@syncular/server 0.0.6-96 → 0.1.0

package/dist/hono/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Hono adapter for Syncular server infrastructure.
+ *
+ * The root @syncular/server export stays framework-agnostic; Hono-specific
+ * imports live behind this opt-in subpath.
+ */
+export * from './api-key-auth';
+export { type CreateBlobRoutesOptions, createBlobRoutes } from './blobs';
+export * from './console/gateway';
+export * from './console/routes';
+export * from './console/schemas';
+export * from './console/types';
+export { createSyncServer, type SyncServerOptions, type SyncServerResult, } from './create-server';
+export * from './openapi';
+export * from './proxy';
+export * from './rate-limit';
+export * from './realtime-sync-packs';
+export { type CreateSyncRoutesOptions, createSyncRoutes, getSyncRealtimeUnsubscribe, getSyncWebSocketConnectionManager, type NormalizedSyncCorsConfig, normalizeSyncCorsConfig, type SyncCorsOptions, type SyncCorsOrigin, type SyncCorsOriginResolver, } from './routes';
+export * from './ws';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hono/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,cAAc,gBAAgB,CAAC;AAG/B,OAAO,EAAE,KAAK,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAIzE,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAGhC,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,cAAc,uBAAuB,CAAC;AAGtC,OAAO,EACL,KAAK,uBAAuB,EAC5B,gBAAgB,EAChB,0BAA0B,EAC1B,iCAAiC,EACjC,KAAK,wBAAwB,EAC7B,uBAAuB,EACvB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,sBAAsB,GAC5B,MAAM,UAAU,CAAC;AAGlB,cAAc,MAAM,CAAC"}

package/dist/hono/index.js

@@ -0,0 +1,31 @@
+/**
+ * Hono adapter for Syncular server infrastructure.
+ *
+ * The root @syncular/server export stays framework-agnostic; Hono-specific
+ * imports live behind this opt-in subpath.
+ */
+// API Key Auth
+export * from './api-key-auth';
+// Blob routes
+export { createBlobRoutes } from './blobs';
+// Console API and live gateway. Console UI mounting lives in ./console/ui and
+// intentionally is not re-exported here because it requires @syncular/console.
+export * from './console/gateway';
+export * from './console/routes';
+export * from './console/schemas';
+export * from './console/types';
+// Simplified server factory
+export { createSyncServer, } from './create-server';
+// OpenAPI utilities
+export * from './openapi';
+// Proxy
+export * from './proxy';
+// Rate limiting
+export * from './rate-limit';
+// Realtime binary sync-pack helpers
+export * from './realtime-sync-packs';
+// Route types and factory
+export { createSyncRoutes, getSyncRealtimeUnsubscribe, getSyncWebSocketConnectionManager, normalizeSyncCorsConfig, } from './routes';
+// WebSocket helpers for realtime sync
+export * from './ws';
+//# sourceMappingURL=index.js.map

package/dist/hono/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/hono/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,eAAe;AACf,cAAc,gBAAgB,CAAC;AAE/B,cAAc;AACd,OAAO,EAAgC,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAEzE,8EAA8E;AAC9E,+EAA+E;AAC/E,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAEhC,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,oCAAoC;AACpC,cAAc,uBAAuB,CAAC;AAEtC,0BAA0B;AAC1B,OAAO,EAEL,gBAAgB,EAChB,0BAA0B,EAC1B,iCAAiC,EAEjC,uBAAuB,GAIxB,MAAM,UAAU,CAAC;AAElB,sCAAsC;AACtC,cAAc,MAAM,CAAC"}

package/dist/hono/openapi.d.ts

