@rdlabo/workers-hono-kit 0.7.2 → 0.8.0

package/README.md

@@ -85,7 +85,6 @@ npm install ai ai-gateway-provider    # createAiGatewayProvider
 | `DeferExecutor` / `defaultDefer` / `createWaitUntilDefer(ctx)` | Fire-and-forget executor for Workers: `defaultDefer` swallows rejections (tests); `createWaitUntilDefer` registers work via `ctx.waitUntil`. |
 | `configureHibernationAutoResponse` / `upgradeHibernationWebSocket` / `broadcastHibernationWebSockets` | Hibernation WebSocket room primitives: runtime ping/pong without waking JavaScript, attachment-before-accept upgrade, and broadcast through sockets restored by `getWebSockets()`. |
 | `acknowledgeHibernationWebSocketClose` / `closeHibernationWebSocket` | Safe close helpers, including normalization of reserved received-only close codes. |
-| `createLegacySseBridge(options)` | Migration adapter from legacy SSE clients to one or more Hibernation WebSocket rooms. Downstream cancellation aborts pending upgrades and closes late-arriving sockets. |
 | `retryDurableObjectOperation(operation, options?)` / `isRetryableDurableObjectError(error)` | Retry idempotent DO work only for `retryable && !overloaded`, with jittered exponential backoff. `operation` runs per attempt so callers create a fresh stub after an exception. |
 | `createAiGatewayProvider(config)` / `AiGatewayConfig` / `AiGatewayProvider` | Route `@ai-sdk` models through the Cloudflare AI Gateway, via either a Workers `AI` binding or REST credentials (`accountId` / `gateway` / `token`). |
 | `KVCache` / `KVNamespace` / `KVCacheOptions` | Workers-KV cache-aside helper (key `appName+version+table_type_column`, sha256 for string ids, TTL clamped ≥60s). Set `appName` / `version` per application. |

package/dist/index.d.ts

@@ -49,8 +49,6 @@ export { createSentryErrorReporter } from './http/http-error.js';
 export type { SentryExceptionReporterLike } from './http/http-error.js';
 export { acknowledgeHibernationWebSocketClose, broadcastHibernationWebSockets, closeHibernationWebSocket, configureHibernationAutoResponse, upgradeHibernationWebSocket, } from './realtime/hibernation.js';
 export type { HibernationAutoResponseOptions, HibernationUpgradeOptions, HibernationWebSocketLike, HibernationWebSocketStateLike, WebSocketAutoResponsePairFactory, WebSocketPairFactory, } from './realtime/hibernation.js';
-export { createLegacySseBridge } from './realtime/legacy-sse.js';
-export type { LegacySseBridgeOptions, RealtimeDurableObjectNamespaceLike } from './realtime/legacy-sse.js';
 export { isRetryableDurableObjectError, retryDurableObjectOperation } from './realtime/retry.js';
 export type { DurableObjectErrorLike, DurableObjectRetryOptions } from './realtime/retry.js';
 export { KVCache } from './cache/kv-cache.js';

package/dist/index.js

@@ -37,7 +37,6 @@ export { defaultDefer, createWaitUntilDefer } from './http/defer.js';
 export { createSentryErrorReporter } from './http/http-error.js';
 // realtime
 export { acknowledgeHibernationWebSocketClose, broadcastHibernationWebSockets, closeHibernationWebSocket, configureHibernationAutoResponse, upgradeHibernationWebSocket, } from './realtime/hibernation.js';
-export { createLegacySseBridge } from './realtime/legacy-sse.js';
 export { isRetryableDurableObjectError, retryDurableObjectOperation } from './realtime/retry.js';
 // cache
 export { KVCache } from './cache/kv-cache.js';

package/dist/realtime/index.d.ts

@@ -1,6 +1,4 @@
 export { acknowledgeHibernationWebSocketClose, broadcastHibernationWebSockets, closeHibernationWebSocket, configureHibernationAutoResponse, upgradeHibernationWebSocket, } from './hibernation.js';
 export type { HibernationAutoResponseOptions, HibernationUpgradeOptions, HibernationWebSocketLike, HibernationWebSocketStateLike, WebSocketAutoResponsePairFactory, WebSocketPairFactory, } from './hibernation.js';
-export { createLegacySseBridge } from './legacy-sse.js';
-export type { LegacySseBridgeOptions, RealtimeDurableObjectNamespaceLike } from './legacy-sse.js';
 export { isRetryableDurableObjectError, retryDurableObjectOperation } from './retry.js';
 export type { DurableObjectErrorLike, DurableObjectRetryOptions } from './retry.js';

package/dist/realtime/index.js

@@ -1,3 +1,2 @@
 export { acknowledgeHibernationWebSocketClose, broadcastHibernationWebSockets, closeHibernationWebSocket, configureHibernationAutoResponse, upgradeHibernationWebSocket, } from './hibernation.js';
-export { createLegacySseBridge } from './legacy-sse.js';
 export { isRetryableDurableObjectError, retryDurableObjectOperation } from './retry.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rdlabo/workers-hono-kit",
