@syncular/server-hono 0.0.1-60

package/dist/create-server.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Simplified server factory for Hono
+ *
+ * Breaking changes from legacy createSyncRoutes:
+ * - handlers: array instead of TableRegistry
+ * - Combined sync + console routes in one call
+ */
+import type { ServerSyncDialect, ServerTableHandler, SyncCoreDb } from '@syncular/server';
+import type { Context } from 'hono';
+import type { UpgradeWebSocket } from 'hono/ws';
+import type { Kysely } from 'kysely';
+import { type ConsoleEventEmitter, createConsoleRoutes } from './console';
+import { createSyncRoutes, type SyncAuthResult, type SyncRoutesConfigWithRateLimit } from './routes';
+export interface SyncServerOptions<DB extends SyncCoreDb = SyncCoreDb> {
+    /** 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>;
+    /** Sync route configuration */
+    sync?: SyncRoutesConfigWithRateLimit;
+    /** WebSocket upgrader for realtime */
+    upgradeWebSocket?: UpgradeWebSocket;
+    /**
+     * Console configuration for dashboard/monitoring.
+     * Omit or set to false to disable console routes.
+     */
+    console?: false | {
+        /** Console bearer token for authentication (required unless SYNC_CONSOLE_TOKEN is set) */
+        token?: string;
+        /** CORS origins (defaults to '*') */
+        corsOrigins?: '*' | string[];
+    };
+}
+export interface SyncServerResult {
+    /** Sync routes for Hono */
+    syncRoutes: ReturnType<typeof createSyncRoutes>;
+    /** Console routes for Hono (if enabled) */
+    consoleRoutes?: ReturnType<typeof createConsoleRoutes>;
+    /** Console event emitter (if console enabled) */
+    consoleEventEmitter?: ConsoleEventEmitter;
+}
+/**
+ * Create a simplified sync server with sync and optional console routes.
+ *
+ * @example
+ * ```typescript
+ * // With handlers
+ * const { syncRoutes } = createSyncServer({
+ *   db,
+ *   dialect,
+ *   handlers: [tasksHandler, notesHandler],
+ *   authenticate: async (c) => {
+ *     const userId = c.req.header('x-user-id');
+ *     return userId ? { actorId: userId } : null;
+ *   },
+ * });
+ *
+ * // 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;
+ *   },
+ *   console: { token: process.env.CONSOLE_TOKEN },
+ * });
+ * ```
+ */
+export declare function createSyncServer<DB extends SyncCoreDb = SyncCoreDb>(options: SyncServerOptions<DB>): SyncServerResult;
+//# sourceMappingURL=create-server.d.ts.map

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

@@ -0,0 +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,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,+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;KAC9B,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,CA2ElB"}

package/dist/create-server.js

