sidekiq-ts 1.0.0

package/dist/config.d.ts

@@ -0,0 +1,59 @@
+import type { RedisClientOptions } from "redis";
+import { type Logger } from "./logger.js";
+import { MiddlewareChain } from "./middleware.js";
+import type { RedisClient } from "./redis.js";
+import type { ConfigOptions, DeathHandler, ErrorHandler, JobLogger, JobPayload, LeaderElectionConfig, LifecycleEvents, StrictArgsMode } from "./types.js";
+export declare class Config {
+    redis: RedisClientOptions;
+    concurrency: number;
+    queues: string[] | [string, number][];
+    timeout: number;
+    pollIntervalAverage: number | null;
+    averageScheduledPollInterval: number;
+    heartbeatInterval: number;
+    tag: string;
+    labels: string[];
+    maxRetries: number;
+    deadMaxJobs: number;
+    deadTimeoutInSeconds: number;
+    backtraceCleaner: (backtrace: string[]) => string[];
+    maxIterationRuntime: number | null;
+    skipDefaultJobLogging: boolean;
+    loggedJobAttributes: string[];
+    profiler?: (payload: JobPayload, fn: () => Promise<void>) => Promise<void>;
+    strictArgs: StrictArgsMode;
+    errorHandlers: ErrorHandler[];
+    deathHandlers: DeathHandler[];
+    lifecycleEvents: LifecycleEvents;
+    logger: Logger;
+    redisIdleTimeout: number | null;
+    jobLogger: JobLogger;
+    clientMiddleware: MiddlewareChain<[
+        string | unknown,
+        JobPayload,
+        string,
+        RedisClient
+    ], JobPayload | false | null | undefined>;
+    serverMiddleware: MiddlewareChain<[unknown, JobPayload, string], unknown>;
+    leaderElection: LeaderElectionConfig;
+    private redisClient?;
+    constructor(options?: ConfigOptions);
+    getRedisClient(): Promise<RedisClient>;
+    close(): Promise<void>;
+    queueNames(): string[];
+    /**
+     * Fire a lifecycle event, calling all registered handlers.
+     *
+     * @param event - The event name to fire
+     * @param options - Options for firing the event
+     * @param options.oneshot - If true, clear handlers after firing (default: true)
+     * @param options.reverse - If true, call handlers in reverse order
+     * @param options.reraise - If true, re-throw any errors from handlers
+     */
+    fireEvent(event: keyof LifecycleEvents, options?: {
+        oneshot?: boolean;
+        reverse?: boolean;
+        reraise?: boolean;
+    }): Promise<void>;
+}
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,OAAO,CAAC;AAIhD,OAAO,EAAgB,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EACV,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,SAAS,EACT,UAAU,EACV,oBAAoB,EACpB,eAAe,EACf,cAAc,EACf,MAAM,YAAY,CAAC;AAapB,qBAAa,MAAM;IACjB,KAAK,EAAE,kBAAkB,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,4BAA4B,EAAE,MAAM,CAAC;IACrC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,gBAAgB,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,MAAM,EAAE,CAAC;IACpD,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,qBAAqB,EAAE,OAAO,CAAC;IAC/B,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3E,UAAU,EAAE,cAAc,CAAC;IAC3B,aAAa,EAAE,YAAY,EAAE,CAAC;IAC9B,aAAa,EAAE,YAAY,EAAE,CAAC;IAC9B,eAAe,EAAE,eAAe,CAAC;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,SAAS,EAAE,SAAS,CAAC;IACrB,gBAAgB,EAAE,eAAe,CAC/B;QAAC,MAAM,GAAG,OAAO;QAAE,UAAU;QAAE,MAAM;QAAE,WAAW;KAAC,EACnD,UAAU,GAAG,KAAK,GAAG,IAAI,GAAG,SAAS,CACtC,CAAC;IACF,gBAAgB,EAAE,eAAe,CAAC,CAAC,OAAO,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC;IAC1E,cAAc,EAAE,oBAAoB,CAAC;IACrC,OAAO,CAAC,WAAW,CAAC,CAAc;gBAGtB,OAAO,GAAE,aAAkB;IAgDjC,cAAc,IAAI,OAAO,CAAC,WAAW,CAAC;IAatC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAM5B,UAAU,IAAI,MAAM,EAAE;IAatB;;;;;;;;OAQG;IACG,SAAS,CACb,KAAK,EAAE,MAAM,eAAe,EAC5B,OAAO,GAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAO,GACxE,OAAO,CAAC,IAAI,CAAC;CA+BjB"}

