iii-sdk 0.22.0-alpha.4 → 0.22.0-alpha.6

package/dist/channel.d.cts

@@ -1,2 +1,2 @@
-import { C as ChannelWriter, M as StreamChannelRef, S as ChannelReader, t as Channel } from "./types-cLCLqZrc.cjs";
+import { C as ChannelWriter, M as StreamChannelRef, S as ChannelReader, t as Channel } from "./types-C43VHoZq.cjs";
 export { type Channel, ChannelReader, ChannelWriter, type StreamChannelRef };

package/dist/channel.d.mts

@@ -1,2 +1,2 @@
-import { C as ChannelWriter, M as StreamChannelRef, S as ChannelReader, t as Channel } from "./types-D6dInVB5.mjs";
+import { C as ChannelWriter, M as StreamChannelRef, S as ChannelReader, t as Channel } from "./types-CPReRK1z.mjs";
 export { type Channel, ChannelReader, ChannelWriter, type StreamChannelRef };

package/dist/engine.d.cts

@@ -1,2 +1,2 @@
-import { _ as EngineTriggers, g as EngineFunctions, l as RemoteFunctionHandler } from "./types-cLCLqZrc.cjs";
+import { _ as EngineTriggers, g as EngineFunctions, l as RemoteFunctionHandler } from "./types-C43VHoZq.cjs";
 export { EngineFunctions, EngineTriggers, type RemoteFunctionHandler };

package/dist/engine.d.mts

@@ -1,2 +1,2 @@
-import { _ as EngineTriggers, g as EngineFunctions, l as RemoteFunctionHandler } from "./types-D6dInVB5.mjs";
+import { _ as EngineTriggers, g as EngineFunctions, l as RemoteFunctionHandler } from "./types-CPReRK1z.mjs";
 export { EngineFunctions, EngineTriggers, type RemoteFunctionHandler };

package/dist/helpers.d.cts

@@ -1,4 +1,4 @@
-import { M as StreamChannelRef, b as ChannelDirection, r as IIIClient, t as Channel, x as ChannelItem } from "./types-cLCLqZrc.cjs";
+import { M as StreamChannelRef, b as ChannelDirection, r as IIIClient, t as Channel, x as ChannelItem } from "./types-C43VHoZq.cjs";
 import { IStream } from "./stream.cjs";
 
 //#region src/utils.d.ts

package/dist/helpers.d.mts

@@ -1,4 +1,4 @@
-import { M as StreamChannelRef, b as ChannelDirection, r as IIIClient, t as Channel, x as ChannelItem } from "./types-D6dInVB5.mjs";
+import { M as StreamChannelRef, b as ChannelDirection, r as IIIClient, t as Channel, x as ChannelItem } from "./types-CPReRK1z.mjs";
 import { IStream } from "./stream.mjs";
 
 //#region src/utils.d.ts

