@navios/schedule 0.9.0 → 1.0.0-alpha.2

package/lib/scheduler.service-pFh29qTy.d.mts

@@ -0,0 +1,236 @@
+import { ClassType } from "@navios/core";
+import { CronJob, CronJobParams } from "cron";
+
+//#region src/decorators/cron.decorator.d.mts
+
+/**
+ * Options for configuring a cron job.
+ *
+ * @public
+ */
+interface CronOptions {
+  /**
+   * Whether the job should be disabled by default.
+   * Disabled jobs won't start automatically but can be manually started later.
+   *
+   * @default false
+   */
+  disabled?: boolean;
+}
+/**
+ * Decorator that marks a method to run on a cron schedule.
+ *
+ * The method must be in a class decorated with `@Schedulable()`.
+ * The method will be automatically executed according to the provided cron expression.
+ *
+ * @param cronTime - Cron expression (5 or 6 fields) or a pre-defined Schedule constant
+ * @param options - Optional configuration for the cron job
+ *
+ * @example
+ * ```typescript
+ * @Schedulable()
+ * class TaskService {
+ *   // Run daily at midnight
+ *   @Cron('0 0 * * *')
+ *   async dailyTask() {
+ *     console.log('Running daily task')
+ *   }
+ *
+ *   // Use pre-defined schedule
+ *   @Cron(Schedule.EveryFiveMinutes)
+ *   async frequentTask() {
+ *     console.log('Running every 5 minutes')
+ *   }
+ *
+ *   // Disabled job (won't start automatically)
+ *   @Cron('0 2 * * *', { disabled: true })
+ *   async maintenanceTask() {
+ *     console.log('Maintenance task')
+ *   }
+ * }
+ * ```
+ *
+ * @throws {Error} If applied to something other than a method
+ *
+ * @public
+ */
+declare function Cron(cronTime: CronJobParams['cronTime'], options?: CronOptions): (target: () => Promise<void>, context: ClassMethodDecoratorContext) => () => Promise<void>;
+//#endregion
+//#region src/metadata/cron.metadata.d.mts
+declare const CronMetadataKey: unique symbol;
+interface CronMetadata {
+  classMethod: string;
+  cronTime: CronJobParams['cronTime'] | null;
+  disabled: boolean;
+}
+declare function getAllCronMetadata(context: ClassMethodDecoratorContext | ClassDecoratorContext): Set<CronMetadata>;
+declare function getCronMetadata(target: Function, context: ClassMethodDecoratorContext): CronMetadata;
+//#endregion
+//#region src/metadata/schedule.metadata.d.mts
+declare const ScheduleMetadataKey: unique symbol;
+interface ScheduleMetadata {
+  name: string;
+  jobs: Set<CronMetadata>;
+}
+declare function getScheduleMetadata(target: ClassType, context: ClassDecoratorContext): ScheduleMetadata;
+declare function extractScheduleMetadata(target: ClassType): ScheduleMetadata;
+declare function hasScheduleMetadata(target: ClassType): boolean;
+//#endregion
+//#region src/cron.constants.d.mts
+/**
+ * Pre-defined cron schedule constants for common scheduling patterns.
+ *
+ * These constants provide convenient shortcuts for frequently used cron expressions,
+ * making it easier to schedule jobs without manually writing cron expressions.
+ *
+ * @example
+ * ```typescript
+ * import { Schedule } from '@navios/schedule'
+ *
+ * @Schedulable()
+ * class TaskService {
+ *   @Cron(Schedule.EveryMinute)
+ *   async everyMinute() {}
+ *
+ *   @Cron(Schedule.EveryHour)
+ *   async hourly() {}
+ *
+ *   @Cron(Schedule.EveryDay)
+ *   async daily() {}
+ * }
+ * ```
+ *
+ * @public
+ */
+declare enum Schedule {
+  EveryMinute = "*/1 * * * *",
+  EveryFiveMinutes = "*/5 * * * *",
+  EveryTenMinutes = "*/10 * * * *",
+  EveryFifteenMinutes = "*/15 * * * *",
+  EveryThirtyMinutes = "*/30 * * * *",
+  EveryHour = "0 * * * *",
+  EveryTwoHours = "0 */2 * * *",
+  EveryThreeHours = "0 */3 * * *",
+  EveryFourHours = "0 */4 * * *",
+  EverySixHours = "0 */6 * * *",
+  EveryTwelveHours = "0 */12 * * *",
+  EveryDay = "0 0 * * *",
+  EveryWeek = "0 0 * * 0",
+  EveryMonth = "0 0 1 * *",
+}
+//#endregion
+//#region src/scheduler.service.d.mts
+/**
+ * Service responsible for managing and executing scheduled cron jobs.
+ *
+ * The SchedulerService registers schedulable services decorated with `@Schedulable()`
+ * and automatically starts their cron jobs based on the `@Cron()` decorator configuration.
+ *
+ * @example
+ * ```typescript
+ * import { inject, Injectable } from '@navios/core'
+ * import { SchedulerService } from '@navios/schedule'
+ *
+ * @Injectable()
+ * class AppModule {
+ *   private readonly scheduler = inject(SchedulerService)
+ *
+ *   async onModuleInit() {
+ *     this.scheduler.register(MySchedulableService)
+ *   }
+ * }
+ * ```
+ *
+ * @public
+ */
+declare class SchedulerService {
+  private readonly logger;
+  private readonly container;
+  private readonly jobs;
+  /**
+   * Registers a schedulable service and starts all its cron jobs.
+   *
+   * The service must be decorated with `@Schedulable()` and contain methods
+   * decorated with `@Cron()` to be registered successfully.
+   *
+   * @param service - The schedulable service class to register
+   * @throws {Error} If the service is not decorated with `@Schedulable()`
+   *
+   * @example
+   * ```typescript
+   * @Schedulable()
+   * class TaskService {
+   *   @Cron('0 0 * * *')
+   *   async dailyTask() {
+   *     // Runs daily at midnight
+   *   }
+   * }
+   *
+   * schedulerService.register(TaskService)
+   * ```
+   *
+   * @public
+   */
+  register(service: ClassType): void;
+  /**
+   * Retrieves a specific cron job instance for a method in a schedulable service.
+   *
+   * @param service - The schedulable service class
+   * @param method - The name of the method decorated with `@Cron()`
+   * @returns The CronJob instance if found, undefined otherwise
+   *
+   * @example
+   * ```typescript
+   * const job = schedulerService.getJob(TaskService, 'dailyTask')
+   * if (job) {
+   *   console.log('Job is active:', job.isActive)
+   *   job.start() // Manually start the job
+   *   job.stop()  // Manually stop the job
+   * }
+   * ```
+   *
+   * @public
+   */
+  getJob<T extends ClassType>(service: T, method: keyof InstanceType<T>): CronJob | undefined;
+  private registerJobs;
+  /**
+   * Starts all registered cron jobs that are currently inactive.
+   *
+   * Only jobs that are not already active will be started. This method
+   * is useful for resuming all jobs after calling `stopAll()`.
+   *
+   * @example
+   * ```typescript
+   * // Stop all jobs
+   * schedulerService.stopAll()
+   *
+   * // Later, resume all jobs
+   * schedulerService.startAll()
+   * ```
+   *
+   * @public
+   */
+  startAll(): void;
+  /**
+   * Stops all registered cron jobs that are currently active.
+   *
+   * Only jobs that are currently active will be stopped. This method
+   * is useful for pausing all scheduled tasks, for example during
+   * application shutdown or maintenance.
+   *
+   * @example
+   * ```typescript
+   * // Pause all scheduled jobs
+   * schedulerService.stopAll()
+   *
+   * // Jobs can be resumed later with startAll()
+   * schedulerService.startAll()
+   * ```
+   *
+   * @public
+   */
+  stopAll(): void;
+}
+//#endregion
+export { extractScheduleMetadata as a, CronMetadata as c, getCronMetadata as d, Cron as f, ScheduleMetadataKey as i, CronMetadataKey as l, Schedule as n, getScheduleMetadata as o, CronOptions as p, ScheduleMetadata as r, hasScheduleMetadata as s, SchedulerService as t, getAllCronMetadata as u };
+//# sourceMappingURL=scheduler.service-pFh29qTy.d.mts.map

