@fluojs/cron 1.0.0-beta.1

package/dist/task-discovery.js

@@ -0,0 +1,104 @@
+import { getClassDiMetadata } from '@fluojs/core/internal';
+import { getSchedulingTaskMetadataEntries } from './metadata.js';
+export function buildDefaultTaskName(targetName, methodName) {
+  return `${targetName}.${methodName}`;
+}
+export function createLockKey(prefix, taskName) {
+  return `${prefix}:${taskName}`;
+}
+export function methodKeyToName(methodKey) {
+  return typeof methodKey === 'symbol' ? methodKey.toString() : methodKey;
+}
+export function discoverCronTaskDescriptors(compiledModules, options, logger) {
+  const seen = new Map();
+  const descriptors = [];
+  for (const candidate of collectDiscoveryCandidates(compiledModules)) {
+    const entries = getSchedulingTaskMetadataEntries(candidate.targetType.prototype);
+    if (candidate.scope !== 'singleton') {
+      if (entries.length > 0) {
+        logger.warn(`${candidate.targetType.name} in module ${candidate.moduleName} declares scheduling methods (@Cron/@Interval/@Timeout) but is registered with ${candidate.scope} scope. Scheduling tasks are run only for singleton providers.`, 'CronLifecycleService');
+      }
+      continue;
+    }
+    for (const entry of entries) {
+      const methodName = methodKeyToName(entry.propertyKey);
+      const taskName = entry.metadata.options.name ?? buildDefaultTaskName(candidate.targetType.name, methodName);
+      const seenMethods = seen.get(candidate.targetType) ?? new Set();
+      const lockTtlMs = entry.metadata.options.lockTtlMs ?? options.distributed.lockTtlMs;
+      if (seenMethods.has(methodName)) {
+        continue;
+      }
+      seenMethods.add(methodName);
+      seen.set(candidate.targetType, seenMethods);
+      const descriptor = {
+        afterRun: entry.metadata.options.afterRun,
+        beforeRun: entry.metadata.options.beforeRun,
+        distributed: entry.metadata.options.distributed ?? true,
+        kind: entry.metadata.kind,
+        lockKey: createLockKey(options.distributed.keyPrefix, entry.metadata.options.key ?? taskName),
+        lockTtlMs,
+        methodKey: entry.propertyKey,
+        methodName,
+        moduleName: candidate.moduleName,
+        onError: entry.metadata.options.onError,
+        onSuccess: entry.metadata.options.onSuccess,
+        targetName: candidate.targetType.name,
+        taskName,
+        token: candidate.token
+      };
+      if (entry.metadata.kind === 'cron') {
+        descriptor.expression = entry.metadata.expression;
+        descriptor.timezone = entry.metadata.options.timezone;
+      } else {
+        descriptor.ms = entry.metadata.ms;
+      }
+      descriptors.push(descriptor);
+    }
+  }
+  return descriptors;
+}
+function scopeFromProvider(provider) {
+  if (typeof provider === 'function') {
+    return getClassDiMetadata(provider)?.scope ?? 'singleton';
+  }
+  if ('useClass' in provider) {
+    return provider.scope ?? getClassDiMetadata(provider.useClass)?.scope ?? 'singleton';
+  }
+  return 'scope' in provider ? provider.scope ?? 'singleton' : 'singleton';
+}
+function isClassProvider(provider) {
+  return typeof provider === 'object' && provider !== null && 'useClass' in provider;
+}
+function collectDiscoveryCandidates(compiledModules) {
+  const candidates = [];
+  for (const compiledModule of compiledModules) {
+    for (const provider of compiledModule.definition.providers ?? []) {
+      if (typeof provider === 'function') {
+        candidates.push({
+          moduleName: compiledModule.type.name,
+          scope: scopeFromProvider(provider),
+          targetType: provider,
+          token: provider
+        });
+        continue;
+      }
+      if (isClassProvider(provider)) {
+        candidates.push({
+          moduleName: compiledModule.type.name,
+          scope: scopeFromProvider(provider),
+          targetType: provider.useClass,
+          token: provider.provide
+        });
+      }
+    }
+    for (const controller of compiledModule.definition.controllers ?? []) {
+      candidates.push({
+        moduleName: compiledModule.type.name,
+        scope: scopeFromProvider(controller),
+        targetType: controller,
+        token: controller
+      });
+    }
+  }
+  return candidates;
+}

