iii-sdk 0.19.7 → 0.20.0-alpha.1

package/dist/helpers.d.cts

@@ -1,20 +1,38 @@
-import { S as ChannelItem, o as Channel, r as isChannelRef, t as extractChannelRefs, u as ISdk, x as ChannelDirection } from "./utils-BnRzIUCy.cjs";
+import { D as StreamChannelRef, _ as ChannelItem, g as ChannelDirection, r as IIIClient, t as Channel } from "./types-BZoO05vA.cjs";
 import { IStream } from "./stream.cjs";
 
+//#region src/utils.d.ts
+/**
+ * Type guard that checks if a value is a {@link StreamChannelRef}.
+ *
+ * @param value - Value to check.
+ * @returns `true` if the value is a valid `StreamChannelRef`.
+ */
+declare const isChannelRef: (value: unknown) => value is StreamChannelRef;
+/**
+ * Recursively extract all {@link StreamChannelRef} values from a JSON-like
+ * input, returning each match paired with its dotted/bracketed path. Mirrors
+ * the Rust SDK's `extract_channel_refs`.
+ *
+ * @param data - Arbitrary JSON-like value.
+ * @returns Array of `[path, ref]` tuples. Empty when no refs are found.
+ */
+declare const extractChannelRefs: (data: unknown) => Array<[string, StreamChannelRef]>;
+//#endregion
 //#region src/helpers.d.ts
 /**
  * Create a streaming channel pair for worker-to-worker data transfer.
  *
- * Free-function form of the previous `ISdk.createChannel` instance method.
+ * Free-function form of the previous `IIIClient.createChannel` instance method.
  */
-declare function createChannel(iii: ISdk, bufferSize?: number): Promise<Channel>;
+declare function createChannel(iii: IIIClient, bufferSize?: number): Promise<Channel>;
 /**
  * Register a custom stream implementation by wiring its 5 callable methods
  * to `stream::get/set/delete/list/list_groups`.
  *
- * Free-function form of the previous `ISdk.createStream` instance method.
+ * Free-function form of the previous `IIIClient.createStream` instance method.
  */
-declare function createStream<TData>(iii: ISdk, streamName: string, stream: IStream<TData>): void;
+declare function createStream<TData>(iii: IIIClient, streamName: string, stream: IStream<TData>): void;
 //#endregion
 export { ChannelDirection, ChannelItem, createChannel, createStream, extractChannelRefs, isChannelRef };
 //# sourceMappingURL=helpers.d.cts.map

package/dist/helpers.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.d.cts","names":[],"sources":["../src/helpers.ts"],"mappings":";;;;;;;;;iBAuBgB,aAAA,CAAc,GAAA,EAAK,IAAA,EAAM,UAAA,YAAsB,OAAA,CAAQ,OAAA;;;AAUvE;;;;iBAAgB,YAAA,OAAA,CAAoB,GAAA,EAAK,IAAA,EAAM,UAAA,UAAoB,MAAA,EAAQ,OAAA,CAAQ,KAAA"}
+{"version":3,"file":"helpers.d.cts","names":[],"sources":["../src/utils.ts","../src/helpers.ts"],"mappings":";;;;;;AAuDA;;;;cAlBa,YAAA,GAAgB,KAAA,cAAiB,KAAA,IAAS,gBAAA;;;;;;;;ACdvD;cDgCa,kBAAA,GAAsB,IAAA,cAAgB,KAAA,UAAe,gBAAA;;;;;AAAlE;;;iBChCgB,aAAA,CAAc,GAAA,EAAK,SAAA,EAAW,UAAA,YAAsB,OAAA,CAAQ,OAAA;;;;;;;iBAU5D,YAAA,OAAA,CAAoB,GAAA,EAAK,SAAA,EAAW,UAAA,UAAoB,MAAA,EAAQ,OAAA,CAAQ,KAAA"}

package/dist/helpers.d.mts

@@ -1,20 +1,38 @@
-import { S as ChannelItem, o as Channel, r as isChannelRef, t as extractChannelRefs, u as ISdk, x as ChannelDirection } from "./utils-e84Qph-9.mjs";
+import { D as StreamChannelRef, _ as ChannelItem, g as ChannelDirection, r as IIIClient, t as Channel } from "./types-BlFE8MZG.mjs";
 import { IStream } from "./stream.mjs";
 
