@navios/schedule 0.5.0 → 0.7.1

package/lib/index.mjs.map

@@ -1 +1 @@
-{"version":3,"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"],"names":["Schedule","Injectable"],"mappings":"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","file":"index.mjs","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\nexport interface CronOptions {\n  disabled?: boolean\n}\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 { Injectable } from '@navios/core'\n\nimport { getScheduleMetadata } from '../metadata/index.mjs'\n\nexport function Schedulable() {\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()(target, context)\n  }\n}\n","export 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@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  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  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  startAll() {\n    for (const job of this.jobs.values()) {\n      if (job.isActive) {\n        continue\n      }\n      job.start()\n    }\n  }\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"]}
+{"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","Injectable","getScheduleMetadata","Schedulable","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 { Injectable } 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() {\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()(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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@navios/schedule",
-  "version": "0.5.0",
+  "version": "0.7.1",
   "author": {
     "name": "Oleksandr Hanzha",
     "email": "alex@granted.name"
@@ -12,11 +12,11 @@
   },
   "license": "MIT",
   "peerDependencies": {
-    "@navios/core": "^0.5.0",
+    "@navios/core": "^0.7.1",
     "zod": "^3.25.0 || ^4.0.0"
   },
   "typings": "./lib/index.d.mts",
-  "main": "./lib/index.js",
+  "main": "./lib/index.cjs",
   "module": "./lib/index.mjs",
   "exports": {
     ".": {
@@ -25,17 +25,17 @@
         "default": "./lib/index.mjs"
       },
       "require": {
-        "types": "./lib/index.d.ts",
-        "default": "./lib/index.js"
+        "types": "./lib/index.d.cts",
+        "default": "./lib/index.cjs"
       }
     }
   },
   "devDependencies": {
-    "@navios/core": "^0.5.0",
-    "typescript": "^5.9.2",
-    "zod": "^4.1.8"
+    "@navios/core": "^0.7.1",
+    "typescript": "^5.9.3",
+    "zod": "^4.2.1"
   },
   "dependencies": {
-    "cron": "^4.3.3"
+    "cron": "^4.4.0"
   }
 }

package/project.json

@@ -25,11 +25,11 @@
     },
     "build": {
       "executor": "nx:run-commands",
-      "inputs": ["projectSources"],
+      "inputs": ["projectSources", "{projectRoot}/tsdown.config.mts"],
       "outputs": ["{projectRoot}/lib"],
       "dependsOn": ["check", "test:ci"],
       "options": {
-        "command": "tsup",
+        "command": "tsdown",
         "cwd": "packages/schedule"
       }
     },

package/src/cron.constants.mts

