@bloomneo/appkit 1.2.9

package/dist/email/strategies/smtp.js

@@ -0,0 +1,286 @@
+/**
+ * SMTP email strategy with nodemailer and connection pooling
+ * @module @bloomneo/appkit/email
+ * @file src/email/strategies/smtp.ts
+ *
+ * @llm-rule WHEN: App has SMTP_HOST environment variable for universal email sending
+ * @llm-rule AVOID: Manual SMTP setup - this handles connection pooling, authentication, and reliability
+ * @llm-rule NOTE: Universal email strategy that works with any SMTP server (Gmail, Outlook, etc.)
+ */
+/**
+ * SMTP email strategy with connection pooling and reliability features
+ */
+export class SmtpStrategy {
+    config;
+    transporter = null;
+    connected = false;
+    /**
+     * Creates SMTP strategy with direct environment access (like auth pattern)
+     * @llm-rule WHEN: Email initialization with SMTP_HOST detected
+     * @llm-rule AVOID: Manual SMTP configuration - environment detection handles this
+     */
+    constructor(config) {
+        this.config = config;
+    }
+    /**
+     * Sends email via SMTP with automatic connection management
+     * @llm-rule WHEN: Sending emails through SMTP servers
+     * @llm-rule AVOID: Manual SMTP calls - this handles all connection complexity
+     * @llm-rule NOTE: Includes connection pooling, authentication, and error handling
+     */
+    async send(data) {
+        try {
+            // Ensure transporter is connected
+            await this.ensureConnected();
+            // Convert to nodemailer format
+            const mailOptions = this.convertToSmtpFormat(data);
+            // Send via SMTP
+            const result = await this.transporter.sendMail(mailOptions);
+            return {
+                success: true,
+                messageId: result.messageId,
+            };
+        }
+        catch (error) {
+            const errorMessage = this.parseSmtpError(error);
+            if (this.config.environment.isDevelopment) {
+                console.error(`[AppKit] SMTP error:`, errorMessage);
+            }
+            return {
+                success: false,
+                error: errorMessage,
+            };
+        }
+    }
+    /**
+     * Disconnects SMTP strategy gracefully
+     * @llm-rule WHEN: App shutdown or email cleanup
+     * @llm-rule AVOID: Abrupt disconnection - graceful shutdown prevents connection issues
+     */
+    async disconnect() {
+        if (!this.connected || !this.transporter)
+            return;
+        try {
+            await this.transporter.close();
+            this.connected = false;
+            this.transporter = null;
+            if (this.config.environment.isDevelopment) {
+                console.log(`👋 [AppKit] SMTP disconnected`);
+            }
+        }
+        catch (error) {
+            console.error(`⚠️ [AppKit] SMTP disconnect error:`, error.message);
+        }
+    }
+    // Private helper methods
+    /**
+     * Ensures SMTP transporter is connected
+     */
+    async ensureConnected() {
+        if (this.connected && this.transporter)
+            return;
+        try {
+            // Dynamic import for nodemailer
+            const nodemailer = await import('nodemailer');
+            const smtpConfig = this.config.smtp;
+            // Create transporter with connection pooling
+            this.transporter = nodemailer.createTransport({
+                host: smtpConfig.host,
+                port: smtpConfig.port,
+                secure: smtpConfig.secure,
+                auth: smtpConfig.auth.user && smtpConfig.auth.pass ? {
+                    user: smtpConfig.auth.user,
+                    pass: smtpConfig.auth.pass,
+                } : undefined,
+                pool: smtpConfig.pool,
+                maxConnections: 5,
+                maxMessages: 100,
+                rateDelta: 1000,
+                rateLimit: 10,
+                connectionTimeout: smtpConfig.timeout,
+                socketTimeout: smtpConfig.timeout,
+                // Security options
+                tls: {
+                    rejectUnauthorized: this.config.environment.isProduction,
+                },
+            });
+            // Verify connection
+            await this.transporter.verify();
+            this.connected = true;
+            if (this.config.environment.isDevelopment) {
+                console.log(`✅ [AppKit] SMTP connected to ${smtpConfig.host}:${smtpConfig.port}`);
+            }
+        }
+        catch (error) {
+            this.connected = false;
+            this.transporter = null;
+            throw new Error(`SMTP connection failed: ${error.message}`);
+        }
+    }
+    /**
+     * Converts EmailData to nodemailer format
+     */
+    convertToSmtpFormat(data) {
+        const mailOptions = {
+            from: this.formatEmailAddress(data.from),
+            to: this.formatEmailAddresses(data.to),
+            subject: data.subject,
+        };
+        // Add content
+        if (data.html) {
+            mailOptions.html = data.html;
+        }
+        if (data.text) {
+            mailOptions.text = data.text;
+        }
+        // Add optional fields
+        if (data.replyTo) {
+            mailOptions.replyTo = this.formatEmailAddress(data.replyTo);
+        }
+        if (data.cc) {
+            mailOptions.cc = this.formatEmailAddresses(data.cc);
+        }
+        if (data.bcc) {
+            mailOptions.bcc = this.formatEmailAddresses(data.bcc);
+        }
+        // Add attachments
+        if (data.attachments && data.attachments.length > 0) {
+            mailOptions.attachments = this.formatAttachments(data.attachments);
+        }
+        return mailOptions;
+    }
+    /**
+     * Formats single email address for nodemailer
+     */
+    formatEmailAddress(address) {
+        if (typeof address === 'string') {
+            return address;
+        }
+        if (address.name) {
+            return `"${address.name}" <${address.email}>`;
+        }
+        return address.email;
+    }
+    /**
+     * Formats multiple email addresses for nodemailer
+     */
+    formatEmailAddresses(addresses) {
+        const addressArray = Array.isArray(addresses) ? addresses : [addresses];
+        return addressArray.map(addr => this.formatEmailAddress(addr)).join(', ');
+    }
+    /**
+     * Formats attachments for nodemailer
+     */
+    formatAttachments(attachments) {
+        return attachments.map(attachment => ({
+            filename: attachment.filename,
+            content: attachment.content,
+            contentType: attachment.contentType || this.guessContentType(attachment.filename),
+        }));
+    }
+    /**
+     * Guesses content type from filename
+     */
+    guessContentType(filename) {
+        const ext = filename.split('.').pop()?.toLowerCase();
+        const mimeTypes = {
+            pdf: 'application/pdf',
+            doc: 'application/msword',
+            docx: 'application/vnd.openxmlformats-officedocument.wordprocessingml.document',
+            xls: 'application/vnd.ms-excel',
+            xlsx: 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',
+            png: 'image/png',
+            jpg: 'image/jpeg',
+            jpeg: 'image/jpeg',
+            gif: 'image/gif',
+            txt: 'text/plain',
+            html: 'text/html',
+            css: 'text/css',
+            js: 'application/javascript',
+            json: 'application/json',
+            zip: 'application/zip',
+        };
+        return mimeTypes[ext || ''] || 'application/octet-stream';
+    }
+    /**
+     * Parses SMTP errors into user-friendly messages
+     */
+    parseSmtpError(error) {
+        if (error.message) {
+            const message = error.message.toLowerCase();
+            // Authentication errors
+            if (message.includes('authentication') || message.includes('invalid credentials') ||
+                message.includes('username') || message.includes('password')) {
+                return 'SMTP authentication failed. Check SMTP_USER and SMTP_PASS environment variables.';
+            }
+            // Connection errors
+            if (message.includes('connection') || message.includes('connect') ||
+                message.includes('econnrefused') || message.includes('timeout')) {
+                return 'SMTP connection failed. Check SMTP_HOST and SMTP_PORT environment variables.';
+            }
+            // TLS/SSL errors
+            if (message.includes('tls') || message.includes('ssl') || message.includes('secure')) {
+                return 'SMTP TLS/SSL error. Check SMTP_SECURE environment variable or server settings.';
+            }
+            // Rate limiting
+            if (message.includes('rate') || message.includes('limit') || message.includes('quota')) {
+                return 'SMTP rate limit exceeded. Please try again later.';
+            }
+            // Recipient errors
+            if (message.includes('recipient') || message.includes('address') ||
+                message.includes('mailbox') || message.includes('does not exist')) {
+                return 'Invalid recipient email address or mailbox does not exist.';
+            }
+            // Sender errors
+            if (message.includes('sender') || message.includes('from') ||
+                message.includes('not authorized') || message.includes('relay')) {
+                return 'SMTP sender not authorized. Check FROM address and server relay settings.';
+            }
+            // Message size errors
+            if (message.includes('size') || message.includes('too large') || message.includes('exceeded')) {
+                return 'Email message too large. Reduce attachment size or content length.';
+            }
+            // DNS errors
+            if (message.includes('dns') || message.includes('hostname') || message.includes('resolve')) {
+                return 'DNS resolution failed. Check SMTP_HOST value.';
+            }
+            // Port errors
+            if (message.includes('port') || message.includes('refused') || message.includes('unreachable')) {
+                return 'SMTP port connection failed. Check SMTP_PORT value and firewall settings.';
+            }
+            return error.message;
+        }
+        // Check for specific error codes
+        if (error.code) {
+            switch (error.code) {
+                case 'ECONNREFUSED':
+                    return 'SMTP connection refused. Check SMTP_HOST and SMTP_PORT.';
+                case 'ENOTFOUND':
+                    return 'SMTP host not found. Check SMTP_HOST value.';
+                case 'ETIMEDOUT':
+                    return 'SMTP connection timeout. Check network connectivity.';
+                case 'ECONNRESET':
+                    return 'SMTP connection reset. Server may be overloaded.';
+                case 'ESOCKET':
+                    return 'SMTP socket error. Check network settings.';
+                default:
+                    return `SMTP error: ${error.code}`;
+            }
+        }
+        return 'Unknown SMTP error occurred';
+    }
+    /**
+     * Gets SMTP connection info for debugging
+     */
+    getConnectionInfo() {
+        const smtpConfig = this.config.smtp;
+        return {
+            host: smtpConfig.host,
+            port: smtpConfig.port,
+            secure: smtpConfig.secure,
+            authenticated: !!(smtpConfig.auth.user && smtpConfig.auth.pass),
+            connected: this.connected,
+        };
+    }
+}
+//# sourceMappingURL=smtp.js.map