+//#region src/utils.d.ts
+/**
+ * Type guard that checks if a value is a {@link StreamChannelRef}.
+ *
+ * @param value - Value to check.
+ * @returns `true` if the value is a valid `StreamChannelRef`.
+ */
+declare const isChannelRef: (value: unknown) => value is StreamChannelRef;
+/**
+ * Recursively extract all {@link StreamChannelRef} values from a JSON-like
+ * input, returning each match paired with its dotted/bracketed path. Mirrors
+ * the Rust SDK's `extract_channel_refs`.
+ *
+ * @param data - Arbitrary JSON-like value.
+ * @returns Array of `[path, ref]` tuples. Empty when no refs are found.
+ */
+declare const extractChannelRefs: (data: unknown) => Array<[string, StreamChannelRef]>;
+//#endregion
 //#region src/helpers.d.ts
 /**
  * Create a streaming channel pair for worker-to-worker data transfer.
  *
- * Free-function form of the previous `ISdk.createChannel` instance method.
+ * Free-function form of the previous `IIIClient.createChannel` instance method.
  */
-declare function createChannel(iii: ISdk, bufferSize?: number): Promise<Channel>;
+declare function createChannel(iii: IIIClient, bufferSize?: number): Promise<Channel>;
 /**
  * Register a custom stream implementation by wiring its 5 callable methods
  * to `stream::get/set/delete/list/list_groups`.
  *
- * Free-function form of the previous `ISdk.createStream` instance method.
+ * Free-function form of the previous `IIIClient.createStream` instance method.
  */
-declare function createStream<TData>(iii: ISdk, streamName: string, stream: IStream<TData>): void;
+declare function createStream<TData>(iii: IIIClient, streamName: string, stream: IStream<TData>): void;
 //#endregion
 export { ChannelDirection, ChannelItem, createChannel, createStream, extractChannelRefs, isChannelRef };
 //# sourceMappingURL=helpers.d.mts.map

package/dist/helpers.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.d.mts","names":[],"sources":["../src/helpers.ts"],"mappings":";;;;;;;;;iBAuBgB,aAAA,CAAc,GAAA,EAAK,IAAA,EAAM,UAAA,YAAsB,OAAA,CAAQ,OAAA;;;AAUvE;;;;iBAAgB,YAAA,OAAA,CAAoB,GAAA,EAAK,IAAA,EAAM,UAAA,UAAoB,MAAA,EAAQ,OAAA,CAAQ,KAAA"}
+{"version":3,"file":"helpers.d.mts","names":[],"sources":["../src/utils.ts","../src/helpers.ts"],"mappings":";;;;;;AAuDA;;;;cAlBa,YAAA,GAAgB,KAAA,cAAiB,KAAA,IAAS,gBAAA;;;;;;;;ACdvD;cDgCa,kBAAA,GAAsB,IAAA,cAAgB,KAAA,UAAe,gBAAA;;;;;AAAlE;;;iBChCgB,aAAA,CAAc,GAAA,EAAK,SAAA,EAAW,UAAA,YAAsB,OAAA,CAAQ,OAAA;;;;;;;iBAU5D,YAAA,OAAA,CAAoB,GAAA,EAAK,SAAA,EAAW,UAAA,UAAoB,MAAA,EAAQ,OAAA,CAAQ,KAAA"}

package/dist/helpers.mjs

