@aneuhold/core-ts-lib 2.2.9 → 2.2.10

package/lib/services/PackageService/NpmPackageService.js

@@ -0,0 +1,146 @@
+import { exec, spawn } from 'child_process';
+import { promisify } from 'util';
+import ErrorUtils from '../../utils/ErrorUtils.js';
+import { DR } from '../DependencyRegistry.js';
+import PackageServiceUtils from './PackageServiceUtils.js';
+const execAsync = promisify(exec);
+/**
+ * Service for handling NPM-specific package operations including validation and publishing.
+ */
+export default class NpmPackageService {
+    /**
+     * Validates the current project for publishing to npm. This will run
+     * `npm publish --access public --dry-run` and check for version conflicts
+     * on the npm registry.
+     *
+     * @param alternativePackageNames Optional array of alternative package names to validate publishing under
+     *
+     * **Warning:** This method uses simple string replacement for package names, which may have unintended effects
+     * if the package name appears in unexpected places. Use with caution.
+     */
+    static async validatePublish(alternativePackageNames) {
+        const { packageName: originalPackageName, version: currentVersion } = await PackageServiceUtils.getPackageInfo();
+        await PackageServiceUtils.validatePrePublishRequirements(currentVersion);
+        const packageNamesToValidate = [originalPackageName, ...(alternativePackageNames || [])];
+        for (const packageName of packageNamesToValidate) {
+            const isAlternativeName = packageName !== originalPackageName;
+            DR.logger.info(`Validating npm publishing for package: ${packageName}`);
+            if (isAlternativeName) {
+                await PackageServiceUtils.replacePackageName(originalPackageName, packageName);
+            }
+            const successfulDryRun = await NpmPackageService.publishDryRun();
+            if (!successfulDryRun) {
+                if (isAlternativeName) {
+                    await PackageServiceUtils.resetGitChanges();
+                }
+                process.exit(1);
+            }
+            await NpmPackageService.checkVersionConflicts(packageName, currentVersion);
+            if (isAlternativeName) {
+                await PackageServiceUtils.resetGitChanges();
+            }
+        }
+        DR.logger.success('Successfully validated npm publishing for all package names.');
+    }
+    /**
+     * Publishes the current project to npm.
+     *
+     * @param alternativePackageNames Optional array of alternative package names to publish under
+     *
+     * **Warning:** This method uses simple string replacement for package names, which may have unintended effects
+     * if the package name appears in unexpected places. Use with caution.
+     */
+    static async publish(alternativePackageNames) {
+        const { packageName: originalPackageName } = await PackageServiceUtils.getPackageInfo();
+        await PackageServiceUtils.validatePrePublishRequirements((await PackageServiceUtils.getPackageInfo()).version);
+        const packageNamesToPublish = [originalPackageName, ...(alternativePackageNames || [])];
+        for (const packageName of packageNamesToPublish) {
+            const isAlternativeName = packageName !== originalPackageName;
+            DR.logger.info(`Publishing to npm for package: ${packageName}`);
+            if (isAlternativeName) {
+                await PackageServiceUtils.replacePackageName(originalPackageName, packageName);
+            }
+            const result = await NpmPackageService.publishToNpm();
+            if (isAlternativeName) {
+                await PackageServiceUtils.resetGitChanges();
+            }
+            if (!result) {
+                process.exit(1);
+            }
+        }
+        DR.logger.success('Successfully published to npm for all package names.');
+    }
+    /**
+     * Executes a dry run of npm publishing.
+     *
+     * @returns true if the dry run was successful, false otherwise.
+     */
+    static async publishDryRun() {
+        DR.logger.info('Running `npm publish --access public --dry-run`');
+        try {
+            await execAsync('npm publish --access public --dry-run');
+            DR.logger.info('npm dry run completed successfully.');
+        }
+        catch (error) {
+            const errorString = ErrorUtils.getErrorString(error);
+            DR.logger.error(`npm dry run failed: ${errorString}`);
+            return false;
+        }
+        return true;
+    }
+    /**
+     * Checks npm registry for package information and performs version conflict checks.
+     *
+     * @param packageName The package name from package.json
+     * @param currentVersion The current version from package.json
+     */
+    static async checkVersionConflicts(packageName, currentVersion) {
+        DR.logger.info(`Checking npm registry for existing versions of ${packageName}...`);
+        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) {
+                const latestVersion = latestVersionMatch[1];
+                PackageServiceUtils.checkVersionConflict(currentVersion, latestVersion, 'npm');
+            }
+        }
+        catch (error) {
+            const errorString = ErrorUtils.getErrorString(error);
+            // If the package doesn't exist on npm, that's fine for first publish
+            if (errorString.includes('404') || errorString.includes('not found')) {
+                DR.logger.info('Package not found on npm - this appears to be a first publish.');
+                return;
+            }
+            // Re-throw version conflict errors
+            if (errorString.includes('already exists') || errorString.includes('is lower than')) {
+                throw error;
+            }
+            // For other npm command errors, log but don't block
+            DR.logger.warn(`Could not check npm registry: ${errorString}`);
+        }
+    }
+    /**
+     * Publishes the current project to npm.
+     *
+     * @returns true if the publish was successful, false otherwise.
+     */
+    static async publishToNpm() {
+        DR.logger.info('Running `npm publish --access public`');
+        return new Promise((resolve) => {
+            const child = spawn('npm publish', ['--access', 'public'], {
+                stdio: 'inherit',
+                shell: true
+            });
+            child.on('exit', (code) => {
+                if (code === 0) {
+                    resolve(true);
+                }
+                else {
+                    resolve(false);
+                }
+            });
+        });
+    }
+}
+//# sourceMappingURL=NpmPackageService.js.map

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

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

