@quave/agenda 1.0.0

package/dist/cjs/utils/backoff.js

@@ -0,0 +1,175 @@
+"use strict";
+/**
+ * Backoff strategy utilities for job retry logic
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.backoffStrategies = void 0;
+exports.constant = constant;
+exports.linear = linear;
+exports.exponential = exponential;
+exports.combine = combine;
+exports.when = when;
+/**
+ * Apply jitter to a delay value
+ * @param delay - Base delay in milliseconds
+ * @param jitter - Jitter factor (0-1), where 0 means no jitter and 1 means up to ±100%
+ * @returns Delay with jitter applied
+ */
+function applyJitter(delay, jitter) {
+    if (jitter <= 0)
+        return delay;
+    // Random value between -jitter and +jitter
+    const jitterAmount = delay * jitter * (Math.random() * 2 - 1);
+    return Math.max(0, Math.round(delay + jitterAmount));
+}
+/**
+ * Constant backoff - same delay between each retry
+ *
+ * @example
+ * ```ts
+ * agenda.define('myJob', handler, {
+ *   backoff: constant({ delay: 5000, maxRetries: 5 })
+ * });
+ * // Retries at: 5s, 5s, 5s, 5s, 5s
+ * ```
+ */
+function constant(options = {}) {
+    const { delay = 1000, maxDelay = Infinity, maxRetries = 3, jitter = 0 } = options;
+    return (context) => {
+        if (context.attempt > maxRetries) {
+            return null;
+        }
+        const baseDelay = Math.min(delay, maxDelay);
+        return applyJitter(baseDelay, jitter);
+    };
+}
+/**
+ * Linear backoff - delay increases by a fixed amount each retry
+ *
+ * @example
+ * ```ts
+ * agenda.define('myJob', handler, {
+ *   backoff: linear({ delay: 1000, increment: 2000, maxRetries: 4 })
+ * });
+ * // Retries at: 1s, 3s, 5s, 7s
+ * ```
+ */
+function linear(options = {}) {
+    const { delay = 1000, increment = delay, maxDelay = Infinity, maxRetries = 3, jitter = 0 } = options;
+    return (context) => {
+        if (context.attempt > maxRetries) {
+            return null;
+        }
+        const baseDelay = delay + increment * (context.attempt - 1);
+        const cappedDelay = Math.min(baseDelay, maxDelay);
+        return applyJitter(cappedDelay, jitter);
+    };
+}
+/**
+ * Exponential backoff - delay multiplies by a factor each retry
+ *
+ * @example
+ * ```ts
+ * agenda.define('myJob', handler, {
+ *   backoff: exponential({ delay: 1000, factor: 2, maxRetries: 5 })
+ * });
+ * // Retries at: 1s, 2s, 4s, 8s, 16s
+ *
+ * // With jitter to prevent thundering herd:
+ * agenda.define('myJob', handler, {
+ *   backoff: exponential({ delay: 1000, factor: 2, maxRetries: 5, jitter: 0.2 })
+ * });
+ * ```
+ */
+function exponential(options = {}) {
+    const { delay = 1000, factor = 2, maxDelay = Infinity, maxRetries = 3, jitter = 0 } = options;
+    return (context) => {
+        if (context.attempt > maxRetries) {
+            return null;
+        }
+        const baseDelay = delay * Math.pow(factor, context.attempt - 1);
+        const cappedDelay = Math.min(baseDelay, maxDelay);
+        return applyJitter(cappedDelay, jitter);
+    };
+}
+/**
+ * Combine multiple strategies - tries each in sequence until one returns non-null
+ * Useful for implementing complex retry logic
+ *
+ * @example
+ * ```ts
+ * // Retry quickly at first, then back off
+ * agenda.define('myJob', handler, {
+ *   backoff: combine(
+ *     // First 2 retries: immediate (100ms)
+ *     (ctx) => ctx.attempt <= 2 ? 100 : null,
+ *     // Then exponential backoff for 3 more attempts
+ *     exponential({ delay: 1000, maxRetries: 3 })
+ *   )
+ * });
+ * ```
+ */
+function combine(...strategies) {
+    return (context) => {
+        for (const strategy of strategies) {
+            const result = strategy(context);
+            if (result !== null) {
+                return result;
+            }
+        }
+        return null;
+    };
+}
+/**
+ * Conditional backoff - only retry if condition is met
+ *
+ * @example
+ * ```ts
+ * // Only retry on specific errors
+ * agenda.define('myJob', handler, {
+ *   backoff: when(
+ *     (ctx) => ctx.error.message.includes('timeout'),
+ *     exponential({ delay: 1000, maxRetries: 3 })
+ *   )
+ * });
+ * ```
+ */
+function when(condition, strategy) {
+    return (context) => {
+        if (!condition(context)) {
+            return null;
+        }
+        return strategy(context);
+    };
+}
+/**
+ * Pre-configured backoff strategies for common use cases
+ */
+exports.backoffStrategies = {
+    /** Constant 1s delay, 3 retries */
+    constant,
+    /** Linear increase starting at 1s, 3 retries */
+    linear,
+    /** Exponential with factor 2, starting at 1s, 3 retries */
+    exponential,
+    /** Combine multiple strategies */
+    combine,
+    /** Conditional retry */
+    when,
+    /**
+     * Aggressive retry - quick retries for transient failures
+     * 100ms, 200ms, 400ms (3 retries in ~700ms total)
+     */
+    aggressive: () => exponential({ delay: 100, factor: 2, maxRetries: 3 }),
+    /**
+     * Relaxed retry - gentle backoff for rate-limited APIs
+     * 5s, 15s, 45s, 135s (4 retries over ~3 minutes)
+     */
+    relaxed: () => exponential({ delay: 5000, factor: 3, maxRetries: 4, jitter: 0.1 }),
+    /**
+     * Standard retry - balanced approach
+     * 1s, 2s, 4s, 8s, 16s (5 retries over ~31 seconds)
+     */
+    standard: () => exponential({ delay: 1000, factor: 2, maxRetries: 5, jitter: 0.1 })
+};
+//# sourceMappingURL=backoff.js.map

