@superdangerous/app-framework 4.9.0

package/dist/settings/SettingsSchema.js

@@ -0,0 +1,424 @@
+/**
+ * Settings Schema System
+ * Consolidated settings system with all features from both implementations
+ */
+/**
+ * Built-in validation functions
+ */
+export const Validators = {
+    required: (message = "This field is required") => (value) => {
+        if (!value || (typeof value === "string" && !value.trim())) {
+            return message;
+        }
+        return null;
+    },
+    email: (message = "Invalid email address") => (value) => {
+        if (value && !/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(value)) {
+            return message;
+        }
+        return null;
+    },
+    url: (message = "Invalid URL") => (value) => {
+        if (value) {
+            try {
+                new URL(value);
+            }
+            catch {
+                return message;
+            }
+        }
+        return null;
+    },
+    ipAddress: (message = "Invalid IP address") => (value) => {
+        if (value) {
+            const parts = value.split(".");
+            if (parts.length !== 4)
+                return message;
+            for (const part of parts) {
+                const num = parseInt(part, 10);
+                if (isNaN(num) || num < 0 || num > 255)
+                    return message;
+            }
+        }
+        return null;
+    },
+    port: (message = "Invalid port number") => (value) => {
+        if (value < 1 || value > 65535) {
+            return message;
+        }
+        return null;
+    },
+    range: (min, max, message) => (value) => {
+        if (value < min || value > max) {
+            return message || `Value must be between ${min} and ${max}`;
+        }
+        return null;
+    },
+    pattern: (pattern, message = "Invalid format") => (value) => {
+        if (value && !pattern.test(value)) {
+            return message;
+        }
+        return null;
+    },
+    minLength: (min, message) => (value) => {
+        if (value && value.length < min) {
+            return message || `Must be at least ${min} characters`;
+        }
+        return null;
+    },
+    maxLength: (max, message) => (value) => {
+        if (value && value.length > max) {
+            return message || `Must be at most ${max} characters`;
+        }
+        return null;
+    },
+};
+/**
+ * Helper to create a settings schema
+ */
+export function createSettingsSchema(schema) {
+    // Sort categories by order
+    schema.categories.sort((a, b) => (a.order || 0) - (b.order || 0));
+    return schema;
+}
+/**
+ * Get setting by key from categories
+ */
+export function getSettingByKey(categories, key) {
+    for (const category of categories) {
+        const setting = category.settings.find((s) => s.key === key);
+        if (setting)
+            return setting;
+    }
+    return undefined;
+}
+/**
+ * Validate a single setting
+ */
+export function validateSetting(setting, value) {
+    // Check required
+    if (setting.required &&
+        (!value || (typeof value === "string" && !value.trim()))) {
+        return setting.validationMessage || "This field is required";
+    }
+    // Type-specific validation
+    switch (setting.type) {
+        case "string":
+        case "password":
+        case "textarea":
+            if (value && typeof value !== "string") {
+                return setting.validationMessage || "Must be a string";
+            }
+            if (setting.validation) {
+                if (setting.validation.minLength !== undefined &&
+                    value.length < setting.validation.minLength) {
+                    return (setting.validationMessage ||
+                        `Must be at least ${setting.validation.minLength} characters`);
+                }
+                if (setting.validation.maxLength !== undefined &&
+                    value.length > setting.validation.maxLength) {
+                    return (setting.validationMessage ||
+                        `Must be at most ${setting.validation.maxLength} characters`);
+                }
+                if (setting.validation.pattern &&
+                    !new RegExp(setting.validation.pattern).test(value)) {
+                    return setting.validationMessage || "Invalid format";
+                }
+            }
+            break;
+        case "email":
+            if (value && !/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(value)) {
+                return setting.validationMessage || "Invalid email address";
+            }
+            break;
+        case "url":
+            try {
+                if (value)
+                    new URL(value);
+            }
+            catch {
+                return setting.validationMessage || "Invalid URL";
+            }
+            break;
+        case "ipaddress":
+            if (value) {
+                const parts = value.split(".");
+                if (parts.length !== 4) {
+                    return setting.validationMessage || "Invalid IP address";
+                }
+                for (const part of parts) {
+                    const num = parseInt(part, 10);
+                    if (isNaN(num) || num < 0 || num > 255) {
+                        return setting.validationMessage || "Invalid IP address";
+                    }
+                }
+            }
+            break;
+        case "number":
+            if (typeof value !== "number" || isNaN(value)) {
+                return setting.validationMessage || "Must be a valid number";
+            }
+            if (setting.validation) {
+                if (setting.validation.min !== undefined &&
+                    value < setting.validation.min) {
+                    return (setting.validationMessage ||
+                        `Must be at least ${setting.validation.min}`);
+                }
+                if (setting.validation.max !== undefined &&
+                    value > setting.validation.max) {
+                    return (setting.validationMessage ||
+                        `Must be at most ${setting.validation.max}`);
+                }
+            }
+            // Also check min/max at root level for backward compatibility
+            if (setting.min !== undefined && value < setting.min) {
+                return setting.validationMessage || `Must be at least ${setting.min}`;
+            }
+            if (setting.max !== undefined && value > setting.max) {
+                return setting.validationMessage || `Must be at most ${setting.max}`;
+            }
+            break;
+        case "boolean":
+            if (typeof value !== "boolean") {
+                return setting.validationMessage || "Must be true or false";
+            }
+            break;
+        case "select":
+        case "multiselect":
+            if (setting.options) {
+                if (setting.type === "select" &&
+                    !setting.options.some((opt) => opt.value === value)) {
+                    return setting.validationMessage || "Must select a valid option";
+                }
+                if (setting.type === "multiselect" && Array.isArray(value)) {
+                    const validValues = setting.options.map((opt) => opt.value);
+                    if (!value.every((v) => validValues.includes(v))) {
+                        return setting.validationMessage || "Invalid selection";
+                    }
+                }
+            }
+            break;
+        case "date":
+        case "time":
+        case "datetime":
+            if (value && !Date.parse(value)) {
+                return setting.validationMessage || "Invalid date/time";
+            }
+            break;
+        case "color":
+            if (value && !/^#[0-9A-Fa-f]{6}$/.test(value)) {
+                return (setting.validationMessage || "Invalid color (must be hex format)");
+            }
+            break;
+    }
+    // Custom validation
+    if (setting.validation?.custom) {
+        const error = setting.validation.custom(value);
+        if (error)
+            return error;
+    }
+    return null;
+}
+/**
+ * Validate all settings against schema
+ */
+export function validateSettings(schema, settings) {
+    const errors = {};
+    for (const category of schema.categories) {
+        for (const setting of category.settings) {
+            if (setting.hidden)
+                continue;
+            const value = settings[setting.key];
+            const error = validateSetting(setting, value);
+            if (error) {
+                errors[setting.key] = error;
+            }
+        }
+    }
+    // Run custom validation
+    if (schema.onValidate) {
+        const customErrors = schema.onValidate(settings);
+        if (customErrors) {
+            Object.assign(errors, customErrors);
+        }
+    }
+    return errors;
+}
+/**
+ * Validate all settings (returns result object)
+ */
+export function validateAllSettings(categories, values) {
+    const errors = {};
+    for (const category of categories) {
+        for (const setting of category.settings) {
+            if (setting.hidden)
+                continue;
+            const value = values[setting.key];
+            const error = validateSetting(setting, value);
+            if (error) {
+                errors[setting.key] = error;
+            }
+        }
+    }
+    return {
+        isValid: Object.keys(errors).length === 0,
+        errors,
+    };
+}
+/**
+ * Helper to flatten nested settings for storage
+ */
+export function flattenSettings(settings, prefix = "") {
+    const flattened = {};
+    for (const [key, value] of Object.entries(settings)) {
+        const fullKey = prefix ? `${prefix}.${key}` : key;
+        if (value &&
+            typeof value === "object" &&
+            !Array.isArray(value) &&
+            !(value instanceof Date)) {
+            Object.assign(flattened, flattenSettings(value, fullKey));
+        }
+        else {
+            flattened[fullKey] = value;
+        }
+    }
+    return flattened;
+}
+// Alias for consistency
+export const flattenSettingsValues = flattenSettings;
+/**
+ * Helper to unflatten settings from storage
+ */
+export function unflattenSettings(flattened) {
+    const settings = {};
+    for (const [key, value] of Object.entries(flattened)) {
+        const parts = key.split(".");
+        let current = settings;
+        for (let i = 0; i < parts.length - 1; i++) {
+            const part = parts[i];
+            if (!part)
+                continue;
+            if (!current[part]) {
+                current[part] = {};
+            }
+            current = current[part];
+        }
+        const lastPart = parts[parts.length - 1];
+        if (lastPart) {
+            current[lastPart] = value;
+        }
+    }
+    return settings;
+}
+// Alias for consistency
+export const unflattenSettingsValues = unflattenSettings;
+/**
+ * Get all settings that require restart
+ */
+export function getRestartRequiredSettings(schema, changedSettings) {
+    const restartRequired = [];
+    // Handle both schema and categories array
+    const categories = Array.isArray(schema) ? schema : schema.categories;
+    // Handle both changed settings object and array of keys
+    const changedKeys = Array.isArray(changedSettings)
+        ? changedSettings
+        : Object.keys(changedSettings);
+    for (const category of categories) {
+        for (const setting of category.settings) {
+            if (setting.requiresRestart && changedKeys.includes(setting.key)) {
+                restartRequired.push(setting.key);
+            }
+        }
+    }
+    return restartRequired;
+}
+/**
+ * Get default values from settings
+ */
+export function getDefaultSettingsValues(categories) {
+    const defaults = {};
+    for (const category of categories) {
+        for (const setting of category.settings) {
+            if (!setting.hidden && setting.defaultValue !== undefined) {
+                defaults[setting.key] = setting.defaultValue;
+            }
+        }
+    }
+    return defaults;
+}
+/**
+ * Evaluate conditional visibility for a field
+ */
+export function evaluateFieldVisibility(field, currentValues) {
+    if (!field.showIf) {
+        return true;
+    }
+    try {
+        return field.showIf(currentValues);
+    }
+    catch (_error) {
+        console.error(`Error evaluating showIf for field ${field.key}:`, _error);
+        return true; // Show field if evaluation fails
+    }
+}
+/**
+ * Group fields by their group property
+ */
+export function groupFields(fields) {
+    const groups = new Map();
+    // First, add ungrouped fields
+    const ungrouped = fields.filter((f) => !f.group);
+    if (ungrouped.length > 0) {
+        groups.set("_default", ungrouped);
+    }
+    // Then, group the rest
+    fields
+        .filter((f) => f.group)
+        .forEach((field) => {
+        const group = field.group;
+        if (!groups.has(group)) {
+            groups.set(group, []);
+        }
+        groups.get(group).push(field);
+    });
+    // Sort fields within each group by order
+    groups.forEach((groupFields) => {
+        groupFields.sort((a, b) => (a.order || 999) - (b.order || 999));
+    });
+    return groups;
+}
+/**
+ * Apply toStorage transform
+ */
+export function applyToStorageTransform(field, value) {
+    if (field.transform?.toStorage) {
+        return field.transform.toStorage(value);
+    }
+    return value;
+}
+/**
+ * Apply fromStorage transform
+ */
+export function applyFromStorageTransform(field, value) {
+    if (field.transform?.fromStorage) {
+        return field.transform.fromStorage(value);
+    }
+    return value;
+}
+/**
+ * Create settings form state
+ */
+export function createSettingsFormState(categories, initialValues) {
+    const defaults = getDefaultSettingsValues(categories);
+    const values = { ...defaults, ...initialValues };
+    const validation = validateAllSettings(categories, values);
+    return {
+        values,
+        errors: validation.errors,
+        touched: {},
+        dirty: {},
+        isValid: validation.isValid,
+        isSubmitting: false,
+    };
+}
+//# sourceMappingURL=SettingsSchema.js.map

