@syncular/server 0.0.1-60

package/dist/helpers/emitted-change.d.ts

@@ -0,0 +1,56 @@
+/**
+ * @syncular/server - Emitted change builder
+ *
+ * Helper for creating emitted changes in server table handlers.
+ */
+import type { StoredScopes } from '@syncular/core';
+import type { EmittedChange } from '../shapes/types';
+export interface CreateEmittedChangeArgs {
+    /** Table name */
+    table: string;
+    /** Row primary key */
+    rowId: string;
+    /** Operation type */
+    op: 'upsert' | 'delete';
+    /** Row data (null for delete) */
+    row: unknown | null;
+    /** Row version (null if not versioned) */
+    version: number | null;
+    /**
+     * Scope values for this change (stored as JSONB).
+     * Example: { user_id: 'U1', project_id: 'P1' }
+     */
+    scopes: StoredScopes;
+}
+/**
+ * Create an emitted change for broadcasting to subscribed clients.
+ *
+ * @example
+ * ```typescript
+ * const handler: ServerTableHandler = {
+ *   table: 'tasks',
+ *   async applyOperation(ctx, op, opIndex) {
+ *     // ... apply the operation ...
+ *
+ *     const newVersion = await getTaskVersion(ctx.db, op.row_id);
+ *     const updatedRow = await getTask(ctx.db, op.row_id);
+ *
+ *     return {
+ *       result: { opIndex, status: 'applied', newVersion },
+ *       emittedChanges: [
+ *         createEmittedChange({
+ *           table: 'tasks',
+ *           rowId: op.row_id,
+ *           op: 'upsert',
+ *           row: updatedRow,
+ *           version: newVersion,
+ *           scopes: { user_id: updatedRow.user_id },
+ *         }),
+ *       ],
+ *     };
+ *   },
+ * };
+ * ```
+ */
+export declare function createEmittedChange(args: CreateEmittedChangeArgs): EmittedChange;
+//# sourceMappingURL=emitted-change.d.ts.map

package/dist/helpers/emitted-change.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emitted-change.d.ts","sourceRoot":"","sources":["../../src/helpers/emitted-change.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD,MAAM,WAAW,uBAAuB;IACtC,iBAAiB;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,sBAAsB;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,qBAAqB;IACrB,EAAE,EAAE,QAAQ,GAAG,QAAQ,CAAC;IACxB,iCAAiC;IACjC,GAAG,EAAE,OAAO,GAAG,IAAI,CAAC;IACpB,0CAA0C;IAC1C,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB;;;OAGG;IACH,MAAM,EAAE,YAAY,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,uBAAuB,GAC5B,aAAa,CASf"}

package/dist/helpers/emitted-change.js

@@ -0,0 +1,46 @@
+/**
+ * @syncular/server - Emitted change builder
+ *
+ * Helper for creating emitted changes in server table handlers.
+ */
+/**
+ * Create an emitted change for broadcasting to subscribed clients.
+ *
+ * @example
+ * ```typescript
+ * const handler: ServerTableHandler = {
+ *   table: 'tasks',
+ *   async applyOperation(ctx, op, opIndex) {
+ *     // ... apply the operation ...
+ *
+ *     const newVersion = await getTaskVersion(ctx.db, op.row_id);
+ *     const updatedRow = await getTask(ctx.db, op.row_id);
+ *
+ *     return {
+ *       result: { opIndex, status: 'applied', newVersion },
+ *       emittedChanges: [
+ *         createEmittedChange({
+ *           table: 'tasks',
+ *           rowId: op.row_id,
+ *           op: 'upsert',
+ *           row: updatedRow,
+ *           version: newVersion,
+ *           scopes: { user_id: updatedRow.user_id },
+ *         }),
+ *       ],
+ *     };
+ *   },
+ * };
+ * ```
+ */
+export function createEmittedChange(args) {
+    return {
+        table: args.table,
+        row_id: args.rowId,
+        op: args.op,
+        row_json: args.op === 'delete' ? null : args.row,
+        row_version: args.version,
+        scopes: args.scopes,
+    };
+}
+//# sourceMappingURL=emitted-change.js.map

