@absolutejs/sync 0.0.1 → 0.1.0

package/dist/adapters/mysql/index.d.ts

@@ -0,0 +1,75 @@
+import type { ChangeSource, ParsedChange } from '../../engine/types';
+/**
+ * MySQL CDC adapter for @absolutejs/sync (Tier 3, M5).
+ *
+ * MySQL has no `LISTEN/NOTIFY`, so two pluggable strategies catch out-of-band
+ * writes — both behind the engine's {@link ChangeSource} seam:
+ *
+ * - **Changelog + poll (portable).** Install triggers with
+ *   {@link mysqlChangelogSchema} and tail the changelog with
+ *   {@link createPollingChangeSource}. Works anywhere, no extra privileges.
+ * - **Binlog (higher throughput).** Wire a binlog reader (e.g. zongji) into
+ *   {@link mysqlBinlogChangeSource}; it normalizes row events into the change
+ *   feed. Catches writes without the per-write changelog overhead.
+ *
+ * Dependency-free — you bring the MySQL client / binlog reader.
+ */
+export { createPollingChangeSource, parseOutboxRow } from '../../engine/pollingSource';
+export type { OutboxRow, PollingChangeSourceOptions } from '../../engine/pollingSource';
+export type MysqlChangelogOptions = {
+    /** Table name → the column names to capture in the change payload. */
+    tables: Record<string, string[]>;
+    /** Changelog table name. Defaults to `absolute_sync_changelog`. */
+    changelogTable?: string;
+    /** Trigger name prefix. Defaults to `absolute_sync`. */
+    prefix?: string;
+};
+/**
+ * Generate the SQL that installs the changelog table and per-table
+ * insert/update/delete triggers — run it once (e.g. in a migration). Each
+ * trigger appends `{ tbl, op, payload }` (payload built with `JSON_OBJECT` from
+ * the listed columns) to the changelog for {@link createPollingChangeSource}.
+ *
+ * Each `CREATE TRIGGER` body is a single statement (no `DELIMITER` needed). The
+ * statements are `;`-separated; run them as a script, or split on `;` if your
+ * driver executes one statement per call.
+ */
+export declare const mysqlChangelogSchema: (options: MysqlChangelogOptions) => string;
+/** A row-level binlog event (the subset {@link normalizeBinlogEvent} needs). */
+export type BinlogRowEvent = {
+    /**
+     * Event kind — zongji's `writerows` / `updaterows` / `deleterows`
+     * (case-insensitive).
+     */
+    type: string;
+    /** The affected table. */
+    table: string;
+    /**
+     * Affected rows. Insert/delete: each entry is the row object. Update: each
+     * entry is `{ before, after }` (zongji's shape).
+     */
+    rows: unknown[];
+};
+/**
+ * Normalize a binlog row event into engine changes — one per affected row. For
+ * updates it takes the `after` image; for deletes the row (or its `before`
+ * image). Rows that aren't objects are skipped. Pure, so it's easy to test and
+ * to swap for a different reader's shape.
+ */
+export declare const normalizeBinlogEvent: (event: BinlogRowEvent) => ParsedChange[];
+export type MysqlBinlogChangeSourceOptions = {
+    /**
+     * Subscribe to row events from a binlog reader; return a function that stops
+     * it. e.g. with zongji:
+     * `(onEvent) => { zongji.on('binlog', e => onEvent({ type: e.getEventName(), table: e.tableMap[e.tableId].tableName, rows: e.rows })); zongji.start(...); return () => zongji.stop(); }`.
+     */
+    subscribe: (onEvent: (event: BinlogRowEvent) => void) => Promise<() => void | Promise<void>> | (() => void | Promise<void>);
+    /** Override the event normalizer (defaults to {@link normalizeBinlogEvent}). */
+    normalize?: (event: BinlogRowEvent) => ParsedChange[];
+};
+/**
+ * A {@link ChangeSource} backed by the MySQL binlog. Each row event is
+ * normalized and emitted into the engine. Connect with
+ * `engine.connectSource(...)`.
+ */
+export declare const mysqlBinlogChangeSource: (options: MysqlBinlogChangeSourceOptions) => ChangeSource;

package/dist/adapters/mysql/index.js

