@intlayer/backend 3.5.4 → 3.5.6

package/dist/esm/utils/auditDictionaryMetadata/PROMPT.md

@@ -0,0 +1,76 @@
+Your role is to review content declaration fields. Correct this fields if they are misspelled or do not match the expected content, and / or complete missing content.
+
+1. **Terminology:**
+
+- **Content Declaration:** A content declaration is a is a file (.ts, .js or .json) that contains the multilingual declaration related to a specific content. A content declaration file is usually related to a specific component, or page or section of a website.
+- **Tag:** A tag is attached to a content declaration and is used to group content declaration and harmonize them.
+
+2. **Audit Requirements:**
+
+   - **Do Not Alter Structure:** If the file structure is correct, do not modify it. Only add, update, or remove content declarations as necessary.
+   - **Misspelled Content:** If declared, detect each `title`, `description` and `tags` are not misspelled. If some content is misspelled, correct it.
+
+3. **Fields functions:**
+
+- **Title:** The title of the content declaration allows to easily identify it. It should be considered as a readable way to represent the `key` (example: `page-metadata` -> `Page metadata`). It should be a short and descriptive title that accurately reflects the dictionary.
+- **Description:** The description of the content declaration provides a brief summary of the content declaration. It should be a concise and informative description that explains the purpose and content of the dictionary.
+- **Tags:** The tags is an array of strings that represent the key of the tags associated with the content declaration.
+
+**Expected Response:**
+
+After completion, provide only the final title, description and tags fields in a JSON without any Markdown, code block formatting or any additional comments or explanations.
+
+**Example of expected response:**
+
+- Entry:
+
+```ts
+import { t, type DeclarationContent } from "intlayer";
+import { Metadata } from "next";
+
+const metadataContent = {
+  key: "pricing-metadata",
+  title: "",
+  description:
+    "here a description that doesn't make any sense and should be replaced",
+  content: {
+    title: t({
+      en: "Pricing | Intlayer",
+      fr: "Tarification | Intlayer",
+      es: "Precios | Intlayer",
+    }),
+    description: t({
+      en: "Discover our pricing plans and get access to premium features with Intlayer. Choose the plan that suits you best.",
+      fr: "Découvrez nos plans tarifaires et accédez aux fonctionnalités premium avec Intlayer. Choisissez le plan qui vous convient le mieux.",
+      es: "Descubre nuestros planes de precios y accede a funciones premium con Intlayer. Elige el plan que mejor te convenga.",
+    }),
+    keywords: t<string[]>({
+      en: ["Pricing", "Subscription"],
+      fr: ["Tarification", "Abonnement"],
+      es: ["Precios", "Suscripción"],
+    }),
+  },
+} satisfies DeclarationContent<Metadata>;
+
+export default metadataContent;
+```
+
+- Response:
+
+```json
+{
+  "title": "Pricing page metadata",
+  "description": "Metadata related to the pricing page, includes title, description, keywords, metadata for SEO purpose. It will help search engines understand the content of the page.",
+  "tags": ["page metadata", "pricing page"]
+}
+```
+
+**List of existing Tags:**
+
+Here the list of existing tags as a context to help you to pick related ones.
+
+{{tags}}
+
+**Content Declaration to complete:**
+
+{{contentDeclaration}}

package/dist/esm/utils/auditDictionaryMetadata/index.mjs

