@intlayer/backend 3.0.0

package/dist/esm/utils/accessControl.mjs

@@ -0,0 +1,95 @@
+import { logger } from './../logger/index.mjs';
+import { HttpStatusCodes } from './httpStatusCodes.mjs';
+var AccessRule = /* @__PURE__ */ ((AccessRule2) => {
+  AccessRule2["none"] = "none";
+  AccessRule2["authenticated"] = "authenticated";
+  AccessRule2["admin"] = "admin";
+  AccessRule2["noneAuthenticated"] = "none-authenticated";
+  AccessRule2["hasOrganization"] = "has-organization";
+  AccessRule2["hasProject"] = "has-project";
+  AccessRule2["hasBearer"] = "has-bearer";
+  return AccessRule2;
+})(AccessRule || {});
+const accessControl = (res, accessRule) => {
+  const accessRuleArray = Array.isArray(accessRule) ? accessRule : [accessRule];
+  const localsAuthInformation = res.locals;
+  const { user, organization, project, authType } = localsAuthInformation;
+  if (accessRuleArray.includes("none" /* none */)) {
+    return {
+      success: true,
+      message: null,
+      data: { user, organization, project, authType }
+    };
+  }
+  let success = true;
+  const messages = [];
+  if (accessRuleArray.includes("authenticated" /* authenticated */)) {
+    if (!user) {
+      success = false;
+      messages.push("User is not authenticated");
+    }
+  }
+  if (accessRuleArray.includes("none-authenticated" /* noneAuthenticated */)) {
+    if (user) {
+      success = false;
+      messages.push("User is authenticated");
+    }
+  }
+  if (accessRuleArray.includes("has-organization" /* hasOrganization */)) {
+    if (!organization) {
+      success = false;
+      messages.push("Organization is not set");
+    }
+  }
+  if (accessRuleArray.includes("has-project" /* hasProject */)) {
+    if (!project) {
+      success = false;
+      messages.push("Project is not set");
+    }
+  }
+  const knownRules = Object.values(AccessRule);
+  const unknownRules = accessRuleArray.filter(
+    (rule) => !knownRules.includes(rule)
+  );
+  if (unknownRules.length > 0) {
+    success = false;
+    messages.push(`Unknown access rules: ${unknownRules.join(", ")}`);
+  }
+  return {
+    success,
+    message: messages.join(", "),
+    data: { user, organization, project, authType }
+  };
+};
+const accessControlMiddleWare = (...accessRules) => (_req, res, next) => {
+  let hasAccess = false;
+  for (const ruleGroup of accessRules) {
+    if (Array.isArray(ruleGroup)) {
+      const accessResults = ruleGroup.map(
+        (rule) => accessControl(res, rule).success
+      );
+      hasAccess = accessResults.every((result) => result);
+    } else {
+      const accessResult = accessControl(res, ruleGroup);
+      if (accessResult.success) {
+        hasAccess = true;
+      }
+    }
+    if (hasAccess) {
+      break;
+    }
+  }
+  if (!hasAccess) {
+    logger.error("Access denied");
+    const errorStatusCode = HttpStatusCodes.FORBIDDEN_403;
+    res.sendStatus(errorStatusCode);
+    return;
+  }
+  next();
+};
+export {
+  AccessRule,
+  accessControl,
+  accessControlMiddleWare
+};
+//# sourceMappingURL=accessControl.mjs.map