package/dist/email/strategies/smtp.js.map

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

package/dist/error/defaults.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Smart defaults and environment validation for error handling
+ * @module @bloomneo/appkit/error
+ * @file src/error/defaults.ts
+ *
+ * @llm-rule WHEN: App startup - need to configure error handling behavior and messages
+ * @llm-rule AVOID: Calling multiple times - expensive environment parsing, use lazy loading in get()
+ * @llm-rule NOTE: Called once at startup, cached globally for performance
+ */
+export interface ErrorMessages {
+    badRequest: string;
+    unauthorized: string;
+    forbidden: string;
+    notFound: string;
+    conflict: string;
+    serverError: string;
+}
+export interface MiddlewareConfig {
+    showStack: boolean;
+    logErrors: boolean;
+}
+export interface EnvironmentConfig {
+    isDevelopment: boolean;
+    isProduction: boolean;
+    isTest: boolean;
+    nodeEnv: string;
+}
+export interface ErrorConfig {
+    messages: ErrorMessages;
+    middleware: MiddlewareConfig;
+    environment: EnvironmentConfig;
+}
+/**
+ * Gets smart defaults using VOILA_ERROR_* environment variables
+ * @llm-rule WHEN: App startup to get production-ready error configuration
+ * @llm-rule AVOID: Calling repeatedly - expensive validation, cache the result
+ * @llm-rule NOTE: Automatically configures dev vs production error behavior
+ */
+export declare function getSmartDefaults(): ErrorConfig;
+//# sourceMappingURL=defaults.d.ts.map

