@gfdelarue/testkit 0.4.4 → 0.5.0

package/dist/process/runs/manifest.d.ts

@@ -1,86 +0,0 @@
-import type { RuntimeSocket } from "../runtime-socket.js";
-import { RUN_MAINTENANCE_STOP_REQUEST_SCHEMA_VERSION, RUN_MANIFEST_SCHEMA_VERSION } from "./schema.js";
-export { RUN_MAINTENANCE_STOP_REQUEST_SCHEMA_VERSION, RUN_MANIFEST_SCHEMA_VERSION };
-export interface RunManifestController {
-    [key: string]: null | string;
-}
-export interface RunManifestPort extends RuntimeSocket {
-    [key: string]: unknown;
-}
-export interface RunManifestService {
-    shutdownTimeoutMs?: number;
-    shutdownDeadlineAt?: number | null;
-    [key: string]: unknown;
-    command?: null | string;
-    cwd?: string;
-    pid: number;
-    processIdentity: string;
-    ports: RunManifestPort[];
-    processGroupId: null | number;
-    runtimeLabel?: string;
-    serviceName?: string;
-    startedAt?: string;
-}
-export interface RunManifest {
-    [key: string]: unknown;
-    controller?: null | RunManifestController;
-    finishedAt?: string;
-    heartbeatAt?: null | string;
-    incarnationId: string;
-    interruptReason?: null | string;
-    pid: number;
-    processIdentity: null | string;
-    runId: string;
-    runtimeDirs: string[];
-    schemaVersion: typeof RUN_MANIFEST_SCHEMA_VERSION;
-    services: RunManifestService[];
-    session?: null | Record<string, unknown>;
-    startedAt?: string;
-    status?: string;
-}
-export interface WritableRunManifest extends RunManifest {
-    controller: null | RunManifestController;
-    heartbeatAt: null | string;
-    interruptReason: null | string;
-    pid: number;
-    processIdentity: null | string;
-    runId: string;
-    schemaVersion: typeof RUN_MANIFEST_SCHEMA_VERSION;
-    startedAt: string;
-    status: string;
-}
-export interface RunMaintenanceStopRequest {
-    coordinatorPid: number;
-    coordinatorProcessIdentity: string;
-    reason: string;
-    requestedAt: string;
-    runId: string;
-    schemaVersion: typeof RUN_MAINTENANCE_STOP_REQUEST_SCHEMA_VERSION;
-    targetIncarnationId: string;
-    targetPid: number;
-    targetProcessIdentity: string;
-}
-export declare class RunManifestCollisionError extends Error {
-    readonly code = "TESTKIT_RUN_MANIFEST_COLLISION";
-    readonly manifestPath: string;
-    constructor(manifestPath: string, options?: ErrorOptions);
-}
-export declare class RunManifestInventoryError extends Error {
-    readonly code = "TESTKIT_RUN_MANIFEST_INVENTORY_FAILED";
-    readonly manifestPath: string;
-    constructor(manifestPath: string, reason: string, options?: ErrorOptions);
-}
-export declare function runManifestPath(productDir: string, runId: unknown): string;
-export declare function writeRunManifest(productDir: string, manifest: Readonly<WritableRunManifest>): void;
-export declare function prepareRunShutdownDeadlines(manifest: Readonly<RunManifest>, requestedAt: string): RunManifest;
-export declare function persistRunShutdownDeadlines(productDir: string, manifest: Readonly<RunManifest>): void;
-export declare function createRunManifest(productDir: string, manifest: Readonly<WritableRunManifest>): void;
-export declare function writeRunMaintenanceStopRequest(productDir: string, request: Readonly<RunMaintenanceStopRequest>): void;
-export declare function readRunMaintenanceStopRequest(productDir: string, runId: unknown): RunMaintenanceStopRequest | null;
-export declare function removeRunMaintenanceStopRequest(productDir: string, runId: unknown): void;
-export declare function removeRunManifestFile(productDir: string, runId: unknown): void;
-export declare function loadRunManifest(productDir: string, runId: unknown): RunManifest | null;
-export declare function listRunManifests(productDir: string): RunManifest[];
-export declare function requireSafeRunId(value: unknown, label: string): string;
-export declare function normalizeRunManifest(value: unknown): RunManifest | null;
-export declare function formatRunSummary(manifest: unknown): string;

package/dist/process/runs/ownership.d.ts

@@ -1,11 +0,0 @@
-import { observeProcessCreationIdentity } from "../index.js";
-export interface TerminalRunDatabaseCleanupAuthority {
-    finishedAt: string;
-    incarnationId: string;
-    pid: number;
-    processIdentity: null | string;
-    runId: string;
-    status: "failed" | "finished" | "interrupted";
-}
-export declare function hasActiveRunManifest(productDir: string, observeIdentity?: typeof observeProcessCreationIdentity): boolean;
-export declare function hasActiveRunManifestWithTerminalAuthority(productDir: string, observeIdentity: typeof observeProcessCreationIdentity, terminalRunAuthority?: Readonly<TerminalRunDatabaseCleanupAuthority>): boolean;

