@gfdelarue/testkit 0.4.5 → 0.6.0

package/dist/engines/api/execution.d.ts

@@ -1,101 +0,0 @@
-import type { TestOutcomeStatus } from "../../domain/test-outcomes.js";
-import type { RunnerProfileDescriptor } from "./capabilities.js";
-import type { EngineEvidence, EngineFailureEvidence, EngineJsonObject, EngineJsonValue } from "./evidence.js";
-import type { EngineInvocationScope } from "./execution-scope.js";
-import type { EngineId, PublicTestType } from "../../domain/identifiers.js";
-export declare const ENGINE_TASK_DEADLINE_EXCEEDED_CODE: "TESTKIT_ENGINE_TASK_DEADLINE_EXCEEDED";
-export declare class EngineTaskDeadlineExceededError extends Error {
-    readonly code: "TESTKIT_ENGINE_TASK_DEADLINE_EXCEEDED";
-    readonly deadlineMs: number;
-    constructor(deadlineMs: number);
-}
-export declare const ENGINE_PROTOCOL_LIMITS: Readonly<{
-    cleanupTimeoutMs: 30000;
-}>;
-export interface EngineCancellationSignal {
-    readonly aborted: boolean;
-    readonly reason?: unknown;
-    addEventListener(type: "abort", listener: () => void, options?: Readonly<{
-        once?: boolean;
-    }>): void;
-    removeEventListener(type: "abort", listener: () => void): void;
-}
-export declare function isEngineTaskDeadlineExceededReason(value: unknown): value is Readonly<{
-    code: typeof ENGINE_TASK_DEADLINE_EXCEEDED_CODE;
-    deadlineMs: number;
-}>;
-export interface EngineExecutionTask {
-    readonly deadlineMs: number;
-    readonly file: string;
-    readonly id: string;
-    readonly inputs: EngineExecutionInputs;
-    readonly orchestration: EngineTaskOrchestration;
-    readonly serviceName: string;
-    readonly suiteName: string;
-    readonly testType: PublicTestType;
-    readonly timeoutMs: number;
-}
-export interface EngineTaskOrchestration {
-    readonly lease: EngineTaskLeaseIdentity;
-    readonly mode: string;
-    readonly runtimeId?: string;
-}
-export interface EngineTaskLeaseIdentity {
-    readonly directory: string;
-    readonly id: string;
-}
-export interface EngineExecutionInputs {
-    readonly configuration?: EngineJsonObject;
-    readonly environment: Readonly<Record<string, string>>;
-    readonly fixtures: Readonly<Record<string, EngineJsonValue>>;
-    readonly setupData?: EngineJsonValue;
-    readonly supportModules: Readonly<Record<string, string>>;
-}
-export interface EngineExecutionTarget {
-    readonly endpoints: Readonly<Record<string, string>>;
-    readonly inputs: EngineExecutionInputs;
-}
-export interface EngineExecutionWorkspace {
-    readonly artifactDirectory: string;
-    /** Optional caller-owned compilation cache, removed after all executions finish. */
-    readonly cacheDirectory?: string;
-    readonly rootDirectory: string;
-    readonly temporaryDirectory: string;
-}
-export interface EngineExecutionObserver {
-    evidenceRecorded(taskId: null | string, evidence: EngineEvidence): void;
-    taskFinished(outcome: EngineTaskOutcome): void;
-    taskStarted(task: EngineExecutionTask): void;
-}
-export interface EngineExecutionRequest<Id extends EngineId = EngineId> {
-    readonly invocationId: string;
-    readonly observer?: EngineExecutionObserver;
-    readonly profile: RunnerProfileDescriptor<Id>;
-    readonly signal: EngineCancellationSignal;
-    readonly target: EngineExecutionTarget;
-    readonly tasks: readonly EngineExecutionTask[];
-    readonly workspace: EngineExecutionWorkspace;
-}
-export declare function resolveEngineTaskInputs(request: Pick<EngineExecutionRequest, "target">, task: Pick<EngineExecutionTask, "inputs">): EngineExecutionInputs;
-export interface EngineTaskOutcome {
-    readonly durationMs: number;
-    readonly evidence: EngineEvidence;
-    readonly failure: EngineFailureEvidence | null;
-    readonly finishedAtMs: number;
-    readonly startedAtMs: number;
-    readonly status: TestOutcomeStatus;
-    readonly taskId: string;
-}
-export interface EngineExecutionResult {
-    readonly evidence: EngineEvidence;
-    readonly invocationId: string;
-    readonly outcomes: readonly EngineTaskOutcome[];
-}
-export type EngineExecutor<Installation> = (request: Readonly<EngineExecutionRequest>, installation: Readonly<Installation>, scope: EngineInvocationScope) => Promise<EngineExecutionResult>;
-export interface EngineExecutionBoundary<Id extends EngineId = EngineId> {
-    readonly request: Readonly<EngineExecutionRequest<Id>>;
-    acceptResult(value: EngineExecutionResult): EngineExecutionResult;
-    close(): void;
-    commit(): void;
-}
-export declare function beginEngineExecution<Id extends EngineId>(request: Readonly<EngineExecutionRequest<Id>>): EngineExecutionBoundary<Id>;

package/dist/engines/api/index.d.ts

@@ -1,5 +0,0 @@
-export * from "./capabilities.js";
-export * from "./evidence.js";
-export * from "./execution.js";
-export { EngineInvocationCleanupDeadlineExceededError, createEngineInvocationScope, type EngineInvocationCleanup, type EngineInvocationScope, type EngineInvocationScopeController, } from "./execution-scope.js";
-export { ENGINE_RUNTIME_ARTIFACT_MARKER, type EngineRuntimeArtifactPayload, encodeEngineRuntimeArtifactPayload, findEncodedEngineRuntimeArtifacts, normalizeEngineJsonValue, } from "./runtime-artifact.js";

package/dist/engines/api/k6-runtime-input.d.ts