package/dist/error/defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../src/error/defaults.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,aAAa,EAAE,OAAO,CAAC;IACvB,YAAY,EAAE,OAAO,CAAC;IACtB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,aAAa,CAAC;IACxB,UAAU,EAAE,gBAAgB,CAAC;IAC7B,WAAW,EAAE,iBAAiB,CAAC;CAChC;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,IAAI,WAAW,CAiC9C"}

package/dist/error/defaults.js

@@ -0,0 +1,75 @@
+/**
+ * Smart defaults and environment validation for error handling
+ * @module @bloomneo/appkit/error
+ * @file src/error/defaults.ts
+ *
+ * @llm-rule WHEN: App startup - need to configure error handling behavior and messages
+ * @llm-rule AVOID: Calling multiple times - expensive environment parsing, use lazy loading in get()
+ * @llm-rule NOTE: Called once at startup, cached globally for performance
+ */
+/**
+ * Gets smart defaults using VOILA_ERROR_* environment variables
+ * @llm-rule WHEN: App startup to get production-ready error configuration
+ * @llm-rule AVOID: Calling repeatedly - expensive validation, cache the result
+ * @llm-rule NOTE: Automatically configures dev vs production error behavior
+ */
+export function getSmartDefaults() {
+    validateEnvironment();
+    const nodeEnv = process.env.NODE_ENV || 'development';
+    const isDevelopment = nodeEnv === 'development';
+    const isProduction = nodeEnv === 'production';
+    const isTest = nodeEnv === 'test';
+    return {
+        // Error message defaults with environment awareness
+        messages: {
+            badRequest: 'Bad Request',
+            unauthorized: process.env.VOILA_AUTH_MESSAGE || 'Authentication required',
+            forbidden: 'Access denied',
+            notFound: 'Not found',
+            conflict: 'Conflict',
+            serverError: isDevelopment ? 'Internal server error' : 'Server error',
+        },
+        // Error handling behavior with smart defaults
+        middleware: {
+            showStack: process.env.VOILA_ERROR_STACK === 'true' || isDevelopment,
+            logErrors: process.env.VOILA_ERROR_LOG !== 'false',
+        },
+        // Environment information
+        environment: {
+            isDevelopment,
+            isProduction,
+            isTest,
+            nodeEnv,
+        },
+    };
+}
+/**
+ * Validates environment variables for error configuration
+ * @llm-rule WHEN: App startup to ensure proper error environment configuration
+ * @llm-rule AVOID: Skipping validation - improper config causes silent failures
+ * @llm-rule NOTE: Validates essential boolean environment variables and NODE_ENV only
+ */
+function validateEnvironment() {
+    // Validate VOILA_ERROR_STACK (essential for security)
+    const errorStack = process.env.VOILA_ERROR_STACK;
+    if (errorStack && !['true', 'false'].includes(errorStack.toLowerCase())) {
+        throw new Error(`Invalid VOILA_ERROR_STACK: "${errorStack}". Must be "true" or "false"`);
+    }
+    // Validate VOILA_ERROR_LOG (essential for debugging)
+    const errorLog = process.env.VOILA_ERROR_LOG;
+    if (errorLog && !['true', 'false'].includes(errorLog.toLowerCase())) {
+        throw new Error(`Invalid VOILA_ERROR_LOG: "${errorLog}". Must be "true" or "false"`);
+    }
+    // Validate NODE_ENV (essential for environment detection)
+    const nodeEnv = process.env.NODE_ENV;
+    if (nodeEnv && !['development', 'production', 'test', 'staging'].includes(nodeEnv)) {
+        console.warn(`[VoilaJSX AppKit] Unusual NODE_ENV: "${nodeEnv}". ` +
+            `Expected: development, production, test, or staging`);
+    }
+    // Essential production safety check
+    if (nodeEnv === 'production' && process.env.VOILA_ERROR_STACK === 'true') {
+        console.warn(`[VoilaJSX AppKit] Security warning: VOILA_ERROR_STACK=true in production. ` +
+            `Stack traces may expose internal application structure. Consider setting to false.`);
+    }
+}
+//# sourceMappingURL=defaults.js.map

