Function parseBumpFile

packages/bumpy/src/core/bump-file.ts:138–230

(content: string, id: string)

/** Parse bump file content (for testing) */
export function parseBumpFile(content: string, id: string): BumpFileParseResult {
  const errors: string[] = [];
  const match = content.match(/^---\n([\s\S]*?)\n?---\n?([\s\S]*)$/);
  if (!match) {
    errors.push(`Bump file "${id}" has no valid frontmatter (expected --- delimiters)`);
    return { bumpFile: null, errors };
  }

  const frontmatter = match[1]!;
  const summary = match[2]!.trim();

  // Empty frontmatter is intentional — signals no releases needed
  if (!frontmatter.trim()) {
    return { bumpFile: null, errors };
  }

  let parsed: Record<string, unknown>;
  try {
    parsed = yaml.load(frontmatter) as Record<string, unknown>;
  } catch (e) {
    errors.push(`Bump file "${id}" has invalid YAML: ${e instanceof Error ? e.message : e}`);
    return { bumpFile: null, errors };
  }
  if (!parsed || typeof parsed !== 'object') {
    errors.push(`Bump file "${id}" has empty or invalid frontmatter`);
    return { bumpFile: null, errors };
  }

  const releases: BumpFileRelease[] = [];
  let noChangelog = false;
  for (const [name, value] of Object.entries(parsed)) {
    // Reserved meta keys are sigil-prefixed (`$`) so they can never collide with
    // a package name (`$` is rejected by validatePackageName).
    if (name.startsWith('$')) {
      if (name === '$changelog') {
        if (typeof value !== 'boolean') {
          errors.push(`Reserved key "$changelog" in bump file "${id}" must be true or false`);
        } else if (value === false) {
          noChangelog = true;
        }
      } else {
        errors.push(`Unknown reserved key "${name}" in bump file "${id}" (expected: $changelog)`);
      }
      continue;
    }

    if (!validatePackageName(name)) {
      errors.push(`Invalid package name "${name}" in bump file "${id}"`);
      continue;
    }

    if (typeof value === 'string') {
      if (!VALID_BUMP_TYPES.has(value)) {
        errors.push(
          `Unknown bump type "${value}" for "${name}" in bump file "${id}" (expected: major, minor, patch, or none)`,
        );
        continue;
      }