@ninebix/nmt-system 1.0.0

package/dist/extensions/distributed/queue.js

@@ -0,0 +1,326 @@
+/**
+ * Job Queue - Bull-based distributed job queue
+ * @module extensions/distributed/queue
+ */
+import { generateUUID } from '../../utils/uuid.js';
+import { EventEmitter } from 'events';
+/**
+ * In-memory job queue (can be replaced with Bull for production)
+ * This implementation provides the same interface as Bull
+ */
+export class JobQueue extends EventEmitter {
+    name;
+    jobs;
+    waitingQueue;
+    activeJobs;
+    completedJobs;
+    failedJobs;
+    delayedJobs;
+    paused;
+    concurrency;
+    defaultOptions;
+    processors;
+    processingPromises;
+    constructor(name, options = {}) {
+        super();
+        this.name = name;
+        this.jobs = new Map();
+        this.waitingQueue = [];
+        this.activeJobs = new Set();
+        this.completedJobs = new Set();
+        this.failedJobs = new Set();
+        this.delayedJobs = new Map();
+        this.paused = false;
+        this.concurrency = options.concurrency ?? 4;
+        this.processors = new Map();
+        this.processingPromises = new Map();
+        this.defaultOptions = {
+            priority: options.defaultJobOptions?.priority ?? 0,
+            maxAttempts: options.defaultJobOptions?.maxAttempts ?? 3,
+            delay: 0,
+            timeout: 30000
+        };
+        // Note: For production, replace with Bull/BullMQ
+        // new Bull(name, { redis: options.redis })
+    }
+    /**
+     * Add a job to the queue
+     */
+    async add(type, data, options = {}) {
+        const job = {
+            id: generateUUID(),
+            type,
+            data,
+            status: 'PENDING',
+            priority: options.priority ?? this.defaultOptions.priority,
+            attempts: 0,
+            maxAttempts: options.maxAttempts ?? this.defaultOptions.maxAttempts,
+            progress: 0,
+            createdAt: new Date().toISOString()
+        };
+        this.jobs.set(job.id, job);
+        if (options.delay && options.delay > 0) {
+            // Delayed job
+            const timeout = setTimeout(() => {
+                this.delayedJobs.delete(job.id);
+                this.enqueue(job.id);
+            }, options.delay);
+            this.delayedJobs.set(job.id, timeout);
+        }
+        else {
+            this.enqueue(job.id);
+        }
+        this.emit('added', job);
+        return job;
+    }
+    /**
+     * Add multiple jobs
+     */
+    async addBulk(jobs) {
+        const results = [];
+        for (const { type, data, options } of jobs) {
+            const job = await this.add(type, data, options);
+            results.push(job);
+        }
+        return results;
+    }
+    /**
+     * Process jobs of a specific type
+     */
+    process(type, handler) {
+        this.processors.set(type, handler);
+        this.tryProcess();
+    }
+    /**
+     * Process all job types with a single handler
+     */
+    processAll(handler) {
+        const types = [
+            'INGEST_TEXT', 'INGEST_BATCH', 'GENERATE_EMBEDDINGS',
+            'BUILD_INDEX', 'CLUSTER', 'ANALYZE_GRAPH',
+            'VERIFY_INTEGRITY', 'EXPORT_DATA', 'IMPORT_DATA', 'CUSTOM'
+        ];
+        for (const type of types) {
+            this.processors.set(type, handler);
+        }
+        this.tryProcess();
+    }
+    /**
+     * Get job by ID
+     */
+    async getJob(id) {
+        return this.jobs.get(id);
+    }
+    /**
+     * Get jobs by status
+     */
+    async getJobs(status) {
+        return Array.from(this.jobs.values())
+            .filter(job => status.includes(job.status));
+    }
+    /**
+     * Get queue statistics
+     */
+    async getStats() {
+        return {
+            waiting: this.waitingQueue.length,
+            active: this.activeJobs.size,
+            completed: this.completedJobs.size,
+            failed: this.failedJobs.size,
+            delayed: this.delayedJobs.size,
+            paused: this.paused
+        };
+    }
+    /**
+     * Pause the queue
+     */
+    async pause() {
+        this.paused = true;
+        this.emit('paused');
+    }
+    /**
+     * Resume the queue
+     */
+    async resume() {
+        this.paused = false;
+        this.emit('resumed');
+        this.tryProcess();
+    }
+    /**
+     * Retry a failed job
+     */
+    async retry(jobId) {
+        const job = this.jobs.get(jobId);
+        if (!job || job.status !== 'FAILED')
+            return undefined;
+        job.status = 'PENDING';
+        job.attempts = 0;
+        job.error = undefined;
+        this.failedJobs.delete(jobId);
+        this.enqueue(jobId);
+        return job;
+    }
+    /**
+     * Remove a job
+     */
+    async remove(jobId) {
+        const job = this.jobs.get(jobId);
+        if (!job)
+            return false;
+        // Remove from all tracking sets
+        this.waitingQueue = this.waitingQueue.filter(id => id !== jobId);
+        this.activeJobs.delete(jobId);
+        this.completedJobs.delete(jobId);
+        this.failedJobs.delete(jobId);
+        const delayed = this.delayedJobs.get(jobId);
+        if (delayed) {
+            clearTimeout(delayed);
+            this.delayedJobs.delete(jobId);
+        }
+        this.jobs.delete(jobId);
+        return true;
+    }
+    /**
+     * Clean completed/failed jobs
+     */
+    async clean(olderThanMs, status) {
+        const cutoff = Date.now() - olderThanMs;
+        let cleaned = 0;
+        for (const job of this.jobs.values()) {
+            const completedAt = job.completedAt ? new Date(job.completedAt).getTime() : 0;
+            const shouldClean = (status === 'all' || status === 'completed') && job.status === 'COMPLETED' ||
+                (status === 'all' || status === 'failed') && job.status === 'FAILED';
+            if (shouldClean && completedAt < cutoff) {
+                await this.remove(job.id);
+                cleaned++;
+            }
+        }
+        return cleaned;
+    }
+    /**
+     * Drain the queue (remove all waiting jobs)
+     */
+    async drain() {
+        for (const jobId of this.waitingQueue) {
+            await this.remove(jobId);
+        }
+        this.waitingQueue = [];
+    }
+    /**
+     * Close the queue
+     */
+    async close() {
+        await this.pause();
+        // Clear delayed timeouts
+        for (const timeout of this.delayedJobs.values()) {
+            clearTimeout(timeout);
+        }
+        this.delayedJobs.clear();
+        // Wait for active jobs
+        await Promise.all(this.processingPromises.values());
+        this.emit('closed');
+    }
+    /**
+     * Update job progress
+     */
+    updateProgress(jobId, progress) {
+        const job = this.jobs.get(jobId);
+        if (job) {
+            job.progress = Math.min(100, Math.max(0, progress));
+            this.emit('progress', job, progress);
+        }
+    }
+    // ==================== Private Methods ====================
+    enqueue(jobId) {
+        const job = this.jobs.get(jobId);
+        if (!job)
+            return;
+        // Insert by priority (higher priority first)
+        let inserted = false;
+        for (let i = 0; i < this.waitingQueue.length; i++) {
+            const otherJob = this.jobs.get(this.waitingQueue[i]);
+            if (otherJob && job.priority > otherJob.priority) {
+                this.waitingQueue.splice(i, 0, jobId);
+                inserted = true;
+                break;
+            }
+        }
+        if (!inserted) {
+            this.waitingQueue.push(jobId);
+        }
+        this.tryProcess();
+    }
+    tryProcess() {
+        if (this.paused)
+            return;
+        while (this.activeJobs.size < this.concurrency &&
+            this.waitingQueue.length > 0) {
+            const jobId = this.waitingQueue.shift();
+            if (!jobId)
+                break;
+            const job = this.jobs.get(jobId);
+            if (!job)
+                continue;
+            const processor = this.processors.get(job.type);
+            if (!processor) {
+                // No processor registered, put back in queue
+                this.waitingQueue.unshift(jobId);
+                break;
+            }
+            this.processJob(job, processor);
+        }
+    }
+    async processJob(job, processor) {
+        job.status = 'RUNNING';
+        job.startedAt = new Date().toISOString();
+        job.attempts++;
+        this.activeJobs.add(job.id);
+        this.emit('active', job);
+        const promise = (async () => {
+            try {
+                const result = await processor(job);
+                job.status = 'COMPLETED';
+                job.result = result;
+                job.progress = 100;
+                job.completedAt = new Date().toISOString();
+                this.activeJobs.delete(job.id);
+                this.completedJobs.add(job.id);
+                this.emit('completed', job, result);
+            }
+            catch (error) {
+                const errorMessage = error instanceof Error ? error.message : String(error);
+                if (job.attempts < job.maxAttempts) {
+                    // Retry
+                    job.status = 'PENDING';
+                    job.error = errorMessage;
+                    this.activeJobs.delete(job.id);
+                    // Exponential backoff
+                    const delay = Math.pow(2, job.attempts) * 1000;
+                    setTimeout(() => this.enqueue(job.id), delay);
+                    this.emit('retrying', job, errorMessage);
+                }
+                else {
+                    // Failed
+                    job.status = 'FAILED';
+                    job.error = errorMessage;
+                    job.completedAt = new Date().toISOString();
+                    this.activeJobs.delete(job.id);
+                    this.failedJobs.add(job.id);
+                    this.emit('failed', job, errorMessage);
+                }
+            }
+            finally {
+                this.processingPromises.delete(job.id);
+                this.tryProcess();
+            }
+        })();
+        this.processingPromises.set(job.id, promise);
+    }
+}
+/**
+ * Create a job queue
+ */
+export function createJobQueue(name, options) {
+    return new JobQueue(name, options);
+}
+//# sourceMappingURL=queue.js.map