package/dist/error/defaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.js","sourceRoot":"","sources":["../../src/error/defaults.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AA6BH;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB;IAC9B,mBAAmB,EAAE,CAAC;IAEtB,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,aAAa,CAAC;IACtD,MAAM,aAAa,GAAG,OAAO,KAAK,aAAa,CAAC;IAChD,MAAM,YAAY,GAAG,OAAO,KAAK,YAAY,CAAC;IAC9C,MAAM,MAAM,GAAG,OAAO,KAAK,MAAM,CAAC;IAElC,OAAO;QACL,oDAAoD;QACpD,QAAQ,EAAE;YACR,UAAU,EAAE,aAAa;YACzB,YAAY,EAAE,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,yBAAyB;YACzE,SAAS,EAAE,eAAe;YAC1B,QAAQ,EAAE,WAAW;YACrB,QAAQ,EAAE,UAAU;YACpB,WAAW,EAAE,aAAa,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,cAAc;SACtE;QAED,8CAA8C;QAC9C,UAAU,EAAE;YACV,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,iBAAiB,KAAK,MAAM,IAAI,aAAa;YACpE,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,eAAe,KAAK,OAAO;SACnD;QAED,0BAA0B;QAC1B,WAAW,EAAE;YACX,aAAa;YACb,YAAY;YACZ,MAAM;YACN,OAAO;SACR;KACF,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,SAAS,mBAAmB;IAC1B,sDAAsD;IACtD,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;IACjD,IAAI,UAAU,IAAI,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;QACxE,MAAM,IAAI,KAAK,CACb,+BAA+B,UAAU,8BAA8B,CACxE,CAAC;IACJ,CAAC;IAED,qDAAqD;IACrD,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;IAC7C,IAAI,QAAQ,IAAI,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;QACpE,MAAM,IAAI,KAAK,CACb,6BAA6B,QAAQ,8BAA8B,CACpE,CAAC;IACJ,CAAC;IAED,0DAA0D;IAC1D,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC;IACrC,IAAI,OAAO,IAAI,CAAC,CAAC,aAAa,EAAE,YAAY,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QACnF,OAAO,CAAC,IAAI,CACV,wCAAwC,OAAO,KAAK;YACpD,qDAAqD,CACtD,CAAC;IACJ,CAAC;IAED,oCAAoC;IACpC,IAAI,OAAO,KAAK,YAAY,IAAI,OAAO,CAAC,GAAG,CAAC,iBAAiB,KAAK,MAAM,EAAE,CAAC;QACzE,OAAO,CAAC,IAAI,CACV,4EAA4E;YAC5E,oFAAoF,CACrF,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/error/error.d.ts

