@superdangerous/app-framework 4.9.0

package/dist/services/queueService.js

@@ -0,0 +1,338 @@
+/**
+ * Queue Service for background job processing
+ * Based on patterns from mila-ai but enhanced with TypeScript and better error handling
+ */
+import { EventEmitter } from "events";
+import { createLogger } from "../core/index.js";
+import { getStorageService } from "../core/storageService.js";
+let logger; // Will be initialized when needed
+function ensureLogger() {
+    if (!logger) {
+        logger = createLogger("QueueService");
+    }
+    return logger;
+}
+export class QueueService extends EventEmitter {
+    jobs;
+    handlers;
+    isRunning;
+    activeJobs;
+    config;
+    pollingTimer;
+    fileHandler = getStorageService();
+    constructor(config = {}) {
+        super();
+        this.config = {
+            maxConcurrentJobs: config.maxConcurrentJobs || 3,
+            pollingInterval: config.pollingInterval || 5000,
+            maxRetries: config.maxRetries || 3,
+            enablePersistence: config.enablePersistence || false,
+        };
+        this.jobs = new Map();
+        this.handlers = new Map();
+        this.isRunning = false;
+        this.activeJobs = 0;
+        ensureLogger().debug("QueueService initialized", this.config);
+    }
+    /**
+     * Register a job handler
+     */
+    registerHandler(jobType, handler) {
+        this.handlers.set(jobType, handler);
+        ensureLogger().debug(`Registered handler for job type: ${jobType}`);
+    }
+    /**
+     * Add a job to the queue
+     */
+    async addJob(type, data, priority = 0) {
+        const jobId = `${type}_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
+        const job = {
+            id: jobId,
+            type,
+            data,
+            status: "pending",
+            priority,
+            retries: 0,
+            maxRetries: this.config.maxRetries,
+            createdAt: new Date(),
+            updatedAt: new Date(),
+        };
+        this.jobs.set(jobId, job);
+        if (this.config.enablePersistence) {
+            await this.persistJob(job);
+        }
+        this.emit("job:added", job);
+        ensureLogger().info(`Added job ${jobId} of type ${type}`);
+        // Check if this is a high-priority job that should preempt current processing
+        if (this.isRunning && priority > 5) {
+            // Check if we have capacity and if new job has higher priority than any processing job
+            const processingJobs = Array.from(this.jobs.values()).filter((j) => j.status === "processing");
+            if (this.activeJobs < this.config.maxConcurrentJobs) {
+                // We have free workers, process immediately
+                this.processNextJob();
+            }
+            else if (processingJobs.some((j) => j.priority < priority)) {
+                // New job has higher priority than some processing jobs
+                ensureLogger().info(`High priority job ${jobId} added, triggering immediate processing`);
+                this.processNextJob();
+            }
+        }
+        else if (this.isRunning) {
+            // Normal priority job, process normally
+            this.processNextJob();
+        }
+        return jobId;
+    }
+    /**
+     * Start processing jobs
+     */
+    async start() {
+        if (this.isRunning) {
+            ensureLogger().warn("Queue is already running");
+            return;
+        }
+        this.isRunning = true;
+        ensureLogger().debug("Starting queue processing");
+        if (this.config.enablePersistence) {
+            await this.loadPersistedJobs();
+        }
+        this.startPolling();
+        this.emit("queue:started");
+    }
+    /**
+     * Stop processing jobs
+     */
+    async stop() {
+        if (!this.isRunning) {
+            ensureLogger().warn("Queue is not running");
+            return;
+        }
+        this.isRunning = false;
+        if (this.pollingTimer) {
+            clearInterval(this.pollingTimer);
+            this.pollingTimer = undefined;
+        }
+        ensureLogger().info("Stopping queue processing");
+        // Wait for active jobs to complete
+        while (this.activeJobs > 0) {
+            await new Promise((resolve) => setTimeout(resolve, 100));
+        }
+        this.emit("queue:stopped");
+        ensureLogger().info("Queue processing stopped");
+    }
+    /**
+     * Process the next job in the queue
+     */
+    async processNextJob() {
+        if (!this.isRunning)
+            return;
+        if (this.activeJobs >= this.config.maxConcurrentJobs) {
+            ensureLogger().debug(`Max concurrent jobs reached (${this.activeJobs}/${this.config.maxConcurrentJobs})`);
+            return;
+        }
+        const job = this.getNextPendingJob();
+        if (!job) {
+            ensureLogger().debug("No pending jobs found");
+            return;
+        }
+        const handler = this.handlers.get(job.type);
+        if (!handler) {
+            ensureLogger().error(`No handler registered for job type: ${job.type}`);
+            await this.failJob(job, "No handler registered");
+            return;
+        }
+        this.activeJobs++;
+        job.status = "processing";
+        job.processedAt = new Date();
+        job.updatedAt = new Date();
+        ensureLogger().info(`Processing job ${job.id} (${job.type}), Active: ${this.activeJobs}`);
+        this.emit("job:started", job);
+        try {
+            await handler(job);
+            await this.completeJob(job);
+        }
+        catch (_error) {
+            await this.handleJobError(job, _error);
+        }
+        finally {
+            this.activeJobs--;
+            // Process next job immediately if available
+            if (this.isRunning) {
+                setImmediate(() => this.processNextJob());
+            }
+        }
+    }
+    /**
+     * Get the next pending job based on priority
+     */
+    getNextPendingJob() {
+        const pendingJobs = Array.from(this.jobs.values())
+            .filter((job) => job.status === "pending")
+            .sort((a, b) => {
+            // Higher priority first
+            if (a.priority !== b.priority) {
+                return b.priority - a.priority;
+            }
+            // Earlier jobs first
+            return a.createdAt.getTime() - b.createdAt.getTime();
+        });
+        return pendingJobs[0] || null;
+    }
+    /**
+     * Mark a job as completed
+     */
+    async completeJob(job) {
+        job.status = "completed";
+        job.updatedAt = new Date();
+        ensureLogger().info(`Job ${job.id} completed successfully`);
+        this.emit("job:completed", job);
+        if (this.config.enablePersistence) {
+            await this.persistJob(job);
+        }
+        // Remove completed jobs after some time to prevent memory leak
+        setTimeout(() => {
+            this.jobs.delete(job.id);
+        }, 60000); // Keep for 1 minute
+    }
+    /**
+     * Handle job error
+     */
+    async handleJobError(job, error) {
+        job.retries++;
+        job.error = error.message;
+        job.updatedAt = new Date();
+        ensureLogger().error(`Job ${job.id} failed: ${error.message}`, error);
+        if (job.retries < job.maxRetries) {
+            job.status = "pending"; // Retry
+            ensureLogger().info(`Job ${job.id} will be retried (${job.retries}/${job.maxRetries})`);
+            this.emit("job:retry", job);
+        }
+        else {
+            await this.failJob(job, error.message);
+        }
+        if (this.config.enablePersistence) {
+            await this.persistJob(job);
+        }
+    }
+    /**
+     * Mark a job as failed
+     */
+    async failJob(job, reason) {
+        job.status = "failed";
+        job.error = reason;
+        job.updatedAt = new Date();
+        ensureLogger().error(`Job ${job.id} failed permanently: ${reason}`);
+        this.emit("job:failed", job);
+        if (this.config.enablePersistence) {
+            // Move failed job to dead-letter queue directory
+            await this.moveToDeadLetterQueue(job);
+        }
+    }
+    /**
+     * Move failed job to dead-letter queue
+     */
+    async moveToDeadLetterQueue(job) {
+        try {
+            // Save to data directory with failed_ prefix
+            await this.fileHandler.saveFile(`failed_${job.id}_${Date.now()}.json`, JSON.stringify(job, null, 2), "data", { overwrite: true });
+            // Remove original queue file from main queue directory
+            await this.fileHandler.deleteFile(`queue_${job.id}.json`, "data");
+            ensureLogger().info(`Moved failed job ${job.id} to dead-letter queue`);
+        }
+        catch (_error) {
+            ensureLogger().error("Failed to move job to dead-letter queue:", _error);
+        }
+    }
+    /**
+     * Start polling for jobs
+     */
+    startPolling() {
+        this.pollingTimer = setInterval(() => {
+            this.processNextJob();
+        }, this.config.pollingInterval);
+        // Process immediately
+        this.processNextJob();
+    }
+    /**
+     * Persist job to file
+     */
+    async persistJob(job) {
+        try {
+            await this.fileHandler.saveFile(`queue_${job.id}.json`, JSON.stringify(job, null, 2), "data", { overwrite: true });
+        }
+        catch (_error) {
+            ensureLogger().error("Failed to persist job", _error);
+        }
+    }
+    /**
+     * Load persisted jobs
+     */
+    async loadPersistedJobs() {
+        try {
+            const files = await this.fileHandler.listFiles("data", /^queue_.*\.json$/);
+            for (const file of files) {
+                try {
+                    const content = await this.fileHandler.readFile(file.name, "data");
+                    const job = JSON.parse(content.toString());
+                    // Convert date strings back to Date objects
+                    job.createdAt = new Date(job.createdAt);
+                    job.updatedAt = new Date(job.updatedAt);
+                    if (job.processedAt) {
+                        job.processedAt = new Date(job.processedAt);
+                    }
+                    // Reset processing jobs to pending
+                    if (job.status === "processing") {
+                        job.status = "pending";
+                    }
+                    this.jobs.set(job.id, job);
+                }
+                catch (_error) {
+                    ensureLogger().error(`Failed to load job from ${file.name}`, _error);
+                }
+            }
+            ensureLogger().debug(`Loaded ${this.jobs.size} persisted jobs`);
+        }
+        catch (_error) {
+            ensureLogger().error("Failed to load persisted jobs", _error);
+        }
+    }
+    /**
+     * Get queue statistics
+     */
+    getStats() {
+        const jobs = Array.from(this.jobs.values());
+        return {
+            total: jobs.length,
+            pending: jobs.filter((j) => j.status === "pending").length,
+            processing: jobs.filter((j) => j.status === "processing").length,
+            completed: jobs.filter((j) => j.status === "completed").length,
+            failed: jobs.filter((j) => j.status === "failed").length,
+            activeJobs: this.activeJobs,
+        };
+    }
+    /**
+     * Get job by ID
+     */
+    getJob(jobId) {
+        return this.jobs.get(jobId);
+    }
+    /**
+     * Get all jobs
+     */
+    getAllJobs() {
+        return Array.from(this.jobs.values());
+    }
+    /**
+     * Clear completed and failed jobs
+     */
+    clearFinishedJobs() {
+        for (const [id, job] of this.jobs) {
+            if (job.status === "completed" || job.status === "failed") {
+                this.jobs.delete(id);
+            }
+        }
+        ensureLogger().info("Cleared finished jobs");
+    }
+}
+export default QueueService;
+//# sourceMappingURL=queueService.js.map

package/dist/services/queueService.js.map

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

package/dist/services/settingsService.d.ts

@@ -0,0 +1,135 @@
+/**
+ * Settings Service
+ * Manages application settings with persistence, validation, and real-time updates
+ */
+import { EventEmitter } from "events";
+import { ZodSchema } from "zod";
+export interface SettingsCategory {
+    id: string;
+    label: string;
+    description?: string;
+    icon?: string;
+    schema?: ZodSchema;
+    fields: SettingsField[];
+    order?: number;
+}
+export interface SettingsField {
+    key: string;
+    label: string;
+    type: "text" | "number" | "boolean" | "select" | "multiselect" | "json" | "password" | "email" | "url" | "color" | "date" | "time" | "datetime";
+    description?: string;
+    placeholder?: string;
+    defaultValue?: any;
+    required?: boolean;
+    validation?: ZodSchema;
+    options?: Array<{
+        value: any;
+        label: string;
+        description?: string;
+    }>;
+    min?: number;
+    max?: number;
+    step?: number;
+    pattern?: string;
+    readonly?: boolean;
+    hidden?: boolean;
+    dependsOn?: {
+        field: string;
+        value: any;
+    };
+    transform?: (value: any) => any;
+    format?: (value: any) => string;
+}
+export interface SettingsOptions {
+    storagePath?: string;
+    autoSave?: boolean;
+    saveDebounce?: number;
+    encryptSensitive?: boolean;
+    sensitiveFields?: string[];
+}
+export declare class SettingsService extends EventEmitter {
+    private options;
+    private categories;
+    private settings;
+    private storagePath?;
+    private autoSave;
+    private saveDebounce;
+    private saveTimeout?;
+    private sensitiveFields;
+    constructor(options?: SettingsOptions);
+    /**
+     * Register a settings category
+     */
+    registerCategory(category: SettingsCategory): void;
+    /**
+     * Load settings from storage
+     */
+    load(): Promise<void>;
+    /**
+     * Save settings to storage
+     */
+    save(): Promise<void>;
+    /**
+     * Get a setting value
+     */
+    get<T = any>(key: string, defaultValue?: T): T;
+    /**
+     * Set a setting value
+     */
+    set(key: string, value: any): Promise<void>;
+    /**
+     * Update multiple settings
+     */
+    update(updates: Record<string, any>): Promise<void>;
+    /**
+     * Get all settings
+     */
+    getAll(): Record<string, any>;
+    /**
+     * Get settings by category
+     */
+    getByCategory(categoryId: string): Record<string, any>;
+    /**
+     * Get all categories
+     */
+    getCategories(): SettingsCategory[];
+    /**
+     * Get category by ID
+     */
+    getCategory(id: string): SettingsCategory | undefined;
+    /**
+     * Validate all settings
+     */
+    validate(): {
+        valid: boolean;
+        errors: Record<string, string>;
+    };
+    /**
+     * Reset settings to defaults
+     */
+    reset(categoryId?: string): void;
+    /**
+     * Export settings
+     */
+    export(categoryId?: string): string;
+    /**
+     * Import settings
+     */
+    import(data: string): Promise<void>;
+    private findField;
+    private scheduleSave;
+    private encryptSensitiveFields;
+    private decryptSensitiveFields;
+    private getNestedValue;
+    private setNestedValue;
+}
+/**
+ * Create common settings categories
+ */
+export declare const CommonSettingsCategories: {
+    general: () => SettingsCategory;
+    server: () => SettingsCategory;
+    logging: () => SettingsCategory;
+};
+export default SettingsService;
+//# sourceMappingURL=settingsService.d.ts.map

package/dist/services/settingsService.d.ts.map

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