@superdangerous/app-framework 4.9.0

package/dist/services/websocketEvents.js.map

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

package/dist/services/websocketServer.d.ts

@@ -0,0 +1,80 @@
+/**
+ * WebSocket Server Implementation
+ * Provides real-time updates for simulator data and events
+ */
+import { Server } from "socket.io";
+import { Server as HTTPServer } from "http";
+interface ClientInfo {
+    id: string;
+    connectedAt: Date;
+    subscriptions: Set<string>;
+}
+interface BroadcastData {
+    simulatorId?: string;
+    templateId?: string;
+    [key: string]: any;
+}
+declare class WebSocketServer {
+    private io;
+    private httpServer;
+    private clients;
+    private simulatorSubscriptions;
+    private broadcastHook?;
+    constructor(httpServer: HTTPServer);
+    initialize(opts?: {
+        broadcastHook?: (event: string, data: any) => void;
+    }): void;
+    /**
+     * Get the underlying Socket.IO server instance
+     */
+    getIO(): Server | null;
+    private setupEventHandlers;
+    private subscribeToSimulator;
+    private unsubscribeFromSimulator;
+    private handleDisconnect;
+    /**
+     * Broadcast an event to all connected clients
+     */
+    broadcast(event: string, data: BroadcastData): void;
+    /**
+     * Send event to specific simulator subscribers
+     */
+    broadcastToSimulator(simulatorId: string, event: string, data: any): void;
+    /**
+     * Get statistics about connected clients
+     */
+    getStats(): {
+        totalClients: number;
+        totalSubscriptions: number;
+        simulatorSubscriptions: Record<string, number>;
+    };
+    /**
+     * Get list of connected clients
+     */
+    getClients(): ClientInfo[];
+    /**
+     * Check if server is initialized
+     */
+    isInitialized(): boolean;
+    /**
+     * Shutdown the WebSocket server
+     */
+    shutdown(): Promise<void>;
+}
+/**
+ * Create WebSocket server instance
+ */
+export declare function createWebSocketServer(httpServer: HTTPServer, opts?: {
+    reset?: boolean;
+    broadcastHook?: (event: string, data: any) => void;
+}): WebSocketServer;
+/**
+ * Get existing WebSocket server instance
+ */
+export declare function getWebSocketServer(): WebSocketServer | null;
+/**
+ * Export the class for type usage
+ */
+export { WebSocketServer };
+export type { ClientInfo, BroadcastData };
+//# sourceMappingURL=websocketServer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"websocketServer.d.ts","sourceRoot":"","sources":["../../src/services/websocketServer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,MAAM,EAAU,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,MAAM,CAAC;AAa5C,UAAU,UAAU;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,IAAI,CAAC;IAClB,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CAC5B;AAED,UAAU,aAAa;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED,cAAM,eAAe;IACnB,OAAO,CAAC,EAAE,CAAuB;IACjC,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,OAAO,CAA0B;IACzC,OAAO,CAAC,sBAAsB,CAA2B;IACzD,OAAO,CAAC,aAAa,CAAC,CAAqC;gBAE/C,UAAU,EAAE,UAAU;IAWlC,UAAU,CAAC,IAAI,CAAC,EAAE;QAChB,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,KAAK,IAAI,CAAC;KACpD,GAAG,IAAI;IAyBR;;OAEG;IACH,KAAK,IAAI,MAAM,GAAG,IAAI;IAItB,OAAO,CAAC,kBAAkB;IA6C1B,OAAO,CAAC,oBAAoB;IAsB5B,OAAO,CAAC,wBAAwB;IAwBhC,OAAO,CAAC,gBAAgB;IAmBxB;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,GAAG,IAAI;IAqEnD;;OAEG;IACH,oBAAoB,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,IAAI;IAoBzE;;OAEG;IACH,QAAQ,IAAI;QACV,YAAY,EAAE,MAAM,CAAC;QACrB,kBAAkB,EAAE,MAAM,CAAC;QAC3B,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KAChD;IAoBD;;OAEG;IACH,UAAU,IAAI,UAAU,EAAE;IAI1B;;OAEG;IACH,aAAa,IAAI,OAAO;IAIxB;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAoBhC;AAKD;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,UAAU,EACtB,IAAI,CAAC,EAAE;IACL,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,KAAK,IAAI,CAAC;CACpD,GACA,eAAe,CAcjB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,eAAe,GAAG,IAAI,CAE3D;AAED;;GAEG;AACH,OAAO,EAAE,eAAe,EAAE,CAAC;AAC3B,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,CAAC"}

