@gfdelarue/testkit 0.4.5 → 0.5.0

package/dist/kernel/unknown-values.js

@@ -1 +1 @@
-export function isUnknownRecord(n){return typeof n=="object"&&n!==null&&!Array.isArray(n)}export function asUnknownRecord(n){return isUnknownRecord(n)?n:null}export function optionalString(n){return typeof n=="string"&&n.length>0?n:null}export function displayString(n,r){return optionalString(n)??r}export function isUnknownArray(n){return Array.isArray(n)}export function isPropertyContainer(n){return typeof n=="object"&&n!==null||typeof n=="function"}export function readDynamicProperty(n,r){return isPropertyContainer(n)?Reflect.get(n,r):void 0}export function isNullableString(n){return n===null||typeof n=="string"}
+export function isUnknownRecord(n){return typeof n=="object"&&n!==null&&!Array.isArray(n)}export function asUnknownRecord(n){return isUnknownRecord(n)?n:null}export function optionalString(n){return typeof n=="string"&&n.length>0?n:null}export function displayString(n,t){return optionalString(n)??t}export function isNonNullObject(n){return n!==null&&typeof n=="object"}export function normalizeOptionalString(n){if(typeof n!="string")return null;const t=n.trim();return t.length>0?t:null}export function isUnknownArray(n){return Array.isArray(n)}export function isPropertyContainer(n){return typeof n=="object"&&n!==null||typeof n=="function"}export function readDynamicProperty(n,t){return isPropertyContainer(n)?Reflect.get(n,t):void 0}export function isNullableString(n){return n===null||typeof n=="string"}

package/dist/process/environment.js

@@ -1 +1 @@
-import c from"node:fs/promises";import A from"node:os";import n from"node:path";import{toError as w}from"../kernel/error-serialization.js";export const ENGINE_PROCESS_RESERVED_ENVIRONMENT_KEYS=Object.freeze(["APPDATA","ComSpec","HOME","LANG","LC_ALL","LOCALAPPDATA","PATH","PATHEXT","SystemRoot","TEMP","TMP","TMPDIR","USERPROFILE","XDG_CACHE_HOME","XDG_CONFIG_HOME","XDG_DATA_HOME"]);export function nativeTemporaryRoot(t=process.env,o=process.platform){return T(t,o)}export async function createInvocationProcessEnvironment(t,o=process.env,r=process.platform){const e=n.join(t,"tmp");return d(t,e,!0,o,r)}export async function createNativeInvocationProcessEnvironment(t,o={}){const r=o.platform??process.platform,e=o.ambientEnvironment??process.env,s=await v(o.nativeTemporaryRootDirectory??nativeTemporaryRoot(e,r));let a=null;try{const i=await c.mkdtemp(n.join(s,"testkit-engine-"));return a=i,r!=="win32"&&await c.chmod(i,448),a=await P(i,s,r),await d(t,a,!1,e,r)}catch(i){if(a===null)throw i;try{await c.rm(a,{force:!0,recursive:!0})}catch(p){throw new AggregateError([w(i),w(p)],`Could not initialize or remove native invocation temporary directory ${a}`,{cause:p})}throw i}}async function d(t,o,r,e,s){if(!n.isAbsolute(t))throw new Error("Engine invocation directory must be absolute");if(!n.isAbsolute(o))throw new Error("Engine invocation temporary directory must be absolute");const a=n.join(t,"home"),i=n.join(t,"cache"),p=n.join(t,"config"),l=n.join(t,"data"),f=n.join(t,"local-app-data"),E=n.join(t,"app-data");await Promise.all([a,...r?[o]:[],i,p,l,f,E].map(y=>c.mkdir(y,{mode:448})));const m={APPDATA:E,HOME:a,LOCALAPPDATA:f,TEMP:o,TMP:o,TMPDIR:o,USERPROFILE:a,XDG_CACHE_HOME:i,XDG_CONFIG_HOME:p,XDG_DATA_HOME:l};return u(m,e,"LANG"),u(m,e,"LC_ALL"),s==="win32"&&(m.PATH="",u(m,e,"ComSpec"),u(m,e,"SystemRoot")),Object.freeze({environment:Object.freeze(m),homeDirectory:a,temporaryDirectory:o})}async function v(t){if(!n.isAbsolute(t))throw new Error("Native invocation temporary root must be absolute");const o=await c.realpath(t);if(!(await c.stat(o)).isDirectory())throw new Error("Native invocation temporary root must be a directory");return o}async function P(t,o,r){const e=await c.lstat(t);if(!e.isDirectory()||e.isSymbolicLink())throw new Error("Native invocation temporary directory must be a non-symbolic-link directory");if(r!=="win32"&&(e.mode&63)!==0)throw new Error("Native invocation temporary directory must not grant group or other access");const s=await c.realpath(t);if(n.dirname(s)!==o)throw new Error("Native invocation temporary directory escaped its operating-system root");return s}function T(t,o){if(o!=="win32")return"/tmp";const r=t.TEMP??t.TMP;return r===void 0||r.length===0?A.tmpdir():r}function u(t,o,r){const e=o[r];e!==void 0&&(t[r]=e)}
+import c from"node:fs/promises";import y from"node:os";import a from"node:path";import{toError as w}from"../kernel/error-serialization.js";export const ENGINE_PROCESS_RESERVED_ENVIRONMENT_KEYS=Object.freeze(["APPDATA","ComSpec","HOME","LANG","LC_ALL","LOCALAPPDATA","PATH","PATHEXT","SystemRoot","TEMP","TMP","TMPDIR","USERPROFILE","XDG_CACHE_HOME","XDG_CONFIG_HOME","XDG_DATA_HOME"]);export async function createInvocationProcessEnvironment(t,o=process.env,r=process.platform){const e=a.join(t,"tmp");return d(t,e,!0,o,r)}export async function createNativeInvocationProcessEnvironment(t,o={}){const r=o.platform??process.platform,e=o.ambientEnvironment??process.env,s=await v(o.nativeTemporaryRootDirectory??T(e,r));let n=null;try{const i=await c.mkdtemp(a.join(s,"testkit-engine-"));return n=i,r!=="win32"&&await c.chmod(i,448),n=await P(i,s,r),await d(t,n,!1,e,r)}catch(i){if(n===null)throw i;try{await c.rm(n,{force:!0,recursive:!0})}catch(p){throw new AggregateError([w(i),w(p)],`Could not initialize or remove native invocation temporary directory ${n}`,{cause:p})}throw i}}async function d(t,o,r,e,s){if(!a.isAbsolute(t))throw new Error("Engine invocation directory must be absolute");if(!a.isAbsolute(o))throw new Error("Engine invocation temporary directory must be absolute");const n=a.join(t,"home"),i=a.join(t,"cache"),p=a.join(t,"config"),l=a.join(t,"data"),E=a.join(t,"local-app-data"),f=a.join(t,"app-data");await Promise.all([n,...r?[o]:[],i,p,l,E,f].map(A=>c.mkdir(A,{mode:448})));const m={APPDATA:f,HOME:n,LOCALAPPDATA:E,TEMP:o,TMP:o,TMPDIR:o,USERPROFILE:n,XDG_CACHE_HOME:i,XDG_CONFIG_HOME:p,XDG_DATA_HOME:l};return u(m,e,"LANG"),u(m,e,"LC_ALL"),s==="win32"&&(m.PATH="",u(m,e,"ComSpec"),u(m,e,"SystemRoot")),Object.freeze({environment:Object.freeze(m),homeDirectory:n,temporaryDirectory:o})}async function v(t){if(!a.isAbsolute(t))throw new Error("Native invocation temporary root must be absolute");const o=await c.realpath(t);if(!(await c.stat(o)).isDirectory())throw new Error("Native invocation temporary root must be a directory");return o}async function P(t,o,r){const e=await c.lstat(t);if(!e.isDirectory()||e.isSymbolicLink())throw new Error("Native invocation temporary directory must be a non-symbolic-link directory");if(r!=="win32"&&(e.mode&63)!==0)throw new Error("Native invocation temporary directory must not grant group or other access");const s=await c.realpath(t);if(a.dirname(s)!==o)throw new Error("Native invocation temporary directory escaped its operating-system root");return s}function T(t,o){if(o!=="win32")return"/tmp";const r=t.TEMP??t.TMP;return r===void 0||r.length===0?y.tmpdir():r}function u(t,o,r){const e=o[r];e!==void 0&&(t[r]=e)}

package/dist/process/execa-bundle.json