package/dist/config.js

@@ -0,0 +1,155 @@
+import { createClient } from "redis";
+import { Context } from "./context.js";
+import { DefaultJobLogger } from "./job-logger.js";
+import { createLogger } from "./logger.js";
+import { MiddlewareChain } from "./middleware.js";
+const DEFAULT_LIFECYCLE_EVENTS = {
+    startup: [],
+    quiet: [],
+    shutdown: [],
+    exit: [],
+    heartbeat: [],
+    beat: [],
+    leader: [],
+    follower: [],
+};
+export class Config {
+    redis;
+    concurrency;
+    queues;
+    timeout;
+    pollIntervalAverage;
+    averageScheduledPollInterval;
+    heartbeatInterval;
+    tag;
+    labels;
+    maxRetries;
+    deadMaxJobs;
+    deadTimeoutInSeconds;
+    backtraceCleaner;
+    maxIterationRuntime;
+    skipDefaultJobLogging;
+    loggedJobAttributes;
+    profiler;
+    strictArgs;
+    errorHandlers;
+    deathHandlers;
+    lifecycleEvents;
+    logger;
+    redisIdleTimeout;
+    jobLogger;
+    clientMiddleware;
+    serverMiddleware;
+    leaderElection;
+    redisClient;
+    // biome-ignore lint/complexity/noExcessiveCognitiveComplexity: config initialization requires many defaults
+    constructor(options = {}) {
+        this.redis = options.redis ?? {
+            url: process.env.REDIS_URL ?? "redis://localhost:6379/0",
+        };
+        this.concurrency = options.concurrency ?? 5;
+        this.queues = options.queues ?? ["default"];
+        this.timeout = options.timeout ?? 25;
+        this.pollIntervalAverage = options.pollIntervalAverage ?? null;
+        this.averageScheduledPollInterval =
+            options.averageScheduledPollInterval ?? 5;
+        this.heartbeatInterval = options.heartbeatInterval ?? 10;
+        this.tag = options.tag ?? "";
+        this.labels = options.labels ?? [];
+        this.maxRetries = options.maxRetries ?? 25;
+        this.deadMaxJobs = options.deadMaxJobs ?? 10_000;
+        this.deadTimeoutInSeconds =
+            options.deadTimeoutInSeconds ?? 180 * 24 * 60 * 60;
+        this.backtraceCleaner =
+            options.backtraceCleaner ?? ((backtrace) => backtrace);
+        this.maxIterationRuntime = options.maxIterationRuntime ?? null;
+        this.skipDefaultJobLogging = options.skipDefaultJobLogging ?? false;
+        this.loggedJobAttributes = options.loggedJobAttributes ?? ["tags"];
+        this.profiler = options.profiler;
+        this.strictArgs = options.strictArgs ?? "raise";
+        this.errorHandlers = options.errorHandlers ?? [];
+        this.deathHandlers = options.deathHandlers ?? [];
+        this.lifecycleEvents = {
+            ...DEFAULT_LIFECYCLE_EVENTS,
+            ...(options.lifecycleEvents ?? {}),
+        };
+        this.logger = options.logger ?? createLogger();
+        this.redisIdleTimeout = options.redisIdleTimeout ?? null;
+        this.jobLogger = options.jobLogger ?? new DefaultJobLogger(this);
+        this.clientMiddleware = new MiddlewareChain(this);
+        this.serverMiddleware = new MiddlewareChain(this);
+        this.leaderElection = options.leaderElection ?? {};
+        if (this.errorHandlers.length === 0) {
+            this.errorHandlers.push((error, context) => {
+                Context.with(context, () => {
+                    const message = error.stack ?? `${error.name}: ${error.message ?? "Unknown error"}`;
+                    this.logger.info(() => message);
+                });
+            });
+        }
+    }
+    async getRedisClient() {
+        if (this.redisClient?.isOpen) {
+            return this.redisClient;
+        }
+        const client = createClient(this.redis);
+        client.on("error", (error) => {
+            this.logger.error(() => `Redis error: ${error.message}`);
+        });
+        await client.connect();
+        this.redisClient = client;
+        return client;
+    }
+    async close() {
+        if (this.redisClient?.isOpen) {
+            await this.redisClient.quit();
+        }
+    }
+    queueNames() {
+        const names = new Set();
+        for (const entry of this.queues) {
+            if (Array.isArray(entry)) {
+                names.add(entry[0]);
+            }
+            else {
+                const [name] = entry.split(",", 1);
+                names.add(name);
+            }
+        }
+        return Array.from(names);
+    }
+    /**
+     * Fire a lifecycle event, calling all registered handlers.
+     *
+     * @param event - The event name to fire
+     * @param options - Options for firing the event
+     * @param options.oneshot - If true, clear handlers after firing (default: true)
+     * @param options.reverse - If true, call handlers in reverse order
+     * @param options.reraise - If true, re-throw any errors from handlers
+     */
+    async fireEvent(event, options = {}) {
+        const { oneshot = true, reverse = false, reraise = false } = options;
+        if (oneshot) {
+            this.logger.debug(() => `Firing ${event} event`);
+        }
+        const handlers = [...this.lifecycleEvents[event]];
+        if (reverse) {
+            handlers.reverse();
+        }
+        for (const handler of handlers) {
+            try {
+                await handler();
+            }
+            catch (error) {
+                const err = error instanceof Error ? error : new Error(String(error));
+                this.logger.error(() => `Exception during Sidekiq lifecycle event ${event}: ${err.message}`);
+                if (reraise) {
+                    throw err;
+                }
+            }
+        }
+        if (oneshot) {
+            this.lifecycleEvents[event] = [];
+        }
+    }
+}

