@syncular/server 0.0.1-100

package/dist/proxy/mutation-detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutation-detector.js","sourceRoot":"","sources":["../../src/proxy/mutation-detector.ts"],"names":[],"mappings":"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"}

package/dist/proxy/oplog.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @syncular/server - Oplog Creation
+ *
+ * Creates sync oplog entries for proxy mutations.
+ */
+import type { SyncOp } from '@syncular/core';
+import { type Kysely } from 'kysely';
+import type { ServerSyncDialect } from '../dialect/types';
+import type { SyncCoreDb } from '../schema';
+import type { ProxyTableHandler } from './types';
+/**
+ * Create oplog entries for affected rows.
+ *
+ * This is called after a mutation to record the changes in the sync oplog,
+ * making them visible to sync clients.
+ */
+export declare function createOplogEntries<DB extends SyncCoreDb>(args: {
+    trx: Kysely<DB>;
+    dialect: ServerSyncDialect;
+    actorId: string;
+    clientId: string;
+    partitionId?: string;
+    shape: ProxyTableHandler;
+    operation: SyncOp;
+    rows: Record<string, unknown>[];
+}): Promise<{
+    commitSeq: number;
+    affectedTables: string[];
+}>;
+//# sourceMappingURL=oplog.d.ts.map

package/dist/proxy/oplog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oplog.d.ts","sourceRoot":"","sources":["../../src/proxy/oplog.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,KAAK,MAAM,EAAO,MAAM,QAAQ,CAAC;AAC1C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AASjD;;;;;GAKG;AACH,wBAAsB,kBAAkB,CAAC,EAAE,SAAS,UAAU,EAAE,IAAI,EAAE;IACpE,GAAG,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,EAAE,iBAAiB,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,iBAAiB,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;CACjC,GAAG,OAAO,CAAC;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CA8G3D"}

package/dist/proxy/oplog.js

@@ -0,0 +1,110 @@
+/**
+ * @syncular/server - Oplog Creation
+ *
+ * Creates sync oplog entries for proxy mutations.
+ */
+import { randomUUID } from 'node:crypto';
+import { sql } from 'kysely';
+/**
+ * Generate a random ID for commit tracking.
+ */
+function generateId() {
+    return randomUUID();
+}
+/**
+ * Create oplog entries for affected rows.
+ *
+ * This is called after a mutation to record the changes in the sync oplog,
+ * making them visible to sync clients.
+ */
+export async function createOplogEntries(args) {
+    const { trx, dialect, actorId, clientId, shape, operation, rows } = args;
+    const partitionId = args.partitionId ?? 'default';
+    if (rows.length === 0) {
+        return { commitSeq: 0, affectedTables: [] };
+    }
+    const pk = shape.primaryKey ?? 'id';
+    const versionCol = shape.versionColumn ?? 'server_version';
+    // Create commit record
+    const commitResult = await sql `
+    insert into ${sql.table('sync_commits')} (
+      partition_id,
+      actor_id,
+      client_id,
+      client_commit_id,
+      meta,
+      result_json
+    )
+    values (
+      ${partitionId},
+      ${actorId},
+      ${clientId},
+      ${`proxy:${generateId()}`},
+      ${null},
+      ${null}
+    )
+    returning commit_seq
+  `.execute(trx);
+    const commitRow = commitResult.rows[0];
+    if (!commitRow) {
+        throw new Error('Failed to insert sync_commits row');
+    }
+    const commitSeq = Number(commitRow.commit_seq);
+    // Compute scopes for all rows and collect changes
+    const affectedTablesSet = new Set();
+    affectedTablesSet.add(shape.table);
+    const changes = rows.map((row) => {
+        const scopes = shape.computeScopes(row);
+        return {
+            commit_seq: commitSeq,
+            partition_id: partitionId,
+            table: shape.table,
+            row_id: String(row[pk]),
+            op: operation,
+            row_json: operation === 'delete' ? null : row,
+            row_version: row[versionCol] != null ? Number(row[versionCol]) : null,
+            scopes: dialect.scopesToDb(scopes),
+        };
+    });
+    // Insert changes
+    await sql `
+	    insert into ${sql.table('sync_changes')} (
+	      commit_seq,
+	      partition_id,
+	      "table",
+	      row_id,
+	      op,
+	      row_json,
+	      row_version,
+	      scopes
+    )
+    values ${sql.join(changes.map((c) => sql `(
+          ${c.commit_seq},
+          ${c.partition_id},
+          ${c.table},
+          ${c.row_id},
+          ${c.op},
+          ${c.row_json},
+          ${c.row_version},
+          ${c.scopes}
+        )`), sql `, `)}
+  `.execute(trx);
+    // Update commit with affected tables
+    const affectedTables = Array.from(affectedTablesSet);
+    const sortedAffectedTables = affectedTables.sort();
+    await sql `
+    update ${sql.table('sync_commits')}
+    set change_count = ${rows.length}, affected_tables = ${sortedAffectedTables}
+    where commit_seq = ${commitSeq}
+  `.execute(trx);
+    // Insert table commits for subscription filtering
+    if (affectedTables.length > 0) {
+        await sql `
+	      insert into ${sql.table('sync_table_commits')} (partition_id, "table", commit_seq)
+	      values ${sql.join(sortedAffectedTables.map((table) => sql `(${partitionId}, ${table}, ${commitSeq})`), sql `, `)}
+	      on conflict (partition_id, "table", commit_seq) do nothing
+	    `.execute(trx);
+    }
+    return { commitSeq, affectedTables };
+}
+//# sourceMappingURL=oplog.js.map