package/lib/scheduler.service-pFh29qTy.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.service-pFh29qTy.d.mts","names":[],"sources":["../src/decorators/cron.decorator.mts","../src/metadata/cron.metadata.mts","../src/metadata/schedule.metadata.mts","../src/cron.constants.mts","../src/scheduler.service.mts"],"sourcesContent":[],"mappings":";;;;;;;;AASA;AA+CA;AACY,UAhDK,WAAA,CAgDL;EACA;;;;;;;;ACxDZ;AAEA;AAMA;;;;;;AAiBA;;;;;;;;ACrBA;AAEA;AAKA;;;;;AAyBA;AAWA;;;;ACxBA;;;;ACWA;;;;;AAgEkB,iBJ5CF,IAAA,CI4CE,QAAA,EJ3CN,aI2CM,CAAA,UAAA,CAAA,EAAA,OAAA,CAAA,EJ1CN,WI0CM,CAAA,EAAA,CAAA,MAAA,EAAA,GAAA,GJvCA,OIuCA,CAAA,IAAA,CAAA,EAAA,OAAA,EJtCL,2BIsCK,EAAA,GAAA,GAAA,GJvCA,OIuCA,CAAA,IAAA,CAAA;;;cHlGL;UAEI,YAAA;;EDKA,QAAA,ECHL,aDGgB,CAAA,UAAA,CAAA,GAAA,IAAA;EA+CZ,QAAI,EAAA,OAAA;;AAER,iBChDI,kBAAA,CDgDJ,OAAA,EC/CD,2BD+CC,GC/C6B,qBD+C7B,CAAA,EC9CT,GD8CS,CC9CL,YD8CK,CAAA;AAGM,iBClCF,eAAA,CDkCE,MAAA,ECjCR,QDiCQ,EAAA,OAAA,EChCP,2BDgCO,CAAA,EC/Bf,YD+Be;;;cEvDL;UAEI,gBAAA;EFCA,IAAA,EAAA,MAAA;EA+CD,IAAA,EE9CR,GF8CY,CE9CR,YF8CQ,CAAA;;AAER,iBE7CI,mBAAA,CF6CJ,MAAA,EE5CF,SF4CE,EAAA,OAAA,EE3CD,qBF2CC,CAAA,EE1CT,gBF0CS;AAGM,iBEvBF,uBAAA,CFuBE,MAAA,EEvB8B,SFuB9B,CAAA,EEvB0C,gBFuB1C;AACL,iBEbG,mBAAA,CFaH,MAAA,EEb+B,SFa/B,CAAA,EAAA,OAAA;;;;;;;AArDb;AA+CA;;;;;;;;;;ACtDA;AAEA;AAMA;;;;;;AAiBA;;AAEW,aEJC,QAAA;EFKT,WAAA,GAAA,aAAA;EAAY,gBAAA,GAAA,aAAA;;;;ECxBF,SAAA,GAAA,WAAqD;EAEjD,aAAA,GAAA,aAAgB;EAKjB,eAAA,GAAA,aAAmB;EACzB,cAAA,GAAA,aAAA;EACC,aAAA,GAAA,aAAA;EACR,gBAAA,GAAA,cAAA;EAAgB,QAAA,GAAA,WAAA;EAsBH,SAAA,GAAA,WAAA;EAWA,UAAA,GAAA,WAAmB;;;;;;AFxCnC;AA+CA;;;;;;;;;;ACtDA;AAEA;AAMA;;;;;;AAiBA;;AAEW,cGQE,gBAAA,CHRF;EACR,iBAAA,MAAA;EAAY,iBAAA,SAAA;;;;ACxBf;AAEA;AAKA;;;;;AAyBA;AAWA;;;;ACxBA;;;;ACWA;;;;;;EAiEK,QAAA,CAAA,OAAA,EAjCe,SAiCf,CAAA,EAAA,IAAA;EAAO;;;;;;;;;;;;;;;;;;;mBAHO,oBACN,iBACK,aAAa,KAC1B"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@navios/schedule",
-  "version": "0.9.0",
+  "version": "1.0.0-alpha.2",
   "author": {
     "name": "Oleksandr Hanzha",
     "email": "alex@granted.name"
@@ -12,7 +12,7 @@
   },
   "license": "MIT",
   "peerDependencies": {
-    "@navios/core": "^0.9.0",
+    "@navios/core": "^1.0.0-alpha.2",
     "zod": "^3.25.0 || ^4.0.0"
   },
   "typings": "./lib/index.d.mts",
