@red-hat-developer-hub/translations-cli 0.0.1

package/dist/commands/index.cjs.js

@@ -0,0 +1,146 @@
+'use strict';
+
+var errors = require('../lib/errors.cjs.js');
+var generate = require('./generate.cjs.js');
+var upload = require('./upload.cjs.js');
+var download = require('./download.cjs.js');
+var deploy = require('./deploy.cjs.js');
+var status = require('./status.cjs.js');
+var clean = require('./clean.cjs.js');
+var sync = require('./sync.cjs.js');
+var init = require('./init.cjs.js');
+var setupMemsource = require('./setupMemsource.cjs.js');
+var list = require('./list.cjs.js');
+
+function registerCommands(program) {
+  const command = program.command("i18n [command]").description(
+    "Internationalization (i18n) management commands for translation workflows"
+  );
+  command.command("generate").description("Generate translation reference files from source code").requiredOption(
+    "--sprint <sprint>",
+    "Sprint value for filename (e.g., s3285). Format: <repo-name>-reference-<sprint>.json"
+  ).option(
+    "--source-dir <path>",
+    "Source directory to scan for translatable strings",
+    "src"
+  ).option(
+    "--output-dir <path>",
+    "Output directory for generated translation files",
+    "i18n"
+  ).option("--format <format>", "Output format (json, po)", "json").option(
+    "--include-pattern <pattern>",
+    "File pattern to include (glob)",
+    "**/*.{ts,tsx,js,jsx}"
+  ).option(
+    "--exclude-pattern <pattern>",
+    "File pattern to exclude (glob)",
+    "**/node_modules/**"
+  ).option("--extract-keys", "Extract translation keys from source code", true).option("--merge-existing", "Merge with existing translation files", false).option(
+    "--core-plugins",
+    "Generate core-plugins reference (Backstage plugins only) instead of RHDH-specific reference"
+  ).option(
+    "--output-filename <name>",
+    "Custom output filename (overrides sprint-based naming)"
+  ).option(
+    "--backstage-repo-path <path>",
+    "Path to Backstage repository root (for core-plugins mode). Defaults to checking BACKSTAGE_REPO_PATH env var or config"
+  ).action(wrapCommand(generate.generateCommand));
+  command.command("upload").description(
+    "Upload translation reference files to TMS (Translation Management System)"
+  ).option("--tms-url <url>", "TMS API URL").option("--tms-token <token>", "TMS API token").option("--project-id <id>", "TMS project ID").option("--source-file <path>", "Source translation file to upload").option(
+    "--upload-filename <name>",
+    "Custom filename for TMS upload (default: {repo-name}-{sprint}.json, extracts sprint from source filename)"
+  ).option(
+    "--target-languages <languages>",
+    "Comma-separated list of target languages"
+  ).option(
+    "--dry-run",
+    "Show what would be uploaded without actually uploading",
+    false
+  ).option("--force", "Force upload even if file has not changed", false).action(wrapCommand(upload.uploadCommand));
+  command.command("list").description("List available translation jobs from TMS").option("--project-id <id>", "TMS project ID").option("--languages <languages>", 'Filter by languages (e.g., "it,ja,fr")').option(
+    "--status <status>",
+    'Filter by status (e.g., "COMPLETED", "ASSIGNED", "NEW")'
+  ).option("--format <format>", "Output format (table, json)", "table").action(wrapCommand(list.listCommand));
+  command.command("download").description("Download translated strings from TMS using Memsource CLI").option("--project-id <id>", "TMS project ID").option(
+    "--output-dir <path>",
+    "Output directory for downloaded translations",
+    "i18n/downloads"
+  ).option(
+    "--languages <languages>",
+    'Comma-separated list of languages to download (e.g., "it,ja,fr")'
+  ).option(
+    "--job-ids <ids>",
+    'Comma-separated list of specific job UIDs to download (use "i18n list" to see UIDs)'
+  ).option(
+    "--status <status>",
+    'Filter by status (default: "COMPLETED"). Use "ALL" to download all statuses, or specific status like "ASSIGNED"',
+    "COMPLETED"
+  ).option(
+    "--include-incomplete",
+    "Include incomplete jobs (same as --status ALL)",
+    false
+  ).action(wrapCommand(download.downloadCommand));
+  command.command("deploy").description(
+    "Deploy downloaded translations to TypeScript translation files (it.ts, ja.ts, etc.)"
+  ).option(
+    "--source-dir <path>",
+    "Source directory containing downloaded translations (from Memsource)",
+    "i18n/downloads"
+  ).action(wrapCommand(deploy.deployCommand));
+  command.command("status").description("Show translation status and statistics").option("--source-dir <path>", "Source directory to analyze", "src").option("--i18n-dir <path>", "i18n directory to analyze", "i18n").option(
+    "--locales-dir <path>",
+    "Locales directory to analyze",
+    "src/locales"
+  ).option("--format <format>", "Output format (table, json)", "table").option("--include-stats", "Include detailed statistics", true).action(wrapCommand(status.statusCommand));
+  command.command("clean").description("Clean up temporary i18n files and caches").option("--i18n-dir <path>", "i18n directory to clean", "i18n").option("--cache-dir <path>", "Cache directory to clean", ".i18n-cache").option("--backup-dir <path>", "Backup directory to clean", ".i18n-backup").option("--force", "Force cleanup without confirmation", false).action(wrapCommand(clean.cleanCommand));
+  command.command("sync").description(
+    "Complete i18n workflow: generate \u2192 upload \u2192 download \u2192 deploy"
+  ).requiredOption(
+    "--sprint <sprint>",
+    "Sprint value for filename (e.g., s3285). Required for generate step."
+  ).option("--source-dir <path>", "Source directory to scan", "src").option("--output-dir <path>", "Output directory for i18n files", "i18n").option("--locales-dir <path>", "Target locales directory", "src/locales").option("--tms-url <url>", "TMS API URL").option("--tms-token <token>", "TMS API token").option("--project-id <id>", "TMS project ID").option(
+    "--languages <languages>",
+    "Comma-separated list of target languages"
+  ).option("--skip-upload", "Skip upload step", false).option("--skip-download", "Skip download step", false).option("--skip-deploy", "Skip deploy step", false).option("--dry-run", "Show what would be done without executing", false).action(wrapCommand(sync.syncCommand));
+  command.command("init").description("Initialize i18n configuration files").option(
+    "--setup-memsource",
+    "Also set up .memsourcerc file for Memsource CLI",
+    false
+  ).option(
+    "--memsource-venv <path>",
+    "Path to Memsource CLI virtual environment (will auto-detect or prompt if not provided)"
+  ).action(wrapCommand(init.initCommand));
+  command.command("setup-memsource").description(
+    "Set up .memsourcerc file for Memsource CLI (follows localization team instructions)"
+  ).option(
+    "--memsource-venv <path>",
+    "Path to Memsource CLI virtual environment (will auto-detect or prompt if not provided)"
+  ).option(
+    "--memsource-url <url>",
+    "Memsource URL",
+    "https://cloud.memsource.com/web"
+  ).option(
+    "--username <username>",
+    "Memsource username (will prompt if not provided and in interactive terminal)"
+  ).option(
+    "--password <password>",
+    "Memsource password (will prompt if not provided and in interactive terminal)"
+  ).option(
+    "--no-input",
+    "Disable interactive prompts (for automation/scripts)"
+  ).action(wrapCommand(setupMemsource.setupMemsourceCommand));
+}
+function wrapCommand(actionFunc) {
+  return async (opts) => {
+    try {
+      await actionFunc(opts);
+      process.exit(0);
+    } catch (error) {
+      errors.exitWithError(error);
+    }
+  };
+}
+
+exports.registerCommands = registerCommands;
+//# sourceMappingURL=index.cjs.js.map

