@tiquo/dom-package 1.5.2 → 1.5.3

package/README.md

@@ -225,6 +225,15 @@ const confirmedBookings = await auth.getBookings({ status: 'confirmed' });
 // With pagination
 const page1 = await auth.getBookings({ limit: 10 });
 const page2 = await auth.getBookings({ limit: 10, cursor: page1.nextCursor });
+
+// Download a QR-code ticket PDF when ticketing is enabled
+const [booking] = upcomingBookings.bookings;
+if (booking?.ticketing.qrCodeTicketsEnabled) {
+  const ticketPdf = await auth.downloadBookingTicket(booking.id);
+}
+
+// Wallet links are included when Apple Wallet / Google Wallet tickets are enabled
+const walletUrl = booking?.ticketing.walletTicketUrl;
 ```
 
 **Options:**
@@ -234,10 +243,14 @@ const page2 = await auth.getBookings({ limit: 10, cursor: page1.nextCursor });
 - `upcoming` - If true, only return future bookings (sorted soonest first)
 
 **Returns:**
-- `bookings` - Array of booking objects with service details, date/time, and status
+- `bookings` - Array of booking objects with service details, date/time, status, and `ticketing` links. `serviceName` and `serviceCategoryName` come from the booking's order-item snapshot.
 - `hasMore` - Whether there are more bookings to fetch
 - `nextCursor` - Cursor for the next page (if `hasMore` is true)
 
+#### `downloadBookingTicket(bookingId): Promise<Blob>`
+
+Download the QR-code ticket PDF for one of the authenticated customer's bookings. Use this when `booking.ticketing.qrCodeTicketsEnabled` is true. Wallet-capable bookings also expose `booking.ticketing.walletTicketUrl`, `appleWalletTicketUrl`, and `googleWalletTicketUrl`.
+
 #### `getEnquiries(options?): Promise<GetEnquiriesResult>`
 
 Get the authenticated customer's enquiry history. Only returns enquiries for the logged-in customer.

package/dist/index.d.mts

@@ -560,11 +560,22 @@ interface TiquoBooking {
     timezone: string;
     attendeeCount: number;
     /**
-     * Service title (e.g. "OJAS Listening Room"). Empty string when the
-     * underlying service has been deleted — render your own fallback if you
-     * need a non-empty display string.
+     * Service title from the booking's order-item snapshot. Empty string when no
+     * order snapshot is available — render your own fallback if needed.
      */
     serviceName: string;
+    /**
+     * Service category from the booking's order-item snapshot, when captured.
+     */
+    serviceCategoryName?: string;
+    ticketing: {
+        qrCodeTicketsEnabled: boolean;
+        walletTicketsEnabled: boolean;
+        ticketDownloadUrl?: string;
+        walletTicketUrl?: string;
+        appleWalletTicketUrl?: string;
+        googleWalletTicketUrl?: string;
+    };
     serviceId: string;
     sublocationId: string;
     customerNotes?: string;
@@ -772,6 +783,13 @@ declare class TiquoAuth {
      * first.
      */
     getBookings(options?: GetBookingsOptions): Promise<GetBookingsResult>;
+    /**
+     * Download a QR-code ticket PDF for one of the authenticated customer's bookings.
+     *
+     * This is only available when `booking.ticketing.qrCodeTicketsEnabled` is
+     * true in the booking list response.
+     */
+    downloadBookingTicket(bookingId: string): Promise<Blob>;
     /**
      * Convenience wrapper around `getBookings({ upcoming: true })` for the
      * common "show me my upcoming bookings" case. Results are sorted

package/dist/index.d.ts

@@ -560,11 +560,22 @@ interface TiquoBooking {
     timezone: string;
     attendeeCount: number;
     /**
-     * Service title (e.g. "OJAS Listening Room"). Empty string when the
-     * underlying service has been deleted — render your own fallback if you
-     * need a non-empty display string.
+     * Service title from the booking's order-item snapshot. Empty string when no
+     * order snapshot is available — render your own fallback if needed.
      */
     serviceName: string;
+    /**
+     * Service category from the booking's order-item snapshot, when captured.
+     */
+    serviceCategoryName?: string;
+    ticketing: {
+        qrCodeTicketsEnabled: boolean;
+        walletTicketsEnabled: boolean;
+        ticketDownloadUrl?: string;
+        walletTicketUrl?: string;
+        appleWalletTicketUrl?: string;
+        googleWalletTicketUrl?: string;
+    };
     serviceId: string;
     sublocationId: string;
     customerNotes?: string;
@@ -772,6 +783,13 @@ declare class TiquoAuth {
      * first.
      */
     getBookings(options?: GetBookingsOptions): Promise<GetBookingsResult>;
+    /**
+     * Download a QR-code ticket PDF for one of the authenticated customer's bookings.
+     *
+     * This is only available when `booking.ticketing.qrCodeTicketsEnabled` is
+     * true in the booking list response.
+     */
+    downloadBookingTicket(bookingId: string): Promise<Blob>;
     /**
      * Convenience wrapper around `getBookings({ upcoming: true })` for the
      * common "show me my upcoming bookings" case. Results are sorted

package/dist/index.js

@@ -1475,6 +1475,36 @@ var TiquoAuth = class {
     const result = await response.json();
     return result.data || { bookings: [], hasMore: false };
   }
+  /**
+   * Download a QR-code ticket PDF for one of the authenticated customer's bookings.
+   *
+   * This is only available when `booking.ticketing.qrCodeTicketsEnabled` is
+   * true in the booking list response.
+   */
+  async downloadBookingTicket(bookingId) {
+    await this.ensureValidToken();
+    this.log("Downloading booking ticket:", bookingId);
+    const url = new URL(
+      `${this.config.apiEndpoint}/api/client/v1/booking-ticket`
+    );
+    url.searchParams.set("bookingId", bookingId);
+    const response = await fetch(url.toString(), {
+      method: "GET",
+      headers: {
+        Authorization: `Bearer ${this.accessToken}`
+      },
+      credentials: "include"
+    });
+    if (!response.ok) {
+      const error = await response.json().catch(() => ({ error: "Failed to download booking ticket" }));
+      throw new TiquoAuthError(
+        error.error || "Failed to download booking ticket",
+        "DOWNLOAD_BOOKING_TICKET_FAILED",
+        response.status
+      );
+    }
+    return response.blob();
+  }
   /**
    * Convenience wrapper around `getBookings({ upcoming: true })` for the
    * common "show me my upcoming bookings" case. Results are sorted

package/dist/index.mjs

@@ -1437,6 +1437,36 @@ var TiquoAuth = class {
     const result = await response.json();
     return result.data || { bookings: [], hasMore: false };
   }
+  /**
+   * Download a QR-code ticket PDF for one of the authenticated customer's bookings.
+   *
+   * This is only available when `booking.ticketing.qrCodeTicketsEnabled` is
+   * true in the booking list response.
+   */
+  async downloadBookingTicket(bookingId) {
+    await this.ensureValidToken();
+    this.log("Downloading booking ticket:", bookingId);
+    const url = new URL(
+      `${this.config.apiEndpoint}/api/client/v1/booking-ticket`
+    );
+    url.searchParams.set("bookingId", bookingId);
+    const response = await fetch(url.toString(), {
+      method: "GET",
+      headers: {
+        Authorization: `Bearer ${this.accessToken}`
+      },
+      credentials: "include"
+    });
+    if (!response.ok) {
+      const error = await response.json().catch(() => ({ error: "Failed to download booking ticket" }));
+      throw new TiquoAuthError(
+        error.error || "Failed to download booking ticket",
+        "DOWNLOAD_BOOKING_TICKET_FAILED",
+        response.status
+      );
+    }
+    return response.blob();
+  }
   /**
    * Convenience wrapper around `getBookings({ upcoming: true })` for the
    * common "show me my upcoming bookings" case. Results are sorted

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@tiquo/dom-package",
-  "version": "1.5.2",
+  "version": "1.5.3",
   "description": "Tiquo SDK for third-party websites - authentication, customer profiles, orders, bookings, enquiries, receipts, and companies",
   "sideEffects": true,
   "publishConfig": {
-    "access": "restricted"
+    "access": "public"
   },
   "main": "dist/index.js",
   "module": "dist/index.mjs",