@igniter-js/jobs 0.1.1 → 0.1.12

package/dist/adapters/index.d.mts

@@ -1,5 +1,143 @@
 export { IgniterJobsBullMQAdapter } from './bullmq.adapter.mjs';
 export { IgniterJobsMemoryAdapter } from './memory.adapter.mjs';
-import '../adapter-PiDCQWQd.mjs';
+import { I as IgniterJobsAdapter, a as IgniterJobsQueueManager, c as IgniterJobDefinition, d as IgniterCronDefinition, e as IgniterJobsAdapterDispatchParams, f as IgniterJobsAdapterScheduleParams, g as IgniterJobSearchResult, h as IgniterJobStatus, i as IgniterJobsJobLog, j as IgniterJobsQueueInfo, o as IgniterJobCounts, k as IgniterJobsQueueCleanOptions, l as IgniterJobsWorkerHandle, m as IgniterJobsWorkerBuilderConfig, n as IgniterJobsEventHandler } from '../adapter-CXZxomI9.mjs';
 import 'ioredis';
-import '@igniter-js/core';
+import '@igniter-js/common';
+
+/**
+ * @fileoverview SQLite adapter for @igniter-js/jobs (local/desktop/CLI environments)
+ * @module @igniter-js/jobs/adapters/sqlite
+ *
+ * This adapter provides persistent job queue storage using SQLite, ideal for:
+ * - Desktop applications (Tauri, Electron)
+ * - CLI tools
+ * - MCP Servers
+ * - Local development
+ * - Edge/embedded environments
+ */
+
+/**
+ * Configuration options for the SQLite adapter.
+ */
+interface IgniterJobsSQLiteAdapterOptions {
+    /**
+     * Path to the SQLite database file.
+     * Use `:memory:` for an in-memory database (useful for testing).
+     * @example './data/jobs.sqlite'
+     * @example ':memory:'
+     */
+    path: string;
+    /**
+     * Interval in milliseconds for the worker polling loop.
+     * Lower values mean faster job pickup but higher CPU usage.
+     * @default 500
+     */
+    pollingInterval?: number;
+    /**
+     * Whether to enable WAL mode for better concurrent read/write performance.
+     * @default true
+     */
+    enableWAL?: boolean;
+}
+/**
+ * SQLite-based adapter for local/desktop/CLI job queue persistence.
+ *
+ * Features:
+ * - Full persistence across process restarts
+ * - Zero external dependencies (SQLite is embedded)
+ * - WAL mode for concurrent access
+ * - Automatic schema migrations
+ * - Compatible with Tauri, Electron, Node.js CLIs
+ *
+ * @example
+ * ```ts
+ * const adapter = IgniterJobsSQLiteAdapter.create({
+ *   path: './data/jobs.sqlite'
+ * });
+ *
+ * const jobs = IgniterJobs.create()
+ *   .withAdapter(adapter)
+ *   .build();
+ * ```
+ */
+declare class IgniterJobsSQLiteAdapter implements IgniterJobsAdapter {
+    readonly client: {
+        type: "sqlite";
+        path: string;
+    };
+    private db;
+    private readonly options;
+    private readonly registeredJobs;
+    private readonly registeredCrons;
+    private readonly workers;
+    private readonly subscribers;
+    private readonly pausedQueues;
+    readonly queues: IgniterJobsQueueManager;
+    private constructor();
+    /**
+     * Creates a new SQLite adapter instance.
+     *
+     * @param options - Configuration options
+     * @returns A new adapter instance
+     *
+     * @example
+     * ```ts
+     * // File-based database (persistent)
+     * const adapter = IgniterJobsSQLiteAdapter.create({
+     *   path: './data/jobs.sqlite'
+     * });
+     *
+     * // In-memory database (for testing)
+     * const testAdapter = IgniterJobsSQLiteAdapter.create({
+     *   path: ':memory:'
+     * });
+     * ```
+     */
+    static create(options: IgniterJobsSQLiteAdapterOptions): IgniterJobsAdapter;
+    private initializeSchema;
+    registerJob(queueName: string, jobName: string, definition: IgniterJobDefinition<any, any, any>): void;
+    registerCron(queueName: string, cronName: string, definition: IgniterCronDefinition<any, any>): void;
+    dispatch(params: IgniterJobsAdapterDispatchParams): Promise<string>;
+    private promoteDelayedJob;
+    schedule(params: IgniterJobsAdapterScheduleParams): Promise<string>;
+    getJob(jobId: string, queue?: string): Promise<IgniterJobSearchResult | null>;
+    getJobState(jobId: string, queue?: string): Promise<IgniterJobStatus | null>;
+    getJobLogs(jobId: string, queue?: string): Promise<IgniterJobsJobLog[]>;
+    getJobProgress(jobId: string, queue?: string): Promise<number>;
+    retryJob(jobId: string, queue?: string): Promise<void>;
+    removeJob(jobId: string, queue?: string): Promise<void>;
+    promoteJob(jobId: string, queue?: string): Promise<void>;
+    moveJobToFailed(jobId: string, reason: string, queue?: string): Promise<void>;
+    retryManyJobs(jobIds: string[], queue?: string): Promise<void>;
+    removeManyJobs(jobIds: string[], queue?: string): Promise<void>;
+    getQueueInfo(queue: string): Promise<IgniterJobsQueueInfo | null>;
+    getQueueJobCounts(queue: string): Promise<IgniterJobCounts>;
+    listQueues(): Promise<IgniterJobsQueueInfo[]>;
+    pauseQueue(queue: string): Promise<void>;
+    resumeQueue(queue: string): Promise<void>;
+    drainQueue(queue: string): Promise<number>;
+    cleanQueue(queue: string, options: IgniterJobsQueueCleanOptions): Promise<number>;
+    obliterateQueue(queue: string, _options?: {
+        force?: boolean;
+    }): Promise<void>;
+    retryAllInQueue(queue: string): Promise<number>;
+    pauseJobType(queue: string, jobName: string): Promise<void>;
+    resumeJobType(queue: string, jobName: string): Promise<void>;
+    searchJobs(filter: any): Promise<IgniterJobSearchResult[]>;
+    searchQueues(filter: any): Promise<IgniterJobsQueueInfo[]>;
+    searchWorkers(filter: any): Promise<IgniterJobsWorkerHandle[]>;
+    createWorker(config: IgniterJobsWorkerBuilderConfig): Promise<IgniterJobsWorkerHandle>;
+    getWorkers(): Map<string, IgniterJobsWorkerHandle>;
+    publishEvent(channel: string, payload: unknown): Promise<void>;
+    subscribeEvent(channel: string, handler: IgniterJobsEventHandler): Promise<() => Promise<void>>;
+    shutdown(): Promise<void>;
+    private rowToSearchResult;
+    private toWorkerHandle;
+    private toWorkerMetrics;
+    private startPollingLoop;
+    private processNextJobs;
+    private processJob;
+    private addJobLog;
+}
+
+export { IgniterJobsSQLiteAdapter, type IgniterJobsSQLiteAdapterOptions };

