orez 0.1.36 → 0.1.38

package/dist/worker/shims/ws-browser.d.ts

@@ -0,0 +1,50 @@
+/**
+ * browser WebSocket/MessagePort adapter for the ws shim.
+ *
+ * wraps a browser WebSocket or MessagePort to match the interface
+ * that the existing ws shim (orez/worker/shims/ws) expects. this lets
+ * zero-cache handle WebSocket connections in browser Web Workers.
+ *
+ * usage:
+ *   import { messagePortToWs, browserWsToWs } from 'orez/worker/shims/ws-browser'
+ *
+ *   // from a MessageChannel (worker ↔ main thread)
+ *   const channel = new MessageChannel()
+ *   const serverWs = messagePortToWs(channel.port2)
+ *
+ *   // from a browser WebSocket
+ *   const ws = new WebSocket('ws://...')
+ *   const shimWs = browserWsToWs(ws)
+ */
+interface WsCompatible {
+    readyState: number;
+    send(data: string | ArrayBuffer | ArrayBufferView): void;
+    close(code?: number, reason?: string): void;
+    addEventListener(type: string, handler: (event: any) => void): void;
+    removeEventListener(type: string, handler: (event: any) => void): void;
+}
+/**
+ * wrap a MessagePort to look like a WebSocket.
+ *
+ * MessagePort uses postMessage/onmessage, while the ws shim expects
+ * send/addEventListener('message'). this bridges the two.
+ */
+export declare function messagePortToWs(port: MessagePort): WsCompatible;
+/**
+ * wrap a browser WebSocket to match the ws shim's expected interface.
+ *
+ * browser WebSocket and the ws shim's CFWebSocket interface are very
+ * similar but have subtle differences. this normalizes them.
+ */
+export declare function browserWsToWs(ws: WebSocket): WsCompatible;
+/**
+ * create a connected pair of WebSocket-like objects for in-process
+ * communication (e.g., when zero-cache and Zero client are in the
+ * same browser context). uses MessageChannel internally.
+ *
+ * returns [client, server] — client goes to Zero client, server
+ * goes to the browser embed's handleWebSocket().
+ */
+export declare function createInProcessPair(): [WsCompatible, WsCompatible];
+export {};
+//# sourceMappingURL=ws-browser.d.ts.map

package/dist/worker/shims/ws-browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws-browser.d.ts","sourceRoot":"","sources":["../../../src/worker/shims/ws-browser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,UAAU,YAAY;IACpB,UAAU,EAAE,MAAM,CAAA;IAClB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,eAAe,GAAG,IAAI,CAAA;IACxD,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3C,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI,GAAG,IAAI,CAAA;IACnE,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI,GAAG,IAAI,CAAA;CACvE;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,WAAW,GAAG,YAAY,CA+C/D;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,SAAS,GAAG,YAAY,CAsBzD;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,IAAI,CAAC,YAAY,EAAE,YAAY,CAAC,CAGlE"}

package/dist/worker/shims/ws-browser.js