package/dist/esm/utils/accessControl.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/utils/accessControl.ts"],"sourcesContent":["import { logger } from '@logger';\nimport { ResponseWithInformation } from '@middlewares/sessionAuth.middleware';\nimport type { NextFunction, Request } from 'express';\nimport { HttpStatusCodes } from './httpStatusCodes';\n\nexport enum AccessRule {\n  none = 'none',\n  authenticated = 'authenticated',\n  admin = 'admin',\n  noneAuthenticated = 'none-authenticated',\n  hasOrganization = 'has-organization',\n  hasProject = 'has-project',\n  hasBearer = 'has-bearer',\n}\n\nexport const accessControl = <R extends AccessRule | AccessRule[]>(\n  res: ResponseWithInformation,\n  accessRule: R\n) => {\n  const accessRuleArray: AccessRule[] = Array.isArray(accessRule)\n    ? accessRule\n    : [accessRule];\n\n  const localsAuthInformation = res.locals;\n  const { user, organization, project, authType } = localsAuthInformation;\n\n  // If 'none' access rule is present, immediately return success\n  if (accessRuleArray.includes(AccessRule.none)) {\n    return {\n      success: true,\n      message: null,\n      data: { user, organization, project, authType },\n    };\n  }\n\n  let success = true;\n  const messages: string[] = [];\n\n  // Check for 'authenticated' access rule\n  if (accessRuleArray.includes(AccessRule.authenticated)) {\n    if (!user) {\n      success = false;\n      messages.push('User is not authenticated');\n    }\n  }\n\n  // Check for 'admin' access rule\n  // if (accessRuleArray.includes(AccessRule.admin)) {\n  //   if (!user?.role.includes('admin')) {\n  //     success = false;\n  //     messages.push('User is not an admin');\n  //   }\n  // }\n\n  // Check for 'none-authenticated' access rule\n  if (accessRuleArray.includes(AccessRule.noneAuthenticated)) {\n    if (user) {\n      success = false;\n      messages.push('User is authenticated');\n    }\n  }\n\n  // Check for 'has-organization' access rule\n  if (accessRuleArray.includes(AccessRule.hasOrganization)) {\n    if (!organization) {\n      success = false;\n      messages.push('Organization is not set');\n    }\n  }\n\n  // Check for 'has-project' access rule\n  if (accessRuleArray.includes(AccessRule.hasProject)) {\n    if (!project) {\n      success = false;\n      messages.push('Project is not set');\n    }\n  }\n\n  // Handle unknown access rules\n  const knownRules = Object.values(AccessRule);\n  const unknownRules = accessRuleArray.filter(\n    (rule) => !knownRules.includes(rule)\n  );\n  if (unknownRules.length > 0) {\n    success = false;\n    messages.push(`Unknown access rules: ${unknownRules.join(', ')}`);\n  }\n\n  return {\n    success,\n    message: messages.join(', '),\n    data: { user, organization, project, authType },\n  };\n};\n\n/**\n * Middleware to control API access based on access rules.\n *\n * This middleware allows for multiple access rules to be passed, either as individual `AccessRule` or\n * an array of `AccessRule` groups. Access is granted if at least one of the following conditions is met:\n *\n * - The user satisfies all `AccessRule` within any group of rules passed as an array.\n * - The user satisfies any single `AccessRule` passed individually.\n *\n * Example usage:\n *\n * ```typescript\n * // Allow access if the user has both `hasProject` and `hasOrganization`, or if they have `admin` rights\n * app.use('/protected-route', apiAccessControlMiddleWare([AccessRule.hasProject, AccessRule.hasOrganization], AccessRule.admin));\n * ```\n *\n * In this example:\n * - The user will be granted access if they have both `hasProject` and `hasOrganization`.\n * - Alternatively, the user will also be granted access if they have `admin` privileges.\n *\n * @param {...(AccessRule | AccessRule[])[]} accessRules - One or more access rules or groups of access rules.\n * - Single `AccessRule`: The user must satisfy this rule for access to be granted.\n * - Array of `AccessRule`: The user must satisfy all rules in the array for access to be granted.\n * @returns {Function} Express middleware function that checks if the user has the required access.\n *\n * If the user does not meet any of the provided access rules, a 403 Forbidden status is returned.\n *\n * @example\n * // Example 1: Require admin privileges\n * app.use('/admin', apiAccessControlMiddleWare(AccessRule.admin));\n *\n * @example\n * // Example 2: Require both project and organization access, or admin privileges\n * app.use('/dashboard', apiAccessControlMiddleWare([AccessRule.hasProject, AccessRule.hasOrganization], AccessRule.admin));\n */\nexport const accessControlMiddleWare =\n  (...accessRules: (AccessRule | AccessRule[])[]) =>\n  (\n    _req: Request<unknown>,\n    res: ResponseWithInformation,\n    next: NextFunction\n  ): void => {\n    let hasAccess = false;\n\n    // Iterate over each access rule group (either single AccessRule or an array of AccessRules)\n    for (const ruleGroup of accessRules) {\n      if (Array.isArray(ruleGroup)) {\n        // If ruleGroup is an array, check if all rules in the group are satisfied\n        const accessResults = ruleGroup.map(\n          (rule) => accessControl(res, rule).success\n        );\n        hasAccess = accessResults.every((result) => result); // All rules must be satisfied in this case\n      } else {\n        // Single rule: just check this one\n        const accessResult = accessControl(res, ruleGroup);\n        if (accessResult.success) {\n          hasAccess = true;\n        }\n      }\n\n      // If access is granted at any point, stop further checks\n      if (hasAccess) {\n        break;\n      }\n    }\n\n    // If no access rule group was satisfied, deny access\n    if (!hasAccess) {\n      logger.error('Access denied');\n\n      const errorStatusCode = HttpStatusCodes.FORBIDDEN_403;\n      res.sendStatus(errorStatusCode);\n      return;\n    }\n\n    next();\n  };\n"],"mappings":"AAAA,SAAS,cAAc;AAGvB,SAAS,uBAAuB;AAEzB,IAAK,aAAL,kBAAKA,gBAAL;AACL,EAAAA,YAAA,UAAO;AACP,EAAAA,YAAA,mBAAgB;AAChB,EAAAA,YAAA,WAAQ;AACR,EAAAA,YAAA,uBAAoB;AACpB,EAAAA,YAAA,qBAAkB;AAClB,EAAAA,YAAA,gBAAa;AACb,EAAAA,YAAA,eAAY;AAPF,SAAAA;AAAA,GAAA;AAUL,MAAM,gBAAgB,CAC3B,KACA,eACG;AACH,QAAM,kBAAgC,MAAM,QAAQ,UAAU,IAC1D,aACA,CAAC,UAAU;AAEf,QAAM,wBAAwB,IAAI;AAClC,QAAM,EAAE,MAAM,cAAc,SAAS,SAAS,IAAI;AAGlD,MAAI,gBAAgB,SAAS,iBAAe,GAAG;AAC7C,WAAO;AAAA,MACL,SAAS;AAAA,MACT,SAAS;AAAA,MACT,MAAM,EAAE,MAAM,cAAc,SAAS,SAAS;AAAA,IAChD;AAAA,EACF;AAEA,MAAI,UAAU;AACd,QAAM,WAAqB,CAAC;AAG5B,MAAI,gBAAgB,SAAS,mCAAwB,GAAG;AACtD,QAAI,CAAC,MAAM;AACT,gBAAU;AACV,eAAS,KAAK,2BAA2B;AAAA,IAC3C;AAAA,EACF;AAWA,MAAI,gBAAgB,SAAS,4CAA4B,GAAG;AAC1D,QAAI,MAAM;AACR,gBAAU;AACV,eAAS,KAAK,uBAAuB;AAAA,IACvC;AAAA,EACF;AAGA,MAAI,gBAAgB,SAAS,wCAA0B,GAAG;AACxD,QAAI,CAAC,cAAc;AACjB,gBAAU;AACV,eAAS,KAAK,yBAAyB;AAAA,IACzC;AAAA,EACF;AAGA,MAAI,gBAAgB,SAAS,8BAAqB,GAAG;AACnD,QAAI,CAAC,SAAS;AACZ,gBAAU;AACV,eAAS,KAAK,oBAAoB;AAAA,IACpC;AAAA,EACF;AAGA,QAAM,aAAa,OAAO,OAAO,UAAU;AAC3C,QAAM,eAAe,gBAAgB;AAAA,IACnC,CAAC,SAAS,CAAC,WAAW,SAAS,IAAI;AAAA,EACrC;AACA,MAAI,aAAa,SAAS,GAAG;AAC3B,cAAU;AACV,aAAS,KAAK,yBAAyB,aAAa,KAAK,IAAI,CAAC,EAAE;AAAA,EAClE;AAEA,SAAO;AAAA,IACL;AAAA,IACA,SAAS,SAAS,KAAK,IAAI;AAAA,IAC3B,MAAM,EAAE,MAAM,cAAc,SAAS,SAAS;AAAA,EAChD;AACF;AAqCO,MAAM,0BACX,IAAI,gBACJ,CACE,MACA,KACA,SACS;AACT,MAAI,YAAY;AAGhB,aAAW,aAAa,aAAa;AACnC,QAAI,MAAM,QAAQ,SAAS,GAAG;AAE5B,YAAM,gBAAgB,UAAU;AAAA,QAC9B,CAAC,SAAS,cAAc,KAAK,IAAI,EAAE;AAAA,MACrC;AACA,kBAAY,cAAc,MAAM,CAAC,WAAW,MAAM;AAAA,IACpD,OAAO;AAEL,YAAM,eAAe,cAAc,KAAK,SAAS;AACjD,UAAI,aAAa,SAAS;AACxB,oBAAY;AAAA,MACd;AAAA,IACF;AAGA,QAAI,WAAW;AACb;AAAA,IACF;AAAA,EACF;AAGA,MAAI,CAAC,WAAW;AACd,WAAO,MAAM,eAAe;AAE5B,UAAM,kBAAkB,gBAAgB;AACxC,QAAI,WAAW,eAAe;AAC9B;AAAA,EACF;AAEA,OAAK;AACP;","names":["AccessRule"]}

package/dist/esm/utils/cookies.mjs

@@ -0,0 +1,32 @@
+const MAX_AGE = 3 * 24 * 60 * 60 * 1e3;
+var Cookies = /* @__PURE__ */ ((Cookies2) => {
+  Cookies2["JWT_AUTH"] = "intlayer_auth";
+  Cookies2["JWT_USER"] = "intlayer_user";
+  Cookies2["JWT_ORGANIZATION"] = "intlayer_organization";
+  Cookies2["JWT_PROJECT"] = "intlayer_project";
+  Cookies2["XSRF_TOKEN"] = "XSRF-TOKEN";
+  return Cookies2;
+})(Cookies || {});
+const getCookieOptions = (overwriteOption = {}) => ({
+  maxAge: MAX_AGE,
+  path: "/",
+  domain: process.env.DOMAIN,
+  httpOnly: true,
+  secure: process.env.NODE_ENV === "production",
+  // Enable for HTTPS in production
+  sameSite: "strict",
+  priority: "high",
+  ...overwriteOption
+});
+const getClearCookieOptions = (overwriteOption = {}) => ({
+  ...getCookieOptions(),
+  maxAge: 1,
+  ...overwriteOption
+});
+export {
+  Cookies,
+  MAX_AGE,
+  getClearCookieOptions,
+  getCookieOptions
+};
+//# sourceMappingURL=cookies.mjs.map

package/dist/esm/utils/cookies.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/utils/cookies.ts"],"sourcesContent":["import type { CookieOptions } from 'express';\n\nexport const MAX_AGE = 3 * 24 * 60 * 60 * 1000; // 3 days\n\nexport enum Cookies {\n  JWT_AUTH = 'intlayer_auth',\n  JWT_USER = 'intlayer_user',\n  JWT_ORGANIZATION = 'intlayer_organization',\n  JWT_PROJECT = 'intlayer_project',\n  XSRF_TOKEN = 'XSRF-TOKEN',\n}\n\nexport const getCookieOptions = (\n  overwriteOption: Partial<CookieOptions> = {}\n): CookieOptions => ({\n  maxAge: MAX_AGE,\n  path: '/',\n  domain: process.env.DOMAIN,\n  httpOnly: true,\n  secure: process.env.NODE_ENV === 'production', // Enable for HTTPS in production\n  sameSite: 'strict',\n  priority: 'high',\n  ...overwriteOption,\n});\n\nexport const getClearCookieOptions = (\n  overwriteOption: Partial<CookieOptions> = {}\n): CookieOptions => ({\n  ...getCookieOptions(),\n  maxAge: 1,\n  ...overwriteOption,\n});\n"],"mappings":"AAEO,MAAM,UAAU,IAAI,KAAK,KAAK,KAAK;AAEnC,IAAK,UAAL,kBAAKA,aAAL;AACL,EAAAA,SAAA,cAAW;AACX,EAAAA,SAAA,cAAW;AACX,EAAAA,SAAA,sBAAmB;AACnB,EAAAA,SAAA,iBAAc;AACd,EAAAA,SAAA,gBAAa;AALH,SAAAA;AAAA,GAAA;AAQL,MAAM,mBAAmB,CAC9B,kBAA0C,CAAC,OACxB;AAAA,EACnB,QAAQ;AAAA,EACR,MAAM;AAAA,EACN,QAAQ,QAAQ,IAAI;AAAA,EACpB,UAAU;AAAA,EACV,QAAQ,QAAQ,IAAI,aAAa;AAAA;AAAA,EACjC,UAAU;AAAA,EACV,UAAU;AAAA,EACV,GAAG;AACL;AAEO,MAAM,wBAAwB,CACnC,kBAA0C,CAAC,OACxB;AAAA,EACnB,GAAG,iBAAiB;AAAA,EACpB,QAAQ;AAAA,EACR,GAAG;AACL;","names":["Cookies"]}

package/dist/esm/utils/errors/ErrorHandler.mjs

@@ -0,0 +1,79 @@
+import { logger } from './../../logger/index.mjs';
+import { formatPaginatedResponse, formatResponse } from './../../utils/responseData.mjs';
+import { t } from "express-intlayer";
+import { errorData } from './errorCodes.mjs';
+import { HttpStatusCodes } from './../../export.mjs';
+class ErrorHandler {
+  /**
+   * Handles generic error responses by formatting and sending a JSON response.
+   * @param res - The response object provided by Express.js.
+   * @param errorKey - A key representing the specific error.
+   * @param statusCode - (Optional) A specific HTTP status code to use for the response.
+   * @param isPaginatedResponse - Flag to determine if the response should be paginated.
+   */
+  static handleGenericErrorResponse(res, errorKey, errorDetails, statusCode, isPaginatedResponse = false) {
+    const error = errorData[errorKey];
+    const status = statusCode ?? error.statusCode;
+    this.handleCustomErrorResponse(
+      res,
+      errorKey,
+      error.message,
+      errorDetails,
+      status,
+      isPaginatedResponse
+    );
+  }
+  /**
+   * Handles application-specific error responses by formatting and sending a JSON response.
+   * @param res - The response object provided by Express.js.
+   * @param error - The error object.
+   * @param isPaginatedResponse - Flag to determine if the response should be paginated.
+   */
+  static handleAppErrorResponse(res, error, errorDetails, isPaginatedResponse = false) {
+    const isMultilingual = error.isMultilingual ?? false;
+    this.handleCustomErrorResponse(
+      res,
+      error.errorKey,
+      isMultilingual ? error.multilingualMessage : JSON.stringify(error.message),
+      errorDetails,
+      error.httpStatusCode,
+      isPaginatedResponse
+    );
+  }
+  /**
+   * Handles more customizable error responses with detailed error messages and codes.
+   * @param res - The response object.
+   * @param errorKey - Error code key used to fetch the corresponding message and default status.
+   * @param message - The localized error message object.
+   * @param statusCode - (Optional) HTTP status code, defaults to 500 if not specified.
+   * @param isPaginatedResponse - Determines if the error should be part of a paginated response.
+   */
+  static handleCustomErrorResponse(res, errorKey, message, errorDetails, statusCode, isPaginatedResponse = false) {
+    logger.error(message?.en ?? message);
+    const status = statusCode ?? HttpStatusCodes.INTERNAL_SERVER_ERROR_500;
+    if (isPaginatedResponse) {
+      const responseData2 = formatPaginatedResponse({
+        error: {
+          code: errorKey,
+          message: typeof message === "string" ? message : t(message)
+        },
+        status
+      });
+      res.status(status).json(responseData2);
+      return;
+    }
+    const responseData = formatResponse({
+      error: {
+        code: errorKey,
+        message: t(message),
+        ...errorDetails
+      },
+      status
+    });
+    res.status(status).json(responseData);
+  }
+}
+export {
+  ErrorHandler
+};
+//# sourceMappingURL=ErrorHandler.mjs.map

package/dist/esm/utils/errors/ErrorHandler.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/utils/errors/ErrorHandler.ts"],"sourcesContent":["// Import required modules and types from their respective locations.\nimport { logger } from '@logger';\nimport { formatPaginatedResponse, formatResponse } from '@utils/responseData';\nimport type { Response } from 'express';\n// @ts-ignore express-intlayer not build yet\nimport { t, LanguageContent } from 'express-intlayer';\nimport { ErrorCodes, errorData } from './errorCodes';\nimport { AppError } from './ErrorsClass';\nimport { HttpStatusCodes, UserAPI } from '@/export';\n\n// Define a class named 'ErrorHandler' to encapsulate error handling logic.\nexport class ErrorHandler {\n  /**\n   * Handles generic error responses by formatting and sending a JSON response.\n   * @param res - The response object provided by Express.js.\n   * @param errorKey - A key representing the specific error.\n   * @param statusCode - (Optional) A specific HTTP status code to use for the response.\n   * @param isPaginatedResponse - Flag to determine if the response should be paginated.\n   */\n  static handleGenericErrorResponse(\n    res: Response,\n    errorKey: ErrorCodes,\n    errorDetails?: object,\n    statusCode?: HttpStatusCodes,\n    isPaginatedResponse: boolean = false\n  ) {\n    const error = errorData[errorKey];\n    const status = statusCode ?? error.statusCode; // Use the provided status code or default to the one in errorData.\n\n    // Delegate to a more customizable error response handler.\n    this.handleCustomErrorResponse(\n      res,\n      errorKey,\n      error.message,\n      errorDetails,\n      status,\n      isPaginatedResponse\n    );\n  }\n\n  /**\n   * Handles application-specific error responses by formatting and sending a JSON response.\n   * @param res - The response object provided by Express.js.\n   * @param error - The error object.\n   * @param isPaginatedResponse - Flag to determine if the response should be paginated.\n   */\n  static handleAppErrorResponse(\n    res: Response,\n    error: AppError,\n    errorDetails?: object,\n    isPaginatedResponse: boolean = false\n  ) {\n    const isMultilingual = error.isMultilingual ?? false;\n    // Delegate to a more customizable error response handler.\n    this.handleCustomErrorResponse(\n      res,\n      error.errorKey,\n      isMultilingual\n        ? error.multilingualMessage\n        : JSON.stringify(error.message),\n      errorDetails,\n      error.httpStatusCode,\n      isPaginatedResponse\n    );\n  }\n\n  /**\n   * Handles more customizable error responses with detailed error messages and codes.\n   * @param res - The response object.\n   * @param errorKey - Error code key used to fetch the corresponding message and default status.\n   * @param message - The localized error message object.\n   * @param statusCode - (Optional) HTTP status code, defaults to 500 if not specified.\n   * @param isPaginatedResponse - Determines if the error should be part of a paginated response.\n   */\n  static handleCustomErrorResponse<T>(\n    res: Response,\n    errorKey: ErrorCodes | string,\n    message: LanguageContent<string> | string,\n    errorDetails?: object,\n    statusCode?: HttpStatusCodes,\n    isPaginatedResponse: boolean = false\n  ) {\n    logger.error((message as { en: string })?.en ?? message); // Log the English version of the error message.\n    const status = statusCode ?? HttpStatusCodes.INTERNAL_SERVER_ERROR_500; // Default to 500 if no status code is provided.\n\n    if (isPaginatedResponse) {\n      // Format the response as a paginated error response if requested.\n      const responseData = formatPaginatedResponse<T>({\n        error: {\n          code: errorKey,\n          message: typeof message === 'string' ? message : t(message),\n        },\n        status,\n      });\n      res.status(status).json(responseData);\n      return;\n    }\n\n    // Format the response as a standard non-paginated error response.\n    const responseData = formatResponse<UserAPI>({\n      error: {\n        code: errorKey,\n        message: t(message),\n        ...errorDetails,\n      },\n      status,\n    });\n\n    res.status(status).json(responseData);\n  }\n}\n"],"mappings":"AACA,SAAS,cAAc;AACvB,SAAS,yBAAyB,sBAAsB;AAGxD,SAAS,SAA0B;AACnC,SAAqB,iBAAiB;AAEtC,SAAS,uBAAgC;AAGlC,MAAM,aAAa;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQxB,OAAO,2BACL,KACA,UACA,cACA,YACA,sBAA+B,OAC/B;AACA,UAAM,QAAQ,UAAU,QAAQ;AAChC,UAAM,SAAS,cAAc,MAAM;AAGnC,SAAK;AAAA,MACH;AAAA,MACA;AAAA,MACA,MAAM;AAAA,MACN;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,OAAO,uBACL,KACA,OACA,cACA,sBAA+B,OAC/B;AACA,UAAM,iBAAiB,MAAM,kBAAkB;AAE/C,SAAK;AAAA,MACH;AAAA,MACA,MAAM;AAAA,MACN,iBACI,MAAM,sBACN,KAAK,UAAU,MAAM,OAAO;AAAA,MAChC;AAAA,MACA,MAAM;AAAA,MACN;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,OAAO,0BACL,KACA,UACA,SACA,cACA,YACA,sBAA+B,OAC/B;AACA,WAAO,MAAO,SAA4B,MAAM,OAAO;AACvD,UAAM,SAAS,cAAc,gBAAgB;AAE7C,QAAI,qBAAqB;AAEvB,YAAMA,gBAAe,wBAA2B;AAAA,QAC9C,OAAO;AAAA,UACL,MAAM;AAAA,UACN,SAAS,OAAO,YAAY,WAAW,UAAU,EAAE,OAAO;AAAA,QAC5D;AAAA,QACA;AAAA,MACF,CAAC;AACD,UAAI,OAAO,MAAM,EAAE,KAAKA,aAAY;AACpC;AAAA,IACF;AAGA,UAAM,eAAe,eAAwB;AAAA,MAC3C,OAAO;AAAA,QACL,MAAM;AAAA,QACN,SAAS,EAAE,OAAO;AAAA,QAClB,GAAG;AAAA,MACL;AAAA,MACA;AAAA,IACF,CAAC;AAED,QAAI,OAAO,MAAM,EAAE,KAAK,YAAY;AAAA,EACtC;AACF;","names":["responseData"]}

package/dist/esm/utils/errors/ErrorsClass.mjs

@@ -0,0 +1,40 @@
+import { HttpStatusCodes } from './../../utils/httpStatusCodes.mjs';
+import { t } from "express-intlayer";
+import { errorData } from './errorCodes.mjs';
+class AppError extends Error {
+  name;
+  isMultilingual = true;
+  errorKey;
+  message;
+  multilingualMessage;
+  httpStatusCode;
+  messageDetails;
+  /**
+   * Constructor for the custom error class.
+   * @param multilingualMessage - The error message which can be a simple string or a multilingual object.
+   * @param httpStatusCode - Optional HTTP status code, defaults to 500 Internal Server Error.
+   */
+  constructor(multilingualMessage, errorKey, httpStatusCode = HttpStatusCodes.INTERNAL_SERVER_ERROR_500, messageDetails) {
+    const message = t(multilingualMessage);
+    super(message);
+    this.message = message;
+    this.name = "AppError";
+    this.errorKey = errorKey;
+    this.multilingualMessage = multilingualMessage;
+    this.httpStatusCode = httpStatusCode;
+    this.messageDetails = messageDetails;
+    Error.captureStackTrace(this, this.constructor);
+  }
+}
+class GenericError extends AppError {
+  constructor(errorKey, messageDetails) {
+    const multilingualMessage = errorData[errorKey].message;
+    const httpStatusCode = errorData[errorKey].statusCode;
+    super(multilingualMessage, errorKey, httpStatusCode, messageDetails);
+  }
+}
+export {
+  AppError,
+  GenericError
+};
+//# sourceMappingURL=ErrorsClass.mjs.map

package/dist/esm/utils/errors/ErrorsClass.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/utils/errors/ErrorsClass.ts"],"sourcesContent":["import { HttpStatusCodes } from '@utils/httpStatusCodes';\n// @ts-ignore express-intlayer not build yet\nimport { t, type LanguageContent } from 'express-intlayer';\nimport { ErrorCodes, errorData } from './errorCodes';\n\n/**\n * Custom error class that extends the native JavaScript Error class.\n * This class supports multilingual error messages and HTTP status codes.\n */\nexport class AppError extends Error {\n  public name: string;\n  public isMultilingual: boolean = true;\n  public errorKey: string;\n  public message: string;\n  public multilingualMessage: LanguageContent<string>;\n  public httpStatusCode: HttpStatusCodes;\n  public messageDetails?: object;\n\n  /**\n   * Constructor for the custom error class.\n   * @param multilingualMessage - The error message which can be a simple string or a multilingual object.\n   * @param httpStatusCode - Optional HTTP status code, defaults to 500 Internal Server Error.\n   */\n  constructor(\n    multilingualMessage: LanguageContent<string>,\n    errorKey: string,\n    httpStatusCode: HttpStatusCodes = HttpStatusCodes.INTERNAL_SERVER_ERROR_500,\n    messageDetails?: object\n  ) {\n    const message = t(multilingualMessage); // Translate message based on current locale.\n\n    super(message); // Use translated message for the superclass constructor.\n    this.message = message;\n    this.name = 'AppError';\n    this.errorKey = errorKey;\n    this.multilingualMessage = multilingualMessage; // Store original message format for potential use.\n    this.httpStatusCode = httpStatusCode; // Set the HTTP status code.\n    this.messageDetails = messageDetails; // Store any additional message details.\n\n    // Capture the stack trace to exclude the constructor call.\n    Error.captureStackTrace(this, this.constructor);\n  }\n}\n\nexport class GenericError extends AppError {\n  constructor(errorKey: ErrorCodes, messageDetails?: object) {\n    const multilingualMessage = errorData[errorKey].message;\n    const httpStatusCode = errorData[errorKey].statusCode;\n\n    super(multilingualMessage, errorKey, httpStatusCode, messageDetails);\n  }\n}\n"],"mappings":"AAAA,SAAS,uBAAuB;AAEhC,SAAS,SAA+B;AACxC,SAAqB,iBAAiB;AAM/B,MAAM,iBAAiB,MAAM;AAAA,EAC3B;AAAA,EACA,iBAA0B;AAAA,EAC1B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOP,YACE,qBACA,UACA,iBAAkC,gBAAgB,2BAClD,gBACA;AACA,UAAM,UAAU,EAAE,mBAAmB;AAErC,UAAM,OAAO;AACb,SAAK,UAAU;AACf,SAAK,OAAO;AACZ,SAAK,WAAW;AAChB,SAAK,sBAAsB;AAC3B,SAAK,iBAAiB;AACtB,SAAK,iBAAiB;AAGtB,UAAM,kBAAkB,MAAM,KAAK,WAAW;AAAA,EAChD;AACF;AAEO,MAAM,qBAAqB,SAAS;AAAA,EACzC,YAAY,UAAsB,gBAAyB;AACzD,UAAM,sBAAsB,UAAU,QAAQ,EAAE;AAChD,UAAM,iBAAiB,UAAU,QAAQ,EAAE;AAE3C,UAAM,qBAAqB,UAAU,gBAAgB,cAAc;AAAA,EACrE;AACF;","names":[]}