@e2edev/e2e 0.2.0

package/dist/config/load.js

@@ -0,0 +1,75 @@
+/** Config discovery and ESM/TypeScript loading (spec 05-config.md). */
+import { existsSync } from 'node:fs';
+import path from 'node:path';
+import { pathToFileURL } from 'node:url';
+import { register } from 'tsx/esm/api';
+import { ConfigurationError } from '../internal/errors.js';
+const CONFIG_NAMES = ['e2e.config.ts', 'e2e.config.mts'];
+/**
+ * Discovers the config file. With `--config` the explicit path wins. Otherwise
+ * the search starts at cwd and inspects each parent, stopping after the
+ * repository root. The selected file's directory is the project root.
+ */
+export function discoverConfig(cwd, explicitPath) {
+    if (explicitPath !== undefined) {
+        const absolute = path.resolve(cwd, explicitPath);
+        if (!existsSync(absolute)) {
+            throw new ConfigurationError('CONFIG_NOT_FOUND', `config file not found: ${explicitPath}`);
+        }
+        return { configPath: absolute, projectRoot: path.dirname(absolute) };
+    }
+    let dir = path.resolve(cwd);
+    for (;;) {
+        const present = CONFIG_NAMES.filter((name) => existsSync(path.join(dir, name)));
+        if (present.length > 1) {
+            throw new ConfigurationError('CONFIG_AMBIGUOUS', `found both ${present.join(' and ')} in ${dir}`);
+        }
+        const name = present[0];
+        if (name !== undefined) {
+            return { configPath: path.join(dir, name), projectRoot: dir };
+        }
+        const isRepoRoot = existsSync(path.join(dir, '.git'));
+        const parent = path.dirname(dir);
+        if (isRepoRoot || parent === dir)
+            break;
+        dir = parent;
+    }
+    return { configPath: undefined, projectRoot: path.resolve(cwd) };
+}
+/**
+ * The process-wide TypeScript loader, registered on first use. `tsImport`
+ * would register a fresh, never-removed loader hook per call - once per
+ * collected file and once per realm, so every import would slow every later
+ * one. One namespaced registration serves them all.
+ */
+let loader;
+let imports = 0;
+/**
+ * Imports a TypeScript/ESM module with erasable-syntax support. Every call
+ * evaluates the module afresh: the query carries the caller's key (what the
+ * instance is for) plus a process-unique sequence, so a realm never receives
+ * another realm's module instance and a second `run()` in one process sees
+ * the config file as it is now.
+ */
+export async function importModule(absolutePath, cacheKey = 'module') {
+    imports += 1;
+    const url = `${pathToFileURL(absolutePath).href}?e2e=${cacheKey}-${imports}`;
+    loader ??= register({ namespace: 'e2e' });
+    return loader.import(url, import.meta.url);
+}
+/** Loads and returns the raw default export of a config module. */
+export async function loadConfigModule(configPath) {
+    let moduleValue;
+    try {
+        moduleValue = await importModule(configPath);
+    }
+    catch (cause) {
+        throw new ConfigurationError('CONFIG_LOAD_FAILED', `failed to load config ${configPath}: ${cause instanceof Error ? cause.message : String(cause)}`, { cause });
+    }
+    const defaultExport = moduleValue.default;
+    if (typeof defaultExport !== 'object' || defaultExport === null) {
+        throw new ConfigurationError('INVALID_CONFIG', `config ${configPath} must default-export the object returned by defineConfig()`);
+    }
+    return defaultExport;
+}
+//# sourceMappingURL=load.js.map

package/dist/config/load.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load.js","sourceRoot":"","sources":["../../src/config/load.ts"],"names":[],"mappings":"AAAA,uEAAuE;AAEvE,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,QAAQ,EAA6B,MAAM,aAAa,CAAC;AAClE,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAG3D,MAAM,YAAY,GAAG,CAAC,eAAe,EAAE,gBAAgB,CAAU,CAAC;AAOlE;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,GAAW,EAAE,YAAqB;IAC/D,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;QAC/B,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;QACjD,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,kBAAkB,CAAC,kBAAkB,EAAE,0BAA0B,YAAY,EAAE,CAAC,CAAC;QAC7F,CAAC;QACD,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,WAAW,EAAE,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;IACvE,CAAC;IACD,IAAI,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC5B,SAAS,CAAC;QACR,MAAM,OAAO,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;QAChF,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,kBAAkB,CAC1B,kBAAkB,EAClB,cAAc,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,GAAG,EAAE,CAChD,CAAC;QACJ,CAAC;QACD,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;QACxB,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,OAAO,EAAE,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,WAAW,EAAE,GAAG,EAAE,CAAC;QAChE,CAAC;QACD,MAAM,UAAU,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC;QACtD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,UAAU,IAAI,MAAM,KAAK,GAAG;YAAE,MAAM;QACxC,GAAG,GAAG,MAAM,CAAC;IACf,CAAC;IACD,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;AACnE,CAAC;AAED;;;;;GAKG;AACH,IAAI,MAAwC,CAAC;AAC7C,IAAI,OAAO,GAAG,CAAC,CAAC;AAEhB;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,YAAoB,EAAE,QAAQ,GAAG,QAAQ;IAC1E,OAAO,IAAI,CAAC,CAAC;IACb,MAAM,GAAG,GAAG,GAAG,aAAa,CAAC,YAAY,CAAC,CAAC,IAAI,QAAQ,QAAQ,IAAI,OAAO,EAAE,CAAC;IAC7E,MAAM,KAAK,QAAQ,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;IAC1C,OAAO,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;AAC7C,CAAC;AAED,mEAAmE;AACnE,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,UAAkB;IACvD,IAAI,WAAoB,CAAC;IACzB,IAAI,CAAC;QACH,WAAW,GAAG,MAAM,YAAY,CAAC,UAAU,CAAC,CAAC;IAC/C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,kBAAkB,CAC1B,oBAAoB,EACpB,yBAAyB,UAAU,KAAK,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAChG,EAAE,KAAK,EAAE,CACV,CAAC;IACJ,CAAC;IACD,MAAM,aAAa,GAAI,WAAqC,CAAC,OAAO,CAAC;IACrE,IAAI,OAAO,aAAa,KAAK,QAAQ,IAAI,aAAa,KAAK,IAAI,EAAE,CAAC;QAChE,MAAM,IAAI,kBAAkB,CAC1B,gBAAgB,EAChB,UAAU,UAAU,4DAA4D,CACjF,CAAC;IACJ,CAAC;IACD,OAAO,aAA0B,CAAC;AACpC,CAAC"}