@@ -1,10 +1,11 @@
-import { a as ChannelDirection, i as isChannelRef, n as extractChannelRefs, o as ChannelItem } from "./utils-DXL7JI0q.mjs";
+import { n as ChannelItem, t as ChannelDirection } from "./channels-De8fNMyx.mjs";
+import { n as extractChannelRefs, r as isChannelRef } from "./utils-8G4hHqvZ.mjs";
 
 //#region src/helpers.ts
 /**
 * Create a streaming channel pair for worker-to-worker data transfer.
 *
-* Free-function form of the previous `ISdk.createChannel` instance method.
+* Free-function form of the previous `IIIClient.createChannel` instance method.
 */
 function createChannel(iii, bufferSize) {
 	return iii.__helpers_create_channel(bufferSize);
@@ -13,7 +14,7 @@ function createChannel(iii, bufferSize) {
 * Register a custom stream implementation by wiring its 5 callable methods
 * to `stream::get/set/delete/list/list_groups`.
 *
-* Free-function form of the previous `ISdk.createStream` instance method.
+* Free-function form of the previous `IIIClient.createStream` instance method.
 */
 function createStream(iii, streamName, stream) {
 	iii.__helpers_create_stream(streamName, stream);

package/dist/helpers.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.mjs","names":[],"sources":["../src/helpers.ts"],"sourcesContent":["/**\n * Helper free functions that operate on an {@link ISdk} instance.\n *\n * These were previously instance methods on the SDK. They take the iii\n * instance as the first argument so the public API surface of `ISdk` stays\n * focused on the core lifecycle and registration methods.\n */\nimport type { Channel, ISdk } from './types'\nimport type { IStream } from './stream'\n\nexport { ChannelDirection, ChannelItem } from './channels'\nexport { extractChannelRefs, isChannelRef } from './utils'\n\ntype IIIWithHelperShims = ISdk & {\n  __helpers_create_channel(bufferSize?: number): Promise<Channel>\n  __helpers_create_stream<T>(name: string, stream: IStream<T>): void\n}\n\n/**\n * Create a streaming channel pair for worker-to-worker data transfer.\n *\n * Free-function form of the previous `ISdk.createChannel` instance method.\n */\nexport function createChannel(iii: ISdk, bufferSize?: number): Promise<Channel> {\n  return (iii as IIIWithHelperShims).__helpers_create_channel(bufferSize)\n}\n\n/**\n * Register a custom stream implementation by wiring its 5 callable methods\n * to `stream::get/set/delete/list/list_groups`.\n *\n * Free-function form of the previous `ISdk.createStream` instance method.\n */\nexport function createStream<TData>(iii: ISdk, streamName: string, stream: IStream<TData>): void {\n  ;(iii as IIIWithHelperShims).__helpers_create_stream(streamName, stream)\n}\n"],"mappings":";;;;;;;;AAuBA,SAAgB,cAAc,KAAW,YAAuC;AAC9E,QAAQ,IAA2B,yBAAyB,WAAW;;;;;;;;AASzE,SAAgB,aAAoB,KAAW,YAAoB,QAA8B;AAC9F,CAAC,IAA2B,wBAAwB,YAAY,OAAO"}
+{"version":3,"file":"helpers.mjs","names":[],"sources":["../src/helpers.ts"],"sourcesContent":["/**\n * Helper free functions that operate on an {@link IIIClient} instance.\n *\n * These were previously instance methods on the SDK. They take the iii\n * instance as the first argument so the public API surface of `IIIClient` stays\n * focused on the core lifecycle and registration methods.\n */\nimport type { Channel, IIIClient } from './types'\nimport type { IStream } from './stream'\n\nexport { ChannelDirection, ChannelItem } from './channels'\nexport { extractChannelRefs, isChannelRef } from './utils'\n\ntype IIIWithHelperShims = IIIClient & {\n  __helpers_create_channel(bufferSize?: number): Promise<Channel>\n  __helpers_create_stream<T>(name: string, stream: IStream<T>): void\n}\n\n/**\n * Create a streaming channel pair for worker-to-worker data transfer.\n *\n * Free-function form of the previous `IIIClient.createChannel` instance method.\n */\nexport function createChannel(iii: IIIClient, bufferSize?: number): Promise<Channel> {\n  return (iii as IIIWithHelperShims).__helpers_create_channel(bufferSize)\n}\n\n/**\n * Register a custom stream implementation by wiring its 5 callable methods\n * to `stream::get/set/delete/list/list_groups`.\n *\n * Free-function form of the previous `IIIClient.createStream` instance method.\n */\nexport function createStream<TData>(iii: IIIClient, streamName: string, stream: IStream<TData>): void {\n  ;(iii as IIIWithHelperShims).__helpers_create_stream(streamName, stream)\n}\n"],"mappings":";;;;;;;;;AAuBA,SAAgB,cAAc,KAAgB,YAAuC;AACnF,QAAQ,IAA2B,yBAAyB,WAAW;;;;;;;;AASzE,SAAgB,aAAoB,KAAgB,YAAoB,QAA8B;AACnG,CAAC,IAA2B,wBAAwB,YAAY,OAAO"}

package/dist/iii-constants-Baptl8nm.d.mts

@@ -0,0 +1,47 @@
+//#region src/iii-constants.d.ts
+/**
+ * Constants for the III module.
+ */
+/**
+ * Engine function paths for internal operations.
+ *
+ * Naming note: `LIST_TRIGGERS` / `INFO_TRIGGERS` cover trigger TYPES
+ * (templates). `LIST_REGISTERED_TRIGGERS` / `INFO_REGISTERED_TRIGGERS`
+ * cover trigger INSTANCES (subscriber rows). The old
+ * `engine::trigger-types::list` builtin has been removed and is now
+ * served by `engine::triggers::list`.
+ */
+declare const EngineFunctions: {
+  readonly LIST_FUNCTIONS: "engine::functions::list";
+  readonly INFO_FUNCTIONS: "engine::functions::info";
+  readonly LIST_WORKERS: "engine::workers::list";
+  readonly INFO_WORKERS: "engine::workers::info";
+  readonly LIST_TRIGGERS: "engine::triggers::list";
+  readonly INFO_TRIGGERS: "engine::triggers::info";
+  readonly LIST_REGISTERED_TRIGGERS: "engine::registered-triggers::list";
+  readonly INFO_REGISTERED_TRIGGERS: "engine::registered-triggers::info";
+  readonly REGISTER_WORKER: "engine::workers::register";
+};
+/** Engine trigger types */
+declare const EngineTriggers: {
+  readonly FUNCTIONS_AVAILABLE: "engine::functions-available";
+  readonly LOG: "log";
+};
+/** Connection state for the III WebSocket */
+type IIIConnectionState = 'disconnected' | 'connecting' | 'connected' | 'reconnecting' | 'failed';
+/** Configuration for WebSocket reconnection behavior */
+interface IIIReconnectionConfig {
+  /** Starting delay in milliseconds (default: 1000ms) */
+  initialDelayMs: number;
+  /** Maximum delay cap in milliseconds (default: 30000ms) */
+  maxDelayMs: number;
+  /** Exponential backoff multiplier (default: 2) */
+  backoffMultiplier: number;
+  /** Random jitter factor 0-1 (default: 0.3) */
+  jitterFactor: number;
+  /** Maximum retry attempts, -1 for infinite (default: -1) */
+  maxRetries: number;
+}
+//#endregion
+export { IIIReconnectionConfig as i, EngineTriggers as n, IIIConnectionState as r, EngineFunctions as t };
+//# sourceMappingURL=iii-constants-Baptl8nm.d.mts.map

package/dist/iii-constants-Baptl8nm.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"iii-constants-Baptl8nm.d.mts","names":[],"sources":["../src/iii-constants.ts"],"mappings":";;AAaA;;;;;;;;;;;cAAa,eAAA;EAAA;;;;;;;;;;;cAaA,cAAA;EAAA,SAGH,mBAAA;EAAA,SAAA,GAAA;AAAA;;KAWE,kBAAA;;UAQK,qBAAA;;EAEf,cAAA;;EAEA,UAAA;;EAEA,iBAAA;;EAEA,YAAA;;EAEA,UAAA;AAAA"}

package/dist/iii-constants-BqXp8xSN.d.cts

@@ -0,0 +1,47 @@
+//#region src/iii-constants.d.ts
+/**
+ * Constants for the III module.
+ */
+/**
+ * Engine function paths for internal operations.
+ *
+ * Naming note: `LIST_TRIGGERS` / `INFO_TRIGGERS` cover trigger TYPES
+ * (templates). `LIST_REGISTERED_TRIGGERS` / `INFO_REGISTERED_TRIGGERS`
+ * cover trigger INSTANCES (subscriber rows). The old
+ * `engine::trigger-types::list` builtin has been removed and is now
+ * served by `engine::triggers::list`.
+ */
+declare const EngineFunctions: {
+  readonly LIST_FUNCTIONS: "engine::functions::list";
+  readonly INFO_FUNCTIONS: "engine::functions::info";
+  readonly LIST_WORKERS: "engine::workers::list";
+  readonly INFO_WORKERS: "engine::workers::info";
+  readonly LIST_TRIGGERS: "engine::triggers::list";
+  readonly INFO_TRIGGERS: "engine::triggers::info";
+  readonly LIST_REGISTERED_TRIGGERS: "engine::registered-triggers::list";
+  readonly INFO_REGISTERED_TRIGGERS: "engine::registered-triggers::info";
+  readonly REGISTER_WORKER: "engine::workers::register";
+};
+/** Engine trigger types */
+declare const EngineTriggers: {
+  readonly FUNCTIONS_AVAILABLE: "engine::functions-available";
+  readonly LOG: "log";
+};
+/** Connection state for the III WebSocket */
+type IIIConnectionState = 'disconnected' | 'connecting' | 'connected' | 'reconnecting' | 'failed';
+/** Configuration for WebSocket reconnection behavior */
+interface IIIReconnectionConfig {
+  /** Starting delay in milliseconds (default: 1000ms) */
+  initialDelayMs: number;
+  /** Maximum delay cap in milliseconds (default: 30000ms) */
+  maxDelayMs: number;
+  /** Exponential backoff multiplier (default: 2) */
+  backoffMultiplier: number;
+  /** Random jitter factor 0-1 (default: 0.3) */
+  jitterFactor: number;
+  /** Maximum retry attempts, -1 for infinite (default: -1) */
+  maxRetries: number;
+}
+//#endregion
+export { IIIReconnectionConfig as i, EngineTriggers as n, IIIConnectionState as r, EngineFunctions as t };
+//# sourceMappingURL=iii-constants-BqXp8xSN.d.cts.map

package/dist/iii-constants-BqXp8xSN.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"iii-constants-BqXp8xSN.d.cts","names":[],"sources":["../src/iii-constants.ts"],"mappings":";;AAaA;;;;;;;;;;;cAAa,eAAA;EAAA;;;;;;;;;;;cAaA,cAAA;EAAA,SAGH,mBAAA;EAAA,SAAA,GAAA;AAAA;;KAWE,kBAAA;;UAQK,qBAAA;;EAEf,cAAA;;EAEA,UAAA;;EAEA,iBAAA;;EAEA,YAAA;;EAEA,UAAA;AAAA"}

package/dist/iii-constants-Br94RUNi.cjs

@@ -0,0 +1,67 @@
+
+//#region src/iii-constants.ts
+/**
+* Constants for the III module.
+*/
+/**
+* Engine function paths for internal operations.
+*
+* Naming note: `LIST_TRIGGERS` / `INFO_TRIGGERS` cover trigger TYPES
+* (templates). `LIST_REGISTERED_TRIGGERS` / `INFO_REGISTERED_TRIGGERS`
+* cover trigger INSTANCES (subscriber rows). The old
+* `engine::trigger-types::list` builtin has been removed and is now
+* served by `engine::triggers::list`.
+*/
+const EngineFunctions = {
+	LIST_FUNCTIONS: "engine::functions::list",
+	INFO_FUNCTIONS: "engine::functions::info",
+	LIST_WORKERS: "engine::workers::list",
+	INFO_WORKERS: "engine::workers::info",
+	LIST_TRIGGERS: "engine::triggers::list",
+	INFO_TRIGGERS: "engine::triggers::info",
+	LIST_REGISTERED_TRIGGERS: "engine::registered-triggers::list",
+	INFO_REGISTERED_TRIGGERS: "engine::registered-triggers::info",
+	REGISTER_WORKER: "engine::workers::register"
+};
+/** Engine trigger types */
+const EngineTriggers = {
+	FUNCTIONS_AVAILABLE: "engine::functions-available",
+	LOG: "log"
+};
+/** Default reconnection configuration */
+const DEFAULT_BRIDGE_RECONNECTION_CONFIG = {
+	initialDelayMs: 1e3,
+	maxDelayMs: 3e4,
+	backoffMultiplier: 2,
+	jitterFactor: .3,
+	maxRetries: -1
+};
+/** Default invocation timeout in milliseconds */
+const DEFAULT_INVOCATION_TIMEOUT_MS = 3e4;
+
+//#endregion
+Object.defineProperty(exports, 'DEFAULT_BRIDGE_RECONNECTION_CONFIG', {
+  enumerable: true,
+  get: function () {
+    return DEFAULT_BRIDGE_RECONNECTION_CONFIG;
+  }
+});
+Object.defineProperty(exports, 'DEFAULT_INVOCATION_TIMEOUT_MS', {
+  enumerable: true,
+  get: function () {
+    return DEFAULT_INVOCATION_TIMEOUT_MS;
+  }
+});
+Object.defineProperty(exports, 'EngineFunctions', {
+  enumerable: true,
+  get: function () {
+    return EngineFunctions;
+  }
+});
+Object.defineProperty(exports, 'EngineTriggers', {
+  enumerable: true,
+  get: function () {
+    return EngineTriggers;
+  }
+});
+//# sourceMappingURL=iii-constants-Br94RUNi.cjs.map

package/dist/iii-constants-Br94RUNi.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"iii-constants-Br94RUNi.cjs","names":[],"sources":["../src/iii-constants.ts"],"sourcesContent":["/**\n * Constants for the III module.\n */\n\n/**\n * Engine function paths for internal operations.\n *\n * Naming note: `LIST_TRIGGERS` / `INFO_TRIGGERS` cover trigger TYPES\n * (templates). `LIST_REGISTERED_TRIGGERS` / `INFO_REGISTERED_TRIGGERS`\n * cover trigger INSTANCES (subscriber rows). The old\n * `engine::trigger-types::list` builtin has been removed and is now\n * served by `engine::triggers::list`.\n */\nexport const EngineFunctions = {\n  LIST_FUNCTIONS: 'engine::functions::list',\n  INFO_FUNCTIONS: 'engine::functions::info',\n  LIST_WORKERS: 'engine::workers::list',\n  INFO_WORKERS: 'engine::workers::info',\n  LIST_TRIGGERS: 'engine::triggers::list',\n  INFO_TRIGGERS: 'engine::triggers::info',\n  LIST_REGISTERED_TRIGGERS: 'engine::registered-triggers::list',\n  INFO_REGISTERED_TRIGGERS: 'engine::registered-triggers::info',\n  REGISTER_WORKER: 'engine::workers::register',\n} as const\n\n/** Engine trigger types */\nexport const EngineTriggers = {\n  FUNCTIONS_AVAILABLE: 'engine::functions-available',\n  LOG: 'log',\n} as const\n\n/** Log function paths */\nexport const LogFunctions = {\n  INFO: 'engine::log::info',\n  WARN: 'engine::log::warn',\n  ERROR: 'engine::log::error',\n  DEBUG: 'engine::log::debug',\n} as const\n\n/** Connection state for the III WebSocket */\nexport type IIIConnectionState =\n  | 'disconnected'\n  | 'connecting'\n  | 'connected'\n  | 'reconnecting'\n  | 'failed'\n\n/** Configuration for WebSocket reconnection behavior */\nexport interface IIIReconnectionConfig {\n  /** Starting delay in milliseconds (default: 1000ms) */\n  initialDelayMs: number\n  /** Maximum delay cap in milliseconds (default: 30000ms) */\n  maxDelayMs: number\n  /** Exponential backoff multiplier (default: 2) */\n  backoffMultiplier: number\n  /** Random jitter factor 0-1 (default: 0.3) */\n  jitterFactor: number\n  /** Maximum retry attempts, -1 for infinite (default: -1) */\n  maxRetries: number\n}\n\n/** Default reconnection configuration */\nexport const DEFAULT_BRIDGE_RECONNECTION_CONFIG: IIIReconnectionConfig = {\n  initialDelayMs: 1000,\n  maxDelayMs: 30000,\n  backoffMultiplier: 2,\n  jitterFactor: 0.3,\n  maxRetries: -1,\n}\n\n/** Default invocation timeout in milliseconds */\nexport const DEFAULT_INVOCATION_TIMEOUT_MS = 30000\n"],"mappings":";;;;;;;;;;;;;;AAaA,MAAa,kBAAkB;CAC7B,gBAAgB;CAChB,gBAAgB;CAChB,cAAc;CACd,cAAc;CACd,eAAe;CACf,eAAe;CACf,0BAA0B;CAC1B,0BAA0B;CAC1B,iBAAiB;CAClB;;AAGD,MAAa,iBAAiB;CAC5B,qBAAqB;CACrB,KAAK;CACN;;AAiCD,MAAa,qCAA4D;CACvE,gBAAgB;CAChB,YAAY;CACZ,mBAAmB;CACnB,cAAc;CACd,YAAY;CACb;;AAGD,MAAa,gCAAgC"}

