@kopynator/cli 1.5.0 → 1.6.0

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_chalk5 = __toESM(require("chalk"));
+var import_chalk6 = __toESM(require("chalk"));
 
 // src/commands/init.ts
 var import_inquirer = __toESM(require("inquirer"));
@@ -270,81 +270,302 @@ async function initCommand() {
 
 // src/commands/check.ts
 var import_chalk2 = __toESM(require("chalk"));
+var import_fs4 = __toESM(require("fs"));
+var import_path4 = __toESM(require("path"));
+
+// src/lib/project.ts
 var import_fs2 = __toESM(require("fs"));
 var import_path2 = __toESM(require("path"));
-async function checkCommand() {
+function detectFramework() {
+  const angularJson = import_path2.default.join(process.cwd(), "angular.json");
+  const packageJson = import_path2.default.join(process.cwd(), "package.json");
+  if (import_fs2.default.existsSync(angularJson)) {
+    return "Angular";
+  }
+  if (import_fs2.default.existsSync(packageJson)) {
+    try {
+      const pkg = JSON.parse(import_fs2.default.readFileSync(packageJson, "utf-8"));
+      const deps = { ...pkg.dependencies, ...pkg.devDependencies };
+      if (deps["@angular/core"]) return "Angular";
+      if (deps["react"]) return "React";
+      if (deps["vue"]) return "Vue";
+    } catch (e) {
+    }
+  }
+  return "Other";
+}
+function getTranslationDir(framework) {
+  switch (framework) {
+    case "Angular":
+      return import_path2.default.join(process.cwd(), "src/assets/i18n");
+    case "React":
+    case "Vue":
+      return import_path2.default.join(process.cwd(), "public/locales");
+    default:
+      return import_path2.default.join(process.cwd(), "locales");
+  }
+}
+function getSourceRoot(framework) {
+  switch (framework) {
+    case "Angular":
+    case "React":
+    case "Vue":
+      return import_path2.default.join(process.cwd(), "src");
+    default:
+      return process.cwd();
+  }
+}
+
+// src/lib/i18n-guardian.ts
+var import_fs3 = __toESM(require("fs"));
+var import_path3 = __toESM(require("path"));
+var import_child_process = require("child_process");
+var SAFELIST_FILE = "kopynator.i18n-safelist.json";
+var BASELINE_FILE = "kopynator.i18n-baseline.json";
+var SOURCE_EXTENSIONS = [".ts", ".tsx", ".js", ".jsx", ".html", ".vue"];
+var EXCLUDED_DIRS = /* @__PURE__ */ new Set(["node_modules", "dist", "build", ".git", ".angular", "coverage", ".next", ".nuxt", "out"]);
+var KEY = `[\\w.:-]+`;
+var USE_PATTERNS = [
+  // {{ 'key' | kopy }} — Angular pipe
+  { re: new RegExp(`(['"\`])(${KEY})\\1\\s*\\|\\s*kopy`, "g"), group: 2 },
+  // [kopy]="'key'" — Angular directive with a string literal binding
+  { re: new RegExp(`\\[kopy\\]\\s*=\\s*"'(${KEY})'"`, "g"), group: 1 },
+  // .translate('key') / .t('key') — @kopynator/core & @kopynator/react API
+  { re: new RegExp(`\\.(?:translate|t)\\(\\s*(['"\`])(${KEY})\\1`, "g"), group: 2 }
+];
+var MAGIC_RE = /kopynator-keys\s*:\s*([^\n]+)/g;
+function flatten(obj, prefix = "") {
+  const out = {};
+  for (const [k, v] of Object.entries(obj || {})) {
+    const key = prefix ? `${prefix}.${k}` : k;
+    if (v && typeof v === "object" && !Array.isArray(v)) {
+      Object.assign(out, flatten(v, key));
+    } else {
+      out[key] = String(v);
+    }
+  }
+  return out;
+}
+function walkSourceFiles(rootDir) {
+  if (!import_fs3.default.existsSync(rootDir)) return [];
+  const results = [];
+  function walk(dir) {
+    for (const entry of import_fs3.default.readdirSync(dir, { withFileTypes: true })) {
+      if (entry.isDirectory()) {
+        if (EXCLUDED_DIRS.has(entry.name)) continue;
+        walk(import_path3.default.join(dir, entry.name));
+      } else if (SOURCE_EXTENSIONS.includes(import_path3.default.extname(entry.name))) {
+        results.push(import_path3.default.join(dir, entry.name));
+      }
+    }
+  }
+  walk(rootDir);
+  return results;
+}
+function scanUsedKeys(files) {
+  const used = /* @__PURE__ */ new Map();
+  const dynamicPrefixes = /* @__PURE__ */ new Set();
+  for (const file of files) {
+    const content = import_fs3.default.readFileSync(file, "utf-8");
+    for (const { re, group } of USE_PATTERNS) {
+      re.lastIndex = 0;
+      let match;
+      while (match = re.exec(content)) {
+        const key = match[group];
+        used.set(key, (used.get(key) || 0) + 1);
+      }
+    }
+    MAGIC_RE.lastIndex = 0;
+    let magicMatch;
+    while (magicMatch = MAGIC_RE.exec(content)) {
+      for (const raw of magicMatch[1].split(",")) {
+        const prefix = raw.trim().replace(/\*$/, "");
+        if (prefix) dynamicPrefixes.add(prefix);
+      }
+    }
+  }
+  return { used, dynamicPrefixes };
+}
+function loadSafelist(cwd) {
+  const p = import_path3.default.join(cwd, SAFELIST_FILE);
+  if (!import_fs3.default.existsSync(p)) return { dynamicPrefixes: [] };
+  try {
+    return JSON.parse(import_fs3.default.readFileSync(p, "utf-8"));
+  } catch {
+    return { dynamicPrefixes: [] };
+  }
+}
+function loadBaseline(cwd) {
+  const p = import_path3.default.join(cwd, BASELINE_FILE);
+  if (!import_fs3.default.existsSync(p)) return { keys: [] };
+  try {
+    const parsed = JSON.parse(import_fs3.default.readFileSync(p, "utf-8"));
+    return { keys: Array.isArray(parsed.keys) ? parsed.keys : [] };
+  } catch {
+    return { keys: [] };
+  }
+}
+function saveBaseline(cwd, keys) {
+  const p = import_path3.default.join(cwd, BASELINE_FILE);
+  import_fs3.default.writeFileSync(p, JSON.stringify({ keys: keys.sort() }, null, 2) + "\n");
+}
+function isProtectedByPrefix(key, prefixes) {
+  for (const prefix of prefixes) {
+    if (key.startsWith(prefix)) return true;
+  }
+  return false;
+}
+function gitShowFile(cwd, ref, relPath) {
+  try {
+    return (0, import_child_process.execFileSync)("git", ["show", `${ref}:${relPath}`], { cwd, stdio: ["pipe", "pipe", "ignore"] }).toString("utf-8");
+  } catch {
+    return null;
+  }
+}
+function slugify(value, maxLen = 40) {
+  return String(value).replace(/<[^>]+>/g, "").replace(/\{\{[^}]+\}\}/g, "").normalize("NFD").replace(/[̀-ͯ]/g, "").toLowerCase().replace(/[^a-z0-9]+/g, "_").replace(/^_+|_+$/g, "").slice(0, maxLen) || "value";
+}
+function pickGlobal(keys) {
+  const globals = keys.filter((k) => k.startsWith("global."));
+  if (!globals.length) return null;
+  const segmented = globals.filter((k) => /^global\.(status|error|action)\./.test(k));
+  const pool = segmented.length ? segmented : globals;
+  return pool.reduce((shortest, k) => k.length < shortest.length ? k : shortest, pool[0]);
+}
+function findGlobalDuplicates(values, usedKeys) {
+  const byValue = /* @__PURE__ */ new Map();
+  for (const [key, value] of Object.entries(values)) {
+    const trimmed = value.trim();
+    if (!trimmed) continue;
+    const group = byValue.get(trimmed) || [];
+    group.push(key);
+    byValue.set(trimmed, group);
+  }
+  const findings = [];
+  for (const [value, keys] of byValue) {
+    if (keys.length < 2) continue;
+    const canonical = pickGlobal(keys) || `global.${slugify(value)}`;
+    for (const key of keys) {
+      if (key === canonical) continue;
+      if (!usedKeys.has(key)) continue;
+      findings.push({ key, value, canonical, canonicalIsNew: !keys.includes(canonical) });
+    }
+  }
+  return findings;
+}
+
+// src/commands/check.ts
+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."));
+    return;
+  }
   console.log(import_chalk2.default.bold.blue("\n\u{1F50D} Validating JSON translation files...\n"));
