cqrs-boilerplate-code 1.0.0 → 1.0.2

package/dist/core-common/index.js

@@ -0,0 +1,29 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+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("./constant/app.constant"), exports);
+__exportStar(require("./error/custom-error/already-exists.error"), exports);
+__exportStar(require("./error/custom-error/not-found.error"), exports);
+__exportStar(require("./error/custom-error/validation.error"), exports);
+__exportStar(require("./error/custom-error/internal-server.error"), exports);
+__exportStar(require("./error/custom-error/unauthorized.error"), exports);
+__exportStar(require("./error/custom-error/service-unavailable.error"), exports);
+__exportStar(require("./error/generic.error"), exports);
+__exportStar(require("./result-model/result"), exports);
+__exportStar(require("./response-model/generic-error-response.model"), exports);
+__exportStar(require("./response-model/generic-success-response.model"), exports);
+__exportStar(require("./core-common.module"), exports);
+//# sourceMappingURL=index.js.map

package/dist/core-common/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core-common/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0DAAuC;AACvC,4EAAyD;AACzD,uEAAoD;AACpD,wEAAqD;AACrD,6EAA0D;AAC1D,0EAAuD;AACvD,iFAA8D;AAC9D,wDAAqC;AACrC,wDAAqC;AACrC,gFAA6D;AAC7D,kFAA+D;AAE/D,uDAAoC","sourcesContent":["export * from './constant/app.constant'\nexport * from './error/custom-error/already-exists.error'\nexport * from './error/custom-error/not-found.error'\nexport * from './error/custom-error/validation.error'\nexport * from './error/custom-error/internal-server.error'\nexport * from './error/custom-error/unauthorized.error'\nexport * from './error/custom-error/service-unavailable.error'\nexport * from './error/generic.error'\nexport * from './result-model/result'\nexport * from './response-model/generic-error-response.model'\nexport * from './response-model/generic-success-response.model'\n\nexport * from './core-common.module'"]}

package/dist/core-common/logger/logger.interface.d.ts

@@ -0,0 +1,7 @@
+export interface LoggerModuleOptions {
+    level?: string;
+    deploymentEnv?: string;
+    serviceVersion?: string;
+    otelAgentHost?: string;
+    overrideConsole?: boolean;
+}

package/dist/core-common/logger/logger.interface.js

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

package/dist/core-common/logger/logger.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.interface.js","sourceRoot":"","sources":["../../../src/core-common/logger/logger.interface.ts"],"names":[],"mappings":"","sourcesContent":["// src/logger/logger.options.ts\nexport interface LoggerModuleOptions {\n  level?: string;\n  deploymentEnv?: string;\n  serviceVersion?: string;\n  otelAgentHost?: string;\n  overrideConsole?: boolean;\n}"]}

package/dist/core-common/logger/logger.module.d.ts

@@ -0,0 +1,6 @@
+import { DynamicModule } from "@nestjs/common";
+import { LoggerModuleOptions } from "./logger.interface";
+export declare const LOGGER_OPTIONS: unique symbol;
+export declare class LoggerModule {
+    static forRoot(options?: LoggerModuleOptions): DynamicModule;
+}

package/dist/core-common/logger/logger.module.js

@@ -0,0 +1,33 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var LoggerModule_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LoggerModule = exports.LOGGER_OPTIONS = void 0;
+const common_1 = require("@nestjs/common");
+const logger_service_1 = require("./logger.service");
+exports.LOGGER_OPTIONS = Symbol("LOGGER_OPTIONS");
+let LoggerModule = LoggerModule_1 = class LoggerModule {
+    static forRoot(options = {}) {
+        return {
+            module: LoggerModule_1,
+            providers: [
+                logger_service_1.LoggerService,
+                {
+                    provide: exports.LOGGER_OPTIONS,
+                    useValue: options,
+                },
+            ],
+            exports: [logger_service_1.LoggerService],
+        };
+    }
+};
+exports.LoggerModule = LoggerModule;
+exports.LoggerModule = LoggerModule = LoggerModule_1 = __decorate([
+    (0, common_1.Module)({})
+], LoggerModule);
+//# sourceMappingURL=logger.module.js.map

