@cldmv/slothlet 2.5.6 → 2.6.0

package/dist/slothlet.mjs

@@ -30,9 +30,32 @@ import {
 	getCategoryBuildingDecisions,
 	buildCategoryDecisions
 } from "@cldmv/slothlet/helpers/api_builder";
+import { updateInstanceData, cleanupInstance } from "./lib/helpers/instance-manager.mjs";
 
 
 
+
+function normalizeRuntimeType(runtime) {
+	if (!runtime || typeof runtime !== "string") {
+		return "async"; 
+	}
+
+	const normalized = runtime.toLowerCase().trim();
+
+	
+	if (normalized === "async" || normalized === "asynclocal" || normalized === "asynclocalstorage") {
+		return "async";
+	}
+
+	
+	if (normalized === "live" || normalized === "livebindings" || normalized === "experimental") {
+		return "live";
+	}
+
+	
+	return "async";
+}
+
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 
@@ -128,7 +151,25 @@ const slothletObject = {
 		}
 
 		
-		this.instanceId = `slothlet_${Date.now()}_${Math.random().toString(36).slice(2, 11).padEnd(9, "0")}`;
+		
+		
+		const { entry = import.meta.url, engine = "singleton", mode, api_mode = "auto" } = options ?? {};
+
+		
+		const executionEngine = mode && ["singleton", "vm", "worker", "fork"].includes(mode) ? mode : engine;
+
+		
+		let isLazyMode;
+		if (mode && ["lazy", "eager"].includes(mode)) {
+			isLazyMode = mode === "lazy";
+		} else {
+			isLazyMode = options.lazy !== undefined ? options.lazy : this.config.lazy;
+		}
+
+		
+		const runtimeType = normalizeRuntimeType(options.runtime || "async");
+		const loadingModeStr = isLazyMode ? "lazy" : "eager";
+		this.instanceId = `slothlet_${runtimeType}_${loadingModeStr}_${Date.now()}_${Math.random().toString(36).slice(2, 11).padEnd(9, "0")}`;
 
 		
 		if (!this.modes) {
@@ -172,18 +213,16 @@ const slothletObject = {
 
 		
 		
-		const { entry = import.meta.url, mode = "singleton", api_mode = "auto" } = options ?? {};
-
-		
-		
 		
 
-		this.mode = mode;
+		this.mode = executionEngine;
 		this.api_mode = api_mode;
 		let api;
 		let dispose;
-		if (mode === "singleton") {
-			const { context = null, reference = null, sanitize = null, ...loadConfig } = options;
+		if (executionEngine === "singleton") {
+			
+			
+			const { context = null, reference = null, sanitize = null, engine, mode, ...loadConfig } = options;
 			this.context = context;
 			this.reference = reference;
 
@@ -193,6 +232,9 @@ const slothletObject = {
 			}
 
 			
+			loadConfig.lazy = isLazyMode;
+
+			
 			
 			if (this.api_mode === "function") {
 				this.boundapi = function (...args) {
@@ -215,7 +257,8 @@ const slothletObject = {
 			return this.boundapi;
 		} else {
 			const { createEngine } = await import("./lib/engine/slothlet_engine.mjs");
-			({ api, dispose } = await createEngine({ entry, ...options }));
+			
+			({ api, dispose } = await createEngine({ entry, mode: executionEngine, ...options }));
 			
 			
 			if (typeof dispose === "function") {
@@ -235,6 +278,19 @@ const slothletObject = {
 	
 	async load(config = {}, ctxRef = { context: null, reference: null }) {
 		this.config = { ...this.config, ...config };
+
+		
+		this.config.runtime = normalizeRuntimeType(this.config.runtime);
+		
+		if (!this.runtime) {
+			if (this.config.runtime === "live") {
+				this.runtime = await import("@cldmv/slothlet/runtime/live");
+			} else {
+				
+				this.runtime = await import("@cldmv/slothlet/runtime/async");
+			}
+		}
+
 		
 		
 		let apiDir = this.config.dir || "api";
@@ -823,9 +879,23 @@ const slothletObject = {
 		
 
 		mutateLiveBindingFunction(self, newSelf);
-		Object.assign(context, newContext || {});
+
+		
+		const contextWithRuntime = {
+			...newContext,
+			runtimeType: this.config.runtime 
+		};
+		Object.assign(context, contextWithRuntime || {});
 		Object.assign(reference, newReference || {});
 
+		
+		if (this.instanceId) {
+			updateInstanceData(this.instanceId, "self", newSelf);
+			updateInstanceData(this.instanceId, "context", contextWithRuntime);
+			updateInstanceData(this.instanceId, "reference", newReference);
+			updateInstanceData(this.instanceId, "config", this.config);
+		}
+
 		this.safeDefine(this.boundapi, "__ctx", {
 			self: this.boundapi,
 			context: this.context,
@@ -1032,6 +1102,14 @@ const slothletObject = {
 				this.reference = {};
 				this._dispose = null;
 				this._boundAPIShutdown = null;
+
+				
+
+				
+				if (this.instanceId) {
+					await cleanupInstance(this.instanceId);
+				}
+
 				if (apiError || internalError) throw apiError || internalError;
 			}
 		} finally {

package/index.cjs

@@ -1,26 +1,27 @@
 /**
- * @fileoverview CommonJS entry point for @cldmv/slothlet with automatic source/dist detection and live-binding context.
- * @module @cldmv/slothlet
+ *	@Project: @cldmv/slothlet
+ *	@Filename: /index.cjs
+ *	@Date: 2025-11-09 11:15:17 -08:00 (1762715717)
+ *	@Author: Nate Hyson <CLDMV>
+ *	@Email: <Shinrai@users.noreply.github.com>
+ *	-----
+ *	@Last modified by: Nate Hyson <CLDMV> (Shinrai@users.noreply.github.com)
+ *	@Last modified time: 2025-11-09 14:43:17 -08:00 (1762728197)
+ *	-----
+ *	@Copyright: Copyright (c) 2013-2025 Catalyzed Motivation Inc. All rights reserved.
  */
 
-const runtimePromise = import("@cldmv/slothlet/runtime");
-const modPromise = import("@cldmv/slothlet/slothlet");
-
-// Development environment check (must happen before slothlet imports)
-(async () => {
-	try {
-		await import("@cldmv/slothlet/devcheck");
-	} catch {
-		// ignore
-	}
-})();
+/**
+ * @fileoverview CommonJS entry point for @cldmv/slothlet - imports ESM implementation for single source of truth.
+ * @module @cldmv/slothlet
+ */
 
 /**
- * Creates a slothlet API instance with live-binding context and AsyncLocalStorage support.
- * Automatically wraps all API functions with context isolation for multi-instance support.
+ * CommonJS entry that dynamically imports the ESM implementation.
+ * This ensures single source of truth in index.mjs while maintaining CJS compatibility.
+ * Eliminates code duplication between entry points and ensures consistent behavior.
  * @public
  * @async
- *
  * @param {object} [options={}] - Configuration options for the slothlet instance
  * @param {string} [options.dir="api"] - Directory to load API modules from
  * @param {boolean} [options.lazy=false] - Use lazy loading (true) or eager loading (false)
@@ -28,38 +29,28 @@ const modPromise = import("@cldmv/slothlet/slothlet");
  * @param {boolean} [options.debug=false] - Enable debug logging
  * @param {string} [options.mode="singleton"] - Execution mode (singleton, vm, worker, fork)
  * @param {string} [options.api_mode="auto"] - API structure mode (auto, function, object)
+ * @param {string} [options.runtime] - Runtime type ("async", "asynclocalstorage", "live", "livebindings", "experimental")
  * @param {object} [options.context={}] - Context data for live bindings
  * @param {object} [options.reference={}] - Reference objects to merge into API root
  * @returns {Promise<function|object>} The bound API object with live-binding context
  *
- * @example // CJS
+ * @example // CJS usage
  * const slothlet = require("@cldmv/slothlet");
  * const api = await slothlet({ dir: "./api", context: { user: "alice" } });
  * console.log(api.config.username); // Access configuration
+ *
+ * @example // CJS usage with runtime selection
+ * const slothlet = require("@cldmv/slothlet");
+ * const api = await slothlet({ dir: "./api", runtime: "live" });
+ *
+ * @example // CJS named destructuring
+ * const { slothlet } = require("@cldmv/slothlet");
+ * const api = await slothlet({ dir: "./api" });
  */
 async function slothlet(options = {}) {
-	const [runtime, mod] = await Promise.all([runtimePromise, modPromise]);
-	const { makeWrapper } = runtime;
-	const build = mod.slothlet ?? mod.default;
-
-	const api = await build(options);
-
-	// Prefer an explicit instance context the internal attached to the API (api.__ctx),
-	// else fall back to module-level pieces if you expose them.
-	const ctx = api?.__ctx ?? { self: mod.self, context: mod.context, reference: mod.reference };
-
-	// console.log("[DEBUG index.cjs] Context setup:", {
-	// 	hasApiCtx: !!api?.__ctx,
-	// 	ctxSelfType: typeof ctx.self,
-	// 	ctxSelfKeys: Object.keys(ctx.self || {}),
-	// 	ctxContextType: typeof ctx.context,
-	// 	ctxContextKeys: Object.keys(ctx.context || {}),
-	// 	ctxReferenceType: typeof ctx.reference,
-	// 	ctxReferenceKeys: Object.keys(ctx.reference || {}),
-	// 	fallbackToMod: !api?.__ctx
-	// });
-
-	return makeWrapper(ctx)(api);
+	// Dynamic import of ESM entry point - single source of truth
+	const { default: esmSlothlet } = await import("./index.mjs");
+	return esmSlothlet(options);
 }
 
 /**

package/index.mjs

@@ -3,6 +3,35 @@
  * @module @cldmv/slothlet
  */
 
+/**
+ * Normalize runtime input to internal standard format.
+ * @function normalizeRuntimeType
+ * @param {string} runtime - Input runtime type (various formats accepted)
+ * @returns {string} Normalized runtime type ("async" or "live")
+ * @internal
+ * @private
+ */
+function normalizeRuntimeType(runtime) {
+	if (!runtime || typeof runtime !== "string") {
+		return "async"; // Default to AsyncLocalStorage
+	}
+
+	const normalized = runtime.toLowerCase().trim();
+
+	// AsyncLocalStorage runtime variants
+	if (normalized === "async" || normalized === "asynclocal" || normalized === "asynclocalstorage") {
+		return "async";
+	}
+
+	// Live bindings runtime variants
+	if (normalized === "live" || normalized === "livebindings" || normalized === "experimental") {
+		return "live";
+	}
+
+	// Default to async for unknown values
+	return "async";
+}
+
 // Development environment check (must happen before slothlet imports)
 (async () => {
 	try {
@@ -20,10 +49,11 @@
  *
  * @param {object} [options={}] - Configuration options for the slothlet instance
  * @param {string} [options.dir="api"] - Directory to load API modules from
- * @param {boolean} [options.lazy=false] - Use lazy loading (true) or eager loading (false)
+ * @param {boolean} [options.lazy=false] - Use lazy loading (true) or eager loading (false) - legacy option
+ * @param {string} [options.mode] - Loading mode ("lazy", "eager") or execution mode ("singleton", "vm", "worker", "fork") - takes precedence over lazy option
+ * @param {string} [options.engine="singleton"] - Execution mode (singleton, vm, worker, fork)
  * @param {number} [options.apiDepth=Infinity] - Maximum directory depth to scan
  * @param {boolean} [options.debug=false] - Enable debug logging
- * @param {string} [options.mode="singleton"] - Execution mode (singleton, vm, worker, fork)
  * @param {string} [options.api_mode="auto"] - API structure mode (auto, function, object)
  * @param {object} [options.context={}] - Context data for live bindings
  * @param {object} [options.reference={}] - Reference objects to merge into API root
@@ -37,28 +67,28 @@
  */
 export default async function slothlet(options = {}) {
 	// Dynamic imports after environment check
-	const [runtime, mod] = await Promise.all([import("@cldmv/slothlet/runtime"), import("@cldmv/slothlet/slothlet")]);
+	// Dynamic imports after environment check
+	const mod = await import("@cldmv/slothlet/slothlet");
 
-	const { makeWrapper } = runtime;
 	const build = mod.slothlet ?? mod.default;
 
 	const api = await build(options);
 
+	// Use the same runtime selection logic as slothlet.mjs
+	const normalizedRuntime = normalizeRuntimeType(options.runtime);
+	let runtimeModule;
+	if (normalizedRuntime === "live") {
+		runtimeModule = await import("@cldmv/slothlet/runtime/live");
+	} else {
+		// Default to AsyncLocalStorage runtime (original master branch implementation)
+		runtimeModule = await import("@cldmv/slothlet/runtime/async");
+	}
+	const { makeWrapper } = runtimeModule;
+
 	// Prefer an explicit instance context the internal attached to the API (api.__ctx),
 	// else fall back to module-level pieces if you expose them.
 	const ctx = api?.__ctx ?? { self: mod.self, context: mod.context, reference: mod.reference };
 
-	// console.log("[DEBUG index.mjs] Context setup:", {
-	// 	hasApiCtx: !!api?.__ctx,
-	// 	ctxSelfType: typeof ctx.self,
-	// 	ctxSelfKeys: Object.keys(ctx.self || {}),
-	// 	ctxContextType: typeof ctx.context,
-	// 	ctxContextKeys: Object.keys(ctx.context || {}),
-	// 	ctxReferenceType: typeof ctx.reference,
-	// 	ctxReferenceKeys: Object.keys(ctx.reference || {}),
-	// 	fallbackToMod: !api?.__ctx
-	// });
-	// return api;
 	return makeWrapper(ctx)(api);
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@cldmv/slothlet",
-	"version": "2.5.6",
+	"version": "2.6.0",
 	"moduleVersions": {
 		"lazy": "1.3.0",
 		"eager": "1.3.0"
@@ -34,6 +34,22 @@
 			"types": "./types/dist/lib/runtime/runtime.d.mts",
 			"import": "./dist/lib/runtime/runtime.mjs"
 		},
+		"./runtime/async": {
+			"development": {
+				"types": "./types/src/lib/runtime/runtime-asynclocalstorage.d.mts",
+				"import": "./src/lib/runtime/runtime-asynclocalstorage.mjs"
+			},
+			"types": "./types/dist/lib/runtime/runtime-asynclocalstorage.d.mts",
+			"import": "./dist/lib/runtime/runtime-asynclocalstorage.mjs"
+		},
+		"./runtime/live": {
+			"development": {
+				"types": "./types/src/lib/runtime/runtime-livebindings.d.mts",
+				"import": "./src/lib/runtime/runtime-livebindings.mjs"
+			},
+			"types": "./types/dist/lib/runtime/runtime-livebindings.d.mts",
+			"import": "./dist/lib/runtime/runtime-livebindings.mjs"
+		},
 		"./helpers/*": {
 			"development": {
 				"types": "./types/src/lib/helpers/*.d.mts",

package/types/dist/lib/helpers/als-eventemitter.d.mts

@@ -3,7 +3,7 @@
  *
  * @function enableAlsForEventEmitters
  * @package
- * @param {AsyncLocalStorage} [als=sharedALS] - The AsyncLocalStorage instance to use (defaults to slothlet's shared instance)
+ * @param {AsyncLocalStorage} [als] - The AsyncLocalStorage instance to use (defaults to slothlet's shared instance)
  *
  * @description
  * Patches EventEmitter.prototype to automatically preserve AsyncLocalStorage context
@@ -18,6 +18,6 @@
  * import { enableAlsForEventEmitters } from "./als-eventemitter.mjs";
  * enableAlsForEventEmitters(als);
  */
-export function enableAlsForEventEmitters(als?: AsyncLocalStorage): void;
-export type AsyncLocalStorage = import("async_hooks").AsyncLocalStorage<any>;
+export function enableAlsForEventEmitters(als?: AsyncLocalStorage<any>): void;
+import { AsyncLocalStorage } from "node:async_hooks";
 //# sourceMappingURL=als-eventemitter.d.mts.map

package/types/dist/lib/helpers/als-eventemitter.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"als-eventemitter.d.mts","sourceRoot":"","sources":["../../../../dist/lib/helpers/als-eventemitter.mjs"],"names":[],"mappings":"AAoCA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,gDAfW,iBAAiB,QAoK3B"}
+{"version":3,"file":"als-eventemitter.d.mts","sourceRoot":"","sources":["../../../../dist/lib/helpers/als-eventemitter.mjs"],"names":[],"mappings":"AAuCA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,8EAqJC;kCA9KiC,kBAAkB"}

package/types/dist/lib/helpers/api_builder.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"api_builder.d.mts","sourceRoot":"","sources":["../../../../dist/lib/helpers/api_builder.mjs"],"names":[],"mappings":"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"}
+{"version":3,"file":"api_builder.d.mts","sourceRoot":"","sources":["../../../../dist/lib/helpers/api_builder.mjs"],"names":[],"mappings":"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"}

package/types/dist/lib/helpers/auto-wrap.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"auto-wrap.d.mts","sourceRoot":"","sources":["../../../../dist/lib/helpers/auto-wrap.mjs"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;;;GAIG;AAEH;;;;;;;;;;;;;;;;;;GAkBG;AACH,kDAdW,SAAS,GACP,SAAS,CA2CrB;AAED;;;;;;;GAOG;AACH,0BAJa,OAAO,CAAC,SAAS,CAAC,CAO9B;wBAGY,cAAc,UAAU,CAAC;wBACzB,OAAO,UAAU,EAAE,MAAM"}
+{"version":3,"file":"auto-wrap.d.mts","sourceRoot":"","sources":["../../../../dist/lib/helpers/auto-wrap.mjs"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;;;GAIG;AAEH;;;;;;;;;;;;;;;;;;GAkBG;AACH,kDAdW,SAAS,GACP,SAAS,CA6CrB;AAED;;;;;;;GAOG;AACH,0BAJa,OAAO,CAAC,SAAS,CAAC,CAO9B;wBAGY,cAAc,UAAU,CAAC;wBACzB,OAAO,UAAU,EAAE,MAAM"}

package/types/dist/lib/helpers/instance-manager.d.mts

@@ -0,0 +1,41 @@
+/**
+ * Get instance data by ID
+ * @param {string} instanceId - Instance identifier
+ * @returns {object|null} Instance data or null if not found
+ */
+export function getInstanceData(instanceId: string): object | null;
+/**
+ * Update instance data for a specific key
+ * @param {string} instanceId - Instance identifier
+ * @param {string} key - Data key (self, context, reference)
+ * @param {any} value - Data value
+ * @returns {void}
+ */
+export function updateInstanceData(instanceId: string, key: string, value: any): void;
+/**
+ * Clean up instance data when no longer needed
+ * @param {string} instanceId - Instance identifier
+ * @returns {Promise<void>}
+ */
+export function cleanupInstance(instanceId: string): Promise<void>;
+/**
+ * Set the currently active instance (called during module loading)
+ * @param {string|null} instanceId - Instance ID to set as active
+ */
+export function setActiveInstance(instanceId: string | null): void;
+/**
+ * Get the current active instance ID
+ * @returns {string|null} Current active instance ID
+ */
+export function getCurrentActiveInstanceId(): string | null;
+/**
+ * Detect current instance ID from stack trace
+ * @returns {string|null} Detected instance ID or null
+ */
+export function detectCurrentInstanceId(): string | null;
+/**
+ * Get all registered instance IDs
+ * @returns {string[]} Array of instance IDs
+ */
+export function getAllInstanceIds(): string[];
+//# sourceMappingURL=instance-manager.d.mts.map

package/types/dist/lib/helpers/instance-manager.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instance-manager.d.mts","sourceRoot":"","sources":["../../../../dist/lib/helpers/instance-manager.mjs"],"names":[],"mappings":"AAmBA;;;;GAIG;AACH,4CAHW,MAAM,GACJ,MAAM,GAAC,IAAI,CAIvB;AAED;;;;;;GAMG;AACH,+CALW,MAAM,OACN,MAAM,SACN,GAAG,GACD,IAAI,CAqBhB;AAED;;;;GAIG;AACH,4CAHW,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CASzB;AAED;;;GAGG;AACH,8CAFW,MAAM,GAAC,IAAI,QAKrB;AAED;;;GAGG;AACH,8CAFa,MAAM,GAAC,IAAI,CAIvB;AAED;;;GAGG;AACH,2CAFa,MAAM,GAAC,IAAI,CAkCvB;AAED;;;GAGG;AACH,qCAFa,MAAM,EAAE,CAIpB"}

package/types/dist/lib/modes/slothlet_lazy.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"slothlet_lazy.d.mts","sourceRoot":"","sources":["../../../../dist/lib/modes/slothlet_lazy.mjs"],"names":[],"mappings":"AAiKA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,4BAtBW,MAAM,aACN,MAAM,iBACN,MAAM,GACJ,OAAO,CAAC,WAAS,MAAM,CAAC,CA4JpC"}
+{"version":3,"file":"slothlet_lazy.d.mts","sourceRoot":"","sources":["../../../../dist/lib/modes/slothlet_lazy.mjs"],"names":[],"mappings":"AAgKA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,4BAtBW,MAAM,aACN,MAAM,iBACN,MAAM,GACJ,OAAO,CAAC,WAAS,MAAM,CAAC,CAkKpC"}

package/types/dist/lib/runtime/runtime-asynclocalstorage.d.mts

@@ -0,0 +1,58 @@
+/**
+ * Shared AsyncLocalStorage instance for all slothlet instances.
+ * Provides unified context management across all EventEmitter wrappers.
+ * @type {AsyncLocalStorageType}
+ * @public
+ */
+export const sharedALS: AsyncLocalStorageType;
+export function runWithCtx(ctx: object, fn: Function, thisArg: any, args: any[]): any;
+export function getCtx(): object | null;
+export function makeWrapper(ctx: object): Function;
+/**
+ * @constant self
+ * @memberof module:@cldmv/slothlet/runtime
+ * @export module:@cldmv/slothlet/runtime
+ * @public
+ * @type {function|object}
+ *
+ * @description
+ * Live binding to the current instance's 'self' reference from AsyncLocalStorage context.
+ *
+ * @example
+ * // Access current instance self
+ * console.log(self); // Current slothlet instance
+ */
+export const self: Function | object;
+/**
+ * @constant context
+ * @memberof module:@cldmv/slothlet/runtime
+ * @export module:@cldmv/slothlet/runtime
+ * @public
+ * @type {object}
+ *
+ * @description
+ * Live binding to the current instance's 'context' data from AsyncLocalStorage context.
+ *
+ * @example
+ * // Access current context data
+ * console.log(context); // Current context object
+ */
+export const context: object;
+/**
+ * @constant reference
+ * @memberof module:@cldmv/slothlet/runtime
+ * @export module:@cldmv/slothlet/runtime
+ * @public
+ * @type {object}
+ *
+ * @description
+ * Live binding to the current instance's 'reference' object from AsyncLocalStorage context.
+ *
+ * @example
+ * // Access current reference object
+ * console.log(reference); // Current reference data
+ */
+export const reference: object;
+export type AsyncLocalStorageType = AsyncLocalStorage<any>;
+import { AsyncLocalStorage } from "node:async_hooks";
+//# sourceMappingURL=runtime-asynclocalstorage.d.mts.map

package/types/dist/lib/runtime/runtime-asynclocalstorage.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-asynclocalstorage.d.mts","sourceRoot":"","sources":["../../../../dist/lib/runtime/runtime-asynclocalstorage.mjs"],"names":[],"mappings":"AAuCA;;;;;GAKG;AACH,wBAHU,qBAAqB,CAGkB;AAsB1C,gCAdI,MAAM,yBAEN,GAAG,gBAED,GAAG,CA6Bf;AAiBM,0BAZM,MAAM,GAAC,IAAI,CAY0B;AAiL3C,iCAjBI,MAAM,YAgIhB;AAuSD;;;;;;;;;;;;;GAaG;AACH,mBATU,WAAS,MAAM,CAS6B;AAEtD;;;;;;;;;;;;;GAaG;AACH,sBATU,MAAM,CAS4C;AAE5D;;;;;;;;;;;;;GAaG;AACH,wBATU,MAAM,CASgD;;kCA3rB9B,kBAAkB"}

package/types/dist/lib/runtime/runtime-livebindings.d.mts

@@ -0,0 +1,58 @@
+/**
+ * Context-aware function execution with temporary active instance override.
+ * Sets the active instance based on the context before calling the function,
+ * ensuring CJS runtime imports detect the correct instance.
+ * @param {object} ctx - Context object containing instanceId
+ * @param {Function} fn - Function to execute
+ * @param {any} thisArg - The this argument
+ * @param {Array} args - The function arguments
+ * @returns {any} The function result
+ */
+export function runWithCtx(ctx: object, fn: Function, thisArg: any, args: any[]): any;
+/**
+ * Legacy makeWrapper function for backwards compatibility.
+ * @internal
+ * @param {object} ctx - The context to bind
+ * @returns {function} A wrapper function
+ */
+export function makeWrapper(_: any): Function;
+/**
+ * Legacy context management functions - kept for backwards compatibility
+ * but may not be needed with instance detection approach.
+ */
+export function getContext(): any;
+export function setContext(newContext: any): void;
+/**
+ * Live-binding reference to the current API instance.
+ * Automatically resolves to the appropriate instance based on calling context.
+ * @type {object}
+ * @public
+ */
+export const self: object;
+/**
+ * Live-binding reference for contextual data.
+ * Automatically resolves to the appropriate instance context.
+ * @type {object}
+ * @public
+ */
+export const context: object;
+/**
+ * Live-binding reference for reference data.
+ * Automatically resolves to the appropriate instance reference.
+ * @type {object}
+ * @public
+ */
+export const reference: object;
+/**
+ * Live-binding reference to the current instance ID.
+ * Automatically resolves to the current instance identifier.
+ * @type {string}
+ * @public
+ */
+export const instanceId: string;
+export namespace contextManager {
+    export { getContext as get };
+    export { setContext as set };
+    export { runWithCtx };
+}
+//# sourceMappingURL=runtime-livebindings.d.mts.map

package/types/dist/lib/runtime/runtime-livebindings.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-livebindings.d.mts","sourceRoot":"","sources":["../../../../dist/lib/runtime/runtime-livebindings.mjs"],"names":[],"mappings":"AA2RA;;;;;;;;;GASG;AACH,gCANW,MAAM,yBAEN,GAAG,gBAED,GAAG,CAkBf;AAED;;;;;GAKG;AACH,8CAMC;AAID;;;GAGG;AAEH,kCAEC;AAED,kDASC;AArQD;;;;;GAKG;AACH,mBAHU,MAAM,CAmDd;AAEF;;;;;GAKG;AACH,sBAHU,MAAM,CA+Cd;AAEF;;;;;GAKG;AACH,wBAHU,MAAM,CA+Cd;AAEF;;;;;GAKG;AACH,yBAHU,MAAM,CAkCd"}