@@ -0,0 +1,171 @@
+// @bun
+// src/engine/pollingSource.ts
+var OP_BY_NAME = {
+  insert: "insert",
+  INSERT: "insert",
+  update: "update",
+  UPDATE: "update",
+  delete: "delete",
+  DELETE: "delete"
+};
+var parseOutboxRow = (row) => {
+  if (typeof row.tbl !== "string") {
+    return;
+  }
+  const op = OP_BY_NAME[row.op];
+  if (op === undefined) {
+    return;
+  }
+  let payload = row.payload;
+  if (typeof payload === "string") {
+    try {
+      payload = JSON.parse(payload);
+    } catch {
+      return;
+    }
+  }
+  if (typeof payload !== "object" || payload === null) {
+    return;
+  }
+  return { table: row.tbl, change: { op, row: payload } };
+};
+var createPollingChangeSource = (options) => {
+  const intervalMs = options.intervalMs ?? 1000;
+  const parse = options.parse ?? parseOutboxRow;
+  const onError = options.onError ?? ((error) => {
+    console.warn("[sync] polling change source error:", error);
+  });
+  let cursor = options.startSeq ?? 0;
+  let running = false;
+  let timer;
+  const tick = async (emit) => {
+    if (!running) {
+      return;
+    }
+    try {
+      const rows = await options.poll(cursor);
+      for (const row of rows) {
+        const parsed = parse(row);
+        if (parsed !== undefined) {
+          await emit(parsed.table, parsed.change);
+        }
+        if (typeof row.seq === "number" && row.seq > cursor) {
+          cursor = row.seq;
+        }
+      }
+      if (rows.length > 0) {
+        await options.onProcessed?.(cursor);
+      }
+    } catch (error) {
+      onError(error);
+    }
+    if (running) {
+      timer = setTimeout(() => {
+        tick(emit);
+      }, intervalMs);
+    }
+  };
+  return {
+    start: async (emit) => {
+      if (running) {
+        return;
+      }
+      running = true;
+      await tick(emit);
+    },
+    stop: () => {
+      running = false;
+      if (timer !== undefined) {
+        clearTimeout(timer);
+        timer = undefined;
+      }
+    }
+  };
+};
+
+// src/adapters/mysql/index.ts
+var DEFAULT_CHANGELOG = "absolute_sync_changelog";
+var DEFAULT_PREFIX = "absolute_sync";
+var OPS = ["insert", "update", "delete"];
+var mysqlChangelogSchema = (options) => {
+  const changelog = options.changelogTable ?? DEFAULT_CHANGELOG;
+  const prefix = options.prefix ?? DEFAULT_PREFIX;
+  const createTable = [
+    `CREATE TABLE IF NOT EXISTS \`${changelog}\` (`,
+    "\tseq BIGINT AUTO_INCREMENT PRIMARY KEY,",
+    "\ttbl VARCHAR(255) NOT NULL,",
+    "\top VARCHAR(16) NOT NULL,",
+    "\tpayload JSON NOT NULL,",
+    "\tcreated_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP",
+    ");"
+  ].join(`
+`);
+  const jsonObject = (columns, ref) => `JSON_OBJECT(${columns.map((column) => `'${column}', ${ref}.\`${column}\``).join(", ")})`;
+  const triggers = Object.entries(options.tables).flatMap(([table, columns]) => OPS.map((op) => {
+    const ref = op === "delete" ? "OLD" : "NEW";
+    const name = `${prefix}_${table}_${op}`;
+    return [
+      `DROP TRIGGER IF EXISTS \`${name}\`;`,
+      `CREATE TRIGGER \`${name}\` AFTER ${op.toUpperCase()} ON \`${table}\` FOR EACH ROW`,
+      `INSERT INTO \`${changelog}\` (tbl, op, payload)`,
+      `VALUES ('${table}', '${op}', ${jsonObject(columns, ref)});`
+    ].join(`
+`);
+  }));
+  return [createTable, ...triggers].join(`
+
+`);
+};
+var BINLOG_OP = {
+  writerows: "insert",
+  updaterows: "update",
+  deleterows: "delete"
+};
+var normalizeBinlogEvent = (event) => {
+  const op = BINLOG_OP[event.type.toLowerCase()];
+  if (op === undefined || typeof event.table !== "string") {
+    return [];
+  }
+  const changes = [];
+  for (const entry of event.rows) {
+    let row = entry;
+    if (entry !== null && typeof entry === "object") {
+      if (op === "update" && "after" in entry) {
+        row = entry.after;
+      } else if (op === "delete" && "before" in entry) {
+        row = entry.before;
+      }
+    }
+    if (typeof row === "object" && row !== null) {
+      changes.push({ table: event.table, change: { op, row } });
+    }
+  }
+  return changes;
+};
+var mysqlBinlogChangeSource = (options) => {
+  const normalize = options.normalize ?? normalizeBinlogEvent;
+  let unsubscribe;
+  return {
+    start: async (emit) => {
+      unsubscribe = await options.subscribe((event) => {
+        for (const parsed of normalize(event)) {
+          emit(parsed.table, parsed.change);
+        }
+      });
+    },
+    stop: async () => {
+      await unsubscribe?.();
+      unsubscribe = undefined;
+    }
+  };
+};
+export {
+  parseOutboxRow,
+  normalizeBinlogEvent,
+  mysqlChangelogSchema,
+  mysqlBinlogChangeSource,
+  createPollingChangeSource
+};
+
+//# debugId=48EE1E12A50EB47064756E2164756E21
+//# sourceMappingURL=index.js.map

package/dist/adapters/mysql/index.js.map