package/dist/core-common/logger/logger.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.module.js","sourceRoot":"","sources":["../../../src/core-common/logger/logger.module.ts"],"names":[],"mappings":";;;;;;;;;;AACA,2CAAuD;AACvD,qDAAiD;AAGpC,QAAA,cAAc,GAAG,MAAM,CAAC,gBAAgB,CAAC,CAAC;AAGhD,IAAM,YAAY,oBAAlB,MAAM,YAAY;IACvB,MAAM,CAAC,OAAO,CAAC,UAA+B,EAAE;QAC9C,OAAO;YACL,MAAM,EAAE,cAAY;YACpB,SAAS,EAAE;gBACT,8BAAa;gBACb;oBACE,OAAO,EAAE,sBAAc;oBACvB,QAAQ,EAAE,OAAO;iBAClB;aACF;YACD,OAAO,EAAE,CAAC,8BAAa,CAAC;SACzB,CAAC;IACJ,CAAC;CACF,CAAA;AAdY,oCAAY;uBAAZ,YAAY;IADxB,IAAA,eAAM,EAAC,EAAE,CAAC;GACE,YAAY,CAcxB","sourcesContent":["// src/logger/logger.module.ts\nimport { DynamicModule, Module } from \"@nestjs/common\";\nimport { LoggerService } from \"./logger.service\";\nimport { LoggerModuleOptions } from \"./logger.interface\";\n\nexport const LOGGER_OPTIONS = Symbol(\"LOGGER_OPTIONS\");\n\n@Module({})\nexport class LoggerModule {\n  static forRoot(options: LoggerModuleOptions = {}): DynamicModule {\n    return {\n      module: LoggerModule,\n      providers: [\n        LoggerService,\n        {\n          provide: LOGGER_OPTIONS,\n          useValue: options,\n        },\n      ],\n      exports: [LoggerService],\n    };\n  }\n}\n"]}

package/dist/core-common/logger/logger.service.d.ts

@@ -0,0 +1,29 @@
+type LogMetadata = {
+    ClassName?: string;
+    MethodName?: string;
+};
+export type OrgContext = {
+    orgId?: string;
+    orgFid?: string;
+    userId?: string;
+};
+export declare class LoggerService {
+    private readonly logger;
+    private readonly deploymentEnv;
+    private readonly hostImageVersion;
+    private readonly otelAgentHost;
+    constructor(logLevel?: string);
+    log(message: string, metadata?: LogMetadata): void;
+    debug(message: string, metadata?: LogMetadata): void;
+    warn(message: string, metadata?: LogMetadata): void;
+    error(message: string, metadata?: LogMetadata, error?: Error): void;
+    private write;
+    private createLogger;
+    private buildAttributes;
+    private cleanMeta;
+    private safeStringify;
+    private circularReplacer;
+    private redactSecrets;
+    private overrideConsole;
+}
+export {};

package/dist/core-common/logger/logger.service.js