package/dist/process/runs/product-state.d.ts

@@ -1,2 +0,0 @@
-export declare function resolveContainedTestkitStateDirectory(productDir: string, ...segments: readonly string[]): string;
-export declare function requireContainedTestkitStateDirectory(productDir: string, candidateDirectory: string, label?: string): string;

package/dist/process/runs/schema.d.ts

@@ -1,3 +0,0 @@
-export declare const RUN_MANIFEST_SCHEMA_VERSION: 3;
-export declare const RUN_MAINTENANCE_STOP_REQUEST_SCHEMA_VERSION: 2;
-export declare function isTerminalRunStatus(status: unknown): status is "failed" | "finished" | "interrupted";

package/dist/process/runs/stop.d.ts

@@ -1,19 +0,0 @@
-import { type RunManifest, type RunManifestService } from "./manifest.js";
-export interface PreparedRunStop {
-    requestedAt: string;
-    controllerActive: boolean;
-    coordinatorProcessIdentity: null | string;
-    graceMs: number;
-    manifest: RunManifest;
-    pid: number;
-    productDir: string;
-    reason: string;
-    runId: string;
-    targetProcessIdentity: null | string;
-}
-export declare function isPidRunning(pid: unknown): boolean;
-export declare function waitForPreparedRunStop(prepared: Readonly<PreparedRunStop>): Promise<Set<string>>;
-export declare function drainRunServices(services: readonly RunManifestService[], drainedServices: Set<string>): Promise<void>;
-export declare function requestProcessStop(pid: number, expectedIdentity: null | string, signal: NodeJS.Signals | number): void;
-export declare function runManifestServiceKey(service: Readonly<RunManifestService>): string;
-export declare function sameRunManifestIncarnation(left: Readonly<RunManifest>, right: Readonly<RunManifest>): boolean;

package/dist/process/runtime-socket.d.ts

@@ -1,4 +0,0 @@
-export interface RuntimeSocket {
-    host: string;
-    port: number;
-}

package/dist/process/service-processes.d.ts

@@ -1,13 +0,0 @@
-import { captureProcessCreationIdentity, processCreationIdentityMatches } from "./index.js";
-export type ProcessSignal = NodeJS.Signals;
-export interface ServiceStartInvocation {
-    args: readonly string[];
-    executable: string;
-    windowsVerbatimArguments?: boolean;
-}
-export { captureProcessCreationIdentity, processCreationIdentityMatches };
-export declare function normalizeServiceStartCommand(command: string): string;
-export declare function prepareServiceStartInvocation(command: string, env: Readonly<NodeJS.ProcessEnv>, platform?: NodeJS.Platform): ServiceStartInvocation;
-export declare function terminateAttributedProcessLineage(pid: unknown, signal: ProcessSignal, expectedCreationIdentity?: string): Promise<void>;
-export declare function terminateOwnedPosixProcessGroup(processGroupId: unknown, leaderCreationIdentity: string, graceMs: number): Promise<void>;
-export declare function sleep(ms: number, signal?: AbortSignal): Promise<void>;

package/dist/process/shutdown.d.ts

@@ -1,10 +0,0 @@
-export declare const DEFAULT_SHUTDOWN_TIMEOUT_MS = 1000;
-export declare const FORCE_TERMINATION_WAIT_MS = 3000;
-/** Import a persisted deadline without granting more than its original allowance. */
-export declare function remainingShutdownMs(timeoutMs: number, deadlineAt: number, now?: number): number;
-/** One monotonic allowance, with a wall-clock deadline for ownership handoff. */
-export declare function createShutdownDeadline(timeoutMs: number): {
-    readonly deadlineAt: number | null;
-    remainingMs: () => number;
-    begin(importedDeadlineAt?: number): boolean;
-};

package/dist/process/windows-cli-owner.d.ts

@@ -1,2 +0,0 @@
-/** CLI-only ownership: help and parser errors never start the native owner. */
-export declare function ensureWindowsCliOwnership(): Promise<void>;

package/dist/process/windows-native.d.ts

@@ -1,6 +0,0 @@
-import fs from "node:fs";
-export declare function windowsOwnerExecutable(): string;
-/** Atomically publish a complete file without replacing an existing name. */
-export declare function publishWindowsFile(source: string, destination: string): void;
-/** A rename can change ctime; require stable file identity, size, and mtime. */
-export declare function sameFileAfterRename(before: Readonly<Pick<fs.BigIntStats, "dev" | "ino" | "size" | "mtimeNs">>, after: Readonly<Pick<fs.BigIntStats, "dev" | "ino" | "size" | "mtimeNs">>): boolean;

