iii-sdk 0.21.8-next.4 → 0.22.0-alpha.1

package/dist/channel.d.cts

@@ -1,2 +1,2 @@
-import { O as StreamChannelRef, t as Channel, v as ChannelReader, y as ChannelWriter } from "./types-n-760A15.cjs";
+import { C as ChannelWriter, M as StreamChannelRef, S as ChannelReader, t as Channel } from "./types-Co4Q4P8p.cjs";
 export { type Channel, ChannelReader, ChannelWriter, type StreamChannelRef };

package/dist/channel.d.mts

@@ -1,2 +1,2 @@
-import { O as StreamChannelRef, t as Channel, v as ChannelReader, y as ChannelWriter } from "./types-BD2fp4Py.mjs";
+import { C as ChannelWriter, M as StreamChannelRef, S as ChannelReader, t as Channel } from "./types-DEEbuJE1.mjs";
 export { type Channel, ChannelReader, ChannelWriter, type StreamChannelRef };

package/dist/engine.d.cts

@@ -1,3 +1,2 @@
-import { l as RemoteFunctionHandler } from "./types-n-760A15.cjs";
-import { n as EngineTriggers, t as EngineFunctions } from "./iii-constants-BqXp8xSN.cjs";
+import { _ as EngineTriggers, g as EngineFunctions, l as RemoteFunctionHandler } from "./types-Co4Q4P8p.cjs";
 export { EngineFunctions, EngineTriggers, type RemoteFunctionHandler };

package/dist/engine.d.mts

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

package/dist/errors-CKW836UA.d.cts

@@ -0,0 +1,62 @@
+//#region src/errors.d.ts
+/**
+ * Typed error surfaced when an invocation dispatched over the SDK fails, RBAC
+ * rejection (FORBIDDEN), handler-level failure, or a timeout waiting for the
+ * engine to respond. Wraps the wire `ErrorBody` shape plus the `function_id`
+ * that was targeted, so callers get a single error type across all failure
+ * modes and can disambiguate via `err.code`.
+ *
+ * Before this existed, rejection values were plain `ErrorBody`-shaped objects,
+ * which printed as `[object Object]` when stringified, leaving developers to
+ * grep through SDK source to figure out what tripped. The class name, `code`
+ * prefix in the message, and `function_id` field together make a rejection
+ * self-describing.
+ */
+type InvocationErrorInit = {
+  code: string;
+  message: string;
+  function_id?: string;
+  stacktrace?: string;
+};
+declare class InvocationError extends Error {
+  readonly code: string;
+  readonly function_id?: string;
+  readonly stacktrace?: string;
+  constructor(init: InvocationErrorInit);
+}
+/**
+ * Fatal error surfaced when the engine rejects this worker's registration with
+ * a `registrationrejected` message: another live worker already owns this
+ * `worker_name` (or an exported function id) in the target `namespace`. The
+ * engine closes the connection on rejection, so this is terminal -- the SDK
+ * stops the worker and does not reconnect. Carries the wire fields
+ * (`code`, `namespace`, `worker_name`, `owner_worker_id`) so callers can tell
+ * exactly which identity collided and with whom.
+ */
+type RegistrationRejectedInit = {
+  code: string;
+  namespace: string;
+  worker_name: string;
+  owner_worker_id: string;
+};
+declare class RegistrationRejectedError extends Error {
+  readonly code: string;
+  readonly namespace: string;
+  readonly worker_name: string;
+  readonly owner_worker_id: string;
+  constructor(init: RegistrationRejectedInit);
+}
+/**
+ * True when `value` looks like the wire `ErrorBody` the engine sends in
+ * `InvocationResult.error`: `{ code: string, message: string, stacktrace?: string }`.
+ * Used to distinguish an engine rejection (which we wrap in
+ * {@link InvocationError}) from a JS `Error` thrown elsewhere.
+ */
+declare function isErrorBody(value: unknown): value is {
+  code: string;
+  message: string;
+  stacktrace?: string;
+};
+//#endregion
+export { isErrorBody as a, RegistrationRejectedInit as i, InvocationErrorInit as n, RegistrationRejectedError as r, InvocationError as t };
+//# sourceMappingURL=errors-CKW836UA.d.cts.map

