@aneuhold/core-ts-lib 2.2.9 → 2.2.11

package/lib/services/ChangelogService/ChangelogService.ts

@@ -0,0 +1,293 @@
+import ErrorUtils from '../../utils/ErrorUtils.js';
+import { DR } from '../DependencyRegistry.js';
+import ChangelogFileService from './ChangelogFileService.js';
+import ChangelogGenerator from './ChangelogGenerator.js';
+import ChangelogParser from './ChangelogParser.js';
+import ChangelogValidator from './ChangelogValidator.js';
+import GitTagService from './GitTagService.js';
+import RepositoryInfoService from './RepositoryInfoService.js';
+import { CHANGELOG_FILENAME, type ChangelogVersionEntry } from './types.js';
+
+/**
+ * A service for managing and validating changelog files in packages.
+ *
+ * This service handles the creation, validation, and maintenance of CHANGELOG.md
+ * files following the Keep a Changelog format.
+ */
+export default class ChangelogService {
+  /**
+   * Validates that a changelog exists and contains a valid entry for the specified version.
+   *
+   * @param version The version to validate in the changelog
+   * @param packagePath Optional path to the package directory (defaults to current working directory)
+   * @throws Error if validation fails
+   */
+  static async validateChangelogForVersion(version: string, packagePath?: string): Promise<void> {
+    const workingDir = packagePath || process.cwd();
+
+    DR.logger.info(`Validating changelog for version ${version}...`);
+
+    const changelogExists = await ChangelogFileService.changelogExists(packagePath);
+    if (!changelogExists) {
+      throw new Error(
+        `No ${CHANGELOG_FILENAME} file found in ${workingDir}. ` +
+          `Run changelog initialization to create one.`
+      );
+    }
+
+    try {
+      const changelogContent = await ChangelogFileService.readChangelog(packagePath);
+      const versionEntries = ChangelogParser.parseChangelog(changelogContent);
+
+      const versionEntry = versionEntries.find((entry) => entry.version === version);
+
+      if (!versionEntry) {
+        throw new Error(
+          `No changelog entry found for version ${version}. ` +
+            `Please add an entry to ${CHANGELOG_FILENAME} before publishing.`
+        );
+      }
+
+      ChangelogValidator.validateVersionEntry(versionEntry, version);
+
+      DR.logger.success(`Changelog validation passed for version ${version}`);
+    } catch (error) {
+      const errorString = ErrorUtils.getErrorString(error);
+      DR.logger.error(`Changelog validation failed: ${errorString}`);
+      throw error;
+    }
+  }
+
+  /**
+   * Initializes a changelog file for the current package if one doesn't exist.
+   * If a changelog already exists, validates it against existing Git tags and
+   * updates the most recent entry if needed to match the current version.
+   *
+   * @param version The current version for the changelog
+   * @param packageName The name of the package
+   * @param packagePath Optional path to the package directory (defaults to current working directory)
+   */
+  static async initializeChangelog(
+    version: string,
+    packageName: string,
+    packagePath?: string
+  ): Promise<void> {
+    const workingDir = packagePath || process.cwd();
+
+    DR.logger.info(`Initializing changelog for ${packageName} version ${version}...`);
+
+    const changelogExists = await ChangelogFileService.changelogExists(packagePath);
+
+    if (changelogExists) {
+      // If it exists, validate against Git tags and update if necessary
+      const existingContent = await ChangelogFileService.readChangelog(packagePath);
+      await this.validateAndUpdateExistingChangelog(
+        version,
+        packageName,
+        existingContent,
+        workingDir
+      );
+    } else {
+      // Changelog doesn't exist, create a new one
+      DR.logger.info(`Creating new changelog file`);
+      const repositoryInfo = await RepositoryInfoService.getRepositoryInfo(workingDir);
+      const initialContent = ChangelogGenerator.createInitialChangelogContent(
+        version,
+        packageName,
+        repositoryInfo
+      );
+      await ChangelogFileService.createChangelog(initialContent, packagePath);
+    }
+
+    DR.logger.success(`Changelog initialization completed for ${packageName}`);
+  }
+
+  /**
+   * Validates an existing changelog against Git tags and updates if necessary.
+   *
+   * @param currentVersion The current version
+   * @param packageName The package name
+   * @param existingContent The current changelog content
+   * @param workingDir The working directory
+   */
+  private static async validateAndUpdateExistingChangelog(
+    currentVersion: string,
+    packageName: string,
+    existingContent: string,
+    workingDir: string
+  ): Promise<void> {
+    const versionEntries = ChangelogParser.parseChangelog(existingContent);
+
+    if (versionEntries.length === 0) {
+      // No version entries exist, add the current version
+      DR.logger.info(
+        `Changelog exists but has no version entries - adding entry for ${currentVersion}`
+      );
+      await this.addVersionEntry(currentVersion, existingContent, packageName, workingDir);
+      return;
+    }
+
+    // Get existing Git tags for this package
+    const existingTags = GitTagService.getPackageTags(packageName, workingDir);
+
+    // Check which entries have corresponding tags and remove ones that don't (except most recent)
+    const mostRecentEntry = versionEntries[0];
+    const olderEntries = versionEntries.slice(1);
+    const validOlderEntries: ChangelogVersionEntry[] = [];
+    const removedVersions: string[] = [];
+
+    for (const entry of olderEntries) {
+      const expectedTag = GitTagService.getTagName(packageName, entry.version);
+      if (existingTags.includes(expectedTag)) {
+        validOlderEntries.push(entry);
+      } else {
+        removedVersions.push(entry.version);
+      }
+    }
+
+    // If we removed any older entries, we need to regenerate the changelog
+    if (removedVersions.length > 0) {
+      DR.logger.info(
+        `Removing changelog entries without corresponding Git tags: ${removedVersions.join(', ')}`
+      );
+
+      const validEntries = [mostRecentEntry, ...validOlderEntries];
+      const repositoryInfo = await RepositoryInfoService.getRepositoryInfo(workingDir);
+      const updatedContent = ChangelogGenerator.regenerateChangelogContent(
+        validEntries,
+        packageName,
+        repositoryInfo
+      );
+      await ChangelogFileService.writeChangelog(updatedContent, workingDir);
+    }
+
+    // Now handle the most recent entry
+    const mostRecentTag = GitTagService.getTagName(packageName, mostRecentEntry.version);
+    const hasTagForMostRecent = existingTags.includes(mostRecentTag);
+
+    if (hasTagForMostRecent) {
+      // Most recent entry has a tag, so we need to add a new entry for current version
+      if (mostRecentEntry.version === currentVersion) {
+        DR.logger.info(
+          `Changelog already contains entry for version ${currentVersion} with corresponding tag - no changes made`
+        );
+        return;
+      }
+
+      DR.logger.info(
+        `Most recent changelog entry has a tag - adding new entry for version ${currentVersion}`
+      );
+      await this.addVersionEntry(currentVersion, existingContent, packageName, workingDir);
+    } else {
+      // Most recent entry doesn't have a tag
+      if (mostRecentEntry.version === currentVersion) {
+        DR.logger.info(
+          `Changelog already contains entry for version ${currentVersion} without tag - no changes made`
+        );
+        return;
+      }
+
+      // Update the most recent entry to match current version
+      DR.logger.info(
+        `Updating most recent changelog entry from ${mostRecentEntry.version} to ${currentVersion}`
+      );
+      await this.updateMostRecentVersionEntry(
+        currentVersion,
+        existingContent,
+        packageName,
+        workingDir
+      );
+    }
+  }
+
+  /**
+   * Updates the most recent version entry in the changelog.
+   *
+   * @param newVersion The new version to update to
+   * @param existingContent The current changelog content
+   * @param packageName The package name
+   * @param workingDir The working directory
+   */
+  private static async updateMostRecentVersionEntry(
+    newVersion: string,
+    existingContent: string,
+    packageName: string,
+    workingDir: string
+  ): Promise<void> {
+    const versionEntries = ChangelogParser.parseChangelog(existingContent);
+
+    if (versionEntries.length === 0) {
+      throw new Error('No version entries found to update');
+    }
+
+    const mostRecentEntry = versionEntries[0];
+    const oldVersionPattern = `## 🔖 [${mostRecentEntry.version}]`;
+    const newVersionPattern = `## 🔖 [${newVersion}]`;
+
+    // Replace the version in the changelog content
+    let updatedContent = existingContent.replace(oldVersionPattern, newVersionPattern);
+
+    // Update version links if they exist
+    const repositoryInfo = await RepositoryInfoService.getRepositoryInfo(workingDir);
+    if (repositoryInfo) {
+      updatedContent = ChangelogGenerator.addVersionLinksToChangelog(
+        updatedContent,
+        repositoryInfo,
+        packageName
+      );
+    }
+
+    await ChangelogFileService.writeChangelog(updatedContent, workingDir);
+  }
+
+  /**
+   * Adds a new version entry to an existing changelog.
+   *
+   * @param version The version to add
+   * @param existingContent The current changelog content
+   * @param packageName The package name for generating version links
+   * @param packagePath The package directory path
+   */
+  private static async addVersionEntry(
+    version: string,
+    existingContent: string,
+    packageName: string,
+    packagePath: string
+  ): Promise<void> {
+    const currentDate = ChangelogGenerator.getCurrentDate();
+    const versionEntry = ChangelogGenerator.createVersionEntryContent(version, currentDate);
+
+    // Find the position after the header to insert the new version
+    const lines = existingContent.split('\n');
+    const headerEndIndex = lines.findIndex((line) => line.startsWith('## ') && line.includes('['));
+
+    let newContent: string;
+    if (headerEndIndex === -1) {
+      // No existing version entries, add after the header
+      const headerLines = lines.slice(0, lines.findIndex((line) => line.trim() === '') + 1);
+      newContent = [...headerLines, '', versionEntry, '', ...lines.slice(headerLines.length)].join(
+        '\n'
+      );
+    } else {
+      // Insert before the first existing version
+      newContent = [
+        ...lines.slice(0, headerEndIndex),
+        versionEntry,
+        '',
+        ...lines.slice(headerEndIndex)
+      ].join('\n');
+    }
+
+    // Add version links if repository info is available
+    const repositoryInfo = await RepositoryInfoService.getRepositoryInfo(packagePath);
+    if (repositoryInfo) {
+      newContent = ChangelogGenerator.addVersionLinksToChangelog(
+        newContent,
+        repositoryInfo,
+        packageName
+      );
+    }
+
+    await ChangelogFileService.writeChangelog(newContent, packagePath);
+  }
+}