package/dist/process/windows-process-identity.d.ts

@@ -1,4 +0,0 @@
-export declare const WINDOWS_KERNEL_PROCESS_IDENTITY_PREFIX: "windows-kernel-filetime:";
-export declare function formatWindowsKernelProcessIdentity(fileTime: string): string;
-export declare function parseWindowsKernelProcessIdentity(identity: string): string | null;
-export declare function isWindowsKernelFileTime(value: string): boolean;

package/dist/repo/ci-environment.d.ts

@@ -1,7 +0,0 @@
-export interface CiGitReference {
-    readonly branch: string | null;
-    readonly pullRequest: number | null;
-}
-export declare function readCiPullRequestHeadSha(env: Readonly<NodeJS.ProcessEnv>): string | null;
-export declare function normalizePullRequestHeadSha(value: unknown): string | null;
-export declare function resolveCiGitReference(env: Readonly<NodeJS.ProcessEnv>): CiGitReference;

package/dist/repo/fingerprint-policy.d.ts

@@ -1,15 +0,0 @@
-import type { Hash } from "crypto";
-export interface FingerprintPolicy {
-    readonly exclude: readonly string[];
-    readonly include: readonly string[];
-}
-export declare function normalizeFingerprintPolicy(value?: unknown): FingerprintPolicy;
-export declare function shouldIgnoreFingerprintPath(productDir: string, absOrRelPath: string, policy?: FingerprintPolicy): boolean;
-export declare function shouldIgnoreCanonicalFingerprintPath(relativePath: string, policy?: FingerprintPolicy): boolean;
-export declare function shouldIgnoreCanonicalFingerprintPathAtPrefix(relativePath: string, addressPrefix: string, policy?: FingerprintPolicy): boolean;
-export declare function hasIncludedFingerprintDescendantAtPrefix(relativePath: string, addressPrefix: string, policy: FingerprintPolicy): boolean;
-export declare function appendFingerprintPathToHash(hash: Hash, productDir: string, absPath: string, policy?: FingerprintPolicy): void;
-export declare function normalizeRelativePath(productDir: string, absOrRelPath: string): string;
-export declare function normalizePath(value: string): string;
-export declare function appendInputToHash(hash: Hash, productDir: string, input: string, fingerprints?: unknown): void;
-export declare function appendFileToHash(hash: Hash, productDir: string, absPath: string, fingerprints?: unknown): void;

package/dist/repo/git-path.d.ts

@@ -1,2 +0,0 @@
-/** Decode one path emitted by Git with `core.quotePath=true` and no `-z`. */
-export declare function decodeGitPathRecord(value: string): string;

package/dist/repo/history.d.ts

@@ -1,17 +0,0 @@
-export interface BlamedCommit {
-    readonly boundary: boolean;
-    readonly commit: string;
-    readonly committedAt: number;
-}
-export type IntroducingCommit = {
-    readonly commit: string;
-    readonly status: "found";
-} | {
-    readonly status: "outside-history";
-};
-export declare function findIntroducingCommit(repoRoot: string, commit: string, path: string, lines: readonly [number, number]): Promise<IntroducingCommit>;
-export declare function parseBlame(output: string): readonly BlamedCommit[];
-export declare function newestBlamedCommit(commits: readonly BlamedCommit[]): BlamedCommit | null;
-export declare function listRemoteRefsContaining(repoRoot: string, commit: string): Promise<readonly string[]>;
-export declare function listUncommittedTrackedFiles(repoRoot: string): Promise<readonly string[]>;
-export declare function listFilesChangedSince(repoRoot: string, base: string): Promise<readonly string[] | null>;

package/dist/repo/managed-git.d.ts

@@ -1,10 +0,0 @@
-import { type ManagedProcessResult } from "../process/index.js";
-export declare const DEFAULT_GIT_COMMAND_TIMEOUT_MS = 30000;
-export interface ManagedGitCommandOptions {
-    env?: Readonly<NodeJS.ProcessEnv>;
-    repositoryConfigOnly?: boolean;
-    signal?: AbortSignal;
-    timeoutMs?: number;
-}
-export declare function runManagedGitCommand(cwd: string, args: readonly string[], options?: Readonly<ManagedGitCommandOptions>): Promise<ManagedProcessResult>;
-export declare function createManagedGitEnvironment(environment: Readonly<NodeJS.ProcessEnv>, platform?: NodeJS.Platform, repositoryConfigOnly?: boolean): NodeJS.ProcessEnv;

package/dist/repo/metadata.d.ts

@@ -1,3 +0,0 @@
-import { type RepoState } from "./state.js";
-export type GitMetadata = Pick<RepoState, "branch" | "commitSha" | "detached" | "dirty" | "dirtyFingerprint" | "pullRequest" | "pullRequestHeadSha" | "remoteUrl" | "repository" | "repoRoot" | "worktreePath">;
-export declare function collectGitMetadata(productDir: string): Promise<GitMetadata>;

