@kopynator/cli 1.1.0 → 1.3.0

package/PUBLISH.md

@@ -0,0 +1,59 @@
+# Publicar @kopynator/cli en npm
+
+## Requisitos
+
+- Cuenta en [npmjs.com](https://www.npmjs.com) con acceso al scope `@kopynator` (o ser el propietario de la organización `kopynator`).
+- `npm` instalado y sesión iniciada.
+
+## Pasos
+
+### 1. Iniciar sesión en npm (si no lo has hecho)
+
+```bash
+npm login
+```
+
+Te pedirá usuario, contraseña y email (o 2FA si lo tienes activado).
+
+### 2. Compilar y publicar desde el paquete CLI
+
+Desde la **raíz del monorepo** (para que las workspaces estén bien) o desde `packages/cli`:
+
+```bash
+cd packages/cli
+npm run build
+npm publish
+```
+
+- El script `prepublishOnly` ejecuta `npm run build` antes de publicar, así que `npm publish` ya deja el `dist/` actualizado.
+- `publishConfig.access: "public"` en `package.json` hace que el paquete scoped `@kopynator/cli` sea público.
+
+### 3. Comprobar la versión publicada
+
+- En npm: https://www.npmjs.com/package/@kopynator/cli  
+- Desde terminal: `npm view @kopynator/cli version`
+
+## Subir una nueva versión (después de cambios)
+
+1. **Subir versión** (elegir una):
+   - Parche (1.3.0 → 1.3.1): `npm run release:patch`
+   - Minor (1.3.0 → 1.4.0): `npm run release:minor`
+   - Major (1.4.0 → 2.0.0): `npm run release:major`
+
+   O editar a mano `version` en `package.json` y en `src/index.ts` (`.version('X.Y.Z')`).
+
+2. **Compilar y publicar**:
+   ```bash
+   npm run build
+   npm publish
+   ```
+
+3. (Opcional) **Crear tag en Git**:
+   ```bash
+   git tag @kopynator/cli@1.3.0
+   git push origin @kopynator/cli@1.3.0
+   ```
+
+## Versión actual
+
+Tras añadir el comando `upload`, la versión del CLI es **1.3.0**.

package/README.md

@@ -33,13 +33,26 @@ Validates your local JSON translation files for syntax errors. Useful for CI/CD
 npx -y @kopynator/cli check
 ```
 
-### 3. Sync (Premium)
-Synchronizes your local keys with the Kopynator Cloud. Uploads new keys and downloads approved translations.
+### 3. Sync
+Downloads translations from the Kopynator Cloud and saves them as local JSON files (e.g. `src/assets/i18n/en.json`).
 
 ```bash
 npx -y @kopynator/cli sync
 ```
 
+### 4. Upload
+Uploads a JSON translation file to the Kopynator Cloud. Keys are merged/updated for the given language. Use the same API key (token) as in your app or `kopynator.config.json`.
+
+```bash
+# Language inferred from filename (es.json → es)
+npx -y @kopynator/cli upload --file=src/assets/i18n/es.json
+
+# Explicit language
+npx -y @kopynator/cli upload --file=locales/en.json --lang=en
+```
+
+After uploading, run `sync` to download the latest state from the cloud if needed.
+
 ## Configuration
 The `init` command creates a `kopynator.config.json` file in your root:
 

package/dist/index.js

@@ -25,7 +25,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 
 // src/index.ts
 var import_commander = require("commander");
-var import_chalk4 = __toESM(require("chalk"));
+var import_chalk5 = __toESM(require("chalk"));
 
 // src/commands/init.ts
 var import_inquirer = __toESM(require("inquirer"));
@@ -34,12 +34,53 @@ var import_fs = __toESM(require("fs"));
 var import_path = __toESM(require("path"));
 async function initCommand() {
   console.log(import_chalk.default.bold.blue("\n\u{1F680} Initializing Kopynator...\n"));
+  let detectedFramework = null;
+  let isReactNative = false;
+  let isIonic = false;
+  let ionicFramework = null;
+  const packageJsonPath = import_path.default.join(process.cwd(), "package.json");
+  if (import_fs.default.existsSync(packageJsonPath)) {
+    try {
+      const packageJson = JSON.parse(import_fs.default.readFileSync(packageJsonPath, "utf-8"));
+      const deps = { ...packageJson.dependencies, ...packageJson.devDependencies };
+      if (deps["react-native"]) {
+        isReactNative = true;
+        detectedFramework = "React Native";
+        console.log(import_chalk.default.cyan("\u{1F4F1} Detected React Native project!"));
+      } else if (deps["@ionic/angular"] || deps["@ionic/react"] || deps["@ionic/vue"] || deps["@capacitor/core"]) {
+        isIonic = true;
+        if (deps["@ionic/angular"] || deps["@angular/core"]) {
+          ionicFramework = "Angular";
+          detectedFramework = "Ionic (Angular)";
+        } else if (deps["@ionic/react"] || deps["react"]) {
+          ionicFramework = "React";
+          detectedFramework = "Ionic (React)";
+        } else if (deps["@ionic/vue"] || deps["vue"]) {
+          ionicFramework = "Vue";
+          detectedFramework = "Ionic (Vue)";
+        }
+        console.log(import_chalk.default.magenta(`\u{1F50C} Detected ${detectedFramework} project!`));
+      } else if (deps["@angular/core"]) {
+        detectedFramework = "Angular";
+        console.log(import_chalk.default.red("\u{1F170}\uFE0F  Detected Angular project!"));
+      } else if (deps["react"] && !deps["react-native"]) {
+        detectedFramework = "React";
+        console.log(import_chalk.default.blue("\u269B\uFE0F  Detected React project!"));
+      } else if (deps["vue"]) {
+        detectedFramework = "Vue";
+        console.log(import_chalk.default.green("\u{1F7E2} Detected Vue project!"));
+      }
+    } catch (error) {
+      console.log(import_chalk.default.yellow("\u26A0\uFE0F  Could not read package.json"));
+    }
+  }
   const answers = await import_inquirer.default.prompt([
     {
       type: "list",
       name: "framework",
-      message: "What framework are you using?",
-      choices: ["Angular", "React", "Vue", "Other"]
+      message: detectedFramework ? `Detected ${detectedFramework}. Is this correct?` : "What framework are you using?",
+      choices: detectedFramework ? [detectedFramework, "Other"] : ["Angular", "React", "Vue", "React Native", "Ionic", "Other"],
+      default: detectedFramework || "React"
     },
     {
       type: "input",
@@ -146,6 +187,70 @@ async function initCommand() {
       console.log(import_chalk.default.yellow("\u26A0\uFE0F  Could not find app.config.ts or app.module.ts. Falling back to config file."));
     }
   }
+  if (isReactNative || answers.framework === "React Native") {
+    console.log(import_chalk.default.green("\n\u2705 React Native Setup"));
+    console.log(import_chalk.default.cyan("\nInstall the package:"));
+    console.log(import_chalk.default.white("  npm install @kopynator/react"));
+    console.log(import_chalk.default.cyan("\nWrap your App.tsx:"));
+    console.log(import_chalk.default.gray(`
+  import { KopyProvider } from '@kopynator/react';
+  
+  export default function App() {
+    return (
+      <KopyProvider config={{ apiKey: 'YOUR_API_KEY', languages: ${JSON.stringify(answers.languages)} }}>
+        <YourApp />
+      </KopyProvider>
+    );
+  }`));
+    console.log(import_chalk.default.yellow("\n\u{1F4CC} Get your API Key from: https://www.kopynator.com"));
+    return;
+  }
+  if (isIonic) {
+    console.log(import_chalk.default.green(`
+\u2705 Ionic (${ionicFramework}) Setup`));
+    console.log(import_chalk.default.magenta("\n\u2139\uFE0F  Ionic/Capacitor apps use the standard web framework packages."));
+    if (ionicFramework === "Angular") {
+      console.log(import_chalk.default.cyan("\nInstall the package:"));
+      console.log(import_chalk.default.white("  npm install @kopynator/angular"));
+      console.log(import_chalk.default.cyan("\nAdd to your app.config.ts or app.module.ts:"));
+      console.log(import_chalk.default.gray(`
+  import { provideKopynator } from '@kopynator/angular';
+  
+  providers: [
+    provideKopynator({
+      apiKey: 'YOUR_API_KEY',
+      mode: 'hybrid',
+      languages: ${JSON.stringify(answers.languages)}
+    })
+  ]`));
+    } else if (ionicFramework === "React") {
+      console.log(import_chalk.default.cyan("\nInstall the package:"));
+      console.log(import_chalk.default.white("  npm install @kopynator/react"));
+      console.log(import_chalk.default.cyan("\nWrap your App:"));
+      console.log(import_chalk.default.gray(`
+  import { KopyProvider } from '@kopynator/react';
+  
+  <KopyProvider config={{ apiKey: 'YOUR_API_KEY', languages: ${JSON.stringify(answers.languages)} }}>
+    <IonApp>...</IonApp>
+  </KopyProvider>`));
+    } else if (ionicFramework === "Vue") {
+      console.log(import_chalk.default.cyan("\nInstall the package:"));
+      console.log(import_chalk.default.white("  npm install @kopynator/vue"));
+      console.log(import_chalk.default.cyan("\nAdd to your main.ts:"));
+      console.log(import_chalk.default.gray(`
+  import { createKopy } from '@kopynator/vue';
+  
+  const kopy = createKopy({
+    apiKey: 'YOUR_API_KEY',
+    defaultLocale: '${answers.defaultLocale}'
+  });
+  
+  app.use(kopy);`));
+    }
+    console.log(import_chalk.default.yellow("\n\u{1F4CC} Get your API Key from: https://www.kopynator.com"));
+    console.log(import_chalk.default.green("\n\u{1F4A1} Pro Tip: Your translations will work seamlessly across iOS, Android, and web!"));
+    return;
+  }
   const configContent = {
     apiKey: "YOUR_API_KEY_HERE",
     defaultLocale: answers.defaultLocale,
@@ -339,7 +444,11 @@ async function syncCommand() {
   try {
     spinner.text = "\u{1F4E1} Fetching available languages...";
     const languagesUrl = `${baseUrl}/languages?token=${token}`;
-    const languagesResponse = await fetch(languagesUrl);
+    const languagesResponse = await fetch(languagesUrl, {
+      headers: {
+        "x-kopynator-version": "1.1.0"
+      }
+    });
     if (!languagesResponse.ok) {
       spinner.fail(`Failed to fetch languages: ${languagesResponse.status} ${languagesResponse.statusText}`);
       return;
@@ -355,7 +464,11 @@ async function syncCommand() {
       const downloadSpinner = (0, import_ora.default)(`\u2B07\uFE0F  Downloading ${locale}...`).start();
       const fetchUrl = `${baseUrl}/fetch?token=${token}&langs=${locale}&nested=${syncConfig.nested}&includeLangKey=${syncConfig.includeLangKey}&pretty=${syncConfig.pretty}&indent=${syncConfig.indent}`;
       try {
-        const translationResponse = await fetch(fetchUrl);
+        const translationResponse = await fetch(fetchUrl, {
+          headers: {
+            "x-kopynator-version": "1.1.0"
+          }
+        });
         if (!translationResponse.ok) {
           downloadSpinner.warn(`Failed to fetch ${locale}: ${translationResponse.status}`);
           continue;
@@ -381,14 +494,132 @@ async function syncCommand() {
   }
 }
 
+// src/commands/upload.ts
+var import_chalk4 = __toESM(require("chalk"));
+var import_fs4 = __toESM(require("fs"));
+var import_path4 = __toESM(require("path"));
+var import_ora2 = __toESM(require("ora"));
+var BATCH_SIZE = 500;
+function flatten(data, prefix = "") {
+  const result = {};
+  for (const key in data) {
+    const fullKey = prefix ? `${prefix}.${key}` : key;
+    const value = data[key];
+    if (value !== null && typeof value === "object" && !Array.isArray(value)) {
+      Object.assign(result, flatten(value, fullKey));
+    } else {
+      result[fullKey] = String(value);
+    }
+  }
+  return result;
+}
+function extractApiKey2() {
+  const appConfigPath = import_path4.default.join(process.cwd(), "src/app/app.config.ts");
+  const appModulePath = import_path4.default.join(process.cwd(), "src/app/app.module.ts");
+  const jsonConfigPath = import_path4.default.join(process.cwd(), "kopynator.config.json");
+  if (import_fs4.default.existsSync(appConfigPath)) {
+    const content = import_fs4.default.readFileSync(appConfigPath, "utf-8");
+    const apiKeyMatch = content.match(/apiKey:\s*['"]([^'"]+)['"]/);
+    if (apiKeyMatch) return { apiKey: apiKeyMatch[1] };
+  }
+  if (import_fs4.default.existsSync(appModulePath)) {
+    const content = import_fs4.default.readFileSync(appModulePath, "utf-8");
+    const apiKeyMatch = content.match(/apiKey:\s*['"]([^'"]+)['"]/);
+    if (apiKeyMatch) return { apiKey: apiKeyMatch[1] };
+  }
+  if (import_fs4.default.existsSync(jsonConfigPath)) {
+    try {
+      const config = JSON.parse(import_fs4.default.readFileSync(jsonConfigPath, "utf-8"));
+      if (config.apiKey) return { apiKey: config.apiKey, baseUrl: config.baseUrl };
+    } catch {
+    }
+  }
+  return null;
+}
+function inferLangFromFile(filePath) {
+  const base = import_path4.default.basename(filePath, import_path4.default.extname(filePath));
+  return base;
+}
+async function uploadCommand(options) {
+  console.log(import_chalk4.default.bold.blue("\n\u{1F4E4} Upload translations to Kopynator Cloud...\n"));
+  const config = extractApiKey2();
+  if (!config) {
+    console.log(import_chalk4.default.red("\u274C Could not find API key. Run `npx kopynator init` or set apiKey in kopynator.config.json / app.config.ts"));
+    return;
+  }
+  const fileOption = options.file;
+  if (!fileOption) {
+    console.log(import_chalk4.default.red("\u274C Missing --file. Example: npx kopynator upload --file=es.json [--lang=es]"));
+    return;
+  }
+  const resolvedPath = import_path4.default.isAbsolute(fileOption) ? fileOption : import_path4.default.join(process.cwd(), fileOption);
+  if (!import_fs4.default.existsSync(resolvedPath)) {
+    console.log(import_chalk4.default.red(`\u274C File not found: ${resolvedPath}`));
+    return;
+  }
+  const lang = options.lang || inferLangFromFile(resolvedPath);
+  const baseUrl = config.baseUrl || "https://api.kopynator.com/api/tokens";
+  const token = config.apiKey;
+  let raw;
+  try {
+    raw = JSON.parse(import_fs4.default.readFileSync(resolvedPath, "utf-8"));
+  } catch (e) {
+    console.log(import_chalk4.default.red(`\u274C Invalid JSON: ${resolvedPath}`));
+    return;
+  }
+  if (typeof raw !== "object" || raw === null || Array.isArray(raw)) {
+    console.log(import_chalk4.default.red("\u274C JSON root must be an object (key-value)."));
+    return;
+  }
+  const flat = flatten(raw);
+  const entries = Object.entries(flat);
+  const total = entries.length;
+  if (total === 0) {
+    console.log(import_chalk4.default.yellow("\u26A0\uFE0F  No keys to upload."));
+    return;
+  }
+  const batches = [];
+  for (let i = 0; i < total; i += BATCH_SIZE) {
+    batches.push(Object.fromEntries(entries.slice(i, i + BATCH_SIZE)));
+  }
+  const spinner = (0, import_ora2.default)(`Uploading ${total} keys (${lang})...`).start();
+  try {
+    let imported = 0;
+    for (let i = 0; i < batches.length; i++) {
+      spinner.text = `Uploading batch ${i + 1}/${batches.length}...`;
+      const res = await fetch(`${baseUrl}/import`, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          "x-api-token": token,
+          "x-kopynator-version": "1.2.0"
+        },
+        body: JSON.stringify({ lang, data: batches[i] })
+      });
+      if (!res.ok) {
+        const errText = await res.text();
+        spinner.fail(`Upload failed: ${res.status} ${errText}`);
+        return;
+      }
+      const result = await res.json();
+      imported += result.importedCount ?? batches[i].length;
+    }
+    spinner.succeed(import_chalk4.default.green(`Uploaded ${imported} keys for language "${lang}".`));
+    console.log(import_chalk4.default.bold.green("\n\u{1F389} Upload completed. Run `npx kopynator sync` to pull latest from cloud.\n"));
+  } catch (error) {
+    spinner.fail(`Upload failed: ${error instanceof Error ? error.message : "Unknown error"}`);
+  }
+}
+
 // src/index.ts
 var program = new import_commander.Command();
-program.name("kopynator").description("Kopynator CLI - Manage your i18n workflow").version("1.0.0");
+program.name("kopynator").description("Kopynator CLI - Manage your i18n workflow").version("1.3.0");
 program.command("init").description("Initialize Kopynator in your project").action(initCommand);
 program.command("check").description("Validate your local JSON translation files").action(checkCommand);
 program.command("sync").description("Sync your translations with the Kopynator Cloud").action(syncCommand);
+program.command("upload").description("Upload a JSON translation file to Kopynator Cloud").option("-f, --file <path>", "Path to the JSON file (e.g. es.json)").option("-l, --lang <code>", "Language code (default: inferred from filename)").action((opts) => uploadCommand({ file: opts.file, lang: opts.lang }));
 program.parse(process.argv);
 if (!process.argv.slice(2).length) {
-  console.log(import_chalk4.default.blue("\u{1F44B} Welcome to Kopynator CLI!"));
+  console.log(import_chalk5.default.blue("\u{1F44B} Welcome to Kopynator CLI!"));
   program.outputHelp();
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kopynator/cli",
-  "version": "1.1.0",
+  "version": "1.3.0",
   "description": "CLI tool for Kopynator - The i18n management solution",
   "bin": {
     "kopynator": "dist/index.js"
@@ -8,6 +8,7 @@
   "main": "./dist/index.js",
   "scripts": {
     "build": "tsup src/index.ts --format cjs --dts --clean",
+    "prepublishOnly": "npm run build",
     "dev": "tsup src/index.ts --format cjs --dts --watch",
     "release:patch": "npm version patch",
     "release:minor": "npm version minor",

package/src/commands/index.ts

@@ -1,3 +1,4 @@
 export * from './init';
 export * from './check';
 export * from './sync';
+export * from './upload';

package/src/commands/init.ts

@@ -6,12 +6,66 @@ import path from 'path';
 export async function initCommand() {
   console.log(chalk.bold.blue('\n🚀 Initializing Kopynator...\n'));
 
+  // Auto-detect framework from package.json
+  let detectedFramework: string | null = null;
+  let isReactNative = false;
+  let isIonic = false;
+  let ionicFramework: string | null = null;
+
+  const packageJsonPath = path.join(process.cwd(), 'package.json');
+  if (fs.existsSync(packageJsonPath)) {
+    try {
+      const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf-8'));
+      const deps = { ...packageJson.dependencies, ...packageJson.devDependencies };
+
+      // Check for React Native
+      if (deps['react-native']) {
+        isReactNative = true;
+        detectedFramework = 'React Native';
+        console.log(chalk.cyan('📱 Detected React Native project!'));
+      }
+      // Check for Ionic/Capacitor
+      else if (deps['@ionic/angular'] || deps['@ionic/react'] || deps['@ionic/vue'] || deps['@capacitor/core']) {
+        isIonic = true;
+        if (deps['@ionic/angular'] || deps['@angular/core']) {
+          ionicFramework = 'Angular';
+          detectedFramework = 'Ionic (Angular)';
+        } else if (deps['@ionic/react'] || deps['react']) {
+          ionicFramework = 'React';
+          detectedFramework = 'Ionic (React)';
+        } else if (deps['@ionic/vue'] || deps['vue']) {
+          ionicFramework = 'Vue';
+          detectedFramework = 'Ionic (Vue)';
+        }
+        console.log(chalk.magenta(`🔌 Detected ${detectedFramework} project!`));
+      }
+      // Check for standard frameworks
+      else if (deps['@angular/core']) {
+        detectedFramework = 'Angular';
+        console.log(chalk.red('🅰️  Detected Angular project!'));
+      } else if (deps['react'] && !deps['react-native']) {
+        detectedFramework = 'React';
+        console.log(chalk.blue('⚛️  Detected React project!'));
+      } else if (deps['vue']) {
+        detectedFramework = 'Vue';
+        console.log(chalk.green('🟢 Detected Vue project!'));
+      }
+    } catch (error) {
+      console.log(chalk.yellow('⚠️  Could not read package.json'));
+    }
+  }
+
   const answers = await inquirer.prompt([
     {
       type: 'list',
       name: 'framework',
-      message: 'What framework are you using?',
-      choices: ['Angular', 'React', 'Vue', 'Other']
+      message: detectedFramework 
+        ? `Detected ${detectedFramework}. Is this correct?`
+        : 'What framework are you using?',
+      choices: detectedFramework 
+        ? [detectedFramework, 'Other']
+        : ['Angular', 'React', 'Vue', 'React Native', 'Ionic', 'Other'],
+      default: detectedFramework || 'React'
     },
     {
       type: 'input',
@@ -133,6 +187,75 @@ export async function initCommand() {
     }
   }
 
+  // React Native specific instructions
+  if (isReactNative || answers.framework === 'React Native') {
+    console.log(chalk.green('\n✅ React Native Setup'));
+    console.log(chalk.cyan('\nInstall the package:'));
+    console.log(chalk.white('  npm install @kopynator/react'));
+    console.log(chalk.cyan('\nWrap your App.tsx:'));
+    console.log(chalk.gray(`
+  import { KopyProvider } from '@kopynator/react';
+  
+  export default function App() {
+    return (
+      <KopyProvider config={{ apiKey: 'YOUR_API_KEY', languages: ${JSON.stringify(answers.languages)} }}>
+        <YourApp />
+      </KopyProvider>
+    );
+  }`));
+    console.log(chalk.yellow('\n📌 Get your API Key from: https://www.kopynator.com'));
+    return;
+  }
+
+  // Ionic/Capacitor specific instructions
+  if (isIonic) {
+    console.log(chalk.green(`\n✅ Ionic (${ionicFramework}) Setup`));
+    console.log(chalk.magenta('\nℹ️  Ionic/Capacitor apps use the standard web framework packages.'));
+    
+    if (ionicFramework === 'Angular') {
+      console.log(chalk.cyan('\nInstall the package:'));
+      console.log(chalk.white('  npm install @kopynator/angular'));
+      console.log(chalk.cyan('\nAdd to your app.config.ts or app.module.ts:'));
+      console.log(chalk.gray(`
+  import { provideKopynator } from '@kopynator/angular';
+  
+  providers: [
+    provideKopynator({
+      apiKey: 'YOUR_API_KEY',
+      mode: 'hybrid',
+      languages: ${JSON.stringify(answers.languages)}
+    })
+  ]`));
+    } else if (ionicFramework === 'React') {
+      console.log(chalk.cyan('\nInstall the package:'));
+      console.log(chalk.white('  npm install @kopynator/react'));
+      console.log(chalk.cyan('\nWrap your App:'));
+      console.log(chalk.gray(`
+  import { KopyProvider } from '@kopynator/react';
+  
+  <KopyProvider config={{ apiKey: 'YOUR_API_KEY', languages: ${JSON.stringify(answers.languages)} }}>
+    <IonApp>...</IonApp>
+  </KopyProvider>`));
+    } else if (ionicFramework === 'Vue') {
+      console.log(chalk.cyan('\nInstall the package:'));
+      console.log(chalk.white('  npm install @kopynator/vue'));
+      console.log(chalk.cyan('\nAdd to your main.ts:'));
+      console.log(chalk.gray(`
+  import { createKopy } from '@kopynator/vue';
+  
+  const kopy = createKopy({
+    apiKey: 'YOUR_API_KEY',
+    defaultLocale: '${answers.defaultLocale}'
+  });
+  
+  app.use(kopy);`));
+    }
+    console.log(chalk.yellow('\n📌 Get your API Key from: https://www.kopynator.com'));
+    console.log(chalk.green('\n💡 Pro Tip: Your translations will work seamlessly across iOS, Android, and web!'));
+    return;
+  }
+
+
   // Fallback: Creates a basic config file
   const configContent = {
     apiKey: "YOUR_API_KEY_HERE",

package/src/commands/upload.ts

@@ -0,0 +1,145 @@
+import chalk from 'chalk';
+import fs from 'fs';
+import path from 'path';
+import ora from 'ora';
+
+const BATCH_SIZE = 500;
+
+interface KopyConfig {
+  apiKey: string;
+  baseUrl?: string;
+}
+
+/**
+ * Flatten nested JSON to dot-notation keys (same as backend/frontend).
+ */
+function flatten(data: Record<string, unknown>, prefix = ''): Record<string, string> {
+  const result: Record<string, string> = {};
+  for (const key in data) {
+    const fullKey = prefix ? `${prefix}.${key}` : key;
+    const value = data[key];
+    if (value !== null && typeof value === 'object' && !Array.isArray(value)) {
+      Object.assign(result, flatten(value as Record<string, unknown>, fullKey));
+    } else {
+      result[fullKey] = String(value);
+    }
+  }
+  return result;
+}
+
+function extractApiKey(): KopyConfig | null {
+  const appConfigPath = path.join(process.cwd(), 'src/app/app.config.ts');
+  const appModulePath = path.join(process.cwd(), 'src/app/app.module.ts');
+  const jsonConfigPath = path.join(process.cwd(), 'kopynator.config.json');
+
+  if (fs.existsSync(appConfigPath)) {
+    const content = fs.readFileSync(appConfigPath, 'utf-8');
+    const apiKeyMatch = content.match(/apiKey:\s*['"]([^'"]+)['"]/);
+    if (apiKeyMatch) return { apiKey: apiKeyMatch[1] };
+  }
+  if (fs.existsSync(appModulePath)) {
+    const content = fs.readFileSync(appModulePath, 'utf-8');
+    const apiKeyMatch = content.match(/apiKey:\s*['"]([^'"]+)['"]/);
+    if (apiKeyMatch) return { apiKey: apiKeyMatch[1] };
+  }
+  if (fs.existsSync(jsonConfigPath)) {
+    try {
+      const config = JSON.parse(fs.readFileSync(jsonConfigPath, 'utf-8'));
+      if (config.apiKey) return { apiKey: config.apiKey, baseUrl: config.baseUrl };
+    } catch {
+      // ignore
+    }
+  }
+  return null;
+}
+
+/**
+ * Infer language code from filename (e.g. es.json -> es, en-US.json -> en-US).
+ */
+function inferLangFromFile(filePath: string): string {
+  const base = path.basename(filePath, path.extname(filePath));
+  return base;
+}
+
+export async function uploadCommand(options: { file?: string; lang?: string }) {
+  console.log(chalk.bold.blue('\n📤 Upload translations to Kopynator Cloud...\n'));
+
+  const config = extractApiKey();
+  if (!config) {
+    console.log(chalk.red('❌ Could not find API key. Run `npx kopynator init` or set apiKey in kopynator.config.json / app.config.ts'));
+    return;
+  }
+
+  const fileOption = options.file;
+  if (!fileOption) {
+    console.log(chalk.red('❌ Missing --file. Example: npx kopynator upload --file=es.json [--lang=es]'));
+    return;
+  }
+
+  const resolvedPath = path.isAbsolute(fileOption) ? fileOption : path.join(process.cwd(), fileOption);
+  if (!fs.existsSync(resolvedPath)) {
+    console.log(chalk.red(`❌ File not found: ${resolvedPath}`));
+    return;
+  }
+
+  const lang = options.lang || inferLangFromFile(resolvedPath);
+  const baseUrl = config.baseUrl || 'https://api.kopynator.com/api/tokens';
+  const token = config.apiKey;
+
+  let raw: unknown;
+  try {
+    raw = JSON.parse(fs.readFileSync(resolvedPath, 'utf-8'));
+  } catch (e) {
+    console.log(chalk.red(`❌ Invalid JSON: ${resolvedPath}`));
+    return;
+  }
+
+  if (typeof raw !== 'object' || raw === null || Array.isArray(raw)) {
+    console.log(chalk.red('❌ JSON root must be an object (key-value).'));
+    return;
+  }
+
+  const flat = flatten(raw as Record<string, unknown>);
+  const entries = Object.entries(flat);
+  const total = entries.length;
+  if (total === 0) {
+    console.log(chalk.yellow('⚠️  No keys to upload.'));
+    return;
+  }
+
+  const batches: Record<string, string>[] = [];
+  for (let i = 0; i < total; i += BATCH_SIZE) {
+    batches.push(Object.fromEntries(entries.slice(i, i + BATCH_SIZE)));
+  }
+
+  const spinner = ora(`Uploading ${total} keys (${lang})...`).start();
+
+  try {
+    let imported = 0;
+    for (let i = 0; i < batches.length; i++) {
+      spinner.text = `Uploading batch ${i + 1}/${batches.length}...`;
+      const res = await fetch(`${baseUrl}/import`, {
+        method: 'POST',
+        headers: {
+          'Content-Type': 'application/json',
+          'x-api-token': token,
+          'x-kopynator-version': '1.2.0',
+        },
+        body: JSON.stringify({ lang, data: batches[i] }),
+      });
+
+      if (!res.ok) {
+        const errText = await res.text();
+        spinner.fail(`Upload failed: ${res.status} ${errText}`);
+        return;
+      }
+      const result = (await res.json()) as { importedCount?: number };
+      imported += result.importedCount ?? batches[i].length;
+    }
+
+    spinner.succeed(chalk.green(`Uploaded ${imported} keys for language "${lang}".`));
+    console.log(chalk.bold.green('\n🎉 Upload completed. Run `npx kopynator sync` to pull latest from cloud.\n'));
+  } catch (error) {
+    spinner.fail(`Upload failed: ${error instanceof Error ? error.message : 'Unknown error'}`);
+  }
+}

package/src/index.ts

@@ -1,14 +1,14 @@
 #!/usr/bin/env node
 import { Command } from 'commander';
 import chalk from 'chalk';
-import { initCommand, checkCommand, syncCommand } from './commands';
+import { initCommand, checkCommand, syncCommand, uploadCommand } from './commands';
 
 const program = new Command();
 
 program
   .name('kopynator')
   .description('Kopynator CLI - Manage your i18n workflow')
-  .version('1.1.0');
+  .version('1.3.0');
 
 program
   .command('init')
@@ -25,6 +25,13 @@ program
   .description('Sync your translations with the Kopynator Cloud')
   .action(syncCommand);
 
+program
+  .command('upload')
+  .description('Upload a JSON translation file to Kopynator Cloud')
+  .option('-f, --file <path>', 'Path to the JSON file (e.g. es.json)')
+  .option('-l, --lang <code>', 'Language code (default: inferred from filename)')
+  .action((opts) => uploadCommand({ file: opts.file, lang: opts.lang }));
+
 program.parse(process.argv);
 
 if (!process.argv.slice(2).length) {