package/lib/services/ChangelogService/ChangelogValidator.d.ts

@@ -0,0 +1,15 @@
+import type { ChangelogVersionEntry } from './types.js';
+/**
+ * Service for validating changelog entries and content.
+ */
+export default class ChangelogValidator {
+    /**
+     * Validates that a version entry meets the requirements.
+     *
+     * @param versionEntry The version entry to validate
+     * @param version The version being validated (for error messages)
+     * @throws Error if validation fails
+     */
+    static validateVersionEntry(versionEntry: ChangelogVersionEntry, version: string): void;
+}
+//# sourceMappingURL=ChangelogValidator.d.ts.map

package/lib/services/ChangelogService/ChangelogValidator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChangelogValidator.d.ts","sourceRoot":"","sources":["../../../src/services/ChangelogService/ChangelogValidator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAGxD;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,kBAAkB;IACrC;;;;;;OAMG;IACH,MAAM,CAAC,oBAAoB,CAAC,YAAY,EAAE,qBAAqB,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;CAwCxF"}

package/lib/services/ChangelogService/ChangelogValidator.js

@@ -0,0 +1,44 @@
+import { REQUIRED_SECTION_TYPES } from './types.js';
+/**
+ * Service for validating changelog entries and content.
+ */
+export default class ChangelogValidator {
+    /**
+     * Validates that a version entry meets the requirements.
+     *
+     * @param versionEntry The version entry to validate
+     * @param version The version being validated (for error messages)
+     * @throws Error if validation fails
+     */
+    static validateVersionEntry(versionEntry, version) {
+        const { sections } = versionEntry;
+        if (sections.length === 0) {
+            throw new Error(`Version ${version} has no changelog sections. ` +
+                `At least one of the following sections is required: ${REQUIRED_SECTION_TYPES.join(', ')}`);
+        }
+        let hasValidSection = false;
+        const emptySections = [];
+        for (const section of sections) {
+            if (REQUIRED_SECTION_TYPES.includes(section.type)) {
+                if (section.content && section.content.trim().length > 0) {
+                    hasValidSection = true;
+                }
+                else {
+                    // Section exists but is empty
+                    emptySections.push(section.type);
+                }
+            }
+        }
+        // Fail if any section exists but is empty
+        if (emptySections.length > 0) {
+            throw new Error(`Version ${version} has empty changelog sections. ` +
+                `The following sections exist but have no content: ${emptySections.join(', ')}`);
+        }
+        // Fail if no section has meaningful content
+        if (!hasValidSection) {
+            throw new Error(`Version ${version} has no meaningful content in changelog sections. ` +
+                `At least one of the following sections must have content: ${REQUIRED_SECTION_TYPES.join(', ')}`);
+        }
+    }
+}
+//# sourceMappingURL=ChangelogValidator.js.map