package/dist/helpers/emitted-change.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emitted-change.js","sourceRoot":"","sources":["../../src/helpers/emitted-change.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAuBH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,UAAU,mBAAmB,CACjC,IAA6B,EACd;IACf,OAAO;QACL,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,MAAM,EAAE,IAAI,CAAC,KAAK;QAClB,EAAE,EAAE,IAAI,CAAC,EAAE;QACX,QAAQ,EAAE,IAAI,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG;QAChD,WAAW,EAAE,IAAI,CAAC,OAAO;QACzB,MAAM,EAAE,IAAI,CAAC,MAAM;KACpB,CAAC;AAAA,CACH"}

package/dist/helpers/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @syncular/server - Helper utilities
+ *
+ * Convenience helpers for implementing server table handlers.
+ */
+export * from './conflict';
+export * from './emitted-change';
+export * from './paginate';
+export * from './scope-strings';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/helpers/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC"}

package/dist/helpers/index.js

@@ -0,0 +1,10 @@
+/**
+ * @syncular/server - Helper utilities
+ *
+ * Convenience helpers for implementing server table handlers.
+ */
+export * from './conflict';
+export * from './emitted-change';
+export * from './paginate';
+export * from './scope-strings';
+//# sourceMappingURL=index.js.map

package/dist/helpers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/helpers/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC"}

package/dist/helpers/paginate.d.ts

@@ -0,0 +1,49 @@
+/**
+ * @syncular/server - Pagination helper
+ *
+ * Simplifies cursor-based pagination for snapshot queries.
+ */
+import type { SelectQueryBuilder } from 'kysely';
+export interface PaginateOptions {
+    /** Cursor value to start from (null for first page) */
+    cursor: string | null;
+    /** Number of rows per page */
+    limit: number;
+    /** Column to use for cursor-based pagination (default: 'id') */
+    cursorColumn?: string;
+}
+export interface PaginateResult<T> {
+    /** Rows for this page */
+    rows: T[];
+    /** Cursor for next page (null if no more pages) */
+    nextCursor: string | null;
+}
+/**
+ * Apply cursor-based pagination to a Kysely query.
+ *
+ * This helper simplifies implementing snapshot pagination by:
+ * - Applying cursor filter if provided
+ * - Ordering by the cursor column
+ * - Fetching limit + 1 to determine if there's a next page
+ * - Computing the next cursor
+ *
+ * @example
+ * ```typescript
+ * const handler: ServerTableHandler = {
+ *   table: 'tasks',
+ *   async snapshot(ctx) {
+ *     const query = ctx.db
+ *       .selectFrom('tasks')
+ *       .selectAll()
+ *       .where('user_id', '=', ctx.actorId);
+ *
+ *     return paginate(query, {
+ *       cursor: ctx.cursor,
+ *       limit: ctx.limit,
+ *     });
+ *   },
+ * };
+ * ```
+ */
+export declare function paginate<T>(query: SelectQueryBuilder<any, any, T>, options: PaginateOptions): Promise<PaginateResult<T>>;
+//# sourceMappingURL=paginate.d.ts.map

package/dist/helpers/paginate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paginate.d.ts","sourceRoot":"","sources":["../../src/helpers/paginate.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,QAAQ,CAAC;AAEjD,MAAM,WAAW,eAAe;IAC9B,uDAAuD;IACvD,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,8BAA8B;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,gEAAgE;IAChE,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,cAAc,CAAC,CAAC;IAC/B,yBAAyB;IACzB,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,mDAAmD;IACnD,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAsB,QAAQ,CAAC,CAAC,EAC9B,KAAK,EAAE,kBAAkB,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,EACtC,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CA2B5B"}

package/dist/helpers/paginate.js

