@bloomneo/appkit 1.2.9

package/dist/event/strategies/redis.js

@@ -0,0 +1,434 @@
+/**
+ * Redis event strategy with distributed pub/sub and automatic connection management
+ * @module @bloomneo/appkit/event
+ * @file src/event/strategies/redis.ts
+ *
+ * @llm-rule WHEN: App has REDIS_URL environment variable for distributed events across servers
+ * @llm-rule AVOID: Manual Redis setup - this handles connection, retry, and subscription management
+ * @llm-rule NOTE: Distributed events, automatic reconnection, pattern subscriptions, production-ready
+ */
+/**
+ * Redis event strategy with distributed pub/sub and reliability features
+ */
+export class RedisStrategy {
+    config;
+    namespace;
+    publisher = null;
+    subscriber = null;
+    connected = false;
+    listeners = new Map();
+    patternListeners = new Map();
+    /**
+     * Creates Redis strategy with direct environment access (like auth pattern)
+     * @llm-rule WHEN: Event initialization with REDIS_URL detected
+     * @llm-rule AVOID: Manual Redis configuration - environment detection handles this
+     */
+    constructor(config, namespace) {
+        this.config = config;
+        this.namespace = namespace;
+    }
+    /**
+     * Connects to Redis with automatic retry and pub/sub setup
+     * @llm-rule WHEN: Event initialization or reconnection after failure
+     * @llm-rule AVOID: Manual connection management - this handles all Redis complexity
+     */
+    async connect() {
+        if (this.connected)
+            return;
+        try {
+            // Dynamic import for Redis client
+            const { createClient } = await import('redis');
+            const redisConfig = this.config.redis;
+            // Create Redis clients (separate for pub/sub)
+            const clientConfig = {
+                url: redisConfig.url,
+                password: redisConfig.password,
+                socket: {
+                    connectTimeout: redisConfig.connectTimeout,
+                    reconnectStrategy: (retries) => {
+                        if (retries >= redisConfig.maxRetries) {
+                            console.error(`[AppKit] Redis max retries (${redisConfig.maxRetries}) exceeded`);
+                            return new Error('Redis connection failed');
+                        }
+                        const delay = Math.min(redisConfig.retryDelay * Math.pow(2, retries), 10000);
+                        console.warn(`[AppKit] Redis reconnecting in ${delay}ms (attempt ${retries + 1})`);
+                        return delay;
+                    },
+                },
+            };
+            // Create publisher and subscriber clients
+            this.publisher = createClient(clientConfig);
+            this.subscriber = createClient(clientConfig);
+            // Set up event handlers
+            this.setupEventHandlers();
+            // Connect both clients
+            await Promise.all([
+                this.publisher.connect(),
+                this.subscriber.connect()
+            ]);
+            this.connected = true;
+            if (this.config.environment.isDevelopment) {
+                console.log(`✅ [AppKit] Redis event strategy connected (namespace: ${this.namespace})`);
+            }
+        }
+        catch (error) {
+            this.connected = false;
+            this.publisher = null;
+            this.subscriber = null;
+            throw new Error(`Redis event connection failed: ${error.message}`);
+        }
+    }
+    /**
+     * Sets up Redis event handlers for connection management
+     */
+    setupEventHandlers() {
+        if (!this.publisher || !this.subscriber)
+            return;
+        // Publisher events
+        this.publisher.on('error', (error) => {
+            console.error('[AppKit] Redis publisher error:', error.message);
+            this.connected = false;
+        });
+        this.publisher.on('ready', () => {
+            if (this.config.environment.isDevelopment) {
+                console.log('✅ [AppKit] Redis publisher ready');
+            }
+        });
+        // Subscriber events
+        this.subscriber.on('error', (error) => {
+            console.error('[AppKit] Redis subscriber error:', error.message);
+            this.connected = false;
+        });
+        this.subscriber.on('ready', () => {
+            if (this.config.environment.isDevelopment) {
+                console.log('✅ [AppKit] Redis subscriber ready');
+            }
+        });
+        // Handle reconnection
+        this.subscriber.on('reconnecting', () => {
+            this.connected = false;
+            if (this.config.environment.isDevelopment) {
+                console.log('🔄 [AppKit] Redis subscriber reconnecting...');
+            }
+        });
+        this.subscriber.on('end', () => {
+            this.connected = false;
+            if (this.config.environment.isDevelopment) {
+                console.log('👋 [AppKit] Redis subscriber connection ended');
+            }
+        });
+    }
+    /**
+     * Emits event via Redis pub/sub with automatic serialization
+     * @llm-rule WHEN: Sending events across multiple servers/processes
+     * @llm-rule AVOID: Manual Redis pub/sub - this handles serialization and namespacing
+     * @llm-rule NOTE: Events are distributed to all connected servers automatically
+     */
+    async emit(event, data) {
+        if (!this.connected || !this.publisher) {
+            console.error(`[AppKit] Redis not connected, cannot emit event: ${event}`);
+            return false;
+        }
+        try {
+            // Build Redis channel name with prefix
+            const channel = this.buildChannelName(event);
+            // Serialize event data
+            const message = this.serializeMessage(data);
+            // Publish to Redis
+            const result = await this.publisher.publish(channel, message);
+            // Log in development
+            if (this.config.environment.isDevelopment) {
+                console.log(`📤 [AppKit] Redis event published: ${event} (subscribers: ${result})`);
+            }
+            return result >= 0; // Redis returns number of subscribers
+        }
+        catch (error) {
+            console.error(`[AppKit] Redis emit error for event "${event}":`, error.message);
+            return false;
+        }
+    }
+    /**
+     * Adds event listener with Redis subscription management
+     * @llm-rule WHEN: Listening to distributed events across servers
+     * @llm-rule AVOID: Manual Redis subscribe - this handles pattern matching and message routing
+     */
+    on(event, handler) {
+        try {
+            // Add to local listeners map
+            if (!this.listeners.has(event)) {
+                this.listeners.set(event, new Set());
+            }
+            this.listeners.get(event).add(handler);
+            // Subscribe to Redis channel if this is the first listener
+            if (this.listeners.get(event).size === 1) {
+                this.subscribeToEvent(event);
+            }
+            if (this.config.environment.isDevelopment) {
+                console.log(`📥 [AppKit] Redis listener added for: ${event} (total: ${this.listeners.get(event).size})`);
+            }
+        }
+        catch (error) {
+            console.error(`[AppKit] Redis on error for event "${event}":`, error.message);
+        }
+    }
+    /**
+     * Adds one-time event listener with automatic cleanup
+     * @llm-rule WHEN: Listening to distributed events that should only fire once
+     * @llm-rule AVOID: Manual cleanup - this handles removal after first trigger
+     */
+    once(event, handler) {
+        try {
+            // Create wrapper that removes itself after first call
+            const onceWrapper = (data) => {
+                this.off(event, onceWrapper);
+                handler(data);
+            };
+            // Add the wrapper as a regular listener
+            this.on(event, onceWrapper);
+            if (this.config.environment.isDevelopment) {
+                console.log(`📥 [AppKit] Redis once listener added for: ${event}`);
+            }
+        }
+        catch (error) {
+            console.error(`[AppKit] Redis once error for event "${event}":`, error.message);
+        }
+    }
+    /**
+     * Removes event listener(s) with Redis unsubscribe management
+     * @llm-rule WHEN: Cleaning up distributed event listeners
+     * @llm-rule AVOID: Manual Redis unsubscribe - this handles cleanup automatically
+     */
+    off(event, handler) {
+        try {
+            const eventListeners = this.listeners.get(event);
+            if (!eventListeners)
+                return;
+            if (handler) {
+                // Remove specific handler
+                eventListeners.delete(handler);
+                // Unsubscribe from Redis if no more listeners
+                if (eventListeners.size === 0) {
+                    this.listeners.delete(event);
+                    this.unsubscribeFromEvent(event);
+                }
+            }
+            else {
+                // Remove all handlers for event
+                const count = eventListeners.size;
+                this.listeners.delete(event);
+                this.unsubscribeFromEvent(event);
+                if (this.config.environment.isDevelopment && count > 0) {
+                    console.log(`📤 [AppKit] Redis removed ${count} listeners for: ${event}`);
+                }
+            }
+        }
+        catch (error) {
+            console.error(`[AppKit] Redis off error for event "${event}":`, error.message);
+        }
+    }
+    /**
+     * Gets current event listeners for debugging
+     * @llm-rule WHEN: Debugging distributed event listeners
+     * @llm-rule AVOID: Using for business logic - this is for debugging only
+     */
+    getListeners(event) {
+        if (event) {
+            const listeners = this.listeners.get(event);
+            return {
+                count: listeners ? listeners.size : 0,
+                subscribed: this.listeners.has(event),
+                channel: this.buildChannelName(event),
+            };
+        }
+        // Get all events with listeners
+        const events = Array.from(this.listeners.entries()).map(([eventName, handlers]) => ({
+            event: eventName,
+            count: handlers.size,
+            channel: this.buildChannelName(eventName),
+        }));
+        return {
+            totalEvents: events.length,
+            totalListeners: events.reduce((sum, event) => sum + event.count, 0),
+            connected: this.connected,
+            events,
+        };
+    }
+    /**
+     * Disconnects Redis strategy gracefully
+     * @llm-rule WHEN: App shutdown or event cleanup
+     * @llm-rule AVOID: Abrupt disconnection - graceful shutdown prevents connection issues
+     */
+    async disconnect() {
+        if (!this.connected)
+            return;
+        try {
+            // Clear all listeners
+            this.listeners.clear();
+            this.patternListeners.clear();
+            // Disconnect Redis clients
+            const disconnectPromises = [];
+            if (this.publisher) {
+                disconnectPromises.push(this.publisher.quit());
+            }
+            if (this.subscriber) {
+                disconnectPromises.push(this.subscriber.quit());
+            }
+            await Promise.all(disconnectPromises);
+            this.connected = false;
+            this.publisher = null;
+            this.subscriber = null;
+            if (this.config.environment.isDevelopment) {
+                console.log(`👋 [AppKit] Redis event strategy disconnected (namespace: ${this.namespace})`);
+            }
+        }
+        catch (error) {
+            console.error(`[AppKit] Redis disconnect error:`, error.message);
+            // Force close if graceful quit fails
+            if (this.publisher)
+                this.publisher.disconnect();
+            if (this.subscriber)
+                this.subscriber.disconnect();
+            this.publisher = null;
+            this.subscriber = null;
+        }
+    }
+    // Private helper methods
+    /**
+     * Builds Redis channel name with prefix and namespace
+     */
+    buildChannelName(event) {
+        const prefix = this.config.redis?.keyPrefix || 'events';
+        return `${prefix}:${this.namespace}:${event}`;
+    }
+    /**
+     * Serializes message data for Redis transmission
+     */
+    serializeMessage(data) {
+        try {
+            return JSON.stringify({
+                data,
+                timestamp: new Date().toISOString(),
+                namespace: this.namespace,
+            });
+        }
+        catch (error) {
+            throw new Error(`Failed to serialize event data: ${error.message}`);
+        }
+    }
+    /**
+     * Deserializes message data from Redis
+     */
+    deserializeMessage(message) {
+        try {
+            const parsed = JSON.parse(message);
+            return parsed.data;
+        }
+        catch (error) {
+            console.error('Failed to deserialize Redis message:', error);
+            return message; // Return raw message as fallback
+        }
+    }
+    /**
+     * Subscribes to Redis channel for specific event
+     */
+    async subscribeToEvent(event) {
+        if (!this.connected || !this.subscriber)
+            return;
+        try {
+            const channel = this.buildChannelName(event);
+            // Subscribe to Redis channel
+            await this.subscriber.subscribe(channel, (message) => {
+                this.handleRedisMessage(event, message);
+            });
+            if (this.config.environment.isDevelopment) {
+                console.log(`🔗 [AppKit] Redis subscribed to: ${channel}`);
+            }
+        }
+        catch (error) {
+            console.error(`[AppKit] Redis subscribe error for event "${event}":`, error.message);
+        }
+    }
+    /**
+     * Unsubscribes from Redis channel for specific event
+     */
+    async unsubscribeFromEvent(event) {
+        if (!this.connected || !this.subscriber)
+            return;
+        try {
+            const channel = this.buildChannelName(event);
+            // Unsubscribe from Redis channel
+            await this.subscriber.unsubscribe(channel);
+            if (this.config.environment.isDevelopment) {
+                console.log(`🔓 [AppKit] Redis unsubscribed from: ${channel}`);
+            }
+        }
+        catch (error) {
+            console.error(`[AppKit] Redis unsubscribe error for event "${event}":`, error.message);
+        }
+    }
+    /**
+     * Handles incoming Redis messages and routes to listeners
+     */
+    handleRedisMessage(event, message) {
+        try {
+            // Deserialize message
+            const data = this.deserializeMessage(message);
+            // Get listeners for this event
+            const eventListeners = this.listeners.get(event);
+            if (!eventListeners || eventListeners.size === 0)
+                return;
+            // Call all listeners
+            for (const handler of eventListeners) {
+                try {
+                    const result = handler(data);
+                    if (result && typeof result.then === 'function') {
+                        result.catch((error) => {
+                            console.error(`Redis event handler error for "${event}":`, error.message);
+                        });
+                    }
+                }
+                catch (error) {
+                    console.error(`Redis event handler error for "${event}":`, error.message);
+                }
+            }
+            if (this.config.environment.isDevelopment) {
+                console.log(`📨 [AppKit] Redis message received: ${event} (${eventListeners.size} handlers)`);
+            }
+        }
+        catch (error) {
+            console.error(`[AppKit] Redis message handling error:`, error.message);
+        }
+    }
+    /**
+     * Gets Redis connection statistics
+     */
+    getConnectionInfo() {
+        const redisConfig = this.config.redis;
+        const subscriptions = Array.from(this.listeners.keys());
+        const totalListeners = Array.from(this.listeners.values())
+            .reduce((sum, listeners) => sum + listeners.size, 0);
+        return {
+            connected: this.connected,
+            url: this.maskUrl(redisConfig.url),
+            namespace: this.namespace,
+            totalSubscriptions: subscriptions.length,
+            totalListeners,
+        };
+    }
+    /**
+     * Masks sensitive parts of Redis URL for logging
+     */
+    maskUrl(url) {
+        try {
+            const parsed = new URL(url);
+            if (parsed.password) {
+                parsed.password = '***';
+            }
+            return parsed.toString();
+        }
+        catch {
+            return 'redis://***';
+        }
+    }
+}
+//# sourceMappingURL=redis.js.map

