@umituz/web-localization 1.0.1

package/README.md

@@ -0,0 +1,71 @@
+# @umituz/web-localization 🌍
+
+A powerful localization package for web applications with built-in automatic Google Translate integration.
+
+## 🚀 Features
+
+- **Automatic Translation**: Uses Google Translate API to fill in missing translations.
+- **Key Synchronization**: Automatically syncs directory structures from a base language (e.g., `en-US.ts`) to other language files.
+- **Deep Nesting**: Supports deeply nested JSON structures for complex localization needs.
+- **CLI Tools**: Easy-to-use command line interface for developers.
+
+## 📦 Installation
+
+```bash
+npm install @umituz/web-localization
+```
+
+## 🛠️ Usage
+
+### CLI Commands
+
+First, set up your locales directory:
+
+```bash
+mkdir -p src/locales
+touch src/locales/en-US.ts src/locales/tr-TR.ts
+```
+
+#### Sync Keys
+
+Synchronizes all missing keys from the base language to target languages:
+
+```bash
+npx web-loc sync --locales-dir src/locales --base-lang en-US
+```
+
+#### Translate Automatically
+
+Uses Google Translate to translate all missing keys:
+
+```bash
+npx web-loc translate --locales-dir src/locales --base-lang en-US
+```
+
+### Script Usage
+
+You can also use the translation service directly in your scripts:
+
+```typescript
+import { googleTranslateService } from "@umituz/web-localization";
+
+await googleTranslateService.initialize({});
+const response = await googleTranslateService.translate({
+  text: "Hello World",
+  targetLanguage: "tr"
+});
+
+console.log(response.translatedText); // "Merhaba Dünya"
+```
+
+## 📐 Package Structure
+
+Following the `@umituz` new package structure:
+
+- `src/domain`: Entities and Interfaces
+- `src/infrastructure`: Services, Utils, Constants
+- `src/presentation`: Components and Hooks (React Web helpers coming soon)
+
+---
+
+Developed by **umituz** ⚡

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@umituz/web-localization",
+  "version": "1.0.1",
+  "description": "Google Translate integrated localization package for web applications",
+  "main": "./src/index.ts",
+  "types": "./src/index.ts",
+  "sideEffects": false,
+  "type": "module",
+  "bin": {
+    "web-loc": "./src/scripts/cli.ts"
+  },
+  "exports": {
+    ".": "./src/index.ts",
+    "./services": "./src/infrastructure/services/index.ts",
+    "./utils": "./src/infrastructure/utils/index.ts",
+    "./package.json": "./package.json"
+  },
+  "scripts": {
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint .",
+    "build": "tsc",
+    "version:patch": "npm version patch -m 'chore: release v%s'",
+    "version:minor": "npm version minor -m 'chore: release v%s'",
+    "version:major": "npm version major -m 'chore: release v%s'"
+  },
+  "keywords": [
+    "localization",
+    "i18n",
+    "google-translate",
+    "web"
+  ],
+  "author": "umituz",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "commander": "^12.0.0",
+    "chalk": "^5.3.0",
+    "dotenv": "^16.4.5"
+  },
+  "devDependencies": {
+    "@types/node": "^20.12.7",
+    "typescript": "^5.4.5",
+    "eslint": "^8.57.0",
+    "@typescript-eslint/parser": "^7.7.0",
+    "@typescript-eslint/eslint-plugin": "^7.7.0"
+  },
+  "files": [
+    "src",
+    "README.md",
+    "LICENSE"
+  ]
+}

package/src/domain/entities/translation.entity.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Translation Entity
+ * @description Data structures for translation requests and responses
+ */
+export interface TranslationRequest {
+    readonly text: string;
+    readonly targetLanguage: string;
+    readonly sourceLanguage?: string;
+}
+export interface TranslationResponse {
+    readonly originalText: string;
+    readonly translatedText: string;
+    readonly sourceLanguage: string;
+    readonly targetLanguage: string;
+    readonly success: boolean;
+    readonly error?: string;
+}
+export interface TranslationItem {
+    readonly key: string;
+    readonly from: string;
+    readonly to: string;
+}
+export interface TranslationStats {
+    totalCount: number;
+    successCount: number;
+    failureCount: number;
+    skippedCount: number;
+    translatedKeys: TranslationItem[];
+}
+//# sourceMappingURL=translation.entity.d.ts.map

