@tapthrough/expo 0.0.0-stage → 0.1.1

package/dist/core/diagnostics.d.ts

@@ -0,0 +1,47 @@
+/** What a report carries about the moments before it: bounded, scrubbed, no request bodies. */
+export interface Diagnostics {
+    screens: {
+        path: string;
+        at: number;
+    }[];
+    logs: {
+        level: 'error' | 'warn';
+        message: string;
+        at: number;
+    }[];
+    requests: {
+        method: string;
+        path: string;
+        status: number;
+        at: number;
+    }[];
+}
+/** Removes credentials from text: query params, Bearer headers and JWT-looking strings. */
+export declare function redact(text: string): string;
+/** Host and path only: query strings often carry tokens or personal data. */
+export declare function requestPath(url: string): string;
+export declare function createDiagnostics(now?: () => number): {
+    recordScreen(path: string): void;
+    recordLog(level: "error" | "warn", args: unknown[]): void;
+    recordRequest(method: string, url: string, status: number): void;
+    snapshot(): Diagnostics;
+};
+export type DiagnosticsRecorder = ReturnType<typeof createDiagnostics>;
+interface Hooks {
+    console: Pick<Console, 'error' | 'warn'>;
+    errorUtils?: {
+        getGlobalHandler(): (error: unknown, isFatal?: boolean) => void;
+        setGlobalHandler(handler: (error: unknown, isFatal?: boolean) => void): void;
+    };
+    fetchHost: {
+        fetch: typeof fetch;
+    };
+}
+/**
+ * Starts recording console errors and warnings, uncaught errors and failed
+ * requests. Each hook calls through to the original, so the app behaves the
+ * same. Requests to `ignoreUrl` (Tapthrough itself) are skipped.
+ */
+export declare function installDiagnostics(recorder: DiagnosticsRecorder, hooks: Hooks, ignoreUrl: string): void;
+export {};
+//# sourceMappingURL=diagnostics.d.ts.map

package/dist/core/diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../../src/core/diagnostics.ts"],"names":[],"mappings":"AAAA,+FAA+F;AAC/F,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;IACvC,IAAI,EAAE;QAAE,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;IAChE,QAAQ,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;CACzE;AAID,2FAA2F;AAC3F,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQ3C;AAED,6EAA6E;AAC7E,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAI/C;AAqBD,wBAAgB,iBAAiB,CAAC,GAAG,GAAE,MAAM,MAAiB;uBAMvC,MAAM;qBAIR,OAAO,GAAG,MAAM,QAAQ,OAAO,EAAE;0BAG5B,MAAM,OAAO,MAAM,UAAU,MAAM;gBAY7C,WAAW;EAI1B;AAED,MAAM,MAAM,mBAAmB,GAAG,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAA;AAEtE,UAAU,KAAK;IACb,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAAC,CAAA;IACxC,UAAU,CAAC,EAAE;QACX,gBAAgB,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,OAAO,KAAK,IAAI,CAAA;QAC/D,gBAAgB,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI,CAAA;KAC7E,CAAA;IACD,SAAS,EAAE;QAAE,KAAK,EAAE,OAAO,KAAK,CAAA;KAAE,CAAA;CACnC;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,mBAAmB,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,QAkChG"}

package/dist/core/diagnostics.js