@@ -1,26 +0,0 @@
-import type { EngineJsonObject, EngineJsonValue } from "./evidence.js";
-export declare const K6_RUNTIME_INPUT_VERSION: 1;
-export declare const K6_RUNTIME_INPUT_FILE_ENV = "TESTKIT_K6_INPUT_FILE";
-export declare const K6_RUNTIME_INPUT_SHA256_ENV = "TESTKIT_K6_INPUT_SHA256";
-export declare const K6_RUNTIME_INVOCATION_ID_ENV = "TESTKIT_INVOCATION_ID";
-export declare const K6_RUNTIME_TASK_ID_ENV = "TESTKIT_TEST_ID";
-export declare const K6_RUNTIME_INPUT_MAX_CHARACTERS: number;
-export interface K6RuntimeInputDocument {
-    readonly engineId: "k6";
-    readonly fixtures: EngineJsonObject;
-    readonly invocationId: string;
-    readonly setupData?: EngineJsonValue;
-    readonly taskId: string;
-    readonly version: typeof K6_RUNTIME_INPUT_VERSION;
-}
-export interface K6RuntimeInputReaderBoundary {
-    readonly environment: Readonly<Record<string, string | undefined>>;
-    openText(file: string): unknown;
-    sha256Hex(contents: string): string;
-}
-/**
- * Reads and validates the k6 wire document without importing either Node or k6
- * globals. The Sobek runtime supplies those capabilities at its outer edge.
- */
-export declare function readK6RuntimeInput(boundary: Readonly<K6RuntimeInputReaderBoundary>): K6RuntimeInputDocument | null;
-export declare function parseK6RuntimeInputDocument(value: unknown, label?: string): K6RuntimeInputDocument;

package/dist/engines/api/k6-runtime-input.js

@@ -1 +0,0 @@
-import{CHARACTER_JSON_STRING_MEASURE as E,requireBoundedJsonValue as _,RUNTIME_INPUT_JSON_BOUNDS as T}from"../contracts/json-bounds.js";import{isUnknownRecord as c}from"../../kernel/unknown-values.js";export const K6_RUNTIME_INPUT_VERSION=1,K6_RUNTIME_INPUT_FILE_ENV="TESTKIT_K6_INPUT_FILE",K6_RUNTIME_INPUT_SHA256_ENV="TESTKIT_K6_INPUT_SHA256",K6_RUNTIME_INVOCATION_ID_ENV="TESTKIT_INVOCATION_ID",K6_RUNTIME_TASK_ID_ENV="TESTKIT_TEST_ID",K6_RUNTIME_INPUT_MAX_CHARACTERS=8*1024*1024;const f=/^[a-f0-9]{64}$/u;export function readK6RuntimeInput(t){const n=t.environment[K6_RUNTIME_INPUT_FILE_ENV],e=t.environment[K6_RUNTIME_INPUT_SHA256_ENV];if(!n&&!e)return null;if(!w(n))throw new Error(`${K6_RUNTIME_INPUT_FILE_ENV} must be an absolute owned path`);if(!e||!f.test(e))throw new Error(`${K6_RUNTIME_INPUT_SHA256_ENV} must be a lowercase SHA-256 digest`);const r=t.openText(n);if(typeof r!="string")throw new Error(`${K6_RUNTIME_INPUT_FILE_ENV} must contain UTF-8 JSON text`);if(r.length>K6_RUNTIME_INPUT_MAX_CHARACTERS)throw new Error(`${K6_RUNTIME_INPUT_FILE_ENV} exceeds the ${String(K6_RUNTIME_INPUT_MAX_CHARACTERS)} character limit`);if(t.sha256Hex(r)!==e)throw new Error(`${K6_RUNTIME_INPUT_FILE_ENV} integrity check failed`);let i;try{i=JSON.parse(r)}catch(s){throw new Error(`${K6_RUNTIME_INPUT_FILE_ENV} contains invalid JSON: ${N(s)}`,{cause:s})}const o=parseK6RuntimeInputDocument(i,K6_RUNTIME_INPUT_FILE_ENV);if(o.invocationId!==t.environment[K6_RUNTIME_INVOCATION_ID_ENV])throw new Error(`${K6_RUNTIME_INPUT_FILE_ENV} invocation identity does not match`);if(o.taskId!==t.environment[K6_RUNTIME_TASK_ID_ENV])throw new Error(`${K6_RUNTIME_INPUT_FILE_ENV} task identity does not match`);return o}export function parseK6RuntimeInputDocument(t,n="k6 runtime input"){if(_(t,n,T,E),!c(t))throw new Error(`${n} must contain an object`);const e=new Set(["engineId","fixtures","invocationId","setupData","taskId","version"]);for(const r of Object.keys(t))if(!e.has(r))throw new Error(`${n} contains unknown field ${r}`);if(t.version!==K6_RUNTIME_INPUT_VERSION)throw new Error(`${n}.version must be 1`);if(t.engineId!=="k6")throw new Error(`${n}.engineId must be "k6"`);if(!c(t.fixtures))throw new Error(`${n}.fixtures must be an object`);return{engineId:"k6",fixtures:t.fixtures,invocationId:I(t.invocationId,`${n}.invocationId`),...Object.hasOwn(t,"setupData")?{setupData:t.setupData}:{},taskId:I(t.taskId,`${n}.taskId`),version:K6_RUNTIME_INPUT_VERSION}}function I(t,n){if(typeof t!="string"||t.length===0)throw new Error(`${n} must be a non-empty string`);return t}function w(t){return typeof t=="string"&&(t.startsWith("/")||/^[a-z]:[\\/]/iu.test(t)||t.startsWith("\\\\"))}function N(t){return t instanceof Error?t.message:String(t)}

package/dist/engines/api/runtime-artifact.d.ts

