hereya-cli 0.57.4 → 0.58.0

package/README.md

@@ -20,7 +20,7 @@ $ npm install -g hereya-cli
 $ hereya COMMAND
 running command...
 $ hereya (--version)
-hereya-cli/0.57.4 linux-x64 node-v24.12.0
+hereya-cli/0.58.0 linux-x64 node-v24.12.0
 $ hereya --help [COMMAND]
 USAGE
   $ hereya COMMAND
@@ -55,6 +55,7 @@ USAGE
 * [`hereya publish`](#hereya-publish)
 * [`hereya remove PACKAGE`](#hereya-remove-package)
 * [`hereya run CMD`](#hereya-run-cmd)
+* [`hereya search QUERY`](#hereya-search-query)
 * [`hereya unbootstrap INFRASTRUCTURETYPE`](#hereya-unbootstrap-infrastructuretype)
 * [`hereya undeploy`](#hereya-undeploy)
 * [`hereya up`](#hereya-up)
@@ -100,7 +101,7 @@ EXAMPLES
   $ hereya add cloudy/docker_postgres
 ```
 
-_See code: [src/commands/add/index.ts](https://github.com/hereya/hereya-cli/blob/v0.57.4/src/commands/add/index.ts)_
+_See code: [src/commands/add/index.ts](https://github.com/hereya/hereya-cli/blob/v0.58.0/src/commands/add/index.ts)_
 
 ## `hereya bootstrap INFRASTRUCTURETYPE`
 
@@ -125,7 +126,7 @@ EXAMPLES
   $ hereya bootstrap local
 ```
 
-_See code: [src/commands/bootstrap/index.ts](https://github.com/hereya/hereya-cli/blob/v0.57.4/src/commands/bootstrap/index.ts)_
+_See code: [src/commands/bootstrap/index.ts](https://github.com/hereya/hereya-cli/blob/v0.58.0/src/commands/bootstrap/index.ts)_
 
 ## `hereya config export-backend [FILE]`
 
@@ -147,7 +148,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.57.4/src/commands/config/export-backend/index.ts)_
+_See code: [src/commands/config/export-backend/index.ts](https://github.com/hereya/hereya-cli/blob/v0.58.0/src/commands/config/export-backend/index.ts)_
 
 ## `hereya config get-backend`
 
@@ -164,7 +165,7 @@ EXAMPLES
   $ hereya config get-backend
 ```
 
-_See code: [src/commands/config/get-backend/index.ts](https://github.com/hereya/hereya-cli/blob/v0.57.4/src/commands/config/get-backend/index.ts)_
+_See code: [src/commands/config/get-backend/index.ts](https://github.com/hereya/hereya-cli/blob/v0.58.0/src/commands/config/get-backend/index.ts)_
 
 ## `hereya config import-backend FILE`
 
@@ -184,7 +185,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.57.4/src/commands/config/import-backend/index.ts)_
+_See code: [src/commands/config/import-backend/index.ts](https://github.com/hereya/hereya-cli/blob/v0.58.0/src/commands/config/import-backend/index.ts)_
 
 ## `hereya config use-backend TYPE`
 
@@ -206,7 +207,7 @@ EXAMPLES
   $ hereya config use-backend local
 ```
 
-_See code: [src/commands/config/use-backend/index.ts](https://github.com/hereya/hereya-cli/blob/v0.57.4/src/commands/config/use-backend/index.ts)_
+_See code: [src/commands/config/use-backend/index.ts](https://github.com/hereya/hereya-cli/blob/v0.58.0/src/commands/config/use-backend/index.ts)_
 
 ## `hereya delete-state`
 
@@ -232,7 +233,7 @@ EXAMPLES
   $ hereya delete-state --workspace staging
 ```
 
-_See code: [src/commands/delete-state/index.ts](https://github.com/hereya/hereya-cli/blob/v0.57.4/src/commands/delete-state/index.ts)_
+_See code: [src/commands/delete-state/index.ts](https://github.com/hereya/hereya-cli/blob/v0.58.0/src/commands/delete-state/index.ts)_
 
 ## `hereya deploy`
 
@@ -257,7 +258,7 @@ EXAMPLES
   $ hereya deploy
 ```
 
-_See code: [src/commands/deploy/index.ts](https://github.com/hereya/hereya-cli/blob/v0.57.4/src/commands/deploy/index.ts)_
+_See code: [src/commands/deploy/index.ts](https://github.com/hereya/hereya-cli/blob/v0.58.0/src/commands/deploy/index.ts)_
 
 ## `hereya doc PACKAGE`
 
@@ -290,7 +291,7 @@ EXAMPLES
   $ hereya doc my-package --no-doc
 ```
 
-_See code: [src/commands/doc/index.ts](https://github.com/hereya/hereya-cli/blob/v0.57.4/src/commands/doc/index.ts)_
+_See code: [src/commands/doc/index.ts](https://github.com/hereya/hereya-cli/blob/v0.58.0/src/commands/doc/index.ts)_
 
 ## `hereya down`
 
@@ -317,7 +318,7 @@ EXAMPLES
   $ hereya down
 ```
 
-_See code: [src/commands/down/index.ts](https://github.com/hereya/hereya-cli/blob/v0.57.4/src/commands/down/index.ts)_
+_See code: [src/commands/down/index.ts](https://github.com/hereya/hereya-cli/blob/v0.58.0/src/commands/down/index.ts)_
 
 ## `hereya env [NAME]`
 
@@ -348,7 +349,7 @@ EXAMPLES
   $ hereya env -w dev -l
 ```
 
-_See code: [src/commands/env/index.ts](https://github.com/hereya/hereya-cli/blob/v0.57.4/src/commands/env/index.ts)_
+_See code: [src/commands/env/index.ts](https://github.com/hereya/hereya-cli/blob/v0.58.0/src/commands/env/index.ts)_
 
 ## `hereya env set [NAME]`
 
@@ -375,7 +376,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.57.4/src/commands/env/set/index.ts)_
+_See code: [src/commands/env/set/index.ts](https://github.com/hereya/hereya-cli/blob/v0.58.0/src/commands/env/set/index.ts)_
 
 ## `hereya flow add PACKAGE`
 
@@ -413,7 +414,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.57.4/src/commands/flow/add/index.ts)_
+_See code: [src/commands/flow/add/index.ts](https://github.com/hereya/hereya-cli/blob/v0.58.0/src/commands/flow/add/index.ts)_
 
 ## `hereya flow down`
 
@@ -447,7 +448,7 @@ EXAMPLES
   $ hereya flow down --pin
 ```
 
-_See code: [src/commands/flow/down/index.ts](https://github.com/hereya/hereya-cli/blob/v0.57.4/src/commands/flow/down/index.ts)_
+_See code: [src/commands/flow/down/index.ts](https://github.com/hereya/hereya-cli/blob/v0.58.0/src/commands/flow/down/index.ts)_
 
 ## `hereya flow env [NAME]`
 
@@ -481,7 +482,7 @@ EXAMPLES
   $ hereya flow env -l
 ```
 
-_See code: [src/commands/flow/env/index.ts](https://github.com/hereya/hereya-cli/blob/v0.57.4/src/commands/flow/env/index.ts)_
+_See code: [src/commands/flow/env/index.ts](https://github.com/hereya/hereya-cli/blob/v0.58.0/src/commands/flow/env/index.ts)_
 
 ## `hereya flow remove PACKAGE`
 
@@ -511,7 +512,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.57.4/src/commands/flow/remove/index.ts)_
+_See code: [src/commands/flow/remove/index.ts](https://github.com/hereya/hereya-cli/blob/v0.58.0/src/commands/flow/remove/index.ts)_
 
 ## `hereya flow run CMD`
 
@@ -540,7 +541,7 @@ EXAMPLES
   $ hereya flow run --pin -- npm test
 ```
 
-_See code: [src/commands/flow/run/index.ts](https://github.com/hereya/hereya-cli/blob/v0.57.4/src/commands/flow/run/index.ts)_
+_See code: [src/commands/flow/run/index.ts](https://github.com/hereya/hereya-cli/blob/v0.58.0/src/commands/flow/run/index.ts)_
 
 ## `hereya flow up`
 
@@ -574,7 +575,7 @@ EXAMPLES
   $ hereya flow up --pin
 ```
 
-_See code: [src/commands/flow/up/index.ts](https://github.com/hereya/hereya-cli/blob/v0.57.4/src/commands/flow/up/index.ts)_
+_See code: [src/commands/flow/up/index.ts](https://github.com/hereya/hereya-cli/blob/v0.58.0/src/commands/flow/up/index.ts)_
 
 ## `hereya help [COMMAND]`
 
@@ -631,7 +632,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.57.4/src/commands/import/index.ts)_
+_See code: [src/commands/import/index.ts](https://github.com/hereya/hereya-cli/blob/v0.58.0/src/commands/import/index.ts)_
 
 ## `hereya init PROJECT`
 
@@ -657,7 +658,7 @@ EXAMPLES
   $ hereya init myProject -w=defaultWorkspace --chdir=./myProject
 ```
 
-_See code: [src/commands/init/index.ts](https://github.com/hereya/hereya-cli/blob/v0.57.4/src/commands/init/index.ts)_
+_See code: [src/commands/init/index.ts](https://github.com/hereya/hereya-cli/blob/v0.58.0/src/commands/init/index.ts)_
 
 ## `hereya login [URL]`
 
@@ -686,7 +687,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.57.4/src/commands/login/index.ts)_
+_See code: [src/commands/login/index.ts](https://github.com/hereya/hereya-cli/blob/v0.58.0/src/commands/login/index.ts)_
 
 ## `hereya logout`
 
@@ -703,7 +704,7 @@ EXAMPLES
   $ hereya logout
 ```
 
-_See code: [src/commands/logout/index.ts](https://github.com/hereya/hereya-cli/blob/v0.57.4/src/commands/logout/index.ts)_
+_See code: [src/commands/logout/index.ts](https://github.com/hereya/hereya-cli/blob/v0.58.0/src/commands/logout/index.ts)_
 
 ## `hereya publish`
 
@@ -726,7 +727,7 @@ EXAMPLES
   $ hereya publish --chdir=/path/to/package
 ```
 
-_See code: [src/commands/publish/index.ts](https://github.com/hereya/hereya-cli/blob/v0.57.4/src/commands/publish/index.ts)_
+_See code: [src/commands/publish/index.ts](https://github.com/hereya/hereya-cli/blob/v0.58.0/src/commands/publish/index.ts)_
 
 ## `hereya remove PACKAGE`
 
@@ -754,7 +755,7 @@ EXAMPLES
   $ hereya remove cloudy/docker_postgres
 ```
 
-_See code: [src/commands/remove/index.ts](https://github.com/hereya/hereya-cli/blob/v0.57.4/src/commands/remove/index.ts)_
+_See code: [src/commands/remove/index.ts](https://github.com/hereya/hereya-cli/blob/v0.58.0/src/commands/remove/index.ts)_
 
 ## `hereya run CMD`
 
@@ -780,7 +781,38 @@ EXAMPLES
   $ hereya run -w uat -- node index.js
 ```
 
-_See code: [src/commands/run/index.ts](https://github.com/hereya/hereya-cli/blob/v0.57.4/src/commands/run/index.ts)_
+_See code: [src/commands/run/index.ts](https://github.com/hereya/hereya-cli/blob/v0.58.0/src/commands/run/index.ts)_
+
+## `hereya search QUERY`
+
+Search for packages in the registry
+
+```
+USAGE
+  $ hereya search QUERY [-C <value>] [-j] [-l <value>]
+
+ARGUMENTS
+  QUERY  Search query string
+
+FLAGS
+  -j, --json           Output in JSON format
+  -l, --limit=<value>  [default: 20] Maximum number of results to return
+
+GLOBAL FLAGS
+  -C, --chdir=<value>  [default: .] directory to run command in
+
+DESCRIPTION
+  Search for packages in the registry
+
+EXAMPLES
+  $ hereya search postgres
+
+  $ hereya search redis --limit 5
+
+  $ hereya search database --json
+```
+
+_See code: [src/commands/search/index.ts](https://github.com/hereya/hereya-cli/blob/v0.58.0/src/commands/search/index.ts)_
 
 ## `hereya unbootstrap INFRASTRUCTURETYPE`
 
@@ -805,7 +837,7 @@ EXAMPLES
   $ hereya unbootstrap local
 ```
 
-_See code: [src/commands/unbootstrap/index.ts](https://github.com/hereya/hereya-cli/blob/v0.57.4/src/commands/unbootstrap/index.ts)_
+_See code: [src/commands/unbootstrap/index.ts](https://github.com/hereya/hereya-cli/blob/v0.58.0/src/commands/unbootstrap/index.ts)_
 
 ## `hereya undeploy`
 
@@ -830,7 +862,7 @@ EXAMPLES
   $ hereya undeploy
 ```
 
-_See code: [src/commands/undeploy/index.ts](https://github.com/hereya/hereya-cli/blob/v0.57.4/src/commands/undeploy/index.ts)_
+_See code: [src/commands/undeploy/index.ts](https://github.com/hereya/hereya-cli/blob/v0.58.0/src/commands/undeploy/index.ts)_
 
 ## `hereya up`
 
@@ -857,7 +889,7 @@ EXAMPLES
   $ hereya up
 ```
 
-_See code: [src/commands/up/index.ts](https://github.com/hereya/hereya-cli/blob/v0.57.4/src/commands/up/index.ts)_
+_See code: [src/commands/up/index.ts](https://github.com/hereya/hereya-cli/blob/v0.58.0/src/commands/up/index.ts)_
 
 ## `hereya workspace create NAME`
 
@@ -882,7 +914,7 @@ EXAMPLES
   $ hereya workspace create dev
 ```
 
-_See code: [src/commands/workspace/create/index.ts](https://github.com/hereya/hereya-cli/blob/v0.57.4/src/commands/workspace/create/index.ts)_
+_See code: [src/commands/workspace/create/index.ts](https://github.com/hereya/hereya-cli/blob/v0.58.0/src/commands/workspace/create/index.ts)_
 
 ## `hereya workspace delete NAME`
 
@@ -902,7 +934,7 @@ EXAMPLES
   $ hereya workspace delete dev
 ```
 
-_See code: [src/commands/workspace/delete/index.ts](https://github.com/hereya/hereya-cli/blob/v0.57.4/src/commands/workspace/delete/index.ts)_
+_See code: [src/commands/workspace/delete/index.ts](https://github.com/hereya/hereya-cli/blob/v0.58.0/src/commands/workspace/delete/index.ts)_
 
 ## `hereya workspace env [NAME]`
 
@@ -928,7 +960,7 @@ EXAMPLES
   $ hereya workspace env myEnv -w dev
 ```
 
-_See code: [src/commands/workspace/env/index.ts](https://github.com/hereya/hereya-cli/blob/v0.57.4/src/commands/workspace/env/index.ts)_
+_See code: [src/commands/workspace/env/index.ts](https://github.com/hereya/hereya-cli/blob/v0.58.0/src/commands/workspace/env/index.ts)_
 
 ## `hereya workspace env set`
 
@@ -952,7 +984,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.57.4/src/commands/workspace/env/set/index.ts)_
+_See code: [src/commands/workspace/env/set/index.ts](https://github.com/hereya/hereya-cli/blob/v0.58.0/src/commands/workspace/env/set/index.ts)_
 
 ## `hereya workspace env unset`
 
@@ -973,7 +1005,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.57.4/src/commands/workspace/env/unset/index.ts)_
+_See code: [src/commands/workspace/env/unset/index.ts](https://github.com/hereya/hereya-cli/blob/v0.58.0/src/commands/workspace/env/unset/index.ts)_
 
 ## `hereya workspace install PACKAGE`
 
@@ -1000,7 +1032,7 @@ EXAMPLES
   $ hereya workspace install hereya/aws-cognito
 ```
 
-_See code: [src/commands/workspace/install/index.ts](https://github.com/hereya/hereya-cli/blob/v0.57.4/src/commands/workspace/install/index.ts)_
+_See code: [src/commands/workspace/install/index.ts](https://github.com/hereya/hereya-cli/blob/v0.58.0/src/commands/workspace/install/index.ts)_
 
 ## `hereya workspace list`
 
@@ -1017,7 +1049,7 @@ EXAMPLES
   $ hereya workspace list
 ```
 
-_See code: [src/commands/workspace/list/index.ts](https://github.com/hereya/hereya-cli/blob/v0.57.4/src/commands/workspace/list/index.ts)_
+_See code: [src/commands/workspace/list/index.ts](https://github.com/hereya/hereya-cli/blob/v0.58.0/src/commands/workspace/list/index.ts)_
 
 ## `hereya workspace set-profile PROFILE`
 
@@ -1041,7 +1073,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.57.4/src/commands/workspace/set-profile/index.ts)_
+_See code: [src/commands/workspace/set-profile/index.ts](https://github.com/hereya/hereya-cli/blob/v0.58.0/src/commands/workspace/set-profile/index.ts)_
 
 ## `hereya workspace uninstall PACKAGE`
 
@@ -1068,5 +1100,5 @@ EXAMPLES
   $ hereya workspace uninstall hereya/aws-cognito
 ```
 
-_See code: [src/commands/workspace/uninstall/index.ts](https://github.com/hereya/hereya-cli/blob/v0.57.4/src/commands/workspace/uninstall/index.ts)_
+_See code: [src/commands/workspace/uninstall/index.ts](https://github.com/hereya/hereya-cli/blob/v0.58.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, 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 { 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, SearchPackagesInput, SearchPackagesOutput, SetEnvVarInput, SetEnvVarOutput, UnsetEnvVarInput, UnsetEnvVarOutput, UpdateWorkspaceInput, UpdateWorkspaceOutput } from '../common.js';
 interface CloudBackendConfig {
     accessToken: string;
     clientId: string;
@@ -27,6 +27,7 @@ export declare class CloudBackend implements Backend {
     publishPackage(input: PublishPackageInput): Promise<PublishPackageOutput>;
     removePackageFromWorkspace(input: RemovePackageFromWorkspaceInput): Promise<RemovePackageFromWorkspaceOutput>;
     saveState(config: Config, workspace?: string): Promise<void>;
+    searchPackages(input: SearchPackagesInput): Promise<SearchPackagesOutput>;
     setEnvVar(input: SetEnvVarInput): Promise<SetEnvVarOutput>;
     unsetEnvVar(input: UnsetEnvVarInput): Promise<UnsetEnvVarOutput>;
     updateWorkspace(input: UpdateWorkspaceInput): Promise<UpdateWorkspaceOutput>;

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

@@ -550,6 +550,49 @@ export class CloudBackend {
             throw new Error(JSON.stringify(await response.json()));
         }
     }
+    async searchPackages(input) {
+        const url = new URL(`${this.config.url}/api/registry/packages/search`);
+        url.searchParams.append('q', input.query);
+        if (input.limit !== undefined) {
+            url.searchParams.append('limit', String(input.limit));
+        }
+        if (input.offset !== undefined) {
+            url.searchParams.append('offset', String(input.offset));
+        }
+        const response = await fetch(url, {
+            headers: {
+                'Authorization': `Bearer ${this.config.accessToken}`,
+            },
+            method: 'GET',
+        });
+        const result = await response.json();
+        if (!response.ok) {
+            let errorMessage = result.error || 'Failed to search packages';
+            switch (response.status) {
+                case 400: {
+                    errorMessage = `Invalid search query: ${errorMessage}`;
+                    break;
+                }
+                case 401: {
+                    errorMessage = 'Authentication failed. Please run `hereya login` to refresh your credentials.';
+                    break;
+                }
+                case 500: {
+                    errorMessage = `Server error: ${errorMessage}`;
+                    break;
+                }
+            }
+            return {
+                reason: errorMessage,
+                success: false,
+            };
+        }
+        return {
+            hasMore: result.hasMore ?? false,
+            packages: result.packages || [],
+            success: true,
+        };
+    }
     async setEnvVar(input) {
         const formData = new FormData();
         formData.append('key', input.name);

package/dist/backend/common.d.ts

@@ -20,6 +20,7 @@ export interface Backend {
     publishPackage?(input: PublishPackageInput): Promise<PublishPackageOutput>;
     removePackageFromWorkspace(input: RemovePackageFromWorkspaceInput): Promise<RemovePackageFromWorkspaceOutput>;
     saveState(config: Config, workspace?: string): Promise<void>;
+    searchPackages?(input: SearchPackagesInput): Promise<SearchPackagesOutput>;
     setEnvVar(input: SetEnvVarInput): Promise<SetEnvVarOutput>;
     unsetEnvVar(input: UnsetEnvVarInput): Promise<UnsetEnvVarOutput>;
     updateWorkspace(input: UpdateWorkspaceInput): Promise<UpdateWorkspaceOutput>;
@@ -289,3 +290,16 @@ export type ListPackageVersionsOutput = {
     reason: string;
     success: false;
 };
+export type SearchPackagesInput = {
+    limit?: number;
+    offset?: number;
+    query: string;
+};
+export type SearchPackagesOutput = {
+    hasMore: boolean;
+    packages: RegistryPackage[];
+    success: true;
+} | {
+    reason: string;
+    success: false;
+};

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

@@ -0,0 +1,15 @@
+import { Command } from '@oclif/core';
+export default class Search extends Command {
+    static args: {
+        query: 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>;
+        limit: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+    private displayResults;
+}

package/dist/commands/search/index.js

@@ -0,0 +1,90 @@
+import { Args, Command, Flags } from '@oclif/core';
+import chalk from 'chalk';
+import { getBackend } from '../../backend/index.js';
+export default class Search extends Command {
+    static args = {
+        query: Args.string({
+            description: 'Search query string',
+            required: true,
+        }),
+    };
+    static description = 'Search for packages in the registry';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> postgres',
+        '<%= config.bin %> <%= command.id %> redis --limit 5',
+        '<%= config.bin %> <%= command.id %> database --json',
+    ];
+    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',
+        }),
+        limit: Flags.integer({
+            char: 'l',
+            default: 20,
+            description: 'Maximum number of results to return',
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(Search);
+        // Change to specified directory
+        if (flags.chdir !== '.') {
+            process.chdir(flags.chdir);
+        }
+        // Get backend
+        const backend = await getBackend();
+        // Check if backend supports search operations
+        if (!backend.searchPackages) {
+            this.error('Package search is only supported with the cloud backend. Please run `hereya login` to use cloud backend.');
+        }
+        try {
+            const result = await backend.searchPackages({
+                limit: flags.limit,
+                query: args.query,
+            });
+            if (!result.success) {
+                this.error(result.reason);
+            }
+            // Output JSON if requested
+            if (flags.json) {
+                this.log(JSON.stringify({
+                    hasMore: result.hasMore,
+                    packages: result.packages,
+                }, null, 2));
+                return;
+            }
+            // Display results in formatted output
+            this.displayResults(result.packages, result.hasMore);
+        }
+        catch (error) {
+            this.error(error instanceof Error ? error.message : 'Failed to search packages');
+        }
+    }
+    displayResults(packages, hasMore) {
+        if (packages.length === 0) {
+            this.log(chalk.yellow('No packages found matching your query.'));
+            return;
+        }
+        this.log(`Found ${chalk.bold(packages.length)} package(s):`);
+        this.log();
+        for (const pkg of packages) {
+            const visibilityBadge = pkg.visibility === 'PUBLIC'
+                ? chalk.green('PUBLIC')
+                : chalk.yellow('PRIVATE');
+            this.log(`  ${chalk.cyan.bold(`${pkg.name}@${pkg.version}`)} ${visibilityBadge}`);
+            if (pkg.description) {
+                this.log(`    ${chalk.gray(pkg.description)}`);
+            }
+            this.log();
+        }
+        if (hasMore) {
+            this.log(chalk.dim('More results available. Use --limit to see more.'));
+        }
+    }
+}

package/oclif.manifest.json

@@ -701,6 +701,65 @@
         "index.js"
       ]
     },
+    "search": {
+      "aliases": [],
+      "args": {
+        "query": {
+          "description": "Search query string",
+          "name": "query",
+          "required": true
+        }
+      },
+      "description": "Search for packages in the registry",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> postgres",
+        "<%= config.bin %> <%= command.id %> redis --limit 5",
+        "<%= config.bin %> <%= command.id %> database --json"
+      ],
+      "flags": {
+        "chdir": {
+          "char": "C",
+          "description": "directory to run command in",
+          "helpGroup": "global",
+          "name": "chdir",
+          "default": ".",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "json": {
+          "char": "j",
+          "description": "Output in JSON format",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "limit": {
+          "char": "l",
+          "description": "Maximum number of results to return",
+          "name": "limit",
+          "default": 20,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "search",
+      "pluginAlias": "hereya-cli",
+      "pluginName": "hereya-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "search",
+        "index.js"
+      ]
+    },
     "unbootstrap": {
       "aliases": [],
       "args": {
@@ -1877,5 +1936,5 @@
       ]
     }
   },
-  "version": "0.57.4"
+  "version": "0.58.0"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "hereya-cli",
   "description": "Infrastructure as Package",
-  "version": "0.57.4",
+  "version": "0.58.0",
   "author": "Hereya Developers",
   "bin": {
     "hereya": "./bin/run.js"