@@ -0,0 +1,11 @@
+{
+  "version": 3,
+  "sources": ["../src/engine/pollingSource.ts", "../src/adapters/mysql/index.ts"],
+  "sourcesContent": [
+    "import type { ChangeSource, EmitChange, ParsedChange, RowOp } from './types';\n\n/**\n * A database-agnostic CDC {@link ChangeSource} that tails an append-only\n * changelog (outbox) table and emits its rows into the engine.\n *\n * This is the portable way to catch out-of-band writes on databases without a\n * native push channel — MySQL (no `LISTEN/NOTIFY`) and SQLite (no update hook\n * reachable from the JS runtime). Install per-table triggers that append to the\n * changelog (see `@absolutejs/sync/mysql` and `/sqlite`), then poll it here. It\n * is also a fine fallback for Postgres when you'd rather not run `LISTEN`.\n *\n * Driver-agnostic: you supply `poll(sinceSeq)` — a single\n * `SELECT seq, tbl, op, payload FROM <changelog> WHERE seq > ? ORDER BY seq` run\n * with your client — and the adapter tracks the cursor, parses each row, emits,\n * and advances. Delivery is at-least-once across crashes (a row may re-emit if\n * the process dies mid-batch); the engine's per-key last-write-wins makes that\n * safe. Use `onProcessed` to prune the changelog once a watermark is durable.\n */\n\nconst OP_BY_NAME: Record<string, RowOp> = {\n\tinsert: 'insert',\n\tINSERT: 'insert',\n\tupdate: 'update',\n\tUPDATE: 'update',\n\tdelete: 'delete',\n\tDELETE: 'delete'\n};\n\n/** One changelog row, as returned by your `poll` query. */\nexport type OutboxRow = {\n\t/** Monotonic sequence (the cursor advances to the max seen). */\n\tseq: number;\n\t/** Source table the change happened on. */\n\ttbl: string;\n\t/** `insert` | `update` | `delete` (upper- or lower-case). */\n\top: string;\n\t/** The row's captured values — a JSON string or an already-parsed object. */\n\tpayload: unknown;\n};\n\n/**\n * Default changelog-row parser: normalizes `op`, JSON-parses a string `payload`,\n * and returns `{ table, change }`. Returns `undefined` for a malformed row so it\n * is skipped (and its `seq` still advances the cursor) rather than wedging the\n * feed.\n */\nexport const parseOutboxRow = (row: OutboxRow): ParsedChange | undefined => {\n\tif (typeof row.tbl !== 'string') {\n\t\treturn undefined;\n\t}\n\tconst op = OP_BY_NAME[row.op];\n\tif (op === undefined) {\n\t\treturn undefined;\n\t}\n\tlet payload: unknown = row.payload;\n\tif (typeof payload === 'string') {\n\t\ttry {\n\t\t\tpayload = JSON.parse(payload);\n\t\t} catch {\n\t\t\treturn undefined;\n\t\t}\n\t}\n\tif (typeof payload !== 'object' || payload === null) {\n\t\treturn undefined;\n\t}\n\treturn { table: row.tbl, change: { op, row: payload } };\n};\n\nexport type PollingChangeSourceOptions = {\n\t/**\n\t * Fetch changelog rows with `seq > sinceSeq`, ordered by `seq` ascending.\n\t * e.g. `(since) => sql\\`SELECT seq, tbl, op, payload FROM absolute_sync_changelog WHERE seq > ${since} ORDER BY seq\\``.\n\t */\n\tpoll: (sinceSeq: number) => Promise<OutboxRow[]> | OutboxRow[];\n\t/** Poll interval in ms. Defaults to 1000. */\n\tintervalMs?: number;\n\t/** Resume cursor (highest `seq` already processed). Defaults to 0. */\n\tstartSeq?: number;\n\t/** Override the row parser (defaults to {@link parseOutboxRow}). */\n\tparse?: (row: OutboxRow) => ParsedChange | undefined;\n\t/** Called after a non-empty batch with the new watermark — prune here. */\n\tonProcessed?: (uptoSeq: number) => void | Promise<void>;\n\t/** Called if a poll throws (the loop keeps running). Defaults to a warning. */\n\tonError?: (error: unknown) => void;\n};\n\n/**\n * Create a polling {@link ChangeSource} over a changelog table. Connect it with\n * `engine.connectSource(...)`; `start` runs an immediate first poll (draining any\n * backlog) and then polls every `intervalMs` until `stop`.\n */\nexport const createPollingChangeSource = (\n\toptions: PollingChangeSourceOptions\n): ChangeSource => {\n\tconst intervalMs = options.intervalMs ?? 1000;\n\tconst parse = options.parse ?? parseOutboxRow;\n\tconst onError =\n\t\toptions.onError ??\n\t\t((error: unknown) => {\n\t\t\tconsole.warn('[sync] polling change source error:', error);\n\t\t});\n\tlet cursor = options.startSeq ?? 0;\n\tlet running = false;\n\tlet timer: ReturnType<typeof setTimeout> | undefined;\n\n\tconst tick = async (emit: EmitChange): Promise<void> => {\n\t\tif (!running) {\n\t\t\treturn;\n\t\t}\n\t\ttry {\n\t\t\tconst rows = await options.poll(cursor);\n\t\t\tfor (const row of rows) {\n\t\t\t\tconst parsed = parse(row);\n\t\t\t\tif (parsed !== undefined) {\n\t\t\t\t\tawait emit(parsed.table, parsed.change);\n\t\t\t\t}\n\t\t\t\tif (typeof row.seq === 'number' && row.seq > cursor) {\n\t\t\t\t\tcursor = row.seq;\n\t\t\t\t}\n\t\t\t}\n\t\t\tif (rows.length > 0) {\n\t\t\t\tawait options.onProcessed?.(cursor);\n\t\t\t}\n\t\t} catch (error) {\n\t\t\tonError(error);\n\t\t}\n\t\tif (running) {\n\t\t\ttimer = setTimeout(() => {\n\t\t\t\tvoid tick(emit);\n\t\t\t}, intervalMs);\n\t\t}\n\t};\n\n\treturn {\n\t\tstart: async (emit) => {\n\t\t\tif (running) {\n\t\t\t\treturn;\n\t\t\t}\n\t\t\trunning = true;\n\t\t\tawait tick(emit);\n\t\t},\n\t\tstop: () => {\n\t\t\trunning = false;\n\t\t\tif (timer !== undefined) {\n\t\t\t\tclearTimeout(timer);\n\t\t\t\ttimer = undefined;\n\t\t\t}\n\t\t}\n\t};\n};\n",
+    "import type { ChangeSource, ParsedChange, RowOp } from '../../engine/types';\n\n/**\n * MySQL CDC adapter for @absolutejs/sync (Tier 3, M5).\n *\n * MySQL has no `LISTEN/NOTIFY`, so two pluggable strategies catch out-of-band\n * writes — both behind the engine's {@link ChangeSource} seam:\n *\n * - **Changelog + poll (portable).** Install triggers with\n *   {@link mysqlChangelogSchema} and tail the changelog with\n *   {@link createPollingChangeSource}. Works anywhere, no extra privileges.\n * - **Binlog (higher throughput).** Wire a binlog reader (e.g. zongji) into\n *   {@link mysqlBinlogChangeSource}; it normalizes row events into the change\n *   feed. Catches writes without the per-write changelog overhead.\n *\n * Dependency-free — you bring the MySQL client / binlog reader.\n */\n\nexport {\n\tcreatePollingChangeSource,\n\tparseOutboxRow\n} from '../../engine/pollingSource';\nexport type {\n\tOutboxRow,\n\tPollingChangeSourceOptions\n} from '../../engine/pollingSource';\n\nconst DEFAULT_CHANGELOG = 'absolute_sync_changelog';\nconst DEFAULT_PREFIX = 'absolute_sync';\nconst OPS = ['insert', 'update', 'delete'] as const;\n\nexport type MysqlChangelogOptions = {\n\t/** Table name → the column names to capture in the change payload. */\n\ttables: Record<string, string[]>;\n\t/** Changelog table name. Defaults to `absolute_sync_changelog`. */\n\tchangelogTable?: string;\n\t/** Trigger name prefix. Defaults to `absolute_sync`. */\n\tprefix?: string;\n};\n\n/**\n * Generate the SQL that installs the changelog table and per-table\n * insert/update/delete triggers — run it once (e.g. in a migration). Each\n * trigger appends `{ tbl, op, payload }` (payload built with `JSON_OBJECT` from\n * the listed columns) to the changelog for {@link createPollingChangeSource}.\n *\n * Each `CREATE TRIGGER` body is a single statement (no `DELIMITER` needed). The\n * statements are `;`-separated; run them as a script, or split on `;` if your\n * driver executes one statement per call.\n */\nexport const mysqlChangelogSchema = (\n\toptions: MysqlChangelogOptions\n): string => {\n\tconst changelog = options.changelogTable ?? DEFAULT_CHANGELOG;\n\tconst prefix = options.prefix ?? DEFAULT_PREFIX;\n\n\tconst createTable = [\n\t\t`CREATE TABLE IF NOT EXISTS \\`${changelog}\\` (`,\n\t\t'\\tseq BIGINT AUTO_INCREMENT PRIMARY KEY,',\n\t\t'\\ttbl VARCHAR(255) NOT NULL,',\n\t\t'\\top VARCHAR(16) NOT NULL,',\n\t\t'\\tpayload JSON NOT NULL,',\n\t\t'\\tcreated_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP',\n\t\t');'\n\t].join('\\n');\n\n\tconst jsonObject = (columns: string[], ref: 'NEW' | 'OLD'): string =>\n\t\t`JSON_OBJECT(${columns\n\t\t\t.map((column) => `'${column}', ${ref}.\\`${column}\\``)\n\t\t\t.join(', ')})`;\n\n\tconst triggers = Object.entries(options.tables).flatMap(\n\t\t([table, columns]) =>\n\t\t\tOPS.map((op) => {\n\t\t\t\tconst ref = op === 'delete' ? 'OLD' : 'NEW';\n\t\t\t\tconst name = `${prefix}_${table}_${op}`;\n\t\t\t\treturn [\n\t\t\t\t\t`DROP TRIGGER IF EXISTS \\`${name}\\`;`,\n\t\t\t\t\t`CREATE TRIGGER \\`${name}\\` AFTER ${op.toUpperCase()} ON \\`${table}\\` FOR EACH ROW`,\n\t\t\t\t\t`INSERT INTO \\`${changelog}\\` (tbl, op, payload)`,\n\t\t\t\t\t`VALUES ('${table}', '${op}', ${jsonObject(columns, ref)});`\n\t\t\t\t].join('\\n');\n\t\t\t})\n\t);\n\n\treturn [createTable, ...triggers].join('\\n\\n');\n};\n\nconst BINLOG_OP: Record<string, RowOp> = {\n\twriterows: 'insert',\n\tupdaterows: 'update',\n\tdeleterows: 'delete'\n};\n\n/** A row-level binlog event (the subset {@link normalizeBinlogEvent} needs). */\nexport type BinlogRowEvent = {\n\t/**\n\t * Event kind — zongji's `writerows` / `updaterows` / `deleterows`\n\t * (case-insensitive).\n\t */\n\ttype: string;\n\t/** The affected table. */\n\ttable: string;\n\t/**\n\t * Affected rows. Insert/delete: each entry is the row object. Update: each\n\t * entry is `{ before, after }` (zongji's shape).\n\t */\n\trows: unknown[];\n};\n\n/**\n * Normalize a binlog row event into engine changes — one per affected row. For\n * updates it takes the `after` image; for deletes the row (or its `before`\n * image). Rows that aren't objects are skipped. Pure, so it's easy to test and\n * to swap for a different reader's shape.\n */\nexport const normalizeBinlogEvent = (event: BinlogRowEvent): ParsedChange[] => {\n\tconst op = BINLOG_OP[event.type.toLowerCase()];\n\tif (op === undefined || typeof event.table !== 'string') {\n\t\treturn [];\n\t}\n\tconst changes: ParsedChange[] = [];\n\tfor (const entry of event.rows) {\n\t\tlet row: unknown = entry;\n\t\tif (entry !== null && typeof entry === 'object') {\n\t\t\tif (op === 'update' && 'after' in entry) {\n\t\t\t\trow = (entry as { after: unknown }).after;\n\t\t\t} else if (op === 'delete' && 'before' in entry) {\n\t\t\t\trow = (entry as { before: unknown }).before;\n\t\t\t}\n\t\t}\n\t\tif (typeof row === 'object' && row !== null) {\n\t\t\tchanges.push({ table: event.table, change: { op, row } });\n\t\t}\n\t}\n\treturn changes;\n};\n\nexport type MysqlBinlogChangeSourceOptions = {\n\t/**\n\t * Subscribe to row events from a binlog reader; return a function that stops\n\t * it. e.g. with zongji:\n\t * `(onEvent) => { zongji.on('binlog', e => onEvent({ type: e.getEventName(), table: e.tableMap[e.tableId].tableName, rows: e.rows })); zongji.start(...); return () => zongji.stop(); }`.\n\t */\n\tsubscribe: (\n\t\tonEvent: (event: BinlogRowEvent) => void\n\t) => Promise<() => void | Promise<void>> | (() => void | Promise<void>);\n\t/** Override the event normalizer (defaults to {@link normalizeBinlogEvent}). */\n\tnormalize?: (event: BinlogRowEvent) => ParsedChange[];\n};\n\n/**\n * A {@link ChangeSource} backed by the MySQL binlog. Each row event is\n * normalized and emitted into the engine. Connect with\n * `engine.connectSource(...)`.\n */\nexport const mysqlBinlogChangeSource = (\n\toptions: MysqlBinlogChangeSourceOptions\n): ChangeSource => {\n\tconst normalize = options.normalize ?? normalizeBinlogEvent;\n\tlet unsubscribe: (() => void | Promise<void>) | undefined;\n\n\treturn {\n\t\tstart: async (emit) => {\n\t\t\tunsubscribe = await options.subscribe((event) => {\n\t\t\t\tfor (const parsed of normalize(event)) {\n\t\t\t\t\tvoid emit(parsed.table, parsed.change);\n\t\t\t\t}\n\t\t\t});\n\t\t},\n\t\tstop: async () => {\n\t\t\tawait unsubscribe?.();\n\t\t\tunsubscribe = undefined;\n\t\t}\n\t};\n};\n"
+  ],
+  "mappings": "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",
+  "debugId": "48EE1E12A50EB47064756E2164756E21",
+  "names": []
+}