@@ -1,19 +0,0 @@
-import type { EngineJsonValue } from "./evidence.js";
-export declare const ENGINE_RUNTIME_ARTIFACT_MARKER: "TESTKIT_ARTIFACT:";
-export declare const MAX_ENGINE_RUNTIME_ARTIFACT_BYTES: number;
-export declare const MAX_ENGINE_RUNTIME_ARTIFACT_DEPTH = 64;
-export declare const MAX_ENGINE_RUNTIME_ARTIFACT_NODES = 100000;
-export declare const MAX_ENCODED_ENGINE_RUNTIME_ARTIFACT_BYTES: number;
-export interface EngineRuntimeArtifactPayload {
-    readonly contentType: string;
-    readonly data: EngineJsonValue;
-    readonly emittedAt: string;
-    readonly kind: null | string;
-    readonly name: string;
-    readonly summary: null | string;
-}
-export declare function normalizeEngineRuntimeArtifactPayload(value: unknown): EngineRuntimeArtifactPayload;
-export declare function encodeEngineRuntimeArtifactPayload(value: unknown): string;
-export declare function decodeEngineRuntimeArtifactPayload(encodedPayload: unknown): EngineRuntimeArtifactPayload;
-export declare function findEncodedEngineRuntimeArtifacts(output: string): readonly string[];
-export declare function normalizeEngineJsonValue(value: unknown, label?: string): EngineJsonValue;

package/dist/engines/bundle-cache.d.ts

@@ -1,32 +0,0 @@
-export type BundleSourcemapStatus = "detected" | "none" | "not-detected-in-sample" | "present";
-export interface BundleCacheStatus {
-    duplicatedSourceCount: number;
-    entryFileCount: number;
-    exists: boolean;
-    fileCount: number;
-    jsFileCount: number;
-    manifest: {
-        entryCount: number;
-        exists: boolean;
-    };
-    path: string;
-    serviceName: string;
-    sizeBytes: number;
-    sourcemapFileCount: null | number;
-    sourcemapStatus: BundleSourcemapStatus;
-    sourceFileCount: number;
-    unmanagedFileCount: number;
-}
-export interface BundleCleanupTarget {
-    path: string;
-    reason: "stale-bundle-version";
-    serviceName: string;
-    sourceFile: null | string;
-}
-export declare function collectBundleCacheStatus(productDir: string, serviceName?: string): BundleCacheStatus;
-export declare function collectBundleCleanupTargets(productDir: string, { allConfigs, serviceName, }?: Readonly<{
-    allConfigs?: readonly {
-        readonly name: string;
-    }[];
-    serviceName?: null | string;
-}>): BundleCleanupTarget[];

package/dist/engines/catalog.d.ts

@@ -1,27 +0,0 @@
-import type { EngineJsonObject, RunnerProfileDescriptor } from "./api/index.js";
-import { BUILT_IN_RUNNER_PROFILES } from "./definitions.js";
-import type { EngineId, PublicTestType, RunnerProfileId } from "../domain/identifiers.js";
-export { isEngineProfileIdentity, type EngineProfileIdentity } from "./definitions.js";
-export interface EngineCatalog {
-    readonly profiles: readonly RunnerProfileDescriptor[];
-    profilesForTestType(testType: PublicTestType): readonly RunnerProfileDescriptor[];
-    resolve<Id extends EngineId>(testType: PublicTestType, engineId: Id): RunnerProfileDescriptor<Id>;
-}
-export declare const BUILT_IN_ENGINE_CATALOG: EngineCatalog;
-export { BUILT_IN_RUNNER_PROFILES };
-export declare function resolveEngineProfile<Id extends EngineId>(testType: PublicTestType, engineId: Id): RunnerProfileDescriptor<Id>;
-type EngineAuthoringModule = "@gfdelarue/testkit/k6" | "@gfdelarue/testkit/node-vitest/data" | "@gfdelarue/testkit/node-vitest/contract" | "@gfdelarue/testkit/playwright";
-export interface EngineAuthoringProfile {
-    readonly engineId: EngineId;
-    readonly profileId: RunnerProfileId;
-}
-export interface ManagedPublicPackageOwner {
-    engineId: "node-vitest" | "playwright";
-    name: string;
-}
-export type EngineConfigurations = Readonly<Partial<Record<EngineId, EngineJsonObject>>>;
-export declare function buildEngineConfigurations(config: object, engineIds: ReadonlySet<EngineId>): Promise<EngineConfigurations | undefined>;
-export declare function expectedEngineAuthoringModule(profileId: RunnerProfileId): EngineAuthoringModule;
-export declare function invalidEngineAuthoringImport(filePath: string, metadata: Readonly<EngineAuthoringProfile>, specifier: string, expectedModule?: EngineAuthoringModule): Error;
-export declare function requireMatchingHostImport(filePath: string, metadata: Readonly<EngineAuthoringProfile>, specifier: string): void;
-export declare function managedPublicPackageOwner(specifier: string): ManagedPublicPackageOwner | null;

package/dist/engines/contracts/fixture-manifest.d.ts

@@ -1,34 +0,0 @@
-/**
- * The fixture manifest that crosses every engine's runtime-input seam.
- * The Node orchestrator builds one manifest per task
- * (`buildRuntimeFixtureManifest`) and each guest — k6, node-vitest data,
- * node-vitest contract — validates it with the same parser, so a manifest
- * the host wrote can never be rejected by one guest and accepted by
- * another.
- */
-export interface RuntimeFixtureManifestEntry {
-    absolutePath: string;
-    aliases: string[];
-    contentType: string;
-    filename: string;
-    path: string;
-    root: string;
-    rootRelativePath: string;
-    sha256: string;
-    sizeBytes: number;
-}
-export interface RuntimeFixtureManifest {
-    entries: RuntimeFixtureManifestEntry[];
-    testFile: string;
-    version: 1;
-}
-export declare function resolveRuntimeFixtureEntry<T extends {
-    readonly aliases: readonly string[];
-    readonly path: string;
-}>(entries: readonly T[], key: string): T;
-/**
- * Validates a manifest that arrived over a runtime-input seam and returns
- * its entries. An empty object means "no fixtures were materialized" and
- * yields no entries.
- */
-export declare function parseRuntimeFixtureManifestEntries(value: unknown, label: string): RuntimeFixtureManifestEntry[];

package/dist/engines/contracts/json-bounds.d.ts

