iii-sdk 0.19.3-next.1 → 0.19.4-alpha.1

package/dist/channel.cjs

@@ -0,0 +1,5 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_channels = require('./channels-huduKJ-b.cjs');
+
+exports.ChannelReader = require_channels.ChannelReader;
+exports.ChannelWriter = require_channels.ChannelWriter;

package/dist/channel.d.cts

@@ -0,0 +1,2 @@
+import { O as StreamChannelRef, b as ChannelWriter, t as Channel, y as ChannelReader } from "./types-gwm9j9oD.cjs";
+export { type Channel, ChannelReader, ChannelWriter, type StreamChannelRef };

package/dist/channel.d.mts

@@ -0,0 +1,2 @@
+import { O as StreamChannelRef, b as ChannelWriter, t as Channel, y as ChannelReader } from "./types-DduY0ha2.mjs";
+export { type Channel, ChannelReader, ChannelWriter, type StreamChannelRef };

package/dist/channel.mjs

@@ -0,0 +1,3 @@
+import { i as ChannelWriter, r as ChannelReader } from "./channels-BFs4n1g6.mjs";
+
+export { ChannelReader, ChannelWriter };

package/dist/{utils-DXL7JI0q.mjs → channels-BFs4n1g6.mjs}

@@ -1,7 +1,5 @@
 import { Readable, Writable } from "node:stream";
 import { WebSocket } from "ws";
-import * as fs from "node:fs";
-import * as path from "node:path";
 
 //#region src/channels.ts
 /**
@@ -212,108 +210,5 @@ function buildChannelUrl(engineWsBase, channelId, accessKey, direction) {
 }
 
 //#endregion
-//#region src/utils.ts
-/**
-* Returns a project identifier for telemetry, derived from the current working
-* directory. Reads `package.json` `name` if present at `cwd`; otherwise falls
-* back to the basename of `cwd`. Returns `undefined` only when both signals
-* are unavailable (e.g. cwd is the filesystem root).
-*
-* No directory walking — only inspects `cwd` itself, so the SDK never reads
-* files outside the user's explicit working directory.
-*/
-function detectProjectName(cwd = process.cwd()) {
-	try {
-		const manifest = path.join(cwd, "package.json");
-		if (fs.existsSync(manifest)) {
-			const parsed = JSON.parse(fs.readFileSync(manifest, "utf8"));
-			if (typeof parsed.name === "string") {
-				const trimmed = parsed.name.trim();
-				if (trimmed) return trimmed;
-			}
-		}
-	} catch {}
-	return path.basename(cwd).trim() || void 0;
-}
-/**
-* Helper that wraps an HTTP-style handler (with separate `req`/`res` arguments)
-* into the function handler format expected by the SDK.
-*
-* @param callback - Async handler receiving an {@link HttpRequest} and {@link HttpResponse}.
-* @returns A function handler compatible with {@link ISdk.registerFunction}.
-*
-* @example
-* ```typescript
-* import { http } from 'iii-sdk'
-*
-* iii.registerFunction(
-*   'my-api',
-*   http(async (req, res) => {
-*     res.status(200)
-*     res.headers({ 'content-type': 'application/json' })
-*     res.stream.end(JSON.stringify({ hello: 'world' }))
-*     res.close()
-*   }),
-* )
-* ```
-*/
-const http = (callback) => {
-	return async (req) => {
-		const { response, ...request } = req;
-		return callback(request, {
-			status: (status_code) => response.sendMessage(JSON.stringify({
-				type: "set_status",
-				status_code
-			})),
-			headers: (headers) => response.sendMessage(JSON.stringify({
-				type: "set_headers",
-				headers
-			})),
-			stream: response.stream,
-			close: () => response.close()
-		});
-	};
-};
-/**
-* 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");
-};
-/**
-* 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.
-*/
-const extractChannelRefs = (data) => {
-	const refs = [];
-	extractRefsRecursive(data, "", refs);
-	return refs;
-};
-const extractRefsRecursive = (data, prefix, refs) => {
-	if (isChannelRef(data)) {
-		refs.push([prefix, data]);
-		return;
-	}
-	if (Array.isArray(data)) {
-		for (let i = 0; i < data.length; i++) {
-			const path = prefix === "" ? `[${i}]` : `${prefix}[${i}]`;
-			extractRefsRecursive(data[i], path, refs);
-		}
-		return;
-	}
-	if (typeof data !== "object" || data === null) return;
-	for (const [key, value] of Object.entries(data)) extractRefsRecursive(value, prefix === "" ? key : `${prefix}.${key}`, refs);
-};
-
-//#endregion
-export { ChannelDirection as a, ChannelWriter as c, isChannelRef as i, extractChannelRefs as n, ChannelItem as o, http as r, ChannelReader as s, detectProjectName as t };
-//# sourceMappingURL=utils-DXL7JI0q.mjs.map
+export { ChannelWriter as i, ChannelItem as n, ChannelReader as r, ChannelDirection as t };
+//# sourceMappingURL=channels-BFs4n1g6.mjs.map

