@shoppexio/storefront 1.0.90 → 1.0.92

package/dist/index.d.cts

@@ -1,7 +1,8 @@
-import { createApiClient, CustomerWarrantyClaimWire, CustomerPortalDashboardWire, CustomerPortalPaginatedInvoicesWire, CustomerPortalInvoiceDetailWire, CustomerLoyaltyWire, CustomerLoyaltyRedeemWire, CustomerWarrantyListWire } from '@shoppex/contracts';
+import { createApiClient } from '@shoppex/contracts/api-client';
 import { NavigationMenuSlot } from '@shoppex/contracts/navigation';
 export { NavigationMenuSlot } from '@shoppex/contracts/navigation';
 import * as src from 'src';
+import { CustomerWarrantyClaimWire, CustomerPortalAffiliateCreateLinkWire, CustomerPortalDashboardWire, CustomerPortalPaginatedInvoicesWire, CustomerPortalInvoiceDetailWire, CustomerLoyaltyWire, CustomerLoyaltyRedeemWire, CustomerWarrantyListWire, CustomerPortalNotificationPreferencesWire } from '@shoppex/contracts/customer-account-wire';
 export { CATALOG_UNIT_PRICE_DECIMAL_PLACES, CATALOG_UNIT_PRICE_FORMAT_OPTIONS, PAYABLE_AMOUNT_DECIMAL_PLACES, roundPayableAmount } from '@shoppex/contracts/catalog-unit-price';
 
 /**
@@ -14,6 +15,7 @@ interface ShoppexConfig {
     currency?: string;
     apiBaseUrl?: string;
     checkoutBaseUrl?: string;
+    preview: boolean;
 }
 interface ShoppexInitOptions {
     locale?: string;
@@ -29,6 +31,14 @@ interface ShoppexInitOptions {
     apiBaseUrl?: string;
     checkoutBaseUrl?: string;
     shopId?: string;
+    /**
+     * Set on pages that render an unpublished draft (preview links): the page
+     * has no live side effects. The cart (lines, metadata, coupon) lives in this
+     * tab's sessionStorage under `shoppex_cart_<storeSlug>_preview`-style keys,
+     * never in the buyer's localStorage cart, and the SDK sends no presence or
+     * affiliate funnel events.
+     */
+    preview?: boolean;
 }
 
 /**
@@ -593,7 +603,7 @@ interface BuyerRewards {
         lifetime_earned: string;
         redeemed: string | null;
         currency: string;
-    };
+    } | null;
     activity: BuyerRewardActivityItem[];
     earned_after_invoice: BuyerRewardActivityItem[];
     pending_after_invoice: BuyerRewardActivityItem[];
@@ -920,7 +930,9 @@ interface CartItem {
  * to the line for the life of the cart, and every quote-driven heal that tried
  * to clear it was a silent no-op.
  */