@@ -1,36 +0,0 @@
-/**
- * Structural bounds for JSON documents that cross a runtime-input seam.
- * Every producer and consumer of a runtime-input document — the Node
- * orchestrator writing it, and the k6 / node-vitest / playwright side
- * reading it — enforces the same profile, so a document accepted on one
- * side can never be rejected on the other.
- */
-export interface JsonBoundsProfile {
-    readonly maxCollectionEntries: number;
-    readonly maxDepth: number;
-    readonly maxNodes: number;
-    readonly maxStringUnits: number;
-}
-/**
- * How a realm measures string size. Hosts measure UTF-8 bytes; the k6
- * guest has no byte-length primitive and measures UTF-16 characters.
- * Characters never exceed bytes, so the guest bound is the looser one
- * and a host-accepted document always passes guest validation.
- */
-export interface JsonStringMeasure {
-    readonly unitLabel: string;
-    readonly unitsOf: (text: string) => number;
-}
-export declare const RUNTIME_INPUT_JSON_BOUNDS: JsonBoundsProfile;
-export declare const CHARACTER_JSON_STRING_MEASURE: JsonStringMeasure;
-/**
- * Rejects values that exceed the profile or are not plain JSON.
- *
- * Self-contained by design: the body references only its parameters and
- * ECMAScript built-ins, so `Function.prototype.toString()` can embed it
- * verbatim into generated bootstrap source (see
- * `playwrightRuntimeInputBootstrapSource`). Do not add references to
- * module-scope bindings.
- */
-export declare function requireBoundedJsonValue(value: unknown, label: string, profile: JsonBoundsProfile, measure: JsonStringMeasure): void;
-export declare function serializeBoundedJson(value: unknown, label: string, profile: JsonBoundsProfile, measure: JsonStringMeasure): string;

package/dist/engines/contracts/json-bounds.js

@@ -1,2 +0,0 @@
-export const RUNTIME_INPUT_JSON_BOUNDS=Object.freeze({maxCollectionEntries:1e4,maxDepth:32,maxNodes:5e4,maxStringUnits:4194304}),CHARACTER_JSON_STRING_MEASURE=Object.freeze({unitLabel:"characters",unitsOf:r=>r.length});export function requireBoundedJsonValue(r,e,t,o){let i=0;const s=(n,a)=>{if(i+=1,i>t.maxNodes)throw new Error(`${e} exceeds the ${t.maxNodes.toString()} node limit`);if(a>t.maxDepth)throw new Error(`${e} exceeds the ${t.maxDepth.toString()} level depth limit`);if(typeof n=="string"){if(o.unitsOf(n)>t.maxStringUnits)throw new Error(`${e} contains a string larger than ${t.maxStringUnits.toString()} ${o.unitLabel}`);return}if(typeof n=="number"){if(!Number.isFinite(n))throw new Error(`${e} contains a non-finite number`);return}if(n===null||typeof n=="boolean")return;if(typeof n!="object")throw new Error(`${e} contains a non-JSON value`);const c=Array.isArray(n)?n:Object.values(n);if(c.length>t.maxCollectionEntries)throw new Error(`${e} contains a collection larger than ${t.maxCollectionEntries.toString()} entries`);for(const u of c)s(u,a+1)};s(r,0)}export function serializeBoundedJson(r,e,t,o){requireBoundedJsonValue(r,e,t,o);const i=JSON.stringify(r);if(typeof i!="string")throw new Error(`${e} is not JSON-serializable`);return`${i}
-`}

package/dist/engines/contracts/k6-repository-configuration.d.ts

@@ -1,12 +0,0 @@
-import { type EngineJsonObject } from "../api/index.js";
-export declare const K6_REPOSITORY_CONFIGURATION_VERSION: 1;
-export interface K6RepositoryConfiguration {
-    readonly httpProfiles: Readonly<Record<string, K6RepositoryHttpProfile>>;
-    readonly kind: "testkit-k6-repository-configuration";
-    readonly version: typeof K6_REPOSITORY_CONFIGURATION_VERSION;
-}
-export type K6RepositoryHttpProfile = Readonly<{
-    kind: "json";
-    value: EngineJsonObject;
-}>;
-export declare function parseK6RepositoryConfiguration(value: unknown): K6RepositoryConfiguration | null;

package/dist/engines/contracts/k6-repository-configuration.js

@@ -1 +0,0 @@
-import{normalizeEngineJsonValue as u}from"../api/index.js";export const K6_REPOSITORY_CONFIGURATION_VERSION=1;export function parseK6RepositoryConfiguration(t){if(t===void 0)return null;const r=s(t,"k6 repository configuration");if(f(r,["httpProfiles","kind","version"],"k6 repository configuration"),r.kind!=="testkit-k6-repository-configuration")throw new Error('k6 repository configuration.kind must be "testkit-k6-repository-configuration"');if(r.version!==K6_REPOSITORY_CONFIGURATION_VERSION)throw new Error("k6 repository configuration.version must be 1");const o=s(r.httpProfiles,"k6 repository configuration.httpProfiles"),n=[];for(const[i,c]of Object.entries(o)){if(i.trim().length===0)throw new Error("k6 repository configuration.httpProfiles keys must be non-empty");n.push([i,p(c,`k6 repository configuration.httpProfiles.${i}`)])}const e=Object.fromEntries(n);return Object.freeze({httpProfiles:Object.freeze(e),kind:"testkit-k6-repository-configuration",version:K6_REPOSITORY_CONFIGURATION_VERSION})}function p(t,r){const o=s(t,r);if(o.kind==="json")return f(o,["kind","value"],r),Object.freeze({kind:"json",value:k(o.value,`${r}.value`)});throw new Error(`${r}.kind must be "json"`)}function k(t,r){const o=u(t,r);if(o===null||typeof o!="object"||Array.isArray(o))throw new Error(`${r} must be an object`);return o}function s(t,r){if(typeof t!="object"||t===null||Array.isArray(t))throw new Error(`${r} must be an object`);const o=Object.getPrototypeOf(t);if(o!==Object.prototype&&o!==null)throw new Error(`${r} must be a plain object`);return t}function f(t,r,o){const n=new Set(r);for(const e of Object.keys(t))if(!n.has(e))throw new Error(`${o} contains unknown field ${e}`);for(const e of r)if(!Object.hasOwn(t,e))throw new Error(`${o} is missing required field ${e}`)}

package/dist/engines/contracts/test-context.d.ts