@@ -0,0 +1,125 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LoggerService = void 0;
+const winston_1 = __importDefault(require("winston"));
+var SeverityText;
+(function (SeverityText) {
+    SeverityText["INFO"] = "Information";
+    SeverityText["DEBUG"] = "Debug";
+    SeverityText["WARNING"] = "Warning";
+    SeverityText["ERROR"] = "Error";
+})(SeverityText || (SeverityText = {}));
+class LoggerService {
+    logger;
+    deploymentEnv;
+    hostImageVersion;
+    otelAgentHost;
+    constructor(logLevel = "debug") {
+        this.deploymentEnv = "rls-dev";
+        this.hostImageVersion = process.env.SERVICE_VERSION ?? "202501.1";
+        this.otelAgentHost = process.env.OTEL_AGENT_HOST ?? "10.0.0.1";
+        this.logger = this.createLogger(logLevel);
+        this.overrideConsole();
+    }
+    log(message, metadata) {
+        this.write("info", SeverityText.INFO, message, metadata);
+    }
+    debug(message, metadata) {
+        this.write("debug", SeverityText.DEBUG, message, metadata);
+    }
+    warn(message, metadata) {
+        this.write("warn", SeverityText.WARNING, message, metadata);
+    }
+    error(message, metadata, error) {
+        this.write("error", SeverityText.ERROR, message, metadata, error);
+    }
+    write(level, severity, message, metadata = {}, error) {
+        const body = {
+            SeverityText: severity,
+            ...metadata,
+            ...(error && {
+                ErrorMessage: error.message,
+                StackTrace: error.stack,
+            }),
+        };
+        this.logger[level](this.redactSecrets(message), body);
+    }
+    createLogger(level) {
+        return winston_1.default.createLogger({
+            level,
+            levels: winston_1.default.config.npm.levels,
+            format: winston_1.default.format.combine(winston_1.default.format.timestamp({ format: "YYYY-MM-DD HH:mm:ss" }), winston_1.default.format.printf(({ level, message, timestamp, ...meta }) => JSON.stringify({
+                message: this.safeStringify(message),
+                attributes: this.buildAttributes(level),
+                timestamp: timestamp,
+                ...this.cleanMeta(meta),
+            }))),
+            transports: [new winston_1.default.transports.Console()],
+        });
+    }
+    buildAttributes(level) {
+        return {
+            "service.image.version": this.hostImageVersion,
+            "deployment.environment": this.deploymentEnv,
+            "otel.agent.host": this.otelAgentHost,
+            "service.log.level": level,
+        };
+    }
+    cleanMeta(meta) {
+        return Object.fromEntries(Object.entries(meta).filter(([_, value]) => value !== undefined && value !== "None"));
+    }
+    safeStringify(input) {
+        try {
+            return typeof input === "string"
+                ? input
+                : JSON.stringify(input, this.circularReplacer());
+        }
+        catch {
+            return "[Unserializable Object]";
+        }
+    }
+    circularReplacer() {
+        const seen = new WeakSet();
+        return (_, value) => {
+            if (typeof value === "object" && value !== null) {
+                if (seen.has(value))
+                    return "[Circular]";
+                seen.add(value);
+            }
+            return value;
+        };
+    }
+    redactSecrets(message) {
+        const patterns = [
+            {
+                name: "JWT",
+                regex: /eyJ[a-zA-Z0-9-_]+\.[a-zA-Z0-9-_]+\.[a-zA-Z0-9-_]+/g,
+                visible: 10,
+            },
+            {
+                name: "BEARER",
+                regex: /Bearer\s+eyJ[A-Za-z0-9\-._~+/]+=*/gi,
+                visible: 15,
+            },
+            { name: "API_KEY", regex: /\b[A-Za-z0-9]{32,}\b/g, visible: 8 },
+            { name: "AWS_SECRET", regex: /AKIA[0-9A-Z]{16}/g, visible: 8 },
+        ];
+        return patterns.reduce((msg, { regex, visible, name }) => {
+            return msg.replace(regex, (m) => `${m.slice(0, visible)}...[REDACTED_${name}]`);
+        }, message);
+    }
+    overrideConsole() {
+        const blocked = ["NodeSDK", "AuthToken"];
+        console.log = (...args) => {
+            const msg = args.map(String).join(" ");
+            if (blocked.some((k) => msg.includes(k)))
+                return;
+            this.log(msg);
+        };
+    }
+}
+exports.LoggerService = LoggerService;
+//# sourceMappingURL=logger.service.js.map

