@context-action/core 0.7.8 → 0.8.1

package/dist/index.js

@@ -787,6 +787,79 @@ var ActionRegister = class {
 		});
 	}
 	/**
+	* 🆕 Action-based dispatcher
+	* 
+	* Provides function-based access to actions for more convenient dispatching.
+	* Each action becomes a callable function that can be invoked directly.
+	* 
+	* @example
+	* ```typescript
+	* interface MyActions extends ActionPayloadMap {
+	*   userLogin: { userId: string; email: string };
+	*   resetApp: void;
+	* }
+	* 
+	* const registry = new ActionRegister<MyActions>();
+	* 
+	* // Function-based dispatching
+	* await registry.actions.userLogin({ userId: '123', email: 'test@example.com' });
+	* await registry.actions.resetApp();
+	* ```
+	* 
+	* @public
+	*/
+	get actions() {
+		return 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);
+				};
+			}
+		} });
+	}
+	/**
+	* Actions-based dispatching with result collection
+	* 
+	* Provides a function-based interface for dispatching actions with detailed execution results.
+	* Each registered action becomes a callable function that returns ExecutionResult.
+	* 
+	* @example
+	* ```typescript
+	* // Actions with payload
+	* const result = await registry.actionsWithResult.userLogin({ userId: '123', email: 'user@example.com' });
+	* 
+	* // Actions without payload
+	* const result = await registry.actionsWithResult.userLogout();
+	* 
+	* // With options
+	* const result = await registry.actionsWithResult.processData(
+	*   { data: { name: 'test' }, type: 'json' },
+	*   { executionMode: 'parallel' }
+	* );
+	* ```
+	* 
+	* @returns Proxy object with action functions that return ExecutionResult
+	*/
+	get actionsWithResult() {
+		return 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);
+				};
+			}
+		} });
+	}
+	/**
 	* Register an action handler with optional configuration
 	* 
 	* @param action - The action type to register handler for
@@ -952,21 +1025,6 @@ var ActionRegister = class {
 		});
 		return unregister;
 	}
-	/**
-	* Dispatch an action with optional execution options
-	* 
-	* @param action - The action type to dispatch
-	* @param payload - The action payload data
-	* @param options - Optional dispatch options (execution mode, filters, etc.)
-	* 
-	* @returns Promise that resolves when all handlers complete
-	* 
-	* @throws {Error} When action dispatching fails
-	* 
-	* @see https://mineclover.github.io/context-action/en/guide/patterns/action/basic-usage
-	* 
-	* @public
-	*/
 	async dispatch(action, payload, options) {
 		if (options?.immediate || !this.dispatchQueue) return this._performDispatch(action, payload, options);
 		else return this.dispatchQueue.enqueue(async () => {
@@ -998,6 +1056,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;
 		}
@@ -1094,26 +1156,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);
@@ -1333,8 +1401,7 @@ var ActionRegister = class {
 		};
 		controller.mergeResult = (merger) => {
 			const currentResult = context.results[context.results.length - 1];
-			const previousResults = context.results.slice(0, -1);
-			const mergedResult = merger(previousResults, currentResult);
+			const mergedResult = merger(context.results.slice(0, -1), currentResult);
 			context.results[context.results.length - 1] = mergedResult;
 		};
 		return controller;