@lovrozagar/honey 0.6.5 → 0.7.0

package/dist/client/sdk.js

@@ -0,0 +1,292 @@
+import { HTTPClient } from "./http.js";
+import { compilePattern, hasPlaceholder, interpolatePartial, interpolatePath } from "./path.js";
+import { createTypedWebSocket } from "./ws.js";
+/* bridge generic — Proxy target is object, return type is T (erased at runtime) */
+function bridge(value) {
+    return value;
+}
+function own(record, key) {
+    return Object.hasOwn(record, key) ? record[key] : undefined;
+}
+/**
+ * Resolve invalidation targets by substituting the mutation's params. Params that are absent
+ * stay placeholders, so a partially resolved target is a narrower pattern, never dropped:
+ * `PUT /orgs/{org}` invalidating `GET /orgs/:org/members/:id` marks `GET /orgs/acme/members/:id`.
+ */
+export function resolveInvalidationTargets(targets, params) {
+    const resolved = [];
+    for (const target of targets) {
+        const spaceIdx = target.indexOf(" ");
+        if (spaceIdx === -1 || !params) {
+            resolved.push(target);
+            continue;
+        }
+        const targetMethod = target.slice(0, spaceIdx);
+        const targetPath = target.slice(spaceIdx + 1);
+        try {
+            resolved.push(`${targetMethod} ${interpolatePartial(targetPath, params)}`);
+        }
+        catch {
+            /* a param value that is not a path segment cannot address a resource; keep the pattern */
+            resolved.push(target);
+        }
+    }
+    return resolved;
+}
+/** Test if a concrete path matches a route pattern (`:name`, `{name}`, `*`); literal text is escaped. */
+export function pathMatchesPattern(concretePath, pattern) {
+    return compilePattern(pattern).test(concretePath);
+}
+/* Bound memory: an entry remembers the last N mutations that marked it, and which concrete
+   paths have already refreshed against a pattern-level mark. */
+const MAX_INVALIDATED_BY = 32;
+const MAX_REFRESHED = 1024;
+/**
+ * Stale marks, split by kind so a concrete key is never re-read as a pattern (a path may
+ * contain `:`), and a lookup scans only patterns for its own method.
+ */
+export class StaleIndex {
+    exact = new Map();
+    patterns = new Map();
+    mark(target, mutation, seq, until) {
+        const spaceIdx = target.indexOf(" ");
+        const method = target.slice(0, spaceIdx);
+        const path = target.slice(spaceIdx + 1);
+        const isPattern = hasPlaceholder(path);
+        let table;
+        if (isPattern) {
+            table = this.patterns.get(method) ?? new Map();
+            this.patterns.set(method, table);
+        }
+        else {
+            table = this.exact;
+        }
+        const existing = table.get(target);
+        if (existing) {
+            existing.by.delete(mutation);
+            existing.by.add(mutation);
+            if (existing.by.size > MAX_INVALIDATED_BY) {
+                const oldest = existing.by.values().next().value;
+                if (oldest !== undefined)
+                    existing.by.delete(oldest);
+            }
+            existing.until = until;
+            existing.seq = seq;
+            /* a new mutation re-marks every instance */
+            if (existing.refreshed)
+                existing.refreshed.clear();
+        }
+        else {
+            table.set(target, { by: new Set([mutation]), refreshed: isPattern ? new Set() : undefined, seq, until });
+        }
+    }
+    lookup(concreteSelector, concretePath, method, now) {
+        const by = new Set();
+        const exact = this.exact.get(concreteSelector);
+        if (exact) {
+            if (exact.until > now)
+                for (const m of exact.by)
+                    by.add(m);
+            else
+                this.exact.delete(concreteSelector);
+        }
+        const table = this.patterns.get(method);
+        if (table) {
+            for (const [key, entry] of table) {
+                if (entry.until <= now) {
+                    table.delete(key);
+                    continue;
+                }
+                if (entry.refreshed?.has(concretePath))
+                    continue;
+                if (pathMatchesPattern(concretePath, key.slice(key.indexOf(" ") + 1))) {
+                    for (const m of entry.by)
+                        by.add(m);
+                }
+            }
+        }
+        return { by: [...by], isStale: by.size > 0 };
+    }
+    /**
+     * A successful stale read clears the mark for that resource only: the exact entry, and this
+     * concrete path's share of any pattern entry. Marks newer than the read's snapshot stay.
+     */
+    clear(concreteSelector, concretePath, method, snapshot) {
+        const exact = this.exact.get(concreteSelector);
+        if (exact && exact.seq <= snapshot)
+            this.exact.delete(concreteSelector);
+        const table = this.patterns.get(method);
+        if (!table)
+            return;
+        for (const [key, entry] of table) {
+            if (entry.seq > snapshot || !entry.refreshed)
+                continue;
+            if (!pathMatchesPattern(concretePath, key.slice(key.indexOf(" ") + 1)))
+                continue;
+            if (entry.refreshed.size >= MAX_REFRESHED) {
+                const oldest = entry.refreshed.values().next().value;
+                if (oldest !== undefined)
+                    entry.refreshed.delete(oldest);
+            }
+            entry.refreshed.add(concretePath);
+        }
+    }
+}
+/**
+ * Two-tier stale lookup over a flat map (kept for compatibility): exact concrete match, then
+ * pattern entries for the same method. Keys are classified by their template placeholders,
+ * not by containing `:`. Expired entries are swept.
+ */
+export function lookupStale(staleMap, concreteSelector, concretePath, method, now) {
+    const allBy = new Set();
+    for (const [key, entry] of staleMap) {
+        if (entry.until <= now) {
+            staleMap.delete(key);
+            continue;
+        }
+        if (key === concreteSelector) {
+            for (const m of entry.by)
+                allBy.add(m);
+            continue;
+        }
+        const spaceIdx = key.indexOf(" ");
+        if (key.slice(0, spaceIdx) !== method)
+            continue;
+        const keyPattern = key.slice(spaceIdx + 1);
+        if (hasPlaceholder(keyPattern) && pathMatchesPattern(concretePath, keyPattern)) {
+            for (const m of entry.by)
+                allBy.add(m);
+        }
+    }
+    return { by: [...allBy], isStale: allBy.size > 0 };
+}
+function isServiceEntry(node) {
+    return (typeof node === "object" &&
+        node !== null &&
+        typeof node["method"] === "string" &&
+        typeof node["path"] === "string");
+}
+export function createSDK(serviceMap, config) {
+    const http = new HTTPClient(config);
+    const staleTime = config.invalidation?.staleTime ?? 0;
+    const stale = staleTime > 0 ? new StaleIndex() : null;
+    let invalidationSeq = 0;
+    const rootCache = new Map();
+    function buildLeafFn(entry, namePath) {
+        /* Paths keep their template; HTTPClient interpolates `{name}` and `:name` alike. */
+        const path = entry.path;
+        const method = entry.method;
+        let fn;
+        if (entry.ws) {
+            fn = (input) => {
+                const opts = {
+                    params: input?.["params"],
+                    search: input?.["search"],
+                };
+                let url = http.buildWSUrl(path, opts);
+                const reconnectToken = input?.["reconnectToken"];
+                if (reconnectToken) {
+                    const sep = url.includes("?") ? "&" : "?";
+                    url = `${url}${sep}reconnect_token=${encodeURIComponent(reconnectToken)}`;
+                }
+                return createTypedWebSocket(url, {
+                    protocols: input?.["protocols"],
+                });
+            };
+        }
+        else if (entry.sse) {
+            fn = (input) => http.requestStream(method, path, input ?? {});
+        }
+        else {
+            fn = async (input) => {
+                const opts = input ?? {};
+                const params = opts["params"];
+                const concretePath = interpolatePath(path, params ?? {});
+                const concreteSelector = `${method} ${concretePath}`;
+                let requestMeta;
+                if (stale) {
+                    const { by, isStale } = stale.lookup(concreteSelector, concretePath, method, Date.now());
+                    requestMeta = { invalidatedBy: by, isStale, selector: concreteSelector, seqSnapshot: invalidationSeq };
+                }
+                const result = config.throwOnError === true
+                    ? await http.request(method, path, opts, requestMeta)
+                    : await http.requestSafe(method, path, opts, requestMeta);
+                if (stale) {
+                    const isSuccess = config.throwOnError === true
+                        ? true
+                        : result.status >= 200 && result.status < 300;
+                    if (isSuccess) {
+                        if (entry.invalidate && entry.invalidate.length > 0) {
+                            const seq = ++invalidationSeq;
+                            const until = Date.now() + staleTime;
+                            for (const target of resolveInvalidationTargets(entry.invalidate, params)) {
+                                stale.mark(target, concreteSelector, seq, until);
+                            }
+                        }
+                        if (requestMeta?.isStale) {
+                            stale.clear(concreteSelector, concretePath, method, requestMeta.seqSnapshot);
+                        }
+                    }
+                }
+                return result;
+            };
+        }
+        Object.defineProperty(fn, "name", { value: namePath.join(".") });
+        return fn;
+    }
+    /** Own keys only: names like `toString` or `constructor` must not resolve through the prototype. */
+    function resolveChild(node, key, namePath) {
+        if (typeof key === "symbol" || key === "then")
+            return undefined;
+        const child = own(node, key);
+        if (child === undefined) {
+            if (key === "toString" || key === "toJSON")
+                return () => `[object HoneySDK${namePath.length ? ` ${namePath.join(".")}` : ""}]`;
+            return undefined;
+        }
+        return child;
+    }
+    function makeNodeProxy(node, namePath) {
+        const actionCache = new Map();
+        const childCache = new Map();
+        return new Proxy({}, {
+            get(_, key) {
+                const child = resolveChild(node, key, namePath);
+                if (child === undefined || typeof child === "function")
+                    return child;
+                const name = key;
+                if (isServiceEntry(child)) {
+                    const cached = actionCache.get(name);
+                    if (cached)
+                        return cached;
+                    const fn = buildLeafFn(child, [...namePath, name]);
+                    actionCache.set(name, fn);
+                    return fn;
+                }
+                const cached = childCache.get(name);
+                if (cached)
+                    return cached;
+                const childProxy = makeNodeProxy(child, [...namePath, name]);
+                childCache.set(name, childProxy);
+                return childProxy;
+            },
+        });
+    }
+    return bridge(new Proxy({}, {
+        get(_target, key) {
+            const node = resolveChild(serviceMap, key, []);
+            if (node === undefined || typeof node === "function")
+                return node;
+            const name = key;
+            const cached = rootCache.get(name);
+            if (cached)
+                return cached;
+            const result = isServiceEntry(node)
+                ? buildLeafFn(node, [name])
+                : makeNodeProxy(node, [name]);
+            rootCache.set(name, result);
+            return result;
+        },
+    }));
+}
+//# sourceMappingURL=sdk.js.map

