@bloomneo/appkit 1.2.9

package/dist/auth/index.js

@@ -0,0 +1,94 @@
+/**
+ * Ultra-simple role-level-permission authentication that just works
+ * @module @bloomneo/appkit/auth
+ * @file src/auth/index.ts
+ *
+ * @llm-rule WHEN: Building apps that need authentication with user roles and permissions
+ * @llm-rule AVOID: Complex auth setups with multiple libraries - this handles JWT + bcrypt + middleware in one API
+ * @llm-rule NOTE: Uses role.level hierarchy (user.basic → admin.system) with automatic inheritance
+ * @llm-rule NOTE: Common pattern - auth.requireLoginToken() → auth.requireUserRoles() → handler
+ * @llm-rule NOTE: Safe user access - const user = auth.user(req); if (!user) return error;
+ */
+import { AuthenticationClass } from './auth.js';
+import { getSmartDefaults } from './defaults.js';
+// Global authentication instance for performance
+let globalAuthentication = null;
+/**
+ * Get authentication instance - the only function you need to learn
+ * Environment variables parsed once for performance
+ * @llm-rule WHEN: Starting any auth operation - this is your main entry point
+ * @llm-rule AVOID: Calling new AuthenticationClass() directly - always use this function
+ * @llm-rule NOTE: Typical flow - get() → generateLoginToken() → middleware → user()
+ */
+function get(overrides = {}) {
+    // Lazy initialization - parse environment once
+    if (!globalAuthentication) {
+        const defaults = getSmartDefaults();
+        const config = { ...defaults, ...overrides };
+        globalAuthentication = new AuthenticationClass(config);
+    }
+    return globalAuthentication;
+}
+/**
+ * Reset global instance (useful for testing or config changes)
+ * @llm-rule WHEN: Testing auth logic with different configurations
+ * @llm-rule AVOID: Using in production - only for tests and development
+ */
+function reset(newConfig = {}) {
+    const defaults = getSmartDefaults();
+    const config = { ...defaults, ...newConfig };
+    globalAuthentication = new AuthenticationClass(config);
+    return globalAuthentication;
+}
+/**
+ * Get current role hierarchy for inspection
+ * @llm-rule WHEN: Need to see available role.levels for debugging or UI
+ * @llm-rule AVOID: Using for authorization logic - use hasRole() method instead
+ */
+function getRoles() {
+    const auth = get();
+    return auth.config.roles;
+}
+/**
+ * Get current permission configuration for inspection
+ * @llm-rule WHEN: Need to see default permissions for debugging or documentation
+ * @llm-rule AVOID: Using for permission checks - use can() method instead
+ */
+function getPermissions() {
+    const auth = get();
+    return auth.config.permissions;
+}
+/**
+ * Check if a role.level exists in current configuration
+ * @llm-rule WHEN: Validating user input or config before creating tokens
+ * @llm-rule AVOID: Using for runtime authorization - this is for validation only
+ */
+function isValidRole(roleLevel) {
+    const auth = get();
+    return auth.config.roles[roleLevel] !== undefined;
+}
+/**
+ * Get all available role.levels in hierarchy order
+ * @llm-rule WHEN: Building role selection UI or generating documentation
+ * @llm-rule AVOID: Hardcoding role lists - use this to stay in sync with config
+ */
+function getAllRoles() {
+    const auth = get();
+    const roles = auth.config.roles;
+    return Object.keys(roles).sort((a, b) => roles[a].level - roles[b].level);
+}
+/**
+ * Single authentication export with minimal functionality
+ */
+export const authClass = {
+    // Core method
+    get,
+    // Utility methods
+    reset,
+    getRoles,
+    getPermissions,
+    isValidRole,
+    getAllRoles,
+};
+export { AuthenticationClass } from './auth.js';
+//# sourceMappingURL=index.js.map

