@nicnocquee/dataqueue 1.30.0 → 1.31.0

package/dist/index.d.cts

@@ -1,5 +1,6 @@
 import * as pg from 'pg';
 import { Pool } from 'pg';
+import { Cron } from 'croner';
 
 type JobType<PayloadMap> = keyof PayloadMap & string;
 interface JobOptions<PayloadMap, T extends JobType<PayloadMap>> {
@@ -490,6 +491,81 @@ type JobQueueConfig = PostgresJobQueueConfig | RedisJobQueueConfig;
 /** @deprecated Use JobQueueConfig instead. Alias kept for backward compat. */
 type JobQueueConfigLegacy = PostgresJobQueueConfig;
 type TagQueryMode = 'exact' | 'all' | 'any' | 'none';
+/**
+ * Status of a cron schedule.
+ */
+type CronScheduleStatus = 'active' | 'paused';
+/**
+ * Options for creating a recurring cron schedule.
+ * Each schedule defines a recurring job that is automatically enqueued
+ * when its cron expression matches.
+ */
+interface CronScheduleOptions<PayloadMap, T extends JobType<PayloadMap>> {
+    /** Unique human-readable name for the schedule. */
+    scheduleName: string;
+    /** Standard cron expression (5 fields, e.g. "0 * * * *"). */
+    cronExpression: string;
+    /** Job type from the PayloadMap. */
+    jobType: T;
+    /** Payload for each job instance. */
+    payload: PayloadMap[T];
+    /** Maximum retry attempts for each job instance (default: 3). */
+    maxAttempts?: number;
+    /** Priority for each job instance (default: 0). */
+    priority?: number;
+    /** Timeout in milliseconds for each job instance. */
+    timeoutMs?: number;
+    /** Whether to force-kill the job on timeout (default: false). */
+    forceKillOnTimeout?: boolean;
+    /** Tags for each job instance. */
+    tags?: string[];
+    /** IANA timezone string for cron evaluation (default: "UTC"). */
+    timezone?: string;
+    /**
+     * Whether to allow overlapping job instances (default: false).
+     * When false, a new job will not be enqueued if the previous instance
+     * is still pending, processing, or waiting.
+     */
+    allowOverlap?: boolean;
+}
+/**
+ * A persisted cron schedule record.
+ */
+interface CronScheduleRecord {
+    id: number;
+    scheduleName: string;
+    cronExpression: string;
+    jobType: string;
+    payload: any;
+    maxAttempts: number;
+    priority: number;
+    timeoutMs: number | null;
+    forceKillOnTimeout: boolean;
+    tags: string[] | undefined;
+    timezone: string;
+    allowOverlap: boolean;
+    status: CronScheduleStatus;
+    lastEnqueuedAt: Date | null;
+    lastJobId: number | null;
+    nextRunAt: Date | null;
+    createdAt: Date;
+    updatedAt: Date;
+}
+/**
+ * Options for editing an existing cron schedule.
+ * All fields are optional; only provided fields are updated.
+ */
+interface EditCronScheduleOptions {
+    cronExpression?: string;
+    payload?: any;
+    maxAttempts?: number;
+    priority?: number;
+    timeoutMs?: number | null;
+    forceKillOnTimeout?: boolean;
+    tags?: string[] | null;
+    timezone?: string;
+    allowOverlap?: boolean;
+}
 interface JobQueue<PayloadMap> {
     /**
      * Add a job to the job queue.
@@ -676,6 +752,56 @@ interface JobQueue<PayloadMap> {
      * @returns The number of tokens that were expired.
      */
     expireTimedOutTokens: () => Promise<number>;
+    /**
+     * Add a recurring cron schedule. The processor automatically enqueues
+     * due cron jobs before each batch, so no manual triggering is needed.
+     *
+     * @returns The ID of the created schedule.
+     * @throws If the cron expression is invalid or the schedule name is already taken.
+     */
+    addCronJob: <T extends JobType<PayloadMap>>(options: CronScheduleOptions<PayloadMap, T>) => Promise<number>;
+    /**
+     * Get a cron schedule by its ID.
+     */
+    getCronJob: (id: number) => Promise<CronScheduleRecord | null>;
+    /**
+     * Get a cron schedule by its unique name.
+     */
+    getCronJobByName: (name: string) => Promise<CronScheduleRecord | null>;
+    /**
+     * List all cron schedules, optionally filtered by status.
+     */
+    listCronJobs: (status?: CronScheduleStatus) => Promise<CronScheduleRecord[]>;
+    /**
+     * Remove a cron schedule by its ID. Does not cancel any already-enqueued jobs.
+     */
+    removeCronJob: (id: number) => Promise<void>;
+    /**
+     * Pause a cron schedule. Paused schedules are skipped by `enqueueDueCronJobs()`.
+     */
+    pauseCronJob: (id: number) => Promise<void>;
+    /**
+     * Resume a paused cron schedule.
+     */
+    resumeCronJob: (id: number) => Promise<void>;
+    /**
+     * Edit an existing cron schedule. Only provided fields are updated.
+     * If `cronExpression` or `timezone` changes, `nextRunAt` is recalculated.
+     */
+    editCronJob: (id: number, updates: EditCronScheduleOptions) => Promise<void>;
+    /**
+     * Check all active cron schedules and enqueue jobs for any whose
+     * `nextRunAt` has passed. When `allowOverlap` is false (the default),
+     * a new job is not enqueued if the previous instance is still
+     * pending, processing, or waiting.
+     *
+     * **Note:** The processor calls this automatically before each batch,
+     * so you typically do not need to call it yourself. It is exposed for
+     * manual use in tests or one-off scripts.
+     *
+     * @returns The number of jobs that were enqueued.
+     */
+    enqueueDueCronJobs: () => Promise<number>;
     /**
      * Get the PostgreSQL database pool.
      * Throws if the backend is not PostgreSQL.
@@ -723,6 +849,24 @@ interface JobUpdates {
     timeoutMs?: number | null;
     tags?: string[] | null;
 }
+/**
+ * Input shape for creating a cron schedule in the backend.
+ * This is the backend-level version of CronScheduleOptions.
+ */
+interface CronScheduleInput {
+    scheduleName: string;
+    cronExpression: string;
+    jobType: string;
+    payload: any;
+    maxAttempts: number;
+    priority: number;
+    timeoutMs: number | null;
+    forceKillOnTimeout: boolean;
+    tags: string[] | undefined;
+    timezone: string;
+    allowOverlap: boolean;
+    nextRunAt: Date | null;
+}
 /**
  * Abstract backend interface that both PostgreSQL and Redis implement.
  * All storage operations go through this interface so the processor
@@ -774,6 +918,32 @@ interface QueueBackend {
     recordJobEvent(jobId: number, eventType: JobEventType, metadata?: any): Promise<void>;
     /** Get all events for a job, ordered by createdAt ASC. */
     getJobEvents(jobId: number): Promise<JobEvent[]>;
+    /** Create a cron schedule and return its ID. */
+    addCronSchedule(input: CronScheduleInput): Promise<number>;
+    /** Get a cron schedule by ID, or null if not found. */
+    getCronSchedule(id: number): Promise<CronScheduleRecord | null>;
+    /** Get a cron schedule by its unique name, or null if not found. */
+    getCronScheduleByName(name: string): Promise<CronScheduleRecord | null>;
+    /** List cron schedules, optionally filtered by status. */
+    listCronSchedules(status?: CronScheduleStatus): Promise<CronScheduleRecord[]>;
+    /** Delete a cron schedule by ID. */
+    removeCronSchedule(id: number): Promise<void>;
+    /** Pause a cron schedule. */
+    pauseCronSchedule(id: number): Promise<void>;
+    /** Resume a cron schedule. */
+    resumeCronSchedule(id: number): Promise<void>;
+    /** Edit a cron schedule. */
+    editCronSchedule(id: number, updates: EditCronScheduleOptions, nextRunAt?: Date | null): Promise<void>;
+    /**
+     * Atomically fetch all active cron schedules whose nextRunAt <= now.
+     * In PostgreSQL this uses FOR UPDATE SKIP LOCKED to prevent duplicate enqueuing.
+     */
+    getDueCronSchedules(): Promise<CronScheduleRecord[]>;
+    /**
+     * Update a cron schedule after a job has been enqueued.
+     * Sets lastEnqueuedAt, lastJobId, and advances nextRunAt.
+     */
+    updateCronScheduleAfterEnqueue(id: number, lastEnqueuedAt: Date, lastJobId: number, nextRunAt: Date | null): Promise<void>;
     /** Set a pending reason for unpicked jobs of a given type. */
     setPendingReasonForUnpickedJobs(reason: string, jobType?: string | string[]): Promise<void>;
 }
@@ -809,6 +979,32 @@ declare class PostgresBackend implements QueueBackend {
      * More efficient than individual recordJobEvent calls.
      */
     private recordJobEventsBatch;
+    /** Create a cron schedule and return its ID. */
+    addCronSchedule(input: CronScheduleInput): Promise<number>;
+    /** Get a cron schedule by ID. */
+    getCronSchedule(id: number): Promise<CronScheduleRecord | null>;
+    /** Get a cron schedule by its unique name. */
+    getCronScheduleByName(name: string): Promise<CronScheduleRecord | null>;
+    /** List cron schedules, optionally filtered by status. */
+    listCronSchedules(status?: CronScheduleStatus): Promise<CronScheduleRecord[]>;
+    /** Delete a cron schedule by ID. */
+    removeCronSchedule(id: number): Promise<void>;
+    /** Pause a cron schedule. */
+    pauseCronSchedule(id: number): Promise<void>;
+    /** Resume a paused cron schedule. */
+    resumeCronSchedule(id: number): Promise<void>;
+    /** Edit a cron schedule. */
+    editCronSchedule(id: number, updates: EditCronScheduleOptions, nextRunAt?: Date | null): Promise<void>;
+    /**
+     * Atomically fetch all active cron schedules whose nextRunAt <= NOW().
+     * Uses FOR UPDATE SKIP LOCKED to prevent duplicate enqueuing across workers.
+     */
+    getDueCronSchedules(): Promise<CronScheduleRecord[]>;
+    /**
+     * Update a cron schedule after a job has been enqueued.
+     * Sets lastEnqueuedAt, lastJobId, and advances nextRunAt.
+     */
+    updateCronScheduleAfterEnqueue(id: number, lastEnqueuedAt: Date, lastJobId: number, nextRunAt: Date | null): Promise<void>;
     setPendingReasonForUnpickedJobs(reason: string, jobType?: string | string[]): Promise<void>;
 }
 
@@ -863,6 +1059,25 @@ declare function testHandlerSerialization<PayloadMap, T extends keyof PayloadMap
     error?: string;
 }>;
 