package/dist/channels-BFs4n1g6.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"channels-BFs4n1g6.mjs","names":[],"sources":["../src/channels.ts"],"sourcesContent":["import { Readable, Writable } from 'node:stream'\nimport { WebSocket } from 'ws'\nimport 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. Provides both a Node.js `Writable` stream\n * and a `sendMessage` method for sending structured text messages.\n *\n * @example\n * ```typescript\n * import { createChannel } from 'iii-sdk/helpers'\n * const channel = await createChannel(iii)\n *\n * // Stream binary data\n * channel.writer.stream.write(Buffer.from('hello'))\n * channel.writer.stream.end()\n *\n * // Or send text messages\n * channel.writer.sendMessage(JSON.stringify({ type: 'event', data: 'test' }))\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: Buffer | string\n    callback: (err?: Error | null) => void\n  }[] = []\n  /** Node.js Writable stream for binary data. */\n  public readonly stream: Writable\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    this.stream = new Writable({\n      write: (chunk: Buffer, _encoding, callback) => {\n        const buf = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk)\n        this.sendChunked(buf, callback)\n      },\n      final: (callback) => {\n        if (!this.ws) {\n          callback()\n          return\n        }\n        // Delay the close frame slightly to allow the TCP stack to flush\n        // all buffered send() data. Without this, the close frame can arrive\n        // at the engine before all data frames, causing data truncation.\n        const doClose = () => {\n          if (this.ws) {\n            this.ws.close(1000, 'stream_complete')\n          }\n          callback()\n        }\n        if (this.wsReady) {\n          setTimeout(doClose, 10)\n        } else {\n          this.ws.on('open', () => setTimeout(doClose, 10))\n        }\n      },\n      destroy: (err, callback) => {\n        if (this.ws) this.ws.terminate()\n        callback(err)\n      },\n    })\n  }\n\n  private ensureConnected(): void {\n    if (this.ws) return\n    this.ws = new WebSocket(this.url)\n\n    this.ws.on('open', () => {\n      this.wsReady = true\n      for (const { data, callback } of this.pendingMessages) {\n        this.ws?.send(data, callback)\n      }\n      this.pendingMessages.length = 0\n    })\n\n    this.ws.on('error', (err) => {\n      this.stream.destroy(err)\n    })\n\n    this.ws.on('close', () => {\n      if (!this.stream.destroyed) {\n        this.stream.destroy()\n      }\n    })\n  }\n\n  /** Send a text message through the channel. */\n  sendMessage(msg: string): void {\n    this.ensureConnected()\n    this.sendRaw(msg, (err) => {\n      if (err) this.stream.destroy(err)\n    })\n  }\n\n  /** Close the channel writer. */\n  close(): void {\n    if (!this.ws) return\n    const doClose = () => {\n      if (this.ws) {\n        this.ws.close(1000, 'channel_close')\n      }\n    }\n    if (this.wsReady) {\n      doClose()\n    } else {\n      this.ws.on('open', () => doClose())\n    }\n  }\n\n  private sendChunked(data: Buffer, callback: (err?: Error | null) => void): void {\n    let offset = 0\n    const sendNext = (err?: Error | null): void => {\n      if (err) {\n        callback(err)\n        return\n      }\n\n      if (offset >= data.length) {\n        callback(null)\n        return\n      }\n\n      const end = Math.min(offset + ChannelWriter.FRAME_SIZE, data.length)\n      const part = data.subarray(offset, end)\n      offset = end\n      this.sendRaw(part, sendNext)\n    }\n    sendNext(null)\n  }\n\n  private sendRaw(data: Buffer | string, callback: (err?: Error | null) => void): void {\n    this.ensureConnected()\n    if (this.wsReady && this.ws) {\n      this.ws.send(data, (err) => callback(err ?? null))\n    } else {\n      this.pendingMessages.push({ data, callback })\n    }\n  }\n}\n\n/**\n * Read end of a streaming channel. Provides both a Node.js `Readable` stream\n * for binary data and an `onMessage` callback for structured text messages.\n *\n * @example\n * ```typescript\n * import { createChannel } from 'iii-sdk/helpers'\n * const channel = await createChannel(iii)\n *\n * // Stream binary data\n * channel.reader.stream.on('data', (chunk) => console.log(chunk))\n *\n * // Or receive text messages\n * channel.reader.onMessage((msg) => console.log('Got:', msg))\n * ```\n */\nexport class ChannelReader {\n  private ws: WebSocket | null = null\n  private connected = false\n  private readonly messageCallbacks: Array<(msg: string) => void> = []\n  /** Node.js Readable stream for binary data. */\n  public readonly stream: Readable\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    const self = this\n    this.stream = new Readable({\n      read() {\n        self.ensureConnected()\n        if (self.ws) self.ws.resume()\n      },\n      destroy(err, callback) {\n        if (self.ws && self.ws.readyState !== WebSocket.CLOSED) {\n          self.ws.terminate()\n        }\n        self.ws = null\n        callback(err)\n      },\n    })\n  }\n\n  private ensureConnected(): void {\n    if (this.connected) return\n    this.connected = true\n    this.ws = new WebSocket(this.url)\n\n    this.ws.on('open', () => {\n      ;(this.ws as unknown as { binaryType: string }).binaryType = 'nodebuffer'\n    })\n\n    this.ws.on('message', (data: Buffer, isBinary: boolean) => {\n      if (isBinary) {\n        if (!this.stream.push(data)) {\n          this.ws?.pause()\n        }\n      } else {\n        const msg = data.toString('utf-8')\n        for (const cb of this.messageCallbacks) {\n          cb(msg)\n        }\n      }\n    })\n\n    this.ws.on('close', () => {\n      this.ws = null\n      if (!this.stream.destroyed) this.stream.push(null)\n    })\n\n    this.ws.on('error', (err) => {\n      this.stream.destroy(err)\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  }\n\n  async readAll(): Promise<Buffer> {\n    this.ensureConnected()\n    const chunks: Buffer[] = []\n\n    for await (const chunk of this.stream) {\n      chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk))\n    }\n\n    return Buffer.concat(chunks)\n  }\n\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"],"mappings":"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"}