package/dist/context.d.ts

@@ -0,0 +1,10 @@
+export type ContextValue = unknown;
+export type ContextMap = Record<string, ContextValue>;
+export declare class Context {
+    private static storage;
+    static current(): ContextMap;
+    static peek(): ContextMap | undefined;
+    static with<T>(values: ContextMap, fn: () => Promise<T> | T): Promise<T> | T;
+    static add(key: string, value: ContextValue): void;
+}
+//# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,YAAY,GAAG,OAAO,CAAC;AAEnC,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;AAGtD,qBAAa,OAAO;IAClB,OAAO,CAAC,MAAM,CAAC,OAAO,CAAuC;IAE7D,MAAM,CAAC,OAAO,IAAI,UAAU;IAU5B,MAAM,CAAC,IAAI,IAAI,UAAU,GAAG,SAAS;IAIrC,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;IAK5E,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,IAAI;CAQnD"}

package/dist/context.js

@@ -0,0 +1,29 @@
+import { AsyncLocalStorage } from "node:async_hooks";
+// biome-ignore lint/complexity/noStaticOnlyClass: Context class provides namespace for async context management
+export class Context {
+    static storage = new AsyncLocalStorage();
+    static current() {
+        const store = this.storage.getStore();
+        if (store) {
+            return store;
+        }
+        const initial = {};
+        this.storage.enterWith(initial);
+        return initial;
+    }
+    static peek() {
+        return this.storage.getStore();
+    }
+    static with(values, fn) {
+        const merged = { ...this.current(), ...values };
+        return this.storage.run(merged, fn);
+    }
+    static add(key, value) {
+        const store = this.storage.getStore();
+        if (store) {
+            store[key] = value;
+            return;
+        }
+        this.storage.enterWith({ [key]: value });
+    }
+}

