@desplega.ai/qa-use 2.15.3 → 2.16.0

package/dist/src/cli/commands/test/vars/index.js

@@ -0,0 +1,16 @@
+/**
+ * qa-use test vars - Manage typed variables on a test.
+ *
+ * Subgroup nested under `qa-use test`. Local YAML files are the primary
+ * surface; `--id <uuid>` falls back to read-modify-write against the backend
+ * via `client.exportTest` + `client.importTestDefinition`.
+ */
+import { Command } from 'commander';
+import { listCommand } from './list.js';
+import { setCommand } from './set.js';
+import { unsetCommand } from './unset.js';
+export const varsCommand = new Command('vars').description('Manage typed variables on a test (list/set/unset)');
+varsCommand.addCommand(listCommand);
+varsCommand.addCommand(setCommand);
+varsCommand.addCommand(unsetCommand);
+//# sourceMappingURL=index.js.map

package/dist/src/cli/commands/test/vars/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../src/cli/commands/test/vars/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC,WAAW,CACxD,mDAAmD,CACpD,CAAC;AAEF,WAAW,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;AACpC,WAAW,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;AACnC,WAAW,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC"}

package/dist/src/cli/commands/test/vars/list.d.ts

@@ -0,0 +1,10 @@
+/**
+ * qa-use test vars list - List typed variables on a test.
+ *
+ * Local-file path (`<file>` positional) is the primary surface; `--id <uuid>`
+ * exports the YAML from the backend in-memory and runs the same rendering
+ * path. Mutual exclusion is enforced via `resolveVarsTarget`.
+ */
+import { Command } from 'commander';
+export declare const listCommand: Command;
+//# sourceMappingURL=list.d.ts.map

package/dist/src/cli/commands/test/vars/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../../../../src/cli/commands/test/vars/list.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAkEpC,eAAO,MAAM,WAAW,SAiDpB,CAAC"}

package/dist/src/cli/commands/test/vars/list.js

@@ -0,0 +1,96 @@
+/**
+ * qa-use test vars list - List typed variables on a test.
+ *
+ * Local-file path (`<file>` positional) is the primary surface; `--id <uuid>`
+ * exports the YAML from the backend in-memory and runs the same rendering
+ * path. Mutual exclusion is enforced via `resolveVarsTarget`.
+ */
+import { Command } from 'commander';
+import * as yaml from 'yaml';
+import { createApiClient, loadConfig } from '../../../lib/config.js';
+import { error, formatError } from '../../../lib/output.js';
+import { printTable } from '../../../lib/table.js';
+import { getNormalizedEntry, maskValue, readVarsFromYamlFile, resolveVarsTarget, } from '../../../lib/test-vars.js';
+function buildRow(key, raw) {
+    const entry = getNormalizedEntry(raw);
+    return {
+        key,
+        type: entry.type ?? 'custom',
+        lifetime: entry.lifetime ?? 'test',
+        context: entry.context ?? 'test',
+        is_sensitive: entry.is_sensitive ?? false,
+        value: maskValue(raw),
+        rawValue: entry.value ?? undefined,
+    };
+}
+function rowsFromVariables(vars) {
+    return Object.entries(vars).map(([k, v]) => buildRow(k, v));
+}
+/**
+ * Build the JSON payload emitted by `--json`.
+ * Sensitive entries omit the `value` key entirely so consumers rely on
+ * `is_sensitive: true` as the redaction signal.
+ */
+function rowsForJson(rows) {
+    return rows.map((row) => {
+        const out = {
+            key: row.key,
+            type: row.type,
+            lifetime: row.lifetime,
+            context: row.context,
+            is_sensitive: row.is_sensitive,
+        };
+        if (!row.is_sensitive && row.rawValue !== undefined) {
+            out.value = row.rawValue;
+        }
+        return out;
+    });
+}
+export const listCommand = new Command('list')
+    .description('List typed variables on a test (local YAML file or remote --id)')
+    .argument('[file]', 'Path to a local test YAML file')
+    .option('--id <uuid>', 'Remote test UUID — exports YAML and lists from there')
+    .option('--json', 'Output as JSON (sensitive values redacted)')
+    .action(async (file, options) => {
+    try {
+        const target = resolveVarsTarget({ file, id: options.id });
+        let vars;
+        if (target.kind === 'file') {
+            ({ vars } = await readVarsFromYamlFile(target.path));
+        }
+        else {
+            const config = await loadConfig();
+            const client = createApiClient(config);
+            const yamlText = await client.exportTest(target.uuid, 'yaml', false);
+            const def = yaml.parse(yamlText);
+            vars = def?.variables ?? {};
+        }
+        const rows = rowsFromVariables(vars);
+        if (options.json) {
+            console.log(JSON.stringify(rowsForJson(rows), null, 2));
+            return;
+        }
+        const columns = [
+            { key: 'key', header: 'KEY' },
+            { key: 'type', header: 'TYPE' },
+            { key: 'lifetime', header: 'LIFETIME' },
+            { key: 'context', header: 'CONTEXT' },
+            {
+                key: 'is_sensitive',
+                header: 'SENSITIVE',
+                format: (v) => (v ? 'yes' : 'no'),
+            },
+            { key: 'value', header: 'VALUE' },
+        ];
+        printTable(columns, rows, {
+            emptyMessage: target.kind === 'file'
+                ? `No variables defined in ${target.path}`
+                : `No variables on test ${target.uuid}`,
+        });
+    }
+    catch (err) {
+        console.log(error(`Failed to list variables: ${formatError(err)}`));
+        process.exit(1);
+    }
+});
+//# sourceMappingURL=list.js.map