package/src/domain/entities/translation.entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"translation.entity.d.ts","sourceRoot":"","sources":["translation.entity.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;CAClC;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,eAAe,EAAE,CAAC;CACnC"}

package/src/domain/entities/translation.entity.js

@@ -0,0 +1,5 @@
+/**
+ * Translation Entity
+ * @description Data structures for translation requests and responses
+ */
+export {};

package/src/domain/entities/translation.entity.ts

@@ -0,0 +1,33 @@
+/**
+ * Translation Entity
+ * @description Data structures for translation requests and responses
+ */
+
+export interface TranslationRequest {
+  readonly text: string;
+  readonly targetLanguage: string;
+  readonly sourceLanguage?: string;
+}
+
+export interface TranslationResponse {
+  readonly originalText: string;
+  readonly translatedText: string;
+  readonly sourceLanguage: string;
+  readonly targetLanguage: string;
+  readonly success: boolean;
+  readonly error?: string;
+}
+
+export interface TranslationItem {
+  readonly key: string;
+  readonly from: string;
+  readonly to: string;
+}
+
+export interface TranslationStats {
+  totalCount: number;
+  successCount: number;
+  failureCount: number;
+  skippedCount: number;
+  translatedKeys: TranslationItem[];
+}

package/src/domain/interfaces/translation-service.interface.d.ts

@@ -0,0 +1,21 @@
+import type { TranslationRequest, TranslationResponse, TranslationStats } from "../entities/translation.entity";
+/**
+ * Translation Service Config
+ */
+export interface TranslationServiceConfig {
+    minDelay?: number;
+    maxRetries?: number;
+    timeout?: number;
+    apiKey?: string;
+}
+/**
+ * Translation Service Interface
+ */
+export interface ITranslationService {
+    initialize(config: TranslationServiceConfig): void;
+    isInitialized(): boolean;
+    translate(request: TranslationRequest): Promise<TranslationResponse>;
+    translateBatch(requests: TranslationRequest[]): Promise<TranslationStats>;
+    translateObject(sourceObject: Record<string, unknown>, targetObject: Record<string, unknown>, targetLanguage: string, path?: string, stats?: TranslationStats, onTranslate?: (key: string, from: string, to: string) => void): Promise<void>;
+}
+//# sourceMappingURL=translation-service.interface.d.ts.map

package/src/domain/interfaces/translation-service.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"translation-service.interface.d.ts","sourceRoot":"","sources":["translation-service.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,EACjB,MAAM,gCAAgC,CAAC;AAExC;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,UAAU,CAAC,MAAM,EAAE,wBAAwB,GAAG,IAAI,CAAC;IACnD,aAAa,IAAI,OAAO,CAAC;IACzB,SAAS,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACrE,cAAc,CAAC,QAAQ,EAAE,kBAAkB,EAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAC1E,eAAe,CACb,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrC,cAAc,EAAE,MAAM,EACtB,IAAI,CAAC,EAAE,MAAM,EACb,KAAK,CAAC,EAAE,gBAAgB,EACxB,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,KAAK,IAAI,GAC5D,OAAO,CAAC,IAAI,CAAC,CAAC;CAClB"}

package/src/domain/interfaces/translation-service.interface.js

@@ -0,0 +1 @@
+export {};

package/src/domain/interfaces/translation-service.interface.ts

@@ -0,0 +1,33 @@
+import type {
+  TranslationRequest,
+  TranslationResponse,
+  TranslationStats,
+} from "../entities/translation.entity";
+
+/**
+ * Translation Service Config
+ */
+export interface TranslationServiceConfig {
+  minDelay?: number;
+  maxRetries?: number;
+  timeout?: number;
+  apiKey?: string; // Optional if using public API
+}
+
+/**
+ * Translation Service Interface
+ */
+export interface ITranslationService {
+  initialize(config: TranslationServiceConfig): void;
+  isInitialized(): boolean;
+  translate(request: TranslationRequest): Promise<TranslationResponse>;
+  translateBatch(requests: TranslationRequest[]): Promise<TranslationStats>;
+  translateObject(
+    sourceObject: Record<string, unknown>,
+    targetObject: Record<string, unknown>,
+    targetLanguage: string,
+    path?: string,
+    stats?: TranslationStats,
+    onTranslate?: (key: string, from: string, to: string) => void
+  ): Promise<void>;
+}