package/dist/cron.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Cron expression parser for standard 5-field cron syntax.
+ *
+ * Format: minute hour day-of-month month day-of-week
+ *
+ * Supported syntax:
+ * - `*` - any value
+ * - `N` - specific value
+ * - `N-M` - range from N to M (inclusive)
+ * - `N,M,O` - list of values
+ * - `*\/N` or `N/M` - step values (every N starting at 0, or every M starting at N)
+ */
+export interface CronSchedule {
+    minute: number[];
+    hour: number[];
+    dayOfMonth: number[];
+    month: number[];
+    dayOfWeek: number[];
+}
+/**
+ * Parse a cron expression into a schedule object.
+ *
+ * @param expression - Standard 5-field cron expression (minute hour day month weekday)
+ * @returns Parsed schedule with arrays of valid values for each field
+ * @throws Error if the expression is invalid
+ */
+export declare function parseCron(expression: string): CronSchedule;
+/**
+ * Check if a schedule should run at the given date/time.
+ *
+ * @param schedule - Parsed cron schedule
+ * @param at - Date to check (defaults to now)
+ * @returns True if the schedule matches the given time
+ */
+export declare function shouldRunAt(schedule: CronSchedule, at?: Date): boolean;
+/**
+ * Calculate the next run time after a given date.
+ *
+ * @param schedule - Parsed cron schedule
+ * @param after - Start searching from this date (defaults to now)
+ * @returns The next date/time when the schedule will run
+ */
+export declare function nextRun(schedule: CronSchedule, after?: Date): Date;
+//# sourceMappingURL=cron.d.ts.map

package/dist/cron.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cron.d.ts","sourceRoot":"","sources":["../src/cron.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAwHD;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,YAAY,CAiB1D;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CACzB,QAAQ,EAAE,YAAY,EACtB,EAAE,GAAE,IAAiB,GACpB,OAAO,CAcT;AAED;;;;;;GAMG;AACH,wBAAgB,OAAO,CACrB,QAAQ,EAAE,YAAY,EACtB,KAAK,GAAE,IAAiB,GACvB,IAAI,CAoBN"}

package/dist/cron.js

