@boringnode/queue 0.0.1-alpha.3 → 0.1.0

package/build/chunk-Y6KR3UIR.js

@@ -1,99 +0,0 @@
-// src/exceptions.ts
-import { createError } from "@poppinss/utils";
-var E_INVALID_DURATION_EXPRESSION = createError(
-  'Invalid duration expression: "%s"',
-  "E_INVALID_DURATION_EXPRESSION",
-  500
-);
-var E_INVALID_BASE_DELAY = createError(
-  "Invalid base delay. Reason: %s",
-  "E_INVALID_BASE_DELAY",
-  500
-);
-var E_INVALID_MAX_DELAY = createError(
-  "Invalid max delay. Reason: %s",
-  "E_INVALID_MAX_DELAY",
-  500
-);
-var E_INVALID_MULTIPLIER = createError(
-  "Invalid multiplier. Reason: %s",
-  "E_INVALID_MULTIPLIER",
-  500
-);
-var E_CONFIGURATION_ERROR = createError(
-  "Configuration error. Reason: %s",
-  "E_CONFIGURATION_ERROR",
-  500
-);
-var E_JOB_NOT_FOUND = createError(
-  'Requested job "%s" is not registered',
-  "E_JOB_NOT_FOUND"
-);
-var E_JOB_MAX_ATTEMPTS_REACHED = createError(
-  'The job "%s" has reached the maximum number of retry attempts',
-  "E_JOB_MAX_ATTEMPTS_REACHED"
-);
-var E_JOB_TIMEOUT = createError(
-  'The job "%s" has exceeded the timeout of %dms',
-  "E_JOB_TIMEOUT"
-);
-
-// src/debug.ts
-import { debuglog } from "util";
-var debug_default = debuglog("boringnode:queue");
-
-// src/locator.ts
-import { glob } from "fs/promises";
-import { resolve } from "path";
-var LocatorSingleton = class {
-  #registry = /* @__PURE__ */ new Map();
-  register(name, JobClass) {
-    debug_default("registering job: %s", name);
-    this.#registry.set(name, JobClass);
-  }
-  async registerFromGlob(patterns) {
-    for (const pattern of patterns) {
-      debug_default("registering jobs from glob pattern: %s", pattern);
-      for await (const file of glob(pattern)) {
-        debug_default("found job file: %s", file);
-        try {
-          const absolutePath = resolve(file);
-          const module = await import(`file://${absolutePath}`);
-          const JobClass = module.default;
-          if (JobClass && typeof JobClass === "function" && JobClass.name) {
-            this.register(JobClass.name, JobClass);
-          }
-        } catch (error) {
-          console.warn(`Failed to load job from ${file}:`, error);
-        }
-      }
-    }
-  }
-  get(name) {
-    return this.#registry.get(name);
-  }
-  getOrThrow(name) {
-    const JobClass = this.get(name);
-    if (!JobClass) {
-      throw new E_JOB_NOT_FOUND([name]);
-    }
-    return JobClass;
-  }
-  clear() {
-    this.#registry.clear();
-  }
-};
-var Locator = new LocatorSingleton();
-
-export {
-  debug_default,
-  E_INVALID_DURATION_EXPRESSION,
-  E_INVALID_BASE_DELAY,
-  E_INVALID_MAX_DELAY,
-  E_INVALID_MULTIPLIER,
-  E_CONFIGURATION_ERROR,
-  E_JOB_MAX_ATTEMPTS_REACHED,
-  E_JOB_TIMEOUT,
-  Locator
-};
-//# sourceMappingURL=chunk-Y6KR3UIR.js.map

