@shoppexio/storefront 1.0.57 → 1.0.59

package/dist/{headless-customer.d.ts → customer.d.cts}

@@ -1,5 +1,14 @@
-import { CustomerLoyaltyRedeemWire, CustomerLoyaltyWire, CustomerPortalAffiliateSummaryWire, CustomerPortalAffiliateCreateLinkWire, CustomerPortalAvatarWire, CustomerPortalDashboardWire, CustomerPortalEmailPreferencesUpdateWire, CustomerPortalEmailPreferencesWire, CustomerPortalFavoriteMutationWire, CustomerPortalFavoritesWire, CustomerPortalLicenseResetWire, CustomerPortalLicenseRenewalWire, CustomerPortalNotificationPreferencesWire, CustomerPortalOrderReviewWire, CustomerPortalProfileUpdateWire, CustomerPortalSubscriptionBillingHistoryWire, CustomerPortalSubscriptionCancelWire, CustomerPortalSubscriptionStatusWire, CustomerPortalSupportCreateWire, CustomerPortalSupportTicketDetailWire, CustomerPortalWalletTopupQuoteWire, CustomerPortalWalletTopupResultWire, CustomerReplacementEligibilityWire, CustomerReplacementRequestWire, CustomerResellerApiKeysWire, CustomerResellerCatalogWire, CustomerResellerEnrollmentWire, CustomerResellerOrderWire, CustomerResellerOrdersWire, CustomerResellerQuoteWire, CustomerResellerSummaryWire, CustomerResellerTopupWire, CustomerResellerWalletWire, CustomerWarrantyClaimWire, CustomerWarrantyListWire } from '@shoppex/contracts/customer-portal-wire';
-export interface HeadlessCustomerClientConfig {
+import { CustomerPortalAffiliateSummaryWire, CustomerPortalAffiliateCreateLinkWire, CustomerPortalAffiliateStatsWire, CustomerPortalAvatarWire, CustomerPortalDashboardWire, CustomerPortalProfileUpdateWire, CustomerPortalEmailPreferencesWire, CustomerPortalEmailPreferencesUpdateWire, CustomerPortalNotificationPreferencesWire, CustomerPortalOrderReviewWire, CustomerReplacementEligibilityWire, CustomerReplacementRequestWire, CustomerPortalLicenseResetWire, CustomerPortalLicenseRenewalWire, CustomerPortalWalletTopupQuoteWire, CustomerPortalWalletTopupResultWire, CustomerPortalSubscriptionBillingHistoryWire, CustomerPortalSubscriptionCancelWire, CustomerPortalSubscriptionStatusWire, CustomerLoyaltyWire, CustomerLoyaltyRedeemWire, CustomerWarrantyListWire, CustomerWarrantyClaimWire, CustomerPortalFavoritesWire, CustomerPortalFavoriteMutationWire, CustomerPortalSupportCreateWire, CustomerPortalSupportTicketDetailWire, CustomerResellerSummaryWire, CustomerResellerEnrollmentWire, CustomerResellerCatalogWire, CustomerResellerQuoteWire, CustomerResellerOrdersWire, CustomerResellerOrderWire, CustomerResellerWalletWire, CustomerResellerTopupWire, CustomerResellerApiKeysWire } from '@shoppex/contracts/customer-portal-wire';
+
+/**
+ * Browser client for a customer account hosted outside Shoppex.
+ *
+ * The publishable key identifies the merchant and the dashboard origin
+ * allowlist authorizes the browser origin. OTP verification returns a separate
+ * short-lived `hcs_` token; the SDK never exposes Shoppex's BetterAuth token.
+ */
+
+interface HeadlessCustomerClientConfig {
     /** Shop slug or Shoppex storefront domain. */
     shop: string;
     /** Existing Headless Checkout publishable key (`pk_live_` / `pk_test_`). */
@@ -13,21 +22,21 @@ export interface HeadlessCustomerClientConfig {
     /** Optional persistent storage override. Defaults to browser localStorage. */
     persistentStorage?: Pick<Storage, 'getItem' | 'setItem' | 'removeItem'>;
 }
-export interface HeadlessCustomerSession {
+interface HeadlessCustomerSession {
     accessToken: string;
     expiresAt: string;
 }
-export interface HeadlessCustomerVerifyOptions {
+interface HeadlessCustomerVerifyOptions {
     /** Persist the customer session across browser restarts for up to 30 days. */
     rememberMe?: boolean;
 }
-export interface HeadlessCustomerOrdersQuery {
+interface HeadlessCustomerOrdersQuery {
     page?: number;
     limit?: number;
     status?: string;
     search?: string;
 }
-export interface HeadlessCustomerDownload {
+interface HeadlessCustomerDownload {
     blob: Blob;
     filename: string | null;
     contentType: string | null;
@@ -36,96 +45,97 @@ type HeadlessCustomerDashboardDeliverable = CustomerPortalDashboardWire['deliver
     /** Pass this value with `invoice_uniqid` to `customer.download()`. */
     downloadIndex?: number | null;
 };
-export type HeadlessCustomerDashboard = Omit<CustomerPortalDashboardWire, 'deliverables'> & {
+type HeadlessCustomerDashboard = Omit<CustomerPortalDashboardWire, 'deliverables'> & {
     deliverables: HeadlessCustomerDashboardDeliverable[];
 };
-export type HeadlessCustomerProfileUpdate = CustomerPortalProfileUpdateWire;
-export type HeadlessCustomerAvatar = CustomerPortalAvatarWire;
-export type HeadlessCustomerEmailPreferences = CustomerPortalEmailPreferencesWire;
-export type HeadlessCustomerEmailPreferencesUpdate = CustomerPortalEmailPreferencesUpdateWire;
-export type HeadlessCustomerNotificationPreferences = CustomerPortalNotificationPreferencesWire;
-export type HeadlessCustomerOrderReview = CustomerPortalOrderReviewWire;
-export type HeadlessCustomerFavorites = CustomerPortalFavoritesWire;
-export type HeadlessCustomerFavoriteMutation = CustomerPortalFavoriteMutationWire;
-export type HeadlessCustomerAffiliate = CustomerPortalAffiliateSummaryWire;
-export type HeadlessCustomerAffiliateLink = CustomerPortalAffiliateCreateLinkWire;
-export type HeadlessCustomerTicket = CustomerPortalSupportTicketDetailWire;
-export type HeadlessCustomerTicketCreateResult = CustomerPortalSupportCreateWire;
-export type HeadlessCustomerLicenseReset = CustomerPortalLicenseResetWire;
-export type HeadlessCustomerLicenseRenewal = CustomerPortalLicenseRenewalWire;
-export type HeadlessCustomerWalletTopupQuote = CustomerPortalWalletTopupQuoteWire;
-export type HeadlessCustomerWalletTopup = CustomerPortalWalletTopupResultWire;
-export type HeadlessCustomerSubscriptionBillingHistory = CustomerPortalSubscriptionBillingHistoryWire;
-export type HeadlessCustomerSubscriptionCancel = CustomerPortalSubscriptionCancelWire;
-export type HeadlessCustomerSubscriptionStatus = CustomerPortalSubscriptionStatusWire;
-export type HeadlessCustomerLoyalty = CustomerLoyaltyWire;
-export type HeadlessCustomerLoyaltyRedeem = CustomerLoyaltyRedeemWire;
-export type HeadlessCustomerWarranties = CustomerWarrantyListWire;
-export type HeadlessCustomerWarrantyClaim = CustomerWarrantyClaimWire;
-export type HeadlessCustomerReplacementEligibility = CustomerReplacementEligibilityWire;
-export type HeadlessCustomerReplacementRequest = CustomerReplacementRequestWire;
-export type HeadlessCustomerReseller = CustomerResellerSummaryWire;
-export type HeadlessCustomerResellerEnrollment = CustomerResellerEnrollmentWire;
-export type HeadlessCustomerResellerCatalog = CustomerResellerCatalogWire;
-export type HeadlessCustomerResellerQuote = CustomerResellerQuoteWire;
-export type HeadlessCustomerResellerOrders = CustomerResellerOrdersWire;
-export type HeadlessCustomerResellerOrder = CustomerResellerOrderWire;
-export type HeadlessCustomerResellerWallet = CustomerResellerWalletWire;
-export type HeadlessCustomerResellerApiKeys = CustomerResellerApiKeysWire;
-export type HeadlessCustomerResellerTopup = CustomerResellerTopupWire;
-export interface HeadlessCustomerTicketInput {
+type HeadlessCustomerProfileUpdate = CustomerPortalProfileUpdateWire;
+type HeadlessCustomerAvatar = CustomerPortalAvatarWire;
+type HeadlessCustomerEmailPreferences = CustomerPortalEmailPreferencesWire;
+type HeadlessCustomerEmailPreferencesUpdate = CustomerPortalEmailPreferencesUpdateWire;
+type HeadlessCustomerNotificationPreferences = CustomerPortalNotificationPreferencesWire;
+type HeadlessCustomerOrderReview = CustomerPortalOrderReviewWire;
+type HeadlessCustomerFavorites = CustomerPortalFavoritesWire;
+type HeadlessCustomerFavoriteMutation = CustomerPortalFavoriteMutationWire;
+type HeadlessCustomerAffiliate = CustomerPortalAffiliateSummaryWire;
+type HeadlessCustomerAffiliateStats = CustomerPortalAffiliateStatsWire;
+type HeadlessCustomerAffiliateLink = CustomerPortalAffiliateCreateLinkWire;
+type HeadlessCustomerTicket = CustomerPortalSupportTicketDetailWire;
+type HeadlessCustomerTicketCreateResult = CustomerPortalSupportCreateWire;
+type HeadlessCustomerLicenseReset = CustomerPortalLicenseResetWire;
+type HeadlessCustomerLicenseRenewal = CustomerPortalLicenseRenewalWire;
+type HeadlessCustomerWalletTopupQuote = CustomerPortalWalletTopupQuoteWire;
+type HeadlessCustomerWalletTopup = CustomerPortalWalletTopupResultWire;
+type HeadlessCustomerSubscriptionBillingHistory = CustomerPortalSubscriptionBillingHistoryWire;
+type HeadlessCustomerSubscriptionCancel = CustomerPortalSubscriptionCancelWire;
+type HeadlessCustomerSubscriptionStatus = CustomerPortalSubscriptionStatusWire;
+type HeadlessCustomerLoyalty = CustomerLoyaltyWire;
+type HeadlessCustomerLoyaltyRedeem = CustomerLoyaltyRedeemWire;
+type HeadlessCustomerWarranties = CustomerWarrantyListWire;
+type HeadlessCustomerWarrantyClaim = CustomerWarrantyClaimWire;
+type HeadlessCustomerReplacementEligibility = CustomerReplacementEligibilityWire;
+type HeadlessCustomerReplacementRequest = CustomerReplacementRequestWire;
+type HeadlessCustomerReseller = CustomerResellerSummaryWire;
+type HeadlessCustomerResellerEnrollment = CustomerResellerEnrollmentWire;
+type HeadlessCustomerResellerCatalog = CustomerResellerCatalogWire;
+type HeadlessCustomerResellerQuote = CustomerResellerQuoteWire;
+type HeadlessCustomerResellerOrders = CustomerResellerOrdersWire;
+type HeadlessCustomerResellerOrder = CustomerResellerOrderWire;
+type HeadlessCustomerResellerWallet = CustomerResellerWalletWire;
+type HeadlessCustomerResellerApiKeys = CustomerResellerApiKeysWire;
+type HeadlessCustomerResellerTopup = CustomerResellerTopupWire;
+interface HeadlessCustomerTicketInput {
     title?: string;
     message: string;
     invoiceId?: string;
 }
-export interface HeadlessCustomerOrderReviewInput {
+interface HeadlessCustomerOrderReviewInput {
     score: 1 | 3 | 5;
     message: string;
 }
-export interface HeadlessCustomerAffiliateLinkInput {
+interface HeadlessCustomerAffiliateLinkInput {
     code: string;
     label: string;
     requestedRevenuePercent?: number | null;
     requestedCustomerDiscountPercent?: number | null;
 }
-export interface HeadlessCustomerSubscriptionCancelOptions {
+interface HeadlessCustomerSubscriptionCancelOptions {
     cancelAtPeriodEnd?: boolean;
     reason?: string | null;
 }
-export interface HeadlessCustomerEmailPreferencesPatch {
+interface HeadlessCustomerEmailPreferencesPatch {
     globalUnsubscribed?: boolean;
     listSubscriptions?: Array<{
         listId: string;
         subscribed: boolean;
     }>;
 }
-export interface HeadlessCustomerNotificationPreferencesPatch {
+interface HeadlessCustomerNotificationPreferencesPatch {
     orderCreatedEmails?: boolean;
     orderCompletedEmails?: boolean;
     paymentIssueEmails?: boolean;
 }
-export interface HeadlessCustomerReplacementOptions {
+interface HeadlessCustomerReplacementOptions {
     lineItemId?: string | null;
     reason: string;
     idempotencyKey?: string;
 }
-export interface HeadlessCustomerResellerCatalogQuery {
+interface HeadlessCustomerResellerCatalogQuery {
     search?: string;
     page?: number;
     perPage?: number;
 }
-export interface HeadlessCustomerResellerOrdersQuery {
+interface HeadlessCustomerResellerOrdersQuery {
     page?: number;
     perPage?: number;
 }
-export interface HeadlessCustomerResellerOrderItem {
+interface HeadlessCustomerResellerOrderItem {
     productId: string;
     variantId?: string;
     quantity: number;
 }
 /** Public DTOs mirror the producer-owned schemas imported above. Passing each
  * schema into `request<T>` makes TypeScript reject drift in required fields. */
-export interface HeadlessCustomerMe {
+interface HeadlessCustomerMe {
     customer: {
         id: string | null;
         email: string;
@@ -146,7 +156,7 @@ export interface HeadlessCustomerMe {
         };
     };
 }
-export interface HeadlessCustomerOrderSummary {
+interface HeadlessCustomerOrderSummary {
     uniqid: string;
     status: string;
     total: string;
@@ -163,7 +173,7 @@ export interface HeadlessCustomerOrderSummary {
         } | null;
     }>;
 }
-export interface HeadlessCustomerOrders {
+interface HeadlessCustomerOrders {
     invoices: HeadlessCustomerOrderSummary[];
     pagination: {
         page: number;
@@ -172,7 +182,7 @@ export interface HeadlessCustomerOrders {
         has_more: boolean;
     };
 }
-export interface HeadlessCustomerPayment {
+interface HeadlessCustomerPayment {
     gateway: string;
     displayName: string | null;
     cryptoGateway?: string | null;
@@ -180,7 +190,7 @@ export interface HeadlessCustomerPayment {
     cryptoAddress: string | null;
     apmMethod: string | null;
 }
-export interface HeadlessCustomerOrder {
+interface HeadlessCustomerOrder {
     id: string;
     uniqid: string;
     status: string;
@@ -240,12 +250,12 @@ export interface HeadlessCustomerOrder {
     currentPayment: HeadlessCustomerPayment | null;
     payments: HeadlessCustomerPayment[];
 }
-export declare class HeadlessCustomerError extends Error {
+declare class HeadlessCustomerError extends Error {
     readonly status: number;
     readonly code?: string | null | undefined;
     constructor(status: number, message: string, code?: string | null | undefined);
 }
-export declare class HeadlessCustomerClient {
+declare class HeadlessCustomerClient {
     private readonly base;
     private readonly shop;
     private readonly publishableKey;
@@ -303,6 +313,9 @@ export declare class HeadlessCustomerClient {
     addFavorite(productId: string): Promise<HeadlessCustomerFavoriteMutation>;
     removeFavorite(productId: string): Promise<HeadlessCustomerFavoriteMutation>;
     affiliate(): Promise<HeadlessCustomerAffiliate>;
+    affiliateStats(input?: {
+        days?: number;
+    }): Promise<HeadlessCustomerAffiliateStats>;
     createAffiliateLink(input: HeadlessCustomerAffiliateLinkInput): Promise<HeadlessCustomerAffiliateLink>;
     createTicket(input: HeadlessCustomerTicketInput): Promise<HeadlessCustomerTicketCreateResult>;
     ticket(ticketId: string): Promise<HeadlessCustomerTicket>;
@@ -321,6 +334,6 @@ export declare class HeadlessCustomerClient {
     resellerApiKeys(): Promise<HeadlessCustomerResellerApiKeys>;
     logout(): Promise<void>;
 }
-export declare function createCustomerClient(config: HeadlessCustomerClientConfig): HeadlessCustomerClient;
-export {};
-//# sourceMappingURL=headless-customer.d.ts.map
+declare function createCustomerClient(config: HeadlessCustomerClientConfig): HeadlessCustomerClient;
+
+export { type HeadlessCustomerAffiliate, type HeadlessCustomerAffiliateLink, type HeadlessCustomerAffiliateLinkInput, type HeadlessCustomerAffiliateStats, type HeadlessCustomerAvatar, HeadlessCustomerClient, type HeadlessCustomerClientConfig, type HeadlessCustomerDashboard, type HeadlessCustomerDownload, type HeadlessCustomerEmailPreferences, type HeadlessCustomerEmailPreferencesPatch, type HeadlessCustomerEmailPreferencesUpdate, HeadlessCustomerError, type HeadlessCustomerFavoriteMutation, type HeadlessCustomerFavorites, type HeadlessCustomerLicenseRenewal, type HeadlessCustomerLicenseReset, type HeadlessCustomerLoyalty, type HeadlessCustomerLoyaltyRedeem, type HeadlessCustomerMe, type HeadlessCustomerNotificationPreferences, type HeadlessCustomerNotificationPreferencesPatch, type HeadlessCustomerOrder, type HeadlessCustomerOrderReview, type HeadlessCustomerOrderReviewInput, type HeadlessCustomerOrderSummary, type HeadlessCustomerOrders, type HeadlessCustomerOrdersQuery, type HeadlessCustomerPayment, type HeadlessCustomerProfileUpdate, type HeadlessCustomerReplacementEligibility, type HeadlessCustomerReplacementOptions, type HeadlessCustomerReplacementRequest, type HeadlessCustomerReseller, type HeadlessCustomerResellerApiKeys, type HeadlessCustomerResellerCatalog, type HeadlessCustomerResellerCatalogQuery, type HeadlessCustomerResellerEnrollment, type HeadlessCustomerResellerOrder, type HeadlessCustomerResellerOrderItem, type HeadlessCustomerResellerOrders, type HeadlessCustomerResellerOrdersQuery, type HeadlessCustomerResellerQuote, type HeadlessCustomerResellerTopup, type HeadlessCustomerResellerWallet, type HeadlessCustomerSession, type HeadlessCustomerSubscriptionBillingHistory, type HeadlessCustomerSubscriptionCancel, type HeadlessCustomerSubscriptionCancelOptions, type HeadlessCustomerSubscriptionStatus, type HeadlessCustomerTicket, type HeadlessCustomerTicketCreateResult, type HeadlessCustomerTicketInput, type HeadlessCustomerVerifyOptions, type HeadlessCustomerWalletTopup, type HeadlessCustomerWalletTopupQuote, type HeadlessCustomerWarranties, type HeadlessCustomerWarrantyClaim, createCustomerClient };

package/dist/customer.d.ts

@@ -1,13 +1,339 @@
+import { CustomerPortalAffiliateSummaryWire, CustomerPortalAffiliateCreateLinkWire, CustomerPortalAffiliateStatsWire, CustomerPortalAvatarWire, CustomerPortalDashboardWire, CustomerPortalProfileUpdateWire, CustomerPortalEmailPreferencesWire, CustomerPortalEmailPreferencesUpdateWire, CustomerPortalNotificationPreferencesWire, CustomerPortalOrderReviewWire, CustomerReplacementEligibilityWire, CustomerReplacementRequestWire, CustomerPortalLicenseResetWire, CustomerPortalLicenseRenewalWire, CustomerPortalWalletTopupQuoteWire, CustomerPortalWalletTopupResultWire, CustomerPortalSubscriptionBillingHistoryWire, CustomerPortalSubscriptionCancelWire, CustomerPortalSubscriptionStatusWire, CustomerLoyaltyWire, CustomerLoyaltyRedeemWire, CustomerWarrantyListWire, CustomerWarrantyClaimWire, CustomerPortalFavoritesWire, CustomerPortalFavoriteMutationWire, CustomerPortalSupportCreateWire, CustomerPortalSupportTicketDetailWire, CustomerResellerSummaryWire, CustomerResellerEnrollmentWire, CustomerResellerCatalogWire, CustomerResellerQuoteWire, CustomerResellerOrdersWire, CustomerResellerOrderWire, CustomerResellerWalletWire, CustomerResellerTopupWire, CustomerResellerApiKeysWire } from '@shoppex/contracts/customer-portal-wire';
+
 /**
- * Public subpath entry for `@shoppexio/storefront/customer`.
+ * Browser client for a customer account hosted outside Shoppex.
  *
- * This package (`packages/sdk`) is the source of the published
- * `@shoppexio/storefront` tarball (scripts/release/
- * publish-internal-theme-runtime-packages.mjs, PACKAGE_CONFIG.sdk), so the
- * documented customer-account import has to be exported HERE.
- * `packages/storefront/src/customer.ts` mirrors the same surface for the
- * standalone storefront-js repo.
+ * The publishable key identifies the merchant and the dashboard origin
+ * allowlist authorizes the browser origin. OTP verification returns a separate
+ * short-lived `hcs_` token; the SDK never exposes Shoppex's BetterAuth token.
  */
-export { createCustomerClient, HeadlessCustomerClient, HeadlessCustomerError, } from './headless-customer.js';
-export type * from './headless-customer.js';
-//# sourceMappingURL=customer.d.ts.map
+
+interface HeadlessCustomerClientConfig {
+    /** Shop slug or Shoppex storefront domain. */
+    shop: string;
+    /** Existing Headless Checkout publishable key (`pk_live_` / `pk_test_`). */
+    publishableKey: string;
+    /** API origin override. Defaults to https://api.shoppex.io. */
+    apiBaseUrl?: string;
+    /** Optional fetch override for tests or compatible runtimes. */
+    fetchImpl?: typeof fetch;
+    /** Optional session storage override. Defaults to browser sessionStorage. */
+    storage?: Pick<Storage, 'getItem' | 'setItem' | 'removeItem'>;
+    /** Optional persistent storage override. Defaults to browser localStorage. */
+    persistentStorage?: Pick<Storage, 'getItem' | 'setItem' | 'removeItem'>;
+}
+interface HeadlessCustomerSession {
+    accessToken: string;
+    expiresAt: string;
+}
+interface HeadlessCustomerVerifyOptions {
+    /** Persist the customer session across browser restarts for up to 30 days. */
+    rememberMe?: boolean;
+}
+interface HeadlessCustomerOrdersQuery {
+    page?: number;
+    limit?: number;
+    status?: string;
+    search?: string;
+}
+interface HeadlessCustomerDownload {
+    blob: Blob;
+    filename: string | null;
+    contentType: string | null;
+}
+type HeadlessCustomerDashboardDeliverable = CustomerPortalDashboardWire['deliverables'][number] & {
+    /** Pass this value with `invoice_uniqid` to `customer.download()`. */
+    downloadIndex?: number | null;
+};
+type HeadlessCustomerDashboard = Omit<CustomerPortalDashboardWire, 'deliverables'> & {
+    deliverables: HeadlessCustomerDashboardDeliverable[];
+};
+type HeadlessCustomerProfileUpdate = CustomerPortalProfileUpdateWire;
+type HeadlessCustomerAvatar = CustomerPortalAvatarWire;
+type HeadlessCustomerEmailPreferences = CustomerPortalEmailPreferencesWire;
+type HeadlessCustomerEmailPreferencesUpdate = CustomerPortalEmailPreferencesUpdateWire;
+type HeadlessCustomerNotificationPreferences = CustomerPortalNotificationPreferencesWire;
+type HeadlessCustomerOrderReview = CustomerPortalOrderReviewWire;
+type HeadlessCustomerFavorites = CustomerPortalFavoritesWire;
+type HeadlessCustomerFavoriteMutation = CustomerPortalFavoriteMutationWire;
+type HeadlessCustomerAffiliate = CustomerPortalAffiliateSummaryWire;
+type HeadlessCustomerAffiliateStats = CustomerPortalAffiliateStatsWire;
+type HeadlessCustomerAffiliateLink = CustomerPortalAffiliateCreateLinkWire;
+type HeadlessCustomerTicket = CustomerPortalSupportTicketDetailWire;
+type HeadlessCustomerTicketCreateResult = CustomerPortalSupportCreateWire;
+type HeadlessCustomerLicenseReset = CustomerPortalLicenseResetWire;
+type HeadlessCustomerLicenseRenewal = CustomerPortalLicenseRenewalWire;
+type HeadlessCustomerWalletTopupQuote = CustomerPortalWalletTopupQuoteWire;
+type HeadlessCustomerWalletTopup = CustomerPortalWalletTopupResultWire;
+type HeadlessCustomerSubscriptionBillingHistory = CustomerPortalSubscriptionBillingHistoryWire;
+type HeadlessCustomerSubscriptionCancel = CustomerPortalSubscriptionCancelWire;
+type HeadlessCustomerSubscriptionStatus = CustomerPortalSubscriptionStatusWire;
+type HeadlessCustomerLoyalty = CustomerLoyaltyWire;
+type HeadlessCustomerLoyaltyRedeem = CustomerLoyaltyRedeemWire;
+type HeadlessCustomerWarranties = CustomerWarrantyListWire;
+type HeadlessCustomerWarrantyClaim = CustomerWarrantyClaimWire;
+type HeadlessCustomerReplacementEligibility = CustomerReplacementEligibilityWire;
+type HeadlessCustomerReplacementRequest = CustomerReplacementRequestWire;
+type HeadlessCustomerReseller = CustomerResellerSummaryWire;
+type HeadlessCustomerResellerEnrollment = CustomerResellerEnrollmentWire;
+type HeadlessCustomerResellerCatalog = CustomerResellerCatalogWire;
+type HeadlessCustomerResellerQuote = CustomerResellerQuoteWire;
+type HeadlessCustomerResellerOrders = CustomerResellerOrdersWire;
+type HeadlessCustomerResellerOrder = CustomerResellerOrderWire;
+type HeadlessCustomerResellerWallet = CustomerResellerWalletWire;
+type HeadlessCustomerResellerApiKeys = CustomerResellerApiKeysWire;
+type HeadlessCustomerResellerTopup = CustomerResellerTopupWire;
+interface HeadlessCustomerTicketInput {
+    title?: string;
+    message: string;
+    invoiceId?: string;
+}
+interface HeadlessCustomerOrderReviewInput {
+    score: 1 | 3 | 5;
+    message: string;
+}
+interface HeadlessCustomerAffiliateLinkInput {
+    code: string;
+    label: string;
+    requestedRevenuePercent?: number | null;
+    requestedCustomerDiscountPercent?: number | null;
+}
+interface HeadlessCustomerSubscriptionCancelOptions {
+    cancelAtPeriodEnd?: boolean;
+    reason?: string | null;
+}
+interface HeadlessCustomerEmailPreferencesPatch {
+    globalUnsubscribed?: boolean;
+    listSubscriptions?: Array<{
+        listId: string;
+        subscribed: boolean;
+    }>;
+}
+interface HeadlessCustomerNotificationPreferencesPatch {
+    orderCreatedEmails?: boolean;
+    orderCompletedEmails?: boolean;
+    paymentIssueEmails?: boolean;
+}
+interface HeadlessCustomerReplacementOptions {
+    lineItemId?: string | null;
+    reason: string;
+    idempotencyKey?: string;
+}
+interface HeadlessCustomerResellerCatalogQuery {
+    search?: string;
+    page?: number;
+    perPage?: number;
+}
+interface HeadlessCustomerResellerOrdersQuery {
+    page?: number;
+    perPage?: number;
+}
+interface HeadlessCustomerResellerOrderItem {
+    productId: string;
+    variantId?: string;
+    quantity: number;
+}
+/** Public DTOs mirror the producer-owned schemas imported above. Passing each
+ * schema into `request<T>` makes TypeScript reject drift in required fields. */
+interface HeadlessCustomerMe {
+    customer: {
+        id: string | null;
+        email: string;
+        name: string;
+        avatar_url: string | null;
+        joined_at: string | null;
+    };
+    shop: {
+        id: string;
+        slug: string;
+        name: string;
+        currency: string;
+        branding: {
+            logo_url: string | null;
+            primary_color: string;
+            secondary_color: string;
+            accent_color: string;
+        };
+    };
+}
+interface HeadlessCustomerOrderSummary {
+    uniqid: string;
+    status: string;
+    total: string;
+    totalDisplay: string | null;
+    currency: string;
+    createdAt: string;
+    lineItems: Array<{
+        productTitle: string | null;
+        quantity: number;
+        product: {
+            attachment_imageId: {
+                cloudflareImageId: string | null;
+            } | null;
+        } | null;
+    }>;
+}
+interface HeadlessCustomerOrders {
+    invoices: HeadlessCustomerOrderSummary[];
+    pagination: {
+        page: number;
+        limit: number;
+        total: number;
+        has_more: boolean;
+    };
+}
+interface HeadlessCustomerPayment {
+    gateway: string;
+    displayName: string | null;
+    cryptoGateway?: string | null;
+    blockchain: string | null;
+    cryptoAddress: string | null;
+    apmMethod: string | null;
+}
+interface HeadlessCustomerOrder {
+    id: string;
+    uniqid: string;
+    status: string;
+    statusDetails: string | null;
+    total: string;
+    totalDisplay: string | null;
+    subtotal: string;
+    discount: string;
+    discountDisplay: string | null;
+    tax: string;
+    taxPercentage: string;
+    currency: string;
+    createdAt: string;
+    updatedAt: string;
+    gatewayUpdatedAt: string | null;
+    customFields: Record<string, unknown> | null;
+    balancePaidAmount: string;
+    currentPaymentAttemptId: string | null;
+    lineItems: Array<{
+        id: string;
+        productTitle: string;
+        productType: string;
+        variantTitle: string | null;
+        unitPrice: string;
+        quantity: number;
+        total: string;
+        deliveryText: string | null;
+        deliverySummary: {
+            codes: string[];
+            links: Array<{
+                label: string;
+                value: string;
+                /** External URL for non-Shoppex links. Portal-only download URLs are removed. */
+                href?: string | null;
+                /** Pass this value to `customer.download(orderId, downloadIndex)`. */
+                downloadIndex?: number | null;
+            }>;
+            notes: string[];
+            serials: Array<{
+                value: string;
+                is_replacement: boolean;
+                is_replaced: boolean;
+            }>;
+        } | null;
+        deliveredAt: string | null;
+        deliveryStatus: 'PENDING' | 'AWAITING_FULFILLMENT' | 'DELIVERED' | 'FAILED';
+        customFields: Record<string, unknown> | null;
+        product: {
+            uniqid: string;
+            slug: string | null;
+            serviceText: string | null;
+            attachment_imageId: {
+                cloudflareImageId: string | null;
+            } | null;
+        } | null;
+    }>;
+    currentPayment: HeadlessCustomerPayment | null;
+    payments: HeadlessCustomerPayment[];
+}
+declare class HeadlessCustomerError extends Error {
+    readonly status: number;
+    readonly code?: string | null | undefined;
+    constructor(status: number, message: string, code?: string | null | undefined);
+}
+declare class HeadlessCustomerClient {
+    private readonly base;
+    private readonly shop;
+    private readonly publishableKey;
+    private readonly fetchImpl;
+    private readonly storage;
+    private readonly persistentStorage;
+    private readonly storageKey;
+    private memorySession;
+    constructor(config: HeadlessCustomerClientConfig);
+    getSession(): HeadlessCustomerSession | null;
+    clearSession(): void;
+    private saveSession;
+    private url;
+    private request;
+    private requestFile;
+    requestOtp(email: string): Promise<{
+        requested: boolean;
+    }>;
+    verifyOtp(email: string, otp: string, options?: HeadlessCustomerVerifyOptions): Promise<HeadlessCustomerSession>;
+    me(): Promise<HeadlessCustomerMe>;
+    dashboard(): Promise<HeadlessCustomerDashboard>;
+    updateProfile(input: {
+        name: string;
+    }): Promise<HeadlessCustomerProfileUpdate>;
+    updateAvatar(file: File): Promise<HeadlessCustomerAvatar>;
+    removeAvatar(): Promise<HeadlessCustomerAvatar>;
+    emailPreferences(): Promise<HeadlessCustomerEmailPreferences>;
+    updateEmailPreferences(patch: HeadlessCustomerEmailPreferencesPatch): Promise<HeadlessCustomerEmailPreferencesUpdate>;
+    notificationPreferences(): Promise<HeadlessCustomerNotificationPreferences>;
+    updateNotificationPreferences(patch: HeadlessCustomerNotificationPreferencesPatch): Promise<HeadlessCustomerNotificationPreferences>;
+    orders(options?: HeadlessCustomerOrdersQuery): Promise<HeadlessCustomerOrders>;
+    order(id: string): Promise<HeadlessCustomerOrder>;
+    orderReview(orderId: string): Promise<HeadlessCustomerOrderReview>;
+    submitOrderReview(orderId: string, input: HeadlessCustomerOrderReviewInput): Promise<HeadlessCustomerOrderReview>;
+    invoicePdf(orderId: string): Promise<HeadlessCustomerDownload>;
+    replacementEligibility(orderId: string, lineItemId?: string): Promise<HeadlessCustomerReplacementEligibility>;
+    requestReplacement(orderId: string, options: HeadlessCustomerReplacementOptions): Promise<HeadlessCustomerReplacementRequest>;
+    download(orderId: string, fileIndex: number): Promise<HeadlessCustomerDownload>;
+    resetLicenseHwid(licenseId: string): Promise<HeadlessCustomerLicenseReset>;
+    renewLicense(licenseId: string): Promise<HeadlessCustomerLicenseRenewal>;
+    walletTopupQuote(): Promise<HeadlessCustomerWalletTopupQuote>;
+    createWalletTopup(amount: string): Promise<HeadlessCustomerWalletTopup>;
+    subscriptionBillingHistory(subscriptionId: string): Promise<HeadlessCustomerSubscriptionBillingHistory>;
+    cancelSubscription(subscriptionId: string, options?: HeadlessCustomerSubscriptionCancelOptions): Promise<HeadlessCustomerSubscriptionCancel>;
+    pauseSubscription(subscriptionId: string): Promise<HeadlessCustomerSubscriptionStatus>;
+    resumeSubscription(subscriptionId: string): Promise<HeadlessCustomerSubscriptionStatus>;
+    loyalty(): Promise<HeadlessCustomerLoyalty>;
+    redeemLoyaltyPoints(input: {
+        points: number;
+        idempotencyKey: string;
+    }): Promise<HeadlessCustomerLoyaltyRedeem>;
+    warranties(invoiceId?: string): Promise<HeadlessCustomerWarranties>;
+    claimWarranty(warrantyId: string, message?: string): Promise<HeadlessCustomerWarrantyClaim>;
+    favorites(): Promise<HeadlessCustomerFavorites>;
+    addFavorite(productId: string): Promise<HeadlessCustomerFavoriteMutation>;
+    removeFavorite(productId: string): Promise<HeadlessCustomerFavoriteMutation>;
+    affiliate(): Promise<HeadlessCustomerAffiliate>;
+    affiliateStats(input?: {
+        days?: number;
+    }): Promise<HeadlessCustomerAffiliateStats>;
+    createAffiliateLink(input: HeadlessCustomerAffiliateLinkInput): Promise<HeadlessCustomerAffiliateLink>;
+    createTicket(input: HeadlessCustomerTicketInput): Promise<HeadlessCustomerTicketCreateResult>;
+    ticket(ticketId: string): Promise<HeadlessCustomerTicket>;
+    replyToTicket(ticketId: string, message: string): Promise<void>;
+    reseller(): Promise<HeadlessCustomerReseller>;
+    applyForReseller(note?: string): Promise<HeadlessCustomerResellerEnrollment>;
+    enrollAsReseller(): Promise<HeadlessCustomerResellerEnrollment>;
+    acceptResellerInvite(token: string): Promise<HeadlessCustomerResellerEnrollment>;
+    resellerCatalog(options?: HeadlessCustomerResellerCatalogQuery): Promise<HeadlessCustomerResellerCatalog>;
+    quoteResellerOrder(items: HeadlessCustomerResellerOrderItem[]): Promise<HeadlessCustomerResellerQuote>;
+    resellerOrders(options?: HeadlessCustomerResellerOrdersQuery): Promise<HeadlessCustomerResellerOrders>;
+    resellerOrder(orderId: string): Promise<HeadlessCustomerResellerOrder>;
+    resellerWallet(): Promise<HeadlessCustomerResellerWallet>;
+    resellerTopupQuote(): Promise<HeadlessCustomerWalletTopupQuote>;
+    createResellerTopup(amount: string): Promise<HeadlessCustomerResellerTopup>;
+    resellerApiKeys(): Promise<HeadlessCustomerResellerApiKeys>;
+    logout(): Promise<void>;
+}
+declare function createCustomerClient(config: HeadlessCustomerClientConfig): HeadlessCustomerClient;
+
+export { type HeadlessCustomerAffiliate, type HeadlessCustomerAffiliateLink, type HeadlessCustomerAffiliateLinkInput, type HeadlessCustomerAffiliateStats, type HeadlessCustomerAvatar, HeadlessCustomerClient, type HeadlessCustomerClientConfig, type HeadlessCustomerDashboard, type HeadlessCustomerDownload, type HeadlessCustomerEmailPreferences, type HeadlessCustomerEmailPreferencesPatch, type HeadlessCustomerEmailPreferencesUpdate, HeadlessCustomerError, type HeadlessCustomerFavoriteMutation, type HeadlessCustomerFavorites, type HeadlessCustomerLicenseRenewal, type HeadlessCustomerLicenseReset, type HeadlessCustomerLoyalty, type HeadlessCustomerLoyaltyRedeem, type HeadlessCustomerMe, type HeadlessCustomerNotificationPreferences, type HeadlessCustomerNotificationPreferencesPatch, type HeadlessCustomerOrder, type HeadlessCustomerOrderReview, type HeadlessCustomerOrderReviewInput, type HeadlessCustomerOrderSummary, type HeadlessCustomerOrders, type HeadlessCustomerOrdersQuery, type HeadlessCustomerPayment, type HeadlessCustomerProfileUpdate, type HeadlessCustomerReplacementEligibility, type HeadlessCustomerReplacementOptions, type HeadlessCustomerReplacementRequest, type HeadlessCustomerReseller, type HeadlessCustomerResellerApiKeys, type HeadlessCustomerResellerCatalog, type HeadlessCustomerResellerCatalogQuery, type HeadlessCustomerResellerEnrollment, type HeadlessCustomerResellerOrder, type HeadlessCustomerResellerOrderItem, type HeadlessCustomerResellerOrders, type HeadlessCustomerResellerOrdersQuery, type HeadlessCustomerResellerQuote, type HeadlessCustomerResellerTopup, type HeadlessCustomerResellerWallet, type HeadlessCustomerSession, type HeadlessCustomerSubscriptionBillingHistory, type HeadlessCustomerSubscriptionCancel, type HeadlessCustomerSubscriptionCancelOptions, type HeadlessCustomerSubscriptionStatus, type HeadlessCustomerTicket, type HeadlessCustomerTicketCreateResult, type HeadlessCustomerTicketInput, type HeadlessCustomerVerifyOptions, type HeadlessCustomerWalletTopup, type HeadlessCustomerWalletTopupQuote, type HeadlessCustomerWarranties, type HeadlessCustomerWarrantyClaim, createCustomerClient };