@xbg.solutions/utils-firebase-event-bridge 1.0.0

package/lib/adapters/auth-adapter.d.ts

@@ -0,0 +1,32 @@
+import { Logger } from '@xbg/utils-logger';
+import { AuthOperation } from '../config-types';
+import { NormalizedFirebaseEvent } from '../normalizer';
+export declare class AuthAdapter {
+    private readonly logger;
+    private readonly eventHandler;
+    constructor(logger: Logger, eventHandler: (event: NormalizedFirebaseEvent) => void);
+    /**
+     * Create Auth trigger for a specific operation
+     *
+     * Note: Firebase Functions v2 uses blocking functions (beforeUserCreated)
+     * rather than event functions. For true event-based triggers, we need to
+     * use Firestore triggers on the users collection instead.
+     */
+    createTrigger(operation: AuthOperation): any;
+    /**
+     * Create trigger for user creation
+     * Uses Firestore trigger on users collection as workaround
+     * since Firebase Auth doesn't provide direct onCreate events in v2
+     */
+    private createOnUserCreated;
+    /**
+     * Create trigger for user deletion
+     * Uses Firestore trigger on users collection
+     */
+    private createOnUserDeleted;
+    /**
+     * Generate trigger function name
+     */
+    static generateTriggerName(operation: string): string;
+}
+//# sourceMappingURL=auth-adapter.d.ts.map

package/lib/adapters/auth-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/auth-adapter.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAsB,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAE5E,qBAAa,WAAW;IAEpB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,YAAY;gBADZ,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,CAAC,KAAK,EAAE,uBAAuB,KAAK,IAAI;IAGzE;;;;;;OAMG;IACH,aAAa,CAAC,SAAS,EAAE,aAAa,GAAG,GAAG;IAS5C;;;;OAIG;IACH,OAAO,CAAC,mBAAmB;IA6B3B;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IA6B3B;;OAEG;IACH,MAAM,CAAC,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;CAItD"}

package/lib/adapters/auth-adapter.js

@@ -0,0 +1,78 @@
+"use strict";
+// src/utilities/firebase-event-bridge/adapters/auth-adapter.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AuthAdapter = void 0;
+const normalizer_1 = require("../normalizer");
+class AuthAdapter {
+    constructor(logger, eventHandler) {
+        this.logger = logger;
+        this.eventHandler = eventHandler;
+    }
+    /**
+     * Create Auth trigger for a specific operation
+     *
+     * Note: Firebase Functions v2 uses blocking functions (beforeUserCreated)
+     * rather than event functions. For true event-based triggers, we need to
+     * use Firestore triggers on the users collection instead.
+     */
+    createTrigger(operation) {
+        switch (operation) {
+            case 'create':
+                return this.createOnUserCreated();
+            case 'delete':
+                return this.createOnUserDeleted();
+        }
+    }
+    /**
+     * Create trigger for user creation
+     * Uses Firestore trigger on users collection as workaround
+     * since Firebase Auth doesn't provide direct onCreate events in v2
+     */
+    createOnUserCreated() {
+        // Import here to avoid circular dependency
+        const { onDocumentCreated } = require('firebase-functions/v2/firestore');
+        return onDocumentCreated({ document: 'users/{userId}', database: 'identity' }, async (event) => {
+            var _a;
+            const userId = event.params.userId;
+            const userData = (_a = event.data) === null || _a === void 0 ? void 0 : _a.data();
+            // ✅ Safe logging - only userId
+            this.logger.debug('Auth user created (via Firestore)', {
+                userId,
+                operation: 'create'
+                // ❌ NEVER LOG: userData
+            });
+            const normalizedEvent = (0, normalizer_1.normalizeAuthEvent)('created', userId, userData, this.logger);
+            this.eventHandler(normalizedEvent);
+        });
+    }
+    /**
+     * Create trigger for user deletion
+     * Uses Firestore trigger on users collection
+     */
+    createOnUserDeleted() {
+        // Import here to avoid circular dependency
+        const { onDocumentDeleted } = require('firebase-functions/v2/firestore');
+        return onDocumentDeleted({ document: 'users/{userId}', database: 'identity' }, async (event) => {
+            var _a;
+            const userId = event.params.userId;
+            const userData = (_a = event.data) === null || _a === void 0 ? void 0 : _a.data();
+            // ✅ Safe logging - only userId
+            this.logger.debug('Auth user deleted (via Firestore)', {
+                userId,
+                operation: 'delete'
+                // ❌ NEVER LOG: userData
+            });
+            const normalizedEvent = (0, normalizer_1.normalizeAuthEvent)('deleted', userId, userData, this.logger);
+            this.eventHandler(normalizedEvent);
+        });
+    }
+    /**
+     * Generate trigger function name
+     */
+    static generateTriggerName(operation) {
+        const operationName = operation.charAt(0).toUpperCase() + operation.slice(1);
+        return `authUser${operationName}`;
+    }
+}
+exports.AuthAdapter = AuthAdapter;
+//# sourceMappingURL=auth-adapter.js.map

