@gravito/horizon 3.2.2 → 4.0.0

package/dist/index.cjs

@@ -7820,6 +7820,35 @@ __export(index_exports, {
 });
 module.exports = __toCommonJS(index_exports);
 
+// src/errors/HorizonError.ts
+var import_core = require("@gravito/core");
+var HorizonError = class extends import_core.SystemException {
+  constructor(status, code, options = {}) {
+    super(status, code, options);
+    this.name = "HorizonError";
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+};
+
+// src/errors/codes.ts
+var HorizonErrorCodes = {
+  // Scheduling errors
+  CRON_PARSE_ERROR: "horizon.cron_parse_error",
+  SCHEDULE_FAILED: "horizon.schedule_failed",
+  COMMAND_FAILED: "horizon.command_failed",
+  // Validation errors
+  INVALID_TIME_FORMAT: "horizon.invalid_time_format",
+  INVALID_MINUTE: "horizon.invalid_minute",
+  INVALID_DAY_OF_WEEK: "horizon.invalid_day_of_week",
+  INVALID_DAY_OF_MONTH: "horizon.invalid_day_of_month",
+  INVALID_TIMEOUT: "horizon.invalid_timeout",
+  INVALID_RETRY_ATTEMPTS: "horizon.invalid_retry_attempts",
+  INVALID_RETRY_DELAY: "horizon.invalid_retry_delay",
+  INVALID_TIMEZONE: "horizon.invalid_timezone",
+  // Lock errors
+  LOCK_DRIVER_REQUIRED: "horizon.lock_driver_required"
+};
+
 // src/SimpleCronParser.ts
 var SimpleCronParser = class {
   /**
@@ -7839,7 +7868,9 @@ var SimpleCronParser = class {
   static isDue(expression, timezone = "UTC", date = /* @__PURE__ */ new Date()) {
     const parts = expression.trim().split(/\s+/);
     if (parts.length !== 5) {
-      throw new Error(`Invalid cron expression: ${expression}`);
+      throw new HorizonError(422, HorizonErrorCodes.CRON_PARSE_ERROR, {
+        message: `Invalid cron expression: ${expression}`
+      });
     }
     const targetDate = this.getDateInTimezone(date, timezone);
     const minutes = targetDate.getMinutes();
@@ -7902,11 +7933,16 @@ var SimpleCronParser = class {
     try {
       const tzDate = new Date(date.toLocaleString("en-US", { timeZone: timezone }));
       if (Number.isNaN(tzDate.getTime())) {
-        throw new Error();
+        throw new HorizonError(422, HorizonErrorCodes.INVALID_TIMEZONE, {
+          message: `Invalid timezone: ${timezone}`
+        });
       }
       return tzDate;
-    } catch {
-      throw new Error(`Invalid timezone: ${timezone}`);
+    } catch (err) {
+      if (err instanceof HorizonError) throw err;
+      throw new HorizonError(422, HorizonErrorCodes.INVALID_TIMEZONE, {
+        message: `Invalid timezone: ${timezone}`
+      });
     }
   }
 };
@@ -7943,7 +7979,9 @@ var CronParser = class {
       });
       return interval.next().toDate();
     } catch (_err) {
-      throw new Error(`Invalid cron expression: ${expression}`);
+      throw new HorizonError(422, HorizonErrorCodes.CRON_PARSE_ERROR, {
+        message: `Invalid cron expression: ${expression}`
+      });
     }
   }
   /**
@@ -8166,7 +8204,9 @@ var LockManager = class {
       this.store = new MemoryLockStore();
     } else if (driver === "cache") {
       if (!context?.cache) {
-        throw new Error("CacheManager is required for cache lock driver");
+        throw new HorizonError(422, HorizonErrorCodes.LOCK_DRIVER_REQUIRED, {
+          message: "CacheManager is required for cache lock driver"
+        });
       }
       this.store = new CacheLockStore(context.cache);
     } else {
@@ -8247,28 +8287,38 @@ function parseTime(time) {
   const timePattern = /^([0-2]\d):([0-5]\d)$/;
   const match = time.match(timePattern);
   if (!match) {
-    throw new Error(`Invalid time format: "${time}". Expected HH:mm (24-hour format, 00:00-23:59)`);
+    throw new HorizonError(422, HorizonErrorCodes.INVALID_TIME_FORMAT, {
+      message: `Invalid time format: "${time}". Expected HH:mm (24-hour format, 00:00-23:59)`
+    });
   }
   const hour = Number.parseInt(match[1], 10);
   const minute = Number.parseInt(match[2], 10);
   if (hour > 23) {
-    throw new Error(`Invalid time format: "${time}". Expected HH:mm (24-hour format, 00:00-23:59)`);
+    throw new HorizonError(422, HorizonErrorCodes.INVALID_TIME_FORMAT, {
+      message: `Invalid time format: "${time}". Expected HH:mm (24-hour format, 00:00-23:59)`
+    });
   }
   return { hour, minute };
 }
 function validateMinute(minute) {
   if (!Number.isInteger(minute) || minute < 0 || minute > 59) {
-    throw new Error(`Invalid minute: ${minute}. Expected integer 0-59`);
+    throw new HorizonError(422, HorizonErrorCodes.INVALID_MINUTE, {
+      message: `Invalid minute: ${minute}. Expected integer 0-59`
+    });
   }
 }
 function validateDayOfWeek(dayOfWeek) {
   if (!Number.isInteger(dayOfWeek) || dayOfWeek < 0 || dayOfWeek > 6) {
-    throw new Error(`Invalid day of week: ${dayOfWeek}. Expected 0-6 (Sunday=0, Saturday=6)`);
+    throw new HorizonError(422, HorizonErrorCodes.INVALID_DAY_OF_WEEK, {
+      message: `Invalid day of week: ${dayOfWeek}. Expected 0-6 (Sunday=0, Saturday=6)`
+    });
   }
 }
 function validateDayOfMonth(dayOfMonth) {
   if (!Number.isInteger(dayOfMonth) || dayOfMonth < 1 || dayOfMonth > 31) {
-    throw new Error(`Invalid day of month: ${dayOfMonth}. Expected 1-31`);
+    throw new HorizonError(422, HorizonErrorCodes.INVALID_DAY_OF_MONTH, {
+      message: `Invalid day of month: ${dayOfMonth}. Expected 1-31`
+    });
   }
 }
 
@@ -8316,16 +8366,16 @@ var TaskSchedule = class {
   cron(expression) {
     const parts = expression.trim().split(/\s+/);
     if (parts.length !== 5) {
-      throw new Error(
-        `Invalid cron expression: "${expression}". Expected 5 parts (minute hour day month weekday), got ${parts.length}.`
-      );
+      throw new HorizonError(422, HorizonErrorCodes.CRON_PARSE_ERROR, {
+        message: `Invalid cron expression: "${expression}". Expected 5 parts (minute hour day month weekday), got ${parts.length}.`
+      });
     }
     const pattern = /^[0-9,\-/*?L#A-Za-z]+$/;
     for (let i = 0; i < 5; i++) {
       if (!pattern.test(parts[i])) {
-        throw new Error(
-          `Invalid cron expression: "${expression}". Part ${i + 1} ("${parts[i]}") contains invalid characters.`
-        );
+        throw new HorizonError(422, HorizonErrorCodes.CRON_PARSE_ERROR, {
+          message: `Invalid cron expression: "${expression}". Part ${i + 1} ("${parts[i]}") contains invalid characters.`
+        });
       }
     }
     this.task.expression = expression;
@@ -8473,9 +8523,9 @@ var TaskSchedule = class {
     try {
       (/* @__PURE__ */ new Date()).toLocaleString("en-US", { timeZone: timezone });
     } catch {
-      throw new Error(
-        `Invalid timezone: "${timezone}". See https://en.wikipedia.org/wiki/List_of_tz_database_time_zones for valid values.`
-      );
+      throw new HorizonError(422, HorizonErrorCodes.INVALID_TIMEZONE, {
+        message: `Invalid timezone: "${timezone}". See https://en.wikipedia.org/wiki/List_of_tz_database_time_zones for valid values.`
+      });
     }
     this.task.timezone = timezone;
     return this;
