@gfdelarue/testkit 0.4.5 → 0.6.0

package/dist/app/db-schema/refresh.d.ts

@@ -1,17 +0,0 @@
-import type { SourceSchemaDumpResolution } from "../../database/source-url.js";
-import { type ConfiguredStepReporter } from "../../steps/index.js";
-import { type SchemaOperationOptions } from "./prepare.js";
-export type DatabaseSchemaRefreshOptions = SchemaOperationOptions;
-export interface DatabaseSchemaRefreshResult {
-    cacheKey: string;
-    cacheKind: string;
-    envName: null | string;
-    ok: true;
-    outputLabel: string;
-    outputPath: string;
-    productDir: string;
-    reusedExistingRefresh: boolean;
-    service: string;
-    sourceUrl: SourceSchemaDumpResolution["metadata"] | null;
-}
-export declare function executeDatabaseSchemaRefresh(options: Readonly<DatabaseSchemaRefreshOptions>, reporter: ConfiguredStepReporter): Promise<DatabaseSchemaRefreshResult>;

package/dist/app/db-schema/verify.d.ts

@@ -1,11 +0,0 @@
-import { type ConfiguredStepReporter } from "../../steps/index.js";
-import { type SchemaOperationOptions } from "./prepare.js";
-export interface DatabaseSchemaVerifyOptions extends SchemaOperationOptions {
-    "skip-schema-source-verify"?: boolean;
-}
-export interface DatabaseSchemaVerifyResult {
-    ok: true;
-    productDir: string;
-    service: string;
-}
-export declare function executeDatabaseSchemaVerify(options: Readonly<DatabaseSchemaVerifyOptions>, reporter: ConfiguredStepReporter): Promise<DatabaseSchemaVerifyResult>;

package/dist/app/destroy/index.d.ts

@@ -1,16 +0,0 @@
-import { type NormalizedServiceConfig } from "../../config/loader/index.js";
-export interface DestroyOptions {
-    destroyOwnedResources?: boolean;
-}
-export declare function destroy(productDir: string, configs: readonly Readonly<NormalizedServiceConfig>[], options?: Readonly<DestroyOptions>): Promise<void>;
-export declare function destroyEnvironment(options: Readonly<{
-    dir?: string;
-    service?: string;
-}>): Promise<{
-    ok: true;
-    productDir: string;
-    results: Array<{
-        destroyed: true;
-        name: string;
-    }>;
-}>;

package/dist/app/discover/index.d.ts

@@ -1,8 +0,0 @@
-import { type DiscoverTestsOptions, type DiscoveryResult } from "../../config/loader/index.js";
-export interface DiscoverOperationResult extends DiscoveryResult {
-    outputLabel: null | string;
-}
-export declare function executeDiscoverOperation(options: Readonly<Omit<DiscoverTestsOptions, "file"> & {
-    file?: readonly string[];
-    output?: string;
-}>, cwd?: string): Promise<DiscoverOperationResult>;

package/dist/app/doctor/index.d.ts

@@ -1,17 +0,0 @@
-import { type LintViolation } from "../lint/index.js";
-export interface DoctorOptions {
-    dir?: string;
-    typecheck?: boolean;
-}
-export interface DoctorCheck {
-    code: "config-load" | "discovery" | "lint" | "typecheck";
-    details?: LintViolation[] | unknown[];
-    level: "fail" | "pass";
-    message: string;
-}
-export interface DoctorResult {
-    checks: DoctorCheck[];
-    ok: boolean;
-    productDir: string;
-}
-export declare function runDoctor(options?: DoctorOptions): Promise<DoctorResult>;

package/dist/app/environments/config-driven.d.ts

@@ -1,5 +0,0 @@
-import type { Environment, EnvironmentEntry, EnvironmentLease } from "../run/environment.js";
-import type { ReadyEnvironment } from "../../environment/ready-environment.js";
-import type { ProvisionedRun } from "../../environment/run-environment.js";
-export declare function createConfigDrivenEnvironments(run: ProvisionedRun): EnvironmentEntry;
-export declare function renderEnvironment(ready: Readonly<ReadyEnvironment>, targetName: string, lease: Readonly<EnvironmentLease>): Environment;

package/dist/app/environments/routing.d.ts

@@ -1,6 +0,0 @@
-import type { Environment, EnvironmentEntry } from "../run/environment.js";
-import type { NormalizedServiceConfig } from "../../config/loader/index.js";
-export declare function declaresProvisioning(runtimeConfigs: readonly NormalizedServiceConfig[]): boolean;
-export declare function routeEnvironments(sourcesByGraph: ReadonlyMap<string, EnvironmentEntry>): EnvironmentEntry;
-export type EnvironmentHold = (owner: string, environment: Environment) => Promise<void>;
-export declare function holdBeforeRelease(entry: EnvironmentEntry, hold: EnvironmentHold): EnvironmentEntry;

