@gfdelarue/testkit 0.3.0

package/dist/config/authoring/preset-env.d.ts

@@ -0,0 +1,19 @@
+type UnknownRecord = Record<string, unknown>;
+export interface DatabaseBindingEnvConfig {
+    prefix: string;
+    service: string;
+}
+export interface PresetEnvConfig {
+    databases?: Record<string, DatabaseBindingEnvConfig>;
+    values?: Record<string, string>;
+}
+interface NextPresetEnvOptions {
+    api?: string | {
+        baseUrl: string;
+    };
+}
+export declare function normalizePresetEnv(env: PresetEnvConfig | null | undefined): Record<string, string>;
+export declare function normalizePresetEnv(env: unknown): UnknownRecord;
+export declare function normalizeDatabaseEnvToken(value: unknown, label: string, sanitize?: boolean): string;
+export declare function normalizeNextPresetEnv({ api }?: NextPresetEnvOptions): Record<string, string>;
+export {};

package/dist/config/authoring/preset-env.js

@@ -0,0 +1 @@
+const i=String;export function normalizePresetEnv(e){if(!e)return{};if(!o(e))throw new Error("Preset env must be an object");const t=new Set(["values","databases"]),n=Object.keys(e).filter(a=>!t.has(a));if(n.length>0)throw new Error(`Preset env only supports "values" and "databases". Received unexpected key(s): ${n.join(", ")}`);const s=o(e.values)?e.values:{},r=o(e.databases)?e.databases:{};return{...c(r),...s}}export function normalizeDatabaseEnvToken(e,t,n=!0){const s=i(e||"").trim(),r=n?s.replace(/[^A-Za-z0-9]+/g,"_").replace(/^_+|_+$/g,""):s;if(!r)throw new Error(`${t} must be a non-empty string`);return r}export function normalizeNextPresetEnv({api:e}={}){const t={};if(e){const n=typeof e=="string"?e:e.baseUrl;n&&(t.NEXT_PUBLIC_API_URL=n)}return t}function c(e){const t={};for(const[n,s]of Object.entries(e)){if(!o(s))throw new Error(`env.databases.${n} must be an object`);const r=normalizeDatabaseEnvToken(s.prefix,`env.databases.${n}.prefix`),a=normalizeDatabaseEnvToken(s.service,`env.databases.${n}.service`,!1);t[`${r}_DATABASE_HOST`]=`{dbHost:${a}}`,t[`${r}_DATABASE_PORT`]=`{dbPort:${a}}`,t[`${r}_DATABASE_NAME`]=`{dbName:${a}}`,t[`${r}_DATABASE_USER`]=`{dbUser:${a}}`,t[`${r}_DATABASE_PASSWORD`]=`{dbPassword:${a}}`,t[`${r}_DATABASE_SSL`]=`{dbSsl:${a}}`}return t}function o(e){return e!==null&&typeof e=="object"&&!Array.isArray(e)}

package/dist/config/authoring/runtime.d.ts

@@ -0,0 +1,64 @@
+import type { RuntimeEnv, RuntimeHeaders, RuntimeHttpClient, RuntimeOptions } from "./http-execution-contract.js";
+export type HttpProfileEnvironment = Readonly<Record<string, string | undefined>>;
+export interface HttpProfileEnv {
+    [key: string]: unknown;
+    BASE?: string;
+    rawEnv?: HttpProfileEnvironment;
+}
+export type HttpProfileResolvedEnv = HttpProfileEnv & RuntimeEnv;
+export interface HttpProfileHeaderContext {
+    actor?: string | null;
+    env?: HttpProfileEnv;
+}
+export type HttpProfileHeaderBuilder<TSetup = unknown> = (setupData: TSetup | null, context?: HttpProfileHeaderContext & {
+    env: HttpProfileResolvedEnv;
+}) => RuntimeHeaders | undefined;
+type HttpProfileRequestMethod = "del" | "get" | "patch" | "post" | "put";
+/** Response shape the in-process profile setup client resolves to. */
+export interface HttpProfileResponse {
+    body: string;
+    cookies?: Record<string, Array<{
+        value: string;
+    }> | undefined>;
+    headers?: Record<string, string>;
+    status: number;
+}
+/** HTTP verbs an execution engine hands to a profile's setup step. */
+export type HttpProfileRequestClient<TResult = Promise<HttpProfileResponse>> = {
+    [Method in HttpProfileRequestMethod]: (...args: Parameters<RuntimeHttpClient[Method]>) => TResult;
+};
+export interface HttpProfileSetupContext {
+    env: HttpProfileResolvedEnv;
+    http: HttpProfileRequestClient;
+    json(response: unknown): unknown;
+}
+/**
+ * Explicit, test-owned authentication for a named HTTP profile. The execution
+ * engine runs `setup` (or `setupAsync` where it can await) once and passes the
+ * result to `headers` for every request.
+ */
+export interface HttpProfileAuth<TSetup = unknown> {
+    headers?: HttpProfileHeaderBuilder<TSetup>;
+    setup?(context: HttpProfileSetupContext): TSetup;
+    setupAsync?(context: HttpProfileSetupContext): Promise<TSetup>;
+}
+export interface HttpProfileConfig<TSetup = unknown> {
+    [key: string]: unknown;
+    auth?: HttpProfileAuth<TSetup> | null;
+    baseUrl?: string;
+    env?: HttpProfileEnv;
+    headers?: HttpProfileHeaderBuilder<TSetup>;
+    options?: RuntimeOptions;
+    rawHeaders?: HttpProfileHeaderBuilder<TSetup>;
+}
+export interface RepoConfig {
+    [key: string]: unknown;
+    profiles?: {
+        http?: Record<string, HttpProfileConfig>;
+    };
+}
+export declare function registerRepoConfig(config: RepoConfig | null | undefined): void;
+export declare function getRepoConfig(): RepoConfig | null;
+export declare function clearRepoConfig(): void;
+export declare function resolveHttpProfile(name: string | null | undefined): HttpProfileConfig | null;
+export {};

package/dist/config/authoring/runtime.js

@@ -0,0 +1 @@
+let o=null;export function registerRepoConfig(n){o=n??null}export function getRepoConfig(){return o}export function clearRepoConfig(){o=null}export function resolveHttpProfile(n){if(!n)return null;const t=getRepoConfig();if(!t)return null;const r=t.profiles?.http?.[n];if(!r)throw new Error(`Unknown testkit HTTP profile "${n}"`);return r}

package/dist/config/loader/cloud.d.ts

@@ -0,0 +1,2 @@
+/** Local submission policy only. Cloud independently owns acceptance. */
+export declare function minimumConfirmingRuns(config: object): number;

package/dist/config/loader/cloud.js

@@ -0,0 +1 @@
+import{isUnknownRecord as e}from"../../kernel/unknown-values.js";import{attachErrorDiagnostics as t}from"../../kernel/error-serialization.js";export function minimumConfirmingRuns(o){let i=o;for(const r of["cloud","verification","minimumConfirmingRuns"]){if(!e(i))throw n();if(i=i[r],i===void 0)return 2}if(typeof i!="number"||!Number.isSafeInteger(i)||i<1||i>64)throw n();return i}function n(){return t(Object.assign(new Error("cloud.verification.minimumConfirmingRuns must be an integer from 1 through 64"),{code:"invalid_cloud_verification_config"}),{source:"local",field:"cloud.verification.minimumConfirmingRuns"})}

package/dist/config/loader/config-loader.d.ts

@@ -0,0 +1,9 @@
+export interface LoadTestkitConfigOptions {
+    importCacheSalt?: string;
+}
+export interface LoadedTestkitConfig {
+    config: object;
+    configFile: null | string;
+}
+export declare function findConfigFile(productDir: string): null | string;
+export declare function loadTestkitConfig(productDir: string, options?: Readonly<LoadTestkitConfigOptions>): Promise<LoadedTestkitConfig>;

package/dist/config/loader/config-loader.js

@@ -0,0 +1 @@
+import m from"node:crypto";import o from"node:fs";import n from"node:path";import{fileURLToPath as d,pathToFileURL as p}from"node:url";import{buildWithEsbuildRetry as h}from"../../toolchains/esbuild.js";import{isObjectRecord as c}from"./values.js";const u=n.resolve(n.dirname(d(import.meta.url)),"..","..",".."),k=n.join(u,"dist","index.js"),j=n.join(u,"dist","config","authoring","index.js"),b=new Set(["/k6","/node-vitest/data","/node-vitest/contract","/playwright"]),y=["testkit.config.ts","testkit.config.mts","testkit.config.mjs","testkit.config.js"];export function findConfigFile(t){for(const e of y){const i=n.join(t,e);if(o.existsSync(i))return i}return null}export async function loadTestkitConfig(t,e={}){const i=findConfigFile(t);if(!i)return{config:{},configFile:null};const r=n.join(t,".testkit","_config");o.mkdirSync(r,{recursive:!0});const s=w(i),a=n.join(r,`config-${s.slice(0,12)}.mjs`);await h({absWorkingDir:t,bundle:!0,entryPoints:[i],format:"esm",legalComments:"none",outfile:a,platform:"node",sourcemap:"inline",target:"es2020",plugins:[C()]});const l=[s,e.importCacheSalt||""].filter(Boolean).join("-"),g=await import(`${p(a).href}?v=${l}`),f=S(g);if(!c(f))throw new Error(`testkit config file must export an object: ${n.basename(i)}`);return{config:f,configFile:i}}function w(t){const e=o.readFileSync(t,"utf8");return m.createHash("sha256").update(t).update("\0").update(e).digest("hex")}function C(){return{name:"testkit-config-alias",setup(t){t.onResolve({filter:/^@gfdelarue\/testkit(?:\/.*)?$/},e=>({namespace:"file",path:E(e.path)}))}}}function E(t){const e=t.slice(18);if(!e)return k;if(e==="/config")return j;throw b.has(e)?new Error(`testkit.config.ts may not import engine authoring module "${t}". Use repository config helpers from @gfdelarue/testkit/config instead.`):new Error(`Unsupported @gfdelarue/testkit import "${t}" while loading testkit config`)}function S(t){if(c(t))return t.default||t.config||{}}