@@ -1,15 +0,0 @@
-export interface TestNamespaceInput {
-    readonly leaseId?: unknown;
-    readonly runtimeId?: unknown;
-}
-export interface TestkitContext<Environment extends object = object> {
-    active: boolean;
-    leaseId: string | null;
-    namespace: string;
-    rawEnv: Environment;
-    runtimeId: string | null;
-}
-export declare function buildTestNamespace({ leaseId, runtimeId }?: TestNamespaceInput): string;
-export declare function readTestkitContext(env?: undefined): TestkitContext<Record<string, never>>;
-export declare function readTestkitContext<Environment extends object>(env: Environment): TestkitContext<Environment>;
-export declare function readTestkitContext<Environment extends object>(env: Environment | undefined): TestkitContext<Environment | Record<string, never>>;

package/dist/engines/contracts/test-context.js

@@ -1 +0,0 @@
-const r=String;function i(e){return r(e||"").trim().toLowerCase().replace(/[^a-z0-9]+/g,"-").replace(/^-+|-+$/g,"")}function t(e){return i(e)||null}function a(e,n){return Reflect.get(e,n)}export function buildTestNamespace({leaseId:e,runtimeId:n}={}){return t(e)||t(n)||"standalone"}export function readTestkitContext(e={}){const n=t(a(e,"TESTKIT_RUNTIME_ID")),o=t(a(e,"TESTKIT_LEASE_ID"));return{active:a(e,"TESTKIT_ACTIVE")==="1",runtimeId:n,leaseId:o,namespace:buildTestNamespace({leaseId:o,runtimeId:n}),rawEnv:e}}

package/dist/engines/definitions.d.ts

@@ -1,23 +0,0 @@
-import type { RunnerProfileDescriptor } from "./api/index.js";
-import type { EngineId, PublicTestType, RunnerProfileId } from "../domain/identifiers.js";
-import type { InternalEngineRegistrationById } from "./installation-catalog.js";
-export type EndpointReadinessOwner = "adapter" | "orchestrator-http";
-export interface BuiltInRunnerProfile<Id extends EngineId = EngineId> extends RunnerProfileDescriptor<Id> {
-    readonly endpointReadinessOwner: EndpointReadinessOwner;
-}
-type BuiltInDefinitions = {
-    readonly [Id in EngineId]: InternalEngineRegistrationById[Id] & {
-        readonly profiles: readonly BuiltInRunnerProfile<Id>[];
-    };
-};
-export declare const BUILT_IN_ENGINE_DEFINITIONS: BuiltInDefinitions;
-export declare const BUILT_IN_RUNNER_PROFILES: readonly BuiltInRunnerProfile[];
-export declare function resolveEndpointReadinessOwner(profile: Readonly<RunnerProfileDescriptor>): EndpointReadinessOwner;
-export interface EngineProfileIdentity {
-    readonly engineId: EngineId;
-    readonly profileId: RunnerProfileId;
-    readonly testType: PublicTestType;
-}
-/** Validate persisted identities without loading engine configuration builders. */
-export declare function isEngineProfileIdentity(value: unknown): value is EngineProfileIdentity;
-export {};

package/dist/engines/factory.d.ts

@@ -1,6 +0,0 @@
-import { type InternalEngineInstallationCatalog } from "./installation-catalog.js";
-import { EngineManager } from "./manager.js";
-export interface EngineManagerFactoryOptions {
-    readonly catalog?: InternalEngineInstallationCatalog;
-}
-export declare function createEngineManager(productDirectory: string, options?: Readonly<EngineManagerFactoryOptions>): EngineManager;

package/dist/engines/generated-performance.d.ts

@@ -1 +0,0 @@
-export declare function ownedGeneratedScript(source: string, label: string): string;

package/dist/engines/installation-catalog.d.ts

@@ -1,27 +0,0 @@
-import { type EngineExecutionRequest, type EngineExecutionResult, type EngineInvocationScope } from "./api/index.js";
-import { type EngineId } from "../domain/identifiers.js";
-import type { K6Installation } from "./installations/k6.js";
-import type { NodeVitestInstallation } from "./installations/node-vitest.js";
-import type { PlaywrightInstallation } from "./installations/playwright.js";
-import type { EngineResolutionContext } from "./installations/types.js";
-export interface EngineInstallationById {
-    readonly k6: K6Installation;
-    readonly "node-vitest": NodeVitestInstallation;
-    readonly playwright: PlaywrightInstallation;
-}
-export type EngineInstallationFor<Id extends EngineId> = EngineInstallationById[Id];
-export type EngineExecutorFor<Id extends EngineId> = (request: Readonly<EngineExecutionRequest<Id>>, installation: Readonly<EngineInstallationFor<Id>>, scope: EngineInvocationScope) => Promise<EngineExecutionResult>;
-export interface InternalEngineRegistration<Id extends EngineId> {
-    readonly id: Id;
-    loadExecutor(): Promise<EngineExecutorFor<Id>>;
-    resolveInstallation(context: Readonly<EngineResolutionContext>): Promise<EngineInstallationFor<Id>>;
-}
-export type InternalEngineRegistrationById = {
-    readonly [Id in EngineId]: InternalEngineRegistration<Id>;
-};
-export interface InternalEngineInstallationCatalog {
-    readonly registrations: InternalEngineRegistrationById;
-    resolve<Id extends EngineId>(engineId: Id): InternalEngineRegistration<Id>;
-}
-export declare const BUILT_IN_ENGINE_INSTALLATION_CATALOG: InternalEngineInstallationCatalog;
-export declare function createInternalEngineInstallationCatalog(registrations: Readonly<InternalEngineRegistrationById>): InternalEngineInstallationCatalog;

package/dist/engines/installation-catalog.js

@@ -1 +0,0 @@
-import"./api/index.js";import"../domain/identifiers.js";import{BUILT_IN_ENGINE_DEFINITIONS as o}from"./definitions.js";export const BUILT_IN_ENGINE_INSTALLATION_CATALOG=createInternalEngineInstallationCatalog(o);export function createInternalEngineInstallationCatalog(e){const t=Object.freeze({k6:Object.freeze(e.k6),"node-vitest":Object.freeze(e["node-vitest"]),playwright:Object.freeze(e.playwright)});return Object.freeze({registrations:t,resolve(r){return t[r]}})}

