@context-action/core 0.9.2 → 1.0.0

package/dist/index.d.ts

@@ -14,33 +14,114 @@ interface ActionSchemaLike {
     };
   };
 }
+type ActionNames<T extends ActionPayloadMap> = Extract<keyof T, string>;
+type ActionResultMap<T extends ActionPayloadMap> = Partial<Record<ActionNames<T>, unknown>>;
+type ActionResult<TResultMap extends ActionPayloadMap, K extends PropertyKey> = K extends keyof TResultMap ? TResultMap[K] : void;
 interface PipelineController<T = unknown, R = void> {
   readonly signal?: AbortSignal;
   abort(reason?: string): void;
   modifyPayload(modifier: (payload: T) => T): void;
   getPayload(): T;
   jumpToPriority(priority: number): void;
-  return(result: R): void;
+  return(result: R): R;
   setResult(result: R): void;
   getResults(): R[];
   mergeResult(merger: (previousResults: R[], currentResult: R) => R): void;
 }
+interface ActionEffectController<T = unknown> {
+  readonly signal?: AbortSignal;
+  getPayload(): T;
+}
+interface ActionGuardController<T = unknown> extends ActionEffectController<T> {
+  abort(reason?: string): void;
+  modifyPayload(modifier: (payload: T) => T): void;
+}
+interface ActionResultController<T = unknown, R = void> extends ActionEffectController<T> {
+  abort(reason?: string): void;
+  return(result: R): R;
+  setResult(result: R): void;
+  getResults(): readonly R[];
+  mergeResult(merger: (previousResults: readonly R[], currentResult: R) => R): void;
+}
+type HandlerRole = 'guard' | 'result' | 'observer' | 'legacy';
+interface ActionObserverEvent<T = unknown, R = void> {
+  readonly action: string;
+  readonly payload: Readonly<T>;
+  readonly outcome: ExecutionResult<R>['outcome'];
+  readonly result: R | readonly R[] | undefined;
+  readonly errors: readonly HandlerError[];
+  readonly signal?: AbortSignal;
+}
+type ActionObserverHandler<T = unknown, R = void> = (event: ActionObserverEvent<T, R>) => void | Promise<void>;
+interface ObserverConfig<T = unknown> extends Omit<HandlerConfig<T>, 'debounce' | 'throttle' | 'blocking' | 'errorPolicy'> {
+  when?: 'success' | 'failure' | 'always';
+}
+interface GuardConfig<T = unknown> extends Omit<HandlerConfig<T>, 'blocking' | 'scheduling' | 'errorPolicy' | 'debounce' | 'throttle' | 'when'> {}
+interface EffectConfig<T = unknown> extends HandlerConfig<T> {
+  effectKind: 'guard' | 'observer';
+}
 type ActionHandler<T = unknown, R = void> = (payload: T, controller: PipelineController<T, R>) => R | Promise<R> | void | Promise<void>;
+type ActionEffectHandler<T = unknown> = (payload: T, controller: ActionEffectController<T>) => void | Promise<void>;
+type ActionGuardHandler<T = unknown> = (payload: T, controller: ActionGuardController<T>) => void | Promise<void>;
+type ActionResultHandler<T = unknown, R = void> = (payload: T, controller: ActionResultController<T, R>) => R | Promise<R>;
+type HandlerScheduling = 'await-before-next' | 'start-and-continue';
+type HandlerErrorPolicy = 'fatal' | 'collect';
 interface HandlerConfig<T = unknown> {
   priority?: number;
   id?: string;
   blocking?: boolean;
+  scheduling?: HandlerScheduling;
+  errorPolicy?: HandlerErrorPolicy;
   once?: boolean;
   debounce?: number;
   throttle?: number;
   replaceExisting?: boolean;
   cleanup?: () => void;
   condition?: (payload: T) => boolean;
+  metadata?: Record<string, unknown>;
+  when?: 'success' | 'failure' | 'always';
 }