@@ -1,3 +1,28 @@
+/**
+ * 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
+ */
 export enum Schedule {
   EveryMinute = '*/1 * * * *',
   EveryFiveMinutes = '*/5 * * * *',

package/src/decorators/cron.decorator.mts

@@ -2,10 +2,58 @@ import type { CronJobParams } from 'cron'
 
 import { getCronMetadata } from '../metadata/index.mjs'
 
+/**
+ * Options for configuring a cron job.
+ * 
+ * @public
+ */
 export 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
+ */
 export function Cron(
   cronTime: CronJobParams['cronTime'],
   options?: CronOptions,

package/src/decorators/schedulable.decorator.mts

@@ -4,6 +4,31 @@ import { Injectable } from '@navios/core'
 
 import { getScheduleMetadata } from '../metadata/index.mjs'
 
+/**
+ * Decorator that marks a class as schedulable and makes it injectable.
+ * 
+ * Classes decorated with `@Schedulable()` can contain methods decorated with `@Cron()`
+ * that will be automatically scheduled and executed. This decorator also applies
+ * the `@Injectable()` decorator, making the class available for dependency injection.
+ * 
+ * @example
+ * ```typescript
+ * @Schedulable()
+ * class TaskService {
+ *   @Cron('0 0 * * *')
+ *   async dailyTask() {
+ *     // This will run daily at midnight
+ *   }
+ * }
+ * 
+ * // Register the service
+ * schedulerService.register(TaskService)
+ * ```
+ * 
+ * @throws {Error} If applied to something other than a class
+ * 
+ * @public
+ */
 export function Schedulable() {
   return (target: ClassType, context: ClassDecoratorContext) => {
     if (context.kind !== 'class') {

package/src/scheduler.service.mts

@@ -11,6 +11,29 @@ import {
   hasScheduleMetadata,
 } from './metadata/index.mjs'
 
+/**
+ * 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
+ */
 @Injectable()
 export class SchedulerService {
   private readonly logger = inject(Logger, {
@@ -19,6 +42,30 @@ export class SchedulerService {
   private readonly container = inject(Container)
   private readonly jobs: Map<string, CronJob> = new Map()
 
+  /**
+   * 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) {
     if (!hasScheduleMetadata(service)) {
       throw new Error(
@@ -30,6 +77,25 @@ export class SchedulerService {
     this.registerJobs(service, metadata)
   }
 
+  /**
+   * 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>,
@@ -67,6 +133,23 @@ export class SchedulerService {
     }
   }
 
+  /**
+   * 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() {
     for (const job of this.jobs.values()) {
       if (job.isActive) {
@@ -76,6 +159,24 @@ export class SchedulerService {
     }
   }
 
+  /**
+   * 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() {
     for (const job of this.jobs.values()) {
       if (!job.isActive) {

package/tsdown.config.mts

@@ -0,0 +1,33 @@
+import { withFilter } from 'rolldown/filter'
+import { defineConfig } from 'tsdown'
+import swc from 'unplugin-swc'
+
+export default defineConfig({
+  entry: ['src/index.mts'],
+  outDir: 'lib',
+  format: ['esm', 'cjs'],
+  clean: true,
+  treeshake: true,
+  sourcemap: true,
+  platform: 'node',
+  dts: true,
+  target: 'es2022',
+  plugins: [
+    withFilter(
+      swc.rolldown({
+        jsc: {
+          target: 'es2022',
+          parser: {
+            syntax: 'typescript',
+            decorators: true,
+          },
+          transform: {
+            decoratorVersion: '2022-03',
+          },
+        },
+      }),
+      // Only run this transform if the file contains a decorator.
+      { transform: { code: '@' } },
+    ),
+  ],
+})

package/lib/_tsup-dts-rollup.d.mts

@@ -1,106 +0,0 @@
-import type { ClassType } from '@navios/core';
-import { CronJob } from 'cron';
-import type { CronJobParams } from 'cron';
-
-declare function Cron(cronTime: CronJobParams['cronTime'], options?: CronOptions): (target: () => Promise<void>, context: ClassMethodDecoratorContext) => () => Promise<void>;
-export { Cron }
-export { Cron as Cron_alias_1 }
-export { Cron as Cron_alias_2 }
-
-declare interface CronMetadata {
-    classMethod: string;
-    cronTime: CronJobParams['cronTime'] | null;
-    disabled: boolean;
-}
-export { CronMetadata }
-export { CronMetadata as CronMetadata_alias_1 }
-export { CronMetadata as CronMetadata_alias_2 }
-
-declare const CronMetadataKey: unique symbol;
-export { CronMetadataKey }
-export { CronMetadataKey as CronMetadataKey_alias_1 }
-export { CronMetadataKey as CronMetadataKey_alias_2 }
-
-declare interface CronOptions {
-    disabled?: boolean;
-}
-export { CronOptions }
-export { CronOptions as CronOptions_alias_1 }
-export { CronOptions as CronOptions_alias_2 }
-
-declare function extractScheduleMetadata(target: ClassType): ScheduleMetadata;
-export { extractScheduleMetadata }
-export { extractScheduleMetadata as extractScheduleMetadata_alias_1 }
-export { extractScheduleMetadata as extractScheduleMetadata_alias_2 }
-
-declare function getAllCronMetadata(context: ClassMethodDecoratorContext | ClassDecoratorContext): Set<CronMetadata>;
-export { getAllCronMetadata }
-export { getAllCronMetadata as getAllCronMetadata_alias_1 }
-export { getAllCronMetadata as getAllCronMetadata_alias_2 }
-
-declare function getCronMetadata(target: Function, context: ClassMethodDecoratorContext): CronMetadata;
-export { getCronMetadata }
-export { getCronMetadata as getCronMetadata_alias_1 }
-export { getCronMetadata as getCronMetadata_alias_2 }
-
-declare function getScheduleMetadata(target: ClassType, context: ClassDecoratorContext): ScheduleMetadata;
-export { getScheduleMetadata }
-export { getScheduleMetadata as getScheduleMetadata_alias_1 }
-export { getScheduleMetadata as getScheduleMetadata_alias_2 }
-
-declare function hasScheduleMetadata(target: ClassType): boolean;
-export { hasScheduleMetadata }
-export { hasScheduleMetadata as hasScheduleMetadata_alias_1 }
-export { hasScheduleMetadata as hasScheduleMetadata_alias_2 }
-
-declare function Schedulable(): (target: ClassType, context: ClassDecoratorContext) => ClassType;
-export { Schedulable }
-export { Schedulable as Schedulable_alias_1 }
-export { Schedulable as Schedulable_alias_2 }
-
-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 * *"
-}
-export { Schedule }
-export { Schedule as Schedule_alias_1 }
-
-declare interface ScheduleMetadata {
-    name: string;
-    jobs: Set<CronMetadata>;
-}
-export { ScheduleMetadata }
-export { ScheduleMetadata as ScheduleMetadata_alias_1 }
-export { ScheduleMetadata as ScheduleMetadata_alias_2 }
-
-declare const ScheduleMetadataKey: unique symbol;
-export { ScheduleMetadataKey }
-export { ScheduleMetadataKey as ScheduleMetadataKey_alias_1 }
-export { ScheduleMetadataKey as ScheduleMetadataKey_alias_2 }
-
-declare class SchedulerService {
-    private readonly logger;
-    private readonly container;
-    private readonly jobs;
-    register(service: ClassType): void;
-    getJob<T extends ClassType>(service: T, method: keyof InstanceType<T>): CronJob | undefined;
-    private registerJobs;
-    startAll(): void;
-    stopAll(): void;
-}
-export { SchedulerService }
-export { SchedulerService as SchedulerService_alias_1 }
-
-export { }

package/lib/_tsup-dts-rollup.d.ts

@@ -1,106 +0,0 @@
-import type { ClassType } from '@navios/core';
-import { CronJob } from 'cron';
-import type { CronJobParams } from 'cron';
-
-declare function Cron(cronTime: CronJobParams['cronTime'], options?: CronOptions): (target: () => Promise<void>, context: ClassMethodDecoratorContext) => () => Promise<void>;
-export { Cron }
-export { Cron as Cron_alias_1 }
-export { Cron as Cron_alias_2 }
-
-declare interface CronMetadata {
-    classMethod: string;
-    cronTime: CronJobParams['cronTime'] | null;
-    disabled: boolean;
-}
-export { CronMetadata }
-export { CronMetadata as CronMetadata_alias_1 }
-export { CronMetadata as CronMetadata_alias_2 }
-
-declare const CronMetadataKey: unique symbol;
-export { CronMetadataKey }
-export { CronMetadataKey as CronMetadataKey_alias_1 }
-export { CronMetadataKey as CronMetadataKey_alias_2 }
-
-declare interface CronOptions {
-    disabled?: boolean;
-}
-export { CronOptions }
-export { CronOptions as CronOptions_alias_1 }
-export { CronOptions as CronOptions_alias_2 }
-
-declare function extractScheduleMetadata(target: ClassType): ScheduleMetadata;
-export { extractScheduleMetadata }
-export { extractScheduleMetadata as extractScheduleMetadata_alias_1 }
-export { extractScheduleMetadata as extractScheduleMetadata_alias_2 }
-
-declare function getAllCronMetadata(context: ClassMethodDecoratorContext | ClassDecoratorContext): Set<CronMetadata>;
-export { getAllCronMetadata }
-export { getAllCronMetadata as getAllCronMetadata_alias_1 }
-export { getAllCronMetadata as getAllCronMetadata_alias_2 }
-
-declare function getCronMetadata(target: Function, context: ClassMethodDecoratorContext): CronMetadata;
-export { getCronMetadata }
-export { getCronMetadata as getCronMetadata_alias_1 }
-export { getCronMetadata as getCronMetadata_alias_2 }
-
-declare function getScheduleMetadata(target: ClassType, context: ClassDecoratorContext): ScheduleMetadata;
-export { getScheduleMetadata }
-export { getScheduleMetadata as getScheduleMetadata_alias_1 }
-export { getScheduleMetadata as getScheduleMetadata_alias_2 }
-
-declare function hasScheduleMetadata(target: ClassType): boolean;
-export { hasScheduleMetadata }
-export { hasScheduleMetadata as hasScheduleMetadata_alias_1 }
-export { hasScheduleMetadata as hasScheduleMetadata_alias_2 }
-
-declare function Schedulable(): (target: ClassType, context: ClassDecoratorContext) => ClassType;
-export { Schedulable }
-export { Schedulable as Schedulable_alias_1 }
-export { Schedulable as Schedulable_alias_2 }
-
-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 * *"
-}
-export { Schedule }
-export { Schedule as Schedule_alias_1 }
-
-declare interface ScheduleMetadata {
-    name: string;
-    jobs: Set<CronMetadata>;
-}
-export { ScheduleMetadata }
-export { ScheduleMetadata as ScheduleMetadata_alias_1 }
-export { ScheduleMetadata as ScheduleMetadata_alias_2 }
-
-declare const ScheduleMetadataKey: unique symbol;
-export { ScheduleMetadataKey }
-export { ScheduleMetadataKey as ScheduleMetadataKey_alias_1 }
-export { ScheduleMetadataKey as ScheduleMetadataKey_alias_2 }
-
-declare class SchedulerService {
-    private readonly logger;
-    private readonly container;
-    private readonly jobs;
-    register(service: ClassType): void;
-    getJob<T extends ClassType>(service: T, method: keyof InstanceType<T>): CronJob | undefined;
-    private registerJobs;
-    startAll(): void;
-    stopAll(): void;
-}
-export { SchedulerService }
-export { SchedulerService as SchedulerService_alias_1 }
-
-export { }

package/lib/index.d.ts

@@ -1,14 +0,0 @@
-export { Cron } from './_tsup-dts-rollup.js';
-export { CronOptions } from './_tsup-dts-rollup.js';
-export { Schedulable } from './_tsup-dts-rollup.js';
-export { getAllCronMetadata } from './_tsup-dts-rollup.js';
-export { getCronMetadata } from './_tsup-dts-rollup.js';
-export { CronMetadataKey } from './_tsup-dts-rollup.js';
-export { CronMetadata } from './_tsup-dts-rollup.js';
-export { getScheduleMetadata } from './_tsup-dts-rollup.js';
-export { extractScheduleMetadata } from './_tsup-dts-rollup.js';
-export { hasScheduleMetadata } from './_tsup-dts-rollup.js';
-export { ScheduleMetadataKey } from './_tsup-dts-rollup.js';
-export { ScheduleMetadata } from './_tsup-dts-rollup.js';
-export { Schedule_alias_1 as Schedule } from './_tsup-dts-rollup.js';
-export { SchedulerService } from './_tsup-dts-rollup.js';