@hastehaul/common 1.0.15 → 1.0.18

package/build/errors/not-authorized-error.d.ts

@@ -0,0 +1,30 @@
+import { StatusCodes } from '../utils/enums';
+import { CustomError } from './custom-error';
+/**
+ * Custom error class representing a "Not Authorized" error.
+ *
+ * The "NotAuthorizedError" class extends the base "CustomError" class to handle errors related to unauthorized access to a resource or action.
+ * It sets the HTTP status code to 401 (UNAUTHORIZED) and provides a default error message of "Not Authorized".
+ * Subclasses can customize the error message or additional fields as needed by overriding the "serializeErrors" method.
+ */
+export declare class NotAuthorizedError extends CustomError {
+    /**
+     * HTTP status code for the "Not Authorized" error.
+     */
+    statusCode: StatusCodes;
+    /**
+     * Creates a new instance of the "NotAuthorizedError" class with a default error message of "Not Authorized".
+     */
+    constructor();
+    /**
+     * Serializes the error to be sent as a response to the client.
+     *
+     * The "serializeErrors" method returns an array containing an object with the error message for the "Not Authorized" error.
+     * Subclasses can override this method to provide custom error serialization.
+     *
+     * @returns An array containing an object with the error message for the "Not Authorized" error.
+     */
+    serializeErrors(): {
+        message: string;
+    }[];
+}

package/build/errors/not-authorized-error.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NotAuthorizedError = void 0;
+const enums_1 = require("../utils/enums");
+const custom_error_1 = require("./custom-error");
+/**
+ * Custom error class representing a "Not Authorized" error.
+ *
+ * The "NotAuthorizedError" class extends the base "CustomError" class to handle errors related to unauthorized access to a resource or action.
+ * It sets the HTTP status code to 401 (UNAUTHORIZED) and provides a default error message of "Not Authorized".
+ * Subclasses can customize the error message or additional fields as needed by overriding the "serializeErrors" method.
+ */
+class NotAuthorizedError extends custom_error_1.CustomError {
+    /**
+     * Creates a new instance of the "NotAuthorizedError" class with a default error message of "Not Authorized".
+     */
+    constructor() {
+        super('Not Authorized');
+        /**
+         * HTTP status code for the "Not Authorized" error.
+         */
+        this.statusCode = enums_1.StatusCodes.UNAUTHORIZED;
+        // Ensures correct prototype chain for subclassing.
+        Object.setPrototypeOf(this, NotAuthorizedError.prototype);
+    }
+    /**
+     * Serializes the error to be sent as a response to the client.
+     *
+     * The "serializeErrors" method returns an array containing an object with the error message for the "Not Authorized" error.
+     * Subclasses can override this method to provide custom error serialization.
+     *
+     * @returns An array containing an object with the error message for the "Not Authorized" error.
+     */
+    serializeErrors() {
+        return [{ message: 'Not authorized' }];
+    }
+}
+exports.NotAuthorizedError = NotAuthorizedError;

package/build/errors/resource-not-found.d.ts

@@ -0,0 +1,30 @@
+import { StatusCodes } from '../utils/enums';
+import { CustomError } from './custom-error';
+/**
+ * Custom error class representing a "Resource Not Found" error.
+ *
+ * The "ResourceNotFound" class extends the base "CustomError" class to handle errors related to resources that cannot be found.
+ * It sets the HTTP status code to 404 (NOT_FOUND) and provides a default error message of "Resource not found".
+ * Subclasses can customize the error message or additional fields as needed by overriding the "serializeErrors" method.
+ */
+export declare class ResourceNotFound extends CustomError {
+    /**
+     * HTTP status code for the "Resource Not Found" error.
+     */
+    statusCode: StatusCodes;
+    /**
+     * Creates a new instance of the "ResourceNotFound" class with a default error message of "Resource not found".
+     */
+    constructor();
+    /**
+     * Serializes the error to be sent as a response to the client.
+     *
+     * The "serializeErrors" method returns an array containing an object with the error message for the "Resource Not Found" error.
+     * Subclasses can override this method to provide custom error serialization.
+     *
+     * @returns An array containing an object with the error message for the "Resource Not Found" error.
+     */
+    serializeErrors(): {
+        message: string;
+    }[];
+}

package/build/errors/resource-not-found.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ResourceNotFound = void 0;
+const enums_1 = require("../utils/enums");
+const custom_error_1 = require("./custom-error");
+/**
+ * Custom error class representing a "Resource Not Found" error.
+ *
+ * The "ResourceNotFound" class extends the base "CustomError" class to handle errors related to resources that cannot be found.
+ * It sets the HTTP status code to 404 (NOT_FOUND) and provides a default error message of "Resource not found".
+ * Subclasses can customize the error message or additional fields as needed by overriding the "serializeErrors" method.
+ */
+class ResourceNotFound extends custom_error_1.CustomError {
+    /**
+     * Creates a new instance of the "ResourceNotFound" class with a default error message of "Resource not found".
+     */
+    constructor() {
+        super('Resource not found');
+        /**
+         * HTTP status code for the "Resource Not Found" error.
+         */
+        this.statusCode = enums_1.StatusCodes.NOT_FOUND;
+        Object.setPrototypeOf(this, ResourceNotFound.prototype);
+    }
+    /**
+     * Serializes the error to be sent as a response to the client.
+     *
+     * The "serializeErrors" method returns an array containing an object with the error message for the "Resource Not Found" error.
+     * Subclasses can override this method to provide custom error serialization.
+     *
+     * @returns An array containing an object with the error message for the "Resource Not Found" error.
+     */
+    serializeErrors() {
+        return [{ message: 'Resource Not Found' }];
+    }
+}
+exports.ResourceNotFound = ResourceNotFound;

package/build/errors/too-many-request-error.d.ts