package/dist/errors-CKW836UA.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors-CKW836UA.d.cts","names":[],"sources":["../src/errors.ts"],"mappings":";;AAaA;;;;;;;;;;AAOA;;KAPY,mBAAA;EACV,IAAA;EACA,OAAA;EACA,WAAA;EACA,UAAA;AAAA;AAAA,cAGW,eAAA,SAAwB,KAAA;EAAA,SACnB,IAAA;EAAA,SACA,WAAA;EAAA,SACA,UAAA;cAEJ,IAAA,EAAM,mBAAA;AAAA;;;;;;;;;;KAkBR,wBAAA;EACV,IAAA;EACA,SAAA;EACA,WAAA;EACA,eAAA;AAAA;AAAA,cAGW,yBAAA,SAAkC,KAAA;EAAA,SAC7B,IAAA;EAAA,SACA,SAAA;EAAA,SACA,WAAA;EAAA,SACA,eAAA;cAEJ,IAAA,EAAM,wBAAA;AAAA;;AAkBpB;;;;;iBAAgB,WAAA,CAAY,KAAA,YAAiB,KAAA;EAC3C,IAAA;EACA,OAAA;EACA,UAAA;AAAA"}

package/dist/errors-DQVZBqCr.d.mts

@@ -0,0 +1,62 @@
+//#region src/errors.d.ts
+/**
+ * Typed error surfaced when an invocation dispatched over the SDK fails, RBAC
+ * rejection (FORBIDDEN), handler-level failure, or a timeout waiting for the
+ * engine to respond. Wraps the wire `ErrorBody` shape plus the `function_id`
+ * that was targeted, so callers get a single error type across all failure
+ * modes and can disambiguate via `err.code`.
+ *
+ * Before this existed, rejection values were plain `ErrorBody`-shaped objects,
+ * which printed as `[object Object]` when stringified, leaving developers to
+ * grep through SDK source to figure out what tripped. The class name, `code`
+ * prefix in the message, and `function_id` field together make a rejection
+ * self-describing.
+ */
+type InvocationErrorInit = {
+  code: string;
+  message: string;
+  function_id?: string;
+  stacktrace?: string;
+};
+declare class InvocationError extends Error {
+  readonly code: string;
+  readonly function_id?: string;
+  readonly stacktrace?: string;
+  constructor(init: InvocationErrorInit);
+}
+/**
+ * Fatal error surfaced when the engine rejects this worker's registration with
+ * a `registrationrejected` message: another live worker already owns this
+ * `worker_name` (or an exported function id) in the target `namespace`. The
+ * engine closes the connection on rejection, so this is terminal -- the SDK
+ * stops the worker and does not reconnect. Carries the wire fields
+ * (`code`, `namespace`, `worker_name`, `owner_worker_id`) so callers can tell
+ * exactly which identity collided and with whom.
+ */
+type RegistrationRejectedInit = {
+  code: string;
+  namespace: string;
+  worker_name: string;
+  owner_worker_id: string;
+};
+declare class RegistrationRejectedError extends Error {
+  readonly code: string;
+  readonly namespace: string;
+  readonly worker_name: string;
+  readonly owner_worker_id: string;
+  constructor(init: RegistrationRejectedInit);
+}
+/**
+ * True when `value` looks like the wire `ErrorBody` the engine sends in
+ * `InvocationResult.error`: `{ code: string, message: string, stacktrace?: string }`.
+ * Used to distinguish an engine rejection (which we wrap in
+ * {@link InvocationError}) from a JS `Error` thrown elsewhere.
+ */
+declare function isErrorBody(value: unknown): value is {
+  code: string;
+  message: string;
+  stacktrace?: string;
+};
+//#endregion
+export { isErrorBody as a, RegistrationRejectedInit as i, InvocationErrorInit as n, RegistrationRejectedError as r, InvocationError as t };
+//# sourceMappingURL=errors-DQVZBqCr.d.mts.map

