@cloudnux/local-cloud-provider 0.1.0

package/dist/schedule-plugin/index.d.ts

@@ -0,0 +1,111 @@
+import { FastifyPluginOptions, FastifyPluginAsync } from 'fastify';
+
+interface ScheduledJob {
+    id: string;
+    name: string;
+    cronExpression?: string;
+    intervalMs?: number;
+    delayMs?: number;
+    nextRun: Date;
+    lastRun?: Date;
+    enabled: boolean;
+    runCount: number;
+    maxRuns?: number;
+    metadata?: Record<string, any>;
+    createdAt: Date;
+    timezone?: string;
+}
+interface JobExecution {
+    id: string;
+    jobId: string;
+    startTime: Date;
+    endTime?: Date;
+    status: 'running' | 'completed' | 'failed';
+    error?: string;
+    result?: any;
+}
+interface SchedulerService {
+    job: ScheduledJob;
+    handler: JobHandler;
+    timerId?: NodeJS.Timeout;
+    isRunning: boolean;
+}
+type JobHandler = (job: ScheduledJob, execution: JobExecution) => Promise<void>;
+interface JobDefinition {
+    name: string;
+    cronExpression?: string;
+    intervalMs?: number;
+    delayMs?: number;
+    handler: JobHandler;
+    enabled?: boolean;
+    maxRuns?: number;
+    metadata?: Record<string, any>;
+    timezone?: string;
+}
+interface SchedulerConfig {
+    persistence: {
+        enabled: boolean;
+        directory: string;
+        saveInterval: number;
+    };
+    execution: {
+        maxConcurrent: number;
+        defaultTimeout: number;
+        retryOnError: boolean;
+        maxRetries: number;
+    };
+    cleanup: {
+        maxExecutionHistory: number;
+        cleanupInterval: number;
+    };
+    restartBehavior: {
+        preserveNaturalTiming: boolean;
+        skipMissedRuns: boolean;
+        maxTimingDrift: number;
+        rapidRestartThreshold: number;
+    };
+    cron: {
+        defaultTimezone?: string;
+        logCronDetails: boolean;
+    };
+}
+interface SchedulerPluginOptions extends FastifyPluginOptions {
+    prefix?: string;
+    config?: Partial<SchedulerConfig>;
+}
+interface SchedulerState {
+    schedulers: Record<string, SchedulerService>;
+    executions: Record<string, JobExecution>;
+    executionHistory: JobExecution[];
+    isShuttingDown: boolean;
+    runningExecutions: number;
+    cleanupInterval?: NodeJS.Timeout;
+    lastRestartTime: Date;
+    config: SchedulerConfig;
+}
+interface SchedulerManager {
+    addJob: (jobDefinition: JobDefinition) => Promise<string>;
+    removeJob: (jobName: string) => Promise<void>;
+    hasJob: (jobName: string) => boolean;
+    listJobs: () => string[];
+    getJobStats: (jobName: string) => SchedulerService | null;
+    enableJob: (jobName: string) => Promise<void>;
+    disableJob: (jobName: string) => Promise<void>;
+    triggerJob: (jobName: string) => Promise<void>;
+    getJobsMap: () => Record<string, SchedulerService>;
+}
+interface SchedulerDecoratorOptions {
+    state: SchedulerState;
+    scheduleJobFn: (scheduler: SchedulerService) => SchedulerService;
+    executeJob: (scheduler: SchedulerService) => Promise<void>;
+    config: SchedulerConfig;
+}
+declare module 'fastify' {
+    interface FastifyInstance {
+        scheduler: SchedulerManager;
+    }
+}
+
+declare const schedulerPlugin: FastifyPluginAsync<SchedulerPluginOptions>;
+
+export { type JobDefinition, type JobExecution, type JobHandler, type ScheduledJob, type SchedulerConfig, type SchedulerDecoratorOptions, type SchedulerManager, type SchedulerPluginOptions, type SchedulerService, type SchedulerState, schedulerPlugin };