@@ -0,0 +1,99 @@
+/**
+ * Simplified server factory for Hono
+ *
+ * Breaking changes from legacy createSyncRoutes:
+ * - handlers: array instead of TableRegistry
+ * - Combined sync + console routes in one call
+ */
+import { createConsoleEventEmitter, createConsoleRoutes, createTokenAuthenticator, } from './console';
+import { createSyncRoutes, getSyncWebSocketConnectionManager, } from './routes';
+/**
+ * Create a simplified sync server with sync and optional console routes.
+ *
+ * @example
+ * ```typescript
+ * // With handlers
+ * const { syncRoutes } = createSyncServer({
+ *   db,
+ *   dialect,
+ *   handlers: [tasksHandler, notesHandler],
+ *   authenticate: async (c) => {
+ *     const userId = c.req.header('x-user-id');
+ *     return userId ? { actorId: userId } : null;
+ *   },
+ * });
+ *
+ * // 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;
+ *   },
+ *   console: { token: process.env.CONSOLE_TOKEN },
+ * });
+ * ```
+ */
+export function createSyncServer(options) {
+    const { db, dialect, handlers, authenticate, sync, upgradeWebSocket, console: consoleConfig, } = options;
+    if (handlers.length === 0) {
+        throw new Error('At least one handler must be provided');
+    }
+    // Create sync routes
+    const syncRoutes = createSyncRoutes({
+        db,
+        dialect,
+        handlers,
+        authenticate,
+        sync: {
+            ...sync,
+            websocket: upgradeWebSocket
+                ? {
+                    enabled: true,
+                    upgradeWebSocket,
+                    ...(sync?.websocket?.heartbeatIntervalMs !== undefined && {
+                        heartbeatIntervalMs: sync.websocket.heartbeatIntervalMs,
+                    }),
+                    ...(sync?.websocket?.maxConnectionsTotal !== undefined && {
+                        maxConnectionsTotal: sync.websocket.maxConnectionsTotal,
+                    }),
+                    ...(sync?.websocket?.maxConnectionsPerClient !== undefined && {
+                        maxConnectionsPerClient: sync.websocket.maxConnectionsPerClient,
+                    }),
+                }
+                : { enabled: false },
+        },
+    });
+    // Console is opt-in; disable unless explicitly configured.
+    if (!consoleConfig) {
+        return { syncRoutes };
+    }
+    const consoleToken = consoleConfig.token ?? process.env.SYNC_CONSOLE_TOKEN;
+    if (!consoleToken) {
+        throw new Error('Console is enabled but no token is configured. Set `console.token` or SYNC_CONSOLE_TOKEN.');
+    }
+    const consoleEventEmitter = createConsoleEventEmitter();
+    const consoleRoutes = createConsoleRoutes({
+        db,
+        dialect,
+        handlers,
+        authenticate: createTokenAuthenticator(consoleToken),
+        corsOrigins: consoleConfig.corsOrigins ?? '*',
+        eventEmitter: consoleEventEmitter,
+        wsConnectionManager: getSyncWebSocketConnectionManager(syncRoutes),
+        ...(upgradeWebSocket && {
+            websocket: {
+                enabled: true,
+                upgradeWebSocket,
+            },
+        }),
+    });
+    return {
+        syncRoutes,
+        consoleRoutes,
+        consoleEventEmitter,
+    };
+}
+//# sourceMappingURL=create-server.js.map

package/dist/create-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-server.js","sourceRoot":"","sources":["../src/create-server.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAUH,OAAO,EAEL,yBAAyB,EACzB,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,gBAAgB,EAChB,iCAAiC,GAGlC,MAAM,UAAU,CAAC;AA8ClB;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,UAAU,gBAAgB,CAC9B,OAA8B,EACZ;IAClB,MAAM,EACJ,EAAE,EACF,OAAO,EACP,QAAQ,EACR,YAAY,EACZ,IAAI,EACJ,gBAAgB,EAChB,OAAO,EAAE,aAAa,GACvB,GAAG,OAAO,CAAC;IAEZ,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAC3D,CAAC;IAED,qBAAqB;IACrB,MAAM,UAAU,GAAG,gBAAgB,CAAC;QAClC,EAAE;QACF,OAAO;QACP,QAAQ;QACR,YAAY;QACZ,IAAI,EAAE;YACJ,GAAG,IAAI;YACP,SAAS,EAAE,gBAAgB;gBACzB,CAAC,CAAC;oBACE,OAAO,EAAE,IAAI;oBACb,gBAAgB;oBAChB,GAAG,CAAC,IAAI,EAAE,SAAS,EAAE,mBAAmB,KAAK,SAAS,IAAI;wBACxD,mBAAmB,EAAE,IAAI,CAAC,SAAS,CAAC,mBAAmB;qBACxD,CAAC;oBACF,GAAG,CAAC,IAAI,EAAE,SAAS,EAAE,mBAAmB,KAAK,SAAS,IAAI;wBACxD,mBAAmB,EAAE,IAAI,CAAC,SAAS,CAAC,mBAAmB;qBACxD,CAAC;oBACF,GAAG,CAAC,IAAI,EAAE,SAAS,EAAE,uBAAuB,KAAK,SAAS,IAAI;wBAC5D,uBAAuB,EAAE,IAAI,CAAC,SAAS,CAAC,uBAAuB;qBAChE,CAAC;iBACH;gBACH,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE;SACvB;KACF,CAAC,CAAC;IAEH,2DAA2D;IAC3D,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,OAAO,EAAE,UAAU,EAAE,CAAC;IACxB,CAAC;IAED,MAAM,YAAY,GAAG,aAAa,CAAC,KAAK,IAAI,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;IAC3E,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CACb,2FAA2F,CAC5F,CAAC;IACJ,CAAC;IACD,MAAM,mBAAmB,GAAG,yBAAyB,EAAE,CAAC;IAExD,MAAM,aAAa,GAAG,mBAAmB,CAAC;QACxC,EAAE;QACF,OAAO;QACP,QAAQ;QACR,YAAY,EAAE,wBAAwB,CAAC,YAAY,CAAC;QACpD,WAAW,EAAE,aAAa,CAAC,WAAW,IAAI,GAAG;QAC7C,YAAY,EAAE,mBAAmB;QACjC,mBAAmB,EAAE,iCAAiC,CAAC,UAAU,CAAC;QAClE,GAAG,CAAC,gBAAgB,IAAI;YACtB,SAAS,EAAE;gBACT,OAAO,EAAE,IAAI;gBACb,gBAAgB;aACjB;SACF,CAAC;KACH,CAAC,CAAC;IAEH,OAAO;QACL,UAAU;QACV,aAAa;QACb,mBAAmB;KACpB,CAAC;AAAA,CACH"}

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @syncular/server-hono - Hono adapter for sync infrastructure
+ *
+ * This package provides Hono-specific routes for @syncular/server.
+ * Keeps @syncular/server framework-agnostic.
+ */
+export * from './api-key-auth';
+export { type CreateBlobRoutesOptions, createBlobRoutes } from './blobs';
+export * from './console';
+export { createSyncServer, type SyncServerOptions, type SyncServerResult, } from './create-server';
+export * from './openapi';
+export * from './proxy';
+export * from './rate-limit';
+export { type CreateSyncRoutesOptions, createSyncRoutes, getSyncRealtimeUnsubscribe, getSyncWebSocketConnectionManager, } from './routes';
+export * from './ws';
+//# 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;;;;;GAKG;AAGH,cAAc,gBAAgB,CAAC;AAG/B,OAAO,EAAE,KAAK,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAGzE,cAAc,WAAW,CAAC;AAG1B,OAAO,EACL,gBAAgB,EAChB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,GACtB,MAAM,iBAAiB,CAAC;AAGzB,cAAc,WAAW,CAAC;AAG1B,cAAc,SAAS,CAAC;AAGxB,cAAc,cAAc,CAAC;AAG7B,OAAO,EACL,KAAK,uBAAuB,EAC5B,gBAAgB,EAChB,0BAA0B,EAC1B,iCAAiC,GAClC,MAAM,UAAU,CAAC;AAGlB,cAAc,MAAM,CAAC"}

