iii-sdk 0.22.0 → 0.22.1-alpha.2

package/dist/index.cjs

@@ -3,7 +3,7 @@ const require_utils = require('./utils-63wxBJg-.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_iii_types = require('./iii-types-BvaIabiX.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");
@@ -14,6 +14,18 @@ let _iii_dev_helpers_observability_internal = require("@iii-dev/helpers/observab
 
 //#region src/iii.ts
 const { version: SDK_VERSION } = (0, node_module.createRequire)(require("url").pathToFileURL(__filename).href)("../package.json");
+/**
+* `registrationrejected` code (engine `protocol.rs`): another live worker
+* already holds this `(namespace, worker_name)`. The engine closes the
+* connection -- fatal.
+*/
+const WORKER_NAMESPACE_CONFLICT = "WORKER_NAMESPACE_CONFLICT";
+/**
+* `registrationrejected` code (engine `protocol.rs`): another live worker in
+* this namespace already exports this one function id. The connection stays
+* open -- non-fatal.
+*/
+const FUNCTION_NAMESPACE_CONFLICT = "FUNCTION_NAMESPACE_CONFLICT";
 function getOsInfo() {
 	return `${node_os.platform()} ${node_os.release()} (${node_os.arch()})`;
 }
@@ -22,6 +34,23 @@ function getDefaultWorkerName() {
 	if (managedName) return managedName;
 	return `${node_os.hostname()}:${process.pid}`;
 }
+/**
+* Engine address used when neither an explicit address nor `III_URL` is set.
+* The IPv4 loopback is spelled out on purpose: `localhost` can resolve to `::1`
+* on a host whose engine only listens on IPv4.
+*/
+const DEFAULT_ENGINE_URL = "ws://127.0.0.1:49134";
+function resolveAddress(address) {
+	if (address) return address;
+	const fromEnv = process.env.III_URL;
+	if (fromEnv) return fromEnv;
+	return DEFAULT_ENGINE_URL;
+}
+function resolveNamespace(optionNamespace) {
+	if (optionNamespace) return optionNamespace;
+	const managedNamespace = process.env.III_NAMESPACE;
+	if (managedNamespace) return managedNamespace;
+}
 var Sdk = class {
 	constructor(address, options) {
 		this.address = address;
@@ -50,7 +79,8 @@ var Sdk = class {
 						type: triggerType.id,
 						function_id: functionId,
 						config,
-						metadata
+						metadata,
+						namespace: this.namespace
 					});
 				},
 				registerFunction: (functionId, handler, config, metadata) => {
@@ -59,7 +89,8 @@ var Sdk = class {
 						type: triggerType.id,
 						function_id: functionId,
 						config,
-						metadata
+						metadata,
+						namespace: this.namespace
 					});
 					return ref;
 				},
@@ -185,7 +216,7 @@ var Sdk = class {
 			};
 		};
 		this.trigger = async (request) => {
-			const { function_id, payload, action, timeoutMs, metadata } = request;
+			const { function_id, payload, action, timeoutMs, metadata, namespace } = request;
 			const effectiveTimeout = timeoutMs ?? this.invocationTimeoutMs;
 			if (action?.type === "void") {
 				const traceparent = (0, _iii_dev_helpers_observability.injectTraceparent)();
@@ -196,7 +227,8 @@ var Sdk = class {
 					traceparent,
 					baggage,
 					action,
-					metadata
+					metadata,
+					...namespace !== void 0 ? { namespace } : {}
 				});
 				return;
 			}
@@ -233,7 +265,8 @@ var Sdk = class {
 					traceparent,
 					baggage,
 					action,
-					metadata
+					metadata,
+					...namespace !== void 0 ? { namespace } : {}
 				});
 			});
 		};
@@ -244,6 +277,9 @@ var Sdk = class {
 			this.registerFunction(`stream::list(${streamName})`, stream.list.bind(stream));
 			this.registerFunction(`stream::list_groups(${streamName})`, stream.listGroups.bind(stream));
 		};
+		this.getConnectionState = () => this.connectionState;
+		this.getAddress = () => this.address;
+		this.getFatalError = () => this.fatalError;
 		this.shutdown = async () => {
 			this.isShuttingDown = true;
 			this.stopMetricsReporting();
@@ -266,6 +302,7 @@ var Sdk = class {
 			this.setConnectionState("disconnected");
 		};
 		this.workerName = options?.workerName ?? getDefaultWorkerName();
+		this.namespace = resolveNamespace(options?.namespace);
 		this.workerDescription = options?.workerDescription;
 		this.metricsReportingEnabled = options?.enableMetricsReporting ?? true;
 		this.invocationTimeoutMs = options?.invocationTimeoutMs ?? 3e4;
@@ -292,6 +329,7 @@ var Sdk = class {
 				os: getOsInfo(),
 				pid: process.pid,
 				isolation: process.env.III_ISOLATION || null,
+				...this.namespace !== void 0 ? { namespace: this.namespace } : {},
 				telemetry: {
 					language,
 					project_name: telemetryOpts?.project_name ?? require_utils.detectProjectName(),
@@ -407,6 +445,7 @@ var Sdk = class {
 			previous_worker_id: this.workerId,
 			reattach_token: this.reattachToken
 		}));
+		this.registerWorkerMetadata();
 		this.triggerTypes.forEach(({ message }) => {
 			this.sendMessage(require_iii_types.MessageType.RegisterTriggerType, message, true);
 		});
@@ -422,7 +461,6 @@ var Sdk = class {
 			if (message.type === require_iii_types.MessageType.InvokeFunction && typeof message.invocation_id === "string" && !this.invocations.has(message.invocation_id)) continue;
 			this.sendMessageRaw(JSON.stringify(message));
 		}
-		this.registerWorkerMetadata();
 	}
 	isOpen() {
 		return this.ws?.readyState === ws.WebSocket.OPEN;
@@ -481,6 +519,56 @@ var Sdk = class {
 		});
 		else console.error(`[iii] ${message}`, error ?? "");
 	}