package/dist/iii-types-BHasLgj1.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"iii-types-BHasLgj1.cjs","names":[],"sources":["../src/iii-types.ts"],"sourcesContent":["import type { HttpInvocationConfig } from '@iii-dev/helpers/http'\n\n/**\n * Any JSON value: the TypeScript equivalent of the engine's arbitrary-JSON\n * wire values (Rust `serde_json::Value`). Used where the wire contract is\n * \"any JSON\", e.g. per-invocation `metadata`.\n */\nexport type JsonValue =\n  | string\n  | number\n  | boolean\n  | null\n  | JsonValue[]\n  | { [key: string]: JsonValue }\n\nexport enum MessageType {\n  RegisterFunction = 'registerfunction',\n  UnregisterFunction = 'unregisterfunction',\n  InvokeFunction = 'invokefunction',\n  InvocationResult = 'invocationresult',\n  RegisterTriggerType = 'registertriggertype',\n  RegisterTrigger = 'registertrigger',\n  UnregisterTrigger = 'unregistertrigger',\n  UnregisterTriggerType = 'unregistertriggertype',\n  TriggerRegistrationResult = 'triggerregistrationresult',\n  WorkerRegistered = 'workerregistered',\n  RegistrationRejected = 'registrationrejected',\n  Reattach = 'reattach',\n}\n\nexport type RegisterTriggerTypeMessage = {\n  message_type: MessageType.RegisterTriggerType\n  /** Unique identifier for the trigger type (e.g. `state`, `durable:subscriber`). */\n  id: string\n  /** Human-readable description of what this trigger type does. */\n  description: string\n}\n\nexport type UnregisterTriggerTypeMessage = {\n  message_type: MessageType.UnregisterTriggerType\n  id: string\n}\n\nexport type UnregisterTriggerMessage = {\n  message_type: MessageType.UnregisterTrigger\n  id: string\n  type?: string\n}\n\nexport type ErrorBody = {\n  code: string\n  message: string\n  stacktrace?: string\n}\n\nexport type TriggerRegistrationResultMessage = {\n  message_type: MessageType.TriggerRegistrationResult\n  id: string\n  type: string\n  function_id: string\n  error?: ErrorBody\n}\n\nexport type RegisterTriggerMessage = {\n  /** Wire discriminator; always `MessageType.RegisterTrigger`. */\n  message_type: MessageType.RegisterTrigger\n  /** Unique trigger identifier, generated by the SDK during registration. */\n  id: string\n  /** Identifier of the registered trigger type this trigger uses (e.g. `storage::object-created`, `http`). */\n  type: string\n  /** ID of the function this trigger invokes when it fires. */\n  function_id: string\n  /** Trigger-type-specific configuration, matching the shape the trigger type expects. */\n  config: unknown\n  /** Arbitrary user-specifiable metadata supplied to the triggered handler function on every invocation. */\n  metadata?: Record<string, unknown>\n  /**\n   * Namespace the trigger's target function resolves in. Omit for the engine's\n   * default namespace, independent of this connection's namespace.\n   */\n  namespace?: string\n}\n\nexport type RegisterFunctionFormat = {\n  /**\n   * The name of the parameter.\n   */\n  name?: string\n  /**\n   * The description of the parameter.\n   */\n  description?: string\n  /**\n   * The type of the parameter.\n   */\n  type?: 'string' | 'number' | 'boolean' | 'object' | 'array' | 'null' | 'map' | 'integer'\n  /**\n   * The body of the parameter (for objects).\n   */\n  properties?: Record<string, unknown>\n  /**\n   * The items of the parameter (for arrays).\n   */\n  items?: unknown\n  /**\n   * Whether the parameter is required.\n   */\n  required?: string[]\n  [key: string]: unknown\n}\n\nexport type RegisterFunctionMessage = {\n  message_type: MessageType.RegisterFunction\n  /**\n   * The path of the function (use :: for namespacing, e.g. external::my_lambda).\n   */\n  id: string\n  /**\n   * The description of the function.\n   */\n  description?: string\n  /**\n   * The request format of the function.\n   */\n  request_format?: RegisterFunctionFormat\n  /**\n   * The response format of the function.\n   */\n  response_format?: RegisterFunctionFormat\n  /**\n   * Arbitrary metadata attached to the function.\n   */\n  metadata?: Record<string, unknown>\n  /**\n   * HTTP invocation config for external HTTP functions (Lambda, Cloudflare Workers, etc.).\n   */\n  invocation?: HttpInvocationConfig\n}\n\n/**\n * Routing action for {@link TriggerRequest}. Determines how the engine\n * handles the invocation.\n *\n * - `enqueue`: Routes through a named queue for async processing.\n * - `void`: Fire-and-forget, no response.\n */\nexport type TriggerAction = { type: 'enqueue'; queue: string } | { type: 'void' }\n\n/**\n * Input passed to the RBAC middleware function on every function invocation\n * through the RBAC port. The middleware can inspect, modify, or reject the\n * call before it reaches the target function.\n */\nexport type MiddlewareFunctionInput = {\n  /** ID of the function being invoked. */\n  function_id: string\n  /** Payload sent by the caller. */\n  payload: Record<string, unknown>\n  /** Routing action, if any. */\n  action?: TriggerAction\n  /** Auth context returned by the auth function for this session. */\n  context: Record<string, unknown>\n  /**\n   * Target namespace the invoke addressed; forward the call here to stay in the\n   * caller's namespace. Absent → the engine's default namespace.\n   */\n  namespace?: string\n}\n\n/**\n * Request object passed to {@link IIIClient.trigger}.\n *\n * @typeParam TInput - Type of the payload.\n */\n/**\n * A `function_id` accepted wherever a target function is named: a bare string,\n * or a ref (e.g. a `FunctionRef` from `registerFunction`) carrying the namespace\n * where the function was registered. When a ref is passed, its namespace is used\n * for routing unless an explicit `namespace` overrides it.\n */\nexport type FunctionTarget = string | { function_id: string; namespace?: string }\n\nexport type TriggerRequest<TInput = unknown> = {\n  /** ID of the function to invoke, or a ref carrying its namespace. */\n  function_id: FunctionTarget\n  /** Input data passed to the function. */\n  payload: TInput\n  /** Sets how the trigger is routed. Omit for a synchronous request/response. Specify for a specific routing scheme (e.g. `TriggerAction.Enqueue()`, `TriggerAction.Void()`). */\n  action?: TriggerAction\n  /** Override the default invocation timeout, in milliseconds. */\n  timeoutMs?: number\n  /** Arbitrary user-specifiable metadata supplied to the triggered handler function on every invocation. */\n  metadata?: unknown\n  /**\n   * Target namespace for routing. Omit to route within the engine's default\n   * namespace. Serialized into the {@link InvokeFunctionMessage} `namespace`\n   * field; omitted from the wire when undefined.\n   */\n  namespace?: string\n}\n\nexport type InvokeFunctionMessage = {\n  message_type: MessageType.InvokeFunction\n  /**\n   * This is optional for async invocations\n   */\n  invocation_id?: string\n  /**\n   * The path of the function.\n   */\n  function_id: string\n  /**\n   * The data to pass to the function\n   */\n  data: unknown\n  /**\n   * W3C trace-context traceparent header for distributed tracing\n   */\n  traceparent?: string\n  /**\n   * W3C baggage header for cross-cutting context propagation\n   */\n  baggage?: string\n  /**\n   * Trigger action for queue routing or fire-and-forget\n   */\n  action?: TriggerAction\n  /**\n   * Optional per-invocation metadata (arbitrary JSON). Travels as a separate\n   * channel from `data`. Omitted from the JSON when undefined; absence on\n   * inbound means \"no metadata\" (backward compatible with older engines).\n   */\n  metadata?: JsonValue\n  /**\n   * Target namespace for routing. Optional and additive: omitted from the JSON\n   * when undefined, and absence on inbound means the engine's default\n   * namespace (backward compatible with older engines).\n   */\n  namespace?: string\n}\n\nexport type InvocationResultMessage = {\n  message_type: MessageType.InvocationResult\n  /**\n   * The id of the invocation\n   */\n  invocation_id: string\n  /**\n   * The path of the function.\n   */\n  function_id: string\n  result?: unknown\n  error?: unknown\n  /**\n   * W3C trace-context traceparent header for distributed tracing\n   */\n  traceparent?: string\n  /**\n   * W3C baggage header for cross-cutting context propagation\n   */\n  baggage?: string\n}\n\nexport type WorkerRegisteredMessage = {\n  message_type: MessageType.WorkerRegistered\n  worker_id: string\n  /** Secret to present in a reattach frame on reconnect; absent on older engines. */\n  reattach_token?: string\n}\n\n/**\n * Sent by the engine when this worker's registration collides with a live\n * worker in `namespace`. The `code` decides severity:\n *\n * - `WORKER_NAMESPACE_CONFLICT`: another worker already holds this\n *   `(namespace, worker_name)`. The engine closes the connection -- fatal: the\n *   SDK stops the worker and does not reconnect.\n * - `FUNCTION_NAMESPACE_CONFLICT`: another worker already exports this one\n *   function id (carried in `worker_name`). The engine keeps the connection\n *   open -- non-fatal: only that registration is refused and the worker keeps\n *   serving its other functions.\n */\nexport type RegistrationRejectedMessage = {\n  message_type: MessageType.RegistrationRejected\n  /** Machine-readable rejection code (`WORKER_NAMESPACE_CONFLICT` | `FUNCTION_NAMESPACE_CONFLICT`). */\n  code: string\n  /** Namespace in which the collision occurred. */\n  namespace: string\n  /** The contested identity: the worker name, or (FUNCTION conflict) the function id. */\n  worker_name: string\n  /** ID of the live worker that already owns the contested identity. */\n  owner_worker_id: string\n}\n\nexport type UnregisterFunctionMessage = {\n  message_type: MessageType.UnregisterFunction\n  id: string\n}\n\n/**\n * Serializable reference to one end of a streaming channel. Can be included\n * in invocation payloads to pass channel endpoints between workers.\n */\nexport type StreamChannelRef = {\n  /** Unique channel identifier. */\n  channel_id: string\n  /** Access key for authentication. */\n  access_key: string\n  /** Whether this ref is for reading or writing. */\n  direction: 'read' | 'write'\n}\n\nexport type IIIMessage =\n  | RegisterFunctionMessage\n  | UnregisterFunctionMessage\n  | InvokeFunctionMessage\n  | InvocationResultMessage\n  | RegisterTriggerMessage\n  | RegisterTriggerTypeMessage\n  | UnregisterTriggerMessage\n  | UnregisterTriggerTypeMessage\n  | TriggerRegistrationResultMessage\n  | WorkerRegisteredMessage\n  | RegistrationRejectedMessage\n"],"mappings":";;AAeA,IAAY,cAAL;AACL;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;KACD"}
+{"version":3,"file":"iii-types-BHasLgj1.cjs","names":[],"sources":["../src/iii-types.ts"],"sourcesContent":["import type { HttpInvocationConfig } from '@iii-dev/helpers/http'\n\n/**\n * Any JSON value: the TypeScript equivalent of the engine's arbitrary-JSON\n * wire values (Rust `serde_json::Value`). Used where the wire contract is\n * \"any JSON\", e.g. per-invocation `metadata`.\n */\nexport type JsonValue =\n  | string\n  | number\n  | boolean\n  | null\n  | JsonValue[]\n  | { [key: string]: JsonValue }\n\nexport enum MessageType {\n  RegisterFunction = 'registerfunction',\n  UnregisterFunction = 'unregisterfunction',\n  InvokeFunction = 'invokefunction',\n  InvocationResult = 'invocationresult',\n  RegisterTriggerType = 'registertriggertype',\n  RegisterTrigger = 'registertrigger',\n  UnregisterTrigger = 'unregistertrigger',\n  UnregisterTriggerType = 'unregistertriggertype',\n  TriggerRegistrationResult = 'triggerregistrationresult',\n  WorkerRegistered = 'workerregistered',\n  RegistrationRejected = 'registrationrejected',\n  Reattach = 'reattach',\n}\n\nexport type RegisterTriggerTypeMessage = {\n  message_type: MessageType.RegisterTriggerType\n  /** Unique identifier for the trigger type (e.g. `state`, `durable:subscriber`). */\n  id: string\n  /** Human-readable description of what this trigger type does. */\n  description: string\n}\n\nexport type UnregisterTriggerTypeMessage = {\n  message_type: MessageType.UnregisterTriggerType\n  id: string\n}\n\nexport type UnregisterTriggerMessage = {\n  message_type: MessageType.UnregisterTrigger\n  id: string\n  type?: string\n}\n\nexport type ErrorBody = {\n  code: string\n  message: string\n  stacktrace?: string\n}\n\nexport type TriggerRegistrationResultMessage = {\n  message_type: MessageType.TriggerRegistrationResult\n  id: string\n  type: string\n  function_id: string\n  error?: ErrorBody\n}\n\nexport type RegisterTriggerMessage = {\n  /** Wire discriminator; always `MessageType.RegisterTrigger`. */\n  message_type: MessageType.RegisterTrigger\n  /** Unique trigger identifier, generated by the SDK during registration. */\n  id: string\n  /** Identifier of the registered trigger type this trigger uses (e.g. `storage::object-created`, `http`). */\n  type: string\n  /** ID of the function this trigger invokes when it fires. */\n  function_id: string\n  /** Trigger-type-specific configuration, matching the shape the trigger type expects. */\n  config: unknown\n  /** Arbitrary user-specifiable metadata supplied to the triggered handler function on every invocation. */\n  metadata?: Record<string, unknown>\n  /**\n   * Namespace the trigger's target function resolves in. Omit for the engine's\n   * default namespace, independent of this connection's namespace.\n   */\n  namespace?: string\n}\n\nexport type RegisterFunctionFormat = {\n  /**\n   * The name of the parameter.\n   */\n  name?: string\n  /**\n   * The description of the parameter.\n   */\n  description?: string\n  /**\n   * The type of the parameter.\n   */\n  type?: 'string' | 'number' | 'boolean' | 'object' | 'array' | 'null' | 'map' | 'integer'\n  /**\n   * The body of the parameter (for objects).\n   */\n  properties?: Record<string, unknown>\n  /**\n   * The items of the parameter (for arrays).\n   */\n  items?: unknown\n  /**\n   * Whether the parameter is required.\n   */\n  required?: string[]\n  [key: string]: unknown\n}\n\nexport type RegisterFunctionMessage = {\n  message_type: MessageType.RegisterFunction\n  /**\n   * The path of the function (use :: for namespacing, e.g. external::my_lambda).\n   */\n  id: string\n  /**\n   * The description of the function.\n   */\n  description?: string\n  /**\n   * The request format of the function.\n   */\n  request_format?: RegisterFunctionFormat\n  /**\n   * The response format of the function.\n   */\n  response_format?: RegisterFunctionFormat\n  /**\n   * Arbitrary metadata attached to the function.\n   */\n  metadata?: Record<string, unknown>\n  /**\n   * HTTP invocation config for external HTTP functions (Lambda, Cloudflare Workers, etc.).\n   */\n  invocation?: HttpInvocationConfig\n}\n\n/**\n * Routing action for {@link TriggerRequest}. Determines how the engine\n * handles the invocation.\n *\n * - `enqueue`: Routes through a named queue for async processing.\n * - `void`: Fire-and-forget, no response.\n */\nexport type TriggerAction = { type: 'enqueue'; queue: string } | { type: 'void' }\n\n/**\n * Input passed to the RBAC middleware function on every function invocation\n * through the RBAC port. The middleware can inspect, modify, or reject the\n * call before it reaches the target function.\n */\nexport type MiddlewareFunctionInput = {\n  /** ID of the function being invoked. */\n  function_id: string\n  /** Payload sent by the caller. */\n  payload: Record<string, unknown>\n  /** Routing action, if any. */\n  action?: TriggerAction\n  /** Auth context returned by the auth function for this session. */\n  context: Record<string, unknown>\n  /**\n   * Target namespace the invoke addressed; forward the call here to stay in the\n   * caller's namespace. Absent → the engine's default namespace.\n   */\n  namespace?: string\n}\n\n/**\n * Request object passed to {@link IIIClient.trigger}.\n *\n * @typeParam TInput - Type of the payload.\n */\nexport type TriggerRequest<TInput = unknown> = {\n  /** ID of the function to invoke. */\n  function_id: string\n  /** Input data passed to the function. */\n  payload: TInput\n  /** Sets how the trigger is routed. Omit for a synchronous request/response. Specify for a specific routing scheme (e.g. `TriggerAction.Enqueue()`, `TriggerAction.Void()`). */\n  action?: TriggerAction\n  /** Override the default invocation timeout, in milliseconds. */\n  timeoutMs?: number\n  /** Arbitrary user-specifiable metadata supplied to the triggered handler function on every invocation. */\n  metadata?: unknown\n  /**\n   * Target namespace for routing. Omit to route within the engine's default\n   * namespace. Serialized into the {@link InvokeFunctionMessage} `namespace`\n   * field; omitted from the wire when undefined.\n   */\n  namespace?: string\n}\n\nexport type InvokeFunctionMessage = {\n  message_type: MessageType.InvokeFunction\n  /**\n   * This is optional for async invocations\n   */\n  invocation_id?: string\n  /**\n   * The path of the function.\n   */\n  function_id: string\n  /**\n   * The data to pass to the function\n   */\n  data: unknown\n  /**\n   * W3C trace-context traceparent header for distributed tracing\n   */\n  traceparent?: string\n  /**\n   * W3C baggage header for cross-cutting context propagation\n   */\n  baggage?: string\n  /**\n   * Trigger action for queue routing or fire-and-forget\n   */\n  action?: TriggerAction\n  /**\n   * Optional per-invocation metadata (arbitrary JSON). Travels as a separate\n   * channel from `data`. Omitted from the JSON when undefined; absence on\n   * inbound means \"no metadata\" (backward compatible with older engines).\n   */\n  metadata?: JsonValue\n  /**\n   * Target namespace for routing. Optional and additive: omitted from the JSON\n   * when undefined, and absence on inbound means the engine's default\n   * namespace (backward compatible with older engines).\n   */\n  namespace?: string\n}\n\nexport type InvocationResultMessage = {\n  message_type: MessageType.InvocationResult\n  /**\n   * The id of the invocation\n   */\n  invocation_id: string\n  /**\n   * The path of the function.\n   */\n  function_id: string\n  result?: unknown\n  error?: unknown\n  /**\n   * W3C trace-context traceparent header for distributed tracing\n   */\n  traceparent?: string\n  /**\n   * W3C baggage header for cross-cutting context propagation\n   */\n  baggage?: string\n}\n\nexport type WorkerRegisteredMessage = {\n  message_type: MessageType.WorkerRegistered\n  worker_id: string\n  /** Secret to present in a reattach frame on reconnect; absent on older engines. */\n  reattach_token?: string\n}\n\n/**\n * Sent by the engine when this worker's registration collides with a live\n * worker in `namespace`. The `code` decides severity:\n *\n * - `WORKER_NAMESPACE_CONFLICT`: another worker already holds this\n *   `(namespace, worker_name)`. The engine closes the connection -- fatal: the\n *   SDK stops the worker and does not reconnect.\n * - `FUNCTION_NAMESPACE_CONFLICT`: another worker already exports this one\n *   function id (carried in `worker_name`). The engine keeps the connection\n *   open -- non-fatal: only that registration is refused and the worker keeps\n *   serving its other functions.\n */\nexport type RegistrationRejectedMessage = {\n  message_type: MessageType.RegistrationRejected\n  /** Machine-readable rejection code (`WORKER_NAMESPACE_CONFLICT` | `FUNCTION_NAMESPACE_CONFLICT`). */\n  code: string\n  /** Namespace in which the collision occurred. */\n  namespace: string\n  /** The contested identity: the worker name, or (FUNCTION conflict) the function id. */\n  worker_name: string\n  /** ID of the live worker that already owns the contested identity. */\n  owner_worker_id: string\n}\n\nexport type UnregisterFunctionMessage = {\n  message_type: MessageType.UnregisterFunction\n  id: string\n}\n\n/**\n * Serializable reference to one end of a streaming channel. Can be included\n * in invocation payloads to pass channel endpoints between workers.\n */\nexport type StreamChannelRef = {\n  /** Unique channel identifier. */\n  channel_id: string\n  /** Access key for authentication. */\n  access_key: string\n  /** Whether this ref is for reading or writing. */\n  direction: 'read' | 'write'\n}\n\nexport type IIIMessage =\n  | RegisterFunctionMessage\n  | UnregisterFunctionMessage\n  | InvokeFunctionMessage\n  | InvocationResultMessage\n  | RegisterTriggerMessage\n  | RegisterTriggerTypeMessage\n  | UnregisterTriggerMessage\n  | UnregisterTriggerTypeMessage\n  | TriggerRegistrationResultMessage\n  | WorkerRegisteredMessage\n  | RegistrationRejectedMessage\n"],"mappings":";;AAeA,IAAY,cAAL;AACL;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;KACD"}