package/dist/{utils-CuS1Knym.cjs → channels-huduKJ-b.cjs}

@@ -1,36 +1,6 @@
-//#region \0rolldown/runtime.js
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __copyProps = (to, from, except, desc) => {
-	if (from && typeof from === "object" || typeof from === "function") {
-		for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
-			key = keys[i];
-			if (!__hasOwnProp.call(to, key) && key !== except) {
-				__defProp(to, key, {
-					get: ((k) => from[k]).bind(null, key),
-					enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
-				});
-			}
-		}
-	}
-	return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
-	value: mod,
-	enumerable: true
-}) : target, mod));
-
-//#endregion
+const require_utils = require('./utils-BtEFReHq.cjs');
 let node_stream = require("node:stream");
 let ws = require("ws");
-let node_fs = require("node:fs");
-node_fs = __toESM(node_fs);
-let node_path = require("node:path");
-node_path = __toESM(node_path);
 
 //#region src/channels.ts
 /**
@@ -240,109 +210,6 @@ function buildChannelUrl(engineWsBase, channelId, accessKey, direction) {
 	return `${engineWsBase.replace(/\/$/, "")}/ws/channels/${channelId}?key=${encodeURIComponent(accessKey)}&dir=${direction}`;
 }
 
-//#endregion
-//#region src/utils.ts
-/**
-* Returns a project identifier for telemetry, derived from the current working
-* directory. Reads `package.json` `name` if present at `cwd`; otherwise falls
-* back to the basename of `cwd`. Returns `undefined` only when both signals
-* are unavailable (e.g. cwd is the filesystem root).
-*
-* No directory walking — only inspects `cwd` itself, so the SDK never reads
-* files outside the user's explicit working directory.
-*/
-function detectProjectName(cwd = process.cwd()) {
-	try {
-		const manifest = node_path.join(cwd, "package.json");
-		if (node_fs.existsSync(manifest)) {
-			const parsed = JSON.parse(node_fs.readFileSync(manifest, "utf8"));
-			if (typeof parsed.name === "string") {
-				const trimmed = parsed.name.trim();
-				if (trimmed) return trimmed;
-			}
-		}
-	} catch {}
-	return node_path.basename(cwd).trim() || void 0;
-}
-/**
-* Helper that wraps an HTTP-style handler (with separate `req`/`res` arguments)
-* into the function handler format expected by the SDK.
-*
-* @param callback - Async handler receiving an {@link HttpRequest} and {@link HttpResponse}.
-* @returns A function handler compatible with {@link ISdk.registerFunction}.
-*
-* @example
-* ```typescript
-* import { http } from 'iii-sdk'
-*
-* iii.registerFunction(
-*   'my-api',
-*   http(async (req, res) => {
-*     res.status(200)
-*     res.headers({ 'content-type': 'application/json' })
-*     res.stream.end(JSON.stringify({ hello: 'world' }))
-*     res.close()
-*   }),
-* )
-* ```
-*/
-const http = (callback) => {
-	return async (req) => {
-		const { response, ...request } = req;
-		return callback(request, {
-			status: (status_code) => response.sendMessage(JSON.stringify({
-				type: "set_status",
-				status_code
-			})),
-			headers: (headers) => response.sendMessage(JSON.stringify({
-				type: "set_headers",
-				headers
-			})),
-			stream: response.stream,
-			close: () => response.close()
-		});
-	};
-};
-/**
-* 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");
-};
-/**
-* 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.
-*/
-const extractChannelRefs = (data) => {
-	const refs = [];
-	extractRefsRecursive(data, "", refs);
-	return refs;
-};
-const extractRefsRecursive = (data, prefix, refs) => {
-	if (isChannelRef(data)) {
-		refs.push([prefix, data]);
-		return;
-	}
-	if (Array.isArray(data)) {
-		for (let i = 0; i < data.length; i++) {
-			const path = prefix === "" ? `[${i}]` : `${prefix}[${i}]`;
-			extractRefsRecursive(data[i], path, refs);
-		}
-		return;
-	}
-	if (typeof data !== "object" || data === null) return;
-	for (const [key, value] of Object.entries(data)) extractRefsRecursive(value, prefix === "" ? key : `${prefix}.${key}`, refs);
-};
-
 //#endregion
 Object.defineProperty(exports, 'ChannelDirection', {
   enumerable: true,
@@ -368,34 +235,4 @@ Object.defineProperty(exports, 'ChannelWriter', {
     return ChannelWriter;
   }
 });
-Object.defineProperty(exports, '__toESM', {
-  enumerable: true,
-  get: function () {
-    return __toESM;
-  }
-});
-Object.defineProperty(exports, 'detectProjectName', {
-  enumerable: true,
-  get: function () {
-    return detectProjectName;
-  }
-});
-Object.defineProperty(exports, 'extractChannelRefs', {
-  enumerable: true,
-  get: function () {
-    return extractChannelRefs;
-  }
-});
-Object.defineProperty(exports, 'http', {
-  enumerable: true,
-  get: function () {
-    return http;
-  }
-});
-Object.defineProperty(exports, 'isChannelRef', {
-  enumerable: true,
-  get: function () {
-    return isChannelRef;
-  }
-});
-//# sourceMappingURL=utils-CuS1Knym.cjs.map
+//# sourceMappingURL=channels-huduKJ-b.cjs.map

package/dist/channels-huduKJ-b.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"channels-huduKJ-b.cjs","names":["Writable","WebSocket","Readable"],"sources":["../src/channels.ts"],"sourcesContent":["import { Readable, Writable } from 'node:stream'\nimport { WebSocket } from 'ws'\nimport 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. Provides both a Node.js `Writable` stream\n * and a `sendMessage` method for sending structured text messages.\n *\n * @example\n * ```typescript\n * import { createChannel } from 'iii-sdk/helpers'\n * const channel = await createChannel(iii)\n *\n * // Stream binary data\n * channel.writer.stream.write(Buffer.from('hello'))\n * channel.writer.stream.end()\n *\n * // Or send text messages\n * channel.writer.sendMessage(JSON.stringify({ type: 'event', data: 'test' }))\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: Buffer | string\n    callback: (err?: Error | null) => void\n  }[] = []\n  /** Node.js Writable stream for binary data. */\n  public readonly stream: Writable\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    this.stream = new Writable({\n      write: (chunk: Buffer, _encoding, callback) => {\n        const buf = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk)\n        this.sendChunked(buf, callback)\n      },\n      final: (callback) => {\n        if (!this.ws) {\n          callback()\n          return\n        }\n        // Delay the close frame slightly to allow the TCP stack to flush\n        // all buffered send() data. Without this, the close frame can arrive\n        // at the engine before all data frames, causing data truncation.\n        const doClose = () => {\n          if (this.ws) {\n            this.ws.close(1000, 'stream_complete')\n          }\n          callback()\n        }\n        if (this.wsReady) {\n          setTimeout(doClose, 10)\n        } else {\n          this.ws.on('open', () => setTimeout(doClose, 10))\n        }\n      },\n      destroy: (err, callback) => {\n        if (this.ws) this.ws.terminate()\n        callback(err)\n      },\n    })\n  }\n\n  private ensureConnected(): void {\n    if (this.ws) return\n    this.ws = new WebSocket(this.url)\n\n    this.ws.on('open', () => {\n      this.wsReady = true\n      for (const { data, callback } of this.pendingMessages) {\n        this.ws?.send(data, callback)\n      }\n      this.pendingMessages.length = 0\n    })\n\n    this.ws.on('error', (err) => {\n      this.stream.destroy(err)\n    })\n\n    this.ws.on('close', () => {\n      if (!this.stream.destroyed) {\n        this.stream.destroy()\n      }\n    })\n  }\n\n  /** Send a text message through the channel. */\n  sendMessage(msg: string): void {\n    this.ensureConnected()\n    this.sendRaw(msg, (err) => {\n      if (err) this.stream.destroy(err)\n    })\n  }\n\n  /** Close the channel writer. */\n  close(): void {\n    if (!this.ws) return\n    const doClose = () => {\n      if (this.ws) {\n        this.ws.close(1000, 'channel_close')\n      }\n    }\n    if (this.wsReady) {\n      doClose()\n    } else {\n      this.ws.on('open', () => doClose())\n    }\n  }\n\n  private sendChunked(data: Buffer, callback: (err?: Error | null) => void): void {\n    let offset = 0\n    const sendNext = (err?: Error | null): void => {\n      if (err) {\n        callback(err)\n        return\n      }\n\n      if (offset >= data.length) {\n        callback(null)\n        return\n      }\n\n      const end = Math.min(offset + ChannelWriter.FRAME_SIZE, data.length)\n      const part = data.subarray(offset, end)\n      offset = end\n      this.sendRaw(part, sendNext)\n    }\n    sendNext(null)\n  }\n\n  private sendRaw(data: Buffer | string, callback: (err?: Error | null) => void): void {\n    this.ensureConnected()\n    if (this.wsReady && this.ws) {\n      this.ws.send(data, (err) => callback(err ?? null))\n    } else {\n      this.pendingMessages.push({ data, callback })\n    }\n  }\n}\n\n/**\n * Read end of a streaming channel. Provides both a Node.js `Readable` stream\n * for binary data and an `onMessage` callback for structured text messages.\n *\n * @example\n * ```typescript\n * import { createChannel } from 'iii-sdk/helpers'\n * const channel = await createChannel(iii)\n *\n * // Stream binary data\n * channel.reader.stream.on('data', (chunk) => console.log(chunk))\n *\n * // Or receive text messages\n * channel.reader.onMessage((msg) => console.log('Got:', msg))\n * ```\n */\nexport class ChannelReader {\n  private ws: WebSocket | null = null\n  private connected = false\n  private readonly messageCallbacks: Array<(msg: string) => void> = []\n  /** Node.js Readable stream for binary data. */\n  public readonly stream: Readable\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    const self = this\n    this.stream = new Readable({\n      read() {\n        self.ensureConnected()\n        if (self.ws) self.ws.resume()\n      },\n      destroy(err, callback) {\n        if (self.ws && self.ws.readyState !== WebSocket.CLOSED) {\n          self.ws.terminate()\n        }\n        self.ws = null\n        callback(err)\n      },\n    })\n  }\n\n  private ensureConnected(): void {\n    if (this.connected) return\n    this.connected = true\n    this.ws = new WebSocket(this.url)\n\n    this.ws.on('open', () => {\n      ;(this.ws as unknown as { binaryType: string }).binaryType = 'nodebuffer'\n    })\n\n    this.ws.on('message', (data: Buffer, isBinary: boolean) => {\n      if (isBinary) {\n        if (!this.stream.push(data)) {\n          this.ws?.pause()\n        }\n      } else {\n        const msg = data.toString('utf-8')\n        for (const cb of this.messageCallbacks) {\n          cb(msg)\n        }\n      }\n    })\n\n    this.ws.on('close', () => {\n      this.ws = null\n      if (!this.stream.destroyed) this.stream.push(null)\n    })\n\n    this.ws.on('error', (err) => {\n      this.stream.destroy(err)\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  }\n\n  async readAll(): Promise<Buffer> {\n    this.ensureConnected()\n    const chunks: Buffer[] = []\n\n    for await (const chunk of this.stream) {\n      chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk))\n    }\n\n    return Buffer.concat(chunks)\n  }\n\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"],"mappings":"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"}

