@syncular/server 0.0.1-60

package/dist/proxy/handler.js

@@ -0,0 +1,99 @@
+/**
+ * @syncular/server - Proxy Query Handler
+ *
+ * Executes proxied queries with automatic oplog generation for mutations.
+ */
+import { sql } from 'kysely';
+import { appendReturning, detectMutation, hasReturningClause, } from './mutation-detector';
+import { createOplogEntries } from './oplog';
+/**
+ * Build a raw SQL query with parameters using Kysely's sql helper.
+ *
+ * This converts parameterized SQL (using $1, $2, etc.) to Kysely's format.
+ */
+function buildRawQuery(sqlQuery, parameters) {
+    // If no parameters, just use sql.raw
+    if (parameters.length === 0) {
+        return sql.raw(sqlQuery);
+    }
+    // Parse the SQL and split by parameter placeholders ($1, $2, etc.)
+    // Then use sql.join to build the query with proper parameter binding
+    const parts = [];
+    let lastIndex = 0;
+    const paramRegex = /\$(\d+)/g;
+    let match;
+    while ((match = paramRegex.exec(sqlQuery)) !== null) {
+        // Add the SQL before this parameter
+        if (match.index > lastIndex) {
+            parts.push(sql.raw(sqlQuery.slice(lastIndex, match.index)));
+        }
+        // Add the parameter value (1-indexed in SQL, 0-indexed in array)
+        const paramIndex = Number.parseInt(match[1], 10) - 1;
+        if (paramIndex >= 0 && paramIndex < parameters.length) {
+            // Use sql.value to create a proper parameter binding
+            parts.push(sql.val(parameters[paramIndex]));
+        }
+        else {
+            // Keep the original placeholder if out of bounds (shouldn't happen)
+            parts.push(sql.raw(match[0]));
+        }
+        lastIndex = match.index + match[0].length;
+    }
+    // Add remaining SQL after last parameter
+    if (lastIndex < sqlQuery.length) {
+        parts.push(sql.raw(sqlQuery.slice(lastIndex)));
+    }
+    // Join all parts together
+    return sql.join(parts, sql.raw(''));
+}
+/**
+ * Execute a proxied query with automatic oplog generation for mutations.
+ *
+ * - Read queries: Execute directly and return rows
+ * - Mutations: Append RETURNING *, execute, create oplog entries
+ */
+export async function executeProxyQuery(args) {
+    const { db, dialect, shapes, ctx, sqlQuery, parameters } = args;
+    const mutation = detectMutation(sqlQuery);
+    if (!mutation) {
+        // Read query - execute directly
+        const result = await buildRawQuery(sqlQuery, parameters).execute(db);
+        return { rows: result.rows };
+    }
+    // Check if this table has a registered shape
+    const shape = shapes.get(mutation.tableName);
+    if (!shape) {
+        // No shape registered - execute without oplog
+        // This allows proxy operations on non-synced tables
+        const result = await buildRawQuery(sqlQuery, parameters).execute(db);
+        return {
+            rows: result.rows,
+            rowCount: Number(result.numAffectedRows ?? 0),
+        };
+    }
+    // Mutation with registered shape - append RETURNING * and create oplog
+    const needsReturning = !hasReturningClause(sqlQuery);
+    const finalSql = needsReturning ? appendReturning(sqlQuery) : sqlQuery;
+    const result = await buildRawQuery(finalSql, parameters).execute(db);
+    const affectedRows = result.rows;
+    if (affectedRows.length === 0) {
+        return { rowCount: 0 };
+    }
+    // Create oplog entries
+    const { commitSeq, affectedTables } = await createOplogEntries({
+        trx: db,
+        dialect,
+        actorId: ctx.actorId,
+        clientId: ctx.clientId,
+        partitionId: ctx.partitionId,
+        shape,
+        operation: mutation.operation,
+        rows: affectedRows,
+    });
+    return {
+        rowCount: affectedRows.length,
+        commitSeq,
+        affectedTables,
+    };
+}
+//# sourceMappingURL=handler.js.map

package/dist/proxy/handler.js.map

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

package/dist/proxy/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @syncular/server - Proxy Exports
+ *
+ * Server-side proxy functionality for database access.
+ */
+export { type ExecuteProxyQueryArgs, type ExecuteProxyQueryResult, executeProxyQuery, } from './handler';
+export { type DetectedMutation, detectMutation } from './mutation-detector';
+export { ProxyTableRegistry } from './registry';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/proxy/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EACL,KAAK,qBAAqB,EAC1B,KAAK,uBAAuB,EAC5B,iBAAiB,GAClB,MAAM,WAAW,CAAC;AAEnB,OAAO,EAAE,KAAK,gBAAgB,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAG5E,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC"}

package/dist/proxy/index.js

@@ -0,0 +1,14 @@
+/**
+ * @syncular/server - Proxy Exports
+ *
+ * Server-side proxy functionality for database access.
+ */
+// Query execution
+export { executeProxyQuery, } from './handler';
+// Mutation detection
+export { detectMutation } from './mutation-detector';
+// Oplog creation
+// Registry
+export { ProxyTableRegistry } from './registry';
+// Types
+//# sourceMappingURL=index.js.map

package/dist/proxy/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/proxy/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,kBAAkB;AAClB,OAAO,EAGL,iBAAiB,GAClB,MAAM,WAAW,CAAC;AACnB,qBAAqB;AACrB,OAAO,EAAyB,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC5E,iBAAiB;AACjB,WAAW;AACX,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,QAAQ"}

package/dist/proxy/mutation-detector.d.ts

@@ -0,0 +1,31 @@
+/**
+ * @syncular/server - Mutation Detector
+ *
+ * Detects whether a SQL query is a mutation (INSERT/UPDATE/DELETE).
+ */
+import type { SyncOp } from '@syncular/core';
+export interface DetectedMutation {
+    /** Operation type */
+    operation: SyncOp;
+    /** Table name being modified */
+    tableName: string;
+}
+/**
+ * Detect if a SQL query is a mutation and extract table info.
+ *
+ * @param sql - The SQL query string
+ * @returns Mutation info if detected, null for read queries
+ */
+export declare function detectMutation(sql: string): DetectedMutation | null;
+/**
+ * Check if SQL already has a RETURNING clause.
+ */
+export declare function hasReturningClause(sql: string): boolean;
+/**
+ * Append RETURNING * to a mutation query if not already present.
+ *
+ * @param sql - The SQL query string
+ * @returns Modified SQL with RETURNING *
+ */
+export declare function appendReturning(sql: string): string;
+//# sourceMappingURL=mutation-detector.d.ts.map

package/dist/proxy/mutation-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutation-detector.d.ts","sourceRoot":"","sources":["../../src/proxy/mutation-detector.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAE7C,MAAM,WAAW,gBAAgB;IAC/B,qBAAqB;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CAqCnE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAGvD;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAQnD"}

package/dist/proxy/mutation-detector.js

@@ -0,0 +1,61 @@
+/**
+ * @syncular/server - Mutation Detector
+ *
+ * Detects whether a SQL query is a mutation (INSERT/UPDATE/DELETE).
+ */
+/**
+ * Detect if a SQL query is a mutation and extract table info.
+ *
+ * @param sql - The SQL query string
+ * @returns Mutation info if detected, null for read queries
+ */
+export function detectMutation(sql) {
+    const trimmed = sql.trim();
+    // INSERT INTO [schema.]table
+    const insertMatch = trimmed.match(/^\s*INSERT\s+INTO\s+(?:["']?(\w+)["']?\.)?["']?(\w+)["']?/i);
+    if (insertMatch) {
+        return {
+            operation: 'upsert',
+            tableName: insertMatch[2],
+        };
+    }
+    // UPDATE [schema.]table
+    const updateMatch = trimmed.match(/^\s*UPDATE\s+(?:["']?(\w+)["']?\.)?["']?(\w+)["']?/i);
+    if (updateMatch) {
+        return {
+            operation: 'upsert',
+            tableName: updateMatch[2],
+        };
+    }
+    // DELETE FROM [schema.]table
+    const deleteMatch = trimmed.match(/^\s*DELETE\s+FROM\s+(?:["']?(\w+)["']?\.)?["']?(\w+)["']?/i);
+    if (deleteMatch) {
+        return {
+            operation: 'delete',
+            tableName: deleteMatch[2],
+        };
+    }
+    return null;
+}
+/**
+ * Check if SQL already has a RETURNING clause.
+ */
+export function hasReturningClause(sql) {
+    // Simple check - look for RETURNING keyword not in a string
+    return /\bRETURNING\b/i.test(sql);
+}
+/**
+ * Append RETURNING * to a mutation query if not already present.
+ *
+ * @param sql - The SQL query string
+ * @returns Modified SQL with RETURNING *
+ */
+export function appendReturning(sql) {
+    if (hasReturningClause(sql)) {
+        return sql;
+    }
+    // Remove trailing semicolon if present
+    const trimmed = sql.trim().replace(/;\s*$/, '');
+    return `${trimmed} RETURNING *`;
+}
+//# sourceMappingURL=mutation-detector.js.map

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":"AAAA;;;;GAIG;AAWH;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,GAAW,EAA2B;IACnE,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IAE3B,6BAA6B;IAC7B,MAAM,WAAW,GAAG,OAAO,CAAC,KAAK,CAC/B,4DAA4D,CAC7D,CAAC;IACF,IAAI,WAAW,EAAE,CAAC;QAChB,OAAO;YACL,SAAS,EAAE,QAAQ;YACnB,SAAS,EAAE,WAAW,CAAC,CAAC,CAAE;SAC3B,CAAC;IACJ,CAAC;IAED,wBAAwB;IACxB,MAAM,WAAW,GAAG,OAAO,CAAC,KAAK,CAC/B,qDAAqD,CACtD,CAAC;IACF,IAAI,WAAW,EAAE,CAAC;QAChB,OAAO;YACL,SAAS,EAAE,QAAQ;YACnB,SAAS,EAAE,WAAW,CAAC,CAAC,CAAE;SAC3B,CAAC;IACJ,CAAC;IAED,6BAA6B;IAC7B,MAAM,WAAW,GAAG,OAAO,CAAC,KAAK,CAC/B,4DAA4D,CAC7D,CAAC;IACF,IAAI,WAAW,EAAE,CAAC;QAChB,OAAO;YACL,SAAS,EAAE,QAAQ;YACnB,SAAS,EAAE,WAAW,CAAC,CAAC,CAAE;SAC3B,CAAC;IACJ,CAAC;IAED,OAAO,IAAI,CAAC;AAAA,CACb;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAW,EAAW;IACvD,4DAA4D;IAC5D,OAAO,gBAAgB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAAA,CACnC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,GAAW,EAAU;IACnD,IAAI,kBAAkB,CAAC,GAAG,CAAC,EAAE,CAAC;QAC5B,OAAO,GAAG,CAAC;IACb,CAAC;IAED,uCAAuC;IACvC,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAChD,OAAO,GAAG,OAAO,cAAc,CAAC;AAAA,CACjC"}

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,CA4G3D"}

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,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,CAAA,IAAI,WAAW,KAAK,KAAK,KAAK,SAAS,GAAG,CAAC,EAClF,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"}