@gfdelarue/testkit 0.3.0

package/dist/cli/commands/cloud/download.js

@@ -0,0 +1 @@
+import{cloudInteraction as u}from"../../cloud-selection.js";import{downloadCloudArtifact as n}from"../../../app/cloud/control-actions.js";export default async function e({flags:t,json:r,log:i}){const o=await n(t.receipt,t.path,t.output,{origin:t.url,...u(r)});return r||i(JSON.stringify(o,null,2)),{ok:!0,result:o}}

package/dist/cli/commands/cloud/list.d.ts

@@ -0,0 +1,5 @@
+import type { CommandContext } from "../../command-catalog.js";
+export default function run({ args, flags, json, log }: CommandContext<"cloud list">): Promise<{
+    ok: boolean;
+    result: unknown;
+}>;

package/dist/cli/commands/cloud/list.js

@@ -0,0 +1 @@
+import{cloudInteraction as c}from"../../cloud-selection.js";import{listCloudResources as n}from"../../../app/cloud/control-read.js";export default async function u({args:o,flags:r,json:e,log:t}){const i=await n(o.resource,{...c(e),origin:r.url,organisation:r.org,project:r.project,limit:r.limit,cursor:r.cursor,branch:r.branch,decision:r.decision,pr:r.pr,sort:r.sort,direction:r.direction,flaky:r.flaky,receipt:r.receipt,caseId:r.case,testPath:r.path,page:r.page,campaign:r.campaign,rootCauseKey:r["root-cause-key"],issueReference:r["issue-reference"],view:r.view,order:r.order});return e||t(JSON.stringify(i,null,2)),{ok:!0,result:i}}

package/dist/cli/commands/cloud/login.d.ts

@@ -0,0 +1,13 @@
+import type { CommandContext } from "../../command-catalog.js";
+export default function run({ flags, json, log }: CommandContext<"cloud login">): Promise<{
+    reused: boolean;
+    user: {
+        id: string;
+        email: string;
+        name: string;
+    };
+    expiresAt: string;
+    maximumExpiresAt: string;
+    origin: string;
+    ok: boolean;
+}>;

package/dist/cli/commands/cloud/login.js

@@ -0,0 +1,2 @@
+import{runWithCliProcessSignal as s}from"../../process-signal.js";import{loginToCloud as u}from"../../../app/cloud/login.js";export default async function c({flags:r,json:e,log:i}){const o=await s(t=>u({origin:r.url,browser:r.browser,force:r.force,signal:t,notify:n=>process.stderr.write(`${n}
+`)}));return e||i(`Connected to ${o.origin} as ${o.user.email}.`),{ok:!0,...o}}

package/dist/cli/commands/cloud/logout.d.ts

@@ -0,0 +1,7 @@
+import type { CommandContext } from "../../command-catalog.js";
+export default function run({ flags, json, log }: CommandContext<"cloud logout">): Promise<{
+    origin: string;
+    loggedOut: boolean;
+    environmentTokenActive: boolean;
+    ok: boolean;
+}>;

package/dist/cli/commands/cloud/logout.js

@@ -0,0 +1 @@
+import{logoutOfCloud as e}from"../../../app/cloud/login.js";export default async function r({flags:n,json:t,log:i}){const o=await e({origin:n.url});return t||(i(`Signed out of ${o.origin}.`),o.environmentTokenActive&&i("TESTKIT_CLOUD_TOKEN is still set and will be used by Cloud commands.")),{ok:!0,...o}}

package/dist/cli/commands/cloud/migrate/apply.d.ts

@@ -0,0 +1,2 @@
+import type { CommandContext } from "../../../command-catalog.js";
+export default function run({ flags, json, log, setExitCode }: CommandContext<"cloud migrate apply">): Promise<import("../../../../app/cloud/migration/model.js").MigrationResult>;

package/dist/cli/commands/cloud/migrate/apply.js

@@ -0,0 +1 @@
+import{applyMigration as p}from"../../../../app/cloud/migration/index.js";import{migrationProgressRenderer as i}from"./progress.js";export default async function l({flags:r,json:t,log:o,setExitCode:n}){const e=await p(r.plan,process.env,i());return e.complete||n(1),t||o(`${e.complete?"Complete":"Incomplete"}: ${e.reportPath} (${String(e.problems.length)} problems)`),e}

package/dist/cli/commands/cloud/migrate/plan.d.ts

@@ -0,0 +1,7 @@
+import type { CommandContext } from "../../../command-catalog.js";
+export default function run({ flags, json, log, setExitCode }: CommandContext<"cloud migrate plan">): Promise<{
+    ready: boolean;
+    planPath: string;
+    problems: import("../../../../app/cloud/migration/model.js").MigrationProblem[];
+    summary: import("../../../../app/cloud/migration/model.js").MigrationPlan["sourceSummary"];
+}>;

package/dist/cli/commands/cloud/migrate/plan.js

@@ -0,0 +1 @@
+import{planMigration as o}from"../../../../app/cloud/migration/index.js";export default async function p({flags:r,json:i,log:t,setExitCode:n}){const e=await o({sourceDir:r.source,registry:r.registry,regressions:r.regressions,mapping:r.mapping,outputDir:r.output,origin:r.url,projectId:r.project,campaignId:r.campaign});return e.ready||n(1),i||t(`${e.ready?"Ready":"Blocked"}: ${e.planPath} (${String(e.problems.length)} problems)`),e}

package/dist/cli/commands/cloud/migrate/progress.d.ts

@@ -0,0 +1,2 @@
+import type { MigrationProgressCallback } from "../../../../app/cloud/migration/progress.js";
+export declare function migrationProgressRenderer(): MigrationProgressCallback;

package/dist/cli/commands/cloud/migrate/progress.js

@@ -0,0 +1,2 @@
+const c={"source-verification":"Verifying source","journal-upgrade":"Upgraded recovery journal",packaging:"Packaging",uploading:"Uploading","receipt-accepted":"Receipt accepted","record-admission":"Admitting records",reconciliation:"Reconciling evidence and records",completion:"Import complete",failed:"Migration incomplete"};export function migrationProgressRenderer(){let i="",o=0;return r=>{const e=`${r.phase}:${r.runId??""}`,t=Date.now();if(e===i&&t-o<250&&r.phase!=="failed"&&r.phase!=="completion")return;i=e,o=t;const a=`${String(r.completedRuns)}/${String(r.totalRuns)} runs accepted, ${String(Math.max(0,r.totalRuns-r.completedRuns))} remaining`,s=`${String(r.bytesTransferred)} upload bytes, ${String(r.retries)} retries, ${String(r.verifiedBytes??0)} verified bytes`,n=[r.runId?`run ${r.runId}`:"",r.operation?`operation ${r.operation}`:""].filter(Boolean).join(", ");process.stderr.write(`[migration] ${c[r.phase]}: ${a}; ${s}${n?`; ${n}`:""}${r.detail?`; ${r.detail}`:""}
+`)}}