package/dist/cjs/utils/backoff.js.map

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

package/dist/cjs/utils/dateConstraints.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Check if a given date should be skipped based on the skip days configuration.
+ * @param date - The date to check
+ * @param skipDays - Array of days to skip (0 = Sunday, 1 = Monday, ..., 6 = Saturday)
+ * @param timezone - Optional timezone for the check
+ * @returns true if the day should be skipped
+ */
+export declare function shouldSkipDay(date: Date, skipDays?: number[], timezone?: string): boolean;
+/**
+ * Applies skip days constraint to a date, moving forward to the next valid day.
+ * Preserves the time of day from the original date.
+ * @param date - The original date
+ * @param skipDays - Array of days to skip (0 = Sunday, 1 = Monday, ..., 6 = Saturday)
+ * @param timezone - Optional timezone
+ * @returns The adjusted date on a valid day, or null if no valid day found
+ */
+export declare function applySkipDays(date: Date, skipDays?: number[], timezone?: string): Date | null;
+/**
+ * Applies date range constraints to a nextRunAt date.
+ * - If nextRunAt is before startDate, returns startDate
+ * - If nextRunAt is after endDate, returns null (job should not run)
+ * @param nextRunAt - The computed next run time
+ * @param startDate - Optional start date constraint
+ * @param endDate - Optional end date constraint
+ * @returns The adjusted date, or null if outside valid range
+ */
+export declare function applyDateRangeConstraints(nextRunAt: Date, startDate?: Date, endDate?: Date): Date | null;
+/**
+ * Apply all date constraints (date range and skip days) to a computed nextRunAt.
+ * This is the main function to use when computing nextRunAt.
+ * @param nextRunAt - The base computed next run time
+ * @param options - Constraint options
+ * @returns The adjusted date respecting all constraints, or null if invalid
+ */
+export declare function applyAllDateConstraints(nextRunAt: Date, options: {
+    startDate?: Date;
+    endDate?: Date;
+    skipDays?: number[];
+    timezone?: string;
+}): Date | null;
+/**
+ * Check if a date is within the valid date range.
+ * @param date - The date to check
+ * @param startDate - Optional start date constraint
+ * @param endDate - Optional end date constraint
+ * @returns true if the date is within the valid range
+ */
+export declare function isWithinDateRange(date: Date, startDate?: Date, endDate?: Date): boolean;

