hereya-cli 0.55.0 → 0.57.0

package/dist/backend/common.d.ts

@@ -7,13 +7,17 @@ export interface Backend {
     deleteState(input: DeleteStateInput): Promise<DeleteStateOutput>;
     deleteWorkspace(input: DeleteWorkspaceInput): Promise<DeleteWorkspaceOutput>;
     exportBackend(): Promise<ExportBackendOutput>;
+    getPackageByVersion?(name: string, version: string): Promise<GetPackageOutput>;
+    getPackageLatest?(name: string): Promise<GetPackageOutput>;
     getProvisioningId(input: GetProvisioningIdInput): Promise<GetProvisioningIdOutput>;
     getState(input: GetStateInput): Promise<GetStateOutput>;
     getWorkspace(workspace: string): Promise<GetWorkspaceOutput>;
     getWorkspaceEnv(input: GetWorkspaceEnvInput): Promise<GetWorkspaceEnvOutput>;
     importBackend(input: ImportBackendInput): Promise<ImportBackendOutput>;
     init(options: InitProjectInput): Promise<InitProjectOutput>;
+    listPackageVersions?(name: string): Promise<ListPackageVersionsOutput>;
     listWorkspaces(): Promise<string[]>;
+    publishPackage?(input: PublishPackageInput): Promise<PublishPackageOutput>;
     removePackageFromWorkspace(input: RemovePackageFromWorkspaceInput): Promise<RemovePackageFromWorkspaceOutput>;
     saveState(config: Config, workspace?: string): Promise<void>;
     setEnvVar(input: SetEnvVarInput): Promise<SetEnvVarOutput>;
@@ -45,9 +49,9 @@ export declare const WorkspaceSchema: z.ZodObject<{
         version: string;
         parameters?: Record<string, any> | undefined;
     }> | undefined;
+    profile?: string | undefined;
     isDeploy?: boolean | undefined;
     mirrorOf?: string | undefined;
-    profile?: string | undefined;
 }, {
     name: string;
     id: string;
@@ -56,9 +60,9 @@ export declare const WorkspaceSchema: z.ZodObject<{
         version: string;
         parameters?: Record<string, any> | undefined;
     }> | undefined;
+    profile?: string | undefined;
     isDeploy?: boolean | undefined;
     mirrorOf?: string | undefined;
-    profile?: string | undefined;
 }>;
 export type Workspace = z.infer<typeof WorkspaceSchema>;
 export type AddPackageToWorkspaceInput = {
@@ -227,3 +231,61 @@ export type UpdateWorkspaceOutput = {
     success: true;
     workspace: Workspace;
 };
+export type PublishPackageInput = {
+    commit: string;
+    description: string;
+    doc?: string;
+    iac: string;
+    infra: string;
+    name: string;
+    onDeployPkg?: string;
+    onDeployVersion?: string;
+    repository: string;
+    sha256: string;
+    version: string;
+    visibility?: 'PRIVATE' | 'PUBLIC';
+};
+export type PublishPackageOutput = {
+    package: {
+        id: string;
+        name: string;
+        version: string;
+    };
+    success: true;
+} | {
+    reason: string;
+    success: false;
+};
+export type RegistryPackage = {
+    commit?: string;
+    createdAt?: string;
+    description: string;
+    doc?: string;
+    iac?: string;
+    id: string;
+    infra?: string;
+    name: string;
+    onDeploy?: {
+        pkg: string;
+        version: string;
+    };
+    repository?: string;
+    sha256?: string;
+    updatedAt?: string;
+    version: string;
+    visibility?: 'PRIVATE' | 'PUBLIC';
+};
+export type GetPackageOutput = {
+    package: RegistryPackage;
+    success: true;
+} | {
+    reason: string;
+    success: false;
+};
+export type ListPackageVersionsOutput = {
+    packages: RegistryPackage[];
+    success: true;
+} | {
+    reason: string;
+    success: false;
+};

package/dist/backend/file.d.ts

@@ -1,5 +1,5 @@
 import { Config } from '../lib/config/common.js';
-import { AddPackageToWorkspaceInput, AddPackageToWorkspaceOutput, Backend, CreateWorkspaceInput, CreateWorkspaceOutput, DeleteStateInput, DeleteStateOutput, DeleteWorkspaceInput, DeleteWorkspaceOutput, ExportBackendOutput, GetProvisioningIdInput, GetProvisioningIdOutput, GetStateInput, GetStateOutput, GetWorkspaceEnvInput, GetWorkspaceEnvOutput, GetWorkspaceOutput, ImportBackendInput, ImportBackendOutput, InitProjectInput, InitProjectOutput, RemovePackageFromWorkspaceInput, RemovePackageFromWorkspaceOutput, SetEnvVarInput, SetEnvVarOutput, UnsetEnvVarInput, UnsetEnvVarOutput, UpdateWorkspaceInput, UpdateWorkspaceOutput } from './common.js';
+import { AddPackageToWorkspaceInput, AddPackageToWorkspaceOutput, Backend, CreateWorkspaceInput, CreateWorkspaceOutput, DeleteStateInput, DeleteStateOutput, DeleteWorkspaceInput, DeleteWorkspaceOutput, ExportBackendOutput, GetPackageOutput, GetProvisioningIdInput, GetProvisioningIdOutput, GetStateInput, GetStateOutput, GetWorkspaceEnvInput, GetWorkspaceEnvOutput, GetWorkspaceOutput, ImportBackendInput, ImportBackendOutput, InitProjectInput, InitProjectOutput, ListPackageVersionsOutput, PublishPackageInput, PublishPackageOutput, RemovePackageFromWorkspaceInput, RemovePackageFromWorkspaceOutput, SetEnvVarInput, SetEnvVarOutput, UnsetEnvVarInput, UnsetEnvVarOutput, UpdateWorkspaceInput, UpdateWorkspaceOutput } from './common.js';
 import { FileStorage } from './file-storage/common.js';
 export declare class FileBackend implements Backend {
     private readonly fileStorage;
@@ -9,13 +9,17 @@ export declare class FileBackend implements Backend {
     deleteState(input: DeleteStateInput): Promise<DeleteStateOutput>;
     deleteWorkspace(input: DeleteWorkspaceInput): Promise<DeleteWorkspaceOutput>;
     exportBackend(): Promise<ExportBackendOutput>;
+    getPackageByVersion(_: string, __: string): Promise<GetPackageOutput>;
+    getPackageLatest(_: string): Promise<GetPackageOutput>;
     getProvisioningId(input: GetProvisioningIdInput): Promise<GetProvisioningIdOutput>;
     getState(input: GetStateInput): Promise<GetStateOutput>;
     getWorkspace(workspace: string): Promise<GetWorkspaceOutput>;
     getWorkspaceEnv(input: GetWorkspaceEnvInput): Promise<GetWorkspaceEnvOutput>;
     importBackend(_: ImportBackendInput): Promise<ImportBackendOutput>;
     init(options: InitProjectInput): Promise<InitProjectOutput>;
+    listPackageVersions(_: string): Promise<ListPackageVersionsOutput>;
     listWorkspaces(): Promise<string[]>;
+    publishPackage(_: PublishPackageInput): Promise<PublishPackageOutput>;
     removePackageFromWorkspace(input: RemovePackageFromWorkspaceInput): Promise<RemovePackageFromWorkspaceOutput>;
     saveState(config: Config, workspace?: string): Promise<void>;
     setEnvVar(input: SetEnvVarInput): Promise<SetEnvVarOutput>;

package/dist/backend/file.js

@@ -180,6 +180,18 @@ export class FileBackend {
             success: false,
         };
     }
+    async getPackageByVersion(_, __) {
+        return {
+            reason: 'Package registry operations are only supported with the cloud backend. Please run `hereya login` to use cloud backend.',
+            success: false,
+        };
+    }
+    async getPackageLatest(_) {
+        return {
+            reason: 'Package registry operations are only supported with the cloud backend. Please run `hereya login` to use cloud backend.',
+            success: false,
+        };
+    }
     async getProvisioningId(input) {
         const idPaths = [`provisioning/${input.logicalId}.yaml`, `provisioning/${input.logicalId}.yml`];
         const newId = `p-${randomUUID()}`;
@@ -331,6 +343,12 @@ export class FileBackend {
             },
         };
     }
+    async listPackageVersions(_) {
+        return {
+            reason: 'Package registry operations are only supported with the cloud backend. Please run `hereya login` to use cloud backend.',
+            success: false,
+        };
+    }
     async listWorkspaces() {
         const workspaces$ = await this.fileStorage.listFileNames({ directory: 'state/workspaces' });
         if (workspaces$.success) {
@@ -341,6 +359,12 @@ export class FileBackend {
         }
         throw new Error(`Could not list workspaces: ${workspaces$.error}`);
     }
+    async publishPackage(_) {
+        return {
+            reason: 'Package registry operations are only supported with the cloud backend. Please run `hereya login` to use cloud backend.',
+            success: false,
+        };
+    }
     async removePackageFromWorkspace(input) {
         const workspace$ = await this.getWorkspace(input.workspace);
         if (!workspace$.found) {

package/dist/commands/add/index.js

@@ -147,8 +147,9 @@ export default class Add extends Command {
                                 const configManager = getConfigManager();
                                 await configManager.addPackage({
                                     metadata: ctx.provisionOutput.metadata,
-                                    package: ctx.package,
+                                    package: ctx.provisionOutput.pkgName,
                                     projectRootDir,
+                                    version: ctx.provisionOutput.version,
                                 });
                                 await delay(500);
                             },

package/dist/commands/deploy/index.js

@@ -54,8 +54,20 @@ export default class Deploy extends Command {
                 async task(ctx) {
                     // Config already loaded above for validation
                     ctx.configOutput = loadConfigOutput;
-                    ctx.deployPackages = Object.keys(loadConfigOutput.config.deploy ?? {});
-                    ctx.packages = Object.keys(loadConfigOutput.config.packages ?? {});
+                    // Get deploy packages with their versions
+                    const deployPackages = loadConfigOutput.config.deploy ?? {};
+                    ctx.deployPackages = Object.entries(deployPackages).map(([name, info]) => ({
+                        name,
+                        packageSpec: info.version ? `${name}@${info.version}` : name,
+                        version: info.version || ''
+                    }));
+                    // Get regular packages with their versions
+                    const packages = loadConfigOutput.config.packages ?? {};
+                    ctx.packages = Object.entries(packages).map(([name, info]) => ({
+                        name,
+                        packageSpec: info.version ? `${name}@${info.version}` : name,
+                        version: info.version || ''
+                    }));
                     ctx.workspace = flags.workspace;
                     await delay(500);
                 },
@@ -97,10 +109,24 @@ export default class Deploy extends Command {
             },
             {
                 async task(ctx) {
-                    const savedDeployPackages = Object.keys(ctx.savedStateOutput?.config.deploy ?? {});
-                    ctx.removedDeployPackages = savedDeployPackages.filter((packageName) => !ctx.deployPackages.includes(packageName));
-                    const savedPackages = Object.keys(ctx.savedStateOutput?.config.packages ?? {});
-                    ctx.removedPackages = savedPackages.filter((packageName) => !ctx.packages.includes(packageName));
+                    const savedDeployPackages = ctx.savedStateOutput?.config.deploy ?? {};
+                    const currentDeployPackageNames = new Set(ctx.deployPackages.map(pkg => pkg.name));
+                    ctx.removedDeployPackages = Object.entries(savedDeployPackages)
+                        .filter(([name]) => !currentDeployPackageNames.has(name))
+                        .map(([name, info]) => ({
+                        name,
+                        packageSpec: info.version ? `${name}@${info.version}` : name,
+                        version: info.version || ''
+                    }));
+                    const savedPackages = ctx.savedStateOutput?.config.packages ?? {};
+                    const currentPackageNames = new Set(ctx.packages.map(pkg => pkg.name));
+                    ctx.removedPackages = Object.entries(savedPackages)
+                        .filter(([name]) => !currentPackageNames.has(name))
+                        .map(([name, info]) => ({
+                        name,
+                        packageSpec: info.version ? `${name}@${info.version}` : name,
+                        version: info.version || ''
+                    }));
                     await delay(500);
                 },
                 title: 'Identifying removed packages',
@@ -108,7 +134,7 @@ export default class Deploy extends Command {
             {
                 skip: (ctx) => ctx.removedDeployPackages.length === 0,
                 task(ctx, task) {
-                    return task.newListr(ctx.removedDeployPackages.map((packageName) => ({
+                    return task.newListr(ctx.removedDeployPackages.map((pkg) => ({
                         rendererOptions: {
                             persistentOutput: isDebug(),
                         },
@@ -117,7 +143,7 @@ export default class Deploy extends Command {
                             const backend = await getBackend();
                             const profile = await getProfileFromWorkspace(backend, ctx.workspace, ctx.configOutput.config.project);
                             const { parameters } = await parameterManager.getPackageParameters({
-                                package: packageName,
+                                package: pkg.name,
                                 profile,
                                 projectRootDir,
                             });
@@ -129,7 +155,7 @@ export default class Deploy extends Command {
                             const destroyOutput = await executor.destroy({
                                 isDeploying: true,
                                 logger: getLogger(task),
-                                package: packageName,
+                                package: pkg.packageSpec,
                                 parameters,
                                 project: ctx.configOutput.config.project,
                                 projectEnv: ctx.projectEnv,
@@ -140,7 +166,7 @@ export default class Deploy extends Command {
                                 throw new Error(destroyOutput.reason);
                             }
                         },
-                        title: `Destroying package ${packageName}`,
+                        title: `Destroying package ${pkg.name}`,
                     })), { concurrent: true, rendererOptions: { collapseSubtasks: !isDebug() } });
                 },
                 title: 'Destroying removed deployment packages',
@@ -148,7 +174,7 @@ export default class Deploy extends Command {
             {
                 skip: (ctx) => ctx.removedPackages.length === 0,
                 task(ctx, task) {
-                    return task.newListr(ctx.removedPackages.map((packageName) => ({
+                    return task.newListr(ctx.removedPackages.map((pkg) => ({
                         rendererOptions: {
                             persistentOutput: isDebug(),
                         },
@@ -157,7 +183,7 @@ export default class Deploy extends Command {
                             const backend = await getBackend();
                             const profile = await getProfileFromWorkspace(backend, ctx.workspace, ctx.configOutput.config.project);
                             const { parameters } = await parameterManager.getPackageParameters({
-                                package: packageName,
+                                package: pkg.name,
                                 profile,
                                 projectRootDir,
                             });
@@ -169,7 +195,7 @@ export default class Deploy extends Command {
                             const destroyOutput = await executor.destroy({
                                 isDeploying: true,
                                 logger: getLogger(task),
-                                package: packageName,
+                                package: pkg.packageSpec,
                                 parameters,
                                 project: ctx.configOutput.config.project,
                                 projectRootDir,
@@ -180,10 +206,10 @@ export default class Deploy extends Command {
                             }
                             const { env, metadata } = destroyOutput;
                             const output = ctx.removed || [];
-                            output.push({ env, metadata, packageName });
+                            output.push({ env, metadata, packageName: pkg.name });
                             ctx.removed = output;
                         },
-                        title: `Destroying ${packageName}`,
+                        title: `Destroying ${pkg.name}`,
                     })), { concurrent: true, rendererOptions: { collapseSubtasks: !isDebug() } });
                 },
                 title: 'Destroying removed packages',
@@ -194,7 +220,7 @@ export default class Deploy extends Command {
                     if (!ctx.packages || ctx.packages.length === 0) {
                         return;
                     }
-                    return task.newListr(ctx.packages.map((packageName) => ({
+                    return task.newListr(ctx.packages.map((pkg) => ({
                         rendererOptions: {
                             persistentOutput: isDebug(),
                         },
@@ -203,7 +229,7 @@ export default class Deploy extends Command {
                             const backend = await getBackend();
                             const profile = await getProfileFromWorkspace(backend, ctx.workspace, ctx.configOutput.config.project);
                             const { parameters } = await parameterManager.getPackageParameters({
-                                package: packageName,
+                                package: pkg.name,
                                 profile,
                                 projectRootDir,
                             });
@@ -215,7 +241,7 @@ export default class Deploy extends Command {
                             const provisionOutput = await executor.provision({
                                 isDeploying: true,
                                 logger: getLogger(task),
-                                package: packageName,
+                                package: pkg.packageSpec,
                                 parameters,
                                 project: ctx.configOutput.config.project,
                                 projectRootDir,
@@ -226,10 +252,10 @@ export default class Deploy extends Command {
                             }
                             const { env, metadata } = provisionOutput;
                             const output = ctx.added || [];
-                            output.push({ env, metadata, packageName });
+                            output.push({ env, metadata, packageName: pkg.name });
                             ctx.added = output;
                         },
-                        title: `Provisioning ${packageName}`,
+                        title: `Provisioning ${pkg.name}`,
                     })), { concurrent: true, rendererOptions: { collapseSubtasks: !isDebug() } });
                 },
                 title: `Provisioning packages`,
@@ -300,7 +326,7 @@ export default class Deploy extends Command {
                         throw new Error(getProjectEnvOutput.reason);
                     }
                     const { env: projectEnv } = getProjectEnvOutput;
-                    return task.newListr(ctx.deployPackages.map((packageName) => ({
+                    return task.newListr(ctx.deployPackages.map((pkg) => ({
                         rendererOptions: {
                             persistentOutput: isDebug(),
                         },
@@ -309,7 +335,7 @@ export default class Deploy extends Command {
                             const backend = await getBackend();
                             const profile = await getProfileFromWorkspace(backend, ctx.workspace, ctx.configOutput.config.project);
                             const { parameters } = await parameterManager.getPackageParameters({
-                                package: packageName,
+                                package: pkg.name,
                                 profile,
                                 projectRootDir,
                             });
@@ -321,7 +347,7 @@ export default class Deploy extends Command {
                             const provisionOutput = await executor.provision({
                                 isDeploying: true,
                                 logger: getLogger(task),
-                                package: packageName,
+                                package: pkg.packageSpec,
                                 parameters,
                                 project: ctx.configOutput.config.project,
                                 projectEnv,
@@ -335,7 +361,7 @@ export default class Deploy extends Command {
                                 .map(([key, value]) => `${key}=${value}`)
                                 .join('\n'));
                         },
-                        title: `Provisioning package ${packageName}`,
+                        title: `Provisioning package ${pkg.name}`,
                     })), { concurrent: true, rendererOptions: { collapseSubtasks: !isDebug() } });
                 },
                 title: 'Provisioning deployment packages',

package/dist/commands/doc/index.d.ts

@@ -0,0 +1,17 @@
+import { Command } from '@oclif/core';
+export default class Doc extends Command {
+    static args: {
+        package: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: string[];
+    static flags: {
+        chdir: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'no-doc': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+    private displayMarkdown;
+    private displayPackage;
+    private parsePackageSpec;
+}

package/dist/commands/doc/index.js

@@ -0,0 +1,154 @@
+import { Args, Command, Flags } from '@oclif/core';
+import chalk from 'chalk';
+import { marked } from 'marked';
+import { markedTerminal } from 'marked-terminal';
+import { getBackend } from '../../backend/index.js';
+// Configure marked with terminal renderer
+marked.use(markedTerminal({
+    reflowText: true,
+    showSectionPrefix: false,
+    width: 80,
+}));
+export default class Doc extends Command {
+    static args = {
+        package: Args.string({
+            description: 'Package name with optional version (e.g., my-package or my-package@1.0.0)',
+            required: true,
+        }),
+    };
+    static description = 'Display documentation for a package from the registry';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> my-package',
+        '<%= config.bin %> <%= command.id %> my-package@1.0.0',
+        '<%= config.bin %> <%= command.id %> my-package --json',
+        '<%= config.bin %> <%= command.id %> my-package --no-doc',
+    ];
+    static flags = {
+        chdir: Flags.directory({
+            char: 'C',
+            default: '.',
+            description: 'directory to run command in',
+            helpGroup: 'global',
+        }),
+        json: Flags.boolean({
+            char: 'j',
+            description: 'Output in JSON format',
+        }),
+        'no-doc': Flags.boolean({
+            description: 'Show only metadata without the full documentation',
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(Doc);
+        // Change to specified directory
+        if (flags.chdir !== '.') {
+            process.chdir(flags.chdir);
+        }
+        // Parse package name and version
+        const { name, version } = this.parsePackageSpec(args.package);
+        // Get backend
+        const backend = await getBackend();
+        // Check if backend supports registry operations
+        if (!backend.getPackageLatest || !backend.getPackageByVersion) {
+            this.error('Package registry operations are only supported with the cloud backend. Please run `hereya login` to use cloud backend.');
+        }
+        try {
+            // Fetch package information
+            const result = version
+                ? await backend.getPackageByVersion(name, version)
+                : await backend.getPackageLatest(name);
+            if (!result.success) {
+                this.error(result.reason);
+            }
+            const pkg = result.package;
+            // Output JSON if requested
+            if (flags.json) {
+                this.log(JSON.stringify(pkg, null, 2));
+                return;
+            }
+            // Display package information
+            this.displayPackage(pkg, flags['no-doc']);
+        }
+        catch (error) {
+            this.error(error instanceof Error ? error.message : 'Failed to fetch package documentation');
+        }
+    }
+    displayMarkdown(content) {
+        // Render markdown for terminal display
+        const rendered = marked(content);
+        // Remove any trailing newlines to avoid extra spacing
+        this.log(rendered.trimEnd());
+    }
+    displayPackage(pkg, noDoc) {
+        // Header with package name, version, and visibility
+        const visibilityBadge = pkg.visibility === 'PUBLIC'
+            ? chalk.green('PUBLIC')
+            : chalk.yellow('PRIVATE');
+        this.log(chalk.bold.cyan(`📦 ${pkg.name}@${pkg.version}`) + ' ' + visibilityBadge);
+        this.log('━'.repeat(50));
+        // Description
+        if (pkg.description) {
+            this.log(chalk.bold('Description:') + ' ' + pkg.description);
+            this.log();
+        }
+        // Repository and commit info
+        if (pkg.repository) {
+            this.log(chalk.bold('Repository:') + ' ' + chalk.blue.underline(pkg.repository));
+        }
+        if (pkg.commit) {
+            this.log(chalk.bold('Commit:') + ' ' + chalk.gray(pkg.commit));
+        }
+        if (pkg.sha256) {
+            this.log(chalk.bold('SHA256:') + ' ' + chalk.gray(pkg.sha256.slice(0, 16) + '...'));
+        }
+        // Infrastructure details
+        if (pkg.iac || pkg.infra) {
+            this.log();
+            this.log(`${chalk.bold('Infrastructure:')} ${pkg.iac || 'Unknown'} on ${pkg.infra || 'Unknown'}`);
+        }
+        // OnDeploy hook
+        if (pkg.onDeploy) {
+            this.log();
+            this.log(`${chalk.bold('On Deploy Hook:')} ${pkg.onDeploy.pkg}@${pkg.onDeploy.version}`);
+        }
+        // Timestamps
+        if (pkg.createdAt || pkg.updatedAt) {
+            this.log();
+            if (pkg.createdAt) {
+                const created = new Date(pkg.createdAt).toLocaleString();
+                this.log(`${chalk.bold('Created:')} ${chalk.gray(created)}`);
+            }
+            if (pkg.updatedAt) {
+                const updated = new Date(pkg.updatedAt).toLocaleString();
+                this.log(`${chalk.bold('Updated:')} ${chalk.gray(updated)}`);
+            }
+        }
+        // Documentation content
+        if (!noDoc && pkg.doc) {
+            this.log();
+            this.log(chalk.bold.blue('━━━ Documentation ━━━'));
+            this.log();
+            this.displayMarkdown(pkg.doc);
+        }
+        else if (!noDoc && !pkg.doc) {
+            this.log();
+            this.log(chalk.gray('(No documentation available)'));
+        }
+    }
+    parsePackageSpec(spec) {
+        const atIndex = spec.lastIndexOf('@');
+        // Handle scoped packages like @org/package
+        if (atIndex > 0) {
+            const possibleVersion = spec.slice(atIndex + 1);
+            // Check if what comes after @ looks like a version
+            if (/^\d+\.\d+\.\d+/.test(possibleVersion)) {
+                return {
+                    name: spec.slice(0, atIndex),
+                    version: possibleVersion,
+                };
+            }
+        }
+        // No version specified
+        return { name: spec };
+    }
+}

package/dist/commands/down/index.js

@@ -71,21 +71,50 @@ export default class Down extends Command {
                         },
                         {
                             async task(ctx) {
-                                let packages = Object.keys(ctx.configOutput.config.packages ?? {});
+                                // Get packages with their versions from config
+                                const configPackages = ctx.configOutput.config.packages ?? {};
+                                let packagesWithVersions = Object.entries(configPackages).map(([name, info]) => ({
+                                    name,
+                                    packageSpec: info.version ? `${name}@${info.version}` : name,
+                                    version: info.version || ''
+                                }));
                                 const backend = await getBackend();
                                 const savedStateOutput = await backend.getState({
                                     project: ctx.configOutput.config.project,
                                     workspace: ctx.workspace,
                                 });
-                                let removedPackages = [];
+                                let removedPackagesWithVersions = [];
                                 if (savedStateOutput.found) {
-                                    const savedPackages = Object.keys(savedStateOutput.config.packages ?? {});
-                                    removedPackages = savedPackages.filter((packageName) => !packages.includes(packageName));
+                                    const savedPackages = savedStateOutput.config.packages ?? {};
+                                    removedPackagesWithVersions = Object.entries(savedPackages)
+                                        .filter(([name]) => !configPackages[name])
+                                        .map(([name, info]) => ({
+                                        name,
+                                        packageSpec: info.version ? `${name}@${info.version}` : name,
+                                        version: info.version || ''
+                                    }));
                                 }
+                                // Handle --select flag with version validation
                                 if (flags.select.length > 0) {
-                                    packages = packages.filter((packageName) => flags.select.includes(packageName));
+                                    const selectedPackages = [];
+                                    for (const selectedPkg of flags.select) {
+                                        // Parse the selected package to extract name and version
+                                        const [selectedName, selectedVersion] = selectedPkg.split('@');
+                                        // Find the package in the config
+                                        const configPkg = packagesWithVersions.find(pkg => pkg.name === selectedName);
+                                        if (!configPkg) {
+                                            throw new Error(`Package ${selectedName} not found in project`);
+                                        }
+                                        // If user specified a version, validate it matches the installed version
+                                        if (selectedVersion && selectedVersion !== configPkg.version) {
+                                            throw new Error(`Package ${selectedName} version mismatch: installed version is ${configPkg.version || 'unspecified'}, but you specified ${selectedVersion}. ` +
+                                                `Please use 'hereya down -s ${selectedName}' to use the installed version.`);
+                                        }
+                                        selectedPackages.push(configPkg);
+                                    }
+                                    packagesWithVersions = selectedPackages;
                                 }
-                                ctx.packages = [...packages, ...removedPackages];
+                                ctx.packages = [...packagesWithVersions, ...removedPackagesWithVersions];
                                 await delay(500);
                             },
                             title: 'Identifying packages to destroy',
@@ -96,7 +125,7 @@ export default class Down extends Command {
                                 if (!ctx.packages || ctx.packages.length === 0) {
                                     return;
                                 }
-                                return task.newListr(ctx.packages.map((packageName) => ({
+                                return task.newListr(ctx.packages.map((pkg) => ({
                                     rendererOptions: {
                                         persistentOutput: isDebug(),
                                     },
@@ -105,7 +134,7 @@ export default class Down extends Command {
                                         const backend = await getBackend();
                                         const profile = await getProfileFromWorkspace(backend, ctx.workspace, ctx.configOutput.config.project);
                                         const { parameters } = await parameterManager.getPackageParameters({
-                                            package: packageName,
+                                            package: pkg.name,
                                             profile,
                                             projectRootDir,
                                         });
@@ -117,7 +146,7 @@ export default class Down extends Command {
                                         const destroyOutput = await executor.destroy({
                                             isDeploying: flags.deploy,
                                             logger: getLogger(task),
-                                            package: packageName,
+                                            package: pkg.packageSpec,
                                             parameters,
                                             project: ctx.configOutput.config.project,
                                             projectRootDir,
@@ -128,10 +157,10 @@ export default class Down extends Command {
                                         }
                                         const { env, metadata } = destroyOutput;
                                         const output = ctx.destroyed || [];
-                                        output.push({ env, metadata, packageName });
+                                        output.push({ env, metadata, packageName: pkg.name });
                                         ctx.destroyed = output;
                                     },
-                                    title: `Destroying ${packageName}`,
+                                    title: `Destroying ${pkg.name}`,
                                 })), { concurrent: true, rendererOptions: { collapseSubtasks: !isDebug() } });
                             },
                             title: `Destroying packages`,