package/dist/auth/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/auth/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAuC,MAAM,eAAe,CAAC;AAEtF,iDAAiD;AACjD,IAAI,oBAAoB,GAA+B,IAAI,CAAC;AAE5D;;;;;;GAMG;AACH,SAAS,GAAG,CAAC,YAAiC,EAAE;IAC9C,+CAA+C;IAC/C,IAAI,CAAC,oBAAoB,EAAE,CAAC;QAC1B,MAAM,QAAQ,GAAG,gBAAgB,EAAE,CAAC;QACpC,MAAM,MAAM,GAAe,EAAE,GAAG,QAAQ,EAAE,GAAG,SAAS,EAAE,CAAC;QACzD,oBAAoB,GAAG,IAAI,mBAAmB,CAAC,MAAM,CAAC,CAAC;IACzD,CAAC;IAED,OAAO,oBAAoB,CAAC;AAC9B,CAAC;AAED;;;;GAIG;AACH,SAAS,KAAK,CAAC,YAAiC,EAAE;IAChD,MAAM,QAAQ,GAAG,gBAAgB,EAAE,CAAC;IACpC,MAAM,MAAM,GAAe,EAAE,GAAG,QAAQ,EAAE,GAAG,SAAS,EAAE,CAAC;IACzD,oBAAoB,GAAG,IAAI,mBAAmB,CAAC,MAAM,CAAC,CAAC;IACvD,OAAO,oBAAoB,CAAC;AAC9B,CAAC;AAED;;;;GAIG;AACH,SAAS,QAAQ;IACf,MAAM,IAAI,GAAG,GAAG,EAAE,CAAC;IACnB,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;AAC3B,CAAC;AAED;;;;GAIG;AACH,SAAS,cAAc;IACrB,MAAM,IAAI,GAAG,GAAG,EAAE,CAAC;IACnB,OAAO,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC;AACjC,CAAC;AAED;;;;GAIG;AACH,SAAS,WAAW,CAAC,SAAiB;IACpC,MAAM,IAAI,GAAG,GAAG,EAAE,CAAC;IACnB,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,KAAK,SAAS,CAAC;AACpD,CAAC;AAED;;;;GAIG;AACH,SAAS,WAAW;IAClB,MAAM,IAAI,GAAG,GAAG,EAAE,CAAC;IACnB,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;IAEhC,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;AAC5E,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,cAAc;IACd,GAAG;IAEH,kBAAkB;IAClB,KAAK;IACL,QAAQ;IACR,cAAc;IACd,WAAW;IACX,WAAW;CACH,CAAC;AAoBX,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC"}

package/dist/cache/cache.d.ts

