@konplit-services/common 1.0.146 → 1.0.147

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

@@ -0,0 +1,61 @@
+/**
+ * Listener Module
+ *
+ * This module defines an abstract `Listener` class for listening to events from a NATS JetStream.
+ * It ensures that the required stream and consumer exist before consuming events.
+ *
+ * @module Listener
+ */
+import { NatsConnection, Msg } from "nats";
+import { StreamEvent, StreamName } from "../subjects";
+/**
+ * Event Interface
+ *
+ * Represents an event that will be consumed from a NATS stream.
+ *
+ * @interface
+ */
+interface Event {
+    subject: string;
+    streamEvents: StreamEvent;
+    streamName: StreamName;
+    data: any;
+}
+/**
+ * Listener Abstract Class
+ *
+ * Abstract class for consuming events from a NATS JetStream.
+ * Subclasses should implement the specific subject, streamEvents, stream, and durableName properties.
+ *
+ * @abstract
+ * @template T - The type of event to be consumed
+ */
+export declare abstract class RequestListener<T extends Event> {
+    private nc;
+    private jc;
+    /**
+     * The subject associated with the event.
+     * @abstract
+     */
+    abstract subject: T["subject"];
+    /**
+     * The durable name for the consumer.
+     * @abstract
+     */
+    abstract durableName: string;
+    /**
+     * Handles the incoming message.
+     * @abstract
+     * @param {T["data"]} data - The decoded data from the message
+     * @param {JsMsg} msg - The raw NATS message
+     */
+    abstract onMessageResponse(data: T["data"], msg: Msg): any;
+    /**
+     * Constructor for the Listener class.
+     *
+     * @param {JetStreamClient} client - The NATS JetStream client
+     */
+    constructor(nc: NatsConnection);
+    listenForRequests(): Promise<void>;
+}
+export {};

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

@@ -0,0 +1,56 @@
+"use strict";
+/**
+ * Listener Module
+ *
+ * This module defines an abstract `Listener` class for listening to events from a NATS JetStream.
+ * It ensures that the required stream and consumer exist before consuming events.
+ *
+ * @module Listener
+ */
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RequestListener = void 0;
+const nats_1 = require("nats");
+/**
+ * Listener Abstract Class
+ *
+ * Abstract class for consuming events from a NATS JetStream.
+ * Subclasses should implement the specific subject, streamEvents, stream, and durableName properties.
+ *
+ * @abstract
+ * @template T - The type of event to be consumed
+ */
+class RequestListener {
+    /**
+     * Constructor for the Listener class.
+     *
+     * @param {JetStreamClient} client - The NATS JetStream client
+     */
+    constructor(nc) {
+        this.jc = (0, nats_1.JSONCodec)();
+        this.nc = nc;
+    }
+    listenForRequests() {
+        return __awaiter(this, void 0, void 0, function* () {
+            this.nc.subscribe(this.subject, {
+                // NOT TRAPPING ERRORS FOR BREVITY (this should be simple enough to implement from this starting point)
+                callback: (err, msg) => __awaiter(this, void 0, void 0, function* () {
+                    // decode the symbol for use in the following query
+                    const decodedRequest = this.jc.decode(msg.data);
+                    console.log("Received Request:", decodedRequest);
+                    const response = yield this.onMessageResponse(decodedRequest, msg);
+                    msg.respond(this.jc.encode(response));
+                }),
+            });
+        });
+    }
+}
+exports.RequestListener = RequestListener;

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

@@ -0,0 +1,56 @@
+/**
+ * Publisher Module
+ *
+ * This module defines an abstract `Publisher` class for publishing events to a NATS JetStream.
+ * It ensures that the required stream exists before publishing events.
+ *
+ * @module Publisher
+ */
+import { NatsConnection } from "nats";
+import { StreamEvent, StreamName } from "../subjects";
+/**
+ * Event Interface
+ *
+ * Represents an event that will be published to a NATS stream.
+ *
+ * @interface
+ */
+interface Event {
+    subject: string;
+    streamEvents: StreamEvent;
+    streamName: StreamName;
+    data: any;
+}
+/**
+ * Publisher Abstract Class
+ *
+ * Abstract class for publishing events to a NATS JetStream.
+ * Subclasses should implement the specific subject, streamEvents, and stream properties.
+ *
+ * @abstract
+ * @template T - The type of event to be published
+ */
+export declare abstract class ResponsePublisher<T extends Event> {
+    private nc;
+    private jc;
+    /**
+     * The subject associated with the event.
+     * @abstract
+     */
+    abstract subject: T["subject"];
+    /**
+     * Constructor for the Publisher class.
+     *
+     * @param {JetStreamClient} client - The NATS JetStream client
+     */
+    constructor(nc: NatsConnection);
+    /**
+     * Sends a request to another service and waits for a reply.
+     *
+     * @param {T["data"]} data - The data to be sent in the request
+     * @param {number} timeout - The timeout duration to wait for a response
+     * @returns {Promise<any>} - Resolves with the reply data from the responding service
+     */
+    request(data: T["data"], timeout?: number): Promise<any>;
+}
+export {};

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

@@ -0,0 +1,68 @@
+"use strict";
+/**
+ * Publisher Module
+ *
+ * This module defines an abstract `Publisher` class for publishing events to a NATS JetStream.
+ * It ensures that the required stream exists before publishing events.
+ *
+ * @module Publisher
+ */
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ResponsePublisher = void 0;
+const nats_1 = require("nats");
+/**
+ * Publisher Abstract Class
+ *
+ * Abstract class for publishing events to a NATS JetStream.
+ * Subclasses should implement the specific subject, streamEvents, and stream properties.
+ *
+ * @abstract
+ * @template T - The type of event to be published
+ */
+class ResponsePublisher {
+    /**
+     * Constructor for the Publisher class.
+     *
+     * @param {JetStreamClient} client - The NATS JetStream client
+     */
+    constructor(nc) {
+        this.jc = (0, nats_1.JSONCodec)();
+        this.nc = nc;
+    }
+    /**
+     * Sends a request to another service and waits for a reply.
+     *
+     * @param {T["data"]} data - The data to be sent in the request
+     * @param {number} timeout - The timeout duration to wait for a response
+     * @returns {Promise<any>} - Resolves with the reply data from the responding service
+     */
+    request(data, timeout = 5000) {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                // Send request and wait for the response
+                const response = yield this.nc.request(this.subject, this.jc.encode(data), { timeout } // Timeout for the response
+                );
+                if (!response) {
+                    throw new Error("Failed to get Response");
+                }
+                const replyData = this.jc.decode(response.data);
+                console.log("Received Reply:", replyData);
+                return replyData;
+            }
+            catch (err) {
+                console.error("Error sending request:", err);
+                throw err;
+            }
+        });
+    }
+}
+exports.ResponsePublisher = ResponsePublisher;

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

@@ -1,2 +1,4 @@
 export * from "./base-events.listener";
 export * from "./base-events.publisher";
+export * from "./base-event-request.listener";
+export * from "./base-event-response-publisher";

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

@@ -16,3 +16,5 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./base-events.listener"), exports);
 __exportStar(require("./base-events.publisher"), exports);
+__exportStar(require("./base-event-request.listener"), exports);
+__exportStar(require("./base-event-response-publisher"), exports);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@konplit-services/common",
-  "version": "1.0.146",
+  "version": "1.0.147",
   "description": "",
   "main": "./build/index.js",
   "types": "./build/index.d.ts",