iii-browser-sdk 0.17.0 → 0.18.0

package/dist/helpers.cjs

@@ -0,0 +1,30 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_utils = require('./utils-Cq61lImK.cjs');
+
+//#region src/helpers.ts
+/**
+* Create a streaming channel pair for worker-to-worker data transfer.
+*
+* Free-function form of the previous `ISdk.createChannel` instance method.
+*/
+function createChannel(iii, bufferSize) {
+	return iii.__helpers_create_channel(bufferSize);
+}
+/**
+* Register a custom stream implementation by wiring its 5 callable methods
+* to `stream::get/set/delete/list/list_groups`.
+*
+* Free-function form of the previous `ISdk.createStream` instance method.
+*/
+function createStream(iii, streamName, stream) {
+	iii.__helpers_create_stream(streamName, stream);
+}
+
+//#endregion
+exports.ChannelDirection = require_utils.ChannelDirection;
+exports.ChannelItem = require_utils.ChannelItem;
+exports.createChannel = createChannel;
+exports.createStream = createStream;
+exports.extractChannelRefs = require_utils.extractChannelRefs;
+exports.isChannelRef = require_utils.isChannelRef;
+//# sourceMappingURL=helpers.cjs.map

package/dist/helpers.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.cjs","names":[],"sources":["../src/helpers.ts"],"sourcesContent":["/**\n * Helper free functions that operate on an {@link ISdk} instance.\n *\n * These were previously instance methods on the SDK. They take the iii\n * instance as the first argument so the public API surface of `ISdk` stays\n * focused on the core lifecycle and registration methods.\n */\nimport type { Channel, ISdk } from './types'\nimport type { IStream } from './stream'\n\nexport { ChannelDirection, ChannelItem } from './channels'\nexport { extractChannelRefs, isChannelRef } from './utils'\n\ntype IIIWithHelperShims = ISdk & {\n  __helpers_create_channel(bufferSize?: number): Promise<Channel>\n  __helpers_create_stream<T>(name: string, stream: IStream<T>): void\n}\n\n/**\n * Create a streaming channel pair for worker-to-worker data transfer.\n *\n * Free-function form of the previous `ISdk.createChannel` instance method.\n */\nexport function createChannel(iii: ISdk, bufferSize?: number): Promise<Channel> {\n  return (iii as IIIWithHelperShims).__helpers_create_channel(bufferSize)\n}\n\n/**\n * Register a custom stream implementation by wiring its 5 callable methods\n * to `stream::get/set/delete/list/list_groups`.\n *\n * Free-function form of the previous `ISdk.createStream` instance method.\n */\nexport function createStream<TData>(iii: ISdk, streamName: string, stream: IStream<TData>): void {\n  ;(iii as IIIWithHelperShims).__helpers_create_stream(streamName, stream)\n}\n"],"mappings":";;;;;;;;;AAuBA,SAAgB,cAAc,KAAW,YAAuC;AAC9E,QAAQ,IAA2B,yBAAyB,WAAW;;;;;;;;AASzE,SAAgB,aAAoB,KAAW,YAAoB,QAA8B;AAC9F,CAAC,IAA2B,wBAAwB,YAAY,OAAO"}

package/dist/helpers.d.cts

@@ -0,0 +1,38 @@
+import { L as StreamChannelRef, a as ISdk, b as ChannelItem, r as Channel, y as ChannelDirection } from "./types-CP-lPyex.cjs";
+import { IStream } from "./stream.cjs";
+
+//#region src/utils.d.ts
+/**
+ * Type guard that checks if a value is a {@link StreamChannelRef}.
+ *
+ * @param value - Value to check.
+ * @returns `true` if the value is a valid `StreamChannelRef`.
+ */
+declare const isChannelRef: (value: unknown) => value is StreamChannelRef;
+/**
+ * Recursively extract all {@link StreamChannelRef} values from a JSON-like
+ * input, returning each match paired with its dotted/bracketed path. Mirrors
+ * the Rust SDK's `extract_channel_refs`.
+ *
+ * @param data - Arbitrary JSON-like value.
+ * @returns Array of `[path, ref]` tuples. Empty when no refs are found.
+ */
+declare const extractChannelRefs: (data: unknown) => Array<[string, StreamChannelRef]>;
+//#endregion
+//#region src/helpers.d.ts
+/**
+ * Create a streaming channel pair for worker-to-worker data transfer.
+ *
+ * Free-function form of the previous `ISdk.createChannel` instance method.
+ */
+declare function createChannel(iii: ISdk, bufferSize?: number): Promise<Channel>;
+/**
+ * Register a custom stream implementation by wiring its 5 callable methods
+ * to `stream::get/set/delete/list/list_groups`.
+ *
+ * Free-function form of the previous `ISdk.createStream` instance method.
+ */
+declare function createStream<TData>(iii: ISdk, streamName: string, stream: IStream<TData>): void;
+//#endregion
+export { ChannelDirection, ChannelItem, createChannel, createStream, extractChannelRefs, isChannelRef };
+//# sourceMappingURL=helpers.d.cts.map