package/dist/config/loader/database-materialization.d.ts

@@ -0,0 +1,19 @@
+export interface DatabaseMaterializationInput {
+    image?: string;
+    maxConnections?: number;
+    password?: string;
+    reservedConnections?: number;
+    runtimeConnections?: number;
+    user?: string;
+}
+export interface MaterializedDatabaseDefaults {
+    image: string;
+    maxConnections: number;
+    password: string;
+    reservedConnections: number;
+    runtimeConnections: number;
+    user: string;
+}
+export type MaterializedDatabaseConfig<T extends object = DatabaseMaterializationInput> = Omit<T, keyof DatabaseMaterializationInput> & MaterializedDatabaseDefaults;
+export declare function materializeDatabaseConfig<T extends object>(database: T & DatabaseMaterializationInput): MaterializedDatabaseConfig<T>;
+export declare function materializeDatabaseConfig(database: null | undefined): undefined;

package/dist/config/loader/database-materialization.js

@@ -0,0 +1 @@
+const C="pgvector/pgvector:pg16",o="testkit",E="testkit",e=200,L=20,_=20;export function materializeDatabaseConfig(n){if(n)return{...n,image:n.image||C,user:n.user||o,password:n.password||E,maxConnections:n.maxConnections||200,reservedConnections:n.reservedConnections??20,runtimeConnections:n.runtimeConnections??20}}

package/dist/config/loader/database-roles.d.ts

@@ -0,0 +1,2 @@
+import type { DatabaseRoleConfig } from "../authoring/index.js";
+export declare function normalizeDatabaseRoles(value: unknown, serviceName: string, bootstrapUser: string): DatabaseRoleConfig[];

package/dist/config/loader/database-roles.js

@@ -0,0 +1 @@
+import{Buffer as f}from"node:buffer";export function normalizeDatabaseRoles(r,n,t){if(r===void 0)return[];const e=`Service "${n}" database.roles`;if(!Array.isArray(r))throw new Error(`${e} must be an array`);const m=new Set;return Array.from(r,(i,s)=>{const a=`${e}[${String(s)}]`,o=w(i,a);if(o.name===t)throw new Error(`${a}.name must not match the bootstrap user`);if(m.has(o.name))throw new Error(`${a}.name duplicates role ${JSON.stringify(o.name)}`);return m.add(o.name),o}).sort((i,s)=>i.name<s.name?-1:i.name>s.name?1:0)}function w(r,n){if(!r||typeof r!="object"||Array.isArray(r))throw new Error(`${n} must be an object`);for(const e of Reflect.ownKeys(r))if(e!=="name"&&e!=="login")throw new Error(`${n} has unsupported attribute ${String(e)}`);if(!Object.hasOwn(r,"login")||!("login"in r)||r.login!==!1)throw new Error(`${n}.login must be explicitly false`);if(!Object.hasOwn(r,"name")||!("name"in r)||typeof r.name!="string"||r.name.length===0)throw new Error(`${n}.name must be a non-empty string`);const t=r.name;if(t.includes("\0"))throw new Error(`${n}.name must not contain NUL`);if(f.from(t,"utf8").toString("utf8")!==t)throw new Error(`${n}.name must contain valid Unicode`);if(f.byteLength(t,"utf8")>63)throw new Error(`${n}.name must not exceed 63 UTF-8 bytes`);if(t==="public"||t==="none"||t.startsWith("pg_"))throw new Error(`${n}.name is reserved by PostgreSQL`);return{name:t,login:!1}}

package/dist/config/loader/database.d.ts

@@ -0,0 +1,55 @@
+import { type DatabaseBinding } from "./execution-model.js";
+import type { DatabaseRoleConfig, PostgresDatabaseConfig } from "../authoring/index.js";
+import { type NormalizedConfiguredStep } from "../../steps/configured-steps.js";
+type FalsyDatabaseConfig = "" | 0 | false | null | undefined;
+export type DatabaseConfigInput = PostgresDatabaseConfig;
+export interface DatabaseServiceConfigInput {
+    readonly database?: unknown;
+    readonly databaseFrom?: unknown;
+}
+export interface NormalizedDatabaseTemplateConfig {
+    inputs: string[];
+    migrate: NormalizedConfiguredStep[];
+    seed: NormalizedConfiguredStep[];
+    verify: NormalizedConfiguredStep[];
+}
+export interface NormalizedSourceSchemaConfigBase {
+    refresh: NormalizedSourceSchemaRefresh;
+    unavailable: NormalizedSourceSchemaUnavailable;
+    verify: boolean;
+}
+export interface NormalizedAutomaticSourceSchemaConfig extends NormalizedSourceSchemaConfigBase {
+    kind: "auto";
+}
+export interface NormalizedEnvironmentSourceSchemaConfig extends NormalizedSourceSchemaConfigBase {
+    env: string;
+    kind: "env";
+}
+export type NormalizedSourceSchemaConfig = NormalizedAutomaticSourceSchemaConfig | NormalizedEnvironmentSourceSchemaConfig;
+export type NormalizedSourceSchemaRefresh = {
+    mode: "always" | "auto";
+} | {
+    mode: "ttl";
+    ttlSeconds: number;
+};
+export type NormalizedSourceSchemaUnavailable = "auto" | "fail" | "warn-cache";
+export interface NormalizedDatabaseFields {
+    binding: DatabaseBinding;
+    maxConnections: number | undefined;
+    reservedConnections: number | undefined;
+    reset: boolean;
+    roles: DatabaseRoleConfig[];
+    runtimeConnections: number | undefined;
+    serviceName: string;
+    sourceSchema: NormalizedSourceSchemaConfig | null;
+    template: NormalizedDatabaseTemplateConfig;
+}
+export type NormalizedDatabaseConfig<Input extends object = DatabaseConfigInput> = Omit<Input, keyof NormalizedDatabaseFields> & NormalizedDatabaseFields;
+export type LooselyNormalizedDatabaseConfig = NormalizedDatabaseFields & Record<PropertyKey, unknown>;
+type CompatibleDatabaseConfigInput<Input extends object> = Input & Pick<DatabaseConfigInput, Extract<keyof DatabaseConfigInput, keyof Input>>;
+export declare function normalizeDatabaseConfig<Input extends object>(explicitService: Readonly<DatabaseServiceConfigInput & {
+    database?: CompatibleDatabaseConfigInput<Input> | FalsyDatabaseConfig;
+}>, serviceName: string): NormalizedDatabaseConfig<Input> | undefined;
+export declare function normalizeDatabaseConfig(explicitService: Readonly<DatabaseServiceConfigInput>, serviceName: string): LooselyNormalizedDatabaseConfig | undefined;
+export declare function normalizeDatabaseTemplateConfig(value: unknown, serviceName: string): NormalizedDatabaseTemplateConfig;
+export {};

package/dist/config/loader/database.js

@@ -0,0 +1 @@
+import{normalizeDatabaseBinding as u}from"./decode-execution.js";import{normalizeDatabaseRoles as m}from"./database-roles.js";import{materializeDatabaseConfig as b}from"./database-materialization.js";import"./execution-model.js";import{normalizeConfiguredInputs as d,normalizeConfiguredSteps as i}from"../../steps/configured-steps.js";export function normalizeDatabaseConfig(e,r){if(s(e.databaseFrom))return;const t=e.database;if(!s(t))return;const o=n(t,"user"),a=b({user:typeof o=="string"?o:void 0}).user;return{...g(t),binding:u(f(n(t,"binding"),"per-runtime"),`Service "${r}" database.binding`),maxConnections:c(n(t,"maxConnections"),`Service "${r}" database.maxConnections`),reservedConnections:p(n(t,"reservedConnections"),`Service "${r}" database.reservedConnections`),runtimeConnections:c(n(t,"runtimeConnections"),`Service "${r}" database.runtimeConnections`),reset:n(t,"reset")!==!1,roles:m(n(t,"roles"),r,a),sourceSchema:l(n(t,"sourceSchema"),r),template:normalizeDatabaseTemplateConfig(n(t,"template"),r),serviceName:r}}function c(e,r){if(e==null)return;const t=Number(e);if(!Number.isInteger(t)||t<=0)throw new Error(`${r} must be a positive integer`);return t}function p(e,r){if(e==null)return;const t=Number(e);if(!Number.isInteger(t)||t<0)throw new Error(`${r} must be a non-negative integer`);return t}export function normalizeDatabaseTemplateConfig(e,r){if(e==null)return{inputs:[],migrate:[],seed:[],verify:[]};if(typeof e!="object")throw new Error(`Service "${r}" database.template must be an object`);if(Object.prototype.hasOwnProperty.call(e,"schema"))throw new Error(`Service "${r}" database.template.schema has been removed. Configure database.sourceSchema instead.`);return{inputs:d(n(e,"inputs"),`Service "${r}" database.template`),migrate:i(n(e,"migrate"),`Service "${r}" database.template.migrate`),seed:i(n(e,"seed"),`Service "${r}" database.template.seed`),verify:i(n(e,"verify"),`Service "${r}" database.template.verify`)}}function l(e,r){if(e===!1||e===null)return null;if(e===void 0)return{kind:"auto",refresh:{mode:"auto"},unavailable:"auto",verify:!0};if(typeof e!="object"||Array.isArray(e))throw new Error(`Service "${r}" database.sourceSchema must be an object or false`);const t=f(n(e,"kind"),"env");if(t!=="env")throw new Error(`Service "${r}" database.sourceSchema.kind must be "env"`);if(Object.prototype.hasOwnProperty.call(e,"cachePath"))throw new Error(`Service "${r}" database.sourceSchema.cachePath has been removed. Testkit now manages commit-scoped source schema caches automatically.`);const o=n(e,"env");if(typeof o!="string"||o.trim().length===0)throw new Error(`Service "${r}" database.sourceSchema.env must be a non-empty string`);return{kind:t,env:o.trim(),refresh:h(n(e,"refresh"),r),unavailable:y(n(e,"unavailable"),r),verify:n(e,"verify")!==!1}}function h(e,r){if(e==null||e==="auto")return{mode:"auto"};if(e==="always")return{mode:"always"};if(typeof e=="object"&&!Array.isArray(e)){const t=n(e,"ttlSeconds");if(typeof t!="number"||!Number.isInteger(t)||t<0)throw new Error(`Service "${r}" database.sourceSchema.refresh.ttlSeconds must be a non-negative integer`);return{mode:"ttl",ttlSeconds:t}}throw new Error(`Service "${r}" database.sourceSchema.refresh must be "auto", "always", or { ttlSeconds }`)}function y(e,r){if(e==null||e==="auto")return"auto";if(e==="fail"||e==="warn-cache")return e;throw new Error(`Service "${r}" database.sourceSchema.unavailable must be "auto", "fail", or "warn-cache"`)}function s(e){return!!e}function f(e,r){return s(e)?e:r}function n(e,r){if(!(e===null||typeof e!="object"&&typeof e!="function"))return Reflect.get(e,r)}function g(e){const r={};if(typeof e=="string"){for(let t=0;t<e.length;t+=1)Object.defineProperty(r,String(t),{configurable:!0,enumerable:!0,value:e[t],writable:!0});return r}if(e===null||typeof e!="object"&&typeof e!="function")return r;for(const t of Reflect.ownKeys(e))if(Object.getOwnPropertyDescriptor(e,t)?.enumerable){const a=Reflect.get(e,t);Object.defineProperty(r,t,{configurable:!0,enumerable:!0,value:a,writable:!0})}return r}

