@gfdelarue/testkit 0.4.4 → 0.5.0

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,22 +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 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"];
-}>];

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

@@ -1,51 +0,0 @@
-export declare const TESTKIT_PACKAGE_NAME = "@gfdelarue/testkit";
-export type RootDependencyGroup = "dependencies" | "optionalDependencies";
-export interface PackageResolutionRequest {
-    readonly dependencyGroup: RootDependencyGroup;
-    readonly packageName: string;
-    readonly publicEntrypoint: string;
-}
-export interface ResolvedPackage {
-    readonly entrypoint: string;
-    readonly manifestPath: string;
-    readonly name: string;
-    readonly root: string;
-    readonly version: string;
-}
-export type ResolvedPackageEntrypoint = Pick<ResolvedPackage, "entrypoint" | "name" | "version">;
-export interface RootPackageResolverOptions {
-    readonly packageJsonPath?: string;
-    readonly resolveImportFromRoot?: (specifier: string) => string;
-}
-export declare class RootPackageDeclarationError extends Error {
-    readonly code = "TESTKIT_ROOT_PACKAGE_DECLARATION_INVALID";
-    constructor(message: string, options?: ErrorOptions);
-}
-export declare class MissingDirectPackageError extends Error {
-    readonly code = "TESTKIT_DIRECT_PACKAGE_MISSING";
-    readonly packageName: string;
-    readonly version: string;
-    constructor(packageName: string, version: string, publicEntrypoint: string, optionalDependency: boolean, options: ErrorOptions);
-}
-export declare class BrokenPackageInstallationError extends Error {
-    readonly code = "TESTKIT_PACKAGE_INSTALLATION_BROKEN";
-    readonly packageName: string;
-    readonly version: string;
-    constructor(packageName: string, version: string, problem: string, options?: ErrorOptions);
-}
-export declare class RootPackageResolver {
-    readonly packageJsonPath: string;
-    readonly packageRoot: string;
-    private readonly manifest;
-    private readonly requireFromRoot;
-    private readonly resolveRootImport;
-    constructor(options?: Readonly<RootPackageResolverOptions>);
-    resolveImportFromRoot(request: Readonly<PackageResolutionRequest>): ResolvedPackage;
-    resolveRequireFromRoot(request: Readonly<PackageResolutionRequest>): ResolvedPackage;
-    resolveRequireFromPackage(parent: Readonly<ResolvedPackage>, request: Readonly<PackageResolutionRequest>): ResolvedPackage;
-    resolveRequirePublicEntrypoint(selectedPackage: Readonly<ResolvedPackage>, publicEntrypoint: string): string;
-    resolveRootPublicEntrypoint(publicEntrypoint: string): string;
-    brokenInstallation(selectedPackage: Readonly<ResolvedPackage>, problem: string, cause: unknown): BrokenPackageInstallationError;
-    private declaredVersion;
-}
-export declare function importResolvedPackageEntrypoint(selectedPackage: Readonly<ResolvedPackageEntrypoint>): Promise<unknown>;

package/dist/engines/installations/playwright-resolution-child.d.ts

@@ -1 +0,0 @@
-export {};

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

