@release-change/release-notes-generator 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025-present Victor Brito
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,15 @@
+# @release-change/release-notes-generator
+
+Functions used internally in release-change to prepare and generate release notes
+
+![License: MIT](https://img.shields.io/github/license/release-change/release-change)
+[![ESM-only package](https://img.shields.io/badge/package-ESM--only-ffe536)](https://nodejs.org/api/esm.html)
+[![Conventional Commits 1.0.0](https://img.shields.io/badge/Conventional%20Commits-1.0.0-%23FE5196?logo=conventionalcommits&logoColor=white)](https://conventionalcommits.org)
+[![Formatted with Biome](https://img.shields.io/badge/Formatted_with-Biome-60a5fa?style=flat&logo=biome)](https://biomejs.dev/)
+![NPM latest version](https://img.shields.io/npm/v/%40release-change%2Frelease-notes-generator/latest)
+![Node support](https://img.shields.io/node/v/%40release-change%2Frelease-notes-generator)
+![Build status](https://img.shields.io/github/actions/workflow/status/release-change/release-change/run-tests.yml)
+
+## Copyright & licence
+
+© 2025-present Victor Brito — Released under the [MIT licence](./LICENSE).

package/dist/create-changelog-file.d.ts

@@ -0,0 +1,9 @@
+import type { ReleaseNotes } from "./release-notes-generator.types.js";
+/**
+ * Creates a `CHANGELOG.md` file.
+ * @param changelogFilePath - The path to the new changelog file.
+ * @param header - The changelog file header to use.
+ * @param releaseNotesBody - The release notes body to format.
+ */
+export declare const createChangelogFile: (changelogFilePath: string, header: string, releaseNotesBody: ReleaseNotes["body"]) => void;
+//# sourceMappingURL=create-changelog-file.d.ts.map

package/dist/create-changelog-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-changelog-file.d.ts","sourceRoot":"","sources":["../src/create-changelog-file.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAMvE;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,GAC9B,mBAAmB,MAAM,EACzB,QAAQ,MAAM,EACd,kBAAkB,YAAY,CAAC,MAAM,CAAC,KACrC,IAIF,CAAC"}

package/dist/create-changelog-file.js

@@ -0,0 +1,14 @@
+import fs from "node:fs";
+import { formatReleaseNotesBody } from "./format-release-notes-body.js";
+/**
+ * Creates a `CHANGELOG.md` file.
+ * @param changelogFilePath - The path to the new changelog file.
+ * @param header - The changelog file header to use.
+ * @param releaseNotesBody - The release notes body to format.
+ */
+export const createChangelogFile = (changelogFilePath, header, releaseNotesBody) => {
+    const formattedReleaseNotesBody = formatReleaseNotesBody(releaseNotesBody, true);
+    const newFileData = header + formattedReleaseNotesBody;
+    fs.writeFileSync(changelogFilePath, newFileData);
+};
+//# sourceMappingURL=create-changelog-file.js.map

package/dist/create-changelog-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-changelog-file.js","sourceRoot":"","sources":["../src/create-changelog-file.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,SAAS,CAAC;AAEzB,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAExE;;;;;GAKG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CACjC,iBAAyB,EACzB,MAAc,EACd,gBAAsC,EAChC,EAAE;IACR,MAAM,yBAAyB,GAAG,sBAAsB,CAAC,gBAAgB,EAAE,IAAI,CAAC,CAAC;IACjF,MAAM,WAAW,GAAG,MAAM,GAAG,yBAAyB,CAAC;IACvD,EAAE,CAAC,aAAa,CAAC,iBAAiB,EAAE,WAAW,CAAC,CAAC;AACnD,CAAC,CAAC"}

package/dist/create-release-notes.d.ts

@@ -0,0 +1,9 @@
+import type { Context } from "@release-change/shared";
+import type { ReleaseNotes } from "./release-notes-generator.types.js";
+/**
+ * Creates release notes on GitHub from the prepared notes.
+ * @param releaseNotes - The prepared release notes to use.
+ * @param context - The context where the CLI is running.
+ */
+export declare const createReleaseNotes: (releaseNotes: ReleaseNotes, context: Context) => Promise<void>;
+//# sourceMappingURL=create-release-notes.d.ts.map

package/dist/create-release-notes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-release-notes.d.ts","sourceRoot":"","sources":["../src/create-release-notes.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAqB,MAAM,wBAAwB,CAAC;AACzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAWvE;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,GAC7B,cAAc,YAAY,EAC1B,SAAS,OAAO,KACf,OAAO,CAAC,IAAI,CA4Ed,CAAC"}

package/dist/create-release-notes.js

@@ -0,0 +1,88 @@
+import { inspect } from "node:util";
+import { getReleaseToken } from "@release-change/ci";
+import { getRepositoryRelatedEntryPoint } from "@release-change/github";
+import { setLogger } from "@release-change/logger";
+import { formatDetailedError } from "@release-change/shared";
+import { formatReleaseNotesBody } from "./format-release-notes-body.js";
+/**
+ * Creates release notes on GitHub from the prepared notes.
+ * @param releaseNotes - The prepared release notes to use.
+ * @param context - The context where the CLI is running.
+ */
+export const createReleaseNotes = async (releaseNotes, context) => {
+    const { tagName, target, isPrerelease, body } = releaseNotes;
+    const { env, config } = context;
+    const { debug, repositoryUrl } = config;
+    const logger = setLogger(debug);
+    logger.setScope("release-notes-generator");
+    const releaseToken = getReleaseToken(env);
+    const uri = `${getRepositoryRelatedEntryPoint(repositoryUrl)}/releases`;
+    const requestBody = {
+        tag_name: tagName,
+        target_commitish: target,
+        name: tagName,
+        prerelease: isPrerelease,
+        make_latest: String(!isPrerelease),
+        body: formatReleaseNotesBody(body)
+    };
+    const releaseNotesResponse = await fetch(uri, {
+        method: "POST",
+        headers: {
+            Accept: "application/vnd.github+json",
+            Authorization: `Bearer ${releaseToken}`,
+            "Content-Type": "application/json",
+            "X-GitHub-Api-Version": "2022-11-28"
+        },
+        body: JSON.stringify(requestBody)
+    });
+    const { headers, status, statusText } = releaseNotesResponse;
+    const releaseNotesResponseData = releaseNotesResponse.json();
+    if (debug) {
+        logger.setDebugScope("release-notes-generator:create-release-notes");
+        logger.logDebug(`Release notes: ${inspect(releaseNotes, { depth: Number.POSITIVE_INFINITY })}`);
+        logger.logDebug(`API entry point: ${uri}`);
+        logger.logDebug(`Request body: ${inspect(requestBody, { depth: Number.POSITIVE_INFINITY })}`);
+        logger.logDebug(`Response status: ${status}`);
+        logger.logDebug(`Response status text: ${statusText}`);
+        logger.logDebug(`Response headers: ${inspect(headers, { depth: Number.POSITIVE_INFINITY })}`);
+        logger.logDebug(`Response JSON: ${inspect(await releaseNotesResponseData, { depth: Number.POSITIVE_INFINITY })}`);
+    }
+    if (status === 201) {
+        logger.logSuccess(`Created release notes for Git tag ${tagName}.`);
+        const releaseInfo = {
+            type: "github",
+            name: "GitHub release",
+            url: `${repositoryUrl.replace(".git", "")}/releases/tag/${tagName}`
+        };
+        context.releaseInfos.push(releaseInfo);
+        if (debug) {
+            logger.logDebug("context.releaseInfos:");
+            logger.logDebug(inspect(context.releaseInfos, { depth: Number.POSITIVE_INFINITY }));
+        }
+    }
+    else {
+        const responseError = await releaseNotesResponseData;
+        const { message, documentation_url: documentationUrl } = responseError;
+        const documentationReference = documentationUrl ? ` See ${documentationUrl}.` : "";
+        logger.logError(`Failed to create release notes for Git tag ${tagName}.`);
+        if (status === 404) {
+            process.exitCode = 404;
+            throw formatDetailedError({
+                title: "Failed to create the release notes",
+                message: `Failed to fetch URI ${uri}.`,
+                details: {
+                    output: `status: ${status}`
+                }
+            });
+        }
+        process.exitCode = status;
+        throw formatDetailedError({
+            title: "Failed to create the release notes",
+            message: `${message}${documentationReference}`,
+            details: {
+                output: `status: ${status}`
+            }
+        });
+    }
+};
+//# sourceMappingURL=create-release-notes.js.map

package/dist/create-release-notes.js.map

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

package/dist/format-list-item.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Formats a list item in Markdown format from a string.
+ * @param item - The item to use.
+ * @return The item formatted as a list item in Markdown format.
+ */
+export declare const formatListItem: (item: string) => string;
+//# sourceMappingURL=format-list-item.d.ts.map

package/dist/format-list-item.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-list-item.d.ts","sourceRoot":"","sources":["../src/format-list-item.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,cAAc,GAAI,MAAM,MAAM,KAAG,MAAqB,CAAC"}

package/dist/format-list-item.js

@@ -0,0 +1,7 @@
+/**
+ * Formats a list item in Markdown format from a string.
+ * @param item - The item to use.
+ * @return The item formatted as a list item in Markdown format.
+ */
+export const formatListItem = (item) => `- ${item}`;
+//# sourceMappingURL=format-list-item.js.map

package/dist/format-list-item.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-list-item.js","sourceRoot":"","sources":["../src/format-list-item.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,IAAY,EAAU,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC"}

package/dist/format-release-notes-body.d.ts

@@ -0,0 +1,15 @@
+import type { ReleaseNotes } from "./release-notes-generator.types.js";
+/**
+ * Formats the release notes body in Markdown format.
+ *
+ * The release notes body should have at least one of the following properties to be formatted:
+ * - `major`,
+ * - `minor`,
+ * - `patch`,
+ * - `dependencies`.
+ * @param releaseNotesBody - The release notes body to format.
+ * @param [isReleaseNotesBodyForChangelog] - Whether the release notes body is for the `CHANGELOG.md` file or not.
+ * @return The formatted release notes body as a string.
+ */
+export declare const formatReleaseNotesBody: (releaseNotesBody: ReleaseNotes["body"], isReleaseNotesBodyForChangelog?: boolean) => string;
+//# sourceMappingURL=format-release-notes-body.d.ts.map

package/dist/format-release-notes-body.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-release-notes-body.d.ts","sourceRoot":"","sources":["../src/format-release-notes-body.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAIvE;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,sBAAsB,GACjC,kBAAkB,YAAY,CAAC,MAAM,CAAC,EACtC,wCAAsC,KACrC,MA6BF,CAAC"}

package/dist/format-release-notes-body.js

@@ -0,0 +1,44 @@
+import { formatListItem } from "./format-list-item.js";
+/**
+ * Formats the release notes body in Markdown format.
+ *
+ * The release notes body should have at least one of the following properties to be formatted:
+ * - `major`,
+ * - `minor`,
+ * - `patch`,
+ * - `dependencies`.
+ * @param releaseNotesBody - The release notes body to format.
+ * @param [isReleaseNotesBodyForChangelog] - Whether the release notes body is for the `CHANGELOG.md` file or not.
+ * @return The formatted release notes body as a string.
+ */
+export const formatReleaseNotesBody = (releaseNotesBody, isReleaseNotesBodyForChangelog = false) => {
+    const { major, minor, patch, dependencies, changelog } = releaseNotesBody;
+    const hasChanges = major || minor || patch || dependencies;
+    if (hasChanges) {
+        const headingLevel = isReleaseNotesBodyForChangelog ? "###" : "##";
+        const majorChangesSection = major?.length
+            ? `${headingLevel} Major changes\n\n${major.map(formatListItem).join("\n")}\n`
+            : "";
+        const minorChangesSection = minor?.length
+            ? `${headingLevel} Minor changes\n\n${minor.map(formatListItem).join("\n")}\n`
+            : "";
+        const patchChangesSection = patch?.length
+            ? `${headingLevel} Patch changes\n\n${patch.map(formatListItem).join("\n")}\n`
+            : "";
+        const dependenciesUpdatesSection = dependencies?.length
+            ? `${headingLevel} Dependencies updates\n\n${dependencies.map(formatListItem).join("\n")}\n`
+            : "";
+        const fullChangelogSection = changelog ? `---\n\n${changelog}\n` : "";
+        return [
+            majorChangesSection,
+            minorChangesSection,
+            patchChangesSection,
+            dependenciesUpdatesSection,
+            fullChangelogSection
+        ]
+            .filter(Boolean)
+            .join("\n");
+    }
+    return "";
+};
+//# sourceMappingURL=format-release-notes-body.js.map

package/dist/format-release-notes-body.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-release-notes-body.js","sourceRoot":"","sources":["../src/format-release-notes-body.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CACpC,gBAAsC,EACtC,8BAA8B,GAAG,KAAK,EAC9B,EAAE;IACV,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,GAAG,gBAAgB,CAAC;IAC1E,MAAM,UAAU,GAAG,KAAK,IAAI,KAAK,IAAI,KAAK,IAAI,YAAY,CAAC;IAC3D,IAAI,UAAU,EAAE,CAAC;QACf,MAAM,YAAY,GAAG,8BAA8B,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;QACnE,MAAM,mBAAmB,GAAG,KAAK,EAAE,MAAM;YACvC,CAAC,CAAC,GAAG,YAAY,qBAAqB,KAAK,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;YAC9E,CAAC,CAAC,EAAE,CAAC;QACP,MAAM,mBAAmB,GAAG,KAAK,EAAE,MAAM;YACvC,CAAC,CAAC,GAAG,YAAY,qBAAqB,KAAK,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;YAC9E,CAAC,CAAC,EAAE,CAAC;QACP,MAAM,mBAAmB,GAAG,KAAK,EAAE,MAAM;YACvC,CAAC,CAAC,GAAG,YAAY,qBAAqB,KAAK,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;YAC9E,CAAC,CAAC,EAAE,CAAC;QACP,MAAM,0BAA0B,GAAG,YAAY,EAAE,MAAM;YACrD,CAAC,CAAC,GAAG,YAAY,4BAA4B,YAAY,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;YAC5F,CAAC,CAAC,EAAE,CAAC;QACP,MAAM,oBAAoB,GAAG,SAAS,CAAC,CAAC,CAAC,UAAU,SAAS,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QACtE,OAAO;YACL,mBAAmB;YACnB,mBAAmB;YACnB,mBAAmB;YACnB,0BAA0B;YAC1B,oBAAoB;SACrB;aACE,MAAM,CAAC,OAAO,CAAC;aACf,IAAI,CAAC,IAAI,CAAC,CAAC;IAChB,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export type { ReleaseNotes } from "./release-notes-generator.types.js";
+export { createReleaseNotes } from "./create-release-notes.js";
+export { prepareReleaseNotes } from "./prepare-release-notes.js";
+export { updateChangelogFile } from "./update-changelog-file.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAEvE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { createReleaseNotes } from "./create-release-notes.js";
+export { prepareReleaseNotes } from "./prepare-release-notes.js";
+export { updateChangelogFile } from "./update-changelog-file.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/prepare-release-notes.d.ts

@@ -0,0 +1,13 @@
+import type { Context, PackageNextRelease } from "@release-change/shared";
+import type { ReleaseNotes } from "./release-notes-generator.types.js";
+/**
+ * Prepares the release notes for a package.
+ *
+ * In a monorepo context, the release notes for the root package are prepared considering all other internal packages.
+ * @param packageNextRelease - The next release data to use.
+ * @param packageDependencies - The package internal dependencies.
+ * @param context - The context where the CLI is running.
+ * @return The release notes for the package.
+ */
+export declare const prepareReleaseNotes: (packageNextRelease: PackageNextRelease, packageDependencies: string[] | null, context: Context) => ReleaseNotes;
+//# sourceMappingURL=prepare-release-notes.d.ts.map

package/dist/prepare-release-notes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prepare-release-notes.d.ts","sourceRoot":"","sources":["../src/prepare-release-notes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC1E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAQvE;;;;;;;;GAQG;AACH,eAAO,MAAM,mBAAmB,GAC9B,oBAAoB,kBAAkB,EACtC,qBAAqB,MAAM,EAAE,GAAG,IAAI,EACpC,SAAS,OAAO,KACf,YA4HF,CAAC"}

package/dist/prepare-release-notes.js

@@ -0,0 +1,136 @@
+import { inspect } from "node:util";
+import { COMMIT_ABBREVIATED_SHA_LENGTH, COMMIT_MESSAGE } from "@release-change/commit-analyser";
+import { setLogger } from "@release-change/logger";
+import { formatDetailedError } from "@release-change/shared";
+/**
+ * Prepares the release notes for a package.
+ *
+ * In a monorepo context, the release notes for the root package are prepared considering all other internal packages.
+ * @param packageNextRelease - The next release data to use.
+ * @param packageDependencies - The package internal dependencies.
+ * @param context - The context where the CLI is running.
+ * @return The release notes for the package.
+ */
+export const prepareReleaseNotes = (packageNextRelease, packageDependencies, context) => {
+    const { pathname, name, gitTag } = packageNextRelease;
+    const { config, branch, lastRelease, nextRelease, commits } = context;
+    if (branch) {
+        const { debug, repositoryUrl, releaseType, isMonorepo } = config;
+        const logger = setLogger(debug);
+        const branchConfig = releaseType[branch];
+        if (branchConfig) {
+            const { prerelease } = branchConfig;
+            if (lastRelease) {
+                const packageLastRelease = lastRelease.packages.find(packageItem => packageItem.name === name);
+                if (packageLastRelease) {
+                    if (commits) {
+                        const majorChanges = [];
+                        const minorChanges = [];
+                        const patchChanges = [];
+                        const dependenciesUpdates = [];
+                        const { gitTag: lastGitTag } = packageLastRelease;
+                        for (const commit of commits) {
+                            const { isMergeCommit, sha, message, releaseType, modifiedFiles } = commit;
+                            if (isMergeCommit ||
+                                (isMonorepo &&
+                                    name &&
+                                    !modifiedFiles?.filter(file => file.startsWith(pathname)).length)) {
+                                continue;
+                            }
+                            if (sha) {
+                                const abbreviatedSha = sha?.slice(0, COMMIT_ABBREVIATED_SHA_LENGTH);
+                                const [_, scope, description] = message.match(COMMIT_MESSAGE) ?? [];
+                                const sanitisedDescription = description ?? "";
+                                const changeItem = `${scope ? `**${scope}:** ${sanitisedDescription}` : sanitisedDescription} ([\`${abbreviatedSha}\`](${repositoryUrl.replace(".git", "")}/commit/${sha}))`;
+                                switch (releaseType) {
+                                    case "major":
+                                        majorChanges.push(changeItem);
+                                        break;
+                                    case "minor": {
+                                        minorChanges.push(changeItem);
+                                        break;
+                                    }
+                                    case "patch":
+                                        patchChanges.push(changeItem);
+                                        break;
+                                    default:
+                                        break;
+                                }
+                            }
+                        }
+                        if (isMonorepo && name && packageDependencies && nextRelease) {
+                            for (const packageDependency of packageDependencies) {
+                                const packageNextRelease = nextRelease.find(packageItem => packageItem.name === packageDependency);
+                                if (packageNextRelease) {
+                                    const updateItem = `${packageNextRelease.name}@${packageNextRelease.version}`;
+                                    dependenciesUpdates.push(updateItem);
+                                }
+                            }
+                        }
+                        const fullChangelog = lastGitTag
+                            ? `**Full changelog:** [\`${lastGitTag}...${gitTag}\`](${repositoryUrl.replace(".git", "")}/compare/${lastGitTag}...${gitTag})`
+                            : "";
+                        const releaseNotesBody = {};
+                        if (majorChanges.length)
+                            releaseNotesBody.major = majorChanges;
+                        if (minorChanges.length)
+                            releaseNotesBody.minor = minorChanges;
+                        if (patchChanges.length)
+                            releaseNotesBody.patch = patchChanges;
+                        if (dependenciesUpdates.length)
+                            releaseNotesBody.dependencies = dependenciesUpdates;
+                        if (fullChangelog)
+                            releaseNotesBody.changelog = fullChangelog;
+                        if (debug) {
+                            logger.setDebugScope("release-notes-generator:prepare-release-notes");
+                            logger.logDebug(`Release notes for ${name || "root"} package:`);
+                            logger.logDebug(inspect(releaseNotesBody, { depth: Number.POSITIVE_INFINITY }));
+                        }
+                        return {
+                            tagName: gitTag,
+                            target: branch,
+                            isPrerelease: Boolean(prerelease),
+                            body: releaseNotesBody
+                        };
+                    }
+                    throw formatDetailedError({
+                        title: "Failed to prepare the release notes",
+                        message: "No commits have been retrieved.",
+                        details: {
+                            output: "commits: undefined"
+                        }
+                    });
+                }
+                throw formatDetailedError({
+                    title: "Failed to prepare the release notes",
+                    message: `No last release found for ${name || "root"} package.`,
+                    details: {
+                        output: "packageLastRelease: undefined"
+                    }
+                });
+            }
+            throw formatDetailedError({
+                title: "Failed to prepare the release notes",
+                message: "The last release is not defined.",
+                details: {
+                    output: "lastRelease: undefined"
+                }
+            });
+        }
+        throw formatDetailedError({
+            title: "Failed to prepare the release notes",
+            message: `The branch ${branch} is not defined in the configuration.`,
+            details: {
+                output: "branchConfig: undefined"
+            }
+        });
+    }
+    throw formatDetailedError({
+        title: "Failed to prepare the release notes",
+        message: "The branch is not defined",
+        details: {
+            output: "branch: undefined"
+        }
+    });
+};
+//# sourceMappingURL=prepare-release-notes.js.map

package/dist/prepare-release-notes.js.map

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

package/dist/release-notes-generator.types.d.ts

@@ -0,0 +1,13 @@
+export type ReleaseNotes = {
+    tagName: string;
+    target: string;
+    isPrerelease: boolean;
+    body: {
+        major?: string[];
+        minor?: string[];
+        patch?: string[];
+        dependencies?: string[];
+        changelog?: string;
+    };
+};
+//# sourceMappingURL=release-notes-generator.types.d.ts.map

package/dist/release-notes-generator.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"release-notes-generator.types.d.ts","sourceRoot":"","sources":["../src/release-notes-generator.types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,OAAO,CAAC;IACtB,IAAI,EAAE;QACJ,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;QACjB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;QACxB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;CACH,CAAC"}

package/dist/release-notes-generator.types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=release-notes-generator.types.js.map

package/dist/release-notes-generator.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"release-notes-generator.types.js","sourceRoot":"","sources":["../src/release-notes-generator.types.ts"],"names":[],"mappings":""}

package/dist/update-changelog-file.d.ts

@@ -0,0 +1,12 @@
+import type { PackageNextRelease } from "@release-change/shared";
+import type { ReleaseNotes } from "./release-notes-generator.types.js";
+/**
+ * Updates the package `CHANGELOG.md` file.
+ *
+ * In case the changelog file does not exist or is empty, it is filled without the full changelog section.
+ * @param packageNextRelease - The next release data to use.
+ * @param releaseNotesBody - The release notes body to format.
+ * @param cwd - The current working directory.
+ */
+export declare const updateChangelogFile: (packageNextRelease: PackageNextRelease, releaseNotesBody: ReleaseNotes["body"], cwd: string) => void;
+//# sourceMappingURL=update-changelog-file.d.ts.map

package/dist/update-changelog-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-changelog-file.d.ts","sourceRoot":"","sources":["../src/update-changelog-file.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAUvE;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB,GAC9B,oBAAoB,kBAAkB,EACtC,kBAAkB,YAAY,CAAC,MAAM,CAAC,EACtC,KAAK,MAAM,SAyBZ,CAAC"}

package/dist/update-changelog-file.js

@@ -0,0 +1,40 @@
+import fs from "node:fs";
+import path from "node:path";
+import { getPackageName } from "@release-change/get-packages";
+import { createChangelogFile } from "./create-changelog-file.js";
+import { formatReleaseNotesBody } from "./format-release-notes-body.js";
+/**
+ * Updates the package `CHANGELOG.md` file.
+ *
+ * In case the changelog file does not exist or is empty, it is filled without the full changelog section.
+ * @param packageNextRelease - The next release data to use.
+ * @param releaseNotesBody - The release notes body to format.
+ * @param cwd - The current working directory.
+ */
+export const updateChangelogFile = (packageNextRelease, releaseNotesBody, cwd) => {
+    const { name, pathname, version } = packageNextRelease;
+    const { major, minor, patch, dependencies } = releaseNotesBody;
+    const packageName = name || getPackageName(path.join(cwd, pathname, "package.json"));
+    const changelogFilePath = path.join(cwd, pathname, "CHANGELOG.md");
+    const versionHeader = `\n\n## ${version}\n\n`;
+    if (fs.existsSync(changelogFilePath)) {
+        const fileData = fs.readFileSync(changelogFilePath, "utf-8");
+        if (fileData) {
+            const formattedReleaseNotesBody = formatReleaseNotesBody(releaseNotesBody, true);
+            const blankLineIndex = fileData.indexOf("\n\n");
+            const updatedFileData = blankLineIndex === -1
+                ? `${fileData}\n\n${formattedReleaseNotesBody}`
+                : `${fileData.slice(0, blankLineIndex)}${versionHeader}${formattedReleaseNotesBody}${fileData.slice(blankLineIndex + 1)}`;
+            fs.writeFileSync(changelogFilePath, updatedFileData);
+        }
+        else {
+            const newFileHeader = `# ${packageName ?? "root package"}${versionHeader}`;
+            createChangelogFile(changelogFilePath, newFileHeader, { major, minor, patch, dependencies });
+        }
+    }
+    else {
+        const newFileHeader = `# ${packageName ?? "root package"}${versionHeader}`;
+        createChangelogFile(changelogFilePath, newFileHeader, { major, minor, patch, dependencies });
+    }
+};
+//# sourceMappingURL=update-changelog-file.js.map

package/dist/update-changelog-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-changelog-file.js","sourceRoot":"","sources":["../src/update-changelog-file.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAE9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAExE;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CACjC,kBAAsC,EACtC,gBAAsC,EACtC,GAAW,EACX,EAAE;IACF,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,kBAAkB,CAAC;IACvD,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,GAAG,gBAAgB,CAAC;IAC/D,MAAM,WAAW,GAAG,IAAI,IAAI,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,EAAE,cAAc,CAAC,CAAC,CAAC;IACrF,MAAM,iBAAiB,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,EAAE,cAAc,CAAC,CAAC;IACnE,MAAM,aAAa,GAAG,UAAU,OAAO,MAAM,CAAC;IAC9C,IAAI,EAAE,CAAC,UAAU,CAAC,iBAAiB,CAAC,EAAE,CAAC;QACrC,MAAM,QAAQ,GAAG,EAAE,CAAC,YAAY,CAAC,iBAAiB,EAAE,OAAO,CAAC,CAAC;QAC7D,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,yBAAyB,GAAG,sBAAsB,CAAC,gBAAgB,EAAE,IAAI,CAAC,CAAC;YACjF,MAAM,cAAc,GAAG,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YAChD,MAAM,eAAe,GACnB,cAAc,KAAK,CAAC,CAAC;gBACnB,CAAC,CAAC,GAAG,QAAQ,OAAO,yBAAyB,EAAE;gBAC/C,CAAC,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,cAAc,CAAC,GAAG,aAAa,GAAG,yBAAyB,GAAG,QAAQ,CAAC,KAAK,CAAC,cAAc,GAAG,CAAC,CAAC,EAAE,CAAC;YAC9H,EAAE,CAAC,aAAa,CAAC,iBAAiB,EAAE,eAAe,CAAC,CAAC;QACvD,CAAC;aAAM,CAAC;YACN,MAAM,aAAa,GAAG,KAAK,WAAW,IAAI,cAAc,GAAG,aAAa,EAAE,CAAC;YAC3E,mBAAmB,CAAC,iBAAiB,EAAE,aAAa,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC,CAAC;QAC/F,CAAC;IACH,CAAC;SAAM,CAAC;QACN,MAAM,aAAa,GAAG,KAAK,WAAW,IAAI,cAAc,GAAG,aAAa,EAAE,CAAC;QAC3E,mBAAmB,CAAC,iBAAiB,EAAE,aAAa,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC,CAAC;IAC/F,CAAC;AACH,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@release-change/release-notes-generator",
+  "version": "0.1.0",
+  "description": "Functions used internally in release-change to prepare and generate release notes",
+  "keywords": [],
+  "homepage": "https://github.com/release-change/release-change",
+  "bugs": {
+    "url": "https://github.com/release-change/release-change/issues"
+  },
+  "author": "Victor Brito (https://victor-brito.dev)",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/release-change/release-change.git"
+  },
+  "type": "module",
+  "license": "MIT",
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    "import": "./dist/index.js",
+    "types": "./dist/index.d.ts"
+  },
+  "engines": {
+    "node": "^20.18.3 || ^22.12.0 || ^24.0.0",
+    "npm": ">=10.8.2",
+    "pnpm": ">=10.28.0"
+  },
+  "dependencies": {
+    "@release-change/ci": "0.1.0",
+    "@release-change/commit-analyser": "0.1.0",
+    "@release-change/get-packages": "0.1.0",
+    "@release-change/github": "0.1.0",
+    "@release-change/logger": "0.1.0",
+    "@release-change/shared": "0.1.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch --preserveWatchOutput & vitest"
+  }
+}