@tiquo/dom-package 1.5.2 → 1.6.0

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.
@@ -264,6 +277,32 @@ const page2 = await auth.getEnquiries({ limit: 10, cursor: page1.nextCursor });
 - `hasMore` - Whether there are more enquiries to fetch
 - `nextCursor` - Cursor for the next page (if `hasMore` is true)
 
+#### `createEnquiry(input): Promise<CreateEnquiryResult>`
+
+Create an enquiry from your website. `customer.email` is required. If the visitor is authenticated, the enquiry is attached to that customer. Otherwise the SDK uses your public key and allowed domain configuration, finds or creates a customer by email, and attaches the enquiry.
+
+Submitted customer fields fill missing profile data only; existing names, phones, and customer parameter values are not overwritten.
+
+```typescript
+const { enquiry, customer } = await auth.createEnquiry({
+  customer: {
+    email: 'customer@example.com',
+    firstName: 'Sam',
+    lastName: 'Taylor',
+    phone: '+44 7911 123456',
+    details: {
+      system_marketing_opt_in: true,
+    },
+  },
+  enquiry: {
+    subject: 'Private event request',
+    message: 'I would like to enquire about availability next Friday.',
+    category: 'events',
+    priority: 'medium',
+  },
+});
+```
+
 #### `destroy(): void`
 
 Clean up resources when destroying the auth instance. Call this when your component unmounts or when you no longer need the auth instance.

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;
@@ -611,6 +622,40 @@ interface GetEnquiriesResult {
     hasMore: boolean;
     nextCursor?: string;
 }
+interface CreateEnquiryCustomerData {
+    /** Required. Used to find or create the customer profile for this enquiry. */
+    email: string;
+    firstName?: string;
+    lastName?: string;
+    /**
+     * Primary phone number in E.164 format. The SDK auto-normalizes common
+     * formats before submission.
+     */
+    phone?: string;
+    /**
+     * Additional customer parameter values keyed by system parameter id
+     * (`system_marketing_opt_in`) or customer parameter schema id. Existing
+     * non-empty values are not overwritten.
+     */
+    details?: Record<string, string | number | boolean | null>;
+}
+interface CreateEnquiryData {
+    customer: CreateEnquiryCustomerData;
+    enquiry: {
+        type?: string;
+        subject?: string;
+        /** Required unless `subject` is supplied. */
+        message?: string;
+        category?: string;
+        priority?: "low" | "medium" | "high" | "urgent";
+        source?: "online" | "website" | "phone" | "email" | "walk_in" | "social" | "referral" | "pos" | "admin";
+    };
+}
+interface CreateEnquiryResult {
+    success: boolean;
+    enquiry: TiquoEnquiry;
+    customer: TiquoCustomer;
+}
 type TiquoCompanyRelationship = "employee" | "contractor" | "manager" | "executive" | "owner" | "contact" | "other";
 /**
  * The authenticated customer's membership in a company. Each company the
@@ -772,6 +817,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
@@ -805,6 +857,18 @@ declare class TiquoAuth {
      * Only returns enquiries for the logged-in customer
      */
     getEnquiries(options?: GetEnquiriesOptions): Promise<GetEnquiriesResult>;
+    /**
+     * Create a new enquiry through the DOM package.
+     *
+     * `customer.email` is required. If the current browser has an authenticated
+     * DOM session, the enquiry is associated with that customer. Otherwise the
+     * public key and allowed-domain configuration are used to accept the
+     * submission, find or create a customer by email, and attach the enquiry.
+     *
+     * Submitted customer details fill missing customer profile fields only; they
+     * do not overwrite existing profile data.
+     */
+    createEnquiry(input: CreateEnquiryData): Promise<CreateEnquiryResult>;
     /**
      * Get the companies the authenticated customer belongs to.
      *
@@ -928,6 +992,7 @@ declare function useTiquoAuth(auth: TiquoAuth): {
     getUpcomingBookings: (options?: Omit<GetBookingsOptions, "upcoming">) => Promise<GetBookingsResult>;
     getReceipt: (orderId: string) => Promise<TiquoReceipt>;
     getEnquiries: (options?: GetEnquiriesOptions) => Promise<GetEnquiriesResult>;
+    createEnquiry: (input: CreateEnquiryData) => Promise<CreateEnquiryResult>;
     getCompanies: () => Promise<GetCompaniesResult>;
     getCompanyColleagues: (companyId: string) => Promise<GetCompanyColleaguesResult>;
     getIframeToken: (flowId?: string) => Promise<IframeTokenResult>;
@@ -992,4 +1057,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, 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 };
+export { type AuthStateChangeCallback, type CountryPhoneInfo, type CreateEnquiryCustomerData, type CreateEnquiryData, type CreateEnquiryResult, 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

@@ -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;
@@ -611,6 +622,40 @@ interface GetEnquiriesResult {
     hasMore: boolean;
     nextCursor?: string;
 }
+interface CreateEnquiryCustomerData {
+    /** Required. Used to find or create the customer profile for this enquiry. */
+    email: string;
+    firstName?: string;
+    lastName?: string;
+    /**
+     * Primary phone number in E.164 format. The SDK auto-normalizes common
+     * formats before submission.
+     */
+    phone?: string;
+    /**
+     * Additional customer parameter values keyed by system parameter id
+     * (`system_marketing_opt_in`) or customer parameter schema id. Existing
+     * non-empty values are not overwritten.
+     */
+    details?: Record<string, string | number | boolean | null>;
+}
+interface CreateEnquiryData {
+    customer: CreateEnquiryCustomerData;
+    enquiry: {
+        type?: string;
+        subject?: string;
+        /** Required unless `subject` is supplied. */
+        message?: string;
+        category?: string;
+        priority?: "low" | "medium" | "high" | "urgent";
+        source?: "online" | "website" | "phone" | "email" | "walk_in" | "social" | "referral" | "pos" | "admin";
+    };
+}
+interface CreateEnquiryResult {
+    success: boolean;
+    enquiry: TiquoEnquiry;
+    customer: TiquoCustomer;
+}
 type TiquoCompanyRelationship = "employee" | "contractor" | "manager" | "executive" | "owner" | "contact" | "other";
 /**
  * The authenticated customer's membership in a company. Each company the
@@ -772,6 +817,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
@@ -805,6 +857,18 @@ declare class TiquoAuth {
      * Only returns enquiries for the logged-in customer
      */
     getEnquiries(options?: GetEnquiriesOptions): Promise<GetEnquiriesResult>;