@@ -0,0 +1,105 @@
+/**
+ * browser WebSocket/MessagePort adapter for the ws shim.
+ *
+ * wraps a browser WebSocket or MessagePort to match the interface
+ * that the existing ws shim (orez/worker/shims/ws) expects. this lets
+ * zero-cache handle WebSocket connections in browser Web Workers.
+ *
+ * usage:
+ *   import { messagePortToWs, browserWsToWs } from 'orez/worker/shims/ws-browser'
+ *
+ *   // from a MessageChannel (worker ↔ main thread)
+ *   const channel = new MessageChannel()
+ *   const serverWs = messagePortToWs(channel.port2)
+ *
+ *   // from a browser WebSocket
+ *   const ws = new WebSocket('ws://...')
+ *   const shimWs = browserWsToWs(ws)
+ */
+/**
+ * wrap a MessagePort to look like a WebSocket.
+ *
+ * MessagePort uses postMessage/onmessage, while the ws shim expects
+ * send/addEventListener('message'). this bridges the two.
+ */
+export function messagePortToWs(port) {
+    const listeners = new Map();
+    let closed = false;
+    function addListener(type, handler) {
+        if (!listeners.has(type))
+            listeners.set(type, new Set());
+        listeners.get(type).add(handler);
+    }
+    function removeListener(type, handler) {
+        listeners.get(type)?.delete(handler);
+    }
+    function emit(type, event) {
+        for (const h of listeners.get(type) || [])
+            h(event);
+    }
+    // forward port messages → ws 'message' events
+    port.onmessage = (event) => {
+        emit('message', { data: event.data });
+    };
+    port.onmessageerror = (event) => {
+        emit('error', { message: 'MessagePort error', error: event });
+    };
+    return {
+        get readyState() {
+            return closed ? 3 : 1; // CLOSED or OPEN
+        },
+        send(data) {
+            if (closed)
+                return;
+            // MessagePort uses postMessage (structured clone)
+            port.postMessage(data);
+        },
+        close(code, _reason) {
+            if (closed)
+                return;
+            closed = true;
+            port.close();
+            emit('close', { code: code ?? 1000, reason: '', wasClean: true });
+        },
+        addEventListener: addListener,
+        removeEventListener: removeListener,
+    };
+}
+/**
+ * wrap a browser WebSocket to match the ws shim's expected interface.
+ *
+ * browser WebSocket and the ws shim's CFWebSocket interface are very
+ * similar but have subtle differences. this normalizes them.
+ */
+export function browserWsToWs(ws) {
+    return {
+        get readyState() {
+            return ws.readyState;
+        },
+        send(data) {
+            ws.send(data);
+        },
+        close(code, reason) {
+            ws.close(code, reason);
+        },
+        addEventListener(type, handler) {
+            ws.addEventListener(type, handler);
+        },
+        removeEventListener(type, handler) {
+            ws.removeEventListener(type, handler);
+        },
+    };
+}
+/**
+ * create a connected pair of WebSocket-like objects for in-process
+ * communication (e.g., when zero-cache and Zero client are in the
+ * same browser context). uses MessageChannel internally.
+ *
+ * returns [client, server] — client goes to Zero client, server
+ * goes to the browser embed's handleWebSocket().
+ */
+export function createInProcessPair() {
+    const channel = new MessageChannel();
+    return [messagePortToWs(channel.port1), messagePortToWs(channel.port2)];
+}
+//# sourceMappingURL=ws-browser.js.map

package/dist/worker/shims/ws-browser.js.map

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

package/dist/worker/shims/ws.d.ts