package/dist/config/loader/decode-discovery.d.ts

@@ -0,0 +1,5 @@
+import { type NormalizedDiscoveryConfig } from "./path-policy.js";
+export interface DiscoveryConfigNormalizationOptions {
+    allowRoots?: boolean;
+}
+export declare function normalizeDiscoveryConfig(value: unknown, { allowRoots }?: DiscoveryConfigNormalizationOptions): NormalizedDiscoveryConfig;

package/dist/config/loader/decode-discovery.js

@@ -0,0 +1 @@
+import s from"node:path";import{normalizeDiscoveryPath as n}from"./path-policy.js";export function normalizeDiscoveryConfig(r,{allowRoots:t=!0}={}){if(r==null)return{};if(typeof r!="object"||Array.isArray(r))throw new Error("testkit discovery config must be an object");const e={};return t&&Object.prototype.hasOwnProperty.call(r,"roots")&&(e.roots=i(Reflect.get(r,"roots"),"testkit discovery roots")),Object.prototype.hasOwnProperty.call(r,"exclude")&&(e.exclude=i(Reflect.get(r,"exclude"),"testkit discovery exclude")),e}function i(r,t){if(!Array.isArray(r))throw new Error(`${t} must be an array of relative paths`);const e=r.map(o=>{if(typeof o!="string"||o.trim().length===0)throw new Error(`${t} entries must be non-empty strings`);if(s.isAbsolute(o))throw new Error(`${t} entries must be relative paths`);return n(o)}).filter(Boolean);return[...new Set(e)]}

package/dist/config/loader/decode-execution.d.ts

@@ -0,0 +1,9 @@
+import type { DatabaseBinding, ExecutionConfigInput, ResolveExecutionConfigInput, NormalizedExecutionConfig } from "./execution-model.js";
+export declare function parseTaskConcurrencyOptions(taskConcurrency: unknown, workers?: unknown): number | null;
+export declare function parseRuntimeInstancesOption(value: unknown, label?: string): number;
+export declare function normalizeRuntimeInstances(value: unknown, label?: string): number;
+export declare function parseRuntimeMaxConcurrentTasksOption(value: unknown, label?: string): number;
+export declare function normalizeRuntimeMaxConcurrentTasks(value: unknown, label?: string): number;
+export declare function normalizeDatabaseBinding(value: unknown, label?: string): DatabaseBinding;
+export declare function resolveExecutionConfig({ cli, repo, }?: ResolveExecutionConfigInput): NormalizedExecutionConfig;
+export declare function normalizeExecutionConfig(input?: ExecutionConfigInput): NormalizedExecutionConfig;

package/dist/config/loader/decode-execution.js

@@ -0,0 +1 @@
+import{DEFAULT_FILE_TIMEOUT_SECONDS as c,normalizeFileTimeoutSeconds as a}from"../../domain/file-timeout.js";export function parseTaskConcurrencyOptions(e,n){return i(e,n,"--task-concurrency","--workers")??null}export function parseRuntimeInstancesOption(e,n="runtime.instances"){return d(e,n)}export function normalizeRuntimeInstances(e,n="runtime.instances"){return s(e,n)}export function parseRuntimeMaxConcurrentTasksOption(e,n="runtime.maxConcurrentTasks"){return d(e,n)}export function normalizeRuntimeMaxConcurrentTasks(e,n="runtime.maxConcurrentTasks"){return e==null?Number.POSITIVE_INFINITY:s(e,n)}export function normalizeDatabaseBinding(e,n="database.binding"){const r=String(e).trim();if(r!=="shared"&&r!=="per-runtime")throw new Error(`Invalid ${n} value "${String(e)}". Expected one of: shared, per-runtime.`);return r}export function resolveExecutionConfig({cli:e={},repo:n={}}={}){const r=i(n.taskConcurrency,n.workers);return{taskConcurrency:i(e.taskConcurrency,e.workers,"--task-concurrency","--workers")??r??1,fileTimeoutSeconds:a(e.fileTimeoutSeconds??n.fileTimeoutSeconds??c)}}export function normalizeExecutionConfig(e={}){const n=new Set(["workers","taskConcurrency","fileTimeoutSeconds"]),r=Object.keys(e).filter(t=>!n.has(t));if(r.length>0)throw new Error(`execution received unexpected key(s): ${r.join(", ")}`);return{taskConcurrency:i(e.taskConcurrency,e.workers)??1,fileTimeoutSeconds:a(e.fileTimeoutSeconds??c)}}function i(e,n,r="execution.taskConcurrency",o="execution.workers"){const t=e==null?void 0:s(e,r),u=n==null?void 0:s(n,o);if(t!==void 0&&u!==void 0&&t!==u)throw new Error(`${r} and ${o} must match when both are provided.`);return t??u}function d(e,n){const r=Number.parseInt(String(e),10);if(!Number.isInteger(r)||r<=0)throw new Error(`Invalid ${n} value "${String(e)}". Expected a positive integer.`);return r}function s(e,n){const r=Number(e);if(!Number.isInteger(r)||r<=0)throw new Error(`${n} must be a positive integer.`);return r}

package/dist/config/loader/dependencies.d.ts

@@ -0,0 +1,7 @@
+export interface RuntimeDependencyConfig {
+    name: string;
+    testkit: {
+        dependsOn?: readonly string[];
+    };
+}
+export declare function resolveRuntimeConfigs<Config extends RuntimeDependencyConfig>(targetConfig: Config, configMap: ReadonlyMap<string, Config>): Config[];

package/dist/config/loader/dependencies.js

@@ -0,0 +1 @@
+export function resolveRuntimeConfigs(o,m){const t=[],n=new Set,r=new Set,s=e=>{if(!r.has(e.name)){if(n.has(e.name))throw new Error(`Dependency cycle detected involving "${e.name}"`);n.add(e.name);for(const d of e.testkit.dependsOn||[]){const a=m.get(d);if(!a)throw new Error(`Service "${e.name}" depends on unknown service "${d}"`);s(a)}n.delete(e.name),r.add(e.name),t.push(e)}};return s(o),t}

package/dist/config/loader/discover-tests.d.ts

@@ -0,0 +1,101 @@
+import type { EngineId, RunnerProfileId } from "../../domain/identifiers.js";
+import { type RunType } from "../../domain/test-types.js";
+import { type PublicTestType } from "../../domain/identifiers.js";
+import { type RuntimeIsolationPolicy as ConfigRuntimeIsolationPolicy } from "./runtime-isolation.js";
+import { resolveEngineProfile } from "../../engines/catalog.js";
+import { type DiscoverySummary } from "./discovery-summary.js";
+declare const DISCOVERY_SCHEMA_VERSION: 9;
+export type DiscoveryTestType = PublicTestType;
+export type RuntimeIsolationPolicy = ConfigRuntimeIsolationPolicy;
+export type { DiscoverySummary } from "./discovery-summary.js";
+export interface DiscoveryDiagnostic {
+    code: string;
+    message: string;
+    path?: string;
+    serviceNames?: string[];
+    severity: "error" | "warning";
+}
+export interface DiscoveryService {
+    activeFileCount: number;
+    dependsOn: string[];
+    discovered: boolean;
+    fileCount: number;
+    localCwd: string;
+    name: string;
+    skippedFileCount: number;
+    suiteCount: number;
+}
+export interface DiscoveryTestContract {
+    authoringApi?: string;
+    executionHost: ReturnType<typeof resolveEngineProfile>["capabilities"]["executionHost"];
+    summary?: string;
+}
+export interface DiscoverySuite {
+    activeFileCount: number;
+    contract: DiscoveryTestContract;
+    dependsOn: string[];
+    displayName: string;
+    engineId: EngineId;
+    fileCount: number;
+    filePaths: string[];
+    groupLabel: string;
+    id: string;
+    locks: string[];
+    name: string;
+    profileId: RunnerProfileId;
+    service: string;
+    skippedFileCount: number;
+    testType: DiscoveryTestType;
+}
+export interface DiscoveryFile {
+    contract: DiscoveryTestContract;
+    dependsOn: string[];
+    displayName: string;
+    engineId: EngineId;
+    groupLabel: string;
+    id: string;
+    locks: string[];
+    path: string;
+    profileId: RunnerProfileId;
+    runtimeIsolation: RuntimeIsolationPolicy;
+    service: string;
+    skipped: boolean;
+    skipReason: null | string;
+    suiteName: string;
+    testType: DiscoveryTestType;
+}
+export interface DiscoveryResult {
+    configFile: null | string;
+    diagnostics: DiscoveryDiagnostic[];
+    files: DiscoveryFile[];
+    filters: {
+        diagnostics: "error" | "report";
+        fileNames: string[];
+        runnableOnly: boolean;
+        service: null | string;
+        suiteSelectors: string[];
+        types: RunType[];
+    };
+    product: {
+        directory: string;
+        name: string;
+    };
+    schemaVersion: typeof DISCOVERY_SCHEMA_VERSION;
+    services: DiscoveryService[];
+    source: "testkit-discovery";
+    suites: DiscoverySuite[];
+    summary: DiscoverySummary;
+}
+export interface DiscoverTestsOptions {
+    diagnostics?: "error" | "report";
+    dir?: null | string;
+    file?: null | string | readonly string[];
+    runnableOnly?: boolean;
+    service?: null | string;
+    suite?: null | string | readonly string[];
+    type?: null | string | readonly string[];
+}
+export declare function discoverTests(options?: Readonly<DiscoverTestsOptions>): Promise<DiscoveryResult>;
+export declare function formatDisplayName(value: unknown): string;
+export declare function testTypeContract(testType: DiscoveryTestType, engineId: EngineId, profileId: RunnerProfileId): DiscoveryTestContract;
+export declare function fileDisplayName(filePath: string): string;