package/dist/adapters/postgres/index.d.ts

@@ -0,0 +1,53 @@
+import type { ChangeSource, ParsedChange } from '../../engine/types';
+/** A parsed change ready to feed the engine. */
+export type ParsedNotification = ParsedChange;
+/**
+ * Default NOTIFY-payload parser: expects the JSON the trigger from
+ * {@link postgresNotifyTrigger} sends — `{ table, op, row }` where `op` is
+ * `INSERT`/`UPDATE`/`DELETE`. Returns `undefined` for anything malformed so a
+ * bad payload is skipped rather than throwing.
+ */
+export declare const parseNotification: (payload: string) => ParsedNotification | undefined;
+export type PostgresChangeSourceOptions = {
+    /**
+     * Subscribe to a Postgres NOTIFY channel; return a function that stops
+     * listening. The wiring is yours, e.g. with porsager/postgres:
+     * `(channel, onNotify) => { const s = await sql.listen(channel, onNotify); return s.unlisten; }`.
+     */
+    listen: (channel: string, onNotify: (payload: string) => void) => Promise<() => void | Promise<void>> | (() => void | Promise<void>);
+    /** NOTIFY channel; must match the trigger's. Defaults to `absolute_sync`. */
+    channel?: string;
+    /** Override the payload parser (defaults to {@link parseNotification}). */
+    parse?: (payload: string) => ParsedNotification | undefined;
+};
+/**
+ * A {@link ChangeSource} backed by Postgres `LISTEN/NOTIFY`. Each notification
+ * is parsed to `(table, change)` and emitted into the engine.
+ *
+ * @example
+ * const disconnect = await engine.connectSource(
+ *   postgresChangeSource({
+ *     listen: async (channel, onNotify) =>
+ *       (await sql.listen(channel, onNotify)).unlisten
+ *   })
+ * );
+ */
+export declare const postgresChangeSource: (options: PostgresChangeSourceOptions) => ChangeSource;
+export type PostgresNotifyTriggerOptions = {
+    /** Tables to emit changes for. */
+    tables: string[];
+    /** NOTIFY channel; must match the change source's. Defaults to `absolute_sync`. */
+    channel?: string;
+    /** Trigger function name. Defaults to `absolute_sync_notify`. */
+    functionName?: string;
+};
+/**
+ * Generate the SQL that installs a NOTIFY trigger on each table — run it once
+ * (e.g. in a migration). On every insert/update/delete it sends
+ * `{ table, op, row }` JSON on the channel for {@link postgresChangeSource}.
+ *
+ * Note: `pg_notify` payloads are capped at 8000 bytes, so very wide rows can be
+ * truncated (the parser then skips them). For large rows or high throughput,
+ * prefer a logical-replication source behind the same {@link ChangeSource} seam.
+ */
+export declare const postgresNotifyTrigger: (options: PostgresNotifyTriggerOptions) => string;