@@ -0,0 +1,118 @@
+/**
+ * Core cache class with Redis and Memory strategies and simplified API
+ * @module @bloomneo/appkit/cache
+ * @file src/cache/cache.ts
+ *
+ * @llm-rule WHEN: Building apps that need caching with automatic strategy selection
+ * @llm-rule AVOID: Using directly - always get instance via cacheClass.get()
+ * @llm-rule NOTE: Auto-detects Redis vs Memory from environment, namespace passed to get() function
+ */
+import type { CacheConfig } from './defaults.js';
+export interface CacheStrategy {
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    get(key: string): Promise<any>;
+    set(key: string, value: any, ttl?: number): Promise<boolean>;
+    delete(key: string): Promise<boolean>;
+    clear(): Promise<boolean>;
+    has(key: string): Promise<boolean>;
+    keys(pattern?: string): Promise<string[]>;
+    deleteMany(keys: string[]): Promise<number>;
+}
+/**
+ * Cache class with automatic strategy selection and ultra-simple API
+ */
+export declare class CacheClass {
+    config: CacheConfig;
+    namespace: string;
+    private strategy;
+    private connected;
+    constructor(config: CacheConfig, namespace: string);
+    /**
+     * Creates appropriate strategy based on configuration
+     * @llm-rule WHEN: Cache initialization - selects Redis or Memory based on environment
+     * @llm-rule AVOID: Manual strategy creation - configuration handles strategy selection
+     */
+    private createStrategy;
+    /**
+     * Connects to cache backend with automatic retry logic
+     * @llm-rule WHEN: Cache initialization or reconnection after failure
+     * @llm-rule AVOID: Manual connection management - this handles connection state
+     */
+    connect(): Promise<void>;
+    /**
+     * Disconnects from cache backend gracefully
+     * @llm-rule WHEN: App shutdown or cache cleanup
+     * @llm-rule AVOID: Abrupt disconnection - graceful shutdown prevents data loss
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Gets a value from cache with automatic key prefixing
+     * @llm-rule WHEN: Retrieving cached data by key
+     * @llm-rule AVOID: Manual key management - automatic prefixing handles namespacing
+     * @llm-rule NOTE: Returns null if key not found or expired
+     */
+    get(key: string): Promise<any>;
+    /**
+     * Sets a value in cache with TTL and automatic key prefixing
+     * @llm-rule WHEN: Storing data in cache with optional expiration
+     * @llm-rule AVOID: Storing large objects without TTL - can cause memory issues
+     * @llm-rule NOTE: Uses default TTL from config if not specified
+     */
+    set(key: string, value: any, ttl?: number): Promise<boolean>;
+    /**
+     * Deletes a key from cache
+     * @llm-rule WHEN: Removing specific cached data or cache invalidation
+     * @llm-rule AVOID: Mass deletion without consideration - use clear() for full cache clear
+     */
+    delete(key: string): Promise<boolean>;
+    /**
+     * Clears entire namespace in cache
+     * @llm-rule WHEN: Cache invalidation or cleanup operations for this namespace
+     * @llm-rule AVOID: Using in production without careful consideration - affects all namespace data
+     * @llm-rule NOTE: Only clears keys within current namespace, not entire cache
+     */
+    clear(): Promise<boolean>;
+    /**
+     * Gets a value from cache or sets it using a factory function
+     * @llm-rule WHEN: Cache-aside pattern - get cached value or compute and cache
+     * @llm-rule AVOID: Manual get/set logic - this handles race conditions properly
+     * @llm-rule NOTE: Factory function only called on cache miss
+     */
+    getOrSet(key: string, factory: () => Promise<any>, ttl?: number): Promise<any>;
+    /**
+     * Gets current cache strategy name for debugging
+     * @llm-rule WHEN: Debugging or health checks to see which strategy is active
+     * @llm-rule AVOID: Using for application logic - cache should be transparent
+     */
+    getStrategy(): string;
+    /**
+     * Gets cache configuration summary for debugging
+     * @llm-rule WHEN: Health checks or debugging cache configuration
+     * @llm-rule AVOID: Exposing sensitive details - this only shows safe info
+     */
+    getConfig(): {
+        strategy: string;
+        keyPrefix: string;
+        namespace: string;
+        defaultTTL: number;
+        connected: boolean;
+    };
+    /**
+     * Ensures cache is connected before operations
+     */
+    private ensureConnected;
+    /**
+     * Builds full cache key with prefix and namespace
+     */
+    private buildKey;
+    /**
+     * Validates cache key format and length
+     */
+    private validateKey;
+    /**
+     * Validates cache value
+     */
+    private validateValue;
+}
+//# sourceMappingURL=cache.d.ts.map

package/dist/cache/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/cache/cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD,MAAM,WAAW,aAAa;IAC5B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAC/B,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7D,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACtC,KAAK,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACnC,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC1C,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC7C;AAED;;GAEG;AACH,qBAAa,UAAU;IACd,MAAM,EAAE,WAAW,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,QAAQ,CAAiC;IACjD,OAAO,CAAC,SAAS,CAAkB;gBAEvB,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM;IAMlD;;;;OAIG;IACH,OAAO,CAAC,cAAc;IAWtB;;;;OAIG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAgB9B;;;;OAIG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAejC;;;;;OAKG;IACG,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAapC;;;;;OAKG;IACG,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAelE;;;;OAIG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAa3C;;;;;OAKG;IACG,KAAK,IAAI,OAAO,CAAC,OAAO,CAAC;IAkB/B;;;;;OAKG;IACG,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAkBpF;;;;OAIG;IACH,WAAW,IAAI,MAAM;IAIrB;;;;OAIG;IACH,SAAS,IAAI;QACX,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,EAAE,OAAO,CAAC;KACpB;IAYD;;OAEG;YACW,eAAe;IAM7B;;OAEG;IACH,OAAO,CAAC,QAAQ;IAIhB;;OAEG;IACH,OAAO,CAAC,WAAW;IAkBnB;;OAEG;IACH,OAAO,CAAC,aAAa;CAYtB"}