package/dist/engine.cjs

@@ -0,0 +1,5 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_iii_constants = require('./iii-constants-Br94RUNi.cjs');
+
+exports.EngineFunctions = require_iii_constants.EngineFunctions;
+exports.EngineTriggers = require_iii_constants.EngineTriggers;

package/dist/engine.d.cts

@@ -0,0 +1,3 @@
+import { u as RemoteFunctionHandler } from "./types-gwm9j9oD.cjs";
+import { n as EngineTriggers, t as EngineFunctions } from "./iii-constants-BqXp8xSN.cjs";
+export { EngineFunctions, EngineTriggers, type RemoteFunctionHandler };

package/dist/engine.d.mts

@@ -0,0 +1,3 @@
+import { u as RemoteFunctionHandler } from "./types-DduY0ha2.mjs";
+import { n as EngineTriggers, t as EngineFunctions } from "./iii-constants-Baptl8nm.mjs";
+export { EngineFunctions, EngineTriggers, type RemoteFunctionHandler };

package/dist/engine.mjs

@@ -0,0 +1,3 @@
+import { i as EngineTriggers, r as EngineFunctions } from "./iii-constants-_k3SoHry.mjs";
+
+export { EngineFunctions, EngineTriggers };

package/dist/errors.cjs

@@ -0,0 +1,33 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+//#region src/errors.ts
+var InvocationError = class extends Error {
+	constructor(init) {
+		super(`${init.code}: ${init.message}`);
+		this.name = "InvocationError";
+		this.code = init.code;
+		this.function_id = init.function_id;
+		this.stacktrace = init.stacktrace;
+	}
+};
+/**
+* True when `value` looks like the wire `ErrorBody` the engine sends in
+* `InvocationResult.error`: `{ code: string, message: string, stacktrace?: string }`.
+* Used to distinguish an engine rejection (which we wrap in
+* {@link InvocationError}) from a JS `Error` thrown elsewhere.
+*/
+function isErrorBody(value) {
+	if (typeof value !== "object" || value === null) return false;
+	const v = value;
+	return typeof v.code === "string" && typeof v.message === "string" && (v.stacktrace === void 0 || typeof v.stacktrace === "string");
+}
+/**
+* @deprecated Renamed to {@link InvocationError}; import from `iii-sdk/errors`.
+*/
+const IIIInvocationError = InvocationError;
+
+//#endregion
+exports.IIIInvocationError = IIIInvocationError;
+exports.InvocationError = InvocationError;
+exports.isErrorBody = isErrorBody;
+//# sourceMappingURL=errors.cjs.map