-type CartItemUpdate = Partial<Omit<CartItem, 'line_id' | 'product_id' | 'variant_id' | 'min_quantity' | 'max_quantity'>> & {
+type CartItemUpdate = Partial<Omit<CartItem, 'line_id' | 'product_id' | 'variant_id' | 'variant_title' | 'min_quantity' | 'max_quantity'>> & {
+    /** `null` clears the stored option name (the product has no options). */
+    variant_title?: string | null;
     /** `null` clears the stored minimum. */
     min_quantity?: number | null;
     /** `null` clears the stored ceiling. */
@@ -1013,6 +1025,10 @@ interface EligibleBundleDeal {
  *   `product_id`   the product identifier the cart sent, echoed exactly.
  *   `variant_id`   the resolved option id, `null` for a product with no variants.
  *   `quantity`     the quantity this line was quoted at.
+ *   `product_title` / `variant_title`  the catalog's names for the product and the option
+ *                  (`variant_title` null for a product with no variants), the names the invoice line
+ *                  carries. `product_title` is the base-language title; a storefront that shows
+ *                  translated titles keeps its own. Never compose or substitute them.
  *   `min_quantity` ABSENT when it is 1. Present values are the stepper's floor.
  *   `max_quantity` ABSENT when nothing bounds the line — absence is the unbounded sentinel, and
  *                  `-1` is never sent. Never coerce an absent key to 0.
@@ -1046,6 +1062,10 @@ interface EligibleBundleDeal {
 interface CartQuoteLine {
     product_id: string;
     variant_id: string | null;
+    /** Absent on servers older than this field. */
+    product_title?: string;
+    /** Absent on servers older than this field. */
+    variant_title?: string | null;
     quantity: number;
     /** Absent when 1. */
     min_quantity?: number;
@@ -1065,6 +1085,12 @@ interface CartQuote {
      * signing secret configured; absent on older backends.
      */
     quote_token?: string | null;
+    /**
+     * True when the cart holds a physical product. Shipping is priced at
+     * checkout from the buyer's address, so `total` excludes it; show
+     * "shipping calculated at checkout" next to the total.
+     */
+    requires_shipping: boolean;
     coupon_applied: boolean;
     coupon_source: CartCodeSource | null;
     coupon_discount_order_type: 'TOTAL' | 'PAYMENT_FEES' | null;
@@ -1781,6 +1807,24 @@ interface CustomerEmailPreferencesPatch {
         subscribed: boolean;
     }>;
 }
+/** Which order mails the buyer receives. A key left out is left as it is. */
+interface CustomerNotificationPreferencesPatch {
+    order_created_emails?: boolean;
+    order_completed_emails?: boolean;
+    payment_issue_emails?: boolean;
+}
+interface CustomerAffiliateLinkInput {
+    code: string;
+    label: string;
+    /** Asking for a rate of one's own sends the link to the shop for approval. */
+    requested_affiliate_revenue_percent?: number;
+    requested_affiliate_customer_discount_percent?: number;
+}
+interface CustomerInvoicePdf {
+    blob: Blob;
+    /** From the producer's `Content-Disposition`; null when it named none. */
+    filename: string | null;
+}
 /** One basket line for a QUOTE. `variant_id` is omitted, never null, when a product has no variants. */
 interface ResellerOrderItem {
     product_id: string;
@@ -1820,6 +1864,14 @@ declare function dashboard(): Promise<SDKResponse<CustomerPortalDashboardWire>>;
  */
 declare function orders(options?: CustomerOrdersQuery): Promise<SDKResponse<CustomerPortalPaginatedInvoicesWire>>;
 declare function order(id: string): Promise<SDKResponse<CustomerPortalInvoiceDetailWire>>;
+/**
+ * The invoice as a PDF, for the buyer to save.
+ *
+ * A file, not the JSON envelope, so it does not go through `requestCustomer`.
+ * Anything but a PDF on a 2xx is a contract failure rather than a download: a
+ * proxy's HTML error page saved as `invoice.pdf` is a file that will not open.
+ */
+declare function invoicePdf(id: string): Promise<SDKResponse<CustomerInvoicePdf>>;
 declare function loyalty(): Promise<SDKResponse<CustomerLoyaltyWire>>;
 declare function redeemLoyaltyPoints(input: {
     points: number;
@@ -1846,6 +1898,15 @@ declare function addFavorite(productUniqid: string): Promise<SDKResponse<unknown
 declare function removeFavorite(productUniqid: string): Promise<SDKResponse<unknown>>;
 declare function affiliate(): Promise<SDKResponse<unknown>>;
 declare function affiliateStats(days?: number): Promise<SDKResponse<unknown>>;
+/**
+ * A referral link with a code of the buyer's choosing.
+ *
+ * `status` in the answer is `pending` when the shop approves links first, or
+ * when the link asks for rates of its own. Nothing here pays out, converts or
+ * shares a commission: those decide where earned money goes and are not
+ * reachable from a storefront.
+ */
+declare function createAffiliateLink(input: CustomerAffiliateLinkInput): Promise<SDKResponse<CustomerPortalAffiliateCreateLinkWire>>;
 declare function createTicket(payload: CustomerTicketPayload): Promise<SDKResponse<unknown>>;
 declare function ticket(uniqid: string): Promise<SDKResponse<unknown>>;
 declare function replyToTicket(uniqid: string, message: string): Promise<SDKResponse<unknown>>;
@@ -1860,6 +1921,13 @@ declare function updateAvatar(file: File): Promise<SDKResponse<unknown>>;
 declare function removeAvatar(): Promise<SDKResponse<unknown>>;
 declare function emailPreferences(): Promise<SDKResponse<unknown>>;
 declare function updateEmailPreferences(patch: CustomerEmailPreferencesPatch): Promise<SDKResponse<unknown>>;
+/**
+ * Order mail, as opposed to the marketing lists above: order placed, order
+ * completed, payment needs attention. Its own producer
+ * (`routes/v1/customer-notifications.ts`), and it answers the saved set.
+ */
+declare function notificationPreferences(): Promise<SDKResponse<CustomerPortalNotificationPreferencesWire>>;
+declare function updateNotificationPreferences(patch: CustomerNotificationPreferencesPatch): Promise<SDKResponse<CustomerPortalNotificationPreferencesWire>>;
 declare function sessions(): Promise<SDKResponse<unknown>>;
 declare function revokeSession(id: string): Promise<SDKResponse<unknown>>;
 /**
@@ -2080,6 +2148,7 @@ declare const shoppex: {
     dashboard: typeof dashboard;
     orders: typeof orders;
     order: typeof order;
+    invoicePdf: typeof invoicePdf;
     loyalty: typeof loyalty;
     redeemLoyaltyPoints: typeof redeemLoyaltyPoints;
     warranties: typeof warranties;
@@ -2094,6 +2163,7 @@ declare const shoppex: {
     removeFavorite: typeof removeFavorite;
     affiliate: typeof affiliate;
     affiliateStats: typeof affiliateStats;
+    createAffiliateLink: typeof createAffiliateLink;
     createTicket: typeof createTicket;
     ticket: typeof ticket;
     replyToTicket: typeof replyToTicket;
@@ -2102,6 +2172,8 @@ declare const shoppex: {
     removeAvatar: typeof removeAvatar;
     emailPreferences: typeof emailPreferences;
     updateEmailPreferences: typeof updateEmailPreferences;
+    notificationPreferences: typeof notificationPreferences;
+    updateNotificationPreferences: typeof updateNotificationPreferences;
     sessions: typeof sessions;
     revokeSession: typeof revokeSession;
     revokeAllSessions: typeof revokeAllSessions;
@@ -2142,4 +2214,4 @@ declare const shoppex: {
     mergeSettings: typeof mergeSettings;
 };
 
-export { type AffiliateValidation, ApiError, type ApiResponse, type BlockDefinition, type BlockInstance, type BuyerRewardActivityItem, type BuyerRewards, CURRENCY_UNAVAILABLE_ERROR_CODE, type CartAddOptions, type CartAddon, type CartAppliedDiscount, type CartBasketMergeLine, type CartCodeSource, CartError, type CartItem, type CartItemUpdate, type CartLineIdentityInput, type CartMetadata, type CartPayload, type CartQuote, type CartQuoteLine, type CartStats, type Category, CheckoutCreateError, type CheckoutOptions, type CheckoutResult, type CouponValidation, type CouponValidationOptions, type CursorPagination, type CustomFieldDefinition, type CustomerEmailPreferencesPatch, type CustomerProfilePatch, type CustomerSubscriptionCancelOptions, type CustomerTicketPayload, type EligibleBundleDeal, type EligibleBundleDealProduct, type EligibleCartDeal, type Feedback, type Invoice, type InvoiceProduct, type Menu, type MenuItem, NetworkError, NotInitializedError, PRODUCT_FILTER_UNSUPPORTED, type Page, type PageLayout, type PriceVariant, type Product, type ProductAddon, type ProductBundle, type ProductBundleProduct, type ProductCategory, type ProductDescriptionTab, type ProductFaq, type ProductFeedback, type ProductGroup, type ProductImage, type ProductVariant, type PublishedBuilderSettings, type PublishedThemeSettingsPayload, type ResellerCatalogQuery, type ResellerOrderItem, type ResellerOrdersQuery, type ResolvedThemeSettings, type RewardActionType, type RewardGrantStatus, type RewardProgramSummary, type RewardProgramTeaserItem, type RewardReason, type SDKResponse, type SearchOptions, type SectionDefinition, type SettingField, type Shop, type ShopFeedback, type ShopReviewsPage, type ShopReviewsSummary, type ShopTheme, type ShoppexConfig, ShoppexError, type ShoppexInitOptions, type StorefrontAddon, type StorefrontAddonBootstrap, type StorefrontAnnouncementBarAddon, type StorefrontCatalogSearchItem, type StorefrontContactTicketInput, type StorefrontContactTicketResult, type StorefrontCountdownBarAddon, type StorefrontCouponPopupModalAddon, type StorefrontCustomField, type StorefrontData, type StorefrontItem, type StorefrontOnlineUsers, type StorefrontPromoInfoCardAddon, type StorefrontRecentPurchasePopupAddon, type StorefrontRecentSaleEntry, type StorefrontRecentSales, type StorefrontSearchFilterOptions, type StorefrontSocialLinks, type Subscription, type SubscriptionFlags, type SubscriptionInterval, type ThemeBlockManifest, type ThemeConfig, type TrustedChecks, ValidationError, acceptResellerInvite, addFavorite, affiliate, affiliateStats, applyForReseller, buildStorefrontContactMessage, buildStorefrontCustomFieldPayload, buildStorefrontProductLookup, cancelSubscription, claimWarranty, collectProductSearchHaystack, computeCartLineId, createTicket, dashboard, shoppex as default, emailPreferences, enrollAsReseller, ensureCartLineId, favorites, fetchPublishedBuilderSettings, fetchPublishedThemeSettings, filterProductsBySearchQuery, getMenu, getMenuBySlot, getMenuByTitle, getMenuSlotTitles, getMenus, getMergedStorefrontProducts, getShopReviewsPage, getStorefrontGroupProducts, getStorefrontOnlineUsers, getStorefrontRecentSales, groupMatchesSearchQuery, isProductInStock, isProductOutOfStock, isStorefrontCheckboxCustomFieldValueChecked, isVariantOutOfStock, logout, loyalty, me, mergeSettings, normalizeSearchQuery, normalizeStorefrontCustomFields, order, orders, pauseSubscription, productMatchesSearchQuery, quoteResellerOrder, redeemLoyaltyPoints, removeAvatar, removeFavorite, replyToTicket, requestOtp, reseller, resellerApiKeys, resellerCatalog, resellerOrder, resellerOrders, resellerWallet, resetLicenseHwid, resolveDefaults, resolveDisplayStock, resolveStorefrontApiBaseUrl, resolveStorefrontSocialLinks, resolveVariantStockValue, resumeSubscription, revokeAllSessions, revokeSession, searchMergedStorefrontCatalog, searchMergedStorefrontCatalogItems, sessions, shoppex, stripHtmlFromText, submitStorefrontContactTicket, subscriptionBillingHistory, ticket, touchStorefrontPresence, trackCartActivity, trackPageView, updateAvatar, updateEmailPreferences, updateProfile, validateStorefrontCustomFieldValue, verifyOtp, warranties };
+export { type AffiliateValidation, ApiError, type ApiResponse, type BlockDefinition, type BlockInstance, type BuyerRewardActivityItem, type BuyerRewards, CURRENCY_UNAVAILABLE_ERROR_CODE, type CartAddOptions, type CartAddon, type CartAppliedDiscount, type CartBasketMergeLine, type CartCodeSource, CartError, type CartItem, type CartItemUpdate, type CartLineIdentityInput, type CartMetadata, type CartPayload, type CartQuote, type CartQuoteLine, type CartStats, type Category, CheckoutCreateError, type CheckoutOptions, type CheckoutResult, type CouponValidation, type CouponValidationOptions, type CursorPagination, type CustomFieldDefinition, type CustomerAffiliateLinkInput, type CustomerEmailPreferencesPatch, type CustomerInvoicePdf, type CustomerNotificationPreferencesPatch, type CustomerProfilePatch, type CustomerSubscriptionCancelOptions, type CustomerTicketPayload, type EligibleBundleDeal, type EligibleBundleDealProduct, type EligibleCartDeal, type Feedback, type Invoice, type InvoiceProduct, type Menu, type MenuItem, NetworkError, NotInitializedError, PRODUCT_FILTER_UNSUPPORTED, type Page, type PageLayout, type PriceVariant, type Product, type ProductAddon, type ProductBundle, type ProductBundleProduct, type ProductCategory, type ProductDescriptionTab, type ProductFaq, type ProductFeedback, type ProductGroup, type ProductImage, type ProductVariant, type PublishedBuilderSettings, type PublishedThemeSettingsPayload, type ResellerCatalogQuery, type ResellerOrderItem, type ResellerOrdersQuery, type ResolvedThemeSettings, type RewardActionType, type RewardGrantStatus, type RewardProgramSummary, type RewardProgramTeaserItem, type RewardReason, type SDKResponse, type SearchOptions, type SectionDefinition, type SettingField, type Shop, type ShopFeedback, type ShopReviewsPage, type ShopReviewsSummary, type ShopTheme, type ShoppexConfig, ShoppexError, type ShoppexInitOptions, type StorefrontAddon, type StorefrontAddonBootstrap, type StorefrontAnnouncementBarAddon, type StorefrontCatalogSearchItem, type StorefrontContactTicketInput, type StorefrontContactTicketResult, type StorefrontCountdownBarAddon, type StorefrontCouponPopupModalAddon, type StorefrontCustomField, type StorefrontData, type StorefrontItem, type StorefrontOnlineUsers, type StorefrontPromoInfoCardAddon, type StorefrontRecentPurchasePopupAddon, type StorefrontRecentSaleEntry, type StorefrontRecentSales, type StorefrontSearchFilterOptions, type StorefrontSocialLinks, type Subscription, type SubscriptionFlags, type SubscriptionInterval, type ThemeBlockManifest, type ThemeConfig, type TrustedChecks, ValidationError, acceptResellerInvite, addFavorite, affiliate, affiliateStats, applyForReseller, buildStorefrontContactMessage, buildStorefrontCustomFieldPayload, buildStorefrontProductLookup, cancelSubscription, claimWarranty, collectProductSearchHaystack, computeCartLineId, createAffiliateLink, createTicket, dashboard, shoppex as default, emailPreferences, enrollAsReseller, ensureCartLineId, favorites, fetchPublishedBuilderSettings, fetchPublishedThemeSettings, filterProductsBySearchQuery, getMenu, getMenuBySlot, getMenuByTitle, getMenuSlotTitles, getMenus, getMergedStorefrontProducts, getShopReviewsPage, getStorefrontGroupProducts, getStorefrontOnlineUsers, getStorefrontRecentSales, groupMatchesSearchQuery, invoicePdf, isProductInStock, isProductOutOfStock, isStorefrontCheckboxCustomFieldValueChecked, isVariantOutOfStock, logout, loyalty, me, mergeSettings, normalizeSearchQuery, normalizeStorefrontCustomFields, notificationPreferences, order, orders, pauseSubscription, productMatchesSearchQuery, quoteResellerOrder, redeemLoyaltyPoints, removeAvatar, removeFavorite, replyToTicket, requestOtp, reseller, resellerApiKeys, resellerCatalog, resellerOrder, resellerOrders, resellerWallet, resetLicenseHwid, resolveDefaults, resolveDisplayStock, resolveStorefrontApiBaseUrl, resolveStorefrontSocialLinks, resolveVariantStockValue, resumeSubscription, revokeAllSessions, revokeSession, searchMergedStorefrontCatalog, searchMergedStorefrontCatalogItems, sessions, shoppex, stripHtmlFromText, submitStorefrontContactTicket, subscriptionBillingHistory, ticket, touchStorefrontPresence, trackCartActivity, trackPageView, updateAvatar, updateEmailPreferences, updateNotificationPreferences, updateProfile, validateStorefrontCustomFieldValue, verifyOtp, warranties };

package/dist/index.d.ts

@@ -1,7 +1,8 @@
-import { createApiClient, CustomerWarrantyClaimWire, CustomerPortalDashboardWire, CustomerPortalPaginatedInvoicesWire, CustomerPortalInvoiceDetailWire, CustomerLoyaltyWire, CustomerLoyaltyRedeemWire, CustomerWarrantyListWire } from '@shoppex/contracts';
+import { createApiClient } from '@shoppex/contracts/api-client';
 import { NavigationMenuSlot } from '@shoppex/contracts/navigation';
 export { NavigationMenuSlot } from '@shoppex/contracts/navigation';
 import * as src from 'src';
+import { CustomerWarrantyClaimWire, CustomerPortalAffiliateCreateLinkWire, CustomerPortalDashboardWire, CustomerPortalPaginatedInvoicesWire, CustomerPortalInvoiceDetailWire, CustomerLoyaltyWire, CustomerLoyaltyRedeemWire, CustomerWarrantyListWire, CustomerPortalNotificationPreferencesWire } from '@shoppex/contracts/customer-account-wire';
 export { CATALOG_UNIT_PRICE_DECIMAL_PLACES, CATALOG_UNIT_PRICE_FORMAT_OPTIONS, PAYABLE_AMOUNT_DECIMAL_PLACES, roundPayableAmount } from '@shoppex/contracts/catalog-unit-price';
 
 /**
@@ -14,6 +15,7 @@ interface ShoppexConfig {
     currency?: string;
     apiBaseUrl?: string;
     checkoutBaseUrl?: string;
+    preview: boolean;
 }
 interface ShoppexInitOptions {
     locale?: string;
@@ -29,6 +31,14 @@ interface ShoppexInitOptions {
     apiBaseUrl?: string;
     checkoutBaseUrl?: string;
     shopId?: string;
+    /**
+     * Set on pages that render an unpublished draft (preview links): the page
+     * has no live side effects. The cart (lines, metadata, coupon) lives in this
+     * tab's sessionStorage under `shoppex_cart_<storeSlug>_preview`-style keys,
+     * never in the buyer's localStorage cart, and the SDK sends no presence or
+     * affiliate funnel events.
+     */
+    preview?: boolean;
 }
 
 /**
@@ -593,7 +603,7 @@ interface BuyerRewards {
         lifetime_earned: string;
         redeemed: string | null;
         currency: string;
-    };
+    } | null;
     activity: BuyerRewardActivityItem[];
     earned_after_invoice: BuyerRewardActivityItem[];
     pending_after_invoice: BuyerRewardActivityItem[];
@@ -920,7 +930,9 @@ interface CartItem {
  * to the line for the life of the cart, and every quote-driven heal that tried
  * to clear it was a silent no-op.
  */
-type CartItemUpdate = Partial<Omit<CartItem, 'line_id' | 'product_id' | 'variant_id' | 'min_quantity' | 'max_quantity'>> & {
+type CartItemUpdate = Partial<Omit<CartItem, 'line_id' | 'product_id' | 'variant_id' | 'variant_title' | 'min_quantity' | 'max_quantity'>> & {
+    /** `null` clears the stored option name (the product has no options). */
+    variant_title?: string | null;
     /** `null` clears the stored minimum. */
     min_quantity?: number | null;
     /** `null` clears the stored ceiling. */
@@ -1013,6 +1025,10 @@ interface EligibleBundleDeal {
  *   `product_id`   the product identifier the cart sent, echoed exactly.
  *   `variant_id`   the resolved option id, `null` for a product with no variants.
  *   `quantity`     the quantity this line was quoted at.
+ *   `product_title` / `variant_title`  the catalog's names for the product and the option
+ *                  (`variant_title` null for a product with no variants), the names the invoice line
+ *                  carries. `product_title` is the base-language title; a storefront that shows
+ *                  translated titles keeps its own. Never compose or substitute them.
  *   `min_quantity` ABSENT when it is 1. Present values are the stepper's floor.
  *   `max_quantity` ABSENT when nothing bounds the line — absence is the unbounded sentinel, and
  *                  `-1` is never sent. Never coerce an absent key to 0.
@@ -1046,6 +1062,10 @@ interface EligibleBundleDeal {
 interface CartQuoteLine {
     product_id: string;
     variant_id: string | null;
+    /** Absent on servers older than this field. */
+    product_title?: string;
+    /** Absent on servers older than this field. */
+    variant_title?: string | null;
     quantity: number;
     /** Absent when 1. */
     min_quantity?: number;
@@ -1065,6 +1085,12 @@ interface CartQuote {
      * signing secret configured; absent on older backends.
      */
     quote_token?: string | null;
+    /**
+     * True when the cart holds a physical product. Shipping is priced at
+     * checkout from the buyer's address, so `total` excludes it; show
+     * "shipping calculated at checkout" next to the total.
+     */
+    requires_shipping: boolean;
     coupon_applied: boolean;
     coupon_source: CartCodeSource | null;
     coupon_discount_order_type: 'TOTAL' | 'PAYMENT_FEES' | null;
@@ -1781,6 +1807,24 @@ interface CustomerEmailPreferencesPatch {
         subscribed: boolean;
     }>;
 }
+/** Which order mails the buyer receives. A key left out is left as it is. */
+interface CustomerNotificationPreferencesPatch {
+    order_created_emails?: boolean;
+    order_completed_emails?: boolean;
+    payment_issue_emails?: boolean;
+}
+interface CustomerAffiliateLinkInput {
+    code: string;
+    label: string;
+    /** Asking for a rate of one's own sends the link to the shop for approval. */
+    requested_affiliate_revenue_percent?: number;
+    requested_affiliate_customer_discount_percent?: number;
+}
+interface CustomerInvoicePdf {
+    blob: Blob;
+    /** From the producer's `Content-Disposition`; null when it named none. */
+    filename: string | null;
+}
 /** One basket line for a QUOTE. `variant_id` is omitted, never null, when a product has no variants. */
 interface ResellerOrderItem {
     product_id: string;
@@ -1820,6 +1864,14 @@ declare function dashboard(): Promise<SDKResponse<CustomerPortalDashboardWire>>;
  */
 declare function orders(options?: CustomerOrdersQuery): Promise<SDKResponse<CustomerPortalPaginatedInvoicesWire>>;
 declare function order(id: string): Promise<SDKResponse<CustomerPortalInvoiceDetailWire>>;
+/**
+ * The invoice as a PDF, for the buyer to save.
+ *
+ * A file, not the JSON envelope, so it does not go through `requestCustomer`.
+ * Anything but a PDF on a 2xx is a contract failure rather than a download: a
+ * proxy's HTML error page saved as `invoice.pdf` is a file that will not open.
+ */
+declare function invoicePdf(id: string): Promise<SDKResponse<CustomerInvoicePdf>>;
 declare function loyalty(): Promise<SDKResponse<CustomerLoyaltyWire>>;
 declare function redeemLoyaltyPoints(input: {
     points: number;
@@ -1846,6 +1898,15 @@ declare function addFavorite(productUniqid: string): Promise<SDKResponse<unknown
 declare function removeFavorite(productUniqid: string): Promise<SDKResponse<unknown>>;
 declare function affiliate(): Promise<SDKResponse<unknown>>;
 declare function affiliateStats(days?: number): Promise<SDKResponse<unknown>>;
+/**
+ * A referral link with a code of the buyer's choosing.
+ *
+ * `status` in the answer is `pending` when the shop approves links first, or
+ * when the link asks for rates of its own. Nothing here pays out, converts or
+ * shares a commission: those decide where earned money goes and are not
+ * reachable from a storefront.
+ */
+declare function createAffiliateLink(input: CustomerAffiliateLinkInput): Promise<SDKResponse<CustomerPortalAffiliateCreateLinkWire>>;
 declare function createTicket(payload: CustomerTicketPayload): Promise<SDKResponse<unknown>>;
 declare function ticket(uniqid: string): Promise<SDKResponse<unknown>>;
 declare function replyToTicket(uniqid: string, message: string): Promise<SDKResponse<unknown>>;
@@ -1860,6 +1921,13 @@ declare function updateAvatar(file: File): Promise<SDKResponse<unknown>>;
 declare function removeAvatar(): Promise<SDKResponse<unknown>>;
 declare function emailPreferences(): Promise<SDKResponse<unknown>>;
 declare function updateEmailPreferences(patch: CustomerEmailPreferencesPatch): Promise<SDKResponse<unknown>>;
+/**
+ * Order mail, as opposed to the marketing lists above: order placed, order
+ * completed, payment needs attention. Its own producer
+ * (`routes/v1/customer-notifications.ts`), and it answers the saved set.
+ */
+declare function notificationPreferences(): Promise<SDKResponse<CustomerPortalNotificationPreferencesWire>>;
+declare function updateNotificationPreferences(patch: CustomerNotificationPreferencesPatch): Promise<SDKResponse<CustomerPortalNotificationPreferencesWire>>;
 declare function sessions(): Promise<SDKResponse<unknown>>;
 declare function revokeSession(id: string): Promise<SDKResponse<unknown>>;
 /**
@@ -2080,6 +2148,7 @@ declare const shoppex: {
     dashboard: typeof dashboard;
     orders: typeof orders;
     order: typeof order;
+    invoicePdf: typeof invoicePdf;
     loyalty: typeof loyalty;
     redeemLoyaltyPoints: typeof redeemLoyaltyPoints;
     warranties: typeof warranties;
@@ -2094,6 +2163,7 @@ declare const shoppex: {
     removeFavorite: typeof removeFavorite;
     affiliate: typeof affiliate;
     affiliateStats: typeof affiliateStats;
+    createAffiliateLink: typeof createAffiliateLink;
     createTicket: typeof createTicket;
     ticket: typeof ticket;
     replyToTicket: typeof replyToTicket;
@@ -2102,6 +2172,8 @@ declare const shoppex: {
     removeAvatar: typeof removeAvatar;
     emailPreferences: typeof emailPreferences;
     updateEmailPreferences: typeof updateEmailPreferences;
+    notificationPreferences: typeof notificationPreferences;
+    updateNotificationPreferences: typeof updateNotificationPreferences;
     sessions: typeof sessions;
     revokeSession: typeof revokeSession;
     revokeAllSessions: typeof revokeAllSessions;
@@ -2142,4 +2214,4 @@ declare const shoppex: {
     mergeSettings: typeof mergeSettings;
 };
 
-export { type AffiliateValidation, ApiError, type ApiResponse, type BlockDefinition, type BlockInstance, type BuyerRewardActivityItem, type BuyerRewards, CURRENCY_UNAVAILABLE_ERROR_CODE, type CartAddOptions, type CartAddon, type CartAppliedDiscount, type CartBasketMergeLine, type CartCodeSource, CartError, type CartItem, type CartItemUpdate, type CartLineIdentityInput, type CartMetadata, type CartPayload, type CartQuote, type CartQuoteLine, type CartStats, type Category, CheckoutCreateError, type CheckoutOptions, type CheckoutResult, type CouponValidation, type CouponValidationOptions, type CursorPagination, type CustomFieldDefinition, type CustomerEmailPreferencesPatch, type CustomerProfilePatch, type CustomerSubscriptionCancelOptions, type CustomerTicketPayload, type EligibleBundleDeal, type EligibleBundleDealProduct, type EligibleCartDeal, type Feedback, type Invoice, type InvoiceProduct, type Menu, type MenuItem, NetworkError, NotInitializedError, PRODUCT_FILTER_UNSUPPORTED, type Page, type PageLayout, type PriceVariant, type Product, type ProductAddon, type ProductBundle, type ProductBundleProduct, type ProductCategory, type ProductDescriptionTab, type ProductFaq, type ProductFeedback, type ProductGroup, type ProductImage, type ProductVariant, type PublishedBuilderSettings, type PublishedThemeSettingsPayload, type ResellerCatalogQuery, type ResellerOrderItem, type ResellerOrdersQuery, type ResolvedThemeSettings, type RewardActionType, type RewardGrantStatus, type RewardProgramSummary, type RewardProgramTeaserItem, type RewardReason, type SDKResponse, type SearchOptions, type SectionDefinition, type SettingField, type Shop, type ShopFeedback, type ShopReviewsPage, type ShopReviewsSummary, type ShopTheme, type ShoppexConfig, ShoppexError, type ShoppexInitOptions, type StorefrontAddon, type StorefrontAddonBootstrap, type StorefrontAnnouncementBarAddon, type StorefrontCatalogSearchItem, type StorefrontContactTicketInput, type StorefrontContactTicketResult, type StorefrontCountdownBarAddon, type StorefrontCouponPopupModalAddon, type StorefrontCustomField, type StorefrontData, type StorefrontItem, type StorefrontOnlineUsers, type StorefrontPromoInfoCardAddon, type StorefrontRecentPurchasePopupAddon, type StorefrontRecentSaleEntry, type StorefrontRecentSales, type StorefrontSearchFilterOptions, type StorefrontSocialLinks, type Subscription, type SubscriptionFlags, type SubscriptionInterval, type ThemeBlockManifest, type ThemeConfig, type TrustedChecks, ValidationError, acceptResellerInvite, addFavorite, affiliate, affiliateStats, applyForReseller, buildStorefrontContactMessage, buildStorefrontCustomFieldPayload, buildStorefrontProductLookup, cancelSubscription, claimWarranty, collectProductSearchHaystack, computeCartLineId, createTicket, dashboard, shoppex as default, emailPreferences, enrollAsReseller, ensureCartLineId, favorites, fetchPublishedBuilderSettings, fetchPublishedThemeSettings, filterProductsBySearchQuery, getMenu, getMenuBySlot, getMenuByTitle, getMenuSlotTitles, getMenus, getMergedStorefrontProducts, getShopReviewsPage, getStorefrontGroupProducts, getStorefrontOnlineUsers, getStorefrontRecentSales, groupMatchesSearchQuery, isProductInStock, isProductOutOfStock, isStorefrontCheckboxCustomFieldValueChecked, isVariantOutOfStock, logout, loyalty, me, mergeSettings, normalizeSearchQuery, normalizeStorefrontCustomFields, order, orders, pauseSubscription, productMatchesSearchQuery, quoteResellerOrder, redeemLoyaltyPoints, removeAvatar, removeFavorite, replyToTicket, requestOtp, reseller, resellerApiKeys, resellerCatalog, resellerOrder, resellerOrders, resellerWallet, resetLicenseHwid, resolveDefaults, resolveDisplayStock, resolveStorefrontApiBaseUrl, resolveStorefrontSocialLinks, resolveVariantStockValue, resumeSubscription, revokeAllSessions, revokeSession, searchMergedStorefrontCatalog, searchMergedStorefrontCatalogItems, sessions, shoppex, stripHtmlFromText, submitStorefrontContactTicket, subscriptionBillingHistory, ticket, touchStorefrontPresence, trackCartActivity, trackPageView, updateAvatar, updateEmailPreferences, updateProfile, validateStorefrontCustomFieldValue, verifyOtp, warranties };
+export { type AffiliateValidation, ApiError, type ApiResponse, type BlockDefinition, type BlockInstance, type BuyerRewardActivityItem, type BuyerRewards, CURRENCY_UNAVAILABLE_ERROR_CODE, type CartAddOptions, type CartAddon, type CartAppliedDiscount, type CartBasketMergeLine, type CartCodeSource, CartError, type CartItem, type CartItemUpdate, type CartLineIdentityInput, type CartMetadata, type CartPayload, type CartQuote, type CartQuoteLine, type CartStats, type Category, CheckoutCreateError, type CheckoutOptions, type CheckoutResult, type CouponValidation, type CouponValidationOptions, type CursorPagination, type CustomFieldDefinition, type CustomerAffiliateLinkInput, type CustomerEmailPreferencesPatch, type CustomerInvoicePdf, type CustomerNotificationPreferencesPatch, type CustomerProfilePatch, type CustomerSubscriptionCancelOptions, type CustomerTicketPayload, type EligibleBundleDeal, type EligibleBundleDealProduct, type EligibleCartDeal, type Feedback, type Invoice, type InvoiceProduct, type Menu, type MenuItem, NetworkError, NotInitializedError, PRODUCT_FILTER_UNSUPPORTED, type Page, type PageLayout, type PriceVariant, type Product, type ProductAddon, type ProductBundle, type ProductBundleProduct, type ProductCategory, type ProductDescriptionTab, type ProductFaq, type ProductFeedback, type ProductGroup, type ProductImage, type ProductVariant, type PublishedBuilderSettings, type PublishedThemeSettingsPayload, type ResellerCatalogQuery, type ResellerOrderItem, type ResellerOrdersQuery, type ResolvedThemeSettings, type RewardActionType, type RewardGrantStatus, type RewardProgramSummary, type RewardProgramTeaserItem, type RewardReason, type SDKResponse, type SearchOptions, type SectionDefinition, type SettingField, type Shop, type ShopFeedback, type ShopReviewsPage, type ShopReviewsSummary, type ShopTheme, type ShoppexConfig, ShoppexError, type ShoppexInitOptions, type StorefrontAddon, type StorefrontAddonBootstrap, type StorefrontAnnouncementBarAddon, type StorefrontCatalogSearchItem, type StorefrontContactTicketInput, type StorefrontContactTicketResult, type StorefrontCountdownBarAddon, type StorefrontCouponPopupModalAddon, type StorefrontCustomField, type StorefrontData, type StorefrontItem, type StorefrontOnlineUsers, type StorefrontPromoInfoCardAddon, type StorefrontRecentPurchasePopupAddon, type StorefrontRecentSaleEntry, type StorefrontRecentSales, type StorefrontSearchFilterOptions, type StorefrontSocialLinks, type Subscription, type SubscriptionFlags, type SubscriptionInterval, type ThemeBlockManifest, type ThemeConfig, type TrustedChecks, ValidationError, acceptResellerInvite, addFavorite, affiliate, affiliateStats, applyForReseller, buildStorefrontContactMessage, buildStorefrontCustomFieldPayload, buildStorefrontProductLookup, cancelSubscription, claimWarranty, collectProductSearchHaystack, computeCartLineId, createAffiliateLink, createTicket, dashboard, shoppex as default, emailPreferences, enrollAsReseller, ensureCartLineId, favorites, fetchPublishedBuilderSettings, fetchPublishedThemeSettings, filterProductsBySearchQuery, getMenu, getMenuBySlot, getMenuByTitle, getMenuSlotTitles, getMenus, getMergedStorefrontProducts, getShopReviewsPage, getStorefrontGroupProducts, getStorefrontOnlineUsers, getStorefrontRecentSales, groupMatchesSearchQuery, invoicePdf, isProductInStock, isProductOutOfStock, isStorefrontCheckboxCustomFieldValueChecked, isVariantOutOfStock, logout, loyalty, me, mergeSettings, normalizeSearchQuery, normalizeStorefrontCustomFields, notificationPreferences, order, orders, pauseSubscription, productMatchesSearchQuery, quoteResellerOrder, redeemLoyaltyPoints, removeAvatar, removeFavorite, replyToTicket, requestOtp, reseller, resellerApiKeys, resellerCatalog, resellerOrder, resellerOrders, resellerWallet, resetLicenseHwid, resolveDefaults, resolveDisplayStock, resolveStorefrontApiBaseUrl, resolveStorefrontSocialLinks, resolveVariantStockValue, resumeSubscription, revokeAllSessions, revokeSession, searchMergedStorefrontCatalog, searchMergedStorefrontCatalogItems, sessions, shoppex, stripHtmlFromText, submitStorefrontContactTicket, subscriptionBillingHistory, ticket, touchStorefrontPresence, trackCartActivity, trackPageView, updateAvatar, updateEmailPreferences, updateNotificationPreferences, updateProfile, validateStorefrontCustomFieldValue, verifyOtp, warranties };