iii-sdk 0.24.0 → 0.25.0-rc.1

package/dist/channel.cjs

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

package/dist/channel.mjs

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

package/dist/{channels-C4f7nfQr.mjs → channels-Di68FfqY.mjs}

@@ -13,12 +13,14 @@ const ChannelDirection = {
 	Write: "write"
 };
 const ChannelItem = {
+	/** Construct a text channel item. */
 	Text(value) {
 		return {
 			type: "text",
 			value
 		};
 	},
+	/** Construct a binary channel item. */
 	Binary(value) {
 		return {
 			type: "binary",
@@ -222,4 +224,4 @@ function buildChannelUrl(engineWsBase, channelId, accessKey, direction) {
 
 //#endregion
 export { ChannelWriter as i, ChannelItem as n, ChannelReader as r, ChannelDirection as t };
-//# sourceMappingURL=channels-C4f7nfQr.mjs.map
+//# sourceMappingURL=channels-Di68FfqY.mjs.map

package/dist/{channels-C4f7nfQr.mjs.map → channels-Di68FfqY.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"channels-C4f7nfQr.mjs","names":[],"sources":["../src/channels.ts"],"sourcesContent":["import { Readable, Writable } from 'node:stream'\nimport { WebSocket } from 'ws'\nimport { WS_HANDSHAKE_TIMEOUT_MS } from './iii-constants'\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    // A non-null socket is only reusable while it is still connecting or open.\n    // A CLOSING/CLOSED socket is dead and must be replaced — guarding solely on\n    // `this.ws` being non-null would pin a terminated socket forever, so every\n    // subsequent send would target a connection that can never deliver it.\n    if (\n      this.ws &&\n      this.ws.readyState !== WebSocket.CLOSING &&\n      this.ws.readyState !== WebSocket.CLOSED\n    ) {\n      return\n    }\n    this.wsReady = false\n    this.ws = new WebSocket(this.url, { handshakeTimeout: WS_HANDSHAKE_TIMEOUT_MS })\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.wsReady = false\n      this.stream.destroy(err)\n    })\n\n    this.ws.on('close', () => {\n      this.wsReady = false\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    // Trust the socket's live readyState over the tracked `wsReady` flag, which\n    // can stay true after a drop. Queue anything we cannot send right now — and\n    // requeue a send() that throws because the socket died underneath us — so it\n    // flushes on the next open instead of being lost or throwing to the caller.\n    if (this.ws && this.ws.readyState === WebSocket.OPEN) {\n      try {\n        this.ws.send(data, (err) => callback(err ?? null))\n      } catch {\n        this.pendingMessages.push({ data, callback })\n      }\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, { handshakeTimeout: WS_HANDSHAKE_TIMEOUT_MS })\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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"}
+{"version":3,"file":"channels-Di68FfqY.mjs","names":[],"sources":["../src/channels.ts"],"sourcesContent":["import { Readable, Writable } from 'node:stream'\nimport { WebSocket } from 'ws'\nimport { WS_HANDSHAKE_TIMEOUT_MS } from './iii-constants'\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    // A non-null socket is only reusable while it is still connecting or open.\n    // A CLOSING/CLOSED socket is dead and must be replaced — guarding solely on\n    // `this.ws` being non-null would pin a terminated socket forever, so every\n    // subsequent send would target a connection that can never deliver it.\n    if (\n      this.ws &&\n      this.ws.readyState !== WebSocket.CLOSING &&\n      this.ws.readyState !== WebSocket.CLOSED\n    ) {\n      return\n    }\n    this.wsReady = false\n    this.ws = new WebSocket(this.url, { handshakeTimeout: WS_HANDSHAKE_TIMEOUT_MS })\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.wsReady = false\n      this.stream.destroy(err)\n    })\n\n    this.ws.on('close', () => {\n      this.wsReady = false\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    // Trust the socket's live readyState over the tracked `wsReady` flag, which\n    // can stay true after a drop. Queue anything we cannot send right now — and\n    // requeue a send() that throws because the socket died underneath us — so it\n    // flushes on the next open instead of being lost or throwing to the caller.\n    if (this.ws && this.ws.readyState === WebSocket.OPEN) {\n      try {\n        this.ws.send(data, (err) => callback(err ?? null))\n      } catch {\n        this.pendingMessages.push({ data, callback })\n      }\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, { handshakeTimeout: WS_HANDSHAKE_TIMEOUT_MS })\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/{channels-C2ezAJ_g.cjs → channels-Dn3OKXH5.cjs}

@@ -1,4 +1,4 @@
-const require_utils = require('./utils-63wxBJg-.cjs');
+const require_utils = require('./utils-SpwzEB77.cjs');
 const require_iii_constants = require('./iii-constants-M_BGfxGD.cjs');
 let ws = require("ws");
 let node_stream = require("node:stream");
@@ -14,12 +14,14 @@ const ChannelDirection = {
 	Write: "write"
 };
 const ChannelItem = {
+	/** Construct a text channel item. */
 	Text(value) {
 		return {
 			type: "text",
 			value
 		};
 	},
+	/** Construct a binary channel item. */
 	Binary(value) {
 		return {
 			type: "binary",
@@ -246,4 +248,4 @@ Object.defineProperty(exports, 'ChannelWriter', {
     return ChannelWriter;
   }
 });
-//# sourceMappingURL=channels-C2ezAJ_g.cjs.map
+//# sourceMappingURL=channels-Dn3OKXH5.cjs.map

package/dist/{channels-C2ezAJ_g.cjs.map → channels-Dn3OKXH5.cjs.map}

@@ -1 +1 @@
-{"version":3,"file":"channels-C2ezAJ_g.cjs","names":["Writable","WebSocket","WS_HANDSHAKE_TIMEOUT_MS","Readable"],"sources":["../src/channels.ts"],"sourcesContent":["import { Readable, Writable } from 'node:stream'\nimport { WebSocket } from 'ws'\nimport { WS_HANDSHAKE_TIMEOUT_MS } from './iii-constants'\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    // A non-null socket is only reusable while it is still connecting or open.\n    // A CLOSING/CLOSED socket is dead and must be replaced — guarding solely on\n    // `this.ws` being non-null would pin a terminated socket forever, so every\n    // subsequent send would target a connection that can never deliver it.\n    if (\n      this.ws &&\n      this.ws.readyState !== WebSocket.CLOSING &&\n      this.ws.readyState !== WebSocket.CLOSED\n    ) {\n      return\n    }\n    this.wsReady = false\n    this.ws = new WebSocket(this.url, { handshakeTimeout: WS_HANDSHAKE_TIMEOUT_MS })\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.wsReady = false\n      this.stream.destroy(err)\n    })\n\n    this.ws.on('close', () => {\n      this.wsReady = false\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    // Trust the socket's live readyState over the tracked `wsReady` flag, which\n    // can stay true after a drop. Queue anything we cannot send right now — and\n    // requeue a send() that throws because the socket died underneath us — so it\n    // flushes on the next open instead of being lost or throwing to the caller.\n    if (this.ws && this.ws.readyState === WebSocket.OPEN) {\n      try {\n        this.ws.send(data, (err) => callback(err ?? null))\n      } catch {\n        this.pendingMessages.push({ data, callback })\n      }\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, { handshakeTimeout: WS_HANDSHAKE_TIMEOUT_MS })\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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"}
+{"version":3,"file":"channels-Dn3OKXH5.cjs","names":["Writable","WebSocket","WS_HANDSHAKE_TIMEOUT_MS","Readable"],"sources":["../src/channels.ts"],"sourcesContent":["import { Readable, Writable } from 'node:stream'\nimport { WebSocket } from 'ws'\nimport { WS_HANDSHAKE_TIMEOUT_MS } from './iii-constants'\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    // A non-null socket is only reusable while it is still connecting or open.\n    // A CLOSING/CLOSED socket is dead and must be replaced — guarding solely on\n    // `this.ws` being non-null would pin a terminated socket forever, so every\n    // subsequent send would target a connection that can never deliver it.\n    if (\n      this.ws &&\n      this.ws.readyState !== WebSocket.CLOSING &&\n      this.ws.readyState !== WebSocket.CLOSED\n    ) {\n      return\n    }\n    this.wsReady = false\n    this.ws = new WebSocket(this.url, { handshakeTimeout: WS_HANDSHAKE_TIMEOUT_MS })\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.wsReady = false\n      this.stream.destroy(err)\n    })\n\n    this.ws.on('close', () => {\n      this.wsReady = false\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    // Trust the socket's live readyState over the tracked `wsReady` flag, which\n    // can stay true after a drop. Queue anything we cannot send right now — and\n    // requeue a send() that throws because the socket died underneath us — so it\n    // flushes on the next open instead of being lost or throwing to the caller.\n    if (this.ws && this.ws.readyState === WebSocket.OPEN) {\n      try {\n        this.ws.send(data, (err) => callback(err ?? null))\n      } catch {\n        this.pendingMessages.push({ data, callback })\n      }\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, { handshakeTimeout: WS_HANDSHAKE_TIMEOUT_MS })\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/helpers.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_utils = require('./utils-63wxBJg-.cjs');
-const require_channels = require('./channels-C2ezAJ_g.cjs');
+const require_utils = require('./utils-SpwzEB77.cjs');
+const require_channels = require('./channels-Dn3OKXH5.cjs');
 
 //#region src/helpers.ts
 /**

package/dist/helpers.mjs

@@ -1,4 +1,4 @@
-import { n as ChannelItem, t as ChannelDirection } from "./channels-C4f7nfQr.mjs";
+import { n as ChannelItem, t as ChannelDirection } from "./channels-Di68FfqY.mjs";
 import { n as extractChannelRefs, r as isChannelRef } from "./utils-8G4hHqvZ.mjs";
 
 //#region src/helpers.ts

package/dist/index.cjs

@@ -1,13 +1,13 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_utils = require('./utils-63wxBJg-.cjs');
+const require_utils = require('./utils-SpwzEB77.cjs');
 const require_errors = require('./errors.cjs');
 const require_iii_constants = require('./iii-constants-M_BGfxGD.cjs');
-const require_channels = require('./channels-C2ezAJ_g.cjs');
+const require_channels = require('./channels-Dn3OKXH5.cjs');
 const require_iii_types = require('./iii-types-BHasLgj1.cjs');
 let _opentelemetry_api = require("@opentelemetry/api");
 let node_module = require("node:module");
 let node_os = require("node:os");
-node_os = require_utils.__toESM(node_os);
+node_os = require_utils.__toESM(node_os, 1);
 let ws = require("ws");
 let _iii_dev_helpers_observability = require("@iii-dev/helpers/observability");
 let _iii_dev_helpers_observability_internal = require("@iii-dev/helpers/observability/internal");
@@ -84,11 +84,11 @@ var Sdk = class {
 		this.connectionState = "disconnected";
 		this.isShuttingDown = false;
 		this.registerTriggerType = (triggerType, handler) => {
-			this.sendMessage(require_iii_types.MessageType.RegisterTriggerType, triggerType, true);
+			this.sendMessage("registertriggertype", triggerType, true);
 			this.triggerTypes.set(triggerType.id, {
 				message: {
 					...triggerType,
-					message_type: require_iii_types.MessageType.RegisterTriggerType
+					message_type: "registertriggertype"
 				},
 				handler
 			});
@@ -120,7 +120,7 @@ var Sdk = class {
 			};
 		};
 		this.unregisterTriggerType = (triggerType) => {
-			this.sendMessage(require_iii_types.MessageType.UnregisterTriggerType, triggerType, true);
+			this.sendMessage("unregistertriggertype", triggerType, true);
 			this.triggerTypes.delete(triggerType.id);
 		};
 		this.registerTrigger = (trigger) => {
@@ -128,18 +128,18 @@ var Sdk = class {
 			const fullTrigger = {
 				...trigger,
 				id,
-				message_type: require_iii_types.MessageType.RegisterTrigger,
+				message_type: "registertrigger",
 				...(() => {
 					const namespace = callNamespace(trigger.namespace, this.namespace, "RegisterTriggerInput.namespace");
 					return namespace !== void 0 ? { namespace } : {};
 				})()
 			};
-			this.sendMessage(require_iii_types.MessageType.RegisterTrigger, fullTrigger, true);
+			this.sendMessage("registertrigger", fullTrigger, true);
 			this.triggers.set(id, fullTrigger);
 			return { unregister: () => {
-				this.sendMessage(require_iii_types.MessageType.UnregisterTrigger, {
+				this.sendMessage("unregistertrigger", {
 					id,
-					message_type: require_iii_types.MessageType.UnregisterTrigger,
+					message_type: "unregistertrigger",
 					type: fullTrigger.type
 				});
 				this.triggers.delete(id);
@@ -152,11 +152,11 @@ var Sdk = class {
 			const fullMessage = isHandler ? {
 				...options,
 				id: functionId,
-				message_type: require_iii_types.MessageType.RegisterFunction
+				message_type: "registerfunction"
 			} : {
 				...options,
 				id: functionId,
-				message_type: require_iii_types.MessageType.RegisterFunction,
+				message_type: "registerfunction",
 				invocation: {
 					url: handlerOrInvocation.url,
 					method: handlerOrInvocation.method ?? "POST",
@@ -165,7 +165,7 @@ var Sdk = class {
 					auth: handlerOrInvocation.auth
 				}
 			};
-			this.sendMessage(require_iii_types.MessageType.RegisterFunction, fullMessage, true);
+			this.sendMessage("registerfunction", fullMessage, true);
 			if (isHandler) {
 				const handler = handlerOrInvocation;
 				this.functions.set(functionId, {
@@ -222,7 +222,7 @@ var Sdk = class {
 			return {
 				id: functionId,
 				unregister: () => {
-					this.sendMessage(require_iii_types.MessageType.UnregisterFunction, { id: functionId }, true);
+					this.sendMessage("unregisterfunction", { id: functionId }, true);
 					this.functions.delete(functionId);
 				}
 			};
@@ -246,7 +246,7 @@ var Sdk = class {
 			if (action?.type === "void") {
 				const traceparent = (0, _iii_dev_helpers_observability.injectTraceparent)();
 				const baggage = (0, _iii_dev_helpers_observability.injectBaggage)();
-				this.sendMessage(require_iii_types.MessageType.InvokeFunction, {
+				this.sendMessage("invokefunction", {
 					function_id,
 					data: payload,
 					traceparent,
@@ -283,7 +283,7 @@ var Sdk = class {
 					function_id,
 					timeout
 				});
-				this.sendMessage(require_iii_types.MessageType.InvokeFunction, {
+				this.sendMessage("invokefunction", {
 					invocation_id,
 					function_id,
 					data: payload,
@@ -466,24 +466,24 @@ var Sdk = class {
 		this.ws?.on("pong", touch);
 		this.startHeartbeat();
 		if (this.workerId) this.sendMessageRaw(JSON.stringify({
-			type: require_iii_types.MessageType.Reattach,
+			type: "reattach",
 			previous_worker_id: this.workerId,
 			reattach_token: this.reattachToken
 		}));
 		this.registerWorkerMetadata();
 		this.triggerTypes.forEach(({ message }) => {
-			this.sendMessage(require_iii_types.MessageType.RegisterTriggerType, message, true);
+			this.sendMessage("registertriggertype", message, true);
 		});
 		this.functions.forEach(({ message }) => {
-			this.sendMessage(require_iii_types.MessageType.RegisterFunction, message, true);
+			this.sendMessage("registerfunction", message, true);
 		});
 		this.triggers.forEach((trigger) => {
-			this.sendMessage(require_iii_types.MessageType.RegisterTrigger, trigger, true);
+			this.sendMessage("registertrigger", trigger, true);
 		});
 		const pending = this.messagesToSend;
 		this.messagesToSend = [];
 		for (const message of pending) {
-			if (message.type === require_iii_types.MessageType.InvokeFunction && typeof message.invocation_id === "string" && !this.invocations.has(message.invocation_id)) continue;
+			if (message.type === "invokefunction" && typeof message.invocation_id === "string" && !this.invocations.has(message.invocation_id)) continue;
 			this.sendMessageRaw(JSON.stringify(message));
 		}
 	}
@@ -501,7 +501,7 @@ var Sdk = class {
 	}
 	toWireFormat(messageType, message) {
 		const { message_type: _, ...rest } = message;
-		if (messageType === require_iii_types.MessageType.RegisterTrigger && "type" in message) {
+		if (messageType === "registertrigger" && "type" in message) {
 			const { type: triggerType, ...triggerRest } = message;
 			return {
 				type: messageType,
@@ -509,7 +509,7 @@ var Sdk = class {
 				trigger_type: triggerType
 			};
 		}
-		if (messageType === require_iii_types.MessageType.UnregisterTrigger && "type" in message) {
+		if (messageType === "unregistertrigger" && "type" in message) {
 			const { type: triggerType, ...triggerRest } = message;
 			return {
 				type: messageType,
@@ -517,7 +517,7 @@ var Sdk = class {
 				trigger_type: triggerType
 			};
 		}
-		if (messageType === require_iii_types.MessageType.TriggerRegistrationResult && "type" in message) {
+		if (messageType === "triggerregistrationresult" && "type" in message) {
 			const { type: triggerType, ...resultRest } = message;
 			return {
 				type: messageType,
@@ -650,7 +650,7 @@ var Sdk = class {
 			}
 			try {
 				const result = await fn.handler(resolvedInput, metadata, traceparent, baggage);
-				this.sendMessage(require_iii_types.MessageType.InvocationResult, {
+				this.sendMessage("invocationresult", {
 					invocation_id,
 					function_id,
 					result,
@@ -659,7 +659,7 @@ var Sdk = class {
 				});
 			} catch (error) {
 				const isError = error instanceof Error;
-				this.sendMessage(require_iii_types.MessageType.InvocationResult, {
+				this.sendMessage("invocationresult", {
 					invocation_id,
 					function_id,
 					error: {
@@ -674,7 +674,7 @@ var Sdk = class {
 		} else {
 			const errorCode = fn ? "function_not_invokable" : "function_not_found";
 			const errorMessage = fn ? "Function is HTTP-invoked and cannot be invoked locally" : "Function not found";
-			if (invocation_id) this.sendMessage(require_iii_types.MessageType.InvocationResult, {
+			if (invocation_id) this.sendMessage("invocationresult", {
 				invocation_id,
 				function_id,
 				error: {
@@ -697,16 +697,16 @@ var Sdk = class {
 				metadata,
 				namespace
 			});
-			this.sendMessage(require_iii_types.MessageType.TriggerRegistrationResult, {
+			this.sendMessage("triggerregistrationresult", {
 				id,
-				message_type: require_iii_types.MessageType.TriggerRegistrationResult,
+				message_type: "triggerregistrationresult",
 				type: trigger_type,
 				function_id
 			});
 		} catch (error) {
-			this.sendMessage(require_iii_types.MessageType.TriggerRegistrationResult, {
+			this.sendMessage("triggerregistrationresult", {
 				id,
-				message_type: require_iii_types.MessageType.TriggerRegistrationResult,
+				message_type: "triggerregistrationresult",
 				type: trigger_type,
 				function_id,
 				error: {
@@ -715,9 +715,9 @@ var Sdk = class {
 				}
 			});
 		}
-		else this.sendMessage(require_iii_types.MessageType.TriggerRegistrationResult, {
+		else this.sendMessage("triggerregistrationresult", {
 			id,
-			message_type: require_iii_types.MessageType.TriggerRegistrationResult,
+			message_type: "triggerregistrationresult",
 			type: trigger_type,
 			function_id,
 			error: {
@@ -760,22 +760,22 @@ var Sdk = class {
 			this.logError("Failed to parse incoming message", error);
 			return;
 		}
-		if (msgType === require_iii_types.MessageType.InvocationResult) {
+		if (msgType === "invocationresult") {
 			const { invocation_id, result, error } = message;
 			this.onInvocationResult(invocation_id, result, error);
-		} else if (msgType === require_iii_types.MessageType.InvokeFunction) {
+		} else if (msgType === "invokefunction") {
 			const { invocation_id, function_id, data, metadata, traceparent, baggage } = message;
 			this.onInvokeFunction(invocation_id, function_id, data, metadata, traceparent, baggage);
-		} else if (msgType === require_iii_types.MessageType.RegisterTrigger) this.onRegisterTrigger(message);
-		else if (msgType === require_iii_types.MessageType.UnregisterTrigger) this.onUnregisterTrigger(message);
-		else if (msgType === require_iii_types.MessageType.TriggerRegistrationResult) this.onTriggerRegistrationResult(message);
-		else if (msgType === require_iii_types.MessageType.WorkerRegistered) {
+		} else if (msgType === "registertrigger") this.onRegisterTrigger(message);
+		else if (msgType === "unregistertrigger") this.onUnregisterTrigger(message);
+		else if (msgType === "triggerregistrationresult") this.onTriggerRegistrationResult(message);
+		else if (msgType === "workerregistered") {
 			const { worker_id, reattach_token } = message;
 			this.workerId = worker_id;
 			this.reattachToken = reattach_token;
 			console.debug("[iii] Worker registered with ID:", worker_id);
 			this.startMetricsReporting();
-		} else if (msgType === require_iii_types.MessageType.RegistrationRejected) {
+		} else if (msgType === "registrationrejected") {
 			const { code, namespace, worker_name, function_id, owner_worker_id } = message;
 			this.onRegistrationRejected({
 				code,
@@ -810,10 +810,25 @@ var Sdk = class {
 * ```
 */
 const TriggerAction = {
+	/**
+	* Routes the invocation through a named queue. The engine enqueues the job,
+	* acknowledges the caller with `{ messageReceiptId }`, and processes it
+	* asynchronously.
+	*
+	* Requires the `queue` worker in `worker-compose.yaml`.
+	* Without it the trigger rejects with `enqueue_error` (no queue provider).
+	*
+	* @param opts - Queue routing options.
+	* @param opts.queue - Name of the target queue.
+	*/
 	Enqueue: (opts) => ({
 		type: "enqueue",
 		...opts
 	}),
+	/**
+	* Fire-and-forget routing. The engine forwards the invocation without
+	* waiting for a response or queuing the job.
+	*/
 	Void: () => ({ type: "void" })
 };
 /**