@peektravel/app-utilities 0.9.1 → 0.9.3

package/docs/webhooks.md

@@ -60,7 +60,7 @@ the full price breakdown, so one registration captures everything; the parser
 auto-detects whatever a given payload carries.
 
 ```
-{ displayId id primaryGuest { name email phone optinMarketing optinSms isGdpr postalCode } activitySnapshot { type name id } ticketQuantities { quantity resourceOptionSnapshot { name id } } reservationStatus checkinStatus returnStatus fulfillmentStatusOverride { status } timeSnapshot { id legacyId } purchasedAt purchasedAtUtc startsAt startsAtUtc endsAt endsAtUtc availabilityTimeId bookingPortalUrl operatorNotes value { convenienceFee { amount formatted } deposit { amount formatted } discount { amount formatted } discountedPrice { amount formatted } fees { amount formatted } flatPartnerFee { amount formatted } price { amount formatted } retailPrice { amount formatted } taxes { amount formatted } tips { amount formatted } total { formatted amount } } balance { total { amount formatted } } tips { price { amount formatted } } order { displayId id promoCodes { code } channelSnapshot { id name agent { name } } initialQuote { source { actor { app name } } } } questionAnswers { answer questionText questionLocationSnapshot { latitude longitude } } tickets { questionAnswers { answer questionText } } resourcePoolAssignments { quantity resourcePool { name shortName resources { name } } resourceAssignments { resource { id name } } } bookingGuests { id name country dateOfBirth email isGdpr isParticipant optinSms optinMarketing phone postalCode fieldResponses { id text fieldLocation { field { name } } } } primaryGuest { id name country dateOfBirth email isGdpr isParticipant optinSms optinMarketing phone postalCode fieldResponses { id text fieldLocation { field { name } } } } }
+{ displayId id primaryGuest { name email phone optinMarketing optinSms isGdpr postalCode } activitySnapshot { type name id } ticketQuantities { quantity resourceOptionSnapshot { name id } } reservationStatus checkinStatus returnStatus fulfillmentStatusOverride { status } timeSnapshot { id legacyId } purchasedAt purchasedAtUtc startsAt startsAtUtc endsAt endsAtUtc availabilityTimeId bookingPortalUrl operatorNotes operatorStatus value { convenienceFee { amount formatted } deposit { amount formatted } discount { amount formatted } discountedPrice { amount formatted } fees { amount formatted } flatPartnerFee { amount formatted } price { amount formatted } retailPrice { amount formatted } taxes { amount formatted } tips { amount formatted } total { formatted amount } } balance { total { amount formatted } } tips { price { amount formatted } } order { displayId id promoCodes { code } channelSnapshot { id name agent { name } } initialQuote { source { actor { app name } } } } questionAnswers { answer questionText questionLocationSnapshot { latitude longitude } } tickets { questionAnswers { answer questionText } } resourcePoolAssignments { quantity resourcePool { name shortName resources { name } } resourceAssignments { resource { id name } } } bookingGuests { id name country dateOfBirth email isGdpr isParticipant optinSms optinMarketing phone postalCode fieldResponses { id text fieldLocation { field { name } } } } primaryGuest { id name country dateOfBirth email isGdpr isParticipant optinSms optinMarketing phone postalCode fieldResponses { id text fieldLocation { field { name } } } } }
 ```
 
 > This package owns this string internally and snapshots it in

package/llms.txt

@@ -133,12 +133,39 @@ final authority and may still reject the request.
 - `getDailyNoteService()` — `getToday()`, `update(note)`
 - `getAvailabilityService()` — `getAvailabilityTimes({activityId, date, resourceOptionQuantities})`
 - `getMembershipService()` — `getAll()`, `purchase(input)`
-- `getBookingService()` — `getById(id, opts?)`, `searchByTimeRange(input)`,
-  `searchByTimeslot(id, opts?)`, `getGuests(id)`, `getPaymentsOnFile(id)`,
-  `appendNote(id, note, mode?)`, `setCheckinStatus(id, checkedIn)`, `cancel(id, notes?)`,
+- `getBookingService(integrator?)` — `getById(id, opts?)`, `searchByTimeRange(input)`,
+  `searchByTimeslot(id, opts?)`, `getGuests(id)`,
+  `getMetaData(id)` → `MetaData[]` (booking custom-field responses, `[]` when not
+  found; each `MetaData` carries a typed `value: MetaDataValue | null` discriminated
+  union — every variant also has a display-safe `displayValue` string (the
+  `html` variant's is HTML-escaped); returns only fields whose slug starts with
+  `integrator:<integrator>:`,
+  that prefix stripped). The `integrator` arg on the accessor scopes
+  `getMetaData` — **do not set it** unless Peek engineering created a custom
+  integrator id for this integration.
+  Eight metadata setters (fixed `fieldName`, caller supplies the value;
+  integrator-scoped; return `SetMetaDataResult {success, bookingId, message}`;
+  not PII-gated): `setMetaDataGuest(id, guests: SetMetaDataGuestInput[])`
+  (name+email required), `setMetaDataAttachment(id, attachments:
+  SetMetaDataAttachmentInput[])` (name+attachmentUrl required),
+  `setMetaDataManifestUrl(id, url)`, `setMetaDataReservationId(id, reservationId)`,
+  `setMetaDataBookingStatus(id, status)`, `setMetaDataAssignedProduct(id, productName)`,
+  `setMetaDataAssignedEmployee(id, employeeName)`,
+  `setMetaDataInsurancePurchased(id, insurancePurchased)`. `getPaymentsOnFile(id)`,
+  `appendNote(id, note, mode?)`, `setCheckinStatus(id, checkedIn)`,
+  `updateCustomStatus(id, customStatus)` → `boolean` (sets the operator custom
+  status; not PII-gated), `cancel(id, notes?)`,
   `makePayment(input)`, `refund(input)`, `createInvoiceLink(id)`,
   `listAddons(id)`, `addAddon(id, {addonOptionId, quantity})`,
-  `removeAddon(id, {addonOptionId, quantity})`, `create(input)`
+  `removeAddon(id, {addonOptionId, quantity})`, `create(input)` (optional
+  `input.listPrice` — total booking price string, commas allowed; split evenly
+  across tickets with the remainder cent on the last, sent per ticket in the
+  activity currency, fallback USD)
+- `getReviewService()` — `getReviews(productId, reviewCount?, reviewOffset?)`
+  (single newest-first page of `Review`s, count 1–50, offset ≥ 0);
+  `getAllReviewSummaries()` → `ProductReviewSummary[]` (one per activity:
+  `avgRating` — decimal, `null` when no ratings — plus `countTotal` and per-star
+  `countOneStar`…`countFiveStar`). No PII; unaffected by `fullCustomerAccess`.
 
 ## Sibling accessors (CNG, ACME — REST, not GraphQL)
 
@@ -190,6 +217,11 @@ stay internal.
   additionally enforces that every required (non-per-guest) custom question is
   answered — validation runs even when `customQuestionAnswers` is empty/omitted,
   and an unanswered required question fails creation before the quote.
+  `CreateBookingInput.acceptAllCustomQuestionIds?: boolean` (default `false`)
+  relaxes the id check: a `cq_…` id not in the activity's question list is
+  accepted as a plain text answer instead of failing creation (by-name answers
+  still must match). When every answer is by id (and no required check runs) the
+  questions fetch is skipped entirely.
 
 ## Errors
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@peektravel/app-utilities",
-  "version": "0.9.1",
+  "version": "0.9.3",
   "description": "GraphQL JS mapping utilities extracted from the Peek Pro Autopilot connector.",
   "license": "MIT",
   "repository": {