glitchgrab 1.53.0 → 1.54.0

package/dist/server.d.mts

@@ -359,6 +359,19 @@ interface BookingSettings {
     noticeMinutes: number;
     /** Code in the "Book on WhatsApp" link. Lower case, letters, digits and `-`; unique across projects. */
     whatsappCode: string | null;
+    /**
+     * Who else is WhatsApped when a demo is booked, besides the project owner —
+     * sales, the founders, whoever needs the lead as it lands. At most 5; a
+     * ten-digit Indian mobile is stored with its 91. Send the whole list to
+     * change it; leave the field out and it keeps what is stored.
+     */
+    notifyRecipients: BookingNotifyRecipient[];
+}
+/** One extra person alerted when a demo is booked. */
+interface BookingNotifyRecipient {
+    name: string;
+    /** Digits only, country code included. */
+    phone: string;
 }
 interface BookingSettingsState {
     settings: BookingSettings;
@@ -393,6 +406,78 @@ declare function getBookingSettings(options?: CallsOptions): Promise<BookingSett
  * comes back as one.
  */
 declare function updateBookingSettings(changes: Partial<BookingSettings>, options?: CallsOptions): Promise<BookingSettingsResult>;
+/** One booked demo. Times are ISO strings in UTC; `timezone` is what the prospect picked in. */
+interface Booking {
+    id: string;
+    /** Who booked. */
+    name: string;
+    email: string;
+    /** Digits only, country code included. */
+    phone: string;
+    startsAt: string;
+    endsAt: string;
+    /** IANA zone the prospect booked in, e.g. `"Asia/Kolkata"`. */
+    timezone: string | null;
+    /** What they typed when booking, if anything. */
+    note: string | null;
+    /** `CONFIRMED` or `CANCELLED`. Unverified holds are never returned. */
+    status: string;
+    /** The Google Meet room. Null until the booking is confirmed. */
+    meetUrl: string | null;
+    createdAt: string;
+}
+interface ListBookingsOptions extends CallsOptions {
+    /** `"upcoming"` (default) or `"past"`. */
+    scope?: "upcoming" | "past";
+    /** Up to 100. Defaults to 50. */
+    limit?: number;
+}
+/**
+ * Whether the prospect was told. A move re-sends the approved confirmation
+ * template, so `"sent"` is real. A cancellation can only go as free text, which
+ * WhatsApp delivers only inside its 24-hour window and reports nothing about —
+ * `"attempted"` means exactly that, and your panel should say so rather than
+ * telling an admin the client knows.
+ */
+type BookingClientNotice = "sent" | "attempted" | "none";
+type BookingMutationResult = {
+    ok: true;
+    booking: Booking | null;
+    clientNotice: BookingClientNotice;
+} | {
+    ok: false;
+    error: string;
+    code: string | null;
+};
+/**
+ * The project's booked demos, soonest first. Never throws — an empty list on
+ * any failure, so a panel renders "no demos" instead of a stack trace.
+ *
+ * ```ts
+ * const demos = await listBookings(); // GLITCHGRAB_CALLS_KEY=ggc_…
+ * ```
+ */
+declare function listBookings(options?: ListBookingsOptions): Promise<Booking[]>;
+/**
+ * Move a demo to a new start time. The Google event is patched, never
+ * recreated, so the Meet link in every message already sent stays alive, and
+ * the prospect is re-sent the confirmation with the new time.
+ *
+ * `{ ok: false, code: "SLOT_TAKEN" }` when another booking holds that slot,
+ * `"PAST"` for a time that has gone, `"CALENDAR"` when Google refused — in the
+ * last case nothing was changed and the demo still stands at its old time.
+ */
+declare function rescheduleBooking(id: string, startsAt: Date | string, options?: CallsOptions): Promise<BookingMutationResult>;
+/**
+ * Call a demo off: the Google event is deleted, the recorder is stood down, and
+ * the prospect is messaged if WhatsApp will carry it (see
+ * {@link BookingClientNotice}).
+ *
+ * `reason` is included in that message. Nothing is marked cancelled unless the
+ * calendar agreed first, so `{ ok: false, code: "CALENDAR" }` means the demo is
+ * still on.
+ */
+declare function cancelBooking(id: string, reason?: string, options?: CallsOptions): Promise<BookingMutationResult>;
 /**
  * `JSON.stringify` that is safe inside `<script type="application/ld+json">`.
  *
@@ -413,4 +498,4 @@ declare function updateBookingSettings(changes: Partial<BookingSettings>, option
  */
 declare function escapeJsonForScript(value: unknown): string;
 
-export { 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 ListCallsOptions, ReportResult, ReportSeverity, ReportType, type ServerReportOptions, type ServerReporterConfig, type ServerReporterIdentity, type SignSessionOptions, captureServerErrors, configureServerReporter, deleteCall, escapeJsonForScript, getBookingSettings, getCall, getGuide, listCalls, listGuides, reportServerError, resetServerReporter, signSession, updateBookingSettings };
+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 };

