@misiki/gocommerce-connector 0.21.0 → 0.23.0

package/README.md

@@ -47,7 +47,8 @@ Each is optional. Without `-identity` there is no sign-in (guest checkout
 always works); without `-reviews` products show no stars; and so on. Add
 `-meilisearch` (with `MEILI_HOST` and keys) for typo-tolerant search once a store
 switches the Meilisearch plugin on,
-`-newsletter` and `-contact` for the signup box and contact form, and `-b2b` for
+`-newsletter` and `-contact` for the signup box and contact form,
+`-whatsapp` for WhatsApp order updates, and `-b2b` for
 business buyers (see "Beyond the storefront's screens").
 
 ### The browser and CORS
@@ -153,6 +154,7 @@ down stays best-effort: the storefront renders from its static record.
 | product specs table | the product's category attribute answers |
 | attribute filters (`?attributes.color=Red`) | `/api/products?attr=color:Red` |
 | newsletter box | `/x/newsletter/subscribe` |
+| WhatsApp order updates at checkout | `/x/notify-whatsapp/consent` — `whatsappService.consentOffer()`: `{ enabled, marketing }`, whether to show the order-updates box and the offers-and-reminders box; both false when ext/notify-whatsapp is not in the engine or does not answer, so checkout never waits on it. `whatsappService.setConsent({ cartId, phone, orderUpdates, marketing })` (PUT) records both answers for the phone, an unticked box as `false`; with `marketing` the engine keeps the phone on the bag for basket reminders. It throws the engine's 400 (`validation_failed`) when the phone is not a WhatsApp number for the store's country |
 | contact form, product enquiries | `/x/contact/messages`, with the form's hidden `website` honeypot passed on so the engine drops what a bot filled in |
 | search words, type-ahead (plugin on) | `/x/meilisearch/search`, falling back to the engine's own search when it is off or down |
 | store record | the storefront's own config, with the engine's currency, menus and module switches over it; the store's own logo, dark logo and icon (`logo_url`, `logo_dark_url`, `icon_url` from `/api/store`, D148) replace `logo`, `logoDark` and `favicon` when it has them; for the contact page (D156), the address once the store shows it (as `address: { street, city, state, pincode, country }`), `mapLocation` and `openingHours` when set, `businessCountry` (the store's ISO country, for the phone's country code), the `whatsapp-chat` plugin's number as `plugins.whatsappChatButton`, and Google Customer Reviews (ext/google-reviews) as `plugins.googleReviewsOptIn` (`active` while the survey is on) and `plugins.googleStoreWidget` (`{ active, position: 'RIGHT_BOTTOM' \| 'LEFT_BOTTOM' }`, off without the survey) |

package/dist/{index-BnLRuRag.d.cts → index-BM6hYdQs.d.cts}

@@ -723,6 +723,7 @@ type CartExtras = {
         key: string;
         body: string;
         meta?: Record<string, string>;
+        attribution?: Record<string, unknown>;
     } | null;
 };
 
@@ -7150,6 +7151,47 @@ declare class NewsletterService extends BaseService {
 }
 declare const newsletterService: NewsletterService;
 
