tempest-react-sdk 0.23.0 → 0.25.0

package/dist/vite/tempest-pwa-manifest.js.map

@@ -1 +1 @@
-{"version":3,"file":"tempest-pwa-manifest.js","sources":["../../src/vite/tempest-pwa-manifest.ts"],"sourcesContent":["import type { Plugin } from \"vite\";\n\n/**\n * A Vite plugin object. Typed loosely so the SDK's published declarations stay\n * free of `vite`'s internal types (which the `.d.ts` rollup can't analyze);\n * assign the result straight into a `plugins: [...]` array.\n */\nexport type TempestVitePlugin = { name: string } & Record<string, unknown>;\n\n/** Options for {@link tempestPwaManifest}. */\nexport interface TempestPwaManifestOptions {\n    /** Output file name (under the build root). Default `precache-manifest.json`. */\n    fileName?: string;\n    /**\n     * Extra URLs to precache that Vite doesn't emit into the bundle — typically\n     * `public/` assets like the web manifest and icons. Default `[]`.\n     */\n    additionalUrls?: string[];\n    /** Emitted files matching this are skipped. Default `/\\.map$/` (source maps). */\n    exclude?: RegExp;\n    /** Include emitted `.html` documents (the app shell). Default `true`. */\n    includeHtml?: boolean;\n    /**\n     * App-shell document always added to the manifest, even if Vite emits it\n     * after this plugin runs. Must match `installPrecache`'s `navigateFallback`\n     * so offline navigations resolve. Pass `false` to disable. Default `/index.html`.\n     */\n    appShell?: string | false;\n}\n\nfunction joinBase(base: string, file: string): string {\n    const prefix = base.endsWith(\"/\") ? base : `${base}/`;\n    return `${prefix}${file}`.replace(/([^:]\\/)\\/+/g, \"$1\");\n}\n\n/** Deterministic djb2 hash → hex. Stable across rebuilds with the same assets. */\nfunction hash(input: string): string {\n    let h = 5381;\n    for (let i = 0; i < input.length; i++) {\n        h = ((h << 5) + h + input.charCodeAt(i)) >>> 0;\n    }\n    return h.toString(16);\n}\n\n/**\n * Vite build plugin that emits a `precache-manifest.json` listing every built\n * asset (plus any `additionalUrls`) as root-absolute URLs, with a content-based\n * `version`. It is the dependency-free counterpart to Workbox's `__WB_MANIFEST`:\n * `installPrecache` (from `tempest-react-sdk/sw`) reads this file at the service\n * worker's `install` event to cache the app shell for offline use.\n *\n * @example\n * // vite.config.ts\n * import { createViteConfig, tempestPwaManifest } from \"tempest-react-sdk/vite\";\n *\n * export default createViteConfig({\n *   plugins: [tempestPwaManifest({ additionalUrls: [\"/manifest.webmanifest\", \"/icon.svg\"] })],\n * });\n */\nexport function tempestPwaManifest(options: TempestPwaManifestOptions = {}): TempestVitePlugin {\n    const {\n        fileName = \"precache-manifest.json\",\n        additionalUrls = [],\n        exclude = /\\.map$/,\n        includeHtml = true,\n        appShell = \"/index.html\",\n    } = options;\n\n    let base = \"/\";\n\n    const plugin: Plugin = {\n        name: \"tempest-pwa-manifest\",\n        apply: \"build\",\n        configResolved(config) {\n            base = config.base ?? \"/\";\n        },\n        generateBundle(_outputOptions, bundle) {\n            const urls = new Set<string>(additionalUrls);\n            // Vite may emit index.html after this hook, so guarantee the shell.\n            if (appShell) urls.add(appShell);\n            for (const file of Object.keys(bundle)) {\n                if (file === fileName) continue;\n                if (exclude.test(file)) continue;\n                if (!includeHtml && file.endsWith(\".html\")) continue;\n                urls.add(joinBase(base, file));\n            }\n\n            const list = [...urls].sort();\n            const version = hash(list.join(\"\\n\"));\n            this.emitFile({\n                type: \"asset\",\n                fileName,\n                source: JSON.stringify({ version, urls: list }),\n            });\n        },\n    };\n\n    return plugin as TempestVitePlugin;\n}\n"],"names":["joinBase","base","file","hash","input","h","i","tempestPwaManifest","options","fileName","additionalUrls","exclude","includeHtml","appShell","config","_outputOptions","bundle","urls","list","version"],"mappings":"AA8BA,SAASA,EAASC,GAAcC,GAAsB;AAElD,SAAO,GADQD,EAAK,SAAS,GAAG,IAAIA,IAAO,GAAGA,CAAI,GAClC,GAAGC,CAAI,GAAG,QAAQ,gBAAgB,IAAI;AAC1D;AAGA,SAASC,EAAKC,GAAuB;AACjC,MAAIC,IAAI;AACR,WAASC,IAAI,GAAGA,IAAIF,EAAM,QAAQE;AAC9B,IAAAD,KAAMA,KAAK,KAAKA,IAAID,EAAM,WAAWE,CAAC,MAAO;AAEjD,SAAOD,EAAE,SAAS,EAAE;AACxB;AAiBO,SAASE,EAAmBC,IAAqC,IAAuB;AAC3F,QAAM;AAAA,IACF,UAAAC,IAAW;AAAA,IACX,gBAAAC,IAAiB,CAAA;AAAA,IACjB,SAAAC,IAAU;AAAA,IACV,aAAAC,IAAc;AAAA,IACd,UAAAC,IAAW;AAAA,EAAA,IACXL;AAEJ,MAAIP,IAAO;AA6BX,SA3BuB;AAAA,IACnB,MAAM;AAAA,IACN,OAAO;AAAA,IACP,eAAea,GAAQ;AACnB,MAAAb,IAAOa,EAAO,QAAQ;AAAA,IAC1B;AAAA,IACA,eAAeC,GAAgBC,GAAQ;AACnC,YAAMC,IAAO,IAAI,IAAYP,CAAc;AAE3C,MAAIG,KAAUI,EAAK,IAAIJ,CAAQ;AAC/B,iBAAWX,KAAQ,OAAO,KAAKc,CAAM;AACjC,QAAId,MAASO,MACTE,EAAQ,KAAKT,CAAI,KACjB,CAACU,KAAeV,EAAK,SAAS,OAAO,KACzCe,EAAK,IAAIjB,EAASC,GAAMC,CAAI,CAAC;AAGjC,YAAMgB,IAAO,CAAC,GAAGD,CAAI,EAAE,KAAA,GACjBE,IAAUhB,EAAKe,EAAK,KAAK;AAAA,CAAI,CAAC;AACpC,WAAK,SAAS;AAAA,QACV,MAAM;AAAA,QACN,UAAAT;AAAA,QACA,QAAQ,KAAK,UAAU,EAAE,SAAAU,GAAS,MAAMD,GAAM;AAAA,MAAA,CACjD;AAAA,IACL;AAAA,EAAA;AAIR;"}
+{"version":3,"file":"tempest-pwa-manifest.js","names":[],"sources":["../../src/vite/tempest-pwa-manifest.ts"],"sourcesContent":["import type { Plugin } from \"vite\";\n\n/**\n * A Vite plugin object. Typed loosely so the SDK's published declarations stay\n * free of `vite`'s internal types (which the `.d.ts` rollup can't analyze);\n * assign the result straight into a `plugins: [...]` array.\n */\nexport type TempestVitePlugin = { name: string } & Record<string, unknown>;\n\n/** Options for {@link tempestPwaManifest}. */\nexport interface TempestPwaManifestOptions {\n    /** Output file name (under the build root). Default `precache-manifest.json`. */\n    fileName?: string;\n    /**\n     * Extra URLs to precache that Vite doesn't emit into the bundle — typically\n     * `public/` assets like the web manifest and icons. Default `[]`.\n     */\n    additionalUrls?: string[];\n    /** Emitted files matching this are skipped. Default `/\\.map$/` (source maps). */\n    exclude?: RegExp;\n    /** Include emitted `.html` documents (the app shell). Default `true`. */\n    includeHtml?: boolean;\n    /**\n     * App-shell document always added to the manifest, even if Vite emits it\n     * after this plugin runs. Must match `installPrecache`'s `navigateFallback`\n     * so offline navigations resolve. Pass `false` to disable. Default `/index.html`.\n     */\n    appShell?: string | false;\n}\n\nfunction joinBase(base: string, file: string): string {\n    const prefix = base.endsWith(\"/\") ? base : `${base}/`;\n    return `${prefix}${file}`.replace(/([^:]\\/)\\/+/g, \"$1\");\n}\n\n/** Deterministic djb2 hash → hex. Stable across rebuilds with the same assets. */\nfunction hash(input: string): string {\n    let h = 5381;\n    for (let i = 0; i < input.length; i++) {\n        h = ((h << 5) + h + input.charCodeAt(i)) >>> 0;\n    }\n    return h.toString(16);\n}\n\n/**\n * Vite build plugin that emits a `precache-manifest.json` listing every built\n * asset (plus any `additionalUrls`) as root-absolute URLs, with a content-based\n * `version`. It is the dependency-free counterpart to Workbox's `__WB_MANIFEST`:\n * `installPrecache` (from `tempest-react-sdk/sw`) reads this file at the service\n * worker's `install` event to cache the app shell for offline use.\n *\n * @example\n * // vite.config.ts\n * import { createViteConfig, tempestPwaManifest } from \"tempest-react-sdk/vite\";\n *\n * export default createViteConfig({\n *   plugins: [tempestPwaManifest({ additionalUrls: [\"/manifest.webmanifest\", \"/icon.svg\"] })],\n * });\n */\nexport function tempestPwaManifest(options: TempestPwaManifestOptions = {}): TempestVitePlugin {\n    const {\n        fileName = \"precache-manifest.json\",\n        additionalUrls = [],\n        exclude = /\\.map$/,\n        includeHtml = true,\n        appShell = \"/index.html\",\n    } = options;\n\n    let base = \"/\";\n\n    const plugin: Plugin = {\n        name: \"tempest-pwa-manifest\",\n        apply: \"build\",\n        configResolved(config) {\n            base = config.base ?? \"/\";\n        },\n        generateBundle(_outputOptions, bundle) {\n            const urls = new Set<string>(additionalUrls);\n            // Vite may emit index.html after this hook, so guarantee the shell.\n            if (appShell) urls.add(appShell);\n            for (const file of Object.keys(bundle)) {\n                if (file === fileName) continue;\n                if (exclude.test(file)) continue;\n                if (!includeHtml && file.endsWith(\".html\")) continue;\n                urls.add(joinBase(base, file));\n            }\n\n            const list = [...urls].sort();\n            const version = hash(list.join(\"\\n\"));\n            this.emitFile({\n                type: \"asset\",\n                fileName,\n                source: JSON.stringify({ version, urls: list }),\n            });\n        },\n    };\n\n    return plugin as TempestVitePlugin;\n}\n"],"mappings":";AA8BA,SAAS,EAAS,GAAc,GAAsB;CAElD,OAAO,GADQ,EAAK,SAAS,GAAG,IAAI,IAAO,GAAG,EAAK,KAChC,IAAO,QAAQ,gBAAgB,IAAI;AAC1D;AAGA,SAAS,EAAK,GAAuB;CACjC,IAAI,IAAI;CACR,KAAK,IAAI,IAAI,GAAG,IAAI,EAAM,QAAQ,KAC9B,KAAM,KAAK,KAAK,IAAI,EAAM,WAAW,CAAC,MAAO;CAEjD,OAAO,EAAE,SAAS,EAAE;AACxB;AAiBA,SAAgB,EAAmB,IAAqC,CAAC,GAAsB;CAC3F,IAAM,EACF,cAAW,0BACX,oBAAiB,CAAC,GAClB,aAAU,UACV,iBAAc,IACd,cAAW,kBACX,GAEA,IAAO;CA6BX,OAAO;EA1BH,MAAM;EACN,OAAO;EACP,eAAe,GAAQ;GACnB,IAAO,EAAO,QAAQ;EAC1B;EACA,eAAe,GAAgB,GAAQ;GACnC,IAAM,IAAO,IAAI,IAAY,CAAc;GAE3C,AAAI,KAAU,EAAK,IAAI,CAAQ;GAC/B,KAAK,IAAM,KAAQ,OAAO,KAAK,CAAM,GAC7B,MAAS,MACT,EAAQ,KAAK,CAAI,KACjB,CAAC,KAAe,EAAK,SAAS,OAAO,KACzC,EAAK,IAAI,EAAS,GAAM,CAAI,CAAC;GAGjC,IAAM,IAAO,CAAC,GAAG,CAAI,CAAC,CAAC,KAAK,GACtB,IAAU,EAAK,EAAK,KAAK,IAAI,CAAC;GACpC,KAAK,SAAS;IACV,MAAM;IACN;IACA,QAAQ,KAAK,UAAU;KAAE;KAAS,MAAM;IAAK,CAAC;GAClD,CAAC;EACL;CAGG;AACX"}