@@ -0,0 +1,33 @@
+import { CustomError } from './custom-error';
+/**
+ * Custom error class representing a "Too Many Requests" error.
+ *
+ * The "TooManyRequestError" class extends the base "CustomError" class to handle errors related to receiving too many requests from a client within a specific time frame.
+ * It sets the HTTP status code to 429 (TOO_MANY_REQUESTS) and provides a default error message of "Too Many Requests".
+ * The class also includes a `retrySec` property to specify the number of seconds after which the client can retry the request.
+ * Subclasses can customize the error message or additional fields as needed by overriding the "serializeErrors" method.
+ */
+export declare class TooManyRequestError extends CustomError {
+    retrySec: string;
+    /**
+     * HTTP status code for the "Too Many Requests" error.
+     */
+    statusCode: number;
+    /**
+     * Creates a new instance of the "TooManyRequestError" class with a default error message of "Too Many Requests".
+     *
+     * @param retrySec The number of seconds after which the client can retry the request.
+     */
+    constructor(retrySec: string);
+    /**
+     * Serializes the error to be sent as a response to the client.
+     *
+     * The "serializeErrors" method returns an array containing an object with the error message for the "Too Many Requests" error.
+     * Subclasses can override this method to provide custom error serialization.
+     *
+     * @returns An array containing an object with the error message for the "Too Many Requests" error.
+     */
+    serializeErrors(): {
+        message: string;
+    }[];
+}

package/build/errors/too-many-request-error.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TooManyRequestError = void 0;
+const enums_1 = require("../utils/enums");
+const custom_error_1 = require("./custom-error");
+/**
+ * Custom error class representing a "Too Many Requests" error.
+ *
+ * The "TooManyRequestError" class extends the base "CustomError" class to handle errors related to receiving too many requests from a client within a specific time frame.
+ * It sets the HTTP status code to 429 (TOO_MANY_REQUESTS) and provides a default error message of "Too Many Requests".
+ * The class also includes a `retrySec` property to specify the number of seconds after which the client can retry the request.
+ * Subclasses can customize the error message or additional fields as needed by overriding the "serializeErrors" method.
+ */
+class TooManyRequestError extends custom_error_1.CustomError {
+    /**
+     * Creates a new instance of the "TooManyRequestError" class with a default error message of "Too Many Requests".
+     *
+     * @param retrySec The number of seconds after which the client can retry the request.
+     */
+    constructor(retrySec) {
+        super('Too Many Requests');
+        this.retrySec = retrySec;
+        /**
+         * HTTP status code for the "Too Many Requests" error.
+         */
+        this.statusCode = enums_1.StatusCodes.TOO_MANY_REQUEST;
+        Object.setPrototypeOf(this, TooManyRequestError.prototype);
+    }
+    /**
+     * Serializes the error to be sent as a response to the client.
+     *
+     * The "serializeErrors" method returns an array containing an object with the error message for the "Too Many Requests" error.
+     * Subclasses can override this method to provide custom error serialization.
+     *
+     * @returns An array containing an object with the error message for the "Too Many Requests" error.
+     */
+    serializeErrors() {
+        return [
+            { message: `Too Many Requests. Try again later` }
+        ];
+    }
+}
+exports.TooManyRequestError = TooManyRequestError;

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

@@ -1,6 +1,8 @@
 import { NatsConnection, ConsumerConfig, JsMsg } from "nats";
-import { DurableName, Subjects, Streams } from "../common/enums";
 import { MainSubjects, ValidateSubjectFormat } from "../common/enums/subjects/main-subjects";
+import { Subjects } from '../common/enums/subjects';
+import { DurableName } from '../common/enums/durable-names';
+import { Streams } from '../common/enums/streams';
 /**
  * Interface representing an event published to NATS.
  */

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

@@ -1,6 +1,6 @@
 import { PubAck, NatsConnection } from "nats";
-import { Subjects } from "../common/enums";
 import { MainSubjects, ValidateSubjectFormat } from "../common/enums/subjects/main-subjects";
+import { Subjects } from '../common/enums/subjects';
 /**
  * Interface representing an event to be published to NATS.
  */

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

@@ -1,6 +1,6 @@
 import { NatsConnection } from "nats";
-import { Streams } from "../common/enums";
 import { MainSubjects } from "../common/enums/subjects/main-subjects";
+import { Streams } from '../common/enums/streams';
 /**
  * Interface representing an event to be used with NATS streams.
  */

package/build/index.d.ts

