@xbg.solutions/backend-core 1.0.0

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

@@ -0,0 +1,61 @@
+/**
+ * Firestore Configuration
+ *
+ * Multi-database Firestore setup. Customize the DatabaseName type and
+ * FIRESTORE_CONFIG map to match your application's database structure.
+ *
+ * The boilerplate ships with two databases (main + analytics) as a
+ * starting point. Add or remove databases to fit your domain:
+ *
+ *   1. Add the name to the DatabaseName union type.
+ *   2. Add the config entry to FIRESTORE_CONFIG.
+ *   3. Add the matching env var to .env (the setup wizard handles the
+ *      two defaults automatically).
+ *
+ * For single-database mode, set every firestoreName to "(default)".
+ */
+/**
+ * Database names — extend this type as your project grows.
+ */
+export type DatabaseName = 'main' | 'analytics';
+/**
+ * Database configuration interface
+ */
+export interface FirestoreDatabaseConfig {
+    /** Firestore database name (for named databases in production) */
+    firestoreName: string;
+    /** Collections that exist in this database */
+    collections: string[];
+    /** Whether this database should be available in emulator mode */
+    emulatorSupport: boolean;
+}
+/**
+ * Firestore configuration type
+ */
+export type FirestoreConfig = {
+    [K in DatabaseName]: FirestoreDatabaseConfig;
+};
+/**
+ * Firestore configuration.
+ *
+ * Collections listed here are framework-level only. Entity-specific
+ * collections are created by the code generator via repository classes.
+ */
+export declare const FIRESTORE_CONFIG: FirestoreConfig;
+/**
+ * Get Firestore database name
+ */
+export declare function getFirestoreDatabaseName(database: DatabaseName): string;
+/**
+ * Get collections for a database
+ */
+export declare function getDatabaseCollections(database: DatabaseName): string[];
+/**
+ * Check if database supports emulator
+ */
+export declare function isDatabaseEmulatorSupported(database: DatabaseName): boolean;
+/**
+ * Validate Firestore configuration
+ */
+export declare function validateFirestoreConfig(): void;
+//# sourceMappingURL=firestore.config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"firestore.config.d.ts","sourceRoot":"","sources":["../../../../src/config/firestore.config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH;;GAEG;AACH,MAAM,MAAM,YAAY,GACpB,MAAM,GACN,WAAW,CAAC;AAEhB;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,kEAAkE;IAClE,aAAa,EAAE,MAAM,CAAC;IACtB,8CAA8C;IAC9C,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,iEAAiE;IACjE,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG;KAC3B,CAAC,IAAI,YAAY,GAAG,uBAAuB;CAC7C,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,EAAE,eAW9B,CAAC;AAEF;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM,CAEvE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM,EAAE,CAEvE;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,YAAY,GAAG,OAAO,CAE3E;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,IAAI,CAY9C"}

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