@@ -0,0 +1,53 @@
+import { readFileSync } from "fs";
+import { dirname, join } from "path";
+import { fileURLToPath } from "url";
+import { logger } from './../../logger/index.mjs';
+import { OpenAI } from "openai";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const getFileContent = (relativeFilePath) => {
+  const absolutePath = join(__dirname, relativeFilePath);
+  const fileContent = readFileSync(absolutePath, "utf-8");
+  return fileContent;
+};
+const CHAT_GPT_PROMPT = getFileContent("./PROMPT.md");
+const auditDictionaryMetadata = async ({
+  model,
+  openAiApiKey,
+  customPrompt,
+  tags,
+  fileContent
+}) => {
+  try {
+    const openai = new OpenAI({
+      apiKey: openAiApiKey
+    });
+    const prompt = customPrompt ?? CHAT_GPT_PROMPT.replace(
+      "{{tags}}",
+      `${JSON.stringify(
+        tags.map(({ key, description }) => `- ${key}: ${description}`).join("\n\n"),
+        null,
+        2
+      )}`
+    ).replace("{{contentDeclaration}}", fileContent);
+    console.log("prompt", prompt);
+    const chatCompletion = await openai.chat.completions.create({
+      model: model ?? "gpt-4o-mini",
+      messages: [{ role: "system", content: prompt }]
+    });
+    const newContent = chatCompletion.choices[0].message?.content;
+    console.log("newContent", newContent);
+    logger.info(
+      `${chatCompletion.usage?.total_tokens} tokens used in the request`
+    );
+    return {
+      fileContent: newContent ?? "",
+      tokenUsed: chatCompletion.usage?.total_tokens ?? 0
+    };
+  } catch (error) {
+    console.error(error);
+  }
+};
+export {
+  auditDictionaryMetadata
+};
+//# sourceMappingURL=index.mjs.map

package/dist/esm/utils/auditDictionaryMetadata/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/utils/auditDictionaryMetadata/index.ts"],"sourcesContent":["import { readFileSync } from 'fs';\nimport { dirname, join } from 'path';\nimport { fileURLToPath } from 'url';\nimport { logger } from '@logger';\nimport { OpenAI } from 'openai';\nimport { Tag } from '@/types/tag.types';\n\nconst __dirname = dirname(fileURLToPath(import.meta.url));\n\nexport type AuditOptions = {\n  tags: Tag[];\n  fileContent: string;\n  model?: string;\n  openAiApiKey: string;\n  customPrompt?: string;\n};\nexport type AuditFileResultData = { fileContent: string; tokenUsed: number };\n\n/**\n * Reads the content of a file synchronously.\n *\n * @function\n * @param relativeFilePath - The relative or absolute path to the target file.\n * @returns The entire contents of the specified file as a UTF-8 encoded string.\n */\nconst getFileContent = (relativeFilePath: string): string => {\n  const absolutePath = join(__dirname, relativeFilePath);\n  const fileContent = readFileSync(absolutePath, 'utf-8');\n  return fileContent;\n};\n\n// The prompt template to send to ChatGPT, requesting an audit of content declaration files.\nconst CHAT_GPT_PROMPT = getFileContent('./PROMPT.md');\n\n/**\n * Audits a content declaration file by constructing a prompt for ChatGPT.\n * The prompt includes details about the project's locales, file paths of content declarations,\n * and requests for identifying issues or inconsistencies. It prints the prompt for each file,\n * and could be adapted to send requests to the ChatGPT model.\n *\n */\nexport const auditDictionaryMetadata = async ({\n  model,\n  openAiApiKey,\n  customPrompt,\n  tags,\n  fileContent,\n}: AuditOptions): Promise<AuditFileResultData | undefined> => {\n  try {\n    // Optionally, you could initialize and configure the OpenAI client here, if you intend to make API calls.\n    // Uncomment and configure the following lines if you have `openai` installed and want to call the API:\n\n    const openai = new OpenAI({\n      apiKey: openAiApiKey,\n    });\n\n    // Prepare the prompt for ChatGPT by replacing placeholders with actual values.\n    const prompt =\n      customPrompt ??\n      CHAT_GPT_PROMPT.replace(\n        '{{tags}}',\n        `${JSON.stringify(\n          tags\n            .map(({ key, description }) => `- ${key}: ${description}`)\n            .join('\\n\\n'),\n          null,\n          2\n        )}`\n      ).replace('{{contentDeclaration}}', fileContent);\n\n    console.log('prompt', prompt);\n\n    // Example of how you might request a completion from ChatGPT:\n    const chatCompletion = await openai.chat.completions.create({\n      model: model ?? 'gpt-4o-mini',\n      messages: [{ role: 'system', content: prompt }],\n    });\n\n    const newContent = chatCompletion.choices[0].message?.content;\n\n    console.log('newContent', newContent);\n\n    logger.info(\n      `${chatCompletion.usage?.total_tokens} tokens used in the request`\n    );\n\n    return {\n      fileContent: newContent ?? '',\n      tokenUsed: chatCompletion.usage?.total_tokens ?? 0,\n    };\n  } catch (error) {\n    console.error(error);\n  }\n};\n"],"mappings":"AAAA,SAAS,oBAAoB;AAC7B,SAAS,SAAS,YAAY;AAC9B,SAAS,qBAAqB;AAC9B,SAAS,cAAc;AACvB,SAAS,cAAc;AAGvB,MAAM,YAAY,QAAQ,cAAc,YAAY,GAAG,CAAC;AAkBxD,MAAM,iBAAiB,CAAC,qBAAqC;AAC3D,QAAM,eAAe,KAAK,WAAW,gBAAgB;AACrD,QAAM,cAAc,aAAa,cAAc,OAAO;AACtD,SAAO;AACT;AAGA,MAAM,kBAAkB,eAAe,aAAa;AAS7C,MAAM,0BAA0B,OAAO;AAAA,EAC5C;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,MAA8D;AAC5D,MAAI;AAIF,UAAM,SAAS,IAAI,OAAO;AAAA,MACxB,QAAQ;AAAA,IACV,CAAC;AAGD,UAAM,SACJ,gBACA,gBAAgB;AAAA,MACd;AAAA,MACA,GAAG,KAAK;AAAA,QACN,KACG,IAAI,CAAC,EAAE,KAAK,YAAY,MAAM,KAAK,GAAG,KAAK,WAAW,EAAE,EACxD,KAAK,MAAM;AAAA,QACd;AAAA,QACA;AAAA,MACF,CAAC;AAAA,IACH,EAAE,QAAQ,0BAA0B,WAAW;AAEjD,YAAQ,IAAI,UAAU,MAAM;AAG5B,UAAM,iBAAiB,MAAM,OAAO,KAAK,YAAY,OAAO;AAAA,MAC1D,OAAO,SAAS;AAAA,MAChB,UAAU,CAAC,EAAE,MAAM,UAAU,SAAS,OAAO,CAAC;AAAA,IAChD,CAAC;AAED,UAAM,aAAa,eAAe,QAAQ,CAAC,EAAE,SAAS;AAEtD,YAAQ,IAAI,cAAc,UAAU;AAEpC,WAAO;AAAA,MACL,GAAG,eAAe,OAAO,YAAY;AAAA,IACvC;AAEA,WAAO;AAAA,MACL,aAAa,cAAc;AAAA,MAC3B,WAAW,eAAe,OAAO,gBAAgB;AAAA,IACnD;AAAA,EACF,SAAS,OAAO;AACd,YAAQ,MAAM,KAAK;AAAA,EACrB;AACF;","names":[]}