package/dist/core-common/logger/logger.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.service.js","sourceRoot":"","sources":["../../../src/core-common/logger/logger.service.ts"],"names":[],"mappings":"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","sourcesContent":["import winston, { Logger } from \"winston\";\n\n/* ---------------------------------- Types --------------------------------- */\n\nenum SeverityText {\n  INFO = \"Information\",\n  DEBUG = \"Debug\",\n  WARNING = \"Warning\",\n  ERROR = \"Error\",\n}\n\ntype LogMetadata = {\n  ClassName?: string;\n  MethodName?: string;\n};\n\nexport type OrgContext = {\n  orgId?: string;\n  orgFid?: string;\n  userId?: string;\n};\n\n/* --------------------------------- Service -------------------------------- */\n\nexport class LoggerService {\n  private readonly logger: Logger;\n  private readonly deploymentEnv: string;\n  private readonly hostImageVersion: string;\n  private readonly otelAgentHost: string;\n\n  constructor(logLevel: string = \"debug\") {\n    this.deploymentEnv = \"rls-dev\";\n    this.hostImageVersion = process.env.SERVICE_VERSION ?? \"202501.1\";\n    this.otelAgentHost = process.env.OTEL_AGENT_HOST ?? \"10.0.0.1\";\n    this.logger = this.createLogger(logLevel);\n    this.overrideConsole();\n  }\n\n  /* ------------------------------- Public API ------------------------------- */\n\n  log(message: string, metadata?: LogMetadata) {\n    this.write(\"info\", SeverityText.INFO, message, metadata);\n  }\n\n  debug(message: string, metadata?: LogMetadata) {\n    this.write(\"debug\", SeverityText.DEBUG, message, metadata);\n  }\n\n  warn(message: string, metadata?: LogMetadata) {\n    this.write(\"warn\", SeverityText.WARNING, message, metadata);\n  }\n\n  error(message: string, metadata?: LogMetadata, error?: Error) {\n    this.write(\"error\", SeverityText.ERROR, message, metadata, error);\n  }\n\n  /* ------------------------------ Logger Core ------------------------------ */\n\n  private write(\n    level: keyof Logger,\n    severity: SeverityText,\n    message: string,\n    metadata: LogMetadata = {},\n    error?: Error,\n  ) {\n    const body = {\n      SeverityText: severity,\n      ...metadata,\n      ...(error && {\n        ErrorMessage: error.message,\n        StackTrace: error.stack,\n      }),\n    };\n\n    this.logger[level](this.redactSecrets(message), body);\n  }\n\n  private createLogger(level: string): Logger {\n    return winston.createLogger({\n      level,\n      levels: winston.config.npm.levels,\n      format: winston.format.combine(\n        winston.format.timestamp({ format: \"YYYY-MM-DD HH:mm:ss\" }),\n        winston.format.printf(({ level, message, timestamp, ...meta }) =>\n          JSON.stringify({\n            message: this.safeStringify(message),\n            attributes: this.buildAttributes(level),\n            timestamp: timestamp,\n            ...this.cleanMeta(meta),\n          }),\n        ),\n      ),\n      transports: [new winston.transports.Console()],\n    });\n  }\n\n  /* ------------------------------- Context -------------------------------- */\n\n  private buildAttributes(level: string) {\n    return {\n      \"service.image.version\": this.hostImageVersion,\n      \"deployment.environment\": this.deploymentEnv,\n      \"otel.agent.host\": this.otelAgentHost,\n      \"service.log.level\": level,\n    };\n  }\n\n  /* ------------------------------- Helpers -------------------------------- */\n\n  private cleanMeta(meta: Record<string, unknown>) {\n    return Object.fromEntries(\n      Object.entries(meta).filter(\n        ([_, value]) => value !== undefined && value !== \"None\",\n      ),\n    );\n  }\n\n  private safeStringify(input: unknown): string {\n    try {\n      return typeof input === \"string\"\n        ? input\n        : JSON.stringify(input, this.circularReplacer());\n    } catch {\n      return \"[Unserializable Object]\";\n    }\n  }\n\n  private circularReplacer() {\n    const seen = new WeakSet();\n    return (_: string, value: any) => {\n      if (typeof value === \"object\" && value !== null) {\n        if (seen.has(value)) return \"[Circular]\";\n        seen.add(value);\n      }\n      return value;\n    };\n  }\n\n  /* ----------------------------- Redaction -------------------------------- */\n\n  private redactSecrets(message: string): string {\n    const patterns = [\n      {\n        name: \"JWT\",\n        regex: /eyJ[a-zA-Z0-9-_]+\\.[a-zA-Z0-9-_]+\\.[a-zA-Z0-9-_]+/g,\n        visible: 10,\n      },\n      {\n        name: \"BEARER\",\n        regex: /Bearer\\s+eyJ[A-Za-z0-9\\-._~+/]+=*/gi,\n        visible: 15,\n      },\n      { name: \"API_KEY\", regex: /\\b[A-Za-z0-9]{32,}\\b/g, visible: 8 },\n      { name: \"AWS_SECRET\", regex: /AKIA[0-9A-Z]{16}/g, visible: 8 },\n    ];\n\n    return patterns.reduce((msg, { regex, visible, name }) => {\n      return msg.replace(\n        regex,\n        (m) => `${m.slice(0, visible)}...[REDACTED_${name}]`,\n      );\n    }, message);\n  }\n\n  /* --------------------------- Console Override ---------------------------- */\n\n  private overrideConsole() {\n    const blocked = [\"NodeSDK\", \"AuthToken\"];\n    console.log = (...args: unknown[]) => {\n      const msg = args.map(String).join(\" \");\n      if (blocked.some((k) => msg.includes(k))) return;\n      this.log(msg);\n    };\n  }\n}\n"]}

