@cldmv/slothlet 2.11.0 → 3.0.1

package/dist/lib/helpers/hooks.mjs

@@ -1,389 +0,0 @@
-/*
-	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 MAX_BRACE_NESTING = 10;
-
-
-export class HookManager {
-	
-	constructor(enabled = true, defaultPattern = "**", options = {}) {
-		this.enabled = enabled;
-		this.defaultPattern = defaultPattern;
-		this.suppressErrors = options.suppressErrors || false;
-		this.hooks = new Map(); 
-		this.registrationOrder = 0; 
-		this.reportedErrors = new WeakSet(); 
-	}
-
-	
-	on(name, type, handler, options = {}) {
-		const priority = options.priority ?? 100;
-		const pattern = options.pattern || this.defaultPattern;
-		const compiledPattern = this._compilePattern(pattern);
-		const order = this.registrationOrder++;
-
-		this.hooks.set(name, {
-			tag: name,
-			type,
-			handler,
-			priority,
-			pattern,
-			compiledPattern,
-			order
-		});
-
-		return name;
-	}
-
-	
-	cleanup() {
-		this.hooks.clear();
-		this.reportedErrors = new WeakSet();
-		this.registrationOrder = 0;
-		this.enabled = false;
-	}
-
-	
-	off(nameOrPattern) {
-		
-		if (this.hooks.has(nameOrPattern)) {
-			return this.hooks.delete(nameOrPattern);
-		}
-
-		
-		const compiled = this._compilePattern(nameOrPattern);
-		let removed = false;
-		for (const key of [...this.hooks.keys()]) {
-			if (this._matchPattern(compiled, key)) {
-				this.hooks.delete(key);
-				removed = true;
-			}
-		}
-		return removed;
-	}
-
-	
-	clear(type) {
-		if (type === undefined) {
-			this.hooks.clear();
-			this.registrationOrder = 0;
-			return;
-		}
-
-		
-		for (const [name, hook] of this.hooks) {
-			if (hook.type === type) {
-				this.hooks.delete(name);
-			}
-		}
-	}
-
-	
-	list(type) {
-		const result = [];
-		for (const [name, hook] of this.hooks) {
-			if (type === undefined || hook.type === type) {
-				result.push({
-					name,
-					type: hook.type,
-					priority: hook.priority,
-					pattern: hook.pattern,
-					order: hook.order
-				});
-			}
-		}
-		return result;
-	}
-
-	
-	enable(pattern) {
-		this.enabled = true;
-		if (pattern !== undefined) {
-			this.defaultPattern = pattern;
-		}
-	}
-
-	
-	disable() {
-		this.enabled = false;
-	}
-
-	
-	executeBeforeHooks(path, args) {
-		const hooks = this._getMatchingHooks("before", path);
-		let currentArgs = args;
-
-		for (const hook of hooks) {
-			try {
-				const result = hook.handler({ path, args: currentArgs });
-
-				
-				if (result === undefined) {
-					continue;
-				}
-
-				
-				if (Array.isArray(result)) {
-					currentArgs = result;
-					continue;
-				}
-
-				
-				return { cancelled: true, value: result, args: currentArgs };
-			} catch (error) {
-				
-				this.reportedErrors.add(error);
-				this.executeErrorHooks(path, error, {
-					type: "before",
-					hookId: hook.id,
-					hookTag: hook.tag
-				});
-				throw error;
-			}
-		}
-
-		return { cancelled: false, args: currentArgs };
-	}
-
-	
-	executeAfterHooks(path, initialResult) {
-		const hooks = this._getMatchingHooks("after", path);
-		let currentResult = initialResult;
-
-		for (const hook of hooks) {
-			try {
-				const transformed = hook.handler({ path, result: currentResult });
-				
-				if (transformed !== undefined) {
-					currentResult = transformed;
-				}
-			} catch (error) {
-				
-				this.reportedErrors.add(error);
-				this.executeErrorHooks(path, error, {
-					type: "after",
-					hookId: hook.id,
-					hookTag: hook.tag
-				});
-				throw error;
-			}
-		}
-
-		return currentResult;
-	}
-
-	
-	executeAlwaysHooks(path, result, errors = []) {
-		const hooks = this._getMatchingHooks("always", path);
-
-		for (const hook of hooks) {
-			try {
-				hook.handler({
-					path,
-					result,
-					hasError: errors.length > 0,
-					errors
-				});
-			} catch (error) {
-				
-				this.executeErrorHooks(path, error, {
-					type: "always",
-					hookId: hook.id,
-					hookTag: hook.tag
-				});
-				
-			}
-		}
-	}
-
-	
-	executeErrorHooks(path, error, source = { type: "unknown" }) {
-		const hooks = this._getMatchingHooks("error", path);
-
-		
-		const errorContext = {
-			path,
-			error,
-			errorType: error.constructor ? error.constructor.name : "Error",
-			source: {
-				type: source.type || "unknown",
-				hookId: source.hookId,
-				hookTag: source.hookTag,
-				timestamp: Date.now(),
-				stack: error.stack
-			}
-		};
-
-		for (const hook of hooks) {
-			try {
-				hook.handler(errorContext);
-			} catch (hookError) {
-				
-				console.error(`Error in error hook for ${path}:`, hookError);
-			}
-		}
-	}
-
-	
-	_getMatchingHooks(type, path) {
-		const matching = [];
-
-		for (const [hookId, hook] of this.hooks.entries()) {
-			if (hook.type !== type) continue;
-			if (!this._matchPattern(hook.compiledPattern, path)) continue;
-			matching.push({ ...hook, id: hookId });
-		}
-
-		
-		matching.sort((a, b) => {
-			if (a.priority !== b.priority) {
-				return b.priority - a.priority; 
-			}
-			return a.order - b.order; 
-		});
-
-		return matching;
-	}
-
-	
-	_compilePattern(pattern) {
-		
-		if (pattern.startsWith("!")) {
-			return {
-				negation: true,
-				regex: this._compilePattern(pattern.slice(1))
-			};
-		}
-
-		
-		const expanded = this._expandBraces(pattern);
-		if (expanded.length > 1) {
-			
-			const regexes = expanded.map((p) => this._patternToRegex(p));
-			return new RegExp(`^(?:${regexes.join("|")})$`);
-		}
-
-		
-		return new RegExp(`^${this._patternToRegex(expanded[0])}$`);
-	}
-
-	
-	_expandBraces(pattern, depth = 0) {
-		if (depth > MAX_BRACE_NESTING) {
-			throw new Error(`Brace expansion exceeds maximum nesting depth of ${MAX_BRACE_NESTING}`);
-		}
-
-		const braceStart = pattern.indexOf("{");
-		if (braceStart === -1) {
-			return [pattern];
-		}
-
-		
-		let braceEnd = -1;
-		let nestLevel = 0;
-		for (let i = braceStart; i < pattern.length; i++) {
-			if (pattern[i] === "{") nestLevel++;
-			if (pattern[i] === "}") {
-				nestLevel--;
-				if (nestLevel === 0) {
-					braceEnd = i;
-					break;
-				}
-			}
-		}
-
-		if (braceEnd === -1) {
-			
-			return [pattern];
-		}
-
-		const before = pattern.slice(0, braceStart);
-		const inside = pattern.slice(braceStart + 1, braceEnd);
-		const after = pattern.slice(braceEnd + 1);
-
-		
-		const alternatives = this._splitAlternatives(inside);
-
-		
-		const results = [];
-		for (const alt of alternatives) {
-			const expanded = this._expandBraces(before + alt + after, depth + 1);
-			results.push(...expanded);
-		}
-
-		return results;
-	}
-
-	
-	_splitAlternatives(str) {
-		const alternatives = [];
-		let current = "";
-		let nestLevel = 0;
-
-		for (let i = 0; i < str.length; i++) {
-			const char = str[i];
-			if (char === "{") nestLevel++;
-			if (char === "}") nestLevel--;
-
-			if (char === "," && nestLevel === 0) {
-				alternatives.push(current);
-				current = "";
-			} else {
-				current += char;
-			}
-		}
-
-		if (current) {
-			alternatives.push(current);
-		}
-
-		return alternatives;
-	}
-
-	
-	_patternToRegex(pattern) {
-		
-		let regex = pattern.replace(/[+?^${}()|[\]\\]/g, "\\$&");
-
-		
-		regex = regex.replace(/\./g, "\\.");
-
-		
-		regex = regex.replace(/\*\*/g, "___DOUBLESTAR___");
-
-		
-		regex = regex.replace(/\*/g, "([^\\.]+)");
-
-		
-		regex = regex.replace(/___DOUBLESTAR___/g, ".*?");
-
-		return regex;
-	}
-
-	
-	_matchPattern(compiledPattern, path) {
-		if (compiledPattern.negation) {
-			
-			return !this._matchPattern(compiledPattern.regex, path);
-		}
-
-		return compiledPattern.test(path);
-	}
-}