package/dist/errors-DQVZBqCr.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors-DQVZBqCr.d.mts","names":[],"sources":["../src/errors.ts"],"mappings":";;AAaA;;;;;;;;;;AAOA;;KAPY,mBAAA;EACV,IAAA;EACA,OAAA;EACA,WAAA;EACA,UAAA;AAAA;AAAA,cAGW,eAAA,SAAwB,KAAA;EAAA,SACnB,IAAA;EAAA,SACA,WAAA;EAAA,SACA,UAAA;cAEJ,IAAA,EAAM,mBAAA;AAAA;;;;;;;;;;KAkBR,wBAAA;EACV,IAAA;EACA,SAAA;EACA,WAAA;EACA,eAAA;AAAA;AAAA,cAGW,yBAAA,SAAkC,KAAA;EAAA,SAC7B,IAAA;EAAA,SACA,SAAA;EAAA,SACA,WAAA;EAAA,SACA,eAAA;cAEJ,IAAA,EAAM,wBAAA;AAAA;;AAkBpB;;;;;iBAAgB,WAAA,CAAY,KAAA,YAAiB,KAAA;EAC3C,IAAA;EACA,OAAA;EACA,UAAA;AAAA"}

package/dist/errors.cjs

@@ -10,6 +10,16 @@ var InvocationError = class extends Error {
 		this.stacktrace = init.stacktrace;
 	}
 };
