@aneuhold/core-ts-lib 2.2.9 → 2.2.11

package/lib/services/PackageService/PackageServiceUtils.d.ts

@@ -0,0 +1,69 @@
+import { VersionType } from '../../types/VersionType.js';
+/**
+ * Utility service containing common functionality shared between JSR and NPM package services.
+ */
+export default class PackageServiceUtils {
+    /**
+     * Gets the package name and version from package.json.
+     *
+     * @returns An object containing the package name and version
+     */
+    static getPackageInfo(): Promise<{
+        packageName: string;
+        version: string;
+    }>;
+    /**
+     * Validates the current project for changes and changelog before publishing.
+     *
+     * @param currentVersion The current version to validate changelog for
+     */
+    static validatePrePublishRequirements(currentVersion: string): Promise<void>;
+    /**
+     * Common logic for checking version conflicts between current and latest versions.
+     *
+     * @param currentVersion The current version from package.json
+     * @param latestVersion The latest published version
+     * @param registryName The name of the registry (for error messages)
+     */
+    static checkVersionConflict(currentVersion: string, latestVersion: string, registryName: string): void;
+    /**
+     * Replaces the package name in all files in the root directory, but no child directories,
+     * with a new name.
+     *
+     * @param originalPackageName The original package name to replace
+     * @param newPackageName The new package name to use
+     */
+    static replacePackageName(originalPackageName: string, newPackageName: string): Promise<void>;
+    /**
+     * Performs a git reset to discard all changes in the working directory.
+     * This is used between alternative package name operations.
+     */
+    static resetGitChanges(): Promise<void>;
+    /**
+     * Initializes a changelog for the current project if one doesn't exist.
+     * This operation is idempotent - it won't modify existing content.
+     *
+     * @param packagePath Optional path to the package directory (defaults to current working directory)
+     */
+    static initializeChangelog(packagePath?: string): Promise<void>;
+    /**
+     * Bumps the version if needed based on npm registry comparison and initializes changelog.
+     * This operation is idempotent - it will only bump if the current version conflicts with
+     * the registry, and changelog initialization won't modify existing content.
+     *
+     * @param versionType The type of version bump (patch, minor, major). Defaults to patch.
+     * @param packagePath Optional path to the package directory (defaults to current working directory)
+     */
+    static bumpVersionIfNeededAndInitializeChangelog(versionType?: VersionType, packagePath?: string): Promise<void>;
+    /**
+     * Checks if a version bump is needed by comparing current version with npm registry
+     * and considering the requested version type.
+     *
+     * @param packageName The package name to check
+     * @param currentVersion The current version from package.json
+     * @param versionType The type of version bump requested
+     * @returns true if a version bump is needed, false otherwise
+     */
+    private static checkIfVersionBumpNeeded;
+}
+//# sourceMappingURL=PackageServiceUtils.d.ts.map

package/lib/services/PackageService/PackageServiceUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PackageServiceUtils.d.ts","sourceRoot":"","sources":["../../../src/services/PackageService/PackageServiceUtils.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAUzD;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,mBAAmB;IACtC;;;;OAIG;WACU,cAAc,IAAI,OAAO,CAAC;QACrC,WAAW,EAAE,MAAM,CAAC;QACpB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IAwBF;;;;OAIG;WACU,8BAA8B,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAUlF;;;;;;OAMG;IACH,MAAM,CAAC,oBAAoB,CACzB,cAAc,EAAE,MAAM,EACtB,aAAa,EAAE,MAAM,EACrB,YAAY,EAAE,MAAM,GACnB,IAAI;IAqBP;;;;;;OAMG;WACU,kBAAkB,CAC7B,mBAAmB,EAAE,MAAM,EAC3B,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,IAAI,CAAC;IAiBhB;;;OAGG;WACU,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAU7C;;;;;OAKG;WACU,mBAAmB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKrE;;;;;;;OAOG;WACU,yCAAyC,CACpD,WAAW,GAAE,WAA+B,EAC5C,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC;IAiChB;;;;;;;;OAQG;mBACkB,wBAAwB;CAmC9C"}

package/lib/services/PackageService/PackageServiceUtils.js