+	logWarn(message) {
+		const otelLogger = (0, _iii_dev_helpers_observability.getLogger)();
+		if (otelLogger) otelLogger.emit({
+			severityNumber: _iii_dev_helpers_observability.SeverityNumber.WARN,
+			body: `[iii] ${message}`
+		});
+		else console.warn(`[iii] ${message}`);
+	}
+	/**
+	* Handle a `registrationrejected` from the engine. The `code` decides the
+	* severity:
+	*
+	* - {@link WORKER_NAMESPACE_CONFLICT}: another live worker already holds this
+	*   `(namespace, worker_name)`. The engine closes the connection, so this is
+	*   fatal -- stop the worker, do not reconnect, and surface a
+	*   {@link RegistrationRejectedError} to every pending invocation.
+	* - {@link FUNCTION_NAMESPACE_CONFLICT}: another live worker in this namespace
+	*   already exports this one function id. Only that registration is refused;
+	*   the engine keeps the connection open and the worker keeps serving its
+	*   other functions. Non-fatal -- log a warning and continue.
+	* - Any other code: treated as fatal (safe default).
+	*/
+	onRegistrationRejected(init) {
+		if (init.code === FUNCTION_NAMESPACE_CONFLICT) {
+			this.logWarn(`Function registration rejected: function "${init.function_id ?? "<unknown>"}" in namespace "${init.namespace}" is already exported by worker ${init.owner_worker_id}. The worker stays connected and keeps serving its other functions.`);
+			return;
+		}
+		const error = new require_errors.RegistrationRejectedError(init);
+		this.fatalError = error;
+		if (init.code === WORKER_NAMESPACE_CONFLICT) this.logError("Registration rejected by engine", error);
+		else this.logError(`Registration rejected by engine with unknown code "${init.code}"; treating as fatal`, error);
+		this.isShuttingDown = true;
+		this.clearReconnectTimeout();
+		this.stopHeartbeat();
+		for (const [, invocation] of this.invocations) {
+			if (invocation.timeout) clearTimeout(invocation.timeout);
+			invocation.reject(error);
+		}
+		this.invocations.clear();
+		if (this.ws) {
+			this.ws.removeAllListeners();
+			this.ws.on("error", () => {});
+			try {
+				this.ws.terminate();
+			} catch {}
+			this.ws = void 0;
+		}
+		this.stopMetricsReporting();
+		this.setConnectionState("failed");
+	}
 	onInvocationResult(invocation_id, result, error) {
 		const invocation = this.invocations.get(invocation_id);
 		if (invocation) {
@@ -574,14 +662,15 @@ var Sdk = class {
 		}
 	}
 	async onRegisterTrigger(message) {
-		const { trigger_type, id, function_id, config, metadata } = message;
+		const { trigger_type, id, function_id, config, metadata, namespace } = message;
 		const triggerTypeData = this.triggerTypes.get(trigger_type);
 		if (triggerTypeData) try {
 			await triggerTypeData.handler.registerTrigger({
 				id,
 				function_id,
 				config,
-				metadata
+				metadata,
+				namespace
 			});
 			this.sendMessage(require_iii_types.MessageType.TriggerRegistrationResult, {
 				id,
@@ -661,6 +750,15 @@ var Sdk = class {
 			this.reattachToken = reattach_token;
 			console.debug("[iii] Worker registered with ID:", worker_id);
 			this.startMetricsReporting();
+		} else if (msgType === require_iii_types.MessageType.RegistrationRejected) {
+			const { code, namespace, worker_name, function_id, owner_worker_id } = message;
+			this.onRegistrationRejected({
+				code,
+				namespace,
+				worker_name,
+				function_id,
+				owner_worker_id
+			});
 		}
 	}
 };
@@ -697,7 +795,8 @@ const TriggerAction = {
 * Register the worker with a iii instance, returns a connected worker client.
 * The WebSocket connection is established automatically.
 *
-* @param address - WebSocket URL of the III engine (e.g. `ws://localhost:49134`).
+* @param address - WebSocket URL of the III engine. Omit to resolve it from
+*   `process.env.III_URL`, falling back to {@link DEFAULT_ENGINE_URL}.
 * @param options - Optional {@link InitOptions} for worker name, timeouts, reconnection, and OTel.
 * @returns A connected {@link IIIClient} instance.
 *
@@ -705,15 +804,19 @@ const TriggerAction = {
 * ```typescript
 * import { registerWorker } from 'iii-sdk'
 *
-* const worker = registerWorker(process.env.III_URL ?? 'ws://localhost:49134', {
-*   workerName: 'my-worker',
-* })
+* // Address from III_URL, set by whatever supervisor spawned this worker.
+* const worker = registerWorker()
+*
+* // Or explicitly, which always wins over the environment.
+* const other = registerWorker('ws://localhost:49134', { workerName: 'my-worker' })
 * ```
 */
-const registerWorker = (address, options) => new Sdk(address, options);
+const registerWorker = (address, options) => new Sdk(resolveAddress(address), options);
 
 //#endregion
+exports.DEFAULT_ENGINE_URL = DEFAULT_ENGINE_URL;
 exports.InvocationError = require_errors.InvocationError;
+exports.RegistrationRejectedError = require_errors.RegistrationRejectedError;
 exports.TriggerAction = TriggerAction;
 exports.registerWorker = registerWorker;
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["os","MessageType","context","SpanKind","trace","ChannelWriter","ChannelReader","InvocationError","DEFAULT_BRIDGE_RECONNECTION_CONFIG","EngineFunctions","detectProjectName","WebSocket","WS_HANDSHAKE_TIMEOUT_MS","WS_IDLE_TIMEOUT_MS","WS_PING_INTERVAL_MS","SeverityNumber","isErrorBody","isChannelRef"],"sources":["../src/iii.ts"],"sourcesContent":["import { context, trace } from '@opentelemetry/api'\nimport { createRequire } from 'node:module'\nimport * as os from 'node:os'\nimport { type Data, WebSocket } from 'ws'\nimport { ChannelReader, ChannelWriter } from './channels'\nimport { InvocationError, isErrorBody } from './errors'\nimport {\n  DEFAULT_BRIDGE_RECONNECTION_CONFIG,\n  DEFAULT_INVOCATION_TIMEOUT_MS,\n  EngineFunctions,\n  type IIIConnectionState,\n  type IIIReconnectionConfig,\n  WS_HANDSHAKE_TIMEOUT_MS,\n  WS_IDLE_TIMEOUT_MS,\n  WS_PING_INTERVAL_MS,\n} from './iii-constants'\nimport type { HttpInvocationConfig } from '@iii-dev/helpers/http'\nimport {\n  type IIIMessage,\n  type InvocationResultMessage,\n  type InvokeFunctionMessage,\n  type JsonValue,\n  MessageType,\n  type RegisterFunctionMessage,\n  type RegisterTriggerMessage,\n  type RegisterTriggerTypeMessage,\n  type StreamChannelRef,\n  type TriggerRegistrationResultMessage,\n  type TriggerRequest,\n  type WorkerRegisteredMessage,\n} from './iii-types'\nimport { registerWorkerGauges, stopWorkerGauges } from '@iii-dev/helpers/observability'\nimport { getMeter, getTracer } from '@iii-dev/helpers/observability/internal'\nimport { SpanKind } from '@opentelemetry/api'\nimport type { IStream } from './stream'\nimport { detectProjectName } from './utils'\nimport {\n  extractContext,\n  getLogger,\n  initOtel,\n  injectBaggage,\n  injectTraceparent,\n  type OtelConfig,\n  recordSpanEvent,\n  redactAndTruncate,\n  resolveMaxBytesFromEnv,\n  SeverityNumber,\n  shutdownOtel,\n  withSpan,\n} from '@iii-dev/helpers/observability'\nimport type { TriggerHandler } from './triggers'\nimport type {\n  FunctionRef,\n  IIIClient,\n  Invocation,\n  RegisterFunctionOptions,\n  RemoteFunctionData,\n  RemoteFunctionHandler,\n  RemoteTriggerTypeData,\n  Trigger,\n  TriggerTypeRef,\n} from './types'\nimport { isChannelRef } from './utils'\n\nconst require = createRequire(import.meta.url)\nconst { version: SDK_VERSION } = require('../package.json')\n\nfunction getOsInfo(): string {\n  return `${os.platform()} ${os.release()} (${os.arch()})`\n}\n\nfunction getDefaultWorkerName(): string {\n  // III_WORKER_NAME carries the config.yaml entry name for managed workers\n  // (set by iii-worker at spawn). Engine truth (`iii worker status`/`list`)\n  // matches connections by name, so the managed identity must win over the\n  // hostname:pid fallback.\n  const managedName = process.env.III_WORKER_NAME\n  if (managedName) {\n    return managedName\n  }\n  return `${os.hostname()}:${process.pid}`\n}\n\n/** Worker metadata reported to the engine (language, framework, project). */\nexport type TelemetryOptions = {\n  /** Programming language of the worker. */\n  language?: string\n  /** Name of the project this worker belongs to. */\n  project_name?: string\n  /** Framework name, if applicable. */\n  framework?: string\n  /** Amplitude API key for product analytics. */\n  amplitude_api_key?: string\n}\n\n/**\n * Configuration options passed to {@link registerWorker}.\n *\n * @example\n * ```typescript\n * const worker = registerWorker('ws://localhost:49134', {\n *   workerName: 'my-worker',\n *   invocationTimeoutMs: 10000,\n *   reconnectionConfig: { maxRetries: 5 },\n * })\n * ```\n */\nexport type InitOptions = {\n  /** Display name for this worker. Defaults to `hostname:pid`. */\n  workerName?: string\n  /**\n   * One-line, human/LLM-readable summary of what this worker does.\n   * Surfaces in `engine::workers::list` / `engine::workers::info`.\n   */\n  workerDescription?: string\n  /** Enable worker metrics via OpenTelemetry. Defaults to `true`. */\n  enableMetricsReporting?: boolean\n  /** Default timeout for `worker.trigger()` invocations in milliseconds. Defaults to `30000`. */\n  invocationTimeoutMs?: number\n  /**\n   * WebSocket reconnection behavior.\n   *\n   * @see {@link IIIReconnectionConfig} for available fields and defaults.\n   */\n  reconnectionConfig?: Partial<IIIReconnectionConfig>\n  /**\n   * OpenTelemetry configuration. OTel is initialized automatically by default.\n   * Set `{ enabled: false }` or env `OTEL_ENABLED=false/0/no/off` to disable.\n   * The `engineWsUrl` is set automatically from the III address.\n   */\n  otel?: Omit<OtelConfig, 'engineWsUrl'>\n  /** Custom HTTP headers sent during the WebSocket handshake. */\n  headers?: Record<string, string>\n  /** @internal */\n  telemetry?: TelemetryOptions\n}\n\nclass Sdk implements IIIClient {\n  private ws?: WebSocket\n  private functions = new Map<string, RemoteFunctionData>()\n  private invocations = new Map<string, Invocation & { timeout?: NodeJS.Timeout }>()\n  private triggers = new Map<string, RegisterTriggerMessage>()\n  private triggerTypes = new Map<string, RemoteTriggerTypeData>()\n  private messagesToSend: Record<string, unknown>[] = []\n  private workerName: string\n  private workerDescription?: string\n  private workerId?: string\n  private reattachToken?: string\n  private reconnectTimeout?: NodeJS.Timeout\n  private heartbeatInterval?: NodeJS.Timeout\n  private idleTimeout?: NodeJS.Timeout\n  private metricsReportingEnabled: boolean\n  private invocationTimeoutMs: number\n  private reconnectionConfig: IIIReconnectionConfig\n  private reconnectAttempt = 0\n  private connectionState: IIIConnectionState = 'disconnected'\n  private isShuttingDown = false\n\n  constructor(\n    private readonly address: string,\n    private readonly options?: InitOptions,\n  ) {\n    this.workerName = options?.workerName ?? getDefaultWorkerName()\n    this.workerDescription = options?.workerDescription\n    this.metricsReportingEnabled = options?.enableMetricsReporting ?? true\n    this.invocationTimeoutMs = options?.invocationTimeoutMs ?? DEFAULT_INVOCATION_TIMEOUT_MS\n    this.reconnectionConfig = {\n      ...DEFAULT_BRIDGE_RECONNECTION_CONFIG,\n      ...options?.reconnectionConfig,\n    }\n\n    // Initialize OpenTelemetry (enabled by default, opt-out via config or env)\n    initOtel({ ...options?.otel, engineWsUrl: this.address })\n\n    this.connect()\n  }\n\n  /**\n   * Registers a custom trigger type with the engine. A trigger type defines\n   * how external events (HTTP, cron, queue, etc.) map to function invocations.\n   *\n   * @param triggerType - Trigger type registration input.\n   * @param triggerType.id - Unique trigger type identifier.\n   * @param triggerType.description - Human-readable description.\n   * @param handler - Handler with `registerTrigger` / `unregisterTrigger` callbacks.\n   *\n   * @example\n   * ```typescript\n   * worker.registerTriggerType(\n   *   { id: 'my-trigger', description: 'Custom trigger' },\n   *   {\n   *     async registerTrigger({ id, function_id, config }) { },\n   *     async unregisterTrigger({ id, function_id, config }) { },\n   *   },\n   * )\n   * ```\n   */\n  registerTriggerType = <TConfig>(\n    triggerType: Omit<RegisterTriggerTypeMessage, 'message_type'>,\n    handler: TriggerHandler<TConfig>,\n  ): TriggerTypeRef<TConfig> => {\n    this.sendMessage(MessageType.RegisterTriggerType, triggerType, true)\n    this.triggerTypes.set(triggerType.id, {\n      message: { ...triggerType, message_type: MessageType.RegisterTriggerType },\n      handler,\n    })\n\n    return {\n      id: triggerType.id,\n      registerTrigger: (functionId: string, config: TConfig, metadata?: Record<string, unknown>) => {\n        return this.registerTrigger({\n          type: triggerType.id,\n          function_id: functionId,\n          config,\n          metadata,\n        })\n      },\n      registerFunction: (functionId, handler, config, metadata?) => {\n        const ref = this.registerFunction(functionId, handler)\n        this.registerTrigger({\n          type: triggerType.id,\n          function_id: functionId,\n          config,\n          metadata,\n        })\n        return ref\n      },\n      unregister: () => {\n        this.unregisterTriggerType(triggerType)\n      },\n    }\n  }\n\n  /**\n   * Unregisters a previously registered trigger type.\n   *\n   * @param triggerType - The trigger type to unregister (must match the `id` used during registration).\n   */\n  unregisterTriggerType = (triggerType: Omit<RegisterTriggerTypeMessage, 'message_type'>): void => {\n    this.sendMessage(MessageType.UnregisterTriggerType, triggerType, true)\n    this.triggerTypes.delete(triggerType.id)\n  }\n\n  /**\n   * Binds a trigger configuration to a registered function. When the trigger\n   * fires, the engine invokes the target function.\n   *\n   * @param trigger - Trigger registration input.\n   * @param trigger.type - Trigger type (e.g. `http`, `durable:subscriber`, `cron`).\n   * @param trigger.function_id - ID of the function to invoke.\n   * @param trigger.config - Trigger-specific configuration.\n   * @returns A {@link Trigger} handle with an `unregister()` method.\n   *\n   * @example\n   * ```typescript\n   * const trigger = worker.registerTrigger({\n   *   type: 'http',\n   *   function_id: 'greet',\n   *   config: { api_path: '/greet', http_method: 'GET' },\n   * })\n   *\n   * // Later...\n   * trigger.unregister()\n   * ```\n   */\n  registerTrigger = (trigger: Omit<RegisterTriggerMessage, 'message_type' | 'id'>): Trigger => {\n    const id = crypto.randomUUID()\n    const fullTrigger: RegisterTriggerMessage = {\n      ...trigger,\n      id,\n      message_type: MessageType.RegisterTrigger,\n    }\n    this.sendMessage(MessageType.RegisterTrigger, fullTrigger, true)\n    this.triggers.set(id, fullTrigger)\n\n    return {\n      unregister: () => {\n        this.sendMessage(MessageType.UnregisterTrigger, {\n          id,\n          message_type: MessageType.UnregisterTrigger,\n          type: fullTrigger.type,\n        })\n        this.triggers.delete(id)\n      },\n    }\n  }\n\n  /**\n   * Registers a function with the engine. The `functionId` is the unique identifier\n   * used by triggers and invocations.\n   *\n   * Pass a handler for local execution, or an {@link HttpInvocationConfig}\n   * for HTTP-invoked functions (Lambda, Cloudflare Workers, etc.).\n   *\n   * @param functionId - Unique function identifier.\n   * @param handlerOrInvocation - Async handler or HTTP invocation config.\n   * @param options - Optional function registration options (description, request/response formats, metadata).\n   * @returns A {@link FunctionRef} with `id` and `unregister()`.\n   *\n   * @example\n   * ```typescript\n   * const fn = worker.registerFunction(\n   *   'greet',\n   *   async (input: { name: string }) => {\n   *     return { message: `Hello, ${input.name}!` }\n   *   },\n   *   { description: 'Greets a user' },\n   * )\n   * ```\n   */\n  registerFunction = (\n    functionId: string,\n    handlerOrInvocation: RemoteFunctionHandler | HttpInvocationConfig,\n    options?: RegisterFunctionOptions,\n  ): FunctionRef => {\n    if (!functionId || functionId.trim() === '') {\n      throw new Error('id is required')\n    }\n    if (this.functions.has(functionId)) {\n      throw new Error(`function id already registered: ${functionId}`)\n    }\n\n    const isHandler = typeof handlerOrInvocation === 'function'\n\n    const fullMessage: RegisterFunctionMessage = isHandler\n      ? { ...options, id: functionId, message_type: MessageType.RegisterFunction }\n      : {\n          ...options,\n          id: functionId,\n          message_type: MessageType.RegisterFunction,\n          invocation: {\n            url: handlerOrInvocation.url,\n            method: handlerOrInvocation.method ?? 'POST',\n            timeout_ms: handlerOrInvocation.timeout_ms,\n            headers: handlerOrInvocation.headers,\n            auth: handlerOrInvocation.auth,\n          },\n        }\n\n    this.sendMessage(MessageType.RegisterFunction, fullMessage, true)\n\n    if (isHandler) {\n      const handler = handlerOrInvocation as RemoteFunctionHandler\n      this.functions.set(functionId, {\n        message: fullMessage,\n        handler: async (input, metadata?: JsonValue, traceparent?: string, baggage?: string) => {\n          const tracePayloads = !(\n            process.env.III_DISABLE_TRACE_PAYLOADS === '1' ||\n            process.env.III_DISABLE_TRACE_PAYLOADS?.toLowerCase() === 'true'\n          )\n          const payloadMaxBytes = resolveMaxBytesFromEnv()\n\n          const runHandler = async () => {\n            if (tracePayloads) {\n              const { json, truncated } = redactAndTruncate(input, payloadMaxBytes)\n              recordSpanEvent('iii.invocation.input', {\n                'iii.payload.json': json,\n                'iii.payload.truncated': truncated,\n              })\n            }\n            try {\n              const result = await handler(input, metadata)\n              if (tracePayloads) {\n                const { json, truncated } = redactAndTruncate(result, payloadMaxBytes)\n                recordSpanEvent('iii.invocation.output', {\n                  'iii.payload.json': json,\n                  'iii.payload.truncated': truncated,\n                  'iii.payload.ok': true,\n                })\n              }\n              return result\n            } catch (err) {\n              if (tracePayloads) {\n                const errMsg = err instanceof Error ? err.message : String(err)\n                const { json, truncated } = redactAndTruncate(\n                  { error: errMsg },\n                  payloadMaxBytes,\n                )\n                recordSpanEvent('iii.invocation.output', {\n                  'iii.payload.json': json,\n                  'iii.payload.truncated': truncated,\n                  'iii.payload.ok': false,\n                })\n              }\n              throw err\n            }\n          }\n\n          if (getTracer()) {\n            const parentContext = extractContext(traceparent, baggage)\n\n            // INTERNAL and named `execute` (not `call`/`trigger`): the engine\n            // suppresses its own `call <fn>` span for worker-routed functions\n            // (this span is the canonical one for the invocation) but still\n            // emits engine-side wrappers like `trigger <fn>` from fire_triggers\n            // and `call <fn>` for builtins. Reusing those names would read as\n            // duplicate engine spans under the worker's service. `execute` is\n            // unique, so the worker handler span reads as a clean internal\n            // child (and is collapsible by a single rule).\n            return context.with(parentContext, () =>\n              withSpan(`execute ${functionId}`, { kind: SpanKind.INTERNAL }, async () => await runHandler()),\n            )\n          }\n\n          const traceId = crypto.randomUUID().replace(/-/g, '')\n          const spanId = crypto.randomUUID().replace(/-/g, '').slice(0, 16)\n          const syntheticSpan = trace.wrapSpanContext({ traceId, spanId, traceFlags: 1 })\n\n          return context.with(trace.setSpan(context.active(), syntheticSpan), async () => await runHandler())\n        },\n      })\n    } else {\n      this.functions.set(functionId, { message: fullMessage })\n    }\n\n    return {\n      id: functionId,\n      unregister: () => {\n        this.sendMessage(MessageType.UnregisterFunction, { id: functionId }, true)\n        this.functions.delete(functionId)\n      },\n    }\n  }\n\n  /**\n   * @internal Implementation backing the `createChannel` helper in the\n   * `iii-sdk/helpers` submodule. Not part of the public `IIIClient` surface.\n   *\n   * Creates a streaming channel pair for worker-to-worker data transfer.\n   * Returns a {@link Channel} with a local writer/reader and serializable refs\n   * that can be passed as fields in invocation data to other functions.\n   */\n  __helpers_create_channel = async (bufferSize?: number): Promise<import('./types').Channel> => {\n    const result = await this.trigger<{ buffer_size?: number }, { writer: StreamChannelRef; reader: StreamChannelRef }>(\n      { function_id: 'engine::channels::create', payload: { buffer_size: bufferSize } },\n    )\n\n    return {\n      writer: new ChannelWriter(this.address, result.writer),\n      reader: new ChannelReader(this.address, result.reader),\n      writerRef: result.writer,\n      readerRef: result.reader,\n    }\n  }\n\n  /**\n   * Invokes a remote function. The routing behavior and return type depend\n   * on the `action` field of the request.\n   *\n   * | `action`                      | Behavior                                           | Return type              |\n   * |-------------------------------|----------------------------------------------------|-----------------------   |\n   * | _(none)_                      | Synchronous: waits for the function to return     | `Promise<TOutput>`       |\n   * | `TriggerAction.Enqueue(...)` | Async via named queue; engine acknowledges enqueue | `Promise<EnqueueResult>` |\n   * | `TriggerAction.Void()`       | Fire-and-forget, no response                      | `Promise<undefined>`     |\n   *\n   * @param request - The trigger request.\n   * @param request.function_id - ID of the function to invoke.\n   * @param request.payload - Payload to pass to the function.\n   * @param request.action - Routing action. Omit for synchronous request/response.\n   * @param request.timeoutMs - Override the default invocation timeout.\n   * @param request.metadata - Optional per-invocation metadata (arbitrary JSON)\n   *   surfaced to the target handler as its second argument.\n   * @returns The result of the function invocation.\n   *\n   * @example\n   * ```typescript\n   * import { TriggerAction } from 'iii-sdk'\n   *\n   * // Synchronous\n   * const result = await worker.trigger({ function_id: 'get-order', payload: { id: '123' } })\n   *\n   * // Enqueue\n   * const { messageReceiptId } = await worker.trigger({\n   *   function_id: 'payments::charge',\n   *   payload: { orderId: '123', amount: 49.99 },\n   *   action: TriggerAction.Enqueue({ queue: 'payment' }),\n   * })\n   *\n   * // Fire-and-forget\n   * worker.trigger({\n   *   function_id: 'notifications::send',\n   *   payload: { userId: '123' },\n   *   action: TriggerAction.Void(),\n   * })\n   * ```\n   */\n  // biome-ignore lint/suspicious/noExplicitAny: TOutput defaults to any so untyped calls type-check (the engine cannot express the return type statically)\n  trigger = async <TInput = unknown, TOutput = any>(\n    request: TriggerRequest<TInput>,\n  ): Promise<TOutput> => {\n    const { function_id, payload, action, timeoutMs, metadata } = request\n    const effectiveTimeout = timeoutMs ?? this.invocationTimeoutMs\n\n    // Void is fire-and-forget, no invocation_id, no response\n    if (action?.type === 'void') {\n      const traceparent = injectTraceparent()\n      const baggage = injectBaggage()\n      this.sendMessage(MessageType.InvokeFunction, {\n        function_id,\n        data: payload,\n        traceparent,\n        baggage,\n        action,\n        metadata,\n      })\n      return undefined as TOutput\n    }\n\n    // Enqueue and default: send invocation_id, await response\n    const invocation_id = crypto.randomUUID()\n    const traceparent = injectTraceparent()\n    const baggage = injectBaggage()\n\n    return new Promise<TOutput>((resolve, reject) => {\n      const timeout = setTimeout(() => {\n        const invocation = this.invocations.get(invocation_id)\n        if (invocation) {\n          this.invocations.delete(invocation_id)\n          reject(\n            new InvocationError({\n              code: 'TIMEOUT',\n              message: `invocation timed out after ${effectiveTimeout}ms`,\n              function_id,\n            }),\n          )\n        }\n      }, effectiveTimeout)\n\n      this.invocations.set(invocation_id, {\n        resolve: (result: TOutput) => {\n          clearTimeout(timeout)\n          resolve(result)\n        },\n        reject: (error: unknown) => {\n          clearTimeout(timeout)\n          reject(error)\n        },\n        function_id,\n        timeout,\n      })\n\n      this.sendMessage(MessageType.InvokeFunction, {\n        invocation_id,\n        function_id,\n        data: payload,\n        traceparent,\n        baggage,\n        action,\n        metadata,\n      })\n    })\n  }\n\n  private registerWorkerMetadata(): void {\n    const telemetryOpts = this.options?.telemetry\n    const language =\n      telemetryOpts?.language ?? Intl.DateTimeFormat().resolvedOptions().locale ?? process.env.LANG?.split('.')[0]\n\n    this.trigger({\n      function_id: EngineFunctions.REGISTER_WORKER,\n      payload: {\n        runtime: 'node',\n        version: SDK_VERSION,\n        name: this.workerName,\n        description: this.workerDescription,\n        os: getOsInfo(),\n        pid: process.pid,\n        isolation: process.env.III_ISOLATION || null,\n        telemetry: {\n          language,\n          project_name: telemetryOpts?.project_name ?? detectProjectName(),\n          framework: telemetryOpts?.framework?.trim() || 'iii-node',\n          amplitude_api_key: telemetryOpts?.amplitude_api_key,\n        },\n      },\n      action: { type: 'void' },\n    })\n  }\n\n  /**\n   * @internal Implementation backing the `createStream` helper in the\n   * `iii-sdk/helpers` submodule. Not part of the public `IIIClient` surface.\n   *\n   * Registers a custom stream implementation, overriding the engine default\n   * for the given stream name. Registers 5 of the 6 `IStream` methods\n   * (`get`, `set`, `delete`, `list`, `listGroups`). The `update` method is\n   * not registered; atomic updates are handled by the engine's built-in\n   * stream update logic.\n   */\n  __helpers_create_stream = <TData>(streamName: string, stream: IStream<TData>): void => {\n    this.registerFunction(`stream::get(${streamName})`, stream.get.bind(stream))\n    this.registerFunction(`stream::set(${streamName})`, stream.set.bind(stream))\n    this.registerFunction(`stream::delete(${streamName})`, stream.delete.bind(stream))\n    this.registerFunction(`stream::list(${streamName})`, stream.list.bind(stream))\n    this.registerFunction(`stream::list_groups(${streamName})`, stream.listGroups.bind(stream))\n  }\n\n  /**\n   * Gracefully shutdown the iii, cleaning up all resources.\n   */\n  shutdown = async (): Promise<void> => {\n    this.isShuttingDown = true\n\n    this.stopMetricsReporting()\n\n    // Shutdown OpenTelemetry\n    await shutdownOtel()\n\n    // Clear reconnection timeout and keepalive heartbeat (shutdown never\n    // reaches onSocketClose: listeners are removed before close() below)\n    this.clearReconnectTimeout()\n    this.stopHeartbeat()\n\n    // Reject all pending invocations\n    for (const [_id, invocation] of this.invocations) {\n      if (invocation.timeout) {\n        clearTimeout(invocation.timeout)\n      }\n      invocation.reject(new Error('iii is shutting down'))\n    }\n    this.invocations.clear()\n\n    // Close WebSocket. Swallow any close-time errors (most commonly\n    // \"WebSocket was closed before the connection was established\",\n    // emitted when `close()` fires while still in CONNECTING state\n    // and there's no error listener). Without a catch-all listener,\n    // that event becomes an unhandled exception because we remove\n    // every listener right above the close call.\n    if (this.ws) {\n      this.ws.removeAllListeners()\n      this.ws.on('error', () => {})\n      try {\n        this.ws.close()\n      } catch {\n        // ignore, shutting down anyway\n      }\n      this.ws = undefined\n    }\n\n    this.setConnectionState('disconnected')\n  }\n\n  // private methods\n\n  private setConnectionState(state: IIIConnectionState): void {\n    if (this.connectionState !== state) {\n      this.connectionState = state\n    }\n  }\n\n  private connect(): void {\n    if (this.isShuttingDown) {\n      return\n    }\n\n    this.setConnectionState('connecting')\n    this.ws = new WebSocket(this.address, {\n      headers: this.options?.headers,\n      handshakeTimeout: WS_HANDSHAKE_TIMEOUT_MS,\n    })\n    this.ws.on('open', this.onSocketOpen.bind(this))\n    this.ws.on('close', this.onSocketClose.bind(this))\n    this.ws.on('error', this.onSocketError.bind(this))\n  }\n\n  private clearReconnectTimeout(): void {\n    if (this.reconnectTimeout) {\n      clearTimeout(this.reconnectTimeout)\n      this.reconnectTimeout = undefined\n    }\n  }\n\n  private startHeartbeat(): void {\n    this.stopHeartbeat()\n    // Dedicated deadline, refresh()ed on every inbound frame, so it fires\n    // exactly WS_IDLE_TIMEOUT_MS after the last frame instead of on the next\n    // ping tick (which could add up to a full WS_PING_INTERVAL_MS of delay).\n    this.idleTimeout = setTimeout(() => {\n      this.logError(`No inbound data for ${WS_IDLE_TIMEOUT_MS}ms, terminating connection to force reconnect`)\n      this.ws?.terminate() // 'close' fires -> onSocketClose stops the heartbeat and schedules reconnect\n    }, WS_IDLE_TIMEOUT_MS)\n    this.heartbeatInterval = setInterval(() => {\n      if (this.ws && this.isOpen()) {\n        this.ws.ping()\n      }\n    }, WS_PING_INTERVAL_MS)\n  }\n\n  private stopHeartbeat(): void {\n    if (this.heartbeatInterval) {\n      clearInterval(this.heartbeatInterval)\n      this.heartbeatInterval = undefined\n    }\n    if (this.idleTimeout) {\n      clearTimeout(this.idleTimeout)\n      this.idleTimeout = undefined\n    }\n  }\n\n  private scheduleReconnect(): void {\n    if (this.isShuttingDown) {\n      return\n    }\n\n    const { maxRetries, initialDelayMs, backoffMultiplier, maxDelayMs, jitterFactor } = this.reconnectionConfig\n\n    if (maxRetries !== -1 && this.reconnectAttempt >= maxRetries) {\n      this.setConnectionState('failed')\n      this.logError(`Max reconnection retries (${maxRetries}) reached, giving up`)\n      return\n    }\n\n    if (this.reconnectTimeout) {\n      return // Already scheduled\n    }\n\n    const exponentialDelay = initialDelayMs * backoffMultiplier ** this.reconnectAttempt\n    const cappedDelay = Math.min(exponentialDelay, maxDelayMs)\n    const jitter = cappedDelay * jitterFactor * (2 * Math.random() - 1)\n    const delay = Math.floor(cappedDelay + jitter)\n\n    this.setConnectionState('reconnecting')\n    console.debug(`[iii] Reconnecting in ${delay}ms (attempt ${this.reconnectAttempt + 1})...`)\n\n    this.reconnectTimeout = setTimeout(() => {\n      this.reconnectTimeout = undefined\n      this.reconnectAttempt++\n      this.connect()\n    }, delay)\n  }\n\n  private onSocketError(error: Error): void {\n    this.logError('WebSocket error', error)\n  }\n\n  private startMetricsReporting(): void {\n    if (!this.metricsReportingEnabled || !this.workerId) {\n      return\n    }\n\n    const meter = getMeter()\n    if (!meter) {\n      console.warn(\n        '[iii] Worker metrics disabled: OpenTelemetry not initialized. Call initOtel() with metricsEnabled: true before creating the iii.',\n      )\n      return\n    }\n\n    registerWorkerGauges(meter, {\n      workerId: this.workerId,\n      workerName: this.workerName,\n    })\n  }\n\n  private stopMetricsReporting(): void {\n    stopWorkerGauges()\n  }\n\n  private onSocketClose(): void {\n    this.stopHeartbeat()\n    this.ws?.removeAllListeners()\n    this.ws?.terminate()\n    this.ws = undefined\n\n    this.setConnectionState('disconnected')\n    this.stopMetricsReporting()\n    this.scheduleReconnect()\n  }\n\n  private onSocketOpen(): void {\n    this.clearReconnectTimeout()\n    this.reconnectAttempt = 0\n    this.setConnectionState('connected')\n\n    this.ws?.on('message', this.onMessage.bind(this))\n\n    // Reset the idle deadline on any inbound frame (message/ping/pong), Rust SDK parity\n    const touch = () => {\n      this.idleTimeout?.refresh()\n    }\n    this.ws?.on('message', touch)\n    this.ws?.on('ping', touch)\n    this.ws?.on('pong', touch)\n    this.startHeartbeat()\n\n    // Reconnect: present the previous engine-assigned identity BEFORE the\n    // registration replay so the engine retires the old connection and the\n    // replay lands on a clean slate instead of racing its cleanup. The\n    // token proves we ARE that worker (ids alone are publicly listable).\n    if (this.workerId) {\n      this.sendMessageRaw(\n        JSON.stringify({\n          type: MessageType.Reattach,\n          previous_worker_id: this.workerId,\n          reattach_token: this.reattachToken,\n        }),\n      )\n    }\n\n    this.triggerTypes.forEach(({ message }) => {\n      this.sendMessage(MessageType.RegisterTriggerType, message, true)\n    })\n    this.functions.forEach(({ message }) => {\n      this.sendMessage(MessageType.RegisterFunction, message, true)\n    })\n    this.triggers.forEach((trigger) => {\n      this.sendMessage(MessageType.RegisterTrigger, trigger, true)\n    })\n\n    // Optimized: swap with empty array instead of splice\n    const pending = this.messagesToSend\n    this.messagesToSend = []\n    for (const message of pending) {\n      if (\n        message.type === MessageType.InvokeFunction &&\n        typeof message.invocation_id === 'string' &&\n        !this.invocations.has(message.invocation_id)\n      ) {\n        continue\n      }\n      this.sendMessageRaw(JSON.stringify(message))\n    }\n\n    this.registerWorkerMetadata()\n  }\n\n  private isOpen(): boolean {\n    return this.ws?.readyState === WebSocket.OPEN\n  }\n\n  private sendMessageRaw(data: string): void {\n    if (this.ws && this.isOpen()) {\n      try {\n        this.ws.send(data, (err) => {\n          if (err) {\n            this.logError('Failed to send message', err)\n          }\n        })\n      } catch (error) {\n        this.logError('Exception while sending message', error)\n      }\n    }\n  }\n\n  private toWireFormat(messageType: MessageType, message: Omit<IIIMessage, 'message_type'>): Record<string, unknown> {\n    const { message_type: _, ...rest } = message as Record<string, unknown>\n    if (messageType === MessageType.RegisterTrigger && 'type' in message) {\n      const { type: triggerType, ...triggerRest } = message as RegisterTriggerMessage\n      return { type: messageType, ...triggerRest, trigger_type: triggerType }\n    }\n    if (messageType === MessageType.UnregisterTrigger && 'type' in message) {\n      const { type: triggerType, ...triggerRest } = message as RegisterTriggerMessage\n      return { type: messageType, ...triggerRest, trigger_type: triggerType }\n    }\n    if (messageType === MessageType.TriggerRegistrationResult && 'type' in message) {\n      const { type: triggerType, ...resultRest } = message as TriggerRegistrationResultMessage\n      return { type: messageType, ...resultRest, trigger_type: triggerType }\n    }\n    return { type: messageType, ...rest } as Record<string, unknown>\n  }\n\n  private sendMessage(messageType: MessageType, message: Omit<IIIMessage, 'message_type'>, skipIfClosed = false): void {\n    const wireMessage = this.toWireFormat(messageType, message)\n    if (this.isOpen()) {\n      this.sendMessageRaw(JSON.stringify(wireMessage))\n    } else if (!skipIfClosed) {\n      this.messagesToSend.push(wireMessage)\n    }\n  }\n\n  private logError(message: string, error?: unknown): void {\n    const otelLogger = getLogger()\n    const errorMessage = error instanceof Error ? error.message : String(error ?? '')\n\n    if (otelLogger) {\n      otelLogger.emit({\n        severityNumber: SeverityNumber.ERROR,\n        body: `[iii] ${message}${errorMessage ? `: ${errorMessage}` : ''}`,\n      })\n    } else {\n      console.error(`[iii] ${message}`, error ?? '')\n    }\n  }\n\n  private onInvocationResult(invocation_id: string, result: unknown, error: unknown): void {\n    const invocation = this.invocations.get(invocation_id)\n\n    if (invocation) {\n      if (invocation.timeout) {\n        clearTimeout(invocation.timeout)\n      }\n      if (error) {\n        invocation.reject(this.toInvocationError(error, invocation.function_id))\n      } else {\n        invocation.resolve(result)\n      }\n    }\n\n    this.invocations.delete(invocation_id)\n  }\n\n  /**\n   * Wrap a wire-format `ErrorBody` in {@link InvocationError} so callers get\n   * a real `Error` with a readable `.message` and a typed `.code`. Pass-through\n   * for values that are already `Error` subclasses. Everything else is wrapped\n   * under an `UNKNOWN` code so `String(err) !== '[object Object]'` holds for\n   * every rejection path.\n   */\n  private toInvocationError(error: unknown, function_id?: string): Error {\n    if (error instanceof Error) {\n      return error\n    }\n    if (isErrorBody(error)) {\n      return new InvocationError({\n        code: error.code,\n        message: error.message,\n        function_id,\n        stacktrace: error.stacktrace,\n      })\n    }\n    // JSON.stringify(undefined) returns undefined (not \"undefined\"), which\n    // would set message to the literal string \"undefined\" after type coercion\n    // and leak an uninformative rejection. Fall back through String(error)\n    // so every path produces a concrete, readable string.\n    const message =\n      typeof error === 'string'\n        ? error\n        : (JSON.stringify(error) ?? String(error))\n    return new InvocationError({\n      code: 'UNKNOWN',\n      message,\n      function_id,\n    })\n  }\n\n  private resolveChannelValue(value: unknown): unknown {\n    if (isChannelRef(value)) {\n      return value.direction === 'read'\n        ? new ChannelReader(this.address, value)\n        : new ChannelWriter(this.address, value)\n    }\n    if (Array.isArray(value)) {\n      return value.map((item) => this.resolveChannelValue(item))\n    }\n    if (value !== null && typeof value === 'object') {\n      const out: Record<string, unknown> = {}\n      for (const [k, v] of Object.entries(value as Record<string, unknown>)) {\n        out[k] = this.resolveChannelValue(v)\n      }\n      return out\n    }\n    return value\n  }\n\n  private async onInvokeFunction<TInput>(\n    invocation_id: string | undefined,\n    function_id: string,\n    input: TInput,\n    metadata?: JsonValue,\n    traceparent?: string,\n    baggage?: string,\n  ): Promise<unknown> {\n    const fn = this.functions.get(function_id)\n    const getResponseTraceparent = () => injectTraceparent() ?? traceparent\n    const getResponseBaggage = () => injectBaggage() ?? baggage\n\n    const resolvedInput = this.resolveChannelValue(input) as TInput\n\n    if (fn?.handler) {\n      if (!invocation_id) {\n        try {\n          await fn.handler(resolvedInput, metadata, traceparent, baggage)\n        } catch (error) {\n          this.logError(`Error invoking function ${function_id}`, error)\n        }\n        return\n      }\n\n      try {\n        const result = await fn.handler(resolvedInput, metadata, traceparent, baggage)\n        this.sendMessage(MessageType.InvocationResult, {\n          invocation_id,\n          function_id,\n          result,\n          traceparent: getResponseTraceparent(),\n          baggage: getResponseBaggage(),\n        })\n      } catch (error) {\n        const isError = error instanceof Error\n        this.sendMessage(MessageType.InvocationResult, {\n          invocation_id,\n          function_id,\n          error: {\n            code: 'invocation_failed',\n            message: isError ? error.message : String(error),\n            stacktrace: isError ? error.stack : undefined,\n          },\n          traceparent: getResponseTraceparent(),\n          baggage: getResponseBaggage(),\n        })\n      }\n    } else {\n      const errorCode = fn ? 'function_not_invokable' : 'function_not_found'\n      const errorMessage = fn ? 'Function is HTTP-invoked and cannot be invoked locally' : 'Function not found'\n      if (invocation_id) {\n        this.sendMessage(MessageType.InvocationResult, {\n          invocation_id,\n          function_id,\n          error: { code: errorCode, message: errorMessage },\n          traceparent,\n          baggage,\n        })\n      }\n    }\n  }\n\n  private async onRegisterTrigger(message: { trigger_type: string; id: string; function_id: string; config: unknown; metadata?: Record<string, unknown> }) {\n    const { trigger_type, id, function_id, config, metadata } = message\n    const triggerTypeData = this.triggerTypes.get(trigger_type)\n\n    if (triggerTypeData) {\n      try {\n        await triggerTypeData.handler.registerTrigger({ id, function_id, config, metadata })\n        this.sendMessage(MessageType.TriggerRegistrationResult, {\n          id,\n          message_type: MessageType.TriggerRegistrationResult,\n          type: trigger_type,\n          function_id,\n        })\n      } catch (error) {\n        this.sendMessage(MessageType.TriggerRegistrationResult, {\n          id,\n          message_type: MessageType.TriggerRegistrationResult,\n          type: trigger_type,\n          function_id,\n          error: { code: 'trigger_registration_failed', message: (error as Error).message },\n        })\n      }\n    } else {\n      this.sendMessage(MessageType.TriggerRegistrationResult, {\n        id,\n        message_type: MessageType.TriggerRegistrationResult,\n        type: trigger_type,\n        function_id,\n        error: { code: 'trigger_type_not_found', message: 'Trigger type not found' },\n      })\n    }\n  }\n\n  private async onUnregisterTrigger(message: {\n    trigger_type?: string\n    id: string\n    function_id?: string\n    config?: unknown\n    metadata?: Record<string, unknown>\n  }) {\n    const trigger_type = message.trigger_type\n    if (!trigger_type) return\n\n    const triggerTypeData = this.triggerTypes.get(trigger_type)\n    if (!triggerTypeData) return\n\n    const { id, function_id = '', config, metadata } = message\n    try {\n      await triggerTypeData.handler.unregisterTrigger({ id, function_id, config, metadata })\n    } catch (error) {\n      this.logError(`Error unregistering trigger ${id}`, error)\n    }\n  }\n\n  private onTriggerRegistrationResult(\n    message: { id: string; trigger_type?: string; type?: string; function_id: string; error?: { code: string; message: string; stacktrace?: string } },\n  ): void {\n    if (!message.error) return\n    const triggerType = message.trigger_type ?? message.type ?? ''\n    console.error(\n      `[iii] Trigger registration failed for \"${message.id}\" (${triggerType}): ${message.error.message}`,\n    )\n  }\n\n  private onMessage(socketMessage: Data): void {\n    let msgType: MessageType\n    let message: Record<string, unknown>\n\n    try {\n      const parsed = JSON.parse(socketMessage.toString()) as Record<string, unknown>\n      msgType = parsed.type as MessageType\n      const { type: _, ...rest } = parsed\n      message = rest\n    } catch (error) {\n      this.logError('Failed to parse incoming message', error)\n      return\n    }\n\n    if (msgType === MessageType.InvocationResult) {\n      const { invocation_id, result, error } = message as InvocationResultMessage\n      this.onInvocationResult(invocation_id, result, error)\n    } else if (msgType === MessageType.InvokeFunction) {\n      const { invocation_id, function_id, data, metadata, traceparent, baggage } = message as InvokeFunctionMessage\n      this.onInvokeFunction(invocation_id, function_id, data, metadata, traceparent, baggage)\n    } else if (msgType === MessageType.RegisterTrigger) {\n      this.onRegisterTrigger(message as { trigger_type: string; id: string; function_id: string; config: unknown; metadata?: Record<string, unknown> })\n    } else if (msgType === MessageType.UnregisterTrigger) {\n      this.onUnregisterTrigger(\n        message as {\n          trigger_type?: string\n          id: string\n          function_id?: string\n          config?: unknown\n          metadata?: Record<string, unknown>\n        },\n      )\n    } else if (msgType === MessageType.TriggerRegistrationResult) {\n      this.onTriggerRegistrationResult(\n        message as { id: string; trigger_type?: string; type?: string; function_id: string; error?: { code: string; message: string; stacktrace?: string } },\n      )\n    } else if (msgType === MessageType.WorkerRegistered) {\n      const { worker_id, reattach_token } = message as WorkerRegisteredMessage\n      this.workerId = worker_id\n      this.reattachToken = reattach_token\n      console.debug('[iii] Worker registered with ID:', worker_id)\n      this.startMetricsReporting()\n    }\n  }\n}\n\n/**\n * Factory object that constructs routing actions for {@link IIIClient.trigger}.\n *\n * @example\n * ```typescript\n * import { TriggerAction } from 'iii-sdk'\n *\n * // Enqueue to a named queue\n * worker.trigger({\n *   function_id: 'process',\n *   payload: { data: 'hello' },\n *   action: TriggerAction.Enqueue({ queue: 'jobs' }),\n * })\n *\n * // Fire-and-forget\n * worker.trigger({\n *   function_id: 'notify',\n *   payload: {},\n *   action: TriggerAction.Void(),\n * })\n * ```\n */\nexport const TriggerAction = {\n  /**\n   * Routes the invocation through a named queue. The engine enqueues the job,\n   * acknowledges the caller with `{ messageReceiptId }`, and processes it\n   * asynchronously.\n   *\n   * Requires a queue worker in the project. Run `iii worker add queue`.\n   * Without it the trigger rejects with `enqueue_error` (no queue provider).\n   *\n   * @param opts - Queue routing options.\n   * @param opts.queue - Name of the target queue.\n   */\n  Enqueue: (opts: { queue: string }) => ({ type: 'enqueue' as const, ...opts }),\n  /**\n   * Fire-and-forget routing. The engine forwards the invocation without\n   * waiting for a response or queuing the job.\n   */\n  Void: () => ({ type: 'void' as const }),\n} as const\n\n/**\n * Register the worker with a iii instance, returns a connected worker client.\n * The WebSocket connection is established automatically.\n *\n * @param address - WebSocket URL of the III engine (e.g. `ws://localhost:49134`).\n * @param options - Optional {@link InitOptions} for worker name, timeouts, reconnection, and OTel.\n * @returns A connected {@link IIIClient} instance.\n *\n * @example\n * ```typescript\n * import { registerWorker } from 'iii-sdk'\n *\n * const worker = registerWorker(process.env.III_URL ?? 'ws://localhost:49134', {\n *   workerName: 'my-worker',\n * })\n * ```\n */\nexport const registerWorker = (address: string, options?: InitOptions): IIIClient => new Sdk(address, options)\n"],"mappings":"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"}
+{"version":3,"file":"index.cjs","names":["os","MessageType","context","SpanKind","trace","ChannelWriter","ChannelReader","InvocationError","DEFAULT_BRIDGE_RECONNECTION_CONFIG","EngineFunctions","detectProjectName","WebSocket","WS_HANDSHAKE_TIMEOUT_MS","WS_IDLE_TIMEOUT_MS","WS_PING_INTERVAL_MS","SeverityNumber","RegistrationRejectedError","isErrorBody","isChannelRef"],"sources":["../src/iii.ts"],"sourcesContent":["import { context, trace } from '@opentelemetry/api'\nimport { createRequire } from 'node:module'\nimport * as os from 'node:os'\nimport { type Data, WebSocket } from 'ws'\nimport { ChannelReader, ChannelWriter } from './channels'\nimport { InvocationError, isErrorBody, RegistrationRejectedError } from './errors'\nimport {\n  DEFAULT_BRIDGE_RECONNECTION_CONFIG,\n  DEFAULT_INVOCATION_TIMEOUT_MS,\n  EngineFunctions,\n  type IIIConnectionState,\n  type IIIReconnectionConfig,\n  WS_HANDSHAKE_TIMEOUT_MS,\n  WS_IDLE_TIMEOUT_MS,\n  WS_PING_INTERVAL_MS,\n} from './iii-constants'\nimport type { HttpInvocationConfig } from '@iii-dev/helpers/http'\nimport {\n  type IIIMessage,\n  type InvocationResultMessage,\n  type InvokeFunctionMessage,\n  type JsonValue,\n  MessageType,\n  type RegisterFunctionMessage,\n  type RegistrationRejectedMessage,\n  type RegisterTriggerMessage,\n  type RegisterTriggerTypeMessage,\n  type StreamChannelRef,\n  type TriggerRegistrationResultMessage,\n  type TriggerRequest,\n  type WorkerRegisteredMessage,\n} from './iii-types'\nimport { registerWorkerGauges, stopWorkerGauges } from '@iii-dev/helpers/observability'\nimport { getMeter, getTracer } from '@iii-dev/helpers/observability/internal'\nimport { SpanKind } from '@opentelemetry/api'\nimport type { IStream } from './stream'\nimport { detectProjectName } from './utils'\nimport {\n  extractContext,\n  getLogger,\n  initOtel,\n  injectBaggage,\n  injectTraceparent,\n  type OtelConfig,\n  recordSpanEvent,\n  redactAndTruncate,\n  resolveMaxBytesFromEnv,\n  SeverityNumber,\n  shutdownOtel,\n  withSpan,\n} from '@iii-dev/helpers/observability'\nimport type { TriggerHandler } from './triggers'\nimport type {\n  FunctionRef,\n  IIIClient,\n  Invocation,\n  RegisterFunctionOptions,\n  RemoteFunctionData,\n  RemoteFunctionHandler,\n  RemoteTriggerTypeData,\n  Trigger,\n  TriggerTypeRef,\n} from './types'\nimport { isChannelRef } from './utils'\n\nconst require = createRequire(import.meta.url)\nconst { version: SDK_VERSION } = require('../package.json')\n\n/**\n * `registrationrejected` code (engine `protocol.rs`): another live worker\n * already holds this `(namespace, worker_name)`. The engine closes the\n * connection -- fatal.\n */\nconst WORKER_NAMESPACE_CONFLICT = 'WORKER_NAMESPACE_CONFLICT'\n\n/**\n * `registrationrejected` code (engine `protocol.rs`): another live worker in\n * this namespace already exports this one function id. The connection stays\n * open -- non-fatal.\n */\nconst FUNCTION_NAMESPACE_CONFLICT = 'FUNCTION_NAMESPACE_CONFLICT'\n\nfunction getOsInfo(): string {\n  return `${os.platform()} ${os.release()} (${os.arch()})`\n}\n\nfunction getDefaultWorkerName(): string {\n  // III_WORKER_NAME carries the config.yaml entry name for managed workers\n  // (set by iii-worker at spawn). Engine truth (`iii worker status`/`list`)\n  // matches connections by name, so the managed identity must win over the\n  // hostname:pid fallback.\n  const managedName = process.env.III_WORKER_NAME\n  if (managedName) {\n    return managedName\n  }\n  return `${os.hostname()}:${process.pid}`\n}\n\n/**\n * Engine address used when neither an explicit address nor `III_URL` is set.\n * The IPv4 loopback is spelled out on purpose: `localhost` can resolve to `::1`\n * on a host whose engine only listens on IPv4.\n */\nexport const DEFAULT_ENGINE_URL = 'ws://127.0.0.1:49134'\n\nfunction resolveAddress(address?: string): string {\n  // The supervisor that spawned this process -- `iii compose`, a container\n  // runtime, systemd -- sets III_URL, the same way it sets III_NAMESPACE and\n  // III_WORKER_NAME. An explicit address still wins.\n  if (address) {\n    return address\n  }\n  const fromEnv = process.env.III_URL\n  if (fromEnv) {\n    return fromEnv\n  }\n  return DEFAULT_ENGINE_URL\n}\n\nfunction resolveNamespace(optionNamespace?: string): string | undefined {\n  // III_NAMESPACE carries the namespace for managed workers (set by iii-worker\n  // at spawn), mirroring III_WORKER_NAME. An explicit option wins; otherwise\n  // the env var provides the managed identity. Absent in both means undefined\n  // -- the engine applies its `default` namespace when none is on the wire.\n  if (optionNamespace) {\n    return optionNamespace\n  }\n  const managedNamespace = process.env.III_NAMESPACE\n  if (managedNamespace) {\n    return managedNamespace\n  }\n  return undefined\n}\n\n/** Worker metadata reported to the engine (language, framework, project). */\nexport type TelemetryOptions = {\n  /** Programming language of the worker. */\n  language?: string\n  /** Name of the project this worker belongs to. */\n  project_name?: string\n  /** Framework name, if applicable. */\n  framework?: string\n  /** Amplitude API key for product analytics. */\n  amplitude_api_key?: string\n}\n\n/**\n * Configuration options passed to {@link registerWorker}.\n *\n * @example\n * ```typescript\n * const worker = registerWorker('ws://localhost:49134', {\n *   workerName: 'my-worker',\n *   invocationTimeoutMs: 10000,\n *   reconnectionConfig: { maxRetries: 5 },\n * })\n * ```\n */\nexport type InitOptions = {\n  /** Display name for this worker. Defaults to `hostname:pid`. */\n  workerName?: string\n  /**\n   * Namespace this worker registers under. Resolution order:\n   * `options.namespace` -> `process.env.III_NAMESPACE` -> undefined. When\n   * undefined the engine applies its `default` namespace. Scopes worker and\n   * function registrations so identically-named entries can coexist across\n   * namespaces.\n   */\n  namespace?: string\n  /**\n   * One-line, human/LLM-readable summary of what this worker does.\n   * Surfaces in `engine::workers::list` / `engine::workers::info`.\n   */\n  workerDescription?: string\n  /** Enable worker metrics via OpenTelemetry. Defaults to `true`. */\n  enableMetricsReporting?: boolean\n  /** Default timeout for `worker.trigger()` invocations in milliseconds. Defaults to `30000`. */\n  invocationTimeoutMs?: number\n  /**\n   * WebSocket reconnection behavior.\n   *\n   * @see {@link IIIReconnectionConfig} for available fields and defaults.\n   */\n  reconnectionConfig?: Partial<IIIReconnectionConfig>\n  /**\n   * OpenTelemetry configuration. OTel is initialized automatically by default.\n   * Set `{ enabled: false }` or env `OTEL_ENABLED=false/0/no/off` to disable.\n   * The `engineWsUrl` is set automatically from the III address.\n   */\n  otel?: Omit<OtelConfig, 'engineWsUrl'>\n  /** Custom HTTP headers sent during the WebSocket handshake. */\n  headers?: Record<string, string>\n  /** @internal */\n  telemetry?: TelemetryOptions\n}\n\nclass Sdk implements IIIClient {\n  private ws?: WebSocket\n  private functions = new Map<string, RemoteFunctionData>()\n  private invocations = new Map<string, Invocation & { timeout?: NodeJS.Timeout }>()\n  private triggers = new Map<string, RegisterTriggerMessage>()\n  private triggerTypes = new Map<string, RemoteTriggerTypeData>()\n  private messagesToSend: Record<string, unknown>[] = []\n  private workerName: string\n  private namespace?: string\n  private workerDescription?: string\n  private workerId?: string\n  private reattachToken?: string\n  private reconnectTimeout?: NodeJS.Timeout\n  private heartbeatInterval?: NodeJS.Timeout\n  private idleTimeout?: NodeJS.Timeout\n  private metricsReportingEnabled: boolean\n  private invocationTimeoutMs: number\n  private reconnectionConfig: IIIReconnectionConfig\n  private reconnectAttempt = 0\n  private connectionState: IIIConnectionState = 'disconnected'\n  private isShuttingDown = false\n  // Set when the engine fatally rejects this worker's registration (e.g. a\n  // namespace/name collision). Terminal: no reconnect follows. Mirrors the\n  // Python (`_fatal_error`) and Rust (`fatal_error()`) SDKs.\n  private fatalError?: RegistrationRejectedError\n\n  constructor(\n    private readonly address: string,\n    private readonly options?: InitOptions,\n  ) {\n    this.workerName = options?.workerName ?? getDefaultWorkerName()\n    this.namespace = resolveNamespace(options?.namespace)\n    this.workerDescription = options?.workerDescription\n    this.metricsReportingEnabled = options?.enableMetricsReporting ?? true\n    this.invocationTimeoutMs = options?.invocationTimeoutMs ?? DEFAULT_INVOCATION_TIMEOUT_MS\n    this.reconnectionConfig = {\n      ...DEFAULT_BRIDGE_RECONNECTION_CONFIG,\n      ...options?.reconnectionConfig,\n    }\n\n    // Initialize OpenTelemetry (enabled by default, opt-out via config or env)\n    initOtel({ ...options?.otel, engineWsUrl: this.address })\n\n    this.connect()\n  }\n\n  /**\n   * Registers a custom trigger type with the engine. A trigger type defines\n   * how external events (HTTP, cron, queue, etc.) map to function invocations.\n   *\n   * @param triggerType - Trigger type registration input.\n   * @param triggerType.id - Unique trigger type identifier.\n   * @param triggerType.description - Human-readable description.\n   * @param handler - Handler with `registerTrigger` / `unregisterTrigger` callbacks.\n   *\n   * @example\n   * ```typescript\n   * worker.registerTriggerType(\n   *   { id: 'my-trigger', description: 'Custom trigger' },\n   *   {\n   *     async registerTrigger({ id, function_id, config }) { },\n   *     async unregisterTrigger({ id, function_id, config }) { },\n   *   },\n   * )\n   * ```\n   */\n  registerTriggerType = <TConfig>(\n    triggerType: Omit<RegisterTriggerTypeMessage, 'message_type'>,\n    handler: TriggerHandler<TConfig>,\n  ): TriggerTypeRef<TConfig> => {\n    this.sendMessage(MessageType.RegisterTriggerType, triggerType, true)\n    this.triggerTypes.set(triggerType.id, {\n      message: { ...triggerType, message_type: MessageType.RegisterTriggerType },\n      handler,\n    })\n\n    return {\n      id: triggerType.id,\n      // This typed helper pairs a function with its trigger, so it defaults the\n      // trigger's namespace to this worker's — otherwise the function would land\n      // in the worker's namespace and the trigger in `default`, and never resolve\n      // it. The low-level `registerTrigger` keeps the engine default (`default`).\n      registerTrigger: (functionId: string, config: TConfig, metadata?: Record<string, unknown>) => {\n        return this.registerTrigger({\n          type: triggerType.id,\n          function_id: functionId,\n          config,\n          metadata,\n          namespace: this.namespace,\n        })\n      },\n      registerFunction: (functionId, handler, config, metadata?) => {\n        const ref = this.registerFunction(functionId, handler)\n        this.registerTrigger({\n          type: triggerType.id,\n          function_id: functionId,\n          config,\n          metadata,\n          namespace: this.namespace,\n        })\n        return ref\n      },\n      unregister: () => {\n        this.unregisterTriggerType(triggerType)\n      },\n    }\n  }\n\n  /**\n   * Unregisters a previously registered trigger type.\n   *\n   * @param triggerType - The trigger type to unregister (must match the `id` used during registration).\n   */\n  unregisterTriggerType = (triggerType: Omit<RegisterTriggerTypeMessage, 'message_type'>): void => {\n    this.sendMessage(MessageType.UnregisterTriggerType, triggerType, true)\n    this.triggerTypes.delete(triggerType.id)\n  }\n\n  /**\n   * Binds a trigger configuration to a registered function. When the trigger\n   * fires, the engine invokes the target function.\n   *\n   * @param trigger - Trigger registration input.\n   * @param trigger.type - Trigger type (e.g. `http`, `durable:subscriber`, `cron`).\n   * @param trigger.function_id - ID of the function to invoke.\n   * @param trigger.config - Trigger-specific configuration.\n   * @returns A {@link Trigger} handle with an `unregister()` method.\n   *\n   * @example\n   * ```typescript\n   * const trigger = worker.registerTrigger({\n   *   type: 'http',\n   *   function_id: 'greet',\n   *   config: { api_path: '/greet', http_method: 'GET' },\n   * })\n   *\n   * // Later...\n   * trigger.unregister()\n   * ```\n   */\n  registerTrigger = (trigger: Omit<RegisterTriggerMessage, 'message_type' | 'id'>): Trigger => {\n    const id = crypto.randomUUID()\n    const fullTrigger: RegisterTriggerMessage = {\n      ...trigger,\n      id,\n      message_type: MessageType.RegisterTrigger,\n    }\n    this.sendMessage(MessageType.RegisterTrigger, fullTrigger, true)\n    this.triggers.set(id, fullTrigger)\n\n    return {\n      unregister: () => {\n        this.sendMessage(MessageType.UnregisterTrigger, {\n          id,\n          message_type: MessageType.UnregisterTrigger,\n          type: fullTrigger.type,\n        })\n        this.triggers.delete(id)\n      },\n    }\n  }\n\n  /**\n   * Registers a function with the engine. The `functionId` is the unique identifier\n   * used by triggers and invocations.\n   *\n   * Pass a handler for local execution, or an {@link HttpInvocationConfig}\n   * for HTTP-invoked functions (Lambda, Cloudflare Workers, etc.).\n   *\n   * @param functionId - Unique function identifier.\n   * @param handlerOrInvocation - Async handler or HTTP invocation config.\n   * @param options - Optional function registration options (description, request/response formats, metadata).\n   * @returns A {@link FunctionRef} with `id` and `unregister()`.\n   *\n   * @example\n   * ```typescript\n   * const fn = worker.registerFunction(\n   *   'greet',\n   *   async (input: { name: string }) => {\n   *     return { message: `Hello, ${input.name}!` }\n   *   },\n   *   { description: 'Greets a user' },\n   * )\n   * ```\n   */\n  registerFunction = (\n    functionId: string,\n    handlerOrInvocation: RemoteFunctionHandler | HttpInvocationConfig,\n    options?: RegisterFunctionOptions,\n  ): FunctionRef => {\n    if (!functionId || functionId.trim() === '') {\n      throw new Error('id is required')\n    }\n    if (this.functions.has(functionId)) {\n      throw new Error(`function id already registered: ${functionId}`)\n    }\n\n    const isHandler = typeof handlerOrInvocation === 'function'\n\n    const fullMessage: RegisterFunctionMessage = isHandler\n      ? { ...options, id: functionId, message_type: MessageType.RegisterFunction }\n      : {\n          ...options,\n          id: functionId,\n          message_type: MessageType.RegisterFunction,\n          invocation: {\n            url: handlerOrInvocation.url,\n            method: handlerOrInvocation.method ?? 'POST',\n            timeout_ms: handlerOrInvocation.timeout_ms,\n            headers: handlerOrInvocation.headers,\n            auth: handlerOrInvocation.auth,\n          },\n        }\n\n    this.sendMessage(MessageType.RegisterFunction, fullMessage, true)\n\n    if (isHandler) {\n      const handler = handlerOrInvocation as RemoteFunctionHandler\n      this.functions.set(functionId, {\n        message: fullMessage,\n        handler: async (input, metadata?: JsonValue, traceparent?: string, baggage?: string) => {\n          const tracePayloads = !(\n            process.env.III_DISABLE_TRACE_PAYLOADS === '1' ||\n            process.env.III_DISABLE_TRACE_PAYLOADS?.toLowerCase() === 'true'\n          )\n          const payloadMaxBytes = resolveMaxBytesFromEnv()\n\n          const runHandler = async () => {\n            if (tracePayloads) {\n              const { json, truncated } = redactAndTruncate(input, payloadMaxBytes)\n              recordSpanEvent('iii.invocation.input', {\n                'iii.payload.json': json,\n                'iii.payload.truncated': truncated,\n              })\n            }\n            try {\n              const result = await handler(input, metadata)\n              if (tracePayloads) {\n                const { json, truncated } = redactAndTruncate(result, payloadMaxBytes)\n                recordSpanEvent('iii.invocation.output', {\n                  'iii.payload.json': json,\n                  'iii.payload.truncated': truncated,\n                  'iii.payload.ok': true,\n                })\n              }\n              return result\n            } catch (err) {\n              if (tracePayloads) {\n                const errMsg = err instanceof Error ? err.message : String(err)\n                const { json, truncated } = redactAndTruncate(\n                  { error: errMsg },\n                  payloadMaxBytes,\n                )\n                recordSpanEvent('iii.invocation.output', {\n                  'iii.payload.json': json,\n                  'iii.payload.truncated': truncated,\n                  'iii.payload.ok': false,\n                })\n              }\n              throw err\n            }\n          }\n\n          if (getTracer()) {\n            const parentContext = extractContext(traceparent, baggage)\n\n            // INTERNAL and named `execute` (not `call`/`trigger`): the engine\n            // suppresses its own `call <fn>` span for worker-routed functions\n            // (this span is the canonical one for the invocation) but still\n            // emits engine-side wrappers like `trigger <fn>` from fire_triggers\n            // and `call <fn>` for builtins. Reusing those names would read as\n            // duplicate engine spans under the worker's service. `execute` is\n            // unique, so the worker handler span reads as a clean internal\n            // child (and is collapsible by a single rule).\n            return context.with(parentContext, () =>\n              withSpan(`execute ${functionId}`, { kind: SpanKind.INTERNAL }, async () => await runHandler()),\n            )\n          }\n\n          const traceId = crypto.randomUUID().replace(/-/g, '')\n          const spanId = crypto.randomUUID().replace(/-/g, '').slice(0, 16)\n          const syntheticSpan = trace.wrapSpanContext({ traceId, spanId, traceFlags: 1 })\n\n          return context.with(trace.setSpan(context.active(), syntheticSpan), async () => await runHandler())\n        },\n      })\n    } else {\n      this.functions.set(functionId, { message: fullMessage })\n    }\n\n    return {\n      id: functionId,\n      unregister: () => {\n        this.sendMessage(MessageType.UnregisterFunction, { id: functionId }, true)\n        this.functions.delete(functionId)\n      },\n    }\n  }\n\n  /**\n   * @internal Implementation backing the `createChannel` helper in the\n   * `iii-sdk/helpers` submodule. Not part of the public `IIIClient` surface.\n   *\n   * Creates a streaming channel pair for worker-to-worker data transfer.\n   * Returns a {@link Channel} with a local writer/reader and serializable refs\n   * that can be passed as fields in invocation data to other functions.\n   */\n  __helpers_create_channel = async (bufferSize?: number): Promise<import('./types').Channel> => {\n    const result = await this.trigger<{ buffer_size?: number }, { writer: StreamChannelRef; reader: StreamChannelRef }>(\n      { function_id: 'engine::channels::create', payload: { buffer_size: bufferSize } },\n    )\n\n    return {\n      writer: new ChannelWriter(this.address, result.writer),\n      reader: new ChannelReader(this.address, result.reader),\n      writerRef: result.writer,\n      readerRef: result.reader,\n    }\n  }\n\n  /**\n   * Invokes a remote function. The routing behavior and return type depend\n   * on the `action` field of the request.\n   *\n   * | `action`                      | Behavior                                           | Return type              |\n   * |-------------------------------|----------------------------------------------------|-----------------------   |\n   * | _(none)_                      | Synchronous: waits for the function to return     | `Promise<TOutput>`       |\n   * | `TriggerAction.Enqueue(...)` | Async via named queue; engine acknowledges enqueue | `Promise<EnqueueResult>` |\n   * | `TriggerAction.Void()`       | Fire-and-forget, no response                      | `Promise<undefined>`     |\n   *\n   * @param request - The trigger request.\n   * @param request.function_id - ID of the function to invoke.\n   * @param request.payload - Payload to pass to the function.\n   * @param request.action - Routing action. Omit for synchronous request/response.\n   * @param request.timeoutMs - Override the default invocation timeout.\n   * @param request.metadata - Optional per-invocation metadata (arbitrary JSON)\n   *   surfaced to the target handler as its second argument.\n   * @returns The result of the function invocation.\n   *\n   * @example\n   * ```typescript\n   * import { TriggerAction } from 'iii-sdk'\n   *\n   * // Synchronous\n   * const result = await worker.trigger({ function_id: 'get-order', payload: { id: '123' } })\n   *\n   * // Enqueue\n   * const { messageReceiptId } = await worker.trigger({\n   *   function_id: 'payments::charge',\n   *   payload: { orderId: '123', amount: 49.99 },\n   *   action: TriggerAction.Enqueue({ queue: 'payment' }),\n   * })\n   *\n   * // Fire-and-forget\n   * worker.trigger({\n   *   function_id: 'notifications::send',\n   *   payload: { userId: '123' },\n   *   action: TriggerAction.Void(),\n   * })\n   * ```\n   */\n  // biome-ignore lint/suspicious/noExplicitAny: TOutput defaults to any so untyped calls type-check (the engine cannot express the return type statically)\n  trigger = async <TInput = unknown, TOutput = any>(\n    request: TriggerRequest<TInput>,\n  ): Promise<TOutput> => {\n    const { function_id, payload, action, timeoutMs, metadata, namespace } = request\n    const effectiveTimeout = timeoutMs ?? this.invocationTimeoutMs\n\n    // Void is fire-and-forget, no invocation_id, no response\n    if (action?.type === 'void') {\n      const traceparent = injectTraceparent()\n      const baggage = injectBaggage()\n      this.sendMessage(MessageType.InvokeFunction, {\n        function_id,\n        data: payload,\n        traceparent,\n        baggage,\n        action,\n        metadata,\n        // Omit when absent so the engine routes within its default namespace.\n        ...(namespace !== undefined ? { namespace } : {}),\n      })\n      return undefined as TOutput\n    }\n\n    // Enqueue and default: send invocation_id, await response\n    const invocation_id = crypto.randomUUID()\n    const traceparent = injectTraceparent()\n    const baggage = injectBaggage()\n\n    return new Promise<TOutput>((resolve, reject) => {\n      const timeout = setTimeout(() => {\n        const invocation = this.invocations.get(invocation_id)\n        if (invocation) {\n          this.invocations.delete(invocation_id)\n          reject(\n            new InvocationError({\n              code: 'TIMEOUT',\n              message: `invocation timed out after ${effectiveTimeout}ms`,\n              function_id,\n            }),\n          )\n        }\n      }, effectiveTimeout)\n\n      this.invocations.set(invocation_id, {\n        resolve: (result: TOutput) => {\n          clearTimeout(timeout)\n          resolve(result)\n        },\n        reject: (error: unknown) => {\n          clearTimeout(timeout)\n          reject(error)\n        },\n        function_id,\n        timeout,\n      })\n\n      this.sendMessage(MessageType.InvokeFunction, {\n        invocation_id,\n        function_id,\n        data: payload,\n        traceparent,\n        baggage,\n        action,\n        metadata,\n        // Omit when absent so the engine routes within its default namespace.\n        ...(namespace !== undefined ? { namespace } : {}),\n      })\n    })\n  }\n\n  private registerWorkerMetadata(): void {\n    const telemetryOpts = this.options?.telemetry\n    const language =\n      telemetryOpts?.language ?? Intl.DateTimeFormat().resolvedOptions().locale ?? process.env.LANG?.split('.')[0]\n\n    this.trigger({\n      function_id: EngineFunctions.REGISTER_WORKER,\n      payload: {\n        runtime: 'node',\n        version: SDK_VERSION,\n        name: this.workerName,\n        description: this.workerDescription,\n        os: getOsInfo(),\n        pid: process.pid,\n        isolation: process.env.III_ISOLATION || null,\n        // Omit when absent so the engine falls back to its `default` namespace.\n        ...(this.namespace !== undefined ? { namespace: this.namespace } : {}),\n        telemetry: {\n          language,\n          project_name: telemetryOpts?.project_name ?? detectProjectName(),\n          framework: telemetryOpts?.framework?.trim() || 'iii-node',\n          amplitude_api_key: telemetryOpts?.amplitude_api_key,\n        },\n      },\n      action: { type: 'void' },\n    })\n  }\n\n  /**\n   * @internal Implementation backing the `createStream` helper in the\n   * `iii-sdk/helpers` submodule. Not part of the public `IIIClient` surface.\n   *\n   * Registers a custom stream implementation, overriding the engine default\n   * for the given stream name. Registers 5 of the 6 `IStream` methods\n   * (`get`, `set`, `delete`, `list`, `listGroups`). The `update` method is\n   * not registered; atomic updates are handled by the engine's built-in\n   * stream update logic.\n   */\n  __helpers_create_stream = <TData>(streamName: string, stream: IStream<TData>): void => {\n    this.registerFunction(`stream::get(${streamName})`, stream.get.bind(stream))\n    this.registerFunction(`stream::set(${streamName})`, stream.set.bind(stream))\n    this.registerFunction(`stream::delete(${streamName})`, stream.delete.bind(stream))\n    this.registerFunction(`stream::list(${streamName})`, stream.list.bind(stream))\n    this.registerFunction(`stream::list_groups(${streamName})`, stream.listGroups.bind(stream))\n  }\n\n  /**\n   * The current WebSocket connection state. `'failed'` is terminal — it follows\n   * a fatal registration rejection (see {@link getFatalError}). Mirrors the\n   * Python/Rust SDKs' `get_connection_state()`.\n   */\n  getConnectionState = (): IIIConnectionState => this.connectionState\n\n  /**\n   * Engine address this worker resolved to: the explicit argument, else\n   * `III_URL`, else {@link DEFAULT_ENGINE_URL}. Mirrors the Rust SDK's\n   * `address()` and the Python SDK's `get_address()`.\n   */\n  getAddress = (): string => this.address\n\n  /**\n   * The fatal registration rejection that terminated this connection, if any\n   * (e.g. a `WORKER_NAMESPACE_CONFLICT`). `undefined` while healthy. Mirrors the\n   * Python (`_fatal_error`) and Rust (`fatal_error()`) SDKs.\n   */\n  getFatalError = (): RegistrationRejectedError | undefined => this.fatalError\n\n  /**\n   * Gracefully shutdown the iii, cleaning up all resources.\n   */\n  shutdown = async (): Promise<void> => {\n    this.isShuttingDown = true\n\n    this.stopMetricsReporting()\n\n    // Shutdown OpenTelemetry\n    await shutdownOtel()\n\n    // Clear reconnection timeout and keepalive heartbeat (shutdown never\n    // reaches onSocketClose: listeners are removed before close() below)\n    this.clearReconnectTimeout()\n    this.stopHeartbeat()\n\n    // Reject all pending invocations\n    for (const [_id, invocation] of this.invocations) {\n      if (invocation.timeout) {\n        clearTimeout(invocation.timeout)\n      }\n      invocation.reject(new Error('iii is shutting down'))\n    }\n    this.invocations.clear()\n\n    // Close WebSocket. Swallow any close-time errors (most commonly\n    // \"WebSocket was closed before the connection was established\",\n    // emitted when `close()` fires while still in CONNECTING state\n    // and there's no error listener). Without a catch-all listener,\n    // that event becomes an unhandled exception because we remove\n    // every listener right above the close call.\n    if (this.ws) {\n      this.ws.removeAllListeners()\n      this.ws.on('error', () => {})\n      try {\n        this.ws.close()\n      } catch {\n        // ignore, shutting down anyway\n      }\n      this.ws = undefined\n    }\n\n    this.setConnectionState('disconnected')\n  }\n\n  // private methods\n\n  private setConnectionState(state: IIIConnectionState): void {\n    if (this.connectionState !== state) {\n      this.connectionState = state\n    }\n  }\n\n  private connect(): void {\n    if (this.isShuttingDown) {\n      return\n    }\n\n    this.setConnectionState('connecting')\n    this.ws = new WebSocket(this.address, {\n      headers: this.options?.headers,\n      handshakeTimeout: WS_HANDSHAKE_TIMEOUT_MS,\n    })\n    this.ws.on('open', this.onSocketOpen.bind(this))\n    this.ws.on('close', this.onSocketClose.bind(this))\n    this.ws.on('error', this.onSocketError.bind(this))\n  }\n\n  private clearReconnectTimeout(): void {\n    if (this.reconnectTimeout) {\n      clearTimeout(this.reconnectTimeout)\n      this.reconnectTimeout = undefined\n    }\n  }\n\n  private startHeartbeat(): void {\n    this.stopHeartbeat()\n    // Dedicated deadline, refresh()ed on every inbound frame, so it fires\n    // exactly WS_IDLE_TIMEOUT_MS after the last frame instead of on the next\n    // ping tick (which could add up to a full WS_PING_INTERVAL_MS of delay).\n    this.idleTimeout = setTimeout(() => {\n      this.logError(`No inbound data for ${WS_IDLE_TIMEOUT_MS}ms, terminating connection to force reconnect`)\n      this.ws?.terminate() // 'close' fires -> onSocketClose stops the heartbeat and schedules reconnect\n    }, WS_IDLE_TIMEOUT_MS)\n    this.heartbeatInterval = setInterval(() => {\n      if (this.ws && this.isOpen()) {\n        this.ws.ping()\n      }\n    }, WS_PING_INTERVAL_MS)\n  }\n\n  private stopHeartbeat(): void {\n    if (this.heartbeatInterval) {\n      clearInterval(this.heartbeatInterval)\n      this.heartbeatInterval = undefined\n    }\n    if (this.idleTimeout) {\n      clearTimeout(this.idleTimeout)\n      this.idleTimeout = undefined\n    }\n  }\n\n  private scheduleReconnect(): void {\n    if (this.isShuttingDown) {\n      return\n    }\n\n    const { maxRetries, initialDelayMs, backoffMultiplier, maxDelayMs, jitterFactor } = this.reconnectionConfig\n\n    if (maxRetries !== -1 && this.reconnectAttempt >= maxRetries) {\n      this.setConnectionState('failed')\n      this.logError(`Max reconnection retries (${maxRetries}) reached, giving up`)\n      return\n    }\n\n    if (this.reconnectTimeout) {\n      return // Already scheduled\n    }\n\n    const exponentialDelay = initialDelayMs * backoffMultiplier ** this.reconnectAttempt\n    const cappedDelay = Math.min(exponentialDelay, maxDelayMs)\n    const jitter = cappedDelay * jitterFactor * (2 * Math.random() - 1)\n    const delay = Math.floor(cappedDelay + jitter)\n\n    this.setConnectionState('reconnecting')\n    console.debug(`[iii] Reconnecting in ${delay}ms (attempt ${this.reconnectAttempt + 1})...`)\n\n    this.reconnectTimeout = setTimeout(() => {\n      this.reconnectTimeout = undefined\n      this.reconnectAttempt++\n      this.connect()\n    }, delay)\n  }\n\n  private onSocketError(error: Error): void {\n    this.logError('WebSocket error', error)\n  }\n\n  private startMetricsReporting(): void {\n    if (!this.metricsReportingEnabled || !this.workerId) {\n      return\n    }\n\n    const meter = getMeter()\n    if (!meter) {\n      console.warn(\n        '[iii] Worker metrics disabled: OpenTelemetry not initialized. Call initOtel() with metricsEnabled: true before creating the iii.',\n      )\n      return\n    }\n\n    registerWorkerGauges(meter, {\n      workerId: this.workerId,\n      workerName: this.workerName,\n    })\n  }\n\n  private stopMetricsReporting(): void {\n    stopWorkerGauges()\n  }\n\n  private onSocketClose(): void {\n    this.stopHeartbeat()\n    this.ws?.removeAllListeners()\n    this.ws?.terminate()\n    this.ws = undefined\n\n    this.setConnectionState('disconnected')\n    this.stopMetricsReporting()\n    this.scheduleReconnect()\n  }\n\n  private onSocketOpen(): void {\n    this.clearReconnectTimeout()\n    this.reconnectAttempt = 0\n    this.setConnectionState('connected')\n\n    this.ws?.on('message', this.onMessage.bind(this))\n\n    // Reset the idle deadline on any inbound frame (message/ping/pong), Rust SDK parity\n    const touch = () => {\n      this.idleTimeout?.refresh()\n    }\n    this.ws?.on('message', touch)\n    this.ws?.on('ping', touch)\n    this.ws?.on('pong', touch)\n    this.startHeartbeat()\n\n    // Reconnect: present the previous engine-assigned identity BEFORE the\n    // metadata announce and registration replay so the engine retires the old\n    // connection and the replay lands on a clean slate instead of racing its\n    // cleanup. This must precede registerWorkerMetadata(): otherwise the old\n    // connection still holds this (namespace, worker_name) and the announce\n    // would trip WORKER_NAMESPACE_CONFLICT against ourselves. The token proves\n    // we ARE that worker (ids alone are publicly listable).\n    if (this.workerId) {\n      this.sendMessageRaw(\n        JSON.stringify({\n          type: MessageType.Reattach,\n          previous_worker_id: this.workerId,\n          reattach_token: this.reattachToken,\n        }),\n      )\n    }\n\n    // Announce worker metadata (carrying the namespace) before flushing any\n    // registrations so the engine knows this connection's namespace up front.\n    this.registerWorkerMetadata()\n\n\n    this.triggerTypes.forEach(({ message }) => {\n      this.sendMessage(MessageType.RegisterTriggerType, message, true)\n    })\n    this.functions.forEach(({ message }) => {\n      this.sendMessage(MessageType.RegisterFunction, message, true)\n    })\n    this.triggers.forEach((trigger) => {\n      this.sendMessage(MessageType.RegisterTrigger, trigger, true)\n    })\n\n    // Optimized: swap with empty array instead of splice\n    const pending = this.messagesToSend\n    this.messagesToSend = []\n    for (const message of pending) {\n      if (\n        message.type === MessageType.InvokeFunction &&\n        typeof message.invocation_id === 'string' &&\n        !this.invocations.has(message.invocation_id)\n      ) {\n        continue\n      }\n      this.sendMessageRaw(JSON.stringify(message))\n    }\n  }\n\n  private isOpen(): boolean {\n    return this.ws?.readyState === WebSocket.OPEN\n  }\n\n  private sendMessageRaw(data: string): void {\n    if (this.ws && this.isOpen()) {\n      try {\n        this.ws.send(data, (err) => {\n          if (err) {\n            this.logError('Failed to send message', err)\n          }\n        })\n      } catch (error) {\n        this.logError('Exception while sending message', error)\n      }\n    }\n  }\n\n  private toWireFormat(messageType: MessageType, message: Omit<IIIMessage, 'message_type'>): Record<string, unknown> {\n    const { message_type: _, ...rest } = message as Record<string, unknown>\n    if (messageType === MessageType.RegisterTrigger && 'type' in message) {\n      const { type: triggerType, ...triggerRest } = message as RegisterTriggerMessage\n      return { type: messageType, ...triggerRest, trigger_type: triggerType }\n    }\n    if (messageType === MessageType.UnregisterTrigger && 'type' in message) {\n      const { type: triggerType, ...triggerRest } = message as RegisterTriggerMessage\n      return { type: messageType, ...triggerRest, trigger_type: triggerType }\n    }\n    if (messageType === MessageType.TriggerRegistrationResult && 'type' in message) {\n      const { type: triggerType, ...resultRest } = message as TriggerRegistrationResultMessage\n      return { type: messageType, ...resultRest, trigger_type: triggerType }\n    }\n    return { type: messageType, ...rest } as Record<string, unknown>\n  }\n\n  private sendMessage(messageType: MessageType, message: Omit<IIIMessage, 'message_type'>, skipIfClosed = false): void {\n    const wireMessage = this.toWireFormat(messageType, message)\n    if (this.isOpen()) {\n      this.sendMessageRaw(JSON.stringify(wireMessage))\n    } else if (!skipIfClosed) {\n      this.messagesToSend.push(wireMessage)\n    }\n  }\n\n  private logError(message: string, error?: unknown): void {\n    const otelLogger = getLogger()\n    const errorMessage = error instanceof Error ? error.message : String(error ?? '')\n\n    if (otelLogger) {\n      otelLogger.emit({\n        severityNumber: SeverityNumber.ERROR,\n        body: `[iii] ${message}${errorMessage ? `: ${errorMessage}` : ''}`,\n      })\n    } else {\n      console.error(`[iii] ${message}`, error ?? '')\n    }\n  }\n\n  private logWarn(message: string): void {\n    const otelLogger = getLogger()\n    if (otelLogger) {\n      otelLogger.emit({\n        severityNumber: SeverityNumber.WARN,\n        body: `[iii] ${message}`,\n      })\n    } else {\n      console.warn(`[iii] ${message}`)\n    }\n  }\n\n  /**\n   * Handle a `registrationrejected` from the engine. The `code` decides the\n   * severity:\n   *\n   * - {@link WORKER_NAMESPACE_CONFLICT}: another live worker already holds this\n   *   `(namespace, worker_name)`. The engine closes the connection, so this is\n   *   fatal -- stop the worker, do not reconnect, and surface a\n   *   {@link RegistrationRejectedError} to every pending invocation.\n   * - {@link FUNCTION_NAMESPACE_CONFLICT}: another live worker in this namespace\n   *   already exports this one function id. Only that registration is refused;\n   *   the engine keeps the connection open and the worker keeps serving its\n   *   other functions. Non-fatal -- log a warning and continue.\n   * - Any other code: treated as fatal (safe default).\n   */\n  private onRegistrationRejected(init: {\n    code: string\n    namespace: string\n    worker_name?: string\n    function_id?: string\n    owner_worker_id: string\n  }): void {\n    if (init.code === FUNCTION_NAMESPACE_CONFLICT) {\n      this.logWarn(\n        `Function registration rejected: function \"${init.function_id ?? '<unknown>'}\" in namespace \"${init.namespace}\" is already exported by worker ${init.owner_worker_id}. The worker stays connected and keeps serving its other functions.`,\n      )\n      return\n    }\n\n    const error = new RegistrationRejectedError(init)\n    // Record it so callers can poll for the terminal cause (parity with the\n    // Python/Rust SDKs); the connection also transitions to `failed` below.\n    this.fatalError = error\n    if (init.code === WORKER_NAMESPACE_CONFLICT) {\n      this.logError('Registration rejected by engine', error)\n    } else {\n      this.logError(`Registration rejected by engine with unknown code \"${init.code}\"; treating as fatal`, error)\n    }\n\n    // Mark shutdown first so neither onSocketClose nor scheduleReconnect can\n    // schedule a reconnect for a rejection that would only be rejected again.\n    this.isShuttingDown = true\n    this.clearReconnectTimeout()\n    this.stopHeartbeat()\n\n    // Reject every in-flight invocation with the fatal error.\n    for (const [, invocation] of this.invocations) {\n      if (invocation.timeout) {\n        clearTimeout(invocation.timeout)\n      }\n      invocation.reject(error)\n    }\n    this.invocations.clear()\n\n    // Tear down the socket without triggering the reconnect path.\n    if (this.ws) {\n      this.ws.removeAllListeners()\n      this.ws.on('error', () => {})\n      try {\n        this.ws.terminate()\n      } catch {\n        // ignore, stopping anyway\n      }\n      this.ws = undefined\n    }\n\n    this.stopMetricsReporting()\n    this.setConnectionState('failed')\n  }\n\n  private onInvocationResult(invocation_id: string, result: unknown, error: unknown): void {\n    const invocation = this.invocations.get(invocation_id)\n\n    if (invocation) {\n      if (invocation.timeout) {\n        clearTimeout(invocation.timeout)\n      }\n      if (error) {\n        invocation.reject(this.toInvocationError(error, invocation.function_id))\n      } else {\n        invocation.resolve(result)\n      }\n    }\n\n    this.invocations.delete(invocation_id)\n  }\n\n  /**\n   * Wrap a wire-format `ErrorBody` in {@link InvocationError} so callers get\n   * a real `Error` with a readable `.message` and a typed `.code`. Pass-through\n   * for values that are already `Error` subclasses. Everything else is wrapped\n   * under an `UNKNOWN` code so `String(err) !== '[object Object]'` holds for\n   * every rejection path.\n   */\n  private toInvocationError(error: unknown, function_id?: string): Error {\n    if (error instanceof Error) {\n      return error\n    }\n    if (isErrorBody(error)) {\n      return new InvocationError({\n        code: error.code,\n        message: error.message,\n        function_id,\n        stacktrace: error.stacktrace,\n      })\n    }\n    // JSON.stringify(undefined) returns undefined (not \"undefined\"), which\n    // would set message to the literal string \"undefined\" after type coercion\n    // and leak an uninformative rejection. Fall back through String(error)\n    // so every path produces a concrete, readable string.\n    const message =\n      typeof error === 'string'\n        ? error\n        : (JSON.stringify(error) ?? String(error))\n    return new InvocationError({\n      code: 'UNKNOWN',\n      message,\n      function_id,\n    })\n  }\n\n  private resolveChannelValue(value: unknown): unknown {\n    if (isChannelRef(value)) {\n      return value.direction === 'read'\n        ? new ChannelReader(this.address, value)\n        : new ChannelWriter(this.address, value)\n    }\n    if (Array.isArray(value)) {\n      return value.map((item) => this.resolveChannelValue(item))\n    }\n    if (value !== null && typeof value === 'object') {\n      const out: Record<string, unknown> = {}\n      for (const [k, v] of Object.entries(value as Record<string, unknown>)) {\n        out[k] = this.resolveChannelValue(v)\n      }\n      return out\n    }\n    return value\n  }\n\n  private async onInvokeFunction<TInput>(\n    invocation_id: string | undefined,\n    function_id: string,\n    input: TInput,\n    metadata?: JsonValue,\n    traceparent?: string,\n    baggage?: string,\n  ): Promise<unknown> {\n    const fn = this.functions.get(function_id)\n    const getResponseTraceparent = () => injectTraceparent() ?? traceparent\n    const getResponseBaggage = () => injectBaggage() ?? baggage\n\n    const resolvedInput = this.resolveChannelValue(input) as TInput\n\n    if (fn?.handler) {\n      if (!invocation_id) {\n        try {\n          await fn.handler(resolvedInput, metadata, traceparent, baggage)\n        } catch (error) {\n          this.logError(`Error invoking function ${function_id}`, error)\n        }\n        return\n      }\n\n      try {\n        const result = await fn.handler(resolvedInput, metadata, traceparent, baggage)\n        this.sendMessage(MessageType.InvocationResult, {\n          invocation_id,\n          function_id,\n          result,\n          traceparent: getResponseTraceparent(),\n          baggage: getResponseBaggage(),\n        })\n      } catch (error) {\n        const isError = error instanceof Error\n        this.sendMessage(MessageType.InvocationResult, {\n          invocation_id,\n          function_id,\n          error: {\n            code: 'invocation_failed',\n            message: isError ? error.message : String(error),\n            stacktrace: isError ? error.stack : undefined,\n          },\n          traceparent: getResponseTraceparent(),\n          baggage: getResponseBaggage(),\n        })\n      }\n    } else {\n      const errorCode = fn ? 'function_not_invokable' : 'function_not_found'\n      const errorMessage = fn ? 'Function is HTTP-invoked and cannot be invoked locally' : 'Function not found'\n      if (invocation_id) {\n        this.sendMessage(MessageType.InvocationResult, {\n          invocation_id,\n          function_id,\n          error: { code: errorCode, message: errorMessage },\n          traceparent,\n          baggage,\n        })\n      }\n    }\n  }\n\n  private async onRegisterTrigger(message: {\n    trigger_type: string\n    id: string\n    function_id: string\n    config: unknown\n    metadata?: Record<string, unknown>\n    namespace?: string\n  }) {\n    const { trigger_type, id, function_id, config, metadata, namespace } = message\n    const triggerTypeData = this.triggerTypes.get(trigger_type)\n\n    if (triggerTypeData) {\n      try {\n        // Surface the namespace to the handler: a provider that fires the target\n        // later needs it to resolve in the right namespace, not `default`.\n        await triggerTypeData.handler.registerTrigger({ id, function_id, config, metadata, namespace })\n        this.sendMessage(MessageType.TriggerRegistrationResult, {\n          id,\n          message_type: MessageType.TriggerRegistrationResult,\n          type: trigger_type,\n          function_id,\n        })\n      } catch (error) {\n        this.sendMessage(MessageType.TriggerRegistrationResult, {\n          id,\n          message_type: MessageType.TriggerRegistrationResult,\n          type: trigger_type,\n          function_id,\n          error: { code: 'trigger_registration_failed', message: (error as Error).message },\n        })\n      }\n    } else {\n      this.sendMessage(MessageType.TriggerRegistrationResult, {\n        id,\n        message_type: MessageType.TriggerRegistrationResult,\n        type: trigger_type,\n        function_id,\n        error: { code: 'trigger_type_not_found', message: 'Trigger type not found' },\n      })\n    }\n  }\n\n  private async onUnregisterTrigger(message: {\n    trigger_type?: string\n    id: string\n    function_id?: string\n    config?: unknown\n    metadata?: Record<string, unknown>\n  }) {\n    const trigger_type = message.trigger_type\n    if (!trigger_type) return\n\n    const triggerTypeData = this.triggerTypes.get(trigger_type)\n    if (!triggerTypeData) return\n\n    const { id, function_id = '', config, metadata } = message\n    try {\n      await triggerTypeData.handler.unregisterTrigger({ id, function_id, config, metadata })\n    } catch (error) {\n      this.logError(`Error unregistering trigger ${id}`, error)\n    }\n  }\n\n  private onTriggerRegistrationResult(\n    message: { id: string; trigger_type?: string; type?: string; function_id: string; error?: { code: string; message: string; stacktrace?: string } },\n  ): void {\n    if (!message.error) return\n    const triggerType = message.trigger_type ?? message.type ?? ''\n    console.error(\n      `[iii] Trigger registration failed for \"${message.id}\" (${triggerType}): ${message.error.message}`,\n    )\n  }\n\n  private onMessage(socketMessage: Data): void {\n    let msgType: MessageType\n    let message: Record<string, unknown>\n\n    try {\n      const parsed = JSON.parse(socketMessage.toString()) as Record<string, unknown>\n      msgType = parsed.type as MessageType\n      const { type: _, ...rest } = parsed\n      message = rest\n    } catch (error) {\n      this.logError('Failed to parse incoming message', error)\n      return\n    }\n\n    if (msgType === MessageType.InvocationResult) {\n      const { invocation_id, result, error } = message as InvocationResultMessage\n      this.onInvocationResult(invocation_id, result, error)\n    } else if (msgType === MessageType.InvokeFunction) {\n      const { invocation_id, function_id, data, metadata, traceparent, baggage } = message as InvokeFunctionMessage\n      this.onInvokeFunction(invocation_id, function_id, data, metadata, traceparent, baggage)\n    } else if (msgType === MessageType.RegisterTrigger) {\n      this.onRegisterTrigger(message as { trigger_type: string; id: string; function_id: string; config: unknown; metadata?: Record<string, unknown> })\n    } else if (msgType === MessageType.UnregisterTrigger) {\n      this.onUnregisterTrigger(\n        message as {\n          trigger_type?: string\n          id: string\n          function_id?: string\n          config?: unknown\n          metadata?: Record<string, unknown>\n        },\n      )\n    } else if (msgType === MessageType.TriggerRegistrationResult) {\n      this.onTriggerRegistrationResult(\n        message as { id: string; trigger_type?: string; type?: string; function_id: string; error?: { code: string; message: string; stacktrace?: string } },\n      )\n    } else if (msgType === MessageType.WorkerRegistered) {\n      const { worker_id, reattach_token } = message as WorkerRegisteredMessage\n      this.workerId = worker_id\n      this.reattachToken = reattach_token\n      console.debug('[iii] Worker registered with ID:', worker_id)\n      this.startMetricsReporting()\n    } else if (msgType === MessageType.RegistrationRejected) {\n      const { code, namespace, worker_name, function_id, owner_worker_id } = message as RegistrationRejectedMessage\n      this.onRegistrationRejected({ code, namespace, worker_name, function_id, owner_worker_id })\n    }\n  }\n}\n\n/**\n * Factory object that constructs routing actions for {@link IIIClient.trigger}.\n *\n * @example\n * ```typescript\n * import { TriggerAction } from 'iii-sdk'\n *\n * // Enqueue to a named queue\n * worker.trigger({\n *   function_id: 'process',\n *   payload: { data: 'hello' },\n *   action: TriggerAction.Enqueue({ queue: 'jobs' }),\n * })\n *\n * // Fire-and-forget\n * worker.trigger({\n *   function_id: 'notify',\n *   payload: {},\n *   action: TriggerAction.Void(),\n * })\n * ```\n */\nexport const TriggerAction = {\n  /**\n   * Routes the invocation through a named queue. The engine enqueues the job,\n   * acknowledges the caller with `{ messageReceiptId }`, and processes it\n   * asynchronously.\n   *\n   * Requires a queue worker in the project. Run `iii worker add queue`.\n   * Without it the trigger rejects with `enqueue_error` (no queue provider).\n   *\n   * @param opts - Queue routing options.\n   * @param opts.queue - Name of the target queue.\n   */\n  Enqueue: (opts: { queue: string }) => ({ type: 'enqueue' as const, ...opts }),\n  /**\n   * Fire-and-forget routing. The engine forwards the invocation without\n   * waiting for a response or queuing the job.\n   */\n  Void: () => ({ type: 'void' as const }),\n} as const\n\n/**\n * Register the worker with a iii instance, returns a connected worker client.\n * The WebSocket connection is established automatically.\n *\n * @param address - WebSocket URL of the III engine. Omit to resolve it from\n *   `process.env.III_URL`, falling back to {@link DEFAULT_ENGINE_URL}.\n * @param options - Optional {@link InitOptions} for worker name, timeouts, reconnection, and OTel.\n * @returns A connected {@link IIIClient} instance.\n *\n * @example\n * ```typescript\n * import { registerWorker } from 'iii-sdk'\n *\n * // Address from III_URL, set by whatever supervisor spawned this worker.\n * const worker = registerWorker()\n *\n * // Or explicitly, which always wins over the environment.\n * const other = registerWorker('ws://localhost:49134', { workerName: 'my-worker' })\n * ```\n */\nexport const registerWorker = (address?: string, options?: InitOptions): IIIClient =>\n  new Sdk(resolveAddress(address), options)\n"],"mappings":"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"}

package/dist/index.d.cts

@@ -1,10 +1,15 @@
-import { C as MiddlewareFunctionInput, d as StreamResponse, r as IIIClient, u as StreamRequest, x as JsonValue } from "./types-n-760A15.cjs";
-import { i as IIIReconnectionConfig } from "./iii-constants-BqXp8xSN.cjs";
-import { InvocationError, InvocationErrorInit } from "./errors.cjs";
+import { D as MiddlewareFunctionInput, T as JsonValue, d as StreamResponse, r as IIIClient, u as StreamRequest, v as IIIConnectionState, y as IIIReconnectionConfig } from "./types-HYwMK3aJ.cjs";
+import { n as InvocationErrorInit, r as RegistrationRejectedError, t as InvocationError } from "./errors-BK88qe9x.cjs";
 import { OtelConfig } from "@iii-dev/helpers/observability";
 import { EnqueueResult } from "@iii-dev/helpers/queue";
 
 //#region src/iii.d.ts
+/**
+ * Engine address used when neither an explicit address nor `III_URL` is set.
+ * The IPv4 loopback is spelled out on purpose: `localhost` can resolve to `::1`
+ * on a host whose engine only listens on IPv4.
+ */
+declare const DEFAULT_ENGINE_URL = "ws://127.0.0.1:49134";
 /** Worker metadata reported to the engine (language, framework, project). */
 type TelemetryOptions = {
   /** Programming language of the worker. */language?: string; /** Name of the project this worker belongs to. */
@@ -26,6 +31,14 @@ type TelemetryOptions = {
  */
 type InitOptions = {
   /** Display name for this worker. Defaults to `hostname:pid`. */workerName?: string;
+  /**
+   * Namespace this worker registers under. Resolution order:
+   * `options.namespace` -> `process.env.III_NAMESPACE` -> undefined. When
+   * undefined the engine applies its `default` namespace. Scopes worker and
+   * function registrations so identically-named entries can coexist across
+   * namespaces.
+   */
+  namespace?: string;
   /**
    * One-line, human/LLM-readable summary of what this worker does.
    * Surfaces in `engine::workers::list` / `engine::workers::info`.
@@ -100,7 +113,8 @@ declare const TriggerAction: {
  * Register the worker with a iii instance, returns a connected worker client.
  * The WebSocket connection is established automatically.
  *
- * @param address - WebSocket URL of the III engine (e.g. `ws://localhost:49134`).
+ * @param address - WebSocket URL of the III engine. Omit to resolve it from
+ *   `process.env.III_URL`, falling back to {@link DEFAULT_ENGINE_URL}.
  * @param options - Optional {@link InitOptions} for worker name, timeouts, reconnection, and OTel.
  * @returns A connected {@link IIIClient} instance.
  *
@@ -108,12 +122,14 @@ declare const TriggerAction: {
  * ```typescript
  * import { registerWorker } from 'iii-sdk'
  *
- * const worker = registerWorker(process.env.III_URL ?? 'ws://localhost:49134', {
- *   workerName: 'my-worker',
- * })
+ * // Address from III_URL, set by whatever supervisor spawned this worker.
+ * const worker = registerWorker()
+ *
+ * // Or explicitly, which always wins over the environment.
+ * const other = registerWorker('ws://localhost:49134', { workerName: 'my-worker' })
  * ```
  */
-declare const registerWorker: (address: string, options?: InitOptions) => IIIClient;
+declare const registerWorker: (address?: string, options?: InitOptions) => IIIClient;
 //#endregion
-export { type EnqueueResult, type IIIClient, type InitOptions, InvocationError, type InvocationErrorInit, type JsonValue, type MiddlewareFunctionInput, type StreamRequest, type StreamResponse, type TelemetryOptions, TriggerAction, registerWorker };
+export { DEFAULT_ENGINE_URL, type EnqueueResult, type IIIClient, type IIIConnectionState, type InitOptions, InvocationError, type InvocationErrorInit, type JsonValue, type MiddlewareFunctionInput, RegistrationRejectedError, type StreamRequest, type StreamResponse, type TelemetryOptions, TriggerAction, registerWorker };
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../src/iii.ts"],"mappings":";;;;;;;;KAoFY,gBAAA;4CAEV,QAAA,WAFU;EAIV,YAAA;EAEA,SAAA,WAJA;EAMA,iBAAA;AAAA;;;;AAeF;;;;;;;;;KAAY,WAAA;EA2BkB,gEAzB5B,UAAA;EAKA;;;;EAAA,iBAAA,WAU6B;EAR7B,sBAAA,YAcO;EAZP,mBAAA;EAcA;;;;;EARA,kBAAA,GAAqB,OAAA,CAAQ,qBAAA;EAggClB;;;;;EA1/BX,IAAA,GAAO,IAAA,CAAK,UAAA;EAEZ,OAAA,GAAU,MAAA;EAEV,SAAA,GAAY,gBAAA;AAAA;;;AA2hCd;;;;;;;;;;;;;;;;;;;;cArCa,aAAA;;;;;;;;;;;;;IAYO,KAAA;EAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAyBP,cAAA,GAAkB,OAAA,UAAiB,OAAA,GAAU,WAAA,KAAc,SAAA"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/iii.ts"],"mappings":";;;;;;;;;AAuGA;;cAAa,kBAAA;;KAgCD,gBAAA;EAAA,0CAEV,QAAA;EAEA,YAAA,WAFA;EAIA,SAAA;EAEA,iBAAA;AAAA;;AAeF;;;;;;;;;;;KAAY,WAAA;EAUV,gEARA,UAAA;EAeA;;;;;;;EAPA,SAAA;EAuBA;;;;EAlBA,iBAAA,WAoB4B;EAlB5B,sBAAA,YAoqCQ;EAlqCR,mBAAA;EAkqCQ;;;;;EA5pCR,kBAAA,GAAqB,OAAA,CAAQ,qBAAA;;;;;AAkrC/B;EA5qCE,IAAA,GAAO,IAAA,CAAK,UAAA;EAEZ,OAAA,GAAU,MAAA,kBA0qCmB;EAxqC7B,SAAA,GAAY,gBAAA;AAAA;;;;;;;;;;;;;;;;;;;;;;;cAgoCD,aAAA;;;;;;;;;;;;;IAYO,KAAA;EAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cA4BP,cAAA,GAAkB,OAAA,WAAkB,OAAA,GAAU,WAAA,KAAc,SAAA"}