@cedarjs/jobs 0.2.0 → 0.3.0

package/README.md

@@ -1,3 +1,3 @@
-# RedwoodJob
+# CedarJS Jobs
 
-Provides background job scheduling and processing for Redwood.
+Provides background job scheduling and processing for CedarJS.

package/dist/adapters/BaseAdapter/BaseAdapter.d.ts

@@ -3,6 +3,7 @@ export interface SchedulePayload {
     name: string;
     path: string;
     args: unknown[];
+    cron?: string | undefined;
     runAt: Date;
     queue: string;
     priority: number;
@@ -17,10 +18,12 @@ export interface BaseAdapterOptions {
 }
 export interface SuccessOptions<TJob extends BaseJob = BaseJob> {
     job: TJob;
+    runAt: Date | undefined;
     deleteJob?: boolean;
 }
 export interface ErrorOptions<TJob extends BaseJob = BaseJob> {
     job: TJob;
+    runAt: Date;
     error: Error;
 }
 export interface FailureOptions<TJob extends BaseJob = BaseJob> {
@@ -49,7 +52,9 @@ export declare abstract class BaseAdapter<TOptions extends BaseAdapterOptions =
      */
     abstract success(options: SuccessOptions): void | Promise<void>;
     /**
-     * Called when an attempt to run a job produced an error
+     * Called when an attempt to run a job produced an error.
+     * This should update the stored job with the new `options.runAt` so that it
+     * will be retried
      */
     abstract error(options: ErrorOptions): void | Promise<void>;
     /**

package/dist/adapters/BaseAdapter/BaseAdapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BaseAdapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/BaseAdapter/BaseAdapter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAG3E,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,OAAO,EAAE,CAAA;IACf,KAAK,EAAE,IAAI,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,QAAQ;IACvB,WAAW,EAAE,MAAM,CAAA;IACnB,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,MAAM,EAAE,CAAA;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,WAAW,CAAA;CACrB;AAED,MAAM,WAAW,cAAc,CAAC,IAAI,SAAS,OAAO,GAAG,OAAO;IAC5D,GAAG,EAAE,IAAI,CAAA;IACT,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB;AAED,MAAM,WAAW,YAAY,CAAC,IAAI,SAAS,OAAO,GAAG,OAAO;IAC1D,GAAG,EAAE,IAAI,CAAA;IACT,KAAK,EAAE,KAAK,CAAA;CACb;AAED,MAAM,WAAW,cAAc,CAAC,IAAI,SAAS,OAAO,GAAG,OAAO;IAC5D,GAAG,EAAE,IAAI,CAAA;IACT,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB;AAED;;;;;;;GAOG;AACH,8BAAsB,WAAW,CAC/B,QAAQ,SAAS,kBAAkB,GAAG,kBAAkB,EACxD,eAAe,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAEtC,OAAO,EAAE,QAAQ,CAAA;IACjB,MAAM,EAAE,WAAW,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAA;gBAE3B,OAAO,EAAE,QAAQ;IAU7B,QAAQ,CAAC,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,eAAe;IAE5D;;OAEG;IACH,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,GAAG,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;IAEzE;;OAEG;IACH,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAE/D;;OAEG;IACH,QAAQ,CAAC,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAE3D;;OAEG;IACH,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAE/D;;OAEG;IACH,QAAQ,CAAC,KAAK,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;CACvC"}
+{"version":3,"file":"BaseAdapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/BaseAdapter/BaseAdapter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAG3E,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,OAAO,EAAE,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACzB,KAAK,EAAE,IAAI,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,QAAQ;IACvB,WAAW,EAAE,MAAM,CAAA;IACnB,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,MAAM,EAAE,CAAA;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,WAAW,CAAA;CACrB;AAED,MAAM,WAAW,cAAc,CAAC,IAAI,SAAS,OAAO,GAAG,OAAO;IAC5D,GAAG,EAAE,IAAI,CAAA;IACT,KAAK,EAAE,IAAI,GAAG,SAAS,CAAA;IACvB,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB;AAED,MAAM,WAAW,YAAY,CAAC,IAAI,SAAS,OAAO,GAAG,OAAO;IAC1D,GAAG,EAAE,IAAI,CAAA;IACT,KAAK,EAAE,IAAI,CAAA;IACX,KAAK,EAAE,KAAK,CAAA;CACb;AAED,MAAM,WAAW,cAAc,CAAC,IAAI,SAAS,OAAO,GAAG,OAAO;IAC5D,GAAG,EAAE,IAAI,CAAA;IACT,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB;AAED;;;;;;;GAOG;AACH,8BAAsB,WAAW,CAC/B,QAAQ,SAAS,kBAAkB,GAAG,kBAAkB,EACxD,eAAe,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAEtC,OAAO,EAAE,QAAQ,CAAA;IACjB,MAAM,EAAE,WAAW,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAA;gBAE3B,OAAO,EAAE,QAAQ;IAU7B,QAAQ,CAAC,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,eAAe;IAE5D;;OAEG;IACH,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,GAAG,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;IAEzE;;OAEG;IACH,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAE/D;;;;OAIG;IACH,QAAQ,CAAC,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAE3D;;OAEG;IACH,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAE/D;;OAEG;IACH,QAAQ,CAAC,KAAK,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;CACvC"}

package/dist/adapters/PrismaAdapter/PrismaAdapter.d.ts

@@ -6,6 +6,7 @@ export interface PrismaJob extends BaseJob {
     id: number;
     handler: string;
     runAt: Date;
+    cron: string | null | undefined;
     lockedAt: Date;
     lockedBy: string;
     lastError: string | null;
@@ -27,7 +28,9 @@ export interface PrismaAdapterOptions extends BaseAdapterOptions {
 /**
  * Implements a job adapter using Prisma ORM.
  *
- * Assumes a table exists with the following schema (the table name can be customized):
+ * Assumes a table exists with the following schema (the table name can be
+ * customized):
+ *
  * ```prisma
  * model BackgroundJob {
  *   id        Int       \@id \@default(autoincrement())
@@ -36,6 +39,7 @@ export interface PrismaAdapterOptions extends BaseAdapterOptions {
  *   queue     String
  *   priority  Int
  *   runAt     DateTime
+ *   cron      String?
  *   lockedAt  DateTime?
  *   lockedBy  String?
  *   lastError String?
@@ -58,11 +62,10 @@ export declare class PrismaAdapter extends BaseAdapter<PrismaAdapterOptions> {
      * in their generated code to do this in a DB-agnostic way.
      */
     find({ processName, maxRuntime, queues, }: FindArgs): Promise<PrismaJob | undefined>;
-    success({ job, deleteJob }: SuccessOptions<PrismaJob>): Promise<void>;
-    error({ job, error }: ErrorOptions<PrismaJob>): Promise<void>;
+    success({ job, runAt, deleteJob }: SuccessOptions<PrismaJob>): Promise<void>;
+    error({ job, runAt, error }: ErrorOptions<PrismaJob>): Promise<void>;
     failure({ job, deleteJob }: FailureOptions<PrismaJob>): Promise<void>;
-    schedule({ name, path, args, runAt, queue, priority, }: SchedulePayload): Promise<void>;
+    schedule({ name, path, args, runAt, cron, queue, priority, }: SchedulePayload): Promise<void>;
     clear(): Promise<void>;
-    backoffMilliseconds(attempts: number): number;
 }
 //# sourceMappingURL=PrismaAdapter.d.ts.map

package/dist/adapters/PrismaAdapter/PrismaAdapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PrismaAdapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/PrismaAdapter/PrismaAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAIlD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAA;AAC7C,OAAO,KAAK,EACV,kBAAkB,EAClB,eAAe,EACf,QAAQ,EACR,cAAc,EACd,YAAY,EACZ,cAAc,EACf,MAAM,+BAA+B,CAAA;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAA;AAI3D,MAAM,WAAW,SAAU,SAAQ,OAAO;IACxC,EAAE,EAAE,MAAM,CAAA;IACV,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,IAAI,CAAA;IACX,QAAQ,EAAE,IAAI,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,QAAQ,EAAE,IAAI,GAAG,IAAI,CAAA;IACrB,SAAS,EAAE,IAAI,CAAA;IACf,SAAS,EAAE,IAAI,CAAA;CAChB;AAED,MAAM,WAAW,oBAAqB,SAAQ,kBAAkB;IAC9D;;OAEG;IACH,EAAE,EAAE,YAAY,CAAA;IAEhB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAUD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,aAAc,SAAQ,WAAW,CAAC,oBAAoB,CAAC;IAClE,EAAE,EAAE,YAAY,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,YAAY,CAAC,MAAM,YAAY,CAAC,CAAA;IAC1C,QAAQ,EAAE,MAAM,CAAA;gBAEJ,OAAO,EAAE,oBAAoB;IAqBzC;;;;;OAKG;IACY,IAAI,CAAC,EAClB,WAAW,EACX,UAAU,EACV,MAAM,GACP,EAAE,QAAQ,GAAG,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC;IA4F7B,OAAO,CAAC,EAAE,GAAG,EAAE,SAAS,EAAE,EAAE,cAAc,CAAC,SAAS,CAAC;IAkBrD,KAAK,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,YAAY,CAAC,SAAS,CAAC;IAmB7C,OAAO,CAAC,EAAE,GAAG,EAAE,SAAS,EAAE,EAAE,cAAc,CAAC,SAAS,CAAC;IAYrD,QAAQ,CAAC,EACtB,IAAI,EACJ,IAAI,EACJ,IAAI,EACJ,KAAK,EACL,KAAK,EACL,QAAQ,GACT,EAAE,eAAe;IAWH,KAAK;IAIpB,mBAAmB,CAAC,QAAQ,EAAE,MAAM;CAGrC"}
+{"version":3,"file":"PrismaAdapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/PrismaAdapter/PrismaAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAIlD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAA;AAC7C,OAAO,KAAK,EACV,kBAAkB,EAClB,eAAe,EACf,QAAQ,EACR,cAAc,EACd,YAAY,EACZ,cAAc,EACf,MAAM,+BAA+B,CAAA;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAA;AAI3D,MAAM,WAAW,SAAU,SAAQ,OAAO;IACxC,EAAE,EAAE,MAAM,CAAA;IACV,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,IAAI,CAAA;IACX,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAA;IAC/B,QAAQ,EAAE,IAAI,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,QAAQ,EAAE,IAAI,GAAG,IAAI,CAAA;IACrB,SAAS,EAAE,IAAI,CAAA;IACf,SAAS,EAAE,IAAI,CAAA;CAChB;AAED,MAAM,WAAW,oBAAqB,SAAQ,kBAAkB;IAC9D;;OAEG;IACH,EAAE,EAAE,YAAY,CAAA;IAEhB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAUD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,aAAc,SAAQ,WAAW,CAAC,oBAAoB,CAAC;IAClE,EAAE,EAAE,YAAY,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,YAAY,CAAC,MAAM,YAAY,CAAC,CAAA;IAC1C,QAAQ,EAAE,MAAM,CAAA;gBAEJ,OAAO,EAAE,oBAAoB;IAqBzC;;;;;OAKG;IACY,IAAI,CAAC,EAClB,WAAW,EACX,UAAU,EACV,MAAM,GACP,EAAE,QAAQ,GAAG,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC;IA6F7B,OAAO,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,cAAc,CAAC,SAAS,CAAC;IAoB5D,KAAK,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,YAAY,CAAC,SAAS,CAAC;IAiBpD,OAAO,CAAC,EAAE,GAAG,EAAE,SAAS,EAAE,EAAE,cAAc,CAAC,SAAS,CAAC;IAYrD,QAAQ,CAAC,EACtB,IAAI,EACJ,IAAI,EACJ,IAAI,EACJ,KAAK,EACL,IAAI,EACJ,KAAK,EACL,QAAQ,GACT,EAAE,eAAe;IAYH,KAAK;CAGrB"}

package/dist/adapters/PrismaAdapter/PrismaAdapter.js

@@ -114,8 +114,8 @@ class PrismaAdapter extends import_BaseAdapter.BaseAdapter {
   // Prisma queries are lazily evaluated and only sent to the db when they are
   // awaited, so do the await here to ensure they actually run (if the user
   // doesn't await the Promise then the queries will never be executed!)
-  async success({ job, deleteJob }) {
-    this.logger.debug(`[RedwoodJob] Job ${job.id} success`);
+  async success({ job, runAt, deleteJob }) {
+    this.logger.debug(`[CedarJS Jobs] Job ${job.id} success`);
     if (deleteJob) {
       await this.accessor.delete({ where: { id: job.id } });
     } else {
@@ -125,22 +125,22 @@ class PrismaAdapter extends import_BaseAdapter.BaseAdapter {
           lockedAt: null,
           lockedBy: null,
           lastError: null,
-          runAt: null
+          runAt: runAt || null
         }
       });
     }
   }
-  async error({ job, error }) {
-    this.logger.debug(`[RedwoodJob] Job ${job.id} failure`);
+  // There was an error processing the job. Record the failure data and the new
+  // runAt time.
+  async error({ job, runAt, error }) {
+    this.logger.debug(`[CedarJS Jobs] Job ${job.id} failure`);
     const data = {
       lockedAt: null,
       lockedBy: null,
       lastError: `${error.message}
 
 ${error.stack}`,
-      runAt: new Date(
-        (/* @__PURE__ */ new Date()).getTime() + this.backoffMilliseconds(job.attempts)
-      )
+      runAt
     };
     await this.accessor.update({
       where: { id: job.id },
@@ -164,6 +164,7 @@ ${error.stack}`,
     path,
     args,
     runAt,
+    cron,
     queue,
     priority
   }) {
@@ -171,6 +172,7 @@ ${error.stack}`,
       data: {
         handler: JSON.stringify({ name, path, args }),
         runAt,
+        cron,
         queue,
         priority
       }
@@ -179,9 +181,6 @@ ${error.stack}`,
   async clear() {
     await this.accessor.deleteMany();
   }
-  backoffMilliseconds(attempts) {
-    return 1e3 * attempts ** 4;
-  }
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/dist/adapters/PrismaAdapter/errors.d.ts

@@ -1,8 +1,8 @@
-import { RedwoodJobError } from '../../errors.js';
+import { CedarJSJobsError } from '../../errors.js';
 /**
  * Thrown when a given model name isn't actually available in the PrismaClient
  */
-export declare class ModelNameError extends RedwoodJobError {
+export declare class ModelNameError extends CedarJSJobsError {
     constructor(name: string);
 }
 //# sourceMappingURL=errors.d.ts.map

package/dist/adapters/PrismaAdapter/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/adapters/PrismaAdapter/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAEjD;;GAEG;AACH,qBAAa,cAAe,SAAQ,eAAe;gBACrC,IAAI,EAAE,MAAM;CAGzB"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/adapters/PrismaAdapter/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAElD;;GAEG;AACH,qBAAa,cAAe,SAAQ,gBAAgB;gBACtC,IAAI,EAAE,MAAM;CAGzB"}

package/dist/adapters/PrismaAdapter/errors.js

@@ -22,7 +22,7 @@ __export(errors_exports, {
 });
 module.exports = __toCommonJS(errors_exports);
 var import_errors = require("../../errors.js");
-class ModelNameError extends import_errors.RedwoodJobError {
+class ModelNameError extends import_errors.CedarJSJobsError {
   constructor(name) {
     super(`Model \`${name}\` not found in PrismaClient`);
   }

package/dist/bins/rw-jobs-worker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rw-jobs-worker.d.ts","sourceRoot":"","sources":["../../src/bins/rw-jobs-worker.ts"],"names":[],"mappings":";AAWA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAqC/C,eAAO,MAAM,WAAW,oBAGrB;IACD,EAAE,EAAE,MAAM,CAAA;IACV,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;CAC1B,WAEA,CAAA;AAwBD,eAAO,MAAM,SAAS,mCAKnB;IACD,KAAK,EAAE,MAAM,CAAA;IACb,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,OAAO,CAAA;IACd,OAAO,EAAE,OAAO,CAAA;CACjB,oBAqBA,CAAA"}
+{"version":3,"file":"rw-jobs-worker.d.ts","sourceRoot":"","sources":["../../src/bins/rw-jobs-worker.ts"],"names":[],"mappings":";AAWA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAwC/C,eAAO,MAAM,WAAW,oBAGrB;IACD,EAAE,EAAE,MAAM,CAAA;IACV,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;CAC1B,WAEA,CAAA;AA0BD,eAAO,MAAM,SAAS,mCAKnB;IACD,KAAK,EAAE,MAAM,CAAA;IACb,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,OAAO,CAAA;IACd,OAAO,EAAE,OAAO,CAAA;CACjB,oBAqBA,CAAA"}

package/dist/bins/rw-jobs-worker.js

@@ -43,7 +43,7 @@ var import_setupEnv = require("../setupEnv.js");
 (0, import_setupEnv.setupEnv)();
 const parseArgs = (argv) => {
   return (0, import_yargs.default)((0, import_helpers.hideBin)(argv)).usage(
-    "Starts a single RedwoodJob worker to process background jobs\n\nUsage: $0 [options]"
+    "Starts a single CedarJS Jobs worker to process background jobs\n\nUsage: $0 [options]"
   ).option("index", {
     type: "number",
     required: true,

package/dist/bins/rw-jobs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rw-jobs.d.ts","sourceRoot":"","sources":["../../src/bins/rw-jobs.ts"],"names":[],"mappings":";AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAatD,OAAO,KAAK,EAEV,WAAW,EAGZ,MAAM,aAAa,CAAA;AAEpB,MAAM,MAAM,gBAAgB,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAA;AAsEjD,eAAO,MAAM,eAAe,WAAY,GAAG,qBAU1C,CAAA;AAED,eAAO,MAAM,YAAY,6CAKtB;IACD,UAAU,EAAE,gBAAgB,CAAA;IAC5B,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,MAAM,EAAE,WAAW,CAAA;CACpB,mBA2BA,CAAA;AAGD,eAAO,MAAM,WAAW,oCAIrB;IACD,UAAU,EAAE,gBAAgB,CAAA;IAC5B,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,WAAW,CAAA;CACpB,kBAqBA,CAAA;AAED,eAAO,MAAM,UAAU,eAAgB;IAAE,MAAM,EAAE,WAAW,CAAA;CAAE,SAG7D,CAAA"}
+{"version":3,"file":"rw-jobs.d.ts","sourceRoot":"","sources":["../../src/bins/rw-jobs.ts"],"names":[],"mappings":";AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAatD,OAAO,KAAK,EAEV,WAAW,EAGZ,MAAM,aAAa,CAAA;AAEpB,MAAM,MAAM,gBAAgB,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAA;AAyEjD,eAAO,MAAM,eAAe,WAAY,GAAG,qBAU1C,CAAA;AAED,eAAO,MAAM,YAAY,6CAKtB;IACD,UAAU,EAAE,gBAAgB,CAAA;IAC5B,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,MAAM,EAAE,WAAW,CAAA;CACpB,mBA2BA,CAAA;AAGD,eAAO,MAAM,WAAW,oCAIrB;IACD,UAAU,EAAE,gBAAgB,CAAA;IAC5B,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,WAAW,CAAA;CACpB,kBAqBA,CAAA;AAED,eAAO,MAAM,UAAU,eAAgB;IAAE,MAAM,EAAE,WAAW,CAAA;CAAE,SAG7D,CAAA"}

package/dist/bins/rw-jobs.js

@@ -54,7 +54,7 @@ const parseArgs = (argv) => {
     commandString.shift();
   }
   const parsed = (0, import_yargs.default)(commandString).usage(
-    "Starts the RedwoodJob runner to process background jobs\n\nUsage: rw jobs <command> [options]"
+    "Starts the CedarJS Jobs runner to process background jobs\n\nUsage: rw jobs <command> [options]"
   ).command("work", "Start a worker and process jobs").command("workoff", "Start a worker and exit after all jobs processed").command("start", "Start workers in daemon mode").command("stop", "Stop any daemonized job workers").command("restart", "Stop and start any daemonized job workers").command("clear", "Clear the job queue").demandCommand(1, "You must specify a mode to start in").example(
     "rw jobs work",
     "Start the job workers using the job config and work on jobs until manually stopped"
@@ -192,7 +192,7 @@ const main = async () => {
   const workerConfig = jobsConfig.workers;
   const numWorkers = buildNumWorkers(workerConfig);
   const logger = jobsConfig.logger ?? import_consts.DEFAULT_LOGGER;
-  logger.warn(`Starting RedwoodJob Runner at ${(/* @__PURE__ */ new Date()).toISOString()}...`);
+  logger.warn(`Starting CedarJS Jobs Runner at ${(/* @__PURE__ */ new Date()).toISOString()}...`);
   switch (command) {
     case "start":
       startWorkers({

package/dist/core/Executor.d.ts

@@ -4,8 +4,11 @@ export interface ExecutorOptions {
     adapter: BaseAdapter;
     job: BaseJob;
     logger?: BasicLogger;
+    /** Defaults to DEFAULT_MAX_ATTEMPTS */
     maxAttempts?: number;
+    /** Defaults to DEFAULT_DELETE_FAILED_JOBS */
     deleteFailedJobs?: boolean;
+    /** Defaults to DEFAULT_DELETE_SUCCESSFUL_JOBS */
     deleteSuccessfulJobs?: boolean;
 }
 export declare const DEFAULTS: {
@@ -25,5 +28,6 @@ export declare class Executor {
     constructor(options: ExecutorOptions);
     get jobIdentifier(): string;
     perform(): Promise<void>;
+    backoffMilliseconds(attempts: number): number;
 }
 //# sourceMappingURL=Executor.d.ts.map

package/dist/core/Executor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Executor.d.ts","sourceRoot":"","sources":["../../src/core/Executor.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wCAAwC,CAAA;AASzE,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAEvD,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,WAAW,CAAA;IACpB,GAAG,EAAE,OAAO,CAAA;IACZ,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B,oBAAoB,CAAC,EAAE,OAAO,CAAA;CAC/B;AAED,eAAO,MAAM,QAAQ;;;;;CAKpB,CAAA;AAED,qBAAa,QAAQ;IACnB,OAAO,EAAE,QAAQ,CAAC,eAAe,CAAC,CAAA;IAClC,OAAO,EAAE,eAAe,CAAC,SAAS,CAAC,CAAA;IACnC,MAAM,EAAE,WAAW,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC,CAAA;IAC9C,GAAG,EAAE,OAAO,CAAA;IACZ,WAAW,EAAE,WAAW,CAAC,eAAe,CAAC,aAAa,CAAC,CAAC,CAAA;IACxD,gBAAgB,EAAE,WAAW,CAAC,eAAe,CAAC,kBAAkB,CAAC,CAAC,CAAA;IAClE,oBAAoB,EAAE,WAAW,CAAC,eAAe,CAAC,sBAAsB,CAAC,CAAC,CAAA;gBAE9D,OAAO,EAAE,eAAe;IAmBpC,IAAI,aAAa,WAEhB;IAEK,OAAO;CAkCd"}
+{"version":3,"file":"Executor.d.ts","sourceRoot":"","sources":["../../src/core/Executor.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wCAAwC,CAAA;AASzE,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAEvD,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,WAAW,CAAA;IACpB,GAAG,EAAE,OAAO,CAAA;IACZ,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,uCAAuC;IACvC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,6CAA6C;IAC7C,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B,iDAAiD;IACjD,oBAAoB,CAAC,EAAE,OAAO,CAAA;CAC/B;AAED,eAAO,MAAM,QAAQ;;;;;CAKpB,CAAA;AAED,qBAAa,QAAQ;IACnB,OAAO,EAAE,QAAQ,CAAC,eAAe,CAAC,CAAA;IAClC,OAAO,EAAE,eAAe,CAAC,SAAS,CAAC,CAAA;IACnC,MAAM,EAAE,WAAW,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC,CAAA;IAC9C,GAAG,EAAE,OAAO,CAAA;IACZ,WAAW,EAAE,WAAW,CAAC,eAAe,CAAC,aAAa,CAAC,CAAC,CAAA;IACxD,gBAAgB,EAAE,WAAW,CAAC,eAAe,CAAC,kBAAkB,CAAC,CAAC,CAAA;IAClE,oBAAoB,EAAE,WAAW,CAAC,eAAe,CAAC,sBAAsB,CAAC,CAAC,CAAA;gBAE9D,OAAO,EAAE,eAAe;IAmBpC,IAAI,aAAa,WAEhB;IAEK,OAAO;IA2Cb,mBAAmB,CAAC,QAAQ,EAAE,MAAM;CAGrC"}

package/dist/core/Executor.js

@@ -22,6 +22,7 @@ __export(Executor_exports, {
   Executor: () => Executor
 });
 module.exports = __toCommonJS(Executor_exports);
+var import_cron_parser = require("cron-parser");
 var import_consts = require("../consts.js");
 var import_errors = require("../errors.js");
 var import_loaders = require("../loaders.js");
@@ -58,28 +59,30 @@ class Executor {
     return `${this.job.id} (${this.job.path}:${this.job.name})`;
   }
   async perform() {
-    this.logger.info(`[RedwoodJob] Started job ${this.jobIdentifier}`);
+    this.logger.info(`[CedarJS Jobs] Started job ${this.jobIdentifier}`);
     try {
       const job = await (0, import_loaders.loadJob)({ name: this.job.name, path: this.job.path });
       await job.perform(...this.job.args);
+      const runAt = job.cron ? import_cron_parser.CronExpressionParser.parse(job.cron).next().toDate() : void 0;
       await this.adapter.success({
         job: this.job,
-        deleteJob: this.deleteSuccessfulJobs
+        runAt,
+        deleteJob: !runAt && this.deleteSuccessfulJobs
       });
     } catch (error) {
-      this.logger.error(
-        `[RedwoodJob] Error in job ${this.jobIdentifier}: ${error.message}`
-      );
+      const errorMessage = `[CedarJS Jobs] Error in job ${this.jobIdentifier}: ${error.message}`;
+      this.logger.error(errorMessage);
       this.logger.error(error.stack);
       await this.adapter.error({
         job: this.job,
+        runAt: new Date(
+          (/* @__PURE__ */ new Date()).getTime() + this.backoffMilliseconds(this.job.attempts)
+        ),
         error
       });
       if (this.job.attempts >= this.maxAttempts) {
-        this.logger.warn(
-          this.job,
-          `[RedwoodJob] Failed job ${this.jobIdentifier}: reached max attempts (${this.maxAttempts})`
-        );
+        const maxAttemptsMessage = `[CedarJS Jobs] Failed job ${this.jobIdentifier}: reached max attempts (${this.maxAttempts})`;
+        this.logger.warn(this.job, maxAttemptsMessage);
         await this.adapter.failure({
           job: this.job,
           deleteJob: this.deleteFailedJobs
@@ -87,6 +90,9 @@ class Executor {
       }
     }
   }
+  backoffMilliseconds(attempts) {
+    return 1e3 * attempts ** 4;
+  }
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/dist/core/JobManager.d.ts

@@ -1,4 +1,4 @@
-import type { Adapters, BasicLogger, CreateSchedulerArgs, CreateSchedulerConfig, Job, JobDefinition, JobManagerConfig, QueueNames, WorkerConfig } from '../types.js';
+import type { Adapters, BasicLogger, CreateSchedulerArgs, CreateSchedulerConfig, Job, JobComputedProperties, JobDefinition, JobManagerConfig, QueueNames, WorkerConfig } from '../types.js';
 import type { WorkerOptions } from './Worker.js';
 import { Worker } from './Worker.js';
 export interface CreateWorkerArgs {
@@ -13,8 +13,10 @@ export declare class JobManager<TAdapters extends Adapters, TQueues extends Queu
     logger: TLogger;
     workers: WorkerConfig<TAdapters, TQueues>[];
     constructor(config: JobManagerConfig<TAdapters, TQueues extends string[] ? never : TQueues, TLogger>);
-    createScheduler(schedulerConfig: CreateSchedulerConfig<TAdapters>): <TJob extends Job<TQueues, any[]>>(job: TJob, ...argsAndOptions: CreateSchedulerArgs<TJob>) => Promise<boolean>;
-    createJob<TArgs extends unknown[]>(jobDefinition: JobDefinition<TQueues, TArgs>): Job<TQueues, TArgs>;
+    createScheduler(schedulerConfig: CreateSchedulerConfig<TAdapters>): <TJob extends Job<TQueues, any[], any>>(job: TJob, ...argsAndOptions: CreateSchedulerArgs<TJob>) => Promise<boolean>;
+    createJob<TArgs extends any[], TCron extends string | undefined, TJobDef extends JobDefinition<TQueues, TArgs, TCron> & {
+        cron?: TCron;
+    }>(jobDefinition: TJobDef): TJobDef & JobComputedProperties;
     createWorker({ index, workoff, clear, processName }: CreateWorkerArgs): Worker;
 }
 //# sourceMappingURL=JobManager.d.ts.map

package/dist/core/JobManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"JobManager.d.ts","sourceRoot":"","sources":["../../src/core/JobManager.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,QAAQ,EACR,WAAW,EACX,mBAAmB,EACnB,qBAAqB,EACrB,GAAG,EACH,aAAa,EACb,gBAAgB,EAChB,UAAU,EACV,YAAY,EACb,MAAM,aAAa,CAAA;AAGpB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAChD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAEpC,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,aAAa,CAAC,SAAS,CAAC,CAAA;IACjC,KAAK,EAAE,aAAa,CAAC,OAAO,CAAC,CAAA;IAC7B,WAAW,EAAE,MAAM,CAAA;CACpB;AAED,qBAAa,UAAU,CACrB,SAAS,SAAS,QAAQ,EAC1B,OAAO,SAAS,UAAU,EAC1B,OAAO,SAAS,WAAW;IAE3B,QAAQ,EAAE,SAAS,CAAA;IACnB,MAAM,EAAE,OAAO,CAAA;IACf,MAAM,EAAE,OAAO,CAAA;IACf,OAAO,EAAE,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,EAAE,CAAA;gBAGzC,MAAM,EAAE,gBAAgB,CACtB,SAAS,EAGT,OAAO,SAAS,MAAM,EAAE,GAAG,KAAK,GAAG,OAAO,EAC1C,OAAO,CACR;IAQH,eAAe,CAAC,eAAe,EAAE,qBAAqB,CAAC,SAAS,CAAC,IAMvD,IAAI,SAAS,GAAG,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,OACjC,IAAI,qBACU,mBAAmB,CAAC,IAAI,CAAC;IAYhD,SAAS,CAAC,KAAK,SAAS,OAAO,EAAE,EAC/B,aAAa,EAAE,aAAa,CAAC,OAAO,EAAE,KAAK,CAAC,GAC3C,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC;IAOtB,YAAY,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,EAAE,gBAAgB;CAqBtE"}
+{"version":3,"file":"JobManager.d.ts","sourceRoot":"","sources":["../../src/core/JobManager.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,QAAQ,EACR,WAAW,EACX,mBAAmB,EACnB,qBAAqB,EACrB,GAAG,EACH,qBAAqB,EACrB,aAAa,EACb,gBAAgB,EAChB,UAAU,EACV,YAAY,EACb,MAAM,aAAa,CAAA;AAGpB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAChD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAEpC,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,aAAa,CAAC,SAAS,CAAC,CAAA;IACjC,KAAK,EAAE,aAAa,CAAC,OAAO,CAAC,CAAA;IAC7B,WAAW,EAAE,MAAM,CAAA;CACpB;AAED,qBAAa,UAAU,CACrB,SAAS,SAAS,QAAQ,EAC1B,OAAO,SAAS,UAAU,EAC1B,OAAO,SAAS,WAAW;IAE3B,QAAQ,EAAE,SAAS,CAAA;IACnB,MAAM,EAAE,OAAO,CAAA;IACf,MAAM,EAAE,OAAO,CAAA;IACf,OAAO,EAAE,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,EAAE,CAAA;gBAGzC,MAAM,EAAE,gBAAgB,CACtB,SAAS,EAGT,OAAO,SAAS,MAAM,EAAE,GAAG,KAAK,GAAG,OAAO,EAC1C,OAAO,CACR;IAQH,eAAe,CAAC,eAAe,EAAE,qBAAqB,CAAC,SAAS,CAAC,IAMvD,IAAI,SAAS,GAAG,CAAC,OAAO,EAAE,GAAG,EAAE,EAAE,GAAG,CAAC,OACtC,IAAI,qBACU,mBAAmB,CAAC,IAAI,CAAC;IAYhD,SAAS,CACP,KAAK,SAAS,GAAG,EAAE,EACnB,KAAK,SAAS,MAAM,GAAG,SAAS,EAChC,OAAO,SAAS,aAAa,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,GAAG;QAAE,IAAI,CAAC,EAAE,KAAK,CAAA;KAAE,EACvE,aAAa,EAAE,OAAO,GAAG,OAAO,GAAG,qBAAqB;IAO1D,YAAY,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,EAAE,gBAAgB;CAqBtE"}

package/dist/core/JobManager.js

@@ -38,7 +38,7 @@ class JobManager {
   createScheduler(schedulerConfig) {
     const scheduler = new import_Scheduler.Scheduler({
       adapter: this.adapters[schedulerConfig.adapter],
-      logger: this.logger
+      logger: schedulerConfig.logger ?? this.logger
     });
     return (job, ...argsAndOptions) => {
       const [possibleArgs, possibleOptions] = argsAndOptions;

package/dist/core/Scheduler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Scheduler.d.ts","sourceRoot":"","sources":["../../src/core/Scheduler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,eAAe,EAChB,MAAM,wCAAwC,CAAA;AAY/C,OAAO,KAAK,EACV,WAAW,EACX,GAAG,EACH,UAAU,EACV,kBAAkB,EACnB,MAAM,aAAa,CAAA;AAEpB,UAAU,eAAe,CAAC,QAAQ,SAAS,WAAW;IACpD,OAAO,EAAE,QAAQ,CAAA;IACjB,MAAM,CAAC,EAAE,WAAW,CAAA;CACrB;AAED,qBAAa,SAAS,CAAC,QAAQ,SAAS,WAAW;IACjD,OAAO,EAAE,QAAQ,CAAA;IACjB,MAAM,EAAE,WAAW,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAA;gBAE5C,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,eAAe,CAAC,QAAQ,CAAC;IAS1D,YAAY,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,IAAI,GAAG,IAAI,CAAA;KAAE;IAU1E,YAAY,CAAC,IAAI,SAAS,GAAG,CAAC,UAAU,EAAE,OAAO,EAAE,CAAC,EAAE,EACpD,GAAG,EACH,IAAI,EACJ,OAAO,GACR,EAAE;QACD,GAAG,EAAE,IAAI,CAAA;QACT,IAAI,EAAE,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,GAAG,KAAK,EAAE,CAAA;QAC3C,OAAO,CAAC,EAAE,kBAAkB,CAAA;KAC7B,GAAG,eAAe;IAoBb,QAAQ,CAAC,IAAI,SAAS,GAAG,CAAC,UAAU,EAAE,OAAO,EAAE,CAAC,EAAE,EACtD,GAAG,EACH,IAAI,EACJ,OAAO,GACR,EAAE;QACD,GAAG,EAAE,IAAI,CAAA;QACT,IAAI,EAAE,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,GAAG,KAAK,EAAE,CAAA;QAC3C,OAAO,CAAC,EAAE,kBAAkB,CAAA;KAC7B;CAmBF"}
+{"version":3,"file":"Scheduler.d.ts","sourceRoot":"","sources":["../../src/core/Scheduler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,eAAe,EAChB,MAAM,wCAAwC,CAAA;AAY/C,OAAO,KAAK,EACV,WAAW,EACX,GAAG,EACH,UAAU,EACV,kBAAkB,EACnB,MAAM,aAAa,CAAA;AAEpB,UAAU,eAAe,CAAC,QAAQ,SAAS,WAAW;IACpD,OAAO,EAAE,QAAQ,CAAA;IACjB,MAAM,CAAC,EAAE,WAAW,CAAA;CACrB;AAED,qBAAa,SAAS,CAAC,QAAQ,SAAS,WAAW;IACjD,OAAO,EAAE,QAAQ,CAAA;IACjB,MAAM,EAAE,WAAW,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAA;gBAE5C,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,eAAe,CAAC,QAAQ,CAAC;IAS1D,YAAY,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,IAAI,GAAG,IAAI,CAAA;KAAE;IAU1E,YAAY,CAAC,IAAI,SAAS,GAAG,CAAC,UAAU,EAAE,OAAO,EAAE,CAAC,EAAE,EACpD,GAAG,EACH,IAAI,EACJ,OAAO,GACR,EAAE;QACD,GAAG,EAAE,IAAI,CAAA;QACT,IAAI,EAAE,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,GAAG,KAAK,EAAE,CAAA;QAC3C,OAAO,CAAC,EAAE,kBAAkB,CAAA;KAC7B,GAAG,eAAe;IA2Bb,QAAQ,CAAC,IAAI,SAAS,GAAG,CAAC,UAAU,EAAE,OAAO,EAAE,CAAC,EAAE,EACtD,GAAG,EACH,IAAI,EACJ,OAAO,GACR,EAAE;QACD,GAAG,EAAE,IAAI,CAAA;QACT,IAAI,EAAE,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,GAAG,KAAK,EAAE,CAAA;QAC3C,OAAO,CAAC,EAAE,kBAAkB,CAAA;KAC7B;CAmBF"}

package/dist/core/Scheduler.js

@@ -54,10 +54,16 @@ class Scheduler {
     if (!queue) {
       throw new import_errors.QueueNotDefinedError();
     }
+    if (job.cron && (wait || waitUntil)) {
+      throw new Error(
+        "Cannot schedule a cron job with wait or waitUntil options"
+      );
+    }
     return {
       name: job.name,
       path: job.path,
       args: args ?? [],
+      cron: job.cron,
       runAt: this.computeRunAt({ wait, waitUntil }),
       queue,
       priority
@@ -73,13 +79,13 @@ class Scheduler {
       args,
       options
     });
-    this.logger.info(payload, `[RedwoodJob] Scheduling ${job.name}`);
+    this.logger.info(payload, `[CedarJS Jobs] Scheduling ${job.name}`);
     try {
       await this.adapter.schedule(payload);
       return true;
     } catch (e) {
       throw new import_errors.SchedulingError(
-        `[RedwoodJob] Exception when scheduling ${payload.name}`,
+        `[CedarJS Jobs] Exception when scheduling ${payload.name}`,
         e
       );
     }

package/dist/core/Worker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Worker.d.ts","sourceRoot":"","sources":["../../src/core/Worker.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wCAAwC,CAAA;AAUzE,OAAO,KAAK,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAInE,MAAM,WAAW,aAAc,SAAQ,mBAAmB;IAGxD,OAAO,EAAE,WAAW,CAAA;IACpB,uDAAuD;IACvD,WAAW,EAAE,MAAM,CAAA;IACnB,oEAAoE;IACpE,MAAM,EAAE,MAAM,EAAE,CAAA;IAIhB,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,8DAA8D;IAC9D,KAAK,CAAC,EAAE,OAAO,CAAA;IAEf;;;;;OAKG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;IAEjB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED,KAAK,eAAe,GAAG,QAAQ,CAAC,aAAa,CAAC,CAAA;AAc9C,qBAAa,MAAM;;IACjB,OAAO,EAAE,eAAe,CAAA;IACxB,OAAO,EAAE,eAAe,CAAC,SAAS,CAAC,CAAA;IACnC,MAAM,EAAE,eAAe,CAAC,QAAQ,CAAC,CAAA;IACjC,KAAK,EAAE,eAAe,CAAC,OAAO,CAAC,CAAA;IAC/B,WAAW,EAAE,eAAe,CAAC,aAAa,CAAC,CAAA;IAC3C,MAAM,EAAE,eAAe,CAAC,QAAQ,CAAC,CAAA;IACjC,WAAW,EAAE,eAAe,CAAC,aAAa,CAAC,CAAA;IAC3C,UAAU,EAAE,eAAe,CAAC,YAAY,CAAC,CAAA;IACzC,oBAAoB,EAAE,eAAe,CAAC,sBAAsB,CAAC,CAAA;IAC7D,gBAAgB,EAAE,eAAe,CAAC,kBAAkB,CAAC,CAAA;IACrD,UAAU,EAAE,eAAe,CAAC,YAAY,CAAC,CAAA;IACzC,OAAO,EAAE,eAAe,CAAC,SAAS,CAAC,CAAA;IACnC,OAAO,EAAE,eAAe,CAAC,SAAS,CAAC,CAAA;IACnC,aAAa,EAAE,IAAI,CAAA;gBAEP,OAAO,EAAE,aAAa;IAwElC,GAAG;IAQH,IAAI,UAAU,WAMb;CAmDF"}
+{"version":3,"file":"Worker.d.ts","sourceRoot":"","sources":["../../src/core/Worker.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wCAAwC,CAAA;AAUzE,OAAO,KAAK,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAInE,MAAM,WAAW,aAAc,SAAQ,mBAAmB;IAGxD,OAAO,EAAE,WAAW,CAAA;IACpB,uDAAuD;IACvD,WAAW,EAAE,MAAM,CAAA;IACnB,oEAAoE;IACpE,MAAM,EAAE,MAAM,EAAE,CAAA;IAIhB,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,8DAA8D;IAC9D,KAAK,CAAC,EAAE,OAAO,CAAA;IAEf;;;;;OAKG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;IAEjB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED,KAAK,eAAe,GAAG,QAAQ,CAAC,aAAa,CAAC,CAAA;AAc9C,qBAAa,MAAM;;IACjB,OAAO,EAAE,eAAe,CAAA;IACxB,OAAO,EAAE,eAAe,CAAC,SAAS,CAAC,CAAA;IACnC,MAAM,EAAE,eAAe,CAAC,QAAQ,CAAC,CAAA;IACjC,KAAK,EAAE,eAAe,CAAC,OAAO,CAAC,CAAA;IAC/B,WAAW,EAAE,eAAe,CAAC,aAAa,CAAC,CAAA;IAC3C,MAAM,EAAE,eAAe,CAAC,QAAQ,CAAC,CAAA;IACjC,WAAW,EAAE,eAAe,CAAC,aAAa,CAAC,CAAA;IAC3C,UAAU,EAAE,eAAe,CAAC,YAAY,CAAC,CAAA;IACzC,oBAAoB,EAAE,eAAe,CAAC,sBAAsB,CAAC,CAAA;IAC7D,gBAAgB,EAAE,eAAe,CAAC,kBAAkB,CAAC,CAAA;IACrD,UAAU,EAAE,eAAe,CAAC,YAAY,CAAC,CAAA;IACzC,OAAO,EAAE,eAAe,CAAC,SAAS,CAAC,CAAA;IACnC,OAAO,EAAE,eAAe,CAAC,SAAS,CAAC,CAAA;IACnC,aAAa,EAAE,IAAI,CAAA;gBAEP,OAAO,EAAE,aAAa;IA2ElC,GAAG;IAQH,IAAI,UAAU,WAMb;CAqDF"}

package/dist/errors.d.ts

@@ -1,68 +1,68 @@
 /**
- * Parent class for any RedwoodJob-related error
+ * Parent class for any CedarJS Jobs-related error
  */
-export declare class RedwoodJobError extends Error {
+export declare class CedarJSJobsError extends Error {
     constructor(message: string);
 }
 /**
  * Thrown when trying to configure a scheduler without an adapter
  */
-export declare class AdapterNotConfiguredError extends RedwoodJobError {
+export declare class AdapterNotConfiguredError extends CedarJSJobsError {
     constructor();
 }
 /**
  * Thrown when the Worker or Executor is instantiated without an adapter
  */
-export declare class AdapterRequiredError extends RedwoodJobError {
+export declare class AdapterRequiredError extends CedarJSJobsError {
     constructor();
 }
 /**
  * Thrown when the Worker is instantiated without an array of queues
  */
-export declare class QueuesRequiredError extends RedwoodJobError {
+export declare class QueuesRequiredError extends CedarJSJobsError {
     constructor();
 }
 /**
  * Thrown when the Executor is instantiated without a job
  */
-export declare class JobRequiredError extends RedwoodJobError {
+export declare class JobRequiredError extends CedarJSJobsError {
     constructor();
 }
 /**
  * Thrown when a job with the given handler is not found in the filesystem
  */
-export declare class JobNotFoundError extends RedwoodJobError {
+export declare class JobNotFoundError extends CedarJSJobsError {
     constructor(name: string);
 }
 /**
  * Thrown when a job file exists, but the export does not match the filename
  */
-export declare class JobExportNotFoundError extends RedwoodJobError {
+export declare class JobExportNotFoundError extends CedarJSJobsError {
     constructor(name: string);
 }
 /**
  * Thrown when the runner tries to import `adapter` from api/src/lib/jobs.js|ts and
  * the file does not exist
  */
-export declare class JobsLibNotFoundError extends RedwoodJobError {
+export declare class JobsLibNotFoundError extends CedarJSJobsError {
     constructor();
 }
 /**
  * Thrown when the runner tries to import `adapter` from api/src/lib/jobs.js|ts
  */
-export declare class AdapterNotFoundError extends RedwoodJobError {
+export declare class AdapterNotFoundError extends CedarJSJobsError {
     constructor(name: string);
 }
 /**
  * Thrown when the runner tries to import `logger` from api/src/lib/jobs.js|ts
  */
-export declare class LoggerNotFoundError extends RedwoodJobError {
+export declare class LoggerNotFoundError extends CedarJSJobsError {
     constructor(name: string);
 }
 /**
  * Thrown when the runner tries to import `workerConfig` from api/src/lib/jobs.js|ts
  */
-export declare class WorkerConfigNotFoundError extends RedwoodJobError {
+export declare class WorkerConfigNotFoundError extends CedarJSJobsError {
     constructor(name: string);
 }
 /**
@@ -78,7 +78,7 @@ export declare class WorkerConfigNotFoundError extends RedwoodJobError {
  * }
  * ```
  */
-export declare class RethrownJobError extends RedwoodJobError {
+export declare class RethrownJobError extends CedarJSJobsError {
     originalError: Error;
     stackBeforeRethrow: string | undefined;
     constructor(message: string, error: Error);
@@ -95,10 +95,10 @@ export declare class SchedulingError extends RethrownJobError {
 export declare class PerformError extends RethrownJobError {
     constructor(message: string, error: Error);
 }
-export declare class QueueNotDefinedError extends RedwoodJobError {
+export declare class QueueNotDefinedError extends CedarJSJobsError {
     constructor();
 }
-export declare class WorkerConfigIndexNotFoundError extends RedwoodJobError {
+export declare class WorkerConfigIndexNotFoundError extends CedarJSJobsError {
     constructor(index: number);
 }
 //# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,qBAAa,eAAgB,SAAQ,KAAK;gBAC5B,OAAO,EAAE,MAAM;CAI5B;AAED;;GAEG;AACH,qBAAa,yBAA0B,SAAQ,eAAe;;CAI7D;AAED;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,eAAe;;CAIxD;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,eAAe;;CAIvD;AAED;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,eAAe;;CAIpD;AAED;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,eAAe;gBACvC,IAAI,EAAE,MAAM;CAGzB;AAED;;GAEG;AACH,qBAAa,sBAAuB,SAAQ,eAAe;gBAC7C,IAAI,EAAE,MAAM;CAGzB;AAED;;;GAGG;AACH,qBAAa,oBAAqB,SAAQ,eAAe;;CAMxD;AAED;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,eAAe;gBAC3C,IAAI,EAAE,MAAM;CAKzB;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,eAAe;gBAC1C,IAAI,EAAE,MAAM;CAKzB;AAED;;GAEG;AACH,qBAAa,yBAA0B,SAAQ,eAAe;gBAChD,IAAI,EAAE,MAAM;CAGzB;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,gBAAiB,SAAQ,eAAe;IACnD,aAAa,EAAE,KAAK,CAAA;IACpB,kBAAkB,EAAE,MAAM,GAAG,SAAS,CAAA;gBAE1B,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK;CAqB1C;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,gBAAgB;gBACvC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK;CAG1C;AAED;;GAEG;AACH,qBAAa,YAAa,SAAQ,gBAAgB;gBACpC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK;CAG1C;AAED,qBAAa,oBAAqB,SAAQ,eAAe;;CAIxD;AAED,qBAAa,8BAA+B,SAAQ,eAAe;gBACrD,KAAK,EAAE,MAAM;CAG1B"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;gBAC7B,OAAO,EAAE,MAAM;CAI5B;AAED;;GAEG;AACH,qBAAa,yBAA0B,SAAQ,gBAAgB;;CAI9D;AAED;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,gBAAgB;;CAIzD;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,gBAAgB;;CAIxD;AAED;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,gBAAgB;;CAIrD;AAED;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,gBAAgB;gBACxC,IAAI,EAAE,MAAM;CAGzB;AAED;;GAEG;AACH,qBAAa,sBAAuB,SAAQ,gBAAgB;gBAC9C,IAAI,EAAE,MAAM;CAGzB;AAED;;;GAGG;AACH,qBAAa,oBAAqB,SAAQ,gBAAgB;;CASzD;AAED;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,gBAAgB;gBAC5C,IAAI,EAAE,MAAM;CAKzB;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,gBAAgB;gBAC3C,IAAI,EAAE,MAAM;CAKzB;AAED;;GAEG;AACH,qBAAa,yBAA0B,SAAQ,gBAAgB;gBACjD,IAAI,EAAE,MAAM;CAGzB;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,gBAAiB,SAAQ,gBAAgB;IACpD,aAAa,EAAE,KAAK,CAAA;IACpB,kBAAkB,EAAE,MAAM,GAAG,SAAS,CAAA;gBAE1B,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK;CAqB1C;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,gBAAgB;gBACvC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK;CAG1C;AAED;;GAEG;AACH,qBAAa,YAAa,SAAQ,gBAAgB;gBACpC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK;CAG1C;AAED,qBAAa,oBAAqB,SAAQ,gBAAgB;;CAIzD;AAED,qBAAa,8BAA+B,SAAQ,gBAAgB;gBACtD,KAAK,EAAE,MAAM;CAG1B"}

package/dist/errors.js

@@ -21,6 +21,7 @@ __export(errors_exports, {
   AdapterNotConfiguredError: () => AdapterNotConfiguredError,
   AdapterNotFoundError: () => AdapterNotFoundError,
   AdapterRequiredError: () => AdapterRequiredError,
+  CedarJSJobsError: () => CedarJSJobsError,
   JobExportNotFoundError: () => JobExportNotFoundError,
   JobNotFoundError: () => JobNotFoundError,
   JobRequiredError: () => JobRequiredError,
@@ -29,7 +30,6 @@ __export(errors_exports, {
   PerformError: () => PerformError,
   QueueNotDefinedError: () => QueueNotDefinedError,
   QueuesRequiredError: () => QueuesRequiredError,
-  RedwoodJobError: () => RedwoodJobError,
   RethrownJobError: () => RethrownJobError,
   SchedulingError: () => SchedulingError,
   WorkerConfigIndexNotFoundError: () => WorkerConfigIndexNotFoundError,
@@ -37,69 +37,69 @@ __export(errors_exports, {
 });
 module.exports = __toCommonJS(errors_exports);
 const JOBS_CONFIG_FILENAME = "jobs.{ts,js}";
-class RedwoodJobError extends Error {
+class CedarJSJobsError extends Error {
   constructor(message) {
     super(message);
     this.name = this.constructor.name;
   }
 }
-class AdapterNotConfiguredError extends RedwoodJobError {
+class AdapterNotConfiguredError extends CedarJSJobsError {
   constructor() {
     super("No adapter configured for the job scheduler");
   }
 }
-class AdapterRequiredError extends RedwoodJobError {
+class AdapterRequiredError extends CedarJSJobsError {
   constructor() {
     super("`adapter` is required to perform a job");
   }
 }
-class QueuesRequiredError extends RedwoodJobError {
+class QueuesRequiredError extends CedarJSJobsError {
   constructor() {
     super("`queues` is required to find a job to run");
   }
 }
-class JobRequiredError extends RedwoodJobError {
+class JobRequiredError extends CedarJSJobsError {
   constructor() {
     super("`job` is required to perform a job");
   }
 }
-class JobNotFoundError extends RedwoodJobError {
+class JobNotFoundError extends CedarJSJobsError {
   constructor(name) {
     super(`Job \`${name}\` not found in the filesystem`);
   }
 }
-class JobExportNotFoundError extends RedwoodJobError {
+class JobExportNotFoundError extends CedarJSJobsError {
   constructor(name) {
     super(`Job file \`${name}\` does not export a class with the same name`);
   }
 }
-class JobsLibNotFoundError extends RedwoodJobError {
+class JobsLibNotFoundError extends CedarJSJobsError {
   constructor() {
     super(
       `api/src/lib/${JOBS_CONFIG_FILENAME} not found. Run \`yarn rw setup jobs\` to create this file and configure background jobs. Already did that? You'll need to run \`yarn rw dev\` or \`yarn rw build\` before you can start the job workers!`
     );
   }
 }
-class AdapterNotFoundError extends RedwoodJobError {
+class AdapterNotFoundError extends CedarJSJobsError {
   constructor(name) {
     super(
       `api/src/lib/${JOBS_CONFIG_FILENAME} does not export an adapter named \`${name}\``
     );
   }
 }
-class LoggerNotFoundError extends RedwoodJobError {
+class LoggerNotFoundError extends CedarJSJobsError {
   constructor(name) {
     super(
       `api/src/lib/${JOBS_CONFIG_FILENAME} does not export a logger named \`${name}\``
     );
   }
 }
-class WorkerConfigNotFoundError extends RedwoodJobError {
+class WorkerConfigNotFoundError extends CedarJSJobsError {
   constructor(name) {
     super(`api/src/lib/#{JOBS_CONFIG_FILENAME} does not export \`${name}\``);
   }
 }
-class RethrownJobError extends RedwoodJobError {
+class RethrownJobError extends CedarJSJobsError {
   originalError;
   stackBeforeRethrow;
   constructor(message, error) {
@@ -125,12 +125,12 @@ class PerformError extends RethrownJobError {
     super(message, error);
   }
 }
-class QueueNotDefinedError extends RedwoodJobError {
+class QueueNotDefinedError extends CedarJSJobsError {
   constructor() {
     super("Scheduler requires a named `queue` to place jobs in");
   }
 }
-class WorkerConfigIndexNotFoundError extends RedwoodJobError {
+class WorkerConfigIndexNotFoundError extends CedarJSJobsError {
   constructor(index) {
     super(`Worker index ${index} not found in jobs config`);
   }
@@ -140,6 +140,7 @@ class WorkerConfigIndexNotFoundError extends RedwoodJobError {
   AdapterNotConfiguredError,
   AdapterNotFoundError,
   AdapterRequiredError,
+  CedarJSJobsError,
   JobExportNotFoundError,
   JobNotFoundError,
   JobRequiredError,
@@ -148,7 +149,6 @@ class WorkerConfigIndexNotFoundError extends RedwoodJobError {
   PerformError,
   QueueNotDefinedError,
   QueuesRequiredError,
-  RedwoodJobError,
   RethrownJobError,
   SchedulingError,
   WorkerConfigIndexNotFoundError,

package/dist/types.d.ts

@@ -1,6 +1,6 @@
 import type { IntRange } from 'type-fest';
 import type { BaseAdapter } from './adapters/BaseAdapter/BaseAdapter.js';
-/** Redwood's logger and the standard console logger conform to this shape. */
+/** CedarJS's logger and the standard console logger conform to this shape. */
 export interface BasicLogger {
     debug: (message?: any, ...optionalParams: any[]) => void;
     info: (message?: any, ...optionalParams: any[]) => void;
@@ -8,8 +8,8 @@ export interface BasicLogger {
     error: (message?: any, ...optionalParams: any[]) => void;
 }
 /**
- *This is the minimum interface that a "job" must conform to in order to be
- * scheduled and executed by Redwood's job engine.
+ * This is the minimum interface that a "job" must conform to in order to be
+ * scheduled and executed by CedarJS's job engine.
  */
 export interface BaseJob {
     id: string | number;
@@ -17,6 +17,7 @@ export interface BaseJob {
     path: string;
     args: unknown[];
     attempts: number;
+    cron?: string | undefined | null;
 }
 export type PossibleBaseJob = BaseJob | undefined;
 export type Adapters = Record<string, BaseAdapter>;
@@ -113,8 +114,8 @@ export interface JobManagerConfig<TAdapters extends Adapters, TQueues extends Qu
 }
 export interface CreateSchedulerConfig<TAdapters extends Adapters> {
     /**
-     * The name of the adapter to use for this scheduler. This must be one of the keys
-     * in the `adapters` object when you created the `JobManager`.
+     * The name of the adapter to use for this scheduler. This must be one of the
+     * keys in the `adapters` object when you created the `JobManager`.
      */
     adapter: keyof TAdapters;
     /**
@@ -123,7 +124,7 @@ export interface CreateSchedulerConfig<TAdapters extends Adapters> {
      */
     logger?: BasicLogger;
 }
-export interface JobDefinition<TQueues extends QueueNames, TArgs extends unknown[] = []> {
+export interface JobDefinition<TQueues extends QueueNames, TArgs extends unknown[] = [], TCron extends string | undefined = string | undefined> {
     /**
      * The name of the queue that this job should always be scheduled on. This
      * must be one of the values in the `queues` array when you created the
@@ -136,6 +137,12 @@ export interface JobDefinition<TQueues extends QueueNames, TArgs extends unknown
      * @default 50
      */
     priority?: PriorityValue;
+    /**
+     * If this is specified it will be the recurring schedule this job will run at
+     * See https://github.com/harrisiirak/cron-parser#cron-format for the
+     * supported syntax.
+     */
+    cron?: TCron;
     /**
      * The function to run when this job is executed.
      *
@@ -153,23 +160,33 @@ export type JobComputedProperties = {
      */
     path: string;
 };
-export type Job<TQueues extends QueueNames, TArgs extends unknown[] = []> = JobDefinition<TQueues, TArgs> & JobComputedProperties;
+export type Job<TQueues extends QueueNames, TArgs extends unknown[] = [], TCron extends string | undefined = string | undefined> = JobDefinition<TQueues, TArgs, TCron> & JobComputedProperties;
 export type ScheduleJobOptions = {
     /**
-     * The number of seconds to wait before scheduling this job. This is mutually
-     * exclusive with `waitUntil`.
+     * The number of seconds to wait before scheduling this job. This is
+     * mutually exclusive with `waitUntil`.
      */
     wait: number;
     waitUntil?: never;
 } | {
     wait?: never;
     /**
-     * The date and time to schedule this job for. This is mutually exclusive with
-     * `wait`.
+     * The date and time to schedule this job for. This is mutually exclusive
+     * with `wait`.
      */
     waitUntil: Date;
 };
 type PriorityValue = IntRange<1, 101>;
-export type CreateSchedulerArgs<TJob extends Job<QueueNames>> = Parameters<TJob['perform']> extends [] ? [ScheduleJobOptions?] | [[], ScheduleJobOptions?] : [Parameters<TJob['perform']>, ScheduleJobOptions?];
+/**
+ * If the job has no arguments:
+ *  - you may pass an empty array for the arguments and then optionally pass the
+ *    scheduler options
+ *  - you may optionally pass the scheduler options
+ * If the job has arguments:
+ *  - you must pass the arguments and then optionally pass the scheduler options
+ * If the job has a cron schedule defined:
+ *  - options are not allowed (cron jobs are scheduled automatically)
+ */
+export type CreateSchedulerArgs<TJob extends Job<QueueNames, any[], any>> = TJob['cron'] extends '' ? Parameters<TJob['perform']> extends [] ? [ScheduleJobOptions?] | [[], ScheduleJobOptions?] : [Parameters<TJob['perform']>, ScheduleJobOptions?] : TJob['cron'] extends string ? Parameters<TJob['perform']> extends [] ? [] | [[]] : [Parameters<TJob['perform']>] : Parameters<TJob['perform']> extends [] ? [ScheduleJobOptions?] | [[], ScheduleJobOptions?] : [Parameters<TJob['perform']>, ScheduleJobOptions?];
 export {};
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cedarjs/jobs",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/cedarjs/cedar.git",
@@ -38,12 +38,13 @@
     "test:watch": "vitest"
   },
   "dependencies": {
-    "@cedarjs/cli-helpers": "0.2.0",
-    "@cedarjs/project-config": "0.2.0",
+    "@cedarjs/cli-helpers": "0.3.0",
+    "@cedarjs/project-config": "0.3.0",
+    "cron-parser": "5.3.0",
     "type-fest": "4.26.1"
   },
   "devDependencies": {
-    "@cedarjs/framework-tools": "0.2.0",
+    "@cedarjs/framework-tools": "0.3.0",
     "@prisma/client": "5.20.0",
     "concurrently": "8.2.2",
     "publint": "0.3.12",
@@ -54,5 +55,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "568c8f994789688a43c5f57181505d7461417b0f"
+  "gitHead": "ebf827bba666cc5a129823079056d0b0e8280aad"
 }