@gravito/horizon 2.0.0 → 3.0.1

package/dist/index.cjs

@@ -7822,128 +7822,59 @@ __export(index_exports, {
 module.exports = __toCommonJS(index_exports);
 
 // src/SimpleCronParser.ts
-var SimpleCronParser = {
+var SimpleCronParser = class {
   /**
-   * Check if a cron expression matches the given date.
-   * Only supports standard 5-field cron expressions.
-   *
-   * Fields: minute hour day-of-month month day-of-week
-   * Values:
-   *  - * (any)
-   *  - numbers (0-59, 1-31, 0-11, 0-7)
-   *  - ranges (1-5)
-   *  - lists (1,2,3)
-   *  - steps (*\/5, 1-10/2)
+   * Check if a cron expression is due at the given date/time
    */
-  isDue(expression, timezone, date) {
-    const fields = expression.trim().split(/\s+/);
-    if (fields.length !== 5) {
-      throw new Error("SimpleCronParser only supports 5-field cron expressions");
-    }
-    let targetDate = date;
-    if (timezone && timezone !== "UTC") {
-      try {
-        const parts = new Intl.DateTimeFormat("en-US", {
-          timeZone: timezone,
-          year: "numeric",
-          month: "numeric",
-          day: "numeric",
-          hour: "numeric",
-          minute: "numeric",
-          second: "numeric",
-          hour12: false
-        }).formatToParts(date);
-        const partMap = {};
-        parts.forEach((p) => {
-          partMap[p.type] = p.value;
-        });
-        targetDate = new Date(
-          parseInt(partMap.year ?? "0", 10),
-          parseInt(partMap.month ?? "1", 10) - 1,
-          parseInt(partMap.day ?? "1", 10),
-          parseInt(partMap.hour ?? "0", 10) === 24 ? 0 : parseInt(partMap.hour ?? "0", 10),
-          parseInt(partMap.minute ?? "0", 10),
-          0
-        );
-      } catch (_e) {
-        throw new Error(`Invalid timezone: ${timezone}`);
-      }
-    } else if (timezone === "UTC") {
-      targetDate = new Date(
-        date.getUTCFullYear(),
-        date.getUTCMonth(),
-        date.getUTCDate(),
-        date.getUTCHours(),
-        date.getUTCMinutes(),
-        0
-      );
-    }
-    const [minute, hour, dayOfMonth, month, dayOfWeek] = fields;
-    if (minute === void 0 || hour === void 0 || dayOfMonth === void 0 || month === void 0 || dayOfWeek === void 0) {
-      throw new Error("Invalid cron expression");
-    }
-    const matchMinute = matchField(minute, targetDate.getMinutes(), 0, 59);
-    const matchHour = matchField(hour, targetDate.getHours(), 0, 23);
-    const matchDayOfMonth = matchField(dayOfMonth, targetDate.getDate(), 1, 31);
-    const matchMonth = matchField(month, targetDate.getMonth() + 1, 1, 12);
-    const matchDayOfWeek = matchField(dayOfWeek, targetDate.getDay(), 0, 7);
-    return matchMinute && matchHour && matchDayOfMonth && matchMonth && matchDayOfWeek;
-  }
-};
-function matchField(pattern, value, min, max) {
-  if (pattern === "*") {
-    return true;
-  }
-  if (pattern.includes("/")) {
-    const [range, stepStr] = pattern.split("/");
-    if (range === void 0 || stepStr === void 0) {
-      return false;
-    }
-    const step = parseInt(stepStr, 10);
-    if (range === "*") {
-      return (value - min) % step === 0;
-    }
-    if (range.includes("-")) {
-      const [startStr, endStr] = range.split("-");
-      if (startStr === void 0 || endStr === void 0) {
-        return false;
-      }
-      const start = parseInt(startStr, 10);
-      const end = parseInt(endStr, 10);
-      if (value >= start && value <= end) {
-        return (value - start) % step === 0;
-      }
-      return false;
+  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}`);
     }
+    const targetDate = this.getDateInTimezone(date, timezone);
+    const minutes = targetDate.getMinutes();
+    const hours = targetDate.getHours();
+    const dayOfMonth = targetDate.getDate();
+    const month = targetDate.getMonth() + 1;
+    const dayOfWeek = targetDate.getDay();
+    return this.match(parts[0], minutes, 0, 59) && this.match(parts[1], hours, 0, 23) && this.match(parts[2], dayOfMonth, 1, 31) && this.match(parts[3], month, 1, 12) && this.match(parts[4], dayOfWeek, 0, 6, true);
   }
-  if (pattern.includes(",")) {
-    const parts = pattern.split(",");
-    return parts.some((part) => matchField(part, value, min, max));
+  static match(pattern, value, _min, _max, isDayOfWeek = false) {
+    if (pattern === "*") return true;
+    if (pattern.includes(",")) {
+      return pattern.split(",").some((p) => this.match(p, value, _min, _max, isDayOfWeek));
+    }
+    const stepMatch = pattern.match(/^(\*|\d+(-\d+)?)\/(\d+)$/);
+    if (stepMatch) {
+      const range = stepMatch[1];
+      const step = parseInt(stepMatch[3], 10);
+      if (range === "*") return value % step === 0;
+      const [rMin, rMax] = range.split("-").map((n) => parseInt(n, 10));
+      return value >= rMin && value <= rMax && (value - rMin) % step === 0;
+    }
+    if (pattern.includes("-")) {
+      const [rMin, rMax] = pattern.split("-").map((n) => parseInt(n, 10));
+      return value >= rMin && value <= rMax;
+    }
+    const patternVal = parseInt(pattern, 10);
+    if (isDayOfWeek && patternVal === 7 && value === 0) return true;
+    return patternVal === value;
   }
-  if (pattern.includes("-")) {
-    const [startStr, endStr] = pattern.split("-");
-    if (startStr === void 0 || endStr === void 0) {
-      return false;
+  static getDateInTimezone(date, timezone) {
+    try {
+      const tzDate = new Date(date.toLocaleString("en-US", { timeZone: timezone }));
+      if (isNaN(tzDate.getTime())) throw new Error();
+      return tzDate;
+    } catch {
+      throw new Error(`Invalid timezone: ${timezone}`);
     }
-    const start = parseInt(startStr, 10);
-    const end = parseInt(endStr, 10);
-    return value >= start && value <= end;
   }
-  const expected = parseInt(pattern, 10);
-  if (max === 7 && expected === 7 && value === 0) {
-    return true;
-  }
-  return value === expected;
-}
+};
 
 // src/CronParser.ts
 var CronParser = class {
   /**
    * Get the next execution date based on a cron expression.
-   *
-   * @param expression - Cron expression
-   * @param timezone - Timezone identifier
-   * @param currentDate - Reference date
    */
   static async nextDate(expression, timezone = "UTC", currentDate = /* @__PURE__ */ new Date()) {
     try {
@@ -7959,10 +7890,6 @@ var CronParser = class {
   }
   /**
    * Check if the cron expression is due to run at the current time (minute precision).
-   *
-   * @param expression - Cron expression
-   * @param timezone - Timezone identifier
-   * @param currentDate - Reference date
    */
   static async isDue(expression, timezone = "UTC", currentDate = /* @__PURE__ */ new Date()) {
     try {
@@ -8524,6 +8451,7 @@ var SchedulerManager = class {
 var OrbitHorizon = class {
   /**
    * Install the Horizon Orbit into PlanetCore.
+   * Registers the SchedulerManager and configures the distributed lock driver.
    *
    * @param core - The PlanetCore instance.
    */
@@ -8534,7 +8462,7 @@ var OrbitHorizon = class {
     const nodeRole = config.nodeRole;
     let lockManager;
     if (lockDriver === "cache") {
-      const cacheManager = core.services.get("cache");
+      const cacheManager = core.container.make("cache");
       if (!cacheManager) {
         core.logger.warn(
           "[OrbitHorizon] Cache driver requested but cache service not found (ensure orbit-cache is loaded first). Falling back to Memory lock."
@@ -8547,11 +8475,10 @@ var OrbitHorizon = class {
       lockManager = new LockManager("memory");
     }
     const scheduler = new SchedulerManager(lockManager, core.logger, core.hooks, nodeRole);
-    core.services.set(exposeAs, scheduler);
+    core.container.instance(exposeAs, scheduler);
     core.adapter.use("*", async (c, next) => {
       c.set("scheduler", scheduler);
-      await next();
-      return void 0;
+      return await next();
     });
     core.logger.info(`[OrbitHorizon] Initialized (Driver: ${lockDriver})`);
   }

package/dist/index.d.cts

@@ -1,26 +1,30 @@
 import { CacheManager } from '@gravito/stasis';
-import { GravitoOrbit, PlanetCore, ActionCallback, Logger, HookManager } from '@gravito/core';
+import { ActionCallback, Logger, HookManager, GravitoOrbit, PlanetCore } from '@gravito/core';
 
+/**
+ * Advanced cron expression parser with fallback support.
+ */
 declare class CronParser {
     /**
      * Get the next execution date based on a cron expression.
-     *
-     * @param expression - Cron expression
-     * @param timezone - Timezone identifier
-     * @param currentDate - Reference date
      */
     static nextDate(expression: string, timezone?: string, currentDate?: Date): Promise<Date>;
     /**
      * Check if the cron expression is due to run at the current time (minute precision).
-     *
-     * @param expression - Cron expression
-     * @param timezone - Timezone identifier
-     * @param currentDate - Reference date
      */
     static isDue(expression: string, timezone?: string, currentDate?: Date): Promise<boolean>;
     private static minuteMatches;
 }
 
+/**
+ * Interface for distributed lock storage backends.
+ *
+ * Provides methods for acquiring, releasing, and managing
+ * distributed locks to prevent concurrent task execution.
+ *
+ * @public
+ * @since 3.0.0
+ */
 interface LockStore {
     /**
      * Attempt to acquire a lock
@@ -47,6 +51,21 @@ interface LockStore {
     exists(key: string): Promise<boolean>;
 }
 
+/**
+ * Cache-based lock store using Gravito Stasis.
+ *
+ * Stores locks in the cache system for distributed locking
+ * across multiple application instances.
+ *
+ * @example
+ * ```typescript
+ * const store = new CacheLockStore(cacheManager, 'locks:')
+ * const acquired = await store.acquire('task-123', 300)
+ * ```
+ *
+ * @since 3.0.0
+ * @public
+ */
 declare class CacheLockStore implements LockStore {
     private cache;
     private prefix;
@@ -58,6 +77,34 @@ declare class CacheLockStore implements LockStore {
     exists(key: string): Promise<boolean>;
 }
 
+/**
+ * Manager for distributed locks to prevent concurrent task execution.
+ *
+ * Supports multiple storage backends (memory, cache, custom) and provides
+ * a unified interface for acquiring and releasing locks.
+ *
+ * @example
+ * ```typescript
+ * // Using memory store
+ * const locks = new LockManager('memory')
+ *
+ * // Using cache store
+ * const locks = new LockManager('cache', { cache: cacheManager })
+ *
+ * // Acquire a lock
+ * const acquired = await locks.acquire('task:send-emails', 300)
+ * if (acquired) {
+ *   try {
+ *     // Execute task
+ *   } finally {
+ *     await locks.release('task:send-emails')
+ *   }
+ * }
+ * ```
+ *
+ * @since 3.0.0
+ * @public
+ */
 declare class LockManager {
     private store;
     constructor(driver: 'memory' | 'cache' | LockStore, context?: {
@@ -69,6 +116,25 @@ declare class LockManager {
     exists(key: string): Promise<boolean>;
 }
 
+/**
+ * In-memory lock store for single-instance deployments.
+ *
+ * Stores locks in memory with automatic expiration.
+ * Not suitable for multi-instance deployments.
+ *
+ * @example
+ * ```typescript
+ * const store = new MemoryLockStore()
+ * const acquired = await store.acquire('task-123', 300)
+ * if (acquired) {
+ *   // Execute task
+ *   await store.release('task-123')
+ * }
+ * ```
+ *
+ * @since 3.0.0
+ * @public
+ */
 declare class MemoryLockStore implements LockStore {
     private locks;
     acquire(key: string, ttlSeconds: number): Promise<boolean>;
@@ -77,47 +143,49 @@ declare class MemoryLockStore implements LockStore {
     exists(key: string): Promise<boolean>;
 }
 
-declare class OrbitHorizon implements GravitoOrbit {
-    /**
-     * Install the Horizon Orbit into PlanetCore.
-     *
-     * @param core - The PlanetCore instance.
-     */
-    install(core: PlanetCore): void;
-}
-
-interface ProcessResult {
-    exitCode: number;
-    stdout: string;
-    stderr: string;
-    success: boolean;
-}
-declare function runProcess(command: string): Promise<ProcessResult>;
-declare class Process {
-    static run(command: string): Promise<ProcessResult>;
-}
-
+/**
+ * Represents a configuration for a scheduled task (Cron job).
+ *
+ * @public
+ * @since 3.0.0
+ */
 interface ScheduledTask {
+    /** Unique name for the task */
     name: string;
+    /** Standard cron expression mapping the frequency */
     expression: string;
+    /** Timezone for evaluating the cron expression (default: UTC) */
     timezone: string;
+    /** The function or task to execute */
     callback: () => void | Promise<void>;
+    /** If true, uses a distributed lock to ensure only one server runs the task */
     shouldRunOnOneServer: boolean;
+    /** Time-to-live for the distributed lock in seconds (default: 300) */
     lockTtl: number;
+    /** If true, the task runs in the background and doesn't block the scheduler loop */
     background: boolean;
+    /** Optional node role required to run this task (e.g., 'worker') */
     nodeRole?: string;
+    /** Command string if the task was registered via a shell command */
     command?: string;
+    /** Callbacks executed after successful task completion */
     onSuccessCallbacks: ActionCallback[];
+    /** Callbacks executed after task failure */
     onFailureCallbacks: ActionCallback[];
 }
 /**
  * Fluent API for defining task schedules.
  *
  * @example
+ * ```typescript
  * scheduler.task('backup')
  *   .daily()
  *   .at('02:00')
- *   .onOneServer()
+ *   .onOneServer();
+ * ```
+ *
+ * @public
+ * @since 3.0.0
  */
 declare class TaskSchedule {
     private task;
@@ -363,4 +431,85 @@ declare class SchedulerManager {
     private executeTask;
 }
 
+/**
+ * OrbitHorizon is the official Task Scheduler for Gravito.
+ * It provides a fluent API for defining Cron jobs that can run on a schedule,
+ * with support for distributed locking (run on one server) and node roles.
+ *
+ * @example
+ * ```typescript
+ * const horizon = new OrbitHorizon();
+ * core.addOrbit(horizon);
+ *
+ * // Defining a task
+ * const scheduler = core.container.make('scheduler');
+ * scheduler.call('cleanup', async () => { ... }).daily().at('03:00').onOneServer();
+ * ```
+ * @public
+ */
+declare class OrbitHorizon implements GravitoOrbit {
+    /**
+     * Install the Horizon Orbit into PlanetCore.
+     * Registers the SchedulerManager and configures the distributed lock driver.
+     *
+     * @param core - The PlanetCore instance.
+     */
+    install(core: PlanetCore): void;
+}
+declare module '@gravito/core' {
+    interface GravitoVariables {
+        /** Scheduler manager for task scheduling */
+        scheduler?: SchedulerManager;
+    }
+}
+
+/**
+ * Result of a process execution.
+ *
+ * @public
+ * @since 3.0.0
+ */
+interface ProcessResult {
+    /** Exit code of the process (0 indicates success). */
+    exitCode: number;
+    /** Standard output from the process. */
+    stdout: string;
+    /** Standard error output from the process. */
+    stderr: string;
+    /** Whether the process completed successfully (exitCode === 0). */
+    success: boolean;
+}
+/**
+ * Execute a shell command and capture its output.
+ *
+ * @param command - The command string to execute.
+ * @returns A promise that resolves to the process result.
+ *
+ * @public
+ * @since 3.0.0
+ */
+declare function runProcess(command: string): Promise<ProcessResult>;
+/**
+ * Process execution utility for running shell commands.
+ *
+ * Provides a simple interface for executing shell commands
+ * and capturing their output.
+ *
+ * @example
+ * ```typescript
+ * const result = await Process.run('ls -la')
+ * if (result.success) {
+ *   console.log(result.stdout)
+ * } else {
+ *   console.error(result.stderr)
+ * }
+ * ```
+ *
+ * @since 3.0.0
+ * @public
+ */
+declare class Process {
+    static run(command: string): Promise<ProcessResult>;
+}
+
 export { CacheLockStore, CronParser, LockManager, type LockStore, MemoryLockStore, OrbitHorizon, Process, type ProcessResult, type ScheduledTask, SchedulerManager, TaskSchedule, runProcess };

package/dist/index.d.ts

@@ -1,26 +1,30 @@
 import { CacheManager } from '@gravito/stasis';
-import { GravitoOrbit, PlanetCore, ActionCallback, Logger, HookManager } from '@gravito/core';
+import { ActionCallback, Logger, HookManager, GravitoOrbit, PlanetCore } from '@gravito/core';
 
+/**
+ * Advanced cron expression parser with fallback support.
+ */
 declare class CronParser {
     /**
      * Get the next execution date based on a cron expression.
-     *
-     * @param expression - Cron expression
-     * @param timezone - Timezone identifier
-     * @param currentDate - Reference date
      */
     static nextDate(expression: string, timezone?: string, currentDate?: Date): Promise<Date>;
     /**
      * Check if the cron expression is due to run at the current time (minute precision).
-     *
-     * @param expression - Cron expression
-     * @param timezone - Timezone identifier
-     * @param currentDate - Reference date
      */
     static isDue(expression: string, timezone?: string, currentDate?: Date): Promise<boolean>;
     private static minuteMatches;
 }
 
+/**
+ * Interface for distributed lock storage backends.
+ *
+ * Provides methods for acquiring, releasing, and managing
+ * distributed locks to prevent concurrent task execution.
+ *
+ * @public
+ * @since 3.0.0
+ */
 interface LockStore {
     /**
      * Attempt to acquire a lock
@@ -47,6 +51,21 @@ interface LockStore {
     exists(key: string): Promise<boolean>;
 }
 
+/**
+ * Cache-based lock store using Gravito Stasis.
+ *
+ * Stores locks in the cache system for distributed locking
+ * across multiple application instances.
+ *
+ * @example
+ * ```typescript
+ * const store = new CacheLockStore(cacheManager, 'locks:')
+ * const acquired = await store.acquire('task-123', 300)
+ * ```
+ *
+ * @since 3.0.0
+ * @public
+ */
 declare class CacheLockStore implements LockStore {
     private cache;
     private prefix;
@@ -58,6 +77,34 @@ declare class CacheLockStore implements LockStore {
     exists(key: string): Promise<boolean>;
 }
 
+/**
+ * Manager for distributed locks to prevent concurrent task execution.
+ *
+ * Supports multiple storage backends (memory, cache, custom) and provides
+ * a unified interface for acquiring and releasing locks.
+ *
+ * @example
+ * ```typescript
+ * // Using memory store
+ * const locks = new LockManager('memory')
+ *
+ * // Using cache store
+ * const locks = new LockManager('cache', { cache: cacheManager })
+ *
+ * // Acquire a lock
+ * const acquired = await locks.acquire('task:send-emails', 300)
+ * if (acquired) {
+ *   try {
+ *     // Execute task
+ *   } finally {
+ *     await locks.release('task:send-emails')
+ *   }
+ * }
+ * ```
+ *
+ * @since 3.0.0
+ * @public
+ */
 declare class LockManager {
     private store;
     constructor(driver: 'memory' | 'cache' | LockStore, context?: {
@@ -69,6 +116,25 @@ declare class LockManager {
     exists(key: string): Promise<boolean>;
 }
 
+/**
+ * In-memory lock store for single-instance deployments.
+ *
+ * Stores locks in memory with automatic expiration.
+ * Not suitable for multi-instance deployments.
+ *
+ * @example
+ * ```typescript
+ * const store = new MemoryLockStore()
+ * const acquired = await store.acquire('task-123', 300)
+ * if (acquired) {
+ *   // Execute task
+ *   await store.release('task-123')
+ * }
+ * ```
+ *
+ * @since 3.0.0
+ * @public
+ */
 declare class MemoryLockStore implements LockStore {
     private locks;
     acquire(key: string, ttlSeconds: number): Promise<boolean>;
@@ -77,47 +143,49 @@ declare class MemoryLockStore implements LockStore {
     exists(key: string): Promise<boolean>;
 }
 
-declare class OrbitHorizon implements GravitoOrbit {
-    /**
-     * Install the Horizon Orbit into PlanetCore.
-     *
-     * @param core - The PlanetCore instance.
-     */
-    install(core: PlanetCore): void;
-}
-
-interface ProcessResult {
-    exitCode: number;
-    stdout: string;
-    stderr: string;
-    success: boolean;
-}
-declare function runProcess(command: string): Promise<ProcessResult>;
-declare class Process {
-    static run(command: string): Promise<ProcessResult>;
-}
-
+/**
+ * Represents a configuration for a scheduled task (Cron job).
+ *
+ * @public
+ * @since 3.0.0
+ */
 interface ScheduledTask {
+    /** Unique name for the task */
     name: string;
+    /** Standard cron expression mapping the frequency */
     expression: string;
+    /** Timezone for evaluating the cron expression (default: UTC) */
     timezone: string;
+    /** The function or task to execute */
     callback: () => void | Promise<void>;
+    /** If true, uses a distributed lock to ensure only one server runs the task */
     shouldRunOnOneServer: boolean;
+    /** Time-to-live for the distributed lock in seconds (default: 300) */
     lockTtl: number;
+    /** If true, the task runs in the background and doesn't block the scheduler loop */
     background: boolean;
+    /** Optional node role required to run this task (e.g., 'worker') */
     nodeRole?: string;
+    /** Command string if the task was registered via a shell command */
     command?: string;
+    /** Callbacks executed after successful task completion */
     onSuccessCallbacks: ActionCallback[];
+    /** Callbacks executed after task failure */
     onFailureCallbacks: ActionCallback[];
 }
 /**
  * Fluent API for defining task schedules.
  *
  * @example
+ * ```typescript
  * scheduler.task('backup')
  *   .daily()
  *   .at('02:00')
- *   .onOneServer()
+ *   .onOneServer();
+ * ```
+ *
+ * @public
+ * @since 3.0.0
  */
 declare class TaskSchedule {
     private task;
@@ -363,4 +431,85 @@ declare class SchedulerManager {
     private executeTask;
 }
 
+/**
+ * OrbitHorizon is the official Task Scheduler for Gravito.
+ * It provides a fluent API for defining Cron jobs that can run on a schedule,
+ * with support for distributed locking (run on one server) and node roles.
+ *
+ * @example
+ * ```typescript
+ * const horizon = new OrbitHorizon();
+ * core.addOrbit(horizon);
+ *
+ * // Defining a task
+ * const scheduler = core.container.make('scheduler');
+ * scheduler.call('cleanup', async () => { ... }).daily().at('03:00').onOneServer();
+ * ```
+ * @public
+ */
+declare class OrbitHorizon implements GravitoOrbit {
+    /**
+     * Install the Horizon Orbit into PlanetCore.
+     * Registers the SchedulerManager and configures the distributed lock driver.
+     *
+     * @param core - The PlanetCore instance.
+     */
+    install(core: PlanetCore): void;
+}
+declare module '@gravito/core' {
+    interface GravitoVariables {
+        /** Scheduler manager for task scheduling */
+        scheduler?: SchedulerManager;
+    }
+}
+
+/**
+ * Result of a process execution.
+ *
+ * @public
+ * @since 3.0.0
+ */
+interface ProcessResult {
+    /** Exit code of the process (0 indicates success). */
+    exitCode: number;
+    /** Standard output from the process. */
+    stdout: string;
+    /** Standard error output from the process. */
+    stderr: string;
+    /** Whether the process completed successfully (exitCode === 0). */
+    success: boolean;
+}
+/**
+ * Execute a shell command and capture its output.
+ *
+ * @param command - The command string to execute.
+ * @returns A promise that resolves to the process result.
+ *
+ * @public
+ * @since 3.0.0
+ */
+declare function runProcess(command: string): Promise<ProcessResult>;
+/**
+ * Process execution utility for running shell commands.
+ *
+ * Provides a simple interface for executing shell commands
+ * and capturing their output.
+ *
+ * @example
+ * ```typescript
+ * const result = await Process.run('ls -la')
+ * if (result.success) {
+ *   console.log(result.stdout)
+ * } else {
+ *   console.error(result.stderr)
+ * }
+ * ```
+ *
+ * @since 3.0.0
+ * @public
+ */
+declare class Process {
+    static run(command: string): Promise<ProcessResult>;
+}
+
 export { CacheLockStore, CronParser, LockManager, type LockStore, MemoryLockStore, OrbitHorizon, Process, type ProcessResult, type ScheduledTask, SchedulerManager, TaskSchedule, runProcess };

package/dist/index.js

@@ -1,128 +1,59 @@
 import "./chunk-MCKGQKYU.js";
 
 // src/SimpleCronParser.ts
-var SimpleCronParser = {
-  /**
-   * Check if a cron expression matches the given date.
-   * Only supports standard 5-field cron expressions.
-   *
-   * Fields: minute hour day-of-month month day-of-week
-   * Values:
-   *  - * (any)
-   *  - numbers (0-59, 1-31, 0-11, 0-7)
-   *  - ranges (1-5)
-   *  - lists (1,2,3)
-   *  - steps (*\/5, 1-10/2)
-   */
-  isDue(expression, timezone, date) {
-    const fields = expression.trim().split(/\s+/);
-    if (fields.length !== 5) {
-      throw new Error("SimpleCronParser only supports 5-field cron expressions");
+var SimpleCronParser = class {
+  /**
+   * Check if a cron expression is due at the given date/time
+   */
+  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}`);
     }
-    let targetDate = date;
-    if (timezone && timezone !== "UTC") {
-      try {
-        const parts = new Intl.DateTimeFormat("en-US", {
-          timeZone: timezone,
-          year: "numeric",
-          month: "numeric",
-          day: "numeric",
-          hour: "numeric",
-          minute: "numeric",
-          second: "numeric",
-          hour12: false
-        }).formatToParts(date);
-        const partMap = {};
-        parts.forEach((p) => {
-          partMap[p.type] = p.value;
-        });
-        targetDate = new Date(
-          parseInt(partMap.year ?? "0", 10),
-          parseInt(partMap.month ?? "1", 10) - 1,
-          parseInt(partMap.day ?? "1", 10),
-          parseInt(partMap.hour ?? "0", 10) === 24 ? 0 : parseInt(partMap.hour ?? "0", 10),
-          parseInt(partMap.minute ?? "0", 10),
-          0
-        );
-      } catch (_e) {
-        throw new Error(`Invalid timezone: ${timezone}`);
-      }
-    } else if (timezone === "UTC") {
-      targetDate = new Date(
-        date.getUTCFullYear(),
-        date.getUTCMonth(),
-        date.getUTCDate(),
-        date.getUTCHours(),
-        date.getUTCMinutes(),
-        0
-      );
+    const targetDate = this.getDateInTimezone(date, timezone);
+    const minutes = targetDate.getMinutes();
+    const hours = targetDate.getHours();
+    const dayOfMonth = targetDate.getDate();
+    const month = targetDate.getMonth() + 1;
+    const dayOfWeek = targetDate.getDay();
+    return this.match(parts[0], minutes, 0, 59) && this.match(parts[1], hours, 0, 23) && this.match(parts[2], dayOfMonth, 1, 31) && this.match(parts[3], month, 1, 12) && this.match(parts[4], dayOfWeek, 0, 6, true);
+  }
+  static match(pattern, value, _min, _max, isDayOfWeek = false) {
+    if (pattern === "*") return true;
+    if (pattern.includes(",")) {
+      return pattern.split(",").some((p) => this.match(p, value, _min, _max, isDayOfWeek));
     }
-    const [minute, hour, dayOfMonth, month, dayOfWeek] = fields;
-    if (minute === void 0 || hour === void 0 || dayOfMonth === void 0 || month === void 0 || dayOfWeek === void 0) {
-      throw new Error("Invalid cron expression");
+    const stepMatch = pattern.match(/^(\*|\d+(-\d+)?)\/(\d+)$/);
+    if (stepMatch) {
+      const range = stepMatch[1];
+      const step = parseInt(stepMatch[3], 10);
+      if (range === "*") return value % step === 0;
+      const [rMin, rMax] = range.split("-").map((n) => parseInt(n, 10));
+      return value >= rMin && value <= rMax && (value - rMin) % step === 0;
     }
-    const matchMinute = matchField(minute, targetDate.getMinutes(), 0, 59);
-    const matchHour = matchField(hour, targetDate.getHours(), 0, 23);
-    const matchDayOfMonth = matchField(dayOfMonth, targetDate.getDate(), 1, 31);
-    const matchMonth = matchField(month, targetDate.getMonth() + 1, 1, 12);
-    const matchDayOfWeek = matchField(dayOfWeek, targetDate.getDay(), 0, 7);
-    return matchMinute && matchHour && matchDayOfMonth && matchMonth && matchDayOfWeek;
-  }
-};
-function matchField(pattern, value, min, max) {
-  if (pattern === "*") {
-    return true;
-  }
-  if (pattern.includes("/")) {
-    const [range, stepStr] = pattern.split("/");
-    if (range === void 0 || stepStr === void 0) {
-      return false;
-    }
-    const step = parseInt(stepStr, 10);
-    if (range === "*") {
-      return (value - min) % step === 0;
-    }
-    if (range.includes("-")) {
-      const [startStr, endStr] = range.split("-");
-      if (startStr === void 0 || endStr === void 0) {
-        return false;
-      }
-      const start = parseInt(startStr, 10);
-      const end = parseInt(endStr, 10);
-      if (value >= start && value <= end) {
-        return (value - start) % step === 0;
-      }
-      return false;
+    if (pattern.includes("-")) {
+      const [rMin, rMax] = pattern.split("-").map((n) => parseInt(n, 10));
+      return value >= rMin && value <= rMax;
     }
+    const patternVal = parseInt(pattern, 10);
+    if (isDayOfWeek && patternVal === 7 && value === 0) return true;
+    return patternVal === value;
   }
-  if (pattern.includes(",")) {
-    const parts = pattern.split(",");
-    return parts.some((part) => matchField(part, value, min, max));
-  }
-  if (pattern.includes("-")) {
-    const [startStr, endStr] = pattern.split("-");
-    if (startStr === void 0 || endStr === void 0) {
-      return false;
+  static getDateInTimezone(date, timezone) {
+    try {
+      const tzDate = new Date(date.toLocaleString("en-US", { timeZone: timezone }));
+      if (isNaN(tzDate.getTime())) throw new Error();
+      return tzDate;
+    } catch {
+      throw new Error(`Invalid timezone: ${timezone}`);
     }
-    const start = parseInt(startStr, 10);
-    const end = parseInt(endStr, 10);
-    return value >= start && value <= end;
   }
-  const expected = parseInt(pattern, 10);
-  if (max === 7 && expected === 7 && value === 0) {
-    return true;
-  }
-  return value === expected;
-}
+};
 
 // src/CronParser.ts
 var CronParser = class {
   /**
    * Get the next execution date based on a cron expression.
-   *
-   * @param expression - Cron expression
-   * @param timezone - Timezone identifier
-   * @param currentDate - Reference date
    */
   static async nextDate(expression, timezone = "UTC", currentDate = /* @__PURE__ */ new Date()) {
     try {
@@ -138,10 +69,6 @@ var CronParser = class {
   }
   /**
    * Check if the cron expression is due to run at the current time (minute precision).
-   *
-   * @param expression - Cron expression
-   * @param timezone - Timezone identifier
-   * @param currentDate - Reference date
    */
   static async isDue(expression, timezone = "UTC", currentDate = /* @__PURE__ */ new Date()) {
     try {
@@ -703,6 +630,7 @@ var SchedulerManager = class {
 var OrbitHorizon = class {
   /**
    * Install the Horizon Orbit into PlanetCore.
+   * Registers the SchedulerManager and configures the distributed lock driver.
    *
    * @param core - The PlanetCore instance.
    */
@@ -713,7 +641,7 @@ var OrbitHorizon = class {
     const nodeRole = config.nodeRole;
     let lockManager;
     if (lockDriver === "cache") {
-      const cacheManager = core.services.get("cache");
+      const cacheManager = core.container.make("cache");
       if (!cacheManager) {
         core.logger.warn(
           "[OrbitHorizon] Cache driver requested but cache service not found (ensure orbit-cache is loaded first). Falling back to Memory lock."
@@ -726,11 +654,10 @@ var OrbitHorizon = class {
       lockManager = new LockManager("memory");
     }
     const scheduler = new SchedulerManager(lockManager, core.logger, core.hooks, nodeRole);
-    core.services.set(exposeAs, scheduler);
+    core.container.instance(exposeAs, scheduler);
     core.adapter.use("*", async (c, next) => {
       c.set("scheduler", scheduler);
-      await next();
-      return void 0;
+      return await next();
     });
     core.logger.info(`[OrbitHorizon] Initialized (Driver: ${lockDriver})`);
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gravito/horizon",
-  "version": "2.0.0",
+  "version": "3.0.1",
   "description": "Distributed task scheduler for Gravito framework",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
@@ -23,8 +23,8 @@
     "test": "bun test",
     "lint": "biome lint ./src",
     "typecheck": "bun tsc -p tsconfig.json --noEmit --skipLibCheck",
-    "test:coverage": "bun test --coverage --coverage-threshold=80",
-    "test:ci": "bun test --coverage --coverage-threshold=80"
+    "test:coverage": "bun test --coverage --coverage-threshold=60",
+    "test:ci": "bun test --coverage --coverage-threshold=60"
   },
   "keywords": [
     "gravito",