package/dist/lib/helpers/instance-manager.mjs

@@ -1,111 +0,0 @@
-/*
-	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 instanceRegistry = new Map();
-
-
-let currentActiveInstanceId = null;
-
-
-export function getInstanceData(instanceId) {
-	return instanceRegistry.get(instanceId) || null;
-}
-
-
-export function updateInstanceData(instanceId, key, value) {
-	
-	
-	
-	
-	
-
-	let instanceData = instanceRegistry.get(instanceId);
-	if (!instanceData) {
-		instanceData = {
-			self: null,
-			context: {},
-			reference: {}
-		};
-		instanceRegistry.set(instanceId, instanceData);
-	}
-	instanceData[key] = value;
-
-	
-}
-
-
-export async function cleanupInstance(instanceId) {
-	
-	instanceRegistry.delete(instanceId);
-
-	if (currentActiveInstanceId === instanceId) {
-		currentActiveInstanceId = null;
-	}
-}
-
-
-export function setActiveInstance(instanceId) {
-	currentActiveInstanceId = instanceId;
-	
-}
-
-
-export function getCurrentActiveInstanceId() {
-	return currentActiveInstanceId;
-}
-
-
-export function detectCurrentInstanceId() {
-	
-	
-	
-	
-	
-	
-
-	
-	if (currentActiveInstanceId && instanceRegistry.has(currentActiveInstanceId)) {
-		return currentActiveInstanceId;
-	}
-
-	
-	const stack = new Error().stack;
-	if (stack) {
-		
-		const matches = stack.match(/slothlet_instance=([^&\s):]+)/g);
-
-		if (matches && matches.length > 0) {
-			
-			const instanceParam = matches[0];
-			const instanceId = instanceParam.replace(/slothlet_instance=([^&\s):]+).*/, "$1");
-
-			if (instanceRegistry.has(instanceId)) {
-				return instanceId;
-			}
-		}
-	}
-
-	
-	return null;
-}
-
-
-export function getAllInstanceIds() {
-	return Array.from(instanceRegistry.keys());
-}