package/dist/settings/SettingsSchema.js.map

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

package/dist/testing/TestServer.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Test Server Utility
+ * Provides standardized test server management for all SuperDangerous applications
+ */
+export interface TestServerConfig {
+    /** Path to the application entry point */
+    entryPoint: string;
+    /** Port to run the server on */
+    port: number;
+    /** API base URL */
+    apiBase?: string;
+    /** Environment variables */
+    env?: Record<string, string>;
+    /** Timeout for server startup (ms) */
+    startupTimeout?: number;
+    /** Health check endpoint */
+    healthEndpoint?: string;
+    /** Whether to suppress server output */
+    silent?: boolean;
+}
+export declare class TestServer {
+    private process;
+    private config;
+    private startPromise;
+    port: number;
+    constructor(config: TestServerConfig);
+    /**
+     * Clean up any existing processes on the port
+     */
+    private cleanupPort;
+    /**
+     * Wait for the server to be ready
+     */
+    private waitForServer;
+    /**
+     * Start the test server
+     */
+    start(): Promise<void>;
+    private _start;
+    /**
+     * Stop the test server
+     */
+    stop(): Promise<void>;
+    /**
+     * Get the API base URL
+     */
+    getApiBase(): string;
+    /**
+     * Make a request to the test server
+     */
+    request(endpoint: string, options?: any): Promise<any>;
+}
+/**
+ * Create a test server instance
+ */
+export declare function createTestServer(config: TestServerConfig): TestServer;
+/**
+ * Setup function for Jest beforeAll
+ */
+export declare function setupTestServer(config: TestServerConfig): Promise<void>;
+/**
+ * Teardown function for Jest afterAll
+ */
+export declare function teardownTestServer(): Promise<void>;
+/**
+ * Get the global test server instance
+ */
+export declare function getTestServer(): TestServer | null;
+//# sourceMappingURL=TestServer.d.ts.map

