@syncular/server-hono 0.0.4-25 → 0.0.6-100

package/dist/console/types.d.ts

@@ -0,0 +1,175 @@
+import type { ServerSyncDialect, ServerTableHandler, SqlFamily, SyncCoreDb, SyncServerAuth } from '@syncular/server';
+import type { Context } from 'hono';
+import type { UpgradeWebSocket } from 'hono/ws';
+import type { Kysely } from 'kysely';
+import type { WebSocketConnectionManager } from '../ws';
+import type { LiveEvent } from './schemas';
+export interface ConsoleAuthResult {
+    /** Identifier for the console user (for audit logging). */
+    consoleUserId?: string;
+}
+/**
+ * Listener for console live events (SSE streaming).
+ */
+export type ConsoleEventListener = (event: LiveEvent) => void;
+/**
+ * Console event emitter for broadcasting live events.
+ */
+export interface ConsoleEventEmitter {
+    /** Add a listener for live events */
+    addListener(listener: ConsoleEventListener): void;
+    /** Remove a listener */
+    removeListener(listener: ConsoleEventListener): void;
+    /** Emit an event to all listeners */
+    emit(event: LiveEvent): void;
+    /**
+     * Replay recent events, optionally constrained by timestamp, partition, and max count.
+     */
+    replay(options?: {
+        since?: string;
+        limit?: number;
+        partitionId?: string;
+    }): LiveEvent[];
+}
+export interface ConsoleMetricsOptions {
+    /**
+     * Metrics query strategy for timeseries/latency endpoints.
+     * - raw: in-memory processing from raw event rows
+     * - aggregated: DB-level aggregation where supported (raw fallback for unsupported paths)
+     * - auto: use raw for small windows, aggregated for larger windows
+     */
+    aggregationMode?: 'auto' | 'raw' | 'aggregated';
+    /** Max events for using raw mode when aggregationMode is 'auto'. */
+    rawFallbackMaxEvents?: number;
+}
+export interface ConsoleMaintenanceOptions {
+    /**
+     * Minimum interval between automatic event-prune runs.
+     * Set to 0 to disable automatic pruning.
+     * Default: 5 minutes.
+     */
+    autoPruneIntervalMs?: number;
+    /**
+     * Max age for request events before pruning.
+     * Set to 0 to disable age-based pruning.
+     * Default: 7 days.
+     */
+    requestEventsMaxAgeMs?: number;
+    /**
+     * Max number of request events to retain.
+     * Set to 0 to disable count-based pruning.
+     * Default: 10000.
+     */
+    requestEventsMaxRows?: number;
+    /**
+     * Max age for operation audit events before pruning.
+     * Set to 0 to disable age-based pruning.
+     * Default: 30 days.
+     */
+    operationEventsMaxAgeMs?: number;
+    /**
+     * Max number of operation audit events to retain.
+     * Set to 0 to disable count-based pruning.
+     * Default: 5000.
+     */
+    operationEventsMaxRows?: number;
+}
+export interface ConsoleBlobObject {
+    key: string;
+    size: number;
+    uploaded: Date;
+    httpMetadata?: {
+        contentType?: string;
+    };
+}
+export interface ConsoleBlobGetResult {
+    body: ReadableStream;
+    size: number;
+    httpMetadata?: {
+        contentType?: string;
+    };
+}
+export interface ConsoleBlobHeadResult {
+    size: number;
+    httpMetadata?: {
+        contentType?: string;
+    };
+}
+export interface ConsoleBlobBucket {
+    list(options: {
+        prefix?: string;
+        cursor?: string;
+        limit?: number;
+    }): Promise<{
+        objects: ConsoleBlobObject[];
+        truncated: boolean;
+        cursor?: string;
+    }>;
+    get(key: string): Promise<ConsoleBlobGetResult | null>;
+    delete(key: string | string[]): Promise<void>;
+    head(key: string): Promise<ConsoleBlobHeadResult | null>;
+}
+export interface ConsoleSharedOptions {
+    /**
+     * CORS origins to allow. Defaults to ['http://localhost:5173', 'https://console.sync.dev'].
+     * Set to '*' to allow all origins (not recommended for production).
+     */
+    corsOrigins?: string[] | '*';
+    metrics?: ConsoleMetricsOptions;
+    maintenance?: ConsoleMaintenanceOptions;
+    blobBucket?: ConsoleBlobBucket;
+}
+export interface CreateConsoleRoutesOptions<DB extends SyncCoreDb = SyncCoreDb, Auth extends SyncServerAuth = SyncServerAuth, F extends SqlFamily = SqlFamily> extends ConsoleSharedOptions {
+    db: Kysely<DB>;
+    dialect: ServerSyncDialect<F>;
+    handlers: ServerTableHandler<DB, Auth>[];
+    /**
+     * Authentication function for console requests.
+     * Return null to reject the request.
+     */
+    authenticate: (c: Context) => Promise<ConsoleAuthResult | null>;
+    /**
+     * Compaction options (required for /compact endpoint).
+     */
+    compact?: {
+        fullHistoryHours?: number;
+    };
+    /**
+     * Pruning options.
+     */
+    prune?: {
+        activeWindowMs?: number;
+        fallbackMaxAgeMs?: number;
+        keepNewestCommits?: number;
+    };
+    /**
+     * Event emitter for live console events.
+     * If provided along with websocket config, enables the /events/live WebSocket endpoint.
+     */
+    eventEmitter?: ConsoleEventEmitter;
+    /**
+     * Shared sync WebSocket connection manager.
+     * When provided, `/clients` includes realtime connection state per client.
+     */
+    wsConnectionManager?: WebSocketConnectionManager;
+    /**
+     * WebSocket configuration for live events streaming.
+     */
+    websocket?: {
+        enabled?: boolean;
+        /**
+         * Runtime-provided WebSocket upgrader (e.g. from `hono/bun`'s `createBunWebSocket()`).
+         */
+        upgradeWebSocket?: UpgradeWebSocket;
+        /**
+         * Heartbeat interval in milliseconds. Default: 30000
+         */
+        heartbeatIntervalMs?: number;
+    };
+    /**
+     * Optional console schema readiness promise.
+     * When provided, routes wait for this promise before querying console tables.
+     */
+    consoleSchemaReady?: Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/console/types.js

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

package/dist/console/types.js.map

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

package/dist/console/ui.d.ts

@@ -0,0 +1,38 @@
+import { type ConsoleUiPrefill } from '@syncular/console/server';
+import type { Context, Hono } from 'hono';
+type MaybePromise<T> = T | Promise<T>;
+export interface MountConsoleUiOptions {
+    /**
+     * Browser mount path for the console UI. Defaults to `/console`.
+     */
+    mountPath?: string;
+    /**
+     * API base path used to prefill the console server URL.
+     * Defaults to `/api`.
+     */
+    apiBasePath?: string;
+    /**
+     * Resolve prefill values per request.
+     * Return `null`/`undefined` to keep defaults.
+     */
+    resolvePrefill?: (c: Context) => MaybePromise<ConsoleUiPrefill | null | undefined>;
+    /**
+     * Convenience callback for prefilled token.
+     */
+    resolveToken?: (c: Context) => MaybePromise<string | undefined>;
+    /**
+     * Override distributable directory.
+     */
+    staticDir?: string;
+    /**
+     * Cache-Control header for index responses.
+     */
+    indexCacheControl?: string;
+    /**
+     * Cache-Control header for static asset responses.
+     */
+    assetCacheControl?: string;
+}
+export declare function mountConsoleUi(app: Hono, options?: MountConsoleUiOptions): void;
+export {};
+//# sourceMappingURL=ui.d.ts.map

package/dist/console/ui.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui.d.ts","sourceRoot":"","sources":["../../src/console/ui.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,gBAAgB,EAItB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAE1C,KAAK,YAAY,CAAC,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;AAEtC,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,cAAc,CAAC,EAAE,CACf,CAAC,EAAE,OAAO,KACP,YAAY,CAAC,gBAAgB,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;IACvD;;OAEG;IACH,YAAY,CAAC,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,YAAY,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAChE;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;OAEG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAeD,wBAAgB,cAAc,CAC5B,GAAG,EAAE,IAAI,EACT,OAAO,GAAE,qBAA0B,GAClC,IAAI,CAqCN"}

package/dist/console/ui.js

@@ -0,0 +1,43 @@
+import { createConsoleStaticResponder, } from '@syncular/console/server';
+function normalizePath(pathname, fallback) {
+    const value = pathname?.trim() ?? '';
+    if (!value)
+        return fallback;
+    if (value === '/')
+        return '/';
+    const withLeadingSlash = value.startsWith('/') ? value : `/${value}`;
+    return withLeadingSlash.replace(/\/+$/g, '') || '/';
+}
+export function mountConsoleUi(app, options = {}) {
+    const mountPath = normalizePath(options.mountPath, '/console');
+    const apiBasePath = normalizePath(options.apiBasePath, '/api');
+    const staticResponderConfig = {
+        mountPath,
+        staticDir: options.staticDir,
+        indexCacheControl: options.indexCacheControl,
+        assetCacheControl: options.assetCacheControl,
+    };
+    const serveConsoleStatic = createConsoleStaticResponder(staticResponderConfig);
+    const handler = async (c) => {
+        const prefillFromResolver = await options.resolvePrefill?.(c);
+        const token = await options.resolveToken?.(c);
+        const origin = new URL(c.req.url).origin;
+        const prefill = {
+            basePath: mountPath,
+            serverUrl: `${origin}${apiBasePath}`,
+            ...prefillFromResolver,
+        };
+        if (token !== undefined) {
+            prefill.token = token;
+        }
+        const requestOptions = { prefill };
+        const response = await serveConsoleStatic(c.req.raw, requestOptions);
+        if (!response)
+            return c.notFound();
+        return response;
+    };
+    const wildcardPath = mountPath === '/' ? '/*' : `${mountPath}/*`;
+    app.get(mountPath, handler);
+    app.get(wildcardPath, handler);
+}
+//# sourceMappingURL=ui.js.map

package/dist/console/ui.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui.js","sourceRoot":"","sources":["../../src/console/ui.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,4BAA4B,GAE7B,MAAM,0BAA0B,CAAC;AA6ClC,SAAS,aAAa,CAAC,QAA4B,EAAE,QAAgB,EAAU;IAC7E,MAAM,KAAK,GAAG,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IACrC,IAAI,CAAC,KAAK;QAAE,OAAO,QAAQ,CAAC;IAC5B,IAAI,KAAK,KAAK,GAAG;QAAE,OAAO,GAAG,CAAC;IAC9B,MAAM,gBAAgB,GAAG,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,EAAE,CAAC;IACrE,OAAO,gBAAgB,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC;AAAA,CACrD;AAED,MAAM,UAAU,cAAc,CAC5B,GAAS,EACT,OAAO,GAA0B,EAAE,EAC7B;IACN,MAAM,SAAS,GAAG,aAAa,CAAC,OAAO,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;IAC/D,MAAM,WAAW,GAAG,aAAa,CAAC,OAAO,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IAE/D,MAAM,qBAAqB,GAA0B;QACnD,SAAS;QACT,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,iBAAiB,EAAE,OAAO,CAAC,iBAAiB;QAC5C,iBAAiB,EAAE,OAAO,CAAC,iBAAiB;KAC7C,CAAC;IACF,MAAM,kBAAkB,GACtB,4BAA4B,CAAC,qBAAqB,CAAC,CAAC;IAEtD,MAAM,OAAO,GAAG,KAAK,EAAE,CAAU,EAAE,EAAE,CAAC;QACpC,MAAM,mBAAmB,GAAG,MAAM,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,CAAC;QAC9D,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,CAAC;QAC9C,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC;QAEzC,MAAM,OAAO,GAAqB;YAChC,QAAQ,EAAE,SAAS;YACnB,SAAS,EAAE,GAAG,MAAM,GAAG,WAAW,EAAE;YACpC,GAAG,mBAAmB;SACvB,CAAC;QAEF,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,OAAO,CAAC,KAAK,GAAG,KAAK,CAAC;QACxB,CAAC;QAED,MAAM,cAAc,GAAqC,EAAE,OAAO,EAAE,CAAC;QACrE,MAAM,QAAQ,GAAG,MAAM,kBAAkB,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;QACrE,IAAI,CAAC,QAAQ;YAAE,OAAO,CAAC,CAAC,QAAQ,EAAE,CAAC;QACnC,OAAO,QAAQ,CAAC;IAAA,CACjB,CAAC;IAEF,MAAM,YAAY,GAAG,SAAS,KAAK,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,SAAS,IAAI,CAAC;IACjE,GAAG,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAC5B,GAAG,CAAC,GAAG,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;AAAA,CAChC"}

package/dist/create-server.d.ts

@@ -2,47 +2,38 @@
  * Simplified server factory for Hono
  *
  * Breaking changes from legacy createSyncRoutes:
- * - handlers: array instead of TableRegistry
+ * - sync contract instead of top-level handlers/authenticate
  * - Combined sync + console routes in one call
  */
-import type { ServerSyncDialect, ServerTableHandler, SnapshotChunkStorage, SyncCoreDb } from '@syncular/server';
-import type { Context } from 'hono';
+import type { ScopeCacheBackend, ServerSyncConfig, ServerSyncDialect, SnapshotChunkStorage, SqlFamily, SyncCoreDb } from '@syncular/server';
 import type { UpgradeWebSocket } from 'hono/ws';
 import type { Kysely } from 'kysely';
-import { type ConsoleEventEmitter, createConsoleRoutes } from './console';
+import { createConsoleRoutes } from './console/routes';
+import type { ConsoleEventEmitter, ConsoleSharedOptions } from './console/types';
 import { createSyncRoutes, type SyncAuthResult, type SyncRoutesConfigWithRateLimit } from './routes';
-export interface SyncServerOptions<DB extends SyncCoreDb = SyncCoreDb> {
+export interface SyncServerOptions<DB extends SyncCoreDb = SyncCoreDb, Auth extends SyncAuthResult = SyncAuthResult, F extends SqlFamily = SqlFamily> {
     /** Kysely database instance */
     db: Kysely<DB>;
     /** Server sync dialect */
-    dialect: ServerSyncDialect;
-    /**
-     * Table handlers for sync operations.
-     */
-    handlers: ServerTableHandler<DB>[];
-    /** Authentication function - returns actorId or null for unauthenticated */
-    authenticate: (c: Context) => Promise<SyncAuthResult | null>;
+    dialect: ServerSyncDialect<F>;
+    /** Sync contract with auth + table handlers */
+    sync: ServerSyncConfig<DB, Auth>;
     /** Snapshot chunk storage (external body storage, e.g. R2/S3) */
     chunkStorage?: SnapshotChunkStorage;
+    /** Scope cache backend for resolveScopes() results */
+    scopeCache?: ScopeCacheBackend;
     /** Sync route configuration */
-    sync?: SyncRoutesConfigWithRateLimit;
+    routes?: SyncRoutesConfigWithRateLimit;
     /** WebSocket upgrader for realtime */
     upgradeWebSocket?: UpgradeWebSocket;
     /**
      * Console configuration for dashboard/monitoring.
      * Omit or set to false to disable console routes.
      */
-    console?: false | {
+    console?: false | ({
         /** Console bearer token for authentication (required unless SYNC_CONSOLE_TOKEN is set) */
         token?: string;
-        /** CORS origins (defaults to '*') */
-        corsOrigins?: '*' | string[];
-        /** Metrics aggregation strategy for console stats endpoints */
-        metrics?: {
-            aggregationMode?: 'auto' | 'raw' | 'aggregated';
-            rawFallbackMaxEvents?: number;
-        };
-    };
+    } & ConsoleSharedOptions);
 }
 export interface SyncServerResult {
     /** Sync routes for Hono */
@@ -57,29 +48,21 @@ export interface SyncServerResult {
  *
  * @example
  * ```typescript
- * // With handlers
+ * // With sync contract
  * const { syncRoutes } = createSyncServer({
  *   db,
  *   dialect,
- *   handlers: [tasksHandler, notesHandler],
- *   authenticate: async (c) => {
- *     const userId = c.req.header('x-user-id');
- *     return userId ? { actorId: userId } : null;
- *   },
+ *   sync,
  * });
  *
  * // With custom handlers
  * const { syncRoutes, consoleRoutes } = createSyncServer({
  *   db,
  *   dialect,
- *   handlers: [tasksHandler, notesHandler],
- *   authenticate: async (c) => {
- *     const userId = c.req.header('x-user-id');
- *     return userId ? { actorId: userId } : null;
- *   },
+ *   sync,
  *   console: { token: process.env.CONSOLE_TOKEN },
  * });
  * ```
  */
-export declare function createSyncServer<DB extends SyncCoreDb = SyncCoreDb>(options: SyncServerOptions<DB>): SyncServerResult;
+export declare function createSyncServer<DB extends SyncCoreDb = SyncCoreDb, Auth extends SyncAuthResult = SyncAuthResult, F extends SqlFamily = SqlFamily>(options: SyncServerOptions<DB, Auth, F>): SyncServerResult;
 //# sourceMappingURL=create-server.d.ts.map

package/dist/create-server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-server.d.ts","sourceRoot":"","sources":["../src/create-server.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,UAAU,EACX,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACpC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAChD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACrC,OAAO,EACL,KAAK,mBAAmB,EAExB,mBAAmB,EAEpB,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,gBAAgB,EAEhB,KAAK,cAAc,EACnB,KAAK,6BAA6B,EACnC,MAAM,UAAU,CAAC;AAElB,MAAM,WAAW,iBAAiB,CAAC,EAAE,SAAS,UAAU,GAAG,UAAU;IACnE,+BAA+B;IAC/B,EAAE,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;IAEf,0BAA0B;IAC1B,OAAO,EAAE,iBAAiB,CAAC;IAE3B;;OAEG;IACH,QAAQ,EAAE,kBAAkB,CAAC,EAAE,CAAC,EAAE,CAAC;IAEnC,4EAA4E;IAC5E,YAAY,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IAE7D,iEAAiE;IACjE,YAAY,CAAC,EAAE,oBAAoB,CAAC;IAEpC,+BAA+B;IAC/B,IAAI,CAAC,EAAE,6BAA6B,CAAC;IAErC,sCAAsC;IACtC,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IAEpC;;;OAGG;IACH,OAAO,CAAC,EACJ,KAAK,GACL;QACE,0FAA0F;QAC1F,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,qCAAqC;QACrC,WAAW,CAAC,EAAE,GAAG,GAAG,MAAM,EAAE,CAAC;QAC7B,+DAA+D;QAC/D,OAAO,CAAC,EAAE;YACR,eAAe,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,YAAY,CAAC;YAChD,oBAAoB,CAAC,EAAE,MAAM,CAAC;SAC/B,CAAC;KACH,CAAC;CACP;AAED,MAAM,WAAW,gBAAgB;IAC/B,2BAA2B;IAC3B,UAAU,EAAE,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC;IAChD,2CAA2C;IAC3C,aAAa,CAAC,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC;IACvD,iDAAiD;IACjD,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;CAC3C;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,SAAS,UAAU,GAAG,UAAU,EACjE,OAAO,EAAE,iBAAiB,CAAC,EAAE,CAAC,GAC7B,gBAAgB,CA0FlB"}
+{"version":3,"file":"create-server.d.ts","sourceRoot":"","sources":["../src/create-server.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,EACpB,SAAS,EACT,UAAU,EACX,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAChD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACrC,OAAO,EAEL,mBAAmB,EAEpB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EACV,mBAAmB,EACnB,oBAAoB,EACrB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,gBAAgB,EAEhB,KAAK,cAAc,EACnB,KAAK,6BAA6B,EACnC,MAAM,UAAU,CAAC;AAElB,MAAM,WAAW,iBAAiB,CAChC,EAAE,SAAS,UAAU,GAAG,UAAU,EAClC,IAAI,SAAS,cAAc,GAAG,cAAc,EAC5C,CAAC,SAAS,SAAS,GAAG,SAAS;IAE/B,+BAA+B;IAC/B,EAAE,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;IAEf,0BAA0B;IAC1B,OAAO,EAAE,iBAAiB,CAAC,CAAC,CAAC,CAAC;IAE9B,+CAA+C;IAC/C,IAAI,EAAE,gBAAgB,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;IAEjC,iEAAiE;IACjE,YAAY,CAAC,EAAE,oBAAoB,CAAC;IAEpC,sDAAsD;IACtD,UAAU,CAAC,EAAE,iBAAiB,CAAC;IAE/B,+BAA+B;IAC/B,MAAM,CAAC,EAAE,6BAA6B,CAAC;IAEvC,sCAAsC;IACtC,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IAEpC;;;OAGG;IACH,OAAO,CAAC,EACJ,KAAK,GACL,CAAC;QACC,0FAA0F;QAC1F,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,GAAG,oBAAoB,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,gBAAgB;IAC/B,2BAA2B;IAC3B,UAAU,EAAE,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC;IAChD,2CAA2C;IAC3C,aAAa,CAAC,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC;IACvD,iDAAiD;IACjD,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;CAC3C;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,gBAAgB,CAC9B,EAAE,SAAS,UAAU,GAAG,UAAU,EAClC,IAAI,SAAS,cAAc,GAAG,cAAc,EAC5C,CAAC,SAAS,SAAS,GAAG,SAAS,EAC/B,OAAO,EAAE,iBAAiB,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,gBAAgB,CAoG3D"}

package/dist/create-server.js

@@ -2,43 +2,35 @@
  * Simplified server factory for Hono
  *
  * Breaking changes from legacy createSyncRoutes:
- * - handlers: array instead of TableRegistry
+ * - sync contract instead of top-level handlers/authenticate
  * - Combined sync + console routes in one call
  */
-import { createConsoleEventEmitter, createConsoleRoutes, createTokenAuthenticator, } from './console/index.js';
+import { createConsoleEventEmitter, createConsoleRoutes, createTokenAuthenticator, } from './console/routes.js';
 import { createSyncRoutes, getSyncWebSocketConnectionManager, } from './routes.js';
 /**
  * Create a simplified sync server with sync and optional console routes.
  *
  * @example
  * ```typescript
- * // With handlers
+ * // With sync contract
  * const { syncRoutes } = createSyncServer({
  *   db,
  *   dialect,
- *   handlers: [tasksHandler, notesHandler],
- *   authenticate: async (c) => {
- *     const userId = c.req.header('x-user-id');
- *     return userId ? { actorId: userId } : null;
- *   },
+ *   sync,
  * });
  *
  * // With custom handlers
  * const { syncRoutes, consoleRoutes } = createSyncServer({
  *   db,
  *   dialect,
- *   handlers: [tasksHandler, notesHandler],
- *   authenticate: async (c) => {
- *     const userId = c.req.header('x-user-id');
- *     return userId ? { actorId: userId } : null;
- *   },
+ *   sync,
  *   console: { token: process.env.CONSOLE_TOKEN },
  * });
  * ```
  */
 export function createSyncServer(options) {
-    const { db, dialect, handlers, authenticate, chunkStorage, sync, upgradeWebSocket, console: consoleConfig, } = options;
-    if (handlers.length === 0) {
+    const { db, dialect, sync, chunkStorage, scopeCache, routes, upgradeWebSocket, console: consoleConfig, } = options;
+    if (sync.handlers.length === 0) {
         throw new Error('At least one handler must be provided');
     }
     const resolvedConsoleConfig = consoleConfig === false || consoleConfig === undefined
@@ -54,28 +46,33 @@ export function createSyncServer(options) {
     const consoleEventEmitter = isConsoleEnabled
         ? createConsoleEventEmitter()
         : undefined;
+    const consoleSchemaReady = isConsoleEnabled && dialect.ensureConsoleSchema
+        ? dialect.ensureConsoleSchema(db)
+        : undefined;
     // Create sync routes
     const syncRoutes = createSyncRoutes({
         db,
         dialect,
-        handlers,
-        authenticate,
+        handlers: sync.handlers,
+        authenticate: async (context) => sync.authenticate(context.req.raw),
         chunkStorage,
+        scopeCache,
         consoleLiveEmitter: consoleEventEmitter,
+        consoleSchemaReady,
         sync: {
-            ...sync,
+            ...routes,
             websocket: upgradeWebSocket
                 ? {
                     enabled: true,
                     upgradeWebSocket,
-                    ...(sync?.websocket?.heartbeatIntervalMs !== undefined && {
-                        heartbeatIntervalMs: sync.websocket.heartbeatIntervalMs,
+                    ...(routes?.websocket?.heartbeatIntervalMs !== undefined && {
+                        heartbeatIntervalMs: routes.websocket.heartbeatIntervalMs,
                     }),
-                    ...(sync?.websocket?.maxConnectionsTotal !== undefined && {
-                        maxConnectionsTotal: sync.websocket.maxConnectionsTotal,
+                    ...(routes?.websocket?.maxConnectionsTotal !== undefined && {
+                        maxConnectionsTotal: routes.websocket.maxConnectionsTotal,
                     }),
-                    ...(sync?.websocket?.maxConnectionsPerClient !== undefined && {
-                        maxConnectionsPerClient: sync.websocket.maxConnectionsPerClient,
+                    ...(routes?.websocket?.maxConnectionsPerClient !== undefined && {
+                        maxConnectionsPerClient: routes.websocket.maxConnectionsPerClient,
                     }),
                 }
                 : { enabled: false },
@@ -88,12 +85,15 @@ export function createSyncServer(options) {
     const consoleRoutes = createConsoleRoutes({
         db,
         dialect,
-        handlers,
+        handlers: sync.handlers,
         authenticate: createTokenAuthenticator(consoleToken),
-        corsOrigins: resolvedConsoleConfig.corsOrigins ?? '*',
+        corsOrigins: resolvedConsoleConfig.corsOrigins,
         eventEmitter: consoleEventEmitter,
+        consoleSchemaReady,
         wsConnectionManager: getSyncWebSocketConnectionManager(syncRoutes),
         metrics: resolvedConsoleConfig.metrics,
+        maintenance: resolvedConsoleConfig.maintenance,
+        blobBucket: resolvedConsoleConfig.blobBucket,
         ...(upgradeWebSocket && {
             websocket: {
                 enabled: true,

package/dist/create-server.js.map

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

package/dist/proxy/connection-manager.d.ts

@@ -4,7 +4,7 @@
  * Manages WebSocket connections for the proxy.
  */
 import type { ProxyHandshake, ProxyMessage, ProxyResponse } from '@syncular/core';
-import type { ProxyTableRegistry, ServerSyncDialect, SyncCoreDb } from '@syncular/server';
+import type { ProxyHandlerCollection, ServerSyncDialect, SyncCoreDb } from '@syncular/server';
 import type { WSContext } from 'hono/ws';
 import type { Kysely, Transaction } from 'kysely';
 export interface ProxyConnectionManagerConfig<DB extends SyncCoreDb = SyncCoreDb> {
@@ -12,8 +12,8 @@ export interface ProxyConnectionManagerConfig<DB extends SyncCoreDb = SyncCoreDb
     db: Kysely<DB>;
     /** Server sync dialect */
     dialect: ServerSyncDialect;
-    /** Proxy table registry for oplog generation */
-    handlers: ProxyTableRegistry;
+    /** Proxy table handlers for oplog generation */
+    handlers: ProxyHandlerCollection;
     /** Maximum concurrent connections (default: 100) */
     maxConnections?: number;
     /** Idle connection timeout in ms (default: 30000) */

package/dist/proxy/connection-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"connection-manager.d.ts","sourceRoot":"","sources":["../../src/proxy/connection-manager.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,cAAc,EACd,YAAY,EACZ,aAAa,EACd,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAEV,kBAAkB,EAClB,iBAAiB,EACjB,UAAU,EACX,MAAM,kBAAkB,CAAC;AAE1B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAElD,MAAM,WAAW,4BAA4B,CAC3C,EAAE,SAAS,UAAU,GAAG,UAAU;IAElC,0BAA0B;IAC1B,EAAE,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;IACf,0BAA0B;IAC1B,OAAO,EAAE,iBAAiB,CAAC;IAC3B,gDAAgD;IAChD,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,oDAAoD;IACpD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,qDAAqD;IACrD,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,UAAU,oBAAoB,CAAC,EAAE,SAAS,UAAU;IAClD,EAAE,EAAE,SAAS,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,WAAW,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC;IACpC,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,GAAG,IAAI,CAAC;IAChD,2CAA2C;IAC3C,oBAAoB,CAAC,EAAE,MAAM,IAAI,CAAC;IAClC,0CAA0C;IAC1C,mBAAmB,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAC9C;AAED;;GAEG;AACH,qBAAa,sBAAsB,CAAC,EAAE,SAAS,UAAU,GAAG,UAAU;IACpE,OAAO,CAAC,WAAW,CAAkD;IACrE,OAAO,CAAC,MAAM,CAAmC;IACjD,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,cAAc,CAAS;IAE/B,YAAY,MAAM,EAAE,4BAA4B,CAAC,EAAE,CAAC,EAInD;IAED;;OAEG;IACH,SAAS,IAAI,OAAO,CAEnB;IAED;;OAEG;IACH,kBAAkB,IAAI,MAAM,CAE3B;IAED;;OAEG;IACH,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,cAAc,GAAG,oBAAoB,CAAC,EAAE,CAAC,CAc3E;IAED;;OAEG;IACH,GAAG,CAAC,EAAE,EAAE,SAAS,GAAG,oBAAoB,CAAC,EAAE,CAAC,GAAG,SAAS,CAEvD;IAED;;OAEG;IACG,UAAU,CAAC,EAAE,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAqB7C;IAED;;OAEG;IACG,aAAa,CACjB,EAAE,EAAE,SAAS,EACb,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,aAAa,CAAC,CA0CxB;YAEa,WAAW;YAoCX,YAAY;YA2BZ,cAAc;YA2Bd,WAAW;IAkCzB,OAAO,CAAC,cAAc;IAkBtB;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAa9B;CACF"}
+{"version":3,"file":"connection-manager.d.ts","sourceRoot":"","sources":["../../src/proxy/connection-manager.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,cAAc,EACd,YAAY,EACZ,aAAa,EACd,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAEV,sBAAsB,EACtB,iBAAiB,EACjB,UAAU,EACX,MAAM,kBAAkB,CAAC;AAE1B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAElD,MAAM,WAAW,4BAA4B,CAC3C,EAAE,SAAS,UAAU,GAAG,UAAU;IAElC,0BAA0B;IAC1B,EAAE,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;IACf,0BAA0B;IAC1B,OAAO,EAAE,iBAAiB,CAAC;IAC3B,gDAAgD;IAChD,QAAQ,EAAE,sBAAsB,CAAC;IACjC,oDAAoD;IACpD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,qDAAqD;IACrD,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,UAAU,oBAAoB,CAAC,EAAE,SAAS,UAAU;IAClD,EAAE,EAAE,SAAS,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,WAAW,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC;IACpC,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,GAAG,IAAI,CAAC;IAChD,2CAA2C;IAC3C,oBAAoB,CAAC,EAAE,MAAM,IAAI,CAAC;IAClC,0CAA0C;IAC1C,mBAAmB,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAC9C;AAED;;GAEG;AACH,qBAAa,sBAAsB,CAAC,EAAE,SAAS,UAAU,GAAG,UAAU;IACpE,OAAO,CAAC,WAAW,CAAkD;IACrE,OAAO,CAAC,MAAM,CAAmC;IACjD,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,cAAc,CAAS;IAE/B,YAAY,MAAM,EAAE,4BAA4B,CAAC,EAAE,CAAC,EAInD;IAED;;OAEG;IACH,SAAS,IAAI,OAAO,CAEnB;IAED;;OAEG;IACH,kBAAkB,IAAI,MAAM,CAE3B;IAED;;OAEG;IACH,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,cAAc,GAAG,oBAAoB,CAAC,EAAE,CAAC,CAc3E;IAED;;OAEG;IACH,GAAG,CAAC,EAAE,EAAE,SAAS,GAAG,oBAAoB,CAAC,EAAE,CAAC,GAAG,SAAS,CAEvD;IAED;;OAEG;IACG,UAAU,CAAC,EAAE,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAqB7C;IAED;;OAEG;IACG,aAAa,CACjB,EAAE,EAAE,SAAS,EACb,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,aAAa,CAAC,CA0CxB;YAEa,WAAW;YAoCX,YAAY;YA2BZ,cAAc;YA2Bd,WAAW;IAkCzB,OAAO,CAAC,cAAc;IAkBtB;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAa9B;CACF"}

package/dist/proxy/routes.d.ts

@@ -4,7 +4,7 @@
  * WebSocket endpoint for database proxy.
  */
 import type { ProxyHandshake, ProxyMessage, ProxyResponse } from '@syncular/core';
-import type { ProxyTableRegistry, ServerSyncDialect, SyncCoreDb } from '@syncular/server';
+import type { ProxyHandlerCollection, ServerSyncDialect, SyncCoreDb } from '@syncular/server';
 import type { Context } from 'hono';
 import { Hono } from 'hono';
 import type { UpgradeWebSocket, WSContext } from 'hono/ws';
@@ -28,8 +28,8 @@ interface CreateProxyRoutesConfig<DB extends SyncCoreDb = SyncCoreDb> {
     db: Kysely<DB>;
     /** Server sync dialect */
     dialect: ServerSyncDialect;
-    /** Proxy table registry for oplog generation */
-    handlers: ProxyTableRegistry;
+    /** Proxy table handlers for oplog generation */
+    handlers: ProxyHandlerCollection;
     /** Authenticate the request and return actor info */
     authenticate: (c: Context) => Promise<ProxyAuthResult | null>;
     /** WebSocket upgrade function from Hono */
@@ -54,7 +54,7 @@ interface CreateProxyRoutesConfig<DB extends SyncCoreDb = SyncCoreDb> {
  *
  * app.route('/proxy', createProxyRoutes({
  *   db,
- *   handlers: proxyTableRegistry,
+ *   handlers: proxyHandlers,
  *   authenticate: async (c) => {
  *     // Verify admin auth
  *     return { actorId: 'admin:123' };

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

@@ -1 +1 @@
-{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../src/proxy/routes.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,cAAc,EAEd,YAAY,EACZ,aAAa,EACd,MAAM,gBAAgB,CAAC;AAExB,OAAO,KAAK,EACV,kBAAkB,EAClB,iBAAiB,EACjB,UAAU,EACX,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACpC,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,KAAK,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAC3D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAGrC;;GAEG;AACH,UAAU,4BAA4B;IACpC,SAAS,IAAI,OAAO,CAAC;IACrB,kBAAkB,IAAI,MAAM,CAAC;IAC7B,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,cAAc,GAAG,OAAO,CAAC;IAC5D,aAAa,CAAC,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAC5E,UAAU,CAAC,EAAE,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1C;AAOD,UAAU,eAAe;IACvB,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,UAAU,uBAAuB,CAAC,EAAE,SAAS,UAAU,GAAG,UAAU;IAClE,0BAA0B;IAC1B,EAAE,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;IACf,0BAA0B;IAC1B,OAAO,EAAE,iBAAiB,CAAC;IAC3B,gDAAgD;IAChD,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,qDAAqD;IACrD,YAAY,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC;IAC9D,2CAA2C;IAC3C,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,oDAAoD;IACpD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,qDAAqD;IACrD,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,SAAS,UAAU,EACrD,MAAM,EAAE,uBAAuB,CAAC,EAAE,CAAC,GAClC,IAAI,CA2HN;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,IAAI,GACX,4BAA4B,GAAG,SAAS,CAE1C"}
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../src/proxy/routes.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,cAAc,EAEd,YAAY,EACZ,aAAa,EACd,MAAM,gBAAgB,CAAC;AAExB,OAAO,KAAK,EACV,sBAAsB,EACtB,iBAAiB,EACjB,UAAU,EACX,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACpC,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,KAAK,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAC3D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAGrC;;GAEG;AACH,UAAU,4BAA4B;IACpC,SAAS,IAAI,OAAO,CAAC;IACrB,kBAAkB,IAAI,MAAM,CAAC;IAC7B,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,cAAc,GAAG,OAAO,CAAC;IAC5D,aAAa,CAAC,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAC5E,UAAU,CAAC,EAAE,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1C;AAOD,UAAU,eAAe;IACvB,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,UAAU,uBAAuB,CAAC,EAAE,SAAS,UAAU,GAAG,UAAU;IAClE,0BAA0B;IAC1B,EAAE,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;IACf,0BAA0B;IAC1B,OAAO,EAAE,iBAAiB,CAAC;IAC3B,gDAAgD;IAChD,QAAQ,EAAE,sBAAsB,CAAC;IACjC,qDAAqD;IACrD,YAAY,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC;IAC9D,2CAA2C;IAC3C,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,oDAAoD;IACpD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,qDAAqD;IACrD,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,SAAS,UAAU,EACrD,MAAM,EAAE,uBAAuB,CAAC,EAAE,CAAC,GAClC,IAAI,CA2HN;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,IAAI,GACX,4BAA4B,GAAG,SAAS,CAE1C"}

package/dist/proxy/routes.js

@@ -22,7 +22,7 @@ const proxyConnectionManagerMap = new WeakMap();
  *
  * app.route('/proxy', createProxyRoutes({
  *   db,
- *   handlers: proxyTableRegistry,
+ *   handlers: proxyHandlers,
  *   authenticate: async (c) => {
  *     // Verify admin auth
  *     return { actorId: 'admin:123' };