package/dist/iii-constants-_k3SoHry.mjs

@@ -0,0 +1,43 @@
+//#region src/iii-constants.ts
+/**
+* Constants for the III module.
+*/
+/**
+* Engine function paths for internal operations.
+*
+* Naming note: `LIST_TRIGGERS` / `INFO_TRIGGERS` cover trigger TYPES
+* (templates). `LIST_REGISTERED_TRIGGERS` / `INFO_REGISTERED_TRIGGERS`
+* cover trigger INSTANCES (subscriber rows). The old
+* `engine::trigger-types::list` builtin has been removed and is now
+* served by `engine::triggers::list`.
+*/
+const EngineFunctions = {
+	LIST_FUNCTIONS: "engine::functions::list",
+	INFO_FUNCTIONS: "engine::functions::info",
+	LIST_WORKERS: "engine::workers::list",
+	INFO_WORKERS: "engine::workers::info",
+	LIST_TRIGGERS: "engine::triggers::list",
+	INFO_TRIGGERS: "engine::triggers::info",
+	LIST_REGISTERED_TRIGGERS: "engine::registered-triggers::list",
+	INFO_REGISTERED_TRIGGERS: "engine::registered-triggers::info",
+	REGISTER_WORKER: "engine::workers::register"
+};
+/** Engine trigger types */
+const EngineTriggers = {
+	FUNCTIONS_AVAILABLE: "engine::functions-available",
+	LOG: "log"
+};
+/** Default reconnection configuration */
+const DEFAULT_BRIDGE_RECONNECTION_CONFIG = {
+	initialDelayMs: 1e3,
+	maxDelayMs: 3e4,
+	backoffMultiplier: 2,
+	jitterFactor: .3,
+	maxRetries: -1
+};
+/** Default invocation timeout in milliseconds */
+const DEFAULT_INVOCATION_TIMEOUT_MS = 3e4;
+
+//#endregion
+export { EngineTriggers as i, DEFAULT_INVOCATION_TIMEOUT_MS as n, EngineFunctions as r, DEFAULT_BRIDGE_RECONNECTION_CONFIG as t };
+//# sourceMappingURL=iii-constants-_k3SoHry.mjs.map