@@ -0,0 +1,72 @@
+/**
+ * @syncular/server/hono - OpenAPI Spec Export
+ *
+ * Provides utilities for generating and serving OpenAPI specifications.
+ */
+import { type Handler, Hono } from 'hono';
+export interface OpenAPIConfig {
+    title?: string;
+    version?: string;
+    description?: string;
+    servers?: Array<{
+        url: string;
+        description?: string;
+    }>;
+}
+export interface ScalarReferenceConfig {
+    url?: string;
+    cdn?: string;
+}
+export interface OpenAPIDocsRoutesConfig extends OpenAPIConfig {
+    openAPIPath?: string;
+    scalarPath?: string;
+    scalar?: ScalarReferenceConfig;
+}
+/**
+ * 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>;
+/**
+ * Create a Scalar API reference handler that points at an OpenAPI document.
+ */
+export declare function createScalarReferenceHandler(config?: ScalarReferenceConfig): Handler;
+/**
+ * Create a small Hono app that serves both `/openapi.json` and `/spec`.
+ *
+ * @example
+ * ```typescript
+ * import { Hono } from 'hono';
+ * import { createOpenAPIDocsRoutes } from '@syncular/server/hono';
+ *
+ * const app = new Hono();
+ * app.route('/', createOpenAPIDocsRoutes(app, {
+ *   title: 'Syncular API',
+ * }));
+ * ```
+ */
+export declare function createOpenAPIDocsRoutes(app: Hono, config?: OpenAPIDocsRoutesConfig): Hono<import("hono/types").BlankEnv, import("hono/types").BlankSchema, "/">;
+/**
+ * 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>;
+//# sourceMappingURL=openapi.d.ts.map

package/dist/hono/openapi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi.d.ts","sourceRoot":"","sources":["../../src/hono/openapi.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,KAAK,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAM1C,MAAM,WAAW,aAAa;IAC5B,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,MAAM,WAAW,qBAAqB;IACpC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,uBAAwB,SAAQ,aAAa;IAC5D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,qBAAqB,CAAC;CAChC;AAMD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,IAAI,EAAE,MAAM,GAAE,aAAkB,yGAazE;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAC1C,MAAM,GAAE,qBAA0B,GACjC,OAAO,CAKT;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,IAAI,EACT,MAAM,GAAE,uBAA4B,8EAgBrC;AAED;;;GAGG;AACH,wBAAsB,uBAAuB,CAC3C,GAAG,EAAE,IAAI,EACT,MAAM,GAAE,aAAkB,GACzB,OAAO,CAAC,OAAO,CAAC,CAalB"}

package/dist/hono/openapi.js

@@ -0,0 +1,99 @@
+/**
+ * @syncular/server/hono - OpenAPI Spec Export
+ *
+ * Provides utilities for generating and serving OpenAPI specifications.
+ */
+import { Scalar } from '@scalar/hono-api-reference';
+import { Hono } from 'hono';
+import { generateSpecs, openAPIRouteHandler } from 'hono-openapi';
+const DEFAULT_SCALAR_CDN = 'https://cdn.jsdelivr.net/npm/@scalar/api-reference@latest';
+function normalizeRoutePath(path) {
+    return path.startsWith('/') ? path : `/${path}`;
+}
+/**
+ * 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,
+        },
+    });
+}
+/**
+ * Create a Scalar API reference handler that points at an OpenAPI document.
+ */
+export function createScalarReferenceHandler(config = {}) {
+    return Scalar({
+        url: config.url ?? '/openapi.json',
+        cdn: config.cdn ?? DEFAULT_SCALAR_CDN,
+    });
+}
+/**
+ * Create a small Hono app that serves both `/openapi.json` and `/spec`.
+ *
+ * @example
+ * ```typescript
+ * import { Hono } from 'hono';
+ * import { createOpenAPIDocsRoutes } from '@syncular/server/hono';
+ *
+ * const app = new Hono();
+ * app.route('/', createOpenAPIDocsRoutes(app, {
+ *   title: 'Syncular API',
+ * }));
+ * ```
+ */
+export function createOpenAPIDocsRoutes(app, config = {}) {
+    const docsApp = new Hono();
+    const openAPIPath = normalizeRoutePath(config.openAPIPath ?? '/openapi.json');
+    const scalarPath = normalizeRoutePath(config.scalarPath ?? '/spec');
+    docsApp.get(openAPIPath, createOpenAPIHandler(app, config));
+    docsApp.get(scalarPath, createScalarReferenceHandler({
+        url: config.scalar?.url ?? openAPIPath,
+        cdn: config.scalar?.cdn,
+    }));
+    return docsApp;
+}
+/**
+ * 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/hono/openapi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi.js","sourceRoot":"","sources":["../../src/hono/openapi.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AACpD,OAAO,EAAgB,IAAI,EAAE,MAAM,MAAM,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAElE,MAAM,kBAAkB,GACtB,2DAA2D,CAAC;AAoB9D,SAAS,kBAAkB,CAAC,IAAY;IACtC,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC;AAClD,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,oBAAoB,CAAC,GAAS,EAAE,MAAM,GAAkB,EAAE;IACxE,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;AACL,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,4BAA4B,CAC1C,MAAM,GAA0B,EAAE;IAElC,OAAO,MAAM,CAAC;QACZ,GAAG,EAAE,MAAM,CAAC,GAAG,IAAI,eAAe;QAClC,GAAG,EAAE,MAAM,CAAC,GAAG,IAAI,kBAAkB;KACtC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,uBAAuB,CACrC,GAAS,EACT,MAAM,GAA4B,EAAE;IAEpC,MAAM,OAAO,GAAG,IAAI,IAAI,EAAE,CAAC;IAC3B,MAAM,WAAW,GAAG,kBAAkB,CAAC,MAAM,CAAC,WAAW,IAAI,eAAe,CAAC,CAAC;IAC9E,MAAM,UAAU,GAAG,kBAAkB,CAAC,MAAM,CAAC,UAAU,IAAI,OAAO,CAAC,CAAC;IAEpE,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,oBAAoB,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC;IAC5D,OAAO,CAAC,GAAG,CACT,UAAU,EACV,4BAA4B,CAAC;QAC3B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,IAAI,WAAW;QACtC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG;KACxB,CAAC,CACH,CAAC;IAEF,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,GAAS,EACT,MAAM,GAAkB,EAAE;IAE1B,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;AACL,CAAC"}

package/dist/hono/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 { 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> {
+    /** Database connection */
+    db: Kysely<DB>;
+    /** Server sync dialect */
+    dialect: ServerSyncDialect;
+    /** Proxy table handlers for oplog generation */
+    handlers: ProxyHandlerCollection;
+    /** 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/hono/proxy/connection-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection-manager.d.ts","sourceRoot":"","sources":["../../../src/hono/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/hono/proxy/connection-manager.js

@@ -0,0 +1,251 @@
+/**
+ * @syncular/server/hono - Proxy Connection Manager
+ *
+ * Manages WebSocket connections for the proxy.
+ */
+import { executeProxyQuery } from '@syncular/server';
+/**
+ * Manages proxy WebSocket connections and their state.
+ */
+export class ProxyConnectionManager {
+    connections = new Map();
+    config;
+    idleTimeoutMs;
+    maxConnections;
+    constructor(config) {
+        this.config = config;
+        this.idleTimeoutMs = config.idleTimeoutMs ?? 30000;
+        this.maxConnections = config.maxConnections ?? 100;
+    }
+    /**
+     * Check if a new connection can be accepted.
+     */
+    canAccept() {
+        return this.connections.size < this.maxConnections;
+    }
+    /**
+     * Get the current connection count.
+     */
+    getConnectionCount() {
+        return this.connections.size;
+    }
+    /**
+     * Handle the handshake message and register the connection.
+     */
+    register(ws, handshake) {
+        const state = {
+            ws,
+            actorId: handshake.actorId,
+            clientId: handshake.clientId,
+            transaction: null,
+            lastActivity: Date.now(),
+            idleTimer: null,
+        };
+        this.connections.set(ws, state);
+        this.resetIdleTimer(state);
+        return state;
+    }
+    /**
+     * Get the connection state for a WebSocket.
+     */
+    get(ws) {
+        return this.connections.get(ws);
+    }
+    /**
+     * Unregister and cleanup a connection.
+     */
+    async unregister(ws) {
+        const state = this.connections.get(ws);
+        if (!state)
+            return;
+        // Clear idle timer
+        if (state.idleTimer) {
+            clearTimeout(state.idleTimer);
+        }
+        // Rollback any pending transaction by rejecting the promise
+        if (state.transaction) {
+            const rejectTransaction = state.__rejectTransaction;
+            if (rejectTransaction) {
+                rejectTransaction(new Error('Connection closed'));
+            }
+            state.transaction = null;
+            state.__resolveTransaction = undefined;
+            state.__rejectTransaction = undefined;
+        }
+        this.connections.delete(ws);
+    }
+    /**
+     * Handle a proxy message and return the response.
+     */
+    async handleMessage(ws, message) {
+        const state = this.connections.get(ws);
+        if (!state) {
+            return {
+                id: message.id,
+                type: 'error',
+                error: 'Connection not registered',
+            };
+        }
+        // Update activity and reset idle timer
+        state.lastActivity = Date.now();
+        this.resetIdleTimer(state);
+        try {
+            switch (message.type) {
+                case 'begin':
+                    return await this.handleBegin(state, message);
+                case 'commit':
+                    return await this.handleCommit(state, message);
+                case 'rollback':
+                    return await this.handleRollback(state, message);
+                case 'query':
+                    return await this.handleQuery(state, message);
+                default:
+                    return {
+                        id: message.id,
+                        type: 'error',
+                        error: `Unknown message type: ${message.type}`,
+                    };
+            }
+        }
+        catch (err) {
+            return {
+                id: message.id,
+                type: 'error',
+                error: err instanceof Error ? err.message : 'Unknown error',
+            };
+        }
+    }
+    async handleBegin(state, message) {
+        if (state.transaction) {
+            return {
+                id: message.id,
+                type: 'error',
+                error: 'Transaction already in progress',
+            };
+        }
+        // Start a transaction and keep it open
+        // We use a workaround since Kysely doesn't expose raw transaction control
+        return new Promise((resolve) => {
+            this.config.db
+                .transaction()
+                .execute(async (trx) => {
+                state.transaction = trx;
+                // Wait for commit or rollback
+                return new Promise((resolveTransaction, rejectTransaction) => {
+                    state.__resolveTransaction = resolveTransaction;
+                    state.__rejectTransaction = rejectTransaction;
+                    resolve({
+                        id: message.id,
+                        type: 'result',
+                    });
+                });
+            })
+                .catch(() => {
+                // Transaction was rolled back externally
+            });
+        });
+    }
+    async handleCommit(state, message) {
+        if (!state.transaction) {
+            return {
+                id: message.id,
+                type: 'error',
+                error: 'No transaction in progress',
+            };
+        }
+        // Resolve the transaction promise to commit
+        const resolveTransaction = state.__resolveTransaction;
+        if (resolveTransaction) {
+            resolveTransaction();
+        }
+        state.transaction = null;
+        state.__resolveTransaction = undefined;
+        state.__rejectTransaction = undefined;
+        return {
+            id: message.id,
+            type: 'result',
+        };
+    }
+    async handleRollback(state, message) {
+        if (!state.transaction) {
+            return {
+                id: message.id,
+                type: 'error',
+                error: 'No transaction in progress',
+            };
+        }
+        // Reject the transaction promise to trigger rollback
+        const rejectTransaction = state.__rejectTransaction;
+        if (rejectTransaction) {
+            rejectTransaction(new Error('Transaction rolled back'));
+        }
+        state.transaction = null;
+        state.__resolveTransaction = undefined;
+        state.__rejectTransaction = undefined;
+        return {
+            id: message.id,
+            type: 'result',
+        };
+    }
+    async handleQuery(state, message) {
+        if (!message.sql) {
+            return {
+                id: message.id,
+                type: 'error',
+                error: 'Missing SQL query',
+            };
+        }
+        const db = state.transaction ?? this.config.db;
+        const result = await executeProxyQuery({
+            db,
+            dialect: this.config.dialect,
+            handlers: this.config.handlers,
+            ctx: {
+                actorId: state.actorId,
+                clientId: state.clientId,
+            },
+            sqlQuery: message.sql,
+            parameters: message.parameters ?? [],
+        });
+        return {
+            id: message.id,
+            type: 'result',
+            rows: result.rows,
+            rowCount: result.rowCount,
+        };
+    }
+    resetIdleTimer(state) {
+        if (state.idleTimer) {
+            clearTimeout(state.idleTimer);
+        }
+        if (this.idleTimeoutMs <= 0)
+            return;
+        state.idleTimer = setTimeout(() => {
+            // Close idle connection
+            try {
+                state.ws.close(4000, 'Idle timeout');
+            }
+            catch {
+                // Ignore close errors
+            }
+            this.unregister(state.ws);
+        }, this.idleTimeoutMs);
+    }
+    /**
+     * Close all connections.
+     */
+    async closeAll() {
+        const promises = [];
+        for (const [ws] of this.connections) {
+            try {
+                ws.close(1000, 'Server shutdown');
+            }
+            catch {
+                // Ignore close errors
+            }
+            promises.push(this.unregister(ws));
+        }
+        await Promise.all(promises);
+    }
+}
+//# sourceMappingURL=connection-manager.js.map

package/dist/hono/proxy/connection-manager.js.map

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

package/dist/hono/proxy/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @syncular/server/hono - Proxy Exports
+ *
+ * WebSocket endpoint for admin database proxy.
+ */
+export * from './connection-manager';
+export * from './routes';
+//# sourceMappingURL=index.d.ts.map

package/dist/hono/proxy/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hono/proxy/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,sBAAsB,CAAC;AACrC,cAAc,UAAU,CAAC"}

package/dist/hono/proxy/index.js

@@ -0,0 +1,8 @@
+/**
+ * @syncular/server/hono - Proxy Exports
+ *
+ * WebSocket endpoint for admin database proxy.
+ */
+export * from './connection-manager';
+export * from './routes';
+//# sourceMappingURL=index.js.map

package/dist/hono/proxy/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/hono/proxy/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,sBAAsB,CAAC;AACrC,cAAc,UAAU,CAAC"}