@@ -0,0 +1,173 @@
+/**
+ * Cron expression parser for standard 5-field cron syntax.
+ *
+ * Format: minute hour day-of-month month day-of-week
+ *
+ * Supported syntax:
+ * - `*` - any value
+ * - `N` - specific value
+ * - `N-M` - range from N to M (inclusive)
+ * - `N,M,O` - list of values
+ * - `*\/N` or `N/M` - step values (every N starting at 0, or every M starting at N)
+ */
+const FIELD_RANGES = {
+    minute: { min: 0, max: 59 },
+    hour: { min: 0, max: 23 },
+    dayOfMonth: { min: 1, max: 31 },
+    month: { min: 1, max: 12 },
+    dayOfWeek: { min: 0, max: 6 },
+};
+const MONTH_NAMES = {
+    jan: 1,
+    feb: 2,
+    mar: 3,
+    apr: 4,
+    may: 5,
+    jun: 6,
+    jul: 7,
+    aug: 8,
+    sep: 9,
+    oct: 10,
+    nov: 11,
+    dec: 12,
+};
+const DAY_NAMES = {
+    sun: 0,
+    mon: 1,
+    tue: 2,
+    wed: 3,
+    thu: 4,
+    fri: 5,
+    sat: 6,
+};
+const WHITESPACE_REGEX = /\s+/;
+function parseValue(value, range, names) {
+    const lower = value.toLowerCase();
+    if (names && lower in names) {
+        return names[lower];
+    }
+    const num = Number.parseInt(value, 10);
+    if (Number.isNaN(num) || num < range.min || num > range.max) {
+        throw new Error(`Invalid cron value: ${value} (expected ${range.min}-${range.max})`);
+    }
+    return num;
+}
+// biome-ignore lint/complexity/noExcessiveCognitiveComplexity: cron parsing requires handling multiple syntax forms
+function parseField(field, range, names) {
+    const values = new Set();
+    for (const part of field.split(",")) {
+        if (part.includes("/")) {
+            // Step value: */N or N/M or N-M/S
+            const [rangeStr, stepStr] = part.split("/");
+            const step = Number.parseInt(stepStr, 10);
+            if (Number.isNaN(step) || step <= 0) {
+                throw new Error(`Invalid cron step: ${stepStr}`);
+            }
+            let start;
+            let end;
+            if (rangeStr === "*") {
+                start = range.min;
+                end = range.max;
+            }
+            else if (rangeStr.includes("-")) {
+                const [startStr, endStr] = rangeStr.split("-");
+                start = parseValue(startStr, range, names);
+                end = parseValue(endStr, range, names);
+            }
+            else {
+                start = parseValue(rangeStr, range, names);
+                end = range.max;
+            }
+            for (let i = start; i <= end; i += step) {
+                values.add(i);
+            }
+        }
+        else if (part.includes("-")) {
+            // Range: N-M
+            const [startStr, endStr] = part.split("-");
+            const start = parseValue(startStr, range, names);
+            const end = parseValue(endStr, range, names);
+            if (start > end) {
+                throw new Error(`Invalid cron range: ${part}`);
+            }
+            for (let i = start; i <= end; i += 1) {
+                values.add(i);
+            }
+        }
+        else if (part === "*") {
+            // Any value
+            for (let i = range.min; i <= range.max; i += 1) {
+                values.add(i);
+            }
+        }
+        else {
+            // Single value
+            values.add(parseValue(part, range, names));
+        }
+    }
+    return Array.from(values).sort((a, b) => a - b);
+}
+/**
+ * Parse a cron expression into a schedule object.
+ *
+ * @param expression - Standard 5-field cron expression (minute hour day month weekday)
+ * @returns Parsed schedule with arrays of valid values for each field
+ * @throws Error if the expression is invalid
+ */
+export function parseCron(expression) {
+    const parts = expression.trim().split(WHITESPACE_REGEX);
+    if (parts.length !== 5) {
+        throw new Error(`Invalid cron expression: expected 5 fields, got ${parts.length}`);
+    }
+    const [minute, hour, dayOfMonth, month, dayOfWeek] = parts;
+    return {
+        minute: parseField(minute, FIELD_RANGES.minute),
+        hour: parseField(hour, FIELD_RANGES.hour),
+        dayOfMonth: parseField(dayOfMonth, FIELD_RANGES.dayOfMonth),
+        month: parseField(month, FIELD_RANGES.month, MONTH_NAMES),
+        dayOfWeek: parseField(dayOfWeek, FIELD_RANGES.dayOfWeek, DAY_NAMES),
+    };
+}
+/**
+ * Check if a schedule should run at the given date/time.
+ *
+ * @param schedule - Parsed cron schedule
+ * @param at - Date to check (defaults to now)
+ * @returns True if the schedule matches the given time
+ */
+export function shouldRunAt(schedule, at = new Date()) {
+    const minute = at.getMinutes();
+    const hour = at.getHours();
+    const dayOfMonth = at.getDate();
+    const month = at.getMonth() + 1; // JS months are 0-indexed
+    const dayOfWeek = at.getDay();
+    return (schedule.minute.includes(minute) &&
+        schedule.hour.includes(hour) &&
+        schedule.dayOfMonth.includes(dayOfMonth) &&
+        schedule.month.includes(month) &&
+        schedule.dayOfWeek.includes(dayOfWeek));
+}
+/**
+ * Calculate the next run time after a given date.
+ *
+ * @param schedule - Parsed cron schedule
+ * @param after - Start searching from this date (defaults to now)
+ * @returns The next date/time when the schedule will run
+ */
+export function nextRun(schedule, after = new Date()) {
+    // Start from the next minute
+    const next = new Date(after);
+    next.setSeconds(0);
+    next.setMilliseconds(0);
+    next.setMinutes(next.getMinutes() + 1);
+    // Search up to 4 years ahead (handles leap years and edge cases)
+    const maxIterations = 4 * 366 * 24 * 60;
+    for (let i = 0; i < maxIterations; i += 1) {
+        if (shouldRunAt(schedule, next)) {
+            return next;
+        }
+        // Increment by 1 minute
+        next.setMinutes(next.getMinutes() + 1);
+    }
+    throw new Error("Could not find next run time within 4 years");
+}

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+export { DeadSet, JobRecord, ProcessSet, Queue, RetrySet, ScheduledSet, SortedEntry, Stats, StatsHistory, Workers, } from "./api.js";
+export { Client } from "./client.js";
+export { Config } from "./config.js";
+export { loadConfigFile } from "./config-loader.js";
+export { Context } from "./context.js";
+export { InterruptHandler } from "./interrupt-handler.js";
+export { IterableJob } from "./iterable.js";
+export { IterableAbort, IterableInterrupted, JobSkipError, } from "./iterable-errors.js";
+export { Job } from "./job.js";
+export { DefaultJobLogger } from "./job-logger.js";
+export { createLogger, Formatters, SidekiqLogger } from "./logger.js";
+export { Runner } from "./runner.js";
+export { Sidekiq } from "./sidekiq.js";
+export { EmptyQueueError, Queues, Testing } from "./testing.js";
+export type * from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,EACP,SAAS,EACT,UAAU,EACV,KAAK,EACL,QAAQ,EACR,YAAY,EACZ,WAAW,EACX,KAAK,EACL,YAAY,EACZ,OAAO,GACR,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,YAAY,GACb,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACtE,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,eAAe,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAChE,mBAAmB,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,14 @@
+export { DeadSet, JobRecord, ProcessSet, Queue, RetrySet, ScheduledSet, SortedEntry, Stats, StatsHistory, Workers, } from "./api.js";
+export { Client } from "./client.js";
+export { Config } from "./config.js";
+export { loadConfigFile } from "./config-loader.js";
+export { Context } from "./context.js";
+export { InterruptHandler } from "./interrupt-handler.js";
+export { IterableJob } from "./iterable.js";
+export { IterableAbort, IterableInterrupted, JobSkipError, } from "./iterable-errors.js";
+export { Job } from "./job.js";
+export { DefaultJobLogger } from "./job-logger.js";
+export { createLogger, Formatters, SidekiqLogger } from "./logger.js";
+export { Runner } from "./runner.js";
+export { Sidekiq } from "./sidekiq.js";
+export { EmptyQueueError, Queues, Testing } from "./testing.js";