package/dist/index.js

@@ -0,0 +1,25 @@
+/**
+ * @syncular/server-hono - Hono adapter for sync infrastructure
+ *
+ * This package provides Hono-specific routes for @syncular/server.
+ * Keeps @syncular/server framework-agnostic.
+ */
+// API Key Auth
+export * from './api-key-auth';
+// Blob routes
+export { createBlobRoutes } from './blobs';
+// Console
+export * from './console';
+// Simplified server factory
+export { createSyncServer, } from './create-server';
+// OpenAPI utilities
+export * from './openapi';
+// Proxy
+export * from './proxy';
+// Rate limiting
+export * from './rate-limit';
+// Route types and factory
+export { createSyncRoutes, getSyncRealtimeUnsubscribe, getSyncWebSocketConnectionManager, } from './routes';
+// WebSocket helpers for realtime sync
+export * from './ws';
+//# 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;;;;;GAKG;AAEH,eAAe;AACf,cAAc,gBAAgB,CAAC;AAE/B,cAAc;AACd,OAAO,EAAgC,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAEzE,UAAU;AACV,cAAc,WAAW,CAAC;AAE1B,4BAA4B;AAC5B,OAAO,EACL,gBAAgB,GAGjB,MAAM,iBAAiB,CAAC;AAEzB,oBAAoB;AACpB,cAAc,WAAW,CAAC;AAE1B,QAAQ;AACR,cAAc,SAAS,CAAC;AAExB,gBAAgB;AAChB,cAAc,cAAc,CAAC;AAE7B,0BAA0B;AAC1B,OAAO,EAEL,gBAAgB,EAChB,0BAA0B,EAC1B,iCAAiC,GAClC,MAAM,UAAU,CAAC;AAElB,sCAAsC;AACtC,cAAc,MAAM,CAAC"}

package/dist/openapi.d.ts

