@bloomneo/appkit 1.2.9

package/dist/database/defaults.js

@@ -0,0 +1,271 @@
+/**
+ * Simplified defaults and validation for AppKit Database
+ * Environment-driven configuration with smart detection
+ *
+ * Required Environment Variables:
+ * - DATABASE_URL: Database connection string
+ *
+ * Optional Environment Variables:
+ * - VOILA_DB_TENANT: Enable tenant mode (auto/true/false)
+ * - ORG_{NAME}: Organization-specific database URLs
+ *
+ * @module @bloomneo/appkit/database
+ * @file src/database/defaults.js
+ *
+ * @llm-rule WHEN: App startup - need to validate database environment configuration
+ * @llm-rule AVOID: Calling multiple times - expensive validation, use once at startup
+ * @llm-rule NOTE: All tenant tables MUST have tenant_id text field (nullable)
+ */
+export function validateTenantId(tenantId) {
+    return typeof tenantId === 'string' && /^[a-zA-Z0-9_-]+$/.test(tenantId) && tenantId.length <= 63;
+}
+export function validateOrgId(orgId) {
+    return typeof orgId === 'string' && /^[a-zA-Z0-9_-]+$/.test(orgId) && orgId.length <= 63;
+}
+export function validateDatabaseUrl(url) {
+    if (!url || typeof url !== 'string')
+        return false;
+    if (!url.includes('://'))
+        return false;
+    if (url.includes('..') || url.includes('<') || url.includes('>'))
+        return false;
+    return [
+        'postgresql://', 'postgres://', 'mysql://',
+        'mongodb://', 'mongodb+srv://', 'sqlite://'
+    ].some(protocol => url.startsWith(protocol));
+}
+class DatabaseError extends Error {
+    statusCode;
+    details; // or use a more specific type like `Record<string, any>`
+    constructor(message, statusCode = 500, details = null) {
+        super(message);
+        this.name = 'DatabaseError';
+        this.statusCode = statusCode;
+        this.details = details;
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, DatabaseError);
+        }
+    }
+}
+export function createDatabaseError(message, statusCode = 500, details = null) {
+    return new DatabaseError(message, statusCode, details);
+}
+export function detectProvider(url) {
+    if (!url)
+        return 'unknown';
+    if (url.includes('postgresql://') || url.includes('postgres://'))
+        return 'postgresql';
+    if (url.includes('mysql://'))
+        return 'mysql';
+    if (url.includes('mongodb://') || url.includes('mongodb+srv://'))
+        return 'mongodb';
+    if (url.includes('sqlite://'))
+        return 'sqlite';
+    return 'unknown';
+}
+export function detectAdapter(url) {
+    const provider = detectProvider(url);
+    if (provider === 'mongodb')
+        return 'mongoose';
+    return 'prisma';
+}
+export function sanitizeDatabaseName(name) {
+    if (!name || typeof name !== 'string') {
+        throw createDatabaseError('Database name must be a non-empty string', 400);
+    }
+    return name.toLowerCase().replace(/[^a-z0-9_-]/g, '_');
+}
+export function getOrgEnvironmentVars() {
+    const orgVars = {};
+    Object.keys(process.env).forEach(key => {
+        if (key.startsWith('ORG_') && key !== 'ORG_') {
+            const orgId = key.replace('ORG_', '').toLowerCase();
+            const url = process.env[key];
+            if (url && validateDatabaseUrl(url)) {
+                orgVars[orgId] = url;
+            }
+            else {
+                console.warn(`Invalid database URL for organization '${orgId}': ${url}`);
+            }
+        }
+    });
+    return orgVars;
+}
+export function validateEnvironment() {
+    const errors = [];
+    const warnings = [];
+    const config = {
+        valid: true,
+        errors,
+        warnings,
+        hasDatabase: false,
+        hasTenants: false,
+        hasOrgs: false,
+        orgCount: 0,
+    };
+    const databaseUrl = process.env.DATABASE_URL;
+    if (!databaseUrl) {
+        errors.push('DATABASE_URL environment variable is required');
+    }
+    else if (!validateDatabaseUrl(databaseUrl)) {
+        errors.push(`Invalid DATABASE_URL format: ${databaseUrl}`);
+    }
+    else {
+        config.hasDatabase = true;
+    }
+    const tenantMode = process.env.VOILA_DB_TENANT;
+    if (tenantMode) {
+        const mode = tenantMode.toLowerCase();
+        if (['true', 'auto'].includes(mode)) {
+            config.hasTenants = true;
+        }
+        else if (mode !== 'false') {
+            warnings.push(`Unknown VOILA_DB_TENANT value: ${tenantMode}. Use 'auto', 'true', or 'false'`);
+        }
+    }
+    const orgVars = getOrgEnvironmentVars();
+    config.orgCount = Object.keys(orgVars).length;
+    config.hasOrgs = config.orgCount > 0;
+    Object.keys(orgVars).forEach(orgId => {
+        if (!validateOrgId(orgId)) {
+            warnings.push(`Invalid organization ID format: ${orgId}`);
+        }
+    });
+    const nodeEnv = process.env.NODE_ENV;
+    if (!nodeEnv) {
+        warnings.push('NODE_ENV not set. Defaulting to development mode');
+    }
+    else if (!['development', 'production', 'test'].includes(nodeEnv)) {
+        warnings.push(`Unusual NODE_ENV value: ${nodeEnv}`);
+    }
+    if (config.hasTenants && !config.hasDatabase) {
+        errors.push('Tenant mode enabled but no valid DATABASE_URL found');
+    }
+    if (config.hasOrgs && config.orgCount > 10) {
+        warnings.push(`Large number of organizations configured (${config.orgCount}). Consider using dynamic URL resolution`);
+    }
+    config.valid = errors.length === 0;
+    return config;
+}
+export function getSmartDefaults() {
+    const isDevelopment = process.env.NODE_ENV === 'development';
+    const isProduction = process.env.NODE_ENV === 'production';
+    const validation = validateEnvironment();
+    if (isDevelopment && validation.warnings.length > 0) {
+        console.warn('⚠️  [AppKit] Database configuration warnings:');
+        validation.warnings.forEach((w) => console.warn(`   ${w}`));
+    }
+    if (!validation.valid) {
+        throw createDatabaseError(`Database configuration errors:\n${validation.errors.join('\n')}`, 500, { validation });
+    }
+    return {
+        database: {
+            url: process.env.DATABASE_URL || '',
+            provider: detectProvider(process.env.DATABASE_URL || ''),
+            adapter: detectAdapter(process.env.DATABASE_URL || ''),
+        },
+        tenant: {
+            enabled: validation.hasTenants,
+            mode: process.env.VOILA_DB_TENANT?.toLowerCase() || 'false',
+            fieldName: 'tenant_id',
+        },
+        org: {
+            enabled: validation.hasOrgs,
+            count: validation.orgCount,
+            urls: getOrgEnvironmentVars(),
+        },
+        environment: {
+            isDevelopment,
+            isProduction,
+            nodeEnv: process.env.NODE_ENV || 'development',
+        },
+        validation,
+    };
+}
+export async function validateSchema(client, requiredField = 'tenant_id') {
+    if (process.env.NODE_ENV !== 'development')
+        return { valid: true, warnings: [] };
+    const warnings = [];
+    try {
+        if (client.$queryRaw) {
+            const models = Object.keys(client).filter(key => typeof client[key] === 'object' && typeof client[key].findFirst === 'function');
+            for (const model of models) {
+                try {
+                    await client[model].findFirst({ where: { [requiredField]: null }, take: 1 });
+                }
+                catch (e) {
+                    if (e.message.includes(requiredField)) {
+                        warnings.push(`Prisma model '${model}' missing field '${requiredField}'`);
+                    }
+                }
+            }
+        }
+        else if (client.models) {
+            const models = Object.keys(client.models);
+            for (const modelName of models) {
+                const model = client.models[modelName];
+                if (!model.schema.paths[requiredField]) {
+                    warnings.push(`Mongoose model '${modelName}' missing field '${requiredField}'`);
+                }
+            }
+        }
+        return { valid: warnings.length === 0, warnings };
+    }
+    catch (error) {
+        return { valid: false, warnings: [`Schema validation failed: ${error.message}`] };
+    }
+}
+export function formatBytes(bytes) {
+    if (bytes === 0)
+        return '0 B';
+    const k = 1024;
+    const sizes = ['B', 'KB', 'MB', 'GB', 'TB'];
+    const i = Math.floor(Math.log(bytes) / Math.log(k));
+    return `${parseFloat((bytes / Math.pow(k, i)).toFixed(2))} ${sizes[i]}`;
+}
+export function maskUrl(url) {
+    if (!url || typeof url !== 'string')
+        return '[invalid-url]';
+    try {
+        return url.replace(/:\/\/[^@]*@/, '://***:***@');
+    }
+    catch {
+        return '[masked-url]';
+    }
+}
+export function getConfigSummary() {
+    const config = getSmartDefaults();
+    return {
+        database: {
+            provider: config.database.provider,
+            adapter: config.database.adapter,
+            url: maskUrl(config.database.url || ''),
+        },
+        tenant: {
+            enabled: config.tenant.enabled,
+            mode: config.tenant.mode,
+        },
+        org: {
+            enabled: config.org.enabled,
+            count: config.org.count,
+            organizations: Object.keys(config.org.urls),
+        },
+        environment: config.environment.nodeEnv,
+        validation: {
+            valid: config.validation.valid,
+            warningCount: config.validation.warnings.length,
+            errorCount: config.validation.errors.length,
+        },
+    };
+}
+let cachedValidation = null;
+export function getCachedValidation() {
+    if (!cachedValidation) {
+        cachedValidation = validateEnvironment();
+    }
+    return cachedValidation;
+}
+export function clearValidationCache() {
+    cachedValidation = null;
+}
+//# sourceMappingURL=defaults.js.map

