@cloudnux/local-cloud-provider 0.17.0 → 0.19.0

package/dist/dev-console-plugin/index.d.ts

@@ -1,7 +1,24 @@
 import { FastifyRequest, FastifyReply, FastifyInstance } from 'fastify';
-import { EventBatchItemResult } from '@cloudnux/core-cloud-provider';
+import { LoggerService, LogEntry, EventBatchItemResult } from '@cloudnux/core-cloud-provider';
 import { WebSocket } from 'ws';
 
+type LogContext = {
+    module?: string;
+    reqId?: string;
+};
+type LogListener = (entry: LogEntry) => void;
+type RunWithLogContext = <T>(context: LogContext, fn: () => T) => T;
+type SubscribeToLogs = (listener: LogListener) => () => void;
+type LoggingContext = LoggerService & {
+    runWithLogContext: RunWithLogContext;
+    subscribeToLogs: SubscribeToLogs;
+};
+declare module "fastify" {
+    interface FastifyInstance {
+        logging: LoggingContext;
+    }
+}
+
 interface QueueMessage {
     id: string;
     timestamp: Date;
@@ -20,7 +37,6 @@ interface QueueService {
     incoming: QueueMessage[];
     processing: QueueMessage[];
     dlq: QueueMessage[];
-    timeoutId: NodeJS.Timeout | null;
     processingBatch: boolean;
     module?: string;
 }
@@ -31,12 +47,12 @@ interface QueueConfig {
     parallel: boolean;
     maxConcurrent: number;
     retryBackoff: boolean;
+    tickIntervalMs: number;
     persistence: {
         enabled?: boolean;
         directory: string;
         saveInterval?: number;
         saveOnShutdown?: boolean;
-        loadOnStartup?: boolean;
     };
 }
 interface QueueSummary {
@@ -51,6 +67,17 @@ interface QueueSummary {
         maxConcurrent: number;
     };
 }
+interface QueueMessageHistoryEntry {
+    id: string;
+    queueName: string;
+    status: 'completed' | 'failed';
+    timestamp: Date;
+    completedAt: Date;
+    attempts: number;
+    payload: any;
+    attributes: Record<string, any>;
+    error?: string;
+}
 interface QueueManager {
     addQueue: (queueName: string, handler: EventHandler, module?: string) => Promise<void>;
     removeQueue: (queueName: string) => Promise<void>;
@@ -82,6 +109,7 @@ interface QueueManager {
         message: string;
         purged: number;
     } | null>;
+    getMessageHistory: (queueName: string, limit?: number) => QueueMessageHistoryEntry[];
 }
 declare module 'fastify' {
     interface FastifyInstance {
@@ -114,13 +142,12 @@ interface JobExecution {
     error?: string;
     result?: any;
 }
+type JobHandler = (job: ScheduledJob, execution: JobExecution) => Promise<void>;
 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;
@@ -133,16 +160,59 @@ interface JobDefinition {
     timezone?: string;
     module?: string;
 }
+interface SchedulerConfig {
+    tickIntervalMs: number;
+    persistence: {
+        enabled?: boolean;
+        directory: string;
+        saveInterval?: number;
+        saveOnShutdown?: boolean;
+    };
+    execution: {
+        maxConcurrent: number;
+        defaultTimeout: number;
+    };
+    cleanup: {
+        maxExecutionHistory: number;
+        cleanupInterval: number;
+    };
+    restartBehavior: {
+        preserveNaturalTiming: boolean;
+        skipMissedRuns: boolean;
+        maxTimingDrift: number;
+        rapidRestartThreshold: number;
+    };
+    cron: {
+        defaultTimezone?: string;
+        logCronDetails: boolean;
+    };
+}
+interface SchedulerDashboardJob extends ScheduledJob {
+    isRunning: boolean;
+    timeUntilNextRun: number;
+    upcomingExecutions: Date[];
+    cronDescription?: string;
+}
 interface SchedulerManager {
     addJob: (jobDefinition: JobDefinition) => Promise<string>;
     removeJob: (jobName: string) => Promise<void>;
     hasJob: (jobName: string) => boolean;
     listJobs: (module?: string) => string[];
     getJobStats: (jobName: string) => SchedulerService | null;
+    getJobsMap: () => Record<string, SchedulerService>;
+    getConfig: () => SchedulerConfig;
     enableJob: (jobName: string) => Promise<void>;
     disableJob: (jobName: string) => Promise<void>;
     triggerJob: (jobName: string) => Promise<void>;
-    getJobsMap: () => Record<string, SchedulerService>;
+    getDashboardSummary: () => {
+        jobs: SchedulerDashboardJob[];
+        runningExecutions: number;
+    };
+    getExecutionsSummary: () => {
+        executions: JobExecution[];
+        running: JobExecution[];
+    };
+    getJobExecutionHistory: (jobName: string, limit?: number) => JobExecution[];
 }
 declare module 'fastify' {
     interface FastifyInstance {