@syncular/server 0.0.1-100

package/dist/helpers/scope-strings.js

@@ -0,0 +1,82 @@
+/**
+ * @syncular/server - Scope string utilities
+ *
+ * Helpers for creating and parsing scope strings.
+ * Scope strings identify partitions of data for sync subscriptions.
+ */
+/**
+ * Create a scope string from a prefix and values.
+ *
+ * Scope strings use colon separators: `prefix:value1:value2`
+ *
+ * @example
+ * ```typescript
+ * // Simple scope string
+ * createScopeKey('user', 'alice')
+ * // => 'user:alice'
+ *
+ * // Multi-value scope string
+ * createScopeKey('user', 'alice', 'project', 'proj-1')
+ * // => 'user:alice:project:proj-1'
+ * ```
+ */
+export function createScopeKey(prefix, ...values) {
+    return [prefix, ...values].join(':');
+}
+/**
+ * Parse a scope string into its prefix and values.
+ *
+ * Returns null if the key is invalid or doesn't match the expected prefix.
+ *
+ * @example
+ * ```typescript
+ * // Parse any scope string
+ * parseScopeKey('user:alice')
+ * // => { prefix: 'user', values: ['alice'] }
+ *
+ * // Parse with expected prefix
+ * parseScopeKey('user:alice', 'user')
+ * // => { prefix: 'user', values: ['alice'] }
+ *
+ * // Returns null if prefix doesn't match
+ * parseScopeKey('user:alice', 'project')
+ * // => null
+ *
+ * // Multi-value scope string
+ * parseScopeKey('user:alice:project:proj-1')
+ * // => { prefix: 'user', values: ['alice', 'project', 'proj-1'] }
+ * ```
+ */
+export function parseScopeKey(key, expectedPrefix) {
+    const parts = key.split(':');
+    if (parts.length < 1)
+        return null;
+    const [prefix, ...values] = parts;
+    if (!prefix)
+        return null;
+    // Check expected prefix if provided
+    if (expectedPrefix && prefix !== expectedPrefix)
+        return null;
+    return { prefix, values };
+}
+/**
+ * Extract a specific value from a scope string by index.
+ *
+ * @example
+ * ```typescript
+ * // Get first value after prefix
+ * getScopeKeyValue('user:alice:project:proj-1', 0)
+ * // => 'alice'
+ *
+ * // Get second value
+ * getScopeKeyValue('user:alice:project:proj-1', 2)
+ * // => 'proj-1'
+ * ```
+ */
+export function getScopeKeyValue(key, valueIndex) {
+    const parsed = parseScopeKey(key);
+    if (!parsed)
+        return null;
+    return parsed.values[valueIndex] ?? null;
+}
+//# sourceMappingURL=scope-strings.js.map

package/dist/helpers/scope-strings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope-strings.js","sourceRoot":"","sources":["../../src/helpers/scope-strings.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAYH;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,cAAc,CAAC,MAAc,EAAE,GAAG,MAAgB,EAAU;IAC1E,OAAO,CAAC,MAAM,EAAE,GAAG,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAAA,CACtC;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,UAAU,aAAa,CAC3B,GAAW,EACX,cAAuB,EACA;IACvB,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC7B,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAElC,MAAM,CAAC,MAAM,EAAE,GAAG,MAAM,CAAC,GAAG,KAAK,CAAC;IAClC,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IAEzB,oCAAoC;IACpC,IAAI,cAAc,IAAI,MAAM,KAAK,cAAc;QAAE,OAAO,IAAI,CAAC;IAE7D,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;AAAA,CAC3B;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,gBAAgB,CAC9B,GAAW,EACX,UAAkB,EACH;IACf,MAAM,MAAM,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;IAClC,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IACzB,OAAO,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC;AAAA,CAC1C"}

package/dist/index.d.ts