package/dist/cli/commands/cloud/migrate/reconcile.d.ts

@@ -0,0 +1,2 @@
+import type { CommandContext } from "../../../command-catalog.js";
+export default function run({ flags, json, log, setExitCode }: CommandContext<"cloud migrate reconcile">): Promise<import("../../../../app/cloud/migration/model.js").MigrationResult>;

package/dist/cli/commands/cloud/migrate/reconcile.js

@@ -0,0 +1 @@
+import{reconcileMigration as i}from"../../../../app/cloud/migration/index.js";import{migrationProgressRenderer as p}from"./progress.js";export default async function l({flags:r,json:o,log:t,setExitCode:n}){const e=await i(r.plan,process.env,p());return e.complete||n(1),o||t(`${e.complete?"Complete":"Incomplete"}: ${e.reportPath} (${String(e.problems.length)} problems)`),e}

package/dist/cli/commands/cloud/policy/preview.d.ts

@@ -0,0 +1,5 @@
+import type { CommandContext } from "../../../command-catalog.js";
+export default function run({ args, flags, json, log }: CommandContext<"cloud policy preview">): Promise<{
+    ok: boolean;
+    result: unknown;
+}>;

package/dist/cli/commands/cloud/policy/preview.js

@@ -0,0 +1 @@
+import{previewCloudPolicy as u}from"../../../../app/cloud/control-actions.js";export default async function e({args:o,flags:i,json:n,log:t}){const r=await u(o.policy,i.file,{origin:i.url,organisation:i.org});return n||t(JSON.stringify(r,null,2)),{ok:!0,result:r}}

package/dist/cli/commands/cloud/project/create.d.ts

@@ -0,0 +1,5 @@
+import type { CommandContext } from "../../../command-catalog.js";
+export default function run({ flags, json, log }: CommandContext<"cloud project create">): Promise<{
+    ok: boolean;
+    result: unknown;
+}>;

package/dist/cli/commands/cloud/project/create.js

@@ -0,0 +1 @@
+import{cloudInteraction as n}from"../../../cloud-selection.js";import{runWithCliProcessSignal as u}from"../../../process-signal.js";import{createCloudProject as s}from"../../../../app/cloud/control.js";export default async function c({flags:r,json:o,log:i}){const e=await u(t=>s({...n(o),origin:r.url,organisation:r.org,name:r.name,repository:r.repository,provider:r.provider,host:r.host,publishDecisions:r["publish-decisions"],requestKey:r["request-key"],browser:r.browser,signal:t}));return o||i(JSON.stringify(e,null,2)),{ok:!0,result:e}}

package/dist/cli/commands/cloud/publish.d.ts

@@ -0,0 +1,7 @@
+import type { CommandContext } from "../../command-catalog.js";
+export default function run({ flags, json, log }: CommandContext<"cloud publish">): Promise<{
+    receipt: import("../../../cloud/client.js").CloudReceipt;
+    association?: import("../../../cloud/campaigns.js").CampaignResult;
+    dashboardUrl: string;
+    ok: boolean;
+}>;

package/dist/cli/commands/cloud/publish.js

@@ -0,0 +1 @@
+import{cloudInteraction as t}from"../../cloud-selection.js";import c from"node:path";import{publishRunToCloud as s}from"../../../app/cloud/index.js";export default async function d({flags:o,json:e,log:r}){const i=await s({campaignId:o.campaign,...t(e),origin:o.url,productDir:c.resolve(o.dir??process.cwd()),projectId:o.project,runId:o.run??null}),{receipt:n}=i;if(!e){r(`Published ${n.runId}: ${n.decision} (${n.id})`),r(i.dashboardUrl);for(const a of n.decisionReasons)r(`  ${a.message}`);i.association&&r(`Campaign ${i.association.campaignId}: receipt ${i.association.changed?"linked":"already linked"}, version ${String(i.association.version)}`)}return{ok:!0,...i}}

package/dist/cli/commands/cloud/session/revoke.d.ts

@@ -0,0 +1,8 @@
+import type { CommandContext } from "../../../command-catalog.js";
+export default function run({ args, flags, json, log }: CommandContext<"cloud session revoke">): Promise<{
+    ok: boolean;
+    result: {
+        id: string;
+        revoked: true;
+    };
+}>;

package/dist/cli/commands/cloud/session/revoke.js

@@ -0,0 +1 @@
+import{revokeCloudSession as t}from"../../../../app/cloud/control-actions.js";export default async function u({args:e,flags:r,json:i,log:n}){const o=await t(e.id,{origin:r.url});return i||n(`Revoked Cloud session ${o.id}.`),{ok:!0,result:o}}

package/dist/cli/commands/cloud/show.d.ts

@@ -0,0 +1,5 @@
+import type { CommandContext } from "../../command-catalog.js";
+export default function run({ args, flags, json, log }: CommandContext<"cloud show">): Promise<{
+    ok: boolean;
+    result: unknown;
+}>;

package/dist/cli/commands/cloud/show.js

@@ -0,0 +1 @@
+import{cloudInteraction as e}from"../../cloud-selection.js";import{showCloudResource as u}from"../../../app/cloud/control-read.js";export default async function c({args:o,flags:r,json:t,log:n}){const i=await u(o.resource,o.id,{...e(t),origin:r.url,organisation:r.org,project:r.project,campaign:r.campaign});return t||n(JSON.stringify(i,null,2)),{ok:!0,result:i}}

package/dist/cli/commands/cloud/snapshot.d.ts

@@ -0,0 +1,5 @@
+import type { CommandContext } from "../../command-catalog.js";
+export default function run({ flags, json, log }: CommandContext<"cloud snapshot">): Promise<{
+    ok: boolean;
+    snapshot: unknown;
+}>;

package/dist/cli/commands/cloud/snapshot.js