@@ -1,5 +1,173 @@
-export * from "./connections-wrappers";
-export * from "./errors";
-export * from "./middlewares";
-export * from "./utils";
-export * from "./events";
+/**
+ * Re-exports all the contents from the "redis-connection-wrapper" module.
+ *
+ * The "redis-connection-wrapper" module contains a class that wraps the Redis client connection and provides easy access to the Redis client instance.
+ * It also includes error handling and connection management features.
+ */
+export * from "./connections-wrappers/redis-connection-wrapper";
+/**
+ * Re-exports all the contents from the "socket-connection-wrapper" module.
+ *
+ * The "socket-connection-wrapper" module contains a class that wraps the Socket.IO server connection and provides easy access to the Socket.IO server instance.
+ * It includes error handling and connection management features for Socket.IO server connections.
+ */
+export * from "./connections-wrappers/socket-connection-wrapper";
+/**
+ * Re-exports all the contents from the "nats-wrapper" module.
+ *
+ * The "nats-wrapper" module contains a class that wraps the NATS (NATS Streaming Server) client connection and provides easy access to the NATS client instance.
+ * It includes error handling and connection management features for NATS client connections.
+ */
+export * from "./connections-wrappers/nats-wrapper";
+/**
+ * Re-exports the "BadRequestError" class from the "bad-request-error" file.
+ *
+ * The "BadRequestError" class represents a specific "Bad Request" error and is used to handle client requests with invalid or malformed data.
+ */
+export * from "./errors/bad-request-error";
+/**
+ * Re-exports the "CustomError" abstract class from the "custom-error" file.
+ *
+ * The "CustomError" abstract class serves as the foundation for creating specific error classes for different types of errors.
+ */
+export * from "./errors/custom-error";
+/**
+ * Re-exports the "DatabaseError" class from the "database-error" file.
+ *
+ * The "DatabaseError" class represents a specific error related to database operations or connectivity issues.
+ */
+export * from "./errors/database-error";
+/**
+ * Re-exports the "NotFoundError" class from the "not-found-error" file.
+ *
+ * The "NotFoundError" class represents a specific "Not Found" error and is used when a requested resource is not found.
+ */
+export * from "./errors/not-found-error";
+/**
+ * Re-exports the "SystemError" class from the "system-error" file.
+ *
+ * The "SystemError" class represents a specific "System Error" that can occur due to unexpected issues in the system.
+ */
+export * from "./errors/system-error";
+export * from "./errors/too-many-request-error";
+export * from "./errors/resource-not-found";
+export * from "./errors/not-authorized-error";
+/**
+ * Re-exports the "currentUser" middleware from the "current-user" module.
+ *
+ * The "currentUser" middleware is used to extract and verify the current user's information from the request headers.
+ * It checks for a valid bearer token in the "Authorization" header, verifies the JWT token, and attaches the user payload to the request object for further processing in subsequent middleware or route handlers.
+ */
+export * from "./middlewares/current-user";
+/**
+ * Re-exports the "errorHandler" middleware from the "error-handler" module.
+ *
+ * The "errorHandler" middleware is a custom error-handling middleware used to handle and respond to errors that occur during request processing.
+ * It intercepts any uncaught errors in the application, such as custom errors or other exceptions, and sends appropriate error responses to the client.
+ * If the error is a custom error (e.g., BadRequestError, NotFoundError, DatabaseError, etc.), the middleware serializes the error and sends it with the corresponding status code and error messages.
+ * If the error is not a custom error, a generic error response is sent with a 500 status code and a default error message.
+ */
+export * from "./middlewares/error-handler";
+export * from "./middlewares/is-allowed";
+export * from "./middlewares/validate-body";
+export * from "./middlewares/require-auth";
+/**
+ *? Re-exports all the enums from the "enums" module.
+ *
+ * The "enums" module contains various enumerations used in the application.
+ * Enumerations are used to define named constant values, such as status codes, subject names, or stream names.
+ */
+export * from "./utils/enums";
+/**
+ *? Re-exports all the functions related to reading directories from the "read-dir" module.
+ *
+ * The "read-dir" module contains utility functions to read and access files and directories in the application.
+ * These functions are used for dynamic loading, configuration, and other file-related operations.
+ */
+export * from "./utils/read-dir";
+export * from "./utils/schemas";
+/**
+ *? Re-exports all the contents from the "base-producers" module.
+ *
+ * The "base-producers" module contains base classes and utilities for implementing job producers in the application.
+ * Job producers are responsible for generating and queuing jobs to be processed by job workers.
+ */
+export * from "./utils/base_classes/jobs/base-producers";
+/**
+ *? Re-exports all the contents from the "base-worker" module.
+ *
+ * The "base-worker" module contains base classes and utilities for implementing job workers in the application.
+ * Job workers are responsible for processing jobs generated by job producers and executing the required tasks.
+ */
+export * from "./utils/base_classes/jobs/base-worker";
+/**
+ *? Re-exports all the contents from the "base-namespace" module.
+ *
+ * The "base-namespace" module contains base classes and utilities for implementing custom namespaces in the application.
+ * Custom namespaces provide separate channels for communication between connected clients and the server, allowing for organized event handling within separate contexts.
+ */
+export * from "./utils/base_classes/listeners/base-namespace";
+/**
+ *? Re-exports the "BaseConsumer" class from the "base-consumer" file.
+ *
+ * The "BaseConsumer" class serves as a base class for implementing event consumers.
+ * It provides common functionality and methods that can be extended by specific consumer implementations.
+ */
+export * from "./events/base/base-consumer";
+/**
+ * Re-exports the "BasePublisher" class from the "base-publisher" file.
+ *
+ * The "BasePublisher" class serves as a base class for implementing event publishers.
+ * It provides common functionality and methods that can be extended by specific publisher implementations.
+ */
+export * from "./events/base/base-publisher";
+/**
+ * Re-exports the "BaseStream" class from the "base-stream" file.
+ *
+ * The "BaseStream" class serves as a base class for implementing event streams.
+ * It provides common functionality and methods that can be extended by specific stream implementations.
+ */
+export * from "./events/base/base-stream";
+/**
+ * Re-exports the "OrderCancelledEvent" class from the "order-cancelled-event" file.
+ *
+ * The "OrderCancelledEvent" class represents an event related to the cancellation of an order.
+ */
+export * from "./events/common/interfaces/order-events-interfaces/order-cancelled-event";
+/**
+ * Re-exports the "OrderCompletedEvent" class from the "order-completed-event" file.
+ *
+ * The "OrderCompletedEvent" class represents an event related to the completion of an order.
+ */
+export * from "./events/common/interfaces/order-events-interfaces/order-completed-event";
+/**
+ * Re-exports the "OrderRequestedEvent" class from the "order-requested-event" file.
+ *
+ * The "OrderRequestedEvent" class represents an event related to a request for an order.
+ */
+export * from "./events/common/interfaces/order-events-interfaces/order-requested-event";
+/**
+ * Re-exports all the interfaces related to streams from the "stream-interfaces" file.
+ *
+ * The "stream-interfaces" file contains interfaces for various streams used in the application.
+ * For example, "OrderStreamEvent" represents an event associated with the "Order" stream.
+ */
+export * from "./events/common/interfaces/stream-interfaces/order-stream-interface";
+/**
+ * Re-exports all the types related to durable names from the "durable-names" file.
+ *
+ * The types include enums and utility types used to define durable names for consumers of different event types.
+ */
+export * from "./events/common/enums/durable-names";
+/**
+ * Re-exports the type related to streams from the "streams" file.
+ *
+ * The "Streams" type alias represents a JetStream stream that can handle different event types.
+ */
+export * from "./events/common/enums/streams";
+/**
+ * Re-exports the type related to subjects from the "subjects" file.
+ *
+ * The "Subjects" type alias represents the subjects for different event types.
+ */
+export * from "./events/common/enums/subjects";

