@syncular/server-hono 0.0.6-96 → 0.2.1

package/dist/proxy/index.js

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

package/dist/proxy/index.js.map

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

package/dist/proxy/routes.d.ts

@@ -1,74 +0,0 @@
-/**
- * @syncular/server-hono - Proxy Routes
- *
- * WebSocket endpoint for database proxy.
- */
-import type { ProxyHandshake, ProxyMessage, ProxyResponse } from '@syncular/core';
-import type { ProxyHandlerCollection, ServerSyncDialect, SyncCoreDb } from '@syncular/server';
-import type { Context } from 'hono';
-import { Hono } from 'hono';
-import type { UpgradeWebSocket, WSContext } from 'hono/ws';
-import type { Kysely } from 'kysely';
-/**
- * WeakMap for storing proxy connection manager per Hono instance.
- */
-interface ProxyConnectionManagerHandle {
-    canAccept(): boolean;
-    getConnectionCount(): number;
-    register(ws: WSContext, handshake: ProxyHandshake): unknown;
-    handleMessage(ws: WSContext, message: ProxyMessage): Promise<ProxyResponse>;
-    unregister(ws: WSContext): Promise<void>;
-}
-interface ProxyAuthResult {
-    /** Actor ID for oplog tracking */
-    actorId: string;
-}
-interface CreateProxyRoutesConfig<DB extends SyncCoreDb = SyncCoreDb> {
-    /** Database connection */
-    db: Kysely<DB>;
-    /** Server sync dialect */
-    dialect: ServerSyncDialect;
-    /** 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 */
-    upgradeWebSocket: UpgradeWebSocket;
-    /** Maximum concurrent connections (default: 100) */
-    maxConnections?: number;
-    /** Idle connection timeout in ms (default: 30000) */
-    idleTimeoutMs?: number;
-}
-/**
- * Create Hono routes for the proxy WebSocket endpoint.
- *
- * @example
- * ```typescript
- * import { Hono } from 'hono';
- * import { createBunWebSocket } from 'hono/bun';
- * import { createProxyRoutes } from '@syncular/server-hono/proxy';
- *
- * const { upgradeWebSocket, websocket } = createBunWebSocket();
- *
- * const app = new Hono();
- *
- * app.route('/proxy', createProxyRoutes({
- *   db,
- *   handlers: proxyHandlers,
- *   authenticate: async (c) => {
- *     // Verify admin auth
- *     return { actorId: 'admin:123' };
- *   },
- *   upgradeWebSocket,
- * }));
- *
- * export default { fetch: app.fetch, websocket };
- * ```
- */
-export declare function createProxyRoutes<DB extends SyncCoreDb>(config: CreateProxyRoutesConfig<DB>): Hono;
-/**
- * Get the ProxyConnectionManager from a proxy routes instance.
- */
-export declare function getProxyConnectionManager(routes: Hono): ProxyConnectionManagerHandle | undefined;
-export {};
-//# sourceMappingURL=routes.d.ts.map

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

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