package/dist/src/cli/commands/test/vars/list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../../../../src/cli/commands/test/vars/list.ts"],"names":[],"mappings":"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"}

package/dist/src/cli/commands/test/vars/set.d.ts

@@ -0,0 +1,31 @@
+/**
+ * qa-use test vars set - Set a typed variable on a test.
+ *
+ * Local-file path: mutates `<file>` in place via yaml's Document API so
+ * comments and key order survive a round-trip.
+ *
+ * Remote `--id` path: exports YAML, parses to a `TestDefinition`, mutates
+ * the parsed object directly, and re-imports via `client.importTestDefinition`.
+ * Comment/key-order preservation is meaningless across export → import — the
+ * server normalizes formatting — so the Document API path is **not** used
+ * remotely on purpose.
+ *
+ * Validation:
+ *   --type / --lifetime / --context must match the runtime arrays in
+ *   src/cli/lib/test-vars.ts (which mirror the auto-generated unions).
+ *
+ * Mutation rules (apply identically to both paths):
+ *   - --key + --value only            → simple form (`key: value`)
+ *   - any of --type/--lifetime/...    → full form ({value, type, ...})
+ *   - existing full form stays full form even if only --value is passed
+ *
+ * Sensitive-preserve:
+ *   - Existing sensitive var, `--sensitive` without `--value` → keep value.
+ *     Locally we read from the file. Remotely we rely on cope's import-merge
+ *     rule which keeps the stored DB value when is_sensitive=true and no
+ *     value is supplied.
+ *   - New key with `--sensitive` and no `--value` → exit 1.
+ */
+import { Command } from 'commander';
+export declare const setCommand: Command;
+//# sourceMappingURL=set.d.ts.map

package/dist/src/cli/commands/test/vars/set.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"set.d.ts","sourceRoot":"","sources":["../../../../../../src/cli/commands/test/vars/set.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAgNpC,eAAO,MAAM,UAAU,SA0EnB,CAAC"}

package/dist/src/cli/commands/test/vars/set.js

