@gfdelarue/testkit 0.3.1 → 0.3.3

package/dist/database/template-steps.js

@@ -1,4 +1,4 @@
-import a from"fs";import h from"path";import{buildTemplateExecutionEnv as m,collectConfiguredInputs as P}from"../steps/index.js";import{runConfiguredSteps as w}from"./configured-steps.js";import"../evidence/setup-progress.js";import{makeTempDir as T,removeTempDir as A}from"../process/files/temp-dir.js";import{captureOutput as E}from"../process/index.js";import{assertPgDumpArgsAreSourceSafe as D}from"./source-url.js";import{runDockerPsql as v,startDockerPgDump as x}from"./postgres/index.js";const p=String,y=["migrate","seed","verify"];export function runTemplateStage(e,r,t,n={}){const o=e.testkit.database?.template?.[r]||[];return l(e,r,o,0,t,n)}export function runTemplateStep(e,r,t,n,o,i={}){return l(e,r,[t],n,o,i)}async function l(e,r,t,n,o,i){await w({...i,config:e,steps:t,env:{...m(e,{},process.env),DATABASE_URL:o},labelPrefix:`template:${r}`,startIndex:n})}export function collectTemplateInputs(e,r={}){const t=y.flatMap(n=>r[n]||[]);return P(e,{inputs:r.inputs||[],steps:t})}export async function captureTemplateSnapshotText(e,r,t={}){const n=T("testkit-schema-snapshot-"),o=h.join(n,"schema.sql");try{const i=t.image||await resolvePgDumpClientImage(e,r,t);return await dumpPostgresSchemaToFile(e,o,r,{...t,image:i}),a.readFileSync(o,"utf8")}finally{A(n)}}export async function dumpPostgresSchemaToFile(e,r,t,n={}){const o={...m(e,{},n.env||process.env),...f(t,{applicationName:n.pgApplicationName})},i=pgDumpArgs();D(i);const s=await b(e,i,o,n);if(s.exitCode!==0)throw new Error(s.shortMessage||s.stderr||s.stdout||"pg_dump failed");a.writeFileSync(r,s.stdout),sanitizeSnapshotFile(r)}export function pgDumpArgs(){return["--schema-only","--no-owner","--no-privileges"]}function d(e){return{host:e.PGHOST,port:e.PGPORT||5432,database:e.PGDATABASE,user:e.PGUSER,password:e.PGPASSWORD,sslMode:e.PGSSLMODE}}async function b(e,r,t,n={}){const o=x({args:r,cwd:e.productDir,env:t,image:n.image||null,ownedContainer:n.ownedContainer||null,signal:n.signal,connection:d(t)}),i=n.reporter,s=i?.outputMode==="debug"?c=>i.writeDebugLine?.(c):null,u=n.logRecord||null,g=[E(o.stderr,{livePrefix:`[${e.runtimeLabel||e.name}:${e.name}]`,liveWriter:s,onLine(c){u&&u.write(`${new Date().toISOString()} [stderr] ${c}
-`)}})],S=await o;return await Promise.all(g),S}export async function resolvePgDumpClientImage(e,r,t={}){const n=t.env||process.env,o=C(n);if(o)return o;const i={...n,...f(r,{applicationName:t.pgApplicationName})},s=await v({args:["-tAc","SHOW server_version_num"],cwd:e.productDir,env:i,ownedContainer:t.ownedContainer||null,signal:t.signal,connection:d(i)});if(s.exitCode!==0)throw new Error(s.shortMessage||s.stderr||s.stdout||"Failed to detect source Postgres version");return postgresClientImageForServerVersion(s.stdout)}export function postgresClientImageForServerVersion(e){const r=Number(p(_(e,"")).trim());if(!Number.isFinite(r)||r<1e5)throw new Error(`Unable to determine Postgres major version from server_version_num: ${JSON.stringify(e)}`);return`postgres:${String(Math.floor(r/1e4))}`}function C(e){return e.TESTKIT_POSTGRES_CLIENT_IMAGE||null}function f(e,r={}){const t=new URL(e);return G({PGHOST:t.hostname,PGPORT:t.port||"5432",PGDATABASE:decodeURIComponent(t.pathname.replace(/^\//,"")),PGUSER:decodeURIComponent(t.username||""),PGPASSWORD:decodeURIComponent(t.password||""),PGSSLMODE:t.searchParams.get("sslmode")||void 0,PGAPPNAME:r.applicationName||void 0})}function G(e){const r={};for(const[t,n]of Object.entries(e))n!=null&&n!==""&&(r[t]=n);return r}export function sanitizeSnapshotFile(e){const r=a.readFileSync(e,"utf8"),t=sanitizeSnapshotText(r);t!==r&&a.writeFileSync(e,t)}export function sanitizeSnapshotText(e){return O(p(e).split(`
-`)).filter(r=>{const t=r.trim();return!t.startsWith("-- Dumped from database version ")&&!t.startsWith("-- Dumped by pg_dump version ")&&t!=="SET transaction_timeout = 0;"&&!t.startsWith("\\restrict ")&&!t.startsWith("\\unrestrict ")}).join(`
-`)}function O(e){const r=[];for(let t=0;t<e.length;t+=1){if(e[t]?.trim()==="--"&&e[t+1]?.startsWith("-- Name: public; Type: SCHEMA;")){let n=t+1;for(;n<e.length&&!e[n]?.includes("*not* creating schema");)n+=1;if(n<e.length){for(;n+1<e.length&&e[n+1]?.trim()==="";)n+=1;t=n;continue}}r.push(e[t])}return r}function _(e,r){return!!e?e:r}
+import c from"fs";import{buildTemplateExecutionEnv as m,collectConfiguredInputs as h}from"../steps/index.js";import{runConfiguredSteps as A}from"./configured-steps.js";import"../evidence/setup-progress.js";import{captureOutput as E}from"../process/index.js";import{assertPgDumpArgsAreSourceSafe as T}from"./source-url.js";import{runDockerPsql as v,startDockerPgDump as D}from"./postgres/index.js";const p=String,x=["migrate","seed","verify"];export function runTemplateStage(e,n,t,r={}){const o=e.testkit.database?.template?.[n]||[];return l(e,n,o,0,t,r)}export function runTemplateStep(e,n,t,r,o,i={}){return l(e,n,[t],r,o,i)}async function l(e,n,t,r,o,i){await A({...i,config:e,steps:t,env:{...m(e,{},process.env),DATABASE_URL:o},labelPrefix:`template:${n}`,startIndex:r})}export function collectTemplateInputs(e,n={}){const t=x.flatMap(r=>n[r]||[]);return h(e,{inputs:n.inputs||[],steps:t})}export async function captureTemplateSnapshotText(e,n,t={}){const r=t.image||await resolvePgDumpClientImage(e,n,t);return sanitizeSnapshotText(await d(e,n,{...t,image:r}))}export async function dumpPostgresSchemaToFile(e,n,t,r={}){const o=await d(e,t,r);c.writeFileSync(n,o),sanitizeSnapshotFile(n)}async function d(e,n,t){const r={...m(e,{},t.env||process.env),...S(n,{applicationName:t.pgApplicationName})},o=pgDumpArgs();T(o);const i=await C(e,o,r,t);if(i.exitCode!==0)throw new Error(i.shortMessage||i.stderr||i.stdout||"pg_dump failed");return i.stdout}export function pgDumpArgs(){return["--schema-only","--no-owner","--no-privileges"]}function f(e){return{host:e.PGHOST,port:e.PGPORT||5432,database:e.PGDATABASE,user:e.PGUSER,password:e.PGPASSWORD,sslMode:e.PGSSLMODE}}async function C(e,n,t,r={}){const o=D({args:n,cwd:e.productDir,env:t,image:r.image||null,ownedContainer:r.ownedContainer||null,signal:r.signal,connection:f(t)}),i=r.reporter,s=i?.outputMode==="debug"?a=>i.writeDebugLine?.(a):null,u=r.logRecord||null,w=[E(o.stderr,{livePrefix:`[${e.runtimeLabel||e.name}:${e.name}]`,liveWriter:s,onLine(a){u&&u.write(`${new Date().toISOString()} [stderr] ${a}
+`)}})],P=await o;return await Promise.all(w),P}export async function resolvePgDumpClientImage(e,n,t={}){const r=t.env||process.env,o=g(r);if(o)return o;const i={...r,...S(n,{applicationName:t.pgApplicationName})},s=await v({args:["-tAc","SHOW server_version_num"],cwd:e.productDir,env:i,ownedContainer:t.ownedContainer||null,signal:t.signal,connection:f(i)});if(s.exitCode!==0)throw new Error(s.shortMessage||s.stderr||s.stdout||"Failed to detect source Postgres version");return postgresClientImageForServerVersion(s.stdout)}export function createOwnedPgDumpClientImageResolver(e,n,t){const r={...t,ownedContainer:{...t.ownedContainer}};let o;return async()=>{const i=g(r.env||process.env);return i||(o??=await resolvePgDumpClientImage(e,n,r),o)}}export function postgresClientImageForServerVersion(e){const n=Number(p(O(e,"")).trim());if(!Number.isFinite(n)||n<1e5)throw new Error(`Unable to determine Postgres major version from server_version_num: ${JSON.stringify(e)}`);return`postgres:${String(Math.floor(n/1e4))}`}function g(e){return e.TESTKIT_POSTGRES_CLIENT_IMAGE||null}function S(e,n={}){const t=new URL(e);return y({PGHOST:t.hostname,PGPORT:t.port||"5432",PGDATABASE:decodeURIComponent(t.pathname.replace(/^\//,"")),PGUSER:decodeURIComponent(t.username||""),PGPASSWORD:decodeURIComponent(t.password||""),PGSSLMODE:t.searchParams.get("sslmode")||void 0,PGAPPNAME:n.applicationName||void 0})}function y(e){const n={};for(const[t,r]of Object.entries(e))r!=null&&r!==""&&(n[t]=r);return n}export function sanitizeSnapshotFile(e){const n=c.readFileSync(e,"utf8"),t=sanitizeSnapshotText(n);t!==n&&c.writeFileSync(e,t)}export function sanitizeSnapshotText(e){return b(p(e).split(`
+`)).filter(n=>{const t=n.trim();return!t.startsWith("-- Dumped from database version ")&&!t.startsWith("-- Dumped by pg_dump version ")&&t!=="SET transaction_timeout = 0;"&&!t.startsWith("\\restrict ")&&!t.startsWith("\\unrestrict ")}).join(`
+`)}function b(e){const n=[];for(let t=0;t<e.length;t+=1){if(e[t]?.trim()==="--"&&e[t+1]?.startsWith("-- Name: public; Type: SCHEMA;")){let r=t+1;for(;r<e.length&&!e[r]?.includes("*not* creating schema");)r+=1;if(r<e.length){for(;r+1<e.length&&e[r+1]?.trim()==="";)r+=1;t=r;continue}}n.push(e[t])}return n}function O(e,n){return!!e?e:n}

package/dist/engines/managed-module-resolution.js

@@ -1,4 +1,4 @@
-import{inspectManagedNodeModuleResolutionPolicy as o}from"./managed-module-resolution-policy.js";export function createManagedNodeModuleResolution(e){const t=o(e),r={...t.direct};for(const[a,i]of Object.entries(t.packageExports)){const n=i.import??i.default??i.require;n!==null&&(r[a]=n)}return Object.freeze({aliases:Object.freeze(r),bootstrapSource:s(t),dependencyRoots:t.managedImporterRoots})}export function managedNodeModuleResolutionBootstrapSource(e){return createManagedNodeModuleResolution(e).bootstrapSource}function s(e){return`
+import{inspectManagedNodeModuleResolutionPolicy as o}from"./managed-module-resolution-policy.js";export function createManagedNodeModuleResolution(e){const t=o(e),n={...t.direct};for(const[a,i]of Object.entries(t.packageExports)){const r=i.import??i.default??i.require;r!==null&&(n[a]=r)}return Object.freeze({aliases:Object.freeze(n),bootstrapSource:s(t),dependencyRoots:t.managedImporterRoots})}export function managedNodeModuleResolutionBootstrapSource(e){return createManagedNodeModuleResolution(e).bootstrapSource}function s(e){return`
 const fs = require("node:fs");
 const path = require("node:path");
 const { registerHooks } = require("node:module");
@@ -316,8 +316,9 @@ function classifyResolvedSpecifier(specifier, parentURL) {
 }
 
 function exactDirectSpecifier(file) {
+  const canonicalFile = canonicalPath(file);
   for (const [specifier, target] of DIRECT) {
-    if (sameFile(file, target)) return specifier;
+    if (canonicalFile === canonicalPath(target)) return specifier;
   }
   return null;
 }
@@ -579,6 +580,7 @@ function isManagedDependencyFile(file) {
 function exactExportedSubpathForFile(exportsDeclaration, packageRoot, file) {
   if (exportsDeclaration === null || typeof exportsDeclaration !== "object")
     return null;
+  const canonicalFile = canonicalPath(file);
   for (const [subpath, declaration] of Object.entries(exportsDeclaration)) {
     if (
       (subpath !== "." && !subpath.startsWith("./")) ||
@@ -590,7 +592,7 @@ function exactExportedSubpathForFile(exportsDeclaration, packageRoot, file) {
       if (
         target.startsWith("./") &&
         !target.includes("*") &&
-        sameFile(path.resolve(packageRoot, target), file)
+        canonicalPath(path.resolve(packageRoot, target)) === canonicalFile
       ) {
         return subpath;
       }

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

@@ -1,3 +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:()=>`
+import{isPathWithin as y}from"../../../process/files/paths.js";import u from"node:fs";import{createRequire as h}from"node:module";import i from"node:path";import{fileURLToPath as l}from"node:url";import{NODE_VITEST_PACKAGE_REQUIREMENTS as N}from"../../installations/node-vitest.js";export const managedTypeScriptFile=l(import.meta.resolve("typescript"));const k=/^@gfdelarue\/testkit(?:\/|$)/u;export function createConsumerTypeScriptPathsPlugin(t,e){const r=h(import.meta.url)(managedTypeScriptFile),n=S(t,r),o=Object.keys(n.paths??{});return o.length===0?null:{enforce:"pre",name:"testkit-node-vitest-consumer-typescript-paths",resolveId(a,s){if(s===void 0||isNodeVitestManagedDependencyImporter(s,e.dependencyRoots)||k.test(a)||!o.some(g=>w(a,g)))return null;const c=x(s);if(c===null)return null;const f=r.resolveModuleName(a,c,n,r.sys).resolvedModule?.resolvedFileName;return f===void 0?null:assertNodeVitestConsumerResolution(a,f,s,e)}}}export function assertNodeVitestConsumerResolution(t,e,r,n){if(isNodeVitestManagedDependencyImporter(r,n.dependencyRoots))return e;const o=d(e);if(o===null)return e;const a=v(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)&&m(o,s)||Object.values(n.aliases).some(c=>m(o,c)))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 v(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=E(o);if(s!==null){if(s.startsWith("@vitest/"))return{packageName:s,privatePackage:!0};if(N.some(({packageName:c})=>c===s))return{packageName:s,privatePackage:!1}}}const a=i.dirname(n);if(a===n)break;n=a}}return null}function E(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=d(t);return r===null?!1:e.some(n=>y(n,r))}function d(t){const e=t.split(/[?#]/u,1)[0];if(e.startsWith("\0"))return null;if(e.startsWith("file:"))return l(e);const r=e.startsWith("/@fs/")?e.slice(4):e;return i.isAbsolute(r)?i.resolve(r):null}function m(t,e){try{return u.realpathSync(t)===u.realpathSync(e)}catch{return i.resolve(t)===i.resolve(e)}}function S(t,e){const r=i.resolve(t).replaceAll(i.sep,"/"),n=i.posix.dirname(r),o=e.readConfigFile(r,c=>e.sys.readFile(c));if(o.error!==void 0)throw new Error(p(r,[o.error],e));const a=e.parseJsonConfigFileContent(o.config,e.sys,n,{},r),s=a.errors.filter(c=>c.category===e.DiagnosticCategory.Error&&c.code!==18003);if(s.length>0)throw new Error(p(r,s,e));return a.options}function p(t,e,r){const n=r.formatDiagnostics(e,{getCanonicalFileName:o=>o,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}
+${n}`.trim()}function w(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 x(t){const e=t.split(/[?#]/u,1)[0];return e.startsWith("file:")?l(e):i.isAbsolute(e)?e:null}

package/dist/engines/node-vitest/runtime/runtime-input.js

@@ -1 +1 @@
-import m from"node:fs/promises";import w from"node:path";import{readVerifiedOwnedFile as f,writeOwnedRuntimeInput as S,RUNTIME_INPUT_BYTE_MEASURE as O}from"../../runtime-input-file.js";import{requireBoundedJsonValue as h,RUNTIME_INPUT_JSON_BOUNDS as V}from"../../contracts/json-bounds.js";import{ENGINE_PROCESS_RESERVED_ENVIRONMENT_KEYS as l,installManagedProcessEnvironmentOverlay as R}from"../../../process/index.js";export const NODE_VITEST_RUNTIME_INPUT_VERSION=1,NODE_VITEST_RUNTIME_INPUT_FILENAME="runtime-input.json",NODE_VITEST_RUNTIME_INPUT_FILE_ENV="TESTKIT_NODE_VITEST_INPUT_FILE",NODE_VITEST_RUNTIME_INPUT_SHA256_ENV="TESTKIT_NODE_VITEST_INPUT_SHA256",NODE_VITEST_RUNTIME_INPUT_SYMBOL="elench.testkit.node-vitest.runtime-input.v1",NODE_VITEST_DATA_BUDGET_FAILURE_DETAIL_KIND="data-flow-budget",NODE_VITEST_DATA_FAILURE_DETAILS_ARTIFACT_KIND="testkit.failure-details",NODE_VITEST_DATA_FAILURE_DETAILS_ARTIFACT_NAME="data-flow-failure-details";const E={filename:NODE_VITEST_RUNTIME_INPUT_FILENAME,label:"Node/Vitest runtime input",maxSizeBytes:8*1024*1024},N=512,I=4*1024*1024,x=new Set(["BASE_URL","FORCE_COLOR","NODE_OPTIONS","NO_COLOR","UPDATE_SNAPSHOT",...l].map(t=>t.toUpperCase()));export const MAX_NODE_VITEST_SPAWN_ENVIRONMENT_UNITS=24*1024;export async function writeOwnedNodeVitestRuntimeInput(t,e){return S(t,e,E)}export async function verifyOwnedNodeVitestRuntimeInput(t){await f(t,E)}export function selectNodeVitestForwardedEnvironment(t){const e={...t};return _(e),e}export function assertNodeVitestSpawnEnvironmentBudget(t){if(Object.entries(t).reduce((n,[o,r])=>n+o.length+r.length+2,1)>MAX_NODE_VITEST_SPAWN_ENVIRONMENT_UNITS)throw new Error(`Node/Vitest process environment exceeds the ${MAX_NODE_VITEST_SPAWN_ENVIRONMENT_UNITS.toString()} character environment-block budget`)}export async function installNodeVitestRuntimeInput(t){const e=process.env[NODE_VITEST_RUNTIME_INPUT_FILE_ENV],n=process.env[NODE_VITEST_RUNTIME_INPUT_SHA256_ENV];if(e!==t.expectedFile)throw new Error("Node/Vitest runtime input pointer does not match its engine-owned path");if(n!==t.expectedSha256)throw new Error("Node/Vitest runtime input digest does not match its prepared value");const o=await m.lstat(t.expectedFile),r={directory:w.dirname(t.expectedFile),file:t.expectedFile,sha256:t.expectedSha256,sizeBytes:o.size},c=await f(r,E);let i;try{i=JSON.parse(c)}catch(u){throw new Error("Node/Vitest runtime input contains invalid JSON",{cause:u})}const s=a(p(i));if(s.invocationId!==t.expectedInvocationId||s.profileId!==t.expectedProfileId||s.taskId!==t.expectedTaskId)throw new Error("Node/Vitest runtime input identity does not match its task");R({environment:s.environment,label:"Node/Vitest"}),Object.defineProperty(globalThis,Symbol.for(NODE_VITEST_RUNTIME_INPUT_SYMBOL),{configurable:!0,enumerable:!1,value:s,writable:!1}),applyNodeVitestEngineEnvironment()}export function applyNodeVitestEngineEnvironment(){const t=readNodeVitestRuntimeInput();if(t===null)throw new Error("Node/Vitest runtime input is not installed");const e=t.context.baseUrl;typeof e=="string"?process.env.BASE_URL=e:Reflect.deleteProperty(process.env,"BASE_URL")}export function readNodeVitestRuntimeInput(){const t=Reflect.get(globalThis,Symbol.for(NODE_VITEST_RUNTIME_INPUT_SYMBOL));return t===void 0?null:a(p(t,"Installed Node/Vitest runtime input"))}function p(t,e="Node/Vitest runtime input"){if(h(t,e,V,O),!d(t))throw new Error(`${e} must contain an object`);const n=new Set(["context","engineId","environment","fixtures","invocationId","profileId","setupData","taskId","version"]);for(const r of Object.keys(t))if(!n.has(r))throw new Error(`${e} contains unknown field ${r}`);if(t.version!==NODE_VITEST_RUNTIME_INPUT_VERSION)throw new Error(`${e}.version must be 1`);if(t.engineId!=="node-vitest")throw new Error(`${e}.engineId must be "node-vitest"`);if(!A(t.profileId))throw new Error(`${e}.profileId is invalid`);if(!d(t.context)||!d(t.fixtures))throw new Error(`${e} context and fixtures must be objects`);const o=y(t.environment,`${e}.environment`);return _(o),{context:t.context,engineId:"node-vitest",environment:o,fixtures:t.fixtures,invocationId:T(t.invocationId,`${e}.invocationId`),profileId:t.profileId,...Object.hasOwn(t,"setupData")?{setupData:t.setupData}:{},taskId:T(t.taskId,`${e}.taskId`),version:NODE_VITEST_RUNTIME_INPUT_VERSION}}function _(t){const e=Object.entries(t);if(e.length>N)throw new Error(`Node/Vitest forwarded environment exceeds the ${N.toString()} entry limit`);let n=0;const o=new Set;for(const[r,c]of e){D(r,c,"Node/Vitest forwarded environment");const i=r.toUpperCase();if(o.has(i))throw new Error(`Node/Vitest forwarded environment contains case-insensitive duplicate key ${r}`);if(o.add(i),i.startsWith("TESTKIT_")||i.startsWith("VITEST_")||x.has(i))throw new Error(`Node/Vitest forwarded environment contains reserved key ${r}`);n+=Buffer.byteLength(r)+Buffer.byteLength(c)+2}if(n>I)throw new Error(`Node/Vitest forwarded environment exceeds the ${I.toString()} byte limit`)}function y(t,e){if(!d(t))throw new Error(`${e} must be an object`);const n=Object.entries(t);if(!n.every(o=>typeof o[1]=="string"))throw new Error(`${e} values must all be strings`);return Object.fromEntries(n)}function D(t,e,n){if(t.length===0||t.includes("=")||t.includes("\0"))throw new Error(`${n} contains an invalid variable name`);if(e.includes("\0"))throw new Error(`${n}.${t} contains a NUL character`)}function a(t){if(t!==null&&typeof t=="object"&&!Object.isFrozen(t)){Object.freeze(t);for(const e of Object.values(t))a(e)}return t}function T(t,e){if(typeof t!="string"||t.length===0)throw new Error(`${e} must be a non-empty string`);return t}function A(t){return t==="node-vitest-contract"||t==="node-vitest-data"}function d(t){return typeof t=="object"&&t!==null&&!Array.isArray(t)}
+import m from"node:fs/promises";import w from"node:path";import{readVerifiedOwnedFile as f,writeOwnedRuntimeInput as S,RUNTIME_INPUT_BYTE_MEASURE as O}from"../../runtime-input-file.js";import{requireBoundedJsonValue as h,RUNTIME_INPUT_JSON_BOUNDS as V}from"../../contracts/json-bounds.js";import{ENGINE_PROCESS_RESERVED_ENVIRONMENT_KEYS as l}from"../../../process/environment.js";import{installManagedProcessEnvironmentOverlay as R}from"../../../process/environment-overlay.js";export const NODE_VITEST_RUNTIME_INPUT_VERSION=1,NODE_VITEST_RUNTIME_INPUT_FILENAME="runtime-input.json",NODE_VITEST_RUNTIME_INPUT_FILE_ENV="TESTKIT_NODE_VITEST_INPUT_FILE",NODE_VITEST_RUNTIME_INPUT_SHA256_ENV="TESTKIT_NODE_VITEST_INPUT_SHA256",NODE_VITEST_RUNTIME_INPUT_SYMBOL="elench.testkit.node-vitest.runtime-input.v1",NODE_VITEST_DATA_BUDGET_FAILURE_DETAIL_KIND="data-flow-budget",NODE_VITEST_DATA_FAILURE_DETAILS_ARTIFACT_KIND="testkit.failure-details",NODE_VITEST_DATA_FAILURE_DETAILS_ARTIFACT_NAME="data-flow-failure-details";const E={filename:NODE_VITEST_RUNTIME_INPUT_FILENAME,label:"Node/Vitest runtime input",maxSizeBytes:8*1024*1024},N=512,p=4*1024*1024,x=new Set(["BASE_URL","FORCE_COLOR","NODE_OPTIONS","NO_COLOR","UPDATE_SNAPSHOT",...l].map(t=>t.toUpperCase()));export const MAX_NODE_VITEST_SPAWN_ENVIRONMENT_UNITS=24*1024;export async function writeOwnedNodeVitestRuntimeInput(t,e){return S(t,e,E)}export async function verifyOwnedNodeVitestRuntimeInput(t){await f(t,E)}export function selectNodeVitestForwardedEnvironment(t){const e={...t};return _(e),e}export function assertNodeVitestSpawnEnvironmentBudget(t){if(Object.entries(t).reduce((n,[o,r])=>n+o.length+r.length+2,1)>MAX_NODE_VITEST_SPAWN_ENVIRONMENT_UNITS)throw new Error(`Node/Vitest process environment exceeds the ${MAX_NODE_VITEST_SPAWN_ENVIRONMENT_UNITS.toString()} character environment-block budget`)}export async function installNodeVitestRuntimeInput(t){const e=process.env[NODE_VITEST_RUNTIME_INPUT_FILE_ENV],n=process.env[NODE_VITEST_RUNTIME_INPUT_SHA256_ENV];if(e!==t.expectedFile)throw new Error("Node/Vitest runtime input pointer does not match its engine-owned path");if(n!==t.expectedSha256)throw new Error("Node/Vitest runtime input digest does not match its prepared value");const o=await m.lstat(t.expectedFile),r={directory:w.dirname(t.expectedFile),file:t.expectedFile,sha256:t.expectedSha256,sizeBytes:o.size},c=await f(r,E);let i;try{i=JSON.parse(c)}catch(u){throw new Error("Node/Vitest runtime input contains invalid JSON",{cause:u})}const s=a(I(i));if(s.invocationId!==t.expectedInvocationId||s.profileId!==t.expectedProfileId||s.taskId!==t.expectedTaskId)throw new Error("Node/Vitest runtime input identity does not match its task");R({environment:s.environment,label:"Node/Vitest"}),Object.defineProperty(globalThis,Symbol.for(NODE_VITEST_RUNTIME_INPUT_SYMBOL),{configurable:!0,enumerable:!1,value:s,writable:!1}),applyNodeVitestEngineEnvironment()}export function applyNodeVitestEngineEnvironment(){const t=readNodeVitestRuntimeInput();if(t===null)throw new Error("Node/Vitest runtime input is not installed");const e=t.context.baseUrl;typeof e=="string"?process.env.BASE_URL=e:Reflect.deleteProperty(process.env,"BASE_URL")}export function readNodeVitestRuntimeInput(){const t=Reflect.get(globalThis,Symbol.for(NODE_VITEST_RUNTIME_INPUT_SYMBOL));return t===void 0?null:a(I(t,"Installed Node/Vitest runtime input"))}function I(t,e="Node/Vitest runtime input"){if(h(t,e,V,O),!d(t))throw new Error(`${e} must contain an object`);const n=new Set(["context","engineId","environment","fixtures","invocationId","profileId","setupData","taskId","version"]);for(const r of Object.keys(t))if(!n.has(r))throw new Error(`${e} contains unknown field ${r}`);if(t.version!==NODE_VITEST_RUNTIME_INPUT_VERSION)throw new Error(`${e}.version must be 1`);if(t.engineId!=="node-vitest")throw new Error(`${e}.engineId must be "node-vitest"`);if(!A(t.profileId))throw new Error(`${e}.profileId is invalid`);if(!d(t.context)||!d(t.fixtures))throw new Error(`${e} context and fixtures must be objects`);const o=y(t.environment,`${e}.environment`);return _(o),{context:t.context,engineId:"node-vitest",environment:o,fixtures:t.fixtures,invocationId:T(t.invocationId,`${e}.invocationId`),profileId:t.profileId,...Object.hasOwn(t,"setupData")?{setupData:t.setupData}:{},taskId:T(t.taskId,`${e}.taskId`),version:NODE_VITEST_RUNTIME_INPUT_VERSION}}function _(t){const e=Object.entries(t);if(e.length>N)throw new Error(`Node/Vitest forwarded environment exceeds the ${N.toString()} entry limit`);let n=0;const o=new Set;for(const[r,c]of e){D(r,c,"Node/Vitest forwarded environment");const i=r.toUpperCase();if(o.has(i))throw new Error(`Node/Vitest forwarded environment contains case-insensitive duplicate key ${r}`);if(o.add(i),i.startsWith("TESTKIT_")||i.startsWith("VITEST_")||x.has(i))throw new Error(`Node/Vitest forwarded environment contains reserved key ${r}`);n+=Buffer.byteLength(r)+Buffer.byteLength(c)+2}if(n>p)throw new Error(`Node/Vitest forwarded environment exceeds the ${p.toString()} byte limit`)}function y(t,e){if(!d(t))throw new Error(`${e} must be an object`);const n=Object.entries(t);if(!n.every(o=>typeof o[1]=="string"))throw new Error(`${e} values must all be strings`);return Object.fromEntries(n)}function D(t,e,n){if(t.length===0||t.includes("=")||t.includes("\0"))throw new Error(`${n} contains an invalid variable name`);if(e.includes("\0"))throw new Error(`${n}.${t} contains a NUL character`)}function a(t){if(t!==null&&typeof t=="object"&&!Object.isFrozen(t)){Object.freeze(t);for(const e of Object.values(t))a(e)}return t}function T(t,e){if(typeof t!="string"||t.length===0)throw new Error(`${e} must be a non-empty string`);return t}function A(t){return t==="node-vitest-contract"||t==="node-vitest-data"}function d(t){return typeof t=="object"&&t!==null&&!Array.isArray(t)}

package/dist/engines/playwright/runtime/runtime-input.js

@@ -1,4 +1,4 @@
-import l from"node:fs/promises";import c from"node:path";import{writeOwnedRuntimeInput as m,ownedRuntimeInputModuleUrl as f}from"../../runtime-input-file.js";import{requireBoundedJsonValue as y,RUNTIME_INPUT_JSON_BOUNDS as h}from"../../contracts/json-bounds.js";import{ENGINE_PROCESS_RESERVED_ENVIRONMENT_KEYS as g,managedProcessEnvironmentOverlayInstallerSource as w}from"../../../process/index.js";export const PLAYWRIGHT_RUNTIME_INPUT_MAX_BYTES=4*1024*1024,PLAYWRIGHT_RUNTIME_ENVIRONMENT_MAX_BYTES=2*1024*1024,PLAYWRIGHT_RUNTIME_ENVIRONMENT_MAX_ENTRIES=512;const d=new Set(["BASE_URL","FORCE_COLOR","NODE_OPTIONS","NO_COLOR","PLAYWRIGHT_BROWSERS_PATH","PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD","TESTKIT_ACTIVE","TESTKIT_INTERNAL_FILE_DEADLINE_MS","TESTKIT_INTERNAL_FILE_TIMEOUT_SECONDS","TESTKIT_INVOCATION_ID","TESTKIT_RUNTIME_ID","TESTKIT_TEST_FILE","TESTKIT_TEST_ID",...g].map(e=>e.toUpperCase())),p={filename:"runtime-input.json",label:"Playwright runtime input",maxSizeBytes:PLAYWRIGHT_RUNTIME_INPUT_MAX_BYTES},E=Symbol.for("@gfdelarue/testkit/playwright-runtime-input/v1");export function readPlaywrightContext(){const e=Reflect.get(globalThis,E);return T(e)?e.context:null}export async function materializePlaywrightRuntimeInput(e){if(!c.isAbsolute(e.directory))throw new Error("Playwright runtime-input directory must be absolute");await l.mkdir(e.directory,{recursive:!0,mode:448}),process.platform!=="win32"&&await l.chmod(e.directory,448);const t=I(e.inputs.environment),r={baseUrl:v(e.baseUrl),endpoints:e.endpoints,engineId:"playwright",environment:t,fixtures:e.inputs.fixtures,invocationId:e.invocationId,managed:!0,schemaVersion:1,taskId:e.taskId,uiConfig:e.inputs.configuration??{},...e.inputs.setupData===void 0?{}:{setupData:e.inputs.setupData}},o=await m(e.directory,r,p);return{digest:o.sha256,file:o.file,sizeBytes:o.sizeBytes}}export function playwrightRuntimeInputBootstrapSource(e){const t=JSON.stringify({digest:e.digest,file:e.file,ownedInput:{directory:c.dirname(e.file),file:e.file,sha256:e.digest,sizeBytes:e.sizeBytes},protocol:p,invocationId:e.invocationId,jsonBounds:h,maximumEnvironmentBytes:PLAYWRIGHT_RUNTIME_ENVIRONMENT_MAX_BYTES,maximumEnvironmentEntries:PLAYWRIGHT_RUNTIME_ENVIRONMENT_MAX_ENTRIES,reservedEnvironmentKeys:[...d],taskId:e.taskId}),n=w(),r=`const requireBoundedJsonValue = (${y.toString()});`;return`
+import l from"node:fs/promises";import c from"node:path";import{writeOwnedRuntimeInput as m,ownedRuntimeInputModuleUrl as f}from"../../runtime-input-file.js";import{requireBoundedJsonValue as y,RUNTIME_INPUT_JSON_BOUNDS as h}from"../../contracts/json-bounds.js";import{ENGINE_PROCESS_RESERVED_ENVIRONMENT_KEYS as g}from"../../../process/environment.js";import{managedProcessEnvironmentOverlayInstallerSource as w}from"../../../process/environment-overlay.js";export const PLAYWRIGHT_RUNTIME_INPUT_MAX_BYTES=4*1024*1024,PLAYWRIGHT_RUNTIME_ENVIRONMENT_MAX_BYTES=2*1024*1024,PLAYWRIGHT_RUNTIME_ENVIRONMENT_MAX_ENTRIES=512;const d=new Set(["BASE_URL","FORCE_COLOR","NODE_OPTIONS","NO_COLOR","PLAYWRIGHT_BROWSERS_PATH","PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD","TESTKIT_ACTIVE","TESTKIT_INTERNAL_FILE_DEADLINE_MS","TESTKIT_INTERNAL_FILE_TIMEOUT_SECONDS","TESTKIT_INVOCATION_ID","TESTKIT_RUNTIME_ID","TESTKIT_TEST_FILE","TESTKIT_TEST_ID",...g].map(e=>e.toUpperCase())),p={filename:"runtime-input.json",label:"Playwright runtime input",maxSizeBytes:PLAYWRIGHT_RUNTIME_INPUT_MAX_BYTES},E=Symbol.for("@gfdelarue/testkit/playwright-runtime-input/v1");export function readPlaywrightContext(){const e=Reflect.get(globalThis,E);return T(e)?e.context:null}export async function materializePlaywrightRuntimeInput(e){if(!c.isAbsolute(e.directory))throw new Error("Playwright runtime-input directory must be absolute");await l.mkdir(e.directory,{recursive:!0,mode:448}),process.platform!=="win32"&&await l.chmod(e.directory,448);const t=I(e.inputs.environment),r={baseUrl:v(e.baseUrl),endpoints:e.endpoints,engineId:"playwright",environment:t,fixtures:e.inputs.fixtures,invocationId:e.invocationId,managed:!0,schemaVersion:1,taskId:e.taskId,uiConfig:e.inputs.configuration??{},...e.inputs.setupData===void 0?{}:{setupData:e.inputs.setupData}},o=await m(e.directory,r,p);return{digest:o.sha256,file:o.file,sizeBytes:o.sizeBytes}}export function playwrightRuntimeInputBootstrapSource(e){const t=JSON.stringify({digest:e.digest,file:e.file,ownedInput:{directory:c.dirname(e.file),file:e.file,sha256:e.digest,sizeBytes:e.sizeBytes},protocol:p,invocationId:e.invocationId,jsonBounds:h,maximumEnvironmentBytes:PLAYWRIGHT_RUNTIME_ENVIRONMENT_MAX_BYTES,maximumEnvironmentEntries:PLAYWRIGHT_RUNTIME_ENVIRONMENT_MAX_ENTRIES,reservedEnvironmentKeys:[...d],taskId:e.taskId}),n=w(),r=`const requireBoundedJsonValue = (${y.toString()});`;return`
 import path from "node:path";
 import { readVerifiedOwnedFile } from ${JSON.stringify(f)};
 

package/dist/environment/template.d.ts

@@ -44,12 +44,13 @@ export declare function resolveRuntimeInstanceConfigs<T extends RuntimeServiceCo
     runtimeId: string;
     runtimeLabel: string;
     testkit: {
+        mode?: string;
+        serviceEnv?: Readonly<Record<string, string>>;
+        ui?: unknown;
         database: import("../config/loader/database-materialization.js").MaterializedDatabaseConfig<{
-            sourceSchema: import("../config/loader/database.js").NormalizedSourceSchemaConfig | null;
-            template: import("../config/loader/database.js").NormalizedDatabaseTemplateConfig;
-            image?: string | undefined;
-            password?: string | undefined;
-            user?: string | undefined;
+            image?: string;
+            password?: string;
+            user?: string;
             binding: import("../config/loader/execution-model.js").DatabaseBinding;
             maxConnections: number | undefined;
             reservedConnections: number | undefined;
@@ -57,6 +58,8 @@ export declare function resolveRuntimeInstanceConfigs<T extends RuntimeServiceCo
             roles: import("../config/authoring/index.js").DatabaseRoleConfig[];
             runtimeConnections: number | undefined;
             serviceName: string;
+            sourceSchema: import("../config/loader/database.js").NormalizedSourceSchemaConfig | null;
+            template: import("../config/loader/database.js").NormalizedDatabaseTemplateConfig;
         }> | undefined;
         prepareDir: string;
         templateContext: {
@@ -82,13 +85,14 @@ export declare function resolveRuntimeInstanceConfigs<T extends RuntimeServiceCo
             databaseBindingsReader: typeof readDatabaseInfo;
         };
         runtime: {
-            prepare: import("../steps/build-config.js").NormalizedBuildPrepareConfig;
             build: import("../steps/build-config.js").NormalizedBuildConfig | null;
             instances: number;
             maxConcurrentTasks: number;
             toolchain: import("../toolchains/index.js").NormalizedRuntimeToolchain | null;
+            prepare: import("../steps/build-config.js").NormalizedBuildPrepareConfig;
         };
         local: {
+            shutdownTimeoutMs?: number;
             start: string;
             cwd: string | undefined;
             port: number | undefined;
@@ -97,11 +101,7 @@ export declare function resolveRuntimeInstanceConfigs<T extends RuntimeServiceCo
             env: {
                 [x: string]: string;
             };
-            shutdownTimeoutMs?: number;
         } | undefined;
-        mode?: string;
-        serviceEnv?: Readonly<Record<string, string>>;
-        ui?: unknown;
     };
 })[];
 export declare function buildPortMap(runtimeConfigs: readonly RuntimeServiceConfig[], runtimeId: RuntimeIdentifier, namespace?: RuntimePortNamespace): Map<string, number>;
@@ -110,12 +110,13 @@ export declare function resolveRuntimeConfig<T extends RuntimeServiceConfig>(con
     runtimeId: string;
     runtimeLabel: string;
     testkit: {
+        mode?: string;
+        serviceEnv?: Readonly<Record<string, string>>;
+        ui?: unknown;
         database: import("../config/loader/database-materialization.js").MaterializedDatabaseConfig<{
-            sourceSchema: import("../config/loader/database.js").NormalizedSourceSchemaConfig | null;
-            template: import("../config/loader/database.js").NormalizedDatabaseTemplateConfig;
-            image?: string | undefined;
-            password?: string | undefined;
-            user?: string | undefined;
+            image?: string;
+            password?: string;
+            user?: string;
             binding: import("../config/loader/execution-model.js").DatabaseBinding;
             maxConnections: number | undefined;
             reservedConnections: number | undefined;
@@ -123,6 +124,8 @@ export declare function resolveRuntimeConfig<T extends RuntimeServiceConfig>(con
             roles: import("../config/authoring/index.js").DatabaseRoleConfig[];
             runtimeConnections: number | undefined;
             serviceName: string;
+            sourceSchema: import("../config/loader/database.js").NormalizedSourceSchemaConfig | null;
+            template: import("../config/loader/database.js").NormalizedDatabaseTemplateConfig;
         }> | undefined;
         prepareDir: string;
         templateContext: {
@@ -148,13 +151,14 @@ export declare function resolveRuntimeConfig<T extends RuntimeServiceConfig>(con
             databaseBindingsReader: typeof readDatabaseInfo;
         };
         runtime: {
-            prepare: import("../steps/build-config.js").NormalizedBuildPrepareConfig;
             build: import("../steps/build-config.js").NormalizedBuildConfig | null;
             instances: number;
             maxConcurrentTasks: number;
             toolchain: import("../toolchains/index.js").NormalizedRuntimeToolchain | null;
+            prepare: import("../steps/build-config.js").NormalizedBuildPrepareConfig;
         };
         local: {
+            shutdownTimeoutMs?: number;
             start: string;
             cwd: string | undefined;
             port: number | undefined;
@@ -163,11 +167,7 @@ export declare function resolveRuntimeConfig<T extends RuntimeServiceConfig>(con
             env: {
                 [x: string]: string;
             };
-            shutdownTimeoutMs?: number;
         } | undefined;
-        mode?: string;
-        serviceEnv?: Readonly<Record<string, string>>;
-        ui?: unknown;
     };
 };
 export declare function resolveServiceStateDir(runtimeDir: string, config: Pick<ExecutionEnvironmentConfig, "name">): string;