@xbg.solutions/utils-firestore-connector 1.0.0

package/lib/firebase-types.d.ts

@@ -0,0 +1,141 @@
+/**
+ * Generic Firebase/Firestore type definitions for portable use
+ * Clean implementation without legacy compatibility
+ */
+import { Firestore } from 'firebase-admin/firestore';
+import { LogContext } from '@xbg/utils-logger';
+/**
+ * Generic database configuration for any project
+ */
+export type DatabaseConfig<TDatabaseNames extends string = string> = {
+    [dbName in TDatabaseNames]: {
+        /** 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;
+        /** Custom initialization options for this database */
+        initOptions?: Record<string, any>;
+    };
+};
+/**
+ * Runtime database instances
+ */
+export type DatabaseInstances<TDatabaseNames extends string = string> = {
+    [K in TDatabaseNames]: Firestore;
+};
+/**
+ * Database connection test results
+ */
+export type DatabaseConnectionResult<TDatabaseNames extends string = string> = {
+    [K in TDatabaseNames]: boolean;
+};
+/**
+ * Firestore environment detection
+ */
+export interface FirestoreEnvironment {
+    isEmulator: boolean;
+    isProduction: boolean;
+    isFunctionsEnvironment: boolean;
+    projectId: string;
+    emulatorHost?: string;
+    emulatorPort?: number;
+}
+/**
+ * Firebase configuration interface
+ */
+export interface FirebaseConfig {
+    projectId: string;
+    databaseURL?: string;
+    storageBucket?: string;
+    serviceAccountPath?: string;
+}
+/**
+ * Extended LogContext for Firebase operations
+ */
+export interface FirebaseLogContext extends LogContext {
+    dbName?: string;
+    databases?: string[];
+    collection?: string;
+    document?: string;
+    docId?: string;
+    firebaseOperation?: FirebaseOperation;
+    connectionTest?: boolean;
+    healthCheck?: boolean;
+}
+/**
+ * Health check result interface
+ */
+export interface HealthCheckResult<TDatabaseNames extends string = string> {
+    firebase: boolean;
+    databases: DatabaseConnectionResult<TDatabaseNames>;
+    timestamp: Date;
+}
+/**
+ * Firebase error interface
+ */
+export interface FirebaseError extends Error {
+    code?: string;
+    details?: string;
+    httpStatus?: number;
+}
+/**
+ * Test document interface
+ */
+export interface TestDocument {
+    timestamp: any;
+    test: boolean;
+    database: string;
+}
+/**
+ * Firebase connection state
+ */
+export interface FirebaseConnectionState {
+    initialized: boolean;
+    connected: boolean;
+    databasesInitialized: boolean;
+    lastHealthCheck?: Date;
+    connectionErrors?: Error[];
+}
+/**
+ * Firebase initialization options
+ */
+export interface FirebaseInitOptions {
+    forceReinitialize?: boolean;
+    skipDatabaseInit?: boolean;
+    testMode?: boolean;
+    emulatorMode?: boolean;
+}
+/**
+ * Firebase operation types
+ */
+export declare enum FirebaseOperation {
+    INITIALIZE = "initialize",
+    CONNECT = "connect",
+    DISCONNECT = "disconnect",
+    READ = "read",
+    WRITE = "write",
+    DELETE = "delete",
+    QUERY = "query",
+    HEALTH_CHECK = "health_check",
+    CONNECTION_TEST = "connection_test"
+}
+/**
+ * Type guard for standard errors
+ */
+export declare const isError: (error: any) => error is Error;
+/**
+ * Convert unknown error to Error type
+ */
+export declare const toError: (error: unknown) => Error;
+/**
+ * Detect Firestore environment
+ */
+export declare const detectEnvironment: () => FirestoreEnvironment;
+/**
+ * Get Firebase configuration from environment
+ */
+export declare const getFirebaseConfigFromEnv: () => FirebaseConfig;
+export { Firestore, CollectionReference, DocumentReference, DocumentSnapshot, QuerySnapshot } from 'firebase-admin/firestore';
+//# sourceMappingURL=firebase-types.d.ts.map

package/lib/firebase-types.d.ts.map

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

package/lib/firebase-types.js