@@ -0,0 +1,249 @@
+/**
+ * qa-use test vars set - Set a typed variable on a test.
+ *
+ * Local-file path: mutates `<file>` in place via yaml's Document API so
+ * comments and key order survive a round-trip.
+ *
+ * Remote `--id` path: exports YAML, parses to a `TestDefinition`, mutates
+ * the parsed object directly, and re-imports via `client.importTestDefinition`.
+ * Comment/key-order preservation is meaningless across export → import — the
+ * server normalizes formatting — so the Document API path is **not** used
+ * remotely on purpose.
+ *
+ * Validation:
+ *   --type / --lifetime / --context must match the runtime arrays in
+ *   src/cli/lib/test-vars.ts (which mirror the auto-generated unions).
+ *
+ * Mutation rules (apply identically to both paths):
+ *   - --key + --value only            → simple form (`key: value`)
+ *   - any of --type/--lifetime/...    → full form ({value, type, ...})
+ *   - existing full form stays full form even if only --value is passed
+ *
+ * Sensitive-preserve:
+ *   - Existing sensitive var, `--sensitive` without `--value` → keep value.
+ *     Locally we read from the file. Remotely we rely on cope's import-merge
+ *     rule which keeps the stored DB value when is_sensitive=true and no
+ *     value is supplied.
+ *   - New key with `--sensitive` and no `--value` → exit 1.
+ */
+import { Command } from 'commander';
+import * as yaml from 'yaml';
+import { createApiClient, loadConfig } from '../../../lib/config.js';
+import { error, formatError, success } from '../../../lib/output.js';
+import { readVarsFromYamlFile, resolveVarsTarget, TEST_VARIABLE_CONTEXTS, TEST_VARIABLE_LIFETIMES, TEST_VARIABLE_TYPES, verifySetMutation, writeYamlFile, } from '../../../lib/test-vars.js';
+function fail(msg) {
+    console.log(error(msg));
+    process.exit(1);
+}
+function validateEnum(flag, value, allowed) {
+    if (value === undefined)
+        return;
+    if (!allowed.includes(value)) {
+        fail(`invalid value for --${flag}: '${value}'; allowed: ${allowed.join(', ')}`);
+    }
+}
+/**
+ * Determine whether the requested mutation requires the full-form shape.
+ * Any non-value flag → full form; otherwise simple form is fine for new
+ * entries (existing full-form entries always stay full form).
+ */
+function requiresFullForm(opts) {
+    return Boolean(opts.type || opts.lifetime || opts.context || opts.sensitive);
+}
+/**
+ * Coerce a CLI string argument to its likely scalar shape: integer/float when
+ * parseable, otherwise the original string. Mirrors how cope's YAML loader
+ * round-trips numeric values without quoting.
+ */
+function coerceScalar(s) {
+    if (s === '')
+        return s;
+    if (/^-?\d+$/.test(s)) {
+        const n = Number.parseInt(s, 10);
+        if (Number.isSafeInteger(n))
+            return n;
+    }
+    if (/^-?\d+\.\d+$/.test(s)) {
+        const n = Number.parseFloat(s);
+        if (Number.isFinite(n))
+            return n;
+    }
+    return s;
+}
+/**
+ * Apply common precondition checks (sensitive-without-value rules).
+ * Throws via `fail` on violation; returns the resolved sensitive-preserve flag.
+ */
+function checkSensitivePreconditions(options, existing) {
+    const sensitivePreserve = options.sensitive === true &&
+        options.value === undefined &&
+        existing.isFull &&
+        existing.full?.is_sensitive === true;
+    if (options.sensitive === true && options.value === undefined && !sensitivePreserve) {
+        fail(`cannot set --sensitive without --value on ${existing.raw === undefined ? 'a new key' : 'a non-sensitive key'}: '${options.key}'`);
+    }
+    return sensitivePreserve;
+}
+/**
+ * Apply the mutation to a parsed `Variables` object (used on the remote path
+ * and for in-memory mutations during tests). Returns the updated map.
+ */
+function applyMutationToObject(vars, options) {
+    const key = options.key;
+    const existingRaw = vars[key];
+    const existsAsFull = existingRaw !== undefined && typeof existingRaw === 'object' && existingRaw !== null;
+    const existing = {
+        raw: existingRaw,
+        isFull: existsAsFull,
+        isSimple: !existsAsFull && existingRaw !== undefined && existingRaw !== null,
+        full: existsAsFull ? existingRaw : undefined,
+    };
+    checkSensitivePreconditions(options, existing);
+    const upgradeToFull = requiresFullForm(options) || existsAsFull;
+    if (!upgradeToFull) {
+        if (options.value === undefined) {
+            fail('--value is required when no other flags are passed');
+        }
+        vars[key] = coerceScalar(options.value);
+        return vars;
+    }
+    if (!existsAsFull) {
+        const seed = {
+            value: options.value !== undefined
+                ? coerceScalar(options.value)
+                : existing.isSimple
+                    ? existingRaw
+                    : '',
+            type: options.type ?? 'custom',
+            lifetime: options.lifetime ?? 'test',
+            context: options.context ?? 'test',
+            is_sensitive: options.sensitive === true,
+        };
+        vars[key] = seed;
+        return vars;
+    }
+    const merged = { ...existingRaw };
+    if (options.value !== undefined)
+        merged.value = coerceScalar(options.value);
+    if (options.type !== undefined)
+        merged.type = options.type;
+    if (options.lifetime !== undefined)
+        merged.lifetime = options.lifetime;
+    if (options.context !== undefined)
+        merged.context = options.context;
+    if (options.sensitive === true)
+        merged.is_sensitive = true;
+    vars[key] = merged;
+    return vars;
+}
+/**
+ * Apply the mutation via the yaml.Document API so comments and key ordering
+ * survive a write back to disk.
+ */
+function applyMutationToDocument(doc, options) {
+    const key = options.key;
+    const existingRaw = doc.getIn(['variables', key]);
+    const existsAsFull = yaml.isMap(existingRaw);
+    const existing = {
+        raw: existingRaw,
+        isFull: existsAsFull,
+        isSimple: !existsAsFull && existingRaw !== undefined && existingRaw !== null,
+        full: existsAsFull ? existingRaw.toJSON() : undefined,
+    };
+    checkSensitivePreconditions(options, existing);
+    const upgradeToFull = requiresFullForm(options) || existsAsFull;
+    if (!doc.hasIn(['variables'])) {
+        doc.setIn(['variables'], doc.createNode({}));
+    }
+    if (!upgradeToFull) {
+        if (options.value === undefined) {
+            fail('--value is required when no other flags are passed');
+        }
+        doc.setIn(['variables', key], coerceScalar(options.value));
+        return;
+    }
+    if (!existsAsFull) {
+        const seed = {
+            value: options.value !== undefined
+                ? coerceScalar(options.value)
+                : existing.isSimple
+                    ? existingRaw
+                    : '',
+            type: options.type ?? 'custom',
+            lifetime: options.lifetime ?? 'test',
+            context: options.context ?? 'test',
+            is_sensitive: options.sensitive === true,
+        };
+        doc.setIn(['variables', key], doc.createNode(seed));
+        return;
+    }
+    const path = ['variables', key];
+    if (options.value !== undefined)
+        doc.setIn([...path, 'value'], coerceScalar(options.value));
+    if (options.type !== undefined)
+        doc.setIn([...path, 'type'], options.type);
+    if (options.lifetime !== undefined)
+        doc.setIn([...path, 'lifetime'], options.lifetime);
+    if (options.context !== undefined)
+        doc.setIn([...path, 'context'], options.context);
+    if (options.sensitive === true)
+        doc.setIn([...path, 'is_sensitive'], true);
+}
+export const setCommand = new Command('set')
+    .description('Set (create or update) a typed variable on a test (local YAML or remote --id)')
+    .argument('[file]', 'Path to a local test YAML file')
+    .option('--id <uuid>', 'Remote test UUID — exports YAML, mutates, re-imports')
+    .requiredOption('--key <key>', 'Variable name')
+    .option('--value <value>', 'Variable value')
+    .option(`--type <type>`, `Variable type (one of: ${TEST_VARIABLE_TYPES.join(', ')})`)
+    .option('--lifetime <lifetime>', `Variable lifetime (one of: ${TEST_VARIABLE_LIFETIMES.join(', ')})`)
+    .option('--context <context>', `Variable context (one of: ${TEST_VARIABLE_CONTEXTS.join(', ')})`)
+    .option('--sensitive', 'Mark the variable as sensitive (masked in list output)')
+    .action(async (file, options) => {
+    try {
+        const target = resolveVarsTarget({ file, id: options.id });
+        if (!options.key)
+            fail('--key is required');
+        validateEnum('type', options.type, TEST_VARIABLE_TYPES);
+        validateEnum('lifetime', options.lifetime, TEST_VARIABLE_LIFETIMES);
+        validateEnum('context', options.context, TEST_VARIABLE_CONTEXTS);
+        if (target.kind === 'file') {
+            const { doc } = await readVarsFromYamlFile(target.path);
+            applyMutationToDocument(doc, options);
+            await writeYamlFile(target.path, doc);
+            console.log(success(`Set variable '${options.key}' in ${target.path}`));
+            return;
+        }
+        // Remote --id path: read-modify-write via export → import.
+        const config = await loadConfig();
+        const client = createApiClient(config);
+        const yamlText = await client.exportTest(target.uuid, 'yaml', false);
+        const def = yaml.parse(yamlText) ?? {};
+        def.variables = applyMutationToObject(def.variables ?? {}, options);
+        const expectedEntry = def.variables[options.key];
+        const result = await client.importTestDefinition([def]);
+        if (result?.success === false) {
+            fail(`import failed: ${JSON.stringify(result)}`);
+        }
+        const action = result?.imported?.[0]?.action;
+        if (action === 'conflict') {
+            const message = result?.imported?.[0]?.message;
+            fail(`import returned conflict for test ${target.uuid}${message ? `: ${message}` : ''} — variable '${options.key}' was not updated`);
+        }
+        // Re-export and verify the mutation took effect. `ImportResult.success`
+        // can be `true` while `action` is `unchanged`/`conflict`, so a green
+        // import response is not enough — we must observe the change server-side.
+        const reExportText = await client.exportTest(target.uuid, 'yaml', false);
+        const reExportDef = yaml.parse(reExportText) ?? {};
+        const verifyError = verifySetMutation(reExportDef.variables ?? {}, options.key, expectedEntry);
+        if (verifyError !== null) {
+            fail(`post-import verification failed: ${verifyError}${action ? ` (import action: ${action})` : ''}`);
+        }
+        console.log(success(`Set variable '${options.key}' on test ${target.uuid}`));
+    }
+    catch (err) {
+        console.log(error(`Failed to set variable: ${formatError(err)}`));
+        process.exit(1);
+    }
+});
+//# sourceMappingURL=set.js.map