package/lib/services/ChangelogService/ChangelogValidator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChangelogValidator.js","sourceRoot":"","sources":["../../../src/services/ChangelogService/ChangelogValidator.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAEpD;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,kBAAkB;IACrC;;;;;;OAMG;IACH,MAAM,CAAC,oBAAoB,CAAC,YAAmC,EAAE,OAAe;QAC9E,MAAM,EAAE,QAAQ,EAAE,GAAG,YAAY,CAAC;QAElC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CACb,WAAW,OAAO,8BAA8B;gBAC9C,uDAAuD,sBAAsB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC7F,CAAC;QACJ,CAAC;QAED,IAAI,eAAe,GAAG,KAAK,CAAC;QAC5B,MAAM,aAAa,GAAa,EAAE,CAAC;QAEnC,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,IAAI,sBAAsB,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;gBAClD,IAAI,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACzD,eAAe,GAAG,IAAI,CAAC;gBACzB,CAAC;qBAAM,CAAC;oBACN,8BAA8B;oBAC9B,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;gBACnC,CAAC;YACH,CAAC;QACH,CAAC;QAED,0CAA0C;QAC1C,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CACb,WAAW,OAAO,iCAAiC;gBACjD,qDAAqD,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAClF,CAAC;QACJ,CAAC;QAED,4CAA4C;QAC5C,IAAI,CAAC,eAAe,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CACb,WAAW,OAAO,oDAAoD;gBACpE,6DAA6D,sBAAsB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACnG,CAAC;QACJ,CAAC;IACH,CAAC;CACF"}

