@gfdelarue/testkit 0.3.0

package/dist/engines/manager.d.ts

@@ -0,0 +1,24 @@
+import { type EngineExecutionRequest, type EngineExecutionResult } from "./api/index.js";
+import { type EngineId } from "../domain/identifiers.js";
+import type { InternalEngineInstallationCatalog, InternalEngineRegistration } from "./installation-catalog.js";
+export type EngineManagerExecutionRequest = EngineExecutionRequest;
+export interface EngineManagerOptions {
+    readonly catalog: InternalEngineInstallationCatalog;
+    readonly productRoot: string;
+}
+export interface ResolvedEngineExecutionSession<Id extends EngineId = EngineId> {
+    readonly engineId: Id;
+    execute(request: Readonly<EngineExecutionRequest<Id>>): Promise<EngineExecutionResult>;
+}
+export declare class EngineExecutorLoadError extends Error {
+    readonly code = "TESTKIT_ENGINE_EXECUTOR_LOAD_FAILED";
+    readonly engineId: EngineId;
+    constructor(engineId: EngineId, options: ErrorOptions);
+}
+export declare class EngineManager {
+    private readonly catalog;
+    private readonly productRoot;
+    constructor(options: Readonly<EngineManagerOptions>);
+    resolve<Id extends EngineId>(engineId: Id): InternalEngineRegistration<Id>;
+    withEngine<Id extends EngineId, Result>(engineId: Id, signal: AbortSignal, operation: (session: ResolvedEngineExecutionSession<Id>) => Result | PromiseLike<Result>): Promise<Result>;
+}

package/dist/engines/manager.js

@@ -0,0 +1 @@
+import{ENGINE_PROTOCOL_LIMITS as d,beginEngineExecution as E,createEngineInvocationScope as g}from"./api/index.js";import"../domain/identifiers.js";export class EngineExecutorLoadError extends Error{code="TESTKIT_ENGINE_EXECUTOR_LOAD_FAILED";engineId;constructor(e,o){super(`Resolved ${e} executor could not be loaded`,o),this.name="EngineExecutorLoadError",this.engineId=e}}export class EngineManager{catalog;productRoot;constructor(e){this.catalog=e.catalog,this.productRoot=e.productRoot}resolve(e){return this.catalog.resolve(e)}async withEngine(e,o,r){const a=this.resolve(e);o.throwIfAborted();const c=await a.resolveInstallation({productRoot:this.productRoot,signal:o});return o.throwIfAborted(),r(h(a,c))}}function h(t,e){return Object.freeze({engineId:t.id,async execute(o){u(o.signal);const r=E(o),a=g({timeoutMs:d.cleanupTimeoutMs});let c=null,i,s=!1;try{const l=await w(t);u(o.signal),c=r.acceptResult(await l(r.request,e,a.scope))}catch(l){s=!0,i=l}finally{r.close()}const n=await a.drain();if(s)throw n.length===0?i:new AggregateError([i,...n],`Engine invocation failed and ${n.length.toString()} cleanup handler(s) also failed`,{cause:i});if(n.length>0)throw new AggregateError(n,`${n.length.toString()} engine invocation cleanup handler(s) failed`);if(c===null)throw new Error("Engine invocation completed without a result");return r.commit(),c}})}function u(t){if(t.aborted)throw t.reason instanceof Error?t.reason:new Error("Resolved engine invocation was cancelled",{cause:t.reason})}async function w(t){try{return await t.loadExecutor()}catch(e){throw new EngineExecutorLoadError(t.id,{cause:e})}}

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

@@ -0,0 +1,16 @@
+import { type ProcessClassification } from "../../adapters/execution.js";
+import { type EngineExecutionRequest, type EngineExecutionResult, type EngineFailureEvidence, type EngineInvocationScope } from "../../api/index.js";
+import { type ManagedProcessResult } from "../../../process/index.js";
+import type { NodeVitestInstallation } from "../../installations/node-vitest.js";
+import { type CollectedNodeVitestEvidence } from "./evidence.js";
+import { writeOwnedNodeVitestRuntimeInput, type NodeVitestRuntimeInputDocument } from "../runtime/runtime-input.js";
+import { writeNodeVitestWorkspace } from "./workspace.js";
+export interface NodeVitestExecutorDependencies {
+    removeOwnedDirectory(directory: string): Promise<void>;
+    writeWorkspace(request: Parameters<typeof writeNodeVitestWorkspace>[0]): ReturnType<typeof writeNodeVitestWorkspace>;
+    writeRuntimeInput(taskDirectory: string, document: NodeVitestRuntimeInputDocument): ReturnType<typeof writeOwnedNodeVitestRuntimeInput>;
+}
+export declare const nodeVitestExecutorDependencies: NodeVitestExecutorDependencies;
+export declare function executeNodeVitestEngine(request: Readonly<EngineExecutionRequest<"node-vitest">>, installation: Readonly<NodeVitestInstallation>, scope: EngineInvocationScope, dependencies?: NodeVitestExecutorDependencies): Promise<EngineExecutionResult>;
+export declare function classifyNodeVitestProcessResult(result: ManagedProcessResult, collected: CollectedNodeVitestEvidence, timeoutMs: number, deadlineExceeded: boolean): ProcessClassification;
+export declare function nodeVitestEvidenceCollectionFailure(result: ManagedProcessResult, error: unknown): EngineFailureEvidence;

package/dist/engines/node-vitest/adapter/adapter.js

