@fire-spark/cli 0.0.0-stage → 0.13.3

package/src/main.ts

@@ -0,0 +1,113 @@
+import { COMMANDS, findCommand } from "./commands";
+import type { Command } from "./core/command.types";
+import { renderCommandHelp, renderRootHelp } from "./core/help";
+import { resolveLocale, translate } from "./core/i18n";
+import type { Locale } from "./core/i18n";
+import { GLOBAL_OPTIONS, UsageError, parseOptions } from "./core/options";
+import { resolveOptions, secretValues } from "./core/options";
+import { createOutput } from "./core/output";
+import type { Writer } from "./core/output";
+import { createRedactor, redactError, secretsFromEnv } from "./core/redact";
+import type { Redactor } from "./core/redact";
+
+export interface RunIo {
+  env: NodeJS.ProcessEnv;
+  cwd: string;
+  stdout: Writer;
+  stderr: Writer;
+  isTty: boolean;
+  ask?: (question: string) => Promise<string>;
+}
+
+const UNKNOWN_COMMAND = {
+  "es-EC": "Comando desconocido: {name}",
+  "en-US": "Unknown command: {name}",
+  "pt-BR": "Comando desconhecido: {name}"
+};
+
+const USAGE_ERROR = {
+  "es-EC": "Error de uso: {message}",
+  "en-US": "Usage error: {message}",
+  "pt-BR": "Erro de uso: {message}"
+};
+
+const UNEXPECTED = {
+  "es-EC": "Error inesperado: {message}",
+  "en-US": "Unexpected error: {message}",
+  "pt-BR": "Erro inesperado: {message}"
+};
+
+const defaultIo = (): RunIo => {
+  return {
+    env: process.env,
+    cwd: process.cwd(),
+    stdout: process.stdout,
+    stderr: process.stderr,
+    isTty: Boolean(process.stdout.isTTY)
+  };
+};
+
+const peekLocale = (argv: string[], env: NodeJS.ProcessEnv) => {
+  const index = argv.findIndex(arg => arg === "--locale");
+  const inline = argv.find(arg => arg.startsWith("--locale="));
+  const flag = inline ? inline.slice("--locale=".length) : argv[index + 1];
+  return resolveLocale(index >= 0 || inline ? flag : undefined, env);
+};
+
+interface CommandRun {
+  command: Command;
+  argv: string[];
+  io: RunIo;
+  locale: Locale;
+  redactor: Redactor;
+}
+
+const runCommand = async (input: CommandRun) => {
+  const { command, argv, io, locale, redactor } = input;
+  const specs = [...command.options, ...GLOBAL_OPTIONS];
+  const { values, positionals } = parseOptions(argv, specs);
+  const options = resolveOptions(specs, values, io.env);
+  for (const secret of secretValues(specs, options)) redactor.add(secret);
+  const colors = io.isTty && !options["no-color"];
+  const output = createOutput(io.stdout, io.stderr, redactor, colors);
+  if (options.help) {
+    output.line(renderCommandHelp(command, locale));
+    return 0;
+  }
+  const { env, cwd, ask, isTty } = io;
+  const context = { locale, options, positionals, env, cwd, output, redactor };
+  return command.run({ ...context, isTty, ask });
+};
+
+// `pnpm run doctor -- --live` forwards the separator itself.
+const dropSeparators = (argv: string[]) => argv.filter(arg => arg !== "--");
+
+export const run = async (input: string[], io: RunIo = defaultIo()) => {
+  const argv = dropSeparators(input);
+  const locale = peekLocale(argv, io.env);
+  const redactor = createRedactor(secretsFromEnv(io.env));
+  const output = createOutput(io.stdout, io.stderr, redactor, false);
+  const [name, ...rest] = argv;
+  if (!name || name === "--help" || name === "-h" || name === "help") {
+    output.line(renderRootHelp(COMMANDS, locale));
+    return 0;
+  }
+  const command = findCommand(name);
+  if (!command) {
+    output.error(translate(locale, UNKNOWN_COMMAND, { name }));
+    output.error(renderRootHelp(COMMANDS, locale));
+    return 2;
+  }
+  try {
+    const input = { command, argv: rest, io, locale, redactor };
+    return await runCommand(input);
+  } catch (error) {
+    const message = redactError(error, redactor);
+    if (error instanceof UsageError) {
+      output.error(translate(locale, USAGE_ERROR, { message }));
+      return 2;
+    }
+    output.error(translate(locale, UNEXPECTED, { message }));
+    return 1;
+  }
+};

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.