hereya-cli 0.60.0 → 0.61.0

package/README.md

@@ -20,7 +20,7 @@ $ npm install -g hereya-cli
 $ hereya COMMAND
 running command...
 $ hereya (--version)
-hereya-cli/0.60.0 linux-x64 node-v24.13.0
+hereya-cli/0.61.0 linux-x64 node-v24.13.0
 $ hereya --help [COMMAND]
 USAGE
   $ hereya COMMAND
@@ -52,6 +52,7 @@ USAGE
 * [`hereya init PROJECT`](#hereya-init-project)
 * [`hereya login [URL]`](#hereya-login-url)
 * [`hereya logout`](#hereya-logout)
+* [`hereya provid PACKAGE`](#hereya-provid-package)
 * [`hereya publish`](#hereya-publish)
 * [`hereya remove PACKAGE`](#hereya-remove-package)
 * [`hereya run CMD`](#hereya-run-cmd)
@@ -101,7 +102,7 @@ EXAMPLES
   $ hereya add cloudy/docker_postgres
 ```
 
-_See code: [src/commands/add/index.ts](https://github.com/hereya/hereya-cli/blob/v0.60.0/src/commands/add/index.ts)_
+_See code: [src/commands/add/index.ts](https://github.com/hereya/hereya-cli/blob/v0.61.0/src/commands/add/index.ts)_
 
 ## `hereya bootstrap INFRASTRUCTURETYPE`
 
@@ -126,7 +127,7 @@ EXAMPLES
   $ hereya bootstrap local
 ```
 
-_See code: [src/commands/bootstrap/index.ts](https://github.com/hereya/hereya-cli/blob/v0.60.0/src/commands/bootstrap/index.ts)_
+_See code: [src/commands/bootstrap/index.ts](https://github.com/hereya/hereya-cli/blob/v0.61.0/src/commands/bootstrap/index.ts)_
 
 ## `hereya config export-backend [FILE]`
 
@@ -148,7 +149,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.60.0/src/commands/config/export-backend/index.ts)_
+_See code: [src/commands/config/export-backend/index.ts](https://github.com/hereya/hereya-cli/blob/v0.61.0/src/commands/config/export-backend/index.ts)_
 
 ## `hereya config get-backend`
 
@@ -165,7 +166,7 @@ EXAMPLES
   $ hereya config get-backend
 ```
 
-_See code: [src/commands/config/get-backend/index.ts](https://github.com/hereya/hereya-cli/blob/v0.60.0/src/commands/config/get-backend/index.ts)_
+_See code: [src/commands/config/get-backend/index.ts](https://github.com/hereya/hereya-cli/blob/v0.61.0/src/commands/config/get-backend/index.ts)_
 
 ## `hereya config import-backend FILE`
 
@@ -185,7 +186,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.60.0/src/commands/config/import-backend/index.ts)_
+_See code: [src/commands/config/import-backend/index.ts](https://github.com/hereya/hereya-cli/blob/v0.61.0/src/commands/config/import-backend/index.ts)_
 
 ## `hereya config use-backend TYPE`
 
@@ -207,7 +208,7 @@ EXAMPLES
   $ hereya config use-backend local
 ```
 
-_See code: [src/commands/config/use-backend/index.ts](https://github.com/hereya/hereya-cli/blob/v0.60.0/src/commands/config/use-backend/index.ts)_
+_See code: [src/commands/config/use-backend/index.ts](https://github.com/hereya/hereya-cli/blob/v0.61.0/src/commands/config/use-backend/index.ts)_
 
 ## `hereya delete-state`
 
@@ -233,7 +234,7 @@ EXAMPLES
   $ hereya delete-state --workspace staging
 ```
 
-_See code: [src/commands/delete-state/index.ts](https://github.com/hereya/hereya-cli/blob/v0.60.0/src/commands/delete-state/index.ts)_
+_See code: [src/commands/delete-state/index.ts](https://github.com/hereya/hereya-cli/blob/v0.61.0/src/commands/delete-state/index.ts)_
 
 ## `hereya deploy`
 
@@ -258,7 +259,7 @@ EXAMPLES
   $ hereya deploy
 ```
 
-_See code: [src/commands/deploy/index.ts](https://github.com/hereya/hereya-cli/blob/v0.60.0/src/commands/deploy/index.ts)_
+_See code: [src/commands/deploy/index.ts](https://github.com/hereya/hereya-cli/blob/v0.61.0/src/commands/deploy/index.ts)_
 
 ## `hereya doc PACKAGE`
 
@@ -291,7 +292,7 @@ EXAMPLES
   $ hereya doc my-package --no-doc
 ```
 
-_See code: [src/commands/doc/index.ts](https://github.com/hereya/hereya-cli/blob/v0.60.0/src/commands/doc/index.ts)_
+_See code: [src/commands/doc/index.ts](https://github.com/hereya/hereya-cli/blob/v0.61.0/src/commands/doc/index.ts)_
 
 ## `hereya down`
 
@@ -318,7 +319,7 @@ EXAMPLES
   $ hereya down
 ```
 
-_See code: [src/commands/down/index.ts](https://github.com/hereya/hereya-cli/blob/v0.60.0/src/commands/down/index.ts)_
+_See code: [src/commands/down/index.ts](https://github.com/hereya/hereya-cli/blob/v0.61.0/src/commands/down/index.ts)_
 
 ## `hereya env [NAME]`
 
@@ -349,7 +350,7 @@ EXAMPLES
   $ hereya env -w dev -l
 ```
 
-_See code: [src/commands/env/index.ts](https://github.com/hereya/hereya-cli/blob/v0.60.0/src/commands/env/index.ts)_
+_See code: [src/commands/env/index.ts](https://github.com/hereya/hereya-cli/blob/v0.61.0/src/commands/env/index.ts)_
 
 ## `hereya env set [NAME]`
 
@@ -376,7 +377,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.60.0/src/commands/env/set/index.ts)_
+_See code: [src/commands/env/set/index.ts](https://github.com/hereya/hereya-cli/blob/v0.61.0/src/commands/env/set/index.ts)_
 
 ## `hereya flow add PACKAGE`
 
@@ -414,7 +415,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.60.0/src/commands/flow/add/index.ts)_
+_See code: [src/commands/flow/add/index.ts](https://github.com/hereya/hereya-cli/blob/v0.61.0/src/commands/flow/add/index.ts)_
 
 ## `hereya flow down`
 
@@ -448,7 +449,7 @@ EXAMPLES
   $ hereya flow down --pin
 ```
 
-_See code: [src/commands/flow/down/index.ts](https://github.com/hereya/hereya-cli/blob/v0.60.0/src/commands/flow/down/index.ts)_
+_See code: [src/commands/flow/down/index.ts](https://github.com/hereya/hereya-cli/blob/v0.61.0/src/commands/flow/down/index.ts)_
 
 ## `hereya flow env [NAME]`
 
@@ -482,7 +483,7 @@ EXAMPLES
   $ hereya flow env -l
 ```
 
-_See code: [src/commands/flow/env/index.ts](https://github.com/hereya/hereya-cli/blob/v0.60.0/src/commands/flow/env/index.ts)_
+_See code: [src/commands/flow/env/index.ts](https://github.com/hereya/hereya-cli/blob/v0.61.0/src/commands/flow/env/index.ts)_
 
 ## `hereya flow remove PACKAGE`
 
@@ -512,7 +513,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.60.0/src/commands/flow/remove/index.ts)_
+_See code: [src/commands/flow/remove/index.ts](https://github.com/hereya/hereya-cli/blob/v0.61.0/src/commands/flow/remove/index.ts)_
 
 ## `hereya flow run CMD`
 
@@ -541,7 +542,7 @@ EXAMPLES
   $ hereya flow run --pin -- npm test
 ```
 
-_See code: [src/commands/flow/run/index.ts](https://github.com/hereya/hereya-cli/blob/v0.60.0/src/commands/flow/run/index.ts)_
+_See code: [src/commands/flow/run/index.ts](https://github.com/hereya/hereya-cli/blob/v0.61.0/src/commands/flow/run/index.ts)_
 
 ## `hereya flow up`
 
@@ -575,7 +576,7 @@ EXAMPLES
   $ hereya flow up --pin
 ```
 
-_See code: [src/commands/flow/up/index.ts](https://github.com/hereya/hereya-cli/blob/v0.60.0/src/commands/flow/up/index.ts)_
+_See code: [src/commands/flow/up/index.ts](https://github.com/hereya/hereya-cli/blob/v0.61.0/src/commands/flow/up/index.ts)_
 
 ## `hereya help [COMMAND]`
 
@@ -632,7 +633,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.60.0/src/commands/import/index.ts)_
+_See code: [src/commands/import/index.ts](https://github.com/hereya/hereya-cli/blob/v0.61.0/src/commands/import/index.ts)_
 
 ## `hereya init PROJECT`
 
@@ -658,7 +659,7 @@ EXAMPLES
   $ hereya init myProject -w=defaultWorkspace --chdir=./myProject
 ```
 
-_See code: [src/commands/init/index.ts](https://github.com/hereya/hereya-cli/blob/v0.60.0/src/commands/init/index.ts)_
+_See code: [src/commands/init/index.ts](https://github.com/hereya/hereya-cli/blob/v0.61.0/src/commands/init/index.ts)_
 
 ## `hereya login [URL]`
 
@@ -687,7 +688,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.60.0/src/commands/login/index.ts)_
+_See code: [src/commands/login/index.ts](https://github.com/hereya/hereya-cli/blob/v0.61.0/src/commands/login/index.ts)_
 
 ## `hereya logout`
 
@@ -704,7 +705,35 @@ EXAMPLES
   $ hereya logout
 ```
 
-_See code: [src/commands/logout/index.ts](https://github.com/hereya/hereya-cli/blob/v0.60.0/src/commands/logout/index.ts)_
+_See code: [src/commands/logout/index.ts](https://github.com/hereya/hereya-cli/blob/v0.61.0/src/commands/logout/index.ts)_
+
+## `hereya provid PACKAGE`
+
+Display the provisioning ID for a package
+
+```
+USAGE
+  $ hereya provid PACKAGE [-C <value>] [-w <value>]
+
+ARGUMENTS
+  PACKAGE  Package name (e.g., hereya/postgres)
+
+FLAGS
+  -C, --chdir=<value>      Project root directory
+  -w, --workspace=<value>  Name of the workspace
+
+DESCRIPTION
+  Display the provisioning ID for a package
+
+EXAMPLES
+  $ hereya provid hereya/postgres
+
+  $ hereya provid hereya/postgres -w dev
+
+  $ hereya provid hereya/postgres --workspace staging
+```
+
+_See code: [src/commands/provid/index.ts](https://github.com/hereya/hereya-cli/blob/v0.61.0/src/commands/provid/index.ts)_
 
 ## `hereya publish`
 
@@ -727,7 +756,7 @@ EXAMPLES
   $ hereya publish --chdir=/path/to/package
 ```
 
-_See code: [src/commands/publish/index.ts](https://github.com/hereya/hereya-cli/blob/v0.60.0/src/commands/publish/index.ts)_
+_See code: [src/commands/publish/index.ts](https://github.com/hereya/hereya-cli/blob/v0.61.0/src/commands/publish/index.ts)_
 
 ## `hereya remove PACKAGE`
 
@@ -755,7 +784,7 @@ EXAMPLES
   $ hereya remove cloudy/docker_postgres
 ```
 
-_See code: [src/commands/remove/index.ts](https://github.com/hereya/hereya-cli/blob/v0.60.0/src/commands/remove/index.ts)_
+_See code: [src/commands/remove/index.ts](https://github.com/hereya/hereya-cli/blob/v0.61.0/src/commands/remove/index.ts)_
 
 ## `hereya run CMD`
 
@@ -781,7 +810,7 @@ EXAMPLES
   $ hereya run -w uat -- node index.js
 ```
 
-_See code: [src/commands/run/index.ts](https://github.com/hereya/hereya-cli/blob/v0.60.0/src/commands/run/index.ts)_
+_See code: [src/commands/run/index.ts](https://github.com/hereya/hereya-cli/blob/v0.61.0/src/commands/run/index.ts)_
 
 ## `hereya search QUERY`
 
@@ -812,7 +841,7 @@ EXAMPLES
   $ hereya search database --json
 ```
 
-_See code: [src/commands/search/index.ts](https://github.com/hereya/hereya-cli/blob/v0.60.0/src/commands/search/index.ts)_
+_See code: [src/commands/search/index.ts](https://github.com/hereya/hereya-cli/blob/v0.61.0/src/commands/search/index.ts)_
 
 ## `hereya unbootstrap INFRASTRUCTURETYPE`
 
@@ -837,7 +866,7 @@ EXAMPLES
   $ hereya unbootstrap local
 ```
 
-_See code: [src/commands/unbootstrap/index.ts](https://github.com/hereya/hereya-cli/blob/v0.60.0/src/commands/unbootstrap/index.ts)_
+_See code: [src/commands/unbootstrap/index.ts](https://github.com/hereya/hereya-cli/blob/v0.61.0/src/commands/unbootstrap/index.ts)_
 
 ## `hereya undeploy`
 
@@ -862,7 +891,7 @@ EXAMPLES
   $ hereya undeploy
 ```
 
-_See code: [src/commands/undeploy/index.ts](https://github.com/hereya/hereya-cli/blob/v0.60.0/src/commands/undeploy/index.ts)_
+_See code: [src/commands/undeploy/index.ts](https://github.com/hereya/hereya-cli/blob/v0.61.0/src/commands/undeploy/index.ts)_
 
 ## `hereya up`
 
@@ -889,7 +918,7 @@ EXAMPLES
   $ hereya up
 ```
 
-_See code: [src/commands/up/index.ts](https://github.com/hereya/hereya-cli/blob/v0.60.0/src/commands/up/index.ts)_
+_See code: [src/commands/up/index.ts](https://github.com/hereya/hereya-cli/blob/v0.61.0/src/commands/up/index.ts)_
 
 ## `hereya workspace create NAME`
 
@@ -914,7 +943,7 @@ EXAMPLES
   $ hereya workspace create dev
 ```
 
-_See code: [src/commands/workspace/create/index.ts](https://github.com/hereya/hereya-cli/blob/v0.60.0/src/commands/workspace/create/index.ts)_
+_See code: [src/commands/workspace/create/index.ts](https://github.com/hereya/hereya-cli/blob/v0.61.0/src/commands/workspace/create/index.ts)_
 
 ## `hereya workspace delete NAME`
 
@@ -934,7 +963,7 @@ EXAMPLES
   $ hereya workspace delete dev
 ```
 
-_See code: [src/commands/workspace/delete/index.ts](https://github.com/hereya/hereya-cli/blob/v0.60.0/src/commands/workspace/delete/index.ts)_
+_See code: [src/commands/workspace/delete/index.ts](https://github.com/hereya/hereya-cli/blob/v0.61.0/src/commands/workspace/delete/index.ts)_
 
 ## `hereya workspace env [NAME]`
 
@@ -960,7 +989,7 @@ EXAMPLES
   $ hereya workspace env myEnv -w dev
 ```
 
-_See code: [src/commands/workspace/env/index.ts](https://github.com/hereya/hereya-cli/blob/v0.60.0/src/commands/workspace/env/index.ts)_
+_See code: [src/commands/workspace/env/index.ts](https://github.com/hereya/hereya-cli/blob/v0.61.0/src/commands/workspace/env/index.ts)_
 
 ## `hereya workspace env set`
 
@@ -984,7 +1013,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.60.0/src/commands/workspace/env/set/index.ts)_
+_See code: [src/commands/workspace/env/set/index.ts](https://github.com/hereya/hereya-cli/blob/v0.61.0/src/commands/workspace/env/set/index.ts)_
 
 ## `hereya workspace env unset`
 
@@ -1005,7 +1034,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.60.0/src/commands/workspace/env/unset/index.ts)_
+_See code: [src/commands/workspace/env/unset/index.ts](https://github.com/hereya/hereya-cli/blob/v0.61.0/src/commands/workspace/env/unset/index.ts)_
 
 ## `hereya workspace install PACKAGE`
 
@@ -1032,7 +1061,7 @@ EXAMPLES
   $ hereya workspace install hereya/aws-cognito
 ```
 
-_See code: [src/commands/workspace/install/index.ts](https://github.com/hereya/hereya-cli/blob/v0.60.0/src/commands/workspace/install/index.ts)_
+_See code: [src/commands/workspace/install/index.ts](https://github.com/hereya/hereya-cli/blob/v0.61.0/src/commands/workspace/install/index.ts)_
 
 ## `hereya workspace list`
 
@@ -1049,7 +1078,7 @@ EXAMPLES
   $ hereya workspace list
 ```
 
-_See code: [src/commands/workspace/list/index.ts](https://github.com/hereya/hereya-cli/blob/v0.60.0/src/commands/workspace/list/index.ts)_
+_See code: [src/commands/workspace/list/index.ts](https://github.com/hereya/hereya-cli/blob/v0.61.0/src/commands/workspace/list/index.ts)_
 
 ## `hereya workspace set-profile PROFILE`
 
@@ -1073,7 +1102,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.60.0/src/commands/workspace/set-profile/index.ts)_
+_See code: [src/commands/workspace/set-profile/index.ts](https://github.com/hereya/hereya-cli/blob/v0.61.0/src/commands/workspace/set-profile/index.ts)_
 
 ## `hereya workspace uninstall PACKAGE`
 
@@ -1100,5 +1129,5 @@ EXAMPLES
   $ hereya workspace uninstall hereya/aws-cognito
 ```
 
-_See code: [src/commands/workspace/uninstall/index.ts](https://github.com/hereya/hereya-cli/blob/v0.60.0/src/commands/workspace/uninstall/index.ts)_
+_See code: [src/commands/workspace/uninstall/index.ts](https://github.com/hereya/hereya-cli/blob/v0.61.0/src/commands/workspace/uninstall/index.ts)_
 <!-- commandsstop -->

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

@@ -0,0 +1,14 @@
+import { Command } from '@oclif/core';
+export default class Provid 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 | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        workspace: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+    private findPackageVersion;
+}

package/dist/commands/provid/index.js

@@ -0,0 +1,104 @@
+import { Args, Command, Flags } from '@oclif/core';
+import fs from 'node:fs/promises';
+import { getBackend } from '../../backend/index.js';
+import { getPackageDownloadPath } from '../../infrastructure/common.js';
+import { getProvisioningLogicalId } from '../../infrastructure/index.js';
+import { getConfigManager } from '../../lib/config/index.js';
+import { getPackageCanonicalName } from '../../lib/package/index.js';
+export default class Provid extends Command {
+    static args = {
+        package: Args.string({
+            description: 'Package name (e.g., hereya/postgres)',
+            required: true,
+        }),
+    };
+    static description = 'Display the provisioning ID for a package';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> hereya/postgres',
+        '<%= config.bin %> <%= command.id %> hereya/postgres -w dev',
+        '<%= config.bin %> <%= command.id %> hereya/postgres --workspace staging',
+    ];
+    static flags = {
+        chdir: Flags.string({
+            char: 'C',
+            description: 'Project root directory',
+            required: false,
+        }),
+        workspace: Flags.string({
+            char: 'w',
+            description: 'Name of the workspace',
+            required: false,
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(Provid);
+        const projectRootDir = flags.chdir || process.env.HEREYA_PROJECT_ROOT_DIR;
+        const configManager = getConfigManager();
+        const loadConfigOutput = await configManager.loadConfig({ projectRootDir });
+        if (!loadConfigOutput.found) {
+            this.warn(`Project not initialized. Run 'hereya init' first.`);
+            return;
+        }
+        const { config } = loadConfigOutput;
+        let { workspace } = flags;
+        if (!workspace) {
+            workspace = config.workspace;
+        }
+        if (!workspace) {
+            this.error('You must specify a workspace with --workspace or set a default workspace in hereya.yaml');
+        }
+        const { project } = config;
+        const packageName = args.package;
+        const packageCanonicalName = getPackageCanonicalName(packageName);
+        const logicalId = getProvisioningLogicalId({ pkg: packageName, project, workspace });
+        const backend = await getBackend();
+        const provisioningIdResult = await backend.getProvisioningId({
+            logicalId,
+            packageCanonicalName,
+            project,
+            workspace,
+        });
+        if (!provisioningIdResult.success) {
+            this.error(provisioningIdResult.reason);
+        }
+        // Get version from config (packages, deploy, or onDeploy sections)
+        const version = this.findPackageVersion(config, packageName);
+        const packagePath = await getPackageDownloadPath({ id: provisioningIdResult.id, version });
+        this.log(`Package: ${packageName}`);
+        this.log(`Workspace: ${workspace}`);
+        this.log(`Project: ${project}`);
+        this.log(`Logical ID: ${logicalId}`);
+        this.log(`Provisioning ID: ${provisioningIdResult.id}`);
+        // Check if the package path exists locally
+        const pathExists = await fs.stat(packagePath).then(() => true).catch(() => false);
+        if (pathExists) {
+            this.log(`Package Path: ${packagePath}`);
+        }
+        else {
+            this.log(`Package Path: not found locally (provisioning may not have happened yet or occurred on a different computer)`);
+        }
+    }
+    findPackageVersion(config, packageName) {
+        // Check direct packages entry
+        if (config.packages?.[packageName]?.version) {
+            return config.packages[packageName].version;
+        }
+        // Check direct deploy entry
+        if (config.deploy?.[packageName]?.version) {
+            return config.deploy[packageName].version;
+        }
+        // Check onDeploy sections in packages
+        for (const pkg of Object.values(config.packages ?? {})) {
+            if (pkg.onDeploy?.pkg === packageName && pkg.onDeploy?.version) {
+                return pkg.onDeploy.version;
+            }
+        }
+        // Check onDeploy sections in deploy
+        for (const pkg of Object.values(config.deploy ?? {})) {
+            if (pkg.onDeploy?.pkg === packageName && pkg.onDeploy?.version) {
+                return pkg.onDeploy.version;
+            }
+        }
+        return undefined;
+    }
+}

package/dist/iac/common.d.ts

@@ -17,9 +17,10 @@ export type ApplyInput = {
     };
     id: string;
     infraConfig?: {
-        terraformStateBucketName: string;
+        localStatePath?: string;
+        terraformStateBucketName?: string;
         terraformStateBucketRegion?: string;
-        terraformStateLockTableName: string;
+        terraformStateLockTableName?: string;
     };
     logger?: Logger;
     parameters?: {
@@ -40,10 +41,11 @@ export type DestroyInput = ApplyInput;
 export type DestroyOutput = ApplyOutput;
 export type GetStateLocationInput = {
     id: string;
-    infraConfig: {
-        terraformStateBucketName: string;
+    infraConfig?: {
+        localStatePath?: string;
+        terraformStateBucketName?: string;
         terraformStateBucketRegion?: string;
-        terraformStateLockTableName: string;
+        terraformStateLockTableName?: string;
     };
 };
 export type GetStateLocationOutput = {
@@ -51,6 +53,9 @@ export type GetStateLocationOutput = {
     key: string;
     region: string;
     success: true;
+} | {
+    localPath: string;
+    success: true;
 } | {
     reason: string;
     success: false;

package/dist/iac/terraform.js

@@ -8,10 +8,24 @@ import { mapObject } from '../lib/object-utils.js';
 import { runShell } from '../lib/shell.js';
 export class Terraform {
     async apply(input) {
-        if (input.infraConfig &&
+        if (input.infraConfig?.localStatePath) {
+            // Local backend
+            await fs.promises.mkdir(input.infraConfig.localStatePath, { recursive: true });
+            const backendConfig = `
+      terraform {
+            backend "local" {
+                path = "${path.join(input.infraConfig.localStatePath, 'terraform.tfstate')}"
+            }
+      }
+      `;
+            const backendFile = path.join(input.pkgPath, 'hereya_terraform_backend.tf');
+            await fs.promises.writeFile(backendFile, backendConfig);
+        }
+        else if (input.infraConfig &&
             input.infraConfig.terraformStateBucketName &&
             input.infraConfig.terraformStateLockTableName &&
             input.infraConfig.terraformStateBucketRegion) {
+            // S3 backend
             const backendConfig = `
       terraform {
             backend "s3" {
@@ -72,6 +86,38 @@ export class Terraform {
     }
     async destroy(input) {
         const terraform = await this.getTerraformBinary(input.logger);
+        // Write backend configuration
+        if (input.infraConfig?.localStatePath) {
+            // Local backend
+            await fs.promises.mkdir(input.infraConfig.localStatePath, { recursive: true });
+            const backendConfig = `
+      terraform {
+            backend "local" {
+                path = "${path.join(input.infraConfig.localStatePath, 'terraform.tfstate')}"
+            }
+      }
+      `;
+            const backendFile = path.join(input.pkgPath, 'hereya_terraform_backend.tf');
+            await fs.promises.writeFile(backendFile, backendConfig);
+        }
+        else if (input.infraConfig &&
+            input.infraConfig.terraformStateBucketName &&
+            input.infraConfig.terraformStateLockTableName &&
+            input.infraConfig.terraformStateBucketRegion) {
+            // S3 backend
+            const backendConfig = `
+      terraform {
+            backend "s3" {
+                bucket = "${input.infraConfig.terraformStateBucketName}"
+                key = "${input.id}/terraform.tfstate"
+                region = "${input.infraConfig.terraformStateBucketRegion}"
+                dynamodb_table = "${input.infraConfig.terraformStateLockTableName}"
+            }
+      }
+      `;
+            const backendFile = path.join(input.pkgPath, 'hereya_terraform_backend.tf');
+            await fs.promises.writeFile(backendFile, backendConfig);
+        }
         try {
             await runShell(terraform, ['init'], {
                 directory: input.pkgPath,
@@ -177,11 +223,23 @@ export class Terraform {
         return true;
     }
     async getStateLocation(input) {
+        if (input.infraConfig?.localStatePath) {
+            return {
+                localPath: path.join(input.infraConfig.localStatePath, 'terraform.tfstate'),
+                success: true,
+            };
+        }
+        if (input.infraConfig?.terraformStateBucketName) {
+            return {
+                bucket: input.infraConfig.terraformStateBucketName,
+                key: `${input.id}/terraform.tfstate`,
+                region: input.infraConfig.terraformStateBucketRegion ?? '',
+                success: true,
+            };
+        }
         return {
-            bucket: input.infraConfig.terraformStateBucketName,
-            key: `${input.id}/terraform.tfstate`,
-            region: input.infraConfig.terraformStateBucketRegion ?? '',
-            success: true,
+            reason: 'No state location configuration provided',
+            success: false,
         };
     }
     async getEnv(pkgPath, logger) {

package/dist/infrastructure/aws.js

@@ -248,6 +248,9 @@ export class AwsInfrastructure {
         if (!stateLocation$.success) {
             return { reason: stateLocation$.reason, success: false };
         }
+        if (!('bucket' in stateLocation$)) {
+            return { reason: 'Expected S3 state location for AWS infrastructure', success: false };
+        }
         const { bucket, key } = stateLocation$;
         const s3Client = new S3Client({});
         await s3Client.send(new PutObjectCommand({

package/dist/infrastructure/local.js

@@ -1,4 +1,6 @@
 import * as fs from 'node:fs/promises';
+import os from 'node:os';
+import path from 'node:path';
 import { getIac } from '../iac/index.js';
 import { downloadPackage } from '../lib/package/index.js';
 import { getPackageDownloadPath, } from './common.js';
@@ -25,6 +27,9 @@ export class LocalInfrastructure {
         const output = await iac.destroy({
             env: input.env ?? {},
             id: input.id,
+            infraConfig: {
+                localStatePath: path.join(os.homedir(), '.hereya', 'tf', 'states', input.id),
+            },
             logger: input.logger,
             parameters: input.parameters,
             pkgPath: downloadPath,
@@ -47,6 +52,9 @@ export class LocalInfrastructure {
         const output = await iac.apply({
             env: input.env ?? {},
             id: input.id,
+            infraConfig: {
+                localStatePath: path.join(os.homedir(), '.hereya', 'tf', 'states', input.id),
+            },
             logger: input.logger,
             parameters: input.parameters,
             pkgPath: downloadPath,

package/dist/lib/package/index.js

@@ -145,7 +145,10 @@ async function resolveWithStandardManager(protocol, input, packageName, version)
             return { found: false, reason: 'Package has dependencies but is not a deploy package' };
         }
         if (input.isDeploying && metadata.onDeploy) {
-            return resolvePackage({ ...input, package: metadata.onDeploy.pkg });
+            const onDeployPackage = metadata.onDeploy.version
+                ? `${metadata.onDeploy.pkg}@${metadata.onDeploy.version}`
+                : metadata.onDeploy.pkg;
+            return resolvePackage({ ...input, package: onDeployPackage });
         }
         return {
             canonicalName: getPackageCanonicalName(packageName),
@@ -206,7 +209,10 @@ async function resolveCloudPackage(packageInfo, cloudManager, input) {
             return { found: false, reason: 'Package has dependencies but is not a deploy package' };
         }
         if (input.isDeploying && metadata.onDeploy) {
-            return resolvePackage({ ...input, package: metadata.onDeploy.pkg });
+            const onDeployPackage = metadata.onDeploy.version
+                ? `${metadata.onDeploy.pkg}@${metadata.onDeploy.version}`
+                : metadata.onDeploy.pkg;
+            return resolvePackage({ ...input, package: onDeployPackage });
         }
         // Build packageUri with repository and commit
         const packageUri = packageInfo.registryPackage.commit

package/oclif.manifest.json

@@ -193,6 +193,63 @@
         "index.js"
       ]
     },
+    "doc": {
+      "aliases": [],
+      "args": {
+        "package": {
+          "description": "Package name with optional version (e.g., my-package or my-package@1.0.0)",
+          "name": "package",
+          "required": true
+        }
+      },
+      "description": "Display documentation for a package from the registry",
+      "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"
+      ],
+      "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"
+        },
+        "no-doc": {
+          "description": "Show only metadata without the full documentation",
+          "name": "no-doc",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "doc",
+      "pluginAlias": "hereya-cli",
+      "pluginName": "hereya-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "doc",
+        "index.js"
+      ]
+    },
     "down": {
       "aliases": [],
       "args": {},
@@ -257,63 +314,6 @@
         "index.js"
       ]
     },
-    "doc": {
-      "aliases": [],
-      "args": {
-        "package": {
-          "description": "Package name with optional version (e.g., my-package or my-package@1.0.0)",
-          "name": "package",
-          "required": true
-        }
-      },
-      "description": "Display documentation for a package from the registry",
-      "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"
-      ],
-      "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"
-        },
-        "no-doc": {
-          "description": "Show only metadata without the full documentation",
-          "name": "no-doc",
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "doc",
-      "pluginAlias": "hereya-cli",
-      "pluginName": "hereya-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "doc",
-        "index.js"
-      ]
-    },
     "env": {
       "aliases": [],
       "args": {
@@ -564,6 +564,57 @@
         "index.js"
       ]
     },
+    "provid": {
+      "aliases": [],
+      "args": {
+        "package": {
+          "description": "Package name (e.g., hereya/postgres)",
+          "name": "package",
+          "required": true
+        }
+      },
+      "description": "Display the provisioning ID for a package",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> hereya/postgres",
+        "<%= config.bin %> <%= command.id %> hereya/postgres -w dev",
+        "<%= config.bin %> <%= command.id %> hereya/postgres --workspace staging"
+      ],
+      "flags": {
+        "chdir": {
+          "char": "C",
+          "description": "Project root directory",
+          "name": "chdir",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "workspace": {
+          "char": "w",
+          "description": "Name of the workspace",
+          "name": "workspace",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "provid",
+      "pluginAlias": "hereya-cli",
+      "pluginName": "hereya-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "provid",
+        "index.js"
+      ]
+    },
     "publish": {
       "aliases": [],
       "args": {},
@@ -1936,5 +1987,5 @@
       ]
     }
   },
-  "version": "0.60.0"
+  "version": "0.61.0"
 }

package/package.json

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