@@ -0,0 +1,185 @@
+import { exec } from 'child_process';
+import { access, readFile } from 'fs/promises';
+import path from 'path';
+import { promisify } from 'util';
+import { VersionType } from '../../types/VersionType.js';
+import ErrorUtils from '../../utils/ErrorUtils.js';
+import ChangelogService from '../ChangelogService/index.js';
+import { DR } from '../DependencyRegistry.js';
+import DependencyService from '../DependencyService.js';
+import FileSystemService from '../FileSystemService/FileSystemService.js';
+import StringService from '../StringService.js';
+const execAsync = promisify(exec);
+/**
+ * Utility service containing common functionality shared between JSR and NPM package services.
+ */
+export default class PackageServiceUtils {
+    /**
+     * Gets the package name and version from package.json.
+     *
+     * @returns An object containing the package name and version
+     */
+    static async getPackageInfo() {
+        const rootDir = process.cwd();
+        const packageJsonPath = path.join(rootDir, 'package.json');
+        try {
+            await access(packageJsonPath);
+        }
+        catch {
+            throw new Error('No package.json file found in the current directory.');
+        }
+        try {
+            const packageJsonData = JSON.parse(await readFile(packageJsonPath, 'utf-8'));
+            return {
+                packageName: packageJsonData.name,
+                version: packageJsonData.version
+            };
+        }
+        catch (error) {
+            const errorString = ErrorUtils.getErrorString(error);
+            DR.logger.error(`Failed to read package.json: ${errorString}`);
+            throw error;
+        }
+    }
+    /**
+     * Validates the current project for changes and changelog before publishing.
+     *
+     * @param currentVersion The current version to validate changelog for
+     */
+    static async validatePrePublishRequirements(currentVersion) {
+        if (await FileSystemService.hasPendingChanges()) {
+            DR.logger.error('Please commit or stash your changes before publishing.');
+            process.exit(1);
+        }
+        // Validate changelog for the current version before proceeding
+        await ChangelogService.validateChangelogForVersion(currentVersion);
+    }
+    /**
+     * Common logic for checking version conflicts between current and latest versions.
+     *
+     * @param currentVersion The current version from package.json
+     * @param latestVersion The latest published version
+     * @param registryName The name of the registry (for error messages)
+     */
+    static checkVersionConflict(currentVersion, latestVersion, registryName) {
+        DR.logger.info(`Current version: ${currentVersion}, Latest on ${registryName}: ${latestVersion}`);
+        // Compare versions using semver-like comparison
+        const comparison = StringService.compareSemanticVersions(currentVersion, latestVersion);
+        if (comparison === 0) {
+            throw new Error(`Version ${currentVersion} already exists on ${registryName}. Please bump the version before publishing.`);
+        }
+        else if (comparison < 0) {
+            throw new Error(`Current version ${currentVersion} is lower than the latest published version ${latestVersion} on ${registryName}. Please bump the version.`);
+        }
+        DR.logger.info('Version check passed - ready to publish.');
+    }
+    /**
+     * Replaces the package name in all files in the root directory, but no child directories,
+     * with a new name.
+     *
+     * @param originalPackageName The original package name to replace
+     * @param newPackageName The new package name to use
+     */
+    static async replacePackageName(originalPackageName, newPackageName) {
+        DR.logger.info(`Replacing package name from "${originalPackageName}" to "${newPackageName}"`);
+        const rootDir = process.cwd();
+        // Replace in all files in the root directory
+        await FileSystemService.replaceInFiles({
+            searchString: originalPackageName,
+            replaceString: newPackageName,
+            rootPath: rootDir,
+            includePatterns: ['*'],
+            excludePatterns: []
+        });
+        DR.logger.info(`Successfully replaced package name in configuration files`);
+    }
+    /**
+     * Performs a git reset to discard all changes in the working directory.
+     * This is used between alternative package name operations.
+     */
+    static async resetGitChanges() {
+        DR.logger.info('Resetting git changes');
+        try {
+            await execAsync('git reset --hard HEAD');
+        }
+        catch (error) {
+            DR.logger.error(`Failed to reset git changes: ${ErrorUtils.getErrorString(error)}`);
+            throw error;
+        }
+    }
+    /**
+     * Initializes a changelog for the current project if one doesn't exist.
+     * This operation is idempotent - it won't modify existing content.
+     *
+     * @param packagePath Optional path to the package directory (defaults to current working directory)
+     */
+    static async initializeChangelog(packagePath) {
+        const { packageName, version } = await PackageServiceUtils.getPackageInfo();
+        await ChangelogService.initializeChangelog(version, packageName, packagePath);
+    }
+    /**
+     * Bumps the version if needed based on npm registry comparison and initializes changelog.
+     * This operation is idempotent - it will only bump if the current version conflicts with
+     * the registry, and changelog initialization won't modify existing content.
+     *
+     * @param versionType The type of version bump (patch, minor, major). Defaults to patch.
+     * @param packagePath Optional path to the package directory (defaults to current working directory)
+     */
+    static async bumpVersionIfNeededAndInitializeChangelog(versionType = VersionType.Patch, packagePath) {
+        const { packageName, version: currentVersion } = await PackageServiceUtils.getPackageInfo();
+        DR.logger.info(`Checking if version bump is needed for ${packageName} (current: ${currentVersion})`);
+        // Check if version bump is needed by comparing with npm registry
+        const needsBump = await PackageServiceUtils.checkIfVersionBumpNeeded(packageName, currentVersion, versionType);
+        let finalVersion = currentVersion;
+        if (needsBump) {
+            DR.logger.info(`Version bump needed - bumping ${versionType} version`);
+            await DependencyService.bumpVersion(versionType);
+            // Get the new version after bump
+            const { version: newVersion } = await PackageServiceUtils.getPackageInfo();
+            finalVersion = newVersion;
+            DR.logger.success(`Version bumped from ${currentVersion} to ${finalVersion}`);
+        }
+        else {
+            DR.logger.info('No version bump needed - current version is valid');
+        }
+        // Initialize changelog with the final version
+        await ChangelogService.initializeChangelog(finalVersion, packageName, packagePath);
+        DR.logger.success(`Version preparation completed for ${packageName} version ${finalVersion}`);
+    }
+    /**
+     * Checks if a version bump is needed by comparing current version with npm registry
+     * and considering the requested version type.
+     *
+     * @param packageName The package name to check
+     * @param currentVersion The current version from package.json
+     * @param versionType The type of version bump requested
+     * @returns true if a version bump is needed, false otherwise
+     */
+    static async checkIfVersionBumpNeeded(packageName, currentVersion, versionType) {
+        DR.logger.info(`Checking npm registry for existing versions of ${packageName}...`);
+        let latestVersion = null;
+        try {
+            const { stdout } = await execAsync(`npm view ${packageName}`);
+            // Parse the npm view output to extract the latest version
+            const latestVersionMatch = stdout.match(/latest:\s*([^\s|]+)/);
+            if (latestVersionMatch) {
+                latestVersion = latestVersionMatch[1];
+                DR.logger.info(`Current version: ${currentVersion}, Latest on npm: ${latestVersion}`);
+            }
+        }
+        catch (error) {
+            const errorString = ErrorUtils.getErrorString(error);
+            // If the package doesn't exist on npm, no bump needed for first publish
+            if (errorString.includes('404') || errorString.includes('not found')) {
+                DR.logger.info('Package not found on npm - no version bump needed for first publish.');
+                return false;
+            }
+            // For other npm command errors, log but assume no bump needed to be safe
+            DR.logger.warn(`Could not check npm registry: ${errorString}`);
+            return false;
+        }
+        // Use the new logic to determine if bump is needed based on version type
+        return StringService.shouldBumpVersion(currentVersion, latestVersion, versionType);
+    }
+}
+//# sourceMappingURL=PackageServiceUtils.js.map