package/dist/proxy/oplog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"oplog.js","sourceRoot":"","sources":["../../src/proxy/oplog.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,EAAe,GAAG,EAAE,MAAM,QAAQ,CAAC;AAK1C;;GAEG;AACH,SAAS,UAAU,GAAW;IAC5B,OAAO,UAAU,EAAE,CAAC;AAAA,CACrB;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAwB,IAS/D,EAA4D;IAC3D,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC;IACzE,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,IAAI,SAAS,CAAC;IAElD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,EAAE,SAAS,EAAE,CAAC,EAAE,cAAc,EAAE,EAAE,EAAE,CAAC;IAC9C,CAAC;IAED,MAAM,EAAE,GAAG,KAAK,CAAC,UAAU,IAAI,IAAI,CAAC;IACpC,MAAM,UAAU,GAAG,KAAK,CAAC,aAAa,IAAI,gBAAgB,CAAC;IAE3D,uBAAuB;IACvB,MAAM,YAAY,GAAG,MAAM,GAAG,CAAwB;kBACtC,GAAG,CAAC,KAAK,CAAC,cAAc,CAAC;;;;;;;;;QASnC,WAAW;QACX,OAAO;QACP,QAAQ;QACR,SAAS,UAAU,EAAE,EAAE;QACvB,IAAI;QACJ,IAAI;;;GAGT,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAEf,MAAM,SAAS,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACvC,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;IACvD,CAAC;IACD,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;IAE/C,kDAAkD;IAClD,MAAM,iBAAiB,GAAG,IAAI,GAAG,EAAU,CAAC;IAC5C,iBAAiB,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAEnC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC;QAChC,MAAM,MAAM,GAAG,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;QAExC,OAAO;YACL,UAAU,EAAE,SAAS;YACrB,YAAY,EAAE,WAAW;YACzB,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACvB,EAAE,EAAE,SAAS;YACb,QAAQ,EAAE,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG;YAC7C,WAAW,EAAE,GAAG,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI;YACrE,MAAM,EAAE,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC;SACnC,CAAC;IAAA,CACH,CAAC,CAAC;IAEH,iBAAiB;IACjB,MAAM,GAAG,CAAA;mBACQ,GAAG,CAAC,KAAK,CAAC,cAAc,CAAC;;;;;;;;;;aAU/B,GAAG,CAAC,IAAI,CACf,OAAO,CAAC,GAAG,CACT,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAA;YACN,CAAC,CAAC,UAAU;YACZ,CAAC,CAAC,YAAY;YACd,CAAC,CAAC,KAAK;YACP,CAAC,CAAC,MAAM;YACR,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,QAAQ;YACV,CAAC,CAAC,WAAW;YACb,CAAC,CAAC,MAAM;UACV,CACH,EACD,GAAG,CAAA,IAAI,CACR;GACF,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAEf,qCAAqC;IACrC,MAAM,cAAc,GAAG,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IACrD,MAAM,oBAAoB,GAAG,cAAc,CAAC,IAAI,EAAE,CAAC;IACnD,MAAM,GAAG,CAAA;aACE,GAAG,CAAC,KAAK,CAAC,cAAc,CAAC;yBACb,IAAI,CAAC,MAAM,uBAAuB,oBAAoB;yBACtD,SAAS;GAC/B,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAEf,kDAAkD;IAClD,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9B,MAAM,GAAG,CAAA;qBACQ,GAAG,CAAC,KAAK,CAAC,oBAAoB,CAAC;gBACpC,GAAG,CAAC,IAAI,CACd,oBAAoB,CAAC,GAAG,CACtB,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,CAAA,IAAI,WAAW,KAAK,KAAK,KAAK,SAAS,GAAG,CACzD,EACD,GAAG,CAAA,IAAI,CACR;;MAEH,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAClB,CAAC;IAED,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,CAAC;AAAA,CACtC"}