package/lib/services/PackageService/NpmPackageService.ts

@@ -0,0 +1,178 @@
+import { exec, spawn } from 'child_process';
+import { promisify } from 'util';
+import ErrorUtils from '../../utils/ErrorUtils.js';
+import { DR } from '../DependencyRegistry.js';
+import PackageServiceUtils from './PackageServiceUtils.js';
+
+const execAsync = promisify(exec);
+
+/**
+ * Service for handling NPM-specific package operations including validation and publishing.
+ */
+export default class NpmPackageService {
+  /**
+   * Validates the current project for publishing to npm. This will run
+   * `npm publish --access public --dry-run` and check for version conflicts
+   * on the npm registry.
+   *
+   * @param alternativePackageNames Optional array of alternative package names to validate publishing under
+   *
+   * **Warning:** This method uses simple string replacement for package names, which may have unintended effects
+   * if the package name appears in unexpected places. Use with caution.
+   */
+  static async validatePublish(alternativePackageNames?: string[]): Promise<void> {
+    const { packageName: originalPackageName, version: currentVersion } =
+      await PackageServiceUtils.getPackageInfo();
+
+    await PackageServiceUtils.validatePrePublishRequirements(currentVersion);
+
+    const packageNamesToValidate = [originalPackageName, ...(alternativePackageNames || [])];
+
+    for (const packageName of packageNamesToValidate) {
+      const isAlternativeName = packageName !== originalPackageName;
+
+      DR.logger.info(`Validating npm publishing for package: ${packageName}`);
+
+      if (isAlternativeName) {
+        await PackageServiceUtils.replacePackageName(originalPackageName, packageName);
+      }
+
+      const successfulDryRun = await NpmPackageService.publishDryRun();
+      if (!successfulDryRun) {
+        if (isAlternativeName) {
+          await PackageServiceUtils.resetGitChanges();
+        }
+        process.exit(1);
+      }
+
+      await NpmPackageService.checkVersionConflicts(packageName, currentVersion);
+
+      if (isAlternativeName) {
+        await PackageServiceUtils.resetGitChanges();
+      }
+    }
+
+    DR.logger.success('Successfully validated npm publishing for all package names.');
+  }
+
+  /**
+   * Publishes the current project to npm.
+   *
+   * @param alternativePackageNames Optional array of alternative package names to publish under
+   *
+   * **Warning:** This method uses simple string replacement for package names, which may have unintended effects
+   * if the package name appears in unexpected places. Use with caution.
+   */
+  static async publish(alternativePackageNames?: string[]): Promise<void> {
+    const { packageName: originalPackageName } = await PackageServiceUtils.getPackageInfo();
+
+    await PackageServiceUtils.validatePrePublishRequirements(
+      (await PackageServiceUtils.getPackageInfo()).version
+    );
+
+    const packageNamesToPublish = [originalPackageName, ...(alternativePackageNames || [])];
+
+    for (const packageName of packageNamesToPublish) {
+      const isAlternativeName = packageName !== originalPackageName;
+
+      DR.logger.info(`Publishing to npm for package: ${packageName}`);
+
+      if (isAlternativeName) {
+        await PackageServiceUtils.replacePackageName(originalPackageName, packageName);
+      }
+
+      const result = await NpmPackageService.publishToNpm();
+
+      if (isAlternativeName) {
+        await PackageServiceUtils.resetGitChanges();
+      }
+
+      if (!result) {
+        process.exit(1);
+      }
+    }
+
+    DR.logger.success('Successfully published to npm for all package names.');
+  }
+
+  /**
+   * Executes a dry run of npm publishing.
+   *
+   * @returns true if the dry run was successful, false otherwise.
+   */
+  private static async publishDryRun(): Promise<boolean> {
+    DR.logger.info('Running `npm publish --access public --dry-run`');
+    try {
+      await execAsync('npm publish --access public --dry-run');
+      DR.logger.info('npm dry run completed successfully.');
+    } catch (error) {
+      const errorString = ErrorUtils.getErrorString(error);
+      DR.logger.error(`npm dry run failed: ${errorString}`);
+      return false;
+    }
+    return true;
+  }
+
+  /**
+   * Checks npm registry for package information and performs version conflict checks.
+   *
+   * @param packageName The package name from package.json
+   * @param currentVersion The current version from package.json
+   */
+  private static async checkVersionConflicts(
+    packageName: string,
+    currentVersion: string
+  ): Promise<void> {
+    DR.logger.info(`Checking npm registry for existing versions of ${packageName}...`);
+
+    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) {
+        const latestVersion = latestVersionMatch[1];
+        PackageServiceUtils.checkVersionConflict(currentVersion, latestVersion, 'npm');
+      }
+    } catch (error) {
+      const errorString = ErrorUtils.getErrorString(error);
+
+      // If the package doesn't exist on npm, that's fine for first publish
+      if (errorString.includes('404') || errorString.includes('not found')) {
+        DR.logger.info('Package not found on npm - this appears to be a first publish.');
+        return;
+      }
+
+      // Re-throw version conflict errors
+      if (errorString.includes('already exists') || errorString.includes('is lower than')) {
+        throw error;
+      }
+
+      // For other npm command errors, log but don't block
+      DR.logger.warn(`Could not check npm registry: ${errorString}`);
+    }
+  }
+
+  /**
+   * Publishes the current project to npm.
+   *
+   * @returns true if the publish was successful, false otherwise.
+   */
+  private static async publishToNpm(): Promise<boolean> {
+    DR.logger.info('Running `npm publish --access public`');
+    return new Promise((resolve) => {
+      const child = spawn('npm publish', ['--access', 'public'], {
+        stdio: 'inherit',
+        shell: true
+      });
+
+      child.on('exit', (code) => {
+        if (code === 0) {
+          resolve(true);
+        } else {
+          resolve(false);
+        }
+      });
+    });
+  }
+}

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