@@ -0,0 +1,85 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.QuerySnapshot = exports.DocumentSnapshot = exports.DocumentReference = exports.CollectionReference = exports.Firestore = exports.getFirebaseConfigFromEnv = exports.detectEnvironment = exports.toError = exports.isError = exports.FirebaseOperation = void 0;
+/**
+ * Firebase operation types
+ */
+var FirebaseOperation;
+(function (FirebaseOperation) {
+    FirebaseOperation["INITIALIZE"] = "initialize";
+    FirebaseOperation["CONNECT"] = "connect";
+    FirebaseOperation["DISCONNECT"] = "disconnect";
+    FirebaseOperation["READ"] = "read";
+    FirebaseOperation["WRITE"] = "write";
+    FirebaseOperation["DELETE"] = "delete";
+    FirebaseOperation["QUERY"] = "query";
+    FirebaseOperation["HEALTH_CHECK"] = "health_check";
+    FirebaseOperation["CONNECTION_TEST"] = "connection_test";
+})(FirebaseOperation || (exports.FirebaseOperation = FirebaseOperation = {}));
+/**
+ * Type guard for standard errors
+ */
+const isError = (error) => {
+    return error instanceof Error;
+};
+exports.isError = isError;
+/**
+ * Convert unknown error to Error type
+ */
+const toError = (error) => {
+    if ((0, exports.isError)(error)) {
+        return error;
+    }
+    if (typeof error === 'string') {
+        return new Error(error);
+    }
+    if (error && typeof error === 'object' && 'message' in error) {
+        return new Error(String(error.message));
+    }
+    return new Error('Unknown error occurred');
+};
+exports.toError = toError;
+/**
+ * Detect Firestore environment
+ */
+const detectEnvironment = () => {
+    const projectId = process.env.FIREBASE_PROJECT_ID || process.env.GCLOUD_PROJECT || '';
+    return {
+        isEmulator: !!(process.env.FUNCTIONS_EMULATOR || process.env.FIRESTORE_EMULATOR_HOST),
+        isProduction: !!(process.env.K_SERVICE || process.env.GCLOUD_PROJECT),
+        isFunctionsEnvironment: !!(process.env.FUNCTIONS_EMULATOR || process.env.K_SERVICE),
+        projectId,
+        emulatorHost: process.env.FIRESTORE_EMULATOR_HOST,
+        emulatorPort: process.env.FIRESTORE_EMULATOR_PORT ? parseInt(process.env.FIRESTORE_EMULATOR_PORT) : undefined
+    };
+};
+exports.detectEnvironment = detectEnvironment;
+/**
+ * Get Firebase configuration from environment
+ */
+const getFirebaseConfigFromEnv = () => {
+    const projectId = process.env.FIREBASE_PROJECT_ID || process.env.GCLOUD_PROJECT;
+    const serviceAccountPath = process.env.GOOGLE_APPLICATION_CREDENTIALS;
+    if (!projectId) {
+        throw new Error('FIREBASE_PROJECT_ID or GCLOUD_PROJECT environment variable is required');
+    }
+    // In Firebase Functions environment, service account credentials are not required
+    if (!serviceAccountPath && !process.env.FUNCTIONS_EMULATOR && !process.env.K_SERVICE) {
+        throw new Error('GOOGLE_APPLICATION_CREDENTIALS environment variable is required');
+    }
+    return {
+        projectId,
+        databaseURL: process.env.FIREBASE_DATABASE_URL || `https://${projectId}.firebaseio.com`,
+        storageBucket: process.env.FIREBASE_STORAGE_BUCKET || `${projectId}.appspot.com`,
+        serviceAccountPath: serviceAccountPath || ''
+    };
+};
+exports.getFirebaseConfigFromEnv = getFirebaseConfigFromEnv;
+// Re-export Firestore types for convenience
+var firestore_1 = require("firebase-admin/firestore");
+Object.defineProperty(exports, "Firestore", { enumerable: true, get: function () { return firestore_1.Firestore; } });
+Object.defineProperty(exports, "CollectionReference", { enumerable: true, get: function () { return firestore_1.CollectionReference; } });
+Object.defineProperty(exports, "DocumentReference", { enumerable: true, get: function () { return firestore_1.DocumentReference; } });
+Object.defineProperty(exports, "DocumentSnapshot", { enumerable: true, get: function () { return firestore_1.DocumentSnapshot; } });
+Object.defineProperty(exports, "QuerySnapshot", { enumerable: true, get: function () { return firestore_1.QuerySnapshot; } });
+//# sourceMappingURL=firebase-types.js.map

package/lib/firebase-types.js.map

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