package/dist/commands/init.cjs.js

@@ -0,0 +1,115 @@
+'use strict';
+
+var os = require('node:os');
+var path = require('node:path');
+var chalk = require('chalk');
+var fs = require('fs-extra');
+var config = require('../lib/i18n/config.cjs.js');
+var setupMemsource = require('./setupMemsource.cjs.js');
+
+function _interopDefaultCompat (e) { return e && typeof e === 'object' && 'default' in e ? e : { default: e }; }
+
+var os__default = /*#__PURE__*/_interopDefaultCompat(os);
+var path__default = /*#__PURE__*/_interopDefaultCompat(path);
+var chalk__default = /*#__PURE__*/_interopDefaultCompat(chalk);
+var fs__default = /*#__PURE__*/_interopDefaultCompat(fs);
+
+async function initCommand(opts) {
+  console.log(chalk__default.default.blue("\u{1F527} Initializing i18n configuration..."));
+  try {
+    await config.createDefaultConfigFile();
+    const memsourceRcPath = path__default.default.join(os__default.default.homedir(), ".memsourcerc");
+    const hasMemsourceRc = await fs__default.default.pathExists(memsourceRcPath);
+    if (!hasMemsourceRc) {
+      await config.createDefaultAuthFile();
+    }
+    console.log(chalk__default.default.green("\n\u2705 Configuration files created successfully!"));
+    console.log(chalk__default.default.yellow("\n\u{1F4DD} Next steps:"));
+    console.log("");
+    console.log(
+      chalk__default.default.cyan("   1. Edit .i18n.config.json in your project root:")
+    );
+    console.log(
+      chalk__default.default.gray(
+        '      - Add your TMS URL (e.g., "https://cloud.memsource.com/web")'
+      )
+    );
+    console.log(chalk__default.default.gray("      - Add your TMS Project ID"));
+    console.log(
+      chalk__default.default.gray(
+        "      - Adjust directories, languages, and patterns as needed"
+      )
+    );
+    console.log("");
+    if (hasMemsourceRc) {
+      console.log(
+        chalk__default.default.green(
+          "   \u2713 ~/.memsourcerc found - authentication is already configured!"
+        )
+      );
+      console.log(
+        chalk__default.default.gray("     Make sure to source it before running commands:")
+      );
+      console.log(chalk__default.default.gray("     source ~/.memsourcerc"));
+      console.log("");
+    } else {
+      console.log(
+        chalk__default.default.cyan("   2. Set up Memsource authentication (recommended):")
+      );
+      console.log(
+        chalk__default.default.gray("      Run: translations-cli i18n setup-memsource")
+      );
+      console.log(
+        chalk__default.default.gray(
+          "      This creates ~/.memsourcerc following the localization team's format"
+        )
+      );
+      console.log(chalk__default.default.gray("      Then source it: source ~/.memsourcerc"));
+      console.log("");
+      console.log(chalk__default.default.cyan("   OR use ~/.i18n.auth.json (fallback):"));
+      console.log(chalk__default.default.gray("      - Add your TMS username and password"));
+      console.log(
+        chalk__default.default.gray(
+          "      - Token can be left empty (will be generated or read from environment)"
+        )
+      );
+      console.log("");
+    }
+    console.log(chalk__default.default.cyan("   3. Security reminder:"));
+    console.log(
+      chalk__default.default.gray(
+        "      - Never commit ~/.i18n.auth.json or ~/.memsourcerc to git"
+      )
+    );
+    console.log(
+      chalk__default.default.gray("      - Add them to your global .gitignore if needed")
+    );
+    console.log("");
+    console.log(
+      chalk__default.default.blue("\u{1F4A1} For detailed instructions, see: docs/i18n-commands.md")
+    );
+    if (opts.setupMemsource) {
+      console.log(chalk__default.default.blue("\n\u{1F527} Setting up .memsourcerc file..."));
+      await setupMemsource.setupMemsourceCommand({
+        memsourceVenv: opts.memsourceVenv
+      });
+    } else if (!hasMemsourceRc) {
+      console.log(
+        chalk__default.default.yellow(
+          '\n\u{1F4A1} Tip: Run "translations-cli i18n setup-memsource" to set up .memsourcerc file'
+        )
+      );
+      console.log(
+        chalk__default.default.gray(
+          "   This follows the localization team's instructions format."
+        )
+      );
+    }
+  } catch (error) {
+    console.error(chalk__default.default.red("\u274C Error creating config files:"), error);
+    throw error;
+  }
+}
+
+exports.initCommand = initCommand;
+//# sourceMappingURL=init.cjs.js.map

