{"id":13536863,"url":"https://github.com/DaBigBlob/libsql-stateless","last_synced_at":"2025-04-02T03:31:17.373Z","repository":{"id":205387223,"uuid":"714123058","full_name":"DaBigBlob/libsql-stateless","owner":"DaBigBlob","description":"Thin libSQL stateless HTTP driver for TypeScript and JavaScript for the edge 🚀","archived":false,"fork":false,"pushed_at":"2024-09-07T20:04:28.000Z","size":238,"stargazers_count":22,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-19T15:54:26.440Z","etag":null,"topics":["cloudflare-pages","cloudflare-workers","database","http","https","lambda-functions","libsql","netlify","serverless","sqlite","vercel","webapi"],"latest_commit_sha":null,"homepage":"https://www.npmjs.com/package/libsql-stateless","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/DaBigBlob.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-11-04T01:26:46.000Z","updated_at":"2024-09-07T20:04:31.000Z","dependencies_parsed_at":null,"dependency_job_id":"db844e6a-224e-4fb7-b089-389243d31c94","html_url":"https://github.com/DaBigBlob/libsql-stateless","commit_stats":{"total_commits":259,"total_committers":2,"mean_commits":129.5,"dds":0.007722007722007707,"last_synced_commit":"a19386817d2a87bdfe7aeb19bcba8b3a5ab365cf"},"previous_names":["dabigblob/libsql-stateless"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DaBigBlob%2Flibsql-stateless","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DaBigBlob%2Flibsql-stateless/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DaBigBlob%2Flibsql-stateless/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DaBigBlob%2Flibsql-stateless/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/DaBigBlob","download_url":"https://codeload.github.com/DaBigBlob/libsql-stateless/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246399816,"owners_count":20770907,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cloudflare-pages","cloudflare-workers","database","http","https","lambda-functions","libsql","netlify","serverless","sqlite","vercel","webapi"],"created_at":"2024-08-01T09:00:50.743Z","updated_at":"2025-04-02T03:31:17.070Z","avatar_url":"https://github.com/DaBigBlob.png","language":"TypeScript","readme":"# libsql-stateless\n\n\u003e Thin libSQL stateless HTTP driver for TypeScript and JavaScript for the edge 🚀\n- ✅ **Supported runtime environments:** Web API (browser, serverless), Bun, Node.js (\u003e=18)\n- ✅ **Extremely thin:** Has no dependency, only has a few functions that implement the [`Hrana v3 HTTP`](https://github.com/tursodatabase/libsql/blob/main/libsql-server/docs/HRANA_3_SPEC.md) protocol from scratch, and has no classes (tend to duplicate memory and/or perform long memory traversals).\n- ✅ **Does no extra computation.**\n- ✅ **Has no premature optimizations.**\n- ✅ **Is extremely light:** 1.15kB (unpacked)* / 548B (gzipped)\n- ✅ Unlike `@libsql/client/web`, **every function performs complete execution in exactly 1 roundtrip.**\n- ✅ **Is built for:** Quick stateless query execution. (Mainly for serverless and edge functions.)\n- ✅ **Supports everything in** `@libsql/client/web`\n- ⚠️ **Interactive transactions are not supported** because this lib is stateless but [`transactions`](https://github.com/DaBigBlob/libsql-stateless/wiki/transactions) are supported.\n- ⚠️ **The API provided by `libsql-stateless` is raw and explicit** for reducing (computational and memory) overheads.\n\n\\* The actual js that is included with your project. (Excluding the type definitions and 2 copies of the main js for esm and cjs. (because you're gonna use one of them))\n\u003cbr\u003e\n\n**For easier DX, consider using [`libsql-stateless-easy`](https://github.com/DaBigBlob/libsql-stateless-easy) instead**: it, however, comes with the cost of non-zero-dependency and (computational and memory) overheads potentially unneeded by you. But is still very very very slim compared to `@libsql/client`.\n\n# Why not just use `@libsql/client/web`?\n1. Not everyone needs stateful DB connection or the overheads that come with it.\n2. To provide a simpler API, `@libsql/client/web` does a lot of, I'd argue unnecessary, computation under the hood.\\\n    Many people would rather use a more complex API than have worse performance.\n\n# Installation\n```sh\n$ npm i libsql-stateless #pnpm, yarn, etc.\n# or\n$ bun add libsql-stateless\n```\n\n# Goto [`WIKI`](https://github.com/DaBigBlob/libsql-stateless/wiki) for  Specifications and Examples\n\n## API Level\n\u003e NOTE: \u003cunix_epoch_miliseconds\u003e-HRANA_3_SPEC.md is the current API level.  \nDownloaded from: https://github.com/tursodatabase/libsql/blob/main/docs/HRANA_3_SPEC.md at \u003cunix_epoch_miliseconds\u003e.  \nServers using older API levels may not be compatible. In that case downgrade to an earlier of this package.","funding_links":[],"categories":["Tools"],"sub_categories":["Community"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FDaBigBlob%2Flibsql-stateless","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FDaBigBlob%2Flibsql-stateless","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FDaBigBlob%2Flibsql-stateless/lists"}