@@ -0,0 +1,45 @@
+/**
+ * @syncular/server-hono - OpenAPI Spec Export
+ *
+ * Provides utilities for generating and serving OpenAPI specifications.
+ */
+import type { Hono } from 'hono';
+interface OpenAPIConfig {
+    title?: string;
+    version?: string;
+    description?: string;
+    servers?: Array<{
+        url: string;
+        description?: string;
+    }>;
+}
+/**
+ * Create an OpenAPI spec handler that can be used with Hono routes.
+ *
+ * @example
+ * ```typescript
+ * import { Hono } from 'hono';
+ * import { createSyncRoutes, createConsoleRoutes, createOpenAPIHandler } from '@syncular/server-hono';
+ *
+ * const app = new Hono();
+ * const syncRoutes = createSyncRoutes({ ... });
+ * const consoleRoutes = createConsoleRoutes({ ... });
+ *
+ * app.route('/sync', syncRoutes);
+ * app.route('/console', consoleRoutes);
+ *
+ * // Add OpenAPI spec endpoint
+ * app.get('/openapi.json', createOpenAPIHandler(app, {
+ *   title: 'Syncular API',
+ *   version: '1.0.0',
+ * }));
+ * ```
+ */
+export declare function createOpenAPIHandler(app: Hono, config?: OpenAPIConfig): import("hono").MiddlewareHandler<import("hono/types").BlankEnv, "/", import("hono/types").BlankInput>;
+/**
+ * Generate OpenAPI document from a Hono app instance.
+ * This is useful for build-time spec generation.
+ */
+export declare function generateOpenAPIDocument(app: Hono, config?: OpenAPIConfig): Promise<unknown>;
+export {};
+//# sourceMappingURL=openapi.d.ts.map

package/dist/openapi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi.d.ts","sourceRoot":"","sources":["../src/openapi.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAGjC,UAAU,aAAa;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACxD;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,IAAI,EAAE,MAAM,GAAE,aAAkB,yGAazE;AAED;;;GAGG;AACH,wBAAsB,uBAAuB,CAC3C,GAAG,EAAE,IAAI,EACT,MAAM,GAAE,aAAkB,GACzB,OAAO,CAAC,OAAO,CAAC,CAalB"}

package/dist/openapi.js

@@ -0,0 +1,59 @@
+/**
+ * @syncular/server-hono - OpenAPI Spec Export
+ *
+ * Provides utilities for generating and serving OpenAPI specifications.
+ */
+import { generateSpecs, openAPIRouteHandler } from 'hono-openapi';
+/**
+ * Create an OpenAPI spec handler that can be used with Hono routes.
+ *
+ * @example
+ * ```typescript
+ * import { Hono } from 'hono';
+ * import { createSyncRoutes, createConsoleRoutes, createOpenAPIHandler } from '@syncular/server-hono';
+ *
+ * const app = new Hono();
+ * const syncRoutes = createSyncRoutes({ ... });
+ * const consoleRoutes = createConsoleRoutes({ ... });
+ *
+ * app.route('/sync', syncRoutes);
+ * app.route('/console', consoleRoutes);
+ *
+ * // Add OpenAPI spec endpoint
+ * app.get('/openapi.json', createOpenAPIHandler(app, {
+ *   title: 'Syncular API',
+ *   version: '1.0.0',
+ * }));
+ * ```
+ */
+export function createOpenAPIHandler(app, config = {}) {
+    return openAPIRouteHandler(app, {
+        documentation: {
+            info: {
+                title: config.title ?? 'Syncular API',
+                version: config.version ?? '1.0.0',
+                description: config.description ??
+                    'Sync infrastructure API for real-time data synchronization',
+            },
+            servers: config.servers,
+        },
+    });
+}
+/**
+ * Generate OpenAPI document from a Hono app instance.
+ * This is useful for build-time spec generation.
+ */
+export async function generateOpenAPIDocument(app, config = {}) {
+    return generateSpecs(app, {
+        documentation: {
+            info: {
+                title: config.title ?? 'Syncular API',
+                version: config.version ?? '1.0.0',
+                description: config.description ??
+                    'Sync infrastructure API for real-time data synchronization',
+            },
+            servers: config.servers,
+        },
+    });
+}
+//# sourceMappingURL=openapi.js.map