package/dist/esm/utils/auditTag/PROMPT.md

@@ -0,0 +1,34 @@
+Your role is to review a tag. A tag is attached to a content declaration and is used to group content declarations and harmonize them.
+
+- Here an example of a tag of a random project:
+
+  ````json
+  {
+    "key": "page-metadata",
+    "name": "Page metadata",
+    "description": "Contain all metadata related to the page, such as title, description, keywords, etc for SEO purpose. It will help search engines understand the content of the page.",
+    "instructions": "## Metadata Tag//## Content Declaration structure//A content declaration containing this tag should a least includes the following fields://- title/- description/- keywords//### Example of structure//```json/{/  \"key\": \"...\",/  \"content\": {/    \"title\": \"...\",/    \"description\": \"...\",/    \"keywords\": [\"...\", \"...\", \"...\"]/  }/}/```//## Fields instructions//### 1. **Title Tag**//#### **Purpose**//The title tag defines the title of your webpage. It's displayed on search engine results pages (SERPs) as the clickable headline and is essential for both SEO and user experience.//#### **Best Practices**//- **Length:** Aim for **50-60 characters**. Search engines typically display the first 50-60 characters of a title tag. Titles longer than this may be truncated./- **Keywords:** Include primary keywords relevant to the page content, preferably toward the beginning./- **Clarity and Relevance:** Ensure the title accurately reflects the content of the page./- **Branding:** If appropriate, include your brand name at the end of the title (e.g., \"How to Bake a Cake | YourBrand\")./- **Uniqueness:** Each page on your website should have a unique title to avoid confusion and duplication issues.//### 2. **Meta Description**//#### **Purpose**//The meta description provides a brief summary of the webpage's content. While not a direct ranking factor, a compelling meta description can improve click-through rates (CTR) from SERPs.//#### **Best Practices**//- **Length:** Keep it between **150-160 characters**. Descriptions longer than this may be cut off in search results./- **Engaging and Inviting:** Write a clear, concise, and enticing summary that encourages users to click./- **Include Keywords:** Incorporate relevant keywords naturally, as they may be bolded in SERPs when they match the search query./- **Call to Action (CTA):** Use action-oriented language (e.g., \"Learn more,\" \"Discover,\" \"Get started\")./- **Unique Descriptions:** Ensure each page has a unique meta description to differentiate it from others.//### 3. **Meta Keywords**//#### **Purpose**//Historically used to list important keywords for a webpage. However, most modern search engines no longer use meta keywords for ranking.//#### **Best Practices**//- **Page Related Keywords:** The provided keywords should be relevant to the content of the page./- **Uniqueness:** Each page on your website should have a unique set of keywords to avoid confusion and duplication issues./- **Keyword number:** The number of keywords should be between 3-10."
+  }
+  ````
+
+1. **Audit Requirements:**
+
+   - **Misplaced Content:** Detect each `title`, `description` and `instructions` are defined correct. If not, provide the expected content.
+   - **Ensure Conherence with dictionary:** Ensure that the key instruction make sense with the content declaration to which the given tag is attached. If the instructions doesn't looks appropriate, suggest a new one.
+
+2. **Modification Guidelines:**
+
+   - **Do Not Alter Structure:** If the file structure is correct, do not modify it. Only add, update, or remove content declarations as necessary.
+   - **Return Only Final File Content:** Provide the updated file content without any additional comments or explanations.
+
+**Tags to Audit:**
+
+{{tag}}
+
+**Content Declaration that attach the tag into:**
+
+{{contentDeclarations}}
+
+**Expected Response:**
+
+After auditing, provide only the final content of the file as plain text without any Markdown or code block formatting. If no changes are needed, return the file content exactly as it is.