+var RegistrationRejectedError = class extends Error {
+	constructor(init) {
+		super(`${init.code}: registration rejected for worker "${init.worker_name}" in namespace "${init.namespace}" (already owned by worker ${init.owner_worker_id})`);
+		this.name = "RegistrationRejectedError";
+		this.code = init.code;
+		this.namespace = init.namespace;
+		this.worker_name = init.worker_name;
+		this.owner_worker_id = init.owner_worker_id;
+	}
+};
 /**
 * True when `value` looks like the wire `ErrorBody` the engine sends in
 * `InvocationResult.error`: `{ code: string, message: string, stacktrace?: string }`.
@@ -24,5 +34,6 @@ function isErrorBody(value) {
 
 //#endregion
 exports.InvocationError = InvocationError;
+exports.RegistrationRejectedError = RegistrationRejectedError;
 exports.isErrorBody = isErrorBody;
 //# sourceMappingURL=errors.cjs.map

package/dist/errors.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"errors.cjs","names":[],"sources":["../src/errors.ts"],"sourcesContent":["/**\n * Typed error surfaced when an invocation dispatched over the SDK fails, RBAC\n * rejection (FORBIDDEN), handler-level failure, or a timeout waiting for the\n * engine to respond. Wraps the wire `ErrorBody` shape plus the `function_id`\n * that was targeted, so callers get a single error type across all failure\n * modes and can disambiguate via `err.code`.\n *\n * Before this existed, rejection values were plain `ErrorBody`-shaped objects,\n * which printed as `[object Object]` when stringified, leaving developers to\n * grep through SDK source to figure out what tripped. The class name, `code`\n * prefix in the message, and `function_id` field together make a rejection\n * self-describing.\n */\nexport type InvocationErrorInit = {\n  code: string\n  message: string\n  function_id?: string\n  stacktrace?: string\n}\n\nexport class InvocationError extends Error {\n  public readonly code: string\n  public readonly function_id?: string\n  public readonly stacktrace?: string\n\n  constructor(init: InvocationErrorInit) {\n    super(`${init.code}: ${init.message}`)\n    this.name = 'InvocationError'\n    this.code = init.code\n    this.function_id = init.function_id\n    this.stacktrace = init.stacktrace\n  }\n}\n\n/**\n * True when `value` looks like the wire `ErrorBody` the engine sends in\n * `InvocationResult.error`: `{ code: string, message: string, stacktrace?: string }`.\n * Used to distinguish an engine rejection (which we wrap in\n * {@link InvocationError}) from a JS `Error` thrown elsewhere.\n */\nexport function isErrorBody(value: unknown): value is {\n  code: string\n  message: string\n  stacktrace?: string\n} {\n  if (typeof value !== 'object' || value === null) return false\n  const v = value as { code?: unknown; message?: unknown; stacktrace?: unknown }\n  return (\n    typeof v.code === 'string' &&\n    typeof v.message === 'string' &&\n    (v.stacktrace === undefined || typeof v.stacktrace === 'string')\n  )\n}\n"],"mappings":";;;AAoBA,IAAa,kBAAb,cAAqC,MAAM;CAKzC,YAAY,MAA2B;AACrC,QAAM,GAAG,KAAK,KAAK,IAAI,KAAK,UAAU;AACtC,OAAK,OAAO;AACZ,OAAK,OAAO,KAAK;AACjB,OAAK,cAAc,KAAK;AACxB,OAAK,aAAa,KAAK;;;;;;;;;AAU3B,SAAgB,YAAY,OAI1B;AACA,KAAI,OAAO,UAAU,YAAY,UAAU,KAAM,QAAO;CACxD,MAAM,IAAI;AACV,QACE,OAAO,EAAE,SAAS,YAClB,OAAO,EAAE,YAAY,aACpB,EAAE,eAAe,UAAa,OAAO,EAAE,eAAe"}
+{"version":3,"file":"errors.cjs","names":[],"sources":["../src/errors.ts"],"sourcesContent":["/**\n * Typed error surfaced when an invocation dispatched over the SDK fails, RBAC\n * rejection (FORBIDDEN), handler-level failure, or a timeout waiting for the\n * engine to respond. Wraps the wire `ErrorBody` shape plus the `function_id`\n * that was targeted, so callers get a single error type across all failure\n * modes and can disambiguate via `err.code`.\n *\n * Before this existed, rejection values were plain `ErrorBody`-shaped objects,\n * which printed as `[object Object]` when stringified, leaving developers to\n * grep through SDK source to figure out what tripped. The class name, `code`\n * prefix in the message, and `function_id` field together make a rejection\n * self-describing.\n */\nexport type InvocationErrorInit = {\n  code: string\n  message: string\n  function_id?: string\n  stacktrace?: string\n}\n\nexport class InvocationError extends Error {\n  public readonly code: string\n  public readonly function_id?: string\n  public readonly stacktrace?: string\n\n  constructor(init: InvocationErrorInit) {\n    super(`${init.code}: ${init.message}`)\n    this.name = 'InvocationError'\n    this.code = init.code\n    this.function_id = init.function_id\n    this.stacktrace = init.stacktrace\n  }\n}\n\n/**\n * Fatal error surfaced when the engine rejects this worker's registration with\n * a `registrationrejected` message: another live worker already owns this\n * `worker_name` (or an exported function id) in the target `namespace`. The\n * engine closes the connection on rejection, so this is terminal -- the SDK\n * stops the worker and does not reconnect. Carries the wire fields\n * (`code`, `namespace`, `worker_name`, `owner_worker_id`) so callers can tell\n * exactly which identity collided and with whom.\n */\nexport type RegistrationRejectedInit = {\n  code: string\n  namespace: string\n  worker_name: string\n  owner_worker_id: string\n}\n\nexport class RegistrationRejectedError extends Error {\n  public readonly code: string\n  public readonly namespace: string\n  public readonly worker_name: string\n  public readonly owner_worker_id: string\n\n  constructor(init: RegistrationRejectedInit) {\n    super(\n      `${init.code}: registration rejected for worker \"${init.worker_name}\" in namespace \"${init.namespace}\" (already owned by worker ${init.owner_worker_id})`,\n    )\n    this.name = 'RegistrationRejectedError'\n    this.code = init.code\n    this.namespace = init.namespace\n    this.worker_name = init.worker_name\n    this.owner_worker_id = init.owner_worker_id\n  }\n}\n\n/**\n * True when `value` looks like the wire `ErrorBody` the engine sends in\n * `InvocationResult.error`: `{ code: string, message: string, stacktrace?: string }`.\n * Used to distinguish an engine rejection (which we wrap in\n * {@link InvocationError}) from a JS `Error` thrown elsewhere.\n */\nexport function isErrorBody(value: unknown): value is {\n  code: string\n  message: string\n  stacktrace?: string\n} {\n  if (typeof value !== 'object' || value === null) return false\n  const v = value as { code?: unknown; message?: unknown; stacktrace?: unknown }\n  return (\n    typeof v.code === 'string' &&\n    typeof v.message === 'string' &&\n    (v.stacktrace === undefined || typeof v.stacktrace === 'string')\n  )\n}\n"],"mappings":";;;AAoBA,IAAa,kBAAb,cAAqC,MAAM;CAKzC,YAAY,MAA2B;AACrC,QAAM,GAAG,KAAK,KAAK,IAAI,KAAK,UAAU;AACtC,OAAK,OAAO;AACZ,OAAK,OAAO,KAAK;AACjB,OAAK,cAAc,KAAK;AACxB,OAAK,aAAa,KAAK;;;AAoB3B,IAAa,4BAAb,cAA+C,MAAM;CAMnD,YAAY,MAAgC;AAC1C,QACE,GAAG,KAAK,KAAK,sCAAsC,KAAK,YAAY,kBAAkB,KAAK,UAAU,6BAA6B,KAAK,gBAAgB,GACxJ;AACD,OAAK,OAAO;AACZ,OAAK,OAAO,KAAK;AACjB,OAAK,YAAY,KAAK;AACtB,OAAK,cAAc,KAAK;AACxB,OAAK,kBAAkB,KAAK;;;;;;;;;AAUhC,SAAgB,YAAY,OAI1B;AACA,KAAI,OAAO,UAAU,YAAY,UAAU,KAAM,QAAO;CACxD,MAAM,IAAI;AACV,QACE,OAAO,EAAE,SAAS,YAClB,OAAO,EAAE,YAAY,aACpB,EAAE,eAAe,UAAa,OAAO,EAAE,eAAe"}

