@tiquo/dom-package 1.3.3 → 1.4.1

package/dist/index.d.mts

@@ -325,10 +325,17 @@ interface TiquoOrderItem {
     total: number;
     type: 'product' | 'booking' | 'custom';
 }
+/**
+ * An order belonging to the authenticated customer.
+ *
+ * Note: `lost_cart` (abandoned) and `pending` (unprocessed/awaiting-payment)
+ * orders are never returned — they're internal state, not part of the
+ * customer's purchase history.
+ */
 interface TiquoOrder {
     id: string;
     orderNumber: string;
-    status: 'draft' | 'pending' | 'processing' | 'completed' | 'cancelled' | 'refunded' | 'open_tab';
+    status: 'draft' | 'processing' | 'completed' | 'cancelled' | 'refunded' | 'open_tab';
     paymentStatus: 'pending' | 'paid' | 'partial' | 'refunded' | 'partially_refunded' | 'failed' | 'cancelled';
     total: number;
     subtotal: number;
@@ -337,7 +344,7 @@ interface TiquoOrder {
     items: TiquoOrderItem[];
     createdAt: number;
     completedAt?: number;
-    customerRole: 'primary' | 'attendee' | 'recipient' | 'billing' | 'guest' | 'other';
+    customerRole: 'primary' | 'attendee' | 'billing' | 'referrer' | 'other';
 }
 interface GetOrdersOptions {
     limit?: number;
@@ -349,16 +356,95 @@ interface GetOrdersResult {
     hasMore: boolean;
     nextCursor?: string;
 }
+interface TiquoReceiptItem {
+    id: string;
+    name: string;
+    quantity: number;
+    unitPrice: number;
+    subtotal: number;
+    tax: number;
+    discount: number;
+    total: number;
+    type: 'product' | 'booking' | 'custom' | 'membership';
+    specialInstructions?: string;
+}
+interface TiquoReceiptBusiness {
+    name?: string;
+    logo?: string;
+    brandName?: string;
+    primaryColor?: string;
+    vatNumber?: string;
+    address?: string;
+    city?: string;
+    postalCode?: string;
+    country?: string;
+    email?: string;
+    phone?: string;
+    sublocationName?: string;
+    locationName?: string;
+}
+interface TiquoReceiptCustomer {
+    id: string;
+    customerNumber: string;
+    displayName?: string;
+    email?: string;
+}
+interface TiquoReceiptOrder {
+    id: string;
+    orderNumber: string;
+    status: TiquoOrder['status'];
+    paymentStatus: TiquoOrder['paymentStatus'];
+    currency: string;
+    subtotal: number;
+    taxTotal: number;
+    /** "Tax Inclusive" or "Tax Exclusive" — controls how the receipt should render tax lines. */
+    taxSetting?: string;
+    discountTotal: number;
+    discountName?: string;
+    serviceChargeAmount?: number;
+    tipAmount?: number;
+    total: number;
+    refundAmount?: number;
+    refundedAt?: number;
+    paymentMethod?: string;
+    cardBrand?: string;
+    cardLast4?: string;
+    items: TiquoReceiptItem[];
+    createdAt: number;
+    completedAt?: number;
+}
+/**
+ * A printable receipt for a single paid/completed order owned by the
+ * authenticated customer. Combines order totals, line items, business
+ * branding (logo, VAT, address), and the customer's own details so the
+ * consumer can render or print the receipt without further API calls.
+ */
+interface TiquoReceipt {
+    order: TiquoReceiptOrder;
+    business: TiquoReceiptBusiness;
+    customer: TiquoReceiptCustomer;
+}
+/**
+ * A booking belonging to the authenticated customer.
+ *
+ * Note: `draft` bookings (in-progress checkout state) are never returned —
+ * they're internal state, not part of the customer's booking history.
+ */
 interface TiquoBooking {
     id: string;
     bookingNumber: string;
-    status: 'draft' | '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;
     duration: number;
     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.
+     */
     serviceName: string;
     serviceId: string;
     sublocationId: string;
@@ -394,7 +480,7 @@ interface TiquoEnquiry {
     updatedAt: string;
     firstResponseAt?: string;
     resolvedAt?: string;
-    customerRole: 'primary' | 'interested' | 'decision_maker' | 'influencer' | 'referrer' | 'other';
+    customerRole: 'primary' | 'attendee' | 'billing' | 'referrer' | 'other';
 }
 interface GetEnquiriesOptions {
     limit?: number;
@@ -464,15 +550,54 @@ declare class TiquoAuth {
      */
     onAuthStateChange(callback: AuthStateChangeCallback): () => void;
     /**
-     * Get the authenticated customer's order history
-     * Only returns orders for the logged-in customer
+     * Get the authenticated customer's order history.
+     *
+     * Returns orders across most statuses (draft, processing, completed,
+     * cancelled, refunded, open_tab). `lost_cart` (abandoned) and `pending`
+     * (unprocessed/awaiting-payment) orders are never exposed — they're
+     * internal state, not purchase history.
+     *
+     * Pass `status` to filter to a single status; pass `cursor` (an order id
+     * from a previous `nextCursor`) to paginate. Sorted most recent first.
      */
     getOrders(options?: GetOrdersOptions): Promise<GetOrdersResult>;
     /**
-     * Get the authenticated customer's booking history
-     * Only returns bookings for the logged-in customer
+     * Get the authenticated customer's booking history.
+     *
+     * Pass `upcoming: true` to limit to future bookings sorted soonest-first —
+     * the common case for rendering "Your upcoming bookings" on a logged-in
+     * customer dashboard. Without it, returns all bookings sorted most recent
+     * first.
      */
     getBookings(options?: GetBookingsOptions): Promise<GetBookingsResult>;
+    /**
+     * Convenience wrapper around `getBookings({ upcoming: true })` for the
+     * common "show me my upcoming bookings" case. Results are sorted
+     * soonest-first.
+     *
+     * Only actionable future bookings are returned — `cancelled`, `no_show`,
+     * and `rescheduled` bookings are excluded even if their date is in the
+     * future, since they're effectively history. Use `getBookings()` without
+     * `upcoming: true` if you need those.
+     */
+    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),
+     * refunded, or completed — drafts and pending orders don't have a receipt
+     * yet and will throw `RECEIPT_NOT_AVAILABLE`.
+     *
+     * The returned payload bundles the order totals & items, the business's
+     * receipt branding (logo, VAT number, address), and the customer's own
+     * details so the consumer can render or print the receipt without further
+     * API calls.
+     *
+     * Throws `TiquoAuthError` with code:
+     *   - `RECEIPT_NOT_AVAILABLE` — order doesn't exist for this customer, or
+     *     it isn't paid/completed yet.
+     *   - `NOT_AUTHENTICATED` — no valid session.
+     */
+    getReceipt(orderId: string): Promise<TiquoReceipt>;
     /**
      * Get the authenticated customer's enquiry history
      * Only returns enquiries for the logged-in customer
@@ -568,6 +693,8 @@ declare function useTiquoAuth(auth: TiquoAuth): {
     updateProfile: (updates: ProfileUpdateData) => Promise<ProfileUpdateResult>;
     getOrders: (options?: GetOrdersOptions) => Promise<GetOrdersResult>;
     getBookings: (options?: GetBookingsOptions) => Promise<GetBookingsResult>;
+    getUpcomingBookings: (options?: Omit<GetBookingsOptions, "upcoming">) => Promise<GetBookingsResult>;
+    getReceipt: (orderId: string) => Promise<TiquoReceipt>;
     getEnquiries: (options?: GetEnquiriesOptions) => Promise<GetEnquiriesResult>;
     getIframeToken: (flowId?: string) => Promise<IframeTokenResult>;
     embedCustomerFlow: (flowUrl: string, container: HTMLElement | string, options?: {
@@ -631,4 +758,4 @@ declare class TiquoPhone {
     static buildPhone: typeof buildPhone;
 }
 
-export { type AuthStateChangeCallback, type CountryPhoneInfo, type GetBookingsOptions, type GetBookingsResult, type GetEnquiriesOptions, type GetEnquiriesResult, type GetOrdersOptions, type GetOrdersResult, type IframeTokenResult, type PhoneValidationResult, type ProfileUpdateData, type ProfileUpdateResult, type SendOTPResult, TiquoAuth, type TiquoAuthConfig, TiquoAuthError, type TiquoBooking, type TiquoCustomer, type TiquoCustomerEmail, type TiquoCustomerPhone, type TiquoEnquiry, type TiquoOrder, type TiquoOrderItem, TiquoPhone, 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 GetEnquiriesOptions, type GetEnquiriesResult, type GetOrdersOptions, type GetOrdersResult, type IframeTokenResult, type PhoneValidationResult, type ProfileUpdateData, type ProfileUpdateResult, type SendOTPResult, TiquoAuth, type TiquoAuthConfig, TiquoAuthError, type TiquoBooking, 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

@@ -325,10 +325,17 @@ interface TiquoOrderItem {
     total: number;
     type: 'product' | 'booking' | 'custom';
 }
+/**
+ * An order belonging to the authenticated customer.
+ *
+ * Note: `lost_cart` (abandoned) and `pending` (unprocessed/awaiting-payment)
+ * orders are never returned — they're internal state, not part of the
+ * customer's purchase history.
+ */
 interface TiquoOrder {
     id: string;
     orderNumber: string;
-    status: 'draft' | 'pending' | 'processing' | 'completed' | 'cancelled' | 'refunded' | 'open_tab';
+    status: 'draft' | 'processing' | 'completed' | 'cancelled' | 'refunded' | 'open_tab';
     paymentStatus: 'pending' | 'paid' | 'partial' | 'refunded' | 'partially_refunded' | 'failed' | 'cancelled';
     total: number;
     subtotal: number;
@@ -337,7 +344,7 @@ interface TiquoOrder {
     items: TiquoOrderItem[];
     createdAt: number;
     completedAt?: number;
-    customerRole: 'primary' | 'attendee' | 'recipient' | 'billing' | 'guest' | 'other';
+    customerRole: 'primary' | 'attendee' | 'billing' | 'referrer' | 'other';
 }
 interface GetOrdersOptions {
     limit?: number;
@@ -349,16 +356,95 @@ interface GetOrdersResult {
     hasMore: boolean;
     nextCursor?: string;
 }
+interface TiquoReceiptItem {
+    id: string;
+    name: string;
+    quantity: number;
+    unitPrice: number;
+    subtotal: number;
+    tax: number;
+    discount: number;
+    total: number;
+    type: 'product' | 'booking' | 'custom' | 'membership';
+    specialInstructions?: string;
+}
+interface TiquoReceiptBusiness {
+    name?: string;
+    logo?: string;
+    brandName?: string;
+    primaryColor?: string;
+    vatNumber?: string;
+    address?: string;
+    city?: string;
+    postalCode?: string;
+    country?: string;
+    email?: string;
+    phone?: string;
+    sublocationName?: string;
+    locationName?: string;
+}
+interface TiquoReceiptCustomer {
+    id: string;
+    customerNumber: string;
+    displayName?: string;
+    email?: string;
+}
+interface TiquoReceiptOrder {
+    id: string;
+    orderNumber: string;
+    status: TiquoOrder['status'];
+    paymentStatus: TiquoOrder['paymentStatus'];
+    currency: string;
+    subtotal: number;
+    taxTotal: number;
+    /** "Tax Inclusive" or "Tax Exclusive" — controls how the receipt should render tax lines. */
+    taxSetting?: string;
+    discountTotal: number;
+    discountName?: string;
+    serviceChargeAmount?: number;
+    tipAmount?: number;
+    total: number;
+    refundAmount?: number;
+    refundedAt?: number;
+    paymentMethod?: string;
+    cardBrand?: string;
+    cardLast4?: string;
+    items: TiquoReceiptItem[];
+    createdAt: number;
+    completedAt?: number;
+}
+/**
+ * A printable receipt for a single paid/completed order owned by the
+ * authenticated customer. Combines order totals, line items, business
+ * branding (logo, VAT, address), and the customer's own details so the
+ * consumer can render or print the receipt without further API calls.
+ */
+interface TiquoReceipt {
+    order: TiquoReceiptOrder;
+    business: TiquoReceiptBusiness;
+    customer: TiquoReceiptCustomer;
+}
+/**
+ * A booking belonging to the authenticated customer.
+ *
+ * Note: `draft` bookings (in-progress checkout state) are never returned —
+ * they're internal state, not part of the customer's booking history.
+ */
 interface TiquoBooking {
     id: string;
     bookingNumber: string;
-    status: 'draft' | '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;
     duration: number;
     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.
+     */
     serviceName: string;
     serviceId: string;
     sublocationId: string;
@@ -394,7 +480,7 @@ interface TiquoEnquiry {
     updatedAt: string;
     firstResponseAt?: string;
     resolvedAt?: string;
-    customerRole: 'primary' | 'interested' | 'decision_maker' | 'influencer' | 'referrer' | 'other';
+    customerRole: 'primary' | 'attendee' | 'billing' | 'referrer' | 'other';
 }
 interface GetEnquiriesOptions {
     limit?: number;
@@ -464,15 +550,54 @@ declare class TiquoAuth {
      */
     onAuthStateChange(callback: AuthStateChangeCallback): () => void;
     /**
-     * Get the authenticated customer's order history
-     * Only returns orders for the logged-in customer
+     * Get the authenticated customer's order history.
+     *
+     * Returns orders across most statuses (draft, processing, completed,
+     * cancelled, refunded, open_tab). `lost_cart` (abandoned) and `pending`
+     * (unprocessed/awaiting-payment) orders are never exposed — they're
+     * internal state, not purchase history.
+     *
+     * Pass `status` to filter to a single status; pass `cursor` (an order id
+     * from a previous `nextCursor`) to paginate. Sorted most recent first.
      */
     getOrders(options?: GetOrdersOptions): Promise<GetOrdersResult>;
     /**
-     * Get the authenticated customer's booking history
-     * Only returns bookings for the logged-in customer
+     * Get the authenticated customer's booking history.
+     *
+     * Pass `upcoming: true` to limit to future bookings sorted soonest-first —
+     * the common case for rendering "Your upcoming bookings" on a logged-in
+     * customer dashboard. Without it, returns all bookings sorted most recent
+     * first.
      */
     getBookings(options?: GetBookingsOptions): Promise<GetBookingsResult>;
+    /**
+     * Convenience wrapper around `getBookings({ upcoming: true })` for the
+     * common "show me my upcoming bookings" case. Results are sorted
+     * soonest-first.
+     *
+     * Only actionable future bookings are returned — `cancelled`, `no_show`,
+     * and `rescheduled` bookings are excluded even if their date is in the
+     * future, since they're effectively history. Use `getBookings()` without
+     * `upcoming: true` if you need those.
+     */
+    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),
+     * refunded, or completed — drafts and pending orders don't have a receipt
+     * yet and will throw `RECEIPT_NOT_AVAILABLE`.
+     *
+     * The returned payload bundles the order totals & items, the business's
+     * receipt branding (logo, VAT number, address), and the customer's own
+     * details so the consumer can render or print the receipt without further
+     * API calls.
+     *
+     * Throws `TiquoAuthError` with code:
+     *   - `RECEIPT_NOT_AVAILABLE` — order doesn't exist for this customer, or
+     *     it isn't paid/completed yet.
+     *   - `NOT_AUTHENTICATED` — no valid session.
+     */
+    getReceipt(orderId: string): Promise<TiquoReceipt>;
     /**
      * Get the authenticated customer's enquiry history
      * Only returns enquiries for the logged-in customer
@@ -568,6 +693,8 @@ declare function useTiquoAuth(auth: TiquoAuth): {
     updateProfile: (updates: ProfileUpdateData) => Promise<ProfileUpdateResult>;
     getOrders: (options?: GetOrdersOptions) => Promise<GetOrdersResult>;
     getBookings: (options?: GetBookingsOptions) => Promise<GetBookingsResult>;
+    getUpcomingBookings: (options?: Omit<GetBookingsOptions, "upcoming">) => Promise<GetBookingsResult>;
+    getReceipt: (orderId: string) => Promise<TiquoReceipt>;
     getEnquiries: (options?: GetEnquiriesOptions) => Promise<GetEnquiriesResult>;
     getIframeToken: (flowId?: string) => Promise<IframeTokenResult>;
     embedCustomerFlow: (flowUrl: string, container: HTMLElement | string, options?: {
@@ -631,4 +758,4 @@ declare class TiquoPhone {
     static buildPhone: typeof buildPhone;
 }
 
-export { type AuthStateChangeCallback, type CountryPhoneInfo, type GetBookingsOptions, type GetBookingsResult, type GetEnquiriesOptions, type GetEnquiriesResult, type GetOrdersOptions, type GetOrdersResult, type IframeTokenResult, type PhoneValidationResult, type ProfileUpdateData, type ProfileUpdateResult, type SendOTPResult, TiquoAuth, type TiquoAuthConfig, TiquoAuthError, type TiquoBooking, type TiquoCustomer, type TiquoCustomerEmail, type TiquoCustomerPhone, type TiquoEnquiry, type TiquoOrder, type TiquoOrderItem, TiquoPhone, 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 GetEnquiriesOptions, type GetEnquiriesResult, type GetOrdersOptions, type GetOrdersResult, type IframeTokenResult, type PhoneValidationResult, type ProfileUpdateData, type ProfileUpdateResult, type SendOTPResult, TiquoAuth, type TiquoAuthConfig, TiquoAuthError, type TiquoBooking, 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.js

@@ -919,8 +919,15 @@ var TiquoAuth = class {
     };
   }
   /**
-   * Get the authenticated customer's order history
-   * Only returns orders for the logged-in customer
+   * Get the authenticated customer's order history.
+   *
+   * Returns orders across most statuses (draft, processing, completed,
+   * cancelled, refunded, open_tab). `lost_cart` (abandoned) and `pending`
+   * (unprocessed/awaiting-payment) orders are never exposed — they're
+   * internal state, not purchase history.
+   *
+   * Pass `status` to filter to a single status; pass `cursor` (an order id
+   * from a previous `nextCursor`) to paginate. Sorted most recent first.
    */
   async getOrders(options) {
     await this.ensureValidToken();
@@ -950,8 +957,12 @@ var TiquoAuth = class {
     return result.data || { orders: [], hasMore: false };
   }
   /**
-   * Get the authenticated customer's booking history
-   * Only returns bookings for the logged-in customer
+   * Get the authenticated customer's booking history.
+   *
+   * Pass `upcoming: true` to limit to future bookings sorted soonest-first —
+   * the common case for rendering "Your upcoming bookings" on a logged-in
+   * customer dashboard. Without it, returns all bookings sorted most recent
+   * first.
    */
   async getBookings(options) {
     await this.ensureValidToken();
@@ -983,6 +994,55 @@ var TiquoAuth = class {
     const result = await response.json();
     return result.data || { bookings: [], hasMore: false };
   }
+  /**
+   * Convenience wrapper around `getBookings({ upcoming: true })` for the
+   * common "show me my upcoming bookings" case. Results are sorted
+   * soonest-first.
+   *
+   * Only actionable future bookings are returned — `cancelled`, `no_show`,
+   * and `rescheduled` bookings are excluded even if their date is in the
+   * future, since they're effectively history. Use `getBookings()` without
+   * `upcoming: true` if you need those.
+   */
+  async getUpcomingBookings(options) {
+    return this.getBookings({ ...options, upcoming: true });
+  }
+  /**
+   * Get a printable receipt for a single order owned by the authenticated
+   * customer. Only resolves for orders that are paid (full or partial),
+   * refunded, or completed — drafts and pending orders don't have a receipt
+   * yet and will throw `RECEIPT_NOT_AVAILABLE`.
+   *
+   * The returned payload bundles the order totals & items, the business's
+   * receipt branding (logo, VAT number, address), and the customer's own
+   * details so the consumer can render or print the receipt without further
+   * API calls.
+   *
+   * Throws `TiquoAuthError` with code:
+   *   - `RECEIPT_NOT_AVAILABLE` — order doesn't exist for this customer, or
+   *     it isn't paid/completed yet.
+   *   - `NOT_AUTHENTICATED` — no valid session.
+   */
+  async getReceipt(orderId) {
+    await this.ensureValidToken();
+    this.log("Fetching receipt for order:", orderId);
+    const url = new URL(`${this.config.apiEndpoint}/api/client/v1/receipt`);
+    url.searchParams.set("orderId", orderId);
+    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 get receipt" }));
+      const code = response.status === 404 ? "RECEIPT_NOT_AVAILABLE" : "GET_RECEIPT_FAILED";
+      throw new TiquoAuthError(error.error || "Failed to get receipt", code, response.status);
+    }
+    const result = await response.json();
+    return result.data;
+  }
   /**
    * Get the authenticated customer's enquiry history
    * Only returns enquiries for the logged-in customer
@@ -1582,6 +1642,8 @@ function useTiquoAuth(auth) {
     updateProfile: (updates) => auth.updateProfile(updates),
     getOrders: (options) => auth.getOrders(options),
     getBookings: (options) => auth.getBookings(options),
+    getUpcomingBookings: (options) => auth.getUpcomingBookings(options),
+    getReceipt: (orderId) => auth.getReceipt(orderId),
     getEnquiries: (options) => auth.getEnquiries(options),
     getIframeToken: (flowId) => auth.getIframeToken(flowId),
     embedCustomerFlow: auth.embedCustomerFlow.bind(auth),

package/dist/index.mjs

@@ -883,8 +883,15 @@ var TiquoAuth = class {
     };
   }
   /**
-   * Get the authenticated customer's order history
-   * Only returns orders for the logged-in customer
+   * Get the authenticated customer's order history.
+   *
+   * Returns orders across most statuses (draft, processing, completed,
+   * cancelled, refunded, open_tab). `lost_cart` (abandoned) and `pending`
+   * (unprocessed/awaiting-payment) orders are never exposed — they're
+   * internal state, not purchase history.
+   *
+   * Pass `status` to filter to a single status; pass `cursor` (an order id
+   * from a previous `nextCursor`) to paginate. Sorted most recent first.
    */
   async getOrders(options) {
     await this.ensureValidToken();
@@ -914,8 +921,12 @@ var TiquoAuth = class {
     return result.data || { orders: [], hasMore: false };
   }
   /**
-   * Get the authenticated customer's booking history
-   * Only returns bookings for the logged-in customer
+   * Get the authenticated customer's booking history.
+   *
+   * Pass `upcoming: true` to limit to future bookings sorted soonest-first —
+   * the common case for rendering "Your upcoming bookings" on a logged-in
+   * customer dashboard. Without it, returns all bookings sorted most recent
+   * first.
    */
   async getBookings(options) {
     await this.ensureValidToken();
@@ -947,6 +958,55 @@ var TiquoAuth = class {
     const result = await response.json();
     return result.data || { bookings: [], hasMore: false };
   }
+  /**
+   * Convenience wrapper around `getBookings({ upcoming: true })` for the
+   * common "show me my upcoming bookings" case. Results are sorted
+   * soonest-first.
+   *
+   * Only actionable future bookings are returned — `cancelled`, `no_show`,
+   * and `rescheduled` bookings are excluded even if their date is in the
+   * future, since they're effectively history. Use `getBookings()` without
+   * `upcoming: true` if you need those.
+   */
+  async getUpcomingBookings(options) {
+    return this.getBookings({ ...options, upcoming: true });
+  }
+  /**
+   * Get a printable receipt for a single order owned by the authenticated
+   * customer. Only resolves for orders that are paid (full or partial),
+   * refunded, or completed — drafts and pending orders don't have a receipt
+   * yet and will throw `RECEIPT_NOT_AVAILABLE`.
+   *
+   * The returned payload bundles the order totals & items, the business's
+   * receipt branding (logo, VAT number, address), and the customer's own
+   * details so the consumer can render or print the receipt without further
+   * API calls.
+   *
+   * Throws `TiquoAuthError` with code:
+   *   - `RECEIPT_NOT_AVAILABLE` — order doesn't exist for this customer, or
+   *     it isn't paid/completed yet.
+   *   - `NOT_AUTHENTICATED` — no valid session.
+   */
+  async getReceipt(orderId) {
+    await this.ensureValidToken();
+    this.log("Fetching receipt for order:", orderId);
+    const url = new URL(`${this.config.apiEndpoint}/api/client/v1/receipt`);
+    url.searchParams.set("orderId", orderId);
+    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 get receipt" }));
+      const code = response.status === 404 ? "RECEIPT_NOT_AVAILABLE" : "GET_RECEIPT_FAILED";
+      throw new TiquoAuthError(error.error || "Failed to get receipt", code, response.status);
+    }
+    const result = await response.json();
+    return result.data;
+  }
   /**
    * Get the authenticated customer's enquiry history
    * Only returns enquiries for the logged-in customer
@@ -1546,6 +1606,8 @@ function useTiquoAuth(auth) {
     updateProfile: (updates) => auth.updateProfile(updates),
     getOrders: (options) => auth.getOrders(options),
     getBookings: (options) => auth.getBookings(options),
+    getUpcomingBookings: (options) => auth.getUpcomingBookings(options),
+    getReceipt: (orderId) => auth.getReceipt(orderId),
     getEnquiries: (options) => auth.getEnquiries(options),
     getIframeToken: (flowId) => auth.getIframeToken(flowId),
     embedCustomerFlow: auth.embedCustomerFlow.bind(auth),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tiquo/dom-package",
-  "version": "1.3.3",
+  "version": "1.4.1",
   "description": "Tiquo SDK for third-party websites - authentication, customer profiles, orders, bookings, and enquiries",
   "sideEffects": true,
   "publishConfig": {