@elliemae/encw-leak-runner 1.0.3 → 1.0.5

package/dist/bin/leak-runner.js

@@ -140,6 +140,7 @@ var ScenarioRunner = class {
       scenario,
       snapshotsDir
     );
+    if (scenario.setup) await scenario.setup(page, frame);
     paths.before = await profiler.captureSnapshot("before");
     await this.repeatScenarioActions(scenario, page, frame);
     await forceGarbageCollection(page);
@@ -156,12 +157,19 @@ var ScenarioRunner = class {
     const auth = new AuthManager();
     const pageSetup = new PageSetup();
     await pageSetup.apply(page);
+    await page.unroute(PageSetup.BLOCKED_PATTERN);
     await auth.login(page, {
       username: this.config.env.userId,
       password: this.config.env.password,
       instanceId: this.config.env.instanceId
     });
-    await page.goto(scenario.url());
+    process.stderr.write(`[scenarioRunner] post-login URL = ${page.url()}
+`);
+    await page.waitForURL(`**${scenario.url()}**`, { timeout: 3e4 });
+    process.stderr.write(
+      `[scenarioRunner] settled URL before iframe = ${page.url()}
+`
+    );
     const frame = await resolveIframe(page, scenario.microappSelector);
     fs.mkdirSync(snapshotsDir, { recursive: true });
     const profiler = new IframeHeapProfiler(page, frame, snapshotsDir);
@@ -403,9 +411,12 @@ var aiConfigFileSchema = z.object({
   model: z.string().min(1),
   temperature: z.number().min(0).max(2)
 }).partial();
+var envsSchema = z.record(z.string().min(1));
 var runnerConfigFileSchema = z.object({
+  $schema: z.string().optional(),
   runner: runnerOptionsSchema,
-  ai: aiConfigFileSchema
+  ai: aiConfigFileSchema,
+  envs: envsSchema
 }).partial().strict();
 
 // lib/config/sources/fileConfigSource.ts
@@ -469,7 +480,8 @@ function applySource(acc, source) {
   const payload = source.load();
   return {
     runner: payload.runner ? applyRunnerPayload(acc.runner, payload.runner) : acc.runner,
-    ai: payload.ai ? applyAiPayload(acc.ai, payload.ai) : acc.ai
+    ai: payload.ai ? applyAiPayload(acc.ai, payload.ai) : acc.ai,
+    envs: payload.envs ? { ...acc.envs, ...payload.envs } : acc.envs
   };
 }
 var RunnerConfigLoader = class {
@@ -488,14 +500,16 @@ var RunnerConfigLoader = class {
         aiEnabled: BUILT_IN_DEFAULTS.ai.enabled ?? false,
         aiModel: BUILT_IN_DEFAULTS.ai.model ?? "Claude3.7",
         aiTemperature: BUILT_IN_DEFAULTS.ai.temperature ?? 0.3
-      }
+      },
+      envs: {}
     };
     const resolved = ordered.reduce(applySource, initial);
     return {
       runner: resolved.runner,
       aiEnabled: resolved.ai.aiEnabled,
       aiModel: resolved.ai.aiModel,
-      aiTemperature: resolved.ai.aiTemperature
+      aiTemperature: resolved.ai.aiTemperature,
+      envs: resolved.envs
     };
   }
 };
