@gfdelarue/testkit 0.3.7 → 0.4.1

package/dist/evidence/index.js

@@ -1 +1 @@
-export{normalizeArtifactArchiveConfig}from"./artifact-config.js";export{finalizeLiveRunArtifact,loadTimings,persistTaskArtifacts,persistTaskFileArtifacts,persistTaskOutputArtifacts,resetResultArtifacts,saveTimings,writeLiveRunArtifact,writeRunArtifact}from"./artifacts.js";export{applyRunBundleRetention,listRunBundles,loadRunBundleArtifact,loadRunBundleManifest,loadVerifiedRunBundleArtifactIfExists,prepareVerifiedRunBundleUpload,publishRunBundle,sealRunBundle,verifyRunBundle}from"./bundles.js";export{collectArtifactEntries,loadCurrentRunArtifact,loadLatestRunArtifact,loadRunArtifact}from"./reading.js";export{DEFAULT_REPORTED_ARCHIVE_CONFIG}from"./reporting-types.js";export{copyRegularFileSecurely,MAX_PERSISTED_FILE_ARTIFACT_BYTES}from"./secure-file-copy.js";export{collectTestkitStorageInventory}from"./storage-inventory.js";export{}from"./timing.js";
+export{normalizeArtifactArchiveConfig}from"./artifact-config.js";export{finalizeLiveRunArtifact,loadTimings,persistTaskArtifacts,persistTaskFileArtifacts,persistTaskOutputArtifacts,resetResultArtifacts,saveTimings,writeLiveRunArtifact,writeRunArtifact}from"./artifacts.js";export{applyRunBundleRetention,listRunBundles,loadRunBundleArtifact,loadRunBundleManifest,loadVerifiedRunBundleArtifactIfExists,publishRunBundle,sealRunBundle,verifyRunBundle}from"./bundles.js";export{collectArtifactEntries,loadCurrentRunArtifact,loadLatestRunArtifact,loadRunArtifact}from"./reading.js";export{DEFAULT_REPORTED_ARCHIVE_CONFIG}from"./reporting-types.js";export{copyRegularFileSecurely,MAX_PERSISTED_FILE_ARTIFACT_BYTES}from"./secure-file-copy.js";export{collectTestkitStorageInventory}from"./storage-inventory.js";export{}from"./timing.js";

package/dist/kernel/redaction.d.ts

@@ -1 +1,2 @@
+export declare const SENSITIVE_KEY_PATTERN: RegExp;
 export declare function redactSensitiveText(value: unknown): string;

package/dist/kernel/redaction.js

@@ -1 +1 @@
-const S=/\b([A-Z0-9_]+)=([^\s]+)/giu,T=/PASSWORD|TOKEN|SECRET|PRIVATE_KEY|AUTH|COOKIE|SESSION|API_KEY/iu,a=/(:\/\/[^:\s/@]+:)([^@\s/]+)(@)/gu,o=String;export function redactSensitiveText(r){return u(o(r??"").replace(S,(e,t,s)=>T.test(t)?/(^|_)URL$/iu.test(t)?`${t}=${u(s)}`:`${t}=<redacted>`:e))}function u(r){return r.replace(a,(e,t,s,c,E)=>{for(let n=E-1;n>=0;n--){const i=r[n];if(/[a-z]/iu.test(i))return`${t}<redacted>${c}`;if(!/[0-9+.-]/u.test(i))break}return e})}
+const S=/\b([A-Z0-9_]+)=([^\s]+)/giu;export const SENSITIVE_KEY_PATTERN=/PASSWORD|TOKEN|SECRET|PRIVATE_KEY|AUTH|COOKIE|SESSION|API_KEY/iu;const T=/(:\/\/[^:\s/@]+:)([^@\s/]+)(@)/gu,a=String;export function redactSensitiveText(r){return u(a(r??"").replace(S,(e,t,s)=>SENSITIVE_KEY_PATTERN.test(t)?/(^|_)URL$/iu.test(t)?`${t}=${u(s)}`:`${t}=<redacted>`:e))}function u(r){return r.replace(T,(e,t,s,c,E)=>{for(let n=E-1;n>=0;n--){const i=r[n];if(/[a-z]/iu.test(i))return`${t}<redacted>${c}`;if(!/[0-9+.-]/u.test(i))break}return e})}

package/dist/process/execa-bundle.json

@@ -3,7 +3,7 @@
   "entrypoint": "dist/process/process.js",
   "sourceSha256": "a54f01864b603cee568b2945390dff35d578e07f6d26b5add06014169c3d17b0",
   "bundleSha256": "62f76cf9fd019f6c552bfde2787f058917caf279670a62e7a6bfa12be34cb4b1",