package/dist/errors.d.cts

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

package/dist/errors.d.mts

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

package/dist/errors.mjs

@@ -8,6 +8,16 @@ var InvocationError = class extends Error {
 		this.stacktrace = init.stacktrace;
 	}
 };
+var RegistrationRejectedError = class extends Error {
+	constructor(init) {
+		super(`${init.code}: registration rejected for worker "${init.worker_name}" in namespace "${init.namespace}" (already owned by worker ${init.owner_worker_id})`);
+		this.name = "RegistrationRejectedError";
+		this.code = init.code;
+		this.namespace = init.namespace;
+		this.worker_name = init.worker_name;
+		this.owner_worker_id = init.owner_worker_id;
+	}
+};
 /**
 * True when `value` looks like the wire `ErrorBody` the engine sends in
 * `InvocationResult.error`: `{ code: string, message: string, stacktrace?: string }`.
@@ -21,5 +31,5 @@ function isErrorBody(value) {
 }
 
 //#endregion
-export { InvocationError, isErrorBody };
+export { InvocationError, RegistrationRejectedError, isErrorBody };
 //# sourceMappingURL=errors.mjs.map

package/dist/errors.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"errors.mjs","names":[],"sources":["../src/errors.ts"],"sourcesContent":["/**\n * Typed error surfaced when an invocation dispatched over the SDK fails, RBAC\n * rejection (FORBIDDEN), handler-level failure, or a timeout waiting for the\n * engine to respond. Wraps the wire `ErrorBody` shape plus the `function_id`\n * that was targeted, so callers get a single error type across all failure\n * modes and can disambiguate via `err.code`.\n *\n * Before this existed, rejection values were plain `ErrorBody`-shaped objects,\n * which printed as `[object Object]` when stringified, leaving developers to\n * grep through SDK source to figure out what tripped. The class name, `code`\n * prefix in the message, and `function_id` field together make a rejection\n * self-describing.\n */\nexport type InvocationErrorInit = {\n  code: string\n  message: string\n  function_id?: string\n  stacktrace?: string\n}\n\nexport class InvocationError extends Error {\n  public readonly code: string\n  public readonly function_id?: string\n  public readonly stacktrace?: string\n\n  constructor(init: InvocationErrorInit) {\n    super(`${init.code}: ${init.message}`)\n    this.name = 'InvocationError'\n    this.code = init.code\n    this.function_id = init.function_id\n    this.stacktrace = init.stacktrace\n  }\n}\n\n/**\n * True when `value` looks like the wire `ErrorBody` the engine sends in\n * `InvocationResult.error`: `{ code: string, message: string, stacktrace?: string }`.\n * Used to distinguish an engine rejection (which we wrap in\n * {@link InvocationError}) from a JS `Error` thrown elsewhere.\n */\nexport function isErrorBody(value: unknown): value is {\n  code: string\n  message: string\n  stacktrace?: string\n} {\n  if (typeof value !== 'object' || value === null) return false\n  const v = value as { code?: unknown; message?: unknown; stacktrace?: unknown }\n  return (\n    typeof v.code === 'string' &&\n    typeof v.message === 'string' &&\n    (v.stacktrace === undefined || typeof v.stacktrace === 'string')\n  )\n}\n"],"mappings":";AAoBA,IAAa,kBAAb,cAAqC,MAAM;CAKzC,YAAY,MAA2B;AACrC,QAAM,GAAG,KAAK,KAAK,IAAI,KAAK,UAAU;AACtC,OAAK,OAAO;AACZ,OAAK,OAAO,KAAK;AACjB,OAAK,cAAc,KAAK;AACxB,OAAK,aAAa,KAAK;;;;;;;;;AAU3B,SAAgB,YAAY,OAI1B;AACA,KAAI,OAAO,UAAU,YAAY,UAAU,KAAM,QAAO;CACxD,MAAM,IAAI;AACV,QACE,OAAO,EAAE,SAAS,YAClB,OAAO,EAAE,YAAY,aACpB,EAAE,eAAe,UAAa,OAAO,EAAE,eAAe"}
+{"version":3,"file":"errors.mjs","names":[],"sources":["../src/errors.ts"],"sourcesContent":["/**\n * Typed error surfaced when an invocation dispatched over the SDK fails, RBAC\n * rejection (FORBIDDEN), handler-level failure, or a timeout waiting for the\n * engine to respond. Wraps the wire `ErrorBody` shape plus the `function_id`\n * that was targeted, so callers get a single error type across all failure\n * modes and can disambiguate via `err.code`.\n *\n * Before this existed, rejection values were plain `ErrorBody`-shaped objects,\n * which printed as `[object Object]` when stringified, leaving developers to\n * grep through SDK source to figure out what tripped. The class name, `code`\n * prefix in the message, and `function_id` field together make a rejection\n * self-describing.\n */\nexport type InvocationErrorInit = {\n  code: string\n  message: string\n  function_id?: string\n  stacktrace?: string\n}\n\nexport class InvocationError extends Error {\n  public readonly code: string\n  public readonly function_id?: string\n  public readonly stacktrace?: string\n\n  constructor(init: InvocationErrorInit) {\n    super(`${init.code}: ${init.message}`)\n    this.name = 'InvocationError'\n    this.code = init.code\n    this.function_id = init.function_id\n    this.stacktrace = init.stacktrace\n  }\n}\n\n/**\n * Fatal error surfaced when the engine rejects this worker's registration with\n * a `registrationrejected` message: another live worker already owns this\n * `worker_name` (or an exported function id) in the target `namespace`. The\n * engine closes the connection on rejection, so this is terminal -- the SDK\n * stops the worker and does not reconnect. Carries the wire fields\n * (`code`, `namespace`, `worker_name`, `owner_worker_id`) so callers can tell\n * exactly which identity collided and with whom.\n */\nexport type RegistrationRejectedInit = {\n  code: string\n  namespace: string\n  worker_name: string\n  owner_worker_id: string\n}\n\nexport class RegistrationRejectedError extends Error {\n  public readonly code: string\n  public readonly namespace: string\n  public readonly worker_name: string\n  public readonly owner_worker_id: string\n\n  constructor(init: RegistrationRejectedInit) {\n    super(\n      `${init.code}: registration rejected for worker \"${init.worker_name}\" in namespace \"${init.namespace}\" (already owned by worker ${init.owner_worker_id})`,\n    )\n    this.name = 'RegistrationRejectedError'\n    this.code = init.code\n    this.namespace = init.namespace\n    this.worker_name = init.worker_name\n    this.owner_worker_id = init.owner_worker_id\n  }\n}\n\n/**\n * True when `value` looks like the wire `ErrorBody` the engine sends in\n * `InvocationResult.error`: `{ code: string, message: string, stacktrace?: string }`.\n * Used to distinguish an engine rejection (which we wrap in\n * {@link InvocationError}) from a JS `Error` thrown elsewhere.\n */\nexport function isErrorBody(value: unknown): value is {\n  code: string\n  message: string\n  stacktrace?: string\n} {\n  if (typeof value !== 'object' || value === null) return false\n  const v = value as { code?: unknown; message?: unknown; stacktrace?: unknown }\n  return (\n    typeof v.code === 'string' &&\n    typeof v.message === 'string' &&\n    (v.stacktrace === undefined || typeof v.stacktrace === 'string')\n  )\n}\n"],"mappings":";AAoBA,IAAa,kBAAb,cAAqC,MAAM;CAKzC,YAAY,MAA2B;AACrC,QAAM,GAAG,KAAK,KAAK,IAAI,KAAK,UAAU;AACtC,OAAK,OAAO;AACZ,OAAK,OAAO,KAAK;AACjB,OAAK,cAAc,KAAK;AACxB,OAAK,aAAa,KAAK;;;AAoB3B,IAAa,4BAAb,cAA+C,MAAM;CAMnD,YAAY,MAAgC;AAC1C,QACE,GAAG,KAAK,KAAK,sCAAsC,KAAK,YAAY,kBAAkB,KAAK,UAAU,6BAA6B,KAAK,gBAAgB,GACxJ;AACD,OAAK,OAAO;AACZ,OAAK,OAAO,KAAK;AACjB,OAAK,YAAY,KAAK;AACtB,OAAK,cAAc,KAAK;AACxB,OAAK,kBAAkB,KAAK;;;;;;;;;AAUhC,SAAgB,YAAY,OAI1B;AACA,KAAI,OAAO,UAAU,YAAY,UAAU,KAAM,QAAO;CACxD,MAAM,IAAI;AACV,QACE,OAAO,EAAE,SAAS,YAClB,OAAO,EAAE,YAAY,aACpB,EAAE,eAAe,UAAa,OAAO,EAAE,eAAe"}

