@fluojs/cli 1.0.0-beta.4 → 1.0.0-beta.6

package/dist/commands/package-workflow.js

@@ -0,0 +1,137 @@
+import { spawn } from 'node:child_process';
+import { detectPackageManager, SUPPORTED_PACKAGE_MANAGERS } from './package-manager.js';
+const DEFAULT_PACKAGE_NAME = '@fluojs/cli';
+const DEFAULT_REGISTRY_TIMEOUT_MS = 5_000;
+const EMPTY_ENV = {};
+function normalizeFluoPackage(packageName) {
+  if (packageName.startsWith('@fluojs/')) {
+    return packageName;
+  }
+  return `@fluojs/${packageName}`;
+}
+function buildAddArgs(packageManager, packages, dev) {
+  if (packageManager === 'npm') {
+    return ['install', dev ? '--save-dev' : '--save', ...packages];
+  }
+  if (packageManager === 'yarn') {
+    return ['add', ...(dev ? ['--dev'] : []), ...packages];
+  }
+  return ['add', ...(dev ? ['-D'] : []), ...packages];
+}
+function defaultSpawnCommand(command, args, options) {
+  return new Promise((resolveExitCode, reject) => {
+    const child = spawn(command, args, options);
+    child.on('error', reject);
+    child.on('exit', code => resolveExitCode(code ?? 1));
+  });
+}
+async function fetchNpmDistTags(packageName) {
+  const controller = new AbortController();
+  const timeout = setTimeout(() => controller.abort(), DEFAULT_REGISTRY_TIMEOUT_MS);
+  try {
+    const response = await fetch(`https://registry.npmjs.org/-/package/${encodeURIComponent(packageName)}/dist-tags`, {
+      headers: {
+        accept: 'application/json'
+      },
+      signal: controller.signal
+    });
+    if (!response.ok) {
+      return undefined;
+    }
+    const payload = await response.json();
+    if (typeof payload !== 'object' || payload === null) {
+      return undefined;
+    }
+    const distTags = {};
+    for (const [key, value] of Object.entries(payload)) {
+      if (typeof value === 'string') {
+        distTags[key] = value;
+      }
+    }
+    return distTags;
+  } catch (_error) {
+    return undefined;
+  } finally {
+    clearTimeout(timeout);
+  }
+}
+function parsePackageManager(value) {
+  if (!value || value.startsWith('-')) {
+    throw new Error('Expected --package-manager to have a value.');
+  }
+  if (!SUPPORTED_PACKAGE_MANAGERS.has(value)) {
+    throw new Error(`Invalid --package-manager value "${value}". Use one of: pnpm, npm, yarn, bun.`);
+  }
+  return value;
+}
+export function addUsage() {
+  return ['Usage: fluo add <package...> [options]', '', 'Install one or more @fluojs packages with the detected package manager.', '', 'Options', '  --dev                                 Install as a development dependency.', '  --package-manager <pnpm|npm|yarn|bun> Override package-manager detection.', '  --dry-run                             Print the command without running it.', '  --help                                Show help for the add command.'].join('\n');
+}
+export function upgradeUsage() {
+  return ['Usage: fluo upgrade [options]', '', 'Report the latest CLI package state and point to migration workflows.', '', 'Options', '  --help  Show help for the upgrade command.'].join('\n');
+}
+export async function runAddCommand(argv, runtime = {}) {
+  if (argv.includes('--help') || argv.includes('-h')) {
+    (runtime.stdout ?? process.stdout).write(`${addUsage()}\n`);
+    return 0;
+  }
+  let dev = false;
+  let dryRun = false;
+  let packageManager;
+  const packages = [];
+  for (let index = 0; index < argv.length; index += 1) {
+    const arg = argv[index];
+    if (arg === '--dev' || arg === '-D') {
+      dev = true;
+      continue;
+    }
+    if (arg === '--dry-run') {
+      dryRun = true;
+      continue;
+    }
+    if (arg === '--package-manager') {
+      packageManager = parsePackageManager(argv[index + 1]);
+      index += 1;
+      continue;
+    }
+    if (arg.startsWith('-')) {
+      throw new Error(`Unknown add option: ${arg}`);
+    }
+    packages.push(normalizeFluoPackage(arg));
+  }
+  if (packages.length === 0) {
+    throw new Error('Expected at least one package for fluo add.');
+  }
+  const env = runtime.env ?? EMPTY_ENV;
+  const manager = packageManager ?? detectPackageManager({
+    cwd: runtime.cwd ?? process.cwd(),
+    env
+  });
+  const args = buildAddArgs(manager, packages, dev);
+  if (dryRun) {
+    (runtime.stdout ?? process.stdout).write(`Would run: ${manager} ${args.join(' ')}\n`);
+    return 0;
+  }
+  return (runtime.spawnCommand ?? defaultSpawnCommand)(manager, args, {
+    cwd: runtime.cwd ?? process.cwd(),
+    env,
+    stdio: 'inherit'
+  });
+}
+export async function runUpgradeCommand(argv, runtime = {}) {
+  if (argv.includes('--help') || argv.includes('-h')) {
+    (runtime.stdout ?? process.stdout).write(`${upgradeUsage()}\n`);
+    return 0;
+  }
+  if (argv.length > 0) {
+    throw new Error(`Unknown upgrade option: ${argv[0]}`);
+  }
+  const distTags = await (runtime.fetchDistTags ?? fetchNpmDistTags)(DEFAULT_PACKAGE_NAME);
+  const stdout = runtime.stdout ?? process.stdout;
+  stdout.write('fluo upgrade\n');
+  stdout.write(`  Latest CLI: ${distTags?.latest ?? 'unavailable'}\n`);
+  stdout.write('  To update the global CLI, run your package manager global install command for @fluojs/cli@latest.\n');
+  stdout.write('  To preview NestJS migration codemods, run `fluo migrate <path> --json`.\n');
+  stdout.write('  To inspect generated starter drift, run `fluo doctor`.\n');
+  return 0;
+}