package/dist/vite.cjs

@@ -1,2 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./vite/create-vite-config.cjs"),t=require("./vite/tempest-pwa-manifest.cjs"),s=require("./vite/tempest-pwa-icons.cjs"),a=require("./vite/tempest-pwa-dev-sw.cjs");exports.createViteConfig=e.createViteConfig;exports.tempestPwaManifest=t.tempestPwaManifest;exports.tempestPwaIcons=s.tempestPwaIcons;exports.tempestPwaDevSw=a.tempestPwaDevSw;
-//# sourceMappingURL=vite.cjs.map
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./vite/create-vite-config.cjs"),t=require("./vite/tempest-pwa-manifest.cjs"),n=require("./vite/tempest-pwa-icons.cjs"),r=require("./vite/tempest-pwa-dev-sw.cjs");exports.createViteConfig=e.createViteConfig,exports.tempestPwaDevSw=r.tempestPwaDevSw,exports.tempestPwaIcons=n.tempestPwaIcons,exports.tempestPwaManifest=t.tempestPwaManifest;

package/dist/vite.js

@@ -1,11 +1,5 @@
-import { createViteConfig as o } from "./vite/create-vite-config.js";
-import { tempestPwaManifest as m } from "./vite/tempest-pwa-manifest.js";
-import { tempestPwaIcons as f } from "./vite/tempest-pwa-icons.js";
-import { tempestPwaDevSw as s } from "./vite/tempest-pwa-dev-sw.js";
-export {
-  o as createViteConfig,
-  s as tempestPwaDevSw,
-  f as tempestPwaIcons,
-  m as tempestPwaManifest
-};
-//# sourceMappingURL=vite.js.map
+import { createViteConfig as e } from "./vite/create-vite-config.js";
+import { tempestPwaManifest as t } from "./vite/tempest-pwa-manifest.js";
+import { tempestPwaIcons as n } from "./vite/tempest-pwa-icons.js";
+import { tempestPwaDevSw as r } from "./vite/tempest-pwa-dev-sw.js";
+export { e as createViteConfig, r as tempestPwaDevSw, n as tempestPwaIcons, t as tempestPwaManifest };

package/dist/ws/create-web-socket.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});function B(a){try{return JSON.parse(a)}catch{return a}}function J(a,g={}){const{protocols:p,maxRetries:S=10,initialBackoff:m=1e3,maxBackoff:y=3e4,pingInterval:i=0,pingPayload:k=JSON.stringify({type:"ping"}),parser:b=B,onOpen:P,onMessage:O,onClose:T,onError:W,onStatusChange:h}=g;let e=null,r=null,s=null,o=0,u="idle",c=!1;function l(n){u!==n&&(u=n,h?.(n))}function f(){s&&(clearInterval(s),s=null)}function w(){!i||i<=0||(f(),s=setInterval(()=>{e?.readyState===WebSocket.OPEN&&e.send(k)},i))}function N(){if(c)return;if(o>=S){l("error");return}const n=Math.min(m*2**o,y);o+=1,r=setTimeout(d,n)}function d(){if(c)return;e&&(e.onopen=null,e.onmessage=null,e.onclose=null,e.onerror=null,e.close()),l("connecting");const n=new WebSocket(a,p);e=n,n.onopen=t=>{o=0,l("open"),w(),P?.(t)},n.onmessage=t=>{const M=typeof t.data=="string"?t.data:"";O?.({data:b(M),raw:t})},n.onerror=t=>{W?.(t)},n.onclose=t=>{f(),T?.(t),e=null,l("closed"),!c&&!t.wasClean&&N()}}function C(n){return e?.readyState!==WebSocket.OPEN?!1:(e.send(n),!0)}function E(n,t){c=!0,r&&(clearTimeout(r),r=null),f(),o=0,e&&(l("closing"),e.close(n,t),e=null),l("closed")}function I(){r&&(clearTimeout(r),r=null),o=0,c=!1,d()}return d(),{send:C,close:E,reconnect:I,get status(){return u}}}exports.createWebSocket=J;
-//# sourceMappingURL=create-web-socket.cjs.map
+function e(e){try{return JSON.parse(e)}catch{return e}}function t(t,n={}){let{protocols:r,maxRetries:i=10,initialBackoff:a=1e3,maxBackoff:o=3e4,pingInterval:s=0,pingPayload:c=JSON.stringify({type:`ping`}),parser:l=e,onOpen:u,onMessage:d,onClose:f,onError:p,onStatusChange:m}=n,h=null,g=null,_=null,v=0,y=`idle`,b=!1;function x(e){y!==e&&(y=e,m?.(e))}function S(){_&&=(clearInterval(_),null)}function C(){!s||s<=0||(S(),_=setInterval(()=>{h?.readyState===WebSocket.OPEN&&h.send(c)},s))}function w(){if(b)return;if(v>=i){x(`error`);return}let e=Math.min(a*2**v,o);v+=1,g=setTimeout(T,e)}function T(){if(b)return;h&&(h.onopen=null,h.onmessage=null,h.onclose=null,h.onerror=null,h.close()),x(`connecting`);let e=new WebSocket(t,r);h=e,e.onopen=e=>{v=0,x(`open`),C(),u?.(e)},e.onmessage=e=>{let t=typeof e.data==`string`?e.data:``;d?.({data:l(t),raw:e})},e.onerror=e=>{p?.(e)},e.onclose=e=>{S(),f?.(e),h=null,x(`closed`),!b&&!e.wasClean&&w()}}function E(e){return h?.readyState===WebSocket.OPEN?(h.send(e),!0):!1}function D(e,t){b=!0,g&&=(clearTimeout(g),null),S(),v=0,h&&=(x(`closing`),h.close(e,t),null),x(`closed`)}function O(){g&&=(clearTimeout(g),null),v=0,b=!1,T()}return T(),{send:E,close:D,reconnect:O,get status(){return y}}}exports.createWebSocket=t;
+//# sourceMappingURL=create-web-socket.cjs.map

