@tiquo/dom-package 1.5.1 → 1.5.3

package/README.md

@@ -9,6 +9,7 @@ Tiquo SDK for third-party websites. Integrate authentication, customer profiles,
 - **Multi-Tab Sync** - Auth state automatically syncs across all browser tabs
 - **Native App Integration** - WebView token injection for iOS/Android hybrid apps
 - **Customer Flow Integration** - Embed authenticated customer flows with one line of code
+- **First-Party Website Analytics** - Cookie-free pageview, session, attribution, and known-customer activity tracking
 - **Phone Number Utilities** - Validation, formatting, and country code support for 200+ countries
 - **Framework Agnostic** - Works with React, Vue, Svelte, or vanilla JavaScript
 - **TypeScript Support** - Full type definitions included
@@ -39,6 +40,19 @@ const auth = new TiquoAuth({
 });
 ```
 
+Website analytics starts automatically when you initialize `TiquoAuth` or `TiquoCMS`.
+The same public key is used across all websites in your organization; Tiquo records
+the source domain for each event and rolls `www.example.com` into `example.com`.
+Other subdomains are tracked as separate websites.
+
+```typescript
+// Optional custom analytics events
+await auth.analytics?.track('booking_started', {
+  eventName: 'Booking Started',
+  eventProperties: { serviceId: 'svc_123' }
+});
+```
+
 ### 3. Authenticate Users
 
 ```typescript
@@ -65,6 +79,7 @@ const auth = new TiquoAuth({
   storagePrefix?: string;  // Optional: localStorage key prefix
   debug?: boolean;         // Optional: Enable debug logging
   enableTabSync?: boolean; // Optional: Multi-tab session sync (default: true)
+  analytics?: boolean;     // Optional: Website analytics (default: true)
 });
 ```
 
@@ -210,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:**
@@ -219,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

@@ -209,8 +209,27 @@ declare function buildPhone(countryCode: string, nationalNumber: string): string
  * ```
  */
 
