@syncular/server 0.1.2 → 0.2.0

package/dist/handlers/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/handlers/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,SAAS,CAAC"}

package/dist/handlers/types.d.ts

@@ -1,295 +0,0 @@
-import type { BinarySnapshotColumn, BinarySnapshotRowsEncoder, ScopePattern, ScopeValues, ScopeValuesForKeys, StoredScopes, SyncAuthLeaseProvenance, SyncChange, SyncOp, SyncOperation, SyncOperationResult } from '@syncular/core';
-import type { ZodSchema, z } from 'zod';
-import type { DbExecutor } from '../dialect/types';
-import type { SyncCoreDb } from '../schema';
-export interface SyncServerAuth {
-    actorId: string;
-    partitionId?: string;
-}
-/**
- * Emitted change to be stored in the oplog.
- * Uses JSONB scopes instead of scope_keys array.
- */
-export interface EmittedChange {
-    /** Table name */
-    table: string;
-    /** Row primary key */
-    row_id: string;
-    /** Operation type */
-    op: SyncOp;
-    /** Row data as JSON (null for deletes) */
-    row_json: unknown | null;
-    /** Row version for optimistic concurrency */
-    row_version: number | null;
-    /**
-     * Scope values for this change (stored as JSONB).
-     * Example: { user_id: 'U1', project_id: 'P1' }
-     */
-    scopes: StoredScopes;
-}
-export interface ApplyOperationResult {
-    result: SyncOperationResult;
-    emittedChanges: EmittedChange[];
-}
-export interface BatchApplyOperationInput {
-    op: SyncOperation;
-    opIndex: number;
-}
-/**
- * Context for server operations.
- */
-export interface ServerContext<DB extends SyncCoreDb = SyncCoreDb, Auth extends SyncServerAuth = SyncServerAuth> {
-    /** Database connection (transaction in applyOperation) */
-    db: DbExecutor<DB>;
-    /** Actor ID (user ID from auth) */
-    actorId: string;
-    /** Full auth payload returned by authenticate */
-    auth: Auth;
-}
-/**
- * Context passed to snapshot method.
- */
-export interface ServerSnapshotContext<DB extends SyncCoreDb = SyncCoreDb, ScopeKeys extends string = string, Auth extends SyncServerAuth = SyncServerAuth> extends ServerContext<DB, Auth> {
-    /** Database executor for the snapshot */
-    db: DbExecutor<DB>;
-    /** Effective scope values for this subscription */
-    scopeValues: ScopeValuesForKeys<ScopeKeys>;
-    /** Pagination cursor (row_id for keyset pagination) */
-    cursor: string | null;
-    /** Max rows to return */
-    limit: number;
-    /**
-     * Client schema version targeted by this snapshot.
-     * Use this to emit the correct generated client row shape for older clients.
-     */
-    schemaVersion: number;
-}
-/**
- * Context passed to applyOperation method.
- */
-export interface ServerApplyOperationContext<DB extends SyncCoreDb = SyncCoreDb, Auth extends SyncServerAuth = SyncServerAuth> extends ServerContext<DB, Auth> {
-    /** Database executor for the operation */
-    trx: DbExecutor<DB>;
-    /** Client/device identifier */
-    clientId: string;
-    /** Unique commit identifier */
-    commitId: string;
-    /**
-     * Client's schema version when the commit was created.
-     * Use this to transform payloads from older client versions.
-     */
-    schemaVersion: number;
-    /**
-     * Auth lease provenance captured when the client queued the commit.
-     * This is audit/replay context only; handlers must still use current auth.
-     */
-    authLease?: SyncAuthLeaseProvenance;
-}
-/**
- * Server-side scope configuration for advanced use cases.
- * Use this when you need custom extraction, access control, or filtering.
- *
- * For simple cases, use the simplified scope array format:
- * `scopes: ['user:{user_id}']`
- */
-interface ServerScopeConfig {
-    /**
-     * Column name containing the scope value.
-     * For simple patterns like 'user:{user_id}' → column: 'user_id'
-     */
-    column?: string;
-    /**
-     * Custom extractor for complex patterns.
-     * Example: extract year/month from a date column
-     */
-    extract?: (row: Record<string, unknown>) => Record<string, string>;
-    /**
-     * Optional access control per scope pattern.
-     * Return true if the actor can access this scope value.
-     */
-    access?: (ctx: ServerContext, vars: Record<string, string>) => Promise<boolean>;
-    /**
-     * Optional filter builder for wildcard subscriptions.
-     * Called when the subscription uses wildcards for this pattern.
-     */
-    toFilter?: (vars: Record<string, string | undefined>, query: unknown) => unknown;
-}
-/**
- * Server handler options - configuration for a table's sync behavior.
- */
-export interface ServerHandlerOptions<DB extends SyncCoreDb = SyncCoreDb, Auth extends SyncServerAuth = SyncServerAuth, Scopes extends Record<ScopePattern, Record<string, string>> = Record<ScopePattern, Record<string, string>>, TableName extends string = string, Params extends ZodSchema = ZodSchema> {
-    /**
-     * Scope patterns this handler uses.
-     * Array of pattern keys from SharedScopes.
-     */
-    scopes: (keyof Scopes)[];
-    /**
-     * Scope definitions - how each pattern maps to row data.
-     * Defaults to using column name = variable name.
-     */
-    scopeDefinitions?: Partial<Record<keyof Scopes, ServerScopeConfig>>;
-    /**
-     * Resolve allowed scope values for the current actor.
-     * Called once per request to determine what the actor can access.
-     *
-     * Returns scope values the actor is allowed to access.
-     * The server will intersect requested scopes with these.
-     *
-     * @example
-     * resolveScopes: async (ctx) => ({
-     *   user_id: [ctx.user.id],
-     *   project_id: ctx.user.projectIds,
-     * })
-     */
-    resolveScopes: (ctx: ServerContext<DB, Auth>) => Promise<ScopeValues>;
-    /**
-     * Optional Zod schema for subscription parameters.
-     */
-    params?: Params;
-    /**
-     * Primary key column (default: 'id')
-     */
-    primaryKey?: string;
-    /**
-     * Version column for optimistic concurrency (default: 'server_version')
-     */
-    versionColumn?: string;
-    /**
-     * Tables that must be bootstrapped before this one.
-     */
-    dependsOn?: string[];
-    /**
-     * TTL for cached snapshot chunks (ms). Default: 24 hours.
-     */
-    snapshotChunkTtlMs?: number;
-    /**
-     * Stable binary snapshot column metadata. Generators should provide this for
-     * Rust/native clients so the server does not need to infer column order and
-     * value types from every snapshot chunk at runtime.
-     */
-    snapshotBinaryColumns?: readonly BinarySnapshotColumn[];
-    /**
-     * Version-aware binary snapshot column metadata. Returning null intentionally
-     * disables fallback to current metadata.
-     */
-    snapshotBinaryColumnsForVersion?: (schemaVersion: number) => readonly BinarySnapshotColumn[] | null | undefined;
-    /**
-     * Optional generated binary snapshot encoder. When present, binary bootstrap
-     * chunks use this instead of the generic object-row encoder.
-     */
-    snapshotBinaryEncoder?: BinarySnapshotRowsEncoder;
-    /**
-     * Version-aware generated binary snapshot encoder. Returning null
-     * intentionally disables fallback to the current encoder.
-     */
-    snapshotBinaryEncoderForVersion?: (schemaVersion: number) => BinarySnapshotRowsEncoder | null | undefined;
-    /**
-     * Transform client payload → server row on writes.
-     */
-    transformInbound?: (payload: Record<string, unknown>, ctx: ServerApplyOperationContext<DB, Auth>) => Partial<DB[TableName & keyof DB]>;
-    /**
-     * Transform server row → client payload on reads.
-     */
-    transformOutbound?: (row: DB[TableName & keyof DB]) => Record<string, unknown>;
-    /**
-     * Custom snapshot implementation.
-     * Default uses keyset pagination ordered by primary key.
-     */
-    snapshot?: (ctx: ServerSnapshotContext<DB, string, Auth>, params: Params extends ZodSchema ? z.infer<Params> : undefined) => Promise<{
-        rows: unknown[];
-        nextCursor: string | null;
-    }>;
-    /**
-     * Custom apply operation implementation.
-     */
-    applyOperation?: (ctx: ServerApplyOperationContext<DB, Auth>, op: SyncOperation, opIndex: number) => Promise<ApplyOperationResult>;
-}
-/**
- * Server-side table handler for snapshots and mutations.
- * This is the internal handler interface used by the sync engine.
- */
-export interface ServerTableHandler<DB extends SyncCoreDb = SyncCoreDb, Auth extends SyncServerAuth = SyncServerAuth> {
-    /** Table name */
-    table: string;
-    /** Primary key column for row ids and artifact/import metadata. */
-    primaryKeyColumn?: string;
-    /** Scope patterns used by this handler */
-    scopePatterns: ScopePattern[];
-    /**
-     * Tables that must be bootstrapped before this one.
-     */
-    dependsOn?: string[];
-    /**
-     * TTL for cached snapshot chunks (ms).
-     */
-    snapshotChunkTtlMs?: number;
-    /**
-     * Stable binary snapshot column metadata used by binary bootstrap chunks.
-     */
-    snapshotBinaryColumns?: readonly BinarySnapshotColumn[];
-    /**
-     * Version-aware binary snapshot column metadata. Generated handlers should
-     * use this when old client schema versions can have different row shapes.
-     * Returning null intentionally disables fallback to current metadata.
-     */
-    snapshotBinaryColumnsForVersion?: (schemaVersion: number) => readonly BinarySnapshotColumn[] | null | undefined;
-    /**
-     * Optional generated binary snapshot encoder used by binary bootstrap chunks.
-     */
-    snapshotBinaryEncoder?: BinarySnapshotRowsEncoder;
-    /**
-     * Version-aware binary snapshot encoder. Returning null intentionally
-     * disables fallback to the current generated encoder.
-     */
-    snapshotBinaryEncoderForVersion?: (schemaVersion: number) => BinarySnapshotRowsEncoder | null | undefined;
-    /**
-     * Project a persisted incremental change row to the requested client schema
-     * before pull plugins, wire integrity, and response encoding run.
-     *
-     * Generated divergent-schema handlers use this to keep the commit log in the
-     * current client row shape while serving older clients their targeted row
-     * shape.
-     */
-    projectChangeForVersion?: (change: SyncChange, schemaVersion: number) => SyncChange;
-    /**
-     * Hint for push engine savepoint optimization on single-op commits.
-     *
-     * When true, the handler guarantees that a rejected single operation
-     * does not leave durable writes behind before returning the rejection.
-     * This allows pushCommit() to skip SAVEPOINT overhead for single-op
-     * commits on savepoint-capable dialects.
-     *
-     * Omit or set false for custom handlers unless this guarantee holds.
-     */
-    canRejectSingleOperationWithoutSavepoint?: boolean;
-    /**
-     * Resolve allowed scope values for the current actor.
-     */
-    resolveScopes: (ctx: ServerContext<DB, Auth>) => Promise<ScopeValues>;
-    /**
-     * Extract stored scopes from a row.
-     */
-    extractScopes: (row: Record<string, unknown>) => StoredScopes;
-    /**
-     * Build a bootstrap snapshot page.
-     */
-    snapshot(ctx: ServerSnapshotContext<DB, string, Auth>, params: Record<string, unknown> | undefined): Promise<{
-        rows: unknown[];
-        nextCursor: string | null;
-    }>;
-    /**
-     * Apply a single operation.
-     */
-    applyOperation(ctx: ServerApplyOperationContext<DB, Auth>, op: SyncOperation, opIndex: number): Promise<ApplyOperationResult>;
-    /**
-     * Apply multiple operations in order.
-     *
-     * Implementations may internally batch writes but must preserve the same
-     * observable semantics as sequential applyOperation calls:
-     * - results are returned in operation order
-     * - processing stops at the first non-applied result
-     */
-    applyOperationBatch?(ctx: ServerApplyOperationContext<DB, Auth>, operations: BatchApplyOperationInput[]): Promise<ApplyOperationResult[]>;
-}
-export {};
-//# sourceMappingURL=types.d.ts.map

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

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