package/dist/ws/create-web-socket.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"create-web-socket.cjs","sources":["../../src/ws/create-web-socket.ts"],"sourcesContent":["export type WebSocketStatus = \"idle\" | \"connecting\" | \"open\" | \"closing\" | \"closed\" | \"error\";\n\nexport interface WebSocketMessage<T> {\n    /** Parsed payload — JSON-decoded when possible, raw string otherwise. */\n    data: T;\n    /** The original `MessageEvent`. */\n    raw: MessageEvent;\n}\n\nexport interface CreateWebSocketOptions<T> {\n    /** Subprotocol(s) forwarded to the `WebSocket` constructor. */\n    protocols?: string | string[];\n    /** Max reconnect attempts. Default: 10. Pass 0 to disable. */\n    maxRetries?: number;\n    /** Initial backoff (ms). Doubles each attempt, capped at `maxBackoff`. Default: 1000. */\n    initialBackoff?: number;\n    /** Maximum backoff (ms). Default: 30000. */\n    maxBackoff?: number;\n    /**\n     * Ping interval (ms). When set, the client sends `pingPayload` periodically\n     * to keep the socket alive. Default: 0 (disabled).\n     */\n    pingInterval?: number;\n    /** Payload sent on each ping. Default: `JSON.stringify({ type: \"ping\" })`. */\n    pingPayload?: string | ArrayBufferLike | Blob | ArrayBufferView;\n    /** Parse incoming frames. Default: JSON with raw-string fallback. */\n    parser?: (raw: string) => T;\n    onOpen?: (event: Event) => void;\n    onMessage?: (message: WebSocketMessage<T>) => void;\n    onClose?: (event: CloseEvent) => void;\n    onError?: (event: Event) => void;\n    onStatusChange?: (status: WebSocketStatus) => void;\n}\n\nexport interface WebSocketController {\n    /** Send a payload over the current connection. No-op when not open. */\n    send: (payload: string | ArrayBufferLike | Blob | ArrayBufferView) => boolean;\n    /** Close the connection and stop reconnecting. */\n    close: (code?: number, reason?: string) => void;\n    /** Force an immediate reconnect, resetting the retry counter. */\n    reconnect: () => void;\n    /** Current connection status. */\n    readonly status: WebSocketStatus;\n}\n\nfunction defaultParser<T>(raw: string): T {\n    try {\n        return JSON.parse(raw) as T;\n    } catch {\n        return raw as unknown as T;\n    }\n}\n\n/**\n * Open a WebSocket with automatic exponential-backoff reconnect, optional\n * heartbeat pings, and typed JSON parsing.\n *\n * @param url - Full ws:// or wss:// URL.\n * @param options - Connection configuration and callbacks.\n * @returns Controller exposing `send`, `close`, `reconnect`, and `status`.\n */\nexport function createWebSocket<T = unknown>(\n    url: string,\n    options: CreateWebSocketOptions<T> = {},\n): WebSocketController {\n    const {\n        protocols,\n        maxRetries = 10,\n        initialBackoff = 1000,\n        maxBackoff = 30000,\n        pingInterval = 0,\n        pingPayload = JSON.stringify({ type: \"ping\" }),\n        parser = defaultParser<T>,\n        onOpen,\n        onMessage,\n        onClose,\n        onError,\n        onStatusChange,\n    } = options;\n\n    let socket: WebSocket | null = null;\n    let retryTimer: ReturnType<typeof setTimeout> | null = null;\n    let pingTimer: ReturnType<typeof setInterval> | null = null;\n    let retries = 0;\n    let status: WebSocketStatus = \"idle\";\n    let closed = false;\n\n    function setStatus(next: WebSocketStatus): void {\n        if (status === next) return;\n        status = next;\n        onStatusChange?.(next);\n    }\n\n    function clearPing(): void {\n        if (pingTimer) {\n            clearInterval(pingTimer);\n            pingTimer = null;\n        }\n    }\n\n    function startPing(): void {\n        if (!pingInterval || pingInterval <= 0) return;\n        clearPing();\n        pingTimer = setInterval(() => {\n            if (socket?.readyState === WebSocket.OPEN) {\n                socket.send(pingPayload);\n            }\n        }, pingInterval);\n    }\n\n    function scheduleReconnect(): void {\n        if (closed) return;\n        if (retries >= maxRetries) {\n            setStatus(\"error\");\n            return;\n        }\n        const delay = Math.min(initialBackoff * 2 ** retries, maxBackoff);\n        retries += 1;\n        retryTimer = setTimeout(connect, delay);\n    }\n\n    function connect(): void {\n        if (closed) return;\n        if (socket) {\n            socket.onopen = null;\n            socket.onmessage = null;\n            socket.onclose = null;\n            socket.onerror = null;\n            socket.close();\n        }\n        setStatus(\"connecting\");\n\n        const ws = new WebSocket(url, protocols);\n        socket = ws;\n\n        ws.onopen = (event) => {\n            retries = 0;\n            setStatus(\"open\");\n            startPing();\n            onOpen?.(event);\n        };\n\n        ws.onmessage = (event) => {\n            const raw = typeof event.data === \"string\" ? event.data : \"\";\n            onMessage?.({\n                data: parser(raw),\n                raw: event,\n            });\n        };\n\n        ws.onerror = (event) => {\n            onError?.(event);\n        };\n\n        ws.onclose = (event) => {\n            clearPing();\n            onClose?.(event);\n            socket = null;\n            setStatus(\"closed\");\n            if (!closed && !event.wasClean) {\n                scheduleReconnect();\n            }\n        };\n    }\n\n    function send(payload: string | ArrayBufferLike | Blob | ArrayBufferView): boolean {\n        if (socket?.readyState !== WebSocket.OPEN) return false;\n        socket.send(payload);\n        return true;\n    }\n\n    function close(code?: number, reason?: string): void {\n        closed = true;\n        if (retryTimer) {\n            clearTimeout(retryTimer);\n            retryTimer = null;\n        }\n        clearPing();\n        retries = 0;\n        if (socket) {\n            setStatus(\"closing\");\n            socket.close(code, reason);\n            socket = null;\n        }\n        setStatus(\"closed\");\n    }\n\n    function reconnect(): void {\n        if (retryTimer) {\n            clearTimeout(retryTimer);\n            retryTimer = null;\n        }\n        retries = 0;\n        closed = false;\n        connect();\n    }\n\n    connect();\n\n    return {\n        send,\n        close,\n        reconnect,\n        get status() {\n            return status;\n        },\n    };\n}\n"],"names":["defaultParser","raw","createWebSocket","url","options","protocols","maxRetries","initialBackoff","maxBackoff","pingInterval","pingPayload","parser","onOpen","onMessage","onClose","onError","onStatusChange","socket","retryTimer","pingTimer","retries","status","closed","setStatus","next","clearPing","startPing","scheduleReconnect","delay","connect","ws","event","send","payload","close","code","reason","reconnect"],"mappings":"gFA6CA,SAASA,EAAiBC,EAAgB,CACtC,GAAI,CACA,OAAO,KAAK,MAAMA,CAAG,CACzB,MAAQ,CACJ,OAAOA,CACX,CACJ,CAUO,SAASC,EACZC,EACAC,EAAqC,GAClB,CACnB,KAAM,CACF,UAAAC,EACA,WAAAC,EAAa,GACb,eAAAC,EAAiB,IACjB,WAAAC,EAAa,IACb,aAAAC,EAAe,EACf,YAAAC,EAAc,KAAK,UAAU,CAAE,KAAM,OAAQ,EAC7C,OAAAC,EAASX,EACT,OAAAY,EACA,UAAAC,EACA,QAAAC,EACA,QAAAC,EACA,eAAAC,CAAA,EACAZ,EAEJ,IAAIa,EAA2B,KAC3BC,EAAmD,KACnDC,EAAmD,KACnDC,EAAU,EACVC,EAA0B,OAC1BC,EAAS,GAEb,SAASC,EAAUC,EAA6B,CACxCH,IAAWG,IACfH,EAASG,EACTR,IAAiBQ,CAAI,EACzB,CAEA,SAASC,GAAkB,CACnBN,IACA,cAAcA,CAAS,EACvBA,EAAY,KAEpB,CAEA,SAASO,GAAkB,CACnB,CAACjB,GAAgBA,GAAgB,IACrCgB,EAAA,EACAN,EAAY,YAAY,IAAM,CACtBF,GAAQ,aAAe,UAAU,MACjCA,EAAO,KAAKP,CAAW,CAE/B,EAAGD,CAAY,EACnB,CAEA,SAASkB,GAA0B,CAC/B,GAAIL,EAAQ,OACZ,GAAIF,GAAWd,EAAY,CACvBiB,EAAU,OAAO,EACjB,MACJ,CACA,MAAMK,EAAQ,KAAK,IAAIrB,EAAiB,GAAKa,EAASZ,CAAU,EAChEY,GAAW,EACXF,EAAa,WAAWW,EAASD,CAAK,CAC1C,CAEA,SAASC,GAAgB,CACrB,GAAIP,EAAQ,OACRL,IACAA,EAAO,OAAS,KAChBA,EAAO,UAAY,KACnBA,EAAO,QAAU,KACjBA,EAAO,QAAU,KACjBA,EAAO,MAAA,GAEXM,EAAU,YAAY,EAEtB,MAAMO,EAAK,IAAI,UAAU3B,EAAKE,CAAS,EACvCY,EAASa,EAETA,EAAG,OAAUC,GAAU,CACnBX,EAAU,EACVG,EAAU,MAAM,EAChBG,EAAA,EACAd,IAASmB,CAAK,CAClB,EAEAD,EAAG,UAAaC,GAAU,CACtB,MAAM9B,EAAM,OAAO8B,EAAM,MAAS,SAAWA,EAAM,KAAO,GAC1DlB,IAAY,CACR,KAAMF,EAAOV,CAAG,EAChB,IAAK8B,CAAA,CACR,CACL,EAEAD,EAAG,QAAWC,GAAU,CACpBhB,IAAUgB,CAAK,CACnB,EAEAD,EAAG,QAAWC,GAAU,CACpBN,EAAA,EACAX,IAAUiB,CAAK,EACfd,EAAS,KACTM,EAAU,QAAQ,EACd,CAACD,GAAU,CAACS,EAAM,UAClBJ,EAAA,CAER,CACJ,CAEA,SAASK,EAAKC,EAAqE,CAC/E,OAAIhB,GAAQ,aAAe,UAAU,KAAa,IAClDA,EAAO,KAAKgB,CAAO,EACZ,GACX,CAEA,SAASC,EAAMC,EAAeC,EAAuB,CACjDd,EAAS,GACLJ,IACA,aAAaA,CAAU,EACvBA,EAAa,MAEjBO,EAAA,EACAL,EAAU,EACNH,IACAM,EAAU,SAAS,EACnBN,EAAO,MAAMkB,EAAMC,CAAM,EACzBnB,EAAS,MAEbM,EAAU,QAAQ,CACtB,CAEA,SAASc,GAAkB,CACnBnB,IACA,aAAaA,CAAU,EACvBA,EAAa,MAEjBE,EAAU,EACVE,EAAS,GACTO,EAAA,CACJ,CAEA,OAAAA,EAAA,EAEO,CACH,KAAAG,EACA,MAAAE,EACA,UAAAG,EACA,IAAI,QAAS,CACT,OAAOhB,CACX,CAAA,CAER"}
+{"version":3,"file":"create-web-socket.cjs","names":[],"sources":["../../src/ws/create-web-socket.ts"],"sourcesContent":["export type WebSocketStatus = \"idle\" | \"connecting\" | \"open\" | \"closing\" | \"closed\" | \"error\";\n\nexport interface WebSocketMessage<T> {\n    /** Parsed payload — JSON-decoded when possible, raw string otherwise. */\n    data: T;\n    /** The original `MessageEvent`. */\n    raw: MessageEvent;\n}\n\nexport interface CreateWebSocketOptions<T> {\n    /** Subprotocol(s) forwarded to the `WebSocket` constructor. */\n    protocols?: string | string[];\n    /** Max reconnect attempts. Default: 10. Pass 0 to disable. */\n    maxRetries?: number;\n    /** Initial backoff (ms). Doubles each attempt, capped at `maxBackoff`. Default: 1000. */\n    initialBackoff?: number;\n    /** Maximum backoff (ms). Default: 30000. */\n    maxBackoff?: number;\n    /**\n     * Ping interval (ms). When set, the client sends `pingPayload` periodically\n     * to keep the socket alive. Default: 0 (disabled).\n     */\n    pingInterval?: number;\n    /** Payload sent on each ping. Default: `JSON.stringify({ type: \"ping\" })`. */\n    pingPayload?: string | Blob | BufferSource;\n    /** Parse incoming frames. Default: JSON with raw-string fallback. */\n    parser?: (raw: string) => T;\n    onOpen?: (event: Event) => void;\n    onMessage?: (message: WebSocketMessage<T>) => void;\n    onClose?: (event: CloseEvent) => void;\n    onError?: (event: Event) => void;\n    onStatusChange?: (status: WebSocketStatus) => void;\n}\n\nexport interface WebSocketController {\n    /** Send a payload over the current connection. No-op when not open. */\n    send: (payload: string | Blob | BufferSource) => boolean;\n    /** Close the connection and stop reconnecting. */\n    close: (code?: number, reason?: string) => void;\n    /** Force an immediate reconnect, resetting the retry counter. */\n    reconnect: () => void;\n    /** Current connection status. */\n    readonly status: WebSocketStatus;\n}\n\nfunction defaultParser<T>(raw: string): T {\n    try {\n        return JSON.parse(raw) as T;\n    } catch {\n        return raw as unknown as T;\n    }\n}\n\n/**\n * Open a WebSocket with automatic exponential-backoff reconnect, optional\n * heartbeat pings, and typed JSON parsing.\n *\n * @param url - Full ws:// or wss:// URL.\n * @param options - Connection configuration and callbacks.\n * @returns Controller exposing `send`, `close`, `reconnect`, and `status`.\n */\nexport function createWebSocket<T = unknown>(\n    url: string,\n    options: CreateWebSocketOptions<T> = {},\n): WebSocketController {\n    const {\n        protocols,\n        maxRetries = 10,\n        initialBackoff = 1000,\n        maxBackoff = 30000,\n        pingInterval = 0,\n        pingPayload = JSON.stringify({ type: \"ping\" }),\n        parser = defaultParser<T>,\n        onOpen,\n        onMessage,\n        onClose,\n        onError,\n        onStatusChange,\n    } = options;\n\n    let socket: WebSocket | null = null;\n    let retryTimer: ReturnType<typeof setTimeout> | null = null;\n    let pingTimer: ReturnType<typeof setInterval> | null = null;\n    let retries = 0;\n    let status: WebSocketStatus = \"idle\";\n    let closed = false;\n\n    function setStatus(next: WebSocketStatus): void {\n        if (status === next) return;\n        status = next;\n        onStatusChange?.(next);\n    }\n\n    function clearPing(): void {\n        if (pingTimer) {\n            clearInterval(pingTimer);\n            pingTimer = null;\n        }\n    }\n\n    function startPing(): void {\n        if (!pingInterval || pingInterval <= 0) return;\n        clearPing();\n        pingTimer = setInterval(() => {\n            if (socket?.readyState === WebSocket.OPEN) {\n                socket.send(pingPayload);\n            }\n        }, pingInterval);\n    }\n\n    function scheduleReconnect(): void {\n        if (closed) return;\n        if (retries >= maxRetries) {\n            setStatus(\"error\");\n            return;\n        }\n        const delay = Math.min(initialBackoff * 2 ** retries, maxBackoff);\n        retries += 1;\n        retryTimer = setTimeout(connect, delay);\n    }\n\n    function connect(): void {\n        if (closed) return;\n        if (socket) {\n            socket.onopen = null;\n            socket.onmessage = null;\n            socket.onclose = null;\n            socket.onerror = null;\n            socket.close();\n        }\n        setStatus(\"connecting\");\n\n        const ws = new WebSocket(url, protocols);\n        socket = ws;\n\n        ws.onopen = (event) => {\n            retries = 0;\n            setStatus(\"open\");\n            startPing();\n            onOpen?.(event);\n        };\n\n        ws.onmessage = (event) => {\n            const raw = typeof event.data === \"string\" ? event.data : \"\";\n            onMessage?.({\n                data: parser(raw),\n                raw: event,\n            });\n        };\n\n        ws.onerror = (event) => {\n            onError?.(event);\n        };\n\n        ws.onclose = (event) => {\n            clearPing();\n            onClose?.(event);\n            socket = null;\n            setStatus(\"closed\");\n            if (!closed && !event.wasClean) {\n                scheduleReconnect();\n            }\n        };\n    }\n\n    function send(payload: string | Blob | BufferSource): boolean {\n        if (socket?.readyState !== WebSocket.OPEN) return false;\n        socket.send(payload);\n        return true;\n    }\n\n    function close(code?: number, reason?: string): void {\n        closed = true;\n        if (retryTimer) {\n            clearTimeout(retryTimer);\n            retryTimer = null;\n        }\n        clearPing();\n        retries = 0;\n        if (socket) {\n            setStatus(\"closing\");\n            socket.close(code, reason);\n            socket = null;\n        }\n        setStatus(\"closed\");\n    }\n\n    function reconnect(): void {\n        if (retryTimer) {\n            clearTimeout(retryTimer);\n            retryTimer = null;\n        }\n        retries = 0;\n        closed = false;\n        connect();\n    }\n\n    connect();\n\n    return {\n        send,\n        close,\n        reconnect,\n        get status() {\n            return status;\n        },\n    };\n}\n"],"mappings":"AA6CA,SAAS,EAAiB,EAAgB,CACtC,GAAI,CACA,OAAO,KAAK,MAAM,CAAG,CACzB,MAAQ,CACJ,OAAO,CACX,CACJ,CAUA,SAAgB,EACZ,EACA,EAAqC,CAAC,EACnB,CACnB,GAAM,CACF,YACA,aAAa,GACb,iBAAiB,IACjB,aAAa,IACb,eAAe,EACf,cAAc,KAAK,UAAU,CAAE,KAAM,MAAO,CAAC,EAC7C,SAAS,EACT,SACA,YACA,UACA,UACA,kBACA,EAEA,EAA2B,KAC3B,EAAmD,KACnD,EAAmD,KACnD,EAAU,EACV,EAA0B,OAC1B,EAAS,GAEb,SAAS,EAAU,EAA6B,CACxC,IAAW,IACf,EAAS,EACT,IAAiB,CAAI,EACzB,CAEA,SAAS,GAAkB,CACvB,AAEI,KADA,cAAc,CAAS,EACX,KAEpB,CAEA,SAAS,GAAkB,CACnB,CAAC,GAAgB,GAAgB,IACrC,EAAU,EACV,EAAY,gBAAkB,CACtB,GAAQ,aAAe,UAAU,MACjC,EAAO,KAAK,CAAW,CAE/B,EAAG,CAAY,EACnB,CAEA,SAAS,GAA0B,CAC/B,GAAI,EAAQ,OACZ,GAAI,GAAW,EAAY,CACvB,EAAU,OAAO,EACjB,MACJ,CACA,IAAM,EAAQ,KAAK,IAAI,EAAiB,GAAK,EAAS,CAAU,EAChE,GAAW,EACX,EAAa,WAAW,EAAS,CAAK,CAC1C,CAEA,SAAS,GAAgB,CACrB,GAAI,EAAQ,OACR,IACA,EAAO,OAAS,KAChB,EAAO,UAAY,KACnB,EAAO,QAAU,KACjB,EAAO,QAAU,KACjB,EAAO,MAAM,GAEjB,EAAU,YAAY,EAEtB,IAAM,EAAK,IAAI,UAAU,EAAK,CAAS,EACvC,EAAS,EAET,EAAG,OAAU,GAAU,CACnB,EAAU,EACV,EAAU,MAAM,EAChB,EAAU,EACV,IAAS,CAAK,CAClB,EAEA,EAAG,UAAa,GAAU,CACtB,IAAM,EAAM,OAAO,EAAM,MAAS,SAAW,EAAM,KAAO,GAC1D,IAAY,CACR,KAAM,EAAO,CAAG,EAChB,IAAK,CACT,CAAC,CACL,EAEA,EAAG,QAAW,GAAU,CACpB,IAAU,CAAK,CACnB,EAEA,EAAG,QAAW,GAAU,CACpB,EAAU,EACV,IAAU,CAAK,EACf,EAAS,KACT,EAAU,QAAQ,EACd,CAAC,GAAU,CAAC,EAAM,UAClB,EAAkB,CAE1B,CACJ,CAEA,SAAS,EAAK,EAAgD,CAG1D,OAFI,GAAQ,aAAe,UAAU,MACrC,EAAO,KAAK,CAAO,EACZ,IAF2C,EAGtD,CAEA,SAAS,EAAM,EAAe,EAAuB,CACjD,EAAS,GACT,AAEI,KADA,aAAa,CAAU,EACV,MAEjB,EAAU,EACV,EAAU,EACV,AAGI,KAFA,EAAU,SAAS,EACnB,EAAO,MAAM,EAAM,CAAM,EAChB,MAEb,EAAU,QAAQ,CACtB,CAEA,SAAS,GAAkB,CACvB,AAEI,KADA,aAAa,CAAU,EACV,MAEjB,EAAU,EACV,EAAS,GACT,EAAQ,CACZ,CAIA,OAFA,EAAQ,EAED,CACH,OACA,QACA,YACA,IAAI,QAAS,CACT,OAAO,CACX,CACJ,CACJ"}