package/dist/iii-types-Btz-0RpP.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"iii-types-Btz-0RpP.mjs","names":[],"sources":["../src/iii-types.ts"],"sourcesContent":["import type { HttpInvocationConfig } from '@iii-dev/helpers/http'\n\n/**\n * Any JSON value: the TypeScript equivalent of the engine's arbitrary-JSON\n * wire values (Rust `serde_json::Value`). Used where the wire contract is\n * \"any JSON\", e.g. per-invocation `metadata`.\n */\nexport type JsonValue =\n  | string\n  | number\n  | boolean\n  | null\n  | JsonValue[]\n  | { [key: string]: JsonValue }\n\nexport enum MessageType {\n  RegisterFunction = 'registerfunction',\n  UnregisterFunction = 'unregisterfunction',\n  InvokeFunction = 'invokefunction',\n  InvocationResult = 'invocationresult',\n  RegisterTriggerType = 'registertriggertype',\n  RegisterTrigger = 'registertrigger',\n  UnregisterTrigger = 'unregistertrigger',\n  UnregisterTriggerType = 'unregistertriggertype',\n  TriggerRegistrationResult = 'triggerregistrationresult',\n  WorkerRegistered = 'workerregistered',\n  RegistrationRejected = 'registrationrejected',\n  Reattach = 'reattach',\n}\n\nexport type RegisterTriggerTypeMessage = {\n  message_type: MessageType.RegisterTriggerType\n  /** Unique identifier for the trigger type (e.g. `state`, `durable:subscriber`). */\n  id: string\n  /** Human-readable description of what this trigger type does. */\n  description: string\n}\n\nexport type UnregisterTriggerTypeMessage = {\n  message_type: MessageType.UnregisterTriggerType\n  id: string\n}\n\nexport type UnregisterTriggerMessage = {\n  message_type: MessageType.UnregisterTrigger\n  id: string\n  type?: string\n}\n\nexport type ErrorBody = {\n  code: string\n  message: string\n  stacktrace?: string\n}\n\nexport type TriggerRegistrationResultMessage = {\n  message_type: MessageType.TriggerRegistrationResult\n  id: string\n  type: string\n  function_id: string\n  error?: ErrorBody\n}\n\nexport type RegisterTriggerMessage = {\n  /** Wire discriminator; always `MessageType.RegisterTrigger`. */\n  message_type: MessageType.RegisterTrigger\n  /** Unique trigger identifier, generated by the SDK during registration. */\n  id: string\n  /** Identifier of the registered trigger type this trigger uses (e.g. `storage::object-created`, `http`). */\n  type: string\n  /** ID of the function this trigger invokes when it fires. */\n  function_id: string\n  /** Trigger-type-specific configuration, matching the shape the trigger type expects. */\n  config: unknown\n  /** Arbitrary user-specifiable metadata supplied to the triggered handler function on every invocation. */\n  metadata?: Record<string, unknown>\n  /**\n   * Namespace the trigger's target function resolves in. Omit for the engine's\n   * default namespace, independent of this connection's namespace.\n   */\n  namespace?: string\n}\n\nexport type RegisterFunctionFormat = {\n  /**\n   * The name of the parameter.\n   */\n  name?: string\n  /**\n   * The description of the parameter.\n   */\n  description?: string\n  /**\n   * The type of the parameter.\n   */\n  type?: 'string' | 'number' | 'boolean' | 'object' | 'array' | 'null' | 'map' | 'integer'\n  /**\n   * The body of the parameter (for objects).\n   */\n  properties?: Record<string, unknown>\n  /**\n   * The items of the parameter (for arrays).\n   */\n  items?: unknown\n  /**\n   * Whether the parameter is required.\n   */\n  required?: string[]\n  [key: string]: unknown\n}\n\nexport type RegisterFunctionMessage = {\n  message_type: MessageType.RegisterFunction\n  /**\n   * The path of the function (use :: for namespacing, e.g. external::my_lambda).\n   */\n  id: string\n  /**\n   * The description of the function.\n   */\n  description?: string\n  /**\n   * The request format of the function.\n   */\n  request_format?: RegisterFunctionFormat\n  /**\n   * The response format of the function.\n   */\n  response_format?: RegisterFunctionFormat\n  /**\n   * Arbitrary metadata attached to the function.\n   */\n  metadata?: Record<string, unknown>\n  /**\n   * HTTP invocation config for external HTTP functions (Lambda, Cloudflare Workers, etc.).\n   */\n  invocation?: HttpInvocationConfig\n}\n\n/**\n * Routing action for {@link TriggerRequest}. Determines how the engine\n * handles the invocation.\n *\n * - `enqueue`: Routes through a named queue for async processing.\n * - `void`: Fire-and-forget, no response.\n */\nexport type TriggerAction = { type: 'enqueue'; queue: string } | { type: 'void' }\n\n/**\n * Input passed to the RBAC middleware function on every function invocation\n * through the RBAC port. The middleware can inspect, modify, or reject the\n * call before it reaches the target function.\n */\nexport type MiddlewareFunctionInput = {\n  /** ID of the function being invoked. */\n  function_id: string\n  /** Payload sent by the caller. */\n  payload: Record<string, unknown>\n  /** Routing action, if any. */\n  action?: TriggerAction\n  /** Auth context returned by the auth function for this session. */\n  context: Record<string, unknown>\n  /**\n   * Target namespace the invoke addressed; forward the call here to stay in the\n   * caller's namespace. Absent → the engine's default namespace.\n   */\n  namespace?: string\n}\n\n/**\n * Request object passed to {@link IIIClient.trigger}.\n *\n * @typeParam TInput - Type of the payload.\n */\n/**\n * A `function_id` accepted wherever a target function is named: a bare string,\n * or a ref (e.g. a `FunctionRef` from `registerFunction`) carrying the namespace\n * where the function was registered. When a ref is passed, its namespace is used\n * for routing unless an explicit `namespace` overrides it.\n */\nexport type FunctionTarget = string | { function_id: string; namespace?: string }\n\nexport type TriggerRequest<TInput = unknown> = {\n  /** ID of the function to invoke, or a ref carrying its namespace. */\n  function_id: FunctionTarget\n  /** Input data passed to the function. */\n  payload: TInput\n  /** Sets how the trigger is routed. Omit for a synchronous request/response. Specify for a specific routing scheme (e.g. `TriggerAction.Enqueue()`, `TriggerAction.Void()`). */\n  action?: TriggerAction\n  /** Override the default invocation timeout, in milliseconds. */\n  timeoutMs?: number\n  /** Arbitrary user-specifiable metadata supplied to the triggered handler function on every invocation. */\n  metadata?: unknown\n  /**\n   * Target namespace for routing. Omit to route within the engine's default\n   * namespace. Serialized into the {@link InvokeFunctionMessage} `namespace`\n   * field; omitted from the wire when undefined.\n   */\n  namespace?: string\n}\n\nexport type InvokeFunctionMessage = {\n  message_type: MessageType.InvokeFunction\n  /**\n   * This is optional for async invocations\n   */\n  invocation_id?: string\n  /**\n   * The path of the function.\n   */\n  function_id: string\n  /**\n   * The data to pass to the function\n   */\n  data: unknown\n  /**\n   * W3C trace-context traceparent header for distributed tracing\n   */\n  traceparent?: string\n  /**\n   * W3C baggage header for cross-cutting context propagation\n   */\n  baggage?: string\n  /**\n   * Trigger action for queue routing or fire-and-forget\n   */\n  action?: TriggerAction\n  /**\n   * Optional per-invocation metadata (arbitrary JSON). Travels as a separate\n   * channel from `data`. Omitted from the JSON when undefined; absence on\n   * inbound means \"no metadata\" (backward compatible with older engines).\n   */\n  metadata?: JsonValue\n  /**\n   * Target namespace for routing. Optional and additive: omitted from the JSON\n   * when undefined, and absence on inbound means the engine's default\n   * namespace (backward compatible with older engines).\n   */\n  namespace?: string\n}\n\nexport type InvocationResultMessage = {\n  message_type: MessageType.InvocationResult\n  /**\n   * The id of the invocation\n   */\n  invocation_id: string\n  /**\n   * The path of the function.\n   */\n  function_id: string\n  result?: unknown\n  error?: unknown\n  /**\n   * W3C trace-context traceparent header for distributed tracing\n   */\n  traceparent?: string\n  /**\n   * W3C baggage header for cross-cutting context propagation\n   */\n  baggage?: string\n}\n\nexport type WorkerRegisteredMessage = {\n  message_type: MessageType.WorkerRegistered\n  worker_id: string\n  /** Secret to present in a reattach frame on reconnect; absent on older engines. */\n  reattach_token?: string\n}\n\n/**\n * Sent by the engine when this worker's registration collides with a live\n * worker in `namespace`. The `code` decides severity:\n *\n * - `WORKER_NAMESPACE_CONFLICT`: another worker already holds this\n *   `(namespace, worker_name)`. The engine closes the connection -- fatal: the\n *   SDK stops the worker and does not reconnect.\n * - `FUNCTION_NAMESPACE_CONFLICT`: another worker already exports this one\n *   function id (carried in `worker_name`). The engine keeps the connection\n *   open -- non-fatal: only that registration is refused and the worker keeps\n *   serving its other functions.\n */\nexport type RegistrationRejectedMessage = {\n  message_type: MessageType.RegistrationRejected\n  /** Machine-readable rejection code (`WORKER_NAMESPACE_CONFLICT` | `FUNCTION_NAMESPACE_CONFLICT`). */\n  code: string\n  /** Namespace in which the collision occurred. */\n  namespace: string\n  /** The contested identity: the worker name, or (FUNCTION conflict) the function id. */\n  worker_name: string\n  /** ID of the live worker that already owns the contested identity. */\n  owner_worker_id: string\n}\n\nexport type UnregisterFunctionMessage = {\n  message_type: MessageType.UnregisterFunction\n  id: string\n}\n\n/**\n * Serializable reference to one end of a streaming channel. Can be included\n * in invocation payloads to pass channel endpoints between workers.\n */\nexport type StreamChannelRef = {\n  /** Unique channel identifier. */\n  channel_id: string\n  /** Access key for authentication. */\n  access_key: string\n  /** Whether this ref is for reading or writing. */\n  direction: 'read' | 'write'\n}\n\nexport type IIIMessage =\n  | RegisterFunctionMessage\n  | UnregisterFunctionMessage\n  | InvokeFunctionMessage\n  | InvocationResultMessage\n  | RegisterTriggerMessage\n  | RegisterTriggerTypeMessage\n  | UnregisterTriggerMessage\n  | UnregisterTriggerTypeMessage\n  | TriggerRegistrationResultMessage\n  | WorkerRegisteredMessage\n  | RegistrationRejectedMessage\n"],"mappings":";AAeA,IAAY,cAAL;AACL;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;KACD"}
+{"version":3,"file":"iii-types-Btz-0RpP.mjs","names":[],"sources":["../src/iii-types.ts"],"sourcesContent":["import type { HttpInvocationConfig } from '@iii-dev/helpers/http'\n\n/**\n * Any JSON value: the TypeScript equivalent of the engine's arbitrary-JSON\n * wire values (Rust `serde_json::Value`). Used where the wire contract is\n * \"any JSON\", e.g. per-invocation `metadata`.\n */\nexport type JsonValue =\n  | string\n  | number\n  | boolean\n  | null\n  | JsonValue[]\n  | { [key: string]: JsonValue }\n\nexport enum MessageType {\n  RegisterFunction = 'registerfunction',\n  UnregisterFunction = 'unregisterfunction',\n  InvokeFunction = 'invokefunction',\n  InvocationResult = 'invocationresult',\n  RegisterTriggerType = 'registertriggertype',\n  RegisterTrigger = 'registertrigger',\n  UnregisterTrigger = 'unregistertrigger',\n  UnregisterTriggerType = 'unregistertriggertype',\n  TriggerRegistrationResult = 'triggerregistrationresult',\n  WorkerRegistered = 'workerregistered',\n  RegistrationRejected = 'registrationrejected',\n  Reattach = 'reattach',\n}\n\nexport type RegisterTriggerTypeMessage = {\n  message_type: MessageType.RegisterTriggerType\n  /** Unique identifier for the trigger type (e.g. `state`, `durable:subscriber`). */\n  id: string\n  /** Human-readable description of what this trigger type does. */\n  description: string\n}\n\nexport type UnregisterTriggerTypeMessage = {\n  message_type: MessageType.UnregisterTriggerType\n  id: string\n}\n\nexport type UnregisterTriggerMessage = {\n  message_type: MessageType.UnregisterTrigger\n  id: string\n  type?: string\n}\n\nexport type ErrorBody = {\n  code: string\n  message: string\n  stacktrace?: string\n}\n\nexport type TriggerRegistrationResultMessage = {\n  message_type: MessageType.TriggerRegistrationResult\n  id: string\n  type: string\n  function_id: string\n  error?: ErrorBody\n}\n\nexport type RegisterTriggerMessage = {\n  /** Wire discriminator; always `MessageType.RegisterTrigger`. */\n  message_type: MessageType.RegisterTrigger\n  /** Unique trigger identifier, generated by the SDK during registration. */\n  id: string\n  /** Identifier of the registered trigger type this trigger uses (e.g. `storage::object-created`, `http`). */\n  type: string\n  /** ID of the function this trigger invokes when it fires. */\n  function_id: string\n  /** Trigger-type-specific configuration, matching the shape the trigger type expects. */\n  config: unknown\n  /** Arbitrary user-specifiable metadata supplied to the triggered handler function on every invocation. */\n  metadata?: Record<string, unknown>\n  /**\n   * Namespace the trigger's target function resolves in. Omit for the engine's\n   * default namespace, independent of this connection's namespace.\n   */\n  namespace?: string\n}\n\nexport type RegisterFunctionFormat = {\n  /**\n   * The name of the parameter.\n   */\n  name?: string\n  /**\n   * The description of the parameter.\n   */\n  description?: string\n  /**\n   * The type of the parameter.\n   */\n  type?: 'string' | 'number' | 'boolean' | 'object' | 'array' | 'null' | 'map' | 'integer'\n  /**\n   * The body of the parameter (for objects).\n   */\n  properties?: Record<string, unknown>\n  /**\n   * The items of the parameter (for arrays).\n   */\n  items?: unknown\n  /**\n   * Whether the parameter is required.\n   */\n  required?: string[]\n  [key: string]: unknown\n}\n\nexport type RegisterFunctionMessage = {\n  message_type: MessageType.RegisterFunction\n  /**\n   * The path of the function (use :: for namespacing, e.g. external::my_lambda).\n   */\n  id: string\n  /**\n   * The description of the function.\n   */\n  description?: string\n  /**\n   * The request format of the function.\n   */\n  request_format?: RegisterFunctionFormat\n  /**\n   * The response format of the function.\n   */\n  response_format?: RegisterFunctionFormat\n  /**\n   * Arbitrary metadata attached to the function.\n   */\n  metadata?: Record<string, unknown>\n  /**\n   * HTTP invocation config for external HTTP functions (Lambda, Cloudflare Workers, etc.).\n   */\n  invocation?: HttpInvocationConfig\n}\n\n/**\n * Routing action for {@link TriggerRequest}. Determines how the engine\n * handles the invocation.\n *\n * - `enqueue`: Routes through a named queue for async processing.\n * - `void`: Fire-and-forget, no response.\n */\nexport type TriggerAction = { type: 'enqueue'; queue: string } | { type: 'void' }\n\n/**\n * Input passed to the RBAC middleware function on every function invocation\n * through the RBAC port. The middleware can inspect, modify, or reject the\n * call before it reaches the target function.\n */\nexport type MiddlewareFunctionInput = {\n  /** ID of the function being invoked. */\n  function_id: string\n  /** Payload sent by the caller. */\n  payload: Record<string, unknown>\n  /** Routing action, if any. */\n  action?: TriggerAction\n  /** Auth context returned by the auth function for this session. */\n  context: Record<string, unknown>\n  /**\n   * Target namespace the invoke addressed; forward the call here to stay in the\n   * caller's namespace. Absent → the engine's default namespace.\n   */\n  namespace?: string\n}\n\n/**\n * Request object passed to {@link IIIClient.trigger}.\n *\n * @typeParam TInput - Type of the payload.\n */\nexport type TriggerRequest<TInput = unknown> = {\n  /** ID of the function to invoke. */\n  function_id: string\n  /** Input data passed to the function. */\n  payload: TInput\n  /** Sets how the trigger is routed. Omit for a synchronous request/response. Specify for a specific routing scheme (e.g. `TriggerAction.Enqueue()`, `TriggerAction.Void()`). */\n  action?: TriggerAction\n  /** Override the default invocation timeout, in milliseconds. */\n  timeoutMs?: number\n  /** Arbitrary user-specifiable metadata supplied to the triggered handler function on every invocation. */\n  metadata?: unknown\n  /**\n   * Target namespace for routing. Omit to route within the engine's default\n   * namespace. Serialized into the {@link InvokeFunctionMessage} `namespace`\n   * field; omitted from the wire when undefined.\n   */\n  namespace?: string\n}\n\nexport type InvokeFunctionMessage = {\n  message_type: MessageType.InvokeFunction\n  /**\n   * This is optional for async invocations\n   */\n  invocation_id?: string\n  /**\n   * The path of the function.\n   */\n  function_id: string\n  /**\n   * The data to pass to the function\n   */\n  data: unknown\n  /**\n   * W3C trace-context traceparent header for distributed tracing\n   */\n  traceparent?: string\n  /**\n   * W3C baggage header for cross-cutting context propagation\n   */\n  baggage?: string\n  /**\n   * Trigger action for queue routing or fire-and-forget\n   */\n  action?: TriggerAction\n  /**\n   * Optional per-invocation metadata (arbitrary JSON). Travels as a separate\n   * channel from `data`. Omitted from the JSON when undefined; absence on\n   * inbound means \"no metadata\" (backward compatible with older engines).\n   */\n  metadata?: JsonValue\n  /**\n   * Target namespace for routing. Optional and additive: omitted from the JSON\n   * when undefined, and absence on inbound means the engine's default\n   * namespace (backward compatible with older engines).\n   */\n  namespace?: string\n}\n\nexport type InvocationResultMessage = {\n  message_type: MessageType.InvocationResult\n  /**\n   * The id of the invocation\n   */\n  invocation_id: string\n  /**\n   * The path of the function.\n   */\n  function_id: string\n  result?: unknown\n  error?: unknown\n  /**\n   * W3C trace-context traceparent header for distributed tracing\n   */\n  traceparent?: string\n  /**\n   * W3C baggage header for cross-cutting context propagation\n   */\n  baggage?: string\n}\n\nexport type WorkerRegisteredMessage = {\n  message_type: MessageType.WorkerRegistered\n  worker_id: string\n  /** Secret to present in a reattach frame on reconnect; absent on older engines. */\n  reattach_token?: string\n}\n\n/**\n * Sent by the engine when this worker's registration collides with a live\n * worker in `namespace`. The `code` decides severity:\n *\n * - `WORKER_NAMESPACE_CONFLICT`: another worker already holds this\n *   `(namespace, worker_name)`. The engine closes the connection -- fatal: the\n *   SDK stops the worker and does not reconnect.\n * - `FUNCTION_NAMESPACE_CONFLICT`: another worker already exports this one\n *   function id (carried in `worker_name`). The engine keeps the connection\n *   open -- non-fatal: only that registration is refused and the worker keeps\n *   serving its other functions.\n */\nexport type RegistrationRejectedMessage = {\n  message_type: MessageType.RegistrationRejected\n  /** Machine-readable rejection code (`WORKER_NAMESPACE_CONFLICT` | `FUNCTION_NAMESPACE_CONFLICT`). */\n  code: string\n  /** Namespace in which the collision occurred. */\n  namespace: string\n  /** The contested identity: the worker name, or (FUNCTION conflict) the function id. */\n  worker_name: string\n  /** ID of the live worker that already owns the contested identity. */\n  owner_worker_id: string\n}\n\nexport type UnregisterFunctionMessage = {\n  message_type: MessageType.UnregisterFunction\n  id: string\n}\n\n/**\n * Serializable reference to one end of a streaming channel. Can be included\n * in invocation payloads to pass channel endpoints between workers.\n */\nexport type StreamChannelRef = {\n  /** Unique channel identifier. */\n  channel_id: string\n  /** Access key for authentication. */\n  access_key: string\n  /** Whether this ref is for reading or writing. */\n  direction: 'read' | 'write'\n}\n\nexport type IIIMessage =\n  | RegisterFunctionMessage\n  | UnregisterFunctionMessage\n  | InvokeFunctionMessage\n  | InvocationResultMessage\n  | RegisterTriggerMessage\n  | RegisterTriggerTypeMessage\n  | UnregisterTriggerMessage\n  | UnregisterTriggerTypeMessage\n  | TriggerRegistrationResultMessage\n  | WorkerRegisteredMessage\n  | RegistrationRejectedMessage\n"],"mappings":";AAeA,IAAY,cAAL;AACL;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;KACD"}