package/lib/services/PackageService/PackageServiceUtils.js.map

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

package/lib/services/PackageService/PackageServiceUtils.ts

@@ -0,0 +1,239 @@
+import { exec } from 'child_process';
+import { access, readFile } from 'fs/promises';
+import path from 'path';
+import { promisify } from 'util';
+import { PackageJson } from '../../types/PackageJson.js';
+import { VersionType } from '../../types/VersionType.js';
+import ErrorUtils from '../../utils/ErrorUtils.js';
+import ChangelogService from '../ChangelogService/index.js';
+import { DR } from '../DependencyRegistry.js';
+import DependencyService from '../DependencyService.js';
+import FileSystemService from '../FileSystemService/FileSystemService.js';
+import StringService from '../StringService.js';
+
+const execAsync = promisify(exec);
+
+/**
+ * Utility service containing common functionality shared between JSR and NPM package services.
+ */
+export default class PackageServiceUtils {
+  /**
+   * Gets the package name and version from package.json.
+   *
+   * @returns An object containing the package name and version
+   */
+  static async getPackageInfo(): Promise<{
+    packageName: string;
+    version: string;
+  }> {
+    const rootDir = process.cwd();
+    const packageJsonPath = path.join(rootDir, 'package.json');
+
+    try {
+      await access(packageJsonPath);
+    } catch {
+      throw new Error('No package.json file found in the current directory.');
+    }
+
+    try {
+      const packageJsonData = JSON.parse(await readFile(packageJsonPath, 'utf-8')) as PackageJson;
+
+      return {
+        packageName: packageJsonData.name,
+        version: packageJsonData.version
+      };
+    } catch (error) {
+      const errorString = ErrorUtils.getErrorString(error);
+      DR.logger.error(`Failed to read package.json: ${errorString}`);
+      throw error;
+    }
+  }
+
+  /**
+   * Validates the current project for changes and changelog before publishing.
+   *
+   * @param currentVersion The current version to validate changelog for
+   */
+  static async validatePrePublishRequirements(currentVersion: string): Promise<void> {
+    if (await FileSystemService.hasPendingChanges()) {
+      DR.logger.error('Please commit or stash your changes before publishing.');
+      process.exit(1);
+    }
+
+    // Validate changelog for the current version before proceeding
+    await ChangelogService.validateChangelogForVersion(currentVersion);
+  }
+
+  /**
+   * Common logic for checking version conflicts between current and latest versions.
+   *
+   * @param currentVersion The current version from package.json
+   * @param latestVersion The latest published version
+   * @param registryName The name of the registry (for error messages)
+   */
+  static checkVersionConflict(
+    currentVersion: string,
+    latestVersion: string,
+    registryName: string
+  ): void {
+    DR.logger.info(
+      `Current version: ${currentVersion}, Latest on ${registryName}: ${latestVersion}`
+    );
+
+    // Compare versions using semver-like comparison
+    const comparison = StringService.compareSemanticVersions(currentVersion, latestVersion);
+
+    if (comparison === 0) {
+      throw new Error(
+        `Version ${currentVersion} already exists on ${registryName}. Please bump the version before publishing.`
+      );
+    } else if (comparison < 0) {
+      throw new Error(
+        `Current version ${currentVersion} is lower than the latest published version ${latestVersion} on ${registryName}. Please bump the version.`
+      );
+    }
+
+    DR.logger.info('Version check passed - ready to publish.');
+  }
+
+  /**
+   * Replaces the package name in all files in the root directory, but no child directories,
+   * with a new name.
+   *
+   * @param originalPackageName The original package name to replace
+   * @param newPackageName The new package name to use
+   */
+  static async replacePackageName(
+    originalPackageName: string,
+    newPackageName: string
+  ): Promise<void> {
+    DR.logger.info(`Replacing package name from "${originalPackageName}" to "${newPackageName}"`);
+
+    const rootDir = process.cwd();
+
+    // Replace in all files in the root directory
+    await FileSystemService.replaceInFiles({
+      searchString: originalPackageName,
+      replaceString: newPackageName,
+      rootPath: rootDir,
+      includePatterns: ['*'],
+      excludePatterns: []
+    });
+
+    DR.logger.info(`Successfully replaced package name in configuration files`);
+  }
+
+  /**
+   * Performs a git reset to discard all changes in the working directory.
+   * This is used between alternative package name operations.
+   */
+  static async resetGitChanges(): Promise<void> {
+    DR.logger.info('Resetting git changes');
+    try {
+      await execAsync('git reset --hard HEAD');
+    } catch (error) {
+      DR.logger.error(`Failed to reset git changes: ${ErrorUtils.getErrorString(error)}`);
+      throw error;
+    }
+  }
+
+  /**
+   * Initializes a changelog for the current project if one doesn't exist.
+   * This operation is idempotent - it won't modify existing content.
+   *
+   * @param packagePath Optional path to the package directory (defaults to current working directory)
+   */
+  static async initializeChangelog(packagePath?: string): Promise<void> {
+    const { packageName, version } = await PackageServiceUtils.getPackageInfo();
+    await ChangelogService.initializeChangelog(version, packageName, packagePath);
+  }
+
+  /**
+   * Bumps the version if needed based on npm registry comparison and initializes changelog.
+   * This operation is idempotent - it will only bump if the current version conflicts with
+   * the registry, and changelog initialization won't modify existing content.
+   *
+   * @param versionType The type of version bump (patch, minor, major). Defaults to patch.
+   * @param packagePath Optional path to the package directory (defaults to current working directory)
+   */
+  static async bumpVersionIfNeededAndInitializeChangelog(
+    versionType: VersionType = VersionType.Patch,
+    packagePath?: string
+  ): Promise<void> {
+    const { packageName, version: currentVersion } = await PackageServiceUtils.getPackageInfo();
+
+    DR.logger.info(
+      `Checking if version bump is needed for ${packageName} (current: ${currentVersion})`
+    );
+
+    // Check if version bump is needed by comparing with npm registry
+    const needsBump = await PackageServiceUtils.checkIfVersionBumpNeeded(
+      packageName,
+      currentVersion,
+      versionType
+    );
+
+    let finalVersion = currentVersion;
+    if (needsBump) {
+      DR.logger.info(`Version bump needed - bumping ${versionType} version`);
+      await DependencyService.bumpVersion(versionType);
+
+      // Get the new version after bump
+      const { version: newVersion } = await PackageServiceUtils.getPackageInfo();
+      finalVersion = newVersion;
+      DR.logger.success(`Version bumped from ${currentVersion} to ${finalVersion}`);
+    } else {
+      DR.logger.info('No version bump needed - current version is valid');
+    }
+
+    // Initialize changelog with the final version
+    await ChangelogService.initializeChangelog(finalVersion, packageName, packagePath);
+
+    DR.logger.success(`Version preparation completed for ${packageName} version ${finalVersion}`);
+  }
+
+  /**
+   * Checks if a version bump is needed by comparing current version with npm registry
+   * and considering the requested version type.
+   *
+   * @param packageName The package name to check
+   * @param currentVersion The current version from package.json
+   * @param versionType The type of version bump requested
+   * @returns true if a version bump is needed, false otherwise
+   */
+  private static async checkIfVersionBumpNeeded(
+    packageName: string,
+    currentVersion: string,
+    versionType: VersionType
+  ): Promise<boolean> {
+    DR.logger.info(`Checking npm registry for existing versions of ${packageName}...`);
+
+    let latestVersion: string | null = null;
+
+    try {
+      const { stdout } = await execAsync(`npm view ${packageName}`);
+
+      // Parse the npm view output to extract the latest version
+      const latestVersionMatch = stdout.match(/latest:\s*([^\s|]+)/);
+      if (latestVersionMatch) {
+        latestVersion = latestVersionMatch[1];
+        DR.logger.info(`Current version: ${currentVersion}, Latest on npm: ${latestVersion}`);
+      }
+    } catch (error) {
+      const errorString = ErrorUtils.getErrorString(error);
+
+      // If the package doesn't exist on npm, no bump needed for first publish
+      if (errorString.includes('404') || errorString.includes('not found')) {
+        DR.logger.info('Package not found on npm - no version bump needed for first publish.');
+        return false;
+      }
+
+      // For other npm command errors, log but assume no bump needed to be safe
+      DR.logger.warn(`Could not check npm registry: ${errorString}`);
+      return false;
+    }
+
+    // Use the new logic to determine if bump is needed based on version type
+    return StringService.shouldBumpVersion(currentVersion, latestVersion, versionType);
+  }
+}

