@peektravel/app-utilities 0.1.5 → 0.1.6

package/README.md

@@ -196,6 +196,39 @@ both `import` and `require` consumers (including the Node 22 / CommonJS Firebase
 Functions runtime) resolve correctly. Its only runtime dependency is
 `jsonwebtoken`.
 
+## Webhooks
+
+Receiver apps can consume Peek **booking** and **waiver** webhooks without
+hand-writing a payload parser. Each has a pure parser (construct nothing — no
+auth/network) that returns a clean model:
+
+```ts
+import {
+  parseBookingWebhook,
+  parseWaiverWebhook,
+  type Booking,
+  type Waiver,
+} from "@peektravel/app-utilities";
+
+app.post("/booking-webhook", (req, res) => {
+  const booking: Booking = parseBookingWebhook(req.body);
+  res.sendStatus(200);
+});
+
+app.post("/waiver-webhook", (req, res) => {
+  const waiver: Waiver = parseWaiverWebhook(req.body);
+  res.sendStatus(200);
+});
+```
+
+Both tolerate the delivery envelope / a bare node / a JSON string and never throw
+on malformed input. They differ on registration: a **booking** webhook's payload
+shape is set by a GraphQL query configured **once in an external system** (the
+App Store `broadcast_to_url` config) — this package documents and drift-guards
+the exact query to paste there — whereas a **waiver** webhook has a fixed payload,
+so you just subscribe to its event with no query. **The query to register and the
+full guide: [`docs/webhooks.md`](docs/webhooks.md) (shipped).**
+
 ## UI components (`/ui`)
 
 The package also ships framework-agnostic **Web Components** ported from the Peek
@@ -326,6 +359,7 @@ src/ui/                    Web Components + Odyssey CSS (barrel: src/ui/index.ts
 test/                      vitest unit tests (test/ui/* run under happy-dom)
 examples/ui-gallery.html   component gallery (npm run sample)
 dist/                      build output (generated, git-ignored)
+docs/webhooks.md           booking-webhook consumer guide (shipped)
 docs/internal/             maintainer docs (ARCHITECTURE.md — not shipped)
 llms.txt                   AI-agent quickstart (shipped in the package)
 ```

package/dist/index.cjs

@@ -3078,6 +3078,91 @@ function requireNonEmpty(value, name) {
   }
 }
 
+// src/internal/bookings/booking-webhook.ts
+var PAYLOAD_BOOKING_KEY = "booking";
+var VALUE_OPEN_TOKEN = "value {";
+var PRICE_BREAKDOWN_KEYS = [
+  "convenienceFee",
+  "deposit",
+  "discount",
+  "discountedPrice",
+  "fees",
+  "flatPartnerFee",
+  "price",
+  "retailPrice",
+  "taxes"
+];
+buildMaximalWebhookQuery();
+function buildMaximalWebhookQuery() {
+  const fields = bookingQueryFields.replace(
+    VALUE_OPEN_TOKEN,
+    `${VALUE_OPEN_TOKEN} ${PRICE_BREAKDOWN_FIELDS}`
+  );
+  return `{ ${fields} ${bookingGuestsFields} }`.replace(/\s+/g, " ").trim();
+}
+function parseBookingWebhook(payload) {
+  const node = extractBookingNode(payload);
+  return fromBookingNode(node, hasGuests(node), hasPriceBreakdown(node));
+}
+function extractBookingNode(payload) {
+  let body = payload;
+  if (typeof body === "string") {
+    try {
+      body = JSON.parse(body);
+    } catch {
+      return {};
+    }
+  }
+  if (!body || typeof body !== "object") return {};
+  const record = body;
+  const inner = record[PAYLOAD_BOOKING_KEY];
+  if (inner && typeof inner === "object") return inner;
+  return record;
+}
+function hasGuests(node) {
+  return Array.isArray(node.bookingGuests);
+}
+function hasPriceBreakdown(node) {
+  const value = node.value;
+  if (!value) return false;
+  return PRICE_BREAKDOWN_KEYS.some((key) => key in value);
+}
+
+// src/internal/waivers/waiver-webhook.ts
+var PAYLOAD_WAIVER_KEY = "waiver";
+function parseWaiverWebhook(payload) {
+  return fromWaiverNode(extractWaiverNode(payload));
+}
+function fromWaiverNode(node) {
+  const data = node ?? {};
+  const waiverData = data.waiver_data ?? {};
+  return {
+    templateId: data.agreement_template_id || "",
+    bookingId: data.booking_id || "",
+    fileUrl: data.file_url || "",
+    signedAt: data.signed_at || "",
+    isSignedByGuardian: Boolean(data.signed_by_guardian),
+    guestName: waiverData.participant_name || null,
+    isOptinMarketing: Boolean(waiverData.participant_optin_marketing),
+    isOptinSms: Boolean(waiverData.participant_optin_sms)
+  };
+}
+function extractWaiverNode(payload) {
+  let body = payload;
+  if (typeof body === "string") {
+    try {
+      body = JSON.parse(body);
+    } catch {
+      return {};
+    }
+  }
+  if (!body || typeof body !== "object") return {};
+  const record = body;
+  const inner = record[PAYLOAD_WAIVER_KEY];
+  if (inner && typeof inner === "object") return inner;
+  return record;
+}
+
 exports.ADD_ON_PRODUCT_TYPE = ADD_ON_PRODUCT_TYPE;
 exports.AccountUserService = AccountUserService;
 exports.AdminAccountRequiredError = AdminAccountRequiredError;
@@ -3095,5 +3180,7 @@ exports.ResourcePoolService = ResourcePoolService;
 exports.ReviewService = ReviewService;
 exports.TimeslotService = TimeslotService;
 exports.noopLogger = noopLogger;
+exports.parseBookingWebhook = parseBookingWebhook;
+exports.parseWaiverWebhook = parseWaiverWebhook;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map