@kindgi/cli 0.1.8-rc.0 → 0.1.9-rc.0

package/dist/exports/reader.js

@@ -0,0 +1,181 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (C) 2026 Kindgi Inc.
+/**
+ * The reads `kindgi exports create` makes, straight over HTTP: each answer
+ * is written as the route gives it, so there's nothing for a typed client
+ * to add (as `deploy/post.ts` sends its `POST` itself).
+ *
+ * - A `429` with a `Retry-After` is waited out and sent again, as the
+ *   commands that publish do (`rate-limit-wait.ts`).
+ * - A `5xx`, or no answer at all, is sent again `SERVER_ERROR_RETRIES`
+ *   times, after 1s, 2s, then 4s.
+ * - Anything else that isn't a `200` is a `ReadError`, with the status and
+ *   the code the server named.
+ */
+import { Readable } from 'node:stream';
+import { sendWaitingOutRateLimits } from '../rate-limit-wait.js';
+/** How many records a page asks for. */
+export const PAGE_SIZE = 100;
+/** How many times a `5xx`, or no answer, is sent again. */
+export const SERVER_ERROR_RETRIES = 3;
+/** A read the server refused, or that never got an answer (`status` absent). */
+export class ReadError extends Error {
+    status;
+    code;
+    constructor(message, status, code) {
+        super(message);
+        this.status = status;
+        this.code = code;
+        this.name = 'ReadError';
+    }
+}
+/** A route with its path parameters filled in, each one encoded. */
+export function fillRoute(route, values) {
+    return route.replace(/\{([^}]+)\}/g, (_m, name) => {
+        const value = values[name];
+        if (value === undefined)
+            throw new Error(`${route}: no value for {${name}}`);
+        return encodeURIComponent(value);
+    });
+}
+export function createReader(options) {
+    const base = options.apiUrl.replace(/\/+$/, '');
+    const pause = options.pause ?? pauseFor;
+    const url = (path, query) => {
+        const search = new URLSearchParams(query ?? {}).toString();
+        return `${base}${path}${search === '' ? '' : `?${search}`}`;
+    };
+    /** Send, waiting out rate limits and sending a `5xx` again; the answer, or what went wrong. */
+    async function send(method, target, extra = {}) {
+        const once = () => fetchOnce(options, method, target, extra);
+        for (let retry = 0;; retry++) {
+            const answer = await sendWaitingOutRateLimits(options, once, rateLimitRefusal);
+            if (!(answer instanceof Error) && answer.status < 500)
+                return answer;
+            if (retry >= SERVER_ERROR_RETRIES || options.stopSignal?.aborted === true) {
+                throw await unanswered(method, target, answer);
+            }
+            if (!(answer instanceof Error))
+                await answer.body?.cancel().catch(() => undefined);
+            await pause(1000 * 2 ** retry, options.stopSignal);
+        }
+    }
+    async function json(method, target, init) {
+        const res = await send(method, target, init);
+        if (res.status !== 200)
+            throw await refusal(method, target, res);
+        try {
+            return await res.json();
+        }
+        catch (err) {
+            throw new ReadError(`${method} ${target} answered 200 with a body that isn't JSON: ${err.message}`, 200);
+        }
+    }
+    return {
+        one: (path, query) => json('GET', url(path, query)),
+        async whole(path, query) {
+            const target = url(path, query);
+            const page = (await json('GET', target));
+            if (!Array.isArray(page.data)) {
+                throw new ReadError(`GET ${target} answered no \`data\` list`, 200);
+            }
+            if (page.hasMore === true) {
+                throw new ReadError(`GET ${target} says it has more, and the route takes no cursor to read it by`, 200);
+            }
+            return page.data;
+        },
+        async *pages(path, query) {
+            let cursor;
+            for (;;) {
+                const target = url(path, {
+                    ...query,
+                    limit: String(PAGE_SIZE),
+                    ...(cursor !== undefined && { cursor }),
+                });
+                const page = (await json('GET', target));
+                if (!Array.isArray(page.data)) {
+                    throw new ReadError(`GET ${target} answered no \`data\` list`, 200);
+                }
+                yield* page.data;
+                if (page.hasMore !== true)
+                    return;
+                if (typeof page.nextCursor !== 'string' || page.nextCursor === cursor) {
+                    throw new ReadError(`GET ${target} says it has more, with no new cursor to read it by`, 200);
+                }
+                cursor = page.nextCursor;
+            }
+        },
+        async bytes(path) {
+            const target = url(path);
+            const res = await send('GET', target);
+            if (res.status !== 200)
+                throw await refusal('GET', target, res);
+            if (res.body === null)
+                return Readable.from([]);
+            return Readable.fromWeb(res.body);
+        },
+        post: (path, body, idempotencyKey) => json('POST', url(path), {
+            body: JSON.stringify(body),
+            headers: { 'Content-Type': 'application/json', 'Idempotency-Key': idempotencyKey },
+        }),
+    };
+}
+/** One send: the answer, or the error that stopped it (no answer, or Ctrl+C). */
+async function fetchOnce(options, method, target, extra) {
+    try {
+        return await options.fetch(target, {
+            method,
+            headers: { Authorization: `Bearer ${options.token}`, ...extra.headers },
+            ...(extra.body !== undefined && { body: extra.body }),
+            ...(options.stopSignal !== undefined && { signal: options.stopSignal }),
+        });
+    }
+    catch (err) {
+        return err instanceof Error ? err : new Error(String(err));
+    }
+}
+/** The last `5xx`, or no answer, as a `ReadError`. */
+async function unanswered(method, target, answer) {
+    if (answer instanceof Error)
+        return new ReadError(`${method} ${target} got no answer: ${answer.message}`);
+    return refusal(method, target, answer);
+}
+/** A `429` the server says to wait out. */
+function rateLimitRefusal(answer) {
+    if (answer instanceof Error || answer.status !== 429)
+        return undefined;
+    const after = answer.headers.get('retry-after')?.trim();
+    // The server sends whole seconds.
+    if (after === undefined || !/^\d+$/.test(after))
+        return undefined;
+    return { retryAfterSeconds: Number(after) };
+}
+/** A refusal as a `ReadError`: the status, and the server's code and message when it sent them. */
+async function refusal(method, target, res) {
+    let code;
+    let message;
+    try {
+        const body = (await res.json());
+        if (typeof body?.error?.code === 'string')
+            code = body.error.code;
+        if (typeof body?.error?.message === 'string')
+            message = body.error.message;
+    }
+    catch {
+        // Not JSON: the status says it.
+    }
+    const said = code === undefined ? '' : ` ${code}${message === undefined ? '' : `: ${message}`}`;
+    return new ReadError(`${method} ${target} answered ${res.status}${said}`, res.status, code);
+}
+function pauseFor(ms, signal) {
+    return new Promise((resolve) => {
+        const done = () => {
+            clearTimeout(timer);
+            signal?.removeEventListener('abort', done);
+            resolve();
+        };
+        const timer = setTimeout(done, ms);
+        signal?.addEventListener('abort', done, { once: true });
+    });
+}
+//# sourceMappingURL=reader.js.map

