@context-action/core 0.8.0 → 0.8.4

package/dist/index.js

@@ -314,27 +314,91 @@ var ActionGuard = class {
 		this.guards = /* @__PURE__ */ new Map();
 		this.maxIdleTime = 6e4;
 		this.cleanupIntervalMs = 3e4;
+		this.maxGuards = 1e3;
+		this.accessOrder = [];
 		if (autoCleanup) this.startAutoCleanup();
 	}
 	/**
 	* Start automatic cleanup of idle guard states
-	* 
+	*
 	* @internal
 	*/
 	startAutoCleanup() {
 		this.cleanupInterval = setInterval(() => {
-			const now = Date.now();
-			const keysToDelete = [];
-			this.guards.forEach((state, key) => {
+			this.performCleanup();
+		}, this.cleanupIntervalMs);
+	}
+	/**
+	* 🔧 Optimized cleanup with early exit and batched operations
+	*
+	* @internal
+	*/
+	performCleanup() {
+		const guardCount = this.guards.size;
+		if (guardCount === 0) return;
+		const now = Date.now();
+		const keysToDelete = [];
+		if (guardCount <= 10) this.guards.forEach((state, key) => {
+			const isIdle = now - state.lastExecuted > this.maxIdleTime;
+			const hasActiveTimers = state.debounceTimer || state.throttleTimer;
+			if (isIdle && !hasActiveTimers) keysToDelete.push(key);
+		});
+		else {
+			const entriesToCheck = Math.min(this.accessOrder.length, Math.ceil(guardCount / 4));
+			for (let i = 0; i < entriesToCheck; i++) {
+				const key = this.accessOrder[i];
+				if (!key) continue;
+				const state = this.guards.get(key);
+				if (!state) {
+					keysToDelete.push(key);
+					continue;
+				}
 				const isIdle = now - state.lastExecuted > this.maxIdleTime;
 				const hasActiveTimers = state.debounceTimer || state.throttleTimer;
 				if (isIdle && !hasActiveTimers) keysToDelete.push(key);
-			});
-			if (keysToDelete.length > 0) {
-				keysToDelete.forEach((key) => this.guards.delete(key));
-				if (typeof process !== "undefined" && process.env?.DEBUG_CONTEXT_ACTION) console.debug(`[ActionGuard] Cleaned up ${keysToDelete.length} idle guards`);
 			}
-		}, this.cleanupIntervalMs);
+		}
+		if (keysToDelete.length > 0) {
+			keysToDelete.forEach((key) => {
+				this.guards.delete(key);
+				const accessIndex = this.accessOrder.indexOf(key);
+				if (accessIndex !== -1) this.accessOrder.splice(accessIndex, 1);
+			});
+			if (typeof process !== "undefined" && process.env?.DEBUG_CONTEXT_ACTION) console.debug(`[ActionGuard] Cleaned up ${keysToDelete.length} idle guards`);
+		}
+	}
+	/**
+	* 🔧 Update access order for LRU tracking
+	*
+	* @internal
+	*/
+	updateAccessOrder(key) {
+		const existingIndex = this.accessOrder.indexOf(key);
+		if (existingIndex !== -1) this.accessOrder.splice(existingIndex, 1);
+		this.accessOrder.push(key);
+	}
+	/**
+	* 🔧 Evict oldest guards if max limit exceeded
+	*
+	* @internal
+	*/
+	evictIfNeeded() {
+		if (this.guards.size >= this.maxGuards) {
+			const evictCount = Math.ceil(this.maxGuards * .1);
+			this.accessOrder.slice(0, evictCount).forEach((key) => {
+				const state = this.guards.get(key);
+				if (state) {
+					if (state.debounceTimer) {
+						clearTimeout(state.debounceTimer);
+						if (state.debounceResolve) state.debounceResolve(false);
+					}
+					if (state.throttleTimer) clearTimeout(state.throttleTimer);
+				}
+				this.guards.delete(key);
+			});
+			this.accessOrder = this.accessOrder.slice(evictCount);
+			if (typeof process !== "undefined" && process.env?.DEBUG_CONTEXT_ACTION) console.debug(`[ActionGuard] Evicted ${evictCount} oldest guards due to limit`);
+		}
 	}
 	/**
 	* Apply debouncing to an action
@@ -359,6 +423,7 @@ var ActionGuard = class {
 	* @internal
 	*/
 	async debounce(actionKey, debounceMs) {
+		this.evictIfNeeded();
 		/** Get or create guard state for this action */
 		let state = this.guards.get(actionKey);
 		if (!state) {
@@ -373,6 +438,7 @@ var ActionGuard = class {
 			};
 			this.guards.set(actionKey, state);
 		}
+		this.updateAccessOrder(actionKey);
 		/** Clear any existing debounce timer to restart the delay period */
 		if (state.debounceTimer) {
 			clearTimeout(state.debounceTimer);
@@ -417,6 +483,7 @@ var ActionGuard = class {
 	* @internal
 	*/
 	throttle(actionKey, throttleMs) {
+		this.evictIfNeeded();
 		/** Get or create guard state for this action */
 		let state = this.guards.get(actionKey);
 		if (!state) {
@@ -431,6 +498,7 @@ var ActionGuard = class {
 			};
 			this.guards.set(actionKey, state);
 		}
+		this.updateAccessOrder(actionKey);
 		const now = Date.now();
 		const timeSinceLastExecution = now - state.lastExecuted;
 		/** Check if enough time has passed since last execution */
@@ -548,6 +616,7 @@ var ActionGuard = class {
 			this.cleanupInterval = void 0;
 		}
 		this.clearAll();
+		this.accessOrder = [];
 	}
 	/**
 	* 🆕 Get statistics about active guards
@@ -632,7 +701,11 @@ var OperationQueue = class {
 	* - 작업 완료 시 대기 중인 프로세스에게 자동 알림
 	*/
 	async processQueue() {
-		if (this.processingPromise) return this.processingPromise;
+		if (this.processingPromise) {
+			await this.processingPromise;
+			if (this.queue.length > 0 && !this.processingPromise) return this.processQueue();
+			return;
+		}
 		this.processingPromise = this._doProcess();
 		try {
 			await this.processingPromise;
@@ -761,6 +834,35 @@ var OperationQueue = class {
 * 
 * @public
 */
+/**
+* Type guard to determine if an object is DispatchOptions
+* Extracted as utility function for reuse and performance
+* 
+* @param obj - Object to check
+* @returns True if object is DispatchOptions
+* @internal
+*/
+function isDispatchOptions(obj) {
+	if (!obj || typeof obj !== "object") return false;
+	if ("debounce" in obj && typeof obj.debounce === "number") return true;
+	if ("throttle" in obj && typeof obj.throttle === "number") return true;
+	if ("executionMode" in obj) return true;
+	if ("signal" in obj && obj.signal instanceof AbortSignal) return true;
+	if ("immediate" in obj && typeof obj.immediate === "boolean") return true;
+	if ("queuePriority" in obj && typeof obj.queuePriority === "number") return true;
+	if ("timeout" in obj && typeof obj.timeout === "number") return true;
+	if ("retryOnError" in obj && typeof obj.retryOnError === "object") return true;
+	if ("autoAbort" in obj && typeof obj.autoAbort === "object") return true;
+	if ("filter" in obj && typeof obj.filter === "object" && obj.filter !== null) {
+		const filter = obj.filter;
+		if ("handlerIds" in filter || "excludeHandlerIds" in filter || "priority" in filter || "custom" in filter) return true;
+	}
+	if ("result" in obj && typeof obj.result === "object" && obj.result !== null) {
+		const result = obj.result;
+		if ("strategy" in result || "merger" in result || "collect" in result || "maxResults" in result || "includeErrors" in result) return true;
+	}
+	return false;
+}
 var ActionRegister = class {
 	constructor(config = {}) {
 		this.pipelines = /* @__PURE__ */ new Map();
@@ -809,18 +911,16 @@ var ActionRegister = class {
 	* @public
 	*/
 	get actions() {
-		return new Proxy({}, { get: (target, prop) => {
+		if (!this._actionsProxy) this._actionsProxy = new Proxy({}, { get: (_target, prop) => {
 			if (typeof prop === "string" && this.pipelines.has(prop)) {
 				const actionKey = prop;
 				return (payloadOrOptions, options) => {
-					const isDispatchOptions = (obj) => {
-						return obj && typeof obj === "object" && ("debounce" in obj || "throttle" in obj || "executionMode" in obj || "signal" in obj || "immediate" in obj || "filter" in obj || "result" in obj);
-					};
 					if (payloadOrOptions && isDispatchOptions(payloadOrOptions)) return this.dispatch(actionKey, void 0, payloadOrOptions);
 					else return this.dispatch(actionKey, payloadOrOptions, options);
 				};
 			}
 		} });
+		return this._actionsProxy;
 	}
 	/**
 	* Actions-based dispatching with result collection
@@ -846,18 +946,16 @@ var ActionRegister = class {
 	* @returns Proxy object with action functions that return ExecutionResult
 	*/
 	get actionsWithResult() {
-		return new Proxy({}, { get: (target, prop) => {
+		if (!this._actionsWithResultProxy) this._actionsWithResultProxy = new Proxy({}, { get: (_target, prop) => {
 			if (typeof prop === "string" && this.pipelines.has(prop)) {
 				const actionKey = prop;
 				return (payloadOrOptions, options) => {
-					const isDispatchOptions = (obj) => {
-						return obj && typeof obj === "object" && ("debounce" in obj || "throttle" in obj || "executionMode" in obj || "signal" in obj || "immediate" in obj || "filter" in obj || "result" in obj);
-					};
 					if (payloadOrOptions && isDispatchOptions(payloadOrOptions)) return this.dispatchWithResult(actionKey, void 0, payloadOrOptions);
 					else return this.dispatchWithResult(actionKey, payloadOrOptions, options);
 				};
 			}
 		} });
+		return this._actionsWithResultProxy;
 	}
 	/**
 	* Register an action handler with optional configuration
@@ -1056,6 +1154,10 @@ var ActionRegister = class {
 			pipelineMap: Object.fromEntries(Array.from(this.pipelines.entries()).map(([k, v]) => [k, v.length]))
 		});
 		if (!pipeline || pipeline.length === 0) {
+			const warningMessage = `⚠️ Action '${String(action)}' has no registered handlers. This action will be ignored.`;
+			console.warn(warningMessage);
+			console.warn("💡 Tip: Register a handler using registry.register() before dispatching this action.");
+			console.warn("📋 Available actions:", Array.from(this.pipelines.keys()));
 			this.log(`No handlers found for action '${String(action)}', dispatch cancelled`, {}, "warn");
 			return;
 		}
@@ -1152,26 +1254,32 @@ var ActionRegister = class {
 			errors: []
 		};
 		const pipeline = this.pipelines.get(action);
-		if (!pipeline || pipeline.length === 0) return {
-			success: true,
-			aborted: false,
-			abortReason: void 0,
-			terminated: false,
-			result: void 0,
-			successResults: [],
-			results: [],
-			failedResults: [],
-			execution: {
-				duration: 0,
-				handlersExecuted: 0,
-				handlersSkipped: 0,
-				handlersFailed: 0,
-				startTime: _startTime,
-				endTime: _startTime
-			},
-			handlers: [],
-			errors: []
-		};
+		if (!pipeline || pipeline.length === 0) {
+			const warningMessage = `⚠️ Action '${String(action)}' has no registered handlers. This action will be ignored.`;
+			console.warn(warningMessage);
+			console.warn("💡 Tip: Register a handler using registry.register() before dispatching this action.");
+			console.warn("📋 Available actions:", Array.from(this.pipelines.keys()));
+			return {
+				success: true,
+				aborted: false,
+				abortReason: void 0,
+				terminated: false,
+				result: void 0,
+				successResults: [],
+				results: [],
+				failedResults: [],
+				execution: {
+					duration: 0,
+					handlersExecuted: 0,
+					handlersSkipped: 0,
+					handlersFailed: 0,
+					startTime: _startTime,
+					endTime: _startTime
+				},
+				handlers: [],
+				errors: []
+			};
+		}
 		const filteredHandlers = options?.filter ? this.filterHandlers(pipeline, options.filter) : pipeline;
 		const actionKey = String(action);
 		const guardResult = await this.applyActionGuardControlsWithResult(actionKey, filteredHandlers, options, _startTime, pipeline.length);