package/lib/services/ChangelogService/ChangelogValidator.ts

@@ -0,0 +1,55 @@
+import type { ChangelogVersionEntry } from './types.js';
+import { REQUIRED_SECTION_TYPES } from './types.js';
+
+/**
+ * Service for validating changelog entries and content.
+ */
+export default class ChangelogValidator {
+  /**
+   * Validates that a version entry meets the requirements.
+   *
+   * @param versionEntry The version entry to validate
+   * @param version The version being validated (for error messages)
+   * @throws Error if validation fails
+   */
+  static validateVersionEntry(versionEntry: ChangelogVersionEntry, version: string): void {
+    const { sections } = versionEntry;
+
+    if (sections.length === 0) {
+      throw new Error(
+        `Version ${version} has no changelog sections. ` +
+          `At least one of the following sections is required: ${REQUIRED_SECTION_TYPES.join(', ')}`
+      );
+    }
+
+    let hasValidSection = false;
+    const emptySections: string[] = [];
+
+    for (const section of sections) {
+      if (REQUIRED_SECTION_TYPES.includes(section.type)) {
+        if (section.content && section.content.trim().length > 0) {
+          hasValidSection = true;
+        } else {
+          // Section exists but is empty
+          emptySections.push(section.type);
+        }
+      }
+    }
+
+    // Fail if any section exists but is empty
+    if (emptySections.length > 0) {
+      throw new Error(
+        `Version ${version} has empty changelog sections. ` +
+          `The following sections exist but have no content: ${emptySections.join(', ')}`
+      );
+    }
+
+    // Fail if no section has meaningful content
+    if (!hasValidSection) {
+      throw new Error(
+        `Version ${version} has no meaningful content in changelog sections. ` +
+          `At least one of the following sections must have content: ${REQUIRED_SECTION_TYPES.join(', ')}`
+      );
+    }
+  }
+}

