@wocart/storefront 2.1.0 → 3.0.0

package/dist/whatsapp.js

@@ -1,21 +1,3 @@
-/**
- * WhatsApp prefill messages — the storefront's message rule.
- *
- * A storefront's WhatsApp launcher hands the shopper to WhatsApp with the
- * message already written. The template belongs to the merchant (the dashboard
- * authors it within the limits below), and the page
- * resolves it: `{store}`, `{product}`, `{url}`, `{order}`.
- *
- * Three rules live here so no theme re-invents them:
- *
- * 1. **Ad-click parameters are stripped from `{url}`.** A shopper arriving from
- *    a paid ad should not hand the merchant's WhatsApp a `fbclid`-laden link.
- * 2. **The resolved message is capped at `MAX_RESOLVED_PREFILL_LENGTH`, cut at
- *    a word boundary.** Browsers and WhatsApp both truncate silently past a
- *    point; a cut mid-word reads as a broken store.
- * 3. **The encoded text is appended the same way everywhere**, so a base href
- *    that already carries a query string keeps it.
- */
 /**
  * The hard cap on a resolved prefill message, in characters.
  *
@@ -87,3 +69,35 @@ export function buildWhatsAppHref(baseHref, text) {
     const separator = baseHref.includes("?") ? "&" : "?";
     return `${baseHref}${separator}text=${encodeURIComponent(text)}`;
 }
+/**
+ * The store's WhatsApp for one page, or null when it has none: every link a
+ * theme draws to it — the launcher, a footer or menu link, a contact card,
+ * the order confirmation's button — comes from here, so each carries the
+ * page's message and every text is in the page's language.
+ *
+ * Each text is the merchant's when they wrote one, else the theme's `words`.
+ * The message is the page's own template (a product's, an order's), else the
+ * merchant's general one, else the theme's for that kind of page.
+ */
+export function whatsAppContact(config, page, words) {
+    const widget = config.whatsapp;
+    if (!widget)
+        return null;
+    const own = page.kind === "product" ? widget.prefillProduct : page.kind === "order" ? widget.prefillThankYou : null;
+    const template = own ?? widget.prefillGeneral ?? words.messages[page.kind];
+    const message = resolvePrefillText({ template, storeName: config.name, productName: page.product ?? null, url: page.url, orderNumber: page.order ?? null });
+    return {
+        href: buildWhatsAppHref(widget.href, message),
+        launcherLabel: widget.launcherLabel ?? words.launcher,
+        caption: widget.caption ?? words.caption,
+        welcomeMessage: widget.welcomeMessage ?? words.welcome,
+        ctaLabel: widget.ctaLabel ?? words.cta,
+        orderButtonLabel: widget.thankYouButtonLabel ?? words.orderButton,
+        agentName: widget.agentName ?? config.name,
+        avatarUrl: widget.avatarUrl,
+        accent: widget.accent,
+        position: widget.position,
+        attention: widget.attention,
+        surfaces: widget.surfaces,
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wocart/storefront",
-  "version": "2.1.0",
+  "version": "3.0.0",
   "description": "Typed, validated SDK for Wocart cash-on-delivery storefronts: catalog reads, basket, checkout, OTP and order tracking, with Astro adapters.",
   "keywords": [
     "wocart",