package/dist/interrupt-handler.d.ts

@@ -0,0 +1,8 @@
+import type { Config } from "./config.js";
+import type { JobPayload } from "./types.js";
+export declare class InterruptHandler {
+    config?: Config;
+    call(_instance: unknown, payload: JobPayload, _queue: string, next: () => Promise<unknown> | unknown): Promise<unknown>;
+}
+export declare const ensureInterruptHandler: (config: Config) => void;
+//# sourceMappingURL=interrupt-handler.d.ts.map

package/dist/interrupt-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interrupt-handler.d.ts","sourceRoot":"","sources":["../src/interrupt-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,qBAAa,gBAAgB;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAEV,IAAI,CACR,SAAS,EAAE,OAAO,EAClB,OAAO,EAAE,UAAU,EACnB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,GACrC,OAAO,CAAC,OAAO,CAAC;CAcpB;AAED,eAAO,MAAM,sBAAsB,GAAI,QAAQ,MAAM,KAAG,IAIvD,CAAC"}

package/dist/interrupt-handler.js

@@ -0,0 +1,24 @@
+import { IterableInterrupted, JobSkipError } from "./iterable-errors.js";
+export class InterruptHandler {
+    config;
+    async call(_instance, payload, _queue, next) {
+        try {
+            return await next();
+        }
+        catch (error) {
+            if (error instanceof IterableInterrupted) {
+                this.config?.logger.debug("Interrupted, re-queueing...");
+                const { Client } = await import("./client.js");
+                const client = new Client({ config: this.config });
+                await client.push(payload);
+                throw new JobSkipError();
+            }
+            throw error;
+        }
+    }
+}
+export const ensureInterruptHandler = (config) => {
+    if (!config.serverMiddleware.exists(InterruptHandler)) {
+        config.serverMiddleware.add(InterruptHandler);
+    }
+};

