@peektravel/app-utilities 0.1.5 → 0.2.2

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

@@ -25,6 +25,7 @@ var jwt__namespace = /*#__PURE__*/_interopNamespace(jwt);
 
 // src/internal/gateway-endpoints.ts
 var SALES_ENDPOINT = "sales";
+var V2_EXTENDABLE_SLUG = "peek_backoffice_api-v1";
 
 // src/internal/account-users/account-user-converter.ts
 var ACTIVE_STATUS = "ACTIVE";
@@ -1841,14 +1842,19 @@ var GraphQLClient = class {
     throw new RateLimitError();
   }
   endpoint(endpointName) {
-    return `${this.options.baseUrl}/${this.options.appId}/${endpointName}`;
+    const { baseUrl, appId, endpointPathPrefix } = this.options;
+    const prefix = endpointPathPrefix ? `${endpointPathPrefix}/` : "";
+    return `${baseUrl}/${appId}/${prefix}${endpointName}`;
   }
   buildHeaders() {
-    return {
+    const headers = {
       "X-Peek-Auth": `Bearer ${this.options.getToken()}`,
-      "pk-api-key": this.options.gatewayKey,
       "Content-Type": "application/json"
     };
+    if (this.options.gatewayKey) {
+      headers["pk-api-key"] = this.options.gatewayKey;
+    }
+    return headers;
   }
 };
 
@@ -2908,6 +2914,7 @@ var noopLogger = {
 
 // src/peek-access-service.ts
 var DEFAULT_BASE_URL = "https://apps.peekapis.com/backoffice-gql";
+var DEFAULT_V2_BASE_URL = "https://app-registry.peeklabs.com/installations-api";
 var DEFAULT_TOKEN_TTL_SECONDS = 3600;
 var DEFAULT_TOKEN_REFRESH_LEEWAY_SECONDS = 60;
 var DEFAULT_RETRY_DELAYS_MS = [1e3, 2e3, 4e3];
@@ -2926,11 +2933,12 @@ var PeekAccessService = class {
   bookingService;
   reviewService;
   constructor(config) {
+    const isV2 = config.mode === "v2";
     requireNonEmpty(config.installId, "installId");
     requireNonEmpty(config.jwtSecret, "jwtSecret");
     requireNonEmpty(config.issuer, "issuer");
     requireNonEmpty(config.appId, "appId");
-    requireNonEmpty(config.gatewayKey, "gatewayKey");
+    if (!isV2) requireNonEmpty(config.gatewayKey ?? "", "gatewayKey");
     const logger = config.logger ?? noopLogger;
     const tokens = new TokenManager({
       secret: config.jwtSecret,
@@ -2939,14 +2947,16 @@ var PeekAccessService = class {
       ttlSeconds: config.tokenTtlSeconds ?? DEFAULT_TOKEN_TTL_SECONDS,
       leewaySeconds: config.tokenRefreshLeewaySeconds ?? DEFAULT_TOKEN_REFRESH_LEEWAY_SECONDS
     });
+    const defaultBaseUrl = isV2 ? DEFAULT_V2_BASE_URL : DEFAULT_BASE_URL;
     this.client = new GraphQLClient({
-      baseUrl: config.baseUrl ?? DEFAULT_BASE_URL,
+      baseUrl: config.baseUrl ?? defaultBaseUrl,
       appId: config.appId,
       gatewayKey: config.gatewayKey,
       getToken: () => tokens.getToken(),
       retryDelaysMs: config.retryDelaysMs ?? DEFAULT_RETRY_DELAYS_MS,
       logger,
-      fetchFn: config.fetch ?? globalThis.fetch
+      fetchFn: config.fetch ?? globalThis.fetch,
+      endpointPathPrefix: isV2 ? V2_EXTENDABLE_SLUG : void 0
     });
     this.productServiceOptions = {
       itemOptionsPageSize: config.itemOptionsPageSize
@@ -3078,6 +3088,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 +3190,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