@mohasinac/appkit 4.63.4 → 4.64.0

package/dist/features/admin/schemas/firestore.d.ts

@@ -32,6 +32,10 @@ export interface NotificationDocument extends BaseDocument {
     readAt?: Date;
     relatedId?: string;
     relatedType?: NotificationRelatedType;
+    /** Outcome of the async whatsappNotify job for this notification's WhatsApp send, if one was enqueued. */
+    whatsappStatus?: "queued" | "sent" | "failed" | "skipped";
+    /** jobs/{id} doc that ran (or is running) the WhatsApp send for this notification. */
+    whatsappJobId?: string;
 }
 export declare const NOTIFICATIONS_COLLECTION: "notifications";
 export declare const NOTIFICATIONS_INDEXED_FIELDS: readonly ["userId", "isRead", "createdAt", "type"];
@@ -110,6 +114,7 @@ export interface SiteSettingsCredentials {
     /** Webhook signing secret from Razorpay's dashboard → Webhooks. Without it `verifyWebhook()` fails closed. */
     razorpayWebhookSecret?: string;
     resendApiKey?: string;
+    whatsappApiKey?: string;
     metaAppId?: string;
     metaAppSecret?: string;
     metaPageAccessToken?: string;
@@ -124,6 +129,28 @@ export interface SiteSettingsCredentials {
     /** Google Places API for Google Business Reviews (HS4) */
     googleMapsApiKey?: string;
     googlePlaceId?: string;
+    /** WhatsApp Business Cloud API — platform level (for admin purchase announcements) */
+    whatsappPhoneNumberId?: string;
+    whatsappCloudApiToken?: string;
+    /** Comma-separated digits-only phone numbers that receive order announcements */
+    whatsappAdminNotifyNumbers?: string;
+    /**
+     * Approved Meta message-template names, one flat string field per
+     * order-lifecycle notification type — every `SiteSettingsCredentials`
+     * field is stored as an individually-encrypted string (see
+     * `getDecryptedCredentials`/`getCredentialsMasked`, which iterate + mask
+     * every field as a string), so this can't be a `Record<string,string>`
+     * map. Business-initiated WhatsApp sends outside the 24h customer-service
+     * window require a pre-approved template.
+     */
+    whatsappTemplateOrderPlaced?: string;
+    whatsappTemplateOrderConfirmed?: string;
+    whatsappTemplateOrderShipped?: string;
+    whatsappTemplateOrderDelivered?: string;
+    whatsappTemplateOrderCancelled?: string;
+    whatsappTemplateRefundInitiated?: string;
+    /** BCP-47 language code the templates above were approved in, e.g. "en" or "en_US". */
+    whatsappTemplateLanguage?: string;
 }
 export interface SiteSettingsCredentialsMasked {
     phonepeClientId?: string;
@@ -136,6 +163,7 @@ export interface SiteSettingsCredentialsMasked {
     razorpayKeySecret?: string;
     razorpayWebhookSecret?: string;
     resendApiKey?: string;
+    whatsappApiKey?: string;
     metaAppId?: string;
     metaAppSecret?: string;
     metaPageAccessToken?: string;
@@ -147,6 +175,16 @@ export interface SiteSettingsCredentialsMasked {
     deviantartClientSecret?: string;
     googleMapsApiKey?: string;
     googlePlaceId?: string;
+    whatsappPhoneNumberId?: string;
+    whatsappCloudApiToken?: string;
+    whatsappAdminNotifyNumbers?: string;
+    whatsappTemplateOrderPlaced?: string;
+    whatsappTemplateOrderConfirmed?: string;
+    whatsappTemplateOrderShipped?: string;
+    whatsappTemplateOrderDelivered?: string;
+    whatsappTemplateOrderCancelled?: string;
+    whatsappTemplateRefundInitiated?: string;
+    whatsappTemplateLanguage?: string;
 }
 export interface NotificationChannelConfig {
     inApp: {
@@ -162,6 +200,15 @@ export interface NotificationChannelConfig {
         /** Subset of NotificationTypes to email — absent means all types. */
         types?: NotificationType[];
     };
+    whatsapp: {
+        enabled: boolean;
+        /** Minimum priority that triggers a WhatsApp message (default: "high"). */
+        minPriority?: NotificationPriority;
+        /** Subset of NotificationTypes to WhatsApp — absent means all types. */
+        types?: NotificationType[];
+        /** When true, WhatsApp OTP is offered as an alternative to email OTP at checkout. */
+        otpEnabled?: boolean;
+    };
     sms: {
         enabled: boolean;
         /** Minimum priority that triggers an SMS (default: "high"). */
@@ -452,6 +499,29 @@ export interface SiteSettingsDocument extends BaseDocument {
          * ₹2,000 of "handling" on a ₹20,000 order — see `computeCodHandlingFee`.
          */ codHandlingFeeCap: number;
         codHandlingFeePercent: number;
+        /**
+         * Admin master toggle for the per-order, BUYER-paid WhatsApp addon.
+         *
+         * 🛑 Defaults to FALSE. The cost of WhatsApp moved to a standing monthly
+         * charge on the SELLER (`whatsappNotifyMonthlyFee` below) — the platform
+         * owns one number, so the expense is standing rather than per order, and a
+         * buyer should not have to purchase their own delivery updates. The
+         * checkout path that charges it is left intact rather than cut out again:
+         * it is woven through the order-total arithmetic that carries D42's
+         * round-once fix, and disabling it makes the fee resolve to 0 without
+         * touching that money code.
+         */
+        whatsappNotifyFeeEnabled: boolean;
+        /** Flat rupee fee charged to the buyer when they opt into the per-order addon. Unreachable while `whatsappNotifyFeeEnabled` is false. */
+        whatsappNotifyFee: number;
+        /**
+         * What a seller pays per month to receive WhatsApp order notifications —
+         * the admin-set price of `StoreDocument.whatsappNotifySubscribed`.
+         *
+         * Rupees per month, not per message: Meta bills us per template, but a
+         * seller cannot predict their own order count, and a per-message price
+         * would make their bill a function of how well they sold.
+         */ whatsappNotifyMonthlyFee: number;
         /** Admin master toggle — whether the gift-wrap addon is offered at checkout at all. */
         giftWrapFeeEnabled: boolean;
         /** Flat rupee fee charged to the buyer when they opt into gift wrap. */
@@ -537,6 +607,8 @@ export interface SiteSettingsDocument extends BaseDocument {
     messaging?: {
         /** User-facing email. Staff mail (daily digest, payout summary) ignores this. */
         emailEnabled: boolean;
+        /** User-facing WhatsApp. Same exemption for staff. */
+        whatsappEnabled: boolean;
         /**
          * Reserved sends allowed per channel per day. Applies to staff and
          * transactional mail too — the ceiling exists to stay inside the
@@ -544,6 +616,7 @@ export interface SiteSettingsDocument extends BaseDocument {
          */
         dailyCeiling: {
             email: number;
+            whatsapp: number;
             sms: number;
         };
     };

package/dist/features/admin/schemas/firestore.js

@@ -15,7 +15,7 @@ export const ADMIN_CHECKOUT_BYPASS_FLAG_KEY = "adminCheckoutBypass";
  *   · `constants/notification-types.ts` (9) — fed the admin filter chips and
  *     the per-channel allow-list, so the admin list could not filter 18 of
  *     the 27 real types and an admin literally could not allow-list
- *     `offer_received` or `payment_review` for email
+ *     `offer_received` or `payment_review` for email or WhatsApp
  *   · `features/account/types/index.ts` (5: order|offer|promo|system|message)
  *     — a different vocabulary entirely, on a `UserNotification` type with
  *     zero real consumers
@@ -195,6 +195,7 @@ export const notificationQueryHelpers = {
 export const DEFAULT_NOTIFICATION_CHANNELS = {
     inApp: { enabled: true, readOnly: true },
     email: { enabled: false, minPriority: "normal" },
+    whatsapp: { enabled: false, minPriority: "high", otpEnabled: false },
     sms: { enabled: false, minPriority: "high" },
 };
 const PRIORITY_ORDER = {
@@ -254,7 +255,8 @@ export const DEFAULT_SITE_SETTINGS_DATA = {
     // half-configured site.
     messaging: {
         emailEnabled: false,
-        dailyCeiling: { email: 80, sms: 50 },
+        whatsappEnabled: false,
+        dailyCeiling: { email: 80, whatsapp: 200, sms: 50 },
     },
     emi: {
         enabled: false,
@@ -277,9 +279,12 @@ export const DEFAULT_SITE_SETTINGS_DATA = {
         // The buyer add-ons ship ENABLED. They were `false`, which made
         // StoreAddonsPicker return null on both the cart and checkout, so a fresh
         // install had no add-ons at all and no indication why. `undefined` still
-        // means disabled everywhere (computeGiftWrapFee et al. read
+        // means disabled everywhere (computeWhatsAppNotifyFee et al. read
         // `if (!rates.XEnabled) return 0`) — only the DEFAULT changed, so an
         // existing siteSettings document keeps whatever it already stored.
+        whatsappNotifyFeeEnabled: false,
+        whatsappNotifyFee: 10,
+        whatsappNotifyMonthlyFee: 199,
         giftWrapFeeEnabled: true,
         giftWrapFee: 49,
         shipmentProtectionFeeEnabled: true,

package/dist/features/auth/checkout-value-otp.d.ts

@@ -44,6 +44,6 @@ export interface CheckoutValueOtpDoc {
  * making the whole feature look broken.
  */
 export declare function enforceCheckoutValueOtpRateLimit(db: Db, uid: string): Promise<void>;
-/** Build the checkout-value OTP message body. */
+/** Build the checkout-value OTP WhatsApp/SMS message body. */
 export declare function buildCheckoutValueOtpMessage(code: string, siteName: string): string;
 export {};

package/dist/features/auth/checkout-value-otp.js

@@ -75,7 +75,7 @@ export async function enforceCheckoutValueOtpRateLimit(db, uid) {
         tx.set(metaRef, { lastSentAt: new Date() }, { merge: true });
     });
 }
-/** Build the checkout-value OTP message body. */
+/** Build the checkout-value OTP WhatsApp/SMS message body. */
 export function buildCheckoutValueOtpMessage(code, siteName) {
     return (`*${siteName} — Order Verification*\n\n` +
         `Your verification code for this high-value order is: *${code}*\n\n` +

package/dist/features/auth/permissions/constants.d.ts

@@ -83,7 +83,7 @@ export declare const ROUTE_PERMISSION_MAP: Record<string, Permission>;
  *
  * Defaults on store creation: ["suggest_brands", "create_coupons"]
  */
-export type StoreCapability = "advanced_listing_types" | "host_auctions" | "host_preorders" | "create_categories" | "suggest_brands" | "create_coupons" | "bulk_listing_import" | "extended_return_window" | "verified_seller" | "featured_placement" | "promotional_banner" | "priority_support" | "multiple_stores" | "custom_store_slug" | "api_access" | "lower_commission_rate" | "early_access_features" | "advanced_analytics";
+export type StoreCapability = "advanced_listing_types" | "host_auctions" | "host_preorders" | "create_categories" | "suggest_brands" | "create_coupons" | "bulk_listing_import" | "extended_return_window" | "verified_seller" | "featured_placement" | "promotional_banner" | "priority_support" | "multiple_stores" | "custom_store_slug" | "api_access" | "lower_commission_rate" | "early_access_features" | "advanced_analytics" | "whatsapp_catalog_sync";
 export declare const ALL_STORE_CAPABILITIES: StoreCapability[];
 /** Narrow an untrusted string to a real capability. */
 export declare function isStoreCapability(value: unknown): value is StoreCapability;
@@ -118,7 +118,7 @@ export declare function hasCapability(capabilities: StoreCapability[], required:
  *
  * 🛑 The PURE half of `getStoreCapabilities`, extracted so a caller that
  * already holds the store document does not pay a second Firestore read to ask
- * what it is entitled to (Rule #6). Several routes were reading
+ * what it is entitled to (Rule #6). Three WhatsApp routes were reading
  * `store.capabilities ?? []` inline for exactly that reason, which made them a
  * second, divergent reader of the field — they skipped the default merge, so
  * they and `getStoreCapabilities` could disagree about the same store.

package/dist/features/auth/permissions/constants.js

@@ -390,6 +390,7 @@ const STORE_CAPABILITY_MAP = {
     lower_commission_rate: true,
     early_access_features: true,
     advanced_analytics: true,
+    whatsapp_catalog_sync: true,
 };
 export const ALL_STORE_CAPABILITIES = Object.keys(STORE_CAPABILITY_MAP);
 /** Narrow an untrusted string to a real capability. */
@@ -441,7 +442,7 @@ export function hasCapability(capabilities, required) {
  *
  * 🛑 The PURE half of `getStoreCapabilities`, extracted so a caller that
  * already holds the store document does not pay a second Firestore read to ask
- * what it is entitled to (Rule #6). Several routes were reading
+ * what it is entitled to (Rule #6). Three WhatsApp routes were reading
  * `store.capabilities ?? []` inline for exactly that reason, which made them a
  * second, divergent reader of the field — they skipped the default merge, so
  * they and `getStoreCapabilities` could disagree about the same store.

package/dist/features/blog/components/BlogIndexPageView.js

@@ -1,6 +1,6 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { blogRepository } from "../../../repositories/index.js";
-import { Container, Heading, Main, Section } from "../../../ui/index.js";
+import { Container, Main, Section, PageHeroHeading } from "../../../ui/index.js";
 import { AdSlot } from "../../homepage/components/AdSlot.js";
 import { BlogIndexListing } from "./BlogIndexListing.js";
 import { BLOG_DEFAULT_PUBLIC_SORT } from "../schemas/firestore.js";
@@ -41,5 +41,5 @@ export async function BlogIndexPageView({ searchParams = {} }) {
             },
         }
         : undefined;
-    return (_jsx(Main, { children: _jsx(Section, { padding: "y-2xl", children: _jsxs(Container, { size: "xl", children: [_jsx(Heading, { level: 1, className: "mb-8", color: "primary", size: "3xl", weight: "semibold", children: "Blog" }), _jsx(AdSlot, { id: "listing-sidebar-top", className: "mb-6" }), _jsx(BlogIndexListing, { initialData: initialData }), _jsx(AdSlot, { id: "listing-sidebar-bottom", className: "mt-8" })] }) }) }));
+    return (_jsx(Main, { children: _jsx(Section, { padding: "y-2xl", children: _jsxs(Container, { size: "xl", children: [_jsx(PageHeroHeading, { className: "mb-8", pill: "From the shop floor", title: "Blog", description: "Buying guides, release notes and what we have learned importing and grading Beyblades.", meta: initialData?.meta?.total ? `${initialData.meta.total} articles` : undefined }), _jsx(AdSlot, { id: "listing-sidebar-top", className: "mb-6" }), _jsx(BlogIndexListing, { initialData: initialData }), _jsx(AdSlot, { id: "listing-sidebar-bottom", className: "mt-8" })] }) }) }));
 }

package/dist/features/blog/components/BlogListView.js

@@ -3,6 +3,7 @@ import React from "react";
 import Link from "next/link.js";
 import { Article, Div, Grid, Heading, OverflowRow, Pagination, Row, Span, Stack, Text } from "../../../ui/index.js";
 import { MediaImage } from "../../media/MediaImage.js";
+import { blogCategoryBadge } from "../constants/category-badge.js";
 import { getDefaultLocale } from "../../../core/baseline-resolver.js";
 import { getMediaUrl } from "../../media/types/index.js";
 import { safeDisplayName } from "../../../security/index.js";
@@ -25,7 +26,7 @@ export function BlogCard({ post, href, onClick, className = "" }) {
     const isInteractive = !!(href || onClick);
     const card = (_jsxs(Article, { role: onClick && !href ? "button" : undefined, tabIndex: onClick && !href ? 0 : undefined, onKeyDown: onClick && !href
             ? (e) => (e.key === "Enter" || e.key === "") && onClick(post)
-            : undefined, onClick: onClick && !href ? () => onClick(post) : undefined, className: `group flex flex-col h-full overflow-hidden rounded-xl border border-[var(--appkit-color-border)] bg-[var(--appkit-color-surface)] shadow-sm transition hover:shadow-md ${isInteractive ? "cursor-pointer" : ""} ${className}`, children: [_jsx(Div, { className: `relative aspect-video w-full ${__O.hidden} bg-[var(--appkit-color-surface)] dark:bg-[var(--appkit-color-surface-elevated)] flex-shrink-0`, children: coverImageUrl ? (_jsx(MediaImage, { src: coverImageUrl, alt: post.title, size: "card", className: "transition-transform duration-300 group-hover:scale-105" })) : (_jsx(Row, { surface: "muted", className: "h-full w-full", align: "center", justify: "center", children: _jsx(Span, { className: "opacity-30", size: "4xl", "aria-hidden": "true", children: "\u270D\uFE0F" }) })) }), _jsxs(Stack, { className: `flex-1 ${__P.p5}`, children: [_jsxs(Row, { className: "mb-2", gap: "sm", wrap: true, children: [_jsx(Span, { size: "xs", weight: "medium", className: "bg-primary/10 text-primary", rounded: "full", padding: "pill-xs", transform: "capitalize", children: post.category }), post.isFeatured && (_jsx(Span, { size: "xs", weight: "medium", className: CLS_FEATURED_BADGE, children: "Featured" })), post.readTimeMinutes && (_jsxs(Span, { size: "xs", color: "muted", children: [post.readTimeMinutes, " min read"] }))] }), _jsx(Heading, { level: 3, className: `group-hover:text-primary`, color: "primary", truncate: 2, size: "base", weight: "semibold", children: post.title }), post.excerpt && (_jsx(Text, { className: `mt-2 flex-1`, color: "muted", truncate: 3, size: "sm", children: post.excerpt })), _jsxs(Row, { className: "mt-auto", padding: "t-sm", gap: "3", children: [post.authorAvatar ? (_jsx(Div, { className: "relative h-7 w-7 flex-shrink-0", rounded: "full", overflow: "hidden", children: _jsx(MediaImage, { src: post.authorAvatar, alt: post.authorName ?? "author", size: "avatar" }) })) : post.authorName ? (_jsx(Row, { textWeight: "bold", textSize: "xs", className: "h-7 w-7 flex-shrink-0 bg-primary/10 text-primary", align: "center", justify: "center", rounded: "full", children: post.authorName.charAt(0).toUpperCase() })) : null, _jsxs(Text, { className: "text-[var(--appkit-color-text-muted)] min-w-0", size: "xs", children: [post.authorName && (_jsx(Span, { weight: "medium", className: "text-neutral-700", children: safeDisplayName(post.authorName, "Author") })), date && _jsxs(Span, { className: "ml-1 text-neutral-400", children: ["\u00B7 ", date] })] })] })] })] }));
+            : undefined, onClick: onClick && !href ? () => onClick(post) : undefined, className: `group flex flex-col h-full overflow-hidden rounded-xl border border-[var(--appkit-color-border)] bg-[var(--appkit-color-surface)] shadow-sm transition hover:shadow-md ${isInteractive ? "cursor-pointer" : ""} ${className}`, children: [_jsx(Div, { className: `relative aspect-video w-full ${__O.hidden} bg-[var(--appkit-color-surface)] dark:bg-[var(--appkit-color-surface-elevated)] flex-shrink-0`, children: coverImageUrl ? (_jsx(MediaImage, { src: coverImageUrl, alt: post.title, size: "card", className: "transition-transform duration-300 group-hover:scale-105" })) : (_jsx(Row, { surface: "muted", className: "h-full w-full", align: "center", justify: "center", children: _jsx(Span, { className: "opacity-30", size: "4xl", "aria-hidden": "true", children: "\u270D\uFE0F" }) })) }), _jsxs(Stack, { className: `flex-1 ${__P.p5}`, children: [_jsxs(Row, { className: "mb-2", gap: "sm", wrap: true, children: [_jsx(Span, { size: "xs", weight: "medium", className: blogCategoryBadge(post.category), rounded: "full", padding: "pill-xs", transform: "capitalize", children: post.category }), post.isFeatured && (_jsx(Span, { size: "xs", weight: "medium", className: CLS_FEATURED_BADGE, children: "Featured" })), post.readTimeMinutes && (_jsxs(Span, { size: "xs", color: "muted", children: [post.readTimeMinutes, " min read"] }))] }), _jsx(Heading, { level: 3, className: `group-hover:text-primary`, color: "primary", truncate: 2, size: "base", weight: "semibold", children: post.title }), post.excerpt && (_jsx(Text, { className: `mt-2 flex-1`, color: "muted", truncate: 3, size: "sm", children: post.excerpt })), _jsxs(Row, { className: "mt-auto", padding: "t-sm", gap: "3", children: [post.authorAvatar ? (_jsx(Div, { className: "relative h-7 w-7 flex-shrink-0", rounded: "full", overflow: "hidden", children: _jsx(MediaImage, { src: post.authorAvatar, alt: post.authorName ?? "author", size: "avatar" }) })) : post.authorName ? (_jsx(Row, { textWeight: "bold", textSize: "xs", className: "h-7 w-7 flex-shrink-0 bg-primary/10 text-primary", align: "center", justify: "center", rounded: "full", children: post.authorName.charAt(0).toUpperCase() })) : null, _jsxs(Text, { className: "text-[var(--appkit-color-text-muted)] min-w-0", size: "xs", children: [post.authorName && (_jsx(Span, { weight: "medium", className: "text-neutral-700", children: safeDisplayName(post.authorName, "Author") })), date && _jsxs(Span, { className: "ml-1 text-neutral-400", children: ["\u00B7 ", date] })] })] }), _jsxs(Row, { align: "center", gap: "xs", className: "mt-3 text-primary", textSize: "sm", textWeight: "medium", children: [_jsx(Span, { children: "Read" }), _jsx(Span, { "aria-hidden": "true", className: "transition-transform duration-200 group-hover:translate-x-1", children: "\u2192" })] })] })] }));
     if (href) {
         return (_jsx(Link, { href: href, className: "block h-full", children: card }));
     }

package/dist/features/blog/components/BlogPostView.js

@@ -5,6 +5,7 @@ import Link from "next/link.js";
 import { Div, Grid, Heading, RichText, Row, Scrim, Span, Stack, Text } from "../../../ui/index.js";
 import { Iframe } from "../../../ui/components/Iframe.js";
 import { MediaImage } from "../../media/MediaImage.js";
+import { blogCategoryBadge } from "../constants/category-badge.js";
 import { useBlogPost } from "../hooks/useBlog.js";
 import { BlogCard } from "./BlogListView.js";
 import { getMediaUrl } from "../../media/types/index.js";
@@ -56,5 +57,5 @@ export function BlogPostView({ slug, initialData, labels = {}, renderImage, rend
         })
         : "";
     const coverImageUrl = getMediaUrl(post.coverImage);
-    return (_jsxs(Div, { className: `min-h-screen ${className}`, children: [coverImageUrl && (_jsxs(Div, { className: `relative h-72 md:h-96 ${__O.hidden}`, children: [renderImage ? (renderImage(post)) : (_jsx(MediaImage, { src: coverImageUrl, alt: post.title, size: "hero" })), _jsx(Scrim, { direction: "bottom-up", intensity: "subtle", className: "absolute inset-0" })] })), _jsxs(Div, { className: "max-w-3xl mx-auto", paddingY: "y-3xl", paddingX: "x-md", children: [renderBlogPostHeader(post, date, labels), post.youtubeId && /^[A-Za-z0-9_-]{6,20}$/.test(post.youtubeId) && (_jsx(Div, { className: "mb-8", children: _jsx(Iframe, { src: `https://www.youtube-nocookie.com/embed/${post.youtubeId}`, title: `${post.title} — video`, aspect: "video", rounded: "lg" }) })), post.tags && post.tags.length > 0 && (_jsx(Row, { wrap: true, gap: "sm", className: "mb-8", children: post.tags.map((tag) => (_jsxs(Link, { href: `${String(ROUTES.BLOG.LIST)}?tags=${encodeURIComponent(tag)}`, className: "inline-block px-[var(--appkit-space-3)] py-[var(--appkit-space-1)] rounded-full bg-[var(--appkit-color-surface-elevated)] hover:bg-primary/10 text-[var(--appkit-color-text-muted)] hover:text-primary text-[length:var(--appkit-text-xs)] font-medium transition-colors", children: ["#", tag] }, tag))) })), renderAuthorBio && _jsx(Div, { className: "mb-6", children: renderAuthorBio(post) }), _jsx(Div, { surface: "card", padding: "xl", className: "mb-12", children: renderContent ? renderContent(post) : (_jsx(RichText, { html: normalizeRichTextHtml(post.content ?? ""), proseClass: "prose max-w-none dark:prose-invert" })) }), _jsxs(Stack, { gap: "xl", children: [renderBlogPostRelated(related, labels?.relatedTitle ?? "Related Posts", renderRelatedCard), renderBlogPostRelated(relatedByTags, labels?.relatedByTagsTitle ?? "You might also like", renderRelatedCard), renderBlogPostRelated(relatedByAuthor, labels?.relatedByAuthorTitle ?? `More from ${post.authorName}`, renderRelatedCard)] }), renderBackButton && _jsx(Div, { border: "default", className: "mt-10 border-t", padding: "t-xl", children: renderBackButton() })] })] }));
+    return (_jsxs(Div, { className: `min-h-screen ${className}`, children: [coverImageUrl && (_jsxs(Div, { className: `relative h-72 md:h-[28rem] ${__O.hidden}`, children: [renderImage ? (renderImage(post)) : (_jsx(MediaImage, { src: coverImageUrl, alt: post.title, size: "hero", objectFit: "cover" })), _jsx(Scrim, { direction: "bottom-up", intensity: "strong", className: "absolute inset-0" }), _jsx(Div, { className: "absolute inset-x-0 bottom-0", children: _jsxs(Stack, { className: "mx-auto max-w-3xl", gap: "sm", paddingX: "x-md", paddingY: "y-xl", children: [_jsxs(Row, { gap: "sm", wrap: true, children: [_jsx(Span, { size: "xs", weight: "medium", className: `inline-block capitalize ${blogCategoryBadge(post.category)}`, rounded: "full", padding: "pill-xs", children: post.category }), post.isFeatured && (_jsx(Span, { size: "xs", weight: "medium", className: CLS_FEATURED_BADGE, children: labels?.featured ?? "Featured" }))] }), _jsx(Heading, { level: 1, size: "3xl", mdSize: "4xl", weight: "bold", color: "inverse", shadow: "lg", children: post.title }), _jsxs(Row, { color: "inverse", textSize: "sm", wrap: true, gap: "md", className: "opacity-90", children: [post.authorName && (_jsxs(Span, { children: [labels?.author ?? "By", " ", _jsx(Span, { weight: "medium", children: post.authorName })] })), post.readTimeMinutes != null && (_jsxs(Span, { children: [post.readTimeMinutes, " ", labels?.readTime ?? "min read"] })), date && _jsx(Span, { children: date })] })] }) })] })), _jsxs(Div, { className: "max-w-3xl mx-auto", paddingY: "y-3xl", paddingX: "x-md", children: [!coverImageUrl && renderBlogPostHeader(post, date, labels), post.youtubeId && /^[A-Za-z0-9_-]{6,20}$/.test(post.youtubeId) && (_jsx(Div, { className: "mb-8", children: _jsx(Iframe, { src: `https://www.youtube-nocookie.com/embed/${post.youtubeId}`, title: `${post.title} — video`, aspect: "video", rounded: "lg" }) })), post.tags && post.tags.length > 0 && (_jsx(Row, { wrap: true, gap: "sm", className: "mb-8", children: post.tags.map((tag) => (_jsxs(Link, { href: `${String(ROUTES.BLOG.LIST)}?tags=${encodeURIComponent(tag)}`, className: "inline-block px-[var(--appkit-space-3)] py-[var(--appkit-space-1)] rounded-full bg-[var(--appkit-color-surface-elevated)] hover:bg-primary/10 text-[var(--appkit-color-text-muted)] hover:text-primary text-[length:var(--appkit-text-xs)] font-medium transition-colors", children: ["#", tag] }, tag))) })), renderAuthorBio && _jsx(Div, { className: "mb-6", children: renderAuthorBio(post) }), _jsx(Div, { surface: "card", padding: "xl", className: "mb-12", children: renderContent ? renderContent(post) : (_jsx(RichText, { html: normalizeRichTextHtml(post.content ?? ""), proseClass: "prose max-w-none dark:prose-invert" })) }), renderBackButton && _jsx(Div, { border: "default", className: "mt-10 border-t", padding: "t-xl", children: renderBackButton() })] }), _jsx(Div, { className: "mx-auto max-w-6xl", paddingX: "x-md", paddingY: "y-2xl", children: _jsxs(Stack, { gap: "xl", children: [renderBlogPostRelated(related, labels?.relatedTitle ?? "Related Posts", renderRelatedCard), renderBlogPostRelated(relatedByTags, labels?.relatedByTagsTitle ?? "You might also like", renderRelatedCard), renderBlogPostRelated(relatedByAuthor, labels?.relatedByAuthorTitle ?? `More from ${post.authorName}`, renderRelatedCard)] }) })] }));
 }

package/dist/features/blog/constants/category-badge.d.ts

@@ -0,0 +1,33 @@
+/**
+ * The per-category chip palette, shared by every blog surface.
+ *
+ * ## Why this moved out of `BlogFeaturedCard`
+ *
+ * There were two palettes and only one of them had colours. `BlogFeaturedCard`
+ * carried this real five-way map — and that component is mounted ONLY on the
+ * homepage rail. `BlogCard`, which is what `/blog` and every related-posts
+ * grid actually render, painted all five categories one flat
+ * `bg-primary/10 text-primary`.
+ *
+ * So the index — the page where telling a guide from a release note is worth
+ * something, because you are scanning twenty of them — was the one surface
+ * with no category colour at all.
+ *
+ * 🛑 `Record<BlogPostCategory, string>`, so a sixth category is a compile
+ * error rather than a card that silently falls back to grey.
+ *
+ * @tag domain:blog
+ * @tag layer:constants
+ */
+import type { BlogPostCategory } from "../types";
+export declare const BLOG_CATEGORY_BADGE: Record<BlogPostCategory, string>;
+/**
+ * Neutral fallback for a value that is not a known category.
+ *
+ * 🛑 Both halves are theme-relative tokens that invert together. Never pair a
+ * `-surface` tint with a literal `text-white`: `-surface` is a near-white tint
+ * in light themes and a dark tint in dark ones, so fixed-white ink is
+ * invisible in exactly one of them (Root Cause #67).
+ */
+export declare const BLOG_CATEGORY_BADGE_FALLBACK = "bg-[var(--appkit-color-bg)] text-[var(--appkit-color-text-muted)]";
+export declare function blogCategoryBadge(category: string | undefined): string;

package/dist/features/blog/constants/category-badge.js

@@ -0,0 +1,40 @@
+/**
+ * The per-category chip palette, shared by every blog surface.
+ *
+ * ## Why this moved out of `BlogFeaturedCard`
+ *
+ * There were two palettes and only one of them had colours. `BlogFeaturedCard`
+ * carried this real five-way map — and that component is mounted ONLY on the
+ * homepage rail. `BlogCard`, which is what `/blog` and every related-posts
+ * grid actually render, painted all five categories one flat
+ * `bg-primary/10 text-primary`.
+ *
+ * So the index — the page where telling a guide from a release note is worth
+ * something, because you are scanning twenty of them — was the one surface
+ * with no category colour at all.
+ *
+ * 🛑 `Record<BlogPostCategory, string>`, so a sixth category is a compile
+ * error rather than a card that silently falls back to grey.
+ *
+ * @tag domain:blog
+ * @tag layer:constants
+ */
+export const BLOG_CATEGORY_BADGE = {
+    news: "bg-info-surface text-info",
+    tips: "bg-success-surface text-success",
+    guides: "bg-indigo-100 text-indigo-800 dark:bg-indigo-900/40 dark:text-indigo-300",
+    updates: "bg-purple-100 text-purple-800 dark:bg-purple-900/40 dark:text-purple-300",
+    community: "bg-warning-surface text-warning",
+};
+/**
+ * Neutral fallback for a value that is not a known category.
+ *
+ * 🛑 Both halves are theme-relative tokens that invert together. Never pair a
+ * `-surface` tint with a literal `text-white`: `-surface` is a near-white tint
+ * in light themes and a dark tint in dark ones, so fixed-white ink is
+ * invisible in exactly one of them (Root Cause #67).
+ */
+export const BLOG_CATEGORY_BADGE_FALLBACK = "bg-[var(--appkit-color-bg)] text-[var(--appkit-color-text-muted)]";
+export function blogCategoryBadge(category) {
+    return (BLOG_CATEGORY_BADGE[category] ?? BLOG_CATEGORY_BADGE_FALLBACK);
+}

package/dist/features/cart/components/CartPriceBreakdown.d.ts

@@ -22,6 +22,7 @@ export interface CartPriceBreakdownStore {
     subtotal: number;
     shippingFee: number;
     codHandlingFee: number;
+    whatsappNotifyFee: number;
     giftWrapFee: number;
     shipmentProtectionFee: number;
     saleProtectionFee: number;
@@ -44,6 +45,7 @@ export interface CartPriceBreakdownData {
     subtotal: number;
     shippingFee: number;
     codHandlingFee: number;
+    whatsappNotifyFee: number;
     giftWrapFee: number;
     shipmentProtectionFee: number;
     saleProtectionFee: number;

package/dist/features/cart/components/CartPriceBreakdown.js

@@ -40,7 +40,7 @@ export function CartPriceBreakdown({ preview, itemCount, currency = "INR", unava
     const subtotalLabel = itemCount !== undefined
         ? `Subtotal (${itemCount} item${itemCount !== 1 ? "s" : ""}${storeCount > 1 ? `, ${storeCount} stores` : ""})`
         : "Subtotal";
-    return (_jsxs(Stack, { gap: "xs", className: className, children: [_jsx(Line, { label: subtotalLabel, amount: money(preview.subtotal) }), preview.shippingFee > 0 && (_jsx(Line, { label: withStoreCount("Shipping", storeCount), amount: money(preview.shippingFee) })), preview.codHandlingFee > 0 && (_jsx(Line, { label: "COD handling fee", amount: money(preview.codHandlingFee), derivation: derivations?.codHandlingFee })), preview.giftWrapFee > 0 && (_jsx(Line, { label: withStoreCount("Gift wrap", countCharged((s) => s.giftWrapFee)), amount: money(preview.giftWrapFee) })), preview.shipmentProtectionFee > 0 && (_jsx(Line, { label: withStoreCount("Shipment protection", countCharged((s) => s.shipmentProtectionFee)), amount: money(preview.shipmentProtectionFee) })), preview.saleProtectionFee > 0 && (_jsx(Line, { label: withStoreCount("Sale protection", countCharged((s) => s.saleProtectionFee)), amount: money(preview.saleProtectionFee) })), preview.emiSurcharge > 0 && (_jsx(Line, { label: "EMI surcharge", amount: money(preview.emiSurcharge), derivation: derivations?.emiSurcharge })), preview.sharedPurchaseFee > 0 && (_jsx(Line, { label: withStoreCount("Split delivery", countCharged((s) => s.sharedPurchaseFee)), amount: money(preview.sharedPurchaseFee) })), preview.platformFee > 0 && (_jsx(Line, { label: "Platform fee", amount: money(preview.platformFee), derivation: derivations?.platformFee })), preview.gstOnFee > 0 && (_jsx(Line, { label: "GST on platform fee", amount: money(preview.gstOnFee), derivation: derivations?.gstOnFee })), preview.couponDiscount > 0 && (_jsx(Line, { label: "Coupon discount", amount: `−${money(preview.couponDiscount)}`, tone: "success" })), _jsx(Div, { border: "top-subtle", paddingY: "t-sm", children: _jsx(Line, { label: "Total", amount: money(preview.total), tone: "primary", strong: preview.pointsApplied <= 0 }) }), preview.pointsApplied > 0 && (_jsxs(_Fragment, { children: [_jsx(Line, { label: `Points applied (${preview.pointsApplied.toLocaleString("en-IN")} pts)`, amount: `−${money(preview.pointsApplied)}`, tone: "success" }), _jsx(Div, { border: "top-subtle", paddingY: "t-sm", children: _jsx(Line, { label: "Amount due", amount: money(preview.amountDue), tone: "primary", strong: true }) })] })), preview.pointsApplied > 0 && preview.pointsBalance > preview.pointsApplied && (_jsxs(Text, { size: "xs", color: "muted", children: [(preview.pointsBalance - preview.pointsApplied).toLocaleString("en-IN"), " points stay in your balance \u2014 up to half of an order can be paid with points."] })), preview.pointsApplied === 0 && preview.pointsBalance > 0 && (_jsx(Text, { size: "xs", color: "muted", children: preview.stores.some((s) => s.acceptsPoints)
+    return (_jsxs(Stack, { gap: "xs", className: className, children: [_jsx(Line, { label: subtotalLabel, amount: money(preview.subtotal) }), preview.shippingFee > 0 && (_jsx(Line, { label: withStoreCount("Shipping", storeCount), amount: money(preview.shippingFee) })), preview.codHandlingFee > 0 && (_jsx(Line, { label: "COD handling fee", amount: money(preview.codHandlingFee), derivation: derivations?.codHandlingFee })), preview.whatsappNotifyFee > 0 && (_jsx(Line, { label: withStoreCount("WhatsApp updates", countCharged((s) => s.whatsappNotifyFee)), amount: money(preview.whatsappNotifyFee) })), preview.giftWrapFee > 0 && (_jsx(Line, { label: withStoreCount("Gift wrap", countCharged((s) => s.giftWrapFee)), amount: money(preview.giftWrapFee) })), preview.shipmentProtectionFee > 0 && (_jsx(Line, { label: withStoreCount("Shipment protection", countCharged((s) => s.shipmentProtectionFee)), amount: money(preview.shipmentProtectionFee) })), preview.saleProtectionFee > 0 && (_jsx(Line, { label: withStoreCount("Sale protection", countCharged((s) => s.saleProtectionFee)), amount: money(preview.saleProtectionFee) })), preview.emiSurcharge > 0 && (_jsx(Line, { label: "EMI surcharge", amount: money(preview.emiSurcharge), derivation: derivations?.emiSurcharge })), preview.sharedPurchaseFee > 0 && (_jsx(Line, { label: withStoreCount("Split delivery", countCharged((s) => s.sharedPurchaseFee)), amount: money(preview.sharedPurchaseFee) })), preview.platformFee > 0 && (_jsx(Line, { label: "Platform fee", amount: money(preview.platformFee), derivation: derivations?.platformFee })), preview.gstOnFee > 0 && (_jsx(Line, { label: "GST on platform fee", amount: money(preview.gstOnFee), derivation: derivations?.gstOnFee })), preview.couponDiscount > 0 && (_jsx(Line, { label: "Coupon discount", amount: `−${money(preview.couponDiscount)}`, tone: "success" })), _jsx(Div, { border: "top-subtle", paddingY: "t-sm", children: _jsx(Line, { label: "Total", amount: money(preview.total), tone: "primary", strong: preview.pointsApplied <= 0 }) }), preview.pointsApplied > 0 && (_jsxs(_Fragment, { children: [_jsx(Line, { label: `Points applied (${preview.pointsApplied.toLocaleString("en-IN")} pts)`, amount: `−${money(preview.pointsApplied)}`, tone: "success" }), _jsx(Div, { border: "top-subtle", paddingY: "t-sm", children: _jsx(Line, { label: "Amount due", amount: money(preview.amountDue), tone: "primary", strong: true }) })] })), preview.pointsApplied > 0 && preview.pointsBalance > preview.pointsApplied && (_jsxs(Text, { size: "xs", color: "muted", children: [(preview.pointsBalance - preview.pointsApplied).toLocaleString("en-IN"), " points stay in your balance \u2014 up to half of an order can be paid with points."] })), preview.pointsApplied === 0 && preview.pointsBalance > 0 && (_jsx(Text, { size: "xs", color: "muted", children: preview.stores.some((s) => s.acceptsPoints)
                     ? "Your points could not be applied to this order."
                     : storeCount > 1
                         ? "None of these sellers accepts points."

package/dist/features/cart/components/StoreAddonsPicker.d.ts

@@ -3,12 +3,13 @@ import React from "react";
  * Paid add-on checkboxes for ONE store.
  *
  * Add-on fees are billed per order group (= per store), so they are chosen per
- * store: ticking "gift wrap" for one seller must not bill it for every
+ * store: ticking "WhatsApp updates" for one seller must not bill it for every
  * seller in the cart. Rendered inside that store's card in the cart, and inside
  * that store's row of the checkout summary — Buy Now skips the cart entirely,
  * so both surfaces have to be able to edit them.
  */
 export interface StoreAddonsValue {
+    whatsappNotifyAddon?: boolean;
     giftWrapAddon?: boolean;
     giftWrapMessage?: string;
     shipmentProtectionAddon?: boolean;
@@ -16,6 +17,8 @@ export interface StoreAddonsValue {
 }
 /** The subset of `siteSettings.commissions` that gates and prices the add-ons. */
 export interface StoreAddonsRates {
+    whatsappNotifyFeeEnabled?: boolean;
+    whatsappNotifyFee?: number;
     giftWrapFeeEnabled?: boolean;
     giftWrapFee?: number;
     shipmentProtectionFeeEnabled?: boolean;
@@ -56,7 +59,7 @@ export interface StoreProtectionContext {
  * showing an explanatory line instead.
  *
  * 🛑 Deliberately asks only about TIER 1. A seller who supports neither
- * protection still has gift wrap, and a store whose only
+ * protection still has WhatsApp updates and gift wrap, and a store whose only
  * enabled add-ons are protections it declined must still render the picker —
  * because that is where the risk notice lives, and a hidden notice is the
  * tri-state failure in § `StoreProtectionContext`.

package/dist/features/cart/components/StoreAddonsPicker.js

@@ -1,6 +1,6 @@
 "use client";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { Gift, ShieldAlert, ShieldCheck, ShieldOff } from "lucide-react";
+import { Gift, MessageCircle, ShieldAlert, ShieldCheck, ShieldOff } from "lucide-react";
 import { Div, Row, Stack, Text } from "../../../ui/index.js";
 import { Disclaimer } from "../../../ui/components/Disclaimer.js";
 import { IconBox } from "../../../ui/components/IconBox.js";
@@ -16,14 +16,15 @@ import { formatCurrency } from "../../../utils/number.formatter.js";
  * showing an explanatory line instead.
  *
  * 🛑 Deliberately asks only about TIER 1. A seller who supports neither
- * protection still has gift wrap, and a store whose only
+ * protection still has WhatsApp updates and gift wrap, and a store whose only
  * enabled add-ons are protections it declined must still render the picker —
  * because that is where the risk notice lives, and a hidden notice is the
  * tri-state failure in § `StoreProtectionContext`.
  */
 export function hasAnyStoreAddon(rates) {
     return (!!rates &&
-        !!(rates.giftWrapFeeEnabled ||
+        !!(rates.whatsappNotifyFeeEnabled ||
+            rates.giftWrapFeeEnabled ||
             rates.shipmentProtectionFeeEnabled ||
             rates.saleProtectionFeeEnabled));
 }
@@ -51,7 +52,7 @@ export function StoreAddonsPicker({ storeId, storeSubtotal, value, onChange, rat
     const shippingDeclined = !!rates.shipmentProtectionFeeEnabled && !protection?.supportsShippingProtection;
     const saleDeclined = !!rates.saleProtectionFeeEnabled && !protection?.supportsSaleProtection;
     const saleBlockedByFinalSale = !!rates.saleProtectionFeeEnabled && !!protection?.supportsSaleProtection && !!protection?.hasFinalSaleItem;
-    return (_jsxs(Stack, { gap: "xs", className: `min-w-0 ${className}`, children: [disabled && disabledReason && (_jsx(Text, { size: "xs", color: "muted", children: disabledReason })), rates.giftWrapFeeEnabled && (_jsxs(Row, { gap: "sm", align: "start", className: "min-w-0", children: [_jsx(IconBox, { size: "sm", tone: "brand", children: _jsx(Gift, { size: 14 }) }), _jsxs(Stack, { gap: "xs", className: "flex-1 min-w-0", children: [_jsx(FieldCheckbox, { name: `giftWrapAddon-${storeId}`, label: `Gift wrap (+${money(rates.giftWrapFee ?? 49)})`, checked: !!value.giftWrapAddon, onChange: (checked) => set({ giftWrapAddon: checked }), disabled: disabled }), showGiftMessage && value.giftWrapAddon && (_jsx(FieldTextarea, { name: `giftWrapMessage-${storeId}`, label: "Gift message (optional)", value: value.giftWrapMessage ?? "", onChange: (next) => set({ giftWrapMessage: next.slice(0, 500) }), rows: 2, maxLength: 500, showCharCount: true, placeholder: "Add a note for the recipient\u2026", disabled: disabled }))] })] })), shippingOffered && storeSubtotal > 0 && (_jsxs(Row, { gap: "sm", align: "start", className: "min-w-0", children: [_jsx(IconBox, { size: "sm", tone: "brand", children: _jsx(ShieldCheck, { size: 14 }) }), _jsx(Div, { className: "flex-1 min-w-0", children: _jsx(FieldCheckbox, { name: `shipmentProtectionAddon-${storeId}`, label: `Shipment protection — loss or damage in transit (+${money(protectionFee)})`, checked: !!value.shipmentProtectionAddon, onChange: (checked) => set({ shipmentProtectionAddon: checked }), disabled: disabled }) })] })), saleOffered && storeSubtotal > 0 && (_jsxs(Row, { gap: "sm", align: "start", className: "min-w-0", children: [_jsx(IconBox, { size: "sm", tone: "brand", children: _jsx(ShieldAlert, { size: 14 }) }), _jsx(Div, { className: "flex-1 min-w-0", children: _jsx(FieldCheckbox, { name: `saleProtectionAddon-${storeId}`, label: `Sale protection — item not as described (+${money(saleFee)})`, checked: !!value.saleProtectionAddon, onChange: (checked) => set({ saleProtectionAddon: checked }), disabled: disabled }) })] })), (shippingDeclined || saleDeclined) && (_jsxs(Row, { gap: "sm", align: "start", className: "min-w-0", children: [_jsx(IconBox, { size: "sm", tone: "muted", children: _jsx(ShieldOff, { size: 14 }) }), _jsx(Text, { size: "xs", color: "muted", className: "flex-1 min-w-0", children: shippingDeclined && saleDeclined
+    return (_jsxs(Stack, { gap: "xs", className: `min-w-0 ${className}`, children: [disabled && disabledReason && (_jsx(Text, { size: "xs", color: "muted", children: disabledReason })), rates.whatsappNotifyFeeEnabled && (_jsxs(Row, { gap: "sm", align: "start", className: "min-w-0", children: [_jsx(IconBox, { size: "sm", tone: "brand", children: _jsx(MessageCircle, { size: 14 }) }), _jsx(Div, { className: "flex-1 min-w-0", children: _jsx(FieldCheckbox, { name: `whatsappNotifyAddon-${storeId}`, label: `WhatsApp order updates (+${money(rates.whatsappNotifyFee ?? 10)})`, checked: !!value.whatsappNotifyAddon, onChange: (checked) => set({ whatsappNotifyAddon: checked }), disabled: disabled }) })] })), rates.giftWrapFeeEnabled && (_jsxs(Row, { gap: "sm", align: "start", className: "min-w-0", children: [_jsx(IconBox, { size: "sm", tone: "brand", children: _jsx(Gift, { size: 14 }) }), _jsxs(Stack, { gap: "xs", className: "flex-1 min-w-0", children: [_jsx(FieldCheckbox, { name: `giftWrapAddon-${storeId}`, label: `Gift wrap (+${money(rates.giftWrapFee ?? 49)})`, checked: !!value.giftWrapAddon, onChange: (checked) => set({ giftWrapAddon: checked }), disabled: disabled }), showGiftMessage && value.giftWrapAddon && (_jsx(FieldTextarea, { name: `giftWrapMessage-${storeId}`, label: "Gift message (optional)", value: value.giftWrapMessage ?? "", onChange: (next) => set({ giftWrapMessage: next.slice(0, 500) }), rows: 2, maxLength: 500, showCharCount: true, placeholder: "Add a note for the recipient\u2026", disabled: disabled }))] })] })), shippingOffered && storeSubtotal > 0 && (_jsxs(Row, { gap: "sm", align: "start", className: "min-w-0", children: [_jsx(IconBox, { size: "sm", tone: "brand", children: _jsx(ShieldCheck, { size: 14 }) }), _jsx(Div, { className: "flex-1 min-w-0", children: _jsx(FieldCheckbox, { name: `shipmentProtectionAddon-${storeId}`, label: `Shipment protection — loss or damage in transit (+${money(protectionFee)})`, checked: !!value.shipmentProtectionAddon, onChange: (checked) => set({ shipmentProtectionAddon: checked }), disabled: disabled }) })] })), saleOffered && storeSubtotal > 0 && (_jsxs(Row, { gap: "sm", align: "start", className: "min-w-0", children: [_jsx(IconBox, { size: "sm", tone: "brand", children: _jsx(ShieldAlert, { size: 14 }) }), _jsx(Div, { className: "flex-1 min-w-0", children: _jsx(FieldCheckbox, { name: `saleProtectionAddon-${storeId}`, label: `Sale protection — item not as described (+${money(saleFee)})`, checked: !!value.saleProtectionAddon, onChange: (checked) => set({ saleProtectionAddon: checked }), disabled: disabled }) })] })), (shippingDeclined || saleDeclined) && (_jsxs(Row, { gap: "sm", align: "start", className: "min-w-0", children: [_jsx(IconBox, { size: "sm", tone: "muted", children: _jsx(ShieldOff, { size: 14 }) }), _jsx(Text, { size: "xs", color: "muted", className: "flex-1 min-w-0", children: shippingDeclined && saleDeclined
                             ? "This seller does not offer shipment or sale protection."
                             : shippingDeclined
                                 ? "This seller does not offer shipment protection."

package/dist/features/cart/repository/cart.repository.js

@@ -577,7 +577,8 @@ export class CartRepository extends BaseRepository {
      */
     async setStoreAddons(userId, storeId, addons) {
         const isEmpty = !addons ||
-            (!addons.giftWrapAddon &&
+            (!addons.whatsappNotifyAddon &&
+                !addons.giftWrapAddon &&
                 !addons.shipmentProtectionAddon &&
                 !addons.saleProtectionAddon);
         await this.db

package/dist/features/cart/schemas/firestore.d.ts

@@ -272,11 +272,12 @@ export interface CartAppliedCoupon {
  *
  * Add-on fees have always been billed per order group (= per store) by
  * `createOrderForGroup` / `previewCheckoutPricing`, but the selection used to be
- * a single cart-wide boolean — so one tick on "gift wrap" quietly billed
+ * a single cart-wide boolean — so one tick on "WhatsApp updates" quietly billed
  * ₹10 × every store in the cart, with no way to opt in for just one seller.
  * Keying the selection by storeId makes the choice match the billing.
  */
 export interface CartStoreAddons {
+    whatsappNotifyAddon?: boolean;
     giftWrapAddon?: boolean;
     giftWrapMessage?: string;
     /** Loss or damage IN TRANSIT. */

package/dist/features/categories/components/TaxonomyLinkIndex.d.ts

@@ -0,0 +1,39 @@
+import React from "react";
+/**
+ * A plain, server-rendered index of entity links.
+ *
+ * ## Why this exists
+ *
+ * Measured on the prerendered HTML 2026-10-24: `/categories`, `/brands` and
+ * `/parts` each rendered **zero** outbound entity links, and `/franchise`
+ * rendered one. All three hubs filter and paginate entirely client-side
+ * (`useCategoriesFiltered`), which is a deliberate choice that keeps them
+ * static — but it means a crawler that lands on `/brands` finds nothing to
+ * follow, and the 28 brand pages are reachable only from the homepage strip.
+ * Franchise detail pages were reachable by no link at all.
+ *
+ * This renders the full set as real `<a href>`s in the server HTML, below the
+ * interactive grid. It is additive: the client grid above is untouched, so the
+ * filtering UX is unchanged and the page stays static (a Firestore read in a
+ * Server Component does not force dynamic rendering — only `searchParams`,
+ * `cookies()` and `headers()` do, Root Cause #94).
+ *
+ * It is also genuinely useful rather than an SEO artefact — an A–Z index is
+ * what a visitor who wants "all of them" is looking for, and hiding every
+ * entity behind a JS filter serves nobody. Nothing here is cloaked: the links
+ * are visible to a person exactly as they are to a crawler.
+ *
+ * 🛑 Deliberately NOT a `"use client"` component and deliberately not
+ * paginated. Its whole job is to be in the HTML.
+ */
+export interface TaxonomyLink {
+    href: string;
+    label: string;
+}
+export interface TaxonomyLinkIndexProps {
+    heading: string;
+    /** One short sentence saying what the list is. Rendered above the links. */
+    blurb?: string;
+    items: readonly TaxonomyLink[];
+}
+export declare function TaxonomyLinkIndex({ heading, blurb, items }: TaxonomyLinkIndexProps): React.JSX.Element | null;

package/dist/features/categories/components/TaxonomyLinkIndex.js

@@ -0,0 +1,11 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { TextLink } from "../../../ui/components/TextLink.js";
+import { Section } from "../../../ui/components/Semantic.js";
+import { Container, Row } from "../../../ui/components/Layout.js";
+import { Heading, Text } from "../../../ui/components/Typography.js";
+export function TaxonomyLinkIndex({ heading, blurb, items }) {
+    // An empty index is worse than none — it reads as a broken section.
+    if (items.length === 0)
+        return null;
+    return (_jsx(Section, { padding: "y-xl", surface: "muted", children: _jsxs(Container, { size: "xl", children: [_jsx(Heading, { level: 2, size: "xl", weight: "semibold", color: "primary", className: "mb-2", children: heading }), blurb ? (_jsx(Text, { size: "sm", color: "muted", className: "mb-4", children: blurb })) : null, _jsx(Row, { wrap: true, gap: "comfortable", as: "nav", "aria-label": heading, children: items.map((item) => (_jsx(TextLink, { href: item.href, children: item.label }, item.href))) })] }) }));
+}

package/dist/features/categories/schemas/firestore.d.ts

@@ -185,6 +185,31 @@ export interface CategoryDocument extends BaseDocument {
      * ranking mechanism; no Shopify competitor in the crawl has any.
      */
     contentBody?: string;
+    /**
+     * Where this category's SEO signals belong, when that is NOT its own URL.
+     *
+     * A part-leaf category and a `/parts/{slot}/{code}` page are the same
+     * entity seen twice: the leaf is a (usually empty) shopping surface, the
+     * parts page is the reference entry with the weight, code, aliases, WBO
+     * legality and the models that use it. Measured 2026-10-24 the taxonomy
+     * held 4,698 categories of which exactly **20** had any stock, so for the
+     * overwhelming majority the parts page is the only one with content.
+     *
+     * Setting this makes the category page declare the parts page canonical, so
+     * the two stop competing and the signals consolidate onto the one a visitor
+     * actually wants.
+     *
+     * 🛑 Written by `scripts/gen-category-parts.mjs`, which is the ONLY place
+     * that knows both ids — it assigns the category id and the glossary id in
+     * the same loop (the pairing `PART_CATEGORY_TO_GLOSSARY_ID` records). Do not
+     * re-derive it at a call site from the slug: the id schemes differ by
+     * construction and the collision-qualification rule is not invertible.
+     *
+     * 🛑 A root-relative path (`/parts/disc/0-0wall`), never absolute — the
+     * canonical HOST has exactly one definition (appkit.config.js `seo.siteUrl`)
+     * and a second one here is Root Cause #81 waiting to happen.
+     */
+    seoCanonicalPath?: string;
     /** Condition-keyed description bodies. A SET, because WHS reuses two per category. */
     descriptionTemplates?: CategoryDescriptionTemplate[];
     /** What this category hands down to a product filed under it. */