hereya-cli 0.100.5 → 0.100.6

package/dist/iac/terraform.js

@@ -4,7 +4,7 @@ import os from 'node:os';
 import path from 'node:path';
 import { pipeline } from 'node:stream/promises';
 import { Extract as decompress } from 'unzip-stream';
-import { mapObject } from '../lib/object-utils.js';
+import { mapObject, paramToEnvString } from '../lib/object-utils.js';
 import { runShell } from '../lib/shell.js';
 export class Terraform {
     async apply(input) {
@@ -46,12 +46,12 @@ export class Terraform {
                 env: {
                     ...mapObject(input.env ?? {}, (key, value) => [
                         `TF_VAR_${key}`,
-                        typeof value === 'object' ? JSON.stringify(value) : value,
+                        paramToEnvString(value),
                     ]),
                     ...input.env,
                     ...mapObject(input.parameters ?? {}, (key, value) => [
                         `TF_VAR_${key}`,
-                        typeof value === 'object' ? JSON.stringify(value) : value,
+                        paramToEnvString(value),
                     ]),
                 },
                 logger: input.logger,
@@ -61,12 +61,12 @@ export class Terraform {
                 env: {
                     ...mapObject(input.env ?? {}, (key, value) => [
                         `TF_VAR_${key}`,
-                        typeof value === 'object' ? JSON.stringify(value) : value,
+                        paramToEnvString(value),
                     ]),
                     ...input.env,
                     ...mapObject(input.parameters ?? {}, (key, value) => [
                         `TF_VAR_${key}`,
-                        typeof value === 'object' ? JSON.stringify(value) : value,
+                        paramToEnvString(value),
                     ]),
                 },
                 logger: input.logger,
@@ -124,12 +124,12 @@ export class Terraform {
                 env: {
                     ...mapObject(input.env ?? {}, (key, value) => [
                         `TF_VAR_${key}`,
-                        typeof value === 'object' ? JSON.stringify(value) : value,
+                        paramToEnvString(value),
                     ]),
                     ...input.env,
                     ...mapObject(input.parameters ?? {}, (key, value) => [
                         `TF_VAR_${key}`,
-                        typeof value === 'object' ? JSON.stringify(value) : value,
+                        paramToEnvString(value),
                     ]),
                 },
                 logger: input.logger,
@@ -140,12 +140,12 @@ export class Terraform {
                 env: {
                     ...mapObject(input.env ?? {}, (key, value) => [
                         `TF_VAR_${key}`,
-                        typeof value === 'object' ? JSON.stringify(value) : value,
+                        paramToEnvString(value),
                     ]),
                     ...input.env,
                     ...mapObject(input.parameters ?? {}, (key, value) => [
                         `TF_VAR_${key}`,
-                        typeof value === 'object' ? JSON.stringify(value) : value,
+                        paramToEnvString(value),
                     ]),
                 },
                 logger: input.logger,

package/dist/lib/object-utils.d.ts

@@ -1,4 +1,24 @@
 export declare function mapObject(obj: object, fn: (key: string, value: any) => [string, any]): object;
+/**
+ * Coerce a parameter value (as parsed from a hereyavars YAML file or
+ * forwarded through the executor) into the string form expected by the
+ * package's CDK/Terraform process when injected as an environment variable
+ * or CLI argument.
+ *
+ * - Strings (including pre-stringified JSON) pass through unchanged so the
+ *   existing "stringify it yourself" workaround keeps working.
+ * - Numbers and booleans become their plain string representation
+ *   (matching the previous behavior of `String(value)`).
+ * - Arrays and objects are JSON-encoded so the receiving package can
+ *   `JSON.parse(process.env.foo)` instead of receiving "[object Object]"
+ *   or a comma-joined `Array.prototype.toString()`.
+ * - `null` and `undefined` become an empty string.
+ *
+ * Intended to be applied at the single boundary where the env map for the
+ * package process is built — not earlier in the pipeline, so the parsed
+ * YAML can stay structured everywhere else in the CLI.
+ */
+export declare function paramToEnvString(value: unknown): string;
 export declare function arrayOfStringToObject(arr: string[], keyValueSeparator?: string): {
     [k: string]: string;
 };

package/dist/lib/object-utils.js

@@ -1,6 +1,36 @@
 export function mapObject(obj, fn) {
     return Object.fromEntries(Object.entries(obj).map(([key, value]) => fn(key, value)));
 }
+/**
+ * Coerce a parameter value (as parsed from a hereyavars YAML file or
+ * forwarded through the executor) into the string form expected by the
+ * package's CDK/Terraform process when injected as an environment variable
+ * or CLI argument.
+ *
+ * - Strings (including pre-stringified JSON) pass through unchanged so the
+ *   existing "stringify it yourself" workaround keeps working.
+ * - Numbers and booleans become their plain string representation
+ *   (matching the previous behavior of `String(value)`).
+ * - Arrays and objects are JSON-encoded so the receiving package can
+ *   `JSON.parse(process.env.foo)` instead of receiving "[object Object]"
+ *   or a comma-joined `Array.prototype.toString()`.
+ * - `null` and `undefined` become an empty string.
+ *
+ * Intended to be applied at the single boundary where the env map for the
+ * package process is built — not earlier in the pipeline, so the parsed
+ * YAML can stay structured everywhere else in the CLI.
+ */
+export function paramToEnvString(value) {
+    if (value === null || value === undefined)
+        return '';
+    if (typeof value === 'string')
+        return value;
+    if (typeof value === 'number' || typeof value === 'boolean') {
+        return String(value);
+    }
+    // Objects/arrays -> JSON. Round-trippable and what package authors expect.
+    return JSON.stringify(value);
+}
 export function arrayOfStringToObject(arr, keyValueSeparator = '=') {
     return Object.fromEntries(arr.map((item) => {
         const [key, value] = item.split(keyValueSeparator);