@intlayer/docs 9.0.0-canary.9 → 9.0.1

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);

package/docs/id/configuration.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-13
-updatedAt: 2026-06-23
+updatedAt: 2026-07-11
 title: Konfigurasi
 description: Pelajari cara mengonfigurasi Intlayer untuk aplikasi Anda. Pahami berbagai pengaturan dan opsi yang tersedia untuk menyesuaikan Intlayer sesuai kebutuhan Anda.
 keywords:
@@ -14,6 +14,9 @@ slugs:
   - concept
   - configuration
 history:
+  - version: 9.0.0
+    date: 2026-07-11
+    changes: "Menambahkan konfigurasi `analytics`"
   - version: 9.0.0
     date: 2026-06-24
     changes: "Add `enableProxy` option to the routing configuration"
@@ -355,6 +358,30 @@ const config: IntlayerConfig = {
     liveSync: true,
   },
 
+  /**
+   * Konfigurasi analitik (analytics).
+   */
+  analytics: {
+    /**
+     * Apakah pengumpulan analitik diaktifkan (tampilan halaman, eksposur konten, peristiwa A/B).
+     * Membutuhkan `editor.clientId` untuk diatur agar atribusi berfungsi.
+     * Default: false
+     */
+    enabled: true,
+
+    /**
+     * Milidetik antara pengiriman batch otomatis ke backend.
+     * Default: 20000
+     */
+    flushInterval: 20000,
+
+    /**
+     * Fraksi sesi yang direkam, dari 0 (tidak ada) hingga 1 (semua).
+     * Default: 1
+     */
+    sampleRate: 1,
+  },
+
   /**
    * Pengaturan terjemahan dan pembuatan berbasis AI.
    */
@@ -668,6 +695,20 @@ Mendefinisikan pengaturan yang terkait dengan editor terintegrasi, termasuk port
 
 ---
 
+### Konfigurasi Analitik (Analytics)
+
+Menentukan pengaturan terkait analitik Intlayer: mengumpulkan konten apa yang sebenarnya ditampilkan kepada pengguna (tampilan halaman, eksposur konten) dan mendukung pengujian A/B pada konten.
+
+Analitik bersifat opt-in secara ketat: tidak ada yang dikumpulkan kecuali `analytics.enabled` secara eksplisit diatur ke `true` **dan** kunci proyek (`editor.clientId`) dikonfigurasi untuk atribusi. Saat dinonaktifkan (default), seluruh integrasi analitik dihilangkan dari bundel aplikasi Anda (dead-code elimination).
+
+| Field           | Deskripsi                                                                             | Tipe      | Default | Contoh  | Catatan                                                                                                                                     |
+| --------------- | ------------------------------------------------------------------------------------- | --------- | ------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
+| `enabled`       | Mengaktifkan pengumpulan analitik (tampilan halaman, eksposur konten, peristiwa A/B). | `boolean` | `false` | `true`  | Membutuhkan `editor.clientId` untuk diatur agar atribusi berfungsi; jika tidak, analitik tetap nonaktif meskipun `enabled` bernilai `true`. |
+| `flushInterval` | Milidetik antara pengiriman batch otomatis ke backend.                                | `number`  | `20000` | `10000` |                                                                                                                                             |
+| `sampleRate`    | Fraksi sesi yang direkam, dari `0` (tidak ada) hingga `1` (semua).                    | `number`  | `1`     | `0.5`   | Sampling bersifat deterministik per sesi, sehingga sesi yang direkam melaporkan semua peristiwanya (tidak ada funnel parsial).              |
+
+---
+
 ### Konfigurasi Routing (Routing)
 
 Pengaturan yang mengontrol perilaku routing, termasuk struktur URL, penyimpanan locale, dan penanganan middleware.

package/docs/id/how_works_intlayer.md

@@ -220,9 +220,9 @@ Paket `@intlayer/mcp` menyediakan server MCP (Model Context Protocol) yang membe
 
 Paket `@intlayer/dictionaries-entry`, `@intlayer/unmerged-dictionaries-entry` dan `@intlayer/dynamic-dictionaries-entry` mengembalikan jalur entri dari kamus Intlayer. Karena pencarian sistem berkas dari browser tidak mungkin dilakukan, menggunakan bundler seperti Webpack atau Rollup untuk mengambil jalur entri kamus juga tidak memungkinkan. Paket-paket ini dirancang untuk di-alias-kan, memungkinkan optimasi bundling di berbagai bundler seperti Vite, Webpack, dan Turbopack.
 