+/**
+ * Calculate the next occurrence of a cron expression after a given date.
+ *
+ * @param cronExpression - A standard cron expression (5 fields, e.g. "0 * * * *").
+ * @param timezone - IANA timezone string (default: "UTC").
+ * @param after - The reference date to compute the next run from (default: now).
+ * @param CronImpl - Cron class for dependency injection (default: croner's Cron).
+ * @returns The next occurrence as a Date, or null if the expression will never fire again.
+ */
+declare function getNextCronOccurrence(cronExpression: string, timezone?: string, after?: Date, CronImpl?: typeof Cron): Date | null;
+/**
+ * Validate whether a string is a syntactically correct cron expression.
+ *
+ * @param cronExpression - The cron expression to validate.
+ * @param CronImpl - Cron class for dependency injection (default: croner's Cron).
+ * @returns True if the expression is valid, false otherwise.
+ */
+declare function validateCronExpression(cronExpression: string, CronImpl?: typeof Cron): boolean;
+
 /**
  * Initialize the job queue system.
  *
@@ -870,4 +1085,4 @@ declare function testHandlerSerialization<PayloadMap, T extends keyof PayloadMap
  */
 declare const initJobQueue: <PayloadMap = any>(config: JobQueueConfig) => JobQueue<PayloadMap>;
 
