ngx-task 0.1.0

package/lib/angular/create-task.js

@@ -0,0 +1,312 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createTask = createTask;
+const core_1 = require("@angular/core");
+const execution_state_machine_js_1 = require("../core/execution-state-machine.js");
+const promise_adapter_js_1 = require("../adapters/promise-adapter.js");
+const observable_adapter_js_1 = require("../adapters/observable-adapter.js");
+const drop_scheduler_js_1 = require("../schedulers/drop-scheduler.js");
+const restart_scheduler_js_1 = require("../schedulers/restart-scheduler.js");
+const enqueue_scheduler_js_1 = require("../schedulers/enqueue-scheduler.js");
+const latest_scheduler_js_1 = require("../schedulers/latest-scheduler.js");
+const parallel_scheduler_js_1 = require("../schedulers/parallel-scheduler.js");
+class TaskExecutionImpl {
+    stateMachine;
+    id;
+    args;
+    createdAt;
+    statusSig;
+    progressSig;
+    resultSig;
+    errorSig;
+    startedAtSig;
+    finishedAtSig;
+    status;
+    progress;
+    result;
+    error;
+    startedAt;
+    finishedAt;
+    done;
+    constructor(stateMachine) {
+        this.stateMachine = stateMachine;
+        this.id = stateMachine.id;
+        this.args = stateMachine.args;
+        this.createdAt = stateMachine.createdAt;
+        this.done = stateMachine.done;
+        this.statusSig = (0, core_1.signal)(stateMachine.status);
+        this.progressSig = (0, core_1.signal)(stateMachine.progress);
+        this.resultSig = (0, core_1.signal)(stateMachine.result);
+        this.errorSig = (0, core_1.signal)(stateMachine.error);
+        this.startedAtSig = (0, core_1.signal)(stateMachine.startedAt);
+        this.finishedAtSig = (0, core_1.signal)(stateMachine.finishedAt);
+        this.status = this.statusSig.asReadonly();
+        this.progress = this.progressSig.asReadonly();
+        this.result = this.resultSig.asReadonly();
+        this.error = this.errorSig.asReadonly();
+        this.startedAt = this.startedAtSig.asReadonly();
+        this.finishedAt = this.finishedAtSig.asReadonly();
+        stateMachine.addListener({
+            onStatusChange: (status) => {
+                this.statusSig.set(status);
+                this.startedAtSig.set(stateMachine.startedAt);
+                this.finishedAtSig.set(stateMachine.finishedAt);
+            },
+            onProgressChange: (p) => this.progressSig.set(p),
+            onResultChange: (r) => this.resultSig.set(r),
+            onErrorChange: (e) => this.errorSig.set(e),
+        });
+    }
+    cancel(reason) {
+        this.stateMachine.cancel(reason);
+    }
+    resultOrThrow() {
+        return this.stateMachine.resultOrThrow();
+    }
+}
+class TaskImpl {
+    handler;
+    options;
+    statusSig = (0, core_1.signal)('idle');
+    pendingSig = (0, core_1.signal)(false);
+    runningSig = (0, core_1.signal)(false);
+    resultSig = (0, core_1.signal)(undefined);
+    errorSig = (0, core_1.signal)(undefined);
+    progressSig = (0, core_1.signal)(undefined);
+    runningCountSig = (0, core_1.signal)(0);
+    queuedCountSig = (0, core_1.signal)(0);
+    executionCountSig = (0, core_1.signal)(0);
+    lastExecutionSig = (0, core_1.signal)(undefined);
+    status = this.statusSig.asReadonly();
+    pending = this.pendingSig.asReadonly();
+    running = this.runningSig.asReadonly();
+    result = this.resultSig.asReadonly();
+    error = this.errorSig.asReadonly();
+    progress = this.progressSig.asReadonly();
+    runningCount = this.runningCountSig.asReadonly();
+    queuedCount = this.queuedCountSig.asReadonly();
+    executionCount = this.executionCountSig.asReadonly();
+    lastExecution = this.lastExecutionSig.asReadonly();
+    scheduler;
+    classifyError;
+    lastArgs;
+    seq = 0;
+    pendingTimer;
+    pendingActiveTime;
+    constructor(handler, options) {
+        this.handler = handler;
+        this.options = options;
+        this.classifyError = options?.classifyError ?? promise_adapter_js_1.defaultClassifyError;
+        this.scheduler = this.initScheduler(options);
+        this.initDestroyRef(options);
+    }
+    run(args) {
+        this.seq++;
+        this.lastArgs = args;
+        const executionId = `exec-${this.seq}`;
+        const stateMachine = new execution_state_machine_js_1.ExecutionStateMachine(executionId, args, this.seq);
+        const taskExecution = new TaskExecutionImpl(stateMachine);
+        this.executionCountSig.update(c => c + 1);
+        this.lastExecutionSig.set(taskExecution);
+        // Timeout logic setup
+        const timeoutOpt = this.options?.timeout;
+        const timeoutMs = typeof timeoutOpt === 'number' ? timeoutOpt : timeoutOpt?.milliseconds;
+        const timeoutMsg = typeof timeoutOpt === 'object' ? timeoutOpt.message : undefined;
+        let timeoutTimer = undefined;
+        stateMachine.addListener({
+            onStatusChange: (status) => {
+                if (status === 'running' && timeoutMs && timeoutMs > 0) {
+                    timeoutTimer = setTimeout(() => {
+                        const timeoutError = {
+                            cause: new Error(timeoutMsg ?? `Task execution ${executionId} timed out after ${timeoutMs}ms`),
+                            kind: 'timeout',
+                            message: timeoutMsg ?? `Task execution ${executionId} timed out after ${timeoutMs}ms`,
+                            retryable: true,
+                        };
+                        stateMachine.timeOut(timeoutError);
+                    }, timeoutMs);
+                }
+                else if (stateMachine.isSettled && timeoutTimer) {
+                    clearTimeout(timeoutTimer);
+                    timeoutTimer = undefined;
+                }
+                this.syncCountsAndStatus();
+            },
+            onProgressChange: (p) => this.progressSig.set(p),
+            onResultChange: (res) => {
+                if (res !== undefined) {
+                    this.resultSig.set(res);
+                    this.errorSig.set(undefined);
+                }
+            },
+            onErrorChange: (err) => {
+                if (err !== undefined) {
+                    this.errorSig.set(err);
+                }
+            },
+        });
+        stateMachine.done.finally(() => {
+            if (timeoutTimer) {
+                clearTimeout(timeoutTimer);
+                timeoutTimer = undefined;
+            }
+            queueMicrotask(() => this.syncCountsAndStatus());
+        });
+        this.scheduler.schedule(stateMachine, (exec) => {
+            const context = exec.createContext();
+            try {
+                const handlerResult = this.handler(exec.args, context);
+                if ((0, observable_adapter_js_1.isObservable)(handlerResult)) {
+                    const obs = handlerResult;
+                    const obsAdapter = new observable_adapter_js_1.ObservableOperationAdapter(() => obs, {
+                        observableResult: this.options?.observableResult,
+                        classifyError: this.classifyError,
+                    });
+                    obsAdapter.runWithObservable(exec, obs);
+                }
+                else {
+                    const promiseAdapter = new promise_adapter_js_1.PromiseOperationAdapter(async () => handlerResult, this.classifyError);
+                    promiseAdapter.run(exec);
+                }
+            }
+            catch (err) {
+                const taskErr = this.classifyError(err);
+                exec.fail(taskErr);
+            }
+        });
+        this.syncCountsAndStatus();
+        return taskExecution;
+    }
+    cancel(reason) {
+        const last = this.lastExecutionSig();
+        last?.cancel(reason);
+    }
+    cancelAll(reason) {
+        this.scheduler.cancelAll(reason);
+        this.syncCountsAndStatus();
+    }
+    reset() {
+        this.resultSig.set(undefined);
+        this.errorSig.set(undefined);
+        this.progressSig.set(undefined);
+        this.statusSig.set('idle');
+    }
+    retryLast() {
+        if (this.lastArgs !== undefined) {
+            return this.run(this.lastArgs);
+        }
+        return undefined;
+    }
+    syncCountsAndStatus() {
+        const rCount = this.scheduler.runningCount;
+        const qCount = this.scheduler.queuedCount;
+        this.runningCountSig.set(rCount);
+        this.queuedCountSig.set(qCount);
+        const isWorkActive = rCount > 0 || qCount > 0;
+        this.runningSig.set(rCount > 0);
+        this.updatePendingState(isWorkActive);
+        if (isWorkActive) {
+            this.statusSig.set('pending');
+        }
+        else if (this.executionCountSig() > 0) {
+            this.statusSig.set('settled');
+        }
+        else {
+            this.statusSig.set('idle');
+        }
+    }
+    updatePendingState(isWorkActive) {
+        const delay = this.options?.pendingDelay ?? 0;
+        const minDuration = this.options?.minimumPendingDuration ?? 0;
+        if (isWorkActive) {
+            if (this.pendingSig()) {
+                return;
+            }
+            if (delay > 0) {
+                if (!this.pendingTimer) {
+                    this.pendingTimer = setTimeout(() => {
+                        this.pendingTimer = undefined;
+                        if (this.scheduler.runningCount > 0 || this.scheduler.queuedCount > 0) {
+                            this.pendingActiveTime = Date.now();
+                            this.pendingSig.set(true);
+                        }
+                    }, delay);
+                }
+            }
+            else {
+                this.pendingActiveTime = Date.now();
+                this.pendingSig.set(true);
+            }
+        }
+        else {
+            if (this.pendingTimer) {
+                clearTimeout(this.pendingTimer);
+                this.pendingTimer = undefined;
+            }
+            if (this.pendingSig()) {
+                const elapsed = this.pendingActiveTime ? Date.now() - this.pendingActiveTime : minDuration;
+                const remaining = minDuration - elapsed;
+                if (remaining > 0) {
+                    setTimeout(() => {
+                        if (this.scheduler.runningCount === 0 && this.scheduler.queuedCount === 0) {
+                            this.pendingSig.set(false);
+                            this.pendingActiveTime = undefined;
+                        }
+                    }, remaining);
+                }
+                else {
+                    this.pendingSig.set(false);
+                    this.pendingActiveTime = undefined;
+                }
+            }
+        }
+    }
+    initScheduler(options) {
+        const policy = options?.concurrency ?? 'drop';
+        if (typeof policy === 'object' && policy.mode === 'parallel') {
+            return new parallel_scheduler_js_1.ParallelScheduler({
+                limit: policy.limit,
+                maxQueueSize: options?.maxQueueSize,
+                overflowPolicy: options?.overflowPolicy,
+            });
+        }
+        switch (policy) {
+            case 'restart':
+                return new restart_scheduler_js_1.RestartScheduler();
+            case 'enqueue':
+                return new enqueue_scheduler_js_1.EnqueueScheduler({
+                    maxQueueSize: options?.maxQueueSize,
+                    overflowPolicy: options?.overflowPolicy,
+                });
+            case 'latest':
+                return new latest_scheduler_js_1.LatestScheduler();
+            case 'drop':
+            default:
+                return new drop_scheduler_js_1.DropScheduler();
+        }
+    }
+    initDestroyRef(options) {
+        let destroyRef = null;
+        if (options?.injector) {
+            destroyRef = options.injector.get(core_1.DestroyRef, null);
+        }
+        else {
+            try {
+                destroyRef = (0, core_1.inject)(core_1.DestroyRef, { optional: true });
+            }
+            catch {
+                // Ignored outside DI context
+            }
+        }
+        const destroyBehavior = options?.destroyBehavior ?? 'cancel';
+        if (destroyRef && destroyBehavior === 'cancel') {
+            destroyRef.onDestroy(() => {
+                this.cancelAll('Owner destroyed');
+            });
+        }
+    }
+}
+function createTask(handler, options) {
+    return new TaskImpl(handler, options);
+}
+//# sourceMappingURL=create-task.js.map