package/src/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @umituz/web-localization
+ * Google Translate integrated localization package for web applications
+ */
+export * from "./domain/entities/translation.entity";
+export * from "./domain/interfaces/translation-service.interface";
+export * from "./infrastructure/services/google-translate.service";
+export * from "./infrastructure/constants";
+export * from "./infrastructure/utils/text-validator.util";
+export * from "./infrastructure/utils/rate-limit.util";
+//# sourceMappingURL=index.d.ts.map

package/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,sCAAsC,CAAC;AACrD,cAAc,mDAAmD,CAAC;AAClE,cAAc,oDAAoD,CAAC;AACnE,cAAc,4BAA4B,CAAC;AAC3C,cAAc,4CAA4C,CAAC;AAC3D,cAAc,wCAAwC,CAAC"}

package/src/index.js

@@ -0,0 +1,10 @@
+/**
+ * @umituz/web-localization
+ * Google Translate integrated localization package for web applications
+ */
+export * from "./domain/entities/translation.entity";
+export * from "./domain/interfaces/translation-service.interface";
+export * from "./infrastructure/services/google-translate.service";
+export * from "./infrastructure/constants";
+export * from "./infrastructure/utils/text-validator.util";
+export * from "./infrastructure/utils/rate-limit.util";

package/src/index.ts

@@ -0,0 +1,11 @@
+/**
+ * @umituz/web-localization
+ * Google Translate integrated localization package for web applications
+ */
+
+export * from "./domain/entities/translation.entity";
+export * from "./domain/interfaces/translation-service.interface";
+export * from "./infrastructure/services/google-translate.service";
+export * from "./infrastructure/constants";
+export * from "./infrastructure/utils/text-validator.util";
+export * from "./infrastructure/utils/rate-limit.util";

package/src/infrastructure/constants/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Localization Constants
+ */
+export declare const GOOGLE_TRANSLATE_API_URL = "https://translate.googleapis.com/translate_a/single";
+export declare const DEFAULT_MIN_DELAY = 100;
+export declare const DEFAULT_MAX_RETRIES = 3;
+export declare const DEFAULT_TIMEOUT = 10000;
+export declare const DEFAULT_LOCALES_DIR = "src/locales";
+export declare const DEFAULT_SOURCE_DIR = "src";
+export declare const DEFAULT_BASE_LANGUAGE = "en-US";
+//# sourceMappingURL=index.d.ts.map

package/src/infrastructure/constants/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,eAAO,MAAM,wBAAwB,wDAAwD,CAAC;AAE9F,eAAO,MAAM,iBAAiB,MAAM,CAAC;AACrC,eAAO,MAAM,mBAAmB,IAAI,CAAC;AACrC,eAAO,MAAM,eAAe,QAAQ,CAAC;AAErC,eAAO,MAAM,mBAAmB,gBAAgB,CAAC;AACjD,eAAO,MAAM,kBAAkB,QAAQ,CAAC;AACxC,eAAO,MAAM,qBAAqB,UAAU,CAAC"}

package/src/infrastructure/constants/index.js

@@ -0,0 +1,10 @@
+/**
+ * Localization Constants
+ */
+export const GOOGLE_TRANSLATE_API_URL = "https://translate.googleapis.com/translate_a/single";
+export const DEFAULT_MIN_DELAY = 100;
+export const DEFAULT_MAX_RETRIES = 3;
+export const DEFAULT_TIMEOUT = 10000;
+export const DEFAULT_LOCALES_DIR = "src/locales";
+export const DEFAULT_SOURCE_DIR = "src";
+export const DEFAULT_BASE_LANGUAGE = "en-US";

package/src/infrastructure/constants/index.ts

@@ -0,0 +1,13 @@
+/**
+ * Localization Constants
+ */
+
+export const GOOGLE_TRANSLATE_API_URL = "https://translate.googleapis.com/translate_a/single";
+
+export const DEFAULT_MIN_DELAY = 100;
+export const DEFAULT_MAX_RETRIES = 3;
+export const DEFAULT_TIMEOUT = 10000;
+
+export const DEFAULT_LOCALES_DIR = "src/locales";
+export const DEFAULT_SOURCE_DIR = "src";
+export const DEFAULT_BASE_LANGUAGE = "en-US";

package/src/infrastructure/services/cli.service.d.ts