package/dist/adapters/postgres/index.js

@@ -0,0 +1,86 @@
+// @bun
+// src/adapters/postgres/index.ts
+var DEFAULT_CHANNEL = "absolute_sync";
+var DEFAULT_FUNCTION = "absolute_sync_notify";
+var OP_BY_TG = {
+  INSERT: "insert",
+  UPDATE: "update",
+  DELETE: "delete"
+};
+var parseNotification = (payload) => {
+  let data;
+  try {
+    data = JSON.parse(payload);
+  } catch {
+    return;
+  }
+  if (typeof data !== "object" || data === null) {
+    return;
+  }
+  const { table, op, row } = data;
+  if (typeof table !== "string") {
+    return;
+  }
+  const rowOp = typeof op === "string" ? OP_BY_TG[op] : undefined;
+  if (rowOp === undefined) {
+    return;
+  }
+  if (typeof row !== "object" || row === null) {
+    return;
+  }
+  return { table, change: { op: rowOp, row } };
+};
+var postgresChangeSource = (options) => {
+  const channel = options.channel ?? DEFAULT_CHANNEL;
+  const parse = options.parse ?? parseNotification;
+  let unlisten;
+  return {
+    start: async (emit) => {
+      unlisten = await options.listen(channel, (payload) => {
+        const parsed = parse(payload);
+        if (parsed !== undefined) {
+          emit(parsed.table, parsed.change);
+        }
+      });
+    },
+    stop: async () => {
+      await unlisten?.();
+      unlisten = undefined;
+    }
+  };
+};
+var postgresNotifyTrigger = (options) => {
+  const channel = options.channel ?? DEFAULT_CHANNEL;
+  const fn = options.functionName ?? DEFAULT_FUNCTION;
+  const functionSql = [
+    `CREATE OR REPLACE FUNCTION ${fn}() RETURNS trigger AS $$`,
+    "BEGIN",
+    `  PERFORM pg_notify('${channel}', json_build_object(`,
+    `    'table', TG_TABLE_NAME,`,
+    `    'op', TG_OP,`,
+    `    'row', row_to_json(COALESCE(NEW, OLD))`,
+    "  )::text);",
+    "  RETURN COALESCE(NEW, OLD);",
+    "END;",
+    "$$ LANGUAGE plpgsql;"
+  ].join(`
+`);
+  const triggerSql = options.tables.map((table) => [
+    `DROP TRIGGER IF EXISTS ${fn}_${table} ON ${table};`,
+    `CREATE TRIGGER ${fn}_${table}`,
+    `AFTER INSERT OR UPDATE OR DELETE ON ${table}`,
+    `FOR EACH ROW EXECUTE FUNCTION ${fn}();`
+  ].join(`
+`));
+  return [functionSql, ...triggerSql].join(`
+
+`);
+};
+export {
+  postgresNotifyTrigger,
+  postgresChangeSource,
+  parseNotification
+};
+
+//# debugId=0625BCD90123273B64756E2164756E21
+//# sourceMappingURL=index.js.map