package/dist/engines/installations/k6.d.ts

@@ -1,98 +0,0 @@
-import { type PlatformTarget } from "../../process/host/platform.js";
-import { runManagedHostProcess } from "../../process/index.js";
-import { RootPackageResolver, type ResolvedPackage } from "./package-resolution.js";
-import type { EngineResolutionContext } from "./types.js";
-export declare const EXPECTED_K6_VERSION = "1.7.1";
-export declare const K6_VERSION_PROBE_TIMEOUT_MS = 30000;
-export declare const K6_TARGET_PACKAGE_REQUIREMENTS: readonly [Readonly<{
-    executablePath: "bin/k6";
-    packageName: "@gfdelarue/testkit-engine-k6-darwin-arm64";
-    publicEntrypoint: "@gfdelarue/testkit-engine-k6-darwin-arm64/binary";
-    target: Readonly<{
-        arch: "arm64";
-        platform: "darwin";
-    }>;
-}>, Readonly<{
-    executablePath: "bin/k6";
-    packageName: "@gfdelarue/testkit-engine-k6-darwin-x64";
-    publicEntrypoint: "@gfdelarue/testkit-engine-k6-darwin-x64/binary";
-    target: Readonly<{
-        arch: "x64";
-        platform: "darwin";
-    }>;
-}>, Readonly<{
-    executablePath: "bin/k6";
-    packageName: "@gfdelarue/testkit-engine-k6-linux-arm64";
-    publicEntrypoint: "@gfdelarue/testkit-engine-k6-linux-arm64/binary";
-    target: Readonly<{
-        arch: "arm64";
-        platform: "linux";
-    }>;
-}>, Readonly<{
-    executablePath: "bin/k6";
-    packageName: "@gfdelarue/testkit-engine-k6-linux-x64";
-    publicEntrypoint: "@gfdelarue/testkit-engine-k6-linux-x64/binary";
-    target: Readonly<{
-        arch: "x64";
-        platform: "linux";
-    }>;
-}>, Readonly<{
-    executablePath: "bin/k6.exe";
-    packageName: "@gfdelarue/testkit-engine-k6-win32-x64";
-    publicEntrypoint: "@gfdelarue/testkit-engine-k6-win32-x64/binary";
-    target: Readonly<{
-        arch: "x64";
-        platform: "win32";
-    }>;
-}>];
-export type K6TargetPackageName = (typeof K6_TARGET_PACKAGE_REQUIREMENTS)[number]["packageName"];
-export interface K6TargetPackageInstallation {
-    readonly name: K6TargetPackageName;
-    readonly root: string;
-    readonly target: PlatformTarget;
-    readonly version: string;
-}
-export interface K6Installation {
-    readonly authoringEntrypoints: {
-        readonly authoring: string;
-        readonly config: string;
-        readonly root: string;
-        readonly rootPackageJson: string;
-    };
-    readonly engineId: "k6";
-    readonly engineVersion: string;
-    readonly executable: string;
-    readonly target: PlatformTarget;
-    readonly targetPackage: K6TargetPackageInstallation;
-}
-type K6VersionProbeResult = Awaited<ReturnType<typeof runManagedHostProcess>>;
-export declare class K6OptionalPackageMissingError extends Error {
-    readonly code = "TESTKIT_K6_OPTIONAL_PACKAGE_MISSING";
-    readonly packageName: K6TargetPackageName;
-    readonly target: PlatformTarget;
-    readonly version: string;
-    constructor(requirement: Readonly<K6TargetPackageRequirement>, version: string, options: ErrorOptions);
-}
-export declare class K6EngineVersionMismatchError extends Error {
-    readonly code = "TESTKIT_K6_ENGINE_VERSION_MISMATCH";
-    readonly expectedVersion: string;
-    readonly observedVersion: string;
-    readonly packageName: K6TargetPackageName;
-    readonly packageVersion: string;
-    constructor(selected: Readonly<ResolvedPackage>, requirement: Readonly<K6TargetPackageRequirement>, observedVersion: string);
-}
-export declare class K6VersionProbeError extends Error {
-    readonly code = "TESTKIT_K6_VERSION_PROBE_FAILED";
-    constructor(message: string, options?: ErrorOptions);
-}
-interface K6TargetPackageRequirement {
-    readonly executablePath: "bin/k6" | "bin/k6.exe";
-    readonly packageName: K6TargetPackageNameLiteral;
-    readonly publicEntrypoint: `${K6TargetPackageNameLiteral}/binary`;
-    readonly target: PlatformTarget;
-}
-type K6TargetPackageNameLiteral = "@gfdelarue/testkit-engine-k6-darwin-arm64" | "@gfdelarue/testkit-engine-k6-darwin-x64" | "@gfdelarue/testkit-engine-k6-linux-arm64" | "@gfdelarue/testkit-engine-k6-linux-x64" | "@gfdelarue/testkit-engine-k6-win32-x64";
-export declare function resolveK6Installation(context: Readonly<EngineResolutionContext>): Promise<K6Installation>;
-export declare function requireK6TargetPackageRequirement(target?: Readonly<PlatformTarget>): (typeof K6_TARGET_PACKAGE_REQUIREMENTS)[number];
-export declare function requireK6VersionProbeResult(selected: Readonly<ResolvedPackage>, target: Readonly<PlatformTarget>, signal: AbortSignal, result: Readonly<K6VersionProbeResult>, resolver: RootPackageResolver): string;
-export {};

package/dist/engines/installations/k6.js