package/dist/extensions/distributed/queue.js.map

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

package/dist/extensions/distributed/scheduler.d.ts

@@ -0,0 +1,107 @@
+/**
+ * Scheduler - Cron-based job scheduling
+ * @module extensions/distributed/scheduler
+ */
+import { EventEmitter } from 'events';
+import type { UUID } from '../../types/index.js';
+import type { JobType, JobQueue, JobOptions } from './queue.js';
+/**
+ * Scheduled job definition
+ */
+export interface ScheduledJob<T = unknown> {
+    id: UUID;
+    name: string;
+    type: JobType;
+    data: T;
+    schedule: string;
+    options?: JobOptions;
+    enabled: boolean;
+    lastRun?: string;
+    nextRun?: string;
+    runCount: number;
+    createdAt: string;
+}
+/**
+ * Scheduler Service
+ */
+export declare class Scheduler extends EventEmitter {
+    private queue;
+    private scheduledJobs;
+    private timers;
+    private running;
+    private checkInterval;
+    private checkTimer?;
+    constructor(queue: JobQueue, checkInterval?: number);
+    /**
+     * Start the scheduler
+     */
+    start(): void;
+    /**
+     * Stop the scheduler
+     */
+    stop(): void;
+    /**
+     * Add a scheduled job
+     */
+    addScheduledJob<T>(name: string, type: JobType, data: T, schedule: string, options?: JobOptions): ScheduledJob<T>;
+    /**
+     * Remove a scheduled job
+     */
+    removeScheduledJob(id: UUID): boolean;
+    /**
+     * Enable a scheduled job
+     */
+    enableJob(id: UUID): boolean;
+    /**
+     * Disable a scheduled job
+     */
+    disableJob(id: UUID): boolean;
+    /**
+     * Update a scheduled job
+     */
+    updateScheduledJob<T>(id: UUID, updates: Partial<Pick<ScheduledJob<T>, 'name' | 'data' | 'schedule' | 'options'>>): ScheduledJob<T> | undefined;
+    /**
+     * Get scheduled job by ID
+     */
+    getScheduledJob(id: UUID): ScheduledJob | undefined;
+    /**
+     * Get all scheduled jobs
+     */
+    getAllScheduledJobs(): ScheduledJob[];
+    /**
+     * Run a scheduled job immediately
+     */
+    runNow(id: UUID): Promise<void>;
+    /**
+     * Get next runs for all jobs
+     */
+    getUpcomingRuns(count?: number): Array<{
+        job: ScheduledJob;
+        runAt: string;
+    }>;
+    private scheduleNextCheck;
+    private checkScheduledJobs;
+    private executeJob;
+    private calculateNextRun;
+    private parseSchedule;
+    private parseCronField;
+}
+/**
+ * Create a scheduler
+ */
+export declare function createScheduler(queue: JobQueue, checkInterval?: number): Scheduler;
+export declare const SchedulePresets: {
+    readonly EVERY_MINUTE: "* * * * *";
+    readonly EVERY_5_MINUTES: "*/5 * * * *";
+    readonly EVERY_15_MINUTES: "*/15 * * * *";
+    readonly EVERY_30_MINUTES: "*/30 * * * *";
+    readonly EVERY_HOUR: "0 * * * *";
+    readonly EVERY_6_HOURS: "0 */6 * * *";
+    readonly EVERY_12_HOURS: "0 */12 * * *";
+    readonly DAILY_MIDNIGHT: "0 0 * * *";
+    readonly DAILY_NOON: "0 12 * * *";
+    readonly WEEKLY_SUNDAY: "0 0 * * 0";
+    readonly WEEKLY_MONDAY: "0 0 * * 1";
+    readonly MONTHLY_FIRST: "0 0 1 * *";
+};
+//# sourceMappingURL=scheduler.d.ts.map