@@ -28,10 +28,20 @@
         "types": "./lib/index.d.cts",
         "default": "./lib/index.cjs"
       }
+    },
+    "./legacy-compat": {
+      "import": {
+        "types": "./lib/legacy-compat/index.d.mts",
+        "default": "./lib/legacy-compat/index.mjs"
+      },
+      "require": {
+        "types": "./lib/legacy-compat/index.d.cts",
+        "default": "./lib/legacy-compat/index.cjs"
+      }
     }
   },
   "devDependencies": {
-    "@navios/core": "^0.9.0",
+    "@navios/core": "^1.0.0-alpha.2",
     "typescript": "^5.9.3",
     "zod": "^4.2.1"
   },

package/src/legacy-compat/decorators/cron.decorator.mts

@@ -0,0 +1,58 @@
+import type { CronJobParams } from 'cron'
+
+import { createMethodContext } from '@navios/core/legacy-compat'
+
+import {
+  Cron as OriginalCron,
+  type CronOptions,
+} from '../../decorators/cron.decorator.mjs'
+
+export type { CronOptions }
+
+/**
+ * Legacy-compatible Cron decorator.
+ *
+ * Works with TypeScript experimental decorators (legacy API).
+ * Marks a method to run on a cron schedule.
+ *
+ * @param cronTime - Cron expression (5 or 6 fields) or a pre-defined Schedule constant
+ * @param options - Optional configuration for the cron job
+ * @returns A method decorator compatible with legacy decorator API
+ *
+ * @example
+ * ```typescript
+ * @Schedulable()
+ * class TaskService {
+ *   @Cron('0 0 * * *')
+ *   async dailyTask() {
+ *     console.log('Running daily task')
+ *   }
+ *
+ *   @Cron(Schedule.EveryFiveMinutes, { disabled: true })
+ *   async frequentTask() {
+ *     console.log('Running every 5 minutes')
+ *   }
+ * }
+ * ```
+ */
+export function Cron(cronTime: CronJobParams['cronTime'], options?: CronOptions) {
+  return function <T extends object>(
+    target: T,
+    propertyKey: string | symbol,
+    descriptor: TypedPropertyDescriptor<() => Promise<void>>,
+  ): PropertyDescriptor | void {
+    if (!descriptor) {
+      throw new Error(
+        '[Navios] @Cron decorator requires a method descriptor. Make sure experimentalDecorators is enabled.',
+      )
+    }
+    const context = createMethodContext(target, propertyKey, descriptor)
+    const originalDecorator = OriginalCron(cronTime, options)
+    // @ts-expect-error - we don't need to type the value
+    const result = originalDecorator(descriptor.value, context)
+    if (result !== descriptor.value) {
+      descriptor.value = result as any
+    }
+    return descriptor
+  }
+}

package/src/legacy-compat/decorators/index.mts

@@ -0,0 +1,2 @@
+export { Cron, type CronOptions } from './cron.decorator.mjs'
+export { Schedulable, type SchedulableOptions } from './schedulable.decorator.mjs'

package/src/legacy-compat/decorators/schedulable.decorator.mts

@@ -0,0 +1,47 @@
+import type { ClassType, Registry } from '@navios/core'
+
+import { createClassContext } from '@navios/core/legacy-compat'
+
+import { Schedulable as OriginalSchedulable } from '../../decorators/schedulable.decorator.mjs'
+
+/**
+ * Options for the Schedulable decorator.
+ */
+export interface SchedulableOptions {
+  /**
+   * The registry to register the service with.
+   * If not provided, the global registry will be used.
+   */
+  registry?: Registry
+}
+
+/**
+ * Legacy-compatible Schedulable decorator.
+ *
+ * Works with TypeScript experimental decorators (legacy API).
+ * Marks a class as schedulable and makes it injectable.
+ *
+ * @param options - Optional configuration including the registry to use
+ * @returns A class decorator compatible with legacy decorator API
+ *
+ * @example
+ * ```typescript
+ * @Schedulable()
+ * class TaskService {
+ *   @Cron('0 0 * * *')
+ *   async dailyTask() {
+ *     console.log('Running daily task')
+ *   }
+ * }
+ *
+ * // Register the service
+ * schedulerService.register(TaskService)
+ * ```
+ */
+export function Schedulable(options: SchedulableOptions = {}) {
+  return function (target: ClassType) {
+    const context = createClassContext(target)
+    const originalDecorator = OriginalSchedulable(options)
+    return originalDecorator(target, context)
+  }
+}

package/src/legacy-compat/index.mts

@@ -0,0 +1,41 @@
+/**
+ * Legacy-compatible decorators for projects that cannot use Stage 3 decorators.
+ *
+ * These decorators use the TypeScript experimental decorator API and convert
+ * the arguments to Stage 3 format internally.
+ *
+ * @example
+ * ```typescript
+ * import { Schedulable, Cron, Schedule } from '@navios/schedule/legacy-compat'
+ *
+ * @Schedulable()
+ * class TaskService {
+ *   @Cron(Schedule.EveryMinute)
+ *   async everyMinuteTask() {
+ *     console.log('Running every minute')
+ *   }
+ * }
+ * ```
+ */
+
+// Export legacy-compatible decorators
+export { Cron, Schedulable, type CronOptions, type SchedulableOptions } from './decorators/index.mjs'
+
+// Re-export Schedule constants for convenience
+export { Schedule } from '../cron.constants.mjs'
+
+// Re-export metadata types and functions (these work with both decorator styles)
+export type { CronMetadata, ScheduleMetadata } from '../metadata/index.mjs'
+export {
+  getAllCronMetadata,
+  getCronMetadata,
+  getScheduleMetadata,
+  extractScheduleMetadata,
+  hasScheduleMetadata,
+} from '../metadata/index.mjs'
+
+// Re-export SchedulerService (works with both decorator styles)
+export { SchedulerService } from '../scheduler.service.mjs'
+
+// Re-export context compatibility utilities from core
+export { createClassContext, createMethodContext } from '@navios/core/legacy-compat'