package/lib/angular/create-task.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-task.js","sourceRoot":"","sources":["../../../projects/ngx-task/src/lib/angular/create-task.ts"],"names":[],"mappings":"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"}

package/lib/angular/task.interface.d.ts

@@ -0,0 +1,55 @@
+import type { Signal, Injector } from '@angular/core';
+import type { TaskExecutionStatus, TaskStatus, TaskProgress, TaskError, ConcurrencyPolicy, QueueOverflowPolicy } from '../core/types.js';
+import type { TaskOutcome } from '../core/outcome.js';
+import type { TaskContext } from '../core/task-context.js';
+import type { ObservableResultPolicy } from '../adapters/observable-adapter.js';
+export type TaskHandler<TArgs, TResult> = (args: TArgs, context: TaskContext) => PromiseLike<TResult> | any;
+export type DestroyBehavior = 'cancel' | 'detach' | 'allow';
+export interface TaskTimeoutOptions {
+    readonly milliseconds: number;
+    readonly message?: string;
+}
+export interface CreateTaskOptions<TArgs, TResult> {
+    concurrency?: ConcurrencyPolicy;
+    timeout?: number | TaskTimeoutOptions;
+    pendingDelay?: number;
+    minimumPendingDuration?: number;
+    classifyError?: (error: unknown) => TaskError;
+    destroyBehavior?: DestroyBehavior;
+    injector?: Injector;
+    maxQueueSize?: number;
+    overflowPolicy?: QueueOverflowPolicy;
+    observableResult?: ObservableResultPolicy;
+}
+export interface TaskExecution<TArgs, TResult> {
+    readonly id: string;
+    readonly args: TArgs;
+    readonly status: Signal<TaskExecutionStatus>;
+    readonly progress: Signal<TaskProgress | undefined>;
+    readonly result: Signal<TResult | undefined>;
+    readonly error: Signal<TaskError | undefined>;
+    readonly createdAt: number;
+    readonly startedAt: Signal<number | undefined>;
+    readonly finishedAt: Signal<number | undefined>;
+    readonly done: Promise<TaskOutcome<TResult>>;
+    cancel(reason?: unknown): void;
+    resultOrThrow(): Promise<TResult>;
+}
+export interface Task<TArgs, TResult> {
+    readonly status: Signal<TaskStatus>;
+    readonly pending: Signal<boolean>;
+    readonly running: Signal<boolean>;
+    readonly result: Signal<TResult | undefined>;
+    readonly error: Signal<TaskError | undefined>;
+    readonly progress: Signal<TaskProgress | undefined>;
+    readonly runningCount: Signal<number>;
+    readonly queuedCount: Signal<number>;
+    readonly executionCount: Signal<number>;
+    readonly lastExecution: Signal<TaskExecution<TArgs, TResult> | undefined>;
+    run(args: TArgs): TaskExecution<TArgs, TResult>;
+    cancel(reason?: unknown): void;
+    cancelAll(reason?: unknown): void;
+    reset(): void;
+    retryLast(): TaskExecution<TArgs, TResult> | undefined;
+}
+//# sourceMappingURL=task.interface.d.ts.map