package/dist/iterable-constants.d.ts

@@ -0,0 +1,3 @@
+export declare const ITERATION_STATE_FLUSH_INTERVAL_SECONDS = 5;
+export declare const ITERATION_STATE_TTL_SECONDS: number;
+//# sourceMappingURL=iterable-constants.d.ts.map

package/dist/iterable-constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"iterable-constants.d.ts","sourceRoot":"","sources":["../src/iterable-constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,sCAAsC,IAAI,CAAC;AACxD,eAAO,MAAM,2BAA2B,QAAoB,CAAC"}

package/dist/iterable-constants.js

@@ -0,0 +1,2 @@
+export const ITERATION_STATE_FLUSH_INTERVAL_SECONDS = 5;
+export const ITERATION_STATE_TTL_SECONDS = 30 * 24 * 60 * 60;

package/dist/iterable-errors.d.ts

@@ -0,0 +1,10 @@
+export declare class IterableInterrupted extends Error {
+    constructor(message?: string);
+}
+export declare class JobSkipError extends Error {
+    constructor(message?: string);
+}
+export declare class IterableAbort extends Error {
+    constructor();
+}
+//# sourceMappingURL=iterable-errors.d.ts.map

package/dist/iterable-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"iterable-errors.d.ts","sourceRoot":"","sources":["../src/iterable-errors.ts"],"names":[],"mappings":"AAAA,qBAAa,mBAAoB,SAAQ,KAAK;gBAChC,OAAO,SAA6B;CAIjD;AAED,qBAAa,YAAa,SAAQ,KAAK;gBACzB,OAAO,SAAgB;CAIpC;AAED,qBAAa,aAAc,SAAQ,KAAK;;CAKvC"}

package/dist/iterable-errors.js

@@ -0,0 +1,18 @@
+export class IterableInterrupted extends Error {
+    constructor(message = "Iterable job interrupted") {
+        super(message);
+        this.name = "IterableInterrupted";
+    }
+}
+export class JobSkipError extends Error {
+    constructor(message = "Job skipped") {
+        super(message);
+        this.name = "JobSkipError";
+    }
+}
+export class IterableAbort extends Error {
+    constructor() {
+        super("Iterable job aborted");
+        this.name = "IterableAbort";
+    }
+}

package/dist/iterable.d.ts

