@super-line/store-sync-libsql 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,98 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+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 __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  libsqlSyncStore: () => libsqlSyncStore
+});
+module.exports = __toCommonJS(index_exports);
+var import_client = require("@libsql/client");
+var import_store_sync = require("@super-line/store-sync");
+async function libsqlSyncStore(opts) {
+  const table = opts.table ?? "resources";
+  if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(table)) throw new Error(`Invalid table name: ${table}`);
+  const debounceMs = opts.debounceMs ?? 250;
+  const client = (0, import_client.createClient)({ url: opts.url, authToken: opts.authToken });
+  await client.execute(`CREATE TABLE IF NOT EXISTS "${table}" (id TEXT PRIMARY KEY, state TEXT NOT NULL, access TEXT NOT NULL)`);
+  const inner = (0, import_store_sync.syncStoreServer)({ resolveOptions: opts.resolveOptions });
+  const timers = /* @__PURE__ */ new Map();
+  const snapshot = async (id) => {
+    const res = await inner.read(id);
+    if (!res) return;
+    await client.execute({
+      sql: `INSERT INTO "${table}" (id, state, access) VALUES (?, ?, ?) ON CONFLICT(id) DO UPDATE SET state = excluded.state`,
+      args: [id, res.data, JSON.stringify(res.accessRules)]
+    });
+  };
+  const cancel = (id) => {
+    const t = timers.get(id);
+    if (!t) return;
+    clearTimeout(t);
+    timers.delete(id);
+  };
+  const { rows } = await client.execute(`SELECT id, state, access FROM "${table}"`);
+  for (const row of rows) {
+    const id = row.id;
+    const access = JSON.parse(row.access);
+    await inner.create(id, {}, access);
+    await inner.apply({ id, update: row.state, origin: "restore" });
+  }
+  inner.onChange((change) => {
+    cancel(change.id);
+    timers.set(
+      change.id,
+      setTimeout(() => {
+        timers.delete(change.id);
+        void snapshot(change.id);
+      }, debounceMs)
+    );
+  });
+  return {
+    ...inner,
+    async create(id, data, accessRules) {
+      await inner.create(id, data, accessRules);
+      const res = await inner.read(id);
+      await client.execute({
+        sql: `INSERT INTO "${table}" (id, state, access) VALUES (?, ?, ?) ON CONFLICT(id) DO NOTHING`,
+        args: [id, res?.data ?? "", JSON.stringify(accessRules)]
+      });
+    },
+    async setAccess(id, accessRules) {
+      await inner.setAccess(id, accessRules);
+      await client.execute({ sql: `UPDATE "${table}" SET access = ? WHERE id = ?`, args: [JSON.stringify(accessRules), id] });
+    },
+    async delete(id) {
+      cancel(id);
+      await inner.delete(id);
+      await client.execute({ sql: `DELETE FROM "${table}" WHERE id = ?`, args: [id] });
+    },
+    async close() {
+      const ids = [...timers.keys()];
+      for (const t of timers.values()) clearTimeout(t);
+      timers.clear();
+      for (const id of ids) await snapshot(id);
+      client.close();
+    }
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  libsqlSyncStore
+});

package/dist/index.d.cts

@@ -0,0 +1,24 @@
+import { DocOptions } from '@super-line/store-sync';
+import { ServerStore } from '@super-line/core';
+
+interface LibsqlSyncStoreOptions {
+    /** libsql URL: `file:x.db`, `:memory:`, `libsql://` (Turso) or `http://`/`https://` (sqld). */
+    url: string;
+    /** Auth token for Turso Cloud. */
+    authToken?: string;
+    /** Table this store owns; defaults to `resources`. Validated `/^[A-Za-z_][A-Za-z0-9_]*$/`. */
+    table?: string;
+    /** Coalesce rapid edits into one snapshot write; defaults to 250ms. */
+    debounceMs?: number;
+    /** Per-resource super-store config; MUST match the client's (the store-sync rule). */
+    resolveOptions?: (id: string) => DocOptions | undefined;
+}
+/**
+ * Durable CRDT **server half**: `syncStoreServer`'s Yjs merge engine, snapshotted per Resource to a shared
+ * libsql so state survives a restart. A thin wrapper — persistence is an extra `onChange` subscriber that
+ * debounces a full-state upsert; the hot path (`apply`) stays synchronous and relay-safe. Async factory:
+ * it rehydrates every Resource (history-preserving `applyUpdate`) before returning a ready store.
+ */
+declare function libsqlSyncStore(opts: LibsqlSyncStoreOptions): Promise<ServerStore>;
+
+export { type LibsqlSyncStoreOptions, libsqlSyncStore };

package/dist/index.d.ts