package/dist/helpers.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.cts","names":[],"sources":["../src/utils.ts","../src/helpers.ts"],"mappings":";;;;;;;;;;cAmCa,YAAA,GAAgB,KAAA,cAAiB,KAAA,IAAS,gBAAA;AAkBvD;;;;;;;;AAAA,cAAa,kBAAA,GAAsB,IAAA,cAAgB,KAAA,UAAe,gBAAA;;;;;AAAlE;;;iBC9BgB,aAAA,CAAc,GAAA,EAAK,IAAA,EAAM,UAAA,YAAsB,OAAA,CAAQ,OAAA;;;;;;;iBAUvD,YAAA,OAAA,CAAoB,GAAA,EAAK,IAAA,EAAM,UAAA,UAAoB,MAAA,EAAQ,OAAA,CAAQ,KAAA"}

package/dist/helpers.d.mts

@@ -0,0 +1,38 @@
+import { L as StreamChannelRef, a as ISdk, b as ChannelItem, r as Channel, y as ChannelDirection } from "./types-Bw88g_Jj.mjs";
+import { IStream } from "./stream.mjs";
+
+//#region src/utils.d.ts
+/**
+ * Type guard that checks if a value is a {@link StreamChannelRef}.
+ *
+ * @param value - Value to check.
+ * @returns `true` if the value is a valid `StreamChannelRef`.
+ */
+declare const isChannelRef: (value: unknown) => value is StreamChannelRef;
+/**
+ * Recursively extract all {@link StreamChannelRef} values from a JSON-like
+ * input, returning each match paired with its dotted/bracketed path. Mirrors
+ * the Rust SDK's `extract_channel_refs`.
+ *
+ * @param data - Arbitrary JSON-like value.
+ * @returns Array of `[path, ref]` tuples. Empty when no refs are found.
+ */
+declare const extractChannelRefs: (data: unknown) => Array<[string, StreamChannelRef]>;
+//#endregion
+//#region src/helpers.d.ts
+/**
+ * Create a streaming channel pair for worker-to-worker data transfer.
+ *
+ * Free-function form of the previous `ISdk.createChannel` instance method.
+ */
+declare function createChannel(iii: ISdk, bufferSize?: number): Promise<Channel>;
+/**
+ * Register a custom stream implementation by wiring its 5 callable methods
+ * to `stream::get/set/delete/list/list_groups`.
+ *
+ * Free-function form of the previous `ISdk.createStream` instance method.
+ */
+declare function createStream<TData>(iii: ISdk, streamName: string, stream: IStream<TData>): void;
+//#endregion
+export { ChannelDirection, ChannelItem, createChannel, createStream, extractChannelRefs, isChannelRef };
+//# sourceMappingURL=helpers.d.mts.map

package/dist/helpers.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.mts","names":[],"sources":["../src/utils.ts","../src/helpers.ts"],"mappings":";;;;;;;;;;cAmCa,YAAA,GAAgB,KAAA,cAAiB,KAAA,IAAS,gBAAA;AAkBvD;;;;;;;;AAAA,cAAa,kBAAA,GAAsB,IAAA,cAAgB,KAAA,UAAe,gBAAA;;;;;AAAlE;;;iBC9BgB,aAAA,CAAc,GAAA,EAAK,IAAA,EAAM,UAAA,YAAsB,OAAA,CAAQ,OAAA;;;;;;;iBAUvD,YAAA,OAAA,CAAoB,GAAA,EAAK,IAAA,EAAM,UAAA,UAAoB,MAAA,EAAQ,OAAA,CAAQ,KAAA"}