package/dist/config/loader/discover-tests.js

@@ -0,0 +1 @@
+import g from"path";import{loadConfigContext as M,resolveProductDir as z}from"./load.js";import{discoverProject as A}from"./discovery.js";import{loadTestkitConfig as B}from"./config-loader.js";import{TEST_TYPE_ORDER as H,isRunType as L}from"../../domain/test-types.js";import"../../domain/identifiers.js";import{DEFAULT_RUNTIME_ISOLATION_POLICY as V,resolveRuntimeIsolationPolicy as _}from"./runtime-isolation.js";import{resolveEngineProfile as q}from"../../engines/catalog.js";import{readTestFileMetadata as U}from"./file-metadata.js";import{normalizeDiscoveryConfig as G}from"./decode-discovery.js";import"./path-policy.js";import{buildDiscoverySummary as Y,emptyDiscoverySummary as K}from"./discovery-summary.js";import{matchesSelectedTypes as J,matchesSuiteSelectors as k,normalizeTypeValues as Q,parseSuiteSelectors as W}from"../../domain/suite-selection.js";import{errorMessage as P}from"../../kernel/error-serialization.js";import{isObjectRecord as R,readObjectRecord as I,readProperty as f}from"./values.js";const X=9,h=String;export async function discoverTests(e={}){const t=z(process.cwd(),e.dir),i=se(e),o=await Z(t,i.diagnosticsMode),s={schemaVersion:X,source:"testkit-discovery",product:{name:g.basename(t),directory:t},configFile:o.configFile?g.relative(t,o.configFile)||g.basename(o.configFile):null,filters:{service:i.serviceFilter,types:i.typeValues,suiteSelectors:i.suiteSelectors.map(p=>p.raw),fileNames:i.fileNames,runnableOnly:i.runnableOnly,diagnostics:i.diagnosticsMode},services:[],suites:[],files:[],diagnostics:[...o.diagnostics],summary:K()};if(!o.config)return x(s);const r=ae(o.config),u=le(r.services),a=A(t,u,{strict:i.diagnosticsMode==="error",discovery:r.discovery}),m={project:a,fileMetadataByPath:new Map};s.diagnostics.push(...a.diagnostics),re(i.serviceFilter,r.services,a);let y=null;try{y=await M({dir:t,preparedDiscovery:m,configContext:{config:o.config,configFile:o.configFile},discoveryOptions:{strict:i.diagnosticsMode==="error"}})}catch(p){if(i.diagnosticsMode==="error")throw p;s.diagnostics.push({code:"config_invalid",severity:"error",message:P(p)})}const C=ie({productDir:t,rawDiscovery:a,explicitServices:r.services,configs:y?.configs??[],fileMetadataByPath:m.fileMetadataByPath,filters:i});return x({...s,...C})}export function formatDisplayName(e){return h(e||"").split(/[-_/]+/g).filter(Boolean).map(t=>t.replace(/^\w/,i=>i.toUpperCase())).join(" ")}export function testTypeContract(e,t,i){const o=q(e,t);if(o.id!==i)throw new Error(`Discovery profile mismatch for ${e}: metadata resolved ${i}, catalog resolved ${o.id}`);return e==="data"?{authoringApi:"@gfdelarue/testkit/node-vitest/data",executionHost:o.capabilities.executionHost,summary:"Data suites use the node-vitest engine and record Testkit data evidence; they are not raw Vitest or service-namespace tests."}:e==="contract"?{authoringApi:"@gfdelarue/testkit/node-vitest/contract",executionHost:o.capabilities.executionHost,summary:"Contract suites use the node-vitest engine for Node-backed service/runtime contracts without data-flow evidence requirements."}:t==="k6"?{authoringApi:"@gfdelarue/testkit/k6",executionHost:o.capabilities.executionHost}:t==="playwright"?{authoringApi:"@gfdelarue/testkit/playwright",executionHost:o.capabilities.executionHost}:{executionHost:o.capabilities.executionHost}}async function Z(e,t){try{const i=await B(e),{config:o,configFile:s}=ee(i);return{config:o,configFile:s,diagnostics:[]}}catch(i){if(t==="error")throw i;return{config:null,configFile:null,diagnostics:[{code:"config_invalid",severity:"error",message:P(i)}]}}}function ee(e){if(!R(e))throw new Error("testkit config loader must return an object");const t=f(e,"config"),i=f(e,"configFile");if(!R(t)){const o=typeof i=="string"?g.basename(i):"testkit config file";throw new Error(`testkit config file must export an object: ${o}`)}if(i!==null&&typeof i!="string")throw new Error("testkit config loader returned an invalid config path");return{config:t,configFile:i}}function ie({configs:e,fileMetadataByPath:t,productDir:i,rawDiscovery:o,explicitServices:s,filters:r}){const u=new Map(e.map(n=>[n.name,n])),a=new Map,m=new Map,y=[],C=new Set([...Object.keys(s),...Object.keys(o.services),...u.keys()]);for(const n of C){if(r.serviceFilter&&n!==r.serviceFilter)continue;const c=u.get(n),d=o.services[n],l=s[n];a.set(n,{name:n,discovered:c!==void 0||!!d,localCwd:c?c.testkit.local?.cwd||".":l?.localCwd||d?.inferredLocalCwd||".",dependsOn:[...c?.testkit.dependsOn??l?.dependsOn??[]],suiteCount:0,fileCount:0,activeFileCount:0,skippedFileCount:0})}for(const n of o.files){const c=n.testType;if(!J(c,r.typeValues)||!k(c,n.suiteName,r.suiteSelectors)||r.serviceFilter&&n.serviceName!==r.serviceFilter||r.fileNameSet.size>0&&!r.fileNameSet.has(n.filePath))continue;const d=t.get(n.filePath)??U(i,n.filePath);t.set(n.filePath,d);const l=u.get(n.serviceName),v=l?.suites[c]?.find($=>$.name===n.suiteName);if(l&&(!v||v.testType!==c||v.engineId!==d.engineId||v.profileId!==d.profileId))throw new Error(`Normalized suite ${n.serviceName}/${c}:${n.suiteName} conflicts with file ${n.filePath}`);const S=l&&(d.skipReason||l.testkit.skip?.fileReasonByPath.get(n.filePath)||de(l,c,n.suiteName))||null;if(r.runnableOnly&&S)continue;const T=l?[...new Set([...fe(l,c,n.suiteName),...l.testkit.requirements.fileLocksByPath.get(n.filePath)||[],...d.locks])].sort():[],j=a.get(n.serviceName)?.dependsOn||[],w=te({serviceName:n.serviceName,suiteName:n.suiteName,testType:c,filePath:n.filePath,engineId:d.engineId,profileId:d.profileId,skipReason:S,locks:T,runtimeIsolation:l&&v?_(l,v,n.filePath):V,dependsOn:j});y.push(w);const O=[n.serviceName,c,n.suiteName].join("|"),F=m.get(O);F?F.files.push(w):m.set(O,{serviceName:n.serviceName,testType:c,suiteName:n.suiteName,files:[w]})}const p=[...m.values()].map(n=>oe(n.serviceName,n.testType,n.suiteName,n.files,a.get(n.serviceName)?.dependsOn||[]));for(const n of p){const c=a.get(n.service)||{name:n.service,discovered:!0,localCwd:o.services[n.service]?.inferredLocalCwd||".",dependsOn:[...s[n.service]?.dependsOn||[]],suiteCount:0,fileCount:0,activeFileCount:0,skippedFileCount:0};c.suiteCount+=1,c.fileCount+=n.fileCount,c.activeFileCount+=n.activeFileCount,c.skippedFileCount+=n.skippedFileCount,a.set(n.service,c)}return{services:[...a.values()].sort((n,c)=>n.name.localeCompare(c.name)),suites:p.sort(ve),files:y.sort(ge)}}function te(e){const t=testTypeContract(e.testType,e.engineId,e.profileId);return{id:me(e.serviceName,e.testType,e.engineId,e.profileId,e.filePath),path:e.filePath,displayName:fileDisplayName(e.filePath),service:e.serviceName,suiteName:e.suiteName,groupLabel:formatDisplayName(e.suiteName),testType:e.testType,engineId:e.engineId,profileId:e.profileId,skipped:!!e.skipReason,skipReason:e.skipReason,locks:e.locks,runtimeIsolation:e.runtimeIsolation,dependsOn:[...e.dependsOn],contract:t}}function oe(e,t,i,o,s){const r=ne(e,t,i,o),u=o.filter(a=>a.skipped).length;return{id:pe(e,t,r.engineId,r.profileId,i),service:e,name:i,displayName:formatDisplayName(i),testType:t,engineId:r.engineId,profileId:r.profileId,groupLabel:formatDisplayName(i),fileCount:o.length,activeFileCount:o.length-u,skippedFileCount:u,dependsOn:[...s],locks:[...new Set(o.flatMap(a=>a.locks))].sort(),filePaths:o.map(a=>a.path),contract:r.contract}}function ne(e,t,i,o){const s=o[0];for(const r of o.slice(1))if(r.engineId!==s.engineId||r.profileId!==s.profileId)throw new Error(`Discovery suite ${e}/${t}:${i} mixes engine profiles ${s.engineId}/${s.profileId} and ${r.engineId}/${r.profileId}`);return{contract:s.contract,engineId:s.engineId,profileId:s.profileId}}function x(e){return{...e,diagnostics:e.diagnostics.sort(ye),summary:Y({diagnostics:e.diagnostics,files:e.files,serviceCount:e.services.length,suiteCount:e.suites.length})}}function re(e,t,i){if(!e)return;const o=new Set([...Object.keys(t),...Object.keys(i.services),...Object.keys(i.suitesByService)]);if(o.has(e))return;const s=[...o].sort((r,u)=>r.localeCompare(u)).join(", ");throw new Error(s.length>0?`Service "${e}" not found. Available: ${s}`:`Service "${e}" not found.`)}function se(e){const t=ce(Q(N(e.type))),i=W(N(e.suite)),o=N(e.file).map(b);return{typeValues:t,suiteSelectors:i,fileNames:o,fileNameSet:new Set(o),serviceFilter:e.service||null,runnableOnly:!!e.runnableOnly,diagnosticsMode:e.diagnostics==="error"?"error":"report"}}function ce(e){const t=[];for(const i of e){if(!L(i))throw new Error(`Discovery produced unsupported test type "${i}".`);t.push(i)}return t}function ae(e){const t=I(f(e,"services")),i={};for(const[o,s]of Object.entries(t)){const r=I(s),u=I(f(r,"local"));i[o]={dependsOn:ue(f(r,"dependsOn")),discovery:D(f(r,"discovery")),localCwd:b(f(u,"cwd")||"."),localDisabled:f(r,"local")===!1}}return{discovery:D(f(e,"discovery")),services:i}}function le(e){const t={};for(const[i,o]of Object.entries(e))o&&(t[i]={discovery:o.discovery,local:o.localDisabled?!1:{baseUrl:"",cwd:o.localCwd,env:{},start:""}});return t}function D(e){try{return G(e,{allowRoots:!0})}catch{return{}}}function ue(e){return Array.isArray(e)?e.filter(i=>typeof i=="string"):[]}function de(e,t,i){for(const o of e.testkit.skip?.suites||[])if(k(t,i,[o.selector]))return o.reason;return null}function fe(e,t,i){const o=new Set;for(const s of e.testkit.requirements.suites)if(k(t,i,[s.selector]))for(const r of s.locks)o.add(r);return[...o].sort()}function N(e){return Array.isArray(e)?e.filter(i=>i!=null).map(i=>h(i)):e==null||e===""?[]:[h(e)]}function b(e){return h(e).split(g.sep).join("/").replace(/^\.\/+/,"")}export function fileDisplayName(e){const t=new RegExp(`\\.(${H.join("|")})\\.testkit\\.ts$`),i=g.posix.basename(e).replace(t,"");return formatDisplayName(i)}function pe(e,t,i,o,s){return[e,t,i,o,s].join("|")}function me(e,t,i,o,s){return[e,t,i,o,b(s)].join("|")}function ve(e,t){return e.service.localeCompare(t.service)||e.testType.localeCompare(t.testType)||e.name.localeCompare(t.name)}function ge(e,t){return e.service.localeCompare(t.service)||e.testType.localeCompare(t.testType)||e.suiteName.localeCompare(t.suiteName)||e.path.localeCompare(t.path)}function ye(e,t){return E(e.severity)-E(t.severity)||e.code.localeCompare(t.code)||(e.path||"").localeCompare(t.path||"")}function E(e){return e==="error"?1:2}

