arkos 1.4.0-canary.7 → 1.4.0-canary.71

package/dist/cjs/modules/base/utils/helpers/base.service.helpers.js

@@ -78,12 +78,13 @@ function handleRelationFieldsInBody(body, relationFields, ignoreActions = []) {
             else if (apiAction === "disconnect") {
                 disconnectData.push({ id: bodyField.id });
             }
-            else if (canBeUsedToConnect(field.type, bodyField)) {
+            else if (bodyField?.apiAction !== "update" &&
+                canBeUsedToConnect(field.type, bodyField)) {
                 const { apiAction, ...cleanedData } = bodyField;
                 throwErrorIfApiActionIsInvalid(apiAction);
                 connectData.push(cleanedData);
             }
-            else if (!bodyField?.id) {
+            else if (bodyField?.apiAction !== "update" && !bodyField?.id) {
                 let nestedRelations = getGroupedModelReations(field.type);
                 let dataToPush = { ...bodyField };
                 if (nestedRelations?.singular || nestedRelations?.list) {
@@ -97,7 +98,21 @@ function handleRelationFieldsInBody(body, relationFields, ignoreActions = []) {
                 createData.push(dataToPush);
             }
             else {
-                const { id, apiAction, ...data } = bodyField;
+                const { apiAction, ...data } = bodyField;
+                let foreignKeyFieldName = bodyField?.id ? "id" : "";
+                let foreignKeyFieldValue = bodyField?.id ? bodyField.id : "";
+                if (!foreignKeyFieldName) {
+                    for (const [key, value] of Object.entries(data)) {
+                        if (canBeUsedToConnect(field.type, { [key]: value })) {
+                            foreignKeyFieldName = key;
+                            break;
+                        }
+                    }
+                    if (!foreignKeyFieldName)
+                        throw new app_error_1.default("No unique fields to be used in the prisma where clause", 400, "NoFieldToIsInPrismaWhereClause", { data: body });
+                }
+                foreignKeyFieldValue = data[foreignKeyFieldName];
+                delete data[foreignKeyFieldName];
                 throwErrorIfApiActionIsInvalid(apiAction);
                 let nestedRelations = getGroupedModelReations(field.type);
                 let dataToPush = data;
@@ -105,7 +120,7 @@ function handleRelationFieldsInBody(body, relationFields, ignoreActions = []) {
                     dataToPush = handleRelationFieldsInBody(data, nestedRelations, ignoreActions);
                 }
                 updateData.push({
-                    where: { id },
+                    where: { [foreignKeyFieldName]: foreignKeyFieldValue },
                     data: dataToPush,
                 });
             }
@@ -138,12 +153,13 @@ function handleRelationFieldsInBody(body, relationFields, ignoreActions = []) {
         else if (relationData?.apiAction === "disconnect") {
             mutableBody[field.name] = { disconnect: true };
         }
-        else if (canBeUsedToConnect(field.type, relationData)) {
+        else if (relationData?.apiAction !== "update" &&
+            canBeUsedToConnect(field.type, relationData)) {
             const { apiAction, ...cleanedData } = relationData;
             throwErrorIfApiActionIsInvalid(apiAction);
             mutableBody[field.name] = { connect: cleanedData };
         }
-        else if (!relationData?.id) {
+        else if (relationData?.apiAction !== "update" && !relationData?.id) {
             let dataToCreate = { ...relationData };
             if (dataToCreate?.apiAction) {
                 const { apiAction, ...rest } = dataToCreate;

package/dist/cjs/modules/base/utils/helpers/base.service.helpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"base.service.helpers.js","sourceRoot":"","sources":["../../../../../../src/modules/base/utils/helpers/base.service.helpers.ts"],"names":[],"mappings":"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","sourcesContent":["import prismaSchemaParser from \"../../../../utils/prisma/prisma-schema-parser\";\nimport { PrismaField } from \"../../../../utils/prisma/types\";\nimport AppError from \"../../../error-handler/utils/app-error\";\n\n/**\n * Removes apiAction field from an object and all nested objects\n *\n * @param {Record<string, any>} obj - The object to clean\n * @returns {Record<string, any>} - The cleaned object\n */\nexport function removeApiAction(obj: Record<string, any>): Record<string, any> {\n  if (!obj || typeof obj !== \"object\") return obj;\n\n  const result: Record<string, any> = {};\n\n  for (const [key, value] of Object.entries(obj)) {\n    if (key === \"apiAction\") continue;\n\n    if (Array.isArray(value)) {\n      result[key] = value.map((item) =>\n        typeof item === \"object\" && item !== null ? removeApiAction(item) : item\n      );\n    } else if (typeof value === \"object\" && value !== null) {\n      result[key] = removeApiAction(value);\n    } else {\n      result[key] = value;\n    }\n  }\n\n  return result;\n}\n\nconst prismaOperations = [\n  \"create\",\n  \"connect\",\n  \"update\",\n  \"delete\",\n  \"disconnect\",\n  \"deleteMany\",\n  \"connectOrCreate\",\n  \"upsert\",\n  \"set\",\n];\n\n/**\n * Checks if an object is already formatted as a Prisma relation operation\n *\n * @param {Record<string, any>} obj - The object to check\n * @returns {boolean} - True if the object contains Prisma relation operations\n */\nexport function isPrismaRelationFormat(obj: Record<string, any>): boolean {\n  if (!obj || typeof obj !== \"object\") return false;\n\n  // Check if any key is a Prisma operation\n  return prismaOperations.some((op) => obj?.[op]);\n}\n\nexport function throwErrorIfApiActionIsInvalid(apiAction: string) {\n  if (apiAction && !prismaOperations.includes(apiAction))\n    throw Error(\n      `Validation Error: Unknown value \"${apiAction}\" for apiAction field, available values are ${prismaOperations.join(\", \")}.`\n    );\n}\n\n/**\n * Determines the appropriate Prisma operation (`create`, `connect`, `update`, `delete`, or `disconnect`)\n * for each relation field in the provided body based on its nested data and recursively does the same for each relation field.\n *\n * This function handles the following types of relations:\n * - **One-to-one**\n * - **One-to-many**\n *\n *\n * ### Operation Rules:\n *\n *\n * - **Create**: Used when the nested relation data is provided **without an `id` or unique field**.\n * - **Connect**: Used when the nested relation data contains **only an `id` or a unique field** (e.g., email).\n * - **Update**: Used when the nested relation data contains **both an `id` and additional fields**.\n * - **Delete**: Used when the nested relation data includes **`apiAction: \"delete\"`**.\n * - **Disconnect**: Used when the nested relation data includes **`apiAction: \"disconnect\"`**.\n *\n * The function will preserve existing Prisma operation formats if detected,\n * allowing developers to manually structure relation operations when needed.\n *\n * @param {Record<string, any>} body - The object containing relation fields to be processed.\n * @param {Object} relationFields - Defines relation field types.\n * @param {RelationFields[]} relationFields.singular - List of one-side relation field names (one-to-one).\n * @param {RelationFields[]} relationFields.list - List of many-side relation field names (one-to-many).\n * @param {string[]} ignoreActions - Optional list of apiAction values to ignore.\n * @returns {Record<string, any>} The transformed data with appropriate Prisma operations applied.\n */\nexport function handleRelationFieldsInBody(\n  body: Record<string, any>,\n  relationFields: ModelGroupRelationFields,\n  ignoreActions: string[] = []\n) {\n  let mutableBody = { ...body };\n\n  relationFields?.list?.forEach((field) => {\n    if (!body?.[field.name]) return;\n\n    if (ignoreActions?.includes?.(body[field.name]?.apiAction)) {\n      delete mutableBody[field.name];\n      return;\n    }\n\n    if (isPrismaRelationFormat(body[field.name])) return;\n\n    if (!Array.isArray(body[field.name])) return;\n\n    const createData: any[] = [];\n    const connectData: any[] = [];\n    const updateData: any[] = [];\n    const disconnectData: any[] = [];\n    const deleteManyIds: any[] = [];\n\n    body[field.name]?.forEach((bodyField: any) => {\n      if (ignoreActions?.includes?.(bodyField?.apiAction)) return;\n\n      const apiAction = bodyField?.apiAction;\n\n      throwErrorIfApiActionIsInvalid(apiAction);\n\n      if (apiAction === \"delete\") {\n        deleteManyIds.push(bodyField.id);\n      } else if (apiAction === \"disconnect\") {\n        disconnectData.push({ id: bodyField.id });\n      } else if (canBeUsedToConnect(field.type, bodyField)) {\n        const { apiAction, ...cleanedData } = bodyField;\n\n        throwErrorIfApiActionIsInvalid(apiAction);\n        connectData.push(cleanedData);\n      } else if (!bodyField?.id) {\n        let nestedRelations = getGroupedModelReations(field.type);\n\n        let dataToPush = { ...bodyField };\n\n        if (nestedRelations?.singular || nestedRelations?.list) {\n          dataToPush = handleRelationFieldsInBody(\n            dataToPush,\n            nestedRelations,\n            ignoreActions\n          );\n        }\n\n        if (dataToPush?.apiAction) {\n          const { apiAction, ...rest } = dataToPush;\n\n          throwErrorIfApiActionIsInvalid(apiAction);\n          dataToPush = rest;\n        }\n\n        createData.push(dataToPush);\n      } else {\n        const { id, apiAction, ...data } = bodyField;\n\n        throwErrorIfApiActionIsInvalid(apiAction);\n        let nestedRelations = getGroupedModelReations(field.type);\n\n        let dataToPush = data;\n        if (nestedRelations?.singular || nestedRelations?.list) {\n          dataToPush = handleRelationFieldsInBody(\n            data,\n            nestedRelations,\n            ignoreActions\n          );\n        }\n\n        updateData.push({\n          where: { id },\n          data: dataToPush,\n        });\n      }\n    });\n\n    mutableBody[field.name] = {\n      ...(createData.length ? { create: createData } : {}),\n      ...(connectData.length ? { connect: connectData } : {}),\n      ...(updateData.length ? { update: updateData } : {}),\n      ...(disconnectData.length ? { disconnect: disconnectData } : {}),\n      ...(deleteManyIds.length\n        ? { deleteMany: { id: { in: deleteManyIds } } }\n        : {}),\n    };\n  });\n\n  relationFields?.singular?.forEach((field) => {\n    if (!body?.[field.name]) return;\n\n    if (ignoreActions?.includes?.(body[field.name]?.apiAction)) {\n      delete mutableBody[field.name];\n      return;\n    }\n\n    if (isPrismaRelationFormat(body[field.name])) {\n      return;\n    }\n\n    const relationData = body[field.name];\n    let nestedRelations = getGroupedModelReations(field.type);\n\n    if (relationData?.apiAction === \"delete\") {\n      mutableBody[field.name] = { delete: true };\n    } else if (relationData?.apiAction === \"disconnect\") {\n      mutableBody[field.name] = { disconnect: true };\n    } else if (canBeUsedToConnect(field.type, relationData)) {\n      const { apiAction, ...cleanedData } = relationData;\n\n      throwErrorIfApiActionIsInvalid(apiAction);\n\n      mutableBody[field.name] = { connect: cleanedData };\n    } else if (!relationData?.id) {\n      let dataToCreate = { ...relationData };\n\n      if (dataToCreate?.apiAction) {\n        const { apiAction, ...rest } = dataToCreate;\n        throwErrorIfApiActionIsInvalid(apiAction);\n\n        dataToCreate = rest;\n      }\n\n      if (nestedRelations?.singular || nestedRelations?.list) {\n        dataToCreate = handleRelationFieldsInBody(\n          dataToCreate,\n          nestedRelations,\n          ignoreActions\n        );\n      }\n\n      mutableBody[field.name] = { create: dataToCreate };\n    } else {\n      // If ID and other fields, assume update operation\n      const { id, apiAction, ...data } = relationData;\n\n      throwErrorIfApiActionIsInvalid(apiAction);\n\n      let dataToUpdate = data;\n      if (nestedRelations?.singular || nestedRelations?.list) {\n        dataToUpdate = handleRelationFieldsInBody(\n          data,\n          nestedRelations,\n          ignoreActions\n        );\n      }\n\n      mutableBody[field.name] = {\n        update: {\n          where: { id },\n          data: dataToUpdate,\n        },\n      };\n    }\n  });\n\n  if (mutableBody?.apiAction) {\n    throw new AppError(\n      \"Validation Error: Invalid usage of apiAction field, it must only be used on relation fields whether single or multiple.\",\n      500,\n      {\n        data: {\n          ...body,\n        },\n      }\n    );\n  }\n\n  // As a final step, recursively remove any remaining apiAction fields\n  return removeApiAction(mutableBody);\n}\n\nexport type ModelGroupRelationFields = ReturnType<\n  typeof getGroupedModelReations\n>;\n\nfunction getGroupedModelReations(modelName: string) {\n  const relationsFields = prismaSchemaParser.getModelRelations(modelName);\n\n  return {\n    singular: relationsFields?.filter(\n      (field) => field.isRelation && !field.isArray\n    ),\n    list: relationsFields?.filter((field) => field.isRelation && field.isArray),\n  };\n}\n\n/**\n * Checks if a field value can be used to connect to a model\n * This happens when the field contains only an ID or a single unique field\n *\n * @param {string} modelName - The model name to get unique fields for\n * @param {Record<string, any>} bodyField - The field value from the body\n * @returns {boolean} True if the field can be used for a connect operation\n */\nexport function canBeUsedToConnect(\n  modelName: string,\n  bodyField: Record<string, any> | undefined | null\n): boolean {\n  if (!bodyField) return false;\n\n  if (bodyField.apiAction && ![\"connect\"]?.includes?.(bodyField.apiAction))\n    return false;\n\n  if (bodyField.apiAction === \"connect\") return true;\n\n  if (Object.keys(bodyField)?.length === 1 && bodyField?.id) return true;\n\n  const uniqueFields = prismaSchemaParser.getModelUniqueFields(modelName) || [];\n\n  // If the field has exactly one property and it's a unique field, it can be used to connect\n  if (Object.keys(bodyField).length === 1 && uniqueFields?.length > 0) {\n    const fieldName = Object.keys(bodyField)[0];\n    return uniqueFields?.some((field: PrismaField) => field.name === fieldName);\n  }\n\n  return false;\n}\n"]}
+{"version":3,"file":"base.service.helpers.js","sourceRoot":"","sources":["../../../../../../src/modules/base/utils/helpers/base.service.helpers.ts"],"names":[],"mappings":"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","sourcesContent":["import prismaSchemaParser from \"../../../../utils/prisma/prisma-schema-parser\";\nimport { PrismaField } from \"../../../../utils/prisma/types\";\nimport AppError from \"../../../error-handler/utils/app-error\";\n\n/**\n * Removes apiAction field from an object and all nested objects\n *\n * @param {Record<string, any>} obj - The object to clean\n * @returns {Record<string, any>} - The cleaned object\n */\nexport function removeApiAction(obj: Record<string, any>): Record<string, any> {\n  if (!obj || typeof obj !== \"object\") return obj;\n\n  const result: Record<string, any> = {};\n\n  for (const [key, value] of Object.entries(obj)) {\n    if (key === \"apiAction\") continue;\n\n    if (Array.isArray(value)) {\n      result[key] = value.map((item) =>\n        typeof item === \"object\" && item !== null ? removeApiAction(item) : item\n      );\n    } else if (typeof value === \"object\" && value !== null) {\n      result[key] = removeApiAction(value);\n    } else {\n      result[key] = value;\n    }\n  }\n\n  return result;\n}\n\nconst prismaOperations = [\n  \"create\",\n  \"connect\",\n  \"update\",\n  \"delete\",\n  \"disconnect\",\n  \"deleteMany\",\n  \"connectOrCreate\",\n  \"upsert\",\n  \"set\",\n];\n\n/**\n * Checks if an object is already formatted as a Prisma relation operation\n *\n * @param {Record<string, any>} obj - The object to check\n * @returns {boolean} - True if the object contains Prisma relation operations\n */\nexport function isPrismaRelationFormat(obj: Record<string, any>): boolean {\n  if (!obj || typeof obj !== \"object\") return false;\n\n  // Check if any key is a Prisma operation\n  return prismaOperations.some((op) => obj?.[op]);\n}\n\nexport function throwErrorIfApiActionIsInvalid(apiAction: string) {\n  if (apiAction && !prismaOperations.includes(apiAction))\n    throw Error(\n      `Validation Error: Unknown value \"${apiAction}\" for apiAction field, available values are ${prismaOperations.join(\", \")}.`\n    );\n}\n\n/**\n * Determines the appropriate Prisma operation (`create`, `connect`, `update`, `delete`, or `disconnect`)\n * for each relation field in the provided body based on its nested data and recursively does the same for each relation field.\n *\n * This function handles the following types of relations:\n * - **One-to-one**\n * - **One-to-many**\n *\n *\n * ### Operation Rules:\n *\n *\n * - **Create**: Used when the nested relation data is provided **without an `id` or unique field**.\n * - **Connect**: Used when the nested relation data contains **only an `id` or a unique field** (e.g., email).\n * - **Update**: Used when the nested relation data contains **both an `id` and additional fields**.\n * - **Delete**: Used when the nested relation data includes **`apiAction: \"delete\"`**.\n * - **Disconnect**: Used when the nested relation data includes **`apiAction: \"disconnect\"`**.\n *\n * The function will preserve existing Prisma operation formats if detected,\n * allowing developers to manually structure relation operations when needed.\n *\n * @param {Record<string, any>} body - The object containing relation fields to be processed.\n * @param {Object} relationFields - Defines relation field types.\n * @param {RelationFields[]} relationFields.singular - List of one-side relation field names (one-to-one).\n * @param {RelationFields[]} relationFields.list - List of many-side relation field names (one-to-many).\n * @param {string[]} ignoreActions - Optional list of apiAction values to ignore.\n * @returns {Record<string, any>} The transformed data with appropriate Prisma operations applied.\n */\nexport function handleRelationFieldsInBody(\n  body: Record<string, any>,\n  relationFields: ModelGroupRelationFields,\n  ignoreActions: string[] = []\n) {\n  let mutableBody = { ...body };\n\n  relationFields?.list?.forEach((field) => {\n    if (!body?.[field.name]) return;\n\n    if (ignoreActions?.includes?.(body[field.name]?.apiAction)) {\n      delete mutableBody[field.name];\n      return;\n    }\n\n    if (isPrismaRelationFormat(body[field.name])) return;\n\n    if (!Array.isArray(body[field.name])) return;\n\n    const createData: any[] = [];\n    const connectData: any[] = [];\n    const updateData: any[] = [];\n    const disconnectData: any[] = [];\n    const deleteManyIds: any[] = [];\n\n    body[field.name]?.forEach((bodyField: any) => {\n      if (ignoreActions?.includes?.(bodyField?.apiAction)) return;\n\n      const apiAction = bodyField?.apiAction;\n\n      throwErrorIfApiActionIsInvalid(apiAction);\n\n      if (apiAction === \"delete\") {\n        deleteManyIds.push(bodyField.id);\n      } else if (apiAction === \"disconnect\") {\n        disconnectData.push({ id: bodyField.id });\n      } else if (\n        bodyField?.apiAction !== \"update\" &&\n        canBeUsedToConnect(field.type, bodyField)\n      ) {\n        const { apiAction, ...cleanedData } = bodyField;\n\n        throwErrorIfApiActionIsInvalid(apiAction);\n        connectData.push(cleanedData);\n      } else if (bodyField?.apiAction !== \"update\" && !bodyField?.id) {\n        let nestedRelations = getGroupedModelReations(field.type);\n\n        let dataToPush = { ...bodyField };\n\n        if (nestedRelations?.singular || nestedRelations?.list) {\n          dataToPush = handleRelationFieldsInBody(\n            dataToPush,\n            nestedRelations,\n            ignoreActions\n          );\n        }\n\n        if (dataToPush?.apiAction) {\n          const { apiAction, ...rest } = dataToPush;\n\n          throwErrorIfApiActionIsInvalid(apiAction);\n          dataToPush = rest;\n        }\n\n        createData.push(dataToPush);\n      } else {\n        const { apiAction, ...data } = bodyField;\n        let foreignKeyFieldName = bodyField?.id ? \"id\" : \"\";\n        let foreignKeyFieldValue = bodyField?.id ? bodyField.id : \"\";\n\n        if (!foreignKeyFieldName) {\n          for (const [key, value] of Object.entries(data)) {\n            if (canBeUsedToConnect(field.type, { [key]: value })) {\n              foreignKeyFieldName = key;\n              break;\n            }\n          }\n\n          if (!foreignKeyFieldName)\n            throw new AppError(\n              \"No unique fields to be used in the prisma where clause\",\n              400,\n              \"NoFieldToIsInPrismaWhereClause\",\n              { data: body }\n            );\n        }\n\n        foreignKeyFieldValue = data[foreignKeyFieldName];\n        delete data[foreignKeyFieldName];\n\n        throwErrorIfApiActionIsInvalid(apiAction);\n        let nestedRelations = getGroupedModelReations(field.type);\n\n        let dataToPush = data;\n        if (nestedRelations?.singular || nestedRelations?.list) {\n          dataToPush = handleRelationFieldsInBody(\n            data,\n            nestedRelations,\n            ignoreActions\n          );\n        }\n\n        updateData.push({\n          where: { [foreignKeyFieldName]: foreignKeyFieldValue },\n          data: dataToPush,\n        });\n      }\n    });\n\n    mutableBody[field.name] = {\n      ...(createData.length ? { create: createData } : {}),\n      ...(connectData.length ? { connect: connectData } : {}),\n      ...(updateData.length ? { update: updateData } : {}),\n      ...(disconnectData.length ? { disconnect: disconnectData } : {}),\n      ...(deleteManyIds.length\n        ? { deleteMany: { id: { in: deleteManyIds } } }\n        : {}),\n    };\n  });\n\n  relationFields?.singular?.forEach((field) => {\n    if (!body?.[field.name]) return;\n\n    if (ignoreActions?.includes?.(body[field.name]?.apiAction)) {\n      delete mutableBody[field.name];\n      return;\n    }\n\n    if (isPrismaRelationFormat(body[field.name])) {\n      return;\n    }\n\n    const relationData = body[field.name];\n    let nestedRelations = getGroupedModelReations(field.type);\n\n    if (relationData?.apiAction === \"delete\") {\n      mutableBody[field.name] = { delete: true };\n    } else if (relationData?.apiAction === \"disconnect\") {\n      mutableBody[field.name] = { disconnect: true };\n    } else if (\n      relationData?.apiAction !== \"update\" &&\n      canBeUsedToConnect(field.type, relationData)\n    ) {\n      const { apiAction, ...cleanedData } = relationData;\n\n      throwErrorIfApiActionIsInvalid(apiAction);\n\n      mutableBody[field.name] = { connect: cleanedData };\n    } else if (relationData?.apiAction !== \"update\" && !relationData?.id) {\n      let dataToCreate = { ...relationData };\n\n      if (dataToCreate?.apiAction) {\n        const { apiAction, ...rest } = dataToCreate;\n        throwErrorIfApiActionIsInvalid(apiAction);\n\n        dataToCreate = rest;\n      }\n\n      if (nestedRelations?.singular || nestedRelations?.list) {\n        dataToCreate = handleRelationFieldsInBody(\n          dataToCreate,\n          nestedRelations,\n          ignoreActions\n        );\n      }\n\n      mutableBody[field.name] = { create: dataToCreate };\n    } else {\n      // If ID and other fields, assume update operation\n      const { id, apiAction, ...data } = relationData;\n\n      throwErrorIfApiActionIsInvalid(apiAction);\n\n      let dataToUpdate = data;\n      if (nestedRelations?.singular || nestedRelations?.list) {\n        dataToUpdate = handleRelationFieldsInBody(\n          data,\n          nestedRelations,\n          ignoreActions\n        );\n      }\n\n      mutableBody[field.name] = {\n        update: {\n          where: { id },\n          data: dataToUpdate,\n        },\n      };\n    }\n  });\n\n  if (mutableBody?.apiAction) {\n    throw new AppError(\n      \"Validation Error: Invalid usage of apiAction field, it must only be used on relation fields whether single or multiple.\",\n      500,\n      {\n        data: {\n          ...body,\n        },\n      }\n    );\n  }\n\n  // As a final step, recursively remove any remaining apiAction fields\n  return removeApiAction(mutableBody);\n}\n\nexport type ModelGroupRelationFields = ReturnType<\n  typeof getGroupedModelReations\n>;\n\nfunction getGroupedModelReations(modelName: string) {\n  const relationsFields = prismaSchemaParser.getModelRelations(modelName);\n\n  return {\n    singular: relationsFields?.filter(\n      (field) => field.isRelation && !field.isArray\n    ),\n    list: relationsFields?.filter((field) => field.isRelation && field.isArray),\n  };\n}\n\n/**\n * Checks if a field value can be used to connect to a model\n * This happens when the field contains only an ID or a single unique field\n *\n * @param {string} modelName - The model name to get unique fields for\n * @param {Record<string, any>} bodyField - The field value from the body\n * @returns {boolean} True if the field can be used for a connect operation\n */\nexport function canBeUsedToConnect(\n  modelName: string,\n  bodyField: Record<string, any> | undefined | null\n): boolean {\n  if (!bodyField) return false;\n\n  if (bodyField.apiAction && ![\"connect\"]?.includes?.(bodyField.apiAction))\n    return false;\n\n  if (bodyField.apiAction === \"connect\") return true;\n\n  if (Object.keys(bodyField)?.length === 1 && bodyField?.id) return true;\n\n  const uniqueFields = prismaSchemaParser.getModelUniqueFields(modelName) || [];\n\n  if (Object.keys(bodyField).length === 1 && uniqueFields?.length > 0) {\n    const fieldName = Object.keys(bodyField)[0];\n    return uniqueFields?.some((field: PrismaField) => field.name === fieldName);\n  }\n\n  return false;\n}\n"]}

package/dist/cjs/modules/debugger/debugger.service.js

@@ -53,26 +53,33 @@ ${sheu_1.default.bold("Ending:")} ${moduleName}\n`);
                 timestamp: true,
             });
     }
-    logLevel2RequestInfo(req, _, next) {
+    logRequestInfo(req, _, next) {
         const config = (0, server_1.getArkosConfig)();
         const debugLevel = config.debugging?.requests?.level || 0;
+        const filter = config.debugging?.requests?.filter;
+        function shouldLog(inputName) {
+            const hasFilter = (filter?.length || 0) > 0;
+            if (!hasFilter)
+                return true;
+            return filter?.includes(inputName);
+        }
         if (debugLevel < 2)
             return next();
         if (req.modelName)
             sheu_1.default.debug(`Prisma Model Module\n${req.modelName}`, { timestamp: true });
-        if (Object.keys(req.query).length > 0)
+        if (Object.keys(req.params).length > 0 && shouldLog("Params"))
             sheu_1.default.debug(`Original Request Params (req.params)\n${JSON.stringify(req.params || {}, null, 2)}`, { timestamp: true });
         else
             sheu_1.default.debug(`Original Request Params (req.params) - Empty`, {
                 timestamp: true,
             });
-        if (req.body && Object.keys(req.body).length > 0)
+        if (req.body && Object.keys(req.body).length > 0 && shouldLog("Body"))
             sheu_1.default.debug(`Original Request Body (req.body)\n${JSON.stringify(req.body, null, 2)}`, { timestamp: true });
         else
             sheu_1.default.debug(`Original Request Body (req.body) - Empty`, {
                 timestamp: true,
             });
-        if (Object.keys(req.query).length > 0)
+        if (Object.keys(req.query).length > 0 && shouldLog("Query"))
             sheu_1.default.debug(`Original Request Query (req.query)\n${JSON.stringify(req.query || {}, null, 2)}`, { timestamp: true });
         else
             sheu_1.default.debug(`Original Request Query (req.query) - Empty`, {

package/dist/cjs/modules/debugger/debugger.service.js.map

@@ -1 +1 @@
-{"version":3,"file":"debugger.service.js","sourceRoot":"","sources":["../../../../src/modules/debugger/debugger.service.ts"],"names":[],"mappings":";;;;;AAAA,4DAAoC;AAGpC,gDAAwB;AACxB,+DAAqD;AACrD,gGAAsE;AAEtE,yCAA8C;AAE9C,MAAM,eAAe;IACnB,oBAAoB,CAAC,UAAkB,EAAE,MAAc;QACrD,MAAM,MAAM,GAAG,IAAA,uBAAc,GAAE,CAAC;QAChC,MAAM,UAAU,GAAG,MAAM,CAAC,SAAS,EAAE,aAAa,EAAE,KAAK,IAAI,CAAC,CAAC;QAC/D,IAAI,UAAU,GAAG,CAAC;YAAE,OAAO;QAE3B,MAAM,gBAAgB,GAAG,MAAM,CAAC,SAAS,EAAE,aAAa,EAAE,OAAO,EAAE,OAAO,CAAC;QAC3E,IACE,CAAC,gBAAgB,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC;YACxC,CAAC,gBAAgB,EAAE,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAC/B,UAAU,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CACxD;YAED,OAAO;QAET,cAAI,CAAC,KAAK,CAAC,GAAG,cAAI,CAAC,IAAI,CAAC,sBAAsB,CAAC,IAAI,UAAU,EAAE,CAAC,CAAC;QACjE,cAAI,CAAC,KAAK,CAAC,cAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAC/D,CAAC;IAED,iCAAiC,CAC/B,UAIG;QAEH,MAAM,MAAM,GAAG,IAAA,uBAAc,GAAE,CAAC;QAChC,MAAM,UAAU,GAAG,MAAM,CAAC,SAAS,EAAE,aAAa,EAAE,KAAK,IAAI,CAAC,CAAC;QAE/D,IAAI,UAAU,GAAG,CAAC;YAAE,OAAO;QAC3B,cAAI,CAAC,KAAK,CAAC,GAAG,cAAI,CAAC,IAAI,CAAC,2BAA2B,CAAC,EAAE,EAAE;YACtD,SAAS,EAAE,IAAI;SAChB,CAAC,CAAC;QAEH,MAAM,gBAAgB,GAAG,MAAM,CAAC,SAAS,EAAE,aAAa,EAAE,OAAO,EAAE,OAAO,CAAC;QAE3E,UAAU,CAAC,OAAO,CAAC,CAAC,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,EAAE,EAAE;YAC3D,IACE,CAAC,gBAAgB,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC;gBACxC,CAAC,gBAAgB,EAAE,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAC/B,UAAU,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CACxD;gBAED,OAAO;YAET,cAAI,CAAC,KAAK,CAAC,KAAK,cAAI,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,UAAU;EACtD,cAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,SAAS,CAAC,OAAO,CAAC,IAAA,gBAAG,GAAE,EAAE,EAAE,CAAC;EAClD,cAAI,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,kCAAsB,CAAC,qBAAqB,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,UAAU,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,kCAAsB,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE;EACzL,cAAI,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,UAAU,IAAI,CAAC,CAAC;QACtC,CAAC,CAAC,CAAC;IACL,CAAC;IAED,yBAAyB,CAAC,gBAAqC;QAC7D,MAAM,MAAM,GAAG,IAAA,uBAAc,GAAE,CAAC;QAChC,MAAM,UAAU,GAAG,MAAM,CAAC,SAAS,EAAE,QAAQ,EAAE,KAAK,IAAI,CAAC,CAAC;QAC1D,IAAI,UAAU,GAAG,CAAC;YAAE,OAAO;QAE3B,IAAI,gBAAgB,IAAI,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACjE,cAAI,CAAC,KAAK,CACR,mCAAmC,IAAI,CAAC,SAAS,CAAC,gBAAgB,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAC9E,EAAE,SAAS,EAAE,IAAI,EAAE,CACpB,CAAC;QACJ,CAAC;;YACC,cAAI,CAAC,KAAK,CAAC,wCAAwC,EAAE;gBACnD,SAAS,EAAE,IAAI;aAChB,CAAC,CAAC;IACP,CAAC;IAED,oBAAoB,CAClB,GAAiB,EACjB,CAAgB,EAChB,IAAuB;QAEvB,MAAM,MAAM,GAAG,IAAA,uBAAc,GAAE,CAAC;QAChC,MAAM,UAAU,GAAG,MAAM,CAAC,SAAS,EAAE,QAAQ,EAAE,KAAK,IAAI,CAAC,CAAC;QAC1D,IAAI,UAAU,GAAG,CAAC;YAAE,OAAO,IAAI,EAAE,CAAC;QAElC,IAAI,GAAG,CAAC,SAAS;YACf,cAAI,CAAC,KAAK,CAAC,wBAAwB,GAAG,CAAC,SAAS,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAE3E,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,CAAC;YACnC,cAAI,CAAC,KAAK,CACR,yCAAyC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EACpF,EAAE,SAAS,EAAE,IAAI,EAAE,CACpB,CAAC;;YAEF,cAAI,CAAC,KAAK,CAAC,8CAA8C,EAAE;gBACzD,SAAS,EAAE,IAAI;aAChB,CAAC,CAAC;QAEL,IAAI,GAAG,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC;YAC9C,cAAI,CAAC,KAAK,CACR,qCAAqC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EACxE,EAAE,SAAS,EAAE,IAAI,EAAE,CACpB,CAAC;;YAEF,cAAI,CAAC,KAAK,CAAC,0CAA0C,EAAE;gBACrD,SAAS,EAAE,IAAI;aAChB,CAAC,CAAC;QAEL,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,CAAC;YACnC,cAAI,CAAC,KAAK,CACR,uCAAuC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EACjF,EAAE,SAAS,EAAE,IAAI,EAAE,CACpB,CAAC;;YAEF,cAAI,CAAC,KAAK,CAAC,4CAA4C,EAAE;gBACvD,SAAS,EAAE,IAAI;aAChB,CAAC,CAAC;QAEL,IAAI,EAAE,CAAC;IACT,CAAC;CACF;AAED,MAAM,eAAe,GAAG,IAAI,eAAe,EAAE,CAAC;AAE9C,kBAAe,eAAe,CAAC","sourcesContent":["import sheu from \"../../utils/sheu\";\nimport { ArkosNextFunction, ArkosRequest, ArkosResponse } from \"../../exports\";\nimport { ModuleComponents } from \"../../utils/dynamic-loader\";\nimport util from \"util\";\nimport { crd } from \"../../utils/helpers/fs.helpers\";\nimport loadedComponentsLogger from \"./utils/loaded-components-logger\";\nimport { Router } from \"express\";\nimport { getArkosConfig } from \"../../server\";\n\nclass DebuggerService {\n  logModuleFinalRouter(moduleName: string, router: Router) {\n    const config = getArkosConfig();\n    const debugLevel = config.debugging?.dynamicLoader?.level || 0;\n    if (debugLevel < 3) return;\n\n    const moduleNameFilter = config.debugging?.dynamicLoader?.filters?.modules;\n    if (\n      (moduleNameFilter?.[0]?.length || 0) > 0 &&\n      !moduleNameFilter?.some((name) =>\n        moduleName.toLowerCase().startsWith(name.toLowerCase())\n      )\n    )\n      return;\n\n    sheu.debug(`${sheu.bold(\"Final Router Module:\")} ${moduleName}`);\n    sheu.print(util.inspect(router, { depth: 2, colors: true }));\n  }\n\n  logDynamicLoadedModulesComponents(\n    appModules: {\n      moduleName: string;\n      moduleDir: string;\n      components: ModuleComponents;\n    }[]\n  ) {\n    const config = getArkosConfig();\n    const debugLevel = config.debugging?.dynamicLoader?.level || 0;\n\n    if (debugLevel < 1) return;\n    sheu.debug(`${sheu.bold(\"Dynamic Loader Components\")}`, {\n      timestamp: true,\n    });\n\n    const moduleNameFilter = config.debugging?.dynamicLoader?.filters?.modules;\n\n    appModules.forEach(({ moduleName, moduleDir, components }) => {\n      if (\n        (moduleNameFilter?.[0]?.length || 0) > 0 &&\n        !moduleNameFilter?.some((name) =>\n          moduleName.toLowerCase().startsWith(name.toLowerCase())\n        )\n      )\n        return;\n\n      sheu.print(`\\n${sheu.bold(\"Module:\")} ${moduleName}\n${sheu.bold(\"Path:\")} ${moduleDir.replace(crd(), \"\")}\n${sheu.bold(\"Components:\")} ${loadedComponentsLogger.getComponentsNameList(moduleName, components).join(\", \")}${debugLevel >= 2 ? `\\n${loadedComponentsLogger.getLogText(components)}` : \"\"}\n${sheu.bold(\"Ending:\")} ${moduleName}\\n`);\n    });\n  }\n\n  handleTransformedQueryLog(transformedQuery: Record<string, any>) {\n    const config = getArkosConfig();\n    const debugLevel = config.debugging?.requests?.level || 0;\n    if (debugLevel < 2) return;\n\n    if (transformedQuery && Object.keys(transformedQuery).length > 0) {\n      sheu.debug(\n        `Transformed Request Parameters\\n${JSON.stringify(transformedQuery, null, 2)}`,\n        { timestamp: true }\n      );\n    } else\n      sheu.debug(`Transformed Request Parameters - Empty`, {\n        timestamp: true,\n      });\n  }\n\n  logLevel2RequestInfo(\n    req: ArkosRequest,\n    _: ArkosResponse,\n    next: ArkosNextFunction\n  ): void {\n    const config = getArkosConfig();\n    const debugLevel = config.debugging?.requests?.level || 0;\n    if (debugLevel < 2) return next();\n\n    if (req.modelName)\n      sheu.debug(`Prisma Model Module\\n${req.modelName}`, { timestamp: true });\n\n    if (Object.keys(req.query).length > 0)\n      sheu.debug(\n        `Original Request Params (req.params)\\n${JSON.stringify(req.params || {}, null, 2)}`,\n        { timestamp: true }\n      );\n    else\n      sheu.debug(`Original Request Params (req.params) - Empty`, {\n        timestamp: true,\n      });\n\n    if (req.body && Object.keys(req.body).length > 0)\n      sheu.debug(\n        `Original Request Body (req.body)\\n${JSON.stringify(req.body, null, 2)}`,\n        { timestamp: true }\n      );\n    else\n      sheu.debug(`Original Request Body (req.body) - Empty`, {\n        timestamp: true,\n      });\n\n    if (Object.keys(req.query).length > 0)\n      sheu.debug(\n        `Original Request Query (req.query)\\n${JSON.stringify(req.query || {}, null, 2)}`,\n        { timestamp: true }\n      );\n    else\n      sheu.debug(`Original Request Query (req.query) - Empty`, {\n        timestamp: true,\n      });\n\n    next();\n  }\n}\n\nconst debuggerService = new DebuggerService();\n\nexport default debuggerService;\n"]}
+{"version":3,"file":"debugger.service.js","sourceRoot":"","sources":["../../../../src/modules/debugger/debugger.service.ts"],"names":[],"mappings":"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","sourcesContent":["import sheu from \"../../utils/sheu\";\nimport { ArkosNextFunction, ArkosRequest, ArkosResponse } from \"../../exports\";\nimport { ModuleComponents } from \"../../utils/dynamic-loader\";\nimport util from \"util\";\nimport { crd } from \"../../utils/helpers/fs.helpers\";\nimport loadedComponentsLogger from \"./utils/loaded-components-logger\";\nimport { Router } from \"express\";\nimport { getArkosConfig } from \"../../server\";\n\nclass DebuggerService {\n  logModuleFinalRouter(moduleName: string, router: Router) {\n    const config = getArkosConfig();\n    const debugLevel = config.debugging?.dynamicLoader?.level || 0;\n    if (debugLevel < 3) return;\n\n    const moduleNameFilter = config.debugging?.dynamicLoader?.filters?.modules;\n    if (\n      (moduleNameFilter?.[0]?.length || 0) > 0 &&\n      !moduleNameFilter?.some((name) =>\n        moduleName.toLowerCase().startsWith(name.toLowerCase())\n      )\n    )\n      return;\n\n    sheu.debug(`${sheu.bold(\"Final Router Module:\")} ${moduleName}`);\n    sheu.print(util.inspect(router, { depth: 2, colors: true }));\n  }\n\n  logDynamicLoadedModulesComponents(\n    appModules: {\n      moduleName: string;\n      moduleDir: string;\n      components: ModuleComponents;\n    }[]\n  ) {\n    const config = getArkosConfig();\n    const debugLevel = config.debugging?.dynamicLoader?.level || 0;\n\n    if (debugLevel < 1) return;\n    sheu.debug(`${sheu.bold(\"Dynamic Loader Components\")}`, {\n      timestamp: true,\n    });\n\n    const moduleNameFilter = config.debugging?.dynamicLoader?.filters?.modules;\n\n    appModules.forEach(({ moduleName, moduleDir, components }) => {\n      if (\n        (moduleNameFilter?.[0]?.length || 0) > 0 &&\n        !moduleNameFilter?.some((name) =>\n          moduleName.toLowerCase().startsWith(name.toLowerCase())\n        )\n      )\n        return;\n\n      sheu.print(`\\n${sheu.bold(\"Module:\")} ${moduleName}\n${sheu.bold(\"Path:\")} ${moduleDir.replace(crd(), \"\")}\n${sheu.bold(\"Components:\")} ${loadedComponentsLogger.getComponentsNameList(moduleName, components).join(\", \")}${debugLevel >= 2 ? `\\n${loadedComponentsLogger.getLogText(components)}` : \"\"}\n${sheu.bold(\"Ending:\")} ${moduleName}\\n`);\n    });\n  }\n\n  handleTransformedQueryLog(transformedQuery: Record<string, any>) {\n    const config = getArkosConfig();\n    const debugLevel = config.debugging?.requests?.level || 0;\n    if (debugLevel < 2) return;\n\n    if (transformedQuery && Object.keys(transformedQuery).length > 0) {\n      sheu.debug(\n        `Transformed Request Parameters\\n${JSON.stringify(transformedQuery, null, 2)}`,\n        { timestamp: true }\n      );\n    } else\n      sheu.debug(`Transformed Request Parameters - Empty`, {\n        timestamp: true,\n      });\n  }\n\n  logRequestInfo(\n    req: ArkosRequest,\n    _: ArkosResponse,\n    next: ArkosNextFunction\n  ): void {\n    const config = getArkosConfig();\n    const debugLevel = config.debugging?.requests?.level || 0;\n    const filter = config.debugging?.requests?.filter;\n\n    function shouldLog(inputName: any) {\n      const hasFilter = (filter?.length || 0) > 0;\n      if (!hasFilter) return true;\n      return filter?.includes(inputName);\n    }\n\n    if (debugLevel < 2) return next();\n\n    if (req.modelName)\n      sheu.debug(`Prisma Model Module\\n${req.modelName}`, { timestamp: true });\n\n    if (Object.keys(req.params).length > 0 && shouldLog(\"Params\"))\n      sheu.debug(\n        `Original Request Params (req.params)\\n${JSON.stringify(req.params || {}, null, 2)}`,\n        { timestamp: true }\n      );\n    else\n      sheu.debug(`Original Request Params (req.params) - Empty`, {\n        timestamp: true,\n      });\n\n    if (req.body && Object.keys(req.body).length > 0 && shouldLog(\"Body\"))\n      sheu.debug(\n        `Original Request Body (req.body)\\n${JSON.stringify(req.body, null, 2)}`,\n        { timestamp: true }\n      );\n    else\n      sheu.debug(`Original Request Body (req.body) - Empty`, {\n        timestamp: true,\n      });\n\n    if (Object.keys(req.query).length > 0 && shouldLog(\"Query\"))\n      sheu.debug(\n        `Original Request Query (req.query)\\n${JSON.stringify(req.query || {}, null, 2)}`,\n        { timestamp: true }\n      );\n    else\n      sheu.debug(`Original Request Query (req.query) - Empty`, {\n        timestamp: true,\n      });\n\n    next();\n  }\n}\n\nconst debuggerService = new DebuggerService();\n\nexport default debuggerService;\n"]}

package/dist/cjs/modules/debugger/utils/loaded-components-logger.js

@@ -43,7 +43,7 @@ class LoadedComponentsLogger {
         }, []);
     }
     getLogText(components) {
-        return `${sheu_1.default.bold("AuthConfigs:")} ${components?.authConfigs ? `\n${util_1.default.inspect(components.authConfigs, { depth: null, colors: true })}` : " -"}
+        return `${sheu_1.default.bold("AuthConfigs:")}${components?.authConfigs ? `\n${util_1.default.inspect(components.authConfigs, { depth: null, colors: true })}` : " -"}
 ${sheu_1.default.bold("PrismaQueryOptions:")}${components?.prismaQueryOptions ? `\n${util_1.default.inspect(components.prismaQueryOptions, { depth: null, colors: true })}` : " -"}
 ${sheu_1.default.bold("Router:")}${components?.router ? `\n${util_1.default.inspect(components.router, { depth: null, colors: true })}` : " -"}
 ${sheu_1.default.bold("Interceptors:")}${components?.interceptors ? `\n${util_1.default.inspect(components.interceptors, { depth: null, colors: true })}` : " -"}

package/dist/cjs/modules/debugger/utils/loaded-components-logger.js.map

@@ -1 +1 @@
-{"version":3,"file":"loaded-components-logger.js","sourceRoot":"","sources":["../../../../../src/modules/debugger/utils/loaded-components-logger.ts"],"names":[],"mappings":"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","sourcesContent":["import { ModuleComponents } from \"../../../utils/dynamic-loader\";\nimport { getUserFileExtension as ext } from \"../../../utils/helpers/fs.helpers\";\nimport sheu from \"../../../utils/sheu\";\nimport util from \"util\";\n\nclass LoadedComponentsLogger {\n  ext = ext();\n  componentsToPath: Record<\n    keyof ModuleComponents,\n    string | ModuleComponents[\"dtos\"]\n  > = {\n    authConfigs: `{{module-name}}.auth.${this.ext}`,\n    prismaQueryOptions: `{{module-name}}.query.${this.ext}`,\n    interceptors: `{{module-name}}.interceptors.${this.ext}`,\n    interceptorsOld: `{{module-name}}.middlewares.${this.ext}`,\n    router: `{{module-name}}.router.${this.ext}`,\n    hooks: `{{module-name}}.hooks.${this.ext}`,\n    dtos: {\n      create: `create-{{module-name}}.dto.${this.ext}`,\n      update: `update-{{module-name}}.dto.${this.ext}`,\n    },\n    schemas: {\n      create: `create-{{module-name}}.schema.${this.ext}`,\n      update: `update-{{module-name}}.schema.${this.ext}`,\n    },\n  };\n\n  getComponentsNameList(moduleName: string, components: ModuleComponents) {\n    return Object.keys(components).reduce((acc, key) => {\n      if (components[key as keyof ModuleComponents]) {\n        const mapping = this.componentsToPath[key as keyof ModuleComponents];\n        if (![\"schemas\", \"dtos\"].includes(key))\n          acc.push((mapping as string)!.replace(\"{{module-name}}\", moduleName));\n        else {\n          if ((components as any)[key as keyof ModuleComponents]?.create)\n            acc.push(\n              (mapping as ModuleComponents[\"dtos\"])?.create.replace(\n                \"{{module-name}}\",\n                moduleName\n              )\n            );\n          if ((components as any)[key as keyof ModuleComponents]?.update)\n            acc.push(\n              (mapping as ModuleComponents[\"dtos\"])?.update.replace(\n                \"{{module-name}}\",\n                moduleName\n              )\n            );\n        }\n      }\n\n      return acc;\n    }, [] as string[]);\n  }\n\n  getLogText(components: ModuleComponents) {\n    return `${sheu.bold(\"AuthConfigs:\")} ${components?.authConfigs ? `\\n${util.inspect(components.authConfigs, { depth: null, colors: true })}` : \" -\"}\n${sheu.bold(\"PrismaQueryOptions:\")}${components?.prismaQueryOptions ? `\\n${util.inspect(components.prismaQueryOptions, { depth: null, colors: true })}` : \" -\"}\n${sheu.bold(\"Router:\")}${components?.router ? `\\n${util.inspect(components.router, { depth: null, colors: true })}` : \" -\"}\n${sheu.bold(\"Interceptors:\")}${components?.interceptors ? `\\n${util.inspect(components.interceptors, { depth: null, colors: true })}` : \" -\"}\n${sheu.bold(\"Hooks:\")}${components?.hooks ? `\\n${util.inspect(components.hooks, { depth: null, colors: true })}` : \" -\"}\n`;\n  }\n}\n\nconst loadedComponentsLogger = new LoadedComponentsLogger();\n\nexport default loadedComponentsLogger;\n"]}
+{"version":3,"file":"loaded-components-logger.js","sourceRoot":"","sources":["../../../../../src/modules/debugger/utils/loaded-components-logger.ts"],"names":[],"mappings":";;;;;AACA,kEAAgF;AAChF,+DAAuC;AACvC,gDAAwB;AAExB,MAAM,sBAAsB;IAA5B;QACE,QAAG,GAAG,IAAA,iCAAG,GAAE,CAAC;QACZ,qBAAgB,GAGZ;YACF,WAAW,EAAE,wBAAwB,IAAI,CAAC,GAAG,EAAE;YAC/C,kBAAkB,EAAE,yBAAyB,IAAI,CAAC,GAAG,EAAE;YACvD,YAAY,EAAE,gCAAgC,IAAI,CAAC,GAAG,EAAE;YACxD,eAAe,EAAE,+BAA+B,IAAI,CAAC,GAAG,EAAE;YAC1D,MAAM,EAAE,0BAA0B,IAAI,CAAC,GAAG,EAAE;YAC5C,KAAK,EAAE,yBAAyB,IAAI,CAAC,GAAG,EAAE;YAC1C,IAAI,EAAE;gBACJ,MAAM,EAAE,8BAA8B,IAAI,CAAC,GAAG,EAAE;gBAChD,MAAM,EAAE,8BAA8B,IAAI,CAAC,GAAG,EAAE;aACjD;YACD,OAAO,EAAE;gBACP,MAAM,EAAE,iCAAiC,IAAI,CAAC,GAAG,EAAE;gBACnD,MAAM,EAAE,iCAAiC,IAAI,CAAC,GAAG,EAAE;aACpD;SACF,CAAC;IAsCJ,CAAC;IApCC,qBAAqB,CAAC,UAAkB,EAAE,UAA4B;QACpE,OAAO,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;YACjD,IAAI,UAAU,CAAC,GAA6B,CAAC,EAAE,CAAC;gBAC9C,MAAM,OAAO,GAAG,IAAI,CAAC,gBAAgB,CAAC,GAA6B,CAAC,CAAC;gBACrE,IAAI,CAAC,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC;oBACpC,GAAG,CAAC,IAAI,CAAE,OAAmB,CAAC,OAAO,CAAC,iBAAiB,EAAE,UAAU,CAAC,CAAC,CAAC;qBACnE,CAAC;oBACJ,IAAK,UAAkB,CAAC,GAA6B,CAAC,EAAE,MAAM;wBAC5D,GAAG,CAAC,IAAI,CACL,OAAoC,EAAE,MAAM,CAAC,OAAO,CACnD,iBAAiB,EACjB,UAAU,CACX,CACF,CAAC;oBACJ,IAAK,UAAkB,CAAC,GAA6B,CAAC,EAAE,MAAM;wBAC5D,GAAG,CAAC,IAAI,CACL,OAAoC,EAAE,MAAM,CAAC,OAAO,CACnD,iBAAiB,EACjB,UAAU,CACX,CACF,CAAC;gBACN,CAAC;YACH,CAAC;YAED,OAAO,GAAG,CAAC;QACb,CAAC,EAAE,EAAc,CAAC,CAAC;IACrB,CAAC;IAED,UAAU,CAAC,UAA4B;QACrC,OAAO,GAAG,cAAI,CAAC,IAAI,CAAC,cAAc,CAAC,GAAG,UAAU,EAAE,WAAW,CAAC,CAAC,CAAC,KAAK,cAAI,CAAC,OAAO,CAAC,UAAU,CAAC,WAAW,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI;EACnJ,cAAI,CAAC,IAAI,CAAC,qBAAqB,CAAC,GAAG,UAAU,EAAE,kBAAkB,CAAC,CAAC,CAAC,KAAK,cAAI,CAAC,OAAO,CAAC,UAAU,CAAC,kBAAkB,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI;EAC5J,cAAI,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,cAAI,CAAC,OAAO,CAAC,UAAU,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI;EACxH,cAAI,CAAC,IAAI,CAAC,eAAe,CAAC,GAAG,UAAU,EAAE,YAAY,CAAC,CAAC,CAAC,KAAK,cAAI,CAAC,OAAO,CAAC,UAAU,CAAC,YAAY,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI;EAC1I,cAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC,KAAK,cAAI,CAAC,OAAO,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI;CACtH,CAAC;IACA,CAAC;CACF;AAED,MAAM,sBAAsB,GAAG,IAAI,sBAAsB,EAAE,CAAC;AAE5D,kBAAe,sBAAsB,CAAC","sourcesContent":["import { ModuleComponents } from \"../../../utils/dynamic-loader\";\nimport { getUserFileExtension as ext } from \"../../../utils/helpers/fs.helpers\";\nimport sheu from \"../../../utils/sheu\";\nimport util from \"util\";\n\nclass LoadedComponentsLogger {\n  ext = ext();\n  componentsToPath: Record<\n    keyof ModuleComponents,\n    string | ModuleComponents[\"dtos\"]\n  > = {\n    authConfigs: `{{module-name}}.auth.${this.ext}`,\n    prismaQueryOptions: `{{module-name}}.query.${this.ext}`,\n    interceptors: `{{module-name}}.interceptors.${this.ext}`,\n    interceptorsOld: `{{module-name}}.middlewares.${this.ext}`,\n    router: `{{module-name}}.router.${this.ext}`,\n    hooks: `{{module-name}}.hooks.${this.ext}`,\n    dtos: {\n      create: `create-{{module-name}}.dto.${this.ext}`,\n      update: `update-{{module-name}}.dto.${this.ext}`,\n    },\n    schemas: {\n      create: `create-{{module-name}}.schema.${this.ext}`,\n      update: `update-{{module-name}}.schema.${this.ext}`,\n    },\n  };\n\n  getComponentsNameList(moduleName: string, components: ModuleComponents) {\n    return Object.keys(components).reduce((acc, key) => {\n      if (components[key as keyof ModuleComponents]) {\n        const mapping = this.componentsToPath[key as keyof ModuleComponents];\n        if (![\"schemas\", \"dtos\"].includes(key))\n          acc.push((mapping as string)!.replace(\"{{module-name}}\", moduleName));\n        else {\n          if ((components as any)[key as keyof ModuleComponents]?.create)\n            acc.push(\n              (mapping as ModuleComponents[\"dtos\"])?.create.replace(\n                \"{{module-name}}\",\n                moduleName\n              )\n            );\n          if ((components as any)[key as keyof ModuleComponents]?.update)\n            acc.push(\n              (mapping as ModuleComponents[\"dtos\"])?.update.replace(\n                \"{{module-name}}\",\n                moduleName\n              )\n            );\n        }\n      }\n\n      return acc;\n    }, [] as string[]);\n  }\n\n  getLogText(components: ModuleComponents) {\n    return `${sheu.bold(\"AuthConfigs:\")}${components?.authConfigs ? `\\n${util.inspect(components.authConfigs, { depth: null, colors: true })}` : \" -\"}\n${sheu.bold(\"PrismaQueryOptions:\")}${components?.prismaQueryOptions ? `\\n${util.inspect(components.prismaQueryOptions, { depth: null, colors: true })}` : \" -\"}\n${sheu.bold(\"Router:\")}${components?.router ? `\\n${util.inspect(components.router, { depth: null, colors: true })}` : \" -\"}\n${sheu.bold(\"Interceptors:\")}${components?.interceptors ? `\\n${util.inspect(components.interceptors, { depth: null, colors: true })}` : \" -\"}\n${sheu.bold(\"Hooks:\")}${components?.hooks ? `\\n${util.inspect(components.hooks, { depth: null, colors: true })}` : \" -\"}\n`;\n  }\n}\n\nconst loadedComponentsLogger = new LoadedComponentsLogger();\n\nexport default loadedComponentsLogger;\n"]}

package/dist/cjs/modules/email/email.service.js

@@ -21,42 +21,40 @@ class EmailService {
             return this.customConfig;
         }
         const { email: emailConfigs } = (0, server_1.getArkosConfig)();
-        if (!emailConfigs) {
-            throw new app_error_1.default("You are trying to use emailService without setting arkosConfig.email configurations", 500, {
+        const host = emailConfigs?.host || process.env.EMAIL_HOST;
+        const port = emailConfigs?.port ||
+            (process.env.EMAIL_PORT ? parseInt(process.env.EMAIL_PORT) : undefined);
+        const secure = emailConfigs?.secure !== undefined
+            ? emailConfigs.secure
+            : process.env.EMAIL_SECURE
+                ? process.env.EMAIL_SECURE === "true"
+                : undefined;
+        const user = emailConfigs?.auth?.user || process.env.EMAIL_USER;
+        const pass = emailConfigs?.auth?.pass || process.env.EMAIL_PASSWORD;
+        const name = emailConfigs?.name || process.env.EMAIL_NAME;
+        if (!host || !user || !pass) {
+            throw new app_error_1.default("You are trying to use emailService without setting email configurations. " +
+                "Please configure either arkosConfig.email or environment variables (EMAIL_HOST, EMAIL_USER, EMAIL_PASSWORD)", 500, {
                 docs: "Read more about emailService at https://www.arkosjs.com/docs/core-concepts/sending-emails",
             });
         }
         return {
-            host: emailConfigs.host,
-            port: emailConfigs.port || 465,
-            secure: emailConfigs.secure !== undefined ? emailConfigs.secure : true,
+            host,
+            port: port || 465,
+            secure: secure !== undefined ? secure : true,
             auth: {
-                user: emailConfigs.auth?.user,
-                pass: emailConfigs.auth?.pass,
+                user,
+                pass,
             },
-            name: emailConfigs.name,
+            name,
         };
     }
     getTransporter(customConfig) {
-        if (customConfig) {
-            const defaultConfig = this.getEmailConfig();
-            return nodemailer_1.default.createTransport({
-                host: customConfig.host || defaultConfig.host,
-                port: customConfig.port || defaultConfig.port,
-                secure: customConfig.secure !== undefined
-                    ? customConfig.secure
-                    : defaultConfig.secure,
-                auth: customConfig.auth || defaultConfig.auth,
-            });
-        }
+        if (customConfig)
+            return nodemailer_1.default.createTransport(customConfig);
         if (!this.transporter) {
             const config = this.getEmailConfig();
-            this.transporter = nodemailer_1.default.createTransport({
-                host: config.host,
-                port: config.port,
-                secure: config.secure,
-                auth: config.auth,
-            });
+            this.transporter = nodemailer_1.default.createTransport(config);
         }
         return this.transporter;
     }
@@ -68,9 +66,8 @@ class EmailService {
         const fromAddress = options.from || connectionOptions?.auth?.user || config.auth?.user;
         if (connectionOptions || !skipVerification) {
             const isConnected = await this.verifyConnection(transporter);
-            if (!isConnected) {
+            if (!isConnected)
                 throw new Error("Failed to connect to email server");
-            }
         }
         const info = await transporter.sendMail({
             ...options,

package/dist/cjs/modules/email/email.service.js.map

@@ -1 +1 @@
-{"version":3,"file":"email.service.js","sourceRoot":"","sources":["../../../../src/modules/email/email.service.ts"],"names":[],"mappings":"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","sourcesContent":["import nodemailer, { Transporter } from \"nodemailer\";\nimport { convert } from \"html-to-text\";\nimport { getArkosConfig } from \"../../server\";\nimport AppError from \"../error-handler/utils/app-error\";\n\n/**\n * Defines the options for sending an email.\n */\nexport type EmailOptions = {\n  from?: string; // Sender's email address (optional).\n  to: string | string[]; // Recipient's email address or an array of email addresses.\n  subject: string; // Subject of the email.\n  text?: string; // Plain text body of the email (optional).\n  html: string; // HTML body of the email.\n};\n\n/**\n * Defines the authentication options for SMTP.\n */\nexport type SMTPAuthOptions = {\n  user: string;\n  pass: string;\n};\n\n/**\n * Defines the connection options for SMTP server.\n */\nexport type SMTPConnectionOptions = {\n  host?: string;\n  port?: number;\n  secure?: boolean;\n  auth?: SMTPAuthOptions;\n  name?: string;\n};\n\n/**\n * A service class to handle email-related tasks, including sending emails.\n *\n * See the api reference [www.arkosjs.com/docs/api-reference/the-email-service-class](https://www.arkosjs.com/docs/api-reference/the-email-service-class)\n */\nexport class EmailService {\n  private transporter: Transporter | null = null;\n  private customConfig: SMTPConnectionOptions | null = null;\n\n  /**\n   * Creates an instance of the EmailService class.\n   *\n   * @param {SMTPConnectionOptions} [config] - Optional custom SMTP configuration.\n   * If provided, these settings will be used instead of the Arkos config.\n   */\n  constructor(config?: SMTPConnectionOptions) {\n    if (config) {\n      this.customConfig = config;\n    }\n  }\n\n  /**\n   * Gets the email configuration, either from constructor-provided config or ArkosConfig\n   * @returns Configuration object with host, port, and auth details\n   * @throws AppError if email configuration is not set\n   */\n  private getEmailConfig(): SMTPConnectionOptions {\n    // If custom config was provided through constructor, use it\n    if (this.customConfig) {\n      return this.customConfig;\n    }\n\n    // Otherwise, get from Arkos config\n    const { email: emailConfigs } = getArkosConfig();\n\n    if (!emailConfigs) {\n      throw new AppError(\n        \"You are trying to use emailService without setting arkosConfig.email configurations\",\n        500,\n        {\n          docs: \"Read more about emailService at https://www.arkosjs.com/docs/core-concepts/sending-emails\",\n        }\n      );\n    }\n\n    return {\n      host: emailConfigs.host,\n      port: emailConfigs.port || 465,\n      secure: emailConfigs.secure !== undefined ? emailConfigs.secure : true,\n      auth: {\n        user: emailConfigs.auth?.user,\n        pass: emailConfigs.auth?.pass,\n      },\n      name: emailConfigs.name,\n    };\n  }\n\n  /**\n   * Gets or creates a transporter using provided config or default config\n   * @param customConfig Optional override connection settings\n   * @returns A configured nodemailer transporter\n   */\n  private getTransporter(customConfig?: SMTPConnectionOptions): Transporter {\n    if (customConfig) {\n      // Create temporary transporter with custom settings\n      const defaultConfig = this.getEmailConfig();\n      return nodemailer.createTransport({\n        host: customConfig.host || defaultConfig.host,\n        port: customConfig.port || defaultConfig.port,\n        secure:\n          customConfig.secure !== undefined\n            ? customConfig.secure\n            : defaultConfig.secure,\n        auth: customConfig.auth || defaultConfig.auth,\n      });\n    }\n\n    // Use cached transporter or create new one with default settings\n    if (!this.transporter) {\n      const config = this.getEmailConfig();\n      this.transporter = nodemailer.createTransport({\n        host: config.host,\n        port: config.port,\n        secure: config.secure,\n        auth: config.auth,\n      });\n    }\n\n    return this.transporter;\n  }\n\n  /**\n   * Sends an email with the provided options.\n   * Can use either the default configuration or custom connection options.\n   *\n   * @param {EmailOptions} options - The options for the email to be sent.\n   * @param {SMTPConnectionOptions} [connectionOptions] - Optional custom connection settings.\n   * @param {boolean} [skipVerification=false] - Whether to skip connection verification.\n   * @returns {Promise<{ success: boolean; messageId?: string }>} Result with message ID on success.\n   */\n  public async send(\n    options: EmailOptions,\n    connectionOptions?: SMTPConnectionOptions,\n    skipVerification = false\n  ): Promise<{ success: boolean; messageId?: string }> {\n    const config = this.getEmailConfig();\n    const transporter = connectionOptions\n      ? this.getTransporter(connectionOptions)\n      : this.getTransporter();\n\n    // Determine from address with proper fallbacks\n    const fromAddress =\n      options.from || connectionOptions?.auth?.user || config.auth?.user;\n\n    // Optionally verify connection\n    if (connectionOptions || !skipVerification) {\n      const isConnected = await this.verifyConnection(transporter);\n\n      if (!isConnected) {\n        throw new Error(\"Failed to connect to email server\");\n      }\n    }\n\n    // Send the email\n    const info = await transporter.sendMail({\n      ...options,\n      from: fromAddress,\n      text: options?.text || convert(options.html),\n    });\n\n    return { success: true, messageId: info.messageId };\n  }\n\n  /**\n   * Verifies the connection to the email server.\n   * @param {Transporter} [transporterToVerify] - Optional transporter to verify.\n   * @returns {Promise<boolean>} A promise that resolves to true if connection is valid.\n   */\n  public async verifyConnection(\n    transporterToVerify?: Transporter\n  ): Promise<boolean> {\n    try {\n      const transporter = transporterToVerify || this.getTransporter();\n      await transporter.verify();\n      return true;\n    } catch (error) {\n      console.error(\"Email Server Connection Failed\", error);\n      return false;\n    }\n  }\n\n  /**\n   * Updates the custom configuration for this email service instance.\n   * @param {SMTPConnectionOptions} config - The new connection options.\n   */\n  public updateConfig(config: SMTPConnectionOptions): void {\n    this.customConfig = config;\n    this.transporter = null; // Reset transporter so it will be recreated with new config\n  }\n\n  /**\n   * Creates a new instance of EmailService with custom configuration.\n   * @param {SMTPConnectionOptions} config - The connection options for the new instance.\n   * @returns {EmailService} A new EmailService instance.\n   */\n  public static create(config: SMTPConnectionOptions): EmailService {\n    return new EmailService(config);\n  }\n}\n\n// Create default instance\nconst emailService = new EmailService();\nexport default emailService;\n"]}
+{"version":3,"file":"email.service.js","sourceRoot":"","sources":["../../../../src/modules/email/email.service.ts"],"names":[],"mappings":"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","sourcesContent":["import nodemailer, { Transporter } from \"nodemailer\";\nimport { convert } from \"html-to-text\";\nimport { getArkosConfig } from \"../../server\";\nimport AppError from \"../error-handler/utils/app-error\";\n\n/**\n * Defines the options for sending an email.\n */\nexport type EmailOptions = {\n  from?: string;\n  to: string | string[];\n  subject: string;\n  text?: string;\n  html: string;\n};\n\n/**\n * Defines the authentication options for SMTP.\n */\nexport type SMTPAuthOptions = {\n  user: string;\n  pass: string;\n};\n\n/**\n * Defines the connection options for SMTP server.\n */\nexport type SMTPConnectionOptions = {\n  host?: string;\n  port?: number;\n  secure?: boolean;\n  auth?: SMTPAuthOptions;\n  name?: string;\n};\n\n/**\n * A service class to handle email-related tasks, including sending emails.\n *\n * See the api reference [www.arkosjs.com/docs/api-reference/the-email-service-class](https://www.arkosjs.com/docs/api-reference/the-email-service-class)\n */\nexport class EmailService {\n  private transporter: Transporter | null = null;\n  private customConfig: SMTPConnectionOptions | null = null;\n\n  /**\n   * Creates an instance of the EmailService class.\n   *\n   * @param {SMTPConnectionOptions} [config] - Optional custom SMTP configuration.\n   * If provided, these settings will be used instead of the Arkos config.\n   */\n  constructor(config?: SMTPConnectionOptions) {\n    if (config) {\n      this.customConfig = config;\n    }\n  }\n\n  /**\n   * Gets the email configuration from multiple sources with priority:\n   * 1. Constructor customConfig\n   * 2. ArkosConfig\n   * 3. Environment variables\n   * @returns Configuration object with host, port, and auth details\n   * @throws AppError if required email configuration is not set\n   */\n  private getEmailConfig(): SMTPConnectionOptions {\n    if (this.customConfig) {\n      return this.customConfig;\n    }\n\n    const { email: emailConfigs } = getArkosConfig();\n    const host = emailConfigs?.host || process.env.EMAIL_HOST;\n    const port =\n      emailConfigs?.port ||\n      (process.env.EMAIL_PORT ? parseInt(process.env.EMAIL_PORT) : undefined);\n    const secure =\n      emailConfigs?.secure !== undefined\n        ? emailConfigs.secure\n        : process.env.EMAIL_SECURE\n          ? process.env.EMAIL_SECURE === \"true\"\n          : undefined;\n    const user = emailConfigs?.auth?.user || process.env.EMAIL_USER;\n    const pass = emailConfigs?.auth?.pass || process.env.EMAIL_PASSWORD;\n    const name = emailConfigs?.name || process.env.EMAIL_NAME;\n\n    if (!host || !user || !pass) {\n      throw new AppError(\n        \"You are trying to use emailService without setting email configurations. \" +\n          \"Please configure either arkosConfig.email or environment variables (EMAIL_HOST, EMAIL_USER, EMAIL_PASSWORD)\",\n        500,\n        {\n          docs: \"Read more about emailService at https://www.arkosjs.com/docs/core-concepts/sending-emails\",\n        }\n      );\n    }\n\n    return {\n      host,\n      port: port || 465,\n      secure: secure !== undefined ? secure : true,\n      auth: {\n        user,\n        pass,\n      },\n      name,\n    };\n  }\n\n  /**\n   * Gets or creates a transporter using the email configuration\n   * @param customConfig Optional override connection settings (takes full priority if provided)\n   * @returns A configured nodemailer transporter\n   */\n  private getTransporter(customConfig?: SMTPConnectionOptions): Transporter {\n    if (customConfig) return nodemailer.createTransport(customConfig);\n\n    if (!this.transporter) {\n      const config = this.getEmailConfig();\n      this.transporter = nodemailer.createTransport(config);\n    }\n    return this.transporter;\n  }\n\n  /**\n   * Sends an email with the provided options.\n   * Can use either the default configuration or custom connection options.\n   *\n   * @param {EmailOptions} options - The options for the email to be sent.\n   * @param {SMTPConnectionOptions} [connectionOptions] - Optional custom connection settings.\n   * @param {boolean} [skipVerification=false] - Whether to skip connection verification.\n   * @returns {Promise<{ success: boolean; messageId?: string }>} Result with message ID on success.\n   */\n  public async send(\n    options: EmailOptions,\n    connectionOptions?: SMTPConnectionOptions,\n    skipVerification = false\n  ): Promise<{ success: boolean; messageId?: string }> {\n    const config = this.getEmailConfig();\n    const transporter = connectionOptions\n      ? this.getTransporter(connectionOptions)\n      : this.getTransporter();\n\n    const fromAddress =\n      options.from || connectionOptions?.auth?.user || config.auth?.user;\n\n    if (connectionOptions || !skipVerification) {\n      const isConnected = await this.verifyConnection(transporter);\n\n      if (!isConnected) throw new Error(\"Failed to connect to email server\");\n    }\n\n    // Send the email\n    const info = await transporter.sendMail({\n      ...options,\n      from: fromAddress,\n      text: options?.text || convert(options.html),\n    });\n\n    return { success: true, messageId: info.messageId };\n  }\n\n  /**\n   * Verifies the connection to the email server.\n   * @param {Transporter} [transporterToVerify] - Optional transporter to verify.\n   * @returns {Promise<boolean>} A promise that resolves to true if connection is valid.\n   */\n  public async verifyConnection(\n    transporterToVerify?: Transporter\n  ): Promise<boolean> {\n    try {\n      const transporter = transporterToVerify || this.getTransporter();\n      await transporter.verify();\n      return true;\n    } catch (error) {\n      console.error(\"Email Server Connection Failed\", error);\n      return false;\n    }\n  }\n\n  /**\n   * Updates the custom configuration for this email service instance.\n   * @param {SMTPConnectionOptions} config - The new connection options.\n   */\n  public updateConfig(config: SMTPConnectionOptions): void {\n    this.customConfig = config;\n    this.transporter = null; // Reset transporter so it will be recreated with new config\n  }\n\n  /**\n   * Creates a new instance of EmailService with custom configuration.\n   * @param {SMTPConnectionOptions} config - The connection options for the new instance.\n   * @returns {EmailService} A new EmailService instance.\n   */\n  public static create(config: SMTPConnectionOptions): EmailService {\n    return new EmailService(config);\n  }\n}\n\nconst emailService = new EmailService();\n\nexport default emailService;\n"]}

package/dist/cjs/modules/error-handler/error-handler.controller.js

@@ -32,21 +32,21 @@ var __importStar = (this && this.__importStar) || (function () {
         return result;
     };
 })();
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.default = errorHandler;
-const app_error_1 = __importDefault(require("./utils/app-error"));
 const errorControllerHelper = __importStar(require("./utils/error-handler.helpers"));
 const server_1 = require("../../server");
 function errorHandler(err, req, res, _) {
     console.error("[\x1b[31mError\x1b[0m]:", err);
     err.statusCode = err.statusCode || 500;
     err.status = err.status || "error";
-    if (process.env.NODE_ENV !== "production")
-        return sendDevelopmentError(err, req, res);
-    let error = { ...err, message: err.message };
+    let error = {
+        ...err,
+        message: err.message,
+        stack: err?.stack || undefined,
+    };
+    if (process.env.ARKOS_BUILD === "true")
+        delete error?.stack;
     if (err.name === "JsonWebTokenError")
         error = errorControllerHelper.handleJWTError();
     if (err.name === "TokenExpiredError")
@@ -85,8 +85,13 @@ function errorHandler(err, req, res, _) {
         error = errorControllerHelper.handleVersionMismatchError(err);
     if (err.name === "NetworkError")
         error = errorControllerHelper.handleNetworkError(err);
-    if (!error.isOperational)
-        error = new app_error_1.default("Internal server error", 500);
+    if (process.env.ARKOS_BUILD !== "true")
+        return sendDevelopmentError({
+            ...error,
+            message: error.message,
+            stack: err.stack,
+            originalError: err,
+        }, req, res);
     sendProductionError(error, req, res);
 }
 function sendDevelopmentError(err, req, res) {
@@ -94,7 +99,7 @@ function sendDevelopmentError(err, req, res) {
         res.status(err.statusCode).json({
             ...err,
             message: err.message.split("\n")[err.message.split("\n").length - 1],
-            stack: err.stack?.split("\n"),
+            stack: err?.originalError?.stack?.split("\n"),
         });
     else
         res.status(err.statusCode).json({
@@ -109,12 +114,14 @@ function sendProductionError(err, req, res) {
                 status: err.status,
                 message: err.message,
                 meta: err.meta || {},
-                code: err.code || "unknown",
+                code: err.code || "Unknown",
             });
         else
             res.status(500).json({
                 status: "error",
-                message: "Internal server error",
+                message: "Internal server error, please try again later.",
+                code: "Unknown",
+                meta: {},
             });
         return;
     }
@@ -122,17 +129,17 @@ function sendProductionError(err, req, res) {
         res.status(err.statusCode).json({
             title: "Internal server error",
             message: err.message,
+            code: "Unknown",
         });
         return;
     }
     res.status(err.statusCode).json({
         title: "Internal server error",
-        message: "Please try again later.",
+        message: "Internal server error, please try again later.",
     });
 }
 process.on("SIGTERM", () => {
-    if (process.env.NODE_ENV !== "production" &&
-        process.env.NODE_ENV !== "staging") {
+    if (process.env.ARKOS_BUILD !== "true") {
         process.exit();
     }
     else {

package/dist/cjs/modules/error-handler/error-handler.controller.js.map

@@ -1 +1 @@
-{"version":3,"file":"error-handler.controller.js","sourceRoot":"","sources":["../../../../src/modules/error-handler/error-handler.controller.ts"],"names":[],"mappings":"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","sourcesContent":["import { NextFunction, Request, Response } from \"express\";\nimport AppError from \"./utils/app-error\";\nimport * as errorControllerHelper from \"./utils/error-handler.helpers\";\nimport { server } from \"../../server\";\n\n/**\n * Error handling middleware for Express.\n *\n * This middleware function handles all errors in the Express application.\n * It checks for the environment (development or production) and sends appropriate error responses\n * based on whether the environment is production or not. It also maps specific errors such as\n * JWT errors, Prisma client errors, and database-related errors to specific helper functions for handling.\n *\n * @param {AppError} err - The error object thrown by the application.\n * @param {Request} req - The Express request object.\n * @param {Response} res - The Express response object.\n * @param {NextFunction} _ - The next middleware function in the chain.\n *\n * @returns {void} - Sends the response with the error details to the client.\n */\nexport default function errorHandler(\n  err: AppError,\n  req: Request,\n  res: Response,\n  _: NextFunction\n): void {\n  console.error(\"[\\x1b[31mError\\x1b[0m]:\", err);\n  // Default error status\n  err.statusCode = err.statusCode || 500;\n  err.status = err.status || \"error\";\n\n  // If the environment is not production, send detailed error information\n  if (process.env.NODE_ENV !== \"production\")\n    return sendDevelopmentError(err, req, res);\n\n  // Prepare error object for response, copying the original error's properties\n  let error = { ...err, message: err.message };\n\n  // Handle specific error cases (JWT errors, Prisma validation errors, etc.)\n  if (err.name === \"JsonWebTokenError\")\n    error = errorControllerHelper.handleJWTError();\n  if (err.name === \"TokenExpiredError\")\n    error = errorControllerHelper.handleJWTExpired();\n\n  // Handle specific Prisma client validation errors\n  if (err.name === \"PrismaClientValidationError\")\n    error = errorControllerHelper.handlePrismaClientValidationError(err);\n  if (err.name === \"PrismaClientInitializationError\")\n    error = errorControllerHelper.handlePrismaClientInitializationError(err);\n\n  // Handle Prisma database-specific error codes (P1000 to P3005)\n  if (err.code === \"P1000\")\n    error = errorControllerHelper.handleAuthenticationError(err);\n  if (err.code === \"P1001\")\n    error = errorControllerHelper.handleServerNotReachableError(err);\n  if (err.code === \"P1002\")\n    error = errorControllerHelper.handleConnectionTimeoutError(err);\n  if (err.code === \"P1003\")\n    error = errorControllerHelper.handleDatabaseNotFoundError(err);\n  if (err.code === \"P2000\")\n    error = errorControllerHelper.handleFieldValueTooLargeError(err);\n  if (err.code === \"P2001\")\n    error = errorControllerHelper.handleRecordNotFoundError(err);\n  if (err.code === \"P2002\")\n    error = errorControllerHelper.handleUniqueConstraintError(err);\n  if (err.code === \"P2003\")\n    error = errorControllerHelper.handleForeignKeyConstraintError(err);\n  if (err.code === \"P2004\")\n    error = errorControllerHelper.handleConstraintFailedError(err);\n  if (err.code === \"P2025\")\n    error = errorControllerHelper.handleNonExistingRecord(err);\n  if (err.code === \"P3000\")\n    error = errorControllerHelper.handleSchemaCreationFailedError(err);\n  if (err.code === \"P3001\")\n    error = errorControllerHelper.handleMigrationAlreadyAppliedError(err);\n  if (err.code === \"P3002\")\n    error = errorControllerHelper.handleMigrationScriptFailedError(err);\n  if (err.code === \"P3003\")\n    error = errorControllerHelper.handleVersionMismatchError(err);\n\n  if (err.name === \"NetworkError\")\n    error = errorControllerHelper.handleNetworkError(err);\n  if (!error.isOperational) error = new AppError(\"Internal server error\", 500);\n\n  // Send the error response for production environment\n  sendProductionError(error, req, res);\n}\n\n/**\n * Sends a detailed error response in development mode.\n *\n * In development, the error response includes full error details, including\n * the stack trace and the complete error message.\n *\n * @param {AppError} err - The error object.\n * @param {Request} req - The Express request object.\n * @param {Response} res - The Express response object.\n *\n * @returns {void} - Sends the response with the error details to the client.\n */\nfunction sendDevelopmentError(\n  err: AppError,\n  req: Request,\n  res: Response\n): void {\n  if (req.originalUrl.startsWith(\"/api\"))\n    res.status(err.statusCode).json({\n      ...err,\n      message: err.message.split(\"\\n\")[err.message.split(\"\\n\").length - 1],\n      stack: err.stack?.split(\"\\n\"),\n    });\n  else\n    res.status(err.statusCode).json({\n      title: \"Internal server error\",\n      message: err.message,\n    });\n}\n\n/**\n * Sends a generic error response in production mode.\n *\n * In production, sensitive error details (such as stack traces) are not exposed\n * to the client. Only operational errors are shown with a generic message.\n *\n * @param {AppError} err - The error object.\n * @param {Request} req - The Express request object.\n * @param {Response} res - The Express response object.\n *\n * @returns {void} - Sends the response with the error details to the client.\n */\nfunction sendProductionError(err: AppError, req: Request, res: Response): void {\n  if (req.originalUrl.startsWith(\"/api\")) {\n    if (err.isOperational)\n      res.status(err.statusCode).json({\n        status: err.status,\n        message: err.message,\n        meta: err.meta || {},\n        code: err.code || \"unknown\",\n      });\n    else\n      res.status(500).json({\n        status: \"error\",\n        message: \"Internal server error\",\n      });\n\n    return;\n  }\n\n  if (err.isOperational) {\n    res.status(err.statusCode).json({\n      title: \"Internal server error\",\n      message: err.message,\n    });\n    return;\n  }\n\n  res.status(err.statusCode).json({\n    title: \"Internal server error\",\n    message: \"Please try again later.\",\n  });\n}\n\n/**\n * Gracefully handles process termination by listening for SIGTERM signal.\n *\n * - In production and staging environments, it will log a shutdown message\n *   and attempt to close the server gracefully.\n * - In development or non-production environments, it will immediately exit the process.\n *\n * @returns {void}\n */\nprocess.on(\"SIGTERM\", () => {\n  if (\n    process.env.NODE_ENV !== \"production\" &&\n    process.env.NODE_ENV !== \"staging\"\n  ) {\n    process.exit();\n  } else {\n    console.error(\"SIGTERM RECEIVED in Production. Shutting down gracefully!\");\n\n    server.close(() => {\n      console.error(\"Process terminated!!!\");\n      process.exit();\n    });\n  }\n});\n"]}
+{"version":3,"file":"error-handler.controller.js","sourceRoot":"","sources":["../../../../src/modules/error-handler/error-handler.controller.ts"],"names":[],"mappings":"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","sourcesContent":["import { NextFunction, Request, Response } from \"express\";\nimport AppError from \"./utils/app-error\";\nimport * as errorControllerHelper from \"./utils/error-handler.helpers\";\nimport { server } from \"../../server\";\n\n/**\n * Error handling middleware for Express.\n *\n * This middleware function handles all errors in the Express application.\n * It checks for the environment (development or production) and sends appropriate error responses\n * based on whether the environment is production or not. It also maps specific errors such as\n * JWT errors, Prisma client errors, and database-related errors to specific helper functions for handling.\n *\n * @param {AppError} err - The error object thrown by the application.\n * @param {Request} req - The Express request object.\n * @param {Response} res - The Express response object.\n * @param {NextFunction} _ - The next middleware function in the chain.\n *\n * @returns {void} - Sends the response with the error details to the client.\n */\nexport default function errorHandler(\n  err: AppError,\n  req: Request,\n  res: Response,\n  _: NextFunction\n): void {\n  console.error(\"[\\x1b[31mError\\x1b[0m]:\", err);\n\n  err.statusCode = err.statusCode || 500;\n  err.status = err.status || \"error\";\n\n  let error: any = {\n    ...err,\n    message: err.message,\n    stack: err?.stack || undefined,\n  };\n\n  if (process.env.ARKOS_BUILD === \"true\") delete error?.stack;\n\n  if (err.name === \"JsonWebTokenError\")\n    error = errorControllerHelper.handleJWTError();\n  if (err.name === \"TokenExpiredError\")\n    error = errorControllerHelper.handleJWTExpired();\n\n  if (err.name === \"PrismaClientValidationError\")\n    error = errorControllerHelper.handlePrismaClientValidationError(err);\n  if (err.name === \"PrismaClientInitializationError\")\n    error = errorControllerHelper.handlePrismaClientInitializationError(err);\n  if (err.code === \"P1000\")\n    error = errorControllerHelper.handleAuthenticationError(err);\n  if (err.code === \"P1001\")\n    error = errorControllerHelper.handleServerNotReachableError(err);\n  if (err.code === \"P1002\")\n    error = errorControllerHelper.handleConnectionTimeoutError(err);\n  if (err.code === \"P1003\")\n    error = errorControllerHelper.handleDatabaseNotFoundError(err);\n  if (err.code === \"P2000\")\n    error = errorControllerHelper.handleFieldValueTooLargeError(err);\n  if (err.code === \"P2001\")\n    error = errorControllerHelper.handleRecordNotFoundError(err);\n  if (err.code === \"P2002\")\n    error = errorControllerHelper.handleUniqueConstraintError(err);\n  if (err.code === \"P2003\")\n    error = errorControllerHelper.handleForeignKeyConstraintError(err);\n  if (err.code === \"P2004\")\n    error = errorControllerHelper.handleConstraintFailedError(err);\n  if (err.code === \"P2025\")\n    error = errorControllerHelper.handleNonExistingRecord(err);\n  if (err.code === \"P3000\")\n    error = errorControllerHelper.handleSchemaCreationFailedError(err);\n  if (err.code === \"P3001\")\n    error = errorControllerHelper.handleMigrationAlreadyAppliedError(err);\n  if (err.code === \"P3002\")\n    error = errorControllerHelper.handleMigrationScriptFailedError(err);\n  if (err.code === \"P3003\")\n    error = errorControllerHelper.handleVersionMismatchError(err);\n\n  if (err.name === \"NetworkError\")\n    error = errorControllerHelper.handleNetworkError(err);\n\n  if (process.env.ARKOS_BUILD !== \"true\")\n    return sendDevelopmentError(\n      {\n        ...error,\n        message: error.message,\n        stack: err.stack,\n        originalError: err,\n      },\n      req,\n      res\n    );\n\n  sendProductionError(error, req, res);\n}\n\n/**\n * Sends a detailed error response in development mode.\n *\n * In development, the error response includes full error details, including\n * the stack trace and the complete error message.\n *\n * @param {AppError} err - The error object.\n * @param {Request} req - The Express request object.\n * @param {Response} res - The Express response object.\n *\n * @returns {void} - Sends the response with the error details to the client.\n */\nfunction sendDevelopmentError(err: any, req: Request, res: Response): void {\n  if (req.originalUrl.startsWith(\"/api\"))\n    res.status(err.statusCode).json({\n      ...err,\n      message: err.message.split(\"\\n\")[err.message.split(\"\\n\").length - 1],\n      stack: err?.originalError?.stack?.split(\"\\n\"),\n    });\n  else\n    res.status(err.statusCode).json({\n      title: \"Internal server error\",\n      message: err.message,\n    });\n}\n\n/**\n * Sends a generic error response in production mode.\n *\n * In production, sensitive error details (such as stack traces) are not exposed\n * to the client. Only operational errors are shown with a generic message.\n *\n * @param {AppError} err - The error object.\n * @param {Request} req - The Express request object.\n * @param {Response} res - The Express response object.\n *\n * @returns {void} - Sends the response with the error details to the client.\n */\nfunction sendProductionError(err: AppError, req: Request, res: Response): void {\n  if (req.originalUrl.startsWith(\"/api\")) {\n    if (err.isOperational)\n      res.status(err.statusCode).json({\n        status: err.status,\n        message: err.message,\n        meta: err.meta || {},\n        code: err.code || \"Unknown\",\n      });\n    else\n      res.status(500).json({\n        status: \"error\",\n        message: \"Internal server error, please try again later.\",\n        code: \"Unknown\",\n        meta: {},\n      });\n\n    return;\n  }\n\n  if (err.isOperational) {\n    res.status(err.statusCode).json({\n      title: \"Internal server error\",\n      message: err.message,\n      code: \"Unknown\",\n    });\n    return;\n  }\n\n  res.status(err.statusCode).json({\n    title: \"Internal server error\",\n    message: \"Internal server error, please try again later.\",\n  });\n}\n\n/**\n * Gracefully handles process termination by listening for SIGTERM signal.\n *\n * - In production and staging environments, it will log a shutdown message\n *   and attempt to close the server gracefully.\n * - In development or non-production environments, it will immediately exit the process.\n *\n * @returns {void}\n */\nprocess.on(\"SIGTERM\", () => {\n  if (process.env.ARKOS_BUILD !== \"true\") {\n    process.exit();\n  } else {\n    console.error(\"SIGTERM RECEIVED in Production. Shutting down gracefully!\");\n\n    server.close(() => {\n      console.error(\"Process terminated!!!\");\n      process.exit();\n    });\n  }\n});\n"]}

package/dist/cjs/modules/error-handler/utils/app-error.js

@@ -1,14 +1,25 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 class AppError extends Error {
-    constructor(message, statusCode, meta, code) {
+    constructor(message, statusCode, code, meta) {
         super(message);
+        this.code = "Unknown";
         this.message = message || "An error occurred, try again!";
         this.statusCode = statusCode;
         this.status = `${statusCode}`.startsWith("4") ? "fail" : "error";
         this.isOperational = true;
-        this.code = code || "Unknown";
-        this.meta = meta;
+        if (code && meta && typeof code === typeof meta)
+            throw new AppError(`meta and code must not both be ${typeof code}, one must be of type object and other string. but received ${JSON.stringify({ meta, code })}`, 500, "AppErrorMisuse", { meta, code });
+        if (typeof code === "string")
+            this.code = code || "Unknown";
+        if (typeof code === "object")
+            this.meta = code;
+        if (typeof meta === "string")
+            this.code = meta || "Unknown";
+        if (typeof meta === "object")
+            this.meta = meta;
+        if (!code)
+            this.code = "Unknown";
         this.missing = false;
         Error.captureStackTrace(this, this.constructor);
     }

package/dist/cjs/modules/error-handler/utils/app-error.js.map

@@ -1 +1 @@
-{"version":3,"file":"app-error.js","sourceRoot":"","sources":["../../../../../src/modules/error-handler/utils/app-error.ts"],"names":[],"mappings":";;AAgCA,MAAM,QAAS,SAAQ,KAAK;IAgB1B,YACE,OAAe,EACf,UAAkB,EAClB,IAA0B,EAC1B,IAAa;QAEb,KAAK,CAAC,OAAO,CAAC,CAAC;QAEf,IAAI,CAAC,OAAO,GAAG,OAAO,IAAI,+BAA+B,CAAC;QAC1D,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,MAAM,GAAG,GAAG,UAAU,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC;QACjE,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,IAAI,IAAI,SAAS,CAAC;QAC9B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;QAErB,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IAClD,CAAC;CACF;AAED,kBAAe,QAAQ,CAAC","sourcesContent":["/**\n * Custom error class for handling application errors.\n *\n * @extends {Error}\n *\n * @property {number} statusCode - HTTP status code of the error.\n * @property {string} status - Status message derived from the status code (`fail` for 4xx, `error` for 5xx).\n * @property {boolean} [missing=false] - Flag to indicate if a resource is missing.\n * @property {boolean} isOperational - Indicates if the error is operational (intended for client visibility).\n * @property {string} [code] - Optional error code for categorization.\n * @property {Record<string, any>} [meta] - Additional metadata related to the error.\n *\n * @example\n * ```typescript\n *\n * function getUser(id: string) {\n *   if (!id) {\n *     throw new AppError('User ID is required', 400, { field: 'id' }, 'USER_ID_MISSING');\n *   }\n *   // Simulate a user not found scenario\n *   throw new AppError('User not found', 404, { userId: id }, 'USER_NOT_FOUND');\n * }\n *\n * try {\n *   getUser('');\n * } catch (error) {\n *   if (error instanceof AppError) {\n *     console.error(`Error: ${error.message}, Code: ${error.code}, Status: ${error.status}`);\n *   }\n * }\n * ```\n */\nclass AppError extends Error {\n  statusCode: number;\n  status: string;\n  public missing?: boolean;\n  public isOperational: boolean;\n  code?: string;\n  meta?: Record<string, any>;\n\n  /**\n   * Creates an instance of AppError.\n   *\n   * @param {string} message - The error message.\n   * @param {number} statusCode - The HTTP status code.\n   * @param {Record<string, any>} [meta] - Additional metadata for debugging or client feedback.\n   * @param {string} [code] - A custom error code for categorization.\n   */\n  constructor(\n    message: string,\n    statusCode: number,\n    meta?: Record<string, any>,\n    code?: string\n  ) {\n    super(message);\n\n    this.message = message || \"An error occurred, try again!\";\n    this.statusCode = statusCode;\n    this.status = `${statusCode}`.startsWith(\"4\") ? \"fail\" : \"error\";\n    this.isOperational = true;\n    this.code = code || \"Unknown\";\n    this.meta = meta;\n    this.missing = false;\n\n    Error.captureStackTrace(this, this.constructor);\n  }\n}\n\nexport default AppError;\n"]}
+{"version":3,"file":"app-error.js","sourceRoot":"","sources":["../../../../../src/modules/error-handler/utils/app-error.ts"],"names":[],"mappings":";;AAgCA,MAAM,QAAS,SAAQ,KAAK;IAgB1B,YACE,OAAe,EACf,UAAkB,EAClB,IAAmC,EACnC,IAAmC;QAEnC,KAAK,CAAC,OAAO,CAAC,CAAC;QAjBjB,SAAI,GAAY,SAAS,CAAC;QAmBxB,IAAI,CAAC,OAAO,GAAG,OAAO,IAAI,+BAA+B,CAAC;QAC1D,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,MAAM,GAAG,GAAG,UAAU,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC;QACjE,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;QAE1B,IAAI,IAAI,IAAI,IAAI,IAAI,OAAO,IAAI,KAAK,OAAO,IAAI;YAC7C,MAAM,IAAI,QAAQ,CAChB,kCAAkC,OAAO,IAAI,+DAA+D,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,EAAE,EAC5I,GAAG,EACH,gBAAgB,EAChB,EAAE,IAAI,EAAE,IAAI,EAAE,CACf,CAAC;QAEJ,IAAI,OAAO,IAAI,KAAK,QAAQ;YAAE,IAAI,CAAC,IAAI,GAAG,IAAI,IAAI,SAAS,CAAC;QAC5D,IAAI,OAAO,IAAI,KAAK,QAAQ;YAAE,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QAC/C,IAAI,OAAO,IAAI,KAAK,QAAQ;YAAE,IAAI,CAAC,IAAI,GAAG,IAAI,IAAI,SAAS,CAAC;QAC5D,IAAI,OAAO,IAAI,KAAK,QAAQ;YAAE,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QAC/C,IAAI,CAAC,IAAI;YAAE,IAAI,CAAC,IAAI,GAAG,SAAS,CAAC;QAEjC,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;QAErB,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IAClD,CAAC;CACF;AAED,kBAAe,QAAQ,CAAC","sourcesContent":["/**\n * Custom error class for handling application errors.\n *\n * @extends {Error}\n *\n * @property {number} statusCode - HTTP status code of the error.\n * @property {string} status - Status message derived from the status code (`fail` for 4xx, `error` for 5xx).\n * @property {boolean} [missing=false] - Flag to indicate if a resource is missing.\n * @property {boolean} isOperational - Indicates if the error is operational (intended for client visibility).\n * @property {string} [code] - Optional error code for categorization.\n * @property {Record<string, any>} [meta] - Additional metadata related to the error.\n *\n * @example\n * ```typescript\n *\n * function getUser(id: string) {\n *   if (!id) {\n *     throw new AppError('User ID is required', 400, 'UserIDMissing', { field: 'id' });\n *   }\n *   // Simulate a user not found scenario\n *   throw new AppError('User not found', 404, 'UserNotFound', { userId: id });\n * }\n *\n * try {\n *   getUser('');\n * } catch (error) {\n *   if (error instanceof AppError) {\n *     console.error(`Error: ${error.message}, Code: ${error.code}, Status: ${error.status}`);\n *   }\n * }\n * ```\n */\nclass AppError extends Error {\n  statusCode: number;\n  status: string;\n  public missing?: boolean;\n  public isOperational: boolean;\n  code?: string = \"Unknown\";\n  meta?: Record<string, any>;\n\n  /**\n   * Creates an instance of AppError.\n   *\n   * @param {string} message - The error message.\n   * @param {number} statusCode - The HTTP status code.\n   * @param {Record<string, any>} [meta] - Additional metadata for debugging or client feedback.\n   * @param {string} [code] - A custom error code for categorization.\n   */\n  constructor(\n    message: string,\n    statusCode: number,\n    code?: string | Record<string, any>,\n    meta?: Record<string, any> | string\n  ) {\n    super(message);\n\n    this.message = message || \"An error occurred, try again!\";\n    this.statusCode = statusCode;\n    this.status = `${statusCode}`.startsWith(\"4\") ? \"fail\" : \"error\";\n    this.isOperational = true;\n\n    if (code && meta && typeof code === typeof meta)\n      throw new AppError(\n        `meta and code must not both be ${typeof code}, one must be of type object and other string. but received ${JSON.stringify({ meta, code })}`,\n        500,\n        \"AppErrorMisuse\",\n        { meta, code }\n      );\n\n    if (typeof code === \"string\") this.code = code || \"Unknown\";\n    if (typeof code === \"object\") this.meta = code;\n    if (typeof meta === \"string\") this.code = meta || \"Unknown\";\n    if (typeof meta === \"object\") this.meta = meta;\n    if (!code) this.code = \"Unknown\";\n\n    this.missing = false;\n\n    Error.captureStackTrace(this, this.constructor);\n  }\n}\n\nexport default AppError;\n"]}