@@ -0,0 +1 @@
+import{makeTempDirAsync as R}from"../../../process/files/temp-dir.js";import{classifyManagedProcessResult as W,terminalOutcome as y,processOutputEvidence as z,emptyEvidence as J,failureFromError as f,firstOutputLine as h,processExitFailure as H,toError as x,executeEngineTasks as Y,managedProcessFailure as G}from"../../adapters/execution.js";import{requireRootDirectory as Q,requireAbsoluteWorkspacePath as M,requireConsumerFile as P,safeSegment as A}from"../../adapters/workspace.js";import d from"node:fs/promises";import c from"node:path";import{pathToFileURL as X}from"node:url";import{isEngineTaskDeadlineExceededReason as Z,resolveEngineTaskInputs as q}from"../../api/index.js";import{createInvocationProcessEnvironment as tt,runManagedProcess as et}from"../../../process/index.js";import{collectNodeVitestEvidence as it}from"./evidence.js";import{assertNodeVitestSpawnEnvironmentBudget as rt,NODE_VITEST_RUNTIME_INPUT_FILE_ENV as ot,NODE_VITEST_RUNTIME_INPUT_SHA256_ENV as nt,selectNodeVitestForwardedEnvironment as st,verifyOwnedNodeVitestRuntimeInput as at,writeOwnedNodeVitestRuntimeInput as ct}from"../runtime/runtime-input.js";import{writeNodeVitestWorkspace as ut}from"./workspace.js";import{engineEvidenceIdentity as dt}from"../../adapters/evidence-identity.js";const E={codePrefix:"NODE_VITEST",label:"Node/Vitest"};class L extends Error{constructor(e){const i=x(e);super(i.message,{cause:i}),this.name="NodeVitestConsumerPreparationError"}}export const nodeVitestExecutorDependencies={removeOwnedDirectory:t=>d.rm(t,{force:!0,recursive:!0}),writeRuntimeInput:ct,writeWorkspace:ut};export async function executeNodeVitestEngine(t,e,i,r=nodeVitestExecutorDependencies){const o=await pt(t,e,r,i);return Y(t,o.tasks,E,(n,s)=>ft(t,o,n,s),vt(t,o.installation))}async function pt(t,e,i,r){const o=t.profile.id,n=e.packages.vitest.cli,s=await Q(t.workspace.rootDirectory);M(t.workspace.temporaryDirectory,"temporary directory"),M(t.workspace.artifactDirectory,"artifact directory"),await d.mkdir(t.workspace.temporaryDirectory,{recursive:!0}),await d.mkdir(t.workspace.artifactDirectory,{recursive:!0});const l=await d.realpath(t.workspace.temporaryDirectory),p=await d.realpath(t.workspace.artifactDirectory),I=Object.freeze({...e.authoringEntrypoints,cli:e.packages.vitest.cli,packages:e.packages}),T=await R(`node-vitest-${A(t.invocationId)}-`,{parentDir:l});r.defer(()=>i.removeOwnedDirectory(T));const j=await tt(T),v=[];for(const[U,a]of t.tasks.entries()){const m=q(t,a),S=`${U.toString().padStart(3,"0")}-${A(a.id)}`,u=c.join(T,S),_=await R(`${S}-`,{parentDir:p}),w=c.join(u,"testkit-vitest-report.json"),K=c.join(_,"data","manifest.json"),B=c.join(u,"setup.mjs"),F=c.join(u,"input-bootstrap.mjs"),O=c.join(u,"resolution-bootstrap.cjs"),V=c.join(u,"vitest.config.mjs");try{await d.mkdir(u,{mode:448,recursive:!1});const D=await N(()=>P(s,a.file,"Node/Vitest task file")),k=await N(()=>Tt(s,m)),$=await N(()=>Et(t,o,a,m)),g=await i.writeRuntimeInput(u,$);await i.writeWorkspace({report:{identity:{engineId:"node-vitest",invocationId:t.invocationId,taskId:a.id,sourceFile:a.file},reportFile:w,workspaceDirectory:u},configFile:k.testkitConfig,entrypoints:I,inputBootstrapFile:F,resolutionBootstrapFile:O,rootDirectory:s,runtimeInput:{expectedFile:g.file,expectedInvocationId:t.invocationId,expectedProfileId:o,expectedSha256:g.sha256,expectedTaskId:a.id},setupFile:B,sourceFile:D,timeoutMs:Math.max(1,a.deadlineMs-Date.now()),tsconfigFile:k.tsconfig,vitestConfigFile:V}),v.push({artifactDirectory:_,inputs:m,task:a,preparationFailure:null,prepared:{dataManifestFile:K,inputBootstrapFile:F,reportFile:w,resolutionBootstrapFile:O,runtimeInput:g,vitestConfigFile:V}})}catch(D){v.push({artifactDirectory:_,inputs:m,task:a,preparationFailure:_t(D),prepared:null})}}return Object.freeze({cliFile:n,installation:e,invocationEnvironment:j.environment,profileId:o,rootDirectory:s,tasks:Object.freeze(v)})}async function ft(t,e,i,r){const o=Math.max(0,i.task.deadlineMs-r);try{await at(i.prepared.runtimeInput)}catch(p){return y(i.task.id,"failed",r,J(),{...f(p,"NODE_VITEST_INPUT_INVALID"),classification:"infra"})}const n=await et({args:[e.cliFile,"run","--config",i.prepared.vitestConfigFile,"--configLoader","runner"],cwd:e.rootDirectory,displayLabel:"Node/Vitest",env:mt(t,e,i),executable:process.execPath,signal:t.signal,timeoutMs:o});let s;try{s=await it({identity:{engineId:"node-vitest",invocationId:t.invocationId,taskId:i.task.id,sourceFile:i.task.file},artifactDirectory:i.artifactDirectory,dataManifestFile:i.prepared.dataManifestFile,profileId:e.profileId,reportFile:i.prepared.reportFile,rootDirectory:e.rootDirectory,stderr:n.stderr,stdout:n.stdout})}catch(p){const I=z(n);return y(i.task.id,"failed",r,I,nodeVitestEvidenceCollectionFailure(n,p))}const l=classifyNodeVitestProcessResult(n,s,i.task.timeoutMs,Z(t.signal.reason));return y(i.task.id,l.status,r,s.evidence,l.failure)}export function classifyNodeVitestProcessResult(t,e,i,r){const o=W(t,i,r,E);return o!==null?o:e.reportSummary?.numTotalTests===0?{failure:{code:"NODE_VITEST_NO_TESTS",message:"Vitest did not discover any tests for the task file"},status:"failed"}:lt(e.reportSummary)?{failure:null,status:"skipped"}:t.exitCode!==0?H(t,E,e.reportFailureMessage??h(t.stderr)??h(t.stdout),"Vitest"):e.reportError!==null?{failure:{...f(e.reportError,"NODE_VITEST_REPORT_INVALID"),classification:"infra"},status:"failed"}:e.reportFailureMessage!==null?{failure:{code:"NODE_VITEST_REPORT_FAILED",message:e.reportFailureMessage},status:"failed"}:e.dataEvidenceError!==null?{failure:f(e.dataEvidenceError,"NODE_VITEST_DATA_EVIDENCE_INVALID"),status:"failed"}:e.reportSummary===null||!e.reportSummary.success||e.reportSummary.numFailedTests>0||e.reportSummary.numPassedTests===0?{failure:{code:"NODE_VITEST_REPORT_FAILED",message:"Vitest report did not contain a completed passing test"},status:"failed"}:{failure:null,status:"passed"}}export function nodeVitestEvidenceCollectionFailure(t,e){const i=x(e);return G(t,E,i)??{...f(i,"NODE_VITEST_EVIDENCE_FAILED"),classification:"infra"}}function lt(t){return t!==null&&t.success&&t.numTotalTests>0&&t.numPassedTests===0&&t.numFailedTests===0&&(t.numPendingTests>0||t.numTodoTests>0)}function mt(t,e,i){const r=i.task,o=C(t,r.serviceName),n={...e.invocationEnvironment};return Object.assign(n,{...o===null?{}:{BASE_URL:o},FORCE_COLOR:"0",NODE_OPTIONS:It(i.prepared.resolutionBootstrapFile,i.prepared.inputBootstrapFile),NO_COLOR:"1",TESTKIT_ACTIVE:"1",[ot]:i.prepared.runtimeInput.file,[nt]:i.prepared.runtimeInput.sha256,TESTKIT_INTERNAL_FILE_DEADLINE_MS:String(r.deadlineMs),TESTKIT_INTERNAL_FILE_TIMEOUT_SECONDS:String(Math.max(1,Math.ceil(r.timeoutMs/1e3))),TESTKIT_INVOCATION_ID:t.invocationId,TESTKIT_LEASE_DIR:r.orchestration.lease.directory,TESTKIT_LEASE_ID:r.orchestration.lease.id,TESTKIT_MODE:r.orchestration.mode,...r.orchestration.runtimeId===void 0?{}:{TESTKIT_RUNTIME_ID:r.orchestration.runtimeId},TESTKIT_TEST_FILE:r.file,TESTKIT_TEST_ID:r.id,...e.profileId==="node-vitest-data"?{TESTKIT_DATA_ARTIFACT_DIR:c.dirname(i.prepared.dataManifestFile)}:{}}),rt(n),n}function Et(t,e,i,r){const o=C(t,i.serviceName),n=st(r.environment);return{context:{baseUrl:o,engineId:"node-vitest",invocationId:t.invocationId,profileId:e,serviceName:i.serviceName,task:{file:i.file,id:i.id,suiteName:i.suiteName,testType:i.testType}},engineId:"node-vitest",environment:n,fixtures:r.fixtures,invocationId:t.invocationId,profileId:e,...r.setupData===void 0?{}:{setupData:r.setupData},taskId:i.id,version:1}}function It(t,e){return[`--require=${JSON.stringify(t)}`,`--import=${JSON.stringify(X(e).href)}`].join(" ")}function C(t,e){return Object.hasOwn(t.target.endpoints,e)?t.target.endpoints[e]:null}async function Tt(t,e){return{testkitConfig:await b(t,e.supportModules,"testkitConfig"),tsconfig:await b(t,e.supportModules,"tsconfig")}}async function b(t,e,i){if(!Object.hasOwn(e,i))return null;const r=e[i];if(!c.isAbsolute(r))throw new Error(`supportModules.${i} must be an absolute path`);return P(t,r,`supportModules.${i}`)}function vt(t,e){return{...dt({engineId:"node-vitest",installationKind:"root-direct-packages",profile:t.profile}),directPackages:{esbuild:e.packages.esbuild.version,typescript:e.packages.typescript.version,vite:e.packages.vite.version,vitest:e.packages.vitest.version}}}function _t(t){return{...f(t,"NODE_VITEST_PREPARE_FAILED"),classification:t instanceof L?"product":"infra"}}async function N(t){try{return await t()}catch(e){throw new L(e)}}

package/dist/engines/node-vitest/adapter/consumer-typescript-paths.d.ts

@@ -0,0 +1,17 @@
+export declare const managedTypeScriptFile: string;
+export interface ConsumerTypeScriptPathsPlugin {
+    readonly enforce: "pre";
+    readonly name: string;
+    resolveId(specifier: string, importer: string | undefined): string | null;
+}
+export interface NodeVitestConsumerResolutionPolicy {
+    readonly aliases: Readonly<Record<string, string>>;
+    readonly dependencyRoots: readonly string[];
+}
+/**
+ * Resolves only paths declared by the explicitly supplied consumer tsconfig.
+ * The engine never searches for a project configuration on its own.
+ */
+export declare function createConsumerTypeScriptPathsPlugin(tsconfigFile: string, policy: Readonly<NodeVitestConsumerResolutionPolicy>): ConsumerTypeScriptPathsPlugin | null;
+export declare function assertNodeVitestConsumerResolution(specifier: string, resolvedId: string, importer: string | undefined, policy: Readonly<NodeVitestConsumerResolutionPolicy>): string;
+export declare function isNodeVitestManagedDependencyImporter(value: string | undefined, roots: readonly string[]): boolean;

package/dist/engines/node-vitest/adapter/consumer-typescript-paths.js

