iii-browser-sdk 0.25.0 → 0.25.1-alpha.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types-Bw5KRoof.d.mts","names":[],"sources":["../src/observe-types.ts","../src/iii-types.ts","../src/channels.ts","../src/errors.ts","../src/iii-constants.ts","../src/types.ts"],"mappings":"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"}
@@ -122,6 +122,7 @@ var ChannelReader = class {
122
122
  constructor(engineWsBase, ref) {
123
123
  this.ws = null;
124
124
  this.connected = false;
125
+ this.closedByCaller = false;
125
126
  this.messageCallbacks = [];
126
127
  this.binaryCallbacks = [];
127
128
  this.url = buildChannelUrl(engineWsBase, ref.channel_id, ref.access_key, "read");
@@ -154,17 +155,30 @@ var ChannelReader = class {
154
155
  this.binaryCallbacks.push(callback);
155
156
  this.ensureConnected();
156
157
  }
157
- /** Read all binary data from the channel until it closes. */
158
+ /**
159
+ * Read all binary data from the channel until it closes.
160
+ *
161
+ * Rejects with an `Error` carrying the close `code` and `reason` when the
162
+ * channel ends abnormally (the writer aborted or the connection was lost).
163
+ */
158
164
  async readAll() {
159
165
  this.ensureConnected();
160
166
  const chunks = [];
161
- return new Promise((resolve) => {
167
+ return new Promise((resolve, reject) => {
162
168
  const onData = (data) => {
163
169
  chunks.push(data);
164
170
  };
165
171
  this.binaryCallbacks.push(onData);
166
172
  const originalWs = this.ws;
167
- if (originalWs) originalWs.addEventListener("close", () => {
173
+ if (originalWs) originalWs.addEventListener("close", (event) => {
174
+ if (!this.closedByCaller && event.code !== 1e3 && event.code !== 1005) {
175
+ const detail = event.reason ? `: ${event.reason}` : "";
176
+ reject(Object.assign(/* @__PURE__ */ new Error(`Channel closed abnormally with code ${event.code}${detail}`), {
177
+ code: event.code,
178
+ reason: event.reason
179
+ }));
180
+ return;
181
+ }
168
182
  const totalLength = chunks.reduce((sum, c) => sum + c.length, 0);
169
183
  const result = new Uint8Array(totalLength);
170
184
  let offset = 0;
@@ -178,7 +192,10 @@ var ChannelReader = class {
178
192
  }
179
193
  /** Close the channel reader. */
180
194
  close() {
181
- if (this.ws && this.ws.readyState !== WebSocket.CLOSED) this.ws.close(1e3, "channel_close");
195
+ if (this.ws && this.ws.readyState !== WebSocket.CLOSED) {
196
+ this.closedByCaller = true;
197
+ this.ws.close(1e3, "channel_close");
198
+ }
182
199
  }
183
200
  };
184
201
  function buildChannelUrl(engineWsBase, channelId, accessKey, direction) {
@@ -324,4 +341,4 @@ Object.defineProperty(exports, 'utf8ByteLength', {
324
341
  return utf8ByteLength;
325
342
  }
326
343
  });
327
- //# sourceMappingURL=utils-BUI0XQTZ.cjs.map
344
+ //# sourceMappingURL=utils-Cy-Lu8WQ.cjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"utils-Cy-Lu8WQ.cjs","names":[],"sources":["../src/channels.ts","../src/utils.ts"],"sourcesContent":["import type { StreamChannelRef } from './iii-types'\n\n/**\n * Direction of a streaming channel endpoint. Mirrors the Rust SDK's\n * `ChannelDirection` enum and matches the literal values used by\n * {@link StreamChannelRef.direction}.\n */\nexport const ChannelDirection = {\n Read: 'read',\n Write: 'write',\n} as const\nexport type ChannelDirection = (typeof ChannelDirection)[keyof typeof ChannelDirection]\n\n/**\n * Discriminated runtime tag for an item observed on a streaming channel.\n * Mirrors the Rust SDK's `ChannelItem` enum (`Text` / `Binary`). Carrier for\n * factory + type-guard helpers so callers can construct and discriminate\n * channel items without depending on Rust-specific shape.\n */\nexport type ChannelItem =\n | { type: 'text'; value: string }\n | { type: 'binary'; value: Uint8Array }\n\nexport const ChannelItem = {\n /** Construct a text channel item. */\n Text(value: string): ChannelItem {\n return { type: 'text', value }\n },\n /** Construct a binary channel item. */\n Binary(value: Uint8Array): ChannelItem {\n return { type: 'binary', value }\n },\n} as const\n\n/**\n * Write end of a streaming channel. Uses native browser WebSocket.\n *\n * @example\n * ```typescript\n * import { createChannel } from 'iii-browser-sdk/helpers'\n * const channel = await createChannel(iii)\n *\n * channel.writer.sendMessage(JSON.stringify({ type: 'event', data: 'test' }))\n * channel.writer.sendBinary(new Uint8Array([1, 2, 3]))\n * channel.writer.close()\n * ```\n */\nexport class ChannelWriter {\n private static readonly FRAME_SIZE = 64 * 1024\n private ws: WebSocket | null = null\n private wsReady = false\n private readonly pendingMessages: {\n data: ArrayBuffer | string\n resolve: () => void\n reject: (err: Error) => void\n }[] = []\n private readonly url: string\n\n constructor(engineWsBase: string, ref: StreamChannelRef) {\n this.url = buildChannelUrl(engineWsBase, ref.channel_id, ref.access_key, 'write')\n }\n\n private ensureConnected(): void {\n if (this.ws) return\n\n this.ws = new WebSocket(this.url)\n this.ws.binaryType = 'arraybuffer'\n\n this.ws.addEventListener('open', () => {\n this.wsReady = true\n for (const { data, resolve, reject } of this.pendingMessages) {\n try {\n this.ws?.send(data)\n resolve()\n } catch (err) {\n reject(err instanceof Error ? err : new Error(String(err)))\n }\n }\n this.pendingMessages.length = 0\n })\n\n this.ws.addEventListener('error', () => {\n for (const { reject } of this.pendingMessages) {\n reject(new Error('WebSocket error'))\n }\n this.pendingMessages.length = 0\n })\n }\n\n /** Send a text message through the channel. */\n sendMessage(msg: string): void {\n this.ensureConnected()\n this.sendRaw(msg)\n }\n\n /** Send binary data through the channel. */\n sendBinary(data: Uint8Array): void {\n this.ensureConnected()\n\n let offset = 0\n while (offset < data.length) {\n const end = Math.min(offset + ChannelWriter.FRAME_SIZE, data.length)\n const chunk = data.subarray(offset, end)\n const buffer = chunk.buffer instanceof ArrayBuffer ? chunk.buffer : new ArrayBuffer(chunk.byteLength)\n if (!(chunk.buffer instanceof ArrayBuffer)) {\n new Uint8Array(buffer).set(chunk)\n }\n this.sendRaw(buffer.slice(chunk.byteOffset, chunk.byteOffset + chunk.byteLength))\n offset = end\n }\n }\n\n /** Close the channel writer. */\n close(): void {\n if (!this.ws) return\n\n const doClose = () => {\n if (this.ws && this.ws.readyState === WebSocket.OPEN) {\n this.ws.close(1000, 'channel_close')\n }\n }\n\n if (this.wsReady) {\n doClose()\n } else {\n this.ws.addEventListener('open', () => doClose())\n }\n }\n\n private sendRaw(data: ArrayBuffer | string): void {\n if (this.wsReady && this.ws && this.ws.readyState === WebSocket.OPEN) {\n this.ws.send(data)\n } else {\n this.ensureConnected()\n this.pendingMessages.push({\n data,\n resolve: () => {\n //\n },\n reject: () => {\n console.error('Failed to send message')\n },\n })\n }\n }\n}\n\n/**\n * Read end of a streaming channel. Uses native browser WebSocket.\n *\n * @example\n * ```typescript\n * import { createChannel } from 'iii-browser-sdk/helpers'\n * const channel = await createChannel(iii)\n *\n * channel.reader.onMessage((msg) => console.log('Got:', msg))\n * channel.reader.onBinary((data) => console.log('Binary:', data.byteLength))\n * ```\n */\nexport class ChannelReader {\n private ws: WebSocket | null = null\n private connected = false\n private closedByCaller = false\n private readonly messageCallbacks: Array<(msg: string) => void> = []\n private readonly binaryCallbacks: Array<(data: Uint8Array) => void> = []\n private readonly url: string\n\n constructor(engineWsBase: string, ref: StreamChannelRef) {\n this.url = buildChannelUrl(engineWsBase, ref.channel_id, ref.access_key, 'read')\n }\n\n private ensureConnected(): void {\n if (this.connected) return\n this.connected = true\n\n this.ws = new WebSocket(this.url)\n this.ws.binaryType = 'arraybuffer'\n\n this.ws.addEventListener('message', (event: MessageEvent) => {\n if (event.data instanceof ArrayBuffer) {\n const data = new Uint8Array(event.data)\n for (const cb of this.binaryCallbacks) {\n cb(data)\n }\n } else if (typeof event.data === 'string') {\n for (const cb of this.messageCallbacks) {\n cb(event.data)\n }\n }\n })\n\n this.ws.addEventListener('close', () => {\n this.ws = null\n })\n\n this.ws.addEventListener('error', () => {\n this.ws = null\n })\n }\n\n /** Register a callback to receive text messages from the channel. */\n onMessage(callback: (msg: string) => void): void {\n this.messageCallbacks.push(callback)\n this.ensureConnected()\n }\n\n /** Register a callback to receive binary data from the channel. */\n onBinary(callback: (data: Uint8Array) => void): void {\n this.binaryCallbacks.push(callback)\n this.ensureConnected()\n }\n\n /**\n * Read all binary data from the channel until it closes.\n *\n * Rejects with an `Error` carrying the close `code` and `reason` when the\n * channel ends abnormally (the writer aborted or the connection was lost).\n */\n async readAll(): Promise<Uint8Array> {\n this.ensureConnected()\n const chunks: Uint8Array[] = []\n\n return new Promise<Uint8Array>((resolve, reject) => {\n const onData = (data: Uint8Array) => {\n chunks.push(data)\n }\n this.binaryCallbacks.push(onData)\n\n const originalWs = this.ws\n if (originalWs) {\n originalWs.addEventListener('close', (event: CloseEvent) => {\n // 1000 or no status (1005, the engine's plain Close) is end of stream; our own close is never an error\n if (!this.closedByCaller && event.code !== 1000 && event.code !== 1005) {\n const detail = event.reason ? `: ${event.reason}` : ''\n reject(\n Object.assign(new Error(`Channel closed abnormally with code ${event.code}${detail}`), {\n code: event.code,\n reason: event.reason,\n }),\n )\n return\n }\n const totalLength = chunks.reduce((sum, c) => sum + c.length, 0)\n const result = new Uint8Array(totalLength)\n let offset = 0\n for (const chunk of chunks) {\n result.set(chunk, offset)\n offset += chunk.length\n }\n resolve(result)\n })\n }\n })\n }\n\n /** Close the channel reader. */\n close(): void {\n if (this.ws && this.ws.readyState !== WebSocket.CLOSED) {\n // only an open socket is ours to close; a flag set with none would mask a later read's abort\n this.closedByCaller = true\n this.ws.close(1000, 'channel_close')\n }\n }\n}\n\nfunction buildChannelUrl(\n engineWsBase: string,\n channelId: string,\n accessKey: string,\n direction: 'read' | 'write',\n): string {\n const base = engineWsBase.replace(/\\/$/, '')\n return `${base}/ws/channels/${channelId}?key=${encodeURIComponent(accessKey)}&dir=${direction}`\n}\n","import type { StreamChannelRef } from './iii-types'\n\n/**\n * Safely stringify a value, handling circular references, BigInt, and other edge cases.\n * Returns \"[unserializable]\" if serialization fails for any reason.\n */\nexport function safeStringify(value: unknown): string {\n const seen = new WeakSet<object>()\n\n try {\n return JSON.stringify(value, (_key, val) => {\n if (typeof val === 'bigint') {\n return val.toString()\n }\n\n if (val !== null && typeof val === 'object') {\n if (seen.has(val)) {\n return '[Circular]'\n }\n seen.add(val)\n }\n\n return val\n })\n } catch {\n return '[unserializable]'\n }\n}\n\n/**\n * Type guard that checks if a value is a {@link StreamChannelRef}.\n *\n * @param value - Value to check.\n * @returns `true` if the value is a valid `StreamChannelRef`.\n */\nexport const isChannelRef = (value: unknown): value is StreamChannelRef => {\n if (typeof value !== 'object' || value === null) return false\n const maybe = value as Partial<StreamChannelRef>\n return (\n typeof maybe.channel_id === 'string' &&\n typeof maybe.access_key === 'string' &&\n (maybe.direction === 'read' || maybe.direction === 'write')\n )\n}\n\n/**\n * Recursively extract all {@link StreamChannelRef} values from a JSON-like\n * input, returning each match paired with its dotted/bracketed path. Mirrors\n * the Rust SDK's `extract_channel_refs`.\n *\n * @param data - Arbitrary JSON-like value.\n * @returns Array of `[path, ref]` tuples. Empty when no refs are found.\n */\nexport const extractChannelRefs = (data: unknown): Array<[string, StreamChannelRef]> => {\n const refs: Array<[string, StreamChannelRef]> = []\n extractRefsRecursive(data, '', refs)\n return refs\n}\n\nconst extractRefsRecursive = (\n data: unknown,\n prefix: string,\n refs: Array<[string, StreamChannelRef]>,\n): void => {\n if (isChannelRef(data)) {\n refs.push([prefix, data])\n return\n }\n if (Array.isArray(data)) {\n for (let i = 0; i < data.length; i++) {\n const path = prefix === '' ? `[${i}]` : `${prefix}[${i}]`\n extractRefsRecursive(data[i], path, refs)\n }\n return\n }\n if (typeof data !== 'object' || data === null) return\n\n for (const [key, value] of Object.entries(data as Record<string, unknown>)) {\n const path = prefix === '' ? key : `${prefix}.${key}`\n extractRefsRecursive(value, path, refs)\n }\n}\n\n/**\n * Generate an RFC 4122 v4 UUID.\n *\n * `crypto.randomUUID` is only defined in secure contexts (https / localhost),\n * so pages served over plain http from a LAN address would throw on every\n * invocation. Fall back to building the UUID from `crypto.getRandomValues`,\n * which is available in insecure contexts and uses the same CSPRNG. The\n * engine parses invocation ids as UUIDs, so the fallback must be a real one.\n */\nexport function randomUUID(): string {\n if (typeof crypto.randomUUID === 'function') return crypto.randomUUID()\n const bytes = crypto.getRandomValues(new Uint8Array(16))\n bytes[6] = (bytes[6] & 0x0f) | 0x40\n bytes[8] = (bytes[8] & 0x3f) | 0x80\n const hex = Array.from(bytes, (b) => b.toString(16).padStart(2, '0')).join('')\n return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`\n}\n\n/** UTF-8 byte length of a string, without `Buffer` or an encoder allocation. */\nexport function utf8ByteLength(s: string): number {\n let bytes = 0\n for (let i = 0; i < s.length; i++) {\n const c = s.charCodeAt(i)\n if (c < 0x80) bytes += 1\n else if (c < 0x800) bytes += 2\n else if (c >= 0xd800 && c <= 0xdbff && i + 1 < s.length) {\n const d = s.charCodeAt(i + 1)\n if (d >= 0xdc00 && d <= 0xdfff) {\n bytes += 4\n i++\n } else {\n bytes += 3\n }\n } else bytes += 3\n }\n return bytes\n}\n\n/**\n * Lets a timer not hold the process open where timers can be unreferenced\n * (Node, which runs this SDK in tests and server-side rendering). A no-op in\n * a browser, where a timer is a number.\n */\nexport function unrefTimer(timer: unknown): void {\n ;(timer as { unref?: () => void } | undefined)?.unref?.()\n}\n"],"mappings":"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"}
@@ -121,6 +121,7 @@ var ChannelReader = class {
121
121
  constructor(engineWsBase, ref) {
122
122
  this.ws = null;
123
123
  this.connected = false;
124
+ this.closedByCaller = false;
124
125
  this.messageCallbacks = [];
125
126
  this.binaryCallbacks = [];
126
127
  this.url = buildChannelUrl(engineWsBase, ref.channel_id, ref.access_key, "read");
@@ -153,17 +154,30 @@ var ChannelReader = class {
153
154
  this.binaryCallbacks.push(callback);
154
155
  this.ensureConnected();
155
156
  }
156
- /** Read all binary data from the channel until it closes. */
157
+ /**
158
+ * Read all binary data from the channel until it closes.
159
+ *
160
+ * Rejects with an `Error` carrying the close `code` and `reason` when the
161
+ * channel ends abnormally (the writer aborted or the connection was lost).
162
+ */
157
163
  async readAll() {
158
164
  this.ensureConnected();
159
165
  const chunks = [];
160
- return new Promise((resolve) => {
166
+ return new Promise((resolve, reject) => {
161
167
  const onData = (data) => {
162
168
  chunks.push(data);
163
169
  };
164
170
  this.binaryCallbacks.push(onData);
165
171
  const originalWs = this.ws;
166
- if (originalWs) originalWs.addEventListener("close", () => {
172
+ if (originalWs) originalWs.addEventListener("close", (event) => {
173
+ if (!this.closedByCaller && event.code !== 1e3 && event.code !== 1005) {
174
+ const detail = event.reason ? `: ${event.reason}` : "";
175
+ reject(Object.assign(/* @__PURE__ */ new Error(`Channel closed abnormally with code ${event.code}${detail}`), {
176
+ code: event.code,
177
+ reason: event.reason
178
+ }));
179
+ return;
180
+ }
167
181
  const totalLength = chunks.reduce((sum, c) => sum + c.length, 0);
168
182
  const result = new Uint8Array(totalLength);
169
183
  let offset = 0;
@@ -177,7 +191,10 @@ var ChannelReader = class {
177
191
  }
178
192
  /** Close the channel reader. */
179
193
  close() {
180
- if (this.ws && this.ws.readyState !== WebSocket.CLOSED) this.ws.close(1e3, "channel_close");
194
+ if (this.ws && this.ws.readyState !== WebSocket.CLOSED) {
195
+ this.closedByCaller = true;
196
+ this.ws.close(1e3, "channel_close");
197
+ }
181
198
  }
182
199
  };
183
200
  function buildChannelUrl(engineWsBase, channelId, accessKey, direction) {
@@ -270,4 +287,4 @@ function unrefTimer(timer) {
270
287
 
271
288
  //#endregion
272
289
  export { utf8ByteLength as a, ChannelReader as c, unrefTimer as i, ChannelWriter as l, isChannelRef as n, ChannelDirection as o, randomUUID as r, ChannelItem as s, extractChannelRefs as t };
273
- //# sourceMappingURL=utils-Bz5eP_hN.mjs.map
290
+ //# sourceMappingURL=utils-CyT9CwWA.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"utils-CyT9CwWA.mjs","names":[],"sources":["../src/channels.ts","../src/utils.ts"],"sourcesContent":["import type { StreamChannelRef } from './iii-types'\n\n/**\n * Direction of a streaming channel endpoint. Mirrors the Rust SDK's\n * `ChannelDirection` enum and matches the literal values used by\n * {@link StreamChannelRef.direction}.\n */\nexport const ChannelDirection = {\n Read: 'read',\n Write: 'write',\n} as const\nexport type ChannelDirection = (typeof ChannelDirection)[keyof typeof ChannelDirection]\n\n/**\n * Discriminated runtime tag for an item observed on a streaming channel.\n * Mirrors the Rust SDK's `ChannelItem` enum (`Text` / `Binary`). Carrier for\n * factory + type-guard helpers so callers can construct and discriminate\n * channel items without depending on Rust-specific shape.\n */\nexport type ChannelItem =\n | { type: 'text'; value: string }\n | { type: 'binary'; value: Uint8Array }\n\nexport const ChannelItem = {\n /** Construct a text channel item. */\n Text(value: string): ChannelItem {\n return { type: 'text', value }\n },\n /** Construct a binary channel item. */\n Binary(value: Uint8Array): ChannelItem {\n return { type: 'binary', value }\n },\n} as const\n\n/**\n * Write end of a streaming channel. Uses native browser WebSocket.\n *\n * @example\n * ```typescript\n * import { createChannel } from 'iii-browser-sdk/helpers'\n * const channel = await createChannel(iii)\n *\n * channel.writer.sendMessage(JSON.stringify({ type: 'event', data: 'test' }))\n * channel.writer.sendBinary(new Uint8Array([1, 2, 3]))\n * channel.writer.close()\n * ```\n */\nexport class ChannelWriter {\n private static readonly FRAME_SIZE = 64 * 1024\n private ws: WebSocket | null = null\n private wsReady = false\n private readonly pendingMessages: {\n data: ArrayBuffer | string\n resolve: () => void\n reject: (err: Error) => void\n }[] = []\n private readonly url: string\n\n constructor(engineWsBase: string, ref: StreamChannelRef) {\n this.url = buildChannelUrl(engineWsBase, ref.channel_id, ref.access_key, 'write')\n }\n\n private ensureConnected(): void {\n if (this.ws) return\n\n this.ws = new WebSocket(this.url)\n this.ws.binaryType = 'arraybuffer'\n\n this.ws.addEventListener('open', () => {\n this.wsReady = true\n for (const { data, resolve, reject } of this.pendingMessages) {\n try {\n this.ws?.send(data)\n resolve()\n } catch (err) {\n reject(err instanceof Error ? err : new Error(String(err)))\n }\n }\n this.pendingMessages.length = 0\n })\n\n this.ws.addEventListener('error', () => {\n for (const { reject } of this.pendingMessages) {\n reject(new Error('WebSocket error'))\n }\n this.pendingMessages.length = 0\n })\n }\n\n /** Send a text message through the channel. */\n sendMessage(msg: string): void {\n this.ensureConnected()\n this.sendRaw(msg)\n }\n\n /** Send binary data through the channel. */\n sendBinary(data: Uint8Array): void {\n this.ensureConnected()\n\n let offset = 0\n while (offset < data.length) {\n const end = Math.min(offset + ChannelWriter.FRAME_SIZE, data.length)\n const chunk = data.subarray(offset, end)\n const buffer = chunk.buffer instanceof ArrayBuffer ? chunk.buffer : new ArrayBuffer(chunk.byteLength)\n if (!(chunk.buffer instanceof ArrayBuffer)) {\n new Uint8Array(buffer).set(chunk)\n }\n this.sendRaw(buffer.slice(chunk.byteOffset, chunk.byteOffset + chunk.byteLength))\n offset = end\n }\n }\n\n /** Close the channel writer. */\n close(): void {\n if (!this.ws) return\n\n const doClose = () => {\n if (this.ws && this.ws.readyState === WebSocket.OPEN) {\n this.ws.close(1000, 'channel_close')\n }\n }\n\n if (this.wsReady) {\n doClose()\n } else {\n this.ws.addEventListener('open', () => doClose())\n }\n }\n\n private sendRaw(data: ArrayBuffer | string): void {\n if (this.wsReady && this.ws && this.ws.readyState === WebSocket.OPEN) {\n this.ws.send(data)\n } else {\n this.ensureConnected()\n this.pendingMessages.push({\n data,\n resolve: () => {\n //\n },\n reject: () => {\n console.error('Failed to send message')\n },\n })\n }\n }\n}\n\n/**\n * Read end of a streaming channel. Uses native browser WebSocket.\n *\n * @example\n * ```typescript\n * import { createChannel } from 'iii-browser-sdk/helpers'\n * const channel = await createChannel(iii)\n *\n * channel.reader.onMessage((msg) => console.log('Got:', msg))\n * channel.reader.onBinary((data) => console.log('Binary:', data.byteLength))\n * ```\n */\nexport class ChannelReader {\n private ws: WebSocket | null = null\n private connected = false\n private closedByCaller = false\n private readonly messageCallbacks: Array<(msg: string) => void> = []\n private readonly binaryCallbacks: Array<(data: Uint8Array) => void> = []\n private readonly url: string\n\n constructor(engineWsBase: string, ref: StreamChannelRef) {\n this.url = buildChannelUrl(engineWsBase, ref.channel_id, ref.access_key, 'read')\n }\n\n private ensureConnected(): void {\n if (this.connected) return\n this.connected = true\n\n this.ws = new WebSocket(this.url)\n this.ws.binaryType = 'arraybuffer'\n\n this.ws.addEventListener('message', (event: MessageEvent) => {\n if (event.data instanceof ArrayBuffer) {\n const data = new Uint8Array(event.data)\n for (const cb of this.binaryCallbacks) {\n cb(data)\n }\n } else if (typeof event.data === 'string') {\n for (const cb of this.messageCallbacks) {\n cb(event.data)\n }\n }\n })\n\n this.ws.addEventListener('close', () => {\n this.ws = null\n })\n\n this.ws.addEventListener('error', () => {\n this.ws = null\n })\n }\n\n /** Register a callback to receive text messages from the channel. */\n onMessage(callback: (msg: string) => void): void {\n this.messageCallbacks.push(callback)\n this.ensureConnected()\n }\n\n /** Register a callback to receive binary data from the channel. */\n onBinary(callback: (data: Uint8Array) => void): void {\n this.binaryCallbacks.push(callback)\n this.ensureConnected()\n }\n\n /**\n * Read all binary data from the channel until it closes.\n *\n * Rejects with an `Error` carrying the close `code` and `reason` when the\n * channel ends abnormally (the writer aborted or the connection was lost).\n */\n async readAll(): Promise<Uint8Array> {\n this.ensureConnected()\n const chunks: Uint8Array[] = []\n\n return new Promise<Uint8Array>((resolve, reject) => {\n const onData = (data: Uint8Array) => {\n chunks.push(data)\n }\n this.binaryCallbacks.push(onData)\n\n const originalWs = this.ws\n if (originalWs) {\n originalWs.addEventListener('close', (event: CloseEvent) => {\n // 1000 or no status (1005, the engine's plain Close) is end of stream; our own close is never an error\n if (!this.closedByCaller && event.code !== 1000 && event.code !== 1005) {\n const detail = event.reason ? `: ${event.reason}` : ''\n reject(\n Object.assign(new Error(`Channel closed abnormally with code ${event.code}${detail}`), {\n code: event.code,\n reason: event.reason,\n }),\n )\n return\n }\n const totalLength = chunks.reduce((sum, c) => sum + c.length, 0)\n const result = new Uint8Array(totalLength)\n let offset = 0\n for (const chunk of chunks) {\n result.set(chunk, offset)\n offset += chunk.length\n }\n resolve(result)\n })\n }\n })\n }\n\n /** Close the channel reader. */\n close(): void {\n if (this.ws && this.ws.readyState !== WebSocket.CLOSED) {\n // only an open socket is ours to close; a flag set with none would mask a later read's abort\n this.closedByCaller = true\n this.ws.close(1000, 'channel_close')\n }\n }\n}\n\nfunction buildChannelUrl(\n engineWsBase: string,\n channelId: string,\n accessKey: string,\n direction: 'read' | 'write',\n): string {\n const base = engineWsBase.replace(/\\/$/, '')\n return `${base}/ws/channels/${channelId}?key=${encodeURIComponent(accessKey)}&dir=${direction}`\n}\n","import type { StreamChannelRef } from './iii-types'\n\n/**\n * Safely stringify a value, handling circular references, BigInt, and other edge cases.\n * Returns \"[unserializable]\" if serialization fails for any reason.\n */\nexport function safeStringify(value: unknown): string {\n const seen = new WeakSet<object>()\n\n try {\n return JSON.stringify(value, (_key, val) => {\n if (typeof val === 'bigint') {\n return val.toString()\n }\n\n if (val !== null && typeof val === 'object') {\n if (seen.has(val)) {\n return '[Circular]'\n }\n seen.add(val)\n }\n\n return val\n })\n } catch {\n return '[unserializable]'\n }\n}\n\n/**\n * Type guard that checks if a value is a {@link StreamChannelRef}.\n *\n * @param value - Value to check.\n * @returns `true` if the value is a valid `StreamChannelRef`.\n */\nexport const isChannelRef = (value: unknown): value is StreamChannelRef => {\n if (typeof value !== 'object' || value === null) return false\n const maybe = value as Partial<StreamChannelRef>\n return (\n typeof maybe.channel_id === 'string' &&\n typeof maybe.access_key === 'string' &&\n (maybe.direction === 'read' || maybe.direction === 'write')\n )\n}\n\n/**\n * Recursively extract all {@link StreamChannelRef} values from a JSON-like\n * input, returning each match paired with its dotted/bracketed path. Mirrors\n * the Rust SDK's `extract_channel_refs`.\n *\n * @param data - Arbitrary JSON-like value.\n * @returns Array of `[path, ref]` tuples. Empty when no refs are found.\n */\nexport const extractChannelRefs = (data: unknown): Array<[string, StreamChannelRef]> => {\n const refs: Array<[string, StreamChannelRef]> = []\n extractRefsRecursive(data, '', refs)\n return refs\n}\n\nconst extractRefsRecursive = (\n data: unknown,\n prefix: string,\n refs: Array<[string, StreamChannelRef]>,\n): void => {\n if (isChannelRef(data)) {\n refs.push([prefix, data])\n return\n }\n if (Array.isArray(data)) {\n for (let i = 0; i < data.length; i++) {\n const path = prefix === '' ? `[${i}]` : `${prefix}[${i}]`\n extractRefsRecursive(data[i], path, refs)\n }\n return\n }\n if (typeof data !== 'object' || data === null) return\n\n for (const [key, value] of Object.entries(data as Record<string, unknown>)) {\n const path = prefix === '' ? key : `${prefix}.${key}`\n extractRefsRecursive(value, path, refs)\n }\n}\n\n/**\n * Generate an RFC 4122 v4 UUID.\n *\n * `crypto.randomUUID` is only defined in secure contexts (https / localhost),\n * so pages served over plain http from a LAN address would throw on every\n * invocation. Fall back to building the UUID from `crypto.getRandomValues`,\n * which is available in insecure contexts and uses the same CSPRNG. The\n * engine parses invocation ids as UUIDs, so the fallback must be a real one.\n */\nexport function randomUUID(): string {\n if (typeof crypto.randomUUID === 'function') return crypto.randomUUID()\n const bytes = crypto.getRandomValues(new Uint8Array(16))\n bytes[6] = (bytes[6] & 0x0f) | 0x40\n bytes[8] = (bytes[8] & 0x3f) | 0x80\n const hex = Array.from(bytes, (b) => b.toString(16).padStart(2, '0')).join('')\n return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`\n}\n\n/** UTF-8 byte length of a string, without `Buffer` or an encoder allocation. */\nexport function utf8ByteLength(s: string): number {\n let bytes = 0\n for (let i = 0; i < s.length; i++) {\n const c = s.charCodeAt(i)\n if (c < 0x80) bytes += 1\n else if (c < 0x800) bytes += 2\n else if (c >= 0xd800 && c <= 0xdbff && i + 1 < s.length) {\n const d = s.charCodeAt(i + 1)\n if (d >= 0xdc00 && d <= 0xdfff) {\n bytes += 4\n i++\n } else {\n bytes += 3\n }\n } else bytes += 3\n }\n return bytes\n}\n\n/**\n * Lets a timer not hold the process open where timers can be unreferenced\n * (Node, which runs this SDK in tests and server-side rendering). A no-op in\n * a browser, where a timer is a number.\n */\nexport function unrefTimer(timer: unknown): void {\n ;(timer as { unref?: () => void } | undefined)?.unref?.()\n}\n"],"mappings":";;;;;;AAOA,MAAa,mBAAmB;CAC9B,MAAM;CACN,OAAO;CACR;AAaD,MAAa,cAAc;;CAEzB,KAAK,OAA4B;AAC/B,SAAO;GAAE,MAAM;GAAQ;GAAO;;;CAGhC,OAAO,OAAgC;AACrC,SAAO;GAAE,MAAM;GAAU;GAAO;;CAEnC;;;;;;;;;;;;;;AAeD,IAAa,gBAAb,MAAa,cAAc;CAWzB,YAAY,cAAsB,KAAuB;EATzD,KAAQ,KAAuB;EAC/B,KAAQ,UAAU;EAClB,KAAiB,kBAIX,EAAE;AAIN,OAAK,MAAM,gBAAgB,cAAc,IAAI,YAAY,IAAI,YAAY,QAAQ;;CAGnF,AAAQ,kBAAwB;AAC9B,MAAI,KAAK,GAAI;AAEb,OAAK,KAAK,IAAI,UAAU,KAAK,IAAI;AACjC,OAAK,GAAG,aAAa;AAErB,OAAK,GAAG,iBAAiB,cAAc;AACrC,QAAK,UAAU;AACf,QAAK,MAAM,EAAE,MAAM,SAAS,YAAY,KAAK,gBAC3C,KAAI;AACF,SAAK,IAAI,KAAK,KAAK;AACnB,aAAS;YACF,KAAK;AACZ,WAAO,eAAe,QAAQ,MAAM,IAAI,MAAM,OAAO,IAAI,CAAC,CAAC;;AAG/D,QAAK,gBAAgB,SAAS;IAC9B;AAEF,OAAK,GAAG,iBAAiB,eAAe;AACtC,QAAK,MAAM,EAAE,YAAY,KAAK,gBAC5B,wBAAO,IAAI,MAAM,kBAAkB,CAAC;AAEtC,QAAK,gBAAgB,SAAS;IAC9B;;;CAIJ,YAAY,KAAmB;AAC7B,OAAK,iBAAiB;AACtB,OAAK,QAAQ,IAAI;;;CAInB,WAAW,MAAwB;AACjC,OAAK,iBAAiB;EAEtB,IAAI,SAAS;AACb,SAAO,SAAS,KAAK,QAAQ;GAC3B,MAAM,MAAM,KAAK,IAAI,SAAS,cAAc,YAAY,KAAK,OAAO;GACpE,MAAM,QAAQ,KAAK,SAAS,QAAQ,IAAI;GACxC,MAAM,SAAS,MAAM,kBAAkB,cAAc,MAAM,SAAS,IAAI,YAAY,MAAM,WAAW;AACrG,OAAI,EAAE,MAAM,kBAAkB,aAC5B,KAAI,WAAW,OAAO,CAAC,IAAI,MAAM;AAEnC,QAAK,QAAQ,OAAO,MAAM,MAAM,YAAY,MAAM,aAAa,MAAM,WAAW,CAAC;AACjF,YAAS;;;;CAKb,QAAc;AACZ,MAAI,CAAC,KAAK,GAAI;EAEd,MAAM,gBAAgB;AACpB,OAAI,KAAK,MAAM,KAAK,GAAG,eAAe,UAAU,KAC9C,MAAK,GAAG,MAAM,KAAM,gBAAgB;;AAIxC,MAAI,KAAK,QACP,UAAS;MAET,MAAK,GAAG,iBAAiB,cAAc,SAAS,CAAC;;CAIrD,AAAQ,QAAQ,MAAkC;AAChD,MAAI,KAAK,WAAW,KAAK,MAAM,KAAK,GAAG,eAAe,UAAU,KAC9D,MAAK,GAAG,KAAK,KAAK;OACb;AACL,QAAK,iBAAiB;AACtB,QAAK,gBAAgB,KAAK;IACxB;IACA,eAAe;IAGf,cAAc;AACZ,aAAQ,MAAM,yBAAyB;;IAE1C,CAAC;;;;AA9FN,cAAwB,aAAa,KAAK;;;;;;;;;;;;;AA+G5C,IAAa,gBAAb,MAA2B;CAQzB,YAAY,cAAsB,KAAuB;EAPzD,KAAQ,KAAuB;EAC/B,KAAQ,YAAY;EACpB,KAAQ,iBAAiB;EACzB,KAAiB,mBAAiD,EAAE;EACpE,KAAiB,kBAAqD,EAAE;AAItE,OAAK,MAAM,gBAAgB,cAAc,IAAI,YAAY,IAAI,YAAY,OAAO;;CAGlF,AAAQ,kBAAwB;AAC9B,MAAI,KAAK,UAAW;AACpB,OAAK,YAAY;AAEjB,OAAK,KAAK,IAAI,UAAU,KAAK,IAAI;AACjC,OAAK,GAAG,aAAa;AAErB,OAAK,GAAG,iBAAiB,YAAY,UAAwB;AAC3D,OAAI,MAAM,gBAAgB,aAAa;IACrC,MAAM,OAAO,IAAI,WAAW,MAAM,KAAK;AACvC,SAAK,MAAM,MAAM,KAAK,gBACpB,IAAG,KAAK;cAED,OAAO,MAAM,SAAS,SAC/B,MAAK,MAAM,MAAM,KAAK,iBACpB,IAAG,MAAM,KAAK;IAGlB;AAEF,OAAK,GAAG,iBAAiB,eAAe;AACtC,QAAK,KAAK;IACV;AAEF,OAAK,GAAG,iBAAiB,eAAe;AACtC,QAAK,KAAK;IACV;;;CAIJ,UAAU,UAAuC;AAC/C,OAAK,iBAAiB,KAAK,SAAS;AACpC,OAAK,iBAAiB;;;CAIxB,SAAS,UAA4C;AACnD,OAAK,gBAAgB,KAAK,SAAS;AACnC,OAAK,iBAAiB;;;;;;;;CASxB,MAAM,UAA+B;AACnC,OAAK,iBAAiB;EACtB,MAAM,SAAuB,EAAE;AAE/B,SAAO,IAAI,SAAqB,SAAS,WAAW;GAClD,MAAM,UAAU,SAAqB;AACnC,WAAO,KAAK,KAAK;;AAEnB,QAAK,gBAAgB,KAAK,OAAO;GAEjC,MAAM,aAAa,KAAK;AACxB,OAAI,WACF,YAAW,iBAAiB,UAAU,UAAsB;AAE1D,QAAI,CAAC,KAAK,kBAAkB,MAAM,SAAS,OAAQ,MAAM,SAAS,MAAM;KACtE,MAAM,SAAS,MAAM,SAAS,KAAK,MAAM,WAAW;AACpD,YACE,OAAO,uBAAO,IAAI,MAAM,uCAAuC,MAAM,OAAO,SAAS,EAAE;MACrF,MAAM,MAAM;MACZ,QAAQ,MAAM;MACf,CAAC,CACH;AACD;;IAEF,MAAM,cAAc,OAAO,QAAQ,KAAK,MAAM,MAAM,EAAE,QAAQ,EAAE;IAChE,MAAM,SAAS,IAAI,WAAW,YAAY;IAC1C,IAAI,SAAS;AACb,SAAK,MAAM,SAAS,QAAQ;AAC1B,YAAO,IAAI,OAAO,OAAO;AACzB,eAAU,MAAM;;AAElB,YAAQ,OAAO;KACf;IAEJ;;;CAIJ,QAAc;AACZ,MAAI,KAAK,MAAM,KAAK,GAAG,eAAe,UAAU,QAAQ;AAEtD,QAAK,iBAAiB;AACtB,QAAK,GAAG,MAAM,KAAM,gBAAgB;;;;AAK1C,SAAS,gBACP,cACA,WACA,WACA,WACQ;AAER,QAAO,GADM,aAAa,QAAQ,OAAO,GAC3B,CAAC,eAAe,UAAU,OAAO,mBAAmB,UAAU,CAAC,OAAO;;;;;;;;;;;AC7OtF,MAAa,gBAAgB,UAA8C;AACzE,KAAI,OAAO,UAAU,YAAY,UAAU,KAAM,QAAO;CACxD,MAAM,QAAQ;AACd,QACE,OAAO,MAAM,eAAe,YAC5B,OAAO,MAAM,eAAe,aAC3B,MAAM,cAAc,UAAU,MAAM,cAAc;;;;;;;;;;AAYvD,MAAa,sBAAsB,SAAqD;CACtF,MAAM,OAA0C,EAAE;AAClD,sBAAqB,MAAM,IAAI,KAAK;AACpC,QAAO;;AAGT,MAAM,wBACJ,MACA,QACA,SACS;AACT,KAAI,aAAa,KAAK,EAAE;AACtB,OAAK,KAAK,CAAC,QAAQ,KAAK,CAAC;AACzB;;AAEF,KAAI,MAAM,QAAQ,KAAK,EAAE;AACvB,OAAK,IAAI,IAAI,GAAG,IAAI,KAAK,QAAQ,KAAK;GACpC,MAAM,OAAO,WAAW,KAAK,IAAI,EAAE,KAAK,GAAG,OAAO,GAAG,EAAE;AACvD,wBAAqB,KAAK,IAAI,MAAM,KAAK;;AAE3C;;AAEF,KAAI,OAAO,SAAS,YAAY,SAAS,KAAM;AAE/C,MAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,KAAgC,CAExE,sBAAqB,OADR,WAAW,KAAK,MAAM,GAAG,OAAO,GAAG,OACd,KAAK;;;;;;;;;;;AAa3C,SAAgB,aAAqB;AACnC,KAAI,OAAO,OAAO,eAAe,WAAY,QAAO,OAAO,YAAY;CACvE,MAAM,QAAQ,OAAO,gBAAgB,IAAI,WAAW,GAAG,CAAC;AACxD,OAAM,KAAM,MAAM,KAAK,KAAQ;AAC/B,OAAM,KAAM,MAAM,KAAK,KAAQ;CAC/B,MAAM,MAAM,MAAM,KAAK,QAAQ,MAAM,EAAE,SAAS,GAAG,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC,KAAK,GAAG;AAC9E,QAAO,GAAG,IAAI,MAAM,GAAG,EAAE,CAAC,GAAG,IAAI,MAAM,GAAG,GAAG,CAAC,GAAG,IAAI,MAAM,IAAI,GAAG,CAAC,GAAG,IAAI,MAAM,IAAI,GAAG,CAAC,GAAG,IAAI,MAAM,GAAG;;;AAI1G,SAAgB,eAAe,GAAmB;CAChD,IAAI,QAAQ;AACZ,MAAK,IAAI,IAAI,GAAG,IAAI,EAAE,QAAQ,KAAK;EACjC,MAAM,IAAI,EAAE,WAAW,EAAE;AACzB,MAAI,IAAI,IAAM,UAAS;WACd,IAAI,KAAO,UAAS;WACpB,KAAK,SAAU,KAAK,SAAU,IAAI,IAAI,EAAE,QAAQ;GACvD,MAAM,IAAI,EAAE,WAAW,IAAI,EAAE;AAC7B,OAAI,KAAK,SAAU,KAAK,OAAQ;AAC9B,aAAS;AACT;SAEA,UAAS;QAEN,UAAS;;AAElB,QAAO;;;;;;;AAQT,SAAgB,WAAW,OAAsB;AAC9C,CAAC,OAA8C,SAAS"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "iii-browser-sdk",
3
- "version": "0.25.0",
3
+ "version": "0.25.1-alpha.2",
4
4
  "private": false,
5
5
  "publishConfig": {
6
6
  "access": "public"
@@ -40,7 +40,7 @@
40
40
  },
41
41
  "devDependencies": {
42
42
  "@types/ws": "^8.18.1",
43
- "happy-dom": "^20.14.5",
43
+ "happy-dom": "^21.0.4",
44
44
  "tsdown": "^0.21.4",
45
45
  "typedoc": "^0.28.20",
46
46
  "typescript": "^5.9.3",
@@ -1 +0,0 @@
1
- {"version":3,"file":"types-BGYN2Z4E.d.cts","names":[],"sources":["../src/iii-types.ts","../src/channels.ts","../src/errors.ts","../src/iii-constants.ts","../src/observe-types.ts","../src/triggers.ts","../src/types.ts"],"mappings":"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"}
@@ -1 +0,0 @@
1
- {"version":3,"file":"types-Crw4auK5.d.mts","names":[],"sources":["../src/iii-types.ts","../src/channels.ts","../src/errors.ts","../src/iii-constants.ts","../src/observe-types.ts","../src/triggers.ts","../src/types.ts"],"mappings":"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"}
@@ -1 +0,0 @@
1
- {"version":3,"file":"utils-BUI0XQTZ.cjs","names":[],"sources":["../src/channels.ts","../src/utils.ts"],"sourcesContent":["import type { StreamChannelRef } from './iii-types'\n\n/**\n * Direction of a streaming channel endpoint. Mirrors the Rust SDK's\n * `ChannelDirection` enum and matches the literal values used by\n * {@link StreamChannelRef.direction}.\n */\nexport const ChannelDirection = {\n Read: 'read',\n Write: 'write',\n} as const\nexport type ChannelDirection = (typeof ChannelDirection)[keyof typeof ChannelDirection]\n\n/**\n * Discriminated runtime tag for an item observed on a streaming channel.\n * Mirrors the Rust SDK's `ChannelItem` enum (`Text` / `Binary`). Carrier for\n * factory + type-guard helpers so callers can construct and discriminate\n * channel items without depending on Rust-specific shape.\n */\nexport type ChannelItem =\n | { type: 'text'; value: string }\n | { type: 'binary'; value: Uint8Array }\n\nexport const ChannelItem = {\n /** Construct a text channel item. */\n Text(value: string): ChannelItem {\n return { type: 'text', value }\n },\n /** Construct a binary channel item. */\n Binary(value: Uint8Array): ChannelItem {\n return { type: 'binary', value }\n },\n} as const\n\n/**\n * Write end of a streaming channel. Uses native browser WebSocket.\n *\n * @example\n * ```typescript\n * import { createChannel } from 'iii-browser-sdk/helpers'\n * const channel = await createChannel(iii)\n *\n * channel.writer.sendMessage(JSON.stringify({ type: 'event', data: 'test' }))\n * channel.writer.sendBinary(new Uint8Array([1, 2, 3]))\n * channel.writer.close()\n * ```\n */\nexport class ChannelWriter {\n private static readonly FRAME_SIZE = 64 * 1024\n private ws: WebSocket | null = null\n private wsReady = false\n private readonly pendingMessages: {\n data: ArrayBuffer | string\n resolve: () => void\n reject: (err: Error) => void\n }[] = []\n private readonly url: string\n\n constructor(engineWsBase: string, ref: StreamChannelRef) {\n this.url = buildChannelUrl(engineWsBase, ref.channel_id, ref.access_key, 'write')\n }\n\n private ensureConnected(): void {\n if (this.ws) return\n\n this.ws = new WebSocket(this.url)\n this.ws.binaryType = 'arraybuffer'\n\n this.ws.addEventListener('open', () => {\n this.wsReady = true\n for (const { data, resolve, reject } of this.pendingMessages) {\n try {\n this.ws?.send(data)\n resolve()\n } catch (err) {\n reject(err instanceof Error ? err : new Error(String(err)))\n }\n }\n this.pendingMessages.length = 0\n })\n\n this.ws.addEventListener('error', () => {\n for (const { reject } of this.pendingMessages) {\n reject(new Error('WebSocket error'))\n }\n this.pendingMessages.length = 0\n })\n }\n\n /** Send a text message through the channel. */\n sendMessage(msg: string): void {\n this.ensureConnected()\n this.sendRaw(msg)\n }\n\n /** Send binary data through the channel. */\n sendBinary(data: Uint8Array): void {\n this.ensureConnected()\n\n let offset = 0\n while (offset < data.length) {\n const end = Math.min(offset + ChannelWriter.FRAME_SIZE, data.length)\n const chunk = data.subarray(offset, end)\n const buffer = chunk.buffer instanceof ArrayBuffer ? chunk.buffer : new ArrayBuffer(chunk.byteLength)\n if (!(chunk.buffer instanceof ArrayBuffer)) {\n new Uint8Array(buffer).set(chunk)\n }\n this.sendRaw(buffer.slice(chunk.byteOffset, chunk.byteOffset + chunk.byteLength))\n offset = end\n }\n }\n\n /** Close the channel writer. */\n close(): void {\n if (!this.ws) return\n\n const doClose = () => {\n if (this.ws && this.ws.readyState === WebSocket.OPEN) {\n this.ws.close(1000, 'channel_close')\n }\n }\n\n if (this.wsReady) {\n doClose()\n } else {\n this.ws.addEventListener('open', () => doClose())\n }\n }\n\n private sendRaw(data: ArrayBuffer | string): void {\n if (this.wsReady && this.ws && this.ws.readyState === WebSocket.OPEN) {\n this.ws.send(data)\n } else {\n this.ensureConnected()\n this.pendingMessages.push({\n data,\n resolve: () => {\n //\n },\n reject: () => {\n console.error('Failed to send message')\n },\n })\n }\n }\n}\n\n/**\n * Read end of a streaming channel. Uses native browser WebSocket.\n *\n * @example\n * ```typescript\n * import { createChannel } from 'iii-browser-sdk/helpers'\n * const channel = await createChannel(iii)\n *\n * channel.reader.onMessage((msg) => console.log('Got:', msg))\n * channel.reader.onBinary((data) => console.log('Binary:', data.byteLength))\n * ```\n */\nexport class ChannelReader {\n private ws: WebSocket | null = null\n private connected = false\n private readonly messageCallbacks: Array<(msg: string) => void> = []\n private readonly binaryCallbacks: Array<(data: Uint8Array) => void> = []\n private readonly url: string\n\n constructor(engineWsBase: string, ref: StreamChannelRef) {\n this.url = buildChannelUrl(engineWsBase, ref.channel_id, ref.access_key, 'read')\n }\n\n private ensureConnected(): void {\n if (this.connected) return\n this.connected = true\n\n this.ws = new WebSocket(this.url)\n this.ws.binaryType = 'arraybuffer'\n\n this.ws.addEventListener('message', (event: MessageEvent) => {\n if (event.data instanceof ArrayBuffer) {\n const data = new Uint8Array(event.data)\n for (const cb of this.binaryCallbacks) {\n cb(data)\n }\n } else if (typeof event.data === 'string') {\n for (const cb of this.messageCallbacks) {\n cb(event.data)\n }\n }\n })\n\n this.ws.addEventListener('close', () => {\n this.ws = null\n })\n\n this.ws.addEventListener('error', () => {\n this.ws = null\n })\n }\n\n /** Register a callback to receive text messages from the channel. */\n onMessage(callback: (msg: string) => void): void {\n this.messageCallbacks.push(callback)\n this.ensureConnected()\n }\n\n /** Register a callback to receive binary data from the channel. */\n onBinary(callback: (data: Uint8Array) => void): void {\n this.binaryCallbacks.push(callback)\n this.ensureConnected()\n }\n\n /** Read all binary data from the channel until it closes. */\n async readAll(): Promise<Uint8Array> {\n this.ensureConnected()\n const chunks: Uint8Array[] = []\n\n return new Promise<Uint8Array>((resolve) => {\n const onData = (data: Uint8Array) => {\n chunks.push(data)\n }\n this.binaryCallbacks.push(onData)\n\n const originalWs = this.ws\n if (originalWs) {\n originalWs.addEventListener('close', () => {\n const totalLength = chunks.reduce((sum, c) => sum + c.length, 0)\n const result = new Uint8Array(totalLength)\n let offset = 0\n for (const chunk of chunks) {\n result.set(chunk, offset)\n offset += chunk.length\n }\n resolve(result)\n })\n }\n })\n }\n\n /** Close the channel reader. */\n close(): void {\n if (this.ws && this.ws.readyState !== WebSocket.CLOSED) {\n this.ws.close(1000, 'channel_close')\n }\n }\n}\n\nfunction buildChannelUrl(\n engineWsBase: string,\n channelId: string,\n accessKey: string,\n direction: 'read' | 'write',\n): string {\n const base = engineWsBase.replace(/\\/$/, '')\n return `${base}/ws/channels/${channelId}?key=${encodeURIComponent(accessKey)}&dir=${direction}`\n}\n","import type { StreamChannelRef } from './iii-types'\n\n/**\n * Safely stringify a value, handling circular references, BigInt, and other edge cases.\n * Returns \"[unserializable]\" if serialization fails for any reason.\n */\nexport function safeStringify(value: unknown): string {\n const seen = new WeakSet<object>()\n\n try {\n return JSON.stringify(value, (_key, val) => {\n if (typeof val === 'bigint') {\n return val.toString()\n }\n\n if (val !== null && typeof val === 'object') {\n if (seen.has(val)) {\n return '[Circular]'\n }\n seen.add(val)\n }\n\n return val\n })\n } catch {\n return '[unserializable]'\n }\n}\n\n/**\n * Type guard that checks if a value is a {@link StreamChannelRef}.\n *\n * @param value - Value to check.\n * @returns `true` if the value is a valid `StreamChannelRef`.\n */\nexport const isChannelRef = (value: unknown): value is StreamChannelRef => {\n if (typeof value !== 'object' || value === null) return false\n const maybe = value as Partial<StreamChannelRef>\n return (\n typeof maybe.channel_id === 'string' &&\n typeof maybe.access_key === 'string' &&\n (maybe.direction === 'read' || maybe.direction === 'write')\n )\n}\n\n/**\n * Recursively extract all {@link StreamChannelRef} values from a JSON-like\n * input, returning each match paired with its dotted/bracketed path. Mirrors\n * the Rust SDK's `extract_channel_refs`.\n *\n * @param data - Arbitrary JSON-like value.\n * @returns Array of `[path, ref]` tuples. Empty when no refs are found.\n */\nexport const extractChannelRefs = (data: unknown): Array<[string, StreamChannelRef]> => {\n const refs: Array<[string, StreamChannelRef]> = []\n extractRefsRecursive(data, '', refs)\n return refs\n}\n\nconst extractRefsRecursive = (\n data: unknown,\n prefix: string,\n refs: Array<[string, StreamChannelRef]>,\n): void => {\n if (isChannelRef(data)) {\n refs.push([prefix, data])\n return\n }\n if (Array.isArray(data)) {\n for (let i = 0; i < data.length; i++) {\n const path = prefix === '' ? `[${i}]` : `${prefix}[${i}]`\n extractRefsRecursive(data[i], path, refs)\n }\n return\n }\n if (typeof data !== 'object' || data === null) return\n\n for (const [key, value] of Object.entries(data as Record<string, unknown>)) {\n const path = prefix === '' ? key : `${prefix}.${key}`\n extractRefsRecursive(value, path, refs)\n }\n}\n\n/**\n * Generate an RFC 4122 v4 UUID.\n *\n * `crypto.randomUUID` is only defined in secure contexts (https / localhost),\n * so pages served over plain http from a LAN address would throw on every\n * invocation. Fall back to building the UUID from `crypto.getRandomValues`,\n * which is available in insecure contexts and uses the same CSPRNG. The\n * engine parses invocation ids as UUIDs, so the fallback must be a real one.\n */\nexport function randomUUID(): string {\n if (typeof crypto.randomUUID === 'function') return crypto.randomUUID()\n const bytes = crypto.getRandomValues(new Uint8Array(16))\n bytes[6] = (bytes[6] & 0x0f) | 0x40\n bytes[8] = (bytes[8] & 0x3f) | 0x80\n const hex = Array.from(bytes, (b) => b.toString(16).padStart(2, '0')).join('')\n return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`\n}\n\n/** UTF-8 byte length of a string, without `Buffer` or an encoder allocation. */\nexport function utf8ByteLength(s: string): number {\n let bytes = 0\n for (let i = 0; i < s.length; i++) {\n const c = s.charCodeAt(i)\n if (c < 0x80) bytes += 1\n else if (c < 0x800) bytes += 2\n else if (c >= 0xd800 && c <= 0xdbff && i + 1 < s.length) {\n const d = s.charCodeAt(i + 1)\n if (d >= 0xdc00 && d <= 0xdfff) {\n bytes += 4\n i++\n } else {\n bytes += 3\n }\n } else bytes += 3\n }\n return bytes\n}\n\n/**\n * Lets a timer not hold the process open where timers can be unreferenced\n * (Node, which runs this SDK in tests and server-side rendering). A no-op in\n * a browser, where a timer is a number.\n */\nexport function unrefTimer(timer: unknown): void {\n ;(timer as { unref?: () => void } | undefined)?.unref?.()\n}\n"],"mappings":"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"}
@@ -1 +0,0 @@
1
- {"version":3,"file":"utils-Bz5eP_hN.mjs","names":[],"sources":["../src/channels.ts","../src/utils.ts"],"sourcesContent":["import type { StreamChannelRef } from './iii-types'\n\n/**\n * Direction of a streaming channel endpoint. Mirrors the Rust SDK's\n * `ChannelDirection` enum and matches the literal values used by\n * {@link StreamChannelRef.direction}.\n */\nexport const ChannelDirection = {\n Read: 'read',\n Write: 'write',\n} as const\nexport type ChannelDirection = (typeof ChannelDirection)[keyof typeof ChannelDirection]\n\n/**\n * Discriminated runtime tag for an item observed on a streaming channel.\n * Mirrors the Rust SDK's `ChannelItem` enum (`Text` / `Binary`). Carrier for\n * factory + type-guard helpers so callers can construct and discriminate\n * channel items without depending on Rust-specific shape.\n */\nexport type ChannelItem =\n | { type: 'text'; value: string }\n | { type: 'binary'; value: Uint8Array }\n\nexport const ChannelItem = {\n /** Construct a text channel item. */\n Text(value: string): ChannelItem {\n return { type: 'text', value }\n },\n /** Construct a binary channel item. */\n Binary(value: Uint8Array): ChannelItem {\n return { type: 'binary', value }\n },\n} as const\n\n/**\n * Write end of a streaming channel. Uses native browser WebSocket.\n *\n * @example\n * ```typescript\n * import { createChannel } from 'iii-browser-sdk/helpers'\n * const channel = await createChannel(iii)\n *\n * channel.writer.sendMessage(JSON.stringify({ type: 'event', data: 'test' }))\n * channel.writer.sendBinary(new Uint8Array([1, 2, 3]))\n * channel.writer.close()\n * ```\n */\nexport class ChannelWriter {\n private static readonly FRAME_SIZE = 64 * 1024\n private ws: WebSocket | null = null\n private wsReady = false\n private readonly pendingMessages: {\n data: ArrayBuffer | string\n resolve: () => void\n reject: (err: Error) => void\n }[] = []\n private readonly url: string\n\n constructor(engineWsBase: string, ref: StreamChannelRef) {\n this.url = buildChannelUrl(engineWsBase, ref.channel_id, ref.access_key, 'write')\n }\n\n private ensureConnected(): void {\n if (this.ws) return\n\n this.ws = new WebSocket(this.url)\n this.ws.binaryType = 'arraybuffer'\n\n this.ws.addEventListener('open', () => {\n this.wsReady = true\n for (const { data, resolve, reject } of this.pendingMessages) {\n try {\n this.ws?.send(data)\n resolve()\n } catch (err) {\n reject(err instanceof Error ? err : new Error(String(err)))\n }\n }\n this.pendingMessages.length = 0\n })\n\n this.ws.addEventListener('error', () => {\n for (const { reject } of this.pendingMessages) {\n reject(new Error('WebSocket error'))\n }\n this.pendingMessages.length = 0\n })\n }\n\n /** Send a text message through the channel. */\n sendMessage(msg: string): void {\n this.ensureConnected()\n this.sendRaw(msg)\n }\n\n /** Send binary data through the channel. */\n sendBinary(data: Uint8Array): void {\n this.ensureConnected()\n\n let offset = 0\n while (offset < data.length) {\n const end = Math.min(offset + ChannelWriter.FRAME_SIZE, data.length)\n const chunk = data.subarray(offset, end)\n const buffer = chunk.buffer instanceof ArrayBuffer ? chunk.buffer : new ArrayBuffer(chunk.byteLength)\n if (!(chunk.buffer instanceof ArrayBuffer)) {\n new Uint8Array(buffer).set(chunk)\n }\n this.sendRaw(buffer.slice(chunk.byteOffset, chunk.byteOffset + chunk.byteLength))\n offset = end\n }\n }\n\n /** Close the channel writer. */\n close(): void {\n if (!this.ws) return\n\n const doClose = () => {\n if (this.ws && this.ws.readyState === WebSocket.OPEN) {\n this.ws.close(1000, 'channel_close')\n }\n }\n\n if (this.wsReady) {\n doClose()\n } else {\n this.ws.addEventListener('open', () => doClose())\n }\n }\n\n private sendRaw(data: ArrayBuffer | string): void {\n if (this.wsReady && this.ws && this.ws.readyState === WebSocket.OPEN) {\n this.ws.send(data)\n } else {\n this.ensureConnected()\n this.pendingMessages.push({\n data,\n resolve: () => {\n //\n },\n reject: () => {\n console.error('Failed to send message')\n },\n })\n }\n }\n}\n\n/**\n * Read end of a streaming channel. Uses native browser WebSocket.\n *\n * @example\n * ```typescript\n * import { createChannel } from 'iii-browser-sdk/helpers'\n * const channel = await createChannel(iii)\n *\n * channel.reader.onMessage((msg) => console.log('Got:', msg))\n * channel.reader.onBinary((data) => console.log('Binary:', data.byteLength))\n * ```\n */\nexport class ChannelReader {\n private ws: WebSocket | null = null\n private connected = false\n private readonly messageCallbacks: Array<(msg: string) => void> = []\n private readonly binaryCallbacks: Array<(data: Uint8Array) => void> = []\n private readonly url: string\n\n constructor(engineWsBase: string, ref: StreamChannelRef) {\n this.url = buildChannelUrl(engineWsBase, ref.channel_id, ref.access_key, 'read')\n }\n\n private ensureConnected(): void {\n if (this.connected) return\n this.connected = true\n\n this.ws = new WebSocket(this.url)\n this.ws.binaryType = 'arraybuffer'\n\n this.ws.addEventListener('message', (event: MessageEvent) => {\n if (event.data instanceof ArrayBuffer) {\n const data = new Uint8Array(event.data)\n for (const cb of this.binaryCallbacks) {\n cb(data)\n }\n } else if (typeof event.data === 'string') {\n for (const cb of this.messageCallbacks) {\n cb(event.data)\n }\n }\n })\n\n this.ws.addEventListener('close', () => {\n this.ws = null\n })\n\n this.ws.addEventListener('error', () => {\n this.ws = null\n })\n }\n\n /** Register a callback to receive text messages from the channel. */\n onMessage(callback: (msg: string) => void): void {\n this.messageCallbacks.push(callback)\n this.ensureConnected()\n }\n\n /** Register a callback to receive binary data from the channel. */\n onBinary(callback: (data: Uint8Array) => void): void {\n this.binaryCallbacks.push(callback)\n this.ensureConnected()\n }\n\n /** Read all binary data from the channel until it closes. */\n async readAll(): Promise<Uint8Array> {\n this.ensureConnected()\n const chunks: Uint8Array[] = []\n\n return new Promise<Uint8Array>((resolve) => {\n const onData = (data: Uint8Array) => {\n chunks.push(data)\n }\n this.binaryCallbacks.push(onData)\n\n const originalWs = this.ws\n if (originalWs) {\n originalWs.addEventListener('close', () => {\n const totalLength = chunks.reduce((sum, c) => sum + c.length, 0)\n const result = new Uint8Array(totalLength)\n let offset = 0\n for (const chunk of chunks) {\n result.set(chunk, offset)\n offset += chunk.length\n }\n resolve(result)\n })\n }\n })\n }\n\n /** Close the channel reader. */\n close(): void {\n if (this.ws && this.ws.readyState !== WebSocket.CLOSED) {\n this.ws.close(1000, 'channel_close')\n }\n }\n}\n\nfunction buildChannelUrl(\n engineWsBase: string,\n channelId: string,\n accessKey: string,\n direction: 'read' | 'write',\n): string {\n const base = engineWsBase.replace(/\\/$/, '')\n return `${base}/ws/channels/${channelId}?key=${encodeURIComponent(accessKey)}&dir=${direction}`\n}\n","import type { StreamChannelRef } from './iii-types'\n\n/**\n * Safely stringify a value, handling circular references, BigInt, and other edge cases.\n * Returns \"[unserializable]\" if serialization fails for any reason.\n */\nexport function safeStringify(value: unknown): string {\n const seen = new WeakSet<object>()\n\n try {\n return JSON.stringify(value, (_key, val) => {\n if (typeof val === 'bigint') {\n return val.toString()\n }\n\n if (val !== null && typeof val === 'object') {\n if (seen.has(val)) {\n return '[Circular]'\n }\n seen.add(val)\n }\n\n return val\n })\n } catch {\n return '[unserializable]'\n }\n}\n\n/**\n * Type guard that checks if a value is a {@link StreamChannelRef}.\n *\n * @param value - Value to check.\n * @returns `true` if the value is a valid `StreamChannelRef`.\n */\nexport const isChannelRef = (value: unknown): value is StreamChannelRef => {\n if (typeof value !== 'object' || value === null) return false\n const maybe = value as Partial<StreamChannelRef>\n return (\n typeof maybe.channel_id === 'string' &&\n typeof maybe.access_key === 'string' &&\n (maybe.direction === 'read' || maybe.direction === 'write')\n )\n}\n\n/**\n * Recursively extract all {@link StreamChannelRef} values from a JSON-like\n * input, returning each match paired with its dotted/bracketed path. Mirrors\n * the Rust SDK's `extract_channel_refs`.\n *\n * @param data - Arbitrary JSON-like value.\n * @returns Array of `[path, ref]` tuples. Empty when no refs are found.\n */\nexport const extractChannelRefs = (data: unknown): Array<[string, StreamChannelRef]> => {\n const refs: Array<[string, StreamChannelRef]> = []\n extractRefsRecursive(data, '', refs)\n return refs\n}\n\nconst extractRefsRecursive = (\n data: unknown,\n prefix: string,\n refs: Array<[string, StreamChannelRef]>,\n): void => {\n if (isChannelRef(data)) {\n refs.push([prefix, data])\n return\n }\n if (Array.isArray(data)) {\n for (let i = 0; i < data.length; i++) {\n const path = prefix === '' ? `[${i}]` : `${prefix}[${i}]`\n extractRefsRecursive(data[i], path, refs)\n }\n return\n }\n if (typeof data !== 'object' || data === null) return\n\n for (const [key, value] of Object.entries(data as Record<string, unknown>)) {\n const path = prefix === '' ? key : `${prefix}.${key}`\n extractRefsRecursive(value, path, refs)\n }\n}\n\n/**\n * Generate an RFC 4122 v4 UUID.\n *\n * `crypto.randomUUID` is only defined in secure contexts (https / localhost),\n * so pages served over plain http from a LAN address would throw on every\n * invocation. Fall back to building the UUID from `crypto.getRandomValues`,\n * which is available in insecure contexts and uses the same CSPRNG. The\n * engine parses invocation ids as UUIDs, so the fallback must be a real one.\n */\nexport function randomUUID(): string {\n if (typeof crypto.randomUUID === 'function') return crypto.randomUUID()\n const bytes = crypto.getRandomValues(new Uint8Array(16))\n bytes[6] = (bytes[6] & 0x0f) | 0x40\n bytes[8] = (bytes[8] & 0x3f) | 0x80\n const hex = Array.from(bytes, (b) => b.toString(16).padStart(2, '0')).join('')\n return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`\n}\n\n/** UTF-8 byte length of a string, without `Buffer` or an encoder allocation. */\nexport function utf8ByteLength(s: string): number {\n let bytes = 0\n for (let i = 0; i < s.length; i++) {\n const c = s.charCodeAt(i)\n if (c < 0x80) bytes += 1\n else if (c < 0x800) bytes += 2\n else if (c >= 0xd800 && c <= 0xdbff && i + 1 < s.length) {\n const d = s.charCodeAt(i + 1)\n if (d >= 0xdc00 && d <= 0xdfff) {\n bytes += 4\n i++\n } else {\n bytes += 3\n }\n } else bytes += 3\n }\n return bytes\n}\n\n/**\n * Lets a timer not hold the process open where timers can be unreferenced\n * (Node, which runs this SDK in tests and server-side rendering). A no-op in\n * a browser, where a timer is a number.\n */\nexport function unrefTimer(timer: unknown): void {\n ;(timer as { unref?: () => void } | undefined)?.unref?.()\n}\n"],"mappings":"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"}