@superdangerous/app-framework 4.9.0

package/dist/logging/LogCategories.js

@@ -0,0 +1,205 @@
+/**
+ * Log Categories System
+ * Provides a declarative way to define log categories with automatic UI generation
+ */
+export const LogLevels = {
+    error: {
+        name: "error",
+        color: "text-red-600 dark:text-red-400",
+        badge: "bg-red-600 text-white",
+        priority: 0,
+    },
+    warn: {
+        name: "warn",
+        color: "text-amber-600 dark:text-amber-400",
+        badge: "bg-amber-500 text-white",
+        priority: 1,
+    },
+    info: {
+        name: "info",
+        color: "text-blue-600 dark:text-blue-400",
+        badge: "bg-blue-600 text-white",
+        priority: 2,
+    },
+    debug: {
+        name: "debug",
+        color: "text-gray-600 dark:text-gray-400",
+        badge: "bg-gray-600 text-white",
+        priority: 3,
+    },
+    verbose: {
+        name: "verbose",
+        color: "text-gray-500 dark:text-gray-500",
+        badge: "bg-gray-500 text-white",
+        priority: 4,
+    },
+};
+/**
+ * Default log viewer configuration
+ */
+export const defaultLogViewerConfig = {
+    categories: [
+        {
+            id: "system",
+            label: "System",
+            description: "Core system operations",
+            enabled: true,
+        },
+        {
+            id: "api",
+            label: "API",
+            description: "API requests and responses",
+            enabled: true,
+        },
+        {
+            id: "auth",
+            label: "Authentication",
+            description: "Authentication and authorization",
+            enabled: true,
+        },
+        {
+            id: "database",
+            label: "Database",
+            description: "Database operations",
+            enabled: true,
+        },
+        {
+            id: "service",
+            label: "Services",
+            description: "Background services",
+            enabled: true,
+        },
+    ],
+    defaultLevel: "info",
+    maxLogEntries: 1000,
+    enableRealtime: true,
+    enableExport: true,
+    enableArchives: true,
+    archiveRetentionDays: 7,
+    horizontalScroll: true,
+    timestampFormat: "YYYY-MM-DD HH:mm:ss.SSS",
+    showCategories: true,
+    showMetadata: true,
+    theme: "system",
+};
+/**
+ * Helper to parse log entries from different formats
+ */
+export function parseLogEntry(raw) {
+    try {
+        if (typeof raw === "string") {
+            // Try to parse JSON log format
+            if (raw.trim().startsWith("{")) {
+                return JSON.parse(raw);
+            }
+            // Parse text log format: "2023-10-20 10:30:45.123 [INFO] [Category] Message"
+            const match = raw.match(/^(\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2}\.\d{3})\s+\[(\w+)\]\s+(?:\[([^\]]+)\]\s+)?(.*)$/);
+            if (match) {
+                const [, timestamp, level, category, message] = match;
+                return {
+                    id: `${Date.now()}-${Math.random()}`,
+                    timestamp: timestamp || "",
+                    level: (level?.toLowerCase() || "info"),
+                    category: category || "",
+                    message: message || "",
+                };
+            }
+        }
+        else if (typeof raw === "object") {
+            return raw;
+        }
+    }
+    catch (_error) {
+        console.error("Failed to parse log entry:", _error);
+    }
+    return null;
+}
+/**
+ * Helper to format log entries for display
+ */
+export function formatLogEntry(entry, format = "full") {
+    if (format === "compact") {
+        return `${entry.timestamp} [${entry.level.toUpperCase()}] ${entry.message}`;
+    }
+    let formatted = `${entry.timestamp} [${entry.level.toUpperCase()}]`;
+    if (entry.category) {
+        formatted += ` [${entry.category}]`;
+    }
+    formatted += ` ${entry.message}`;
+    if (entry.metadata && Object.keys(entry.metadata).length > 0) {
+        formatted += "\n  Metadata: " + JSON.stringify(entry.metadata, null, 2);
+    }
+    if (entry.stack) {
+        formatted += "\n  Stack: " + entry.stack;
+    }
+    return formatted;
+}
+/**
+ * Calculate log statistics
+ */
+export function calculateLogStats(entries) {
+    const stats = {
+        total: entries.length,
+        byLevel: {},
+        byCategory: {},
+        errorRate: 0,
+        warnRate: 0,
+    };
+    for (const entry of entries) {
+        // Count by level
+        stats.byLevel[entry.level] = (stats.byLevel[entry.level] || 0) + 1;
+        // Count by category
+        if (entry.category) {
+            stats.byCategory[entry.category] =
+                (stats.byCategory[entry.category] || 0) + 1;
+        }
+    }
+    // Calculate rates
+    if (stats.total > 0) {
+        stats.errorRate = (stats.byLevel.error || 0) / stats.total;
+        stats.warnRate = (stats.byLevel.warn || 0) / stats.total;
+    }
+    return stats;
+}
+/**
+ * Filter log entries
+ */
+export function filterLogEntries(entries, filter) {
+    return entries.filter((entry) => {
+        // Filter by level
+        if (filter.levels &&
+            filter.levels.length > 0 &&
+            !filter.levels.includes(entry.level)) {
+            return false;
+        }
+        // Filter by category
+        if (filter.categories &&
+            filter.categories.length > 0 &&
+            entry.category &&
+            !filter.categories.includes(entry.category)) {
+            return false;
+        }
+        // Filter by search term
+        if (filter.search) {
+            const searchLower = filter.search.toLowerCase();
+            const inMessage = entry.message.toLowerCase().includes(searchLower);
+            const inCategory = entry.category?.toLowerCase().includes(searchLower);
+            const inMetadata = entry.metadata
+                ? JSON.stringify(entry.metadata).toLowerCase().includes(searchLower)
+                : false;
+            if (!inMessage && !inCategory && !inMetadata) {
+                return false;
+            }
+        }
+        // Filter by date range
+        const entryDate = new Date(entry.timestamp);
+        if (filter.startDate && entryDate < filter.startDate) {
+            return false;
+        }
+        if (filter.endDate && entryDate > filter.endDate) {
+            return false;
+        }
+        return true;
+    });
+}
+//# sourceMappingURL=LogCategories.js.map