package/dist/index.cjs

@@ -34,23 +34,24 @@ 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;
 }
-/**
-* Normalizes a `function_id` that may be a bare string or a {@link FunctionRef}.
-* A ref carries the namespace where the function was registered, so triggers and
-* invocations can target it without the caller restating the namespace.
-*/
-function resolveFunctionTarget(fn) {
-	return typeof fn === "string" ? { function_id: fn } : {
-		function_id: fn.function_id,
-		namespace: fn.namespace
-	};
-}
-var Sdk = class Sdk {
+var Sdk = class {
 	constructor(address, options) {
 		this.address = address;
 		this.options = options;
@@ -62,7 +63,6 @@ var Sdk = class Sdk {
 		this.reconnectAttempt = 0;
 		this.connectionState = "disconnected";
 		this.isShuttingDown = false;
-		this.namespaceViews = /* @__PURE__ */ new Map();
 		this.registerTriggerType = (triggerType, handler) => {
 			this.sendMessage(require_iii_types.MessageType.RegisterTriggerType, triggerType, true);
 			this.triggerTypes.set(triggerType.id, {
@@ -79,16 +79,18 @@ var Sdk = class Sdk {
 						type: triggerType.id,
 						function_id: functionId,
 						config,
-						metadata
+						metadata,
+						namespace: this.namespace
 					});
 				},
 				registerFunction: (functionId, handler, config, metadata) => {
 					const ref = this.registerFunction(functionId, handler);
 					this.registerTrigger({
 						type: triggerType.id,
-						function_id: ref,
+						function_id: functionId,
 						config,
-						metadata
+						metadata,
+						namespace: this.namespace
 					});
 					return ref;
 				},
@@ -103,12 +105,8 @@ var Sdk = class Sdk {
 		};
 		this.registerTrigger = (trigger) => {
 			const id = crypto.randomUUID();
-			const target = resolveFunctionTarget(trigger.function_id);
-			const namespace = trigger.namespace ?? target.namespace ?? this.namespace;
 			const fullTrigger = {
 				...trigger,
-				function_id: target.function_id,
-				...namespace !== void 0 ? { namespace } : {},
 				id,
 				message_type: require_iii_types.MessageType.RegisterTrigger
 			};
@@ -199,8 +197,6 @@ var Sdk = class Sdk {
 			} else this.functions.set(functionId, { message: fullMessage });
 			return {
 				id: functionId,
-				function_id: functionId,
-				namespace: this.namespace,
 				unregister: () => {
 					this.sendMessage(require_iii_types.MessageType.UnregisterFunction, { id: functionId }, true);
 					this.functions.delete(functionId);
@@ -211,7 +207,7 @@ var Sdk = class Sdk {
 			const result = await this.trigger({
 				function_id: "engine::channels::create",
 				payload: { buffer_size: bufferSize }
-			}, { routeToDefault: true });
+			});
 			return {
 				writer: new require_channels.ChannelWriter(this.address, result.writer),
 				reader: new require_channels.ChannelReader(this.address, result.reader),
@@ -219,11 +215,8 @@ var Sdk = class Sdk {
 				readerRef: result.reader
 			};
 		};
-		this.trigger = async (request, opts) => {
-			const { function_id: functionTarget, payload, action, timeoutMs, metadata, namespace: explicitNamespace } = request;
-			const target = resolveFunctionTarget(functionTarget);
-			const function_id = target.function_id;
-			const namespace = opts?.routeToDefault ? explicitNamespace : explicitNamespace ?? target.namespace ?? this.namespace;
+		this.trigger = async (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)();
@@ -277,17 +270,6 @@ var Sdk = class Sdk {
 				});
 			});
 		};
-		this.useNamespace = (namespace) => {
-			if (namespace === (this.namespace ?? "default")) return this;
-			const cached = this.namespaceViews.get(namespace);
-			if (cached) return cached;
-			const view = new Sdk(this.address, {
-				...this.options,
-				namespace
-			});
-			this.namespaceViews.set(namespace, view);
-			return view;
-		};
 		this.__helpers_create_stream = (streamName, stream) => {
 			this.registerFunction(`stream::get(${streamName})`, stream.get.bind(stream));
 			this.registerFunction(`stream::set(${streamName})`, stream.set.bind(stream));
@@ -296,12 +278,10 @@ var Sdk = class Sdk {
 			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;
-			const views = [...this.namespaceViews.values()];
-			this.namespaceViews.clear();
-			await Promise.all(views.map((view) => view.shutdown()));
 			this.stopMetricsReporting();
 			await (0, _iii_dev_helpers_observability.shutdownOtel)();
 			this.clearReconnectTimeout();
@@ -358,7 +338,7 @@ var Sdk = class Sdk {
 				}
 			},
 			action: { type: "void" }
-		}, { routeToDefault: true });
+		});
 	}
 	setConnectionState(state) {
 		if (this.connectionState !== state) this.connectionState = state;
@@ -816,7 +796,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.
 *
@@ -824,14 +805,17 @@ 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;