package/lib/services/ChangelogService/GitTagService.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Service for handling Git tag operations related to changelog management.
+ */
+export default class GitTagService {
+    /**
+     * Gets Git tags for a specific package.
+     *
+     * @param packageName The package name
+     * @param workingDir The working directory
+     * @returns Array of Git tags for the package
+     */
+    static getPackageTags(packageName: string, workingDir: string): string[];
+    /**
+     * Generates the expected Git tag name for a package version.
+     *
+     * @param packageName The package name
+     * @param version The version
+     * @returns The expected Git tag name
+     */
+    static getTagName(packageName: string, version: string): string;
+    /**
+     * Converts package name to tag prefix (removes scope if present).
+     *
+     * @param packageName The package name
+     * @returns The tag prefix
+     */
+    private static getTagPrefix;
+}
+//# sourceMappingURL=GitTagService.d.ts.map

package/lib/services/ChangelogService/GitTagService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GitTagService.d.ts","sourceRoot":"","sources":["../../../src/services/ChangelogService/GitTagService.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,aAAa;IAChC;;;;;;OAMG;IACH,MAAM,CAAC,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE;IAuBxE;;;;;;OAMG;IACH,MAAM,CAAC,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM;IAK/D;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,YAAY;CAG5B"}

package/lib/services/ChangelogService/GitTagService.js