@@ -0,0 +1,11 @@
+export interface SyncOptions {
+    localesDir?: string;
+    sourceDir?: string;
+    baseLang?: string;
+}
+export declare class CLIService {
+    sync(options?: SyncOptions): Promise<void>;
+    translate(options?: SyncOptions): Promise<void>;
+}
+export declare const cliService: CLIService;
+//# sourceMappingURL=cli.service.d.ts.map

package/src/infrastructure/services/cli.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.service.d.ts","sourceRoot":"","sources":["cli.service.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,WAAW;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,UAAU;IACf,IAAI,CAAC,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAsD9C,SAAS,CAAC,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;CAsD1D;AAED,eAAO,MAAM,UAAU,YAAmB,CAAC"}

package/src/infrastructure/services/cli.service.js

@@ -0,0 +1,95 @@
+import fs from "fs";
+import path from "path";
+import chalk from "chalk";
+import { googleTranslateService } from "./google-translate.service";
+import { parseTypeScriptFile, generateTypeScriptContent } from "../utils/file.util";
+import { DEFAULT_LOCALES_DIR, DEFAULT_BASE_LANGUAGE } from "../constants";
+export class CLIService {
+    async sync(options = {}) {
+        const localesDir = path.resolve(process.cwd(), options.localesDir || DEFAULT_LOCALES_DIR);
+        const baseLang = options.baseLang || DEFAULT_BASE_LANGUAGE;
+        const baseLangPath = path.join(localesDir, `${baseLang}.ts`);
+        if (!fs.existsSync(localesDir)) {
+            console.error(chalk.red(`❌ Locales directory not found: ${localesDir}`));
+            return;
+        }
+        if (!fs.existsSync(baseLangPath)) {
+            console.error(chalk.red(`❌ Base language file not found: ${baseLangPath}`));
+            return;
+        }
+        const baseData = parseTypeScriptFile(baseLangPath);
+        const files = fs.readdirSync(localesDir)
+            .filter(f => f.match(/^[a-z]{2}-[A-Z]{2}\.ts$/) && f !== `${baseLang}.ts`)
+            .sort();
+        console.log(chalk.blue(`📊 Found ${files.length} languages to sync with ${baseLang}.\n`));
+        for (const file of files) {
+            const targetPath = path.join(localesDir, file);
+            const targetData = parseTypeScriptFile(targetPath);
+            const langCode = file.replace(".ts", "");
+            // Deep merge with base data structure
+            const syncObject = (source, target) => {
+                const result = { ...target };
+                for (const key in source) {
+                    if (typeof source[key] === "object" && source[key] !== null) {
+                        result[key] = syncObject(source[key], target[key] || {});
+                    }
+                    else if (target[key] === undefined) {
+                        result[key] = source[key];
+                    }
+                }
+                // Remove extra keys
+                for (const key in target) {
+                    if (source[key] === undefined) {
+                        delete result[key];
+                    }
+                }
+                return result;
+            };
+            const syncedData = syncObject(baseData, targetData);
+            fs.writeFileSync(targetPath, generateTypeScriptContent(syncedData, langCode));
+            console.log(chalk.green(`   🌍 ${langCode}: Synced structure.`));
+        }
+        console.log(chalk.bold.green("\n✅ Synchronization completed!"));
+    }
+    async translate(options = {}) {
+        const localesDir = path.resolve(process.cwd(), options.localesDir || DEFAULT_LOCALES_DIR);
+        const baseLang = options.baseLang || DEFAULT_BASE_LANGUAGE;
+        const baseLangPath = path.join(localesDir, `${baseLang}.ts`);
+        if (!fs.existsSync(baseLangPath)) {
+            console.error(chalk.red(`❌ Base language file not found: ${baseLangPath}`));
+            return;
+        }
+        googleTranslateService.initialize({});
+        const baseData = parseTypeScriptFile(baseLangPath);
+        const files = fs.readdirSync(localesDir)
+            .filter(f => f.match(/^[a-z]{2}-[A-Z]{2}\.ts$/) && f !== `${baseLang}.ts`)
+            .sort();
+        console.log(chalk.blue.bold(`🚀 Starting automatic translation for ${files.length} languages...\n`));
+        for (const file of files) {
+            const targetPath = path.join(localesDir, file);
+            const targetData = parseTypeScriptFile(targetPath);
+            const langCode = file.replace(".ts", "");
+            const stats = {
+                totalCount: 0,
+                successCount: 0,
+                failureCount: 0,
+                skippedCount: 0,
+                translatedKeys: []
+            };
+            console.log(chalk.yellow(`🌍 Translating ${langCode}...`));
+            await googleTranslateService.translateObject(baseData, targetData, langCode.split("-")[0], // ISO 639-1
+            "", stats, (key, from, to) => {
+                process.stdout.write(chalk.gray(`   • ${key}: ${from.substring(0, 15)}... → ${to.substring(0, 15)}...\r`));
+            });
+            if (stats.successCount > 0) {
+                fs.writeFileSync(targetPath, generateTypeScriptContent(targetData, langCode));
+                console.log(chalk.green(`   ✅ Successfully translated ${stats.successCount} keys.`));
+            }
+            else {
+                console.log(chalk.gray("   ✨ Already up to date."));
+            }
+        }
+        console.log(chalk.bold.green("\n✅ All translations completed!"));
+    }
+}
+export const cliService = new CLIService();

