@intlayer/docs 9.0.0-canary.9 → 9.0.0

package/docs/hi/releases/v9.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-06-14
-updatedAt: 2026-06-26
+updatedAt: 2026-07-08
 title: नया Intlayer v9 - क्या नया है?
 description: जानें कि Intlayer v9 में क्या नया है। लोकप्रिय i18n लाइब्रेरीज़ के लिए ड्रॉप-इन कम्पैटिबिलिटी पैकेजेस और Collections और Variants के लिए सपोर्ट का परिचय।
 keywords:
@@ -9,9 +9,13 @@ keywords:
   - Migration
   - Collections
   - Variants
+  - Self-Hosting
+  - Docker
+  - CMS SDK
   - i18next
   - next-intl
   - vue-i18n
+youtubeVideo: https://www.youtube.com/watch?v=ia6JmVf-kkU
 slugs:
   - doc
   - releases
@@ -23,6 +27,14 @@ author: aymericzip
 
 Intlayer v9 में आपका स्वागत है! यह मेजर रिलीज़ प्रमुख i18n लाइब्रेरीज़ (`react-i18next`, `next-intl`, `vue-i18n`, आदि) के लिए **Compat Adapter Packages** के साथ Intlayer पर माइग्रेशन की राह को आसान बनाने में एक बड़ा मील का पत्थर है, और यह रिच कंटेंट स्ट्रक्चर्स: **Collections** और **Variants** के लिए सपोर्ट जोड़ता है।
 
+<iframe
+  src="https://www.youtube.com/embed/ia6JmVf-kkU"
+  className="m-auto overflow-hidden rounded-lg border-0 max-md:size-full max-md:h-[700px] md:aspect-16/9 md:w-full"
+  title="Demo Video - New Intlayer v9 - What's new?"
+  sandbox="allow-forms allow-modals allow-popups allow-presentation allow-same-origin allow-scripts"
+  loading="lazy"
+/>
+
 ## विषय-सूची
 
 <TOC levels={[2]} maxDepth={1} />
@@ -109,36 +121,40 @@ Intlayer v9 स्टैटिक की-वैल्यू ऑब्जेक
 
 ऑर्डर किए गए आइटम्स की एक CMS-मैनेज्ड सूची परिभाषित करें (जैसे FAQs, प्रोडक्ट्स, या ब्लॉग लिस्ट्स):
 
-```ts fileName="faq.content.ts"
+```ts fileName="faq.1.content.ts"
 import { t, type Dictionary } from "intlayer";
 
 export default {
   key: "faq",
-  content: [
-    {
-      question: t({
-        hi: "Intlayer क्या है?",
-        en: "What is Intlayer?",
-        fr: "Qu'est-ce qu'Intlayer ?",
-      }),
-      answer: t({
-        hi: "एक i18n टूलकिट।",
-        en: "An i18n toolkit.",
-        fr: "Une boîte à outils i18n.",
-      }),
-    },
-  ],
+  item: 1,
+  content: {
+    question: t({ en: "What is Intlayer?", fr: "Qu'est-ce qu'Intlayer ?" }),
+    answer: t({ en: "An i18n toolkit.", fr: "Une boîte à outils i18n." }),
+  },
+} satisfies Dictionary;
+```
+
+```ts fileName="faq.2.content.ts"
+import { t, type Dictionary } from "intlayer";
+
+export default {
+  key: "faq",
+  item: 2,
+  content: {
+    question: t({ en: "Is it free?", fr: "Est-ce gratuit ?" }),
+    answer: t({ en: "Yes, open-source.", fr: "Oui, open-source." }),
+  },
 } satisfies Dictionary;
 ```
 
 #### उपयोग:
 
 ```ts
-// सभी आइटम्स प्राप्त करें
+// Fetch all items as an array
 const allFaqs = useIntlayer("faq"); // -> { question: string, answer: string }[]
 
