hereya-cli 0.6.3 → 0.7.0

package/README.md

@@ -20,7 +20,7 @@ $ npm install -g hereya-cli
 $ hereya COMMAND
 running command...
 $ hereya (--version)
-hereya-cli/0.6.3 linux-x64 node-v20.14.0
+hereya-cli/0.7.0 linux-x64 node-v20.14.0
 $ hereya --help [COMMAND]
 USAGE
   $ hereya COMMAND
@@ -33,12 +33,13 @@ USAGE
 * [`hereya bootstrap INFRASTRUCTURETYPE`](#hereya-bootstrap-infrastructuretype)
 * [`hereya deploy`](#hereya-deploy)
 * [`hereya down`](#hereya-down)
-* [`hereya env`](#hereya-env)
+* [`hereya env [NAME]`](#hereya-env-name)
 * [`hereya help [COMMAND]`](#hereya-help-command)
 * [`hereya init PROJECT`](#hereya-init-project)
 * [`hereya remote exec [PKGPATH]`](#hereya-remote-exec-pkgpath)
 * [`hereya remove PACKAGE`](#hereya-remove-package)
 * [`hereya run CMD`](#hereya-run-cmd)
+* [`hereya unbootstrap INFRASTRUCTURETYPE`](#hereya-unbootstrap-infrastructuretype)
 * [`hereya undeploy`](#hereya-undeploy)
 * [`hereya up`](#hereya-up)
 * [`hereya workspace create NAME`](#hereya-workspace-create-name)
@@ -70,7 +71,7 @@ EXAMPLES
   $ hereya add cloudy/docker_postgres
 ```
 
-_See code: [src/commands/add/index.ts](https://github.com/hereya/hereya-cli/blob/v0.6.3/src/commands/add/index.ts)_
+_See code: [src/commands/add/index.ts](https://github.com/hereya/hereya-cli/blob/v0.7.0/src/commands/add/index.ts)_
 
 ## `hereya bootstrap INFRASTRUCTURETYPE`
 
@@ -81,7 +82,7 @@ USAGE
   $ hereya bootstrap INFRASTRUCTURETYPE [-f]
 
 ARGUMENTS
-  INFRASTRUCTURETYPE  infrastructure to bootstrap. Options are local, aws, azure, gcp
+  INFRASTRUCTURETYPE  infrastructure to bootstrap. Options are local, aws
 
 FLAGS
   -f, --force  redeploy hereya resources if already deployed
@@ -95,7 +96,7 @@ EXAMPLES
   $ hereya bootstrap local
 ```
 
-_See code: [src/commands/bootstrap/index.ts](https://github.com/hereya/hereya-cli/blob/v0.6.3/src/commands/bootstrap/index.ts)_
+_See code: [src/commands/bootstrap/index.ts](https://github.com/hereya/hereya-cli/blob/v0.7.0/src/commands/bootstrap/index.ts)_
 
 ## `hereya deploy`
 
@@ -116,7 +117,7 @@ EXAMPLES
   $ hereya deploy
 ```
 
-_See code: [src/commands/deploy/index.ts](https://github.com/hereya/hereya-cli/blob/v0.6.3/src/commands/deploy/index.ts)_
+_See code: [src/commands/deploy/index.ts](https://github.com/hereya/hereya-cli/blob/v0.7.0/src/commands/deploy/index.ts)_
 
 ## `hereya down`
 
@@ -138,17 +139,21 @@ EXAMPLES
   $ hereya down
 ```
 
-_See code: [src/commands/down/index.ts](https://github.com/hereya/hereya-cli/blob/v0.6.3/src/commands/down/index.ts)_
+_See code: [src/commands/down/index.ts](https://github.com/hereya/hereya-cli/blob/v0.7.0/src/commands/down/index.ts)_
 
-## `hereya env`
+## `hereya env [NAME]`
 
 Print project environment variables.
 
 ```
 USAGE
-  $ hereya env [--chdir <value>] [-w <value>]
+  $ hereya env [NAME] [--chdir <value>] [-l] [-w <value>]
+
+ARGUMENTS
+  NAME  name of the env to display
 
 FLAGS
+  -l, --list               list only the env vars without values
   -w, --workspace=<value>  name of the workspace to print the env vars for
       --chdir=<value>      project root directory
 
@@ -158,10 +163,14 @@ DESCRIPTION
 EXAMPLES
   $ hereya env
 
+  $ hereya env myEnv
+
   $ hereya env -w dev
+
+  $ hereya env -w dev -l
 ```
 
-_See code: [src/commands/env/index.ts](https://github.com/hereya/hereya-cli/blob/v0.6.3/src/commands/env/index.ts)_
+_See code: [src/commands/env/index.ts](https://github.com/hereya/hereya-cli/blob/v0.7.0/src/commands/env/index.ts)_
 
 ## `hereya help [COMMAND]`
 
@@ -207,7 +216,7 @@ EXAMPLES
   $ hereya init myProject -w=defaultWorkspace --chdir=./myProject
 ```
 
-_See code: [src/commands/init/index.ts](https://github.com/hereya/hereya-cli/blob/v0.6.3/src/commands/init/index.ts)_
+_See code: [src/commands/init/index.ts](https://github.com/hereya/hereya-cli/blob/v0.7.0/src/commands/init/index.ts)_
 
 ## `hereya remote exec [PKGPATH]`
 
@@ -231,7 +240,7 @@ EXAMPLES
   $ hereya remote exec
 ```
 
-_See code: [src/commands/remote/exec/index.ts](https://github.com/hereya/hereya-cli/blob/v0.6.3/src/commands/remote/exec/index.ts)_
+_See code: [src/commands/remote/exec/index.ts](https://github.com/hereya/hereya-cli/blob/v0.7.0/src/commands/remote/exec/index.ts)_
 
 ## `hereya remove PACKAGE`
 
@@ -254,7 +263,7 @@ EXAMPLES
   $ hereya remove cloudy/docker_postgres
 ```
 
-_See code: [src/commands/remove/index.ts](https://github.com/hereya/hereya-cli/blob/v0.6.3/src/commands/remove/index.ts)_
+_See code: [src/commands/remove/index.ts](https://github.com/hereya/hereya-cli/blob/v0.7.0/src/commands/remove/index.ts)_
 
 ## `hereya run CMD`
 
@@ -280,7 +289,32 @@ EXAMPLES
   $ hereya run -w uat -- node index.js
 ```
 
-_See code: [src/commands/run/index.ts](https://github.com/hereya/hereya-cli/blob/v0.6.3/src/commands/run/index.ts)_
+_See code: [src/commands/run/index.ts](https://github.com/hereya/hereya-cli/blob/v0.7.0/src/commands/run/index.ts)_
+
+## `hereya unbootstrap INFRASTRUCTURETYPE`
+
+Uninstall hereya resources deployed with bootstrap command.
+
+```
+USAGE
+  $ hereya unbootstrap INFRASTRUCTURETYPE [-f]
+
+ARGUMENTS
+  INFRASTRUCTURETYPE  infrastructure to unbootstrap. Options are local, aws
+
+FLAGS
+  -f, --force  try to delete hereya resources even if not deployed
+
+DESCRIPTION
+  Uninstall hereya resources deployed with bootstrap command.
+
+EXAMPLES
+  $ hereya unbootstrap aws
+
+  $ hereya unbootstrap local
+```
+
+_See code: [src/commands/unbootstrap/index.ts](https://github.com/hereya/hereya-cli/blob/v0.7.0/src/commands/unbootstrap/index.ts)_
 
 ## `hereya undeploy`
 
@@ -301,7 +335,7 @@ EXAMPLES
   $ hereya undeploy
 ```
 
-_See code: [src/commands/undeploy/index.ts](https://github.com/hereya/hereya-cli/blob/v0.6.3/src/commands/undeploy/index.ts)_
+_See code: [src/commands/undeploy/index.ts](https://github.com/hereya/hereya-cli/blob/v0.7.0/src/commands/undeploy/index.ts)_
 
 ## `hereya up`
 
@@ -323,7 +357,7 @@ EXAMPLES
   $ hereya up
 ```
 
-_See code: [src/commands/up/index.ts](https://github.com/hereya/hereya-cli/blob/v0.6.3/src/commands/up/index.ts)_
+_See code: [src/commands/up/index.ts](https://github.com/hereya/hereya-cli/blob/v0.7.0/src/commands/up/index.ts)_
 
 ## `hereya workspace create NAME`
 
@@ -343,7 +377,7 @@ EXAMPLES
   $ hereya workspace create dev
 ```
 
-_See code: [src/commands/workspace/create/index.ts](https://github.com/hereya/hereya-cli/blob/v0.6.3/src/commands/workspace/create/index.ts)_
+_See code: [src/commands/workspace/create/index.ts](https://github.com/hereya/hereya-cli/blob/v0.7.0/src/commands/workspace/create/index.ts)_
 
 ## `hereya workspace delete NAME`
 
@@ -363,7 +397,7 @@ EXAMPLES
   $ hereya workspace delete dev
 ```
 
-_See code: [src/commands/workspace/delete/index.ts](https://github.com/hereya/hereya-cli/blob/v0.6.3/src/commands/workspace/delete/index.ts)_
+_See code: [src/commands/workspace/delete/index.ts](https://github.com/hereya/hereya-cli/blob/v0.7.0/src/commands/workspace/delete/index.ts)_
 
 ## `hereya workspace env [NAME]`
 
@@ -389,7 +423,7 @@ EXAMPLES
   $ hereya workspace env myEnv -w dev
 ```
 
-_See code: [src/commands/workspace/env/index.ts](https://github.com/hereya/hereya-cli/blob/v0.6.3/src/commands/workspace/env/index.ts)_
+_See code: [src/commands/workspace/env/index.ts](https://github.com/hereya/hereya-cli/blob/v0.7.0/src/commands/workspace/env/index.ts)_
 
 ## `hereya workspace install PACKAGE`
 
@@ -415,7 +449,7 @@ EXAMPLES
   $ hereya workspace install hereya/aws-cognito
 ```
 
-_See code: [src/commands/workspace/install/index.ts](https://github.com/hereya/hereya-cli/blob/v0.6.3/src/commands/workspace/install/index.ts)_
+_See code: [src/commands/workspace/install/index.ts](https://github.com/hereya/hereya-cli/blob/v0.7.0/src/commands/workspace/install/index.ts)_
 
 ## `hereya workspace uninstall PACKAGE`
 
@@ -441,5 +475,5 @@ EXAMPLES
   $ hereya workspace uninstall hereya/aws-cognito
 ```
 
-_See code: [src/commands/workspace/uninstall/index.ts](https://github.com/hereya/hereya-cli/blob/v0.6.3/src/commands/workspace/uninstall/index.ts)_
+_See code: [src/commands/workspace/uninstall/index.ts](https://github.com/hereya/hereya-cli/blob/v0.7.0/src/commands/workspace/uninstall/index.ts)_
 <!-- commandsstop -->

package/dist/commands/bootstrap/index.js

@@ -3,7 +3,7 @@ import { getInfrastructure } from '../../infrastructure/index.js';
 export default class Bootstrap extends Command {
     static args = {
         infrastructureType: Args.string({
-            description: 'infrastructure to bootstrap. Options are local, aws, azure, gcp',
+            description: 'infrastructure to bootstrap. Options are local, aws',
             required: true
         })
     };

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

@@ -1,9 +1,13 @@
 import { Command } from '@oclif/core';
 export default class Env extends Command {
+    static args: {
+        name: import("@oclif/core/lib/interfaces/parser.js").Arg<string | undefined, Record<string, unknown>>;
+    };
     static description: string;
     static examples: string[];
     static flags: {
         chdir: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        list: import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;
         workspace: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
     };
     run(): Promise<void>;

package/dist/commands/env/index.js

@@ -1,18 +1,28 @@
-import { Command, Flags } from '@oclif/core';
+import { Args, Command, Flags } from '@oclif/core';
 import { getConfigManager } from '../../lib/config/index.js';
 import { getEnvManager } from '../../lib/env/index.js';
 import { logEnv } from '../../lib/env-utils.js';
 export default class Env extends Command {
+    static args = {
+        name: Args.string({ description: 'name of the env to display', required: false }),
+    };
     static description = 'Print project environment variables.';
     static examples = [
         '<%= config.bin %> <%= command.id %>',
+        '<%= config.bin %> <%= command.id %> myEnv',
         '<%= config.bin %> <%= command.id %> -w dev',
+        '<%= config.bin %> <%= command.id %> -w dev -l',
     ];
     static flags = {
         chdir: Flags.string({
             description: 'project root directory',
             required: false,
         }),
+        list: Flags.boolean({
+            char: 'l',
+            description: 'list only the env vars without values',
+            required: false,
+        }),
         workspace: Flags.string({
             char: 'w',
             description: 'name of the workspace to print the env vars for',
@@ -20,7 +30,7 @@ export default class Env extends Command {
         }),
     };
     async run() {
-        const { flags } = await this.parse(Env);
+        const { args, flags } = await this.parse(Env);
         const projectRootDir = flags.chdir || process.env.HEREYA_PROJECT_ROOT_DIR;
         const configManager = getConfigManager();
         const loadConfigOutput = await configManager.loadConfig({ projectRootDir });
@@ -29,7 +39,7 @@ export default class Env extends Command {
             return;
         }
         const { config } = loadConfigOutput;
-        let { workspace } = flags;
+        let { list, workspace } = flags;
         if (!workspace) {
             workspace = config.workspace;
         }
@@ -41,6 +51,17 @@ export default class Env extends Command {
             projectRootDir,
             workspace,
         });
+        if (args.name) {
+            if (env[args.name] === undefined) {
+                this.error(`Env var ${args.name} not found`);
+            }
+            this.log(env[args.name]);
+            return;
+        }
+        if (list) {
+            this.log(Object.keys(env).join('\n'));
+            return;
+        }
         logEnv(env);
     }
 }

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

@@ -0,0 +1,12 @@
+import { Command } from '@oclif/core';
+export default class Unbootstrap extends Command {
+    static args: {
+        infrastructureType: import("@oclif/core/lib/interfaces/parser.js").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: string[];
+    static flags: {
+        force: import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/unbootstrap/index.js

@@ -0,0 +1,28 @@
+import { Args, Command, Flags } from '@oclif/core';
+import { getInfrastructure } from '../../infrastructure/index.js';
+export default class Unbootstrap extends Command {
+    static args = {
+        infrastructureType: Args.string({
+            description: 'infrastructure to unbootstrap. Options are local, aws',
+            required: true
+        })
+    };
+    static description = 'Uninstall hereya resources deployed with bootstrap command.';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> aws',
+        '<%= config.bin %> <%= command.id %> local',
+    ];
+    static flags = {
+        force: Flags.boolean({ char: 'f', description: 'try to delete hereya resources even if not deployed' }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(Unbootstrap);
+        const infrastructure$ = getInfrastructure({ type: args.infrastructureType });
+        if (!infrastructure$.supported) {
+            this.warn(infrastructure$.reason);
+            return;
+        }
+        const { infrastructure } = infrastructure$;
+        await infrastructure.unbootstrap({ force: flags.force });
+    }
+}

package/dist/infrastructure/aws.d.ts

@@ -6,6 +6,7 @@ export declare class AwsInfrastructure implements Infrastructure {
     provision(input: ProvisionInput): Promise<ProvisionOutput>;
     resolveEnv(input: ResolveEnvInput): Promise<ResolveEnvOutput>;
     saveEnv(input: SaveEnvInput): Promise<SaveEnvOutput>;
+    unbootstrap(_: BootstrapInput): Promise<void>;
     undeploy(input: UndeployInput): Promise<UndeployOutput>;
     private getEnv;
     private getFilesToUpload;

package/dist/infrastructure/aws.js

@@ -13,7 +13,7 @@ import { fileExists, getAnyPath } from '../lib/filesystem.js';
 import { objectToBase64 } from '../lib/object-utils.js';
 import { runShell } from '../lib/shell.js';
 import { InfrastructureType } from './common.js';
-import { provisionPackage } from './index.js';
+import { destroyPackage, provisionPackage } from './index.js';
 export class AwsInfrastructure {
     async bootstrap(_) {
         const stsClient = new STSClient({});
@@ -129,6 +129,23 @@ export class AwsInfrastructure {
             return { reason: error.message, success: false };
         }
     }
+    async unbootstrap(_) {
+        const ssmClient = new SSMClient({});
+        const key = '/hereya-bootstrap/config';
+        try {
+            await ssmClient.send(new DeleteParameterCommand({
+                Name: key,
+            }));
+        }
+        catch (error) {
+            console.log(`Could not delete parameter "${key}": ${error.message}. Continuing with unbootstrap...`);
+        }
+        const bootstrapPackage = 'hereya/bootstrap-aws-stack';
+        const output = await destroyPackage({ package: bootstrapPackage });
+        if (!output.success) {
+            throw new Error(output.reason);
+        }
+    }
     async undeploy(input) {
         let files = [];
         let s3Bucket = '';

package/dist/infrastructure/common.d.ts

@@ -12,6 +12,7 @@ export interface Infrastructure {
     provision(input: ProvisionInput): Promise<ProvisionOutput>;
     resolveEnv(input: ResolveEnvInput): Promise<ResolveEnvOutput>;
     saveEnv(input: SaveEnvInput): Promise<SaveEnvOutput>;
+    unbootstrap(input: BootstrapInput): Promise<void>;
     undeploy(input: UndeployInput): Promise<UndeployOutput>;
 }
 export type BootstrapInput = {

package/dist/infrastructure/local.d.ts

@@ -10,6 +10,7 @@ export declare class LocalInfrastructure implements Infrastructure {
         value: string;
     }>;
     saveEnv(input: SaveEnvInput): Promise<SaveEnvOutput>;
+    unbootstrap(): Promise<void>;
     undeploy(input: UndeployInput): Promise<UndeployOutput>;
     private download;
     private isNotEmpty;

package/dist/infrastructure/local.js

@@ -64,6 +64,9 @@ export class LocalInfrastructure {
         console.log(`Saving env to ${input.id}`);
         return { success: true };
     }
+    async unbootstrap() {
+        console.log('Unbootstrapping local infrastructure');
+    }
     async undeploy(input) {
         input.parameters = {
             ...input.parameters,

package/oclif.manifest.json

@@ -52,7 +52,7 @@
       "aliases": [],
       "args": {
         "infrastructureType": {
-          "description": "infrastructure to bootstrap. Options are local, aws, azure, gcp",
+          "description": "infrastructure to bootstrap. Options are local, aws",
           "name": "infrastructureType",
           "required": true
         }
@@ -180,11 +180,19 @@
     },
     "env": {
       "aliases": [],
-      "args": {},
+      "args": {
+        "name": {
+          "description": "name of the env to display",
+          "name": "name",
+          "required": false
+        }
+      },
       "description": "Print project environment variables.",
       "examples": [
         "<%= config.bin %> <%= command.id %>",
-        "<%= config.bin %> <%= command.id %> -w dev"
+        "<%= config.bin %> <%= command.id %> myEnv",
+        "<%= config.bin %> <%= command.id %> -w dev",
+        "<%= config.bin %> <%= command.id %> -w dev -l"
       ],
       "flags": {
         "chdir": {
@@ -195,6 +203,14 @@
           "multiple": false,
           "type": "option"
         },
+        "list": {
+          "char": "l",
+          "description": "list only the env vars without values",
+          "name": "list",
+          "required": false,
+          "allowNo": false,
+          "type": "boolean"
+        },
         "workspace": {
           "char": "w",
           "description": "name of the workspace to print the env vars for",
@@ -358,6 +374,45 @@
         "index.js"
       ]
     },
+    "unbootstrap": {
+      "aliases": [],
+      "args": {
+        "infrastructureType": {
+          "description": "infrastructure to unbootstrap. Options are local, aws",
+          "name": "infrastructureType",
+          "required": true
+        }
+      },
+      "description": "Uninstall hereya resources deployed with bootstrap command.",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> aws",
+        "<%= config.bin %> <%= command.id %> local"
+      ],
+      "flags": {
+        "force": {
+          "char": "f",
+          "description": "try to delete hereya resources even if not deployed",
+          "name": "force",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "unbootstrap",
+      "pluginAlias": "hereya-cli",
+      "pluginName": "hereya-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "unbootstrap",
+        "index.js"
+      ]
+    },
     "undeploy": {
       "aliases": [],
       "args": {},
@@ -728,5 +783,5 @@
       ]
     }
   },
-  "version": "0.6.3"
+  "version": "0.7.0"
 }

package/package.json

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