@@ -0,0 +1,101 @@
+const LIMITS = { screens: 20, logs: 20, requests: 10 };
+/** Removes credentials from text: query params, Bearer headers and JWT-looking strings. */
+export function redact(text) {
+    return text
+        .replace(/\b(access_token|refresh_token|id_token|token|apikey|api_key|key|password|secret|t)=([^&\s"']+)/gi, '$1=[redacted]')
+        .replace(/\bBearer\s+[^\s"']+/gi, 'Bearer [redacted]')
+        .replace(/\beyJ[\w-]+\.[\w-]+\.[\w-]+/g, '[jwt]');
+}
+/** Host and path only: query strings often carry tokens or personal data. */
+export function requestPath(url) {
+    const [withoutQuery = ''] = url.split(/[?#]/);
+    const match = /^[a-z][a-z0-9+.-]*:\/\/([^/]+)(\/.*)?$/i.exec(withoutQuery);
+    return redact(match ? `${match[1]}${match[2] ?? '/'}` : withoutQuery);
+}
+function format(args) {
+    return args
+        .map((arg) => {
+        if (typeof arg === 'string')
+            return arg;
+        if (arg instanceof Error)
+            return `${arg.name}: ${arg.message}`;
+        try {
+            return JSON.stringify(arg);
+        }
+        catch {
+            return String(arg);
+        }
+    })
+        .join(' ');
+}
+function push(list, item, max) {
+    list.push(item);
+    if (list.length > max)
+        list.splice(0, list.length - max);
+}
+export function createDiagnostics(now = Date.now) {
+    const screens = [];
+    const logs = [];
+    const requests = [];
+    return {
+        recordScreen(path) {
+            if (screens.at(-1)?.path === path)
+                return;
+            push(screens, { path: requestPath(path), at: now() }, LIMITS.screens);
+        },
+        recordLog(level, args) {
+            push(logs, { level, message: redact(format(args)).slice(0, 500), at: now() }, LIMITS.logs);
+        },
+        recordRequest(method, url, status) {
+            push(requests, {
+                method: method.toUpperCase().slice(0, 10),
+                path: requestPath(url).slice(0, 300),
+                status,
+                at: now(),
+            }, LIMITS.requests);
+        },
+        snapshot() {
+            return { screens: [...screens], logs: [...logs], requests: [...requests] };
+        },
+    };
+}
+/**
+ * Starts recording console errors and warnings, uncaught errors and failed
+ * requests. Each hook calls through to the original, so the app behaves the
+ * same. Requests to `ignoreUrl` (Tapthrough itself) are skipped.
+ */
+export function installDiagnostics(recorder, hooks, ignoreUrl) {
+    const { console: target, errorUtils, fetchHost } = hooks;
+    for (const level of ['error', 'warn']) {
+        const original = target[level].bind(target);
+        target[level] = (...args) => {
+            recorder.recordLog(level, args);
+            original(...args);
+        };
+    }
+    if (errorUtils) {
+        const previous = errorUtils.getGlobalHandler();
+        errorUtils.setGlobalHandler((error, isFatal) => {
+            recorder.recordLog('error', [isFatal ? 'Uncaught (fatal):' : 'Uncaught:', error]);
+            previous(error, isFatal);
+        });
+    }
+    const originalFetch = fetchHost.fetch;
+    fetchHost.fetch = async (input, init) => {
+        const url = typeof input === 'string' ? input : input instanceof URL ? input.href : input.url;
+        const method = init?.method ?? (typeof input === 'object' && 'method' in input ? input.method : 'GET');
+        const ignored = url.startsWith(ignoreUrl);
+        try {
+            const response = await originalFetch(input, init);
+            if (!ignored && !response.ok)
+                recorder.recordRequest(method, url, response.status);
+            return response;
+        }
+        catch (error) {
+            if (!ignored)
+                recorder.recordRequest(method, url, 0);
+            throw error;
+        }
+    };
+}
+//# sourceMappingURL=diagnostics.js.map

package/dist/core/diagnostics.js.map

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

package/dist/core/feedback.d.ts

@@ -0,0 +1,302 @@
+import type { Platform } from '@tapthrough/protocol';
+import type { Annotation } from './annotations.js';
+import type { Diagnostics } from './diagnostics.js';
+/** Which PR build is running, read from the loaded EAS update's manifest. */
+export interface PreviewContext {
+    updateGroupId: string;
+    /** The EAS project the update belongs to; the server checks it against the repo. */
+    projectId: string;
+    /** The EAS Update branch, e.g. `pr-142`. */
+    branch: string | undefined;
+}
+/**
+ * The update group of the running EAS update, from `Constants.manifest2`.
+ * A development build has it however the update was opened (QR code, Orbit
+ * or a Tapthrough link); an embedded or local build has none.
+ */
+export declare function previewContextFromManifest(manifest: unknown): PreviewContext | null;
+/** A link token's payload, read without verification (the seed hook and server verify). */
+export declare function decodeTokenClaims(token: string): Record<string, unknown> | undefined;
+/**
+ * The scenario ID (`scn`) from a link token, for attributing reports. The
+ * server checks the ID belongs to the same PR.
+ */
+export declare function scenarioIdFromToken(token: string): string | undefined;
+export interface FeedbackInput {
+    preview: PreviewContext;
+    platform: Platform;
+    body: string;
+    reporterName?: string;
+    route?: string;
+    scenarioId?: string;
+    device?: {
+        os?: string;
+        osVersion?: string;
+        model?: string;
+    };
+    screenshot?: {
+        contentType: 'image/jpeg' | 'image/png';
+        base64: string;
+    };
+    diagnostics?: Diagnostics;
+    /** Boxes drawn on the screenshot; only sent with a screenshot. */
+    annotations?: Annotation[];
+    /** The reporter's own call; left out, Tapthrough guesses. */
+    cause?: 'pr' | 'unrelated';
+}
+/** Whether a report is caused by the PR: Tapthrough's guess unless a person said. */
+export type Cause = 'pr' | 'unrelated' | 'unknown';
+export interface Triage {
+    cause: Cause;
+    causeSource: 'guess' | 'reporter' | 'developer';
+    /** Plain-text reasons behind the guess. */
+    reasons: string[];
+    /** GitHub's prefilled new-issue form, for bugs the PR didn't cause. */
+    issueUrl?: string;
+    /** `auto`: an issue filed from here gets `tapthrough:fix` and Claude starts. `label`: a developer adds it. */
+    issueFix?: 'auto' | 'label';
+}
+export type FeedbackResult = ({
+    ok: true;
+    commentUrl: string;
+    findingId?: string;
+} & Partial<Triage>) | {
+    ok: false;
+    message: string;
+};
+/** Markdown reasons from the server, as plain text for the app. */
+export declare function plainReason(reason: string): string;
+/** Posts a report to Tapthrough, which comments it on the PR. Never throws. */
+export declare function sendFeedback(input: FeedbackInput, options: {
+    apiUrl: string;
+    fetch?: typeof fetch;
+}): Promise<FeedbackResult>;
+export type StepResultValue = 'pass' | 'fail' | 'skip';
+export interface ChecklistStep {
+    index: number;
+    action: string;
+    expect: string;
+    result: {
+        result: StepResultValue;
+        reporter: string | null;
+        platform: Platform;
+        /** Checked on this earlier commit; the push since didn't touch the screen. */
+        carriedFrom?: string;
+    } | null;
+}
+/** Checks from an earlier commit that a push cleared, and why. */
+export interface ChecklistReset {
+    fromSha: string;
+    cleared: number;
+    reason: 'code' | 'config' | 'unknown';
+}
+/** Why the checklist started over, for a reviewer. */
+export declare function resetMessage(reset: ChecklistReset): string;
+/** A report from an earlier commit, to re-check on this build. */
+export interface RecheckItem {
+    id: string;
+    excerpt: string;
+    reporter: string | null;
+    sha: string;
+    platform: Platform;
+    stillBrokenHere: boolean;
+}
+/** A later push to the PR than the build that's running. */
+export interface NewerBuild {
+    sha: string;
+    updateGroupId: string;
+    /** Opens it in the development build; null when the server can't build the link. */
+    openUrl: string | null;
+    /** True when the push is a fix Claude made for a report. */
+    hasFix: boolean;
+}
+/**
+ * One part of getting the app into a scenario's starting state, said two ways:
+ * what Tapthrough does when it sets the app up, and what a person does by hand.
+ */
+export interface SetupLine {
+    kind: 'account' | 'data' | 'flag' | 'screen';
+    /** e.g. "Signs you in as a test user with the viewer role" */
+    auto: string;
+    /** e.g. "Sign in as a user with the viewer role" */
+    manual: string;
+}
+export interface ChecklistScenario {
+    key: string;
+    title: string;
+    routePath: string;
+    /** Why the PR runs it, e.g. "This PR changes src/app/index.tsx". Older servers omit it. */
+    why?: string | null;
+    /** How the starting state is made. Older servers omit it. */
+    setup?: SetupLine[];
+    steps: ChecklistStep[];
+}
+/** A scenario in the run that isn't part of the PR's plan, for jumping into its state. */
+export interface LibraryEntry {
+    key: string;
+    title: string;
+    routePath: string;
+    /** True for scenarios already in `scenarios`. */
+    picked: boolean;
+    why?: string | null;
+    setup?: SetupLine[];
+}
+export interface Checklist {
+    pr: number;
+    sha: string;
+    open: boolean;
+    scenarios: ChecklistScenario[];
+    recheck?: RecheckItem[];
+    newerBuild?: NewerBuild | null;
+    library?: LibraryEntry[];
+    reset?: ChecklistReset | null;
+}
+/** Whether the Review sheet has anything to show. */
+export declare function hasReviewItems(checklist: Checklist | null): checklist is Checklist;
+export interface Progress {
+    total: number;
+    passed: number;
+    failed: number;
+}
+/** Step results across the plan, keyed `scenario:index` like the Review sheet. */
+export declare function checklistProgress(checklist: Checklist, results?: Record<string, StepResultValue | undefined>): Progress;
+/** One line for the sheet's header, e.g. `1 of 3 checked` or `3 of 3 passed`. */
+export declare function progressLabel({ total, passed, failed }: Progress): string;
+export type Badge = {
+    kind: 'new-build';
+} | {
+    kind: 'failed';
+} | {
+    kind: 'remaining';
+    count: number;
+} | {
+    kind: 'done';
+}
+/** Nothing to check here, but an idea waits on someone: questions, or a build to test. */
+ | {
+    kind: 'idea';
+};
+/** What the floating Review button shows: a new build wins, then failures, then steps left. */
+export declare function reviewBadge(checklist: Checklist | null): Badge | null;
+/** Marks an earlier report fixed or still broken on this build. Never throws. */
+export declare function sendRecheck(input: {
+    preview: PreviewContext;
+    platform: Platform;
+    findingId: string;
+    result: 'fixed' | 'still_broken';
+    reporterName?: string;
+}, options: {
+    apiUrl: string;
+    fetch?: typeof fetch;
+}): Promise<{
+    ok: true;
+} | {
+    ok: false;
+    message: string;
+}>;
+/** The reporter saying whether the PR caused a report. Never throws. */
+export declare function sendCause(input: {
+    preview: PreviewContext;
+    platform: Platform;
+    findingId: string;
+    cause: 'pr' | 'unrelated';
+}, options: {
+    apiUrl: string;
+    fetch?: typeof fetch;
+}): Promise<{
+    ok: true;
+} | {
+    ok: false;
+    message: string;
+}>;
+export type FixRequestResult = {
+    ok: true;
+    status: 'requested' | 'not_set_up';
+} | {
+    ok: false;
+    message: string;
+};
+/** Asks Claude to fix a report on the PR's branch, in the repo's own Actions. Never throws. */
+export declare function requestFix(input: {
+    preview: PreviewContext;
+    platform: Platform;
+    findingId: string;
+    reporterName?: string;
+}, options: {
+    apiUrl: string;
+    fetch?: typeof fetch;
+}): Promise<FixRequestResult>;
+/** What happened to Claude after filing; `off` means a developer adds the label, null that it was filed before. */
+export type IssueFix = 'started' | 'not_set_up' | 'refused' | 'off' | null;
+export type IssueFileResult = {
+    ok: true;
+    issueNumber: number;
+    issueUrl: string;
+    fix: IssueFix;
+}
+/** `openInBrowser`: Tapthrough can't file it here, so offer GitHub's prefilled form instead. */
+ | {
+    ok: false;
+    message: string;
+    openInBrowser: boolean;
+};
+/**
+ * Files a report as a GitHub issue through Tapthrough, so the reporter doesn't
+ * need to sign in to GitHub on the phone. Never throws.
+ */
+export declare function fileIssue(input: {
+    preview: PreviewContext;
+    platform: Platform;
+    findingId: string;
+}, options: {
+    apiUrl: string;
+    fetch?: typeof fetch;
+}): Promise<IssueFileResult>;
+export type LaunchRequestResult = {
+    ok: true;
+    launchUrl: string;
+} | {
+    ok: false;
+    message: string;
+};
+/**
+ * Asks Tapthrough for a launch link into one of the PR's scenarios, so the
+ * app can set itself up for it without leaving. Never throws.
+ */
+export declare function requestLaunch(input: {
+    preview: PreviewContext;
+    platform: Platform;
+    scenarioKey: string;
+}, options: {
+    apiUrl: string;
+    fetch?: typeof fetch;
+}): Promise<LaunchRequestResult>;
+/** The PR's test plan and current results for the running build, or null if there isn't one. */
+export declare function fetchChecklist(preview: PreviewContext, platform: Platform, options: {
+    apiUrl: string;
+    fetch?: typeof fetch;
+}): Promise<Checklist | null>;
+/** Records a pass, fail or skip for one step. Never throws. */
+export declare function sendStepResult(input: {
+    preview: PreviewContext;
+    platform: Platform;
+    scenarioKey: string;
+    stepIndex: number;
+    result: StepResultValue;
+    reporterName?: string;
+    findingId?: string;
+}, options: {
+    apiUrl: string;
+    fetch?: typeof fetch;
+}): Promise<{
+    ok: true;
+} | {
+    ok: false;
+    message: string;
+}>;
+/** The report body for a failed step: the step and its expectation, then the reviewer's note. */
+export declare function failedStepBody(step: {
+    action: string;
+    expect: string;
+}, note: string): string;
+//# sourceMappingURL=feedback.d.ts.map

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

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