@bloomneo/appkit 1.2.9

package/dist/config/defaults.js

@@ -0,0 +1,217 @@
+/**
+ * Smart defaults and environment validation for configuration management
+ * @module @bloomneo/appkit/config
+ * @file src/config/defaults.ts
+ *
+ * @llm-rule WHEN: App startup - need to parse UPPER_SNAKE_CASE environment variables
+ * @llm-rule AVOID: Calling multiple times - expensive parsing, use lazy loading in get()
+ * @llm-rule NOTE: Called once at startup, cached globally for performance
+ */
+/**
+ * Parses a string value to its appropriate type (boolean, number, or string)
+ * @llm-rule WHEN: Processing environment variables that need type conversion
+ * @llm-rule AVOID: Manual string-to-type conversion - this handles edge cases properly
+ * @llm-rule NOTE: Supports "true"/"false" → boolean, numeric strings → number
+ */
+function parseValue(value) {
+    if (typeof value !== 'string')
+        return value;
+    const trimmed = value.trim();
+    // Handle empty strings
+    if (trimmed === '')
+        return '';
+    // Handle booleans
+    const lowerValue = trimmed.toLowerCase();
+    if (lowerValue === 'true')
+        return true;
+    if (lowerValue === 'false')
+        return false;
+    // Handle special values
+    if (lowerValue === 'null')
+        return '';
+    if (lowerValue === 'undefined')
+        return '';
+    // Handle numbers (but not if they start with 0 - could be IDs)
+    if (!trimmed.startsWith('0') && !isNaN(Number(trimmed)) && trimmed !== '') {
+        const num = Number(trimmed);
+        // Only convert if it's a safe integer or decimal
+        if (Number.isSafeInteger(num) || (num % 1 !== 0 && num.toString() === trimmed)) {
+            return num;
+        }
+    }
+    return value;
+}
+/**
+ * Sets a value on a nested object using a dot-notation path
+ * @llm-rule WHEN: Building nested config object from flat environment variables
+ * @llm-rule AVOID: Manual object nesting - this handles deep paths safely
+ */
+function setNestedValue(obj, path, value) {
+    let current = obj;
+    for (let i = 0; i < path.length - 1; i++) {
+        const segment = path[i];
+        if (typeof current[segment] !== 'object' || current[segment] === null) {
+            current[segment] = {};
+        }
+        current = current[segment];
+    }
+    current[path[path.length - 1]] = value;
+}
+/**
+ * Validates the NODE_ENV for common conventions
+ * @llm-rule WHEN: App startup to ensure proper environment configuration
+ * @llm-rule AVOID: Skipping validation - improper NODE_ENV causes subtle bugs
+ */
+function validateEnvironment() {
+    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.`);
+    }
+    // Validate common required variables in production
+    if (nodeEnv === 'production') {
+        const requiredProdVars = ['VOILA_SERVICE_NAME'];
+        const missing = requiredProdVars.filter(varName => !process.env[varName]);
+        if (missing.length > 0) {
+            console.warn(`[VoilaJSX AppKit] Missing recommended production environment variables: ${missing.join(', ')}`);
+        }
+    }
+}
+/**
+ * Check if environment variable is a framework variable that should be ignored
+ * @llm-rule WHEN: Filtering out framework variables from app config parsing
+ * @llm-rule AVOID: Parsing framework variables as app config - they serve different purposes
+ * @llm-rule NOTE: VoilaJSX AppKit uses VOILA_* and FLUX_* for internal configuration
+ */
+function isFrameworkVariable(envKey) {
+    const frameworkPrefixes = [
+        'VOILA_', // VoilaJSX AppKit framework configuration
+        'FLUX_', // Flux Framework internal variables
+        'NODE_', // Node.js environment variables
+        'npm_', // npm variables
+    ];
+    return frameworkPrefixes.some(prefix => envKey.startsWith(prefix));
+}
+/**
+ * Check if environment variable is a system variable that should be ignored
+ * @llm-rule WHEN: Filtering out system variables from app config validation
+ * @llm-rule AVOID: Validating system variables - they don't follow our conventions
+ */
+function isSystemVariable(envKey) {
+    const systemVarPrefixes = [
+        '__CF', // macOS Core Foundation variables
+        '__VERCEL_', // Vercel deployment variables
+        '__NEXT_', // Next.js internal variables
+        '_', // Shell variables starting with underscore
+        'TERM', // Terminal variables
+        'SHELL', // Shell variables
+        'PATH', // System PATH
+        'HOME', // User home directory
+        'USER', // Current user
+        'PWD', // Present working directory
+        'OLDPWD', // Previous working directory
+        'SHLVL', // Shell level
+        'PS1', // Primary prompt string
+        'LANG', // Language settings
+        'LC_', // Locale settings
+        'XDG_', // XDG Base Directory variables
+    ];
+    // Check system variable prefixes
+    if (systemVarPrefixes.some(prefix => envKey.startsWith(prefix))) {
+        return true;
+    }
+    // Check for common system variables
+    const systemVars = [
+        'TMPDIR', 'TMP', 'TEMP',
+        'EDITOR', 'VISUAL',
+        'PAGER', 'LESS',
+        'DISPLAY', 'XAUTHORITY',
+        'SSH_AUTH_SOCK', 'SSH_AGENT_PID',
+        'CONDA_DEFAULT_ENV', 'VIRTUAL_ENV',
+        'JAVA_HOME', 'ANDROID_HOME',
+        'DOCKER_HOST', 'KUBERNETES_SERVICE_HOST',
+        'CI', 'GITHUB_ACTIONS', 'GITLAB_CI', 'JENKINS_URL',
+    ];
+    return systemVars.includes(envKey);
+}
+/**
+ * Validates environment variable format for common mistakes
+ * @llm-rule WHEN: Processing custom environment variables for format validation
+ * @llm-rule AVOID: Silent format errors - validates UPPER_SNAKE_CASE convention
+ */
+function validateEnvVarFormat(envKey) {
+    // Skip framework and system variables - they don't follow our conventions
+    if (isFrameworkVariable(envKey) || isSystemVariable(envKey)) {
+        return true;
+    }
+    // Check for proper UPPER_SNAKE_CASE format
+    if (envKey !== envKey.toUpperCase()) {
+        console.warn(`[VoilaJSX AppKit] Environment variable "${envKey}" should be uppercase for consistency`);
+    }
+    return true;
+}
+/**
+ * Builds the entire configuration object from process.env
+ * @llm-rule WHEN: App startup to get production-ready configuration from environment
+ * @llm-rule AVOID: Calling repeatedly - validates environment each time, expensive operation
+ * @llm-rule NOTE: Called once at startup, cached globally for performance
+ * @llm-rule CONVENTION: Only processes non-framework variables for user config
+ * @llm-rule CONVENTION: Variables with VOILA_* and FLUX_* are AppKit internal
+ */
+export function buildConfigFromEnv() {
+    validateEnvironment();
+    const config = {
+        app: {
+            name: process.env.VOILA_SERVICE_NAME || process.env.npm_package_name || 'voila-app',
+            environment: process.env.NODE_ENV || 'development',
+            port: process.env.PORT ? parseInt(process.env.PORT, 10) : undefined,
+            host: process.env.HOST || undefined,
+        },
+    };
+    // Process ONLY user configuration variables using UPPER_SNAKE_CASE convention
+    // IMPORTANT: Framework variables (VOILA_*, FLUX_*) are NOT processed as user config
+    for (const envKey in process.env) {
+        // Skip framework variables and system variables
+        if (isFrameworkVariable(envKey) || isSystemVariable(envKey)) {
+            continue;
+        }
+        // Process remaining variables as user configuration
+        if (validateEnvVarFormat(envKey)) {
+            const path = envKey.toLowerCase().split('_');
+            const value = parseValue(process.env[envKey] || '');
+            setNestedValue(config, path, value);
+        }
+    }
+    return config;
+}
+/**
+ * Validates critical configuration at startup
+ * @llm-rule WHEN: App startup to ensure required config is present
+ * @llm-rule AVOID: Skipping validation - missing config causes runtime errors
+ * @llm-rule NOTE: Add your app-specific required config here
+ */
+export function validateConfig(config) {
+    const environment = config.app.environment;
+    // Production-specific validations
+    if (environment === 'production') {
+        if (!config.app.name || config.app.name === 'voila-app') {
+            throw new Error('VOILA_SERVICE_NAME is required in production. ' +
+                'Set environment variable: VOILA_SERVICE_NAME=your-app-name');
+        }
+    }
+    // Port validation
+    if (config.app.port && (config.app.port < 1 || config.app.port > 65535)) {
+        throw new Error(`Invalid PORT: ${config.app.port}. Must be between 1 and 65535.`);
+    }
+}
+/**
+ * Gets smart defaults with validation
+ * @llm-rule WHEN: App startup to get production-ready configuration
+ * @llm-rule AVOID: Calling repeatedly - expensive validation, cache the result
+ */
+export function getSmartDefaults() {
+    const config = buildConfigFromEnv();
+    validateConfig(config);
+    return config;
+}
+//# sourceMappingURL=defaults.js.map

package/dist/config/defaults.js.map

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

package/dist/config/index.d.ts

@@ -0,0 +1,105 @@
+/**
+ * Ultra-simple configuration management that just works
+ * @module @bloomneo/appkit/config
+ * @file src/config/index.ts
+ *
+ * @llm-rule WHEN: Building apps that need configuration from environment variables
+ * @llm-rule AVOID: Complex config setups with multiple files - this handles everything automatically
+ * @llm-rule NOTE: Uses UPPER_SNAKE_CASE convention (DATABASE_HOST → config.get('database.host'))
+ * @llm-rule NOTE: Common pattern - configClass.get() → config.get('path', default) → use value
+ *
+ * CRITICAL UNDERSCORE CONVENTION:
+ * - VOILA_* and FLUX_* = Framework internal variables (NOT parsed as app config)
+ * - Everything else = Your app config (parsed into config object)
+ *
+ * Examples:
+ * ✅ VOILA_AUTH_SECRET=secret           → Framework internal (not in config object)
+ * ✅ DATABASE_HOST=localhost            → config.get('database.host')
+ * ✅ REDIS_URL=redis://local            → config.get('redis.url')
+ * ❌ VOILA_DATABASE_HOST=localhost      → Framework var (won't be parsed as app config)
+ */
+import { ConfigClass } from './config.js';
+import { type ConfigValue } from './defaults.js';
+/**
+ * Get configuration instance - the only function you need to learn
+ * Environment variables parsed once for performance
+ * @llm-rule WHEN: Starting any operation that needs configuration - this is your main entry point
+ * @llm-rule AVOID: Calling new ConfigClass() directly - always use this function
+ * @llm-rule NOTE: Typical flow - get() → config.get('path') → use value
+ * @llm-rule NOTE: Only parses non-framework variables for your app config
+ */
+declare function get(overrides?: ConfigValue): ConfigClass;
+/**
+ * Reset global instance (useful for testing or config changes)
+ * @llm-rule WHEN: Testing config logic with different environment variables
+ * @llm-rule AVOID: Using in production - only for tests and development
+ */
+declare function reset(newConfig?: ConfigValue): ConfigClass;
+/**
+ * Clear the cached configuration instance
+ * @llm-rule WHEN: Testing or when you need to reload environment variables
+ * @llm-rule AVOID: Using in production - only for tests and development
+ */
+declare function clearCache(): void;
+/**
+ * Get current environment (development, production, test)
+ * @llm-rule WHEN: Need to conditionally enable features based on environment
+ * @llm-rule AVOID: Checking process.env.NODE_ENV directly - use this for consistency
+ */
+declare function getEnvironment(): string;
+/**
+ * Check if running in development mode
+ * @llm-rule WHEN: Need to enable debug features or detailed logging
+ * @llm-rule AVOID: Manual environment checks - use this for consistency
+ */
+declare function isDevelopment(): boolean;
+/**
+ * Check if running in production mode
+ * @llm-rule WHEN: Need to disable debug features or enable optimizations
+ * @llm-rule AVOID: Manual environment checks - use this for consistency
+ */
+declare function isProduction(): boolean;
+/**
+ * Check if running in test mode
+ * @llm-rule WHEN: Need to enable test-specific behavior
+ * @llm-rule AVOID: Manual environment checks - use this for consistency
+ */
+declare function isTest(): boolean;
+/**
+ * Get all environment variables that follow the UPPER_SNAKE_CASE convention
+ * @llm-rule WHEN: Debugging configuration or documenting available config options
+ * @llm-rule AVOID: Using for runtime config access - use get() instead
+ * @llm-rule NOTE: Only returns non-framework variables - your app config
+ */
+declare function getEnvVars(): Record<string, string>;
+/**
+ * Validate that required configuration paths exist
+ * @llm-rule WHEN: App startup to ensure critical config is present
+ * @llm-rule AVOID: Using in request handlers - expensive validation
+ * @llm-rule NOTE: Throws descriptive errors with environment variable names
+ */
+declare function validateRequired(paths: string[]): void;
+/**
+ * Get configuration for a specific module/feature
+ * @llm-rule WHEN: Module initialization that needs multiple related config values
+ * @llm-rule AVOID: Multiple get() calls - use this for better performance
+ */
+declare function getModuleConfig<T extends Record<string, any>>(modulePrefix: string, defaults?: T): T;
+/**
+ * Single configuration export with enhanced functionality
+ */
+export declare const configClass: {
+    readonly get: typeof get;
+    readonly reset: typeof reset;
+    readonly clearCache: typeof clearCache;
+    readonly getEnvironment: typeof getEnvironment;
+    readonly isDevelopment: typeof isDevelopment;
+    readonly isProduction: typeof isProduction;
+    readonly isTest: typeof isTest;
+    readonly getEnvVars: typeof getEnvVars;
+    readonly validateRequired: typeof validateRequired;
+    readonly getModuleConfig: typeof getModuleConfig;
+};
+export type { ConfigValue, AppConfig } from './defaults.js';
+export { ConfigClass } from './config.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/config/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAoC,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AAKnF;;;;;;;GAOG;AACH,iBAAS,GAAG,CAAC,SAAS,GAAE,WAAgB,GAAG,WAAW,CASrD;AAED;;;;GAIG;AACH,iBAAS,KAAK,CAAC,SAAS,GAAE,WAAgB,GAAG,WAAW,CAKvD;AAED;;;;GAIG;AACH,iBAAS,UAAU,IAAI,IAAI,CAE1B;AAED;;;;GAIG;AACH,iBAAS,cAAc,IAAI,MAAM,CAGhC;AAED;;;;GAIG;AACH,iBAAS,aAAa,IAAI,OAAO,CAEhC;AAED;;;;GAIG;AACH,iBAAS,YAAY,IAAI,OAAO,CAE/B;AAED;;;;GAIG;AACH,iBAAS,MAAM,IAAI,OAAO,CAEzB;AAED;;;;;GAKG;AACH,iBAAS,UAAU,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAe5C;AAED;;;;;GAKG;AACH,iBAAS,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,CAiB/C;AAED;;;;GAIG;AACH,iBAAS,eAAe,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACpD,YAAY,EAAE,MAAM,EACpB,QAAQ,GAAE,CAAW,GACpB,CAAC,CAKH;AAED;;GAEG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;CAgBd,CAAC;AAGX,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC"}

package/dist/config/index.js

@@ -0,0 +1,163 @@
+/**
+ * Ultra-simple configuration management that just works
+ * @module @bloomneo/appkit/config
+ * @file src/config/index.ts
+ *
+ * @llm-rule WHEN: Building apps that need configuration from environment variables
+ * @llm-rule AVOID: Complex config setups with multiple files - this handles everything automatically
+ * @llm-rule NOTE: Uses UPPER_SNAKE_CASE convention (DATABASE_HOST → config.get('database.host'))
+ * @llm-rule NOTE: Common pattern - configClass.get() → config.get('path', default) → use value
+ *
+ * CRITICAL UNDERSCORE CONVENTION:
+ * - VOILA_* and FLUX_* = Framework internal variables (NOT parsed as app config)
+ * - Everything else = Your app config (parsed into config object)
+ *
+ * Examples:
+ * ✅ VOILA_AUTH_SECRET=secret           → Framework internal (not in config object)
+ * ✅ DATABASE_HOST=localhost            → config.get('database.host')
+ * ✅ REDIS_URL=redis://local            → config.get('redis.url')
+ * ❌ VOILA_DATABASE_HOST=localhost      → Framework var (won't be parsed as app config)
+ */
+import { ConfigClass } from './config.js';
+import { getSmartDefaults } from './defaults.js';
+// Global configuration instance for performance
+let globalConfig = null;
+/**
+ * Get configuration instance - the only function you need to learn
+ * Environment variables parsed once for performance
+ * @llm-rule WHEN: Starting any operation that needs configuration - this is your main entry point
+ * @llm-rule AVOID: Calling new ConfigClass() directly - always use this function
+ * @llm-rule NOTE: Typical flow - get() → config.get('path') → use value
+ * @llm-rule NOTE: Only parses non-framework variables for your app config
+ */
+function get(overrides = {}) {
+    // Lazy initialization - parse environment once
+    if (!globalConfig) {
+        const defaults = getSmartDefaults();
+        const finalConfig = { ...defaults, ...overrides };
+        globalConfig = new ConfigClass(finalConfig);
+    }
+    return globalConfig;
+}
+/**
+ * Reset global instance (useful for testing or config changes)
+ * @llm-rule WHEN: Testing config logic with different environment variables
+ * @llm-rule AVOID: Using in production - only for tests and development
+ */
+function reset(newConfig = {}) {
+    const defaults = getSmartDefaults();
+    const finalConfig = { ...defaults, ...newConfig };
+    globalConfig = new ConfigClass(finalConfig);
+    return globalConfig;
+}
+/**
+ * Clear the cached configuration instance
+ * @llm-rule WHEN: Testing or when you need to reload environment variables
+ * @llm-rule AVOID: Using in production - only for tests and development
+ */
+function clearCache() {
+    globalConfig = null;
+}
+/**
+ * Get current environment (development, production, test)
+ * @llm-rule WHEN: Need to conditionally enable features based on environment
+ * @llm-rule AVOID: Checking process.env.NODE_ENV directly - use this for consistency
+ */
+function getEnvironment() {
+    const config = get();
+    return config.get('app.environment', 'development') || 'development';
+}
+/**
+ * Check if running in development mode
+ * @llm-rule WHEN: Need to enable debug features or detailed logging
+ * @llm-rule AVOID: Manual environment checks - use this for consistency
+ */
+function isDevelopment() {
+    return getEnvironment() === 'development';
+}
+/**
+ * Check if running in production mode
+ * @llm-rule WHEN: Need to disable debug features or enable optimizations
+ * @llm-rule AVOID: Manual environment checks - use this for consistency
+ */
+function isProduction() {
+    return getEnvironment() === 'production';
+}
+/**
+ * Check if running in test mode
+ * @llm-rule WHEN: Need to enable test-specific behavior
+ * @llm-rule AVOID: Manual environment checks - use this for consistency
+ */
+function isTest() {
+    return getEnvironment() === 'test';
+}
+/**
+ * Get all environment variables that follow the UPPER_SNAKE_CASE convention
+ * @llm-rule WHEN: Debugging configuration or documenting available config options
+ * @llm-rule AVOID: Using for runtime config access - use get() instead
+ * @llm-rule NOTE: Only returns non-framework variables - your app config
+ */
+function getEnvVars() {
+    const envVars = {};
+    for (const [key, value] of Object.entries(process.env)) {
+        // Skip framework variables - only show app config
+        if (!key.startsWith('VOILA_') &&
+            !key.startsWith('FLUX_') &&
+            !key.startsWith('NODE_') &&
+            !key.startsWith('npm_') &&
+            value !== undefined) {
+            envVars[key] = value;
+        }
+    }
+    return envVars;
+}
+/**
+ * Validate that required configuration paths exist
+ * @llm-rule WHEN: App startup to ensure critical config is present
+ * @llm-rule AVOID: Using in request handlers - expensive validation
+ * @llm-rule NOTE: Throws descriptive errors with environment variable names
+ */
+function validateRequired(paths) {
+    const config = get();
+    const missing = [];
+    for (const path of paths) {
+        if (!config.has(path)) {
+            missing.push(path);
+        }
+    }
+    if (missing.length > 0) {
+        const envVars = missing.map(path => path.split('.').join('_').toUpperCase());
+        throw new Error(`Missing required configuration: ${missing.join(', ')}\n` +
+            `Set environment variables: ${envVars.join(', ')}`);
+    }
+}
+/**
+ * Get configuration for a specific module/feature
+ * @llm-rule WHEN: Module initialization that needs multiple related config values
+ * @llm-rule AVOID: Multiple get() calls - use this for better performance
+ */
+function getModuleConfig(modulePrefix, defaults = {}) {
+    const config = get();
+    const moduleConfig = config.get(modulePrefix, {});
+    return { ...defaults, ...moduleConfig };
+}
+/**
+ * Single configuration export with enhanced functionality
+ */
+export const configClass = {
+    // Core methods
+    get,
+    reset,
+    clearCache,
+    // Environment helpers
+    getEnvironment,
+    isDevelopment,
+    isProduction,
+    isTest,
+    // Utility methods
+    getEnvVars,
+    validateRequired,
+    getModuleConfig,
+};
+export { ConfigClass } from './config.js';
+//# sourceMappingURL=index.js.map

package/dist/config/index.js.map

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

package/dist/database/adapters/mongoose.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Simplified Mongoose adapter with app discovery and tenant middleware
+ * @module @bloomneo/appkit/database
+ * @file src/database/adapters/mongoose.ts
+ *
+ * @llm-rule WHEN: Using Mongoose ODM with MongoDB databases in VoilaJSX framework
+ * @llm-rule AVOID: Using with SQL databases - use prisma adapter instead
+ * @llm-rule NOTE: Auto-discovers apps from /apps directory structure, applies tenant filtering
+ */
+interface MongooseClientConfig {
+    url: string;
+    appName?: string;
+    maxPoolSize?: number;
+    timeout?: number;
+    connectionOptions?: Record<string, any>;
+}
+interface DiscoveredApp {
+    name: string;
+    modelsPath: string;
+}
+interface TenantMiddlewareOptions {
+    fieldName?: string;
+    orgId?: string;
+}
+interface MongooseConnection {
+    db: any;
+    close: () => Promise<void>;
+    model: (name: string, schema?: any, collection?: string) => any;
+    models: Record<string, any>;
+    on: (event: string, callback: (...args: any[]) => void) => void;
+    _appKit?: boolean;
+    _appName?: string;
+    _url?: string;
+    _tenantId?: string;
+    _tenantFiltered?: boolean;
+    [key: string]: any;
+}
+/**
+ * Simplified Mongoose adapter with VoilaJSX app discovery
+ */
+export declare class MongooseAdapter {
+    private options;
+    private connections;
+    private discoveredApps;
+    private isDevelopment;
+    private mongoose;
+    constructor(options?: Record<string, any>);
+    /**
+     * Creates Mongoose connection with app discovery and automatic connection management
+     */
+    createClient(config: MongooseClientConfig): Promise<MongooseConnection>;
+    /**
+     * Apply tenant filtering middleware to Mongoose connection
+     */
+    applyTenantMiddleware(connection: MongooseConnection, tenantId: string, options?: TenantMiddlewareOptions): Promise<MongooseConnection>;
+    /**
+     * Auto-discover VoilaJSX apps with Mongoose models
+     */
+    discoverApps(): Promise<DiscoveredApp[]>;
+    /**
+     * Check if tenant registry collection exists
+     */
+    hasTenantRegistry(connection: MongooseConnection): Promise<boolean>;
+    /**
+     * Create tenant registry entry
+     */
+    createTenantRegistryEntry(connection: MongooseConnection, tenantId: string): Promise<void>;
+    /**
+     * Delete tenant registry entry
+     */
+    deleteTenantRegistryEntry(connection: MongooseConnection, tenantId: string): Promise<void>;
+    /**
+     * Check if tenant exists in registry
+     */
+    tenantExistsInRegistry(connection: MongooseConnection, tenantId: string): Promise<boolean>;
+    /**
+     * Get all tenants from registry
+     */
+    getTenantsFromRegistry(connection: MongooseConnection): Promise<string[]>;
+    /**
+     * Disconnect all cached connections
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Detect current app from file path (VoilaJSX structure)
+     */
+    private _detectCurrentApp;
+    /**
+     * Find apps directory in project structure
+     */
+    private _findAppsDirectory;
+    /**
+     * Load models for specific app
+     */
+    private _loadModelsForApp;
+    /**
+     * Setup connection event handlers
+     */
+    private _setupConnectionEvents;
+    /**
+     * Mask URL for logging (hide credentials)
+     */
+    private _maskUrl;
+}
+export {};
+//# sourceMappingURL=mongoose.d.ts.map

package/dist/database/adapters/mongoose.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mongoose.d.ts","sourceRoot":"","sources":["../../../src/database/adapters/mongoose.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,UAAU,oBAAoB;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CACzC;AAED,UAAU,aAAa;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,UAAU,uBAAuB;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,kBAAkB;IAC1B,EAAE,EAAE,GAAG,CAAC;IACR,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,EAAE,UAAU,CAAC,EAAE,MAAM,KAAK,GAAG,CAAC;IAChE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC5B,EAAE,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,KAAK,IAAI,CAAC;IAChE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,OAAO,CAAsB;IACrC,OAAO,CAAC,WAAW,CAAkC;IACrD,OAAO,CAAC,cAAc,CAAyB;IAC/C,OAAO,CAAC,aAAa,CAAU;IAC/B,OAAO,CAAC,QAAQ,CAAM;gBAEV,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM;IAY7C;;OAEG;IACG,YAAY,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAuD7E;;OAEG;IACG,qBAAqB,CACzB,UAAU,EAAE,kBAAkB,EAC9B,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,kBAAkB,CAAC;IA4H9B;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;IAiE9C;;OAEG;IACG,iBAAiB,CAAC,UAAU,EAAE,kBAAkB,GAAG,OAAO,CAAC,OAAO,CAAC;IAczE;;OAEG;IACG,yBAAyB,CAAC,UAAU,EAAE,kBAAkB,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBhG;;OAEG;IACG,yBAAyB,CAAC,UAAU,EAAE,kBAAkB,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWhG;;OAEG;IACG,sBAAsB,CAAC,UAAU,EAAE,kBAAkB,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAUhG;;OAEG;IACG,sBAAsB,CAAC,UAAU,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAmB/E;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAuBjC;;OAEG;YACW,iBAAiB;IAmC/B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAsB1B;;OAEG;YACW,iBAAiB;IA0C/B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAwB9B;;OAEG;IACH,OAAO,CAAC,QAAQ;CAQjB"}