@super-line/store-pglite 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,128 @@
+"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, {
+  pgliteStoreServer: () => pgliteStoreServer
+});
+module.exports = __toCommonJS(index_exports);
+var import_pglite = require("@electric-sql/pglite");
+var import_live = require("@electric-sql/pglite/live");
+var import_pglite_sync = require("@electric-sql/pglite-sync");
+var import_postgres = __toESM(require("postgres"), 1);
+var import_core = require("@super-line/core");
+var IDENT = /^[A-Za-z_][A-Za-z0-9_]*$/;
+async function pgliteStoreServer(opts) {
+  const table = opts.table ?? "resources";
+  if (!IDENT.test(table)) throw new Error(`Invalid table name: ${table}`);
+  const ddl = `CREATE TABLE IF NOT EXISTS "${table}" (id text PRIMARY KEY, data jsonb NOT NULL, access jsonb NOT NULL, origin text)`;
+  const sql = (0, import_postgres.default)(opts.pgUrl, { prepare: false, onnotice: () => {
+  } });
+  try {
+    await sql.unsafe(ddl);
+  } catch (err) {
+    const code = err.code;
+    if (code !== "42P07" && code !== "23505") throw err;
+  }
+  const asJson = (v) => sql.json(v);
+  const ownsDb = !opts.db;
+  const db = opts.db ?? await import_pglite.PGlite.create({ extensions: { live: import_live.live, sync: (0, import_pglite_sync.electricSync)() } });
+  await db.exec(ddl);
+  const changeCbs = /* @__PURE__ */ new Set();
+  const deleteCbs = /* @__PURE__ */ new Set();
+  const liveSub = await db.live.changes(`SELECT id, data, origin FROM "${table}"`, [], "id", (changes) => {
+    for (const ch of changes) {
+      if (ch.__op__ === "DELETE") {
+        for (const cb of deleteCbs) cb(ch.id);
+      } else if (ch.__op__ === "INSERT" || ch.__op__ === "UPDATE") {
+        const change = { id: ch.id, update: ch.data, origin: ch.origin ?? "" };
+        for (const cb of changeCbs) cb(change);
+      }
+    }
+  });
+  const shape = opts.electricUrl && db.sync ? await db.sync.syncShapeToTable({
+    shape: { url: opts.electricUrl, params: { table } },
+    table,
+    primaryKey: ["id"],
+    shapeKey: null
+  }) : void 0;
+  return {
+    clustering: "self",
+    model: "lww",
+    async read(id) {
+      const rows = await sql`SELECT data::text AS data, access::text AS access FROM ${sql(table)} WHERE id = ${id}`;
+      const row = rows[0];
+      if (!row) return void 0;
+      return { id, data: JSON.parse(row.data), accessRules: JSON.parse(row.access) };
+    },
+    async create(id, data, accessRules) {
+      const res = await sql`INSERT INTO ${sql(table)} (id, data, access, origin)
+        VALUES (${id}, ${asJson(data ?? null)}, ${asJson(accessRules)}, ${null})
+        ON CONFLICT (id) DO NOTHING`;
+      if (res.count === 0) throw new import_core.SuperLineError("CONFLICT", `Resource already exists: ${id}`);
+    },
+    async apply(change) {
+      const res = await sql`UPDATE ${sql(table)} SET data = ${asJson(change.update ?? null)}, origin = ${change.origin} WHERE id = ${change.id}`;
+      if (res.count === 0) throw new import_core.SuperLineError("NOT_FOUND", `No resource: ${change.id}`);
+    },
+    async setAccess(id, accessRules) {
+      const res = await sql`UPDATE ${sql(table)} SET access = ${asJson(accessRules)} WHERE id = ${id}`;
+      if (res.count === 0) throw new import_core.SuperLineError("NOT_FOUND", `No resource: ${id}`);
+    },
+    async delete(id) {
+      await sql`DELETE FROM ${sql(table)} WHERE id = ${id}`;
+    },
+    async list() {
+      const rows = await sql`SELECT id FROM ${sql(table)}`;
+      return rows.map((r) => r.id);
+    },
+    onChange(cb) {
+      changeCbs.add(cb);
+      return () => changeCbs.delete(cb);
+    },
+    onDelete(cb) {
+      deleteCbs.add(cb);
+      return () => deleteCbs.delete(cb);
+    },
+    async close() {
+      try {
+        await liveSub.unsubscribe();
+        shape?.unsubscribe();
+        if (ownsDb) await db.close();
+      } finally {
+        await sql.end();
+      }
+    }
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  pgliteStoreServer
+});

package/dist/index.d.cts