@@ -1 +0,0 @@
-import p from"node:fs";import l from"node:path";import{currentPlatformTarget as h,platformTargetKey as b,UnsupportedPlatformTargetError as x}from"../../process/host/platform.js";import{isPathWithin as k}from"../../process/files/paths.js";import{managedHostProcessInfrastructureError as E,runManagedHostProcess as w}from"../../process/index.js";import{MissingDirectPackageError as y,RootPackageResolver as P}from"./package-resolution.js";export const EXPECTED_K6_VERSION="1.7.1",K6_VERSION_PROBE_TIMEOUT_MS=3e4,K6_TARGET_PACKAGE_REQUIREMENTS=Object.freeze([Object.freeze({executablePath:"bin/k6",packageName:"@gfdelarue/testkit-engine-k6-darwin-arm64",publicEntrypoint:"@gfdelarue/testkit-engine-k6-darwin-arm64/binary",target:Object.freeze({arch:"arm64",platform:"darwin"})}),Object.freeze({executablePath:"bin/k6",packageName:"@gfdelarue/testkit-engine-k6-darwin-x64",publicEntrypoint:"@gfdelarue/testkit-engine-k6-darwin-x64/binary",target:Object.freeze({arch:"x64",platform:"darwin"})}),Object.freeze({executablePath:"bin/k6",packageName:"@gfdelarue/testkit-engine-k6-linux-arm64",publicEntrypoint:"@gfdelarue/testkit-engine-k6-linux-arm64/binary",target:Object.freeze({arch:"arm64",platform:"linux"})}),Object.freeze({executablePath:"bin/k6",packageName:"@gfdelarue/testkit-engine-k6-linux-x64",publicEntrypoint:"@gfdelarue/testkit-engine-k6-linux-x64/binary",target:Object.freeze({arch:"x64",platform:"linux"})}),Object.freeze({executablePath:"bin/k6.exe",packageName:"@gfdelarue/testkit-engine-k6-win32-x64",publicEntrypoint:"@gfdelarue/testkit-engine-k6-win32-x64/binary",target:Object.freeze({arch:"x64",platform:"win32"})})]);export class K6OptionalPackageMissingError extends Error{code="TESTKIT_K6_OPTIONAL_PACKAGE_MISSING";packageName;target;version;constructor(t,a,r){const n=Object.freeze({...t.target});super(`Testkit k6 on ${n.platform}/${n.arch} requires optional package ${t.packageName}@${a}, but it is not installed. Run a clean npm install from the consumer lockfile without omitting optional dependencies. Testkit does not use PATH or a system k6 fallback.`,r),this.name="K6OptionalPackageMissingError",this.packageName=t.packageName,this.target=n,this.version=a}}export class K6EngineVersionMismatchError extends Error{code="TESTKIT_K6_ENGINE_VERSION_MISMATCH";expectedVersion;observedVersion;packageName;packageVersion;constructor(t,a,r){super(`Testkit requires k6 v${EXPECTED_K6_VERSION}, but ${a.packageName}@${t.version} reported k6 v${r} from its version probe. Install the ${a.packageName} version that ships k6 v${EXPECTED_K6_VERSION}.`),this.name="K6EngineVersionMismatchError",this.expectedVersion=EXPECTED_K6_VERSION,this.observedVersion=r,this.packageName=a.packageName,this.packageVersion=t.version}}export class K6VersionProbeError extends Error{code="TESTKIT_K6_VERSION_PROBE_FAILED";constructor(t,a){super(t,a),this.name="K6VersionProbeError"}}const v=/^k6(?:\.exe)? v((?:0|[1-9][0-9]*)\.(?:0|[1-9][0-9]*)\.(?:0|[1-9][0-9]*)(?:-[0-9A-Za-z.-]+)?)\s+\([^\r\n)]*\b(darwin|linux|windows)\/(amd64|arm64)\)(?:\s|$)/u;export async function resolveK6Installation(e){e.signal.throwIfAborted();const t=new P,a=requireK6TargetPackageRequirement();let r;try{r=t.resolveRequireFromRoot({dependencyGroup:"optionalDependencies",packageName:a.packageName,publicEntrypoint:a.publicEntrypoint})}catch(s){throw s instanceof y?new K6OptionalPackageMissingError(a,s.version,{cause:s}):s}const n=O(r,a,t),i=T(t),o=await $(r,n,a.target,e,t),c=Object.freeze({...a.target});return Object.freeze({authoringEntrypoints:i,engineId:"k6",engineVersion:o,executable:n,target:c,targetPackage:Object.freeze({name:a.packageName,root:r.root,target:c,version:r.version})})}function T(e){return Object.freeze({authoring:e.resolveRootPublicEntrypoint("@gfdelarue/testkit/k6"),config:e.resolveRootPublicEntrypoint("@gfdelarue/testkit/config"),root:e.resolveRootPublicEntrypoint("@gfdelarue/testkit"),rootPackageJson:e.packageJsonPath})}export function requireK6TargetPackageRequirement(e=h()){const t=b(e),a=K6_TARGET_PACKAGE_REQUIREMENTS.find(r=>b(r.target)===t);if(a===void 0)throw new x(e.platform,e.arch,"managed k6");return a}function O(e,t,a){try{const r=_(e.manifestPath);if(r.name!==t.packageName||r.version!==e.version)throw new TypeError(`manifest must remain exactly ${t.packageName}@${e.version}`);d(r.os,t.target.platform,"os"),d(r.cpu,t.target.arch,"cpu");const n=l.resolve(e.root,t.executablePath);if(!k(e.root,n))throw new TypeError(`expected executable ${t.executablePath} escapes its package root`);const i=p.lstatSync(n);if(!i.isFile()||i.isSymbolicLink())throw new TypeError(`expected executable ${t.executablePath} must be a regular non-symlink file`);const o=p.realpathSync(n);if(!k(e.root,o))throw new TypeError(`expected executable ${t.executablePath} resolves outside its package root`);if(o!==e.entrypoint)throw new TypeError(`public binary export must resolve exactly to ${t.executablePath}`);if(l.basename(o)!==l.basename(t.executablePath))throw new TypeError(`public binary export must use filename ${l.basename(t.executablePath)}`);if(t.target.platform!=="win32"&&(i.mode&73)===0)throw new TypeError(`expected executable ${t.executablePath} must have a POSIX executable permission bit`);return t.target.platform!=="win32"&&p.accessSync(o,p.constants.X_OK),o}catch(r){throw a.brokenInstallation(e,`its ${t.target.platform}/${t.target.arch} k6 binary contract is invalid: ${R(r)}`,r)}}async function $(e,t,a,r,n){let i;try{i=await w({args:["version"],cwd:r.productRoot,displayLabel:"Testkit k6 version probe",env:process.env,executable:t,signal:r.signal,timeoutMs:K6_VERSION_PROBE_TIMEOUT_MS})}catch(o){throw m(r.signal,o),n.brokenInstallation(e,"its mandatory k6 version probe could not run",o)}return requireK6VersionProbeResult(e,a,r.signal,i,n)}export function requireK6VersionProbeResult(e,t,a,r,n){const i=E("Testkit k6 version probe",r);m(a,S(r)?i:null);const o=K(r)??i??I(r);if(o!==null)throw n.brokenInstallation(e,"its mandatory k6 version probe failed",o);const c=r.stdout.trim().split(/\r?\n/u,1)[0]??"",s=v.exec(c);if(s===null)throw n.brokenInstallation(e,"its mandatory k6 version probe returned an invalid version",new K6VersionProbeError(`Expected bounded output beginning with "k6 v<version>"; received ${JSON.stringify(c)}`));const u=`${s[2]}/${s[3]}`,f=N(t);if(u!==f)throw n.brokenInstallation(e,`its mandatory k6 version probe reported incompatible target ${u}; expected ${f}`,new K6VersionProbeError(`k6 version target ${u} does not match ${f}`));const g=s[1];if(g!==EXPECTED_K6_VERSION)throw new K6EngineVersionMismatchError(e,requireK6TargetPackageRequirement(t),g);return g}function N(e){const t=e.platform==="win32"?"windows":e.platform,a=e.arch==="x64"?"amd64":e.arch;return`${t}/${a}`}function I(e){return e.exitCode!==0?new K6VersionProbeError(e.exitCode===null?`k6 version terminated by ${e.exitSignal??"an unknown signal"}`:`k6 version exited with code ${e.exitCode.toString()}`):null}function S(e){return e.terminationError!==null||e.error!==null||e.timedOut||e.outputLimitExceeded}function K(e){return e.error!==null&&e.terminationError===null&&!e.timedOut&&!e.cancelled&&!e.outputLimitExceeded?e.error:null}function m(e,t){if(e.aborted)throw t==null&&e.throwIfAborted(),t===e.reason?t:new AggregateError([e.reason,t],"k6 version probe was cancelled and process cleanup also failed",{cause:e.reason})}function d(e,t,a){if(!Array.isArray(e)||e.length!==1||e[0]!==t)throw new TypeError(`manifest ${a} must be exactly [${JSON.stringify(t)}]; received ${JSON.stringify(e)}`)}function _(e){const t=JSON.parse(p.readFileSync(e,"utf8"));if(typeof t!="object"||t===null||Array.isArray(t))throw new TypeError("package manifest must contain a JSON object");return t}function R(e){return e instanceof Error?e.message:String(e)}

