@peektravel/app-utilities 0.2.4 → 0.2.6

package/dist/index.js

@@ -266,7 +266,7 @@ function fromBookingNode(node, includeGuests = false, includePriceBreakdown = fa
     timeslotId: data.timeSnapshot?.legacyId || null,
     totalTickets: ticketQuantity(ticketQuantities),
     ticketDescription: formatTickets(ticketQuantities),
-    tickets: ticketsToTicketArray(ticketQuantities),
+    tickets: ticketsToTicketArray(ticketQuantities, includePriceBreakdown),
     isCanceled: data.reservationStatus === "CANCELED",
     isNoShow: data.fulfillmentStatusOverride?.status === "NO_SHOW",
     isCheckedIn: data.checkinStatus !== "NONE",
@@ -367,12 +367,14 @@ function resellerNameFromChannelSnapshot(channelSnapshot) {
   }
   return out;
 }
-function ticketsToTicketArray(ticketQuantities) {
+function ticketsToTicketArray(ticketQuantities, includePriceBreakdown) {
   if (!ticketQuantities || ticketQuantities.length === 0) return [];
   return ticketQuantities.map((ticket) => ({
     name: ticket.resourceOptionSnapshot?.name || "Unknown",
     quantity: ticket.quantity || 0,
-    ticketId: ticket.resourceOptionSnapshot?.id || "unknown"
+    ticketId: ticket.resourceOptionSnapshot?.id || "unknown",
+    listPrice: includePriceBreakdown ? mapPrice(ticket.value?.price) : void 0,
+    totalValue: includePriceBreakdown ? mapPrice(ticket.value?.total) : void 0
   }));
 }
 function durationInMin(startsAt, endsAt) {
@@ -737,9 +739,15 @@ var PRICE_BREAKDOWN_FIELDS = `
   taxes { amount formatted }
   tips { amount formatted }
 `;
+var TICKET_VALUE_FIELDS = `
+  value {
+    price { amount formatted }
+    total { amount formatted }
+  }
+`;
 function buildBookingsListingQuery(includeGuests, includePriceBreakdown) {
   const guestsSection = includeGuests ? bookingGuestsFields : "";
-  const fields = includePriceBreakdown ? bookingQueryFields.replace("value {", `value { ${PRICE_BREAKDOWN_FIELDS}`) : bookingQueryFields;
+  const fields = includePriceBreakdown ? bookingQueryFields.replace("value {", `value { ${PRICE_BREAKDOWN_FIELDS}`).replace("ticketQuantities {", `ticketQuantities { ${TICKET_VALUE_FIELDS}`) : bookingQueryFields;
   return `
     query Sales($after: String, $first: Int, $filter: SalesFilter!, $orderBy: SalesOrdering) {
       sales(after: $after, first: $first, filter: $filter, orderBy: $orderBy) {
@@ -934,14 +942,18 @@ function buildBookingsVariables(params) {
 var DEFAULT_PAGE_SIZE2 = 50;
 var DEFAULT_CANCEL_NOTE = "Canceled";
 var DEFAULT_CUSTOMER_MESSAGE = "Charge initiated via API";
-var BOOKING_ID_PREFIX = "b_";
+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]+$/;
+var ORDER_DISPLAY_ID_REGEX = /^O-[A-Z0-9]+$/;
 var PAYMENT_SOURCE_PREFIX = "ps_";
 var PAYMENT_ID_PREFIX = "pmt_";
 var ALLOWED_PAYMENT_SOURCE_IDS = ["cash/cash", "custom/other", "custom/voucher"];
 var CURRENCY_CODE_REGEX = /^[A-Z]{3}$/;
 var ERROR_ADDON_OPTION_ID_REQUIRED = "addonOptionId is required";
 var ERROR_QUANTITY_INVALID = "quantity must be a positive integer string";
-var ERROR_BOOKING_ID_REQUIRED = "bookingId is required";
+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_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";
@@ -973,6 +985,7 @@ var BookingService = class {
    * ```
    */
   async getById(bookingId, options = {}) {
+    assertBookingId(bookingId);
     const includeGuests = options.includeGuests ?? false;
     const includePriceBreakdown = options.includePriceBreakdown ?? false;
     const body = await this.client.request(
@@ -1021,6 +1034,7 @@ var BookingService = class {
   }
   /** Returns the guests on a booking (primary guest included). */
   async getGuests(bookingId) {
+    assertBookingId(bookingId);
     const body = await this.client.request(
       SALES_ENDPOINT,
       BOOKING_GUESTS_QUERY,
@@ -1034,6 +1048,7 @@ var BookingService = class {
   }
   /** Returns the payments on file for a booking, or null when not found. */
   async getPaymentsOnFile(bookingId) {
+    assertBookingId(bookingId);
     const normalized = normalizeBookingId(bookingId);
     const body = await this.client.request(
       SALES_ENDPOINT,
@@ -1047,6 +1062,7 @@ var BookingService = class {
    * booking, or null when the booking is not found.
    */
   async appendNote(bookingId, note, mode = "append") {
+    assertBookingId(bookingId);
     const normalized = normalizeBookingId(bookingId);
     const booking = await this.getById(normalized);
     if (!booking) {
@@ -1065,6 +1081,7 @@ ${note}`;
    * when not found.
    */
   async setCheckinStatus(bookingId, checkedIn) {
+    assertBookingId(bookingId);
     const normalized = normalizeBookingId(bookingId);
     const checkedInAt = checkedIn ? (/* @__PURE__ */ new Date()).toISOString() : null;
     await this.client.request(SALES_ENDPOINT, UPDATE_BOOKING_CHECKIN_MUTATION, {
@@ -1074,6 +1091,7 @@ ${note}`;
   }
   /** Cancels a booking and returns its id/displayId/status. */
   async cancel(bookingId, notes = DEFAULT_CANCEL_NOTE) {
+    assertBookingId(bookingId);
     const body = await this.client.request(
       SALES_ENDPOINT,
       CANCEL_BOOKING_MUTATION,
@@ -1109,12 +1127,13 @@ ${note}`;
    * @throws {Error} when `paymentSourceId` is missing or not a `ps_…` id / one
    * of `cash/cash`, `custom/other`, `custom/voucher`; when `amount` is not a
    * valid number; when `currency` is not a 3-letter uppercase code; when
-   * `idempotencyKey` is empty; when `bookingId` does not resolve to a `b_…` id;
-   * when the booking or payment source is not found; or when the charge fails.
+   * `idempotencyKey` is empty; when `bookingId` is not a valid booking id
+   * (`b_…`/`B-…`); when the booking or payment source is not found; or when the
+   * charge fails.
    */
   async makePayment(input) {
+    this.validatePaymentInput(input);
     const normalized = normalizeBookingId(input.bookingId);
-    this.validatePaymentInput(input, normalized);
     const onFile = await this.getPaymentsOnFile(normalized);
     if (!onFile) {
       throw new Error("Booking not found");
@@ -1155,8 +1174,8 @@ ${note}`;
    * payments-on-file, then applies the refund.
    */
   async refund(input) {
+    this.validateRefundInput(input);
     const normalized = normalizeBookingId(input.bookingId);
-    this.validateRefundInput(input, normalized);
     const onFile = await this.getPaymentsOnFile(normalized);
     if (!onFile) {
       throw new Error("Booking not found");
@@ -1195,9 +1214,7 @@ ${note}`;
   }
   /** Creates an invoice link for a booking's order. */
   async createInvoiceLink(bookingId) {
-    if (!bookingId || bookingId.trim().length === 0) {
-      throw new Error("bookingId is required");
-    }
+    assertBookingId(bookingId);
     const normalized = normalizeBookingId(bookingId);
     const booking = await this.getById(normalized);
     if (!booking || !booking.orderId) {
@@ -1217,6 +1234,7 @@ ${note}`;
   }
   /** Returns the add-ons on a booking, grouped by add-on item (clean model). */
   async listAddons(bookingId) {
+    assertBookingId(bookingId);
     const { items, displayId, orderId, normalizedBookingId } = await this.fetchBookingSale(bookingId);
     const addons = items.map((item) => toBookingAddon(item)).filter((addon) => addon !== null);
     return {
@@ -1251,6 +1269,7 @@ ${note}`;
    * the underlying quote/order mutations fail.
    */
   async addAddon(bookingId, input) {
+    assertBookingId(bookingId);
     const addonOptionId = (input?.addonOptionId || input?.addonId || "").trim();
     if (!addonOptionId) {
       throw new Error(ERROR_ADDON_OPTION_ID_REQUIRED);
@@ -1303,6 +1322,7 @@ ${note}`;
    * variables. Returns the booking's add-ons after the change.
    */
   async removeAddon(bookingId, input) {
+    assertBookingId(bookingId);
     const addonOptionId = (input?.addonOptionId || input?.addonId || "").trim();
     if (!addonOptionId) {
       throw new Error(ERROR_ADDON_OPTION_ID_REQUIRED);
@@ -1331,14 +1351,10 @@ ${note}`;
    * booking matched, and parses the node into the internal model.
    */
   async fetchBookingSale(bookingId) {
-    const searchString = (bookingId || "").trim();
-    if (!searchString) {
-      throw new Error(ERROR_BOOKING_ID_REQUIRED);
-    }
     const body = await this.client.request(
       SALES_ENDPOINT,
       SALES_ADDONS_QUERY,
-      buildSalesAddonsVariables(searchString)
+      buildSalesAddonsVariables(bookingId)
     );
     const edges = body.data?.sales?.edges ?? [];
     if (edges.length === 0) {
@@ -1521,7 +1537,7 @@ ${note}`;
     }
     return matched.productId;
   }
-  validatePaymentInput(input, normalizedBookingId) {
+  validatePaymentInput(input) {
     if (!input.paymentSourceId || !input.paymentSourceId.startsWith(PAYMENT_SOURCE_PREFIX) && !ALLOWED_PAYMENT_SOURCE_IDS.includes(input.paymentSourceId)) {
       throw new Error(
         "paymentSourceId is required and must start with 'ps_' or be one of 'cash/cash', 'custom/other', 'custom/voucher'"
@@ -1530,16 +1546,16 @@ ${note}`;
     assertAmount(input.amount);
     assertCurrency(input.currency);
     assertIdempotencyKey(input.idempotencyKey);
-    assertBookingId(normalizedBookingId);
+    assertBookingId(input.bookingId);
   }
-  validateRefundInput(input, normalizedBookingId) {
+  validateRefundInput(input) {
     if (!input.paymentId || !input.paymentId.startsWith(PAYMENT_ID_PREFIX)) {
       throw new Error("paymentId is required and must start with 'pmt_'");
     }
     assertAmount(input.amount);
     assertCurrency(input.currency);
     assertIdempotencyKey(input.idempotencyKey);
-    assertBookingId(normalizedBookingId);
+    assertBookingId(input.bookingId);
   }
   async fetchPaginated(query, baseParams, includeGuests, includePriceBreakdown) {
     const bookings = [];
@@ -1579,9 +1595,14 @@ function assertIdempotencyKey(idempotencyKey) {
     throw new Error("idempotencyKey is required");
   }
 }
-function assertBookingId(normalizedBookingId) {
-  if (!normalizedBookingId.startsWith(BOOKING_ID_PREFIX)) {
-    throw new Error("bookingId is required and must start with 'b_' or 'B-'");
+function assertBookingId(bookingId) {
+  if (!(BOOKING_DB_ID_REGEX.test(bookingId) || BOOKING_DISPLAY_ID_REGEX.test(bookingId))) {
+    throw new Error(ERROR_INVALID_BOOKING_ID);
+  }
+}
+function assertOrderId(orderId) {
+  if (!(ORDER_DB_ID_REGEX.test(orderId) || ORDER_DISPLAY_ID_REGEX.test(orderId))) {
+    throw new Error(ERROR_INVALID_ORDER_ID);
   }
 }
 function validateCreateInput(input) {
@@ -1599,6 +1620,9 @@ function validateCreateInput(input) {
   if (input.markAsPaid && !input.idempotencyKey) {
     throw new Error("idempotencyKey is required when markAsPaid is set");
   }
+  if (input.parentOrderId) {
+    assertOrderId(input.parentOrderId);
+  }
 }
 function parseQuantity(value) {
   if (typeof value !== "string" && typeof value !== "number") {