package/lib/services/StringService.d.ts

@@ -1,3 +1,4 @@
+import { VersionType } from '../types/VersionType.js';
 /**
  * A service which can be used to interact with strings.
  */
@@ -18,5 +19,16 @@ export default class StringService {
      * @returns -1 if version1 < version2, 0 if equal, 1 if version1 > version2
      */
     static compareSemanticVersions(version1: string, version2: string): number;
+    /**
+     * Checks if a version needs to be bumped based on the desired version type.
+     * This considers both registry conflicts and whether the requested version type
+     * has been incremented from the published version.
+     *
+     * @param currentVersion The current version from package.json
+     * @param publishedVersion The latest published version (or null if not published)
+     * @param requestedVersionType The type of version bump requested
+     * @returns true if a version bump is needed, false otherwise
+     */
+    static shouldBumpVersion(currentVersion: string, publishedVersion: string | null, requestedVersionType: VersionType): boolean;
 }
 //# sourceMappingURL=StringService.d.ts.map

package/lib/services/StringService.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"StringService.d.ts","sourceRoot":"","sources":["../../src/services/StringService.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,aAAa;IAChC;;;;;;OAMG;IACH,MAAM,CAAC,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAIjE;;;;;;OAMG;IACH,MAAM,CAAC,uBAAuB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM;CAgB3E"}
+{"version":3,"file":"StringService.d.ts","sourceRoot":"","sources":["../../src/services/StringService.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAEtD;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,aAAa;IAChC;;;;;;OAMG;IACH,MAAM,CAAC,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAIjE;;;;;;OAMG;IACH,MAAM,CAAC,uBAAuB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM;IAiB1E;;;;;;;;;OASG;IACH,MAAM,CAAC,iBAAiB,CACtB,cAAc,EAAE,MAAM,EACtB,gBAAgB,EAAE,MAAM,GAAG,IAAI,EAC/B,oBAAoB,EAAE,WAAW,GAChC,OAAO;CAuDX"}

package/lib/services/StringService.js

@@ -1,3 +1,4 @@
+import { VersionType } from '../types/VersionType.js';
 /**
  * A service which can be used to interact with strings.
  */
@@ -33,5 +34,60 @@ export default class StringService {
         }
         return 0;
     }