@@ -0,0 +1,77 @@
+import { VersionType } from '../../types/VersionType.js';
+/**
+ * A service which can be used to assist in publishing or validating packages
+ * for the current project. This service provides convenient aliases to the
+ * specialized JSR and NPM package services.
+ */
+export default class PackageService {
+    /**
+     * Validates the current project for publishing to JSR. This will check if the
+     * project has any pending changes first, then update the version of the
+     * jsr.json to match the package.json file, then run the
+     * `jsr publish --dry-run` command, and finally cleanup the changes made.
+     *
+     * @param alternativePackageNames Optional array of alternative package names to validate publishing under
+     *
+     * **Warning:** This method uses simple string replacement for package names, which may have unintended effects
+     * if the package name appears in unexpected places. Use with caution.
+     */
+    static validateJsrPublish(alternativePackageNames?: string[]): Promise<void>;
+    /**
+     * Publishes the current project to JSR.
+     *
+     * @param alternativePackageNames Optional array of alternative package names to publish under
+     *
+     * **Warning:** This method uses simple string replacement for package names, which may have unintended effects
+     * if the package name appears in unexpected places. Use with caution.
+     */
+    static publishToJsr(alternativePackageNames?: string[]): Promise<void>;
+    /**
+     * Validates the current project for publishing to npm. This will run
+     * `npm publish --access public --dry-run` and check for version conflicts
+     * on the npm registry.
+     *
+     * @param alternativePackageNames Optional array of alternative package names to validate publishing under
+     *
+     * **Warning:** This method uses simple string replacement for package names, which may have unintended effects
+     * if the package name appears in unexpected places. Use with caution.
+     */
+    static validateNpmPublish(alternativePackageNames?: string[]): Promise<void>;
+    /**
+     * Publishes the current project to npm.
+     *
+     * @param alternativePackageNames Optional array of alternative package names to publish under
+     *
+     * **Warning:** This method uses simple string replacement for package names, which may have unintended effects
+     * if the package name appears in unexpected places. Use with caution.
+     */
+    static publishToNpm(alternativePackageNames?: string[]): Promise<void>;
+    /**
+     * Test method for string replacement functionality. This method allows testing
+     * the string replacement behavior without performing actual publishing operations.
+     *
+     * @param originalString The original string to replace
+     * @param newString The new string to replace it with
+     *
+     * **Warning:** This method uses simple string replacement, which may have unintended effects
+     * if the string appears in unexpected places. Use with caution.
+     */
+    static testStringReplacement(originalString: string, newString: string): 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>;
+}
+//# sourceMappingURL=PackageService.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PackageService.d.ts","sourceRoot":"","sources":["../../../src/services/PackageService/PackageService.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAMzD;;;;GAIG;AACH,MAAM,CAAC,OAAO,OAAO,cAAc;IACjC;;;;;;;;;;OAUG;WACU,kBAAkB,CAAC,uBAAuB,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlF;;;;;;;OAOG;WACU,YAAY,CAAC,uBAAuB,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAI5E;;;;;;;;;OASG;WACU,kBAAkB,CAAC,uBAAuB,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlF;;;;;;;OAOG;WACU,YAAY,CAAC,uBAAuB,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAI5E;;;;;;;;;OASG;WACU,qBAAqB,CAAC,cAAc,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ5F;;;;;OAKG;WACU,mBAAmB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIrE;;;;;;;OAOG;WACU,yCAAyC,CACpD,WAAW,CAAC,EAAE,WAAW,EACzB,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC;CAGjB"}