@@ -0,0 +1,44 @@
+import { Job } from "./job.js";
+type IterableEntry<TItem, TCursor> = [TItem, TCursor];
+type IterableSource<TItem, TCursor> = Iterator<IterableEntry<TItem, TCursor>> | Iterable<IterableEntry<TItem, TCursor>>;
+export declare class IterableJob<TArgs extends unknown[] = unknown[], TItem = unknown, TCursor = unknown> extends Job<TArgs> {
+    private executions;
+    private cursorValue;
+    private startTime;
+    private runtimeSeconds;
+    private argsValue;
+    private cancelledValue;
+    private currentObjectValue;
+    static abort(): never;
+    get currentObject(): TItem | null;
+    arguments(): Readonly<TArgs> | null;
+    cursor(): TCursor | null;
+    cancel(): Promise<boolean>;
+    cancelled(): boolean;
+    onStart(): Promise<void>;
+    onResume(): Promise<void>;
+    onStop(): Promise<void>;
+    onCancel(): Promise<void>;
+    onComplete(): Promise<void>;
+    aroundIteration(fn: () => Promise<void> | void): Promise<void>;
+    buildEnumerator(..._args: [...TArgs, {
+        cursor: TCursor | null;
+    }]): IterableSource<TItem, TCursor> | null;
+    eachIteration(_item: TItem, ..._args: TArgs): Promise<void>;
+    protected arrayEnumerator(array: TItem[], cursor: number | null | undefined): IterableSource<TItem, number>;
+    protected iterationKey(): string;
+    perform(...args: TArgs): Promise<void>;
+    private isCancelled;
+    private fetchPreviousIterationState;
+    private iterateWithEnumerator;
+    private verifyIterationTime;
+    private reenqueueIterationJob;
+    private assertEnumerator;
+    private shouldInterrupt;
+    private flushState;
+    private cleanup;
+    private handleCompleted;
+    private monoNow;
+}
+export {};
+//# sourceMappingURL=iterable.d.ts.map

package/dist/iterable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"iterable.d.ts","sourceRoot":"","sources":["../src/iterable.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAI/B,KAAK,aAAa,CAAC,KAAK,EAAE,OAAO,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;AAEtD,KAAK,cAAc,CAAC,KAAK,EAAE,OAAO,IAC9B,QAAQ,CAAC,aAAa,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,GACvC,QAAQ,CAAC,aAAa,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC;AAS5C,qBAAa,WAAW,CACtB,KAAK,SAAS,OAAO,EAAE,GAAG,OAAO,EAAE,EACnC,KAAK,GAAG,OAAO,EACf,OAAO,GAAG,OAAO,CACjB,SAAQ,GAAG,CAAC,KAAK,CAAC;IAClB,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,WAAW,CAAwB;IAC3C,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,SAAS,CAAgC;IACjD,OAAO,CAAC,cAAc,CAAuB;IAC7C,OAAO,CAAC,kBAAkB,CAAsB;IAEhD,MAAM,CAAC,KAAK,IAAI,KAAK;IAIrB,IAAI,aAAa,IAAI,KAAK,GAAG,IAAI,CAEhC;IAED,SAAS,IAAI,QAAQ,CAAC,KAAK,CAAC,GAAG,IAAI;IAInC,MAAM,IAAI,OAAO,GAAG,IAAI;IAIlB,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC;IAqBhC,SAAS,IAAI,OAAO;IAKd,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAIxB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAIzB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAIvB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAIzB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B,eAAe,CAAC,EAAE,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpE,eAAe,CACb,GAAG,KAAK,EAAE,CAAC,GAAG,KAAK,EAAE;QAAE,MAAM,EAAE,OAAO,GAAG,IAAI,CAAA;KAAE,CAAC,GAC/C,cAAc,CAAC,KAAK,EAAE,OAAO,CAAC,GAAG,IAAI;IAMxC,aAAa,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IAM3D,SAAS,CAAC,eAAe,CACvB,KAAK,EAAE,KAAK,EAAE,EACd,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAChC,cAAc,CAAC,KAAK,EAAE,MAAM,CAAC;IAuBhC,SAAS,CAAC,YAAY,IAAI,MAAM;IAI1B,OAAO,CAAC,GAAG,IAAI,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;YA6C9B,WAAW;YAUX,2BAA2B;YAc3B,qBAAqB;YA8DrB,mBAAmB;YAiBnB,qBAAqB;IAQnC,OAAO,CAAC,gBAAgB;IA4BxB,OAAO,CAAC,eAAe;YAKT,UAAU;YAqBV,OAAO;IAcrB,OAAO,CAAC,eAAe;IAUvB,OAAO,CAAC,OAAO;CAGhB"}