package/dist/repo/physical-tree.d.ts

@@ -1,37 +0,0 @@
-export type PhysicalNode = {
-    readonly kind: "ancestor-missing";
-    readonly obstaclePath: string;
-} | {
-    readonly kind: "ancestor-non-directory";
-    readonly mode: bigint;
-    readonly obstaclePath: string;
-} | {
-    readonly kind: "ancestor-symlink";
-    readonly obstaclePath: string;
-    readonly target: Buffer;
-} | {
-    readonly identity: PhysicalNodeIdentity;
-    readonly kind: "directory";
-    readonly mode: bigint;
-} | {
-    readonly contents: Buffer;
-    readonly kind: "file";
-    readonly mode: bigint;
-} | {
-    readonly kind: "missing";
-} | {
-    readonly kind: "symlink";
-    readonly target: Buffer;
-};
-export interface PhysicalNodeIdentity {
-    readonly dev: bigint;
-    readonly ino: bigint;
-    readonly type: bigint;
-}
-export declare function physicalPathAndHandleIdentitiesEqual(pathIdentity: Readonly<PhysicalNodeIdentity>, handleIdentity: Readonly<PhysicalNodeIdentity>, platform: NodeJS.Platform): boolean;
-export type PhysicalNodeType = "block-device" | "character-device" | "directory" | "fifo" | "file" | "socket" | "symlink" | "unknown";
-export declare function readPhysicalNode(rootDir: string, canonicalRelativePath: string): PhysicalNode;
-export declare function readPhysicalDirectoryEntries(rootDir: string, canonicalRelativePath: string): readonly string[];
-export declare function physicalNodeMode(mode: bigint): string;
-export declare function physicalNodeType(mode: bigint): PhysicalNodeType;
-export declare function decodePhysicalPathSegment(encoded: Uint8Array, parentPath?: string): string;

package/dist/repo/remote.d.ts

@@ -1,6 +0,0 @@
-export interface GitRepository {
-    readonly host: string;
-    readonly name: string;
-    readonly owner: string;
-}
-export declare function parseGitRepository(remoteUrl: unknown): GitRepository | null;

package/dist/repo/state.d.ts

@@ -1,26 +0,0 @@
-import { type GitRepository } from "./remote.js";
-export type RepoStateKind = "commit" | "dirty" | "nogit";
-export interface RepoState {
-    branch: string | null;
-    cacheKey: string;
-    commitSha: string | null;
-    contentFingerprint: string | null;
-    detached: boolean;
-    dirty: boolean;
-    dirtyFingerprint: string | null;
-    kind: RepoStateKind;
-    pullRequest: number | null;
-    pullRequestHeadSha: string | null;
-    remoteUrl: string | null;
-    repository: GitRepository | null;
-    repoRoot: string | null;
-    worktreePath: string;
-}
-export type RepoStateMetadata = RepoState;
-export interface CollectRepoStateOptions {
-    env?: Readonly<NodeJS.ProcessEnv>;
-    fingerprints?: unknown;
-}
-export declare function collectRepoState(productDir: string, options?: Readonly<CollectRepoStateOptions>): Promise<RepoState>;
-export declare function collectGitRepoState(productDir: string, options?: Readonly<CollectRepoStateOptions>): Promise<RepoState | null>;
-export declare function summarizeRepoStateForMetadata(repoState: Readonly<RepoState> | null | undefined): RepoStateMetadata | null;

package/dist/repo/tree-listing.d.ts

@@ -1,10 +0,0 @@
-export interface CommitFile {
-    readonly path: string;
-    readonly size: number;
-}
-export interface TreeListing {
-    readonly directories: readonly string[];
-    readonly files: readonly CommitFile[];
-}
-export declare function listCommitFiles(repoRoot: string, commit: string): Promise<readonly CommitFile[]>;
-export declare function parseTreeListing(output: string, directory?: string): TreeListing;

package/dist/steps/build-config.d.ts