package/dist/ws/create-web-socket.js

@@ -1,83 +1,70 @@
-function J(a) {
-  try {
-    return JSON.parse(a);
-  } catch {
-    return a;
-  }
+//#region src/ws/create-web-socket.ts
+function e(e) {
+	try {
+		return JSON.parse(e);
+	} catch {
+		return e;
+	}
 }
-function M(a, g = {}) {
-  const {
-    protocols: p,
-    maxRetries: m = 10,
-    initialBackoff: S = 1e3,
-    maxBackoff: y = 3e4,
-    pingInterval: i = 0,
-    pingPayload: k = JSON.stringify({ type: "ping" }),
-    parser: P = J,
-    onOpen: O,
-    onMessage: T,
-    onClose: b,
-    onError: h,
-    onStatusChange: w
-  } = g;
-  let e = null, r = null, c = null, o = 0, u = "idle", s = !1;
-  function l(n) {
-    u !== n && (u = n, w?.(n));
-  }
-  function f() {
-    c && (clearInterval(c), c = null);
-  }
-  function N() {
-    !i || i <= 0 || (f(), c = setInterval(() => {
-      e?.readyState === WebSocket.OPEN && e.send(k);
-    }, i));
-  }
-  function W() {
-    if (s) return;
-    if (o >= m) {
-      l("error");
-      return;
-    }
-    const n = Math.min(S * 2 ** o, y);
-    o += 1, r = setTimeout(d, n);
-  }
-  function d() {
-    if (s) return;
-    e && (e.onopen = null, e.onmessage = null, e.onclose = null, e.onerror = null, e.close()), l("connecting");
-    const n = new WebSocket(a, p);
-    e = n, n.onopen = (t) => {
-      o = 0, l("open"), N(), O?.(t);
-    }, n.onmessage = (t) => {
-      const B = typeof t.data == "string" ? t.data : "";
-      T?.({
-        data: P(B),
-        raw: t
-      });
-    }, n.onerror = (t) => {
-      h?.(t);
-    }, n.onclose = (t) => {
-      f(), b?.(t), e = null, l("closed"), !s && !t.wasClean && W();
-    };
-  }
-  function C(n) {
-    return e?.readyState !== WebSocket.OPEN ? !1 : (e.send(n), !0);
-  }
-  function E(n, t) {
-    s = !0, r && (clearTimeout(r), r = null), f(), o = 0, e && (l("closing"), e.close(n, t), e = null), l("closed");
-  }
-  function I() {
-    r && (clearTimeout(r), r = null), o = 0, s = !1, d();
-  }
-  return d(), {
-    send: C,
-    close: E,
-    reconnect: I,
-    get status() {
-      return u;
-    }
-  };
+function t(t, n = {}) {
+	let { protocols: r, maxRetries: i = 10, initialBackoff: a = 1e3, maxBackoff: o = 3e4, pingInterval: s = 0, pingPayload: c = JSON.stringify({ type: "ping" }), parser: l = e, onOpen: u, onMessage: d, onClose: f, onError: p, onStatusChange: m } = n, h = null, g = null, _ = null, v = 0, y = "idle", b = !1;
+	function x(e) {
+		y !== e && (y = e, m?.(e));
+	}
+	function S() {
+		_ &&= (clearInterval(_), null);
+	}
+	function C() {
+		!s || s <= 0 || (S(), _ = setInterval(() => {
+			h?.readyState === WebSocket.OPEN && h.send(c);
+		}, s));
+	}
+	function w() {
+		if (b) return;
+		if (v >= i) {
+			x("error");
+			return;
+		}
+		let e = Math.min(a * 2 ** v, o);
+		v += 1, g = setTimeout(T, e);
+	}
+	function T() {
+		if (b) return;
+		h && (h.onopen = null, h.onmessage = null, h.onclose = null, h.onerror = null, h.close()), x("connecting");
+		let e = new WebSocket(t, r);
+		h = e, e.onopen = (e) => {
+			v = 0, x("open"), C(), u?.(e);
+		}, e.onmessage = (e) => {
+			let t = typeof e.data == "string" ? e.data : "";
+			d?.({
+				data: l(t),
+				raw: e
+			});
+		}, e.onerror = (e) => {
+			p?.(e);
+		}, e.onclose = (e) => {
+			S(), f?.(e), h = null, x("closed"), !b && !e.wasClean && w();
+		};
+	}
+	function E(e) {
+		return h?.readyState === WebSocket.OPEN ? (h.send(e), !0) : !1;
+	}
+	function D(e, t) {
+		b = !0, g &&= (clearTimeout(g), null), S(), v = 0, h &&= (x("closing"), h.close(e, t), null), x("closed");
+	}
+	function O() {
+		g &&= (clearTimeout(g), null), v = 0, b = !1, T();
+	}
+	return T(), {
+		send: E,
+		close: D,
+		reconnect: O,
+		get status() {
+			return y;
+		}
+	};
 }
-export {
-  M as createWebSocket
-};
-//# sourceMappingURL=create-web-socket.js.map
+//#endregion
+export { t as createWebSocket };
+
+//# sourceMappingURL=create-web-socket.js.map

package/dist/ws/create-web-socket.js.map

@@ -1 +1 @@
-{"version":3,"file":"create-web-socket.js","sources":["../../src/ws/create-web-socket.ts"],"sourcesContent":["export type WebSocketStatus = \"idle\" | \"connecting\" | \"open\" | \"closing\" | \"closed\" | \"error\";\n\nexport interface WebSocketMessage<T> {\n    /** Parsed payload — JSON-decoded when possible, raw string otherwise. */\n    data: T;\n    /** The original `MessageEvent`. */\n    raw: MessageEvent;\n}\n\nexport interface CreateWebSocketOptions<T> {\n    /** Subprotocol(s) forwarded to the `WebSocket` constructor. */\n    protocols?: string | string[];\n    /** Max reconnect attempts. Default: 10. Pass 0 to disable. */\n    maxRetries?: number;\n    /** Initial backoff (ms). Doubles each attempt, capped at `maxBackoff`. Default: 1000. */\n    initialBackoff?: number;\n    /** Maximum backoff (ms). Default: 30000. */\n    maxBackoff?: number;\n    /**\n     * Ping interval (ms). When set, the client sends `pingPayload` periodically\n     * to keep the socket alive. Default: 0 (disabled).\n     */\n    pingInterval?: number;\n    /** Payload sent on each ping. Default: `JSON.stringify({ type: \"ping\" })`. */\n    pingPayload?: string | ArrayBufferLike | Blob | ArrayBufferView;\n    /** Parse incoming frames. Default: JSON with raw-string fallback. */\n    parser?: (raw: string) => T;\n    onOpen?: (event: Event) => void;\n    onMessage?: (message: WebSocketMessage<T>) => void;\n    onClose?: (event: CloseEvent) => void;\n    onError?: (event: Event) => void;\n    onStatusChange?: (status: WebSocketStatus) => void;\n}\n\nexport interface WebSocketController {\n    /** Send a payload over the current connection. No-op when not open. */\n    send: (payload: string | ArrayBufferLike | Blob | ArrayBufferView) => boolean;\n    /** Close the connection and stop reconnecting. */\n    close: (code?: number, reason?: string) => void;\n    /** Force an immediate reconnect, resetting the retry counter. */\n    reconnect: () => void;\n    /** Current connection status. */\n    readonly status: WebSocketStatus;\n}\n\nfunction defaultParser<T>(raw: string): T {\n    try {\n        return JSON.parse(raw) as T;\n    } catch {\n        return raw as unknown as T;\n    }\n}\n\n/**\n * Open a WebSocket with automatic exponential-backoff reconnect, optional\n * heartbeat pings, and typed JSON parsing.\n *\n * @param url - Full ws:// or wss:// URL.\n * @param options - Connection configuration and callbacks.\n * @returns Controller exposing `send`, `close`, `reconnect`, and `status`.\n */\nexport function createWebSocket<T = unknown>(\n    url: string,\n    options: CreateWebSocketOptions<T> = {},\n): WebSocketController {\n    const {\n        protocols,\n        maxRetries = 10,\n        initialBackoff = 1000,\n        maxBackoff = 30000,\n        pingInterval = 0,\n        pingPayload = JSON.stringify({ type: \"ping\" }),\n        parser = defaultParser<T>,\n        onOpen,\n        onMessage,\n        onClose,\n        onError,\n        onStatusChange,\n    } = options;\n\n    let socket: WebSocket | null = null;\n    let retryTimer: ReturnType<typeof setTimeout> | null = null;\n    let pingTimer: ReturnType<typeof setInterval> | null = null;\n    let retries = 0;\n    let status: WebSocketStatus = \"idle\";\n    let closed = false;\n\n    function setStatus(next: WebSocketStatus): void {\n        if (status === next) return;\n        status = next;\n        onStatusChange?.(next);\n    }\n\n    function clearPing(): void {\n        if (pingTimer) {\n            clearInterval(pingTimer);\n            pingTimer = null;\n        }\n    }\n\n    function startPing(): void {\n        if (!pingInterval || pingInterval <= 0) return;\n        clearPing();\n        pingTimer = setInterval(() => {\n            if (socket?.readyState === WebSocket.OPEN) {\n                socket.send(pingPayload);\n            }\n        }, pingInterval);\n    }\n\n    function scheduleReconnect(): void {\n        if (closed) return;\n        if (retries >= maxRetries) {\n            setStatus(\"error\");\n            return;\n        }\n        const delay = Math.min(initialBackoff * 2 ** retries, maxBackoff);\n        retries += 1;\n        retryTimer = setTimeout(connect, delay);\n    }\n\n    function connect(): void {\n        if (closed) return;\n        if (socket) {\n            socket.onopen = null;\n            socket.onmessage = null;\n            socket.onclose = null;\n            socket.onerror = null;\n            socket.close();\n        }\n        setStatus(\"connecting\");\n\n        const ws = new WebSocket(url, protocols);\n        socket = ws;\n\n        ws.onopen = (event) => {\n            retries = 0;\n            setStatus(\"open\");\n            startPing();\n            onOpen?.(event);\n        };\n\n        ws.onmessage = (event) => {\n            const raw = typeof event.data === \"string\" ? event.data : \"\";\n            onMessage?.({\n                data: parser(raw),\n                raw: event,\n            });\n        };\n\n        ws.onerror = (event) => {\n            onError?.(event);\n        };\n\n        ws.onclose = (event) => {\n            clearPing();\n            onClose?.(event);\n            socket = null;\n            setStatus(\"closed\");\n            if (!closed && !event.wasClean) {\n                scheduleReconnect();\n            }\n        };\n    }\n\n    function send(payload: string | ArrayBufferLike | Blob | ArrayBufferView): boolean {\n        if (socket?.readyState !== WebSocket.OPEN) return false;\n        socket.send(payload);\n        return true;\n    }\n\n    function close(code?: number, reason?: string): void {\n        closed = true;\n        if (retryTimer) {\n            clearTimeout(retryTimer);\n            retryTimer = null;\n        }\n        clearPing();\n        retries = 0;\n        if (socket) {\n            setStatus(\"closing\");\n            socket.close(code, reason);\n            socket = null;\n        }\n        setStatus(\"closed\");\n    }\n\n    function reconnect(): void {\n        if (retryTimer) {\n            clearTimeout(retryTimer);\n            retryTimer = null;\n        }\n        retries = 0;\n        closed = false;\n        connect();\n    }\n\n    connect();\n\n    return {\n        send,\n        close,\n        reconnect,\n        get status() {\n            return status;\n        },\n    };\n}\n"],"names":["defaultParser","raw","createWebSocket","url","options","protocols","maxRetries","initialBackoff","maxBackoff","pingInterval","pingPayload","parser","onOpen","onMessage","onClose","onError","onStatusChange","socket","retryTimer","pingTimer","retries","status","closed","setStatus","next","clearPing","startPing","scheduleReconnect","delay","connect","ws","event","send","payload","close","code","reason","reconnect"],"mappings":"AA6CA,SAASA,EAAiBC,GAAgB;AACtC,MAAI;AACA,WAAO,KAAK,MAAMA,CAAG;AAAA,EACzB,QAAQ;AACJ,WAAOA;AAAA,EACX;AACJ;AAUO,SAASC,EACZC,GACAC,IAAqC,IAClB;AACnB,QAAM;AAAA,IACF,WAAAC;AAAA,IACA,YAAAC,IAAa;AAAA,IACb,gBAAAC,IAAiB;AAAA,IACjB,YAAAC,IAAa;AAAA,IACb,cAAAC,IAAe;AAAA,IACf,aAAAC,IAAc,KAAK,UAAU,EAAE,MAAM,QAAQ;AAAA,IAC7C,QAAAC,IAASX;AAAA,IACT,QAAAY;AAAA,IACA,WAAAC;AAAA,IACA,SAAAC;AAAA,IACA,SAAAC;AAAA,IACA,gBAAAC;AAAA,EAAA,IACAZ;AAEJ,MAAIa,IAA2B,MAC3BC,IAAmD,MACnDC,IAAmD,MACnDC,IAAU,GACVC,IAA0B,QAC1BC,IAAS;AAEb,WAASC,EAAUC,GAA6B;AAC5C,IAAIH,MAAWG,MACfH,IAASG,GACTR,IAAiBQ,CAAI;AAAA,EACzB;AAEA,WAASC,IAAkB;AACvB,IAAIN,MACA,cAAcA,CAAS,GACvBA,IAAY;AAAA,EAEpB;AAEA,WAASO,IAAkB;AACvB,IAAI,CAACjB,KAAgBA,KAAgB,MACrCgB,EAAA,GACAN,IAAY,YAAY,MAAM;AAC1B,MAAIF,GAAQ,eAAe,UAAU,QACjCA,EAAO,KAAKP,CAAW;AAAA,IAE/B,GAAGD,CAAY;AAAA,EACnB;AAEA,WAASkB,IAA0B;AAC/B,QAAIL,EAAQ;AACZ,QAAIF,KAAWd,GAAY;AACvB,MAAAiB,EAAU,OAAO;AACjB;AAAA,IACJ;AACA,UAAMK,IAAQ,KAAK,IAAIrB,IAAiB,KAAKa,GAASZ,CAAU;AAChE,IAAAY,KAAW,GACXF,IAAa,WAAWW,GAASD,CAAK;AAAA,EAC1C;AAEA,WAASC,IAAgB;AACrB,QAAIP,EAAQ;AACZ,IAAIL,MACAA,EAAO,SAAS,MAChBA,EAAO,YAAY,MACnBA,EAAO,UAAU,MACjBA,EAAO,UAAU,MACjBA,EAAO,MAAA,IAEXM,EAAU,YAAY;AAEtB,UAAMO,IAAK,IAAI,UAAU3B,GAAKE,CAAS;AACvC,IAAAY,IAASa,GAETA,EAAG,SAAS,CAACC,MAAU;AACnB,MAAAX,IAAU,GACVG,EAAU,MAAM,GAChBG,EAAA,GACAd,IAASmB,CAAK;AAAA,IAClB,GAEAD,EAAG,YAAY,CAACC,MAAU;AACtB,YAAM9B,IAAM,OAAO8B,EAAM,QAAS,WAAWA,EAAM,OAAO;AAC1D,MAAAlB,IAAY;AAAA,QACR,MAAMF,EAAOV,CAAG;AAAA,QAChB,KAAK8B;AAAA,MAAA,CACR;AAAA,IACL,GAEAD,EAAG,UAAU,CAACC,MAAU;AACpB,MAAAhB,IAAUgB,CAAK;AAAA,IACnB,GAEAD,EAAG,UAAU,CAACC,MAAU;AACpB,MAAAN,EAAA,GACAX,IAAUiB,CAAK,GACfd,IAAS,MACTM,EAAU,QAAQ,GACd,CAACD,KAAU,CAACS,EAAM,YAClBJ,EAAA;AAAA,IAER;AAAA,EACJ;AAEA,WAASK,EAAKC,GAAqE;AAC/E,WAAIhB,GAAQ,eAAe,UAAU,OAAa,MAClDA,EAAO,KAAKgB,CAAO,GACZ;AAAA,EACX;AAEA,WAASC,EAAMC,GAAeC,GAAuB;AACjD,IAAAd,IAAS,IACLJ,MACA,aAAaA,CAAU,GACvBA,IAAa,OAEjBO,EAAA,GACAL,IAAU,GACNH,MACAM,EAAU,SAAS,GACnBN,EAAO,MAAMkB,GAAMC,CAAM,GACzBnB,IAAS,OAEbM,EAAU,QAAQ;AAAA,EACtB;AAEA,WAASc,IAAkB;AACvB,IAAInB,MACA,aAAaA,CAAU,GACvBA,IAAa,OAEjBE,IAAU,GACVE,IAAS,IACTO,EAAA;AAAA,EACJ;AAEA,SAAAA,EAAA,GAEO;AAAA,IACH,MAAAG;AAAA,IACA,OAAAE;AAAA,IACA,WAAAG;AAAA,IACA,IAAI,SAAS;AACT,aAAOhB;AAAA,IACX;AAAA,EAAA;AAER;"}
+{"version":3,"file":"create-web-socket.js","names":[],"sources":["../../src/ws/create-web-socket.ts"],"sourcesContent":["export type WebSocketStatus = \"idle\" | \"connecting\" | \"open\" | \"closing\" | \"closed\" | \"error\";\n\nexport interface WebSocketMessage<T> {\n    /** Parsed payload — JSON-decoded when possible, raw string otherwise. */\n    data: T;\n    /** The original `MessageEvent`. */\n    raw: MessageEvent;\n}\n\nexport interface CreateWebSocketOptions<T> {\n    /** Subprotocol(s) forwarded to the `WebSocket` constructor. */\n    protocols?: string | string[];\n    /** Max reconnect attempts. Default: 10. Pass 0 to disable. */\n    maxRetries?: number;\n    /** Initial backoff (ms). Doubles each attempt, capped at `maxBackoff`. Default: 1000. */\n    initialBackoff?: number;\n    /** Maximum backoff (ms). Default: 30000. */\n    maxBackoff?: number;\n    /**\n     * Ping interval (ms). When set, the client sends `pingPayload` periodically\n     * to keep the socket alive. Default: 0 (disabled).\n     */\n    pingInterval?: number;\n    /** Payload sent on each ping. Default: `JSON.stringify({ type: \"ping\" })`. */\n    pingPayload?: string | Blob | BufferSource;\n    /** Parse incoming frames. Default: JSON with raw-string fallback. */\n    parser?: (raw: string) => T;\n    onOpen?: (event: Event) => void;\n    onMessage?: (message: WebSocketMessage<T>) => void;\n    onClose?: (event: CloseEvent) => void;\n    onError?: (event: Event) => void;\n    onStatusChange?: (status: WebSocketStatus) => void;\n}\n\nexport interface WebSocketController {\n    /** Send a payload over the current connection. No-op when not open. */\n    send: (payload: string | Blob | BufferSource) => boolean;\n    /** Close the connection and stop reconnecting. */\n    close: (code?: number, reason?: string) => void;\n    /** Force an immediate reconnect, resetting the retry counter. */\n    reconnect: () => void;\n    /** Current connection status. */\n    readonly status: WebSocketStatus;\n}\n\nfunction defaultParser<T>(raw: string): T {\n    try {\n        return JSON.parse(raw) as T;\n    } catch {\n        return raw as unknown as T;\n    }\n}\n\n/**\n * Open a WebSocket with automatic exponential-backoff reconnect, optional\n * heartbeat pings, and typed JSON parsing.\n *\n * @param url - Full ws:// or wss:// URL.\n * @param options - Connection configuration and callbacks.\n * @returns Controller exposing `send`, `close`, `reconnect`, and `status`.\n */\nexport function createWebSocket<T = unknown>(\n    url: string,\n    options: CreateWebSocketOptions<T> = {},\n): WebSocketController {\n    const {\n        protocols,\n        maxRetries = 10,\n        initialBackoff = 1000,\n        maxBackoff = 30000,\n        pingInterval = 0,\n        pingPayload = JSON.stringify({ type: \"ping\" }),\n        parser = defaultParser<T>,\n        onOpen,\n        onMessage,\n        onClose,\n        onError,\n        onStatusChange,\n    } = options;\n\n    let socket: WebSocket | null = null;\n    let retryTimer: ReturnType<typeof setTimeout> | null = null;\n    let pingTimer: ReturnType<typeof setInterval> | null = null;\n    let retries = 0;\n    let status: WebSocketStatus = \"idle\";\n    let closed = false;\n\n    function setStatus(next: WebSocketStatus): void {\n        if (status === next) return;\n        status = next;\n        onStatusChange?.(next);\n    }\n\n    function clearPing(): void {\n        if (pingTimer) {\n            clearInterval(pingTimer);\n            pingTimer = null;\n        }\n    }\n\n    function startPing(): void {\n        if (!pingInterval || pingInterval <= 0) return;\n        clearPing();\n        pingTimer = setInterval(() => {\n            if (socket?.readyState === WebSocket.OPEN) {\n                socket.send(pingPayload);\n            }\n        }, pingInterval);\n    }\n\n    function scheduleReconnect(): void {\n        if (closed) return;\n        if (retries >= maxRetries) {\n            setStatus(\"error\");\n            return;\n        }\n        const delay = Math.min(initialBackoff * 2 ** retries, maxBackoff);\n        retries += 1;\n        retryTimer = setTimeout(connect, delay);\n    }\n\n    function connect(): void {\n        if (closed) return;\n        if (socket) {\n            socket.onopen = null;\n            socket.onmessage = null;\n            socket.onclose = null;\n            socket.onerror = null;\n            socket.close();\n        }\n        setStatus(\"connecting\");\n\n        const ws = new WebSocket(url, protocols);\n        socket = ws;\n\n        ws.onopen = (event) => {\n            retries = 0;\n            setStatus(\"open\");\n            startPing();\n            onOpen?.(event);\n        };\n\n        ws.onmessage = (event) => {\n            const raw = typeof event.data === \"string\" ? event.data : \"\";\n            onMessage?.({\n                data: parser(raw),\n                raw: event,\n            });\n        };\n\n        ws.onerror = (event) => {\n            onError?.(event);\n        };\n\n        ws.onclose = (event) => {\n            clearPing();\n            onClose?.(event);\n            socket = null;\n            setStatus(\"closed\");\n            if (!closed && !event.wasClean) {\n                scheduleReconnect();\n            }\n        };\n    }\n\n    function send(payload: string | Blob | BufferSource): boolean {\n        if (socket?.readyState !== WebSocket.OPEN) return false;\n        socket.send(payload);\n        return true;\n    }\n\n    function close(code?: number, reason?: string): void {\n        closed = true;\n        if (retryTimer) {\n            clearTimeout(retryTimer);\n            retryTimer = null;\n        }\n        clearPing();\n        retries = 0;\n        if (socket) {\n            setStatus(\"closing\");\n            socket.close(code, reason);\n            socket = null;\n        }\n        setStatus(\"closed\");\n    }\n\n    function reconnect(): void {\n        if (retryTimer) {\n            clearTimeout(retryTimer);\n            retryTimer = null;\n        }\n        retries = 0;\n        closed = false;\n        connect();\n    }\n\n    connect();\n\n    return {\n        send,\n        close,\n        reconnect,\n        get status() {\n            return status;\n        },\n    };\n}\n"],"mappings":";AA6CA,SAAS,EAAiB,GAAgB;CACtC,IAAI;EACA,OAAO,KAAK,MAAM,CAAG;CACzB,QAAQ;EACJ,OAAO;CACX;AACJ;AAUA,SAAgB,EACZ,GACA,IAAqC,CAAC,GACnB;CACnB,IAAM,EACF,cACA,gBAAa,IACb,oBAAiB,KACjB,gBAAa,KACb,kBAAe,GACf,iBAAc,KAAK,UAAU,EAAE,MAAM,OAAO,CAAC,GAC7C,YAAS,GACT,WACA,cACA,YACA,YACA,sBACA,GAEA,IAA2B,MAC3B,IAAmD,MACnD,IAAmD,MACnD,IAAU,GACV,IAA0B,QAC1B,IAAS;CAEb,SAAS,EAAU,GAA6B;EACxC,MAAW,MACf,IAAS,GACT,IAAiB,CAAI;CACzB;CAEA,SAAS,IAAkB;EACvB,AAEI,OADA,cAAc,CAAS,GACX;CAEpB;CAEA,SAAS,IAAkB;EACnB,CAAC,KAAgB,KAAgB,MACrC,EAAU,GACV,IAAY,kBAAkB;GAC1B,AAAI,GAAQ,eAAe,UAAU,QACjC,EAAO,KAAK,CAAW;EAE/B,GAAG,CAAY;CACnB;CAEA,SAAS,IAA0B;EAC/B,IAAI,GAAQ;EACZ,IAAI,KAAW,GAAY;GACvB,EAAU,OAAO;GACjB;EACJ;EACA,IAAM,IAAQ,KAAK,IAAI,IAAiB,KAAK,GAAS,CAAU;EAEhE,AADA,KAAW,GACX,IAAa,WAAW,GAAS,CAAK;CAC1C;CAEA,SAAS,IAAgB;EACrB,IAAI,GAAQ;EAQZ,AAPI,MACA,EAAO,SAAS,MAChB,EAAO,YAAY,MACnB,EAAO,UAAU,MACjB,EAAO,UAAU,MACjB,EAAO,MAAM,IAEjB,EAAU,YAAY;EAEtB,IAAM,IAAK,IAAI,UAAU,GAAK,CAAS;EAsBvC,AArBA,IAAS,GAET,EAAG,UAAU,MAAU;GAInB,AAHA,IAAU,GACV,EAAU,MAAM,GAChB,EAAU,GACV,IAAS,CAAK;EAClB,GAEA,EAAG,aAAa,MAAU;GACtB,IAAM,IAAM,OAAO,EAAM,QAAS,WAAW,EAAM,OAAO;GAC1D,IAAY;IACR,MAAM,EAAO,CAAG;IAChB,KAAK;GACT,CAAC;EACL,GAEA,EAAG,WAAW,MAAU;GACpB,IAAU,CAAK;EACnB,GAEA,EAAG,WAAW,MAAU;GAKpB,AAJA,EAAU,GACV,IAAU,CAAK,GACf,IAAS,MACT,EAAU,QAAQ,GACd,CAAC,KAAU,CAAC,EAAM,YAClB,EAAkB;EAE1B;CACJ;CAEA,SAAS,EAAK,GAAgD;EAG1D,OAFI,GAAQ,eAAe,UAAU,QACrC,EAAO,KAAK,CAAO,GACZ,MAF2C;CAGtD;CAEA,SAAS,EAAM,GAAe,GAAuB;EAajD,AAZA,IAAS,IACT,AAEI,OADA,aAAa,CAAU,GACV,OAEjB,EAAU,GACV,IAAU,GACV,AAGI,OAFA,EAAU,SAAS,GACnB,EAAO,MAAM,GAAM,CAAM,GAChB,OAEb,EAAU,QAAQ;CACtB;CAEA,SAAS,IAAkB;EAOvB,AANA,AAEI,OADA,aAAa,CAAU,GACV,OAEjB,IAAU,GACV,IAAS,IACT,EAAQ;CACZ;CAIA,OAFA,EAAQ,GAED;EACH;EACA;EACA;EACA,IAAI,SAAS;GACT,OAAO;EACX;CACJ;AACJ"}

package/dist/ws/use-web-socket.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("react"),k=require("./create-web-socket.cjs");function M(n,l={}){const{enabled:r=!0,onMessage:c,...f}=l,[S,o]=e.useState("idle"),[b,i]=e.useState(null),t=e.useRef(null),u=e.useRef(c);u.current=c,e.useEffect(()=>{if(!r||!n){o("idle");return}const s=k.createWebSocket(n,{...f,onStatusChange:o,onMessage:a=>{i(a),u.current?.(a)}});return t.current=s,()=>{s.close(),t.current=null}},[n,r]);const d=e.useCallback(s=>t.current?.send(s)??!1,[]),g=e.useCallback(()=>{t.current?.reconnect()},[]);return{status:S,lastMessage:b,send:d,reconnect:g}}exports.useWebSocket=M;
-//# sourceMappingURL=use-web-socket.cjs.map
+const e=require("./create-web-socket.cjs");let t=require("react");function n(n,r={}){let{enabled:i=!0,onMessage:a,...o}=r,[s,c]=(0,t.useState)(`idle`),[l,u]=(0,t.useState)(null),d=(0,t.useRef)(null),f=(0,t.useRef)(a);return f.current=a,(0,t.useEffect)(()=>{if(!i||!n){c(`idle`);return}let t=e.createWebSocket(n,{...o,onStatusChange:c,onMessage:e=>{u(e),f.current?.(e)}});return d.current=t,()=>{t.close(),d.current=null}},[n,i]),{status:s,lastMessage:l,send:(0,t.useCallback)(e=>d.current?.send(e)??!1,[]),reconnect:(0,t.useCallback)(()=>{d.current?.reconnect()},[])}}exports.useWebSocket=n;
+//# sourceMappingURL=use-web-socket.cjs.map

package/dist/ws/use-web-socket.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"use-web-socket.cjs","sources":["../../src/ws/use-web-socket.ts"],"sourcesContent":["import { useCallback, useEffect, useRef, useState } from \"react\";\nimport {\n    createWebSocket,\n    type CreateWebSocketOptions,\n    type WebSocketController,\n    type WebSocketMessage,\n    type WebSocketStatus,\n} from \"./create-web-socket\";\n\nexport interface UseWebSocketOptions<T> extends Omit<CreateWebSocketOptions<T>, \"onStatusChange\"> {\n    /** When false, the socket is not opened. Default: true. */\n    enabled?: boolean;\n}\n\nexport interface UseWebSocketResult<T> {\n    status: WebSocketStatus;\n    /** Last decoded frame received. */\n    lastMessage: WebSocketMessage<T> | null;\n    /** Send a payload through the active connection. Returns false when not open. */\n    send: (payload: string | ArrayBufferLike | Blob | ArrayBufferView) => boolean;\n    /** Force a reconnect, resetting the retry counter. */\n    reconnect: () => void;\n}\n\n/**\n * React hook around {@link createWebSocket}. Manages the connection lifecycle\n * for the host component and tears it down on unmount.\n */\nexport function useWebSocket<T = unknown>(\n    url: string,\n    options: UseWebSocketOptions<T> = {},\n): UseWebSocketResult<T> {\n    const { enabled = true, onMessage, ...rest } = options;\n    const [status, setStatus] = useState<WebSocketStatus>(\"idle\");\n    const [lastMessage, setLastMessage] = useState<WebSocketMessage<T> | null>(null);\n    const controllerRef = useRef<WebSocketController | null>(null);\n\n    const onMessageRef = useRef(onMessage);\n    onMessageRef.current = onMessage;\n\n    useEffect(() => {\n        if (!enabled || !url) {\n            setStatus(\"idle\");\n            return;\n        }\n\n        const controller = createWebSocket<T>(url, {\n            ...rest,\n            onStatusChange: setStatus,\n            onMessage: (message) => {\n                setLastMessage(message);\n                onMessageRef.current?.(message);\n            },\n        });\n        controllerRef.current = controller;\n\n        return () => {\n            controller.close();\n            controllerRef.current = null;\n        };\n        // eslint-disable-next-line react-hooks/exhaustive-deps\n    }, [url, enabled]);\n\n    const send = useCallback(\n        (payload: string | ArrayBufferLike | Blob | ArrayBufferView): boolean => {\n            return controllerRef.current?.send(payload) ?? false;\n        },\n        [],\n    );\n\n    const reconnect = useCallback((): void => {\n        controllerRef.current?.reconnect();\n    }, []);\n\n    return { status, lastMessage, send, reconnect };\n}\n"],"names":["useWebSocket","url","options","enabled","onMessage","rest","status","setStatus","useState","lastMessage","setLastMessage","controllerRef","useRef","onMessageRef","useEffect","controller","createWebSocket","message","send","useCallback","payload","reconnect"],"mappings":"8IA4BO,SAASA,EACZC,EACAC,EAAkC,GACb,CACrB,KAAM,CAAE,QAAAC,EAAU,GAAM,UAAAC,EAAW,GAAGC,GAASH,EACzC,CAACI,EAAQC,CAAS,EAAIC,EAAAA,SAA0B,MAAM,EACtD,CAACC,EAAaC,CAAc,EAAIF,EAAAA,SAAqC,IAAI,EACzEG,EAAgBC,EAAAA,OAAmC,IAAI,EAEvDC,EAAeD,EAAAA,OAAOR,CAAS,EACrCS,EAAa,QAAUT,EAEvBU,EAAAA,UAAU,IAAM,CACZ,GAAI,CAACX,GAAW,CAACF,EAAK,CAClBM,EAAU,MAAM,EAChB,MACJ,CAEA,MAAMQ,EAAaC,EAAAA,gBAAmBf,EAAK,CACvC,GAAGI,EACH,eAAgBE,EAChB,UAAYU,GAAY,CACpBP,EAAeO,CAAO,EACtBJ,EAAa,UAAUI,CAAO,CAClC,CAAA,CACH,EACD,OAAAN,EAAc,QAAUI,EAEjB,IAAM,CACTA,EAAW,MAAA,EACXJ,EAAc,QAAU,IAC5B,CAEJ,EAAG,CAACV,EAAKE,CAAO,CAAC,EAEjB,MAAMe,EAAOC,EAAAA,YACRC,GACUT,EAAc,SAAS,KAAKS,CAAO,GAAK,GAEnD,CAAA,CAAC,EAGCC,EAAYF,EAAAA,YAAY,IAAY,CACtCR,EAAc,SAAS,UAAA,CAC3B,EAAG,CAAA,CAAE,EAEL,MAAO,CAAE,OAAAL,EAAQ,YAAAG,EAAa,KAAAS,EAAM,UAAAG,CAAA,CACxC"}
+{"version":3,"file":"use-web-socket.cjs","names":[],"sources":["../../src/ws/use-web-socket.ts"],"sourcesContent":["import { useCallback, useEffect, useRef, useState } from \"react\";\nimport {\n    createWebSocket,\n    type CreateWebSocketOptions,\n    type WebSocketController,\n    type WebSocketMessage,\n    type WebSocketStatus,\n} from \"./create-web-socket\";\n\nexport interface UseWebSocketOptions<T> extends Omit<CreateWebSocketOptions<T>, \"onStatusChange\"> {\n    /** When false, the socket is not opened. Default: true. */\n    enabled?: boolean;\n}\n\nexport interface UseWebSocketResult<T> {\n    status: WebSocketStatus;\n    /** Last decoded frame received. */\n    lastMessage: WebSocketMessage<T> | null;\n    /** Send a payload through the active connection. Returns false when not open. */\n    send: (payload: string | Blob | BufferSource) => boolean;\n    /** Force a reconnect, resetting the retry counter. */\n    reconnect: () => void;\n}\n\n/**\n * React hook around {@link createWebSocket}. Manages the connection lifecycle\n * for the host component and tears it down on unmount.\n */\nexport function useWebSocket<T = unknown>(\n    url: string,\n    options: UseWebSocketOptions<T> = {},\n): UseWebSocketResult<T> {\n    const { enabled = true, onMessage, ...rest } = options;\n    const [status, setStatus] = useState<WebSocketStatus>(\"idle\");\n    const [lastMessage, setLastMessage] = useState<WebSocketMessage<T> | null>(null);\n    const controllerRef = useRef<WebSocketController | null>(null);\n\n    const onMessageRef = useRef(onMessage);\n    onMessageRef.current = onMessage;\n\n    useEffect(() => {\n        if (!enabled || !url) {\n            setStatus(\"idle\");\n            return;\n        }\n\n        const controller = createWebSocket<T>(url, {\n            ...rest,\n            onStatusChange: setStatus,\n            onMessage: (message) => {\n                setLastMessage(message);\n                onMessageRef.current?.(message);\n            },\n        });\n        controllerRef.current = controller;\n\n        return () => {\n            controller.close();\n            controllerRef.current = null;\n        };\n        // eslint-disable-next-line react-hooks/exhaustive-deps\n    }, [url, enabled]);\n\n    const send = useCallback((payload: string | Blob | BufferSource): boolean => {\n        return controllerRef.current?.send(payload) ?? false;\n    }, []);\n\n    const reconnect = useCallback((): void => {\n        controllerRef.current?.reconnect();\n    }, []);\n\n    return { status, lastMessage, send, reconnect };\n}\n"],"mappings":"kEA4BA,SAAgB,EACZ,EACA,EAAkC,CAAC,EACd,CACrB,GAAM,CAAE,UAAU,GAAM,YAAW,GAAG,GAAS,EACzC,CAAC,EAAQ,IAAA,EAAA,EAAA,SAAA,CAAuC,MAAM,EACtD,CAAC,EAAa,IAAA,EAAA,EAAA,SAAA,CAAuD,IAAI,EACzE,GAAA,EAAA,EAAA,OAAA,CAAmD,IAAI,EAEvD,GAAA,EAAA,EAAA,OAAA,CAAsB,CAAS,EAkCrC,MAjCA,GAAa,QAAU,GAEvB,EAAA,EAAA,UAAA,KAAgB,CACZ,GAAI,CAAC,GAAW,CAAC,EAAK,CAClB,EAAU,MAAM,EAChB,MACJ,CAEA,IAAM,EAAa,EAAA,gBAAmB,EAAK,CACvC,GAAG,EACH,eAAgB,EAChB,UAAY,GAAY,CACpB,EAAe,CAAO,EACtB,EAAa,UAAU,CAAO,CAClC,CACJ,CAAC,EAGD,MAFA,GAAc,QAAU,MAEX,CACT,EAAW,MAAM,EACjB,EAAc,QAAU,IAC5B,CAEJ,EAAG,CAAC,EAAK,CAAO,CAAC,EAUV,CAAE,SAAQ,cAAa,MAAA,EAAA,EAAA,YAAA,CARJ,GACf,EAAc,SAAS,KAAK,CAAO,GAAK,GAChD,CAAC,CAM0B,EAAM,WAAA,EAAA,EAAA,YAAA,KAJM,CACtC,EAAc,SAAS,UAAU,CACrC,EAAG,CAAC,CAEgC,CAAU,CAClD"}

package/dist/ws/use-web-socket.js

@@ -1,32 +1,33 @@
-import { useState as a, useRef as l, useEffect as m, useCallback as f } from "react";
-import { createWebSocket as p } from "./create-web-socket.js";
-function W(n, i = {}) {
-  const { enabled: s = !0, onMessage: r, ...d } = i, [g, c] = a("idle"), [M, S] = a(null), e = l(null), o = l(r);
-  o.current = r, m(() => {
-    if (!s || !n) {
-      c("idle");
-      return;
-    }
-    const t = p(n, {
-      ...d,
-      onStatusChange: c,
-      onMessage: (u) => {
-        S(u), o.current?.(u);
-      }
-    });
-    return e.current = t, () => {
-      t.close(), e.current = null;
-    };
-  }, [n, s]);
-  const b = f(
-    (t) => e.current?.send(t) ?? !1,
-    []
-  ), k = f(() => {
-    e.current?.reconnect();
-  }, []);
-  return { status: g, lastMessage: M, send: b, reconnect: k };
+import { createWebSocket as e } from "./create-web-socket.js";
+import { useCallback as t, useEffect as n, useRef as r, useState as i } from "react";
+//#region src/ws/use-web-socket.ts
+function a(a, o = {}) {
+	let { enabled: s = !0, onMessage: c, ...l } = o, [u, d] = i("idle"), [f, p] = i(null), m = r(null), h = r(c);
+	return h.current = c, n(() => {
+		if (!s || !a) {
+			d("idle");
+			return;
+		}
+		let t = e(a, {
+			...l,
+			onStatusChange: d,
+			onMessage: (e) => {
+				p(e), h.current?.(e);
+			}
+		});
+		return m.current = t, () => {
+			t.close(), m.current = null;
+		};
+	}, [a, s]), {
+		status: u,
+		lastMessage: f,
+		send: t((e) => m.current?.send(e) ?? !1, []),
+		reconnect: t(() => {
+			m.current?.reconnect();
+		}, [])
+	};
 }
-export {
-  W as useWebSocket
-};
-//# sourceMappingURL=use-web-socket.js.map
+//#endregion
+export { a as useWebSocket };
+
+//# sourceMappingURL=use-web-socket.js.map

package/dist/ws/use-web-socket.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-web-socket.js","sources":["../../src/ws/use-web-socket.ts"],"sourcesContent":["import { useCallback, useEffect, useRef, useState } from \"react\";\nimport {\n    createWebSocket,\n    type CreateWebSocketOptions,\n    type WebSocketController,\n    type WebSocketMessage,\n    type WebSocketStatus,\n} from \"./create-web-socket\";\n\nexport interface UseWebSocketOptions<T> extends Omit<CreateWebSocketOptions<T>, \"onStatusChange\"> {\n    /** When false, the socket is not opened. Default: true. */\n    enabled?: boolean;\n}\n\nexport interface UseWebSocketResult<T> {\n    status: WebSocketStatus;\n    /** Last decoded frame received. */\n    lastMessage: WebSocketMessage<T> | null;\n    /** Send a payload through the active connection. Returns false when not open. */\n    send: (payload: string | ArrayBufferLike | Blob | ArrayBufferView) => boolean;\n    /** Force a reconnect, resetting the retry counter. */\n    reconnect: () => void;\n}\n\n/**\n * React hook around {@link createWebSocket}. Manages the connection lifecycle\n * for the host component and tears it down on unmount.\n */\nexport function useWebSocket<T = unknown>(\n    url: string,\n    options: UseWebSocketOptions<T> = {},\n): UseWebSocketResult<T> {\n    const { enabled = true, onMessage, ...rest } = options;\n    const [status, setStatus] = useState<WebSocketStatus>(\"idle\");\n    const [lastMessage, setLastMessage] = useState<WebSocketMessage<T> | null>(null);\n    const controllerRef = useRef<WebSocketController | null>(null);\n\n    const onMessageRef = useRef(onMessage);\n    onMessageRef.current = onMessage;\n\n    useEffect(() => {\n        if (!enabled || !url) {\n            setStatus(\"idle\");\n            return;\n        }\n\n        const controller = createWebSocket<T>(url, {\n            ...rest,\n            onStatusChange: setStatus,\n            onMessage: (message) => {\n                setLastMessage(message);\n                onMessageRef.current?.(message);\n            },\n        });\n        controllerRef.current = controller;\n\n        return () => {\n            controller.close();\n            controllerRef.current = null;\n        };\n        // eslint-disable-next-line react-hooks/exhaustive-deps\n    }, [url, enabled]);\n\n    const send = useCallback(\n        (payload: string | ArrayBufferLike | Blob | ArrayBufferView): boolean => {\n            return controllerRef.current?.send(payload) ?? false;\n        },\n        [],\n    );\n\n    const reconnect = useCallback((): void => {\n        controllerRef.current?.reconnect();\n    }, []);\n\n    return { status, lastMessage, send, reconnect };\n}\n"],"names":["useWebSocket","url","options","enabled","onMessage","rest","status","setStatus","useState","lastMessage","setLastMessage","controllerRef","useRef","onMessageRef","useEffect","controller","createWebSocket","message","send","useCallback","payload","reconnect"],"mappings":";;AA4BO,SAASA,EACZC,GACAC,IAAkC,IACb;AACrB,QAAM,EAAE,SAAAC,IAAU,IAAM,WAAAC,GAAW,GAAGC,MAASH,GACzC,CAACI,GAAQC,CAAS,IAAIC,EAA0B,MAAM,GACtD,CAACC,GAAaC,CAAc,IAAIF,EAAqC,IAAI,GACzEG,IAAgBC,EAAmC,IAAI,GAEvDC,IAAeD,EAAOR,CAAS;AACrC,EAAAS,EAAa,UAAUT,GAEvBU,EAAU,MAAM;AACZ,QAAI,CAACX,KAAW,CAACF,GAAK;AAClB,MAAAM,EAAU,MAAM;AAChB;AAAA,IACJ;AAEA,UAAMQ,IAAaC,EAAmBf,GAAK;AAAA,MACvC,GAAGI;AAAA,MACH,gBAAgBE;AAAA,MAChB,WAAW,CAACU,MAAY;AACpB,QAAAP,EAAeO,CAAO,GACtBJ,EAAa,UAAUI,CAAO;AAAA,MAClC;AAAA,IAAA,CACH;AACD,WAAAN,EAAc,UAAUI,GAEjB,MAAM;AACT,MAAAA,EAAW,MAAA,GACXJ,EAAc,UAAU;AAAA,IAC5B;AAAA,EAEJ,GAAG,CAACV,GAAKE,CAAO,CAAC;AAEjB,QAAMe,IAAOC;AAAA,IACT,CAACC,MACUT,EAAc,SAAS,KAAKS,CAAO,KAAK;AAAA,IAEnD,CAAA;AAAA,EAAC,GAGCC,IAAYF,EAAY,MAAY;AACtC,IAAAR,EAAc,SAAS,UAAA;AAAA,EAC3B,GAAG,CAAA,CAAE;AAEL,SAAO,EAAE,QAAAL,GAAQ,aAAAG,GAAa,MAAAS,GAAM,WAAAG,EAAA;AACxC;"}
+{"version":3,"file":"use-web-socket.js","names":[],"sources":["../../src/ws/use-web-socket.ts"],"sourcesContent":["import { useCallback, useEffect, useRef, useState } from \"react\";\nimport {\n    createWebSocket,\n    type CreateWebSocketOptions,\n    type WebSocketController,\n    type WebSocketMessage,\n    type WebSocketStatus,\n} from \"./create-web-socket\";\n\nexport interface UseWebSocketOptions<T> extends Omit<CreateWebSocketOptions<T>, \"onStatusChange\"> {\n    /** When false, the socket is not opened. Default: true. */\n    enabled?: boolean;\n}\n\nexport interface UseWebSocketResult<T> {\n    status: WebSocketStatus;\n    /** Last decoded frame received. */\n    lastMessage: WebSocketMessage<T> | null;\n    /** Send a payload through the active connection. Returns false when not open. */\n    send: (payload: string | Blob | BufferSource) => boolean;\n    /** Force a reconnect, resetting the retry counter. */\n    reconnect: () => void;\n}\n\n/**\n * React hook around {@link createWebSocket}. Manages the connection lifecycle\n * for the host component and tears it down on unmount.\n */\nexport function useWebSocket<T = unknown>(\n    url: string,\n    options: UseWebSocketOptions<T> = {},\n): UseWebSocketResult<T> {\n    const { enabled = true, onMessage, ...rest } = options;\n    const [status, setStatus] = useState<WebSocketStatus>(\"idle\");\n    const [lastMessage, setLastMessage] = useState<WebSocketMessage<T> | null>(null);\n    const controllerRef = useRef<WebSocketController | null>(null);\n\n    const onMessageRef = useRef(onMessage);\n    onMessageRef.current = onMessage;\n\n    useEffect(() => {\n        if (!enabled || !url) {\n            setStatus(\"idle\");\n            return;\n        }\n\n        const controller = createWebSocket<T>(url, {\n            ...rest,\n            onStatusChange: setStatus,\n            onMessage: (message) => {\n                setLastMessage(message);\n                onMessageRef.current?.(message);\n            },\n        });\n        controllerRef.current = controller;\n\n        return () => {\n            controller.close();\n            controllerRef.current = null;\n        };\n        // eslint-disable-next-line react-hooks/exhaustive-deps\n    }, [url, enabled]);\n\n    const send = useCallback((payload: string | Blob | BufferSource): boolean => {\n        return controllerRef.current?.send(payload) ?? false;\n    }, []);\n\n    const reconnect = useCallback((): void => {\n        controllerRef.current?.reconnect();\n    }, []);\n\n    return { status, lastMessage, send, reconnect };\n}\n"],"mappings":";;;AA4BA,SAAgB,EACZ,GACA,IAAkC,CAAC,GACd;CACrB,IAAM,EAAE,aAAU,IAAM,cAAW,GAAG,MAAS,GACzC,CAAC,GAAQ,KAAa,EAA0B,MAAM,GACtD,CAAC,GAAa,KAAkB,EAAqC,IAAI,GACzE,IAAgB,EAAmC,IAAI,GAEvD,IAAe,EAAO,CAAS;CAkCrC,OAjCA,EAAa,UAAU,GAEvB,QAAgB;EACZ,IAAI,CAAC,KAAW,CAAC,GAAK;GAClB,EAAU,MAAM;GAChB;EACJ;EAEA,IAAM,IAAa,EAAmB,GAAK;GACvC,GAAG;GACH,gBAAgB;GAChB,YAAY,MAAY;IAEpB,AADA,EAAe,CAAO,GACtB,EAAa,UAAU,CAAO;GAClC;EACJ,CAAC;EAGD,OAFA,EAAc,UAAU,SAEX;GAET,AADA,EAAW,MAAM,GACjB,EAAc,UAAU;EAC5B;CAEJ,GAAG,CAAC,GAAK,CAAO,CAAC,GAUV;EAAE;EAAQ;EAAa,MARjB,GAAa,MACf,EAAc,SAAS,KAAK,CAAO,KAAK,IAChD,CAAC,CAM0B;EAAM,WAJlB,QAAwB;GACtC,EAAc,SAAS,UAAU;EACrC,GAAG,CAAC,CAEgC;CAAU;AAClD"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tempest-react-sdk",
-  "version": "0.23.0",
+  "version": "0.25.0",
   "description": "SDK público da Tempest com componentes, hooks e integrações para projetos React.",
   "type": "module",
   "license": "MIT",
@@ -81,11 +81,12 @@
       "require": "./dist/br.cjs"
     },
     "./styles.css": "./dist/styles.css",
