@peektravel/app-utilities 0.9.1 → 0.9.3

package/dist/index.cjs

@@ -338,6 +338,20 @@ var SEARCH_BY_ACTIVITY_DATE = "activityDate";
 function normalizeBookingId(bookingId) {
   return bookingId.toLowerCase().replace(/-/g, "_");
 }
+function buildSalesQuery(nodeBody) {
+  return `
+    query Sales($after: String, $first: Int, $filter: SalesFilter!, $orderBy: SalesOrdering) {
+      sales(after: $after, first: $first, filter: $filter, orderBy: $orderBy) {
+        pageInfo { endCursor hasNextPage }
+        edges {
+          node {
+            ${nodeBody}
+          }
+        }
+      }
+    }
+  `;
+}
 var GUEST_IDENTITY_PII_FIELDS = "name country dateOfBirth email isGdpr";
 var GUEST_CONTACT_PII_FIELDS = `phone
   postalCode
@@ -431,6 +445,7 @@ function buildBookingQueryFields(fullCustomerAccess) {
   availabilityTimeId
   ${fullCustomerAccess ? "bookingPortalUrl" : ""}
   operatorNotes
+  operatorStatus
   value {
     total {
       formatted
@@ -513,67 +528,40 @@ function buildBookingsListingQuery(includeGuests, includePriceBreakdown, fullCus
   const guestsSection = includeGuests ? buildBookingGuestsFields(fullCustomerAccess) : "";
   const baseFields = buildBookingQueryFields(fullCustomerAccess);
   const fields = includePriceBreakdown ? baseFields.replace("value {", `value { ${PRICE_BREAKDOWN_FIELDS}`).replace("ticketQuantities {", `ticketQuantities { ${TICKET_VALUE_FIELDS}`) : baseFields;
-  return `
-    query Sales($after: String, $first: Int, $filter: SalesFilter!, $orderBy: SalesOrdering) {
-      sales(after: $after, first: $first, filter: $filter, orderBy: $orderBy) {
-        pageInfo { endCursor hasNextPage }
-        edges {
-          node {
-            ... on Booking {
-              ${fields}
-              ${guestsSection}
-            }
-          }
-        }
-      }
+  return buildSalesQuery(`
+    ... on Booking {
+      ${fields}
+      ${guestsSection}
     }
-  `;
+  `);
 }
 function buildBookingGuestsQuery(fullCustomerAccess) {
-  return `
-  query Sales($after: String, $first: Int, $filter: SalesFilter!, $orderBy: SalesOrdering) {
-    sales(after: $after, first: $first, filter: $filter, orderBy: $orderBy) {
-      pageInfo { endCursor hasNextPage }
-      edges {
-        node {
-          ... on Booking {
-            displayId
-            id
-            ${buildBookingGuestsFields(fullCustomerAccess)}
-          }
-        }
-      }
+  return buildSalesQuery(`
+    ... on Booking {
+      displayId
+      id
+      ${buildBookingGuestsFields(fullCustomerAccess)}
     }
-  }
-`;
+  `);
 }
-var BOOKING_PAYMENTS_ON_FILE_QUERY = `
-  query Sales($after: String, $first: Int, $filter: SalesFilter!, $orderBy: SalesOrdering) {
-    sales(after: $after, first: $first, filter: $filter, orderBy: $orderBy) {
-      pageInfo { endCursor hasNextPage }
-      edges {
-        node {
-          order {
-            payments {
-              id
-              paymentSource { id }
-              appliedAt
-              currentAmount { amount currency }
-              refundableAmount { amount currency }
-            }
-            id
-            displayId
-            paymentSources { description type id }
-          }
-          ... on Booking {
-            displayId
-            id
-          }
-        }
-      }
+var BOOKING_PAYMENTS_ON_FILE_QUERY = buildSalesQuery(`
+  order {
+    payments {
+      id
+      paymentSource { id }
+      appliedAt
+      currentAmount { amount currency }
+      refundableAmount { amount currency }
     }
+    id
+    displayId
+    paymentSources { description type id }
   }
-`;
+  ... on Booking {
+    displayId
+    id
+  }
+`);
 var UPDATE_OPERATOR_NOTES_MUTATION = `
   mutation Account($input: UpdateOperatorNotesForBookingInput!) {
     updateOperatorNotesForBooking(input: $input) {
@@ -581,6 +569,13 @@ var UPDATE_OPERATOR_NOTES_MUTATION = `
     }
   }
 `;
+var UPDATE_OPERATOR_STATUS_MUTATION = `
+  mutation Account($input: UpdateOperatorStatusForBookingInput!) {
+    updateOperatorStatusForBooking(input: $input) {
+      booking { operatorStatus }
+    }
+  }
+`;
 var UPDATE_BOOKING_CHECKIN_MUTATION = `
   mutation Account($input: UpdateBookingCheckInInput!) {
     updateBookingCheckIn(input: $input) {
@@ -803,6 +798,7 @@ function fromBookingNode(node, includeGuests = false, includePriceBreakdown = fa
     availabilityTimeId: data.availabilityTimeId || null,
     portalUrl: data.bookingPortalUrl || null,
     notes: data.operatorNotes || "",
+    customStatus: data.operatorStatus || null,
     valueDisplay: data.value?.total?.formatted || "",
     valueAmount: data.value?.total?.amount || "",
     outstandingBalanceAmount: data.balance?.total?.amount || "",
@@ -957,6 +953,251 @@ function fromBookingGuestsResponse(response) {
   return guests;
 }
 
+// src/internal/peek/bookings/metadata-converter.ts
+var UPSERT_SUCCESS_TYPENAME = "UpsertBookingFieldResponsesSuccess";
+function fromBookingMetaDataNode(node) {
+  return (node?.fieldResponses ?? []).map(fromFieldResponseNode);
+}
+function fromFieldResponseNode(response) {
+  const field = response.fieldLocation?.field;
+  const prompt = response.fieldLocation?.prompt;
+  return {
+    id: field?.id || "",
+    name: field?.name || "",
+    slug: field?.slug || "",
+    type: field?.type || "",
+    prompt: prompt?.label ?? null,
+    promptHint: prompt?.hint ?? null,
+    isRequired: Boolean(prompt?.isRequired),
+    refid: response.refid || "",
+    value: fromValueNode(response.value)
+  };
+}
+function fromValueNode(value) {
+  if (!value || !value.__typename) return null;
+  switch (value.__typename) {
+    case "AgeFieldResponseValue": {
+      const age = value.age ?? 0;
+      return { kind: "age", age, displayValue: String(age) };
+    }
+    case "AttachmentFieldResponseValue": {
+      const attachmentUrl = value.attachmentUrl ?? "";
+      const name = value.name ?? null;
+      return {
+        kind: "attachment",
+        attachmentUrl,
+        mime: value.mime ?? null,
+        name,
+        size: value.size ?? null,
+        displayValue: name || attachmentUrl
+      };
+    }
+    case "BarcodeFieldResponseValue": {
+      const barcodeValue = value.barcodeValue ?? "";
+      return {
+        kind: "barcode",
+        barcodeType: value.barcodeType ?? null,
+        barcodeValue,
+        displayValue: barcodeValue
+      };
+    }
+    case "BooleanFieldResponseValue": {
+      const bool = Boolean(value.boolean);
+      return { kind: "boolean", boolean: bool, displayValue: yesNo(bool) };
+    }
+    case "CheckboxFieldResponseValue": {
+      const isChecked = Boolean(value.isChecked);
+      return { kind: "checkbox", isChecked, displayValue: yesNo(isChecked) };
+    }
+    case "CurrencyFieldResponseValue": {
+      const currency = value.currency ?? "";
+      return { kind: "currency", currency, displayValue: currency };
+    }
+    case "DateFieldResponseValue": {
+      const date = value.date ?? "";
+      return { kind: "date", date, displayValue: date };
+    }
+    case "DecimalFieldResponseValue": {
+      const decimal = value.decimal ?? null;
+      return { kind: "decimal", decimal, displayValue: decimal ?? "" };
+    }
+    case "DurationFieldResponseValue": {
+      const amount = value.duration?.amount ?? 0;
+      const unit = value.duration?.unit ?? null;
+      return { kind: "duration", amount, unit, displayValue: amountUnit(amount, unit) };
+    }
+    case "EmailFieldResponseValue": {
+      const email = value.email ?? null;
+      return { kind: "email", email, displayValue: email ?? "" };
+    }
+    case "GuestFieldResponseValue": {
+      const name = value.name ?? null;
+      return {
+        kind: "guest",
+        name,
+        email: value.email ?? null,
+        dateOfBirth: value.dateOfBirth ?? null,
+        notes: value.notes ?? null,
+        waiverSigned: value.waiverSigned ?? null,
+        displayValue: name ?? ""
+      };
+    }
+    case "HtmlFieldResponseValue": {
+      const html = value.html ?? "";
+      return { kind: "html", html, displayValue: escapeHtml(html) };
+    }
+    case "ImageUrlFieldResponseValue": {
+      const imageUrl = value.imageUrl ?? "";
+      return { kind: "imageUrl", imageUrl, displayValue: imageUrl };
+    }
+    case "IntegerFieldResponseValue": {
+      const integer = value.integer ?? 0;
+      return { kind: "integer", integer, displayValue: String(integer) };
+    }
+    case "LocationFieldResponseValue": {
+      const streetAddress = value.streetAddress ?? null;
+      const locality = value.locality ?? null;
+      const region = value.region ?? null;
+      const postalCode = value.postalCode ?? null;
+      const country = value.country ?? null;
+      return {
+        kind: "location",
+        country,
+        county: value.county ?? null,
+        locality,
+        postalCode,
+        region,
+        streetAddress,
+        displayValue: [streetAddress, locality, region, postalCode, country].filter((part) => part).join(", ")
+      };
+    }
+    case "LongTextFieldResponseValue": {
+      const longText = value.longText ?? "";
+      return { kind: "longText", longText, displayValue: longText };
+    }
+    case "MetaFieldResponseValue": {
+      const meta = value.meta ?? null;
+      return { kind: "meta", meta, displayValue: meta == null ? "" : JSON.stringify(meta) };
+    }
+    case "PercentFieldResponseValue": {
+      const percent = value.percent ?? null;
+      return { kind: "percent", percent, displayValue: percent == null ? "" : `${percent}%` };
+    }
+    case "PhoneFieldResponseValue": {
+      const phone = value.phone ?? "";
+      return { kind: "phone", phone, displayValue: phone };
+    }
+    case "ShortTextFieldResponseValue": {
+      const shortText = value.shortText ?? "";
+      return { kind: "shortText", shortText, displayValue: shortText };
+    }
+    case "TimeFieldResponseValue": {
+      const time = value.time ?? "";
+      return { kind: "time", time, displayValue: time };
+    }
+    case "UrlFieldResponseValue": {
+      const url = value.url ?? null;
+      return { kind: "url", url, displayValue: url ?? "" };
+    }
+    case "VolumeFieldResponseValue": {
+      const amount = value.volume?.amount ?? "0";
+      const unit = value.volume?.unit ?? null;
+      return { kind: "volume", amount, unit, displayValue: amountUnit(amount, unit) };
+    }
+    case "WeightFieldResponseValue": {
+      const amount = value.weight?.amount ?? "0";
+      const unit = value.weight?.unit ?? null;
+      return { kind: "weight", amount, unit, displayValue: amountUnit(amount, unit) };
+    }
+    default:
+      return null;
+  }
+}
+function yesNo(value) {
+  return value ? "Yes" : "No";
+}
+function amountUnit(amount, unit) {
+  return unit ? `${amount} ${unit.toLowerCase()}` : String(amount);
+}
+function escapeHtml(value) {
+  return value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#39;");
+}
+function toSetMetaDataResult(node, bookingId) {
+  return {
+    success: node?.__typename === UPSERT_SUCCESS_TYPENAME,
+    bookingId: node?.bookingId || bookingId,
+    message: node?.message || ""
+  };
+}
+function filterMetaDataByIntegrator(metaData, integrator) {
+  const prefix = `integrator:${integrator}:`;
+  return metaData.filter((entry) => entry.slug.startsWith(prefix)).map((entry) => ({ ...entry, slug: entry.slug.slice(prefix.length) }));
+}
+
+// src/internal/peek/bookings/metadata-queries.ts
+var GUEST_VALUE_PII_FIELDS = "dateOfBirth\n      email\n      name\n      ";
+function buildGuestValueFields(fullCustomerAccess) {
+  return `... on GuestFieldResponseValue {
+      ${fullCustomerAccess ? GUEST_VALUE_PII_FIELDS : ""}notes
+      waiverSigned
+    }`;
+}
+function buildMetaDataValueSelection(fullCustomerAccess) {
+  return `value {
+    __typename
+    ... on AgeFieldResponseValue { age }
+    ... on AttachmentFieldResponseValue { attachmentUrl mime name size }
+    ... on BarcodeFieldResponseValue { barcodeType barcodeValue }
+    ... on BooleanFieldResponseValue { boolean }
+    ... on CheckboxFieldResponseValue { isChecked }
+    ... on CurrencyFieldResponseValue { currency }
+    ... on DateFieldResponseValue { date }
+    ... on DecimalFieldResponseValue { decimal }
+    ... on DurationFieldResponseValue { duration { amount unit } }
+    ... on EmailFieldResponseValue { email }
+    ${buildGuestValueFields(fullCustomerAccess)}
+    ... on HtmlFieldResponseValue { html }
+    ... on ImageUrlFieldResponseValue { imageUrl }
+    ... on IntegerFieldResponseValue { integer }
+    ... on LocationFieldResponseValue { country county locality postalCode region streetAddress }
+    ... on LongTextFieldResponseValue { longText }
+    ... on MetaFieldResponseValue { meta }
+    ... on PercentFieldResponseValue { percent }
+    ... on PhoneFieldResponseValue { phone }
+    ... on ShortTextFieldResponseValue { shortText }
+    ... on TimeFieldResponseValue { time }
+    ... on UrlFieldResponseValue { url }
+    ... on VolumeFieldResponseValue { volume { amount unit } }
+    ... on WeightFieldResponseValue { weight { amount unit } }
+  }`;
+}
+function buildBookingMetaDataQuery(fullCustomerAccess) {
+  return buildSalesQuery(`
+    ... on Booking {
+      displayId
+      id
+      fieldResponses {
+        fieldLocation {
+          field { id name slug type }
+          prompt { label hint isRequired }
+        }
+        refid
+        ${buildMetaDataValueSelection(fullCustomerAccess)}
+      }
+    }
+  `);
+}
+var UPSERT_BOOKING_FIELD_RESPONSES_MUTATION = `
+  mutation UpsertBookingFieldResponses($input: UpsertBookingFieldResponsesInput!) {
+    upsertBookingFieldResponses(input: $input) {
+      __typename
+      ... on UpsertBookingFieldResponsesSuccess { bookingId message }
+      ... on BookingNotFoundError { message bookingId }
+      ... on GenericError { message }
+    }
+  }
+`;
+
 // src/internal/peek/bookings/payments-on-file-converter.ts
 function fromPaymentsOnFileResponse(response, bookingId) {
   const firstEdge = (response?.sales?.edges ?? [])[0];
@@ -1112,6 +1353,9 @@ var QUESTION_TYPE_SELECT_ONE = "SELECT_ONE";
 var QUESTION_TYPE_LOCATION = "LOCATION";
 var QUESTION_ID_REGEX = /^cq_[a-z0-9]+$/;
 var OPTION_ID_REGEX = /^cqao_[a-z0-9]+$/;
+function isCustomQuestionId(idOrText) {
+  return QUESTION_ID_REGEX.test(idOrText);
+}
 var CHECKBOX_TRUE = /* @__PURE__ */ new Set(["yes", "true"]);
 var CHECKBOX_VALID = /* @__PURE__ */ new Set(["yes", "no", "true", "false"]);
 var CHECKBOX_TEXT_TRUE = "Yes";
@@ -1129,10 +1373,13 @@ var errMissingRequired = (text, id) => `Custom question "${text}" (${id}) is req
 function normalize(value) {
   return value.toLowerCase().replace(/[^a-z0-9]/g, "");
 }
-function resolveQuestion(idOrText, questions) {
+function resolveQuestion(idOrText, questions, acceptAllIds) {
   if (QUESTION_ID_REGEX.test(idOrText)) {
     const byId = questions.find((question) => question.id === idOrText);
-    if (!byId) throw new Error(errUnknownQuestionId(idOrText));
+    if (!byId) {
+      if (acceptAllIds) return null;
+      throw new Error(errUnknownQuestionId(idOrText));
+    }
     return byId;
   }
   const target = normalize(idOrText);
@@ -1157,8 +1404,11 @@ function resolveOption(value, question) {
   if (matches.length > 1) throw new Error(errAmbiguousOption(value, question.id));
   return matches[0];
 }
-function resolveOne(answer, questions) {
-  const question = resolveQuestion(answer.questionIdOrText, questions);
+function resolveOne(answer, questions, acceptAllIds) {
+  const question = resolveQuestion(answer.questionIdOrText, questions, acceptAllIds);
+  if (!question) {
+    return { questionId: answer.questionIdOrText, questionAnswerText: answer.value };
+  }
   if (question.perGuest) {
     throw new Error(errPerGuestUnsupported(question.id));
   }
@@ -1191,7 +1441,8 @@ function resolveOne(answer, questions) {
   }
 }
 function resolveCustomQuestionAnswers(answers, questions, options) {
-  const resolved = answers.map((answer) => resolveOne(answer, questions));
+  const acceptAllIds = options?.acceptAllIds ?? false;
+  const resolved = answers.map((answer) => resolveOne(answer, questions, acceptAllIds));
   if (options?.requireRequired) {
     assertRequiredAnswered(resolved, questions);
   }
@@ -1206,10 +1457,41 @@ function assertRequiredAnswered(resolved, questions) {
   }
 }
 
+// src/internal/peek/bookings/list-price.ts
+var ERROR_LIST_PRICE_INVALID = "listPrice must be a positive number string, e.g. '100', '1,000', or '10.00'";
+function parseListPriceToCents(listPrice) {
+  if (typeof listPrice !== "string") {
+    throw new Error(ERROR_LIST_PRICE_INVALID);
+  }
+  const cleaned = listPrice.replace(/,/g, "").trim();
+  if (!/^\d+(\.\d+)?$/.test(cleaned)) {
+    throw new Error(ERROR_LIST_PRICE_INVALID);
+  }
+  const cents = Math.round(Number(cleaned) * 100);
+  if (!Number.isFinite(cents) || cents <= 0) {
+    throw new Error(ERROR_LIST_PRICE_INVALID);
+  }
+  return cents;
+}
+function centsToAmount(cents) {
+  return (cents / 100).toFixed(2);
+}
+function distributeListPrice(listPrice, ticketCount) {
+  const totalCents = parseListPriceToCents(listPrice);
+  const perTicketCents = Math.floor(totalCents / ticketCount);
+  const amounts = [];
+  for (let i = 0; i < ticketCount - 1; i += 1) {
+    amounts.push(centsToAmount(perTicketCents));
+  }
+  amounts.push(centsToAmount(totalCents - perTicketCents * (ticketCount - 1)));
+  return amounts;
+}
+
 // src/internal/peek/bookings/booking-service.ts
 var DEFAULT_PAGE_SIZE2 = 50;
 var DEFAULT_CANCEL_NOTE = "Canceled";
 var DEFAULT_CUSTOMER_MESSAGE = "Charge initiated via API";
+var DEFAULT_CURRENCY = "USD";
 var BOOKING_DB_ID_REGEX = /^b_[a-z0-9]+$/;
 var BOOKING_DISPLAY_ID_REGEX = /^B-[A-Z0-9]+$/;
 var ORDER_DB_ID_REGEX = /^o_[a-z0-9]+$/;
@@ -1222,6 +1504,17 @@ var ERROR_ADDON_OPTION_ID_REQUIRED = "addonOptionId is required";
 var ERROR_QUANTITY_INVALID = "quantity must be a positive integer string";
 var ERROR_INVALID_BOOKING_ID = "bookingId is required and must be a valid booking id, e.g. 'b_abc123' or 'B-ABC123'";
 var ERROR_INVALID_ORDER_ID = "orderId is required and must be a valid order id, e.g. 'o_abc123' or 'O-ABC123'";
+var ERROR_CUSTOM_STATUS_REQUIRED = "customStatus is required and must be a non-empty string";
+var ERROR_GUESTS_REQUIRED = "at least one guest is required";
+var ERROR_ATTACHMENTS_REQUIRED = "at least one attachment is required";
+var META_FIELD_GUEST = "guest";
+var META_FIELD_ATTACHMENT = "attachment";
+var META_FIELD_MANIFEST_URL = "manifest_url";
+var META_FIELD_RESERVATION_ID = "reservation_id";
+var META_FIELD_BOOKING_STATUS = "booking_status";
+var META_FIELD_ASSIGNED_PRODUCT = "assigned_product";
+var META_FIELD_ASSIGNED_EMPLOYEE = "assigned_employee";
+var META_FIELD_INSURANCE_PURCHASED = "insurance_purchased";
 var ERROR_BOOKING_NOT_FOUND = "Booking not found";
 var ERROR_MULTIPLE_BOOKINGS_FOUND = "Expected exactly one booking for the provided bookingId";
 var ERROR_NO_ADDON_OPTION_TO_REMOVE = "No confirmed add-on option matching addonOptionId was found on the booking";
@@ -1234,12 +1527,15 @@ var BookingService = class {
     this.deps = deps;
     this.pageSize = options.pageSize ?? DEFAULT_PAGE_SIZE2;
     this.fullCustomerAccess = resolveAccessOptions(options.accessOptions).fullCustomerAccess;
+    this.integrator = options.integrator ?? "";
   }
   client;
   deps;
   pageSize;
   /** Whether customer PII is requested and payment operations are allowed. */
   fullCustomerAccess;
+  /** Integrator id scoping `getMetaData` results. */
+  integrator;
   /**
    * Throws a {@link PiiAccessDisabledError} for `operation` when this service was
    * created without `fullCustomerAccess` — used to gate payment and booking-modification
@@ -1327,6 +1623,131 @@ var BookingService = class {
     );
     return fromBookingGuestsResponse(body.data);
   }
+  /**
+   * Returns a booking's custom-field metadata (its `fieldResponses`), scoped to
+   * this service's integrator. Only fields whose slug starts with
+   * `integrator:<integrator>:` are returned, and that prefix is stripped from
+   * each returned `slug`. Returns `[]` when the booking is not found or has no
+   * matching fields.
+   *
+   * @example
+   * ```ts
+   * const meta = await peek.getBookingService().getMetaData("b_abc123");
+   * for (const field of meta) {
+   *   if (field.value?.kind === "url") console.log(field.slug, field.value.url);
+   * }
+   * ```
+   */
+  async getMetaData(bookingId) {
+    assertBookingId(bookingId);
+    const body = await this.client.request(
+      SALES_ENDPOINT,
+      buildBookingMetaDataQuery(this.fullCustomerAccess),
+      buildBookingsVariables({
+        pageSize: this.pageSize,
+        after: null,
+        bookingId: normalizeBookingId(bookingId)
+      })
+    );
+    const firstEdge = (body.data?.sales?.edges ?? [])[0];
+    if (!firstEdge) {
+      return [];
+    }
+    return filterMetaDataByIntegrator(fromBookingMetaDataNode(firstEdge.node), this.integrator);
+  }
+  /**
+   * Sets the booking's `guest` metadata field. Each guest requires a `name` and
+   * `email`; `dateOfBirth`/`waiverSigned`/`notes` are optional.
+   */
+  async setMetaDataGuest(bookingId, guests) {
+    if (!Array.isArray(guests) || guests.length === 0) {
+      throw new Error(ERROR_GUESTS_REQUIRED);
+    }
+    const built = guests.map((guest) => {
+      assertNonEmptyString(guest?.name, "guest name");
+      assertNonEmptyString(guest?.email, "guest email");
+      const out = { name: guest.name, email: guest.email };
+      if (guest.dateOfBirth !== void 0) out.dateOfBirth = guest.dateOfBirth;
+      if (guest.waiverSigned !== void 0) out.waiverSigned = guest.waiverSigned;
+      if (guest.notes !== void 0) out.notes = guest.notes;
+      return out;
+    });
+    return this.upsertFieldResponse(bookingId, { fieldName: META_FIELD_GUEST, guests: built });
+  }
+  /**
+   * Sets the booking's `attachment` metadata field. Each attachment requires a
+   * `name` and `attachmentUrl`.
+   */
+  async setMetaDataAttachment(bookingId, attachments) {
+    if (!Array.isArray(attachments) || attachments.length === 0) {
+      throw new Error(ERROR_ATTACHMENTS_REQUIRED);
+    }
+    const built = attachments.map((attachment) => {
+      assertNonEmptyString(attachment?.name, "attachment name");
+      assertNonEmptyString(attachment?.attachmentUrl, "attachment attachmentUrl");
+      return { name: attachment.name, attachmentUrl: attachment.attachmentUrl };
+    });
+    return this.upsertFieldResponse(bookingId, {
+      fieldName: META_FIELD_ATTACHMENT,
+      attachments: built
+    });
+  }
+  /** Sets the booking's `manifest_url` metadata field. */
+  async setMetaDataManifestUrl(bookingId, url) {
+    assertNonEmptyString(url, "url");
+    return this.upsertFieldResponse(bookingId, { fieldName: META_FIELD_MANIFEST_URL, url });
+  }
+  /** Sets the booking's `reservation_id` metadata field. */
+  async setMetaDataReservationId(bookingId, reservationId) {
+    return this.setShortTextField(bookingId, META_FIELD_RESERVATION_ID, reservationId, "reservationId");
+  }
+  /** Sets the booking's `booking_status` metadata field. */
+  async setMetaDataBookingStatus(bookingId, status) {
+    return this.setShortTextField(bookingId, META_FIELD_BOOKING_STATUS, status, "status");
+  }
+  /** Sets the booking's `assigned_product` metadata field. */
+  async setMetaDataAssignedProduct(bookingId, productName) {
+    return this.setShortTextField(bookingId, META_FIELD_ASSIGNED_PRODUCT, productName, "productName");
+  }
+  /** Sets the booking's `assigned_employee` metadata field. */
+  async setMetaDataAssignedEmployee(bookingId, employeeName) {
+    return this.setShortTextField(bookingId, META_FIELD_ASSIGNED_EMPLOYEE, employeeName, "employeeName");
+  }
+  /** Sets the booking's `insurance_purchased` metadata field. */
+  async setMetaDataInsurancePurchased(bookingId, insurancePurchased) {
+    if (typeof insurancePurchased !== "boolean") {
+      throw new Error("insurancePurchased is required and must be a boolean");
+    }
+    return this.upsertFieldResponse(bookingId, {
+      fieldName: META_FIELD_INSURANCE_PURCHASED,
+      boolean: insurancePurchased
+    });
+  }
+  /** Validates a non-empty `shortText` value and upserts it under `fieldName`. */
+  setShortTextField(bookingId, fieldName, value, argName) {
+    assertNonEmptyString(value, argName);
+    return this.upsertFieldResponse(bookingId, { fieldName, shortText: value });
+  }
+  /**
+   * Validates the booking id and upserts a single field response (scoped to this
+   * service's integrator), mapping the result union into a {@link SetMetaDataResult}.
+   */
+  async upsertFieldResponse(bookingId, fieldResponse) {
+    assertBookingId(bookingId);
+    const normalized = normalizeBookingId(bookingId);
+    const body = await this.client.request(
+      SALES_ENDPOINT,
+      UPSERT_BOOKING_FIELD_RESPONSES_MUTATION,
+      {
+        input: {
+          bookingId: normalized,
+          integrator: this.integrator,
+          fieldResponses: [fieldResponse]
+        }
+      }
+    );
+    return toSetMetaDataResult(body.data?.upsertBookingFieldResponses, normalized);
+  }
   /** Returns the payments on file for a booking, or null when not found. */
   async getPaymentsOnFile(bookingId) {
     this.assertPiiEnabled("getPaymentsOnFile");
@@ -1371,6 +1792,30 @@ ${note}`;
     });
     return this.getById(normalized);
   }
+  /**
+   * Sets a booking's operator-facing custom status. Returns `true` when the
+   * gateway confirms the stored `operatorStatus` equals the requested
+   * `customStatus`, `false` otherwise.
+   *
+   * @example
+   * ```ts
+   * const ok = await peek.getBookingService().updateCustomStatus("b_abc123", "Awaiting deposit");
+   * ```
+   *
+   * @throws {Error} when `bookingId` is not a valid booking id (`b_…`/`B-…`) or
+   * when `customStatus` is not a non-empty string.
+   */
+  async updateCustomStatus(bookingId, customStatus) {
+    assertBookingId(bookingId);
+    assertCustomStatus(customStatus);
+    const normalized = normalizeBookingId(bookingId);
+    const body = await this.client.request(
+      SALES_ENDPOINT,
+      UPDATE_OPERATOR_STATUS_MUTATION,
+      { input: { id: normalized, operatorStatus: customStatus } }
+    );
+    return body.data?.updateOperatorStatusForBooking?.booking?.operatorStatus === customStatus;
+  }
   /** Cancels a booking and returns its id/displayId/status. */
   async cancel(bookingId, notes = DEFAULT_CANCEL_NOTE) {
     assertBookingId(bookingId);
@@ -1726,13 +2171,26 @@ ${note}`;
    */
   async create(input) {
     validateCreateInput(input);
-    const questionAnswers = await this.buildQuestionAnswers(input);
+    const ticketCount = input.tickets.reduce((count, ticket) => count + ticket.quantity, 0);
+    const listPriceAmounts = input.listPrice === void 0 ? null : distributeListPrice(input.listPrice, ticketCount);
+    const [questionAnswers, currency] = await Promise.all([
+      this.buildQuestionAnswers(input),
+      listPriceAmounts ? this.resolveActivityCurrency(input.activityId) : Promise.resolve("")
+    ]);
+    let seatIndex = 0;
     const tickets = input.tickets.flatMap(
-      (ticket) => Array.from({ length: ticket.quantity }, () => ({
-        resourceOptionId: ticket.resourceOptionId,
-        reservationStatus: "CONFIRMED",
-        refid: crypto.randomUUID()
-      }))
+      (ticket) => Array.from({ length: ticket.quantity }, () => {
+        const seat = {
+          resourceOptionId: ticket.resourceOptionId,
+          reservationStatus: "CONFIRMED",
+          refid: crypto.randomUUID()
+        };
+        if (listPriceAmounts) {
+          seat.price = { amount: listPriceAmounts[seatIndex], currency };
+        }
+        seatIndex += 1;
+        return seat;
+      })
     );
     const bookingQuote = {
       tickets,
@@ -1799,19 +2257,22 @@ ${note}`;
    * Resolves the input's custom-question answers into the quote's
    * `questionAnswers` payload (each tagged with a fresh `refid`), or `null` when
    * none were supplied. Fetches the activity's custom questions to validate
-   * against; throws on the first unmatched/ambiguous/invalid answer.
+   * against; throws on the first unmatched/ambiguous/invalid answer. When
+   * `acceptAllCustomQuestionIds` is set the fetch is skipped if every answer is
+   * given by id (a by-name answer still needs the list to resolve).
    */
   async buildQuestionAnswers(input) {
     const answers = input.customQuestionAnswers ?? [];
     const requireRequired = input.requireRequiredQuestions ?? false;
+    const acceptAllIds = input.acceptAllCustomQuestionIds ?? false;
     if (answers.length === 0 && !requireRequired) {
       return null;
     }
-    const questions = await this.deps.productService.getCustomQuestions(
-      input.activityId
-    );
+    const needsQuestions = !acceptAllIds || requireRequired || answers.some((answer) => !isCustomQuestionId(answer.questionIdOrText));
+    const questions = needsQuestions ? await this.deps.productService.getCustomQuestions(input.activityId) : [];
     const resolved = resolveCustomQuestionAnswers(answers, questions, {
-      requireRequired
+      requireRequired,
+      acceptAllIds
     });
     if (resolved.length === 0) {
       return null;
@@ -1844,6 +2305,15 @@ ${note}`;
     }
     return result.transactionId;
   }
+  /**
+   * Resolves an activity's ISO currency via the product service, falling back to
+   * {@link DEFAULT_CURRENCY} when the activity (or its currency) can't be found.
+   */
+  async resolveActivityCurrency(activityId) {
+    const products = await this.deps.productService.getAllProducts();
+    const match = products.find((product) => product.productId === activityId);
+    return match?.currency || DEFAULT_CURRENCY;
+  }
   /** Finds the parent item id of an add-on by matching its option id. */
   async resolveParentItemId(addonOptionId) {
     const products = await this.deps.productService.getAllProducts();
@@ -1918,6 +2388,16 @@ function assertBookingId(bookingId) {
     throw new Error(ERROR_INVALID_BOOKING_ID);
   }
 }
+function assertCustomStatus(customStatus) {
+  if (typeof customStatus !== "string" || customStatus.trim().length === 0) {
+    throw new Error(ERROR_CUSTOM_STATUS_REQUIRED);
+  }
+}
+function assertNonEmptyString(value, field) {
+  if (typeof value !== "string" || value.trim().length === 0) {
+    throw new Error(`${field} is required and must be a non-empty string`);
+  }
+}
 function assertOrderId(orderId) {
   if (!(ORDER_DB_ID_REGEX.test(orderId) || ORDER_DISPLAY_ID_REGEX.test(orderId))) {
     throw new Error(ERROR_INVALID_ORDER_ID);
@@ -2184,7 +2664,7 @@ async function requestWithRetry(http, url, init, label, onResponse) {
 // src/internal/sdk-headers.ts
 var SDK_HEADER_NAME = "x-peek-sdk";
 var SDK_PLATFORM = "js";
-var SDK_VERSION = "0.9.1";
+var SDK_VERSION = "0.9.3";
 var SDK_HEADER_VALUE = `${SDK_PLATFORM}-${SDK_VERSION}`;
 
 // src/internal/peek/graphql-client.ts
@@ -2609,6 +3089,23 @@ function fromReviewNode(node) {
     comment: node.comment ?? null
   };
 }
+function fromActivityReviewSummaryNode(node) {
+  const meta = node.reviewMeta;
+  return {
+    productId: node.id,
+    productName: node.name,
+    avgRating: meta?.avgRating ?? null,
+    countTotal: meta?.count ?? 0,
+    countOneStar: meta?.oneStar ?? 0,
+    countTwoStar: meta?.twoStar ?? 0,
+    countThreeStar: meta?.threeStar ?? 0,
+    countFourStar: meta?.fourStar ?? 0,
+    countFiveStar: meta?.fiveStar ?? 0
+  };
+}
+function fromActivityReviewSummaryNodes(nodes) {
+  return nodes.map(fromActivityReviewSummaryNode);
+}
 
 // src/internal/peek/reviews/review-cursor.ts
 function encodeCursor(offset, pageSize) {
@@ -2644,6 +3141,23 @@ function buildReviewsQuery(fullCustomerAccess) {
   }
 `;
 }
+var REVIEW_SUMMARIES_QUERY = `
+  query ReviewSummaries {
+    activities {
+      id
+      name
+      reviewMeta {
+        avgRating
+        count
+        fiveStar
+        fourStar
+        threeStar
+        twoStar
+        oneStar
+      }
+    }
+  }
+`;
 function buildReviewsVariables(params) {
   return {
     first: params.first,
@@ -2703,6 +3217,29 @@ var ReviewService = class {
     const edges = body.data?.reviews?.edges ?? [];
     return edges.map((edge) => fromReviewNode(edge.node));
   }
+  /**
+   * Returns an aggregate review summary for **every** activity — its average
+   * rating and the count of reviews at each star level. This reads the same
+   * activity list as `getAllProducts`; it carries no per-review detail or PII, so
+   * it is unaffected by `fullCustomerAccess`. An activity with no reviews comes
+   * back with a `null` `avgRating` and zero counts.
+   *
+   * @example
+   * ```ts
+   * const summaries = await peek.getReviewService().getAllReviewSummaries();
+   * for (const s of summaries) {
+   *   console.log(s.productName, s.avgRating, s.countTotal);
+   * }
+   * ```
+   */
+  async getAllReviewSummaries() {
+    const body = await this.client.request(
+      SALES_ENDPOINT,
+      REVIEW_SUMMARIES_QUERY,
+      {}
+    );
+    return fromActivityReviewSummaryNodes(body.data?.activities ?? []);
+  }
   validate(productId, reviewCount, reviewOffset) {
     if (!productId) {
       throw new Error(ERROR_PRODUCT_ID_REQUIRED);
@@ -3413,7 +3950,7 @@ var CREATE_PROMO_CODE_MUTATION = `
 
 // src/internal/peek/promo-codes/promo-code-service.ts
 var DEFAULT_PAGE_SIZE3 = 50;
-var DEFAULT_CURRENCY = "USD";
+var DEFAULT_CURRENCY2 = "USD";
 var CURRENCY_PATTERN = /^[A-Z]{3}$/;
 var PromoCodeService = class {
   constructor(client, options = {}) {
@@ -3459,7 +3996,7 @@ var PromoCodeService = class {
     if (Number.isNaN(parseFloat(input.amount))) {
       throw new Error("amount must be a valid number");
     }
-    const currency = input.currency || DEFAULT_CURRENCY;
+    const currency = input.currency || DEFAULT_CURRENCY2;
     if (!CURRENCY_PATTERN.test(currency)) {
       throw new Error("currency must be 3 uppercase letters");
     }
@@ -3833,6 +4370,7 @@ var PeekAccessService = class {
   productServiceOptions;
   accessOptions;
   jwtSecret;
+  issuer;
   productService;
   accountUserService;
   resourcePoolService;
@@ -3843,7 +4381,7 @@ var PeekAccessService = class {
   dailyNoteService;
   availabilityService;
   membershipService;
-  bookingService;
+  bookingServices = /* @__PURE__ */ new Map();
   reviewService;
   constructor(config) {
     const hasApiUrl = !!config.apiUrl;
@@ -3854,6 +4392,7 @@ var PeekAccessService = class {
     if (!hasApiUrl) requireNonEmpty(config.appId ?? "", "appId", "PeekAccessService");
     if (!hasApiUrl && !isV2) requireNonEmpty(config.gatewayKey ?? "", "gatewayKey", "PeekAccessService");
     this.jwtSecret = config.jwtSecret;
+    this.issuer = config.issuer;
     const logger = config.logger ?? noopLogger;
     const tokens = createTokenManager(config);
     const useRegistrySlug = hasApiUrl || isV2;
@@ -4014,17 +4553,25 @@ var PeekAccessService = class {
   }
   /**
    * Returns the {@link BookingService} for this install, bound to the shared
-   * authenticated transport. The instance is created lazily and reused.
+   * authenticated transport. Instances are created lazily and reused per
+   * `integrator`.
+   *
+   * `integrator` scopes `getMetaData` results to a custom integrator id. **Do
+   * not set it** unless Peek engineering created a custom integrator id for this
+   * integration — omit it and the correct default is used.
    */
-  getBookingService() {
-    if (!this.bookingService) {
-      this.bookingService = new BookingService(
+  getBookingService(integrator) {
+    const resolved = integrator ?? this.issuer;
+    let service = this.bookingServices.get(resolved);
+    if (!service) {
+      service = new BookingService(
         this.client,
         { productService: this.getProductService() },
-        { accessOptions: this.accessOptions }
+        { accessOptions: this.accessOptions, integrator: resolved }
       );
+      this.bookingServices.set(resolved, service);
     }
-    return this.bookingService;
+    return service;
   }
   /**
    * Returns the {@link ReviewService} for this install, bound to the shared