@lunora/scheduler 1.0.0-alpha.4 → 1.0.0-alpha.6

package/LICENSE.md

@@ -103,3 +103,9 @@ Unless required by applicable law or agreed to in writing, software distributed
 under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
 CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+<!-- DEPENDENCIES -->
+<!-- /DEPENDENCIES -->
+
+<!-- TYPE_DEPENDENCIES -->
+<!-- /TYPE_DEPENDENCIES -->

package/dist/index.mjs

@@ -1,8 +1,8 @@
-export { default as createScheduler } from './packem_shared/createScheduler-CWMn70nv.mjs';
-export { default as createWorkpool } from './packem_shared/createWorkpool-CEnqCafM.mjs';
-export { createCronTrigger } from './packem_shared/createCronTrigger-Cq9IBcWQ.mjs';
-export { CRON_SCHEDULE_KINDS, compileCronSchedule, cronJobs } from './packem_shared/CRON_SCHEDULE_KINDS-BaLlXJiN.mjs';
-export { createQueueConsumer, createQueueWorkpool, httpDispatcher } from './packem_shared/createQueueConsumer-DWahNPfz.mjs';
-export { SchedulerDO } from './packem_shared/SchedulerDO-CQfTGw7C.mjs';
+export { default as createScheduler } from './packem_shared/createScheduler-CcD09oIm.mjs';
+export { default as createWorkpool } from './packem_shared/createWorkpool-C28trhTA.mjs';
+export { createCronTrigger } from './packem_shared/createCronTrigger-Dh4VLxD9.mjs';
+export { CRON_SCHEDULE_KINDS, compileCronSchedule, cronJobs } from './packem_shared/CRON_SCHEDULE_KINDS-BMVeCHOu.mjs';
+export { createQueueConsumer, createQueueWorkpool, httpDispatcher } from './packem_shared/createQueueConsumer-Cy-Mp-El.mjs';
+export { SchedulerDO } from './packem_shared/SchedulerDO-DVeJrNbs.mjs';
 export { isWorkflowReference } from './packem_shared/isWorkflowReference-C9mQkMXt.mjs';
-export { assertValidCronExpression, isValidCronExpression } from './packem_shared/assertValidCronExpression-BLfrDgmK.mjs';
+export { assertValidCronExpression, isValidCronExpression } from './packem_shared/assertValidCronExpression-B9m75qU0.mjs';

package/dist/packem_shared/{CRON_SCHEDULE_KINDS-BaLlXJiN.mjs → CRON_SCHEDULE_KINDS-BMVeCHOu.mjs}

@@ -1,5 +1,6 @@
+import { LunoraError } from '@lunora/errors';
 import { isWorkflowReference } from './isWorkflowReference-C9mQkMXt.mjs';