package/dist/config/resolve.d.ts

@@ -0,0 +1,94 @@
+/** Config validation, defaults, and resolution (spec 05-config.md). */
+import { type NormalizedBaseUrl } from '../internal/urls.ts';
+import type { ArtifactStore, CacheMode, CommandConfig, E2EConfig, Platform, SecretProvider, TraceCacheStore } from '../types.ts';
+import { type BackendHandle } from '../backend/index.ts';
+import { type ResolvedAgentConfig, type ResolvedLimits } from './agent.ts';
+export type { ResolvedAgentConfig, ResolvedLimits } from './agent.ts';
+export interface ResolvedTarget {
+    readonly name: string;
+    readonly index: number;
+    readonly platform: Platform;
+    /** Validated backend; undefined for an agent-tools-only target. */
+    readonly backend: BackendHandle | undefined;
+}
+export interface ResolvedCredential {
+    readonly name: string;
+    readonly username: string;
+    /** A static value, or a provider resolved fresh on every authorized fill. */
+    readonly password: string | SecretProvider;
+    readonly allowedOrigins: readonly string[] | undefined;
+}
+export interface ResolvedConfig {
+    readonly specVersion: '0.1';
+    readonly projectId: string;
+    readonly projectRoot: string;
+    readonly configPath: string | undefined;
+    readonly ci: boolean;
+    readonly app: {
+        /** False when no app URL was configured and `base` is a synthetic loopback placeholder. */
+        readonly configured: boolean;
+        readonly base: NormalizedBaseUrl;
+        readonly readyUrl: string;
+        readonly allowedOrigins: readonly string[];
+        readonly environment: 'test' | 'staging' | 'production';
+        readonly allowProduction: boolean;
+        readonly command: CommandConfig | undefined;
+        /** Stable logical app identity; overrides the origin for cache/session keying. */
+        readonly identity: string | undefined;
+    };
+    readonly targets: readonly ResolvedTarget[];
+    readonly tests: readonly string[];
+    readonly timeout: number;
+    readonly launchTimeout: number;
+    readonly actionTimeout: number;
+    readonly assertionTimeout: number;
+    readonly cleanupTimeout: number;
+    readonly retries: number;
+    readonly workers: number;
+    readonly artifacts: readonly ('trace' | 'screenshot')[];
+    /** True when artifact kinds were set in config, so a backend that cannot produce one is an error. */
+    readonly artifactsExplicit: boolean;
+    /** Host store every produced artifact is handed to; undefined keeps files local only. */
+    readonly artifactStore: ArtifactStore | undefined;
+    readonly reporters: readonly ('list' | 'json')[];
+    readonly testIdAttribute: string;
+    readonly agent: ResolvedAgentConfig;
+    readonly cache: ResolvedCacheConfig;
+    readonly limits: ResolvedLimits;
+    readonly credentials: ReadonlyMap<string, ResolvedCredential>;
+    readonly configDigest: string;
+}
+/**
+ * The resolved trace cache posture. Like executors and model instances, a
+ * custom store never crosses a process boundary: workers re-resolve the
+ * config module and construct their own.
+ */
+export interface ResolvedCacheConfig {
+    readonly mode: CacheMode;
+    /** Custom entry store; undefined selects the file store at `dir`. */
+    readonly store: TraceCacheStore | undefined;
+    /** Absolute file store directory. */
+    readonly dir: string;
+}
+/**
+ * Flags that replace config keys, so workers re-resolving the config file
+ * apply them too. `--headed` and `--artifacts` are run options, not config
+ * overrides, and travel separately.
+ */
+export interface CliOverrides {
+    retries?: number;
+    workers?: number;
+    reporters?: readonly ('list' | 'json')[];
+    /** Trace cache mode override; `--no-cache` maps to `'off'`. */
+    cache?: CacheMode;
+}
+/** True when CI mode is active per 05-config.md. */
+export declare function isCiMode(env?: NodeJS.ProcessEnv): boolean;
+/** Resolves a raw config object plus environment into an immutable resolved config. */
+export declare function resolveConfig(raw: E2EConfig, options: {
+    projectRoot: string;
+    configPath?: string;
+    env?: NodeJS.ProcessEnv;
+    cli?: CliOverrides;
+}): ResolvedConfig;
+//# sourceMappingURL=resolve.d.ts.map

package/dist/config/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../src/config/resolve.ts"],"names":[],"mappings":"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"}