package/dist/errors.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.cjs","names":[],"sources":["../src/errors.ts"],"sourcesContent":["/**\n * Typed error surfaced when an invocation dispatched over the SDK fails — RBAC\n * rejection (FORBIDDEN), handler-level failure, or a timeout waiting for the\n * engine to respond. Wraps the wire `ErrorBody` shape plus the `function_id`\n * that was targeted, so callers get a single error type across all failure\n * modes and can disambiguate via `err.code`.\n *\n * Before this existed, rejection values were plain `ErrorBody`-shaped objects,\n * which printed as `[object Object]` when stringified — leaving developers to\n * grep through SDK source to figure out what tripped. The class name, `code`\n * prefix in the message, and `function_id` field together make a rejection\n * self-describing.\n */\nexport type InvocationErrorInit = {\n  code: string\n  message: string\n  function_id?: string\n  stacktrace?: string\n}\n\nexport class InvocationError extends Error {\n  public readonly code: string\n  public readonly function_id?: string\n  public readonly stacktrace?: string\n\n  constructor(init: InvocationErrorInit) {\n    super(`${init.code}: ${init.message}`)\n    this.name = 'InvocationError'\n    this.code = init.code\n    this.function_id = init.function_id\n    this.stacktrace = init.stacktrace\n  }\n}\n\n/**\n * True when `value` looks like the wire `ErrorBody` the engine sends in\n * `InvocationResult.error`: `{ code: string, message: string, stacktrace?: string }`.\n * Used to distinguish an engine rejection (which we wrap in\n * {@link InvocationError}) from a JS `Error` thrown elsewhere.\n */\nexport function isErrorBody(value: unknown): value is {\n  code: string\n  message: string\n  stacktrace?: string\n} {\n  if (typeof value !== 'object' || value === null) return false\n  const v = value as { code?: unknown; message?: unknown; stacktrace?: unknown }\n  return (\n    typeof v.code === 'string' &&\n    typeof v.message === 'string' &&\n    (v.stacktrace === undefined || typeof v.stacktrace === 'string')\n  )\n}\n\n/**\n * @deprecated Renamed to {@link InvocationError}; import from `iii-sdk/errors`.\n */\nexport const IIIInvocationError = InvocationError\n/**\n * @deprecated Renamed to {@link InvocationError}.\n */\nexport type IIIInvocationError = InvocationError\n/**\n * @deprecated Renamed to {@link InvocationErrorInit}.\n */\nexport type IIIInvocationErrorInit = InvocationErrorInit\n"],"mappings":";;;AAoBA,IAAa,kBAAb,cAAqC,MAAM;CAKzC,YAAY,MAA2B;AACrC,QAAM,GAAG,KAAK,KAAK,IAAI,KAAK,UAAU;AACtC,OAAK,OAAO;AACZ,OAAK,OAAO,KAAK;AACjB,OAAK,cAAc,KAAK;AACxB,OAAK,aAAa,KAAK;;;;;;;;;AAU3B,SAAgB,YAAY,OAI1B;AACA,KAAI,OAAO,UAAU,YAAY,UAAU,KAAM,QAAO;CACxD,MAAM,IAAI;AACV,QACE,OAAO,EAAE,SAAS,YAClB,OAAO,EAAE,YAAY,aACpB,EAAE,eAAe,UAAa,OAAO,EAAE,eAAe;;;;;AAO3D,MAAa,qBAAqB"}

