glitchgrab 1.56.0 → 1.57.0

package/README.md

@@ -288,6 +288,35 @@ curl "https://glitchgrab.dev/api/v1/sdk/feedback?approved=true&minRating=4&limit
 
 The repo is always derived from the token — there is no `repoId` to pass. Rate limit: 30 submissions per token per hour.
 
+## How do I save a lead without filing an issue?
+
+A demo form or contact page asks a prospect for their details. Those are a **lead**, not a bug — `submitLead()` stores them in Glitchgrab and never creates a GitHub issue:
+
+```tsx
+const { submitLead } = useGlitchgrab();
+
+const result = await submitLead({
+  name: "Asha Mehta",
+  phone: "+91 98765 43210",
+  source: "demo",               // which form — filter on it later
+  email: "asha@firm.in",        // optional
+  company: "Mehta & Co",        // optional
+  address: "Pune",              // optional
+  metadata: { practice: "CA", language: "Hindi" }, // optional, flat values
+});
+// { success: true, id: "…", created: true } — or null on failure. Never throws.
+```
+
+One lead per phone number per project: the same visitor submitting twice updates their lead (`created: false`) instead of adding a second row. Leads show under **Calls → Leads** in Glitchgrab, next to any demo the same phone or email went on to book. The owner can switch on a WhatsApp alert for each new lead there.
+
+Read them in your own admin with the project's `ggc_` server key — the same key as `listBookings()`:
+
+```ts
+import { listLeads } from "glitchgrab/server";
+
+const leads = await listLeads({ source: "demo", since: "2026-09-01" }); // GLITCHGRAB_CALLS_KEY=ggc_…
+```
+
 ## What keyboard shortcuts are available?
 
 Once `GlitchgrabProvider` is mounted, these shortcuts work globally:

package/dist/index.d.mts

@@ -1,6 +1,6 @@
 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-DcDF1mXc.mjs';
-export { G as GlitchgrabConfig, j as ReportSeverity, k as ReportType, l as RuntimeInfo } from './types-DcDF1mXc.mjs';
+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, L as LeadInput, h as LeadResult, i as ReportPayload, j as ReportResult } from './types-DfVtKZcp.mjs';
+export { G as GlitchgrabConfig, k as ReportSeverity, l as ReportType, m as RuntimeInfo } from './types-DfVtKZcp.mjs';
 import * as React from 'react';
 import { ReactNode } from 'react';
 
@@ -356,6 +356,13 @@ declare function sendReport(payload: ReportPayload, baseUrl?: string): Promise<R
  * sendBeacon fallback: the caller needs a real result to show a thank-you.
  */
 declare function sendFeedback(payload: FeedbackPayload, baseUrl?: string): Promise<FeedbackResult | null>;
+/**
+ * POST a lead (#534). Retries transient failures like {@link sendFeedback}; a
+ * 4xx other than 429 is a caller mistake and returns null at once.
+ */
+declare function sendLead(token: string, lead: LeadInput & {
+    pageUrl?: string;
+}, baseUrl?: string): Promise<LeadResult | null>;
 interface EnhanceContext {
     url?: string;
     visitedPages?: string[];
@@ -397,4 +404,4 @@ declare function computeSignature(params: {
 declare function shouldSkipDuplicate(signature: string, windowMs?: number, now?: number): boolean;
 declare function clearDedupCache(): void;
 
-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 };
+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, LeadInput, LeadResult, ReportButton, ReportButtonProps, ReportPayload, ReportResult, UseGlitchgrabReturn, addBreadcrumb, captureContext, captureDeviceInfo, captureError, clearAppContext, clearBreadcrumbs, clearDedupCache, computeSignature, enhanceText, fetchGlitchgrabFeedback, fetchGlitchgrabReports, getAppContext, getBreadcrumbs, getShortcutLabel, initBreadcrumbs, matchesShortcut, sanitizeUrl, sendFeedback, sendLead, sendReport, setContext, setContexts, shouldSkipDuplicate, useGlitchgrab, useGlitchgrabActions, useGlitchgrabFeedback, useGlitchgrabReports };

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 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-DcDF1mXc.js';
-export { G as GlitchgrabConfig, j as ReportSeverity, k as ReportType, l as RuntimeInfo } from './types-DcDF1mXc.js';
+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, L as LeadInput, h as LeadResult, i as ReportPayload, j as ReportResult } from './types-DfVtKZcp.js';
+export { G as GlitchgrabConfig, k as ReportSeverity, l as ReportType, m as RuntimeInfo } from './types-DfVtKZcp.js';
 import * as React from 'react';
 import { ReactNode } from 'react';
 