@@ -0,0 +1,35 @@
+import { PGliteWithLive } from '@electric-sql/pglite/live';
+import { ServerStore } from '@super-line/core';
+
+/** Options for {@link pgliteStoreServer}. */
+interface PgliteStoreOptions {
+    /**
+     * Connection string for the central Postgres — the source of truth for writes + strong reads + ACL.
+     * Accepts a real Postgres URL or a PGLiteSocketServer (both speak pg-wire).
+     */
+    pgUrl: string;
+    /**
+     * Electric shape endpoint (e.g. `http://localhost:3000/v1/shape`) that streams the central table into this
+     * node's local replica. Omit to disable incoming sync — useful for tests/manual feeding of the local replica.
+     */
+    electricUrl?: string;
+    /** Table this store owns on both the central DB and the local replica; defaults to `resources`. */
+    table?: string;
+    /**
+     * Advanced/testing: supply the local PGlite replica (must have the `live` extension; add `sync`/`electricSync`
+     * for real Electric sync). When omitted, an ephemeral in-memory PGlite with `live` + `electricSync` is created.
+     */
+    db?: PGliteWithLive;
+}
+/**
+ * The self-clustering, last-writer-wins **server half** — durable like {@link "@super-line/store-sqlite"}, but
+ * its cross-node sync is owned by the store, not super-line's adapter. Writes + strong reads + ACL hit a central
+ * Postgres; each node mirrors that table into an in-memory PGlite replica via **Electric** (one-way, read-only)
+ * and turns its `live.changes` feed into {@link ServerStore.onChange}/{@link ServerStore.onDelete} — which core
+ * fans to LOCAL subscribers only (`clustering: 'self'`). Postgres+Electric is the only fan-out infra. A write
+ * round-trips central PG → Electric → every node's `live.changes`; the `origin` column carries echo-break through
+ * the round-trip. Pair it with `memoryStoreClient()` on the client.
+ */
+declare function pgliteStoreServer(opts: PgliteStoreOptions): Promise<ServerStore>;
+
+export { type PgliteStoreOptions, pgliteStoreServer };

package/dist/index.d.ts

@@ -0,0 +1,35 @@
+import { PGliteWithLive } from '@electric-sql/pglite/live';
+import { ServerStore } from '@super-line/core';
+
+/** Options for {@link pgliteStoreServer}. */
+interface PgliteStoreOptions {
+    /**
+     * Connection string for the central Postgres — the source of truth for writes + strong reads + ACL.
+     * Accepts a real Postgres URL or a PGLiteSocketServer (both speak pg-wire).
+     */
+    pgUrl: string;
+    /**
+     * Electric shape endpoint (e.g. `http://localhost:3000/v1/shape`) that streams the central table into this
+     * node's local replica. Omit to disable incoming sync — useful for tests/manual feeding of the local replica.
+     */
+    electricUrl?: string;
+    /** Table this store owns on both the central DB and the local replica; defaults to `resources`. */
+    table?: string;
+    /**
+     * Advanced/testing: supply the local PGlite replica (must have the `live` extension; add `sync`/`electricSync`
+     * for real Electric sync). When omitted, an ephemeral in-memory PGlite with `live` + `electricSync` is created.
+     */
+    db?: PGliteWithLive;
+}
+/**
+ * The self-clustering, last-writer-wins **server half** — durable like {@link "@super-line/store-sqlite"}, but
+ * its cross-node sync is owned by the store, not super-line's adapter. Writes + strong reads + ACL hit a central
+ * Postgres; each node mirrors that table into an in-memory PGlite replica via **Electric** (one-way, read-only)
+ * and turns its `live.changes` feed into {@link ServerStore.onChange}/{@link ServerStore.onDelete} — which core
+ * fans to LOCAL subscribers only (`clustering: 'self'`). Postgres+Electric is the only fan-out infra. A write
+ * round-trips central PG → Electric → every node's `live.changes`; the `origin` column carries echo-break through
+ * the round-trip. Pair it with `memoryStoreClient()` on the client.
+ */
+declare function pgliteStoreServer(opts: PgliteStoreOptions): Promise<ServerStore>;
+
+export { type PgliteStoreOptions, pgliteStoreServer };

package/dist/index.js

