@syncular/server-hono 0.0.1-60

package/dist/console/index.js

@@ -0,0 +1,7 @@
+/**
+ * @syncular/server-hono - Console API
+ *
+ * Provides monitoring and operations endpoints for the @syncular dashboard.
+ */
+export { createConsoleEventEmitter, createConsoleRoutes, createTokenAuthenticator, } from './routes';
+//# sourceMappingURL=index.js.map

package/dist/console/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/console/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH,OAAO,EACL,yBAAyB,EACzB,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,UAAU,CAAC"}

package/dist/console/routes.d.ts

@@ -0,0 +1,106 @@
+/**
+ * @syncular/server-hono - Console API routes
+ *
+ * Provides monitoring and operations endpoints for the @syncular dashboard.
+ *
+ * Endpoints:
+ * - GET  /stats           - Sync statistics
+ * - GET  /commits         - Paginated commit list
+ * - GET  /commits/:seq    - Single commit with changes
+ * - GET  /clients         - Client cursor list
+ * - GET  /handlers        - Registered handlers
+ * - POST /prune           - Trigger pruning
+ * - POST /prune/preview   - Preview pruning (dry run)
+ * - POST /compact         - Trigger compaction
+ * - DELETE /clients/:id   - Evict client
+ */
+import type { ServerSyncDialect, ServerTableHandler, SyncCoreDb } from '@syncular/server';
+import type { Context } from 'hono';
+import { Hono } 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;
+}
+/**
+ * Create a simple console event emitter for broadcasting live events.
+ */
+export declare function createConsoleEventEmitter(): ConsoleEventEmitter;
+export interface CreateConsoleRoutesOptions<DB extends SyncCoreDb = SyncCoreDb> {
+    db: Kysely<DB>;
+    dialect: ServerSyncDialect;
+    handlers: ServerTableHandler<DB>[];
+    /**
+     * Authentication function for console requests.
+     * Return null to reject the request.
+     */
+    authenticate: (c: Context) => Promise<ConsoleAuthResult | null>;
+    /**
+     * 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[] | '*';
+    /**
+     * 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;
+    };
+}
+export declare function createConsoleRoutes<DB extends SyncCoreDb>(options: CreateConsoleRoutesOptions<DB>): Hono;
+/**
+ * Creates a simple token-based authenticator for local development.
+ * The token can be set via SYNC_CONSOLE_TOKEN env var or passed directly.
+ */
+export declare function createTokenAuthenticator(token?: string): (c: Context) => Promise<ConsoleAuthResult | null>;
+//# sourceMappingURL=routes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../src/console/routes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,UAAU,EACX,MAAM,kBAAkB,CAAC;AAO1B,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACpC,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAE5B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAEhD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAErC,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,OAAO,CAAC;AACxD,OAAO,EAuCL,KAAK,SAAS,EAOf,MAAM,WAAW,CAAC;AAEnB,MAAM,WAAW,iBAAiB;IAChC,2DAA2D;IAC3D,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;AAE9D;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,qCAAqC;IACrC,WAAW,CAAC,QAAQ,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAClD,wBAAwB;IACxB,cAAc,CAAC,QAAQ,EAAE,oBAAoB,GAAG,IAAI,CAAC;IACrD,qCAAqC;IACrC,IAAI,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,CAAC;CAC9B;AAED;;GAEG;AACH,wBAAgB,yBAAyB,IAAI,mBAAmB,CAoB/D;AAED,MAAM,WAAW,0BAA0B,CACzC,EAAE,SAAS,UAAU,GAAG,UAAU;IAElC,EAAE,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;IACf,OAAO,EAAE,iBAAiB,CAAC;IAC3B,QAAQ,EAAE,kBAAkB,CAAC,EAAE,CAAC,EAAE,CAAC;IACnC;;;OAGG;IACH,YAAY,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAC;IAChE;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC;IAC7B;;OAEG;IACH,OAAO,CAAC,EAAE;QACR,gBAAgB,CAAC,EAAE,MAAM,CAAC;KAC3B,CAAC;IACF;;OAEG;IACH,KAAK,CAAC,EAAE;QACN,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;KAC5B,CAAC;IACF;;;OAGG;IACH,YAAY,CAAC,EAAE,mBAAmB,CAAC;IACnC;;;OAGG;IACH,mBAAmB,CAAC,EAAE,0BAA0B,CAAC;IACjD;;OAEG;IACH,SAAS,CAAC,EAAE;QACV,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB;;WAEG;QACH,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;QACpC;;WAEG;QACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;KAC9B,CAAC;CACH;AAwED,wBAAgB,mBAAmB,CAAC,EAAE,SAAS,UAAU,EACvD,OAAO,EAAE,0BAA0B,CAAC,EAAE,CAAC,GACtC,IAAI,CAyyDN;AA6BD;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,CAAC,EAAE,MAAM,GACb,CAAC,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CA0BnD"}