package/dist/services/websocketServer.js

@@ -0,0 +1,299 @@
+/**
+ * WebSocket Server Implementation
+ * Provides real-time updates for simulator data and events
+ */
+import { Server } from "socket.io";
+import { createLogger } from "../core/index.js";
+let logger; // Will be initialized when needed
+class WebSocketServer {
+    io = null;
+    httpServer;
+    clients;
+    simulatorSubscriptions; // simulatorId -> Set of socket IDs
+    broadcastHook;
+    constructor(httpServer) {
+        // Initialize logger if not already done
+        if (!logger) {
+            logger = createLogger("WebSocket");
+        }
+        this.httpServer = httpServer;
+        this.clients = new Map();
+        this.simulatorSubscriptions = new Map();
+    }
+    initialize(opts) {
+        if (this.io) {
+            if (opts?.broadcastHook) {
+                this.broadcastHook = opts.broadcastHook;
+                logger.debug("WebSocket broadcast hook updated");
+            }
+            return;
+        }
+        this.io = new Server(this.httpServer, {
+            cors: {
+                origin: "*", // Allow all origins for local development
+                methods: ["GET", "POST"],
+            },
+            transports: ["websocket", "polling"],
+        });
+        if (opts?.broadcastHook) {
+            this.broadcastHook = opts.broadcastHook;
+        }
+        this.setupEventHandlers();
+        logger.info("WebSocket server initialized");
+    }
+    /**
+     * Get the underlying Socket.IO server instance
+     */
+    getIO() {
+        return this.io;
+    }
+    setupEventHandlers() {
+        if (!this.io)
+            return;
+        this.io.on("connection", (socket) => {
+            // Only log in debug mode to avoid spam
+            if (process.env.LOG_LEVEL?.toLowerCase() === "debug") {
+                logger.debug(`Client connected: ${socket.id}`);
+            }
+            this.clients.set(socket.id, {
+                id: socket.id,
+                connectedAt: new Date(),
+                subscriptions: new Set(),
+            });
+            // Send initial connection confirmation
+            socket.emit("connected", {
+                id: socket.id,
+                timestamp: Date.now(),
+            });
+            // Handle simulator subscriptions
+            socket.on("subscribe:simulator", (simulatorId) => {
+                this.subscribeToSimulator(socket, simulatorId);
+            });
+            socket.on("unsubscribe:simulator", (simulatorId) => {
+                this.unsubscribeFromSimulator(socket, simulatorId);
+            });
+            // Handle disconnection
+            socket.on("disconnect", () => {
+                // Only log in debug mode to avoid spam
+                if (process.env.LOG_LEVEL?.toLowerCase() === "debug") {
+                    logger.debug(`Client disconnected: ${socket.id}`);
+                }
+                this.handleDisconnect(socket);
+            });
+            // Handle errors
+            socket.on("error", (_error) => {
+                logger.error(`Socket error for ${socket.id}:`, _error);
+            });
+        });
+    }
+    subscribeToSimulator(socket, simulatorId) {
+        const client = this.clients.get(socket.id);
+        if (!client)
+            return;
+        // Add to client's subscriptions
+        client.subscriptions.add(simulatorId);
+        // Add to simulator's subscriber list
+        if (!this.simulatorSubscriptions.has(simulatorId)) {
+            this.simulatorSubscriptions.set(simulatorId, new Set());
+        }
+        const subscribers = this.simulatorSubscriptions.get(simulatorId);
+        if (subscribers) {
+            subscribers.add(socket.id);
+        }
+        // Join socket.io room for efficient broadcasting
+        socket.join(`simulator:${simulatorId}`);
+        logger.debug(`Client ${socket.id} subscribed to simulator ${simulatorId}`);
+    }
+    unsubscribeFromSimulator(socket, simulatorId) {
+        const client = this.clients.get(socket.id);
+        if (!client)
+            return;
+        // Remove from client's subscriptions
+        client.subscriptions.delete(simulatorId);
+        // Remove from simulator's subscriber list
+        const subscribers = this.simulatorSubscriptions.get(simulatorId);
+        if (subscribers) {
+            subscribers.delete(socket.id);
+            if (subscribers.size === 0) {
+                this.simulatorSubscriptions.delete(simulatorId);
+            }
+        }
+        // Leave socket.io room
+        socket.leave(`simulator:${simulatorId}`);
+        logger.debug(`Client ${socket.id} unsubscribed from simulator ${simulatorId}`);
+    }
+    handleDisconnect(socket) {
+        const client = this.clients.get(socket.id);
+        if (!client)
+            return;
+        // Clean up all subscriptions
+        client.subscriptions.forEach((simulatorId) => {
+            const subscribers = this.simulatorSubscriptions.get(simulatorId);
+            if (subscribers) {
+                subscribers.delete(socket.id);
+                if (subscribers.size === 0) {
+                    this.simulatorSubscriptions.delete(simulatorId);
+                }
+            }
+        });
+        // Remove client
+        this.clients.delete(socket.id);
+    }
+    /**
+     * Broadcast an event to all connected clients
+     */
+    broadcast(event, data) {
+        if (!this.io)
+            return;
+        // Allow tests/consumers to observe outbound broadcasts
+        if (this.broadcastHook) {
+            try {
+                this.broadcastHook(event, data);
+            }
+            catch (_err) {
+                // ignore hook errors
+            }
+        }
+        // Create typed message based on event
+        let message;
+        // Timestamp removed - not needed in simplified message structure
+        switch (event) {
+            case "simulator:started":
+            case "simulator:stopped":
+            case "simulator:update":
+                message = {
+                    type: event,
+                    data: data,
+                };
+                break;
+            case "template:created":
+            case "template:updated":
+            case "template:deleted":
+                message = {
+                    type: event,
+                    data: data,
+                };
+                break;
+            case "simulator:data":
+                message = {
+                    type: "data:update",
+                    data: {
+                        simulatorId: data.simulatorId,
+                        values: data.values || { [data.address]: data.value },
+                    },
+                };
+                break;
+            default:
+                message = {
+                    type: event,
+                    data: data,
+                };
+        }
+        // Broadcast to all clients
+        this.io.emit(event, message.data);
+        // If simulator-specific, also send to room
+        if (data.simulatorId) {
+            this.io.to(`simulator:${data.simulatorId}`).emit(event, message.data);
+        }
+        logger.debug(`Broadcast ${event} to ${this.clients.size} clients`);
+    }
+    /**
+     * Send event to specific simulator subscribers
+     */
+    broadcastToSimulator(simulatorId, event, data) {
+        if (!this.io)
+            return;
+        const message = {
+            type: "data:update",
+            data: {
+                simulatorId,
+                values: data,
+            },
+        };
+        this.io.to(`simulator:${simulatorId}`).emit(event, message.data);
+        const subscriberCount = this.simulatorSubscriptions.get(simulatorId)?.size || 0;
+        logger.debug(`Broadcast ${event} to ${subscriberCount} subscribers of simulator ${simulatorId}`);
+    }
+    /**
+     * Get statistics about connected clients
+     */
+    getStats() {
+        const stats = {
+            totalClients: this.clients.size,
+            totalSubscriptions: 0,
+            simulatorSubscriptions: {},
+        };
+        // Count total subscriptions
+        this.clients.forEach((client) => {
+            stats.totalSubscriptions += client.subscriptions.size;
+        });
+        // Count per-simulator subscriptions
+        this.simulatorSubscriptions.forEach((subscribers, simulatorId) => {
+            stats.simulatorSubscriptions[simulatorId] = subscribers.size;
+        });
+        return stats;
+    }
+    /**
+     * Get list of connected clients
+     */
+    getClients() {
+        return Array.from(this.clients.values());
+    }
+    /**
+     * Check if server is initialized
+     */
+    isInitialized() {
+        return this.io !== null;
+    }
+    /**
+     * Shutdown the WebSocket server
+     */
+    async shutdown() {
+        if (this.io) {
+            // Disconnect all clients
+            this.io.disconnectSockets();
+            // Close the server
+            await new Promise((resolve) => {
+                this.io.close(() => {
+                    logger.info("WebSocket server shut down");
+                    resolve();
+                });
+            });
+            this.io = null;
+        }
+        // Clear all data
+        this.clients.clear();
+        this.simulatorSubscriptions.clear();
+    }
+}
+// Singleton instance
+let wsServer = null;
+/**
+ * Create WebSocket server instance
+ */
+export function createWebSocketServer(httpServer, opts) {
+    // Initialize logger if not already done
+    if (!logger) {
+        logger = createLogger("WebSocket");
+    }
+    if (!wsServer || opts?.reset) {
+        wsServer = new WebSocketServer(httpServer);
+        wsServer.initialize({ broadcastHook: opts?.broadcastHook });
+    }
+    else if (opts?.broadcastHook) {
+        // Reconfigure hook without rebuilding the IO server
+        wsServer.initialize({ broadcastHook: opts.broadcastHook });
+    }
+    return wsServer;
+}
+/**
+ * Get existing WebSocket server instance
+ */
+export function getWebSocketServer() {
+    return wsServer;
+}
+/**
+ * Export the class for type usage
+ */
+export { WebSocketServer };
+//# sourceMappingURL=websocketServer.js.map

