@kopynator/cli 1.6.1 → 1.6.4

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_chalk6 = __toESM(require("chalk"));
+var import_chalk7 = __toESM(require("chalk"));
 
 // src/commands/init.ts
 var import_inquirer = __toESM(require("inquirer"));
@@ -272,6 +272,7 @@ async function initCommand() {
 var import_chalk2 = __toESM(require("chalk"));
 var import_fs4 = __toESM(require("fs"));
 var import_path4 = __toESM(require("path"));
+var readline = __toESM(require("readline"));
 
 // src/lib/project.ts
 var import_fs2 = __toESM(require("fs"));
@@ -455,6 +456,117 @@ function findGlobalDuplicates(values, usedKeys) {
 }
 
 // src/commands/check.ts
+function loadKopyConfig() {
+  const cwd = process.cwd();
+  for (const rel of ["kopynator.config.json", "src/kopynator.config.json"]) {
+    const p = import_path4.default.join(cwd, rel);
+    if (import_fs4.default.existsSync(p)) {
+      try {
+        const c = JSON.parse(import_fs4.default.readFileSync(p, "utf-8"));
+        const key = c.apiKey ?? c.api_key;
+        if (key) return { apiKey: key, baseUrl: c.baseUrl };
+      } catch {
+      }
+    }
+  }
+  for (const rel of ["src/app/app.config.ts", "src/app/app.module.ts"]) {
+    const p = import_path4.default.join(cwd, rel);
+    if (import_fs4.default.existsSync(p)) {
+      const m = import_fs4.default.readFileSync(p, "utf-8").match(/apiKey:\s*['"]([^'"]+)['"]/);
+      if (m) return { apiKey: m[1] };
+    }
+  }
+  const envKey = process.env.KOPYNATOR_API_KEY?.trim();
+  if (envKey) return { apiKey: envKey, baseUrl: process.env.KOPYNATOR_BASE_URL?.trim() || void 0 };
+  return null;
+}
+function ask(question) {
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+  return new Promise((resolve) => rl.question(question, (ans) => {
+    rl.close();
+    resolve(ans.trim());
+  }));
+}
+async function checkRemoteOrphans(localKeys) {
+  const config = loadKopyConfig();
+  if (!config) {
+    console.log(import_chalk2.default.gray("\n   (Skipping remote check \u2014 no API key found)\n"));
+    return;
+  }
+  const baseUrl = config.baseUrl || "https://api.kopynator.com/tokens";
+  const token = config.apiKey;
+  console.log(import_chalk2.default.bold.blue("\n\u2601\uFE0F  Checking for server-only keys...\n"));
+  let languages = [];
+  try {
+    const res = await fetch(`${baseUrl}/languages`, {
+      headers: { "x-api-token": token, "x-kopynator-version": "1.6.3" }
+    });
+    if (!res.ok) {
+      console.log(import_chalk2.default.yellow(`   Could not fetch languages from server (${res.status}). Skipping.
+`));
+      return;
+    }
+    languages = await res.json();
+  } catch {
+    console.log(import_chalk2.default.yellow("   Could not reach server. Skipping remote check.\n"));
+    return;
+  }
+  if (languages.length === 0) {
+    console.log(import_chalk2.default.gray("   No languages found on server.\n"));
+    return;
+  }
+  const remoteKeys = /* @__PURE__ */ new Set();
+  for (const lang of languages) {
+    try {
+      const res = await fetch(`${baseUrl}/fetch?langs=${lang}&nested=false&includeLangKey=false`, {
+        headers: { "x-api-token": token, "x-kopynator-version": "1.6.3" }
+      });
+      if (!res.ok) continue;
+      const data = await res.json();
+      Object.keys(data).forEach((k) => remoteKeys.add(k));
+    } catch {
+    }
+  }
+  const orphans = [...remoteKeys].filter((k) => !localKeys.has(k)).sort();
+  if (orphans.length === 0) {
+    console.log(import_chalk2.default.green("\u2705 No server-only keys found. Everything is in sync.\n"));
+    return;
+  }
+  console.log(import_chalk2.default.yellow(`\u26A0\uFE0F  ${orphans.length} key(s) exist on the server but are NOT in your local files:
+`));
+  orphans.forEach((k) => console.log(import_chalk2.default.yellow(`   - ${k}`)));
+  const answer = await ask(import_chalk2.default.bold("\nDelete these keys from the server? [y/N] "));
+  if (answer.toLowerCase() !== "y") {
+    console.log(import_chalk2.default.gray("\n   Skipped. Server keys were not deleted.\n"));
+    return;
+  }
+  try {
+    const res = await fetch(`${baseUrl}/keys`, {
+      method: "DELETE",
+      headers: {
+        "Content-Type": "application/json",
+        "x-api-token": token,
+        "x-kopynator-version": "1.6.3"
+      },
+      body: JSON.stringify({ keys: orphans })
+    });
+    if (!res.ok) {
+      const err = await res.text().catch(() => res.statusText);
+      console.log(import_chalk2.default.red(`
+\u274C Failed to delete keys: ${res.status} ${err}
+`));
+      return;
+    }
+    const result = await res.json().catch(() => ({}));
+    console.log(import_chalk2.default.green(`
+\u2705 Deleted ${result.deleted ?? orphans.length} key(s) from the server.
+`));
+  } catch (e) {
+    console.log(import_chalk2.default.red(`
+\u274C Network error: ${e.message}
+`));
+  }
+}
 async function checkCommand(opts = {}) {
   if (process.env.KOPYNATOR_I18N_SKIP === "1") {
     console.log(import_chalk2.default.yellow("\u26A0\uFE0F  KOPYNATOR_I18N_SKIP=1 \u2014 skipping i18n check."));
@@ -554,6 +666,7 @@ All missing keys (${missing.length}):`));
   }
   console.log(import_chalk2.default.bold.green(`
 \u2728 i18n check passed (${files.length} locale file(s); baseline=${baselineSet.size}; scanned ${sourceFiles.length} source file(s)).`));
+  await checkRemoteOrphans(definedKeys);
 }
 
 // src/commands/sync.ts
@@ -910,16 +1023,155 @@ async function uploadCommand(options) {
   }
 }
 
-// src/commands/limits.ts
+// src/commands/push.ts
 var import_chalk5 = __toESM(require("chalk"));
 var import_fs7 = __toESM(require("fs"));
 var import_path7 = __toESM(require("path"));
+var import_ora3 = __toESM(require("ora"));
+var BATCH_SIZE2 = 500;
+function flatten3(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, flatten3(value, fullKey));
+    } else {
+      result[fullKey] = String(value);
+    }
+  }
+  return result;
+}
+function loadJsonConfig3(jsonPath) {
+  if (!import_fs7.default.existsSync(jsonPath)) return null;
+  try {
+    const config = JSON.parse(import_fs7.default.readFileSync(jsonPath, "utf-8"));
+    const key = config.apiKey ?? config.api_key;
+    if (key && typeof key === "string") return { apiKey: key, baseUrl: config.baseUrl };
+  } catch {
+  }
+  return null;
+}
+function extractApiKey3() {
+  const cwd = process.cwd();
+  const configFromRoot = loadJsonConfig3(import_path7.default.join(cwd, "kopynator.config.json"));
+  if (configFromRoot) return configFromRoot;
+  const configFromSrc = loadJsonConfig3(import_path7.default.join(cwd, "src/kopynator.config.json"));
+  if (configFromSrc) return configFromSrc;
+  for (const rel of ["src/app/app.config.ts", "src/app/app.module.ts"]) {
+    const p = import_path7.default.join(cwd, rel);
+    if (import_fs7.default.existsSync(p)) {
+      const m = import_fs7.default.readFileSync(p, "utf-8").match(/apiKey:\s*['"]([^'"]+)['"]/);
+      if (m) return { apiKey: m[1] };
+    }
+  }
+  const envKey = process.env.KOPYNATOR_API_KEY?.trim();
+  if (envKey) return { apiKey: envKey, baseUrl: process.env.KOPYNATOR_BASE_URL?.trim() || void 0 };
+  return null;
+}
+function inferLang(filePath) {
+  return import_path7.default.basename(filePath, import_path7.default.extname(filePath));
+}
+async function pushFile(filePath, token, baseUrl) {
+  const lang = inferLang(filePath);
+  let raw;
+  try {
+    raw = JSON.parse(import_fs7.default.readFileSync(filePath, "utf-8"));
+  } catch {
+    return { lang, pushed: 0, skipped: 0, error: "Invalid JSON" };
+  }
+  if (typeof raw !== "object" || raw === null || Array.isArray(raw)) {
+    return { lang, pushed: 0, skipped: 0, error: "JSON root must be an object" };
+  }
+  const flat = flatten3(raw);
+  const entries = Object.entries(flat);
+  if (entries.length === 0) return { lang, pushed: 0, skipped: 0 };
+  const batches = [];
+  for (let i = 0; i < entries.length; i += BATCH_SIZE2) {
+    batches.push(Object.fromEntries(entries.slice(i, i + BATCH_SIZE2)));
+  }
+  let pushed = 0;
+  let skipped = 0;
+  for (const batch of batches) {
+    const res = await fetch(`${baseUrl}/import`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        "x-api-token": token,
+        "x-kopynator-version": "1.6.1",
+        // merge mode: server wins on conflict (existing keys are not overwritten)
+        "x-import-mode": "merge"
+      },
+      body: JSON.stringify({ lang, data: batch, mode: "merge" })
+    });
+    if (!res.ok) {
+      const err = await res.text().catch(() => res.statusText);
+      return { lang, pushed, skipped, error: `${res.status}: ${err}` };
+    }
+    const result = await res.json().catch(() => ({}));
+    pushed += result.imported ?? Object.keys(batch).length;
+    skipped += result.skipped ?? 0;
+  }
+  return { lang, pushed, skipped };
+}
+async function pushCommand() {
+  console.log(import_chalk5.default.bold.blue("\n\u2601\uFE0F  Pushing local translations to Kopynator Cloud (merge mode)...\n"));
+  console.log(import_chalk5.default.gray("   Keys that already exist on the server are NOT overwritten.\n"));
+  const config = extractApiKey3();
+  if (!config) {
+    console.log(import_chalk5.default.red("\u274C Could not find API key. Run `npx kopynator init` first."));
+    return;
+  }
+  const framework = detectFramework();
+  const assetsDir = getTranslationDir(framework);
+  if (!import_fs7.default.existsSync(assetsDir)) {
+    console.log(import_chalk5.default.red(`\u274C Translation directory not found: ${assetsDir}`));
+    return;
+  }
+  const files = import_fs7.default.readdirSync(assetsDir).filter((f) => f.endsWith(".json") && !f.startsWith(".")).map((f) => import_path7.default.join(assetsDir, f));
+  if (files.length === 0) {
+    console.log(import_chalk5.default.yellow("\u26A0\uFE0F  No JSON translation files found."));
+    return;
+  }
+  const baseUrl = config.baseUrl || "https://api.kopynator.com/tokens";
+  const token = config.apiKey;
+  console.log(import_chalk5.default.cyan(`\u{1F4C2} Found ${files.length} file(s) in ${assetsDir}
+`));
+  let totalPushed = 0;
+  let totalSkipped = 0;
+  let totalErrors = 0;
+  for (const filePath of files) {
+    const spinner = (0, import_ora3.default)(`Pushing ${import_path7.default.basename(filePath)}...`).start();
+    const result = await pushFile(filePath, token, baseUrl);
+    if (result.error) {
+      spinner.fail(`${import_chalk5.default.bold(result.lang)}: ${import_chalk5.default.red(result.error)}`);
+      totalErrors++;
+    } else {
+      spinner.succeed(
+        `${import_chalk5.default.bold(result.lang)}: ${import_chalk5.default.green(`${result.pushed} pushed`)}` + (result.skipped ? import_chalk5.default.gray(`, ${result.skipped} skipped (already on server)`) : "")
+      );
+      totalPushed += result.pushed;
+      totalSkipped += result.skipped;
+    }
+  }
+  console.log("");
+  if (totalErrors === 0) {
+    console.log(import_chalk5.default.green(`\u2705 Push complete \u2014 ${totalPushed} keys pushed, ${totalSkipped} already existed on server.`));
+  } else {
+    console.log(import_chalk5.default.yellow(`\u26A0\uFE0F  Push finished with ${totalErrors} error(s). ${totalPushed} keys pushed.`));
+  }
+}
+
+// src/commands/limits.ts
+var import_chalk6 = __toESM(require("chalk"));
+var import_fs8 = __toESM(require("fs"));
+var import_path8 = __toESM(require("path"));
 function resolveApiKey() {
   const cwd = process.cwd();
   const fromJson = (p) => {
     try {
-      if (import_fs7.default.existsSync(p)) {
-        const cfg = JSON.parse(import_fs7.default.readFileSync(p, "utf-8"));
+      if (import_fs8.default.existsSync(p)) {
+        const cfg = JSON.parse(import_fs8.default.readFileSync(p, "utf-8"));
         if (cfg && cfg.apiKey) return { apiKey: cfg.apiKey, baseUrl: cfg.baseUrl };
       }
     } catch {
@@ -928,8 +1180,8 @@ function resolveApiKey() {
   };
   const fromAppFile = (p) => {
     try {
-      if (import_fs7.default.existsSync(p)) {
-        const content = import_fs7.default.readFileSync(p, "utf-8");
+      if (import_fs8.default.existsSync(p)) {
+        const content = import_fs8.default.readFileSync(p, "utf-8");
         const match = content.match(/apiKey:\s*['"]([^'"]+)['"]/);
         if (match) return { apiKey: match[1] };
       }
@@ -937,7 +1189,7 @@ function resolveApiKey() {
     }
     return null;
   };
-  return fromJson(import_path7.default.join(cwd, "kopynator.config.json")) || fromJson(import_path7.default.join(cwd, "src/kopynator.config.json")) || fromAppFile(import_path7.default.join(cwd, "src/app/app.config.ts")) || fromAppFile(import_path7.default.join(cwd, "src/app/app.module.ts")) || (process.env.KOPYNATOR_API_KEY ? { apiKey: process.env.KOPYNATOR_API_KEY.trim(), baseUrl: process.env.KOPYNATOR_BASE_URL?.trim() } : null);
+  return fromJson(import_path8.default.join(cwd, "kopynator.config.json")) || fromJson(import_path8.default.join(cwd, "src/kopynator.config.json")) || fromAppFile(import_path8.default.join(cwd, "src/app/app.config.ts")) || fromAppFile(import_path8.default.join(cwd, "src/app/app.module.ts")) || (process.env.KOPYNATOR_API_KEY ? { apiKey: process.env.KOPYNATOR_API_KEY.trim(), baseUrl: process.env.KOPYNATOR_BASE_URL?.trim() } : null);
 }
 function formatLimit(value) {
   return value === -1 ? "Unlimited" : String(value);
@@ -945,8 +1197,8 @@ function formatLimit(value) {
 async function limitsCommand() {
   const resolved = resolveApiKey();
   if (!resolved) {
-    console.log(import_chalk5.default.red("\n\u2716 No API key found."));
-    console.log(import_chalk5.default.gray("  Add it to kopynator.config.json or set KOPYNATOR_API_KEY.\n"));
+    console.log(import_chalk6.default.red("\n\u2716 No API key found."));
+    console.log(import_chalk6.default.gray("  Add it to kopynator.config.json or set KOPYNATOR_API_KEY.\n"));
     process.exit(1);
     return;
   }
@@ -956,7 +1208,7 @@ async function limitsCommand() {
     const res = await fetch(url, { headers: { "x-kopynator-version": "1.6.1" } });
     if (!res.ok) {
       const body = await res.text().catch(() => "");
-      console.log(import_chalk5.default.red(`
+      console.log(import_chalk6.default.red(`
 \u2716 Could not fetch limits (HTTP ${res.status}). ${body}
 `));
       process.exit(1);
@@ -969,12 +1221,12 @@ async function limitsCommand() {
       const usedPart = used === void 0 ? "" : `${used} / `;
       const text = `  ${label.padEnd(9)} ${usedPart}${formatLimit(limit)}`;
       const reached = limit !== -1 && used !== void 0 && used >= limit;
-      return reached ? import_chalk5.default.red(`${text}  (limit reached \u2014 upgrade your plan)`) : import_chalk5.default.green(text);
+      return reached ? import_chalk6.default.red(`${text}  (limit reached \u2014 upgrade your plan)`) : import_chalk6.default.green(text);
     };
     console.log("");
-    console.log(import_chalk5.default.bold("\u{1F4CA} Kopynator \u2014 plan limits (per organization)"));
-    const planLabel = import_chalk5.default.cyan((data.plan || "free").toUpperCase());
-    const statusLabel = data.active ? import_chalk5.default.green("active") : import_chalk5.default.yellow("inactive/expired \u2192 free limits apply");
+    console.log(import_chalk6.default.bold("\u{1F4CA} Kopynator \u2014 plan limits (per organization)"));
+    const planLabel = import_chalk6.default.cyan((data.plan || "free").toUpperCase());
+    const statusLabel = data.active ? import_chalk6.default.green("active") : import_chalk6.default.yellow("inactive/expired \u2192 free limits apply");
     console.log(`  Plan: ${planLabel}  (${statusLabel})`);
     console.log("");
     console.log(row("Projects", usage.projects, limits.projects));
@@ -982,7 +1234,7 @@ async function limitsCommand() {
     console.log(row("Members", void 0, limits.members));
     console.log("");
   } catch (error) {
-    console.log(import_chalk5.default.red(`
+    console.log(import_chalk6.default.red(`
 \u2716 Request failed: ${error?.message || error}
 `));
     process.exit(1);
@@ -991,14 +1243,15 @@ async function limitsCommand() {
 
 // src/index.ts
 var program = new import_commander.Command();
-program.name("kopynator").description("Kopynator CLI - Manage your i18n workflow").version("1.6.1", "-v, --version").helpOption("-h, --help", "Display help for command").addHelpText("beforeAll", import_chalk6.default.blue("\n\u{1F44B} Welcome to Kopynator CLI!\n"));
+program.name("kopynator").description("Kopynator CLI - Manage your i18n workflow").version("1.6.1", "-v, --version").helpOption("-h, --help", "Display help for command").addHelpText("beforeAll", import_chalk7.default.blue("\n\u{1F44B} Welcome to Kopynator CLI!\n"));
 program.command("init").description("Initialize Kopynator in your project").action(initCommand);
 program.command("check").description("Validate translation files: JSON syntax, broken references and duplicate global keys").option("--base-ref <ref>", "Git ref to diff against when detecting new duplicate keys", "master").option("--update-baseline", "Accept all currently-missing keys as backlog (writes kopynator.i18n-baseline.json)").option("--all", "List every missing key, including ones already accepted in the baseline").action((opts) => checkCommand({ baseRef: opts.baseRef, updateBaseline: opts.updateBaseline, all: opts.all }));
 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.command("push").description("Push all local JSON translation files to the cloud (merge mode \u2014 existing server keys are NOT overwritten)").action(pushCommand);
 program.command("limits").description("Show your plan limits and current usage (projects, keys, members)").action(limitsCommand);
 program.command("help").description("Show help for all commands").action(() => {
-  console.log(import_chalk6.default.blue("\u{1F44B} Kopynator CLI - Comandos disponibles:\n"));
+  console.log(import_chalk7.default.blue("\u{1F44B} Kopynator CLI - Comandos disponibles:\n"));
   program.outputHelp();
 });
 program.parse(process.argv);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kopynator/cli",
-  "version": "1.6.1",
+  "version": "1.6.4",
   "description": "CLI tool for Kopynator - The i18n management solution",
   "bin": {
     "kopynator": "dist/index.js"

package/src/commands/check.ts

@@ -1,6 +1,7 @@
 import chalk from 'chalk';
 import fs from 'fs';
 import path from 'path';
+import * as readline from 'readline';
 import { detectFramework, getSourceRoot, getTranslationDir } from '../lib/project';
 import {
   findGlobalDuplicates,
@@ -14,6 +15,121 @@ import {
   walkSourceFiles,
 } from '../lib/i18n-guardian';
 
+interface KopyConfig { apiKey: string; baseUrl?: string; }
+
+function loadKopyConfig(): KopyConfig | null {
+  const cwd = process.cwd();
+  for (const rel of ['kopynator.config.json', 'src/kopynator.config.json']) {
+    const p = path.join(cwd, rel);
+    if (fs.existsSync(p)) {
+      try {
+        const c = JSON.parse(fs.readFileSync(p, 'utf-8'));
+        const key = c.apiKey ?? c.api_key;
+        if (key) return { apiKey: key, baseUrl: c.baseUrl };
+      } catch { /* ignore */ }
+    }
+  }
+  for (const rel of ['src/app/app.config.ts', 'src/app/app.module.ts']) {
+    const p = path.join(cwd, rel);
+    if (fs.existsSync(p)) {
+      const m = fs.readFileSync(p, 'utf-8').match(/apiKey:\s*['"]([^'"]+)['"]/);
+      if (m) return { apiKey: m[1] };
+    }
+  }
+  const envKey = process.env.KOPYNATOR_API_KEY?.trim();
+  if (envKey) return { apiKey: envKey, baseUrl: process.env.KOPYNATOR_BASE_URL?.trim() || undefined };
+  return null;
+}
+
+function ask(question: string): Promise<string> {
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+  return new Promise(resolve => rl.question(question, ans => { rl.close(); resolve(ans.trim()); }));
+}
+
+async function checkRemoteOrphans(localKeys: Set<string>): Promise<void> {
+  const config = loadKopyConfig();
+  if (!config) {
+    console.log(chalk.gray('\n   (Skipping remote check — no API key found)\n'));
+    return;
+  }
+
+  const baseUrl = config.baseUrl || 'https://api.kopynator.com/tokens';
+  const token = config.apiKey;
+
+  console.log(chalk.bold.blue('\n☁️  Checking for server-only keys...\n'));
+
+  // Fetch all languages
+  let languages: string[] = [];
+  try {
+    const res = await fetch(`${baseUrl}/languages`, {
+      headers: { 'x-api-token': token, 'x-kopynator-version': '1.6.3' },
+    });
+    if (!res.ok) {
+      console.log(chalk.yellow(`   Could not fetch languages from server (${res.status}). Skipping.\n`));
+      return;
+    }
+    languages = await res.json() as string[];
+  } catch {
+    console.log(chalk.yellow('   Could not reach server. Skipping remote check.\n'));
+    return;
+  }
+
+  if (languages.length === 0) {
+    console.log(chalk.gray('   No languages found on server.\n'));
+    return;
+  }
+
+  // Collect all keys present on the server (union across all langs)
+  const remoteKeys = new Set<string>();
+  for (const lang of languages) {
+    try {
+      const res = await fetch(`${baseUrl}/fetch?langs=${lang}&nested=false&includeLangKey=false`, {
+        headers: { 'x-api-token': token, 'x-kopynator-version': '1.6.3' },
+      });
+      if (!res.ok) continue;
+      const data = await res.json() as Record<string, unknown>;
+      Object.keys(data).forEach(k => remoteKeys.add(k));
+    } catch { /* skip lang on error */ }
+  }
+
+  const orphans = [...remoteKeys].filter(k => !localKeys.has(k)).sort();
+
+  if (orphans.length === 0) {
+    console.log(chalk.green('✅ No server-only keys found. Everything is in sync.\n'));
+    return;
+  }
+
+  console.log(chalk.yellow(`⚠️  ${orphans.length} key(s) exist on the server but are NOT in your local files:\n`));
+  orphans.forEach(k => console.log(chalk.yellow(`   - ${k}`)));
+
+  const answer = await ask(chalk.bold('\nDelete these keys from the server? [y/N] '));
+  if (answer.toLowerCase() !== 'y') {
+    console.log(chalk.gray('\n   Skipped. Server keys were not deleted.\n'));
+    return;
+  }
+
+  try {
+    const res = await fetch(`${baseUrl}/keys`, {
+      method: 'DELETE',
+      headers: {
+        'Content-Type': 'application/json',
+        'x-api-token': token,
+        'x-kopynator-version': '1.6.3',
+      },
+      body: JSON.stringify({ keys: orphans }),
+    });
+    if (!res.ok) {
+      const err = await res.text().catch(() => res.statusText);
+      console.log(chalk.red(`\n❌ Failed to delete keys: ${res.status} ${err}\n`));
+      return;
+    }
+    const result = await res.json().catch(() => ({})) as { deleted?: number };
+    console.log(chalk.green(`\n✅ Deleted ${result.deleted ?? orphans.length} key(s) from the server.\n`));
+  } catch (e: any) {
+    console.log(chalk.red(`\n❌ Network error: ${e.message}\n`));
+  }
+}
+
 export interface CheckOptions {
   baseRef?: string;
   updateBaseline?: boolean;
@@ -148,4 +264,6 @@ export async function checkCommand(opts: CheckOptions = {}) {
   }
 
   console.log(chalk.bold.green(`\n✨ i18n check passed (${files.length} locale file(s); baseline=${baselineSet.size}; scanned ${sourceFiles.length} source file(s)).`));
+
+  await checkRemoteOrphans(definedKeys);
 }

package/src/commands/index.ts

@@ -2,4 +2,5 @@ export * from './init';
 export * from './check';
 export * from './sync';
 export * from './upload';
+export * from './push';
 export * from './limits';

package/src/commands/push.ts

@@ -0,0 +1,178 @@
+import chalk from 'chalk';
+import fs from 'fs';
+import path from 'path';
+import ora from 'ora';
+import { detectFramework, getTranslationDir } from '../lib/project';
+
+const BATCH_SIZE = 500;
+
+interface KopyConfig {
+  apiKey: string;
+  baseUrl?: string;
+}
+
+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 loadJsonConfig(jsonPath: string): KopyConfig | null {
+  if (!fs.existsSync(jsonPath)) return null;
+  try {
+    const config = JSON.parse(fs.readFileSync(jsonPath, 'utf-8'));
+    const key = config.apiKey ?? config.api_key;
+    if (key && typeof key === 'string') return { apiKey: key, baseUrl: config.baseUrl };
+  } catch {
+    // ignore
+  }
+  return null;
+}
+
+function extractApiKey(): KopyConfig | null {
+  const cwd = process.cwd();
+  const configFromRoot = loadJsonConfig(path.join(cwd, 'kopynator.config.json'));
+  if (configFromRoot) return configFromRoot;
+  const configFromSrc = loadJsonConfig(path.join(cwd, 'src/kopynator.config.json'));
+  if (configFromSrc) return configFromSrc;
+
+  for (const rel of ['src/app/app.config.ts', 'src/app/app.module.ts']) {
+    const p = path.join(cwd, rel);
+    if (fs.existsSync(p)) {
+      const m = fs.readFileSync(p, 'utf-8').match(/apiKey:\s*['"]([^'"]+)['"]/);
+      if (m) return { apiKey: m[1] };
+    }
+  }
+
+  const envKey = process.env.KOPYNATOR_API_KEY?.trim();
+  if (envKey) return { apiKey: envKey, baseUrl: process.env.KOPYNATOR_BASE_URL?.trim() || undefined };
+  return null;
+}
+
+function inferLang(filePath: string): string {
+  return path.basename(filePath, path.extname(filePath));
+}
+
+async function pushFile(
+  filePath: string,
+  token: string,
+  baseUrl: string,
+): Promise<{ lang: string; pushed: number; skipped: number; error?: string }> {
+  const lang = inferLang(filePath);
+  let raw: unknown;
+  try {
+    raw = JSON.parse(fs.readFileSync(filePath, 'utf-8'));
+  } catch {
+    return { lang, pushed: 0, skipped: 0, error: 'Invalid JSON' };
+  }
+
+  if (typeof raw !== 'object' || raw === null || Array.isArray(raw)) {
+    return { lang, pushed: 0, skipped: 0, error: 'JSON root must be an object' };
+  }
+
+  const flat = flatten(raw as Record<string, unknown>);
+  const entries = Object.entries(flat);
+  if (entries.length === 0) return { lang, pushed: 0, skipped: 0 };
+
+  const batches: Record<string, string>[] = [];
+  for (let i = 0; i < entries.length; i += BATCH_SIZE) {
+    batches.push(Object.fromEntries(entries.slice(i, i + BATCH_SIZE)));
+  }
+
+  let pushed = 0;
+  let skipped = 0;
+
+  for (const batch of batches) {
+    const res = await fetch(`${baseUrl}/import`, {
+      method: 'POST',
+      headers: {
+        'Content-Type': 'application/json',
+        'x-api-token': token,
+        'x-kopynator-version': '1.6.1',
+        // merge mode: server wins on conflict (existing keys are not overwritten)
+        'x-import-mode': 'merge',
+      },
+      body: JSON.stringify({ lang, data: batch, mode: 'merge' }),
+    });
+
+    if (!res.ok) {
+      const err = await res.text().catch(() => res.statusText);
+      return { lang, pushed, skipped, error: `${res.status}: ${err}` };
+    }
+
+    const result = await res.json().catch(() => ({})) as any;
+    pushed += result.imported ?? Object.keys(batch).length;
+    skipped += result.skipped ?? 0;
+  }
+
+  return { lang, pushed, skipped };
+}
+
+export async function pushCommand() {
+  console.log(chalk.bold.blue('\n☁️  Pushing local translations to Kopynator Cloud (merge mode)...\n'));
+  console.log(chalk.gray('   Keys that already exist on the server are NOT overwritten.\n'));
+
+  const config = extractApiKey();
+  if (!config) {
+    console.log(chalk.red('❌ Could not find API key. Run `npx kopynator init` first.'));
+    return;
+  }
+
+  const framework = detectFramework();
+  const assetsDir = getTranslationDir(framework);
+
+  if (!fs.existsSync(assetsDir)) {
+    console.log(chalk.red(`❌ Translation directory not found: ${assetsDir}`));
+    return;
+  }
+
+  const files = fs.readdirSync(assetsDir)
+    .filter(f => f.endsWith('.json') && !f.startsWith('.'))
+    .map(f => path.join(assetsDir, f));
+
+  if (files.length === 0) {
+    console.log(chalk.yellow('⚠️  No JSON translation files found.'));
+    return;
+  }
+
+  const baseUrl = config.baseUrl || 'https://api.kopynator.com/tokens';
+  const token = config.apiKey;
+
+  console.log(chalk.cyan(`📂 Found ${files.length} file(s) in ${assetsDir}\n`));
+
+  let totalPushed = 0;
+  let totalSkipped = 0;
+  let totalErrors = 0;
+
+  for (const filePath of files) {
+    const spinner = ora(`Pushing ${path.basename(filePath)}...`).start();
+    const result = await pushFile(filePath, token, baseUrl);
+
+    if (result.error) {
+      spinner.fail(`${chalk.bold(result.lang)}: ${chalk.red(result.error)}`);
+      totalErrors++;
+    } else {
+      spinner.succeed(
+        `${chalk.bold(result.lang)}: ${chalk.green(`${result.pushed} pushed`)}` +
+        (result.skipped ? chalk.gray(`, ${result.skipped} skipped (already on server)`) : ''),
+      );
+      totalPushed += result.pushed;
+      totalSkipped += result.skipped;
+    }
+  }
+
+  console.log('');
+  if (totalErrors === 0) {
+    console.log(chalk.green(`✅ Push complete — ${totalPushed} keys pushed, ${totalSkipped} already existed on server.`));
+  } else {
+    console.log(chalk.yellow(`⚠️  Push finished with ${totalErrors} error(s). ${totalPushed} keys pushed.`));
+  }
+}

package/src/index.ts

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import { Command } from 'commander';
 import chalk from 'chalk';
-import { initCommand, checkCommand, syncCommand, uploadCommand, limitsCommand } from './commands';
+import { initCommand, checkCommand, syncCommand, uploadCommand, pushCommand, limitsCommand } from './commands';
 
 const program = new Command();
 
@@ -37,6 +37,11 @@ program
   .option('-l, --lang <code>', 'Language code (default: inferred from filename)')
   .action((opts) => uploadCommand({ file: opts.file, lang: opts.lang }));
 
+program
+  .command('push')
+  .description('Push all local JSON translation files to the cloud (merge mode — existing server keys are NOT overwritten)')
+  .action(pushCommand);
+
 program
   .command('limits')
   .description('Show your plan limits and current usage (projects, keys, members)')