@e2edev/e2e 0.5.0 → 0.6.0

package/dist/config/app.js

@@ -1,142 +1,195 @@
-/** App, command, and service resolution (spec 05-config.md). */
+/**
+ * Per-target app resolution: what an engine declares
+ * about the app it drives, validated where an error can name the target.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
 import { ConfigurationError } from '../internal/errors.js';
+import { obj } from '../internal/objects.js';
 import { isImplicitTestHost, normalizeBaseUrl } from '../internal/urls.js';
 import { httpUrl, positiveInt } from './validate.js';
-const APP_KEYS = new Set([
-    'url',
-    'command',
-    'readyUrl',
-    'services',
-    'allowedOrigins',
-    'environment',
-    'identity',
-]);
-/** App keys that make sense without an app URL; every other key needs one. */
-const URL_FREE_APP_KEYS = new Set(['url', 'command', 'services']);
-export function resolveApp(raw, env) {
-    if (raw.app !== undefined) {
-        for (const key of Object.keys(raw.app)) {
-            if (!APP_KEYS.has(key)) {
-                throw new ConfigurationError('INVALID_CONFIG', `unknown app config key "${key}"`);
-            }
-        }
-    }
-    const services = resolveServices(raw.app?.services);
-    const rawUrl = raw.app?.url ?? env['APP_URL'];
-    if (rawUrl === undefined || rawUrl === '') {
-        // Not every surface has an app URL to point at (a device, a desktop
-        // shell): a synthetic loopback base keeps navigation resolution and
-        // identity digests defined, and `app.open()` fails loud with
-        // APP_URL_REQUIRED the moment a test actually needs one. A configured
-        // app command without a URL is still a mistake worth failing early on.
-        const orphaned = Object.keys(raw.app ?? {}).filter((key) => !URL_FREE_APP_KEYS.has(key));
-        if (orphaned.length > 0) {
-            throw new ConfigurationError('INVALID_CONFIG', `app.${orphaned[0]} requires app.url: set app.url in e2e.config.ts or the APP_URL environment variable`);
-        }
-        if (raw.app?.command === undefined) {
-            return {
-                configured: false,
-                base: normalizeBaseUrl('http://127.0.0.1:1'),
-                readyUrl: 'http://127.0.0.1:1/',
-                allowedOrigins: [],
-                environment: 'test',
-                command: undefined,
-                services,
-                identity: undefined,
-            };
-        }
-        throw new ConfigurationError('APP_URL_REQUIRED', 'an app URL is required alongside app.command: set app.url in e2e.config.ts or the APP_URL environment variable');
+const ENVIRONMENTS = new Set(['test', 'staging', 'production']);
+/**
+ * Resolves one target's app from its engine's `app` declaration. Every fact
+ * is optional: a URL normalizes like any base URL, origins must be serialized
+ * origins, a command needs something to poll, services need one readiness
+ * contract each, and the identity defaults to where the app is served when
+ * the engine gives none. `projectRoot` anchors every command's `log` path.
+ */
+export function resolveTargetApp(targetName, engine, projectRoot) {
+    const declared = engine?.app ?? {};
+    const where = `target "${targetName}" engine ${engine?.name ?? 'none'}`;
+    const base = declared.url === undefined ? undefined : normalizeBaseUrl(declared.url);
+    const environment = declared.environment ??
+        (base !== undefined && !isImplicitTestHost(new URL(base.href).hostname) ? 'production' : 'test');
+    if (!ENVIRONMENTS.has(environment)) {
+        throw new ConfigurationError('INVALID_CONFIG', `${where} declares invalid app.environment "${String(environment)}"`);
     }
-    const base = normalizeBaseUrl(rawUrl);
-    const baseHost = new URL(base.href).hostname;
-    // The environment is a label for the report and the cache/session identity
-    // digest, not a gate: a loopback, `.localhost`, or `.test` host is `test`,
-    // any other host is `production` unless the config says otherwise.
-    const environment = raw.app?.environment ?? (isImplicitTestHost(baseHost) ? 'test' : 'production');
-    if (!['test', 'staging', 'production'].includes(environment)) {
-        throw new ConfigurationError('INVALID_CONFIG', `invalid app.environment "${environment}"`);
+    const allowedOrigins = declared.allowedOrigins ?? (base === undefined ? [] : [base.origin]);
+    if (!Array.isArray(allowedOrigins)) {
+        throw new ConfigurationError('INVALID_CONFIG', `${where} app.allowedOrigins must be an array`);
     }
-    const allowedOrigins = raw.app?.allowedOrigins ?? [base.origin];
     for (const origin of allowedOrigins) {
         let parsed;
         try {
             parsed = new URL(origin);
         }
         catch {
-            throw new ConfigurationError('INVALID_CONFIG', `invalid allowed origin: ${origin}`);
+            throw new ConfigurationError('INVALID_CONFIG', `${where} declares an invalid allowed origin: ${origin}`);
         }
         if (parsed.origin !== origin) {
-            throw new ConfigurationError('INVALID_CONFIG', `allowed origin must be a serialized origin, got ${origin} (expected ${parsed.origin})`);
+            throw new ConfigurationError('INVALID_CONFIG', `${where} allowed origin must be a serialized origin, got ${origin} (expected ${parsed.origin})`);
         }
     }
-    const command = raw.app?.command;
-    if (command !== undefined)
-        validateCommand(command, 'app.command');
-    const identity = raw.app?.identity;
+    const identity = declared.identity;
     if (identity !== undefined && (typeof identity !== 'string' || identity.trim() === '')) {
-        throw new ConfigurationError('INVALID_CONFIG', 'app.identity must be a non-empty string');
+        throw new ConfigurationError('INVALID_CONFIG', `${where} app.identity must be a non-empty string`);
+    }
+    const command = declared.command;
+    if (command !== undefined)
+        validateCommand(command, `${where} app.command`, projectRoot);
+    const readyUrl = httpUrl(declared.readyUrl, `${where} app.readyUrl`) ?? base?.href;
+    if (command !== undefined && readyUrl === undefined) {
+        throw new ConfigurationError('APP_URL_REQUIRED', `${where} declares app.command without a URL to poll: declare url or readyUrl beside it`);
     }
     return {
-        configured: true,
         base,
-        readyUrl: httpUrl(raw.app?.readyUrl, 'app.readyUrl') ?? base.href,
         allowedOrigins,
         environment,
+        identity: identity ?? (base === undefined ? undefined : `${base.origin}${base.basePath}`),
         command,
-        services,
-        identity,
+        readyUrl: command === undefined ? undefined : readyUrl,
+        services: resolveServices(declared.services, projectRoot, `${where} app.services`),
     };
 }
 /**
- * The shape every spawned command shares: a non-empty executable and, when
- * set, positive integer timeouts. A NaN or infinite budget would otherwise
- * make the readiness loop spin without a deadline.
+ * The shape every spawned command shares: a non-empty executable, when set
+ * positive integer timeouts, and when set a `log` path inside the project
+ * root. A NaN or infinite budget would otherwise make the readiness loop spin
+ * without a deadline; a log outside the root would let config write anywhere.
  */
-function validateCommand(command, label) {
+function validateCommand(command, label, projectRoot) {
     if (typeof command !== 'object' || command === null) {
         throw new ConfigurationError('INVALID_CONFIG', `${label} must be an object`);
     }
     if (typeof command.executable !== 'string' || command.executable.length === 0) {
         throw new ConfigurationError('INVALID_CONFIG', `${label}.executable is required`);
     }
-    positiveInt(command.startupTimeout, `${label}.startupTimeout`);
-    positiveInt(command.shutdownTimeout, `${label}.shutdownTimeout`);
+    positiveInt(command.startupTimeout, `${label}.startupTimeout`, 'milliseconds');
+    positiveInt(command.shutdownTimeout, `${label}.shutdownTimeout`, 'milliseconds');
+    if (command.log !== undefined) {
+        if (typeof command.log !== 'string' || command.log.trim() === '') {
+            throw new ConfigurationError('INVALID_CONFIG', `${label}.log must be a non-empty path`);
+        }
+        if (!insideProjectRoot(projectRoot, path.resolve(projectRoot, command.log))) {
+            throw new ConfigurationError('INVALID_CONFIG', `${label}.log must be a file inside the project root, got ${JSON.stringify(command.log)}`);
+        }
+    }
+    if (command.reuseExisting !== undefined && typeof command.reuseExisting !== 'boolean') {
+        throw new ConfigurationError('INVALID_CONFIG', `${label}.reuseExisting must be a boolean`);
+    }
+}
+/** Only a command with a URL to probe can find something already answering there. */
+function rejectReuse(command, label, reason) {
+    if (command.reuseExisting !== undefined) {
+        throw new ConfigurationError('INVALID_CONFIG', `${label}.reuseExisting needs readyUrl: ${reason}`);
+    }
+}
+/**
+ * `target` with the symlinks of its deepest existing ancestor resolved and the
+ * missing tail appended as written. A log file usually does not exist yet,
+ * but the directory a symlink points at does, so this is what the runner
+ * would actually open.
+ */
+function realpathOfExisting(target) {
+    const tail = [];
+    let current = target;
+    for (;;) {
+        try {
+            return path.join(fs.realpathSync(current), ...tail);
+        }
+        catch {
+            const parent = path.dirname(current);
+            if (parent === current)
+                return target;
+            tail.unshift(path.basename(current));
+            current = parent;
+        }
+    }
 }
-/** Services carry no name, so messages name one by its position and command line. */
-function commandLine(command) {
-    return [command.executable, ...(command.args ?? [])].join(' ');
+/**
+ * Whether `target` is a path strictly below the project root once both are
+ * resolved through the filesystem: an in-project symlink pointing outside is
+ * rejected, a symlinked project root still counts as the root, and a name
+ * that merely starts with `..` (`..logs/out.log`) is an ordinary entry.
+ */
+function insideProjectRoot(projectRoot, target) {
+    const relative = path.relative(realpathOfExisting(projectRoot), realpathOfExisting(target));
+    return (relative !== '' &&
+        relative !== '..' &&
+        !relative.startsWith(`..${path.sep}`) &&
+        !path.isAbsolute(relative));
+}
+/** The longest `name` a service may carry; a label, not a description. */
+const SERVICE_NAME_MAX_LENGTH = 64;
+/**
+ * The name a service goes by in errors, reporter output, and the report: the
+ * explicit `name`, trimmed, or the executable's base name (`docker`, `pnpm`,
+ * and for a shell wrapper just `sh`, which is when an explicit name earns its
+ * keep). Explicit names must be unique so two failures never read alike.
+ */
+function serviceName(service, position, taken) {
+    if (service.name === undefined)
+        return path.basename(service.executable);
+    const name = typeof service.name === 'string' ? service.name.trim() : '';
+    if (name.length === 0 || name.length > SERVICE_NAME_MAX_LENGTH) {
+        throw new ConfigurationError('INVALID_CONFIG', `${position}.name must be a non-empty string of at most ${SERVICE_NAME_MAX_LENGTH} characters`);
+    }
+    if (taken.has(name)) {
+        throw new ConfigurationError('INVALID_CONFIG', `${position}.name "${name}" is already used by another service; service names must be unique`);
+    }
+    taken.add(name);
+    return name;
 }
 /**
- * Resolves `app.services`: every service is a command with exactly one
- * readiness contract (`readyUrl` or `waitForExit`), and a `teardown` is a
+ * Resolves a declaration's `services`: every service is a command with exactly
+ * one readiness contract (`readyUrl` or `waitForExit`), and a `teardown` is a
  * command of its own. The service fields that only steer the runner
- * (`readyUrl`, `waitForExit`, `teardown`) are lifted out of the command.
+ * (`name`, `readyUrl`, `waitForExit`, `teardown`) are lifted out of the
+ * command; `reuseExisting` stays on it, and only a `readyUrl` service may set it.
+ * `projectRoot` anchors each `log` path; `prefix` names the declaring target
+ * in errors, so a failing service is traceable to the engine that declared it.
  */
-export function resolveServices(raw) {
+export function resolveServices(raw, projectRoot, prefix = 'app.services') {
     if (raw === undefined)
         return [];
     if (!Array.isArray(raw)) {
-        throw new ConfigurationError('INVALID_CONFIG', 'app.services must be an array');
+        throw new ConfigurationError('INVALID_CONFIG', `${prefix} must be an array`);
     }
+    const names = new Set();
     return raw.map((service, index) => {
-        const position = `app.services[${index}]`;
-        validateCommand(service, position);
-        const { readyUrl: rawReadyUrl, waitForExit, teardown, ...command } = service;
+        const position = `${prefix}[${index}]`;
+        validateCommand(service, position, projectRoot);
+        const { name: _name, readyUrl: rawReadyUrl, waitForExit, teardown, ...command } = service;
         const readyUrl = httpUrl(rawReadyUrl, `${position}.readyUrl`);
         if ((readyUrl !== undefined) === (waitForExit === true)) {
             throw new ConfigurationError('INVALID_CONFIG', `${position} needs exactly one readiness contract: set readyUrl or waitForExit: true`);
         }
         const readiness = readyUrl === undefined ? { waitForExit: true } : { readyUrl };
-        const label = `${position} (${commandLine(command)})`;
-        if (teardown !== undefined)
-            validateCommand(teardown, `${position}.teardown`);
+        if (readyUrl === undefined)
+            rejectReuse(command, position, 'a waitForExit service has nothing to reuse');
+        const name = serviceName(service, position, names);
+        const label = `service "${name}"`;
+        if (teardown !== undefined) {
+            validateCommand(teardown, `${position}.teardown`, projectRoot);
+            rejectReuse(teardown, `${position}.teardown`, 'a teardown command has nothing to reuse');
+        }
         return {
             label,
+            name: service.name === undefined ? undefined : name,
             command,
             readiness,
-            teardown: teardown === undefined
-                ? undefined
-                : { label: `${label} teardown (${commandLine(teardown)})`, command: teardown },
+            teardown: teardown === undefined ? undefined : { label: `${label} teardown`, command: teardown },
         };
     });
 }
@@ -147,22 +200,24 @@ function digestCommand(command) {
     return { ...rest, env: Object.fromEntries(Object.keys(env).map((key) => [key, { envName: key }])) };
 }
 /**
- * The digest view of `app`: `app.command.env`, every service's env, and every
- * service teardown's env become names, so no environment value contributes to
- * the digest. Live values never appear under `app`, so nothing else changes.
+ * The declarative part of an engine's `app` manifest as it enters the config
+ * digest: hooks stripped, and every `command.env`, service env, and service
+ * teardown env value replaced by `{ envName: key }`, so no environment value
+ * contributes to the digest.
  */
-export function digestApp(app) {
-    return {
-        ...app,
-        ...(app.command === undefined ? {} : { command: digestCommand(app.command) }),
-        ...(app.services === undefined
-            ? {}
-            : {
-                services: app.services.map(({ teardown, ...service }) => ({
-                    ...digestCommand(service),
-                    ...(teardown === undefined ? {} : { teardown: digestCommand(teardown) }),
-                })),
-            }),
-    };
+export function digestAppDeclaration(app) {
+    const { url, allowedOrigins, environment, identity, command, readyUrl, services } = app;
+    return obj({
+        url,
+        allowedOrigins,
+        environment,
+        identity,
+        readyUrl,
+        command: command === undefined ? undefined : digestCommand(command),
+        services: services?.map(({ teardown, ...service }) => obj({
+            ...digestCommand(service),
+            teardown: teardown === undefined ? undefined : digestCommand(teardown),
+        })),
+    });
 }
 //# sourceMappingURL=app.js.map

package/dist/config/app.js.map

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

package/dist/config/diagnose.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Turns a module loading failure into a sentence that names the fix. The
+ * loader's own messages are accurate but stop at the symptom: a missing
+ * package reads the same whether it was never added or just not installed,
+ * and a removed export looks like a typo.
+ */
+/** The runtime exports of `@e2edev/e2e`; a unit test keeps this list equal to the real module. */
+export declare const RUNTIME_EXPORTS: readonly string[];
+/**
+ * The message of a failed import of `importer`, extended with what to do
+ * about it when the cause is one the runner recognizes. Any other cause keeps
+ * its own message.
+ */
+export declare function explainModuleError(cause: unknown, importer: string): string;
+//# sourceMappingURL=diagnose.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"diagnose.d.ts","sourceRoot":"","sources":["../../src/config/diagnose.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,kGAAkG;AAClG,eAAO,MAAM,eAAe,EAAE,SAAS,MAAM,EAS5C,CAAC;AASF;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAG3E"}

package/dist/config/diagnose.js

@@ -0,0 +1,122 @@
+/**
+ * Turns a module loading failure into a sentence that names the fix. The
+ * loader's own messages are accurate but stop at the symptom: a missing
+ * package reads the same whether it was never added or just not installed,
+ * and a removed export looks like a typo.
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import path from 'node:path';
+import { withHint } from '../internal/errors.js';
+import { addDevDependencyCommand, detectPackageManager } from '../internal/package-manager.js';
+import { didYouMean, suggest } from '../internal/suggest.js';
+/** The runtime exports of `@e2edev/e2e`; a unit test keeps this list equal to the real module. */
+export const RUNTIME_EXPORTS = [
+    'test',
+    'expect',
+    'credentials',
+    'AgentError',
+    'BLOCKABLE_CODES',
+    'RUNTIME_CODES',
+    'buildTraceEntry',
+    'readTraceEntry',
+];
+/**
+ * The message of a failed import of `importer`, extended with what to do
+ * about it when the cause is one the runner recognizes. Any other cause keeps
+ * its own message.
+ */
+export function explainModuleError(cause, importer) {
+    const message = cause instanceof Error ? cause.message : String(cause);
+    return withHint(message, moduleErrorHint(message, cause?.code, importer));
+}
+function moduleErrorHint(message, code, importer) {
+    if (code === 'ERR_MODULE_NOT_FOUND') {
+        const missing = /Cannot find (?:package|module) '([^']+)'/.exec(message)?.[1];
+        if (missing !== undefined && !missing.startsWith('.') && !path.isAbsolute(missing)) {
+            return missingPackageHint(packageNameOf(missing), importer);
+        }
+        return '';
+    }
+    if (code === 'ERR_PACKAGE_PATH_NOT_EXPORTED') {
+        const match = /Package subpath '([^']+)' is not defined by "exports" in (.+?package\.json)/.exec(message);
+        return match === null ? '' : subpathHint(match[1], match[2]);
+    }
+    const missingExport = /The requested module '([^']+)' does not provide an export named '([^']+)'/.exec(message);
+    return missingExport === null ? '' : missingExportHint(missingExport[1], missingExport[2]);
+}
+/** `@scope/name/subpath` and `name/subpath` reduce to the package that would be installed. */
+function packageNameOf(specifier) {
+    const parts = specifier.split('/');
+    return specifier.startsWith('@') ? parts.slice(0, 2).join('/') : parts[0];
+}
+function missingPackageHint(name, importer) {
+    const manifest = nearestManifest(path.dirname(importer));
+    const manager = detectPackageManager(manifest?.dir ?? path.dirname(importer), manifest?.packageManager);
+    if (manifest?.dependencies.has(name) === true) {
+        return `${name} is declared in ${manifest.path} but is not installed: run ${manager} install`;
+    }
+    return `add it to the project: ${addDevDependencyCommand(manager, name)}`;
+}
+function subpathHint(subpath, manifestPath) {
+    let parsed;
+    try {
+        parsed = JSON.parse(readFileSync(manifestPath, 'utf8'));
+    }
+    catch {
+        return '';
+    }
+    const name = typeof parsed.name === 'string' ? parsed.name : path.basename(path.dirname(manifestPath));
+    const entries = typeof parsed.exports === 'object' && parsed.exports !== null && !Array.isArray(parsed.exports)
+        ? Object.keys(parsed.exports).filter((key) => key.startsWith('.'))
+        : ['.'];
+    const specifiers = entries.map((entry) => (entry === '.' ? name : `${name}/${entry.slice(2)}`));
+    const attempted = `${name}/${subpath.replace(/^\.\//, '')}`;
+    return `${name} exports ${specifiers.join(', ')}${didYouMean(attempted, specifiers)}`;
+}
+function missingExportHint(specifier, exportName) {
+    if (specifier !== '@e2edev/e2e')
+        return '';
+    if (exportName === 'defineConfig') {
+        return 'defineConfig was removed in @e2edev/e2e 0.5: default-export the object and end it with satisfies E2EConfig';
+    }
+    const suggestion = suggest(exportName, RUNTIME_EXPORTS);
+    if (suggestion !== undefined)
+        return `did you mean "${suggestion}"?`;
+    return /^[A-Z]/.test(exportName)
+        ? `if ${exportName} is a type, import it with import type { ${exportName} } from '@e2edev/e2e'`
+        : `@e2edev/e2e exports ${RUNTIME_EXPORTS.join(', ')}`;
+}
+/** The closest package.json above `dir`, read for its declared dependencies. */
+function nearestManifest(dir) {
+    let current = dir;
+    for (;;) {
+        const manifestPath = path.join(current, 'package.json');
+        if (existsSync(manifestPath)) {
+            try {
+                const parsed = JSON.parse(readFileSync(manifestPath, 'utf8'));
+                const dependencies = new Set();
+                for (const block of ['dependencies', 'devDependencies', 'peerDependencies', 'optionalDependencies']) {
+                    const section = parsed[block];
+                    if (typeof section === 'object' && section !== null) {
+                        for (const name of Object.keys(section))
+                            dependencies.add(name);
+                    }
+                }
+                return {
+                    path: manifestPath,
+                    dir: current,
+                    packageManager: typeof parsed['packageManager'] === 'string' ? parsed['packageManager'] : undefined,
+                    dependencies,
+                };
+            }
+            catch {
+                return undefined;
+            }
+        }
+        const parent = path.dirname(current);
+        if (parent === current)
+            return undefined;
+        current = parent;
+    }
+}
+//# sourceMappingURL=diagnose.js.map

package/dist/config/diagnose.js.map

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

package/dist/config/load.d.ts

@@ -1,4 +1,5 @@
-/** Config discovery and ESM/TypeScript loading (spec 05-config.md). */
+/** Config discovery and ESM/TypeScript loading. */
+import { ConfigurationError } from '../internal/errors.ts';
 import type { E2EConfig } from '../types.ts';
 export interface DiscoveredConfig {
     readonly configPath: string | undefined;
@@ -10,6 +11,13 @@ export interface DiscoveredConfig {
  * repository root. The selected file's directory is the project root.
  */
 export declare function discoverConfig(cwd: string, explicitPath?: string): DiscoveredConfig;
+/**
+ * The failure for a run that found no config file: where the search looked,
+ * a lookalike in the working directory when one exists, and otherwise the
+ * command that creates a config. Thrown by the CLI path only; an embedding
+ * host passes its config as a value.
+ */
+export declare function missingConfigError(cwd: string): ConfigurationError;
 /**
  * Imports a TypeScript/ESM module with erasable-syntax support. Every call
  * evaluates the module afresh: the query carries the caller's key (what the

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

@@ -1 +1 @@
-{"version":3,"file":"load.d.ts","sourceRoot":"","sources":["../../src/config/load.ts"],"names":[],"mappings":"AAAA,uEAAuE;AAOvE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAK7C,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,gBAAgB,CA2BnF;AAWD;;;;;;GAMG;AACH,wBAAsB,YAAY,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,SAAW,GAAG,OAAO,CAAC,OAAO,CAAC,CAO9F;AAED,mEAAmE;AACnE,wBAAsB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAmB7E"}
+{"version":3,"file":"load.d.ts","sourceRoot":"","sources":["../../src/config/load.ts"],"names":[],"mappings":"AAAA,mDAAmD;AAMnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAoB7C,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,gBAAgB,CA2BnF;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,kBAAkB,CASlE;AAWD;;;;;;GAMG;AACH,wBAAsB,YAAY,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,SAAW,GAAG,OAAO,CAAC,OAAO,CAAC,CAO9F;AAED,mEAAmE;AACnE,wBAAsB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAuB7E"}

package/dist/config/load.js

@@ -1,11 +1,25 @@
-/** Config discovery and ESM/TypeScript loading (spec 05-config.md). */
+/** Config discovery and ESM/TypeScript loading. */
 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';
+import { explainModuleError } from './diagnose.js';
 import { esmPackageHint } from './esm.js';
 const CONFIG_NAMES = ['e2e.config.ts', 'e2e.config.mts'];
+/** Spellings a config author might reach for that the loader does not read. */
+const CONFIG_LOOKALIKES = [
+    'e2e.config.js',
+    'e2e.config.mjs',
+    'e2e.config.cjs',
+    'e2e.config.cts',
+    'e2e.config.json',
+    'e2e.config.mts.ts',
+    'e2e.ts',
+    'e2e.json',
+    'e2e-config.ts',
+    'e2e.conf.ts',
+];
 /**
  * Discovers the config file. With `--config` the explicit path wins. Otherwise
  * the search starts at cwd and inspects each parent, stopping after the
@@ -37,6 +51,21 @@ export function discoverConfig(cwd, explicitPath) {
     }
     return { configPath: undefined, projectRoot: path.resolve(cwd) };
 }
+/**
+ * The failure for a run that found no config file: where the search looked,
+ * a lookalike in the working directory when one exists, and otherwise the
+ * command that creates a config. Thrown by the CLI path only; an embedding
+ * host passes its config as a value.
+ */
+export function missingConfigError(cwd) {
+    const root = path.resolve(cwd);
+    const lookalike = CONFIG_LOOKALIKES.find((name) => existsSync(path.join(root, name)));
+    const searched = `no ${CONFIG_NAMES.join(' or ')} found in ${root} or its parent directories`;
+    const remedy = lookalike === undefined
+        ? 'run e2e init to create one, or pass --config <path>'
+        : `found ${lookalike}, but only ${CONFIG_NAMES.join(' and ')} are loaded: rename it and keep it an ES module`;
+    return new ConfigurationError('CONFIG_NOT_FOUND', `${searched}; ${remedy}`);
+}
 /**
  * The process-wide TypeScript loader, registered on first use. `tsImport`
  * would register a fresh, never-removed loader hook per call - once per
@@ -68,11 +97,14 @@ export async function loadConfigModule(configPath) {
         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 });
+        throw new ConfigurationError('CONFIG_LOAD_FAILED', `failed to load config ${configPath}: ${explainModuleError(cause, configPath)}`, { 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()`);
+        const found = defaultExport === undefined
+            ? 'has no default export'
+            : `default-exports ${typeof defaultExport === 'function' ? 'a function' : `a ${typeof defaultExport}`}`;
+        throw new ConfigurationError('INVALID_CONFIG', `config ${configPath} ${found}; write export default { targets: [...] } satisfies E2EConfig`);
     }
     return defaultExport;
 }