@@ -0,0 +1,140 @@
+/**
+ * Core error class with semantic HTTP status codes and middleware
+ * @module @bloomneo/appkit/error
+ * @file src/error/error.ts
+ *
+ * @llm-rule WHEN: Building apps that need semantic HTTP error handling
+ * @llm-rule AVOID: Using directly - always get instance via errorClass.get()
+ * @llm-rule NOTE: Provides semantic error creation (badRequest, unauthorized) and Express middleware
+ */
+import type { ErrorConfig } from './defaults.js';
+export interface AppError extends Error {
+    statusCode: number;
+    type: string;
+}
+export interface ExpressRequest {
+    [key: string]: any;
+}
+export interface ExpressResponse {
+    status: (code: number) => ExpressResponse;
+    json: (data: any) => void;
+}
+export interface ExpressNextFunction {
+    (error?: any): void;
+}
+export type ExpressErrorHandler = (error: AppError, req: ExpressRequest, res: ExpressResponse, next: ExpressNextFunction) => void;
+export type AsyncRouteHandler = (req: ExpressRequest, res: ExpressResponse, next: ExpressNextFunction) => Promise<any>;
+export interface ErrorHandlerOptions {
+    showStack?: boolean;
+    logErrors?: boolean;
+}
+/**
+ * Error class with semantic HTTP status codes and middleware functionality
+ */
+export declare class ErrorClass {
+    config: ErrorConfig;
+    constructor(config: ErrorConfig);
+    /**
+     * Creates a 400 Bad Request error
+     * @llm-rule WHEN: Client sends invalid input data (missing fields, wrong format)
+     * @llm-rule AVOID: Using for server-side validation errors - use conflict() instead
+     * @llm-rule NOTE: EXAMPLES: missing email, invalid JSON, malformed request body
+     * @llm-rule NOTE: PATTERN: if (!req.body.email) throw error.badRequest('Email required');
+     */
+    badRequest(message?: string): AppError;
+    /**
+     * Creates a 401 Unauthorized error
+     * @llm-rule WHEN: Authentication is required but missing or invalid
+     * @llm-rule AVOID: Using for permission issues - use forbidden() for access control
+     * @llm-rule NOTE: EXAMPLES: missing token, invalid token, expired session
+     * @llm-rule NOTE: PATTERN: if (!token) throw error.unauthorized('Token required');
+     */
+    unauthorized(message?: string): AppError;
+    /**
+     * Creates a 403 Forbidden error
+     * @llm-rule WHEN: User is authenticated but lacks permission for the action
+     * @llm-rule AVOID: Using for authentication issues - use unauthorized() instead
+     * @llm-rule NOTE: EXAMPLES: insufficient role, blocked user, admin-only endpoint
+     * @llm-rule NOTE: PATTERN: if (!user.isAdmin) throw error.forbidden('Admin access required');
+     */
+    forbidden(message?: string): AppError;
+    /**
+     * Creates a 404 Not Found error
+     * @llm-rule WHEN: Requested resource does not exist
+     * @llm-rule AVOID: Using for business logic failures - use conflict() instead
+     * @llm-rule NOTE: EXAMPLES: user not found, post not found, missing file
+     * @llm-rule NOTE: PATTERN: if (!user) throw error.notFound('User not found');
+     */
+    notFound(message?: string): AppError;
+    /**
+     * Creates a 409 Conflict error
+     * @llm-rule WHEN: Business logic conflicts or resource already exists
+     * @llm-rule AVOID: Using for validation errors - use badRequest() for input validation
+     * @llm-rule NOTE: EXAMPLES: email already exists, duplicate username, state conflicts
+     * @llm-rule NOTE: PATTERN: if (existingUser) throw error.conflict('Email already registered');
+     */
+    conflict(message?: string): AppError;
+    /**
+     * Creates a 500 Server Error
+     * @llm-rule WHEN: Internal server failures like database errors, external API failures
+     * @llm-rule AVOID: Using for business logic issues - use appropriate 4xx errors instead
+     * @llm-rule NOTE: EXAMPLES: database connection failure, external API timeout, file system errors
+     * @llm-rule NOTE: PATTERN: catch (dbError) { throw error.serverError('Database unavailable'); }
+     */
+    serverError(message?: string): AppError;
+    /**
+     * Creates a custom error with any status code
+     * @llm-rule WHEN: Need custom HTTP status codes not covered by semantic methods
+     * @llm-rule AVOID: Using for standard HTTP codes - use semantic methods instead
+     * @llm-rule NOTE: EXAMPLES: 429 rate limit, 503 service unavailable, 418 teapot
+     * @llm-rule NOTE: PATTERN: error.createError(429, 'Rate limit exceeded', 'RATE_LIMIT');
+     */
+    createError(statusCode: number, message: string, type?: string): AppError;
+    /**
+     * Creates production-ready Express error handling middleware
+     * @llm-rule WHEN: Setting up Express app error handling - use as last middleware
+     * @llm-rule AVOID: Using multiple error handlers - this should be the final middleware
+     * @llm-rule NOTE: MIDDLEWARE SETUP: app.use(error.handleErrors()); // Must be LAST
+     * @llm-rule NOTE: AUTO-FEATURES: dev vs prod responses, stack trace hiding, error logging
+     */
+    handleErrors(options?: ErrorHandlerOptions): ExpressErrorHandler;
+    /**
+     * Wraps async route handlers to catch errors automatically
+     * @llm-rule WHEN: Creating async Express route handlers that might throw errors
+     * @llm-rule AVOID: Manual try/catch in every route - this handles it automatically
+     * @llm-rule NOTE: ASYNC PATTERN: app.post('/route', error.asyncRoute(async (req, res) => {...}));
+     * @llm-rule NOTE: ERROR FLOW: thrown errors → automatically caught → sent to handleErrors middleware
+     */
+    asyncRoute(fn: AsyncRouteHandler): (req: ExpressRequest, res: ExpressResponse, next: ExpressNextFunction) => void;
+    /**
+     * Checks if error is a 4xx client error
+     * @llm-rule WHEN: Need to categorize errors for logging or metrics
+     * @llm-rule AVOID: Manual status code checking - this handles the logic
+     * @llm-rule NOTE: CLIENT ERRORS: 400-499 status codes (user's fault)
+     */
+    isClientError(error: AppError): boolean;
+    /**
+     * Checks if error is a 5xx server error
+     * @llm-rule WHEN: Need to categorize errors for monitoring or alerting
+     * @llm-rule AVOID: Manual status code checking - this handles the logic
+     * @llm-rule NOTE: SERVER ERRORS: 500-599 status codes (server's fault)
+     */
+    isServerError(error: AppError): boolean;
+    /**
+     * Gets current environment detection info
+     * @llm-rule WHEN: Need to check current environment configuration
+     * @llm-rule AVOID: Direct process.env access - this provides parsed config
+     */
+    getEnvironmentInfo(): {
+        isDevelopment: boolean;
+        isProduction: boolean;
+        nodeEnv: string;
+    };
+    /**
+     * Gets current error configuration
+     * @llm-rule WHEN: Debugging error setup or inspecting current settings
+     * @llm-rule AVOID: Accessing config directly - this provides clean interface
+     */
+    getConfig(): ErrorConfig;
+}
+//# sourceMappingURL=error.d.ts.map

