@merittdev/horus-lens 0.0.1

package/dist/dashboard.d.cts

@@ -0,0 +1,707 @@
+import { z } from 'zod';
+
+/**
+ * Heavy payloads are uploaded to S3 as individual assets via presigned URLs;
+ * the finalize call carries only metadata + asset manifest.
+ */
+declare const AssetKindSchema: z.ZodEnum<{
+    replay: "replay";
+    console: "console";
+    network: "network";
+    dom: "dom";
+    screenshot: "screenshot";
+    attachment: "attachment";
+}>;
+type AssetKind = z.infer<typeof AssetKindSchema>;
+declare const AssetRefSchema: z.ZodObject<{
+    kind: z.ZodEnum<{
+        replay: "replay";
+        console: "console";
+        network: "network";
+        dom: "dom";
+        screenshot: "screenshot";
+        attachment: "attachment";
+    }>;
+    key: z.ZodString;
+    contentType: z.ZodString;
+    byteSize: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+type AssetRef = z.infer<typeof AssetRefSchema>;
+declare const ReportStatusSchema: z.ZodEnum<{
+    initiated: "initiated";
+    submitted: "submitted";
+    triaged: "triaged";
+    linked: "linked";
+    resolved: "resolved";
+}>;
+type ReportStatus = z.infer<typeof ReportStatusSchema>;
+declare const ReportMetadataSchema: z.ZodObject<{
+    comment: z.ZodOptional<z.ZodString>;
+    annotations: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        kind: z.ZodEnum<{
+            rect: "rect";
+            ellipse: "ellipse";
+            arrow: "arrow";
+        }>;
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+        viewport: z.ZodObject<{
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+        }, z.core.$strip>;
+    }, z.core.$strip>>>;
+    target: z.ZodOptional<z.ZodObject<{
+        domPath: z.ZodOptional<z.ZodString>;
+        tagName: z.ZodOptional<z.ZodString>;
+        text: z.ZodOptional<z.ZodString>;
+        boundingRect: z.ZodOptional<z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+        }, z.core.$strip>>;
+        reactComponents: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+    env: z.ZodObject<{
+        url: z.ZodString;
+        route: z.ZodOptional<z.ZodString>;
+        referrer: z.ZodOptional<z.ZodString>;
+        userAgent: z.ZodString;
+        browser: z.ZodOptional<z.ZodString>;
+        os: z.ZodOptional<z.ZodString>;
+        device: z.ZodOptional<z.ZodEnum<{
+            desktop: "desktop";
+            tablet: "tablet";
+            mobile: "mobile";
+        }>>;
+        viewport: z.ZodObject<{
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+        }, z.core.$strip>;
+        screen: z.ZodObject<{
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+        }, z.core.$strip>;
+        devicePixelRatio: z.ZodNumber;
+        language: z.ZodString;
+        timezone: z.ZodString;
+        theme: z.ZodOptional<z.ZodEnum<{
+            light: "light";
+            dark: "dark";
+        }>>;
+        online: z.ZodOptional<z.ZodBoolean>;
+        capturedAt: z.ZodNumber;
+    }, z.core.$strip>;
+    app: z.ZodOptional<z.ZodObject<{
+        release: z.ZodOptional<z.ZodString>;
+        gitSha: z.ZodOptional<z.ZodString>;
+        environment: z.ZodOptional<z.ZodString>;
+        featureFlags: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodBoolean, z.ZodNumber]>>>;
+        user: z.ZodOptional<z.ZodObject<{
+            id: z.ZodOptional<z.ZodString>;
+            email: z.ZodOptional<z.ZodString>;
+            name: z.ZodOptional<z.ZodString>;
+            organization: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        extra: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>>;
+    errors: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        message: z.ZodString;
+        stack: z.ZodOptional<z.ZodString>;
+        source: z.ZodEnum<{
+            "window.onerror": "window.onerror";
+            unhandledrejection: "unhandledrejection";
+            "console.error": "console.error";
+            "react-boundary": "react-boundary";
+        }>;
+        timestamp: z.ZodNumber;
+    }, z.core.$strip>>>;
+    consoleTail: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        level: z.ZodEnum<{
+            log: "log";
+            info: "info";
+            warn: "warn";
+            error: "error";
+            debug: "debug";
+        }>;
+        args: z.ZodArray<z.ZodString>;
+        timestamp: z.ZodNumber;
+    }, z.core.$strip>>>;
+    networkTail: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        method: z.ZodString;
+        url: z.ZodString;
+        status: z.ZodNullable<z.ZodNumber>;
+        ok: z.ZodNullable<z.ZodBoolean>;
+        durationMs: z.ZodNullable<z.ZodNumber>;
+        requestType: z.ZodEnum<{
+            fetch: "fetch";
+            xhr: "xhr";
+        }>;
+        startedAt: z.ZodNumber;
+        error: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    sdk: z.ZodObject<{
+        name: z.ZodString;
+        version: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+type ReportMetadata = z.infer<typeof ReportMetadataSchema>;
+declare const ReportSchema: z.ZodObject<{
+    id: z.ZodString;
+    projectId: z.ZodString;
+    status: z.ZodEnum<{
+        initiated: "initiated";
+        submitted: "submitted";
+        triaged: "triaged";
+        linked: "linked";
+        resolved: "resolved";
+    }>;
+    createdAt: z.ZodString;
+    submittedAt: z.ZodNullable<z.ZodString>;
+    metadata: z.ZodNullable<z.ZodObject<{
+        comment: z.ZodOptional<z.ZodString>;
+        annotations: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            kind: z.ZodEnum<{
+                rect: "rect";
+                ellipse: "ellipse";
+                arrow: "arrow";
+            }>;
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+            viewport: z.ZodObject<{
+                width: z.ZodNumber;
+                height: z.ZodNumber;
+            }, z.core.$strip>;
+        }, z.core.$strip>>>;
+        target: z.ZodOptional<z.ZodObject<{
+            domPath: z.ZodOptional<z.ZodString>;
+            tagName: z.ZodOptional<z.ZodString>;
+            text: z.ZodOptional<z.ZodString>;
+            boundingRect: z.ZodOptional<z.ZodObject<{
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+                width: z.ZodNumber;
+                height: z.ZodNumber;
+            }, z.core.$strip>>;
+            reactComponents: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>>;
+        env: z.ZodObject<{
+            url: z.ZodString;
+            route: z.ZodOptional<z.ZodString>;
+            referrer: z.ZodOptional<z.ZodString>;
+            userAgent: z.ZodString;
+            browser: z.ZodOptional<z.ZodString>;
+            os: z.ZodOptional<z.ZodString>;
+            device: z.ZodOptional<z.ZodEnum<{
+                desktop: "desktop";
+                tablet: "tablet";
+                mobile: "mobile";
+            }>>;
+            viewport: z.ZodObject<{
+                width: z.ZodNumber;
+                height: z.ZodNumber;
+            }, z.core.$strip>;
+            screen: z.ZodObject<{
+                width: z.ZodNumber;
+                height: z.ZodNumber;
+            }, z.core.$strip>;
+            devicePixelRatio: z.ZodNumber;
+            language: z.ZodString;
+            timezone: z.ZodString;
+            theme: z.ZodOptional<z.ZodEnum<{
+                light: "light";
+                dark: "dark";
+            }>>;
+            online: z.ZodOptional<z.ZodBoolean>;
+            capturedAt: z.ZodNumber;
+        }, z.core.$strip>;
+        app: z.ZodOptional<z.ZodObject<{
+            release: z.ZodOptional<z.ZodString>;
+            gitSha: z.ZodOptional<z.ZodString>;
+            environment: z.ZodOptional<z.ZodString>;
+            featureFlags: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodBoolean, z.ZodNumber]>>>;
+            user: z.ZodOptional<z.ZodObject<{
+                id: z.ZodOptional<z.ZodString>;
+                email: z.ZodOptional<z.ZodString>;
+                name: z.ZodOptional<z.ZodString>;
+                organization: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+            extra: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$strip>>;
+        errors: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            message: z.ZodString;
+            stack: z.ZodOptional<z.ZodString>;
+            source: z.ZodEnum<{
+                "window.onerror": "window.onerror";
+                unhandledrejection: "unhandledrejection";
+                "console.error": "console.error";
+                "react-boundary": "react-boundary";
+            }>;
+            timestamp: z.ZodNumber;
+        }, z.core.$strip>>>;
+        consoleTail: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            level: z.ZodEnum<{
+                log: "log";
+                info: "info";
+                warn: "warn";
+                error: "error";
+                debug: "debug";
+            }>;
+            args: z.ZodArray<z.ZodString>;
+            timestamp: z.ZodNumber;
+        }, z.core.$strip>>>;
+        networkTail: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            method: z.ZodString;
+            url: z.ZodString;
+            status: z.ZodNullable<z.ZodNumber>;
+            ok: z.ZodNullable<z.ZodBoolean>;
+            durationMs: z.ZodNullable<z.ZodNumber>;
+            requestType: z.ZodEnum<{
+                fetch: "fetch";
+                xhr: "xhr";
+            }>;
+            startedAt: z.ZodNumber;
+            error: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+        sdk: z.ZodObject<{
+            name: z.ZodString;
+            version: z.ZodString;
+        }, z.core.$strip>;
+    }, z.core.$strip>>;
+    assets: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        kind: z.ZodEnum<{
+            replay: "replay";
+            console: "console";
+            network: "network";
+            dom: "dom";
+            screenshot: "screenshot";
+            attachment: "attachment";
+        }>;
+        key: z.ZodString;
+        contentType: z.ZodString;
+        byteSize: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>>;
+    externalIssue: z.ZodDefault<z.ZodNullable<z.ZodObject<{
+        provider: z.ZodString;
+        key: z.ZodString;
+        url: z.ZodString;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+type Report = z.infer<typeof ReportSchema>;
+declare const ReportSummarySchema: z.ZodObject<{
+    status: z.ZodEnum<{
+        initiated: "initiated";
+        submitted: "submitted";
+        triaged: "triaged";
+        linked: "linked";
+        resolved: "resolved";
+    }>;
+    id: z.ZodString;
+    projectId: z.ZodString;
+    createdAt: z.ZodString;
+    submittedAt: z.ZodNullable<z.ZodString>;
+    externalIssue: z.ZodDefault<z.ZodNullable<z.ZodObject<{
+        provider: z.ZodString;
+        key: z.ZodString;
+        url: z.ZodString;
+    }, z.core.$strip>>>;
+    comment: z.ZodOptional<z.ZodString>;
+    url: z.ZodOptional<z.ZodString>;
+    errorCount: z.ZodDefault<z.ZodNumber>;
+    hasReplay: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+type ReportSummary = z.infer<typeof ReportSummarySchema>;
+
+declare const IntegrationProviderSchema: z.ZodEnum<{
+    github: "github";
+    jira: "jira";
+    linear: "linear";
+}>;
+type IntegrationProvider = z.infer<typeof IntegrationProviderSchema>;
+declare const IntegrationStatusSchema: z.ZodEnum<{
+    disconnected: "disconnected";
+    pending: "pending";
+    connected: "connected";
+}>;
+type IntegrationStatus = z.infer<typeof IntegrationStatusSchema>;
+/**
+ * One integration per provider per project; at most ONE is `active` — the
+ * active one is the destination issues are routed to.
+ */
+/** Non-secret issue-routing settings, editable from the dashboard. */
+declare const IntegrationConfigSchema: z.ZodObject<{
+    repo: z.ZodOptional<z.ZodString>;
+    teamKey: z.ZodOptional<z.ZodString>;
+    projectKey: z.ZodOptional<z.ZodString>;
+    issueType: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type IntegrationConfig = z.infer<typeof IntegrationConfigSchema>;
+declare const IntegrationSchema: z.ZodObject<{
+    provider: z.ZodEnum<{
+        github: "github";
+        jira: "jira";
+        linear: "linear";
+    }>;
+    status: z.ZodEnum<{
+        disconnected: "disconnected";
+        pending: "pending";
+        connected: "connected";
+    }>;
+    account: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    active: z.ZodDefault<z.ZodBoolean>;
+    config: z.ZodDefault<z.ZodObject<{
+        repo: z.ZodOptional<z.ZodString>;
+        teamKey: z.ZodOptional<z.ZodString>;
+        projectKey: z.ZodOptional<z.ZodString>;
+        issueType: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+type Integration = z.infer<typeof IntegrationSchema>;
+/** Write-only S3 credentials. The secret is never returned by any endpoint. */
+declare const S3ConfigInputSchema: z.ZodObject<{
+    bucket: z.ZodString;
+    region: z.ZodString;
+    endpoint: z.ZodOptional<z.ZodString>;
+    accessKeyId: z.ZodString;
+    secretAccessKey: z.ZodString;
+    forcePathStyle: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+type S3ConfigInput = z.infer<typeof S3ConfigInputSchema>;
+/** What the API returns about a project's S3 config — secret omitted, key masked. */
+declare const S3ConfigPublicSchema: z.ZodObject<{
+    bucket: z.ZodString;
+    region: z.ZodString;
+    endpoint: z.ZodOptional<z.ZodString>;
+    forcePathStyle: z.ZodOptional<z.ZodBoolean>;
+    accessKeyIdMasked: z.ZodString;
+}, z.core.$strip>;
+type S3ConfigPublic = z.infer<typeof S3ConfigPublicSchema>;
+declare const ProjectSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    accessId: z.ZodString;
+    allowedOrigins: z.ZodArray<z.ZodString>;
+    destination: z.ZodNullable<z.ZodEnum<{
+        github: "github";
+        jira: "jira";
+        linear: "linear";
+    }>>;
+    dashboardUrl: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    s3: z.ZodNullable<z.ZodObject<{
+        bucket: z.ZodString;
+        region: z.ZodString;
+        endpoint: z.ZodOptional<z.ZodString>;
+        forcePathStyle: z.ZodOptional<z.ZodBoolean>;
+        accessKeyIdMasked: z.ZodString;
+    }, z.core.$strip>>;
+    onboardedAt: z.ZodNullable<z.ZodString>;
+    createdAt: z.ZodString;
+}, z.core.$strip>;
+type Project = z.infer<typeof ProjectSchema>;
+/** POST /v1/projects — bootstrap auth (admin token). Secret is shown exactly once. */
+declare const CreateProjectRequestSchema: z.ZodObject<{
+    name: z.ZodString;
+    allowedOrigins: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+type CreateProjectRequest = z.infer<typeof CreateProjectRequestSchema>;
+declare const CreateProjectResponseSchema: z.ZodObject<{
+    project: z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        accessId: z.ZodString;
+        allowedOrigins: z.ZodArray<z.ZodString>;
+        destination: z.ZodNullable<z.ZodEnum<{
+            github: "github";
+            jira: "jira";
+            linear: "linear";
+        }>>;
+        dashboardUrl: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        s3: z.ZodNullable<z.ZodObject<{
+            bucket: z.ZodString;
+            region: z.ZodString;
+            endpoint: z.ZodOptional<z.ZodString>;
+            forcePathStyle: z.ZodOptional<z.ZodBoolean>;
+            accessKeyIdMasked: z.ZodString;
+        }, z.core.$strip>>;
+        onboardedAt: z.ZodNullable<z.ZodString>;
+        createdAt: z.ZodString;
+    }, z.core.$strip>;
+    accessId: z.ZodString;
+    accessSecret: z.ZodString;
+}, z.core.$strip>;
+type CreateProjectResponse = z.infer<typeof CreateProjectResponseSchema>;
+/** PATCH /v1/project — secret auth. */
+declare const UpdateProjectRequestSchema: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    allowedOrigins: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    onboarded: z.ZodOptional<z.ZodBoolean>;
+    dashboardUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+type UpdateProjectRequest = z.infer<typeof UpdateProjectRequestSchema>;
+declare const ListIntegrationsResponseSchema: z.ZodObject<{
+    integrations: z.ZodArray<z.ZodObject<{
+        provider: z.ZodEnum<{
+            github: "github";
+            jira: "jira";
+            linear: "linear";
+        }>;
+        status: z.ZodEnum<{
+            disconnected: "disconnected";
+            pending: "pending";
+            connected: "connected";
+        }>;
+        account: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        active: z.ZodDefault<z.ZodBoolean>;
+        config: z.ZodDefault<z.ZodObject<{
+            repo: z.ZodOptional<z.ZodString>;
+            teamKey: z.ZodOptional<z.ZodString>;
+            projectKey: z.ZodOptional<z.ZodString>;
+            issueType: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+type ListIntegrationsResponse = z.infer<typeof ListIntegrationsResponseSchema>;
+declare const ConnectIntegrationResponseSchema: z.ZodObject<{
+    authorizeUrl: z.ZodString;
+    provider: z.ZodEnum<{
+        github: "github";
+        jira: "jira";
+        linear: "linear";
+    }>;
+}, z.core.$strip>;
+type ConnectIntegrationResponse = z.infer<typeof ConnectIntegrationResponseSchema>;
+
+interface ListReportsQuery {
+    status?: ReportStatus;
+    /** Case-insensitive substring search over comment and URL. */
+    q?: string;
+    limit?: number;
+    cursor?: string;
+}
+interface ListReportsResult {
+    reports: ReportSummary[];
+    nextCursor: string | null;
+}
+/**
+ * Typed fetch client for the Lens management API. Every request is
+ * authenticated with `Authorization: Bearer <token>` where the token is
+ * resolved lazily via `config.getToken` on each call — so hosts can hand out
+ * short-lived, server-minted tokens instead of leaking the long-lived
+ * `accessSecret` to the browser.
+ */
+interface LensApi {
+    listReports(query?: ListReportsQuery): Promise<ListReportsResult>;
+    getReport(id: string): Promise<Report>;
+    /** Resolves the short-lived signed GET URL for a report asset. */
+    getAssetUrl(id: string, kind: AssetKind): Promise<string>;
+    /** Fetches a report asset and parses it as JSON (e.g. the rrweb replay events). */
+    getAssetJson<T>(id: string, kind: AssetKind): Promise<T>;
+    listIntegrations(): Promise<Integration[]>;
+    connectIntegration(provider: IntegrationProvider, opts?: {
+        returnUrl?: string;
+    }): Promise<ConnectIntegrationResponse>;
+    /**
+     * Dev-only: completes the OAuth dance that `connectIntegration` starts,
+     * flipping the provider to `connected` (and active as the destination).
+     */
+    completeIntegrationDev(provider: IntegrationProvider, account?: string): Promise<Integration>;
+    /** Makes `provider` the single active issue destination; returns the refreshed list. */
+    activateIntegration(provider: IntegrationProvider): Promise<Integration[]>;
+    /** Disconnects `provider`; returns the refreshed list. */
+    disconnectIntegration(provider: IntegrationProvider): Promise<Integration[]>;
+    /** Updates `provider`'s non-secret issue-routing config; returns the refreshed list. */
+    updateIntegrationConfig(provider: IntegrationProvider, config: IntegrationConfig): Promise<Integration[]>;
+    /** Bootstrap/admin auth. `accessSecret` is returned exactly once. */
+    createProject(body: CreateProjectRequest): Promise<CreateProjectResponse>;
+    /** Reads the current project (S3 config masked, secret never returned). */
+    getProject(): Promise<Project>;
+    updateProject(body: UpdateProjectRequest): Promise<Project>;
+    /** Verifies + stores S3 credentials. Rejects with code `s3_verification_failed` on bad creds. */
+    setS3Config(body: S3ConfigInput): Promise<Project>;
+    /** Removes the project's S3 config, reverting to Lens-managed storage. */
+    clearS3Config(): Promise<Project>;
+    /** Effective asset storage for the project (status only — credentials live in env). */
+    getStorageStatus(): Promise<StorageStatus>;
+}
+interface StorageStatus {
+    mode: 's3' | 'local';
+    /** 'project' = per-project credentials, 'env' = the Lens API's environment. */
+    source: 'project' | 'env' | null;
+    bucket: string | null;
+    region: string | null;
+    /** Dev only. In production, report intake is rejected until S3 is configured. */
+    localAllowed: boolean;
+}
+interface LensApiConfig {
+    /** Base URL of the management API, e.g. `https://lens.acme.com` (no trailing `/v1`). */
+    baseUrl: string;
+    /**
+     * Resolves a bearer token for each request. Return a short-lived token
+     * minted by your backend — or an empty string when the host proxies
+     * requests server-side and attaches credentials there (no Authorization
+     * header is sent in that case, which keeps auth middleware like Clerk from
+     * trying to validate a foreign bearer token).
+     */
+    getToken: () => string | Promise<string>;
+    /**
+     * Header used to carry the token. Defaults to `Authorization` with a
+     * `Bearer ` prefix. Set a custom header (e.g. `x-lens-token`, sent raw)
+     * when requests pass through auth middleware that hijacks Authorization
+     * bearer tokens (Clerk returns 404 for foreign ones).
+     */
+    tokenHeader?: string;
+    /**
+     * Resolves the active Lens project id for hosts that manage multiple
+     * projects behind one server-side proxy. When it returns a non-empty
+     * string, every request additionally sends it as the `x-lens-project`
+     * header — the proxy maps it to the right project secret, so the dashboard
+     * never sees any secret. Return `null`/`undefined`/`''` (or omit the option
+     * entirely) for single-project hosts, in which case no header is sent.
+     */
+    project?: () => string | null | undefined;
+}
+declare class LensApiError extends Error {
+    readonly status: number;
+    readonly code: string;
+    constructor(status: number, code: string, message: string);
+}
+declare function createLensApi(config: LensApiConfig): LensApi;
+
+interface LensDashboardProviderProps {
+    api: LensApi;
+    /**
+     * Optional explicit theme. When set, the provider wraps its subtree in a
+     * `display: contents` scope that stamps `lens-db--dark` / `lens-db--light`,
+     * pinning the components to that theme regardless of the host's `.dark` class
+     * or `data-theme`. When omitted, components render LIGHT by default and follow
+     * a host opt-in (`.dark`/`[data-theme]`) if present. OS preference is ignored.
+     */
+    theme?: 'light' | 'dark';
+    children: React.ReactNode;
+}
+/**
+ * Supplies a {@link LensApi} instance to the Lens dashboard components via
+ * React context. Wrap any subtree that renders `ReportsTable`, `ReportDetail`,
+ * `ReplayPlayer`, or `IntegrationSettings`.
+ */
+declare function LensDashboardProvider(props: LensDashboardProviderProps): React.JSX.Element;
+/** Reads the {@link LensApi} from context, throwing a clear error if missing. */
+declare function useLensApi(): LensApi;
+
+interface ReportsTableProps {
+    onSelect?: (id: string) => void;
+    status?: ReportStatus;
+    pageSize?: number;
+    className?: string;
+}
+/**
+ * Paginated, searchable table of captured reports. A debounced search box
+ * filters over comment + URL (server-side); pagination walks the API cursor
+ * one page at a time via a client-side cursor stack (Prev/Next), where each
+ * Next pushes the current cursor and each Prev pops back to it.
+ */
+declare function ReportsTable(props: ReportsTableProps): React.JSX.Element;
+
+interface ReportDetailProps {
+    reportId: string;
+    onClose?: () => void;
+    className?: string;
+}
+/** Full detail view for a single report: context, errors, logs, replay and assets. */
+declare function ReportDetail(props: ReportDetailProps): React.JSX.Element;
+
+interface ReplayPlayerProps {
+    reportId: string;
+    className?: string;
+}
+/**
+ * First-party rrweb session-replay player.
+ *
+ * Built directly on rrweb's proven `Replayer` (the `rrweb-player` Svelte wrapper
+ * shipped a broken dist that never constructs a Replayer). The replayer's iframe
+ * is scaled with a CSS transform to fit a responsive, viewport-aspect container;
+ * a monochrome first-party controls bar drives play/pause, scrubbing, speed, and
+ * skip-inactive.
+ *
+ * rrweb is loaded via a dynamic `import()` inside an effect so it never runs
+ * during SSR. rrweb's base stylesheet is NOT imported here — the required rules
+ * are inlined into `styles.css` under "rrweb replayer base".
+ */
+declare function ReplayPlayer(props: ReplayPlayerProps): React.JSX.Element;
+
+interface IntegrationSettingsProps {
+    className?: string;
+}
+/**
+ * Lists all three issue-tracker integrations and manages their lifecycle against
+ * the single-destination contract: exactly one connected provider can be the
+ * active destination issues route to. Every mutation refetches the authoritative
+ * list so single-active semantics are enforced by the server, not the UI. The
+ * row/radio presentation lives in the shared {@link IntegrationList}.
+ */
+declare function IntegrationSettings(props: IntegrationSettingsProps): React.JSX.Element;
+
+interface OnboardingWizardProps {
+    /** Fired when the host clicks Finish on the final step. */
+    onComplete?: (result: {
+        project: Project;
+        accessId: string;
+        /** Only present when the wizard created the project this session — shown once, never re-fetchable. */
+        accessSecret: string | null;
+    }) => void;
+    /**
+     * Fired immediately after project creation (step 1), before the wizard
+     * continues. Lets proxy-based hosts start forwarding the new project's
+     * secret for the remaining wizard calls.
+     */
+    onProjectCreated?: (result: CreateProjectResponse) => void;
+    className?: string;
+    /**
+     * Skip project creation and load the existing project instead. The
+     * `accessSecret` cannot be shown again in this mode.
+     */
+    existingProject?: boolean;
+}
+/**
+ * Guided, multi-step setup card for provisioning a Lens project: create the
+ * project, pick the single issue destination, configure asset storage, then
+ * surface the install snippets. Designed for internal admin dashboards — the
+ * `accessSecret` lives only in memory and is displayed exactly once.
+ */
+declare function OnboardingWizard(props: OnboardingWizardProps): React.JSX.Element;
+
+interface ProjectSettingsProps {
+    className?: string;
+}
+/**
+ * Always-available editor for a project's name and allowed origins, plus a
+ * read-only, copyable access id. Unlike the wizard this stands alone, so hosts
+ * can expose an origins editor anywhere in their admin surface. Every save goes
+ * through `updateProject`; the access secret is never shown here (it exists
+ * only at creation time).
+ */
+declare function ProjectSettings(props: ProjectSettingsProps): React.JSX.Element;
+
+declare function StatusBadge({ status }: {
+    status: ReportStatus;
+}): React.JSX.Element;
+
+interface AsyncState<T> {
+    data: T | undefined;
+    error: Error | undefined;
+    loading: boolean;
+    /** Re-runs the async function. */
+    reload: () => void;
+}
+/**
+ * Tiny data-fetching primitive — no react-query dependency. Runs `fn` on mount
+ * and whenever `deps` change, tracks loading/error, and ignores results from
+ * stale invocations (so the last-requested call always wins).
+ */
+declare function useAsync<T>(fn: () => Promise<T>, deps: unknown[]): AsyncState<T>;
+
+export { type AssetKind, type AssetRef, type AsyncState, type ConnectIntegrationResponse, type CreateProjectRequest, type CreateProjectResponse, type Integration, type IntegrationProvider, IntegrationSettings, type IntegrationSettingsProps, type IntegrationStatus, type LensApi, type LensApiConfig, LensApiError, LensDashboardProvider, type LensDashboardProviderProps, type ListIntegrationsResponse, type ListReportsQuery, type ListReportsResult, OnboardingWizard, type OnboardingWizardProps, type Project, ProjectSettings, type ProjectSettingsProps, ReplayPlayer, type ReplayPlayerProps, type Report, ReportDetail, type ReportDetailProps, type ReportMetadata, type ReportStatus, type ReportSummary, ReportsTable, type ReportsTableProps, type S3ConfigInput, type S3ConfigPublic, StatusBadge, type UpdateProjectRequest, createLensApi, useAsync, useLensApi };