@boringnode/queue 0.0.1-alpha.3 → 0.1.0

package/README.md

@@ -1,5 +1,15 @@
 # @boringnode/queue
 
+<div align="center">
+
+[![typescript-image]][typescript-url]
+[![gh-workflow-image]][gh-workflow-url]
+[![npm-image]][npm-url]
+[![npm-download-image]][npm-download-url]
+[![license-image]][license-url]
+
+</div>
+
 A simple and efficient queue system for Node.js applications. Built for simplicity and ease of use, `@boringnode/queue` allows you to dispatch background jobs and process them asynchronously with support for multiple queue adapters.
 
 ## Installation
@@ -19,6 +29,7 @@ npm install @boringnode/queue
 - **Priority Queues**: Process high-priority jobs first
 - **Retry with Backoff**: Automatic retries with exponential, linear, or fixed backoff strategies
 - **Job Timeout**: Automatically fail or retry jobs that exceed a time limit
+- **Scheduled Jobs**: Cron-based or interval-based job scheduling with pause/resume support
 
 ## Quick Start
 
@@ -28,7 +39,7 @@ Create a job by extending the `Job` class:
 
 ```typescript
 import { Job } from '@boringnode/queue'
-import type { JobOptions } from '@boringnode/queue/types/main'
+import type { JobContext, JobOptions } from '@boringnode/queue/types'
 
 interface SendEmailPayload {
   to: string
@@ -42,7 +53,7 @@ export default class SendEmailJob extends Job<SendEmailPayload> {
   }
 
   async execute(): Promise<void> {
-    console.log(`Sending email to: ${this.payload.to}`)
+    console.log(`[Attempt ${this.context.attempt}] Sending email to: ${this.payload.to}`)
   }
 }
 ```