package/dist/extensions/distributed/scheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.d.ts","sourceRoot":"","sources":["../../../src/extensions/distributed/scheduler.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAEjD,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEhE;;GAEG;AACH,MAAM,WAAW,YAAY,CAAC,CAAC,GAAG,OAAO;IACvC,EAAE,EAAE,IAAI,CAAC;IACT,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,CAAC,CAAC;IACR,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,UAAU,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAaD;;GAEG;AACH,qBAAa,SAAU,SAAQ,YAAY;IACzC,OAAO,CAAC,KAAK,CAAW;IACxB,OAAO,CAAC,aAAa,CAA0B;IAC/C,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,UAAU,CAAC,CAAiB;gBAExB,KAAK,EAAE,QAAQ,EAAE,aAAa,GAAE,MAAc;IAS1D;;OAEG;IACH,KAAK,IAAI,IAAI;IAQb;;OAEG;IACH,IAAI,IAAI,IAAI;IAgBZ;;OAEG;IACH,eAAe,CAAC,CAAC,EACf,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,OAAO,EACb,IAAI,EAAE,CAAC,EACP,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,UAAU,GACnB,YAAY,CAAC,CAAC,CAAC;IAoBlB;;OAEG;IACH,kBAAkB,CAAC,EAAE,EAAE,IAAI,GAAG,OAAO;IAgBrC;;OAEG;IACH,SAAS,CAAC,EAAE,EAAE,IAAI,GAAG,OAAO;IAW5B;;OAEG;IACH,UAAU,CAAC,EAAE,EAAE,IAAI,GAAG,OAAO;IAgB7B;;OAEG;IACH,kBAAkB,CAAC,CAAC,EAClB,EAAE,EAAE,IAAI,EACR,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,UAAU,GAAG,SAAS,CAAC,CAAC,GAChF,YAAY,CAAC,CAAC,CAAC,GAAG,SAAS;IAiB9B;;OAEG;IACH,eAAe,CAAC,EAAE,EAAE,IAAI,GAAG,YAAY,GAAG,SAAS;IAInD;;OAEG;IACH,mBAAmB,IAAI,YAAY,EAAE;IAIrC;;OAEG;IACG,MAAM,CAAC,EAAE,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IASrC;;OAEG;IACH,eAAe,CAAC,KAAK,GAAE,MAAW,GAAG,KAAK,CAAC;QAAE,GAAG,EAAE,YAAY,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAiBhF,OAAO,CAAC,iBAAiB;YASX,kBAAkB;YAiBlB,UAAU;IAgBxB,OAAO,CAAC,gBAAgB;IAkCxB,OAAO,CAAC,aAAa;IAgBrB,OAAO,CAAC,cAAc;CAqCvB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,QAAQ,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAElF;AAGD,eAAO,MAAM,eAAe;;;;;;;;;;;;;CAalB,CAAC"}