package/dist/task-runner.d.ts

@@ -0,0 +1,15 @@
+import type { Container } from '@fluojs/di';
+import type { ApplicationLogger } from '@fluojs/runtime';
+import type { CronTaskDescriptor } from './types.js';
+export declare class CronTaskRunner {
+    private readonly runtimeContainer;
+    private readonly logger;
+    constructor(runtimeContainer: Container, logger: ApplicationLogger);
+    executeTask(descriptor: CronTaskDescriptor, postRunErrorProvider?: () => Error | Promise<Error | undefined> | undefined): Promise<unknown>;
+    private resolveTaskInvocation;
+    private runTaskBeforeHook;
+    private runTaskSuccessHook;
+    private runTaskErrorHook;
+    private runTaskAfterHook;
+}
+//# sourceMappingURL=task-runner.d.ts.map

package/dist/task-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-runner.d.ts","sourceRoot":"","sources":["../src/task-runner.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEzD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAOrD,qBAAa,cAAc;IAEvB,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM;gBADN,gBAAgB,EAAE,SAAS,EAC3B,MAAM,EAAE,iBAAiB;IAGtC,WAAW,CACf,UAAU,EAAE,kBAAkB,EAC9B,oBAAoB,CAAC,EAAE,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,GAAG,SAAS,CAAC,GAAG,SAAS,GAC1E,OAAO,CAAC,OAAO,CAAC;YA8BL,qBAAqB;YA8CrB,iBAAiB;YAQjB,kBAAkB;YAQlB,gBAAgB;YAUhB,gBAAgB;CAW/B"}

package/dist/task-runner.js

@@ -0,0 +1,87 @@
+export class CronTaskRunner {
+  constructor(runtimeContainer, logger) {
+    this.runtimeContainer = runtimeContainer;
+    this.logger = logger;
+  }
+  async executeTask(descriptor, postRunErrorProvider) {
+    const taskInvocation = await this.resolveTaskInvocation(descriptor);
+    if (!taskInvocation) {
+      return undefined;
+    }
+    let taskError;
+    try {
+      await this.runTaskBeforeHook(descriptor);
+      await Promise.resolve(taskInvocation.callable.call(taskInvocation.instance));
+      const postRunError = await postRunErrorProvider?.();
+      if (postRunError) {
+        throw postRunError;
+      }
+      await this.runTaskSuccessHook(descriptor);
+    } catch (error) {
+      taskError = error;
+      this.logger.error(`Cron task ${descriptor.taskName} failed.`, error, 'CronLifecycleService');
+    }
+    await this.runTaskErrorHook(descriptor, taskError);
+    await this.runTaskAfterHook(descriptor);
+    return taskError;
+  }
+  async resolveTaskInvocation(descriptor) {
+    if (descriptor.callback) {
+      return {
+        callable: descriptor.callback,
+        instance: undefined
+      };
+    }
+    if (!descriptor.token || descriptor.methodKey === undefined || !descriptor.targetName || !descriptor.moduleName || !descriptor.methodName) {
+      this.logger.error(`Scheduling task ${descriptor.taskName} is missing invocation metadata and was skipped.`, undefined, 'CronLifecycleService');
+      return undefined;
+    }
+    let instance;
+    try {
+      instance = await this.runtimeContainer.resolve(descriptor.token);
+    } catch (error) {
+      this.logger.error(`Failed to resolve cron task target ${descriptor.targetName} from module ${descriptor.moduleName}.`, error, 'CronLifecycleService');
+      return undefined;
+    }
+    const value = instance[descriptor.methodKey];
+    if (typeof value !== 'function') {
+      this.logger.warn(`Cron method ${descriptor.targetName}.${descriptor.methodName} is not callable and was skipped.`, 'CronLifecycleService');
+      return undefined;
+    }
+    return {
+      callable: value,
+      instance
+    };
+  }
+  async runTaskBeforeHook(descriptor) {
+    if (!descriptor.beforeRun) {
+      return;
+    }
+    await Promise.resolve(descriptor.beforeRun());
+  }
+  async runTaskSuccessHook(descriptor) {
+    if (!descriptor.onSuccess) {
+      return;
+    }
+    await Promise.resolve(descriptor.onSuccess());
+  }
+  async runTaskErrorHook(descriptor, taskError) {
+    if (taskError && descriptor.onError) {
+      try {
+        await Promise.resolve(descriptor.onError(taskError));
+      } catch (hookError) {
+        this.logger.error(`Cron onError hook ${descriptor.taskName} failed.`, hookError, 'CronLifecycleService');
+      }
+    }
+  }
+  async runTaskAfterHook(descriptor) {
+    if (!descriptor.afterRun) {
+      return;
+    }
+    try {
+      await Promise.resolve(descriptor.afterRun());
+    } catch (hookError) {
+      this.logger.error(`Cron afterRun hook ${descriptor.taskName} failed.`, hookError, 'CronLifecycleService');
+    }
+  }
+}