package/dist/helpers.d.cts

@@ -1,4 +1,4 @@
-import { O as StreamChannelRef, _ as ChannelItem, g as ChannelDirection, r as IIIClient, t as Channel } from "./types-n-760A15.cjs";
+import { M as StreamChannelRef, b as ChannelDirection, r as IIIClient, t as Channel, x as ChannelItem } from "./types-Co4Q4P8p.cjs";
 import { IStream } from "./stream.cjs";
 
 //#region src/utils.d.ts

package/dist/helpers.d.mts

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

package/dist/{iii-types-BvaIabiX.cjs → iii-types-BHasLgj1.cjs}

@@ -11,6 +11,7 @@ let MessageType = /* @__PURE__ */ function(MessageType) {
 	MessageType["UnregisterTriggerType"] = "unregistertriggertype";
 	MessageType["TriggerRegistrationResult"] = "triggerregistrationresult";
 	MessageType["WorkerRegistered"] = "workerregistered";
+	MessageType["RegistrationRejected"] = "registrationrejected";
 	MessageType["Reattach"] = "reattach";
 	return MessageType;
 }({});
@@ -22,4 +23,4 @@ Object.defineProperty(exports, 'MessageType', {
     return MessageType;
   }
 });
-//# sourceMappingURL=iii-types-BvaIabiX.cjs.map
+//# sourceMappingURL=iii-types-BHasLgj1.cjs.map

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