package/dist/helpers.mjs

@@ -0,0 +1,24 @@
+import { i as ChannelItem, n as isChannelRef, r as ChannelDirection, t as extractChannelRefs } from "./utils-CwkqVmBx.mjs";
+
+//#region src/helpers.ts
+/**
+* Create a streaming channel pair for worker-to-worker data transfer.
+*
+* Free-function form of the previous `ISdk.createChannel` instance method.
+*/
+function createChannel(iii, bufferSize) {
+	return iii.__helpers_create_channel(bufferSize);
+}
+/**
+* Register a custom stream implementation by wiring its 5 callable methods
+* to `stream::get/set/delete/list/list_groups`.
+*
+* Free-function form of the previous `ISdk.createStream` instance method.
+*/
+function createStream(iii, streamName, stream) {
+	iii.__helpers_create_stream(streamName, stream);
+}
+
+//#endregion
+export { ChannelDirection, ChannelItem, createChannel, createStream, extractChannelRefs, isChannelRef };
+//# sourceMappingURL=helpers.mjs.map

package/dist/helpers.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.mjs","names":[],"sources":["../src/helpers.ts"],"sourcesContent":["/**\n * Helper free functions that operate on an {@link ISdk} instance.\n *\n * These were previously instance methods on the SDK. They take the iii\n * instance as the first argument so the public API surface of `ISdk` stays\n * focused on the core lifecycle and registration methods.\n */\nimport type { Channel, ISdk } from './types'\nimport type { IStream } from './stream'\n\nexport { ChannelDirection, ChannelItem } from './channels'\nexport { extractChannelRefs, isChannelRef } from './utils'\n\ntype IIIWithHelperShims = ISdk & {\n  __helpers_create_channel(bufferSize?: number): Promise<Channel>\n  __helpers_create_stream<T>(name: string, stream: IStream<T>): void\n}\n\n/**\n * Create a streaming channel pair for worker-to-worker data transfer.\n *\n * Free-function form of the previous `ISdk.createChannel` instance method.\n */\nexport function createChannel(iii: ISdk, bufferSize?: number): Promise<Channel> {\n  return (iii as IIIWithHelperShims).__helpers_create_channel(bufferSize)\n}\n\n/**\n * Register a custom stream implementation by wiring its 5 callable methods\n * to `stream::get/set/delete/list/list_groups`.\n *\n * Free-function form of the previous `ISdk.createStream` instance method.\n */\nexport function createStream<TData>(iii: ISdk, streamName: string, stream: IStream<TData>): void {\n  ;(iii as IIIWithHelperShims).__helpers_create_stream(streamName, stream)\n}\n"],"mappings":";;;;;;;;AAuBA,SAAgB,cAAc,KAAW,YAAuC;AAC9E,QAAQ,IAA2B,yBAAyB,WAAW;;;;;;;;AASzE,SAAgB,aAAoB,KAAW,YAAoB,QAA8B;AAC9F,CAAC,IAA2B,wBAAwB,YAAY,OAAO"}

package/dist/index.cjs

@@ -1,167 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_utils = require('./utils-Cq61lImK.cjs');
 
