@taladel/common 1.0.13 → 1.0.16

package/dist/events/auth/user-created-event.d.ts

@@ -0,0 +1,11 @@
+import { Subjects } from '../subjects';
+import { Event } from '../base-event';
+export interface UserCreatedEvent extends Event {
+    subject: Subjects.UserCreated;
+    data: {
+        id: string;
+        email: string;
+        name: string;
+    };
+}
+//# sourceMappingURL=user-created-event.d.ts.map

package/dist/events/auth/user-created-event.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-created-event.d.ts","sourceRoot":"","sources":["../../../src/events/auth/user-created-event.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAQtC,MAAM,WAAW,gBAAiB,SAAQ,KAAK;IAC7C,OAAO,EAAE,QAAQ,CAAC,WAAW,CAAC;IAC9B,IAAI,EAAE;QACJ,EAAE,EAAE,MAAM,CAAC;QACX,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;CACH"}

package/dist/events/auth/user-created-event.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=user-created-event.js.map

package/dist/events/auth/user-created-event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-created-event.js","sourceRoot":"","sources":["../../../src/events/auth/user-created-event.ts"],"names":[],"mappings":""}

package/dist/events/base-event.d.ts

@@ -0,0 +1,6 @@
+import { Subjects } from './subjects';
+export interface Event {
+    subject: Subjects;
+    data: any;
+}
+//# sourceMappingURL=base-event.d.ts.map

package/dist/events/base-event.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-event.d.ts","sourceRoot":"","sources":["../../src/events/base-event.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAStC,MAAM,WAAW,KAAK;IACpB,OAAO,EAAE,QAAQ,CAAC;IAClB,IAAI,EAAE,GAAG,CAAC;CACX"}

package/dist/events/base-event.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=base-event.js.map

package/dist/events/base-event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-event.js","sourceRoot":"","sources":["../../src/events/base-event.ts"],"names":[],"mappings":""}

package/dist/events/base-listener.d.ts

@@ -0,0 +1,12 @@
+import { Consumer } from 'kafkajs';
+import { Event } from './base-event';
+export declare abstract class BaseListener<T extends Event> {
+    abstract subject: T['subject'];
+    abstract groupId: string;
+    abstract onMessage(data: T['data']): Promise<void>;
+    protected consumer: Consumer;
+    constructor(consumer: Consumer);
+    listen(): Promise<void>;
+    parseMessage(data: Buffer | null): T['data'];
+}
+//# sourceMappingURL=base-listener.d.ts.map

package/dist/events/base-listener.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-listener.d.ts","sourceRoot":"","sources":["../../src/events/base-listener.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAsB,MAAM,SAAS,CAAC;AACvD,OAAO,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AASrC,8BAAsB,YAAY,CAAC,CAAC,SAAS,KAAK;IAChD,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAElD,SAAS,CAAC,QAAQ,EAAE,QAAQ,CAAC;gBAEjB,QAAQ,EAAE,QAAQ;IAIxB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAc7B,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,CAAC;CAM7C"}

package/dist/events/base-listener.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseListener = void 0;
+// Abstract base class for all listeners.
+// Each concrete listener (like UserCreatedListener) will:
+//   1. Specify which topic (subject) to listen to
+//   2. Specify the consumer group name (Kafka's version of queue groups)
+//   3. Implement onMessage() to handle the event
+//
+// The Kafka Consumer is injected via constructor — we don't create it here.
+class BaseListener {
+    constructor(consumer) {
+        this.consumer = consumer;
+    }
+    async listen() {
+        await this.consumer.connect();
+        await this.consumer.subscribe({ topic: this.subject, fromBeginning: true });
+        await this.consumer.run({
+            eachMessage: async ({ message }) => {
+                console.log(`Event received: ${this.subject}`);
+                const parsedData = this.parseMessage(message.value);
+                await this.onMessage(parsedData);
+            },
+        });
+    }
+    parseMessage(data) {
+        if (!data) {
+            throw new Error('Received empty message');
+        }
+        return JSON.parse(data.toString('utf8'));
+    }
+}
+exports.BaseListener = BaseListener;
+//# sourceMappingURL=base-listener.js.map