package/lib/adapters/auth-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-adapter.js","sourceRoot":"","sources":["../../src/adapters/auth-adapter.ts"],"names":[],"mappings":";AAAA,+DAA+D;;;AAI/D,8CAA4E;AAE5E,MAAa,WAAW;IACtB,YACmB,MAAc,EACd,YAAsD;QADtD,WAAM,GAAN,MAAM,CAAQ;QACd,iBAAY,GAAZ,YAAY,CAA0C;IACtE,CAAC;IAEJ;;;;;;OAMG;IACH,aAAa,CAAC,SAAwB;QACpC,QAAQ,SAAS,EAAE,CAAC;YAClB,KAAK,QAAQ;gBACX,OAAO,IAAI,CAAC,mBAAmB,EAAE,CAAC;YACpC,KAAK,QAAQ;gBACX,OAAO,IAAI,CAAC,mBAAmB,EAAE,CAAC;QACtC,CAAC;IACH,CAAC;IAED;;;;OAIG;IACK,mBAAmB;QACzB,2CAA2C;QAC3C,MAAM,EAAE,iBAAiB,EAAE,GAAG,OAAO,CAAC,iCAAiC,CAAC,CAAC;QAEzE,OAAO,iBAAiB,CACtB,EAAE,QAAQ,EAAE,gBAAgB,EAAE,QAAQ,EAAE,UAAU,EAAE,EACpD,KAAK,EAAE,KAAU,EAAE,EAAE;;YACnB,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC;YACnC,MAAM,QAAQ,GAAG,MAAA,KAAK,CAAC,IAAI,0CAAE,IAAI,EAAE,CAAC;YAEpC,+BAA+B;YAC/B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,mCAAmC,EAAE;gBACrD,MAAM;gBACN,SAAS,EAAE,QAAQ;gBACnB,wBAAwB;aACzB,CAAC,CAAC;YAEH,MAAM,eAAe,GAAG,IAAA,+BAAkB,EACxC,SAAS,EACT,MAAM,EACN,QAAQ,EACR,IAAI,CAAC,MAAM,CACZ,CAAC;YAEF,IAAI,CAAC,YAAY,CAAC,eAAe,CAAC,CAAC;QACrC,CAAC,CACF,CAAC;IACJ,CAAC;IAED;;;OAGG;IACK,mBAAmB;QACzB,2CAA2C;QAC3C,MAAM,EAAE,iBAAiB,EAAE,GAAG,OAAO,CAAC,iCAAiC,CAAC,CAAC;QAEzE,OAAO,iBAAiB,CACtB,EAAE,QAAQ,EAAE,gBAAgB,EAAE,QAAQ,EAAE,UAAU,EAAE,EACpD,KAAK,EAAE,KAAU,EAAE,EAAE;;YACnB,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC;YACnC,MAAM,QAAQ,GAAG,MAAA,KAAK,CAAC,IAAI,0CAAE,IAAI,EAAE,CAAC;YAEpC,+BAA+B;YAC/B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,mCAAmC,EAAE;gBACrD,MAAM;gBACN,SAAS,EAAE,QAAQ;gBACnB,wBAAwB;aACzB,CAAC,CAAC;YAEH,MAAM,eAAe,GAAG,IAAA,+BAAkB,EACxC,SAAS,EACT,MAAM,EACN,QAAQ,EACR,IAAI,CAAC,MAAM,CACZ,CAAC;YAEF,IAAI,CAAC,YAAY,CAAC,eAAe,CAAC,CAAC;QACrC,CAAC,CACF,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,mBAAmB,CAAC,SAAiB;QAC1C,MAAM,aAAa,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC7E,OAAO,WAAW,aAAa,EAAE,CAAC;IACpC,CAAC;CACF;AAhGD,kCAgGC"}

package/lib/adapters/firestore-adapter.d.ts

@@ -0,0 +1,33 @@
+import { Logger } from '@xbg/utils-logger';
+import { DatabaseName, FirestoreCollectionConfig, FirestoreOperation } from '../config-types';
+import { NormalizedFirebaseEvent } from '../normalizer';
+export declare class FirestoreAdapter {
+    private readonly logger;
+    private readonly eventHandler;
+    constructor(logger: Logger, eventHandler: (event: NormalizedFirebaseEvent) => void);
+    /**
+     * Create Firestore trigger for a specific operation
+     */
+    createTrigger(databaseName: DatabaseName, config: FirestoreCollectionConfig, operation: FirestoreOperation): any;
+    /**
+     * Map DatabaseName to Firebase database identifier
+     */
+    private getDatabaseIdentifier;
+    /**
+     * Create onCreate trigger
+     */
+    private createOnCreate;
+    /**
+     * Create onUpdate trigger
+     */
+    private createOnUpdate;
+    /**
+     * Create onDelete trigger
+     */
+    private createOnDelete;
+    /**
+     * Generate trigger function name
+     */
+    static generateTriggerName(databaseName: string, collectionPath: string, operation: string, eventNameOverride?: string): string;
+}
+//# sourceMappingURL=firestore-adapter.d.ts.map

package/lib/adapters/firestore-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"firestore-adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/firestore-adapter.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,yBAAyB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAC9F,OAAO,EAAkD,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAExG,qBAAa,gBAAgB;IAEzB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,YAAY;gBADZ,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,CAAC,KAAK,EAAE,uBAAuB,KAAK,IAAI;IAGzE;;OAEG;IACH,aAAa,CACX,YAAY,EAAE,YAAY,EAC1B,MAAM,EAAE,yBAAyB,EACjC,SAAS,EAAE,kBAAkB,GAC5B,GAAG;IAcN;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAQ7B;;OAEG;IACH,OAAO,CAAC,cAAc;IAqCtB;;OAEG;IACH,OAAO,CAAC,cAAc;IAuCtB;;OAEG;IACH,OAAO,CAAC,cAAc;IAqCtB;;OAEG;IACH,MAAM,CAAC,mBAAmB,CACxB,YAAY,EAAE,MAAM,EACpB,cAAc,EAAE,MAAM,EACtB,SAAS,EAAE,MAAM,EACjB,iBAAiB,CAAC,EAAE,MAAM,GACzB,MAAM;CAqBV"}

package/lib/adapters/firestore-adapter.js