package/dist/cache/cache.js

@@ -0,0 +1,249 @@
+/**
+ * Core cache class with Redis and Memory strategies and simplified API
+ * @module @bloomneo/appkit/cache
+ * @file src/cache/cache.ts
+ *
+ * @llm-rule WHEN: Building apps that need caching with automatic strategy selection
+ * @llm-rule AVOID: Using directly - always get instance via cacheClass.get()
+ * @llm-rule NOTE: Auto-detects Redis vs Memory from environment, namespace passed to get() function
+ */
+import { RedisStrategy } from './strategies/redis.js';
+import { MemoryStrategy } from './strategies/memory.js';
+/**
+ * Cache class with automatic strategy selection and ultra-simple API
+ */
+export class CacheClass {
+    config;
+    namespace;
+    strategy;
+    connected = false;
+    constructor(config, namespace) {
+        this.config = config;
+        this.namespace = namespace;
+        this.strategy = this.createStrategy();
+    }
+    /**
+     * Creates appropriate strategy based on configuration
+     * @llm-rule WHEN: Cache initialization - selects Redis or Memory based on environment
+     * @llm-rule AVOID: Manual strategy creation - configuration handles strategy selection
+     */
+    createStrategy() {
+        switch (this.config.strategy) {
+            case 'redis':
+                return new RedisStrategy(this.config);
+            case 'memory':
+                return new MemoryStrategy(this.config);
+            default:
+                throw new Error(`Unknown cache strategy: ${this.config.strategy}`);
+        }
+    }
+    /**
+     * Connects to cache backend with automatic retry logic
+     * @llm-rule WHEN: Cache initialization or reconnection after failure
+     * @llm-rule AVOID: Manual connection management - this handles connection state
+     */
+    async connect() {
+        if (this.connected)
+            return;
+        try {
+            await this.strategy.connect();
+            this.connected = true;
+            if (this.config.environment.isDevelopment) {
+                console.log(`✅ [AppKit] Cache connected using ${this.config.strategy} strategy`);
+            }
+        }
+        catch (error) {
+            console.error(`❌ [AppKit] Cache connection failed:`, error.message);
+            throw error;
+        }
+    }
+    /**
+     * Disconnects from cache backend gracefully
+     * @llm-rule WHEN: App shutdown or cache cleanup
+     * @llm-rule AVOID: Abrupt disconnection - graceful shutdown prevents data loss
+     */
+    async disconnect() {
+        if (!this.connected)
+            return;
+        try {
+            await this.strategy.disconnect();
+            this.connected = false;
+            if (this.config.environment.isDevelopment) {
+                console.log(`👋 [AppKit] Cache disconnected`);
+            }
+        }
+        catch (error) {
+            console.error(`⚠️ [AppKit] Cache disconnect error:`, error.message);
+        }
+    }
+    /**
+     * Gets a value from cache with automatic key prefixing
+     * @llm-rule WHEN: Retrieving cached data by key
+     * @llm-rule AVOID: Manual key management - automatic prefixing handles namespacing
+     * @llm-rule NOTE: Returns null if key not found or expired
+     */
+    async get(key) {
+        this.validateKey(key);
+        await this.ensureConnected();
+        try {
+            const prefixedKey = this.buildKey(key);
+            return await this.strategy.get(prefixedKey);
+        }
+        catch (error) {
+            console.error(`[AppKit] Cache get error for key "${key}":`, error.message);
+            return null; // Graceful degradation
+        }
+    }
+    /**
+     * Sets a value in cache with TTL and automatic key prefixing
+     * @llm-rule WHEN: Storing data in cache with optional expiration
+     * @llm-rule AVOID: Storing large objects without TTL - can cause memory issues
+     * @llm-rule NOTE: Uses default TTL from config if not specified
+     */
+    async set(key, value, ttl) {
+        this.validateKey(key);
+        this.validateValue(value);
+        await this.ensureConnected();
+        try {
+            const prefixedKey = this.buildKey(key);
+            const cacheTTL = ttl ?? this.config.defaultTTL;
+            return await this.strategy.set(prefixedKey, value, cacheTTL);
+        }
+        catch (error) {
+            console.error(`[AppKit] Cache set error for key "${key}":`, error.message);
+            return false; // Graceful degradation
+        }
+    }
+    /**
+     * Deletes a key from cache
+     * @llm-rule WHEN: Removing specific cached data or cache invalidation
+     * @llm-rule AVOID: Mass deletion without consideration - use clear() for full cache clear
+     */
+    async delete(key) {
+        this.validateKey(key);
+        await this.ensureConnected();
+        try {
+            const prefixedKey = this.buildKey(key);
+            return await this.strategy.delete(prefixedKey);
+        }
+        catch (error) {
+            console.error(`[AppKit] Cache delete error for key "${key}":`, error.message);
+            return false;
+        }
+    }
+    /**
+     * Clears entire namespace in cache
+     * @llm-rule WHEN: Cache invalidation or cleanup operations for this namespace
+     * @llm-rule AVOID: Using in production without careful consideration - affects all namespace data
+     * @llm-rule NOTE: Only clears keys within current namespace, not entire cache
+     */
+    async clear() {
+        await this.ensureConnected();
+        try {
+            // Get all keys in this namespace and delete them
+            const pattern = this.buildKey('*');
+            const keys = await this.strategy.keys(pattern);
+            if (keys.length === 0)
+                return true;
+            const deleted = await this.strategy.deleteMany(keys);
+            return deleted === keys.length;
+        }
+        catch (error) {
+            console.error(`[AppKit] Cache clear error:`, error.message);
+            return false;
+        }
+    }
+    /**
+     * Gets a value from cache or sets it using a factory function
+     * @llm-rule WHEN: Cache-aside pattern - get cached value or compute and cache
+     * @llm-rule AVOID: Manual get/set logic - this handles race conditions properly
+     * @llm-rule NOTE: Factory function only called on cache miss
+     */
+    async getOrSet(key, factory, ttl) {
+        // Try to get existing value first
+        const existing = await this.get(key);
+        if (existing !== null) {
+            return existing;
+        }
+        // Generate new value and cache it
+        try {
+            const value = await factory();
+            await this.set(key, value, ttl);
+            return value;
+        }
+        catch (error) {
+            console.error(`[AppKit] Cache getOrSet factory error for key "${key}":`, error.message);
+            throw error; // Re-throw factory errors
+        }
+    }
+    /**
+     * Gets current cache strategy name for debugging
+     * @llm-rule WHEN: Debugging or health checks to see which strategy is active
+     * @llm-rule AVOID: Using for application logic - cache should be transparent
+     */
+    getStrategy() {
+        return this.config.strategy;
+    }
+    /**
+     * Gets cache configuration summary for debugging
+     * @llm-rule WHEN: Health checks or debugging cache configuration
+     * @llm-rule AVOID: Exposing sensitive details - this only shows safe info
+     */
+    getConfig() {
+        return {
+            strategy: this.config.strategy,
+            keyPrefix: this.config.keyPrefix,
+            namespace: this.namespace,
+            defaultTTL: this.config.defaultTTL,
+            connected: this.connected,
+        };
+    }
+    // Private helper methods
+    /**
+     * Ensures cache is connected before operations
+     */
+    async ensureConnected() {
+        if (!this.connected) {
+            await this.connect();
+        }
+    }
+    /**
+     * Builds full cache key with prefix and namespace
+     */
+    buildKey(key) {
+        return `${this.config.keyPrefix}:${this.namespace}:${key}`;
+    }
+    /**
+     * Validates cache key format and length
+     */
+    validateKey(key) {
+        if (!key || typeof key !== 'string') {
+            throw new Error('Cache key must be a non-empty string');
+        }
+        if (key.length > 250) {
+            throw new Error('Cache key too long (max 250 characters)');
+        }
+        if (key.includes('\n') || key.includes('\r')) {
+            throw new Error('Cache key cannot contain newline characters');
+        }
+        if (key.includes(':')) {
+            throw new Error('Cache key cannot contain colon characters (reserved for namespacing)');
+        }
+    }
+    /**
+     * Validates cache value
+     */
+    validateValue(value) {
+        if (value === undefined) {
+            throw new Error('Cannot cache undefined values');
+        }
+        // Check if value can be serialized
+        try {
+            JSON.stringify(value);
+        }
+        catch (error) {
+            throw new Error('Value must be JSON serializable');
+        }
+    }
+}
+//# sourceMappingURL=cache.js.map