package/dist/src/cli/commands/test/vars/set.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"set.js","sourceRoot":"","sources":["../../../../../../src/cli/commands/test/vars/set.ts"],"names":[],"mappings":"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"}

package/dist/src/cli/commands/test/vars/unset.d.ts

@@ -0,0 +1,12 @@
+/**
+ * qa-use test vars unset - Remove a typed variable from a test.
+ *
+ * Local-file path: deletes the key via the yaml.Document API. When the
+ * `variables:` map becomes empty, the whole block is removed.
+ *
+ * Remote `--id` path: export → mutate (delete the key) → import. Absent keys
+ * are a no-op on either path (exit 0 with an info note).
+ */
+import { Command } from 'commander';
+export declare const unsetCommand: Command;
+//# sourceMappingURL=unset.d.ts.map

package/dist/src/cli/commands/test/vars/unset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unset.d.ts","sourceRoot":"","sources":["../../../../../../src/cli/commands/test/vars/unset.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAsBpC,eAAO,MAAM,YAAY,SAiFrB,CAAC"}

package/dist/src/cli/commands/test/vars/unset.js

@@ -0,0 +1,86 @@
+/**
+ * qa-use test vars unset - Remove a typed variable from a test.
+ *
+ * Local-file path: deletes the key via the yaml.Document API. When the
+ * `variables:` map becomes empty, the whole block is removed.
+ *
+ * Remote `--id` path: export → mutate (delete the key) → import. Absent keys
+ * are a no-op on either path (exit 0 with an info note).
+ */
+import { Command } from 'commander';
+import * as yaml from 'yaml';
+import { createApiClient, loadConfig } from '../../../lib/config.js';
+import { error, formatError, info, success } from '../../../lib/output.js';
+import { readVarsFromYamlFile, resolveVarsTarget, verifyUnsetMutation, writeYamlFile, } from '../../../lib/test-vars.js';
+function fail(msg) {
+    console.log(error(msg));
+    process.exit(1);
+}
+export const unsetCommand = new Command('unset')
+    .description('Remove a typed variable from a test (local YAML or remote --id)')
+    .argument('[file]', 'Path to a local test YAML file')
+    .option('--id <uuid>', 'Remote test UUID — exports YAML, mutates, re-imports')
+    .requiredOption('--key <key>', 'Variable name')
+    .action(async (file, options) => {
+    try {
+        const target = resolveVarsTarget({ file, id: options.id });
+        if (!options.key)
+            fail('--key is required');
+        const key = options.key;
+        if (target.kind === 'file') {
+            const { doc } = await readVarsFromYamlFile(target.path);
+            const exists = doc.hasIn(['variables', key]);
+            if (!exists) {
+                console.log(info(`key '${key}' not present in ${target.path}`));
+                return;
+            }
+            doc.deleteIn(['variables', key]);
+            // If the variables map is now empty, drop the whole block.
+            const remaining = doc.getIn(['variables']);
+            const isEmpty = remaining === null ||
+                remaining === undefined ||
+                (yaml.isMap(remaining) && remaining.items.length === 0);
+            if (isEmpty) {
+                doc.deleteIn(['variables']);
+            }
+            await writeYamlFile(target.path, doc);
+            console.log(success(`Unset variable '${key}' in ${target.path}`));
+            return;
+        }
+        // Remote --id path
+        const config = await loadConfig();
+        const client = createApiClient(config);
+        const yamlText = await client.exportTest(target.uuid, 'yaml', false);
+        const def = yaml.parse(yamlText) ?? {};
+        const vars = def.variables ?? {};
+        if (!(key in vars)) {
+            console.log(info(`key '${key}' not present on test ${target.uuid}`));
+            return;
+        }
+        delete vars[key];
+        def.variables = vars;
+        const result = await client.importTestDefinition([def]);
+        if (result?.success === false) {
+            fail(`import failed: ${JSON.stringify(result)}`);
+        }
+        const action = result?.imported?.[0]?.action;
+        if (action === 'conflict') {
+            const message = result?.imported?.[0]?.message;
+            fail(`import returned conflict for test ${target.uuid}${message ? `: ${message}` : ''} — variable '${key}' was not removed`);
+        }
+        // Re-export and verify the deletion took effect — see set.ts for why
+        // `ImportResult.success === true` is not a strong enough signal.
+        const reExportText = await client.exportTest(target.uuid, 'yaml', false);
+        const reExportDef = yaml.parse(reExportText) ?? {};
+        const verifyError = verifyUnsetMutation(reExportDef.variables ?? {}, key);
+        if (verifyError !== null) {
+            fail(`post-import verification failed: ${verifyError}${action ? ` (import action: ${action})` : ''}`);
+        }
+        console.log(success(`Unset variable '${key}' on test ${target.uuid}`));
+    }
+    catch (err) {
+        console.log(error(`Failed to unset variable: ${formatError(err)}`));
+        process.exit(1);
+    }
+});
+//# sourceMappingURL=unset.js.map

package/dist/src/cli/commands/test/vars/unset.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unset.js","sourceRoot":"","sources":["../../../../../../src/cli/commands/test/vars/unset.ts"],"names":[],"mappings":"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"}