@@ -505,13 +519,26 @@ var MissingRequiredParamError = class extends Error {
   constructor(missing) {
     super(
       `Missing required parameter(s): ${missing.join(", ")}.
-Provide via CLI flag (--base-url / --instance-id / --user-id) or env var (BASE_URL / ENCW_INSTANCE_ID / ENCW_USER_ID / ENCW_PASSWORD).`
+Provide via CLI flag (--env / --instance-id / --user-id) or env var (BASE_URL / ENCW_ENV / ENCW_INSTANCE_ID / ENCW_USER_ID / ENCW_PASSWORD).`
     );
     this.missing = missing;
     this.name = "MissingRequiredParamError";
   }
 };
 
+// lib/config/unknownEnvError.ts
+var UnknownEnvError = class extends Error {
+  constructor(name, knownEnvs) {
+    const knownList = knownEnvs.length > 0 ? knownEnvs.join(", ") : "(none defined)";
+    super(
+      `Unknown env "${name}". Known envs in leak-runner.config.json: ${knownList}.`
+    );
+    this.name = name;
+    this.knownEnvs = knownEnvs;
+    this.name = "UnknownEnvError";
+  }
+};
+
 // lib/config/requiredEnvParams.ts
 var RequiredEnvParamsResolver = class {
   resolve(cliOpts) {
@@ -524,8 +551,17 @@ var RequiredEnvParamsResolver = class {
     if (missing.length > 0) throw new MissingRequiredParamError(missing);
     return params;
   }
+  // Precedence: BASE_URL env > --env / ENCW_ENV map lookup.
+  // Throws UnknownEnvError when an env name is supplied but not in the map,
+  // so a typo fails loudly instead of silently falling through to "missing baseUrl".
   resolveBaseUrl(cliOpts) {
-    return cliOpts.baseUrl || process.env.BASE_URL || "";
+    if (process.env.BASE_URL) return process.env.BASE_URL;
+    const envName = cliOpts.env || process.env.ENCW_ENV;
+    if (!envName) return "";
+    const envs = cliOpts.envs ?? {};
+    const fromMap = envs[envName];
+    if (!fromMap) throw new UnknownEnvError(envName, Object.keys(envs));
+    return fromMap;
   }
   resolveInstanceId(cliOpts) {
     return cliOpts.instanceId || process.env.ENCW_INSTANCE_ID || "";
@@ -551,7 +587,10 @@ var RunCommand = class {
   register(program, deps) {
     program.command("run [key]").description(
       "Run a scenario by `<microapp>/<id>`, or use --all / --tag to run multiple"
-    ).option("--all", "Run all registered scenarios").option("--tag <tag>", "Run all scenarios matching a tag").option("--base-url <url>", "Override base URL").option("--instance-id <id>", "Override instance ID").option("--user-id <id>", "Override user ID").option("--output-dir <dir>", "Override output directory").option(
+    ).option("--all", "Run all registered scenarios").option("--tag <tag>", "Run all scenarios matching a tag").option(
+      "--env <name>",
+      "Select a named environment from leak-runner.config.json envs (also reads ENCW_ENV)"
+    ).option("--instance-id <id>", "Override instance ID").option("--user-id <id>", "Override user ID").option("--output-dir <dir>", "Override output directory").option(
       "--top-n <n>",
       "Override top-N for heap comparison",
       (v) => parseInt(v, 10)
@@ -568,7 +607,7 @@ var RunCommand = class {
         await new JunitReporter().write(summary, config.runner.outputDir);
         process.exit(summary.failCount > 0 ? 1 : 0);
       } catch (err) {
-        if (err instanceof MissingRequiredParamError) {
+        if (err instanceof MissingRequiredParamError || err instanceof UnknownEnvError) {
           process.stderr.write(`Configuration error: ${err.message}
 `);
           process.exit(2);
@@ -592,7 +631,8 @@ var RunCommand = class {
     ]);
     const resolved = loader.resolveOptions();
     const env = deps.envParams.resolve({
-      baseUrl: options.baseUrl,
+      env: options.env,
+      envs: resolved.envs,
       instanceId: options.instanceId,
       userId: options.userId
     });
@@ -684,6 +724,26 @@ var ScenarioRegistry = class {
   }
 };
 
+// lib/scenarios/one-admin/page-models/AdminLandingPageModel.ts
+var AdminLandingPageModel = class {
+  constructor(frame) {
+    this.frame = frame;
+  }
+  get oneAdminConsoleOption() {
+    return this.frame.getByText("ONE ADMIN CONSOLE");
+  }
+  async clickOneAdminConsole() {
+    await this.oneAdminConsoleOption.click();
+  }
+  static async acceptCookiesIfShown(page) {
+    try {
+      await page.locator("#onetrust-group-container").waitFor({ state: "visible", timeout: 5e3 });
+      await page.locator("button", { hasText: "Accept All Cookies" }).click();
+    } catch {
+    }
+  }
+};
+
 // lib/scenarios/one-admin/page-models/SelectSettingsPageModel.ts
 var SelectSettingsPageModel = class {
   constructor(frame) {
@@ -737,8 +797,17 @@ var exportNavigationScenario = {
   description: "Navigate to export page and come back - verify iframe GC",
   tags: ["critical"],
   microappSelector: "iframe#pui-iframe-container-emAdminUI",
-  url: () => "/admin/oneadmin/migrate",
+  url: () => "/admin",
+  async setup(page) {
+    await AdminLandingPageModel.acceptCookiesIfShown(page);
+  },
   async action(page, frame) {
+    const path3 = new URL(page.url()).pathname.replace(/\/$/, "");
+    if (path3 === "/admin") {
+      const adminLanding = new AdminLandingPageModel(frame);
+      await adminLanding.oneAdminConsoleOption.waitFor({ state: "visible" });
+      await adminLanding.clickOneAdminConsole();
+    }
     const settings = new SelectSettingsPageModel(frame);
     await settings.container.waitFor({ state: "visible" });
     await settings.expandTreeItem("eFolder");

package/dist/cjs/cli/commands/runCommand.js

@@ -33,7 +33,10 @@ class RunCommand {
   register(program, deps) {
     program.command("run [key]").description(
       "Run a scenario by `<microapp>/<id>`, or use --all / --tag to run multiple"
-    ).option("--all", "Run all registered scenarios").option("--tag <tag>", "Run all scenarios matching a tag").option("--base-url <url>", "Override base URL").option("--instance-id <id>", "Override instance ID").option("--user-id <id>", "Override user ID").option("--output-dir <dir>", "Override output directory").option(
+    ).option("--all", "Run all registered scenarios").option("--tag <tag>", "Run all scenarios matching a tag").option(
+      "--env <name>",
+      "Select a named environment from leak-runner.config.json envs (also reads ENCW_ENV)"
+    ).option("--instance-id <id>", "Override instance ID").option("--user-id <id>", "Override user ID").option("--output-dir <dir>", "Override output directory").option(
       "--top-n <n>",
       "Override top-N for heap comparison",
       (v) => parseInt(v, 10)
@@ -50,7 +53,7 @@ class RunCommand {
         await new import_junitReporter.JunitReporter().write(summary, config.runner.outputDir);
         process.exit(summary.failCount > 0 ? 1 : 0);
       } catch (err) {
-        if (err instanceof import_requiredEnvParams.MissingRequiredParamError) {
+        if (err instanceof import_requiredEnvParams.MissingRequiredParamError || err instanceof import_requiredEnvParams.UnknownEnvError) {
           process.stderr.write(`Configuration error: ${err.message}
 `);
           process.exit(2);
@@ -74,7 +77,8 @@ class RunCommand {
     ]);
     const resolved = loader.resolveOptions();
     const env = deps.envParams.resolve({
-      baseUrl: options.baseUrl,
+      env: options.env,
+      envs: resolved.envs,
       instanceId: options.instanceId,
       userId: options.userId
     });

package/dist/cjs/config/missingRequiredParamError.js

@@ -25,7 +25,7 @@ class MissingRequiredParamError extends Error {
   constructor(missing) {
     super(
       `Missing required parameter(s): ${missing.join(", ")}.
-Provide via CLI flag (--base-url / --instance-id / --user-id) or env var (BASE_URL / ENCW_INSTANCE_ID / ENCW_USER_ID / ENCW_PASSWORD).`
+Provide via CLI flag (--env / --instance-id / --user-id) or env var (BASE_URL / ENCW_ENV / ENCW_INSTANCE_ID / ENCW_USER_ID / ENCW_PASSWORD).`
     );
     this.missing = missing;
     this.name = "MissingRequiredParamError";

package/dist/cjs/config/requiredEnvParams.js

@@ -19,10 +19,12 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var requiredEnvParams_exports = {};
 __export(requiredEnvParams_exports, {
   MissingRequiredParamError: () => import_missingRequiredParamError.MissingRequiredParamError,
-  RequiredEnvParamsResolver: () => RequiredEnvParamsResolver
+  RequiredEnvParamsResolver: () => RequiredEnvParamsResolver,
+  UnknownEnvError: () => import_unknownEnvError.UnknownEnvError
 });
 module.exports = __toCommonJS(requiredEnvParams_exports);
 var import_missingRequiredParamError = require("./missingRequiredParamError.js");
+var import_unknownEnvError = require("./unknownEnvError.js");
 class RequiredEnvParamsResolver {
   resolve(cliOpts) {
     const baseUrl = this.resolveBaseUrl(cliOpts);
@@ -34,8 +36,17 @@ class RequiredEnvParamsResolver {
     if (missing.length > 0) throw new import_missingRequiredParamError.MissingRequiredParamError(missing);
     return params;
   }
+  // Precedence: BASE_URL env > --env / ENCW_ENV map lookup.
+  // Throws UnknownEnvError when an env name is supplied but not in the map,
+  // so a typo fails loudly instead of silently falling through to "missing baseUrl".
   resolveBaseUrl(cliOpts) {
-    return cliOpts.baseUrl || process.env.BASE_URL || "";
+    if (process.env.BASE_URL) return process.env.BASE_URL;
+    const envName = cliOpts.env || process.env.ENCW_ENV;
+    if (!envName) return "";
+    const envs = cliOpts.envs ?? {};
+    const fromMap = envs[envName];
+    if (!fromMap) throw new import_unknownEnvError.UnknownEnvError(envName, Object.keys(envs));
+    return fromMap;
   }
   resolveInstanceId(cliOpts) {
     return cliOpts.instanceId || process.env.ENCW_INSTANCE_ID || "";

package/dist/cjs/config/runnerConfigLoader.js

@@ -40,7 +40,8 @@ function applySource(acc, source) {
   const payload = source.load();
   return {
     runner: payload.runner ? applyRunnerPayload(acc.runner, payload.runner) : acc.runner,
-    ai: payload.ai ? applyAiPayload(acc.ai, payload.ai) : acc.ai
+    ai: payload.ai ? applyAiPayload(acc.ai, payload.ai) : acc.ai,
+    envs: payload.envs ? { ...acc.envs, ...payload.envs } : acc.envs
   };
 }
 class RunnerConfigLoader {
@@ -60,14 +61,16 @@ class RunnerConfigLoader {
         aiEnabled: import_configSource.BUILT_IN_DEFAULTS.ai.enabled ?? false,
         aiModel: import_configSource.BUILT_IN_DEFAULTS.ai.model ?? "Claude3.7",
         aiTemperature: import_configSource.BUILT_IN_DEFAULTS.ai.temperature ?? 0.3
-      }
+      },
+      envs: {}
     };
     const resolved = ordered.reduce(applySource, initial);
     return {
       runner: resolved.runner,
       aiEnabled: resolved.ai.aiEnabled,
       aiModel: resolved.ai.aiModel,
-      aiTemperature: resolved.ai.aiTemperature
+      aiTemperature: resolved.ai.aiTemperature,
+      envs: resolved.envs
     };
   }
 }

package/dist/cjs/config/runnerConfigSchema.js

@@ -19,6 +19,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var runnerConfigSchema_exports = {};
 __export(runnerConfigSchema_exports, {
   aiConfigFileSchema: () => aiConfigFileSchema,
+  envsSchema: () => envsSchema,
   runnerConfigFileSchema: () => runnerConfigFileSchema,
   runnerOptionsSchema: () => runnerOptionsSchema
 });
@@ -34,7 +35,10 @@ const aiConfigFileSchema = import_zod.z.object({
   model: import_zod.z.string().min(1),
   temperature: import_zod.z.number().min(0).max(2)
 }).partial();
+const envsSchema = import_zod.z.record(import_zod.z.string().min(1));
 const runnerConfigFileSchema = import_zod.z.object({
+  $schema: import_zod.z.string().optional(),
   runner: runnerOptionsSchema,
-  ai: aiConfigFileSchema
+  ai: aiConfigFileSchema,
+  envs: envsSchema
 }).partial().strict();

package/dist/cjs/config/unknownEnvError.js

@@ -0,0 +1,36 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var unknownEnvError_exports = {};
+__export(unknownEnvError_exports, {
+  UnknownEnvError: () => UnknownEnvError
+});
+module.exports = __toCommonJS(unknownEnvError_exports);
+class UnknownEnvError extends Error {
+  constructor(name, knownEnvs) {
+    const knownList = knownEnvs.length > 0 ? knownEnvs.join(", ") : "(none defined)";
+    super(
+      `Unknown env "${name}". Known envs in leak-runner.config.json: ${knownList}.`
+    );
+    this.name = name;
+    this.knownEnvs = knownEnvs;
+    this.name = "UnknownEnvError";
+  }
+  name;
+  knownEnvs;
+}

package/dist/cjs/index.js

@@ -32,6 +32,7 @@ __export(index_exports, {
   ScenarioRegistry: () => import_scenarioRegistry.ScenarioRegistry,
   ScenarioRunner: () => import_scenarioRunner.ScenarioRunner,
   ThresholdEvaluator: () => import_thresholdEvaluator.ThresholdEvaluator,
+  UnknownEnvError: () => import_requiredEnvParams.UnknownEnvError,
   buildProgram: () => import_cli.buildProgram,
   defaultDeps: () => import_cli.defaultDeps
 });

package/dist/cjs/runner/scenarioRunner.js

@@ -93,6 +93,7 @@ class ScenarioRunner {
       scenario,
       snapshotsDir
     );
+    if (scenario.setup) await scenario.setup(page, frame);
     paths.before = await profiler.captureSnapshot("before");
     await this.repeatScenarioActions(scenario, page, frame);
     await forceGarbageCollection(page);
@@ -109,12 +110,19 @@ class ScenarioRunner {
     const auth = new import_smoked_suite.AuthManager();
     const pageSetup = new import_smoked_suite.PageSetup();
     await pageSetup.apply(page);
+    await page.unroute(import_smoked_suite.PageSetup.BLOCKED_PATTERN);
     await auth.login(page, {
       username: this.config.env.userId,
       password: this.config.env.password,
       instanceId: this.config.env.instanceId
     });
-    await page.goto(scenario.url());
+    process.stderr.write(`[scenarioRunner] post-login URL = ${page.url()}
+`);
+    await page.waitForURL(`**${scenario.url()}**`, { timeout: 3e4 });
+    process.stderr.write(
+      `[scenarioRunner] settled URL before iframe = ${page.url()}
+`
+    );
     const frame = await resolveIframe(page, scenario.microappSelector);
     import_node_fs.default.mkdirSync(snapshotsDir, { recursive: true });
     const profiler = new import_iframeHeapProfiler.IframeHeapProfiler(page, frame, snapshotsDir);

package/dist/cjs/scenarios/one-admin/export-navigation.scenario.js

@@ -28,8 +28,17 @@ const exportNavigationScenario = {
   description: "Navigate to export page and come back - verify iframe GC",
   tags: ["critical"],
   microappSelector: "iframe#pui-iframe-container-emAdminUI",
-  url: () => "/admin/oneadmin/migrate",
+  url: () => "/admin",
+  async setup(page) {
+    await import_page_models.AdminLandingPageModel.acceptCookiesIfShown(page);
+  },
   async action(page, frame) {
+    const path = new URL(page.url()).pathname.replace(/\/$/, "");
+    if (path === "/admin") {
+      const adminLanding = new import_page_models.AdminLandingPageModel(frame);
+      await adminLanding.oneAdminConsoleOption.waitFor({ state: "visible" });
+      await adminLanding.clickOneAdminConsole();
+    }
     const settings = new import_page_models.SelectSettingsPageModel(frame);
     await settings.container.waitFor({ state: "visible" });
     await settings.expandTreeItem("eFolder");

package/dist/cjs/scenarios/one-admin/page-models/AdminLandingPageModel.js

@@ -0,0 +1,42 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var AdminLandingPageModel_exports = {};
+__export(AdminLandingPageModel_exports, {
+  AdminLandingPageModel: () => AdminLandingPageModel
+});
+module.exports = __toCommonJS(AdminLandingPageModel_exports);
+class AdminLandingPageModel {
+  constructor(frame) {
+    this.frame = frame;
+  }
+  frame;
+  get oneAdminConsoleOption() {
+    return this.frame.getByText("ONE ADMIN CONSOLE");
+  }
+  async clickOneAdminConsole() {
+    await this.oneAdminConsoleOption.click();
+  }
+  static async acceptCookiesIfShown(page) {
+    try {
+      await page.locator("#onetrust-group-container").waitFor({ state: "visible", timeout: 5e3 });
+      await page.locator("button", { hasText: "Accept All Cookies" }).click();
+    } catch {
+    }
+  }
+}

package/dist/cjs/scenarios/one-admin/page-models/index.js

@@ -18,9 +18,11 @@ var __copyProps = (to, from, except, desc) => {
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var page_models_exports = {};
 __export(page_models_exports, {
+  AdminLandingPageModel: () => import_AdminLandingPageModel.AdminLandingPageModel,
   ExportPageModel: () => import_ExportPageModel.ExportPageModel,
   SelectSettingsPageModel: () => import_SelectSettingsPageModel.SelectSettingsPageModel
 });
 module.exports = __toCommonJS(page_models_exports);
+var import_AdminLandingPageModel = require("./AdminLandingPageModel.js");
 var import_SelectSettingsPageModel = require("./SelectSettingsPageModel.js");
 var import_ExportPageModel = require("./ExportPageModel.js");

package/dist/esm/cli/commands/runCommand.js

@@ -7,12 +7,18 @@ import {
 import { EnvVarConfigSource } from "../../config/sources/envVarConfigSource.js";
 import { FileConfigSource } from "../../config/sources/fileConfigSource.js";
 import { RunnerConfigLoader } from "../../config/runnerConfigLoader.js";
-import { MissingRequiredParamError } from "../../config/requiredEnvParams.js";
+import {
+  MissingRequiredParamError,
+  UnknownEnvError
+} from "../../config/requiredEnvParams.js";
 class RunCommand {
   register(program, deps) {
     program.command("run [key]").description(
       "Run a scenario by `<microapp>/<id>`, or use --all / --tag to run multiple"
-    ).option("--all", "Run all registered scenarios").option("--tag <tag>", "Run all scenarios matching a tag").option("--base-url <url>", "Override base URL").option("--instance-id <id>", "Override instance ID").option("--user-id <id>", "Override user ID").option("--output-dir <dir>", "Override output directory").option(
+    ).option("--all", "Run all registered scenarios").option("--tag <tag>", "Run all scenarios matching a tag").option(
+      "--env <name>",
+      "Select a named environment from leak-runner.config.json envs (also reads ENCW_ENV)"
+    ).option("--instance-id <id>", "Override instance ID").option("--user-id <id>", "Override user ID").option("--output-dir <dir>", "Override output directory").option(
       "--top-n <n>",
       "Override top-N for heap comparison",
       (v) => parseInt(v, 10)
@@ -29,7 +35,7 @@ class RunCommand {
         await new JunitReporter().write(summary, config.runner.outputDir);
         process.exit(summary.failCount > 0 ? 1 : 0);
       } catch (err) {
-        if (err instanceof MissingRequiredParamError) {
+        if (err instanceof MissingRequiredParamError || err instanceof UnknownEnvError) {
           process.stderr.write(`Configuration error: ${err.message}
 `);
           process.exit(2);
@@ -53,7 +59,8 @@ class RunCommand {
     ]);
     const resolved = loader.resolveOptions();
     const env = deps.envParams.resolve({
-      baseUrl: options.baseUrl,
+      env: options.env,
+      envs: resolved.envs,
       instanceId: options.instanceId,
       userId: options.userId
     });

package/dist/esm/config/missingRequiredParamError.js

@@ -2,7 +2,7 @@ class MissingRequiredParamError extends Error {
   constructor(missing) {
     super(
       `Missing required parameter(s): ${missing.join(", ")}.
-Provide via CLI flag (--base-url / --instance-id / --user-id) or env var (BASE_URL / ENCW_INSTANCE_ID / ENCW_USER_ID / ENCW_PASSWORD).`
+Provide via CLI flag (--env / --instance-id / --user-id) or env var (BASE_URL / ENCW_ENV / ENCW_INSTANCE_ID / ENCW_USER_ID / ENCW_PASSWORD).`
     );
     this.missing = missing;
     this.name = "MissingRequiredParamError";

package/dist/esm/config/requiredEnvParams.js

@@ -1,4 +1,5 @@
 import { MissingRequiredParamError } from "./missingRequiredParamError.js";
+import { UnknownEnvError } from "./unknownEnvError.js";
 class RequiredEnvParamsResolver {
   resolve(cliOpts) {
     const baseUrl = this.resolveBaseUrl(cliOpts);
@@ -10,8 +11,17 @@ class RequiredEnvParamsResolver {
     if (missing.length > 0) throw new MissingRequiredParamError(missing);
     return params;
   }
+  // Precedence: BASE_URL env > --env / ENCW_ENV map lookup.
+  // Throws UnknownEnvError when an env name is supplied but not in the map,
+  // so a typo fails loudly instead of silently falling through to "missing baseUrl".
   resolveBaseUrl(cliOpts) {
-    return cliOpts.baseUrl || process.env.BASE_URL || "";
+    if (process.env.BASE_URL) return process.env.BASE_URL;
+    const envName = cliOpts.env || process.env.ENCW_ENV;
+    if (!envName) return "";
+    const envs = cliOpts.envs ?? {};
+    const fromMap = envs[envName];
+    if (!fromMap) throw new UnknownEnvError(envName, Object.keys(envs));
+    return fromMap;
   }
   resolveInstanceId(cliOpts) {
     return cliOpts.instanceId || process.env.ENCW_INSTANCE_ID || "";
@@ -33,5 +43,6 @@ class RequiredEnvParamsResolver {
 }
 export {
   MissingRequiredParamError,
-  RequiredEnvParamsResolver
+  RequiredEnvParamsResolver,
+  UnknownEnvError
 };

package/dist/esm/config/runnerConfigLoader.js

@@ -17,7 +17,8 @@ function applySource(acc, source) {
   const payload = source.load();
   return {
     runner: payload.runner ? applyRunnerPayload(acc.runner, payload.runner) : acc.runner,
-    ai: payload.ai ? applyAiPayload(acc.ai, payload.ai) : acc.ai
+    ai: payload.ai ? applyAiPayload(acc.ai, payload.ai) : acc.ai,
+    envs: payload.envs ? { ...acc.envs, ...payload.envs } : acc.envs
   };
 }
 class RunnerConfigLoader {
@@ -37,14 +38,16 @@ class RunnerConfigLoader {
         aiEnabled: BUILT_IN_DEFAULTS.ai.enabled ?? false,
         aiModel: BUILT_IN_DEFAULTS.ai.model ?? "Claude3.7",
         aiTemperature: BUILT_IN_DEFAULTS.ai.temperature ?? 0.3
-      }
+      },
+      envs: {}
     };
     const resolved = ordered.reduce(applySource, initial);
     return {
       runner: resolved.runner,
       aiEnabled: resolved.ai.aiEnabled,
       aiModel: resolved.ai.aiModel,
-      aiTemperature: resolved.ai.aiTemperature
+      aiTemperature: resolved.ai.aiTemperature,
+      envs: resolved.envs
     };
   }
 }

package/dist/esm/config/runnerConfigSchema.js

@@ -9,12 +9,16 @@ const aiConfigFileSchema = z.object({
   model: z.string().min(1),
   temperature: z.number().min(0).max(2)
 }).partial();
+const envsSchema = z.record(z.string().min(1));
 const runnerConfigFileSchema = z.object({
+  $schema: z.string().optional(),
   runner: runnerOptionsSchema,
-  ai: aiConfigFileSchema
+  ai: aiConfigFileSchema,
+  envs: envsSchema
 }).partial().strict();
 export {
   aiConfigFileSchema,
+  envsSchema,
   runnerConfigFileSchema,
   runnerOptionsSchema
 };

package/dist/esm/config/unknownEnvError.js

@@ -0,0 +1,16 @@
+class UnknownEnvError extends Error {
+  constructor(name, knownEnvs) {
+    const knownList = knownEnvs.length > 0 ? knownEnvs.join(", ") : "(none defined)";
+    super(
+      `Unknown env "${name}". Known envs in leak-runner.config.json: ${knownList}.`
+    );
+    this.name = name;
+    this.knownEnvs = knownEnvs;
+    this.name = "UnknownEnvError";
+  }
+  name;
+  knownEnvs;
+}
+export {
+  UnknownEnvError
+};

package/dist/esm/index.js

@@ -12,7 +12,8 @@ import { EnvVarConfigSource } from "./config/sources/envVarConfigSource.js";
 import { CliOverrideConfigSource } from "./config/sources/cliOverrideConfigSource.js";
 import {
   RequiredEnvParamsResolver,
-  MissingRequiredParamError
+  MissingRequiredParamError,
+  UnknownEnvError
 } from "./config/requiredEnvParams.js";
 import { buildProgram, defaultDeps } from "./cli/index.js";
 export {
@@ -30,6 +31,7 @@ export {
   ScenarioRegistry,
   ScenarioRunner,
   ThresholdEvaluator,
+  UnknownEnvError,
   buildProgram,
   defaultDeps
 };