@@ -356,6 +356,13 @@ declare function sendReport(payload: ReportPayload, baseUrl?: string): Promise<R
  * sendBeacon fallback: the caller needs a real result to show a thank-you.
  */
 declare function sendFeedback(payload: FeedbackPayload, baseUrl?: string): Promise<FeedbackResult | null>;
+/**
+ * POST a lead (#534). Retries transient failures like {@link sendFeedback}; a
+ * 4xx other than 429 is a caller mistake and returns null at once.
+ */
+declare function sendLead(token: string, lead: LeadInput & {
+    pageUrl?: string;
+}, baseUrl?: string): Promise<LeadResult | null>;
 interface EnhanceContext {
     url?: string;
     visitedPages?: string[];
@@ -397,4 +404,4 @@ declare function computeSignature(params: {
 declare function shouldSkipDuplicate(signature: string, windowMs?: number, now?: number): boolean;
 declare function clearDedupCache(): void;
 
-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 };
+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, LeadInput, LeadResult, ReportButton, ReportButtonProps, ReportPayload, ReportResult, UseGlitchgrabReturn, addBreadcrumb, captureContext, captureDeviceInfo, captureError, clearAppContext, clearBreadcrumbs, clearDedupCache, computeSignature, enhanceText, fetchGlitchgrabFeedback, fetchGlitchgrabReports, getAppContext, getBreadcrumbs, getShortcutLabel, initBreadcrumbs, matchesShortcut, sanitizeUrl, sendFeedback, sendLead, sendReport, setContext, setContexts, shouldSkipDuplicate, useGlitchgrab, useGlitchgrabActions, useGlitchgrabFeedback, useGlitchgrabReports };

package/dist/index.js

@@ -56,6 +56,7 @@ __export(index_exports, {
   matchesShortcut: () => matchesShortcut,
   sanitizeUrl: () => sanitizeUrl,
   sendFeedback: () => sendFeedback,
+  sendLead: () => sendLead,
   sendReport: () => sendReport,
   setContext: () => setContext,
   setContexts: () => setContexts,
@@ -724,6 +725,36 @@ async function sendFeedback(payload, baseUrl) {
     return null;
   }
 }
+async function sendLead(token, lead, baseUrl) {
+  var _a, _b;
+  try {
+    const url = `${baseUrl != null ? baseUrl : DEFAULT_BASE_URL}/api/v1/sdk/leads`;
+    const body = JSON.stringify(lead);
+    for (let attempt = 0; attempt < MAX_RETRIES; attempt++) {
+      try {
+        const response = await fetch(url, {
+          method: "POST",
+          headers: { "Content-Type": "application/json", Authorization: `Bearer ${token}` },
+          body
+        });
+        if (response.ok) {
+          const envelope = await response.json();
+          return { success: envelope.success, id: (_a = envelope.data) == null ? void 0 : _a.leadId, created: (_b = envelope.data) == null ? void 0 : _b.created };
+        }
+        if (response.status >= 400 && response.status < 500 && response.status !== 429) {
+          return null;
+        }
+      } catch (e) {
+      }
+      if (attempt < MAX_RETRIES - 1) {
+        await new Promise((resolve) => setTimeout(resolve, RETRY_BASE_MS * Math.pow(2, attempt)));
+      }
+    }
+    return null;
+  } catch (e) {
+    return null;
+  }
+}
 function signedFields(identity) {
   if (!(identity == null ? void 0 : identity.signature) || !identity.userId) return {};
   return { userId: identity.userId, signature: identity.signature };
@@ -9127,6 +9158,17 @@ function GlitchgrabProviderInner({
     },
     [token, baseUrl, session]
   );
+  const submitLead = (0, import_react6.useCallback)(
+    async (lead) => {
+      try {
+        const context = captureContext(visitedPagesRef.current);
+        return await sendLead(token, { ...lead, pageUrl: context.url }, baseUrl);
+      } catch (e) {
+        return null;
+      }
+    },
+    [token, baseUrl]
+  );
   const openFeedbackDialog = (0, import_react6.useCallback)(() => {
     if (typeof window !== "undefined") {
       window.dispatchEvent(
@@ -9304,6 +9346,7 @@ function GlitchgrabProviderInner({
         setContext: setContext2,
         setContexts: setContexts2,
         sendFeedback: feedback,
+        submitLead,
         openFeedbackDialog,
         addBreadcrumb: addBreadcrumb2,
         openReportDialog,
@@ -9769,6 +9812,7 @@ function useGlitchgrabFeedback(query) {
   matchesShortcut,
   sanitizeUrl,
   sendFeedback,
+  sendLead,
   sendReport,
   setContext,
   setContexts,