@@ -1,35 +0,0 @@
-import { type NormalizedConfiguredStep } from "./configured-steps.js";
-export type { BuildConfigInput, BuildConfigInputBase, NextBuildConfigInput, ScriptBuildConfigInput, StepsBuildConfigInput, TscBuildConfigInput, } from "../config/authoring/build-config-contract.js";
-export interface NormalizedBuildConfigBase {
-    inputs: string[];
-}
-export interface NormalizedTscBuildConfig extends NormalizedBuildConfigBase {
-    cwd: string | null;
-    entry: string;
-    kind: "tsc";
-    outDir: string;
-    tsconfig: string;
-}
-export interface NormalizedScriptBuildConfig extends NormalizedBuildConfigBase {
-    cwd: string | null;
-    kind: "script";
-    script: string;
-}
-export interface NormalizedNextBuildConfig extends NormalizedBuildConfigBase {
-    cwd: string | null;
-    distDir: string;
-    kind: "next";
-    tsconfig: string;
-}
-export interface NormalizedStepsBuildConfig extends NormalizedBuildConfigBase {
-    kind: "steps";
-    steps: NormalizedConfiguredStep[];
-}
-export type NormalizedBuildConfig = NormalizedTscBuildConfig | NormalizedScriptBuildConfig | NormalizedNextBuildConfig | NormalizedStepsBuildConfig;
-export interface NormalizedBuildPrepareConfig {
-    inputs: string[];
-    steps: NormalizedConfiguredStep[];
-}
-export declare function normalizeBuildConfig(value: unknown, label: string): NormalizedBuildConfig | null;
-export declare function buildConfigToPrepare(build: NormalizedBuildConfig | null | undefined): NormalizedBuildPrepareConfig;
-export declare function compiledEntryFromBuild(build: NormalizedBuildConfig | null | undefined): string | null;

package/dist/steps/configured-step-testkit-modules.d.ts

@@ -1,19 +0,0 @@
-/** Public Testkit modules available to Node-hosted lifecycle steps. */
-export declare const CONFIGURED_STEP_TESTKIT_MODULE_SPECIFIERS: readonly ["@gfdelarue/testkit", "@gfdelarue/testkit/config", "@gfdelarue/testkit/config/build-assets", "@gfdelarue/testkit/config/database-steps", "@gfdelarue/testkit/config/next-runtime-tsconfig", "@gfdelarue/testkit/drizzle", "@gfdelarue/testkit/env", "@gfdelarue/testkit/tooling/vitest"];
-export type ConfiguredStepTestkitModuleSpecifier = (typeof CONFIGURED_STEP_TESTKIT_MODULE_SPECIFIERS)[number];
-/**
- * Where each configured-step module lives under dist/, as extensionless path
- * segments. Runtime entry points append ".js"; type lookups append ".d.ts".
- */
-export declare const CONFIGURED_STEP_TESTKIT_MODULE_DIST_PATHS: {
-    readonly "@gfdelarue/testkit": readonly ["index"];
-    readonly "@gfdelarue/testkit/config": readonly ["config", "authoring", "index"];
-    readonly "@gfdelarue/testkit/config/build-assets": readonly ["config", "runtime", "build-assets"];
-    readonly "@gfdelarue/testkit/config/database-steps": readonly ["database", "steps"];
-    readonly "@gfdelarue/testkit/config/next-runtime-tsconfig": readonly ["config", "runtime", "next-runtime-tsconfig"];
-    readonly "@gfdelarue/testkit/drizzle": readonly ["database", "drizzle", "index"];
-    readonly "@gfdelarue/testkit/env": readonly ["config", "runtime", "env", "index"];
-    readonly "@gfdelarue/testkit/tooling/vitest": readonly ["toolchains", "vitest", "index"];
-};
-export declare function isTestkitPackageSpecifier(specifier: string): boolean;
-export declare function requireConfiguredStepTestkitModuleSpecifier(specifier: string): ConfiguredStepTestkitModuleSpecifier;

package/dist/steps/configured-steps.d.ts