package/dist/cjs/utils/dateConstraints.js

@@ -0,0 +1,127 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.shouldSkipDay = shouldSkipDay;
+exports.applySkipDays = applySkipDays;
+exports.applyDateRangeConstraints = applyDateRangeConstraints;
+exports.applyAllDateConstraints = applyAllDateConstraints;
+exports.isWithinDateRange = isWithinDateRange;
+const luxon_1 = require("luxon");
+const debug_1 = __importDefault(require("debug"));
+const log = (0, debug_1.default)('agenda:dateConstraints');
+/**
+ * Check if a given date should be skipped based on the skip days configuration.
+ * @param date - The date to check
+ * @param skipDays - Array of days to skip (0 = Sunday, 1 = Monday, ..., 6 = Saturday)
+ * @param timezone - Optional timezone for the check
+ * @returns true if the day should be skipped
+ */
+function shouldSkipDay(date, skipDays, timezone) {
+    if (!skipDays || skipDays.length === 0) {
+        return false;
+    }
+    const dt = timezone
+        ? luxon_1.DateTime.fromJSDate(date, { zone: timezone })
+        : luxon_1.DateTime.fromJSDate(date);
+    // Luxon weekday: 1 = Monday, 7 = Sunday
+    // Convert to JS weekday: 0 = Sunday, 1 = Monday, ..., 6 = Saturday
+    const jsWeekday = dt.weekday === 7 ? 0 : dt.weekday;
+    return skipDays.includes(jsWeekday);
+}
+/**
+ * Applies skip days constraint to a date, moving forward to the next valid day.
+ * Preserves the time of day from the original date.
+ * @param date - The original date
+ * @param skipDays - Array of days to skip (0 = Sunday, 1 = Monday, ..., 6 = Saturday)
+ * @param timezone - Optional timezone
+ * @returns The adjusted date on a valid day, or null if no valid day found
+ */
+function applySkipDays(date, skipDays, timezone) {
+    if (!skipDays || skipDays.length === 0) {
+        return date;
+    }
+    // Validate skip days - if all days are skipped, return null
+    if (skipDays.length >= 7) {
+        log('all days are marked as skip days, returning null');
+        return null;
+    }
+    let dt = timezone
+        ? luxon_1.DateTime.fromJSDate(date, { zone: timezone })
+        : luxon_1.DateTime.fromJSDate(date);
+    // Luxon weekday: 1 = Monday, 7 = Sunday
+    // Convert to JS weekday: 0 = Sunday, 1 = Monday, ..., 6 = Saturday
+    const getJsWeekday = (luxonDt) => luxonDt.weekday === 7 ? 0 : luxonDt.weekday;
+    // Terminates within 6 steps: covering all 7 weekdays needs 7 distinct
+    // entries, which the length >= 7 guard above already rejected.
+    while (skipDays.includes(getJsWeekday(dt))) {
+        dt = dt.plus({ days: 1 });
+        log('skipping day, moved to %s', dt.toISO());
+    }
+    return dt.toJSDate();
+}
+/**
+ * Applies date range constraints to a nextRunAt date.
+ * - If nextRunAt is before startDate, returns startDate
+ * - If nextRunAt is after endDate, returns null (job should not run)
+ * @param nextRunAt - The computed next run time
+ * @param startDate - Optional start date constraint
+ * @param endDate - Optional end date constraint
+ * @returns The adjusted date, or null if outside valid range
+ */
+function applyDateRangeConstraints(nextRunAt, startDate, endDate) {
+    let result = nextRunAt;
+    // If before start date, move to start date
+    if (startDate && result < startDate) {
+        log('nextRunAt %s is before startDate %s, adjusting', result.toISOString(), startDate.toISOString());
+        result = new Date(startDate);
+    }
+    // If after end date, return null (job should stop)
+    if (endDate && result > endDate) {
+        log('nextRunAt %s is after endDate %s, returning null', result.toISOString(), endDate.toISOString());
+        return null;
+    }
+    return result;
+}
+/**
+ * Apply all date constraints (date range and skip days) to a computed nextRunAt.
+ * This is the main function to use when computing nextRunAt.
+ * @param nextRunAt - The base computed next run time
+ * @param options - Constraint options
+ * @returns The adjusted date respecting all constraints, or null if invalid
+ */
+function applyAllDateConstraints(nextRunAt, options) {
+    const { startDate, endDate, skipDays, timezone } = options;
+    // Step 1: If before startDate, move to startDate. The endDate check
+    // happens in step 3, after skip days may have moved the date.
+    let result = startDate && nextRunAt < startDate ? new Date(startDate) : nextRunAt;
+    // Step 2: Apply skip days
+    result = applySkipDays(result, skipDays, timezone);
+    if (!result) {
+        return null;
+    }
+    // Step 3: Check end date constraint again (skip days may have moved the date)
+    if (endDate && result > endDate) {
+        log('after skip days adjustment, date %s is after endDate %s', result.toISOString(), endDate.toISOString());
+        return null;
+    }
+    return result;
+}
+/**
+ * Check if a date is within the valid date range.
+ * @param date - The date to check
+ * @param startDate - Optional start date constraint
+ * @param endDate - Optional end date constraint
+ * @returns true if the date is within the valid range
+ */
+function isWithinDateRange(date, startDate, endDate) {
+    if (startDate && date < startDate) {
+        return false;
+    }
+    if (endDate && date > endDate) {
+        return false;
+    }
+    return true;
+}
+//# sourceMappingURL=dateConstraints.js.map