package/lib/services/PackageService/PackageService.js

@@ -0,0 +1,96 @@
+import { DR } from '../DependencyRegistry.js';
+import JsrPackageService from './JsrPackageService.js';
+import NpmPackageService from './NpmPackageService.js';
+import PackageServiceUtils from './PackageServiceUtils.js';
+/**
+ * A service which can be used to assist in publishing or validating packages
+ * for the current project. This service provides convenient aliases to the
+ * specialized JSR and NPM package services.
+ */
+export default class PackageService {
+    /**
+     * Validates the current project for publishing to JSR. This will check if the
+     * project has any pending changes first, then update the version of the
+     * jsr.json to match the package.json file, then run the
+     * `jsr publish --dry-run` command, and finally cleanup the changes made.
+     *
+     * @param alternativePackageNames Optional array of alternative package names to validate publishing under
+     *
+     * **Warning:** This method uses simple string replacement for package names, which may have unintended effects
+     * if the package name appears in unexpected places. Use with caution.
+     */
+    static async validateJsrPublish(alternativePackageNames) {
+        return JsrPackageService.validatePublish(alternativePackageNames);
+    }
+    /**
+     * Publishes the current project to JSR.
+     *
+     * @param alternativePackageNames Optional array of alternative package names to publish under
+     *
+     * **Warning:** This method uses simple string replacement for package names, which may have unintended effects
+     * if the package name appears in unexpected places. Use with caution.
+     */
+    static async publishToJsr(alternativePackageNames) {
+        return JsrPackageService.publish(alternativePackageNames);
+    }
+    /**
+     * Validates the current project for publishing to npm. This will run
+     * `npm publish --access public --dry-run` and check for version conflicts
+     * on the npm registry.
+     *
+     * @param alternativePackageNames Optional array of alternative package names to validate publishing under
+     *
+     * **Warning:** This method uses simple string replacement for package names, which may have unintended effects
+     * if the package name appears in unexpected places. Use with caution.
+     */
+    static async validateNpmPublish(alternativePackageNames) {
+        return NpmPackageService.validatePublish(alternativePackageNames);
+    }
+    /**
+     * Publishes the current project to npm.
+     *
+     * @param alternativePackageNames Optional array of alternative package names to publish under
+     *
+     * **Warning:** This method uses simple string replacement for package names, which may have unintended effects
+     * if the package name appears in unexpected places. Use with caution.
+     */
+    static async publishToNpm(alternativePackageNames) {
+        return NpmPackageService.publish(alternativePackageNames);
+    }
+    /**
+     * Test method for string replacement functionality. This method allows testing
+     * the string replacement behavior without performing actual publishing operations.
+     *
+     * @param originalString The original string to replace
+     * @param newString The new string to replace it with
+     *
+     * **Warning:** This method uses simple string replacement, which may have unintended effects
+     * if the string appears in unexpected places. Use with caution.
+     */
+    static async testStringReplacement(originalString, newString) {
+        DR.logger.info(`Testing string replacement from "${originalString}" to "${newString}"`);
+        await PackageServiceUtils.replacePackageName(originalString, newString);
+        DR.logger.info('Test completed - package name replacement has been applied');
+    }
+    /**
+     * 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) {
+        return PackageServiceUtils.initializeChangelog(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, packagePath) {
+        return PackageServiceUtils.bumpVersionIfNeededAndInitializeChangelog(versionType, packagePath);
+    }
+}
+//# sourceMappingURL=PackageService.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PackageService.js","sourceRoot":"","sources":["../../../src/services/PackageService/PackageService.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,EAAE,EAAE,MAAM,0BAA0B,CAAC;AAC9C,OAAO,iBAAiB,MAAM,wBAAwB,CAAC;AACvD,OAAO,iBAAiB,MAAM,wBAAwB,CAAC;AACvD,OAAO,mBAAmB,MAAM,0BAA0B,CAAC;AAE3D;;;;GAIG;AACH,MAAM,CAAC,OAAO,OAAO,cAAc;IACjC;;;;;;;;;;OAUG;IACH,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,uBAAkC;QAChE,OAAO,iBAAiB,CAAC,eAAe,CAAC,uBAAuB,CAAC,CAAC;IACpE,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,uBAAkC;QAC1D,OAAO,iBAAiB,CAAC,OAAO,CAAC,uBAAuB,CAAC,CAAC;IAC5D,CAAC;IAED;;;;;;;;;OASG;IACH,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,uBAAkC;QAChE,OAAO,iBAAiB,CAAC,eAAe,CAAC,uBAAuB,CAAC,CAAC;IACpE,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,uBAAkC;QAC1D,OAAO,iBAAiB,CAAC,OAAO,CAAC,uBAAuB,CAAC,CAAC;IAC5D,CAAC;IAED;;;;;;;;;OASG;IACH,MAAM,CAAC,KAAK,CAAC,qBAAqB,CAAC,cAAsB,EAAE,SAAiB;QAC1E,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,oCAAoC,cAAc,SAAS,SAAS,GAAG,CAAC,CAAC;QAExF,MAAM,mBAAmB,CAAC,kBAAkB,CAAC,cAAc,EAAE,SAAS,CAAC,CAAC;QAExE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,4DAA4D,CAAC,CAAC;IAC/E,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,KAAK,CAAC,mBAAmB,CAAC,WAAoB;QACnD,OAAO,mBAAmB,CAAC,mBAAmB,CAAC,WAAW,CAAC,CAAC;IAC9D,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,KAAK,CAAC,yCAAyC,CACpD,WAAyB,EACzB,WAAoB;QAEpB,OAAO,mBAAmB,CAAC,yCAAyC,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;IACjG,CAAC;CACF"}

package/lib/services/PackageService/PackageService.ts

@@ -0,0 +1,108 @@
+import { VersionType } from '../../types/VersionType.js';
+import { DR } from '../DependencyRegistry.js';
+import JsrPackageService from './JsrPackageService.js';
+import NpmPackageService from './NpmPackageService.js';
+import PackageServiceUtils from './PackageServiceUtils.js';
+
+/**
+ * A service which can be used to assist in publishing or validating packages
+ * for the current project. This service provides convenient aliases to the
+ * specialized JSR and NPM package services.
+ */
+export default class PackageService {
+  /**
+   * Validates the current project for publishing to JSR. This will check if the
+   * project has any pending changes first, then update the version of the
+   * jsr.json to match the package.json file, then run the
+   * `jsr publish --dry-run` command, and finally cleanup the changes made.
+   *
+   * @param alternativePackageNames Optional array of alternative package names to validate publishing under
+   *
+   * **Warning:** This method uses simple string replacement for package names, which may have unintended effects
+   * if the package name appears in unexpected places. Use with caution.
+   */
+  static async validateJsrPublish(alternativePackageNames?: string[]): Promise<void> {
+    return JsrPackageService.validatePublish(alternativePackageNames);
+  }
+
+  /**
+   * Publishes the current project to JSR.
+   *
+   * @param alternativePackageNames Optional array of alternative package names to publish under
+   *
+   * **Warning:** This method uses simple string replacement for package names, which may have unintended effects
+   * if the package name appears in unexpected places. Use with caution.
+   */
+  static async publishToJsr(alternativePackageNames?: string[]): Promise<void> {
+    return JsrPackageService.publish(alternativePackageNames);
+  }
+
+  /**
+   * Validates the current project for publishing to npm. This will run
+   * `npm publish --access public --dry-run` and check for version conflicts
+   * on the npm registry.
+   *
+   * @param alternativePackageNames Optional array of alternative package names to validate publishing under
+   *
+   * **Warning:** This method uses simple string replacement for package names, which may have unintended effects
+   * if the package name appears in unexpected places. Use with caution.
+   */
+  static async validateNpmPublish(alternativePackageNames?: string[]): Promise<void> {
+    return NpmPackageService.validatePublish(alternativePackageNames);
+  }
+
+  /**
+   * Publishes the current project to npm.
+   *
+   * @param alternativePackageNames Optional array of alternative package names to publish under
+   *
+   * **Warning:** This method uses simple string replacement for package names, which may have unintended effects
+   * if the package name appears in unexpected places. Use with caution.
+   */
+  static async publishToNpm(alternativePackageNames?: string[]): Promise<void> {
+    return NpmPackageService.publish(alternativePackageNames);
+  }
+
+  /**
+   * Test method for string replacement functionality. This method allows testing
+   * the string replacement behavior without performing actual publishing operations.
+   *
+   * @param originalString The original string to replace
+   * @param newString The new string to replace it with
+   *
+   * **Warning:** This method uses simple string replacement, which may have unintended effects
+   * if the string appears in unexpected places. Use with caution.
+   */
+  static async testStringReplacement(originalString: string, newString: string): Promise<void> {
+    DR.logger.info(`Testing string replacement from "${originalString}" to "${newString}"`);
+
+    await PackageServiceUtils.replacePackageName(originalString, newString);
+
+    DR.logger.info('Test completed - package name replacement has been applied');
+  }
+
+  /**
+   * 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> {
+    return PackageServiceUtils.initializeChangelog(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,
+    packagePath?: string
+  ): Promise<void> {
+    return PackageServiceUtils.bumpVersionIfNeededAndInitializeChangelog(versionType, packagePath);
+  }
+}