@@ -0,0 +1,28 @@
+/**
+ * @syncular/server - Server-side sync infrastructure
+ *
+ * Commit-log based sync with:
+ * - commit log + change log
+ * - scopes + subscriptions (partial sync + auth)
+ * - commit-level idempotency
+ * - blob/media storage
+ */
+export * from '@syncular/core';
+export * from './blobs';
+export * from './clients';
+export * from './compaction';
+export * from './dialect';
+export * from './helpers';
+export * from './migrate';
+export * from './proxy';
+export * from './prune';
+export * from './pull';
+export * from './push';
+export * from './realtime';
+export * from './schema';
+export * from './shapes';
+export * from './snapshot-chunks';
+export type { SnapshotChunkStorage } from './snapshot-chunks/types';
+export * from './stats';
+export * from './subscriptions';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,cAAc,gBAAgB,CAAC;AAE/B,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,mBAAmB,CAAC;AAClC,YAAY,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AACpE,cAAc,SAAS,CAAC;AACxB,cAAc,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,27 @@
+/**
+ * @syncular/server - Server-side sync infrastructure
+ *
+ * Commit-log based sync with:
+ * - commit log + change log
+ * - scopes + subscriptions (partial sync + auth)
+ * - commit-level idempotency
+ * - blob/media storage
+ */
+export * from '@syncular/core';
+export * from './blobs/index.js';
+export * from './clients.js';
+export * from './compaction.js';
+export * from './dialect/index.js';
+export * from './helpers/index.js';
+export * from './migrate.js';
+export * from './proxy/index.js';
+export * from './prune.js';
+export * from './pull.js';
+export * from './push.js';
+export * from './realtime/index.js';
+export * from './schema.js';
+export * from './shapes/index.js';
+export * from './snapshot-chunks.js';
+export * from './stats.js';
+export * from './subscriptions/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,cAAc,gBAAgB,CAAC;AAE/B,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,mBAAmB,CAAC;AAElC,cAAc,SAAS,CAAC;AACxB,cAAc,iBAAiB,CAAC"}

package/dist/migrate.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @syncular/server - Schema setup
+ */
+import type { Kysely } from 'kysely';
+import type { ServerSyncDialect } from './dialect/types';
+import type { SyncCoreDb } from './schema';
+/**
+ * Ensures the sync schema exists in the database.
+ * Safe to call multiple times (idempotent).
+ *
+ * @typeParam DB - Your database type that extends SyncCoreDb
+ */
+export declare function ensureSyncSchema<DB extends SyncCoreDb>(db: Kysely<DB>, dialect: ServerSyncDialect): Promise<void>;
+//# sourceMappingURL=migrate.d.ts.map

package/dist/migrate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate.d.ts","sourceRoot":"","sources":["../src/migrate.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,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;AAE3C;;;;;GAKG;AACH,wBAAsB,gBAAgB,CAAC,EAAE,SAAS,UAAU,EAC1D,EAAE,EAAE,MAAM,CAAC,EAAE,CAAC,EACd,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,IAAI,CAAC,CAEf"}

package/dist/migrate.js

@@ -0,0 +1,13 @@
+/**
+ * @syncular/server - Schema setup
+ */
+/**
+ * Ensures the sync schema exists in the database.
+ * Safe to call multiple times (idempotent).
+ *
+ * @typeParam DB - Your database type that extends SyncCoreDb
+ */
+export async function ensureSyncSchema(db, dialect) {
+    await dialect.ensureSyncSchema(db);
+}
+//# sourceMappingURL=migrate.js.map

package/dist/migrate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate.js","sourceRoot":"","sources":["../src/migrate.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,EAAc,EACd,OAA0B,EACX;IACf,MAAM,OAAO,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAC;AAAA,CACpC"}

package/dist/proxy/handler.d.ts