+/** Which WhatsApp boxes checkout shows. */
+type WhatsappConsentOffer = {
+    /** The store sends order updates on WhatsApp: show the opt-in. */
+    enabled: boolean;
+    /** It sends basket reminders too: show the marketing box as well. */
+    marketing: boolean;
+};
+/** What the engine kept for a phone: the number as it reads it, in E.164. */
+type WhatsappConsent = {
+    phone: string;
+    orderUpdates: boolean;
+    marketing: boolean;
+};
+/**
+ * The shopper's WhatsApp opt-in at checkout (ext/notify-whatsapp).
+ *
+ * The engine keeps the latest answer per phone, so an unticked box is sent as
+ * `false` rather than left out: it is how a shopper who said yes last time
+ * says no now.
+ */
+declare class WhatsappService extends BaseService {
+    /**
+     * Whether to show the boxes. Never throws: an engine without the module, or
+     * one that fails, answers both off, because checkout must not depend on it.
+     */
+    consentOffer(): Promise<WhatsappConsentOffer>;
+    /**
+     * Records both answers for the phone as typed, against the bag (with
+     * `marketing`, the engine keeps the phone on it for basket reminders). Throws
+     * the engine's 400 (`validation_failed`) when the phone is not a WhatsApp
+     * number for the store's country.
+     */
+    setConsent({ cartId, phone, orderUpdates, marketing, }: {
+        cartId?: string | null;
+        phone: string;
+        orderUpdates: boolean;
+        marketing: boolean;
+    }): Promise<WhatsappConsent>;
+}
+declare const whatsappService: WhatsappService;
+
 type B2bRole = 'admin' | 'approver' | 'buyer';
 type Company = {
     id: number;
@@ -7697,4 +7739,4 @@ declare class B2bService extends BaseService {
 }
 declare const b2bService: B2bService;
 
-export { type GoogleReviews as $, type AddOn as A, type B2bPlaced as B, type Cart as C, type CompanyOrder as D, ContactService as E, CountryService as F, CouponService as G, type Credentials as H, type Credit as I, CurrencyService as J, type Customer as K, DealService as L, DemoRequestService as M, type EngineRequest as N, EnquiryService as O, type Envelope as P, type FacetValue as Q, type Faq as R, FaqService as S, FeedbackService as T, type FooterSettings as U, type FreeShipping as V, type Fulfillment as W, GalleryService as X, type GooglePlace as Y, type GoogleReview as Z, GoogleReviewService as _, type Address as a, type StorefrontProduct as a$, type GoogleSurvey as a0, type HeaderSettings as a1, type HomeLayout as a2, type HomeLayoutSection as a3, HomeService as a4, type IdentityAddress as a5, InitService as a6, type Invitation as a7, type LayoutCollection as a8, type LayoutPage as a9, type ProductFacets as aA, type ProductOption as aB, ProductService as aC, ProfileService as aD, type Quote as aE, REDIRECT_GATEWAYS as aF, ReelsService as aG, RegionService as aH, type RejectedLine as aI, type Review as aJ, type ReviewPage as aK, ReviewService as aL, type SearchDoc as aM, type SearchResult as aN, SearchService as aO, SettingService as aP, type ShippingRate as aQ, type SiteChrome as aR, type SiteFooter as aS, type SiteHeader as aT, type SocialLink as aU, StateService as aV, type StoreProfile as aW, StoreService as aX, type StorefrontCategory as aY, type StorefrontMenu as aZ, type StorefrontOrder as a_, LayoutService as aa, type Lead as ab, type ListMeta as ac, MeilisearchService as ad, type Member as ae, type Menu as af, type MenuItem as ag, MenuService as ah, type MenuSummary as ai, type Money as aj, NewsletterService as ak, type Offer as al, type OpeningHours as am, type Order as an, type OrderLine as ao, OrderService as ap, type PageLayout as aq, PageService as ar, type PaymentIntent as as, PaymentMethodService as at, type Plugin as au, PluginService as av, PopularSearchService as aw, PopularityService as ax, type Postcode as ay, type Product as az, AddressService as b, profileService as b$, type ThemeSettings as b0, type ThemeSettingsResult as b1, UploadService as b2, UserService as b3, type Variant as b4, type VariantImage as b5, VariantService as b6, VarniCustomDesignService as b7, VarniCustomProductService as b8, type Vendor as b9, faqService as bA, feedbackService as bB, fromEngineAddress as bC, fromIdentityAddress as bD, fromSearchDoc as bE, galleryService as bF, googleReviewService as bG, homeService as bH, initService as bI, layoutService as bJ, mediaUrl as bK, meilisearchService as bL, menuService as bM, minorToMajor as bN, newsletterService as bO, orderService as bP, ownDomain as bQ, pageService as bR, paymentMethodService as bS, pluginService as bT, pluginsService as bU, popularSearchService as bV, popularityService as bW, priceOf as bX, productImages as bY, productService as bZ, productVideos as b_, VendorService as ba, WarrantyService as bb, type Wishlist as bc, type WishlistItem as bd, WishlistService as be, addressService as bf, authService as bg, autocompleteService as bh, b2bService as bi, bannerService as bj, blogService as bk, cartService as bl, categoryService as bm, chatService as bn, checkoutService as bo, collectionService as bp, contactService as bq, countryService as br, couponService as bs, currencyExponent as bt, currencyService as bu, dealService as bv, demoRequestService as bw, emptyCart as bx, emptyPage as by, enquiryService as bz, type AppliedDiscount as c, qs as c0, reelsService as c1, regionService as c2, reviewService as c3, searchService as c4, setRequestHost as c5, settingService as c6, settingsService as c7, stateService as c8, staticStore as c9, varniCustomProductService as cA, vendorService as cB, warrantyService as cC, wishlistService as cD, storeForHost as ca, storeService as cb, toAddOn as cc, toCart as cd, toCartLine as ce, toCartOffer as cf, toCategory as cg, toCmsPage as ch, toCollection as ci, toEngineAddress as cj, toFreeShipping as ck, toIdentityAddress as cl, toMajor as cm, toMinor as cn, toOrder as co, toPage as cp, toProduct as cq, toRating as cr, toStorefrontFacets as cs, toUser as ct, toVariant as cu, toVendor as cv, uploadService as cw, userService as cx, variantService as cy, varniCustomDesignService as cz, type Approval as d, type AuthResponse as e, AuthService as f, AutocompleteService as g, type B2bRole as h, B2bService as i, BannerService as j, BaseService as k, BlogService as l, type CartLine as m, type CartOffer as n, CartService as o, CatalogService as p, type Category as q, CategoryService as r, ChatService as s, type CheckoutOptions as t, type CheckoutResult as u, CheckoutService as v, type CmsPage as w, type Collection as x, CollectionService as y, type Company as z };
+export { type GoogleReviews as $, type AddOn as A, type B2bPlaced as B, type Cart as C, type CompanyOrder as D, ContactService as E, CountryService as F, CouponService as G, type Credentials as H, type Credit as I, CurrencyService as J, type Customer as K, DealService as L, DemoRequestService as M, type EngineRequest as N, EnquiryService as O, type Envelope as P, type FacetValue as Q, type Faq as R, FaqService as S, FeedbackService as T, type FooterSettings as U, type FreeShipping as V, type Fulfillment as W, GalleryService as X, type GooglePlace as Y, type GoogleReview as Z, GoogleReviewService as _, type Address as a, type StorefrontProduct as a$, type GoogleSurvey as a0, type HeaderSettings as a1, type HomeLayout as a2, type HomeLayoutSection as a3, HomeService as a4, type IdentityAddress as a5, InitService as a6, type Invitation as a7, type LayoutCollection as a8, type LayoutPage as a9, type ProductFacets as aA, type ProductOption as aB, ProductService as aC, ProfileService as aD, type Quote as aE, REDIRECT_GATEWAYS as aF, ReelsService as aG, RegionService as aH, type RejectedLine as aI, type Review as aJ, type ReviewPage as aK, ReviewService as aL, type SearchDoc as aM, type SearchResult as aN, SearchService as aO, SettingService as aP, type ShippingRate as aQ, type SiteChrome as aR, type SiteFooter as aS, type SiteHeader as aT, type SocialLink as aU, StateService as aV, type StoreProfile as aW, StoreService as aX, type StorefrontCategory as aY, type StorefrontMenu as aZ, type StorefrontOrder as a_, LayoutService as aa, type Lead as ab, type ListMeta as ac, MeilisearchService as ad, type Member as ae, type Menu as af, type MenuItem as ag, MenuService as ah, type MenuSummary as ai, type Money as aj, NewsletterService as ak, type Offer as al, type OpeningHours as am, type Order as an, type OrderLine as ao, OrderService as ap, type PageLayout as aq, PageService as ar, type PaymentIntent as as, PaymentMethodService as at, type Plugin as au, PluginService as av, PopularSearchService as aw, PopularityService as ax, type Postcode as ay, type Product as az, AddressService as b, productImages as b$, type ThemeSettings as b0, type ThemeSettingsResult as b1, UploadService as b2, UserService as b3, type Variant as b4, type VariantImage as b5, VariantService as b6, VarniCustomDesignService as b7, VarniCustomProductService as b8, type Vendor as b9, emptyCart as bA, emptyPage as bB, enquiryService as bC, faqService as bD, feedbackService as bE, fromEngineAddress as bF, fromIdentityAddress as bG, fromSearchDoc as bH, galleryService as bI, googleReviewService as bJ, homeService as bK, initService as bL, layoutService as bM, mediaUrl as bN, meilisearchService as bO, menuService as bP, minorToMajor as bQ, newsletterService as bR, orderService as bS, ownDomain as bT, pageService as bU, paymentMethodService as bV, pluginService as bW, pluginsService as bX, popularSearchService as bY, popularityService as bZ, priceOf as b_, VendorService as ba, WarrantyService as bb, type WhatsappConsent as bc, type WhatsappConsentOffer as bd, WhatsappService as be, type Wishlist as bf, type WishlistItem as bg, WishlistService as bh, addressService as bi, authService as bj, autocompleteService as bk, b2bService as bl, bannerService as bm, blogService as bn, cartService as bo, categoryService as bp, chatService as bq, checkoutService as br, collectionService as bs, contactService as bt, countryService as bu, couponService as bv, currencyExponent as bw, currencyService as bx, dealService as by, demoRequestService as bz, type AppliedDiscount as c, productService as c0, productVideos as c1, profileService as c2, qs as c3, reelsService as c4, regionService as c5, reviewService as c6, searchService as c7, setRequestHost as c8, settingService as c9, userService as cA, variantService as cB, varniCustomDesignService as cC, varniCustomProductService as cD, vendorService as cE, warrantyService as cF, whatsappService as cG, wishlistService as cH, settingsService as ca, stateService as cb, staticStore as cc, storeForHost as cd, storeService as ce, toAddOn as cf, toCart as cg, toCartLine as ch, toCartOffer as ci, toCategory as cj, toCmsPage as ck, toCollection as cl, toEngineAddress as cm, toFreeShipping as cn, toIdentityAddress as co, toMajor as cp, toMinor as cq, toOrder as cr, toPage as cs, toProduct as ct, toRating as cu, toStorefrontFacets as cv, toUser as cw, toVariant as cx, toVendor as cy, uploadService as cz, type Approval as d, type AuthResponse as e, AuthService as f, AutocompleteService as g, type B2bRole as h, B2bService as i, BannerService as j, BaseService as k, BlogService as l, type CartLine as m, type CartOffer as n, CartService as o, CatalogService as p, type Category as q, CategoryService as r, ChatService as s, type CheckoutOptions as t, type CheckoutResult as u, CheckoutService as v, type CmsPage as w, type Collection as x, CollectionService as y, type Company as z };

package/dist/{index-BnLRuRag.d.ts → index-BM6hYdQs.d.ts}

@@ -723,6 +723,7 @@ type CartExtras = {
         key: string;
         body: string;
         meta?: Record<string, string>;
+        attribution?: Record<string, unknown>;
     } | null;
 };
 
@@ -7150,6 +7151,47 @@ declare class NewsletterService extends BaseService {
 }
 declare const newsletterService: NewsletterService;
 
+/** Which WhatsApp boxes checkout shows. */
+type WhatsappConsentOffer = {
+    /** The store sends order updates on WhatsApp: show the opt-in. */
+    enabled: boolean;
+    /** It sends basket reminders too: show the marketing box as well. */
+    marketing: boolean;
+};
+/** What the engine kept for a phone: the number as it reads it, in E.164. */
+type WhatsappConsent = {
+    phone: string;
+    orderUpdates: boolean;
+    marketing: boolean;
+};
+/**
+ * The shopper's WhatsApp opt-in at checkout (ext/notify-whatsapp).
+ *
+ * The engine keeps the latest answer per phone, so an unticked box is sent as
+ * `false` rather than left out: it is how a shopper who said yes last time
+ * says no now.
+ */
+declare class WhatsappService extends BaseService {
+    /**
+     * Whether to show the boxes. Never throws: an engine without the module, or
+     * one that fails, answers both off, because checkout must not depend on it.
+     */
+    consentOffer(): Promise<WhatsappConsentOffer>;
+    /**
+     * Records both answers for the phone as typed, against the bag (with
+     * `marketing`, the engine keeps the phone on it for basket reminders). Throws
+     * the engine's 400 (`validation_failed`) when the phone is not a WhatsApp
+     * number for the store's country.
+     */
+    setConsent({ cartId, phone, orderUpdates, marketing, }: {
+        cartId?: string | null;
+        phone: string;
+        orderUpdates: boolean;
+        marketing: boolean;
+    }): Promise<WhatsappConsent>;
+}
+declare const whatsappService: WhatsappService;
+
 type B2bRole = 'admin' | 'approver' | 'buyer';
 type Company = {
     id: number;
@@ -7697,4 +7739,4 @@ declare class B2bService extends BaseService {
 }
 declare const b2bService: B2bService;
 
-export { type GoogleReviews as $, type AddOn as A, type B2bPlaced as B, type Cart as C, type CompanyOrder as D, ContactService as E, CountryService as F, CouponService as G, type Credentials as H, type Credit as I, CurrencyService as J, type Customer as K, DealService as L, DemoRequestService as M, type EngineRequest as N, EnquiryService as O, type Envelope as P, type FacetValue as Q, type Faq as R, FaqService as S, FeedbackService as T, type FooterSettings as U, type FreeShipping as V, type Fulfillment as W, GalleryService as X, type GooglePlace as Y, type GoogleReview as Z, GoogleReviewService as _, type Address as a, type StorefrontProduct as a$, type GoogleSurvey as a0, type HeaderSettings as a1, type HomeLayout as a2, type HomeLayoutSection as a3, HomeService as a4, type IdentityAddress as a5, InitService as a6, type Invitation as a7, type LayoutCollection as a8, type LayoutPage as a9, type ProductFacets as aA, type ProductOption as aB, ProductService as aC, ProfileService as aD, type Quote as aE, REDIRECT_GATEWAYS as aF, ReelsService as aG, RegionService as aH, type RejectedLine as aI, type Review as aJ, type ReviewPage as aK, ReviewService as aL, type SearchDoc as aM, type SearchResult as aN, SearchService as aO, SettingService as aP, type ShippingRate as aQ, type SiteChrome as aR, type SiteFooter as aS, type SiteHeader as aT, type SocialLink as aU, StateService as aV, type StoreProfile as aW, StoreService as aX, type StorefrontCategory as aY, type StorefrontMenu as aZ, type StorefrontOrder as a_, LayoutService as aa, type Lead as ab, type ListMeta as ac, MeilisearchService as ad, type Member as ae, type Menu as af, type MenuItem as ag, MenuService as ah, type MenuSummary as ai, type Money as aj, NewsletterService as ak, type Offer as al, type OpeningHours as am, type Order as an, type OrderLine as ao, OrderService as ap, type PageLayout as aq, PageService as ar, type PaymentIntent as as, PaymentMethodService as at, type Plugin as au, PluginService as av, PopularSearchService as aw, PopularityService as ax, type Postcode as ay, type Product as az, AddressService as b, profileService as b$, type ThemeSettings as b0, type ThemeSettingsResult as b1, UploadService as b2, UserService as b3, type Variant as b4, type VariantImage as b5, VariantService as b6, VarniCustomDesignService as b7, VarniCustomProductService as b8, type Vendor as b9, faqService as bA, feedbackService as bB, fromEngineAddress as bC, fromIdentityAddress as bD, fromSearchDoc as bE, galleryService as bF, googleReviewService as bG, homeService as bH, initService as bI, layoutService as bJ, mediaUrl as bK, meilisearchService as bL, menuService as bM, minorToMajor as bN, newsletterService as bO, orderService as bP, ownDomain as bQ, pageService as bR, paymentMethodService as bS, pluginService as bT, pluginsService as bU, popularSearchService as bV, popularityService as bW, priceOf as bX, productImages as bY, productService as bZ, productVideos as b_, VendorService as ba, WarrantyService as bb, type Wishlist as bc, type WishlistItem as bd, WishlistService as be, addressService as bf, authService as bg, autocompleteService as bh, b2bService as bi, bannerService as bj, blogService as bk, cartService as bl, categoryService as bm, chatService as bn, checkoutService as bo, collectionService as bp, contactService as bq, countryService as br, couponService as bs, currencyExponent as bt, currencyService as bu, dealService as bv, demoRequestService as bw, emptyCart as bx, emptyPage as by, enquiryService as bz, type AppliedDiscount as c, qs as c0, reelsService as c1, regionService as c2, reviewService as c3, searchService as c4, setRequestHost as c5, settingService as c6, settingsService as c7, stateService as c8, staticStore as c9, varniCustomProductService as cA, vendorService as cB, warrantyService as cC, wishlistService as cD, storeForHost as ca, storeService as cb, toAddOn as cc, toCart as cd, toCartLine as ce, toCartOffer as cf, toCategory as cg, toCmsPage as ch, toCollection as ci, toEngineAddress as cj, toFreeShipping as ck, toIdentityAddress as cl, toMajor as cm, toMinor as cn, toOrder as co, toPage as cp, toProduct as cq, toRating as cr, toStorefrontFacets as cs, toUser as ct, toVariant as cu, toVendor as cv, uploadService as cw, userService as cx, variantService as cy, varniCustomDesignService as cz, type Approval as d, type AuthResponse as e, AuthService as f, AutocompleteService as g, type B2bRole as h, B2bService as i, BannerService as j, BaseService as k, BlogService as l, type CartLine as m, type CartOffer as n, CartService as o, CatalogService as p, type Category as q, CategoryService as r, ChatService as s, type CheckoutOptions as t, type CheckoutResult as u, CheckoutService as v, type CmsPage as w, type Collection as x, CollectionService as y, type Company as z };
+export { type GoogleReviews as $, type AddOn as A, type B2bPlaced as B, type Cart as C, type CompanyOrder as D, ContactService as E, CountryService as F, CouponService as G, type Credentials as H, type Credit as I, CurrencyService as J, type Customer as K, DealService as L, DemoRequestService as M, type EngineRequest as N, EnquiryService as O, type Envelope as P, type FacetValue as Q, type Faq as R, FaqService as S, FeedbackService as T, type FooterSettings as U, type FreeShipping as V, type Fulfillment as W, GalleryService as X, type GooglePlace as Y, type GoogleReview as Z, GoogleReviewService as _, type Address as a, type StorefrontProduct as a$, type GoogleSurvey as a0, type HeaderSettings as a1, type HomeLayout as a2, type HomeLayoutSection as a3, HomeService as a4, type IdentityAddress as a5, InitService as a6, type Invitation as a7, type LayoutCollection as a8, type LayoutPage as a9, type ProductFacets as aA, type ProductOption as aB, ProductService as aC, ProfileService as aD, type Quote as aE, REDIRECT_GATEWAYS as aF, ReelsService as aG, RegionService as aH, type RejectedLine as aI, type Review as aJ, type ReviewPage as aK, ReviewService as aL, type SearchDoc as aM, type SearchResult as aN, SearchService as aO, SettingService as aP, type ShippingRate as aQ, type SiteChrome as aR, type SiteFooter as aS, type SiteHeader as aT, type SocialLink as aU, StateService as aV, type StoreProfile as aW, StoreService as aX, type StorefrontCategory as aY, type StorefrontMenu as aZ, type StorefrontOrder as a_, LayoutService as aa, type Lead as ab, type ListMeta as ac, MeilisearchService as ad, type Member as ae, type Menu as af, type MenuItem as ag, MenuService as ah, type MenuSummary as ai, type Money as aj, NewsletterService as ak, type Offer as al, type OpeningHours as am, type Order as an, type OrderLine as ao, OrderService as ap, type PageLayout as aq, PageService as ar, type PaymentIntent as as, PaymentMethodService as at, type Plugin as au, PluginService as av, PopularSearchService as aw, PopularityService as ax, type Postcode as ay, type Product as az, AddressService as b, productImages as b$, type ThemeSettings as b0, type ThemeSettingsResult as b1, UploadService as b2, UserService as b3, type Variant as b4, type VariantImage as b5, VariantService as b6, VarniCustomDesignService as b7, VarniCustomProductService as b8, type Vendor as b9, emptyCart as bA, emptyPage as bB, enquiryService as bC, faqService as bD, feedbackService as bE, fromEngineAddress as bF, fromIdentityAddress as bG, fromSearchDoc as bH, galleryService as bI, googleReviewService as bJ, homeService as bK, initService as bL, layoutService as bM, mediaUrl as bN, meilisearchService as bO, menuService as bP, minorToMajor as bQ, newsletterService as bR, orderService as bS, ownDomain as bT, pageService as bU, paymentMethodService as bV, pluginService as bW, pluginsService as bX, popularSearchService as bY, popularityService as bZ, priceOf as b_, VendorService as ba, WarrantyService as bb, type WhatsappConsent as bc, type WhatsappConsentOffer as bd, WhatsappService as be, type Wishlist as bf, type WishlistItem as bg, WishlistService as bh, addressService as bi, authService as bj, autocompleteService as bk, b2bService as bl, bannerService as bm, blogService as bn, cartService as bo, categoryService as bp, chatService as bq, checkoutService as br, collectionService as bs, contactService as bt, countryService as bu, couponService as bv, currencyExponent as bw, currencyService as bx, dealService as by, demoRequestService as bz, type AppliedDiscount as c, productService as c0, productVideos as c1, profileService as c2, qs as c3, reelsService as c4, regionService as c5, reviewService as c6, searchService as c7, setRequestHost as c8, settingService as c9, userService as cA, variantService as cB, varniCustomDesignService as cC, varniCustomProductService as cD, vendorService as cE, warrantyService as cF, whatsappService as cG, wishlistService as cH, settingsService as ca, stateService as cb, staticStore as cc, storeForHost as cd, storeService as ce, toAddOn as cf, toCart as cg, toCartLine as ch, toCartOffer as ci, toCategory as cj, toCmsPage as ck, toCollection as cl, toEngineAddress as cm, toFreeShipping as cn, toIdentityAddress as co, toMajor as cp, toMinor as cq, toOrder as cr, toPage as cs, toProduct as ct, toRating as cu, toStorefrontFacets as cv, toUser as cw, toVariant as cx, toVendor as cy, uploadService as cz, type Approval as d, type AuthResponse as e, AuthService as f, AutocompleteService as g, type B2bRole as h, B2bService as i, BannerService as j, BaseService as k, BlogService as l, type CartLine as m, type CartOffer as n, CartService as o, CatalogService as p, type Category as q, CategoryService as r, ChatService as s, type CheckoutOptions as t, type CheckoutResult as u, CheckoutService as v, type CmsPage as w, type Collection as x, CollectionService as y, type Company as z };

package/dist/index.cjs

@@ -247,6 +247,41 @@ function metaBrowser() {
     event_source_url: window.location.origin + window.location.pathname
   };
 }