@@ -0,0 +1,54 @@
+/**
+ * @syncular/server - Pagination helper
+ *
+ * Simplifies cursor-based pagination for snapshot queries.
+ */
+/**
+ * Apply cursor-based pagination to a Kysely query.
+ *
+ * This helper simplifies implementing snapshot pagination by:
+ * - Applying cursor filter if provided
+ * - Ordering by the cursor column
+ * - Fetching limit + 1 to determine if there's a next page
+ * - Computing the next cursor
+ *
+ * @example
+ * ```typescript
+ * const handler: ServerTableHandler = {
+ *   table: 'tasks',
+ *   async snapshot(ctx) {
+ *     const query = ctx.db
+ *       .selectFrom('tasks')
+ *       .selectAll()
+ *       .where('user_id', '=', ctx.actorId);
+ *
+ *     return paginate(query, {
+ *       cursor: ctx.cursor,
+ *       limit: ctx.limit,
+ *     });
+ *   },
+ * };
+ * ```
+ */
+export async function paginate(query, options) {
+    const { cursor, limit, cursorColumn = 'id' } = options;
+    // Apply cursor filter if resuming from a previous page
+    let q = query;
+    if (cursor) {
+        q = q.where(cursorColumn, '>', cursor);
+    }
+    // Order by cursor column and fetch limit + 1 to check for more pages
+    const rows = await q
+        .orderBy(cursorColumn, 'asc')
+        .limit(limit + 1)
+        .execute();
+    // Determine if there are more pages
+    const hasMore = rows.length > limit;
+    const pageRows = hasMore ? rows.slice(0, limit) : rows;
+    // Compute next cursor from last row
+    const nextCursor = hasMore
+        ? (pageRows[pageRows.length - 1]?.[cursorColumn] ?? null)
+        : null;
+    return { rows: pageRows, nextCursor };
+}
+//# sourceMappingURL=paginate.js.map

package/dist/helpers/paginate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paginate.js","sourceRoot":"","sources":["../../src/helpers/paginate.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAoBH;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,KAAsC,EACtC,OAAwB,EACI;IAC5B,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC;IAEvD,uDAAuD;IACvD,IAAI,CAAC,GAAG,KAAK,CAAC;IACd,IAAI,MAAM,EAAE,CAAC;QACX,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,YAAY,EAAE,GAAG,EAAE,MAAM,CAAa,CAAC;IACrD,CAAC;IAED,qEAAqE;IACrE,MAAM,IAAI,GAAG,MAAM,CAAC;SACjB,OAAO,CAAC,YAAY,EAAE,KAAK,CAAC;SAC5B,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC;SAChB,OAAO,EAAE,CAAC;IAEb,oCAAoC;IACpC,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;IACpC,MAAM,QAAQ,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAEvD,oCAAoC;IACpC,MAAM,UAAU,GAAG,OAAO;QACxB,CAAC,CAAC,CAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAA6B,EAAE,CAC5D,YAAY,CACF,IAAI,IAAI,CAAC;QACvB,CAAC,CAAC,IAAI,CAAC;IAET,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC;AAAA,CACvC"}

package/dist/helpers/scope-strings.d.ts

@@ -0,0 +1,74 @@
+/**
+ * @syncular/server - Scope string utilities
+ *
+ * Helpers for creating and parsing scope strings.
+ * Scope strings identify partitions of data for sync subscriptions.
+ */
+/**
+ * Result from parsing a scope key
+ */
+interface ParsedScopeKey {
+    /** The prefix (first segment) */
+    prefix: string;
+    /** The remaining values (segments after prefix) */
+    values: string[];
+}
+/**
+ * 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 declare function createScopeKey(prefix: string, ...values: string[]): string;
+/**
+ * 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 declare function parseScopeKey(key: string, expectedPrefix?: string): ParsedScopeKey | null;
+/**
+ * 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 declare function getScopeKeyValue(key: string, valueIndex: number): string | null;
+export type { ParsedScopeKey };
+//# sourceMappingURL=scope-strings.d.ts.map

package/dist/helpers/scope-strings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope-strings.d.ts","sourceRoot":"","sources":["../../src/helpers/scope-strings.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,UAAU,cAAc;IACtB,iCAAiC;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,mDAAmD;IACnD,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAE1E;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,aAAa,CAC3B,GAAG,EAAE,MAAM,EACX,cAAc,CAAC,EAAE,MAAM,GACtB,cAAc,GAAG,IAAI,CAWvB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,MAAM,GACjB,MAAM,GAAG,IAAI,CAIf;AAED,YAAY,EAAE,cAAc,EAAE,CAAC"}

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';
+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 * from './stats';
+export * from './subscriptions';
+//# 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;AAO5C,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,CAmDlC"}