package/dist/handlers/types.js

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=types.js.map

package/dist/handlers/types.js.map

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

package/dist/helpers/conflict.d.ts

@@ -1,52 +0,0 @@
-/**
- * @syncular/server - Conflict result builder
- *
- * Helper for building conflict results in server table handlers.
- */
-import type { ApplyOperationResult } from '../handlers/types';
-export interface BuildConflictResultArgs {
-    /** Index of the operation in the batch */
-    opIndex: number;
-    /** Current server row data */
-    serverRow: unknown;
-    /** Current server version */
-    serverVersion: number;
-    /** Client's base version (what they thought they were updating) */
-    baseVersion: number | null;
-}
-/**
- * Build a conflict result for applyOperation.
- *
- * Use this when the client's base version doesn't match the server's current version,
- * indicating a concurrent modification conflict.
- *
- * @example
- * ```typescript
- * const handler: ServerTableHandler = {
- *   table: 'tasks',
- *   async applyOperation(ctx, op, opIndex) {
- *     const existing = await ctx.db
- *       .selectFrom('tasks')
- *       .selectAll()
- *       .where('id', '=', op.row_id)
- *       .executeTakeFirst();
- *
- *     // Check for version conflict
- *     if (existing && op.base_version !== null && existing.version !== op.base_version) {
- *       return {
- *         result: buildConflictResult({
- *           opIndex,
- *           serverRow: existing,
- *           serverVersion: existing.version,
- *           baseVersion: op.base_version,
- *         }),
- *       };
- *     }
- *
- *     // ... apply the operation
- *   },
- * };
- * ```
- */
-export declare function buildConflictResult(args: BuildConflictResultArgs): ApplyOperationResult['result'];
-//# sourceMappingURL=conflict.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"conflict.d.ts","sourceRoot":"","sources":["../../src/helpers/conflict.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAE9D,MAAM,WAAW,uBAAuB;IACtC,0CAA0C;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,8BAA8B;IAC9B,SAAS,EAAE,OAAO,CAAC;IACnB,6BAA6B;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,mEAAmE;IACnE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,uBAAuB,GAC5B,oBAAoB,CAAC,QAAQ,CAAC,CAQhC"}