package/dist/iii-constants-_k3SoHry.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"iii-constants-_k3SoHry.mjs","names":[],"sources":["../src/iii-constants.ts"],"sourcesContent":["/**\n * Constants for the III module.\n */\n\n/**\n * Engine function paths for internal operations.\n *\n * Naming note: `LIST_TRIGGERS` / `INFO_TRIGGERS` cover trigger TYPES\n * (templates). `LIST_REGISTERED_TRIGGERS` / `INFO_REGISTERED_TRIGGERS`\n * cover trigger INSTANCES (subscriber rows). The old\n * `engine::trigger-types::list` builtin has been removed and is now\n * served by `engine::triggers::list`.\n */\nexport const EngineFunctions = {\n  LIST_FUNCTIONS: 'engine::functions::list',\n  INFO_FUNCTIONS: 'engine::functions::info',\n  LIST_WORKERS: 'engine::workers::list',\n  INFO_WORKERS: 'engine::workers::info',\n  LIST_TRIGGERS: 'engine::triggers::list',\n  INFO_TRIGGERS: 'engine::triggers::info',\n  LIST_REGISTERED_TRIGGERS: 'engine::registered-triggers::list',\n  INFO_REGISTERED_TRIGGERS: 'engine::registered-triggers::info',\n  REGISTER_WORKER: 'engine::workers::register',\n} as const\n\n/** Engine trigger types */\nexport const EngineTriggers = {\n  FUNCTIONS_AVAILABLE: 'engine::functions-available',\n  LOG: 'log',\n} as const\n\n/** Log function paths */\nexport const LogFunctions = {\n  INFO: 'engine::log::info',\n  WARN: 'engine::log::warn',\n  ERROR: 'engine::log::error',\n  DEBUG: 'engine::log::debug',\n} as const\n\n/** Connection state for the III WebSocket */\nexport type IIIConnectionState =\n  | 'disconnected'\n  | 'connecting'\n  | 'connected'\n  | 'reconnecting'\n  | 'failed'\n\n/** Configuration for WebSocket reconnection behavior */\nexport interface IIIReconnectionConfig {\n  /** Starting delay in milliseconds (default: 1000ms) */\n  initialDelayMs: number\n  /** Maximum delay cap in milliseconds (default: 30000ms) */\n  maxDelayMs: number\n  /** Exponential backoff multiplier (default: 2) */\n  backoffMultiplier: number\n  /** Random jitter factor 0-1 (default: 0.3) */\n  jitterFactor: number\n  /** Maximum retry attempts, -1 for infinite (default: -1) */\n  maxRetries: number\n}\n\n/** Default reconnection configuration */\nexport const DEFAULT_BRIDGE_RECONNECTION_CONFIG: IIIReconnectionConfig = {\n  initialDelayMs: 1000,\n  maxDelayMs: 30000,\n  backoffMultiplier: 2,\n  jitterFactor: 0.3,\n  maxRetries: -1,\n}\n\n/** Default invocation timeout in milliseconds */\nexport const DEFAULT_INVOCATION_TIMEOUT_MS = 30000\n"],"mappings":";;;;;;;;;;;;;AAaA,MAAa,kBAAkB;CAC7B,gBAAgB;CAChB,gBAAgB;CAChB,cAAc;CACd,cAAc;CACd,eAAe;CACf,eAAe;CACf,0BAA0B;CAC1B,0BAA0B;CAC1B,iBAAiB;CAClB;;AAGD,MAAa,iBAAiB;CAC5B,qBAAqB;CACrB,KAAK;CACN;;AAiCD,MAAa,qCAA4D;CACvE,gBAAgB;CAChB,YAAY;CACZ,mBAAmB;CACnB,cAAc;CACd,YAAY;CACb;;AAGD,MAAa,gCAAgC"}

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