package/dist/events/base-listener.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-listener.js","sourceRoot":"","sources":["../../src/events/base-listener.ts"],"names":[],"mappings":";;;AAGA,yCAAyC;AACzC,0DAA0D;AAC1D,kDAAkD;AAClD,yEAAyE;AACzE,iDAAiD;AACjD,EAAE;AACF,4EAA4E;AAC5E,MAAsB,YAAY;IAOhC,YAAY,QAAkB;QAC5B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED,KAAK,CAAC,MAAM;QACV,MAAM,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;QAC9B,MAAM,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QAE5E,MAAM,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;YACtB,WAAW,EAAE,KAAK,EAAE,EAAE,OAAO,EAAsB,EAAE,EAAE;gBACrD,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;gBAE/C,MAAM,UAAU,GAAG,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;gBACpD,MAAM,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;YACnC,CAAC;SACF,CAAC,CAAC;IACL,CAAC;IAED,YAAY,CAAC,IAAmB;QAC9B,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;QAC5C,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;IAC3C,CAAC;CACF;AA/BD,oCA+BC"}

package/dist/events/base-publisher.d.ts

@@ -0,0 +1,9 @@
+import { Producer } from 'kafkajs';
+import { Event } from './base-event';
+export declare abstract class BasePublisher<T extends Event> {
+    abstract subject: T['subject'];
+    protected producer: Producer;
+    constructor(producer: Producer);
+    publish(data: T['data']): Promise<void>;
+}
+//# sourceMappingURL=base-publisher.d.ts.map

package/dist/events/base-publisher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-publisher.d.ts","sourceRoot":"","sources":["../../src/events/base-publisher.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACnC,OAAO,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAQrC,8BAAsB,aAAa,CAAC,CAAC,SAAS,KAAK;IACjD,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC;IAC/B,SAAS,CAAC,QAAQ,EAAE,QAAQ,CAAC;gBAEjB,QAAQ,EAAE,QAAQ;IAIxB,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;CAY9C"}

package/dist/events/base-publisher.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BasePublisher = void 0;
+// Abstract base class for all publishers.
+// Each concrete publisher (like UserCreatedPublisher) will:
+//   1. Specify which topic (subject) it publishes to
+//   2. Call publish() with the typed data
+//
+// The Kafka Producer is injected via constructor — we don't create it here.
+class BasePublisher {
+    constructor(producer) {
+        this.producer = producer;
+    }
+    async publish(data) {
+        await this.producer.send({
+            topic: this.subject,
+            messages: [
+                {
+                    value: JSON.stringify(data),
+                },
+            ],
+        });
+        console.log(`Event published to topic: ${this.subject}`);
+    }
+}
+exports.BasePublisher = BasePublisher;
+//# sourceMappingURL=base-publisher.js.map

package/dist/events/base-publisher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-publisher.js","sourceRoot":"","sources":["../../src/events/base-publisher.ts"],"names":[],"mappings":";;;AAGA,0CAA0C;AAC1C,4DAA4D;AAC5D,qDAAqD;AACrD,0CAA0C;AAC1C,EAAE;AACF,4EAA4E;AAC5E,MAAsB,aAAa;IAIjC,YAAY,QAAkB;QAC5B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,IAAe;QAC3B,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;YACvB,KAAK,EAAE,IAAI,CAAC,OAAO;YACnB,QAAQ,EAAE;gBACR;oBACE,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;iBAC5B;aACF;SACF,CAAC,CAAC;QAEH,OAAO,CAAC,GAAG,CAAC,6BAA6B,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;IAC3D,CAAC;CACF;AApBD,sCAoBC"}

package/dist/events/subjects.d.ts

@@ -0,0 +1,12 @@
+export declare enum Subjects {
+    UserCreated = "user:created",
+    ProductCreated = "product:created",
+    ProductUpdated = "product:updated",
+    ProductDeleted = "product:deleted",
+    OrderCreated = "order:created",
+    OrderUpdated = "order:updated",
+    OrderComplete = "order:complete",
+    OrderExpired = "order:expired",
+    PaymentComplete = "payment:complete"
+}
+//# sourceMappingURL=subjects.d.ts.map

package/dist/events/subjects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subjects.d.ts","sourceRoot":"","sources":["../../src/events/subjects.ts"],"names":[],"mappings":"AAGA,oBAAY,QAAQ;IAChB,WAAW,iBAAiB;IAE5B,cAAc,oBAAoB;IAClC,cAAc,oBAAoB;IAClC,cAAc,oBAAoB;IAElC,YAAY,kBAAkB;IAC9B,YAAY,kBAAkB;IAC9B,aAAa,mBAAmB;IAChC,YAAY,kBAAkB;IAE9B,eAAe,qBAAqB;CACrC"}

