@vortenixinnovations/flagra-common-module 1.0.58 → 1.0.60

package/build/events/account/account-created-event.d.ts

@@ -0,0 +1,11 @@
+import { Subjects } from "../base/subjects.js";
+export interface AccountCreatedEvent {
+    subject: Subjects.AccountCreated;
+    data: {
+        id: string;
+        fullname: string;
+        role: string;
+        email: string;
+        password: string;
+    };
+}

package/build/events/account/account-created-event.js

@@ -0,0 +1 @@
+export {};

package/build/events/account/account-verify-event.d.ts

@@ -0,0 +1,10 @@
+import { Subjects } from "../base/subjects.js";
+export interface AccountVerifyEvent {
+    subject: Subjects.AccountVerify;
+    data: {
+        id: string;
+        first: string;
+        email: string;
+        otp: number;
+    };
+}

package/build/events/account/account-verify-event.js

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1,5 @@
+import { Subjects } from "./subjects.js";
+export interface Event {
+    subject: Subjects;
+    data: any;
+}

package/build/events/base/base-event.js

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1,21 @@
+import { JetStreamClient, JetStreamManager, JsMsg, NatsConnection, ConsumerConfig } from "nats";
+import { Subjects } from "./subjects.js";
+interface Event {
+    subject: Subjects;
+    data: any;
+}
+export declare abstract class Listener<T extends Event> {
+    protected nc: NatsConnection;
+    abstract subject: T["subject"];
+    abstract queueGroupName: string;
+    abstract onMessage(data: T["data"], msg: JsMsg): void;
+    protected client: JetStreamClient;
+    protected manager: JetStreamManager;
+    protected ackWait: number;
+    constructor(nc: NatsConnection);
+    init(): Promise<void>;
+    subscriptionOptions(): Partial<ConsumerConfig>;
+    listen(): Promise<void>;
+    private parseMessage;
+}
+export {};

package/build/events/base/base-listener.js

@@ -0,0 +1,75 @@
+import { AckPolicy, StorageType, DeliverPolicy, } from "nats";
+import { logger } from "../../util/logger/index.js";
+export class Listener {
+    nc;
+    client;
+    manager;
+    ackWait = 30_000_000_000; // 30 seconds in nanoseconds
+    constructor(nc) {
+        this.nc = nc;
+        this.client = nc.jetstream();
+    }
+    async init() {
+        this.manager = await this.nc.jetstreamManager();
+    }
+    subscriptionOptions() {
+        return {
+            durable_name: this.queueGroupName,
+            ack_policy: AckPolicy.Explicit,
+            deliver_policy: DeliverPolicy.All,
+            ack_wait: this.ackWait,
+            max_ack_pending: 100,
+            max_deliver: 5,
+        };
+    }
+    async listen() {
+        if (!this.manager)
+            await this.init();
+        const streamName = `STREAM_${this.subject}`;
+        const durableName = this.queueGroupName;
+        // Ensure the stream exists
+        try {
+            await this.manager.streams.info(streamName);
+        }
+        catch {
+            logger.info(`Creating stream: ${streamName}`);
+            await this.manager.streams.add({
+                name: streamName,
+                subjects: [this.subject],
+                storage: StorageType.File,
+            });
+        }
+        // Ensure the consumer (durable queue group) exists
+        try {
+            await this.manager.consumers.info(streamName, durableName);
+        }
+        catch {
+            logger.info(`Creating durable consumer: ${durableName}`);
+            await this.manager.consumers.add(streamName, this.subscriptionOptions());
+        }
+        logger.info(`Listening for subject "${this.subject}" with queue group "${durableName}"`);
+        const consumer = await this.client.consumers.get(streamName, durableName);
+        // Use next() in a loop - simplest and works reliably
+        while (true) {
+            try {
+                const msg = await consumer.next({ expires: 30000 });
+                if (msg) {
+                    const parsedData = this.parseMessage(msg);
+                    this.onMessage(parsedData, msg);
+                }
+            }
+            catch (err) {
+                // Handle timeout or other errors
+                if (err.code !== "408") {
+                    // 408 is timeout, which is normal
+                    logger.info("Error getting message:", err);
+                    await new Promise((resolve) => setTimeout(resolve, 1000));
+                }
+            }
+        }
+    }
+    parseMessage(msg) {
+        const data = msg.data;
+        return JSON.parse(new TextDecoder().decode(data));
+    }
+}

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