package/dist/adapters/postgres/index.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/adapters/postgres/index.ts"],
+  "sourcesContent": [
+    "import type { ChangeSource, ParsedChange, RowOp } from '../../engine/types';\n\n/**\n * Postgres CDC adapter for @absolutejs/sync (Tier 3, M5).\n *\n * Catches writes that didn't go through the mutation API by turning Postgres\n * `LISTEN/NOTIFY` into the engine's change feed. Install the triggers once with\n * {@link postgresNotifyTrigger}, then connect {@link postgresChangeSource} via\n * `engine.connectSource(...)`.\n *\n * Client-agnostic: you supply how to `listen` on a channel, so it works with\n * porsager/postgres (`sql.listen`), node-postgres, or `Bun.sql` — and the\n * adapter itself has no database dependency.\n */\n\nconst DEFAULT_CHANNEL = 'absolute_sync';\nconst DEFAULT_FUNCTION = 'absolute_sync_notify';\n\nconst OP_BY_TG: Record<string, RowOp> = {\n\tINSERT: 'insert',\n\tUPDATE: 'update',\n\tDELETE: 'delete'\n};\n\n/** A parsed change ready to feed the engine. */\nexport type ParsedNotification = ParsedChange;\n\n/**\n * Default NOTIFY-payload parser: expects the JSON the trigger from\n * {@link postgresNotifyTrigger} sends — `{ table, op, row }` where `op` is\n * `INSERT`/`UPDATE`/`DELETE`. Returns `undefined` for anything malformed so a\n * bad payload is skipped rather than throwing.\n */\nexport const parseNotification = (\n\tpayload: string\n): ParsedNotification | undefined => {\n\tlet data: unknown;\n\ttry {\n\t\tdata = JSON.parse(payload);\n\t} catch {\n\t\treturn undefined;\n\t}\n\tif (typeof data !== 'object' || data === null) {\n\t\treturn undefined;\n\t}\n\tconst { table, op, row } = data as {\n\t\ttable?: unknown;\n\t\top?: unknown;\n\t\trow?: unknown;\n\t};\n\tif (typeof table !== 'string') {\n\t\treturn undefined;\n\t}\n\tconst rowOp = typeof op === 'string' ? OP_BY_TG[op] : undefined;\n\tif (rowOp === undefined) {\n\t\treturn undefined;\n\t}\n\tif (typeof row !== 'object' || row === null) {\n\t\treturn undefined;\n\t}\n\treturn { table, change: { op: rowOp, row } };\n};\n\nexport type PostgresChangeSourceOptions = {\n\t/**\n\t * Subscribe to a Postgres NOTIFY channel; return a function that stops\n\t * listening. The wiring is yours, e.g. with porsager/postgres:\n\t * `(channel, onNotify) => { const s = await sql.listen(channel, onNotify); return s.unlisten; }`.\n\t */\n\tlisten: (\n\t\tchannel: string,\n\t\tonNotify: (payload: string) => void\n\t) => Promise<() => void | Promise<void>> | (() => void | Promise<void>);\n\t/** NOTIFY channel; must match the trigger's. Defaults to `absolute_sync`. */\n\tchannel?: string;\n\t/** Override the payload parser (defaults to {@link parseNotification}). */\n\tparse?: (payload: string) => ParsedNotification | undefined;\n};\n\n/**\n * A {@link ChangeSource} backed by Postgres `LISTEN/NOTIFY`. Each notification\n * is parsed to `(table, change)` and emitted into the engine.\n *\n * @example\n * const disconnect = await engine.connectSource(\n *   postgresChangeSource({\n *     listen: async (channel, onNotify) =>\n *       (await sql.listen(channel, onNotify)).unlisten\n *   })\n * );\n */\nexport const postgresChangeSource = (\n\toptions: PostgresChangeSourceOptions\n): ChangeSource => {\n\tconst channel = options.channel ?? DEFAULT_CHANNEL;\n\tconst parse = options.parse ?? parseNotification;\n\tlet unlisten: (() => void | Promise<void>) | undefined;\n\n\treturn {\n\t\tstart: async (emit) => {\n\t\t\tunlisten = await options.listen(channel, (payload) => {\n\t\t\t\tconst parsed = parse(payload);\n\t\t\t\tif (parsed !== undefined) {\n\t\t\t\t\tvoid emit(parsed.table, parsed.change);\n\t\t\t\t}\n\t\t\t});\n\t\t},\n\t\tstop: async () => {\n\t\t\tawait unlisten?.();\n\t\t\tunlisten = undefined;\n\t\t}\n\t};\n};\n\nexport type PostgresNotifyTriggerOptions = {\n\t/** Tables to emit changes for. */\n\ttables: string[];\n\t/** NOTIFY channel; must match the change source's. Defaults to `absolute_sync`. */\n\tchannel?: string;\n\t/** Trigger function name. Defaults to `absolute_sync_notify`. */\n\tfunctionName?: string;\n};\n\n/**\n * Generate the SQL that installs a NOTIFY trigger on each table — run it once\n * (e.g. in a migration). On every insert/update/delete it sends\n * `{ table, op, row }` JSON on the channel for {@link postgresChangeSource}.\n *\n * Note: `pg_notify` payloads are capped at 8000 bytes, so very wide rows can be\n * truncated (the parser then skips them). For large rows or high throughput,\n * prefer a logical-replication source behind the same {@link ChangeSource} seam.\n */\nexport const postgresNotifyTrigger = (\n\toptions: PostgresNotifyTriggerOptions\n): string => {\n\tconst channel = options.channel ?? DEFAULT_CHANNEL;\n\tconst fn = options.functionName ?? DEFAULT_FUNCTION;\n\n\tconst functionSql = [\n\t\t`CREATE OR REPLACE FUNCTION ${fn}() RETURNS trigger AS $$`,\n\t\t'BEGIN',\n\t\t`  PERFORM pg_notify('${channel}', json_build_object(`,\n\t\t`    'table', TG_TABLE_NAME,`,\n\t\t`    'op', TG_OP,`,\n\t\t`    'row', row_to_json(COALESCE(NEW, OLD))`,\n\t\t'  )::text);',\n\t\t'  RETURN COALESCE(NEW, OLD);',\n\t\t'END;',\n\t\t'$$ LANGUAGE plpgsql;'\n\t].join('\\n');\n\n\tconst triggerSql = options.tables.map((table) =>\n\t\t[\n\t\t\t`DROP TRIGGER IF EXISTS ${fn}_${table} ON ${table};`,\n\t\t\t`CREATE TRIGGER ${fn}_${table}`,\n\t\t\t`AFTER INSERT OR UPDATE OR DELETE ON ${table}`,\n\t\t\t`FOR EACH ROW EXECUTE FUNCTION ${fn}();`\n\t\t].join('\\n')\n\t);\n\n\treturn [functionSql, ...triggerSql].join('\\n\\n');\n};\n"
+  ],
+  "mappings": ";;AAeA,IAAM,kBAAkB;AACxB,IAAM,mBAAmB;AAEzB,IAAM,WAAkC;AAAA,EACvC,QAAQ;AAAA,EACR,QAAQ;AAAA,EACR,QAAQ;AACT;AAWO,IAAM,oBAAoB,CAChC,YACoC;AAAA,EACpC,IAAI;AAAA,EACJ,IAAI;AAAA,IACH,OAAO,KAAK,MAAM,OAAO;AAAA,IACxB,MAAM;AAAA,IACP;AAAA;AAAA,EAED,IAAI,OAAO,SAAS,YAAY,SAAS,MAAM;AAAA,IAC9C;AAAA,EACD;AAAA,EACA,QAAQ,OAAO,IAAI,QAAQ;AAAA,EAK3B,IAAI,OAAO,UAAU,UAAU;AAAA,IAC9B;AAAA,EACD;AAAA,EACA,MAAM,QAAQ,OAAO,OAAO,WAAW,SAAS,MAAM;AAAA,EACtD,IAAI,UAAU,WAAW;AAAA,IACxB;AAAA,EACD;AAAA,EACA,IAAI,OAAO,QAAQ,YAAY,QAAQ,MAAM;AAAA,IAC5C;AAAA,EACD;AAAA,EACA,OAAO,EAAE,OAAO,QAAQ,EAAE,IAAI,OAAO,IAAI,EAAE;AAAA;AA+BrC,IAAM,uBAAuB,CACnC,YACkB;AAAA,EAClB,MAAM,UAAU,QAAQ,WAAW;AAAA,EACnC,MAAM,QAAQ,QAAQ,SAAS;AAAA,EAC/B,IAAI;AAAA,EAEJ,OAAO;AAAA,IACN,OAAO,OAAO,SAAS;AAAA,MACtB,WAAW,MAAM,QAAQ,OAAO,SAAS,CAAC,YAAY;AAAA,QACrD,MAAM,SAAS,MAAM,OAAO;AAAA,QAC5B,IAAI,WAAW,WAAW;AAAA,UACpB,KAAK,OAAO,OAAO,OAAO,MAAM;AAAA,QACtC;AAAA,OACA;AAAA;AAAA,IAEF,MAAM,YAAY;AAAA,MACjB,MAAM,WAAW;AAAA,MACjB,WAAW;AAAA;AAAA,EAEb;AAAA;AAqBM,IAAM,wBAAwB,CACpC,YACY;AAAA,EACZ,MAAM,UAAU,QAAQ,WAAW;AAAA,EACnC,MAAM,KAAK,QAAQ,gBAAgB;AAAA,EAEnC,MAAM,cAAc;AAAA,IACnB,8BAA8B;AAAA,IAC9B;AAAA,IACA,wBAAwB;AAAA,IACxB;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACD,EAAE,KAAK;AAAA,CAAI;AAAA,EAEX,MAAM,aAAa,QAAQ,OAAO,IAAI,CAAC,UACtC;AAAA,IACC,0BAA0B,MAAM,YAAY;AAAA,IAC5C,kBAAkB,MAAM;AAAA,IACxB,uCAAuC;AAAA,IACvC,iCAAiC;AAAA,EAClC,EAAE,KAAK;AAAA,CAAI,CACZ;AAAA,EAEA,OAAO,CAAC,aAAa,GAAG,UAAU,EAAE,KAAK;AAAA;AAAA,CAAM;AAAA;",
+  "debugId": "0625BCD90123273B64756E2164756E21",
+  "names": []
+}