package/lib/angular/task.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task.interface.d.ts","sourceRoot":"","sources":["../../../projects/ngx-task/src/lib/angular/task.interface.ts"],"names":[],"mappings":"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"}

package/lib/angular/task.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=task.interface.js.map

package/lib/angular/task.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task.interface.js","sourceRoot":"","sources":["../../../projects/ngx-task/src/lib/angular/task.interface.ts"],"names":[],"mappings":""}

package/lib/core/execution-state-machine.d.ts

@@ -0,0 +1,53 @@
+import type { TaskExecutionStatus, TaskError, TaskProgress } from './types.js';
+import type { TaskOutcome } from './outcome.js';
+import type { TaskContext } from './task-context.js';
+export interface ExecutionListener<TArgs, TResult> {
+    onStatusChange?: (status: TaskExecutionStatus) => void;
+    onProgressChange?: (progress: TaskProgress | undefined) => void;
+    onResultChange?: (result: TResult | undefined) => void;
+    onErrorChange?: (error: TaskError | undefined) => void;
+}
+export declare class ExecutionStateMachine<TArgs, TResult> {
+    readonly id: string;
+    readonly args: TArgs;
+    readonly createdAt: number;
+    readonly attempt: number;
+    readonly idempotencyKey: string;
+    private _status;
+    private _startedAt?;
+    private _finishedAt?;
+    private _progress?;
+    private _result?;
+    private _error?;
+    readonly abortController: AbortController;
+    readonly done: Promise<TaskOutcome<TResult>>;
+    private resolveDone;
+    private listeners;
+    constructor(id: string, args: TArgs, attempt?: number, idempotencyKey?: string);
+    get status(): TaskExecutionStatus;
+    get startedAt(): number | undefined;
+    get finishedAt(): number | undefined;
+    get progress(): TaskProgress | undefined;
+    get result(): TResult | undefined;
+    get error(): TaskError | undefined;
+    get isSettled(): boolean;
+    get isRunning(): boolean;
+    get isQueued(): boolean;
+    get signal(): AbortSignal;
+    addListener(listener: ExecutionListener<TArgs, TResult>): () => void;
+    createContext(reportProgressOverride?: (p: TaskProgress) => void): TaskContext;
+    queue(): boolean;
+    start(): boolean;
+    succeed(value: TResult): boolean;
+    fail(error: TaskError): boolean;
+    cancel(reason?: unknown): boolean;
+    supersede(): boolean;
+    drop(): boolean;
+    timeOut(error: TaskError): boolean;
+    reportProgress(progress: TaskProgress): void;
+    resultOrThrow(): Promise<TResult>;
+    private notifyStatus;
+    private notifyResult;
+    private notifyError;
+}
+//# sourceMappingURL=execution-state-machine.d.ts.map