package/dist/errors.d.cts

@@ -0,0 +1,52 @@
+//#region src/errors.d.ts
+/**
+ * Typed error surfaced when an invocation dispatched over the SDK fails — RBAC
+ * rejection (FORBIDDEN), handler-level failure, or a timeout waiting for the
+ * engine to respond. Wraps the wire `ErrorBody` shape plus the `function_id`
+ * that was targeted, so callers get a single error type across all failure
+ * modes and can disambiguate via `err.code`.
+ *
+ * Before this existed, rejection values were plain `ErrorBody`-shaped objects,
+ * which printed as `[object Object]` when stringified — leaving developers to
+ * grep through SDK source to figure out what tripped. The class name, `code`
+ * prefix in the message, and `function_id` field together make a rejection
+ * self-describing.
+ */
+type InvocationErrorInit = {
+  code: string;
+  message: string;
+  function_id?: string;
+  stacktrace?: string;
+};
+declare class InvocationError extends Error {
+  readonly code: string;
+  readonly function_id?: string;
+  readonly stacktrace?: string;
+  constructor(init: InvocationErrorInit);
+}
+/**
+ * True when `value` looks like the wire `ErrorBody` the engine sends in
+ * `InvocationResult.error`: `{ code: string, message: string, stacktrace?: string }`.
+ * Used to distinguish an engine rejection (which we wrap in
+ * {@link InvocationError}) from a JS `Error` thrown elsewhere.
+ */
+declare function isErrorBody(value: unknown): value is {
+  code: string;
+  message: string;
+  stacktrace?: string;
+};
+/**
+ * @deprecated Renamed to {@link InvocationError}; import from `iii-sdk/errors`.
+ */
+declare const IIIInvocationError: typeof InvocationError;
+/**
+ * @deprecated Renamed to {@link InvocationError}.
+ */
+type IIIInvocationError = InvocationError;
+/**
+ * @deprecated Renamed to {@link InvocationErrorInit}.
+ */
+type IIIInvocationErrorInit = InvocationErrorInit;
+//#endregion
+export { IIIInvocationError, IIIInvocationErrorInit, InvocationError, InvocationErrorInit, isErrorBody };
+//# sourceMappingURL=errors.d.cts.map