@@ -0,0 +1 @@
+import{readCloudSnapshot as t}from"../../../app/cloud/index.js";export default async function o({flags:i,json:r,log:n}){const e=await t({campaignId:i.campaign,findingId:i.finding,findings:i.findings,receipts:i.receipts,history:i.history,rootCauseKey:i["root-cause-key"],issueReference:i["issue-reference"],view:i.view,limit:i.limit,cursor:i.cursor,origin:i.url,projectId:i.project});return r||n(JSON.stringify(e,null,2)),{ok:!0,snapshot:e}}

package/dist/cli/commands/cloud/status.d.ts

@@ -0,0 +1,33 @@
+import type { CommandContext } from "../../command-catalog.js";
+export default function run({ flags, json, log }: CommandContext<"cloud status">): Promise<{
+    origin: string;
+    source: "environment";
+    authenticated: null;
+    message: string;
+    ok: boolean;
+} | {
+    origin: string;
+    source: "none";
+    authenticated: boolean;
+    message?: undefined;
+    ok: boolean;
+} | {
+    user: {
+        id: string;
+        email: string;
+        name: string;
+    };
+    expiresAt: string;
+    maximumExpiresAt: string;
+    origin: string;
+    source: "account";
+    authenticated: boolean;
+    message?: undefined;
+    ok: boolean;
+} | {
+    origin: string;
+    source: "account";
+    authenticated: boolean;
+    message?: undefined;
+    ok: boolean;
+}>;

package/dist/cli/commands/cloud/status.js

@@ -0,0 +1 @@
+import{cloudLoginStatus as u}from"../../../app/cloud/login.js";export default async function o({flags:t,json:e,log:i}){const n=await u({origin:t.url});return e||(i(`Cloud: ${n.origin}`),i(n.source==="environment"?n.message:n.authenticated&&"user"in n?`Signed in as ${n.user.email}`:"Not signed in. Run testkit cloud login.")),{ok:!0,...n}}

package/dist/cli/commands/db/schema/refresh.d.ts

@@ -0,0 +1,2 @@
+import type { CommandContext } from "../../../command-catalog.js";
+export default function run({ flags, json, log }: CommandContext<"db schema refresh">): Promise<import("../../../../app/db-schema/refresh.js").DatabaseSchemaRefreshResult>;

package/dist/cli/commands/db/schema/refresh.js

@@ -0,0 +1 @@
+import{executeDatabaseSchemaRefreshOperation as n}from"../../../operations/db/schema/refresh/operation.js";import{renderDatabaseSchemaRefreshResult as f}from"../../../renderers/db-schema/text.js";export default async function s({flags:r,json:t,log:a}){const e=await n(r);if(!t)for(const o of f(e))a(o);return e}

package/dist/cli/commands/db/schema/verify.d.ts

@@ -0,0 +1,2 @@
+import type { CommandContext } from "../../../command-catalog.js";
+export default function run({ flags, json, log }: CommandContext<"db schema verify">): Promise<import("../../../../app/db-schema/verify.js").DatabaseSchemaVerifyResult>;

package/dist/cli/commands/db/schema/verify.js

@@ -0,0 +1 @@
+import{executeDatabaseSchemaVerifyOperation as n}from"../../../operations/db/schema/verify/operation.js";import{renderDatabaseSchemaVerifyResult as f}from"../../../renderers/db-schema/text.js";export default async function i({flags:r,json:t,log:a}){const e=await n(r);if(!t)for(const o of f(e))a(o);return e}

package/dist/cli/commands/destroy.d.ts

@@ -0,0 +1,9 @@
+import type { CommandContext } from "../command-catalog.js";
+export default function run({ flags, json, log }: CommandContext<"destroy">): Promise<{
+    ok: true;
+    productDir: string;
+    results: Array<{
+        destroyed: true;
+        name: string;
+    }>;
+}>;

package/dist/cli/commands/destroy.js

@@ -0,0 +1 @@
+import{destroyEnvironment as i}from"../../app/destroy/index.js";import{renderDestroyResult as s}from"../renderers/destroy/text.js";export default async function c({flags:r,json:t,log:o}){const e=await i({dir:r.dir,service:r.service});if(!t)for(const n of s(e))o(n);return e}

package/dist/cli/commands/discover.d.ts

@@ -0,0 +1,2 @@
+import type { CommandContext } from "../command-catalog.js";
+export default function run({ flags, json, log }: CommandContext<"discover">): Promise<import("../../app/discover/index.js").DiscoverOperationResult>;

package/dist/cli/commands/discover.js

@@ -0,0 +1 @@
+import{executeDiscoverOperation as u}from"../../app/discover/index.js";import{renderDiscoverResult as n}from"../renderers/discover/text.js";export default async function c({flags:e,json:r,log:o}){const t=await u({diagnostics:e.strict?"error":"report",dir:e.dir,file:e.file||[],output:e.output,runnableOnly:e["runnable-only"],service:e.service||null,suite:e.suite||[],type:e.type||[]},process.cwd());if(!r)for(const i of n(t,{outputMode:e["output-mode"]}))o(i);return t}

package/dist/cli/commands/doctor.d.ts

@@ -0,0 +1,2 @@
+import type { CommandContext } from "../command-catalog.js";
+export default function run({ flags, json, log }: CommandContext<"doctor">): Promise<import("../../app/doctor/index.js").DoctorResult>;

package/dist/cli/commands/doctor.js

@@ -0,0 +1 @@
+import{runDoctor as n}from"../../app/doctor/index.js";import{renderDoctorResult as i}from"../renderers/doctor/text.js";export default async function f({flags:o,json:e,log:c}){const r=await n({dir:o.dir,typecheck:o.typecheck});if(!e)for(const t of i(r))c(t);if(!r.ok)throw Object.assign(new Error("testkit doctor failed"),{result:r});return r}

package/dist/cli/commands/guard/unsafe-entrypoint.d.ts

@@ -0,0 +1,2 @@
+import type { CommandContext } from "../../command-catalog.js";
+export default function run({ flags }: CommandContext<"guard unsafe-entrypoint">): void;

package/dist/cli/commands/guard/unsafe-entrypoint.js

@@ -0,0 +1,2 @@
+export default function t({flags:e}){throw Object.assign(new Error(`${e.command} is disabled because DB-touching tests must run through the isolated testkit harness.
+Use ${e.use} instead.`),{exitCode:1})}