package/dist/cjs/utils/dateConstraints.js.map

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

package/dist/cjs/utils/isValidDate.d.ts

@@ -0,0 +1 @@
+export declare function isValidDate(date: unknown): date is Date;

package/dist/cjs/utils/isValidDate.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isValidDate = isValidDate;
+function isValidDate(date) {
+    // An invalid date object returns NaN for getTime()
+    return date !== null && Number.isNaN(new Date(date).getTime()) === false;
+}
+//# sourceMappingURL=isValidDate.js.map

package/dist/cjs/utils/isValidDate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"isValidDate.js","sourceRoot":"","sources":["../../../src/utils/isValidDate.ts"],"names":[],"mappings":";;AAAA,kCAGC;AAHD,SAAgB,WAAW,CAAC,IAAa;IACxC,mDAAmD;IACnD,OAAO,IAAI,KAAK,IAAI,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,IAAc,CAAC,CAAC,OAAO,EAAE,CAAC,KAAK,KAAK,CAAC;AACpF,CAAC"}

package/dist/cjs/utils/nextRunAt.d.ts

@@ -0,0 +1,10 @@
+import type { JobParameters } from '../types/JobParameters.js';
+export declare function isValidHumanInterval(value: unknown): value is string;
+/**
+ * Internal method that computes the interval
+ */
+export declare const computeFromInterval: (attrs: JobParameters<unknown>) => Date | null;
+/**
+ * Internal method to compute next run time from the repeat string
+ */
+export declare function computeFromRepeatAt(attrs: JobParameters<unknown>): Date | null;

package/dist/cjs/utils/nextRunAt.js

