Function publishCommand

packages/bumpy/src/commands/publish.ts:72–164

(
  rootDir: string,
  opts: PublishCommandOptions,
)

 * transiently into the working tree, published to the channel's dist-tag, and restored.
 */
export async function publishCommand(
  rootDir: string,
  opts: PublishCommandOptions,
): Promise<SnapshotPublishOutcome | null | void> {
  const config = await loadConfig(rootDir);
  const { packages, catalogs } = await discoverWorkspace(rootDir, config);
  const { packageManager: detectedPm } = await detectWorkspaces(rootDir);
  const depGraph = new DependencyGraph(packages);

  if (!opts.dryRun && hasUncommittedChanges({ cwd: rootDir })) {
    log.warn('You have uncommitted changes. Commit or stash them before publishing.');
    process.exit(1);
  }

  // Snapshots are a distinct, transient release model — never mixed with the channel flow.
  if (opts.snapshot !== undefined) {
    if (opts.channel !== undefined) {
      log.error('--snapshot and --channel cannot be used together — they are distinct release models.');
      process.exit(1);
    }
    return await publishSnapshot(rootDir, config, packages, catalogs, detectedPm, depGraph, opts);
  }

  const channel = resolveActiveChannel(rootDir, config, opts.channel);
  if (channel) {
    await publishChannel(rootDir, config, packages, catalogs, detectedPm, depGraph, channel, opts);
    return;
  }

  // Find packages that need publishing — use cached plan from `ci plan` if available,
  // otherwise query the registry
  let toPublish = await findUnpublishedWithCache(rootDir, packages, config);

  // When channels are configured, prerelease versions must never reach the stable
  // flow (they'd land on @latest). With the no-commit model this can't normally
  // happen — committed versions are always stable — so a suffixed version here
  // means something went wrong. Refuse loudly rather than publish it.
  if (Object.keys(config.channels || {}).length > 0) {
    const prereleases = toPublish.filter((r) => semver.prerelease(r.newVersion) !== null);
    if (prereleases.length > 0) {
      log.error('Refusing to publish prerelease versions outside a channel:');
      for (const r of prereleases) log.error(`  • ${r.name}@${r.newVersion}`);
      log.error('Prerelease versions should never be committed — see https://bumpy.varlock.dev/docs/prereleases');
      process.exit(1);
    }
  }

  // Exclude packages with pending non-none bumps (they'll be superseded by the next version PR)
  if (opts.excludePackages && opts.excludePackages.size > 0) {
    const excluded = toPublish.filter((r) => opts.excludePackages!.has(r.name));
    if (excluded.length > 0) {
      for (const r of excluded) {
        log.dim(`  Skipping ${r.name}@${r.newVersion} — pending bump will supersede this version`);
      }
      toPublish = toPublish.filter((r) => !opts.excludePackages!.has(r.name));
    }
  }