stelo 1.0.1

package/dist/executor.d.ts

@@ -0,0 +1,212 @@
+export type TaskPriority = 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10;
+export type TaskStatus = 'pending' | 'queued' | 'running' | 'completed' | 'failed' | 'cancelled' | 'timedout' | 'retrying';
+export interface TaskOptions {
+    /** Task priority (0 = lowest, 10 = highest). Default: 5 */
+    priority?: TaskPriority;
+    /** Timeout in ms. Default: 30000 */
+    timeoutMs?: number;
+    /** Number of retry attempts on failure. Default: 0 */
+    retryAttempts?: number;
+    /** Delay between retries in ms. Default: 1000 */
+    retryDelayMs?: number;
+    /** Exponential backoff multiplier for retries. Default: 2.0 */
+    retryBackoff?: number;
+    /** Tags for categorization/filtering */
+    tags?: string[];
+    /** Group ID — tasks in same group execute sequentially */
+    group?: string;
+    /** Task IDs this task depends on (must complete first) */
+    dependsOn?: string[];
+    /** Arbitrary metadata */
+    metadata?: Record<string, unknown>;
+    /** Cancel signal */
+    signal?: AbortSignal;
+}
+export interface Task<T = unknown> {
+    /** Unique task ID */
+    id: string;
+    /** Human-readable task name */
+    name: string;
+    /** Current status */
+    status: TaskStatus;
+    /** Task priority */
+    priority: TaskPriority;
+    /** The function to execute */
+    execute: () => T | Promise<T>;
+    /** Task result (set after completion) */
+    result?: T;
+    /** Error (set after failure) */
+    error?: Error;
+    /** When the task was created */
+    createdAt: string;
+    /** When execution started */
+    startedAt?: string;
+    /** When execution completed/failed */
+    completedAt?: string;
+    /** Duration in ms */
+    durationMs?: number;
+    /** Retry attempt number */
+    attempt: number;
+    /** Max retry attempts */
+    maxAttempts: number;
+    /** Retry delay in ms */
+    retryDelayMs: number;
+    /** Retry backoff multiplier */
+    retryBackoff: number;
+    /** Timeout in ms */
+    timeoutMs: number;
+    /** Tags */
+    tags: string[];
+    /** Group */
+    group?: string;
+    /** Dependencies */
+    dependsOn: string[];
+    /** Metadata */
+    metadata: Record<string, unknown>;
+    /** Promise that resolves when task completes */
+    promise: Promise<T>;
+    /** Internal resolve/reject  */
+    _resolve: (value: T) => void;
+    _reject: (error: Error) => void;
+    /** Abort signal */
+    signal?: AbortSignal;
+    /** Timeout handle */
+    _timeoutHandle?: ReturnType<typeof setTimeout>;
+}
+export interface ExecutorOptions {
+    /** Max concurrent tasks. Default: 1 */
+    maxConcurrency?: number;
+    /** Default task timeout in ms. Default: 30000 */
+    defaultTimeoutMs?: number;
+    /** Default priority for tasks. Default: 5 */
+    defaultPriority?: TaskPriority;
+    /** Max queue size (0 = unlimited). Default: 10000 */
+    maxQueueSize?: number;
+    /** Default retry attempts. Default: 0 */
+    defaultRetryAttempts?: number;
+    /** Default retry delay. Default: 1000 */
+    defaultRetryDelayMs?: number;
+    /** Process tasks in FIFO order within same priority? Default: true */
+    fifoWithinPriority?: boolean;
+    /** Pause processing on first failure? Default: false */
+    pauseOnFailure?: boolean;
+    /** Enable task execution logging? Default: true */
+    logging?: boolean;
+}
+export interface ExecutorStats {
+    /** Total tasks submitted */
+    totalSubmitted: number;
+    /** Tasks currently in queue */
+    queueSize: number;
+    /** Tasks currently running */
+    runningCount: number;
+    /** Tasks completed successfully */
+    completedCount: number;
+    /** Tasks that failed */
+    failedCount: number;
+    /** Tasks that were cancelled */
+    cancelledCount: number;
+    /** Tasks that timed out */
+    timedOutCount: number;
+    /** Average task duration (ms) */
+    avgDurationMs: number;
+    /** Is the executor running? */
+    isRunning: boolean;
+    /** Is the executor paused? */
+    isPaused: boolean;
+}
+export declare class Executor {
+    private _queue;
+    private _running;
+    private _completed;
+    private _options;
+    private _isRunning;
+    private _isPaused;
+    private _stats;
+    private _processing;
+    private _log;
+    private _groupLocks;
+    constructor(options?: ExecutorOptions);
+    /**
+     * Submit a task to the executor.
+     * Returns a promise that resolves with the task result.
+     *
+     * @example
+     * ```ts
+     * const result = await executor.submit('moveToButton', () => {
+     *   mouse.moveSmoothly(500, 300);
+     * }, { priority: 8, timeoutMs: 5000 });
+     * ```
+     */
+    submit<T>(name: string, execute: () => T | Promise<T>, options?: TaskOptions): Promise<T>;
+    /**
+     * Submit multiple tasks at once. Returns array of promises.
+     */
+    submitBatch<T>(tasks: {
+        name: string;
+        execute: () => T | Promise<T>;
+        options?: TaskOptions;
+    }[]): Promise<T>[];
+    /**
+     * Submit a task and wait for it to complete, returning the task metadata.
+     */
+    submitAndWait<T>(name: string, execute: () => T | Promise<T>, options?: TaskOptions): Promise<{
+        result: T;
+        durationMs: number;
+        taskId: string;
+    }>;
+    /** Pause task processing (running tasks continue, no new ones start) */
+    pause(): void;
+    /** Resume task processing */
+    resume(): void;
+    /** Stop the executor. Optionally cancel all pending tasks. */
+    stop(cancelPending?: boolean): void;
+    /** Start the executor (if previously stopped) */
+    start(): void;
+    /** Cancel a specific task by ID */
+    cancel(taskId: string): boolean;
+    /** Cancel all tasks matching a predicate */
+    cancelWhere(predicate: (task: Task) => boolean): number;
+    /** Cancel all tasks in a group */
+    cancelGroup(group: string): number;
+    /** Cancel all tasks with a specific tag */
+    cancelByTag(tag: string): number;
+    /** Drain the queue — wait for all pending + running tasks to complete */
+    drain(): Promise<void>;
+    /** Clear the queue (cancel all pending, let running finish) */
+    clear(): number;
+    /** Get executor statistics */
+    getStats(): ExecutorStats;
+    /** Get all queued tasks */
+    getQueuedTasks(): Task[];
+    /** Get all currently running tasks */
+    getRunningTasks(): Task[];
+    /** Get a completed task by ID */
+    getCompletedTask(taskId: string): Task | undefined;
+    /** Check if a task exists (queued, running, or completed) */
+    hasTask(taskId: string): boolean;
+    private _processQueue;
+    private _executeTask;
+    private _emitTaskEvent;
+}
+/**
+ * Get (or create) the default executor singleton.
+ */
+export declare function getDefaultExecutor(options?: ExecutorOptions): Executor;
+/**
+ * Create a new executor with custom options.
+ */
+export declare function createExecutor(options?: ExecutorOptions): Executor;
+/**
+ * Convenience: submit a task to the default executor.
+ */
+export declare function enqueue<T>(name: string, execute: () => T | Promise<T>, options?: TaskOptions): Promise<T>;
+/**
+ * Convenience: submit a high-priority task.
+ */
+export declare function urgent<T>(name: string, execute: () => T | Promise<T>, options?: Omit<TaskOptions, 'priority'>): Promise<T>;
+/**
+ * Convenience: submit a background (low-priority) task.
+ */
+export declare function background<T>(name: string, execute: () => T | Promise<T>, options?: Omit<TaskOptions, 'priority'>): Promise<T>;
+//# sourceMappingURL=executor.d.ts.map

package/dist/executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../ts/executor.ts"],"names":[],"mappings":"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"}