package/lib/firebase.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Firebase Admin SDK Initialization
+ * Centralized Firebase initialization for the backend boilerplate
+ */
+import * as admin from 'firebase-admin';
+import { Firestore } from 'firebase-admin/firestore';
+/**
+ * Initialize Firebase Admin SDK
+ * Safe to call multiple times - only initializes once
+ */
+export declare function initializeFirebase(): admin.app.App;
+/**
+ * Get Firestore instance
+ * Initializes Firebase if not already initialized
+ *
+ * @returns Firestore instance
+ */
+export declare function getFirestore(): Firestore;
+/**
+ * Get Firebase Auth instance
+ */
+export declare function getAuth(): admin.auth.Auth;
+/**
+ * Get Firebase Storage instance
+ */
+export declare function getStorage(): admin.storage.Storage;
+/**
+ * Reset Firebase instances (useful for testing)
+ */
+export declare function resetFirebase(): void;
+/**
+ * Check if Firebase is initialized
+ */
+export declare function isFirebaseInitialized(): boolean;
+//# sourceMappingURL=firebase.d.ts.map

package/lib/firebase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"firebase.d.ts","sourceRoot":"","sources":["../src/firebase.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,KAAK,MAAM,gBAAgB,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAMrD;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,KAAK,CAAC,GAAG,CAAC,GAAG,CAiClD;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,IAAI,SAAS,CAmBxC;AAED;;GAEG;AACH,wBAAgB,OAAO,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAGzC;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAGlD;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,IAAI,CAGpC;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,OAAO,CAE/C"}

package/lib/firebase.js

@@ -0,0 +1,133 @@
+"use strict";
+/**
+ * Firebase Admin SDK Initialization
+ * Centralized Firebase initialization for the backend boilerplate
+ */
+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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.initializeFirebase = initializeFirebase;
+exports.getFirestore = getFirestore;
+exports.getAuth = getAuth;
+exports.getStorage = getStorage;
+exports.resetFirebase = resetFirebase;
+exports.isFirebaseInitialized = isFirebaseInitialized;
+const admin = __importStar(require("firebase-admin"));
+const utils_logger_1 = require("@xbg/utils-logger");
+let firestoreInstance = null;
+let isInitialized = false;
+/**
+ * Initialize Firebase Admin SDK
+ * Safe to call multiple times - only initializes once
+ */
+function initializeFirebase() {
+    if (!isInitialized) {
+        try {
+            // Check if already initialized (e.g., by Firebase Functions runtime)
+            if (admin.apps.length === 0) {
+                const projectId = process.env.FIREBASE_PROJECT_ID || process.env.GCLOUD_PROJECT;
+                if (!projectId) {
+                    throw new Error('FIREBASE_PROJECT_ID or GCLOUD_PROJECT environment variable is required');
+                }
+                // Initialize with application default credentials in Cloud Functions
+                // or with service account in local development
+                admin.initializeApp({
+                    projectId,
+                    credential: admin.credential.applicationDefault(),
+                });
+                utils_logger_1.logger.info('Firebase Admin SDK initialized', {
+                    projectId,
+                    environment: process.env.NODE_ENV,
+                });
+            }
+            isInitialized = true;
+        }
+        catch (error) {
+            const err = error instanceof Error ? error : new Error(String(error));
+            utils_logger_1.logger.error('Failed to initialize Firebase Admin SDK', err);
+            throw err;
+        }
+    }
+    return admin.app();
+}
+/**
+ * Get Firestore instance
+ * Initializes Firebase if not already initialized
+ *
+ * @returns Firestore instance
+ */
+function getFirestore() {
+    if (!firestoreInstance) {
+        // Ensure Firebase is initialized
+        initializeFirebase();
+        // Get Firestore instance
+        firestoreInstance = admin.firestore();
+        // Configure Firestore settings
+        firestoreInstance.settings({
+            ignoreUndefinedProperties: true,
+        });
+        utils_logger_1.logger.info('Firestore instance created', {
+            emulator: !!process.env.FIRESTORE_EMULATOR_HOST,
+        });
+    }
+    return firestoreInstance;
+}
+/**
+ * Get Firebase Auth instance
+ */
+function getAuth() {
+    initializeFirebase();
+    return admin.auth();
+}
+/**
+ * Get Firebase Storage instance
+ */
+function getStorage() {
+    initializeFirebase();
+    return admin.storage();
+}
+/**
+ * Reset Firebase instances (useful for testing)
+ */
+function resetFirebase() {
+    firestoreInstance = null;
+    isInitialized = false;
+}
+/**
+ * Check if Firebase is initialized
+ */
+function isFirebaseInitialized() {
+    return isInitialized;
+}
+//# sourceMappingURL=firebase.js.map

