@intlayer/backend 5.5.11 → 5.7.0

package/dist/esm/utils/AI/autocomplete/PROMPT.md

@@ -6,10 +6,26 @@ You're the assistant and you will have to complete your own text.
 - You should try to guess the next word(s) or complete the sentence.
 - Your completion should not exceed one sentence.
 - Minimize the completion length if you're unsure about the user's input.
+- Avoid duplication of the current line in the suggestion.
+- Avoid dialog-like completions.
 
-The user input will be provided in the next user message:
+The user input will be provided in the next user message.
 
-Exmaple of entry:
+Use the following context to generate the completion:
+
+Context before the cursor:
+
+{{contextBefore}}
+
+Current line up to cursor:
+
+{{currentLine}}
+
+Context after the cursor:
+
+{{contextAfter}}
+
+Example of entry:
 
 ```json
 { "role": "user", "content": "Lorem ipsum " }

package/dist/esm/utils/AI/autocomplete/index.mjs

@@ -11,25 +11,28 @@ const aiDefaultOptions = {
   provider: AIProvider.OPENAI,
   model: "gpt-4o-mini",
   temperature: 0.7,
-  maxTokens: 6
+  maxTokens: 128
 };
 const autocomplete = async ({
   text,
   aiConfig,
-  applicationContext
+  applicationContext,
+  contextBefore,
+  currentLine,
+  contextAfter
 }) => {
   const prompt = CHAT_GPT_PROMPT.replace(
     "{{applicationContext}}",
     applicationContext ?? ""
-  );
+  ).replace("{{contextBefore}}", contextBefore ?? "").replace("{{currentLine}}", currentLine ?? "").replace("{{contextAfter}}", contextAfter ?? "");
   const { text: newContent, usage } = await generateText({
     ...aiConfig,
     messages: [
       { role: "system", content: prompt },
       { role: "assistant", content: text }
     ],
-    maxTokens: 6
-    // Generate next 6 tokens
+    maxTokens: aiConfig.maxTokens ?? 128
+    // Generate next tokens
   });
   logger.info(`${usage?.totalTokens ?? 0} tokens used in the request`);
   return {

package/dist/esm/utils/AI/autocomplete/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../src/utils/AI/autocomplete/index.ts"],"sourcesContent":["import { logger } from '@logger';\nimport { generateText } from 'ai';\nimport { readFileSync } from 'fs';\nimport { dirname, join } from 'path';\nimport { fileURLToPath } from 'url';\nimport { AIConfig, AIOptions, AIProvider } from '../aiSdk';\n\nconst __dirname = dirname(fileURLToPath(import.meta.url));\n\n// Get the content of a file at the specified path\nconst getFileContent = (filePath: string) =>\n  readFileSync(join(__dirname, filePath), { encoding: 'utf-8' });\n\nexport type AutocompleteOptions = {\n  text: string;\n  aiConfig: AIConfig;\n  applicationContext?: string;\n};\n\nexport type AutocompleteFileResultData = {\n  autocompletion: string;\n  tokenUsed: number;\n};\n\n// The prompt template to send to the AI model\nconst CHAT_GPT_PROMPT = getFileContent('./PROMPT.md');\n\nexport const aiDefaultOptions: AIOptions = {\n  provider: AIProvider.OPENAI,\n  model: 'gpt-4o-mini',\n  temperature: 0.7,\n  maxTokens: 6,\n};\n\n/**\n * Autocompletes a content declaration file by constructing a prompt for AI models.\n * The prompt includes details about the project's locales, file paths of content declarations,\n * and requests for identifying issues or inconsistencies.\n */\nexport const autocomplete = async ({\n  text,\n  aiConfig,\n  applicationContext,\n}: AutocompleteOptions): Promise<AutocompleteFileResultData | undefined> => {\n  // Prepare the prompt for AI by replacing placeholders with actual values.\n  const prompt = CHAT_GPT_PROMPT.replace(\n    '{{applicationContext}}',\n    applicationContext ?? ''\n  );\n\n  // Use the AI SDK to generate the completion\n  const { text: newContent, usage } = await generateText({\n    ...aiConfig,\n    messages: [\n      { role: 'system', content: prompt },\n      { role: 'assistant', content: text },\n    ],\n    maxTokens: 6, // Generate next 6 tokens\n  });\n\n  logger.info(`${usage?.totalTokens ?? 0} tokens used in the request`);\n\n  return {\n    autocompletion: newContent,\n    tokenUsed: usage?.totalTokens ?? 0,\n  };\n};\n"],"mappings":"AAAA,SAAS,cAAc;AACvB,SAAS,oBAAoB;AAC7B,SAAS,oBAAoB;AAC7B,SAAS,SAAS,YAAY;AAC9B,SAAS,qBAAqB;AAC9B,SAA8B,kBAAkB;AAEhD,MAAM,YAAY,QAAQ,cAAc,YAAY,GAAG,CAAC;AAGxD,MAAM,iBAAiB,CAAC,aACtB,aAAa,KAAK,WAAW,QAAQ,GAAG,EAAE,UAAU,QAAQ,CAAC;AAc/D,MAAM,kBAAkB,eAAe,aAAa;AAE7C,MAAM,mBAA8B;AAAA,EACzC,UAAU,WAAW;AAAA,EACrB,OAAO;AAAA,EACP,aAAa;AAAA,EACb,WAAW;AACb;AAOO,MAAM,eAAe,OAAO;AAAA,EACjC;AAAA,EACA;AAAA,EACA;AACF,MAA4E;AAE1E,QAAM,SAAS,gBAAgB;AAAA,IAC7B;AAAA,IACA,sBAAsB;AAAA,EACxB;AAGA,QAAM,EAAE,MAAM,YAAY,MAAM,IAAI,MAAM,aAAa;AAAA,IACrD,GAAG;AAAA,IACH,UAAU;AAAA,MACR,EAAE,MAAM,UAAU,SAAS,OAAO;AAAA,MAClC,EAAE,MAAM,aAAa,SAAS,KAAK;AAAA,IACrC;AAAA,IACA,WAAW;AAAA;AAAA,EACb,CAAC;AAED,SAAO,KAAK,GAAG,OAAO,eAAe,CAAC,6BAA6B;AAEnE,SAAO;AAAA,IACL,gBAAgB;AAAA,IAChB,WAAW,OAAO,eAAe;AAAA,EACnC;AACF;","names":[]}
+{"version":3,"sources":["../../../../../src/utils/AI/autocomplete/index.ts"],"sourcesContent":["import { logger } from '@logger';\nimport { generateText } from 'ai';\nimport { readFileSync } from 'fs';\nimport { dirname, join } from 'path';\nimport { fileURLToPath } from 'url';\nimport { AIConfig, AIOptions, AIProvider } from '../aiSdk';\n\nconst __dirname = dirname(fileURLToPath(import.meta.url));\n\n// Get the content of a file at the specified path\nconst getFileContent = (filePath: string) =>\n  readFileSync(join(__dirname, filePath), { encoding: 'utf-8' });\n\nexport type AutocompleteOptions = {\n  text: string;\n  aiConfig: AIConfig;\n  applicationContext?: string;\n  contextBefore?: string;\n  currentLine?: string;\n  contextAfter?: string;\n};\n\nexport type AutocompleteFileResultData = {\n  autocompletion: string;\n  tokenUsed: number;\n};\n\n// The prompt template to send to the AI model\nconst CHAT_GPT_PROMPT = getFileContent('./PROMPT.md');\n\nexport const aiDefaultOptions: AIOptions = {\n  provider: AIProvider.OPENAI,\n  model: 'gpt-4o-mini',\n  temperature: 0.7,\n  maxTokens: 128,\n};\n\n/**\n * Autocompletes a content declaration file by constructing a prompt for AI models.\n * The prompt includes details about the project's locales, file paths of content declarations,\n * and requests for identifying issues or inconsistencies.\n */\nexport const autocomplete = async ({\n  text,\n  aiConfig,\n  applicationContext,\n  contextBefore,\n  currentLine,\n  contextAfter,\n}: AutocompleteOptions): Promise<AutocompleteFileResultData | undefined> => {\n  // Prepare the prompt for AI by replacing placeholders with actual values.\n  const prompt = CHAT_GPT_PROMPT.replace(\n    '{{applicationContext}}',\n    applicationContext ?? ''\n  )\n    .replace('{{contextBefore}}', contextBefore ?? '')\n    .replace('{{currentLine}}', currentLine ?? '')\n    .replace('{{contextAfter}}', contextAfter ?? '');\n\n  // Use the AI SDK to generate the completion\n  const { text: newContent, usage } = await generateText({\n    ...aiConfig,\n    messages: [\n      { role: 'system', content: prompt },\n      { role: 'assistant', content: text },\n    ],\n    maxTokens: aiConfig.maxTokens ?? 128, // Generate next tokens\n  });\n\n  logger.info(`${usage?.totalTokens ?? 0} tokens used in the request`);\n\n  return {\n    autocompletion: newContent,\n    tokenUsed: usage?.totalTokens ?? 0,\n  };\n};\n"],"mappings":"AAAA,SAAS,cAAc;AACvB,SAAS,oBAAoB;AAC7B,SAAS,oBAAoB;AAC7B,SAAS,SAAS,YAAY;AAC9B,SAAS,qBAAqB;AAC9B,SAA8B,kBAAkB;AAEhD,MAAM,YAAY,QAAQ,cAAc,YAAY,GAAG,CAAC;AAGxD,MAAM,iBAAiB,CAAC,aACtB,aAAa,KAAK,WAAW,QAAQ,GAAG,EAAE,UAAU,QAAQ,CAAC;AAiB/D,MAAM,kBAAkB,eAAe,aAAa;AAE7C,MAAM,mBAA8B;AAAA,EACzC,UAAU,WAAW;AAAA,EACrB,OAAO;AAAA,EACP,aAAa;AAAA,EACb,WAAW;AACb;AAOO,MAAM,eAAe,OAAO;AAAA,EACjC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,MAA4E;AAE1E,QAAM,SAAS,gBAAgB;AAAA,IAC7B;AAAA,IACA,sBAAsB;AAAA,EACxB,EACG,QAAQ,qBAAqB,iBAAiB,EAAE,EAChD,QAAQ,mBAAmB,eAAe,EAAE,EAC5C,QAAQ,oBAAoB,gBAAgB,EAAE;AAGjD,QAAM,EAAE,MAAM,YAAY,MAAM,IAAI,MAAM,aAAa;AAAA,IACrD,GAAG;AAAA,IACH,UAAU;AAAA,MACR,EAAE,MAAM,UAAU,SAAS,OAAO;AAAA,MAClC,EAAE,MAAM,aAAa,SAAS,KAAK;AAAA,IACrC;AAAA,IACA,WAAW,SAAS,aAAa;AAAA;AAAA,EACnC,CAAC;AAED,SAAO,KAAK,GAAG,OAAO,eAAe,CAAC,6BAA6B;AAEnE,SAAO;AAAA,IACL,gBAAgB;AAAA,IAChB,WAAW,OAAO,eAAe;AAAA,EACnC;AACF;","names":[]}

package/dist/esm/utils/access.mjs

@@ -0,0 +1 @@
+//# sourceMappingURL=access.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/esm/utils/accessControl.mjs

@@ -8,6 +8,7 @@ var AccessRule = /* @__PURE__ */ ((AccessRule2) => {
   AccessRule2["hasOrganization"] = "has-organization";
   AccessRule2["hasProject"] = "has-project";
   AccessRule2["hasBearer"] = "has-bearer";
+  AccessRule2["oauth2"] = "oauth2";
   return AccessRule2;
 })(AccessRule || {});
 const accessControl = (res, accessRule) => {
@@ -47,6 +48,12 @@ const accessControl = (res, accessRule) => {
       messages.push("Project is not set");
     }
   }
+  if (accessRuleArray.includes("oauth2" /* oauth2 */)) {
+    if (authType !== "oauth2") {
+      success = false;
+      messages.push("OAuth2 authentication is required");
+    }
+  }
   const knownRules = Object.values(AccessRule);
   const unknownRules = accessRuleArray.filter(
     (rule) => !knownRules.includes(rule)

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

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

package/dist/esm/utils/auth/getAuth.mjs

@@ -0,0 +1,227 @@
+import { sendVerificationUpdate } from "./../../controllers/user.controller.mjs";
+import { logger } from "./../../logger/index.mjs";
+import { sendEmail } from "./../../services/email.service.mjs";
+import { getOrganizationById } from "./../../services/organization.service.mjs";
+import { getProjectById } from "./../../services/project.service.mjs";
+import { getUserById } from "./../../services/user.service.mjs";
+import { mapOrganizationToAPI } from "./../../utils/mapper/organization.mjs";
+import { mapProjectToAPI } from "./../../utils/mapper/project.mjs";
+import { mapUserToAPI } from "./../../utils/mapper/user.mjs";
+import {
+  computeEffectivePermission,
+  getSessionRoles,
+  intersectPermissions
+} from "./../../utils/permissions.mjs";
+import { betterAuth } from "better-auth";
+import { mongodbAdapter } from "better-auth/adapters/mongodb";
+import { createAuthMiddleware } from "better-auth/api";
+import { customSession } from "better-auth/plugins";
+const formatSession = (session) => {
+  const roles = getSessionRoles(session);
+  let permissions = computeEffectivePermission(roles);
+  if (session.permissions) {
+    permissions = intersectPermissions(permissions, session.permissions);
+  }
+  const resultSession = {
+    user: mapUserToAPI(session.user),
+    organization: mapOrganizationToAPI(session.organization),
+    project: mapProjectToAPI(session.project),
+    authType: "session",
+    permissions,
+    roles
+  };
+  return resultSession;
+};
+const getAuth = (dbClient) => {
+  if (!dbClient) {
+    throw new Error("MongoDB connection not established");
+  }
+  const auth = betterAuth({
+    appName: "Intlayer",
+    database: mongodbAdapter(dbClient.db()),
+    /**
+     * User model
+     */
+    user: {
+      modelName: "users"
+    },
+    databaseHooks: {
+      user: {
+        create: {
+          // Runs once, immediately after the INSERT
+          after: async (user) => {
+            if (!user?.emailVerified) return;
+            await sendEmail({
+              type: "welcome",
+              to: user.email,
+              username: user.name ?? user.email.split("@")[0],
+              loginLink: `${process.env.CLIENT_URL}/auth/login`,
+              locale: user.lang
+            });
+            logger.info("Welcome e\u2011mail delivered", {
+              email: user.email
+            });
+          }
+        }
+      }
+    },
+    hooks: {
+      after: createAuthMiddleware(async (ctx) => {
+        const { path, context } = ctx;
+        const newUser = context.newSession?.user;
+        const existingUser = context.session?.user;
+        const user = newUser ?? existingUser;
+        if (!user) return;
+        if (["/verify-email"].includes(path)) {
+          sendVerificationUpdate(user);
+          logger.info("SSE verification update sent", {
+            email: user.email,
+            userId: user.id
+          });
+          await sendEmail({
+            type: "welcome",
+            to: user.email,
+            username: user.name ?? user.email.split("@")[0],
+            loginLink: `${process.env.CLIENT_URL}/auth/login`,
+            locale: user.lang
+          });
+          logger.info("Welcome e\u2011mail delivered", {
+            email: user.email
+          });
+        }
+      })
+    },
+    advanced: {
+      // 1️⃣  Change or drop the global prefix
+      // cookiePrefix: "intlayer",          // =>  intlayer.session_token
+      cookiePrefix: "intlayer",
+      // =>  session_token  (no prefix)
+      // 2️⃣  Override just the session‑token cookie
+      cookies: {
+        session_token: {
+          // name: 'intlayer_session_token', // final name depends on the prefix above
+          // attributes: { sameSite: "lax", maxAge: 60 * 60 * 24 } // optional
+        }
+      }
+      // 3️⃣  (optional) turn off the automatic __Secure‑ prefix in non‑prod
+      // useSecureCookies: false,
+    },
+    session: {
+      modelName: "sessions",
+      id: "id",
+      additionalFields: {
+        activeOrganizationId: { type: "string", nullable: true, input: false },
+        activeProjectId: { type: "string", nullable: true, input: false }
+      }
+    },
+    plugins: [
+      customSession(async ({ session }) => {
+        const typedSession = session;
+        let userAPI = null;
+        let organizationAPI = null;
+        let projectAPI = null;
+        if (typedSession.userId) {
+          const userData = await getUserById(typedSession.userId);
+          if (userData) {
+            userAPI = mapUserToAPI(userData);
+          }
+        }
+        if (typedSession.activeOrganizationId) {
+          const orgData = await getOrganizationById(
+            typedSession.activeOrganizationId
+          );
+          if (orgData) {
+            organizationAPI = mapOrganizationToAPI(orgData);
+          }
+        }
+        if (typedSession.activeProjectId) {
+          const projectData = await getProjectById(
+            typedSession.activeProjectId
+          );
+          if (projectData) {
+            projectAPI = mapProjectToAPI(projectData);
+          }
+        }
+        const sessionWithNoPermission = {
+          session: typedSession,
+          user: userAPI,
+          organization: organizationAPI ?? null,
+          project: projectAPI ?? null,
+          authType: "session"
+        };
+        return formatSession(sessionWithNoPermission);
+      })
+    ],
+    emailAndPassword: {
+      enabled: true,
+      disableSignUp: false,
+      requireEmailVerification: true,
+      minPasswordLength: 8,
+      maxPasswordLength: 128,
+      autoSignIn: true,
+      sendResetPassword: async ({ user, url }) => {
+        logger.info("sending reset password email", { email: user.email });
+        await sendEmail({
+          type: "resetPassword",
+          to: user.email,
+          username: user.name ?? user.email.split("@")[0],
+          resetLink: url
+        });
+      },
+      resetPasswordTokenExpiresIn: 3600
+    },
+    accountLinking: {
+      enabled: true,
+      // allow linking in general
+      trustedProviders: ["google", "github"]
+      // optional: auto‑link when Google verifies the e‑mail
+    },
+    emailVerification: {
+      autoSignInAfterVerification: true,
+      sendVerificationEmail: async ({ user, url }) => {
+        logger.info("sending verification email", { email: user.email });
+        await sendEmail({
+          type: "validate",
+          to: user.email,
+          username: user.name ?? user.email.split("@")[0],
+          validationLink: url
+        });
+      }
+    },
+    crossSubDomainCookies: {
+      enabled: true,
+      additionalCookies: ["session_token"],
+      domain: process.env.CLIENT_URL
+    },
+    cookiePrefix: "intlayer",
+    cookies: {
+      session_token: {
+        name: "session_token",
+        attributes: {
+          httpOnly: true,
+          secure: true
+        }
+      }
+    },
+    trustedOrigins: [process.env.CLIENT_URL],
+    socialProviders: {
+      google: {
+        clientId: process.env.GOOGLE_CLIENT_ID,
+        clientSecret: process.env.GOOGLE_CLIENT_SECRET
+      },
+      github: {
+        clientId: process.env.GITHUB_CLIENT_ID,
+        clientSecret: process.env.GITHUB_CLIENT_SECRET
+      }
+    },
+    logger: {
+      log: (level, message, ...args) => logger[level](message, ...args)
+    }
+  });
+  return auth;
+};
+export {
+  formatSession,
+  getAuth
+};
+//# sourceMappingURL=getAuth.mjs.map

package/dist/esm/utils/auth/getAuth.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/utils/auth/getAuth.ts"],"sourcesContent":["import type { OrganizationAPI } from '@/types/organization.types';\nimport type { ProjectAPI } from '@/types/project.types';\nimport type {\n  SessionAPI,\n  SessionContext,\n  SessionDataApi,\n} from '@/types/session.types';\nimport type { User, UserAPI } from '@/types/user.types';\nimport { sendVerificationUpdate } from '@controllers/user.controller';\nimport { logger } from '@logger';\nimport { sendEmail } from '@services/email.service';\nimport { getOrganizationById } from '@services/organization.service';\nimport { getProjectById } from '@services/project.service';\nimport { getUserById } from '@services/user.service';\nimport { mapOrganizationToAPI } from '@utils/mapper/organization';\nimport { mapProjectToAPI } from '@utils/mapper/project';\nimport { mapUserToAPI } from '@utils/mapper/user';\nimport {\n  computeEffectivePermission,\n  getSessionRoles,\n  intersectPermissions,\n} from '@utils/permissions';\nimport { betterAuth, OmitId } from 'better-auth';\nimport { mongodbAdapter } from 'better-auth/adapters/mongodb';\nimport { createAuthMiddleware } from 'better-auth/api';\nimport { customSession } from 'better-auth/plugins';\nimport type { MongoClient } from 'mongodb';\n\nexport type Auth = ReturnType<typeof betterAuth>;\n\nexport const formatSession = (session: SessionContext): OmitId<SessionAPI> => {\n  const roles = getSessionRoles(session);\n  let permissions = computeEffectivePermission(roles);\n\n  // Intersect in the case a Access Token try to override the permissions\n  if (session.permissions) {\n    permissions = intersectPermissions(permissions, session.permissions);\n  }\n\n  const resultSession = {\n    user: mapUserToAPI(session.user),\n    organization: mapOrganizationToAPI(session.organization),\n    project: mapProjectToAPI(session.project),\n    authType: 'session',\n    permissions,\n    roles,\n  } as OmitId<SessionAPI>;\n\n  return resultSession;\n};\n\nexport const getAuth = (dbClient: MongoClient): Auth => {\n  if (!dbClient) {\n    throw new Error('MongoDB connection not established');\n  }\n\n  const auth = betterAuth({\n    appName: 'Intlayer',\n\n    database: mongodbAdapter(dbClient.db()),\n\n    /**\n     * User model\n     */\n    user: {\n      modelName: 'users',\n    },\n\n    databaseHooks: {\n      user: {\n        create: {\n          // Runs once, immediately after the INSERT\n          after: async (user) => {\n            if (!user?.emailVerified) return;\n\n            await sendEmail({\n              type: 'welcome',\n              to: user.email,\n              username: user.name ?? user.email.split('@')[0],\n              loginLink: `${process.env.CLIENT_URL}/auth/login`,\n              locale: (user as any).lang,\n            });\n            logger.info('Welcome e‑mail delivered', {\n              email: user.email,\n            });\n          },\n        },\n      },\n    },\n\n    hooks: {\n      after: createAuthMiddleware(async (ctx) => {\n        const { path, context } = ctx;\n\n        const newUser = context.newSession?.user;\n        const existingUser = context.session?.user;\n        const user = newUser ?? existingUser;\n\n        if (!user) return;\n\n        if (['/verify-email'].includes(path)) {\n          sendVerificationUpdate(user as unknown as User);\n          logger.info('SSE verification update sent', {\n            email: user.email,\n            userId: user.id,\n          });\n\n          await sendEmail({\n            type: 'welcome',\n            to: user.email,\n            username: user.name ?? user.email.split('@')[0],\n            loginLink: `${process.env.CLIENT_URL}/auth/login`,\n            locale: (user as any).lang,\n          });\n          logger.info('Welcome e‑mail delivered', {\n            email: user.email,\n          });\n        }\n      }),\n    },\n\n    advanced: {\n      // 1️⃣  Change or drop the global prefix\n      // cookiePrefix: \"intlayer\",          // =>  intlayer.session_token\n      cookiePrefix: 'intlayer', // =>  session_token  (no prefix)\n\n      // 2️⃣  Override just the session‑token cookie\n      cookies: {\n        session_token: {\n          // name: 'intlayer_session_token', // final name depends on the prefix above\n          // attributes: { sameSite: \"lax\", maxAge: 60 * 60 * 24 } // optional\n        },\n      },\n\n      // 3️⃣  (optional) turn off the automatic __Secure‑ prefix in non‑prod\n      // useSecureCookies: false,\n    },\n\n    session: {\n      modelName: 'sessions',\n      id: 'id',\n\n      additionalFields: {\n        activeOrganizationId: { type: 'string', nullable: true, input: false },\n        activeProjectId: { type: 'string', nullable: true, input: false },\n      },\n    },\n\n    plugins: [\n      customSession(async ({ session }) => {\n        const typedSession = session as unknown as SessionDataApi;\n\n        let userAPI: UserAPI | null = null;\n        let organizationAPI: OrganizationAPI | null = null;\n        let projectAPI: ProjectAPI | null = null;\n\n        if (typedSession.userId) {\n          const userData = await getUserById(typedSession.userId);\n\n          if (userData) {\n            userAPI = mapUserToAPI(userData);\n          }\n        }\n\n        if (typedSession.activeOrganizationId) {\n          const orgData = await getOrganizationById(\n            typedSession.activeOrganizationId\n          );\n\n          if (orgData) {\n            organizationAPI = mapOrganizationToAPI(orgData);\n          }\n        }\n        if (typedSession.activeProjectId) {\n          const projectData = await getProjectById(\n            typedSession.activeProjectId\n          );\n\n          if (projectData) {\n            projectAPI = mapProjectToAPI(projectData);\n          }\n        }\n\n        const sessionWithNoPermission: SessionContext = {\n          session: typedSession,\n          user: userAPI!,\n          organization: organizationAPI ?? null,\n          project: projectAPI ?? null,\n          authType: 'session',\n        };\n\n        return formatSession(sessionWithNoPermission);\n      }),\n    ],\n\n    emailAndPassword: {\n      enabled: true,\n      disableSignUp: false,\n      requireEmailVerification: true,\n      minPasswordLength: 8,\n      maxPasswordLength: 128,\n      autoSignIn: true,\n      sendResetPassword: async ({ user, url }) => {\n        logger.info('sending reset password email', { email: user.email });\n        await sendEmail({\n          type: 'resetPassword',\n          to: user.email,\n          username: user.name ?? user.email.split('@')[0],\n          resetLink: url,\n        });\n      },\n      resetPasswordTokenExpiresIn: 3600,\n    },\n    accountLinking: {\n      enabled: true, // allow linking in general\n      trustedProviders: ['google', 'github'], // optional: auto‑link when Google verifies the e‑mail\n    },\n    emailVerification: {\n      autoSignInAfterVerification: true,\n      sendVerificationEmail: async ({ user, url }) => {\n        logger.info('sending verification email', { email: user.email });\n        await sendEmail({\n          type: 'validate',\n          to: user.email,\n          username: user.name ?? user.email.split('@')[0],\n          validationLink: url,\n        });\n      },\n    },\n\n    crossSubDomainCookies: {\n      enabled: true,\n      additionalCookies: ['session_token'],\n      domain: process.env.CLIENT_URL as string,\n    },\n    cookiePrefix: 'intlayer',\n    cookies: {\n      session_token: {\n        name: 'session_token',\n        attributes: {\n          httpOnly: true,\n          secure: true,\n        },\n      },\n    },\n\n    trustedOrigins: [process.env.CLIENT_URL as string],\n\n    socialProviders: {\n      google: {\n        clientId: process.env.GOOGLE_CLIENT_ID as string,\n        clientSecret: process.env.GOOGLE_CLIENT_SECRET as string,\n      },\n      github: {\n        clientId: process.env.GITHUB_CLIENT_ID as string,\n        clientSecret: process.env.GITHUB_CLIENT_SECRET as string,\n      },\n    },\n\n    logger: {\n      log: (level, message, ...args) => logger[level](message, ...args),\n    },\n  });\n\n  return auth;\n};\n"],"mappings":"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","names":[]}

package/dist/esm/utils/cors.mjs

@@ -0,0 +1,31 @@
+import { logger } from "./../logger/index.mjs";
+const whitelist = [process.env.CLIENT_URL];
+const corsOptions = {
+  origin: (origin, callback) => {
+    if (!origin) return callback(null, true);
+    if (whitelist.includes(origin)) {
+      logger.info("whitelisted origin", origin);
+      return callback(null, true);
+    }
+    logger.info("non whitelisted origin", origin);
+    callback(null, origin);
+  },
+  allowedHeaders: [
+    "authorization",
+    "Content-Type",
+    "credentials",
+    "cache-control",
+    "Access-Control-Allow-Origin",
+    "private-state-token-redemption",
+    "private-state-token-issuance",
+    "browsing-topics"
+  ],
+  exposedHeaders: [""],
+  preflightContinue: false,
+  methods: "GET,HEAD,PUT,PATCH,POST,DELETE",
+  credentials: true
+};
+export {
+  corsOptions
+};
+//# sourceMappingURL=cors.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/utils/cors.ts"],"sourcesContent":["import { logger } from '@logger';\nimport { CorsOptions } from 'cors';\n\nconst whitelist = [process.env.CLIENT_URL!];\n\nexport const corsOptions: CorsOptions = {\n  origin: (origin, callback) => {\n    // Allow requests with no origin (like mobile apps or curl requests)\n    if (!origin) return callback(null, true);\n\n    if (whitelist.includes(origin)) {\n      logger.info('whitelisted origin', origin);\n      return callback(null, true);\n    }\n\n    logger.info('non whitelisted origin', origin);\n    // Reflect the request's origin (echo back the origin header)\n    callback(null, origin);\n  },\n  allowedHeaders: [\n    'authorization',\n    'Content-Type',\n    'credentials',\n    'cache-control',\n    'Access-Control-Allow-Origin',\n    'private-state-token-redemption',\n    'private-state-token-issuance',\n    'browsing-topics',\n  ],\n  exposedHeaders: [''],\n  preflightContinue: false,\n  methods: 'GET,HEAD,PUT,PATCH,POST,DELETE',\n  credentials: true,\n};\n"],"mappings":"AAAA,SAAS,cAAc;AAGvB,MAAM,YAAY,CAAC,QAAQ,IAAI,UAAW;AAEnC,MAAM,cAA2B;AAAA,EACtC,QAAQ,CAAC,QAAQ,aAAa;AAE5B,QAAI,CAAC,OAAQ,QAAO,SAAS,MAAM,IAAI;AAEvC,QAAI,UAAU,SAAS,MAAM,GAAG;AAC9B,aAAO,KAAK,sBAAsB,MAAM;AACxC,aAAO,SAAS,MAAM,IAAI;AAAA,IAC5B;AAEA,WAAO,KAAK,0BAA0B,MAAM;AAE5C,aAAS,MAAM,MAAM;AAAA,EACvB;AAAA,EACA,gBAAgB;AAAA,IACd;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AAAA,EACA,gBAAgB,CAAC,EAAE;AAAA,EACnB,mBAAmB;AAAA,EACnB,SAAS;AAAA,EACT,aAAa;AACf;","names":[]}

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/utils/ensureMongoDocumentToObject.ts"],"sourcesContent":["import type { Document } from 'mongoose';\n\n/**\n * If the dictionary is a mongoose document, convert it to an object\n * @param potentialDocument - The potential document to convert.\n * @returns The potential document converted to an object.\n */\nexport const ensureMongoDocumentToObject = <T extends object | Document>(\n  potentialDocument: T\n): T => {\n  let potentialObject: T = potentialDocument as T;\n\n  // If the user is a mongoose document, convert it to an object\n  if (typeof (potentialDocument as Document).toObject === 'function') {\n    potentialObject = (potentialDocument as Document).toObject();\n  }\n\n  return potentialObject as T;\n};\n"],"mappings":"AAOO,MAAM,8BAA8B,CACzC,sBACM;AACN,MAAI,kBAAqB;AAGzB,MAAI,OAAQ,kBAA+B,aAAa,YAAY;AAClE,sBAAmB,kBAA+B,SAAS;AAAA,EAC7D;AAEA,SAAO;AACT;","names":[]}
+{"version":3,"sources":["../../../src/utils/ensureMongoDocumentToObject.ts"],"sourcesContent":["import type { Document, ObjectIdToString } from 'mongoose';\n\n/**\n * If the dictionary is a mongoose document, convert it to an object\n * @param potentialDocument - The potential document to convert.\n * @returns The potential document converted to an object.\n */\nexport const ensureMongoDocumentToObject = <T extends object | Document>(\n  potentialDocument: T\n): ObjectIdToString<T> => {\n  let potentialObject: T = potentialDocument as T;\n\n  // If the user is a mongoose document, convert it to an object\n  if (typeof (potentialDocument as Document).toObject === 'function') {\n    potentialObject = (potentialDocument as Document).toObject();\n  }\n\n  return potentialObject as ObjectIdToString<T>;\n};\n"],"mappings":"AAOO,MAAM,8BAA8B,CACzC,sBACwB;AACxB,MAAI,kBAAqB;AAGzB,MAAI,OAAQ,kBAA+B,aAAa,YAAY;AAClE,sBAAmB,kBAA+B,SAAS;AAAA,EAC7D;AAEA,SAAO;AACT;","names":[]}

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

@@ -1,9 +1,9 @@
 import { Locales } from "@intlayer/config";
 import { logger } from "./../../logger/index.mjs";
 import { formatPaginatedResponse, formatResponse } from "./../../utils/responseData.mjs";
+import { HttpStatusCodes } from "./../../export.mjs";
 import { t } from "express-intlayer";
 import { errorData } from "./errorCodes.mjs";
-import { HttpStatusCodes } from "./../../export.mjs";
 class ErrorHandler {
   /**
    * Handles generic error responses by formatting and sending a JSON response.
@@ -49,7 +49,7 @@ class ErrorHandler {
       res,
       error.errorKey,
       isMultilingual ? error.multilingualTitle : error.title,
-      isMultilingual ? error.multilingualMessage : error.multilingualMessage,
+      isMultilingual ? error.multilingualMessage : error.message,
       error.messageDetails ?? messageDetails,
       error.httpStatusCode,
       isPaginatedResponse

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/utils/errors/ErrorHandler.ts"],"sourcesContent":["// Import required modules and types from their respective locations.\nimport { Locales } from '@intlayer/config';\nimport { logger } from '@logger';\nimport { formatPaginatedResponse, formatResponse } from '@utils/responseData';\nimport type { Response } from 'express';\n// @ts-ignore express-intlayer not build yet\nimport type { LanguageContent } from 'express-intlayer';\nimport { t } from 'express-intlayer';\nimport { type ErrorCodes, errorData } from './errorCodes';\nimport type { AppError } from './ErrorsClass';\nimport { type UserAPI, HttpStatusCodes } from '@/export';\n\n// Define a class named 'ErrorHandler' to encapsulate error handling logic.\nexport class ErrorHandler {\n  /**\n   * Handles generic error responses by formatting and sending a JSON response.\n   * @param res - The response object provided by Express.js.\n   * @param errorKey - A key representing the specific error.\n   * @param statusCode - (Optional) A specific HTTP status code to use for the response.\n   * @param isPaginatedResponse - Flag to determine if the response should be paginated.\n   */\n  static handleGenericErrorResponse(\n    res: Response,\n    errorKey: ErrorCodes,\n    errorDetails?: object,\n    statusCode?: HttpStatusCodes,\n    isPaginatedResponse: boolean = false\n  ) {\n    const error = errorData[errorKey];\n    const status = statusCode ?? error.statusCode; // Use the provided status code or default to the one in errorData.\n\n    // Delegate to a more customizable error response handler.\n    this.handleCustomErrorResponse(\n      res,\n      errorKey,\n      error.title,\n      error.message,\n      errorDetails,\n      status,\n      isPaginatedResponse\n    );\n  }\n\n  /**\n   * Handles application-specific error responses by formatting and sending a JSON response.\n   * @param res - The response object provided by Express.js.\n   * @param error - The error object.\n   * @param messageDetails - (Optional) Additional message details to include in the response.\n   * @param isPaginatedResponse - (Optional) Flag to determine if the response should be paginated.\n   */\n  static handleAppErrorResponse(\n    res: Response,\n    error: AppError,\n    messageDetails?: object,\n    isPaginatedResponse: boolean = false\n  ) {\n    if (!error.isAppError) {\n      this.handleCustomErrorResponse(\n        res,\n        error.errorKey ?? 'UNKNOWN_ERROR',\n        'Error',\n        error.message ?? JSON.stringify(error),\n        undefined,\n        error.httpStatusCode ?? HttpStatusCodes.INTERNAL_SERVER_ERROR_500,\n        isPaginatedResponse\n      );\n    }\n\n    const isMultilingual = error.isMultilingual ?? false;\n    // Delegate to a more customizable error response handler.\n    this.handleCustomErrorResponse(\n      res,\n      error.errorKey,\n      isMultilingual ? error.multilingualTitle : error.title,\n      isMultilingual ? error.multilingualMessage : error.multilingualMessage,\n      error.messageDetails ?? messageDetails,\n      error.httpStatusCode,\n      isPaginatedResponse\n    );\n  }\n\n  /**\n   * Handles more customizable error responses with detailed error messages and codes.\n   * @param res - The response object.\n   * @param errorKey - Error code key used to fetch the corresponding message and default status.\n   * @param message - The localized error message object.\n   * @param messageDetails - (Optional) Additional message details to include in the response.\n   * @param statusCode - (Optional) HTTP status code, defaults to 500 if not specified.\n   * @param isPaginatedResponse - Determines if the error should be part of a paginated response.\n   */\n  static handleCustomErrorResponse<T>(\n    res: Response,\n    errorKey: ErrorCodes | string,\n    title: LanguageContent<string> | string,\n    message: LanguageContent<string> | string,\n    messageDetails?: object,\n    statusCode?: HttpStatusCodes,\n    isPaginatedResponse: boolean = false\n  ) {\n    const errorTitle = t(title as LanguageContent<string>, Locales.ENGLISH);\n    const errorMessage = t(message as LanguageContent<string>, Locales.ENGLISH);\n    logger.error(errorMessage, messageDetails); // Log the English version of the error message.\n    const status = statusCode ?? HttpStatusCodes.INTERNAL_SERVER_ERROR_500; // Default to 500 if no status code is provided.\n\n    if (isPaginatedResponse) {\n      // Format the response as a paginated error response if requested.\n      const responseData = formatPaginatedResponse<T>({\n        error: {\n          code: errorKey,\n          title: errorTitle,\n          message: errorMessage,\n        },\n        status,\n      });\n      res.status(status).json(responseData);\n      return;\n    }\n\n    // Format the response as a standard non-paginated error response.\n    const responseData = formatResponse<UserAPI>({\n      error: {\n        code: errorKey,\n        title: errorTitle,\n        message: errorMessage,\n        ...messageDetails,\n      },\n      status,\n    });\n\n    res.status(status).json(responseData);\n  }\n}\n"],"mappings":"AACA,SAAS,eAAe;AACxB,SAAS,cAAc;AACvB,SAAS,yBAAyB,sBAAsB;AAIxD,SAAS,SAAS;AAClB,SAA0B,iBAAiB;AAE3C,SAAuB,uBAAuB;AAGvC,MAAM,aAAa;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQxB,OAAO,2BACL,KACA,UACA,cACA,YACA,sBAA+B,OAC/B;AACA,UAAM,QAAQ,UAAU,QAAQ;AAChC,UAAM,SAAS,cAAc,MAAM;AAGnC,SAAK;AAAA,MACH;AAAA,MACA;AAAA,MACA,MAAM;AAAA,MACN,MAAM;AAAA,MACN;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,OAAO,uBACL,KACA,OACA,gBACA,sBAA+B,OAC/B;AACA,QAAI,CAAC,MAAM,YAAY;AACrB,WAAK;AAAA,QACH;AAAA,QACA,MAAM,YAAY;AAAA,QAClB;AAAA,QACA,MAAM,WAAW,KAAK,UAAU,KAAK;AAAA,QACrC;AAAA,QACA,MAAM,kBAAkB,gBAAgB;AAAA,QACxC;AAAA,MACF;AAAA,IACF;AAEA,UAAM,iBAAiB,MAAM,kBAAkB;AAE/C,SAAK;AAAA,MACH;AAAA,MACA,MAAM;AAAA,MACN,iBAAiB,MAAM,oBAAoB,MAAM;AAAA,MACjD,iBAAiB,MAAM,sBAAsB,MAAM;AAAA,MACnD,MAAM,kBAAkB;AAAA,MACxB,MAAM;AAAA,MACN;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWA,OAAO,0BACL,KACA,UACA,OACA,SACA,gBACA,YACA,sBAA+B,OAC/B;AACA,UAAM,aAAa,EAAE,OAAkC,QAAQ,OAAO;AACtE,UAAM,eAAe,EAAE,SAAoC,QAAQ,OAAO;AAC1E,WAAO,MAAM,cAAc,cAAc;AACzC,UAAM,SAAS,cAAc,gBAAgB;AAE7C,QAAI,qBAAqB;AAEvB,YAAMA,gBAAe,wBAA2B;AAAA,QAC9C,OAAO;AAAA,UACL,MAAM;AAAA,UACN,OAAO;AAAA,UACP,SAAS;AAAA,QACX;AAAA,QACA;AAAA,MACF,CAAC;AACD,UAAI,OAAO,MAAM,EAAE,KAAKA,aAAY;AACpC;AAAA,IACF;AAGA,UAAM,eAAe,eAAwB;AAAA,MAC3C,OAAO;AAAA,QACL,MAAM;AAAA,QACN,OAAO;AAAA,QACP,SAAS;AAAA,QACT,GAAG;AAAA,MACL;AAAA,MACA;AAAA,IACF,CAAC;AAED,QAAI,OAAO,MAAM,EAAE,KAAK,YAAY;AAAA,EACtC;AACF;","names":["responseData"]}
+{"version":3,"sources":["../../../../src/utils/errors/ErrorHandler.ts"],"sourcesContent":["// Import required modules and types from their respective locations.\nimport { Locales } from '@intlayer/config';\nimport { logger } from '@logger';\nimport { formatPaginatedResponse, formatResponse } from '@utils/responseData';\nimport type { Response } from 'express';\n// @ts-ignore express-intlayer not build yet\nimport { type UserAPI, HttpStatusCodes } from '@/export';\nimport type { LanguageContent } from 'express-intlayer';\nimport { t } from 'express-intlayer';\nimport { type ErrorCodes, errorData } from './errorCodes';\nimport type { AppError } from './ErrorsClass';\n\n// Define a class named 'ErrorHandler' to encapsulate error handling logic.\nexport class ErrorHandler {\n  /**\n   * Handles generic error responses by formatting and sending a JSON response.\n   * @param res - The response object provided by Express.js.\n   * @param errorKey - A key representing the specific error.\n   * @param statusCode - (Optional) A specific HTTP status code to use for the response.\n   * @param isPaginatedResponse - Flag to determine if the response should be paginated.\n   */\n  static handleGenericErrorResponse(\n    res: Response,\n    errorKey: ErrorCodes,\n    errorDetails?: object,\n    statusCode?: HttpStatusCodes,\n    isPaginatedResponse: boolean = false\n  ) {\n    const error = errorData[errorKey];\n    const status = statusCode ?? error.statusCode; // Use the provided status code or default to the one in errorData.\n\n    // Delegate to a more customizable error response handler.\n    this.handleCustomErrorResponse(\n      res,\n      errorKey,\n      error.title,\n      error.message,\n      errorDetails,\n      status,\n      isPaginatedResponse\n    );\n  }\n\n  /**\n   * Handles application-specific error responses by formatting and sending a JSON response.\n   * @param res - The response object provided by Express.js.\n   * @param error - The error object.\n   * @param messageDetails - (Optional) Additional message details to include in the response.\n   * @param isPaginatedResponse - (Optional) Flag to determine if the response should be paginated.\n   */\n  static handleAppErrorResponse(\n    res: Response,\n    error: AppError,\n    messageDetails?: object,\n    isPaginatedResponse: boolean = false\n  ) {\n    if (!error.isAppError) {\n      this.handleCustomErrorResponse(\n        res,\n        error.errorKey ?? 'UNKNOWN_ERROR',\n        'Error',\n        error.message ?? JSON.stringify(error),\n        undefined,\n        error.httpStatusCode ?? HttpStatusCodes.INTERNAL_SERVER_ERROR_500,\n        isPaginatedResponse\n      );\n    }\n\n    const isMultilingual = error.isMultilingual ?? false;\n    // Delegate to a more customizable error response handler.\n    this.handleCustomErrorResponse(\n      res,\n      error.errorKey,\n      isMultilingual ? error.multilingualTitle : error.title,\n      isMultilingual ? error.multilingualMessage : error.message,\n      error.messageDetails ?? messageDetails,\n      error.httpStatusCode,\n      isPaginatedResponse\n    );\n  }\n\n  /**\n   * Handles more customizable error responses with detailed error messages and codes.\n   * @param res - The response object.\n   * @param errorKey - Error code key used to fetch the corresponding message and default status.\n   * @param message - The localized error message object.\n   * @param messageDetails - (Optional) Additional message details to include in the response.\n   * @param statusCode - (Optional) HTTP status code, defaults to 500 if not specified.\n   * @param isPaginatedResponse - Determines if the error should be part of a paginated response.\n   */\n  static handleCustomErrorResponse<T>(\n    res: Response,\n    errorKey: ErrorCodes | string,\n    title: LanguageContent<string> | string,\n    message: LanguageContent<string> | string,\n    messageDetails?: object,\n    statusCode?: HttpStatusCodes,\n    isPaginatedResponse: boolean = false\n  ) {\n    const errorTitle = t(title as LanguageContent<string>, Locales.ENGLISH);\n    const errorMessage = t(message as LanguageContent<string>, Locales.ENGLISH);\n    logger.error(errorMessage, messageDetails); // Log the English version of the error message.\n    const status = statusCode ?? HttpStatusCodes.INTERNAL_SERVER_ERROR_500; // Default to 500 if no status code is provided.\n\n    if (isPaginatedResponse) {\n      // Format the response as a paginated error response if requested.\n      const responseData = formatPaginatedResponse<T>({\n        error: {\n          code: errorKey,\n          title: errorTitle,\n          message: errorMessage,\n        },\n        status,\n      });\n      res.status(status).json(responseData);\n      return;\n    }\n\n    // Format the response as a standard non-paginated error response.\n    const responseData = formatResponse<UserAPI>({\n      error: {\n        code: errorKey,\n        title: errorTitle,\n        message: errorMessage,\n        ...messageDetails,\n      },\n      status,\n    });\n\n    res.status(status).json(responseData);\n  }\n}\n"],"mappings":"AACA,SAAS,eAAe;AACxB,SAAS,cAAc;AACvB,SAAS,yBAAyB,sBAAsB;AAGxD,SAAuB,uBAAuB;AAE9C,SAAS,SAAS;AAClB,SAA0B,iBAAiB;AAIpC,MAAM,aAAa;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQxB,OAAO,2BACL,KACA,UACA,cACA,YACA,sBAA+B,OAC/B;AACA,UAAM,QAAQ,UAAU,QAAQ;AAChC,UAAM,SAAS,cAAc,MAAM;AAGnC,SAAK;AAAA,MACH;AAAA,MACA;AAAA,MACA,MAAM;AAAA,MACN,MAAM;AAAA,MACN;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,OAAO,uBACL,KACA,OACA,gBACA,sBAA+B,OAC/B;AACA,QAAI,CAAC,MAAM,YAAY;AACrB,WAAK;AAAA,QACH;AAAA,QACA,MAAM,YAAY;AAAA,QAClB;AAAA,QACA,MAAM,WAAW,KAAK,UAAU,KAAK;AAAA,QACrC;AAAA,QACA,MAAM,kBAAkB,gBAAgB;AAAA,QACxC;AAAA,MACF;AAAA,IACF;AAEA,UAAM,iBAAiB,MAAM,kBAAkB;AAE/C,SAAK;AAAA,MACH;AAAA,MACA,MAAM;AAAA,MACN,iBAAiB,MAAM,oBAAoB,MAAM;AAAA,MACjD,iBAAiB,MAAM,sBAAsB,MAAM;AAAA,MACnD,MAAM,kBAAkB;AAAA,MACxB,MAAM;AAAA,MACN;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWA,OAAO,0BACL,KACA,UACA,OACA,SACA,gBACA,YACA,sBAA+B,OAC/B;AACA,UAAM,aAAa,EAAE,OAAkC,QAAQ,OAAO;AACtE,UAAM,eAAe,EAAE,SAAoC,QAAQ,OAAO;AAC1E,WAAO,MAAM,cAAc,cAAc;AACzC,UAAM,SAAS,cAAc,gBAAgB;AAE7C,QAAI,qBAAqB;AAEvB,YAAMA,gBAAe,wBAA2B;AAAA,QAC9C,OAAO;AAAA,UACL,MAAM;AAAA,UACN,OAAO;AAAA,UACP,SAAS;AAAA,QACX;AAAA,QACA;AAAA,MACF,CAAC;AACD,UAAI,OAAO,MAAM,EAAE,KAAKA,aAAY;AACpC;AAAA,IACF;AAGA,UAAM,eAAe,eAAwB;AAAA,MAC3C,OAAO;AAAA,QACL,MAAM;AAAA,QACN,OAAO;AAAA,QACP,SAAS;AAAA,QACT,GAAG;AAAA,MACL;AAAA,MACA;AAAA,IACF,CAAC;AAED,QAAI,OAAO,MAAM,EAAE,KAAK,YAAY;AAAA,EACtC;AACF;","names":["responseData"]}