package/dist/esm/utils/auditTag/index.mjs

@@ -0,0 +1,49 @@
+import { readFileSync } from "fs";
+import { dirname, join } from "path";
+import { fileURLToPath } from "url";
+import { logger } from './../../logger/index.mjs';
+import { OpenAI } from "openai";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const getFileContent = (relativeFilePath) => {
+  const absolutePath = join(__dirname, relativeFilePath);
+  const fileContent = readFileSync(absolutePath, "utf-8");
+  return fileContent;
+};
+const CHAT_GPT_PROMPT = getFileContent("./PROMPT.md");
+const auditTag = async ({
+  model,
+  openAiApiKey,
+  customPrompt,
+  tag,
+  dictionaries
+}) => {
+  try {
+    const openai = new OpenAI({
+      apiKey: openAiApiKey
+    });
+    const prompt = customPrompt ?? CHAT_GPT_PROMPT.replace("{{tag}}", `${JSON.stringify(tag)}`).replace(
+      "{{contentDeclarations}}",
+      dictionaries.map((dictionary) => `- ${JSON.stringify(dictionary)}`).join("\n\n")
+    );
+    console.log("prompt", prompt);
+    const chatCompletion = await openai.chat.completions.create({
+      model: model ?? "gpt-4o-mini",
+      messages: [{ role: "system", content: prompt }]
+    });
+    const newContent = chatCompletion.choices[0].message?.content;
+    console.log("newContent", newContent);
+    logger.info(
+      `${chatCompletion.usage?.total_tokens} tokens used in the request`
+    );
+    return {
+      fileContent: newContent ?? "",
+      tokenUsed: chatCompletion.usage?.total_tokens ?? 0
+    };
+  } catch (error) {
+    console.error(error);
+  }
+};
+export {
+  auditTag
+};
+//# sourceMappingURL=index.mjs.map

