@semiont/jobs 0.5.2 → 0.5.4

package/dist/fs-job-queue.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Job Queue Manager
+ *
+ * Filesystem-based job queue with atomic operations.
+ * Jobs are stored in directories by status for easy polling.
+ */
+import type { AnyJob, JobStatus, JobQueryFilters } from './types';
+import type { SemiontProject } from '@semiont/core/node';
+import type { JobId, Logger, EventBus } from '@semiont/core';
+import type { JobQueue } from './job-queue-interface';
+export declare class FsJobQueue implements JobQueue {
+    private eventBus?;
+    private jobsDir;
+    private logger;
+    private pendingQueue;
+    private watcher;
+    private loadDebounceTimer;
+    constructor(project: SemiontProject, logger: Logger, eventBus?: EventBus | undefined);
+    /**
+     * Initialize job queue directories, load pending jobs, and start fs.watch
+     */
+    initialize(): Promise<void>;
+    /**
+     * Clean up watcher
+     */
+    destroy(): void;
+    /**
+     * Load pending jobs from disk into in-memory queue
+     */
+    private loadPendingJobs;
+    /**
+     * Debounced version of loadPendingJobs — fs.watch can fire rapidly
+     */
+    private debouncedLoadPendingJobs;
+    /**
+     * Create a new job
+     */
+    createJob(job: AnyJob): Promise<void>;
+    /**
+     * Get a job by ID (searches all status directories)
+     */
+    getJob(jobId: JobId): Promise<AnyJob | null>;
+    /**
+     * Update a job (atomic: delete old, write new)
+     */
+    updateJob(job: AnyJob, oldStatus?: JobStatus): Promise<void>;
+    /**
+     * Poll for next pending job (FIFO) from in-memory queue.
+     * If a predicate is provided, returns the first matching job (skipping non-matching ones).
+     */
+    pollNextPendingJob(predicate?: (job: AnyJob) => boolean): Promise<AnyJob | null>;
+    /**
+     * List jobs with filters
+     */
+    listJobs(filters?: JobQueryFilters): Promise<AnyJob[]>;
+    /**
+     * Cancel a job
+     */
+    cancelJob(jobId: JobId): Promise<boolean>;
+    /**
+     * Clean up old completed/failed jobs (older than retention period)
+     */
+    cleanupOldJobs(retentionHours?: number): Promise<number>;
+    /**
+     * Get job file path
+     */
+    private getJobPath;
+    /**
+     * Get statistics about the queue
+     */
+    getStats(): Promise<{
+        pending: number;
+        running: number;
+        complete: number;
+        failed: number;
+        cancelled: number;
+    }>;
+}
+//# sourceMappingURL=fs-job-queue.d.ts.map

package/dist/fs-job-queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-job-queue.d.ts","sourceRoot":"","sources":["../src/fs-job-queue.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,eAAe,EAAgB,MAAM,SAAS,CAAC;AAChF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC7D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEtD,qBAAa,UAAW,YAAW,QAAQ;IAWvC,OAAO,CAAC,QAAQ,CAAC;IAVnB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAS;IAEvB,OAAO,CAAC,YAAY,CAAgB;IACpC,OAAO,CAAC,OAAO,CAA0B;IACzC,OAAO,CAAC,iBAAiB,CAA8C;gBAGrE,OAAO,EAAE,cAAc,EACvB,MAAM,EAAE,MAAM,EACN,QAAQ,CAAC,EAAE,QAAQ,YAAA;IAM7B;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IA0BjC;;OAEG;IACH,OAAO,IAAI,IAAI;IAWf;;OAEG;YACW,eAAe;IAsB7B;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAQhC;;OAEG;IACG,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAqB3C;;OAEG;IACG,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAiBlD;;OAEG;IACG,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAkClE;;;OAGG;IACG,kBAAkB,CAAC,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAUtF;;OAEG;IACG,QAAQ,CAAC,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAyChE;;OAEG;IACG,SAAS,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC;IA2B/C;;OAEG;IACG,cAAc,CAAC,cAAc,GAAE,MAAW,GAAG,OAAO,CAAC,MAAM,CAAC;IAsClE;;OAEG;IACH,OAAO,CAAC,UAAU;IAIlB;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC;QACxB,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CAyBH"}