@@ -0,0 +1,74 @@
+"use strict";
+/**
+ * Firestore Configuration
+ *
+ * Multi-database Firestore setup. Customize the DatabaseName type and
+ * FIRESTORE_CONFIG map to match your application's database structure.
+ *
+ * The boilerplate ships with two databases (main + analytics) as a
+ * starting point. Add or remove databases to fit your domain:
+ *
+ *   1. Add the name to the DatabaseName union type.
+ *   2. Add the config entry to FIRESTORE_CONFIG.
+ *   3. Add the matching env var to .env (the setup wizard handles the
+ *      two defaults automatically).
+ *
+ * For single-database mode, set every firestoreName to "(default)".
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FIRESTORE_CONFIG = void 0;
+exports.getFirestoreDatabaseName = getFirestoreDatabaseName;
+exports.getDatabaseCollections = getDatabaseCollections;
+exports.isDatabaseEmulatorSupported = isDatabaseEmulatorSupported;
+exports.validateFirestoreConfig = validateFirestoreConfig;
+/**
+ * Firestore configuration.
+ *
+ * Collections listed here are framework-level only. Entity-specific
+ * collections are created by the code generator via repository classes.
+ */
+exports.FIRESTORE_CONFIG = {
+    main: {
+        firestoreName: process.env.MAIN_DATABASE_ID || '(default)',
+        collections: ['sessions', 'token_blacklist', 'audit_logs'],
+        emulatorSupport: true,
+    },
+    analytics: {
+        firestoreName: process.env.ANALYTICS_DATABASE_ID || 'analytics',
+        collections: [],
+        emulatorSupport: true,
+    },
+};
+/**
+ * Get Firestore database name
+ */
+function getFirestoreDatabaseName(database) {
+    return exports.FIRESTORE_CONFIG[database].firestoreName;
+}
+/**
+ * Get collections for a database
+ */
+function getDatabaseCollections(database) {
+    return exports.FIRESTORE_CONFIG[database].collections;
+}
+/**
+ * Check if database supports emulator
+ */
+function isDatabaseEmulatorSupported(database) {
+    return exports.FIRESTORE_CONFIG[database].emulatorSupport;
+}
+/**
+ * Validate Firestore configuration
+ */
+function validateFirestoreConfig() {
+    const errors = [];
+    Object.entries(exports.FIRESTORE_CONFIG).forEach(([dbName, config]) => {
+        if (!config.firestoreName) {
+            errors.push(`Firestore name is required for database: ${dbName}`);
+        }
+    });
+    if (errors.length > 0) {
+        throw new Error(`Firestore configuration validation failed:\n${errors.join('\n')}`);
+    }
+}
+//# sourceMappingURL=firestore.config.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"firestore.config.js","sourceRoot":"","sources":["../../../../src/config/firestore.config.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;GAeG;;;AAkDH,4DAEC;AAKD,wDAEC;AAKD,kEAEC;AAKD,0DAYC;AAvDD;;;;;GAKG;AACU,QAAA,gBAAgB,GAAoB;IAC/C,IAAI,EAAE;QACJ,aAAa,EAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,WAAW;QAC1D,WAAW,EAAE,CAAC,UAAU,EAAE,iBAAiB,EAAE,YAAY,CAAC;QAC1D,eAAe,EAAE,IAAI;KACtB;IACD,SAAS,EAAE;QACT,aAAa,EAAE,OAAO,CAAC,GAAG,CAAC,qBAAqB,IAAI,WAAW;QAC/D,WAAW,EAAE,EAAE;QACf,eAAe,EAAE,IAAI;KACtB;CACF,CAAC;AAEF;;GAEG;AACH,SAAgB,wBAAwB,CAAC,QAAsB;IAC7D,OAAO,wBAAgB,CAAC,QAAQ,CAAC,CAAC,aAAa,CAAC;AAClD,CAAC;AAED;;GAEG;AACH,SAAgB,sBAAsB,CAAC,QAAsB;IAC3D,OAAO,wBAAgB,CAAC,QAAQ,CAAC,CAAC,WAAW,CAAC;AAChD,CAAC;AAED;;GAEG;AACH,SAAgB,2BAA2B,CAAC,QAAsB;IAChE,OAAO,wBAAgB,CAAC,QAAQ,CAAC,CAAC,eAAe,CAAC;AACpD,CAAC;AAED;;GAEG;AACH,SAAgB,uBAAuB;IACrC,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,MAAM,CAAC,OAAO,CAAC,wBAAgB,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,EAAE;QAC5D,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC;YAC1B,MAAM,CAAC,IAAI,CAAC,4CAA4C,MAAM,EAAE,CAAC,CAAC;QACpE,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,+CAA+C,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACtF,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,15 @@
+/**
+ * Configuration barrel export
+ * Single entry point for all configuration
+ */
+export * from './app.config';
+export * from './database.config';
+export * from './auth.config';
+export * from './middleware.config';
+export * from './communications.config';
+export * from './cache.config';
+/**
+ * Validate all configuration on startup
+ */
+export declare function validateAllConfig(): void;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/config/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC;AACxC,cAAc,gBAAgB,CAAC;AAO/B;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAKxC"}

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

@@ -0,0 +1,41 @@
+"use strict";
+/**
+ * Configuration barrel export
+ * Single entry point for all configuration
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateAllConfig = validateAllConfig;
+__exportStar(require("./app.config"), exports);
+__exportStar(require("./database.config"), exports);
+__exportStar(require("./auth.config"), exports);
+__exportStar(require("./middleware.config"), exports);
+__exportStar(require("./communications.config"), exports);
+__exportStar(require("./cache.config"), exports);
+const app_config_1 = require("./app.config");
+const auth_config_1 = require("./auth.config");
+const communications_config_1 = require("./communications.config");
+const cache_config_1 = require("./cache.config");
+/**
+ * Validate all configuration on startup
+ */
+function validateAllConfig() {
+    (0, app_config_1.validateAppConfig)();
+    (0, auth_config_1.validateAuthConfig)();
+    (0, communications_config_1.validateCommunicationsConfig)();
+    (0, cache_config_1.validateCacheConfig)();
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/config/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;;;;;;;;;;;;AAiBH,8CAKC;AApBD,+CAA6B;AAC7B,oDAAkC;AAClC,gDAA8B;AAC9B,sDAAoC;AACpC,0DAAwC;AACxC,iDAA+B;AAE/B,6CAAiD;AACjD,+CAAmD;AACnD,mEAAuE;AACvE,iDAAqD;AAErD;;GAEG;AACH,SAAgB,iBAAiB;IAC/B,IAAA,8BAAiB,GAAE,CAAC;IACpB,IAAA,gCAAkB,GAAE,CAAC;IACrB,IAAA,oDAA4B,GAAE,CAAC;IAC/B,IAAA,kCAAmB,GAAE,CAAC;AACxB,CAAC"}

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

@@ -0,0 +1,31 @@
+/**
+ * Google Maps API Configuration
+ * Used for address validation and geocoding services
+ */
+export interface MapsConfig {
+    apiKey: string;
+    enabled: boolean;
+    timeout: number;
+    rateLimits?: {
+        requestsPerSecond?: number;
+        requestsPerDay?: number;
+    };
+}
+/**
+ * Load Google Maps configuration from environment
+ */
+export declare const MAPS_CONFIG: MapsConfig;
+/**
+ * Get Google Maps API key
+ * @throws Error if API key is not configured
+ */
+export declare function getGoogleMapsApiKey(): string;
+/**
+ * Check if Google Maps is configured
+ */
+export declare function isGoogleMapsConfigured(): boolean;
+/**
+ * Validate Google Maps configuration
+ */
+export declare function validateMapsConfig(): void;
+//# sourceMappingURL=maps.config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"maps.config.d.ts","sourceRoot":"","sources":["../../../../src/config/maps.config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE;QACX,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB,CAAC;CACH;AAED;;GAEG;AACH,eAAO,MAAM,WAAW,EAAE,UAQzB,CAAC;AAEF;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAK5C;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,CAEhD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAQzC"}

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

@@ -0,0 +1,50 @@
+"use strict";
+/**
+ * Google Maps API Configuration
+ * Used for address validation and geocoding services
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MAPS_CONFIG = void 0;
+exports.getGoogleMapsApiKey = getGoogleMapsApiKey;
+exports.isGoogleMapsConfigured = isGoogleMapsConfigured;
+exports.validateMapsConfig = validateMapsConfig;
+/**
+ * Load Google Maps configuration from environment
+ */
+exports.MAPS_CONFIG = {
+    apiKey: process.env.GOOGLE_MAPS_API_KEY || '',
+    enabled: !!process.env.GOOGLE_MAPS_API_KEY,
+    timeout: parseInt(process.env.GOOGLE_MAPS_TIMEOUT || '5000', 10),
+    rateLimits: {
+        requestsPerSecond: parseInt(process.env.GOOGLE_MAPS_RATE_LIMIT_PER_SECOND || '50', 10),
+        requestsPerDay: parseInt(process.env.GOOGLE_MAPS_RATE_LIMIT_PER_DAY || '100000', 10),
+    },
+};
+/**
+ * Get Google Maps API key
+ * @throws Error if API key is not configured
+ */
+function getGoogleMapsApiKey() {
+    if (!exports.MAPS_CONFIG.apiKey) {
+        throw new Error('Google Maps API key is not configured. Set GOOGLE_MAPS_API_KEY environment variable.');
+    }
+    return exports.MAPS_CONFIG.apiKey;
+}
+/**
+ * Check if Google Maps is configured
+ */
+function isGoogleMapsConfigured() {
+    return exports.MAPS_CONFIG.enabled;
+}
+/**
+ * Validate Google Maps configuration
+ */
+function validateMapsConfig() {
+    if (exports.MAPS_CONFIG.enabled && !exports.MAPS_CONFIG.apiKey) {
+        throw new Error('Google Maps API key is required when GOOGLE_MAPS_API_KEY is set');
+    }
+    if (exports.MAPS_CONFIG.timeout < 1000 || exports.MAPS_CONFIG.timeout > 30000) {
+        throw new Error('Google Maps timeout must be between 1000 and 30000 milliseconds');
+    }
+}
+//# sourceMappingURL=maps.config.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"maps.config.js","sourceRoot":"","sources":["../../../../src/config/maps.config.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AA6BH,kDAKC;AAKD,wDAEC;AAKD,gDAQC;AA1CD;;GAEG;AACU,QAAA,WAAW,GAAe;IACrC,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,EAAE;IAC7C,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB;IAC1C,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,MAAM,EAAE,EAAE,CAAC;IAChE,UAAU,EAAE;QACV,iBAAiB,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,iCAAiC,IAAI,IAAI,EAAE,EAAE,CAAC;QACtF,cAAc,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,8BAA8B,IAAI,QAAQ,EAAE,EAAE,CAAC;KACrF;CACF,CAAC;AAEF;;;GAGG;AACH,SAAgB,mBAAmB;IACjC,IAAI,CAAC,mBAAW,CAAC,MAAM,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,sFAAsF,CAAC,CAAC;IAC1G,CAAC;IACD,OAAO,mBAAW,CAAC,MAAM,CAAC;AAC5B,CAAC;AAED;;GAEG;AACH,SAAgB,sBAAsB;IACpC,OAAO,mBAAW,CAAC,OAAO,CAAC;AAC7B,CAAC;AAED;;GAEG;AACH,SAAgB,kBAAkB;IAChC,IAAI,mBAAW,CAAC,OAAO,IAAI,CAAC,mBAAW,CAAC,MAAM,EAAE,CAAC;QAC/C,MAAM,IAAI,KAAK,CAAC,iEAAiE,CAAC,CAAC;IACrF,CAAC;IAED,IAAI,mBAAW,CAAC,OAAO,GAAG,IAAI,IAAI,mBAAW,CAAC,OAAO,GAAG,KAAK,EAAE,CAAC;QAC9D,MAAM,IAAI,KAAK,CAAC,iEAAiE,CAAC,CAAC;IACrF,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,57 @@
+/**
+ * Middleware Configuration
+ * Pipeline setup and ordering
+ */
+export interface MiddlewareConfig {
+    cors: {
+        enabled: boolean;
+        credentials: boolean;
+        maxAge: number;
+    };
+    helmet: {
+        enabled: boolean;
+        contentSecurityPolicy: boolean;
+        crossOriginEmbedderPolicy: boolean;
+    };
+    rateLimit: {
+        enabled: boolean;
+        windowMs: number;
+        max: number;
+        skipSuccessfulRequests: boolean;
+        skipFailedRequests: boolean;
+    };
+    compression: {
+        enabled: boolean;
+        level: number;
+        threshold: number;
+    };
+    bodyParser: {
+        json: {
+            limit: string;
+            strict: boolean;
+        };
+        urlencoded: {
+            limit: string;
+            extended: boolean;
+            parameterLimit: number;
+        };
+    };
+    requestId: {
+        enabled: boolean;
+        headerName: string;
+    };
+    logging: {
+        enabled: boolean;
+        logBody: boolean;
+        logHeaders: boolean;
+        sensitiveHeaders: string[];
+    };
+}
+export declare const MIDDLEWARE_CONFIG: MiddlewareConfig;
+/**
+ * Middleware execution order
+ * Order matters! Earlier middleware run first
+ */
+export declare const MIDDLEWARE_ORDER: readonly ["helmet", "cors", "requestId", "logging", "compression", "bodyParser", "rateLimit", "authentication", "validation"];
+export type MiddlewareType = typeof MIDDLEWARE_ORDER[number];
+//# sourceMappingURL=middleware.config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.config.d.ts","sourceRoot":"","sources":["../../../../src/config/middleware.config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE;QACJ,OAAO,EAAE,OAAO,CAAC;QACjB,WAAW,EAAE,OAAO,CAAC;QACrB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IAEF,MAAM,EAAE;QACN,OAAO,EAAE,OAAO,CAAC;QACjB,qBAAqB,EAAE,OAAO,CAAC;QAC/B,yBAAyB,EAAE,OAAO,CAAC;KACpC,CAAC;IAEF,SAAS,EAAE;QACT,OAAO,EAAE,OAAO,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,GAAG,EAAE,MAAM,CAAC;QACZ,sBAAsB,EAAE,OAAO,CAAC;QAChC,kBAAkB,EAAE,OAAO,CAAC;KAC7B,CAAC;IAEF,WAAW,EAAE;QACX,OAAO,EAAE,OAAO,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IAEF,UAAU,EAAE;QACV,IAAI,EAAE;YACJ,KAAK,EAAE,MAAM,CAAC;YACd,MAAM,EAAE,OAAO,CAAC;SACjB,CAAC;QACF,UAAU,EAAE;YACV,KAAK,EAAE,MAAM,CAAC;YACd,QAAQ,EAAE,OAAO,CAAC;YAClB,cAAc,EAAE,MAAM,CAAC;SACxB,CAAC;KACH,CAAC;IAEF,SAAS,EAAE;QACT,OAAO,EAAE,OAAO,CAAC;QACjB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IAEF,OAAO,EAAE;QACP,OAAO,EAAE,OAAO,CAAC;QACjB,OAAO,EAAE,OAAO,CAAC;QACjB,UAAU,EAAE,OAAO,CAAC;QACpB,gBAAgB,EAAE,MAAM,EAAE,CAAC;KAC5B,CAAC;CACH;AAED,eAAO,MAAM,iBAAiB,EAAE,gBAkD/B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,gBAAgB,+HAUnB,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,OAAO,gBAAgB,CAAC,MAAM,CAAC,CAAC"}

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

@@ -0,0 +1,68 @@
+"use strict";
+/**
+ * Middleware Configuration
+ * Pipeline setup and ordering
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MIDDLEWARE_ORDER = exports.MIDDLEWARE_CONFIG = void 0;
+exports.MIDDLEWARE_CONFIG = {
+    cors: {
+        enabled: true,
+        credentials: true,
+        maxAge: parseInt(process.env.CORS_MAX_AGE || '86400', 10), // 24 hours
+    },
+    helmet: {
+        enabled: process.env.NODE_ENV === 'production',
+        contentSecurityPolicy: process.env.NODE_ENV === 'production',
+        crossOriginEmbedderPolicy: false,
+    },
+    rateLimit: {
+        enabled: process.env.RATE_LIMIT_ENABLED !== 'false',
+        windowMs: parseInt(process.env.RATE_LIMIT_WINDOW_MS || '900000', 10), // 15 minutes
+        max: parseInt(process.env.RATE_LIMIT_MAX || '100', 10),
+        skipSuccessfulRequests: false,
+        skipFailedRequests: false,
+    },
+    compression: {
+        enabled: process.env.COMPRESSION_ENABLED !== 'false',
+        level: parseInt(process.env.COMPRESSION_LEVEL || '6', 10),
+        threshold: parseInt(process.env.COMPRESSION_THRESHOLD || '1024', 10), // 1KB
+    },
+    bodyParser: {
+        json: {
+            limit: process.env.JSON_BODY_LIMIT || '10mb',
+            strict: true,
+        },
+        urlencoded: {
+            limit: process.env.URLENCODED_BODY_LIMIT || '10mb',
+            extended: true,
+            parameterLimit: parseInt(process.env.PARAMETER_LIMIT || '1000', 10),
+        },
+    },
+    requestId: {
+        enabled: true,
+        headerName: 'X-Request-ID',
+    },
+    logging: {
+        enabled: true,
+        logBody: process.env.NODE_ENV === 'development',
+        logHeaders: process.env.NODE_ENV === 'development',
+        sensitiveHeaders: ['authorization', 'cookie', 'x-api-key'],
+    },
+};
+/**
+ * Middleware execution order
+ * Order matters! Earlier middleware run first
+ */
+exports.MIDDLEWARE_ORDER = [
+    'helmet',
+    'cors',
+    'requestId',
+    'logging',
+    'compression',
+    'bodyParser',
+    'rateLimit',
+    'authentication',
+    'validation',
+];
+//# sourceMappingURL=middleware.config.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.config.js","sourceRoot":"","sources":["../../../../src/config/middleware.config.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAsDU,QAAA,iBAAiB,GAAqB;IACjD,IAAI,EAAE;QACJ,OAAO,EAAE,IAAI;QACb,WAAW,EAAE,IAAI;QACjB,MAAM,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,OAAO,EAAE,EAAE,CAAC,EAAE,WAAW;KACvE;IAED,MAAM,EAAE;QACN,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY;QAC9C,qBAAqB,EAAE,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY;QAC5D,yBAAyB,EAAE,KAAK;KACjC;IAED,SAAS,EAAE;QACT,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,kBAAkB,KAAK,OAAO;QACnD,QAAQ,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,QAAQ,EAAE,EAAE,CAAC,EAAE,aAAa;QACnF,GAAG,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,KAAK,EAAE,EAAE,CAAC;QACtD,sBAAsB,EAAE,KAAK;QAC7B,kBAAkB,EAAE,KAAK;KAC1B;IAED,WAAW,EAAE;QACX,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,mBAAmB,KAAK,OAAO;QACpD,KAAK,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,GAAG,EAAE,EAAE,CAAC;QACzD,SAAS,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,qBAAqB,IAAI,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM;KAC7E;IAED,UAAU,EAAE;QACV,IAAI,EAAE;YACJ,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,MAAM;YAC5C,MAAM,EAAE,IAAI;SACb;QACD,UAAU,EAAE;YACV,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,qBAAqB,IAAI,MAAM;YAClD,QAAQ,EAAE,IAAI;YACd,cAAc,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,MAAM,EAAE,EAAE,CAAC;SACpE;KACF;IAED,SAAS,EAAE;QACT,OAAO,EAAE,IAAI;QACb,UAAU,EAAE,cAAc;KAC3B;IAED,OAAO,EAAE;QACP,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,aAAa;QAC/C,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,aAAa;QAClD,gBAAgB,EAAE,CAAC,eAAe,EAAE,QAAQ,EAAE,WAAW,CAAC;KAC3D;CACF,CAAC;AAEF;;;GAGG;AACU,QAAA,gBAAgB,GAAG;IAC9B,QAAQ;IACR,MAAM;IACN,WAAW;IACX,SAAS;IACT,aAAa;IACb,YAAY;IACZ,WAAW;IACX,gBAAgB;IAChB,YAAY;CACJ,CAAC"}

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

@@ -0,0 +1,53 @@
+/**
+ * Token Configuration
+ * Generic token handler configuration for boilerplate backend
+ *
+ * NOTE: This is a generic configuration. When using this boilerplate for your
+ * specific project, customize the custom claims interface and blacklist reasons
+ * to match your application's requirements.
+ */
+import type { ITokenHandler } from '@xbg/utils-token-handler';
+import type { TokenBlacklistManager } from '@xbg/utils-token-handler';
+/**
+ * Generic custom claims interface
+ * Customize this for your specific application needs
+ */
+export interface CustomClaims {
+    userUID: string | null;
+    role?: string;
+    emailVerified?: boolean;
+    [key: string]: any;
+}
+/**
+ * Generic blacklist reasons
+ * Customize these for your application's specific use cases
+ */
+export declare enum BlacklistReason {
+    LOGOUT = "LOGOUT",
+    PASSWORD_CHANGE = "PASSWORD_CHANGE",
+    SECURITY_BREACH = "SECURITY_BREACH",
+    ACCOUNT_DELETION = "ACCOUNT_DELETION",
+    ADMIN_REVOCATION = "ADMIN_REVOCATION"
+}
+/**
+ * Create configured token handler
+ */
+export declare function createProjectTokenHandler(): ITokenHandler<CustomClaims>;
+/**
+ * Get or create token handler singleton
+ */
+export declare function getTokenHandler(): ITokenHandler<CustomClaims>;
+/**
+ * Get or create token blacklist manager singleton
+ */
+export declare function getTokenBlacklist(): TokenBlacklistManager;
+/**
+ * Export singleton instances for convenience
+ */
+export declare const tokenHandler: ITokenHandler<CustomClaims>;
+export declare const tokenBlacklist: TokenBlacklistManager;
+/**
+ * Reset singletons (useful for testing)
+ */
+export declare function resetTokenHandlerSingletons(): void;
+//# sourceMappingURL=tokens.config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.config.d.ts","sourceRoot":"","sources":["../../../../src/config/tokens.config.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAEtE;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED;;;GAGG;AACH,oBAAY,eAAe;IACzB,MAAM,WAAW;IACjB,eAAe,oBAAoB;IACnC,eAAe,oBAAoB;IACnC,gBAAgB,qBAAqB;IACrC,gBAAgB,qBAAqB;CACtC;AAQD;;GAEG;AACH,wBAAgB,yBAAyB,IAAI,aAAa,CAAC,YAAY,CAAC,CA0DvE;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,aAAa,CAAC,YAAY,CAAC,CAK7D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,qBAAqB,CAwBzD;AAED;;GAEG;AACH,eAAO,MAAM,YAAY,6BAAoB,CAAC;AAC9C,eAAO,MAAM,cAAc,uBAAsB,CAAC;AAElD;;GAEG;AACH,wBAAgB,2BAA2B,IAAI,IAAI,CAGlD"}

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

@@ -0,0 +1,129 @@
+"use strict";
+/**
+ * Token Configuration
+ * Generic token handler configuration for boilerplate backend
+ *
+ * NOTE: This is a generic configuration. When using this boilerplate for your
+ * specific project, customize the custom claims interface and blacklist reasons
+ * to match your application's requirements.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tokenBlacklist = exports.tokenHandler = exports.BlacklistReason = void 0;
+exports.createProjectTokenHandler = createProjectTokenHandler;
+exports.getTokenHandler = getTokenHandler;
+exports.getTokenBlacklist = getTokenBlacklist;
+exports.resetTokenHandlerSingletons = resetTokenHandlerSingletons;
+const utils_token_handler_1 = require("@xbg/utils-token-handler");
+const utils_firestore_connector_1 = require("@xbg/utils-firestore-connector");
+/**
+ * Generic blacklist reasons
+ * Customize these for your application's specific use cases
+ */
+var BlacklistReason;
+(function (BlacklistReason) {
+    BlacklistReason["LOGOUT"] = "LOGOUT";
+    BlacklistReason["PASSWORD_CHANGE"] = "PASSWORD_CHANGE";
+    BlacklistReason["SECURITY_BREACH"] = "SECURITY_BREACH";
+    BlacklistReason["ACCOUNT_DELETION"] = "ACCOUNT_DELETION";
+    BlacklistReason["ADMIN_REVOCATION"] = "ADMIN_REVOCATION";
+})(BlacklistReason || (exports.BlacklistReason = BlacklistReason = {}));
+/**
+ * Token handler singleton instance
+ */
+let tokenHandlerInstance = null;
+let tokenBlacklistInstance = null;
+/**
+ * Create configured token handler
+ */
+function createProjectTokenHandler() {
+    // Get Firestore instance
+    const db = (0, utils_firestore_connector_1.getFirestore)();
+    // Create database adapter
+    const tokenDatabase = (0, utils_token_handler_1.createFirestoreTokenDatabase)(db, process.env.TOKEN_BLACKLIST_COLLECTION || 'tokenBlacklist');
+    // Create auth adapter with CustomClaims type
+    const authAdapter = (0, utils_token_handler_1.createFirebaseAuthAdapter)();
+    // Build configuration
+    const config = {
+        customClaims: {
+            extract: (token) => ({
+                userUID: token.userUID || null,
+                role: token.role || 'user',
+                emailVerified: token.email_verified || false,
+            }),
+            validate: (claims) => {
+                // Add your custom validation logic here
+                if (claims.userUID !== null && typeof claims.userUID !== 'string') {
+                    return false;
+                }
+                return true;
+            },
+            defaults: {
+                userUID: null,
+                role: 'user',
+                emailVerified: false,
+            },
+        },
+        blacklist: {
+            storage: {
+                database: 'main',
+                collection: process.env.TOKEN_BLACKLIST_COLLECTION || 'tokenBlacklist',
+            },
+            retention: {
+                cleanupRetentionDays: parseInt(process.env.TOKEN_BLACKLIST_RETENTION_DAYS || '30', 10),
+                globalRevocationRetentionDays: parseInt(process.env.TOKEN_GLOBAL_REVOCATION_RETENTION_DAYS || '30', 10),
+            },
+            reasons: Object.values(BlacklistReason),
+        },
+        provider: {
+            type: 'firebase',
+            firebase: {
+                projectId: process.env.FIREBASE_PROJECT_ID,
+            },
+        },
+        database: tokenDatabase,
+    };
+    return (0, utils_token_handler_1.createTokenHandler)(config, authAdapter);
+}
+/**
+ * Get or create token handler singleton
+ */
+function getTokenHandler() {
+    if (!tokenHandlerInstance) {
+        tokenHandlerInstance = createProjectTokenHandler();
+    }
+    return tokenHandlerInstance;
+}
+/**
+ * Get or create token blacklist manager singleton
+ */
+function getTokenBlacklist() {
+    if (!tokenBlacklistInstance) {
+        const db = (0, utils_firestore_connector_1.getFirestore)();
+        const tokenDatabase = (0, utils_token_handler_1.createFirestoreTokenDatabase)(db, process.env.TOKEN_BLACKLIST_COLLECTION || 'tokenBlacklist');
+        tokenBlacklistInstance = (0, utils_token_handler_1.createTokenBlacklistManager)(tokenDatabase, {
+            storage: {
+                database: 'main',
+                collection: process.env.TOKEN_BLACKLIST_COLLECTION || 'tokenBlacklist',
+            },
+            retention: {
+                cleanupRetentionDays: parseInt(process.env.TOKEN_BLACKLIST_RETENTION_DAYS || '30', 10),
+                globalRevocationRetentionDays: parseInt(process.env.TOKEN_GLOBAL_REVOCATION_RETENTION_DAYS || '30', 10),
+            },
+            reasons: Object.values(BlacklistReason),
+        });
+    }
+    return tokenBlacklistInstance;
+}
+/**
+ * Export singleton instances for convenience
+ */
+exports.tokenHandler = getTokenHandler();
+exports.tokenBlacklist = getTokenBlacklist();
+/**
+ * Reset singletons (useful for testing)
+ */
+function resetTokenHandlerSingletons() {
+    tokenHandlerInstance = null;
+    tokenBlacklistInstance = null;
+}
+//# sourceMappingURL=tokens.config.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.config.js","sourceRoot":"","sources":["../../../../src/config/tokens.config.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AAuCH,8DA0DC;AAKD,0CAKC;AAKD,8CAwBC;AAWD,kEAGC;AApJD,kEAAoJ;AACpJ,8EAA8D;AAe9D;;;GAGG;AACH,IAAY,eAMX;AAND,WAAY,eAAe;IACzB,oCAAiB,CAAA;IACjB,sDAAmC,CAAA;IACnC,sDAAmC,CAAA;IACnC,wDAAqC,CAAA;IACrC,wDAAqC,CAAA;AACvC,CAAC,EANW,eAAe,+BAAf,eAAe,QAM1B;AAED;;GAEG;AACH,IAAI,oBAAoB,GAAuC,IAAI,CAAC;AACpE,IAAI,sBAAsB,GAAiC,IAAI,CAAC;AAEhE;;GAEG;AACH,SAAgB,yBAAyB;IACvC,yBAAyB;IACzB,MAAM,EAAE,GAAG,IAAA,wCAAY,GAAE,CAAC;IAE1B,0BAA0B;IAC1B,MAAM,aAAa,GAAG,IAAA,kDAA4B,EAChD,EAAE,EACF,OAAO,CAAC,GAAG,CAAC,0BAA0B,IAAI,gBAAgB,CAC3D,CAAC;IAEF,6CAA6C;IAC7C,MAAM,WAAW,GAAG,IAAA,+CAAyB,GAAgB,CAAC;IAE9D,sBAAsB;IACtB,MAAM,MAAM,GAAG;QACb,YAAY,EAAE;YACZ,OAAO,EAAE,CAAC,KAAU,EAAgB,EAAE,CAAC,CAAC;gBACtC,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,IAAI;gBAC9B,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,MAAM;gBAC1B,aAAa,EAAE,KAAK,CAAC,cAAc,IAAI,KAAK;aAC7C,CAAC;YACF,QAAQ,EAAE,CAAC,MAAoB,EAAW,EAAE;gBAC1C,wCAAwC;gBACxC,IAAI,MAAM,CAAC,OAAO,KAAK,IAAI,IAAI,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;oBAClE,OAAO,KAAK,CAAC;gBACf,CAAC;gBACD,OAAO,IAAI,CAAC;YACd,CAAC;YACD,QAAQ,EAAE;gBACR,OAAO,EAAE,IAAI;gBACb,IAAI,EAAE,MAAM;gBACZ,aAAa,EAAE,KAAK;aACrB;SACF;QACD,SAAS,EAAE;YACT,OAAO,EAAE;gBACP,QAAQ,EAAE,MAAM;gBAChB,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,0BAA0B,IAAI,gBAAgB;aACvE;YACD,SAAS,EAAE;gBACT,oBAAoB,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,8BAA8B,IAAI,IAAI,EAAE,EAAE,CAAC;gBACtF,6BAA6B,EAAE,QAAQ,CACrC,OAAO,CAAC,GAAG,CAAC,sCAAsC,IAAI,IAAI,EAC1D,EAAE,CACH;aACF;YACD,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC;SACxC;QACD,QAAQ,EAAE;YACR,IAAI,EAAE,UAAmB;YACzB,QAAQ,EAAE;gBACR,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,mBAAmB;aAC3C;SACF;QACD,QAAQ,EAAE,aAAa;KACxB,CAAC;IAEF,OAAO,IAAA,wCAAkB,EAAC,MAAM,EAAE,WAAW,CAAC,CAAC;AACjD,CAAC;AAED;;GAEG;AACH,SAAgB,eAAe;IAC7B,IAAI,CAAC,oBAAoB,EAAE,CAAC;QAC1B,oBAAoB,GAAG,yBAAyB,EAAE,CAAC;IACrD,CAAC;IACD,OAAO,oBAAoB,CAAC;AAC9B,CAAC;AAED;;GAEG;AACH,SAAgB,iBAAiB;IAC/B,IAAI,CAAC,sBAAsB,EAAE,CAAC;QAC5B,MAAM,EAAE,GAAG,IAAA,wCAAY,GAAE,CAAC;QAC1B,MAAM,aAAa,GAAG,IAAA,kDAA4B,EAChD,EAAE,EACF,OAAO,CAAC,GAAG,CAAC,0BAA0B,IAAI,gBAAgB,CAC3D,CAAC;QAEF,sBAAsB,GAAG,IAAA,iDAA2B,EAAC,aAAa,EAAE;YAClE,OAAO,EAAE;gBACP,QAAQ,EAAE,MAAM;gBAChB,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,0BAA0B,IAAI,gBAAgB;aACvE;YACD,SAAS,EAAE;gBACT,oBAAoB,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,8BAA8B,IAAI,IAAI,EAAE,EAAE,CAAC;gBACtF,6BAA6B,EAAE,QAAQ,CACrC,OAAO,CAAC,GAAG,CAAC,sCAAsC,IAAI,IAAI,EAC1D,EAAE,CACH;aACF;YACD,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC;SACxC,CAAC,CAAC;IACL,CAAC;IACD,OAAO,sBAAsB,CAAC;AAChC,CAAC;AAED;;GAEG;AACU,QAAA,YAAY,GAAG,eAAe,EAAE,CAAC;AACjC,QAAA,cAAc,GAAG,iBAAiB,EAAE,CAAC;AAElD;;GAEG;AACH,SAAgB,2BAA2B;IACzC,oBAAoB,GAAG,IAAI,CAAC;IAC5B,sBAAsB,GAAG,IAAI,CAAC;AAChC,CAAC"}