@cldmv/slothlet 3.3.0 → 3.3.2

package/dist/slothlet.mjs

@@ -14,820 +14,4 @@
 	limitations under the License.
 */
 
-
-
-
-import { readdirSync } from "node:fs";
-import { dirname, join } from "node:path";
-import { fileURLToPath, pathToFileURL } from "node:url";
-import { getContextManager } from "@cldmv/slothlet/factories/context";
-import { SlothletError, SlothletWarning, SlothletDebug } from "@cldmv/slothlet/errors";
-import { registerInstance } from "@cldmv/slothlet/handlers/lifecycle-token";
-import { resolveWrapper } from "@cldmv/slothlet/handlers/unified-wrapper";
-import { initI18n } from "@cldmv/slothlet/i18n";
-import {
-	enableEventEmitterPatching,
-	disableEventEmitterPatching,
-	cleanupEventEmitterResources,
-	setApiContextChecker
-} from "@cldmv/slothlet/helpers/eventemitter-context";
-
-
-class Slothlet {
-	
-	
-	static RESERVED_ROOT_KEYS = ["slothlet", "shutdown", "destroy"];
-
-	
-	static SKIP_PROPS = ["__metadata", "__type", "_materialize", "_impl", "____slothletInternal"];
-
-	constructor() {
-		
-		this.SlothletError = SlothletError;
-		this.SlothletWarning = SlothletWarning;
-		
-		this.debugLogger = null;
-
-		
-		this.instanceID = null;
-		this.config = null;
-		this.api = null;
-		this.boundApi = null; 
-		this.contextManager = null;
-		this.isLoaded = false;
-		this.reference = null;
-		this.context = null;
-
-		
-		this.envSnapshot = null;
-
-		
-		this._totalLazyCount = 0; 
-		this._unmaterializedLazyCount = 0; 
-		this._materializationComplete = false; 
-		this._materializationWaiters = []; 
-		this._materializationCompleteEmitted = false; 
-
-		
-		this.componentCategories = ["helpers", "handlers", "builders", "processors", "modes"];
-
-		
-		for (const category of this.componentCategories) {
-			this[category] = {};
-		}
-	}
-
-	
-	async _initializeComponents() {
-		
-		
-		
-		
-		
-
-		const baseDir = join(dirname(fileURLToPath(import.meta.url)), "lib");
-
-		for (const category of this.componentCategories) {
-			const categoryDir = join(baseDir, category);
-			const files = readdirSync(categoryDir).filter((f) => f.endsWith(".mjs"));
-
-			for (const file of files) {
-				const filePath = join(categoryDir, file);
-
-				try {
-					const module = await import(pathToFileURL(filePath).href);
-
-					
-					const classExports = Object.values(module).filter((exp) => typeof exp === "function" && exp.slothletProperty);
-
-					for (const ClassExport of classExports) {
-						const propName = ClassExport.slothletProperty;
-						
-						this[category][propName] = new ClassExport(this);
-
-						if (this.config?.debug?.initialization) {
-							this.debug("initialization", {
-								key: "DEBUG_MODE_COMPONENT_INITIALIZED",
-								component: ClassExport.name,
-								category,
-								propertyName: propName
-							});
-						}
-					}
-				} catch (error) {
-					
-					
-					
-					
-					throw new this.SlothletError(
-						"MODULE_IMPORT_FAILED",
-						{
-							modulePath: filePath
-						},
-						error
-					);
-				}
-			}
-		}
-	}
-
-	
-	_setupLifecycleSubscribers() {
-		
-		
-		if (!this.handlers.lifecycle) {
-			return; 
-		}
-		
-
-		
-		
-		
-		if (this.handlers.metadata) {
-			this.handlers.lifecycle.subscribe("impl:created", (data, token) => {
-				this.handlers.metadata.tagSystemMetadata(
-					data.impl,
-					{
-						filePath: data.filePath,
-						apiPath: data.apiPath,
-						moduleID: data.moduleID,
-						sourceFolder: data.sourceFolder
-					},
-					token
-				);
-			});
-
-			this.handlers.lifecycle.subscribe("impl:changed", (data, token) => {
-				this.handlers.metadata.tagSystemMetadata(
-					data.impl,
-					{
-						filePath: data.filePath,
-						apiPath: data.apiPath,
-						moduleID: data.moduleID,
-						sourceFolder: data.sourceFolder
-					},
-					token
-				);
-			});
-
-			this.handlers.lifecycle.subscribe("impl:removed", (data) => {
-				
-				
-				
-				if (data.apiPath) {
-					const rootSegment = data.apiPath.split(".")[0];
-					this.handlers.metadata.removeUserMetadataByApiPath(rootSegment);
-				}
-			});
-		}
-
-		
-		
-		
-		if (this.handlers.ownership) {
-			
-			
-			this.handlers.lifecycle.subscribe("impl:created", (data) => {
-				
-				
-				
-				const collisionMode = this.config?.collision?.api || "merge";
-				
-				const implValue = data.wrapper?.__impl ?? data.impl;
-				this.handlers.ownership.register({
-					moduleID: data.moduleID,
-					apiPath: data.apiPath,
-					value: implValue,
-					source: data.source,
-					filePath: data.filePath,
-					collisionMode: collisionMode
-				});
-			});
-
-			
-			
-			this.handlers.lifecycle.subscribe("impl:changed", (data) => {
-				
-				
-				
-				const collisionMode = this.config?.collision?.api || "merge";
-				
-				
-				
-				const implValue = data.wrapper?.__impl ?? data.impl;
-
-				
-				
-				const currentOwner = this.handlers.ownership.getCurrentOwner(data.apiPath);
-				if (currentOwner?.moduleID !== data.moduleID) {
-					this.handlers.ownership.register({
-						moduleID: data.moduleID,
-						apiPath: data.apiPath,
-						value: implValue,
-						source: data.source,
-						filePath: data.filePath,
-						collisionMode: collisionMode
-					});
-				}
-			});
-		}
-	}
-
-	
-	_registerLazyWrapper() {
-		this._totalLazyCount++;
-		this._unmaterializedLazyCount++;
-
-		if (this.config?.debug?.materialize) {
-			this.debug("materialize", {
-				key: "DEBUG_MODE_LAZY_WRAPPER_REGISTERED",
-				total: this._totalLazyCount,
-				unmaterialized: this._unmaterializedLazyCount
-			});
-		}
-	}
-
-	
-	_onWrapperMaterialized() {
-		this._unmaterializedLazyCount--;
-
-		if (this.config?.debug?.materialize) {
-			this.debug("materialize", {
-				key: "DEBUG_MODE_LAZY_WRAPPER_MATERIALIZED",
-				total: this._totalLazyCount,
-				unmaterialized: this._unmaterializedLazyCount,
-				
-				
-				percentage: this._totalLazyCount > 0 ? ((this._totalLazyCount - this._unmaterializedLazyCount) / this._totalLazyCount) * 100 : 100
-			});
-		}
-
-		
-		if (this._unmaterializedLazyCount === 0 && !this._materializationComplete) {
-			this._materializationComplete = true;
-
-			if (this.config?.debug?.materialize) {
-				this.debug("materialize", {
-					key: "DEBUG_MODE_ALL_LAZY_WRAPPERS_MATERIALIZED",
-					total: this._totalLazyCount
-				});
-			}
-
-			
-			const waiters = this._materializationWaiters.splice(0);
-			for (const resolve of waiters) {
-				resolve();
-			}
-
-			
-			if (this.config?.tracking?.materialization && !this._materializationCompleteEmitted) {
-				this._materializationCompleteEmitted = true;
-				
-				
-				if (this.handlers?.lifecycle) {
-					this.handlers.lifecycle.emit("materialized:complete", {
-						total: this._totalLazyCount,
-						timestamp: Date.now()
-					});
-				}
-			}
-		}
-	}
-
-	
-	_captureEnvSnapshot(envConfig) {
-		const rawInclude = envConfig?.include;
-		const include = Array.isArray(rawInclude) ? rawInclude.filter((key) => typeof key === "string") : null;
-		const useAllowlist = include !== null && include.length > 0;
-		const raw = useAllowlist
-			? include.reduce((acc, key) => {
-					if (Object.prototype.hasOwnProperty.call(process.env, key)) {
-						acc[key] = process.env[key];
-					}
-					return acc;
-				}, Object.create(null))
-			: { ...process.env };
-		return Object.freeze(raw);
-	}
-
-	
-	async load(config = {}, preservedInstanceID = null) {
-		
-		this.config = config;
-
-		
-		
-		
-		
-		
-		if (!this.envSnapshot) {
-			this.envSnapshot = this._captureEnvSnapshot(config.env);
-		}
-
-		
-		
-		
-		this.debugLogger = new SlothletDebug(config);
-
-		
-		
-		await this._initializeComponents();
-
-		
-		registerInstance(this);
-
-		
-		this._setupLifecycleSubscribers();
-
-		
-		this.config = this.helpers.config.transformConfig(config);
-
-		
-		if (this.config?.i18n?.language) {
-			initI18n({ language: this.config.i18n.language });
-		}
-
-		
-		
-		this.debugLogger = new SlothletDebug(this.config);
-
-		
-		this.instanceID = preservedInstanceID || this.helpers.utilities.generateId();
-
-		
-		this.reference = this.config.reference;
-		this.context = this.config.context;
-
-		
-		this.contextManager = getContextManager(this.config.runtime);
-
-		
-		
-		
-		
-		
-		
-		
-		
-		setApiContextChecker(() => {
-			
-			const ctx = this.contextManager.tryGetContext();
-			return !!(ctx && ctx.self);
-			
-		});
-		
-
-		
-		let store;
-		if (preservedInstanceID && this.contextManager.instances.has(preservedInstanceID)) {
-			
-			this.contextManager.cleanup(preservedInstanceID);
-			store = this.contextManager.initialize(this.instanceID, this.config);
-		} else {
-			
-			store = this.contextManager.initialize(this.instanceID, this.config);
-		}
-
-		
-		
-		enableEventEmitterPatching();
-
-		
-		
-		
-		if (typeof this.contextManager.registerEventEmitterContextChecker === "function") {
-			this.contextManager.registerEventEmitterContextChecker();
-		}
-
-		
-
-		
-		const baseModuleId = `base_${this.helpers.utilities.generateId().substring(0, 8)}`;
-
-		
-		
-		const baseApi = await this.builders.builder.buildAPI({
-			dir: this.config.dir,
-			mode: this.config.mode,
-			moduleID: baseModuleId
-		});
-
-		
-		
-		this.api = baseApi;
-
-		
-		const apiWithBuiltins = await this.buildFinalAPI(this.api);
-
-		
-		
-		
-		
-		if (this.handlers.apiCacheManager) {
-			this.handlers.apiCacheManager.set(baseModuleId, {
-				endpoint: ".",
-				moduleID: baseModuleId,
-				api: this.api, 
-				folderPath: this.config.dir,
-				mode: this.config.mode,
-				sanitizeOptions: this.config.sanitize || {},
-				
-				
-				collisionMode: this.config.collision?.api || "merge",
-				config: { ...this.config },
-				timestamp: Date.now()
-			});
-		}
-
-		
-		this.injectRuntimeMetadataFunctions(apiWithBuiltins);
-
-		
-		if (this.config.metadata && typeof this.config.metadata === "object") {
-			
-			for (const [key, value] of Object.entries(this.config.metadata)) {
-				this.handlers.metadata.setGlobalMetadata(key, value);
-			}
-
-			
-			this.handlers.metadata.registerUserMetadata(baseModuleId, this.config.metadata);
-		}
-
-		
-		
-		
-		
-		if (this.handlers.ownership) {
-			this.handlers.ownership.registerSubtree(apiWithBuiltins, baseModuleId, "");
-		}
-
-		
-		
-
-		
-		if (!this.boundApi) {
-			
-			
-			
-			const isCallable = typeof this.api === "function" || (this.api && typeof this.api.default === "function");
-			const proxyTarget = isCallable ? function () {} : {};
-
-			this.boundApi = new Proxy(proxyTarget, {
-				get: (target, prop) => (this.api ? this.api[prop] : undefined),
-				set: (target, prop, value) => {
-					if (this.api) {
-						this.api[prop] = value;
-					}
-					return true;
-				},
-				has: (target, prop) => (this.api ? prop in this.api : false),
-				ownKeys: (____target) => (this.api ? Reflect.ownKeys(this.api) : []),
-				deleteProperty: (target, prop) => (this.api ? delete this.api[prop] : true),
-				apply: (target, thisArg, args) => (this.api ? Reflect.apply(this.api, thisArg, args) : undefined),
-				construct: (target, args) => (this.api ? Reflect.construct(this.api, args) : {}),
-				getOwnPropertyDescriptor: (target, prop) => {
-					
-					if (isCallable && prop === "prototype") {
-						return Object.getOwnPropertyDescriptor(target, prop);
-					}
-					if (this.api && prop in this.api) {
-						const desc = Object.getOwnPropertyDescriptor(this.api, prop);
-						if (desc) {
-							return { ...desc, configurable: true };
-						}
-					}
-					return undefined;
-				}
-			});
-			
-		}
-
-		
-		store.self = this.boundApi;
-		store.context = this.context || {}; 
-
-		
-		
-		if (this.reference && typeof this.reference === "object") {
-			Object.assign(this.boundApi, this.reference);
-		}
-
-		this.isLoaded = true;
-
-		return this.boundApi;
-	}
-
-	
-	async reload(options = {}) {
-		const { keepInstanceID = false } = options;
-
-		
-		
-		if (!this.config?.dir) {
-			throw new SlothletError("INVALID_CONFIG_NOT_LOADED", {
-				operation: "reload",
-				validationError: true
-			});
-		}
-
-		
-		
-		
-		const operationHistory = this.handlers.apiManager?.state?.operationHistory ? [...this.handlers.apiManager.state.operationHistory] : [];
-
-		
-		await this._clearModuleCaches();
-
-		
-		
-		
-		
-		const oldInstanceID = this.instanceID;
-		if (!keepInstanceID) {
-			this.instanceID = `${oldInstanceID}_reload_${Date.now()}`;
-		}
-
-		
-		
-		const savedMetadataState = this.handlers.metadata?.exportUserState?.();
-
-		
-		
-		const savedHooks = this.handlers.hookManager?.exportHooks?.();
-
-		
-		await this.load(this.config, this.instanceID);
-
-		
-		
-		
-		
-		if (savedMetadataState && this.handlers.metadata) {
-			this.handlers.metadata.importUserState(savedMetadataState);
-		}
-
-		
-		
-		
-		if (savedHooks?.length && this.handlers.hookManager) {
-			this.handlers.hookManager.importHooks(savedHooks);
-		}
-
-		
-		
-		
-		for (const [, store] of this.contextManager.instances) {
-			if (store.parentInstanceID === oldInstanceID) {
-				store.parentInstanceID = this.instanceID;
-			}
-		}
-
-		
-		
-		if (oldInstanceID && oldInstanceID !== this.instanceID && this.contextManager.instances?.has(oldInstanceID)) {
-			this.contextManager.cleanup(oldInstanceID);
-		}
-
-		
-		for (const operation of operationHistory) {
-			if (operation.type === "add") {
-				await this.handlers.apiManager.addApiComponent({
-					apiPath: operation.apiPath,
-					folderPath: operation.folderPath,
-					
-					
-					options: { ...(operation.options || {}), recordHistory: false },
-					moduleID: `replay_${this.helpers.utilities.generateId().substring(0, 8)}`, 
-					versionConfig: operation.versionConfig || null
-				});
-			} else if (operation.type === "remove") {
-				
-				
-				const { parts } = this.handlers.apiManager.normalizeApiPath(operation.apiPath);
-				this.handlers.apiManager.deletePath(this.api, parts);
-				
-				
-				
-				if (this.handlers.metadata) {
-					const rootSegment = operation.apiPath.split(".")[0];
-					this.handlers.metadata.removeUserMetadataByApiPath(rootSegment);
-				}
-			} else if (operation.type === "addPermissionRule") {
-				if (this.handlers.permissionManager) {
-					this.handlers.permissionManager.addRule(operation.rule, operation.ownerModuleID, operation.ruleId);
-				}
-			} else if (operation.type === "removePermissionRule") {
-				if (this.handlers.permissionManager) {
-					this.handlers.permissionManager.removeRule(operation.ruleId, operation.callerModuleID);
-				}
-			}
-		}
-
-		return this.boundApi;
-	}
-
-	
-	async _clearModuleCaches() {
-		
-		
-		const targetDir = this.config.dir;
-		const { resolve } = await import("node:path");
-		const { createRequire } = await import("node:module");
-		const require = createRequire(import.meta.url);
-		const absoluteTargetDir = resolve(targetDir);
-
-		
-		for (const key of Object.keys(require.cache)) {
-			if (key.startsWith(absoluteTargetDir)) {
-				delete require.cache[key];
-			}
-		}
-
-		
-		
-	}
-
-	
-	injectRuntimeMetadataFunctions(api) {
-		if (!api.slothlet?.metadata) {
-			return;
-		}
-
-		const metadataHandler = this.handlers.metadata;
-
-		
-		api.slothlet.metadata.get = async function slothlet_metadata_get_runtime(path) {
-			return metadataHandler.get(path);
-		};
-
-		api.slothlet.metadata.self = function slothlet_metadata_self_runtime() {
-			return metadataHandler.self();
-		};
-
-		api.slothlet.metadata.caller = function slothlet_metadata_caller_runtime() {
-			return metadataHandler.caller();
-		};
-	}
-
-	
-	async _drainInFlightLoads() {
-		if (!this.api) return;
-
-		const pending = [];
-		const seen = new Set();
-
-		
-		const collect = (obj, depth = 0) => {
-			
-			
-			
-			
-			const objType = typeof obj;
-			if (!obj || (objType !== "object" && objType !== "function") || depth > 15 || seen.has(obj)) return;
-			seen.add(obj);
-
-			try {
-				
-				if (obj.__isVersionDispatcher === true) return;
-
-				
-				
-				
-				
-				const wrapper = resolveWrapper(obj);
-				if (wrapper) {
-					const mat = wrapper.____slothletInternal.materializationPromise;
-					if (mat) pending.push(mat);
-
-					
-					
-					
-					
-					
-					for (const key of Object.keys(wrapper)) {
-						if (!key.startsWith("____")) collect(wrapper[key], depth + 1);
-					}
-					return;
-				}
-
-				for (const key of Object.keys(obj)) {
-					collect(obj[key], depth + 1);
-				}
-			} catch {
-				
-				
-			}
-		};
-
-		for (const key of Object.keys(this.api)) {
-			collect(this.api[key]);
-		}
-
-		if (pending.length > 0) {
-			await Promise.allSettled(pending);
-		}
-	}
-
-	
-	async shutdown() {
-		if (!this.isLoaded) {
-			return;
-		}
-
-		
-		
-		
-		await this._drainInFlightLoads();
-
-		
-		disableEventEmitterPatching();
-		cleanupEventEmitterResources();
-
-		
-		if (this.instanceID && this.contextManager) {
-			this.contextManager.cleanup(this.instanceID);
-		}
-
-		
-		
-		
-		if (this.handlers.ownership) {
-			this.handlers.ownership.clear();
-		}
-
-		
-		this.handlers.versionManager?.shutdown();
-
-		
-		await this.handlers.permissionManager?.shutdown();
-
-		
-		
-		this.isLoaded = false;
-	}
-
-	
-	debug(code, context = {}) {
-		if (this.debugLogger) {
-			this.debugLogger.log(code, context);
-		}
-	}
-
-	
-	getAPI() {
-		if (!this.isLoaded) {
-			throw new SlothletError(
-				"INVALID_CONFIG_NOT_LOADED",
-				{
-					operation: "getAPI"
-				},
-				null,
-				{ validationError: true }
-			);
-		}
-		return this.boundApi;
-	}
-
-	
-	getDiagnostics() {
-		return {
-			instanceID: this.instanceID,
-			isLoaded: this.isLoaded,
-			config: this.config,
-			context: this.contextManager?.getDiagnostics() || null,
-			ownership: this.handlers.ownership?.getDiagnostics() || null
-		};
-	}
-
-	
-	getOwnership() {
-		if (!this.handlers.ownership) {
-			return null;
-		}
-		return this.handlers.ownership.getDiagnostics();
-	}
-
-	
-	buildFinalAPI(userApi) {
-		return this.builders.apiBuilder.buildFinalAPI(userApi);
-	}
-}
-
-
-export async function slothlet(config) {
-	const instance = new Slothlet();
-	const api = await instance.load(config);
-
-	
-	return api;
-}
-
-export default slothlet;
-
-
-
-
-
-
-
-
+import{readdirSync}from"node:fs";import{dirname,join}from"node:path";import{fileURLToPath,pathToFileURL}from"node:url";import{getContextManager}from"@cldmv/slothlet/factories/context";import{SlothletError,SlothletWarning,SlothletDebug}from"@cldmv/slothlet/errors";import{registerInstance}from"@cldmv/slothlet/handlers/lifecycle-token";import{resolveWrapper}from"@cldmv/slothlet/handlers/unified-wrapper";import{initI18n}from"@cldmv/slothlet/i18n";import{enableEventEmitterPatching,disableEventEmitterPatching,cleanupEventEmitterResources,setApiContextChecker}from"@cldmv/slothlet/helpers/eventemitter-context";class Slothlet{static RESERVED_ROOT_KEYS=["slothlet","shutdown","destroy"];static SKIP_PROPS=["__metadata","__type","_materialize","_impl","____slothletInternal"];constructor(){this.SlothletError=SlothletError;this.SlothletWarning=SlothletWarning;this.debugLogger=null;this.instanceID=null;this.config=null;this.api=null;this.boundApi=null;this.contextManager=null;this.isLoaded=false;this.reference=null;this.context=null;this.envSnapshot=null;this._totalLazyCount=0;this._unmaterializedLazyCount=0;this._materializationComplete=false;this._materializationWaiters=[];this._materializationCompleteEmitted=false;this.componentCategories=["helpers","handlers","builders","processors","modes"];for(const category of this.componentCategories){this[category]={}}}async _initializeComponents(){const baseDir=join(dirname(fileURLToPath(import.meta.url)),"lib");for(const category of this.componentCategories){const categoryDir=join(baseDir,category);const files=readdirSync(categoryDir).filter(f=>f.endsWith(".mjs"));for(const file of files){const filePath=join(categoryDir,file);try{const module=await import(pathToFileURL(filePath).href);const classExports=Object.values(module).filter(exp=>typeof exp==="function"&&exp.slothletProperty);for(const ClassExport of classExports){const propName=ClassExport.slothletProperty;this[category][propName]=new ClassExport(this);if(this.config?.debug?.initialization){this.debug("initialization",{key:"DEBUG_MODE_COMPONENT_INITIALIZED",component:ClassExport.name,category,propertyName:propName})}}}catch(error){throw new this.SlothletError("MODULE_IMPORT_FAILED",{modulePath:filePath},error)}}}}_setupLifecycleSubscribers(){if(!this.handlers.lifecycle){return}if(this.handlers.metadata){this.handlers.lifecycle.subscribe("impl:created",(data,token)=>{this.handlers.metadata.tagSystemMetadata(data.impl,{filePath:data.filePath,apiPath:data.apiPath,moduleID:data.moduleID,sourceFolder:data.sourceFolder},token)});this.handlers.lifecycle.subscribe("impl:changed",(data,token)=>{this.handlers.metadata.tagSystemMetadata(data.impl,{filePath:data.filePath,apiPath:data.apiPath,moduleID:data.moduleID,sourceFolder:data.sourceFolder},token)});this.handlers.lifecycle.subscribe("impl:removed",data=>{if(data.apiPath){const rootSegment=data.apiPath.split(".")[0];this.handlers.metadata.removeUserMetadataByApiPath(rootSegment)}})}if(this.handlers.ownership){this.handlers.lifecycle.subscribe("impl:created",data=>{const collisionMode=this.config?.collision?.api||"merge";const implValue=data.wrapper?.__impl??data.impl;this.handlers.ownership.register({moduleID:data.moduleID,apiPath:data.apiPath,value:implValue,source:data.source,filePath:data.filePath,collisionMode})});this.handlers.lifecycle.subscribe("impl:changed",data=>{const collisionMode=this.config?.collision?.api||"merge";const implValue=data.wrapper?.__impl??data.impl;const currentOwner=this.handlers.ownership.getCurrentOwner(data.apiPath);if(currentOwner?.moduleID!==data.moduleID){this.handlers.ownership.register({moduleID:data.moduleID,apiPath:data.apiPath,value:implValue,source:data.source,filePath:data.filePath,collisionMode})}})}}_registerLazyWrapper(){this._totalLazyCount++;this._unmaterializedLazyCount++;if(this.config?.debug?.materialize){this.debug("materialize",{key:"DEBUG_MODE_LAZY_WRAPPER_REGISTERED",total:this._totalLazyCount,unmaterialized:this._unmaterializedLazyCount})}}_onWrapperMaterialized(){this._unmaterializedLazyCount--;if(this.config?.debug?.materialize){this.debug("materialize",{key:"DEBUG_MODE_LAZY_WRAPPER_MATERIALIZED",total:this._totalLazyCount,unmaterialized:this._unmaterializedLazyCount,percentage:this._totalLazyCount>0?(this._totalLazyCount-this._unmaterializedLazyCount)/this._totalLazyCount*100:100})}if(this._unmaterializedLazyCount===0&&!this._materializationComplete){this._materializationComplete=true;if(this.config?.debug?.materialize){this.debug("materialize",{key:"DEBUG_MODE_ALL_LAZY_WRAPPERS_MATERIALIZED",total:this._totalLazyCount})}const waiters=this._materializationWaiters.splice(0);for(const resolve of waiters){resolve()}if(this.config?.tracking?.materialization&&!this._materializationCompleteEmitted){this._materializationCompleteEmitted=true;if(this.handlers?.lifecycle){this.handlers.lifecycle.emit("materialized:complete",{total:this._totalLazyCount,timestamp:Date.now()})}}}}_captureEnvSnapshot(envConfig){const rawInclude=envConfig?.include;const include=Array.isArray(rawInclude)?rawInclude.filter(key=>typeof key==="string"):null;const useAllowlist=include!==null&&include.length>0;const raw=useAllowlist?include.reduce((acc,key)=>{if(Object.prototype.hasOwnProperty.call(process.env,key)){acc[key]=process.env[key]}return acc},Object.create(null)):{...process.env};return Object.freeze(raw)}async load(config={},preservedInstanceID=null){this.config=config;if(!this.envSnapshot){this.envSnapshot=this._captureEnvSnapshot(config.env)}this.debugLogger=new SlothletDebug(config);await this._initializeComponents();registerInstance(this);this._setupLifecycleSubscribers();this.config=this.helpers.config.transformConfig(config);if(this.config?.i18n?.language){initI18n({language:this.config.i18n.language})}this.debugLogger=new SlothletDebug(this.config);this.instanceID=preservedInstanceID||this.helpers.utilities.generateId();this.reference=this.config.reference;this.context=this.config.context;this.contextManager=getContextManager(this.config.runtime);setApiContextChecker(()=>{const ctx=this.contextManager.tryGetContext();return!!(ctx&&ctx.self)});let store;if(preservedInstanceID&&this.contextManager.instances.has(preservedInstanceID)){this.contextManager.cleanup(preservedInstanceID);store=this.contextManager.initialize(this.instanceID,this.config)}else{store=this.contextManager.initialize(this.instanceID,this.config)}enableEventEmitterPatching();if(typeof this.contextManager.registerEventEmitterContextChecker==="function"){this.contextManager.registerEventEmitterContextChecker()}const baseModuleId=`base_${this.helpers.utilities.generateId().substring(0,8)}`;const baseApi=await this.builders.builder.buildAPI({dir:this.config.dir,mode:this.config.mode,moduleID:baseModuleId});this.api=baseApi;const apiWithBuiltins=await this.buildFinalAPI(this.api);if(this.handlers.apiCacheManager){this.handlers.apiCacheManager.set(baseModuleId,{endpoint:".",moduleID:baseModuleId,api:this.api,folderPath:this.config.dir,mode:this.config.mode,sanitizeOptions:this.config.sanitize||{},collisionMode:this.config.collision?.api||"merge",config:{...this.config},timestamp:Date.now()})}this.injectRuntimeMetadataFunctions(apiWithBuiltins);if(this.config.metadata&&typeof this.config.metadata==="object"){for(const[key,value]of Object.entries(this.config.metadata)){this.handlers.metadata.setGlobalMetadata(key,value)}this.handlers.metadata.registerUserMetadata(baseModuleId,this.config.metadata)}if(this.handlers.ownership){this.handlers.ownership.registerSubtree(apiWithBuiltins,baseModuleId,"")}if(!this.boundApi){const isCallable=typeof this.api==="function"||this.api&&typeof this.api.default==="function";const proxyTarget=isCallable?function(){}:{};this.boundApi=new Proxy(proxyTarget,{get:(target,prop)=>this.api?this.api[prop]:void 0,set:(target,prop,value)=>{if(this.api){this.api[prop]=value}return true},has:(target,prop)=>this.api?prop in this.api:false,ownKeys:____target=>this.api?Reflect.ownKeys(this.api):[],deleteProperty:(target,prop)=>this.api?delete this.api[prop]:true,apply:(target,thisArg,args)=>this.api?Reflect.apply(this.api,thisArg,args):void 0,construct:(target,args)=>this.api?Reflect.construct(this.api,args):{},getOwnPropertyDescriptor:(target,prop)=>{if(isCallable&&prop==="prototype"){return Object.getOwnPropertyDescriptor(target,prop)}if(this.api&&prop in this.api){const desc=Object.getOwnPropertyDescriptor(this.api,prop);if(desc){return{...desc,configurable:true}}}return void 0}})}store.self=this.boundApi;store.context=this.context||{};if(this.reference&&typeof this.reference==="object"){Object.assign(this.boundApi,this.reference)}this.isLoaded=true;return this.boundApi}async reload(options={}){const{keepInstanceID=false}=options;if(!this.config?.dir){throw new SlothletError("INVALID_CONFIG_NOT_LOADED",{operation:"reload",validationError:true})}const operationHistory=this.handlers.apiManager?.state?.operationHistory?[...this.handlers.apiManager.state.operationHistory]:[];await this._clearModuleCaches();const oldInstanceID=this.instanceID;if(!keepInstanceID){this.instanceID=`${oldInstanceID}_reload_${Date.now()}`}const savedMetadataState=this.handlers.metadata?.exportUserState?.();const savedHooks=this.handlers.hookManager?.exportHooks?.();await this.load(this.config,this.instanceID);if(savedMetadataState&&this.handlers.metadata){this.handlers.metadata.importUserState(savedMetadataState)}if(savedHooks?.length&&this.handlers.hookManager){this.handlers.hookManager.importHooks(savedHooks)}for(const[,store]of this.contextManager.instances){if(store.parentInstanceID===oldInstanceID){store.parentInstanceID=this.instanceID}}if(oldInstanceID&&oldInstanceID!==this.instanceID&&this.contextManager.instances?.has(oldInstanceID)){this.contextManager.cleanup(oldInstanceID)}for(const operation of operationHistory){if(operation.type==="add"){await this.handlers.apiManager.addApiComponent({apiPath:operation.apiPath,folderPath:operation.folderPath,options:{...operation.options||{},recordHistory:false},moduleID:`replay_${this.helpers.utilities.generateId().substring(0,8)}`,versionConfig:operation.versionConfig||null})}else if(operation.type==="remove"){const{parts}=this.handlers.apiManager.normalizeApiPath(operation.apiPath);this.handlers.apiManager.deletePath(this.api,parts);if(this.handlers.metadata){const rootSegment=operation.apiPath.split(".")[0];this.handlers.metadata.removeUserMetadataByApiPath(rootSegment)}}else if(operation.type==="addPermissionRule"){if(this.handlers.permissionManager){this.handlers.permissionManager.addRule(operation.rule,operation.ownerModuleID,operation.ruleId)}}else if(operation.type==="removePermissionRule"){if(this.handlers.permissionManager){this.handlers.permissionManager.removeRule(operation.ruleId,operation.callerModuleID)}}}return this.boundApi}async _clearModuleCaches(){const targetDir=this.config.dir;const{resolve}=await import("node:path");const{createRequire}=await import("node:module");const require2=createRequire(import.meta.url);const absoluteTargetDir=resolve(targetDir);for(const key of Object.keys(require2.cache)){if(key.startsWith(absoluteTargetDir)){delete require2.cache[key]}}}injectRuntimeMetadataFunctions(api){if(!api.slothlet?.metadata){return}const metadataHandler=this.handlers.metadata;api.slothlet.metadata.get=async function slothlet_metadata_get_runtime(path){return metadataHandler.get(path)};api.slothlet.metadata.self=function slothlet_metadata_self_runtime(){return metadataHandler.self()};api.slothlet.metadata.caller=function slothlet_metadata_caller_runtime(){return metadataHandler.caller()}}async _drainInFlightLoads(){if(!this.api)return;const pending=[];const seen=new Set;const collect=(obj,depth=0)=>{const objType=typeof obj;if(!obj||objType!=="object"&&objType!=="function"||depth>15||seen.has(obj))return;seen.add(obj);try{if(obj.__isVersionDispatcher===true)return;const wrapper=resolveWrapper(obj);if(wrapper){const mat=wrapper.____slothletInternal.materializationPromise;if(mat)pending.push(mat);for(const key of Object.keys(wrapper)){if(!key.startsWith("____"))collect(wrapper[key],depth+1)}return}for(const key of Object.keys(obj)){collect(obj[key],depth+1)}}catch{}};for(const key of Object.keys(this.api)){collect(this.api[key])}if(pending.length>0){await Promise.allSettled(pending)}}async shutdown(){if(!this.isLoaded){return}await this._drainInFlightLoads();disableEventEmitterPatching();cleanupEventEmitterResources();if(this.instanceID&&this.contextManager){this.contextManager.cleanup(this.instanceID)}if(this.handlers.ownership){this.handlers.ownership.clear()}this.handlers.versionManager?.shutdown();await this.handlers.permissionManager?.shutdown();this.isLoaded=false}debug(code,context={}){if(this.debugLogger){this.debugLogger.log(code,context)}}getAPI(){if(!this.isLoaded){throw new SlothletError("INVALID_CONFIG_NOT_LOADED",{operation:"getAPI"},null,{validationError:true})}return this.boundApi}getDiagnostics(){return{instanceID:this.instanceID,isLoaded:this.isLoaded,config:this.config,context:this.contextManager?.getDiagnostics()||null,ownership:this.handlers.ownership?.getDiagnostics()||null}}getOwnership(){if(!this.handlers.ownership){return null}return this.handlers.ownership.getDiagnostics()}buildFinalAPI(userApi){return this.builders.apiBuilder.buildFinalAPI(userApi)}}async function slothlet(config){const instance=new Slothlet;const api=await instance.load(config);return api}var stdin_default=slothlet;export{stdin_default as default,slothlet};