package/dist/adapters/index.d.ts

@@ -1,5 +1,143 @@
 export { IgniterJobsBullMQAdapter } from './bullmq.adapter.js';
 export { IgniterJobsMemoryAdapter } from './memory.adapter.js';
-import '../adapter-PiDCQWQd.js';
+import { I as IgniterJobsAdapter, a as IgniterJobsQueueManager, c as IgniterJobDefinition, d as IgniterCronDefinition, e as IgniterJobsAdapterDispatchParams, f as IgniterJobsAdapterScheduleParams, g as IgniterJobSearchResult, h as IgniterJobStatus, i as IgniterJobsJobLog, j as IgniterJobsQueueInfo, o as IgniterJobCounts, k as IgniterJobsQueueCleanOptions, l as IgniterJobsWorkerHandle, m as IgniterJobsWorkerBuilderConfig, n as IgniterJobsEventHandler } from '../adapter-CXZxomI9.js';
 import 'ioredis';
-import '@igniter-js/core';
+import '@igniter-js/common';
+
+/**
+ * @fileoverview SQLite adapter for @igniter-js/jobs (local/desktop/CLI environments)
+ * @module @igniter-js/jobs/adapters/sqlite
+ *
+ * This adapter provides persistent job queue storage using SQLite, ideal for:
+ * - Desktop applications (Tauri, Electron)
+ * - CLI tools
+ * - MCP Servers
+ * - Local development
+ * - Edge/embedded environments
+ */
+
+/**
+ * Configuration options for the SQLite adapter.
+ */
+interface IgniterJobsSQLiteAdapterOptions {
+    /**
+     * Path to the SQLite database file.
+     * Use `:memory:` for an in-memory database (useful for testing).
+     * @example './data/jobs.sqlite'
+     * @example ':memory:'
+     */
+    path: string;
+    /**
+     * Interval in milliseconds for the worker polling loop.
+     * Lower values mean faster job pickup but higher CPU usage.
+     * @default 500
+     */
+    pollingInterval?: number;
+    /**
+     * Whether to enable WAL mode for better concurrent read/write performance.
+     * @default true
+     */
+    enableWAL?: boolean;
+}
+/**
+ * SQLite-based adapter for local/desktop/CLI job queue persistence.
+ *
+ * Features:
+ * - Full persistence across process restarts
+ * - Zero external dependencies (SQLite is embedded)
+ * - WAL mode for concurrent access
+ * - Automatic schema migrations
+ * - Compatible with Tauri, Electron, Node.js CLIs
+ *
+ * @example
+ * ```ts
+ * const adapter = IgniterJobsSQLiteAdapter.create({
+ *   path: './data/jobs.sqlite'
+ * });
+ *
+ * const jobs = IgniterJobs.create()
+ *   .withAdapter(adapter)
+ *   .build();
+ * ```
+ */
+declare class IgniterJobsSQLiteAdapter implements IgniterJobsAdapter {
+    readonly client: {
+        type: "sqlite";
+        path: string;
+    };
+    private db;
+    private readonly options;
+    private readonly registeredJobs;
+    private readonly registeredCrons;
+    private readonly workers;
+    private readonly subscribers;
+    private readonly pausedQueues;
+    readonly queues: IgniterJobsQueueManager;
+    private constructor();
+    /**
+     * Creates a new SQLite adapter instance.
+     *
+     * @param options - Configuration options
+     * @returns A new adapter instance
+     *
+     * @example
+     * ```ts
+     * // File-based database (persistent)
+     * const adapter = IgniterJobsSQLiteAdapter.create({
+     *   path: './data/jobs.sqlite'
+     * });
+     *
+     * // In-memory database (for testing)
+     * const testAdapter = IgniterJobsSQLiteAdapter.create({
+     *   path: ':memory:'
+     * });
+     * ```
+     */
+    static create(options: IgniterJobsSQLiteAdapterOptions): IgniterJobsAdapter;
+    private initializeSchema;
+    registerJob(queueName: string, jobName: string, definition: IgniterJobDefinition<any, any, any>): void;
+    registerCron(queueName: string, cronName: string, definition: IgniterCronDefinition<any, any>): void;
+    dispatch(params: IgniterJobsAdapterDispatchParams): Promise<string>;
+    private promoteDelayedJob;
+    schedule(params: IgniterJobsAdapterScheduleParams): Promise<string>;
+    getJob(jobId: string, queue?: string): Promise<IgniterJobSearchResult | null>;
+    getJobState(jobId: string, queue?: string): Promise<IgniterJobStatus | null>;
+    getJobLogs(jobId: string, queue?: string): Promise<IgniterJobsJobLog[]>;
+    getJobProgress(jobId: string, queue?: string): Promise<number>;
+    retryJob(jobId: string, queue?: string): Promise<void>;
+    removeJob(jobId: string, queue?: string): Promise<void>;
+    promoteJob(jobId: string, queue?: string): Promise<void>;
+    moveJobToFailed(jobId: string, reason: string, queue?: string): Promise<void>;
+    retryManyJobs(jobIds: string[], queue?: string): Promise<void>;
+    removeManyJobs(jobIds: string[], queue?: string): Promise<void>;
+    getQueueInfo(queue: string): Promise<IgniterJobsQueueInfo | null>;
+    getQueueJobCounts(queue: string): Promise<IgniterJobCounts>;
+    listQueues(): Promise<IgniterJobsQueueInfo[]>;
+    pauseQueue(queue: string): Promise<void>;
+    resumeQueue(queue: string): Promise<void>;
+    drainQueue(queue: string): Promise<number>;
+    cleanQueue(queue: string, options: IgniterJobsQueueCleanOptions): Promise<number>;
+    obliterateQueue(queue: string, _options?: {
+        force?: boolean;
+    }): Promise<void>;
+    retryAllInQueue(queue: string): Promise<number>;
+    pauseJobType(queue: string, jobName: string): Promise<void>;
+    resumeJobType(queue: string, jobName: string): Promise<void>;
+    searchJobs(filter: any): Promise<IgniterJobSearchResult[]>;
+    searchQueues(filter: any): Promise<IgniterJobsQueueInfo[]>;
+    searchWorkers(filter: any): Promise<IgniterJobsWorkerHandle[]>;
+    createWorker(config: IgniterJobsWorkerBuilderConfig): Promise<IgniterJobsWorkerHandle>;
+    getWorkers(): Map<string, IgniterJobsWorkerHandle>;
+    publishEvent(channel: string, payload: unknown): Promise<void>;
+    subscribeEvent(channel: string, handler: IgniterJobsEventHandler): Promise<() => Promise<void>>;
+    shutdown(): Promise<void>;
+    private rowToSearchResult;
+    private toWorkerHandle;
+    private toWorkerMetrics;
+    private startPollingLoop;
+    private processNextJobs;
+    private processJob;
+    private addJobLog;
+}
+
+export { IgniterJobsSQLiteAdapter, type IgniterJobsSQLiteAdapterOptions };