hereya-cli 0.84.0 → 0.85.0

package/dist/lib/package/index.js

@@ -75,6 +75,16 @@ export async function downloadPackage(pkgUrl, destPath) {
     return packageManager.downloadPackage(pkgUrl, destPath);
 }
 export const PackageKind = z.enum(['app', 'package']).default('package');
+export const PARAMETER_NAME_PATTERN = /^[A-Za-z][\w-]*$/;
+export const ParameterSpec = z
+    .object({
+    default: z.string().optional(),
+    description: z.string().optional(),
+    mandatory: z.boolean().default(false).optional(),
+})
+    .refine((p) => !(p.mandatory && p.default !== undefined), {
+    message: 'mandatory parameter cannot have a default',
+});
 export const PackageMetadata = z.object({
     dependencies: z.record(z.string()).optional(),
     deploy: z.boolean().optional(),
@@ -91,6 +101,16 @@ export const PackageMetadata = z.object({
         .optional(),
     originalInfra: z.nativeEnum(InfrastructureType).optional(),
     outputs: z.record(z.object({}).passthrough()).optional(),
+    parameters: z
+        .record(z.string(), ParameterSpec)
+        .optional()
+        .refine((params) => {
+        if (!params)
+            return true;
+        return Object.keys(params).every((name) => PARAMETER_NAME_PATTERN.test(name));
+    }, {
+        message: `parameter names must match ${PARAMETER_NAME_PATTERN.source}`,
+    }),
     snakeCase: z.boolean().optional(),
 });
 // Helper function to parse package spec into name and version

package/oclif.manifest.json

@@ -1198,8 +1198,7 @@
       "examples": [
         "<%= config.bin %> <%= command.id %> my-org/my-app -w my-workspace",
         "<%= config.bin %> <%= command.id %> my-org/my-app -w prod --version 1.2.0",
-        "<%= config.bin %> <%= command.id %> my-org/my-app -w prod -V 'app.yaml: \"key: value\"'",
-        "<%= config.bin %> <%= command.id %> my-org/my-app -w prod --vars-file ./hereyavars.yaml"
+        "<%= config.bin %> <%= command.id %> my-org/my-app -w prod -p organizationId=org-123"
       ],
       "flags": {
         "parameter": {
@@ -1211,27 +1210,6 @@
           "multiple": true,
           "type": "option"
         },
-        "vars": {
-          "char": "V",
-          "description": "YAML string mapping hereyavars filename -> YAML body (mutually exclusive with --vars-file)",
-          "exclusive": [
-            "vars-file"
-          ],
-          "name": "vars",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "vars-file": {
-          "description": "path to a YAML file mapping hereyavars filename -> YAML body (mutually exclusive with --vars)",
-          "exclusive": [
-            "vars"
-          ],
-          "name": "vars-file",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
         "version": {
           "description": "specific app version to deploy (defaults to latest)",
           "name": "version",
@@ -1501,17 +1479,24 @@
         "index.js"
       ]
     },
-    "config:get-backend": {
+    "config:export-backend": {
       "aliases": [],
-      "args": {},
-      "description": "get the current backend type",
+      "args": {
+        "file": {
+          "description": "Path to save the export file. Defaults to cloud-backend.json in current directory",
+          "name": "file",
+          "required": false
+        }
+      },
+      "description": "Export the cloud backend configuration to a file",
       "examples": [
-        "<%= config.bin %> <%= command.id %>"
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> ./path/to/export.json"
       ],
       "flags": {},
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "config:get-backend",
+      "id": "config:export-backend",
       "pluginAlias": "hereya-cli",
       "pluginName": "hereya-cli",
       "pluginType": "core",
@@ -1522,28 +1507,21 @@
         "dist",
         "commands",
         "config",
-        "get-backend",
+        "export-backend",
         "index.js"
       ]
     },
-    "config:export-backend": {
+    "config:get-backend": {
       "aliases": [],
-      "args": {
-        "file": {
-          "description": "Path to save the export file. Defaults to cloud-backend.json in current directory",
-          "name": "file",
-          "required": false
-        }
-      },
-      "description": "Export the cloud backend configuration to a file",
+      "args": {},
+      "description": "get the current backend type",
       "examples": [
-        "<%= config.bin %> <%= command.id %>",
-        "<%= config.bin %> <%= command.id %> ./path/to/export.json"
+        "<%= config.bin %> <%= command.id %>"
       ],
       "flags": {},
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "config:export-backend",
+      "id": "config:get-backend",
       "pluginAlias": "hereya-cli",
       "pluginName": "hereya-cli",
       "pluginType": "core",
@@ -1554,7 +1532,7 @@
         "dist",
         "commands",
         "config",
-        "export-backend",
+        "get-backend",
         "index.js"
       ]
     },
@@ -2702,46 +2680,60 @@
         "index.js"
       ]
     },
-    "workspace:uninstall": {
+    "devenv:project:init": {
       "aliases": [],
       "args": {
-        "package": {
-          "description": "The package to remove. Packages are gitHub repositories. Use the format owner/repository",
-          "name": "package",
+        "project": {
+          "description": "project name",
+          "name": "project",
           "required": true
         }
       },
-      "description": "Remove a package from a workspace.",
+      "description": "Initialize a project on a remote dev environment.",
       "examples": [
-        "<%= config.bin %> <%= command.id %> hereya/aws-cognito"
+        "<%= config.bin %> <%= command.id %> my-app -w my-workspace",
+        "<%= config.bin %> <%= command.id %> my-app -w my-workspace -t acme/node-starter",
+        "<%= config.bin %> <%= command.id %> my-app -w my-workspace -t acme/node-starter -p region=us-east-1"
       ],
       "flags": {
-        "debug": {
-          "description": "enable debug mode",
-          "name": "debug",
+        "deploy-workspace": {
+          "char": "d",
+          "description": "workspace used for deployment (required when using a template)",
+          "name": "deploy-workspace",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "force": {
+          "char": "f",
+          "description": "continue even if folder already exists",
+          "name": "force",
           "allowNo": false,
           "type": "boolean"
         },
         "parameter": {
           "char": "p",
-          "description": "parameter for the package, in the form of 'key=value'. Can be specified multiple times.",
+          "description": "parameter for the template, in the form of 'key=value'. Can be specified multiple times.",
           "name": "parameter",
+          "required": false,
           "default": [],
           "hasDynamicHelp": false,
           "multiple": true,
           "type": "option"
         },
-        "parameter-file": {
-          "char": "f",
-          "description": "path to a file containing parameters for the package",
-          "name": "parameter-file",
+        "template": {
+          "char": "t",
+          "description": "template package to scaffold the project from",
+          "name": "template",
+          "required": false,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
         "workspace": {
           "char": "w",
-          "description": "name of the workspace to remove the package from",
+          "description": "name of the workspace",
           "name": "workspace",
           "required": true,
           "hasDynamicHelp": false,
@@ -2751,7 +2743,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "workspace:uninstall",
+      "id": "devenv:project:init",
       "pluginAlias": "hereya-cli",
       "pluginName": "hereya-cli",
       "pluginType": "core",
@@ -2761,65 +2753,52 @@
       "relativePath": [
         "dist",
         "commands",
-        "workspace",
-        "uninstall",
+        "devenv",
+        "project",
+        "init",
         "index.js"
       ]
     },
-    "devenv:project:init": {
+    "workspace:uninstall": {
       "aliases": [],
       "args": {
-        "project": {
-          "description": "project name",
-          "name": "project",
+        "package": {
+          "description": "The package to remove. Packages are gitHub repositories. Use the format owner/repository",
+          "name": "package",
           "required": true
         }
       },
-      "description": "Initialize a project on a remote dev environment.",
+      "description": "Remove a package from a workspace.",
       "examples": [
-        "<%= config.bin %> <%= command.id %> my-app -w my-workspace",
-        "<%= config.bin %> <%= command.id %> my-app -w my-workspace -t acme/node-starter",
-        "<%= config.bin %> <%= command.id %> my-app -w my-workspace -t acme/node-starter -p region=us-east-1"
+        "<%= config.bin %> <%= command.id %> hereya/aws-cognito"
       ],
       "flags": {
-        "deploy-workspace": {
-          "char": "d",
-          "description": "workspace used for deployment (required when using a template)",
-          "name": "deploy-workspace",
-          "required": false,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "force": {
-          "char": "f",
-          "description": "continue even if folder already exists",
-          "name": "force",
+        "debug": {
+          "description": "enable debug mode",
+          "name": "debug",
           "allowNo": false,
           "type": "boolean"
         },
         "parameter": {
           "char": "p",
-          "description": "parameter for the template, in the form of 'key=value'. Can be specified multiple times.",
+          "description": "parameter for the package, in the form of 'key=value'. Can be specified multiple times.",
           "name": "parameter",
-          "required": false,
           "default": [],
           "hasDynamicHelp": false,
           "multiple": true,
           "type": "option"
         },
-        "template": {
-          "char": "t",
-          "description": "template package to scaffold the project from",
-          "name": "template",
-          "required": false,
+        "parameter-file": {
+          "char": "f",
+          "description": "path to a file containing parameters for the package",
+          "name": "parameter-file",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
         "workspace": {
           "char": "w",
-          "description": "name of the workspace",
+          "description": "name of the workspace to remove the package from",
           "name": "workspace",
           "required": true,
           "hasDynamicHelp": false,
@@ -2829,7 +2808,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "devenv:project:init",
+      "id": "workspace:uninstall",
       "pluginAlias": "hereya-cli",
       "pluginName": "hereya-cli",
       "pluginType": "core",
@@ -2839,9 +2818,8 @@
       "relativePath": [
         "dist",
         "commands",
-        "devenv",
-        "project",
-        "init",
+        "workspace",
+        "uninstall",
         "index.js"
       ]
     },
@@ -2963,51 +2941,26 @@
         "index.js"
       ]
     },
-    "workspace:env:set": {
+    "workspace:env:unset": {
       "aliases": [],
       "args": {},
-      "description": "set an env var for a workspace",
+      "description": "unset an env var for a workspace",
       "examples": [
-        "<%= config.bin %> <%= command.id %> -w my-workspace -n myVar -v my-value -i aws -s"
+        "<%= config.bin %> <%= command.id %> -w my-workspace -n myVar"
       ],
       "flags": {
-        "infra": {
-          "char": "i",
-          "description": "the infrastructure to store the env var in",
-          "name": "infra",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
         "name": {
           "char": "n",
-          "description": "name of the env var to set",
+          "description": "name of the env var to unset",
           "name": "name",
           "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "sensitive": {
-          "char": "s",
-          "description": "whether the env var is sensitive",
-          "name": "sensitive",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "value": {
-          "char": "v",
-          "description": "value of the env var to set",
-          "name": "value",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
         "workspace": {
           "char": "w",
-          "description": "name of the workspace to set an env var for",
+          "description": "name of the workspace to unset an env var for",
           "name": "workspace",
           "required": true,
           "hasDynamicHelp": false,
@@ -3017,7 +2970,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "workspace:env:set",
+      "id": "workspace:env:unset",
       "pluginAlias": "hereya-cli",
       "pluginName": "hereya-cli",
       "pluginType": "core",
@@ -3029,30 +2982,55 @@
         "commands",
         "workspace",
         "env",
-        "set",
+        "unset",
         "index.js"
       ]
     },
-    "workspace:env:unset": {
+    "workspace:env:set": {
       "aliases": [],
       "args": {},
-      "description": "unset an env var for a workspace",
+      "description": "set an env var for a workspace",
       "examples": [
-        "<%= config.bin %> <%= command.id %> -w my-workspace -n myVar"
+        "<%= config.bin %> <%= command.id %> -w my-workspace -n myVar -v my-value -i aws -s"
       ],
       "flags": {
+        "infra": {
+          "char": "i",
+          "description": "the infrastructure to store the env var in",
+          "name": "infra",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
         "name": {
           "char": "n",
-          "description": "name of the env var to unset",
+          "description": "name of the env var to set",
           "name": "name",
           "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
+        "sensitive": {
+          "char": "s",
+          "description": "whether the env var is sensitive",
+          "name": "sensitive",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "value": {
+          "char": "v",
+          "description": "value of the env var to set",
+          "name": "value",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
         "workspace": {
           "char": "w",
-          "description": "name of the workspace to unset an env var for",
+          "description": "name of the workspace to set an env var for",
           "name": "workspace",
           "required": true,
           "hasDynamicHelp": false,
@@ -3062,7 +3040,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "workspace:env:unset",
+      "id": "workspace:env:set",
       "pluginAlias": "hereya-cli",
       "pluginName": "hereya-cli",
       "pluginType": "core",
@@ -3074,7 +3052,7 @@
         "commands",
         "workspace",
         "env",
-        "unset",
+        "set",
         "index.js"
       ]
     },
@@ -3197,5 +3175,5 @@
       ]
     }
   },
-  "version": "0.84.0"
+  "version": "0.85.0"
 }

package/package.json

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

package/dist/lib/app-vars.d.ts

@@ -1,10 +0,0 @@
-/**
- * Write per-deployment hereyavars overrides into <appRootDir>/hereyaconfig/hereyavars/.
- *
- * `hereyaVarsYaml` is a YAML string mapping filename -> YAML body (string).
- * Each filename is validated against a safe pattern (no path traversal, must
- * end in `.yaml`/`.yml`). Each body must be a string.
- */
-export declare function applyHereyaVars(appRootDir: string, hereyaVarsYaml: string | undefined): Promise<{
-    filesWritten: string[];
-}>;

package/dist/lib/app-vars.js

@@ -1,45 +0,0 @@
-import fs from 'node:fs/promises';
-import path from 'node:path';
-import * as yaml from 'yaml';
-const HEREYAVARS_FILENAME_PATTERN = /^[\w.-]+\.ya?ml$/;
-/**
- * Write per-deployment hereyavars overrides into <appRootDir>/hereyaconfig/hereyavars/.
- *
- * `hereyaVarsYaml` is a YAML string mapping filename -> YAML body (string).
- * Each filename is validated against a safe pattern (no path traversal, must
- * end in `.yaml`/`.yml`). Each body must be a string.
- */
-export async function applyHereyaVars(appRootDir, hereyaVarsYaml) {
-    if (!hereyaVarsYaml || hereyaVarsYaml.trim() === '') {
-        return { filesWritten: [] };
-    }
-    let parsed;
-    try {
-        parsed = yaml.parse(hereyaVarsYaml);
-    }
-    catch (error) {
-        throw new Error(`Failed to parse hereyaVarsYaml: ${error.message}`);
-    }
-    if (parsed === null || parsed === undefined) {
-        return { filesWritten: [] };
-    }
-    if (typeof parsed !== 'object' || Array.isArray(parsed)) {
-        throw new TypeError('hereyaVarsYaml must be a YAML mapping of filename -> body string');
-    }
-    const targetDir = path.join(appRootDir, 'hereyaconfig', 'hereyavars');
-    await fs.mkdir(targetDir, { recursive: true });
-    const filesWritten = [];
-    for (const [filename, body] of Object.entries(parsed)) {
-        if (!HEREYAVARS_FILENAME_PATTERN.test(filename)) {
-            throw new Error(`Invalid hereyavars filename '${filename}'. Expected a name matching ${HEREYAVARS_FILENAME_PATTERN.source}`);
-        }
-        if (typeof body !== 'string') {
-            throw new TypeError(`hereyavars value for '${filename}' must be a string (YAML body)`);
-        }
-        const filePath = path.join(targetDir, filename);
-        // eslint-disable-next-line no-await-in-loop
-        await fs.writeFile(filePath, body, { encoding: 'utf8' });
-        filesWritten.push(filePath);
-    }
-    return { filesWritten };
-}