package/dist/exports/reader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reader.js","sourceRoot":"","sources":["../../src/exports/reader.ts"],"names":[],"mappings":"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"}

package/dist/feedback/entries.d.ts

@@ -0,0 +1,53 @@
+/**
+ * `FEEDBACK.md`'s entries, read back: what `kindgi feedback write` appended,
+ * plus what a person or an agent edited since. An entry is a `## <title>`
+ * heading followed by its metadata list (`- **id:** …`, `- **hash:** …`,
+ * …); a `## ` heading without one is part of the entry above it, so a body
+ * can have headings of its own. Fenced code blocks are skipped.
+ *
+ * `submit`, `status` and `withdraw` edit the file through here, one line at
+ * a time, and leave every other byte as it was:
+ * - `- **submitted:** <date> · **report:** <reportId>` after the metadata,
+ *   one per submission;
+ * - ` · **withdrawn:** <date>` at the end of that line;
+ * - `> **Fixed:** <note>` under the heading, as a person marks it by hand.
+ */
+export type FeedbackKind = 'bug' | 'friction' | 'question' | 'design';
+export type FeedbackSeverity = 'blocker' | 'high' | 'medium' | 'low';
+export declare const KINDS: readonly FeedbackKind[];
+export declare const SEVERITIES: readonly FeedbackSeverity[];
+export declare const AUTHORS: readonly ["claude-code", "human", "mixed"];
+export declare const FEEDBACK_FILENAME = "FEEDBACK.md";
+/** One submission of an entry, from its `submitted` line. */
+export interface Submission {
+    readonly reportId: string;
+    readonly submittedAt: string;
+    readonly withdrawnAt?: string;
+}
+export interface FeedbackEntry {
+    readonly title: string;
+    /** The metadata as written (`id`, `hash`, `kind`, …), each value trimmed. */
+    readonly fields: Readonly<Record<string, string>>;
+    readonly body: string;
+    /** A `> **Fixed:** …` line under the heading. */
+    readonly fixed: boolean;
+    readonly submissions: readonly Submission[];
+}
+/** Every entry in the file, in order. */
+export declare function parseFeedback(text: string): FeedbackEntry[];
+/** Add one `submitted` line per report, after its entry's metadata. */
+export declare function addSubmissions(text: string, reports: readonly {
+    readonly entry: string;
+    readonly reportId: string;
+}[], submittedAt: string): {
+    readonly text: string;
+    readonly missing: readonly string[];
+};
+/** End each report's `submitted` line with ` · **withdrawn:** <date>`, once. */
+export declare function markWithdrawn(text: string, reportIds: readonly string[], withdrawnAt: string): string;
+/** Put `> **Fixed:** <note>` under the heading of each entry not marked fixed yet. */
+export declare function markFixed(text: string, fixes: readonly {
+    readonly entry: string;
+    readonly note: string;
+}[]): string;
+//# sourceMappingURL=entries.d.ts.map

