@xbg.solutions/backend-core 1.0.0

package/lib/core/src/config/auth.config.js

@@ -0,0 +1,88 @@
+"use strict";
+/**
+ * Authentication Configuration
+ * JWT and auth provider settings
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AUTH_CONFIG = void 0;
+exports.getEnabledAuthProvider = getEnabledAuthProvider;
+exports.validateAuthConfig = validateAuthConfig;
+exports.AUTH_CONFIG = {
+    jwt: {
+        issuer: process.env.JWT_ISSUER || 'backend-boilerplate',
+        audience: process.env.JWT_AUDIENCE || 'backend-boilerplate-api',
+        expiresIn: process.env.JWT_EXPIRES_IN || '1h',
+        refreshTokenExpiresIn: process.env.JWT_REFRESH_EXPIRES_IN || '7d',
+    },
+    providers: {
+        firebase: {
+            enabled: true,
+            projectId: process.env.FIREBASE_PROJECT_ID,
+        },
+        auth0: {
+            enabled: !!process.env.AUTH0_DOMAIN,
+            domain: process.env.AUTH0_DOMAIN,
+            clientId: process.env.AUTH0_CLIENT_ID,
+            clientSecret: process.env.AUTH0_CLIENT_SECRET,
+        },
+        clerk: {
+            enabled: !!process.env.CLERK_API_KEY,
+            apiKey: process.env.CLERK_API_KEY,
+        },
+    },
+    blacklist: {
+        enabled: process.env.TOKEN_BLACKLIST_ENABLED !== 'false',
+        cleanupIntervalMs: parseInt(process.env.TOKEN_BLACKLIST_CLEANUP_INTERVAL || '3600000', 10), // 1 hour
+        retentionDays: parseInt(process.env.TOKEN_BLACKLIST_RETENTION_DAYS || '30', 10),
+    },
+    session: {
+        maxConcurrentSessions: parseInt(process.env.MAX_CONCURRENT_SESSIONS || '5', 10),
+        slidingExpiration: process.env.SLIDING_EXPIRATION !== 'false',
+    },
+    security: {
+        requireEmailVerification: process.env.REQUIRE_EMAIL_VERIFICATION === 'true',
+        requireMFA: process.env.REQUIRE_MFA === 'true',
+        passwordMinLength: parseInt(process.env.PASSWORD_MIN_LENGTH || '8', 10),
+        maxLoginAttempts: parseInt(process.env.MAX_LOGIN_ATTEMPTS || '5', 10),
+        lockoutDurationMinutes: parseInt(process.env.LOCKOUT_DURATION_MINUTES || '15', 10),
+    },
+};
+/**
+ * Get enabled auth provider
+ */
+function getEnabledAuthProvider() {
+    var _a, _b;
+    if (exports.AUTH_CONFIG.providers.firebase.enabled)
+        return 'firebase';
+    if ((_a = exports.AUTH_CONFIG.providers.auth0) === null || _a === void 0 ? void 0 : _a.enabled)
+        return 'auth0';
+    if ((_b = exports.AUTH_CONFIG.providers.clerk) === null || _b === void 0 ? void 0 : _b.enabled)
+        return 'clerk';
+    return null;
+}
+/**
+ * Validate auth configuration
+ */
+function validateAuthConfig() {
+    var _a;
+    const errors = [];
+    const enabledProvider = getEnabledAuthProvider();
+    if (!enabledProvider) {
+        errors.push('At least one auth provider must be enabled');
+    }
+    if (exports.AUTH_CONFIG.providers.firebase.enabled && !exports.AUTH_CONFIG.providers.firebase.projectId) {
+        errors.push('FIREBASE_PROJECT_ID is required when Firebase auth is enabled');
+    }
+    if ((_a = exports.AUTH_CONFIG.providers.auth0) === null || _a === void 0 ? void 0 : _a.enabled) {
+        if (!exports.AUTH_CONFIG.providers.auth0.domain) {
+            errors.push('AUTH0_DOMAIN is required when Auth0 is enabled');
+        }
+        if (!exports.AUTH_CONFIG.providers.auth0.clientId) {
+            errors.push('AUTH0_CLIENT_ID is required when Auth0 is enabled');
+        }
+    }
+    if (errors.length > 0) {
+        throw new Error(`Auth configuration validation failed:\n${errors.join('\n')}`);
+    }
+}
+//# sourceMappingURL=auth.config.js.map