package/dist/app/environments/supplied.d.ts

@@ -1,3 +0,0 @@
-import type { Environment, EnvironmentEntry } from "../run/environment.js";
-export type SuppliedEnvironment = Partial<Environment>;
-export declare function createSuppliedEnvironments(nativeConfigDirectories: Readonly<Record<string, string>>, supplied?: Readonly<Record<string, SuppliedEnvironment>>): EnvironmentEntry;

package/dist/app/file-selection.d.ts

@@ -1 +0,0 @@
-export declare function resolveRequestedFiles(fileNames: unknown, productDir: unknown, invocationCwd?: unknown): string[];

package/dist/app/inspect/artifacts.d.ts

@@ -1,30 +0,0 @@
-export declare function inspectArtifacts(options: Readonly<{
-    dir?: string;
-    mode: "runs" | "verify" | "artifacts";
-    file: string | null;
-    runId: string | null;
-    service: string | null;
-    kind?: string;
-    includePayload?: boolean;
-}>): {
-    mode: "runs";
-    runs: import("../../evidence/contracts.js").RunBundleSummary[];
-    verification?: undefined;
-    runId?: undefined;
-    entries?: undefined;
-} | {
-    runs?: undefined;
-    mode: "verify";
-    runId: string | null;
-    verification: import("../../evidence/contracts.js").RunBundleVerification;
-    entries?: undefined;
-} | {
-    runs?: undefined;
-    verification?: undefined;
-    mode: "artifacts";
-    runId: string | null;
-    entries: import("../../evidence/reading.js").CollectedArtifactEntry[];
-};
-export type ArtifactInspectionEntry = Extract<ReturnType<typeof inspectArtifacts>, {
-    mode: "artifacts";
-}>["entries"][number];

package/dist/app/inspect/index.d.ts

@@ -1,112 +0,0 @@
-export { formatTestTypeLabel } from "../../domain/test-types.js";
-import type { RunArtifactSuite } from "../../evidence/index.js";
-import { type EngineId, type RunnerProfileId } from "../../domain/identifiers.js";
-import { type DiscoveryDiagnostic, type DiscoveryResult, type DiscoverySummary } from "../../config/loader/index.js";
-import type { StatusModel } from "../status/model.js";
-export { discoverTests, fileDisplayName, formatDisplayName, testTypeContract } from "../../config/loader/index.js";
-export type { DiscoverTestsOptions, DiscoveryDiagnostic, DiscoveryFile, DiscoveryResult, DiscoveryService, DiscoverySuite, DiscoverySummary, DiscoveryTestContract, DiscoveryTestType, RuntimeIsolationPolicy, } from "../../config/loader/index.js";
-export { listRunBundles, loadRunBundleArtifact, loadRunBundleManifest, verifyRunBundle } from "../../evidence/index.js";
-export type { RunBundleVerification } from "../../evidence/index.js";
-declare const WORKSPACE_SCHEMA_VERSION: 2;
-export type WorkspaceTargetKind = "file" | "project" | "suite";
-export type WorkspaceTargetSource = "discovery" | "latest" | "live";
-export type WorkspaceRunSource = "latest" | "live";
-export interface WorkspaceTargetRef {
-    detail: string;
-    engineId?: null | EngineId;
-    filePath?: string;
-    id: string;
-    kind: WorkspaceTargetKind;
-    label: string;
-    profileId?: null | RunnerProfileId;
-    runnable: boolean;
-    service?: null | string;
-    source: WorkspaceTargetSource;
-    status?: null | string;
-    suiteName?: null | string;
-    testType?: null | RunArtifactSuite["testType"];
-}
-export interface WorkspaceRunSummary {
-    durationMs: null | number;
-    files: {
-        failed: number;
-        notRun: number;
-        passed: number;
-        skipped: number;
-        total: number;
-    };
-    generatedAt: null | string;
-    id: null | string;
-    services: {
-        failed: number;
-        passed: number;
-        skipped: number;
-        total: number;
-    };
-    source: WorkspaceRunSource;
-    startedAt: null | string;
-    status: string;
-    suites: {
-        completed: number;
-        failed: number;
-        passed: number;
-        skipped: number;
-        total: number;
-    };
-    types: string[];
-}
-export interface WorkspaceRuntimeGraphStatus {
-    currentRuntimeDirCount: number;
-    desired: StatusModel["runtimeGraphs"][number]["desired"];
-    exists: boolean;
-    name: string;
-    orphan: boolean;
-    runtimeDirCount: number;
-    staleRuntimeDirCount: number;
-}
-export interface WorkspaceServiceStatus {
-    caches: StatusModel["caches"];
-    hasState: boolean;
-    name: string;
-    product: StatusModel["product"];
-    runtimeGraphs: WorkspaceRuntimeGraphStatus[];
-    runs: {
-        active: number;
-        stale: number;
-        total: number;
-    };
-    warnings: string[];
-}
-export interface WorkspaceStatus {
-    ok: boolean;
-    results: WorkspaceServiceStatus[];
-}
-export interface WorkspaceInspection {
-    activity: {
-        activeRuns: number;
-        staleRuns: number;
-    };
-    discovery: {
-        configFile: null | string;
-        diagnostics: DiscoveryDiagnostic[];
-        summary: DiscoverySummary;
-    } | null;
-    generatedAt: string;
-    product: DiscoveryResult["product"];
-    runs: {
-        latest: WorkspaceRunSummary | null;
-        live: WorkspaceRunSummary | null;
-    };
-    schemaVersion: typeof WORKSPACE_SCHEMA_VERSION;
-    source: "testkit-workspace";
-    status: WorkspaceStatus;
-    targets: WorkspaceTargetRef[];
-    warnings: string[];
-}
-export interface InspectWorkspaceOptions {
-    dir?: string;
-    service?: null | string;
-    status?: boolean;
-    targetLimit?: number;
-}
-export declare function inspectWorkspace(options?: Readonly<InspectWorkspaceOptions>): Promise<WorkspaceInspection>;