@@ -0,0 +1,119 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.computeFromInterval = void 0;
+exports.isValidHumanInterval = isValidHumanInterval;
+exports.computeFromRepeatAt = computeFromRepeatAt;
+const luxon_1 = require("luxon");
+const date_js_1 = __importDefault(require("date.js"));
+const debug_1 = __importDefault(require("debug"));
+const cron_parser_1 = require("cron-parser");
+const human_interval_1 = __importDefault(require("human-interval"));
+const isValidDate_js_1 = require("./isValidDate.js");
+const dateConstraints_js_1 = require("./dateConstraints.js");
+const log = (0, debug_1.default)('agenda:nextRunAt');
+const dateForTimezone = (timezoneDate, timezone) => luxon_1.DateTime.fromJSDate(timezoneDate, { zone: timezone });
+function isValidHumanInterval(value) {
+    const transformedValue = (0, human_interval_1.default)(value);
+    return typeof transformedValue === 'number' && Number.isNaN(transformedValue) === false;
+}
+/**
+ * Internal method that computes the interval
+ */
+const computeFromInterval = (attrs) => {
+    const previousNextRunAt = attrs.nextRunAt || new Date();
+    log('[%s:%s] computing next run via interval [%s]', attrs.name, attrs._id, attrs.repeatInterval);
+    const lastRun = dateForTimezone(attrs.lastRunAt || new Date(), attrs.repeatTimezone);
+    const cronOptions = {
+        currentDate: lastRun.toJSDate(),
+        tz: attrs.repeatTimezone
+    };
+    let nextRunAt = null;
+    let error;
+    if (typeof attrs.repeatInterval === 'string') {
+        try {
+            let cronTime = cron_parser_1.CronExpressionParser.parse(attrs.repeatInterval, cronOptions);
+            let nextDate = cronTime.next().toDate();
+            if (nextDate.valueOf() === lastRun.valueOf() ||
+                nextDate.valueOf() <= previousNextRunAt.valueOf()) {
+                // Handle cronTime giving back the same date for the next run time
+                cronOptions.currentDate = new Date(lastRun.valueOf() + 1000);
+                cronTime = cron_parser_1.CronExpressionParser.parse(attrs.repeatInterval, cronOptions);
+                nextDate = cronTime.next().toDate();
+            }
+            nextRunAt = nextDate;
+        }
+        catch (err) {
+            error = err;
+        }
+    }
+    if (isValidHumanInterval(attrs.repeatInterval)) {
+        if (!attrs.lastRunAt) {
+            nextRunAt = new Date(lastRun.valueOf());
+        }
+        else {
+            const intervalValue = (0, human_interval_1.default)(attrs.repeatInterval);
+            nextRunAt = new Date(lastRun.valueOf() + intervalValue);
+        }
+    }
+    if (!(0, isValidDate_js_1.isValidDate)(nextRunAt)) {
+        log('[%s:%s] failed to calculate nextRunAt due to invalid repeat interval', attrs.name, attrs._id);
+        throw new Error(`failed to calculate nextRunAt due to invalid repeat interval (${attrs.repeatInterval}): ${error || 'no readable human interval'}`);
+    }
+    // Apply date constraints (startDate, endDate, skipDays)
+    if (attrs.startDate || attrs.endDate || attrs.skipDays) {
+        nextRunAt = (0, dateConstraints_js_1.applyAllDateConstraints)(nextRunAt, {
+            startDate: attrs.startDate,
+            endDate: attrs.endDate,
+            skipDays: attrs.skipDays,
+            timezone: attrs.repeatTimezone
+        });
+        if (nextRunAt === null) {
+            log('[%s:%s] nextRunAt is null after applying date constraints', attrs.name, attrs._id);
+        }
+    }
+    return nextRunAt;
+};
+exports.computeFromInterval = computeFromInterval;
+/**
+ * Internal method to compute next run time from the repeat string
+ */
+function computeFromRepeatAt(attrs) {
+    const lastRun = attrs.lastRunAt || new Date();
+    const repeatAt = attrs.repeatAt;
+    if (!repeatAt) {
+        throw new Error('repeatAt is required');
+    }
+    const nextDate = (0, date_js_1.default)(repeatAt).valueOf();
+    // If you do not specify offset date for below test it will fail for ms
+    const offset = Date.now();
+    if (offset === (0, date_js_1.default)(repeatAt, new Date(offset)).valueOf()) {
+        log('[%s:%s] failed to calculate repeatAt due to invalid format', attrs.name, attrs._id);
+        throw new Error('failed to calculate repeatAt time due to invalid format');
+    }
+    let nextRunAt;
+    if (nextDate === lastRun.valueOf()) {
+        nextRunAt = (0, date_js_1.default)('tomorrow at ' + repeatAt);
+    }
+    else {
+        nextRunAt = (0, date_js_1.default)(repeatAt);
+    }
+    // Apply date constraints (startDate, endDate, skipDays)
+    if (attrs.startDate || attrs.endDate || attrs.skipDays) {
+        const constrainedDate = (0, dateConstraints_js_1.applyAllDateConstraints)(nextRunAt, {
+            startDate: attrs.startDate,
+            endDate: attrs.endDate,
+            skipDays: attrs.skipDays,
+            timezone: attrs.repeatTimezone
+        });
+        if (constrainedDate === null) {
+            log('[%s:%s] nextRunAt is null after applying date constraints', attrs.name, attrs._id);
+            return null;
+        }
+        nextRunAt = constrainedDate;
+    }
+    return nextRunAt;
+}
+//# sourceMappingURL=nextRunAt.js.map