@@ -8561,7 +8611,9 @@ var TaskSchedule = class {
    */
   timeout(ms) {
     if (ms <= 0) {
-      throw new Error("Timeout must be a positive number");
+      throw new HorizonError(422, HorizonErrorCodes.INVALID_TIMEOUT, {
+        message: "Timeout must be a positive number"
+      });
     }
     this.task.timeout = ms;
     return this;
@@ -8576,10 +8628,14 @@ var TaskSchedule = class {
    */
   retry(attempts = 3, delayMs = 1e3) {
     if (attempts < 0) {
-      throw new Error("Retry attempts must be non-negative");
+      throw new HorizonError(422, HorizonErrorCodes.INVALID_RETRY_ATTEMPTS, {
+        message: "Retry attempts must be non-negative"
+      });
     }
     if (delayMs < 0) {
-      throw new Error("Retry delay must be non-negative");
+      throw new HorizonError(422, HorizonErrorCodes.INVALID_RETRY_DELAY, {
+        message: "Retry delay must be non-negative"
+      });
     }
     this.task.retries = attempts;
     this.task.retryDelay = delayMs;
@@ -8694,7 +8750,9 @@ var SchedulerManager = class {
     const task = new TaskSchedule(name, async () => {
       const result = await Process.run(command);
       if (!result.success) {
-        throw new Error(`Command failed: ${result.stderr || result.stdout}`);
+        throw new HorizonError(500, HorizonErrorCodes.COMMAND_FAILED, {
+          message: `Command failed: ${result.stderr || result.stdout}`
+        });
       }
     });
     task.setCommand(command);

package/dist/index.js

@@ -1,5 +1,34 @@
 import "./chunk-MCKGQKYU.js";
 
+// src/errors/HorizonError.ts
+import { SystemException } from "@gravito/core";
+var HorizonError = class extends SystemException {
+  constructor(status, code, options = {}) {
+    super(status, code, options);
+    this.name = "HorizonError";
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+};
+
+// src/errors/codes.ts
+var HorizonErrorCodes = {
+  // Scheduling errors
+  CRON_PARSE_ERROR: "horizon.cron_parse_error",
+  SCHEDULE_FAILED: "horizon.schedule_failed",
+  COMMAND_FAILED: "horizon.command_failed",
+  // Validation errors
+  INVALID_TIME_FORMAT: "horizon.invalid_time_format",
+  INVALID_MINUTE: "horizon.invalid_minute",
+  INVALID_DAY_OF_WEEK: "horizon.invalid_day_of_week",
+  INVALID_DAY_OF_MONTH: "horizon.invalid_day_of_month",
+  INVALID_TIMEOUT: "horizon.invalid_timeout",
+  INVALID_RETRY_ATTEMPTS: "horizon.invalid_retry_attempts",
+  INVALID_RETRY_DELAY: "horizon.invalid_retry_delay",
+  INVALID_TIMEZONE: "horizon.invalid_timezone",
+  // Lock errors
+  LOCK_DRIVER_REQUIRED: "horizon.lock_driver_required"
+};
+
 // src/SimpleCronParser.ts
 var SimpleCronParser = class {
   /**
@@ -19,7 +48,9 @@ var SimpleCronParser = class {
   static isDue(expression, timezone = "UTC", date = /* @__PURE__ */ new Date()) {
     const parts = expression.trim().split(/\s+/);
     if (parts.length !== 5) {
-      throw new Error(`Invalid cron expression: ${expression}`);
+      throw new HorizonError(422, HorizonErrorCodes.CRON_PARSE_ERROR, {
+        message: `Invalid cron expression: ${expression}`
+      });
     }
     const targetDate = this.getDateInTimezone(date, timezone);
     const minutes = targetDate.getMinutes();
@@ -82,11 +113,16 @@ var SimpleCronParser = class {
     try {
       const tzDate = new Date(date.toLocaleString("en-US", { timeZone: timezone }));
       if (Number.isNaN(tzDate.getTime())) {
-        throw new Error();
+        throw new HorizonError(422, HorizonErrorCodes.INVALID_TIMEZONE, {
+          message: `Invalid timezone: ${timezone}`
+        });
       }
       return tzDate;
-    } catch {
-      throw new Error(`Invalid timezone: ${timezone}`);
+    } catch (err) {
+      if (err instanceof HorizonError) throw err;
+      throw new HorizonError(422, HorizonErrorCodes.INVALID_TIMEZONE, {
+        message: `Invalid timezone: ${timezone}`
+      });
     }
   }
 };
@@ -123,7 +159,9 @@ var CronParser = class {
       });
       return interval.next().toDate();
     } catch (_err) {
-      throw new Error(`Invalid cron expression: ${expression}`);
+      throw new HorizonError(422, HorizonErrorCodes.CRON_PARSE_ERROR, {
+        message: `Invalid cron expression: ${expression}`
+      });
     }
   }
   /**
@@ -346,7 +384,9 @@ var LockManager = class {
       this.store = new MemoryLockStore();
     } else if (driver === "cache") {
       if (!context?.cache) {
-        throw new Error("CacheManager is required for cache lock driver");
+        throw new HorizonError(422, HorizonErrorCodes.LOCK_DRIVER_REQUIRED, {
+          message: "CacheManager is required for cache lock driver"
+        });
       }
       this.store = new CacheLockStore(context.cache);
     } else {
@@ -427,28 +467,38 @@ function parseTime(time) {
   const timePattern = /^([0-2]\d):([0-5]\d)$/;
   const match = time.match(timePattern);
   if (!match) {
-    throw new Error(`Invalid time format: "${time}". Expected HH:mm (24-hour format, 00:00-23:59)`);
+    throw new HorizonError(422, HorizonErrorCodes.INVALID_TIME_FORMAT, {
+      message: `Invalid time format: "${time}". Expected HH:mm (24-hour format, 00:00-23:59)`
+    });
   }
   const hour = Number.parseInt(match[1], 10);
   const minute = Number.parseInt(match[2], 10);
   if (hour > 23) {
-    throw new Error(`Invalid time format: "${time}". Expected HH:mm (24-hour format, 00:00-23:59)`);
+    throw new HorizonError(422, HorizonErrorCodes.INVALID_TIME_FORMAT, {
+      message: `Invalid time format: "${time}". Expected HH:mm (24-hour format, 00:00-23:59)`
+    });
   }
   return { hour, minute };
 }
 function validateMinute(minute) {
   if (!Number.isInteger(minute) || minute < 0 || minute > 59) {
-    throw new Error(`Invalid minute: ${minute}. Expected integer 0-59`);
+    throw new HorizonError(422, HorizonErrorCodes.INVALID_MINUTE, {
+      message: `Invalid minute: ${minute}. Expected integer 0-59`
+    });
   }
 }
 function validateDayOfWeek(dayOfWeek) {
   if (!Number.isInteger(dayOfWeek) || dayOfWeek < 0 || dayOfWeek > 6) {
-    throw new Error(`Invalid day of week: ${dayOfWeek}. Expected 0-6 (Sunday=0, Saturday=6)`);
+    throw new HorizonError(422, HorizonErrorCodes.INVALID_DAY_OF_WEEK, {
+      message: `Invalid day of week: ${dayOfWeek}. Expected 0-6 (Sunday=0, Saturday=6)`
+    });
   }
 }
 function validateDayOfMonth(dayOfMonth) {
   if (!Number.isInteger(dayOfMonth) || dayOfMonth < 1 || dayOfMonth > 31) {
-    throw new Error(`Invalid day of month: ${dayOfMonth}. Expected 1-31`);
+    throw new HorizonError(422, HorizonErrorCodes.INVALID_DAY_OF_MONTH, {
+      message: `Invalid day of month: ${dayOfMonth}. Expected 1-31`
+    });
   }
 }
 
@@ -496,16 +546,16 @@ var TaskSchedule = class {
   cron(expression) {
     const parts = expression.trim().split(/\s+/);
     if (parts.length !== 5) {
-      throw new Error(
-        `Invalid cron expression: "${expression}". Expected 5 parts (minute hour day month weekday), got ${parts.length}.`
-      );
+      throw new HorizonError(422, HorizonErrorCodes.CRON_PARSE_ERROR, {
+        message: `Invalid cron expression: "${expression}". Expected 5 parts (minute hour day month weekday), got ${parts.length}.`
+      });
     }
     const pattern = /^[0-9,\-/*?L#A-Za-z]+$/;
     for (let i = 0; i < 5; i++) {
       if (!pattern.test(parts[i])) {
-        throw new Error(
-          `Invalid cron expression: "${expression}". Part ${i + 1} ("${parts[i]}") contains invalid characters.`
-        );
+        throw new HorizonError(422, HorizonErrorCodes.CRON_PARSE_ERROR, {
+          message: `Invalid cron expression: "${expression}". Part ${i + 1} ("${parts[i]}") contains invalid characters.`
+        });
       }
     }
     this.task.expression = expression;
@@ -653,9 +703,9 @@ var TaskSchedule = class {
     try {
       (/* @__PURE__ */ new Date()).toLocaleString("en-US", { timeZone: timezone });
     } catch {
-      throw new Error(
-        `Invalid timezone: "${timezone}". See https://en.wikipedia.org/wiki/List_of_tz_database_time_zones for valid values.`
-      );
+      throw new HorizonError(422, HorizonErrorCodes.INVALID_TIMEZONE, {
+        message: `Invalid timezone: "${timezone}". See https://en.wikipedia.org/wiki/List_of_tz_database_time_zones for valid values.`
+      });
     }
     this.task.timezone = timezone;
     return this;
@@ -741,7 +791,9 @@ var TaskSchedule = class {
    */
   timeout(ms) {
     if (ms <= 0) {
-      throw new Error("Timeout must be a positive number");
+      throw new HorizonError(422, HorizonErrorCodes.INVALID_TIMEOUT, {
+        message: "Timeout must be a positive number"
+      });
     }
     this.task.timeout = ms;
     return this;
@@ -756,10 +808,14 @@ var TaskSchedule = class {
    */
   retry(attempts = 3, delayMs = 1e3) {
     if (attempts < 0) {
-      throw new Error("Retry attempts must be non-negative");
+      throw new HorizonError(422, HorizonErrorCodes.INVALID_RETRY_ATTEMPTS, {
+        message: "Retry attempts must be non-negative"
+      });
     }
     if (delayMs < 0) {
-      throw new Error("Retry delay must be non-negative");
+      throw new HorizonError(422, HorizonErrorCodes.INVALID_RETRY_DELAY, {
+        message: "Retry delay must be non-negative"
+      });
     }
     this.task.retries = attempts;
     this.task.retryDelay = delayMs;
@@ -874,7 +930,9 @@ var SchedulerManager = class {
     const task = new TaskSchedule(name, async () => {
       const result = await Process.run(command);
       if (!result.success) {
-        throw new Error(`Command failed: ${result.stderr || result.stdout}`);
+        throw new HorizonError(500, HorizonErrorCodes.COMMAND_FAILED, {
+          message: `Command failed: ${result.stderr || result.stdout}`
+        });
       }
     });
     task.setCommand(command);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@gravito/horizon",
   "sideEffects": false,
-  "version": "3.2.2",
+  "version": "4.0.0",
   "description": "Distributed task scheduler for Gravito framework",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
@@ -46,8 +46,8 @@
     "cron-parser": "^4.9.0"
   },
   "peerDependencies": {
-    "@gravito/core": "^2.0.0",
-    "@gravito/stasis": "^3.2.0"
+    "@gravito/core": "^3.0.0",
+    "@gravito/stasis": "^4.0.0"
   },
   "devDependencies": {
     "@gravito/stasis": "workspace:*",