@cldmv/slothlet 3.3.0 → 3.4.0

package/dist/lib/handlers/lifecycle.mjs

@@ -14,118 +14,4 @@
 	limitations under the License.
 */
 
-
-
-
-
-import { ComponentBase } from "@cldmv/slothlet/factories/component-base";
-import { getInstanceToken } from "@cldmv/slothlet/handlers/lifecycle-token";
-
-
-export class Lifecycle extends ComponentBase {
-	
-	static slothletProperty = "lifecycle";
-
-	
-	constructor(slothlet) {
-		super(slothlet);
-		this.subscribers = new Map();
-		this.eventLog = [];
-		this.maxLogSize = 1000;
-	}
-
-	
-	subscribe(event, handler) {
-		if (!this.subscribers.has(event)) {
-			this.subscribers.set(event, new Set());
-		}
-		this.subscribers.get(event).add(handler);
-
-		
-		return () => {
-			const handlers = this.subscribers.get(event);
-			if (handlers) {
-				handlers.delete(handler);
-			}
-		};
-	}
-
-	
-	on(event, handler) {
-		return this.subscribe(event, handler);
-	}
-
-	
-	off(event, handler) {
-		const handlers = this.subscribers.get(event);
-		if (handlers) {
-			handlers.delete(handler);
-		}
-	}
-
-	
-	unsubscribe(event, handler) {
-		this.off(event, handler);
-	}
-
-	
-	async emit(event, data) {
-		
-		if (this.____config?.debug?.lifecycle) {
-			this.eventLog.push({
-				event,
-				data: { ...data },
-				timestamp: Date.now()
-			});
-
-			
-			if (this.eventLog.length > this.maxLogSize) {
-				this.eventLog.shift();
-			}
-
-			this.slothlet.debug("lifecycle", {
-				key: "DEBUG_MODE_LIFECYCLE_EVENT",
-				event,
-				apiPath: data.apiPath,
-				source: data.source,
-				moduleID: data.moduleID
-			});
-		}
-
-		
-		const handlers = this.subscribers.get(event);
-		if (handlers) {
-			
-			const handlerPromises = [];
-
-				const token = getInstanceToken(this.slothlet);
-				for (const handler of handlers) {
-					try {
-						const result = handler(data, token);
-					
-					if (result && typeof result.then === "function") {
-						handlerPromises.push(
-							result.catch((error) => {
-								
-								if (!this.____config?.silent) {
-									new this.SlothletWarning("WARNING_LIFECYCLE_HANDLER_ERROR", { event }, error);
-								}
-							})
-						);
-					}
-				} catch (error) {
-					
-					if (!this.____config?.silent) {
-						new this.SlothletWarning("WARNING_LIFECYCLE_HANDLER_ERROR", { event }, error);
-					}
-				}
-			}
-
-			
-			if (handlerPromises.length > 0) {
-				await Promise.all(handlerPromises);
-			}
-		}
-	}
-
-}
+import{ComponentBase}from"@cldmv/slothlet/factories/component-base";import{getInstanceToken}from"@cldmv/slothlet/handlers/lifecycle-token";class Lifecycle extends ComponentBase{static slothletProperty="lifecycle";constructor(slothlet){super(slothlet);this.subscribers=new Map;this.eventLog=[];this.maxLogSize=1e3}subscribe(event,handler){if(!this.subscribers.has(event)){this.subscribers.set(event,new Set)}this.subscribers.get(event).add(handler);return()=>{const handlers=this.subscribers.get(event);if(handlers){handlers.delete(handler)}}}on(event,handler){return this.subscribe(event,handler)}off(event,handler){const handlers=this.subscribers.get(event);if(handlers){handlers.delete(handler)}}unsubscribe(event,handler){this.off(event,handler)}async emit(event,data){if(this.____config?.debug?.lifecycle){this.eventLog.push({event,data:{...data},timestamp:Date.now()});if(this.eventLog.length>this.maxLogSize){this.eventLog.shift()}this.slothlet.debug("lifecycle",{key:"DEBUG_MODE_LIFECYCLE_EVENT",event,apiPath:data.apiPath,source:data.source,moduleID:data.moduleID})}const handlers=this.subscribers.get(event);if(handlers){const handlerPromises=[];const token=getInstanceToken(this.slothlet);for(const handler of handlers){try{const result=handler(data,token);if(result&&typeof result.then==="function"){handlerPromises.push(result.catch(error=>{if(!this.____config?.silent){new this.SlothletWarning("WARNING_LIFECYCLE_HANDLER_ERROR",{event},error)}}))}}catch(error){if(!this.____config?.silent){new this.SlothletWarning("WARNING_LIFECYCLE_HANDLER_ERROR",{event},error)}}}if(handlerPromises.length>0){await Promise.all(handlerPromises)}}}}export{Lifecycle};