@@ -0,0 +1,62 @@
+/**
+ * ws (websocket) shim for cloudflare workers.
+ *
+ * wraps CF Workers WebSocket (from WebSocketPair) to implement the
+ * ws npm package API that zero-cache uses. enables bundler aliasing
+ * so zero-cache's WebSocket handling works with CF durable WebSockets.
+ *
+ * usage with bundler alias:
+ *   alias: { 'ws': './src/worker/shims/ws.js' }
+ */
+import EventEmitter from 'node:events';
+import { Duplex } from 'node:stream';
+interface CFWebSocket {
+    send(data: string | ArrayBuffer | ArrayBufferView): void;
+    close(code?: number, reason?: string): void;
+    addEventListener(type: string, handler: (event: any) => void): void;
+    removeEventListener(type: string, handler: (event: any) => void): void;
+    readyState: number;
+    accept?(): void;
+}
+declare class WebSocket extends EventEmitter {
+    #private;
+    static readonly CONNECTING = 0;
+    static readonly OPEN = 1;
+    static readonly CLOSING = 2;
+    static readonly CLOSED = 3;
+    readonly CONNECTING = 0;
+    readonly OPEN = 1;
+    readonly CLOSING = 2;
+    readonly CLOSED = 3;
+    constructor(urlOrSocket: string | CFWebSocket, _protocols?: unknown, _opts?: unknown);
+    get url(): string;
+    get readyState(): number;
+    send(data: string | Buffer | ArrayBuffer | ArrayBufferView, cb?: (err?: Error) => void): void;
+    close(code?: number, reason?: string): void;
+    terminate(): void;
+    ping(_data?: unknown, _mask?: boolean, _cb?: () => void): void;
+    addEventListener(type: string, handler: (event: any) => void): void;
+    removeEventListener(type: string, handler: (event: any) => void): void;
+}
+declare class WebSocketServer extends EventEmitter {
+    constructor(_opts?: {
+        noServer?: boolean;
+    });
+    close(cb?: (err?: Error) => void): void;
+    /**
+     * handle a WebSocket upgrade. on CF Workers the upgrade is already done
+     * (WebSocketPair), so this just wraps the CF WebSocket in our shim.
+     *
+     * @param message - the HTTP request (IncomingMessage-like object)
+     * @param socket - the underlying socket (CF WebSocket on CF Workers)
+     * @param head - upgrade head buffer
+     * @param callback - receives the wrapped WebSocket
+     */
+    handleUpgrade(_message: unknown, socket: CFWebSocket | unknown, _head: unknown, callback: (ws: WebSocket) => void): void;
+}
+declare function createWebSocketStream(ws: WebSocket, _opts?: {
+    decodeStrings?: boolean;
+}): Duplex;
+export default WebSocket;
+export { WebSocket, WebSocketServer, createWebSocketStream };
+//# sourceMappingURL=ws.d.ts.map

package/dist/worker/shims/ws.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws.d.ts","sourceRoot":"","sources":["../../../src/worker/shims/ws.ts"],"names":[],"mappings":"AAGA;;;;;;;;;GASG;AAEH,OAAO,YAAY,MAAM,aAAa,CAAA;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AASpC,UAAU,WAAW;IACnB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,eAAe,GAAG,IAAI,CAAA;IACxD,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3C,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI,GAAG,IAAI,CAAA;IACnE,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI,GAAG,IAAI,CAAA;IACtE,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,CAAC,IAAI,IAAI,CAAA;CAChB;AAKD,cAAM,SAAU,SAAQ,YAAY;;IAClC,MAAM,CAAC,QAAQ,CAAC,UAAU,KAAa;IACvC,MAAM,CAAC,QAAQ,CAAC,IAAI,KAAO;IAC3B,MAAM,CAAC,QAAQ,CAAC,OAAO,KAAU;IACjC,MAAM,CAAC,QAAQ,CAAC,MAAM,KAAS;IAE/B,QAAQ,CAAC,UAAU,KAAa;IAChC,QAAQ,CAAC,IAAI,KAAO;IACpB,QAAQ,CAAC,OAAO,KAAU;IAC1B,QAAQ,CAAC,MAAM,KAAS;gBAMZ,WAAW,EAAE,MAAM,GAAG,WAAW,EAAE,UAAU,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,OAAO;IA6HpF,IAAI,GAAG,IAAI,MAAM,CAEhB;IAED,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED,IAAI,CACF,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,WAAW,GAAG,eAAe,EACrD,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,KAAK,IAAI,GACzB,IAAI;IAmBP,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAQ3C,SAAS,IAAI,IAAI;IAMjB,IAAI,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,MAAM,IAAI,GAAG,IAAI;IAU9D,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI,GAAG,IAAI;IAKnE,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI,GAAG,IAAI;CAiCvE;AAKD,cAAM,eAAgB,SAAQ,YAAY;gBAC5B,KAAK,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE;IAI1C,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,KAAK,IAAI,GAAG,IAAI;IAKvC;;;;;;;;OAQG;IACH,aAAa,CACX,QAAQ,EAAE,OAAO,EACjB,MAAM,EAAE,WAAW,GAAG,OAAO,EAC7B,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,CAAC,EAAE,EAAE,SAAS,KAAK,IAAI,GAChC,IAAI;CAKR;AAMD,iBAAS,qBAAqB,CAC5B,EAAE,EAAE,SAAS,EACb,KAAK,CAAC,EAAE;IAAE,aAAa,CAAC,EAAE,OAAO,CAAA;CAAE,GAClC,MAAM,CAoDR;AAED,eAAe,SAAS,CAAA;AACxB,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,qBAAqB,EAAE,CAAA"}