package/dist/commands/scripts.d.ts

@@ -0,0 +1,38 @@
+type CliStream = {
+    isTTY?: boolean;
+    write(message: string): unknown;
+};
+type SpawnCommandOptions = {
+    cwd: string;
+    env: NodeJS.ProcessEnv;
+    stderr?: CliStream;
+    stdio: 'inherit' | 'pipe';
+    stdout?: CliStream;
+};
+type ScriptRuntimeOptions = {
+    ci?: boolean;
+    cwd?: string;
+    env?: NodeJS.ProcessEnv;
+    spawnCommand?: (command: string, args: string[], options: SpawnCommandOptions) => Promise<number>;
+    stderr?: CliStream;
+    stdout?: CliStream;
+};
+type ScriptCommand = 'build' | 'dev' | 'start';
+/**
+ * Renders lifecycle command help text.
+ *
+ * @param command Lifecycle command whose help text should be rendered.
+ * @returns Human-readable lifecycle command usage text.
+ */
+export declare function scriptUsage(command: ScriptCommand): string;
+/**
+ * Runs one generated-project lifecycle command through the CLI-owned runtime command matrix.
+ *
+ * @param command Lifecycle command to run.
+ * @param argv Command-specific arguments after the lifecycle command name.
+ * @param runtime Runtime dependencies used by tests, sandboxes, and embedders.
+ * @returns Process-style exit code from the lifecycle command.
+ */
+export declare function runScriptCommand(command: ScriptCommand, argv: string[], runtime?: ScriptRuntimeOptions): Promise<number>;
+export {};
+//# sourceMappingURL=scripts.d.ts.map

package/dist/commands/scripts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scripts.d.ts","sourceRoot":"","sources":["../../src/commands/scripts.ts"],"names":[],"mappings":"AAMA,KAAK,SAAS,GAAG;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;CACjC,CAAC;AAMF,KAAK,mBAAmB,GAAG;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IACvB,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,KAAK,EAAE,SAAS,GAAG,MAAM,CAAC;IAC1B,MAAM,CAAC,EAAE,SAAS,CAAC;CACpB,CAAC;AAEF,KAAK,oBAAoB,GAAG;IAC1B,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,mBAAmB,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAClG,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,MAAM,CAAC,EAAE,SAAS,CAAC;CACpB,CAAC;AAGF,KAAK,aAAa,GAAG,OAAO,GAAG,KAAK,GAAG,OAAO,CAAC;AA4c/C;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAmB1D;AAED;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,GAAE,oBAAyB,GAAG,OAAO,CAAC,MAAM,CAAC,CAyElI"}