@@ -1,51 +0,0 @@
-import type { ConfiguredStepInput } from "../config/authoring/configured-step-contract.js";
-export type { ConfiguredCommandStepInput, ConfiguredModuleStepInput, ConfiguredSqlFileStepInput, ConfiguredStepBaseInput, ConfiguredStepInput, } from "../config/authoring/configured-step-contract.js";
-export type JsonValue = boolean | null | number | string | JsonValue[] | {
-    [key: string]: JsonValue;
-};
-export interface NormalizedConfiguredStepBase {
-    args?: JsonValue;
-    cwd?: string | null;
-    inputs: string[];
-}
-export interface NormalizedConfiguredCommandStep extends NormalizedConfiguredStepBase {
-    cmd: string;
-    kind: "command";
-}
-export interface NormalizedConfiguredSqlFileStep extends NormalizedConfiguredStepBase {
-    kind: "sql-file";
-    path: string;
-}
-export interface NormalizedConfiguredModuleStep extends NormalizedConfiguredStepBase {
-    kind: "module";
-    specifier: string;
-}
-export type NormalizedConfiguredStep = NormalizedConfiguredCommandStep | NormalizedConfiguredSqlFileStep | NormalizedConfiguredModuleStep;
-export type ConfiguredStepReference = ConfiguredStepInput | NormalizedConfiguredStep;
-export interface ConfiguredStepCollection {
-    inputs?: readonly string[];
-    steps?: readonly ConfiguredStepReference[];
-}
-export interface ConfiguredStepCollectionValidation extends ConfiguredStepCollection {
-    label: string;
-    productDir: string;
-}
-export type ConfiguredStringTransform = (value: string) => string;
-export declare function normalizeOptionalString(value: unknown): string | null;
-export declare function normalizeConfiguredInputs(value: unknown, label: string): string[];
-export declare function normalizeConfiguredSteps(value: unknown, label: string): NormalizedConfiguredStep[];
-export declare function normalizeConfiguredStep(step: unknown, label: string): NormalizedConfiguredStep;
-export declare function parseModuleSpecifier(specifier: unknown): {
-    exportName: string;
-    modulePath: string;
-};
-export declare function normalizeStepArgs(value: unknown, label: string): JsonValue | undefined;
-export declare function isBareModuleSpecifier(modulePath: unknown): boolean;
-export declare function resolveConfiguredCwd(productDir: string, stepCwd: string | null | undefined): string;
-export declare function resolveConfiguredPath(productDir: string, stepCwd: string | null | undefined, targetPath: string): string;
-export declare function collectConfiguredInputs(productDir: string, { inputs, steps }?: ConfiguredStepCollection): string[];
-export declare function summarizeConfiguredStep(step: NormalizedConfiguredStep): string;
-export declare function finalizeConfiguredInputs(inputs: readonly string[] | undefined, transform: ConfiguredStringTransform): string[];
-export declare function finalizeConfiguredStep(step: NormalizedConfiguredStep, transform: ConfiguredStringTransform): NormalizedConfiguredStep;
-export declare function finalizeConfiguredSteps(steps: readonly NormalizedConfiguredStep[] | undefined, transform: ConfiguredStringTransform): NormalizedConfiguredStep[];
-export declare function validateConfiguredCollection({ productDir, label, inputs, steps, }: ConfiguredStepCollectionValidation): void;

package/dist/steps/environment.d.ts

@@ -1,84 +0,0 @@
-type RuntimeIdentifier = number | string;
-export type RuntimeUrlMapping = readonly [false | null | string | undefined, string];
-type StringMap = ReadonlyMap<string, string>;
-export interface ExecutionEnvironmentLease {
-    leaseDir?: null | string;
-    leaseId?: null | RuntimeIdentifier;
-}
-export interface BuildExecutionEnvironmentOptions {
-    includeTestkitControls?: boolean;
-    inheritProcessEnv?: boolean;
-    mode?: string;
-    omitRuntimeDatabaseBindings?: boolean;
-}
-export interface DatabaseTemplateBindings {
-    database: string;
-    host: string;
-    password: string;
-    port: number | string;
-    sslMode: string;
-    url: string;
-    user: string;
-}
-export type DatabaseTemplateBindingsReader = (stateDir: string) => DatabaseTemplateBindings | null;
-export interface DatabasePlaceholder {
-    placeholder: string;
-    serviceName: null | string;
-}
-export interface ExecutionTemplateContextValues {
-    [key: string]: unknown;
-    baseUrlByService?: StringMap;
-    databaseBindingsByService?: ReadonlyMap<string, Readonly<DatabaseTemplateBindings> | null>;
-    databaseBindingsReader?: DatabaseTemplateBindingsReader;
-    leaseDir?: null | string;
-    leaseId?: null | RuntimeIdentifier;
-    portMap?: ReadonlyMap<string, number>;
-    prepareDir?: null | string;
-    privateBaseUrlByService?: StringMap;
-    productDir?: null | string;
-    publicBaseUrlByService?: StringMap;
-    publicHost?: null | string;
-    readyUrlByService?: StringMap;
-    runtimeDir?: string;
-    runtimeId?: null | RuntimeIdentifier;
-    runtimeLabel?: null | RuntimeIdentifier;
-    serviceContextUrlByService?: StringMap;
-    serviceCwd?: null | string;
-    serviceName?: string;
-    serviceStateDir?: null | string;
-    stateDirByService?: StringMap;
-    urlMappings?: readonly RuntimeUrlMapping[];
-}
-export interface ExecutionEnvironmentLocalConfig {
-    env?: Readonly<Record<string, string>>;
-}
-export interface ExecutionEnvironmentTestkitConfig {
-    local?: ExecutionEnvironmentLocalConfig | null;
-    mode?: string;
-    prepareDir?: null | string;
-    serviceEnv?: Readonly<Record<string, string>>;
-    templateContext?: ExecutionTemplateContextValues;
-    ui?: unknown;
-}
-export interface ExecutionEnvironmentConfig {
-    name: string;
-    productDir: string;
-    runtimeId?: null | RuntimeIdentifier;
-    runtimeLabel?: null | RuntimeIdentifier;
-    stateDir?: null | string;
-    testkit: ExecutionEnvironmentTestkitConfig;
-}
-export interface TemplateResolutionContext extends ExecutionTemplateContextValues {
-    serviceName: string;
-}
-export declare function buildExecutionEnv(config: Readonly<ExecutionEnvironmentConfig>, extraEnv?: Readonly<NodeJS.ProcessEnv> | null, processEnv?: Readonly<NodeJS.ProcessEnv> | null, options?: Readonly<BuildExecutionEnvironmentOptions>): NodeJS.ProcessEnv;
-export declare function buildTemplateExecutionEnv(config: Readonly<ExecutionEnvironmentConfig>, extraEnv?: Readonly<NodeJS.ProcessEnv> | null, processEnv?: Readonly<NodeJS.ProcessEnv> | null, options?: Readonly<BuildExecutionEnvironmentOptions>): NodeJS.ProcessEnv;
-export declare function buildTaskExecutionEnv(config: Readonly<ExecutionEnvironmentConfig>, lease: Readonly<ExecutionEnvironmentLease> | null, extraEnv?: Readonly<NodeJS.ProcessEnv> | null, processEnv?: Readonly<NodeJS.ProcessEnv> | null, options?: Readonly<BuildExecutionEnvironmentOptions>): NodeJS.ProcessEnv;
-export declare function resolveExecutionEnvValues(config: Readonly<ExecutionEnvironmentConfig>, names: readonly string[], processEnv?: Readonly<NodeJS.ProcessEnv> | null): NodeJS.ProcessEnv;
-export declare function buildTemplateContext(config: Readonly<ExecutionEnvironmentConfig>, lease: Readonly<ExecutionEnvironmentLease> | null): TemplateResolutionContext;
-export declare function finalizeString(value: string, context: TemplateResolutionContext): string;
-export declare function finalizeSerializable(value: unknown, context: TemplateResolutionContext): unknown;
-export declare function resolveTemplateString(value: string, context: TemplateResolutionContext): string;
-export declare function resolveTemplateString(value: unknown, context: TemplateResolutionContext): unknown;
-export declare function findDatabasePlaceholders(value: string): DatabasePlaceholder[];
-export {};