-  "packageLockSha256": "199fa09ca74cbda901572a6d406108c5d987a057f48b55bae294e7a1d4bded4f",
+  "packageLockSha256": "7d8833d3b8528d73331845635995428ce3be97f369c1c1b1c05d92eec833b073",
   "esbuildVersion": "0.28.1",
   "options": {
     "format": "esm",

package/dist/process/files/json-file.d.ts

@@ -8,4 +8,5 @@ export interface AtomicWriteOptions {
     maxDelayMs?: number;
 }
 export declare function writeJsonFileAtomicWithRetry(filePath: string, value: unknown, options?: AtomicWriteOptions): void;
+export declare function writeTextFileAtomicWithRetry(filePath: string, text: string, options?: AtomicWriteOptions): void;
 export declare function isRetryableAtomicReplaceError(error: unknown): boolean;

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

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

package/dist/repo/history.d.ts

@@ -0,0 +1,17 @@
+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/history.js

@@ -0,0 +1,4 @@
+import{requireManagedHostCommandSuccess as a}from"../process/index.js";import{runManagedGitCommand as s}from"./managed-git.js";const u=/^([0-9a-f]{40}|[0-9a-f]{64}) \d+ \d+(?: \d+)?$/u,l=/^committer-time (\d+)$/u;export async function findIntroducingCommit(e,t,n,r){const i=`${String(r[0])},${String(r[1])}`,o=await s(e,["blame","-w","-M","--porcelain","-L",i,t,"--",n]);if(o.exitCode!==0)throw new Error(`Git cannot blame lines ${String(r[0])} to ${String(r[1])} of ${n} at ${t}: ${m(o.stderr)}`);const c=newestBlamedCommit(parseBlame(o.stdout));if(c===null)throw new Error(`Git blamed no lines of ${n} at ${t}`);return c.boundary&&await f(e)?{status:"outside-history"}:{commit:c.commit,status:"found"}}export function parseBlame(e){const t=new Map;let n=null;for(const r of e.split(`
+`)){if(r.startsWith("	"))continue;const i=u.exec(r);if(i!==null){n=t.get(i[1])??{boundary:!1,committedAt:0},t.set(i[1],n);continue}if(n===null)continue;const o=l.exec(r);o!==null?n.committedAt=Number(o[1]):r==="boundary"&&(n.boundary=!0)}return[...t].map(([r,i])=>({commit:r,...i}))}export function newestBlamedCommit(e){let t=null;for(const n of e)(t===null||n.committedAt>t.committedAt)&&(t=n);return t}export async function listRemoteRefsContaining(e,t){return a("git for-each-ref",await s(e,["for-each-ref","--format=%(refname)","--contains",t,"refs/remotes"])).stdout.split(`
+`).map(i=>i.trim()).filter(i=>i.length>0&&!i.endsWith("/HEAD"))}export async function listUncommittedTrackedFiles(e){return a("git diff",await s(e,["diff","--name-only","-z","HEAD","--"])).stdout.split("\0").filter(r=>r.length>0)}export async function listFilesChangedSince(e,t){if((await s(e,["merge-base","--is-ancestor",t,"HEAD"])).exitCode!==0)return null;const r=["diff","--name-only","--diff-filter=d","-z",`${t}..HEAD`,"--"];return a("git diff",await s(e,r)).stdout.split("\0").filter(o=>o.length>0)}async function f(e){return a("git rev-parse",await s(e,["rev-parse","--is-shallow-repository"])).stdout.trim()==="true"}function m(e){return e.trim().split(`
+`).at(-1)??""}

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

@@ -0,0 +1,10 @@
+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/repo/tree-listing.js

@@ -0,0 +1 @@
+import{isUnknownRecord as m}from"../kernel/unknown-values.js";import{requireManagedHostCommandSuccess as h}from"../process/index.js";import{runManagedGitCommand as p}from"./managed-git.js";const w=/^(\d{6}) (blob|commit|tree) [0-9a-f]+ +(-|\d+)\t([\s\S]+)$/u,E=new Set(["100644","100755"]);export function listCommitFiles(t,e){return a(t,e,"")}export function parseTreeListing(t,e=""){const r=e===""?"":`${e}/`,o=[],s=[];for(const i of t.split("\0")){if(i.length===0)continue;const n=w.exec(i);if(n===null)throw new Error("Git returned an unreadable ls-tree record");const[,f,u,d,l]=n;u==="tree"?o.push(`${r}${l}`):u==="blob"&&E.has(f)&&s.push({path:`${r}${l}`,size:Number(d)})}return{directories:o,files:s}}async function a(t,e,r){const o=await c(t,e,r,!0);if(o!==null)return o.files;const s=await c(t,e,r,!1);if(s===null)throw new Error(`Git lists too many entries directly under ${r||"the repository root"} to read`);const i=[...s.files];for(const n of s.directories)i.push(...await a(t,e,n));return i}async function c(t,e,r,o){const s=r===""?e:`${e}:${r}`,i=["ls-tree","--full-tree","-l","-z",...o?["-r"]:[],s];try{const n=h("git ls-tree",await p(t,i));return parseTreeListing(n.stdout,r)}catch(n){if($(n))return null;throw n}}function $(t){if(!(t instanceof Error)||!("result"in t))return!1;const e=t.result;return m(e)&&e.outputLimitExceeded===!0}

package/dist/tracker/gitea.d.ts

@@ -0,0 +1,14 @@
+import { type TrackerRequest } from "./http.js";
+import { type TrackerRepository } from "./requests.js";
+import type { Tracker, TrackerIssueDraft, TrackerLabel, TrackerTarget } from "./types.js";
+export declare function giteaHeaders(token: string): Record<string, string>;
+export declare function giteaRequests(repository: TrackerRepository): {
+    routes: import("./requests.js").TrackerRoutes;
+    createIssue: (draft: TrackerIssueDraft, labelIds: readonly number[]) => TrackerRequest;
+    createLabel: (label: TrackerLabel) => TrackerRequest;
+    listComments: (pullRequest: number, number: number) => TrackerRequest;
+    listLabels: (number: number) => TrackerRequest;
+    listOpenIssues: (label: string, number: number) => TrackerRequest;
+};
+export declare function readGiteaVersion(origin: string): Promise<string | null>;
+export declare function createGiteaTracker(target: TrackerTarget): Tracker;

package/dist/tracker/gitea.js

@@ -0,0 +1 @@
+import{createTrackerHttp as b,TRACKER_PAGE_LIMIT as y,TrackerError as f}from"./http.js";import{commentRequest as T,commitStatusRequest as g,getRequest as k,TRACKER_USER_AGENT as h,trackerRepository as w,trackerRoutes as I}from"./requests.js";import{decodeGiteaVersion as R,decodeTrackerComment as G,decodeTrackerComments as S,decodeTrackerCommitStatusContext as C,decodeTrackerIssue as A,decodeTrackerIssues as E,decodeTrackerLabel as L,decodeTrackerLabels as q,requireIssueLabels as x}from"./responses.js";const $="50";export function giteaHeaders(a){return{Accept:"application/json",Authorization:`token ${a}`,"User-Agent":h}}export function giteaRequests(a){const o=I(a),r=(s,i,m={})=>k(s,{...m,limit:$,page:String(i)});return{routes:o,createIssue:(s,i)=>({body:{body:s.body,labels:i,title:s.title},method:"POST",url:o.issues}),createLabel:s=>({body:{color:`#${s.color}`,description:s.description,name:s.name},method:"POST",url:o.labels}),listComments:(s,i)=>r(o.comments(s),i),listLabels:s=>r(o.labels,s),listOpenIssues:(s,i)=>r(o.issues,i,{labels:s,state:"open",type:"issues"})}}export async function readGiteaVersion(a){const r=await b({headers:{Accept:"application/json","User-Agent":h},label:"Gitea version probe",secrets:[]}).exchange({method:"GET",url:`${a}/api/v1/version`});return r.ok?R(r.body):null}function O(a){const o=a.get("x-total-count");return o!==null&&/^\d+$/u.test(o)?Number(o):Number.POSITIVE_INFINITY}export function createGiteaTracker(a){const o=w(a),r=giteaRequests(o),s=b({headers:giteaHeaders(a.token),label:"Gitea",secrets:[a.token]});async function i(t,c,e){const n=new Map;for(let u=1;u<=y;u++){const l=await s.send(t(u)),p=n.size;for(const d of c(l.body,l.source))n.has(e(d))||n.set(e(d),d);if(n.size===p||n.size>=O(l.headers))return[...n.values()]}throw new f("rejected",`Gitea returned more than ${String(y)} pages`)}const m=()=>i(r.listLabels,q,t=>t.id);return{target:o,async createIssue(t){const c=t.labels.length===0?[]:await m(),e=t.labels.map(l=>{const p=c.find(d=>d.name===l);if(p===void 0)throw new f("rejected",`Gitea repository ${o.owner}/${o.name} has no label named ${JSON.stringify(l)}`);return p.id}),n=await s.send(r.createIssue(t,e)),{issue:u}=A(n.body,n.source);return x(u,t.labels,"Gitea",o)},async ensureLabels(t){if(t.length===0)return;const c=new Set((await m()).map(e=>e.name));for(const e of t){if(c.has(e.name))continue;const n=await s.send(r.createLabel(e));L(n.body,n.source),c.add(e.name)}},async listOpenIssues(t){return(await i(e=>r.listOpenIssues(t,e),E,e=>e.issue.number)).filter(e=>!e.pullRequest&&e.issue.labels.includes(t)).map(e=>e.issue)},async setCommitStatus(t){const c=await s.send(g(r.routes,t));C(c.body,c.source)},async upsertPullRequestComment(t){const e=(await i(u=>r.listComments(t.pullRequest,u),S,u=>u.id)).find(u=>u.body.startsWith(t.marker)),n=await s.send(T(r.routes,t,e));return{created:e===void 0,url:G(n.body,n.source).url}}}}

package/dist/tracker/github.d.ts

@@ -0,0 +1,14 @@
+import { type TrackerRequest } from "./http.js";
+import { type TrackerRepository } from "./requests.js";
+import type { Tracker, TrackerIssueDraft, TrackerLabel, TrackerTarget } from "./types.js";
+export declare function githubHeaders(token: string): Record<string, string>;
+export declare function githubRequests(repository: TrackerRepository): {
+    routes: import("./requests.js").TrackerRoutes;
+    createIssue: (draft: TrackerIssueDraft) => TrackerRequest;
+    createLabel: (label: TrackerLabel) => TrackerRequest;
+    listComments: (pullRequest: number) => TrackerRequest;
+    listLabels: () => TrackerRequest;
+    listOpenIssues: (label: string) => TrackerRequest;
+    nextPage(link: string | null): TrackerRequest | null;
+};
+export declare function createGithubTracker(target: TrackerTarget): Tracker;

package/dist/tracker/github.js

@@ -0,0 +1 @@
+import{createTrackerHttp as g,nextPageLink as w,TRACKER_PAGE_LIMIT as m,TrackerError as b}from"./http.js";import{commentRequest as f,commitStatusRequest as L,getRequest as d,TRACKER_USER_AGENT as h,trackerRepository as k,trackerRoutes as y}from"./requests.js";import{decodeTrackerComment as R,decodeTrackerComments as T,decodeTrackerCommitStatusContext as I,decodeTrackerIssue as C,decodeTrackerIssues as x,decodeTrackerLabel as A,decodeTrackerLabels as E,isDuplicateLabelRejection as P,requireIssueLabels as q}from"./responses.js";const p="100",G=100;export function githubHeaders(u){return{Accept:"application/vnd.github+json",Authorization:`Bearer ${u}`,"User-Agent":h,"X-GitHub-Api-Version":"2022-11-28"}}export function githubRequests(u){const i=y(u);return{routes:i,createIssue:e=>({body:{body:e.body,labels:e.labels,title:e.title},method:"POST",url:i.issues}),createLabel:e=>({body:{color:e.color,description:Array.from(e.description).slice(0,G).join(""),name:e.name},method:"POST",url:i.labels}),listComments:e=>d(i.comments(e),{per_page:p}),listLabels:()=>d(i.labels,{per_page:p}),listOpenIssues:e=>d(i.issues,{labels:e,per_page:p,state:"open"}),nextPage(e){const a=w(e);if(a===null)return null;if(!URL.canParse(a)||new URL(a).origin!==new URL(u.apiUrl).origin)throw new b("rejected",`GitHub returned a next page outside ${u.apiUrl}`);return{method:"GET",url:a}}}}export function createGithubTracker(u){const i=k(u),e=githubRequests(i),a=g({headers:githubHeaders(u.token),label:"GitHub",secrets:[u.token]});async function c(t,o){const s=[];let r=t;for(let n=0;r!==null;n++){if(n===m)throw new b("rejected",`GitHub returned more than ${String(m)} pages`);const l=await a.send(r);s.push(...o(l.body,l.source)),r=e.nextPage(l.headers.get("link"))}return s}return{target:i,async createIssue(t){const o=await a.send(e.createIssue(t)),{issue:s}=C(o.body,o.source);return q(s,t.labels,"GitHub",i)},async ensureLabels(t){if(t.length===0)return;const o=new Set((await c(e.listLabels(),E)).map(s=>s.name.toLowerCase()));for(const s of t){const r=s.name.toLowerCase();if(o.has(r))continue;const n=await a.exchange(e.createLabel(s));if(n.ok)A(n.body,n.source);else if(n.status!==422||!P(n.body))throw a.failure(n);o.add(r)}},async listOpenIssues(t){const o=t.toLowerCase(),s=new Map;for(const r of await c(e.listOpenIssues(t),x))r.pullRequest||!r.issue.labels.some(n=>n.toLowerCase()===o)||s.set(r.issue.number,r.issue);return[...s.values()]},async setCommitStatus(t){const o=await a.send(L(e.routes,t));I(o.body,o.source)},async upsertPullRequestComment(t){const s=(await c(e.listComments(t.pullRequest),T)).find(n=>n.body.startsWith(t.marker)),r=await a.send(f(e.routes,t,s));return{created:s===void 0,url:R(r.body,r.source).url}}}}

package/dist/tracker/http.d.ts

@@ -0,0 +1,33 @@
+import type { TrackerFailureKind } from "./types.js";
+export declare const TRACKER_PAGE_LIMIT = 1000;
+export declare class TrackerError extends Error {
+    readonly kind: TrackerFailureKind;
+    readonly status: number | null;
+    constructor(kind: TrackerFailureKind, message: string, status?: number | null);
+}
+export interface TrackerRequest {
+    readonly body?: unknown;
+    readonly method: "GET" | "PATCH" | "POST";
+    readonly url: string;
+}
+export interface TrackerResponse {
+    readonly body: unknown;
+    readonly headers: Headers;
+    readonly json: boolean;
+    readonly ok: boolean;
+    readonly source: string;
+    readonly status: number;
+}
+export interface TrackerHttpOptions {
+    readonly headers: Readonly<Record<string, string>>;
+    readonly label: string;
+    readonly secrets: readonly string[];
+}
+export interface TrackerHttp {
+    exchange(request: TrackerRequest): Promise<TrackerResponse>;
+    failure(response: TrackerResponse): TrackerError;
+    send(request: TrackerRequest): Promise<TrackerResponse>;
+}
+export declare function createTrackerHttp(options: TrackerHttpOptions): TrackerHttp;
+export declare function nextPageLink(link: string | null): string | null;
+export declare function scrubFailureDetail(text: string, secrets: readonly string[]): string;

package/dist/tracker/http.js

@@ -0,0 +1 @@
+import{isUnknownRecord as g}from"../kernel/unknown-values.js";import{redactBugText as m}from"./redaction.js";const l=3e4,d=300,f=Symbol("not JSON");export const TRACKER_PAGE_LIMIT=1e3;export class TrackerError extends Error{kind;status;constructor(t,s,o=null){super(s),this.name="TrackerError",this.kind=t,this.status=o}}export function createTrackerHttp(e){const t=r=>scrubFailureDetail(r,e.secrets);async function s(r){const n=`${e.label} ${r.method} ${T(r.url)}`;let i,c;try{i=await fetch(r.url,{body:r.body===void 0?void 0:JSON.stringify(r.body),headers:r.body===void 0?e.headers:{...e.headers,"Content-Type":"application/json"},method:r.method,signal:AbortSignal.timeout(l)}),c=await i.text()}catch(h){throw new TrackerError("unreachable",`${n} did not complete: ${t(y(h))}`)}const u=p(c);return{body:u===f?c:u,headers:i.headers,json:u!==f,ok:i.ok,source:n,status:i.status}}function o(r){const n=t(w(r.body));return new TrackerError($(r.status),`${r.source} returned ${String(r.status)}${n.length>0?`: ${n}`:""}`,r.status)}async function a(r){const n=await s(r);if(!n.ok)throw o(n);if(!n.json)throw new TrackerError("rejected",`${n.source} returned a response that is not JSON`,n.status);return n}return{exchange:s,failure:o,send:a}}export function nextPageLink(e){if(e===null)return null;for(const t of e.matchAll(/<([^>]*)>([^,]*)/gu)){const s=/;\s*rel\s*=\s*(?:"([^"]*)"|([^;\s]*))/iu.exec(t[2]);if((s?.[1]??s?.[2]??"").toLowerCase().split(/\s+/u).includes("next"))return t[1]}return null}export function scrubFailureDetail(e,t){let s=e;for(const a of t)a.length>0&&(s=s.split(a).join("<redacted>"));const o=m(s.replace(/\s+/gu," ").trim());return o.length>d?`${o.slice(0,d)}...`:o}function p(e){if(e.trim().length===0)return null;try{return JSON.parse(e)}catch{return f}}function $(e){return e===401?"unauthorized":e===403?"forbidden":e===404?"not-found":"rejected"}function w(e){if(typeof e=="string")return e;if(!g(e))return"";const t=typeof e.message=="string"?e.message:"";return Array.isArray(e.errors)?`${t} ${JSON.stringify(e.errors)}`:t}function y(e){if(!(e instanceof Error))return"the request failed";if(e.name==="TimeoutError")return`no answer within ${String(l/1e3)} seconds`;const t=e.cause;if(t instanceof Error){if(t.message.length>0)return t.message;if("code"in t&&typeof t.code=="string")return t.code}return e.message}function T(e){const t=new URL(e);return`${t.origin}${t.pathname}`}

package/dist/tracker/index.d.ts

@@ -0,0 +1,4 @@
+import type { Tracker, TrackerTarget } from "./types.js";
+export { TrackerError } from "./http.js";
+export type * from "./types.js";
+export declare function createTracker(target: TrackerTarget): Tracker;

package/dist/tracker/index.js

@@ -0,0 +1 @@
+import{createGiteaTracker as e}from"./gitea.js";import{createGithubTracker as o}from"./github.js";export{TrackerError}from"./http.js";export function createTracker(r){return r.provider==="github"?o(r):e(r)}

package/dist/tracker/redaction.d.ts

@@ -0,0 +1,4 @@
+export declare function redactBugText(value: string): string;
+export declare function redactRunResultText(value: string): string;
+export declare function holdsRedaction(value: string): boolean;
+export declare function redactUntilUnchanged(value: string, redact: (text: string) => string): string;

package/dist/tracker/redaction.js

@@ -0,0 +1,2 @@
+import{redactSensitiveText as d,SENSITIVE_KEY_PATTERN as T}from"../kernel/redaction.js";const c="<redacted>",E=/<redacted>(?!@)/u,A=/\b([A-Z0-9_]+)=(?=\S)/giu,R=/(?:^|_)URL$/iu,f=/["']?[a-z][a-z0-9+.-]*:\/\//iuy,_=/(?:basic|bearer|digest|negotiate|token)[ \t]/iuy,l=/(:\/\/[^:\s/@]*:)[^\s/]+(?=@)/gu,a=/\s/u,g=/(["'`]?)\b(?:(?:proxy-)?authorization|(?:set-)?cookie)[ \t]*:[ \t]*(?=\S)/giu,S=/"([^"\\\r\n]+)"(\s*:\s*)"(?:[^"\\\r\n]|\\.?)*("|$)/gmu,h=8;export function redactBugText(t){return redactUntilUnchanged(t,r=>P(I(p(d(x(r))))))}export function redactRunResultText(t){const r=t.replace(/\s+/gu," ").trim(),e=E.exec(r);return redactBugText(e===null?r:r.slice(0,e.index+c.length))}export function holdsRedaction(t){return t.includes(c)}export function redactUntilUnchanged(t,r){let e=t;for(let n=0;n<h;n+=1){const s=r(e);if(s===e)return e;e=s}return c}function x(t){const r=[];let e=0;for(const n of t.matchAll(A)){if(n.index<e)continue;const s=n[1];if(!T.test(s))continue;const o=n.index+n[0].length;R.test(s)&&u(f,t,o)||(r.push(t.slice(e,o),c),e=N(t,o))}return r.push(t.slice(e)),r.join("")}function N(t,r){const e=t[r];if(e==='"'||e==="'"){const n=i(t,r+1,e);return t[n]===e?n+1:n}if(u(_,t,r))return i(t,r,"");for(let n=r;n<t.length;n+=1)if(a.test(t[n]))return n;return t.length}function u(t,r,e){return t.lastIndex=e,t.test(r)}function p(t){return t.replace(l,`$1${c}`)}function I(t){const r=[];let e=0;for(const n of t.matchAll(g)){if(n.index<e)continue;const s=n.index+n[0].length;r.push(t.slice(e,s),c),e=i(t,s,n[1])}return r.push(t.slice(e)),r.join("")}function i(t,r,e){for(let n=r;n<t.length;n+=1){const s=t[n];if(s==="\r"||s===`
+`||s===e&&t[n-1]!=="\\")return n}return t.length}function P(t){return t.replace(S,(r,e,n,s)=>T.test(e)?`"${e}"${n}"${c}${s}`:r)}

package/dist/tracker/requests.d.ts

@@ -0,0 +1,17 @@
+import type { TrackerRequest } from "./http.js";
+import type { TrackerCommentRecord } from "./responses.js";
+import type { TrackerCommitStatus, TrackerPullRequestComment, TrackerTarget } from "./types.js";
+export declare const TRACKER_USER_AGENT = "testkit";
+export type TrackerRepository = Omit<TrackerTarget, "token">;
+export interface TrackerRoutes {
+    readonly issues: string;
+    readonly labels: string;
+    comment(id: number): string;
+    comments(pullRequest: number): string;
+    status(sha: string): string;
+}
+export declare function trackerRepository(target: TrackerTarget): TrackerRepository;
+export declare function trackerRoutes(repository: TrackerRepository): TrackerRoutes;
+export declare function getRequest(url: string, query: Readonly<Record<string, string>>): TrackerRequest;
+export declare function commitStatusRequest(routes: TrackerRoutes, status: TrackerCommitStatus): TrackerRequest;
+export declare function commentRequest(routes: TrackerRoutes, comment: TrackerPullRequestComment, existing: TrackerCommentRecord | undefined): TrackerRequest;

package/dist/tracker/requests.js

@@ -0,0 +1 @@
+export const TRACKER_USER_AGENT="testkit";export function trackerRepository(t){return{apiUrl:t.apiUrl.replace(/\/+$/u,""),name:t.name,owner:t.owner,provider:t.provider}}export function trackerRoutes(t){const e=`${t.apiUrl}/repos/${encodeURIComponent(t.owner)}/${encodeURIComponent(t.name)}`;return{comment:o=>`${e}/issues/comments/${String(o)}`,comments:o=>`${e}/issues/${String(o)}/comments`,issues:`${e}/issues`,labels:`${e}/labels`,status:o=>`${e}/statuses/${encodeURIComponent(o)}`}}export function getRequest(t,e){return{method:"GET",url:`${t}?${new URLSearchParams(e).toString()}`}}export function commitStatusRequest(t,e){return{body:{context:e.context,description:e.description,state:e.state,...e.targetUrl===null?{}:{target_url:e.targetUrl}},method:"POST",url:t.status(e.sha)}}export function commentRequest(t,e,o){return o===void 0?{body:{body:e.body},method:"POST",url:t.comments(e.pullRequest)}:{body:{body:e.body},method:"PATCH",url:t.comment(o.id)}}

package/dist/tracker/responses.d.ts

@@ -0,0 +1,24 @@
+import type { TrackerIssue, TrackerTarget } from "./types.js";
+export interface TrackerLabelRecord {
+    readonly id: number;
+    readonly name: string;
+}
+export interface TrackerIssueRecord {
+    readonly issue: TrackerIssue;
+    readonly pullRequest: boolean;
+}
+export interface TrackerCommentRecord {
+    readonly body: string;
+    readonly id: number;
+    readonly url: string;
+}
+export declare function decodeTrackerLabel(value: unknown, source: string): TrackerLabelRecord;
+export declare function decodeTrackerLabels(value: unknown, source: string): TrackerLabelRecord[];
+export declare function decodeTrackerIssue(value: unknown, source: string): TrackerIssueRecord;
+export declare function requireIssueLabels(issue: TrackerIssue, labels: readonly string[], tracker: string, repository: Pick<TrackerTarget, "name" | "owner">): TrackerIssue;
+export declare function decodeTrackerIssues(value: unknown, source: string): TrackerIssueRecord[];
+export declare function decodeTrackerComment(value: unknown, source: string): TrackerCommentRecord;
+export declare function decodeTrackerComments(value: unknown, source: string): TrackerCommentRecord[];
+export declare function decodeTrackerCommitStatusContext(value: unknown, source: string): string;
+export declare function isDuplicateLabelRejection(value: unknown): boolean;
+export declare function decodeGiteaVersion(value: unknown): string | null;

package/dist/tracker/responses.js

@@ -0,0 +1 @@
+import{isUnknownRecord as u}from"../kernel/unknown-values.js";import{TrackerError as c}from"./http.js";export function decodeTrackerLabel(t,e){const n=s(t,e,"label");return{id:m(n.id,e,"label.id"),name:i(n.name,e,"label.name")}}export function decodeTrackerLabels(t,e){return a(t,e,"labels").map(n=>decodeTrackerLabel(n,e))}export function decodeTrackerIssue(t,e){const n=s(t,e,"issue");return{issue:{body:f(n.body,e,"issue.body"),labels:(n.labels===void 0?[]:a(n.labels,e,"issue.labels")).map(r=>typeof r=="string"?r:i(s(r,e,"issue.labels[]").name,e,"issue.labels[].name")),number:m(n.number,e,"issue.number"),title:i(n.title,e,"issue.title"),url:b(n.html_url,e,"issue.html_url")},pullRequest:n.pull_request!==void 0&&n.pull_request!==null}}export function requireIssueLabels(t,e,n,r){const p=new Set(t.labels.map(l=>l.toLowerCase())),d=e.filter(l=>!p.has(l.toLowerCase()));if(d.length===0)return t;const h=`${r.owner}/${r.name}`;throw new c("forbidden",`${n} created ${t.url} without these labels: ${d.join(", ")}. The token's user may not label issues in ${h}. Close that issue, then run this again with a token whose user may label issues.`)}export function decodeTrackerIssues(t,e){return a(t,e,"issues").map(n=>decodeTrackerIssue(n,e))}export function decodeTrackerComment(t,e){const n=s(t,e,"comment");return{body:f(n.body,e,"comment.body"),id:m(n.id,e,"comment.id"),url:b(n.html_url,e,"comment.html_url")}}export function decodeTrackerComments(t,e){return a(t,e,"comments").map(n=>decodeTrackerComment(n,e))}export function decodeTrackerCommitStatusContext(t,e){return i(s(t,e,"commit status").context,e,"commit status.context")}export function isDuplicateLabelRejection(t){return!u(t)||!Array.isArray(t.errors)?!1:t.errors.some(e=>u(e)&&e.code==="already_exists")}export function decodeGiteaVersion(t){return u(t)&&typeof t.version=="string"&&t.version.length>0?t.version:null}function o(t,e,n){return new c("rejected",`${t} returned a response Testkit cannot read: ${e} must be ${n}`)}function s(t,e,n){if(!u(t))throw o(e,n,"an object");return t}function a(t,e,n){if(!Array.isArray(t))throw o(e,n,"a list");return t}function i(t,e,n){if(typeof t!="string")throw o(e,n,"a string");return t}function f(t,e,n){return t==null?"":i(t,e,n)}function m(t,e,n){if(typeof t!="number"||!Number.isSafeInteger(t)||t<=0)throw o(e,n,"a positive integer");return t}function b(t,e,n){const r=i(t,e,n);if(!/^https?:\/\/[^\s/]/u.test(r)||!URL.canParse(r))throw o(e,n,"an http or https URL");return r}

package/dist/tracker/types.d.ts

@@ -0,0 +1,51 @@
+export type TrackerProvider = "gitea" | "github";
+export interface TrackerTarget {
+    readonly apiUrl: string;
+    readonly name: string;
+    readonly owner: string;
+    readonly provider: TrackerProvider;
+    readonly token: string;
+}
+export interface TrackerLabel {
+    readonly color: string;
+    readonly description: string;
+    readonly name: string;
+}
+export interface TrackerIssue {
+    readonly body: string;
+    readonly labels: readonly string[];
+    readonly number: number;
+    readonly title: string;
+    readonly url: string;
+}
+export interface TrackerIssueDraft {
+    readonly body: string;
+    readonly labels: readonly string[];
+    readonly title: string;
+}
+export type TrackerCommitState = "failure" | "success";
+export interface TrackerCommitStatus {
+    readonly context: string;
+    readonly description: string;
+    readonly sha: string;
+    readonly state: TrackerCommitState;
+    readonly targetUrl: string | null;
+}
+export interface TrackerPullRequestComment {
+    readonly body: string;
+    readonly marker: string;
+    readonly pullRequest: number;
+}
+export interface TrackerCommentReference {
+    readonly created: boolean;
+    readonly url: string;
+}
+export type TrackerFailureKind = "forbidden" | "not-found" | "rejected" | "unauthorized" | "unreachable";
+export interface Tracker {
+    readonly target: Omit<TrackerTarget, "token">;
+    createIssue(draft: TrackerIssueDraft): Promise<TrackerIssue>;
+    ensureLabels(labels: readonly TrackerLabel[]): Promise<void>;
+    listOpenIssues(label: string): Promise<readonly TrackerIssue[]>;
+    setCommitStatus(status: TrackerCommitStatus): Promise<void>;
+    upsertPullRequestComment(comment: TrackerPullRequestComment): Promise<TrackerCommentReference>;
+}