@@ -0,0 +1,118 @@
+"use strict";
+// src/utilities/firebase-event-bridge/adapters/firestore-adapter.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FirestoreAdapter = void 0;
+const firestore_1 = require("firebase-functions/v2/firestore");
+const normalizer_1 = require("../normalizer");
+class FirestoreAdapter {
+    constructor(logger, eventHandler) {
+        this.logger = logger;
+        this.eventHandler = eventHandler;
+    }
+    /**
+     * Create Firestore trigger for a specific operation
+     */
+    createTrigger(databaseName, config, operation) {
+        const documentPath = `${config.path}/{id}`;
+        const database = this.getDatabaseIdentifier(databaseName);
+        switch (operation) {
+            case 'create':
+                return this.createOnCreate(databaseName, database, documentPath, config);
+            case 'update':
+                return this.createOnUpdate(databaseName, database, documentPath, config);
+            case 'delete':
+                return this.createOnDelete(databaseName, database, documentPath, config);
+        }
+    }
+    /**
+     * Map DatabaseName to Firebase database identifier
+     */
+    getDatabaseIdentifier(databaseName) {
+        const mapping = {
+            main: process.env.MAIN_DATABASE_ID || '(default)',
+            analytics: process.env.ANALYTICS_DATABASE_ID || 'analytics',
+        };
+        return mapping[databaseName] || databaseName;
+    }
+    /**
+     * Create onCreate trigger
+     */
+    createOnCreate(databaseName, database, documentPath, config) {
+        return (0, firestore_1.onDocumentCreated)({ document: documentPath, database }, async (event) => {
+            var _a;
+            const documentId = event.params.id;
+            const data = config.includeData ? (_a = event.data) === null || _a === void 0 ? void 0 : _a.data() : undefined;
+            // Safe logging - only metadata
+            this.logger.debug('Firestore onCreate triggered', {
+                databaseName,
+                collection: config.path,
+                documentId,
+                operation: 'create'
+            });
+            const collectionName = (0, normalizer_1.extractCollectionName)(config.path);
+            const normalizedEvent = (0, normalizer_1.normalizeFirestoreEvent)('created', event.document, documentId, databaseName, collectionName, data, this.logger, config.eventNameOverride);
+            this.eventHandler(normalizedEvent);
+        });
+    }
+    /**
+     * Create onUpdate trigger
+     */
+    createOnUpdate(databaseName, database, documentPath, config) {
+        return (0, firestore_1.onDocumentUpdated)({ document: documentPath, database }, async (event) => {
+            var _a, _b;
+            const documentId = event.params.id;
+            const before = config.includeData ? (_a = event.data) === null || _a === void 0 ? void 0 : _a.before.data() : undefined;
+            const after = config.includeData ? (_b = event.data) === null || _b === void 0 ? void 0 : _b.after.data() : undefined;
+            // Safe logging - only metadata
+            this.logger.debug('Firestore onUpdate triggered', {
+                databaseName,
+                collection: config.path,
+                documentId,
+                operation: 'update'
+            });
+            const collectionName = (0, normalizer_1.extractCollectionName)(config.path);
+            const normalizedEvent = (0, normalizer_1.normalizeFirestoreEvent)('updated', event.document, documentId, databaseName, collectionName, after, this.logger, config.eventNameOverride, config.includeData ? { before, after } : undefined);
+            this.eventHandler(normalizedEvent);
+        });
+    }
+    /**
+     * Create onDelete trigger
+     */
+    createOnDelete(databaseName, database, documentPath, config) {
+        return (0, firestore_1.onDocumentDeleted)({ document: documentPath, database }, async (event) => {
+            var _a;
+            const documentId = event.params.id;
+            const data = config.includeData ? (_a = event.data) === null || _a === void 0 ? void 0 : _a.data() : undefined;
+            // Safe logging - only metadata
+            this.logger.debug('Firestore onDelete triggered', {
+                databaseName,
+                collection: config.path,
+                documentId,
+                operation: 'delete'
+            });
+            const collectionName = (0, normalizer_1.extractCollectionName)(config.path);
+            const normalizedEvent = (0, normalizer_1.normalizeFirestoreEvent)('deleted', event.document, documentId, databaseName, collectionName, data, this.logger, config.eventNameOverride);
+            this.eventHandler(normalizedEvent);
+        });
+    }
+    /**
+     * Generate trigger function name
+     */
+    static generateTriggerName(databaseName, collectionPath, operation, eventNameOverride) {
+        // Use database name as prefix
+        const dbPrefix = databaseName;
+        // Use override if provided, otherwise extract from path
+        const collection = eventNameOverride || (0, normalizer_1.extractCollectionName)(collectionPath);
+        // Convert to camelCase and capitalize first letter
+        const collectionName = collection
+            .split('_')
+            .map((part, index) => index === 0
+            ? part.charAt(0).toUpperCase() + part.slice(1)
+            : part.charAt(0).toUpperCase() + part.slice(1))
+            .join('');
+        const operationName = operation.charAt(0).toUpperCase() + operation.slice(1);
+        return `${dbPrefix}${collectionName}${operationName}`;
+    }
+}
+exports.FirestoreAdapter = FirestoreAdapter;
+//# sourceMappingURL=firestore-adapter.js.map

package/lib/adapters/firestore-adapter.js.map

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

package/lib/adapters/storage-adapter.d.ts

@@ -0,0 +1,21 @@
+import { Logger } from '@xbg/utils-logger';
+import { StorageConfig } from '../config-types';
+import { NormalizedFirebaseEvent } from '../normalizer';
+export declare class StorageAdapter {
+    private readonly logger;
+    private readonly eventHandler;
+    constructor(logger: Logger, eventHandler: (event: NormalizedFirebaseEvent) => void);
+    /**
+     * Create Storage trigger
+     */
+    createTrigger(config: StorageConfig): any;
+    /**
+     * Check if file path matches any configured pattern
+     */
+    private matchesPathPattern;
+    /**
+     * Generate trigger function name
+     */
+    static generateTriggerName(): string;
+}
+//# sourceMappingURL=storage-adapter.d.ts.map

package/lib/adapters/storage-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/storage-adapter.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAyB,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAE/E,qBAAa,cAAc;IAEvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,YAAY;gBADZ,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,CAAC,KAAK,EAAE,uBAAuB,KAAK,IAAI;IAGzE;;OAEG;IACH,aAAa,CAAC,MAAM,EAAE,aAAa,GAAG,GAAG;IA0CzC;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAe1B;;OAEG;IACH,MAAM,CAAC,mBAAmB,IAAI,MAAM;CAGrC"}

package/lib/adapters/storage-adapter.js