package/dist/client/sdk.js.map

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

package/dist/client/sse.d.ts

@@ -1,9 +1,22 @@
 export type SSEEvent = {
     data: string;
     event?: string;
+    /** The last event ID (sticky across events, as `EventSource.lastEventId`). Absent while empty. */
     id?: string;
     retry?: number;
 };
+/**
+ * Parse a `text/event-stream` body per the WHATWG HTML "event stream interpretation" rules:
+ *
+ * - lines end at CRLF, LF or CR (a CR at a chunk boundary waits for a possible LF);
+ * - a leading BOM is skipped;
+ * - `id` persists across events until changed, and an `id` containing NUL is ignored;
+ * - `retry` is accepted only when it is all ASCII digits;
+ * - an event still open when the stream ends is discarded, never dispatched.
+ *
+ * `maxBufferSize` caps both an unterminated line and the data of one event (UTF-16 code
+ * units); exceeding it throws.
+ */
 export declare function parseSSEStream(stream: ReadableStream<Uint8Array>, opts?: {
     maxBufferSize?: number;
 }): AsyncGenerator<SSEEvent, void, undefined>;

package/dist/client/sse.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sse.d.ts","sourceRoot":"","sources":["../../src/client/sse.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG;IACtB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,KAAK,CAAC,EAAE,MAAM,CAAA;CACd,CAAA;AAwDD,wBAAuB,cAAc,CACpC,MAAM,EAAE,cAAc,CAAC,UAAU,CAAC,EAClC,IAAI,CAAC,EAAE;IAAE,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/B,cAAc,CAAC,QAAQ,EAAE,IAAI,EAAE,SAAS,CAAC,CAqC3C"}
+{"version":3,"file":"sse.d.ts","sourceRoot":"","sources":["../../src/client/sse.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG;IACtB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,kGAAkG;IAClG,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,KAAK,CAAC,EAAE,MAAM,CAAA;CACd,CAAA;AAID;;;;;;;;;;;GAWG;AACH,wBAAuB,cAAc,CACpC,MAAM,EAAE,cAAc,CAAC,UAAU,CAAC,EAClC,IAAI,CAAC,EAAE;IAAE,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/B,cAAc,CAAC,QAAQ,EAAE,IAAI,EAAE,SAAS,CAAC,CAsG3C"}

package/dist/client/sse.js

@@ -0,0 +1,129 @@
+const DEFAULT_MAX_BUFFER = 1024 * 1024;
+/**
+ * Parse a `text/event-stream` body per the WHATWG HTML "event stream interpretation" rules:
+ *
+ * - lines end at CRLF, LF or CR (a CR at a chunk boundary waits for a possible LF);
+ * - a leading BOM is skipped;
+ * - `id` persists across events until changed, and an `id` containing NUL is ignored;
+ * - `retry` is accepted only when it is all ASCII digits;
+ * - an event still open when the stream ends is discarded, never dispatched.
+ *
+ * `maxBufferSize` caps both an unterminated line and the data of one event (UTF-16 code
+ * units); exceeding it throws.
+ */
+export async function* parseSSEStream(stream, opts) {
+    const decoder = new TextDecoder();
+    const reader = stream.getReader();
+    const maxBuffer = opts?.maxBufferSize ?? DEFAULT_MAX_BUFFER;
+    let pending = "";
+    let first = true;
+    let data = [];
+    let dataSize = 0;
+    let hasData = false;
+    let event;
+    let lastId = "";
+    let retry;
+    const dispatch = () => {
+        const out = hasData ? { data: data.join("\n") } : undefined;
+        if (out) {
+            if (event !== undefined && event !== "")
+                out.event = event;
+            if (lastId !== "")
+                out.id = lastId;
+            if (retry !== undefined)
+                out.retry = retry;
+            retry = undefined;
+        }
+        data = [];
+        dataSize = 0;
+        hasData = false;
+        event = undefined;
+        return out;
+    };
+    const processLine = (line) => {
+        if (line.charCodeAt(0) === 58 /* : */)
+            return;
+        const colon = line.indexOf(":");
+        const field = colon === -1 ? line : line.slice(0, colon);
+        let value = colon === -1 ? "" : line.slice(colon + 1);
+        if (value.charCodeAt(0) === 32)
+            value = value.slice(1);
+        switch (field) {
+            case "data":
+                dataSize += value.length + 1;
+                if (dataSize > maxBuffer)
+                    throw new Error(`SSE event exceeded ${maxBuffer} characters`);
+                data.push(value);
+                hasData = true;
+                break;
+            case "event":
+                event = value;
+                break;
+            case "id":
+                if (!value.includes("\0"))
+                    lastId = value;
+                break;
+            case "retry":
+                if (/^\d+$/.test(value))
+                    retry = Number(value);
+                break;
+        }
+    };
+    try {
+        while (true) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            pending += decoder.decode(value, { stream: true });
+            if (first && pending.length > 0) {
+                if (pending.charCodeAt(0) === 0xfeff)
+                    pending = pending.slice(1);
+                first = false;
+            }
+            let start = 0;
+            while (start < pending.length) {
+                let end = start;
+                while (end < pending.length) {
+                    const c = pending.charCodeAt(end);
+                    if (c === 10 || c === 13)
+                        break;
+                    end++;
+                }
+                if (end === pending.length)
+                    break;
+                /* A CR as the last character may be the first half of CRLF. */
+                if (pending.charCodeAt(end) === 13 && end === pending.length - 1)
+                    break;
+                const line = pending.slice(start, end);
+                start = end + (pending.charCodeAt(end) === 13 && pending.charCodeAt(end + 1) === 10 ? 2 : 1);
+                if (line === "") {
+                    const out = dispatch();
+                    if (out)
+                        yield out;
+                }
+                else {
+                    processLine(line);
+                }
+            }
+            pending = pending.slice(start);
+            if (pending.length > maxBuffer) {
+                throw new Error(`SSE buffer exceeded ${maxBuffer} characters`);
+            }
+        }
+        /* A lone CR held back at the end of the stream still terminates its line. */
+        if (pending.endsWith("\r")) {
+            const line = pending.slice(0, -1);
+            if (line === "") {
+                const out = dispatch();
+                if (out)
+                    yield out;
+            }
+        }
+        /* Anything else still open is an incomplete event: discard it. */
+    }
+    finally {
+        await reader.cancel().catch(() => { });
+        reader.releaseLock();
+    }
+}
+//# sourceMappingURL=sse.js.map