package/dist/helpers/conflict.js

@@ -1,49 +0,0 @@
-/**
- * @syncular/server - Conflict result builder
- *
- * Helper for building conflict results in server table handlers.
- */
-/**
- * Build a conflict result for applyOperation.
- *
- * Use this when the client's base version doesn't match the server's current version,
- * indicating a concurrent modification conflict.
- *
- * @example
- * ```typescript
- * const handler: ServerTableHandler = {
- *   table: 'tasks',
- *   async applyOperation(ctx, op, opIndex) {
- *     const existing = await ctx.db
- *       .selectFrom('tasks')
- *       .selectAll()
- *       .where('id', '=', op.row_id)
- *       .executeTakeFirst();
- *
- *     // Check for version conflict
- *     if (existing && op.base_version !== null && existing.version !== op.base_version) {
- *       return {
- *         result: buildConflictResult({
- *           opIndex,
- *           serverRow: existing,
- *           serverVersion: existing.version,
- *           baseVersion: op.base_version,
- *         }),
- *       };
- *     }
- *
- *     // ... apply the operation
- *   },
- * };
- * ```
- */
-export function buildConflictResult(args) {
-    return {
-        opIndex: args.opIndex,
-        status: 'conflict',
-        message: `Version conflict: server=${args.serverVersion}, base=${args.baseVersion}`,
-        server_version: args.serverVersion,
-        server_row: args.serverRow,
-    };
-}
-//# sourceMappingURL=conflict.js.map