package/dist/core-common/response-model/generic-error-response.model.d.ts

@@ -0,0 +1,15 @@
+import { Result } from "../result-model/result";
+export declare class ErrorDisplay {
+    code: string;
+    message: string;
+    validationError?: any;
+}
+export declare class GenericErrorResponse {
+    statusCode: number;
+    success: boolean;
+    error: ErrorDisplay;
+    timestamp: string;
+    data: any;
+    constructor();
+    initialize(result: Result<any>, statusCode: number): void;
+}

package/dist/core-common/response-model/generic-error-response.model.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GenericErrorResponse = exports.ErrorDisplay = void 0;
+class ErrorDisplay {
+    code;
+    message;
+    validationError;
+}
+exports.ErrorDisplay = ErrorDisplay;
+class GenericErrorResponse {
+    statusCode;
+    success = false;
+    error;
+    timestamp;
+    data;
+    constructor() {
+        this.statusCode = 500;
+        this.success = false;
+        this.timestamp = new Date().toISOString();
+    }
+    initialize(result, statusCode) {
+        this.statusCode = statusCode;
+        this.error = {
+            code: result.error?.code || "ERROR",
+            message: result.error?.message || "An error occurred.",
+        };
+        this.data = result.data;
+        this.success = result.success || false;
+        this.timestamp = result.timestamp || new Date().toISOString();
+    }
+}
+exports.GenericErrorResponse = GenericErrorResponse;
+//# sourceMappingURL=generic-error-response.model.js.map

