@peektravel/app-utilities 0.9.2 → 0.9.4

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,34 @@ 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 plus a display-safe `displayValue` string on the `MetaData` itself (the
+  `html` value's is HTML-escaped); returns only fields whose slug starts with
+  `integrators:<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:

package/package.json

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