@@ -1,147 +0,0 @@
-/**
- * @syncular/server-hono - Proxy Routes
- *
- * WebSocket endpoint for database proxy.
- */
-import { logSyncEvent } from '@syncular/core';
-import { Hono } from 'hono';
-import { ProxyConnectionManager } from './connection-manager.js';
-const proxyConnectionManagerMap = new WeakMap();
-/**
- * Create Hono routes for the proxy WebSocket endpoint.
- *
- * @example
- * ```typescript
- * import { Hono } from 'hono';
- * import { createBunWebSocket } from 'hono/bun';
- * import { createProxyRoutes } from '@syncular/server-hono/proxy';
- *
- * const { upgradeWebSocket, websocket } = createBunWebSocket();
- *
- * const app = new Hono();
- *
- * app.route('/proxy', createProxyRoutes({
- *   db,
- *   handlers: proxyHandlers,
- *   authenticate: async (c) => {
- *     // Verify admin auth
- *     return { actorId: 'admin:123' };
- *   },
- *   upgradeWebSocket,
- * }));
- *
- * export default { fetch: app.fetch, websocket };
- * ```
- */
-export function createProxyRoutes(config) {
-    const app = new Hono();
-    const manager = new ProxyConnectionManager({
-        db: config.db,
-        dialect: config.dialect,
-        handlers: config.handlers,
-        maxConnections: config.maxConnections,
-        idleTimeoutMs: config.idleTimeoutMs,
-    });
-    // Store manager for external access if needed
-    proxyConnectionManagerMap.set(app, manager);
-    // WebSocket upgrade endpoint - using regular route since WebSocket doesn't fit OpenAPI well
-    app.get('/', async (c) => {
-        // Authenticate before upgrade
-        const auth = await config.authenticate(c);
-        if (!auth) {
-            return c.json({ error: 'UNAUTHENTICATED' }, 401);
-        }
-        // Check connection limit
-        if (!manager.canAccept()) {
-            logSyncEvent({
-                event: 'proxy.rejected',
-                userId: auth.actorId,
-                reason: 'max_connections',
-            });
-            return c.json({ error: 'PROXY_CONNECTION_LIMIT' }, 429);
-        }
-        logSyncEvent({
-            event: 'proxy.connect',
-            userId: auth.actorId,
-        });
-        return config.upgradeWebSocket(c, {
-            onOpen(_evt, _ws) {
-                // Connection opened, wait for handshake message
-            },
-            async onMessage(evt, ws) {
-                try {
-                    const data = typeof evt.data === 'string'
-                        ? evt.data
-                        : new TextDecoder().decode(evt.data);
-                    const message = JSON.parse(data);
-                    // Handle handshake
-                    if (message.type === 'handshake') {
-                        const handshake = message;
-                        // Validate that the handshake actor matches authenticated actor
-                        if (handshake.actorId !== auth.actorId) {
-                            const ack = {
-                                type: 'handshake_ack',
-                                ok: false,
-                                error: 'Actor ID mismatch',
-                            };
-                            ws.send(JSON.stringify(ack));
-                            ws.close(4001, 'Unauthorized');
-                            return;
-                        }
-                        manager.register(ws, handshake);
-                        const ack = {
-                            type: 'handshake_ack',
-                            ok: true,
-                        };
-                        ws.send(JSON.stringify(ack));
-                        return;
-                    }
-                    // Handle proxy messages
-                    const proxyMessage = message;
-                    const response = await manager.handleMessage(ws, proxyMessage);
-                    ws.send(JSON.stringify(response));
-                }
-                catch (err) {
-                    // Send error response if we can parse the message ID
-                    try {
-                        const parsed = JSON.parse(typeof evt.data === 'string'
-                            ? evt.data
-                            : new TextDecoder().decode(evt.data));
-                        if (parsed.id) {
-                            ws.send(JSON.stringify({
-                                id: parsed.id,
-                                type: 'error',
-                                error: err instanceof Error ? err.message : 'Unknown error',
-                            }));
-                        }
-                    }
-                    catch {
-                        // Ignore parse errors
-                    }
-                }
-            },
-            async onClose(_evt, ws) {
-                await manager.unregister(ws);
-                logSyncEvent({
-                    event: 'proxy.disconnect',
-                    userId: auth.actorId,
-                });
-            },
-            async onError(_evt, ws) {
-                await manager.unregister(ws);
-                logSyncEvent({
-                    event: 'proxy.error',
-                    userId: auth.actorId,
-                });
-            },
-        });
-    });
-    return app;
-}
-/**
- * Get the ProxyConnectionManager from a proxy routes instance.
- */
-export function getProxyConnectionManager(routes) {
-    return proxyConnectionManagerMap.get(routes);
-}
-//# sourceMappingURL=routes.js.map

package/dist/proxy/routes.js.map

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

package/dist/rate-limit.d.ts