package/dist/lib/handlers/materialize-manager.mjs

@@ -14,51 +14,4 @@
 	limitations under the License.
 */
 
-
-
-
-
-import { ComponentBase } from "@cldmv/slothlet/factories/component-base";
-
-
-export class MaterializeManager extends ComponentBase {
-	static slothletProperty = "materialize";
-
-	
-	constructor(slothlet) {
-		super(slothlet);
-	}
-
-	
-	get materialized() {
-		return this.slothlet._unmaterializedLazyCount === 0;
-	}
-
-	
-	get() {
-		const total = this.slothlet._totalLazyCount;
-		const remaining = this.slothlet._unmaterializedLazyCount;
-		const materialized = total - remaining;
-		const percentage = total > 0 ? Math.round((materialized / total) * 100) : 100;
-
-		return {
-			total,
-			materialized,
-			remaining,
-			percentage
-		};
-	}
-
-	
-	async wait() {
-		
-		if (this.slothlet._unmaterializedLazyCount === 0) {
-			return;
-		}
-
-		
-		return new Promise((resolve) => {
-			this.slothlet._materializationWaiters.push(resolve);
-		});
-	}
-}
+import{ComponentBase}from"@cldmv/slothlet/factories/component-base";class MaterializeManager extends ComponentBase{static slothletProperty="materialize";constructor(slothlet){super(slothlet)}get materialized(){return this.slothlet._unmaterializedLazyCount===0}get(){const total=this.slothlet._totalLazyCount;const remaining=this.slothlet._unmaterializedLazyCount;const materialized=total-remaining;const percentage=total>0?Math.round(materialized/total*100):100;return{total,materialized,remaining,percentage}}async wait(){if(this.slothlet._unmaterializedLazyCount===0){return}return new Promise(resolve=>{this.slothlet._materializationWaiters.push(resolve)})}}export{MaterializeManager};

package/dist/lib/handlers/metadata.mjs

@@ -14,504 +14,4 @@
 	limitations under the License.
 */
 