@@ -72,7 +83,7 @@ const config = {
 
   worker: {
     concurrency: 5,
-    pollingInterval: '10ms',
+    idleDelay: '2s',
   },
 
   locations: ['./app/jobs/**/*.ts'],
@@ -121,7 +132,7 @@ interface QueueManagerConfig {
   // Worker configuration
   worker: {
     concurrency: number
-    pollingInterval: string
+    idleDelay: Duration
   }
 
   // Job discovery locations
@@ -227,10 +238,10 @@ Schedule jobs to run in the future:
 
 ```typescript
 // Various time formats
-await SendEmailJob.dispatch(payload).in('30s')  // 30 seconds
-await SendEmailJob.dispatch(payload).in('5m')   // 5 minutes
-await SendEmailJob.dispatch(payload).in('2h')   // 2 hours
-await SendEmailJob.dispatch(payload).in('1d')   // 1 day
+await SendEmailJob.dispatch(payload).in('30s') // 30 seconds
+await SendEmailJob.dispatch(payload).in('5m')  // 5 minutes
+await SendEmailJob.dispatch(payload).in('2h')  // 2 hours
+await SendEmailJob.dispatch(payload).in('1d')  // 1 day
 ```
 
 ## Priority
@@ -242,7 +253,7 @@ export default class UrgentJob extends Job<Payload> {
   static readonly jobName = 'UrgentJob'
 
   static options: JobOptions = {
-    priority: 1,  // Processed before default priority (5)
+    priority: 1, // Processed before default priority (5)
   }
 
   async execute(): Promise<void> {
@@ -264,12 +275,13 @@ export default class ReliableJob extends Job<Payload> {
   static options: JobOptions = {
     maxRetries: 5,
     retry: {
-      backoff: () => exponentialBackoff({
-        baseDelay: '1s',
-        maxDelay: '1m',
-        multiplier: 2,
-        jitter: true,
-      }),
+      backoff: () =>
+        exponentialBackoff({
+          baseDelay: '1s',
+          maxDelay: '1m',
+          multiplier: 2,
+          jitter: true,
+        }),
     },
   }
 
@@ -294,7 +306,7 @@ export default class LimitedJob extends Job<Payload> {
   static readonly jobName = 'LimitedJob'
 
   static options: JobOptions = {
-    timeout: '30s',       // Maximum execution time
+    timeout: '30s', // Maximum execution time
     failOnTimeout: false, // Retry on timeout (default)
   }
 
@@ -309,48 +321,245 @@ You can also set a global timeout in the worker configuration:
 ```typescript
 const config = {
   worker: {
-    timeout: '1m',  // Default timeout for all jobs
+    timeout: '1m', // Default timeout for all jobs
   },
 }
 ```
 
+## Job Context
+
+Every job has access to execution context via `this.context`. This provides metadata about the current job execution:
+
+```typescript
+import { Job } from '@boringnode/queue'
+import type { JobContext } from '@boringnode/queue'
+
+export default class MyJob extends Job<Payload> {
+  constructor(payload: Payload, context: JobContext) {
+    super(payload, context)
+  }
+
+  async execute(): Promise<void> {
+    console.log(`Job ID: ${this.context.jobId}`)
+    console.log(`Attempt: ${this.context.attempt}`) // 1, 2, 3...
+    console.log(`Queue: ${this.context.queue}`)
+    console.log(`Priority: ${this.context.priority}`)
+    console.log(`Acquired at: ${this.context.acquiredAt}`)
+
+    if (this.context.attempt > 1) {
+      console.log('This is a retry!')
+    }
+  }
+}
+```
+
+### Context Properties
+
+| Property       | Type   | Description                                     |
+|----------------|--------|-------------------------------------------------|
+| `jobId`        | string | Unique identifier for this job                  |
+| `name`         | string | Job class name                                  |
+| `attempt`      | number | Current attempt number (1-based)                |
+| `queue`        | string | Queue name this job is being processed from     |
+| `priority`     | number | Job priority (lower = higher priority)          |
+| `acquiredAt`   | Date   | When this job was acquired by the worker        |
+| `stalledCount` | number | Times this job was recovered from stalled state |
+
+## Dependency Injection
+
+Use the `jobFactory` option to integrate with IoC containers for dependency injection. This allows your jobs to receive injected services in their constructor.
+
+```typescript
+import { QueueManager } from '@boringnode/queue'
+
+await QueueManager.init({
+  default: 'redis',
+  adapters: { redis: redis(connection) },
+  jobFactory: async (JobClass, payload, context) => {
+    // Use your IoC container to instantiate jobs
+    return app.container.make(JobClass, [payload, context])
+  },
+})
+```
+
+Example with injected dependencies:
+
+```typescript
+import { Job } from '@boringnode/queue'
+import type { JobContext } from '@boringnode/queue'
+
+interface SendEmailPayload {
+  to: string
+  subject: string
+}
+
+export default class SendEmailJob extends Job<SendEmailPayload> {
+  static readonly jobName = 'SendEmailJob'
+
+  constructor(
+    payload: SendEmailPayload,
+    context: JobContext,
+    private mailer: MailerService, // Injected by IoC container
+    private logger: Logger // Injected by IoC container
+  ) {
+    super(payload, context)
+  }
+
+  async execute(): Promise<void> {
+    this.logger.info(`[Attempt ${this.context.attempt}] Sending email to ${this.payload.to}`)
+    await this.mailer.send(this.payload)
+  }
+}
+```
+
+Without a `jobFactory`, jobs are instantiated with `new JobClass(payload, context)`.
+
+## Scheduled Jobs
+
+Schedule jobs to run on a recurring basis using cron expressions or fixed intervals. Schedules are persisted and survive worker restarts.
+
+### Creating a Schedule
+
+```typescript
+import { Schedule } from '@boringnode/queue'
+
+// Run every 10 seconds (uses job name as schedule ID by default)
+const { scheduleId } = await MetricsJob.schedule({ endpoint: '/api/health' }).every('10s').run()
+
+// Run on a cron schedule with custom ID
+await CleanupJob.schedule({ days: 30 })
+  .id('daily-cleanup') // Custom ID (optional, defaults to job name)
+  .cron('0 * * * *') // Every hour at minute 0
+  .timezone('Europe/Paris') // Optional timezone (default: UTC)
+  .run()
+
+// Schedule with constraints
+await ReportJob.schedule({ type: 'weekly' })
+  .id('weekly-report')
+  .cron('0 9 * * MON') // Every Monday at 9am
+  .from(new Date('2024-01-01')) // Start date
+  .to(new Date('2024-12-31')) // End date
+  .limit(52) // Maximum 52 runs
+  .run()
+```
+
+### Managing Schedules
+
+```typescript
+import { Schedule } from '@boringnode/queue'
+
+// Find a schedule by ID
+const schedule = await Schedule.find('health-check')
+
+if (schedule) {
+  console.log(`Status: ${schedule.status}`) // 'active' or 'paused'
+  console.log(`Run count: ${schedule.runCount}`)
+  console.log(`Next run: ${schedule.nextRunAt}`)
+  console.log(`Last run: ${schedule.lastRunAt}`)
+
+  // Pause the schedule
+  await schedule.pause()
+
+  // Resume the schedule
+  await schedule.resume()
+
+  // Trigger an immediate run (outside of the normal schedule)
+  await schedule.trigger()
+
+  // Delete the schedule
+  await schedule.delete()
+}
+```
+
+### Listing Schedules
+
+```typescript
+import { Schedule } from '@boringnode/queue'
+
+// List all schedules
+const all = await Schedule.list()
+
+// Filter by status
+const active = await Schedule.list({ status: 'active' })
+const paused = await Schedule.list({ status: 'paused' })
+```
+
+### Schedule Options
+
+| Method               | Description                                     |
+|----------------------|-------------------------------------------------|
+| `.id(string)`        | Unique identifier (defaults to job name)        |
+| `.every(duration)`   | Run at fixed intervals ('5s', '1m', '1h', '1d') |
+| `.cron(expression)`  | Run on a cron schedule                          |
+| `.timezone(tz)`      | Timezone for cron expressions (default: 'UTC')  |
+| `.from(date)`        | Don't run before this date                      |
+| `.to(date)`          | Don't run after this date                       |
+| `.between(from, to)` | Shorthand for `.from().to()`                    |
+| `.limit(n)`          | Maximum number of runs                          |
+
+### How Scheduling Works
+
+- Schedules are **persisted** in the database (via the adapter)
+- The **Worker** polls for due schedules and dispatches jobs automatically
+- Each schedule run creates a **new job** with a unique ID
+- Multiple workers can run concurrently - only one will claim each due schedule
+- Failed jobs do **not** affect the schedule (the next run will still occur)
+
 ## Job Discovery
 
 The queue manager automatically discovers and registers jobs from the specified locations:
 
 ```typescript
 const config = {
-  locations: [
-    './app/jobs/**/*.ts',
-    './modules/**/jobs/**/*.ts',
-  ],
+  locations: ['./app/jobs/**/*.ts', './modules/**/jobs/**/*.ts'],
 }
 ```
 
 Jobs must:
+
 - Extend the `Job` class
 - Have a static `jobName` property
 - Implement the `execute` method
 - Be exported as default
 
+## Logging
+
+You can pass a logger to the queue manager for debugging or monitoring. The logger must be compatible with the [pino](https://github.com/pinojs/pino) interface.
+
+```typescript
+import { pino } from 'pino'
+
+const config = {
+  default: 'redis',
+  adapters: {
+    /* ... */
+  },
+  logger: pino(),
+}
+
+await QueueManager.init(config)
+```
+
+By default, a simple console logger is used that only outputs warnings and errors.
+
 ## Benchmarks
 
 Performance comparison with BullMQ using realistic jobs (5ms simulated work per job):
 
-| Jobs | Concurrency | @boringnode/queue | BullMQ | Diff         |
-|------|-------------|-------------------|--------|--------------|
-| 100  | 1           | 562ms             | 596ms  | 5.7% faster  |
-| 100  | 5           | 116ms             | 117ms  | ~same        |
-| 100  | 10          | 62ms              | 62ms   | ~same        |
-| 500  | 1           | 2728ms            | 2798ms | 2.5% faster  |
-| 500  | 5           | 565ms             | 565ms  | ~same        |
-| 500  | 10          | 287ms             | 288ms  | ~same        |
-| 1000 | 1           | 5450ms            | 5547ms | 1.7% faster  |
-| 1000 | 5           | 1096ms            | 1116ms | 1.8% faster  |
-| 1000 | 10          | 565ms             | 579ms  | 2.4% faster  |
-| 100K | 5           | 110.5s            | 112.3s | 1.5% faster  |
-| 100K | 10          | 56.2s             | 57.5s  | 2.1% faster  |
-| 100K | 20          | 29.1s             | 29.6s  | 1.7% faster  |
+| Jobs | Concurrency | @boringnode/queue | BullMQ | Diff        |
+|------|-------------|-------------------|--------|-------------|
+| 100  | 1           | 562ms             | 596ms  | 5.7% faster |
+| 100  | 5           | 116ms             | 117ms  | ~same       |
+| 100  | 10          | 62ms              | 62ms   | ~same       |
+| 500  | 1           | 2728ms            | 2798ms | 2.5% faster |
+| 500  | 5           | 565ms             | 565ms  | ~same       |
+| 500  | 10          | 287ms             | 288ms  | ~same       |
+| 1000 | 1           | 5450ms            | 5547ms | 1.7% faster |
+| 1000 | 5           | 1096ms            | 1116ms | 1.8% faster |
+| 1000 | 10          | 565ms             | 579ms  | 2.4% faster |
+| 100K | 5           | 110.5s            | 112.3s | 1.5% faster |
+| 100K | 10          | 56.2s             | 57.5s  | 2.1% faster |
+| 100K | 20          | 29.1s             | 29.6s  | 1.7% faster |
 
 Run benchmarks yourself:
 
@@ -364,3 +573,14 @@ npm run benchmark
 # Custom job duration
 npm run benchmark -- --duration=10
 ```
+
+[gh-workflow-image]: https://img.shields.io/github/actions/workflow/status/boringnode/queue/checks.yml?branch=main&style=for-the-badge
+[gh-workflow-url]: https://github.com/boringnode/queue/actions/workflows/checks.yml
+[npm-image]: https://img.shields.io/npm/v/@boringnode/queue.svg?style=for-the-badge&logo=npm
+[npm-url]: https://www.npmjs.com/package/@boringnode/queue
+[npm-download-image]: https://img.shields.io/npm/dm/@boringnode/queue?style=for-the-badge
+[npm-download-url]: https://www.npmjs.com/package/@boringnode/queue
+[typescript-image]: https://img.shields.io/badge/Typescript-294E80.svg?style=for-the-badge&logo=typescript
+[typescript-url]: https://www.typescriptlang.org
+[license-image]: https://img.shields.io/npm/l/@boringnode/queue?color=blueviolet&style=for-the-badge
+[license-url]: LICENSE.md

package/build/chunk-NPQKBCCY.js

@@ -0,0 +1,26 @@
+import {
+  E_INVALID_DURATION_EXPRESSION,
+  PRIORITY_SCORE_MULTIPLIER
+} from "./chunk-SMOKFZ46.js";
+
+// src/utils.ts
+import { parse as parseDuration } from "@lukeed/ms";
+function parse(duration) {
+  if (typeof duration === "number") {
+    return duration;
+  }
+  const milliseconds = parseDuration(duration);
+  if (typeof milliseconds === "undefined") {
+    throw new E_INVALID_DURATION_EXPRESSION([duration]);
+  }
+  return milliseconds;
+}
+function calculateScore(priority, timestamp) {
+  return priority * PRIORITY_SCORE_MULTIPLIER + timestamp;
+}
+
+export {
+  parse,
+  calculateScore
+};
+//# sourceMappingURL=chunk-NPQKBCCY.js.map

package/build/chunk-NPQKBCCY.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/utils.ts"],"sourcesContent":["import { parse as parseDuration } from '@lukeed/ms'\nimport type { Duration } from './types/main.js'\nimport * as errors from './exceptions.js'\nimport { PRIORITY_SCORE_MULTIPLIER } from './constants.js'\n\nexport function parse(duration: Duration): number {\n  if (typeof duration === 'number') {\n    return duration\n  }\n\n  const milliseconds = parseDuration(duration)\n\n  if (typeof milliseconds === 'undefined') {\n    throw new errors.E_INVALID_DURATION_EXPRESSION([duration])\n  }\n\n  return milliseconds\n}\n\n/**\n * Calculate the score for job ordering in the queue.\n * Lower scores are processed first.\n *\n * @param priority - Job priority (1-10, lower = higher priority)\n * @param timestamp - Timestamp in milliseconds\n * @returns Score for queue ordering\n */\nexport function calculateScore(priority: number, timestamp: number): number {\n  return priority * PRIORITY_SCORE_MULTIPLIER + timestamp\n}\n"],"mappings":";;;;;;AAAA,SAAS,SAAS,qBAAqB;AAKhC,SAAS,MAAM,UAA4B;AAChD,MAAI,OAAO,aAAa,UAAU;AAChC,WAAO;AAAA,EACT;AAEA,QAAM,eAAe,cAAc,QAAQ;AAE3C,MAAI,OAAO,iBAAiB,aAAa;AACvC,UAAM,IAAW,8BAA8B,CAAC,QAAQ,CAAC;AAAA,EAC3D;AAEA,SAAO;AACT;AAUO,SAAS,eAAe,UAAkB,WAA2B;AAC1E,SAAO,WAAW,4BAA4B;AAChD;","names":[]}

package/build/chunk-SMOKFZ46.js

@@ -0,0 +1,117 @@
+var __defProp = Object.defineProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+
+// src/exceptions.ts
+var exceptions_exports = {};
+__export(exceptions_exports, {
+  E_ADAPTER_INIT_ERROR: () => E_ADAPTER_INIT_ERROR,
+  E_CONFIGURATION_ERROR: () => E_CONFIGURATION_ERROR,
+  E_INVALID_BASE_DELAY: () => E_INVALID_BASE_DELAY,
+  E_INVALID_CRON_EXPRESSION: () => E_INVALID_CRON_EXPRESSION,
+  E_INVALID_DURATION_EXPRESSION: () => E_INVALID_DURATION_EXPRESSION,
+  E_INVALID_MAX_DELAY: () => E_INVALID_MAX_DELAY,
+  E_INVALID_MULTIPLIER: () => E_INVALID_MULTIPLIER,
+  E_INVALID_SCHEDULE_CONFIG: () => E_INVALID_SCHEDULE_CONFIG,
+  E_JOB_MAX_ATTEMPTS_REACHED: () => E_JOB_MAX_ATTEMPTS_REACHED,
+  E_JOB_NOT_FOUND: () => E_JOB_NOT_FOUND,
+  E_JOB_TIMEOUT: () => E_JOB_TIMEOUT,
+  E_NO_JOBS_FOUND: () => E_NO_JOBS_FOUND,
+  E_QUEUE_NOT_INITIALIZED: () => E_QUEUE_NOT_INITIALIZED
+});
+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"
+);
+var E_QUEUE_NOT_INITIALIZED = createError(
+  "QueueManager is not initialized. Call QueueManager.init() before using it.",
+  "E_QUEUE_NOT_INITIALIZED",
+  500
+);
+var E_ADAPTER_INIT_ERROR = createError(
+  'Failed to initialize adapter "%s". Reason: %s',
+  "E_ADAPTER_INIT_ERROR",
+  500
+);
+var E_NO_JOBS_FOUND = createError(
+  "No jobs found for the specified locations: %s. Verify your glob patterns match your job files.",
+  "E_NO_JOBS_FOUND",
+  500
+);
+var E_INVALID_CRON_EXPRESSION = createError(
+  'Invalid cron expression "%s": %s',
+  "E_INVALID_CRON_EXPRESSION",
+  500
+);
+var E_INVALID_SCHEDULE_CONFIG = createError(
+  "Invalid schedule configuration: %s",
+  "E_INVALID_SCHEDULE_CONFIG",
+  500
+);
+
+// src/constants.ts
+var DEFAULT_PRIORITY = 5;
+var PRIORITY_SCORE_MULTIPLIER = 1e13;
+var DEFAULT_IDLE_DELAY = "2s";
+var DEFAULT_STALLED_INTERVAL = "30s";
+var DEFAULT_STALLED_THRESHOLD = "30s";
+var DEFAULT_ERROR_RETRY_DELAY = "5s";
+
+export {
+  E_INVALID_DURATION_EXPRESSION,
+  E_INVALID_BASE_DELAY,
+  E_INVALID_MAX_DELAY,
+  E_INVALID_MULTIPLIER,
+  E_CONFIGURATION_ERROR,
+  E_JOB_NOT_FOUND,
+  E_JOB_MAX_ATTEMPTS_REACHED,
+  E_JOB_TIMEOUT,
+  E_QUEUE_NOT_INITIALIZED,
+  E_ADAPTER_INIT_ERROR,
+  E_INVALID_CRON_EXPRESSION,
+  E_INVALID_SCHEDULE_CONFIG,
+  exceptions_exports,
+  DEFAULT_PRIORITY,
+  PRIORITY_SCORE_MULTIPLIER,
+  DEFAULT_IDLE_DELAY,
+  DEFAULT_STALLED_INTERVAL,
+  DEFAULT_STALLED_THRESHOLD,
+  DEFAULT_ERROR_RETRY_DELAY
+};
+//# sourceMappingURL=chunk-SMOKFZ46.js.map

package/build/chunk-SMOKFZ46.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/exceptions.ts","../src/constants.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\nexport const E_QUEUE_NOT_INITIALIZED = createError(\n  'QueueManager is not initialized. Call QueueManager.init() before using it.',\n  'E_QUEUE_NOT_INITIALIZED',\n  500\n)\n\nexport const E_ADAPTER_INIT_ERROR = createError<[adapterName: string, originalMessage: string]>(\n  'Failed to initialize adapter \"%s\". Reason: %s',\n  'E_ADAPTER_INIT_ERROR',\n  500\n)\n\nexport const E_NO_JOBS_FOUND = createError<[patterns: string]>(\n  'No jobs found for the specified locations: %s. Verify your glob patterns match your job files.',\n  'E_NO_JOBS_FOUND',\n  500\n)\n\nexport const E_INVALID_CRON_EXPRESSION = createError<[expression: string, reason: string]>(\n  'Invalid cron expression \"%s\": %s',\n  'E_INVALID_CRON_EXPRESSION',\n  500\n)\n\nexport const E_INVALID_SCHEDULE_CONFIG = createError<[reason: string]>(\n  'Invalid schedule configuration: %s',\n  'E_INVALID_SCHEDULE_CONFIG',\n  500\n)\n","/**\n * Default job priority (1-10 scale, lower = higher priority)\n */\nexport const DEFAULT_PRIORITY = 5\n\n/**\n * Multiplier used in score calculation: priority * multiplier + timestamp\n *\n * This ensures higher priority jobs are processed first,\n * while preserving FIFO order within the same priority.\n * The value (1e13) leaves room for ~300 years of millisecond timestamps.\n */\nexport const PRIORITY_SCORE_MULTIPLIER = 1e13\n\n/**\n * Default delay when the worker is idle (no jobs in queue)\n */\nexport const DEFAULT_IDLE_DELAY = '2s'\n\n/**\n * Default interval between stalled job checks\n */\nexport const DEFAULT_STALLED_INTERVAL = '30s'\n\n/**\n * Default threshold after which a job is considered stalled\n */\nexport const DEFAULT_STALLED_THRESHOLD = '30s'\n\n/**\n * Default delay before retrying after an error\n */\nexport const DEFAULT_ERROR_RETRY_DELAY = '5s'\n"],"mappings":";;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;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;AAEO,IAAM,0BAA0B;AAAA,EACrC;AAAA,EACA;AAAA,EACA;AACF;AAEO,IAAM,uBAAuB;AAAA,EAClC;AAAA,EACA;AAAA,EACA;AACF;AAEO,IAAM,kBAAkB;AAAA,EAC7B;AAAA,EACA;AAAA,EACA;AACF;AAEO,IAAM,4BAA4B;AAAA,EACvC;AAAA,EACA;AAAA,EACA;AACF;AAEO,IAAM,4BAA4B;AAAA,EACvC;AAAA,EACA;AAAA,EACA;AACF;;;ACxEO,IAAM,mBAAmB;AASzB,IAAM,4BAA4B;AAKlC,IAAM,qBAAqB;AAK3B,IAAM,2BAA2B;AAKjC,IAAM,4BAA4B;AAKlC,IAAM,4BAA4B;","names":[]}