package/dist/services/websocketServer.js.map

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

package/dist/settings/SettingsSchema.d.ts

@@ -0,0 +1,151 @@
+/**
+ * Settings Schema System
+ * Consolidated settings system with all features from both implementations
+ */
+export interface SettingOption {
+    value: any;
+    label: string;
+    description?: string;
+}
+export interface SettingDefinition {
+    key: string;
+    label: string;
+    description?: string;
+    defaultValue?: any;
+    type: "string" | "number" | "boolean" | "select" | "multiselect" | "password" | "textarea" | "email" | "url" | "color" | "date" | "time" | "datetime" | "json" | "ipaddress" | "network-interface";
+    options?: SettingOption[];
+    required?: boolean;
+    validation?: {
+        min?: number;
+        max?: number;
+        minLength?: number;
+        maxLength?: number;
+        pattern?: string;
+        custom?: (value: any) => string | null;
+    };
+    validationMessage?: string;
+    transform?: {
+        fromStorage?: (value: any) => any;
+        toStorage?: (value: any) => any;
+    };
+    help?: string;
+    hint?: string;
+    placeholder?: string;
+    prefix?: string;
+    suffix?: string;
+    inputWidth?: "small" | "medium" | "large" | "full";
+    rows?: number;
+    readOnly?: boolean;
+    hidden?: boolean;
+    sensitive?: boolean;
+    requiresRestart?: boolean;
+    category: string;
+    subcategory?: string;
+    group?: string;
+    order?: number;
+    icon?: string;
+    showIf?: (settings: Record<string, any>) => boolean;
+    confirmMessage?: string;
+    min?: number;
+    max?: number;
+    step?: number;
+}
+export interface SettingsCategory {
+    id: string;
+    label: string;
+    description?: string;
+    icon?: string;
+    settings: SettingDefinition[];
+    order?: number;
+}
+export interface SettingsSchema {
+    categories: SettingsCategory[];
+    version: string;
+    onSettingChange?: (key: string, value: any, oldValue: any) => void | Promise<void>;
+    onValidate?: (settings: Record<string, any>) => Record<string, string> | null;
+}
+export interface SettingsFormState {
+    values: Record<string, any>;
+    errors: Record<string, string>;
+    touched: Record<string, boolean>;
+    dirty: Record<string, boolean>;
+    isValid: boolean;
+    isSubmitting: boolean;
+}
+export interface SettingsValidationResult {
+    isValid: boolean;
+    errors: Record<string, string>;
+}
+/**
+ * Built-in validation functions
+ */
+export declare const Validators: {
+    required: (message?: string) => (value: any) => string | null;
+    email: (message?: string) => (value: string) => string | null;
+    url: (message?: string) => (value: string) => string | null;
+    ipAddress: (message?: string) => (value: string) => string | null;
+    port: (message?: string) => (value: number) => string | null;
+    range: (min: number, max: number, message?: string) => (value: number) => string | null;
+    pattern: (pattern: RegExp, message?: string) => (value: string) => string | null;
+    minLength: (min: number, message?: string) => (value: string) => string | null;
+    maxLength: (max: number, message?: string) => (value: string) => string | null;
+};
+/**
+ * Helper to create a settings schema
+ */
+export declare function createSettingsSchema(schema: SettingsSchema): SettingsSchema;
+/**
+ * Get setting by key from categories
+ */
+export declare function getSettingByKey(categories: SettingsCategory[], key: string): SettingDefinition | undefined;
+/**
+ * Validate a single setting
+ */
+export declare function validateSetting(setting: SettingDefinition, value: any): string | null;
+/**
+ * Validate all settings against schema
+ */
+export declare function validateSettings(schema: SettingsSchema, settings: Record<string, any>): Record<string, string>;
+/**
+ * Validate all settings (returns result object)
+ */
+export declare function validateAllSettings(categories: SettingsCategory[], values: Record<string, any>): SettingsValidationResult;
+/**
+ * Helper to flatten nested settings for storage
+ */
+export declare function flattenSettings(settings: any, prefix?: string): Record<string, any>;
+export declare const flattenSettingsValues: typeof flattenSettings;
+/**
+ * Helper to unflatten settings from storage
+ */
+export declare function unflattenSettings(flattened: Record<string, any>): any;
+export declare const unflattenSettingsValues: typeof unflattenSettings;
+/**
+ * Get all settings that require restart
+ */
+export declare function getRestartRequiredSettings(schema: SettingsSchema | SettingsCategory[], changedSettings: Record<string, any> | string[]): string[];
+/**
+ * Get default values from settings
+ */
+export declare function getDefaultSettingsValues(categories: SettingsCategory[]): Record<string, any>;
+/**
+ * Evaluate conditional visibility for a field
+ */
+export declare function evaluateFieldVisibility(field: SettingDefinition, currentValues: Record<string, any>): boolean;
+/**
+ * Group fields by their group property
+ */
+export declare function groupFields(fields: SettingDefinition[]): Map<string, SettingDefinition[]>;
+/**
+ * Apply toStorage transform
+ */
+export declare function applyToStorageTransform(field: SettingDefinition, value: any): any;
+/**
+ * Apply fromStorage transform
+ */
+export declare function applyFromStorageTransform(field: SettingDefinition, value: any): any;
+/**
+ * Create settings form state
+ */
+export declare function createSettingsFormState(categories: SettingsCategory[], initialValues?: Record<string, any>): SettingsFormState;
+//# sourceMappingURL=SettingsSchema.d.ts.map

package/dist/settings/SettingsSchema.d.ts.map

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