ph-cmd 5.2.0-staging.9 → 5.3.0-staging.1

package/dist/src/commands/use.js

@@ -1,199 +1,117 @@
-import { existsSync, readdirSync, readFileSync } from "node:fs";
-import path from "node:path";
-import { useHelp } from "../help.js";
-import { getPackageManagerFromLockfile, getProjectInfo, installDependency, resolvePackageManagerOptions, updateDependencyVersionString, withCustomHelp, } from "../utils/index.js";
-export const ORG = "@powerhousedao";
-// Special packages that don't use the @powerhousedao organization
-export const SPECIAL_PACKAGES = [
-    "document-model",
-    "document-drive",
-    "@renown/sdk",
-];
-// Packages to exclude from dynamic detection (external dependencies)
-export const EXCLUDED_PACKAGES = [
-    "@powerhousedao/document-engineering",
-    "@powerhousedao/scalars",
-    "@powerhousedao/diff-analyzer",
-    "@powerhousedao/analytics-engine-core",
-    "@powerhousedao/analytics-engine-graphql",
-    "@powerhousedao/analytics-engine-pg",
-    "@powerhousedao/analytics-engine-browser",
-    "@powerhousedao/analytics-engine-knex",
-];
-/**
- * Detects all Powerhouse packages from package.json dependencies
- * @param packageJson - The parsed package.json object
- * @returns Array of package names to process
- */
-export function detectPowerhousePackages(packageJson) {
-    const allDependencies = {
-        ...(packageJson.dependencies || {}),
-        ...(packageJson.devDependencies || {}),
-    };
-    const powerhousePackages = [];
-    // Find all @powerhousedao packages (excluding document-engineering)
-    Object.keys(allDependencies).forEach((dep) => {
-        if (dep.startsWith(ORG + "/") && !EXCLUDED_PACKAGES.includes(dep)) {
-            powerhousePackages.push(dep);
+import { getPackageVersion } from "@powerhousedao/codegen/utils";
+import chalk from "chalk";
+import { boolean, command, flag, oneOf, option, optional, positional, run, string, } from "cmd-ts";
+import { detect } from "package-manager-detector/detect";
+import { readPackage } from "read-pkg";
+import { clean, valid } from "semver";
+import { writePackage } from "write-package";
+import { ALL_POWERHOUSE_DEPENDENCIES } from "../utils/constants.js";
+import { handleMutuallyExclusiveOptions, logVersionUpdate, } from "../utils/parsing.js";
+import { runCmd } from "../utils/run-cmd.js";
+const commandParser = command({
+    name: "ph use",
+    description: "Specify the release version of Powerhouse dependencies to use.\nTo use a release tag, specify `staging`, `dev`, or `latest` as the first argument to this command or with the --tag option.\n You can also use a specific version with the --version option.",
+    args: {
+        tagPositional: positional({
+            type: optional(oneOf(["latest", "staging", "dev"])),
+            displayName: "tag",
+            description: `Specify the release tag to use for your project. Can be one of: "latest", "staging", or "dev".`,
+        }),
+        tagOption: option({
+            type: optional(oneOf(["latest", "staging", "dev"])),
+            long: "tag",
+            short: "t",
+            description: `Specify the release tag to use for your project. Can be one of: "latest", "staging", or "dev".`,
+        }),
+        version: option({
+            type: optional(string),
+            long: "version",
+            short: "v",
+            description: "Specify the exact semver release version to use for your project.",
+        }),
+        skipInstall: flag({
+            type: optional(boolean),
+            long: "skip-install",
+            short: "s",
+            description: "Skip running `install` with your package manager",
+        }),
+    },
+    handler: async ({ tagPositional, tagOption, version, skipInstall }) => {
+        const tag = tagPositional ?? tagOption;
+        handleMutuallyExclusiveOptions({ tag, version }, "versioning strategy");
+        if (!tag && !version) {
+            throw new Error("Please specify either a release tag or a version to use.");
         }
-    });
-    // Add special packages if they exist
-    SPECIAL_PACKAGES.forEach((pkg) => {
-        if (allDependencies[pkg]) {
-            powerhousePackages.push(pkg);
+        if (version && !valid(clean(version))) {
+            throw new Error(`❌ Invalid version: ${chalk.bold(version)}`);
         }
-    });
-    return powerhousePackages;
-}
-/**
- * Maps a package name to its monorepo directory path by reading package.json files
- * @param packageName - The package name (e.g., '@powerhousedao/common' or 'document-model')
- * @param localPath - The base path to the monorepo
- * @returns The full path to the package directory
- */
-export function mapPackageToMonorepoPath(packageName, localPath) {
-    // Search in all possible locations
-    const searchDirs = [
-        path.join(localPath, "packages"),
-        path.join(localPath, "apps"),
-        path.join(localPath, "clis"),
-    ];
-    for (const searchDir of searchDirs) {
-        if (!existsSync(searchDir))
-            continue;
-        try {
-            // Read all subdirectories
-            const subdirs = readdirSync(searchDir, { withFileTypes: true })
-                .filter((dirent) => dirent.isDirectory())
-                .map((dirent) => dirent.name);
-            // Check each subdirectory's package.json
-            for (const subdir of subdirs) {
-                const packageJsonPath = path.join(searchDir, subdir, "package.json");
-                if (existsSync(packageJsonPath)) {
-                    try {
-                        const content = readFileSync(packageJsonPath, "utf-8");
-                        const pkg = JSON.parse(content);
-                        if (pkg.name === packageName) {
-                            return path.join(searchDir, subdir);
-                        }
-                    }
-                    catch {
-                        // Ignore invalid package.json files
-                    }
+        console.log(`▶️ Updating project to use ${chalk.bold(version ?? tag)}...\n`);
+        const packageJson = await readPackage();
+        if (packageJson.dependencies) {
+            for (const [name, existingVersion] of Object.entries(packageJson.dependencies)) {
+                if (existingVersion && ALL_POWERHOUSE_DEPENDENCIES.includes(name)) {
+                    const newVersion = await getPackageVersion({ name, tag, version });
+                    packageJson.dependencies[name] = newVersion;
+                    logVersionUpdate({
+                        name,
+                        version: existingVersion,
+                        newVersion,
+                    });
                 }
             }
         }
-        catch {
-            // Ignore errors reading directory
-            continue;
+        if (packageJson.devDependencies) {
+            for (const [name, existingVersion] of Object.entries(packageJson.devDependencies)) {
+                if (existingVersion && ALL_POWERHOUSE_DEPENDENCIES.includes(name)) {
+                    const newVersion = await getPackageVersion({ name, tag, version });
+                    packageJson.devDependencies[name] = newVersion;
+                    logVersionUpdate({
+                        name,
+                        version: existingVersion,
+                        newVersion,
+                    });
+                }
+            }
         }
-    }
-    // Fallback to old behavior if not found
-    const baseName = packageName.startsWith(ORG + "/")
-        ? packageName.substring(ORG.length + 1)
-        : packageName;
-    return path.join(localPath, "packages", baseName);
-}
-export const ENV_MAP = {
-    dev: "dev",
-    staging: "staging",
-    prod: "latest",
-    latest: "latest",
-};
-export const updatePackageJson = async (env, localPath, packageManager, debug, useResolved) => {
-    const projectInfo = await getProjectInfo();
-    const pkgManager = packageManager || getPackageManagerFromLockfile(projectInfo.path);
-    if (debug) {
-        console.log(">>> projectInfo", projectInfo);
-        console.log(">>> pkgManager", pkgManager);
-    }
-    // Read the project's package.json
-    const packageJsonPath = path.join(projectInfo.path, "package.json");
-    const packageJsonContent = readFileSync(packageJsonPath, "utf-8");
-    const packageJson = JSON.parse(packageJsonContent);
-    // Detect all Powerhouse packages from the current package.json
-    const powerhousePackages = detectPowerhousePackages(packageJson);
-    const dependencies = [];
-    if (localPath) {
-        // For local path, map each detected package to its monorepo path
-        powerhousePackages.forEach((packageName) => {
-            const fullPath = mapPackageToMonorepoPath(packageName, localPath);
-            dependencies.push(fullPath);
-        });
-    }
-    else {
-        // For remote dependencies, add version tags
-        powerhousePackages.forEach((packageName) => {
-            dependencies.push(`${packageName}@${ENV_MAP[env]}`);
-        });
-    }
-    if (debug) {
-        console.log(">>> dependencies to update", dependencies);
-    }
-    if (dependencies.length === 0) {
-        console.log("ℹ️ No Powerhouse dependencies found to update");
-        return;
-    }
-    try {
-        console.log("⚙️ Updating dependencies...");
-        if (localPath || useResolved) {
-            installDependency(pkgManager, dependencies, projectInfo.path);
+        if (packageJson.optionalDependencies) {
+            for (const [name, existingVersion] of Object.entries(packageJson.optionalDependencies)) {
+                if (existingVersion && ALL_POWERHOUSE_DEPENDENCIES.includes(name)) {
+                    const newVersion = await getPackageVersion({ name, tag, version });
+                    packageJson.optionalDependencies[name] = newVersion;
+                    logVersionUpdate({
+                        name,
+                        version: existingVersion,
+                        newVersion,
+                    });
+                }
+            }
         }
-        else {
-            updateDependencyVersionString(pkgManager, dependencies, projectInfo.path);
+        if (packageJson.peerDependencies) {
+            for (const [name, existingVersion] of Object.entries(packageJson.peerDependencies)) {
+                if (existingVersion && ALL_POWERHOUSE_DEPENDENCIES.includes(name)) {
+                    const newVersion = await getPackageVersion({ name, tag, version });
+                    packageJson.peerDependencies[name] = newVersion;
+                    logVersionUpdate({
+                        name,
+                        version: existingVersion,
+                        newVersion,
+                    });
+                }
+            }
         }
-        console.log("✅ Dependencies updated successfully");
-    }
-    catch (error) {
-        console.error("❌ Failed to update dependencies");
-        throw error;
-    }
-};
-export const use = async (environment, localPath, options) => {
-    if (!environment ||
-        (!options.force &&
-            environment !== "local" &&
-            !Object.keys(ENV_MAP).includes(environment))) {
-        throw new Error(`❌ Invalid environment, use --force or use one of the following: ${Object.keys(ENV_MAP).join(", ")}`);
-    }
-    if (environment === "local" && !localPath) {
-        throw new Error("❌ Local environment requires a local path, please specify the path to the local environment");
-    }
-    const { debug } = options;
-    const env = environment;
-    if (debug) {
-        console.log(">>> options", options);
-    }
-    const projectInfo = await getProjectInfo();
-    const packageManager = resolvePackageManagerOptions(options) ??
-        getPackageManagerFromLockfile(projectInfo.path);
-    await updatePackageJson(env, localPath, packageManager, debug, options.useResolved);
-};
-export function useCommand(program) {
-    const useCmd = program
-        .command("use")
-        .description("Allows you to change your environment (latest, development, production, local)")
-        .argument("[environment]", "The environment to use (latest, dev, prod, local)")
-        .argument("[localPath]", "The path to the local environment (you have to specify the path to the local environment)")
-        .option("--force", "force environment to use")
-        .option("--use-resolved", "Use resolved dependency versions")
-        .option("--package-manager <packageManager>", "package manager to be used")
-        .option("--pnpm", "Use 'pnpm' as package manager")
-        .option("--yarn", "Use 'yarn' as package manager")
-        .option("--bun", "Use 'bun' as package manager")
-        .option("--debug", "Show additional logs");
-    // Use withCustomHelp instead of withHelpAction and addHelpText
-    return withCustomHelp(useCmd, use, useHelp, 
-    // Pre-check function to validate environment before running the action
-    (environment) => {
-        if (!environment &&
-            !process.argv.includes("--help") &&
-            !process.argv.includes("-h")) {
-            console.error('Error: Missing required argument "environment"');
-            process.exit(1);
-            return false;
+        await writePackage(packageJson);
+        console.log(chalk.green(`\n✅ Project updated to use ${chalk.bold(version ?? tag)}\n`));
+        if (skipInstall)
+            return;
+        const packageManager = await detect();
+        if (!packageManager) {
+            throw new Error(`❌ Failed to detect your package manager. Run install manually.`);
         }
-        return true;
-    });
+        console.log(`▶️ Installing updated dependencies with \`${packageManager.agent}\`\n`);
+        runCmd(`${packageManager.agent} install`);
+    },
+});
+export async function use(args) {
+    await run(commandParser, args);
 }
 //# sourceMappingURL=use.js.map

package/dist/src/commands/use.js.map

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

package/dist/src/commands/use.old.d.ts

@@ -0,0 +1,55 @@
+import type { Command } from "commander";
+import type { CommandActionType } from "../types.js";
+import type { PackageManager } from "../utils/index.js";
+export declare const ORG = "@powerhousedao";
+export declare const SPECIAL_PACKAGES: string[];
+export declare const EXCLUDED_PACKAGES: string[];
+/**
+ * Detects all Powerhouse packages from package.json dependencies
+ * @param packageJson - The parsed package.json object
+ * @returns Array of package names to process
+ */
+export declare function detectPowerhousePackages(packageJson: {
+    dependencies?: Record<string, string>;
+    devDependencies?: Record<string, string>;
+}): string[];
+/**
+ * Maps a package name to its monorepo directory path by reading package.json files
+ * @param packageName - The package name (e.g., '@powerhousedao/common' or 'document-model')
+ * @param localPath - The base path to the monorepo
+ * @returns The full path to the package directory
+ */
+export declare function mapPackageToMonorepoPath(packageName: string, localPath: string): string;
+export declare const ENV_MAP: {
+    dev: string;
+    staging: string;
+    prod: string;
+    latest: string;
+};
+export type Environment = keyof typeof ENV_MAP;
+/**
+ * Checks if a string is a valid semver version
+ * Supports formats like: 1.0.0, 1.0.0-beta.1, 1.0.0-dev.123, v1.0.0
+ */
+export declare function isVersionString(str: string): boolean;
+export declare const updatePackageJson: (envOrVersion: (typeof ENV_MAP)[keyof typeof ENV_MAP], localPath?: string, packageManager?: PackageManager, debug?: boolean, useResolved?: boolean) => Promise<void>;
+export type UseOptions = {
+    dev?: boolean;
+    prod?: boolean;
+    local?: string;
+    debug?: boolean;
+    latest?: boolean;
+    force?: boolean;
+    packageManager?: string;
+    pnpm?: boolean;
+    yarn?: boolean;
+    bun?: boolean;
+    useResolved?: boolean;
+};
+export declare const use: CommandActionType<[
+    string | undefined,
+    string | undefined,
+    UseOptions
+]>;
+export declare function useCommand(program: Command): Command;
+//# sourceMappingURL=use.old.d.ts.map

package/dist/src/commands/use.old.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use.old.d.ts","sourceRoot":"","sources":["../../../src/commands/use.old.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIzC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAUxD,eAAO,MAAM,GAAG,mBAAmB,CAAC;AAGpC,eAAO,MAAM,gBAAgB,UAI5B,CAAC;AAGF,eAAO,MAAM,iBAAiB,UAS7B,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,WAAW,EAAE;IACpD,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC1C,GAAG,MAAM,EAAE,CAuBX;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB,MAAM,CA2CR;AAED,eAAO,MAAM,OAAO;;;;;CAKnB,CAAC;AAGF,MAAM,MAAM,WAAW,GAAG,MAAM,OAAO,OAAO,CAAC;AAE/C;;;GAGG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAOpD;AAED,eAAO,MAAM,iBAAiB,GAC5B,cAAc,CAAC,OAAO,OAAO,EAAE,MAAM,OAAO,OAAO,CAAC,EACpD,YAAY,MAAM,EAClB,iBAAiB,cAAc,EAC/B,QAAQ,OAAO,EACf,cAAc,OAAO,kBAgEtB,CAAC;AAGF,MAAM,MAAM,UAAU,GAAG;IACvB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,CAAC;AAEF,eAAO,MAAM,GAAG,EAAE,iBAAiB,CACjC;IAAC,MAAM,GAAG,SAAS;IAAE,MAAM,GAAG,SAAS;IAAE,UAAU;CAAC,CA0CrD,CAAC;AAEF,wBAAgB,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAyCpD"}

package/dist/src/commands/use.old.js

@@ -0,0 +1,219 @@
+import { existsSync, readdirSync, readFileSync } from "node:fs";
+import path from "node:path";
+import { useHelp } from "../help.js";
+import { getPackageManagerFromLockfile, getProjectInfo, installDependency, updateDependencyVersionString, withCustomHelp, } from "../utils/index.js";
+import { parsePackageManager } from "../utils/parsing.js";
+export const ORG = "@powerhousedao";
+// Special packages that don't use the @powerhousedao organization
+export const SPECIAL_PACKAGES = [
+    "document-model",
+    "document-drive",
+    "@renown/sdk",
+];
+// Packages to exclude from dynamic detection (external dependencies)
+export const EXCLUDED_PACKAGES = [
+    "@powerhousedao/document-engineering",
+    "@powerhousedao/scalars",
+    "@powerhousedao/diff-analyzer",
+    "@powerhousedao/analytics-engine-core",
+    "@powerhousedao/analytics-engine-graphql",
+    "@powerhousedao/analytics-engine-pg",
+    "@powerhousedao/analytics-engine-browser",
+    "@powerhousedao/analytics-engine-knex",
+];
+/**
+ * Detects all Powerhouse packages from package.json dependencies
+ * @param packageJson - The parsed package.json object
+ * @returns Array of package names to process
+ */
+export function detectPowerhousePackages(packageJson) {
+    const allDependencies = {
+        ...(packageJson.dependencies || {}),
+        ...(packageJson.devDependencies || {}),
+    };
+    const powerhousePackages = [];
+    // Find all @powerhousedao packages (excluding document-engineering)
+    Object.keys(allDependencies).forEach((dep) => {
+        if (dep.startsWith(ORG + "/") && !EXCLUDED_PACKAGES.includes(dep)) {
+            powerhousePackages.push(dep);
+        }
+    });
+    // Add special packages if they exist
+    SPECIAL_PACKAGES.forEach((pkg) => {
+        if (allDependencies[pkg]) {
+            powerhousePackages.push(pkg);
+        }
+    });
+    return powerhousePackages;
+}
+/**
+ * Maps a package name to its monorepo directory path by reading package.json files
+ * @param packageName - The package name (e.g., '@powerhousedao/common' or 'document-model')
+ * @param localPath - The base path to the monorepo
+ * @returns The full path to the package directory
+ */
+export function mapPackageToMonorepoPath(packageName, localPath) {
+    // Search in all possible locations
+    const searchDirs = [
+        path.join(localPath, "packages"),
+        path.join(localPath, "apps"),
+        path.join(localPath, "clis"),
+    ];
+    for (const searchDir of searchDirs) {
+        if (!existsSync(searchDir))
+            continue;
+        try {
+            // Read all subdirectories
+            const subdirs = readdirSync(searchDir, { withFileTypes: true })
+                .filter((dirent) => dirent.isDirectory())
+                .map((dirent) => dirent.name);
+            // Check each subdirectory's package.json
+            for (const subdir of subdirs) {
+                const packageJsonPath = path.join(searchDir, subdir, "package.json");
+                if (existsSync(packageJsonPath)) {
+                    try {
+                        const content = readFileSync(packageJsonPath, "utf-8");
+                        const pkg = JSON.parse(content);
+                        if (pkg.name === packageName) {
+                            return path.join(searchDir, subdir);
+                        }
+                    }
+                    catch {
+                        // Ignore invalid package.json files
+                    }
+                }
+            }
+        }
+        catch {
+            // Ignore errors reading directory
+            continue;
+        }
+    }
+    // Fallback to old behavior if not found
+    const baseName = packageName.startsWith(ORG + "/")
+        ? packageName.substring(ORG.length + 1)
+        : packageName;
+    return path.join(localPath, "packages", baseName);
+}
+export const ENV_MAP = {
+    dev: "dev",
+    staging: "staging",
+    prod: "latest",
+    latest: "latest",
+};
+/**
+ * Checks if a string is a valid semver version
+ * Supports formats like: 1.0.0, 1.0.0-beta.1, 1.0.0-dev.123, v1.0.0
+ */
+export function isVersionString(str) {
+    // Remove leading 'v' if present
+    const version = str.startsWith("v") ? str.slice(1) : str;
+    // Semver regex pattern
+    const semverPattern = /^\d+\.\d+\.\d+(-[a-zA-Z0-9]+(\.[a-zA-Z0-9]+)*)?(\+[a-zA-Z0-9]+(\.[a-zA-Z0-9]+)*)?$/;
+    return semverPattern.test(version);
+}
+export const updatePackageJson = async (envOrVersion, localPath, packageManager, debug, useResolved) => {
+    const projectInfo = await getProjectInfo();
+    const pkgManager = packageManager || getPackageManagerFromLockfile(projectInfo.path);
+    if (debug) {
+        console.log(">>> projectInfo", projectInfo);
+        console.log(">>> pkgManager", pkgManager);
+    }
+    // Read the project's package.json
+    const packageJsonPath = path.join(projectInfo.path, "package.json");
+    const packageJsonContent = readFileSync(packageJsonPath, "utf-8");
+    const packageJson = JSON.parse(packageJsonContent);
+    // Detect all Powerhouse packages from the current package.json
+    const powerhousePackages = detectPowerhousePackages(packageJson);
+    const dependencies = [];
+    if (localPath) {
+        // For local path, map each detected package to its monorepo path
+        powerhousePackages.forEach((packageName) => {
+            const fullPath = mapPackageToMonorepoPath(packageName, localPath);
+            dependencies.push(fullPath);
+        });
+    }
+    else {
+        // Determine the version tag to use
+        // For specific versions, add ^ prefix to allow semver range updates
+        const versionTag = isVersionString(envOrVersion)
+            ? `^${envOrVersion.replace(/^v/, "")}` // Remove leading 'v' if present and add ^
+            : ENV_MAP[envOrVersion];
+        // For remote dependencies, add version tags
+        powerhousePackages.forEach((packageName) => {
+            dependencies.push(`${packageName}@${versionTag}`);
+        });
+    }
+    if (debug) {
+        console.log(">>> dependencies to update", dependencies);
+    }
+    if (dependencies.length === 0) {
+        console.log("ℹ️ No Powerhouse dependencies found to update");
+        return;
+    }
+    try {
+        console.log("⚙️ Updating dependencies...");
+        if (localPath || useResolved) {
+            installDependency(pkgManager, dependencies, projectInfo.path);
+        }
+        else {
+            updateDependencyVersionString(pkgManager, dependencies, projectInfo.path);
+        }
+        console.log("✅ Dependencies updated successfully");
+    }
+    catch (error) {
+        console.error("❌ Failed to update dependencies");
+        throw error;
+    }
+};
+export const use = async (environment, localPath, options) => {
+    const isVersion = environment ? isVersionString(environment) : false;
+    if (!environment ||
+        (!options.force &&
+            environment !== "local" &&
+            !isVersion &&
+            !Object.keys(ENV_MAP).includes(environment))) {
+        throw new Error(`❌ Invalid environment, use --force or use one of the following: ${Object.keys(ENV_MAP).join(", ")}, or a specific version (e.g., 5.1.0)`);
+    }
+    if (environment === "local" && !localPath) {
+        throw new Error("❌ Local environment requires a local path, please specify the path to the local environment");
+    }
+    const { debug } = options;
+    // environment can be an Environment key or a version string
+    const envOrVersion = environment;
+    if (debug) {
+        console.log(">>> options", options);
+    }
+    const projectInfo = await getProjectInfo();
+    const packageManager = parsePackageManager(options) ??
+        getPackageManagerFromLockfile(projectInfo.path);
+    await updatePackageJson(envOrVersion, localPath, packageManager, debug, options.useResolved);
+};
+export function useCommand(program) {
+    const useCmd = program
+        .command("use")
+        .description("Allows you to change your environment (latest, dev, staging, prod, local) or use a specific version (e.g., 5.1.0)")
+        .argument("[environment]", "The environment to use (latest, dev, staging, prod, local) or a specific version (e.g., 5.1.0)")
+        .argument("[localPath]", "The path to the local environment (you have to specify the path to the local environment)")
+        .option("--force", "force environment to use")
+        .option("--use-resolved", "Use resolved dependency versions")
+        .option("--package-manager <packageManager>", "package manager to be used")
+        .option("--pnpm", "Use 'pnpm' as package manager")
+        .option("--yarn", "Use 'yarn' as package manager")
+        .option("--bun", "Use 'bun' as package manager")
+        .option("--debug", "Show additional logs");
+    // Use withCustomHelp instead of withHelpAction and addHelpText
+    return withCustomHelp(useCmd, use, useHelp, 
+    // Pre-check function to validate environment before running the action
+    (environment) => {
+        if (!environment &&
+            !process.argv.includes("--help") &&
+            !process.argv.includes("-h")) {
+            console.error('Error: Missing required argument "environment"');
+            process.exit(1);
+            return false;
+        }
+        return true;
+    });
+}
+//# sourceMappingURL=use.old.js.map