-export { type CreateTokenOptions, type DatabaseSSLConfig, type EditJobOptions, FailureReason, type JobContext, type JobEvent, JobEventType, type JobHandler, type JobHandlers, type JobOptions, type JobQueue, type JobQueueConfig, type JobQueueConfigLegacy, type JobRecord, type JobStatus, type JobType, type OnTimeoutCallback, PostgresBackend, type PostgresJobQueueConfig, type Processor, type ProcessorOptions, type QueueBackend, type RedisJobQueueConfig, type RedisTLSConfig, type TagQueryMode, type WaitDuration, WaitSignal, type WaitToken, type WaitTokenResult, type WaitpointRecord, type WaitpointStatus, initJobQueue, testHandlerSerialization, validateHandlerSerializable };
+export { type CreateTokenOptions, type CronScheduleInput, type CronScheduleOptions, type CronScheduleRecord, type CronScheduleStatus, type DatabaseSSLConfig, type EditCronScheduleOptions, type EditJobOptions, FailureReason, type JobContext, type JobEvent, JobEventType, type JobHandler, type JobHandlers, type JobOptions, type JobQueue, type JobQueueConfig, type JobQueueConfigLegacy, type JobRecord, type JobStatus, type JobType, type OnTimeoutCallback, PostgresBackend, type PostgresJobQueueConfig, type Processor, type ProcessorOptions, type QueueBackend, type RedisJobQueueConfig, type RedisTLSConfig, type TagQueryMode, type WaitDuration, WaitSignal, type WaitToken, type WaitTokenResult, type WaitpointRecord, type WaitpointStatus, getNextCronOccurrence, initJobQueue, testHandlerSerialization, validateCronExpression, validateHandlerSerializable };

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 import * as pg from 'pg';
 import { Pool } from 'pg';