-  const assetsDir = import_path2.default.join(process.cwd(), "src/assets/i18n");
-  if (!import_fs2.default.existsSync(assetsDir)) {
+  const cwd = process.cwd();
+  const framework = detectFramework();
+  const assetsDir = getTranslationDir(framework);
+  if (!import_fs4.default.existsSync(assetsDir)) {
     console.log(import_chalk2.default.red(`\u274C Could not find directory: ${assetsDir}`));
     console.log(import_chalk2.default.yellow("Make sure you are running this from your project root."));
-    return;
+    process.exit(1);
   }
-  const files = import_fs2.default.readdirSync(assetsDir).filter((f) => f.endsWith(".json"));
+  const files = import_fs4.default.readdirSync(assetsDir).filter((f) => f.endsWith(".json"));
   if (files.length === 0) {
-    console.log(import_chalk2.default.yellow("\u26A0\uFE0F No JSON files found in assets/i18n."));
+    console.log(import_chalk2.default.yellow("\u26A0\uFE0F No JSON files found in " + assetsDir + "."));
     return;
   }
-  let hasErrors = false;
+  let hasJsonErrors = false;
+  const parsed = {};
   files.forEach((file) => {
     try {
-      const content = import_fs2.default.readFileSync(import_path2.default.join(assetsDir, file), "utf-8");
-      JSON.parse(content);
+      const content = import_fs4.default.readFileSync(import_path4.default.join(assetsDir, file), "utf-8");
+      parsed[file] = JSON.parse(content);
       console.log(import_chalk2.default.green(`\u2713 ${file} is valid JSON.`));
     } catch (e) {
-      hasErrors = true;
+      hasJsonErrors = true;
       console.log(import_chalk2.default.red(`\u274C ${file} has syntax errors:`));
       console.log(import_chalk2.default.red(`   ${e.message}`));
     }
   });
-  if (hasErrors) {
+  if (hasJsonErrors) {
     console.log(import_chalk2.default.red("\n\u{1F4A5} Validation failed. Please fix the errors above."));
     process.exit(1);
-  } else {
-    console.log(import_chalk2.default.bold.green("\n\u2728 All files are valid! You are ready to go."));
   }
+  console.log(import_chalk2.default.bold.blue("\n\u{1F6E1}\uFE0F  Guarding against broken references and duplicate keys...\n"));
+  const definedKeys = /* @__PURE__ */ new Set();
+  for (const file of files) {
+    Object.keys(flatten(parsed[file])).forEach((k) => definedKeys.add(k));
+  }
+  const refFile = files.includes("en.json") ? "en.json" : files.sort()[0];
+  const refValues = flatten(parsed[refFile]);
+  const sourceRoot = getSourceRoot(framework);
+  const sourceFiles = walkSourceFiles(sourceRoot);
+  const { used, dynamicPrefixes: magicPrefixes } = scanUsedKeys(sourceFiles);
+  const safelist = loadSafelist(cwd);
+  const protectedPrefixes = /* @__PURE__ */ new Set([...safelist.dynamicPrefixes || [], ...magicPrefixes]);
+  const missing = [...used.keys()].filter((k) => !definedKeys.has(k)).filter((k) => !isProtectedByPrefix(k, protectedPrefixes));
+  const baseline = loadBaseline(cwd);
+  const baselineSet = new Set(baseline.keys);
+  const freshMissing = missing.filter((k) => !baselineSet.has(k));
+  const staleBaseline = baseline.keys.filter((k) => !missing.includes(k));
+  if (opts.updateBaseline) {
+    saveBaseline(cwd, missing);
+    console.log(import_chalk2.default.green(`\u2705 Baseline updated: ${missing.length} accepted missing key(s) written to kopynator.i18n-baseline.json`));
+    return;
+  }
+  if (opts.all) {
+    console.log(import_chalk2.default.bold(`
+All missing keys (${missing.length}):`));
+    missing.slice().sort().forEach((k) => {
+      const tag = baselineSet.has(k) ? import_chalk2.default.gray("[baseline]") : import_chalk2.default.red("[NEW]");
+      console.log(`  ${tag} ${k} ${import_chalk2.default.gray(`(used ${used.get(k)}x)`)}`);
+    });
+  }
+  const baseRef = opts.baseRef || "master";
+  const oldRefContent = gitShowFile(cwd, baseRef, import_path4.default.relative(cwd, import_path4.default.join(assetsDir, refFile)));
+  const oldRefValues = oldRefContent ? flatten(JSON.parse(oldRefContent)) : {};
+  const duplicates = findGlobalDuplicates(refValues, new Set(used.keys())).filter(
+    (d) => oldRefValues[d.key] === void 0 || oldRefValues[d.key] !== refValues[d.key]
+  );
+  let hasFailures = false;
+  if (freshMissing.length) {
+    hasFailures = true;
+    console.log(import_chalk2.default.red(`
+\u274C ${freshMissing.length} translation key(s) used in code but missing from ${assetsDir}:`));
+    freshMissing.sort().forEach((k) => console.log(import_chalk2.default.red(`   - ${k} ${import_chalk2.default.gray(`(used ${used.get(k)}x)`)}`)));
+  }
+  if (duplicates.length) {
+    hasFailures = true;
+    console.log(import_chalk2.default.red(`
+\u274C ${duplicates.length} key(s) duplicate an existing global value:`));
+    duplicates.forEach(
+      (d) => console.log(import_chalk2.default.red(`   - "${d.key}" duplicates "${d.canonical}"${d.canonicalIsNew ? import_chalk2.default.gray(" (not created yet \u2014 proposed)") : ""} \u2192 "${d.value}"`))
+    );
+  }
+  if (staleBaseline.length) {
+    console.log(
+      import_chalk2.default.blue(`
+\u2139\uFE0F  i18n: ${staleBaseline.length} baseline key(s) no longer missing; regenerate: kopynator check --update-baseline`)
+    );
+  }
+  if (hasFailures) {
+    console.log(import_chalk2.default.red("\n\u{1F4A5} i18n check failed. Fix the issues above, or run with --update-baseline to accept current debt."));
+    process.exit(1);
+  }
+  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)).`));
 }
 
 // src/commands/sync.ts
 var import_chalk3 = __toESM(require("chalk"));
-var import_fs3 = __toESM(require("fs"));
-var import_path3 = __toESM(require("path"));
+var import_fs5 = __toESM(require("fs"));
+var import_path5 = __toESM(require("path"));
 var import_inquirer2 = __toESM(require("inquirer"));
 var import_ora = __toESM(require("ora"));
-function detectFramework() {
-  const angularJson = import_path3.default.join(process.cwd(), "angular.json");
-  const packageJson = import_path3.default.join(process.cwd(), "package.json");
-  if (import_fs3.default.existsSync(angularJson)) {
-    return "Angular";
-  }
-  if (import_fs3.default.existsSync(packageJson)) {
-    try {
-      const pkg = JSON.parse(import_fs3.default.readFileSync(packageJson, "utf-8"));
-      const deps = { ...pkg.dependencies, ...pkg.devDependencies };
-      if (deps["@angular/core"]) return "Angular";
-      if (deps["react"]) return "React";
-      if (deps["vue"]) return "Vue";
-    } catch (e) {
-    }
-  }
-  return "Other";
-}
-function getTranslationDir(framework) {
-  switch (framework) {
-    case "Angular":
-      return import_path3.default.join(process.cwd(), "src/assets/i18n");
-    case "React":
-      return import_path3.default.join(process.cwd(), "public/locales");
-    case "Vue":
-      return import_path3.default.join(process.cwd(), "public/locales");
-    default:
-      return import_path3.default.join(process.cwd(), "locales");
-  }
-}
 function loadJsonConfig(jsonPath) {
-  if (!import_fs3.default.existsSync(jsonPath)) return null;
+  if (!import_fs5.default.existsSync(jsonPath)) return null;
   try {
-    const config = JSON.parse(import_fs3.default.readFileSync(jsonPath, "utf-8"));
+    const config = JSON.parse(import_fs5.default.readFileSync(jsonPath, "utf-8"));
     if (config.apiKey) return { apiKey: config.apiKey, baseUrl: config.baseUrl };
   } catch (e) {
     if (jsonPath.includes("kopynator.config.json")) {
@@ -355,28 +576,28 @@ function loadJsonConfig(jsonPath) {
 }
 function extractApiKey() {
   const cwd = process.cwd();
-  const configFromRoot = loadJsonConfig(import_path3.default.join(cwd, "kopynator.config.json"));
+  const configFromRoot = loadJsonConfig(import_path5.default.join(cwd, "kopynator.config.json"));
   if (configFromRoot) {
     console.log(import_chalk3.default.blue("\u2139\uFE0F  Found API key in kopynator.config.json"));
     return configFromRoot;
   }
-  const configFromSrc = loadJsonConfig(import_path3.default.join(cwd, "src/kopynator.config.json"));
+  const configFromSrc = loadJsonConfig(import_path5.default.join(cwd, "src/kopynator.config.json"));
   if (configFromSrc) {
     console.log(import_chalk3.default.blue("\u2139\uFE0F  Found API key in src/kopynator.config.json"));
     return configFromSrc;
   }
-  const appConfigPath = import_path3.default.join(cwd, "src/app/app.config.ts");
-  const appModulePath = import_path3.default.join(cwd, "src/app/app.module.ts");
-  if (import_fs3.default.existsSync(appConfigPath)) {
-    const content = import_fs3.default.readFileSync(appConfigPath, "utf-8");
+  const appConfigPath = import_path5.default.join(cwd, "src/app/app.config.ts");
+  const appModulePath = import_path5.default.join(cwd, "src/app/app.module.ts");
+  if (import_fs5.default.existsSync(appConfigPath)) {
+    const content = import_fs5.default.readFileSync(appConfigPath, "utf-8");
     const apiKeyMatch = content.match(/apiKey:\s*['"]([^'"]+)['"]/);
     if (apiKeyMatch) {
       console.log(import_chalk3.default.blue("\u2139\uFE0F  Found API key in app.config.ts"));
       return { apiKey: apiKeyMatch[1] };
     }
   }
-  if (import_fs3.default.existsSync(appModulePath)) {
-    const content = import_fs3.default.readFileSync(appModulePath, "utf-8");
+  if (import_fs5.default.existsSync(appModulePath)) {
+    const content = import_fs5.default.readFileSync(appModulePath, "utf-8");
     const apiKeyMatch = content.match(/apiKey:\s*['"]([^'"]+)['"]/);
     if (apiKeyMatch) {
       console.log(import_chalk3.default.blue("\u2139\uFE0F  Found API key in app.module.ts"));
@@ -394,10 +615,10 @@ function extractApiKey() {
   return null;
 }
 async function getSyncConfig() {
-  const configPath = import_path3.default.join(process.cwd(), "kopynator.sync.config.json");
-  if (import_fs3.default.existsSync(configPath)) {
+  const configPath = import_path5.default.join(process.cwd(), "kopynator.sync.config.json");
+  if (import_fs5.default.existsSync(configPath)) {
     try {
-      const config2 = JSON.parse(import_fs3.default.readFileSync(configPath, "utf-8"));
+      const config2 = JSON.parse(import_fs5.default.readFileSync(configPath, "utf-8"));
       console.log(import_chalk3.default.blue("\u2139\uFE0F  Using existing sync configuration"));
       return config2;
     } catch (e) {
@@ -442,7 +663,7 @@ async function getSyncConfig() {
     pretty: answers.pretty,
     indent: answers.indent
   };
-  import_fs3.default.writeFileSync(configPath, JSON.stringify(config, null, 2));
+  import_fs5.default.writeFileSync(configPath, JSON.stringify(config, null, 2));
   console.log(import_chalk3.default.green("\u2705 Configuration saved to kopynator.sync.config.json\n"));
   return config;
 }
@@ -475,8 +696,8 @@ async function syncCommand() {
     const languages = await languagesResponse.json();
     spinner.succeed(`Found ${languages.length} language(s): ${languages.join(", ")}`);
     const i18nDir = getTranslationDir(framework);
-    if (!import_fs3.default.existsSync(i18nDir)) {
-      import_fs3.default.mkdirSync(i18nDir, { recursive: true });
+    if (!import_fs5.default.existsSync(i18nDir)) {
+      import_fs5.default.mkdirSync(i18nDir, { recursive: true });
       console.log(import_chalk3.default.blue(`\u{1F4C1} Created directory: ${i18nDir}`));
     }
     for (const locale of languages) {
@@ -493,7 +714,7 @@ async function syncCommand() {
           continue;
         }
         const translationData = await translationResponse.json();
-        const outputPath = import_path3.default.join(i18nDir, `${locale}.json`);
+        const outputPath = import_path5.default.join(i18nDir, `${locale}.json`);
         let jsonString;
         if (syncConfig.pretty) {
           const indentValue = syncConfig.indent === "tab" ? "	" : Number(syncConfig.indent);
@@ -501,7 +722,7 @@ async function syncCommand() {
         } else {
           jsonString = JSON.stringify(translationData);
         }
-        import_fs3.default.writeFileSync(outputPath, jsonString);
+        import_fs5.default.writeFileSync(outputPath, jsonString);
         downloadSpinner.succeed(`Saved ${locale}.json`);
       } catch (err) {
         downloadSpinner.fail(`Error downloading ${locale}: ${err instanceof Error ? err.message : "Unknown error"}`);
@@ -515,17 +736,17 @@ 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_fs6 = __toESM(require("fs"));
+var import_path6 = __toESM(require("path"));
 var import_ora2 = __toESM(require("ora"));
 var BATCH_SIZE = 500;
-function flatten(data, prefix = "") {
+function flatten2(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));
+      Object.assign(result, flatten2(value, fullKey));
     } else {
       result[fullKey] = String(value);
     }
@@ -533,9 +754,9 @@ function flatten(data, prefix = "") {
   return result;
 }
 function loadJsonConfig2(jsonPath) {
-  if (!import_fs4.default.existsSync(jsonPath)) return null;
+  if (!import_fs6.default.existsSync(jsonPath)) return null;
   try {
-    const config = JSON.parse(import_fs4.default.readFileSync(jsonPath, "utf-8"));
+    const config = JSON.parse(import_fs6.default.readFileSync(jsonPath, "utf-8"));
     const key = config.apiKey ?? config.api_key;
     if (key && typeof key === "string") return { apiKey: key, baseUrl: config.baseUrl };
   } catch {
@@ -544,19 +765,19 @@ function loadJsonConfig2(jsonPath) {
 }
 function extractApiKey2() {
   const cwd = process.cwd();
-  const appConfigPath = import_path4.default.join(cwd, "src/app/app.config.ts");
-  const appModulePath = import_path4.default.join(cwd, "src/app/app.module.ts");
-  const configFromRoot = loadJsonConfig2(import_path4.default.join(cwd, "kopynator.config.json"));
+  const appConfigPath = import_path6.default.join(cwd, "src/app/app.config.ts");
+  const appModulePath = import_path6.default.join(cwd, "src/app/app.module.ts");
+  const configFromRoot = loadJsonConfig2(import_path6.default.join(cwd, "kopynator.config.json"));
   if (configFromRoot) return configFromRoot;
-  const configFromSrc = loadJsonConfig2(import_path4.default.join(cwd, "src/kopynator.config.json"));
+  const configFromSrc = loadJsonConfig2(import_path6.default.join(cwd, "src/kopynator.config.json"));
   if (configFromSrc) return configFromSrc;
-  if (import_fs4.default.existsSync(appConfigPath)) {
-    const content = import_fs4.default.readFileSync(appConfigPath, "utf-8");
+  if (import_fs6.default.existsSync(appConfigPath)) {
+    const content = import_fs6.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");
+  if (import_fs6.default.existsSync(appModulePath)) {
+    const content = import_fs6.default.readFileSync(appModulePath, "utf-8");
     const apiKeyMatch = content.match(/apiKey:\s*['"]([^'"]+)['"]/);
     if (apiKeyMatch) return { apiKey: apiKeyMatch[1] };
   }
@@ -570,7 +791,7 @@ function extractApiKey2() {
   return null;
 }
 function inferLangFromFile(filePath) {
-  const base = import_path4.default.basename(filePath, import_path4.default.extname(filePath));
+  const base = import_path6.default.basename(filePath, import_path6.default.extname(filePath));
   return base;
 }
 async function uploadCommand(options) {
@@ -578,13 +799,13 @@ async function uploadCommand(options) {
   const config = extractApiKey2();
   if (!config) {
     const cwd = process.cwd();
-    const rootConfig = import_path4.default.join(cwd, "kopynator.config.json");
-    const srcConfig = import_path4.default.join(cwd, "src/kopynator.config.json");
+    const rootConfig = import_path6.default.join(cwd, "kopynator.config.json");
+    const srcConfig = import_path6.default.join(cwd, "src/kopynator.config.json");
     console.log(import_chalk4.default.red("\u274C Could not find API key. Set it in kopynator.config.json, app.config.ts, or KOPYNATOR_API_KEY. Run `npx kopynator init` to create config."));
     console.log(import_chalk4.default.gray(`   Directorio actual: ${cwd}`));
-    console.log(import_chalk4.default.gray(`   Comprobado: ${rootConfig} (${import_fs4.default.existsSync(rootConfig) ? "existe" : "no existe"})`));
-    console.log(import_chalk4.default.gray(`   Comprobado: ${srcConfig} (${import_fs4.default.existsSync(srcConfig) ? "existe" : "no existe"})`));
-    if (import_fs4.default.existsSync(rootConfig) || import_fs4.default.existsSync(srcConfig)) {
+    console.log(import_chalk4.default.gray(`   Comprobado: ${rootConfig} (${import_fs6.default.existsSync(rootConfig) ? "existe" : "no existe"})`));
+    console.log(import_chalk4.default.gray(`   Comprobado: ${srcConfig} (${import_fs6.default.existsSync(srcConfig) ? "existe" : "no existe"})`));
+    if (import_fs6.default.existsSync(rootConfig) || import_fs6.default.existsSync(srcConfig)) {
       console.log(import_chalk4.default.yellow('\u{1F4A1} Si el archivo existe, comprueba que tenga la propiedad "apiKey" (o "api_key") con un valor no vac\xEDo.'));
     } else {
       console.log(import_chalk4.default.yellow("\u{1F4A1} Ejecuta el comando desde la ra\xEDz del proyecto (donde est\xE1 package.json)."));
@@ -596,8 +817,8 @@ async function uploadCommand(options) {
     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)) {
+  const resolvedPath = import_path6.default.isAbsolute(fileOption) ? fileOption : import_path6.default.join(process.cwd(), fileOption);
+  if (!import_fs6.default.existsSync(resolvedPath)) {
     console.log(import_chalk4.default.red(`\u274C File not found: ${resolvedPath}`));
     return;
   }
@@ -606,7 +827,7 @@ async function uploadCommand(options) {
   const token = config.apiKey;
   let raw;
   try {
-    raw = JSON.parse(import_fs4.default.readFileSync(resolvedPath, "utf-8"));
+    raw = JSON.parse(import_fs6.default.readFileSync(resolvedPath, "utf-8"));
   } catch (e) {
     console.log(import_chalk4.default.red(`\u274C Invalid JSON: ${resolvedPath}`));
     return;
@@ -615,7 +836,7 @@ async function uploadCommand(options) {
     console.log(import_chalk4.default.red("\u274C JSON root must be an object (key-value)."));
     return;
   }
-  const flat = flatten(raw);
+  const flat = flatten2(raw);
   const entries = Object.entries(flat);
   const total = entries.length;
   if (total === 0) {
@@ -689,15 +910,95 @@ async function uploadCommand(options) {
   }
 }
 
+// src/commands/limits.ts
+var import_chalk5 = __toESM(require("chalk"));
+var import_fs7 = __toESM(require("fs"));
+var import_path7 = __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 (cfg && cfg.apiKey) return { apiKey: cfg.apiKey, baseUrl: cfg.baseUrl };
+      }
+    } catch {
+    }
+    return null;
+  };
+  const fromAppFile = (p) => {
+    try {
+      if (import_fs7.default.existsSync(p)) {
+        const content = import_fs7.default.readFileSync(p, "utf-8");
+        const match = content.match(/apiKey:\s*['"]([^'"]+)['"]/);
+        if (match) return { apiKey: match[1] };
+      }
+    } catch {
+    }
+    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);
+}
+function formatLimit(value) {
+  return value === -1 ? "Unlimited" : String(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"));
+    process.exit(1);
+    return;
+  }
+  const base = (resolved.baseUrl || process.env.KOPYNATOR_BASE_URL || "https://api.kopynator.com").replace(/\/+$/, "").replace(/\/api$/, "");
+  const url = `${base}/tokens/limits?token=${encodeURIComponent(resolved.apiKey)}`;
+  try {
+    const res = await fetch(url, { headers: { "x-kopynator-version": "1.5.0" } });
+    if (!res.ok) {
+      const body = await res.text().catch(() => "");
+      console.log(import_chalk5.default.red(`
+\u2716 Could not fetch limits (HTTP ${res.status}). ${body}
+`));
+      process.exit(1);
+      return;
+    }
+    const data = await res.json();
+    const limits = data.limits || {};
+    const usage = data.usage || {};
+    const row = (label, used, limit) => {
+      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);
+    };
+    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(`  Plan: ${planLabel}  (${statusLabel})`);
+    console.log("");
+    console.log(row("Projects", usage.projects, limits.projects));
+    console.log(row("Keys", usage.keys, limits.keys));
+    console.log(row("Members", void 0, limits.members));
+    console.log("");
+  } catch (error) {
+    console.log(import_chalk5.default.red(`
+\u2716 Request failed: ${error?.message || error}
+`));
+    process.exit(1);
+  }
+}
+
 // src/index.ts
 var program = new import_commander.Command();
-program.name("kopynator").description("Kopynator CLI - Manage your i18n workflow").version("1.4.1", "-v, --version").helpOption("-h, --help", "Display help for command").addHelpText("beforeAll", import_chalk5.default.blue("\n\u{1F44B} Welcome to Kopynator CLI!\n"));
+program.name("kopynator").description("Kopynator CLI - Manage your i18n workflow").version("1.5.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.command("init").description("Initialize Kopynator in your project").action(initCommand);
-program.command("check").description("Validate your local JSON translation files").action(checkCommand);
+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("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_chalk5.default.blue("\u{1F44B} Kopynator CLI - Comandos disponibles:\n"));
+  console.log(import_chalk6.default.blue("\u{1F44B} Kopynator CLI - Comandos disponibles:\n"));
   program.outputHelp();
 });
 program.parse(process.argv);

package/package.json

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