package/dist/cli/commands/lint.d.ts

@@ -0,0 +1,2 @@
+import type { CommandContext } from "../command-catalog.js";
+export default function run({ flags, json, log }: CommandContext<"lint">): Promise<import("../../app/lint/index.js").LintResult>;

package/dist/cli/commands/lint.js

@@ -0,0 +1 @@
+import{executeLintOperation as i}from"../../app/lint/index.js";import{renderLintResult as f}from"../renderers/lint/text.js";export default async function s({flags:e,json:o,log:n}){const r=await i(e);if(!o)for(const t of f(r))n(t);if(!r.ok)throw Object.assign(new Error("testkit lint failed"),{result:r});return r}

package/dist/cli/commands/run/status.d.ts

@@ -0,0 +1,5 @@
+import type { CommandContext } from "../../command-catalog.js";
+export default function run({ flags, json, log }: CommandContext<"run status">): Promise<{
+    ok: boolean;
+    result: import("../../../app/status/runs.js").RunStatus;
+}>;

package/dist/cli/commands/run/status.js

@@ -0,0 +1 @@
+import{collectRunStatus as e}from"../../../app/status/runs.js";import{renderRunStatusLines as i}from"../../renderers/run/status.js";export default async function l({flags:r,json:n,log:u}){const t=await e({dir:r.dir,runId:r.run||null,full:r.full});if(!n)for(const o of i(t))u(o);return{ok:!0,result:t}}

package/dist/cli/commands/run/stop.d.ts

@@ -0,0 +1,7 @@
+import type { CommandContext } from "../../command-catalog.js";
+export default function run({ flags, json, log }: CommandContext<"run stop">): Promise<{
+    ok: true;
+    productDir: string;
+    stoppedRuns: import("../../../environment/run-stopping.js").StoppedRun[];
+    lines: string[];
+}>;

package/dist/cli/commands/run/stop.js

@@ -0,0 +1 @@
+import{stopProductRuns as u}from"../../../app/stop/index.js";import{renderStoppedRuns as i}from"../../renderers/stop/text.js";export default async function s({flags:r,json:o,log:t}){const n=i(await u({all:r.all,dir:r.dir,reason:r.reason,runId:r.run||null},"run stop requested"));if(!o)for(const e of n.lines)t(e);return n}

package/dist/cli/commands/run.d.ts

@@ -0,0 +1,9 @@
+import type { CommandContext } from "../command-catalog.js";
+export default function run({ args, flags, json, setExitCode }: CommandContext<"run">): Promise<{
+    exitCode: number;
+    failure?: import("../../kernel/error-serialization.js").SerializedError;
+    results: import("../../app/run/results.js").FinalizedServiceResult[];
+    runArtifact: import("../../app/run/run-finalization.js").FinalizedRunArtifacts["runArtifact"];
+    outputMode: import("../operations/run/operation.js").RunOutputMode;
+    runId: string;
+}>;

package/dist/cli/commands/run.js

@@ -0,0 +1 @@
+import{buildRunRequest as c}from"../../app/run/request.js";import{executeRunRequest as n}from"../operations/run/operation.js";export default async function p({args:r,flags:e,json:o,setExitCode:u}){const i=await c({dir:e.dir,service:e.service,taskConcurrency:e["task-concurrency"],workers:e.workers,fileTimeoutSeconds:e["file-timeout-seconds"],type:e.type,suite:e.suite,file:e.file,allowEmpty:e["allow-empty"],ignoreSkipRules:e["ignore-skip-rules"],skipSchemaSourceVerify:e["skip-schema-source-verify"]},r.type||null,process.cwd(),process.cwd()),t=await n(i,{outputMode:e["output-mode"]||"compact",json:o,debug:e.debug});return u(t.exitCode),t}

package/dist/cli/commands/setup/playwright.d.ts

@@ -0,0 +1,2 @@
+import type { CommandContext } from "../../command-catalog.js";
+export default function run({ flags, json, log }: CommandContext<"setup playwright">): Promise<import("../../../engines/installations/playwright.js").PlaywrightInstallation>;

package/dist/cli/commands/setup/playwright.js

@@ -0,0 +1 @@
+import{setupPlaywright as n}from"../../../app/setup/playwright.js";export default async function a({flags:e,json:i,log:t}){const s=new AbortController,r=()=>{s.abort(new Error("Playwright setup was interrupted"))};process.once("SIGINT",r),process.once("SIGTERM",r);try{const o=await n({force:e.force,dir:e.dir,signal:s.signal,withDeps:e["with-deps"]});return i||(t("Playwright Chromium is ready"),t(`  registry: ${o.registry.canonicalValue}`),t(`  browser: ${o.browserExecutable}`)),o}finally{process.removeListener("SIGINT",r),process.removeListener("SIGTERM",r)}}

package/dist/cli/commands/status.d.ts

@@ -0,0 +1,5 @@
+import type { CommandContext } from "../command-catalog.js";
+export default function run({ flags, json, log }: CommandContext<"status">): Promise<{
+    ok: boolean;
+    results: import("../../app/status/model.js").StatusModel[];
+}>;

package/dist/cli/commands/status.js

@@ -0,0 +1 @@
+import{collectServiceStatus as c}from"../../app/status/index.js";import{renderStatusResult as n}from"../renderers/status/text.js";export default async function u({flags:r,json:e,log:o}){const t=await c({dir:r.dir,service:r.service});if(!e)for(const i of t)for(const s of n(i))o(s);return{ok:!0,results:t}}

package/dist/cli/commands/stop.d.ts

@@ -0,0 +1,12 @@
+import type { CommandContext } from "../command-catalog.js";
+export default function run({ flags, json, log }: CommandContext<"stop">): Promise<{
+    ok: true;
+    productDir: string;
+    runStop: {
+        ok: true;
+        productDir: string;
+        stoppedRuns: import("../../environment/run-stopping.js").StoppedRun[];
+        lines: string[];
+    };
+    lines: string[];
+}>;

package/dist/cli/commands/stop.js

@@ -0,0 +1 @@
+import{stopProductRuns as u}from"../../app/stop/index.js";import{renderStoppedRuns as i}from"../renderers/stop/text.js";export default async function p({flags:o,json:e,log:n}){const r=i(await u({all:!0,dir:o.dir,reason:o.reason},"stop requested")),t={ok:!0,productDir:r.productDir,runStop:r,lines:r.lines};if(!e)for(const s of t.lines)n(s);return t}

package/dist/cli/commands/typecheck.d.ts

@@ -0,0 +1,2 @@
+import type { CommandContext } from "../command-catalog.js";
+export default function run({ flags, json, log }: CommandContext<"typecheck">): Promise<import("../../app/typecheck/index.js").TestkitTypecheckResult>;

package/dist/cli/commands/typecheck.js

@@ -0,0 +1 @@
+import{runTestkitTypecheck as n,TestkitTypecheckError as s}from"../../app/typecheck/index.js";import{runWithCliProcessSignal as f}from"../process-signal.js";import{renderTypecheckResult as u}from"../renderers/typecheck/text.js";export default async function m({flags:c,json:r,log:i}){const e=await f(t=>n({dir:c.dir,signal:t})).catch(t=>{if(!r&&t instanceof s)for(const o of[t.result.stdout,t.result.stderr])o.trim()&&i(o.trimEnd());throw t});if(!r)for(const t of u(e))i(t);return e}

package/dist/cli/commands/workspace.d.ts

@@ -0,0 +1,2 @@
+import type { CommandContext } from "../command-catalog.js";
+export default function run({ flags, json, log }: CommandContext<"workspace">): Promise<import("../../app/inspect/index.js").WorkspaceInspection>;

package/dist/cli/commands/workspace.js

@@ -0,0 +1 @@
+import{inspectWorkspace as n}from"../../app/inspect/index.js";export default async function a({flags:e,json:i,log:t}){const s=await n({dir:e.dir,service:e.service||null,status:!e["no-status"],targetLimit:e["target-limit"]});if(!i&&(t(`${s.product.name} \xB7 Testkit workspace`),s.discovery&&t(`  ${String(s.discovery.summary.services)} services \xB7 ${String(s.discovery.summary.suites)} suites \xB7 ${String(s.discovery.summary.files)} files`),s.runs.live?t(`  live ${s.runs.live.status} \xB7 ${String(s.runs.live.files.passed)}/${String(s.runs.live.files.total)} files complete`):s.runs.latest&&t(`  latest ${s.runs.latest.status} \xB7 ${String(s.runs.latest.files.passed)}/${String(s.runs.latest.files.total)} files passed`),s.warnings.length>0))for(const r of s.warnings)t(`  warning: ${r}`);return s}

package/dist/cli/entrypoint.d.ts

@@ -0,0 +1 @@
+export declare function normalizeCliArgs(argv: readonly string[]): string[];

package/dist/cli/entrypoint.js

@@ -0,0 +1 @@
+import{commandRegistry as c}from"./command-registry.js";export function normalizeCliArgs(n){if(n[0]==="help")return f(n);if(u(n))return[...n];const t=new Set(c.map(s=>s.id[0])),l=new Set(c.flatMap(s=>Object.entries(s.flags??{}).flatMap(([i,r])=>r.kind==="boolean"?[]:[`--${i}`,...r.char?[`-${r.char}`]:[]]))),o=m(n,l),e=o.at(0)??null;return e!==null&&t.has(e.value)?d(n,o):["run",...n]}function u(n){const t=n[0];return t==="--help"||t==="-h"||t==="--version"||t==="-v"}function f(n){const t=n[1];return t?[t,...n.slice(2),"--help"]:["--help"]}function m(n,t){const l=[];for(let o=0;o<n.length;o+=1){const e=n[o];if(e==="--")break;if(!e.startsWith("-")){l.push({index:o,value:e});continue}const s=e.indexOf("="),i=s<0?e:e.slice(0,s);s<0&&t.has(i)&&(o+=1)}return l}function d(n,t){if(!t.at(0))return[...n];const o=[...c].sort((i,r)=>r.id.length-i.id.length).find(i=>i.id.every((r,a)=>t[a]?.value===r)),e=t.slice(0,o?.id.length??1),s=new Set(e.map(i=>i.index));return[...e.map(i=>i.value),...n.filter((i,r)=>!s.has(r))]}

package/dist/cli/framework/command.d.ts

@@ -0,0 +1,21 @@
+import type { ArgumentDefinitions, FlagDefinitions } from "./definitions.js";
+import type { ParsedCommand } from "./parser.js";
+export type CommandContext<Definition extends CommandDefinition> = ParsedCommand<Definition["flags"], Definition["args"]> & {
+    readonly json: boolean;
+    readonly log: (message?: string) => void;
+    readonly setExitCode: (code: number) => void;
+};
+export interface CommandDefinition<Flags extends FlagDefinitions | undefined = FlagDefinitions | undefined, Arguments extends ArgumentDefinitions | undefined = ArgumentDefinitions | undefined> {
+    readonly args?: Arguments;
+    readonly enableJsonFlag?: boolean;
+    readonly flags?: Flags;
+    readonly summary?: string;
+    readonly description?: string;
+}
+export interface CommandRegistration extends CommandDefinition {
+    readonly id: readonly string[];
+    load(): Promise<{
+        default(context: CommandContext<CommandDefinition>): unknown;
+    }>;
+}
+export declare function defineCommand<const Flags extends FlagDefinitions | undefined = undefined, const Arguments extends ArgumentDefinitions | undefined = undefined>(definition: CommandDefinition<Flags, Arguments>): CommandDefinition<Flags, Arguments>;

package/dist/cli/framework/command.js

@@ -0,0 +1 @@
+export function defineCommand(e){return Object.freeze(e)}

package/dist/cli/framework/definitions.d.ts