package/dist/server.d.ts

@@ -359,6 +359,19 @@ interface BookingSettings {
     noticeMinutes: number;
     /** Code in the "Book on WhatsApp" link. Lower case, letters, digits and `-`; unique across projects. */
     whatsappCode: string | null;
+    /**
+     * Who else is WhatsApped when a demo is booked, besides the project owner —
+     * sales, the founders, whoever needs the lead as it lands. At most 5; a
+     * ten-digit Indian mobile is stored with its 91. Send the whole list to
+     * change it; leave the field out and it keeps what is stored.
+     */
+    notifyRecipients: BookingNotifyRecipient[];
+}
+/** One extra person alerted when a demo is booked. */
+interface BookingNotifyRecipient {
+    name: string;
+    /** Digits only, country code included. */
+    phone: string;
 }
 interface BookingSettingsState {
     settings: BookingSettings;
@@ -393,6 +406,78 @@ declare function getBookingSettings(options?: CallsOptions): Promise<BookingSett
  * comes back as one.
  */
 declare function updateBookingSettings(changes: Partial<BookingSettings>, options?: CallsOptions): Promise<BookingSettingsResult>;
+/** One booked demo. Times are ISO strings in UTC; `timezone` is what the prospect picked in. */
+interface Booking {
+    id: string;
+    /** Who booked. */
+    name: string;
+    email: string;
+    /** Digits only, country code included. */
+    phone: string;
+    startsAt: string;
+    endsAt: string;
+    /** IANA zone the prospect booked in, e.g. `"Asia/Kolkata"`. */
+    timezone: string | null;
+    /** What they typed when booking, if anything. */
+    note: string | null;
+    /** `CONFIRMED` or `CANCELLED`. Unverified holds are never returned. */
+    status: string;
+    /** The Google Meet room. Null until the booking is confirmed. */
+    meetUrl: string | null;
+    createdAt: string;
+}
+interface ListBookingsOptions extends CallsOptions {
+    /** `"upcoming"` (default) or `"past"`. */
+    scope?: "upcoming" | "past";
+    /** Up to 100. Defaults to 50. */
+    limit?: number;
+}
+/**
+ * Whether the prospect was told. A move re-sends the approved confirmation
+ * template, so `"sent"` is real. A cancellation can only go as free text, which
+ * WhatsApp delivers only inside its 24-hour window and reports nothing about —
+ * `"attempted"` means exactly that, and your panel should say so rather than
+ * telling an admin the client knows.
+ */
+type BookingClientNotice = "sent" | "attempted" | "none";
+type BookingMutationResult = {
+    ok: true;
+    booking: Booking | null;
+    clientNotice: BookingClientNotice;
+} | {
+    ok: false;
+    error: string;
+    code: string | null;
+};
+/**
+ * The project's booked demos, soonest first. Never throws — an empty list on
+ * any failure, so a panel renders "no demos" instead of a stack trace.
+ *
+ * ```ts
+ * const demos = await listBookings(); // GLITCHGRAB_CALLS_KEY=ggc_…
+ * ```
+ */
+declare function listBookings(options?: ListBookingsOptions): Promise<Booking[]>;
+/**
+ * Move a demo to a new start time. The Google event is patched, never
+ * recreated, so the Meet link in every message already sent stays alive, and
+ * the prospect is re-sent the confirmation with the new time.
+ *
+ * `{ ok: false, code: "SLOT_TAKEN" }` when another booking holds that slot,
+ * `"PAST"` for a time that has gone, `"CALENDAR"` when Google refused — in the
+ * last case nothing was changed and the demo still stands at its old time.
+ */
+declare function rescheduleBooking(id: string, startsAt: Date | string, options?: CallsOptions): Promise<BookingMutationResult>;
+/**
+ * Call a demo off: the Google event is deleted, the recorder is stood down, and
+ * the prospect is messaged if WhatsApp will carry it (see
+ * {@link BookingClientNotice}).
+ *
+ * `reason` is included in that message. Nothing is marked cancelled unless the
+ * calendar agreed first, so `{ ok: false, code: "CALENDAR" }` means the demo is
+ * still on.
+ */
+declare function cancelBooking(id: string, reason?: string, options?: CallsOptions): Promise<BookingMutationResult>;
 /**
  * `JSON.stringify` that is safe inside `<script type="application/ld+json">`.
  *
@@ -413,4 +498,4 @@ declare function updateBookingSettings(changes: Partial<BookingSettings>, option
  */
 declare function escapeJsonForScript(value: unknown): string;
 
-export { 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 ListCallsOptions, ReportResult, ReportSeverity, ReportType, type ServerReportOptions, type ServerReporterConfig, type ServerReporterIdentity, type SignSessionOptions, captureServerErrors, configureServerReporter, deleteCall, escapeJsonForScript, getBookingSettings, getCall, getGuide, listCalls, listGuides, reportServerError, resetServerReporter, signSession, updateBookingSettings };
+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 };