package/dist/error/error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../src/error/error.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD,MAAM,WAAW,QAAS,SAAQ,KAAK;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,cAAc;IAC7B,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,eAAe,CAAC;IAC1C,IAAI,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,mBAAmB;IAClC,CAAC,KAAK,CAAC,EAAE,GAAG,GAAG,IAAI,CAAC;CACrB;AAED,MAAM,MAAM,mBAAmB,GAAG,CAChC,KAAK,EAAE,QAAQ,EACf,GAAG,EAAE,cAAc,EACnB,GAAG,EAAE,eAAe,EACpB,IAAI,EAAE,mBAAmB,KACtB,IAAI,CAAC;AAEV,MAAM,MAAM,iBAAiB,GAAG,CAC9B,GAAG,EAAE,cAAc,EACnB,GAAG,EAAE,eAAe,EACpB,IAAI,EAAE,mBAAmB,KACtB,OAAO,CAAC,GAAG,CAAC,CAAC;AAElB,MAAM,WAAW,mBAAmB;IAClC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;GAEG;AACH,qBAAa,UAAU;IACd,MAAM,EAAE,WAAW,CAAC;gBAEf,MAAM,EAAE,WAAW;IAI/B;;;;;;OAMG;IACH,UAAU,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,QAAQ;IAOtC;;;;;;OAMG;IACH,YAAY,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,QAAQ;IAOxC;;;;;;OAMG;IACH,SAAS,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,QAAQ;IAOrC;;;;;;OAMG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,QAAQ;IAOpC;;;;;;OAMG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,QAAQ;IAOpC;;;;;;OAMG;IACH,WAAW,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,QAAQ;IAOvC;;;;;;OAMG;IACH,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,QAAQ;IAOzE;;;;;;OAMG;IACH,YAAY,CAAC,OAAO,GAAE,mBAAwB,GAAG,mBAAmB;IAyCpE;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,EAAE,iBAAiB,GAAG,CAAC,GAAG,EAAE,cAAc,EAAE,GAAG,EAAE,eAAe,EAAE,IAAI,EAAE,mBAAmB,KAAK,IAAI;IAMjH;;;;;OAKG;IACH,aAAa,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO;IAIvC;;;;;OAKG;IACH,aAAa,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO;IAIvC;;;;OAIG;IACH,kBAAkB,IAAI;QAAE,aAAa,EAAE,OAAO,CAAC;QAAC,YAAY,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;IAQxF;;;;OAIG;IACH,SAAS,IAAI,WAAW;CAGzB"}