package/dist/cjs/utils/nextRunAt.js.map

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

package/dist/cjs/utils/priority.d.ts

@@ -0,0 +1,13 @@
+export type JobPriority = number | keyof typeof priorityMap;
+declare const priorityMap: {
+    lowest: number;
+    low: number;
+    normal: number;
+    high: number;
+    highest: number;
+};
+/**
+ * Internal method to turn priority into a number
+ */
+export declare function parsePriority(priority?: JobPriority): number;
+export {};

package/dist/cjs/utils/priority.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parsePriority = parsePriority;
+const priorityMap = {
+    lowest: -20,
+    low: -10,
+    normal: 0,
+    high: 10,
+    highest: 20
+};
+/**
+ * Internal method to turn priority into a number
+ */
+function parsePriority(priority) {
+    if (typeof priority === 'number') {
+        return priority;
+    }
+    if (typeof priority === 'string' && priorityMap[priority]) {
+        return priorityMap[priority];
+    }
+    return priorityMap.normal;
+}
+//# sourceMappingURL=priority.js.map

package/dist/cjs/utils/priority.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"priority.js","sourceRoot":"","sources":["../../../src/utils/priority.ts"],"names":[],"mappings":";;AAaA,sCAUC;AArBD,MAAM,WAAW,GAAG;IACnB,MAAM,EAAE,CAAC,EAAE;IACX,GAAG,EAAE,CAAC,EAAE;IACR,MAAM,EAAE,CAAC;IACT,IAAI,EAAE,EAAE;IACR,OAAO,EAAE,EAAE;CACX,CAAC;AAEF;;GAEG;AACH,SAAgB,aAAa,CAAC,QAAsB;IACnD,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAClC,OAAO,QAAQ,CAAC;IACjB,CAAC;IAED,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,WAAW,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC3D,OAAO,WAAW,CAAC,QAAQ,CAAC,CAAC;IAC9B,CAAC;IAED,OAAO,WAAW,CAAC,MAAM,CAAC;AAC3B,CAAC"}

package/dist/cjs/utils/processEvery.d.ts

@@ -0,0 +1 @@
+export declare function calculateProcessEvery(input?: number | string): number;

package/dist/cjs/utils/processEvery.js

@@ -0,0 +1,13 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.calculateProcessEvery = calculateProcessEvery;
+const human_interval_1 = __importDefault(require("human-interval"));
+function calculateProcessEvery(input = 5000) {
+    if (typeof input === 'number')
+        return input;
+    return (0, human_interval_1.default)(input) || 5000;
+}
+//# sourceMappingURL=processEvery.js.map