@@ -0,0 +1,9 @@
+import { NatsConnection } from "nats";
+import { Event } from "./base-event.js";
+export declare abstract class Publisher<T extends Event> {
+    abstract subject: T["subject"];
+    protected client: NatsConnection;
+    private sc;
+    constructor(client: NatsConnection);
+    publish(data: T["data"]): Promise<void>;
+}

package/build/events/base/base-publisher.js

@@ -0,0 +1,15 @@
+import { StringCodec } from "nats";
+import { logger } from "../../util/logger/index.js";
+export class Publisher {
+    client;
+    sc = StringCodec();
+    constructor(client) {
+        this.client = client;
+    }
+    async publish(data) {
+        const encoded = this.sc.encode(JSON.stringify(data));
+        this.client.publish(this.subject, encoded);
+        await this.client.flush();
+        logger.info(`Event published to [${this.subject}]: ${JSON.stringify(data)}`);
+    }
+}

package/build/events/base/base-request-listener.d.ts

@@ -0,0 +1,11 @@
+import { NatsConnection } from "nats";
+import { RequestEvent } from "./request-event.js";
+export declare abstract class RequestListener<T extends RequestEvent> {
+    abstract subject: T["subject"];
+    abstract queueGroupName: string;
+    protected client: NatsConnection;
+    private sc;
+    constructor(client: NatsConnection);
+    abstract onRequest(data: T["request"]): Promise<T["response"]>;
+    listen(): Promise<void>;
+}

package/build/events/base/base-request-listener.js

@@ -0,0 +1,25 @@
+import { StringCodec } from "nats";
+import { logger } from "../../util/logger/index.js";
+export class RequestListener {
+    client;
+    sc = StringCodec();
+    constructor(client) {
+        this.client = client;
+    }
+    async listen() {
+        const opts = { queue: this.queueGroupName };
+        const sub = this.client.subscribe(this.subject, opts);
+        logger.info(`Listening for RPC requests on subject [${this.subject}] in queue [${this.queueGroupName}]`);
+        for await (const msg of sub) {
+            try {
+                const data = JSON.parse(this.sc.decode(msg.data));
+                const response = await this.onRequest(data);
+                msg.respond(this.sc.encode(JSON.stringify(response)));
+            }
+            catch (err) {
+                logger.error(`Failed to process RPC [${this.subject}]: ${err.message}`);
+                msg.respond(this.sc.encode(JSON.stringify({ error: err.message })));
+            }
+        }
+    }
+}

package/build/events/base/base-request-publisher.d.ts

@@ -0,0 +1,9 @@
+import { NatsConnection } from "nats";
+import { RequestEvent } from "./request-event.js";
+export declare abstract class RequestPublisher<T extends RequestEvent> {
+    abstract subject: T["subject"];
+    protected client: NatsConnection;
+    private sc;
+    constructor(client: NatsConnection);
+    send(data: T["request"], timeout?: number): Promise<T["response"]>;
+}

package/build/events/base/base-request-publisher.js

@@ -0,0 +1,22 @@
+import { StringCodec } from "nats";
+import { logger } from "../../util/logger/index.js";
+export class RequestPublisher {
+    client;
+    sc = StringCodec();
+    constructor(client) {
+        this.client = client;
+    }
+    async send(data, timeout = 5000) {
+        const encoded = this.sc.encode(JSON.stringify(data));
+        try {
+            const msg = await this.client.request(this.subject, encoded, { timeout });
+            const response = JSON.parse(this.sc.decode(msg.data));
+            logger.info(`RPC response received for [${this.subject}]`);
+            return response;
+        }
+        catch (err) {
+            logger.error(`RPC request to [${this.subject}] failed: ${err.message}`);
+            throw err;
+        }
+    }
+}

package/build/events/base/request-event.d.ts

@@ -0,0 +1,6 @@
+import { Subjects } from "./subjects.js";
+export interface RequestEvent {
+    subject: Subjects;
+    request: any;
+    response: any;
+}

package/build/events/base/request-event.js

@@ -0,0 +1 @@
+export {};

package/build/events/base/subjects.d.ts

@@ -0,0 +1,4 @@
+export declare enum Subjects {
+    AccountVerify = "account:verify",
+    AccountCreated = "account:created"
+}

package/build/events/base/subjects.js

@@ -0,0 +1,5 @@
+export var Subjects;
+(function (Subjects) {
+    Subjects["AccountVerify"] = "account:verify";
+    Subjects["AccountCreated"] = "account:created";
+})(Subjects || (Subjects = {}));

package/build/index.d.ts

@@ -1 +1,9 @@
 export * from "./util/index.js";