-  "version": "0.7.2",
+  "version": "0.8.0",
   "private": false,
   "publishConfig": {
     "access": "public"
@@ -71,7 +71,7 @@
     }
   },
   "scripts": {
-    "build": "tsc -p tsconfig.build.json",
+    "build": "node scripts/clean-dist.mjs && tsc -p tsconfig.build.json",
     "prepare": "npm run build",
     "typecheck": "tsc --noEmit",
     "test": "vitest run",

package/scripts/clean-dist.mjs

@@ -0,0 +1,3 @@
+import { rmSync } from 'node:fs';
+
+rmSync(new URL('../dist', import.meta.url), { recursive: true, force: true });

package/dist/realtime/legacy-sse.d.ts

@@ -1,25 +0,0 @@
-/** Minimal Durable Object namespace needed by the legacy SSE bridge. */
-export interface RealtimeDurableObjectNamespaceLike<TId = unknown> {
-    idFromName(name: string): TId;
-    get(id: TId): {
-        fetch(input: string | URL | Request, init?: RequestInit): Promise<Response>;
-    };
-}
-/** Options for bridging legacy SSE clients to Hibernation WebSocket rooms. */
-export interface LegacySseBridgeOptions<TId = unknown> {
-    namespace: RealtimeDurableObjectNamespaceLike<TId>;
-    roomNames: readonly string[];
-    signal: AbortSignal;
-    protocol: string;
-    clientId?: string;
-    heartbeatMs?: number;
-    pong?: string;
-    connectUrl?: string;
-}
-/**
- * Bridge legacy SSE clients to one or more Hibernation WebSocket rooms.
- *
- * The heartbeat lives in the outer Worker only; Durable Objects remain hibernatable. Aborting the
- * downstream request also aborts pending upgrades, including the late-upgrade race during teardown.
- */
-export declare function createLegacySseBridge<TId>(options: LegacySseBridgeOptions<TId>): Response;

package/dist/realtime/legacy-sse.js

@@ -1,110 +0,0 @@
-/**
- * Bridge legacy SSE clients to one or more Hibernation WebSocket rooms.
- *
- * The heartbeat lives in the outer Worker only; Durable Objects remain hibernatable. Aborting the
- * downstream request also aborts pending upgrades, including the late-upgrade race during teardown.
- */
-export function createLegacySseBridge(options) {
-    const encoder = new TextEncoder();
-    const sockets = new Set();
-    const heartbeatMs = options.heartbeatMs ?? 25_000;
-    const pong = options.pong ?? 'pong';
-    const connectUrl = options.connectUrl ?? 'https://do/connect';
-    let heartbeat;
-    let closeStream;
-    const stream = new ReadableStream({
-        start(controller) {
-            let closed = false;
-            const upstreamAbort = new AbortController();
-            const close = () => {
-                if (closed) {
-                    return;
-                }
-                closed = true;
-                upstreamAbort.abort();
-                if (heartbeat) {
-                    clearInterval(heartbeat);
-                }
-                for (const socket of sockets) {
-                    try {
-                        socket.close(1000, 'legacy SSE closed');
-                    }
-                    catch {
-                        // already closed
-                    }
-                }
-                sockets.clear();
-                try {
-                    controller.close();
-                }
-                catch {
-                    // already closed
-                }
-            };
-            closeStream = close;
-            if (options.signal.aborted) {
-                close();
-                return;
-            }
-            options.signal.addEventListener('abort', close, { once: true });
-            heartbeat = setInterval(() => {
-                try {
-                    controller.enqueue(encoder.encode('event: ping\ndata: ping\n\n'));
-                }
-                catch {
-                    close();
-                }
-            }, heartbeatMs);
-            const connect = async (roomName) => {
-                const id = options.namespace.idFromName(roomName);
-                const response = (await options.namespace.get(id).fetch(connectUrl, {
-                    signal: upstreamAbort.signal,
-                    headers: {
-                        Upgrade: 'websocket',
-                        'Sec-WebSocket-Protocol': options.protocol,
-                        ...(options.clientId ? { 'x-client-id': options.clientId } : {}),
-                    },
-                }));
-                const socket = response.webSocket;
-                if (response.status !== 101 || !socket) {
-                    socket?.close(1011, 'legacy SSE upgrade failed');
-                    throw new Error('Legacy realtime WebSocket upgrade failed');
-                }
-                if (closed) {
-                    socket.close(1000, 'legacy SSE already closed');
-                    return;
-                }
-                sockets.add(socket);
-                socket.accept();
-                socket.addEventListener('message', ({ data }) => {
-                    if (typeof data !== 'string' || data === pong) {
-                        return;
-                    }
-                    try {
-                        const parsed = JSON.parse(data);
-                        for (const event of Array.isArray(parsed) ? parsed : [parsed]) {
-                            controller.enqueue(encoder.encode(`data: ${JSON.stringify(event)}\n\n`));
-                        }
-                    }
-                    catch {
-                        // Ignore malformed upstream messages.
-                    }
-                });
-                socket.addEventListener('close', close, { once: true });
-                socket.addEventListener('error', close, { once: true });
-            };
-            void Promise.all(options.roomNames.map((roomName) => connect(roomName))).catch(close);
-        },
-        cancel() {
-            closeStream?.();
-        },
-    });
-    return new Response(stream, {
-        headers: {
-            'Content-Type': 'text/event-stream',
-            'Cache-Control': 'no-cache',
-            Connection: 'keep-alive',
-            'X-Accel-Buffering': 'no',
-        },
-    });
-}