+declare class TiquoAnalytics {
+    private static activeInstances;
+    private config;
+    private clientSessionId;
+    private pageStartedAt;
+    private lastPath;
+    private started;
+    constructor(config: TiquoAnalyticsConfig);
+    start(): void;
+    trackPageview(options?: TiquoAnalyticsEventOptions): Promise<void>;
+    track(eventType: string, options?: TiquoAnalyticsEventOptions): Promise<void>;
+    identify(options?: TiquoAnalyticsEventOptions): Promise<void>;
+    private trackEngagement;
+    private send;
+    private getClientSessionId;
+    private log;
+    private adoptConfig;
+}
 declare class TiquoCMS {
     private config;
+    analytics: TiquoAnalytics | null;
     constructor(config: TiquoCMSConfig);
     /**
      * Fetch a published CMS page for the website attached to this public key.
@@ -236,6 +255,8 @@ interface TiquoAuthConfig {
     accessToken?: string;
     /** Pre-authenticated refresh token (for WebView injection from native apps) */
     refreshToken?: string;
+    /** Enable first-party website analytics (default: true) */
+    analytics?: boolean;
 }
 interface TiquoCMSConfig {
     /** Public key from your Tiquo Auth DOM settings */
@@ -244,6 +265,35 @@ interface TiquoCMSConfig {
     apiEndpoint?: string;
     /** Enable debug logging */
     debug?: boolean;
+    /** Enable first-party website analytics (default: true) */
+    analytics?: boolean;
+}
+interface TiquoAnalyticsConfig {
+    /** Public key from your Tiquo Auth DOM settings */
+    publicKey: string;
+    /** API endpoint (defaults to production) */
+    apiEndpoint?: string;
+    /** Enable debug logging */
+    debug?: boolean;
+    /** Optional CMS website slug */
+    siteSlug?: string;
+    /** Enable automatic pageview tracking (default: true) */
+    autoTrackPageviews?: boolean;
+    /** Optional access-token getter used to associate events with known customers */
+    getAccessToken?: () => string | null | undefined;
+}
+interface TiquoAnalyticsEventOptions {
+    eventName?: string;
+    eventProperties?: Record<string, unknown>;
+    siteSlug?: string;
+    pageSlug?: string;
+    path?: string;
+    url?: string;
+    title?: string;
+    referrer?: string;
+    durationMs?: number;
+    scrollDepth?: number;
+    identityLinkType?: "auth_dom_login" | "email_capture" | "booking" | "enquiry" | "order" | "customer_portal" | "manual";
 }
 interface TiquoCMSPageRequest {
     /** CMS website slug */
@@ -392,7 +442,7 @@ interface TiquoOrderItem {
     quantity: number;
     unitPrice: number;
     total: number;
-    type: 'product' | 'booking' | 'custom';
+    type: "product" | "booking" | "custom";
 }
 /**
  * An order belonging to the authenticated customer.
@@ -404,8 +454,8 @@ interface TiquoOrderItem {
 interface TiquoOrder {
     id: string;
     orderNumber: string;
-    status: 'draft' | 'processing' | 'completed' | 'cancelled' | 'refunded' | 'open_tab';
-    paymentStatus: 'pending' | 'paid' | 'partial' | 'refunded' | 'partially_refunded' | 'failed' | 'cancelled';
+    status: "draft" | "processing" | "completed" | "cancelled" | "refunded" | "open_tab";
+    paymentStatus: "pending" | "paid" | "partial" | "refunded" | "partially_refunded" | "failed" | "cancelled";
     total: number;
     subtotal: number;
     taxTotal: number;
@@ -413,12 +463,12 @@ interface TiquoOrder {
     items: TiquoOrderItem[];
     createdAt: number;
     completedAt?: number;
-    customerRole: 'primary' | 'attendee' | 'billing' | 'referrer' | 'other';
+    customerRole: "primary" | "attendee" | "billing" | "referrer" | "other";
 }
 interface GetOrdersOptions {
     limit?: number;
     cursor?: string;
-    status?: TiquoOrder['status'];
+    status?: TiquoOrder["status"];
 }
 interface GetOrdersResult {
     orders: TiquoOrder[];
@@ -434,7 +484,7 @@ interface TiquoReceiptItem {
     tax: number;
     discount: number;
     total: number;
-    type: 'product' | 'booking' | 'custom' | 'membership';
+    type: "product" | "booking" | "custom" | "membership";
     specialInstructions?: string;
 }
 interface TiquoReceiptBusiness {
@@ -461,8 +511,8 @@ interface TiquoReceiptCustomer {
 interface TiquoReceiptOrder {
     id: string;
     orderNumber: string;
-    status: TiquoOrder['status'];
-    paymentStatus: TiquoOrder['paymentStatus'];
+    status: TiquoOrder["status"];
+    paymentStatus: TiquoOrder["paymentStatus"];
     currency: string;
     subtotal: number;
     taxTotal: number;
@@ -502,7 +552,7 @@ interface TiquoReceipt {
 interface TiquoBooking {
     id: string;
     bookingNumber: string;
-    status: 'scheduled' | 'confirmed' | 'reminder_sent' | 'waiting_room' | 'waiting_list' | 'checked_in' | 'active' | 'in_progress' | 'completed' | 'cancelled' | 'no_show' | 'rescheduled';
+    status: "scheduled" | "confirmed" | "reminder_sent" | "waiting_room" | "waiting_list" | "checked_in" | "active" | "in_progress" | "completed" | "cancelled" | "no_show" | "rescheduled";
     date: number;
     startTime: string;
     endTime: string;
@@ -510,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;
@@ -526,7 +587,7 @@ interface TiquoBooking {
 interface GetBookingsOptions {
     limit?: number;
     cursor?: string;
-    status?: TiquoBooking['status'];
+    status?: TiquoBooking["status"];
     upcoming?: boolean;
 }
 interface GetBookingsResult {
@@ -541,27 +602,27 @@ interface TiquoEnquiry {
     subject: string;
     message: string;
     category: string;
-    status: 'new' | 'in_progress' | 'waiting_customer' | 'waiting_internal' | 'won' | 'lost' | 'closed' | 'resolved' | 'archived';
-    priority: 'low' | 'medium' | 'high' | 'urgent';
-    source: 'online' | 'website' | 'phone' | 'email' | 'walk_in' | 'social' | 'referral' | 'pos' | 'admin';
+    status: "new" | "in_progress" | "waiting_customer" | "waiting_internal" | "won" | "lost" | "closed" | "resolved" | "archived";
+    priority: "low" | "medium" | "high" | "urgent";
+    source: "online" | "website" | "phone" | "email" | "walk_in" | "social" | "referral" | "pos" | "admin";
     responseCount: number;
     createdAt: string;
     updatedAt: string;
     firstResponseAt?: string;
     resolvedAt?: string;
-    customerRole: 'primary' | 'attendee' | 'billing' | 'referrer' | 'other';
+    customerRole: "primary" | "attendee" | "billing" | "referrer" | "other";
 }
 interface GetEnquiriesOptions {
     limit?: number;
     cursor?: string;
-    status?: TiquoEnquiry['status'];
+    status?: TiquoEnquiry["status"];
 }
 interface GetEnquiriesResult {
     enquiries: TiquoEnquiry[];
     hasMore: boolean;
     nextCursor?: string;
 }
-type TiquoCompanyRelationship = 'employee' | 'contractor' | 'manager' | 'executive' | 'owner' | 'contact' | 'other';
+type TiquoCompanyRelationship = "employee" | "contractor" | "manager" | "executive" | "owner" | "contact" | "other";
 /**
  * The authenticated customer's membership in a company. Each company the
  * customer belongs to has its own membership record — a customer can be
@@ -599,9 +660,9 @@ interface TiquoCompany {
     postalCode?: string;
     country?: string;
     industry?: string;
-    companySize?: '1-10' | '11-50' | '51-200' | '201-500' | '501-1000' | '1000+';
-    status: 'active' | 'inactive' | 'archived';
-    type?: 'client' | 'prospect' | 'vendor' | 'partner' | 'other';
+    companySize?: "1-10" | "11-50" | "51-200" | "201-500" | "501-1000" | "1000+";
+    status: "active" | "inactive" | "archived";
+    type?: "client" | "prospect" | "vendor" | "partner" | "other";
     membership: TiquoCompanyMembership;
 }
 interface GetCompaniesResult {
@@ -652,6 +713,7 @@ declare class TiquoAuth {
     private visibilityHandler;
     private iframeObserver;
     private injectedIframes;
+    analytics: TiquoAnalytics | null;
     private broadcastChannel;
     private tabId;
     private isProcessingTabSync;
@@ -721,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
@@ -731,7 +800,7 @@ declare class TiquoAuth {
      * future, since they're effectively history. Use `getBookings()` without
      * `upcoming: true` if you need those.
      */
-    getUpcomingBookings(options?: Omit<GetBookingsOptions, 'upcoming'>): Promise<GetBookingsResult>;
+    getUpcomingBookings(options?: Omit<GetBookingsOptions, "upcoming">): Promise<GetBookingsResult>;
     /**
      * Get a printable receipt for a single order owned by the authenticated
      * customer. Only resolves for orders that are paid (full or partial),
@@ -941,4 +1010,4 @@ declare class TiquoPhone {
     static buildPhone: typeof buildPhone;
 }
 
-export { type AuthStateChangeCallback, type CountryPhoneInfo, type GetBookingsOptions, type GetBookingsResult, type GetCompaniesResult, type GetCompanyColleaguesResult, type GetEnquiriesOptions, type GetEnquiriesResult, type GetOrdersOptions, type GetOrdersResult, type IframeTokenResult, type PhoneValidationResult, type ProfilePhotoUploadResult, type ProfileUpdateData, type ProfileUpdateResult, type SendOTPResult, TiquoAuth, type TiquoAuthConfig, TiquoAuthError, type TiquoBooking, TiquoCMS, type TiquoCMSBlock, type TiquoCMSConfig, type TiquoCMSPage, type TiquoCMSPageRequest, type TiquoCompany, type TiquoCompanyColleague, type TiquoCompanyMembership, type TiquoCompanyRelationship, type TiquoCustomer, type TiquoCustomerEmail, type TiquoCustomerPhone, type TiquoEnquiry, type TiquoOrder, type TiquoOrderItem, TiquoPhone, type TiquoReceipt, type TiquoReceiptBusiness, type TiquoReceiptCustomer, type TiquoReceiptItem, type TiquoReceiptOrder, type TiquoSession, type TiquoUser, type VerifyOTPResult, addCustomerUserId, clearCachedEmail, TiquoAuth as default, getCustomerUserIds, getPrefilledEmailFromCookie, isDashboardSession, trackCustomerPresence, useTiquoAuth };
+export { type AuthStateChangeCallback, type CountryPhoneInfo, type GetBookingsOptions, type GetBookingsResult, type GetCompaniesResult, type GetCompanyColleaguesResult, type GetEnquiriesOptions, type GetEnquiriesResult, type GetOrdersOptions, type GetOrdersResult, type IframeTokenResult, type PhoneValidationResult, type ProfilePhotoUploadResult, type ProfileUpdateData, type ProfileUpdateResult, type SendOTPResult, TiquoAnalytics, type TiquoAnalyticsConfig, type TiquoAnalyticsEventOptions, TiquoAuth, type TiquoAuthConfig, TiquoAuthError, type TiquoBooking, TiquoCMS, type TiquoCMSBlock, type TiquoCMSConfig, type TiquoCMSPage, type TiquoCMSPageRequest, type TiquoCompany, type TiquoCompanyColleague, type TiquoCompanyMembership, type TiquoCompanyRelationship, type TiquoCustomer, type TiquoCustomerEmail, type TiquoCustomerPhone, type TiquoEnquiry, type TiquoOrder, type TiquoOrderItem, TiquoPhone, type TiquoReceipt, type TiquoReceiptBusiness, type TiquoReceiptCustomer, type TiquoReceiptItem, type TiquoReceiptOrder, type TiquoSession, type TiquoUser, type VerifyOTPResult, addCustomerUserId, clearCachedEmail, TiquoAuth as default, getCustomerUserIds, getPrefilledEmailFromCookie, isDashboardSession, trackCustomerPresence, useTiquoAuth };

package/dist/index.d.ts

@@ -209,8 +209,27 @@ declare function buildPhone(countryCode: string, nationalNumber: string): string
  * ```
  */
 
+declare class TiquoAnalytics {
+    private static activeInstances;
+    private config;
+    private clientSessionId;
+    private pageStartedAt;
+    private lastPath;
+    private started;
+    constructor(config: TiquoAnalyticsConfig);
+    start(): void;
+    trackPageview(options?: TiquoAnalyticsEventOptions): Promise<void>;
+    track(eventType: string, options?: TiquoAnalyticsEventOptions): Promise<void>;
+    identify(options?: TiquoAnalyticsEventOptions): Promise<void>;
+    private trackEngagement;
+    private send;
+    private getClientSessionId;
+    private log;
+    private adoptConfig;
+}
 declare class TiquoCMS {
     private config;
+    analytics: TiquoAnalytics | null;
     constructor(config: TiquoCMSConfig);
     /**
      * Fetch a published CMS page for the website attached to this public key.
@@ -236,6 +255,8 @@ interface TiquoAuthConfig {
     accessToken?: string;
     /** Pre-authenticated refresh token (for WebView injection from native apps) */
     refreshToken?: string;
+    /** Enable first-party website analytics (default: true) */
+    analytics?: boolean;
 }
 interface TiquoCMSConfig {
     /** Public key from your Tiquo Auth DOM settings */
@@ -244,6 +265,35 @@ interface TiquoCMSConfig {
     apiEndpoint?: string;
     /** Enable debug logging */
     debug?: boolean;
+    /** Enable first-party website analytics (default: true) */
+    analytics?: boolean;
+}
+interface TiquoAnalyticsConfig {
+    /** Public key from your Tiquo Auth DOM settings */
+    publicKey: string;
+    /** API endpoint (defaults to production) */
+    apiEndpoint?: string;
+    /** Enable debug logging */
+    debug?: boolean;
+    /** Optional CMS website slug */
+    siteSlug?: string;
+    /** Enable automatic pageview tracking (default: true) */
+    autoTrackPageviews?: boolean;
+    /** Optional access-token getter used to associate events with known customers */
+    getAccessToken?: () => string | null | undefined;
+}
+interface TiquoAnalyticsEventOptions {
+    eventName?: string;
+    eventProperties?: Record<string, unknown>;
+    siteSlug?: string;
+    pageSlug?: string;
+    path?: string;
+    url?: string;
+    title?: string;
+    referrer?: string;
+    durationMs?: number;
+    scrollDepth?: number;
+    identityLinkType?: "auth_dom_login" | "email_capture" | "booking" | "enquiry" | "order" | "customer_portal" | "manual";
 }
 interface TiquoCMSPageRequest {
     /** CMS website slug */
@@ -392,7 +442,7 @@ interface TiquoOrderItem {
     quantity: number;
     unitPrice: number;
     total: number;
-    type: 'product' | 'booking' | 'custom';
+    type: "product" | "booking" | "custom";
 }
 /**
  * An order belonging to the authenticated customer.
@@ -404,8 +454,8 @@ interface TiquoOrderItem {
 interface TiquoOrder {
     id: string;
     orderNumber: string;
-    status: 'draft' | 'processing' | 'completed' | 'cancelled' | 'refunded' | 'open_tab';
-    paymentStatus: 'pending' | 'paid' | 'partial' | 'refunded' | 'partially_refunded' | 'failed' | 'cancelled';
+    status: "draft" | "processing" | "completed" | "cancelled" | "refunded" | "open_tab";
+    paymentStatus: "pending" | "paid" | "partial" | "refunded" | "partially_refunded" | "failed" | "cancelled";
     total: number;
     subtotal: number;
     taxTotal: number;
@@ -413,12 +463,12 @@ interface TiquoOrder {
     items: TiquoOrderItem[];
     createdAt: number;
     completedAt?: number;
-    customerRole: 'primary' | 'attendee' | 'billing' | 'referrer' | 'other';
+    customerRole: "primary" | "attendee" | "billing" | "referrer" | "other";
 }
 interface GetOrdersOptions {
     limit?: number;
     cursor?: string;
-    status?: TiquoOrder['status'];
+    status?: TiquoOrder["status"];
 }
 interface GetOrdersResult {
     orders: TiquoOrder[];
@@ -434,7 +484,7 @@ interface TiquoReceiptItem {
     tax: number;
     discount: number;
     total: number;
-    type: 'product' | 'booking' | 'custom' | 'membership';
+    type: "product" | "booking" | "custom" | "membership";
     specialInstructions?: string;
 }
 interface TiquoReceiptBusiness {
@@ -461,8 +511,8 @@ interface TiquoReceiptCustomer {
 interface TiquoReceiptOrder {
     id: string;
     orderNumber: string;
-    status: TiquoOrder['status'];
-    paymentStatus: TiquoOrder['paymentStatus'];
+    status: TiquoOrder["status"];
+    paymentStatus: TiquoOrder["paymentStatus"];
     currency: string;
     subtotal: number;
     taxTotal: number;
@@ -502,7 +552,7 @@ interface TiquoReceipt {
 interface TiquoBooking {
     id: string;
     bookingNumber: string;
-    status: 'scheduled' | 'confirmed' | 'reminder_sent' | 'waiting_room' | 'waiting_list' | 'checked_in' | 'active' | 'in_progress' | 'completed' | 'cancelled' | 'no_show' | 'rescheduled';
+    status: "scheduled" | "confirmed" | "reminder_sent" | "waiting_room" | "waiting_list" | "checked_in" | "active" | "in_progress" | "completed" | "cancelled" | "no_show" | "rescheduled";
     date: number;
     startTime: string;
     endTime: string;
@@ -510,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;
@@ -526,7 +587,7 @@ interface TiquoBooking {
 interface GetBookingsOptions {
     limit?: number;
     cursor?: string;
-    status?: TiquoBooking['status'];
+    status?: TiquoBooking["status"];
     upcoming?: boolean;
 }
 interface GetBookingsResult {
@@ -541,27 +602,27 @@ interface TiquoEnquiry {
     subject: string;
     message: string;
     category: string;
-    status: 'new' | 'in_progress' | 'waiting_customer' | 'waiting_internal' | 'won' | 'lost' | 'closed' | 'resolved' | 'archived';
-    priority: 'low' | 'medium' | 'high' | 'urgent';
-    source: 'online' | 'website' | 'phone' | 'email' | 'walk_in' | 'social' | 'referral' | 'pos' | 'admin';
+    status: "new" | "in_progress" | "waiting_customer" | "waiting_internal" | "won" | "lost" | "closed" | "resolved" | "archived";
+    priority: "low" | "medium" | "high" | "urgent";
+    source: "online" | "website" | "phone" | "email" | "walk_in" | "social" | "referral" | "pos" | "admin";
     responseCount: number;
     createdAt: string;
     updatedAt: string;
     firstResponseAt?: string;
     resolvedAt?: string;
-    customerRole: 'primary' | 'attendee' | 'billing' | 'referrer' | 'other';
+    customerRole: "primary" | "attendee" | "billing" | "referrer" | "other";
 }
 interface GetEnquiriesOptions {
     limit?: number;
     cursor?: string;
-    status?: TiquoEnquiry['status'];
+    status?: TiquoEnquiry["status"];
 }
 interface GetEnquiriesResult {
     enquiries: TiquoEnquiry[];
     hasMore: boolean;
     nextCursor?: string;
 }
-type TiquoCompanyRelationship = 'employee' | 'contractor' | 'manager' | 'executive' | 'owner' | 'contact' | 'other';
+type TiquoCompanyRelationship = "employee" | "contractor" | "manager" | "executive" | "owner" | "contact" | "other";
 /**
  * The authenticated customer's membership in a company. Each company the
  * customer belongs to has its own membership record — a customer can be
@@ -599,9 +660,9 @@ interface TiquoCompany {
     postalCode?: string;
     country?: string;
     industry?: string;
-    companySize?: '1-10' | '11-50' | '51-200' | '201-500' | '501-1000' | '1000+';
-    status: 'active' | 'inactive' | 'archived';
-    type?: 'client' | 'prospect' | 'vendor' | 'partner' | 'other';
+    companySize?: "1-10" | "11-50" | "51-200" | "201-500" | "501-1000" | "1000+";
+    status: "active" | "inactive" | "archived";
+    type?: "client" | "prospect" | "vendor" | "partner" | "other";
     membership: TiquoCompanyMembership;
 }
 interface GetCompaniesResult {
@@ -652,6 +713,7 @@ declare class TiquoAuth {
     private visibilityHandler;
     private iframeObserver;
     private injectedIframes;
+    analytics: TiquoAnalytics | null;
     private broadcastChannel;
     private tabId;
     private isProcessingTabSync;
@@ -721,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
@@ -731,7 +800,7 @@ declare class TiquoAuth {
      * future, since they're effectively history. Use `getBookings()` without
      * `upcoming: true` if you need those.
      */
-    getUpcomingBookings(options?: Omit<GetBookingsOptions, 'upcoming'>): Promise<GetBookingsResult>;
+    getUpcomingBookings(options?: Omit<GetBookingsOptions, "upcoming">): Promise<GetBookingsResult>;
     /**
      * Get a printable receipt for a single order owned by the authenticated
      * customer. Only resolves for orders that are paid (full or partial),
@@ -941,4 +1010,4 @@ declare class TiquoPhone {
     static buildPhone: typeof buildPhone;
 }
 
-export { type AuthStateChangeCallback, type CountryPhoneInfo, type GetBookingsOptions, type GetBookingsResult, type GetCompaniesResult, type GetCompanyColleaguesResult, type GetEnquiriesOptions, type GetEnquiriesResult, type GetOrdersOptions, type GetOrdersResult, type IframeTokenResult, type PhoneValidationResult, type ProfilePhotoUploadResult, type ProfileUpdateData, type ProfileUpdateResult, type SendOTPResult, TiquoAuth, type TiquoAuthConfig, TiquoAuthError, type TiquoBooking, TiquoCMS, type TiquoCMSBlock, type TiquoCMSConfig, type TiquoCMSPage, type TiquoCMSPageRequest, type TiquoCompany, type TiquoCompanyColleague, type TiquoCompanyMembership, type TiquoCompanyRelationship, type TiquoCustomer, type TiquoCustomerEmail, type TiquoCustomerPhone, type TiquoEnquiry, type TiquoOrder, type TiquoOrderItem, TiquoPhone, type TiquoReceipt, type TiquoReceiptBusiness, type TiquoReceiptCustomer, type TiquoReceiptItem, type TiquoReceiptOrder, type TiquoSession, type TiquoUser, type VerifyOTPResult, addCustomerUserId, clearCachedEmail, TiquoAuth as default, getCustomerUserIds, getPrefilledEmailFromCookie, isDashboardSession, trackCustomerPresence, useTiquoAuth };
+export { type AuthStateChangeCallback, type CountryPhoneInfo, type GetBookingsOptions, type GetBookingsResult, type GetCompaniesResult, type GetCompanyColleaguesResult, type GetEnquiriesOptions, type GetEnquiriesResult, type GetOrdersOptions, type GetOrdersResult, type IframeTokenResult, type PhoneValidationResult, type ProfilePhotoUploadResult, type ProfileUpdateData, type ProfileUpdateResult, type SendOTPResult, TiquoAnalytics, type TiquoAnalyticsConfig, type TiquoAnalyticsEventOptions, TiquoAuth, type TiquoAuthConfig, TiquoAuthError, type TiquoBooking, TiquoCMS, type TiquoCMSBlock, type TiquoCMSConfig, type TiquoCMSPage, type TiquoCMSPageRequest, type TiquoCompany, type TiquoCompanyColleague, type TiquoCompanyMembership, type TiquoCompanyRelationship, type TiquoCustomer, type TiquoCustomerEmail, type TiquoCustomerPhone, type TiquoEnquiry, type TiquoOrder, type TiquoOrderItem, TiquoPhone, type TiquoReceipt, type TiquoReceiptBusiness, type TiquoReceiptCustomer, type TiquoReceiptItem, type TiquoReceiptOrder, type TiquoSession, type TiquoUser, type VerifyOTPResult, addCustomerUserId, clearCachedEmail, TiquoAuth as default, getCustomerUserIds, getPrefilledEmailFromCookie, isDashboardSession, trackCustomerPresence, useTiquoAuth };