package/dist/app/lint/index.d.ts

@@ -1,28 +0,0 @@
-interface LintOperationFlags {
-    dir?: string;
-}
-export declare function executeLintOperation(flags?: LintOperationFlags): Promise<LintResult>;
-import { type LintOptionsInput, type NormalizedLintOptions } from "./options.js";
-import { type LintFinding } from "./shared.js";
-export interface RunLintOptions extends LintOptionsInput {
-    dir?: string;
-}
-export interface RunLintForConfigOptions {
-    dir?: string;
-}
-export type LintViolation = LintFinding;
-export interface LintSummary {
-    files: number;
-    testkitFiles: number;
-    violations: number;
-}
-export interface LintResult {
-    ok: boolean;
-    productDir: string;
-    summary: LintSummary;
-    violations: LintViolation[];
-}
-export declare function runLint(options?: RunLintOptions): Promise<LintResult>;
-export declare function runLintForConfig(config: unknown, options?: RunLintForConfigOptions): Promise<LintResult>;
-export declare function normalizeLintConfig(config?: unknown): NormalizedLintOptions;
-export {};

package/dist/app/lint/native.d.ts

@@ -1,10 +0,0 @@
-import { type NormalizedLintOptions } from "./options.js";
-import { type LintFinding } from "./shared.js";
-interface LintProjectInput {
-    productDir: string;
-    files: readonly string[];
-    trackedFiles: readonly string[] | null;
-    options: NormalizedLintOptions;
-}
-export declare function lintProject({ productDir, files, trackedFiles, options, }: LintProjectInput): Promise<LintFinding[]>;
-export {};

package/dist/app/lint/options.d.ts

@@ -1,66 +0,0 @@
-export interface LintRulePolicy {
-    allowed?: string[];
-    enabled: boolean;
-    exclude: string[];
-    include: string[];
-    ruleId: string;
-    ruleName: LintRuleName;
-    trackedOnly?: boolean;
-}
-export interface LintRuleOptionsInput {
-    allowed?: readonly string[];
-    enabled?: boolean;
-    exclude?: readonly string[];
-    include?: readonly string[];
-    trackedOnly?: boolean;
-}
-export type LintRuleInput = boolean | LintRuleOptionsInput;
-export interface LintOptionsInput {
-    rules?: Partial<Record<LintRuleName, LintRuleInput>>;
-    ui?: {
-        maxLines?: number;
-        maxTests?: number;
-    };
-}
-export interface NormalizedLintOptions {
-    rules: LintRulePolicies;
-    ui: {
-        maxLines: number;
-        maxTests: number;
-    };
-}
-export declare const LINT_RULE_NAMES: readonly ["engineImports", "uiSpecShape", "dalParallelSafety", "dataSuiteContract", "configImports", "testkitBoundary", "unitTestBoundaries"];
-export type LintRuleName = (typeof LINT_RULE_NAMES)[number];
-export type LintRulePolicies = Record<LintRuleName, LintRulePolicy>;
-export declare const RULES: {
-    readonly engineImports: {
-        readonly ruleId: "engine-imports";
-        readonly defaultEnabled: true;
-    };
-    readonly uiSpecShape: {
-        readonly ruleId: "ui-spec-shape";
-        readonly defaultEnabled: true;
-    };
-    readonly dalParallelSafety: {
-        readonly ruleId: "dal-parallel-safety";
-        readonly defaultEnabled: true;
-    };
-    readonly dataSuiteContract: {
-        readonly ruleId: "data-suite-contract";
-        readonly defaultEnabled: true;
-    };
-    readonly configImports: {
-        readonly ruleId: "config-imports";
-        readonly defaultEnabled: true;
-    };
-    readonly testkitBoundary: {
-        readonly ruleId: "testkit-boundary";
-        readonly defaultEnabled: false;
-    };
-    readonly unitTestBoundaries: {
-        readonly ruleId: "unit-test-boundaries";
-        readonly defaultEnabled: false;
-    };
-};
-export declare function normalizeLintConfig(config?: unknown): NormalizedLintOptions;
-export declare function normalizeLintOptions(options?: LintOptionsInput): NormalizedLintOptions;

package/dist/app/lint/policy.d.ts

@@ -1,21 +0,0 @@
-import type { TSESLint, TSESTree } from "@typescript-eslint/utils";
-import type { NormalizedLintOptions } from "./options.js";
-export type PolicyContext = TSESLint.RuleContext<"violation", []>;
-export type Report = (node: TSESTree.Node, kind: string, target: string, message: string) => void;
-export interface LiteralFact {
-    field: string;
-    value: string;
-    file: string;
-    line: number;
-    snippet: string;
-}
-export interface PolicyInput {
-    context: PolicyContext;
-    file: string;
-    report: Report;
-    options: NormalizedLintOptions;
-    literals: LiteralFact[];
-}
-export declare function stringValue(node: TSESTree.Node | null | undefined): string | null;
-export declare function memberName(node: TSESTree.MemberExpression): string | null;
-export declare function binding(context: PolicyContext, node: TSESTree.Identifier): TSESLint.Scope.Variable | null;

package/dist/app/lint/rules/data.d.ts

@@ -1,3 +0,0 @@
-import type { TSESLint } from "@typescript-eslint/utils";
-import { type PolicyInput } from "../policy.js";
-export declare function createDataPolicy({ context, file, report }: PolicyInput): TSESLint.RuleListener;

package/dist/app/lint/rules/data.js