package/build/chunk-Y6KR3UIR.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/exceptions.ts","../src/debug.ts","../src/locator.ts"],"sourcesContent":["import { createError } from '@poppinss/utils'\n\nexport const E_INVALID_DURATION_EXPRESSION = createError(\n  'Invalid duration expression: \"%s\"',\n  'E_INVALID_DURATION_EXPRESSION',\n  500\n)\n\nexport const E_INVALID_BASE_DELAY = createError<[reason: string]>(\n  'Invalid base delay. Reason: %s',\n  'E_INVALID_BASE_DELAY',\n  500\n)\n\nexport const E_INVALID_MAX_DELAY = createError<[reason: string]>(\n  'Invalid max delay. Reason: %s',\n  'E_INVALID_MAX_DELAY',\n  500\n)\n\nexport const E_INVALID_MULTIPLIER = createError<[reason: string]>(\n  'Invalid multiplier. Reason: %s',\n  'E_INVALID_MULTIPLIER',\n  500\n)\n\nexport const E_CONFIGURATION_ERROR = createError<[reason: string]>(\n  'Configuration error. Reason: %s',\n  'E_CONFIGURATION_ERROR',\n  500\n)\n\nexport const E_JOB_NOT_FOUND = createError<[jobName: string]>(\n  'Requested job \"%s\" is not registered',\n  'E_JOB_NOT_FOUND'\n)\n\nexport const E_JOB_MAX_ATTEMPTS_REACHED = createError<[jobName: string]>(\n  'The job \"%s\" has reached the maximum number of retry attempts',\n  'E_JOB_MAX_ATTEMPTS_REACHED'\n)\n\nexport const E_JOB_TIMEOUT = createError<[jobName: string, timeout: number]>(\n  'The job \"%s\" has exceeded the timeout of %dms',\n  'E_JOB_TIMEOUT'\n)\n","import { debuglog } from 'node:util'\n\nexport default debuglog('boringnode:queue')\n","import { Job } from './job.js'\nimport * as errors from './exceptions.js'\nimport type { JobClass } from './types/main.js'\nimport debug from './debug.js'\nimport { glob } from 'node:fs/promises'\nimport { resolve } from 'node:path'\n\nclass LocatorSingleton {\n  #registry = new Map<string, JobClass>()\n\n  register<T extends Job>(name: string, JobClass: JobClass<T>) {\n    debug('registering job: %s', name)\n\n    this.#registry.set(name, JobClass)\n  }\n\n  async registerFromGlob(patterns: string[]) {\n    for (const pattern of patterns) {\n      debug('registering jobs from glob pattern: %s', pattern)\n      for await (const file of glob(pattern)) {\n        debug('found job file: %s', file)\n\n        try {\n          const absolutePath = resolve(file)\n          const module = await import(`file://${absolutePath}`)\n          const JobClass = module.default as JobClass\n\n          if (JobClass && typeof JobClass === 'function' && JobClass.name) {\n            this.register(JobClass.name, JobClass)\n          }\n        } catch (error) {\n          console.warn(`Failed to load job from ${file}:`, error)\n        }\n      }\n    }\n  }\n\n  get<T extends Job = Job>(name: string): JobClass<T> | undefined {\n    return this.#registry.get(name) as JobClass<T> | undefined\n  }\n\n  getOrThrow<T extends Job = Job>(name: string): JobClass<T> {\n    const JobClass = this.get<T>(name)\n\n    if (!JobClass) {\n      throw new errors.E_JOB_NOT_FOUND([name])\n    }\n\n    return JobClass\n  }\n\n  clear(): void {\n    this.#registry.clear()\n  }\n}\n\nexport const Locator = new LocatorSingleton()\n"],"mappings":";AAAA,SAAS,mBAAmB;AAErB,IAAM,gCAAgC;AAAA,EAC3C;AAAA,EACA;AAAA,EACA;AACF;AAEO,IAAM,uBAAuB;AAAA,EAClC;AAAA,EACA;AAAA,EACA;AACF;AAEO,IAAM,sBAAsB;AAAA,EACjC;AAAA,EACA;AAAA,EACA;AACF;AAEO,IAAM,uBAAuB;AAAA,EAClC;AAAA,EACA;AAAA,EACA;AACF;AAEO,IAAM,wBAAwB;AAAA,EACnC;AAAA,EACA;AAAA,EACA;AACF;AAEO,IAAM,kBAAkB;AAAA,EAC7B;AAAA,EACA;AACF;AAEO,IAAM,6BAA6B;AAAA,EACxC;AAAA,EACA;AACF;AAEO,IAAM,gBAAgB;AAAA,EAC3B;AAAA,EACA;AACF;;;AC7CA,SAAS,gBAAgB;AAEzB,IAAO,gBAAQ,SAAS,kBAAkB;;;ACE1C,SAAS,YAAY;AACrB,SAAS,eAAe;AAExB,IAAM,mBAAN,MAAuB;AAAA,EACrB,YAAY,oBAAI,IAAsB;AAAA,EAEtC,SAAwB,MAAc,UAAuB;AAC3D,kBAAM,uBAAuB,IAAI;AAEjC,SAAK,UAAU,IAAI,MAAM,QAAQ;AAAA,EACnC;AAAA,EAEA,MAAM,iBAAiB,UAAoB;AACzC,eAAW,WAAW,UAAU;AAC9B,oBAAM,0CAA0C,OAAO;AACvD,uBAAiB,QAAQ,KAAK,OAAO,GAAG;AACtC,sBAAM,sBAAsB,IAAI;AAEhC,YAAI;AACF,gBAAM,eAAe,QAAQ,IAAI;AACjC,gBAAM,SAAS,MAAM,OAAO,UAAU,YAAY;AAClD,gBAAM,WAAW,OAAO;AAExB,cAAI,YAAY,OAAO,aAAa,cAAc,SAAS,MAAM;AAC/D,iBAAK,SAAS,SAAS,MAAM,QAAQ;AAAA,UACvC;AAAA,QACF,SAAS,OAAO;AACd,kBAAQ,KAAK,2BAA2B,IAAI,KAAK,KAAK;AAAA,QACxD;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAAA,EAEA,IAAyB,MAAuC;AAC9D,WAAO,KAAK,UAAU,IAAI,IAAI;AAAA,EAChC;AAAA,EAEA,WAAgC,MAA2B;AACzD,UAAM,WAAW,KAAK,IAAO,IAAI;AAEjC,QAAI,CAAC,UAAU;AACb,YAAM,IAAW,gBAAgB,CAAC,IAAI,CAAC;AAAA,IACzC;AAEA,WAAO;AAAA,EACT;AAAA,EAEA,QAAc;AACZ,SAAK,UAAU,MAAM;AAAA,EACvB;AACF;AAEO,IAAM,UAAU,IAAI,iBAAiB;","names":[]}

package/build/job-Bd_c2lFK.d.ts

@@ -1,149 +0,0 @@
-declare class BackoffStrategy$1 {
-    #private;
-    constructor(config: BackoffConfig);
-    calculateDelay(attempt: number): number;
-    getNextRetryAt(attempt: number): Date;
-    getConfig(): Readonly<BackoffConfig>;
-}
-declare function exponentialBackoff(config?: Partial<Omit<BackoffConfig, 'strategy'>>): () => BackoffStrategy$1;
-declare function linearBackoff(config?: Partial<Omit<BackoffConfig, 'strategy'>>): () => BackoffStrategy$1;
-declare function fixedBackoff(delay?: Duration): () => BackoffStrategy$1;
-declare function customBackoff(config: BackoffConfig): () => BackoffStrategy$1;
-
-type Duration = number | string;
-interface JobData {
-    id: string;
-    name: string;
-    payload: any;
-    attempts: number;
-    priority?: number;
-    nextRetryAt?: Date;
-}
-interface JobOptions {
-    queue?: string;
-    adapter?: string | (() => Adapter);
-    maxRetries?: number;
-    priority?: number;
-    retry?: RetryConfig;
-    timeout?: Duration;
-    failOnTimeout?: boolean;
-}
-type JobClass<T extends Job = Job> = (new (payload: any) => T) & {
-    options?: JobOptions;
-};
-interface RetryConfig {
-    maxRetries?: number;
-    backoff?: () => BackoffStrategy$1;
-}
-type BackoffStrategy = 'exponential' | 'linear' | 'fixed';
-interface BackoffConfig {
-    strategy: BackoffStrategy;
-    baseDelay: Duration;
-    maxDelay?: Duration;
-    multiplier?: number;
-    jitter?: boolean;
-}
-interface QueueConfig {
-    adapter?: string;
-    retry?: any;
-}
-interface WorkerConfig {
-    concurrency?: number;
-    pollingInterval?: Duration;
-    leaseTimeout?: Duration;
-    renewalInterval?: Duration;
-    timeout?: Duration;
-}
-type WorkerCycle = {
-    type: 'started';
-    queue: string;
-    job: any;
-} | {
-    type: 'completed';
-    queue: string;
-    job: any;
-} | {
-    type: 'idle';
-    suggestedDelay: Duration;
-} | {
-    type: 'error';
-    error: Error;
-    suggestedDelay: Duration;
-};
-type AdapterFactory<T extends Adapter = Adapter> = () => T;
-interface QueueManagerConfig {
-    default: string;
-    adapters: Record<string, AdapterFactory>;
-    retry?: RetryConfig;
-    queues?: Record<string, QueueConfig>;
-    worker?: WorkerConfig;
-    locations: string[];
-}
-
-interface AcquiredJob extends JobData {
-    acquiredAt: number;
-}
-interface Adapter {
-    /**
-     * Set the worker ID for this adapter instance.
-     * Required before calling pop methods when consuming jobs.
-     */
-    setWorkerId(workerId: string): void;
-    /**
-     * Pop the next available job from the default queue.
-     * The driver handles locking internally.
-     */
-    pop(): Promise<AcquiredJob | null>;
-    /**
-     * Pop the next available job from a specific queue.
-     * The driver handles locking internally.
-     */
-    popFrom(queue: string): Promise<AcquiredJob | null>;
-    /**
-     * Blocking pop that waits for a job to be available.
-     * Supported by Redis adapter.
-     */
-    popAndWait?(queue: string, timeout: number): Promise<AcquiredJob | null>;
-    /**
-     * Mark a job as completed and remove it from active set.
-     */
-    completeJob(jobId: string, queue: string): Promise<void>;
-    /**
-     * Mark a job as failed permanently.
-     */
-    failJob(jobId: string, queue: string, error?: Error): Promise<void>;
-    /**
-     * Retry a job - move back to pending queue with incremented attempts.
-     */
-    retryJob(jobId: string, queue: string, retryAt?: Date): Promise<void>;
-    push(jobData: JobData): Promise<void>;
-    pushOn(queue: string, jobData: JobData): Promise<void>;
-    pushLater(jobData: JobData, delay: number): Promise<void>;
-    pushLaterOn(queue: string, jobData: JobData, delay: number): Promise<void>;
-    size(): Promise<number>;
-    sizeOf(queue: string): Promise<number>;
-    destroy(): Promise<void>;
-}
-
-declare class JobDispatcher<T> {
-    #private;
-    constructor(name: string, payload: T);
-    toQueue(queue: string): this;
-    in(delay: Duration): this;
-    priority(priority: number): this;
-    with(adapter: string | (() => Adapter)): this;
-    run(): Promise<`${string}-${string}-${string}-${string}-${string}`>;
-    then(onFulfilled?: (value: string) => any, onRejected?: (reason: any) => any): Promise<any>;
-}
-
-declare abstract class Job<Payload = any> {
-    #private;
-    static options: JobOptions;
-    get payload(): Payload;
-    constructor(payload: Payload);
-    static dispatch<T extends Job>(this: new (payload: any) => T, payload: T extends Job<infer P> ? P : never): JobDispatcher<T extends Job<infer P> ? P : never>;
-    abstract execute(signal?: AbortSignal): Promise<void>;
-    failed?(error: Error): Promise<void>;
-}
-
-export { type Adapter as A, type BackoffStrategy as B, type Duration as D, Job as J, type QueueManagerConfig as Q, type RetryConfig as R, type WorkerCycle as W, type AcquiredJob as a, type JobData as b, customBackoff as c, type JobOptions as d, exponentialBackoff as e, fixedBackoff as f, type JobClass as g, type BackoffConfig as h, type QueueConfig as i, type WorkerConfig as j, type AdapterFactory as k, linearBackoff as l };