@@ -1,75 +0,0 @@
-export { PLAYWRIGHT_PACKAGE_FAMILY_REQUIREMENTS } from "./package-requirements.js";
-import { type ManagedProcessResult } from "../../process/index.js";
-import { type LinuxLibc, type PlatformTarget } from "../../process/host/platform.js";
-import { RootPackageResolver } from "./package-resolution.js";
-import type { DirectPackageInstallation, EngineResolutionContext } from "./types.js";
-export interface PlaywrightPackageFamily {
-    readonly cli: string;
-    readonly playwright: DirectPackageInstallation<"playwright">;
-    readonly playwrightCore: DirectPackageInstallation<"playwright-core">;
-    readonly playwrightTest: DirectPackageInstallation<"@playwright/test">;
-}
-export type PlaywrightRegistryMode = "configured-absolute" | "configured-relative" | "default" | "hermetic";
-export interface PlaywrightRegistrySelection {
-    readonly canonicalValue: string;
-    readonly mode: PlaywrightRegistryMode;
-}
-export interface PlaywrightInstallation {
-    readonly authoringEntrypoints: {
-        readonly authoring: string;
-        readonly root: string;
-        readonly rootPackageJson: string;
-    };
-    readonly browserExecutable: string;
-    readonly engineId: "playwright";
-    readonly family: PlaywrightPackageFamily;
-    readonly registry: PlaywrightRegistrySelection;
-}
-export interface PlaywrightResolutionOptions {
-    readonly ambientEnvironment?: Readonly<NodeJS.ProcessEnv>;
-    readonly configuredRegistry?: string;
-}
-export interface PlaywrightHost {
-    readonly linuxLibc: LinuxLibc | null;
-    readonly target: PlatformTarget;
-}
-interface PlaywrightChildRequest {
-    readonly family: PlaywrightPackageFamily;
-    readonly registry: PlaywrightRegistrySelection;
-}
-interface PlaywrightChildSuccess extends PlaywrightChildRequest {
-    readonly browserExecutable: string;
-    readonly ok: true;
-}
-export declare class PlaywrightInstallationError extends Error {
-    readonly code = "TESTKIT_PLAYWRIGHT_INSTALLATION_INVALID";
-    constructor(problem: string, options?: ErrorOptions);
-}
-export declare class UnsupportedPlaywrightPlatformError extends Error {
-    readonly code = "TESTKIT_PLAYWRIGHT_PLATFORM_UNSUPPORTED";
-    constructor(target: Readonly<PlatformTarget>, linuxLibc: LinuxLibc | null);
-}
-export declare function resolvePlaywrightPackageFamily(resolver?: RootPackageResolver): PlaywrightPackageFamily;
-export declare function resolvePlaywrightRegistry(options: {
-    readonly ambientEnvironment: Readonly<NodeJS.ProcessEnv>;
-    readonly configuredValue?: string;
-    readonly homeDirectory?: string;
-    readonly platform: PlatformTarget["platform"];
-    readonly productRoot: string;
-}): PlaywrightRegistrySelection;
-export declare function playwrightRegistryEnvironment(ambientEnvironment: Readonly<NodeJS.ProcessEnv>, registry: Readonly<PlaywrightRegistrySelection>): Readonly<Record<string, string>>;
-export declare function resolvePlaywrightInstallation(context: Readonly<EngineResolutionContext>, options?: Readonly<PlaywrightResolutionOptions>): Promise<PlaywrightInstallation>;
-export declare function throwIfPlaywrightProcessAborted(signal: AbortSignal, result: Readonly<ManagedProcessResult>, processFailure: Error | null): void;
-type ParsedChildOutput = PlaywrightChildSuccess | Readonly<{
-    error: Readonly<{
-        code?: string;
-        message: string;
-        name: string;
-    }>;
-    ok: false;
-}>;
-export declare function requireBoundedPlaywrightChildOutput(stdout: string): void;
-export declare function parsePlaywrightChildOutput(stdout: string): ParsedChildOutput;
-export declare function requireMatchingPlaywrightChildRequest(output: Readonly<PlaywrightChildSuccess>, request: Readonly<PlaywrightChildRequest>): void;
-export declare function requireBrowserExecutable(value: string, target: Readonly<PlatformTarget>): string;
-export declare function requireSupportedPlaywrightHost(host: Readonly<PlaywrightHost>): void;

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

@@ -1,10 +0,0 @@
-export interface EngineResolutionContext {
-    readonly productRoot: string;
-    readonly signal: AbortSignal;
-}
-export interface DirectPackageInstallation<Name extends string = string> {
-    readonly entrypoint: string;
-    readonly name: Name;
-    readonly root: string;
-    readonly version: string;
-}

package/dist/engines/k6/adapter/bundle.d.ts

@@ -1,25 +0,0 @@
-import type { EngineCancellationSignal, EngineJsonObject } from "../../api/index.js";
-import { type BuildFailure } from "esbuild";
-export declare class K6ConsumerCompilationError extends Error {
-    constructor(error: BuildFailure);
-}
-export interface K6BundleRequest {
-    readonly configuration?: EngineJsonObject;
-    readonly entrypoints: Readonly<{
-        authoring: string;
-        config: string;
-        root: string;
-        rootPackageJson: string;
-    }>;
-    readonly nativeSummaryDirectory: string;
-    readonly outputFile: string;
-    readonly rootDirectory: string;
-    readonly signal: EngineCancellationSignal;
-    readonly sourceFile: string;
-}
-/**
- * Builds a self-contained Sobek/k6 module. Testkit public imports resolve only
- * to the selected root package entrypoints; native k6/xk6 modules remain
- * external for Sobek to provide.
- */
-export declare function bundleK6Suite({ configuration, entrypoints, outputFile, nativeSummaryDirectory, rootDirectory, signal, sourceFile, }: Readonly<K6BundleRequest>): Promise<void>;