glitchgrab 1.51.0 → 1.53.0

package/README.md

@@ -944,6 +944,56 @@ interface CallsOptions {
 }
 ```
 
+## How do I change demo booking settings from my admin panel?
+
+The same server key reads and writes the project's demo booking settings —
+whether prospects can book, working hours, slot length, notice, and the
+WhatsApp code. Which Google calendar demos land in is **not** exposed: that
+stays set in Glitchgrab → Calls → Booking.
+
+```ts
+// app/api/admin/booking/route.ts — behind your admin auth
+import { getBookingSettings, updateBookingSettings } from "glitchgrab/server";
+
+const current = await getBookingSettings(); // GLITCHGRAB_CALLS_KEY=ggc_…
+if (current.ok && !current.data.calendarConnected) {
+  // no calendar → no slots, whatever `enabled` says
+}
+
+const saved = await updateBookingSettings({ enabled: true, slotMinutes: 45 });
+if (!saved.ok) console.error(saved.error); // e.g. WhatsApp code already taken
+```
+
+- **Send only what changed.** A field left out keeps its value.
+- **Values are clamped** (slot 15–180 min, gap 0–120, 1–90 days ahead, notice
+  0–10080 min) and invalid working hours are ignored — read `data.settings`
+  back instead of trusting what you sent.
+- **Never throws.** Failures come back as `{ ok: false, error }`, never as defaults.
+
+```ts
+getBookingSettings(options?: CallsOptions): Promise<BookingSettingsResult>
+updateBookingSettings(changes: Partial<BookingSettings>, options?: CallsOptions): Promise<BookingSettingsResult>
+
+type BookingSettingsResult =
+  | { ok: true; data: { settings: BookingSettings; saved: boolean; calendarConnected: boolean } }
+  | { ok: false; error: string };
+
+interface BookingSettings {
+  enabled: boolean;
+  slotMinutes: number;
+  bufferMinutes: number;
+  timezone: string;                                   // IANA, e.g. "Asia/Kolkata"
+  workingHours: Record<string, [string, string][]>;   // { "1": [["09:00","17:00"]] }, 1 = Monday
+  title: string | null;
+  description: string | null;
+  hostName: string | null;      // who the visitor meets, shown beside the calendar
+  hostAvatarUrl: string | null; // https only; anything else is ignored on save
+  horizonDays: number;
+  noticeMinutes: number;
+  whatsappCode: string | null;
+}
+```
+
 ## What configuration options are available?
 
 | Prop | Type | Default | Description |