+import { Cron } from 'croner';
 
 type JobType<PayloadMap> = keyof PayloadMap & string;
 interface JobOptions<PayloadMap, T extends JobType<PayloadMap>> {
@@ -490,6 +491,81 @@ type JobQueueConfig = PostgresJobQueueConfig | RedisJobQueueConfig;
 /** @deprecated Use JobQueueConfig instead. Alias kept for backward compat. */
 type JobQueueConfigLegacy = PostgresJobQueueConfig;
 type TagQueryMode = 'exact' | 'all' | 'any' | 'none';
+/**
+ * Status of a cron schedule.
+ */
+type CronScheduleStatus = 'active' | 'paused';
+/**
+ * Options for creating a recurring cron schedule.
+ * Each schedule defines a recurring job that is automatically enqueued
+ * when its cron expression matches.
+ */
+interface CronScheduleOptions<PayloadMap, T extends JobType<PayloadMap>> {
+    /** Unique human-readable name for the schedule. */
+    scheduleName: string;
+    /** Standard cron expression (5 fields, e.g. "0 * * * *"). */
+    cronExpression: string;
+    /** Job type from the PayloadMap. */
+    jobType: T;
+    /** Payload for each job instance. */
+    payload: PayloadMap[T];
+    /** Maximum retry attempts for each job instance (default: 3). */
+    maxAttempts?: number;
+    /** Priority for each job instance (default: 0). */
+    priority?: number;
+    /** Timeout in milliseconds for each job instance. */
+    timeoutMs?: number;
+    /** Whether to force-kill the job on timeout (default: false). */
+    forceKillOnTimeout?: boolean;
+    /** Tags for each job instance. */
+    tags?: string[];
+    /** IANA timezone string for cron evaluation (default: "UTC"). */
+    timezone?: string;
+    /**
+     * Whether to allow overlapping job instances (default: false).
+     * When false, a new job will not be enqueued if the previous instance
+     * is still pending, processing, or waiting.
+     */
+    allowOverlap?: boolean;
+}
+/**
+ * A persisted cron schedule record.
+ */
+interface CronScheduleRecord {
+    id: number;
+    scheduleName: string;
+    cronExpression: string;
+    jobType: string;
+    payload: any;
+    maxAttempts: number;
+    priority: number;
+    timeoutMs: number | null;
+    forceKillOnTimeout: boolean;
+    tags: string[] | undefined;
+    timezone: string;
+    allowOverlap: boolean;
+    status: CronScheduleStatus;
+    lastEnqueuedAt: Date | null;
+    lastJobId: number | null;
+    nextRunAt: Date | null;
+    createdAt: Date;
+    updatedAt: Date;
+}
+/**
+ * Options for editing an existing cron schedule.
+ * All fields are optional; only provided fields are updated.
+ */
+interface EditCronScheduleOptions {
+    cronExpression?: string;
+    payload?: any;
+    maxAttempts?: number;
+    priority?: number;
+    timeoutMs?: number | null;
+    forceKillOnTimeout?: boolean;
+    tags?: string[] | null;
+    timezone?: string;
+    allowOverlap?: boolean;
+}
 interface JobQueue<PayloadMap> {
     /**
      * Add a job to the job queue.
@@ -676,6 +752,56 @@ interface JobQueue<PayloadMap> {
      * @returns The number of tokens that were expired.
      */
     expireTimedOutTokens: () => Promise<number>;
+    /**
+     * Add a recurring cron schedule. The processor automatically enqueues
+     * due cron jobs before each batch, so no manual triggering is needed.
+     *
+     * @returns The ID of the created schedule.
+     * @throws If the cron expression is invalid or the schedule name is already taken.
+     */
+    addCronJob: <T extends JobType<PayloadMap>>(options: CronScheduleOptions<PayloadMap, T>) => Promise<number>;
+    /**
+     * Get a cron schedule by its ID.
+     */
+    getCronJob: (id: number) => Promise<CronScheduleRecord | null>;
+    /**
+     * Get a cron schedule by its unique name.
+     */
+    getCronJobByName: (name: string) => Promise<CronScheduleRecord | null>;
+    /**
+     * List all cron schedules, optionally filtered by status.
+     */
+    listCronJobs: (status?: CronScheduleStatus) => Promise<CronScheduleRecord[]>;
+    /**
+     * Remove a cron schedule by its ID. Does not cancel any already-enqueued jobs.
+     */
+    removeCronJob: (id: number) => Promise<void>;
+    /**
+     * Pause a cron schedule. Paused schedules are skipped by `enqueueDueCronJobs()`.
+     */
+    pauseCronJob: (id: number) => Promise<void>;
+    /**
+     * Resume a paused cron schedule.
+     */
+    resumeCronJob: (id: number) => Promise<void>;
+    /**
+     * Edit an existing cron schedule. Only provided fields are updated.
+     * If `cronExpression` or `timezone` changes, `nextRunAt` is recalculated.
+     */
+    editCronJob: (id: number, updates: EditCronScheduleOptions) => Promise<void>;
+    /**
+     * Check all active cron schedules and enqueue jobs for any whose
+     * `nextRunAt` has passed. When `allowOverlap` is false (the default),
+     * a new job is not enqueued if the previous instance is still
+     * pending, processing, or waiting.
+     *
+     * **Note:** The processor calls this automatically before each batch,
+     * so you typically do not need to call it yourself. It is exposed for
+     * manual use in tests or one-off scripts.
+     *
+     * @returns The number of jobs that were enqueued.
+     */
+    enqueueDueCronJobs: () => Promise<number>;
     /**
      * Get the PostgreSQL database pool.
      * Throws if the backend is not PostgreSQL.
@@ -723,6 +849,24 @@ interface JobUpdates {
     timeoutMs?: number | null;
     tags?: string[] | null;
 }
+/**
+ * Input shape for creating a cron schedule in the backend.
+ * This is the backend-level version of CronScheduleOptions.
+ */
+interface CronScheduleInput {
+    scheduleName: string;
+    cronExpression: string;
+    jobType: string;
+    payload: any;
+    maxAttempts: number;
+    priority: number;
+    timeoutMs: number | null;
+    forceKillOnTimeout: boolean;
+    tags: string[] | undefined;
+    timezone: string;
+    allowOverlap: boolean;
+    nextRunAt: Date | null;
+}
 /**
  * Abstract backend interface that both PostgreSQL and Redis implement.
  * All storage operations go through this interface so the processor
@@ -774,6 +918,32 @@ interface QueueBackend {
     recordJobEvent(jobId: number, eventType: JobEventType, metadata?: any): Promise<void>;
     /** Get all events for a job, ordered by createdAt ASC. */
     getJobEvents(jobId: number): Promise<JobEvent[]>;
+    /** Create a cron schedule and return its ID. */
+    addCronSchedule(input: CronScheduleInput): Promise<number>;
+    /** Get a cron schedule by ID, or null if not found. */
+    getCronSchedule(id: number): Promise<CronScheduleRecord | null>;
+    /** Get a cron schedule by its unique name, or null if not found. */
+    getCronScheduleByName(name: string): Promise<CronScheduleRecord | null>;
+    /** List cron schedules, optionally filtered by status. */
+    listCronSchedules(status?: CronScheduleStatus): Promise<CronScheduleRecord[]>;
+    /** Delete a cron schedule by ID. */
+    removeCronSchedule(id: number): Promise<void>;
+    /** Pause a cron schedule. */
+    pauseCronSchedule(id: number): Promise<void>;
+    /** Resume a cron schedule. */
+    resumeCronSchedule(id: number): Promise<void>;
+    /** Edit a cron schedule. */
+    editCronSchedule(id: number, updates: EditCronScheduleOptions, nextRunAt?: Date | null): Promise<void>;
+    /**
+     * Atomically fetch all active cron schedules whose nextRunAt <= now.
+     * In PostgreSQL this uses FOR UPDATE SKIP LOCKED to prevent duplicate enqueuing.
+     */
+    getDueCronSchedules(): Promise<CronScheduleRecord[]>;
+    /**
+     * Update a cron schedule after a job has been enqueued.
+     * Sets lastEnqueuedAt, lastJobId, and advances nextRunAt.
+     */
+    updateCronScheduleAfterEnqueue(id: number, lastEnqueuedAt: Date, lastJobId: number, nextRunAt: Date | null): Promise<void>;
     /** Set a pending reason for unpicked jobs of a given type. */
     setPendingReasonForUnpickedJobs(reason: string, jobType?: string | string[]): Promise<void>;
 }
@@ -809,6 +979,32 @@ declare class PostgresBackend implements QueueBackend {
      * More efficient than individual recordJobEvent calls.
      */
     private recordJobEventsBatch;
+    /** Create a cron schedule and return its ID. */
+    addCronSchedule(input: CronScheduleInput): Promise<number>;
+    /** Get a cron schedule by ID. */
+    getCronSchedule(id: number): Promise<CronScheduleRecord | null>;
+    /** Get a cron schedule by its unique name. */
+    getCronScheduleByName(name: string): Promise<CronScheduleRecord | null>;
+    /** List cron schedules, optionally filtered by status. */
+    listCronSchedules(status?: CronScheduleStatus): Promise<CronScheduleRecord[]>;
+    /** Delete a cron schedule by ID. */
+    removeCronSchedule(id: number): Promise<void>;
+    /** Pause a cron schedule. */
+    pauseCronSchedule(id: number): Promise<void>;
+    /** Resume a paused cron schedule. */
+    resumeCronSchedule(id: number): Promise<void>;
+    /** Edit a cron schedule. */
+    editCronSchedule(id: number, updates: EditCronScheduleOptions, nextRunAt?: Date | null): Promise<void>;
+    /**
+     * Atomically fetch all active cron schedules whose nextRunAt <= NOW().
+     * Uses FOR UPDATE SKIP LOCKED to prevent duplicate enqueuing across workers.
+     */
+    getDueCronSchedules(): Promise<CronScheduleRecord[]>;
+    /**
+     * Update a cron schedule after a job has been enqueued.
+     * Sets lastEnqueuedAt, lastJobId, and advances nextRunAt.
+     */
+    updateCronScheduleAfterEnqueue(id: number, lastEnqueuedAt: Date, lastJobId: number, nextRunAt: Date | null): Promise<void>;
     setPendingReasonForUnpickedJobs(reason: string, jobType?: string | string[]): Promise<void>;
 }
 
@@ -863,6 +1059,25 @@ declare function testHandlerSerialization<PayloadMap, T extends keyof PayloadMap
     error?: string;
 }>;
 