package/build/index.js

@@ -1,4 +1,5 @@
 "use strict";
+//* Import and re-export multiple modules related to connection wrappers.
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     var desc = Object.getOwnPropertyDescriptor(m, k);
@@ -14,8 +15,191 @@ 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 });
-__exportStar(require("./connections-wrappers"), exports);
-__exportStar(require("./errors"), exports);
-__exportStar(require("./middlewares"), exports);
-__exportStar(require("./utils"), exports);
-__exportStar(require("./events"), exports);
+/**
+ * Re-exports all the contents from the "redis-connection-wrapper" module.
+ *
+ * The "redis-connection-wrapper" module contains a class that wraps the Redis client connection and provides easy access to the Redis client instance.
+ * It also includes error handling and connection management features.
+ */
+__exportStar(require("./connections-wrappers/redis-connection-wrapper"), exports);
+/**
+ * Re-exports all the contents from the "socket-connection-wrapper" module.
+ *
+ * The "socket-connection-wrapper" module contains a class that wraps the Socket.IO server connection and provides easy access to the Socket.IO server instance.
+ * It includes error handling and connection management features for Socket.IO server connections.
+ */
+__exportStar(require("./connections-wrappers/socket-connection-wrapper"), exports);
+/**
+ * Re-exports all the contents from the "nats-wrapper" module.
+ *
+ * The "nats-wrapper" module contains a class that wraps the NATS (NATS Streaming Server) client connection and provides easy access to the NATS client instance.
+ * It includes error handling and connection management features for NATS client connections.
+ */
+__exportStar(require("./connections-wrappers/nats-wrapper"), exports);
+//* Import and re-export custom error classes for easier access.
+/**
+ * Re-exports the "BadRequestError" class from the "bad-request-error" file.
+ *
+ * The "BadRequestError" class represents a specific "Bad Request" error and is used to handle client requests with invalid or malformed data.
+ */
+__exportStar(require("./errors/bad-request-error"), exports);
+/**
+ * Re-exports the "CustomError" abstract class from the "custom-error" file.
+ *
+ * The "CustomError" abstract class serves as the foundation for creating specific error classes for different types of errors.
+ */
+__exportStar(require("./errors/custom-error"), exports);
+/**
+ * Re-exports the "DatabaseError" class from the "database-error" file.
+ *
+ * The "DatabaseError" class represents a specific error related to database operations or connectivity issues.
+ */
+__exportStar(require("./errors/database-error"), exports);
+/**
+ * Re-exports the "NotFoundError" class from the "not-found-error" file.
+ *
+ * The "NotFoundError" class represents a specific "Not Found" error and is used when a requested resource is not found.
+ */
+__exportStar(require("./errors/not-found-error"), exports);
+/**
+ * Re-exports the "SystemError" class from the "system-error" file.
+ *
+ * The "SystemError" class represents a specific "System Error" that can occur due to unexpected issues in the system.
+ */
+__exportStar(require("./errors/system-error"), exports);
+//TODO: DOCUMENT
+__exportStar(require("./errors/too-many-request-error"), exports);
+//TODO: DOCUMENT
+__exportStar(require("./errors/resource-not-found"), exports);
+//TODO: DOCUMENT
+__exportStar(require("./errors/not-authorized-error"), exports);
+//* Import and re-export multiple middleware modules.
+/**
+ * Re-exports the "currentUser" middleware from the "current-user" module.
+ *
+ * The "currentUser" middleware is used to extract and verify the current user's information from the request headers.
+ * It checks for a valid bearer token in the "Authorization" header, verifies the JWT token, and attaches the user payload to the request object for further processing in subsequent middleware or route handlers.
+ */
+__exportStar(require("./middlewares/current-user"), exports);
+/**
+ * Re-exports the "errorHandler" middleware from the "error-handler" module.
+ *
+ * The "errorHandler" middleware is a custom error-handling middleware used to handle and respond to errors that occur during request processing.
+ * It intercepts any uncaught errors in the application, such as custom errors or other exceptions, and sends appropriate error responses to the client.
+ * If the error is a custom error (e.g., BadRequestError, NotFoundError, DatabaseError, etc.), the middleware serializes the error and sends it with the corresponding status code and error messages.
+ * If the error is not a custom error, a generic error response is sent with a 500 status code and a default error message.
+ */
+__exportStar(require("./middlewares/error-handler"), exports);
+//TODO: DOCUMENT
+__exportStar(require("./middlewares/is-allowed"), exports);
+//TODO: DOCUMENT
+__exportStar(require("./middlewares/validate-body"), exports);
+//TODO: DOCUMENT
+__exportStar(require("./middlewares/require-auth"), exports);
+//* Import and re-export multiple modules for enums, base classes, and read-dir functionality.
+/**
+ *? Re-exports all the enums from the "enums" module.
+ *
+ * The "enums" module contains various enumerations used in the application.
+ * Enumerations are used to define named constant values, such as status codes, subject names, or stream names.
+ */
+__exportStar(require("./utils/enums"), exports);
+/**
+ *? Re-exports all the functions related to reading directories from the "read-dir" module.
+ *
+ * The "read-dir" module contains utility functions to read and access files and directories in the application.
+ * These functions are used for dynamic loading, configuration, and other file-related operations.
+ */
+__exportStar(require("./utils/read-dir"), exports);
+//TODO: DOCUMENT
+__exportStar(require("./utils/schemas"), exports);
+/**
+ *? Re-exports all the contents from the "base-producers" module.
+ *
+ * The "base-producers" module contains base classes and utilities for implementing job producers in the application.
+ * Job producers are responsible for generating and queuing jobs to be processed by job workers.
+ */
+__exportStar(require("./utils/base_classes/jobs/base-producers"), exports);
+/**
+ *? Re-exports all the contents from the "base-worker" module.
+ *
+ * The "base-worker" module contains base classes and utilities for implementing job workers in the application.
+ * Job workers are responsible for processing jobs generated by job producers and executing the required tasks.
+ */
+__exportStar(require("./utils/base_classes/jobs/base-worker"), exports);
+/**
+ *? Re-exports all the contents from the "base-namespace" module.
+ *
+ * The "base-namespace" module contains base classes and utilities for implementing custom namespaces in the application.
+ * Custom namespaces provide separate channels for communication between connected clients and the server, allowing for organized event handling within separate contexts.
+ */
+__exportStar(require("./utils/base_classes/listeners/base-namespace"), exports);
+//* Import and re-export base classes for consumers, publishers, and streams.
+/**
+ *? Re-exports the "BaseConsumer" class from the "base-consumer" file.
+ *
+ * The "BaseConsumer" class serves as a base class for implementing event consumers.
+ * It provides common functionality and methods that can be extended by specific consumer implementations.
+ */
+__exportStar(require("./events/base/base-consumer"), exports);
+/**
+ * Re-exports the "BasePublisher" class from the "base-publisher" file.
+ *
+ * The "BasePublisher" class serves as a base class for implementing event publishers.
+ * It provides common functionality and methods that can be extended by specific publisher implementations.
+ */
+__exportStar(require("./events/base/base-publisher"), exports);
+/**
+ * Re-exports the "BaseStream" class from the "base-stream" file.
+ *
+ * The "BaseStream" class serves as a base class for implementing event streams.
+ * It provides common functionality and methods that can be extended by specific stream implementations.
+ */
+__exportStar(require("./events/base/base-stream"), exports);
+//* Import and re-export multiple interfaces related to different events and streams.
+/**
+ * Re-exports the "OrderCancelledEvent" class from the "order-cancelled-event" file.
+ *
+ * The "OrderCancelledEvent" class represents an event related to the cancellation of an order.
+ */
+__exportStar(require("./events/common/interfaces/order-events-interfaces/order-cancelled-event"), exports);
+/**
+ * Re-exports the "OrderCompletedEvent" class from the "order-completed-event" file.
+ *
+ * The "OrderCompletedEvent" class represents an event related to the completion of an order.
+ */
+__exportStar(require("./events/common/interfaces/order-events-interfaces/order-completed-event"), exports);
+/**
+ * Re-exports the "OrderRequestedEvent" class from the "order-requested-event" file.
+ *
+ * The "OrderRequestedEvent" class represents an event related to a request for an order.
+ */
+__exportStar(require("./events/common/interfaces/order-events-interfaces/order-requested-event"), exports);
+//! Interfaces related to payment events are currently commented out using '//'.
+// export * from "./payment-event-interfaces";
+/**
+ * Re-exports all the interfaces related to streams from the "stream-interfaces" file.
+ *
+ * The "stream-interfaces" file contains interfaces for various streams used in the application.
+ * For example, "OrderStreamEvent" represents an event associated with the "Order" stream.
+ */
+__exportStar(require("./events/common/interfaces/stream-interfaces/order-stream-interface"), exports);
+//* Import and re-export types from other files in events enums for easier access.
+/**
+ * Re-exports all the types related to durable names from the "durable-names" file.
+ *
+ * The types include enums and utility types used to define durable names for consumers of different event types.
+ */
+__exportStar(require("./events/common/enums/durable-names"), exports);
+/**
+ * Re-exports the type related to streams from the "streams" file.
+ *
+ * The "Streams" type alias represents a JetStream stream that can handle different event types.
+ */
+__exportStar(require("./events/common/enums/streams"), exports);
+/**
+ * Re-exports the type related to subjects from the "subjects" file.
+ *
+ * The "Subjects" type alias represents the subjects for different event types.
+ */
+__exportStar(require("./events/common/enums/subjects"), exports);