package/lib/core/src/config/auth.config.js.map

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

package/lib/core/src/config/cache.config.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Cache Configuration
+ *
+ * Multi-level caching configuration for the application.
+ *
+ * Configuration Hierarchy:
+ * 1. Global Project Config (Master Switch)
+ * 2. Repository-Level Config (Per-Entity)
+ * 3. Method-Level Options (Runtime)
+ *
+ * Usage:
+ * - Set CACHE_ENABLED=true to enable caching globally
+ * - Configure default provider and TTL
+ * - Individual repositories can opt-in and choose their provider
+ */
+import { CacheConfig, CacheProviderType } from '@xbg/utils-cache-connector';
+/**
+ * Global cache configuration
+ *
+ * Master Configuration:
+ * - enabled: Master switch - if false, all caching is disabled
+ * - defaultProvider: Default cache provider for repositories
+ * - defaultTTL: Default time-to-live in seconds
+ * - namespace: Cache key namespace for versioning
+ */
+export declare const CACHE_CONFIG: CacheConfig;
+/**
+ * Validate cache configuration
+ */
+export declare function validateCacheConfig(): void;
+/**
+ * Check if caching is enabled
+ */
+export declare function isCacheEnabled(): boolean;
+/**
+ * Get cache namespace
+ */
+export declare function getCacheNamespace(): string;
+/**
+ * Get default cache TTL
+ */
+export declare function getDefaultCacheTTL(): number;
+/**
+ * Get default cache provider
+ */
+export declare function getDefaultCacheProvider(): CacheProviderType;
+//# sourceMappingURL=cache.config.d.ts.map

package/lib/core/src/config/cache.config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.config.d.ts","sourceRoot":"","sources":["../../../../src/config/cache.config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EACL,WAAW,EACX,iBAAiB,EAIlB,MAAM,4BAA4B,CAAC;AAEpC;;;;;;;;GAQG;AACH,eAAO,MAAM,YAAY,EAAE,WA+H1B,CAAC;AAEF;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CA2D1C;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,OAAO,CAExC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,iBAAiB,CAE3D"}

package/lib/core/src/config/cache.config.js