package/dist/errors.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.cts","names":[],"sources":["../src/errors.ts"],"mappings":";;AAaA;;;;;;;;;;AAOA;;KAPY,mBAAA;EACV,IAAA;EACA,OAAA;EACA,WAAA;EACA,UAAA;AAAA;AAAA,cAGW,eAAA,SAAwB,KAAA;EAAA,SACnB,IAAA;EAAA,SACA,WAAA;EAAA,SACA,UAAA;cAEJ,IAAA,EAAM,mBAAA;AAAA;;;;;;;iBAeJ,WAAA,CAAY,KAAA,YAAiB,KAAA;EAC3C,IAAA;EACA,OAAA;EACA,UAAA;AAAA;;;;cAcW,kBAAA,SAAkB,eAAA;AAI/B;;;AAAA,KAAY,kBAAA,GAAqB,eAAA;;AAIjC;;KAAY,sBAAA,GAAyB,mBAAA"}

package/dist/errors.d.mts

@@ -0,0 +1,52 @@
+//#region src/errors.d.ts
+/**
+ * Typed error surfaced when an invocation dispatched over the SDK fails — RBAC
+ * rejection (FORBIDDEN), handler-level failure, or a timeout waiting for the
+ * engine to respond. Wraps the wire `ErrorBody` shape plus the `function_id`
+ * that was targeted, so callers get a single error type across all failure
+ * modes and can disambiguate via `err.code`.
+ *
+ * Before this existed, rejection values were plain `ErrorBody`-shaped objects,
+ * which printed as `[object Object]` when stringified — leaving developers to
+ * grep through SDK source to figure out what tripped. The class name, `code`
+ * prefix in the message, and `function_id` field together make a rejection
+ * self-describing.
+ */
+type InvocationErrorInit = {
+  code: string;
+  message: string;
+  function_id?: string;
+  stacktrace?: string;
+};
+declare class InvocationError extends Error {
+  readonly code: string;
+  readonly function_id?: string;
+  readonly stacktrace?: string;
+  constructor(init: InvocationErrorInit);
+}
+/**
+ * True when `value` looks like the wire `ErrorBody` the engine sends in
+ * `InvocationResult.error`: `{ code: string, message: string, stacktrace?: string }`.
+ * Used to distinguish an engine rejection (which we wrap in
+ * {@link InvocationError}) from a JS `Error` thrown elsewhere.
+ */
+declare function isErrorBody(value: unknown): value is {
+  code: string;
+  message: string;
+  stacktrace?: string;
+};
+/**
+ * @deprecated Renamed to {@link InvocationError}; import from `iii-sdk/errors`.
+ */
+declare const IIIInvocationError: typeof InvocationError;
+/**
+ * @deprecated Renamed to {@link InvocationError}.
+ */
+type IIIInvocationError = InvocationError;
+/**
+ * @deprecated Renamed to {@link InvocationErrorInit}.
+ */
+type IIIInvocationErrorInit = InvocationErrorInit;
+//#endregion
+export { IIIInvocationError, IIIInvocationErrorInit, InvocationError, InvocationErrorInit, isErrorBody };
+//# sourceMappingURL=errors.d.mts.map

package/dist/errors.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.mts","names":[],"sources":["../src/errors.ts"],"mappings":";;AAaA;;;;;;;;;;AAOA;;KAPY,mBAAA;EACV,IAAA;EACA,OAAA;EACA,WAAA;EACA,UAAA;AAAA;AAAA,cAGW,eAAA,SAAwB,KAAA;EAAA,SACnB,IAAA;EAAA,SACA,WAAA;EAAA,SACA,UAAA;cAEJ,IAAA,EAAM,mBAAA;AAAA;;;;;;;iBAeJ,WAAA,CAAY,KAAA,YAAiB,KAAA;EAC3C,IAAA;EACA,OAAA;EACA,UAAA;AAAA;;;;cAcW,kBAAA,SAAkB,eAAA;AAI/B;;;AAAA,KAAY,kBAAA,GAAqB,eAAA;;AAIjC;;KAAY,sBAAA,GAAyB,mBAAA"}

package/dist/errors.mjs

@@ -0,0 +1,29 @@
+//#region src/errors.ts
+var InvocationError = class extends Error {
+	constructor(init) {
+		super(`${init.code}: ${init.message}`);
+		this.name = "InvocationError";
+		this.code = init.code;
+		this.function_id = init.function_id;
+		this.stacktrace = init.stacktrace;
+	}
+};
+/**
+* True when `value` looks like the wire `ErrorBody` the engine sends in
+* `InvocationResult.error`: `{ code: string, message: string, stacktrace?: string }`.
+* Used to distinguish an engine rejection (which we wrap in
+* {@link InvocationError}) from a JS `Error` thrown elsewhere.
+*/
+function isErrorBody(value) {
+	if (typeof value !== "object" || value === null) return false;
+	const v = value;
+	return typeof v.code === "string" && typeof v.message === "string" && (v.stacktrace === void 0 || typeof v.stacktrace === "string");
+}
+/**
+* @deprecated Renamed to {@link InvocationError}; import from `iii-sdk/errors`.
+*/
+const IIIInvocationError = InvocationError;
+
+//#endregion
+export { IIIInvocationError, InvocationError, isErrorBody };
+//# sourceMappingURL=errors.mjs.map