-### @intlayer/chokidar
+### @intlayer/engine
 
-Paket `@intlayer/chokidar` digunakan untuk memantau file konten dan menghasilkan ulang kamus yang dimodifikasi setiap kali ada perubahan.
+Paket `@intlayer/engine` digunakan untuk memantau file konten dan menghasilkan ulang kamus yang dimodifikasi setiap kali ada perubahan.
 
 ### @intlayer/editor
 

package/docs/id/intlayer_CMS.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-08-23
-updatedAt: 2025-08-23
+updatedAt: 2026-07-08
 title: Intlayer CMS | Eksternalisasi konten Anda ke Intlayer CMS
 description: Eksternalisasi konten Anda ke Intlayer CMS untuk mendelegasikan pengelolaan konten kepada tim Anda.
 keywords:
@@ -18,6 +18,9 @@ slugs:
   - cms
 youtubeVideo: https://www.youtube.com/watch?v=UDDTnirwi_4
 history:
+  - version: 9.0.0
+    date: 2026-07-08
+    changes: "Bagian 'Sinkronisasi langsung' dipindahkan ke halamannya sendiri (live-sync.md), hanya menyisakan pengantar singkat dan tautan di sini"
   - version: 6.0.1
     date: 2025-09-22
     changes: "Menambahkan dokumentasi live sync"