package/dist/esm/utils/auditTag/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/utils/auditTag/index.ts"],"sourcesContent":["import { readFileSync } from 'fs';\nimport { dirname, join } from 'path';\nimport { fileURLToPath } from 'url';\nimport { logger } from '@logger';\nimport { OpenAI } from 'openai';\nimport { Dictionary } from '@/types/dictionary.types';\nimport { Tag } from '@/types/tag.types';\n\nconst __dirname = dirname(fileURLToPath(import.meta.url));\n\nexport type AuditOptions = {\n  tag: Tag;\n  dictionaries: Dictionary[];\n  model?: string;\n  openAiApiKey: string;\n  customPrompt?: string;\n};\nexport type AuditFileResultData = { fileContent: string; tokenUsed: number };\n\n/**\n * Reads the content of a file synchronously.\n *\n * @function\n * @param relativeFilePath - The relative or absolute path to the target file.\n * @returns The entire contents of the specified file as a UTF-8 encoded string.\n */\nconst getFileContent = (relativeFilePath: string): string => {\n  const absolutePath = join(__dirname, relativeFilePath);\n  const fileContent = readFileSync(absolutePath, 'utf-8');\n  return fileContent;\n};\n\n// The prompt template to send to ChatGPT, requesting an audit of content declaration files.\nconst CHAT_GPT_PROMPT = getFileContent('./PROMPT.md');\n\n/**\n * Audits a content declaration file by constructing a prompt for ChatGPT.\n * The prompt includes details about the project's locales, file paths of content declarations,\n * and requests for identifying issues or inconsistencies. It prints the prompt for each file,\n * and could be adapted to send requests to the ChatGPT model.\n *\n * @async\n * @function\n * @param filePath - The relative or absolute path to the target file.\n * @param options - Optional configuration for the audit process.\n * @returns This function returns a Promise that resolves once the audit is complete.\n */\nexport const auditTag = async ({\n  model,\n  openAiApiKey,\n  customPrompt,\n  tag,\n  dictionaries,\n}: AuditOptions): Promise<AuditFileResultData | undefined> => {\n  try {\n    // Optionally, you could initialize and configure the OpenAI client here, if you intend to make API calls.\n    // Uncomment and configure the following lines if you have `openai` installed and want to call the API:\n\n    const openai = new OpenAI({\n      apiKey: openAiApiKey,\n    });\n\n    // Prepare the prompt for ChatGPT by replacing placeholders with actual values.\n    const prompt =\n      customPrompt ??\n      CHAT_GPT_PROMPT.replace('{{tag}}', `${JSON.stringify(tag)}`).replace(\n        '{{contentDeclarations}}',\n        dictionaries\n          .map((dictionary) => `- ${JSON.stringify(dictionary)}`)\n          .join('\\n\\n')\n      );\n\n    console.log('prompt', prompt);\n\n    // Example of how you might request a completion from ChatGPT:\n    const chatCompletion = await openai.chat.completions.create({\n      model: model ?? 'gpt-4o-mini',\n      messages: [{ role: 'system', content: prompt }],\n    });\n\n    const newContent = chatCompletion.choices[0].message?.content;\n\n    console.log('newContent', newContent);\n\n    logger.info(\n      `${chatCompletion.usage?.total_tokens} tokens used in the request`\n    );\n\n    return {\n      fileContent: newContent ?? '',\n      tokenUsed: chatCompletion.usage?.total_tokens ?? 0,\n    };\n  } catch (error) {\n    console.error(error);\n  }\n};\n"],"mappings":"AAAA,SAAS,oBAAoB;AAC7B,SAAS,SAAS,YAAY;AAC9B,SAAS,qBAAqB;AAC9B,SAAS,cAAc;AACvB,SAAS,cAAc;AAIvB,MAAM,YAAY,QAAQ,cAAc,YAAY,GAAG,CAAC;AAkBxD,MAAM,iBAAiB,CAAC,qBAAqC;AAC3D,QAAM,eAAe,KAAK,WAAW,gBAAgB;AACrD,QAAM,cAAc,aAAa,cAAc,OAAO;AACtD,SAAO;AACT;AAGA,MAAM,kBAAkB,eAAe,aAAa;AAc7C,MAAM,WAAW,OAAO;AAAA,EAC7B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,MAA8D;AAC5D,MAAI;AAIF,UAAM,SAAS,IAAI,OAAO;AAAA,MACxB,QAAQ;AAAA,IACV,CAAC;AAGD,UAAM,SACJ,gBACA,gBAAgB,QAAQ,WAAW,GAAG,KAAK,UAAU,GAAG,CAAC,EAAE,EAAE;AAAA,MAC3D;AAAA,MACA,aACG,IAAI,CAAC,eAAe,KAAK,KAAK,UAAU,UAAU,CAAC,EAAE,EACrD,KAAK,MAAM;AAAA,IAChB;AAEF,YAAQ,IAAI,UAAU,MAAM;AAG5B,UAAM,iBAAiB,MAAM,OAAO,KAAK,YAAY,OAAO;AAAA,MAC1D,OAAO,SAAS;AAAA,MAChB,UAAU,CAAC,EAAE,MAAM,UAAU,SAAS,OAAO,CAAC;AAAA,IAChD,CAAC;AAED,UAAM,aAAa,eAAe,QAAQ,CAAC,EAAE,SAAS;AAEtD,YAAQ,IAAI,cAAc,UAAU;AAEpC,WAAO;AAAA,MACL,GAAG,eAAe,OAAO,YAAY;AAAA,IACvC;AAEA,WAAO;AAAA,MACL,aAAa,cAAc;AAAA,MAC3B,WAAW,eAAe,OAAO,gBAAgB;AAAA,IACnD;AAAA,EACF,SAAS,OAAO;AACd,YAAQ,MAAM,KAAK;AAAA,EACrB;AACF;","names":[]}