package/dist/logging/LogCategories.js.map

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

package/dist/middleware/aiErrorHandler.d.ts

@@ -0,0 +1,31 @@
+/**
+ * AI Error Handler Middleware
+ * Provides user-friendly error messages for AI API errors
+ */
+import { Request, Response, NextFunction } from "express";
+import { ApiResponse } from "../types/index.js";
+import { AIError } from "../services/aiService.js";
+/**
+ * AI-specific error handler middleware
+ */
+export declare function aiErrorHandler(err: any, _req: Request, res: Response<ApiResponse<any>>, next: NextFunction): void;
+/**
+ * Rate limit handler for AI endpoints
+ */
+export declare function aiRateLimitHandler(_req: Request, res: Response<ApiResponse<any>>): void;
+/**
+ * Create AI error with user-friendly message
+ */
+export declare function createAIError(message: string, userMessage: string, status?: number, details?: string[], action?: string): AIError;
+/**
+ * Wrap async AI handlers with error handling
+ */
+export declare function wrapAIHandler(handler: (req: Request, res: Response, next: NextFunction) => Promise<void>): (req: Request, res: Response, next: NextFunction) => Promise<void>;
+declare const _default: {
+    aiErrorHandler: typeof aiErrorHandler;
+    aiRateLimitHandler: typeof aiRateLimitHandler;
+    createAIError: typeof createAIError;
+    wrapAIHandler: typeof wrapAIHandler;
+};
+export default _default;
+//# sourceMappingURL=aiErrorHandler.d.ts.map