@@ -245,144 +248,7 @@ Kemudian Anda akan dapat melihat dan mengelola kamus Anda di [Intlayer CMS](http
 
 Sinkronisasi Langsung memungkinkan aplikasi Anda mencerminkan perubahan konten CMS secara real-time. Tidak perlu membangun ulang atau menerapkan ulang. Saat diaktifkan, pembaruan dikirimkan ke server Sinkronisasi Langsung yang menyegarkan kamus yang dibaca aplikasi Anda.
 
-Aktifkan Sinkronisasi Langsung dengan memperbarui konfigurasi Intlayer Anda:
-
-```typescript fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
-import type { IntlayerConfig } from "intlayer";
-
-const config: IntlayerConfig = {
-  // ... pengaturan konfigurasi lainnya
-  editor: {
-    /**
-     * Mengaktifkan hot reloading konfigurasi locale saat perubahan terdeteksi.
-     * Misalnya, ketika sebuah kamus ditambahkan atau diperbarui, aplikasi akan memperbarui
-     * konten yang ditampilkan pada halaman.
-     *
-     * Karena hot reloading memerlukan koneksi terus-menerus ke server, fitur ini
-     * hanya tersedia untuk klien dengan paket `enterprise`.
-     *
-     * Default: false
-     */
-    liveSync: true,
-  },
-  dictionary: {
-    /**
-     * Mengontrol bagaimana kamus diimpor:
-     *
-     * - "live": Kamus diambil secara dinamis menggunakan Live Sync API.
-     *   Menggantikan useIntlayer dengan useDictionaryDynamic.
-     *
-     * Catatan: Mode live menggunakan Live Sync API untuk mengambil kamus. Jika panggilan API
-     * gagal, kamus diimpor secara dinamis.
-     * Catatan: Hanya kamus dengan konten jarak jauh dan flag "live" yang menggunakan mode live.
-     * Yang lain menggunakan mode dinamis untuk kinerja.
-     */
-    importMode: "fetch",
-  },
-};
-
-export default config;
-```
-
-Mulai server Live Sync untuk membungkus aplikasi Anda:
-
-Contoh menggunakan server mandiri:
-
-```json5 fileName="package.json"
-{
-  "scripts": {
-    // ... skrip lainnya
-    "live:start": "npx intlayer live",
-  },
-}
-```
-
-Anda juga dapat menggunakan server aplikasi Anda secara paralel dengan menggunakan argumen `--process`.
-
-Contoh menggunakan Next.js:
-
-```json5 fileName="package.json"
-{
-  "scripts": {
-    // ... skrip lainnya
-    "build": "next build",
-    "dev": "next dev",
-    "start": "npx intlayer live --with 'next start'",
-  },
-}
-```
-
-Contoh menggunakan Vite:
-
-```json5 fileName="package.json"
-{
-  "scripts": {
-    // ... skrip lainnya
-    "build": "vite build",
-    "dev": "vite dev",
-    "start": "npx intlayer live --with 'vite start'",
-  },
-}
-```
-
-Server Live Sync membungkus aplikasi Anda dan secara otomatis menerapkan konten yang diperbarui saat konten tersebut tiba.
-
-Untuk menerima notifikasi perubahan dari CMS, server Live Sync mempertahankan koneksi SSE ke backend. Ketika konten berubah di CMS, backend meneruskan pembaruan ke server Live Sync, yang kemudian menulis kamus baru. Aplikasi Anda akan mencerminkan pembaruan tersebut pada navigasi berikutnya atau saat memuat ulang browser, tidak perlu membangun ulang.
-
-Diagram alur (CMS/Backend -> Server Live Sync -> Server Aplikasi -> Frontend):
-
-![Alur Live Sync CMS/Backend/Server Live Sync/Server Aplikasi/Frontend](https://github.com/aymericzip/intlayer/blob/main/docs/assets/live_sync_flow_scema.svg)
-
-Cara kerjanya:
-
-![Skema Logika Live Sync](https://github.com/aymericzip/intlayer/blob/main/docs/assets/live_sync_logic_schema.svg)
-
-### Alur kerja pengembangan (lokal)
-
-- Dalam pengembangan, semua kamus jarak jauh diambil saat aplikasi dimulai, sehingga Anda dapat menguji pembaruan dengan cepat.
-- Untuk menguji Live Sync secara lokal dengan Next.js, bungkus server dev Anda:
-
-```json5 fileName="package.json"
-{
-  "scripts": {
-    // ... skrip lainnya
-    "dev": "npx intlayer live --with 'next dev'",
-    // "dev": "npx intlayer live --with 'vite dev'", // Untuk Vite
-  },
-}
-```
-
-Aktifkan optimasi agar Intlayer menerapkan transformasi impor Live selama pengembangan:
-
-```typescript fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
-import type { IntlayerConfig } from "intlayer";
-
-const config: IntlayerConfig = {
-  editor: {
-    applicationURL: "http://localhost:5173",
-    liveSyncURL: "http://localhost:4000",
-    liveSync: true,
-  },
-  dictionary: {
-    importMode: "fetch",
-  },
-  build: {
-    optimize: true,
-  },
-};
-
-export default config;
-```
-
-Pengaturan ini membungkus server dev Anda dengan server Live Sync, mengambil kamus jarak jauh saat startup, dan mengalirkan pembaruan dari CMS melalui SSE. Segarkan halaman untuk melihat perubahan.
-
-Catatan dan batasan:
-
-- Tambahkan origin live sync ke kebijakan keamanan situs Anda (CSP). Pastikan URL live sync diizinkan dalam `connect-src` (dan `frame-ancestors` jika relevan).
-- Live Sync tidak berfungsi dengan output statis. Untuk Next.js, halaman harus dinamis agar dapat menerima pembaruan saat runtime (misalnya, gunakan `generateStaticParams`, `generateMetadata`, `getServerSideProps`, atau `getStaticProps` secara tepat untuk menghindari batasan hanya statis penuh).
-- Di CMS, setiap kamus memiliki flag `live`. Hanya kamus dengan `live=true` yang diambil melalui API live sync; yang lain diimpor secara dinamis dan tetap tidak berubah saat runtime.
-- Flag `live` dievaluasi untuk setiap kamus saat build. Jika konten jarak jauh tidak diberi flag `live=true` selama build, Anda harus membangun ulang untuk mengaktifkan Live Sync untuk kamus tersebut.
-- Server live sync harus dapat menulis ke `.intlayer`. Dalam container, pastikan akses tulis ke `/.intlayer`.
+Untuk panduan pengaturan lengkap (mengaktifkan, menjalankan server Live Sync, alur kerja pengembangan lokal, dan batasan), lihat [dokumentasi Live Sync](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/live-sync.md).
 
 ## Debug