package/dist/worker/shims/ws.js

@@ -0,0 +1,310 @@
+// NOTE THIS IS NOT OREZ NODE THIS IS NOT A GOOD REFERENCE BECAUSE ITS OUR EARLY GUESS AT WHAT COULD WORK
+// DO NOT STUDY THIS, THE OTHER STUFF IN SRC IS WHERE YOU EANT TO LOOK
+/**
+ * ws (websocket) shim for cloudflare workers.
+ *
+ * wraps CF Workers WebSocket (from WebSocketPair) to implement the
+ * ws npm package API that zero-cache uses. enables bundler aliasing
+ * so zero-cache's WebSocket handling works with CF durable WebSockets.
+ *
+ * usage with bundler alias:
+ *   alias: { 'ws': './src/worker/shims/ws.js' }
+ */
+import EventEmitter from 'node:events';
+import { Duplex } from 'node:stream';
+// -- readyState constants --
+const CONNECTING = 0;
+const OPEN = 1;
+const CLOSING = 2;
+const CLOSED = 3;
+// -- WebSocket shim --
+// wraps a CF WebSocket to match the ws package WebSocket API
+class WebSocket extends EventEmitter {
+    static CONNECTING = CONNECTING;
+    static OPEN = OPEN;
+    static CLOSING = CLOSING;
+    static CLOSED = CLOSED;
+    CONNECTING = CONNECTING;
+    OPEN = OPEN;
+    CLOSING = CLOSING;
+    CLOSED = CLOSED;
+    #ws;
+    #url;
+    #listeners = new Map();
+    constructor(urlOrSocket, _protocols, _opts) {
+        super();
+        if (typeof urlOrSocket === 'string') {
+            this.#url = urlOrSocket;
+            // check for in-process connections (fastify shim uses port 0 or 1)
+            const parsedUrl = new URL(urlOrSocket, 'http://localhost');
+            const isInProcess = parsedUrl.port === '0' ||
+                parsedUrl.port === '1' ||
+                parsedUrl.hostname === 'localhost';
+            if (isInProcess) {
+                // in-process: connect via fastify server's handoff mechanism
+                const fastifyInstance = globalThis.__orez_fastify_instance;
+                if (fastifyInstance?.server) {
+                    // create paired message channels for bidirectional communication
+                    // the client-side WS (this) and serverWs are cross-linked so
+                    // ping/pong, messages, and close propagate between them
+                    const clientSide = this;
+                    const serverWs = {
+                        readyState: 1,
+                        _listeners: {},
+                        send: (data) => {
+                            // deliver to client side
+                            queueMicrotask(() => clientSide.emit('message', data));
+                        },
+                        close: (code, reason) => {
+                            serverWs.readyState = 3;
+                            queueMicrotask(() => clientSide.emit('close', code || 1000, reason || ''));
+                        },
+                        ping: () => {
+                            // ping from server → deliver 'ping' event to client
+                            // (expectPingsForLiveness listens for 'ping', not 'pong')
+                            queueMicrotask(() => clientSide.emit('ping'));
+                        },
+                        addEventListener: (type, handler) => {
+                            if (!serverWs._listeners[type])
+                                serverWs._listeners[type] = [];
+                            serverWs._listeners[type].push(handler);
+                        },
+                        removeEventListener: (type, handler) => {
+                            const arr = serverWs._listeners[type];
+                            if (arr) {
+                                const idx = arr.indexOf(handler);
+                                if (idx >= 0)
+                                    arr.splice(idx, 1);
+                            }
+                        },
+                    };
+                    this.#ws = {
+                        accept: () => { },
+                        send: (data) => {
+                            // deliver to server side
+                            const handlers = serverWs._listeners['message'] || [];
+                            for (const h of handlers)
+                                h({ data });
+                        },
+                        close: (code, reason) => {
+                            const handlers = serverWs._listeners['close'] || [];
+                            for (const h of handlers)
+                                h({ code, reason });
+                        },
+                        addEventListener: () => { },
+                        removeEventListener: () => { },
+                        get readyState() {
+                            return 1;
+                        },
+                    };
+                    // emit handoff to fastify server
+                    const path = parsedUrl.pathname + parsedUrl.search;
+                    queueMicrotask(() => {
+                        fastifyInstance.server.emit('message', [
+                            'handoff',
+                            {
+                                message: { url: path, headers: {}, method: 'GET' },
+                                head: new Uint8Array(0),
+                            },
+                        ], serverWs);
+                        this.emit('open');
+                    });
+                }
+                else {
+                    // no fastify instance — emit close immediately
+                    queueMicrotask(() => this.emit('close', 1006, 'no fastify server'));
+                }
+            }
+            else if (typeof globalThis.WebSocket === 'function') {
+                // real outbound WebSocket for external connections
+                const nativeWs = new globalThis.WebSocket(urlOrSocket);
+                this.#ws = {
+                    accept: () => { },
+                    send: (data) => nativeWs.send(data),
+                    close: (code, reason) => nativeWs.close(code, reason),
+                    addEventListener: (type, handler) => nativeWs.addEventListener(type, handler),
+                    removeEventListener: (type, handler) => nativeWs.removeEventListener(type, handler),
+                    get readyState() {
+                        return nativeWs.readyState;
+                    },
+                };
+                nativeWs.addEventListener('open', () => this.emit('open'));
+                nativeWs.addEventListener('message', (ev) => this.emit('message', ev.data));
+                nativeWs.addEventListener('close', (ev) => this.emit('close', ev.code, ev.reason));
+                nativeWs.addEventListener('error', (ev) => this.emit('error', new Error('WebSocket error')));
+            }
+            else {
+                throw new Error('ws shim: outbound WebSocket connections not yet supported. ' +
+                    'use the CF Workers fetch API for outbound WebSocket.');
+            }
+        }
+        else {
+            this.#ws = urlOrSocket;
+            this.#url = '';
+            this.#setupListeners();
+        }
+    }
+    get url() {
+        return this.#url;
+    }
+    get readyState() {
+        return this.#ws.readyState;
+    }
+    send(data, cb) {
+        try {
+            if (typeof data === 'string') {
+                this.#ws.send(data);
+            }
+            else if (Buffer.isBuffer(data)) {
+                this.#ws.send(new Uint8Array(data.buffer, data.byteOffset, data.byteLength));
+            }
+            else if (data instanceof ArrayBuffer) {
+                this.#ws.send(data);
+            }
+            else if (ArrayBuffer.isView(data)) {
+                this.#ws.send(new Uint8Array(data.buffer, data.byteOffset, data.byteLength));
+            }
+            else {
+                this.#ws.send(String(data));
+            }
+            cb?.();
+        }
+        catch (err) {
+            cb?.(err);
+        }
+    }
+    close(code, reason) {
+        try {
+            this.#ws.close(code, reason);
+        }
+        catch {
+            // socket may already be closed
+        }
+    }
+    terminate() {
+        // real ws.terminate() destroys the socket without a close frame.
+        // CF Workers don't expose raw socket destroy, so close with 1000.
+        this.close(1000);
+    }
+    ping(_data, _mask, _cb) {
+        // forward ping to underlying socket if it supports it (in-process pairs)
+        if (typeof this.#ws.ping === 'function') {
+            ;
+            this.#ws.ping();
+        }
+        // also emit pong locally (CF WebSockets handle ping/pong at platform level)
+        this.emit('pong');
+    }
+    // standard EventTarget-style addEventListener (used by Connection)
+    addEventListener(type, handler) {
+        // wrap to emit EventEmitter-style
+        this.on(type, handler);
+    }
+    removeEventListener(type, handler) {
+        this.off(type, handler);
+    }
+    #setupListeners() {
+        // match ws npm package event signatures:
+        //   message: (data: Buffer|string, isBinary: boolean)
+        //   close: (code: number, reason: string)
+        //   error: (err: Error)
+        const onMessage = (event) => {
+            const data = event.data;
+            this.emit('message', data, typeof data !== 'string');
+        };
+        const onClose = (event) => {
+            this.emit('close', event.code ?? 1000, event.reason ?? '');
+        };
+        const onError = (event) => {
+            this.emit('error', event.error ?? new Error(event.message ?? 'WebSocket error'));
+        };
+        const onOpen = () => {
+            this.emit('open');
+        };
+        this.#ws.addEventListener('message', onMessage);
+        this.#ws.addEventListener('close', onClose);
+        this.#ws.addEventListener('error', onError);
+        this.#ws.addEventListener('open', onOpen);
+        this.#listeners.set('message', onMessage);
+        this.#listeners.set('close', onClose);
+        this.#listeners.set('error', onError);
+        this.#listeners.set('open', onOpen);
+    }
+}
+// -- WebSocketServer shim --
+// zero-cache uses WebSocketServer with { noServer: true } for handleUpgrade
+class WebSocketServer extends EventEmitter {
+    constructor(_opts) {
+        super();
+    }
+    close(cb) {
+        // no-op — browser embed has no real server to close
+        cb?.();
+    }
+    /**
+     * handle a WebSocket upgrade. on CF Workers the upgrade is already done
+     * (WebSocketPair), so this just wraps the CF WebSocket in our shim.
+     *
+     * @param message - the HTTP request (IncomingMessage-like object)
+     * @param socket - the underlying socket (CF WebSocket on CF Workers)
+     * @param head - upgrade head buffer
+     * @param callback - receives the wrapped WebSocket
+     */
+    handleUpgrade(_message, socket, _head, callback) {
+        // wrap the CF WebSocket in our shim
+        const ws = new WebSocket(socket);
+        callback(ws);
+    }
+}
+// -- createWebSocketStream --
+// creates a Node.js Duplex stream from a WebSocket.
+// used by zero-cache's Connection class for streaming messages.
+function createWebSocketStream(ws, _opts) {
+    const duplex = new Duplex({
+        objectMode: false,
+        decodeStrings: false,
+        read() {
+            // data is pushed from ws message events
+        },
+        write(chunk, _encoding, callback) {
+            try {
+                ws.send(typeof chunk === 'string' ? chunk : chunk.toString(), callback);
+            }
+            catch (err) {
+                callback(err);
+            }
+        },
+        destroy(err, callback) {
+            ws.close();
+            callback(err);
+        },
+    });
+    // pipe ws messages into the readable side
+    ws.on('message', (event) => {
+        const data = event?.data ?? event;
+        if (typeof data === 'string') {
+            duplex.push(data);
+        }
+        else if (data instanceof ArrayBuffer) {
+            duplex.push(Buffer.from(data));
+        }
+        else if (ArrayBuffer.isView(data)) {
+            duplex.push(Buffer.from(data.buffer, data.byteOffset, data.byteLength));
+        }
+        else {
+            duplex.push(String(data));
+        }
+    });
+    ws.on('close', () => {
+        duplex.push(null); // signal end of readable
+        duplex.destroy();
+    });
+    ws.on('error', (event) => {
+        const err = event?.error ?? new Error(event?.message ?? 'WebSocket error');
+        duplex.destroy(err);
+    });
+    return duplex;
+}
+export default WebSocket;
+export { WebSocket, WebSocketServer, createWebSocketStream };
+//# sourceMappingURL=ws.js.map