package/dist/tokens.d.ts

@@ -0,0 +1,7 @@
+import type { Token } from '@fluojs/core';
+import type { NormalizedCronModuleOptions, SchedulingRegistry } from './types.js';
+/** Injection token for normalized cron module options used by {@link CronLifecycleService}. */
+export declare const CRON_OPTIONS: Token<NormalizedCronModuleOptions>;
+/** Injection token for the runtime scheduling registry exposed to application code. */
+export declare const SCHEDULING_REGISTRY: Token<SchedulingRegistry>;
+//# sourceMappingURL=tokens.d.ts.map

package/dist/tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../src/tokens.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAE1C,OAAO,KAAK,EAAE,2BAA2B,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAElF,+FAA+F;AAC/F,eAAO,MAAM,YAAY,EAAE,KAAK,CAAC,2BAA2B,CAAmC,CAAC;AAChG,uFAAuF;AACvF,eAAO,MAAM,mBAAmB,EAAE,KAAK,CAAC,kBAAkB,CAA+C,CAAC"}

package/dist/tokens.js

@@ -0,0 +1,4 @@
+/** Injection token for normalized cron module options used by {@link CronLifecycleService}. */
+export const CRON_OPTIONS = Symbol.for('fluo.cron.options');
+/** Injection token for the runtime scheduling registry exposed to application code. */
+export const SCHEDULING_REGISTRY = Symbol.for('fluo.cron.scheduling-registry');

package/dist/types.d.ts