package/lib/firebase.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"firebase.js","sourceRoot":"","sources":["../src/firebase.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAaH,gDAiCC;AAQD,oCAmBC;AAKD,0BAGC;AAKD,gCAGC;AAKD,sCAGC;AAKD,sDAEC;AAtGD,sDAAwC;AAExC,oDAA2C;AAE3C,IAAI,iBAAiB,GAAqB,IAAI,CAAC;AAC/C,IAAI,aAAa,GAAG,KAAK,CAAC;AAE1B;;;GAGG;AACH,SAAgB,kBAAkB;IAChC,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,IAAI,CAAC;YACH,qEAAqE;YACrE,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC5B,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;gBAEhF,IAAI,CAAC,SAAS,EAAE,CAAC;oBACf,MAAM,IAAI,KAAK,CAAC,wEAAwE,CAAC,CAAC;gBAC5F,CAAC;gBAED,qEAAqE;gBACrE,+CAA+C;gBAC/C,KAAK,CAAC,aAAa,CAAC;oBAClB,SAAS;oBACT,UAAU,EAAE,KAAK,CAAC,UAAU,CAAC,kBAAkB,EAAE;iBAClD,CAAC,CAAC;gBAEH,qBAAM,CAAC,IAAI,CAAC,gCAAgC,EAAE;oBAC5C,SAAS;oBACT,WAAW,EAAE,OAAO,CAAC,GAAG,CAAC,QAAQ;iBAClC,CAAC,CAAC;YACL,CAAC;YAED,aAAa,GAAG,IAAI,CAAC;QACvB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,GAAG,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YACtE,qBAAM,CAAC,KAAK,CAAC,yCAAyC,EAAE,GAAG,CAAC,CAAC;YAC7D,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC,GAAG,EAAE,CAAC;AACrB,CAAC;AAED;;;;;GAKG;AACH,SAAgB,YAAY;IAC1B,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACvB,iCAAiC;QACjC,kBAAkB,EAAE,CAAC;QAErB,yBAAyB;QACzB,iBAAiB,GAAG,KAAK,CAAC,SAAS,EAAE,CAAC;QAEtC,+BAA+B;QAC/B,iBAAiB,CAAC,QAAQ,CAAC;YACzB,yBAAyB,EAAE,IAAI;SAChC,CAAC,CAAC;QAEH,qBAAM,CAAC,IAAI,CAAC,4BAA4B,EAAE;YACxC,QAAQ,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,uBAAuB;SAChD,CAAC,CAAC;IACL,CAAC;IAED,OAAO,iBAAiB,CAAC;AAC3B,CAAC;AAED;;GAEG;AACH,SAAgB,OAAO;IACrB,kBAAkB,EAAE,CAAC;IACrB,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC;AACtB,CAAC;AAED;;GAEG;AACH,SAAgB,UAAU;IACxB,kBAAkB,EAAE,CAAC;IACrB,OAAO,KAAK,CAAC,OAAO,EAAE,CAAC;AACzB,CAAC;AAED;;GAEG;AACH,SAAgB,aAAa;IAC3B,iBAAiB,GAAG,IAAI,CAAC;IACzB,aAAa,GAAG,KAAK,CAAC;AACxB,CAAC;AAED;;GAEG;AACH,SAAgB,qBAAqB;IACnC,OAAO,aAAa,CAAC;AACvB,CAAC"}

package/lib/firestore-connector.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Generic Firebase configuration and database access utility
+ * Clean implementation without legacy compatibility
+ */
+import * as admin from 'firebase-admin';
+import { DatabaseConfig, DatabaseInstances, DatabaseConnectionResult, HealthCheckResult, FirebaseConnectionState, FirebaseInitOptions, Firestore } from './firebase-types';
+/**
+ * Generic Firestore Connector Class
+ * Can be configured for any project's database schema
+ */
+export declare class FirestoreConnector<TDatabaseNames extends string = string> {
+    private config;
+    private options;
+    private dbInstances;
+    private connectionState;
+    constructor(config: DatabaseConfig<TDatabaseNames>, options?: FirebaseInitOptions);
+    /**
+     * Initialize Firebase Admin SDK with service account
+     */
+    initializeFirebase(): void;
+    /**
+     * Initialize database instances based on configuration
+     */
+    private initializeDatabaseInstances;
+    /**
+     * Get all database instances, initializing if necessary
+     */
+    getDb(): DatabaseInstances<TDatabaseNames>;
+    /**
+     * Get specific database instance by name
+     */
+    getDbByName(dbName: TDatabaseNames): Firestore;
+    /**
+     * Get database instance with collection reference for convenience
+     */
+    getCollection(dbName: TDatabaseNames, collectionName: string): admin.firestore.CollectionReference<admin.firestore.DocumentData, admin.firestore.DocumentData>;
+    /**
+     * Test database connectivity for a specific database
+     */
+    testDatabaseConnection(dbName: TDatabaseNames): Promise<boolean>;
+    /**
+     * Test all database connections
+     */
+    testAllDatabaseConnections(): Promise<DatabaseConnectionResult<TDatabaseNames>>;
+    /**
+     * Health check for Firebase connection
+     */
+    healthCheck(): Promise<HealthCheckResult<TDatabaseNames>>;
+    /**
+     * Gracefully close Firebase connections
+     */
+    closeConnections(): Promise<void>;
+    /**
+     * Get current Firebase connection state
+     */
+    getConnectionState(): FirebaseConnectionState;
+    /**
+     * Reset connection state (useful for testing)
+     */
+    resetConnectionState(): void;
+    /**
+     * Check if Firebase is properly initialized
+     */
+    isInitialized(): boolean;
+    /**
+     * Get available database names from configuration
+     */
+    getDatabaseNames(): TDatabaseNames[];
+    /**
+     * Get collections for a specific database
+     */
+    getCollectionsForDatabase(dbName: TDatabaseNames): string[];
+    /**
+     * Get all collections across all databases
+     */
+    getAllCollections(): Record<TDatabaseNames, string[]>;
+}
+/**
+ * Factory function to create a simple single-database connector
+ */
+export declare const createSingleDatabaseConnector: (_projectId: string, collections: string[], options?: FirebaseInitOptions) => FirestoreConnector<"main">;
+/**
+ * Factory function to create a multi-database connector with custom names
+ */
+export declare const createMultiDatabaseConnector: <T extends string>(config: DatabaseConfig<T>, options?: FirebaseInitOptions) => FirestoreConnector<T>;
+//# sourceMappingURL=firestore-connector.d.ts.map