package/dist/steps/index.d.ts

@@ -1,2 +0,0 @@
-export { buildExecutionEnv, buildTaskExecutionEnv, buildTemplateContext, buildTemplateExecutionEnv, finalizeSerializable, finalizeString, findDatabasePlaceholders, resolveExecutionEnvValues, resolveTemplateString, type BuildExecutionEnvironmentOptions, type DatabasePlaceholder, type DatabaseTemplateBindings, type DatabaseTemplateBindingsReader, type ExecutionEnvironmentConfig, type ExecutionEnvironmentLease, type ExecutionEnvironmentLocalConfig, type ExecutionEnvironmentTestkitConfig, type ExecutionTemplateContextValues, type RuntimeUrlMapping, type TemplateResolutionContext, } from "./environment.js";
-export { collectConfiguredInputs, configuredCommandInvocation, parseModuleSpecifier, resolveConfiguredCwd, resolveConfiguredPath, type ConfiguredCommandInvocation, type ConfiguredStepReporter, type ConfiguredStepServiceConfig, } from "./run.js";

package/dist/steps/module-runner.d.ts

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

package/dist/steps/run.d.ts

@@ -1,36 +0,0 @@
-import { type CaptureStepOutputOptions } from "../evidence/step-output.js";
-import { type NormalizedConfiguredStep } from "./configured-steps.js";
-export { collectConfiguredInputs, parseModuleSpecifier, resolveConfiguredCwd, resolveConfiguredPath, } from "./configured-steps.js";
-import { type ResolvedNodeToolchain, type ToolchainEnvironment, type ToolchainReportConfig, type ToolchainResolvedReporter, type ToolchainRuntimeConfig } from "../toolchains/index.js";
-import type { SetupOperationHandle } from "../evidence/setup-progress.js";
-import type { OwnedPostgresContainerRoute } from "../domain/postgres-route.js";
-import { type OutputLineHandler } from "../process/index.js";
-type RuntimeIdentifier = number | string;
-export interface ConfiguredStepServiceConfig extends ToolchainRuntimeConfig, ToolchainReportConfig {
-    runtimeId?: RuntimeIdentifier | null;
-    stateDir?: string | null;
-    testkit: NonNullable<ToolchainRuntimeConfig["testkit"]> & {
-        prepareDir?: string | null;
-    };
-}
-export interface ConfiguredStepReporter extends ToolchainResolvedReporter<ConfiguredStepServiceConfig> {
-    outputMode?: string;
-    phaseStarted?: (label: string) => unknown;
-    setupOperationFinished?: (operation: SetupOperationHandle) => unknown;
-    writeDebugLine?: OutputLineHandler;
-}
-export interface ConfiguredCommandInvocation {
-    readonly args: readonly string[];
-    readonly command: string;
-    readonly windowsVerbatimArguments?: boolean;
-}
-interface RunConfiguredStepOptions extends CaptureStepOutputOptions {
-    ownedContainer?: OwnedPostgresContainerRoute | null;
-    signal?: AbortSignal;
-    timeoutMs: number;
-}
-export declare function runConfiguredStep(config: ConfiguredStepServiceConfig, step: Exclude<NormalizedConfiguredStep, {
-    kind: "sql-file";
-}>, runtimeEnv: Readonly<ToolchainEnvironment>, resolvedToolchain: ResolvedNodeToolchain | null, options: Readonly<RunConfiguredStepOptions>): Promise<void>;
-export declare function configuredCommandInvocation(command: string, env: Readonly<NodeJS.ProcessEnv>, platform?: NodeJS.Platform): ConfiguredCommandInvocation;
-export declare function applySetupNodeOptions(env?: Readonly<ToolchainEnvironment>): ToolchainEnvironment;

