@intlayer/docs 5.5.11 → 5.5.12

package/legal/pt/terms_of_service.md

@@ -0,0 +1,55 @@
+---
+createdAt: 2025-04-18
+updatedAt: 2025-06-29
+title: Termos de Serviço do Intlayer
+description: Descubra como o Intlayer lida com as informações coletadas através do nosso site e CMS. Siga a documentação para entender os diferentes formatos e casos de uso.
+keywords:
+  - Internacionalização
+  - Documentação
+  - Intlayer
+  - Termos de Serviço
+  - Serviço
+  - Uso
+  - Licença
+  - Responsabilidade
+  - Privacidade
+  - Contribuições
+  - Atribuição
+  - Modificação dos Termos
+slugs:
+  - terms-of-service
+---
+
+# Termos de Uso do Intlayer
+
+## 1. Aceitação dos Termos
+
+Ao usar o Intlayer, você concorda em estar vinculado a estes termos de uso. Se você não aceitar estes termos, por favor, não utilize a ferramenta.
+
+## 2. Licença
+
+O Intlayer é distribuído sob a **licença Apache 2.0**, que permite o uso, modificação e distribuição do código tanto para projetos de código aberto quanto comerciais. Os usuários têm permissão para modificar o código-fonte e enviar contribuições via pull requests de acordo com as diretrizes estabelecidas em nosso [guia de contribuição](https://github.com/aymericzip/intlayer/blob/main/CONTRIBUTING.md). O roubo de código para uso comercial é estritamente proibido.
+
+## 3. Uso Comercial
+
+Você tem permissão para usar o Intlayer em projetos comerciais. No entanto, reutilizar o código para criar ferramentas concorrentes diretas baseadas no Intlayer sem uma transformação significativa ou uma adição substancial de valor é proibido.
+
+## 4. Responsabilidade
+
+Os mantenedores do Intlayer se esforçam para corrigir bugs e problemas de segurança assim que são descobertos. No entanto, eles isentam-se de qualquer responsabilidade por danos resultantes desses problemas nas infraestruturas dos usuários. Incentivamos os usuários a reportar problemas através do nosso [sistema de acompanhamento de issues](https://github.com/aymericzip/intlayer/issues).
+
+## 5. Privacidade
+
+O Intlayer não coleta nem armazena quaisquer dados pessoais dos usuários.
+
+## 6. Contribuições
+
+Os usuários são incentivados a contribuir para o Intlayer seguindo as diretrizes fornecidas em nosso guia de contribuição. Qualquer código submetido deve aderir aos padrões de qualidade estabelecidos e será revisado pelos mantenedores antes da integração.
+
+## 7. Atribuição
+
+Qualquer ferramenta desenvolvida para estender ou utilizar o código do Intlayer deve creditar claramente o Intlayer como base do código. Essa atribuição deve ser visível no código-fonte, bem como em qualquer documentação para usuários ou promocional.
+
+## 8. Modificação dos Termos
+
+Estes termos de uso podem ser modificados a qualquer momento. Os usuários serão informados sobre quaisquer mudanças significativas nos termos de uso e devem aceitar as alterações para continuar utilizando o Intlayer.

package/legal/ru/privacy_notice.md

@@ -0,0 +1,83 @@
+---
+createdAt: 2025-04-18
+updatedAt: 2025-06-29
+title: Уведомление о конфиденциальности Intlayer
+description: Узнайте, как Intlayer обрабатывает информацию, собранную через наш веб-сайт и CMS. Следуйте документации, чтобы понять различные форматы и варианты использования.
+keywords:
+  - Интернационализация
+  - Документация
+  - Intlayer
+  - Конфиденциальность
+  - Уведомление
+  - Файлы cookie
+  - Отслеживание
+  - Аналитика
+  - Google Analytics
+  - Meta (Facebook) Pixel
+  - Аутентификация
+  - Данные пользователя
+slugs:
+  - privacy-notice
+---
+
+# Уведомление о конфиденциальности Intlayer
+
+## Введение
+
+В Intlayer мы серьезно относимся к конфиденциальности. В этом уведомлении объясняется, как мы обрабатываем информацию, собранную через наш веб-сайт и CMS.
+
+## Контакт
+
+Если у вас есть вопросы или опасения по поводу конфиденциальности, пожалуйста, свяжитесь с нами по следующему адресу: [contact@intlayer.org](mailto:contact@intlayer.org).
+
+## Использование файлов cookie и технологий отслеживания
+
+Мы используем **Google Analytics** и **Meta (Facebook) Pixel** для анализа использования нашего веб-сайта и улучшения наших услуг. Эти инструменты генерируют статистику и другую информацию о сайте с помощью файлов cookie, хранящихся на устройствах пользователей.
+
+Для получения дополнительной информации:
+
+- [Политика конфиденциальности Google](https://policies.google.com/privacy)
+- [Политика конфиденциальности Meta](https://www.facebook.com/privacy/policy)
+
+## Аутентификация и данные пользователя
+
+Доступ к CMS Intlayer требует аутентификации пользователя. Мы предлагаем аутентификацию по электронной почте и паролю, а также вход через сторонние сервисы **Google** и **GitHub**.
+
+В процессе аутентификации мы собираем:
+
+- Адрес электронной почты
+- Отображаемое имя (или выбранное имя)
+
+Пользователи также могут получить доступ к CMS через токены доступа, связанные с их аккаунтом. Эти токены привязаны к тем же данным аутентификации.
+
+## Хранение данных и безопасность
+
+Данные аутентификации пользователей хранятся в базе данных **MongoDB**, размещённой на **cloud.mongodb.com**:
+
+- **Регион:** AWS / Орегон (us-west-2)
+- **Тип:** Replica Set (3 узла)
+- **Безопасность паролей:** Все пароли хранятся в виде хешей с использованием стандартных отраслевых методов.
+
+Мы не храним никаких лишних персональных данных, кроме тех, которые необходимы для аутентификации и безопасного доступа к CMS.
+
+## Передача данных третьим лицам
+
+Мы **не** продаём и не передаём ваши персональные данные третьим лицам, за исключением случаев, когда это необходимо для аналитики (Google Analytics, Facebook Pixel) или в рамках процесса аутентификации (вход через Google или GitHub).
+
+## Права пользователей
+
+Как пользователь, вы имеете право:
+
+- Получать доступ к персональным данным, которые мы храним о вас
+- Запрашивать исправление или удаление ваших данных
+- Отзывать доступ или удалять ваш аккаунт
+
+По любым вопросам, связанным с вашими данными, обращайтесь к нам по адресу [contact@intlayer.org](mailto:contact@intlayer.org).
+
+## Изменения в настоящем уведомлении
+
+Мы можем время от времени обновлять это уведомление о конфиденциальности. Рекомендуется регулярно проверять эту страницу, чтобы быть в курсе любых изменений.
+
+---
+
+Сообщите, если вы хотите более формальный стиль, добавить упоминания о GDPR/CCPA или адаптировать текст для юридической страницы вашего сайта.

package/legal/ru/terms_of_service.md

@@ -0,0 +1,55 @@
+---
+createdAt: 2025-04-18
+updatedAt: 2025-06-29
+title: Условия использования Intlayer
+description: Узнайте, как Intlayer обрабатывает информацию, собранную через наш веб-сайт и CMS. Следуйте документации, чтобы понять различные форматы и варианты использования.
+keywords:
+  - Интернационализация
+  - Документация
+  - Intlayer
+  - Условия использования
+  - Сервис
+  - Использование
+  - Лицензия
+  - Ответственность
+  - Конфиденциальность
+  - Вклад
+  - Атрибуция
+  - Изменение условий
+slugs:
+  - terms-of-service
+---
+
+# Условия использования Intlayer
+
+## 1. Принятие условий
+
+Используя Intlayer, вы соглашаетесь соблюдать эти условия использования. Если вы не принимаете эти условия, пожалуйста, не используйте этот инструмент.
+
+## 2. Лицензия
+
+Intlayer распространяется под **лицензией Apache 2.0**, которая разрешает использование, модификацию и распространение кода как для проектов с открытым исходным кодом, так и для коммерческих проектов. Пользователям разрешается изменять исходный код и отправлять вклад через pull-запросы в соответствии с руководством, изложенным в нашем [руководстве по внесению вклада](https://github.com/aymericzip/intlayer/blob/main/CONTRIBUTING.md). Кража кода для коммерческого использования строго запрещена.
+
+## 3. Коммерческое использование
+
+Вам разрешено использовать Intlayer для коммерческих проектов. Однако повторное использование кода для создания прямых конкурирующих инструментов на основе Intlayer без значительной трансформации или существенного добавления ценности запрещено.
+
+## 4. Ответственность
+
+Поддерживающие Intlayer стремятся исправлять ошибки и проблемы безопасности сразу после их обнаружения. Тем не менее, они не несут ответственности за ущерб, вызванный такими проблемами в инфраструктуре пользователей. Мы призываем пользователей сообщать о проблемах через нашу [систему отслеживания проблем](https://github.com/aymericzip/intlayer/issues).
+
+## 5. Конфиденциальность
+
+Intlayer не собирает и не хранит никаких персональных данных пользователей.
+
+## 6. Вклад
+
+Пользователям рекомендуется вносить вклад в развитие Intlayer, следуя рекомендациям, изложенным в нашем руководстве по внесению изменений. Любой предоставленный код должен соответствовать установленным стандартам качества и будет проверен поддерживающими перед интеграцией.
+
+## 7. Атрибуция
+
+Любой инструмент, разработанный для расширения или использования кода Intlayer, должен явно указывать Intlayer как основу кода. Эта атрибуция должна быть видна в исходном коде, а также в любой пользовательской или рекламной документации.
+
+## 8. Изменение условий
+
+Данные условия использования могут быть изменены в любое время. Пользователи будут информированы о любых существенных изменениях условий использования и должны принять эти изменения для продолжения использования Intlayer.

package/legal/zh/privacy_notice.md

@@ -0,0 +1,83 @@
+---
+createdAt: 2025-04-18
+updatedAt: 2025-06-29
+title: Intlayer 隐私声明
+description: 了解 Intlayer 如何处理通过我们的网站和 CMS 收集的信息。请参阅文档以了解不同的格式和使用场景。
+keywords:
+  - 国际化
+  - 文档
+  - Intlayer
+  - 隐私
+  - 声明
+  - Cookie
+  - 跟踪
+  - 分析
+  - Google Analytics
+  - Meta（Facebook）Pixel
+  - 认证
+  - 用户数据
+slugs:
+  - privacy-notice
+---
+
+# Intlayer 隐私声明
+
+## 介绍
+
+在 Intlayer，我们非常重视隐私。本声明解释了我们如何处理通过我们的网站和 CMS 收集的信息。
+
+## 联系方式
+
+如果您对隐私有任何疑问或担忧，请通过以下地址联系我们：[contact@intlayer.org](mailto:contact@intlayer.org)。
+
+## Cookie 和跟踪技术的使用
+
+我们使用 **Google Analytics** 和 **Meta（Facebook）Pixel** 来分析我们网站的使用情况并改进我们的服务。这些工具通过存储在用户设备上的 Cookie 生成网站的统计数据和其他信息。
+
+更多信息请参阅：
+
+- [Google 隐私政策](https://policies.google.com/privacy)
+- [Meta 隐私政策](https://www.facebook.com/privacy/policy)
+
+## 认证和用户数据
+
+访问 Intlayer CMS 需要用户认证。我们提供电子邮件/密码认证以及通过 **Google** 和 **GitHub** 的第三方登录。
+
+在认证过程中，我们会收集：
+
+- 电子邮件地址
+- 显示名称（或选择的名称）
+
+用户也可以通过与其账户关联的访问令牌访问 CMS。这些令牌与相同的认证数据相关联。
+
+## 数据存储与安全
+
+用户认证数据存储在托管于 **cloud.mongodb.com** 的 **MongoDB 数据库** 中：
+
+- **区域：** AWS / 俄勒冈（us-west-2）
+- **类型：** 副本集（3 个节点）
+- **密码安全：** 所有密码均采用行业标准的哈希方法进行加密。
+
+我们不会存储除认证和安全访问 CMS 所需之外的任何不必要的个人数据。
+
+## 与第三方共享数据
+
+我们**不会**出售或与第三方共享您的个人数据，除非是出于分析目的（如 Google Analytics、Facebook Pixel）或作为身份验证过程的一部分（如 Google 或 GitHub 登录）。
+
+## 用户权利
+
+作为用户，您有权：
+
+- 访问我们持有的关于您的个人数据
+- 请求更正或删除您的数据
+- 撤销访问权限或删除您的账户
+
+如有任何关于您数据的请求，请通过 [contact@intlayer.org](mailto:contact@intlayer.org) 与我们联系。
+
+## 本通知的变更
+
+我们可能会不时更新本隐私声明。建议用户定期查看此页面，以了解任何变更。
+
+---
+
+如果您希望使用更正式的语气，添加 GDPR/CCPA 相关内容，或将其调整为您网站上的法律页面，请告知我们。

package/legal/zh/terms_of_service.md

@@ -0,0 +1,55 @@
+---
+createdAt: 2025-04-18
+updatedAt: 2025-06-29
+title: Intlayer 服务条款
+description: 了解 Intlayer 如何处理通过我们的网站和 CMS 收集的信息。请参阅文档以了解不同的格式和使用案例。
+keywords:
+  - 国际化
+  - 文档
+  - Intlayer
+  - 服务条款
+  - 服务
+  - 使用
+  - 许可
+  - 责任
+  - 隐私
+  - 贡献
+  - 归属
+  - 条款修改
+slugs:
+  - terms-of-service
+---
+
+# Intlayer 使用条款
+
+## 1. 条款接受
+
+通过使用 Intlayer，您同意受这些使用条款的约束。如果您不接受这些条款，请不要使用该工具。
+
+## 2. 许可
+
+Intlayer 采用 **Apache 2.0 许可证** 进行分发，该许可证允许在开源和商业项目中使用、修改和分发代码。用户被允许根据我们[贡献指南](https://github.com/aymericzip/intlayer/blob/main/CONTRIBUTING.md)中制定的规则修改源代码并通过拉取请求提交贡献。严禁为商业用途盗用代码。
+
+## 3. 商业使用
+
+您被允许将 Intlayer 用于商业项目。然而，禁止在未进行重大改造或实质性增值的情况下，直接复用代码以创建基于 Intlayer 的竞争工具。
+
+## 4. 责任
+
+Intlayer 的维护者致力于在发现漏洞和安全问题后尽快修复。但对于因这些问题对用户基础设施造成的任何损害，维护者不承担任何责任。我们鼓励用户通过我们的[问题跟踪系统](https://github.com/aymericzip/intlayer/issues)报告问题。
+
+## 5. 隐私
+
+Intlayer 不会收集或存储任何用户的个人数据。
+
+## 6. 贡献
+
+鼓励用户按照我们的贡献指南中的指引为 Intlayer 做出贡献。任何提交的代码必须符合既定的质量标准，并将在集成前由维护者进行审核。
+
+## 7. 归属
+
+任何为扩展或利用 Intlayer 代码而开发的工具，必须明确标注 Intlayer 作为代码的基础。此归属必须在源代码中以及任何用户或宣传文档中可见。
+
+## 8. 条款修改
+
+本使用条款可随时修改。用户将被告知使用条款的任何重大变更，并且必须接受这些变更才能继续使用 Intlayer。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intlayer/docs",
-  "version": "5.5.11",
+  "version": "5.5.12",
   "private": false,
   "description": "Intlayer documentation",
   "keywords": [
@@ -45,7 +45,8 @@
     "src",
     "dist",
     "frequent_questions",
-    "blog"
+    "blog",
+    "legal"
   ],
   "dependencies": {
     "@intlayer/config": "5.5.11",
@@ -65,14 +66,14 @@
     "typescript": "^5.8.3",
     "vitest": "^3.2.2",
     "@intlayer/api": "5.5.11",
-    "@utils/ts-config": "1.0.4",
+    "@intlayer/cli": "5.5.11",
     "@utils/ts-config-types": "1.0.4",
     "@utils/tsup-config": "1.0.4",
-    "@intlayer/cli": "5.5.11"
+    "@utils/ts-config": "1.0.4"
   },
   "peerDependencies": {
-    "@intlayer/api": "5.5.11",
     "@intlayer/cli": "5.5.11",
+    "@intlayer/api": "5.5.11",
     "@intlayer/config": "5.5.11"
   },
   "engines": {
@@ -82,12 +83,12 @@
     "url": "https://github.com/aymericzip/intlayer/issues"
   },
   "scripts": {
+    "prebuild": "tsx tools/generateEntry.ts",
     "build": "pnpm build:package & pnpm build:types",
     "build:package": "tsup",
     "build:types": "tsc --project ./tsconfig.types.json && tsc-alias --project ./tsconfig.types.json",
     "clean": "rimraf ./dist",
     "dev": "concurrently --prefix none \"tsup --watch\" \"tsc --project ./tsconfig.types.json --watch\" \"tsc-alias --project ./tsconfig.types.json --watch\"",
-    "generateEntry": "tsx tools/generateEntry.ts",
     "lint": "eslint . --cache",
     "lint:fix": "eslint . --cache --fix",
     "prettier": "prettier . --check",

package/src/blog.ts

@@ -39,11 +39,13 @@ export const getBlogMetadata = async <
 
 export const getBlogMetadataBySlug = async <L extends LocalesValues>(
   slugs: string | string[],
-  locale: L = defaultLocale as L
+  locale: L = defaultLocale as L,
+  strict = false
 ): Promise<FileMetadata[]> =>
-  await getFileMetadataBySlug(blogEntry, slugs, locale);
+  await getFileMetadataBySlug(blogEntry, slugs, locale, strict);
 
 export const getBlogBySlug = async <L extends LocalesValues>(
   slugs: string | string[],
-  locale: L = defaultLocale as L
-): Promise<string[]> => await getFileBySlug(blogEntry, slugs, locale);
+  locale: L = defaultLocale as L,
+  strict = false
+): Promise<string[]> => await getFileBySlug(blogEntry, slugs, locale, strict);

package/src/common.ts

@@ -66,6 +66,7 @@ export type FileMetadata = {
   keywords: string[];
   updatedAt: string;
   createdAt: string;
+  author?: string;
 };
 
 export const formatMetadata = (
@@ -76,10 +77,12 @@ export const formatMetadata = (
   const metadata = getMarkdownMetadata(file);
   const relativeUrl = join('/', ...(metadata.slugs ?? []));
 
+  const slicedDocKey = docKey.slice(1);
+
   return {
     ...metadata,
     docKey,
-    githubUrl: join(GITHUB_URL_PREFIX, docKey as string).replace(
+    githubUrl: `${GITHUB_URL_PREFIX}${slicedDocKey}`.replace(
       '/en/',
       `/${locale}/`
     ),
@@ -127,7 +130,8 @@ export const getFileMetadataBySlug = async <
 >(
   files: F,
   slugs: string | string[],
-  locale: LocalesValues = defaultLocale as LocalesValues
+  locale: LocalesValues = defaultLocale as LocalesValues,
+  strict = false
 ) => {
   const slugsArray = Array.isArray(slugs) ? slugs : [slugs];
   const filesMetadata = await getFileMetadataRecord(
@@ -135,11 +139,17 @@ export const getFileMetadataBySlug = async <
     defaultLocale as LocalesValues
   );
 
-  const fileMetadataArray: FileMetadata[] = Object.values(filesMetadata).filter(
+  let fileMetadataArray: FileMetadata[] = Object.values(filesMetadata).filter(
     (fileMetadata) =>
       slugsArray.every((slug) => fileMetadata.slugs?.includes(slug))
   );
 
+  if (strict) {
+    fileMetadataArray = fileMetadataArray.filter(
+      (fileMetadata) => fileMetadata.slugs.length === slugsArray.length
+    );
+  }
+
   if (locale !== defaultLocale) {
     const localizedFileMetadata = await Promise.all(
       fileMetadataArray.map(
@@ -159,7 +169,8 @@ export const getFileBySlug = async <
 >(
   files: F,
   slugs: string | string[],
-  locale: LocalesValues = defaultLocale as LocalesValues
+  locale: LocalesValues = defaultLocale as LocalesValues,
+  strict = false
 ) => {
   const slugsArray = Array.isArray(slugs) ? slugs : [slugs];
   const filesMetadata = await getFileMetadataRecord(
@@ -167,11 +178,16 @@ export const getFileBySlug = async <
     defaultLocale as LocalesValues
   );
 
-  const fileMetadataArray = Object.values(filesMetadata).filter(
-    (fileMetadata) =>
-      fileMetadata.slugs.every((slug) => slugsArray.includes(slug))
+  let fileMetadataArray = Object.values(filesMetadata).filter((fileMetadata) =>
+    slugsArray.every((slug) => fileMetadata.slugs?.includes(slug))
   );
 
+  if (strict) {
+    fileMetadataArray = fileMetadataArray.filter(
+      (fileMetadata) => fileMetadata.slugs.length === slugsArray.length
+    );
+  }
+
   const fileList = await Promise.all(
     fileMetadataArray.map(async (fileMetadata) => {
       const file = await getFile(files, fileMetadata.docKey, locale);

package/src/doc.ts

@@ -36,11 +36,13 @@ export const getDocMetadata = async <D extends DocKey, L extends LocalesValues>(
 
 export const getDocMetadataBySlug = async <L extends LocalesValues>(
   slugs: string | string[],
-  locale: L = defaultLocale as L
+  locale: L = defaultLocale as L,
+  strict = false
 ): Promise<FileMetadata[]> =>
-  await getFileMetadataBySlug(docsEntry, slugs, locale);
+  await getFileMetadataBySlug(docsEntry, slugs, locale, strict);
 
 export const getDocBySlug = async <L extends LocalesValues>(
   slugs: string | string[],
-  locale: L = defaultLocale as L
-): Promise<string[]> => await getFileBySlug(docsEntry, slugs, locale);
+  locale: L = defaultLocale as L,
+  strict = false
+): Promise<string[]> => await getFileBySlug(docsEntry, slugs, locale, strict);

package/src/frequentQuestions.ts

@@ -44,12 +44,14 @@ export const getFrequentQuestionMetadata = async <
 
 export const getFrequentQuestionMetadataBySlug = async <L extends Locales>(
   slugs: string | string[],
-  locale: L = defaultLocale as L
+  locale: L = defaultLocale as L,
+  strict = false
 ): Promise<FileMetadata[]> =>
-  await getFileMetadataBySlug(frequentQuestionsEntry, slugs, locale);
+  await getFileMetadataBySlug(frequentQuestionsEntry, slugs, locale, strict);
 
 export const getFrequentQuestionBySlug = async <L extends Locales>(
   slugs: string | string[],
-  locale: L = defaultLocale as L
+  locale: L = defaultLocale as L,
+  strict = false
 ): Promise<string[]> =>
-  await getFileBySlug(frequentQuestionsEntry, slugs, locale);
+  await getFileBySlug(frequentQuestionsEntry, slugs, locale, strict);