package/dist/middleware/aiErrorHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aiErrorHandler.d.ts","sourceRoot":"","sources":["../../src/middleware/aiErrorHandler.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE1D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AAmBnD;;GAEG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,GAAG,EACR,IAAI,EAAE,OAAO,EACb,GAAG,EAAE,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,EAC/B,IAAI,EAAE,YAAY,GACjB,IAAI,CAkLN;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,OAAO,EACb,GAAG,EAAE,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,GAC9B,IAAI,CAMN;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,MAAM,GAAE,MAAY,EACpB,OAAO,CAAC,EAAE,MAAM,EAAE,EAClB,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAOT;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,KAAK,OAAO,CAAC,IAAI,CAAC,IAE7D,KAAK,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,YAAY,mBAgB9D;;;;;;;AAED,wBAKE"}

package/dist/middleware/aiErrorHandler.js

@@ -0,0 +1,181 @@
+/**
+ * AI Error Handler Middleware
+ * Provides user-friendly error messages for AI API errors
+ */
+import { createLogger } from "../core/index.js";
+import { sendError, sendUnauthorized } from "../core/apiResponse.js";
+import { AIError } from "../services/aiService.js";
+let logger; // Will be initialized when needed
+function ensureLogger() {
+    if (!logger) {
+        logger = createLogger("AIError");
+    }
+    return logger;
+}
+/**
+ * AI-specific error handler middleware
+ */
+export function aiErrorHandler(err, _req, res, next) {
+    // Only handle AI-related errors
+    if (!_req.path.startsWith("/api/ai/")) {
+        return next(err);
+    }
+    ensureLogger().error("AI Error:", {
+        path: _req.path,
+        method: _req.method,
+        error: err.message,
+        status: err.statusCode || err.status,
+        stack: err.stack,
+        errorType: err.errorType,
+        provider: err.provider,
+    });
+    // Handle our custom AIError instances
+    if (err instanceof AIError) {
+        const response = {
+            error: err.message,
+            code: err.errorType,
+        };
+        // Add provider-specific information
+        if (err.provider) {
+            response.details = [`Provider: ${err.provider}`];
+        }
+        // Handle specific error types
+        switch (err.errorType) {
+            case "AUTH_ERROR":
+                sendUnauthorized(res, err.message);
+                return;
+            case "RATE_LIMIT":
+                sendError(res, err.message, 429, { retryAfter: 60 });
+                return;
+            case "SERVICE_UNAVAILABLE":
+                sendError(res, err.message, 503);
+                return;
+            case "TIMEOUT":
+                sendError(res, err.message, 408);
+                return;
+            default:
+                sendError(res, err.message, err.statusCode, response);
+                return;
+        }
+    }
+    // Handle legacy structured AI errors with user-friendly messages
+    if (err.userMessage) {
+        const response = {
+            error: err.userMessage,
+        };
+        if (err.details) {
+            response.details = err.details;
+        }
+        if (err.actionRequired) {
+            response.action = err.actionRequired;
+        }
+        if (err.code) {
+            response.code = err.code;
+        }
+        sendError(res, err.userMessage, err.status || 500, {
+            details: err.details,
+            action: err.actionRequired,
+            code: err.code,
+        });
+        return;
+    }
+    // Handle OpenAI specific errors
+    if (err.message && err.message.includes("401")) {
+        sendUnauthorized(res, "OpenAI API authentication failed: Invalid or missing API key. Check your OpenAI API key configuration");
+        return;
+    }
+    if (err.message && err.message.includes("429")) {
+        sendError(res, "OpenAI API rate limit exceeded: Too many requests. Please wait a moment before trying again", 429);
+        return;
+    }
+    if (err.message && err.message.includes("insufficient_quota")) {
+        sendError(res, "OpenAI API quota exceeded: Your account has insufficient quota. Check your OpenAI account billing and usage limits", 402);
+        return;
+    }
+    // Handle Anthropic specific errors
+    if (err.message && err.message.includes("anthropic")) {
+        if (err.message.includes("401")) {
+            sendUnauthorized(res, "Anthropic API authentication failed: Invalid or missing API key");
+            return;
+        }
+        if (err.message.includes("rate")) {
+            sendError(res, "Anthropic API rate limit exceeded: Too many requests", 429);
+            return;
+        }
+    }
+    // Handle JSON parse errors
+    if (err.message && err.message.includes("JSON")) {
+        sendError(res, "Failed to generate valid template format: The AI response was not in the expected format", 500);
+        return;
+    }
+    // Handle missing required fields
+    if (err.message && err.message.includes("missing required fields")) {
+        sendError(res, "Generated template is incomplete: Missing required fields", 500);
+        return;
+    }
+    // Handle API key errors
+    if (err.message && err.message.includes("API key")) {
+        sendUnauthorized(res, "AI API key not configured: Please configure your API key");
+        return;
+    }
+    // Handle timeout errors
+    if (err.message &&
+        (err.message.includes("timeout") || err.message.includes("ETIMEDOUT"))) {
+        sendError(res, "AI request timed out: The request took too long to complete", 504);
+        return;
+    }
+    // Handle network errors
+    if (err.message &&
+        (err.message.includes("ECONNREFUSED") || err.message.includes("ENOTFOUND"))) {
+        sendError(res, "AI service unavailable: Cannot connect to AI service", 503);
+        return;
+    }
+    // Default error response
+    sendError(res, err.message || "An error occurred while processing your AI request", err.status || 500);
+}
+/**
+ * Rate limit handler for AI endpoints
+ */
+export function aiRateLimitHandler(_req, res) {
+    sendError(res, "Too many AI requests: Rate limit exceeded. Please wait a moment before trying again", 429);
+}
+/**
+ * Create AI error with user-friendly message
+ */
+export function createAIError(message, userMessage, status = 500, details, action) {
+    const error = new AIError(message, status, "CUSTOM_ERROR", "unknown");
+    // Additional legacy properties for compatibility
+    error.userMessage = userMessage;
+    error.details = details;
+    error.actionRequired = action;
+    return error;
+}
+/**
+ * Wrap async AI handlers with error handling
+ */
+export function wrapAIHandler(handler) {
+    return async (req, res, next) => {
+        try {
+            await handler(req, res, next);
+        }
+        catch (_error) {
+            // Convert to AI error if needed
+            if (!_error.userMessage && _error.response?.data) {
+                // Handle API response errors
+                const apiError = _error.response.data;
+                _error.userMessage =
+                    apiError.error?.message || apiError.message || "AI request failed";
+                _error.status = _error.response.status;
+                _error.details = apiError.error?.details || [apiError.error?.type];
+            }
+            next(_error);
+        }
+    };
+}
+export default {
+    aiErrorHandler,
+    aiRateLimitHandler,
+    createAIError,
+    wrapAIHandler,
+};
+//# sourceMappingURL=aiErrorHandler.js.map

package/dist/middleware/aiErrorHandler.js.map

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

package/dist/middleware/auth.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Authentication Middleware
+ * Generic authentication utilities for Express applications
+ */
+import { Request, Response, NextFunction } from "express";
+declare global {
+    namespace Express {
+        interface Request {
+            user?: {
+                id: string;
+                username: string;
+                roles?: string[];
+            };
+        }
+    }
+}
+declare module "express-session" {
+    interface SessionData {
+        authenticated?: boolean;
+        username?: string;
+        userId?: string;
+        roles?: string[];
+    }
+}
+export interface AuthConfig {
+    loginPath?: string;
+    apiPrefix?: string;
+    excludePaths?: string[];
+    onUnauthorized?: (req: Request, res: Response) => void;
+}
+/**
+ * Creates authentication middleware with configuration
+ */
+export declare function createAuthMiddleware(config?: AuthConfig): (req: Request, res: Response, next: NextFunction) => void;
+/**
+ * Login handler factory
+ */
+export interface LoginCredentials {
+    username: string;
+    password: string;
+}
+export interface AuthService {
+    validateCredentials: (credentials: LoginCredentials) => Promise<{
+        valid: boolean;
+        user?: {
+            id: string;
+            username: string;
+            roles?: string[];
+        };
+        error?: string;
+    }>;
+}
+export declare function createLoginHandler(authService: AuthService): (req: Request, res: Response) => Promise<void>;
+/**
+ * Logout handler factory
+ */
+export declare function createLogoutHandler(): (req: Request, res: Response) => void;
+/**
+ * Auth check handler
+ */
+export declare function createAuthCheckHandler(): (req: Request, res: Response) => void;
+/**
+ * Role-based access control middleware
+ */
+export declare function requireRole(roles: string | string[]): (req: Request, res: Response, next: NextFunction) => void;
+/**
+ * Simple in-memory auth service for development
+ */
+export declare class SimpleAuthService implements AuthService {
+    private users;
+    constructor(users?: Array<{
+        username: string;
+        password: string;
+        id?: string;
+        roles?: string[];
+    }>);
+    validateCredentials(credentials: LoginCredentials): Promise<{
+        valid: boolean;
+        error: string;
+        user?: undefined;
+    } | {
+        valid: boolean;
+        user: {
+            id: string;
+            username: string;
+            roles: string[] | undefined;
+        };
+        error?: undefined;
+    }>;
+    addUser(username: string, password: string, roles?: string[]): void;
+}
+declare const _default: {
+    createAuthMiddleware: typeof createAuthMiddleware;
+    createLoginHandler: typeof createLoginHandler;
+    createLogoutHandler: typeof createLogoutHandler;
+    createAuthCheckHandler: typeof createAuthCheckHandler;
+    requireRole: typeof requireRole;
+    SimpleAuthService: typeof SimpleAuthService;
+};
+export default _default;
+//# sourceMappingURL=auth.d.ts.map