package/dist/helpers/conflict.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"conflict.js","sourceRoot":"","sources":["../../src/helpers/conflict.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAeH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,MAAM,UAAU,mBAAmB,CACjC,IAA6B;IAE7B,OAAO;QACL,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,MAAM,EAAE,UAAU;QAClB,OAAO,EAAE,4BAA4B,IAAI,CAAC,aAAa,UAAU,IAAI,CAAC,WAAW,EAAE;QACnF,cAAc,EAAE,IAAI,CAAC,aAAa;QAClC,UAAU,EAAE,IAAI,CAAC,SAAS;KAC3B,CAAC;AACJ,CAAC"}

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

@@ -1,56 +0,0 @@
-/**
- * @syncular/server - Emitted change builder
- *
- * Helper for creating emitted changes in server table handlers.
- */
-import type { StoredScopes } from '@syncular/core';
-import type { EmittedChange } from '../handlers/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

@@ -1 +0,0 @@
-{"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,mBAAmB,CAAC;AAEvD,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

@@ -1,46 +0,0 @@
-/**
- * @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

@@ -1 +0,0 @@
-{"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;IAE7B,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;AACJ,CAAC"}

package/dist/helpers/index.d.ts

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

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

@@ -1 +0,0 @@
-{"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,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC"}

package/dist/helpers/index.js

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

package/dist/helpers/index.js.map

@@ -1 +0,0 @@
-{"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,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC"}

package/dist/helpers/paginate.d.ts

@@ -1,49 +0,0 @@
-/**
- * @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

@@ -1 +0,0 @@
-{"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"}