glitchgrab 1.37.0 → 1.39.0

package/README.md

@@ -641,6 +641,110 @@ captureError(error: unknown, options?: {
 - Pass `digest` whenever you have it. In production Next replaces server-boundary error messages with one generic string — without the digest, every distinct server crash on a page collapses into a single deduped issue.
 - No-ops if no `GlitchgrabProvider` has rendered yet.
 
+## How do I catch errors on the server (cron jobs, API routes, workers)?
+
+Everything above is browser-side — it hooks `window.onerror` and needs a
+rendered provider. A cron job at 3am has neither, so a nightly digest that
+throws, an SMTP timeout, or a payment webhook a provider rejects is invisible
+to it. `glitchgrab/server` is the same pipeline for code with no tab open.
+
+```bash
+GLITCHGRAB_TOKEN=gg_your_token
+```
+
+```ts
+// app/api/cron/daily-digest/route.ts
+import { reportServerError } from "glitchgrab/server";
+
+export async function GET() {
+  try {
+    await sendDigest();
+    return Response.json({ ok: true });
+  } catch (error) {
+    await reportServerError(error, { context: "cron/daily-digest" });
+    throw error;
+  }
+}
+```
+
+That is a GitHub issue with the message, the stack, the Node version and the
+region — no browser, no screenshot, no provider.
+
+**Await it.** On a serverless platform your function can be frozen the instant
+the handler returns; a floating promise dies with it and the report never
+leaves the machine.
+
+### Reporting a failure that isn't a thrown error
+
+The useful failures are often values, not exceptions — a provider that answers
+`{ ok: false }`, a send the API rejects. Report those the same way:
+
+```ts
+const result = await sendWhatsApp(payload);
+if (!result.success) {
+  await reportServerError(result.error, {
+    context: "whatsapp/task-reminder",
+    description: `Template ${payload.template} rejected for ${payload.to}`,
+    severity: "high",
+  });
+}
+```
+
+### Set the token once
+
+```ts
+// instrumentation.ts
+import { configureServerReporter, captureServerErrors } from "glitchgrab/server";
+
+export function register() {
+  configureServerReporter({
+    token: process.env.GLITCHGRAB_TOKEN,
+    metadata: { service: "web" },
+  });
+
+  // Optional: report every uncaught exception and unhandled rejection.
+  captureServerErrors();
+}
+```
+
+`captureServerErrors()` listens on `uncaughtExceptionMonitor`, which observes
+without taking over — your process still crashes exactly as it would have. A
+reporter that keeps a broken process alive is worse than no reporter.
+
+### `context` is the grouping key
+
+It is sent as the report's `pageUrl` (as `server://<context>`), and `pageUrl`
+feeds the dedup signature. Two different jobs throwing the same `"Timeout"`
+therefore stay two issues instead of collapsing into one. Give every call site
+its own context.
+
+### Options
+
+```ts
+reportServerError(error: unknown, options?: {
+  token?: string;               // default: process.env.GLITCHGRAB_TOKEN
+  baseUrl?: string;             // default: process.env.GLITCHGRAB_BASE_URL
+  context?: string;             // "cron/daily-digest" — the grouping key
+  description?: string;         // what the job was doing
+  type?: ReportType;            // default "BUG"
+  severity?: ReportSeverity;    // becomes a severity:<value> label
+  pageUrl?: string;             // a real request URL, when there is one
+  metadata?: Record<string, string>;
+  reporter?: { id?: string; name?: string; email?: string; phone?: string };
+  enableInDevelopment?: boolean;
+})
+```
+
+- **Deduped server-side**: one issue per signature per 24h, and nothing new for
+  7 days while an issue for it is open. A job failing hourly files one issue,
+  not twenty-four.
+- **Silent in development** unless `enableInDevelopment: true`. The browser SDK
+  is stopped by the API's localhost check; a server sends no `Origin` header, so
+  this flag is the only thing standing between a refactor and real issues.
+- **Never throws.** Returns `null` when nothing was filed — no token,
+  development, or the API refused it.
+- No React, no DOM, no `"use client"`. Safe in any Node runtime.
+
 ## What configuration options are available?
 
 | Prop | Type | Default | Description |

package/dist/index.d.mts

@@ -1,273 +1,9 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
+import { f as GlitchgrabProviderProps, U as UseGlitchgrabReturn, R as ReportButtonProps, F as FeedbackButtonProps, g as GlitchgrabSession, C as CaptureErrorOptions, e as GlitchgrabFeedback, a as BreadcrumbType, B as Breadcrumb, b as CapturedContext, D as DeviceInfo, c as FeedbackPayload, d as FeedbackResult, h as ReportPayload, i as ReportResult } from './types-DxH3oAL9.mjs';
+export { G as GlitchgrabConfig, j as ReportSeverity, k as ReportType, l as RuntimeInfo } from './types-DxH3oAL9.mjs';
 import * as React from 'react';
 import { ReactNode } from 'react';
 
-interface GlitchgrabConfig {
-    token: string;
-    baseUrl?: string;
-    onError?: (error: Error) => void;
-    /** Called after a report is sent — use to sync with your own ticket system */
-    onReportSent?: (result: ReportResult) => void;
-    /** Enable breadcrumb tracking (default: true) */
-    breadcrumbs?: boolean;
-    /** Max breadcrumbs to keep (default: 50) */
-    maxBreadcrumbs?: number;
-    /**
-     * Skip auto-capture for errors matching any of these patterns (checked against the
-     * error message). String = substring match, RegExp = `.test()`. Use for known-noisy
-     * signatures that aren't app bugs — e.g. browser extension bridge errors.
-     */
-    ignoreErrors?: (string | RegExp)[];
-}
-type ReportType = "BUG" | "FEATURE_REQUEST" | "UI_IMPROVEMENT" | "PERFORMANCE" | "SECURITY" | "QUESTION" | "OTHER";
-type ReportSeverity = "low" | "medium" | "high";
-interface ReportPayload {
-    token: string;
-    source: "SDK_AUTO" | "SDK_USER_REPORT";
-    type?: ReportType;
-    description?: string;
-    errorMessage?: string;
-    errorStack?: string;
-    componentStack?: string;
-    pageUrl?: string;
-    userAgent?: string;
-    breadcrumbs?: Breadcrumb[];
-    deviceInfo?: DeviceInfo;
-    metadata?: Record<string, string>;
-}
-/** Extra context for an error your app already caught — see `captureError` */
-interface CaptureErrorOptions {
-    /** React component stack, e.g. from `componentDidCatch` / `onCaughtError` */
-    componentStack?: string;
-    /**
-     * Next.js error digest. In production Next replaces server-boundary error
-     * messages with a generic string — the digest is the only thing that tells
-     * two different crashes apart, so it also feeds the dedup signature.
-     */
-    digest?: string;
-    /** Which boundary caught it, e.g. `"next-app-router"` — attached as metadata */
-    boundary?: string;
-    /** Extra metadata merged into the report */
-    metadata?: Record<string, string>;
-}
-interface ReportResult {
-    success: boolean;
-    reportId?: string;
-    issueUrl?: string;
-    issueNumber?: number;
-    title?: string;
-    intent?: string;
-    message?: string;
-}
-interface FeedbackPayload {
-    token: string;
-    /** 1–5 stars */
-    rating: number;
-    message?: string;
-    pageUrl?: string;
-    userAgent?: string;
-    metadata?: Record<string, string>;
-}
-interface FeedbackResult {
-    success: boolean;
-    feedbackId?: string;
-    rating?: number;
-    createdAt?: string;
-    message?: string;
-}
-/** One stored feedback entry, as returned by the read endpoint. */
-interface GlitchgrabFeedback {
-    id: string;
-    rating: number;
-    message: string | null;
-    pageUrl: string | null;
-    /** Whether the repo owner published this entry for public display */
-    approved: boolean;
-    reporterPrimaryKey: string;
-    reporterName: string;
-    createdAt: string;
-}
-type BreadcrumbType = "console" | "navigation" | "api" | "click" | "error" | "custom";
-interface Breadcrumb {
-    type: BreadcrumbType;
-    message: string;
-    timestamp: string;
-    data?: Record<string, string>;
-}
-interface DeviceInfo {
-    screenWidth: number;
-    screenHeight: number;
-    viewportWidth: number;
-    viewportHeight: number;
-    platform: string;
-    language: string;
-    online: boolean;
-    colorScheme: string;
-    devicePixelRatio: number;
-}
-/**
- * Machine state at the moment of the crash, as opposed to `DeviceInfo`, which
- * describes the machine itself. Most fields are Chromium-only and simply absent
- * elsewhere — never assume one is present.
- */
-interface RuntimeInfo {
-    /** ms since this page loaded */
-    timeOnPageMs: number;
-    /** How many errors the SDK has already auto-captured in this page session */
-    errorCount: number;
-    /** `document.visibilityState` — a crash in a background tab reads differently */
-    visibility: string;
-    jsHeapUsedMb?: number;
-    jsHeapLimitMb?: number;
-    /** `navigator.connection.effectiveType` — "4g", "3g", "2g", "slow-2g" */
-    connectionType?: string;
-    downlinkMbps?: number;
-    rttMs?: number;
-    saveData?: boolean;
-}
-interface CapturedContext {
-    url: string;
-    userAgent: string;
-    timestamp: string;
-    visitedPages: string[];
-    breadcrumbs: Breadcrumb[];
-    deviceInfo: DeviceInfo | null;
-    /** Runtime health snapshot — null when unavailable (SSR) */
-    runtime: RuntimeInfo | null;
-    /** Key-values the host app attached via `setContext` */
-    appContext: Record<string, string>;
-    /** Build identifier this crash came from, if known */
-    release?: string;
-}
-interface GlitchgrabSession {
-    /** Primary key of the user in your database (required) */
-    userId: string;
-    /** Display name (required) */
-    name: string;
-    /** Email address */
-    email?: string | null;
-    /** Phone number */
-    phone?: string | null;
-    /** Any extra fields you want attached to reports */
-    [key: string]: unknown;
-}
-interface GlitchgrabProviderProps {
-    token: string;
-    /** Logged-in user session — include userId (your DB primary key) so reports are traceable */
-    session?: GlitchgrabSession | null;
-    baseUrl?: string;
-    onError?: (error: Error) => void;
-    onReportSent?: (result: ReportResult) => void;
-    breadcrumbs?: boolean;
-    maxBreadcrumbs?: number;
-    children: ReactNode;
-    fallback?: ReactNode;
-    /** Which report types to show in the dialog (default: all) */
-    types?: ReportType[];
-    /** Show severity picker for BUG type (default: true) */
-    showSeverity?: boolean;
-    /**
-     * Skip auto-capture for errors matching any of these patterns (checked against the
-     * error message). String = substring match, RegExp = `.test()`. Use for known-noisy
-     * signatures that aren't app bugs — e.g. browser extension bridge errors.
-     */
-    ignoreErrors?: (string | RegExp)[];
-    /**
-     * Build identifier attached to every report — a version, a tag, a commit SHA.
-     * Tells you which deploy introduced a crash. Falls back to
-     * `NEXT_PUBLIC_APP_VERSION`, `NEXT_PUBLIC_RELEASE`, then
-     * `NEXT_PUBLIC_VERCEL_GIT_COMMIT_SHA` when not passed.
-     */
-    release?: string;
-    /**
-     * App-owned context attached to every report — orgId, plan, role, feature
-     * flags. Merged with anything set imperatively via `setContext`.
-     */
-    context?: Record<string, unknown>;
-    /**
-     * Extra origins whose failed-request bodies may be recorded in breadcrumbs,
-     * e.g. `["https://api.myapp.com"]`. Same-origin requests are always recorded;
-     * third-party APIs are excluded by default because their error envelopes carry
-     * data you don't control and shouldn't forward into a GitHub issue.
-     */
-    responseBodyOrigins?: string[];
-}
-interface ReportButtonProps {
-    position?: "bottom-right" | "bottom-left" | "top-right" | "top-left";
-    label?: string;
-    className?: string;
-}
-interface FeedbackButtonProps {
-    position?: "bottom-right" | "bottom-left" | "top-right" | "top-left";
-    label?: string;
-    className?: string;
-    /** Heading inside the dialog (default: "How are we doing?") */
-    title?: string;
-    /** Placeholder for the message box */
-    placeholder?: string;
-    /** Shown after a successful submit */
-    thanksMessage?: string;
-}
-interface UseGlitchgrabReturn {
-    /** Report a bug programmatically */
-    reportBug: (description: string, metadata?: Record<string, string>) => Promise<ReportResult | null>;
-    /** Report with a specific type */
-    report: (type: ReportType, description: string, metadata?: Record<string, string>) => Promise<ReportResult | null>;
-    /**
-     * Report an error your app already caught — a framework error boundary
-     * (`app/error.tsx`, React Router `errorElement`, Remix `ErrorBoundary`) or a
-     * `try/catch`. These never reach `window.onerror`, so auto-capture misses them.
-     * Sends `SDK_AUTO`. Fire-and-forget, never throws.
-     */
-    captureError: (error: unknown, options?: CaptureErrorOptions) => void;
-    /**
-     * Attach a key-value to every future report — orgId, plan, role, feature flag.
-     * Pass `null` to remove a key. Survives navigation and provider remounts.
-     */
-    setContext: (key: string, value: unknown) => void;
-    /** Set several context keys at once. Merges; does not replace. */
-    setContexts: (values: Record<string, unknown>) => void;
-    /**
-     * Save a 1–5 star rating your end-user left about your app. Stored by
-     * Glitchgrab and shown on your Feedback page — never becomes a GitHub issue.
-     * Returns null on any failure (never throws).
-     */
-    sendFeedback: (rating: number, message?: string, metadata?: Record<string, string>) => Promise<FeedbackResult | null>;
-    /** Open the built-in feedback dialog (stars + message) programmatically */
-    openFeedbackDialog: () => void;
-    /** Add a custom breadcrumb */
-    addBreadcrumb: (message: string, data?: Record<string, string>) => void;
-    /** Open the ReportButton modal programmatically (captures screenshot + shows dialog) */
-    openReportDialog: (options?: {
-        description?: string;
-        type?: ReportType;
-    }) => void;
-    /**
-     * Open the demo booking dialog.
-     *
-     * Slots come from the project owner's real Google calendar, and the booking
-     * creates a Meet on it — so this is only useful for projects whose owner has
-     * connected a calendar and enabled booking in Glitchgrab.
-     */
-    openBookingDialog: () => void;
-    /**
-     * Optional: polish user-written description text via the Glitchgrab AI enhance endpoint.
-     * Fixes grammar / clarity only — never invents details or changes meaning.
-     * Returns the polished text, or the original text on any failure (never throws).
-     */
-    enhanceText: (text: string, screenshot?: string | null) => Promise<string>;
-    /**
-     * OS-aware label for the shortcut that opens the report dialog —
-     * `⌘⇧G` on Mac, `Ctrl+Shift+G` elsewhere. Render this instead of
-     * hardcoding the shortcut, so the hint stays in sync with the handler.
-     */
-    shortcutLabel: string;
-    /** The token being used */
-    token: string;
-    /** The base URL of the Glitchgrab API */
-    baseUrl: string;
-}
-
 /**
  * Hook to access Glitchgrab in your components.
  *
@@ -649,4 +385,4 @@ declare function computeSignature(params: {
 declare function shouldSkipDuplicate(signature: string, windowMs?: number, now?: number): boolean;
 declare function clearDedupCache(): void;
 
-export { BookDemoButton, type Breadcrumb, type BreadcrumbType, type CaptureErrorOptions, type CapturedContext, type DeviceInfo, FeedbackButton, type FeedbackButtonProps, type FeedbackPayload, type FeedbackQuery, type FeedbackResult, GLITCHGRAB_SHORTCUT, GLITCHGRAB_SHORTCUT_MAC, type GlitchgrabConfig, GlitchgrabErrorBoundary, type GlitchgrabFeedback, GlitchgrabProvider, type GlitchgrabProviderProps, type GlitchgrabReport, type GlitchgrabSession, ReportButton, type ReportButtonProps, type ReportPayload, type ReportResult, type ReportSeverity, type ReportType, type RuntimeInfo, type UseGlitchgrabReturn, addBreadcrumb, captureContext, captureDeviceInfo, captureError, clearAppContext, clearBreadcrumbs, clearDedupCache, computeSignature, enhanceText, fetchGlitchgrabFeedback, fetchGlitchgrabReports, getAppContext, getBreadcrumbs, getShortcutLabel, initBreadcrumbs, matchesShortcut, sanitizeUrl, sendFeedback, sendReport, setContext, setContexts, shouldSkipDuplicate, useGlitchgrab, useGlitchgrabActions, useGlitchgrabFeedback, useGlitchgrabReports };
+export { BookDemoButton, Breadcrumb, BreadcrumbType, CaptureErrorOptions, CapturedContext, DeviceInfo, FeedbackButton, FeedbackButtonProps, FeedbackPayload, type FeedbackQuery, FeedbackResult, GLITCHGRAB_SHORTCUT, GLITCHGRAB_SHORTCUT_MAC, GlitchgrabErrorBoundary, GlitchgrabFeedback, GlitchgrabProvider, GlitchgrabProviderProps, type GlitchgrabReport, GlitchgrabSession, ReportButton, ReportButtonProps, ReportPayload, ReportResult, UseGlitchgrabReturn, addBreadcrumb, captureContext, captureDeviceInfo, captureError, clearAppContext, clearBreadcrumbs, clearDedupCache, computeSignature, enhanceText, fetchGlitchgrabFeedback, fetchGlitchgrabReports, getAppContext, getBreadcrumbs, getShortcutLabel, initBreadcrumbs, matchesShortcut, sanitizeUrl, sendFeedback, sendReport, setContext, setContexts, shouldSkipDuplicate, useGlitchgrab, useGlitchgrabActions, useGlitchgrabFeedback, useGlitchgrabReports };

package/dist/index.d.ts

@@ -1,273 +1,9 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
+import { f as GlitchgrabProviderProps, U as UseGlitchgrabReturn, R as ReportButtonProps, F as FeedbackButtonProps, g as GlitchgrabSession, C as CaptureErrorOptions, e as GlitchgrabFeedback, a as BreadcrumbType, B as Breadcrumb, b as CapturedContext, D as DeviceInfo, c as FeedbackPayload, d as FeedbackResult, h as ReportPayload, i as ReportResult } from './types-DxH3oAL9.js';
+export { G as GlitchgrabConfig, j as ReportSeverity, k as ReportType, l as RuntimeInfo } from './types-DxH3oAL9.js';
 import * as React from 'react';
 import { ReactNode } from 'react';
 
-interface GlitchgrabConfig {
-    token: string;
-    baseUrl?: string;
-    onError?: (error: Error) => void;
-    /** Called after a report is sent — use to sync with your own ticket system */
-    onReportSent?: (result: ReportResult) => void;
-    /** Enable breadcrumb tracking (default: true) */
-    breadcrumbs?: boolean;
-    /** Max breadcrumbs to keep (default: 50) */
-    maxBreadcrumbs?: number;
-    /**
-     * Skip auto-capture for errors matching any of these patterns (checked against the
-     * error message). String = substring match, RegExp = `.test()`. Use for known-noisy
-     * signatures that aren't app bugs — e.g. browser extension bridge errors.
-     */
-    ignoreErrors?: (string | RegExp)[];
-}
-type ReportType = "BUG" | "FEATURE_REQUEST" | "UI_IMPROVEMENT" | "PERFORMANCE" | "SECURITY" | "QUESTION" | "OTHER";
-type ReportSeverity = "low" | "medium" | "high";
-interface ReportPayload {
-    token: string;
-    source: "SDK_AUTO" | "SDK_USER_REPORT";
-    type?: ReportType;
-    description?: string;
-    errorMessage?: string;
-    errorStack?: string;
-    componentStack?: string;
-    pageUrl?: string;
-    userAgent?: string;
-    breadcrumbs?: Breadcrumb[];
-    deviceInfo?: DeviceInfo;
-    metadata?: Record<string, string>;
-}
-/** Extra context for an error your app already caught — see `captureError` */
-interface CaptureErrorOptions {
-    /** React component stack, e.g. from `componentDidCatch` / `onCaughtError` */
-    componentStack?: string;
-    /**
-     * Next.js error digest. In production Next replaces server-boundary error
-     * messages with a generic string — the digest is the only thing that tells
-     * two different crashes apart, so it also feeds the dedup signature.
-     */
-    digest?: string;
-    /** Which boundary caught it, e.g. `"next-app-router"` — attached as metadata */
-    boundary?: string;
-    /** Extra metadata merged into the report */
-    metadata?: Record<string, string>;
-}
-interface ReportResult {
-    success: boolean;
-    reportId?: string;
-    issueUrl?: string;
-    issueNumber?: number;
-    title?: string;
-    intent?: string;
-    message?: string;
-}
-interface FeedbackPayload {
-    token: string;
-    /** 1–5 stars */
-    rating: number;
-    message?: string;
-    pageUrl?: string;
-    userAgent?: string;
-    metadata?: Record<string, string>;
-}
-interface FeedbackResult {
-    success: boolean;
-    feedbackId?: string;
-    rating?: number;
-    createdAt?: string;
-    message?: string;
-}
-/** One stored feedback entry, as returned by the read endpoint. */
-interface GlitchgrabFeedback {
-    id: string;
-    rating: number;
-    message: string | null;
-    pageUrl: string | null;
-    /** Whether the repo owner published this entry for public display */
-    approved: boolean;
-    reporterPrimaryKey: string;
-    reporterName: string;
-    createdAt: string;
-}
-type BreadcrumbType = "console" | "navigation" | "api" | "click" | "error" | "custom";
-interface Breadcrumb {
-    type: BreadcrumbType;
-    message: string;
-    timestamp: string;
-    data?: Record<string, string>;
-}
-interface DeviceInfo {
-    screenWidth: number;
-    screenHeight: number;
-    viewportWidth: number;
-    viewportHeight: number;
-    platform: string;
-    language: string;
-    online: boolean;
-    colorScheme: string;
-    devicePixelRatio: number;
-}
-/**
- * Machine state at the moment of the crash, as opposed to `DeviceInfo`, which
- * describes the machine itself. Most fields are Chromium-only and simply absent
- * elsewhere — never assume one is present.
- */
-interface RuntimeInfo {
-    /** ms since this page loaded */
-    timeOnPageMs: number;
-    /** How many errors the SDK has already auto-captured in this page session */
-    errorCount: number;
-    /** `document.visibilityState` — a crash in a background tab reads differently */
-    visibility: string;
-    jsHeapUsedMb?: number;
-    jsHeapLimitMb?: number;
-    /** `navigator.connection.effectiveType` — "4g", "3g", "2g", "slow-2g" */
-    connectionType?: string;
-    downlinkMbps?: number;
-    rttMs?: number;
-    saveData?: boolean;
-}
-interface CapturedContext {
-    url: string;
-    userAgent: string;
-    timestamp: string;
-    visitedPages: string[];
-    breadcrumbs: Breadcrumb[];
-    deviceInfo: DeviceInfo | null;
-    /** Runtime health snapshot — null when unavailable (SSR) */
-    runtime: RuntimeInfo | null;
-    /** Key-values the host app attached via `setContext` */
-    appContext: Record<string, string>;
-    /** Build identifier this crash came from, if known */
-    release?: string;
-}
-interface GlitchgrabSession {
-    /** Primary key of the user in your database (required) */
-    userId: string;
-    /** Display name (required) */
-    name: string;
-    /** Email address */
-    email?: string | null;
-    /** Phone number */
-    phone?: string | null;
-    /** Any extra fields you want attached to reports */
-    [key: string]: unknown;
-}
-interface GlitchgrabProviderProps {
-    token: string;
-    /** Logged-in user session — include userId (your DB primary key) so reports are traceable */
-    session?: GlitchgrabSession | null;
-    baseUrl?: string;
-    onError?: (error: Error) => void;
-    onReportSent?: (result: ReportResult) => void;
-    breadcrumbs?: boolean;
-    maxBreadcrumbs?: number;
-    children: ReactNode;
-    fallback?: ReactNode;
-    /** Which report types to show in the dialog (default: all) */
-    types?: ReportType[];
-    /** Show severity picker for BUG type (default: true) */
-    showSeverity?: boolean;
-    /**
-     * Skip auto-capture for errors matching any of these patterns (checked against the
-     * error message). String = substring match, RegExp = `.test()`. Use for known-noisy
-     * signatures that aren't app bugs — e.g. browser extension bridge errors.
-     */
-    ignoreErrors?: (string | RegExp)[];
-    /**
-     * Build identifier attached to every report — a version, a tag, a commit SHA.
-     * Tells you which deploy introduced a crash. Falls back to
-     * `NEXT_PUBLIC_APP_VERSION`, `NEXT_PUBLIC_RELEASE`, then
-     * `NEXT_PUBLIC_VERCEL_GIT_COMMIT_SHA` when not passed.
-     */
-    release?: string;
-    /**
-     * App-owned context attached to every report — orgId, plan, role, feature
-     * flags. Merged with anything set imperatively via `setContext`.
-     */
-    context?: Record<string, unknown>;
-    /**
-     * Extra origins whose failed-request bodies may be recorded in breadcrumbs,
-     * e.g. `["https://api.myapp.com"]`. Same-origin requests are always recorded;
-     * third-party APIs are excluded by default because their error envelopes carry
-     * data you don't control and shouldn't forward into a GitHub issue.
-     */
-    responseBodyOrigins?: string[];
-}
-interface ReportButtonProps {
-    position?: "bottom-right" | "bottom-left" | "top-right" | "top-left";
-    label?: string;
-    className?: string;
-}
-interface FeedbackButtonProps {
-    position?: "bottom-right" | "bottom-left" | "top-right" | "top-left";
-    label?: string;
-    className?: string;
-    /** Heading inside the dialog (default: "How are we doing?") */
-    title?: string;
-    /** Placeholder for the message box */
-    placeholder?: string;
-    /** Shown after a successful submit */
-    thanksMessage?: string;
-}
-interface UseGlitchgrabReturn {
-    /** Report a bug programmatically */
-    reportBug: (description: string, metadata?: Record<string, string>) => Promise<ReportResult | null>;
-    /** Report with a specific type */
-    report: (type: ReportType, description: string, metadata?: Record<string, string>) => Promise<ReportResult | null>;
-    /**
-     * Report an error your app already caught — a framework error boundary
-     * (`app/error.tsx`, React Router `errorElement`, Remix `ErrorBoundary`) or a
-     * `try/catch`. These never reach `window.onerror`, so auto-capture misses them.
-     * Sends `SDK_AUTO`. Fire-and-forget, never throws.
-     */
-    captureError: (error: unknown, options?: CaptureErrorOptions) => void;
-    /**
-     * Attach a key-value to every future report — orgId, plan, role, feature flag.
-     * Pass `null` to remove a key. Survives navigation and provider remounts.
-     */
-    setContext: (key: string, value: unknown) => void;
-    /** Set several context keys at once. Merges; does not replace. */
-    setContexts: (values: Record<string, unknown>) => void;
-    /**
-     * Save a 1–5 star rating your end-user left about your app. Stored by
-     * Glitchgrab and shown on your Feedback page — never becomes a GitHub issue.
-     * Returns null on any failure (never throws).
-     */
-    sendFeedback: (rating: number, message?: string, metadata?: Record<string, string>) => Promise<FeedbackResult | null>;
-    /** Open the built-in feedback dialog (stars + message) programmatically */
-    openFeedbackDialog: () => void;
-    /** Add a custom breadcrumb */
-    addBreadcrumb: (message: string, data?: Record<string, string>) => void;
-    /** Open the ReportButton modal programmatically (captures screenshot + shows dialog) */
-    openReportDialog: (options?: {
-        description?: string;
-        type?: ReportType;
-    }) => void;
-    /**
-     * Open the demo booking dialog.
-     *
-     * Slots come from the project owner's real Google calendar, and the booking
-     * creates a Meet on it — so this is only useful for projects whose owner has
-     * connected a calendar and enabled booking in Glitchgrab.
-     */
-    openBookingDialog: () => void;
-    /**
-     * Optional: polish user-written description text via the Glitchgrab AI enhance endpoint.
-     * Fixes grammar / clarity only — never invents details or changes meaning.
-     * Returns the polished text, or the original text on any failure (never throws).
-     */
-    enhanceText: (text: string, screenshot?: string | null) => Promise<string>;
-    /**
-     * OS-aware label for the shortcut that opens the report dialog —
-     * `⌘⇧G` on Mac, `Ctrl+Shift+G` elsewhere. Render this instead of
-     * hardcoding the shortcut, so the hint stays in sync with the handler.
-     */
-    shortcutLabel: string;
-    /** The token being used */
-    token: string;
-    /** The base URL of the Glitchgrab API */
-    baseUrl: string;
-}
-
 /**
  * Hook to access Glitchgrab in your components.
  *
@@ -649,4 +385,4 @@ declare function computeSignature(params: {
 declare function shouldSkipDuplicate(signature: string, windowMs?: number, now?: number): boolean;
 declare function clearDedupCache(): void;
 
-export { BookDemoButton, type Breadcrumb, type BreadcrumbType, type CaptureErrorOptions, type CapturedContext, type DeviceInfo, FeedbackButton, type FeedbackButtonProps, type FeedbackPayload, type FeedbackQuery, type FeedbackResult, GLITCHGRAB_SHORTCUT, GLITCHGRAB_SHORTCUT_MAC, type GlitchgrabConfig, GlitchgrabErrorBoundary, type GlitchgrabFeedback, GlitchgrabProvider, type GlitchgrabProviderProps, type GlitchgrabReport, type GlitchgrabSession, ReportButton, type ReportButtonProps, type ReportPayload, type ReportResult, type ReportSeverity, type ReportType, type RuntimeInfo, type UseGlitchgrabReturn, addBreadcrumb, captureContext, captureDeviceInfo, captureError, clearAppContext, clearBreadcrumbs, clearDedupCache, computeSignature, enhanceText, fetchGlitchgrabFeedback, fetchGlitchgrabReports, getAppContext, getBreadcrumbs, getShortcutLabel, initBreadcrumbs, matchesShortcut, sanitizeUrl, sendFeedback, sendReport, setContext, setContexts, shouldSkipDuplicate, useGlitchgrab, useGlitchgrabActions, useGlitchgrabFeedback, useGlitchgrabReports };
+export { BookDemoButton, Breadcrumb, BreadcrumbType, CaptureErrorOptions, CapturedContext, DeviceInfo, FeedbackButton, FeedbackButtonProps, FeedbackPayload, type FeedbackQuery, FeedbackResult, GLITCHGRAB_SHORTCUT, GLITCHGRAB_SHORTCUT_MAC, GlitchgrabErrorBoundary, GlitchgrabFeedback, GlitchgrabProvider, GlitchgrabProviderProps, type GlitchgrabReport, GlitchgrabSession, ReportButton, ReportButtonProps, ReportPayload, ReportResult, UseGlitchgrabReturn, addBreadcrumb, captureContext, captureDeviceInfo, captureError, clearAppContext, clearBreadcrumbs, clearDedupCache, computeSignature, enhanceText, fetchGlitchgrabFeedback, fetchGlitchgrabReports, getAppContext, getBreadcrumbs, getShortcutLabel, initBreadcrumbs, matchesShortcut, sanitizeUrl, sendFeedback, sendReport, setContext, setContexts, shouldSkipDuplicate, useGlitchgrab, useGlitchgrabActions, useGlitchgrabFeedback, useGlitchgrabReports };