+    /**
+     * Checks if a version needs to be bumped based on the desired version type.
+     * This considers both registry conflicts and whether the requested version type
+     * has been incremented from the published version.
+     *
+     * @param currentVersion The current version from package.json
+     * @param publishedVersion The latest published version (or null if not published)
+     * @param requestedVersionType The type of version bump requested
+     * @returns true if a version bump is needed, false otherwise
+     */
+    static shouldBumpVersion(currentVersion, publishedVersion, requestedVersionType) {
+        // If no published version exists, no bump needed for first publish
+        if (!publishedVersion) {
+            return false;
+        }
+        const currentParts = currentVersion.split('.').map(Number);
+        const publishedParts = publishedVersion.split('.').map(Number);
+        const [currentMajor, currentMinor, currentPatch] = [
+            currentParts[0] || 0,
+            currentParts[1] || 0,
+            currentParts[2] || 0
+        ];
+        const [publishedMajor, publishedMinor, publishedPatch] = [
+            publishedParts[0] || 0,
+            publishedParts[1] || 0,
+            publishedParts[2] || 0
+        ];
+        // If current version is lower than or equal to published, always bump
+        const comparison = StringService.compareSemanticVersions(currentVersion, publishedVersion);
+        if (comparison <= 0) {
+            return true;
+        }
+        // Current version is higher than published, check if requested version type has been bumped
+        switch (requestedVersionType) {
+            case VersionType.Major:
+                // Need to bump if major version hasn't been incremented
+                return currentMajor <= publishedMajor;
+            case VersionType.Minor:
+                // Need to bump if major is same and minor hasn't been incremented
+                if (currentMajor > publishedMajor) {
+                    return false; // Major was already bumped, no need for minor
+                }
+                return currentMajor === publishedMajor && currentMinor <= publishedMinor;
+            case VersionType.Patch:
+            default:
+                // Need to bump if major and minor are same and patch hasn't been incremented
+                if (currentMajor > publishedMajor ||
+                    (currentMajor === publishedMajor && currentMinor > publishedMinor)) {
+                    return false; // Major or minor was already bumped, no need for patch
+                }
+                return (currentMajor === publishedMajor &&
+                    currentMinor === publishedMinor &&
+                    currentPatch <= publishedPatch);
+        }
+    }
 }
 //# sourceMappingURL=StringService.js.map

package/lib/services/StringService.js.map

@@ -1 +1 @@
-{"version":3,"file":"StringService.js","sourceRoot":"","sources":["../../src/services/StringService.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,aAAa;IAChC;;;;;;OAMG;IACH,MAAM,CAAC,oBAAoB,CAAC,QAAgB;QAC1C,OAAO,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC;IACnC,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,uBAAuB,CAAC,QAAgB,EAAE,QAAgB;QAC/D,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC/C,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAE/C,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;QAEzD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,EAAE,CAAC,EAAE,EAAE,CAAC;YACnC,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YAC7B,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YAE7B,IAAI,KAAK,GAAG,KAAK;gBAAE,OAAO,CAAC,CAAC,CAAC;YAC7B,IAAI,KAAK,GAAG,KAAK;gBAAE,OAAO,CAAC,CAAC;QAC9B,CAAC;QAED,OAAO,CAAC,CAAC;IACX,CAAC;CACF"}
+{"version":3,"file":"StringService.js","sourceRoot":"","sources":["../../src/services/StringService.ts"],"names":[],"mappings":"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"}