package/dist/esm/utils/ensureArrayQueryFilter.mjs

@@ -0,0 +1,15 @@
+const ensureArrayQueryFilter = (filter) => {
+  let idsArray;
+  if (typeof filter === "string") {
+    idsArray = filter.split(",");
+  } else if (Array.isArray(filter)) {
+    idsArray = filter;
+  } else {
+    idsArray = [];
+  }
+  return idsArray;
+};
+export {
+  ensureArrayQueryFilter
+};
+//# sourceMappingURL=ensureArrayQueryFilter.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/utils/ensureArrayQueryFilter.ts"],"sourcesContent":["export const ensureArrayQueryFilter = (\n  filter: string | string[] | undefined\n): string[] | undefined => {\n  let idsArray: string[];\n\n  if (typeof filter === 'string') {\n    idsArray = filter.split(',');\n  } else if (Array.isArray(filter)) {\n    idsArray = filter;\n  } else {\n    idsArray = [];\n  }\n\n  return idsArray;\n};\n"],"mappings":"AAAO,MAAM,yBAAyB,CACpC,WACyB;AACzB,MAAI;AAEJ,MAAI,OAAO,WAAW,UAAU;AAC9B,eAAW,OAAO,MAAM,GAAG;AAAA,EAC7B,WAAW,MAAM,QAAQ,MAAM,GAAG;AAChC,eAAW;AAAA,EACb,OAAO;AACL,eAAW,CAAC;AAAA,EACd;AAEA,SAAO;AACT;","names":[]}

package/dist/esm/utils/ensureMongoDocumentToObject.mjs

@@ -0,0 +1,11 @@
+const ensureMongoDocumentToObject = (potentialDocument) => {
+  let potentialObject = potentialDocument;
+  if (typeof potentialDocument.toObject === "function") {
+    potentialObject = potentialDocument.toObject();
+  }
+  return potentialObject;
+};
+export {
+  ensureMongoDocumentToObject
+};
+//# sourceMappingURL=ensureMongoDocumentToObject.mjs.map

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