-// इंडेक्स द्वारा सिंगल आइटम प्राप्त करें
-const faq = useIntlayer("faq", { item: 1 }); // -> { question: string, answer: string }
+// Fetch a single item by index
+const faq = useIntlayer("faq", { item: 2 }); // -> { question: string, answer: string }
 ```
 
 ### 2. Variants
@@ -192,28 +208,52 @@ export default {
 ```ts
 // केवल अनुरोधित आइटम को डायनेमिक रूप से फ़ेच करता है (Suspense की आवश्यकता है)
 const product = useIntlayer("product-copy", {
-  id: "prod_123",
-  category: "books",
+  variant: { id: "prod_123", category: "books" },
 });
 ```
 
 ---
 
-## Dynamic Loading और Bundle Size Optimizations
-
-बंडल्स को बेहद छोटा रखने के लिए, Intlayer v9 डायनेमिक लेज़ी लोडिंग (dynamic lazy loading) का समर्थन करता है।
-
-अपने कॉन्फ़िगरेशन में, `importMode` को `'dynamic'` या `'fetch'` पर सेट करें:
-
-```ts fileName="intlayer.config.ts"
-export default {
-  dictionary: {
-    importMode: "dynamic", // "static" | "dynamic" | "fetch"
-  },
+## `@intlayer/analytics`: कंटेंट एक्सपोज़र ट्रैकिंग और A/B टेस्टिंग
+
+एक नया वैकल्पिक पैकेज, [`@intlayer/analytics`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/analytics.md), आपको बताता है कि आपके विज़िटर्स को वास्तव में कौन-सी सामग्री दिखाई जा रही है — और **Collections & Variants** के साथ यह चक्र पूरा करता है, जिससे आप कंटेंट पर A/B टेस्ट कर सकते हैं और प्रत्येक वेरिएंट के लिए कन्वर्ज़न माप सकते हैं।
+
+- **प्रोवाइडर-स्तर ट्रैकिंग**: `IntlayerProvider` (React / Next.js / React Native) लोड, रूट परिवर्तन और लोकेल परिवर्तन पर स्वचालित रूप से `page_view` इवेंट रिकॉर्ड करता है।
+- **नोड-स्तर ट्रैकिंग**: हर `useIntlayer` रिज़ॉल्यूशन एक `content_exposure` इवेंट रिपोर्ट करता है — कौन-सी डिक्शनरी की, की-पाथ, लोकेल, और (यदि लागू हो) कौन-सा A/B **वेरिएंट** दिखाया गया। फ्लश विंडो के भीतर एक ही नोड के बार-बार एक्सपोज़र को एक इवेंट में मिला दिया जाता है।
+- **डिटरमिनिस्टिक A/B असाइनमेंट**: `getVariant(experimentKey, variants)` बिना **सर्वर राउंड-ट्रिप** के हर सेशन को एक वेरिएंट असाइन करता है, इसलिए पहले रेंडर से पहले कोई फ़्लिकर नहीं होता।
+- **`useConversion()`**: सेशन जिस वेरिएंट के संपर्क में आया, उसे एक लक्ष्य (साइनअप, क्लिक, खरीद…) से जोड़ता है।
+- **इंस्टॉल न होने पर शून्य लागत**: `@intlayer/editor` जैसा ही tree-shakeable पैटर्न — `try/catch` में लिपटा हुआ डायनामिक `import()`, साथ ही एक बिल्ड-टाइम एनवायरनमेंट वेरिएबल (`INTLAYER_ANALYTICS_ENABLED`) जो इसे उपयोग न करने वाले ऐप्स के लिए पूरे इंटीग्रेशन को डेड-कोड के रूप में हटा देता है।
+- **कोई नया कॉन्फ़िगरेशन स्कीमा नहीं**: मौजूदा `editor.backendURL` (इंजेशन एंडपॉइंट / सेल्फ-होस्टिंग) और `editor.clientId` (प्रोजेक्ट की, जो सक्षम करने का स्विच भी है) का पुनः उपयोग करता है।
+- **गोपनीयता का सम्मान**: सेशन का अनाम हैशिंग (SHA-256, कोई रॉ आईडी संग्रहीत नहीं), कोई IP संग्रहण नहीं, केवल मोटे तौर पर देश-स्तरीय भू-स्थान, लगभग हर 20 सेकंड में बैच में भेजे गए अनुरोध।
+- **डैशबोर्ड**: एक नया **Analytics** पेज (प्रोजेक्ट चुनने के बाद साइडबार में दिखता है) सक्रिय उपयोगकर्ता, आज के उपयोगकर्ता, पिछले 7/30/90 दिनों के उपयोगकर्ता, विज़िटर इवोल्यूशन ग्राफ़, और लोकेल बनाम लोकेशन ब्रेकडाउन दिखाता है।
+
+```tsx fileName="CTAButton.tsx" codeFormat="tsx"
+import { useConversion } from "react-intlayer";
+
+const CTAButton = () => {
+  const trackConversion = useConversion();
+
+  return (
+    <button
+      onClick={() =>
+        trackConversion({
+          experimentKey: "homepage-hero",
+          variant: "black_friday",
+          goal: "cta_click",
+        })
+      }
+    >
+      Get started
+    </button>
+  );
 };
 ```
 
-बिल्ड टाइम पर, `@intlayer/swc` और `@intlayer/babel` आपकी फ़ाइलों को स्कैन करते हैं और `useIntlayer` / `getIntlayer` कॉल्स को ट्री-शेकेबल (tree-shakeable) रैपर्स (`useDictionary` / `useDictionaryDynamic`) से बदल देते हैं। केवल चयनित कलेक्शन आइटम, वेरिएंट, या लोकेल के लिए आवश्यक कंटेंट ही लोड किया जाता है, जिससे आपके प्रोडक्शन बंडल में अप्रयुक्त (unused) ट्रांसलेशंस शामिल होने से बच जाते हैं।
+```bash packageManager="npm"
+npm install @intlayer/analytics
+```
+
+आज React, Next.js, और React Native (`react-intlayer` के माध्यम से) के लिए उपलब्ध है; अन्य फ्रेमवर्क बाइंडिंग्स (Vue, Svelte, Angular, …) की योजना बनाई गई है, जो `@intlayer/editor` के समान रोलआउट पैटर्न का पालन करेंगी। पूर्ण गाइड के लिए [Analytics दस्तावेज़](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/analytics.md) देखें।
 
 ---
 
@@ -296,6 +336,59 @@ npm install intlayer react-native-intlayer
 
 ---
 
+## CMS SDK: Intlayer को हेडलेस कंटेंट डेटाबेस के रूप में उपयोग करें
+
+Intlayer v9 में `@intlayer/api` के भीतर एक साफ़, स्वतः-प्रमाणित SDK शामिल है, जिससे आप CMS के साथ प्रोग्रामेटिक रूप से इंटरैक्ट कर सकते हैं — प्रोजेक्ट्स प्राप्त करें, डिक्शनरीज़ प्राप्त करें, और उन्हें अपने सर्वर, स्क्रिप्ट्स या CI से पुश या अपडेट करें। प्रमाणीकरण (OAuth2 `client_credentials`) आपके लिए संभाला और रिफ्रेश किया जाता है।
+
+SDK को **दो अलग-अलग इम्पोर्ट्स** में विभाजित किया गया है ताकि आपके बंडल में केवल वही डोमेन शामिल हों जिन्हें आप वास्तव में उपयोग करते हैं:
+
+1. `createIntlayerCMS` — एक हल्का **ऑथेंटिकेटर** जो क्रेडेंशियल्स और प्रबंधित टोकन रखता है (कोई डोमेन क्लाइंट बंडल नहीं होता)।
+2. `dictionaryEndpoint`, `projectEndpoint`, … — प्रति-डोमेन **एंडपॉइंट बाइंडर**, प्रत्येक अपने स्वयं के सब-पाथ से इम्पोर्ट किया जाता है।
+
+```ts fileName="cms.ts"
+import { createIntlayerCMS } from "@intlayer/api";
+import { dictionaryEndpoint } from "@intlayer/api/dictionary";
+
+// कॉन्फ़िगरेशन वैकल्पिक है: क्रेडेंशियल्स INTLAYER_CLIENT_ID /
+// INTLAYER_CLIENT_SECRET पर फ़ॉलबैक करते हैं, जिन्हें `@intlayer/config/built` हल करता है।
+const cms = createIntlayerCMS();
+
+// पढ़ें
+const { data: dictionaries } = await dictionaryEndpoint(cms).getDictionaries();
+
+// लिखें — CMS को डेटाबेस की तरह उपयोग करें
+await dictionaryEndpoint(cms).pushDictionaries([myDictionary]);
+```
+
+> सुरक्षा: CMS क्रेडेंशियल्स आपके कंटेंट पर लिखने की अनुमति देते हैं। ऑथेंटिकेटर हमेशा केवल **सर्वर साइड** पर ही बनाएं — `clientId` / `clientSecret` को कभी ब्राउज़र पर न भेजें।
+
+---
+
+## स्व-होस्टिंग (Self-Hosting)
+
+Intlayer v9 एक ही कमांड से अपना स्वयं का Intlayer इंस्टेंस चलाने के लिए प्रथम-श्रेणी समर्थन प्रदान करता है — किसी Intlayer Cloud खाते की आवश्यकता नहीं है।
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | sh
+```
+
+इंस्टॉलर एक `docker-compose.yml` और एक `.env` डाउनलोड करता है, आवश्यक सीक्रेट्स (secrets) को स्वचालित रूप से जनरेट करता है, और `docker compose up -d` चलाता है। सब कुछ — डैशबोर्ड, API, डेटाबेस, ऑब्जेक्ट स्टोरेज, और ट्रांजेक्शनल ईमेल — कंटेनर्स में स्थानीय रूप से चलता है।
+
+### शामिल सेवाएं
+
+| सेवा                                   | उद्देश्य                                                         |
+| -------------------------------------- | ---------------------------------------------------------------- |
+| **app** (TanStack Start)               | पोर्ट `3000` पर डैशबोर्ड UI                                      |
+| **backend** (Fastify/Bun)              | पोर्ट `3100` पर REST API                                         |
+| **MongoDB 7** (सिंगल-नोड रेप्लिका सेट) | प्राथमिक डेटाबेस                                                 |
+| **Redis 7**                            | जॉब क्यूज़ और कैशिंग                                             |
+| **MinIO**                              | S3-संगत ऑब्जेक्ट स्टोरेज (अवतार, स्क्रीनशॉट)                     |
+| **Mailpit**                            | लोकल SMTP सिंक + पोर्ट `8025` पर ट्रांजेक्शनल ईमेल के लिए वेब UI |
+
+Chromium (Puppeteer स्क्रीनशॉट जनरेशन के लिए उपयोग किया जाता है) बैकएंड इमेज के अंदर बंडल किया गया है — किसी अतिरिक्त कंटेनर की आवश्यकता नहीं है।
+
+---
+
 ## v8 से माइग्रेशन नोट्स
 
 यदि आप v8 से अपग्रेड कर रहे हैं, तो ध्यान दें कि v9 में कोई ब्रेकिंग बदलाव (breaking changes) शामिल नहीं हैं। लेकिन यहाँ मुख्य बदलाव दिए गए हैं:
@@ -310,4 +403,7 @@ npm install intlayer react-native-intlayer
 
 - [Compat Adapter Packages Guide](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/compat/index.md)
 - [Dynamic Dictionaries - Collections & Variants](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/dynamic_dictionaries/index.md)
+- [Analytics - कंटेंट एक्सपोज़र ट्रैकिंग और A/B टेस्टिंग](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/analytics.md)
 - [Configuration Reference](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/configuration.md)
+- [CMS SDK - @intlayer/api के साथ प्रोग्रामेटिक एक्सेस](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/intlayer_CMS.md)
+- [स्व-होस्टिंग गाइड](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/self_hosting.md)

package/docs/hi/self_hosting.md

@@ -0,0 +1,350 @@
+---
+createdAt: 2026-06-30
+updatedAt: 2026-06-30
+title: इंटलेयर को सेल्फ-होस्ट करना
+description: एक ही कमांड से अपने स्वयं के इंफ्रास्ट्रक्चर पर एक पूर्ण इंटलेयर इंस्टेंस चलाएँ। इंटलेयर क्लाउड अकाउंट की कोई आवश्यकता नहीं है।
+keywords:
+  - Self-Hosting
+  - Docker
+  - Docker Compose
+  - Intlayer
+  - CMS
+  - Installation
+  - Infrastructure
+slugs:
+  - doc
+  - self-hosting
+author: aymericzip
+---
+
+# इंटलेयर को सेल्फ-होस्ट करना
+
+इंटलेयर पूरी तरह से आपके अपने इंफ्रास्ट्रक्चर पर चल सकता है - इसके लिए इंटलेयर क्लाउड खाते की आवश्यकता नहीं है। एक ही कमांड एक उत्पादन-तैयार स्टैक को बूट करता है:
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | sh
+```
+
+इंस्टॉलर एक `docker-compose.yml` और एक `.env` डाउनलोड करता है, आवश्यक सीक्रेट्स को स्वतः जेनरेट करता है, और `docker compose up -d` के साथ सभी कंटेनरों को शुरू करता है।
+
+## विषय-सूची
+
+<TOC/>
+
+---
+
+## आर्किटेक्चर
+
+```
+                ┌─────────────────────────────┐
+ browser ──────▶ │  app  (TanStack Start)  :3000│ ──┐
+                └─────────────────────────────┘   │ VITE_BACKEND_URL
+                ┌─────────────────────────────┐   │
+                │  backend (Fastify/Bun)  :3100│ ◀─┘
+                └──────────────┬──────────────┘
+          ┌──────────┬─────────┼──────────┬───────────┐
+          ▼          ▼         ▼          ▼           ▼
+     mongo:27017  redis:6379  minio:9000  mailpit:1025  Chromium
+     (1-node RS)             (S3 API)     (SMTP)        (in-image)
+                             minio:9001   mailpit:8025
+                             (console)    (web UI)
+```
+
+क्रोमियम (Puppeteer स्क्रीनशॉट जनरेशन के लिए उपयोग किया जाता है) बैकएंड इमेज के अंदर बंडल किया गया है - किसी अलग कंटेनर की आवश्यकता नहीं है।
+
+---
+
+## पूर्व-आवश्यकताएँ
+
+- **डॉकर** ≥ 24 और **डॉकर कंपोज** ≥ v2। यदि इनमें से कोई भी गायब है, तो इंस्टॉलर इंस्टॉल लिंक प्रिंट करता है और बाहर निकल जाता है।
+- होस्ट पर पोर्ट `3000`, `3100`, `8025`, `9000`, और `9001` उपलब्ध होने चाहिए।
+- एक Linux या macOS होस्ट (या Windows पर WSL2)।
+
+---
+
+## त्वरित शुरुआत
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | sh
+```
+
+इंस्टॉलर क्या करता है:
+
+1.  जांचता है कि `docker` और `docker compose` मौजूद हैं या नहीं।
+2.  `docker-compose.yml` और `.env.example` को `./intlayer/` में डाउनलोड करता है।
+3.  यदि कोई `.env` मौजूद नहीं है, तो उदाहरण कॉपी करता है और `openssl rand` के माध्यम से `BETTER_AUTH_SECRET`, `S3_ACCESS_KEY_ID`, और `S3_SECRET_ACCESS_KEY` के लिए रैंडम सीक्रेट्स जेनरेट करता है।
+4.  `docker compose pull` + `docker compose up -d` चलाता है।
+5.  URL प्रिंट करता है: डैशबोर्ड `:3000`, API `:3100`, ईमेल UI `:8025`, MinIO कंसोल `:9001`।
+
+स्टैक के चालू होने के बाद, **http://localhost:3000** खोलें और अपना पहला अकाउंट बनाएँ।
+
+---
+
+## सेवाएँ
+
+| सर्विस      | इमेज                                 | होस्ट पोर्ट(s)                 | उद्देश्य                                            |
+| ----------- | ------------------------------------ | ------------------------------ | --------------------------------------------------- |
+| **app**     | `apps/app/Dockerfile` से निर्मित     | `3000`                         | TanStack Start डैशबोर्ड (CMS UI)                    |
+| **backend** | `apps/backend/Dockerfile` से निर्मित | `3100`                         | Fastify REST API (`/health` एंडपॉइंट)               |
+| **mongo**   | `mongo:7`                            | आंतरिक                         | सिंगल-नोड रेप्लिका सेट (`rs0`)                      |
+| **redis**   | `redis:7-alpine`                     | आंतरिक                         | जॉब क्यू (BullMQ) और कैशिंग (ioredis)               |
+| **minio**   | `minio/minio`                        | `9000` (S3), `9001` (कंसोल)    | अवतार और स्क्रीनशॉट के लिए S3-संगत ऑब्जेक्ट स्टोरेज |
+| **mailpit** | `axllent/mailpit`                    | `1025` (SMTP), `8025` (वेब UI) | लोकल ट्रांजैक्शनल ईमेल सिंक                         |
+
+आंतरिक पोर्ट (mongo, redis) डिफ़ॉल्ट रूप से होस्ट पर एक्सपोज़ नहीं किए जाते हैं।
+
+> MinIO पोर्ट `9000` ब्राउज़र द्वारा पहुँच योग्य होना चाहिए क्योंकि अपलोड किए गए एसेट (अवतार, स्क्रीनशॉट) सीधे `S3_PUBLIC_URL=http://localhost:9000/intlayer` से लोड होते हैं।
+
+---
+
+## एनवायरनमेंट वेरिएबल
+
+इंस्टॉलर एक तैयार-से-उपयोग `.env` जेनरेट करता है। नीचे दी गई तालिका प्रत्येक वेरिएबल का वर्णन करती है।
+
+### आवश्यक (स्वतः जेनरेटेड या प्रॉम्प्टेड)
+
+| वेरिएबल                | उदाहरण                                          | विवरण                                              |
+| ---------------------- | ----------------------------------------------- | -------------------------------------------------- |
+| `NODE_ENV`             | `production`                                    | रनटाइम एनवायरनमेंट                                 |
+| `PORT`                 | `3100`                                          | बैकएंड लिसनिंग पोर्ट                               |
+| `BACKEND_URL`          | `http://localhost:3100`                         | बैकएंड API का पब्लिक URL                           |
+| `APP_URL`              | `http://localhost:3000`                         | डैशबोर्ड का पब्लिक URL                             |
+| `DOMAIN`               | `localhost`                                     | कुकी डोमेन                                         |
+| `MONGODB_URI`          | `mongodb://mongo:27017/intlayer?replicaSet=rs0` | पूर्ण MongoDB कनेक्शन URI                          |
+| `REDIS_URL`            | `redis://redis:6379`                            | Redis कनेक्शन URL                                  |
+| `BETTER_AUTH_SECRET`   | _(जेनरेटेड)_                                    | सेशन साइनिंग के लिए 32-बाइट सीक्रेट                |
+| `MAIL_PROVIDER`        | `smtp`                                          | मेल ट्रांसपोर्ट: `smtp` या `resend`                |
+| `MAIL_SMTP_HOST`       | `mailpit`                                       | SMTP होस्टनेम (मेलपिट कंटेनर नाम)                  |
+| `MAIL_SMTP_PORT`       | `1025`                                          | SMTP पोर्ट                                         |
+| `MAIL_FROM`            | `Intlayer <no-reply@localhost>`                 | प्रेषक पता                                         |
+| `S3_ENDPOINT`          | `http://minio:9000`                             | S3-संगत एंडपॉइंट                                   |
+| `S3_PUBLIC_URL`        | `http://localhost:9000/intlayer`                | ब्राउज़र एसेट लोडिंग के लिए पब्लिक URL             |
+| `S3_BUCKET_NAME`       | `intlayer`                                      | बकेट नाम                                           |
+| `S3_ACCESS_KEY_ID`     | _(जेनरेटेड)_                                    | MinIO एक्सेस की                                    |
+| `S3_SECRET_ACCESS_KEY` | _(जेनरेटेड)_                                    | MinIO सीक्रेट की                                   |
+| `VITE_BACKEND_URL`     | `http://localhost:3100`                         | बिल्ड टाइम पर डैशबोर्ड में बेक किया गया बैकएंड URL |
+| `VITE_DOMAIN`          | `localhost`                                     | बिल्ड टाइम पर डैशबोर्ड में बेक किया गया डोमेन      |
+
+### वैकल्पिक (अनुपस्थिति में फीचर धीरे-धीरे खराब हो जाते हैं)
+
+| वेरिएबल                                                  | फीचर                                                                          |
+| -------------------------------------------------------- | ----------------------------------------------------------------------------- |
+| `OPENAI_API_KEY`                                         | AI-सहायता प्राप्त अनुवाद और कंटेंट ऑडिट                                       |
+| `STRIPE_SECRET_KEY`, `STRIPE_WEBHOOK_SECRET`, `STRIPE_*` | बिलिंग और सब्सक्रिप्शन प्रबंधन                                                |
+| `RESEND_API_KEY`                                         | रीसेंड के माध्यम से ट्रांजैक्शनल ईमेल (सेट होने पर मेलपिट को ओवरराइड करता है) |
+| `GITHUB_CLIENT_ID`, `GITHUB_CLIENT_SECRET`               | GitHub OAuth लॉगिन                                                            |
+| `GOOGLE_CLIENT_ID`, `GOOGLE_CLIENT_SECRET`               | Google OAuth लॉगिन                                                            |
+| `GITLAB_CLIENT_ID`, `GITLAB_CLIENT_SECRET`               | GitLab OAuth लॉगिन                                                            |
+| `MICROSOFT_CLIENT_ID`, `MICROSOFT_CLIENT_SECRET`         | Microsoft OAuth लॉगिन                                                         |
+| `LINKEDIN_CLIENT_ID`, `LINKEDIN_CLIENT_SECRET`           | LinkedIn OAuth लॉगिन                                                          |
+| `ATLASSIAN_CLIENT_ID`, `ATLASSIAN_CLIENT_SECRET`         | Atlassian OAuth लॉगिन                                                         |
+
+---
+
+## अपने इंटलेयर प्रोजेक्ट को कनेक्ट करना
+
+एक बार जब स्टैक चल रहा हो, तो अपने प्रोजेक्ट को `intlayer.org` के बजाय सेल्फ-होस्टेड बैकएंड और डैशबोर्ड पर पॉइंट करें।
+
+### प्रोजेक्ट कॉन्फ़िगरेशन
+
+```typescript fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
+import type { IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  editor: {
+    clientId: process.env.INTLAYER_CLIENT_ID,
+    clientSecret: process.env.INTLAYER_CLIENT_SECRET,
+
+    /**
+     * सेल्फ-होस्टेड CMS डैशबोर्ड का URL।
+     * डिफ़ॉल्ट: https://app.intlayer.org
+     */
+    cmsURL: process.env.INTLAYER_CMS_URL, // उदाहरण के लिए http://localhost:3000
+
+    /**
+     * सेल्फ-होस्टेड बैकएंड API का URL।
+     * डिफ़ॉल्ट: https://back.intlayer.org
+     */
+    backendURL: process.env.INTLAYER_BACKEND_URL, // उदाहरण के लिए http://localhost:3100
+  },
+};
+
+export default config;
+```
+
+अपने प्रोजेक्ट के `.env` में एनवायरनमेंट वेरिएबल सेट करें:
+
+```sh
+INTLAYER_CMS_URL=http://localhost:3000
+INTLAYER_BACKEND_URL=http://localhost:3100
+INTLAYER_CLIENT_ID=<your-client-id>
+INTLAYER_CLIENT_SECRET=<your-client-secret>
+```
+
+अपने सेल्फ-होस्टेड डैशबोर्ड में `http://localhost:3000/projects` पर **प्रोजेक्ट्स → एक्सेस कीज़** के अंतर्गत एक्सेस क्रेडेंशियल बनाएँ।
+
+### `@intlayer/api` SDK
+
+प्रोग्रामेटिक रूप से `@intlayer/api` SDK का उपयोग करते समय, `backendURL` को स्पष्ट रूप से पास करें:
+
+```typescript fileName="cms.ts" codeFormat="typescript"
+import { createIntlayerCMS } from "@intlayer/api";
+import { dictionaryEndpoint } from "@intlayer/api/dictionary";
+
+const cms = createIntlayerCMS({
+  editor: {
+    clientId: process.env.INTLAYER_CLIENT_ID,
+    clientSecret: process.env.INTLAYER_CLIENT_SECRET,
+    backendURL: process.env.INTLAYER_BACKEND_URL, // http://localhost:3100
+  },
+});
+
+const { data: dictionaries } = await dictionaryEndpoint(cms).getDictionaries();
+```
+
+---
+
+## अपग्रेड करना
+
+मौजूदा डिप्लॉयमेंट पर इंस्टॉलर को फिर से चलाने से रोलिंग अपग्रेड होता है:
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | sh
+```
+
+यह नवीनतम इमेज को खींचता है और `docker compose pull && docker compose up -d` के साथ कंटेनरों को रीस्टार्ट करता है। मौजूदा वॉल्यूम (`mongo-data`, `redis-data`, `minio-data`) संरक्षित रहते हैं - कोई डेटा हानि नहीं होती है।
+
+`./intlayer/` डायरेक्टरी के अंदर से मैन्युअल रूप से अपग्रेड करने के लिए:
+
+```sh
+docker compose pull
+docker compose up -d
+```
+
+---
+
+## बैकअप और रीस्टोर
+
+सभी स्थायी डेटा तीन नामित डॉकर वॉल्यूम में रहते हैं।
+
+### बैकअप
+
+```sh
+docker run --rm \
+  -v intlayer_mongo-data:/data \
+  -v "$(pwd)":/backup \
+  busybox tar czf /backup/mongo-data.tar.gz /data
+
+docker run --rm \
+  -v intlayer_redis-data:/data \
+  -v "$(pwd)":/backup \
+  busybox tar czf /backup/redis-data.tar.gz /data
+
+docker run --rm \
+  -v intlayer_minio-data:/data \
+  -v "$(pwd)":/backup \
+  busybox tar czf /backup/minio-data.tar.gz /data
+```
+
+### रीस्टोर
+
+```sh
+docker run --rm \
+  -v intlayer_mongo-data:/data \
+  -v "$(pwd)":/backup \
+  busybox tar xzf /backup/mongo-data.tar.gz -C /
+
+# redis-data और minio-data के लिए दोहराएँ
+```
+
+---
+
+## रिवर्स प्रॉक्सी (Nginx / Caddy) का उपयोग करना
+
+प्रोडक्शन डिप्लॉयमेंट के लिए, ऐप और बैकएंड कंटेनरों को सीधे एक्सपोज़ करने के बजाय उनके सामने एक रिवर्स प्रॉक्सी रखें।
+
+### Nginx उदाहरण
+
+```nginx
+server {
+    listen 80;
+    server_name cms.example.com;
+
+    location / {
+        proxy_pass http://localhost:3000;
+        proxy_set_header Host $host;
+        proxy_set_header X-Real-IP $remote_addr;
+    }
+}
+
+server {
+    listen 80;
+    server_name api.example.com;
+
+    location / {
+        proxy_pass http://localhost:3100;
+        proxy_set_header Host $host;
+        proxy_set_header X-Real-IP $remote_addr;
+    }
+}
+```
+
+अपने पब्लिक डोमेन से मेल खाने के लिए निम्नलिखित `.env` वेरिएबल को अपडेट करें:
+
+```sh
+BACKEND_URL=https://api.example.com
+APP_URL=https://cms.example.com
+DOMAIN=example.com
+VITE_BACKEND_URL=https://api.example.com
+VITE_DOMAIN=example.com
+```
+
+> `VITE_*` वेरिएबल बिल्ड टाइम पर डैशबोर्ड इमेज में बेक किए जाते हैं। यदि आप इमेज बनने के बाद उन्हें बदलते हैं, तो आपको `app` इमेज (`docker compose build app`) को फिर से बनाना होगा या रनटाइम कॉन्फ़िग इंजेक्शन का उपयोग करना होगा।
+
+---
+
+## समस्या निवारण
+
+### पहली शुरुआत में बैकएंड क्रैश-लूप करता है
+
+बैकएंड शुरू होने से पहले MongoDB और Redis स्वस्थ होने चाहिए। कंपोज़ फ़ाइल `condition: service_healthy` के साथ `depends_on` का उपयोग करती है। यदि आप बार-बार बैकएंड रीस्टार्ट देखते हैं, तो जांचें कि `mongo` और `redis` हेल्थचेक पास हो गए हैं या नहीं:
+
+```sh
+docker compose ps
+docker compose logs mongo
+docker compose logs redis
+```
+
+### डैशबोर्ड API तक नहीं पहुँच सकता
+
+सत्यापित करें कि `VITE_BACKEND_URL` उस URL से मेल खाता है जहाँ बैकएंड **ब्राउज़र** से (डॉकर नेटवर्क से नहीं) पहुँच योग्य है। यदि आपने बैकएंड पोर्ट बदला है या एक रिवर्स प्रॉक्सी जोड़ा है, तो डैशबोर्ड इमेज को फिर से बनाएँ:
+
+```sh
+docker compose build app
+docker compose up -d app
+```
+
+### ईमेल नहीं भेजा जा रहा है
+
+डिफ़ॉल्ट रूप से, सभी आउटबाउंड ईमेल मेलपिट द्वारा कैप्चर किए जाते हैं। भेजे गए संदेशों को देखने के लिए `http://localhost:8025` खोलें। वास्तविक ईमेल भेजने के लिए, `.env` में `MAIL_PROVIDER=resend` और `RESEND_API_KEY=<your-key>` सेट करें, फिर बैकएंड को रीस्टार्ट करें:
+
+```sh
+docker compose restart backend
+```
+
+### MinIO बकेट गायब है
+
+यदि `minio-init` वन-शॉट सर्विस नहीं चली (या MinIO के तैयार होने से पहले चली), तो बकेट को मैन्युअल रूप से बनाएँ:
+
+```sh
+docker compose run --rm minio-init
+```
+
+---
+
+## उपयोगी लिंक
+
+- [इंटलेयर सीएमएस डॉक्यूमेंटेशन](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/intlayer_CMS.md)
+- [कॉन्फ़िगरेशन संदर्भ](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/configuration.md)
+- [सीएमएस SDK — `@intlayer/api`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/intlayer_CMS.md#programmatic-access-with-the-intlayerapi-sdk)
+- [Docker Image (aymercizip/intlayer-selfhost)](https://hub.docker.com/repository/docker/aymercizip/intlayer-selfhost/general)

package/docs/id/bundle_optimization.md

@@ -231,6 +231,9 @@ Next.js memerlukan plugin `@intlayer/swc` untuk optimasi pass (menulis ulang imp
 
 > Plugin ini tidak terpasang secara default karena plugin SWC masih berada pada tahap eksperimental untuk Next.js. Hal ini dapat berubah di masa yang akan datang.
 
+<Tabs>
+ <Tab value="npm">
+
 ```bash packageManager="npm"
 npm install -D @intlayer/swc
 ```
@@ -247,6 +250,19 @@ pnpm add -D @intlayer/swc
 bun add -d @intlayer/swc
 ```
 
+ </Tab>
+ <Tab value="Crates.io (rust)">
+
+```toml fileName="Cargo.toml"
+[dependencies]
+intlayer-swc-plugin = "*"
+```
+
+[View on Crates.io](https://crates.io/crates/intlayer-swc-plugin)
+
+ </Tab>
+</Tabs>
+
 Setelah dipasang, Intlayer akan mendeteksi dan menggunakan plugin ini secara otomatis.
 
 Untuk langkah **purge dan minify** (menghapus field dan mengganti nama field), instal `@intlayer/babel` bersamanya dan tambahkan plugin Babel tersebut. Walaupun Next.js menggunakan SWC untuk proses transformasi namun ia tetap mengevaluasi `babel.config.js` untuk plugin config, jadi plugin Babel ini berjalan sebagai pra-langkah sebelum SWC dieksekusi.

package/docs/id/cli/index.md

@@ -125,7 +125,7 @@ Untuk mempelajari cara mengonfigurasi bahasa yang tersedia atau parameter lainny
 
 ### Autentikasi
 
-- **[Login](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/login.md)** - Autentikasi dengan Intlayer CMS dan dapatkan kredensial akses
+- **[Login](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/cli/login.md)** - Autentikasi dengan Intlayer CMS dan dapatkan kredensial akses
 
 ### Perintah Utama
 

package/docs/id/cli/scan.md

@@ -150,10 +150,10 @@ await scan("https://example.com", {
 });
 ```
 
-Untuk akses tingkat lebih rendah, `scanWebsite` dari `@intlayer/chokidar/scan` mengembalikan objek `ScanResult` yang terstruktur:
+Untuk akses tingkat lebih rendah, `scanWebsite` dari `@intlayer/engine/scan` mengembalikan objek `ScanResult` yang terstruktur:
 
 ```ts
-import { scanWebsite } from "@intlayer/chokidar/scan";
+import { scanWebsite } from "@intlayer/engine/scan";
 
 const result = await scanWebsite("https://example.com", { deep: false });
 console.log(result.score, result.totalPageSize, result.events);