package/lib/firestore-connector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"firestore-connector.d.ts","sourceRoot":"","sources":["../src/firestore-connector.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,KAAK,MAAM,gBAAgB,CAAC;AAGxC,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,wBAAwB,EACxB,iBAAiB,EAEjB,uBAAuB,EAGvB,mBAAmB,EAInB,SAAS,EACV,MAAM,kBAAkB,CAAC;AAE1B;;;GAGG;AACH,qBAAa,kBAAkB,CAAC,cAAc,SAAS,MAAM,GAAG,MAAM;IAUlE,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,OAAO;IAVjB,OAAO,CAAC,WAAW,CAAkD;IACrE,OAAO,CAAC,eAAe,CAKrB;gBAGQ,MAAM,EAAE,cAAc,CAAC,cAAc,CAAC,EACtC,OAAO,GAAE,mBAAwB;IAG3C;;OAEG;IACI,kBAAkB,IAAI,IAAI;IA8CjC;;OAEG;IACH,OAAO,CAAC,2BAA2B;IA0CnC;;OAEG;IACI,KAAK,IAAI,iBAAiB,CAAC,cAAc,CAAC;IAYjD;;OAEG;IACI,WAAW,CAAC,MAAM,EAAE,cAAc,GAAG,SAAS;IAWrD;;OAEG;IACI,aAAa,CAAC,MAAM,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM;IAKnE;;OAEG;IACU,sBAAsB,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC;IAwD7E;;OAEG;IACU,0BAA0B,IAAI,OAAO,CAAC,wBAAwB,CAAC,cAAc,CAAC,CAAC;IAyC5F;;OAEG;IACU,WAAW,IAAI,OAAO,CAAC,iBAAiB,CAAC,cAAc,CAAC,CAAC;IAoCtE;;OAEG;IACU,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC;IA2B9C;;OAEG;IACI,kBAAkB,IAAI,uBAAuB;IAIpD;;OAEG;IACI,oBAAoB,IAAI,IAAI;IAUnC;;OAEG;IACI,aAAa,IAAI,OAAO;IAM/B;;OAEG;IACI,gBAAgB,IAAI,cAAc,EAAE;IAI3C;;OAEG;IACI,yBAAyB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,EAAE;IAQlE;;OAEG;IACI,iBAAiB,IAAI,MAAM,CAAC,cAAc,EAAE,MAAM,EAAE,CAAC;CAO7D;AAED;;GAEG;AACH,eAAO,MAAM,6BAA6B,GACxC,YAAY,MAAM,EAClB,aAAa,MAAM,EAAE,EACrB,UAAS,mBAAwB,KAChC,kBAAkB,CAAC,MAAM,CAS3B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,4BAA4B,GAAI,CAAC,SAAS,MAAM,EAC3D,QAAQ,cAAc,CAAC,CAAC,CAAC,EACzB,UAAS,mBAAwB,KAChC,kBAAkB,CAAC,CAAC,CAEtB,CAAC"}

package/lib/firestore-connector.js