@@ -1,101 +0,0 @@
-/**
- * @syncular/server-hono - Rate limiting middleware for sync endpoints
- *
- * Provides per-user rate limiting to prevent DoS attacks and excessive
- * server load from misbehaving clients.
- */
-import type { Context, MiddlewareHandler } from 'hono';
-/**
- * Rate limit configuration
- */
-export interface RateLimitConfig {
-    /**
-     * Maximum requests per window (default: 60)
-     */
-    maxRequests: number;
-    /**
-     * Time window in milliseconds (default: 60000 = 1 minute)
-     */
-    windowMs: number;
-    /**
-     * Function to extract the rate limit key from a request.
-     * Typically returns userId, deviceId, or IP address.
-     * Return null to skip rate limiting for this request.
-     */
-    keyGenerator: (c: Context) => string | null | Promise<string | null>;
-    /**
-     * Whether to include rate limit headers in responses (default: true)
-     */
-    includeHeaders?: boolean;
-    /**
-     * Custom handler for rate-limited requests (optional)
-     * If not provided, returns a 429 JSON response
-     */
-    onRateLimited?: (c: Context, retryAfterMs: number) => Response | Promise<Response>;
-    /**
-     * Whether to skip rate limiting in test environments (default: false)
-     */
-    skipInTest?: boolean;
-}
-/**
- * Reset the global store (for testing)
- */
-export declare function resetRateLimitStore(): void;
-/**
- * Create a rate limiting middleware for Hono.
- *
- * @example
- * ```typescript
- * import { createRateLimiter } from '@syncular/server-hono';
- *
- * const rateLimiter = createRateLimiter({
- *   maxRequests: 60,
- *   windowMs: 60_000,
- *   keyGenerator: async (c) => {
- *     const auth = await authenticate(c);
- *     return auth?.userId ?? null;
- *   },
- * });
- *
- * app.use('/sync/*', rateLimiter);
- * ```
- */
-export declare function createRateLimiter(config: Partial<RateLimitConfig> & Pick<RateLimitConfig, 'keyGenerator'>): MiddlewareHandler;
-/**
- * Create a rate limiter that uses userId from auth context.
- *
- * This is a convenience function for the common case of rate limiting
- * by authenticated user.
- *
- * @example
- * ```typescript
- * const syncRoutes = createSyncRoutes({
- *   db,
- *   handlers: [tasksHandler],
- *   authenticate,
- *   sync: {
- *     rateLimit: {
- *       pull: { maxRequests: 120, windowMs: 60_000 },
- *       push: { maxRequests: 60, windowMs: 60_000 },
- *     },
- *   },
- * });
- * ```
- */
-export interface SyncRateLimitConfig {
-    /**
-     * Rate limit config for pull requests.
-     * Set to false to disable rate limiting for pulls.
-     */
-    pull?: Omit<RateLimitConfig, 'keyGenerator'> | false;
-    /**
-     * Rate limit config for push requests.
-     * Set to false to disable rate limiting for pushes.
-     */
-    push?: Omit<RateLimitConfig, 'keyGenerator'> | false;
-}
-/**
- * Default sync rate limit configuration
- */
-export declare const DEFAULT_SYNC_RATE_LIMITS: SyncRateLimitConfig;
-//# sourceMappingURL=rate-limit.d.ts.map

package/dist/rate-limit.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"rate-limit.d.ts","sourceRoot":"","sources":["../src/rate-limit.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,MAAM,CAAC;AAEvD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;;;OAIG;IACH,YAAY,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAErE;;OAEG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB;;;OAGG;IACH,aAAa,CAAC,EAAE,CACd,CAAC,EAAE,OAAO,EACV,YAAY,EAAE,MAAM,KACjB,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAElC;;OAEG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAwHD;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAK1C;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,IAAI,CAAC,eAAe,EAAE,cAAc,CAAC,GACvE,iBAAiB,CAqEnB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,IAAI,CAAC,EAAE,IAAI,CAAC,eAAe,EAAE,cAAc,CAAC,GAAG,KAAK,CAAC;IAErD;;;OAGG;IACH,IAAI,CAAC,EAAE,IAAI,CAAC,eAAe,EAAE,cAAc,CAAC,GAAG,KAAK,CAAC;CACtD;AAED;;GAEG;AACH,eAAO,MAAM,wBAAwB,EAAE,mBAWtC,CAAC"}

package/dist/rate-limit.js