package/src/infrastructure/services/cli.service.ts

@@ -0,0 +1,129 @@
+import fs from "fs";
+import path from "path";
+import chalk from "chalk";
+import { googleTranslateService } from "./google-translate.service";
+import { parseTypeScriptFile, generateTypeScriptContent } from "../utils/file.util";
+import { 
+  DEFAULT_LOCALES_DIR, 
+  DEFAULT_SOURCE_DIR, 
+  DEFAULT_BASE_LANGUAGE 
+} from "../constants";
+
+export interface SyncOptions {
+  localesDir?: string;
+  sourceDir?: string;
+  baseLang?: string;
+}
+
+export class CLIService {
+  async sync(options: SyncOptions = {}): Promise<void> {
+    const localesDir = path.resolve(process.cwd(), options.localesDir || DEFAULT_LOCALES_DIR);
+    const baseLang = options.baseLang || DEFAULT_BASE_LANGUAGE;
+    const baseLangPath = path.join(localesDir, `${baseLang}.ts`);
+
+    if (!fs.existsSync(localesDir)) {
+      console.error(chalk.red(`❌ Locales directory not found: ${localesDir}`));
+      return;
+    }
+
+    if (!fs.existsSync(baseLangPath)) {
+      console.error(chalk.red(`❌ Base language file not found: ${baseLangPath}`));
+      return;
+    }
+
+    const baseData = parseTypeScriptFile(baseLangPath);
+    const files = fs.readdirSync(localesDir)
+      .filter(f => f.match(/^[a-z]{2}-[A-Z]{2}\.ts$/) && f !== `${baseLang}.ts`)
+      .sort();
+
+    console.log(chalk.blue(`📊 Found ${files.length} languages to sync with ${baseLang}.\n`));
+
+    for (const file of files) {
+      const targetPath = path.join(localesDir, file);
+      const targetData = parseTypeScriptFile(targetPath);
+      const langCode = file.replace(".ts", "");
+
+      // Deep merge with base data structure
+      const syncObject = (source: any, target: any) => {
+        const result = { ...target };
+        for (const key in source) {
+          if (typeof source[key] === "object" && source[key] !== null) {
+            result[key] = syncObject(source[key], target[key] || {});
+          } else if (target[key] === undefined) {
+            result[key] = source[key];
+          }
+        }
+        // Remove extra keys
+        for (const key in target) {
+          if (source[key] === undefined) {
+            delete result[key];
+          }
+        }
+        return result;
+      };
+
+      const syncedData = syncObject(baseData, targetData);
+      fs.writeFileSync(targetPath, generateTypeScriptContent(syncedData, langCode));
+      console.log(chalk.green(`   🌍 ${langCode}: Synced structure.`));
+    }
+
+    console.log(chalk.bold.green("\n✅ Synchronization completed!"));
+  }
+
+  async translate(options: SyncOptions = {}): Promise<void> {
+    const localesDir = path.resolve(process.cwd(), options.localesDir || DEFAULT_LOCALES_DIR);
+    const baseLang = options.baseLang || DEFAULT_BASE_LANGUAGE;
+    const baseLangPath = path.join(localesDir, `${baseLang}.ts`);
+
+    if (!fs.existsSync(baseLangPath)) {
+      console.error(chalk.red(`❌ Base language file not found: ${baseLangPath}`));
+      return;
+    }
+
+    googleTranslateService.initialize({});
+    const baseData = parseTypeScriptFile(baseLangPath);
+    const files = fs.readdirSync(localesDir)
+      .filter(f => f.match(/^[a-z]{2}-[A-Z]{2}\.ts$/) && f !== `${baseLang}.ts`)
+      .sort();
+
+    console.log(chalk.blue.bold(`🚀 Starting automatic translation for ${files.length} languages...\n`));
+
+    for (const file of files) {
+      const targetPath = path.join(localesDir, file);
+      const targetData = parseTypeScriptFile(targetPath);
+      const langCode = file.replace(".ts", "");
+      
+      const stats = {
+        totalCount: 0,
+        successCount: 0,
+        failureCount: 0,
+        skippedCount: 0,
+        translatedKeys: []
+      };
+
+      console.log(chalk.yellow(`🌍 Translating ${langCode}...`));
+
+      await googleTranslateService.translateObject(
+        baseData,
+        targetData,
+        langCode.split("-")[0], // ISO 639-1
+        "",
+        stats,
+        (key, from, to) => {
+          process.stdout.write(chalk.gray(`   • ${key}: ${from.substring(0, 15)}... → ${to.substring(0, 15)}...\r`));
+        }
+      );
+
+      if (stats.successCount > 0) {
+        fs.writeFileSync(targetPath, generateTypeScriptContent(targetData, langCode));
+        console.log(chalk.green(`   ✅ Successfully translated ${stats.successCount} keys.`));
+      } else {
+        console.log(chalk.gray("   ✨ Already up to date."));
+      }
+    }
+
+    console.log(chalk.bold.green("\n✅ All translations completed!"));
+  }
+}
+
+export const cliService = new CLIService();