@@ -0,0 +1,381 @@
+"use strict";
+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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createMultiDatabaseConnector = exports.createSingleDatabaseConnector = exports.FirestoreConnector = void 0;
+/**
+ * Generic Firebase configuration and database access utility
+ * Clean implementation without legacy compatibility
+ */
+const admin = __importStar(require("firebase-admin"));
+const firestore_1 = require("firebase-admin/firestore");
+const utils_logger_1 = require("@xbg/utils-logger");
+const firebase_types_1 = require("./firebase-types");
+/**
+ * Generic Firestore Connector Class
+ * Can be configured for any project's database schema
+ */
+class FirestoreConnector {
+    constructor(config, options = {}) {
+        this.config = config;
+        this.options = options;
+        this.dbInstances = null;
+        this.connectionState = {
+            initialized: false,
+            connected: false,
+            databasesInitialized: false,
+            connectionErrors: []
+        };
+    }
+    /**
+     * Initialize Firebase Admin SDK with service account
+     */
+    initializeFirebase() {
+        try {
+            // Check if already initialized (unless forcing reinitialize)
+            if (!this.options.forceReinitialize) {
+                try {
+                    admin.app();
+                    this.connectionState.initialized = true;
+                    utils_logger_1.logger.debug('Firebase already initialized');
+                }
+                catch (_a) {
+                    // Not initialized, continue with initialization
+                }
+            }
+            if (!this.connectionState.initialized || this.options.forceReinitialize) {
+                const environment = (0, firebase_types_1.detectEnvironment)();
+                if (environment.isFunctionsEnvironment) {
+                    // Use default initialization for Firebase Functions
+                    admin.initializeApp();
+                }
+                else {
+                    const firebaseConfig = (0, firebase_types_1.getFirebaseConfigFromEnv)();
+                    admin.initializeApp({
+                        credential: admin.credential.applicationDefault(),
+                        projectId: firebaseConfig.projectId,
+                        databaseURL: firebaseConfig.databaseURL,
+                        storageBucket: firebaseConfig.storageBucket,
+                    });
+                }
+                this.connectionState.initialized = true;
+                this.connectionState.connected = true;
+            }
+        }
+        catch (error) {
+            const firebaseError = (0, firebase_types_1.toError)(error);
+            this.connectionState.connectionErrors = this.connectionState.connectionErrors || [];
+            this.connectionState.connectionErrors.push(firebaseError);
+            throw firebaseError;
+        }
+        // Initialize database instances if not skipped
+        if (!this.options.skipDatabaseInit) {
+            this.initializeDatabaseInstances();
+        }
+    }
+    /**
+     * Initialize database instances based on configuration
+     */
+    initializeDatabaseInstances() {
+        try {
+            const environment = (0, firebase_types_1.detectEnvironment)();
+            const dbInstances = {};
+            if (environment.isEmulator) {
+                // Emulator doesn't support multiple databases - use same instance for all
+                const db = (0, firestore_1.getFirestore)();
+                for (const dbName of this.getDatabaseNames()) {
+                    dbInstances[dbName] = db;
+                }
+                utils_logger_1.logger.warn('Running in emulator mode - all databases point to same Firestore instance', {
+                    operation: 'initializeDatabaseInstances',
+                    emulator: true,
+                    databases: this.getDatabaseNames()
+                });
+            }
+            else {
+                // Production: Use named databases
+                for (const [dbName, dbConfig] of Object.entries(this.config)) {
+                    const firestoreName = dbConfig.firestoreName || dbName;
+                    dbInstances[dbName] = (0, firestore_1.getFirestore)(admin.app(), firestoreName);
+                }
+                utils_logger_1.logger.info(`Initialized ${this.getDatabaseNames().length} named Firestore databases`, {
+                    operation: 'initializeDatabaseInstances',
+                    production: true,
+                    databases: this.getDatabaseNames()
+                });
+            }
+            this.dbInstances = dbInstances;
+            this.connectionState.databasesInitialized = true;
+        }
+        catch (error) {
+            const firebaseError = (0, firebase_types_1.toError)(error);
+            this.connectionState.connectionErrors = this.connectionState.connectionErrors || [];
+            this.connectionState.connectionErrors.push(firebaseError);
+            throw firebaseError;
+        }
+    }
+    /**
+     * Get all database instances, initializing if necessary
+     */
+    getDb() {
+        if (!this.dbInstances) {
+            this.initializeFirebase();
+        }
+        if (!this.dbInstances) {
+            throw new Error('Failed to initialize Firebase database instances');
+        }
+        return this.dbInstances;
+    }
+    /**
+     * Get specific database instance by name
+     */
+    getDbByName(dbName) {
+        const databases = this.getDb();
+        const db = databases[dbName];
+        if (!db) {
+            throw new Error(`Database instance '${String(dbName)}' not found`);
+        }
+        return db;
+    }
+    /**
+     * Get database instance with collection reference for convenience
+     */
+    getCollection(dbName, collectionName) {
+        const db = this.getDbByName(dbName);
+        return db.collection(collectionName);
+    }
+    /**
+     * Test database connectivity for a specific database
+     */
+    async testDatabaseConnection(dbName) {
+        const baseContext = {
+            operation: 'testDatabaseConnection',
+            dbName: String(dbName),
+            firebaseOperation: firebase_types_1.FirebaseOperation.CONNECTION_TEST,
+            connectionTest: true
+        };
+        try {
+            const db = this.getDbByName(dbName);
+            // Test by writing and reading a test document
+            const testCollection = 'connection-test';
+            const testDocId = `test-${Date.now()}`;
+            const testData = {
+                timestamp: admin.firestore.FieldValue.serverTimestamp(),
+                test: true,
+                database: String(dbName)
+            };
+            // Write test document
+            await db.collection(testCollection).doc(testDocId).set(testData);
+            utils_logger_1.logger.debug('Test document written', Object.assign(Object.assign({}, baseContext), { collection: testCollection, docId: testDocId, firebaseOperation: firebase_types_1.FirebaseOperation.WRITE }));
+            // Read test document
+            const doc = await db.collection(testCollection).doc(testDocId).get();
+            if (!doc.exists) {
+                throw new Error('Test document not found after write');
+            }
+            // Clean up test document
+            await db.collection(testCollection).doc(testDocId).delete();
+            utils_logger_1.logger.debug('Test document cleaned up', Object.assign(Object.assign({}, baseContext), { collection: testCollection, docId: testDocId, firebaseOperation: firebase_types_1.FirebaseOperation.DELETE }));
+            utils_logger_1.logger.info(`Database connection test passed for ${String(dbName)}`, baseContext);
+            return true;
+        }
+        catch (error) {
+            const firebaseError = (0, firebase_types_1.toError)(error);
+            utils_logger_1.logger.error(`Database connection test failed for ${String(dbName)}`, firebaseError, baseContext);
+            return false;
+        }
+    }
+    /**
+     * Test all database connections
+     */
+    async testAllDatabaseConnections() {
+        const context = {
+            operation: 'testAllDatabaseConnections',
+            firebaseOperation: firebase_types_1.FirebaseOperation.CONNECTION_TEST
+        };
+        utils_logger_1.logger.info('Testing all database connections', context);
+        const databases = this.getDb();
+        const results = {};
+        for (const dbName of Object.keys(databases)) {
+            try {
+                results[dbName] = await this.testDatabaseConnection(dbName);
+            }
+            catch (error) {
+                const firebaseError = (0, firebase_types_1.toError)(error);
+                utils_logger_1.logger.error(`Failed to test database connection for ${String(dbName)}`, firebaseError, Object.assign(Object.assign({}, context), { dbName: String(dbName) }));
+                results[dbName] = false;
+            }
+        }
+        const successCount = Object.values(results).filter(Boolean).length;
+        const totalCount = Object.keys(results).length;
+        if (successCount === totalCount) {
+            utils_logger_1.logger.info(`All ${totalCount} database connections tested successfully`, Object.assign(Object.assign({}, context), { metadata: { results, successCount, totalCount } }));
+        }
+        else {
+            utils_logger_1.logger.warn(`Database connection tests: ${successCount}/${totalCount} passed`, Object.assign(Object.assign({}, context), { metadata: { results, successCount, totalCount } }));
+        }
+        return results;
+    }
+    /**
+     * Health check for Firebase connection
+     */
+    async healthCheck() {
+        const context = {
+            operation: 'healthCheck',
+            firebaseOperation: firebase_types_1.FirebaseOperation.HEALTH_CHECK,
+            healthCheck: true
+        };
+        try {
+            // Test Firebase admin connectivity
+            const app = admin.app();
+            const firebaseHealthy = !!app;
+            // Test all database connections
+            const databaseResults = await this.testAllDatabaseConnections();
+            const result = {
+                firebase: firebaseHealthy,
+                databases: databaseResults,
+                timestamp: new Date()
+            };
+            this.connectionState.lastHealthCheck = result.timestamp;
+            utils_logger_1.logger.info('Firebase health check completed', Object.assign(Object.assign({}, context), { metadata: { result } }));
+            return result;
+        }
+        catch (error) {
+            const firebaseError = (0, firebase_types_1.toError)(error);
+            utils_logger_1.logger.error('Firebase health check failed', firebaseError, context);
+            throw firebaseError;
+        }
+    }
+    /**
+     * Gracefully close Firebase connections
+     */
+    async closeConnections() {
+        const context = {
+            operation: 'closeConnections',
+            firebaseOperation: firebase_types_1.FirebaseOperation.DISCONNECT
+        };
+        try {
+            if (this.dbInstances) {
+                // Firebase Admin SDK doesn't require explicit connection closing
+                // but we can clean up our references
+                this.dbInstances = null;
+                this.connectionState.databasesInitialized = false;
+                utils_logger_1.logger.info('Firebase database instances cleared', context);
+            }
+            // Delete the default app to fully clean up
+            await admin.app().delete();
+            this.connectionState.initialized = false;
+            this.connectionState.connected = false;
+            utils_logger_1.logger.info('Firebase connections closed successfully', context);
+        }
+        catch (error) {
+            const firebaseError = (0, firebase_types_1.toError)(error);
+            utils_logger_1.logger.error('Error closing Firebase connections', firebaseError, context);
+            throw firebaseError;
+        }
+    }
+    /**
+     * Get current Firebase connection state
+     */
+    getConnectionState() {
+        return Object.assign({}, this.connectionState);
+    }
+    /**
+     * Reset connection state (useful for testing)
+     */
+    resetConnectionState() {
+        this.connectionState = {
+            initialized: false,
+            connected: false,
+            databasesInitialized: false,
+            connectionErrors: []
+        };
+        this.dbInstances = null;
+    }
+    /**
+     * Check if Firebase is properly initialized
+     */
+    isInitialized() {
+        return this.connectionState.initialized &&
+            this.connectionState.databasesInitialized &&
+            this.dbInstances !== null;
+    }
+    /**
+     * Get available database names from configuration
+     */
+    getDatabaseNames() {
+        return Object.keys(this.config);
+    }
+    /**
+     * Get collections for a specific database
+     */
+    getCollectionsForDatabase(dbName) {
+        const dbConfig = this.config[dbName];
+        if (!dbConfig) {
+            throw new Error(`Database configuration for '${String(dbName)}' not found`);
+        }
+        return dbConfig.collections;
+    }
+    /**
+     * Get all collections across all databases
+     */
+    getAllCollections() {
+        const result = {};
+        for (const [dbName, dbConfig] of Object.entries(this.config)) {
+            result[dbName] = dbConfig.collections;
+        }
+        return result;
+    }
+}
+exports.FirestoreConnector = FirestoreConnector;
+/**
+ * Factory function to create a simple single-database connector
+ */
+const createSingleDatabaseConnector = (_projectId, collections, options = {}) => {
+    const config = {
+        main: {
+            collections,
+            emulatorSupport: true
+        }
+    };
+    return new FirestoreConnector(config, options);
+};
+exports.createSingleDatabaseConnector = createSingleDatabaseConnector;
+/**
+ * Factory function to create a multi-database connector with custom names
+ */
+const createMultiDatabaseConnector = (config, options = {}) => {
+    return new FirestoreConnector(config, options);
+};
+exports.createMultiDatabaseConnector = createMultiDatabaseConnector;
+//# sourceMappingURL=firestore-connector.js.map