package/dist/worker/shims/ws.js.map

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

package/dist/worker/types.d.ts

@@ -0,0 +1,57 @@
+/**
+ * orez/worker types.
+ *
+ * interfaces for the embeddable orez worker that runs PGlite + change
+ * tracking without Node.js dependencies. designed for CF Workers/DO
+ * but usable in any JS runtime (browser, vitest, bun, deno).
+ */
+import type { Mutex } from '../mutex.js';
+import type { ChangeRecord } from '../replication/change-tracker.js';
+import type { ReplicationWriter } from '../replication/handler.js';
+import type { PGlite, PGliteOptions, Results } from '@electric-sql/pglite';
+/** options for creating an orez worker */
+export interface OrezWorkerOptions {
+    /**
+     * pre-created PGlite instance. when provided, orez wraps it
+     * without managing its lifecycle (caller is responsible for closing).
+     */
+    pglite?: PGlite;
+    /**
+     * PGlite constructor options. used when `pglite` is not provided.
+     * in CF Workers, pass wasmModule/fsBundle/loadDataDir here.
+     */
+    pgliteOptions?: PGliteOptions;
+    /** publication names to track. defaults to all public tables. */
+    publications?: string[];
+    /** log level (default: 'warn') */
+    logLevel?: 'error' | 'warn' | 'info' | 'debug';
+}
+/** the orez worker instance */
+export interface OrezWorker {
+    /** the underlying PGlite instance */
+    readonly db: PGlite;
+    /** mutex for serializing PGlite access */
+    readonly mutex: Mutex;
+    /** run a parameterized query */
+    query<T extends Record<string, unknown> = Record<string, unknown>>(sql: string, params?: unknown[]): Promise<Results<T>>;
+    /** execute raw SQL (DDL, multi-statement) */
+    exec(sql: string): Promise<void>;
+    /** install/reinstall change tracking triggers on all published tables */
+    installChangeTracking(): Promise<void>;
+    /** get changes since a watermark */
+    getChangesSince(watermark: number, limit?: number): Promise<ChangeRecord[]>;
+    /** get current watermark value */
+    getCurrentWatermark(): Promise<number>;
+    /** purge consumed changes up to watermark */
+    purgeChanges(watermark: number): Promise<number>;
+    /**
+     * start streaming replication to a writer.
+     * runs until the writer is closed or the worker is shut down.
+     */
+    startReplication(writer: ReplicationWriter): Promise<void>;
+    /** whether this worker owns the PGlite instance (manages its lifecycle) */
+    readonly ownsInstance: boolean;
+    /** close the worker. if ownsInstance, also closes PGlite. */
+    close(): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/worker/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/worker/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AACxC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAA;AACpE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAA;AAClE,OAAO,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAA;AAE1E,0CAA0C;AAC1C,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;IAEf;;;OAGG;IACH,aAAa,CAAC,EAAE,aAAa,CAAA;IAE7B,iEAAiE;IACjE,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;IAEvB,kCAAkC;IAClC,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAA;CAC/C;AAED,+BAA+B;AAC/B,MAAM,WAAW,UAAU;IACzB,qCAAqC;IACrC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IAEnB,0CAA0C;IAC1C,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAA;IAErB,gCAAgC;IAChC,KAAK,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/D,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,OAAO,EAAE,GACjB,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAA;IAEtB,6CAA6C;IAC7C,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAEhC,yEAAyE;IACzE,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IAEtC,oCAAoC;IACpC,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAAA;IAE3E,kCAAkC;IAClC,mBAAmB,IAAI,OAAO,CAAC,MAAM,CAAC,CAAA;IAEtC,6CAA6C;IAC7C,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IAEhD;;;OAGG;IACH,gBAAgB,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAE1D,2EAA2E;IAC3E,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAA;IAE9B,6DAA6D;IAC7D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACvB"}

package/dist/worker/types.js

@@ -0,0 +1,9 @@
+/**
+ * orez/worker types.
+ *
+ * interfaces for the embeddable orez worker that runs PGlite + change
+ * tracking without Node.js dependencies. designed for CF Workers/DO
+ * but usable in any JS runtime (browser, vitest, bun, deno).
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/worker/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/worker/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}