+/**
+ * Calculate the next occurrence of a cron expression after a given date.
+ *
+ * @param cronExpression - A standard cron expression (5 fields, e.g. "0 * * * *").
+ * @param timezone - IANA timezone string (default: "UTC").
+ * @param after - The reference date to compute the next run from (default: now).
+ * @param CronImpl - Cron class for dependency injection (default: croner's Cron).
+ * @returns The next occurrence as a Date, or null if the expression will never fire again.
+ */
+declare function getNextCronOccurrence(cronExpression: string, timezone?: string, after?: Date, CronImpl?: typeof Cron): Date | null;
+/**
+ * Validate whether a string is a syntactically correct cron expression.
+ *
+ * @param cronExpression - The cron expression to validate.
+ * @param CronImpl - Cron class for dependency injection (default: croner's Cron).
+ * @returns True if the expression is valid, false otherwise.
+ */
+declare function validateCronExpression(cronExpression: string, CronImpl?: typeof Cron): boolean;
+
 /**
  * Initialize the job queue system.
  *
@@ -870,4 +1085,4 @@ declare function testHandlerSerialization<PayloadMap, T extends keyof PayloadMap
  */
 declare const initJobQueue: <PayloadMap = any>(config: JobQueueConfig) => JobQueue<PayloadMap>;
 