package/lib/firestore-connector.js.map

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

package/lib/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Firebase utilities barrel export
+ * Clean API without legacy compatibility
+ */
+export * from './firebase-types';
+export * from './firestore-connector';
+export * from './firebase';
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,cAAc,kBAAkB,CAAC;AAGjC,cAAc,uBAAuB,CAAC;AAGtC,cAAc,YAAY,CAAC"}

package/lib/index.js

@@ -0,0 +1,27 @@
+"use strict";
+/**
+ * Firebase utilities barrel export
+ * Clean API without legacy compatibility
+ */
+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 });
+// Core types and utilities
+__exportStar(require("./firebase-types"), exports);
+// Generic connector implementation
+__exportStar(require("./firestore-connector"), exports);
+// Firebase Admin SDK initialization
+__exportStar(require("./firebase"), exports);
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;;;;;;;;;;;;AAEH,2BAA2B;AAC3B,mDAAiC;AAEjC,mCAAmC;AACnC,wDAAsC;AAEtC,oCAAoC;AACpC,6CAA2B"}

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@xbg.solutions/utils-firestore-connector",
+  "version": "1.0.0",
+  "description": "Multi-database Firestore access",
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "files": [
+    "lib"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "build:watch": "tsc --watch",
+    "clean": "rm -rf lib",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@xbg/utils-logger": "^1.0.0",
+    "firebase-admin": "^12.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.0",
+    "typescript": "^5.3.3"
+  },
+  "engines": {
+    "node": "22"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}