@@ -0,0 +1,225 @@
+"use strict";
+/**
+ * Cache Configuration
+ *
+ * Multi-level caching configuration for the application.
+ *
+ * Configuration Hierarchy:
+ * 1. Global Project Config (Master Switch)
+ * 2. Repository-Level Config (Per-Entity)
+ * 3. Method-Level Options (Runtime)
+ *
+ * Usage:
+ * - Set CACHE_ENABLED=true to enable caching globally
+ * - Configure default provider and TTL
+ * - Individual repositories can opt-in and choose their provider
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CACHE_CONFIG = void 0;
+exports.validateCacheConfig = validateCacheConfig;
+exports.isCacheEnabled = isCacheEnabled;
+exports.getCacheNamespace = getCacheNamespace;
+exports.getDefaultCacheTTL = getDefaultCacheTTL;
+exports.getDefaultCacheProvider = getDefaultCacheProvider;
+/**
+ * Global cache configuration
+ *
+ * Master Configuration:
+ * - enabled: Master switch - if false, all caching is disabled
+ * - defaultProvider: Default cache provider for repositories
+ * - defaultTTL: Default time-to-live in seconds
+ * - namespace: Cache key namespace for versioning
+ */
+exports.CACHE_CONFIG = {
+    /**
+     * Master switch - set to 'true' to enable caching globally
+     * Default: false (caching disabled for new projects)
+     */
+    enabled: process.env.CACHE_ENABLED === 'true',
+    /**
+     * Default provider for repositories that don't specify
+     * Options: 'memory', 'firestore', 'redis'
+     * Default: 'memory'
+     */
+    defaultProvider: process.env.CACHE_DEFAULT_PROVIDER || 'memory',
+    /**
+     * Default TTL in seconds (300 = 5 minutes)
+     */
+    defaultTTL: parseInt(process.env.CACHE_DEFAULT_TTL || '300', 10),
+    /**
+     * Cache namespace for versioning
+     * Change this to invalidate all cached data
+     * Default: 'v1'
+     */
+    namespace: process.env.CACHE_NAMESPACE || 'v1',
+    /**
+     * Provider-specific configurations
+     */
+    providers: {
+        /**
+         * Memory Cache Provider Configuration
+         *
+         * Best for:
+         * - Request-scoped caching
+         * - Hot data within a single function instance
+         * - Auth/permissions data
+         * - Configuration values
+         *
+         * Limitations:
+         * - Not shared across function instances
+         * - Lost on cold starts
+         * - Limited by instance memory
+         */
+        memory: {
+            /**
+             * Maximum cache size in bytes
+             * Default: 100MB
+             */
+            maxSize: parseInt(process.env.CACHE_MEMORY_MAX_SIZE_MB || '100', 10) * 1024 * 1024,
+            /**
+             * Cleanup check period in seconds
+             * Default: 60 seconds
+             */
+            checkPeriod: parseInt(process.env.CACHE_MEMORY_CHECK_PERIOD || '60', 10),
+            /**
+             * Whether to clone values (prevents mutations)
+             * Default: false (better performance)
+             */
+            useClones: process.env.CACHE_MEMORY_USE_CLONES === 'true',
+        },
+        /**
+         * Firestore Cache Provider Configuration
+         *
+         * Best for:
+         * - Medium-traffic repositories
+         * - Data shared across function instances
+         * - Cache data that should survive cold starts
+         *
+         * Trade-offs:
+         * - Latency: ~50-100ms (vs memory ~1-5ms)
+         * - Cost: Firestore read/write operations
+         * - Size limit: 1MB per document
+         */
+        firestore: {
+            /**
+             * Database to use for cache storage
+             * Default: 'main'
+             */
+            database: process.env.CACHE_FIRESTORE_DATABASE || 'main',
+            /**
+             * Collection name for cache entries
+             * Default: '_cache'
+             */
+            collection: process.env.CACHE_FIRESTORE_COLLECTION || '_cache',
+            /**
+             * Enable automatic cleanup of expired entries
+             * Default: true
+             */
+            enableCleanup: process.env.CACHE_FIRESTORE_ENABLE_CLEANUP !== 'false',
+            /**
+             * Cleanup interval in seconds
+             * Default: 3600 (1 hour)
+             */
+            cleanupInterval: parseInt(process.env.CACHE_FIRESTORE_CLEANUP_INTERVAL || '3600', 10),
+        },
+        /**
+         * Redis Cache Provider Configuration (Optional)
+         *
+         * Best for:
+         * - High-traffic applications (>1M requests/month)
+         * - Sub-10ms response time requirements
+         * - Cache sizes exceeding Firestore limits
+         * - Advanced features (pub/sub, sorted sets)
+         *
+         * Cost: ~$50/month minimum (Google Cloud Memorystore)
+         *
+         * Note: Only configured if CACHE_REDIS_HOST is set
+         */
+        redis: process.env.CACHE_REDIS_HOST
+            ? {
+                host: process.env.CACHE_REDIS_HOST,
+                port: parseInt(process.env.CACHE_REDIS_PORT || '6379', 10),
+                password: process.env.CACHE_REDIS_PASSWORD,
+                db: parseInt(process.env.CACHE_REDIS_DB || '0', 10),
+                connectTimeout: parseInt(process.env.CACHE_REDIS_CONNECT_TIMEOUT || '5000', 10),
+                tls: process.env.CACHE_REDIS_TLS === 'true',
+            }
+            : undefined,
+    },
+};
+/**
+ * Validate cache configuration
+ */
+function validateCacheConfig() {
+    const errors = [];
+    // Validate default provider
+    const validProviders = ['memory', 'firestore', 'redis', 'noop'];
+    if (!validProviders.includes(exports.CACHE_CONFIG.defaultProvider)) {
+        errors.push(`Invalid default provider: ${exports.CACHE_CONFIG.defaultProvider}`);
+    }
+    // Validate default TTL
+    if (exports.CACHE_CONFIG.defaultTTL <= 0) {
+        errors.push('Default TTL must be greater than 0');
+    }
+    // Validate namespace
+    if (!exports.CACHE_CONFIG.namespace || exports.CACHE_CONFIG.namespace.trim() === '') {
+        errors.push('Cache namespace is required');
+    }
+    // Validate memory provider config
+    if (exports.CACHE_CONFIG.providers.memory.maxSize <= 0) {
+        errors.push('Memory cache max size must be greater than 0');
+    }
+    if (exports.CACHE_CONFIG.providers.memory.checkPeriod <= 0) {
+        errors.push('Memory cache check period must be greater than 0');
+    }
+    // Validate firestore provider config
+    if (!exports.CACHE_CONFIG.providers.firestore.database) {
+        errors.push('Firestore cache database is required');
+    }
+    if (!exports.CACHE_CONFIG.providers.firestore.collection) {
+        errors.push('Firestore cache collection is required');
+    }
+    if (exports.CACHE_CONFIG.providers.firestore.cleanupInterval <= 0) {
+        errors.push('Firestore cache cleanup interval must be greater than 0');
+    }
+    // Validate redis provider config if configured
+    if (exports.CACHE_CONFIG.providers.redis) {
+        if (!exports.CACHE_CONFIG.providers.redis.host) {
+            errors.push('Redis host is required when Redis is configured');
+        }
+        if (exports.CACHE_CONFIG.providers.redis.port <= 0 || exports.CACHE_CONFIG.providers.redis.port > 65535) {
+            errors.push('Redis port must be between 1 and 65535');
+        }
+        if (exports.CACHE_CONFIG.providers.redis.db < 0) {
+            errors.push('Redis database number must be >= 0');
+        }
+    }
+    if (errors.length > 0) {
+        throw new Error(`Cache configuration validation failed:\n${errors.join('\n')}`);
+    }
+}
+/**
+ * Check if caching is enabled
+ */
+function isCacheEnabled() {
+    return exports.CACHE_CONFIG.enabled;
+}
+/**
+ * Get cache namespace
+ */
+function getCacheNamespace() {
+    return exports.CACHE_CONFIG.namespace;
+}
+/**
+ * Get default cache TTL
+ */
+function getDefaultCacheTTL() {
+    return exports.CACHE_CONFIG.defaultTTL;
+}
+/**
+ * Get default cache provider
+ */
+function getDefaultCacheProvider() {
+    return exports.CACHE_CONFIG.defaultProvider;
+}
+//# sourceMappingURL=cache.config.js.map