package/dist/cjs/utils/processEvery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"processEvery.js","sourceRoot":"","sources":["../../../src/utils/processEvery.ts"],"names":[],"mappings":";;;;;AAEA,sDAGC;AALD,oEAA2C;AAE3C,SAAgB,qBAAqB,CAAC,QAAyB,IAAI;IAClE,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5C,OAAQ,IAAA,wBAAa,EAAC,KAAK,CAAY,IAAI,IAAI,CAAC;AACjD,CAAC"}

package/dist/cjs/utils/stack.d.ts

@@ -0,0 +1 @@
+export declare function getCallerFilePath(position?: number): string | undefined;

package/dist/cjs/utils/stack.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getCallerFilePath = getCallerFilePath;
+function getCallerFilePath(position = 2) {
+    if (position >= Error.stackTraceLimit) {
+        throw new TypeError(`getCallerFile(position) requires position be less then Error.stackTraceLimit but position was: \`${position}\` and Error.stackTraceLimit was: \`${Error.stackTraceLimit}\``);
+    }
+    const oldPrepareStackTrace = Error.prepareStackTrace;
+    Error.prepareStackTrace = (_, stack) => stack;
+    const { stack } = new Error();
+    Error.prepareStackTrace = oldPrepareStackTrace;
+    if (stack !== null && typeof stack === 'object') {
+        // stack[0] holds this file
+        // stack[1] holds where this function was called
+        // stack[2] holds the file we're interested in
+        const callSite = stack[position];
+        return callSite?.getFileName() ?? undefined;
+    }
+    return undefined;
+}
+//# sourceMappingURL=stack.js.map

package/dist/cjs/utils/stack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stack.js","sourceRoot":"","sources":["../../../src/utils/stack.ts"],"names":[],"mappings":";;AAAA,8CAoBC;AApBD,SAAgB,iBAAiB,CAAC,QAAQ,GAAG,CAAC;IAC7C,IAAI,QAAQ,IAAI,KAAK,CAAC,eAAe,EAAE,CAAC;QACvC,MAAM,IAAI,SAAS,CAClB,oGAAoG,QAAQ,uCAAuC,KAAK,CAAC,eAAe,IAAI,CAC5K,CAAC;IACH,CAAC;IAED,MAAM,oBAAoB,GAAG,KAAK,CAAC,iBAAiB,CAAC;IACrD,KAAK,CAAC,iBAAiB,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC;IAC9C,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,KAAK,EAAE,CAAC;IAC9B,KAAK,CAAC,iBAAiB,GAAG,oBAAoB,CAAC;IAE/C,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACjD,2BAA2B;QAC3B,gDAAgD;QAChD,8CAA8C;QAC9C,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAgC,CAAC;QAChE,OAAO,QAAQ,EAAE,WAAW,EAAE,IAAI,SAAS,CAAC;IAC7C,CAAC;IACD,OAAO,SAAS,CAAC;AAClB,CAAC"}

package/dist/cjs/version.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Package version, reported by getRunningStats().
+ *
+ * Kept as a source constant (instead of importing package.json) so the
+ * emitted code stays free of import.meta and JSON import attributes —
+ * required for the CommonJS build and for old runtimes (Meteor 2.x runs
+ * Node 14). A unit test asserts it matches package.json.
+ */
+export declare const agendaVersion = "1.0.0";

package/dist/cjs/version.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.agendaVersion = void 0;
+/**
+ * Package version, reported by getRunningStats().
+ *
+ * Kept as a source constant (instead of importing package.json) so the
+ * emitted code stays free of import.meta and JSON import attributes —
+ * required for the CommonJS build and for old runtimes (Meteor 2.x runs
+ * Node 14). A unit test asserts it matches package.json.
+ */
+exports.agendaVersion = '1.0.0';
+//# sourceMappingURL=version.js.map

package/dist/cjs/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/version.ts"],"names":[],"mappings":";;;AAAA;;;;;;;GAOG;AACU,QAAA,aAAa,GAAG,OAAO,CAAC"}