package/dist/testing/TestServer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TestServer.d.ts","sourceRoot":"","sources":["../../src/testing/TestServer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAeH,MAAM,WAAW,gBAAgB;IAC/B,0CAA0C;IAC1C,UAAU,EAAE,MAAM,CAAC;IACnB,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,mBAAmB;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4BAA4B;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,sCAAsC;IACtC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,4BAA4B;IAC5B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,wCAAwC;IACxC,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,MAAM,CAA6B;IAC3C,OAAO,CAAC,YAAY,CAA8B;IAC3C,IAAI,EAAE,MAAM,CAAC;gBAER,MAAM,EAAE,gBAAgB;IAYpC;;OAEG;IACH,OAAO,CAAC,WAAW;IA+BnB;;OAEG;YACW,aAAa;IA2C3B;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAed,MAAM;IAkDpB;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAmC3B;;OAEG;IACH,UAAU,IAAI,MAAM;IAIpB;;OAEG;IACG,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,GAAQ,GAAG,OAAO,CAAC,GAAG,CAAC;CAyBjE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,GAAG,UAAU,CAErE;AAOD;;GAEG;AACH,wBAAsB,eAAe,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAG7E;AAED;;GAEG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC,CAKxD;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,UAAU,GAAG,IAAI,CAEjD"}