@cldmv/slothlet 2.11.0 → 3.0.1

package/dist/lib/handlers/lifecycle-token.mjs

@@ -0,0 +1,44 @@
+/*
+	Copyright 2026 CLDMV/Shinrai
+
+	Licensed under the Apache License, Version 2.0 (the "License");
+	you may not use this file except in compliance with the License.
+	You may obtain a copy of the License at
+
+		http://www.apache.org/licenses/LICENSE-2.0
+
+	Unless required by applicable law or agreed to in writing, software
+	distributed under the License is distributed on an "AS IS" BASIS,
+	WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+	See the License for the specific language governing permissions and
+	limitations under the License.
+*/
+
+
+
+
+
+
+const instanceTokens = new WeakMap();
+
+
+function registerInstance(slothlet) {
+	if (instanceTokens.has(slothlet)) {
+		
+		
+		return;
+	}
+	instanceTokens.set(slothlet, Symbol("@cldmv/slothlet/lifecycle.tagToken"));
+}
+
+
+function getInstanceToken(slothlet) {
+	return instanceTokens.get(slothlet);
+}
+
+
+function verifyToken(slothlet, token) {
+	return token === instanceTokens.get(slothlet);
+}
+
+export { registerInstance, getInstanceToken, verifyToken };

package/dist/lib/handlers/lifecycle.mjs

@@ -0,0 +1,131 @@
+/*
+	Copyright 2026 CLDMV/Shinrai
+
+	Licensed under the Apache License, Version 2.0 (the "License");
+	you may not use this file except in compliance with the License.
+	You may obtain a copy of the License at
+
+		http://www.apache.org/licenses/LICENSE-2.0
+
+	Unless required by applicable law or agreed to in writing, software
+	distributed under the License is distributed on an "AS IS" BASIS,
+	WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+	See the License for the specific language governing permissions and
+	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);
+			}
+		}
+	}
+
+}

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

@@ -0,0 +1,64 @@
+/*
+	Copyright 2026 CLDMV/Shinrai
+
+	Licensed under the Apache License, Version 2.0 (the "License");
+	you may not use this file except in compliance with the License.
+	You may obtain a copy of the License at
+
+		http://www.apache.org/licenses/LICENSE-2.0
+
+	Unless required by applicable law or agreed to in writing, software
+	distributed under the License is distributed on an "AS IS" BASIS,
+	WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+	See the License for the specific language governing permissions and
+	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);
+		});
+	}
+}