+    /**
+     * Create a new enquiry through the DOM package.
+     *
+     * `customer.email` is required. If the current browser has an authenticated
+     * DOM session, the enquiry is associated with that customer. Otherwise the
+     * public key and allowed-domain configuration are used to accept the
+     * submission, find or create a customer by email, and attach the enquiry.
+     *
+     * Submitted customer details fill missing customer profile fields only; they
+     * do not overwrite existing profile data.
+     */
+    createEnquiry(input: CreateEnquiryData): Promise<CreateEnquiryResult>;
     /**
      * Get the companies the authenticated customer belongs to.
      *
@@ -928,6 +992,7 @@ declare function useTiquoAuth(auth: TiquoAuth): {
     getUpcomingBookings: (options?: Omit<GetBookingsOptions, "upcoming">) => Promise<GetBookingsResult>;
     getReceipt: (orderId: string) => Promise<TiquoReceipt>;
     getEnquiries: (options?: GetEnquiriesOptions) => Promise<GetEnquiriesResult>;
+    createEnquiry: (input: CreateEnquiryData) => Promise<CreateEnquiryResult>;
     getCompanies: () => Promise<GetCompaniesResult>;
     getCompanyColleagues: (companyId: string) => Promise<GetCompanyColleaguesResult>;
     getIframeToken: (flowId?: string) => Promise<IframeTokenResult>;
@@ -992,4 +1057,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, 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 };
+export { type AuthStateChangeCallback, type CountryPhoneInfo, type CreateEnquiryCustomerData, type CreateEnquiryData, type CreateEnquiryResult, 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.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
@@ -1563,6 +1593,89 @@ var TiquoAuth = class {
     const result = await response.json();
     return result.data || { enquiries: [], hasMore: false };
   }
+  /**
+   * Create a new enquiry through the DOM package.
+   *
+   * `customer.email` is required. If the current browser has an authenticated
+   * DOM session, the enquiry is associated with that customer. Otherwise the
+   * public key and allowed-domain configuration are used to accept the
+   * submission, find or create a customer by email, and attach the enquiry.
+   *
+   * Submitted customer details fill missing customer profile fields only; they
+   * do not overwrite existing profile data.
+   */
+  async createEnquiry(input) {
+    if (this.accessToken) {
+      await this.refreshTokenIfNeeded();
+    }
+    const customer = { ...input.customer };
+    if (!customer.email?.trim()) {
+      throw new TiquoAuthError(
+        "customer.email is required",
+        "CREATE_ENQUIRY_FAILED"
+      );
+    }
+    if (customer.phone !== void 0 && customer.phone !== "") {
+      const normalized = normalizePhone(customer.phone);
+      const validation = validatePhone(customer.phone);
+      if (!validation.valid) {
+        this.log(
+          "\u26A0\uFE0F Phone validation warning:",
+          validation.reason,
+          "- Original:",
+          customer.phone
+        );
+      }
+      customer.phone = normalized || customer.phone;
+    }
+    const enquiry = { ...input.enquiry };
+    if (!enquiry.message?.trim() && !enquiry.subject?.trim()) {
+      throw new TiquoAuthError(
+        "enquiry.message or enquiry.subject is required",
+        "CREATE_ENQUIRY_FAILED"
+      );
+    }
+    this.log("Creating customer enquiry:", {
+      customer: { ...customer, email: customer.email },
+      enquiry
+    });
+    const response = await this.request("/api/client/v1/enquiries", {
+      method: "POST",
+      headers: {
+        "X-Public-Key": this.config.publicKey
+      },
+      body: JSON.stringify({
+        publicKey: this.config.publicKey,
+        customer,
+        enquiry
+      })
+    });
+    if (!response.ok) {
+      const error = await response.json().catch(() => ({ error: "Failed to create enquiry" }));
+      throw new TiquoAuthError(
+        error.error || "Failed to create enquiry",
+        "CREATE_ENQUIRY_FAILED",
+        response.status
+      );
+    }
+    const result = await response.json();
+    const data = result.data || result;
+    const createdCustomer = data.customer;
+    if (this.session && createdCustomer) {
+      this.session = {
+        ...this.session,
+        customer: createdCustomer
+      };
+      this.notifyListeners();
+      this.broadcastTabSync("SESSION_UPDATE");
+    }
+    this.analytics?.identify({ identityLinkType: "enquiry" }).catch(() => void 0);
+    return {
+      success: true,
+      enquiry: data.enquiry,
+      customer: createdCustomer
+    };
+  }
   /**
    * Get the companies the authenticated customer belongs to.
    *
@@ -2277,6 +2390,7 @@ function useTiquoAuth(auth) {
     getUpcomingBookings: (options) => auth.getUpcomingBookings(options),
     getReceipt: (orderId) => auth.getReceipt(orderId),
     getEnquiries: (options) => auth.getEnquiries(options),
+    createEnquiry: (input) => auth.createEnquiry(input),
     getCompanies: () => auth.getCompanies(),
     getCompanyColleagues: (companyId) => auth.getCompanyColleagues(companyId),
     getIframeToken: (flowId) => auth.getIframeToken(flowId),

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
@@ -1525,6 +1555,89 @@ var TiquoAuth = class {
     const result = await response.json();
     return result.data || { enquiries: [], hasMore: false };
   }
+  /**
+   * Create a new enquiry through the DOM package.
+   *
+   * `customer.email` is required. If the current browser has an authenticated
+   * DOM session, the enquiry is associated with that customer. Otherwise the
+   * public key and allowed-domain configuration are used to accept the
+   * submission, find or create a customer by email, and attach the enquiry.
+   *
+   * Submitted customer details fill missing customer profile fields only; they
+   * do not overwrite existing profile data.
+   */
+  async createEnquiry(input) {
+    if (this.accessToken) {
+      await this.refreshTokenIfNeeded();
+    }
+    const customer = { ...input.customer };
+    if (!customer.email?.trim()) {
+      throw new TiquoAuthError(
+        "customer.email is required",
+        "CREATE_ENQUIRY_FAILED"
+      );
+    }
+    if (customer.phone !== void 0 && customer.phone !== "") {
+      const normalized = normalizePhone(customer.phone);
+      const validation = validatePhone(customer.phone);
+      if (!validation.valid) {
+        this.log(
+          "\u26A0\uFE0F Phone validation warning:",
+          validation.reason,
+          "- Original:",
+          customer.phone
+        );
+      }
+      customer.phone = normalized || customer.phone;
+    }
+    const enquiry = { ...input.enquiry };
+    if (!enquiry.message?.trim() && !enquiry.subject?.trim()) {
+      throw new TiquoAuthError(
+        "enquiry.message or enquiry.subject is required",
+        "CREATE_ENQUIRY_FAILED"
+      );
+    }
+    this.log("Creating customer enquiry:", {
+      customer: { ...customer, email: customer.email },
+      enquiry
+    });
+    const response = await this.request("/api/client/v1/enquiries", {
+      method: "POST",
+      headers: {
+        "X-Public-Key": this.config.publicKey
+      },
+      body: JSON.stringify({
+        publicKey: this.config.publicKey,
+        customer,
+        enquiry
+      })
+    });
+    if (!response.ok) {
+      const error = await response.json().catch(() => ({ error: "Failed to create enquiry" }));
+      throw new TiquoAuthError(
+        error.error || "Failed to create enquiry",
+        "CREATE_ENQUIRY_FAILED",
+        response.status
+      );
+    }
+    const result = await response.json();
+    const data = result.data || result;
+    const createdCustomer = data.customer;
+    if (this.session && createdCustomer) {
+      this.session = {
+        ...this.session,
+        customer: createdCustomer
+      };
+      this.notifyListeners();
+      this.broadcastTabSync("SESSION_UPDATE");
+    }
+    this.analytics?.identify({ identityLinkType: "enquiry" }).catch(() => void 0);
+    return {
+      success: true,
+      enquiry: data.enquiry,
+      customer: createdCustomer
+    };
+  }
   /**
    * Get the companies the authenticated customer belongs to.
    *
@@ -2239,6 +2352,7 @@ function useTiquoAuth(auth) {
     getUpcomingBookings: (options) => auth.getUpcomingBookings(options),
     getReceipt: (orderId) => auth.getReceipt(orderId),
     getEnquiries: (options) => auth.getEnquiries(options),
+    createEnquiry: (input) => auth.createEnquiry(input),
     getCompanies: () => auth.getCompanies(),
     getCompanyColleagues: (companyId) => auth.getCompanyColleagues(companyId),
     getIframeToken: (flowId) => auth.getIframeToken(flowId),

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@tiquo/dom-package",
-  "version": "1.5.2",
+  "version": "1.6.0",
   "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",