package/dist/core-common/response-model/generic-error-response.model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generic-error-response.model.js","sourceRoot":"","sources":["../../../src/core-common/response-model/generic-error-response.model.ts"],"names":[],"mappings":";;;AAQA,MAAa,YAAY;IACvB,IAAI,CAAS;IACb,OAAO,CAAS;IAChB,eAAe,CAAO;CACvB;AAJD,oCAIC;AACD,MAAa,oBAAoB;IAC/B,UAAU,CAAS;IACnB,OAAO,GAAY,KAAK,CAAC;IACzB,KAAK,CAAe;IACpB,SAAS,CAAS;IAClB,IAAI,CAAM;IAEV;QACE,IAAI,CAAC,UAAU,GAAG,GAAG,CAAC;QACtB,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;QACrB,IAAI,CAAC,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC5C,CAAC;IAMD,UAAU,CACR,MAAmB,EACnB,UAAkB;QAElB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,KAAK,GAAG;YACX,IAAI,EAAE,MAAM,CAAC,KAAK,EAAE,IAAI,IAAI,OAAO;YACnC,OAAO,EAAE,MAAM,CAAC,KAAK,EAAE,OAAO,IAAI,oBAAoB;SACvD,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAA;QACvB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,KAAK,CAAC;QACvC,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAChE,CAAC;CACF;AA9BD,oDA8BC","sourcesContent":["import { Result } from \"../result-model/result\";\n\n/**\n * Standard error response to be returned to the caller of the API.\n * This class represents the structure of an error response returned by the API\n * in case of failures.\n */\n\nexport class ErrorDisplay {\n  code: string;\n  message: string;\n  validationError?: any;\n}\nexport class GenericErrorResponse {\n  statusCode: number;\n  success: boolean = false;\n  error: ErrorDisplay;\n  timestamp: string;\n  data: any;\n\n  constructor() {\n    this.statusCode = 500; // Default value\n    this.success = false;\n    this.timestamp = new Date().toISOString(); // Default value\n  }\n  /**\n   * Sets the properties from the Result object.\n   * @param result - Result object instance returned from the controller method.\n   * @param statusCode - HTTP status code.\n   */\n  initialize(\n    result: Result<any>,\n    statusCode: number,\n  ) {\n    this.statusCode = statusCode;\n    this.error = {\n      code: result.error?.code || \"ERROR\",\n      message: result.error?.message || \"An error occurred.\",\n    };\n    this.data = result.data\n    this.success = result.success || false;\n    this.timestamp = result.timestamp || new Date().toISOString();\n  }\n}\n"]}

package/dist/core-common/response-model/generic-success-response.model.d.ts

@@ -0,0 +1,8 @@
+import { Result } from "../result-model/result";
+export declare class GenericSuccessResponse<T> {
+    statusCode: number;
+    success: boolean;
+    data: T;
+    timestamp: string;
+    initialize(result: Result<T>, statusCode: number): void;
+}

package/dist/core-common/response-model/generic-success-response.model.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GenericSuccessResponse = void 0;
+class GenericSuccessResponse {
+    statusCode;
+    success;
+    data;
+    timestamp;
+    initialize(result, statusCode) {
+        this.statusCode = statusCode;
+        this.success = result.success;
+        this.data = result.data;
+        this.timestamp = new Date().toISOString();
+    }
+}
+exports.GenericSuccessResponse = GenericSuccessResponse;
+//# sourceMappingURL=generic-success-response.model.js.map

package/dist/core-common/response-model/generic-success-response.model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generic-success-response.model.js","sourceRoot":"","sources":["../../../src/core-common/response-model/generic-success-response.model.ts"],"names":[],"mappings":";;;AAOA,MAAa,sBAAsB;IACjC,UAAU,CAAS;IACnB,OAAO,CAAU;IACjB,IAAI,CAAI;IACR,SAAS,CAAS;IAOlB,UAAU,CAAC,MAAiB,EAAE,UAAkB;QAC9C,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;QAC9B,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;QACxB,IAAI,CAAC,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC5C,CAAC;CACF;AAjBD,wDAiBC","sourcesContent":["import { Result } from \"../result-model/result\";\n\n/**\n * Standard response object to be returned to the caller of the API.\n * This class represents the structure of a success response returned by the API.\n * @typeparam T - The type of data included in the response.\n */\nexport class GenericSuccessResponse<T> {\n  statusCode: number;\n  success: boolean;\n  data: T;\n  timestamp: string;\n\n  /**\n   * Sets the properties from the Result object.\n   * @param result - Result object instance returned from the controller method.\n   * @param statusCode - HTTP status code.\n   */\n  initialize(result: Result<T>, statusCode: number) {\n    this.statusCode = statusCode;\n    this.success = result.success;\n    this.data = result.data;\n    this.timestamp = new Date().toISOString();\n  }\n}\n"]}

package/dist/core-common/result-model/result.d.ts

