glitchgrab 1.53.0 → 1.55.0

package/README.md

@@ -754,6 +754,29 @@ if (!result.success) {
 }
 ```
 
+### Attach the logs that led up to it
+
+A stack says where a job broke; the lines it printed before that usually say
+why. Pass them as `logs` — an array of lines or one string:
+
+```ts
+const lines: string[] = [];
+const log = (line: string) => { lines.push(line); console.log(line); };
+
+try {
+  log(`[filing] starting return ${returnId}`);
+  await submitReturn(returnId);
+} catch (error) {
+  await reportServerError(error, { context: "worker/filing", logs: lines });
+  throw error;
+}
+```
+
+They arrive on the issue as a `.log` file named after `context`: the start is
+previewed in the issue body, the whole file is kept for download. Only the last
+200,000 characters are sent. Logs are not part of the grouping key — the same
+error with different logs still lands on one issue.
+
 ### Set the token once
 
 ```ts
@@ -795,6 +818,7 @@ reportServerError(error: unknown, options?: {
                                 // anything else is rejected 400 by the API
   pageUrl?: string;             // a real request URL, when there is one
   metadata?: Record<string, string>;
+  logs?: string | string[];     // attached as <context>.log — last 200,000 chars
   reporter?: { id?: string; name?: string; email?: string; phone?: string };
   enableInDevelopment?: boolean;
 })

package/dist/server.d.mts

@@ -48,6 +48,15 @@ interface ServerReportOptions extends ServerReporterConfig {
      * the synthetic URL built from `context`.
      */
     pageUrl?: string;
+    /**
+     * What the job printed before it failed — lines or one string.
+     *
+     * Attached to the issue as a `.log` file: the first part is previewed in the
+     * issue body, the whole file is kept for download. A stack says where it
+     * broke; the log lines before it are usually what says why. Only the last
+     * {@link MAX_LOG_CHARS} characters are sent.
+     */
+    logs?: string | string[];
 }
 /**
  * Set the token and the defaults once, at module load, instead of passing them
@@ -359,6 +368,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 +415,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 +507,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

@@ -48,6 +48,15 @@ interface ServerReportOptions extends ServerReporterConfig {
      * the synthetic URL built from `context`.
      */
     pageUrl?: string;
+    /**
+     * What the job printed before it failed — lines or one string.
+     *
+     * Attached to the issue as a `.log` file: the first part is previewed in the
+     * issue body, the whole file is kept for download. A stack says where it
+     * broke; the log lines before it are usually what says why. Only the last
+     * {@link MAX_LOG_CHARS} characters are sent.
+     */
+    logs?: string | string[];
 }
 /**
  * Set the token and the defaults once, at module load, instead of passing them
@@ -359,6 +368,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 +415,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 +507,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
@@ -90,6 +93,7 @@ async function sendReport(payload, baseUrl) {
 }
 
 // src/server.ts
+var MAX_LOG_CHARS = 2e5;
 var DEV_BLOCKED_MESSAGE = "development";
 function nodeProcess() {
   try {
@@ -142,6 +146,22 @@ function contextUrl(context) {
   if (!context) return void 0;
   return `server://${context.replace(/^\/+/, "")}`;
 }
+function logsAttachment(logs, context) {
+  try {
+    const text = Array.isArray(logs) ? logs.join("\n") : logs;
+    if (!text || !text.trim()) return null;
+    const tail = text.length > MAX_LOG_CHARS ? text.slice(-MAX_LOG_CHARS) : text;
+    const bytes = new TextEncoder().encode(tail);
+    let binary = "";
+    for (let i = 0; i < bytes.length; i += 32768) {
+      binary += String.fromCharCode(...bytes.subarray(i, i + 32768));
+    }
+    const name = `${(context != null ? context : "server").replace(/[^a-z0-9._-]+/gi, "-").replace(/^-+|-+$/g, "") || "server"}.log`;
+    return JSON.stringify([{ name, dataUrl: `data:text/plain;base64,${btoa(binary)}` }]);
+  } catch (e) {
+    return null;
+  }
+}
 function runtimeMetadata() {
   var _a, _b;
   try {
@@ -189,6 +209,8 @@ async function reportServerError(error, options = {}) {
         ...reporter.phone ? { sessionUserPhone: reporter.phone } : {}
       }
     };
+    const attachments = logsAttachment(options.logs, context);
+    if (attachments && payload.metadata) payload.metadata.attachments = attachments;
     return await sendReport(payload, (_m = (_l = options.baseUrl) != null ? _l : defaults.baseUrl) != null ? _m : readEnv("GLITCHGRAB_BASE_URL"));
   } catch (e) {
     return null;
@@ -470,7 +492,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 +531,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 +621,7 @@ function escapeJsonForScript(value) {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  cancelBooking,
   captureServerErrors,
   configureServerReporter,
   deleteCall,
@@ -520,9 +629,11 @@ function escapeJsonForScript(value) {
   getBookingSettings,
   getCall,
   getGuide,
+  listBookings,
   listCalls,
   listGuides,
   reportServerError,
+  rescheduleBooking,
   resetServerReporter,
   signSession,
   updateBookingSettings