package/dist/config/loader/discovery-summary.d.ts

@@ -0,0 +1,29 @@
+export interface DiscoverySummary {
+    activeFiles: number;
+    byService: Record<string, number>;
+    byTestType: Record<string, number>;
+    diagnostics: {
+        errors: number;
+        warnings: number;
+    };
+    files: number;
+    services: number;
+    skippedFiles: number;
+    suites: number;
+}
+export interface DiscoverySummaryDiagnosticInput {
+    severity: "error" | "warning";
+}
+export interface DiscoverySummaryFileInput {
+    service: string;
+    skipped: boolean;
+    testType: string;
+}
+export interface BuildDiscoverySummaryInput {
+    diagnostics: readonly DiscoverySummaryDiagnosticInput[];
+    files: readonly DiscoverySummaryFileInput[];
+    serviceCount: number;
+    suiteCount: number;
+}
+export declare function buildDiscoverySummary(input: Readonly<BuildDiscoverySummaryInput>): DiscoverySummary;
+export declare function emptyDiscoverySummary(): DiscoverySummary;

package/dist/config/loader/discovery-summary.js

@@ -0,0 +1 @@
+export function buildDiscoverySummary(s){const i={},r={};for(const e of s.files)i[e.service]=(i[e.service]||0)+1,r[e.testType]=(r[e.testType]||0)+1;return{activeFiles:s.files.filter(e=>!e.skipped).length,byService:i,byTestType:r,diagnostics:{errors:s.diagnostics.filter(e=>e.severity==="error").length,warnings:s.diagnostics.filter(e=>e.severity==="warning").length},files:s.files.length,services:s.serviceCount,skippedFiles:s.files.filter(e=>e.skipped).length,suites:s.suiteCount}}export function emptyDiscoverySummary(){return{activeFiles:0,byService:{},byTestType:{},diagnostics:{errors:0,warnings:0},files:0,services:0,skippedFiles:0,suites:0}}

package/dist/config/loader/discovery.d.ts

@@ -0,0 +1,54 @@
+import type { PublicTestType } from "../../domain/identifiers.js";
+import type { ServiceConfig } from "../authoring/index.js";
+export type DiscoveryServiceConfig = Pick<ServiceConfig, "discovery" | "local">;
+export type DiscoveryServices = Readonly<Record<string, DiscoveryServiceConfig | null | undefined>>;
+export interface DiscoveryOptions {
+    discovery?: unknown;
+    strict?: boolean;
+}
+export interface DiscoveredService {
+    inferredLocalCwd: string;
+    name: string;
+    source: string;
+}
+export interface DiscoveredSuite {
+    files: string[];
+    name: string;
+}
+export type DiscoveredSuitesByService = Partial<Record<string, Partial<Record<PublicTestType, DiscoveredSuite[]>>>>;
+export interface DiscoveredFile {
+    filePath: string;
+    serviceName: string;
+    suiteName: string;
+    suitePath: string[];
+    testType: PublicTestType;
+}
+interface DiscoveryDiagnosticBase {
+    message: string;
+    path: string;
+    severity: "error";
+}
+export interface LegacyDiscoveryDiagnostic extends DiscoveryDiagnosticBase {
+    code: "legacy_path";
+}
+export interface UnownedDiscoveryDiagnostic extends DiscoveryDiagnosticBase {
+    code: "unowned_test";
+}
+export interface AmbiguousDiscoveryDiagnostic extends DiscoveryDiagnosticBase {
+    code: "ambiguous_test";
+    serviceNames: string[];
+}
+export type DiscoveryDiagnostic = AmbiguousDiscoveryDiagnostic | LegacyDiscoveryDiagnostic | UnownedDiscoveryDiagnostic;
+export interface DiscoveryProject {
+    diagnostics: DiscoveryDiagnostic[];
+    files: DiscoveredFile[];
+    services: Partial<Record<string, DiscoveredService>>;
+    suitesByService: DiscoveredSuitesByService;
+}
+export declare function discoverProject(productDir: string, explicitServices?: DiscoveryServices, options?: DiscoveryOptions): DiscoveryProject;
+export declare function discoverSuites(productDir: string, explicitServices?: DiscoveryServices, options?: DiscoveryOptions): DiscoveredSuitesByService;
+export declare function hasDiscoveryErrors(diagnostics?: readonly ({
+    severity?: unknown;
+} | null | undefined)[]): boolean;
+export declare function buildDiscoveryErrorFromDiagnostics(diagnostics?: readonly DiscoveryDiagnostic[]): Error;
+export {};

package/dist/config/loader/discovery.js