package/lib/core/execution-state-machine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-state-machine.d.ts","sourceRoot":"","sources":["../../../projects/ngx-task/src/lib/core/execution-state-machine.ts"],"names":[],"mappings":"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"}

package/lib/core/execution-state-machine.js

@@ -0,0 +1,217 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExecutionStateMachine = void 0;
+const SETTLED_STATUSES = new Set([
+    'succeeded',
+    'failed',
+    'cancelled',
+    'superseded',
+    'dropped',
+    'timed-out',
+]);
+class ExecutionStateMachine {
+    id;
+    args;
+    createdAt;
+    attempt;
+    idempotencyKey;
+    _status = 'created';
+    _startedAt;
+    _finishedAt;
+    _progress;
+    _result;
+    _error;
+    abortController = new AbortController();
+    done;
+    resolveDone;
+    listeners = new Set();
+    constructor(id, args, attempt = 1, idempotencyKey) {
+        this.id = id;
+        this.args = args;
+        this.createdAt = Date.now();
+        this.attempt = attempt;
+        this.idempotencyKey = idempotencyKey ?? id;
+        this.done = new Promise((resolve) => {
+            this.resolveDone = resolve;
+        });
+    }
+    get status() {
+        return this._status;
+    }
+    get startedAt() {
+        return this._startedAt;
+    }
+    get finishedAt() {
+        return this._finishedAt;
+    }
+    get progress() {
+        return this._progress;
+    }
+    get result() {
+        return this._result;
+    }
+    get error() {
+        return this._error;
+    }
+    get isSettled() {
+        return SETTLED_STATUSES.has(this._status);
+    }
+    get isRunning() {
+        return this._status === 'running';
+    }
+    get isQueued() {
+        return this._status === 'queued';
+    }
+    get signal() {
+        return this.abortController.signal;
+    }
+    addListener(listener) {
+        this.listeners.add(listener);
+        return () => this.listeners.delete(listener);
+    }
+    createContext(reportProgressOverride) {
+        return {
+            signal: this.signal,
+            executionId: this.id,
+            attempt: this.attempt,
+            idempotencyKey: this.idempotencyKey,
+            reportProgress: (progress) => {
+                if (reportProgressOverride) {
+                    reportProgressOverride(progress);
+                }
+                else {
+                    this.reportProgress(progress);
+                }
+            },
+            throwIfCancelled: () => {
+                if (this.signal.aborted) {
+                    throw this.signal.reason ?? new Error(`Task execution ${this.id} was cancelled.`);
+                }
+            },
+        };
+    }
+    queue() {
+        if (this._status !== 'created')
+            return false;
+        this._status = 'queued';
+        this.notifyStatus();
+        return true;
+    }
+    start() {
+        if (this._status !== 'created' && this._status !== 'queued')
+            return false;
+        this._status = 'running';
+        this._startedAt = Date.now();
+        this.notifyStatus();
+        return true;
+    }
+    succeed(value) {
+        if (this._status !== 'running') {
+            // Late resolution ignored after settlement
+            return false;
+        }
+        this._status = 'succeeded';
+        this._result = value;
+        this._finishedAt = Date.now();
+        this.notifyStatus();
+        this.notifyResult();
+        this.resolveDone({ type: 'success', value });
+        return true;
+    }
+    fail(error) {
+        if (this._status !== 'running') {
+            // Late rejection ignored after settlement
+            return false;
+        }
+        this._status = 'failed';
+        this._error = error;
+        this._finishedAt = Date.now();
+        this.notifyStatus();
+        this.notifyError();
+        this.resolveDone({ type: 'failure', error });
+        return true;
+    }
+    cancel(reason) {
+        if (this.isSettled)
+            return false;
+        const wasRunningOrQueued = this._status === 'running' || this._status === 'queued';
+        this._status = 'cancelled';
+        this._finishedAt = Date.now();
+        this.abortController.abort(reason ?? 'cancelled');
+        this.notifyStatus();
+        this.resolveDone({ type: 'cancelled', reason });
+        return wasRunningOrQueued;
+    }
+    supersede() {
+        if (this.isSettled)
+            return false;
+        this._status = 'superseded';
+        this._finishedAt = Date.now();
+        this.abortController.abort('superseded');
+        this.notifyStatus();
+        this.resolveDone({ type: 'superseded' });
+        return true;
+    }
+    drop() {
+        if (this._status !== 'created')
+            return false;
+        this._status = 'dropped';
+        this._finishedAt = Date.now();
+        this.notifyStatus();
+        this.resolveDone({ type: 'dropped' });
+        return true;
+    }
+    timeOut(error) {
+        if (this._status !== 'running')
+            return false;
+        this._status = 'timed-out';
+        this._error = error;
+        this._finishedAt = Date.now();
+        this.abortController.abort('timed-out');
+        this.notifyStatus();
+        this.notifyError();
+        this.resolveDone({ type: 'timed-out', error });
+        return true;
+    }
+    reportProgress(progress) {
+        if (this.isSettled)
+            return;
+        this._progress = progress;
+        for (const listener of this.listeners) {
+            listener.onProgressChange?.(progress);
+        }
+    }
+    async resultOrThrow() {
+        const outcome = await this.done;
+        switch (outcome.type) {
+            case 'success':
+                return outcome.value;
+            case 'failure':
+            case 'timed-out':
+                throw outcome.error.cause ?? new Error(outcome.error.message);
+            case 'cancelled':
+                throw outcome.reason ?? new Error(`Task execution ${this.id} was cancelled.`);
+            case 'superseded':
+                throw new Error(`Task execution ${this.id} was superseded.`);
+            case 'dropped':
+                throw new Error(`Task execution ${this.id} was dropped.`);
+        }
+    }
+    notifyStatus() {
+        for (const listener of this.listeners) {
+            listener.onStatusChange?.(this._status);
+        }
+    }
+    notifyResult() {
+        for (const listener of this.listeners) {
+            listener.onResultChange?.(this._result);
+        }
+    }
+    notifyError() {
+        for (const listener of this.listeners) {
+            listener.onErrorChange?.(this._error);
+        }
+    }
+}
+exports.ExecutionStateMachine = ExecutionStateMachine;
+//# sourceMappingURL=execution-state-machine.js.map