@super-line/store-sqlite 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Mert
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.cjs

@@ -0,0 +1,93 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  sqliteStoreServer: () => sqliteStoreServer
+});
+module.exports = __toCommonJS(index_exports);
+var import_better_sqlite3 = __toESM(require("better-sqlite3"), 1);
+var import_core = require("@super-line/core");
+function sqliteStoreServer(opts) {
+  const table = opts.table ?? "resources";
+  if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(table)) throw new Error(`Invalid table name: ${table}`);
+  const db = new import_better_sqlite3.default(opts.file);
+  db.pragma("journal_mode = WAL");
+  db.pragma("synchronous = NORMAL");
+  db.exec(`CREATE TABLE IF NOT EXISTS "${table}" (id TEXT PRIMARY KEY, data TEXT NOT NULL, access TEXT NOT NULL)`);
+  const stmt = {
+    get: db.prepare(`SELECT data, access FROM "${table}" WHERE id = ?`),
+    has: db.prepare(`SELECT 1 FROM "${table}" WHERE id = ?`),
+    insert: db.prepare(`INSERT INTO "${table}" (id, data, access) VALUES (?, ?, ?)`),
+    setData: db.prepare(`UPDATE "${table}" SET data = ? WHERE id = ?`),
+    setAccess: db.prepare(`UPDATE "${table}" SET access = ? WHERE id = ?`),
+    delete: db.prepare(`DELETE FROM "${table}" WHERE id = ?`),
+    list: db.prepare(`SELECT id FROM "${table}"`)
+  };
+  const listeners = /* @__PURE__ */ new Set();
+  return {
+    clustering: "relay",
+    read(id) {
+      const row = stmt.get.get(id);
+      if (!row) return void 0;
+      return { id, accessRules: JSON.parse(row.access), data: JSON.parse(row.data) };
+    },
+    create(id, data, accessRules) {
+      if (stmt.has.get(id)) throw new import_core.SuperLineError("CONFLICT", `Resource already exists: ${id}`);
+      stmt.insert.run(id, JSON.stringify(data ?? null), JSON.stringify(accessRules));
+    },
+    apply(change) {
+      const res = stmt.setData.run(JSON.stringify(change.update ?? null), change.id);
+      if (res.changes === 0) throw new import_core.SuperLineError("NOT_FOUND", `No resource: ${change.id}`);
+      for (const cb of listeners) cb(change);
+    },
+    setAccess(id, accessRules) {
+      const res = stmt.setAccess.run(JSON.stringify(accessRules), id);
+      if (res.changes === 0) throw new import_core.SuperLineError("NOT_FOUND", `No resource: ${id}`);
+    },
+    delete(id) {
+      stmt.delete.run(id);
+    },
+    list() {
+      return stmt.list.all().map((r) => r.id);
+    },
+    onChange(cb) {
+      listeners.add(cb);
+      return () => listeners.delete(cb);
+    },
+    close() {
+      db.close();
+    }
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  sqliteStoreServer
+});

package/dist/index.d.cts

@@ -0,0 +1,18 @@
+import { ServerStore } from '@super-line/core';
+
+/** Options for {@link sqliteStoreServer}. */
+interface SqliteStoreOptions {
+    /** Path to the SQLite database file (use `:memory:` for an ephemeral store). */
+    file: string;
+    /** Table this store owns; defaults to `resources`. Use distinct tables to share one file across stores. */
+    table?: string;
+}
+/**
+ * The durable, last-writer-wins **server half** — {@link "@super-line/store-memory"}'s `memoryStoreServer`,
+ * but backed by SQLite (better-sqlite3) so Resources survive a restart. A write replaces the whole `data`.
+ * `clustering: 'relay'` — it does no networking; super-line core relays its Changes across nodes and feeds
+ * remote Changes back in via {@link ServerStore.apply}. Pair it with `memoryStoreClient()` on the client.
+ */
+declare function sqliteStoreServer(opts: SqliteStoreOptions): ServerStore;
+
+export { type SqliteStoreOptions, sqliteStoreServer };

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+import { ServerStore } from '@super-line/core';
+
+/** Options for {@link sqliteStoreServer}. */
+interface SqliteStoreOptions {
+    /** Path to the SQLite database file (use `:memory:` for an ephemeral store). */
+    file: string;
+    /** Table this store owns; defaults to `resources`. Use distinct tables to share one file across stores. */
+    table?: string;
+}
+/**
+ * The durable, last-writer-wins **server half** — {@link "@super-line/store-memory"}'s `memoryStoreServer`,
+ * but backed by SQLite (better-sqlite3) so Resources survive a restart. A write replaces the whole `data`.
+ * `clustering: 'relay'` — it does no networking; super-line core relays its Changes across nodes and feeds
+ * remote Changes back in via {@link ServerStore.apply}. Pair it with `memoryStoreClient()` on the client.
+ */
+declare function sqliteStoreServer(opts: SqliteStoreOptions): ServerStore;
+
+export { type SqliteStoreOptions, sqliteStoreServer };

