@intlayer/backend 3.5.5 → 3.5.6

package/dist/cjs/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/cjs/utils/auditTag/index.cjs

@@ -0,0 +1,74 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var auditTag_exports = {};
+__export(auditTag_exports, {
+  auditTag: () => auditTag
+});
+module.exports = __toCommonJS(auditTag_exports);
+var import_fs = require("fs");
+var import_path = require("path");
+var import_url = require("url");
+var import_logger = require('./../../logger/index.cjs');
+var import_openai = require("openai");
+const import_meta = {};
+const __dirname = (0, import_path.dirname)((0, import_url.fileURLToPath)(import_meta.url));
+const getFileContent = (relativeFilePath) => {
+  const absolutePath = (0, import_path.join)(__dirname, relativeFilePath);
+  const fileContent = (0, import_fs.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 import_openai.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);
+    import_logger.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);
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  auditTag
+});
+//# sourceMappingURL=index.cjs.map

package/dist/cjs/utils/auditTag/index.cjs.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;AAAA;AAAA;AAAA;AAAA;AAAA,gBAA6B;AAC7B,kBAA8B;AAC9B,iBAA8B;AAC9B,oBAAuB;AACvB,oBAAuB;AAJvB;AAQA,MAAM,gBAAY,yBAAQ,0BAAc,YAAY,GAAG,CAAC;AAkBxD,MAAM,iBAAiB,CAAC,qBAAqC;AAC3D,QAAM,mBAAe,kBAAK,WAAW,gBAAgB;AACrD,QAAM,kBAAc,wBAAa,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,qBAAO;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,yBAAO;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/cjs/utils/ensureArrayQueryFilter.cjs

@@ -0,0 +1,39 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var ensureArrayQueryFilter_exports = {};
+__export(ensureArrayQueryFilter_exports, {
+  ensureArrayQueryFilter: () => ensureArrayQueryFilter
+});
+module.exports = __toCommonJS(ensureArrayQueryFilter_exports);
+const ensureArrayQueryFilter = (filter) => {
+  let idsArray;
+  if (typeof filter === "string") {
+    idsArray = filter.split(",");
+  } else if (Array.isArray(filter)) {
+    idsArray = filter;
+  } else {
+    idsArray = [];
+  }
+  return idsArray;
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ensureArrayQueryFilter
+});
+//# sourceMappingURL=ensureArrayQueryFilter.cjs.map

package/dist/cjs/utils/ensureArrayQueryFilter.cjs.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":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;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/cjs/utils/ensureMongoDocumentToObject.cjs

@@ -0,0 +1,35 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var ensureMongoDocumentToObject_exports = {};
+__export(ensureMongoDocumentToObject_exports, {
+  ensureMongoDocumentToObject: () => ensureMongoDocumentToObject
+});
+module.exports = __toCommonJS(ensureMongoDocumentToObject_exports);
+const ensureMongoDocumentToObject = (potentialDocument) => {
+  let potentialObject = potentialDocument;
+  if (typeof potentialDocument.toObject === "function") {
+    potentialObject = potentialDocument.toObject();
+  }
+  return potentialObject;
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ensureMongoDocumentToObject
+});
+//# sourceMappingURL=ensureMongoDocumentToObject.cjs.map

package/dist/cjs/utils/ensureMongoDocumentToObject.cjs.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":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;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/cjs/utils/errors/errorCodes.cjs

@@ -1257,6 +1257,97 @@ const errorData = {
       es: "Error al auditar los archivos de declaraci\xF3n de contenido."
     },
     statusCode: import_httpStatusCodes.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: import_httpStatusCodes.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: import_httpStatusCodes.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: import_httpStatusCodes.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: import_httpStatusCodes.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: import_httpStatusCodes.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: import_httpStatusCodes.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: import_httpStatusCodes.HttpStatusCodes.FORBIDDEN_403
   }
 };
 // Annotate the CommonJS export names for ESM import in node: