@zeeshan60/event-processor 1.0.6 → 1.0.7

package/README.md

@@ -11,6 +11,7 @@ This package provides the core building blocks for implementing event sourcing p
 - **Base Interfaces**: `Event` and `Model` interfaces for type-safe event sourcing
 - **Abstract Stores**: `EventStore` and `ModelStore` base classes
 - **In-Memory Implementations**: Ready-to-use in-memory stores for testing
+- **Environment Configuration**: Detect and configure behavior based on runtime environment (Google Cloud Functions vs Client)
 
 ## Installation
 
@@ -61,14 +62,82 @@ const model = event.apply(null);
 await modelStore.save(model);
 ```
 
+## Environment Configuration
+
+The event-processor package includes environment detection to identify whether it's running in Google Cloud Functions or a client application. This enables environment-specific behavior.
+
+### Quick Start
+
+```typescript
+import { EventProcessorSource, setEventProcessorSource, isGCFun, isClient } from '@zeeshan60/event-processor';
+
+// Option 1: Set via environment variable (recommended)
+// export EVENT_PROCESSOR_SOURCE=GOOGLE_CLOUD_FUNCTION
+
+// Option 2: Set programmatically
+setEventProcessorSource(EventProcessorSource.GOOGLE_CLOUD_FUNCTION);
+
+// Check the environment
+if (isGCFun()) {
+  console.log('Running in Google Cloud Functions');
+}
+
+if (isClient()) {
+  console.log('Running in client application');
+}
+```
+
+### Available Helper Methods
+
+- `isGCFun()`: Returns `true` if running in Google Cloud Functions
+- `isClient()`: Returns `true` if running in a client application
+- `isUnknown()`: Returns `true` if environment is not configured
+- `setEventProcessorSource(source)`: Set the environment programmatically
+- `getEventProcessorSource()`: Get the current environment
+
+For detailed environment configuration, see [ENVIRONMENT_CONFIG.md](./ENVIRONMENT_CONFIG.md).
+
+## Documentation
+
+### 📚 Essential Reading
+
+- **[DUAL_CONTEXT_FLOW.md](./DUAL_CONTEXT_FLOW.md)** - 🎯 **START HERE!** Comprehensive guide explaining how the package operates in client vs Google Cloud Functions contexts, complete with diagrams and examples
+- **[QUICK_REFERENCE.md](./QUICK_REFERENCE.md)** - Quick reference cheat sheet for common patterns, troubleshooting, and best practices
+- **[ENVIRONMENT_CONFIG.md](./ENVIRONMENT_CONFIG.md)** - Environment configuration details
+
+### Why Dual-Context Matters
+
+The event-processor package serves **two distinct purposes**:
+
+1. **Client (Mobile App)**: Creates events from user actions, applies them to local models
+2. **Google Cloud Functions**: Processes events from Firestore, generates friend-perspective mirror events
+
+Understanding when to create events vs when to process them is critical to avoid:
+- Duplicate events
+- Infinite loops
+- Incorrect activity attribution
+
+**Read [DUAL_CONTEXT_FLOW.md](./DUAL_CONTEXT_FLOW.md) before integrating this package.**
+
 ## Architecture
 
 - **Event**: Base interface for all events with `apply()` method
 - **Model**: Base interface for all models/aggregates
 - **EventStore**: Abstract class for event persistence
 - **ModelStore**: Abstract class for model/read-model persistence
+- **EventProcessorSource**: Context detection (CLIENT vs GOOGLE_CLOUD_FUNCTION)
+
+### Event Handlers
+
+- **TransactionEventHandler**: Handles transaction lifecycle (create, update, delete)
+- **FriendEventHandler**: Manages friend relationships
+- **UserEventHandler**: Handles user profile changes
+- **GroupEventHandler**: Manages group entities
+- **GroupTransactionEventHandler**: Processes group transactions
+- **ActivityEventHandler**: Creates activity log entries
 
 ## Projects Using This Package
 
-- `money-rabit-backend`: Firebase Functions backend
-- `mobile`: Mobile application
+- `gcloud-functions`: Google Cloud Functions backend (server-side event processing)
+- `mobile`: Mobile application (client-side event creation)
+- `client-events`: Client-side event definitions (extends this package)

package/dist/TransactionEventHandler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TransactionEventHandler.d.ts","sourceRoot":"","sources":["../src/TransactionEventHandler.ts"],"names":[],"mappings":"AAAA,OAAO,EAQH,gBAAgB,EAChB,KAAK,EACR,MAAM,GAAG,CAAC;AACX,OAAO,EAAC,qBAAqB,EAAC,MAAM,GAAG,CAAC;AACxC,OAAO,EAAC,qBAAqB,EAAC,MAAM,GAAG,CAAC;AACxC,OAAO,EAAC,cAAc,EAAC,MAAM,GAAG,CAAC;AACjC,OAAO,EAAC,oBAAoB,EAAC,MAAM,wBAAwB,CAAC;AAK5D,qBAAa,uBAAuB;IAE5B,OAAO,CAAC,UAAU;IAClB,OAAO,CAAC,UAAU;IAClB,OAAO,CAAC,gBAAgB;IACxB,OAAO,CAAC,oBAAoB,CAAC;gBAHrB,UAAU,EAAE,qBAAqB,EACjC,UAAU,EAAE,qBAAqB,EACjC,gBAAgB,EAAE,cAAc,EAChC,oBAAoB,CAAC,EAAE,oBAAoB,YAAA;IAGjD,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,gBAAgB,CAAC;YA2B5C,iBAAiB;CAmJlC"}
+{"version":3,"file":"TransactionEventHandler.d.ts","sourceRoot":"","sources":["../src/TransactionEventHandler.ts"],"names":[],"mappings":"AAAA,OAAO,EAQH,gBAAgB,EAChB,KAAK,EACR,MAAM,GAAG,CAAC;AACX,OAAO,EAAC,qBAAqB,EAAC,MAAM,GAAG,CAAC;AACxC,OAAO,EAAC,qBAAqB,EAAC,MAAM,GAAG,CAAC;AACxC,OAAO,EAAC,cAAc,EAAC,MAAM,GAAG,CAAC;AACjC,OAAO,EAAC,oBAAoB,EAAC,MAAM,wBAAwB,CAAC;AAM5D,qBAAa,uBAAuB;IAE5B,OAAO,CAAC,UAAU;IAClB,OAAO,CAAC,UAAU;IAClB,OAAO,CAAC,gBAAgB;IACxB,OAAO,CAAC,oBAAoB,CAAC;gBAHrB,UAAU,EAAE,qBAAqB,EACjC,UAAU,EAAE,qBAAqB,EACjC,gBAAgB,EAAE,cAAc,EAChC,oBAAoB,CAAC,EAAE,oBAAoB,YAAA;IAGjD,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,gBAAgB,CAAC;YAmC5C,iBAAiB;CA2JlC"}

package/dist/TransactionEventHandler.js

@@ -4,6 +4,7 @@ exports.TransactionEventHandler = void 0;
 const _1 = require(".");
 const splitTypeUtils_1 = require("./utils/splitTypeUtils");
 const userPathUtils_1 = require("./utils/userPathUtils");
+const environment_1 = require("./config/environment");
 const uuid_1 = require("uuid");
 class TransactionEventHandler {
     constructor(modelStore, eventStore, txUserModelStore, activityEventHandler) {
@@ -26,6 +27,15 @@ class TransactionEventHandler {
         if (!validEventTypes.includes(eventType)) {
             throw new Error(`Unknown transaction event type: ${eventType}`);
         }
+        if ((0, environment_1.isGCFun)()) {
+            console.log(`[GCFunction] TransactionEventHandler handling ${eventType} event (streamId: ${event.streamId})`);
+        }
+        else if ((0, environment_1.isClient)()) {
+            console.log(`[Client] TransactionEventHandler handling ${eventType} event (streamId: ${event.streamId})`);
+        }
+        else {
+            console.log(`[Unknown] TransactionEventHandler handling ${eventType} event (streamId: ${event.streamId})`);
+        }
         const existingModel = await this.modelStore.getByStreamIdWhereDeletedIsFalse(event.streamId);
         const model = event.apply(existingModel);
         await this.modelStore.save(model);
@@ -37,6 +47,15 @@ class TransactionEventHandler {
     }
     async createMirrorEvent(originalEvent, transactionModel) {
         const eventType = originalEvent.constructor.name;
+        if ((0, environment_1.isGCFun)()) {
+            console.log(`[GCFunction] Creating mirror event for ${eventType} (recipient: ${transactionModel.recipientUserId})`);
+        }
+        else if ((0, environment_1.isClient)()) {
+            console.log(`[Client] Creating mirror event for ${eventType} (recipient: ${transactionModel.recipientUserId})`);
+        }
+        else {
+            console.log(`[Unknown] Creating mirror event for ${eventType} (recipient: ${transactionModel.recipientUserId})`);
+        }
         const recipientUserModel = await this.txUserModelStore.getByStreamId(transactionModel.recipientUserId);
         const recipientPath = (0, userPathUtils_1.getUserEventPath)(recipientUserModel, transactionModel.recipientUserId);
         const existingMirrorModel = await this.modelStore.findByUserAndLogicalTransactionId(transactionModel.recipientUserId, transactionModel.userId, transactionModel.logicalTransactionId);

package/dist/UserEventHandler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"UserEventHandler.d.ts","sourceRoot":"","sources":["../src/UserEventHandler.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,WAAW,EACX,sBAAsB,EACtB,mBAAmB,EACnB,sBAAsB,EACtB,sBAAsB,EACtB,WAAW,EACX,qBAAqB,EACrB,0BAA0B,EAC1B,SAAS,EACZ,MAAM,GAAG,CAAC;AACX,OAAO,EAAC,cAAc,EAAC,MAAM,GAAG,CAAC;AACjC,OAAO,EAAC,oBAAoB,EAAC,MAAM,wBAAwB,CAAC;AAE5D,qBAAa,gBAAgB;IAErB,OAAO,CAAC,UAAU;IAClB,OAAO,CAAC,oBAAoB,CAAC;gBADrB,UAAU,EAAE,cAAc,EAC1B,oBAAoB,CAAC,EAAE,oBAAoB,YAAA;IAGjD,iBAAiB,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,SAAS,CAAC;IAUzD,4BAA4B,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAAC,SAAS,CAAC;IAU/E,yBAAyB,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,SAAS,CAAC;IAUzE,4BAA4B,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAAC,SAAS,CAAC;IAU/E,4BAA4B,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAAC,SAAS,CAAC;IAU/E,iBAAiB,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,SAAS,CAAC;IAUzD,2BAA2B,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,SAAS,CAAC;IAU7E,gCAAgC,CAAC,KAAK,EAAE,0BAA0B,GAAG,OAAO,CAAC,SAAS,CAAC;CAShG"}
+{"version":3,"file":"UserEventHandler.d.ts","sourceRoot":"","sources":["../src/UserEventHandler.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,WAAW,EACX,sBAAsB,EACtB,mBAAmB,EACnB,sBAAsB,EACtB,sBAAsB,EACtB,WAAW,EACX,qBAAqB,EACrB,0BAA0B,EAC1B,SAAS,EACZ,MAAM,GAAG,CAAC;AACX,OAAO,EAAC,cAAc,EAAC,MAAM,GAAG,CAAC;AACjC,OAAO,EAAC,oBAAoB,EAAC,MAAM,wBAAwB,CAAC;AAG5D,qBAAa,gBAAgB;IAErB,OAAO,CAAC,UAAU;IAClB,OAAO,CAAC,oBAAoB,CAAC;gBADrB,UAAU,EAAE,cAAc,EAC1B,oBAAoB,CAAC,EAAE,oBAAoB,YAAA;IAGjD,iBAAiB,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,SAAS,CAAC;IAWzD,4BAA4B,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAAC,SAAS,CAAC;IAU/E,yBAAyB,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,SAAS,CAAC;IAUzE,4BAA4B,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAAC,SAAS,CAAC;IAU/E,4BAA4B,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAAC,SAAS,CAAC;IAU/E,iBAAiB,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,SAAS,CAAC;IAUzD,2BAA2B,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,SAAS,CAAC;IAU7E,gCAAgC,CAAC,KAAK,EAAE,0BAA0B,GAAG,OAAO,CAAC,SAAS,CAAC;CAShG"}

package/dist/UserEventHandler.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.UserEventHandler = void 0;
+const EventBusSingleton_1 = require("./common/EventBusSingleton");
 class UserEventHandler {
     constructor(modelStore, activityEventHandler) {
         this.modelStore = modelStore;
@@ -13,6 +14,7 @@ class UserEventHandler {
         if (this.activityEventHandler) {
             await this.activityEventHandler.createActivityLog(event, existingModel, updatedModel);
         }
+        (0, EventBusSingleton_1.getEventBus)().publish(event);
         return updatedModel;
     }
     async handlePlaceholderUserCreated(event) {

package/dist/common/EventBus.d.ts

@@ -0,0 +1,12 @@
+import { Observable } from 'rxjs';
+import { Event } from './Event';
+export type EventFilter<T extends Event = Event> = (event: Event) => event is T;
+export declare class EventBus {
+    private subject;
+    constructor();
+    publish(event: Event): void;
+    subscribe<T extends Event = Event>(eventFilter: EventFilter<T>, callback: (event: T) => void): () => void;
+    observable<T extends Event = Event>(eventFilter: EventFilter<T>): Observable<T>;
+    complete(): void;
+}
+//# sourceMappingURL=EventBus.d.ts.map

package/dist/common/EventBus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventBus.d.ts","sourceRoot":"","sources":["../../src/common/EventBus.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,UAAU,EAAE,MAAM,MAAM,CAAC;AAE3C,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAEhC,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,KAAK,GAAG,KAAK,IAAI,CAAC,KAAK,EAAE,KAAK,KAAK,KAAK,IAAI,CAAC,CAAC;AAEhF,qBAAa,QAAQ;IACjB,OAAO,CAAC,OAAO,CAAiB;;IAMhC,OAAO,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAI3B,SAAS,CAAC,CAAC,SAAS,KAAK,GAAG,KAAK,EAC7B,WAAW,EAAE,WAAW,CAAC,CAAC,CAAC,EAC3B,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,GAC7B,MAAM,IAAI;IAQb,UAAU,CAAC,CAAC,SAAS,KAAK,GAAG,KAAK,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC;IAI/E,QAAQ,IAAI,IAAI;CAGnB"}

package/dist/common/EventBus.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EventBus = void 0;
+const rxjs_1 = require("rxjs");
+const operators_1 = require("rxjs/operators");
+class EventBus {
+    constructor() {
+        this.subject = new rxjs_1.Subject();
+    }
+    publish(event) {
+        this.subject.next(event);
+    }
+    subscribe(eventFilter, callback) {
+        const subscription = this.subject
+            .pipe((0, operators_1.filter)(eventFilter))
+            .subscribe(callback);
+        return () => subscription.unsubscribe();
+    }
+    observable(eventFilter) {
+        return this.subject.pipe((0, operators_1.filter)(eventFilter));
+    }
+    complete() {
+        this.subject.complete();
+    }
+}
+exports.EventBus = EventBus;

package/dist/common/EventBusSingleton.d.ts

@@ -0,0 +1,4 @@
+import { EventBus } from './EventBus';
+export declare function getEventBus(): EventBus;
+export declare function resetEventBus(): void;
+//# sourceMappingURL=EventBusSingleton.d.ts.map

package/dist/common/EventBusSingleton.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventBusSingleton.d.ts","sourceRoot":"","sources":["../../src/common/EventBusSingleton.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAItC,wBAAgB,WAAW,IAAI,QAAQ,CAKtC;AAED,wBAAgB,aAAa,IAAI,IAAI,CAKpC"}

package/dist/common/EventBusSingleton.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getEventBus = getEventBus;
+exports.resetEventBus = resetEventBus;
+const EventBus_1 = require("./EventBus");
+let eventBusInstance;
+function getEventBus() {
+    if (!eventBusInstance) {
+        eventBusInstance = new EventBus_1.EventBus();
+    }
+    return eventBusInstance;
+}
+function resetEventBus() {
+    if (eventBusInstance) {
+        eventBusInstance.complete();
+    }
+    eventBusInstance = undefined;
+}

package/dist/config/Environment.d.ts

@@ -0,0 +1,25 @@
+export declare enum EventProcessorSource {
+    GOOGLE_CLOUD_FUNCTION = "GOOGLE_CLOUD_FUNCTION",
+    CLIENT = "CLIENT",
+    UNKNOWN = "UNKNOWN"
+}
+declare class EventProcessorEnvironment {
+    private source;
+    constructor();
+    private initializeFromEnv;
+    setSource(source: EventProcessorSource): void;
+    getSource(): EventProcessorSource;
+    isGCFun(): boolean;
+    isClient(): boolean;
+    isUnknown(): boolean;
+    reset(): void;
+}
+export declare const eventProcessorEnv: EventProcessorEnvironment;
+export declare function setEventProcessorSource(source: EventProcessorSource): void;
+export declare function getEventProcessorSource(): EventProcessorSource;
+export declare function isGCFun(): boolean;
+export declare function isClient(): boolean;
+export declare function isUnknown(): boolean;
+export declare function resetEventProcessorSource(): void;
+export {};
+//# sourceMappingURL=environment.d.ts.map

package/dist/config/Environment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.d.ts","sourceRoot":"","sources":["../../src/config/environment.ts"],"names":[],"mappings":"AAAA,oBAAY,oBAAoB;IAC9B,qBAAqB,0BAA0B;IAC/C,MAAM,WAAW;IACjB,OAAO,YAAY;CACpB;AAED,cAAM,yBAAyB;IAC7B,OAAO,CAAC,MAAM,CAAsD;;IAMpE,OAAO,CAAC,iBAAiB;IAYzB,SAAS,CAAC,MAAM,EAAE,oBAAoB,GAAG,IAAI;IAI7C,SAAS,IAAI,oBAAoB;IAIjC,OAAO,IAAI,OAAO;IAIlB,QAAQ,IAAI,OAAO;IAInB,SAAS,IAAI,OAAO;IAIpB,KAAK,IAAI,IAAI;CAGd;AAED,eAAO,MAAM,iBAAiB,2BAAkC,CAAC;AAEjE,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,oBAAoB,GAAG,IAAI,CAE1E;AAED,wBAAgB,uBAAuB,IAAI,oBAAoB,CAE9D;AAED,wBAAgB,OAAO,IAAI,OAAO,CAEjC;AAED,wBAAgB,QAAQ,IAAI,OAAO,CAElC;AAED,wBAAgB,SAAS,IAAI,OAAO,CAEnC;AAED,wBAAgB,yBAAyB,IAAI,IAAI,CAEhD"}

package/dist/config/Environment.js

@@ -0,0 +1,70 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.eventProcessorEnv = exports.EventProcessorSource = void 0;
+exports.setEventProcessorSource = setEventProcessorSource;
+exports.getEventProcessorSource = getEventProcessorSource;
+exports.isGCFun = isGCFun;
+exports.isClient = isClient;
+exports.isUnknown = isUnknown;
+exports.resetEventProcessorSource = resetEventProcessorSource;
+var EventProcessorSource;
+(function (EventProcessorSource) {
+    EventProcessorSource["GOOGLE_CLOUD_FUNCTION"] = "GOOGLE_CLOUD_FUNCTION";
+    EventProcessorSource["CLIENT"] = "CLIENT";
+    EventProcessorSource["UNKNOWN"] = "UNKNOWN";
+})(EventProcessorSource || (exports.EventProcessorSource = EventProcessorSource = {}));
+class EventProcessorEnvironment {
+    constructor() {
+        this.source = EventProcessorSource.UNKNOWN;
+        this.initializeFromEnv();
+    }
+    initializeFromEnv() {
+        const envSource = process.env.EVENT_PROCESSOR_SOURCE;
+        if (envSource === EventProcessorSource.GOOGLE_CLOUD_FUNCTION) {
+            this.source = EventProcessorSource.GOOGLE_CLOUD_FUNCTION;
+        }
+        else if (envSource === EventProcessorSource.CLIENT) {
+            this.source = EventProcessorSource.CLIENT;
+        }
+        else {
+            this.source = EventProcessorSource.UNKNOWN;
+        }
+    }
+    setSource(source) {
+        this.source = source;
+    }
+    getSource() {
+        return this.source;
+    }
+    isGCFun() {
+        return this.source === EventProcessorSource.GOOGLE_CLOUD_FUNCTION;
+    }
+    isClient() {
+        return this.source === EventProcessorSource.CLIENT;
+    }
+    isUnknown() {
+        return this.source === EventProcessorSource.UNKNOWN;
+    }
+    reset() {
+        this.initializeFromEnv();
+    }
+}
+exports.eventProcessorEnv = new EventProcessorEnvironment();
+function setEventProcessorSource(source) {
+    exports.eventProcessorEnv.setSource(source);
+}
+function getEventProcessorSource() {
+    return exports.eventProcessorEnv.getSource();
+}
+function isGCFun() {
+    return exports.eventProcessorEnv.isGCFun();
+}
+function isClient() {
+    return exports.eventProcessorEnv.isClient();
+}
+function isUnknown() {
+    return exports.eventProcessorEnv.isUnknown();
+}
+function resetEventProcessorSource() {
+    exports.eventProcessorEnv.reset();
+}

package/dist/controllers/UserController.d.ts

@@ -0,0 +1,4 @@
+export declare class UserController {
+    loginUser(userFSId: string): Promise<string>;
+}
+//# sourceMappingURL=UserController.d.ts.map

package/dist/controllers/UserController.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UserController.d.ts","sourceRoot":"","sources":["../../src/controllers/UserController.ts"],"names":[],"mappings":"AAIA,qBAAa,cAAc;IACjB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CA0BrD"}

package/dist/controllers/UserController.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UserController = void 0;
+const EventBusSingleton_1 = require("../common/EventBusSingleton");
+const UserEvents_1 = require("../UserEvents");
+const rxjs_1 = require("rxjs");
+class UserController {
+    async loginUser(userFSId) {
+        const eventBus = (0, EventBusSingleton_1.getEventBus)();
+        const isUserCreatedForFirebaseUid = (event) => {
+            return event instanceof UserEvents_1.UserCreated && event.firebaseUid === userFSId;
+        };
+        try {
+            const event = await (0, rxjs_1.firstValueFrom)(eventBus.observable(isUserCreatedForFirebaseUid).pipe((0, rxjs_1.timeout)(10000)));
+            if (!event.userId) {
+                throw new Error('UserCreated event missing userId');
+            }
+            return event.userId;
+        }
+        catch (error) {
+            if (error.name === 'TimeoutError') {
+                throw new Error(`Timeout waiting for UserCreated event for firebaseUid: ${userFSId}`);
+            }
+            throw error;
+        }
+    }
+}
+exports.UserController = UserController;

package/dist/events.d.ts

@@ -27,4 +27,5 @@ export { GroupTransactionEventHandler } from './GroupTransactionEventHandler';
 export { ActivityEventHandler } from './ActivityEventHandler';
 export { reverseSplitType, calculateMirrorAmountAndIsOwed } from './utils/splitTypeUtils';
 export { getUserEventPath } from './utils/userPathUtils';
+export { EventProcessorSource, setEventProcessorSource, getEventProcessorSource, isGCFun, isClient, isUnknown, resetEventProcessorSource, eventProcessorEnv } from './config/environment';
 //# sourceMappingURL=events.d.ts.map

package/dist/events.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AACA,cAAc,qBAAqB,CAAC;AACpC,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AAGpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAG/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,oCAAoC,CAAC;AACnD,cAAc,oCAAoC,CAAC;AACnD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,+BAA+B,CAAC;AAG9C,OAAO,EAAC,uBAAuB,EAAC,MAAM,2BAA2B,CAAC;AAClE,OAAO,EAAC,gBAAgB,EAAC,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAC,kBAAkB,EAAC,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAC,iBAAiB,EAAC,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAC,4BAA4B,EAAC,MAAM,gCAAgC,CAAC;AAC5E,OAAO,EAAC,oBAAoB,EAAC,MAAM,wBAAwB,CAAC;AAG5D,OAAO,EAAC,gBAAgB,EAAE,8BAA8B,EAAC,MAAM,wBAAwB,CAAC;AACxF,OAAO,EAAC,gBAAgB,EAAC,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AACA,cAAc,qBAAqB,CAAC;AACpC,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AAGpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAG/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,oCAAoC,CAAC;AACnD,cAAc,oCAAoC,CAAC;AACnD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,+BAA+B,CAAC;AAG9C,OAAO,EAAC,uBAAuB,EAAC,MAAM,2BAA2B,CAAC;AAClE,OAAO,EAAC,gBAAgB,EAAC,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAC,kBAAkB,EAAC,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAC,iBAAiB,EAAC,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAC,4BAA4B,EAAC,MAAM,gCAAgC,CAAC;AAC5E,OAAO,EAAC,oBAAoB,EAAC,MAAM,wBAAwB,CAAC;AAG5D,OAAO,EAAC,gBAAgB,EAAE,8BAA8B,EAAC,MAAM,wBAAwB,CAAC;AACxF,OAAO,EAAC,gBAAgB,EAAC,MAAM,uBAAuB,CAAC;AAGvD,OAAO,EACL,oBAAoB,EACpB,uBAAuB,EACvB,uBAAuB,EACvB,OAAO,EACP,QAAQ,EACR,SAAS,EACT,yBAAyB,EACzB,iBAAiB,EAClB,MAAM,sBAAsB,CAAC"}

package/dist/events.js

@@ -14,7 +14,7 @@ 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.getUserEventPath = exports.calculateMirrorAmountAndIsOwed = exports.reverseSplitType = exports.ActivityEventHandler = exports.GroupTransactionEventHandler = exports.GroupEventHandler = exports.FriendEventHandler = exports.UserEventHandler = exports.TransactionEventHandler = void 0;
+exports.eventProcessorEnv = exports.resetEventProcessorSource = exports.isUnknown = exports.isClient = exports.isGCFun = exports.getEventProcessorSource = exports.setEventProcessorSource = exports.EventProcessorSource = exports.getUserEventPath = exports.calculateMirrorAmountAndIsOwed = exports.reverseSplitType = exports.ActivityEventHandler = exports.GroupTransactionEventHandler = exports.GroupEventHandler = exports.FriendEventHandler = exports.UserEventHandler = exports.TransactionEventHandler = void 0;
 // Re-export all event types
 __exportStar(require("./TransactionEvents"), exports);
 __exportStar(require("./UserEvents"), exports);
@@ -58,3 +58,13 @@ Object.defineProperty(exports, "reverseSplitType", { enumerable: true, get: func
 Object.defineProperty(exports, "calculateMirrorAmountAndIsOwed", { enumerable: true, get: function () { return splitTypeUtils_1.calculateMirrorAmountAndIsOwed; } });
 var userPathUtils_1 = require("./utils/userPathUtils");
 Object.defineProperty(exports, "getUserEventPath", { enumerable: true, get: function () { return userPathUtils_1.getUserEventPath; } });
+// Re-export environment configuration
+var environment_1 = require("./config/environment");
+Object.defineProperty(exports, "EventProcessorSource", { enumerable: true, get: function () { return environment_1.EventProcessorSource; } });
+Object.defineProperty(exports, "setEventProcessorSource", { enumerable: true, get: function () { return environment_1.setEventProcessorSource; } });
+Object.defineProperty(exports, "getEventProcessorSource", { enumerable: true, get: function () { return environment_1.getEventProcessorSource; } });
+Object.defineProperty(exports, "isGCFun", { enumerable: true, get: function () { return environment_1.isGCFun; } });
+Object.defineProperty(exports, "isClient", { enumerable: true, get: function () { return environment_1.isClient; } });
+Object.defineProperty(exports, "isUnknown", { enumerable: true, get: function () { return environment_1.isUnknown; } });
+Object.defineProperty(exports, "resetEventProcessorSource", { enumerable: true, get: function () { return environment_1.resetEventProcessorSource; } });
+Object.defineProperty(exports, "eventProcessorEnv", { enumerable: true, get: function () { return environment_1.eventProcessorEnv; } });

package/dist/index.d.ts

@@ -1,2 +1,4 @@
 export * from './events';
+export { UserController } from './controllers/UserController';
+export { resetEventBus } from './common/EventBusSingleton';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,UAAU,CAAC;AAGzB,OAAO,EAAC,cAAc,EAAC,MAAM,8BAA8B,CAAC;AAG5D,OAAO,EAAC,aAAa,EAAC,MAAM,4BAA4B,CAAC"}

package/dist/index.js

@@ -14,5 +14,12 @@ 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.resetEventBus = exports.UserController = void 0;
 // Export all backend event definitions here
 __exportStar(require("./events"), exports);
+// Export controllers
+var UserController_1 = require("./controllers/UserController");
+Object.defineProperty(exports, "UserController", { enumerable: true, get: function () { return UserController_1.UserController; } });
+// Export singleton utilities for testing
+var EventBusSingleton_1 = require("./common/EventBusSingleton");
+Object.defineProperty(exports, "resetEventBus", { enumerable: true, get: function () { return EventBusSingleton_1.resetEventBus; } });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zeeshan60/event-processor",
-  "version": "1.0.6",
+  "version": "1.0.7",
   "description": "Shared event sourcing infrastructure for Loan Tracker projects",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -32,6 +32,7 @@
     "typescript": "^5.3.3"
   },
   "dependencies": {
+    "rxjs": "^7.8.1",
     "uuid": "^13.0.0"
   }
 }