-    "./package.json": "./package.json"
+    "./package.json": "./package.json",
+    "./utilities.css": "./dist/utilities.css"
   },
   "scripts": {
     "dev": "vite build --watch",
-    "build": "tsc -b tsconfig.build.json && vite build",
+    "build": "tsc -b tsconfig.build.json && vite build && node scripts/copy-css-assets.mjs",
     "typecheck": "tsc -b tsconfig.json --noEmit",
     "lint": "eslint .",
     "format": "prettier --write .",
@@ -118,20 +119,20 @@
     "fflate": "^0.8.3",
     "lucide-react": ">=0.400.0",
     "react-hook-form": "^7.76.0",
-    "react-router-dom": "^7.18.0",
+    "react-router": "^8.3.0",
     "zod": "^3.23.0 || ^4.0.0",
     "zustand": "^4.0.0 || ^5.0.0"
   },
   "peerDependencies": {
     "@tiptap/react": "^2.0.0 || ^3.0.0",
     "@tiptap/starter-kit": "^2.0.0 || ^3.0.0",
-    "@vitejs/plugin-react": "^4.0.0 || ^5.0.0",
+    "@vitejs/plugin-react": "^4.0.0 || ^5.0.0 || ^6.0.0",
     "leaflet": "^1.9.0",
     "onnxruntime-web": ">=1.17.0",
     "react": "^18.0.0 || ^19.0.0",
     "react-dom": "^18.0.0 || ^19.0.0",
     "recharts": "^2.0.0 || ^3.0.0",
-    "vite": "^5.0.0 || ^6.0.0 || ^7.0.0"
+    "vite": "^5.0.0 || ^6.0.0 || ^7.0.0 || ^8.0.0"
   },
   "peerDependenciesMeta": {
     "vite": {
@@ -157,43 +158,46 @@
     }
   },
   "devDependencies": {
-    "@eslint/js": "^9.36.0",
-    "@playwright/test": "^1.61.1",
-    "@size-limit/preset-small-lib": "^12.1.0",
+    "@eslint/js": "^10.0.1",
+    "@microsoft/api-extractor": "^7.58.12",
+    "@playwright/test": "^1.62.0",
+    "@size-limit/preset-small-lib": "^13.0.1",
     "@tanstack/react-query": "^5.90.0",
-    "@testing-library/jest-dom": "^6.9.1",
+    "@testing-library/jest-dom": "^7.0.0",
     "@testing-library/react": "^16.3.2",
     "@testing-library/user-event": "^14.6.1",
     "@tiptap/pm": "^3.27.1",
     "@tiptap/react": "^3.27.1",
     "@tiptap/starter-kit": "^3.27.1",
-    "@types/node": "^24.0.0",
+    "@types/node": "^26.1.1",
     "@types/react": "^19.1.0",
     "@types/react-dom": "^19.1.0",
-    "@vitejs/plugin-react": "^5.0.0",
+    "@vitejs/plugin-react": "^6.0.4",
     "@vitest/coverage-v8": "^4.1.6",
     "axe-core": "^4.12.1",
     "dexie": "^4.4.2",
-    "eslint": "^9.36.0",
-    "eslint-plugin-react-hooks": "^5.2.0",
-    "eslint-plugin-react-refresh": "^0.4.22",
+    "eslint": "^10.8.0",
+    "eslint-plugin-react-hooks": "^7.1.1",
+    "eslint-plugin-react-refresh": "^0.5.3",
+    "eslint-plugin-simple-import-sort": "^12.1.1",
+    "eslint-plugin-unused-imports": "^4.4.1",
     "fake-indexeddb": "^6.2.5",
-    "globals": "^16.0.0",
+    "globals": "^17.7.0",
     "husky": "^9.1.7",
     "jsdom": "^29.1.1",
     "lint-staged": "^17.0.5",
-    "lucide-react": "^0.575.0",
+    "lucide-react": "^1.26.0",
     "onnxruntime-web": "^1.27.0",
     "prettier": "^3.8.3",
     "react": "^19.1.0",
     "react-dom": "^19.1.0",
     "react-hook-form": "^7.76.0",
     "recharts": "^3.9.0",
-    "size-limit": "^12.1.0",
-    "typescript": "~5.9.0",
+    "size-limit": "^13.0.1",
+    "typescript": "~6.0.3",
     "typescript-eslint": "^8.45.0",
-    "vite": "^7.0.0",
-    "vite-plugin-dts": "^4.5.0",
+    "vite": "^8.1.5",
+    "vite-plugin-dts": "^5.0.3",
     "vitest": "^4.1.6",
     "zod": "^4.0.0",
     "zustand": "^5.0.0"

package/template/eslint.config.js

@@ -14,6 +14,7 @@ export default tseslint.config(
         languageOptions: {
             ecmaVersion: 2022,
             globals: globals.browser,
+            parserOptions: { tsconfigRootDir: import.meta.dirname },
         },
         plugins: {
             "react-hooks": reactHooks,
@@ -22,7 +23,13 @@ export default tseslint.config(
             "unused-imports": unusedImports,
         },
         rules: {
-            ...reactHooks.configs.recommended.rules,
+            // react-hooks v7 ships the React Compiler rules inside `recommended`
+            // (refs, set-state-in-effect, purity…). They are opinionated enough to
+            // fail a fresh app on day one, so the classic pair is enforced and the
+            // rest is opt-in: add `...reactHooks.configs.recommended.rules` here
+            // once you want the compiler-grade checks.
+            "react-hooks/rules-of-hooks": "error",
+            "react-hooks/exhaustive-deps": "warn",
             "react-refresh/only-export-components": ["warn", { allowConstantExport: true }],
             "@typescript-eslint/consistent-type-imports": "error",
             // Organize imports/exports (tempest fix).