proper-changelog 0.1.0

package/README.md

@@ -0,0 +1,63 @@
+# proper-changelog
+
+GitHub releases are useful in some ways, but they're horrible as changelogs if you need to look at changes across multiple versions or figure out when a specific change was introduced. This tool reads GitHub releases and generates a single markdown changelog.
+
+## Usage
+
+```bash
+# By GitHub repository
+npx proper-changelog --repo <owner>/<repo>
+
+# By npm package name (the GitHub repository is read from the latest published version)
+npx proper-changelog --package <package-name>
+```
+
+Exactly one of `--repo` or `--package` is required.
+
+Releases are listed newest-first by published date. Draft releases are always excluded, and prereleases are excluded unless `--include-prereleases` is passed.
+
+By default this writes the changelog to `CHANGELOG-<package-or-repo>.md` in the current directory (using the package name when `--package` is given, otherwise the repo name). Use `--stdout` to print it instead, or `--out` to choose a different file name.
+
+```bash
+# Write to a custom file
+npx proper-changelog --repo microsoft/beachball --out CHANGELOG.md
+
+# Print to stdout
+npx proper-changelog --repo microsoft/beachball --stdout
+
+# Resolve the repository from an npm package
+npx proper-changelog --package @fluentui/react --stdout
+```
+
+## Options
+
+Either `--package` or `--repo` is required, and they're mutually exclusive.
+
+<!-- prettier-ignore -->
+| Option | Description |
+| ------ | ----------- |
+| `--repo <owner/repo>` | GitHub repository to read releases from. |
+| `--package <name>` | npm package whose GitHub repository should be used (read from the latest published version on npmjs.com; only supports github.com repos). Note that for a monorepo, this does **not** do any filtering of releases by package. |
+| `-o, --out <file>` | Output file name (default: `CHANGELOG-<package-or-repo>.md`). Mutually exclusive with `--stdout`. |
+| `--stdout` | Write the changelog to stdout instead of a file. Mutually exclusive with `--out`. |
+| `--token <token>` | GitHub token (see [Authentication](#authentication)). |
+| `--include-prereleases` | Include prerelease releases. Draft releases are always excluded. |
+| `--from <tag>` | Include releases up to and including this tag (based on date, **not** semver). |
+| `--to <tag>` | Include releases down to and including this tag (based on date, **not** semver). |
+| `--limit <n>` | Maximum number of releases to include. |
+| `--filter <pattern>` | Only include releases whose **tag** matches `<pattern>`. A plain string matches tags containing it (case-insensitive); wrap the value in slashes (e.g. `/^v1\./i`) to match with a regular expression. Useful for monorepos that tag releases per package. (Warning: this is _not_ sanitized, so ReDOS yourself at will.) |
+| `--since <date>` | Only include releases published after this date. Accepts any value parseable by `new Date()`, such as `2024-01-01`. |
+
+## Authentication
+
+The GitHub API is rate-limited for unauthenticated requests. To use a token, the tool checks the following in order:
+
+1. The `--token` option
+2. The `GITHUB_TOKEN` or `GH_TOKEN` environment variables
+3. The output of `gh auth token` (if the [GitHub CLI](https://cli.github.com/) is installed and authenticated)
+
+If no token is found, the tool prints a warning and continues unauthenticated.
+
+## API
+
+The package currently does not have an importable API. If you want this, please open a feature request describing your use case.

package/bin/proper-changelog.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { cli } from '../lib/cli.js';
+
+cli();

package/lib/cli.d.ts

@@ -0,0 +1,6 @@
+import { type CliContext, type ProperChangelogOptions } from './types.ts';
+/** Generate the changelog and write it to a file or stdout. */
+export declare function _generateChangelog(options: ProperChangelogOptions, context: CliContext): Promise<void>;
+/** Run the CLI and handle top-level errors. Intended to be called from the bin script. */
+export declare function cli(): void;
+//# sourceMappingURL=cli.d.ts.map

package/lib/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAIA,OAAO,EAAkB,KAAK,UAAU,EAAE,KAAK,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAG1F,+DAA+D;AAC/D,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,sBAAsB,EAAE,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAqB5G;AAED,0FAA0F;AAC1F,wBAAgB,GAAG,IAAI,IAAI,CAoB1B"}

package/lib/cli.js

@@ -0,0 +1,49 @@
+import fs from 'fs';
+import { CommanderError } from 'commander';
+import { fetchReleases } from "./fetchReleases.js";
+import { renderChangelog } from "./renderChangelog.js";
+import { ChangelogError } from "./types.js";
+import { parseArgs } from "./parseArgs.js";
+/** Generate the changelog and write it to a file or stdout. */
+export async function _generateChangelog(options, context) {
+    const { repo } = options;
+    const releases = await fetchReleases(repo, options.token);
+    if (!releases.length) {
+        context.warn(`No releases found for ${repo.owner}/${repo.repo}`);
+        return;
+    }
+    const changelog = renderChangelog(releases, options);
+    if (options.stdout) {
+        context.log(changelog);
+        return;
+    }
+    // Strip a leading npm scope and replace path separators so the result is a safe single filename.
+    const changelogName = (options.package ?? repo.repo).replace(/^@/, '').replace(/\//g, '-');
+    const outFile = options.out ?? `CHANGELOG-${changelogName}.md`;
+    context.writeFile(outFile, changelog);
+    context.log(`Wrote changelog to ${outFile}`);
+}
+/** Run the CLI and handle top-level errors. Intended to be called from the bin script. */
+export function cli() {
+    (async () => {
+        const context = {
+            argv: process.argv,
+            env: process.env,
+            log: message => console.log(message),
+            warn: message => console.warn(message),
+            writeFile: (file, content) => fs.writeFileSync(file, content, 'utf8'),
+        };
+        const options = await parseArgs(context);
+        await _generateChangelog(options, context);
+    })().catch((err) => {
+        if (err instanceof CommanderError || err instanceof ChangelogError) {
+            console.error(err.message);
+        }
+        else {
+            console.error(err instanceof Error ? err.stack || err.message : String(err));
+        }
+        // eslint-disable-next-line no-restricted-properties -- central handler
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=cli.js.map

package/lib/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAgD,MAAM,YAAY,CAAC;AAC1F,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,+DAA+D;AAC/D,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,OAA+B,EAAE,OAAmB;IAC3F,MAAM,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC;IAEzB,MAAM,QAAQ,GAAG,MAAM,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IAC1D,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;QACrB,OAAO,CAAC,IAAI,CAAC,yBAAyB,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QACjE,OAAO;IACT,CAAC;IAED,MAAM,SAAS,GAAG,eAAe,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAErD,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACnB,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACvB,OAAO;IACT,CAAC;IAED,iGAAiG;IACjG,MAAM,aAAa,GAAG,CAAC,OAAO,CAAC,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAC3F,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,IAAI,aAAa,aAAa,KAAK,CAAC;IAC/D,OAAO,CAAC,SAAS,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IACtC,OAAO,CAAC,GAAG,CAAC,sBAAsB,OAAO,EAAE,CAAC,CAAC;AAC/C,CAAC;AAED,0FAA0F;AAC1F,MAAM,UAAU,GAAG;IACjB,CAAC,KAAK,IAAI,EAAE;QACV,MAAM,OAAO,GAAe;YAC1B,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,GAAG,EAAE,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC;YACpC,IAAI,EAAE,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC;YACtC,SAAS,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC,EAAE,CAAC,aAAa,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC;SACtE,CAAC;QACF,MAAM,OAAO,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC,CAAC;QACzC,MAAM,kBAAkB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC7C,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;QAC1B,IAAI,GAAG,YAAY,cAAc,IAAI,GAAG,YAAY,cAAc,EAAE,CAAC;YACnE,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC7B,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,KAAK,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QAC/E,CAAC;QACD,uEAAuE;QACvE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/lib/fetchReleases.d.ts

@@ -0,0 +1,9 @@
+import { type GitHubRelease, type RepoId } from './types.ts';
+/**
+ * Fetch all releases for a repository from the GitHub REST API, following pagination.
+ *
+ * If `token` is provided, it is sent as a bearer token; otherwise requests are made
+ * unauthenticated (and are subject to stricter rate limits).
+ */
+export declare function fetchReleases(repo: RepoId, token?: string): Promise<GitHubRelease[]>;
+//# sourceMappingURL=fetchReleases.d.ts.map

package/lib/fetchReleases.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetchReleases.d.ts","sourceRoot":"","sources":["../src/fetchReleases.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,aAAa,EAAE,KAAK,MAAM,EAAE,MAAM,YAAY,CAAC;AAK7E;;;;;GAKG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CA8B1F"}

package/lib/fetchReleases.js

@@ -0,0 +1,47 @@
+import { ChangelogError } from "./types.js";
+const apiBase = 'https://api.github.com';
+const perPage = 100;
+/**
+ * Fetch all releases for a repository from the GitHub REST API, following pagination.
+ *
+ * If `token` is provided, it is sent as a bearer token; otherwise requests are made
+ * unauthenticated (and are subject to stricter rate limits).
+ */
+export async function fetchReleases(repo, token) {
+    const headers = {
+        Accept: 'application/vnd.github+json',
+        'X-GitHub-Api-Version': '2026-03-10',
+        'User-Agent': 'proper-changelog',
+    };
+    if (token) {
+        headers.Authorization = `Bearer ${token}`;
+    }
+    const releases = [];
+    let url = `${apiBase}/repos/${repo.owner}/${repo.repo}/releases?per_page=${perPage}`;
+    while (url) {
+        const response = await fetch(url, { headers });
+        if (!response.ok) {
+            const body = await response.text().catch(() => '');
+            throw new ChangelogError(`Failed to fetch releases for ${repo.owner}/${repo.repo}: ${response.status} ${response.statusText}` +
+                (body ? `\n${body}` : ''));
+        }
+        const page = (await response.json());
+        releases.push(...page);
+        url = getNextLink(response.headers.get('link'));
+    }
+    return releases;
+}
+/** Parse the `Link` response header and return the URL with `rel="next"`, if any. */
+function getNextLink(linkHeader) {
+    if (!linkHeader) {
+        return undefined;
+    }
+    for (const part of linkHeader.split(',')) {
+        const match = part.match(/<([^>]+)>;\s*rel="([^"]+)"/);
+        if (match?.[2] === 'next') {
+            return match[1];
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=fetchReleases.js.map

package/lib/fetchReleases.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetchReleases.js","sourceRoot":"","sources":["../src/fetchReleases.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAmC,MAAM,YAAY,CAAC;AAE7E,MAAM,OAAO,GAAG,wBAAwB,CAAC;AACzC,MAAM,OAAO,GAAG,GAAG,CAAC;AAEpB;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAAY,EAAE,KAAc;IAC9D,MAAM,OAAO,GAA2B;QACtC,MAAM,EAAE,6BAA6B;QACrC,sBAAsB,EAAE,YAAY;QACpC,YAAY,EAAE,kBAAkB;KACjC,CAAC;IACF,IAAI,KAAK,EAAE,CAAC;QACV,OAAO,CAAC,aAAa,GAAG,UAAU,KAAK,EAAE,CAAC;IAC5C,CAAC;IAED,MAAM,QAAQ,GAAoB,EAAE,CAAC;IACrC,IAAI,GAAG,GAAuB,GAAG,OAAO,UAAU,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,IAAI,sBAAsB,OAAO,EAAE,CAAC;IAEzG,OAAO,GAAG,EAAE,CAAC;QACX,MAAM,QAAQ,GAAa,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QACzD,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;YACnD,MAAM,IAAI,cAAc,CACtB,gCAAgC,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE;gBAClG,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAC5B,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAoB,CAAC;QACxD,QAAQ,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;QAEvB,GAAG,GAAG,WAAW,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;IAClD,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,qFAAqF;AACrF,SAAS,WAAW,CAAC,UAAyB;IAC5C,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QACzC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC;QACvD,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,MAAM,EAAE,CAAC;YAC1B,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/lib/parseArgs.d.ts

@@ -0,0 +1,9 @@
+import { type CliContext, type ProperChangelogOptions } from './types.ts';
+/**
+ * Parse the CLI arguments (`process.argv` by default), fetch the repo from `--package` if needed,
+ * and get the default token if needed.
+ *
+ * By default this will exit the program if an argument is invalid.
+ */
+export declare function parseArgs(context: Pick<CliContext, 'argv' | 'env' | 'exitOverride' | 'writeErr' | 'warn'>): Promise<ProperChangelogOptions>;
+//# sourceMappingURL=parseArgs.d.ts.map

package/lib/parseArgs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseArgs.d.ts","sourceRoot":"","sources":["../src/parseArgs.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,UAAU,EAAmB,KAAK,sBAAsB,EAA+B,MAAM,YAAY,CAAC;AAExH;;;;;GAKG;AACH,wBAAsB,SAAS,CAC7B,OAAO,EAAE,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,KAAK,GAAG,cAAc,GAAG,UAAU,GAAG,MAAM,CAAC,GAC/E,OAAO,CAAC,sBAAsB,CAAC,CAiDjC"}

package/lib/parseArgs.js

@@ -0,0 +1,87 @@
+import { Command, InvalidArgumentError, Option } from 'commander';
+import { resolveRepoFromPackage } from "./resolveRepoFromPackage.js";
+import { resolveToken } from "./resolveToken.js";
+import { ChangelogError } from "./types.js";
+/**
+ * Parse the CLI arguments (`process.argv` by default), fetch the repo from `--package` if needed,
+ * and get the default token if needed.
+ *
+ * By default this will exit the program if an argument is invalid.
+ */
+export async function parseArgs(context) {
+    const program = new Command()
+        .name('proper-changelog')
+        .description("Generate a single markdown changelog from a GitHub repository's releases.")
+        .addOption(new Option('--repo <owner/repo>', 'GitHub repository to read releases from (use this OR --package)')
+        .argParser(parseRepo)
+        .conflicts('package'))
+        .addOption(new Option('--package <name>', 'npm package whose GitHub repository should be used (use this OR --repo)').conflicts('repo'))
+        .addOption(new Option('-o, --out <file>', 'output file name (default: CHANGELOG-<package-or-repo>.md)').conflicts('stdout'))
+        .addOption(new Option('--stdout', 'write the changelog to stdout instead of a file').conflicts('out'))
+        .option('--token <token>', 'GitHub token (falls back to GITHUB_TOKEN/GH_TOKEN, then `gh auth token`)')
+        .option('--include-prereleases', 'include prerelease releases (drafts are always excluded)')
+        .option('--from <tag>', 'include releases up to and including this tag (based on date, not semver)')
+        .option('--to <tag>', 'include releases down to and including this tag (based on date, not semver)')
+        .option('--limit <n>', 'maximum number of releases to include', parseLimit)
+        .option('--filter <pattern>', 'only include releases whose tag matches this substring or /regex/', parseFilter)
+        .option('--since <date>', 'only include releases published after this date (e.g. 2024-01-01)', parseSince)
+        .allowExcessArguments(false);
+    context.exitOverride && program.exitOverride(context.exitOverride);
+    context.writeErr && program.configureOutput({ writeErr: context.writeErr });
+    const rawOptions = program.parse(context.argv ?? process.argv).opts();
+    let repo = rawOptions.repo;
+    if (rawOptions.package) {
+        repo = await resolveRepoFromPackage(rawOptions.package);
+    }
+    else if (!repo) {
+        throw new ChangelogError('Exactly one of --repo or --package is required.');
+    }
+    const token = await resolveToken(rawOptions.token, context.env);
+    if (!token) {
+        context.warn('Warning: no GitHub token found (checked --token, GITHUB_TOKEN/GH_TOKEN, and `gh auth token`). ' +
+            'Requests will be unauthenticated and may be rate-limited.');
+    }
+    return { ...rawOptions, repo, token };
+}
+/** Parse a `--repo` value in `owner/repo` form. */
+function parseRepo(value) {
+    const match = value.match(/^([^/\s]+)\/([^/\s]+)$/);
+    if (!match) {
+        throw new InvalidArgumentError(`Expected "owner/repo" but got "${value}".`);
+    }
+    return { owner: match[1], repo: match[2] };
+}
+/** Parse a `--limit` value as a positive integer. */
+function parseLimit(value) {
+    const parsed = Number(value);
+    if (!Number.isInteger(parsed) || parsed <= 0) {
+        throw new InvalidArgumentError(`Expected a positive integer but got "${value}".`);
+    }
+    return parsed;
+}
+/** Parse a `--since` value as a date. */
+function parseSince(value) {
+    const date = new Date(value);
+    if (Number.isNaN(date.getTime())) {
+        throw new InvalidArgumentError(`Expected a date but got "${value}".`);
+    }
+    return date;
+}
+/**
+ * Parse a `--filter` value. A value wrapped in slashes (optionally with trailing regex flags,
+ * e.g. `/^v1\./i`) is converted to a `RegExp`; any other value is returned as-is for a
+ * case-insensitive substring match.
+ */
+function parseFilter(value) {
+    const regexMatch = value.match(/^\/(.*)\/([a-z]*)$/s);
+    if (!regexMatch) {
+        return value;
+    }
+    try {
+        return new RegExp(regexMatch[1], regexMatch[2]);
+    }
+    catch (error) {
+        throw new InvalidArgumentError(`Invalid regular expression "${value}": ${error.message}`);
+    }
+}
+//# sourceMappingURL=parseArgs.js.map

package/lib/parseArgs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseArgs.js","sourceRoot":"","sources":["../src/parseArgs.ts"],"names":[],"mappings":"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"}

package/lib/renderChangelog.d.ts

@@ -0,0 +1,8 @@
+import { type SelectReleasesOptions } from './selectReleases.ts';
+import type { GitHubRelease, ProperChangelogOptions } from './types.ts';
+export type RenderChangelogOptions = SelectReleasesOptions & Pick<ProperChangelogOptions, 'package' | 'repo'>;
+/**
+ * Render a full markdown changelog from GitHub releases, applying the given options.
+ */
+export declare function renderChangelog(releases: GitHubRelease[], options: RenderChangelogOptions): string;
+//# sourceMappingURL=renderChangelog.d.ts.map

package/lib/renderChangelog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderChangelog.d.ts","sourceRoot":"","sources":["../src/renderChangelog.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AACjF,OAAO,KAAK,EAAE,aAAa,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAcxE,MAAM,MAAM,sBAAsB,GAAG,qBAAqB,GAAG,IAAI,CAAC,sBAAsB,EAAE,SAAS,GAAG,MAAM,CAAC,CAAC;AAE9G;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,aAAa,EAAE,EAAE,OAAO,EAAE,sBAAsB,GAAG,MAAM,CAUlG"}

package/lib/renderChangelog.js

@@ -0,0 +1,119 @@
+import { selectReleases } from "./selectReleases.js";
+const maxHeadingLevel = 6;
+/**
+ * Render a full markdown changelog from GitHub releases, applying the given options.
+ */
+export function renderChangelog(releases, options) {
+    const selected = selectReleases(releases, options);
+    const heading = `# Changelog - ${options.package || options.repo.repo}`;
+    if (selected.length === 0) {
+        return `${heading}\n\nNo releases found.\n`;
+    }
+    const sections = selected.map(renderRelease);
+    return `${heading}\n\n${sections.join('\n\n')}\n`;
+}
+/** Render a single release as a markdown section. */
+function renderRelease(release) {
+    const releaseName = release.name?.trim() || release.tag_name;
+    const bodyLines = (release.body ?? '').replace(/\r\n/g, '\n').split('\n');
+    const headings = parseHeadings(bodyLines);
+    // If the body has any h1, demote every heading by one level so the highest is h2.
+    const baseDemotion = headings.some(heading => heading.level === 1) ? 1 : 0;
+    // Headings that sit at level 2 after applying the base demotion.
+    const h2Headings = headings.filter(heading => heading.level + baseDemotion === 2);
+    let sectionHeading;
+    let demotion;
+    let promotedLineIndex;
+    if (h2Headings.length === 1) {
+        // Use the single h2 as the section heading (don't demote any other headings).
+        sectionHeading = `## ${formatSectionHeading(h2Headings[0].text, release.tag_name)}`;
+        demotion = baseDemotion;
+        promotedLineIndex = h2Headings[0].lineIndex;
+    }
+    else {
+        // No h2 (don't demote) or multiple h2s (demote everything one more level): use the
+        // release name as the section heading.
+        sectionHeading = `## ${formatSectionHeading(releaseName, release.tag_name)}`;
+        demotion = h2Headings.length > 1 ? baseDemotion + 1 : baseDemotion;
+    }
+    const lines = [sectionHeading, ''];
+    const date = formatDate(release.published_at);
+    const meta = [`Tag [\`${release.tag_name}\`](${release.html_url})`];
+    if (date) {
+        meta.push(`released ${date}`);
+    }
+    lines.push(`_${meta.join(' • ')}_`, '');
+    const body = transformBody(bodyLines, demotion, promotedLineIndex);
+    if (body) {
+        lines.push(body, '');
+    }
+    return lines.join('\n').trimEnd();
+}
+/**
+ * Build the section heading text from a candidate title (either a single h2 heading or the release
+ * name). If the title already references the version (the tag without a leading `v`), use it as-is;
+ * otherwise prefix it with the tag.
+ */
+function formatSectionHeading(title, tag) {
+    const tagWithoutV = tag.replace(/^v/, '');
+    return title.includes(tagWithoutV) ? title : `${tag} - ${title}`;
+}
+/** Format an ISO timestamp as `YYYY-MM-DD`, or return undefined if missing/invalid. */
+function formatDate(published) {
+    if (!published) {
+        return undefined;
+    }
+    const date = new Date(published);
+    return Number.isNaN(date.getTime()) ? undefined : date.toISOString().slice(0, 10);
+}
+/** Collect the ATX headings from body lines, ignoring headings inside fenced code blocks. */
+function parseHeadings(lines) {
+    const headings = [];
+    let inFence = false;
+    lines.forEach((line, lineIndex) => {
+        if (/^\s*(```|~~~)/.test(line)) {
+            inFence = !inFence;
+            return;
+        }
+        if (inFence) {
+            return;
+        }
+        const match = line.match(/^(#{1,6})\s+(.*\S)\s*$/);
+        if (match) {
+            headings.push({ lineIndex, level: match[1].length, text: match[2] });
+        }
+    });
+    return headings;
+}
+/**
+ * Rebuild a release body, demoting ATX headings by `demotion` levels (headings inside fenced
+ * code blocks are left alone) and optionally removing the heading promoted to the section heading.
+ */
+function transformBody(lines, demotion, promotedLineIndex) {
+    let inFence = false;
+    const out = [];
+    lines.forEach((line, lineIndex) => {
+        if (lineIndex === promotedLineIndex) {
+            return;
+        }
+        if (/^\s*(```|~~~)/.test(line)) {
+            inFence = !inFence;
+            out.push(line);
+            return;
+        }
+        if (!inFence && demotion > 0) {
+            const match = line.match(/^(#{1,6})(\s.*)$/);
+            if (match) {
+                const level = Math.min(match[1].length + demotion, maxHeadingLevel);
+                out.push('#'.repeat(level) + match[2]);
+                return;
+            }
+        }
+        out.push(line);
+    });
+    return out
+        .join('\n')
+        .replace(/\n{3,}/g, '\n\n')
+        .trim();
+}
+//# sourceMappingURL=renderChangelog.js.map

package/lib/renderChangelog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderChangelog.js","sourceRoot":"","sources":["../src/renderChangelog.ts"],"names":[],"mappings":"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"}

package/lib/resolveRepoFromPackage.d.ts

@@ -0,0 +1,18 @@
+import { type RepoId } from './types.ts';
+/** The `repository` field of an npm package manifest, in object form. */
+interface NpmRepository {
+    type?: string;
+    url?: string;
+    directory?: string;
+}
+/** Resolve the GitHub repository for an npm package from its latest published version. */
+export declare function resolveRepoFromPackage(packageName: string): Promise<RepoId>;
+/**
+ * Parse a GitHub `owner/repo` from an npm `repository` field. Only github.com is supported:
+ * github.com URLs (`git+https`, `https`, `git://`, `git@github.com:`) and the `github:`
+ * shorthand. Throws if the repository refers to any other host or can't be parsed.
+ * @internal Exported for testing
+ */
+export declare function _parseGitHubRepo(repository: NpmRepository | string | undefined, packageName: string): RepoId;
+export {};
+//# sourceMappingURL=resolveRepoFromPackage.d.ts.map

package/lib/resolveRepoFromPackage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveRepoFromPackage.d.ts","sourceRoot":"","sources":["../src/resolveRepoFromPackage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,MAAM,EAAE,MAAM,YAAY,CAAC;AAEzD,yEAAyE;AACzE,UAAU,aAAa;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AASD,0FAA0F;AAC1F,wBAAsB,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAiBjF;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,aAAa,GAAG,MAAM,GAAG,SAAS,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAkC5G"}

package/lib/resolveRepoFromPackage.js

@@ -0,0 +1,50 @@
+import { ChangelogError } from "./types.js";
+const registryBase = 'https://registry.npmjs.org';
+/** Resolve the GitHub repository for an npm package from its latest published version. */
+export async function resolveRepoFromPackage(packageName) {
+    // Encode the package name for the URL path. The leading `@` in scoped names is allowed
+    // unencoded, but the `/` separator must be encoded.
+    const encodedName = packageName.startsWith('@')
+        ? `@${encodeURIComponent(packageName.slice(1))}`
+        : encodeURIComponent(packageName);
+    const url = `${registryBase}/${encodedName}/latest`;
+    const response = await fetch(url, { headers: { Accept: 'application/json' } });
+    if (!response.ok) {
+        throw new ChangelogError(`Failed to look up npm package "${packageName}": ${response.status} ${response.statusText}`);
+    }
+    const manifest = (await response.json());
+    return _parseGitHubRepo(manifest.repository, packageName);
+}
+/**
+ * Parse a GitHub `owner/repo` from an npm `repository` field. Only github.com is supported:
+ * github.com URLs (`git+https`, `https`, `git://`, `git@github.com:`) and the `github:`
+ * shorthand. Throws if the repository refers to any other host or can't be parsed.
+ * @internal Exported for testing
+ */
+export function _parseGitHubRepo(repository, packageName) {
+    const raw = typeof repository === 'string' ? repository : repository?.url;
+    if (!raw) {
+        throw new ChangelogError(`npm package "${packageName}" does not specify a repository.`);
+    }
+    // `github:owner/repo` shorthand always refers to github.com.
+    const shorthandMatch = raw.match(/^github:([^/#]+)\/([^/#]+?)(?:\.git)?(?:#.*)?$/);
+    if (shorthandMatch) {
+        return { owner: shorthandMatch[1], repo: shorthandMatch[2] };
+    }
+    // A bare `owner/repo` string shorthand also defaults to github.com.
+    const bareMatch = raw.match(/^([^/#:]+)\/([^/#]+?)(?:\.git)?(?:#.*)?$/);
+    if (bareMatch) {
+        return { owner: bareMatch[1], repo: bareMatch[2] };
+    }
+    // Any other host shorthand (e.g. `gitlab:`/`bitbucket:`) is unsupported.
+    if (/^\w+:[^/]+\/[^/]+$/i.test(raw) && !raw.startsWith('github:')) {
+        throw new ChangelogError(`npm package "${packageName}" repository is "${raw}" which does not appear to be on github.com`);
+    }
+    // URL forms: https, git+https, git://, ssh (git@github.com:owner/repo).
+    const urlMatch = raw.match(/github\.com[/:]([^/#]+)\/([^/#]+?)(?:\.git)?(?:#.*)?$/);
+    if (urlMatch) {
+        return { owner: urlMatch[1], repo: urlMatch[2] };
+    }
+    throw new ChangelogError(`npm package "${packageName}" repository is "${raw}" which does not appear to be on github.com`);
+}
+//# sourceMappingURL=resolveRepoFromPackage.js.map

package/lib/resolveRepoFromPackage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveRepoFromPackage.js","sourceRoot":"","sources":["../src/resolveRepoFromPackage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAe,MAAM,YAAY,CAAC;AAczD,MAAM,YAAY,GAAG,4BAA4B,CAAC;AAElD,0FAA0F;AAC1F,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,WAAmB;IAC9D,uFAAuF;IACvF,oDAAoD;IACpD,MAAM,WAAW,GAAG,WAAW,CAAC,UAAU,CAAC,GAAG,CAAC;QAC7C,CAAC,CAAC,IAAI,kBAAkB,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE;QAChD,CAAC,CAAC,kBAAkB,CAAC,WAAW,CAAC,CAAC;IAEpC,MAAM,GAAG,GAAG,GAAG,YAAY,IAAI,WAAW,SAAS,CAAC;IACpD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE,EAAE,CAAC,CAAC;IAC/E,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,cAAc,CACtB,kCAAkC,WAAW,MAAM,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CAC5F,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAgB,CAAC;IACxD,OAAO,gBAAgB,CAAC,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;AAC5D,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,UAA8C,EAAE,WAAmB;IAClG,MAAM,GAAG,GAAG,OAAO,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,EAAE,GAAG,CAAC;IAC1E,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,cAAc,CAAC,gBAAgB,WAAW,kCAAkC,CAAC,CAAC;IAC1F,CAAC;IAED,6DAA6D;IAC7D,MAAM,cAAc,GAAG,GAAG,CAAC,KAAK,CAAC,gDAAgD,CAAC,CAAC;IACnF,IAAI,cAAc,EAAE,CAAC;QACnB,OAAO,EAAE,KAAK,EAAE,cAAc,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC;IAC/D,CAAC;IAED,oEAAoE;IACpE,MAAM,SAAS,GAAG,GAAG,CAAC,KAAK,CAAC,0CAA0C,CAAC,CAAC;IACxE,IAAI,SAAS,EAAE,CAAC;QACd,OAAO,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;IACrD,CAAC;IAED,yEAAyE;IACzE,IAAI,qBAAqB,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAClE,MAAM,IAAI,cAAc,CACtB,gBAAgB,WAAW,oBAAoB,GAAG,6CAA6C,CAChG,CAAC;IACJ,CAAC;IAED,wEAAwE;IACxE,MAAM,QAAQ,GAAG,GAAG,CAAC,KAAK,CAAC,uDAAuD,CAAC,CAAC;IACpF,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;IACnD,CAAC;IAED,MAAM,IAAI,cAAc,CACtB,gBAAgB,WAAW,oBAAoB,GAAG,6CAA6C,CAChG,CAAC;AACJ,CAAC"}

package/lib/resolveToken.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Resolve a GitHub auth token, in priority order:
+ * 1. The explicitly provided token (e.g. from `--token`).
+ * 2. The `GITHUB_TOKEN` or `GH_TOKEN` environment variables.
+ * 3. The output of `gh auth token` (if the GitHub CLI is installed and authenticated).
+ *
+ * Returns `undefined` if no token could be resolved.
+ */
+export declare function resolveToken(explicitToken: string | undefined, env: NodeJS.ProcessEnv): Promise<string | undefined>;
+//# sourceMappingURL=resolveToken.d.ts.map

package/lib/resolveToken.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveToken.d.ts","sourceRoot":"","sources":["../src/resolveToken.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAChC,aAAa,EAAE,MAAM,GAAG,SAAS,EACjC,GAAG,EAAE,MAAM,CAAC,UAAU,GACrB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAiB7B"}

package/lib/resolveToken.js

@@ -0,0 +1,27 @@
+import spawn from 'nano-spawn';
+/**
+ * Resolve a GitHub auth token, in priority order:
+ * 1. The explicitly provided token (e.g. from `--token`).
+ * 2. The `GITHUB_TOKEN` or `GH_TOKEN` environment variables.
+ * 3. The output of `gh auth token` (if the GitHub CLI is installed and authenticated).
+ *
+ * Returns `undefined` if no token could be resolved.
+ */
+export async function resolveToken(explicitToken, env) {
+    if (explicitToken) {
+        return explicitToken;
+    }
+    const envToken = env.GITHUB_TOKEN || env.GH_TOKEN;
+    if (envToken) {
+        return envToken;
+    }
+    try {
+        const { stdout } = await spawn('gh', ['auth', 'token']);
+        return stdout.trim() || undefined;
+    }
+    catch {
+        // gh not installed or not authenticated; fall through to unauthenticated.
+        return undefined;
+    }
+}
+//# sourceMappingURL=resolveToken.js.map

package/lib/resolveToken.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveToken.js","sourceRoot":"","sources":["../src/resolveToken.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,YAAY,CAAC;AAE/B;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,aAAiC,EACjC,GAAsB;IAEtB,IAAI,aAAa,EAAE,CAAC;QAClB,OAAO,aAAa,CAAC;IACvB,CAAC;IAED,MAAM,QAAQ,GAAG,GAAG,CAAC,YAAY,IAAI,GAAG,CAAC,QAAQ,CAAC;IAClD,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;QACxD,OAAO,MAAM,CAAC,IAAI,EAAE,IAAI,SAAS,CAAC;IACpC,CAAC;IAAC,MAAM,CAAC;QACP,0EAA0E;QAC1E,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC"}

package/lib/selectReleases.d.ts

@@ -0,0 +1,9 @@
+import { type GitHubRelease, type ProperChangelogOptions } from './types.ts';
+export type SelectReleasesOptions = Pick<ProperChangelogOptions, 'includePrereleases' | 'filter' | 'since' | 'from' | 'to' | 'limit'>;
+/**
+ * Filter, sort, and slice releases according to the provided options.
+ * Draft releases are always excluded; prereleases are excluded unless `includePrereleases`.
+ * Releases are returned newest-first by published date.
+ */
+export declare function selectReleases(releases: GitHubRelease[], options: SelectReleasesOptions): GitHubRelease[];
+//# sourceMappingURL=selectReleases.d.ts.map

package/lib/selectReleases.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selectReleases.d.ts","sourceRoot":"","sources":["../src/selectReleases.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,aAAa,EAAE,KAAK,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAE7F,MAAM,MAAM,qBAAqB,GAAG,IAAI,CACtC,sBAAsB,EACtB,oBAAoB,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,IAAI,GAAG,OAAO,CACpE,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,aAAa,EAAE,EAAE,OAAO,EAAE,qBAAqB,GAAG,aAAa,EAAE,CA0CzG"}

package/lib/selectReleases.js

@@ -0,0 +1,62 @@
+import { ChangelogError } from "./types.js";
+/**
+ * Filter, sort, and slice releases according to the provided options.
+ * Draft releases are always excluded; prereleases are excluded unless `includePrereleases`.
+ * Releases are returned newest-first by published date.
+ */
+export function selectReleases(releases, options) {
+    let selected = releases.filter(release => !release.draft);
+    if (!options.includePrereleases) {
+        selected = selected.filter(release => !release.prerelease);
+    }
+    if (options.filter) {
+        const matchesTag = makeTagMatcher(options.filter);
+        selected = selected.filter(release => matchesTag(release.tag_name));
+    }
+    if (options.since) {
+        const sinceTime = options.since.getTime();
+        selected = selected.filter(release => {
+            const time = release.published_at ? new Date(release.published_at).getTime() : NaN;
+            return !Number.isNaN(time) && time > sinceTime;
+        });
+    }
+    selected.sort((a, b) => {
+        const aTime = (a.published_at && Date.parse(a.published_at)) || 0;
+        const bTime = (b.published_at && Date.parse(b.published_at)) || 0;
+        return bTime - aTime;
+    });
+    // Apply the `from`/`to` tag range (inclusive, order-independent).
+    if (options.from || options.to) {
+        const bounds = [
+            options.from !== undefined ? indexOfTag(selected, options.from) : 0,
+            options.to !== undefined ? indexOfTag(selected, options.to) : selected.length - 1,
+        ];
+        const start = Math.min(...bounds);
+        const end = Math.max(...bounds);
+        selected = selected.slice(start, end + 1);
+    }
+    if (options.limit !== undefined && options.limit >= 0) {
+        selected = selected.slice(0, options.limit);
+    }
+    return selected;
+}
+/** Find the index of a release by tag name, throwing a helpful error if not found. */
+function indexOfTag(releases, tag) {
+    const index = releases.findIndex(release => release.tag_name === tag);
+    if (index === -1) {
+        throw new ChangelogError(`No release found with tag "${tag}".`);
+    }
+    return index;
+}
+/**
+ * Build a tag-matching predicate from a filter. A `RegExp` matches tags that satisfy it;
+ * a string matches tags that contain it (case-insensitive).
+ */
+function makeTagMatcher(filter) {
+    if (filter instanceof RegExp) {
+        return tag => filter.test(tag);
+    }
+    const needle = filter.toLowerCase();
+    return tag => tag.toLowerCase().includes(needle);
+}
+//# sourceMappingURL=selectReleases.js.map

package/lib/selectReleases.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"selectReleases.js","sourceRoot":"","sources":["../src/selectReleases.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAmD,MAAM,YAAY,CAAC;AAO7F;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,QAAyB,EAAE,OAA8B;IACtF,IAAI,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAE1D,IAAI,CAAC,OAAO,CAAC,kBAAkB,EAAE,CAAC;QAChC,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAC7D,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACnB,MAAM,UAAU,GAAG,cAAc,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAClD,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;IACtE,CAAC;IAED,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;QAC1C,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE;YACnC,MAAM,IAAI,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;YACnF,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,SAAS,CAAC;QACjD,CAAC,CAAC,CAAC;IACL,CAAC;IAED,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACrB,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,YAAY,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,CAAC;QAClE,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,YAAY,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,CAAC;QAClE,OAAO,KAAK,GAAG,KAAK,CAAC;IACvB,CAAC,CAAC,CAAC;IAEH,kEAAkE;IAClE,IAAI,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,EAAE,EAAE,CAAC;QAC/B,MAAM,MAAM,GAAG;YACb,OAAO,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,QAAQ,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;YACnE,OAAO,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC;SAClF,CAAC;QACF,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC;QAClC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC;QAChC,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC;IAC5C,CAAC;IAED,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,IAAI,OAAO,CAAC,KAAK,IAAI,CAAC,EAAE,CAAC;QACtD,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IAC9C,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,sFAAsF;AACtF,SAAS,UAAU,CAAC,QAAyB,EAAE,GAAW;IACxD,MAAM,KAAK,GAAG,QAAQ,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,QAAQ,KAAK,GAAG,CAAC,CAAC;IACtE,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;QACjB,MAAM,IAAI,cAAc,CAAC,8BAA8B,GAAG,IAAI,CAAC,CAAC;IAClE,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,SAAS,cAAc,CAAC,MAAuB;IAC7C,IAAI,MAAM,YAAY,MAAM,EAAE,CAAC;QAC7B,OAAO,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACjC,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;IACpC,OAAO,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;AACnD,CAAC"}

package/lib/types.d.ts

@@ -0,0 +1,56 @@
+import type { components } from '@octokit/openapi-types';
+import type { CommanderError, OutputConfiguration } from 'commander';
+/** A GitHub release as returned by the REST API (`GET /repos/{owner}/{repo}/releases`). */
+export type GitHubRelease = components['schemas']['release'];
+/** Parsed `owner/repo` identifier. */
+export interface RepoId {
+    owner: string;
+    repo: string;
+}
+/** Options as returned by `program.parse().opts()`. */
+export interface CliOptions {
+    /** Repository to read releases from. */
+    repo?: RepoId;
+    /** npm package name the repo was resolved from, if any (used for the changelog heading/filename). */
+    package?: string;
+    /** Auth token for the GitHub API (optional; requests are rate-limited without one). */
+    token?: string;
+    /** Include prerelease releases (default: false). Draft releases are always excluded. */
+    includePrereleases?: boolean;
+    /** Only include releases up to and including this tag (most recent bound). */
+    from?: string;
+    /** Only include releases down to and including this tag (oldest bound). */
+    to?: string;
+    /** Maximum number of releases to include. */
+    limit?: number;
+    /**
+     * Filter releases by tag name. A string matches tags that contain it (case-insensitive);
+     * a `RegExp` matches tags that satisfy it. (The CLI converts a value wrapped in slashes,
+     * e.g. `/^v1\./i`, into a `RegExp`.)
+     */
+    filter?: string | RegExp;
+    /** Only include releases published after this date. */
+    since?: Date;
+    /** Write output to this file */
+    out?: string;
+    /** If true, write to stdout instead of a file */
+    stdout?: boolean;
+}
+/** Options controlling changelog generation. */
+export type ProperChangelogOptions = Required<Pick<CliOptions, 'repo'>> & CliOptions;
+export interface CliContext {
+    argv: string[];
+    env: NodeJS.ProcessEnv;
+    /** Commander error handler */
+    exitOverride?: (err: CommanderError) => never | void;
+    /** Commander error logging handler */
+    writeErr?: OutputConfiguration['writeErr'];
+    log: (message: string) => void;
+    warn: (message: string) => void;
+    writeFile: (file: string, content: string) => void;
+}
+/** Throw this to indicate an expected error (stack won't be logged) */
+export declare class ChangelogError extends Error {
+    name: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/lib/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAErE,2FAA2F;AAC3F,MAAM,MAAM,aAAa,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,CAAC;AAE7D,sCAAsC;AACtC,MAAM,WAAW,MAAM;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,uDAAuD;AACvD,MAAM,WAAW,UAAU;IACzB,wCAAwC;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qGAAqG;IACrG,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uFAAuF;IACvF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wFAAwF;IACxF,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,8EAA8E;IAC9E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2EAA2E;IAC3E,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,6CAA6C;IAC7C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,uDAAuD;IACvD,KAAK,CAAC,EAAE,IAAI,CAAC;IACb,gCAAgC;IAChC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,iDAAiD;IACjD,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,gDAAgD;AAChD,MAAM,MAAM,sBAAsB,GAAG,QAAQ,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,GAAG,UAAU,CAAC;AAErF,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IACvB,8BAA8B;IAC9B,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,KAAK,GAAG,IAAI,CAAC;IACrD,sCAAsC;IACtC,QAAQ,CAAC,EAAE,mBAAmB,CAAC,UAAU,CAAC,CAAC;IAC3C,GAAG,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACpD;AAED,uEAAuE;AACvE,qBAAa,cAAe,SAAQ,KAAK;IACvC,IAAI,SAAoB;CACzB"}

package/lib/types.js

@@ -0,0 +1,5 @@
+/** Throw this to indicate an expected error (stack won't be logged) */
+export class ChangelogError extends Error {
+    name = 'ChangelogError';
+}
+//# sourceMappingURL=types.js.map

package/lib/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAyDA,uEAAuE;AACvE,MAAM,OAAO,cAAe,SAAQ,KAAK;IACvC,IAAI,GAAG,gBAAgB,CAAC;CACzB"}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "proper-changelog",
+  "version": "0.1.0",
+  "description": "Make a readable changelog from GitHub releases",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/microsoft/beachball",
+    "directory": "packages/proper-changelog"
+  },
+  "license": "MIT",
+  "exports": {
+    ".": null
+  },
+  "bin": "./bin/proper-changelog.js",
+  "engines": {
+    "node": ">=22.18.0"
+  },
+  "files": [
+    "bin",
+    "lib/!(__*)",
+    "lib/!(__*)/**/*"
+  ],
+  "scripts": {
+    "build": "yarn run -T tsc --pretty",
+    "depcheck": "yarn run -T depcheck .",
+    "lint": "yarn run -T eslint --color --max-warnings=0 src",
+    "test": "cross-env NODE_OPTIONS='--experimental-vm-modules' yarn run -T jest",
+    "update-snapshots": "yarn test -u"
+  },
+  "devDependencies": {
+    "@microsoft/beachball-scripts": "workspace:^",
+    "@octokit/openapi-types": "^27.0.0",
+    "cross-env": "^10.1.0"
+  },
+  "dependencies": {
+    "commander": "^15.0.0",
+    "nano-spawn": "^2.1.0"
+  }
+}