@emesoft_company/playwright-core 2.1.0

package/dist/config/index.cjs

@@ -0,0 +1,268 @@
+'use strict';
+
+var zod = require('zod');
+var fs = require('fs');
+var dotenv = require('dotenv');
+var test = require('@playwright/test');
+
+// src/errors/app-error.ts
+var AppError = class extends Error {
+  code;
+  context;
+  constructor(message, options) {
+    super(message, { cause: options.cause });
+    this.name = new.target.name;
+    this.code = options.code;
+    this.context = options.context;
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+};
+var ConfigValidationError = class extends AppError {
+  constructor(message, issues, context) {
+    super(message, { code: "CONFIG_VALIDATION_ERROR", context: { issues, ...context } });
+  }
+};
+var ConfigMissingError = class extends AppError {
+  constructor(name) {
+    super(`Required environment variable "${name}" is not set`, {
+      code: "ENV_VAR_MISSING",
+      context: { name }
+    });
+  }
+};
+
+// src/utils/deep-merge.ts
+function isPlainObject(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function deepMerge(base, override) {
+  if (override === void 0) return base;
+  if (!isPlainObject(base) || !isPlainObject(override)) {
+    return override;
+  }
+  const result = { ...base };
+  for (const [key, value] of Object.entries(override)) {
+    if (value === void 0) continue;
+    const baseValue = base[key];
+    result[key] = isPlainObject(baseValue) && isPlainObject(value) ? deepMerge(baseValue, value) : value;
+  }
+  return result;
+}
+function pruneUndefined(value) {
+  if (Array.isArray(value)) return value.map(pruneUndefined);
+  if (isPlainObject(value)) {
+    const result = {};
+    for (const [key, val] of Object.entries(value)) {
+      if (val === void 0) continue;
+      const pruned = pruneUndefined(val);
+      if (isPlainObject(pruned) && Object.keys(pruned).length === 0) continue;
+      result[key] = pruned;
+    }
+    return result;
+  }
+  return value;
+}
+var KNOWN_ENVIRONMENTS = ["local", "dev", "qa", "uat", "staging", "prod"];
+var EnvironmentSchema = zod.z.string().min(1);
+var TimeoutsSchema = zod.z.object({
+  actionMs: zod.z.number().int().positive().default(15e3),
+  navigationMs: zod.z.number().int().positive().default(3e4),
+  testMs: zod.z.number().int().positive().default(6e4),
+  /** Default budget for `waitForCondition` and other non-locator polling. */
+  waitMs: zod.z.number().int().positive().default(3e4)
+});
+var AuthConfigSchema = zod.z.object({
+  tokenUrl: zod.z.string().url().optional(),
+  clientId: zod.z.string().optional(),
+  clientSecret: zod.z.string().optional(),
+  username: zod.z.string().optional(),
+  password: zod.z.string().optional(),
+  /** Single-session storage state file (see `buildGlobalSetup`). */
+  storageStatePath: zod.z.string().optional(),
+  /** Directory used for per-role storage state files in multi-role setups. */
+  storageStateDir: zod.z.string().default(".auth")
+}).default({});
+var ReportingConfigSchema = zod.z.object({
+  allureEnabled: zod.z.boolean().default(false),
+  resultsDir: zod.z.string().default("allure-results"),
+  /** `{id}` is replaced with a test-case id — see `meta()` in `@emesoft_company/playwright-core/reporting`. */
+  testCaseUrlTemplate: zod.z.string().optional()
+}).default({});
+var RetryConfigSchema = zod.z.object({
+  retries: zod.z.number().int().min(0).default(2),
+  minDelayMs: zod.z.number().int().positive().default(200),
+  maxDelayMs: zod.z.number().int().positive().default(5e3)
+}).default({});
+var DiagnosticsConfigSchema = zod.z.object({
+  /** Collect browser console errors + failed requests and attach them to the report. */
+  enabled: zod.z.boolean().default(true),
+  /** Fail the test if the page logged a console error. Off by default — many apps are noisy. */
+  failOnConsoleError: zod.z.boolean().default(false),
+  /** Fail the test on an uncaught page exception. */
+  failOnPageError: zod.z.boolean().default(false),
+  /** Console messages matching any of these substrings are ignored entirely. */
+  ignoreConsolePatterns: zod.z.array(zod.z.string()).default([])
+}).default({});
+var AppConfigSchema = zod.z.object({
+  environment: EnvironmentSchema,
+  baseUrl: zod.z.string().url(),
+  apiBaseUrl: zod.z.string().url().optional(),
+  tenant: zod.z.string().optional(),
+  timeouts: TimeoutsSchema.default({}),
+  auth: AuthConfigSchema,
+  reporting: ReportingConfigSchema,
+  retry: RetryConfigSchema,
+  diagnostics: DiagnosticsConfigSchema,
+  logLevel: zod.z.enum(["fatal", "error", "warn", "info", "debug", "trace", "silent"]).default("info"),
+  custom: zod.z.record(zod.z.string(), zod.z.unknown()).default({})
+});
+
+// src/config/loader.ts
+function readEnvConfig(env) {
+  return {
+    environment: env.TEST_ENV ?? "dev",
+    baseUrl: env.BASE_URL,
+    apiBaseUrl: env.API_BASE_URL,
+    tenant: env.TENANT,
+    logLevel: env.LOG_LEVEL,
+    timeouts: {
+      actionMs: env.ACTION_TIMEOUT_MS ? Number(env.ACTION_TIMEOUT_MS) : void 0,
+      navigationMs: env.NAVIGATION_TIMEOUT_MS ? Number(env.NAVIGATION_TIMEOUT_MS) : void 0,
+      testMs: env.TEST_TIMEOUT_MS ? Number(env.TEST_TIMEOUT_MS) : void 0,
+      waitMs: env.WAIT_TIMEOUT_MS ? Number(env.WAIT_TIMEOUT_MS) : void 0
+    },
+    auth: {
+      tokenUrl: env.AUTH_TOKEN_URL,
+      clientId: env.AUTH_CLIENT_ID,
+      clientSecret: env.AUTH_CLIENT_SECRET,
+      username: env.AUTH_USERNAME,
+      password: env.AUTH_PASSWORD,
+      storageStatePath: env.AUTH_STORAGE_STATE_PATH,
+      storageStateDir: env.AUTH_STORAGE_STATE_DIR
+    },
+    reporting: {
+      allureEnabled: env.REPORT_ALLURE === "true",
+      resultsDir: env.ALLURE_RESULTS_DIR,
+      testCaseUrlTemplate: env.TEST_CASE_URL_TEMPLATE
+    },
+    retry: {
+      retries: env.RETRY_COUNT ? Number(env.RETRY_COUNT) : void 0,
+      minDelayMs: env.RETRY_MIN_DELAY_MS ? Number(env.RETRY_MIN_DELAY_MS) : void 0,
+      maxDelayMs: env.RETRY_MAX_DELAY_MS ? Number(env.RETRY_MAX_DELAY_MS) : void 0
+    },
+    diagnostics: {
+      enabled: env.DIAGNOSTICS === void 0 ? void 0 : env.DIAGNOSTICS !== "false",
+      failOnConsoleError: env.FAIL_ON_CONSOLE_ERROR === void 0 ? void 0 : env.FAIL_ON_CONSOLE_ERROR === "true",
+      failOnPageError: env.FAIL_ON_PAGE_ERROR === void 0 ? void 0 : env.FAIL_ON_PAGE_ERROR === "true"
+    }
+  };
+}
+function requireEnv(name, env = process.env) {
+  const value = env[name];
+  if (value === void 0 || value === "") {
+    throw new ConfigMissingError(name);
+  }
+  return value;
+}
+function loadConfig(options = {}) {
+  const { env = process.env, overrides } = options;
+  const fromEnv = pruneUndefined(readEnvConfig(env));
+  const merged = deepMerge(fromEnv, overrides);
+  const result = AppConfigSchema.safeParse(merged);
+  if (!result.success) {
+    throw new ConfigValidationError(
+      `Invalid application config: ${result.error.issues.map((issue) => `${issue.path.join(".") || "(root)"}: ${issue.message}`).join("; ")}`,
+      result.error.issues
+    );
+  }
+  return result.data;
+}
+function loadEnvFiles(files, env = process.env) {
+  const merged = {};
+  const loaded = [];
+  for (const file of files) {
+    if (!fs.existsSync(file)) continue;
+    Object.assign(merged, dotenv.parse(fs.readFileSync(file)));
+    loaded.push(file);
+  }
+  const applied = [];
+  for (const [key, value] of Object.entries(merged)) {
+    if (env[key] === void 0) {
+      env[key] = value;
+      applied.push(key);
+    }
+  }
+  return { loaded, applied };
+}
+function defaultEnvFiles(environment) {
+  return [".env", ".env.local", `.env.${environment}`, `.env.${environment}.local`];
+}
+
+// src/reporting/allure-setup.ts
+function buildReporterConfig(config) {
+  const reporters = [["html", { open: "never" }]];
+  if (config.reporting.allureEnabled) {
+    reporters.push(["allure-playwright", { resultsDir: config.reporting.resultsDir, detail: true }]);
+  }
+  return reporters;
+}
+
+// src/config/define-config.ts
+function resolveEnvFiles(options, environment) {
+  if (options.envFile === false) return [];
+  if (typeof options.envFile === "string") return [options.envFile];
+  if (Array.isArray(options.envFile)) return options.envFile;
+  return defaultEnvFiles(environment);
+}
+function defineE2EConfig(options = {}) {
+  const environment = process.env.TEST_ENV ?? options.defaultEnvironment ?? "dev";
+  loadEnvFiles(resolveEnvFiles(options, environment));
+  const overrides = typeof options.configOverrides === "function" ? options.configOverrides() : options.configOverrides;
+  const appConfig = loadConfig({ overrides: deepMerge({ environment }, overrides) });
+  const browsers = options.browsers ?? ["chromium"];
+  const deviceByBrowser = {
+    chromium: "Desktop Chrome",
+    firefox: "Desktop Firefox",
+    webkit: "Desktop Safari"
+  };
+  const generated = {
+    testDir: options.testDir ?? "./tests",
+    fullyParallel: true,
+    retries: appConfig.retry.retries,
+    timeout: appConfig.timeouts.testMs,
+    reporter: buildReporterConfig(appConfig),
+    // `globalSetup` is only wired when a path is given AND a storage state path is configured —
+    // otherwise a project that hasn't set up login yet would fail on every run.
+    ...options.globalSetup && appConfig.auth.storageStatePath ? { globalSetup: options.globalSetup } : {},
+    ...options.globalTeardown ? { globalTeardown: options.globalTeardown } : {},
+    use: {
+      baseURL: appConfig.baseUrl,
+      actionTimeout: appConfig.timeouts.actionMs,
+      navigationTimeout: appConfig.timeouts.navigationMs,
+      trace: "on-first-retry",
+      screenshot: "only-on-failure",
+      ...options.globalSetup && appConfig.auth.storageStatePath ? { storageState: appConfig.auth.storageStatePath } : {}
+    },
+    projects: browsers.map((browser) => ({
+      name: browser,
+      use: { ...test.devices[deviceByBrowser[browser]] }
+    }))
+  };
+  return deepMerge(generated, options.playwright);
+}
+
+exports.AppConfigSchema = AppConfigSchema;
+exports.AuthConfigSchema = AuthConfigSchema;
+exports.DiagnosticsConfigSchema = DiagnosticsConfigSchema;
+exports.EnvironmentSchema = EnvironmentSchema;
+exports.KNOWN_ENVIRONMENTS = KNOWN_ENVIRONMENTS;
+exports.ReportingConfigSchema = ReportingConfigSchema;
+exports.RetryConfigSchema = RetryConfigSchema;
+exports.TimeoutsSchema = TimeoutsSchema;
+exports.defaultEnvFiles = defaultEnvFiles;
+exports.defineE2EConfig = defineE2EConfig;
+exports.loadConfig = loadConfig;
+exports.loadEnvFiles = loadEnvFiles;
+exports.requireEnv = requireEnv;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/config/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/errors/app-error.ts","../../src/utils/deep-merge.ts","../../src/config/schema.ts","../../src/config/loader.ts","../../src/config/env.ts","../../src/reporting/allure-setup.ts","../../src/config/define-config.ts"],"names":["z","existsSync","parse","readFileSync","devices"],"mappings":"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","file":"index.cjs","sourcesContent":["export interface AppErrorOptions {\n  code: string;\n  cause?: unknown;\n  context?: Record<string, unknown>;\n}\n\n/**\n * Base error class for the framework. Every error thrown by core carries a\n * machine-readable `code` and optional `context`, so callers can branch on\n * `error.code` instead of parsing messages.\n */\nexport class AppError extends Error {\n  readonly code: string;\n  readonly context?: Record<string, unknown>;\n\n  constructor(message: string, options: AppErrorOptions) {\n    super(message, { cause: options.cause });\n    this.name = new.target.name;\n    this.code = options.code;\n    this.context = options.context;\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n}\n\nexport class ConfigValidationError extends AppError {\n  constructor(message: string, issues: unknown, context?: Record<string, unknown>) {\n    super(message, { code: \"CONFIG_VALIDATION_ERROR\", context: { issues, ...context } });\n  }\n}\n\nexport class ApiError extends AppError {\n  readonly status?: number;\n  readonly method?: string;\n  readonly url?: string;\n\n  constructor(\n    message: string,\n    options: AppErrorOptions & { status?: number; method?: string; url?: string },\n  ) {\n    super(message, options);\n    this.status = options.status;\n    this.method = options.method;\n    this.url = options.url;\n  }\n}\n\nexport class AuthError extends AppError {\n  constructor(message: string, options: Omit<AppErrorOptions, \"code\"> = {}) {\n    super(message, { code: \"AUTH_ERROR\", ...options });\n  }\n}\n\nexport class ConfigMissingError extends AppError {\n  constructor(name: string) {\n    super(`Required environment variable \"${name}\" is not set`, {\n      code: \"ENV_VAR_MISSING\",\n      context: { name },\n    });\n  }\n}\n","export function isPlainObject(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\n/**\n * Recursively merges `override` onto `base`. Arrays and primitives replace wholesale;\n * only plain objects are merged key by key. `undefined` values in `override` are ignored,\n * so a partial object never accidentally erases a configured value.\n */\nexport function deepMerge<T>(base: T, override: unknown): T {\n  if (override === undefined) return base;\n  if (!isPlainObject(base) || !isPlainObject(override)) {\n    return override as T;\n  }\n  const result: Record<string, unknown> = { ...base };\n  for (const [key, value] of Object.entries(override)) {\n    if (value === undefined) continue;\n    const baseValue = (base as Record<string, unknown>)[key];\n    result[key] = isPlainObject(baseValue) && isPlainObject(value) ? deepMerge(baseValue, value) : value;\n  }\n  return result as T;\n}\n\n/** Strips `undefined` values and empty nested objects, so zod defaults apply instead. */\nexport function pruneUndefined(value: unknown): unknown {\n  if (Array.isArray(value)) return value.map(pruneUndefined);\n  if (isPlainObject(value)) {\n    const result: Record<string, unknown> = {};\n    for (const [key, val] of Object.entries(value)) {\n      if (val === undefined) continue;\n      const pruned = pruneUndefined(val);\n      if (isPlainObject(pruned) && Object.keys(pruned).length === 0) continue;\n      result[key] = pruned;\n    }\n    return result;\n  }\n  return value;\n}\n","import { z } from \"zod\";\n\n/** Environments seen most often across projects — autocompleted, but any string is accepted. */\nexport const KNOWN_ENVIRONMENTS = [\"local\", \"dev\", \"qa\", \"uat\", \"staging\", \"prod\"] as const;\n\n/**\n * Free-form on purpose: teams run `uat`, `qa`, `sit`, per-tenant envs and so on. The union\n * below keeps editor autocomplete for the common ones without rejecting anything else\n * (`(string & {})` is the TS idiom that preserves suggestions on an open string type).\n */\nexport type Environment = (typeof KNOWN_ENVIRONMENTS)[number] | (string & {});\n\nexport const EnvironmentSchema = z.string().min(1);\n\nexport const TimeoutsSchema = z.object({\n  actionMs: z.number().int().positive().default(15_000),\n  navigationMs: z.number().int().positive().default(30_000),\n  testMs: z.number().int().positive().default(60_000),\n  /** Default budget for `waitForCondition` and other non-locator polling. */\n  waitMs: z.number().int().positive().default(30_000),\n});\n\nexport const AuthConfigSchema = z\n  .object({\n    tokenUrl: z.string().url().optional(),\n    clientId: z.string().optional(),\n    clientSecret: z.string().optional(),\n    username: z.string().optional(),\n    password: z.string().optional(),\n    /** Single-session storage state file (see `buildGlobalSetup`). */\n    storageStatePath: z.string().optional(),\n    /** Directory used for per-role storage state files in multi-role setups. */\n    storageStateDir: z.string().default(\".auth\"),\n  })\n  .default({});\n\nexport const ReportingConfigSchema = z\n  .object({\n    allureEnabled: z.boolean().default(false),\n    resultsDir: z.string().default(\"allure-results\"),\n    /** `{id}` is replaced with a test-case id — see `meta()` in `@emesoft_company/playwright-core/reporting`. */\n    testCaseUrlTemplate: z.string().optional(),\n  })\n  .default({});\n\nexport const RetryConfigSchema = z\n  .object({\n    retries: z.number().int().min(0).default(2),\n    minDelayMs: z.number().int().positive().default(200),\n    maxDelayMs: z.number().int().positive().default(5_000),\n  })\n  .default({});\n\nexport const DiagnosticsConfigSchema = z\n  .object({\n    /** Collect browser console errors + failed requests and attach them to the report. */\n    enabled: z.boolean().default(true),\n    /** Fail the test if the page logged a console error. Off by default — many apps are noisy. */\n    failOnConsoleError: z.boolean().default(false),\n    /** Fail the test on an uncaught page exception. */\n    failOnPageError: z.boolean().default(false),\n    /** Console messages matching any of these substrings are ignored entirely. */\n    ignoreConsolePatterns: z.array(z.string()).default([]),\n  })\n  .default({});\n\n/**\n * Base config schema shared by every project. Projects extend this via\n * `AppConfigSchema.extend({ ... })` or by nesting project-specific fields\n * under `custom` — core never hardcodes project business fields here.\n */\nexport const AppConfigSchema = z.object({\n  environment: EnvironmentSchema,\n  baseUrl: z.string().url(),\n  apiBaseUrl: z.string().url().optional(),\n  tenant: z.string().optional(),\n  timeouts: TimeoutsSchema.default({}),\n  auth: AuthConfigSchema,\n  reporting: ReportingConfigSchema,\n  retry: RetryConfigSchema,\n  diagnostics: DiagnosticsConfigSchema,\n  logLevel: z.enum([\"fatal\", \"error\", \"warn\", \"info\", \"debug\", \"trace\", \"silent\"]).default(\"info\"),\n  custom: z.record(z.string(), z.unknown()).default({}),\n});\n\nexport type AppConfig = Omit<z.infer<typeof AppConfigSchema>, \"environment\"> & {\n  environment: Environment;\n};\nexport type TimeoutsConfig = z.infer<typeof TimeoutsSchema>;\nexport type AuthConfig = z.infer<typeof AuthConfigSchema>;\nexport type ReportingConfig = z.infer<typeof ReportingConfigSchema>;\nexport type RetryConfig = z.infer<typeof RetryConfigSchema>;\nexport type DiagnosticsConfig = z.infer<typeof DiagnosticsConfigSchema>;\n","import { ConfigMissingError, ConfigValidationError } from \"../errors/app-error.js\";\nimport { deepMerge, pruneUndefined } from \"../utils/deep-merge.js\";\nimport { AppConfigSchema, type AppConfig } from \"./schema.js\";\nimport type { DeepPartial } from \"./types.js\";\n\nfunction readEnvConfig(env: NodeJS.ProcessEnv): Record<string, unknown> {\n  return {\n    environment: env.TEST_ENV ?? \"dev\",\n    baseUrl: env.BASE_URL,\n    apiBaseUrl: env.API_BASE_URL,\n    tenant: env.TENANT,\n    logLevel: env.LOG_LEVEL,\n    timeouts: {\n      actionMs: env.ACTION_TIMEOUT_MS ? Number(env.ACTION_TIMEOUT_MS) : undefined,\n      navigationMs: env.NAVIGATION_TIMEOUT_MS ? Number(env.NAVIGATION_TIMEOUT_MS) : undefined,\n      testMs: env.TEST_TIMEOUT_MS ? Number(env.TEST_TIMEOUT_MS) : undefined,\n      waitMs: env.WAIT_TIMEOUT_MS ? Number(env.WAIT_TIMEOUT_MS) : undefined,\n    },\n    auth: {\n      tokenUrl: env.AUTH_TOKEN_URL,\n      clientId: env.AUTH_CLIENT_ID,\n      clientSecret: env.AUTH_CLIENT_SECRET,\n      username: env.AUTH_USERNAME,\n      password: env.AUTH_PASSWORD,\n      storageStatePath: env.AUTH_STORAGE_STATE_PATH,\n      storageStateDir: env.AUTH_STORAGE_STATE_DIR,\n    },\n    reporting: {\n      allureEnabled: env.REPORT_ALLURE === \"true\",\n      resultsDir: env.ALLURE_RESULTS_DIR,\n      testCaseUrlTemplate: env.TEST_CASE_URL_TEMPLATE,\n    },\n    retry: {\n      retries: env.RETRY_COUNT ? Number(env.RETRY_COUNT) : undefined,\n      minDelayMs: env.RETRY_MIN_DELAY_MS ? Number(env.RETRY_MIN_DELAY_MS) : undefined,\n      maxDelayMs: env.RETRY_MAX_DELAY_MS ? Number(env.RETRY_MAX_DELAY_MS) : undefined,\n    },\n    diagnostics: {\n      enabled: env.DIAGNOSTICS === undefined ? undefined : env.DIAGNOSTICS !== \"false\",\n      failOnConsoleError: env.FAIL_ON_CONSOLE_ERROR === undefined ? undefined : env.FAIL_ON_CONSOLE_ERROR === \"true\",\n      failOnPageError: env.FAIL_ON_PAGE_ERROR === undefined ? undefined : env.FAIL_ON_PAGE_ERROR === \"true\",\n    },\n  };\n}\n\n/**\n * Reads a required environment variable, failing immediately with a clear message instead of\n * letting an `undefined` surface as a confusing failure deep inside a test.\n */\nexport function requireEnv(name: string, env: NodeJS.ProcessEnv = process.env): string {\n  const value = env[name];\n  if (value === undefined || value === \"\") {\n    throw new ConfigMissingError(name);\n  }\n  return value;\n}\n\nexport interface LoadConfigOptions {\n  /** Defaults to `process.env`. */\n  env?: NodeJS.ProcessEnv;\n  /** Project-specific overrides (e.g. from a project's `config.override.ts`), merged on top of env-derived values. */\n  overrides?: DeepPartial<AppConfig>;\n}\n\n/**\n * Loads and validates the application config for the current environment.\n * Resolution order: env-derived defaults -> project `overrides` -> zod validation.\n * Fails fast with `ConfigValidationError` when required fields (e.g. `baseUrl`) are missing/invalid,\n * instead of letting tests fail later with a confusing `undefined` somewhere downstream.\n */\nexport function loadConfig(options: LoadConfigOptions = {}): AppConfig {\n  const { env = process.env, overrides } = options;\n\n  const fromEnv = pruneUndefined(readEnvConfig(env)) as DeepPartial<AppConfig>;\n  const merged = deepMerge(fromEnv as AppConfig, overrides);\n\n  const result = AppConfigSchema.safeParse(merged);\n  if (!result.success) {\n    throw new ConfigValidationError(\n      `Invalid application config: ${result.error.issues\n        .map((issue) => `${issue.path.join(\".\") || \"(root)\"}: ${issue.message}`)\n        .join(\"; \")}`,\n      result.error.issues,\n    );\n  }\n  return result.data;\n}\n","import { existsSync, readFileSync } from \"node:fs\";\nimport { parse } from \"dotenv\";\n\nexport interface LoadEnvFilesResult {\n  /** Files that existed and were read, in the order they were applied. */\n  loaded: string[];\n  /** Variable names actually written to the environment. */\n  applied: string[];\n}\n\n/**\n * Loads several env files with predictable precedence:\n *\n * 1. **Later files beat earlier ones** — so `.env.staging.local` overrides `.env.staging`.\n * 2. **Real environment variables beat every file** — a `BASE_URL` exported by CI or the shell\n *    is never clobbered by a committed `.env`, which is what makes the same config work locally\n *    and in a pipeline.\n *\n * Missing files are skipped silently: the `.local` files are gitignored and simply won't exist\n * on most machines.\n *\n * The two rules together are why this can't just be repeated `dotenv.config()` calls — dotenv\n * either never overrides (so later files lose) or always overrides (so the shell loses). Files\n * are merged first, then applied only where the environment has nothing already.\n */\nexport function loadEnvFiles(files: string[], env: NodeJS.ProcessEnv = process.env): LoadEnvFilesResult {\n  const merged: Record<string, string> = {};\n  const loaded: string[] = [];\n\n  for (const file of files) {\n    if (!existsSync(file)) continue;\n    Object.assign(merged, parse(readFileSync(file)));\n    loaded.push(file);\n  }\n\n  const applied: string[] = [];\n  for (const [key, value] of Object.entries(merged)) {\n    if (env[key] === undefined) {\n      env[key] = value;\n      applied.push(key);\n    }\n  }\n\n  return { loaded, applied };\n}\n\n/**\n * The standard cascade for an environment, following the convention used by Vite/CRA/Next:\n * a committed base, a gitignored base override, then the same pair for the specific environment.\n * Keep secrets in the `.local` files — they are gitignored; `.env` / `.env.<environment>` are not.\n */\nexport function defaultEnvFiles(environment: string): string[] {\n  return [\".env\", \".env.local\", `.env.${environment}`, `.env.${environment}.local`];\n}\n","import type { AppConfig } from \"../config/schema.js\";\n\nexport type PlaywrightReporterEntry = [string] | [string, Record<string, unknown>];\n\n/**\n * Builds the `reporter` array for a project's `playwright.config.ts`. Always includes\n * the built-in HTML reporter; adds Allure when `reporting.allureEnabled` is true.\n *\n * Allure is optional and NOT bundled transitively: because Playwright resolves reporter\n * packages relative to the project that runs the tests, a project enabling Allure must add\n * `allure-playwright` (and `allure-js-commons` if using manual annotations) to its own\n * `devDependencies`. See `docs/EXTENDING.md`.\n */\nexport function buildReporterConfig(config: Pick<AppConfig, \"reporting\">): PlaywrightReporterEntry[] {\n  const reporters: PlaywrightReporterEntry[] = [[\"html\", { open: \"never\" }]];\n  if (config.reporting.allureEnabled) {\n    reporters.push([\"allure-playwright\", { resultsDir: config.reporting.resultsDir, detail: true }]);\n  }\n  return reporters;\n}\n","import { devices, type PlaywrightTestConfig } from \"@playwright/test\";\nimport { buildReporterConfig } from \"../reporting/allure-setup.js\";\nimport { deepMerge } from \"../utils/deep-merge.js\";\nimport { defaultEnvFiles, loadEnvFiles } from \"./env.js\";\nimport { loadConfig } from \"./loader.js\";\nimport type { AppConfig } from \"./schema.js\";\nimport type { DeepPartial } from \"./types.js\";\n\nexport type BrowserName = \"chromium\" | \"firefox\" | \"webkit\";\n\nexport interface DefineE2EConfigOptions {\n  /**\n   * Project-specific config overrides merged on top of the env-derived values.\n   * Pass a FUNCTION if the overrides read `process.env` — it is called after the env files are\n   * loaded, whereas an object literal in a `playwright.config.ts` import would be evaluated\n   * before them.\n   */\n  configOverrides?: DeepPartial<AppConfig> | (() => DeepPartial<AppConfig>);\n  /**\n   * Environment to use when `TEST_ENV` isn't set. Defaults to `\"dev\"`. Set it for apps that\n   * only have one environment (e.g. `\"staging\"`) so nobody has to export `TEST_ENV` by hand.\n   */\n  defaultEnvironment?: string;\n  /**\n   * Env files to load. Defaults to the standard cascade for the resolved environment:\n   * `.env`, `.env.local`, `.env.<environment>`, `.env.<environment>.local` — later files win,\n   * but real environment variables always win over files. Pass an explicit list to take full\n   * control, or `false` to load none.\n   */\n  envFile?: string | string[] | false;\n  /** Defaults to `./tests`. */\n  testDir?: string;\n  /** Browser projects to generate. Defaults to `[\"chromium\"]`. */\n  browsers?: BrowserName[];\n  /** Path to a global setup module (see `buildGlobalSetup`). */\n  globalSetup?: string;\n  globalTeardown?: string;\n  /**\n   * Deep-merged over everything generated here — the escape hatch for any Playwright option\n   * core doesn't model. Anything set here wins.\n   */\n  playwright?: PlaywrightTestConfig;\n}\n\nfunction resolveEnvFiles(options: DefineE2EConfigOptions, environment: string): string[] {\n  if (options.envFile === false) return [];\n  if (typeof options.envFile === \"string\") return [options.envFile];\n  if (Array.isArray(options.envFile)) return options.envFile;\n  return defaultEnvFiles(environment);\n}\n\n/**\n * Builds a project's `playwright.config.ts` from its `AppConfig`, so each project doesn't\n * re-implement the same env-loading + config-plumbing boilerplate.\n *\n * Order matters and is handled here: env files are loaded FIRST, then `configOverrides` is\n * evaluated (hence the function form), then the config is validated, then the Playwright config\n * is assembled from it.\n *\n * ```ts\n * // playwright.config.ts\n * import { defineE2EConfig } from \"@emesoft_company/playwright-core/config\";\n * export default defineE2EConfig();\n * ```\n */\nexport function defineE2EConfig(options: DefineE2EConfigOptions = {}): PlaywrightTestConfig {\n  const environment = process.env.TEST_ENV ?? options.defaultEnvironment ?? \"dev\";\n  loadEnvFiles(resolveEnvFiles(options, environment));\n\n  const overrides =\n    typeof options.configOverrides === \"function\" ? options.configOverrides() : options.configOverrides;\n  // The resolved environment is a base, not an override: an explicit `environment` in the\n  // project's own overrides still wins.\n  const appConfig = loadConfig({ overrides: deepMerge({ environment }, overrides) });\n\n  const browsers = options.browsers ?? [\"chromium\"];\n  const deviceByBrowser: Record<BrowserName, string> = {\n    chromium: \"Desktop Chrome\",\n    firefox: \"Desktop Firefox\",\n    webkit: \"Desktop Safari\",\n  };\n\n  const generated: PlaywrightTestConfig = {\n    testDir: options.testDir ?? \"./tests\",\n    fullyParallel: true,\n    retries: appConfig.retry.retries,\n    timeout: appConfig.timeouts.testMs,\n    reporter: buildReporterConfig(appConfig),\n    // `globalSetup` is only wired when a path is given AND a storage state path is configured —\n    // otherwise a project that hasn't set up login yet would fail on every run.\n    ...(options.globalSetup && appConfig.auth.storageStatePath\n      ? { globalSetup: options.globalSetup }\n      : {}),\n    ...(options.globalTeardown ? { globalTeardown: options.globalTeardown } : {}),\n    use: {\n      baseURL: appConfig.baseUrl,\n      actionTimeout: appConfig.timeouts.actionMs,\n      navigationTimeout: appConfig.timeouts.navigationMs,\n      trace: \"on-first-retry\",\n      screenshot: \"only-on-failure\",\n      ...(options.globalSetup && appConfig.auth.storageStatePath\n        ? { storageState: appConfig.auth.storageStatePath }\n        : {}),\n    },\n    projects: browsers.map((browser) => ({\n      name: browser,\n      use: { ...devices[deviceByBrowser[browser]] },\n    })),\n  };\n\n  return deepMerge(generated, options.playwright);\n}\n"]}

package/dist/config/index.d.cts

@@ -0,0 +1,105 @@
+import { A as AppConfig } from '../schema-y5w2hbT-.cjs';
+export { a as AppConfigSchema, b as AuthConfig, c as AuthConfigSchema, D as DiagnosticsConfig, d as DiagnosticsConfigSchema, E as Environment, e as EnvironmentSchema, K as KNOWN_ENVIRONMENTS, R as ReportingConfig, f as ReportingConfigSchema, g as RetryConfig, h as RetryConfigSchema, T as TimeoutsConfig, i as TimeoutsSchema } from '../schema-y5w2hbT-.cjs';
+import { D as DeepPartial } from '../types-CbWnSYEK.cjs';
+import { PlaywrightTestConfig } from '@playwright/test';
+import 'zod';
+
+/**
+ * Reads a required environment variable, failing immediately with a clear message instead of
+ * letting an `undefined` surface as a confusing failure deep inside a test.
+ */
+declare function requireEnv(name: string, env?: NodeJS.ProcessEnv): string;
+interface LoadConfigOptions {
+    /** Defaults to `process.env`. */
+    env?: NodeJS.ProcessEnv;
+    /** Project-specific overrides (e.g. from a project's `config.override.ts`), merged on top of env-derived values. */
+    overrides?: DeepPartial<AppConfig>;
+}
+/**
+ * Loads and validates the application config for the current environment.
+ * Resolution order: env-derived defaults -> project `overrides` -> zod validation.
+ * Fails fast with `ConfigValidationError` when required fields (e.g. `baseUrl`) are missing/invalid,
+ * instead of letting tests fail later with a confusing `undefined` somewhere downstream.
+ */
+declare function loadConfig(options?: LoadConfigOptions): AppConfig;
+
+interface LoadEnvFilesResult {
+    /** Files that existed and were read, in the order they were applied. */
+    loaded: string[];
+    /** Variable names actually written to the environment. */
+    applied: string[];
+}
+/**
+ * Loads several env files with predictable precedence:
+ *
+ * 1. **Later files beat earlier ones** — so `.env.staging.local` overrides `.env.staging`.
+ * 2. **Real environment variables beat every file** — a `BASE_URL` exported by CI or the shell
+ *    is never clobbered by a committed `.env`, which is what makes the same config work locally
+ *    and in a pipeline.
+ *
+ * Missing files are skipped silently: the `.local` files are gitignored and simply won't exist
+ * on most machines.
+ *
+ * The two rules together are why this can't just be repeated `dotenv.config()` calls — dotenv
+ * either never overrides (so later files lose) or always overrides (so the shell loses). Files
+ * are merged first, then applied only where the environment has nothing already.
+ */
+declare function loadEnvFiles(files: string[], env?: NodeJS.ProcessEnv): LoadEnvFilesResult;
+/**
+ * The standard cascade for an environment, following the convention used by Vite/CRA/Next:
+ * a committed base, a gitignored base override, then the same pair for the specific environment.
+ * Keep secrets in the `.local` files — they are gitignored; `.env` / `.env.<environment>` are not.
+ */
+declare function defaultEnvFiles(environment: string): string[];
+
+type BrowserName = "chromium" | "firefox" | "webkit";
+interface DefineE2EConfigOptions {
+    /**
+     * Project-specific config overrides merged on top of the env-derived values.
+     * Pass a FUNCTION if the overrides read `process.env` — it is called after the env files are
+     * loaded, whereas an object literal in a `playwright.config.ts` import would be evaluated
+     * before them.
+     */
+    configOverrides?: DeepPartial<AppConfig> | (() => DeepPartial<AppConfig>);
+    /**
+     * Environment to use when `TEST_ENV` isn't set. Defaults to `"dev"`. Set it for apps that
+     * only have one environment (e.g. `"staging"`) so nobody has to export `TEST_ENV` by hand.
+     */
+    defaultEnvironment?: string;
+    /**
+     * Env files to load. Defaults to the standard cascade for the resolved environment:
+     * `.env`, `.env.local`, `.env.<environment>`, `.env.<environment>.local` — later files win,
+     * but real environment variables always win over files. Pass an explicit list to take full
+     * control, or `false` to load none.
+     */
+    envFile?: string | string[] | false;
+    /** Defaults to `./tests`. */
+    testDir?: string;
+    /** Browser projects to generate. Defaults to `["chromium"]`. */
+    browsers?: BrowserName[];
+    /** Path to a global setup module (see `buildGlobalSetup`). */
+    globalSetup?: string;
+    globalTeardown?: string;
+    /**
+     * Deep-merged over everything generated here — the escape hatch for any Playwright option
+     * core doesn't model. Anything set here wins.
+     */
+    playwright?: PlaywrightTestConfig;
+}
+/**
+ * Builds a project's `playwright.config.ts` from its `AppConfig`, so each project doesn't
+ * re-implement the same env-loading + config-plumbing boilerplate.
+ *
+ * Order matters and is handled here: env files are loaded FIRST, then `configOverrides` is
+ * evaluated (hence the function form), then the config is validated, then the Playwright config
+ * is assembled from it.
+ *
+ * ```ts
+ * // playwright.config.ts
+ * import { defineE2EConfig } from "@emesoft_company/playwright-core/config";
+ * export default defineE2EConfig();
+ * ```
+ */
+declare function defineE2EConfig(options?: DefineE2EConfigOptions): PlaywrightTestConfig;
+
+export { AppConfig, type BrowserName, DeepPartial, type DefineE2EConfigOptions, type LoadConfigOptions, type LoadEnvFilesResult, defaultEnvFiles, defineE2EConfig, loadConfig, loadEnvFiles, requireEnv };

package/dist/config/index.d.ts

@@ -0,0 +1,105 @@
+import { A as AppConfig } from '../schema-y5w2hbT-.js';
+export { a as AppConfigSchema, b as AuthConfig, c as AuthConfigSchema, D as DiagnosticsConfig, d as DiagnosticsConfigSchema, E as Environment, e as EnvironmentSchema, K as KNOWN_ENVIRONMENTS, R as ReportingConfig, f as ReportingConfigSchema, g as RetryConfig, h as RetryConfigSchema, T as TimeoutsConfig, i as TimeoutsSchema } from '../schema-y5w2hbT-.js';
+import { D as DeepPartial } from '../types-CbWnSYEK.js';
+import { PlaywrightTestConfig } from '@playwright/test';
+import 'zod';
+
+/**
+ * Reads a required environment variable, failing immediately with a clear message instead of
+ * letting an `undefined` surface as a confusing failure deep inside a test.
+ */
+declare function requireEnv(name: string, env?: NodeJS.ProcessEnv): string;
+interface LoadConfigOptions {
+    /** Defaults to `process.env`. */
+    env?: NodeJS.ProcessEnv;
+    /** Project-specific overrides (e.g. from a project's `config.override.ts`), merged on top of env-derived values. */
+    overrides?: DeepPartial<AppConfig>;
+}
+/**
+ * Loads and validates the application config for the current environment.
+ * Resolution order: env-derived defaults -> project `overrides` -> zod validation.
+ * Fails fast with `ConfigValidationError` when required fields (e.g. `baseUrl`) are missing/invalid,
+ * instead of letting tests fail later with a confusing `undefined` somewhere downstream.
+ */
+declare function loadConfig(options?: LoadConfigOptions): AppConfig;
+
+interface LoadEnvFilesResult {
+    /** Files that existed and were read, in the order they were applied. */
+    loaded: string[];
+    /** Variable names actually written to the environment. */
+    applied: string[];
+}
+/**
+ * Loads several env files with predictable precedence:
+ *
+ * 1. **Later files beat earlier ones** — so `.env.staging.local` overrides `.env.staging`.
+ * 2. **Real environment variables beat every file** — a `BASE_URL` exported by CI or the shell
+ *    is never clobbered by a committed `.env`, which is what makes the same config work locally
+ *    and in a pipeline.
+ *
+ * Missing files are skipped silently: the `.local` files are gitignored and simply won't exist
+ * on most machines.
+ *
+ * The two rules together are why this can't just be repeated `dotenv.config()` calls — dotenv
+ * either never overrides (so later files lose) or always overrides (so the shell loses). Files
+ * are merged first, then applied only where the environment has nothing already.
+ */
+declare function loadEnvFiles(files: string[], env?: NodeJS.ProcessEnv): LoadEnvFilesResult;
+/**
+ * The standard cascade for an environment, following the convention used by Vite/CRA/Next:
+ * a committed base, a gitignored base override, then the same pair for the specific environment.
+ * Keep secrets in the `.local` files — they are gitignored; `.env` / `.env.<environment>` are not.
+ */
+declare function defaultEnvFiles(environment: string): string[];
+
+type BrowserName = "chromium" | "firefox" | "webkit";
+interface DefineE2EConfigOptions {
+    /**
+     * Project-specific config overrides merged on top of the env-derived values.
+     * Pass a FUNCTION if the overrides read `process.env` — it is called after the env files are
+     * loaded, whereas an object literal in a `playwright.config.ts` import would be evaluated
+     * before them.
+     */
+    configOverrides?: DeepPartial<AppConfig> | (() => DeepPartial<AppConfig>);
+    /**
+     * Environment to use when `TEST_ENV` isn't set. Defaults to `"dev"`. Set it for apps that
+     * only have one environment (e.g. `"staging"`) so nobody has to export `TEST_ENV` by hand.
+     */
+    defaultEnvironment?: string;
+    /**
+     * Env files to load. Defaults to the standard cascade for the resolved environment:
+     * `.env`, `.env.local`, `.env.<environment>`, `.env.<environment>.local` — later files win,
+     * but real environment variables always win over files. Pass an explicit list to take full
+     * control, or `false` to load none.
+     */
+    envFile?: string | string[] | false;
+    /** Defaults to `./tests`. */
+    testDir?: string;
+    /** Browser projects to generate. Defaults to `["chromium"]`. */
+    browsers?: BrowserName[];
+    /** Path to a global setup module (see `buildGlobalSetup`). */
+    globalSetup?: string;
+    globalTeardown?: string;
+    /**
+     * Deep-merged over everything generated here — the escape hatch for any Playwright option
+     * core doesn't model. Anything set here wins.
+     */
+    playwright?: PlaywrightTestConfig;
+}
+/**
+ * Builds a project's `playwright.config.ts` from its `AppConfig`, so each project doesn't
+ * re-implement the same env-loading + config-plumbing boilerplate.
+ *
+ * Order matters and is handled here: env files are loaded FIRST, then `configOverrides` is
+ * evaluated (hence the function form), then the config is validated, then the Playwright config
+ * is assembled from it.
+ *
+ * ```ts
+ * // playwright.config.ts
+ * import { defineE2EConfig } from "@emesoft_company/playwright-core/config";
+ * export default defineE2EConfig();
+ * ```
+ */
+declare function defineE2EConfig(options?: DefineE2EConfigOptions): PlaywrightTestConfig;
+
+export { AppConfig, type BrowserName, DeepPartial, type DefineE2EConfigOptions, type LoadConfigOptions, type LoadEnvFilesResult, defaultEnvFiles, defineE2EConfig, loadConfig, loadEnvFiles, requireEnv };