@@ -0,0 +1,2 @@
+import R from"fs";import h from"path";import{DEFAULT_DISCOVERY_EXCLUDES as k,normalizeDiscoveryPath as L,resolveDiscoveryRoots as K,shouldExcludeDiscoveryPath as F}from"./path-policy.js";import{normalizeDiscoveryConfig as D}from"./decode-discovery.js";const C=String,E="__testkit__",z=[{suffix:".int.testkit.ts",testType:"int"},{suffix:".e2e.testkit.ts",testType:"e2e"},{suffix:".contract.testkit.ts",testType:"contract"},{suffix:".data.testkit.ts",testType:"data"},{suffix:".dal.testkit.ts",testType:"dal"},{suffix:".load.testkit.ts",testType:"load"},{suffix:".ui.testkit.ts",testType:"ui"}];export function discoverProject(t,e={},n={}){const r=n.strict!==!1,o=D(n.discovery,{allowRoots:!0}),{suiteFiles:s,legacyFiles:a}=O(t,o),i={},p={},u=Y(a),g=[];for(const c of s){const l=N(c);if(!l)continue;const f=A(c,e,o);if(f===null)continue;if(f.length===0){u.push({code:"unowned_test",severity:"error",message:`Unowned test file: ${c}`,path:c});continue}if(f.length>1){u.push({code:"ambiguous_test",severity:"error",message:`Ambiguous test file: ${c} -> ${f.map(v=>v.name).sort((v,m)=>v.localeCompare(m)).join(", ")}`,path:c,serviceNames:f.map(v=>v.name).sort((v,m)=>v.localeCompare(m))});continue}const d=f[0];p[d.name]=W(p[d.name],d);const y=V(d,c),w=q(y,l.suffix);g.push({serviceName:d.name,testType:l.testType,filePath:c,suitePath:w.suitePath})}if(r&&hasDiscoveryErrors(u))throw buildDiscoveryErrorFromDiagnostics(u);for(const c of g){const l=i[c.serviceName]||{},f=l[c.testType]||[],d=c.suitePath.join("/");let y=f.find(w=>w._suiteKey===d);y||(y={files:[],_suiteKey:d,_suitePath:c.suitePath},f.push(y),l[c.testType]=f,i[c.serviceName]=l),y.files.push(c.filePath)}const _=[],T={};for(const[c,l]of Object.entries(i)){if(!l)continue;const f={};for(const[d,y]of Object.entries(l)){if(!y)continue;const w=B(y),v=[];for(const m of y){const P=M(w,m._suiteKey);m.files.sort((S,$)=>S.localeCompare($));for(const S of m.files)_.push({serviceName:c,testType:d,suiteName:P,suitePath:[...m._suitePath],filePath:S});v.push({name:P,files:m.files})}f[d]=v.sort((m,P)=>m.name.localeCompare(P.name))}T[c]=f}return{services:p,suitesByService:T,files:_.sort((c,l)=>c.serviceName.localeCompare(l.serviceName)||c.testType.localeCompare(l.testType)||c.suiteName.localeCompare(l.suiteName)||c.filePath.localeCompare(l.filePath)),diagnostics:u}}export function discoverSuites(t,e={},n={}){return discoverProject(t,e,n).suitesByService}export function hasDiscoveryErrors(t=[]){return t.some(e=>e?.severity==="error")}export function buildDiscoveryErrorFromDiagnostics(t=[]){const e=["Filesystem discovery failed for one or more .testkit.ts files."],n=t.filter(s=>s.code==="legacy_path").map(s=>s.path),r=t.filter(s=>s.code==="unowned_test").map(s=>s.path),o=t.filter(s=>s.code==="ambiguous_test");if(n.length>0){e.push(""),e.push("Legacy test files outside __testkit__:");for(const s of n)e.push(`- ${s}`)}if(r.length>0){e.push(""),e.push("Unowned test files:");for(const s of r)e.push(`- ${s}`)}if(o.length>0){e.push(""),e.push("Ambiguous test files:");for(const s of o)e.push(`- ${s.path} -> ${s.serviceNames.join(", ")}`)}return e.push(""),e.push('Expected test files to live under a "__testkit__" directory within a service root.'),new Error(e.join(`
+`))}function O(t,e={}){const n=[],r=[],o=[...new Set([...k,...(e.exclude||[]).map(x)])],s=K(t,e.roots,".");for(;s.length>0;){const a=s.pop();if(a!==void 0)for(const i of R.readdirSync(a,{withFileTypes:!0})){const p=h.join(a,i.name);if(i.isSymbolicLink())continue;if(i.isDirectory()){const g=L(h.relative(t,p));if(F(g,o))continue;s.push(p);continue}if(!i.isFile())continue;const u=x(h.relative(t,p));N(u)&&(u.split("/").includes(E)?n.push(u):r.push(u))}}return{suiteFiles:n.sort((a,i)=>a.localeCompare(i)),legacyFiles:r.sort((a,i)=>a.localeCompare(i))}}function A(t,e,n={}){const r=Object.entries(e).flatMap(([i,p])=>I(i,p,n));if(r.length===0)return[{name:"app",source:"implicit-root",cwdPrefix:"."}];const o=r.filter(i=>i.depth===0||i.matchPrefix&&b(t,i.matchPrefix)),s=o.filter(i=>U(i,t));if(s.length===0)return o.length>0&&o.every(i=>j(i,t))?null:[];const a=Math.max(...s.map(i=>i.depth));return s.filter(i=>i.depth===a)}function B(t){const e=new Map,n=new Map;for(const r of t){const o=r._suitePath;let s="";for(let a=1;a<=o.length;a+=1){s=o.slice(-a).join("-");const i=e.get(s);if(!i){e.set(s,r._suiteKey);break}if(i===r._suiteKey)break;s=""}s||(s=o.join("-")),n.set(r._suiteKey,s)}if(n.size!==t.length)for(const r of t)n.has(r._suiteKey)||n.set(r._suiteKey,r._suitePath.join("-"));if(new Set(n.values()).size!==t.length){const r=new Map;for(const o of t){const s=o._suitePath.join("-"),a=r.get(s)||0;r.set(s,a+1),n.set(o._suiteKey,a===0?s:`${s}-${C(a+1)}`)}}return n}function M(t,e){const n=t.get(e);if(n===void 0)throw new Error(`Discovery suite name was not resolved for "${e}"`);return n}function I(t,e,n={}){const r=e?.local,o=x(r&&r.cwd||"."),s=D(e?.discovery,{allowRoots:!0}),a=Array.isArray(s.roots)&&s.roots.length>0?s.roots:["."],i=(s.exclude||[]).map(u=>x(o==="."?u:h.posix.join(o,u))),p=[...new Set([...k,...(n.exclude||[]).map(x),...i])];return a.map(u=>{const g=x(u||"."),_=o==="."?g:g==="."?o:x(h.posix.join(o,g));return{name:t,source:"cwd",cwdPrefix:o==="."?null:o,matchPrefix:_==="."?null:_,depth:_==="."?0:_.split("/").filter(Boolean).length,exclude:p}})}function U(t,e){return j(t,e)?!1:!!(t.depth===0||t.matchPrefix&&b(e,t.matchPrefix))}function V(t,e){return t.matchPrefix&&b(e,t.matchPrefix)?h.posix.relative(t.matchPrefix,e):t.cwdPrefix&&b(e,t.cwdPrefix)?h.posix.relative(t.cwdPrefix,e):e}function j(t,e){return F(x(e),t.exclude)}function q(t,e){const n=t.split("/").filter(Boolean),r=n.indexOf(E);if(r===-1)return{suitePath:[h.posix.basename(t,e)]};const o=n.slice(0,r),s=n.slice(r+1);return s.length===0?{suitePath:[h.posix.basename(t,e)]}:s.length===1?o.length===0?{suitePath:[h.posix.basename(s[0],e)]}:{suitePath:o}:{suitePath:[...o,s[0]]}}function W(t,e){return t?{...t,inferredLocalCwd:t.inferredLocalCwd==="."?e.cwdPrefix||".":t.inferredLocalCwd}:{name:e.name,inferredLocalCwd:e.cwdPrefix||".",source:e.source}}function N(t){return z.find(e=>t.endsWith(e.suffix))||null}function b(t,e){return t===e||t.startsWith(`${e}/`)}function x(t){const e=C(t).split(h.sep).join("/");return e==="."||e==="./"?".":e.replace(/^\.\/+/,"").replace(/\/+$/,"")||"."}function Y(t){return t.map(e=>({code:"legacy_path",severity:"error",message:`Legacy test file outside __testkit__: ${e}`,path:e}))}

package/dist/config/loader/env.d.ts

@@ -0,0 +1,4 @@
+import { parseDotenv } from "../../process/files/dotenv.js";
+export { parseDotenv };
+export declare function inferEnvFiles(productDir: string, explicitService: unknown, local: unknown): string[];
+export declare function loadServiceEnv(productDir: string, envFiles: readonly string[]): Record<string, string>;

package/dist/config/loader/env.js

@@ -0,0 +1 @@
+import h from"fs";import p from"path";import{parseDotenv as u}from"../../process/files/dotenv.js";import{resolveServiceCwd as l}from"./paths.js";export{u as parseDotenv};export function inferEnvFiles(n,r,e){const o=m(r,"service config"),d=m(e,"local config"),s=a(o?.envFile,"service.envFile"),f=v(o?.envFiles,"service.envFiles");if(s||f){const t=[];return s&&t.push(s),f&&t.push(...f),t}const i=[],c=a(d?.cwd,"service.local.cwd")??".";return c!=="."&&(i.push(p.posix.join(c,".env.testkit")),i.push(p.posix.join(c,".env"))),i.push(".env.testkit"),i.push(".env"),[...new Set(i)].map(t=>t.split(p.sep).join("/")).filter(t=>h.existsSync(l(n,t)))}export function loadServiceEnv(n,r){const e={};for(const o of r)Object.assign(e,u(l(n,o)));return e}function m(n,r){if(n!=null){if(!w(n))throw new Error(`${r} must be an object`);return n}}function a(n,r){if(n!=null){if(typeof n!="string"||n.trim().length===0)throw new Error(`${r} must be a non-empty string`);return n.trim()}}function v(n,r){if(n!=null){if(!g(n))throw new Error(`${r} must be an array of non-empty strings`);return n.map(e=>{if(typeof e!="string"||e.trim().length===0)throw new Error(`${r} must be an array of non-empty strings`);return e.trim()})}}function w(n){return typeof n=="object"&&n!==null&&!Array.isArray(n)}function g(n){return Array.isArray(n)}

package/dist/config/loader/execution-model.d.ts