package/dist/toolchains/archive.d.ts

@@ -1,53 +0,0 @@
-export declare const ARCHIVE_FORMATS: readonly ["tar", "tar.gz", "zip"];
-export declare const MAX_ARCHIVE_ENTRIES = 100000;
-export type ArchiveFormat = (typeof ARCHIVE_FORMATS)[number];
-export type ArchiveEntryKind = "directory" | "file" | "symlink";
-export interface ArchiveEntry {
-    readonly kind: ArchiveEntryKind | "forbidden";
-    readonly linkTarget?: string;
-    readonly mode: number;
-    readonly path: string;
-    readonly rawType: string;
-    readonly sizeBytes: number;
-}
-export interface ArchiveInspectionOptions {
-    readonly maxEntries?: number;
-    readonly maxUnpackedSizeBytes?: number;
-    readonly signal?: AbortSignal;
-}
-export interface ArchiveInspector {
-    readonly formats: readonly ArchiveFormat[];
-    inspect(archivePath: string, format: ArchiveFormat, options?: Readonly<ArchiveInspectionOptions>): Promise<readonly ArchiveEntry[]>;
-}
-export interface ArchiveExtractor extends ArchiveInspector {
-    extract(archivePath: string, destination: string, format: ArchiveFormat, options?: Readonly<ArchiveInspectionOptions>): Promise<void>;
-}
-export declare class UnsafeArchiveError extends Error {
-    readonly code = "TESTKIT_ARCHIVE_UNSAFE";
-    constructor(message: string, options?: ErrorOptions);
-}
-export declare class TarArchiveInspector implements ArchiveInspector {
-    readonly formats: readonly ["tar", "tar.gz"];
-    inspect(archivePath: string, format: ArchiveFormat, options?: Readonly<ArchiveInspectionOptions>): Promise<readonly ArchiveEntry[]>;
-}
-export declare class ZipArchiveExtractor implements ArchiveExtractor {
-    readonly formats: readonly ["zip"];
-    inspect(archivePath: string, format: ArchiveFormat, options?: Readonly<ArchiveInspectionOptions>): Promise<readonly ArchiveEntry[]>;
-    extract(archivePath: string, destination: string, format: ArchiveFormat, options?: Readonly<ArchiveInspectionOptions>): Promise<void>;
-}
-/**
- * Validates archive paths and the complete symbolic-link graph independently
- * of a caller's exact entry and byte counts. Extractors call this before writing
- * anything so a caller cannot bypass the topology checks by using extract()
- * directly.
- */
-export declare function validateArchiveEntryTopology(entries: readonly ArchiveEntry[]): void;
-export declare function assertSafeArchiveEntry(entry: Readonly<ArchiveEntry>): string;
-export declare function normalizeArchivePath(value: string): string;
-export declare function portableCollisionKey(value: string): string;
-export declare function normalizeSymlinkTarget(value: string, linkPath: string): string;
-export declare function assertInstalledSymlinkTarget(linkPath: string, relativeLinkPath: string, realRoot: string): Promise<void>;
-export declare function decodeUtf8(value: Buffer, label: string): string;
-export declare function requireSafeMode(value: number, entryPath: string): number;
-export declare function requireSafeSize(value: number, entryPath: string): number;
-export declare function throwIfAborted(signal?: AbortSignal): void;

package/dist/toolchains/esbuild.d.ts

@@ -1,9 +0,0 @@
-import { build, type BuildOptions, type BuildResult } from "esbuild";
-export interface EsbuildRetryOptions {
-    attemptTimeoutMs?: unknown;
-    retries?: unknown;
-}
-type EsbuildBuildOptions<T extends BuildOptions> = Parameters<typeof build<T>>[0];
-export declare function buildWithEsbuildRetry<T extends BuildOptions>(options: EsbuildBuildOptions<T>, retryOptions?: EsbuildRetryOptions): Promise<BuildResult<T>>;
-export declare function isEsbuildServiceStoppedError(error: unknown): boolean;
-export {};