package/dist/middleware/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/middleware/auth.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAa1D,OAAO,CAAC,MAAM,CAAC;IAEb,UAAU,OAAO,CAAC;QAChB,UAAU,OAAO;YACf,IAAI,CAAC,EAAE;gBACL,EAAE,EAAE,MAAM,CAAC;gBACX,QAAQ,EAAE,MAAM,CAAC;gBACjB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;aAClB,CAAC;SACH;KACF;CACF;AAGD,OAAO,QAAQ,iBAAiB,CAAC;IAC/B,UAAU,WAAW;QACnB,aAAa,CAAC,EAAE,OAAO,CAAC;QACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;KAClB;CACF;AAED,MAAM,WAAW,UAAU;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,cAAc,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,KAAK,IAAI,CAAC;CACxD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,GAAE,UAAe,IASxD,KAAK,OAAO,EACZ,KAAK,QAAQ,EACb,MAAM,YAAY,KACjB,IAAI,CAmCR;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,mBAAmB,EAAE,CAAC,WAAW,EAAE,gBAAgB,KAAK,OAAO,CAAC;QAC9D,KAAK,EAAE,OAAO,CAAC;QACf,IAAI,CAAC,EAAE;YACL,EAAE,EAAE,MAAM,CAAC;YACX,QAAQ,EAAE,MAAM,CAAC;YACjB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;SAClB,CAAC;QACF,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC,CAAC;CACJ;AAED,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,WAAW,IAC3C,KAAK,OAAO,EAAE,KAAK,QAAQ,KAAG,OAAO,CAAC,IAAI,CAAC,CAmD1D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,KACzB,KAAK,OAAO,EAAE,KAAK,QAAQ,KAAG,IAAI,CAoB3C;AAED;;GAEG;AACH,wBAAgB,sBAAsB,KAC5B,KAAK,OAAO,EAAE,KAAK,QAAQ,KAAG,IAAI,CAe3C;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,IAG1C,KAAK,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,YAAY,KAAG,IAAI,CAuB/D;AAED;;GAEG;AACH,qBAAa,iBAAkB,YAAW,WAAW;IACnD,OAAO,CAAC,KAAK,CAGX;gBAGA,KAAK,GAAE,KAAK,CAAC;QACX,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;KAClB,CAAM;IAyBH,mBAAmB,CAAC,WAAW,EAAE,gBAAgB;;;;;;;;;;;;;IAoBvD,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE;CAO7D;;;;;;;;;AAED,wBAOE"}