package/dist/client/sse.js.map

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

package/dist/client/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/client/types.js.map

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

package/dist/client/ws.d.ts

@@ -1,12 +1,19 @@
 export type TypedWebSocket = {
     close(code?: number, reason?: string): void;
-    off(event: "close" | "error" | "message" | "open", handler: (...args: never[]) => void): void;
+    off(event: "binary" | "close" | "error" | "message" | "open", handler: (...args: never[]) => void): void;
+    /** Binary frames, as `ArrayBuffer`. Text frames go to `"message"`. */
+    on(event: "binary", handler: (data: ArrayBuffer) => void): void;
     on(event: "close", handler: (code: number, reason: string) => void): void;
     on(event: "error", handler: (error: unknown) => void): void;
+    /** Text frames. */
     on(event: "message", handler: (data: string) => void): void;
     on(event: "open", handler: () => void): void;
     readonly readyState: number;
-    send(data: ArrayBuffer | ArrayBufferView | object | string): void;
+    /**
+     * Strings, `ArrayBuffer`, typed arrays and `Blob` are sent as-is; any other value is
+     * JSON-encoded. Sends before the socket opens are queued; after it closes they are dropped.
+     */
+    send(data: ArrayBuffer | ArrayBufferView | Blob | object | string): void;
 };
 export type WSOptions = {
     protocols?: string | string[];

package/dist/client/ws.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ws.d.ts","sourceRoot":"","sources":["../../src/client/ws.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GAAG;IAC5B,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3C,GAAG,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,IAAI,GAAG,IAAI,CAAA;IAC7F,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAAA;IACzE,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI,CAAA;IAC3D,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAAA;IAC3D,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,IAAI,GAAG,IAAI,CAAA;IAC5C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,IAAI,CAAC,IAAI,EAAE,WAAW,GAAG,eAAe,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,CAAA;CACjE,CAAA;AAED,MAAM,MAAM,SAAS,GAAG;IACvB,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;CAC7B,CAAA;AAED,wBAAgB,oBAAoB,CACnC,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,SAAS,EAChB,aAAa,GAAE,OAAO,SAAqB,GACzC,cAAc,CA6FhB"}
+{"version":3,"file":"ws.d.ts","sourceRoot":"","sources":["../../src/client/ws.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GAAG;IAC5B,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3C,GAAG,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,IAAI,GAAG,IAAI,CAAA;IACxG,sEAAsE;IACtE,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,WAAW,KAAK,IAAI,GAAG,IAAI,CAAA;IAC/D,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAAA;IACzE,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI,CAAA;IAC3D,mBAAmB;IACnB,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAAA;IAC3D,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,IAAI,GAAG,IAAI,CAAA;IAC5C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B;;;OAGG;IACH,IAAI,CAAC,IAAI,EAAE,WAAW,GAAG,eAAe,GAAG,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,CAAA;CACxE,CAAA;AAED,MAAM,MAAM,SAAS,GAAG;IACvB,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;CAC7B,CAAA;AAMD,wBAAgB,oBAAoB,CACnC,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,SAAS,EAChB,aAAa,GAAE,OAAO,SAAqB,GACzC,cAAc,CAsHhB"}

package/dist/client/ws.js

@@ -0,0 +1,112 @@
+const EVENTS = new Set(["binary", "close", "error", "message", "open"]);
+export function createTypedWebSocket(url, opts, WebSocketImpl = WebSocket) {
+    const ws = opts?.protocols ? new WebSocketImpl(url, opts.protocols) : new WebSocketImpl(url);
+    ws.binaryType = "arraybuffer";
+    /* user handler → wrapped listener, per event, so one handler can be registered for several events */
+    const listeners = new Map();
+    /* queue sends until OPEN; stop queueing for good once the socket closes or fails */
+    const sendBuffer = [];
+    let state = "connecting";
+    ws.addEventListener("open", () => {
+        state = "open";
+        for (const msg of sendBuffer) {
+            ws.send(msg);
+        }
+        sendBuffer.length = 0;
+    });
+    ws.addEventListener("close", () => {
+        state = "closed";
+        sendBuffer.length = 0;
+    });
+    function close(code, reason) {
+        state = "closed";
+        sendBuffer.length = 0;
+        ws.close(code, reason);
+    }
+    function on(event, handler) {
+        if (!EVENTS.has(event))
+            return;
+        let wrapped;
+        switch (event) {
+            case "message":
+                wrapped = (e) => {
+                    const data = e.data;
+                    if (typeof data === "string")
+                        handler(data);
+                };
+                break;
+            case "binary":
+                wrapped = (e) => {
+                    const data = e.data;
+                    if (data instanceof ArrayBuffer)
+                        handler(data);
+                };
+                break;
+            case "open":
+                wrapped = () => handler();
+                break;
+            case "close":
+                wrapped = (e) => handler(e.code, e.reason);
+                break;
+            default:
+                wrapped = (e) => handler(e);
+                break;
+        }
+        let byHandler = listeners.get(event);
+        if (byHandler === undefined) {
+            byHandler = new WeakMap();
+            listeners.set(event, byHandler);
+        }
+        const previous = byHandler.get(handler);
+        if (previous)
+            ws.removeEventListener(event === "binary" ? "message" : event, previous);
+        byHandler.set(handler, wrapped);
+        ws.addEventListener(event === "binary" ? "message" : event, wrapped);
+    }
+    function off(event, handler) {
+        const byHandler = listeners.get(event);
+        const wrapped = byHandler?.get(handler);
+        if (wrapped) {
+            ws.removeEventListener(event === "binary" ? "message" : event, wrapped);
+            byHandler?.delete(handler);
+        }
+    }
+    function toPayload(data) {
+        if (typeof data === "string")
+            return data;
+        if (typeof Blob !== "undefined" && data instanceof Blob)
+            return data;
+        if (data instanceof ArrayBuffer || ArrayBuffer.isView(data)) {
+            const view = data instanceof ArrayBuffer
+                ? new Uint8Array(data)
+                : new Uint8Array(data.buffer, data.byteOffset, data.byteLength);
+            const copy = new Uint8Array(view.byteLength);
+            copy.set(view);
+            return copy;
+        }
+        return JSON.stringify(data);
+    }
+    function send(data) {
+        if (state === "closed")
+            return;
+        const payload = toPayload(data);
+        if (state === "connecting") {
+            sendBuffer.push(payload);
+        }
+        else {
+            ws.send(payload);
+        }
+    }
+    const typed = {
+        close,
+        off,
+        on,
+        get readyState() {
+            return ws.readyState;
+        },
+        send,
+    };
+    Object.defineProperty(typed, "_ws", { enumerable: false, value: ws });
+    return typed;
+}
+//# sourceMappingURL=ws.js.map

package/dist/client/ws.js.map

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