@@ -1,9 +1,9 @@
 {
   "schemaVersion": 1,
   "entrypoint": "dist/process/process.js",
-  "sourceSha256": "6ad324171090dad3d43ff3b3356edce675b04fe12550b59db3a08f0593e0ebe5",
-  "bundleSha256": "38b6bf24433229155a2b0b82062feb2d57b5f4d2bc17081167a38e9088707269",
-  "packageLockSha256": "2197c742d835b790241553916187f6f45f27a14d62f6d793411aa285d4bd9779",
+  "sourceSha256": "6607c0273f046a00eb72ed4a0cac0f9b1c54d638be535b11188e1c8e20cdea67",
+  "bundleSha256": "6ce5a9db43a95cc11dd3f265a67cbad9bd4c492ea2f33187c6c2474150ce16df",
+  "packageLockSha256": "53ab4740dd4220dec486ba6f21059b6307964fea2ef9b1635598b131ef0a10de",
   "esbuildVersion": "0.28.1",
   "options": {
     "format": "esm",

package/dist/process/files/json-file.js

@@ -1 +1 @@
-import s from"node:fs";import a from"node:path";import{isPropertyContainer as E}from"../../kernel/unknown-values.js";const y=String;export function readProperty(t,r){return Reflect.get(t,r)}export function serializeJson(t,r){let e;try{e=JSON.stringify(t,null,2)}catch(o){throw new Error(`${r} is not JSON serializable`,{cause:o})}if(typeof e!="string")throw new Error(`${r} is not JSON serializable`);return e}export function errorMessage(t){if(t instanceof Error)return t.message;if(E(t)){const r=readProperty(t,"message");if(typeof r=="string"&&r.length>0)return r}return y(t)}const u=new Set(["EPERM","EACCES","EBUSY"]),l=process.platform==="win32"?100:25,A=10,S=100;class R extends Error{attempts;code="TESTKIT_ATOMIC_WRITE_FAILED";cause;path;tempPath;constructor(r,e,o,n){super(`Failed to atomically replace ${r} after ${o.toString()} attempt${o===1?"":"s"}: ${errorMessage(n)}`,{cause:n}),this.name="AtomicWriteError",this.attempts=o,this.cause=n,this.path=r,this.tempPath=e}}export function writeJsonFileAtomicWithRetry(t,r,e={}){writeTextFileAtomicWithRetry(t,serializeJson(r,`atomic JSON file ${t}`),e)}export function writeTextFileAtomicWithRetry(t,r,e={}){const o=a.dirname(t),n=a.join(o,`.${a.basename(t)}.${process.pid.toString()}.${Date.now().toString()}.${Math.random().toString(16).slice(2)}.tmp`),c=e.attempts??l,f=e.baseDelayMs??A,p=e.maxDelayMs??S;s.writeFileSync(n,r);try{for(let i=1;i<=c;i+=1)try{s.renameSync(n,t);return}catch(m){if(!isRetryableAtomicReplaceError(m)||i>=c||T(t))throw new R(t,n,i,m);_(Math.min(p,f*i))}}finally{s.rmSync(n,{force:!0})}}export function isRetryableAtomicReplaceError(t){if(!E(t))return!1;const r=readProperty(t,"code");return typeof r=="string"&&u.has(r)}function T(t){try{return s.lstatSync(t).isDirectory()}catch{return!1}}function _(t){if(t<=0)return;const r=new SharedArrayBuffer(4);Atomics.wait(new Int32Array(r),0,0,t)}
+import s from"node:fs";import a from"node:path";import{isPropertyContainer as p}from"../../kernel/unknown-values.js";const E=String;export function readProperty(t,r){return Reflect.get(t,r)}export function readJsonFileOrNull(t){try{return JSON.parse(s.readFileSync(t,"utf8"))}catch{return null}}export function serializeJson(t,r){let e;try{e=JSON.stringify(t,null,2)}catch(o){throw new Error(`${r} is not JSON serializable`,{cause:o})}if(typeof e!="string")throw new Error(`${r} is not JSON serializable`);return e}export function errorMessage(t){if(t instanceof Error)return t.message;if(p(t)){const r=readProperty(t,"message");if(typeof r=="string"&&r.length>0)return r}return E(t)}const l=new Set(["EPERM","EACCES","EBUSY"]),y=process.platform==="win32"?100:25,S=10,A=100;class R extends Error{attempts;code="TESTKIT_ATOMIC_WRITE_FAILED";cause;path;tempPath;constructor(r,e,o,n){super(`Failed to atomically replace ${r} after ${o.toString()} attempt${o===1?"":"s"}: ${errorMessage(n)}`,{cause:n}),this.name="AtomicWriteError",this.attempts=o,this.cause=n,this.path=r,this.tempPath=e}}export function writeJsonFileAtomicWithRetry(t,r,e={}){writeTextFileAtomicWithRetry(t,serializeJson(r,`atomic JSON file ${t}`),e)}export function writeTextFileAtomicWithRetry(t,r,e={}){const o=a.dirname(t),n=a.join(o,`.${a.basename(t)}.${process.pid.toString()}.${Date.now().toString()}.${Math.random().toString(16).slice(2)}.tmp`),c=e.attempts??y,f=e.baseDelayMs??S,u=e.maxDelayMs??A;s.writeFileSync(n,r);try{for(let i=1;i<=c;i+=1)try{s.renameSync(n,t);return}catch(m){if(!isRetryableAtomicReplaceError(m)||i>=c||T(t))throw new R(t,n,i,m);_(Math.min(u,f*i))}}finally{s.rmSync(n,{force:!0})}}export function isRetryableAtomicReplaceError(t){if(!p(t))return!1;const r=readProperty(t,"code");return typeof r=="string"&&l.has(r)}function T(t){try{return s.lstatSync(t).isDirectory()}catch{return!1}}function _(t){if(t<=0)return;const r=new SharedArrayBuffer(4);Atomics.wait(new Int32Array(r),0,0,t)}

package/dist/process/host/platform.js

@@ -1 +1 @@
-import u from"node:fs";import a from"node:path";import{isUnknownArray as w,isUnknownRecord as m}from"../../kernel/unknown-values.js";export const SUPPORTED_PLATFORMS=["darwin","linux","win32"],SUPPORTED_ARCHITECTURES=["arm64","x64"],SUPPORTED_PLATFORM_TARGETS=Object.freeze([Object.freeze({arch:"arm64",platform:"darwin"}),Object.freeze({arch:"x64",platform:"darwin"}),Object.freeze({arch:"arm64",platform:"linux"}),Object.freeze({arch:"x64",platform:"linux"}),Object.freeze({arch:"x64",platform:"win32"})]);export class UnsupportedPlatformTargetError extends Error{arch;code="TESTKIT_PLATFORM_TARGET_UNSUPPORTED";platform;constructor(t,e,o="platform target"){super(`${o} does not support ${t}-${e}`),this.name="UnsupportedPlatformTargetError",this.platform=t,this.arch=e}}export function platformTargetKey(r){return`${r.platform}-${r.arch}`}export function currentPlatformTarget(r=process.platform,t=process.arch){if(!isSupportedPlatform(r)||!isSupportedArchitecture(t))throw new UnsupportedPlatformTargetError(r,t);const e={platform:r,arch:t};return assertSupportedPlatformTarget(e,"current platform target"),e}export function currentLinuxLibc(){if(process.platform!=="linux")return null;const r=process.report.getReport(),t=m(r)?r.header:null,e=m(t)?t.glibcVersionRuntime:null;return typeof e=="string"&&e.trim().length>0?"glibc":"musl"}export function assertSupportedPlatformTarget(r,t="platform target"){if(r.platform==="win32"&&r.arch!=="x64")throw new UnsupportedPlatformTargetError(r.platform,r.arch,t)}export function isSupportedPlatform(r){return SUPPORTED_PLATFORMS.includes(r)}export function isSupportedArchitecture(r){return SUPPORTED_ARCHITECTURES.includes(r)}export function isWindows(r=process.platform){return r==="win32"}export function commandName(r,t=process.platform){const e=i(r||"").trim();if(!e)throw new Error("commandName requires a non-empty command name");return!isWindows(t)||/\.(?:cmd|bat|exe)$/i.test(e)?e:`${e}.cmd`}export function executableName(r,t=process.platform){const e=i(r||"").trim();if(!e)throw new Error("executableName requires a non-empty command name");return!isWindows(t)||/\.exe$/i.test(e)?e:`${e}.exe`}export function resolveCommandForSpawn(r,t={}){const e=t.platform||process.platform,o=t.env||process.env,n=i(r||"").trim();if(!n)throw new Error("resolveCommandForSpawn requires a non-empty command name");if(!isWindows(e))return n;if(/[\\/]/u.test(n)||a.win32.isAbsolute(n))return A(n);const s=g(n,o),c=[...i(o.PATH||o.Path||"").split(d(e)).map(l=>l.trim()).filter(Boolean),...t.extraWindowsDirs||[],...E(n,o)];for(const l of c)for(const x of s){const f=a.join(l,`${n}${x}`);if(u.existsSync(f))return f}return commandName(n,e)}export function prepareCommandForSpawn(r,t=[],e={}){const o=e.platform||process.platform,n=e.env||process.env,s=resolveCommandForSpawn(r,{...e,platform:o,env:n}),c=w(t)?t.map(l=>i(l)):[];return!isWindows(o)||!/\.(?:cmd|bat)$/i.test(s)?{command:s,args:c,windowsVerbatimArguments:!1}:{command:n.ComSpec||n.COMSPEC||"cmd.exe",args:["/d","/s","/c",P([s,...c])],windowsVerbatimArguments:!0}}export function packageBinPath(r,t,e=process.platform){const o=a.resolve(r||process.cwd()),n=i(t||"").trim();if(!/^[A-Za-z0-9@._/-]+$/.test(n))throw new Error(`Invalid package bin name: ${i(t)}`);const s=a.basename(n);return a.join(o,"node_modules",".bin",commandName(s,e))}export function shellQuote(r,t=process.platform){const e=i(r);return isWindows(t)?h(e):/^[A-Za-z0-9_/:.,@%+=-]*$/.test(e)?e:`'${e.replaceAll("'","'\\''")}'`}function h(r){return/^[A-Za-z0-9_/:.,@%+=\\-]*$/.test(r)?r:`"${r.replaceAll('"','\\"')}"`}function P(r){const[t,...e]=r;return`"${[p(t,{force:!0}),...e.map(o=>p(o))].join(" ")}"`}function p(r,t={}){const e=i(r);return!t.force&&e.length>0&&!/[\s&()<>^|"]/u.test(e)?e:`"${e.replace(/(\\*)"/gu,'$1$1\\"').replace(/\\+$/u,"$&$&")}"`}export function joinPathList(r,t=process.platform){const e=r.filter(Boolean).map(c=>i(c)),n=T(t)||d(t),s=Reflect.apply(Array.prototype.join,e,[n]);if(typeof s!="string")throw new Error("Path-list construction returned an invalid result");return s}function d(r){return isWindows(r)?";":":"}function g(r,t){if(/\.(?:cmd|bat|exe|com)$/i.test(r))return[""];const e=i(t.PATHEXT||".COM;.EXE;.BAT;.CMD").split(";").map(o=>o.trim().toLowerCase()).filter(Boolean);return[...new Set([".cmd",".exe",".bat",".com",...e])]}function A(r){if(u.existsSync(r)||/\.(?:cmd|bat|exe|com)$/i.test(r))return r;for(const t of[".cmd",".exe",".bat",".com"]){const e=`${r}${t}`;if(u.existsSync(e))return e}return commandName(r)}function E(r,t){return r.toLowerCase()!=="volta"?[]:[t.VOLTA_HOME,t.ProgramFiles?a.join(t.ProgramFiles,"Volta"):null,t["ProgramFiles(x86)"]?a.join(t["ProgramFiles(x86)"],"Volta"):null,t.LOCALAPPDATA?a.join(t.LOCALAPPDATA,"Volta","bin"):null,t.USERPROFILE?a.join(t.USERPROFILE,"AppData","Local","Volta","bin"):null].filter(e=>!!e)}export function dockerHostAddress(r,t=process.platform){const e=i(r||"").trim().toLowerCase();return["win32","darwin"].includes(t)&&(e==="127.0.0.1"||e==="localhost"||e==="::1")?"host.docker.internal":r}export function shouldUseDockerHostNetwork(r=process.platform){return r==="linux"}function i(r){const t=Reflect.apply(String,void 0,[r]);if(typeof t!="string")throw new Error("String conversion returned an invalid result");return t}function T(r){const t=a;if(!m(t))return;const e=t.delimiterForPlatform;if(e!=null){if(typeof e!="function")throw new TypeError("path.delimiterForPlatform is not a function");return Reflect.apply(e,t,[r])}}
+import l from"node:fs";import s from"node:path";import{isUnknownArray as x,isUnknownRecord as u}from"../../kernel/unknown-values.js";export const SUPPORTED_PLATFORMS=["darwin","linux","win32"],SUPPORTED_ARCHITECTURES=["arm64","x64"],SUPPORTED_PLATFORM_TARGETS=Object.freeze([Object.freeze({arch:"arm64",platform:"darwin"}),Object.freeze({arch:"x64",platform:"darwin"}),Object.freeze({arch:"arm64",platform:"linux"}),Object.freeze({arch:"x64",platform:"linux"}),Object.freeze({arch:"x64",platform:"win32"})]);export class UnsupportedPlatformTargetError extends Error{arch;code="TESTKIT_PLATFORM_TARGET_UNSUPPORTED";platform;constructor(t,e,o="platform target"){super(`${o} does not support ${t}-${e}`),this.name="UnsupportedPlatformTargetError",this.platform=t,this.arch=e}}export function platformTargetKey(r){return`${r.platform}-${r.arch}`}export function currentPlatformTarget(r=process.platform,t=process.arch){if(!isSupportedPlatform(r)||!isSupportedArchitecture(t))throw new UnsupportedPlatformTargetError(r,t);const e={platform:r,arch:t};return assertSupportedPlatformTarget(e,"current platform target"),e}export function currentLinuxLibc(){if(process.platform!=="linux")return null;const r=process.report.getReport(),t=u(r)?r.header:null,e=u(t)?t.glibcVersionRuntime:null;return typeof e=="string"&&e.trim().length>0?"glibc":"musl"}export function assertSupportedPlatformTarget(r,t="platform target"){if(r.platform==="win32"&&r.arch!=="x64")throw new UnsupportedPlatformTargetError(r.platform,r.arch,t)}export function isSupportedPlatform(r){return SUPPORTED_PLATFORMS.includes(r)}export function isSupportedArchitecture(r){return SUPPORTED_ARCHITECTURES.includes(r)}export function isWindows(r=process.platform){return r==="win32"}export function commandName(r,t=process.platform){const e=stringifyUnknown(r||"").trim();if(!e)throw new Error("commandName requires a non-empty command name");return!isWindows(t)||/\.(?:cmd|bat|exe)$/i.test(e)?e:`${e}.cmd`}export function executableName(r,t=process.platform){const e=stringifyUnknown(r||"").trim();if(!e)throw new Error("executableName requires a non-empty command name");return!isWindows(t)||/\.exe$/i.test(e)?e:`${e}.exe`}export function resolveCommandForSpawn(r,t={}){const e=t.platform||process.platform,o=t.env||process.env,n=stringifyUnknown(r||"").trim();if(!n)throw new Error("resolveCommandForSpawn requires a non-empty command name");if(!isWindows(e))return n;if(/[\\/]/u.test(n)||s.win32.isAbsolute(n))return g(n);const i=P(n,o),a=[...stringifyUnknown(o.PATH||o.Path||"").split(p(e)).map(c=>c.trim()).filter(Boolean),...A(n,o)];for(const c of a)for(const d of i){const m=s.join(c,`${n}${d}`);if(l.existsSync(m))return m}return commandName(n,e)}export function prepareCommandForSpawn(r,t=[],e={}){const o=e.platform||process.platform,n=e.env||process.env,i=resolveCommandForSpawn(r,{...e,platform:o,env:n}),a=x(t)?t.map(c=>stringifyUnknown(c)):[];return!isWindows(o)||!/\.(?:cmd|bat)$/i.test(i)?{command:i,args:a,windowsVerbatimArguments:!1}:{command:n.ComSpec||n.COMSPEC||"cmd.exe",args:["/d","/s","/c",h([i,...a])],windowsVerbatimArguments:!0}}export function packageBinPath(r,t,e=process.platform){const o=s.resolve(r||process.cwd()),n=stringifyUnknown(t||"").trim();if(!/^[A-Za-z0-9@._/-]+$/.test(n))throw new Error(`Invalid package bin name: ${stringifyUnknown(t)}`);const i=s.basename(n);return s.join(o,"node_modules",".bin",commandName(i,e))}export function shellQuote(r,t=process.platform){const e=stringifyUnknown(r);return isWindows(t)?w(e):/^[A-Za-z0-9_/:.,@%+=-]*$/.test(e)?e:`'${e.replaceAll("'","'\\''")}'`}function w(r){return/^[A-Za-z0-9_/:.,@%+=\\-]*$/.test(r)?r:`"${r.replaceAll('"','\\"')}"`}function h(r){const[t,...e]=r;return`"${[f(t,{force:!0}),...e.map(o=>f(o))].join(" ")}"`}function f(r,t={}){const e=stringifyUnknown(r);return!t.force&&e.length>0&&!/[\s&()<>^|"]/u.test(e)?e:`"${e.replace(/(\\*)"/gu,'$1$1\\"').replace(/\\+$/u,"$&$&")}"`}export function joinPathList(r,t=process.platform){const e=r.filter(Boolean).map(a=>stringifyUnknown(a)),n=E(t)||p(t),i=Reflect.apply(Array.prototype.join,e,[n]);if(typeof i!="string")throw new Error("Path-list construction returned an invalid result");return i}function p(r){return isWindows(r)?";":":"}function P(r,t){if(/\.(?:cmd|bat|exe|com)$/i.test(r))return[""];const e=stringifyUnknown(t.PATHEXT||".COM;.EXE;.BAT;.CMD").split(";").map(o=>o.trim().toLowerCase()).filter(Boolean);return[...new Set([".cmd",".exe",".bat",".com",...e])]}function g(r){if(l.existsSync(r)||/\.(?:cmd|bat|exe|com)$/i.test(r))return r;for(const t of[".cmd",".exe",".bat",".com"]){const e=`${r}${t}`;if(l.existsSync(e))return e}return commandName(r)}function A(r,t){return r.toLowerCase()!=="volta"?[]:[t.VOLTA_HOME,t.ProgramFiles?s.join(t.ProgramFiles,"Volta"):null,t["ProgramFiles(x86)"]?s.join(t["ProgramFiles(x86)"],"Volta"):null,t.LOCALAPPDATA?s.join(t.LOCALAPPDATA,"Volta","bin"):null,t.USERPROFILE?s.join(t.USERPROFILE,"AppData","Local","Volta","bin"):null].filter(e=>!!e)}export function dockerHostAddress(r,t=process.platform){const e=stringifyUnknown(r||"").trim().toLowerCase();return["win32","darwin"].includes(t)&&(e==="127.0.0.1"||e==="localhost"||e==="::1")?"host.docker.internal":r}export function shouldUseDockerHostNetwork(r=process.platform){return r==="linux"}export function stringifyUnknown(r){const t=Reflect.apply(String,void 0,[r]);if(typeof t!="string")throw new Error("String conversion returned an invalid result");return t}function E(r){const t=s;if(!u(t))return;const e=t.delimiterForPlatform;if(e!=null){if(typeof e!="function")throw new TypeError("path.delimiterForPlatform is not a function");return Reflect.apply(e,t,[r])}}

package/dist/process/host-process.js

@@ -1 +1 @@
-import l from"node:fs";import s from"node:path";import{runManagedProcess as E,startSupervisedProcess as f}from"./process.js";import{hasErrorCode as m}from"../kernel/error-serialization.js";export function runManagedHostProcess(e){const r=p(e);return E(r)}export function startManagedHostProcess(e){const r=p(e);return e.recoveryIdentity==="none"?f({...r,outputMode:e.outputMode,recoveryIdentity:"none"}):f({...r,outputMode:e.outputMode})}export function managedHostProcessInfrastructureError(e,r){const o=[];if(r.terminationError&&o.push(`process-scope termination was incomplete: ${r.terminationError.message}`),r.error&&o.push(`could not execute: ${r.error.message}`),r.timedOut&&o.push("exceeded its managed deadline"),r.cancelled&&o.push("was cancelled"),r.outputLimitExceeded&&o.push("exceeded the managed stdout/stderr capture limit"),o.length===0)return null;const n=new Error(`${e} ${o.join("; ")}`);return Object.defineProperty(n,"result",{enumerable:!1,value:Object.freeze({...r})}),n}export function normalizeManagedHostEnvironment(e=process.env,r=process.platform){const o=Object.entries(e).filter(t=>typeof t[1]=="string");if(r!=="win32")return Object.fromEntries(o);const n=new Map;for(const[t,a]of o){const c=t.toLowerCase();n.set(c,{key:y(c,t),value:a})}return Object.fromEntries([...n.entries()].sort(([t],[a])=>t.localeCompare(a)).map(([,t])=>[t.key,t.value]))}export function resolveManagedHostExecutable(e,r,o,n=process.platform){const t=resolveManagedHostExecutableIfAvailable(e,r,o,n);if(t)return t;throw o.PATH?new Error(`Could not resolve managed host executable ${JSON.stringify(e)}`):new Error(`Could not resolve managed host executable ${JSON.stringify(e)} because PATH is unavailable`)}export function resolveManagedHostExecutableIfAvailable(e,r,o,n=process.platform){if(e.trim().length===0)throw new Error("Managed host process executable must be non-empty");if(!s.isAbsolute(r))throw new Error("Managed host process working directory must be absolute");if(s.isAbsolute(e))return w(e,n);if(e.includes("/")||e.includes("\\"))throw new Error(`Managed host process executable paths must be absolute, got ${JSON.stringify(e)}`);const t=o.PATH;if(!t)return null;const a=b(e,o,n),c=n==="win32"?";":":";for(const u of t.split(c)){if(u.length===0)continue;const g=s.isAbsolute(u)?u:s.resolve(r,u);for(const h of a){const d=s.join(g,`${e}${h}`);try{const i=l.statSync(d,{throwIfNoEntry:!1});if(i!==void 0&&i.isFile()&&(n==="win32"||(i.mode&73)!==0))return w(d,n)}catch(i){if(!m(i,"ENOENT")&&!m(i,"ENOTDIR"))throw i}}}return null}function p(e){const r=s.resolve(e.cwd),o=normalizeManagedHostEnvironment(e.env);return{args:e.args,cwd:r,displayLabel:e.displayLabel,env:o,executable:resolveManagedHostExecutable(e.executable,r,o),signal:e.signal??new AbortController().signal,timeoutMs:e.timeoutMs,windowsVerbatimArguments:e.windowsVerbatimArguments}}function b(e,r,o){return o!=="win32"?[""]:s.extname(e).length>0?[""]:(r.PATHEXT||".COM;.EXE").split(";").map(t=>t.trim()).filter(t=>[".com",".exe"].includes(t.toLowerCase()))}function w(e,r){if(r==="win32"&&[".bat",".cmd"].includes(s.extname(e).toLowerCase()))throw new Error(`Windows batch wrappers are not managed host executables: ${e}`);const o=l.statSync(e);if(!o.isFile())throw new Error(`Managed host executable is not a regular file: ${e}`);if(r!=="win32"&&(o.mode&73)===0)throw new Error(`Managed host executable is not executable: ${e}`);return e}function y(e,r){return e==="path"?"PATH":e==="pathext"?"PATHEXT":e==="comspec"?"ComSpec":r}
+import f from"node:fs";import s from"node:path";import{runManagedProcess as E,startSupervisedProcess as l}from"./process.js";import{hasErrorCode as m}from"../kernel/error-serialization.js";export function runManagedHostProcess(e){const t=p(e);return E(t)}export function startManagedHostProcess(e){const t=p(e);return e.recoveryIdentity==="none"?l({...t,outputMode:e.outputMode,recoveryIdentity:"none"}):l({...t,outputMode:e.outputMode})}export function managedHostProcessInfrastructureError(e,t){const r=[];if(t.terminationError&&r.push(`process-scope termination was incomplete: ${t.terminationError.message}`),t.error&&r.push(`could not execute: ${t.error.message}`),t.timedOut&&r.push("exceeded its managed deadline"),t.cancelled&&r.push("was cancelled"),t.outputLimitExceeded&&r.push("exceeded the managed stdout/stderr capture limit"),r.length===0)return null;const n=new Error(`${e} ${r.join("; ")}`);return Object.defineProperty(n,"result",{enumerable:!1,value:Object.freeze({...t})}),n}export function normalizeManagedHostEnvironment(e=process.env,t=process.platform){const r=Object.entries(e).filter(o=>typeof o[1]=="string");if(t!=="win32")return Object.fromEntries(r);const n=new Map;for(const[o,a]of r){const c=o.toLowerCase();n.set(c,{key:y(c,o),value:a})}return Object.fromEntries([...n.entries()].sort(([o],[a])=>o.localeCompare(a)).map(([,o])=>[o.key,o.value]))}export function resolveManagedHostExecutable(e,t,r,n=process.platform){const o=resolveManagedHostExecutableIfAvailable(e,t,r,n);if(o)return o;throw r.PATH?new Error(`Could not resolve managed host executable ${JSON.stringify(e)}`):new Error(`Could not resolve managed host executable ${JSON.stringify(e)} because PATH is unavailable`)}export function resolveManagedHostExecutableIfAvailable(e,t,r,n=process.platform){if(e.trim().length===0)throw new Error("Managed host process executable must be non-empty");if(!s.isAbsolute(t))throw new Error("Managed host process working directory must be absolute");if(s.isAbsolute(e))return w(e,n);if(e.includes("/")||e.includes("\\"))throw new Error(`Managed host process executable paths must be absolute, got ${JSON.stringify(e)}`);const o=r.PATH;if(!o)return null;const a=b(e,r,n),c=n==="win32"?";":":";for(const u of o.split(c)){if(u.length===0)continue;const h=s.isAbsolute(u)?u:s.resolve(t,u);for(const g of a){const d=s.join(h,`${e}${g}`);try{const i=f.statSync(d,{throwIfNoEntry:!1});if(i!==void 0&&i.isFile()&&(n==="win32"||(i.mode&73)!==0))return w(d,n)}catch(i){if(!m(i,"ENOENT")&&!m(i,"ENOTDIR"))throw i}}}return null}function p(e){const t=s.resolve(e.cwd),r=normalizeManagedHostEnvironment(e.env);return{args:e.args,cwd:t,displayLabel:e.displayLabel,env:r,executable:resolveManagedHostExecutable(e.executable,t,r),signal:e.signal??new AbortController().signal,timeoutMs:e.timeoutMs,...e.timeoutStartsWhenReady===void 0?{}:{timeoutStartsWhenReady:e.timeoutStartsWhenReady},windowsVerbatimArguments:e.windowsVerbatimArguments}}function b(e,t,r){return r!=="win32"?[""]:s.extname(e).length>0?[""]:(t.PATHEXT||".COM;.EXE").split(";").map(o=>o.trim()).filter(o=>[".com",".exe"].includes(o.toLowerCase()))}function w(e,t){if(t==="win32"&&[".bat",".cmd"].includes(s.extname(e).toLowerCase()))throw new Error(`Windows batch wrappers are not managed host executables: ${e}`);const r=f.statSync(e);if(!r.isFile())throw new Error(`Managed host executable is not a regular file: ${e}`);if(t!=="win32"&&(r.mode&73)===0)throw new Error(`Managed host executable is not executable: ${e}`);return e}function y(e,t){return e==="path"?"PATH":e==="pathext"?"PATHEXT":e==="comspec"?"ComSpec":t}

package/dist/process/index.js

@@ -1 +1 @@
-export{runManagedProcess,ProcessExitedBeforeReadyError,startSupervisedProcess,terminateAttributedProcessLineage,terminateOwnedPosixProcessGroup}from"./process.js";export{managedHostProcessInfrastructureError,normalizeManagedHostEnvironment,resolveManagedHostExecutable,resolveManagedHostExecutableIfAvailable,runManagedHostProcess,startManagedHostProcess}from"./host-process.js";export{requireManagedHostCommandSuccess,runManagedHostCommand}from"./host-command.js";export{resolvePosixCommandShell}from"./command-shell.js";export{captureOutput}from"./capture-output.js";export{captureProcessCreationIdentity,observeProcessCreationIdentity,processCreationIdentityMatches}from"./process-identity.js";export{createInvocationProcessEnvironment,createNativeInvocationProcessEnvironment,ENGINE_PROCESS_RESERVED_ENVIRONMENT_KEYS}from"./environment.js";export{installManagedProcessEnvironmentOverlay,managedProcessEnvironmentOverlayInstallerSource,MANAGED_PROCESS_ENVIRONMENT_OVERLAY_STATE_SYMBOL}from"./environment-overlay.js";export{DEFAULT_SHUTDOWN_TIMEOUT_MS}from"./shutdown.js";
+export{runManagedProcess,ProcessExitedBeforeReadyError,startSupervisedProcess,terminateAttributedProcessLineage,terminateOwnedPosixProcessGroup}from"./process.js";export{managedHostProcessInfrastructureError,normalizeManagedHostEnvironment,resolveManagedHostExecutable,resolveManagedHostExecutableIfAvailable,runManagedHostProcess,startManagedHostProcess}from"./host-process.js";export{requireManagedHostCommandSuccess,runManagedHostCommand}from"./host-command.js";export{resolvePosixCommandShell}from"./command-shell.js";export{captureOutput}from"./capture-output.js";export{captureProcessCreationIdentity,observeProcessCreationIdentity,processCreationIdentityMatches}from"./process-identity.js";export{createInvocationProcessEnvironment,createNativeInvocationProcessEnvironment,ENGINE_PROCESS_RESERVED_ENVIRONMENT_KEYS}from"./environment.js";export{installManagedProcessEnvironmentOverlay,managedProcessEnvironmentOverlayInstallerSource,MANAGED_PROCESS_ENVIRONMENT_OVERLAY_STATE_SYMBOL}from"./environment-overlay.js";export{DEFAULT_SHUTDOWN_TIMEOUT_MS}from"./shutdown.js";export{startReadyDeadline}from"./ready-deadline.js";

package/dist/process/locks.js

@@ -1,4 +1,4 @@
-import{AsyncLocalStorage as te}from"node:async_hooks";import{randomUUID as re}from"node:crypto";import i from"node:fs";import ne from"node:os";import a from"node:path";import{setTimeout as oe}from"node:timers/promises";import{captureProcessCreationIdentity as F}from"./process-identity.js";import{channel as se}from"node:diagnostics_channel";const x=se("testkit.work");import{isUnknownRecord as j}from"../kernel/unknown-values.js";import{hasErrorCode as c}from"../kernel/error-serialization.js";function ie(e){try{i.mkdirSync(e,{mode:448})}catch(t){if(!c(t,"EEXIST"))throw t}return U(e)}function ce(e){try{const t=i.lstatSync(e);return t.isDirectory()&&!t.isSymbolicLink()?"real":"unsafe"}catch(t){if(c(t,"ENOENT"))return"absent";throw t}}function K(e){const t=i.lstatSync(e,{bigint:!0});if(!t.isDirectory()||t.isSymbolicLink())throw new Error(`Process lock path is not a real directory: ${e}`);return{birthtimeNs:t.birthtimeNs,dev:t.dev,ino:t.ino}}function U(e){try{return K(e)}catch(t){if(c(t,"ENOENT")||ue(t))return null;throw t}}function h(e,t){const n=U(e);return n!==null&&n.birthtimeNs===t.birthtimeNs&&n.dev===t.dev&&n.ino===t.ino}function ae(e,t,n){return h(e,t)?v(n)?"unsafe":"retry":h(n,t)?"published":"unsafe"}function ue(e){return e instanceof Error&&e.message.startsWith("Process lock path is not a real directory:")}const V="owner.json",A=1,T="claim-",M="choosing",W="ticket",le=100,q=65e3,fe=100,me=new Set(["EACCES","EBUSY","EPERM"]),de=5e3,Y=ne.hostname(),he=process.platform==="win32"?de:0,O=new te;class H extends Error{constructor(t,n){super(`Timed out waiting for process lock ${a.basename(t)}${Fe(n)}`),this.name="ProcessLockTimeoutError"}}export async function withProcessLock(e,t,n={}){const r=J(e);_e(r);const o=await ye(r,n),s=O.getStore(),u=new Set(s??[]);u.add(r);try{return await O.run(u,t)}finally{o()}}export async function tryWithProcessLock(e,t,n={}){let r;try{r=await withProcessLock(e,async()=>{try{return{ok:!0,value:await t()}}catch(o){return{error:o,ok:!1}}},{...n,timeoutMs:0})}catch(o){if(o instanceof H)return{acquired:!1};throw o}if(!r.ok)throw r.error;return{acquired:!0,value:r.value}}export function probeProcessLock(e,t={}){const n=J(e),r=G(n);if(!v(r))return"absent";const o=t.identityObservations??new Map,s=R(r,o,t);return s.rootAvailable&&s.claims.length===0?(_(r),"absent"):"active"}async function ye(e,t){const n=xe(t.timeoutMs,null,"process lock timeout"),r=je(t.retryIntervalMs,le,"process lock retry interval");let o=t.retryIntervalMs===void 0?10:r;async function s(){const b=o;o=Math.min(r,o*2),await $e(b,t.signal,e)}const u=t.identityObservations??new Map,f=F(process.pid);if(f===null)throw new Error(`Cannot acquire process lock ${e}: current process creation identity is unavailable`);const E=Date.now(),y={createdAt:new Date(E).toISOString(),hostname:Y,pid:process.pid,processIdentity:f,schemaVersion:A,token:re()},m=G(e),l=a.join(m,`${T}${y.token}`),k=`${m}.preparing-${y.token}`;we(k,y);let w=null,$=!1,S=null,I=!1,D=0;try{for(w=K(k);;){L(t.signal,e);const p=ie(m);if(p!==null){try{i.renameSync(k,l),I=!0,S=p}catch(d){if(!c(d,"ENOENT"))if(Ee(d)){const N=ae(k,w,l);if(N==="published")I=!0,S=p;else if(N==="retry"&&D<fe)D+=1;else throw d}else throw d}if(I){if(!h(m,p))throw new Error(`Process lock directory changed during claim publication: ${m}`);if(!h(l,w))throw new Error(`Process lock claim changed during publication: ${l}`);break}}else R(m,u,t);Q(e,null,E,n),await s()}if(S===null)throw new Error(`Process lock claim was published without its directory identity: ${l}`);const b=S,Z=R(m,u,t,b),g=ke(Z.claims);for(pe(l,g);;){L(t.signal,e);const p=R(m,u,t,b),d=p.claims.find(ee=>ee.claimDirectory===l);if(d?.state!=="ready"||d.ticket!==g||d.ownerRecord===null||!X(d.ownerRecord,y))throw new Error(`Process lock claim disappeared or changed before acquisition: ${l}`);const N=Se(p.claims,d);if(N===null)return $=!0,()=>{ge(l,m,b,y,g)};Q(e,N.ownerRecord,E,n),await s()}}finally{I?!$&&S!==null&&w!==null&&h(m,S)&&h(l,w)&&(i.rmSync(l,{force:!0,recursive:!0}),u.delete(l),_(m)):w!==null&&h(k,w)&&i.rmSync(k,{force:!0,recursive:!0})}}function Ee(e){return process.platform==="win32"&&j(e)&&typeof e.code=="string"&&me.has(e.code)}function we(e,t){i.mkdirSync(e,{mode:448});try{i.writeFileSync(a.join(e,V),`${JSON.stringify(t)}
-`,{encoding:"utf8",flag:"wx",mode:384}),i.writeFileSync(a.join(e,M),`${t.token}
-`,{encoding:"utf8",flag:"wx",mode:384})}catch(n){throw i.rmSync(e,{force:!0,recursive:!0}),n}}function pe(e,t){i.writeFileSync(a.join(e,W),`${t.toString()}
-`,{encoding:"utf8",flag:"wx",mode:384}),i.rmSync(a.join(e,M))}function ke(e){const t=e.reduce((n,r)=>r.ticket===null?n:Math.max(n,r.ticket),0);if(t>=Number.MAX_SAFE_INTEGER)throw new Error("Process lock ticket space is exhausted");return t+1}function Se(e,t){if(t.ticket===null||t.ownerRecord===null)return t;const n=t.ownerRecord.token;for(const r of e){if(r.claimDirectory===t.claimDirectory)continue;if(r.state!=="ready"||r.ticket===null||r.ownerRecord===null)return r;const o=r.ownerRecord.token;if(be(r.ticket,o,t.ticket,n)<0)return r}return null}function be(e,t,n,r){return e===n?t.localeCompare(r):e-n}function R(e,t,n,r=null){const o=ce(e);if(o==="absent")return{claims:[],rootAvailable:!0};if(o==="unsafe"){const f=P(e);return Le(e,t,n)?{claims:[],rootAvailable:!0}:{claims:[f],rootAvailable:!1}}if(r!==null&&!h(e,r))return{claims:[P(e)],rootAvailable:!1};let s;try{s=i.readdirSync(e,{withFileTypes:!0})}catch(f){if(c(f,"ENOENT"))return{claims:[],rootAvailable:!0};throw f}const u=[];for(const f of s){const E=a.join(e,f.name),y=!f.name.startsWith(T)||!f.isDirectory()?P(E):z(E);Ie(y,t,n)?Re(E,t):u.push(y)}return{claims:u,rootAvailable:!0}}function P(e){return{claimDirectory:e,ownerRecord:null,state:"malformed",ticket:null}}function z(e){const t=Me(e),n=v(a.join(e,M)),r=Ne(e),o=a.basename(e).slice(T.length),s=t===null||t.token===o;return{claimDirectory:e,ownerRecord:t,state:t===null||!s?"malformed":n?"choosing":r===null?"malformed":"ready",ticket:r}}function Ne(e){try{const t=i.readFileSync(a.join(e,W),"utf8").trim(),n=Number(t);return Number.isSafeInteger(n)&&n>0?n:null}catch{return null}}function Ie(e,t,n){const r=e.ownerRecord;if(r===null||r.hostname!==Y)return n.hostScope==="current-host"&&Ce(e.claimDirectory)>=q;if(ve(r.pid)==="absent")return!0;const o=C(r),s=t.get(e.claimDirectory);if(s?.ownerKey===o&&Date.now()-s.checkedAtMs<he)return!1;const u=F(r.pid);return t.set(e.claimDirectory,{checkedAtMs:Date.now(),ownerKey:o}),u!==null&&u!==r.processIdentity}function Re(e,t){t.delete(e),i.rmSync(e,{force:!0,recursive:!0})}function Le(e,t,n){if(n.hostScope!=="current-host")return!1;const r=B(e);if(r==="absent")return!0;if(r==="real-directory"||Te(r)<q)return!1;const o=B(e);if(o==="absent")return!0;if(o==="real-directory"||!Ae(o,r))return!1;try{return i.unlinkSync(e),t.delete(e),!0}catch(s){if(c(s,"ENOENT"))return!0;if(c(s,"EISDIR")||c(s,"EPERM"))return!1;throw s}}function ge(e,t,n,r,o){if(!h(t,n))throw new Error(`Process lock directory changed before release: ${t}`);const s=z(e);if(s.state!=="ready"||s.ticket!==o||s.ownerRecord===null||!X(s.ownerRecord,r))throw new Error(`Process lock ownership changed before release: ${e}`);i.rmSync(e,{force:!0,recursive:!0}),_(t)}function B(e){try{const t=i.lstatSync(e,{bigint:!0});return t.isDirectory()&&!t.isSymbolicLink()?"real-directory":{birthtimeNs:t.birthtimeNs,ctimeNs:t.ctimeNs,dev:t.dev,ino:t.ino,mode:t.mode,mtimeNs:t.mtimeNs,size:t.size}}catch(t){if(c(t,"ENOENT"))return"absent";throw t}}function Ae(e,t){return e.birthtimeNs===t.birthtimeNs&&e.ctimeNs===t.ctimeNs&&e.dev===t.dev&&e.ino===t.ino&&e.mode===t.mode&&e.mtimeNs===t.mtimeNs&&e.size===t.size}function Te(e){return Math.max(0,Date.now()-Number(e.mtimeNs)/1e6)}function _(e){try{i.rmdirSync(e)}catch(t){if(!c(t,"ENOENT")&&!c(t,"ENOTEMPTY")&&!c(t,"EEXIST"))throw t}}function Me(e){let t;try{t=JSON.parse(i.readFileSync(a.join(e,V),"utf8"))}catch{return null}return j(t)?Oe(t):null}function Oe(e){const t=Object.keys(e).sort(),n=["createdAt","hostname","pid","processIdentity","schemaVersion","token"];return t.length!==n.length||t.some((r,o)=>r!==n[o])||e.schemaVersion!==A||!Ke(e.createdAt)||typeof e.hostname!="string"||e.hostname.length===0||!Ue(e.pid)||typeof e.processIdentity!="string"||e.processIdentity.length===0||typeof e.token!="string"||e.token.length===0?null:{createdAt:e.createdAt,hostname:e.hostname,pid:e.pid,processIdentity:e.processIdentity,schemaVersion:A,token:e.token}}function X(e,t){return C(e)===C(t)}function C(e){return[e.hostname,e.pid.toString(),e.processIdentity,e.token,e.createdAt].join("\0")}function G(e){return`${e}.dir`}function J(e){const t=a.resolve(Pe(e)),n=i.realpathSync.native(a.dirname(t));return a.join(n,a.basename(t))}function Pe(e){if(e.trim().length===0)throw new Error("Process lock path must not be empty");return e}function _e(e){if(O.getStore()?.has(e))throw new Error(`Reentrant process lock acquisition is not allowed: ${e}`)}function Q(e,t,n,r){if(r!==null&&Date.now()-n>=r)throw new H(e,t)}function Ce(e){try{return Math.max(0,Date.now()-i.lstatSync(e).mtimeMs)}catch(t){if(c(t,"ENOENT"))return Number.POSITIVE_INFINITY;throw t}}function ve(e){try{return process.kill(e,0),"alive"}catch(t){return c(t,"ESRCH")?"absent":c(t,"EPERM")?"alive":"unknown"}}async function $e(e,t,n){L(t,n),x.hasSubscribers&&x.publish({metric:"locks.contentionRetries",amount:1});try{await oe(e,void 0,{signal:t})}catch(r){throw L(t,n),r}}function L(e,t){if(e?.aborted)throw De(e,t)}function De(e,t){return e.reason instanceof Error?e.reason:new Error(`Waiting for process lock was aborted: ${t}`)}function Fe(e){return e===null?"":` (host=${e.hostname} pid=${e.pid.toString()} identity=${e.processIdentity} createdAt=${e.createdAt})`}function xe(e,t,n){const r=e===void 0?t:e;if(r!==null&&(!Number.isSafeInteger(r)||r<0))throw new Error(`${n} must be null or a non-negative safe integer`);return r}function je(e,t,n){const r=e??t;if(!Number.isSafeInteger(r)||r<=0)throw new Error(`${n} must be a positive safe integer`);return r}function Ke(e){return typeof e=="string"&&e.length>0&&Number.isFinite(Date.parse(e))}function Ue(e){return Number.isSafeInteger(e)&&Number(e)>0}function v(e){try{return i.lstatSync(e),!0}catch(t){if(c(t,"ENOENT"))return!1;throw t}}
+import{AsyncLocalStorage as we}from"node:async_hooks";import{randomUUID as P}from"node:crypto";import i from"node:fs";import Ee from"node:os";import u from"node:path";import{setTimeout as q}from"node:timers/promises";import{captureProcessCreationIdentity as Y,inspectProcessLiveness as pe}from"./process-identity.js";import{retireWindowsClaim as ke}from"./windows-native.js";import{channel as Se}from"node:diagnostics_channel";const I=Se("testkit.work");import{isUnknownRecord as H}from"../kernel/unknown-values.js";import{hasErrorCode as a}from"../kernel/error-serialization.js";function Ne(e){try{i.mkdirSync(e,{mode:448})}catch(t){if(!a(t,"EEXIST"))throw t}return B(e)}function be(e){try{const t=i.lstatSync(e);return t.isDirectory()&&!t.isSymbolicLink()?"real":"unsafe"}catch(t){if(a(t,"ENOENT"))return"absent";throw t}}function X(e){const t=i.lstatSync(e,{bigint:!0});if(!t.isDirectory()||t.isSymbolicLink())throw new Error(`Process lock path is not a real directory: ${e}`);return{birthtimeNs:t.birthtimeNs,dev:t.dev,ino:t.ino}}function B(e){try{return X(e)}catch(t){if(a(t,"ENOENT")||Ie(t))return null;throw t}}function y(e,t){return G(B(e),t)}function G(e,t){return e!==null&&e.birthtimeNs===t.birthtimeNs&&e.dev===t.dev&&e.ino===t.ino}export function processLockClaimPublicationState(e,t,r){if(y(e,t))try{return K(r)?"unsafe":"retry"}catch(o){if(C(o))return"retry";throw o}return y(r,t)?"published":"unsafe"}function Ie(e){return e instanceof Error&&e.message.startsWith("Process lock path is not a real directory:")}const J="owner.json",v=1,$="claim-",D="choosing",z="ticket",Q=100,Z=65e3,Re=100,Le=new Set(["EACCES","EBUSY","EPERM"]),Te=1e4,_e=3,ge=20,Ae=5,Me=20,Ce=5e3,ee=Ee.hostname(),Oe=process.platform==="win32"?Ce:0,x=new we;class te extends Error{constructor(t,r){super(`Timed out waiting for process lock ${u.basename(t)}${Qe(r)}`),this.name="ProcessLockTimeoutError"}}export async function withProcessLock(e,t,r={}){const n=he(e);Ge(n);const o=await Pe(n,r),s=x.getStore(),c=new Set(s??[]);c.add(n);try{return await x.run(c,t)}finally{await o()}}export async function tryWithProcessLock(e,t,r={}){let n;try{n=await withProcessLock(e,async()=>{try{return{ok:!0,value:await t()}}catch(o){return{error:o,ok:!1}}},{...r,timeoutMs:0})}catch(o){if(o instanceof te)return{acquired:!1};throw o}if(!n.ok)throw n.error;return{acquired:!0,value:n.value}}export function probeProcessLock(e,t={}){const r=he(e),n=me(r);if(!K(n))return"absent";const o=t.identityObservations??new Map,s=oe(n,ne(n),o,re(),t);return s.rootAvailable&&s.claims.length===0?(j(n),"absent"):"active"}async function Pe(e,t){const r=Ze(t.timeoutMs,null,"process lock timeout"),n=et(t.retryIntervalMs,Q,"process lock retry interval");let o=t.retryIntervalMs===void 0?10:n;async function s(){const h=o;o=Math.min(n,o*2),await Je(h,t.signal,e)}const c=t.identityObservations??new Map,E=re(),l=async h=>oe(m,await _(()=>ne(m,h),t.signal,e),c,E,t),w=Y(process.pid);if(w===null)throw new Error(`Cannot acquire process lock ${e}: current process creation identity is unavailable`);const p=Date.now(),R={createdAt:new Date(p).toISOString(),hostname:ee,pid:process.pid,processIdentity:w,schemaVersion:v,token:P()},m=me(e),f=u.join(m,`${$}${R.token}`),N=`${m}.preparing-${R.token}`;ve(N,R);let k=null,U=!1,b=null,A=!1,V=0;try{for(k=X(N);;){g(t.signal,e);const S=await _(()=>Ne(m),t.signal,e);if(S!==null){try{i.renameSync(N,f),A=!0,b=S}catch(d){if(!a(d,"ENOENT"))if(C(d)){const T=processLockClaimPublicationState(N,k,f);if(T==="published")A=!0,b=S;else if(T==="retry"&&V<Re)V+=1;else throw d}else throw d}if(A){if(!y(m,S))throw new Error(`Process lock directory changed during claim publication: ${m}`);if(!y(f,k))throw new Error(`Process lock claim changed during publication: ${f}`);break}}else await l(null);O(e,null,p,r),await s()}if(b===null)throw new Error(`Process lock claim was published without its directory identity: ${f}`);const h=b;let L=nextProcessLockTicket((await l(h)).claims);for(;L===null;)O(e,null,p,r),await s(),L=nextProcessLockTicket((await l(h)).claims);const M=L;for($e(f,M);;){g(t.signal,e);const S=await l(h),d=S.claims.find(ye=>ye.claimDirectory===f);if(d?.state==="changing"){O(e,null,p,r),await s();continue}if(d?.state!=="ready"||d.ticket!==M||d.ownerRecord===null||!de(d.ownerRecord,R))throw new Error(`Process lock claim disappeared or changed before acquisition: ${f}`);const T=firstElectionBlocker(S.claims,d);if(T===null)return U=!0,()=>Ve(f,m,h,R,M);O(e,T.ownerRecord,p,r),await s()}}finally{if(!A)k!==null&&y(N,k)&&i.rmSync(N,{force:!0,recursive:!0});else if(!U&&b!==null&&k!==null){const h=b,L=k;await le(f,m,()=>y(m,h)&&y(f,L))&&c.delete(f)}}}function C(e,t=process.platform){return t==="win32"&&H(e)&&typeof e.code=="string"&&Le.has(e.code)}export function tolerateTransientClaimFailure(e,t,r,n=Date.now(),o=process.platform){if(!C(r,o))throw r;const s=e.get(t),c={count:(s?.count??0)+1,firstAtMs:s?.firstAtMs??n};if(c.count>=_e&&n-c.firstAtMs>=Te)throw r;e.set(t,c)}export function transientWindowsLockRetryDelayMs(e,t,r=process.platform){return!C(e,r)||t>=ge?null:Math.min(Q,10*t)}async function _(e,t,r=""){for(let n=1;;n+=1)try{return e()}catch(o){const s=transientWindowsLockRetryDelayMs(o,n);if(s===null)throw o;I.hasSubscribers&&I.publish({metric:"locks.transientWindowsRetries",amount:1});try{await q(s,void 0,{signal:t})}catch(c){throw g(t,r),c}}}function re(){return{entryReads:new Map,retirements:new Map}}function ve(e,t){i.mkdirSync(e,{mode:448});try{i.writeFileSync(u.join(e,J),`${JSON.stringify(t)}
+`,{encoding:"utf8",flag:"wx",mode:384}),i.writeFileSync(u.join(e,D),`${t.token}
+`,{encoding:"utf8",flag:"wx",mode:384})}catch(r){throw i.rmSync(e,{force:!0,recursive:!0}),r}}function $e(e,t){i.writeFileSync(u.join(e,z),`${t.toString()}
+`,{encoding:"utf8",flag:"wx",mode:384}),i.rmSync(u.join(e,D))}export function nextProcessLockTicket(e){if(e.some(r=>r.state==="changing"))return null;const t=e.reduce((r,n)=>n.ticket===null?r:Math.max(r,n.ticket),0);if(t>=Number.MAX_SAFE_INTEGER)throw new Error("Process lock ticket space is exhausted");return t+1}export function firstElectionBlocker(e,t){if(t.ticket===null||t.ownerRecord===null)return t;const r=t.ownerRecord.token;for(const n of e){if(n.claimDirectory===t.claimDirectory)continue;if(n.state!=="ready"||n.ticket===null||n.ownerRecord===null)return n;const o=n.ownerRecord.token;if(De(n.ticket,o,t.ticket,r)<0)return n}return null}function De(e,t,r,n){return e===r?t.localeCompare(n):e-r}function ne(e,t=null){const r=be(e);if(r!=="real")return{state:r};if(t!==null&&!y(e,t))return{state:"changed"};try{return{entries:i.readdirSync(e,{withFileTypes:!0}),state:"listed"}}catch(n){if(a(n,"ENOENT"))return{state:"absent"};throw n}}function oe(e,t,r,n,o){if(t.state!=="listed")return t.state==="absent"?{claims:[],rootAvailable:!0}:t.state==="unsafe"&&Ue(e,r,o)?{claims:[],rootAvailable:!0}:{claims:[ie(e)],rootAvailable:!1};const{entries:s}=t,c=[];for(const E of s){const l=u.join(e,E.name);let w;try{w=xe(E,l)}catch(p){tolerateTransientClaimFailure(n.entryReads,l,p),c.push(ce(l));continue}n.entryReads.delete(l),w===null?n.retirements.delete(l):Fe(w,r,o)?Ke(e,l,w.identity,r,n.retirements)==="held"&&c.push(ce(l)):(n.retirements.delete(l),c.push(w.claim))}return{claims:c,rootAvailable:!0}}function xe(e,t){const r=W(t);if(r===null)return null;const n=!e.name.startsWith($)||!e.isDirectory()?ie(t):ae(t),o=W(t);return o===null?null:{claim:n,identity:se(r),modifiedAtMs:Number(o.mtimeMs)}}function We(e){const t=W(e);return t===null?null:se(t)}function W(e){try{return i.lstatSync(e,{bigint:!0})}catch(t){if(a(t,"ENOENT"))return null;throw t}}function se(e){return{birthtimeNs:e.birthtimeNs,dev:e.dev,ino:e.ino}}function ie(e){return{claimDirectory:e,ownerRecord:null,state:"malformed",ticket:null}}function ce(e){return{claimDirectory:e,ownerRecord:null,state:"changing",ticket:null}}function ae(e){const t=He(e),r=K(u.join(e,D)),n=je(e),o=u.basename(e).slice($.length),s=t===null||t.token===o;return{claimDirectory:e,ownerRecord:t,state:t===null||!s?"malformed":r?"choosing":n===null?"malformed":"ready",ticket:n}}function je(e){const t=ue(u.join(e,z));if(t===null)return null;const r=Number(t.trim());return Number.isSafeInteger(r)&&r>0?r:null}function ue(e){try{return i.readFileSync(e,"utf8")}catch(t){if(a(t,"ENOENT")||a(t,"EISDIR"))return null;throw t}}function Fe({claim:e,modifiedAtMs:t},r,n){const o=e.ownerRecord;if(o===null||o.hostname!==ee)return n.hostScope==="current-host"&&Date.now()-t>=Z;if(pe(o.pid)==="absent")return!0;const s=F(o),c=r.get(e.claimDirectory);if(c?.ownerKey===s&&Date.now()-c.checkedAtMs<Oe)return!1;const E=Y(o.pid);return r.set(e.claimDirectory,{checkedAtMs:Date.now(),ownerKey:s}),E!==null&&E!==o.processIdentity}function Ke(e,t,r,n,o){n.delete(t);const s=`${e}.reclaiming-${P()}`;try{if(process.platform==="win32"){if(ke(t,s,r)==="absent")return o.delete(t),"removed"}else i.renameSync(t,s)}catch(c){return process.platform!=="win32"&&a(c,"ENOENT")?(o.delete(t),"removed"):(tolerateTransientClaimFailure(o,t,c),"held")}if(o.delete(t),!G(We(s),r))throw new Error(`Process lock claim ${t} changed before reclamation and is now at ${s}`);return i.rmSync(s,{maxRetries:Ae,recursive:!0,retryDelay:Me}),I.hasSubscribers&&I.publish({metric:"locks.reclaimedClaims",amount:1}),"removed"}function Ue(e,t,r){if(r.hostScope!=="current-host")return!1;const n=fe(e);if(n==="absent")return!0;if(n==="real-directory"||Ye(n)<Z)return!1;const o=fe(e);if(o==="absent")return!0;if(o==="real-directory"||!qe(o,n))return!1;try{return i.unlinkSync(e),t.delete(e),!0}catch(s){if(a(s,"ENOENT"))return!0;if(a(s,"EISDIR")||a(s,"EPERM"))return!1;throw s}}async function Ve(e,t,r,n,o){await le(e,t,()=>{if(!y(t,r))throw new Error(`Process lock directory changed before release: ${t}`);const s=ae(e);if(s.state!=="ready"||s.ticket!==o||s.ownerRecord===null||!de(s.ownerRecord,n))throw new Error(`Process lock ownership changed before release: ${e}`);return!0})}async function le(e,t,r){if(process.platform!=="win32")return r()?(i.rmSync(e,{force:!0,recursive:!0}),j(t),!0):!1;const n=`${t}.releasing-${P()}`;return await _(()=>r()?(i.renameSync(e,n),!0):!1)?(await _(()=>{i.rmSync(n,{force:!0,recursive:!0})}),await _(()=>{j(t)}),!0):!1}function fe(e){try{const t=i.lstatSync(e,{bigint:!0});return t.isDirectory()&&!t.isSymbolicLink()?"real-directory":{birthtimeNs:t.birthtimeNs,ctimeNs:t.ctimeNs,dev:t.dev,ino:t.ino,mode:t.mode,mtimeNs:t.mtimeNs,size:t.size}}catch(t){if(a(t,"ENOENT"))return"absent";throw t}}function qe(e,t){return e.birthtimeNs===t.birthtimeNs&&e.ctimeNs===t.ctimeNs&&e.dev===t.dev&&e.ino===t.ino&&e.mode===t.mode&&e.mtimeNs===t.mtimeNs&&e.size===t.size}function Ye(e){return Math.max(0,Date.now()-Number(e.mtimeNs)/1e6)}function j(e){try{i.rmdirSync(e)}catch(t){if(!a(t,"ENOENT")&&!a(t,"ENOTEMPTY")&&!a(t,"EEXIST"))throw t}}function He(e){const t=ue(u.join(e,J));if(t===null)return null;let r;try{r=JSON.parse(t)}catch{return null}return H(r)?Xe(r):null}function Xe(e){const t=Object.keys(e).sort(),r=["createdAt","hostname","pid","processIdentity","schemaVersion","token"];return t.length!==r.length||t.some((n,o)=>n!==r[o])||e.schemaVersion!==v||!tt(e.createdAt)||typeof e.hostname!="string"||e.hostname.length===0||!rt(e.pid)||typeof e.processIdentity!="string"||e.processIdentity.length===0||typeof e.token!="string"||e.token.length===0?null:{createdAt:e.createdAt,hostname:e.hostname,pid:e.pid,processIdentity:e.processIdentity,schemaVersion:v,token:e.token}}function de(e,t){return F(e)===F(t)}function F(e){return[e.hostname,e.pid.toString(),e.processIdentity,e.token,e.createdAt].join("\0")}function me(e){return`${e}.dir`}function he(e){const t=u.resolve(Be(e)),r=i.realpathSync.native(u.dirname(t));return u.join(r,u.basename(t))}function Be(e){if(e.trim().length===0)throw new Error("Process lock path must not be empty");return e}function Ge(e){if(x.getStore()?.has(e))throw new Error(`Reentrant process lock acquisition is not allowed: ${e}`)}function O(e,t,r,n){if(n!==null&&Date.now()-r>=n)throw new te(e,t)}async function Je(e,t,r){g(t,r),I.hasSubscribers&&I.publish({metric:"locks.contentionRetries",amount:1});try{await q(e,void 0,{signal:t})}catch(n){throw g(t,r),n}}function g(e,t){if(e?.aborted)throw ze(e,t)}function ze(e,t){return e.reason instanceof Error?e.reason:new Error(`Waiting for process lock was aborted: ${t}`)}function Qe(e){return e===null?"":` (host=${e.hostname} pid=${e.pid.toString()} identity=${e.processIdentity} createdAt=${e.createdAt})`}function Ze(e,t,r){const n=e===void 0?t:e;if(n!==null&&(!Number.isSafeInteger(n)||n<0))throw new Error(`${r} must be null or a non-negative safe integer`);return n}function et(e,t,r){const n=e??t;if(!Number.isSafeInteger(n)||n<=0)throw new Error(`${r} must be a positive safe integer`);return n}function tt(e){return typeof e=="string"&&e.length>0&&Number.isFinite(Date.parse(e))}function rt(e){return Number.isSafeInteger(e)&&Number(e)>0}function K(e){try{return i.lstatSync(e),!0}catch(t){if(a(t,"ENOENT"))return!1;throw t}}

package/dist/process/port-listener.js

@@ -0,0 +1,2 @@
+import{spawn as u}from"node:child_process";import{once as f}from"node:events";import c from"node:fs";import{windowsCliOwned as d}from"./windows-cli-owner.js";import{windowsOwnerExecutable as p}from"./windows-native.js";const a=1e4;export async function portListenerOwner(r,i){try{if(process.platform==="linux")return l(m(r),i);if(process.platform!=="win32"||!d())return"unknown";const o=u(p(),["job-listener",String(r)],{detached:!0,stdio:["ignore","pipe","ignore"],timeout:a,windowsHide:!0});let t="";o.stdout.setEncoding("utf8").on("data",e=>t+=e);const[n]=await f(o,"close");return n===0&&(t==="ours"||t==="foreign")?t:"unknown"}catch{return"unknown"}}function l(r,i){return r.length===0?"unknown":r.every(o=>o.length===0||o.includes(i))?"ours":"foreign"}function m(r){const i=new Set;for(const t of["/proc/net/tcp","/proc/net/tcp6"])if(c.existsSync(t))for(const n of c.readFileSync(t,"utf8").trim().split(`
+`).slice(1)){const e=n.trim().split(/\s+/u);e[3]==="0A"&&Number.parseInt(e[1]?.split(":")[1]??"",16)===r&&i.add(e[9])}const o=new Map;for(const t of c.readdirSync("/proc").filter(n=>/^\d+$/u.test(n))){let n;try{n=c.readdirSync(`/proc/${t}/fd`)}catch{continue}for(const e of n){const s=/^socket:\[(\d+)\]$/u.exec(w(`/proc/${t}/fd/${e}`))?.[1];s!==void 0&&i.has(s)&&o.set(s,[...o.get(s)??[],Number(t)])}}return[...i].map(t=>(o.get(t)??[]).map(n=>{const e=c.readFileSync(`/proc/${n.toString()}/stat`,"utf8");return Number(e.slice(e.lastIndexOf(")")+2).split(" ")[2])}))}function w(r){try{return c.readlinkSync(r)}catch{return""}}

package/dist/process/process-group.js

@@ -1 +1 @@
-import{DEFAULT_SHUTDOWN_TIMEOUT_MS as f,FORCE_TERMINATION_WAIT_MS as m}from"./shutdown.js";import{hasErrorCode as c,toError as E}from"../kernel/error-serialization.js";export async function cleanupExitedProcessGroup(e,r={}){if((r.platform??process.platform)==="win32")return null;const t=r.groupExists??processGroupExists,n=r.sendSignal??M,o=r.sleep??g,s=r.graceMs??f,l=r.forceWaitMs??m;try{return!t(e)||(r.initialSignalSent||n(e,"SIGTERM"),await i(e,s,t,o,r.remainingMs))?null:(n(e,"SIGKILL"),await i(e,l,t,o)?null:new Error(`Managed process group ${e.toString()} did not stop`))}catch(u){return c(u,"ESRCH")?null:E(u)}}async function i(e,r,a,t,n){const o=performance.now(),s=n??(()=>r-(performance.now()-o));for(;s()>0;){if(!a(e))return!0;await t(Math.min(25,Math.max(1,s())))}return!a(e)}function M(e,r){process.kill(-e,r)}function g(e){return new Promise(r=>setTimeout(r,e))}export function processGroupExists(e){try{return process.kill(-e,0),!0}catch(r){if(c(r,"ESRCH"))return!1;if(c(r,"EPERM"))return!0;throw r}}
+import{DEFAULT_SHUTDOWN_TIMEOUT_MS as f,FORCE_TERMINATION_WAIT_MS as m}from"./shutdown.js";import{hasErrorCode as c,toError as E}from"../kernel/error-serialization.js";export async function cleanupExitedProcessGroup(e,r={}){if((r.platform??process.platform)==="win32")return null;const t=r.groupExists??processGroupExists,n=r.sendSignal??M,o=r.sleep??delay,s=r.graceMs??f,l=r.forceWaitMs??m;try{return!t(e)||(r.initialSignalSent||n(e,"SIGTERM"),await i(e,s,t,o,r.remainingMs))?null:(n(e,"SIGKILL"),await i(e,l,t,o)?null:new Error(`Managed process group ${e.toString()} did not stop`))}catch(u){return c(u,"ESRCH")?null:E(u)}}async function i(e,r,a,t,n){const o=performance.now(),s=n??(()=>r-(performance.now()-o));for(;s()>0;){if(!a(e))return!0;await t(Math.min(25,Math.max(1,s())))}return!a(e)}function M(e,r){process.kill(-e,r)}export function delay(e){return new Promise(r=>setTimeout(r,e))}export function processGroupExists(e){try{return process.kill(-e,0),!0}catch(r){if(c(r,"ESRCH"))return!1;if(c(r,"EPERM"))return!0;throw r}}