glitchgrab 1.56.0 → 1.58.0

package/dist/server.d.mts

@@ -1,4 +1,4 @@
-import { k as ReportType, j as ReportSeverity, i as ReportResult } from './types-DcDF1mXc.mjs';
+import { l as ReportType, k as ReportSeverity, j as ReportResult } from './types-DfVtKZcp.mjs';
 import 'react';
 
 /** Who to attribute the report to. A server has no signed-in user, so this is the job or service. */
@@ -375,6 +375,44 @@ interface BookingSettings {
      * change it; leave the field out and it keeps what is stored.
      */
     notifyRecipients: BookingNotifyRecipient[];
+    /**
+     * What a prospect is asked before they see the calendar — in the booking
+     * dialog and over WhatsApp — so the right person takes the demo. At most 5.
+     * Send the whole list to change it (`[]` asks nothing); leave the field out
+     * and it keeps what is stored. The answers come back on {@link Booking.answers}.
+     */
+    questions: BookingQuestion[];
+}
+/** One question asked before a demo is booked. The prospect taps one of `options`. */
+interface BookingQuestion {
+    /**
+     * Stable name for the question, e.g. `"language"` — lower case letters,
+     * digits, `-` and `_`. Leave it out on a new question and one is made from
+     * the label; keep it when rewording so earlier answers still line up.
+     */
+    id: string;
+    /** What is asked, up to 80 characters. */
+    label: string;
+    /** 2–9 choices, up to 40 characters each. */
+    options: string[];
+    /** False lets the prospect skip it. */
+    required: boolean;
+}
+/** A question as you send it: `id` and `required` may be left out on a new one. */
+type BookingQuestionInput = Omit<BookingQuestion, "id" | "required"> & {
+    id?: string;
+    required?: boolean;
+};
+/** What {@link updateBookingSettings} accepts — any subset of the settings. */
+type BookingSettingsChanges = Partial<Omit<BookingSettings, "questions">> & {
+    questions?: BookingQuestionInput[];
+};
+/** One answer a prospect gave, with the question as it was worded when they booked. */
+interface BookingAnswer {
+    /** The {@link BookingQuestion.id} it answers. */
+    id: string;
+    question: string;
+    answer: string;
 }
 /** One extra person alerted when a demo is booked. */
 interface BookingNotifyRecipient {
@@ -414,7 +452,7 @@ declare function getBookingSettings(options?: CallsOptions): Promise<BookingSett
  * `error` is worth showing: a WhatsApp code already taken by another project
  * comes back as one.
  */
-declare function updateBookingSettings(changes: Partial<BookingSettings>, options?: CallsOptions): Promise<BookingSettingsResult>;
+declare function updateBookingSettings(changes: BookingSettingsChanges, options?: CallsOptions): Promise<BookingSettingsResult>;
 /** One booked demo. Times are ISO strings in UTC; `timezone` is what the prospect picked in. */
 interface Booking {
     id: string;
@@ -429,6 +467,8 @@ interface Booking {
     timezone: string | null;
     /** What they typed when booking, if anything. */
     note: string | null;
+    /** What they answered to the project's {@link BookingSettings.questions}. Empty when nothing was asked. */
+    answers: BookingAnswer[];
     /** `CONFIRMED` or `CANCELLED`. Unverified holds are never returned. */
     status: string;
     /** The Google Meet room. Null until the booking is confirmed. */
@@ -506,5 +546,49 @@ declare function cancelBooking(id: string, reason?: string, options?: CallsOptio
  * Never throws: a value JSON cannot represent (circular, `undefined`) becomes `null`.
  */
 declare function escapeJsonForScript(value: unknown): string;
+/** One lead. One per phone number per project; a repeat submission updates it. */
+interface Lead {
+    id: string;
+    name: string;
+    /** Digits only, country code included. */
+    phone: string;
+    email: string | null;
+    company: string | null;
+    address: string | null;
+    /** What your form passed as `source`, e.g. `"demo"`. */
+    source: string;
+    metadata: Record<string, string | number | boolean> | null;
+    /** The page the lead was left on. */
+    pageUrl: string | null;
+    /** How many times this phone submitted. */
+    submissions: number;
+    /** First submission. */
+    createdAt: string;
+    /** Latest submission. */
+    updatedAt: string;
+    /** The demo this lead went on to book, matched by phone or email. */
+    booking: {
+        id: string;
+        startsAt: string;
+        status: string;
+    } | null;
+}
+interface ListLeadsOptions extends CallsOptions {
+    /** Only leads with this `source`. */
+    source?: string;
+    /** Only leads first left at or after this time. */
+    since?: Date | string;
+    /** Up to 200. Defaults to 100. */
+    limit?: number;
+}
+/**
+ * The project's leads, newest first. Never throws — an empty list on any
+ * failure.
+ *
+ * ```ts
+ * const leads = await listLeads({ source: "demo" }); // GLITCHGRAB_CALLS_KEY=ggc_…
+ * ```
+ */
+declare function listLeads(options?: ListLeadsOptions): Promise<Lead[]>;
 
-export { type Booking, type BookingClientNotice, type BookingMutationResult, type BookingNotifyRecipient, type BookingSettings, type BookingSettingsResult, type BookingSettingsState, type BookingWorkingHours, type Call, type CallAudio, type CallListItem, type CallMoment, type CallParticipant, type CallsOptions, type CaptureServerErrorsOptions, type DeleteCallResult, type GetCallOptions, type Guide, type GuideReadOptions, type GuideSummary, type ListBookingsOptions, type ListCallsOptions, ReportResult, ReportSeverity, ReportType, type ServerReportOptions, type ServerReporterConfig, type ServerReporterIdentity, type SignSessionOptions, cancelBooking, captureServerErrors, configureServerReporter, deleteCall, escapeJsonForScript, getBookingSettings, getCall, getGuide, listBookings, listCalls, listGuides, reportServerError, rescheduleBooking, resetServerReporter, signSession, updateBookingSettings };
+export { type Booking, type BookingAnswer, type BookingClientNotice, type BookingMutationResult, type BookingNotifyRecipient, type BookingQuestion, type BookingQuestionInput, type BookingSettings, type BookingSettingsChanges, type BookingSettingsResult, type BookingSettingsState, type BookingWorkingHours, type Call, type CallAudio, type CallListItem, type CallMoment, type CallParticipant, type CallsOptions, type CaptureServerErrorsOptions, type DeleteCallResult, type GetCallOptions, type Guide, type GuideReadOptions, type GuideSummary, type Lead, type ListBookingsOptions, type ListCallsOptions, type ListLeadsOptions, ReportResult, ReportSeverity, ReportType, type ServerReportOptions, type ServerReporterConfig, type ServerReporterIdentity, type SignSessionOptions, cancelBooking, captureServerErrors, configureServerReporter, deleteCall, escapeJsonForScript, getBookingSettings, getCall, getGuide, listBookings, listCalls, listGuides, listLeads, reportServerError, rescheduleBooking, resetServerReporter, signSession, updateBookingSettings };

package/dist/server.d.ts

@@ -1,4 +1,4 @@
-import { k as ReportType, j as ReportSeverity, i as ReportResult } from './types-DcDF1mXc.js';
+import { l as ReportType, k as ReportSeverity, j as ReportResult } from './types-DfVtKZcp.js';
 import 'react';
 
 /** Who to attribute the report to. A server has no signed-in user, so this is the job or service. */
@@ -375,6 +375,44 @@ interface BookingSettings {
      * change it; leave the field out and it keeps what is stored.
      */
     notifyRecipients: BookingNotifyRecipient[];
+    /**
+     * What a prospect is asked before they see the calendar — in the booking
+     * dialog and over WhatsApp — so the right person takes the demo. At most 5.
+     * Send the whole list to change it (`[]` asks nothing); leave the field out
+     * and it keeps what is stored. The answers come back on {@link Booking.answers}.
+     */
+    questions: BookingQuestion[];
+}
+/** One question asked before a demo is booked. The prospect taps one of `options`. */
+interface BookingQuestion {
+    /**
+     * Stable name for the question, e.g. `"language"` — lower case letters,
+     * digits, `-` and `_`. Leave it out on a new question and one is made from
+     * the label; keep it when rewording so earlier answers still line up.
+     */
+    id: string;
+    /** What is asked, up to 80 characters. */
+    label: string;
+    /** 2–9 choices, up to 40 characters each. */
+    options: string[];
+    /** False lets the prospect skip it. */
+    required: boolean;
+}
+/** A question as you send it: `id` and `required` may be left out on a new one. */
+type BookingQuestionInput = Omit<BookingQuestion, "id" | "required"> & {
+    id?: string;
+    required?: boolean;
+};
+/** What {@link updateBookingSettings} accepts — any subset of the settings. */
+type BookingSettingsChanges = Partial<Omit<BookingSettings, "questions">> & {
+    questions?: BookingQuestionInput[];
+};
+/** One answer a prospect gave, with the question as it was worded when they booked. */
+interface BookingAnswer {
+    /** The {@link BookingQuestion.id} it answers. */
+    id: string;
+    question: string;
+    answer: string;
 }
 /** One extra person alerted when a demo is booked. */
 interface BookingNotifyRecipient {
@@ -414,7 +452,7 @@ declare function getBookingSettings(options?: CallsOptions): Promise<BookingSett
  * `error` is worth showing: a WhatsApp code already taken by another project
  * comes back as one.
  */
-declare function updateBookingSettings(changes: Partial<BookingSettings>, options?: CallsOptions): Promise<BookingSettingsResult>;
+declare function updateBookingSettings(changes: BookingSettingsChanges, options?: CallsOptions): Promise<BookingSettingsResult>;
 /** One booked demo. Times are ISO strings in UTC; `timezone` is what the prospect picked in. */
 interface Booking {
     id: string;
@@ -429,6 +467,8 @@ interface Booking {
     timezone: string | null;
     /** What they typed when booking, if anything. */
     note: string | null;
+    /** What they answered to the project's {@link BookingSettings.questions}. Empty when nothing was asked. */
+    answers: BookingAnswer[];
     /** `CONFIRMED` or `CANCELLED`. Unverified holds are never returned. */
     status: string;
     /** The Google Meet room. Null until the booking is confirmed. */
@@ -506,5 +546,49 @@ declare function cancelBooking(id: string, reason?: string, options?: CallsOptio
  * Never throws: a value JSON cannot represent (circular, `undefined`) becomes `null`.
  */
 declare function escapeJsonForScript(value: unknown): string;
+/** One lead. One per phone number per project; a repeat submission updates it. */
+interface Lead {
+    id: string;
+    name: string;
+    /** Digits only, country code included. */
+    phone: string;
+    email: string | null;
+    company: string | null;
+    address: string | null;
+    /** What your form passed as `source`, e.g. `"demo"`. */
+    source: string;
+    metadata: Record<string, string | number | boolean> | null;
+    /** The page the lead was left on. */
+    pageUrl: string | null;
+    /** How many times this phone submitted. */
+    submissions: number;
+    /** First submission. */
+    createdAt: string;
+    /** Latest submission. */
+    updatedAt: string;
+    /** The demo this lead went on to book, matched by phone or email. */
+    booking: {
+        id: string;
+        startsAt: string;
+        status: string;
+    } | null;
+}
+interface ListLeadsOptions extends CallsOptions {
+    /** Only leads with this `source`. */
+    source?: string;
+    /** Only leads first left at or after this time. */
+    since?: Date | string;
+    /** Up to 200. Defaults to 100. */
+    limit?: number;
+}
+/**
+ * The project's leads, newest first. Never throws — an empty list on any
+ * failure.
+ *
+ * ```ts
+ * const leads = await listLeads({ source: "demo" }); // GLITCHGRAB_CALLS_KEY=ggc_…
+ * ```
+ */
+declare function listLeads(options?: ListLeadsOptions): Promise<Lead[]>;
 
-export { type Booking, type BookingClientNotice, type BookingMutationResult, type BookingNotifyRecipient, type BookingSettings, type BookingSettingsResult, type BookingSettingsState, type BookingWorkingHours, type Call, type CallAudio, type CallListItem, type CallMoment, type CallParticipant, type CallsOptions, type CaptureServerErrorsOptions, type DeleteCallResult, type GetCallOptions, type Guide, type GuideReadOptions, type GuideSummary, type ListBookingsOptions, type ListCallsOptions, ReportResult, ReportSeverity, ReportType, type ServerReportOptions, type ServerReporterConfig, type ServerReporterIdentity, type SignSessionOptions, cancelBooking, captureServerErrors, configureServerReporter, deleteCall, escapeJsonForScript, getBookingSettings, getCall, getGuide, listBookings, listCalls, listGuides, reportServerError, rescheduleBooking, resetServerReporter, signSession, updateBookingSettings };
+export { type Booking, type BookingAnswer, type BookingClientNotice, type BookingMutationResult, type BookingNotifyRecipient, type BookingQuestion, type BookingQuestionInput, type BookingSettings, type BookingSettingsChanges, type BookingSettingsResult, type BookingSettingsState, type BookingWorkingHours, type Call, type CallAudio, type CallListItem, type CallMoment, type CallParticipant, type CallsOptions, type CaptureServerErrorsOptions, type DeleteCallResult, type GetCallOptions, type Guide, type GuideReadOptions, type GuideSummary, type Lead, type ListBookingsOptions, type ListCallsOptions, type ListLeadsOptions, ReportResult, ReportSeverity, ReportType, type ServerReportOptions, type ServerReporterConfig, type ServerReporterIdentity, type SignSessionOptions, cancelBooking, captureServerErrors, configureServerReporter, deleteCall, escapeJsonForScript, getBookingSettings, getCall, getGuide, listBookings, listCalls, listGuides, listLeads, reportServerError, rescheduleBooking, resetServerReporter, signSession, updateBookingSettings };

package/dist/server.js

@@ -31,6 +31,7 @@ __export(server_exports, {
   listBookings: () => listBookings,
   listCalls: () => listCalls,
   listGuides: () => listGuides,
+  listLeads: () => listLeads,
   reportServerError: () => reportServerError,
   rescheduleBooking: () => rescheduleBooking,
   resetServerReporter: () => resetServerReporter,
@@ -499,7 +500,16 @@ function readBookingSettingsState(value) {
           name: (_a2 = stringOrNull(row.name)) != null ? _a2 : "",
           phone: (_b2 = stringOrNull(row.phone)) != null ? _b2 : ""
         };
-      }).filter((row) => row.phone !== "") : []
+      }).filter((row) => row.phone !== "") : [],
+      questions: Array.isArray(s.questions) ? s.questions.filter(isRecord).map((row) => {
+        var _a2, _b2;
+        return {
+          id: (_a2 = stringOrNull(row.id)) != null ? _a2 : "",
+          label: (_b2 = stringOrNull(row.label)) != null ? _b2 : "",
+          options: Array.isArray(row.options) ? row.options.filter((option) => typeof option === "string") : [],
+          required: row.required !== false
+        };
+      }).filter((row) => row.id !== "" && row.label !== "") : []
     },
     saved: value.saved === true,
     calendarConnected: value.calendarConnected === true
@@ -543,6 +553,14 @@ function readBooking(value) {
     endsAt: (_e = stringOrNull(value.endsAt)) != null ? _e : "",
     timezone: stringOrNull(value.timezone),
     note: stringOrNull(value.note),
+    answers: Array.isArray(value.answers) ? value.answers.filter(isRecord).map((row) => {
+      var _a2, _b2, _c2;
+      return {
+        id: (_a2 = stringOrNull(row.id)) != null ? _a2 : "",
+        question: (_b2 = stringOrNull(row.question)) != null ? _b2 : "",
+        answer: (_c2 = stringOrNull(row.answer)) != null ? _c2 : ""
+      };
+    }).filter((row) => row.answer !== "") : [],
     status: (_f = stringOrNull(value.status)) != null ? _f : "CONFIRMED",
     meetUrl: stringOrNull(value.meetUrl),
     createdAt: (_g = stringOrNull(value.createdAt)) != null ? _g : ""
@@ -619,6 +637,52 @@ function escapeJsonForScript(value) {
     return "null";
   }
 }
+function readLead(value) {
+  var _a, _b, _c, _d, _e, _f, _g;
+  if (!isRecord(value) || typeof value.id !== "string") return null;
+  const metadata = isRecord(value.metadata) ? value.metadata : null;
+  const booking = isRecord(value.booking) && typeof value.booking.id === "string" ? {
+    id: value.booking.id,
+    startsAt: (_a = stringOrNull(value.booking.startsAt)) != null ? _a : "",
+    status: (_b = stringOrNull(value.booking.status)) != null ? _b : "CONFIRMED"
+  } : null;
+  return {
+    id: value.id,
+    name: (_c = stringOrNull(value.name)) != null ? _c : "",
+    phone: (_d = stringOrNull(value.phone)) != null ? _d : "",
+    email: stringOrNull(value.email),
+    company: stringOrNull(value.company),
+    address: stringOrNull(value.address),
+    source: (_e = stringOrNull(value.source)) != null ? _e : "",
+    metadata,
+    pageUrl: stringOrNull(value.pageUrl),
+    submissions: typeof value.submissions === "number" ? value.submissions : 1,
+    createdAt: (_f = stringOrNull(value.createdAt)) != null ? _f : "",
+    updatedAt: (_g = stringOrNull(value.updatedAt)) != null ? _g : "",
+    booking
+  };
+}
+async function listLeads(options = {}) {
+  try {
+    const key = callsKey(options);
+    if (!key) return [];
+    const query = new URLSearchParams();
+    if (options.source) query.set("source", options.source);
+    if (options.since) {
+      const since = options.since instanceof Date ? options.since : new Date(options.since);
+      if (!Number.isNaN(since.getTime())) query.set("since", since.toISOString());
+    }
+    setNumber(query, "limit", options.limit);
+    const qs = query.toString();
+    const { data } = await callSdkApi(`/api/v1/sdk/leads${qs ? `?${qs}` : ""}`, key, options, {
+      cache: "no-store"
+    });
+    if (!Array.isArray(data)) return [];
+    return data.map(readLead).filter((lead) => lead !== null);
+  } catch (e) {
+    return [];
+  }
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   cancelBooking,
@@ -632,6 +696,7 @@ function escapeJsonForScript(value) {
   listBookings,
   listCalls,
   listGuides,
+  listLeads,
   reportServerError,
   rescheduleBooking,
   resetServerReporter,