-//#region src/channels.ts
-/**
-* Write end of a streaming channel. Uses native browser WebSocket.
-*
-* @example
-* ```typescript
-* const channel = await iii.createChannel()
-*
-* channel.writer.sendMessage(JSON.stringify({ type: 'event', data: 'test' }))
-* channel.writer.sendBinary(new Uint8Array([1, 2, 3]))
-* channel.writer.close()
-* ```
-*/
-var ChannelWriter = class ChannelWriter {
-	static {
-		this.FRAME_SIZE = 64 * 1024;
-	}
-	constructor(engineWsBase, ref) {
-		this.ws = null;
-		this.wsReady = false;
-		this.pendingMessages = [];
-		this.url = buildChannelUrl(engineWsBase, ref.channel_id, ref.access_key, "write");
-	}
-	ensureConnected() {
-		if (this.ws) return;
-		this.ws = new WebSocket(this.url);
-		this.ws.binaryType = "arraybuffer";
-		this.ws.addEventListener("open", () => {
-			this.wsReady = true;
-			for (const { data, resolve, reject } of this.pendingMessages) try {
-				this.ws?.send(data);
-				resolve();
-			} catch (err) {
-				reject(err instanceof Error ? err : new Error(String(err)));
-			}
-			this.pendingMessages.length = 0;
-		});
-		this.ws.addEventListener("error", () => {
-			for (const { reject } of this.pendingMessages) reject(/* @__PURE__ */ new Error("WebSocket error"));
-			this.pendingMessages.length = 0;
-		});
-	}
-	/** Send a text message through the channel. */
-	sendMessage(msg) {
-		this.ensureConnected();
-		this.sendRaw(msg);
-	}
-	/** Send binary data through the channel. */
-	sendBinary(data) {
-		this.ensureConnected();
-		let offset = 0;
-		while (offset < data.length) {
-			const end = Math.min(offset + ChannelWriter.FRAME_SIZE, data.length);
-			const chunk = data.subarray(offset, end);
-			const buffer = chunk.buffer instanceof ArrayBuffer ? chunk.buffer : new ArrayBuffer(chunk.byteLength);
-			if (!(chunk.buffer instanceof ArrayBuffer)) new Uint8Array(buffer).set(chunk);
-			this.sendRaw(buffer.slice(chunk.byteOffset, chunk.byteOffset + chunk.byteLength));
-			offset = end;
-		}
-	}
-	/** Close the channel writer. */
-	close() {
-		if (!this.ws) return;
-		const doClose = () => {
-			if (this.ws && this.ws.readyState === WebSocket.OPEN) this.ws.close(1e3, "channel_close");
-		};
-		if (this.wsReady) doClose();
-		else this.ws.addEventListener("open", () => doClose());
-	}
-	sendRaw(data) {
-		if (this.wsReady && this.ws && this.ws.readyState === WebSocket.OPEN) this.ws.send(data);
-		else {
-			this.ensureConnected();
-			this.pendingMessages.push({
-				data,
-				resolve: () => {},
-				reject: () => {
-					console.error("Failed to send message");
-				}
-			});
-		}
-	}
-};
-/**
-* Read end of a streaming channel. Uses native browser WebSocket.
-*
-* @example
-* ```typescript
-* const channel = await iii.createChannel()
-*
-* channel.reader.onMessage((msg) => console.log('Got:', msg))
-* channel.reader.onBinary((data) => console.log('Binary:', data.byteLength))
-* ```
-*/
-var ChannelReader = class {
-	constructor(engineWsBase, ref) {
-		this.ws = null;
-		this.connected = false;
-		this.messageCallbacks = [];
-		this.binaryCallbacks = [];
-		this.url = buildChannelUrl(engineWsBase, ref.channel_id, ref.access_key, "read");
-	}
-	ensureConnected() {
-		if (this.connected) return;
-		this.connected = true;
-		this.ws = new WebSocket(this.url);
-		this.ws.binaryType = "arraybuffer";
-		this.ws.addEventListener("message", (event) => {
-			if (event.data instanceof ArrayBuffer) {
-				const data = new Uint8Array(event.data);
-				for (const cb of this.binaryCallbacks) cb(data);
-			} else if (typeof event.data === "string") for (const cb of this.messageCallbacks) cb(event.data);
-		});
-		this.ws.addEventListener("close", () => {
-			this.ws = null;
-		});
-		this.ws.addEventListener("error", () => {
-			this.ws = null;
-		});
-	}
-	/** Register a callback to receive text messages from the channel. */
-	onMessage(callback) {
-		this.messageCallbacks.push(callback);
-		this.ensureConnected();
-	}
-	/** Register a callback to receive binary data from the channel. */
-	onBinary(callback) {
-		this.binaryCallbacks.push(callback);
-		this.ensureConnected();
-	}
-	/** Read all binary data from the channel until it closes. */
-	async readAll() {
-		this.ensureConnected();
-		const chunks = [];
-		return new Promise((resolve) => {
-			const onData = (data) => {
-				chunks.push(data);
-			};
-			this.binaryCallbacks.push(onData);
-			const originalWs = this.ws;
-			if (originalWs) originalWs.addEventListener("close", () => {
-				const totalLength = chunks.reduce((sum, c) => sum + c.length, 0);
-				const result = new Uint8Array(totalLength);
-				let offset = 0;
-				for (const chunk of chunks) {
-					result.set(chunk, offset);
-					offset += chunk.length;
-				}
-				resolve(result);
-			});
-		});
-	}
-	/** Close the channel reader. */
-	close() {
-		if (this.ws && this.ws.readyState !== WebSocket.CLOSED) this.ws.close(1e3, "channel_close");
-	}
-};
-function buildChannelUrl(engineWsBase, channelId, accessKey, direction) {
-	return `${engineWsBase.replace(/\/$/, "")}/ws/channels/${channelId}?key=${encodeURIComponent(accessKey)}&dir=${direction}`;
-}
-
-//#endregion
 //#region src/iii-constants.ts
 /**
 * Constants for the III module.
@@ -215,20 +54,6 @@ let MessageType = /* @__PURE__ */ function(MessageType) {
 	return MessageType;
 }({});
 
