@rawdash/adapter-sqlite 0.15.0

package/README.md

@@ -0,0 +1,49 @@
+# @rawdash/adapter-sqlite
+
+[![npm version](https://img.shields.io/npm/v/@rawdash/adapter-sqlite)](https://www.npmjs.com/package/@rawdash/adapter-sqlite)
+[![license](https://img.shields.io/npm/l/@rawdash/adapter-sqlite)](https://github.com/rawdash/rawdash/blob/main/LICENSE)
+
+File-backed SQLite `ServerStorage` for rawdash. Designed for local OSS
+development: drop a single file in `.rawdash/storage.sqlite`, survive dev
+server restarts, never burn through API rate limits cold-starting on every
+file change.
+
+Internally a thin wrapper over [`@rawdash/adapter-libsql`](../libsql) pointed
+at a local file via libSQL's `file:` URL scheme — same schema, same
+migrations, same advisory-lock semantics.
+
+## Install
+
+```sh
+npm install @rawdash/adapter-sqlite
+```
+
+## Quick example
+
+```ts
+import { serve as honoServe } from '@hono/node-server';
+import { SqliteStorage } from '@rawdash/adapter-sqlite';
+import { mountEngine } from '@rawdash/hono';
+
+import config from './rawdash.config';
+
+const storage = new SqliteStorage('.rawdash/storage.sqlite');
+
+const { app } = mountEngine(config, { storage });
+honoServe({ fetch: app.fetch, port: 8080 });
+```
+
+The parent directory is created automatically. To opt out, pass
+`{ ensureDir: false }`.
+
+## Resetting
+
+Nuke the file (or its containing directory) to start fresh:
+
+```sh
+rm -rf .rawdash
+```
+
+## License
+
+Apache-2.0

package/dist/index.d.ts

@@ -0,0 +1,19 @@
+import { ServerStorage, GetStorageHandleOptions, StorageHandle, SyncState } from '@rawdash/core';
+
+interface SqliteStorageOptions {
+    ensureDir?: boolean;
+}
+declare class SqliteStorage implements ServerStorage {
+    private inner;
+    constructor(path: string, options?: SqliteStorageOptions);
+    waitUntilReady(): Promise<void>;
+    getStorageHandle(connectorId: string, options?: GetStorageHandleOptions): StorageHandle;
+    getSyncState(): Promise<SyncState>;
+    markSyncQueued(): Promise<boolean>;
+    markSyncRunning(): Promise<boolean>;
+    markSyncSucceeded(): Promise<void>;
+    markSyncFailed(error: string): Promise<void>;
+    close(): Promise<void>;
+}
+
+export { SqliteStorage, type SqliteStorageOptions };

package/dist/index.js

@@ -0,0 +1,56 @@
+// src/sqlite-storage.ts
+import { createClient } from "@libsql/client";
+import { LibsqlStorage } from "@rawdash/adapter-libsql";
+import { mkdirSync } from "fs";
+import { dirname, isAbsolute, resolve } from "path";
+import { pathToFileURL } from "url";
+function toFileUrl(path) {
+  if (path === ":memory:") {
+    return ":memory:";
+  }
+  const absolute = isAbsolute(path) ? path : resolve(process.cwd(), path);
+  return pathToFileURL(absolute).toString();
+}
+function makeClient(path, ensureDir) {
+  if (ensureDir && path !== ":memory:") {
+    const absolute = isAbsolute(path) ? path : resolve(process.cwd(), path);
+    mkdirSync(dirname(absolute), { recursive: true });
+  }
+  return createClient({ url: toFileUrl(path) });
+}
+var SqliteStorage = class {
+  inner;
+  constructor(path, options = {}) {
+    const ensureDir = options.ensureDir ?? true;
+    const client = makeClient(path, ensureDir);
+    this.inner = new LibsqlStorage({ client });
+  }
+  waitUntilReady() {
+    return this.inner.waitUntilReady();
+  }
+  getStorageHandle(connectorId, options) {
+    return this.inner.getStorageHandle(connectorId, options);
+  }
+  getSyncState() {
+    return this.inner.getSyncState();
+  }
+  markSyncQueued() {
+    return this.inner.markSyncQueued();
+  }
+  markSyncRunning() {
+    return this.inner.markSyncRunning();
+  }
+  markSyncSucceeded() {
+    return this.inner.markSyncSucceeded();
+  }
+  markSyncFailed(error) {
+    return this.inner.markSyncFailed(error);
+  }
+  close() {
+    return this.inner.close();
+  }
+};
+export {
+  SqliteStorage
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/sqlite-storage.ts"],"sourcesContent":["import { type Client, createClient } from '@libsql/client';\nimport { LibsqlStorage } from '@rawdash/adapter-libsql';\nimport type {\n  GetStorageHandleOptions,\n  ServerStorage,\n  StorageHandle,\n  SyncState,\n} from '@rawdash/core';\nimport { mkdirSync } from 'node:fs';\nimport { dirname, isAbsolute, resolve } from 'node:path';\nimport { pathToFileURL } from 'node:url';\n\nexport interface SqliteStorageOptions {\n  ensureDir?: boolean;\n}\n\nfunction toFileUrl(path: string): string {\n  if (path === ':memory:') {\n    return ':memory:';\n  }\n  const absolute = isAbsolute(path) ? path : resolve(process.cwd(), path);\n  return pathToFileURL(absolute).toString();\n}\n\nfunction makeClient(path: string, ensureDir: boolean): Client {\n  if (ensureDir && path !== ':memory:') {\n    const absolute = isAbsolute(path) ? path : resolve(process.cwd(), path);\n    mkdirSync(dirname(absolute), { recursive: true });\n  }\n  return createClient({ url: toFileUrl(path) });\n}\n\nexport class SqliteStorage implements ServerStorage {\n  private inner: LibsqlStorage;\n\n  constructor(path: string, options: SqliteStorageOptions = {}) {\n    const ensureDir = options.ensureDir ?? true;\n    const client = makeClient(path, ensureDir);\n    this.inner = new LibsqlStorage({ client });\n  }\n\n  waitUntilReady(): Promise<void> {\n    return this.inner.waitUntilReady();\n  }\n\n  getStorageHandle(\n    connectorId: string,\n    options?: GetStorageHandleOptions,\n  ): StorageHandle {\n    return this.inner.getStorageHandle(connectorId, options);\n  }\n\n  getSyncState(): Promise<SyncState> {\n    return this.inner.getSyncState();\n  }\n\n  markSyncQueued(): Promise<boolean> {\n    return this.inner.markSyncQueued();\n  }\n\n  markSyncRunning(): Promise<boolean> {\n    return this.inner.markSyncRunning();\n  }\n\n  markSyncSucceeded(): Promise<void> {\n    return this.inner.markSyncSucceeded();\n  }\n\n  markSyncFailed(error: string): Promise<void> {\n    return this.inner.markSyncFailed(error);\n  }\n\n  close(): Promise<void> {\n    return this.inner.close();\n  }\n}\n"],"mappings":";AAAA,SAAsB,oBAAoB;AAC1C,SAAS,qBAAqB;AAO9B,SAAS,iBAAiB;AAC1B,SAAS,SAAS,YAAY,eAAe;AAC7C,SAAS,qBAAqB;AAM9B,SAAS,UAAU,MAAsB;AACvC,MAAI,SAAS,YAAY;AACvB,WAAO;AAAA,EACT;AACA,QAAM,WAAW,WAAW,IAAI,IAAI,OAAO,QAAQ,QAAQ,IAAI,GAAG,IAAI;AACtE,SAAO,cAAc,QAAQ,EAAE,SAAS;AAC1C;AAEA,SAAS,WAAW,MAAc,WAA4B;AAC5D,MAAI,aAAa,SAAS,YAAY;AACpC,UAAM,WAAW,WAAW,IAAI,IAAI,OAAO,QAAQ,QAAQ,IAAI,GAAG,IAAI;AACtE,cAAU,QAAQ,QAAQ,GAAG,EAAE,WAAW,KAAK,CAAC;AAAA,EAClD;AACA,SAAO,aAAa,EAAE,KAAK,UAAU,IAAI,EAAE,CAAC;AAC9C;AAEO,IAAM,gBAAN,MAA6C;AAAA,EAC1C;AAAA,EAER,YAAY,MAAc,UAAgC,CAAC,GAAG;AAC5D,UAAM,YAAY,QAAQ,aAAa;AACvC,UAAM,SAAS,WAAW,MAAM,SAAS;AACzC,SAAK,QAAQ,IAAI,cAAc,EAAE,OAAO,CAAC;AAAA,EAC3C;AAAA,EAEA,iBAAgC;AAC9B,WAAO,KAAK,MAAM,eAAe;AAAA,EACnC;AAAA,EAEA,iBACE,aACA,SACe;AACf,WAAO,KAAK,MAAM,iBAAiB,aAAa,OAAO;AAAA,EACzD;AAAA,EAEA,eAAmC;AACjC,WAAO,KAAK,MAAM,aAAa;AAAA,EACjC;AAAA,EAEA,iBAAmC;AACjC,WAAO,KAAK,MAAM,eAAe;AAAA,EACnC;AAAA,EAEA,kBAAoC;AAClC,WAAO,KAAK,MAAM,gBAAgB;AAAA,EACpC;AAAA,EAEA,oBAAmC;AACjC,WAAO,KAAK,MAAM,kBAAkB;AAAA,EACtC;AAAA,EAEA,eAAe,OAA8B;AAC3C,WAAO,KAAK,MAAM,eAAe,KAAK;AAAA,EACxC;AAAA,EAEA,QAAuB;AACrB,WAAO,KAAK,MAAM,MAAM;AAAA,EAC1B;AACF;","names":[]}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@rawdash/adapter-sqlite",
+  "version": "0.15.0",
+  "description": "Rawdash SQLite storage adapter for local development (file-backed, survives restarts)",
+  "license": "Apache-2.0",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/rawdash/rawdash.git",
+    "directory": "packages/adapters/sqlite"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "exports": {
+    ".": {
+      "@rawdash/source": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@libsql/client": "^0.17.0",
+    "@rawdash/adapter-libsql": "workspace:*",
+    "@rawdash/core": "workspace:*"
+  },
+  "devDependencies": {
+    "@types/node": "^22.19.17",
+    "tsup": "^8.0.0",
+    "typescript": "^5.7.2",
+    "vitest": "^4.1.4"
+  }
+}