package/dist/adapters/prisma/collection.d.ts

@@ -0,0 +1,39 @@
+import type { CollectionContext, CollectionDefinition } from '../../engine/collection';
+import type { RowKey } from '../../engine/types';
+import type { PrismaWhere } from './topics';
+export type PrismaCollectionOptions<T, P, Ctx> = {
+    /** Collection name (change-feed key and topic root). */
+    name: string;
+    /**
+     * The query filter, written once. Used both to hydrate from the database
+     * (passed to `find`) and, mirrored in JS, to match changed rows
+     * incrementally. Receives the subscription's params and context.
+     */
+    where: (params: P, ctx: Ctx) => PrismaWhere;
+    /**
+     * Run the database read for a given `where` — your Prisma call, e.g.
+     * `(where) => prisma.order.findMany({ where })`.
+     */
+    find: (where: PrismaWhere, params: P, ctx: Ctx) => Promise<Iterable<T>> | Iterable<T>;
+    /** Row identity. Defaults to `row.id`. */
+    key?: (row: T) => RowKey;
+    /** Access control; return false (or throw) to deny. */
+    authorize?: (params: P, ctx: Ctx) => boolean | Promise<boolean>;
+};
+/**
+ * Build a syncable {@link CollectionDefinition} for Prisma from a single filter:
+ * `where` is written once and powers both `hydrate` (via your `find`) and the
+ * incremental `match` (via {@link matchesWhere}) — no restating the WHERE.
+ *
+ * If the filter uses an operator the JS matcher can't evaluate, that change
+ * degrades to a refetch (handled by the engine), so the result stays correct.
+ *
+ * @example
+ * prismaCollection({
+ *   name: 'orders',
+ *   where: (p) => ({ userId: p.userId, status: 'open' }),
+ *   find: (where) => prisma.order.findMany({ where }),
+ *   authorize: (p, ctx) => p.userId === ctx.userId
+ * });
+ */
+export declare const prismaCollection: <T, P = void, Ctx = CollectionContext>(options: PrismaCollectionOptions<T, P, Ctx>) => CollectionDefinition<T, P, Ctx>;