package/lib/core/src/config/cache.config.js.map

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

package/lib/core/src/config/communications.config.d.ts

@@ -0,0 +1,175 @@
+/**
+ * Communications Configuration
+ * Settings for Email, SMS, CRM, Realtime, Push Notifications, Journeys, ERP, Work Management, Survey, and Document integrations
+ */
+export interface CommunicationsConfig {
+    email: EmailConfig;
+    sms: SMSConfig;
+    crm: CRMConfig;
+    realtime: RealtimeConfig;
+    pushNotifications: PushNotificationsConfig;
+    journey: JourneyConfig;
+    erp: ERPConfig;
+    workManagement: WorkManagementConfig;
+    survey: SurveyConfig;
+    document: DocumentConfig;
+}
+export interface EmailConfig {
+    enabled: boolean;
+    provider: 'mailjet' | 'ortto';
+    fromAddress: string;
+    fromName: string;
+    providers: {
+        mailjet?: {
+            apiKey: string;
+            secretKey: string;
+        };
+        ortto?: {
+            apiKey: string;
+            region?: string;
+        };
+    };
+    defaults: {
+        replyTo?: string;
+        trackOpens: boolean;
+        trackClicks: boolean;
+    };
+}
+export interface SMSConfig {
+    enabled: boolean;
+    provider: 'twilio' | 'messagebird';
+    providers: {
+        twilio?: {
+            accountSid: string;
+            authToken: string;
+            fromNumber: string;
+        };
+        messagebird?: {
+            apiKey: string;
+            originator: string;
+            fromNumber: string;
+        };
+    };
+    defaults: {
+        validityPeriod: number;
+        enableDeliveryReports: boolean;
+    };
+}
+export interface CRMConfig {
+    enabled: boolean;
+    provider: 'hubspot' | 'salesforce' | 'attio';
+    syncOnEvents: string[];
+    providers: {
+        hubspot?: {
+            apiKey: string;
+        };
+        salesforce?: {
+            clientId: string;
+            clientSecret: string;
+            loginUrl: string;
+            apiVersion: string;
+        };
+        attio?: {
+            apiKey: string;
+        };
+    };
+    sync: {
+        batchSize: number;
+        retryAttempts: number;
+        retryDelay: number;
+    };
+}
+export interface RealtimeConfig {
+    enabled: boolean;
+    provider: 'sse' | 'websocket';
+    providers: {
+        sse?: {
+            heartbeatInterval: number;
+            reconnectDelay: number;
+        };
+        websocket?: {
+            port: number;
+            path: string;
+            pingInterval: number;
+            pongTimeout: number;
+        };
+    };
+}
+export interface PushNotificationsConfig {
+    enabled: boolean;
+    provider: 'fcm';
+    providers: {
+        fcm?: {
+            projectId: string;
+            serviceAccountPath?: string;
+        };
+    };
+}
+export interface JourneyConfig {
+    enabled: boolean;
+    provider: 'ortto';
+    providers: {
+        ortto?: {
+            apiKey: string;
+            region?: string;
+        };
+    };
+}
+export interface ERPConfig {
+    enabled: boolean;
+    provider: 'workday';
+    providers: {
+        workday?: {
+            tenant: string;
+            clientId: string;
+            clientSecret: string;
+            apiVersion: string;
+        };
+    };
+}
+export interface WorkManagementConfig {
+    enabled: boolean;
+    provider: 'clickup' | 'monday' | 'notion';
+    providers: {
+        clickup?: {
+            apiKey: string;
+            teamId?: string;
+        };
+        monday?: {
+            apiKey: string;
+        };
+        notion?: {
+            apiKey: string;
+            databaseId?: string;
+        };
+    };
+}
+export interface SurveyConfig {
+    enabled: boolean;
+    provider: 'surveymonkey' | 'typeform';
+    providers: {
+        surveymonkey?: {
+            apiKey: string;
+            accessToken: string;
+        };
+        typeform?: {
+            apiKey: string;
+            accessToken: string;
+        };
+    };
+}
+export interface DocumentConfig {
+    enabled: boolean;
+    provider: 'pandadoc';
+    providers: {
+        pandadoc?: {
+            apiKey: string;
+        };
+    };
+}
+export declare const COMMUNICATIONS_CONFIG: CommunicationsConfig;
+/**
+ * Validate communications configuration
+ */
+export declare function validateCommunicationsConfig(): void;
+//# sourceMappingURL=communications.config.d.ts.map

package/lib/core/src/config/communications.config.d.ts.map

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