package/dist/commands/list.cjs.js

@@ -0,0 +1,178 @@
+'use strict';
+
+var chalk = require('chalk');
+var config = require('../lib/i18n/config.cjs.js');
+var exec = require('../lib/utils/exec.cjs.js');
+
+function _interopDefaultCompat (e) { return e && typeof e === 'object' && 'default' in e ? e : { default: e }; }
+
+var chalk__default = /*#__PURE__*/_interopDefaultCompat(chalk);
+
+function buildListJobsArgs(projectId) {
+  return ["job", "list", "--project-id", projectId, "--format", "json"];
+}
+function listAllJobs(projectId) {
+  const listArgs = buildListJobsArgs(projectId);
+  const listOutput = exec.safeExecSyncOrThrow("memsource", listArgs, {
+    encoding: "utf-8",
+    env: { ...process.env }
+  });
+  const jobs = JSON.parse(listOutput);
+  return Array.isArray(jobs) ? jobs : [jobs];
+}
+function validateMemsourcePrerequisites() {
+  if (!exec.commandExists("memsource")) {
+    throw new Error(
+      "memsource CLI not found. Please ensure memsource-cli is installed and ~/.memsourcerc is sourced."
+    );
+  }
+  if (!process.env.MEMSOURCE_TOKEN) {
+    throw new Error(
+      "MEMSOURCE_TOKEN not found. Please source ~/.memsourcerc first: source ~/.memsourcerc"
+    );
+  }
+}
+function formatStatus(status) {
+  const statusMap = {
+    COMPLETED: chalk__default.default.green("\u2713 COMPLETED"),
+    ASSIGNED: chalk__default.default.yellow("\u25CB ASSIGNED"),
+    NEW: chalk__default.default.blue("\u25CB NEW"),
+    DECLINED: chalk__default.default.red("\u2717 DECLINED"),
+    CANCELLED: chalk__default.default.gray("\u2717 CANCELLED")
+  };
+  return statusMap[status] || status;
+}
+function displayJobsTable(jobs, languages, statusFilter) {
+  let filteredJobs = jobs;
+  if (languages && languages.length > 0) {
+    const languageSet = new Set(languages);
+    filteredJobs = filteredJobs.filter(
+      (job) => languageSet.has(job.target_lang)
+    );
+  }
+  if (statusFilter) {
+    filteredJobs = filteredJobs.filter(
+      (job) => job.status === statusFilter
+    );
+  }
+  if (filteredJobs.length === 0) {
+    console.log(chalk__default.default.yellow("No jobs found matching the criteria."));
+    return;
+  }
+  const jobsByFile = /* @__PURE__ */ new Map();
+  for (const job of filteredJobs) {
+    const filename = job.filename || "unknown";
+    if (!jobsByFile.has(filename)) {
+      jobsByFile.set(filename, []);
+    }
+    jobsByFile.get(filename).push(job);
+  }
+  console.log(chalk__default.default.blue("\n\u{1F4CB} Available Translation Jobs\n"));
+  console.log(
+    chalk__default.default.gray(
+      "Note: Display IDs (1, 2, 3...) shown in TMS UI are sequential and may not match the order here.\n"
+    )
+  );
+  console.log(
+    chalk__default.default.bold(
+      `${"Filename".padEnd(50)} ${"Language".padEnd(8)} ${"Status".padEnd(
+        15
+      )} ${"Real UID (for download)".padEnd(30)}`
+    )
+  );
+  console.log(chalk__default.default.gray("-".repeat(120)));
+  for (const [filename, fileJobs] of Array.from(jobsByFile.entries()).sort(
+    (a, b) => a[0].localeCompare(b[0])
+  )) {
+    const sortedJobs = fileJobs.sort(
+      (a, b) => (a.target_lang || "").localeCompare(b.target_lang || "")
+    );
+    for (const job of sortedJobs) {
+      const status = formatStatus(job.status || "UNKNOWN");
+      const lang = (job.target_lang || "unknown").padEnd(8);
+      const uid = (job.uid || "unknown").padEnd(30);
+      const fileDisplay = filename.length > 48 ? `${filename.slice(0, 45)}...` : filename;
+      console.log(
+        `${fileDisplay.padEnd(50)} ${lang} ${status.padEnd(15)} ${chalk__default.default.cyan(
+          uid
+        )}`
+      );
+    }
+  }
+  console.log(chalk__default.default.gray("-".repeat(120)));
+  console.log(
+    chalk__default.default.gray(
+      `
+Total: ${filteredJobs.length} job(s) | Use --languages or --status to filter`
+    )
+  );
+  console.log(
+    chalk__default.default.yellow(
+      "\n\u{1F4A1} Tip: Use the Real UID (not display ID) with --job-ids to download specific jobs."
+    )
+  );
+  console.log(
+    chalk__default.default.yellow(
+      '   Or use --languages "it,ja" to download all jobs for specific languages.'
+    )
+  );
+}
+function displayJobsJson(jobs, languages, statusFilter) {
+  let filteredJobs = jobs;
+  if (languages && languages.length > 0) {
+    const languageSet = new Set(languages);
+    filteredJobs = filteredJobs.filter(
+      (job) => languageSet.has(job.target_lang)
+    );
+  }
+  if (statusFilter) {
+    filteredJobs = filteredJobs.filter(
+      (job) => job.status === statusFilter
+    );
+  }
+  console.log(JSON.stringify(filteredJobs, null, 2));
+}
+async function listCommand(opts) {
+  console.log(chalk__default.default.blue("\u{1F4CB} Listing translation jobs from TMS..."));
+  const config$1 = await config.loadI18nConfig();
+  const mergedOpts = await config.mergeConfigWithOptions(config$1, opts);
+  const {
+    projectId,
+    languages,
+    status,
+    format = "table"
+  } = mergedOpts;
+  if (!projectId) {
+    console.error(chalk__default.default.red("\u274C Missing required TMS configuration:"));
+    console.error("");
+    console.error(chalk__default.default.yellow("   \u2717 Project ID"));
+    console.error(
+      chalk__default.default.gray(
+        "     Set via: --project-id <id> or I18N_TMS_PROJECT_ID or .i18n.config.json"
+      )
+    );
+    process.exit(1);
+  }
+  if (!process.env.MEMSOURCE_TOKEN) {
+    console.error(chalk__default.default.red("\u274C MEMSOURCE_TOKEN not found"));
+    console.error(chalk__default.default.yellow("   Please source ~/.memsourcerc first:"));
+    console.error(chalk__default.default.gray("     source ~/.memsourcerc"));
+    process.exit(1);
+  }
+  try {
+    validateMemsourcePrerequisites();
+    const languageArray = languages && typeof languages === "string" ? languages.split(",").map((lang) => lang.trim()) : void 0;
+    const jobs = listAllJobs(projectId);
+    if (format === "json") {
+      displayJobsJson(jobs, languageArray, status);
+    } else {
+      displayJobsTable(jobs, languageArray, status);
+    }
+  } catch (error) {
+    console.error(chalk__default.default.red("\u274C Error listing jobs:"), error.message);
+    throw error;
+  }
+}
+
+exports.listCommand = listCommand;
+//# sourceMappingURL=list.cjs.js.map