@@ -0,0 +1,24 @@
+
+//#region src/iii-types.ts
+let MessageType = /* @__PURE__ */ function(MessageType) {
+	MessageType["RegisterFunction"] = "registerfunction";
+	MessageType["UnregisterFunction"] = "unregisterfunction";
+	MessageType["InvokeFunction"] = "invokefunction";
+	MessageType["InvocationResult"] = "invocationresult";
+	MessageType["RegisterTriggerType"] = "registertriggertype";
+	MessageType["RegisterTrigger"] = "registertrigger";
+	MessageType["UnregisterTrigger"] = "unregistertrigger";
+	MessageType["UnregisterTriggerType"] = "unregistertriggertype";
+	MessageType["TriggerRegistrationResult"] = "triggerregistrationresult";
+	MessageType["WorkerRegistered"] = "workerregistered";
+	return MessageType;
+}({});
+
+//#endregion
+Object.defineProperty(exports, 'MessageType', {
+  enumerable: true,
+  get: function () {
+    return MessageType;
+  }
+});
+//# sourceMappingURL=iii-types-6aHBgy7l.cjs.map

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

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

package/dist/iii-types-CRx2qAjB.mjs

@@ -0,0 +1,18 @@
+//#region src/iii-types.ts
+let MessageType = /* @__PURE__ */ function(MessageType) {
+	MessageType["RegisterFunction"] = "registerfunction";
+	MessageType["UnregisterFunction"] = "unregisterfunction";
+	MessageType["InvokeFunction"] = "invokefunction";
+	MessageType["InvocationResult"] = "invocationresult";
+	MessageType["RegisterTriggerType"] = "registertriggertype";
+	MessageType["RegisterTrigger"] = "registertrigger";
+	MessageType["UnregisterTrigger"] = "unregistertrigger";
+	MessageType["UnregisterTriggerType"] = "unregistertriggertype";
+	MessageType["TriggerRegistrationResult"] = "triggerregistrationresult";
+	MessageType["WorkerRegistered"] = "workerregistered";
+	return MessageType;
+}({});
+
+//#endregion
+export { MessageType as t };
+//# sourceMappingURL=iii-types-CRx2qAjB.mjs.map

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

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