@kopynator/cli 1.2.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"));
@@ -494,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.2.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.2.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/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.2.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) {