@@ -0,0 +1,100 @@
+export interface ArgumentOptions<Values extends readonly string[] | undefined = readonly string[] | undefined> {
+    readonly description?: string;
+    readonly options?: Values;
+    readonly required?: boolean;
+}
+export interface StringFlagOptions<Values extends readonly string[] | undefined = readonly string[] | undefined> {
+    readonly char?: string;
+    readonly default?: string;
+    readonly description?: string;
+    readonly multiple?: boolean;
+    readonly options?: Values;
+    readonly required?: boolean;
+}
+export interface BooleanFlagOptions {
+    readonly allowNo?: boolean;
+    readonly char?: string;
+    readonly default?: boolean;
+    readonly description?: string;
+    readonly required?: boolean;
+}
+export interface IntegerFlagOptions {
+    readonly char?: string;
+    readonly default?: number;
+    readonly description?: string;
+    readonly required?: boolean;
+}
+export type FlagKind = "boolean" | "integer" | "string";
+export interface FlagDefinition<Value = unknown> {
+    readonly allowNo?: boolean;
+    readonly char?: string;
+    readonly default?: boolean | number | string;
+    readonly description?: string;
+    readonly kind: FlagKind;
+    readonly multiple?: boolean;
+    readonly options?: readonly string[];
+    readonly required?: boolean;
+    readonly valueType?: Value;
+}
+export interface ArgumentDefinition<Value = unknown> {
+    readonly description?: string;
+    readonly kind: "string";
+    readonly options?: readonly string[];
+    readonly required?: boolean;
+    readonly valueType?: Value;
+}
+export type FlagDefinitions = Readonly<Record<string, FlagDefinition>>;
+export type ArgumentDefinitions = Readonly<Record<string, ArgumentDefinition>>;
+type OptionValue<Values extends readonly string[] | undefined> = Values extends readonly (infer Value extends string)[] ? Value : string;
+interface StringFlagFactory {
+    <const Values extends readonly string[] | undefined = undefined>(options: StringFlagOptions<Values> & {
+        readonly multiple: true;
+        readonly required: true;
+    }): FlagDefinition<OptionValue<Values>[]>;
+    <const Values extends readonly string[] | undefined = undefined>(options: StringFlagOptions<Values> & {
+        readonly multiple: true;
+    }): FlagDefinition<OptionValue<Values>[] | undefined>;
+    <const Values extends readonly string[] | undefined = undefined>(options: (StringFlagOptions<Values> & {
+        readonly required: true;
+    }) | (StringFlagOptions<Values> & {
+        readonly default: string;
+    })): FlagDefinition<OptionValue<Values>>;
+    <const Values extends readonly string[] | undefined = undefined>(options?: StringFlagOptions<Values>): FlagDefinition<OptionValue<Values> | undefined>;
+}
+interface BooleanFlagFactory {
+    (options: (BooleanFlagOptions & {
+        readonly default: boolean;
+    }) | (BooleanFlagOptions & {
+        readonly required: true;
+    })): FlagDefinition<boolean>;
+    (options?: BooleanFlagOptions): FlagDefinition<boolean | undefined>;
+}
+interface IntegerFlagFactory {
+    (options: (IntegerFlagOptions & {
+        readonly default: number;
+    }) | (IntegerFlagOptions & {
+        readonly required: true;
+    })): FlagDefinition<number>;
+    (options?: IntegerFlagOptions): FlagDefinition<number | undefined>;
+}
+interface StringArgumentFactory {
+    <const Values extends readonly string[] | undefined = undefined>(options: ArgumentOptions<Values> & {
+        readonly required: true;
+    }): ArgumentDefinition<OptionValue<Values>>;
+    <const Values extends readonly string[] | undefined = undefined>(options?: ArgumentOptions<Values>): ArgumentDefinition<OptionValue<Values> | undefined>;
+}
+export declare const Flags: Readonly<{
+    boolean: BooleanFlagFactory;
+    integer: IntegerFlagFactory;
+    string: StringFlagFactory;
+}>;
+export declare const Args: Readonly<{
+    string: StringArgumentFactory;
+}>;
+export type InferFlags<Definitions extends FlagDefinitions | undefined> = Definitions extends FlagDefinitions ? {
+    -readonly [Name in keyof Definitions]: Definitions[Name] extends FlagDefinition<infer Value> ? Value : never;
+} : Record<string, never>;
+export type InferArguments<Definitions extends ArgumentDefinitions | undefined> = Definitions extends ArgumentDefinitions ? {
+    -readonly [Name in keyof Definitions]: Definitions[Name] extends ArgumentDefinition<infer Value> ? Value : never;
+} : Record<string, never>;
+export {};

package/dist/cli/framework/definitions.js

@@ -0,0 +1 @@
+function e(n={}){return{kind:"string",...n}}function t(n={}){return{kind:"boolean",...n}}function r(n={}){return{kind:"integer",...n}}function i(n={}){return{kind:"string",...n}}export const Flags=Object.freeze({boolean:t,integer:r,string:e}),Args=Object.freeze({string:i});

package/dist/cli/framework/errors.d.ts

@@ -0,0 +1,6 @@
+export declare class CliUsageError extends Error {
+    readonly exitCode = 2;
+    constructor(message: string);
+}
+export declare function commandExitCode(error: unknown): number;
+export declare function errorMessage(error: unknown): string;

package/dist/cli/framework/errors.js

@@ -0,0 +1 @@
+export class CliUsageError extends Error{exitCode=2;constructor(t){super(t),this.name="CliUsageError"}}export function commandExitCode(e){if(!n(e))return 1;const t=Reflect.get(e,"exitCode");return typeof t=="number"&&Number.isSafeInteger(t)&&t>=0&&t<=255?t:1}export function errorMessage(e){if(n(e)){const t=Reflect.get(e,"message");if(typeof t=="string"&&t.length>0)return t}return String(e)}function n(e){return typeof e=="object"&&e!==null||typeof e=="function"}

package/dist/cli/framework/execute.d.ts

@@ -0,0 +1,13 @@
+import type { CommandRegistration } from "./command.js";
+import { type CliIdentity } from "./help.js";
+export interface CliExecutionOutput {
+    readonly setExitCode: (code: number) => void;
+    readonly writeStandardError: (value: string) => void;
+    readonly writeStandardOutput: (value: string) => void | Promise<void>;
+}
+export interface ExecuteCliOptions {
+    readonly beforeAction?: (id: readonly string[]) => Promise<void>;
+    readonly identity: CliIdentity;
+    readonly registrations: readonly CommandRegistration[];
+}
+export declare function executeCliArguments(argv: readonly string[], options: Readonly<ExecuteCliOptions>): Promise<void>;

package/dist/cli/framework/execute.js

