{"_id":"@tursodatabase/serverless","_rev":"30-41b83a3d28741fb64982bdac584a1a7d","name":"@tursodatabase/serverless","dist-tags":{"next":"1.3.0-pre.1","latest":"1.2.3"},"versions":{"0.1.0":{"name":"@tursodatabase/serverless","version":"0.1.0","keywords":[],"author":"","license":"MIT","_id":"@tursodatabase/serverless@0.1.0","maintainers":[{"name":"notrab","email":"jamie@notrab.dev"},{"name":"penberg","email":"penberg@iki.fi"}],"dist":{"shasum":"e2f4632007ce4d6c65fd04dfb81729ffc01c0313","tarball":"https://registry.npmjs.org/@tursodatabase/serverless/-/serverless-0.1.0.tgz","fileCount":18,"integrity":"sha512-pmgHpdtM/7Y8T4BddoV7+fu730EM0OSfYndKkBSTBkjKw0Xk75t8srdn6d6F8hXZQ1r/xiHINEVpG8O1uT7K9Q==","signatures":[{"sig":"MEQCIHhnOpVRr+lr1P7J1fNVUAI2b1E2NYnUuQ+2foans1t9AiBSNiGug4OslhekXjOT5Cauf3flC8P4XUihRWqkPii0ig==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":47499},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"},"./compat":{"types":"./dist/compat/index.d.ts","import":"./dist/compat/index.js"}},"gitHead":"7765bafb13f12f7b8c38c75a6bc629412013cb3b","scripts":{"dev":"tsc --watch","test":"ava integration-tests/*.test.mjs","build":"tsc"},"_npmUser":{"name":"penberg","email":"penberg@iki.fi"},"_npmVersion":"10.9.2","description":"A serverless database driver for Turso Cloud, using only `fetch()`. Connect to your database from serverless and edge functions, such as Cloudflare Workers and Vercel.","directories":{},"_nodeVersion":"22.16.0","_hasShrinkwrap":false,"devDependencies":{"ava":"^6.4.1","typescript":"^5.8.3","@types/node":"^24.0.13"},"_npmOperationalInternal":{"tmp":"tmp/serverless_0.1.0_1753124685955_0.6097727581696475","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@tursodatabase/serverless","version":"0.1.1","keywords":[],"author":"","license":"MIT","_id":"@tursodatabase/serverless@0.1.1","maintainers":[{"name":"notrab","email":"jamie@notrab.dev"},{"name":"penberg","email":"penberg@iki.fi"}],"dist":{"shasum":"7ec0a8be76d462d4186fbea0621b9be0c7068738","tarball":"https://registry.npmjs.org/@tursodatabase/serverless/-/serverless-0.1.1.tgz","fileCount":18,"integrity":"sha512-7YPagfyPH34H2cqYySAametbQjg6i04aHmEEp6HwYvfEqeUYFeyoY//IdLGc+6eMEGRJlL3PipqeeUxfZCjvRw==","signatures":[{"sig":"MEYCIQCCo6wks8CIIhFgFM/xGp5S687ST6Hy5987iC/wNxOwPwIhANQL3ndTXpCIdGa8HLgYMYezJjO7pKVhVqmb6Uud73Lj","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":48712},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"},"./compat":{"types":"./dist/compat/index.d.ts","import":"./dist/compat/index.js"}},"gitHead":"2e0161a1d56b8dd25f5f2cd3c271ed3586ce8438","scripts":{"dev":"tsc --watch","test":"ava integration-tests/*.test.mjs","build":"tsc"},"_npmUser":{"name":"penberg","email":"penberg@iki.fi"},"_npmVersion":"10.9.2","description":"A serverless database driver for Turso Cloud, using only `fetch()`. Connect to your database from serverless and edge functions, such as Cloudflare Workers and Vercel.","directories":{},"_nodeVersion":"22.16.0","_hasShrinkwrap":false,"devDependencies":{"ava":"^6.4.1","typescript":"^5.8.3","@types/node":"^24.0.13"},"_npmOperationalInternal":{"tmp":"tmp/serverless_0.1.1_1753356562328_0.5456908263462834","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@tursodatabase/serverless","version":"0.1.2","keywords":[],"author":"","license":"MIT","_id":"@tursodatabase/serverless@0.1.2","maintainers":[{"name":"notrab","email":"jamie@notrab.dev"},{"name":"penberg","email":"penberg@iki.fi"}],"dist":{"shasum":"d10e116e7d99789291b27e564f86552d0ae65166","tarball":"https://registry.npmjs.org/@tursodatabase/serverless/-/serverless-0.1.2.tgz","fileCount":20,"integrity":"sha512-paD2xyujPal5p+cvYTLjBVlBvl0TLZN7qQA6P3OksXKHDfsr3GYxZrJoFeHp2hDXOAOTVFFBTNYcwNvg/PNHzg==","signatures":[{"sig":"MEUCIHWIImM18GQneTZg3UtOB+R7s95E12cuCuLOtF3l9MoYAiEAkaLmgXXtjqnHowTzKO46URlyTNc1e+i2s+ItSlx9eSw=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":62337},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"},"./compat":{"types":"./dist/compat/index.d.ts","import":"./dist/compat/index.js"}},"gitHead":"29688e69d1c1bad08a30f1916907661e1dbdbbb2","scripts":{"dev":"tsc --watch","test":"ava integration-tests/*.test.mjs","build":"tsc"},"_npmUser":{"name":"penberg","email":"penberg@iki.fi"},"_npmVersion":"10.9.2","description":"A serverless database driver for Turso Cloud, using only `fetch()`. Connect to your database from serverless and edge functions, such as Cloudflare Workers and Vercel.","directories":{},"_nodeVersion":"22.16.0","_hasShrinkwrap":false,"devDependencies":{"ava":"^6.4.1","typescript":"^5.8.3","@types/node":"^24.0.13"},"_npmOperationalInternal":{"tmp":"tmp/serverless_0.1.2_1754053019020_0.4985383997621473","host":"s3://npm-registry-packages-npm-production"}},"0.1.3":{"name":"@tursodatabase/serverless","version":"0.1.3","keywords":[],"author":"","license":"MIT","_id":"@tursodatabase/serverless@0.1.3","maintainers":[{"name":"notrab","email":"jamie@notrab.dev"},{"name":"penberg","email":"penberg@iki.fi"}],"dist":{"shasum":"02970f09892037fb0d164fa0a1b18fe7f80be923","tarball":"https://registry.npmjs.org/@tursodatabase/serverless/-/serverless-0.1.3.tgz","fileCount":20,"integrity":"sha512-S30LgeIgUo2voGLI6F5sNjCZRBd/oUtneZi9zOry1jPZqeZVLJBHWXWyKkuW2/hLnbLT1AVIrenZ4yQav2+nZg==","signatures":[{"sig":"MEUCIQDLvBgyHvaIIcK1hnWoBWex7rjsl4c0rZv2eFBp52wYnwIgZmg72WvNP8//Om9z03OSfAaOuQ7q1c3kUBbqv4UibGY=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":64271},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"},"./compat":{"types":"./dist/compat/index.d.ts","import":"./dist/compat/index.js"}},"gitHead":"2ba28892dce226ada3671a882799fdbd011ae5eb","scripts":{"dev":"tsc --watch","test":"ava integration-tests/*.test.mjs","build":"tsc"},"_npmUser":{"name":"penberg","email":"penberg@iki.fi"},"_npmVersion":"10.9.2","description":"
\n\n---\n\n## About\n\nA serverless database driver for Turso Cloud, using only `fetch()`. Connect to your database from serverless and edge functions, such as Cloudflare Workers and Vercel.\n\n## Installation\n\n```bash\nnpm install @tursodatabase/serverless\n```\n\n## Getting Started\n\n### Basic Usage\n\n```javascript\nimport { connect } from \"@tursodatabase/serverless\";\n\nconst conn = connect({\n url: process.env.TURSO_DATABASE_URL,\n authToken: process.env.TURSO_AUTH_TOKEN,\n});\n\n// Prepare a statement\nconst stmt = conn.prepare(\"SELECT * FROM users WHERE id = ?\");\n\n// Get first row\nconst row = await stmt.get([123]);\nconsole.log(row);\n\n// Get all rows\nconst rows = await stmt.all([123]);\nconsole.log(rows);\n\n// Iterate through rows (streaming)\nfor await (const row of stmt.iterate([123])) {\n console.log(row);\n}\n```\n\n### Batch Operations\n\n```javascript\n// Execute multiple statements in a batch\nawait conn.batch([\n \"CREATE TABLE IF NOT EXISTS users (id INTEGER PRIMARY KEY, email TEXT)\",\n \"INSERT INTO users (email) VALUES ('user@example.com')\",\n \"INSERT INTO users (email) VALUES ('admin@example.com')\",\n]);\n\n// Parameterized batch statements also work\nawait conn.transaction(async () => {\n await conn.batch([\n { sql: \"INSERT INTO users (email) VALUES (?)\", args: [\"alice@example.com\"] },\n { sql: \"INSERT INTO users (email) VALUES (?)\", args: [\"bob@example.com\"] },\n ]);\n}).concurrent();\n```\n\n### Custom Headers\n\nRequests can carry extra HTTP headers, e.g. for routing through a gateway:\n\n```javascript\nconst conn = connect({\n url: process.env.TURSO_DATABASE_URL,\n authToken: process.env.TURSO_AUTH_TOKEN,\n // Extra headers attached to every request. Applied after the standard\n // headers, so they can override e.g. `Authorization`. Setting the `Host`\n // key throws — fetch forbids it.\n requestHeaders: { \"x-custom-header\": \"value\" },\n});\n```\n\n### libSQL Compatibility Layer\n\nFor existing libSQL applications, use the compatibility layer:\n\n```javascript\nimport { createClient } from \"@tursodatabase/serverless/compat\";\n\nconst client = createClient({\n url: process.env.TURSO_DATABASE_URL,\n authToken: process.env.TURSO_AUTH_TOKEN,\n});\n\n// Execute a single SQL statement\nconst result = await client.execute(\"SELECT * FROM users WHERE id = ?\", [123]);\nconsole.log(result.rows);\n\n// Execute multiple statements in a batch\nawait client.batch([\n \"CREATE TABLE IF NOT EXISTS users (id INTEGER PRIMARY KEY, email TEXT)\",\n \"INSERT INTO users (email) VALUES ('user@example.com')\",\n \"INSERT INTO users (email) VALUES ('admin@example.com')\",\n]);\n```\n\n## Examples\n\nCheck out the `examples/` directory for complete usage examples.\n\n## API Reference\n\nFor complete API documentation, see [JavaScript API Reference](../../docs/javascript-api-reference.md).\n\n## Related Packages\n\n* The [@tursodatabase/database](https://www.npmjs.com/package/@tursodatabase/database) package provides the Turso in-memory database, compatible with SQLite.\n* The [@tursodatabase/sync](https://www.npmjs.com/package/@tursodatabase/sync) package provides bidirectional sync between a local Turso database and Turso Cloud. \n\n## License\n\nThis project is licensed under the [MIT license](../../LICENSE.md).\n\n## Support\n\n- [GitHub Issues](https://github.com/tursodatabase/turso/issues)\n- [Documentation](https://docs.turso.tech)\n- [Discord Community](https://tur.so/discord)\n","readmeFilename":"README.md"}
![\"npm\"](\"https://img.shields.io/npm/v/@tursodatabase/serverless\")
\n ![](\"http://img.shields.io/badge/license-MIT-orange.svg?style=flat-square\"){kind=icon}
\n![\"Chat](\"https://img.shields.io/discord/933071162680958986?label=Discord&logo=Discord&style=social\")