@@ -0,0 +1,93 @@
+// src/index.ts
+import { PGlite } from "@electric-sql/pglite";
+import { live } from "@electric-sql/pglite/live";
+import { electricSync } from "@electric-sql/pglite-sync";
+import postgres from "postgres";
+import { SuperLineError } from "@super-line/core";
+var IDENT = /^[A-Za-z_][A-Za-z0-9_]*$/;
+async function pgliteStoreServer(opts) {
+  const table = opts.table ?? "resources";
+  if (!IDENT.test(table)) throw new Error(`Invalid table name: ${table}`);
+  const ddl = `CREATE TABLE IF NOT EXISTS "${table}" (id text PRIMARY KEY, data jsonb NOT NULL, access jsonb NOT NULL, origin text)`;
+  const sql = postgres(opts.pgUrl, { prepare: false, onnotice: () => {
+  } });
+  try {
+    await sql.unsafe(ddl);
+  } catch (err) {
+    const code = err.code;
+    if (code !== "42P07" && code !== "23505") throw err;
+  }
+  const asJson = (v) => sql.json(v);
+  const ownsDb = !opts.db;
+  const db = opts.db ?? await PGlite.create({ extensions: { live, sync: electricSync() } });
+  await db.exec(ddl);
+  const changeCbs = /* @__PURE__ */ new Set();
+  const deleteCbs = /* @__PURE__ */ new Set();
+  const liveSub = await db.live.changes(`SELECT id, data, origin FROM "${table}"`, [], "id", (changes) => {
+    for (const ch of changes) {
+      if (ch.__op__ === "DELETE") {
+        for (const cb of deleteCbs) cb(ch.id);
+      } else if (ch.__op__ === "INSERT" || ch.__op__ === "UPDATE") {
+        const change = { id: ch.id, update: ch.data, origin: ch.origin ?? "" };
+        for (const cb of changeCbs) cb(change);
+      }
+    }
+  });
+  const shape = opts.electricUrl && db.sync ? await db.sync.syncShapeToTable({
+    shape: { url: opts.electricUrl, params: { table } },
+    table,
+    primaryKey: ["id"],
+    shapeKey: null
+  }) : void 0;
+  return {
+    clustering: "self",
+    model: "lww",
+    async read(id) {
+      const rows = await sql`SELECT data::text AS data, access::text AS access FROM ${sql(table)} WHERE id = ${id}`;
+      const row = rows[0];
+      if (!row) return void 0;
+      return { id, data: JSON.parse(row.data), accessRules: JSON.parse(row.access) };
+    },
+    async create(id, data, accessRules) {
+      const res = await sql`INSERT INTO ${sql(table)} (id, data, access, origin)
+        VALUES (${id}, ${asJson(data ?? null)}, ${asJson(accessRules)}, ${null})
+        ON CONFLICT (id) DO NOTHING`;
+      if (res.count === 0) throw new SuperLineError("CONFLICT", `Resource already exists: ${id}`);
+    },
+    async apply(change) {
+      const res = await sql`UPDATE ${sql(table)} SET data = ${asJson(change.update ?? null)}, origin = ${change.origin} WHERE id = ${change.id}`;
+      if (res.count === 0) throw new SuperLineError("NOT_FOUND", `No resource: ${change.id}`);
+    },
+    async setAccess(id, accessRules) {
+      const res = await sql`UPDATE ${sql(table)} SET access = ${asJson(accessRules)} WHERE id = ${id}`;
+      if (res.count === 0) throw new SuperLineError("NOT_FOUND", `No resource: ${id}`);
+    },
+    async delete(id) {
+      await sql`DELETE FROM ${sql(table)} WHERE id = ${id}`;
+    },
+    async list() {
+      const rows = await sql`SELECT id FROM ${sql(table)}`;
+      return rows.map((r) => r.id);
+    },
+    onChange(cb) {
+      changeCbs.add(cb);
+      return () => changeCbs.delete(cb);
+    },
+    onDelete(cb) {
+      deleteCbs.add(cb);
+      return () => deleteCbs.delete(cb);
+    },
+    async close() {
+      try {
+        await liveSub.unsubscribe();
+        shape?.unsubscribe();
+        if (ownsDb) await db.close();
+      } finally {
+        await sql.end();
+      }
+    }
+  };
+}
+export {
+  pgliteStoreServer
+};

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "@super-line/store-pglite",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "Self-clustering last-writer-wins Store for super-line — central Postgres + per-node Electric-synced PGlite replica (live.changes). Postgres is the only fan-out infra; no separate adapter.",
+  "license": "MIT",
+  "author": "Mert",
+  "keywords": [
+    "super-line",
+    "store",
+    "pglite",
+    "postgres",
+    "electric",
+    "sync",
+    "self",
+    "persistence",
+    "lww"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mertdogar/super-line.git",
+    "directory": "packages/store-pglite"
+  },
+  "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": {
+    "@electric-sql/pglite": "^0.5.3",
+    "@electric-sql/pglite-sync": "^0.6.3",
+    "postgres": "^3.4.9",
+    "@super-line/core": "^0.8.0"
+  },
+  "devDependencies": {
+    "@electric-sql/pglite-socket": "^0.2.6"
+  },
+  "scripts": {
+    "build": "tsup"
+  }
+}