-//#endregion
-//#region src/utils.ts
-/**
-* Type guard that checks if a value is a {@link StreamChannelRef}.
-*
-* @param value - Value to check.
-* @returns `true` if the value is a valid `StreamChannelRef`.
-*/
-const isChannelRef = (value) => {
-	if (typeof value !== "object" || value === null) return false;
-	const maybe = value;
-	return typeof maybe.channel_id === "string" && typeof maybe.access_key === "string" && (maybe.direction === "read" || maybe.direction === "write");
-};
-
 //#endregion
 //#region src/iii.ts
 var Sdk = class {
@@ -322,14 +147,14 @@ var Sdk = class {
 				}
 			};
 		};
-		this.createChannel = async (bufferSize) => {
+		this.__helpers_create_channel = async (bufferSize) => {
 			const result = await this.trigger({
 				function_id: "engine::channels::create",
 				payload: { buffer_size: bufferSize }
 			});
 			return {
-				writer: new ChannelWriter(this.address, result.writer),
-				reader: new ChannelReader(this.address, result.reader),
+				writer: new require_utils.ChannelWriter(this.address, result.writer),
+				reader: new require_utils.ChannelReader(this.address, result.reader),
 				writerRef: result.writer,
 				readerRef: result.reader
 			};
@@ -372,7 +197,7 @@ var Sdk = class {
 				});
 			});
 		};
-		this.createStream = (streamName, stream) => {
+		this.__helpers_create_stream = (streamName, stream) => {
 			this.registerFunction(`stream::get(${streamName})`, stream.get.bind(stream));
 			this.registerFunction(`stream::set(${streamName})`, stream.set.bind(stream));
 			this.registerFunction(`stream::delete(${streamName})`, stream.delete.bind(stream));
@@ -550,7 +375,7 @@ var Sdk = class {
 		this.invocations.delete(invocation_id);
 	}
 	resolveChannelValue(value) {
-		if (isChannelRef(value)) return value.direction === "read" ? new ChannelReader(this.address, value) : new ChannelWriter(this.address, value);
+		if (require_utils.isChannelRef(value)) return value.direction === "read" ? new require_utils.ChannelReader(this.address, value) : new require_utils.ChannelWriter(this.address, value);
 		if (Array.isArray(value)) return value.map((item) => this.resolveChannelValue(item));
 		if (value !== null && typeof value === "object") {
 			const out = {};
@@ -715,8 +540,8 @@ const TriggerAction = {
 const registerWorker = (address, options) => new Sdk(address, options);
 
 //#endregion
-exports.ChannelReader = ChannelReader;
-exports.ChannelWriter = ChannelWriter;
+exports.ChannelReader = require_utils.ChannelReader;
+exports.ChannelWriter = require_utils.ChannelWriter;
 exports.EngineFunctions = EngineFunctions;
 exports.EngineTriggers = EngineTriggers;
 exports.TriggerAction = TriggerAction;