package/dist/feedback/entries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entries.d.ts","sourceRoot":"","sources":["../../src/feedback/entries.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;GAaG;AAEH,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,UAAU,GAAG,UAAU,GAAG,QAAQ,CAAC;AACtE,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;AAErE,eAAO,MAAM,KAAK,EAAE,SAAS,YAAY,EAA8C,CAAC;AACxF,eAAO,MAAM,UAAU,EAAE,SAAS,gBAAgB,EAAyC,CAAC;AAC5F,eAAO,MAAM,OAAO,4CAA6C,CAAC;AAElE,eAAO,MAAM,iBAAiB,gBAAgB,CAAC;AAE/C,6DAA6D;AAC7D,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,6EAA6E;IAC7E,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAClD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,iDAAiD;IACjD,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,WAAW,EAAE,SAAS,UAAU,EAAE,CAAC;CAC7C;AAiBD,yCAAyC;AACzC,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,EAAE,CAE3D;AAED,uEAAuE;AACvE,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,SAAS;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,EAAE,EACzE,WAAW,EAAE,MAAM,GAClB;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,CAsBhE;AAED,gFAAgF;AAChF,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,SAAS,MAAM,EAAE,EAC5B,WAAW,EAAE,MAAM,GAClB,MAAM,CAYR;AAED,sFAAsF;AACtF,wBAAgB,SAAS,CACvB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,SAAS;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,GAClE,MAAM,CAiBR"}

package/dist/feedback/entries.js