@@ -0,0 +1,16 @@
+export type DatabaseBinding = "per-runtime" | "shared";
+export interface ExecutionConfigInput {
+    readonly [key: string]: unknown;
+    readonly fileTimeoutSeconds?: unknown;
+    readonly taskConcurrency?: unknown;
+    readonly workers?: unknown;
+}
+export interface ResolveExecutionConfigInput {
+    cli?: ExecutionConfigInput;
+    repo?: ExecutionConfigInput;
+}
+export interface NormalizedExecutionConfig {
+    fileTimeoutSeconds: number;
+    taskConcurrency: number;
+}
+export declare const DATABASE_BINDINGS: Set<DatabaseBinding>;

package/dist/config/loader/execution-model.js

@@ -0,0 +1 @@
+export const DATABASE_BINDINGS=new Set(["shared","per-runtime"]);

package/dist/config/loader/file-metadata.d.ts

@@ -0,0 +1,19 @@
+import ts from "typescript";
+import { type EngineId, type RunnerProfileId } from "../../domain/identifiers.js";
+import { type RuntimeIsolationPolicy } from "./runtime-isolation.js";
+import { type EngineAuthoringProfile } from "../../engines/catalog.js";
+export interface TestFileMetadata {
+    engineId: EngineId;
+    locks: string[];
+    profileId: RunnerProfileId;
+    runtimeIsolation: null | RuntimeIsolationPolicy;
+    skipReason: null | string;
+}
+export interface TestFileMetadataSuite {
+    files?: readonly string[];
+}
+export type TestFileMetadataSuitesByService = Readonly<Record<string, Readonly<Record<string, readonly TestFileMetadataSuite[] | undefined>> | undefined>>;
+export declare function loadTestFileMetadataMap(productDir: string, suitesByService?: null | TestFileMetadataSuitesByService, metadataByPath?: Map<string, TestFileMetadata>): Map<string, TestFileMetadata>;
+export declare function readTestFileMetadata(productDir: string, filePath: string): TestFileMetadata;
+export declare function requireMatchingEngineAuthoringImports(sourceFile: ts.SourceFile, filePath: string, metadata: Readonly<EngineAuthoringProfile>): void;
+export declare function collectModuleSpecifiers(sourceFile: ts.SourceFile): ReadonlySet<string>;

package/dist/config/loader/file-metadata.js

@@ -0,0 +1 @@
+import{isPathWithin as w}from"../../process/files/paths.js";import g from"fs";import S from"path";import i from"typescript";import{ENGINE_IDS as $,PUBLIC_TEST_TYPES as M,isEngineId as R}from"../../domain/identifiers.js";import{normalizeRuntimeIsolationPolicy as A}from"./runtime-isolation.js";import{resolveEngineProfile as O,expectedEngineAuthoringModule as j,invalidEngineAuthoringImport as B,requireMatchingHostImport as K}from"../../engines/catalog.js";const f="@gfdelarue/testkit",V="@gfdelarue/testkit-engine-";export function loadTestFileMetadataMap(e,t={},r=new Map){for(const s of Object.values(t||{}))for(const n of Object.values(s||{}))for(const o of n||[])for(const a of o.files||[])r.has(a)||r.set(a,readTestFileMetadata(e,a));return r}export function readTestFileMetadata(e,t){const r=pe(e,t),s=fe(t),n=g.readFileSync(r,"utf8"),o=i.createSourceFile(r,n,i.ScriptTarget.Latest,!0,i.ScriptKind.TS),a=me(o);if(a.length>0){const p=a.map(m=>i.flattenDiagnosticMessageText(m.messageText," ")).join("; ");throw c(t,`TypeScript syntax is invalid: ${p}`)}let u=null,l=null;for(const p of o.statements)if(!(!i.isVariableStatement(p)||!H(p))){for(const m of p.declarationList.declarations)if(!(!i.isIdentifier(m.name)||m.name.text!=="testkit")){if(u)throw c(t,'exported "testkit" metadata must be declared exactly once');if(!X(p))throw c(t,'exported "testkit" metadata must be const');u=m,l=p}}if(!u||!l)throw c(t,'export const testkit = defineFile({ engine: "..." }) is required');Q(o,l,t);const y=_(u.initializer,t,s);return requireMatchingEngineAuthoringImports(o,t,y),y}function _(e,t,r){if(!e)throw c(t,'exported "testkit" metadata has no value');if(!i.isCallExpression(e))throw c(t,"testkit metadata must use defineFile({ ... })");if(J(e.expression)!=="defineFile")throw c(t,"testkit metadata must call defineFile");if(e.arguments.length!==1)throw c(t,"defineFile metadata must receive exactly one object literal");const s=e.arguments[0];if(!i.isObjectLiteralExpression(s))throw c(t,"defineFile metadata must receive an object literal");return W(s,t,r)}function W(e,t,r){const s={locks:[],runtimeIsolation:null,skipReason:null};let n=null;const o=new Set;for(const u of e.properties){if(i.isSpreadAssignment(u))throw c(t,"testkit metadata may not contain spread properties");if(!i.isPropertyAssignment(u))throw c(t,"testkit metadata properties must use key: value assignments");const l=L(u.name,t,"testkit metadata");if(!Y(l))throw c(t,`unknown metadata property "${l}"`);if(o.has(l))throw c(t,`duplicate metadata property "${l}"`);if(o.add(l),l==="engine"){n=I(u.initializer,t,'metadata property "engine"');continue}if(l==="locks"){s.locks=z(u.initializer,t);continue}if(l==="skip"){s.skipReason=G(u.initializer,t);continue}s.runtimeIsolation=U(u.initializer,t)}if(!n)throw c(t,'a literal "engine" property is required');if(!R(n))throw c(t,`unsupported engine "${n}"; expected one of: ${$.join(", ")}`);let a;try{a=O(r,n)}catch(u){throw c(t,C(u),u)}return{engineId:n,locks:s.locks,profileId:a.id,runtimeIsolation:s.runtimeIsolation,skipReason:s.skipReason}}function z(e,t){if(!i.isArrayLiteralExpression(e))throw c(t,'metadata property "locks" must be an array');const r=[];for(const s of e.elements){if(i.isSpreadElement(s)||i.isOmittedExpression(s))throw c(t,'metadata property "locks" must contain only string literals');r.push(h(s,t,'metadata property "locks" entry'))}return[...new Set(r)].sort()}function G(e,t){const r=x(e);if(r!==null)return b(r,t,'metadata property "skip"').trim();if(!i.isObjectLiteralExpression(e))throw c(t,'metadata property "skip" must be a string literal or { reason: string literal }');if(e.properties.length!==1)throw c(t,'metadata property "skip" object must contain exactly one reason property');const s=e.properties[0];if(!i.isPropertyAssignment(s))throw c(t,'metadata property "skip" reason must use a string-literal assignment');if(L(s.name,t,'metadata property "skip"')!=="reason")throw c(t,'metadata property "skip" object only accepts "reason"');return h(s.initializer,t,'metadata property "skip.reason"')}function U(e,t){const r=I(e,t,'metadata property "runtimeIsolation"');try{return A(r,"defineFile runtimeIsolation")}catch(s){throw c(t,C(s),s)}}function J(e){return i.isIdentifier(e)?e.text:null}function L(e,t,r){if(i.isIdentifier(e)||i.isStringLiteral(e))return e.text;throw c(t,`${r} property names must be plain identifiers or string literals`)}function x(e){return i.isStringLiteral(e)||i.isNoSubstitutionTemplateLiteral(e)?e.text:null}function I(e,t,r){const s=x(e);if(s===null)throw c(t,`${r} must be a string literal`);return b(s,t,r)}function h(e,t,r){return I(e,t,r).trim()}function b(e,t,r){if(e.trim().length===0)throw c(t,`${r} must not be empty`);return e}function H(e){return(e.modifiers||[]).some(t=>t.kind===i.SyntaxKind.ExportKeyword)}function X(e){return(e.declarationList.flags&i.NodeFlags.Const)!==0}function Y(e){return["engine","locks","runtimeIsolation","skip"].includes(e)}function Q(e,t,r){let s=null,n=0;for(const o of e.statements){if(i.isImportDeclaration(o)){const a=o.importClause;if(!a||a.phaseModifier===i.SyntaxKind.TypeKeyword)continue;a.name?.text==="defineFile"&&(n+=1);const u=a.namedBindings;if(u&&i.isNamespaceImport(u)){u.name.text==="defineFile"&&(n+=1);continue}if(!u||!i.isNamedImports(u))continue;for(const l of u.elements){if(l.isTypeOnly||l.name.text!=="defineFile")continue;if(n+=1,(l.propertyName?.text??l.name.text)==="defineFile"&&i.isStringLiteral(o.moduleSpecifier)&&o.moduleSpecifier.text===f){if(s)throw c(r,`defineFile must have exactly one named value import from "${f}"`);s=o}}continue}n+=le(o)}if(!s)throw c(r,`defineFile must be a named value import from "${f}"`);if(n!==1)throw c(r,"the imported defineFile binding may not be shadowed or redeclared");if(s.getStart(e)>t.getStart(e))throw c(r,"the defineFile import must precede metadata")}export function requireMatchingEngineAuthoringImports(e,t,r){Z(e,t,r);const s=j(r.profileId);for(const n of collectModuleSpecifiers(e))if(K(t,r,n),!(n===f||n===s||!n.startsWith(`${f}/`)&&!n.startsWith(V)))throw B(t,r,n,s)}function Z(e,t,r){const s=F(e),n=o=>{if(P(o,t,r),ee(o,s,t,r),i.isCallExpression(o)&&D(o,s)){const a=o.arguments.at(0);if(!a||!i.isStringLiteralLike(a)){const u=o.expression.kind===i.SyntaxKind.ImportKeyword?"import()":"require()";throw new Error(`Invalid Testkit authoring in "${t}": ${r.engineId}/${r.profileId} may not use non-literal ${u}; module specifiers must be string literals so engine boundaries can be verified`)}}for(const a of q(o))n(a);i.forEachChild(o,n)};n(e)}function D(e,t){return e.expression.kind===i.SyntaxKind.ImportKeyword||i.isIdentifier(e.expression)&&e.expression.text==="require"&&!E(e.expression,t)}function P(e,t,r){if(i.isImportDeclaration(e)){const n=e.importClause?.namedBindings;if(n&&i.isNamedImports(n)&&n.elements.find(a=>!a.isTypeOnly&&(a.propertyName?.text??a.name.text)==="createRequire"))throw d(t,r,"createRequire")}if(i.isPropertyAccessExpression(e)&&e.name.text==="createRequire"||i.isElementAccessExpression(e)&&x(e.argumentExpression)==="createRequire"||i.isBindingElement(e)&&(ne(e)==="createRequire"||i.isIdentifier(e.name)&&e.name.text==="createRequire"))throw d(t,r,"createRequire")}function ee(e,t,r,s){if(i.isPropertyAccessExpression(e)&&e.name.text==="require"&&T(e.expression,t)||i.isElementAccessExpression(e)&&x(e.argumentExpression)==="require"&&T(e.expression,t))throw d(r,s,e.getText());if(i.isIdentifier(e)&&e.text==="require"&&!E(e,t)&&!te(e)&&!ie(e))throw d(r,s,"global require")}function d(e,t,r){return new Error(`Invalid Testkit authoring in "${e}": ${t.engineId}/${t.profileId} may not alias or indirectly access the module loader through ${r}; use literal import and require specifiers so engine boundaries can be verified`)}function T(e,t){return i.isIdentifier(e)&&(e.text==="globalThis"||e.text==="module")&&!E(e,t)}function te(e){return i.isCallExpression(e.parent)&&e.parent.expression===e}function ie(e){const t=e.parent;return re(e)||i.isPropertyAccessExpression(t)&&t.name===e||i.isPropertyAssignment(t)&&t.name===e||i.isImportSpecifier(t)&&t.propertyName===e||i.isExportSpecifier(t)&&t.parent.parent.moduleSpecifier!==void 0}function re(e){const t=e.parent;return t.name===e&&!i.isShorthandPropertyAssignment(t)&&!i.isExportSpecifier(t)}function ne(e){const t=e.propertyName;return t&&(i.isIdentifier(t)||i.isStringLiteralLike(t))?t.text:null}function F(e){const t=new WeakMap,r=(n,o)=>{let a=t.get(n);a||(a=new Set,t.set(n,a)),N(a,o)},s=n=>{if(i.isImportDeclaration(n))se(n,e,r);else if(i.isImportEqualsDeclaration(n)&&!n.isTypeOnly)r(e,n.name);else if(i.isVariableDeclaration(n)){const o=n.parent,a=i.isVariableDeclarationList(o)&&(o.flags&i.NodeFlags.BlockScoped)===0?oe(n):k(n);r(a,n.name)}else i.isParameter(n)?r(ae(n),n.name):i.isFunctionDeclaration(n)&&n.name?r(k(n),n.name):i.isFunctionExpression(n)&&n.name?r(n,n.name):(i.isClassDeclaration(n)||i.isEnumDeclaration(n)||i.isModuleDeclaration(n))&&n.name&&i.isIdentifier(n.name)?r(k(n),n.name):i.isClassExpression(n)&&n.name?r(n,n.name):i.isCatchClause(n)&&n.variableDeclaration&&r(n,n.variableDeclaration.name);i.forEachChild(n,s)};return s(e),t}function se(e,t,r){const s=e.importClause;if(!s||s.phaseModifier===i.SyntaxKind.TypeKeyword)return;s.name&&r(t,s.name);const n=s.namedBindings;if(n&&i.isNamespaceImport(n))r(t,n.name);else if(n&&i.isNamedImports(n))for(const o of n.elements)o.isTypeOnly||r(t,o.name)}function N(e,t){if(i.isIdentifier(t)){e.add(t.text);return}for(const r of t.elements)i.isOmittedExpression(r)||N(e,r.name)}function E(e,t){let r=e;for(;;){if(t.get(r)?.has(e.text))return!0;if(i.isSourceFile(r))return!1;r=r.parent}}function k(e){let t=e.parent;for(;;){if(ce(t))return t;t=t.parent}}function oe(e){let t=e.parent;for(;;){if(i.isFunctionLike(t)||i.isSourceFile(t))return t;t=t.parent}}function ae(e){let t=e.parent;for(;;){if(i.isFunctionLike(t)||i.isSourceFile(t))return t;t=t.parent}}function ce(e){return i.isSourceFile(e)||i.isBlock(e)||i.isCaseBlock(e)||i.isCatchClause(e)||i.isForStatement(e)||i.isForInStatement(e)||i.isForOfStatement(e)||i.isFunctionLike(e)||i.isClassStaticBlockDeclaration(e)}export function collectModuleSpecifiers(e){const t=new Set,r=F(e),s=n=>{const o=ue(n,r);o&&t.add(o);for(const a of q(n))s(a);i.forEachChild(n,s)};return s(e),t}function q(e){return e.jsDoc??[]}function ue(e,t){if(i.isJSDocImportTag(e)&&i.isStringLiteralLike(e.moduleSpecifier)||(i.isImportDeclaration(e)||i.isExportDeclaration(e))&&e.moduleSpecifier&&i.isStringLiteralLike(e.moduleSpecifier))return e.moduleSpecifier.text;if(i.isImportEqualsDeclaration(e)&&i.isExternalModuleReference(e.moduleReference)&&i.isStringLiteralLike(e.moduleReference.expression))return e.moduleReference.expression.text;if(i.isImportTypeNode(e)){const s=e.argument;if(i.isLiteralTypeNode(s)&&i.isStringLiteralLike(s.literal))return s.literal.text}if(!i.isCallExpression(e)||!D(e,t))return null;const r=e.arguments[0];return i.isStringLiteralLike(r)?r.text:null}function le(e){return i.isVariableStatement(e)?e.declarationList.declarations.reduce((t,r)=>t+v(r.name,"defineFile"),0):(i.isClassDeclaration(e)||i.isEnumDeclaration(e)||i.isFunctionDeclaration(e))&&e.name?.text==="defineFile"?1:0}function v(e,t){return i.isIdentifier(e)?e.text===t?1:0:e.elements.reduce((r,s)=>i.isOmittedExpression(s)?r:r+v(s.name,t),0)}function pe(e,t){const r=S.resolve(e);if(S.isAbsolute(t))throw new Error(`Test file metadata path must be product-relative: ${t}`);const s=S.resolve(r,t);if(!w(r,s))throw new Error(`Test file metadata path escapes the product root: ${t}`);if(!g.existsSync(s))throw new Error(`Test file metadata source does not exist: ${t}`);const n=g.realpathSync(r),o=g.realpathSync(s);if(!w(n,o))throw new Error(`Test file metadata path resolves outside the product root: ${t}`);return o}function me(e){return e.parseDiagnostics??[]}function fe(e){const t=M.find(r=>e.endsWith(`.${r}.testkit.ts`));if(t)return t;throw new Error(`Cannot read Testkit file metadata from noncanonical path: ${e}`)}function c(e,t,r){return new Error(`Invalid testkit metadata in "${e}": ${t}.`,{cause:r})}function C(e){return e instanceof Error?e.message.replace(/\.$/u,""):String(e)}