@@ -1,186 +0,0 @@
-/**
- * @syncular/server-hono - Rate limiting middleware for sync endpoints
- *
- * Provides per-user rate limiting to prevent DoS attacks and excessive
- * server load from misbehaving clients.
- */
-import { logSyncEvent } from '@syncular/core';
-/**
- * Default rate limit configuration
- */
-const DEFAULT_RATE_LIMIT_CONFIG = {
-    maxRequests: 60,
-    windowMs: 60_000,
-    includeHeaders: true,
-    skipInTest: false,
-};
-/**
- * In-memory rate limiter store
- *
- * Note: This is suitable for single-instance deployments.
- * For distributed deployments, use Redis or similar.
- */
-class RateLimitStore {
-    windowMs;
-    entries = new Map();
-    cleanupInterval = null;
-    constructor(windowMs) {
-        this.windowMs = windowMs;
-        // Clean up expired entries periodically
-        this.cleanupInterval = setInterval(() => this.cleanup(), Math.max(windowMs, 60_000));
-    }
-    /**
-     * Check and increment the rate limit counter for a key.
-     *
-     * @param key - Rate limit key (e.g., userId)
-     * @param maxRequests - Maximum requests allowed
-     * @returns Rate limit check result
-     */
-    check(key, maxRequests) {
-        const now = Date.now();
-        let entry = this.entries.get(key);
-        // Check if window has expired
-        if (!entry || now - entry.windowStart >= this.windowMs) {
-            entry = { count: 0, windowStart: now };
-            this.entries.set(key, entry);
-        }
-        const resetAt = entry.windowStart + this.windowMs;
-        const allowed = entry.count < maxRequests;
-        if (allowed) {
-            entry.count++;
-        }
-        return {
-            allowed,
-            current: entry.count,
-            remaining: Math.max(0, maxRequests - entry.count),
-            resetAt,
-        };
-    }
-    /**
-     * Clean up expired entries
-     */
-    cleanup() {
-        const now = Date.now();
-        for (const [key, entry] of this.entries) {
-            if (now - entry.windowStart >= this.windowMs) {
-                this.entries.delete(key);
-            }
-        }
-    }
-    /**
-     * Stop the cleanup interval
-     */
-    stop() {
-        if (this.cleanupInterval) {
-            clearInterval(this.cleanupInterval);
-            this.cleanupInterval = null;
-        }
-    }
-    /**
-     * Clear all entries (for testing)
-     */
-    clear() {
-        this.entries.clear();
-    }
-    /**
-     * Get current entry count (for monitoring)
-     */
-    get size() {
-        return this.entries.size;
-    }
-}
-// Track created stores so tests can reset state deterministically.
-const activeStores = new Set();
-/**
- * Reset the global store (for testing)
- */
-export function resetRateLimitStore() {
-    for (const store of activeStores) {
-        store.stop();
-    }
-    activeStores.clear();
-}
-/**
- * Create a rate limiting middleware for Hono.
- *
- * @example
- * ```typescript
- * import { createRateLimiter } from '@syncular/server-hono';
- *
- * const rateLimiter = createRateLimiter({
- *   maxRequests: 60,
- *   windowMs: 60_000,
- *   keyGenerator: async (c) => {
- *     const auth = await authenticate(c);
- *     return auth?.userId ?? null;
- *   },
- * });
- *
- * app.use('/sync/*', rateLimiter);
- * ```
- */
-export function createRateLimiter(config) {
-    const { maxRequests = DEFAULT_RATE_LIMIT_CONFIG.maxRequests, windowMs = DEFAULT_RATE_LIMIT_CONFIG.windowMs, keyGenerator, includeHeaders = DEFAULT_RATE_LIMIT_CONFIG.includeHeaders, onRateLimited, skipInTest = DEFAULT_RATE_LIMIT_CONFIG.skipInTest, } = config;
-    const store = new RateLimitStore(windowMs);
-    activeStores.add(store);
-    return async (c, next) => {
-        // Skip in test environment if configured
-        if (skipInTest && process.env.NODE_ENV === 'test') {
-            return next();
-        }
-        // Get the rate limit key
-        const key = await keyGenerator(c);
-        if (key === null) {
-            // Skip rate limiting for this request
-            return next();
-        }
-        const result = store.check(key, maxRequests);
-        // Add rate limit headers if configured
-        if (includeHeaders) {
-            c.header('X-RateLimit-Limit', String(maxRequests));
-            c.header('X-RateLimit-Remaining', String(result.remaining));
-            c.header('X-RateLimit-Reset', String(Math.ceil(result.resetAt / 1000)));
-        }
-        if (!result.allowed) {
-            const retryAfterMs = result.resetAt - Date.now();
-            const retryAfterSec = Math.ceil(retryAfterMs / 1000);
-            // Log rate limit event
-            logSyncEvent({
-                event: 'sync.rate_limit',
-                key,
-                current: result.current,
-                maxRequests,
-                retryAfterMs,
-            });
-            // Add Retry-After header
-            c.header('Retry-After', String(retryAfterSec));
-            // Use custom handler or default response
-            if (onRateLimited) {
-                return onRateLimited(c, retryAfterMs);
-            }
-            return c.json({
-                error: 'RATE_LIMITED',
-                message: 'Too many requests. Please try again later.',
-                retryAfterMs,
-                retryAfterSec,
-            }, 429);
-        }
-        return next();
-    };
-}
-/**
- * Default sync rate limit configuration
- */
-export const DEFAULT_SYNC_RATE_LIMITS = {
-    pull: {
-        maxRequests: 120, // 2 requests per second average
-        windowMs: 60_000,
-        includeHeaders: true,
-    },
-    push: {
-        maxRequests: 60, // 1 request per second average
-        windowMs: 60_000,
-        includeHeaders: true,
-    },
-};
-//# sourceMappingURL=rate-limit.js.map

package/dist/rate-limit.js.map

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