@@ -0,0 +1,6 @@
+import{serializeCliError as g,writeStandardOutput as m}from"../json-errors.js";import{CliUsageError as l,commandExitCode as p,errorMessage as w}from"./errors.js";import{renderCommandHelp as h,renderRootHelp as C,renderTopicHelp as x,renderVersion as O}from"./help.js";import{parseCommandArguments as S}from"./parser.js";export async function executeCliArguments(t,n){const r=H;if(t.length===1&&o(t[0])){await r.writeStandardOutput(C(n.identity,n.registrations));return}if(t.length===1&&y(t[0])){await r.writeStandardOutput(O(n.identity));return}let e;try{e=E(t,n.registrations)}catch(a){const s=F(t,n.registrations);if(s){await r.writeStandardOutput(x(s,n.registrations));return}await c(a,!1,r);return}if(u(e.argv,o)){await r.writeStandardOutput(h(e.registration,n.registrations));return}const i=e.registration.enableJsonFlag===!0&&u(e.argv,a=>a==="--json");try{const a=S(e.argv,e.registration.flags,e.registration.args,e.registration.enableJsonFlag===!0);await n.beforeAction?.(e.registration.id);const d=await(await e.registration.load()).default({...a,json:i,log(f=""){r.writeStandardOutput(`${f}
+`)},setExitCode:r.setExitCode});i&&d!==void 0&&await r.writeStandardOutput(`${JSON.stringify(d,null,2)}
+`)}catch(a){await c(a,i,r)}}function E(t,n){const e=n.filter(i=>i.id.every((a,s)=>t[s]===a)).sort((i,a)=>a.id.length-i.id.length).at(0);if(!e){const i=t.filter(a=>!a.startsWith("-")).at(0);throw new l(i?`Unknown command: ${i}`:"A Testkit command is required")}return{registration:e,argv:t.slice(e.id.length)}}async function c(t,n,r){const e=p(t);if(n){await r.writeStandardOutput(`${JSON.stringify({error:g(t)},null,2)}
+`),r.setExitCode(e);return}r.setExitCode(e);const i=t instanceof l?`
+Run "testkit --help" to see available commands and options.`:"";r.writeStandardError(`Error: ${w(t)}${i}
+`)}function o(t){return t==="--help"||t==="-h"}function y(t){return t==="--version"||t==="-v"}function F(t,n){const r=t.findIndex(o);if(r<1)return null;const e=t.slice(0,r);return n.some(i=>i.id.length>e.length&&e.every((a,s)=>i.id[s]===a))?e:null}function u(t,n){const r=t.indexOf("--");return(r<0?t:t.slice(0,r)).some(n)}const H={setExitCode(t){process.exitCode=t},writeStandardError(t){process.stderr.write(t)},writeStandardOutput:m};

package/dist/cli/framework/help.d.ts

@@ -0,0 +1,11 @@
+import type { CommandRegistration } from "./command.js";
+export interface CliIdentity {
+    readonly description: string;
+    readonly name: string;
+    readonly version: string;
+}
+export declare function renderVersion(identity: Readonly<CliIdentity>): string;
+export declare function renderRootHelp(identity: Readonly<CliIdentity>, registrations: readonly CommandRegistration[]): string;
+export declare function renderTopicHelp(topic: readonly string[], registrations: readonly CommandRegistration[]): string;
+export declare function renderCommandHelp(registration: Readonly<CommandRegistration>, registrations: readonly CommandRegistration[]): string;
+export declare function commandPath(registration: Readonly<CommandRegistration>): string;

package/dist/cli/framework/help.js

@@ -0,0 +1,8 @@
+export function renderVersion(n){return`${n.name}/${n.version} ${process.platform}-${process.arch} node-v${process.versions.node}
+`}export function renderRootHelp(n,e){const o=[...e].sort(u);return`${[n.description,"","Usage:","  testkit <command> [options]","","Commands:",...o.map(a=>i(a)),"","Global options:","  -h, --help     Show help","  -v, --version  Show version"].join(`
+`)}
+`}export function renderTopicHelp(n,e){const o=n.join(" "),c=e.filter(s=>s.id.length>n.length&&n.every((l,r)=>s.id[r]===l)).sort(u);return`${[`Testkit ${o} commands`,"","Usage:",`  testkit ${o} <command> [options]`,"","Commands:",...c.map(s=>i(s))].join(`
+`)}
+`}export function renderCommandHelp(n,e){const o=n,c=n.id.join(" "),a=Object.entries(o.args??{}),s=e.filter(t=>t.id.length===n.id.length+1&&n.id.every((m,$)=>t.id[$]===m)).sort(u),l=a.map(([t,m])=>m.required?`<${t}>`:`[${t}]`).join(" "),r=[o.summary??c,"","Usage:",`  testkit ${c}${l?` ${l}`:""} [options]`];a.length>0&&r.push("","Arguments:",...a.map(([t,m])=>h(t,m)));const p=Object.entries(o.flags??{});return(p.length>0||o.enableJsonFlag)&&(r.push("","Options:",...p.map(([t,m])=>g(t,m))),o.enableJsonFlag&&r.push("  --json  Write one machine-readable JSON document")),r.push("  -h, --help  Show help for this command"),s.length>0&&r.push("","Subcommands:",...s.map(t=>i(t))),o.description&&r.push("",o.description),`${r.join(`
+`)}
+`}export function commandPath(n){return n.id.join(" ")}function i(n){return`  ${n.id.join(" ")}  ${n.summary??""}`.trimEnd()}function h(n,e){const o=d(e.options);return`  ${n}${e.required?" (required)":""}${o}  ${e.description??""}`.trimEnd()}function g(n,e){const o=e.char?`-${e.char}, `:"",c=e.kind==="boolean"&&e.allowNo?`--[no-]${n}`:`--${n}`,a=e.kind==="boolean"?"":` <${e.kind==="integer"?"integer":"value"}>`,s=e.multiple?" (repeatable)":"",l=e.required?" (required)":"",r=e.default===void 0?"":` (default: ${String(e.default)})`;return`  ${o}${c}${a}${s}${l}${d(e.options)}${r}  ${e.description??""}`.trimEnd()}function d(n){return n?` (${n.join("|")})`:""}function u(n,e){return commandPath(n).localeCompare(commandPath(e))}

package/dist/cli/framework/index.d.ts

@@ -0,0 +1,3 @@
+export { Args, Flags, type InferFlags } from "./definitions.js";
+export { defineCommand, type CommandContext, type CommandDefinition, type CommandRegistration } from "./command.js";
+export { executeCliArguments, type ExecuteCliOptions } from "./execute.js";

package/dist/cli/framework/index.js

@@ -0,0 +1 @@
+export{Args,Flags}from"./definitions.js";export{defineCommand}from"./command.js";export{executeCliArguments}from"./execute.js";