package/dist/events/subjects.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Subjects = void 0;
+// Enum of all Kafka topic names.
+// Think of this as the "master list" of all possible events in the system.
+// If a topic isn't here, it doesn't exist.
+var Subjects;
+(function (Subjects) {
+    Subjects["UserCreated"] = "user:created";
+    Subjects["ProductCreated"] = "product:created";
+    Subjects["ProductUpdated"] = "product:updated";
+    Subjects["ProductDeleted"] = "product:deleted";
+    Subjects["OrderCreated"] = "order:created";
+    Subjects["OrderUpdated"] = "order:updated";
+    Subjects["OrderComplete"] = "order:complete";
+    Subjects["OrderExpired"] = "order:expired";
+    Subjects["PaymentComplete"] = "payment:complete";
+})(Subjects || (exports.Subjects = Subjects = {}));
+//# sourceMappingURL=subjects.js.map

package/dist/events/subjects.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subjects.js","sourceRoot":"","sources":["../../src/events/subjects.ts"],"names":[],"mappings":";;;AAAA,iCAAiC;AACjC,2EAA2E;AAC3E,2CAA2C;AAC3C,IAAY,QAaT;AAbH,WAAY,QAAQ;IAChB,wCAA4B,CAAA;IAE5B,8CAAkC,CAAA;IAClC,8CAAkC,CAAA;IAClC,8CAAkC,CAAA;IAElC,0CAA8B,CAAA;IAC9B,0CAA8B,CAAA;IAC9B,4CAAgC,CAAA;IAChC,0CAA8B,CAAA;IAE9B,gDAAoC,CAAA;AACtC,CAAC,EAbS,QAAQ,wBAAR,QAAQ,QAajB"}

package/dist/index.d.ts

@@ -14,4 +14,9 @@ export * from './middlewares/error-handler';
 export * from './middlewares/validate-request';
 export * from './correlation/middleware';
 export * from './correlation/types';
+export * from './events/subjects';
+export * from './events/base-listener';
+export * from './events/base-publisher';
+export * from './events/base-event';
+export * from './events/auth/user-created-event';
 //# 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":"AAAA;;GAEG;AACH,OAAO,EACH,uBAAuB,EACvB,gBAAgB,GACnB,MAAM,0BAA0B,CAAC;AAElC;;GAEG;AACH,YAAY,EACR,oBAAoB,EACpB,sBAAsB,GACzB,MAAM,qBAAqB,CAAC;AAE7B,cAAc,wBAAwB,CAAC;AACvC,cAAc,6BAA6B,CAAC;AAE5C,cAAc,uBAAuB,CAAC;AAEtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,gCAAgC,CAAC;AAG/C,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EACH,uBAAuB,EACvB,gBAAgB,GACnB,MAAM,0BAA0B,CAAC;AAElC;;GAEG;AACH,YAAY,EACR,oBAAoB,EACpB,sBAAsB,GACzB,MAAM,qBAAqB,CAAC;AAE7B,cAAc,wBAAwB,CAAC;AACvC,cAAc,6BAA6B,CAAC;AAE5C,cAAc,uBAAuB,CAAC;AAEtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,gCAAgC,CAAC;AAG/C,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AAEpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AAEpC,cAAc,kCAAkC,CAAC"}

package/dist/index.js

@@ -29,4 +29,9 @@ __exportStar(require("./middlewares/error-handler"), exports);
 __exportStar(require("./middlewares/validate-request"), exports);
 __exportStar(require("./correlation/middleware"), exports);
 __exportStar(require("./correlation/types"), exports);
+__exportStar(require("./events/subjects"), exports);
+__exportStar(require("./events/base-listener"), exports);
+__exportStar(require("./events/base-publisher"), exports);
+__exportStar(require("./events/base-event"), exports);
+__exportStar(require("./events/auth/user-created-event"), exports);
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA;;GAEG;AACH,uDAGkC;AAF9B,qHAAA,uBAAuB,OAAA;AACvB,8GAAA,gBAAgB,OAAA;AAWpB,yDAAuC;AACvC,8DAA4C;AAE5C,wDAAsC;AAEtC,yDAAuC;AACvC,8DAA4C;AAC5C,iEAA+C;AAG/C,2DAAyC;AACzC,sDAAoC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA;;GAEG;AACH,uDAGkC;AAF9B,qHAAA,uBAAuB,OAAA;AACvB,8GAAA,gBAAgB,OAAA;AAWpB,yDAAuC;AACvC,8DAA4C;AAE5C,wDAAsC;AAEtC,yDAAuC;AACvC,8DAA4C;AAC5C,iEAA+C;AAG/C,2DAAyC;AACzC,sDAAoC;AAEpC,oDAAkC;AAClC,yDAAuC;AACvC,0DAAwC;AACxC,sDAAoC;AAEpC,mEAAiD"}

package/dist/services/jwt.service.d.ts