package/dist/config/loader/index.d.ts

@@ -0,0 +1,10 @@
+export { loadConfigContext, loadConfigs, parseDotenv, resolveProductDir, resolveServiceCwd, type LoadConfigContextOptions, type LoadConfigsOptions, type NormalizedConfigContext, type NormalizedLoadedDatabaseConfig, type NormalizedLocalServiceConfig, type NormalizedServiceConfig, type NormalizedServiceTestkitConfig, type NormalizedSuiteConfig, type ServiceSuites, } from "./load.js";
+export { discoverTests, fileDisplayName, formatDisplayName, testTypeContract, type DiscoverTestsOptions, type DiscoveryDiagnostic, type DiscoveryFile, type DiscoveryResult, type DiscoveryService, type DiscoverySuite, type DiscoverySummary, type DiscoveryTestContract, type DiscoveryTestType, } from "./discover-tests.js";
+export { findConfigFile, loadTestkitConfig } from "./config-loader.js";
+export { materializeDatabaseConfig, type DatabaseMaterializationInput, type MaterializedDatabaseConfig, } from "./database-materialization.js";
+export type { NormalizedDatabaseConfig, NormalizedDatabaseTemplateConfig, NormalizedSourceSchemaConfig, } from "./database.js";
+export { detectNextApp, type NormalizedRuntimeConfig } from "./runtime.js";
+export { DEFAULT_RUNTIME_ISOLATION_POLICY, resolveRuntimeIsolationPolicy, type RuntimeIsolationFileMetadata, type RuntimeIsolationPolicy, type RuntimeIsolationResolutionSuite, type RuntimeIsolationResolverConfig, type RuntimeIsolationResolverTestkitConfig, } from "./runtime-isolation.js";
+export { collectModuleSpecifiers, requireMatchingEngineAuthoringImports, type TestFileMetadata, } from "./file-metadata.js";
+export type { NormalizedSkipConfig } from "./skip-config.js";
+export { minimumConfirmingRuns } from "./cloud.js";

package/dist/config/loader/index.js

@@ -0,0 +1 @@
+export{loadConfigContext,loadConfigs,parseDotenv,resolveProductDir,resolveServiceCwd}from"./load.js";export{discoverTests,fileDisplayName,formatDisplayName,testTypeContract}from"./discover-tests.js";export{findConfigFile,loadTestkitConfig}from"./config-loader.js";export{materializeDatabaseConfig}from"./database-materialization.js";export{detectNextApp}from"./runtime.js";export{DEFAULT_RUNTIME_ISOLATION_POLICY,resolveRuntimeIsolationPolicy}from"./runtime-isolation.js";export{collectModuleSpecifiers,requireMatchingEngineAuthoringImports}from"./file-metadata.js";export{minimumConfirmingRuns}from"./cloud.js";