@@ -0,0 +1,3 @@
+import{isPathWithin as y}from"../../../process/files/paths.js";import u from"node:fs";import i from"node:path";import{fileURLToPath as f}from"node:url";import c from"typescript";import{NODE_VITEST_PACKAGE_REQUIREMENTS as h}from"../../installations/node-vitest.js";export const managedTypeScriptFile=f(import.meta.resolve("typescript"));const N=/^@gfdelarue\/testkit(?:\/|$)/u;export function createConsumerTypeScriptPathsPlugin(t,e){const r=E(t),n=Object.keys(r.paths??{});return n.length===0?null:{enforce:"pre",name:"testkit-node-vitest-consumer-typescript-paths",resolveId(o,a){if(a===void 0||isNodeVitestManagedDependencyImporter(a,e.dependencyRoots)||N.test(o)||!n.some(g=>S(o,g)))return null;const s=w(a);if(s===null)return null;const l=c.resolveModuleName(o,s,r,c.sys).resolvedModule?.resolvedFileName;return l===void 0?null:assertNodeVitestConsumerResolution(o,l,a,e)}}}export function assertNodeVitestConsumerResolution(t,e,r,n){if(isNodeVitestManagedDependencyImporter(r,n.dependencyRoots))return e;const o=m(e);if(o===null)return e;const a=k(o);if(a===null)return e;if(a.privatePackage)throw new Error(`Node/Vitest consumers may not resolve ${JSON.stringify(t)} into private Vitest package ${a.packageName}`);const s=n.aliases[t];if(Object.hasOwn(n.aliases,t)&&p(o,s)||Object.values(n.aliases).some(l=>p(o,l)))return e;throw new Error(`Node/Vitest consumers may not resolve ${JSON.stringify(t)} into managed direct package ${a.packageName}; import an exact public ${JSON.stringify(a.packageName)} export instead`)}function k(t){const e=[t];try{const r=u.realpathSync(t);r!==t&&e.push(r)}catch{}for(const r of e){let n=i.dirname(r);for(;;){const o=i.join(n,"package.json");if(u.existsSync(o)){const s=v(o);if(s!==null){if(s.startsWith("@vitest/"))return{packageName:s,privatePackage:!0};if(h.some(({packageName:l})=>l===s))return{packageName:s,privatePackage:!1}}}const a=i.dirname(n);if(a===n)break;n=a}}return null}function v(t){let e;try{e=JSON.parse(u.readFileSync(t,"utf8"))}catch(n){throw new Error(`Cannot inspect package boundary at ${t}`,{cause:n})}if(typeof e!="object"||e===null||Array.isArray(e))return null;const r=Reflect.get(e,"name");return typeof r=="string"?r:null}export function isNodeVitestManagedDependencyImporter(t,e){if(t===void 0)return!1;const r=m(t);return r===null?!1:e.some(n=>y(n,r))}function m(t){const e=t.split(/[?#]/u,1)[0];if(e.startsWith("\0"))return null;if(e.startsWith("file:"))return f(e);const r=e.startsWith("/@fs/")?e.slice(4):e;return i.isAbsolute(r)?i.resolve(r):null}function p(t,e){try{return u.realpathSync(t)===u.realpathSync(e)}catch{return i.resolve(t)===i.resolve(e)}}function E(t){const e=i.resolve(t).replaceAll(i.sep,"/"),r=i.posix.dirname(e),n=c.readConfigFile(e,s=>c.sys.readFile(s));if(n.error!==void 0)throw new Error(d(e,[n.error]));const o=c.parseJsonConfigFileContent(n.config,c.sys,r,{},e),a=o.errors.filter(s=>s.category===c.DiagnosticCategory.Error&&s.code!==18003);if(a.length>0)throw new Error(d(e,a));return o.options}function d(t,e){const r=c.formatDiagnostics(e,{getCanonicalFileName:n=>n,getCurrentDirectory:()=>i.posix.dirname(t),getNewLine:()=>`
+`});return`Cannot load explicit consumer TypeScript paths from ${t}:
+${r}`.trim()}function S(t,e){const r=e.indexOf("*");if(r===-1)return t===e;const n=e.slice(0,r),o=e.slice(r+1);return t.startsWith(n)&&t.endsWith(o)}function w(t){const e=t.split(/[?#]/u,1)[0];return e.startsWith("file:")?f(e):i.isAbsolute(e)?e:null}

package/dist/engines/node-vitest/adapter/evidence.d.ts

@@ -0,0 +1,33 @@
+import type { EngineEvidence, EngineJsonObject } from "../../api/index.js";
+import { type EvidenceFileAccess } from "../../adapters/evidence-files.js";
+import { type NativeReportIdentity } from "../../adapters/native-report.js";
+type NodeVitestProfileId = "node-vitest-contract" | "node-vitest-data";
+export declare const NODE_VITEST_DATA_ARTIFACT_MAX_BYTES: number;
+export declare const NODE_VITEST_DATA_EVIDENCE_MAX_BYTES: number;
+export interface NodeVitestEvidenceRequest {
+    readonly identity: NativeReportIdentity;
+    readonly artifactDirectory: string;
+    readonly dataManifestFile: string;
+    readonly profileId: NodeVitestProfileId;
+    readonly reportFile: string;
+    readonly rootDirectory: string;
+    readonly stderr: string;
+    readonly stdout: string;
+}
+export interface CollectedNodeVitestEvidence {
+    readonly dataEvidenceError: Error | null;
+    readonly evidence: EngineEvidence;
+    readonly reportError: Error | null;
+    readonly reportFailureMessage: string | null;
+    readonly reportSummary: NodeVitestReportSummary | null;
+}
+export interface NodeVitestReportSummary extends EngineJsonObject {
+    readonly numFailedTests: number;
+    readonly numPassedTests: number;
+    readonly numPendingTests: number;
+    readonly numTodoTests: number;
+    readonly numTotalTests: number;
+    readonly success: boolean;
+}
+export declare function collectNodeVitestEvidence(request: Readonly<NodeVitestEvidenceRequest>, fileAccess?: EvidenceFileAccess): Promise<CollectedNodeVitestEvidence>;
+export {};

package/dist/engines/node-vitest/adapter/evidence.js

@@ -0,0 +1,2 @@
+import w from"node:fs/promises";import y from"node:path";import{evidenceFileAccess as R,readStableEvidenceFile as b,writeOwnedEvidenceFile as $}from"../../adapters/evidence-files.js";import{NODE_VITEST_DATA_BUDGET_FAILURE_DETAIL_KIND as F,NODE_VITEST_DATA_FAILURE_DETAILS_ARTIFACT_KIND as _,NODE_VITEST_DATA_FAILURE_DETAILS_ARTIFACT_NAME as V}from"../runtime/runtime-input.js";import{vitestTestFailureDetails as B}from"./failure-details.js";import{readNativeReport as L,requireNativeEvidenceJson as M}from"../../adapters/native-report.js";const z=16*1024*1024,N=1024;export const NODE_VITEST_DATA_ARTIFACT_MAX_BYTES=16*1024*1024,NODE_VITEST_DATA_EVIDENCE_MAX_BYTES=64*1024*1024;const C=".testkit-owned-evidence";export async function collectNodeVitestEvidence(t,e=R){await w.mkdir(t.artifactDirectory,{recursive:!0});const r=await w.realpath(t.artifactDirectory),s=y.join(r,C);await w.mkdir(s,{mode:448,recursive:!1});const n=[],a=[];t.stdout.length>0&&(a.push({stream:"stdout",text:t.stdout}),n.push(await k(r,"stdout.log","node-vitest-stdout",t.stdout))),t.stderr.length>0&&(a.push({stream:"stderr",text:t.stderr}),n.push(await k(r,"stderr.log","node-vitest-stderr",t.stderr)));const i=await J(t.reportFile,t.identity,t.rootDirectory,s,e);n.push(...i.artifacts);const f=t.profileId==="node-vitest-data"?await X(r,s,t.dataManifestFile,e):{artifacts:[],error:null};return n.push(...f.artifacts),{dataEvidenceError:f.error,evidence:{artifacts:n,logs:a,metrics:[],...i.summary===null?{}:{native:{vitest:i.summary}}},reportError:i.error,reportFailureMessage:i.failureMessage,reportSummary:i.summary}}async function J(t,e,r,s,n){try{const a=await I(t,n);if(!a.exists||a.contents===null)throw new Error("Vitest did not produce its Testkit native report");const i=L(a.value,e).result;if(!T(i)||!T(i.summary))throw new Error("Vitest native report must contain result and summary objects");const f=G(i.summary),c=B(i.failures,r);if(f.numFailedTests!==c.length)throw new Error("Vitest native report failure count does not match its summary");if(!Array.isArray(i.errors)||!i.errors.every(m=>typeof m=="string"))throw new Error("Vitest native report errors must contain strings");if(f.success&&i.errors.length>0)throw new Error("Vitest native report success conflicts with runtime errors");const u=await $(s,"testkit-vitest-report.json",a.contents),o=await S(u,"application/json","engine.testkit-vitest-report","testkit-vitest-report","Testkit native Vitest report"),d=await U(s,c);return{artifacts:[o,...d===null?[]:[d]],error:null,failureMessage:typeof c[0]?.message=="string"?c[0].message:i.errors.find(m=>m.trim().length>0)??null,summary:f}}catch(a){return{artifacts:[],error:D(a),failureMessage:null,summary:null}}}async function U(t,e){if(e.length===0)return null;const r={failures:e,phase:"exec"},s=await $(t,"vitest-failure-details.json",Buffer.from(`${JSON.stringify(r,null,2)}
+`,"utf8"));return{...await S(s,"application/json","testkit.failure-details","vitest-failure-details",`${e.length.toString()} failed Vitest test${e.length===1?"":"s"}`),data:r}}async function X(t,e,r,s){let n;try{n=await I(r,s)}catch(c){return{artifacts:[],error:D(c)}}if(!n.exists)return{artifacts:[],error:new Error("Data profile did not produce an artifact manifest")};let a;try{a=Y(n.value)}catch(c){return{artifacts:[],error:D(c)}}const i=[],f=new Set;try{if(n.contents===null)throw new Error("Data artifact manifest bytes are unavailable");let c=n.contents.byteLength;if(c>NODE_VITEST_DATA_EVIDENCE_MAX_BYTES)throw new Error(`Data evidence exceeds its ${NODE_VITEST_DATA_EVIDENCE_MAX_BYTES.toString()} byte aggregate limit`);for(const[o,d]of a.artifacts.entries()){const m=await K(t,e,d,o,NODE_VITEST_DATA_EVIDENCE_MAX_BYTES-c,s),{artifact:l}=m,p=`${l.kind}\0${l.name}\0${m.sourcePath}`;if(f.has(p))throw new Error(`Data artifact manifest contains duplicate artifact ${l.name}`);f.add(p);const E=q(l.metadata?.sizeBytes,`Data artifact manifest artifacts[${o.toString()}]`);c+=E,i.push(l)}const u=await $(e,"manifest.json",n.contents);i.push(await S(u,"application/json","engine.data-manifest","data-artifact-manifest",`${i.length.toString()} data artifact(s)`))}catch(c){return{artifacts:i,error:D(c)}}return{artifacts:i,error:null}}function Y(t){if(!T(t))throw new Error("Data artifact manifest must contain an object");if(t.schemaVersion!==1)throw new Error("Data artifact manifest schemaVersion must be 1");if(!Array.isArray(t.artifacts))throw new Error("Data artifact manifest artifacts must be an array");if(t.artifacts.length===0)throw new Error("Data artifact manifest must contain at least one artifact");if(t.artifacts.length>N)throw new Error(`Data artifact manifest exceeds the ${N.toString()} artifact limit`);return{artifacts:t.artifacts,schemaVersion:t.schemaVersion}}async function K(t,e,r,s,n,a){const i=`Data artifact manifest artifacts[${s.toString()}]`;if(!T(r))throw new Error(`${i} must contain an object`);const f=g(r.kind,`${i}.kind`),c=g(r.name,`${i}.name`),u=g(r.path,`${i}.path`),o=await H(t,u,`${i}.path`),d=j(r.contentType,`${i}.contentType`),m=j(r.summary,`${i}.summary`),l=r.metadata===void 0?void 0:A(r.metadata,`${i}.metadata`),{contents:p}=await b(o,NODE_VITEST_DATA_ARTIFACT_MAX_BYTES,i,a);if(p.byteLength>n)throw new Error(`Data evidence exceeds its ${NODE_VITEST_DATA_EVIDENCE_MAX_BYTES.toString()} byte aggregate limit`);const E=W(f,c,d,p,i),O=await $(e,`${s.toString().padStart(4,"0")}-${Q(c)}${Z(o)}`,p);return{artifact:{kind:f,name:c,path:O,...d===void 0?{}:{contentType:d},...E===void 0?{}:{data:E},...m===void 0?{}:{summary:m},metadata:{...l??{},sizeBytes:p.byteLength}},sourcePath:o}}function W(t,e,r,s,n){if(t!==_)return;if(e!==V)throw new Error(`${n}.name must be ${JSON.stringify(V)} for ${_}`);if(r!=="application/json")throw new Error(`${n}.contentType must be "application/json" for ${_}`);const a=v(s,n),i=A(a,n);if(x(i,["failures","phase"],n),i.phase!=="exec")throw new Error(`${n}.phase must be "exec"`);if(!Array.isArray(i.failures)||i.failures.length===0)throw new Error(`${n}.failures must be a non-empty array`);for(const[f,c]of i.failures.entries()){const u=`${n}.failures[${f.toString()}]`,o=A(c,u);if(x(o,["actual","checkName","count","expected","groupPath","key","kind","message","title"],u),o.kind!==F)throw new Error(`${u}.kind must be ${JSON.stringify(F)}`);if(o.count!==1)throw new Error(`${u}.count must be 1`);const d=g(o.checkName,`${u}.checkName`),m=g(o.key,`${u}.key`),l=g(o.title,`${u}.title`);if(g(o.message,`${u}.message`),!Array.isArray(o.groupPath)||o.groupPath.length!==1||typeof o.groupPath[0]!="string"||o.groupPath[0].trim().length===0)throw new Error(`${u}.groupPath must contain one scenario name`);if(m!==`${o.groupPath[0]} > ${l}`)throw new Error(`${u}.key does not match its scenario and title`);if(!l.includes(`"${d}"`))throw new Error(`${u}.title does not identify its checkName`)}return i}async function k(t,e,r,s){const n=y.join(t,e);return await w.writeFile(n,s,"utf8"),S(n,"text/plain; charset=utf-8","engine.output",r,et(s)??"captured output")}async function S(t,e,r,s,n){const a=await w.stat(t);if(!a.isFile())throw new Error(`${s} artifact is not a regular file`);return{contentType:e,kind:r,metadata:{sizeBytes:a.size},name:s,path:t,summary:n}}async function I(t,e){let r;try{({contents:r}=await b(t,z,t,e))}catch(n){if(nt(n)&&n.code==="ENOENT")return{contents:null,exists:!1,value:null};throw n}const s=v(r,t);return{contents:r,exists:!0,value:s}}function v(t,e){const r=JSON.parse(t.toString("utf8"));return M(r,e),r}function G(t){const e={numFailedTests:h(t.numFailedTests,"Vitest native report.summary.numFailedTests"),numPassedTests:h(t.numPassedTests,"Vitest native report.summary.numPassedTests"),numPendingTests:h(t.numPendingTests,"Vitest native report.summary.numPendingTests"),numTodoTests:h(t.numTodoTests,"Vitest native report.summary.numTodoTests"),numTotalTests:h(t.numTotalTests,"Vitest native report.summary.numTotalTests"),numFailedTestSuites:h(t.numFailedTestSuites,"Vitest native report.summary.numFailedTestSuites"),numPassedTestSuites:h(t.numPassedTestSuites,"Vitest native report.summary.numPassedTestSuites"),numPendingTestSuites:h(t.numPendingTestSuites,"Vitest native report.summary.numPendingTestSuites"),numTotalTestSuites:h(t.numTotalTestSuites,"Vitest native report.summary.numTotalTestSuites"),success:tt(t.success,"Vitest native report.summary.success")};if(e.numTotalTests!==e.numFailedTests+e.numPassedTests+e.numPendingTests+e.numTodoTests||e.numTotalTestSuites!==e.numFailedTestSuites+e.numPassedTestSuites+e.numPendingTestSuites||e.success&&(e.numFailedTests>0||e.numFailedTestSuites>0||e.numTotalTestSuites===0))throw new Error("Vitest native report summary contains inconsistent counts or success");return e}async function H(t,e,r){const s=y.isAbsolute(e)?e:y.resolve(t,e),n=await w.lstat(s);if(!n.isFile()||n.isSymbolicLink())throw new Error(`${r} must be a regular non-symbolic-link file`);const a=await w.realpath(s);if(!rt(t,a))throw new Error(`${r} must stay within the task artifact directory`);return a}function Q(t){const e=t.trim().toLowerCase().replace(/[^a-z0-9._-]+/gu,"-").replace(/^-+|-+$/gu,"").slice(0,80);return e.length===0?"artifact":e}function Z(t){const e=y.extname(t).toLowerCase();return/^\.[a-z0-9]{1,12}$/u.test(e)?e:".bin"}function q(t,e){if(typeof t!="number"||!Number.isSafeInteger(t)||t<0)throw new Error(`${e} did not produce a valid sizeBytes identity`);return t}function A(t,e){if(!T(t))throw new Error(`${e} must contain an object`);const r={};for(const[s,n]of Object.entries(t))r[s]=P(n,`${e}.${s}`);return r}function x(t,e,r){const s=Object.keys(t).sort(),n=[...e].sort();if(s.length!==n.length||s.some((a,i)=>a!==n[i]))throw new Error(`${r} must contain exactly ${n.join(", ")}`)}function P(t,e){if(t===null||typeof t=="boolean"||typeof t=="string")return t;if(typeof t=="number"){if(!Number.isFinite(t))throw new Error(`${e} must be finite`);return t}return Array.isArray(t)?t.map((r,s)=>P(r,`${e}[${s.toString()}]`)):A(t,e)}function j(t,e){if(t!==void 0){if(typeof t!="string")throw new Error(`${e} must be a string`);return t}}function g(t,e){if(typeof t!="string"||t.trim().length===0)throw new Error(`${e} must be a non-empty string`);return t}function h(t,e){if(typeof t!="number"||!Number.isSafeInteger(t)||t<0)throw new Error(`${e} must be a non-negative safe integer`);return t}function tt(t,e){if(typeof t!="boolean")throw new Error(`${e} must be boolean`);return t}function et(t){return t.split(/\r?\n/u).map(e=>e.trim()).find(Boolean)??null}function rt(t,e){const r=y.relative(t,e);return r===""||!r.startsWith("..")&&!y.isAbsolute(r)}function T(t){return typeof t=="object"&&t!==null&&!Array.isArray(t)}function nt(t){return t instanceof Error}function D(t){return t instanceof Error?t:new Error(String(t))}

package/dist/engines/node-vitest/adapter/failure-details.d.ts

@@ -0,0 +1,2 @@
+import type { EngineJsonObject } from "../../api/index.js";
+export declare function vitestTestFailureDetails(value: unknown, rootDirectory: string): EngineJsonObject[];

package/dist/engines/node-vitest/adapter/failure-details.js

@@ -0,0 +1,2 @@
+import s from"node:path";export function vitestTestFailureDetails(t,e){if(!Array.isArray(t))throw new Error("Vitest native report failures must be an array");const i=new Set;return t.map(n=>{if(typeof n!="object"||n===null||Array.isArray(n))throw new Error("Vitest native report failure must contain an object");const r=n,u=l(r.id,"id");if(i.has(u))throw new Error("Vitest native report contains a duplicate test identity");i.add(u);const o=l(r.title,"title"),h=w(e,l(r.file,"file")),c=g(r.line),f=g(r.column);if(!Array.isArray(r.messages)||!r.messages.every(a=>typeof a=="string"))throw new Error("Vitest native report failure messages must contain strings");const m=r.messages.map(a=>a.trim()).filter(Boolean),p=m.slice(1).join(`
+`);return{classification:"product",count:1,key:o,kind:"vitest-test",location:{path:h,...c===null?{}:{line:c},...f===null?{}:{column:f}},message:m[0]??`Vitest assertion failed: ${o}`,...p.length===0?{}:{stack:p},title:o}})}function w(t,e){if(!s.isAbsolute(e))return e;const i=s.relative(t,e);return i.length===0||i.startsWith("..")||s.isAbsolute(i)?e:i.split(s.sep).join("/")}function g(t){if(t===null)return null;if(typeof t!="number"||!Number.isSafeInteger(t)||t<0)throw new Error("Vitest native report failure coordinate must be a non-negative integer or null");return t}function l(t,e){if(typeof t!="string"||t.trim().length===0)throw new Error(`Vitest native report failure ${e} must be a non-empty string`);return t}

package/dist/engines/node-vitest/adapter/index.d.ts

@@ -0,0 +1 @@
+export { executeNodeVitestEngine } from "./adapter.js";

package/dist/engines/node-vitest/adapter/index.js

@@ -0,0 +1 @@
+export{executeNodeVitestEngine}from"./adapter.js";

package/dist/engines/node-vitest/adapter/reporter.d.ts

@@ -0,0 +1,7 @@
+import type { Reporter } from "vitest/reporters";
+import { type NativeReportOptions } from "../../adapters/native-report.js";
+export default class TestkitVitestReporter implements Reporter {
+    private readonly options;
+    constructor(options: NativeReportOptions);
+    onTestRunEnd(modules: Parameters<NonNullable<Reporter["onTestRunEnd"]>>[0], unhandledErrors: Parameters<NonNullable<Reporter["onTestRunEnd"]>>[1]): Promise<void>;
+}

package/dist/engines/node-vitest/adapter/reporter.js

@@ -0,0 +1 @@
+import{writeNativeReport as p}from"../../adapters/native-report.js";export default class m{options;constructor(t){this.options=t}async onTestRunEnd(t,s){const n=t.flatMap(e=>[e,...e.children.allSuites()]),l=t.flatMap(e=>[...e.children.allTests()]),o=l.filter(e=>e.result().state==="failed"),r=n.filter(e=>e.state()==="failed").length,u=n.filter(e=>e.state()==="pending"||e.state()==="queued"||e.type==="suite"&&e.options.mode==="todo").length,d=[...n.flatMap(e=>e.errors().map(i=>i.message)),...s.map(e=>e.message)];await p(this.options,{summary:{numFailedTestSuites:r,numFailedTests:o.length,numPassedTestSuites:n.length-r-u,numPassedTests:l.filter(e=>e.result().state==="passed").length,numPendingTestSuites:u,numPendingTests:l.filter(e=>e.options.mode!=="todo"&&(e.result().state==="pending"||e.result().state==="skipped")).length,numTodoTests:l.filter(e=>e.options.mode==="todo").length,numTotalTestSuites:n.length,numTotalTests:l.length,success:t.length>0&&r===0&&o.length===0&&d.length===0},failures:o.map(e=>({id:e.id,title:c(e),file:e.module.moduleId,line:e.location?.line??null,column:e.location?.column??null,messages:e.result().errors?.map(i=>i.stack||i.message)??[]})),errors:d},16*1024*1024)}}function c(a){const t=[];let s=a.parent;for(;s.type==="suite";)t.unshift(s.name),s=s.parent;return[...t,a.name].join(" ")}

package/dist/engines/node-vitest/adapter/resolution.d.ts

@@ -0,0 +1,12 @@
+import { type ManagedNodeModuleResolution } from "../../managed-module-resolution.js";
+import { type NodeVitestAuthoringEntrypoints, type NodeVitestInstallation } from "../../installations/node-vitest.js";
+export interface NodeVitestResolutionEntrypoints extends NodeVitestAuthoringEntrypoints {
+    readonly cli: string;
+    readonly packages: NodeVitestInstallation["packages"];
+}
+export interface NodeVitestResolutionBoundary {
+    readonly consumerRoots: readonly string[];
+    readonly trustedImporterFiles: readonly string[];
+    readonly trustedInternalEntrypoints: readonly string[];
+}
+export declare function resolveNodeVitestManagedRuntimeResolution(entrypoints: Readonly<NodeVitestResolutionEntrypoints>, boundary: Readonly<NodeVitestResolutionBoundary>): ManagedNodeModuleResolution;

package/dist/engines/node-vitest/adapter/resolution.js

@@ -0,0 +1 @@
+import c from"node:path";import{createManagedNodeModuleResolution as d}from"../../managed-module-resolution.js";import{NODE_VITEST_PACKAGE_REQUIREMENTS as i,NODE_VITEST_PRIVATE_PACKAGE_PREFIXES as g}from"../../installations/node-vitest.js";export function resolveNodeVitestManagedRuntimeResolution(t,a){const o=i.filter(e=>e.authoringResolution==="exact-entrypoint"),n=Object.fromEntries(i.filter(e=>e.authoringResolution==="package-exports").map(e=>[e.packageName,t.packages[e.packageName].entrypoint])),r=o.map(e=>t.packages[e.packageName].root),s=d({consumerRoots:a.consumerRoots,direct:{"@gfdelarue/testkit":t.root,"@gfdelarue/testkit/config":t.config,"@gfdelarue/testkit/node-vitest/contract":t.contract,"@gfdelarue/testkit/node-vitest/data":t.data,"@gfdelarue/testkit/package.json":t.rootPackageJson,...Object.fromEntries(o.map(e=>[e.packageName,t.packages[e.packageName].entrypoint]))},directBridgeRoots:[c.dirname(t.root),...r],engineLabel:"Node/Vitest",forbiddenConsumerPackagePrefixes:g,packageAnchors:n,reservedPackageNames:["@gfdelarue/testkit",...o.map(e=>e.packageName)],stateSymbol:"@gfdelarue/testkit/node-vitest/resolution-hooks/v1",trustedImporterFiles:a.trustedImporterFiles,trustedInternalEntrypoints:a.trustedInternalEntrypoints,verifiedParentlessPackageFiles:{vitest:["dist/workers/forks.js","suppress-warnings.cjs"]},verifiedProcessEntrypoints:[t.cli]});return Object.freeze({...s,dependencyRoots:Object.freeze([...new Set([...s.dependencyRoots,c.dirname(t.root),...r])])})}

package/dist/engines/node-vitest/adapter/workspace.d.ts

@@ -0,0 +1,19 @@
+import { type InstallNodeVitestRuntimeInputRequest } from "../runtime/runtime-input.js";
+import { type NodeVitestResolutionEntrypoints } from "./resolution.js";
+import { type NativeReportOptions } from "../../adapters/native-report.js";
+export interface WriteNodeVitestWorkspaceRequest {
+    readonly report: NativeReportOptions;
+    readonly configFile: string | null;
+    readonly entrypoints: NodeVitestResolutionEntrypoints;
+    readonly inputBootstrapFile: string;
+    readonly resolutionBootstrapFile: string;
+    readonly rootDirectory: string;
+    readonly runtimeInput: InstallNodeVitestRuntimeInputRequest;
+    readonly setupFile: string;
+    readonly sourceFile: string;
+    readonly timeoutMs: number;
+    readonly tsconfigFile: string | null;
+    readonly vitestConfigFile: string;
+}
+export declare function writeNodeVitestWorkspace(request: Readonly<WriteNodeVitestWorkspaceRequest>): Promise<void>;
+export declare function toVitestIncludePattern(file: string): string;

package/dist/engines/node-vitest/adapter/workspace.js

@@ -0,0 +1,177 @@
+import o from"node:fs/promises";import i from"node:path";import{fileURLToPath as g,pathToFileURL as a}from"node:url";import{NODE_VITEST_RUNTIME_INPUT_SYMBOL as p}from"../runtime/runtime-input.js";import{NODE_VITEST_PACKAGE_REQUIREMENTS as y}from"../../installations/node-vitest.js";import{resolveNodeVitestManagedRuntimeResolution as R}from"./resolution.js";import{nativeReporterFile as N}from"../../adapters/native-report.js";const u="elench.testkit.node-vitest.config-runtime.v1",l=g(new URL("../../../../dist/engines/node-vitest/",import.meta.url)),m=i.join(l,"adapter/consumer-typescript-paths.js"),f=i.join(l,"runtime/data/runner.js"),d=i.join(l,"runtime/runtime-input.js");export async function writeNodeVitestWorkspace(e){await o.mkdir(i.dirname(e.setupFile),{recursive:!0});const t=R(e.entrypoints,{consumerRoots:[e.rootDirectory],trustedImporterFiles:[e.inputBootstrapFile,e.setupFile,e.vitestConfigFile],trustedInternalEntrypoints:[m,d]});await Promise.all([o.writeFile(e.setupFile,I(e.configFile,e.runtimeInput.expectedProfileId),"utf8"),o.writeFile(e.inputBootstrapFile,S(e.runtimeInput),"utf8"),o.writeFile(e.resolutionBootstrapFile,t.bootstrapSource,{encoding:"utf8",flag:"wx",mode:384}),o.writeFile(e.vitestConfigFile,O(e,t),"utf8")])}function S(e){const t=a(d).href,n=a(m).href;return`
+const inputRuntime = await import(${JSON.stringify(t)});
+const consumerResolutionRuntime = await import(${JSON.stringify(n)});
+const { installNodeVitestRuntimeInput } = inputRuntime;
+await installNodeVitestRuntimeInput(${JSON.stringify(e)});
+const configRuntimeSymbol = Symbol.for(${JSON.stringify(u)});
+if (Object.hasOwn(globalThis, configRuntimeSymbol))
+  throw new Error("Managed Node/Vitest config runtime is already installed");
+const configRuntimeFunctions = [
+  consumerResolutionRuntime.assertNodeVitestConsumerResolution,
+  consumerResolutionRuntime.createConsumerTypeScriptPathsPlugin,
+  consumerResolutionRuntime.isNodeVitestManagedDependencyImporter,
+];
+for (const value of configRuntimeFunctions) {
+  if (typeof value !== "function")
+    throw new Error("Managed Node/Vitest config runtime is invalid");
+  Object.freeze(value);
+}
+const configRuntime = Object.freeze({
+  assertNodeVitestConsumerResolution: configRuntimeFunctions[0],
+  createConsumerTypeScriptPathsPlugin: configRuntimeFunctions[1],
+  isNodeVitestManagedDependencyImporter: configRuntimeFunctions[2],
+  managedTypeScriptFile: consumerResolutionRuntime.managedTypeScriptFile,
+  version: 1,
+});
+Object.defineProperty(
+  globalThis,
+  configRuntimeSymbol,
+  {
+    configurable: false,
+    enumerable: false,
+    value: configRuntime,
+    writable: false,
+  },
+);
+`}function I(e,t){const n=`
+const installedRuntimeInput = globalThis[
+  Symbol.for(${JSON.stringify(p)})
+];
+if (installedRuntimeInput === undefined)
+  throw new Error("Node/Vitest runtime input is not installed");
+const baseUrl = installedRuntimeInput.context?.baseUrl;
+if (typeof baseUrl === "string") process.env.BASE_URL = baseUrl;
+else delete process.env.BASE_URL;
+`,s=e===null?"const testkitRepositoryConfiguration = null;":`const testkitConfigModule = await import(${JSON.stringify(a(e).href)});
+const testkitRepositoryConfiguration =
+  testkitConfigModule.default ??
+  testkitConfigModule.config ??
+  testkitConfigModule;`;return`
+${n}
+const { registerRepoConfig } = await import("@gfdelarue/testkit/config");
+${s}
+registerRepoConfig(testkitRepositoryConfiguration);${t==="node-vitest-data"?`
+const { __testkitRegisterNodeVitestRepositoryConfiguration } =
+  await import("@gfdelarue/testkit/node-vitest/data");
+__testkitRegisterNodeVitestRepositoryConfiguration(
+  testkitRepositoryConfiguration,
+);`:""}
+`}function O(e,t){const n=`const installedRuntimeInput = globalThis[
+  Symbol.for(${JSON.stringify(p)})
+];
+if (installedRuntimeInput?.invocationId !== ${JSON.stringify(e.runtimeInput.expectedInvocationId)}
+  || installedRuntimeInput.profileId !== ${JSON.stringify(e.runtimeInput.expectedProfileId)}
+  || installedRuntimeInput.taskId !== ${JSON.stringify(e.runtimeInput.expectedTaskId)})
+  throw new Error("Managed Node/Vitest input bootstrap was not installed in the Vitest parent");`,s=`const configRuntime = globalThis[
+  Symbol.for(${JSON.stringify(u)})
+];
+const configRuntimeKeys = [
+  "assertNodeVitestConsumerResolution",
+  "createConsumerTypeScriptPathsPlugin",
+  "isNodeVitestManagedDependencyImporter",
+  "managedTypeScriptFile",
+  "version",
+];
+if (
+  typeof configRuntime !== "object" ||
+  configRuntime === null ||
+  !Object.isFrozen(configRuntime) ||
+  Reflect.ownKeys(configRuntime).length !== configRuntimeKeys.length ||
+  !configRuntimeKeys.every((key) => Object.hasOwn(configRuntime, key)) ||
+  configRuntime.version !== 1 ||
+  typeof configRuntime.managedTypeScriptFile !== "string" ||
+  !configRuntimeKeys.slice(0, 3).every(
+    (key) =>
+      typeof configRuntime[key] === "function" &&
+      Object.isFrozen(configRuntime[key]),
+  )
+)
+  throw new Error("Managed Node/Vitest config runtime is invalid");
+const {
+  assertNodeVitestConsumerResolution,
+  createConsumerTypeScriptPathsPlugin,
+  isNodeVitestManagedDependencyImporter,
+  managedTypeScriptFile,
+} = configRuntime;
+if (managedTypeScriptFile !== ${JSON.stringify(e.entrypoints.packages.typescript.entrypoint)})
+  throw new Error("Managed Node/Vitest TypeScript plugin resolved outside its selected installation");`,c=e.tsconfigFile===null?"":`createConsumerTypeScriptPathsPlugin(${JSON.stringify(e.tsconfigFile)}, consumerResolutionPolicy),`;return`
+${n}
+${s}
+const managedAliases = Object.freeze(${JSON.stringify(t.aliases)});
+const managedPackageNames = Object.freeze(${JSON.stringify(y.map(({packageName:r})=>r))});
+const managedDependencyRoots = Object.freeze(${JSON.stringify(t.dependencyRoots)});
+const consumerResolutionPolicy = Object.freeze({
+  aliases: managedAliases,
+  dependencyRoots: managedDependencyRoots,
+});
+
+function exactSpecifierPattern(specifier) {
+  return new RegExp("^" + specifier.replace(/[.*+?^\${}()|[\\]\\\\]/g, "\\\\$&") + "$");
+}
+
+export default {
+  plugins: [
+    {
+      enforce: "pre",
+      name: "testkit-node-vitest-managed-direct-packages",
+      async resolveId(specifier, importer, options) {
+        const managedImporter = isNodeVitestManagedDependencyImporter(
+          importer,
+          managedDependencyRoots,
+        );
+        if (specifier.startsWith("@vitest/") && !managedImporter)
+          throw new Error("Node/Vitest consumers may not import private Vitest package " + specifier.split("/", 2).join("/"));
+        const managedAlias = managedAliases[specifier];
+        if (managedAlias !== undefined) return assertNodeVitestConsumerResolution(
+          specifier, managedAlias, importer, consumerResolutionPolicy,
+        );
+        if (managedPackageNames.some(
+          (packageName) => specifier === packageName || specifier.startsWith(packageName + "/"),
+        ))
+          throw new Error("Managed Node/Vitest package does not support runtime subpath " + specifier);
+        const resolved = await this.resolve(specifier, importer, {
+          ...options,
+          skipSelf: true,
+        });
+        if (resolved === null) return null;
+        const id = assertNodeVitestConsumerResolution(
+          specifier,
+          resolved.id,
+          importer,
+          consumerResolutionPolicy,
+        );
+        return id === resolved.id ? resolved : { ...resolved, id };
+      },
+    },
+    ${c}
+  ],
+  root: ${JSON.stringify(e.rootDirectory)},
+  resolve: {
+    alias: Object.entries(managedAliases).map(([specifier, replacement]) => ({
+      find: exactSpecifierPattern(specifier),
+      replacement,
+    })),
+  },
+  test: {
+    ${e.runtimeInput.expectedProfileId==="node-vitest-data"?`runner: ${JSON.stringify(f)},
+    server: { deps: { external: ${JSON.stringify([f,e.entrypoints.data].map(r=>r.replaceAll(i.sep,"/")))}.map(exactSpecifierPattern) } },`:""}
+    reporters: [[${JSON.stringify(N("node-vitest"))}, ${JSON.stringify(e.report)}]],
+    allowOnly: false,
+    disableConsoleIntercept: true,
+    environment: "node",
+    fileParallelism: false,
+    hookTimeout: ${e.timeoutMs.toString()},
+    include: [${JSON.stringify(toVitestIncludePattern(e.sourceFile))}],
+    isolate: true,
+    maxWorkers: 1,
+    minWorkers: 1,
+    passWithNoTests: false,
+    pool: "forks",
+    setupFiles: [${JSON.stringify(e.setupFile)}],
+    teardownTimeout: ${e.timeoutMs.toString()},
+    testTimeout: ${e.timeoutMs.toString()},
+    update: "none",
+    watch: false,
+  },
+};
+`}const T=new Set(["!","(",")","*","+","?","@","[","\\","]","{","}"]);export function toVitestIncludePattern(e){return Array.from(e.replaceAll(i.sep,"/"),t=>T.has(t)?`\\${t}`:t).join("")}

package/dist/engines/node-vitest/runtime/contract/index.d.ts

@@ -0,0 +1,64 @@
+import { type HttpMethods } from "../../../../config/authoring/http-methods.js";
+import { expect } from "vitest";
+export { expect };
+type UnknownRecord = Record<string, unknown>;
+export interface ContractScenarioOptions {
+    timeout?: number;
+    timeoutMs?: number;
+}
+export interface ContractHttpRequestOptions extends UnknownRecord {
+    contentTypeJson?: boolean;
+    signal?: AbortSignal;
+}
+export interface ContractHttpResponse {
+    body: string;
+    headers: Record<string, string>;
+    json(): unknown;
+    method: string;
+    path: string;
+    status: number;
+    url: string;
+}
+export interface ContractHttpClientOptions {
+    baseUrl?: string;
+    defaultHeaders?: Record<string, string>;
+}
+export interface ContractHttpClient extends HttpMethods<Promise<ContractHttpResponse>, [
+    headers?: Record<string, string>,
+    options?: ContractHttpRequestOptions
+]> {
+    baseUrl: string;
+    request(method: string, path: string, body?: unknown, headers?: Record<string, string>, options?: ContractHttpRequestOptions): Promise<ContractHttpResponse>;
+}
+export interface ContractFixture {
+    buffer(): Buffer;
+    contentType: string;
+    filename: string;
+    json(): unknown;
+    path: string;
+    sha256: string;
+    sizeBytes: number;
+    text(encoding?: BufferEncoding): string;
+}
+export interface ContractRuntimeContext extends UnknownRecord {
+    baseUrl?: string | null;
+    engineId?: "node-vitest";
+    readonly env: Readonly<Record<string, string>>;
+    profileId?: "node-vitest-contract";
+    serviceName?: string;
+    task?: {
+        file?: string;
+        id?: number | string;
+        suiteName?: string;
+        testType: "contract";
+    };
+}
+export interface ContractScenarioContext extends ContractRuntimeContext {
+    fixture(name: string): ContractFixture;
+    http(options?: ContractHttpClientOptions): ContractHttpClient;
+}
+type ContractScenarioRun = (context: ContractScenarioContext) => unknown;
+export declare function contractScenario(name: string, run: ContractScenarioRun): void;
+export declare function contractScenario(name: string, options: ContractScenarioOptions, run: ContractScenarioRun): void;
+export declare function readContractContext(): ContractRuntimeContext;
+export declare function createHttpClient(options?: Readonly<ContractHttpClientOptions>): ContractHttpClient;

package/dist/engines/node-vitest/runtime/contract/index.js

@@ -0,0 +1 @@
+import{createHttpMethods as b}from"../../../../config/authoring/http-methods.js";import x from"node:fs";import{parseRuntimeFixtureManifestEntries as g,resolveRuntimeFixtureEntry as N}from"../../../contracts/fixture-manifest.js";import{readNodeVitestRuntimeInput as d}from"../runtime-input.js";import{expect as T,test as C}from"vitest";export{T as expect};const w=Object.freeze({}),E=Object.freeze({env:w});export function contractScenario(t,e,n){const{options:r,run:i}=A(e,n);C(t,async()=>{await i(O())},r.timeoutMs||r.timeout)}export function readContractContext(){const t=d();if(t===null)return E;if(t.profileId!=="node-vitest-contract")throw new Error("Node/Vitest contract API requires node-vitest-contract runtime input");const e={...t.context,env:t.environment,...Object.hasOwn(t,"setupData")?{setupData:t.setupData}:{}};if(!q(e))throw new Error("Node/Vitest contract runtime context is invalid");return Object.freeze(e)}export function createHttpClient(t={}){const e=(t.baseUrl||readContractContext().baseUrl||"").replace(/\/+$/u,"");if(!e)throw new Error("createHttpClient(...) requires baseUrl or the managed Node/Vitest contract context baseUrl");const n=t.defaultHeaders||{"Content-Type":"application/json"};async function r(i,c,y,h={},a={}){const u=i.toUpperCase()||"GET",f=j(y,{contentTypeJson:a.contentTypeJson!==!1}),o=await fetch(`${e}${l(c)}`,{method:u,headers:{...f.body==null?{}:n,...h},body:f.body,signal:a.signal}),p=await o.text();return{body:p,headers:R(o.headers),json(){return JSON.parse(p)},method:u,path:l(c),status:o.status,url:o.url}}return{baseUrl:e,...b(r,void 0),request:r}}function O(){const t=readContractContext();return Object.freeze({...t,fixture(e){return S(e)},http(e={}){return createHttpClient(e)}})}function S(t){const e=z(t),n=x.readFileSync(e.absolutePath);return{buffer(){return Buffer.from(n)},contentType:e.contentType,filename:e.filename,json(){return JSON.parse(n.toString("utf8"))},path:e.path,sha256:e.sha256,sizeBytes:e.sizeBytes,text(r="utf8"){return n.toString(r)}}}function z(t){const e=M(t,"fixture name"),n=U();return N(n.entries,e)}function U(){const t=d();return t===null?{entries:[]}:{entries:g(t.fixtures,"Node/Vitest contract fixture manifest")}}function j(t,e){if(t==null)return{body:void 0};if(typeof t=="string")return{body:t};if(t instanceof Uint8Array){const n=new Uint8Array(t.byteLength);return n.set(t),{body:n}}if(e.contentTypeJson)return{body:JSON.stringify(t)};throw new TypeError("Non-JSON contract request bodies must be strings or Uint8Array values")}function l(t){const e=t||"/";return e.startsWith("/")?e:`/${e}`}function R(t){const e={};for(const[n,r]of t.entries())e[n.toLowerCase()]=r;return e}function A(t,e){if(typeof t=="function")return{options:{},run:t};if(typeof e!="function")throw new Error("contractScenario(name, options?, run) requires a callback");return{options:t,run:e}}function M(t,e){const n=typeof t=="string"?t.trim():"";if(!n)throw new Error(`${e} is required`);return n}function q(t){return!s(t)||t.engineId!=="node-vitest"||t.profileId!=="node-vitest-contract"||!F(t.env)||"runner"in t||t.baseUrl!==void 0&&t.baseUrl!==null&&typeof t.baseUrl!="string"||t.serviceName!==void 0&&typeof t.serviceName!="string"?!1:I(t.task)}function I(t){return s(t)?!("type"in t)&&t.testType==="contract"&&m(t.file)&&J(t.id)&&m(t.suiteName):!1}function m(t){return t===void 0||typeof t=="string"}function J(t){return t===void 0||typeof t=="string"||typeof t=="number"}function s(t){return typeof t=="object"&&t!==null&&!Array.isArray(t)}function F(t){return s(t)&&Object.values(t).every(e=>typeof e=="string")}

package/dist/engines/node-vitest/runtime/data/http.d.ts

@@ -0,0 +1,4 @@
+import type { DataHttpClient, DataHttpClientOptions, DataHttpProfileOptions, DataRuntimeContext } from "./types.js";
+export declare function createHttpClient(options?: DataHttpClientOptions): DataHttpClient;
+export declare function readDataContext(): DataRuntimeContext;
+export declare function createDataHttpClient(options?: DataHttpProfileOptions): Promise<DataHttpClient>;

package/dist/engines/node-vitest/runtime/data/http.js

@@ -0,0 +1 @@
+import{stringFromUnknown as _}from"./primitives.js";import{createHttpMethods as b}from"../../../../config/authoring/http-methods.js";import{resolveHttpProfile as F}from"../../../../config/authoring/runtime.js";import{readNodeVitestRuntimeInput as G}from"../runtime-input.js";export function createHttpClient(e={}){const t=(e.baseUrl??readDataContext().baseUrl??"").replace(/\/+$/u,"");if(!t)throw new Error("createHttpClient(...) requires baseUrl or the managed Node/Vitest data context baseUrl");const n=e.recorder||e.trace||null,o=e.defaultHeaders||{"Content-Type":"application/json"},r=e.sessionBundle||null,i=e.defaultActor||r?.primaryActor||null,c=typeof e.getHeaders=="function"?e.getHeaders:null,s=typeof e.getRawHeaders=="function"?e.getRawHeaders:c;async function u(a,f,w,d,E,A={},g={}){O(r,a);const k=w.trim()===""?"GET":w.toUpperCase(),D=`${t}${x(d)}`,H=v(E,{contentTypeJson:g.contentTypeJson!==!1}),$={actor:a&&r?r.actors[a]??null:null,actorName:a,sessionBundle:r},S={...H.body==null?{}:o,...y(f?s:c,$),...A},L=Date.now(),h=await fetch(D,{method:k,headers:S,body:H.body,signal:g.signal}),T=await h.text(),P=Date.now()-L,M=j(h.headers),J={body:T,cookies:C(h.headers),durationMs:P,headers:M,json(){return JSON.parse(T)},method:k,path:x(d),status:h.status,url:D};return n&&n.recordHttpRequest({bodyBytes:ie(H.body),durationMs:P,method:k,path:x(d),requestHeaders:S,responseBytes:Buffer.byteLength(T),status:h.status}),J}const p=m(null,!0),R=b(p,void 0),N=Object.assign(p,{as:B,get:R.get,post:R.post}),U=m(i,!1);return{...b(U,void 0),baseUrl:t,headers(a={}){return{...y(c,{actorName:i,actor:V(r,i),sessionBundle:r}),...a}},rawHeaders(a={}){return{...y(s,{actorName:i,actor:V(r,i),sessionBundle:r}),...a}},raw:N,rawReq:N,request:U,as:I};function m(a,f){return(w,d,E,A,g)=>u(a,f,w,d,E,A,g)}function I(a){O(r,a);const f=m(a,!1),w=B(a);return{...b(f,void 0),headers(d={}){return{...y(c,{actorName:a,actor:r?r.actors[a]??null:null,sessionBundle:r}),...d}},rawHeaders(d={}){return{...y(s,{actorName:a,actor:r?r.actors[a]??null:null,sessionBundle:r}),...d}},raw:w,rawReq:w,request:f}}function B(a){const f=m(a,!0);return Object.assign(f,b(f,void 0))}}export function readDataContext(){const e=G();if(e===null)return ne;if(e.profileId!=="node-vitest-data")throw new Error("Node/Vitest data API requires node-vitest-data runtime input");return te({...e.context,env:e.environment,...Object.hasOwn(e,"setupData")?{setupData:e.setupData}:{}})}export async function createDataHttpClient(e={}){if(!e.profile)return createHttpClient(e);const t=F(e.profile);if(!t)throw new Error(`Data HTTP profile "${e.profile}" is unavailable because no repo config is registered`);const n=Y(t,e),o=X(n),r=await W(n.auth,o,e.profile),i=createHttpClient({...e,baseUrl:o.BASE,...r?.primaryActor?{defaultActor:r.primaryActor}:{},getHeaders(s){return{...n.auth?.headers?.(r,{actor:s.actorName,env:o})??{},...q(n.headers,r,o,s.actorName)}},getRawHeaders(s){return q(n.rawHeaders,r,o,s.actorName)},...r?{sessionBundle:r}:{}}),c=Q(r,i);return{...i,actor:c.actor,actors:c.actors,env:o}}function K(e){return e??null}function Y(e,t){return{...e,...t,auth:t.auth??K(e.auth),headers:t.headers??e.headers,rawHeaders:t.rawHeaders??e.rawHeaders,env:t.env??e.env}}async function W(e,t,n){const o={env:t,http:Z(),json:oe};let r=null;if(typeof e?.setupAsync=="function"?r=await e.setupAsync(o):typeof e?.setup=="function"&&(r=e.setup(o)),r==null)return null;if(!fe(r))throw new Error(`Data HTTP profile "${n??""}" auth setup must return a session bundle with actors and primaryActor`);return r}function q(e,t,n,o){return typeof e!="function"?{}:e(t,{actor:o,env:n})??{}}function X(e){const n={BASE:readDataContext().baseUrl||process.env.BASE_URL},o={...e.env||n,rawEnv:process.env};if(!o.BASE)throw new Error("Data HTTP profile requires BASE_URL or the managed Node/Vitest data context baseUrl");return{...o,BASE:o.BASE,rawEnv:process.env}}function Q(e,t){const n=Object.keys(e?.actors??{}),o=n.map(s=>{const u=e?.actors[s]??null,p=t.as(s);return{email:u?.email||null,headers:p.headers(),index:u?.actorIndex??0,key:s,name:u?.name||null,organizationKey:u?.organizationKey||null,organizationName:u?.organizationName||null,rawHeaders:p.rawHeaders(),rawReq:p.rawReq,req:p,session:u?.session||null}}),r=new Map(o.map(s=>[s.key,s])),i=e?.primaryActor||null,c=i&&r.get(i)||null;return{actor:c,actors:{names:n,primary:c,get(s){const u=r.get(s);if(!u)throw new Error(`Unknown testkit actor "${s}"`);return u},has(s){return r.has(s)},list(){return o.slice()}}}}function Z(){async function e(t,n,o,r={}){const i=se(r),c=await fetch(n,{method:t,headers:i,body:t==="GET"?void 0:ae(o)});return{body:await c.text(),cookies:C(c.headers),headers:j(c.headers),status:c.status}}return{del(t,n,o){return e("DELETE",t,n,o)},get(t,n){return e("GET",t,null,n)},patch(t,n,o){return e("PATCH",t,n,o)},post(t,n,o){return e("POST",t,n,o)},put(t,n,o){return e("PUT",t,n,o)}}}function y(e,t){return typeof e!="function"?{}:e(t)}function O(e,t){if(!(!t||!e)&&!Object.hasOwn(e.actors,t))throw new Error(`Unknown testkit actor "${t}"`)}function x(e){const t=e||"/";return t.startsWith("/")?t:`/${t}`}function v(e,t={}){return e==null?{body:void 0}:typeof e=="string"?{body:e}:e instanceof Uint8Array?{body:Uint8Array.from(e)}:e instanceof URLSearchParams||e instanceof FormData||e instanceof Blob?{body:e}:t.contentTypeJson===!1?{body:z(e)}:{body:JSON.stringify(e)}}function j(e){const t={};for(const[n,o]of e.entries())t[n]=o;return t}function C(e){const t=typeof e.getSetCookie=="function"?e.getSetCookie():ee(e.get("set-cookie")),n={};for(const o of t){const[r]=o.split(";"),i=r.indexOf("=");if(i<=0)continue;const c=r.slice(0,i).trim(),s=r.slice(i+1).trim();n[c]=[{value:s}]}return n}function ee(e){return e?e.split(/,(?=\s*[^;,]+=)/u).map(t=>t.trim()).filter(Boolean):[]}function te(e){if(!l(e))throw new Error("Node/Vitest data context must be an object");if(e.engineId!=="node-vitest")throw new Error('Node/Vitest data context.engineId must be "node-vitest"');if(e.profileId!=="node-vitest-data")throw new Error('Node/Vitest data context.profileId must be "node-vitest-data"');if(!de(e.env))throw new Error("Node/Vitest data context.env must be a string environment record");if("runner"in e)throw new Error("Node/Vitest data context.runner is not supported");const t={...e,env:e.env};if(e.baseUrl!==void 0&&e.baseUrl!==null&&typeof e.baseUrl!="string")throw new Error("Node/Vitest data context.baseUrl must be a string");if(e.serviceName!==void 0&&typeof e.serviceName!="string")throw new Error("Node/Vitest data context.serviceName must be a string");if(!l(e.task))throw new Error("Node/Vitest data context.task must be an object");{const n=e.task.id;if(n!==void 0&&typeof n!="string"&&typeof n!="number")throw new Error("Node/Vitest data context.task.id is invalid");for(const o of["file","suiteName"])if(e.task[o]!==void 0&&typeof e.task[o]!="string")throw new Error(`Node/Vitest data context.task.${o} must be a string`);if(e.task.testType!=="data")throw new Error('Node/Vitest data context.task.testType must be "data"');if("type"in e.task)throw new Error("Node/Vitest data context.task.type is not supported");t.task={...typeof e.task.file=="string"?{file:e.task.file}:{},...n===void 0?{}:{id:n},...typeof e.task.suiteName=="string"?{suiteName:e.task.suiteName}:{},testType:e.task.testType}}return t.engineId=e.engineId,t.profileId=e.profileId,Object.freeze(t)}const re=Object.freeze({}),ne=Object.freeze({env:re});function oe(e){if(!l(e)||typeof e.body!="string")throw new Error("Data HTTP profile response body must be a string");return JSON.parse(e.body)}function se(e){if(e==null)return{};if(!l(e))throw new Error("Data HTTP profile request options must be an object");return e.headers===void 0?{}:ce(e.headers,"Data HTTP profile request headers")}function ae(e){if(e!=null)return z(e)}function ie(e){return e===void 0?0:typeof e=="string"?Buffer.byteLength(e):e instanceof Blob?e.size:e instanceof URLSearchParams?Buffer.byteLength(e.toString()):e instanceof ArrayBuffer||ArrayBuffer.isView(e)?e.byteLength:0}function V(e,t){return t&&e?.actors?e.actors[t]??null:null}function z(e){return typeof e=="string"||e instanceof Blob||e instanceof FormData||e instanceof URLSearchParams||e instanceof ArrayBuffer?e:ArrayBuffer.isView(e)?Uint8Array.from(new Uint8Array(e.buffer,e.byteOffset,e.byteLength)):_(e)}function ce(e,t){if(!l(e))throw new Error(`${t} must be an object`);const n={};for(const[o,r]of Object.entries(e))n[o]=ue(r,`${t}.${o}`);return n}function ue(e,t){if(typeof e!="string"||e.length===0)throw new Error(`${t} must be a non-empty string`);return e}function fe(e){return l(e)&&l(e.actors)&&(e.primaryActor===null||typeof e.primaryActor=="string")}function de(e){return l(e)&&Object.values(e).every(t=>typeof t=="string")}function l(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)}

package/dist/engines/node-vitest/runtime/data/index.d.ts

@@ -0,0 +1,8 @@
+import { type RepoConfig } from "../../../../config/authoring/runtime.js";
+/** @internal Used only by the managed Node/Vitest setup module. */
+export declare function __testkitRegisterNodeVitestRepositoryConfiguration(configuration: RepoConfig | null | undefined): void;
+export { expect } from "vitest";
+export { createHttpClient, readDataContext } from "./http.js";
+export { renderDataFlowMarkdown } from "./report.js";
+export { createDataTrace, dataScenario, measureJsonBytes, stableHash } from "./scenario.js";
+export type { DataActorHttpClient, DataActorRawRequest, DataActorSession, DataBaselineBudgetOptions, DataBudgetOptions, DataEvidenceDetails, DataExternalCallDetails, DataFixture, DataFlowReport, DataHttpActor, DataHttpActors, DataHttpClient, DataHttpClientOptions, DataHttpHeaderBuilder, DataHttpHeaderContext, DataHttpProfileAuth, DataHttpProfileOptions, DataHttpRecorder, DataHttpRequestOptions, DataHttpRequestRecord, DataHttpResponse, DataMetricBudget, DataMetricOptions, DataRootRawRequest, DataRuntimeContext, DataScenarioContext, DataScenarioOptions, DataScenarioReport, DataSequenceBudget, DataSequenceOptions, DataSessionBundle, } from "./types.js";

package/dist/engines/node-vitest/runtime/data/index.js

@@ -0,0 +1 @@
+import{afterAll as e}from"vitest";import{registerRepoConfig as o}from"../../../../config/authoring/runtime.js";import{emitDataFlowArtifacts as r}from"./report.js";import{dataFlowState as a,finalizeDataFlowState as i}from"./scenario.js";e(()=>{i(),r(a())});export function __testkitRegisterNodeVitestRepositoryConfiguration(t){o(t)}export{expect}from"vitest";export{createHttpClient,readDataContext}from"./http.js";export{renderDataFlowMarkdown}from"./report.js";export{createDataTrace,dataScenario,measureJsonBytes,stableHash}from"./scenario.js";

package/dist/engines/node-vitest/runtime/data/primitives.d.ts

@@ -0,0 +1 @@
+export declare function stringFromUnknown(value: unknown): string;

package/dist/engines/node-vitest/runtime/data/primitives.js

@@ -0,0 +1 @@
+export function stringFromUnknown(t){if(t==null)return"";if(typeof t=="string"||typeof t=="number"||typeof t=="boolean"||typeof t=="bigint"||typeof t=="symbol")return String(t);throw new TypeError("Expected a primitive string-compatible value")}

package/dist/engines/node-vitest/runtime/data/report.d.ts

@@ -0,0 +1,3 @@
+import { type DataFlowReport, type DataFlowState } from "./types.js";
+export declare function emitDataFlowArtifacts(state: DataFlowState): void;
+export declare function renderDataFlowMarkdown(report: DataFlowReport): string;

package/dist/engines/node-vitest/runtime/data/report.js

@@ -0,0 +1,6 @@
+import{stringFromUnknown as h}from"./primitives.js";import i from"node:fs";import p from"node:path";import{NODE_VITEST_DATA_BUDGET_FAILURE_DETAIL_KIND as m,NODE_VITEST_DATA_FAILURE_DETAILS_ARTIFACT_KIND as g,NODE_VITEST_DATA_FAILURE_DETAILS_ARTIFACT_NAME as l}from"../runtime-input.js";import{DATA_ARTIFACT_KIND as d,DATA_REPORT_KIND as T,DATA_SCHEMA_VERSION as S}from"./types.js";export function emitDataFlowArtifacts(t){const n=process.env.TESTKIT_DATA_ARTIFACT_DIR;if(!n||t.emitted)return;t.emitted=!0,i.mkdirSync(n,{recursive:!0});const e=E(t),r=$(e),u=p.join(n,"data-flow.json"),o=p.join(n,"data-flow.md"),s=p.join(n,"failure-details.json"),c=p.join(n,"manifest.json");i.writeFileSync(u,`${JSON.stringify(e,null,2)}
+`),i.writeFileSync(o,`${renderDataFlowMarkdown(e)}
+`),r!==null&&i.writeFileSync(s,`${JSON.stringify(r,null,2)}
+`),i.writeFileSync(c,`${JSON.stringify({schemaVersion:1,artifacts:[{contentType:"application/json",kind:d,name:"data-flow",path:u,summary:e.summaryText},{contentType:"text/markdown",kind:T,name:"data-flow-report",path:o,summary:e.summaryText},...r===null?[]:[{contentType:"application/json",kind:g,name:l,path:s,summary:`${String(r.failures.length)} failed data-flow budget${r.failures.length===1?"":"s"}`}]]},null,2)}
+`)}function $(t){const n=t.scenarios.flatMap(e=>e.budgetFailures.map(r=>{const u=`${r.target} budget "${r.name}" (${r.operator})`;return{actual:f(r.actual,`${e.name} ${r.name} actual value`),checkName:r.name,count:1,expected:f(r.expected,`${e.name} ${r.name} expected value`),groupPath:[e.name],key:`${e.name} > ${u}`,kind:m,message:r.message,title:u}}));return n.length===0?null:{failures:n,phase:"exec"}}function f(t,n){let e;try{e=JSON.stringify(t)}catch(u){throw new TypeError(`${n} must be JSON-serializable`,{cause:u})}const r=JSON.parse(e);if(!y(r))throw new TypeError(`${n} must be a finite JSON value`);return r}function y(t){const n=[t];for(;n.length>0;){const e=n.pop();if(!(e===null||typeof e=="boolean"||typeof e=="string")){if(typeof e=="number"){if(!Number.isFinite(e))return!1;continue}if(D(e)){n.push(...e);continue}if(!A(e))return!1;n.push(...Object.values(e))}}return!0}function A(t){return typeof t=="object"&&t!==null&&!Array.isArray(t)}function D(t){return Array.isArray(t)}function E(t){const n=t.scenarios.map(s=>({budgetFailures:s.budgetFailures,budgets:s.budgetResults,description:s.description,durationMs:Math.max(0,(s.finishedAtMs||Date.now())-s.startedAtMs),error:s.error,evidence:s.evidence,events:s.events,findings:s.findings,metrics:s.metrics,name:s.name,sequences:s.sequences,status:s.status==="running"?"failed":s.status})),e=n.filter(s=>s.status==="failed").length,r=n.reduce((s,c)=>s+c.budgetFailures.length,0),u=k(n.flatMap(s=>s.findings)),o=`${String(n.length-e)}/${String(n.length)} data scenario(s) passed, ${String(r)} budget failure(s)`;return{schemaVersion:S,kind:d,generatedAt:new Date().toISOString(),file:process.env.TESTKIT_TEST_FILE||null,taskId:process.env.TESTKIT_TEST_ID||null,summary:{budgetFailures:r,failed:e,findingCounts:u,passed:n.length-e,scenarios:n.length,status:e>0?"failed":"passed"},summaryText:o,scenarios:n}}export function renderDataFlowMarkdown(t){const n=[];n.push("# Data Flow Report"),n.push(""),n.push(`Status: ${t.summary.status}`),n.push(`Scenarios: ${String(t.summary.passed)}/${String(t.summary.scenarios)} passed`),n.push(`Budget failures: ${String(t.summary.budgetFailures)}`),n.push("");for(const e of t.scenarios)n.push(`## ${e.name}`),n.push(""),n.push(`Status: ${e.status}`),n.push(`Duration: ${String(e.durationMs)}ms`),e.description&&n.push(`Description: ${e.description}`),e.error?.message&&n.push(`Error: ${e.error.message}`),n.push(""),_(n,e.metrics),w(n,e.sequences),b(n,e.evidence),F(n,e.budgets),I(n,e.findings);return n.join(`
+`).trimEnd()}function b(t,n){if(t.push("### Evidence"),n.length===0){t.push(""),t.push("No structured data-flow evidence recorded."),t.push("");return}t.push(""),t.push("| Kind | Name | Status | Details |"),t.push("| --- | --- | --- | --- |");for(const e of n)t.push(`| ${a(e.kind)} | ${a(e.name)} | ${a(e.status||"")} | ${a(N(e.details))} |`);t.push("")}function _(t,n){if(t.push("### Metrics"),n.length===0){t.push(""),t.push("No metrics recorded."),t.push("");return}t.push(""),t.push("| Metric | Value | Unit | Kind |"),t.push("| --- | ---: | --- | --- |");for(const e of n)t.push(`| ${a(e.name)} | ${O(e.value)} | ${a(e.unit||"")} | ${a(e.kind||"")} |`);t.push("")}function w(t,n){if(t.push("### Sequences"),n.length===0){t.push(""),t.push("No sequences recorded."),t.push("");return}t.push(""),t.push("| Sequence | Values |"),t.push("| --- | --- |");for(const e of n)t.push(`| ${a(e.name)} | ${a(e.values.join(" -> "))} |`);t.push("")}function F(t,n){if(t.push("### Budgets"),n.length===0){t.push(""),t.push("No budgets declared."),t.push("");return}t.push("");for(const e of n)t.push(`- ${e.status.toUpperCase()} ${e.name}: ${e.message}`);t.push("")}function I(t,n){if(t.push("### Findings"),n.length===0){t.push(""),t.push("No findings recorded."),t.push("");return}t.push("");for(const e of n)t.push(`- ${e.severity.toUpperCase()}: ${e.message}`);t.push("")}function N(t){const n=Object.entries(t||{}).filter(([e])=>e!=="status").slice(0,6);return n.length===0?"":n.map(([e,r])=>`${e}: ${j(r)}`).join(", ")}function j(t){return t==null?"":typeof t=="string"||typeof t=="number"||typeof t=="boolean"?String(t):JSON.stringify(t)}function k(t){const n={info:0,watch:0,waste:0,error:0};for(const e of t)n[e.severity]+=1;return n}function a(t){return h(t??"").replaceAll("|","\\|").replace(/\s+/gu," ").trim()}function O(t){return Number.isInteger(t)?String(t):String(Number(t.toFixed(4)))}

package/dist/engines/node-vitest/runtime/data/runner.d.ts

@@ -0,0 +1,4 @@
+import { TestRunner, type RunnerTestFile } from "vitest";
+export default class DataTestRunner extends TestRunner {
+    onCollected(files: RunnerTestFile[]): void;
+}

package/dist/engines/node-vitest/runtime/data/runner.js

@@ -0,0 +1 @@
+import{TestRunner as a}from"vitest";import{isDataScenarioCase as o}from"./scenario.js";export default class s extends a{onCollected(t){for(const r of t)for(const e of r.tasks)if(!o(e))throw new Error(`Data suites must register every case with dataScenario: ${e.name}`)}}

package/dist/engines/node-vitest/runtime/data/scenario.d.ts

@@ -0,0 +1,12 @@
+import type { DataFlowState, DataScenarioContext, DataScenarioOptions } from "./types.js";
+declare global {
+    var __TESTKIT_DATA_FLOW_STATE__: DataFlowState | undefined;
+}
+export declare function isDataScenarioCase(task: object): boolean;
+export declare function dataScenario(name: string, run: (context: DataScenarioContext) => unknown): void;
+export declare function dataScenario(name: string, options: DataScenarioOptions, run: (context: DataScenarioContext) => unknown): void;
+export declare function createDataTrace(name?: string): DataScenarioContext;
+export declare function measureJsonBytes(value: unknown): number;
+export declare function stableHash(value: unknown): string;
+export declare function dataFlowState(): DataFlowState;
+export declare function finalizeDataFlowState(): DataFlowState;