package/dist/index.js

@@ -0,0 +1,58 @@
+// src/index.ts
+import Database from "better-sqlite3";
+import { SuperLineError } from "@super-line/core";
+function sqliteStoreServer(opts) {
+  const table = opts.table ?? "resources";
+  if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(table)) throw new Error(`Invalid table name: ${table}`);
+  const db = new Database(opts.file);
+  db.pragma("journal_mode = WAL");
+  db.pragma("synchronous = NORMAL");
+  db.exec(`CREATE TABLE IF NOT EXISTS "${table}" (id TEXT PRIMARY KEY, data TEXT NOT NULL, access TEXT NOT NULL)`);
+  const stmt = {
+    get: db.prepare(`SELECT data, access FROM "${table}" WHERE id = ?`),
+    has: db.prepare(`SELECT 1 FROM "${table}" WHERE id = ?`),
+    insert: db.prepare(`INSERT INTO "${table}" (id, data, access) VALUES (?, ?, ?)`),
+    setData: db.prepare(`UPDATE "${table}" SET data = ? WHERE id = ?`),
+    setAccess: db.prepare(`UPDATE "${table}" SET access = ? WHERE id = ?`),
+    delete: db.prepare(`DELETE FROM "${table}" WHERE id = ?`),
+    list: db.prepare(`SELECT id FROM "${table}"`)
+  };
+  const listeners = /* @__PURE__ */ new Set();
+  return {
+    clustering: "relay",
+    read(id) {
+      const row = stmt.get.get(id);
+      if (!row) return void 0;
+      return { id, accessRules: JSON.parse(row.access), data: JSON.parse(row.data) };
+    },
+    create(id, data, accessRules) {
+      if (stmt.has.get(id)) throw new SuperLineError("CONFLICT", `Resource already exists: ${id}`);
+      stmt.insert.run(id, JSON.stringify(data ?? null), JSON.stringify(accessRules));
+    },
+    apply(change) {
+      const res = stmt.setData.run(JSON.stringify(change.update ?? null), change.id);
+      if (res.changes === 0) throw new SuperLineError("NOT_FOUND", `No resource: ${change.id}`);
+      for (const cb of listeners) cb(change);
+    },
+    setAccess(id, accessRules) {
+      const res = stmt.setAccess.run(JSON.stringify(accessRules), id);
+      if (res.changes === 0) throw new SuperLineError("NOT_FOUND", `No resource: ${id}`);
+    },
+    delete(id) {
+      stmt.delete.run(id);
+    },
+    list() {
+      return stmt.list.all().map((r) => r.id);
+    },
+    onChange(cb) {
+      listeners.add(cb);
+      return () => listeners.delete(cb);
+    },
+    close() {
+      db.close();
+    }
+  };
+}
+export {
+  sqliteStoreServer
+};

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@super-line/store-sqlite",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "Durable last-writer-wins Store for super-line — SQLite-backed server persistence (better-sqlite3).",
+  "license": "MIT",
+  "author": "Mert",
+  "keywords": [
+    "super-line",
+    "store",
+    "sqlite",
+    "persistence",
+    "durable",
+    "lww"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mertdogar/super-line.git",
+    "directory": "packages/store-sqlite"
+  },
+  "homepage": "https://mertdogar.github.io/super-line/",
+  "bugs": "https://github.com/mertdogar/super-line/issues",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "better-sqlite3": "^11.8.1",
+    "@super-line/core": "^0.5.0"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.12"
+  },
+  "scripts": {
+    "build": "tsup"
+  }
+}