package/tsdown.config.mts

@@ -3,7 +3,7 @@ import { defineConfig } from 'tsdown'
 import swc from 'unplugin-swc'
 
 export default defineConfig({
-  entry: ['src/index.mts'],
+  entry: ['src/index.mts', 'src/legacy-compat/index.mts'],
   outDir: 'lib',
   format: ['esm', 'cjs'],
   clean: true,

package/lib/index.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.cjs","names":["newMetadata: CronMetadata","getAllCronMetadata","ScheduleMetadataKey","Symbol","getScheduleMetadata","target","context","metadata","jobsMetadata","newMetadata","name","jobs","Error","extractScheduleMetadata","hasScheduleMetadata","getCronMetadata","Cron","cronTime","options","target","context","kind","Error","metadata","disabled","globalRegistry","Injectable","getScheduleMetadata","Schedulable","registry","target","context","kind","Error","metadata","Schedule","Container","inject","Injectable","Logger","CronJob","extractScheduleMetadata","hasScheduleMetadata","SchedulerService","logger","context","name","container","jobs","Map","register","service","Error","metadata","debug","registerJobs","getJob","method","jobName","get","job","cronTime","classMethod","self","defaultDisabled","cronJob","from","onTick","instance","error","start","disabled","set","startAll","values","isActive","stopAll","stop"],"sources":["../src/metadata/cron.metadata.mts","../src/metadata/schedule.metadata.mts","../src/decorators/cron.decorator.mts","../src/decorators/schedulable.decorator.mts","../src/cron.constants.mts","../src/scheduler.service.mts"],"sourcesContent":["import type { CronJobParams } from 'cron'\n\nexport const CronMetadataKey = Symbol('CronMetadataKey')\n\nexport interface CronMetadata {\n  classMethod: string\n  cronTime: CronJobParams['cronTime'] | null\n  disabled: boolean\n}\n\nexport function getAllCronMetadata(\n  context: ClassMethodDecoratorContext | ClassDecoratorContext,\n): Set<CronMetadata> {\n  if (context.metadata) {\n    const metadata = context.metadata[CronMetadataKey] as\n      | Set<CronMetadata>\n      | undefined\n    if (metadata) {\n      return metadata\n    } else {\n      context.metadata[CronMetadataKey] = new Set<CronMetadata>()\n      return context.metadata[CronMetadataKey] as Set<CronMetadata>\n    }\n  }\n  throw new Error('[Navios-Schedule] Wrong environment.')\n}\n\nexport function getCronMetadata(\n  target: Function,\n  context: ClassMethodDecoratorContext,\n): CronMetadata {\n  if (context.metadata) {\n    const metadata = getAllCronMetadata(context)\n    if (metadata) {\n      const endpointMetadata = Array.from(metadata).find(\n        (item) => item.classMethod === target.name,\n      )\n      if (endpointMetadata) {\n        return endpointMetadata\n      } else {\n        const newMetadata: CronMetadata = {\n          classMethod: target.name,\n          cronTime: null,\n          disabled: false,\n        }\n        metadata.add(newMetadata)\n        return newMetadata\n      }\n    }\n  }\n  throw new Error('[Navios-Schedule] Wrong environment.')\n}\n","import type { ClassType } from '@navios/core'\n\nimport type { CronMetadata } from './cron.metadata.mjs'\n\nimport { getAllCronMetadata } from './cron.metadata.mjs'\n\nexport const ScheduleMetadataKey = Symbol('ControllerMetadataKey')\n\nexport interface ScheduleMetadata {\n  name: string\n  jobs: Set<CronMetadata>\n}\n\nexport function getScheduleMetadata(\n  target: ClassType,\n  context: ClassDecoratorContext,\n): ScheduleMetadata {\n  if (context.metadata) {\n    const metadata = context.metadata[ScheduleMetadataKey] as\n      | ScheduleMetadata\n      | undefined\n    if (metadata) {\n      return metadata\n    } else {\n      const jobsMetadata = getAllCronMetadata(context)\n      const newMetadata: ScheduleMetadata = {\n        name: target.name,\n        jobs: jobsMetadata,\n      }\n      context.metadata[ScheduleMetadataKey] = newMetadata\n      // @ts-expect-error We add a custom metadata key to the target\n      target[ScheduleMetadataKey] = newMetadata\n      return newMetadata\n    }\n  }\n  throw new Error('[Navios-Schedule] Wrong environment.')\n}\n\nexport function extractScheduleMetadata(target: ClassType): ScheduleMetadata {\n  // @ts-expect-error We add a custom metadata key to the target\n  const metadata = target[ScheduleMetadataKey] as ScheduleMetadata | undefined\n  if (!metadata) {\n    throw new Error(\n      '[Navios-Schedule] Controller metadata not found. Make sure to use @Controller decorator.',\n    )\n  }\n  return metadata\n}\n\nexport function hasScheduleMetadata(target: ClassType): boolean {\n  // @ts-expect-error We add a custom metadata key to the target\n  const metadata = target[ScheduleMetadataKey] as ScheduleMetadata | undefined\n\n  return !!metadata\n}\n","import type { CronJobParams } from 'cron'\n\nimport { getCronMetadata } from '../metadata/index.mjs'\n\n/**\n * Options for configuring a cron job.\n * \n * @public\n */\nexport interface CronOptions {\n  /**\n   * Whether the job should be disabled by default.\n   * Disabled jobs won't start automatically but can be manually started later.\n   * \n   * @default false\n   */\n  disabled?: boolean\n}\n\n/**\n * Decorator that marks a method to run on a cron schedule.\n * \n * The method must be in a class decorated with `@Schedulable()`.\n * The method will be automatically executed according to the provided cron expression.\n * \n * @param cronTime - Cron expression (5 or 6 fields) or a pre-defined Schedule constant\n * @param options - Optional configuration for the cron job\n * \n * @example\n * ```typescript\n * @Schedulable()\n * class TaskService {\n *   // Run daily at midnight\n *   @Cron('0 0 * * *')\n *   async dailyTask() {\n *     console.log('Running daily task')\n *   }\n * \n *   // Use pre-defined schedule\n *   @Cron(Schedule.EveryFiveMinutes)\n *   async frequentTask() {\n *     console.log('Running every 5 minutes')\n *   }\n * \n *   // Disabled job (won't start automatically)\n *   @Cron('0 2 * * *', { disabled: true })\n *   async maintenanceTask() {\n *     console.log('Maintenance task')\n *   }\n * }\n * ```\n * \n * @throws {Error} If applied to something other than a method\n * \n * @public\n */\nexport function Cron(\n  cronTime: CronJobParams['cronTime'],\n  options?: CronOptions,\n) {\n  return (\n    target: () => Promise<void>,\n    context: ClassMethodDecoratorContext,\n  ) => {\n    if (context.kind !== 'method') {\n      throw new Error(\n        `Cron can only be applied to methods, not ${context.kind}`,\n      )\n    }\n    if (context.metadata) {\n      const metadata = getCronMetadata(target, context)\n      metadata.cronTime = cronTime\n      metadata.disabled = options?.disabled ?? false\n    }\n    return target\n  }\n}\n","import type { ClassType } from '@navios/core'\n\nimport { globalRegistry, Injectable, Registry } from '@navios/core'\n\nimport { getScheduleMetadata } from '../metadata/index.mjs'\n\n/**\n * Decorator that marks a class as schedulable and makes it injectable.\n *\n * Classes decorated with `@Schedulable()` can contain methods decorated with `@Cron()`\n * that will be automatically scheduled and executed. This decorator also applies\n * the `@Injectable()` decorator, making the class available for dependency injection.\n *\n * @example\n * ```typescript\n * @Schedulable()\n * class TaskService {\n *   @Cron('0 0 * * *')\n *   async dailyTask() {\n *     // This will run daily at midnight\n *   }\n * }\n *\n * // Register the service\n * schedulerService.register(TaskService)\n * ```\n *\n * @throws {Error} If applied to something other than a class\n *\n * @public\n */\nexport function Schedulable({ registry }: { registry?: Registry } = {}) {\n  return (target: ClassType, context: ClassDecoratorContext) => {\n    if (context.kind !== 'class') {\n      throw new Error(\n        `SchedulableDecorator can only be applied to classes, not ${context.kind}`,\n      )\n    }\n    if (context.metadata) {\n      getScheduleMetadata(target, context)\n    }\n    return Injectable({ registry: registry ?? globalRegistry })(target, context)\n  }\n}\n","/**\n * Pre-defined cron schedule constants for common scheduling patterns.\n *\n * These constants provide convenient shortcuts for frequently used cron expressions,\n * making it easier to schedule jobs without manually writing cron expressions.\n *\n * @example\n * ```typescript\n * import { Schedule } from '@navios/schedule'\n *\n * @Schedulable()\n * class TaskService {\n *   @Cron(Schedule.EveryMinute)\n *   async everyMinute() {}\n *\n *   @Cron(Schedule.EveryHour)\n *   async hourly() {}\n *\n *   @Cron(Schedule.EveryDay)\n *   async daily() {}\n * }\n * ```\n *\n * @public\n */\nexport enum Schedule {\n  EveryMinute = '*/1 * * * *',\n  EveryFiveMinutes = '*/5 * * * *',\n  EveryTenMinutes = '*/10 * * * *',\n  EveryFifteenMinutes = '*/15 * * * *',\n  EveryThirtyMinutes = '*/30 * * * *',\n  EveryHour = '0 * * * *',\n  EveryTwoHours = '0 */2 * * *',\n  EveryThreeHours = '0 */3 * * *',\n  EveryFourHours = '0 */4 * * *',\n  EverySixHours = '0 */6 * * *',\n  EveryTwelveHours = '0 */12 * * *',\n  EveryDay = '0 0 * * *',\n  EveryWeek = '0 0 * * 0',\n  EveryMonth = '0 0 1 * *',\n}\n","import type { ClassType } from '@navios/core'\n\nimport { Container, inject, Injectable, Logger } from '@navios/core'\n\nimport { CronJob } from 'cron'\n\nimport type { ScheduleMetadata } from './metadata/index.mjs'\n\nimport {\n  extractScheduleMetadata,\n  hasScheduleMetadata,\n} from './metadata/index.mjs'\n\n/**\n * Service responsible for managing and executing scheduled cron jobs.\n * \n * The SchedulerService registers schedulable services decorated with `@Schedulable()`\n * and automatically starts their cron jobs based on the `@Cron()` decorator configuration.\n * \n * @example\n * ```typescript\n * import { inject, Injectable } from '@navios/core'\n * import { SchedulerService } from '@navios/schedule'\n * \n * @Injectable()\n * class AppModule {\n *   private readonly scheduler = inject(SchedulerService)\n * \n *   async onModuleInit() {\n *     this.scheduler.register(MySchedulableService)\n *   }\n * }\n * ```\n * \n * @public\n */\n@Injectable()\nexport class SchedulerService {\n  private readonly logger = inject(Logger, {\n    context: SchedulerService.name,\n  })\n  private readonly container = inject(Container)\n  private readonly jobs: Map<string, CronJob> = new Map()\n\n  /**\n   * Registers a schedulable service and starts all its cron jobs.\n   * \n   * The service must be decorated with `@Schedulable()` and contain methods\n   * decorated with `@Cron()` to be registered successfully.\n   * \n   * @param service - The schedulable service class to register\n   * @throws {Error} If the service is not decorated with `@Schedulable()`\n   * \n   * @example\n   * ```typescript\n   * @Schedulable()\n   * class TaskService {\n   *   @Cron('0 0 * * *')\n   *   async dailyTask() {\n   *     // Runs daily at midnight\n   *   }\n   * }\n   * \n   * schedulerService.register(TaskService)\n   * ```\n   * \n   * @public\n   */\n  register(service: ClassType) {\n    if (!hasScheduleMetadata(service)) {\n      throw new Error(\n        `[Navios-Schedule] Service ${service.name} is not schedulable. Make sure to use @Schedulable decorator.`,\n      )\n    }\n    const metadata = extractScheduleMetadata(service)\n    this.logger.debug('Scheduling service', metadata.name)\n    this.registerJobs(service, metadata)\n  }\n\n  /**\n   * Retrieves a specific cron job instance for a method in a schedulable service.\n   * \n   * @param service - The schedulable service class\n   * @param method - The name of the method decorated with `@Cron()`\n   * @returns The CronJob instance if found, undefined otherwise\n   * \n   * @example\n   * ```typescript\n   * const job = schedulerService.getJob(TaskService, 'dailyTask')\n   * if (job) {\n   *   console.log('Job is active:', job.isActive)\n   *   job.start() // Manually start the job\n   *   job.stop()  // Manually stop the job\n   * }\n   * ```\n   * \n   * @public\n   */\n  getJob<T extends ClassType>(\n    service: T,\n    method: keyof InstanceType<T>,\n  ): CronJob | undefined {\n    const metadata = extractScheduleMetadata(service)\n    const jobName = `${metadata.name}.${method as string}()`\n    return this.jobs.get(jobName)\n  }\n\n  private registerJobs(service: ClassType, metadata: ScheduleMetadata) {\n    const jobs = metadata.jobs\n    for (const job of jobs) {\n      if (!job.cronTime) {\n        this.logger.debug('Skipping job', job.classMethod)\n        continue\n      }\n      const name = `${metadata.name}.${job.classMethod}()`\n      const self = this\n      const defaultDisabled = false\n      const cronJob = CronJob.from({\n        cronTime: job.cronTime,\n        name,\n        async onTick() {\n          try {\n            self.logger.debug('Executing job', name)\n            const instance = await self.container.get(service)\n            await instance[job.classMethod]()\n          } catch (error) {\n            self.logger.error('Error executing job', name, error)\n          }\n        },\n        start: !(defaultDisabled || job.disabled),\n      })\n      this.jobs.set(name, cronJob)\n    }\n  }\n\n  /**\n   * Starts all registered cron jobs that are currently inactive.\n   * \n   * Only jobs that are not already active will be started. This method\n   * is useful for resuming all jobs after calling `stopAll()`.\n   * \n   * @example\n   * ```typescript\n   * // Stop all jobs\n   * schedulerService.stopAll()\n   * \n   * // Later, resume all jobs\n   * schedulerService.startAll()\n   * ```\n   * \n   * @public\n   */\n  startAll() {\n    for (const job of this.jobs.values()) {\n      if (job.isActive) {\n        continue\n      }\n      job.start()\n    }\n  }\n\n  /**\n   * Stops all registered cron jobs that are currently active.\n   * \n   * Only jobs that are currently active will be stopped. This method\n   * is useful for pausing all scheduled tasks, for example during\n   * application shutdown or maintenance.\n   * \n   * @example\n   * ```typescript\n   * // Pause all scheduled jobs\n   * schedulerService.stopAll()\n   * \n   * // Jobs can be resumed later with startAll()\n   * schedulerService.startAll()\n   * ```\n   * \n   * @public\n   */\n  stopAll() {\n    for (const job of this.jobs.values()) {\n      if (!job.isActive) {\n        continue\n      }\n      job.stop()\n    }\n  }\n}\n"],"mappings":"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"}

package/lib/index.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.mjs","names":["newMetadata: CronMetadata","getAllCronMetadata","ScheduleMetadataKey","Symbol","getScheduleMetadata","target","context","metadata","jobsMetadata","newMetadata","name","jobs","Error","extractScheduleMetadata","hasScheduleMetadata","getCronMetadata","Cron","cronTime","options","target","context","kind","Error","metadata","disabled","globalRegistry","Injectable","getScheduleMetadata","Schedulable","registry","target","context","kind","Error","metadata","Schedule","Container","inject","Injectable","Logger","CronJob","extractScheduleMetadata","hasScheduleMetadata","SchedulerService","logger","context","name","container","jobs","Map","register","service","Error","metadata","debug","registerJobs","getJob","method","jobName","get","job","cronTime","classMethod","self","defaultDisabled","cronJob","from","onTick","instance","error","start","disabled","set","startAll","values","isActive","stopAll","stop"],"sources":["../src/metadata/cron.metadata.mts","../src/metadata/schedule.metadata.mts","../src/decorators/cron.decorator.mts","../src/decorators/schedulable.decorator.mts","../src/cron.constants.mts","../src/scheduler.service.mts"],"sourcesContent":["import type { CronJobParams } from 'cron'\n\nexport const CronMetadataKey = Symbol('CronMetadataKey')\n\nexport interface CronMetadata {\n  classMethod: string\n  cronTime: CronJobParams['cronTime'] | null\n  disabled: boolean\n}\n\nexport function getAllCronMetadata(\n  context: ClassMethodDecoratorContext | ClassDecoratorContext,\n): Set<CronMetadata> {\n  if (context.metadata) {\n    const metadata = context.metadata[CronMetadataKey] as\n      | Set<CronMetadata>\n      | undefined\n    if (metadata) {\n      return metadata\n    } else {\n      context.metadata[CronMetadataKey] = new Set<CronMetadata>()\n      return context.metadata[CronMetadataKey] as Set<CronMetadata>\n    }\n  }\n  throw new Error('[Navios-Schedule] Wrong environment.')\n}\n\nexport function getCronMetadata(\n  target: Function,\n  context: ClassMethodDecoratorContext,\n): CronMetadata {\n  if (context.metadata) {\n    const metadata = getAllCronMetadata(context)\n    if (metadata) {\n      const endpointMetadata = Array.from(metadata).find(\n        (item) => item.classMethod === target.name,\n      )\n      if (endpointMetadata) {\n        return endpointMetadata\n      } else {\n        const newMetadata: CronMetadata = {\n          classMethod: target.name,\n          cronTime: null,\n          disabled: false,\n        }\n        metadata.add(newMetadata)\n        return newMetadata\n      }\n    }\n  }\n  throw new Error('[Navios-Schedule] Wrong environment.')\n}\n","import type { ClassType } from '@navios/core'\n\nimport type { CronMetadata } from './cron.metadata.mjs'\n\nimport { getAllCronMetadata } from './cron.metadata.mjs'\n\nexport const ScheduleMetadataKey = Symbol('ControllerMetadataKey')\n\nexport interface ScheduleMetadata {\n  name: string\n  jobs: Set<CronMetadata>\n}\n\nexport function getScheduleMetadata(\n  target: ClassType,\n  context: ClassDecoratorContext,\n): ScheduleMetadata {\n  if (context.metadata) {\n    const metadata = context.metadata[ScheduleMetadataKey] as\n      | ScheduleMetadata\n      | undefined\n    if (metadata) {\n      return metadata\n    } else {\n      const jobsMetadata = getAllCronMetadata(context)\n      const newMetadata: ScheduleMetadata = {\n        name: target.name,\n        jobs: jobsMetadata,\n      }\n      context.metadata[ScheduleMetadataKey] = newMetadata\n      // @ts-expect-error We add a custom metadata key to the target\n      target[ScheduleMetadataKey] = newMetadata\n      return newMetadata\n    }\n  }\n  throw new Error('[Navios-Schedule] Wrong environment.')\n}\n\nexport function extractScheduleMetadata(target: ClassType): ScheduleMetadata {\n  // @ts-expect-error We add a custom metadata key to the target\n  const metadata = target[ScheduleMetadataKey] as ScheduleMetadata | undefined\n  if (!metadata) {\n    throw new Error(\n      '[Navios-Schedule] Controller metadata not found. Make sure to use @Controller decorator.',\n    )\n  }\n  return metadata\n}\n\nexport function hasScheduleMetadata(target: ClassType): boolean {\n  // @ts-expect-error We add a custom metadata key to the target\n  const metadata = target[ScheduleMetadataKey] as ScheduleMetadata | undefined\n\n  return !!metadata\n}\n","import type { CronJobParams } from 'cron'\n\nimport { getCronMetadata } from '../metadata/index.mjs'\n\n/**\n * Options for configuring a cron job.\n * \n * @public\n */\nexport interface CronOptions {\n  /**\n   * Whether the job should be disabled by default.\n   * Disabled jobs won't start automatically but can be manually started later.\n   * \n   * @default false\n   */\n  disabled?: boolean\n}\n\n/**\n * Decorator that marks a method to run on a cron schedule.\n * \n * The method must be in a class decorated with `@Schedulable()`.\n * The method will be automatically executed according to the provided cron expression.\n * \n * @param cronTime - Cron expression (5 or 6 fields) or a pre-defined Schedule constant\n * @param options - Optional configuration for the cron job\n * \n * @example\n * ```typescript\n * @Schedulable()\n * class TaskService {\n *   // Run daily at midnight\n *   @Cron('0 0 * * *')\n *   async dailyTask() {\n *     console.log('Running daily task')\n *   }\n * \n *   // Use pre-defined schedule\n *   @Cron(Schedule.EveryFiveMinutes)\n *   async frequentTask() {\n *     console.log('Running every 5 minutes')\n *   }\n * \n *   // Disabled job (won't start automatically)\n *   @Cron('0 2 * * *', { disabled: true })\n *   async maintenanceTask() {\n *     console.log('Maintenance task')\n *   }\n * }\n * ```\n * \n * @throws {Error} If applied to something other than a method\n * \n * @public\n */\nexport function Cron(\n  cronTime: CronJobParams['cronTime'],\n  options?: CronOptions,\n) {\n  return (\n    target: () => Promise<void>,\n    context: ClassMethodDecoratorContext,\n  ) => {\n    if (context.kind !== 'method') {\n      throw new Error(\n        `Cron can only be applied to methods, not ${context.kind}`,\n      )\n    }\n    if (context.metadata) {\n      const metadata = getCronMetadata(target, context)\n      metadata.cronTime = cronTime\n      metadata.disabled = options?.disabled ?? false\n    }\n    return target\n  }\n}\n","import type { ClassType } from '@navios/core'\n\nimport { globalRegistry, Injectable, Registry } from '@navios/core'\n\nimport { getScheduleMetadata } from '../metadata/index.mjs'\n\n/**\n * Decorator that marks a class as schedulable and makes it injectable.\n *\n * Classes decorated with `@Schedulable()` can contain methods decorated with `@Cron()`\n * that will be automatically scheduled and executed. This decorator also applies\n * the `@Injectable()` decorator, making the class available for dependency injection.\n *\n * @example\n * ```typescript\n * @Schedulable()\n * class TaskService {\n *   @Cron('0 0 * * *')\n *   async dailyTask() {\n *     // This will run daily at midnight\n *   }\n * }\n *\n * // Register the service\n * schedulerService.register(TaskService)\n * ```\n *\n * @throws {Error} If applied to something other than a class\n *\n * @public\n */\nexport function Schedulable({ registry }: { registry?: Registry } = {}) {\n  return (target: ClassType, context: ClassDecoratorContext) => {\n    if (context.kind !== 'class') {\n      throw new Error(\n        `SchedulableDecorator can only be applied to classes, not ${context.kind}`,\n      )\n    }\n    if (context.metadata) {\n      getScheduleMetadata(target, context)\n    }\n    return Injectable({ registry: registry ?? globalRegistry })(target, context)\n  }\n}\n","/**\n * Pre-defined cron schedule constants for common scheduling patterns.\n *\n * These constants provide convenient shortcuts for frequently used cron expressions,\n * making it easier to schedule jobs without manually writing cron expressions.\n *\n * @example\n * ```typescript\n * import { Schedule } from '@navios/schedule'\n *\n * @Schedulable()\n * class TaskService {\n *   @Cron(Schedule.EveryMinute)\n *   async everyMinute() {}\n *\n *   @Cron(Schedule.EveryHour)\n *   async hourly() {}\n *\n *   @Cron(Schedule.EveryDay)\n *   async daily() {}\n * }\n * ```\n *\n * @public\n */\nexport enum Schedule {\n  EveryMinute = '*/1 * * * *',\n  EveryFiveMinutes = '*/5 * * * *',\n  EveryTenMinutes = '*/10 * * * *',\n  EveryFifteenMinutes = '*/15 * * * *',\n  EveryThirtyMinutes = '*/30 * * * *',\n  EveryHour = '0 * * * *',\n  EveryTwoHours = '0 */2 * * *',\n  EveryThreeHours = '0 */3 * * *',\n  EveryFourHours = '0 */4 * * *',\n  EverySixHours = '0 */6 * * *',\n  EveryTwelveHours = '0 */12 * * *',\n  EveryDay = '0 0 * * *',\n  EveryWeek = '0 0 * * 0',\n  EveryMonth = '0 0 1 * *',\n}\n","import type { ClassType } from '@navios/core'\n\nimport { Container, inject, Injectable, Logger } from '@navios/core'\n\nimport { CronJob } from 'cron'\n\nimport type { ScheduleMetadata } from './metadata/index.mjs'\n\nimport {\n  extractScheduleMetadata,\n  hasScheduleMetadata,\n} from './metadata/index.mjs'\n\n/**\n * Service responsible for managing and executing scheduled cron jobs.\n * \n * The SchedulerService registers schedulable services decorated with `@Schedulable()`\n * and automatically starts their cron jobs based on the `@Cron()` decorator configuration.\n * \n * @example\n * ```typescript\n * import { inject, Injectable } from '@navios/core'\n * import { SchedulerService } from '@navios/schedule'\n * \n * @Injectable()\n * class AppModule {\n *   private readonly scheduler = inject(SchedulerService)\n * \n *   async onModuleInit() {\n *     this.scheduler.register(MySchedulableService)\n *   }\n * }\n * ```\n * \n * @public\n */\n@Injectable()\nexport class SchedulerService {\n  private readonly logger = inject(Logger, {\n    context: SchedulerService.name,\n  })\n  private readonly container = inject(Container)\n  private readonly jobs: Map<string, CronJob> = new Map()\n\n  /**\n   * Registers a schedulable service and starts all its cron jobs.\n   * \n   * The service must be decorated with `@Schedulable()` and contain methods\n   * decorated with `@Cron()` to be registered successfully.\n   * \n   * @param service - The schedulable service class to register\n   * @throws {Error} If the service is not decorated with `@Schedulable()`\n   * \n   * @example\n   * ```typescript\n   * @Schedulable()\n   * class TaskService {\n   *   @Cron('0 0 * * *')\n   *   async dailyTask() {\n   *     // Runs daily at midnight\n   *   }\n   * }\n   * \n   * schedulerService.register(TaskService)\n   * ```\n   * \n   * @public\n   */\n  register(service: ClassType) {\n    if (!hasScheduleMetadata(service)) {\n      throw new Error(\n        `[Navios-Schedule] Service ${service.name} is not schedulable. Make sure to use @Schedulable decorator.`,\n      )\n    }\n    const metadata = extractScheduleMetadata(service)\n    this.logger.debug('Scheduling service', metadata.name)\n    this.registerJobs(service, metadata)\n  }\n\n  /**\n   * Retrieves a specific cron job instance for a method in a schedulable service.\n   * \n   * @param service - The schedulable service class\n   * @param method - The name of the method decorated with `@Cron()`\n   * @returns The CronJob instance if found, undefined otherwise\n   * \n   * @example\n   * ```typescript\n   * const job = schedulerService.getJob(TaskService, 'dailyTask')\n   * if (job) {\n   *   console.log('Job is active:', job.isActive)\n   *   job.start() // Manually start the job\n   *   job.stop()  // Manually stop the job\n   * }\n   * ```\n   * \n   * @public\n   */\n  getJob<T extends ClassType>(\n    service: T,\n    method: keyof InstanceType<T>,\n  ): CronJob | undefined {\n    const metadata = extractScheduleMetadata(service)\n    const jobName = `${metadata.name}.${method as string}()`\n    return this.jobs.get(jobName)\n  }\n\n  private registerJobs(service: ClassType, metadata: ScheduleMetadata) {\n    const jobs = metadata.jobs\n    for (const job of jobs) {\n      if (!job.cronTime) {\n        this.logger.debug('Skipping job', job.classMethod)\n        continue\n      }\n      const name = `${metadata.name}.${job.classMethod}()`\n      const self = this\n      const defaultDisabled = false\n      const cronJob = CronJob.from({\n        cronTime: job.cronTime,\n        name,\n        async onTick() {\n          try {\n            self.logger.debug('Executing job', name)\n            const instance = await self.container.get(service)\n            await instance[job.classMethod]()\n          } catch (error) {\n            self.logger.error('Error executing job', name, error)\n          }\n        },\n        start: !(defaultDisabled || job.disabled),\n      })\n      this.jobs.set(name, cronJob)\n    }\n  }\n\n  /**\n   * Starts all registered cron jobs that are currently inactive.\n   * \n   * Only jobs that are not already active will be started. This method\n   * is useful for resuming all jobs after calling `stopAll()`.\n   * \n   * @example\n   * ```typescript\n   * // Stop all jobs\n   * schedulerService.stopAll()\n   * \n   * // Later, resume all jobs\n   * schedulerService.startAll()\n   * ```\n   * \n   * @public\n   */\n  startAll() {\n    for (const job of this.jobs.values()) {\n      if (job.isActive) {\n        continue\n      }\n      job.start()\n    }\n  }\n\n  /**\n   * Stops all registered cron jobs that are currently active.\n   * \n   * Only jobs that are currently active will be stopped. This method\n   * is useful for pausing all scheduled tasks, for example during\n   * application shutdown or maintenance.\n   * \n   * @example\n   * ```typescript\n   * // Pause all scheduled jobs\n   * schedulerService.stopAll()\n   * \n   * // Jobs can be resumed later with startAll()\n   * schedulerService.startAll()\n   * ```\n   * \n   * @public\n   */\n  stopAll() {\n    for (const job of this.jobs.values()) {\n      if (!job.isActive) {\n        continue\n      }\n      job.stop()\n    }\n  }\n}\n"],"mappings":"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"}