+export * from "./events/base/base-event.js";
+export * from "./events/base/base-listener.js";
+export * from "./events/base/base-publisher.js";
+export * from "./events/base/subjects.js";
+export * from "./events/account/account-created-event.js";
+export * from "./events/base/request-event.js";
+export * from "./events/base/base-request-publisher.js";
+export * from "./events/base/base-request-listener.js";

package/build/index.js

@@ -1 +1,9 @@
 export * from "./util/index.js";
+export * from "./events/base/base-event.js";
+export * from "./events/base/base-listener.js";
+export * from "./events/base/base-publisher.js";
+export * from "./events/base/subjects.js";
+export * from "./events/account/account-created-event.js";
+export * from "./events/base/request-event.js";
+export * from "./events/base/base-request-publisher.js";
+export * from "./events/base/base-request-listener.js";

package/build/util/logger/index.d.ts

@@ -0,0 +1,3 @@
+import pino from "pino";
+export declare const logger: pino.Logger<never, boolean>;
+export declare const httpLogger: import("pino-http").HttpLogger<import("http").IncomingMessage, import("http").ServerResponse<import("http").IncomingMessage>, never>;

package/build/util/logger/index.js

@@ -0,0 +1,39 @@
+import pino from "pino";
+import { pinoHttp } from "pino-http";
+import fs from "fs";
+import path from "path";
+import { fileURLToPath } from 'url';
+import dotenv from "dotenv";
+dotenv.config();
+const isProd = process.env.APP_ENV == "production";
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+// Ensure logs directory exists
+const logDir = path.resolve(__dirname, "../logs");
+if (isProd && !fs.existsSync(logDir)) {
+    fs.mkdirSync(logDir, { recursive: true });
+}
+const destination = isProd
+    ? pino.destination({ dest: path.join(logDir, "app.log"), sync: false }) // non-blocking file write
+    : undefined;
+export const logger = pino({
+    level: "info",
+    timestamp: () => `,"time":"${new Date().toISOString()}"`,
+    ...(isProd
+        ? {} // No transport for production — raw JSON
+        : {
+            transport: {
+                target: "pino-pretty",
+                options: {
+                    colorize: true,
+                    translateTime: "SYS:standard",
+                    ignore: "pid,hostname",
+                },
+            },
+        }),
+}, destination // Only used in production
+);
+// HTTP request logger for Express
+export const httpLogger = pinoHttp({
+    logger,
+});

package/package.json

@@ -1,47 +1,35 @@
 {
   "name": "@vortenixinnovations/flagra-common-module",
-  "version": "1.0.58",
-  "description": "common module of flagra",
+  "version": "1.0.60",
+  "description": "flagra.com common module",
+  "type": "module",
   "main": "./build/index.js",
   "types": "./build/index.d.ts",
   "files": [
-    "/build/**/*"
+    "build/**/*"
   ],
-  "publishConfig": {
-    "access": "public"
-  },
-  "exports": {
-    ".": {
-      "types": "./build/index.d.ts",
-      "import": "./build/index.js",
-      "require": "./build/index.js",
-      "default": "./build/index.js"
-    },
-    "./package.json": "./package.json"
-  },
   "scripts": {
-    "clean": "del-cli ./build/*",
+    "clean": "del ./build/*",
     "build": "npm run clean && tsc",
     "release": "npm version patch && npm run build && npm publish"
   },
+  "keywords": [],
+  "author": "midhunx01",
+  "license": "ISC",
+  "devDependencies": {
+    "@types/node": "^24.9.1",
+    "del-cli": "^5.1.0",
+    "typescript": "^5.6.2"
+  },
   "dependencies": {
-    "@sinclair/typebox": "^0.34.41",
-    "ajv": "^8.17.1",
-    "ajv-errors": "^3.0.0",
-    "ajv-formats": "^3.0.1",
-    "class-validator": "^0.14.2",
+    "@types/express": "^5.0.5",
     "dotenv": "^17.2.3",
     "express": "^5.1.0",
-    "pino": "^10.0.0",
+    "nats": "^2.29.3",
+    "node": "^22.21.0",
+    "node-nats-streaming": "^0.3.2",
+    "pino": "^10.1.0",
     "pino-http": "^11.0.0",
-    "pino-pretty": "^13.0.0"
-  },
-  "devDependencies": {
-    "@types/express": "^5.0.3",
-    "@types/node": "^24.7.0",
-    "del-cli": "^7.0.0",
-    "typescript": "^5.9.3"
-  },
-  "author": "midhunx01",
-  "license": "ISC"
+    "pino-pretty": "^13.1.2"
+  }
 }