+interface ResolvedHandlerConfig<T = unknown> {
+  priority: number;
+  id: string;
+  blocking: boolean;
+  scheduling: HandlerScheduling;
+  errorPolicy: HandlerErrorPolicy;
+  once: boolean;
+  replaceExisting: boolean;
+  debounce?: number;
+  throttle?: number;
+  cleanup?: () => void;
+  condition?: (payload: T) => boolean;
+  metadata?: Record<string, unknown>;
+}
+declare function resolveHandlerConfig<T = unknown>(config: HandlerConfig<T> | undefined, handlerId: string): ResolvedHandlerConfig<T>;
 interface HandlerRegistration<T = unknown, R = void> {
   handler: ActionHandler<T, R>;
-  config: Required<HandlerConfig<T>>;
+  config: ResolvedHandlerConfig<T>;
+  id: string;
+  role?: HandlerRole;
+}
+type HandlerExecutionStatus = 'running' | 'succeeded' | 'failed' | 'skipped' | 'cancelled';
+interface HandlerExecutionOutcome<R = void> {
   id: string;
+  status: HandlerExecutionStatus;
+  executed: boolean;
+  duration: number | undefined;
+  result: R | undefined;
+  error: Error | undefined;
+  metadata: Record<string, unknown> | undefined;
+  terminationRequested?: boolean;
+  terminationResult?: R;
+}
+interface PipelineControllerState<T = unknown, R = void> {
+  payload: T;
+  aborted: boolean;
+  abortReason: string | undefined;
+  jumpToPriority: number | undefined;
+  terminated: boolean;
+  terminationResult: R | undefined;
+  results: R[];
 }
 type ExecutionMode = 'sequential' | 'parallel' | 'race';
 interface PipelineContext<T = unknown, R = void> {
@@ -48,7 +129,11 @@ interface PipelineContext<T = unknown, R = void> {
   payload: T;
   handlers: HandlerRegistration<T, R>[];
   executedHandlers?: HandlerRegistration<T, R>[];
+  handlerOutcomes?: HandlerExecutionOutcome<R>[];
+  raceWinnerId?: string;
+  raceLoserOutcomes?: HandlerExecutionOutcome<R>[];
   deferOnceCleanup?: boolean;
+  claimOnce?(registration: HandlerRegistration<T, R>): boolean;
   signal?: AbortSignal;
   trackHandlerPromise?<V>(promise: Promise<V>): Promise<V>;
   collectedErrors?: HandlerError[];
@@ -71,6 +156,7 @@ interface ActionRegisterConfig {
     defaultExecutionMode?: ExecutionMode;
     useConcurrencyQueue?: boolean;
     maxHandlersPerAction?: number;
+    maxJumps?: number;
     errorHandler?: (error: Error, context: unknown) => void | Promise<void>;
     schema?: Record<string, ActionSchemaLike>;
     validateOnDispatch?: boolean;
@@ -88,6 +174,7 @@ interface DispatchOptions {
   retryOnError?: {
     maxAttempts: number;
     delay: number;
+    attemptBarrier?: 'abort-and-drain' | 'abort-and-overlap';
   };
   autoAbort?: {
     enabled: boolean;
@@ -101,7 +188,7 @@ interface DispatchOptions {
       min?: number;
       max?: number;
     };
-    custom?: (config: Required<HandlerConfig>) => boolean;
+    custom?: (config: Readonly<ResolvedHandlerConfig>) => boolean;
   };
   result?: {
     strategy?: 'first' | 'last' | 'all' | 'merge' | 'custom';
@@ -116,6 +203,7 @@ interface ExecutionResult<R = void> {
   aborted: boolean;
   abortReason: string | undefined;
   terminated: boolean;
+  outcome: 'completed' | 'completed_with_errors' | 'failed' | 'cancelled' | 'debounced' | 'throttled';
   validation?: {
     passed: boolean;
     errors: string[];
@@ -130,6 +218,17 @@ interface ExecutionResult<R = void> {
   }>;
   execution: {
     duration: number;
+    admissionDuration: number;
+    queueWaitDuration: number;
+    pipelineDuration: number;
+    retryDelayDuration?: number;
+    resultProcessingDuration?: number;
+    attempts?: Array<{
+      startTime: number;
+      endTime: number;
+      duration: number;
+      outcome: 'succeeded' | 'failed' | 'retried' | 'cancelled';
+    }>;
     handlersExecuted: number;
     handlersSkipped: number;
     handlersFailed: number;
@@ -139,11 +238,19 @@ interface ExecutionResult<R = void> {
   handlers: Array<{
     id: string;
     executed: boolean;
+    status: HandlerExecutionStatus;
     duration: number | undefined;
     result: R | undefined;
     error: Error | undefined;
     metadata: Record<string, unknown> | undefined;
   }>;
+  raceDiagnostics?: {
+    winnerId?: string;
+    winner?: HandlerExecutionOutcome<R>;
+    loserSnapshots: Array<HandlerExecutionOutcome<R>>;
+    pendingLosersAtReturn: number;
+    observedLoserFailures: number;
+  };
   errors: HandlerError[];
 }
 interface HandlerError {
@@ -153,13 +260,10 @@ interface HandlerError {
   severity: 'blocking' | 'non-blocking';
 }
 type UnregisterFunction = () => void;
-type VoidActions<T extends ActionPayloadMap> = { [K in keyof T]: T[K] extends undefined | undefined ? K : never; }[keyof T];
-type PayloadActions<T extends ActionPayloadMap> = { [K in keyof T]: T[K] extends undefined | undefined ? never : K; }[keyof T];
-interface ActionDispatcher<T extends ActionPayloadMap> {
-  <K extends VoidActions<T>>(action: K, options?: DispatchOptions): Promise<void>;
-  <K extends VoidActions<T>>(action: K, payload?: undefined, options?: DispatchOptions): Promise<void>;
-  <K extends PayloadActions<T>>(action: K, payload: T[K], options?: DispatchOptions): Promise<void>;
-}
+type DispatchArgs<P> = [P] extends [void] ? [payload?: undefined, options?: DispatchOptions] : [payload: P, options?: DispatchOptions];
+type ReservedActionKey = 'then' | 'catch' | 'finally' | 'toJSON' | 'constructor' | '__proto__' | 'prototype';
+type ProxyActionKey<T extends ActionPayloadMap> = Exclude<ActionNames<T>, ReservedActionKey>;
+type ActionDispatcher<T extends ActionPayloadMap> = <K extends ActionNames<T>>(action: K, ...args: DispatchArgs<T[K]>) => Promise<void>;
 interface ActionRegistryInfo<T extends ActionPayloadMap> {
   name: string;
   totalActions: number;
@@ -183,8 +287,10 @@ interface ActionHandlerStats<T extends ActionPayloadMap> {
 }
 //#endregion
 //#region src/ActionRegister.d.ts
-declare class ActionRegister<T extends ActionPayloadMap = Record<string, unknown>> {
+declare class ActionRegister<T extends ActionPayloadMap = Record<string, unknown>, TResultMap extends ActionResultMap<T> = {}> {
   private pipelines;
+  private readonly observerHandlers;
+  private readonly claimedOnceHandlers;
   private readonly actionGuard;
   private executionMode;
   private actionExecutionModes;
@@ -194,9 +300,9 @@ declare class ActionRegister<T extends ActionPayloadMap = Record<string, unknown
   private readonly registryConfig;
   private readonly isDebugMode;
   private readonly maxHandlersPerAction;
+  private readonly maxJumps;
   private dispatchQueue?;
   private handlerIdCounter;
-  private controllerPool;
   private lifecycleState;
   private readonly lifecycleController;
   private readonly activeDispatches;
@@ -205,21 +311,37 @@ declare class ActionRegister<T extends ActionPayloadMap = Record<string, unknown
   private dispatchConstructionDepth;
   private _actionsProxy?;
   private _actionsWithResultProxy?;
+  private readonly actionDispatchers;
+  private readonly actionResultDispatchers;
   constructor(config?: ActionRegisterConfig);
-  get actions(): { [K in keyof T]: T[K] extends void ? (payload?: undefined, options?: DispatchOptions) => Promise<void> : (payload: T[K], options?: DispatchOptions) => Promise<void>; };
-  get actionsWithResult(): { [K in keyof T]: T[K] extends void ? (payload?: undefined, options?: DispatchOptions) => Promise<ExecutionResult<any>> : (payload: T[K], options?: DispatchOptions) => Promise<ExecutionResult<any>>; };
-  register<K extends keyof T, R = void>(action: K, handler: ActionHandler<T[K], R>, config?: HandlerConfig<T[K]>): UnregisterFunction;
+  get actions(): { [K in ProxyActionKey<T>]: (...args: DispatchArgs<T[K]>) => Promise<void>; };
+  get actionsWithResult(): { [K in ProxyActionKey<T>]: (...args: DispatchArgs<T[K]>) => Promise<ExecutionResult<ActionResult<TResultMap, K>>>; };
+  register<K extends ActionNames<T> & keyof TResultMap>(action: K, handler: ActionResultHandler<T[K], ActionResult<TResultMap, K>>, config?: HandlerConfig<T[K]>): UnregisterFunction;
+  register<K extends Exclude<ActionNames<T>, keyof TResultMap>, R = void>(action: K, handler: ActionHandler<T[K], R>, config?: HandlerConfig<T[K]>): UnregisterFunction;
+  registerEffect<K extends ActionNames<T>>(action: K, handler: ActionGuardHandler<T[K]>, config: EffectConfig<T[K]> & {
+    effectKind: 'guard';
+  }): UnregisterFunction;
+  registerEffect<K extends ActionNames<T>>(action: K, handler: ActionEffectHandler<T[K]>, config: EffectConfig<T[K]> & {
+    effectKind: 'observer';
+  }): UnregisterFunction;
+  registerGuard<K extends ActionNames<T>>(action: K, handler: ActionGuardHandler<T[K]>, config?: GuardConfig<T[K]>): UnregisterFunction;
+  registerObserver<K extends ActionNames<T>, R = ActionResult<TResultMap, K>, H extends (event: ActionObserverEvent<T[K], R>) => unknown = ActionObserverHandler<T[K], R>>(action: K, handler: H & (ReturnType<H> extends void | Promise<void> ? unknown : never), config?: ObserverConfig<T[K]>): UnregisterFunction;
+  registerResult<K extends ActionNames<T> & keyof TResultMap>(action: K, handler: ActionResultHandler<T[K], ActionResult<TResultMap, K>>, config?: HandlerConfig<T[K]>): UnregisterFunction;
+  private registerWithRole;
   private log;
   private assertAcceptingWork;
+  private assertStringActionKey;
   private rejectedLifecyclePromise;
   private generateHandlerId;
   private createAbortSignal;
   private _performRegistrationSync;
-  dispatch<K extends keyof T>(action: K, payload: T[K], options?: DispatchOptions): Promise<void>;
-  dispatch<K extends keyof T>(action: K, payload?: undefined, options?: DispatchOptions): Promise<void>;
+  dispatch<K extends ActionNames<T>>(action: K, ...args: DispatchArgs<T[K]>): Promise<void>;
   private executeWithRetry;
   private trackDispatchPromise;
   private trackHandlerPromise;
+  private withAttemptSignal;
+  private shouldDrainBeforeRetry;
+  private drainAttemptHandlers;
   private trackGlobalHandlerPromise;
   private waitForRetry;
   private createTimeoutScope;
@@ -228,31 +350,43 @@ declare class ActionRegister<T extends ActionPayloadMap = Record<string, unknown
   private invokeErrorHandler;
   private validatePayload;
   private createAbortedExecutionResult;
-  private _performDispatch;
-  dispatchWithResult<K extends keyof T, R = void>(action: K, payload?: T[K], options?: DispatchOptions): Promise<ExecutionResult<R>>;
+  private resolveDispatchPlan;
+  private evaluateTimingGuards;
+  private getAttemptHandlers;
+  private getObservers;
+  private executeObservers;
+  private snapshotObserverEvent;
+  private safeSnapshotObserverEvent;
+  private executeGuardPhase;
+  private createGuardRejectedResult;
+  private createTimingGuardResult;
+  dispatchWithResult<K extends ActionNames<T> & keyof TResultMap>(action: K, ...args: DispatchArgs<T[K]>): Promise<ExecutionResult<ActionResult<TResultMap, K>>>;
+  dispatchWithResult<K extends Exclude<ActionNames<T>, keyof TResultMap>, R = void>(action: K, ...args: DispatchArgs<T[K]>): Promise<ExecutionResult<R>>;
   private _performDispatchWithResult;
-  private applyActionGuardControlsWithResult;
-  private getControllerFromPool;
+  private createController;
   private filterHandlers;
+  private validateResultOptions;
   private processResults;
   private executePipeline;
   private cleanupOneTimeHandlers;
-  getHandlerCount<K extends keyof T>(action: K): number;
-  hasHandlers<K extends keyof T>(action: K): boolean;
+  private claimOnceRegistration;
+  getHandlerCount<K extends ActionNames<T>>(action: K): number;
+  hasHandlers<K extends ActionNames<T>>(action: K): boolean;
   getRegisteredActions(): (keyof T)[];
-  clearAction<K extends keyof T>(action: K): void;
+  clearAction<K extends ActionNames<T>>(action: K): void;
   clearAll(): void;
   getName(): string;
   getRegistryInfo(): ActionRegistryInfo<T>;
-  getActionStats<K extends keyof T>(action: K): ActionHandlerStats<T> | null;
+  getActionStats<K extends ActionNames<T>>(action: K): ActionHandlerStats<T> | null;
   getAllActionStats(): Array<ActionHandlerStats<T>>;
   setExecutionMode(mode: ExecutionMode): void;
-  setActionExecutionMode<K extends keyof T>(action: K, mode: ExecutionMode): void;
-  getActionExecutionMode<K extends keyof T>(action: K): ExecutionMode;
-  removeActionExecutionMode<K extends keyof T>(action: K): void;
+  setActionExecutionMode<K extends ActionNames<T>>(action: K, mode: ExecutionMode): void;
+  getActionExecutionMode<K extends ActionNames<T>>(action: K): ExecutionMode;
+  removeActionExecutionMode<K extends ActionNames<T>>(action: K): void;
   getRegistryConfig(): ActionRegisterConfig['registry'];
   isDebugEnabled(): boolean;
   private createUnregisterFunction;
+  private getUnregisterFunctions;
   private removeRegistration;
   private runRegistrationCleanup;
   getUnregisterFunctionCount(): number;
@@ -265,13 +399,16 @@ declare class ActionRegister<T extends ActionPayloadMap = Record<string, unknown
 }
 //#endregion
 //#region src/action-guard.d.ts
+type TimerHandle = ReturnType<typeof setTimeout>;
 interface GuardState {
-  lastExecuted: number;
-  debounceTimer: NodeJS.Timeout | undefined;
-  throttleTimer: NodeJS.Timeout | undefined;
+  lastThrottleExecutedAt: number;
+  lastDebounceSettledAt: number;
+  debounceTimer: TimerHandle | undefined;
+  throttleTimer: TimerHandle | undefined;
   isThrottled: boolean;
-  debouncePromise: Promise<boolean> | undefined;
   debounceResolve: ((value: boolean) => void) | undefined;
+  debounceAbortCleanup: (() => void) | undefined;
+  debounceRequestId: number;
 }
 declare class ActionGuard {
   private guards;
@@ -279,17 +416,13 @@ declare class ActionGuard {
   private readonly autoCleanupEnabled;
   private readonly maxIdleTime;
   private readonly cleanupIntervalMs;
-  private readonly maxGuards;
-  private accessOrder;
   constructor(autoCleanup?: boolean);
   private ensureAutoCleanup;
   private startAutoCleanup;
   private stopAutoCleanup;
   private performCleanup;
-  private updateAccessOrder;
-  private evictIfNeeded;
-  debounce(actionKey: string, debounceMs: number): Promise<boolean>;
-  throttle(actionKey: string, throttleMs: number): boolean;
+  debounce(actionKey: string, debounceMs: number, signal?: AbortSignal): Promise<boolean>;
+  throttle(actionKey: string, throttleMs: number, signal?: AbortSignal): boolean;
   clearGuards(actionKey: string): void;
   clearAll(): void;
   getGuardState(actionKey: string): GuardState | undefined;
@@ -301,17 +434,22 @@ declare class ActionGuard {
   };
 }
 //#endregion
-//#region src/execution-modes.d.ts
-declare function executeSequential<T, R = void>(context: PipelineContext<T, R>, createController: (registration: HandlerRegistration<T, R>, index: number) => PipelineController<T, R>): Promise<void>;
-declare function executeParallel<T, R = void>(context: PipelineContext<T, R>, createController: (registration: HandlerRegistration<T, R>, index: number) => PipelineController<T, R>): Promise<void>;
-declare function executeRace<T, R = void>(context: PipelineContext<T, R>, createController: (registration: HandlerRegistration<T, R>, index: number) => PipelineController<T, R>): Promise<void>;
-//#endregion
 //#region src/errors.d.ts
 interface ZodIssueLike {
   message: string;
   path: readonly (string | number | symbol)[];
   code: string;
 }
+declare class ActionResultProcessingError extends Error {
+  name: string;
+  constructor(message: string);
+}
+declare class ActionAttemptSupersededError extends Error {
+  readonly attempt: number;
+  name: string;
+  constructor(attempt: number);
+}
+declare function isActionResultProcessingError(error: unknown): error is ActionResultProcessingError;
 declare class ActionValidationError extends Error {
   name: string;
   readonly zodError: unknown;
@@ -345,5 +483,10 @@ declare function isActionValidationError(error: unknown): error is ActionValidat
 declare function isActionTimeoutError(error: unknown): error is ActionTimeoutError;
 declare function isActionRegisterDestroyedError(error: unknown): error is ActionRegisterDestroyedError;
 //#endregion
-export { type ActionDispatcher, ActionGuard, type ActionHandler, type ActionPayloadMap, ActionRegister, type ActionRegisterConfig, ActionRegisterDestroyedError, type ActionSchemaLike, ActionTimeoutError, ActionValidationError, type DispatchOptions, type ExecutionMode, type ExecutionResult, type HandlerConfig, type HandlerRegistration, type PipelineContext, type PipelineController, type UnregisterFunction, executeParallel, executeRace, executeSequential, isActionRegisterDestroyedError, isActionTimeoutError, isActionValidationError };
+//#region src/execution-modes.d.ts
+declare function executeSequential<T, R = void>(context: PipelineContext<T, R>, createController: (registration: HandlerRegistration<T, R>, index: number) => PipelineController<T, R>): Promise<void>;
+declare function executeParallel<T, R = void>(context: PipelineContext<T, R>, createController: (registration: HandlerRegistration<T, R>, index: number, state: PipelineControllerState<T, R>) => PipelineController<T, R>): Promise<void>;
+declare function executeRace<T, R = void>(context: PipelineContext<T, R>, createController: (registration: HandlerRegistration<T, R>, index: number, state: PipelineControllerState<T, R>) => PipelineController<T, R>): Promise<void>;
+//#endregion
+export { ActionAttemptSupersededError, type ActionDispatcher, type ActionEffectController, type ActionEffectHandler, ActionGuard, type ActionGuardController, type ActionGuardHandler, type ActionHandler, type ActionNames, type ActionObserverEvent, type ActionObserverHandler, type ActionPayloadMap, ActionRegister, type ActionRegisterConfig, ActionRegisterDestroyedError, type ActionResult, type ActionResultController, type ActionResultHandler, type ActionResultMap, ActionResultProcessingError, type ActionSchemaLike, ActionTimeoutError, ActionValidationError, type DispatchArgs, type DispatchOptions, type EffectConfig, type ExecutionMode, type ExecutionResult, type GuardConfig, type HandlerConfig, type HandlerErrorPolicy, type HandlerRegistration, type HandlerRole, type HandlerScheduling, type ObserverConfig, type PipelineContext, type PipelineController, type ProxyActionKey, type ReservedActionKey, type ResolvedHandlerConfig, type UnregisterFunction, executeParallel, executeRace, executeSequential, isActionRegisterDestroyedError, isActionResultProcessingError, isActionTimeoutError, isActionValidationError, resolveHandlerConfig };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../src/types.ts","../src/ActionRegister.ts","../src/action-guard.ts","../src/execution-modes.ts","../src/errors.ts"],"mappings":"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"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/types.ts","../src/ActionRegister.ts","../src/action-guard.ts","../src/errors.ts","../src/execution-modes.ts"],"mappings":"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"}