@@ -0,0 +1,173 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (C) 2026 Kindgi Inc.
+export const KINDS = ['bug', 'friction', 'question', 'design'];
+export const SEVERITIES = ['blocker', 'high', 'medium', 'low'];
+export const AUTHORS = ['claude-code', 'human', 'mixed'];
+export const FEEDBACK_FILENAME = 'FEEDBACK.md';
+const HEADING = /^## (?!#)(.*)$/;
+const META = /^- \*\*[a-z][a-z-]*:\*\*/;
+const SEGMENT = /^\*\*([a-z][a-z-]*):\*\*\s*(.*)$/;
+const FIXED = /^>\s*\*\*Fixed:\*\*/;
+const FENCE = /^ {0,3}(`{3,}|~{3,})/;
+/** Every entry in the file, in order. */
+export function parseFeedback(text) {
+    return locate(splitLines(text).lines).map((l) => l.entry);
+}
+/** Add one `submitted` line per report, after its entry's metadata. */
+export function addSubmissions(text, reports, submittedAt) {
+    const { lines, eol, trailing } = splitLines(text);
+    const missing = [];
+    const located = locate(lines);
+    // Each entry's new lines, in the order the reports came in.
+    const byLine = new Map();
+    for (const report of reports) {
+        const at = located.find((l) => l.entry.fields.id === report.entry);
+        if (at === undefined) {
+            missing.push(report.entry);
+            continue;
+        }
+        const added = byLine.get(at.lastMeta) ?? [];
+        added.push(`- **submitted:** ${submittedAt} · **report:** ${report.reportId}`);
+        byLine.set(at.lastMeta, added);
+    }
+    const out = [...lines];
+    // Bottom up, so an insertion never moves a line still to be edited.
+    for (const [after, added] of [...byLine].sort((a, b) => b[0] - a[0])) {
+        out.splice(after + 1, 0, ...added);
+    }
+    return { text: joinLines(out, eol, trailing), missing };
+}
+/** End each report's `submitted` line with ` · **withdrawn:** <date>`, once. */
+export function markWithdrawn(text, reportIds, withdrawnAt) {
+    const { lines, eol, trailing } = splitLines(text);
+    const out = [...lines];
+    for (const at of locate(lines)) {
+        for (const reportId of reportIds) {
+            const line = at.submissionLines.get(reportId);
+            const sub = at.entry.submissions.find((s) => s.reportId === reportId);
+            if (line === undefined || sub === undefined || sub.withdrawnAt !== undefined)
+                continue;
+            out[line] = `${out[line].replace(/\s+$/, '')} · **withdrawn:** ${withdrawnAt}`;
+        }
+    }
+    return joinLines(out, eol, trailing);
+}
+/** Put `> **Fixed:** <note>` under the heading of each entry not marked fixed yet. */
+export function markFixed(text, fixes) {
+    const { lines, eol, trailing } = splitLines(text);
+    const out = [...lines];
+    const located = locate(lines);
+    // One note per entry (the first given), bottom up.
+    const notes = new Map();
+    for (const fix of fixes) {
+        const at = located.find((l) => l.entry.fields.id === fix.entry);
+        if (at !== undefined && !at.entry.fixed && !notes.has(at.heading)) {
+            notes.set(at.heading, fix.note);
+        }
+    }
+    for (const [heading, note] of [...notes].sort((a, b) => b[0] - a[0])) {
+        const spaced = (out[heading + 1] ?? '').trim() === '';
+        out.splice(heading + 1, 0, '', `> **Fixed:** ${note}`, ...(spaced ? [] : ['']));
+    }
+    return joinLines(out, eol, trailing);
+}
+function locate(lines) {
+    const headings = [];
+    let fence;
+    for (const [i, line] of lines.entries()) {
+        const f = FENCE.exec(line);
+        if (f !== null) {
+            const mark = f[1][0];
+            if (fence === undefined)
+                fence = mark;
+            else if (fence === mark)
+                fence = undefined;
+            continue;
+        }
+        if (fence === undefined && HEADING.test(line) && startsEntry(lines, i))
+            headings.push(i);
+    }
+    return headings.map((heading, n) => readEntry(lines, heading, headings[n + 1] ?? lines.length));
+}
+/** A heading starts an entry when its metadata list follows it (blank and `>` lines between). */
+function startsEntry(lines, heading) {
+    for (let i = heading + 1; i < lines.length; i++) {
+        const line = lines[i];
+        if (line.trim() === '' || line.startsWith('>'))
+            continue;
+        return /^- \*\*id:\*\*/.test(line);
+    }
+    return false;
+}
+function readEntry(lines, heading, end) {
+    const title = (HEADING.exec(lines[heading])?.[1] ?? '').trim();
+    let i = heading + 1;
+    let fixed = false;
+    for (; i < end; i++) {
+        const line = lines[i];
+        if (line.trim() === '')
+            continue;
+        if (line.startsWith('>')) {
+            if (FIXED.test(line))
+                fixed = true;
+            continue;
+        }
+        break;
+    }
+    const fields = {};
+    const submissions = [];
+    const submissionLines = new Map();
+    let lastMeta = i;
+    for (; i < end && META.test(lines[i]); i++) {
+        lastMeta = i;
+        const segments = readSegments(lines[i]);
+        const reportId = segments.report;
+        if (segments.submitted !== undefined && reportId !== undefined) {
+            submissions.push({
+                reportId,
+                submittedAt: segments.submitted,
+                ...(segments.withdrawn !== undefined && { withdrawnAt: segments.withdrawn }),
+            });
+            submissionLines.set(reportId, i);
+            continue;
+        }
+        for (const [key, value] of Object.entries(segments))
+            fields[key] ??= value;
+    }
+    let last = end - 1;
+    while (last >= i && lines[last].trim() === '')
+        last--;
+    if (last >= i && lines[last].trim() === '---')
+        last--;
+    const body = lines
+        .slice(i, last + 1)
+        .join('\n')
+        .trim();
+    return {
+        entry: { title, fields, body, fixed, submissions },
+        heading,
+        lastMeta,
+        submissionLines,
+    };
+}
+/** `- **sdk:** 0.1.8 · **cli:** 0.1.8 · **by:** human` as `{ sdk, cli, by }`. */
+function readSegments(line) {
+    const out = {};
+    for (const part of line.slice(2).split(' · ')) {
+        const m = SEGMENT.exec(part.trim());
+        if (m !== null)
+            out[m[1]] ??= m[2].trim();
+    }
+    return out;
+}
+/** The lines without their `\r`, and how to put them back. */
+function splitLines(text) {
+    const eol = text.includes('\r\n') ? '\r\n' : '\n';
+    const trailing = text.endsWith('\n');
+    const body = trailing ? text.replace(/\r?\n$/, '') : text;
+    return { lines: body === '' ? [] : body.split(/\r?\n/), eol, trailing };
+}
+function joinLines(lines, eol, trailing) {
+    return lines.join(eol) + (trailing ? eol : '');
+}
+//# sourceMappingURL=entries.js.map

package/dist/feedback/entries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entries.js","sourceRoot":"","sources":["../../src/feedback/entries.ts"],"names":[],"mappings":"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"}

package/dist/feedback/intake.d.ts

@@ -0,0 +1,37 @@
+import { type EntryPayload, type ReportStatus, type SubmittedReport, type WithdrawAnswer } from './protocol.js';
+export interface IntakeDeps {
+    readonly fetch: typeof fetch;
+    readonly timeoutMs?: number;
+}
+export type Asked<T> = {
+    readonly kind: 'ok';
+    readonly value: T;
+}
+/** The intake said no, in its own words (`invalid-request`, `rate-limited`, …): it did nothing. */
+ | {
+    readonly kind: 'refused';
+    readonly status: number;
+    readonly error: string;
+    readonly message: string;
+    /** With a 429: how long to wait, in seconds. */
+    readonly retryAfter?: number;
+}
+/**
+ * No answer this CLI can use. `maybeReceived` is false only when the
+ * request surely never reached the intake: no connection was made, or
+ * something in front of it answered 4xx. A timeout, a dropped connection,
+ * a 5xx, or a success this CLI can't read may follow a request that did
+ * its work.
+ */
+ | {
+    readonly kind: 'failed';
+    readonly message: string;
+    readonly maybeReceived: boolean;
+};
+export declare function sendReports(origin: string, bytes: string, sent: readonly EntryPayload[], deps: IntakeDeps): Promise<Asked<readonly SubmittedReport[]>>;
+export declare function askStatus(origin: string, reportIds: readonly string[], deps: IntakeDeps): Promise<Asked<readonly ReportStatus[]>>;
+export declare function withdrawReports(origin: string, reports: readonly {
+    readonly reportId: string;
+    readonly withdrawKey: string;
+}[], deps: IntakeDeps): Promise<Asked<WithdrawAnswer>>;
+//# sourceMappingURL=intake.d.ts.map

package/dist/feedback/intake.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intake.d.ts","sourceRoot":"","sources":["../../src/feedback/intake.ts"],"names":[],"mappings":"AAWA,OAAO,EACL,KAAK,YAAY,EAIjB,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,cAAc,EAIpB,MAAM,eAAe,CAAC;AAEvB,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,KAAK,EAAE,OAAO,KAAK,CAAC;IAC7B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,MAAM,KAAK,CAAC,CAAC,IACf;IAAE,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAA;CAAE;AAC5C,mGAAmG;GACjG;IACE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,gDAAgD;IAChD,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AACH;;;;;;GAMG;GACD;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAA;CAAE,CAAC;AAE3F,wBAAgB,WAAW,CACzB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,SAAS,YAAY,EAAE,EAC7B,IAAI,EAAE,UAAU,GACf,OAAO,CAAC,KAAK,CAAC,SAAS,eAAe,EAAE,CAAC,CAAC,CAS5C;AAED,wBAAgB,SAAS,CACvB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,SAAS,MAAM,EAAE,EAC5B,IAAI,EAAE,UAAU,GACf,OAAO,CAAC,KAAK,CAAC,SAAS,YAAY,EAAE,CAAC,CAAC,CASzC;AAED,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,SAAS;IAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;CAAE,EAAE,EAC/E,IAAI,EAAE,UAAU,GACf,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,CAahC"}

package/dist/feedback/intake.js

@@ -0,0 +1,101 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (C) 2026 Kindgi Inc.
+/**
+ * One request to the feedback intake, and what came of it. A network
+ * failure, or an answer that isn't the intake's, is said, never thrown,
+ * so the command can say what was and wasn't sent, and what may have
+ * arrived anyway.
+ */
+import { networkReason } from '../license/renew.js';
+import { FEEDBACK_REPORTS_PATH, FEEDBACK_STATUS_PATH, FEEDBACK_WITHDRAW_PATH, readStatusAnswer, readSubmitAnswer, readWithdrawAnswer, } from './protocol.js';
+export function sendReports(origin, bytes, sent, deps) {
+    return ask(origin, FEEDBACK_REPORTS_PATH, bytes, 201, (body) => readSubmitAnswer(body, sent), deps);
+}
+export function askStatus(origin, reportIds, deps) {
+    return ask(origin, FEEDBACK_STATUS_PATH, JSON.stringify({ reportIds }), 200, (body) => readStatusAnswer(body, reportIds), deps);
+}
+export function withdrawReports(origin, reports, deps) {
+    return ask(origin, FEEDBACK_WITHDRAW_PATH, JSON.stringify({ reports }), 200, (body) => readWithdrawAnswer(body, reports.map((r) => r.reportId)), deps);
+}
+async function ask(origin, path, bytes, expected, read, deps) {
+    let res;
+    let body;
+    try {
+        res = await deps.fetch(`${origin}${path}`, {
+            method: 'POST',
+            headers: { 'content-type': 'application/json' },
+            body: bytes,
+            signal: AbortSignal.timeout(deps.timeoutMs ?? 30_000),
+        });
+        body = await res.json().catch(() => undefined);
+    }
+    catch (cause) {
+        return {
+            kind: 'failed',
+            message: `${origin} couldn't be reached (${networkReason(cause)})`,
+            maybeReceived: !neverConnected(cause),
+        };
+    }
+    if (res.status === expected) {
+        const value = read(body);
+        return value === undefined
+            ? {
+                kind: 'failed',
+                message: `${origin}'s answer wasn't one this CLI can read`,
+                maybeReceived: true,
+            }
+            : { kind: 'ok', value };
+    }
+    const said = typeof body === 'object' && body !== null ? body : {};
+    if (res.status >= 500 || res.ok || typeof said.error !== 'string') {
+        // A 5xx, a proxy's page, or a success that isn't this route's: the next try may work.
+        return {
+            kind: 'failed',
+            message: `${origin} answered ${res.status}${res.status >= 500 && typeof said.error === 'string' ? ` (${said.error})` : ''}`,
+            maybeReceived: res.status < 400 || res.status >= 500,
+        };
+    }
+    const retryAfter = res.status === 429 ? retryAfterSeconds(res.headers.get('retry-after')) : undefined;
+    return {
+        kind: 'refused',
+        status: res.status,
+        error: said.error,
+        message: typeof said.message === 'string' ? said.message : `${origin} answered ${res.status}`,
+        ...(retryAfter !== undefined && { retryAfter }),
+    };
+}
+/**
+ * The error codes that mean no connection was made, so no byte of the
+ * request left: the name didn't resolve, nothing listened, no route, or the
+ * TLS handshake failed on the certificate. Anything else (a timeout, a
+ * reset) may have come after the request went.
+ */
+const NOT_CONNECTED = new Set([
+    'ENOTFOUND',
+    'EAI_AGAIN',
+    'ECONNREFUSED',
+    'EHOSTUNREACH',
+    'ENETUNREACH',
+    'UND_ERR_CONNECT_TIMEOUT',
+]);
+const CERTIFICATE_CODE = /^(?:CERT_|ERR_TLS_CERT_|UNABLE_TO_|DEPTH_ZERO_|SELF_SIGNED_)/;
+function neverConnected(err) {
+    let at = err;
+    for (let depth = 0; at instanceof Error && depth < 4; depth++) {
+        const code = at.code;
+        if (typeof code === 'string' && (NOT_CONNECTED.has(code) || CERTIFICATE_CODE.test(code)))
+            return true;
+        at = at.cause;
+    }
+    return false;
+}
+/** `Retry-After` as whole seconds: a number of seconds, or an HTTP date. */
+function retryAfterSeconds(header) {
+    if (header === null)
+        return undefined;
+    if (/^\d+$/.test(header.trim()))
+        return Number.parseInt(header.trim(), 10);
+    const at = Date.parse(header);
+    return Number.isNaN(at) ? undefined : Math.max(0, Math.ceil((at - Date.now()) / 1000));
+}
+//# sourceMappingURL=intake.js.map

package/dist/feedback/intake.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"intake.js","sourceRoot":"","sources":["../../src/feedback/intake.ts"],"names":[],"mappings":"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"}