package/dist/adapters/prisma/index.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Prisma adapter for @absolutejs/sync (Tier 2 — ORM auto-reactivity).
+ *
+ * The Prisma counterpart of the Drizzle adapter: derive the topics a query
+ * depends on ({@link deriveReadTopics}) and publish the topics a mutation
+ * invalidates ({@link publishChange} and friends). It identifies a model by name
+ * and reads Prisma's plain `where` objects and result records, so it needs no
+ * `@prisma/client` import and works on every database Prisma supports.
+ *
+ * Use the SAME model identifier on the read and write sides — the topic is the
+ * model name verbatim (e.g. `'user'` -> topic `user`, row topic `user:5`).
+ * Granularity is table-level by default, narrowing to a single row when a filter
+ * is a simple key-field equality.
+ */
+export { keyTopic, tableTopic } from './topics';
+export type { PrismaWhere, RowKey } from './topics';
+export { deriveReadTopics } from './read';
+export type { DeriveReadTopicsOptions, DerivedReadTopics } from './read';
+export { publishChange, publishRows, publishWhere } from './write';
+export type { ChangeOp, ChangePayload, PublishChangeOptions, PublishRowsOptions, PublishWhereOptions } from './write';
+export { matchesWhere, UnsupportedFilterError } from './predicate';
+export { prismaCollection } from './collection';
+export type { PrismaCollectionOptions } from './collection';