-import { assertValidCronExpression } from './assertValidCronExpression-BLfrDgmK.mjs';
+import { assertValidCronExpression } from './assertValidCronExpression-B9m75qU0.mjs';
 
 const WEEKDAY_INDEX = {
   friday: 5,
@@ -12,14 +13,17 @@ const WEEKDAY_INDEX = {
 };
 const field = (value, label, min, max) => {
   if (!Number.isInteger(value) || value < min || value > max) {
-    throw new Error(`@lunora/scheduler: cronJobs ${label} must be an integer in [${min.toFixed(0)}, ${max.toFixed(0)}], got ${String(value)}`);
+    throw new LunoraError(
+      "INTERNAL",
+      `@lunora/scheduler: cronJobs ${label} must be an integer in [${min.toFixed(0)}, ${max.toFixed(0)}], got ${String(value)}`
+    );
   }
   return value.toFixed(0);
 };
 const compileInterval = (schedule) => {
   const units = ["seconds", "minutes", "hours"].filter((unit2) => schedule[unit2] !== void 0);
   if (units.length !== 1) {
-    throw new Error(`@lunora/scheduler: interval schedule must specify exactly one of { seconds, minutes, hours }`);
+    throw new LunoraError("INTERNAL", `@lunora/scheduler: interval schedule must specify exactly one of { seconds, minutes, hours }`);
   }
   const unit = units[0];
   const value = schedule[unit];
@@ -39,7 +43,7 @@ const compileDaily = (schedule) => {
 const compileWeekly = (schedule) => {
   const index = WEEKDAY_INDEX[schedule.dayOfWeek];
   if (index === void 0) {
-    throw new Error(`@lunora/scheduler: weekly schedule has invalid dayOfWeek "${schedule.dayOfWeek}"`);
+    throw new LunoraError("INTERNAL", `@lunora/scheduler: weekly schedule has invalid dayOfWeek "${schedule.dayOfWeek}"`);
   }
   const minute = field(schedule.minuteUTC, "weekly.minuteUTC", 0, 59);
   const hour = field(schedule.hourUTC, "weekly.hourUTC", 0, 23);
@@ -67,7 +71,7 @@ const compileCronSchedule = (kind, schedule) => {
       return compileWeekly(schedule);
     }
     default: {
-      throw new Error(`@lunora/scheduler: unknown cron schedule kind "${String(kind)}"`);
+      throw new LunoraError("INTERNAL", `@lunora/scheduler: unknown cron schedule kind "${String(kind)}"`);
     }
   }
 };
@@ -76,10 +80,10 @@ const cronJobs = () => {
   const seen = /* @__PURE__ */ new Set();
   const register = (name, cron, target, args) => {
     if (typeof name !== "string" || name.trim() === "") {
-      throw new Error(`@lunora/scheduler: cron job name must be a non-empty string`);
+      throw new LunoraError("INTERNAL", `@lunora/scheduler: cron job name must be a non-empty string`);
     }
     if (seen.has(name)) {
-      throw new Error(`@lunora/scheduler: duplicate cron job name "${name}" — names must be unique within one cronJobs()`);
+      throw new LunoraError("INTERNAL", `@lunora/scheduler: duplicate cron job name "${name}" — names must be unique within one cronJobs()`);
     }
     if (isWorkflowReference(target)) {
       assertValidCronExpression(cron, `cron expression for job "${name}"`);
@@ -88,7 +92,10 @@ const cronJobs = () => {
       return;
     }
     if (!target || typeof target.__lunoraRef !== "string") {
-      throw new Error(`@lunora/scheduler: cron job "${name}" requires a function reference (e.g. internal.email.digest) or a workflow reference`);
+      throw new LunoraError(
+        "INTERNAL",
+        `@lunora/scheduler: cron job "${name}" requires a function reference (e.g. internal.email.digest) or a workflow reference`
+      );
     }
     assertValidCronExpression(cron, `cron expression for job "${name}"`);
     seen.add(name);

package/dist/packem_shared/{SchedulerDO-CQfTGw7C.mjs → SchedulerDO-DVeJrNbs.mjs}

@@ -1,3 +1,5 @@
+const jsonResponse = (body, status = 200, headers) => Response.json(body, { headers: { "content-type": "application/json", ...headers }, status });
+
 const HEADER_PREFIX = "id:";
 const RETRY_PREFIX = "retry:";
 const DEAD_PREFIX = "dead:";
@@ -21,7 +23,7 @@ class SchedulerDO {
     return `t:${padTime(scheduledFor)}:${id}`;
   }
   static json(body, status = 200) {
-    return Response.json(body, { headers: { "content-type": "application/json" }, status });
+    return jsonResponse(body, status);
   }
   static error(status, code, message) {
     return SchedulerDO.json({ error: { code, message } }, status);
@@ -143,13 +145,7 @@ class SchedulerDO {
         return this.handleSchedule(request);
       }
     }
-    return Response.json(
-      { error: { code: "NOT_FOUND" } },
-      {
-        headers: { "content-type": "application/json" },
-        status: 404
-      }
-    );
+    return jsonResponse({ error: { code: "NOT_FOUND" } }, 404);
   }
   /** Called by the Workers runtime when the alarm previously set by `_rescheduleAlarm()` fires. */
   async alarm() {

package/dist/packem_shared/{assertValidCronExpression-BLfrDgmK.mjs → assertValidCronExpression-B9m75qU0.mjs}

@@ -1,3 +1,4 @@
+import { LunoraError } from '@lunora/errors';
 import { CronExpressionParser } from 'cron-parser';
 
 const isValidCronExpression = (schedule) => {
@@ -13,7 +14,10 @@ const isValidCronExpression = (schedule) => {
 };
 const assertValidCronExpression = (schedule, context = "cron expression") => {
   if (!isValidCronExpression(schedule)) {
-    throw new Error(`@lunora/scheduler: invalid ${context} "${schedule}" — expected a standard 5- or 6-field cron expression (e.g. "0 * * * *")`);
+    throw new LunoraError(
+      "INTERNAL",
+      `@lunora/scheduler: invalid ${context} "${schedule}" — expected a standard 5- or 6-field cron expression (e.g. "0 * * * *")`
+    );
   }
 };
 

package/dist/packem_shared/{createCronTrigger-Cq9IBcWQ.mjs → createCronTrigger-Dh4VLxD9.mjs}

@@ -1,8 +1,9 @@
-import { assertValidCronExpression } from './assertValidCronExpression-BLfrDgmK.mjs';
+import { LunoraError } from '@lunora/errors';
+import { assertValidCronExpression } from './assertValidCronExpression-B9m75qU0.mjs';
 
 const createCronTrigger = (options) => {
   if (!options.schedule || !options.fn) {
-    throw new Error("@lunora/scheduler: createCronTrigger() requires `schedule` and `fn`");
+    throw new LunoraError("INTERNAL", "@lunora/scheduler: createCronTrigger() requires `schedule` and `fn`");
   }
   assertValidCronExpression(options.schedule);
   const snippet = JSON.stringify(

package/dist/packem_shared/{createQueueConsumer-DWahNPfz.mjs → createQueueConsumer-Cy-Mp-El.mjs}

@@ -1,3 +1,5 @@
+import { LunoraError } from '@lunora/errors';
+
 const trimTrailingSlashes = (value) => {
   let end = value.length;
   while (end > 0 && value[end - 1] === "/") {
@@ -7,7 +9,7 @@ const trimTrailingSlashes = (value) => {
 };
 const createQueueWorkpool = (options) => {
   if (!options.queue) {
-    throw new Error("@lunora/scheduler: `queue` (a Cloudflare Queue binding) is required");
+    throw new LunoraError("INTERNAL", "@lunora/scheduler: `queue` (a Cloudflare Queue binding) is required");
   }
   const enqueue = async (function_, args, enqueueOptions = {}) => {
     const job = { args, functionPath: function_.__lunoraRef, shardKey: enqueueOptions.shardKey };
@@ -28,7 +30,7 @@ const createQueueConsumer = (options) => async (batch) => {
     batch.messages.map(async (message) => {
       try {
         if (!isQueueJob(message.body)) {
-          throw new Error("@lunora/scheduler: queue message body is not a QueueJob (missing functionPath)");
+          throw new LunoraError("INTERNAL", "@lunora/scheduler: queue message body is not a QueueJob (missing functionPath)");
         }
         await options.dispatch(message.body);
         message.ack();
@@ -51,7 +53,7 @@ const httpDispatcher = (options) => {
       method: "POST"
     });
     if (!response.ok) {
-      throw new Error(`@lunora/scheduler: queue dispatch failed (${response.status.toString()}): ${await response.text()}`);
+      throw new LunoraError("INTERNAL", `@lunora/scheduler: queue dispatch failed (${response.status.toString()}): ${await response.text()}`);
     }
   };
 };

package/dist/packem_shared/{createScheduler-CWMn70nv.mjs → createScheduler-CcD09oIm.mjs}

@@ -1,3 +1,4 @@
+import { LunoraError } from '@lunora/errors';
 import { a as applyJurisdiction } from './jurisdiction-CR2zC3Et.mjs';
 
 const schedulerStub = (options) => {
@@ -13,7 +14,7 @@ const callDO = async (options, path, body) => {
   });
   if (!response.ok) {
     const text = await response.text();
-    throw new Error(`@lunora/scheduler: SchedulerDO ${path} failed (${String(response.status)}): ${text}`);
+    throw new LunoraError("INTERNAL", `@lunora/scheduler: SchedulerDO ${path} failed (${String(response.status)}): ${text}`);
   }
   return await response.json();
 };
@@ -22,16 +23,16 @@ const getDO = async (options, path) => {
   const response = await stub.fetch(`https://scheduler.internal${path}`, { method: "GET" });
   if (!response.ok) {
     const text = await response.text();
-    throw new Error(`@lunora/scheduler: SchedulerDO ${path} failed (${String(response.status)}): ${text}`);
+    throw new LunoraError("INTERNAL", `@lunora/scheduler: SchedulerDO ${path} failed (${String(response.status)}): ${text}`);
   }
   return await response.json();
 };
 const createScheduler = (options) => {
   if (!options.namespace) {
-    throw new Error("@lunora/scheduler: `namespace` (SchedulerDO binding) is required");
+    throw new LunoraError("INTERNAL", "@lunora/scheduler: `namespace` (SchedulerDO binding) is required");
   }
   if (!options.originUrl) {
-    throw new Error("@lunora/scheduler: `originUrl` is required so the DO can dispatch back to the Worker");
+    throw new LunoraError("INTERNAL", "@lunora/scheduler: `originUrl` is required so the DO can dispatch back to the Worker");
   }
   const runAt = async (date, function_, args, options_ = {}) => {
     const scheduledFor = date instanceof Date ? date.getTime() : date;
@@ -50,7 +51,7 @@ const createScheduler = (options) => {
   };
   const runAfter = async (delayMs, function_, args, options_ = {}) => {
     if (!Number.isFinite(delayMs) || delayMs < 0) {
-      throw new Error("@lunora/scheduler: `delayMs` must be a non-negative finite number");
+      throw new LunoraError("INTERNAL", "@lunora/scheduler: `delayMs` must be a non-negative finite number");
     }
     return runAt(Date.now() + delayMs, function_, args, options_);
   };

package/dist/packem_shared/{createWorkpool-CEnqCafM.mjs → createWorkpool-C28trhTA.mjs}

@@ -1,3 +1,4 @@
+import { LunoraError } from '@lunora/errors';
 import { a as applyJurisdiction } from './jurisdiction-CR2zC3Et.mjs';
 
 const workpoolStub = (options) => {
@@ -13,7 +14,7 @@ const callDO = async (options, path, body) => {
   });
   if (!response.ok) {
     const text = await response.text();
-    throw new Error(`@lunora/scheduler: SchedulerDO ${path} failed (${String(response.status)}): ${text}`);
+    throw new LunoraError("INTERNAL", `@lunora/scheduler: SchedulerDO ${path} failed (${String(response.status)}): ${text}`);
   }
   return await response.json();
 };
@@ -22,25 +23,25 @@ const getDO = async (options, path) => {
   const response = await stub.fetch(`https://scheduler.internal${path}`, { method: "GET" });
   if (!response.ok) {
     const text = await response.text();
-    throw new Error(`@lunora/scheduler: SchedulerDO ${path} failed (${String(response.status)}): ${text}`);
+    throw new LunoraError("INTERNAL", `@lunora/scheduler: SchedulerDO ${path} failed (${String(response.status)}): ${text}`);
   }
   return await response.json();
 };
 const createWorkpool = (options) => {
   if (!options.namespace) {
-    throw new Error("@lunora/scheduler: `namespace` (SchedulerDO binding) is required");
+    throw new LunoraError("INTERNAL", "@lunora/scheduler: `namespace` (SchedulerDO binding) is required");
   }
   if (!options.originUrl) {
-    throw new Error("@lunora/scheduler: `originUrl` is required so the DO can dispatch back to the Worker");
+    throw new LunoraError("INTERNAL", "@lunora/scheduler: `originUrl` is required so the DO can dispatch back to the Worker");
   }
   if (!Number.isInteger(options.maxConcurrency) || options.maxConcurrency <= 0) {
-    throw new Error("@lunora/scheduler: `maxConcurrency` must be a positive integer");
+    throw new LunoraError("INTERNAL", "@lunora/scheduler: `maxConcurrency` must be a positive integer");
   }
   const name = typeof options.name === "string" && options.name.length > 0 ? options.name : "default";
   const enqueue = async (function_, args, options_ = {}) => {
     const delayMs = options_.delayMs ?? 0;
     if (!Number.isFinite(delayMs) || delayMs < 0) {
-      throw new Error("@lunora/scheduler: `delayMs` must be a non-negative finite number");
+      throw new LunoraError("INTERNAL", "@lunora/scheduler: `delayMs` must be a non-negative finite number");
     }
     return callDO(options, "/schedule", {
       args,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lunora/scheduler",
-  "version": "1.0.0-alpha.4",
+  "version": "1.0.0-alpha.6",
   "description": "Scheduling for Lunora: runAfter / runAt and Cron Triggers via SchedulerDO",
   "keywords": [
     "cloudflare",
@@ -46,6 +46,7 @@
     "access": "public"
   },
   "dependencies": {
+    "@lunora/errors": "1.0.0-alpha.2",
     "cron-parser": "5.6.1"
   },
   "engines": {