@@ -0,0 +1,206 @@
+import type { MetadataPropertyKey, Token } from '@fluojs/core';
+/** Supported task kinds handled by the scheduler runtime. */
+export type SchedulingTaskKind = 'cron' | 'interval' | 'timeout';
+/** Callback shape executed for one scheduled task invocation. */
+export type SchedulingTaskCallback = () => void | Promise<void>;
+/** Shared lifecycle hooks and lock settings supported by all scheduling APIs. */
+export interface SchedulingTaskOptions {
+    afterRun?: () => void | Promise<void>;
+    beforeRun?: () => void | Promise<void>;
+    distributed?: boolean;
+    key?: string;
+    lockTtlMs?: number;
+    name?: string;
+    onError?: (error: unknown) => void | Promise<void>;
+    onSuccess?: () => void | Promise<void>;
+}
+/** Additional options available only for cron-expression tasks. */
+export interface CronTaskOptions extends SchedulingTaskOptions {
+    timezone?: string;
+}
+/** Options for fixed-interval tasks registered with {@link Interval} or {@link SchedulingRegistry.addInterval}. */
+export type IntervalTaskOptions = SchedulingTaskOptions;
+/** Options for one-shot delayed tasks registered with {@link Timeout} or {@link SchedulingRegistry.addTimeout}. */
+export type TimeoutTaskOptions = SchedulingTaskOptions;
+/** Metadata captured for one method decorated with {@link Cron}. */
+export interface CronTaskMetadata {
+    kind: 'cron';
+    expression: string;
+    options: CronTaskOptions;
+}
+/** Metadata captured for one method decorated with {@link Interval}. */
+export interface IntervalTaskMetadata {
+    kind: 'interval';
+    ms: number;
+    options: IntervalTaskOptions;
+}
+/** Metadata captured for one method decorated with {@link Timeout}. */
+export interface TimeoutTaskMetadata {
+    kind: 'timeout';
+    ms: number;
+    options: TimeoutTaskOptions;
+}
+/** Union of all decorator metadata shapes consumed by the scheduler runtime. */
+export type SchedulingTaskMetadata = CronTaskMetadata | IntervalTaskMetadata | TimeoutTaskMetadata;
+/** Distributed lock configuration for multi-instance scheduling. */
+export interface CronDistributedOptions {
+    clientName?: string;
+    enabled?: boolean;
+    keyPrefix?: string;
+    lockTtlMs?: number;
+    ownerId?: string;
+}
+/** Shutdown drain configuration for active cron tasks. */
+export interface CronShutdownOptions {
+    timeoutMs?: number;
+}
+/** Scheduler handle returned by the underlying cron engine. */
+export interface CronScheduledJob {
+    stop(): void;
+}
+/** Options forwarded to the low-level cron scheduler implementation. */
+export interface CronScheduleOptions {
+    name?: string;
+    protect?: boolean;
+    timezone?: string;
+}
+/** Adapter contract used to schedule cron expressions in the runtime. */
+export type CronScheduler = (expression: string, options: CronScheduleOptions, callback: () => Promise<void>) => CronScheduledJob;
+/** Module configuration accepted by {@link CronModule.forRoot}. */
+export interface CronModuleOptions {
+    distributed?: boolean | CronDistributedOptions;
+    scheduler?: CronScheduler;
+    shutdown?: CronShutdownOptions;
+}
+/** Normalized scheduler configuration used internally by {@link CronLifecycleService}. */
+export interface NormalizedCronModuleOptions {
+    distributed: {
+        clientName?: string;
+        enabled: boolean;
+        keyPrefix: string;
+        lockTtlMs: number;
+        ownerId: string;
+    };
+    scheduler: CronScheduler;
+    shutdown: {
+        timeoutMs: number;
+    };
+}
+/** Runtime descriptor for one discovered or dynamically registered task. */
+export interface CronTaskDescriptor {
+    callback?: SchedulingTaskCallback;
+    kind: SchedulingTaskKind;
+    afterRun?: () => void | Promise<void>;
+    beforeRun?: () => void | Promise<void>;
+    distributed: boolean;
+    expression?: string;
+    ms?: number;
+    lockKey: string;
+    lockTtlMs: number;
+    methodKey?: MetadataPropertyKey;
+    methodName?: string;
+    moduleName?: string;
+    onError?: (error: unknown) => void | Promise<void>;
+    onSuccess?: () => void | Promise<void>;
+    taskName: string;
+    timezone?: string;
+    targetName?: string;
+    token?: Token;
+}
+/** Read-only task descriptor exposed by the scheduling registry. */
+export interface SchedulingTaskDescriptor {
+    enabled: boolean;
+    kind: SchedulingTaskKind;
+    name: string;
+    source: 'decorator' | 'dynamic';
+    distributed: boolean;
+    lockKey: string;
+    lockTtlMs: number;
+    expression?: string;
+    ms?: number;
+    timezone?: string;
+    moduleName?: string;
+    targetName?: string;
+    methodName?: string;
+}
+/**
+ * Programmatic registry for adding, inspecting, and mutating scheduled tasks at runtime.
+ *
+ * @example
+ * ```ts
+ * registry.addCron('cleanup', '0 * * * *', async () => {
+ *   await cleanupExpiredSessions();
+ * });
+ * ```
+ */
+export interface SchedulingRegistry {
+    /**
+     * Adds a cron-expression task to the runtime registry.
+     *
+     * @param name Stable task name used for lookup and distributed lock keys.
+     * @param expression Cron expression validated before registration.
+     * @param callback Task body executed on each schedule tick.
+     * @param options Optional task hooks, naming overrides, and distributed lock controls.
+     */
+    addCron(name: string, expression: string, callback: SchedulingTaskCallback, options?: CronTaskOptions): void;
+    /**
+     * Adds a fixed-interval task to the runtime registry.
+     *
+     * @param name Stable task name used for lookup and distributed lock keys.
+     * @param ms Positive interval in milliseconds.
+     * @param callback Task body executed on each interval tick.
+     * @param options Optional task hooks, naming overrides, and distributed lock controls.
+     */
+    addInterval(name: string, ms: number, callback: SchedulingTaskCallback, options?: IntervalTaskOptions): void;
+    /**
+     * Adds a one-shot delayed task to the runtime registry.
+     *
+     * @param name Stable task name used for lookup and distributed lock keys.
+     * @param ms Positive delay in milliseconds before the callback runs once.
+     * @param callback Task body executed after the delay elapses.
+     * @param options Optional task hooks, naming overrides, and distributed lock controls.
+     */
+    addTimeout(name: string, ms: number, callback: SchedulingTaskCallback, options?: TimeoutTaskOptions): void;
+    /**
+     * Removes one registered task from the runtime registry.
+     *
+     * @param name Task name to remove.
+     * @returns `true` when a task existed and was removed.
+     */
+    remove(name: string): boolean;
+    /**
+     * Re-enables a previously disabled task.
+     *
+     * @param name Task name to enable.
+     * @returns `true` when the task exists after the operation.
+     */
+    enable(name: string): boolean;
+    /**
+     * Disables a task without deleting its descriptor.
+     *
+     * @param name Task name to disable.
+     * @returns `true` when the task exists after the operation.
+     */
+    disable(name: string): boolean;
+    /**
+     * Reads one task descriptor by name.
+     *
+     * @param name Task name to inspect.
+     * @returns The current descriptor, or `undefined` when no task is registered.
+     */
+    get(name: string): SchedulingTaskDescriptor | undefined;
+    /**
+     * Lists all registered tasks.
+     *
+     * @returns All known task descriptors, including decorator-discovered and dynamic tasks.
+     */
+    getAll(): SchedulingTaskDescriptor[];
+    /**
+     * Replaces the cron expression for an existing cron task.
+     *
+     * @param name Task name to update.
+     * @param expression New cron expression validated before rescheduling.
+     */
+    updateCronExpression(name: string, expression: string): void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@fluojs/cron",
+  "description": "Decorator-based task scheduling for Fluo with cron, interval, and timeout triggers and optional distributed locking.",
+  "keywords": [
+    "fluo",
+    "cron",
+    "scheduler",
+    "interval",
+    "timeout",
+    "distributed-lock"
+  ],
+  "version": "1.0.0-beta.1",
+  "private": false,
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/fluojs/fluo.git",
+    "directory": "packages/cron"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "croner": "^8.1.2",
+    "@fluojs/core": "^1.0.0-beta.1",
+    "@fluojs/redis": "^1.0.0-beta.1",
+    "@fluojs/di": "^1.0.0-beta.1",
+    "@fluojs/runtime": "^1.0.0-beta.1"
+  },
+  "devDependencies": {
+    "vitest": "^3.2.4"
+  },
+  "scripts": {
+    "prebuild": "node ../../tooling/scripts/clean-dist.mjs",
+    "build": "pnpm exec babel src --extensions .ts --ignore 'src/**/*.test.ts' --out-dir dist --config-file ../../tooling/babel/babel.config.cjs && pnpm exec tsc -p tsconfig.build.json",
+    "typecheck": "pnpm exec tsc -p tsconfig.json --noEmit",
+    "test": "pnpm exec vitest run -c vitest.config.ts",
+    "test:watch": "pnpm exec vitest -c vitest.config.ts"
+  }
+}