@@ -0,0 +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 */\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-wPYrg7hX.mjs → iii-types-Btz-0RpP.mjs}

@@ -10,10 +10,11 @@ let MessageType = /* @__PURE__ */ function(MessageType) {
 	MessageType["UnregisterTriggerType"] = "unregistertriggertype";
 	MessageType["TriggerRegistrationResult"] = "triggerregistrationresult";
 	MessageType["WorkerRegistered"] = "workerregistered";
+	MessageType["RegistrationRejected"] = "registrationrejected";
 	MessageType["Reattach"] = "reattach";
 	return MessageType;
 }({});
 
 //#endregion
 export { MessageType as t };
-//# sourceMappingURL=iii-types-wPYrg7hX.mjs.map
+//# sourceMappingURL=iii-types-Btz-0RpP.mjs.map

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

@@ -0,0 +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 */\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

@@ -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,11 @@ function getDefaultWorkerName() {
 	if (managedName) return managedName;
 	return `${node_os.hostname()}:${process.pid}`;
 }
+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;
@@ -185,7 +202,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 +213,8 @@ var Sdk = class {
 					traceparent,
 					baggage,
 					action,
-					metadata
+					metadata,
+					...namespace !== void 0 ? { namespace } : {}
 				});
 				return;
 			}
@@ -233,7 +251,8 @@ var Sdk = class {
 					traceparent,
 					baggage,
 					action,
-					metadata
+					metadata,
+					...namespace !== void 0 ? { namespace } : {}
 				});
 			});
 		};