@@ -1,6 +1,7 @@
 export interface jwtPayload {
     userId?: string;
     email?: string;
+    name?: string;
 }
 export default class JwtService {
     static generateToken(payload: jwtPayload): string;

package/dist/services/jwt.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"jwt.service.d.ts","sourceRoot":"","sources":["../../src/services/jwt.service.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,UAAU;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAElB;AAED,MAAM,CAAC,OAAO,OAAO,UAAU;IAC3B,MAAM,CAAC,aAAa,CAAC,OAAO,EAAE,UAAU,GAAG,MAAM;IAWjD,MAAM,CAAC,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU;CAUhD"}
+{"version":3,"file":"jwt.service.d.ts","sourceRoot":"","sources":["../../src/services/jwt.service.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,UAAU;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CAEjB;AAED,MAAM,CAAC,OAAO,OAAO,UAAU;IAC3B,MAAM,CAAC,aAAa,CAAC,OAAO,EAAE,UAAU,GAAG,MAAM;IAWjD,MAAM,CAAC,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU;CAUhD"}

package/dist/services/jwt.service.js.map

@@ -1 +1 @@
-{"version":3,"file":"jwt.service.js","sourceRoot":"","sources":["../../src/services/jwt.service.ts"],"names":[],"mappings":";;;;;AAAA,gEAA+B;AAC/B,yDAAqD;AAQrD,MAAqB,UAAU;IAC3B,MAAM,CAAC,aAAa,CAAC,OAAmB;QACpC,OAAO,sBAAG,CAAC,IAAI,CACX,OAAO,EACP,OAAO,CAAC,GAAG,CAAC,UAAW,EACvB;YACE,SAAS,EAAE,IAAI;YACf,SAAS,EAAE,OAAO;SACnB,CACJ,CAAC;IACN,CAAC;IAED,MAAM,CAAC,WAAW,CAAC,KAAa;QAC5B,IAAI,CAAC;YACL,OAAO,sBAAG,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,UAAW,EAAE;gBACtC,UAAU,EAAE,CAAC,OAAO,CAAC;aAC5B,CAAe,CAAC;QACrB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,MAAM,IAAI,0BAAW,CAAC,GAAG,EAAE,0BAA0B,CAAC,CAAC;QAC3D,CAAC;IACL,CAAC;CAEJ;AAtBD,6BAsBC"}
+{"version":3,"file":"jwt.service.js","sourceRoot":"","sources":["../../src/services/jwt.service.ts"],"names":[],"mappings":";;;;;AAAA,gEAA+B;AAC/B,yDAAqD;AASrD,MAAqB,UAAU;IAC3B,MAAM,CAAC,aAAa,CAAC,OAAmB;QACpC,OAAO,sBAAG,CAAC,IAAI,CACX,OAAO,EACP,OAAO,CAAC,GAAG,CAAC,UAAW,EACvB;YACE,SAAS,EAAE,IAAI;YACf,SAAS,EAAE,OAAO;SACnB,CACJ,CAAC;IACN,CAAC;IAED,MAAM,CAAC,WAAW,CAAC,KAAa;QAC5B,IAAI,CAAC;YACL,OAAO,sBAAG,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,UAAW,EAAE;gBACtC,UAAU,EAAE,CAAC,OAAO,CAAC;aAC5B,CAAe,CAAC;QACrB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,MAAM,IAAI,0BAAW,CAAC,GAAG,EAAE,0BAA0B,CAAC,CAAC;QAC3D,CAAC;IACL,CAAC;CAEJ;AAtBD,6BAsBC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@taladel/common",
-  "version": "1.0.13",
+  "version": "1.0.16",
   "description": "common utilities for microservices",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -10,7 +10,7 @@
   "scripts": {
     "clean": "rm -rf dist",
     "build": "npm run clean && tsc",
-    "pub": "git add . && git commit -m \"Updates\" && npm version patch && npm run build && npm publish --access public && git push && git push --tags"
+    "pub": "npm run build && git add . && git commit -m \"Updates\" && npm version patch && npm publish --access public && git push && git push --tags"
   },
   "keywords": [],
   "author": "",
@@ -23,7 +23,8 @@
     "bcryptjs": "^3.0.3",
     "cls-rtracer": "^2.6.3",
     "express-validator": "^7.3.1",
-    "jsonwebtoken": "^9.0.3"
+    "jsonwebtoken": "^9.0.3",
+    "kafkajs": "^2.2.4"
   },
   "devDependencies": {
     "@types/bcryptjs": "^2.4.6",

package/src/events/auth/user-created-event.ts

@@ -0,0 +1,17 @@
+import { Subjects } from '../subjects';
+import { Event } from '../base-event';
+
+// This is the CONCRETE event.
+// It takes the generic Event interface and fills in the specifics:
+//   - subject is locked to 'user:created'
+//   - data is locked to this exact shape: { id, email, name }
+//
+// Think of Event as "event template", and this as "filled-out form".
+export interface UserCreatedEvent extends Event {
+  subject: Subjects.UserCreated;
+  data: {
+    id: string;
+    email: string;
+    name: string;
+  };
+}

package/src/events/base-event.ts

@@ -0,0 +1,13 @@
+import { Subjects } from './subjects';
+
+// This is a TypeScript contract.
+// Every event in the system MUST have:
+//   1. A subject (the Kafka topic name from the Subjects enum)
+//   2. A data payload (the shape depends on the specific event)
+//
+// Think of it like a form template: "All events need these two fields."
+// The actual events (like UserCreatedEvent) will fill in the specifics.
+export interface Event {
+  subject: Subjects;
+  data: any;
+}

package/src/events/base-listener.ts

@@ -0,0 +1,42 @@
+import { Consumer, EachMessagePayload } from 'kafkajs';
+import { Event } from './base-event';
+
+// Abstract base class for all listeners.
+// Each concrete listener (like UserCreatedListener) will:
+//   1. Specify which topic (subject) to listen to
+//   2. Specify the consumer group name (Kafka's version of queue groups)
+//   3. Implement onMessage() to handle the event
+//
+// The Kafka Consumer is injected via constructor — we don't create it here.
+export abstract class BaseListener<T extends Event> {
+  abstract subject: T['subject'];
+  abstract groupId: string;  // Kafka's "consumer group" = NATS "queue group"
+  abstract onMessage(data: T['data']): Promise<void>;
+
+  protected consumer: Consumer;
+
+  constructor(consumer: Consumer) {
+    this.consumer = consumer;
+  }
+
+  async listen(): Promise<void> {
+    await this.consumer.connect();
+    await this.consumer.subscribe({ topic: this.subject, fromBeginning: true });
+
+    await this.consumer.run({
+      eachMessage: async ({ message }: EachMessagePayload) => {
+        console.log(`Event received: ${this.subject}`);
+        
+        const parsedData = this.parseMessage(message.value);
+        await this.onMessage(parsedData);
+      },
+    });
+  }
+
+  parseMessage(data: Buffer | null): T['data'] {
+    if (!data) {
+      throw new Error('Received empty message');
+    }
+    return JSON.parse(data.toString('utf8'));
+  }
+}

package/src/events/base-publisher.ts

@@ -0,0 +1,30 @@
+import { Producer } from 'kafkajs';
+import { Event } from './base-event';
+
+// Abstract base class for all publishers.
+// Each concrete publisher (like UserCreatedPublisher) will:
+//   1. Specify which topic (subject) it publishes to
+//   2. Call publish() with the typed data
+//
+// The Kafka Producer is injected via constructor — we don't create it here.
+export abstract class BasePublisher<T extends Event> {
+  abstract subject: T['subject'];
+  protected producer: Producer;
+
+  constructor(producer: Producer) {
+    this.producer = producer;
+  }
+
+  async publish(data: T['data']): Promise<void> {
+    await this.producer.send({
+      topic: this.subject,
+      messages: [
+        {
+          value: JSON.stringify(data),
+        },
+      ],
+    });
+
+    console.log(`Event published to topic: ${this.subject}`);
+  }
+}

package/src/events/subjects.ts

@@ -0,0 +1,17 @@
+// Enum of all Kafka topic names.
+// Think of this as the "master list" of all possible events in the system.
+// If a topic isn't here, it doesn't exist.
+export enum Subjects {
+    UserCreated = 'user:created',
+    
+    ProductCreated = 'product:created',
+    ProductUpdated = 'product:updated',
+    ProductDeleted = 'product:deleted',
+    
+    OrderCreated = 'order:created',
+    OrderUpdated = 'order:updated',
+    OrderComplete = 'order:complete',
+    OrderExpired = 'order:expired',
+    
+    PaymentComplete = 'payment:complete',
+  }

package/src/index.ts

@@ -25,4 +25,11 @@ export * from './middlewares/validate-request';
 
 
 export * from './correlation/middleware';
-export * from './correlation/types';    
+export * from './correlation/types';    
+
+export * from './events/subjects';
+export * from './events/base-listener';
+export * from './events/base-publisher';
+export * from './events/base-event';
+
+export * from './events/auth/user-created-event';

package/src/services/jwt.service.ts

@@ -4,6 +4,7 @@ import { CustomError } from '../errors/custom-error';
 export interface jwtPayload {
     userId?: string;
     email?: string;
+    name?: string;
     
 }