hereya-cli 0.54.1 → 0.56.0

package/README.md

@@ -20,7 +20,7 @@ $ npm install -g hereya-cli
 $ hereya COMMAND
 running command...
 $ hereya (--version)
-hereya-cli/0.54.1 linux-x64 node-v22.17.1
+hereya-cli/0.56.0 linux-x64 node-v22.18.0
 $ hereya --help [COMMAND]
 USAGE
   $ hereya COMMAND
@@ -37,6 +37,7 @@ USAGE
 * [`hereya config use-backend TYPE`](#hereya-config-use-backend-type)
 * [`hereya delete-state`](#hereya-delete-state)
 * [`hereya deploy`](#hereya-deploy)
+* [`hereya doc PACKAGE`](#hereya-doc-package)
 * [`hereya down`](#hereya-down)
 * [`hereya env [NAME]`](#hereya-env-name)
 * [`hereya env set [NAME]`](#hereya-env-set-name)
@@ -51,6 +52,7 @@ USAGE
 * [`hereya init PROJECT`](#hereya-init-project)
 * [`hereya login [URL]`](#hereya-login-url)
 * [`hereya logout`](#hereya-logout)
+* [`hereya publish`](#hereya-publish)
 * [`hereya remove PACKAGE`](#hereya-remove-package)
 * [`hereya run CMD`](#hereya-run-cmd)
 * [`hereya unbootstrap INFRASTRUCTURETYPE`](#hereya-unbootstrap-infrastructuretype)
@@ -98,7 +100,7 @@ EXAMPLES
   $ hereya add cloudy/docker_postgres
 ```
 
-_See code: [src/commands/add/index.ts](https://github.com/hereya/hereya-cli/blob/v0.54.1/src/commands/add/index.ts)_
+_See code: [src/commands/add/index.ts](https://github.com/hereya/hereya-cli/blob/v0.56.0/src/commands/add/index.ts)_
 
 ## `hereya bootstrap INFRASTRUCTURETYPE`
 
@@ -123,7 +125,7 @@ EXAMPLES
   $ hereya bootstrap local
 ```
 
-_See code: [src/commands/bootstrap/index.ts](https://github.com/hereya/hereya-cli/blob/v0.54.1/src/commands/bootstrap/index.ts)_
+_See code: [src/commands/bootstrap/index.ts](https://github.com/hereya/hereya-cli/blob/v0.56.0/src/commands/bootstrap/index.ts)_
 
 ## `hereya config export-backend [FILE]`
 
@@ -145,7 +147,7 @@ EXAMPLES
   $ hereya config export-backend ./path/to/export.json
 ```
 
-_See code: [src/commands/config/export-backend/index.ts](https://github.com/hereya/hereya-cli/blob/v0.54.1/src/commands/config/export-backend/index.ts)_
+_See code: [src/commands/config/export-backend/index.ts](https://github.com/hereya/hereya-cli/blob/v0.56.0/src/commands/config/export-backend/index.ts)_
 
 ## `hereya config get-backend`
 
@@ -162,7 +164,7 @@ EXAMPLES
   $ hereya config get-backend
 ```
 
-_See code: [src/commands/config/get-backend/index.ts](https://github.com/hereya/hereya-cli/blob/v0.54.1/src/commands/config/get-backend/index.ts)_
+_See code: [src/commands/config/get-backend/index.ts](https://github.com/hereya/hereya-cli/blob/v0.56.0/src/commands/config/get-backend/index.ts)_
 
 ## `hereya config import-backend FILE`
 
@@ -182,7 +184,7 @@ EXAMPLES
   $ hereya config import-backend ./path/to/cloud-backend.json
 ```
 
-_See code: [src/commands/config/import-backend/index.ts](https://github.com/hereya/hereya-cli/blob/v0.54.1/src/commands/config/import-backend/index.ts)_
+_See code: [src/commands/config/import-backend/index.ts](https://github.com/hereya/hereya-cli/blob/v0.56.0/src/commands/config/import-backend/index.ts)_
 
 ## `hereya config use-backend TYPE`
 
@@ -204,7 +206,7 @@ EXAMPLES
   $ hereya config use-backend local
 ```
 
-_See code: [src/commands/config/use-backend/index.ts](https://github.com/hereya/hereya-cli/blob/v0.54.1/src/commands/config/use-backend/index.ts)_
+_See code: [src/commands/config/use-backend/index.ts](https://github.com/hereya/hereya-cli/blob/v0.56.0/src/commands/config/use-backend/index.ts)_
 
 ## `hereya delete-state`
 
@@ -230,7 +232,7 @@ EXAMPLES
   $ hereya delete-state --workspace staging
 ```
 
-_See code: [src/commands/delete-state/index.ts](https://github.com/hereya/hereya-cli/blob/v0.54.1/src/commands/delete-state/index.ts)_
+_See code: [src/commands/delete-state/index.ts](https://github.com/hereya/hereya-cli/blob/v0.56.0/src/commands/delete-state/index.ts)_
 
 ## `hereya deploy`
 
@@ -255,7 +257,40 @@ EXAMPLES
   $ hereya deploy
 ```
 
-_See code: [src/commands/deploy/index.ts](https://github.com/hereya/hereya-cli/blob/v0.54.1/src/commands/deploy/index.ts)_
+_See code: [src/commands/deploy/index.ts](https://github.com/hereya/hereya-cli/blob/v0.56.0/src/commands/deploy/index.ts)_
+
+## `hereya doc PACKAGE`
+
+Display documentation for a package from the registry
+
+```
+USAGE
+  $ hereya doc PACKAGE [-C <value>] [-j] [--no-doc]
+
+ARGUMENTS
+  PACKAGE  Package name with optional version (e.g., my-package or my-package@1.0.0)
+
+FLAGS
+  -j, --json    Output in JSON format
+      --no-doc  Show only metadata without the full documentation
+
+GLOBAL FLAGS
+  -C, --chdir=<value>  [default: .] directory to run command in
+
+DESCRIPTION
+  Display documentation for a package from the registry
+
+EXAMPLES
+  $ hereya doc my-package
+
+  $ hereya doc my-package@1.0.0
+
+  $ hereya doc my-package --json
+
+  $ hereya doc my-package --no-doc
+```
+
+_See code: [src/commands/doc/index.ts](https://github.com/hereya/hereya-cli/blob/v0.56.0/src/commands/doc/index.ts)_
 
 ## `hereya down`
 
@@ -282,7 +317,7 @@ EXAMPLES
   $ hereya down
 ```
 
-_See code: [src/commands/down/index.ts](https://github.com/hereya/hereya-cli/blob/v0.54.1/src/commands/down/index.ts)_
+_See code: [src/commands/down/index.ts](https://github.com/hereya/hereya-cli/blob/v0.56.0/src/commands/down/index.ts)_
 
 ## `hereya env [NAME]`
 
@@ -313,7 +348,7 @@ EXAMPLES
   $ hereya env -w dev -l
 ```
 
-_See code: [src/commands/env/index.ts](https://github.com/hereya/hereya-cli/blob/v0.54.1/src/commands/env/index.ts)_
+_See code: [src/commands/env/index.ts](https://github.com/hereya/hereya-cli/blob/v0.56.0/src/commands/env/index.ts)_
 
 ## `hereya env set [NAME]`
 
@@ -340,7 +375,7 @@ EXAMPLES
   $ hereya env set FOO -v bar -w dev
 ```
 
-_See code: [src/commands/env/set/index.ts](https://github.com/hereya/hereya-cli/blob/v0.54.1/src/commands/env/set/index.ts)_
+_See code: [src/commands/env/set/index.ts](https://github.com/hereya/hereya-cli/blob/v0.56.0/src/commands/env/set/index.ts)_
 
 ## `hereya flow add PACKAGE`
 
@@ -378,7 +413,7 @@ EXAMPLES
   $ hereya flow add cloudy/docker_postgres -p DB_NAME=mydb -p DB_USER=admin
 ```
 
-_See code: [src/commands/flow/add/index.ts](https://github.com/hereya/hereya-cli/blob/v0.54.1/src/commands/flow/add/index.ts)_
+_See code: [src/commands/flow/add/index.ts](https://github.com/hereya/hereya-cli/blob/v0.56.0/src/commands/flow/add/index.ts)_
 
 ## `hereya flow down`
 
@@ -412,7 +447,7 @@ EXAMPLES
   $ hereya flow down --pin
 ```
 
-_See code: [src/commands/flow/down/index.ts](https://github.com/hereya/hereya-cli/blob/v0.54.1/src/commands/flow/down/index.ts)_
+_See code: [src/commands/flow/down/index.ts](https://github.com/hereya/hereya-cli/blob/v0.56.0/src/commands/flow/down/index.ts)_
 
 ## `hereya flow env [NAME]`
 
@@ -446,7 +481,7 @@ EXAMPLES
   $ hereya flow env -l
 ```
 
-_See code: [src/commands/flow/env/index.ts](https://github.com/hereya/hereya-cli/blob/v0.54.1/src/commands/flow/env/index.ts)_
+_See code: [src/commands/flow/env/index.ts](https://github.com/hereya/hereya-cli/blob/v0.56.0/src/commands/flow/env/index.ts)_
 
 ## `hereya flow remove PACKAGE`
 
@@ -476,7 +511,7 @@ EXAMPLES
   $ hereya flow remove cloudy/docker_postgres --profile staging
 ```
 
-_See code: [src/commands/flow/remove/index.ts](https://github.com/hereya/hereya-cli/blob/v0.54.1/src/commands/flow/remove/index.ts)_
+_See code: [src/commands/flow/remove/index.ts](https://github.com/hereya/hereya-cli/blob/v0.56.0/src/commands/flow/remove/index.ts)_
 
 ## `hereya flow run CMD`
 
@@ -505,7 +540,7 @@ EXAMPLES
   $ hereya flow run --pin -- npm test
 ```
 
-_See code: [src/commands/flow/run/index.ts](https://github.com/hereya/hereya-cli/blob/v0.54.1/src/commands/flow/run/index.ts)_
+_See code: [src/commands/flow/run/index.ts](https://github.com/hereya/hereya-cli/blob/v0.56.0/src/commands/flow/run/index.ts)_
 
 ## `hereya flow up`
 
@@ -539,7 +574,7 @@ EXAMPLES
   $ hereya flow up --pin
 ```
 
-_See code: [src/commands/flow/up/index.ts](https://github.com/hereya/hereya-cli/blob/v0.54.1/src/commands/flow/up/index.ts)_
+_See code: [src/commands/flow/up/index.ts](https://github.com/hereya/hereya-cli/blob/v0.56.0/src/commands/flow/up/index.ts)_
 
 ## `hereya help [COMMAND]`
 
@@ -596,7 +631,7 @@ EXAMPLES
   $ hereya import org/my-package -f state.tfstate -w my-workspace
 ```
 
-_See code: [src/commands/import/index.ts](https://github.com/hereya/hereya-cli/blob/v0.54.1/src/commands/import/index.ts)_
+_See code: [src/commands/import/index.ts](https://github.com/hereya/hereya-cli/blob/v0.56.0/src/commands/import/index.ts)_
 
 ## `hereya init PROJECT`
 
@@ -622,7 +657,7 @@ EXAMPLES
   $ hereya init myProject -w=defaultWorkspace --chdir=./myProject
 ```
 
-_See code: [src/commands/init/index.ts](https://github.com/hereya/hereya-cli/blob/v0.54.1/src/commands/init/index.ts)_
+_See code: [src/commands/init/index.ts](https://github.com/hereya/hereya-cli/blob/v0.56.0/src/commands/init/index.ts)_
 
 ## `hereya login [URL]`
 
@@ -651,7 +686,7 @@ EXAMPLES
   $ hereya login --token=your-token https://cloud.hereya.dev
 ```
 
-_See code: [src/commands/login/index.ts](https://github.com/hereya/hereya-cli/blob/v0.54.1/src/commands/login/index.ts)_
+_See code: [src/commands/login/index.ts](https://github.com/hereya/hereya-cli/blob/v0.56.0/src/commands/login/index.ts)_
 
 ## `hereya logout`
 
@@ -668,7 +703,30 @@ EXAMPLES
   $ hereya logout
 ```
 
-_See code: [src/commands/logout/index.ts](https://github.com/hereya/hereya-cli/blob/v0.54.1/src/commands/logout/index.ts)_
+_See code: [src/commands/logout/index.ts](https://github.com/hereya/hereya-cli/blob/v0.56.0/src/commands/logout/index.ts)_
+
+## `hereya publish`
+
+Publish a package to the Hereya registry
+
+```
+USAGE
+  $ hereya publish [--chdir <value>]
+
+FLAGS
+  --chdir=<value>  Directory where the command will be executed.
+                   If not specified, it defaults to the current working directory.
+
+DESCRIPTION
+  Publish a package to the Hereya registry
+
+EXAMPLES
+  $ hereya publish
+
+  $ hereya publish --chdir=/path/to/package
+```
+
+_See code: [src/commands/publish/index.ts](https://github.com/hereya/hereya-cli/blob/v0.56.0/src/commands/publish/index.ts)_
 
 ## `hereya remove PACKAGE`
 
@@ -696,7 +754,7 @@ EXAMPLES
   $ hereya remove cloudy/docker_postgres
 ```
 
-_See code: [src/commands/remove/index.ts](https://github.com/hereya/hereya-cli/blob/v0.54.1/src/commands/remove/index.ts)_
+_See code: [src/commands/remove/index.ts](https://github.com/hereya/hereya-cli/blob/v0.56.0/src/commands/remove/index.ts)_
 
 ## `hereya run CMD`
 
@@ -722,7 +780,7 @@ EXAMPLES
   $ hereya run -w uat -- node index.js
 ```
 
-_See code: [src/commands/run/index.ts](https://github.com/hereya/hereya-cli/blob/v0.54.1/src/commands/run/index.ts)_
+_See code: [src/commands/run/index.ts](https://github.com/hereya/hereya-cli/blob/v0.56.0/src/commands/run/index.ts)_
 
 ## `hereya unbootstrap INFRASTRUCTURETYPE`
 
@@ -747,7 +805,7 @@ EXAMPLES
   $ hereya unbootstrap local
 ```
 
-_See code: [src/commands/unbootstrap/index.ts](https://github.com/hereya/hereya-cli/blob/v0.54.1/src/commands/unbootstrap/index.ts)_
+_See code: [src/commands/unbootstrap/index.ts](https://github.com/hereya/hereya-cli/blob/v0.56.0/src/commands/unbootstrap/index.ts)_
 
 ## `hereya undeploy`
 
@@ -772,7 +830,7 @@ EXAMPLES
   $ hereya undeploy
 ```
 
-_See code: [src/commands/undeploy/index.ts](https://github.com/hereya/hereya-cli/blob/v0.54.1/src/commands/undeploy/index.ts)_
+_See code: [src/commands/undeploy/index.ts](https://github.com/hereya/hereya-cli/blob/v0.56.0/src/commands/undeploy/index.ts)_
 
 ## `hereya up`
 
@@ -799,7 +857,7 @@ EXAMPLES
   $ hereya up
 ```
 
-_See code: [src/commands/up/index.ts](https://github.com/hereya/hereya-cli/blob/v0.54.1/src/commands/up/index.ts)_
+_See code: [src/commands/up/index.ts](https://github.com/hereya/hereya-cli/blob/v0.56.0/src/commands/up/index.ts)_
 
 ## `hereya workspace create NAME`
 
@@ -824,7 +882,7 @@ EXAMPLES
   $ hereya workspace create dev
 ```
 
-_See code: [src/commands/workspace/create/index.ts](https://github.com/hereya/hereya-cli/blob/v0.54.1/src/commands/workspace/create/index.ts)_
+_See code: [src/commands/workspace/create/index.ts](https://github.com/hereya/hereya-cli/blob/v0.56.0/src/commands/workspace/create/index.ts)_
 
 ## `hereya workspace delete NAME`
 
@@ -844,7 +902,7 @@ EXAMPLES
   $ hereya workspace delete dev
 ```
 
-_See code: [src/commands/workspace/delete/index.ts](https://github.com/hereya/hereya-cli/blob/v0.54.1/src/commands/workspace/delete/index.ts)_
+_See code: [src/commands/workspace/delete/index.ts](https://github.com/hereya/hereya-cli/blob/v0.56.0/src/commands/workspace/delete/index.ts)_
 
 ## `hereya workspace env [NAME]`
 
@@ -870,7 +928,7 @@ EXAMPLES
   $ hereya workspace env myEnv -w dev
 ```
 
-_See code: [src/commands/workspace/env/index.ts](https://github.com/hereya/hereya-cli/blob/v0.54.1/src/commands/workspace/env/index.ts)_
+_See code: [src/commands/workspace/env/index.ts](https://github.com/hereya/hereya-cli/blob/v0.56.0/src/commands/workspace/env/index.ts)_
 
 ## `hereya workspace env set`
 
@@ -894,7 +952,7 @@ EXAMPLES
   $ hereya workspace env set -w my-workspace -n myVar -v my-value -i aws -s
 ```
 
-_See code: [src/commands/workspace/env/set/index.ts](https://github.com/hereya/hereya-cli/blob/v0.54.1/src/commands/workspace/env/set/index.ts)_
+_See code: [src/commands/workspace/env/set/index.ts](https://github.com/hereya/hereya-cli/blob/v0.56.0/src/commands/workspace/env/set/index.ts)_
 
 ## `hereya workspace env unset`
 
@@ -915,7 +973,7 @@ EXAMPLES
   $ hereya workspace env unset -w my-workspace -n myVar
 ```
 
-_See code: [src/commands/workspace/env/unset/index.ts](https://github.com/hereya/hereya-cli/blob/v0.54.1/src/commands/workspace/env/unset/index.ts)_
+_See code: [src/commands/workspace/env/unset/index.ts](https://github.com/hereya/hereya-cli/blob/v0.56.0/src/commands/workspace/env/unset/index.ts)_
 
 ## `hereya workspace install PACKAGE`
 
@@ -942,7 +1000,7 @@ EXAMPLES
   $ hereya workspace install hereya/aws-cognito
 ```
 
-_See code: [src/commands/workspace/install/index.ts](https://github.com/hereya/hereya-cli/blob/v0.54.1/src/commands/workspace/install/index.ts)_
+_See code: [src/commands/workspace/install/index.ts](https://github.com/hereya/hereya-cli/blob/v0.56.0/src/commands/workspace/install/index.ts)_
 
 ## `hereya workspace list`
 
@@ -959,7 +1017,7 @@ EXAMPLES
   $ hereya workspace list
 ```
 
-_See code: [src/commands/workspace/list/index.ts](https://github.com/hereya/hereya-cli/blob/v0.54.1/src/commands/workspace/list/index.ts)_
+_See code: [src/commands/workspace/list/index.ts](https://github.com/hereya/hereya-cli/blob/v0.56.0/src/commands/workspace/list/index.ts)_
 
 ## `hereya workspace set-profile PROFILE`
 
@@ -983,7 +1041,7 @@ EXAMPLES
   $ hereya workspace set-profile prod-profile -w production
 ```
 
-_See code: [src/commands/workspace/set-profile/index.ts](https://github.com/hereya/hereya-cli/blob/v0.54.1/src/commands/workspace/set-profile/index.ts)_
+_See code: [src/commands/workspace/set-profile/index.ts](https://github.com/hereya/hereya-cli/blob/v0.56.0/src/commands/workspace/set-profile/index.ts)_
 
 ## `hereya workspace uninstall PACKAGE`
 
@@ -1010,5 +1068,5 @@ EXAMPLES
   $ hereya workspace uninstall hereya/aws-cognito
 ```
 
-_See code: [src/commands/workspace/uninstall/index.ts](https://github.com/hereya/hereya-cli/blob/v0.54.1/src/commands/workspace/uninstall/index.ts)_
+_See code: [src/commands/workspace/uninstall/index.ts](https://github.com/hereya/hereya-cli/blob/v0.56.0/src/commands/workspace/uninstall/index.ts)_
 <!-- commandsstop -->

package/dist/backend/cloud/cloud-backend.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';
 interface CloudBackendConfig {
     accessToken: string;
     clientId: string;
@@ -14,13 +14,17 @@ export declare class CloudBackend implements 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(name: string): Promise<GetWorkspaceOutput>;
     getWorkspaceEnv(input: GetWorkspaceEnvInput): Promise<GetWorkspaceEnvOutput>;
     importBackend(input: ImportBackendInput): Promise<ImportBackendOutput>;
     init(input: 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>;

package/dist/backend/cloud/cloud-backend.js

@@ -123,6 +123,76 @@ export class CloudBackend {
             success: true,
         };
     }
+    async getPackageByVersion(name, version) {
+        const response = await fetch(`${this.config.url}/api/registry/packages/${encodeURIComponent(name)}/${encodeURIComponent(version)}`, {
+            headers: {
+                'Authorization': `Bearer ${this.config.accessToken}`,
+            },
+            method: 'GET',
+        });
+        const result = await response.json();
+        if (!response.ok) {
+            // Handle error responses
+            let errorMessage = result.error || 'Failed to get package';
+            switch (response.status) {
+                case 401: {
+                    errorMessage = 'Authentication failed. Please run `hereya login` to refresh your credentials.';
+                    break;
+                }
+                case 403: {
+                    errorMessage = `Access denied: ${errorMessage}`;
+                    break;
+                }
+                case 404: {
+                    errorMessage = `Package '${name}@${version}' not found`;
+                    break;
+                }
+            }
+            return {
+                reason: errorMessage,
+                success: false,
+            };
+        }
+        return {
+            package: result.package,
+            success: true,
+        };
+    }
+    async getPackageLatest(name) {
+        const response = await fetch(`${this.config.url}/api/registry/packages/${encodeURIComponent(name)}`, {
+            headers: {
+                'Authorization': `Bearer ${this.config.accessToken}`,
+            },
+            method: 'GET',
+        });
+        const result = await response.json();
+        if (!response.ok) {
+            // Handle error responses
+            let errorMessage = result.error || 'Failed to get package';
+            switch (response.status) {
+                case 401: {
+                    errorMessage = 'Authentication failed. Please run `hereya login` to refresh your credentials.';
+                    break;
+                }
+                case 403: {
+                    errorMessage = `Access denied: ${errorMessage}`;
+                    break;
+                }
+                case 404: {
+                    errorMessage = `Package '${name}' not found`;
+                    break;
+                }
+            }
+            return {
+                reason: errorMessage,
+                success: false,
+            };
+        }
+        return {
+            package: result.package,
+            success: true,
+        };
+    }
     async getProvisioningId(input) {
         const formData = new FormData();
         formData.append('packageCanonicalName', input.packageCanonicalName);
@@ -198,6 +268,12 @@ export class CloudBackend {
             },
             method: 'GET',
         });
+        // Handle 404 as "not found" rather than error
+        if (response.status === 404) {
+            return {
+                found: false,
+            };
+        }
         if (!response.ok) {
             const error = await response.json();
             return {
@@ -280,6 +356,41 @@ export class CloudBackend {
             },
         };
     }
+    async listPackageVersions(name) {
+        const response = await fetch(`${this.config.url}/api/registry/packages/${encodeURIComponent(name)}?versions=all`, {
+            headers: {
+                'Authorization': `Bearer ${this.config.accessToken}`,
+            },
+            method: 'GET',
+        });
+        const result = await response.json();
+        if (!response.ok) {
+            // Handle error responses
+            let errorMessage = result.error || 'Failed to list package versions';
+            switch (response.status) {
+                case 401: {
+                    errorMessage = 'Authentication failed. Please run `hereya login` to refresh your credentials.';
+                    break;
+                }
+                case 403: {
+                    errorMessage = `Access denied: ${errorMessage}`;
+                    break;
+                }
+                case 404: {
+                    errorMessage = `Package '${name}' not found`;
+                    break;
+                }
+            }
+            return {
+                reason: errorMessage,
+                success: false,
+            };
+        }
+        return {
+            packages: result.packages || [],
+            success: true,
+        };
+    }
     async listWorkspaces() {
         const response = await fetch(`${this.config.url}/api/workspaces`, {
             headers: {
@@ -293,6 +404,109 @@ export class CloudBackend {
         const result = await response.json();
         return result.workspaces.map((workspace) => workspace.name);
     }
+    async publishPackage(input) {
+        const formData = new FormData();
+        formData.append('name', input.name);
+        formData.append('version', input.version);
+        formData.append('description', input.description);
+        formData.append('repository', input.repository);
+        formData.append('commit', input.commit);
+        formData.append('sha256', input.sha256);
+        formData.append('iac', input.iac);
+        formData.append('infra', input.infra);
+        if (input.doc) {
+            formData.append('doc', input.doc);
+        }
+        if (input.visibility) {
+            formData.append('visibility', input.visibility);
+        }
+        if (input.onDeployPkg) {
+            formData.append('onDeployPkg', input.onDeployPkg);
+        }
+        if (input.onDeployVersion) {
+            formData.append('onDeployVersion', input.onDeployVersion);
+        }
+        const response = await fetch(`${this.config.url}/api/registry/packages`, {
+            body: formData,
+            headers: {
+                'Authorization': `Bearer ${this.config.accessToken}`,
+            },
+            method: 'POST',
+        });
+        const result = await response.json();
+        if (!response.ok) {
+            // Handle validation errors (field-specific errors)
+            if (result.errors && typeof result.errors === 'object') {
+                const errorMessages = [];
+                // Add main error message if present
+                if (result.error) {
+                    errorMessages.push(result.error, ''); // Empty line for separation
+                }
+                // Add field-specific errors
+                for (const [field, messages] of Object.entries(result.errors)) {
+                    if (Array.isArray(messages)) {
+                        errorMessages.push(`${field}: ${messages.join(', ')}`);
+                    }
+                }
+                // Add help message if present
+                if (result.help) {
+                    errorMessages.push('', `ℹ️  ${result.help}`);
+                }
+                return {
+                    reason: errorMessages.join('\n'),
+                    success: false,
+                };
+            }
+            // Handle other errors with more context
+            const errorMessages = [];
+            const errorMessage = result.error || 'Unknown error occurred';
+            // Add main error with context based on errorType or status code
+            if (result.errorType) {
+                errorMessages.push(`[${result.errorType}] ${errorMessage}`);
+            }
+            else {
+                // Fallback to status-based context
+                switch (response.status) {
+                    case 401: {
+                        errorMessages.push('Authentication failed. Please run `hereya login` to refresh your credentials.');
+                        break;
+                    }
+                    case 403: {
+                        errorMessages.push(`Permission denied: ${errorMessage}`);
+                        break;
+                    }
+                    case 409: {
+                        errorMessages.push(`Conflict: ${errorMessage}`);
+                        break;
+                    }
+                    default: {
+                        if (response.status >= 500) {
+                            errorMessages.push(`Server error: ${errorMessage} (status ${response.status})`);
+                        }
+                        else {
+                            errorMessages.push(errorMessage);
+                        }
+                    }
+                }
+            }
+            // Add help message if present
+            if (result.help) {
+                errorMessages.push('', `ℹ️  ${result.help}`);
+            }
+            // Add package info if present (helpful for debugging)
+            if (result.package) {
+                errorMessages.push('', `Package: ${result.package.name}@${result.package.version}`);
+            }
+            return {
+                reason: errorMessages.join('\n'),
+                success: false,
+            };
+        }
+        return {
+            package: result.package,
+            success: true,
+        };
+    }
     async removePackageFromWorkspace(input) {
         const response = await fetch(`${this.config.url}/api/workspaces/${encodeURIComponent(input.workspace)}/packages/${encodeURIComponent(input.package)}`, {
             headers: {