package/dist/lib/helpers/metadata-api.mjs

@@ -1,201 +0,0 @@
-/*
-	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 { getStack, toFsPath } from "@cldmv/slothlet/helpers/resolve-from-caller";
-
-
-let runtimeModule = null;
-let runtimeImportPromise = null;
-
-
-async function ensureRuntime() {
-	if (runtimeModule) {
-		return runtimeModule;
-	}
-
-	if (!runtimeImportPromise) {
-		runtimeImportPromise = import("@cldmv/slothlet/runtime")
-			.then((module) => {
-				runtimeModule = module;
-				return module;
-			})
-			.catch((err) => {
-				console.error("[slothlet] Failed to import runtime for metadata API:", err.message);
-				runtimeModule = {}; 
-				return {};
-			});
-	}
-
-	return runtimeImportPromise;
-}
-
-
-function getApiRoot() {
-	
-	return runtimeModule?.self || null;
-}
-
-
-function findFunctionByStack(apiRoot, targetFile, targetLine, visited = new WeakSet()) {
-	if (!apiRoot || visited.has(apiRoot)) return null;
-	visited.add(apiRoot);
-
-	
-	if (typeof apiRoot === "function" && apiRoot.__sourceFile && apiRoot.__sourceLine) {
-		if (apiRoot.__sourceFile === targetFile && apiRoot.__sourceLine === targetLine) {
-			return apiRoot;
-		}
-	}
-
-	
-	if (typeof apiRoot === "object" || typeof apiRoot === "function") {
-		const keys = Object.keys(apiRoot);
-		for (const key of keys) {
-			
-			if (key.startsWith("_") || ["hooks", "shutdown", "addApi", "describe", "run"].includes(key)) {
-				continue;
-			}
-
-			const result = findFunctionByStack(apiRoot[key], targetFile, targetLine, visited);
-			if (result) return result;
-		}
-	}
-
-	return null;
-}
-
-
-function findFunctionByPath(apiRoot, path) {
-	if (!path || typeof path !== "string") return null;
-
-	const parts = path.split(".");
-	let current = apiRoot;
-
-	for (const part of parts) {
-		if (!current || (typeof current !== "object" && typeof current !== "function")) {
-			if (process.env.SLOTHLET_DEBUG) {
-				console.log("[findFunctionByPath] Failed: current is", typeof current);
-			}
-			return null;
-		}
-		current = current[part];
-	}
-
-	const result = typeof current === "function" ? current : null;
-	if (process.env.SLOTHLET_DEBUG) {
-		console.log("[findFunctionByPath] Result:", result ? "function found" : "null");
-	}
-	return result;
-}
-
-
-function parseCallSite(cs) {
-	if (!cs) return null;
-
-	const fileName = cs.getFileName?.();
-	if (!fileName) return null;
-
-	
-	const filePath = toFsPath(fileName);
-	if (!filePath) return null;
-
-	
-	if (filePath.startsWith?.("node:internal")) return null;
-
-	const lineNum = cs.getLineNumber?.();
-	if (typeof lineNum !== "number") return null;
-
-	return { file: filePath, line: lineNum };
-}
-
-
-export const metadataAPI = {
-	
-	async caller() {
-		
-		await ensureRuntime();
-
-		
-		const apiRoot = getApiRoot();
-		if (!apiRoot || typeof apiRoot !== "object") return null;
-
-		
-		const stack = getStack(metadataAPI.caller);
-
-		
-		
-		
-		if (stack.length < 1) return null;
-
-		const parsed = parseCallSite(stack[0]);
-		if (!parsed) return null;
-
-		
-		const func = findFunctionByStack(apiRoot, parsed.file, parsed.line);
-		if (!func) return null;
-
-		
-		return func.__metadata || null;
-	},
-
-	
-	async self() {
-		
-		await ensureRuntime();
-
-		
-		const apiRoot = getApiRoot();
-		if (!apiRoot || typeof apiRoot !== "object") return null;
-
-		
-		const stack = getStack(metadataAPI.self);
-
-		
-		if (stack.length < 1) return null;
-
-		const parsed = parseCallSite(stack[0]);
-		if (!parsed) return null;
-
-		
-		const func = findFunctionByStack(apiRoot, parsed.file, parsed.line);
-		if (!func) return null;
-
-		
-		return func.__metadata || null;
-	},
-
-	
-	async get(path, apiRoot) {
-		
-		await ensureRuntime();
-
-		
-		const root = apiRoot || getApiRoot();
-		if (!root || (typeof root !== "object" && typeof root !== "function")) {
-			return null;
-		}
-
-		const func = findFunctionByPath(root, path);
-		if (!func) return null;
-
-		
-		return func.__metadata || null;
-	}
-};