package/dist/server.js

@@ -20,6 +20,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/server.ts
 var server_exports = {};
 __export(server_exports, {
+  cancelBooking: () => cancelBooking,
   captureServerErrors: () => captureServerErrors,
   configureServerReporter: () => configureServerReporter,
   deleteCall: () => deleteCall,
@@ -27,9 +28,11 @@ __export(server_exports, {
   getBookingSettings: () => getBookingSettings,
   getCall: () => getCall,
   getGuide: () => getGuide,
+  listBookings: () => listBookings,
   listCalls: () => listCalls,
   listGuides: () => listGuides,
   reportServerError: () => reportServerError,
+  rescheduleBooking: () => rescheduleBooking,
   resetServerReporter: () => resetServerReporter,
   signSession: () => signSession,
   updateBookingSettings: () => updateBookingSettings
@@ -470,7 +473,14 @@ function readBookingSettingsState(value) {
       hostAvatarUrl: stringOrNull(s.hostAvatarUrl),
       horizonDays: (_c = numberOrNull(s.horizonDays)) != null ? _c : 15,
       noticeMinutes: (_d = numberOrNull(s.noticeMinutes)) != null ? _d : 120,
-      whatsappCode: stringOrNull(s.whatsappCode)
+      whatsappCode: stringOrNull(s.whatsappCode),
+      notifyRecipients: Array.isArray(s.notifyRecipients) ? s.notifyRecipients.filter(isRecord).map((row) => {
+        var _a2, _b2;
+        return {
+          name: (_a2 = stringOrNull(row.name)) != null ? _a2 : "",
+          phone: (_b2 = stringOrNull(row.phone)) != null ? _b2 : ""
+        };
+      }).filter((row) => row.phone !== "") : []
     },
     saved: value.saved === true,
     calendarConnected: value.calendarConnected === true
@@ -502,6 +512,85 @@ async function updateBookingSettings(changes, options = {}) {
     return { ok: false, error: "Could not save booking settings" };
   }
 }
+function readBooking(value) {
+  var _a, _b, _c, _d, _e, _f, _g;
+  if (!isRecord(value) || typeof value.id !== "string") return null;
+  return {
+    id: value.id,
+    name: (_a = stringOrNull(value.name)) != null ? _a : "",
+    email: (_b = stringOrNull(value.email)) != null ? _b : "",
+    phone: (_c = stringOrNull(value.phone)) != null ? _c : "",
+    startsAt: (_d = stringOrNull(value.startsAt)) != null ? _d : "",
+    endsAt: (_e = stringOrNull(value.endsAt)) != null ? _e : "",
+    timezone: stringOrNull(value.timezone),
+    note: stringOrNull(value.note),
+    status: (_f = stringOrNull(value.status)) != null ? _f : "CONFIRMED",
+    meetUrl: stringOrNull(value.meetUrl),
+    createdAt: (_g = stringOrNull(value.createdAt)) != null ? _g : ""
+  };
+}
+async function listBookings(options = {}) {
+  try {
+    const key = callsKey(options);
+    if (!key) return [];
+    const query = new URLSearchParams();
+    if (options.scope === "past") query.set("scope", "past");
+    setNumber(query, "limit", options.limit);
+    const qs = query.toString();
+    const { data } = await callSdkApi(`/api/v1/sdk/bookings${qs ? `?${qs}` : ""}`, key, options, {
+      cache: "no-store"
+    });
+    if (!Array.isArray(data)) return [];
+    return data.map(readBooking).filter((booking) => booking !== null);
+  } catch (e) {
+    return [];
+  }
+}
+function readMutation(data, error) {
+  if (error !== null) return { ok: false, error, code: null };
+  const record = isRecord(data) ? data : {};
+  const notice = stringOrNull(record.clientNotice);
+  return {
+    ok: true,
+    booking: readBooking(record.booking),
+    clientNotice: notice === "sent" || notice === "attempted" ? notice : "none"
+  };
+}
+async function rescheduleBooking(id, startsAt, options = {}) {
+  try {
+    const wanted = typeof id === "string" ? id.trim() : "";
+    const key = callsKey(options);
+    if (!wanted) return { ok: false, error: "No booking id", code: null };
+    if (!key) return { ok: false, error: NO_KEY_ERROR, code: null };
+    const when = startsAt instanceof Date ? startsAt.toISOString() : String(startsAt);
+    const { data, error } = await callSdkApi(
+      `/api/v1/sdk/bookings?id=${encodeURIComponent(wanted)}`,
+      key,
+      options,
+      { method: "PATCH", body: { startsAt: when }, cache: "no-store" }
+    );
+    return readMutation(data, error);
+  } catch (e) {
+    return { ok: false, error: "Could not move that demo", code: null };
+  }
+}
+async function cancelBooking(id, reason, options = {}) {
+  try {
+    const wanted = typeof id === "string" ? id.trim() : "";
+    const key = callsKey(options);
+    if (!wanted) return { ok: false, error: "No booking id", code: null };
+    if (!key) return { ok: false, error: NO_KEY_ERROR, code: null };
+    const query = new URLSearchParams({ id: wanted });
+    if (typeof reason === "string" && reason.trim()) query.set("reason", reason.trim().slice(0, 200));
+    const { data, error } = await callSdkApi(`/api/v1/sdk/bookings?${query.toString()}`, key, options, {
+      method: "DELETE",
+      cache: "no-store"
+    });
+    return readMutation(data, error);
+  } catch (e) {
+    return { ok: false, error: "Could not cancel that demo", code: null };
+  }
+}
 function escapeJsonForScript(value) {
   try {
     const json = JSON.stringify(value);
@@ -513,6 +602,7 @@ function escapeJsonForScript(value) {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  cancelBooking,
   captureServerErrors,
   configureServerReporter,
   deleteCall,
@@ -520,9 +610,11 @@ function escapeJsonForScript(value) {
   getBookingSettings,
   getCall,
   getGuide,
+  listBookings,
   listCalls,
   listGuides,
   reportServerError,
+  rescheduleBooking,
   resetServerReporter,
   signSession,
   updateBookingSettings