package/build/middlewares/current-user.js

@@ -64,7 +64,6 @@ const currentUser = (req, res, next) => __awaiter(void 0, void 0, void 0, functi
             // If the token is expired, you may consider refreshing the token or taking appropriate actions.
             // Uncomment the following line if you want to handle token expiration using the AuthController.
             // await AuthController.refreshToken(req, res);
-            // await AuthController.refreshToken(req, res)
         }
         else {
             // If any other error occurs during token verification, set currentUser to null.

package/build/middlewares/error-handler.js

@@ -15,8 +15,6 @@ const errorHandler = (err, req, res, next) => {
     if (err instanceof custom_error_1.CustomError) {
         return res.status(err.statusCode).send({ errors: err.serializeErrors() });
     }
-    res
-        .status(enums_1.StatusCodes.BAD_REQUEST)
-        .send({ errors: [{ message: "Something went wrong" }] });
+    res.status(enums_1.StatusCodes.BAD_REQUEST).send({ errors: [{ message: "Something went wrong" }] });
 };
 exports.errorHandler = errorHandler;

package/build/middlewares/is-allowed.d.ts

@@ -0,0 +1,24 @@
+import { Request, Response, NextFunction } from "express";
+/**
+ * Middleware to check if a user is allowed to perform a specific action on a resource based on their role and permissions.
+ * If the user is not authorized, it throws a NotAuthorizedError to indicate access denied.
+ *
+ * @param req - The Express request object.
+ * @param res - The Express response object.
+ * @param next - The next middleware function.
+ * @param hasVersion - Set to true if the API path includes the version (e.g., /api/v1/...). Default is false.
+ *
+ * @throws BadRequestError - If the action is not supported or if the session has expired.
+ * @throws ResourceNotFound - If the requested resource is not found.
+ * @throws NotAuthorizedError - If the user is not authorized to perform the action on the resource.
+ *
+ * @example
+ * ```js
+ * // Route that requires authorization based on user role and permissions
+ * router.get("/resource/:id", isAllowed, (req, res) => {
+ *   // Only authorized users with the appropriate permissions can access this route
+ *   res.send("You are authorized!");
+ * });
+ * ```
+ */
+export declare const isAllowed: (req: Request, res: Response, next: NextFunction, hasVersion?: boolean) => void;

package/build/middlewares/is-allowed.js

@@ -0,0 +1,71 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isAllowed = void 0;
+const accesscontrol_1 = __importDefault(require("@vsky/accesscontrol"));
+const resource_not_found_1 = require("../errors/resource-not-found");
+const not_authorized_error_1 = require("../errors/not-authorized-error");
+const bad_request_error_1 = require("../errors/bad-request-error");
+// Mapping object for HTTP method to action
+const methodToAction = {
+    GET: "view",
+    POST: "create",
+    DELETE: "delete",
+    PUT: "update",
+    PATCH: "update",
+};
+/**
+ * Middleware to check if a user is allowed to perform a specific action on a resource based on their role and permissions.
+ * If the user is not authorized, it throws a NotAuthorizedError to indicate access denied.
+ *
+ * @param req - The Express request object.
+ * @param res - The Express response object.
+ * @param next - The next middleware function.
+ * @param hasVersion - Set to true if the API path includes the version (e.g., /api/v1/...). Default is false.
+ *
+ * @throws BadRequestError - If the action is not supported or if the session has expired.
+ * @throws ResourceNotFound - If the requested resource is not found.
+ * @throws NotAuthorizedError - If the user is not authorized to perform the action on the resource.
+ *
+ * @example
+ * ```js
+ * // Route that requires authorization based on user role and permissions
+ * router.get("/resource/:id", isAllowed, (req, res) => {
+ *   // Only authorized users with the appropriate permissions can access this route
+ *   res.send("You are authorized!");
+ * });
+ * ```
+ */
+const isAllowed = (req, res, next, hasVersion = false) => {
+    var _a, _b;
+    let STABLEVERSION = `${process.env.STABLE_VERSION}`;
+    if (!STABLEVERSION) {
+        STABLEVERSION = "v1";
+    }
+    // Regular expression to match the route path and extract the resource
+    const regexString = `^\\/api\\/${hasVersion ? `${STABLEVERSION}\\/` : ""}(\\w+)(\\/.*)?$`;
+    const regex = new RegExp(regexString);
+    const path = req.originalUrl;
+    const match = path.match(regex);
+    const resource = match && match[1];
+    // Determine the action based on the HTTP method
+    const action = methodToAction[req.method.toUpperCase()];
+    if (!action) {
+        throw new bad_request_error_1.BadRequestError("Session expired. Please relogin.");
+    }
+    if (!resource) {
+        throw new resource_not_found_1.ResourceNotFound();
+    }
+    // Get the roles and role of the current user from the session
+    const roles = ((_a = req.currentUser) === null || _a === void 0 ? void 0 : _a.role_permission) || [];
+    const role = (_b = req.currentUser) === null || _b === void 0 ? void 0 : _b.role;
+    // Check if the user can perform the action on the resource
+    const canPerform = new accesscontrol_1.default(roles).canPerformAction(role, resource, action);
+    if (!canPerform) {
+        throw new not_authorized_error_1.NotAuthorizedError();
+    }
+    next();
+};
+exports.isAllowed = isAllowed;

package/build/middlewares/require-auth.d.ts

@@ -0,0 +1,18 @@
+import { Request, Response, NextFunction } from 'express';
+/**
+ * Middleware to check if a user is authenticated before allowing access to certain routes.
+ * If the user is not authenticated, it throws a NotAuthorizedError to indicate access denied.
+ * @param req The Express request object.
+ * @param res The Express response object.
+ * @param next The next middleware function.
+ * @throws NotAuthorizedError if the user is not authenticated.
+ * @example
+*    ```js
+  // Route that requires authentication
+  router.get('/protected', requireAuth, (req, res) => {
+    // Only authenticated users can access this route
+    res.send('You are authorized!');
+  });
+* ```
+ */
+export declare const requireAuth: (req: Request, res: Response, next: NextFunction) => void;

package/build/middlewares/require-auth.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.requireAuth = void 0;
+const not_authorized_error_1 = require("../errors/not-authorized-error");
+/**
+ * Middleware to check if a user is authenticated before allowing access to certain routes.
+ * If the user is not authenticated, it throws a NotAuthorizedError to indicate access denied.
+ * @param req The Express request object.
+ * @param res The Express response object.
+ * @param next The next middleware function.
+ * @throws NotAuthorizedError if the user is not authenticated.
+ * @example
+*    ```js
+  // Route that requires authentication
+  router.get('/protected', requireAuth, (req, res) => {
+    // Only authenticated users can access this route
+    res.send('You are authorized!');
+  });
+* ```
+ */
+const requireAuth = (req, res, next) => {
+    if (!req.currentUser) {
+        throw new not_authorized_error_1.NotAuthorizedError();
+    }
+    next();
+};
+exports.requireAuth = requireAuth;

package/build/middlewares/validate-body.d.ts

@@ -0,0 +1,57 @@
+import { Request, Response, NextFunction } from "express";
+/**
+ * Represents the required fields for each HTTP method.
+ * MethodRequiredProps is a mapping between HTTP methods ("POST", "DELETE", "PATCH", "PUT", "GET")
+ * and an object containing an array of required fields for that method.
+ */
+type MethodRequiredProps = {
+    [key in "POST" | "DELETE" | "PATCH" | "PUT" | "GET"]: {
+        required: string[];
+    };
+};
+/**
+ * Represents the schema for validating request body parameters.
+ * - `fields`: An object mapping each parameter name to its expected type.
+ * - `required`: An optional array of parameter names that are required in the request body.
+ * - `optional`: An optional array of parameter names that are allowed but not required in the request body.
+ */
+export type Schema = {
+    fields: {
+        [key: string]: string;
+    };
+    required?: string[] | MethodRequiredProps;
+    optional?: string[];
+};
+/**
+ * Class providing request body validation middleware.
+ */
+export declare class RequestValidator {
+    private model;
+    /**
+     * Constructor for the RequestValidator class.
+     * @param model The schema defining the expected fields and types in the request body.
+     */
+    constructor(model: Schema);
+    /**
+     * Private method to validate required fields in the request body.
+     * @param obj The request body object.
+     * @param required The required fields or required fields for specific HTTP methods.
+     * @param method The HTTP method of the request.
+     * @returns An object containing the validation status and the element that caused the validation failure (if any).
+     */
+    private required;
+    /**
+     * Private method to check if the fields in the request body match the defined schema.
+     * @param obj The request body object.
+     */
+    private check;
+    /**
+     * Middleware function to validate the request body against the provided schema.
+     * @param req The Express request object.
+     * @param res The Express response object.
+     * @param next The next middleware function.
+     * @throws BadRequestError if any validation fails.
+     */
+    validateReqBody: (req: Request, res: Response, next: NextFunction) => Promise<void>;
+}
+export {};

package/build/middlewares/validate-body.js

@@ -0,0 +1,102 @@
+"use strict";
+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.RequestValidator = void 0;
+const bad_request_error_1 = require("../errors/bad-request-error");
+/**
+ * Class providing request body validation middleware.
+ */
+class RequestValidator {
+    /**
+     * Constructor for the RequestValidator class.
+     * @param model The schema defining the expected fields and types in the request body.
+     */
+    constructor(model) {
+        /**
+         * Middleware function to validate the request body against the provided schema.
+         * @param req The Express request object.
+         * @param res The Express response object.
+         * @param next The next middleware function.
+         * @throws BadRequestError if any validation fails.
+         */
+        this.validateReqBody = (req, res, next) => __awaiter(this, void 0, void 0, function* () {
+            const paramsLength = Object.keys(req.params).length;
+            const bodyLength = Object.keys(req.body).length;
+            const method = req.method;
+            const methods = ["POST", "PUT", "DELETE", "PATCH", "GET"];
+            const obj = paramsLength > 0 && bodyLength > 0 ? Object.assign(Object.assign({}, req.params), req.body) : bodyLength > 0 ? req.body : req.params;
+            if (methods.includes(method)) {
+                if (this.model.required) {
+                    const { status, element } = this.required(obj, this.model.required, method);
+                    if (!status) {
+                        throw new bad_request_error_1.BadRequestError(`Required field: ${element}`);
+                    }
+                }
+            }
+            if (!obj.multiadd) {
+                this.check(obj);
+            }
+            else {
+                for (const element of obj.multiadd) {
+                    this.check(element);
+                }
+            }
+            next();
+        });
+        this.model = model;
+    }
+    /**
+     * Private method to validate required fields in the request body.
+     * @param obj The request body object.
+     * @param required The required fields or required fields for specific HTTP methods.
+     * @param method The HTTP method of the request.
+     * @returns An object containing the validation status and the element that caused the validation failure (if any).
+     */
+    required(obj, required, method) {
+        const isArray = Array.isArray(required);
+        if (!obj.multiadd) {
+            const data = !isArray ? required[method]['required'] : required;
+            for (const requiredKey of data) {
+                if (!obj[requiredKey] || (typeof obj[requiredKey] === 'string' && !obj[requiredKey].trim())) {
+                    return { status: false, element: requiredKey };
+                }
+            }
+        }
+        else {
+            if (isArray) {
+                for (const requiredKey of required) {
+                    for (const element of obj.multiadd) {
+                        if (!element[requiredKey]) {
+                            return { status: false, element: requiredKey };
+                        }
+                    }
+                }
+            }
+        }
+        return { status: true, element: '' };
+    }
+    /**
+     * Private method to check if the fields in the request body match the defined schema.
+     * @param obj The request body object.
+     */
+    check(obj) {
+        var _a, _b;
+        for (const key of Object.keys(obj)) {
+            if (!this.model.fields[key] && !((_a = this.model.optional) === null || _a === void 0 ? void 0 : _a.includes(key))) {
+                throw new bad_request_error_1.BadRequestError(`Invalid parameter: ${key}`);
+            }
+            if (typeof obj[key] !== this.model.fields[key] && !((_b = this.model.optional) === null || _b === void 0 ? void 0 : _b.includes(key))) {
+                throw new bad_request_error_1.BadRequestError(`Parameter type mismatch: ${key}`);
+            }
+        }
+    }
+}
+exports.RequestValidator = RequestValidator;

package/build/utils/base_classes/jobs/base-producers.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AbstractJobQueue = void 0;
 const bullmq_1 = require("bullmq");
-const connections_wrappers_1 = require("../../../connections-wrappers");
+const redis_connection_wrapper_1 = require("../../../connections-wrappers/redis-connection-wrapper");
 /**
  * Abstract class representing a Job Queue.
  */
@@ -14,7 +14,7 @@ class AbstractJobQueue {
      */
     constructor(queueName) {
         // Initialize the job queue with the provided name and a Redis connection from the redisWrapper.
-        this.que = new bullmq_1.Queue(queueName, { connection: connections_wrappers_1.redisWrapper.client });
+        this.que = new bullmq_1.Queue(queueName, { connection: redis_connection_wrapper_1.redisWrapper.client });
     }
 }
 exports.AbstractJobQueue = AbstractJobQueue;

package/build/utils/base_classes/jobs/base-worker.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AbstractWorker = void 0;
 const bullmq_1 = require("bullmq");
-const connections_wrappers_1 = require("../../../connections-wrappers");
+const redis_connection_wrapper_1 = require("../../../connections-wrappers/redis-connection-wrapper");
 /**
  * Abstract class representing a worker for processing jobs from a Job Queue.
  */
@@ -15,7 +15,7 @@ class AbstractWorker {
     constructor(queueName) {
         // Create a worker instance with the provided queueName and bind the 'process' method to this worker.
         this.worker = new bullmq_1.Worker(queueName, this.process.bind(this), {
-            connection: connections_wrappers_1.redisWrapper.client,
+            connection: redis_connection_wrapper_1.redisWrapper.client,
             autorun: false,
         });
         // Handle errors that may occur during job processing.

package/build/utils/schemas.d.ts

@@ -0,0 +1,11 @@
+import { Schema } from '../middlewares/validate-body';
+export declare const RegisterSchema: Schema;
+export declare const SigninSchema: Schema;
+export declare const BranchSchema: Schema;
+export declare const DenominationSchema: Schema;
+export declare const CategorySchema: Schema;
+export declare const WardSchema: Schema;
+export declare const UserTypeSchema: Schema;
+export declare const DelegateSchema: Schema;
+export declare const CandidateSchema: Schema;
+export declare const UserSchema: Schema;

package/build/utils/schemas.js

@@ -0,0 +1,162 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UserSchema = exports.CandidateSchema = exports.DelegateSchema = exports.UserTypeSchema = exports.WardSchema = exports.CategorySchema = exports.DenominationSchema = exports.BranchSchema = exports.SigninSchema = exports.RegisterSchema = void 0;
+exports.RegisterSchema = {
+    fields: {
+        user_name: 'string',
+        user_type: 'string',
+        password: 'string',
+        email: 'string',
+        contact: 'string',
+        address: 'string',
+    },
+    required: ['user_name', 'user_type', 'password']
+};
+exports.SigninSchema = {
+    fields: {
+        password: 'string',
+        user_name: 'string',
+    },
+    required: ['password', 'user_name']
+};
+exports.BranchSchema = {
+    fields: {
+        id: 'string',
+        name: 'string',
+        ward_id: 'string',
+        include: 'string',
+        code: 'string',
+        status: 'boolean',
+    },
+    required: {
+        'POST': { required: ['name', 'status', 'ward_id', 'code'] },
+        'PUT': { required: ['id', 'ward_id'] },
+        'PATCH': { required: [] },
+        'DELETE': { required: ['id'] },
+        'GET': { required: ['id'] },
+    },
+    optional: ['include', 'ward_id']
+};
+exports.DenominationSchema = {
+    fields: {
+        id: 'string',
+        include: 'string',
+        name: 'string',
+        status: 'boolean',
+    },
+    required: {
+        'POST': { required: ['name', 'status'] },
+        'PUT': { required: ['id'] },
+        'PATCH': { required: [] },
+        'DELETE': { required: ['id'] },
+        'GET': { required: ['id'] },
+    },
+    optional: ['include']
+};
+exports.CategorySchema = {
+    fields: {
+        id: 'string',
+        name: 'string',
+        status: 'boolean',
+    },
+    required: {
+        'POST': { required: ['name', 'status'] },
+        'PUT': { required: ['id'] },
+        'PATCH': { required: [] },
+        'DELETE': { required: ['id'] },
+        'GET': { required: ['id'] },
+    }
+};
+exports.WardSchema = {
+    fields: {
+        id: 'string',
+        name: 'string',
+        status: 'boolean',
+    },
+    required: {
+        'POST': { required: ['name', 'status'] },
+        'PUT': { required: ['id'] },
+        'PATCH': { required: [] },
+        'DELETE': { required: ['id'] },
+        'GET': { required: ['id'] },
+    }
+};
+exports.UserTypeSchema = {
+    fields: {
+        id: 'string',
+        name: 'string',
+        status: 'boolean',
+    },
+    required: {
+        'POST': { required: ['name', 'status'] },
+        'PUT': { required: ['id'] },
+        'PATCH': { required: [] },
+        'DELETE': { required: ['id'] },
+        'GET': { required: ['id'] },
+    }
+};
+exports.DelegateSchema = {
+    fields: {
+        id: 'string',
+        include: 'string',
+        name: 'string',
+        position: 'string',
+        voter_id_nnumber: 'string',
+        membership_number: 'string',
+        contact: 'string',
+        denomination_id: 'string',
+        status: 'boolean',
+        branch_id: 'string',
+        category_id: 'string',
+        is_potential_for: 'string',
+        multi_update: 'boolean'
+    },
+    required: {
+        'POST': { required: ['name', 'status', 'category_id'] },
+        'PUT': { required: ['id'] },
+        'PATCH': { required: [] },
+        'DELETE': { required: ['id'] },
+        'GET': { required: ['id'] },
+    },
+    optional: ['include']
+};
+exports.CandidateSchema = {
+    fields: {
+        id: 'string',
+        include: 'string',
+        name: 'string',
+        position: 'string',
+        voter_id_nnumber: 'string',
+        membership_number: 'string',
+        contact: 'string',
+        address: 'string',
+        denomination: 'string',
+        email: 'string',
+        status: 'boolean',
+        branch_id: 'string',
+        delegate_id: 'string',
+    },
+    required: {
+        'POST': { required: ['name', 'status', 'branch_id'] },
+        'PUT': { required: ['id'] },
+        'PATCH': { required: [] },
+        'DELETE': { required: ['id'] },
+        'GET': { required: ['id'] },
+    },
+    optional: ['include']
+};
+exports.UserSchema = {
+    fields: {
+        role: 'string',
+        password: 'string',
+        password_tries: 'number',
+        status: 'number',
+        ip_address: 'string',
+        employee_id: 'string',
+        company_id: 'string',
+        branch_id: 'string',
+        multiadd: 'object'
+    },
+    required: ['role', 'password', 'employee_id', 'company_id'],
+    optional: ['branch_id', 'multiadd']
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hastehaul/common",
-  "version": "1.0.15",
+  "version": "1.0.18",
   "description": "",
   "main": "./build/index.js",
   "types": "./build/index.d.ts",
@@ -23,6 +23,7 @@
     "typescript": "^5.1.6"
   },
   "dependencies": {
+    "@vsky/accesscontrol": "^3.0.14",
     "bullmq": "^4.6.3",
     "express": "^4.18.2",
     "ioredis": "^5.3.2",