@@ -244,6 +263,8 @@ 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.getFatalError = () => this.fatalError;
 		this.shutdown = async () => {
 			this.isShuttingDown = true;
 			this.stopMetricsReporting();
@@ -266,6 +287,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 +314,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 +430,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 +446,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 +504,58 @@ 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. Here
+	*   `worker_name` carries the contested function id (the engine reuses the
+	*   struct).
+	* - Any other code: treated as fatal (safe default).
+	*/
+	onRegistrationRejected(init) {
+		if (init.code === FUNCTION_NAMESPACE_CONFLICT) {
+			this.logWarn(`Function registration rejected: function "${init.worker_name}" 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) {
@@ -661,6 +736,14 @@ 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, owner_worker_id } = message;
+			this.onRegistrationRejected({
+				code,
+				namespace,
+				worker_name,
+				owner_worker_id
+			});
 		}
 	}
 };
@@ -714,6 +797,7 @@ const registerWorker = (address, options) => new Sdk(address, options);
 
 //#endregion
 exports.InvocationError = require_errors.InvocationError;
+exports.RegistrationRejectedError = require_errors.RegistrationRejectedError;
 exports.TriggerAction = TriggerAction;
 exports.registerWorker = registerWorker;
 //# sourceMappingURL=index.cjs.map