package/dist/openapi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi.js","sourceRoot":"","sources":["../src/openapi.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AASlE;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,oBAAoB,CAAC,GAAS,EAAE,MAAM,GAAkB,EAAE,EAAE;IAC1E,OAAO,mBAAmB,CAAC,GAAG,EAAE;QAC9B,aAAa,EAAE;YACb,IAAI,EAAE;gBACJ,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,cAAc;gBACrC,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,OAAO;gBAClC,WAAW,EACT,MAAM,CAAC,WAAW;oBAClB,4DAA4D;aAC/D;YACD,OAAO,EAAE,MAAM,CAAC,OAAO;SACxB;KACF,CAAC,CAAC;AAAA,CACJ;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,GAAS,EACT,MAAM,GAAkB,EAAE,EACR;IAClB,OAAO,aAAa,CAAC,GAAG,EAAE;QACxB,aAAa,EAAE;YACb,IAAI,EAAE;gBACJ,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,cAAc;gBACrC,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,OAAO;gBAClC,WAAW,EACT,MAAM,CAAC,WAAW;oBAClB,4DAA4D;aAC/D;YACD,OAAO,EAAE,MAAM,CAAC,OAAO;SACxB;KACF,CAAC,CAAC;AAAA,CACJ"}

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

@@ -0,0 +1,78 @@
+/**
+ * @syncular/server-hono - Proxy Connection Manager
+ *
+ * Manages WebSocket connections for the proxy.
+ */
+import type { ProxyHandshake, ProxyMessage, ProxyResponse } from '@syncular/core';
+import type { ProxyTableRegistry, ServerSyncDialect, SyncCoreDb } from '@syncular/server';
+import type { WSContext } from 'hono/ws';
+import type { Kysely, Transaction } from 'kysely';
+export interface ProxyConnectionManagerConfig<DB extends SyncCoreDb = SyncCoreDb> {
+    /** Database connection */
+    db: Kysely<DB>;
+    /** Server sync dialect */
+    dialect: ServerSyncDialect;
+    /** Proxy table registry for oplog generation */
+    shapes: ProxyTableRegistry;
+    /** Maximum concurrent connections (default: 100) */
+    maxConnections?: number;
+    /** Idle connection timeout in ms (default: 30000) */
+    idleTimeoutMs?: number;
+}
+interface ProxyConnectionState<DB extends SyncCoreDb> {
+    ws: WSContext;
+    actorId: string;
+    clientId: string;
+    transaction: Transaction<DB> | null;
+    lastActivity: number;
+    idleTimer: ReturnType<typeof setTimeout> | null;
+    /** Transaction promise resolve callback */
+    __resolveTransaction?: () => void;
+    /** Transaction promise reject callback */
+    __rejectTransaction?: (error: Error) => void;
+}
+/**
+ * Manages proxy WebSocket connections and their state.
+ */
+export declare class ProxyConnectionManager<DB extends SyncCoreDb = SyncCoreDb> {
+    private connections;
+    private config;
+    private idleTimeoutMs;
+    private maxConnections;
+    constructor(config: ProxyConnectionManagerConfig<DB>);
+    /**
+     * Check if a new connection can be accepted.
+     */
+    canAccept(): boolean;
+    /**
+     * Get the current connection count.
+     */
+    getConnectionCount(): number;
+    /**
+     * Handle the handshake message and register the connection.
+     */
+    register(ws: WSContext, handshake: ProxyHandshake): ProxyConnectionState<DB>;
+    /**
+     * Get the connection state for a WebSocket.
+     */
+    get(ws: WSContext): ProxyConnectionState<DB> | undefined;
+    /**
+     * Unregister and cleanup a connection.
+     */
+    unregister(ws: WSContext): Promise<void>;
+    /**
+     * Handle a proxy message and return the response.
+     */
+    handleMessage(ws: WSContext, message: ProxyMessage): Promise<ProxyResponse>;
+    private handleBegin;
+    private handleCommit;
+    private handleRollback;
+    private handleQuery;
+    private resetIdleTimer;
+    /**
+     * Close all connections.
+     */
+    closeAll(): Promise<void>;
+}
+export {};
+//# sourceMappingURL=connection-manager.d.ts.map

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

@@ -0,0 +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,MAAM,EAAE,kBAAkB,CAAC;IAC3B,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"}