package/dist/event/strategies/redis.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,58 @@
+/**
+ * @bloomneo/appkit - Ultra-minimal, tree-shakable Node.js application toolkit
+ *
+ * This file provides direct access to individual module entry points for optimal tree-shaking.
+ * Import only what you need - unused code will be automatically eliminated by modern bundlers.
+ *
+ * @module @bloomneo/appkit
+ * @file src/index.ts
+ *
+ * @example
+ * // ✅ Perfect tree-shaking - only specific modules bundled
+ * import { authClass } from '@bloomneo/appkit/auth';
+ * import { databaseClass } from '@bloomneo/appkit/database';
+ *
+ * // ✅ Also tree-shakable - but imports main index
+ * import { authClass, databaseClass } from '@bloomneo/appkit';
+ *
+ * // ❌ Avoid - imports everything
+ * import * as appkit from '@bloomneo/appkit';
+ */
+/**
+ * Library name
+ * @type {string}
+ */
+export declare const NAME = "@bloomneo/appkit";
+/**
+ * Supported Node.js version
+ * @type {string}
+ */
+export declare const NODE_VERSION = ">=18.0.0";
+/**
+ * Re-export main entry functions for convenience (tree-shakable)
+ * Each import only loads the specific module needed
+ *
+ * Pattern: {folderName}Class.get() → creates {folderName} instance
+ */
+export { authClass } from './auth/index.js';
+export { configClass } from './config/index.js';
+export { securityClass } from './security/index.js';
+export { databaseClass } from './database/index.js';
+export { cacheClass } from './cache/index.js';
+export { emailClass } from './email/index.js';
+export { eventClass } from './event/index.js';
+export { errorClass } from './error/index.js';
+export { loggerClass } from './logger/index.js';
+export { queueClass } from './queue/index.js';
+export { storageClass } from './storage/index.js';
+export { utilClass } from './util/index.js';
+/**
+ * Quick health check for the library
+ * @returns {Object} Basic library information
+ */
+export declare function getLibraryInfo(): {
+    name: string;
+    nodeVersion: string;
+    timestamp: string;
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAIH;;;GAGG;AACH,eAAO,MAAM,IAAI,qBAAqB,CAAC;AAEvC;;;GAGG;AACH,eAAO,MAAM,YAAY,aAAa,CAAC;AAEvC;;;;;GAKG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAG5C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGhD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGpD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGpD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAG9C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAG9C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAG9C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAG9C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGhD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAG9C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGlD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C;;;GAGG;AACH,wBAAgB,cAAc;;;;EAM7B"}

package/dist/index.js

@@ -0,0 +1,72 @@
+/**
+ * @bloomneo/appkit - Ultra-minimal, tree-shakable Node.js application toolkit
+ *
+ * This file provides direct access to individual module entry points for optimal tree-shaking.
+ * Import only what you need - unused code will be automatically eliminated by modern bundlers.
+ *
+ * @module @bloomneo/appkit
+ * @file src/index.ts
+ *
+ * @example
+ * // ✅ Perfect tree-shaking - only specific modules bundled
+ * import { authClass } from '@bloomneo/appkit/auth';
+ * import { databaseClass } from '@bloomneo/appkit/database';
+ *
+ * // ✅ Also tree-shakable - but imports main index
+ * import { authClass, databaseClass } from '@bloomneo/appkit';
+ *
+ * // ❌ Avoid - imports everything
+ * import * as appkit from '@bloomneo/appkit';
+ */
+/**
+ * Library name
+ * @type {string}
+ */
+export const NAME = '@bloomneo/appkit';
+/**
+ * Supported Node.js version
+ * @type {string}
+ */
+export const NODE_VERSION = '>=18.0.0';
+/**
+ * Re-export main entry functions for convenience (tree-shakable)
+ * Each import only loads the specific module needed
+ *
+ * Pattern: {folderName}Class.get() → creates {folderName} instance
+ */
+// Authentication
+export { authClass } from './auth/index.js';
+// Configuration
+export { configClass } from './config/index.js';
+// Security
+export { securityClass } from './security/index.js';
+// Database
+export { databaseClass } from './database/index.js';
+// Caching
+export { cacheClass } from './cache/index.js';
+// Email
+export { emailClass } from './email/index.js';
+// Events
+export { eventClass } from './event/index.js';
+// Error handling
+export { errorClass } from './error/index.js';
+// Logging
+export { loggerClass } from './logger/index.js';
+// Queuing
+export { queueClass } from './queue/index.js';
+// Storage
+export { storageClass } from './storage/index.js';
+// Utilities
+export { utilClass } from './util/index.js';
+/**
+ * Quick health check for the library
+ * @returns {Object} Basic library information
+ */
+export function getLibraryInfo() {
+    return {
+        name: NAME,
+        nodeVersion: NODE_VERSION,
+        timestamp: new Date().toISOString(),
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAIH;;;GAGG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG,kBAAkB,CAAC;AAEvC;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,UAAU,CAAC;AAEvC;;;;;GAKG;AAEH,iBAAiB;AACjB,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,gBAAgB;AAChB,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,WAAW;AACX,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,WAAW;AACX,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,UAAU;AACV,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,QAAQ;AACR,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,SAAS;AACT,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,iBAAiB;AACjB,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,UAAU;AACV,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,UAAU;AACV,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,UAAU;AACV,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,YAAY;AACZ,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C;;;GAGG;AACH,MAAM,UAAU,cAAc;IAC5B,OAAO;QACL,IAAI,EAAE,IAAI;QACV,WAAW,EAAE,YAAY;QACzB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAC;AACJ,CAAC"}

package/dist/logger/defaults.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Smart defaults with direct environment access and auto transport detection
+ * @module @bloomneo/appkit/logger
+ * @file src/logger/defaults.ts
+ *
+ * @llm-rule WHEN: App startup - need production-ready logging configuration
+ * @llm-rule AVOID: Calling multiple times - expensive environment parsing, cache results
+ * @llm-rule NOTE: Called once at startup, cached globally for performance like auth module
+ * @llm-rule NOTE: Now includes visual error configuration for enhanced developer experience
+ */
+export interface LoggingConfig {
+    level: 'debug' | 'info' | 'warn' | 'error';
+    scope: 'minimal' | 'full';
+    minimal: boolean;
+    transports: {
+        console: boolean;
+        file: boolean;
+        database: boolean;
+        http: boolean;
+        webhook: boolean;
+    };
+    console: {
+        colorize: boolean;
+        timestamps: boolean;
+        prettyPrint: boolean;
+    };
+    file: {
+        dir: string;
+        filename: string;
+        maxSize: number;
+        retentionDays: number;
+    };
+    database: {
+        url: string | null;
+        table: string;
+        batchSize: number;
+    };
+    http: {
+        url: string | null;
+        batchSize: number;
+        timeout: number;
+    };
+    webhook: {
+        url: string | null;
+        level: 'debug' | 'info' | 'warn' | 'error';
+        rateLimit: number;
+    };
+    service: {
+        name: string;
+        version: string;
+        environment: string;
+    };
+}
+/**
+ * Get smart defaults using direct VOILA_LOGGER_* environment access
+ * @llm-rule WHEN: App startup to get production-ready logging configuration
+ * @llm-rule AVOID: Calling repeatedly - validates environment each time, expensive operation
+ * @llm-rule NOTE: Called once at startup, cached globally for performance
+ */
+export declare function getSmartDefaults(): LoggingConfig;
+/**
+ * Validate environment variables (like auth module validation)
+ * @llm-rule WHEN: App startup to catch configuration errors early
+ * @llm-rule AVOID: Skipping validation - invalid config causes silent failures
+ */
+export declare function validateEnvironment(): void;
+//# sourceMappingURL=defaults.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../src/logger/defaults.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IAC3C,KAAK,EAAE,SAAS,GAAG,MAAM,CAAC;IAC1B,OAAO,EAAE,OAAO,CAAC;IAGjB,UAAU,EAAE;QACV,OAAO,EAAE,OAAO,CAAC;QACjB,IAAI,EAAE,OAAO,CAAC;QACd,QAAQ,EAAE,OAAO,CAAC;QAClB,IAAI,EAAE,OAAO,CAAC;QACd,OAAO,EAAE,OAAO,CAAC;KAClB,CAAC;IAGF,OAAO,EAAE;QACP,QAAQ,EAAE,OAAO,CAAC;QAClB,UAAU,EAAE,OAAO,CAAC;QACpB,WAAW,EAAE,OAAO,CAAC;KACtB,CAAC;IAEF,IAAI,EAAE;QACJ,GAAG,EAAE,MAAM,CAAC;QACZ,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;IAEF,QAAQ,EAAE;QACR,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;QACnB,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IAEF,IAAI,EAAE;QACJ,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;QACnB,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IAEF,OAAO,EAAE;QACP,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;QACnB,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;QAC3C,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IAGF,OAAO,EAAE;QACP,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;CACH;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,IAAI,aAAa,CAkEhD;AAiED;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CA4C1C"}