@@ -0,0 +1,10 @@
+import { GenericError } from "../error/generic.error";
+export declare class Result<T> {
+    success: boolean;
+    data: T;
+    error: GenericError;
+    timestamp: string;
+    static success<T>(data: T): Result<T>;
+    static failed<T>(error: GenericError, data?: T): Result<T>;
+    static throwError<T>(error: GenericError, data?: T): Result<T>;
+}

package/dist/core-common/result-model/result.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Result = void 0;
+class Result {
+    success;
+    data;
+    error;
+    timestamp;
+    static success(data) {
+        const result = new Result();
+        result.success = true;
+        result.data = data;
+        result.timestamp = new Date().toISOString();
+        return result;
+    }
+    static failed(error, data) {
+        const result = new Result();
+        result.success = false;
+        result.timestamp = new Date().toISOString();
+        result.error = error;
+        if (data) {
+            result.data = data;
+        }
+        return result;
+    }
+    static throwError(error, data) {
+        const result = new Result();
+        result.success = false;
+        result.timestamp = new Date().toISOString();
+        result.error = error;
+        if (data) {
+            result.data = data;
+        }
+        throw result;
+    }
+}
+exports.Result = Result;
+//# sourceMappingURL=result.js.map

package/dist/core-common/result-model/result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.js","sourceRoot":"","sources":["../../../src/core-common/result-model/result.ts"],"names":[],"mappings":";;;AAEA,MAAa,MAAM;IACjB,OAAO,CAAU;IACjB,IAAI,CAAI;IACR,KAAK,CAAe;IACpB,SAAS,CAAS;IAEX,MAAM,CAAC,OAAO,CAAI,IAAO;QAC9B,MAAM,MAAM,GAAG,IAAI,MAAM,EAAK,CAAC;QAC/B,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;QACtB,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC;QACnB,MAAM,CAAC,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC5C,OAAO,MAAM,CAAC;IAChB,CAAC;IAEM,MAAM,CAAC,MAAM,CAAI,KAAmB,EAAE,IAAQ;QACnD,MAAM,MAAM,GAAG,IAAI,MAAM,EAAK,CAAC;QAC/B,MAAM,CAAC,OAAO,GAAG,KAAK,CAAC;QACvB,MAAM,CAAC,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC5C,MAAM,CAAC,KAAK,GAAG,KAAK,CAAC;QACrB,IAAI,IAAI,EAAE,CAAC;YACT,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC;QACrB,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAEM,MAAM,CAAC,UAAU,CAAI,KAAmB,EAAE,IAAQ;QACvD,MAAM,MAAM,GAAG,IAAI,MAAM,EAAK,CAAC;QAC/B,MAAM,CAAC,OAAO,GAAG,KAAK,CAAC;QACvB,MAAM,CAAC,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC5C,MAAM,CAAC,KAAK,GAAG,KAAK,CAAC;QACrB,IAAI,IAAI,EAAE,CAAC;YACT,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC;QACrB,CAAC;QACD,MAAM,MAAM,CAAC;IACf,CAAC;CACF;AAnCD,wBAmCC","sourcesContent":["import { GenericError } from \"../error/generic.error\";\n\nexport class Result<T> {\n  success: boolean;\n  data: T;\n  error: GenericError;\n  timestamp: string;\n\n  public static success<T>(data: T): Result<T> {\n    const result = new Result<T>();\n    result.success = true;\n    result.data = data;\n    result.timestamp = new Date().toISOString();\n    return result;\n  }\n\n  public static failed<T>(error: GenericError, data?: T): Result<T> {\n    const result = new Result<T>();\n    result.success = false;\n    result.timestamp = new Date().toISOString();\n    result.error = error;\n    if (data) {\n      result.data = data;\n    }\n    return result;\n  }\n\n  public static throwError<T>(error: GenericError, data?: T): Result<T> {\n    const result = new Result<T>();\n    result.success = false;\n    result.timestamp = new Date().toISOString();\n    result.error = error;\n    if (data) {\n      result.data = data;\n    }\n    throw result;\n  }\n}\n"]}