@@ -0,0 +1,24 @@
+import { DocOptions } from '@super-line/store-sync';
+import { ServerStore } from '@super-line/core';
+
+interface LibsqlSyncStoreOptions {
+    /** libsql URL: `file:x.db`, `:memory:`, `libsql://` (Turso) or `http://`/`https://` (sqld). */
+    url: string;
+    /** Auth token for Turso Cloud. */
+    authToken?: string;
+    /** Table this store owns; defaults to `resources`. Validated `/^[A-Za-z_][A-Za-z0-9_]*$/`. */
+    table?: string;
+    /** Coalesce rapid edits into one snapshot write; defaults to 250ms. */
+    debounceMs?: number;
+    /** Per-resource super-store config; MUST match the client's (the store-sync rule). */
+    resolveOptions?: (id: string) => DocOptions | undefined;
+}
+/**
+ * Durable CRDT **server half**: `syncStoreServer`'s Yjs merge engine, snapshotted per Resource to a shared
+ * libsql so state survives a restart. A thin wrapper — persistence is an extra `onChange` subscriber that
+ * debounces a full-state upsert; the hot path (`apply`) stays synchronous and relay-safe. Async factory:
+ * it rehydrates every Resource (history-preserving `applyUpdate`) before returning a ready store.
+ */
+declare function libsqlSyncStore(opts: LibsqlSyncStoreOptions): Promise<ServerStore>;
+
+export { type LibsqlSyncStoreOptions, libsqlSyncStore };

package/dist/index.js

@@ -0,0 +1,73 @@
+// src/index.ts
+import { createClient } from "@libsql/client";
+import { syncStoreServer } from "@super-line/store-sync";
+async function libsqlSyncStore(opts) {
+  const table = opts.table ?? "resources";
+  if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(table)) throw new Error(`Invalid table name: ${table}`);
+  const debounceMs = opts.debounceMs ?? 250;
+  const client = createClient({ url: opts.url, authToken: opts.authToken });
+  await client.execute(`CREATE TABLE IF NOT EXISTS "${table}" (id TEXT PRIMARY KEY, state TEXT NOT NULL, access TEXT NOT NULL)`);
+  const inner = syncStoreServer({ resolveOptions: opts.resolveOptions });
+  const timers = /* @__PURE__ */ new Map();
+  const snapshot = async (id) => {
+    const res = await inner.read(id);
+    if (!res) return;
+    await client.execute({
+      sql: `INSERT INTO "${table}" (id, state, access) VALUES (?, ?, ?) ON CONFLICT(id) DO UPDATE SET state = excluded.state`,
+      args: [id, res.data, JSON.stringify(res.accessRules)]
+    });
+  };
+  const cancel = (id) => {
+    const t = timers.get(id);
+    if (!t) return;
+    clearTimeout(t);
+    timers.delete(id);
+  };
+  const { rows } = await client.execute(`SELECT id, state, access FROM "${table}"`);
+  for (const row of rows) {
+    const id = row.id;
+    const access = JSON.parse(row.access);
+    await inner.create(id, {}, access);
+    await inner.apply({ id, update: row.state, origin: "restore" });
+  }
+  inner.onChange((change) => {
+    cancel(change.id);
+    timers.set(
+      change.id,
+      setTimeout(() => {
+        timers.delete(change.id);
+        void snapshot(change.id);
+      }, debounceMs)
+    );
+  });
+  return {
+    ...inner,
+    async create(id, data, accessRules) {
+      await inner.create(id, data, accessRules);
+      const res = await inner.read(id);
+      await client.execute({
+        sql: `INSERT INTO "${table}" (id, state, access) VALUES (?, ?, ?) ON CONFLICT(id) DO NOTHING`,
+        args: [id, res?.data ?? "", JSON.stringify(accessRules)]
+      });
+    },
+    async setAccess(id, accessRules) {
+      await inner.setAccess(id, accessRules);
+      await client.execute({ sql: `UPDATE "${table}" SET access = ? WHERE id = ?`, args: [JSON.stringify(accessRules), id] });
+    },
+    async delete(id) {
+      cancel(id);
+      await inner.delete(id);
+      await client.execute({ sql: `DELETE FROM "${table}" WHERE id = ?`, args: [id] });
+    },
+    async close() {
+      const ids = [...timers.keys()];
+      for (const t of timers.values()) clearTimeout(t);
+      timers.clear();
+      for (const id of ids) await snapshot(id);
+      client.close();
+    }
+  };
+}
+export {
+  libsqlSyncStore
+};

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@super-line/store-sync-libsql",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "Durable CRDT Store for super-line — store-sync's Yjs merge engine backed by libsql (Turso / sqld).",
+  "license": "MIT",
+  "author": "Mert",
+  "keywords": [
+    "super-line",
+    "store",
+    "crdt",
+    "yjs",
+    "libsql",
+    "turso",
+    "persistence",
+    "durable",
+    "sync"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mertdogar/super-line.git",
+    "directory": "packages/store-sync-libsql"
+  },
+  "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": {
+    "@libsql/client": "^0.15.0",
+    "@super-line/store-sync": "^0.8.0",
+    "@super-line/core": "^0.8.0"
+  },
+  "scripts": {
+    "build": "tsup"
+  }
+}