@@ -1 +0,0 @@
-import{AST_NODE_TYPES as r}from"@typescript-eslint/types";import{binding as p,memberName as w,stringValue as E}from"../policy.js";const T=new Set(["addFinding","actor","budget","bytes","count","duration","event","externalCall","expectMetric","expectSequence","fixture","finding","http","metric","money","ratio","reconcile","record","recordCache","recordHttpRequest","recordLlmUsage","recordRpc","sequence","sequenceBudget","system","transition"]),N=new Set(["actor","bytes","duration","externalCall","http","money","ratio","reconcile","record","recordCache","recordHttpRequest","recordLlmUsage","recordRpc","sequence","system","transition"]),f=new Set(["bench","describe","it","suite","test","BenchmarkRunner","TestRunner","EvaluatedModules"]);export function createDataPolicy({context:o,file:C,report:n}){if(!C.endsWith(".data.testkit.ts"))return{};const d=new Set,h=new Set,v=new Map,g=new Map;let y=!1,b=!1;const u=(e,t,a="vitest-runner-import")=>{n(e,a,t,`Data suites cannot use ${t} for Vitest case registration; declare cases with dataScenario(...)`)},x=e=>{for(const t of o.sourceCode.getAncestors(e).reverse())if(t.type===r.ArrowFunctionExpression||t.type===r.FunctionExpression){const a=g.get(t);if(a)return a}},m=e=>e.startsWith("vitest/")&&e!=="vitest/package.json"||e==="@gfdelarue/testkit/node-vitest/contract",k=e=>{E(e)?.includes("{serviceContextUrl:")&&n(e,"service-namespace-url","serviceContextUrl","Data suites must not use serviceContextUrl placeholders because they run outside the deployed service namespace")};return{ImportDeclaration(e){const t=e.source.value;if(t==="@playwright/test"&&n(e,"browser-runtime-import",t,"Browser/runtime driving belongs in ui or e2e suites, not data suites"),(t.startsWith("@testing-library/")||t==="jsdom"||t==="happy-dom")&&n(e,"dom-runtime-import","dom-runtime","DOM/rendering tests belong in ui suites, not data suites"),e.importKind==="type")return;const a=e.specifiers.filter(s=>s.type!==r.ImportSpecifier||s.importKind!=="type");if(!(e.specifiers.length&&!a.length)){m(t)&&u(e,t),t==="@gfdelarue/testkit/node-vitest/data"&&(y=!0);for(const s of a){const i=o.sourceCode.getDeclaredVariables(e).find(l=>l.name===s.local.name);if(t==="vitest"&&s.type===r.ImportNamespaceSpecifier&&i&&h.add(i),s.type!==r.ImportSpecifier)continue;const c=s.imported.type===r.Identifier?s.imported.name:s.imported.value;t==="vitest"&&f.has(c)&&u(s,c),t==="@gfdelarue/testkit/node-vitest/data"&&c==="dataScenario"&&i&&d.add(i)}}},ExportNamedDeclaration(e){if(!e.source||e.exportKind==="type")return;const t=e.specifiers.filter(a=>a.exportKind!=="type");if(!(e.specifiers.length&&!t.length)&&(m(e.source.value)&&u(e,e.source.value),e.source.value==="vitest"))for(const a of t){const s=a.local.type===r.Identifier?a.local.name:a.local.value;f.has(s)&&u(a,s)}},ExportAllDeclaration(e){e.exportKind!=="type"&&m(e.source.value)&&u(e,e.source.value)},MemberExpression(e){if(e.object.type!==r.Identifier)return;const t=p(o,e.object),a=w(e);t&&h.has(t)&&a&&f.has(a)&&u(e,a,"vitest-runner-call")},CallExpression(e){const t=e.callee.type===r.Identifier?p(o,e.callee):null;if(t&&d.has(t)){b=!0;const i=e.arguments.at(-1);if(!i||i.type!==r.ArrowFunctionExpression&&i.type!==r.FunctionExpression){n(e,"missing-scenario-callback","dataScenario","dataScenario(...) must provide a callback that receives the Testkit data context");return}const c=i.params[0]?.type===r.AssignmentPattern?i.params[0].left:i.params.at(0),l=c?.type===r.Identifier?o.sourceCode.getDeclaredVariables(i).find(D=>D.name===c.name):null;if(!l){n(e,"missing-data-context","dataScenario","dataScenario callbacks must accept the Testkit data context and record data evidence");return}const S={callback:i,context:l,contextName:l.name,methods:new Set,assertion:!1};v.set(e,S),g.set(i,S);return}const a=o.sourceCode.getText(e.callee);e.callee.type===r.MemberExpression&&a.includes(".serviceContextUrl")&&n(e,"service-namespace-url","serviceContextUrl","Data suites run in the managed Node.js runner, not inside a service namespace; use baseUrl/public endpoints or move service-namespace checks to int/e2e");const s=x(e);if(s&&(/^(expect|assert)(?:\(|\.)/u.test(a)&&(s.assertion=!0),e.callee.type===r.MemberExpression&&e.callee.object.type===r.Identifier&&p(o,e.callee.object)===s.context)){const i=w(e.callee);i&&T.has(i)&&s.methods.add(i)}},"CallExpression:exit"(e){const t=v.get(e);if(!t)return;const{callback:a,contextName:s,methods:i,assertion:c}=t;i.size?[...i].some(l=>N.has(l))||(n(a,"weak-data-evidence",s,"Data scenarios must record product data-flow evidence such as http, bytes, sequence, record, transition, system, externalCall, recordCache, recordLlmUsage, or reconcile; ordinary Node/Vitest-style checks belong in *.contract.testkit.ts with @gfdelarue/testkit/node-vitest/contract"),c&&n(a,"vitest-shaped-data-suite",s,"This dataScenario looks like an ordinary assertion test with weak data bookkeeping; move Node-backed contract checks to *.contract.testkit.ts or model the product data flow with structured evidence")):n(a,"missing-data-evidence",s,"Data scenarios must record Testkit-owned data-flow evidence with the data context, such as http, bytes, sequence, record, transition, system, externalCall, recordCache, recordLlmUsage, or reconcile")},ThrowStatement(e){const t=x(e);t&&(t.assertion=!0)},Literal:k,TemplateLiteral:k,"Program:exit"(e){y?d.size?b||n(e,"missing-data-scenario","dataScenario","Data suites must declare at least one dataScenario(...)"):n(e,"missing-data-scenario-import","dataScenario","Data suites must import dataScenario from @gfdelarue/testkit/node-vitest/data"):n(e,"missing-data-import","@gfdelarue/testkit/node-vitest/data","Data suites must import dataScenario from @gfdelarue/testkit/node-vitest/data")}}}

package/dist/app/lint/rules/engine-imports.d.ts

@@ -1,3 +0,0 @@
-import type { TSESLint } from "@typescript-eslint/utils";
-import { type PolicyInput } from "../policy.js";
-export declare function createEngineImportPolicy({ context, file, report }: PolicyInput): TSESLint.RuleListener;

package/dist/app/lint/rules/syntax.d.ts

@@ -1,4 +0,0 @@
-import type { TSESLint } from "@typescript-eslint/utils";
-import type { LintRuleName } from "../options.js";
-import { type PolicyInput } from "../policy.js";
-export declare function createSyntaxPolicy(name: LintRuleName, { file, context, report, options, literals }: PolicyInput, files: readonly string[]): TSESLint.RuleListener;

package/dist/app/lint/rules/unit.d.ts

@@ -1,3 +0,0 @@
-import type { TSESLint } from "@typescript-eslint/utils";
-import { type PolicyInput } from "../policy.js";
-export declare function createUnitPolicy({ file, report }: PolicyInput): TSESLint.RuleListener;

package/dist/app/lint/shared.d.ts

@@ -1,34 +0,0 @@
-export interface LintFindingInput {
-    file: string;
-    kind?: string;
-    line?: number;
-    message: string;
-    ruleId: string;
-    ruleName: string;
-    snippet?: string | null;
-    target?: string;
-}
-export interface LintFinding {
-    file: string;
-    kind: string;
-    line: number;
-    message: string;
-    ruleId: string;
-    ruleName: string;
-    snippet?: string;
-    target: string;
-}
-export declare const DEFAULT_EXCLUDED_DIRS: string[];
-export declare const SOURCE_PATTERNS: string[];
-export declare const SOURCE_IGNORES: string[];
-export declare const DEFAULT_TESTKIT_BOUNDARY_ALLOWED: string[];
-export declare function collectCurrentFiles(productDir: string, gitAvailable: boolean): Promise<string[]>;
-export declare function collectTrackedFiles(productDir: string): Promise<string[] | null>;
-export declare function isSourceLikePath(file: string): boolean;
-export declare function isTypeScriptLikePath(file: string): boolean;
-export declare function isTestkitSuitePath(file: string): boolean;
-export declare function isExcludedRelativePath(file: string): boolean;
-export declare function matchesAnyPathPattern(file: string, patterns: readonly string[]): boolean;
-export declare function compareFindings(left: LintFinding, right: LintFinding): number;
-export declare function normalizeFinding(finding: LintFindingInput): LintFinding;
-export declare function findingKey(finding: Readonly<LintFinding>): string;

package/dist/app/package-inspection.d.ts

@@ -1,20 +0,0 @@
-export interface PackageVersionInspectionOptions {
-    binUrl?: string | URL;
-    currentPackageRoot?: string;
-    cwd?: string;
-    dir?: string | null;
-}
-export interface PackageVersionMismatch {
-    currentPackageRoot: string;
-    currentVersion: string;
-    declaredSpec: string | null;
-    productDir: string;
-    productPackageRoot: string | null;
-    productVersion: string | null;
-}
-export declare function testkitIdentity(): {
-    description: string;
-    name: string;
-    version: string;
-};
-export declare function inspectPackageVersionDrift(options?: Readonly<PackageVersionInspectionOptions>): PackageVersionMismatch | null;

package/dist/app/reports/files.d.ts

@@ -1,13 +0,0 @@
-export declare const REPORT_FILE_BYTES: number;
-export declare const REPORT_BYTES: number;
-export declare const REPORT_FILES = 1000;
-export declare const REPORT_TREES = 128;
-export interface ReportFile {
-    readonly path: string;
-    readonly absolutePath: string;
-    readonly executable: boolean;
-    readonly size: number;
-}
-export declare function requireReportPath(value: string): string;
-export declare function copyReportFile(source: string, destination: string, root?: string): number;
-export declare function snapshotReport(source: string, destination: string, maxDirectories?: number): ReportFile[];

package/dist/app/reports/prepare.d.ts

@@ -1,20 +0,0 @@
-export interface PrepareReportOptions {
-    directory: string;
-    dir?: string;
-    cwd?: string;
-    template?: string;
-    instructions?: string;
-    bug?: readonly string[];
-    run?: string;
-    artifact?: readonly string[];
-}
-export declare function prepareReport(options: PrepareReportOptions): {
-    directory: string;
-    files: string[];
-    bugs: string[];
-    run: string | null;
-    instructions: {
-        path: string;
-        text: string;
-    } | null;
-};

package/dist/app/reports/publish.d.ts

@@ -1,21 +0,0 @@
-export interface PublishReportOptions {
-    directory: string;
-    repository: string;
-    branch: string;
-    path: string;
-    dir?: string;
-    cwd?: string;
-    env?: Readonly<NodeJS.ProcessEnv>;
-    message?: string;
-}
-export declare function publishReport(options: PublishReportOptions): Promise<{
-    revision: string;
-    previous: string | null;
-    changed: boolean;
-    repository: string;
-    branch: string;
-    path: string;
-    url: string;
-    files: number;
-    bytes: number;
-}>;

package/dist/app/run/endpoint-readiness.d.ts

@@ -1,43 +0,0 @@
-import { type EndpointReadinessAttempt } from "../../process/readiness.js";
-import type { NormalizedFailureDetail } from "./failure-details.js";
-export interface EndpointReadinessOptions {
-    attemptTimeoutMs?: number | string;
-    mode?: string;
-    retryDelayMs?: number | string;
-    timeoutMs?: number | string;
-}
-export interface EndpointReadinessLifecycle {
-    isStopRequested(): boolean;
-}
-export interface EndpointReadinessInput {
-    baseUrl: string;
-    env?: NodeJS.ProcessEnv;
-    lifecycle?: EndpointReadinessLifecycle | null;
-    options?: Readonly<EndpointReadinessOptions>;
-    serviceName?: string | null;
-    signal?: AbortSignal;
-}
-export interface EndpointReadinessFailureDetail extends NormalizedFailureDetail {
-    classification: "infra";
-    endpoint: string;
-    key: "http_endpoint_readiness";
-    kind: "http_endpoint_readiness";
-    message: string;
-    service: string | null;
-    title: "HTTP endpoint readiness failed";
-}
-export interface EndpointReadinessSuccess {
-    attempts: EndpointReadinessAttempt[];
-    ok: true;
-    skipped: boolean;
-}
-export interface EndpointReadinessFailure {
-    attempts: EndpointReadinessAttempt[];
-    failureDetails: EndpointReadinessFailureDetail[];
-    ok: false;
-    reason: string;
-    skipped: false;
-}
-export type EndpointReadinessResult = EndpointReadinessFailure | EndpointReadinessSuccess;
-export declare function shouldRunEndpointReadinessPreflight(baseUrl: string, options?: Readonly<EndpointReadinessOptions>, env?: NodeJS.ProcessEnv): boolean;
-export declare function waitForEndpointReadinessPreflight({ baseUrl, serviceName, lifecycle, options, env, signal, }: Readonly<EndpointReadinessInput>): Promise<EndpointReadinessResult>;

package/dist/app/run/endpoint-readiness.js

@@ -1 +0,0 @@
-import{connectEndpoint as E}from"../../process/readiness.js";const P=new Set(["localhost","127.0.0.1","::1"]);export function shouldRunEndpointReadinessPreflight(t,e={},n=process.env){const r=(e.mode||n.TESTKIT_HTTP_ENDPOINT_PREFLIGHT||"auto").trim().toLowerCase();if(["0","false","off","never","disabled"].includes(r))return!1;if(["1","true","on","always","force"].includes(r))return!0;const o=d(t);return!!(o&&!P.has(l(o.host)))}export async function waitForEndpointReadinessPreflight({baseUrl:t,serviceName:e,lifecycle:n=null,options:r={},env:o=process.env,signal:i}){if(!shouldRunEndpointReadinessPreflight(t,r,o))return{ok:!0,skipped:!0,attempts:[]};const s=d(t);if(!s)return T({baseUrl:t,serviceName:e,attempts:[],reason:`HTTP endpoint readiness could not parse ${t||"unknown endpoint"}`});const f=c(r.timeoutMs??o.TESTKIT_HTTP_ENDPOINT_PREFLIGHT_TIMEOUT_MS,3e4),m=c(r.attemptTimeoutMs??o.TESTKIT_HTTP_ENDPOINT_PREFLIGHT_ATTEMPT_TIMEOUT_MS,5e3),_=c(r.retryDelayMs??o.TESTKIT_HTTP_ENDPOINT_PREFLIGHT_RETRY_DELAY_MS,500),u=Date.now()+f,a=[];for(;Date.now()<u;){if(n?.isStopRequested()||i?.aborted)return T({baseUrl:t,serviceName:e,attempts:a,reason:`testkit run interrupted before HTTP endpoint readiness completed for ${t}`});const h=Math.max(1,u-Date.now()),p=await E(s,Math.min(m,h),i);if(a.push(p),p.ok)return{ok:!0,skipped:!1,attempts:a};await w(Math.min(_,Math.max(0,u-Date.now())),i)}return T({baseUrl:t,serviceName:e,attempts:a,reason:`HTTP endpoint for ${e||"unknown"} was not reachable at ${t}`})}function T({baseUrl:t,serviceName:e,attempts:n,reason:r}){const o=n.map(s=>s.error).filter(s=>!!s).slice(-3).join("; "),i=o?`${r}. Last connection failure(s): ${o}`:r;return{ok:!1,skipped:!1,reason:i,attempts:n,failureDetails:[{count:1,kind:"http_endpoint_readiness",key:"http_endpoint_readiness",title:"HTTP endpoint readiness failed",classification:"infra",message:i,service:e||null,endpoint:t}]}}function d(t){try{const e=new URL(t);if(!["http:","https:"].includes(e.protocol))return null;const n=Number(e.port||(e.protocol==="https:"?443:80));return!Number.isInteger(n)||n<=0||n>65535?null:{host:l(e.hostname),port:n}}catch{return null}}function c(t,e){const n=Number(t);return Number.isInteger(n)&&n>0?n:e}function l(t){return t.trim().toLowerCase().replace(/^\[(.*)\]$/u,"$1")}function w(t,e){return e?.aborted?Promise.resolve():new Promise(n=>{const r=setTimeout(o,t);function o(){clearTimeout(r),e?.removeEventListener("abort",o),n()}e?.addEventListener("abort",o,{once:!0})})}

package/dist/app/run/engine-evidence-persistence.d.ts

@@ -1,39 +0,0 @@
-import { type FileEvidenceBudget } from "../../evidence/file-evidence.js";
-import type { EngineEvidence } from "../../engines/api/index.js";
-import { type PersistedArtifactReference } from "../../evidence/index.js";
-import type { ScheduledTask } from "./scheduler/index.js";
-type EvidenceCategory = "artifacts" | "logs" | "metrics" | "native";
-type EvidencePersistenceMode = "observed" | "reconcile";
-export interface EvidenceLedger {
-    readonly countsByCategory: Readonly<Record<EvidenceCategory, Map<string, number>>>;
-    readonly fileEvidence: {
-        maximumBytes: number;
-        persistedBytes: number;
-    };
-}
-interface PersistEvidenceOptions {
-    artifactRoot: string;
-    evidence: EngineEvidence;
-    productDir: string;
-    scope: "invocation" | "task";
-    task: ScheduledTask;
-    fileEvidenceBudget?: FileEvidenceBudget;
-}
-export declare const MAX_ENGINE_FILE_EVIDENCE_BYTES: number;
-interface EvidencePersistenceContext {
-    artifactRoot: string;
-    errors: Error[];
-    ledger: EvidenceLedger;
-    mode: EvidencePersistenceMode;
-    productDir: string;
-    references: PersistedArtifactReference[];
-    scope: "invocation" | "task";
-    task: ScheduledTask;
-}
-export declare function persistEngineEvidence({ artifactRoot, evidence, productDir, scope, task, fileEvidenceBudget, }: Readonly<PersistEvidenceOptions>): PersistedArtifactReference[];
-export declare function persistTrackedEngineEvidence(evidence: Readonly<EngineEvidence>, context: EvidencePersistenceContext): void;
-export declare function createEvidenceLedger(maximumFileEvidenceBytes?: number): EvidenceLedger;
-export declare function requireTaskArtifacts(referencesByTaskId: ReadonlyMap<string, PersistedArtifactReference[]>, taskId: string): PersistedArtifactReference[];
-export declare function requireTaskEvidenceLedger(ledgersByTaskId: ReadonlyMap<string, EvidenceLedger>, taskId: string): EvidenceLedger;
-export declare function contextualError(message: string, cause: unknown): Error;
-export {};

package/dist/app/run/engine-execution-cleanup.d.ts

@@ -1,8 +0,0 @@
-import type { EngineTaskExecutionOutcome } from "./engine-execution.js";
-import type { EngineExecutionCleanupFailure } from "./engine-execution-failures.js";
-export interface PreparedNodeSetupCleanup {
-    cleanup: () => Promise<void>;
-    taskId: string;
-}
-export declare function cleanupPreparedNodeSetups(cleanupStack: readonly Readonly<PreparedNodeSetupCleanup>[]): Promise<EngineExecutionCleanupFailure[]>;
-export declare function applyConsumerNodeSetupCleanupFailures(completedOutcomesByTaskId: Map<string, EngineTaskExecutionOutcome>, cleanupFailures: readonly Readonly<EngineExecutionCleanupFailure>[]): void;

package/dist/app/run/engine-execution-cleanup.js

@@ -1 +0,0 @@
-import{getRuntimeNodeSetupCleanupFailures as i}from"./setup/runtime-node-setup.js";import{toError as c}from"../../kernel/error-serialization.js";export async function cleanupPreparedNodeSetups(n){const r=[];for(const{cleanup:u,taskId:e}of[...n].reverse())try{await u()}catch(t){const s=i(t);s.length===0?r.push({error:c(t),owner:"testkit",taskId:e}):r.push(...s.map(a=>({...a,taskId:e})))}return r}export function applyConsumerNodeSetupCleanupFailures(n,r){const u=new Map;for(const e of r){if(e.owner!=="consumer")continue;const t=u.get(e.taskId)??[];t.push(e.error),u.set(e.taskId,t)}for(const[e,t]of u){const s=n.get(e);if(s===void 0)continue;const a=`Runtime node setup consumer cleanup failed: ${t.map(o=>o.message).join("; ")}`;n.set(e,{...s,error:s.error===null?a:`${s.error}; ${a}`,failureDetails:[...s.failureDetails,...t.map(l)],reason:null,status:"failed"})}}function l(n){return{actual:{owner:"consumer"},classification:"product",count:1,key:"runtime_node_setup_consumer_cleanup_failed",kind:"runtime-node-setup-cleanup",message:n.message,...n.stack===void 0?{}:{stack:n.stack},title:"Runtime node setup consumer cleanup failed"}}