-export { type CreateTokenOptions, type DatabaseSSLConfig, type EditJobOptions, FailureReason, type JobContext, type JobEvent, JobEventType, type JobHandler, type JobHandlers, type JobOptions, type JobQueue, type JobQueueConfig, type JobQueueConfigLegacy, type JobRecord, type JobStatus, type JobType, type OnTimeoutCallback, PostgresBackend, type PostgresJobQueueConfig, type Processor, type ProcessorOptions, type QueueBackend, type RedisJobQueueConfig, type RedisTLSConfig, type TagQueryMode, type WaitDuration, WaitSignal, type WaitToken, type WaitTokenResult, type WaitpointRecord, type WaitpointStatus, initJobQueue, testHandlerSerialization, validateHandlerSerializable };
+export { type CreateTokenOptions, type CronScheduleInput, type CronScheduleOptions, type CronScheduleRecord, type CronScheduleStatus, type DatabaseSSLConfig, type EditCronScheduleOptions, type EditJobOptions, FailureReason, type JobContext, type JobEvent, JobEventType, type JobHandler, type JobHandlers, type JobOptions, type JobQueue, type JobQueueConfig, type JobQueueConfigLegacy, type JobRecord, type JobStatus, type JobType, type OnTimeoutCallback, PostgresBackend, type PostgresJobQueueConfig, type Processor, type ProcessorOptions, type QueueBackend, type RedisJobQueueConfig, type RedisTLSConfig, type TagQueryMode, type WaitDuration, WaitSignal, type WaitToken, type WaitTokenResult, type WaitpointRecord, type WaitpointStatus, getNextCronOccurrence, initJobQueue, testHandlerSerialization, validateCronExpression, validateHandlerSerializable };