package/dist/database/defaults.js.map

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

package/dist/database/index.d.ts

@@ -0,0 +1,137 @@
+/**
+ * Ultra-simple database API with org/tenant support and smart connection management
+ * @module @bloomneo/appkit/database
+ * @file src/database/index.ts
+ *
+ * @llm-rule WHEN: ALWAYS add tenant_id text field to ALL tables (nullable for future compatibility)
+ * @llm-rule NOTE: tenant_id = null (single tenant) or "team-1" (multi-tenant)
+ * @llm-rule VARIABLE: const db = await databaseClass.get() - user's data (single or tenant-filtered)
+ * @llm-rule VARIABLE: const dbTenants = await databaseClass.getTenants() - all tenants (admin access)
+ * @llm-rule VARIABLE: const {orgName}Db = await databaseClass.org('{orgName}').get() - org-specific data
+ * @llm-rule VARIABLE: const {orgName}DbTenants = await databaseClass.org('{orgName}').getTenants() - all tenants in org
+ */
+interface DatabaseClient {
+    _appKit?: boolean;
+    _orgId?: string;
+    _tenantId?: string;
+    _url?: string;
+    [key: string]: any;
+}
+interface PrismaClient extends DatabaseClient {
+    $queryRaw?: any;
+    $disconnect: () => Promise<void>;
+    $connect: () => Promise<void>;
+    $use?: (middleware: any) => void;
+}
+interface MongooseConnection extends DatabaseClient {
+    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;
+}
+type DatabaseClientUnion = PrismaClient | MongooseConnection;
+/**
+ * Organization database builder
+ */
+declare class OrgDatabase {
+    private orgId;
+    constructor(orgId: string);
+    /**
+     * Get organization database (tenant-filtered if tenant mode enabled)
+     */
+    get(req?: any): Promise<DatabaseClientUnion>;
+    /**
+     * Get all tenants in organization (admin access)
+     */
+    getTenants(req?: any): Promise<DatabaseClientUnion>;
+}
+/**
+ * Main database API - ultra-simple like auth module
+ */
+export declare const databaseClass: {
+    /**
+     * Get database client - main function that handles all contexts
+     * @param {Object} [req] - Request object for context detection
+     * @returns {Promise<DatabaseClientUnion>} Database client
+     */
+    get(req?: any): Promise<DatabaseClientUnion>;
+    /**
+     * Get all tenants data (admin access - no tenant filtering)
+     * @param {Object} [req] - Request object for org context
+     * @returns {Promise<DatabaseClientUnion>} Database client with no tenant filtering
+     */
+    getTenants(req?: any): Promise<DatabaseClientUnion>;
+    /**
+     * Get organization-specific database
+     * @param {string} orgId - Organization ID
+     * @returns {OrgDatabase} Organization database instance
+     */
+    org(orgId: string): OrgDatabase;
+    /**
+     * Health check for database connections
+     * @returns {Promise<Object>} Health status
+     */
+    health(): Promise<any>;
+    /**
+     * List tenants in current context
+     * @param {Object} [req] - Request object for org context
+     * @returns {Promise<string[]>} Array of tenant IDs
+     */
+    list(req?: any): Promise<string[]>;
+    /**
+     * Check if tenant exists
+     * @param {string} tenantId - Tenant ID
+     * @param {Object} [req] - Request object for org context
+     * @returns {Promise<boolean>} Whether tenant exists
+     */
+    exists(tenantId: string, req?: any): Promise<boolean>;
+    /**
+     * Create tenant (registers tenant for future use)
+     * @param {string} tenantId - Tenant ID
+     * @param {Object} [req] - Request object for org context
+     * @returns {Promise<void>}
+     */
+    create(tenantId: string, req?: any): Promise<void>;
+    /**
+     * Delete all tenant data (requires confirmation)
+     * @param {string} tenantId - Tenant ID
+     * @param {Object} options - Options object
+     * @param {boolean} options.confirm - Confirmation flag (required)
+     * @param {Object} [req] - Request object for org context
+     * @returns {Promise<void>}
+     */
+    delete(tenantId: string, options: any, req?: any): Promise<void>;
+    /**
+     * Disconnect all connections and cleanup
+     * @returns {Promise<void>}
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Get distinct tenant IDs from database
+     * @private
+     */
+    _getDistinctTenantIds(client: any): Promise<string[]>;
+    /**
+     * Check if tenant has data
+     * @private
+     */
+    _tenantHasData(client: any, tenantId: string): Promise<boolean>;
+    /**
+     * Delete all tenant data
+     * @private
+     */
+    _deleteAllTenantData(client: any, tenantId: string): Promise<void>;
+    /**
+     * Clear tenant-specific cached connections
+     * @private
+     */
+    _clearTenantCache(tenantId: string): void;
+    /**
+     * Close database connection
+     * @private
+     */
+    _closeConnection(connection: any): Promise<void>;
+};
+export default databaseClass;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/database/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAOH,UAAU,cAAc;IACtB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED,UAAU,YAAa,SAAQ,cAAc;IAC3C,SAAS,CAAC,EAAE,GAAG,CAAC;IAChB,WAAW,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9B,IAAI,CAAC,EAAE,CAAC,UAAU,EAAE,GAAG,KAAK,IAAI,CAAC;CAClC;AAED,UAAU,kBAAmB,SAAQ,cAAc;IACjD,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;CACjE;AAED,KAAK,mBAAmB,GAAG,YAAY,GAAG,kBAAkB,CAAC;AA2K7D;;GAEG;AACH,cAAM,WAAW;IAEf,OAAO,CAAC,KAAK,CAAS;gBACV,KAAK,EAAE,MAAM;IAIzB;;OAEG;IACG,GAAG,CAAC,GAAG,GAAE,GAAU;IAWzB;;OAEG;IACG,UAAU,CAAC,GAAG,GAAE,GAAU;CAUjC;AAED;;GAEG;AACH,eAAO,MAAM,aAAa;IACxB;;;;OAIG;cACY,GAAG,GAAU,OAAO,CAAC,mBAAmB,CAAC;IAoBxD;;;;OAIG;qBACmB,GAAG,GAAU,OAAO,CAAC,mBAAmB,CAAC;IAgB/D;;;;OAIG;eACQ,MAAM;IAQjB;;;OAGG;cACa,OAAO,CAAC,GAAG,CAAC;IA4B5B;;;;OAIG;eACa,GAAG,GAAU,OAAO,CAAC,MAAM,EAAE,CAAC;IAS9C;;;;;OAKG;qBACoB,MAAM,QAAO,GAAG,GAAU,OAAO,CAAC,OAAO,CAAC;IAWjE;;;;;OAKG;qBACoB,MAAM,QAAO,GAAG,GAAU,OAAO,CAAC,IAAI,CAAC;IAgB9D;;;;;;;OAOG;qBACoB,MAAM,WAAW,GAAG,QAAO,GAAG,GAAU,OAAO,CAAC,IAAI,CAAC;IAkB5E;;;OAGG;kBACiB,OAAO,CAAC,IAAI,CAAC;IAsBjC;;;OAGG;kCACiC,GAAG,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAsC3D;;;OAGG;2BAC0B,GAAG,YAAY,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IA8BrE;;;OAGG;iCACgC,GAAG,YAAY,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAmCxE;;;OAGG;gCACyB,MAAM,GAAG,IAAI;IAkBzC;;;OAGG;iCACgC,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;CAWvD,CAAC;AAGF,eAAe,aAAa,CAAC"}