@@ -0,0 +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":[]}

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

@@ -1,9 +1,9 @@
 import { logger } from './../../logger/index.mjs';
 import { formatPaginatedResponse, formatResponse } from './../../utils/responseData.mjs';
 import { t } from "express-intlayer";
+import { Locales } from "intlayer";
 import { errorData } from './errorCodes.mjs';
 import { HttpStatusCodes } from './../../export.mjs';
-import { Locales } from "intlayer";
 class ErrorHandler {
   /**
    * Handles generic error responses by formatting and sending a JSON response.

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 { logger } from '@logger';\nimport { formatPaginatedResponse, formatResponse } from '@utils/responseData';\nimport type { Response } from 'express';\n// @ts-ignore express-intlayer not build yet\nimport { t, LanguageContent } from 'express-intlayer';\nimport { ErrorCodes, errorData } from './errorCodes';\nimport { AppError } from './ErrorsClass';\nimport { HttpStatusCodes, UserAPI } from '@/export';\nimport { Locales } from 'intlayer';\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,cAAc;AACvB,SAAS,yBAAyB,sBAAsB;AAGxD,SAAS,SAA0B;AACnC,SAAqB,iBAAiB;AAEtC,SAAS,uBAAgC;AACzC,SAAS,eAAe;AAGjB,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 { logger } from '@logger';\nimport { formatPaginatedResponse, formatResponse } from '@utils/responseData';\nimport type { Response } from 'express';\n// @ts-ignore express-intlayer not build yet\nimport { t, LanguageContent } from 'express-intlayer';\nimport { Locales } from 'intlayer';\nimport { ErrorCodes, errorData } from './errorCodes';\nimport { AppError } from './ErrorsClass';\nimport { HttpStatusCodes, UserAPI } from '@/export';\n\n// Define a class named 'ErrorHandler' to encapsulate error handling logic.\nexport class ErrorHandler {\n  /**\n   * Handles generic error responses by formatting and sending a JSON response.\n   * @param res - The response object provided by Express.js.\n   * @param errorKey - A key representing the specific error.\n   * @param statusCode - (Optional) A specific HTTP status code to use for the response.\n   * @param isPaginatedResponse - Flag to determine if the response should be paginated.\n   */\n  static handleGenericErrorResponse(\n    res: Response,\n    errorKey: ErrorCodes,\n    errorDetails?: object,\n    statusCode?: HttpStatusCodes,\n    isPaginatedResponse: boolean = false\n  ) {\n    const error = errorData[errorKey];\n    const status = statusCode ?? error.statusCode; // Use the provided status code or default to the one in errorData.\n\n    // Delegate to a more customizable error response handler.\n    this.handleCustomErrorResponse(\n      res,\n      errorKey,\n      error.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,cAAc;AACvB,SAAS,yBAAyB,sBAAsB;AAGxD,SAAS,SAA0B;AACnC,SAAS,eAAe;AACxB,SAAqB,iBAAiB;AAEtC,SAAS,uBAAgC;AAGlC,MAAM,aAAa;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQxB,OAAO,2BACL,KACA,UACA,cACA,YACA,sBAA+B,OAC/B;AACA,UAAM,QAAQ,UAAU,QAAQ;AAChC,UAAM,SAAS,cAAc,MAAM;AAGnC,SAAK;AAAA,MACH;AAAA,MACA;AAAA,MACA,MAAM;AAAA,MACN,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"]}

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

@@ -1221,6 +1221,110 @@ const errorData = {
       es: "Error al crear la intenci\xF3n de configuraci\xF3n."
     },
     statusCode: HttpStatusCodes.INTERNAL_SERVER_ERROR_500
+  },
+  AUDIT_FAILED: {
+    title: {
+      en: "Audit failed",
+      fr: "Audit \xE9chou\xE9",
+      es: "Audito fallido"
+    },
+    message: {
+      en: "Failed to audit the content declaration files.",
+      fr: "\xC9chec de l'audit des fichiers de d\xE9claration de contenu.",
+      es: "Error al auditar los archivos de declaraci\xF3n de contenido."
+    },
+    statusCode: HttpStatusCodes.INTERNAL_SERVER_ERROR_500
+  },
+  TAG_NOT_FOUND: {
+    title: {
+      en: "Tag Not Found",
+      fr: "Tag non trouv\xE9",
+      es: "Tag no encontrado"
+    },
+    message: {
+      en: "The specified tag could not be found.",
+      fr: "Le tag sp\xE9cifi\xE9 est introuvable.",
+      es: "El tag especificado no se pudo encontrar."
+    },
+    statusCode: HttpStatusCodes.NOT_FOUND_404
+  },
+  TAG_ID_NOT_FOUND: {
+    title: {
+      en: "Tag ID Not Found",
+      fr: "Identifiant de tag non trouv\xE9",
+      es: "Identificador de tag no encontrado"
+    },
+    message: {
+      en: "The tag ID was not found.",
+      fr: "L'identifiant de tag n'a pas \xE9t\xE9 trouv\xE9.",
+      es: "El identificador de tag no se ha encontrado."
+    },
+    statusCode: HttpStatusCodes.NOT_FOUND_404
+  },
+  TAG_ID_MISMATCH: {
+    title: {
+      en: "Tag ID Mismatch",
+      fr: "Identifiant de tag non correspondant",
+      es: "Identificador de tag no coincidente"
+    },
+    message: {
+      en: "The provided tag ID does not match the expected value. Please verify and try again.",
+      fr: "L'identifiant de tag fourni ne correspond pas \xE0 la valeur attendue. Veuillez v\xE9rifier et r\xE9essayer.",
+      es: "El identificador de tag proporcionado no coincide con el valor esperado. Verifique e intente nuevamente."
+    },
+    statusCode: HttpStatusCodes.BAD_REQUEST_400
+  },
+  TAG_COUNT_FAILED: {
+    title: {
+      en: "Tag Count Failed",
+      fr: "\xC9chec du comptage du tag",
+      es: "Error al contar el tag"
+    },
+    message: {
+      en: "Failed to count tags.",
+      fr: "Le comptage des tags a \xE9chou\xE9.",
+      es: "No se pudo contar los tags."
+    },
+    statusCode: HttpStatusCodes.INTERNAL_SERVER_ERROR_500
+  },
+  TAG_INVALID_FIELDS: {
+    title: {
+      en: "Tag Invalid Fields",
+      fr: "Champs du tag invalides",
+      es: "Campos del tag no v\xE1lidos"
+    },
+    message: {
+      en: "The provided tag fields are invalid.",
+      fr: "Les champs fournis pour le tag sont invalides.",
+      es: "Los campos proporcionados para el tag no son v\xE1lidos."
+    },
+    statusCode: HttpStatusCodes.BAD_REQUEST_400
+  },
+  TAG_UPDATE_FAILED: {
+    title: {
+      en: "Tag Update Failed",
+      fr: "\xC9chec de la mise \xE0 jour du tag",
+      es: "Error al actualizar el tag"
+    },
+    message: {
+      en: "Failed to update the specified tag.",
+      fr: "La mise \xE0 jour du tag a \xE9chou\xE9.",
+      es: "No se pudo actualizar el tag especificado."
+    },
+    statusCode: HttpStatusCodes.INTERNAL_SERVER_ERROR_500
+  },
+  TAG_NOT_IN_ORGANIZATION: {
+    title: {
+      en: "Tag Not In Organization",
+      fr: "Tag non dans l'organisation",
+      es: "Etiqueta no en la organizaci\xF3n"
+    },
+    message: {
+      en: "The specified tag is not in the organization.",
+      fr: "Le tag sp\xE9cifi\xE9 n'est pas dans l'organisation.",
+      es: "La etiqueta especificada no est\xE1 en la organizaci\xF3n."
+    },
+    statusCode: HttpStatusCodes.FORBIDDEN_403
   }
 };
 export {