@@ -0,0 +1,57 @@
+import { execSync } from 'child_process';
+import ErrorUtils from '../../utils/ErrorUtils.js';
+import { DR } from '../DependencyRegistry.js';
+/**
+ * Service for handling Git tag operations related to changelog management.
+ */
+export default class GitTagService {
+    /**
+     * Gets Git tags for a specific package.
+     *
+     * @param packageName The package name
+     * @param workingDir The working directory
+     * @returns Array of Git tags for the package
+     */
+    static getPackageTags(packageName, workingDir) {
+        try {
+            // Convert package name to tag prefix (remove scope if present)
+            const tagPrefix = this.getTagPrefix(packageName);
+            const tagPattern = `${tagPrefix}-v*`;
+            // Get all tags matching the pattern
+            const output = execSync(`git tag -l "${tagPattern}"`, {
+                cwd: workingDir,
+                encoding: 'utf-8'
+            });
+            return output
+                .trim()
+                .split('\n')
+                .filter((tag) => tag.length > 0);
+        }
+        catch (error) {
+            // If git command fails (e.g., not a git repo), return empty array
+            DR.logger.warn(`Failed to retrieve Git tags: ${ErrorUtils.getErrorString(error)}`);
+            return [];
+        }
+    }
+    /**
+     * Generates the expected Git tag name for a package version.
+     *
+     * @param packageName The package name
+     * @param version The version
+     * @returns The expected Git tag name
+     */
+    static getTagName(packageName, version) {
+        const tagPrefix = this.getTagPrefix(packageName);
+        return `${tagPrefix}-v${version}`;
+    }
+    /**
+     * Converts package name to tag prefix (removes scope if present).
+     *
+     * @param packageName The package name
+     * @returns The tag prefix
+     */
+    static getTagPrefix(packageName) {
+        return packageName.replace(/^@[\w-]+\//, '');
+    }
+}
+//# sourceMappingURL=GitTagService.js.map

package/lib/services/ChangelogService/GitTagService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GitTagService.js","sourceRoot":"","sources":["../../../src/services/ChangelogService/GitTagService.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,UAAU,MAAM,2BAA2B,CAAC;AACnD,OAAO,EAAE,EAAE,EAAE,MAAM,0BAA0B,CAAC;AAE9C;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,aAAa;IAChC;;;;;;OAMG;IACH,MAAM,CAAC,cAAc,CAAC,WAAmB,EAAE,UAAkB;QAC3D,IAAI,CAAC;YACH,+DAA+D;YAC/D,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,CAAC,WAAW,CAAC,CAAC;YACjD,MAAM,UAAU,GAAG,GAAG,SAAS,KAAK,CAAC;YAErC,oCAAoC;YACpC,MAAM,MAAM,GAAG,QAAQ,CAAC,eAAe,UAAU,GAAG,EAAE;gBACpD,GAAG,EAAE,UAAU;gBACf,QAAQ,EAAE,OAAO;aAClB,CAAC,CAAC;YAEH,OAAO,MAAM;iBACV,IAAI,EAAE;iBACN,KAAK,CAAC,IAAI,CAAC;iBACX,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACrC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,kEAAkE;YAClE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,gCAAgC,UAAU,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACnF,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,UAAU,CAAC,WAAmB,EAAE,OAAe;QACpD,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,CAAC,WAAW,CAAC,CAAC;QACjD,OAAO,GAAG,SAAS,KAAK,OAAO,EAAE,CAAC;IACpC,CAAC;IAED;;;;;OAKG;IACK,MAAM,CAAC,YAAY,CAAC,WAAmB;QAC7C,OAAO,WAAW,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;IAC/C,CAAC;CACF"}

package/lib/services/ChangelogService/GitTagService.ts

@@ -0,0 +1,60 @@
+import { execSync } from 'child_process';
+import ErrorUtils from '../../utils/ErrorUtils.js';
+import { DR } from '../DependencyRegistry.js';
+
+/**
+ * Service for handling Git tag operations related to changelog management.
+ */
+export default class GitTagService {
+  /**
+   * Gets Git tags for a specific package.
+   *
+   * @param packageName The package name
+   * @param workingDir The working directory
+   * @returns Array of Git tags for the package
+   */
+  static getPackageTags(packageName: string, workingDir: string): string[] {
+    try {
+      // Convert package name to tag prefix (remove scope if present)
+      const tagPrefix = this.getTagPrefix(packageName);
+      const tagPattern = `${tagPrefix}-v*`;
+
+      // Get all tags matching the pattern
+      const output = execSync(`git tag -l "${tagPattern}"`, {
+        cwd: workingDir,
+        encoding: 'utf-8'
+      });
+
+      return output
+        .trim()
+        .split('\n')
+        .filter((tag) => tag.length > 0);
+    } catch (error) {
+      // If git command fails (e.g., not a git repo), return empty array
+      DR.logger.warn(`Failed to retrieve Git tags: ${ErrorUtils.getErrorString(error)}`);
+      return [];
+    }
+  }
+
+  /**
+   * Generates the expected Git tag name for a package version.
+   *
+   * @param packageName The package name
+   * @param version The version
+   * @returns The expected Git tag name
+   */
+  static getTagName(packageName: string, version: string): string {
+    const tagPrefix = this.getTagPrefix(packageName);
+    return `${tagPrefix}-v${version}`;
+  }
+
+  /**
+   * Converts package name to tag prefix (removes scope if present).
+   *
+   * @param packageName The package name
+   * @returns The tag prefix
+   */
+  private static getTagPrefix(packageName: string): string {
+    return packageName.replace(/^@[\w-]+\//, '');
+  }
+}

package/lib/services/ChangelogService/RepositoryInfoService.d.ts

@@ -0,0 +1,14 @@
+import type { RepositoryInfo } from './types.js';
+/**
+ * Service for extracting repository information from package.json files.
+ */
+export default class RepositoryInfoService {
+    /**
+     * Extracts repository information from package.json
+     *
+     * @param packagePath Path to the package directory
+     * @returns Repository information or null if not found/invalid
+     */
+    static getRepositoryInfo(packagePath?: string): Promise<RepositoryInfo | null>;
+}
+//# sourceMappingURL=RepositoryInfoService.d.ts.map

package/lib/services/ChangelogService/RepositoryInfoService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RepositoryInfoService.d.ts","sourceRoot":"","sources":["../../../src/services/ChangelogService/RepositoryInfoService.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,qBAAqB;IACxC;;;;;OAKG;WACU,iBAAiB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;CAiDrF"}

package/lib/services/ChangelogService/RepositoryInfoService.js

@@ -0,0 +1,55 @@
+import { readFile } from 'fs/promises';
+import path from 'path';
+/**
+ * Service for extracting repository information from package.json files.
+ */
+export default class RepositoryInfoService {
+    /**
+     * Extracts repository information from package.json
+     *
+     * @param packagePath Path to the package directory
+     * @returns Repository information or null if not found/invalid
+     */
+    static async getRepositoryInfo(packagePath) {
+        const workingDir = packagePath || process.cwd();
+        const packageJsonPath = path.join(workingDir, 'package.json');
+        try {
+            const packageJsonContent = await readFile(packageJsonPath, 'utf-8');
+            const packageJson = JSON.parse(packageJsonContent);
+            // Type guard to check if packageJson has the expected structure
+            if (typeof packageJson !== 'object' ||
+                packageJson === null ||
+                !('repository' in packageJson) ||
+                typeof packageJson.repository !== 'object' ||
+                packageJson.repository === null ||
+                !('url' in packageJson.repository) ||
+                typeof packageJson.repository.url !== 'string') {
+                return null;
+            }
+            const url = packageJson.repository.url;
+            // Handle different URL formats
+            let gitUrl = url;
+            if (gitUrl.startsWith('git+')) {
+                gitUrl = gitUrl.substring(4);
+            }
+            if (gitUrl.endsWith('.git')) {
+                gitUrl = gitUrl.substring(0, gitUrl.length - 4);
+            }
+            // Extract owner and repo from GitHub URL
+            const match = gitUrl.match(/github\.com[/:]([\w-]+)\/([\w-]+)/);
+            if (!match) {
+                return null;
+            }
+            const [, owner, repo] = match;
+            return {
+                owner,
+                repo,
+                url: `https://github.com/${owner}/${repo}`
+            };
+        }
+        catch {
+            return null;
+        }
+    }
+}
+//# sourceMappingURL=RepositoryInfoService.js.map

package/lib/services/ChangelogService/RepositoryInfoService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RepositoryInfoService.js","sourceRoot":"","sources":["../../../src/services/ChangelogService/RepositoryInfoService.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,IAAI,MAAM,MAAM,CAAC;AAGxB;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,qBAAqB;IACxC;;;;;OAKG;IACH,MAAM,CAAC,KAAK,CAAC,iBAAiB,CAAC,WAAoB;QACjD,MAAM,UAAU,GAAG,WAAW,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;QAChD,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC;QAE9D,IAAI,CAAC;YACH,MAAM,kBAAkB,GAAG,MAAM,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;YACpE,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,kBAAkB,CAAY,CAAC;YAE9D,gEAAgE;YAChE,IACE,OAAO,WAAW,KAAK,QAAQ;gBAC/B,WAAW,KAAK,IAAI;gBACpB,CAAC,CAAC,YAAY,IAAI,WAAW,CAAC;gBAC9B,OAAO,WAAW,CAAC,UAAU,KAAK,QAAQ;gBAC1C,WAAW,CAAC,UAAU,KAAK,IAAI;gBAC/B,CAAC,CAAC,KAAK,IAAI,WAAW,CAAC,UAAU,CAAC;gBAClC,OAAO,WAAW,CAAC,UAAU,CAAC,GAAG,KAAK,QAAQ,EAC9C,CAAC;gBACD,OAAO,IAAI,CAAC;YACd,CAAC;YAED,MAAM,GAAG,GAAG,WAAW,CAAC,UAAU,CAAC,GAAG,CAAC;YAEvC,+BAA+B;YAC/B,IAAI,MAAM,GAAG,GAAG,CAAC;YACjB,IAAI,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC9B,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;YAC/B,CAAC;YACD,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC5B,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YAClD,CAAC;YAED,yCAAyC;YACzC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,mCAAmC,CAAC,CAAC;YAChE,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,OAAO,IAAI,CAAC;YACd,CAAC;YAED,MAAM,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,GAAG,KAAK,CAAC;YAE9B,OAAO;gBACL,KAAK;gBACL,IAAI;gBACJ,GAAG,EAAE,sBAAsB,KAAK,IAAI,IAAI,EAAE;aAC3C,CAAC;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;CACF"}