package/dist/cache/cache.js.map

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

package/dist/cache/defaults.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Smart defaults and environment validation for caching
+ * @module @bloomneo/appkit/cache
+ * @file src/cache/defaults.ts
+ *
+ * @llm-rule WHEN: App startup - need to configure cache behavior and connection strategy
+ * @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 RedisConfig {
+    url: string;
+    password?: string;
+    maxRetries: number;
+    retryDelay: number;
+    connectTimeout: number;
+    commandTimeout: number;
+}
+export interface MemoryConfig {
+    maxItems: number;
+    maxSizeBytes: number;
+    checkInterval: number;
+}
+export interface CacheConfig {
+    strategy: 'redis' | 'memory';
+    keyPrefix: string;
+    defaultTTL: number;
+    namespace: string;
+    redis?: RedisConfig;
+    memory?: MemoryConfig;
+    environment: {
+        isDevelopment: boolean;
+        isProduction: boolean;
+        isTest: boolean;
+        nodeEnv: string;
+    };
+}
+/**
+ * Gets smart defaults using environment variables with auto-strategy detection
+ * @llm-rule WHEN: App startup to get production-ready cache configuration
+ * @llm-rule AVOID: Calling repeatedly - expensive validation, cache the result
+ * @llm-rule NOTE: Auto-detects Redis vs Memory based on REDIS_URL environment variable
+ */
+export declare function getSmartDefaults(): CacheConfig;
+/**
+ * Gets cache configuration summary for debugging and health checks
+ * @llm-rule WHEN: Debugging cache configuration or building health check endpoints
+ * @llm-rule AVOID: Exposing sensitive connection details - this only shows safe info
+ */
+export declare function getConfigSummary(): {
+    strategy: string;
+    keyPrefix: string;
+    namespace: string;
+    defaultTTL: number;
+    redisConnected: boolean;
+    environment: string;
+};
+/**
+ * Validates that required cache configuration is present for production
+ * @llm-rule WHEN: App startup validation for production deployments
+ * @llm-rule AVOID: Skipping validation - missing cache config causes runtime issues
+ */
+export declare function validateProductionRequirements(): void;
+//# sourceMappingURL=defaults.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../src/cache/defaults.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,OAAO,GAAG,QAAQ,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,WAAW,EAAE;QACX,aAAa,EAAE,OAAO,CAAC;QACvB,YAAY,EAAE,OAAO,CAAC;QACtB,MAAM,EAAE,OAAO,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,IAAI,WAAW,CA+C9C;AAkID;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,OAAO,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;CACrB,CAWA;AAED;;;;GAIG;AACH,wBAAgB,8BAA8B,IAAI,IAAI,CAmBrD"}