package/dist/engines/installations/node-vitest.d.ts

@@ -1,33 +0,0 @@
-export { NODE_VITEST_PACKAGE_REQUIREMENTS, NODE_VITEST_PRIVATE_PACKAGE_PREFIXES } from "./package-requirements.js";
-import { RootPackageResolver, type ResolvedPackageEntrypoint } from "./package-resolution.js";
-import type { DirectPackageInstallation, EngineResolutionContext } from "./types.js";
-interface VitestPackageInstallation extends DirectPackageInstallation<"vitest"> {
-    readonly cli: string;
-}
-export interface NodeVitestAuthoringEntrypoints {
-    readonly config: string;
-    readonly contract: string;
-    readonly data: string;
-    readonly root: string;
-    readonly rootPackageJson: string;
-}
-export interface NodeVitestInstallation {
-    readonly authoringEntrypoints: NodeVitestAuthoringEntrypoints;
-    readonly engineId: "node-vitest";
-    readonly packages: {
-        readonly esbuild: DirectPackageInstallation<"esbuild">;
-        readonly typescript: DirectPackageInstallation<"typescript">;
-        readonly vite: DirectPackageInstallation<"vite">;
-        readonly vitest: VitestPackageInstallation;
-    };
-}
-interface NodeVitestResolutionDependencies {
-    readonly packageResolver: RootPackageResolver;
-}
-export declare function resolveNodeVitestInstallation(context: Readonly<EngineResolutionContext>, dependencies?: Readonly<NodeVitestResolutionDependencies>): NodeVitestInstallation;
-export declare function preflightNodeVitestInstallation(installation: Readonly<NodeVitestInstallation>, context: Readonly<{
-    signal: {
-        readonly aborted: boolean;
-        readonly reason?: unknown;
-    };
-}>, importEntrypoint?: (selectedPackage: Readonly<ResolvedPackageEntrypoint>) => Promise<unknown>): Promise<void>;

package/dist/engines/installations/package-requirements.d.ts

@@ -1,28 +0,0 @@
-export declare const NODE_VITEST_PACKAGE_REQUIREMENTS: readonly [Readonly<{
-    authoringResolution: "package-exports";
-    packageName: "vitest";
-    publicEntrypoints: readonly ["vitest"];
-}>, Readonly<{
-    authoringResolution: "package-exports";
-    packageName: "vite";
-    publicEntrypoints: readonly ["vite"];
-}>, Readonly<{
-    authoringResolution: "exact-entrypoint";
-    packageName: "typescript";
-    publicEntrypoints: readonly ["typescript"];
-}>, Readonly<{
-    authoringResolution: "exact-entrypoint";
-    packageName: "esbuild";
-    publicEntrypoints: readonly ["esbuild"];
-}>];
-export declare const NODE_VITEST_PRIVATE_PACKAGE_PREFIXES: readonly ["@vitest/"];
-export declare const PLAYWRIGHT_PACKAGE_FAMILY_REQUIREMENTS: readonly [Readonly<{
-    packageName: "@playwright/test";
-    publicEntrypoints: readonly ["@playwright/test", "@playwright/test/cli"];
-}>, Readonly<{
-    packageName: "playwright";
-    publicEntrypoints: readonly ["playwright"];
-}>, Readonly<{
-    packageName: "playwright-core";
-    publicEntrypoints: readonly ["playwright-core"];
-}>];