package/dist/proxy/registry.d.ts

@@ -0,0 +1,35 @@
+/**
+ * @syncular/server - Proxy Table Registry
+ *
+ * Registry for proxy table handlers.
+ */
+import type { ProxyTableHandler } from './types';
+/**
+ * Registry for proxy table handlers.
+ *
+ * Maps table names to table handlers for oplog generation.
+ */
+export declare class ProxyTableRegistry {
+    private handlers;
+    /**
+     * Register a proxy table handler.
+     */
+    register(handler: ProxyTableHandler): this;
+    /**
+     * Get handler by table name.
+     */
+    get(tableName: string): ProxyTableHandler | undefined;
+    /**
+     * Get handler by table name or throw.
+     */
+    getOrThrow(tableName: string): ProxyTableHandler;
+    /**
+     * Check if a table has a registered handler.
+     */
+    has(tableName: string): boolean;
+    /**
+     * Get all registered handlers.
+     */
+    getAll(): ProxyTableHandler[];
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/proxy/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/proxy/registry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAEjD;;;;GAIG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAwC;IAExD;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI,CAGzC;IAED;;OAEG;IACH,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS,CAEpD;IAED;;OAEG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,iBAAiB,CAM/C;IAED;;OAEG;IACH,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAE9B;IAED;;OAEG;IACH,MAAM,IAAI,iBAAiB,EAAE,CAE5B;CACF"}

package/dist/proxy/registry.js

@@ -0,0 +1,49 @@
+/**
+ * @syncular/server - Proxy Table Registry
+ *
+ * Registry for proxy table handlers.
+ */
+/**
+ * Registry for proxy table handlers.
+ *
+ * Maps table names to table handlers for oplog generation.
+ */
+export class ProxyTableRegistry {
+    handlers = new Map();
+    /**
+     * Register a proxy table handler.
+     */
+    register(handler) {
+        this.handlers.set(handler.table, handler);
+        return this;
+    }
+    /**
+     * Get handler by table name.
+     */
+    get(tableName) {
+        return this.handlers.get(tableName);
+    }
+    /**
+     * Get handler by table name or throw.
+     */
+    getOrThrow(tableName) {
+        const handler = this.handlers.get(tableName);
+        if (!handler) {
+            throw new Error(`No proxy table registered for table: ${tableName}`);
+        }
+        return handler;
+    }
+    /**
+     * Check if a table has a registered handler.
+     */
+    has(tableName) {
+        return this.handlers.has(tableName);
+    }
+    /**
+     * Get all registered handlers.
+     */
+    getAll() {
+        return Array.from(this.handlers.values());
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/proxy/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/proxy/registry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;;;GAIG;AACH,MAAM,OAAO,kBAAkB;IACrB,QAAQ,GAAG,IAAI,GAAG,EAA6B,CAAC;IAExD;;OAEG;IACH,QAAQ,CAAC,OAA0B,EAAQ;QACzC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAC1C,OAAO,IAAI,CAAC;IAAA,CACb;IAED;;OAEG;IACH,GAAG,CAAC,SAAiB,EAAiC;QACpD,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAAA,CACrC;IAED;;OAEG;IACH,UAAU,CAAC,SAAiB,EAAqB;QAC/C,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC7C,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,wCAAwC,SAAS,EAAE,CAAC,CAAC;QACvE,CAAC;QACD,OAAO,OAAO,CAAC;IAAA,CAChB;IAED;;OAEG;IACH,GAAG,CAAC,SAAiB,EAAW;QAC9B,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAAA,CACrC;IAED;;OAEG;IACH,MAAM,GAAwB;QAC5B,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IAAA,CAC3C;CACF"}

package/dist/proxy/types.d.ts

@@ -0,0 +1,44 @@
+/**
+ * @syncular/server - Proxy Types
+ *
+ * Types for database proxy with automatic oplog generation.
+ */
+import type { StoredScopes } from '@syncular/core';
+/**
+ * Proxy table handler for mutations.
+ *
+ * Defines how to compute scopes for rows affected by proxy operations.
+ */
+export interface ProxyTableHandler {
+    /** Database table name */
+    table: string;
+    /** Primary key column name (default: 'id') */
+    primaryKey?: string;
+    /** Version column name (default: 'server_version') */
+    versionColumn?: string;
+    /**
+     * Compute scope values for a row.
+     *
+     * This determines which sync subscriptions will see changes to this row.
+     * Returns a JSONB-compatible object of scope key-value pairs.
+     *
+     * @example
+     * computeScopes: (row) => ({
+     *   user_id: String(row.user_id),
+     *   project_id: String(row.project_id),
+     * })
+     */
+    computeScopes(row: Record<string, unknown>): StoredScopes;
+}
+/**
+ * Context for executing a proxied query.
+ */
+export interface ProxyQueryContext {
+    /** Actor ID for oplog tracking */
+    actorId: string;
+    /** Client ID for oplog tracking */
+    clientId: string;
+    /** Logical partition key (default: 'default') */
+    partitionId?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/proxy/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/proxy/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,0BAA0B;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,8CAA8C;IAC9C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sDAAsD;IACtD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;;;;;;;;OAWG;IACH,aAAa,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,YAAY,CAAC;CAC3D;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,mCAAmC;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,iDAAiD;IACjD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB"}

package/dist/proxy/types.js

@@ -0,0 +1,7 @@
+/**
+ * @syncular/server - Proxy Types
+ *
+ * Types for database proxy with automatic oplog generation.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/proxy/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/proxy/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/prune.d.ts

@@ -0,0 +1,37 @@
+/**
+ * @syncular/server - Pruning utilities
+ *
+ * Pruning strategy (initial):
+ * - Track per-client cursors in `sync_client_cursors`
+ * - Consider a client "active" if it has pulled within `activeWindowMs`
+ * - Compute watermark = min(cursor) across active clients (ignoring cursor < 0)
+ * - Delete commits with commit_seq <= watermark (cascade deletes changes)
+ *
+ * Clients behind pruned history will be forced to bootstrap.
+ */
+import type { Kysely } from 'kysely';
+import type { SyncCoreDb } from './schema';
+export interface PruneOptions {
+    /** Clients with updated_at older than this are ignored for watermark. Default: 14 days. */
+    activeWindowMs?: number;
+    /**
+     * Time-based retention safety cap.
+     *
+     * The server prunes commits older than this age even if watermark pruning
+     * is stuck (e.g. a client never advances).
+     * Default: 30 days.
+     */
+    fallbackMaxAgeMs?: number;
+    /** Soft cap: keep at least this many newest commits even if watermark is high. Default: 1000. */
+    keepNewestCommits?: number;
+}
+export declare function computePruneWatermarkCommitSeq<DB extends SyncCoreDb>(db: Kysely<DB>, options?: PruneOptions): Promise<number>;
+export declare function pruneSync<DB extends SyncCoreDb>(db: Kysely<DB>, args: {
+    watermarkCommitSeq: number;
+    keepNewestCommits?: number;
+}): Promise<number>;
+export declare function maybePruneSync<DB extends SyncCoreDb>(db: Kysely<DB>, args: {
+    minIntervalMs: number;
+    options?: PruneOptions;
+}): Promise<number>;
+//# sourceMappingURL=prune.d.ts.map

package/dist/prune.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prune.d.ts","sourceRoot":"","sources":["../src/prune.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAGV,MAAM,EAGP,MAAM,QAAQ,CAAC;AAEhB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAgB3C,MAAM,WAAW,YAAY;IAC3B,2FAA2F;IAC3F,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iGAAiG;IACjG,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,wBAAsB,8BAA8B,CAAC,EAAE,SAAS,UAAU,EACxE,EAAE,EAAE,MAAM,CAAC,EAAE,CAAC,EACd,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,MAAM,CAAC,CAoCjB;AAED,wBAAsB,SAAS,CAAC,EAAE,SAAS,UAAU,EACnD,EAAE,EAAE,MAAM,CAAC,EAAE,CAAC,EACd,IAAI,EAAE;IAAE,kBAAkB,EAAE,MAAM,CAAC;IAAC,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/D,OAAO,CAAC,MAAM,CAAC,CA0DjB;AAqBD,wBAAsB,cAAc,CAAC,EAAE,SAAS,UAAU,EACxD,EAAE,EAAE,MAAM,CAAC,EAAE,CAAC,EACd,IAAI,EAAE;IAAE,aAAa,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,YAAY,CAAA;CAAE,GACtD,OAAO,CAAC,MAAM,CAAC,CAsBjB"}

package/dist/prune.js

@@ -0,0 +1,112 @@
+/**
+ * @syncular/server - Pruning utilities
+ *
+ * Pruning strategy (initial):
+ * - Track per-client cursors in `sync_client_cursors`
+ * - Consider a client "active" if it has pulled within `activeWindowMs`
+ * - Compute watermark = min(cursor) across active clients (ignoring cursor < 0)
+ * - Delete commits with commit_seq <= watermark (cascade deletes changes)
+ *
+ * Clients behind pruned history will be forced to bootstrap.
+ */
+import { sql } from 'kysely';
+function coerceNumber(value) {
+    if (value === null || value === undefined)
+        return null;
+    if (typeof value === 'number')
+        return Number.isFinite(value) ? value : null;
+    if (typeof value === 'bigint')
+        return Number.isFinite(Number(value)) ? Number(value) : null;
+    if (typeof value === 'string') {
+        const n = Number(value);
+        return Number.isFinite(n) ? n : null;
+    }
+    return null;
+}
+export async function computePruneWatermarkCommitSeq(db, options = {}) {
+    const syncDb = db;
+    const activeWindowMs = options.activeWindowMs ?? 14 * 24 * 60 * 60 * 1000;
+    const cutoffIso = new Date(Date.now() - activeWindowMs).toISOString();
+    const cursorsQ = syncDb.selectFrom('sync_client_cursors');
+    const row = await cursorsQ
+        .select(({ fn }) => fn.min('cursor').as('minCursor'))
+        .where(sql `updated_at >= ${cutoffIso}`)
+        .where(sql `cursor >= ${0}`)
+        .executeTakeFirst();
+    const minCursor = coerceNumber(row?.minCursor) ?? 0;
+    const fallbackMaxAgeMs = options.fallbackMaxAgeMs ?? 30 * 24 * 60 * 60 * 1000;
+    if (fallbackMaxAgeMs <= 0)
+        return minCursor;
+    const ageCutoffIso = new Date(Date.now() - fallbackMaxAgeMs).toISOString();
+    const commitsQ = syncDb.selectFrom('sync_commits');
+    const ageRow = await commitsQ
+        .select(({ fn }) => fn.max('commit_seq').as('maxSeq'))
+        .where(sql `created_at < ${ageCutoffIso}`)
+        .executeTakeFirst();
+    const ageSeq = coerceNumber(ageRow?.maxSeq) ?? 0;
+    return Math.max(minCursor, ageSeq);
+}
+export async function pruneSync(db, args) {
+    if (args.watermarkCommitSeq <= 0)
+        return 0;
+    const syncDb = db;
+    const keepNewestCommits = args.keepNewestCommits ?? 1000;
+    // Don't delete the newest N commits (even if watermark is higher)
+    const commitsQ = syncDb.selectFrom('sync_commits');
+    const maxRow = await commitsQ
+        .select(({ fn }) => fn.max('commit_seq').as('maxSeq'))
+        .executeTakeFirst();
+    const maxSeq = coerceNumber(maxRow?.maxSeq) ?? 0;
+    const minKept = Math.max(0, maxSeq - keepNewestCommits);
+    const pruneUpTo = Math.min(args.watermarkCommitSeq, minKept);
+    if (pruneUpTo <= 0)
+        return 0;
+    // Delete dependent rows explicitly to be robust across dialects and older
+    // schemas that may not have FK cascade enabled.
+    await syncDb.deleteFrom('sync_table_commits')
+        .where(sql `commit_seq <= ${pruneUpTo}`)
+        .executeTakeFirst();
+    await syncDb.deleteFrom('sync_changes')
+        .where(sql `commit_seq <= ${pruneUpTo}`)
+        .executeTakeFirst();
+    const res = await syncDb.deleteFrom('sync_commits')
+        .where(sql `commit_seq <= ${pruneUpTo}`)
+        .executeTakeFirst();
+    return Number(res?.numDeletedRows ?? 0);
+}
+const pruneStateByDb = new WeakMap();
+function getPruneState(db) {
+    const existing = pruneStateByDb.get(db);
+    if (existing)
+        return existing;
+    const created = {
+        lastPruneAtMs: 0,
+        pruneInFlight: null,
+    };
+    pruneStateByDb.set(db, created);
+    return created;
+}
+export async function maybePruneSync(db, args) {
+    const state = getPruneState(db);
+    const now = Date.now();
+    if (now - state.lastPruneAtMs < args.minIntervalMs)
+        return 0;
+    if (state.pruneInFlight)
+        return state.pruneInFlight;
+    state.pruneInFlight = (async () => {
+        try {
+            const watermark = await computePruneWatermarkCommitSeq(db, args.options);
+            const deleted = await pruneSync(db, {
+                watermarkCommitSeq: watermark,
+                keepNewestCommits: args.options?.keepNewestCommits,
+            });
+            state.lastPruneAtMs = Date.now();
+            return deleted;
+        }
+        finally {
+            state.pruneInFlight = null;
+        }
+    })();
+    return state.pruneInFlight;
+}
+//# sourceMappingURL=prune.js.map

package/dist/prune.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prune.js","sourceRoot":"","sources":["../src/prune.ts"],"names":[],"mappings":"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"}

package/dist/pull.d.ts

@@ -0,0 +1,31 @@
+import { type ScopeValues, type SyncPullRequest, type SyncPullResponse } from '@syncular/core';
+import type { Kysely } from 'kysely';
+import type { ServerSyncDialect } from './dialect/types';
+import type { SyncCoreDb } from './schema';
+import type { TableRegistry } from './shapes/registry';
+import type { SnapshotChunkStorage } from './snapshot-chunks/types';
+export interface PullResult {
+    response: SyncPullResponse;
+    /**
+     * Effective scopes for all active subscriptions (for cursor tracking).
+     * Maps subscription ID to effective scopes.
+     */
+    effectiveScopes: ScopeValues;
+    /** Minimum nextCursor across active subscriptions (for pruning cursor tracking). */
+    clientCursor: number;
+}
+export declare function pull<DB extends SyncCoreDb>(args: {
+    db: Kysely<DB>;
+    dialect: ServerSyncDialect;
+    shapes: TableRegistry<DB>;
+    actorId: string;
+    partitionId?: string;
+    request: SyncPullRequest;
+    /**
+     * Optional snapshot chunk storage adapter.
+     * When provided, stores chunk bodies in external storage (S3, etc.)
+     * instead of inline in the database.
+     */
+    chunkStorage?: SnapshotChunkStorage;
+}): Promise<PullResult>;
+//# sourceMappingURL=pull.d.ts.map

package/dist/pull.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pull.d.ts","sourceRoot":"","sources":["../src/pull.ts"],"names":[],"mappings":"AAGA,OAAO,EAML,KAAK,WAAW,EAMhB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EAItB,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACrC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAKvD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAiFpE,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,gBAAgB,CAAC;IAC3B;;;OAGG;IACH,eAAe,EAAE,WAAW,CAAC;IAC7B,oFAAoF;IACpF,YAAY,EAAE,MAAM,CAAC;CACtB;AA0JD,wBAAsB,IAAI,CAAC,EAAE,SAAS,UAAU,EAAE,IAAI,EAAE;IACtD,EAAE,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;IACf,OAAO,EAAE,iBAAiB,CAAC;IAC3B,MAAM,EAAE,aAAa,CAAC,EAAE,CAAC,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,eAAe,CAAC;IACzB;;;;OAIG;IACH,YAAY,CAAC,EAAE,oBAAoB,CAAC;CACrC,GAAG,OAAO,CAAC,UAAU,CAAC,CA2jBtB"}