package/dist/errors.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.mjs","names":[],"sources":["../src/errors.ts"],"sourcesContent":["/**\n * Typed error surfaced when an invocation dispatched over the SDK fails — RBAC\n * rejection (FORBIDDEN), handler-level failure, or a timeout waiting for the\n * engine to respond. Wraps the wire `ErrorBody` shape plus the `function_id`\n * that was targeted, so callers get a single error type across all failure\n * modes and can disambiguate via `err.code`.\n *\n * Before this existed, rejection values were plain `ErrorBody`-shaped objects,\n * which printed as `[object Object]` when stringified — leaving developers to\n * grep through SDK source to figure out what tripped. The class name, `code`\n * prefix in the message, and `function_id` field together make a rejection\n * self-describing.\n */\nexport type InvocationErrorInit = {\n  code: string\n  message: string\n  function_id?: string\n  stacktrace?: string\n}\n\nexport class InvocationError extends Error {\n  public readonly code: string\n  public readonly function_id?: string\n  public readonly stacktrace?: string\n\n  constructor(init: InvocationErrorInit) {\n    super(`${init.code}: ${init.message}`)\n    this.name = 'InvocationError'\n    this.code = init.code\n    this.function_id = init.function_id\n    this.stacktrace = init.stacktrace\n  }\n}\n\n/**\n * True when `value` looks like the wire `ErrorBody` the engine sends in\n * `InvocationResult.error`: `{ code: string, message: string, stacktrace?: string }`.\n * Used to distinguish an engine rejection (which we wrap in\n * {@link InvocationError}) from a JS `Error` thrown elsewhere.\n */\nexport function isErrorBody(value: unknown): value is {\n  code: string\n  message: string\n  stacktrace?: string\n} {\n  if (typeof value !== 'object' || value === null) return false\n  const v = value as { code?: unknown; message?: unknown; stacktrace?: unknown }\n  return (\n    typeof v.code === 'string' &&\n    typeof v.message === 'string' &&\n    (v.stacktrace === undefined || typeof v.stacktrace === 'string')\n  )\n}\n\n/**\n * @deprecated Renamed to {@link InvocationError}; import from `iii-sdk/errors`.\n */\nexport const IIIInvocationError = InvocationError\n/**\n * @deprecated Renamed to {@link InvocationError}.\n */\nexport type IIIInvocationError = InvocationError\n/**\n * @deprecated Renamed to {@link InvocationErrorInit}.\n */\nexport type IIIInvocationErrorInit = InvocationErrorInit\n"],"mappings":";AAoBA,IAAa,kBAAb,cAAqC,MAAM;CAKzC,YAAY,MAA2B;AACrC,QAAM,GAAG,KAAK,KAAK,IAAI,KAAK,UAAU;AACtC,OAAK,OAAO;AACZ,OAAK,OAAO,KAAK;AACjB,OAAK,cAAc,KAAK;AACxB,OAAK,aAAa,KAAK;;;;;;;;;AAU3B,SAAgB,YAAY,OAI1B;AACA,KAAI,OAAO,UAAU,YAAY,UAAU,KAAM,QAAO;CACxD,MAAM,IAAI;AACV,QACE,OAAO,EAAE,SAAS,YAClB,OAAO,EAAE,YAAY,aACpB,EAAE,eAAe,UAAa,OAAO,EAAE,eAAe;;;;;AAO3D,MAAa,qBAAqB"}

package/dist/helpers.cjs

@@ -1,5 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_utils = require('./utils-CuS1Knym.cjs');
+const require_utils = require('./utils-BtEFReHq.cjs');
+const require_channels = require('./channels-huduKJ-b.cjs');
 
 //#region src/helpers.ts
 /**
@@ -21,8 +22,8 @@ function createStream(iii, streamName, stream) {
 }
 
 //#endregion
-exports.ChannelDirection = require_utils.ChannelDirection;
-exports.ChannelItem = require_utils.ChannelItem;
+exports.ChannelDirection = require_channels.ChannelDirection;
+exports.ChannelItem = require_channels.ChannelItem;
 exports.createChannel = createChannel;
 exports.createStream = createStream;
 exports.extractChannelRefs = require_utils.extractChannelRefs;

package/dist/helpers.cjs.map

@@ -1 +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"}
+{"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

@@ -1,6 +1,24 @@
-import { S as ChannelItem, o as Channel, r as isChannelRef, t as extractChannelRefs, u as ISdk, x as ChannelDirection } from "./utils-BnRzIUCy.cjs";
+import { O as StreamChannelRef, _ as ChannelDirection, i as ISdk, t as Channel, v as ChannelItem } from "./types-gwm9j9oD.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.