-
-
-
-
-import { ComponentBase } from "@cldmv/slothlet/factories/component-base";
-import { resolveWrapper } from "@cldmv/slothlet/handlers/unified-wrapper";
-import { verifyToken } from "@cldmv/slothlet/handlers/lifecycle-token";
-
-
-export class Metadata extends ComponentBase {
-	static slothletProperty = "metadata";
-
-	
-	#secureMetadata = new WeakMap(); 
-
-	
-	#userMetadataStore = new Map(); 
-	#globalUserMetadata = {}; 
-
-	_instanceId = null;
-
-	
-	constructor(slothlet) {
-		super(slothlet);
-		this._instanceId = `metadata_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
-	}
-
-	
-	#deepFreeze(obj) {
-		
-		if (Object.isFrozen(obj)) return obj;
-
-		
-		Object.freeze(obj);
-
-		
-		Object.getOwnPropertyNames(obj).forEach((prop) => {
-			if (obj[prop] !== null && typeof obj[prop] === "object") {
-				this.#deepFreeze(obj[prop]);
-			}
-		});
-
-		return obj;
-	}
-
-	
-	tagSystemMetadata(target, systemData, token) {
-		
-		
-		
-		
-		if (!verifyToken(this.slothlet, token)) {
-			throw new this.SlothletError("METADATA_LIFECYCLE_BYPASS", {}, null, { validationError: true });
-		}
-
-		if (!target) return;
-
-		
-		if (typeof target !== "object" && typeof target !== "function") {
-			return;
-		}
-
-		
-		let fullModuleID = systemData.moduleID;
-		if (systemData.apiPath && systemData.moduleID) {
-			const apiPathSlashes = systemData.apiPath.replace(/\./g, "/");
-			fullModuleID = `${systemData.moduleID}:${apiPathSlashes}`;
-		}
-
-		
-		let sourceFolder = systemData.sourceFolder;
-		if (!sourceFolder && systemData.filePath) {
-			
-			const pathModule = this.slothlet.helpers.resolver.path;
-			sourceFolder = pathModule.dirname(systemData.filePath);
-		}
-
-		
-		const frozenSystem = Object.freeze({
-			filePath: systemData.filePath,
-			sourceFolder: sourceFolder,
-			apiPath: systemData.apiPath,
-			moduleID: fullModuleID,
-			taggedAt: Date.now()
-		});
-
-		this.#secureMetadata.set(target, frozenSystem);
-	}
-
-	
-	getSystemMetadata(target) {
-		if (!target) return null;
-
-		
-		const actualTarget = resolveWrapper(target) ?? target;
-
-		
-		const systemData = this.#secureMetadata.get(actualTarget.____slothletInternal?.impl || actualTarget);
-		return systemData || null;
-	}
-
-	
-	getMetadata(target) {
-		if (!target) return {};
-
-		
-		const actualTarget = resolveWrapper(target) ?? target;
-
-		
-		
-		const systemData = this.#secureMetadata.get(actualTarget) || this.#secureMetadata.get(actualTarget.____slothletInternal?.impl) || {};
-
-		
-		
-		
-		const moduleID = systemData.moduleID || systemData.moduleID;
-		const apiPath = systemData.apiPath;
-
-		
-		
-		
-		
-		
-		
-		const collectMetadataFromParents = (path) => {
-			const parts = path.split(".");
-			const collected = {};
-
-			
-			for (let i = 1; i <= parts.length; i++) {
-				const parentPath = parts.slice(0, i).join(".");
-				const parentMeta = this.#userMetadataStore.get(parentPath);
-				if (parentMeta?.metadata) {
-					Object.assign(collected, parentMeta.metadata);
-				}
-			}
-
-			return collected;
-		};
-
-		const userMetadataByModule = moduleID ? this.#userMetadataStore.get(moduleID) : null;
-		const userMetadataByPath = apiPath ? collectMetadataFromParents(apiPath) : {};
-
-		
-		const userData = {
-			...userMetadataByPath,
-			...(userMetadataByModule?.metadata || {})
-		};
-
-		
-		const combined = {
-			...this.#globalUserMetadata,
-			...userData,
-			...systemData 
-		};
-
-		
-		if (combined.metadata && typeof combined.metadata === "object") {
-			const { metadata, ...rest } = combined;
-			return this.#deepFreeze({
-				...rest,
-				...metadata
-			});
-		}
-
-		return this.#deepFreeze(combined);
-	}
-
-	
-	setGlobalMetadata(key, value) {
-		this.#globalUserMetadata[key] = value;
-	}
-
-	
-	setUserMetadata(target, key, value) {
-		if (typeof target !== "function" && typeof target !== "object") {
-			throw new this.SlothletError("INVALID_METADATA_TARGET", {
-				target: typeof target,
-				expected: "function or object"
-			});
-		}
-
-		
-		const actualTarget = resolveWrapper(target) ?? target;
-
-		
-		
-		
-		const systemData = this.#secureMetadata.get(actualTarget) || this.#secureMetadata.get(actualTarget.____slothletInternal?.impl) || {};
-		const moduleID = systemData.moduleID;
-
-		if (!moduleID) {
-			throw new this.SlothletError("METADATA_NO_MODULE_ID", {}, null, { validationError: true });
-		}
-
-		
-		let entry = this.#userMetadataStore.get(moduleID);
-		if (!entry) {
-			entry = { metadata: {}, apiPaths: new Set() };
-			this.#userMetadataStore.set(moduleID, entry);
-		}
-
-		
-		entry.metadata[key] = value;
-
-		
-		
-		
-		const apiPath = systemData.apiPath;
-		if (apiPath) {
-			let pathEntry = this.#userMetadataStore.get(apiPath);
-			if (!pathEntry) {
-				pathEntry = { metadata: {}, apiPaths: new Set() };
-				this.#userMetadataStore.set(apiPath, pathEntry);
-			}
-			pathEntry.metadata[key] = value;
-			pathEntry.apiPaths.add(apiPath);
-		}
-	}
-
-	
-	removeUserMetadata(target, key) {
-		if (typeof target !== "function" && typeof target !== "object") {
-			throw new this.SlothletError("INVALID_METADATA_TARGET", {
-				target: typeof target,
-				expected: "function or object"
-			});
-		}
-
-		
-		const actualTarget = resolveWrapper(target) ?? target;
-
-		
-		const systemData = this.#secureMetadata.get(actualTarget) || this.#secureMetadata.get(actualTarget.____slothletInternal?.impl) || {};
-		const moduleID = systemData.moduleID;
-		const apiPath = systemData.apiPath;
-
-		if (!moduleID) return;
-
-		
-		const applyRemoval = (storeKey) => {
-			const storeEntry = this.#userMetadataStore.get(storeKey);
-			if (!storeEntry) return;
-
-			if (key === undefined) {
-				this.#userMetadataStore.delete(storeKey);
-			} else if (Array.isArray(key)) {
-				for (const k of key) {
-					if (typeof k !== "string") {
-						throw new this.SlothletError("INVALID_METADATA_KEY", {
-							key: k,
-							type: typeof k,
-							expected: "string"
-						});
-					}
-					delete storeEntry.metadata[k];
-				}
-			} else if (typeof key === "object" && key !== null) {
-				for (const [metadataKey, nestedKeys] of Object.entries(key)) {
-					if (!Array.isArray(nestedKeys)) {
-						throw new this.SlothletError("INVALID_METADATA_KEY", {
-							key: metadataKey,
-							type: typeof nestedKeys,
-							expected: "array"
-						});
-					}
-					const metadataValue = storeEntry.metadata[metadataKey];
-					if (metadataValue && typeof metadataValue === "object") {
-						for (const nestedKey of nestedKeys) {
-							if (typeof nestedKey !== "string") {
-								throw new this.SlothletError("INVALID_METADATA_KEY", {
-									key: nestedKey,
-									type: typeof nestedKey,
-									expected: "string"
-								});
-							}
-							delete metadataValue[nestedKey];
-						}
-					}
-				}
-			} else if (typeof key === "string") {
-				delete storeEntry.metadata[key];
-			} else {
-				throw new this.SlothletError("INVALID_METADATA_KEY", {
-					key: key,
-					type: typeof key,
-					expected: "string, string[], or object"
-				});
-			}
-		};
-
-		
-		
-		applyRemoval(moduleID);
-		if (apiPath && apiPath !== moduleID) {
-			applyRemoval(apiPath);
-		}
-	}
-
-	
-	registerUserMetadata(identifier, metadata) {
-		if (!identifier || typeof identifier !== "string") {
-			throw new this.SlothletError(
-				"INVALID_ARGUMENT",
-				{
-					argument: "identifier",
-					expected: "non-empty string",
-					received: typeof identifier
-				},
-				null,
-				{ validationError: true }
-			);
-		}
-
-		let entry = this.#userMetadataStore.get(identifier);
-		if (!entry) {
-			entry = { metadata: {}, apiPaths: new Set() };
-			this.#userMetadataStore.set(identifier, entry);
-		}
-		
-		entry.metadata = { ...entry.metadata, ...metadata };
-		
-		entry.apiPaths.add(identifier);
-	}
-
-	
-	removeUserMetadataByApiPath(apiPath) {
-		if (!apiPath) return;
-		this.#userMetadataStore.delete(apiPath);
-	}
-
-	
-	setPathMetadata(apiPath, keyOrObj, value) {
-		if (typeof apiPath !== "string" || !apiPath) {
-			throw new this.SlothletError(
-				"INVALID_ARGUMENT",
-				{ argument: "apiPath", expected: "non-empty string", received: typeof apiPath },
-				null,
-				{ validationError: true }
-			);
-		}
-
-		const metadataObj = typeof keyOrObj === "string" ? { [keyOrObj]: value } : keyOrObj;
-
-		if (!metadataObj || typeof metadataObj !== "object" || Array.isArray(metadataObj)) {
-			throw new this.SlothletError(
-				"INVALID_ARGUMENT",
-				{ argument: "keyOrObj", expected: "string key or plain object", received: typeof keyOrObj },
-				null,
-				{ validationError: true }
-			);
-		}
-
-		this.registerUserMetadata(apiPath, metadataObj);
-	}
-
-	
-	getPathMetadata(apiPath) {
-		
-		
-		if (!apiPath || typeof apiPath !== "string") return {};
-		const parts = apiPath.split(".");
-		const collected = {};
-		for (let i = 1; i <= parts.length; i++) {
-			const parentPath = parts.slice(0, i).join(".");
-			const parentMeta = this.#userMetadataStore.get(parentPath);
-			if (parentMeta?.metadata) {
-				Object.assign(collected, parentMeta.metadata);
-			}
-		}
-		return { ...this.#globalUserMetadata, ...collected };
-	}
-
-	
-	removePathMetadata(apiPath, key) {
-		if (!apiPath || typeof apiPath !== "string") return;
-
-		const entry = this.#userMetadataStore.get(apiPath);
-		if (!entry) return;
-
-		if (key === undefined) {
-			this.#userMetadataStore.delete(apiPath);
-		} else if (Array.isArray(key)) {
-			for (const k of key) {
-				if (typeof k !== "string") {
-					throw new this.SlothletError("INVALID_METADATA_KEY", {
-						key: k,
-						type: typeof k,
-						expected: "string"
-					});
-				}
-				delete entry.metadata[k];
-			}
-		} else if (typeof key === "string") {
-			delete entry.metadata[key];
-		} else {
-			throw new this.SlothletError("INVALID_METADATA_KEY", {
-				key,
-				type: typeof key,
-				expected: "string or string[]"
-			});
-		}
-	}
-
-	
-	exportUserState() {
-		const storeCopy = new Map();
-		for (const [key, entry] of this.#userMetadataStore) {
-			storeCopy.set(key, {
-				metadata: { ...entry.metadata },
-				apiPaths: new Set(entry.apiPaths)
-			});
-		}
-		return {
-			globalMetadata: { ...this.#globalUserMetadata },
-			userMetadataStore: storeCopy
-		};
-	}
-
-	
-	importUserState(state) {
-		if (!state) return;
-
-		
-		if (state.globalMetadata) {
-			for (const [k, v] of Object.entries(state.globalMetadata)) {
-				if (!(k in this.#globalUserMetadata)) {
-					this.#globalUserMetadata[k] = v;
-				}
-			}
-		}
-
-		
-		if (state.userMetadataStore) {
-			for (const [key, savedEntry] of state.userMetadataStore) {
-				const existing = this.#userMetadataStore.get(key);
-				if (!existing) {
-					
-					this.#userMetadataStore.set(key, {
-						metadata: { ...savedEntry.metadata },
-						apiPaths: new Set(savedEntry.apiPaths)
-					});
-				} else {
-					
-					existing.metadata = { ...savedEntry.metadata, ...existing.metadata };
-					for (const p of savedEntry.apiPaths) existing.apiPaths.add(p);
-				}
-			}
-		}
-	}
-
-	
-	async get(path) {
-		if (typeof path !== "string") {
-			throw new this.SlothletError("INVALID_ARGUMENT", {
-				argument: "path",
-				expected: "string",
-				received: typeof path
-			});
-		}
-
-		const apiRoot = this.slothlet.api;
-		if (!apiRoot) return null;
-
-		const parts = path.split(".");
-		let target = apiRoot;
-
-		for (const part of parts) {
-			if (!target || (typeof target !== "object" && typeof target !== "function")) {
-				return null;
-			}
-			target = target[part];
-		}
-
-		if (target && typeof target._materialize === "function") {
-			await target._materialize();
-		}
-
-		if (typeof target === "function" || (target && resolveWrapper(target)?.____slothletInternal?.impl)) {
-			return this.getMetadata(target);
-		}
-
-		return null;
-	}
-
-	
-	self() {
-		const ctx = this.slothlet.contextManager?.tryGetContext();
-		if (!ctx || !ctx.currentWrapper) {
-			throw new this.SlothletError("RUNTIME_NO_ACTIVE_CONTEXT", {}, null, { validationError: true });
-		}
-		return this.getMetadata(ctx.currentWrapper);
-	}
-
-	
-	caller() {
-		const ctx = this.slothlet.contextManager?.tryGetContext();
-		if (!ctx || !ctx.callerWrapper) return null;
-		return this.getMetadata(ctx.callerWrapper);
-	}
-}
+import{ComponentBase}from"@cldmv/slothlet/factories/component-base";import{resolveWrapper}from"@cldmv/slothlet/handlers/unified-wrapper";import{verifyToken}from"@cldmv/slothlet/handlers/lifecycle-token";class Metadata extends ComponentBase{static slothletProperty="metadata";#secureMetadata=new WeakMap;#userMetadataStore=new Map;#globalUserMetadata={};_instanceId=null;constructor(slothlet){super(slothlet);this._instanceId=`metadata_${Date.now()}_${Math.random().toString(36).substr(2,9)}`}#deepFreeze(obj){if(Object.isFrozen(obj))return obj;Object.freeze(obj);Object.getOwnPropertyNames(obj).forEach(prop=>{if(obj[prop]!==null&&typeof obj[prop]==="object"){this.#deepFreeze(obj[prop])}});return obj}tagSystemMetadata(target,systemData,token){if(!verifyToken(this.slothlet,token)){throw new this.SlothletError("METADATA_LIFECYCLE_BYPASS",{},null,{validationError:true})}if(!target)return;if(typeof target!=="object"&&typeof target!=="function"){return}let fullModuleID=systemData.moduleID;if(systemData.apiPath&&systemData.moduleID){const apiPathSlashes=systemData.apiPath.replace(/\./g,"/");fullModuleID=`${systemData.moduleID}:${apiPathSlashes}`}let sourceFolder=systemData.sourceFolder;if(!sourceFolder&&systemData.filePath){const pathModule=this.slothlet.helpers.resolver.path;sourceFolder=pathModule.dirname(systemData.filePath)}const frozenSystem=Object.freeze({filePath:systemData.filePath,sourceFolder,apiPath:systemData.apiPath,moduleID:fullModuleID,taggedAt:Date.now()});this.#secureMetadata.set(target,frozenSystem)}getSystemMetadata(target){if(!target)return null;const actualTarget=resolveWrapper(target)??target;const systemData=this.#secureMetadata.get(actualTarget.____slothletInternal?.impl||actualTarget);return systemData||null}getMetadata(target){if(!target)return{};const actualTarget=resolveWrapper(target)??target;const systemData=this.#secureMetadata.get(actualTarget)||this.#secureMetadata.get(actualTarget.____slothletInternal?.impl)||{};const moduleID=systemData.moduleID||systemData.moduleID;const apiPath=systemData.apiPath;const collectMetadataFromParents=path=>{const parts=path.split(".");const collected={};for(let i=1;i<=parts.length;i++){const parentPath=parts.slice(0,i).join(".");const parentMeta=this.#userMetadataStore.get(parentPath);if(parentMeta?.metadata){Object.assign(collected,parentMeta.metadata)}}return collected};const userMetadataByModule=moduleID?this.#userMetadataStore.get(moduleID):null;const userMetadataByPath=apiPath?collectMetadataFromParents(apiPath):{};const userData={...userMetadataByPath,...userMetadataByModule?.metadata||{}};const combined={...this.#globalUserMetadata,...userData,...systemData};if(combined.metadata&&typeof combined.metadata==="object"){const{metadata,...rest}=combined;return this.#deepFreeze({...rest,...metadata})}return this.#deepFreeze(combined)}setGlobalMetadata(key,value){this.#globalUserMetadata[key]=value}setUserMetadata(target,key,value){if(typeof target!=="function"&&typeof target!=="object"){throw new this.SlothletError("INVALID_METADATA_TARGET",{target:typeof target,expected:"function or object"})}const actualTarget=resolveWrapper(target)??target;const systemData=this.#secureMetadata.get(actualTarget)||this.#secureMetadata.get(actualTarget.____slothletInternal?.impl)||{};const moduleID=systemData.moduleID;if(!moduleID){throw new this.SlothletError("METADATA_NO_MODULE_ID",{},null,{validationError:true})}let entry=this.#userMetadataStore.get(moduleID);if(!entry){entry={metadata:{},apiPaths:new Set};this.#userMetadataStore.set(moduleID,entry)}entry.metadata[key]=value;const apiPath=systemData.apiPath;if(apiPath){let pathEntry=this.#userMetadataStore.get(apiPath);if(!pathEntry){pathEntry={metadata:{},apiPaths:new Set};this.#userMetadataStore.set(apiPath,pathEntry)}pathEntry.metadata[key]=value;pathEntry.apiPaths.add(apiPath)}}removeUserMetadata(target,key){if(typeof target!=="function"&&typeof target!=="object"){throw new this.SlothletError("INVALID_METADATA_TARGET",{target:typeof target,expected:"function or object"})}const actualTarget=resolveWrapper(target)??target;const systemData=this.#secureMetadata.get(actualTarget)||this.#secureMetadata.get(actualTarget.____slothletInternal?.impl)||{};const moduleID=systemData.moduleID;const apiPath=systemData.apiPath;if(!moduleID)return;const applyRemoval=storeKey=>{const storeEntry=this.#userMetadataStore.get(storeKey);if(!storeEntry)return;if(key===void 0){this.#userMetadataStore.delete(storeKey)}else if(Array.isArray(key)){for(const k of key){if(typeof k!=="string"){throw new this.SlothletError("INVALID_METADATA_KEY",{key:k,type:typeof k,expected:"string"})}delete storeEntry.metadata[k]}}else if(typeof key==="object"&&key!==null){for(const[metadataKey,nestedKeys]of Object.entries(key)){if(!Array.isArray(nestedKeys)){throw new this.SlothletError("INVALID_METADATA_KEY",{key:metadataKey,type:typeof nestedKeys,expected:"array"})}const metadataValue=storeEntry.metadata[metadataKey];if(metadataValue&&typeof metadataValue==="object"){for(const nestedKey of nestedKeys){if(typeof nestedKey!=="string"){throw new this.SlothletError("INVALID_METADATA_KEY",{key:nestedKey,type:typeof nestedKey,expected:"string"})}delete metadataValue[nestedKey]}}}}else if(typeof key==="string"){delete storeEntry.metadata[key]}else{throw new this.SlothletError("INVALID_METADATA_KEY",{key,type:typeof key,expected:"string, string[], or object"})}};applyRemoval(moduleID);if(apiPath&&apiPath!==moduleID){applyRemoval(apiPath)}}registerUserMetadata(identifier,metadata){if(!identifier||typeof identifier!=="string"){throw new this.SlothletError("INVALID_ARGUMENT",{argument:"identifier",expected:"non-empty string",received:typeof identifier},null,{validationError:true})}let entry=this.#userMetadataStore.get(identifier);if(!entry){entry={metadata:{},apiPaths:new Set};this.#userMetadataStore.set(identifier,entry)}entry.metadata={...entry.metadata,...metadata};entry.apiPaths.add(identifier)}removeUserMetadataByApiPath(apiPath){if(!apiPath)return;this.#userMetadataStore.delete(apiPath)}setPathMetadata(apiPath,keyOrObj,value){if(typeof apiPath!=="string"||!apiPath){throw new this.SlothletError("INVALID_ARGUMENT",{argument:"apiPath",expected:"non-empty string",received:typeof apiPath},null,{validationError:true})}const metadataObj=typeof keyOrObj==="string"?{[keyOrObj]:value}:keyOrObj;if(!metadataObj||typeof metadataObj!=="object"||Array.isArray(metadataObj)){throw new this.SlothletError("INVALID_ARGUMENT",{argument:"keyOrObj",expected:"string key or plain object",received:typeof keyOrObj},null,{validationError:true})}this.registerUserMetadata(apiPath,metadataObj)}getPathMetadata(apiPath){if(!apiPath||typeof apiPath!=="string")return{};const parts=apiPath.split(".");const collected={};for(let i=1;i<=parts.length;i++){const parentPath=parts.slice(0,i).join(".");const parentMeta=this.#userMetadataStore.get(parentPath);if(parentMeta?.metadata){Object.assign(collected,parentMeta.metadata)}}return{...this.#globalUserMetadata,...collected}}removePathMetadata(apiPath,key){if(!apiPath||typeof apiPath!=="string")return;const entry=this.#userMetadataStore.get(apiPath);if(!entry)return;if(key===void 0){this.#userMetadataStore.delete(apiPath)}else if(Array.isArray(key)){for(const k of key){if(typeof k!=="string"){throw new this.SlothletError("INVALID_METADATA_KEY",{key:k,type:typeof k,expected:"string"})}delete entry.metadata[k]}}else if(typeof key==="string"){delete entry.metadata[key]}else{throw new this.SlothletError("INVALID_METADATA_KEY",{key,type:typeof key,expected:"string or string[]"})}}exportUserState(){const storeCopy=new Map;for(const[key,entry]of this.#userMetadataStore){storeCopy.set(key,{metadata:{...entry.metadata},apiPaths:new Set(entry.apiPaths)})}return{globalMetadata:{...this.#globalUserMetadata},userMetadataStore:storeCopy}}importUserState(state){if(!state)return;if(state.globalMetadata){for(const[k,v]of Object.entries(state.globalMetadata)){if(!(k in this.#globalUserMetadata)){this.#globalUserMetadata[k]=v}}}if(state.userMetadataStore){for(const[key,savedEntry]of state.userMetadataStore){const existing=this.#userMetadataStore.get(key);if(!existing){this.#userMetadataStore.set(key,{metadata:{...savedEntry.metadata},apiPaths:new Set(savedEntry.apiPaths)})}else{existing.metadata={...savedEntry.metadata,...existing.metadata};for(const p of savedEntry.apiPaths)existing.apiPaths.add(p)}}}}async get(path){if(typeof path!=="string"){throw new this.SlothletError("INVALID_ARGUMENT",{argument:"path",expected:"string",received:typeof path})}const apiRoot=this.slothlet.api;if(!apiRoot)return null;const parts=path.split(".");let target=apiRoot;for(const part of parts){if(!target||typeof target!=="object"&&typeof target!=="function"){return null}target=target[part]}if(target&&typeof target._materialize==="function"){await target._materialize()}if(typeof target==="function"||target&&resolveWrapper(target)?.____slothletInternal?.impl){return this.getMetadata(target)}return null}self(){const ctx=this.slothlet.contextManager?.tryGetContext();if(!ctx||!ctx.currentWrapper){throw new this.SlothletError("RUNTIME_NO_ACTIVE_CONTEXT",{},null,{validationError:true})}return this.getMetadata(ctx.currentWrapper)}caller(){const ctx=this.slothlet.contextManager?.tryGetContext();if(!ctx||!ctx.callerWrapper)return null;return this.getMetadata(ctx.callerWrapper)}}export{Metadata};