+var ATTRIBUTION_KEY = "gc_attribution";
+var ATTRIBUTION_DAYS = 30;
+var TOUCH_FIELDS = [
+  "utm_source",
+  "utm_medium",
+  "utm_campaign",
+  "utm_content",
+  "utm_term",
+  "gclid",
+  "gbraid",
+  "wbraid",
+  "fbclid",
+  "ttclid",
+  "msclkid",
+  "referrer",
+  "at"
+];
+function cleanTouch(raw, now) {
+  if (!raw || typeof raw !== "object") return void 0;
+  const at = Date.parse(String(raw.at ?? ""));
+  if (!Number.isFinite(at) || now - at > ATTRIBUTION_DAYS * 864e5 || at - now > 864e5) return void 0;
+  const out = {};
+  for (const k of TOUCH_FIELDS) {
+    const v = raw[k];
+    if (typeof v === "string" && v.trim()) out[k] = v.trim().slice(0, 200);
+  }
+  return Object.keys(out).length > 1 ? out : void 0;
+}
+function landingAttribution(now = Date.now()) {
+  const saved = readJSON(ATTRIBUTION_KEY);
+  const last = cleanTouch(saved?.last, now);
+  const first = cleanTouch(saved?.first, now) ?? last;
+  if (!first && !last) return void 0;
+  return { ...first ? { first } : {}, ...last ? { last } : {} };
+}
 function storedCartId() {
   const v = readLocal("cart_id");
   if (!v || v === "undefined" || v === "null") return null;
@@ -2221,10 +2256,18 @@ var CheckoutService = class extends BaseService {
     const retry = extras.attempt?.body === `${code}:${serialised}`;
     const key = retry ? extras.attempt.key : newKey();
     const meta = retry ? extras.attempt?.meta : metaBrowser();
-    saveCartExtras(id2, { attempt: { key, body: `${code}:${serialised}`, ...meta ? { meta } : {} } });
+    const attribution = retry ? extras.attempt?.attribution : landingAttribution();
+    saveCartExtras(id2, {
+      attempt: { key, body: `${code}:${serialised}`, ...meta ? { meta } : {}, ...attribution ? { attribution } : {} }
+    });
+    const metadata = {
+      ...extra.metadata,
+      ...meta ? { meta_capi: meta } : {},
+      ...attribution ? { attribution } : {}
+    };
     const result = await this.data(`/api/checkout/${encodeURIComponent(code)}`, {
       method: "POST",
-      body: meta ? { ...body, metadata: { ...extra.metadata, meta_capi: meta } } : body,
+      body: Object.keys(metadata).length ? { ...body, metadata } : body,
       headers: { "Idempotency-Key": key }
     });
     if (result.order.access_token) {
@@ -3673,6 +3716,50 @@ function withAmounts(v) {
 }
 var variantService = new VariantService();
 
+// src/services/whatsapp-service.ts
+var WhatsappService = class extends BaseService {
+  /**
+   * Whether to show the boxes. Never throws: an engine without the module, or
+   * one that fails, answers both off, because checkout must not depend on it.
+   */
+  async consentOffer() {
+    try {
+      const d = await this.data("/x/notify-whatsapp/consent");
+      const enabled = d?.enabled === true;
+      return { enabled, marketing: enabled && d?.marketing === true };
+    } catch {
+      return { enabled: false, marketing: false };
+    }
+  }
+  /**
+   * Records both answers for the phone as typed, against the bag (with
+   * `marketing`, the engine keeps the phone on it for basket reminders). Throws
+   * the engine's 400 (`validation_failed`) when the phone is not a WhatsApp
+   * number for the store's country.
+   */
+  async setConsent({
+    cartId,
+    phone,
+    orderUpdates,
+    marketing
+  }) {
+    const d = await this.data(
+      "/x/notify-whatsapp/consent",
+      {
+        method: "PUT",
+        body: {
+          cart_id: cartId || storedCartId() || "",
+          phone: String(phone ?? "").trim(),
+          order_updates: orderUpdates === true,
+          marketing: marketing === true
+        }
+      }
+    );
+    return { phone: d.phone, orderUpdates: d.order_updates, marketing: d.marketing };
+  }
+};
+var whatsappService = new WhatsappService();
+
 // src/services/b2b-service.ts
 var B2bService = class extends BaseService {
   // ------------------------------------------------------------ company
@@ -3995,6 +4082,7 @@ exports.VarniCustomDesignService = VarniCustomDesignService;
 exports.VarniCustomProductService = VarniCustomProductService;
 exports.VendorService = VendorService;
 exports.WarrantyService = WarrantyService;
+exports.WhatsappService = WhatsappService;
 exports.WishlistService = WishlistService;
 exports.addressService = addressService;
 exports.authService = authService;
@@ -4090,6 +4178,7 @@ exports.varniCustomDesignService = varniCustomDesignService;
 exports.varniCustomProductService = varniCustomProductService;
 exports.vendorService = vendorService;
 exports.warrantyService = warrantyService;
+exports.whatsappService = whatsappService;
 exports.wishlistService = wishlistService;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map