package/dist/cli/framework/parser.d.ts

@@ -0,0 +1,6 @@
+import { type ArgumentDefinitions, type FlagDefinitions, type InferArguments, type InferFlags } from "./definitions.js";
+export interface ParsedCommand<Flags extends FlagDefinitions | undefined, Arguments extends ArgumentDefinitions | undefined> {
+    readonly args: InferArguments<Arguments>;
+    readonly flags: InferFlags<Flags>;
+}
+export declare function parseCommandArguments<const FlagSet extends FlagDefinitions | undefined, const ArgumentSet extends ArgumentDefinitions | undefined>(argv: readonly string[], flagDefinitions: FlagSet, argumentDefinitions: ArgumentSet, enableJsonFlag: boolean): ParsedCommand<FlagSet, ArgumentSet>;

package/dist/cli/framework/parser.js

@@ -0,0 +1 @@
+import"./definitions.js";import{CliUsageError as l}from"./errors.js";export function parseCommandArguments(n,t,e,i){const r=t??{},o=y(r),a=q(r),s=new Set,f=[];let c=!1;for(let u=0;u<n.length;u+=1){const d=n[u];if(c){f.push(d);continue}if(d==="--"){c=!0;continue}if(d==="--json"){if(!i)throw g(d);continue}if(d.startsWith("--")){u=m(n,u,{aliases:o,definitions:r,flags:a,seenFlags:s});continue}if(d.startsWith("-")&&d!=="-"){u=v(n,u,{aliases:o,definitions:r,flags:a,seenFlags:s});continue}f.push(d)}return E(r,a),{args:j(f,e??{}),flags:a}}function m(n,t,e){const i=n[t],r=i.indexOf("="),o=i.slice(2,r<0?void 0:r),a=k(o,e.definitions);if(!a)throw g(`--${o}`);const{definition:s,name:f,negated:c}=a;if(s.kind==="boolean"){if(r>=0)throw new l(`Boolean flag --${o} does not take a value`);if(c&&!s.allowNo)throw g(`--${o}`);return h(f,s,e.seenFlags),e.flags[f]=!c,t}if(c)throw g(`--${o}`);const w=r<0?null:i.slice(r+1),u=p(n,t,`--${f}`,w,s);return h(f,s,e.seenFlags),$(e.flags,f,s,u.values),u.index}function v(n,t,e){const i=n[t],r=i.slice(1,2),o=e.aliases.get(r);if(!o)throw g(`-${r}`);const a=e.definitions[o],s=i.slice(2);if(a.kind==="boolean"){if(s.startsWith("="))throw new l(`Boolean flag -${r} does not take a value`);if(s.length>0)throw g(i);return h(o,a,e.seenFlags),e.flags[o]=!0,t}const f=s.length===0?null:s.startsWith("=")?s.slice(1):s,c=p(n,t,`-${r}`,f,a);return h(o,a,e.seenFlags),$(e.flags,o,a,c.values),c.index}function p(n,t,e,i,r){const o=[];let a=t;if(i!==null){if(i.length===0)throw new l(`Flag ${e} requires a value`);o.push(i)}else{const s=n.at(t+1);if(s===void 0||F(s,r))throw new l(`Flag ${e} requires a value`);o.push(s),a+=1}if(r.multiple)for(;;){const s=n.at(a+1);if(s===void 0||F(s,r))break;o.push(s),a+=1}return{index:a,values:o}}function $(n,t,e,i){if(e.multiple){const o=n[t];if(o!==void 0&&!Array.isArray(o))throw new Error(`Invalid internal default for multiple flag --${t}`);const a=o??[];for(const s of i)a.push(b(t,e,s));n[t]=a;return}const r=i.at(0);if(r===void 0)throw new Error(`Missing parsed value for --${t}`);n[t]=b(t,e,r)}function k(n,t){if(Object.hasOwn(t,n))return{definition:t[n],name:n,negated:!1};if(!n.startsWith("no-"))return null;const e=n.slice(3);return Object.hasOwn(t,e)?{definition:t[e],name:e,negated:!0}:null}function h(n,t,e){if(!t.multiple&&e.has(n))throw new l(`Flag --${n} can only be specified once`);e.add(n)}function F(n,t){return n==="-"||t.kind==="integer"&&/^-\d+$/u.test(n)?!1:n.startsWith("-")}function b(n,t,e){if(t.kind==="integer"){if(!/^-?\d+$/u.test(e))throw new l(`Expected --${n} to be an integer; received ${JSON.stringify(e)}`);const i=Number(e);if(!Number.isSafeInteger(i))throw new l(`Expected --${n} to be a safe integer; received ${JSON.stringify(e)}`);return i}return O(e,t.options,`--${n}`),e}function j(n,t){const e=Object.entries(t);if(n.length>e.length)throw new l(`Unexpected argument ${JSON.stringify(n[e.length])}`);const i={};for(const[r,[o,a]]of e.entries()){const s=n.at(r);if(s===void 0){if(a.required)throw new l(`Missing required argument ${o}`);i[o]=void 0;continue}O(s,a.options,o),i[o]=s}return i}function O(n,t,e){if(!(!t||t.includes(n)))throw new l(`Expected ${e} to be one of: ${t.join(", ")}; received ${JSON.stringify(n)}`)}function q(n){const t={};for(const[e,i]of Object.entries(n))t[e]=i.default;return t}function y(n){const t=new Map;for(const[e,i]of Object.entries(n)){if(!i.char)continue;if(!/^[A-Za-z0-9]$/u.test(i.char))throw new Error(`Invalid short flag alias for --${e}: ${i.char}`);const r=t.get(i.char);if(r)throw new Error(`Duplicate short flag alias -${i.char} for --${r} and --${e}`);t.set(i.char,e)}return t}function E(n,t){const e=Object.entries(n).filter(([i,r])=>r.required&&t[i]===void 0).map(([i])=>`--${i}`);if(e.length>0)throw new l(`Missing required flag${e.length===1?"":"s"}: ${e.join(", ")}`)}function g(n){return new l(`Unknown flag: ${n}`)}

package/dist/cli/index.d.ts

@@ -0,0 +1,4 @@
+export declare function executeCli(argv: readonly string[], options?: Readonly<{
+    beforeAction?: (id: readonly string[]) => Promise<void>;
+}>): Promise<void>;
+export declare function run(argv?: readonly string[]): Promise<void>;