package/src/infrastructure/services/google-translate.service.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Google Translate Service
+ * @description Main translation service using Google Translate API
+ */
+import type { TranslationRequest, TranslationResponse, TranslationStats } from "../../domain/entities/translation.entity";
+import type { ITranslationService, TranslationServiceConfig } from "../../domain/interfaces/translation-service.interface";
+declare class GoogleTranslateService implements ITranslationService {
+    private config;
+    private rateLimiter;
+    initialize(config: TranslationServiceConfig): void;
+    isInitialized(): boolean;
+    private ensureInitialized;
+    translate(request: TranslationRequest): Promise<TranslationResponse>;
+    translateBatch(requests: TranslationRequest[]): Promise<TranslationStats>;
+    translateObject(sourceObject: Record<string, unknown>, targetObject: Record<string, unknown>, targetLanguage: string, path?: string, stats?: TranslationStats, onTranslate?: (key: string, from: string, to: string) => void): Promise<void>;
+    private callTranslateAPI;
+}
+export declare const googleTranslateService: GoogleTranslateService;
+export { GoogleTranslateService };
+//# sourceMappingURL=google-translate.service.d.ts.map

package/src/infrastructure/services/google-translate.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"google-translate.service.d.ts","sourceRoot":"","sources":["google-translate.service.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,EACjB,MAAM,0CAA0C,CAAC;AAClD,OAAO,KAAK,EACV,mBAAmB,EACnB,wBAAwB,EACzB,MAAM,uDAAuD,CAAC;AAa/D,cAAM,sBAAuB,YAAW,mBAAmB;IACzD,OAAO,CAAC,MAAM,CAAyC;IACvD,OAAO,CAAC,WAAW,CAA4B;IAE/C,UAAU,CAAC,MAAM,EAAE,wBAAwB,GAAG,IAAI;IASlD,aAAa,IAAI,OAAO;IAIxB,OAAO,CAAC,iBAAiB;IAQnB,SAAS,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAsDpE,cAAc,CAAC,QAAQ,EAAE,kBAAkB,EAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAyDzE,eAAe,CACnB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrC,cAAc,EAAE,MAAM,EACtB,IAAI,SAAK,EACT,KAAK,GAAE,gBAMN,EACD,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,KAAK,IAAI,GAC5D,OAAO,CAAC,IAAI,CAAC;YA6DF,gBAAgB;CAuC/B;AAED,eAAO,MAAM,sBAAsB,wBAA+B,CAAC;AACnE,OAAO,EAAE,sBAAsB,EAAE,CAAC"}