iii-sdk 0.20.0 → 0.21.1-next.1

package/dist/channel.cjs

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

package/dist/channel.d.cts

@@ -1,2 +1,2 @@
-import { D as StreamChannelRef, t as Channel, v as ChannelReader, y as ChannelWriter } from "./types-pzKubHk_.cjs";
+import { O as StreamChannelRef, t as Channel, v as ChannelReader, y as ChannelWriter } from "./types-BWAWo4sU.cjs";
 export { type Channel, ChannelReader, ChannelWriter, type StreamChannelRef };

package/dist/channel.d.mts

@@ -1,2 +1,2 @@
-import { D as StreamChannelRef, t as Channel, v as ChannelReader, y as ChannelWriter } from "./types-ChnmRit-.mjs";
+import { O as StreamChannelRef, t as Channel, v as ChannelReader, y as ChannelWriter } from "./types-CsnoPSrN.mjs";
 export { type Channel, ChannelReader, ChannelWriter, type StreamChannelRef };

package/dist/channel.mjs

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

package/dist/{channels-De8fNMyx.mjs → channels-D3WzAo7Z.mjs}

@@ -76,7 +76,8 @@ var ChannelWriter = class ChannelWriter {
 		});
 	}
 	ensureConnected() {
-		if (this.ws) return;
+		if (this.ws && this.ws.readyState !== WebSocket.CLOSING && this.ws.readyState !== WebSocket.CLOSED) return;
+		this.wsReady = false;
 		this.ws = new WebSocket(this.url);
 		this.ws.on("open", () => {
 			this.wsReady = true;
@@ -84,9 +85,11 @@ var ChannelWriter = class ChannelWriter {
 			this.pendingMessages.length = 0;
 		});
 		this.ws.on("error", (err) => {
+			this.wsReady = false;
 			this.stream.destroy(err);
 		});
 		this.ws.on("close", () => {
+			this.wsReady = false;
 			if (!this.stream.destroyed) this.stream.destroy();
 		});
 	}
@@ -126,7 +129,14 @@ var ChannelWriter = class ChannelWriter {
 	}
 	sendRaw(data, callback) {
 		this.ensureConnected();
-		if (this.wsReady && this.ws) this.ws.send(data, (err) => callback(err ?? null));
+		if (this.ws && this.ws.readyState === WebSocket.OPEN) try {
+			this.ws.send(data, (err) => callback(err ?? null));
+		} catch {
+			this.pendingMessages.push({
+				data,
+				callback
+			});
+		}
 		else this.pendingMessages.push({
 			data,
 			callback
@@ -211,4 +221,4 @@ function buildChannelUrl(engineWsBase, channelId, accessKey, direction) {
 
 //#endregion
 export { ChannelWriter as i, ChannelItem as n, ChannelReader as r, ChannelDirection as t };
-//# sourceMappingURL=channels-De8fNMyx.mjs.map
+//# sourceMappingURL=channels-D3WzAo7Z.mjs.map

package/dist/channels-D3WzAo7Z.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"channels-D3WzAo7Z.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    // 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)\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)\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-ZbQzcwnN.cjs → channels-DfBRsGN1.cjs}

@@ -77,7 +77,8 @@ var ChannelWriter = class ChannelWriter {
 		});
 	}
 	ensureConnected() {
-		if (this.ws) return;
+		if (this.ws && this.ws.readyState !== ws.WebSocket.CLOSING && this.ws.readyState !== ws.WebSocket.CLOSED) return;
+		this.wsReady = false;
 		this.ws = new ws.WebSocket(this.url);
 		this.ws.on("open", () => {
 			this.wsReady = true;
@@ -85,9 +86,11 @@ var ChannelWriter = class ChannelWriter {
 			this.pendingMessages.length = 0;
 		});
 		this.ws.on("error", (err) => {
+			this.wsReady = false;
 			this.stream.destroy(err);
 		});
 		this.ws.on("close", () => {
+			this.wsReady = false;
 			if (!this.stream.destroyed) this.stream.destroy();
 		});
 	}
@@ -127,7 +130,14 @@ var ChannelWriter = class ChannelWriter {
 	}
 	sendRaw(data, callback) {
 		this.ensureConnected();
-		if (this.wsReady && this.ws) this.ws.send(data, (err) => callback(err ?? null));
+		if (this.ws && this.ws.readyState === ws.WebSocket.OPEN) try {
+			this.ws.send(data, (err) => callback(err ?? null));
+		} catch {
+			this.pendingMessages.push({
+				data,
+				callback
+			});
+		}
 		else this.pendingMessages.push({
 			data,
 			callback
@@ -235,4 +245,4 @@ Object.defineProperty(exports, 'ChannelWriter', {
     return ChannelWriter;
   }
 });
-//# sourceMappingURL=channels-ZbQzcwnN.cjs.map
+//# sourceMappingURL=channels-DfBRsGN1.cjs.map

package/dist/channels-DfBRsGN1.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"channels-DfBRsGN1.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    // 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)\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)\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.d.cts

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

package/dist/engine.d.mts

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

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-ZbQzcwnN.cjs');
+const require_channels = require('./channels-DfBRsGN1.cjs');
 
 //#region src/helpers.ts
 /**

package/dist/helpers.d.cts

@@ -1,4 +1,4 @@
-import { D as StreamChannelRef, _ as ChannelItem, g as ChannelDirection, r as IIIClient, t as Channel } from "./types-pzKubHk_.cjs";
+import { O as StreamChannelRef, _ as ChannelItem, g as ChannelDirection, r as IIIClient, t as Channel } from "./types-BWAWo4sU.cjs";
 import { IStream } from "./stream.cjs";
 
 //#region src/utils.d.ts

package/dist/helpers.d.mts

@@ -1,4 +1,4 @@
-import { D as StreamChannelRef, _ as ChannelItem, g as ChannelDirection, r as IIIClient, t as Channel } from "./types-ChnmRit-.mjs";
+import { O as StreamChannelRef, _ as ChannelItem, g as ChannelDirection, r as IIIClient, t as Channel } from "./types-CsnoPSrN.mjs";
 import { IStream } from "./stream.mjs";
 
 //#region src/utils.d.ts

package/dist/helpers.mjs

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

package/dist/iii-types-6aHBgy7l.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"iii-types-6aHBgy7l.cjs","names":[],"sources":["../src/iii-types.ts"],"sourcesContent":["import type { HttpInvocationConfig } from '@iii-dev/helpers/http'\n\nexport enum MessageType {\n  RegisterFunction = 'registerfunction',\n  UnregisterFunction = 'unregisterfunction',\n  InvokeFunction = 'invokefunction',\n  InvocationResult = 'invocationresult',\n  RegisterTriggerType = 'registertriggertype',\n  RegisterTrigger = 'registertrigger',\n  UnregisterTrigger = 'unregistertrigger',\n  UnregisterTriggerType = 'unregistertriggertype',\n  TriggerRegistrationResult = 'triggerregistrationresult',\n  WorkerRegistered = 'workerregistered',\n}\n\nexport type RegisterTriggerTypeMessage = {\n  message_type: MessageType.RegisterTriggerType\n  id: string\n  description: string\n}\n\nexport type UnregisterTriggerTypeMessage = {\n  message_type: MessageType.UnregisterTriggerType\n  id: string\n}\n\nexport type UnregisterTriggerMessage = {\n  message_type: MessageType.UnregisterTrigger\n  id: string\n  type?: string\n}\n\nexport type ErrorBody = {\n  code: string\n  message: string\n  stacktrace?: string\n}\n\nexport type TriggerRegistrationResultMessage = {\n  message_type: MessageType.TriggerRegistrationResult\n  id: string\n  type: string\n  function_id: string\n  error?: ErrorBody\n}\n\nexport type RegisterTriggerMessage = {\n  message_type: MessageType.RegisterTrigger\n  id: string\n  type: string\n  function_id: string\n  config: unknown\n  metadata?: Record<string, unknown>\n}\n\nexport type RegisterFunctionFormat = {\n  /**\n   * The name of the parameter\n   */\n  name?: string\n  /**\n   * The description of the parameter\n   */\n  description?: string\n  /**\n   * The type of the parameter\n   */\n  type?: 'string' | 'number' | 'boolean' | 'object' | 'array' | 'null' | 'map' | 'integer'\n  /**\n   * The body of the parameter (for objects)\n   */\n  properties?: Record<string, unknown>\n  /**\n   * The items of the parameter (for arrays)\n   */\n  items?: unknown\n  /**\n   * Whether the parameter is required\n   */\n  required?: string[]\n  [key: string]: unknown\n}\n\nexport type RegisterFunctionMessage = {\n  message_type: MessageType.RegisterFunction\n  /**\n   * The path of the function (use :: for namespacing, e.g. external::my_lambda)\n   */\n  id: string\n  /**\n   * The description of the function\n   */\n  description?: string\n  /**\n   * The request format of the function\n   */\n  request_format?: RegisterFunctionFormat\n  /**\n   * The response format of the function\n   */\n  response_format?: RegisterFunctionFormat\n  metadata?: Record<string, unknown>\n  /**\n   * HTTP invocation config for external HTTP functions (Lambda, Cloudflare Workers, etc.)\n   */\n  invocation?: HttpInvocationConfig\n}\n\n/**\n * Routing action for {@link TriggerRequest}. Determines how the engine\n * handles the invocation.\n *\n * - `enqueue` -- Routes through a named queue for async processing.\n * - `void` -- Fire-and-forget, no response.\n */\nexport type TriggerAction = { type: 'enqueue'; queue: string } | { type: 'void' }\n\n/**\n * Input passed to the RBAC middleware function on every function invocation\n * through the RBAC port. The middleware can inspect, modify, or reject the\n * call before it reaches the target function.\n */\nexport type MiddlewareFunctionInput = {\n  /** ID of the function being invoked. */\n  function_id: string\n  /** Payload sent by the caller. */\n  payload: Record<string, unknown>\n  /** Routing action, if any. */\n  action?: TriggerAction\n  /** Auth context returned by the auth function for this session. */\n  context: Record<string, unknown>\n}\n\n/**\n * Request object passed to {@link IIIClient.trigger}.\n *\n * @typeParam TInput - Type of the payload.\n */\nexport type TriggerRequest<TInput = unknown> = {\n  /** ID of the function to invoke. */\n  function_id: string\n  /** Payload to pass to the function. */\n  payload: TInput\n  /** Routing action. Omit for synchronous request/response. */\n  action?: TriggerAction\n  /** Override the default invocation timeout in milliseconds. */\n  timeoutMs?: number\n}\n\nexport type InvokeFunctionMessage = {\n  message_type: MessageType.InvokeFunction\n  /**\n   * This is optional for async invocations\n   */\n  invocation_id?: string\n  /**\n   * The path of the function\n   */\n  function_id: string\n  /**\n   * The data to pass to the function\n   */\n  data: unknown\n  /**\n   * W3C trace-context traceparent header for distributed tracing\n   */\n  traceparent?: string\n  /**\n   * W3C baggage header for cross-cutting context propagation\n   */\n  baggage?: string\n  /**\n   * Trigger action for queue routing or fire-and-forget\n   */\n  action?: TriggerAction\n}\n\nexport type InvocationResultMessage = {\n  message_type: MessageType.InvocationResult\n  /**\n   * The id of the invocation\n   */\n  invocation_id: string\n  /**\n   * The path of the function\n   */\n  function_id: string\n  result?: unknown\n  error?: unknown\n  /**\n   * W3C trace-context traceparent header for distributed tracing\n   */\n  traceparent?: string\n  /**\n   * W3C baggage header for cross-cutting context propagation\n   */\n  baggage?: string\n}\n\nexport type WorkerRegisteredMessage = {\n  message_type: MessageType.WorkerRegistered\n  worker_id: string\n}\n\nexport type UnregisterFunctionMessage = {\n  message_type: MessageType.UnregisterFunction\n  id: string\n}\n\n/**\n * Serializable reference to one end of a streaming channel. Can be included\n * in invocation payloads to pass channel endpoints between workers.\n */\nexport type StreamChannelRef = {\n  /** Unique channel identifier. */\n  channel_id: string\n  /** Access key for authentication. */\n  access_key: string\n  /** Whether this ref is for reading or writing. */\n  direction: 'read' | 'write'\n}\n\nexport type IIIMessage =\n  | RegisterFunctionMessage\n  | UnregisterFunctionMessage\n  | InvokeFunctionMessage\n  | InvocationResultMessage\n  | RegisterTriggerMessage\n  | RegisterTriggerTypeMessage\n  | UnregisterTriggerMessage\n  | UnregisterTriggerTypeMessage\n  | TriggerRegistrationResultMessage\n  | WorkerRegisteredMessage\n"],"mappings":";;AAEA,IAAY,cAAL;AACL;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;KACD"}
+{"version":3,"file":"iii-types-6aHBgy7l.cjs","names":[],"sources":["../src/iii-types.ts"],"sourcesContent":["import type { HttpInvocationConfig } from '@iii-dev/helpers/http'\n\n/**\n * Any JSON value: the TypeScript equivalent of the engine's arbitrary-JSON\n * wire values (Rust `serde_json::Value`). Used where the wire contract is\n * \"any JSON\", e.g. per-invocation `metadata`.\n */\nexport type JsonValue =\n  | string\n  | number\n  | boolean\n  | null\n  | JsonValue[]\n  | { [key: string]: JsonValue }\n\nexport enum MessageType {\n  RegisterFunction = 'registerfunction',\n  UnregisterFunction = 'unregisterfunction',\n  InvokeFunction = 'invokefunction',\n  InvocationResult = 'invocationresult',\n  RegisterTriggerType = 'registertriggertype',\n  RegisterTrigger = 'registertrigger',\n  UnregisterTrigger = 'unregistertrigger',\n  UnregisterTriggerType = 'unregistertriggertype',\n  TriggerRegistrationResult = 'triggerregistrationresult',\n  WorkerRegistered = 'workerregistered',\n}\n\nexport type RegisterTriggerTypeMessage = {\n  message_type: MessageType.RegisterTriggerType\n  id: string\n  description: string\n}\n\nexport type UnregisterTriggerTypeMessage = {\n  message_type: MessageType.UnregisterTriggerType\n  id: string\n}\n\nexport type UnregisterTriggerMessage = {\n  message_type: MessageType.UnregisterTrigger\n  id: string\n  type?: string\n}\n\nexport type ErrorBody = {\n  code: string\n  message: string\n  stacktrace?: string\n}\n\nexport type TriggerRegistrationResultMessage = {\n  message_type: MessageType.TriggerRegistrationResult\n  id: string\n  type: string\n  function_id: string\n  error?: ErrorBody\n}\n\nexport type RegisterTriggerMessage = {\n  message_type: MessageType.RegisterTrigger\n  id: string\n  type: string\n  function_id: string\n  config: unknown\n  metadata?: Record<string, unknown>\n}\n\nexport type RegisterFunctionFormat = {\n  /**\n   * The name of the parameter\n   */\n  name?: string\n  /**\n   * The description of the parameter\n   */\n  description?: string\n  /**\n   * The type of the parameter\n   */\n  type?: 'string' | 'number' | 'boolean' | 'object' | 'array' | 'null' | 'map' | 'integer'\n  /**\n   * The body of the parameter (for objects)\n   */\n  properties?: Record<string, unknown>\n  /**\n   * The items of the parameter (for arrays)\n   */\n  items?: unknown\n  /**\n   * Whether the parameter is required\n   */\n  required?: string[]\n  [key: string]: unknown\n}\n\nexport type RegisterFunctionMessage = {\n  message_type: MessageType.RegisterFunction\n  /**\n   * The path of the function (use :: for namespacing, e.g. external::my_lambda)\n   */\n  id: string\n  /**\n   * The description of the function\n   */\n  description?: string\n  /**\n   * The request format of the function\n   */\n  request_format?: RegisterFunctionFormat\n  /**\n   * The response format of the function\n   */\n  response_format?: RegisterFunctionFormat\n  metadata?: Record<string, unknown>\n  /**\n   * HTTP invocation config for external HTTP functions (Lambda, Cloudflare Workers, etc.)\n   */\n  invocation?: HttpInvocationConfig\n}\n\n/**\n * Routing action for {@link TriggerRequest}. Determines how the engine\n * handles the invocation.\n *\n * - `enqueue` -- Routes through a named queue for async processing.\n * - `void` -- Fire-and-forget, no response.\n */\nexport type TriggerAction = { type: 'enqueue'; queue: string } | { type: 'void' }\n\n/**\n * Input passed to the RBAC middleware function on every function invocation\n * through the RBAC port. The middleware can inspect, modify, or reject the\n * call before it reaches the target function.\n */\nexport type MiddlewareFunctionInput = {\n  /** ID of the function being invoked. */\n  function_id: string\n  /** Payload sent by the caller. */\n  payload: Record<string, unknown>\n  /** Routing action, if any. */\n  action?: TriggerAction\n  /** Auth context returned by the auth function for this session. */\n  context: Record<string, unknown>\n}\n\n/**\n * Request object passed to {@link IIIClient.trigger}.\n *\n * @typeParam TInput - Type of the payload.\n */\nexport type TriggerRequest<TInput = unknown> = {\n  /** ID of the function to invoke. */\n  function_id: string\n  /** Payload to pass to the function. */\n  payload: TInput\n  /** Routing action. Omit for synchronous request/response. */\n  action?: TriggerAction\n  /** Override the default invocation timeout in milliseconds. */\n  timeoutMs?: number\n  /**\n   * Optional per-invocation metadata (arbitrary JSON). Travels as a separate\n   * channel from the payload and is surfaced to the target handler as a\n   * dedicated argument. Omitted from the wire message when undefined.\n   */\n  metadata?: unknown\n}\n\nexport type InvokeFunctionMessage = {\n  message_type: MessageType.InvokeFunction\n  /**\n   * This is optional for async invocations\n   */\n  invocation_id?: string\n  /**\n   * The path of the function\n   */\n  function_id: string\n  /**\n   * The data to pass to the function\n   */\n  data: unknown\n  /**\n   * W3C trace-context traceparent header for distributed tracing\n   */\n  traceparent?: string\n  /**\n   * W3C baggage header for cross-cutting context propagation\n   */\n  baggage?: string\n  /**\n   * Trigger action for queue routing or fire-and-forget\n   */\n  action?: TriggerAction\n  /**\n   * Optional per-invocation metadata (arbitrary JSON). Travels as a separate\n   * channel from `data`. Omitted from the JSON when undefined; absence on\n   * inbound means \"no metadata\" (backward compatible with older engines).\n   */\n  metadata?: JsonValue\n}\n\nexport type InvocationResultMessage = {\n  message_type: MessageType.InvocationResult\n  /**\n   * The id of the invocation\n   */\n  invocation_id: string\n  /**\n   * The path of the function\n   */\n  function_id: string\n  result?: unknown\n  error?: unknown\n  /**\n   * W3C trace-context traceparent header for distributed tracing\n   */\n  traceparent?: string\n  /**\n   * W3C baggage header for cross-cutting context propagation\n   */\n  baggage?: string\n}\n\nexport type WorkerRegisteredMessage = {\n  message_type: MessageType.WorkerRegistered\n  worker_id: string\n}\n\nexport type UnregisterFunctionMessage = {\n  message_type: MessageType.UnregisterFunction\n  id: string\n}\n\n/**\n * Serializable reference to one end of a streaming channel. Can be included\n * in invocation payloads to pass channel endpoints between workers.\n */\nexport type StreamChannelRef = {\n  /** Unique channel identifier. */\n  channel_id: string\n  /** Access key for authentication. */\n  access_key: string\n  /** Whether this ref is for reading or writing. */\n  direction: 'read' | 'write'\n}\n\nexport type IIIMessage =\n  | RegisterFunctionMessage\n  | UnregisterFunctionMessage\n  | InvokeFunctionMessage\n  | InvocationResultMessage\n  | RegisterTriggerMessage\n  | RegisterTriggerTypeMessage\n  | UnregisterTriggerMessage\n  | UnregisterTriggerTypeMessage\n  | TriggerRegistrationResultMessage\n  | WorkerRegisteredMessage\n"],"mappings":";;AAeA,IAAY,cAAL;AACL;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;KACD"}

package/dist/iii-types-CRx2qAjB.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"iii-types-CRx2qAjB.mjs","names":[],"sources":["../src/iii-types.ts"],"sourcesContent":["import type { HttpInvocationConfig } from '@iii-dev/helpers/http'\n\nexport enum MessageType {\n  RegisterFunction = 'registerfunction',\n  UnregisterFunction = 'unregisterfunction',\n  InvokeFunction = 'invokefunction',\n  InvocationResult = 'invocationresult',\n  RegisterTriggerType = 'registertriggertype',\n  RegisterTrigger = 'registertrigger',\n  UnregisterTrigger = 'unregistertrigger',\n  UnregisterTriggerType = 'unregistertriggertype',\n  TriggerRegistrationResult = 'triggerregistrationresult',\n  WorkerRegistered = 'workerregistered',\n}\n\nexport type RegisterTriggerTypeMessage = {\n  message_type: MessageType.RegisterTriggerType\n  id: string\n  description: string\n}\n\nexport type UnregisterTriggerTypeMessage = {\n  message_type: MessageType.UnregisterTriggerType\n  id: string\n}\n\nexport type UnregisterTriggerMessage = {\n  message_type: MessageType.UnregisterTrigger\n  id: string\n  type?: string\n}\n\nexport type ErrorBody = {\n  code: string\n  message: string\n  stacktrace?: string\n}\n\nexport type TriggerRegistrationResultMessage = {\n  message_type: MessageType.TriggerRegistrationResult\n  id: string\n  type: string\n  function_id: string\n  error?: ErrorBody\n}\n\nexport type RegisterTriggerMessage = {\n  message_type: MessageType.RegisterTrigger\n  id: string\n  type: string\n  function_id: string\n  config: unknown\n  metadata?: Record<string, unknown>\n}\n\nexport type RegisterFunctionFormat = {\n  /**\n   * The name of the parameter\n   */\n  name?: string\n  /**\n   * The description of the parameter\n   */\n  description?: string\n  /**\n   * The type of the parameter\n   */\n  type?: 'string' | 'number' | 'boolean' | 'object' | 'array' | 'null' | 'map' | 'integer'\n  /**\n   * The body of the parameter (for objects)\n   */\n  properties?: Record<string, unknown>\n  /**\n   * The items of the parameter (for arrays)\n   */\n  items?: unknown\n  /**\n   * Whether the parameter is required\n   */\n  required?: string[]\n  [key: string]: unknown\n}\n\nexport type RegisterFunctionMessage = {\n  message_type: MessageType.RegisterFunction\n  /**\n   * The path of the function (use :: for namespacing, e.g. external::my_lambda)\n   */\n  id: string\n  /**\n   * The description of the function\n   */\n  description?: string\n  /**\n   * The request format of the function\n   */\n  request_format?: RegisterFunctionFormat\n  /**\n   * The response format of the function\n   */\n  response_format?: RegisterFunctionFormat\n  metadata?: Record<string, unknown>\n  /**\n   * HTTP invocation config for external HTTP functions (Lambda, Cloudflare Workers, etc.)\n   */\n  invocation?: HttpInvocationConfig\n}\n\n/**\n * Routing action for {@link TriggerRequest}. Determines how the engine\n * handles the invocation.\n *\n * - `enqueue` -- Routes through a named queue for async processing.\n * - `void` -- Fire-and-forget, no response.\n */\nexport type TriggerAction = { type: 'enqueue'; queue: string } | { type: 'void' }\n\n/**\n * Input passed to the RBAC middleware function on every function invocation\n * through the RBAC port. The middleware can inspect, modify, or reject the\n * call before it reaches the target function.\n */\nexport type MiddlewareFunctionInput = {\n  /** ID of the function being invoked. */\n  function_id: string\n  /** Payload sent by the caller. */\n  payload: Record<string, unknown>\n  /** Routing action, if any. */\n  action?: TriggerAction\n  /** Auth context returned by the auth function for this session. */\n  context: Record<string, unknown>\n}\n\n/**\n * Request object passed to {@link IIIClient.trigger}.\n *\n * @typeParam TInput - Type of the payload.\n */\nexport type TriggerRequest<TInput = unknown> = {\n  /** ID of the function to invoke. */\n  function_id: string\n  /** Payload to pass to the function. */\n  payload: TInput\n  /** Routing action. Omit for synchronous request/response. */\n  action?: TriggerAction\n  /** Override the default invocation timeout in milliseconds. */\n  timeoutMs?: number\n}\n\nexport type InvokeFunctionMessage = {\n  message_type: MessageType.InvokeFunction\n  /**\n   * This is optional for async invocations\n   */\n  invocation_id?: string\n  /**\n   * The path of the function\n   */\n  function_id: string\n  /**\n   * The data to pass to the function\n   */\n  data: unknown\n  /**\n   * W3C trace-context traceparent header for distributed tracing\n   */\n  traceparent?: string\n  /**\n   * W3C baggage header for cross-cutting context propagation\n   */\n  baggage?: string\n  /**\n   * Trigger action for queue routing or fire-and-forget\n   */\n  action?: TriggerAction\n}\n\nexport type InvocationResultMessage = {\n  message_type: MessageType.InvocationResult\n  /**\n   * The id of the invocation\n   */\n  invocation_id: string\n  /**\n   * The path of the function\n   */\n  function_id: string\n  result?: unknown\n  error?: unknown\n  /**\n   * W3C trace-context traceparent header for distributed tracing\n   */\n  traceparent?: string\n  /**\n   * W3C baggage header for cross-cutting context propagation\n   */\n  baggage?: string\n}\n\nexport type WorkerRegisteredMessage = {\n  message_type: MessageType.WorkerRegistered\n  worker_id: string\n}\n\nexport type UnregisterFunctionMessage = {\n  message_type: MessageType.UnregisterFunction\n  id: string\n}\n\n/**\n * Serializable reference to one end of a streaming channel. Can be included\n * in invocation payloads to pass channel endpoints between workers.\n */\nexport type StreamChannelRef = {\n  /** Unique channel identifier. */\n  channel_id: string\n  /** Access key for authentication. */\n  access_key: string\n  /** Whether this ref is for reading or writing. */\n  direction: 'read' | 'write'\n}\n\nexport type IIIMessage =\n  | RegisterFunctionMessage\n  | UnregisterFunctionMessage\n  | InvokeFunctionMessage\n  | InvocationResultMessage\n  | RegisterTriggerMessage\n  | RegisterTriggerTypeMessage\n  | UnregisterTriggerMessage\n  | UnregisterTriggerTypeMessage\n  | TriggerRegistrationResultMessage\n  | WorkerRegisteredMessage\n"],"mappings":";AAEA,IAAY,cAAL;AACL;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;KACD"}
+{"version":3,"file":"iii-types-CRx2qAjB.mjs","names":[],"sources":["../src/iii-types.ts"],"sourcesContent":["import type { HttpInvocationConfig } from '@iii-dev/helpers/http'\n\n/**\n * Any JSON value: the TypeScript equivalent of the engine's arbitrary-JSON\n * wire values (Rust `serde_json::Value`). Used where the wire contract is\n * \"any JSON\", e.g. per-invocation `metadata`.\n */\nexport type JsonValue =\n  | string\n  | number\n  | boolean\n  | null\n  | JsonValue[]\n  | { [key: string]: JsonValue }\n\nexport enum MessageType {\n  RegisterFunction = 'registerfunction',\n  UnregisterFunction = 'unregisterfunction',\n  InvokeFunction = 'invokefunction',\n  InvocationResult = 'invocationresult',\n  RegisterTriggerType = 'registertriggertype',\n  RegisterTrigger = 'registertrigger',\n  UnregisterTrigger = 'unregistertrigger',\n  UnregisterTriggerType = 'unregistertriggertype',\n  TriggerRegistrationResult = 'triggerregistrationresult',\n  WorkerRegistered = 'workerregistered',\n}\n\nexport type RegisterTriggerTypeMessage = {\n  message_type: MessageType.RegisterTriggerType\n  id: string\n  description: string\n}\n\nexport type UnregisterTriggerTypeMessage = {\n  message_type: MessageType.UnregisterTriggerType\n  id: string\n}\n\nexport type UnregisterTriggerMessage = {\n  message_type: MessageType.UnregisterTrigger\n  id: string\n  type?: string\n}\n\nexport type ErrorBody = {\n  code: string\n  message: string\n  stacktrace?: string\n}\n\nexport type TriggerRegistrationResultMessage = {\n  message_type: MessageType.TriggerRegistrationResult\n  id: string\n  type: string\n  function_id: string\n  error?: ErrorBody\n}\n\nexport type RegisterTriggerMessage = {\n  message_type: MessageType.RegisterTrigger\n  id: string\n  type: string\n  function_id: string\n  config: unknown\n  metadata?: Record<string, unknown>\n}\n\nexport type RegisterFunctionFormat = {\n  /**\n   * The name of the parameter\n   */\n  name?: string\n  /**\n   * The description of the parameter\n   */\n  description?: string\n  /**\n   * The type of the parameter\n   */\n  type?: 'string' | 'number' | 'boolean' | 'object' | 'array' | 'null' | 'map' | 'integer'\n  /**\n   * The body of the parameter (for objects)\n   */\n  properties?: Record<string, unknown>\n  /**\n   * The items of the parameter (for arrays)\n   */\n  items?: unknown\n  /**\n   * Whether the parameter is required\n   */\n  required?: string[]\n  [key: string]: unknown\n}\n\nexport type RegisterFunctionMessage = {\n  message_type: MessageType.RegisterFunction\n  /**\n   * The path of the function (use :: for namespacing, e.g. external::my_lambda)\n   */\n  id: string\n  /**\n   * The description of the function\n   */\n  description?: string\n  /**\n   * The request format of the function\n   */\n  request_format?: RegisterFunctionFormat\n  /**\n   * The response format of the function\n   */\n  response_format?: RegisterFunctionFormat\n  metadata?: Record<string, unknown>\n  /**\n   * HTTP invocation config for external HTTP functions (Lambda, Cloudflare Workers, etc.)\n   */\n  invocation?: HttpInvocationConfig\n}\n\n/**\n * Routing action for {@link TriggerRequest}. Determines how the engine\n * handles the invocation.\n *\n * - `enqueue` -- Routes through a named queue for async processing.\n * - `void` -- Fire-and-forget, no response.\n */\nexport type TriggerAction = { type: 'enqueue'; queue: string } | { type: 'void' }\n\n/**\n * Input passed to the RBAC middleware function on every function invocation\n * through the RBAC port. The middleware can inspect, modify, or reject the\n * call before it reaches the target function.\n */\nexport type MiddlewareFunctionInput = {\n  /** ID of the function being invoked. */\n  function_id: string\n  /** Payload sent by the caller. */\n  payload: Record<string, unknown>\n  /** Routing action, if any. */\n  action?: TriggerAction\n  /** Auth context returned by the auth function for this session. */\n  context: Record<string, unknown>\n}\n\n/**\n * Request object passed to {@link IIIClient.trigger}.\n *\n * @typeParam TInput - Type of the payload.\n */\nexport type TriggerRequest<TInput = unknown> = {\n  /** ID of the function to invoke. */\n  function_id: string\n  /** Payload to pass to the function. */\n  payload: TInput\n  /** Routing action. Omit for synchronous request/response. */\n  action?: TriggerAction\n  /** Override the default invocation timeout in milliseconds. */\n  timeoutMs?: number\n  /**\n   * Optional per-invocation metadata (arbitrary JSON). Travels as a separate\n   * channel from the payload and is surfaced to the target handler as a\n   * dedicated argument. Omitted from the wire message when undefined.\n   */\n  metadata?: unknown\n}\n\nexport type InvokeFunctionMessage = {\n  message_type: MessageType.InvokeFunction\n  /**\n   * This is optional for async invocations\n   */\n  invocation_id?: string\n  /**\n   * The path of the function\n   */\n  function_id: string\n  /**\n   * The data to pass to the function\n   */\n  data: unknown\n  /**\n   * W3C trace-context traceparent header for distributed tracing\n   */\n  traceparent?: string\n  /**\n   * W3C baggage header for cross-cutting context propagation\n   */\n  baggage?: string\n  /**\n   * Trigger action for queue routing or fire-and-forget\n   */\n  action?: TriggerAction\n  /**\n   * Optional per-invocation metadata (arbitrary JSON). Travels as a separate\n   * channel from `data`. Omitted from the JSON when undefined; absence on\n   * inbound means \"no metadata\" (backward compatible with older engines).\n   */\n  metadata?: JsonValue\n}\n\nexport type InvocationResultMessage = {\n  message_type: MessageType.InvocationResult\n  /**\n   * The id of the invocation\n   */\n  invocation_id: string\n  /**\n   * The path of the function\n   */\n  function_id: string\n  result?: unknown\n  error?: unknown\n  /**\n   * W3C trace-context traceparent header for distributed tracing\n   */\n  traceparent?: string\n  /**\n   * W3C baggage header for cross-cutting context propagation\n   */\n  baggage?: string\n}\n\nexport type WorkerRegisteredMessage = {\n  message_type: MessageType.WorkerRegistered\n  worker_id: string\n}\n\nexport type UnregisterFunctionMessage = {\n  message_type: MessageType.UnregisterFunction\n  id: string\n}\n\n/**\n * Serializable reference to one end of a streaming channel. Can be included\n * in invocation payloads to pass channel endpoints between workers.\n */\nexport type StreamChannelRef = {\n  /** Unique channel identifier. */\n  channel_id: string\n  /** Access key for authentication. */\n  access_key: string\n  /** Whether this ref is for reading or writing. */\n  direction: 'read' | 'write'\n}\n\nexport type IIIMessage =\n  | RegisterFunctionMessage\n  | UnregisterFunctionMessage\n  | InvokeFunctionMessage\n  | InvocationResultMessage\n  | RegisterTriggerMessage\n  | RegisterTriggerTypeMessage\n  | UnregisterTriggerMessage\n  | UnregisterTriggerTypeMessage\n  | TriggerRegistrationResultMessage\n  | WorkerRegisteredMessage\n"],"mappings":";AAeA,IAAY,cAAL;AACL;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;KACD"}

package/dist/index.cjs

@@ -1,7 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_utils = require('./utils-63wxBJg-.cjs');
 const require_errors = require('./errors.cjs');
-const require_channels = require('./channels-ZbQzcwnN.cjs');
+const require_channels = require('./channels-DfBRsGN1.cjs');
 const require_iii_constants = require('./iii-constants-Br94RUNi.cjs');
 const require_iii_types = require('./iii-types-6aHBgy7l.cjs');
 let _opentelemetry_api = require("@opentelemetry/api");
@@ -113,7 +113,7 @@ var Sdk = class {
 				const handler = handlerOrInvocation;
 				this.functions.set(functionId, {
 					message: fullMessage,
-					handler: async (input, traceparent, baggage) => {
+					handler: async (input, metadata, traceparent, baggage) => {
 						const tracePayloads = !(process.env.III_DISABLE_TRACE_PAYLOADS === "1" || process.env.III_DISABLE_TRACE_PAYLOADS?.toLowerCase() === "true");
 						const payloadMaxBytes = (0, _iii_dev_helpers_observability.resolveMaxBytesFromEnv)();
 						const runHandler = async () => {
@@ -125,7 +125,7 @@ var Sdk = class {
 								});
 							}
 							try {
-								const result = await handler(input);
+								const result = await handler(input, metadata);
 								if (tracePayloads) {
 									const { json, truncated } = (0, _iii_dev_helpers_observability.redactAndTruncate)(result, payloadMaxBytes);
 									(0, _iii_dev_helpers_observability.recordSpanEvent)("iii.invocation.output", {
@@ -183,7 +183,7 @@ var Sdk = class {
 			};
 		};
 		this.trigger = async (request) => {
-			const { function_id, payload, action, timeoutMs } = request;
+			const { function_id, payload, action, timeoutMs, metadata } = request;
 			const effectiveTimeout = timeoutMs ?? this.invocationTimeoutMs;
 			if (action?.type === "void") {
 				const traceparent = (0, _iii_dev_helpers_observability.injectTraceparent)();
@@ -193,7 +193,8 @@ var Sdk = class {
 					data: payload,
 					traceparent,
 					baggage,
-					action
+					action,
+					metadata
 				});
 				return;
 			}
@@ -229,7 +230,8 @@ var Sdk = class {
 					data: payload,
 					traceparent,
 					baggage,
-					action
+					action,
+					metadata
 				});
 			});
 		};
@@ -480,7 +482,7 @@ var Sdk = class {
 		}
 		return value;
 	}
-	async onInvokeFunction(invocation_id, function_id, input, traceparent, baggage) {
+	async onInvokeFunction(invocation_id, function_id, input, metadata, traceparent, baggage) {
 		const fn = this.functions.get(function_id);
 		const getResponseTraceparent = () => (0, _iii_dev_helpers_observability.injectTraceparent)() ?? traceparent;
 		const getResponseBaggage = () => (0, _iii_dev_helpers_observability.injectBaggage)() ?? baggage;
@@ -488,14 +490,14 @@ var Sdk = class {
 		if (fn?.handler) {
 			if (!invocation_id) {
 				try {
-					await fn.handler(resolvedInput, traceparent, baggage);
+					await fn.handler(resolvedInput, metadata, traceparent, baggage);
 				} catch (error) {
 					this.logError(`Error invoking function ${function_id}`, error);
 				}
 				return;
 			}
 			try {
-				const result = await fn.handler(resolvedInput, traceparent, baggage);
+				const result = await fn.handler(resolvedInput, metadata, traceparent, baggage);
 				this.sendMessage(require_iii_types.MessageType.InvocationResult, {
 					invocation_id,
 					function_id,
@@ -609,8 +611,8 @@ var Sdk = class {
 			const { invocation_id, result, error } = message;
 			this.onInvocationResult(invocation_id, result, error);
 		} else if (msgType === require_iii_types.MessageType.InvokeFunction) {
-			const { invocation_id, function_id, data, traceparent, baggage } = message;
-			this.onInvokeFunction(invocation_id, function_id, data, traceparent, baggage);
+			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);