@@ -0,0 +1,42 @@
+/**
+ * @syncular/server - Proxy Query Handler
+ *
+ * Executes proxied queries with automatic oplog generation for mutations.
+ */
+import type { Kysely } from 'kysely';
+import type { ServerSyncDialect } from '../dialect/types';
+import type { SyncCoreDb } from '../schema';
+import type { ProxyTableRegistry } from './registry';
+import type { ProxyQueryContext } from './types';
+export interface ExecuteProxyQueryArgs<DB extends SyncCoreDb = SyncCoreDb> {
+    /** Database connection or transaction */
+    db: Kysely<DB>;
+    /** Server sync dialect */
+    dialect: ServerSyncDialect;
+    /** Proxy table registry for oplog generation */
+    shapes: ProxyTableRegistry;
+    /** Query context (actor/client IDs) */
+    ctx: ProxyQueryContext;
+    /** SQL query string */
+    sqlQuery: string;
+    /** Query parameters */
+    parameters: readonly unknown[];
+}
+export interface ExecuteProxyQueryResult {
+    /** Query result rows (for SELECT or RETURNING) */
+    rows?: unknown[];
+    /** Number of affected rows (for mutations) */
+    rowCount?: number;
+    /** Commit sequence if oplog was created */
+    commitSeq?: number;
+    /** Affected tables if oplog was created */
+    affectedTables?: string[];
+}
+/**
+ * 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 declare function executeProxyQuery<DB extends SyncCoreDb>(args: ExecuteProxyQueryArgs<DB>): Promise<ExecuteProxyQueryResult>;
+//# sourceMappingURL=handler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../src/proxy/handler.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAc,MAAM,QAAQ,CAAC;AAEjD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAQ5C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAEjD,MAAM,WAAW,qBAAqB,CAAC,EAAE,SAAS,UAAU,GAAG,UAAU;IACvE,yCAAyC;IACzC,EAAE,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;IACf,0BAA0B;IAC1B,OAAO,EAAE,iBAAiB,CAAC;IAC3B,gDAAgD;IAChD,MAAM,EAAE,kBAAkB,CAAC;IAC3B,uCAAuC;IACvC,GAAG,EAAE,iBAAiB,CAAC;IACvB,uBAAuB;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,uBAAuB;IACvB,UAAU,EAAE,SAAS,OAAO,EAAE,CAAC;CAChC;AAED,MAAM,WAAW,uBAAuB;IACtC,kDAAkD;IAClD,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC;IACjB,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2CAA2C;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2CAA2C;IAC3C,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B;AAiDD;;;;;GAKG;AACH,wBAAsB,iBAAiB,CAAC,EAAE,SAAS,UAAU,EAC3D,IAAI,EAAE,qBAAqB,CAAC,EAAE,CAAC,GAC9B,OAAO,CAAC,uBAAuB,CAAC,CAyDlC"}

package/dist/proxy/handler.js

@@ -0,0 +1,102 @@
+/**
+ * @syncular/server - Proxy Query Handler
+ *
+ * Executes proxied queries with automatic oplog generation for mutations.
+ */
+import { sql } from 'kysely';
+import { appendReturning, detectMutation, hasReturningClause, hasReturningWildcard, } from './mutation-detector.js';
+import { createOplogEntries } from './oplog.js';
+/**
+ * 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 hasReturning = hasReturningClause(sqlQuery);
+    if (hasReturning && !hasReturningWildcard(sqlQuery)) {
+        throw new Error(`Proxy mutation on synced table "${mutation.tableName}" must use RETURNING * (or omit RETURNING)`);
+    }
+    const finalSql = hasReturning ? sqlQuery : appendReturning(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.js';
+// Mutation detection
+export { detectMutation } from './mutation-detector.js';
+// Oplog creation
+// Registry
+export { ProxyTableRegistry } from './registry.js';
+// 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,35 @@
+/**
+ * @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;
+/**
+ * Check if SQL has a wildcard RETURNING clause (RETURNING * or alias.*).
+ */
+export declare function hasReturningWildcard(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;AAyMD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CA2BnE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAGvD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAIzD;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAQnD"}

package/dist/proxy/mutation-detector.js

@@ -0,0 +1,246 @@
+/**
+ * @syncular/server - Mutation Detector
+ *
+ * Detects whether a SQL query is a mutation (INSERT/UPDATE/DELETE).
+ */
+function isWordStart(ch) {
+    return /[A-Za-z_]/.test(ch);
+}
+function isWordPart(ch) {
+    return /[A-Za-z0-9_$]/.test(ch);
+}
+function skipLeadingNoise(sql) {
+    let index = 0;
+    while (index < sql.length) {
+        while (index < sql.length && /[\s;]/.test(sql[index])) {
+            index += 1;
+        }
+        if (sql.startsWith('--', index)) {
+            index += 2;
+            while (index < sql.length && sql[index] !== '\n') {
+                index += 1;
+            }
+            continue;
+        }
+        if (sql.startsWith('/*', index)) {
+            const end = sql.indexOf('*/', index + 2);
+            if (end === -1)
+                return '';
+            index = end + 2;
+            continue;
+        }
+        break;
+    }
+    return sql.slice(index);
+}
+function extractMainStatement(sql) {
+    const normalized = skipLeadingNoise(sql);
+    if (!normalized.toLowerCase().startsWith('with')) {
+        return normalized;
+    }
+    const lower = normalized.toLowerCase();
+    const rootKeywords = new Set(['insert', 'update', 'delete', 'select']);
+    let index = 0;
+    let depth = 0;
+    let inSingleQuote = false;
+    let inDoubleQuote = false;
+    let inLineComment = false;
+    let inBlockComment = false;
+    while (index < normalized.length) {
+        const ch = normalized[index];
+        const next = normalized[index + 1];
+        if (inLineComment) {
+            if (ch === '\n')
+                inLineComment = false;
+            index += 1;
+            continue;
+        }
+        if (inBlockComment) {
+            if (ch === '*' && next === '/') {
+                inBlockComment = false;
+                index += 2;
+                continue;
+            }
+            index += 1;
+            continue;
+        }
+        if (inSingleQuote) {
+            if (ch === "'" && next === "'") {
+                index += 2;
+                continue;
+            }
+            if (ch === "'")
+                inSingleQuote = false;
+            index += 1;
+            continue;
+        }
+        if (inDoubleQuote) {
+            if (ch === '"' && next === '"') {
+                index += 2;
+                continue;
+            }
+            if (ch === '"')
+                inDoubleQuote = false;
+            index += 1;
+            continue;
+        }
+        if (ch === '-' && next === '-') {
+            inLineComment = true;
+            index += 2;
+            continue;
+        }
+        if (ch === '/' && next === '*') {
+            inBlockComment = true;
+            index += 2;
+            continue;
+        }
+        if (ch === "'") {
+            inSingleQuote = true;
+            index += 1;
+            continue;
+        }
+        if (ch === '"') {
+            inDoubleQuote = true;
+            index += 1;
+            continue;
+        }
+        if (ch === '(') {
+            depth += 1;
+            index += 1;
+            continue;
+        }
+        if (ch === ')') {
+            if (depth > 0)
+                depth -= 1;
+            index += 1;
+            continue;
+        }
+        if (depth === 0 && isWordStart(ch)) {
+            const tokenStart = index;
+            index += 1;
+            while (index < normalized.length && isWordPart(normalized[index])) {
+                index += 1;
+            }
+            const token = lower.slice(tokenStart, index);
+            if (token !== 'with' &&
+                token !== 'recursive' &&
+                rootKeywords.has(token)) {
+                return normalized.slice(tokenStart);
+            }
+            continue;
+        }
+        index += 1;
+    }
+    return normalized;
+}
+function parseIdentifier(input, startIndex) {
+    let index = startIndex;
+    while (index < input.length && /\s/.test(input[index])) {
+        index += 1;
+    }
+    if (index >= input.length)
+        return null;
+    if (input[index] === '"') {
+        index += 1;
+        let value = '';
+        while (index < input.length) {
+            const ch = input[index];
+            if (ch === '"' && input[index + 1] === '"') {
+                value += '"';
+                index += 2;
+                continue;
+            }
+            if (ch === '"') {
+                index += 1;
+                return { name: value, nextIndex: index };
+            }
+            value += ch;
+            index += 1;
+        }
+        return null;
+    }
+    if (!isWordStart(input[index]))
+        return null;
+    const first = index;
+    index += 1;
+    while (index < input.length && isWordPart(input[index])) {
+        index += 1;
+    }
+    return { name: input.slice(first, index), nextIndex: index };
+}
+function parseTargetTable(input) {
+    const first = parseIdentifier(input, 0);
+    if (!first)
+        return null;
+    let index = first.nextIndex;
+    while (index < input.length && /\s/.test(input[index])) {
+        index += 1;
+    }
+    if (input[index] !== '.') {
+        return first.name;
+    }
+    const second = parseIdentifier(input, index + 1);
+    if (!second)
+        return null;
+    return second.name;
+}
+/**
+ * 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 statement = extractMainStatement(sql).trimStart();
+    const lower = statement.toLowerCase();
+    if (lower.startsWith('insert')) {
+        const tableName = parseTargetTable(statement.replace(/^insert\s+into\s+/i, ''));
+        if (!tableName)
+            return null;
+        return { operation: 'upsert', tableName };
+    }
+    if (lower.startsWith('update')) {
+        const tableName = parseTargetTable(statement.replace(/^update\s+/i, ''));
+        if (!tableName)
+            return null;
+        return { operation: 'upsert', tableName };
+    }
+    if (lower.startsWith('delete')) {
+        const tableName = parseTargetTable(statement.replace(/^delete\s+from\s+/i, ''));
+        if (!tableName)
+            return null;
+        return { operation: 'delete', tableName };
+    }
+    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);
+}
+/**
+ * Check if SQL has a wildcard RETURNING clause (RETURNING * or alias.*).
+ */
+export function hasReturningWildcard(sql) {
+    const match = sql.match(/\bRETURNING\b([\s\S]*)$/i);
+    if (!match)
+        return false;
+    return /(^|,)\s*(?:[A-Za-z_][A-Za-z0-9_$]*\.)?\*/i.test(match[1]);
+}
+/**
+ * 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