@@ -0,0 +1,71 @@
+"use strict";
+// src/utilities/firebase-event-bridge/adapters/storage-adapter.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StorageAdapter = void 0;
+const storage_1 = require("firebase-functions/v2/storage");
+const normalizer_1 = require("../normalizer");
+class StorageAdapter {
+    constructor(logger, eventHandler) {
+        this.logger = logger;
+        this.eventHandler = eventHandler;
+    }
+    /**
+     * Create Storage trigger
+     */
+    createTrigger(config) {
+        return (0, storage_1.onObjectFinalized)(async (event) => {
+            const filePath = event.data.name;
+            // Check if file matches configured path patterns
+            if (!this.matchesPathPattern(filePath, config.pathPatterns)) {
+                this.logger.debug('Storage event skipped - path not matched', {
+                    filePath,
+                    patterns: config.pathPatterns
+                });
+                return;
+            }
+            const metadata = config.includeMetadata ? {
+                name: event.data.name,
+                bucket: event.data.bucket,
+                contentType: event.data.contentType,
+                size: event.data.size,
+                timeCreated: event.data.timeCreated,
+                updated: event.data.updated,
+                metadata: event.data.metadata,
+                md5Hash: event.data.md5Hash
+            } : undefined;
+            // ✅ Safe logging - only file path
+            this.logger.debug('Storage onFinalized triggered', {
+                filePath,
+                contentType: event.data.contentType,
+                size: event.data.size
+                // ❌ NEVER LOG: metadata content (may contain user-uploaded info)
+            });
+            const normalizedEvent = (0, normalizer_1.normalizeStorageEvent)(filePath, metadata, this.logger);
+            this.eventHandler(normalizedEvent);
+        });
+    }
+    /**
+     * Check if file path matches any configured pattern
+     */
+    matchesPathPattern(filePath, patterns) {
+        return patterns.some(pattern => {
+            // Convert glob pattern to regex
+            // 'items/**' -> '^items/.*$'
+            // 'profiles/*' -> '^profiles/[^/]+$'
+            const regexPattern = pattern
+                .replace(/\*\*/g, '.*')
+                .replace(/\*/g, '[^/]+')
+                .replace(/\//g, '\\/');
+            const regex = new RegExp(`^${regexPattern}$`);
+            return regex.test(filePath);
+        });
+    }
+    /**
+     * Generate trigger function name
+     */
+    static generateTriggerName() {
+        return 'storageObjectFinalized';
+    }
+}
+exports.StorageAdapter = StorageAdapter;
+//# sourceMappingURL=storage-adapter.js.map

package/lib/adapters/storage-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-adapter.js","sourceRoot":"","sources":["../../src/adapters/storage-adapter.ts"],"names":[],"mappings":";AAAA,kEAAkE;;;AAElE,2DAAkE;AAGlE,8CAA+E;AAE/E,MAAa,cAAc;IACzB,YACmB,MAAc,EACd,YAAsD;QADtD,WAAM,GAAN,MAAM,CAAQ;QACd,iBAAY,GAAZ,YAAY,CAA0C;IACtE,CAAC;IAEJ;;OAEG;IACH,aAAa,CAAC,MAAqB;QACjC,OAAO,IAAA,2BAAiB,EAAC,KAAK,EAAE,KAAK,EAAE,EAAE;YACvC,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;YAEjC,iDAAiD;YACjD,IAAI,CAAC,IAAI,CAAC,kBAAkB,CAAC,QAAQ,EAAE,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC;gBAC5D,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,0CAA0C,EAAE;oBAC5D,QAAQ;oBACR,QAAQ,EAAE,MAAM,CAAC,YAAY;iBAC9B,CAAC,CAAC;gBACH,OAAO;YACT,CAAC;YAED,MAAM,QAAQ,GAAG,MAAM,CAAC,eAAe,CAAC,CAAC,CAAC;gBACxC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI;gBACrB,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM;gBACzB,WAAW,EAAE,KAAK,CAAC,IAAI,CAAC,WAAW;gBACnC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI;gBACrB,WAAW,EAAE,KAAK,CAAC,IAAI,CAAC,WAAW;gBACnC,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,OAAO;gBAC3B,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,QAAQ;gBAC7B,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,OAAO;aAC5B,CAAC,CAAC,CAAC,SAAS,CAAC;YAEd,kCAAkC;YAClC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,+BAA+B,EAAE;gBACjD,QAAQ;gBACR,WAAW,EAAE,KAAK,CAAC,IAAI,CAAC,WAAW;gBACnC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI;gBACrB,iEAAiE;aAClE,CAAC,CAAC;YAEH,MAAM,eAAe,GAAG,IAAA,kCAAqB,EAC3C,QAAQ,EACR,QAAQ,EACR,IAAI,CAAC,MAAM,CACZ,CAAC;YAEF,IAAI,CAAC,YAAY,CAAC,eAAe,CAAC,CAAC;QACrC,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACK,kBAAkB,CAAC,QAAgB,EAAE,QAAkB;QAC7D,OAAO,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE;YAC7B,gCAAgC;YAChC,6BAA6B;YAC7B,qCAAqC;YACrC,MAAM,YAAY,GAAG,OAAO;iBACzB,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC;iBACtB,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC;iBACvB,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;YAEzB,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,IAAI,YAAY,GAAG,CAAC,CAAC;YAC9C,OAAO,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC9B,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,mBAAmB;QACxB,OAAO,wBAAwB,CAAC;IAClC,CAAC;CACF;AA3ED,wCA2EC"}

package/lib/bridge.d.ts

@@ -0,0 +1,36 @@
+import { FirebaseEventBridgeConfig } from './config-types';
+import { NormalizedFirebaseEvent } from './normalizer';
+/**
+ * Type for the event mapping function provided at app startup.
+ * Maps a Firebase event name + normalized event to a domain event + payload,
+ * or returns null/undefined if no mapping exists.
+ */
+export type MapFirebaseEventToDomainFn = (eventName: string, event: NormalizedFirebaseEvent) => {
+    domainEvent: string;
+    domainPayload: any;
+} | null | undefined;
+/**
+ * Initialize the Firebase Event Bridge with the event mapping function.
+ * Must be called at app startup before generating triggers.
+ */
+export declare function initializeFirebaseEventBridge(mapFn: MapFirebaseEventToDomainFn): void;
+export declare class FirebaseEventBridge {
+    private readonly logger;
+    private readonly config;
+    private readonly triggerFactory;
+    constructor(config: FirebaseEventBridgeConfig);
+    /**
+     * Generate all Firebase trigger functions based on config
+     */
+    generateTriggers(): Record<string, any>;
+    /**
+     * Central event handler - publishes to event bus with error handling
+     *
+     * Maps Firebase-specific events to platform-agnostic domain events.
+     * This ensures subscribers remain unaware of the event source.
+     *
+     * ⚠️ LOGGING SAFETY: Never logs event payload (raw data)
+     */
+    private handleEvent;
+}
+//# sourceMappingURL=bridge.d.ts.map

package/lib/bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.d.ts","sourceRoot":"","sources":["../src/bridge.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAE3D,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAEvD;;;;GAIG;AACH,MAAM,MAAM,0BAA0B,GAAG,CACvC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,uBAAuB,KAC3B;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,GAAG,CAAA;CAAE,GAAG,IAAI,GAAG,SAAS,CAAC;AAKpE;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,0BAA0B,GAAG,IAAI,CAErF;AAED,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA4B;IACnD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAiB;gBAEpC,MAAM,EAAE,yBAAyB;IAW7C;;OAEG;IACH,gBAAgB,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAqCvC;;;;;;;OAOG;IACH,OAAO,CAAC,WAAW;CA2DpB"}

package/lib/bridge.js

@@ -0,0 +1,117 @@
+"use strict";
+// src/utilities/firebase-event-bridge/bridge.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FirebaseEventBridge = void 0;
+exports.initializeFirebaseEventBridge = initializeFirebaseEventBridge;
+const utils_logger_1 = require("@xbg/utils-logger");
+const trigger_factory_1 = require("./trigger-factory");
+// Event mapping function is provided via initializeFirebaseEventBridge() at app startup
+let mapFirebaseEventToDomain = null;
+/**
+ * Initialize the Firebase Event Bridge with the event mapping function.
+ * Must be called at app startup before generating triggers.
+ */
+function initializeFirebaseEventBridge(mapFn) {
+    mapFirebaseEventToDomain = mapFn;
+}
+class FirebaseEventBridge {
+    constructor(config) {
+        this.config = config;
+        this.logger = new utils_logger_1.Logger('firebase-event-bridge', {
+            component: 'firebase-event-bridge'
+        });
+        this.triggerFactory = new trigger_factory_1.TriggerFactory(this.logger, this.handleEvent.bind(this));
+    }
+    /**
+     * Generate all Firebase trigger functions based on config
+     */
+    generateTriggers() {
+        var _a, _b, _c, _d, _e, _f;
+        const triggers = {};
+        // Generate Firestore triggers
+        if ((_a = this.config.firestore) === null || _a === void 0 ? void 0 : _a.enabled) {
+            const firestoreTriggers = this.triggerFactory.generateFirestoreTriggers(this.config.firestore);
+            Object.assign(triggers, firestoreTriggers);
+        }
+        // Generate Auth triggers
+        if ((_b = this.config.auth) === null || _b === void 0 ? void 0 : _b.enabled) {
+            const authTriggers = this.triggerFactory.generateAuthTriggers(this.config.auth);
+            Object.assign(triggers, authTriggers);
+        }
+        // Generate Storage triggers
+        if ((_c = this.config.storage) === null || _c === void 0 ? void 0 : _c.enabled) {
+            const storageTriggers = this.triggerFactory.generateStorageTriggers(this.config.storage);
+            Object.assign(triggers, storageTriggers);
+        }
+        this.logger.info('Firebase Event Bridge initialized', {
+            totalTriggers: Object.keys(triggers).length,
+            firestoreEnabled: ((_d = this.config.firestore) === null || _d === void 0 ? void 0 : _d.enabled) || false,
+            authEnabled: ((_e = this.config.auth) === null || _e === void 0 ? void 0 : _e.enabled) || false,
+            storageEnabled: ((_f = this.config.storage) === null || _f === void 0 ? void 0 : _f.enabled) || false
+        });
+        return triggers;
+    }
+    /**
+     * Central event handler - publishes to event bus with error handling
+     *
+     * Maps Firebase-specific events to platform-agnostic domain events.
+     * This ensures subscribers remain unaware of the event source.
+     *
+     * ⚠️ LOGGING SAFETY: Never logs event payload (raw data)
+     */
+    handleEvent(event) {
+        try {
+            // ✅ Safe logging - only event metadata
+            this.logger.debug('Firebase event received', {
+                firebaseEventName: event.eventName,
+                eventId: event.eventId,
+                source: event.source,
+                documentId: event.normalized.documentId,
+                userId: event.normalized.userId,
+                filePath: event.normalized.filePath
+                // ❌ NEVER LOG: event.raw, event.changes
+            });
+            // Map Firebase event to domain event
+            if (!mapFirebaseEventToDomain) {
+                this.logger.warn('Firebase Event Bridge not initialized. Call initializeFirebaseEventBridge() first.');
+                return;
+            }
+            const mapping = mapFirebaseEventToDomain(event.eventName, event);
+            if (!mapping) {
+                this.logger.warn('No domain event mapping found for Firebase event', {
+                    firebaseEventName: event.eventName,
+                    eventId: event.eventId
+                });
+                return;
+            }
+            const { domainEvent, domainPayload } = mapping;
+            // ✅ Safe logging - mapping result
+            this.logger.debug('Firebase event mapped to domain event', {
+                firebaseEventName: event.eventName,
+                domainEvent,
+                eventId: event.eventId
+            });
+            // Publish domain event to internal event bus
+            this.config.eventBus.publish(domainEvent, domainPayload);
+            // ✅ Safe logging - only metadata
+            this.logger.debug('Domain event published to bus', {
+                domainEvent,
+                firebaseEventName: event.eventName,
+                listenerCount: this.config.eventBus.listenerCount(domainEvent)
+            });
+        }
+        catch (error) {
+            // Swallow error and emit error event
+            this.logger.error('Failed to handle Firebase event', error, {
+                eventName: event.eventName,
+                eventId: event.eventId,
+                source: event.source
+                // ❌ NEVER LOG: event payload, error with full context
+            });
+            // Note: Not emitting error event as EventType doesn't have system errors
+            // Could be added if needed
+        }
+    }
+}
+exports.FirebaseEventBridge = FirebaseEventBridge;
+//# sourceMappingURL=bridge.js.map

package/lib/bridge.js.map

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

package/lib/config-types.d.ts

@@ -0,0 +1,56 @@
+import { eventBus } from '@xbg/utils-events';
+/**
+ * DatabaseName is defined locally since this is a standalone package.
+ * At app startup, pass the appropriate database name strings.
+ */
+export type DatabaseName = string;
+/**
+ * Main configuration for Firebase Event Bridge
+ */
+export interface FirebaseEventBridgeConfig {
+    eventBus: typeof eventBus;
+    firestore?: FirestoreConfig;
+    auth?: AuthConfig;
+    storage?: StorageConfig;
+}
+/**
+ * Firestore trigger configuration
+ */
+export interface FirestoreConfig {
+    enabled: boolean;
+    databases: FirestoreDatabaseConfig[];
+}
+/**
+ * Configuration for a single Firestore database
+ */
+export interface FirestoreDatabaseConfig {
+    databaseName: DatabaseName;
+    collections: FirestoreCollectionConfig[];
+}
+/**
+ * Configuration for a single collection
+ */
+export interface FirestoreCollectionConfig {
+    path: string;
+    operations: FirestoreOperation[];
+    includeData: boolean;
+    eventNameOverride?: string;
+}
+export type FirestoreOperation = 'create' | 'update' | 'delete';
+/**
+ * Auth trigger configuration
+ */
+export interface AuthConfig {
+    enabled: boolean;
+    operations: AuthOperation[];
+}
+export type AuthOperation = 'create' | 'delete';
+/**
+ * Storage trigger configuration
+ */
+export interface StorageConfig {
+    enabled: boolean;
+    pathPatterns: string[];
+    includeMetadata: boolean;
+}
+//# sourceMappingURL=config-types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config-types.d.ts","sourceRoot":"","sources":["../src/config-types.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAE7C;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC;AAElC;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,QAAQ,EAAE,OAAO,QAAQ,CAAC;IAC1B,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,OAAO,CAAC,EAAE,aAAa,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,uBAAuB,EAAE,CAAC;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,YAAY,EAAE,YAAY,CAAC;IAC3B,WAAW,EAAE,yBAAyB,EAAE,CAAC;CAC1C;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,kBAAkB,EAAE,CAAC;IACjC,WAAW,EAAE,OAAO,CAAC;IACrB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,MAAM,kBAAkB,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEhE;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,aAAa,EAAE,CAAC;CAC7B;AAED,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEhD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,eAAe,EAAE,OAAO,CAAC;CAC1B"}

package/lib/config-types.js

@@ -0,0 +1,4 @@
+"use strict";
+// src/utilities/firebase-event-bridge/config-types.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=config-types.js.map

package/lib/config-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-types.js","sourceRoot":"","sources":["../src/config-types.ts"],"names":[],"mappings":";AAAA,sDAAsD"}

package/lib/index.d.ts

@@ -0,0 +1,5 @@
+export { FirebaseEventBridge, initializeFirebaseEventBridge } from './bridge';
+export type { MapFirebaseEventToDomainFn } from './bridge';
+export type { FirebaseEventBridgeConfig, FirestoreConfig, FirestoreDatabaseConfig, FirestoreCollectionConfig, FirestoreOperation, AuthConfig, AuthOperation, StorageConfig } from './config-types';
+export type { NormalizedFirebaseEvent } from './normalizer';
+//# 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":"AAEA,OAAO,EAAE,mBAAmB,EAAE,6BAA6B,EAAE,MAAM,UAAU,CAAC;AAC9E,YAAY,EAAE,0BAA0B,EAAE,MAAM,UAAU,CAAC;AAC3D,YAAY,EACV,yBAAyB,EACzB,eAAe,EACf,uBAAuB,EACvB,yBAAyB,EACzB,kBAAkB,EAClB,UAAU,EACV,aAAa,EACb,aAAa,EACd,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC"}

package/lib/index.js

@@ -0,0 +1,8 @@
+"use strict";
+// src/utilities/firebase-event-bridge/index.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.initializeFirebaseEventBridge = exports.FirebaseEventBridge = void 0;
+var bridge_1 = require("./bridge");
+Object.defineProperty(exports, "FirebaseEventBridge", { enumerable: true, get: function () { return bridge_1.FirebaseEventBridge; } });
+Object.defineProperty(exports, "initializeFirebaseEventBridge", { enumerable: true, get: function () { return bridge_1.initializeFirebaseEventBridge; } });
+//# 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,+CAA+C;;;AAE/C,mCAA8E;AAArE,6GAAA,mBAAmB,OAAA;AAAE,uHAAA,6BAA6B,OAAA"}

package/lib/normalizer.d.ts

@@ -0,0 +1,56 @@
+import { Logger } from '@xbg/utils-logger';
+import { BaseEventPayload } from '@xbg/utils-events';
+/**
+ * Normalized event structure for internal event bus
+ * Extends BaseEventPayload for type compatibility with event bus
+ */
+export interface NormalizedFirebaseEvent extends BaseEventPayload {
+    eventId: string;
+    eventName: string;
+    timestamp: Date;
+    source: 'firestore' | 'auth' | 'storage';
+    normalized: {
+        databaseName?: string;
+        documentId?: string;
+        documentPath?: string;
+        collection?: string;
+        userId?: string;
+        filePath?: string;
+        operation?: string;
+    };
+    raw: any;
+    changes?: {
+        before: any;
+        after: any;
+    };
+    [key: string]: any;
+}
+/**
+ * Normalize Firestore event to standard format
+ *
+ * ⚠️ LOGGING SAFETY: Only logs metadata, never document data
+ */
+export declare function normalizeFirestoreEvent(operation: string, documentPath: string, documentId: string, databaseName: string, collectionName: string, data: any, logger: Logger, eventNameOverride?: string, changes?: {
+    before: any;
+    after: any;
+}): NormalizedFirebaseEvent;
+/**
+ * Normalize Auth event to standard format
+ *
+ * ⚠️ LOGGING SAFETY: Only logs metadata, never user data
+ */
+export declare function normalizeAuthEvent(operation: string, userId: string, userData: any, logger: Logger): NormalizedFirebaseEvent;
+/**
+ * Normalize Storage event to standard format
+ *
+ * ⚠️ LOGGING SAFETY: Only logs file path, never metadata content
+ */
+export declare function normalizeStorageEvent(filePath: string, metadata: any, logger: Logger): NormalizedFirebaseEvent;
+/**
+ * Extract collection name from document path
+ * Examples:
+ *   'users/{userUID}' -> 'users'
+ *   'items/{itemUID}/images/{imageUID}' -> 'images'
+ */
+export declare function extractCollectionName(path: string): string;
+//# sourceMappingURL=normalizer.d.ts.map

package/lib/normalizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizer.d.ts","sourceRoot":"","sources":["../src/normalizer.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAErD;;;GAGG;AACH,MAAM,WAAW,uBAAwB,SAAQ,gBAAgB;IAE/D,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,IAAI,CAAC;IAChB,MAAM,EAAE,WAAW,GAAG,MAAM,GAAG,SAAS,CAAC;IAGzC,UAAU,EAAE;QACV,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IAIF,GAAG,EAAE,GAAG,CAAC;IAIT,OAAO,CAAC,EAAE;QACR,MAAM,EAAE,GAAG,CAAC;QACZ,KAAK,EAAE,GAAG,CAAC;KACZ,CAAC;IAGF,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,EACpB,cAAc,EAAE,MAAM,EACtB,IAAI,EAAE,GAAG,EACT,MAAM,EAAE,MAAM,EACd,iBAAiB,CAAC,EAAE,MAAM,EAC1B,OAAO,CAAC,EAAE;IAAE,MAAM,EAAE,GAAG,CAAC;IAAC,KAAK,EAAE,GAAG,CAAA;CAAE,GACpC,uBAAuB,CA+BzB;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,GAAG,EACb,MAAM,EAAE,MAAM,GACb,uBAAuB,CAsBzB;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,GAAG,EACb,MAAM,EAAE,MAAM,GACb,uBAAuB,CAsBzB;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAS1D"}

package/lib/normalizer.js

@@ -0,0 +1,111 @@
+"use strict";
+// src/utilities/firebase-event-bridge/normalizer.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeFirestoreEvent = normalizeFirestoreEvent;
+exports.normalizeAuthEvent = normalizeAuthEvent;
+exports.normalizeStorageEvent = normalizeStorageEvent;
+exports.extractCollectionName = extractCollectionName;
+/**
+ * Normalize Firestore event to standard format
+ *
+ * ⚠️ LOGGING SAFETY: Only logs metadata, never document data
+ */
+function normalizeFirestoreEvent(operation, documentPath, documentId, databaseName, collectionName, data, logger, eventNameOverride, changes) {
+    const collection = eventNameOverride || collectionName;
+    const eventName = `firestore.${collection}.${operation}`;
+    // ✅ Safe logging - only metadata
+    logger.debug('Normalizing Firestore event', {
+        eventName,
+        documentId,
+        databaseName,
+        collection: collectionName,
+        operation,
+        hasChanges: !!changes,
+        hasEventNameOverride: !!eventNameOverride
+        // ❌ NEVER LOG: data, changes, raw document content
+    });
+    return {
+        eventId: `${eventName}-${documentId}-${Date.now()}`,
+        eventName,
+        timestamp: new Date(),
+        source: 'firestore',
+        normalized: {
+            databaseName,
+            documentId,
+            documentPath,
+            collection: collectionName,
+            operation
+        },
+        raw: data, // Not logged, just passed through to event bus
+        changes // Not logged, just passed through to event bus
+    };
+}
+/**
+ * Normalize Auth event to standard format
+ *
+ * ⚠️ LOGGING SAFETY: Only logs metadata, never user data
+ */
+function normalizeAuthEvent(operation, userId, userData, logger) {
+    const eventName = `auth.user.${operation}`;
+    // ✅ Safe logging - only metadata
+    logger.debug('Normalizing Auth event', {
+        eventName,
+        userId,
+        operation
+        // ❌ NEVER LOG: userData, email, phone, etc.
+    });
+    return {
+        eventId: `${eventName}-${userId}-${Date.now()}`,
+        eventName,
+        timestamp: new Date(),
+        source: 'auth',
+        normalized: {
+            userId,
+            operation
+        },
+        raw: userData // Not logged, just passed through
+    };
+}
+/**
+ * Normalize Storage event to standard format
+ *
+ * ⚠️ LOGGING SAFETY: Only logs file path, never metadata content
+ */
+function normalizeStorageEvent(filePath, metadata, logger) {
+    const eventName = 'storage.object.finalized';
+    // ✅ Safe logging - only file path
+    logger.debug('Normalizing Storage event', {
+        eventName,
+        filePath,
+        hasMetadata: !!metadata
+        // ❌ NEVER LOG: metadata content (may contain user info)
+    });
+    return {
+        eventId: `${eventName}-${Date.now()}`,
+        eventName,
+        timestamp: new Date(),
+        source: 'storage',
+        normalized: {
+            filePath,
+            operation: 'upload'
+        },
+        raw: metadata // Not logged, just passed through
+    };
+}
+/**
+ * Extract collection name from document path
+ * Examples:
+ *   'users/{userUID}' -> 'users'
+ *   'items/{itemUID}/images/{imageUID}' -> 'images'
+ */
+function extractCollectionName(path) {
+    const parts = path.split('/');
+    // Get last non-parameter part
+    for (let i = parts.length - 1; i >= 0; i--) {
+        if (!parts[i].startsWith('{')) {
+            return parts[i];
+        }
+    }
+    return parts[0];
+}
+//# sourceMappingURL=normalizer.js.map

package/lib/normalizer.js.map

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

package/lib/trigger-factory.d.ts

@@ -0,0 +1,21 @@
+import { Logger } from '@xbg/utils-logger';
+import { FirestoreConfig, AuthConfig, StorageConfig } from './config-types';
+import { NormalizedFirebaseEvent } from './normalizer';
+export declare class TriggerFactory {
+    private readonly logger;
+    private readonly eventHandler;
+    constructor(logger: Logger, eventHandler: (event: NormalizedFirebaseEvent) => void);
+    /**
+     * Generate all Firestore triggers based on config
+     */
+    generateFirestoreTriggers(config: FirestoreConfig): Record<string, any>;
+    /**
+     * Generate all Auth triggers based on config
+     */
+    generateAuthTriggers(config: AuthConfig): Record<string, any>;
+    /**
+     * Generate Storage trigger based on config
+     */
+    generateStorageTriggers(config: StorageConfig): Record<string, any>;
+}
+//# sourceMappingURL=trigger-factory.d.ts.map

package/lib/trigger-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trigger-factory.d.ts","sourceRoot":"","sources":["../src/trigger-factory.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAI5E,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAEvD,qBAAa,cAAc;IAEvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,YAAY;gBADZ,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,CAAC,KAAK,EAAE,uBAAuB,KAAK,IAAI;IAGzE;;OAEG;IACH,yBAAyB,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAyCvE;;OAEG;IACH,oBAAoB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAwB7D;;OAEG;IACH,uBAAuB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;CAsBpE"}

package/lib/trigger-factory.js

@@ -0,0 +1,84 @@
+"use strict";
+// src/utilities/firebase-event-bridge/trigger-factory.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TriggerFactory = void 0;
+const firestore_adapter_1 = require("./adapters/firestore-adapter");
+const auth_adapter_1 = require("./adapters/auth-adapter");
+const storage_adapter_1 = require("./adapters/storage-adapter");
+class TriggerFactory {
+    constructor(logger, eventHandler) {
+        this.logger = logger;
+        this.eventHandler = eventHandler;
+    }
+    /**
+     * Generate all Firestore triggers based on config
+     */
+    generateFirestoreTriggers(config) {
+        const triggers = {};
+        const adapter = new firestore_adapter_1.FirestoreAdapter(this.logger, this.eventHandler);
+        for (const dbConfig of config.databases) {
+            for (const collectionConfig of dbConfig.collections) {
+                for (const operation of collectionConfig.operations) {
+                    const trigger = adapter.createTrigger(dbConfig.databaseName, collectionConfig, operation);
+                    const triggerName = firestore_adapter_1.FirestoreAdapter.generateTriggerName(dbConfig.databaseName, collectionConfig.path, operation, collectionConfig.eventNameOverride);
+                    triggers[triggerName] = trigger;
+                    // ✅ Safe logging - only trigger metadata
+                    this.logger.debug('Firestore trigger generated', {
+                        triggerName,
+                        databaseName: dbConfig.databaseName,
+                        collection: collectionConfig.path,
+                        operation
+                    });
+                }
+            }
+        }
+        this.logger.info('Firestore triggers generated', {
+            count: Object.keys(triggers).length,
+            databaseCount: config.databases.length
+        });
+        return triggers;
+    }
+    /**
+     * Generate all Auth triggers based on config
+     */
+    generateAuthTriggers(config) {
+        const triggers = {};
+        const adapter = new auth_adapter_1.AuthAdapter(this.logger, this.eventHandler);
+        for (const operation of config.operations) {
+            const trigger = adapter.createTrigger(operation);
+            const triggerName = auth_adapter_1.AuthAdapter.generateTriggerName(operation);
+            triggers[triggerName] = trigger;
+            // ✅ Safe logging - only trigger metadata
+            this.logger.debug('Auth trigger generated', {
+                triggerName,
+                operation
+            });
+        }
+        this.logger.info('Auth triggers generated', {
+            count: Object.keys(triggers).length
+        });
+        return triggers;
+    }
+    /**
+     * Generate Storage trigger based on config
+     */
+    generateStorageTriggers(config) {
+        const triggers = {};
+        const adapter = new storage_adapter_1.StorageAdapter(this.logger, this.eventHandler);
+        const trigger = adapter.createTrigger(config);
+        const triggerName = storage_adapter_1.StorageAdapter.generateTriggerName();
+        triggers[triggerName] = trigger;
+        // ✅ Safe logging - only trigger metadata
+        this.logger.debug('Storage trigger generated', {
+            triggerName,
+            pathPatterns: config.pathPatterns
+        });
+        this.logger.info('Storage triggers generated', {
+            count: 1,
+            pathPatterns: config.pathPatterns
+        });
+        return triggers;
+    }
+}
+exports.TriggerFactory = TriggerFactory;
+//# sourceMappingURL=trigger-factory.js.map

package/lib/trigger-factory.js.map

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

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@xbg.solutions/utils-firebase-event-bridge",
+  "version": "1.0.0",
+  "description": "Firebase triggers to event normalization",
+  "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-events": "^1.0.0",
+    "@xbg/utils-logger": "^1.0.0",
+    "firebase-admin": "^12.0.0",
+    "firebase-functions": "^4.6.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.0",
+    "typescript": "^5.3.3"
+  },
+  "engines": {
+    "node": "22"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}