@mohasinac/appkit 4.63.3 → 4.63.5

package/dist/features/whatsapp-bot/types/index.d.ts

@@ -0,0 +1,126 @@
+export interface CheckoutMessageInput {
+    waNumber: string;
+    cart: Array<{
+        name: string;
+        qty: number;
+        salePrice: number;
+    }>;
+    total: number;
+    address: {
+        name: string;
+        phone: string;
+        line1: string;
+        line2?: string;
+        city: string;
+        pincode: string;
+    };
+    isPreorder?: boolean;
+}
+export interface StatusNotificationInput {
+    userPhone: string;
+    template: string;
+    vars: Record<string, string>;
+}
+export interface WebhookVerifyInput {
+    payload: string;
+    signature: string;
+    secret: string;
+}
+export interface IncomingWebhookPayload {
+    /** Digits-only phone number, e.g. "919876543210" */
+    from: string;
+    body: string;
+}
+export interface SendWhatsAppInput {
+    /** Digits-only phone number, e.g. "919876543210" */
+    toPhone: string;
+    message: string;
+    accountSid: string;
+    authToken: string;
+    /** Twilio from number, e.g. "whatsapp:+14155238886" */
+    fromNumber: string;
+}
+/** Input for sending a message via Meta WhatsApp Business Cloud API. */
+export interface WaBusinessSendInput {
+    /** Digits-only phone number with country code, e.g. "919876543210" */
+    toPhone: string;
+    message: string;
+    /** Meta Phone Number ID (from Meta for Developers > App > WhatsApp > API Setup) */
+    phoneNumberId: string;
+    /** Meta system user access token */
+    accessToken: string;
+}
+/**
+ * Input for sending a pre-approved Meta message TEMPLATE. Required for any
+ * business-initiated WhatsApp send outside the 24h customer-service window —
+ * Meta rejects free-form `type: "text"` sends in that case.
+ */
+export interface WaBusinessTemplateSendInput {
+    /** Digits-only phone number with country code, e.g. "919876543210" */
+    toPhone: string;
+    /** Meta Phone Number ID (from Meta for Developers > App > WhatsApp > API Setup) */
+    phoneNumberId: string;
+    /** Meta system user access token */
+    accessToken: string;
+    /** Exact approved template name from Meta WhatsApp Manager (not the display label). */
+    templateName: string;
+    /** BCP-47 language code the template was approved in, e.g. "en" or "en_US". */
+    languageCode: string;
+    /** Positional {{1}}, {{2}}… body parameters, in order. */
+    bodyParams?: string[];
+}
+/** A product mapped to the Meta Commerce API catalog item format. */
+export interface CatalogSyncProduct {
+    /** Firestore product ID — used as Meta `retailer_id` */
+    id: string;
+    title: string;
+    description: string;
+    /** Price in decimal rupees */
+    price: number;
+    currency: string;
+    /** URL of the first product image */
+    imageUrl: string;
+    availability: "in stock" | "out of stock";
+    condition: "new" | "used" | "refurbished";
+    /** Canonical product page URL, e.g. /products/{slug} */
+    link?: string;
+}
+export interface CatalogSyncInput {
+    catalogId: string;
+    /** Meta access token with catalog management permission */
+    accessToken: string;
+    products: CatalogSyncProduct[];
+}
+export interface CatalogSyncResult {
+    /** Meta batch request handles */
+    handles: string[];
+    successCount: number;
+    failureCount: number;
+    errors: string[];
+}
+/** Input for building a purchase announcement message. */
+export interface PurchaseAnnouncementInput {
+    buyerName: string;
+    firstItemName: string;
+    /** 0 if only one item in the order */
+    additionalItemCount: number;
+    /** Total order amount in decimal rupees */
+    totalAmount: number;
+    orderId: string;
+}
+/** Tier PP — input for building the payment-proof fast-review WhatsApp message (admin push + buyer/seller share link). */
+export interface PaymentProofReviewMessageInput {
+    orderId: string;
+    buyerName: string;
+    productTitle: string;
+    totalAmount: number;
+    reviewUrl: string;
+}
+/** Known order status values — extend as needed per project. */
+export type OrderStatusKey = "pending_payment" | "payment_confirmed" | "processing" | "shipped" | "out_for_delivery" | "delivered" | "cancelled" | "refund_initiated" | string;
+export interface StatusMessageInput {
+    orderId: string;
+    status: OrderStatusKey;
+    trackingNumber?: string;
+    courierName?: string;
+}

package/dist/features/whatsapp-bot/types/index.js

@@ -0,0 +1 @@
+export {};

package/dist/index.d.ts

@@ -479,7 +479,7 @@ export type { RateLimitConfig } from "./security/index";
 export type { RateLimitResult } from "./security/index";
 export type { UserRole } from "./security/index";
 export { AddressesRepository } from "./repositories/index";
-export { type PayoutMethodType, type PayoutMethodDocument, PAYOUT_METHODS_COLLECTION, PAYOUT_METHOD_INDEXED_FIELDS, DEFAULT_PAYOUT_METHOD_DATA, type ShippingMethod as ShippingConfigMethod, type ShippingConfigDocument, SHIPPING_CONFIGS_COLLECTION, SHIPPING_CONFIG_INDEXED_FIELDS, DEFAULT_SHIPPING_CONFIG_DATA, type AnalyticsScope, type AnalyticsCardType, type AnalyticsCardDocument, ANALYTICS_CARDS_COLLECTION, ANALYTICS_CARD_INDEXED_FIELDS, DEFAULT_ANALYTICS_CARD_DATA, type AlertOperator, type AnalyticsAlertDocument, ANALYTICS_ALERTS_COLLECTION, ANALYTICS_ALERT_INDEXED_FIELDS, DEFAULT_ANALYTICS_ALERT_DATA, type StoreCategoryDocument, storeCategoryFormSchema, storeCategoryCreateSchema, storeCategoryUpdateSchema, type StoreCategoryFormValues, listingTemplateFormSchema, listingTemplateCreateSchema, listingTemplateUpdateSchema, type ListingTemplateFormValues, LISTING_TEMPLATE_TYPES, LISTING_TEMPLATE_TYPE_OPTIONS, payoutMethodFormSchema, payoutMethodCreateSchema, payoutMethodUpdateSchema, type PayoutMethodFormValues, shippingConfigFormSchema, SHIPPING_METHOD_OPTIONS, shippingConfigCreateSchema, shippingConfigUpdateSchema, type ShippingConfigFormValues, customRoleFormSchema, customRoleCreateSchema, customRoleUpdateSchema, isKnownPermission, type CustomRoleFormValues, moderationReviewFormSchema, moderationReviewUpdateSchema, MODERATION_REVIEWER_STATUSES, type ModerationReviewFormValues, reportReviewFormSchema, reportReviewUpdateSchema, REPORT_REVIEWER_STATUSES, REPORT_TERMINAL_STATUSES, type ReportReviewFormValues, reportCreateSchema, type ReportCreateValues, itemRequestCreateSchema, type ItemRequestCreateValues, REPORT_ENTITY_TYPES, REPORT_REASONS, analyticsAlertCreateSchema, type AnalyticsAlertCreateValues, analyticsCardCreateSchema, type AnalyticsCardCreateValues, ANALYTICS_ALERT_OPERATORS, ANALYTICS_CARD_TYPES, storeGoogleConfigUpdateSchema, type StoreGoogleConfigFormValues, toSellerGoogleConfig, type SellerGoogleConfig, adminNotificationCreateSchema, type AdminNotificationCreateValues, ADMIN_NOTIFICATION_CATEGORIES, ADMIN_NOTIFICATION_SEVERITIES, STORE_CATEGORIES_COLLECTION, STORE_CATEGORY_INDEXED_FIELDS, DEFAULT_STORE_CATEGORY_DATA, type ListingTemplateType, type ListingTemplateDocument, LISTING_TEMPLATES_COLLECTION, LISTING_TEMPLATE_INDEXED_FIELDS, DEFAULT_LISTING_TEMPLATE_DATA, type ModerationStatus, type ModerationMediaType, type ModerationQueueDocument, MODERATION_QUEUE_COLLECTION, MODERATION_QUEUE_INDEXED_FIELDS, DEFAULT_MODERATION_QUEUE_DATA, type ReportEntityType, type ReportStatus, type ReportReason, type ReportDocument, REPORTS_COLLECTION, REPORT_INDEXED_FIELDS, DEFAULT_REPORT_DATA, type AdminNotificationCategory, type AdminNotificationDocument, ADMIN_NOTIFICATIONS_COLLECTION, ADMIN_NOTIFICATION_INDEXED_FIELDS, DEFAULT_ADMIN_NOTIFICATION_DATA, type ItemRequestStatus, type ItemRequestReply, type ItemRequestDocument, ITEM_REQUESTS_COLLECTION, ITEM_REQUEST_INDEXED_FIELDS, DEFAULT_ITEM_REQUEST_DATA, type StoreGoogleConfigDocument, STORE_GOOGLE_CONFIG_COLLECTION, STORE_GOOGLE_CONFIG_INDEXED_FIELDS, DEFAULT_STORE_GOOGLE_CONFIG_DATA, type CustomRoleDocument, CUSTOM_ROLES_COLLECTION, CUSTOM_ROLE_INDEXED_FIELDS, DEFAULT_CUSTOM_ROLE_DATA, type RoleOverrideDocument, ROLE_OVERRIDES_COLLECTION, ROLE_OVERRIDE_INDEXED_FIELDS, DEFAULT_ROLE_OVERRIDE_DATA, PayoutMethodsRepository, ShippingConfigsRepository, AnalyticsCardsRepository, AnalyticsAlertsRepository, StoreCategoriesRepository, ListingTemplatesRepository, ModerationQueueRepository, ReportsRepository, AdminNotificationsRepository, ItemRequestsRepository, StoreGoogleConfigRepository, CustomRolesRepository, RoleOverridesRepository, payoutMethodsRepository, shippingConfigsRepository, analyticsCardsRepository, analyticsAlertsRepository, storeCategoriesRepository, listingTemplatesRepository, moderationQueueRepository, reportsRepository, adminNotificationsRepository, itemRequestsRepository, storeGoogleConfigRepository, customRolesRepository, roleOverridesRepository, } from "./features/store-extensions/index";
+export { type PayoutMethodType, type PayoutMethodDocument, PAYOUT_METHODS_COLLECTION, PAYOUT_METHOD_INDEXED_FIELDS, DEFAULT_PAYOUT_METHOD_DATA, type ShippingMethod as ShippingConfigMethod, type ShippingConfigDocument, SHIPPING_CONFIGS_COLLECTION, SHIPPING_CONFIG_INDEXED_FIELDS, DEFAULT_SHIPPING_CONFIG_DATA, type AnalyticsScope, type AnalyticsCardType, type AnalyticsCardDocument, ANALYTICS_CARDS_COLLECTION, ANALYTICS_CARD_INDEXED_FIELDS, DEFAULT_ANALYTICS_CARD_DATA, type AlertOperator, type AnalyticsAlertDocument, ANALYTICS_ALERTS_COLLECTION, ANALYTICS_ALERT_INDEXED_FIELDS, DEFAULT_ANALYTICS_ALERT_DATA, type StoreCategoryDocument, storeCategoryFormSchema, storeCategoryCreateSchema, storeCategoryUpdateSchema, type StoreCategoryFormValues, listingTemplateFormSchema, listingTemplateCreateSchema, listingTemplateUpdateSchema, type ListingTemplateFormValues, LISTING_TEMPLATE_TYPES, LISTING_TEMPLATE_TYPE_OPTIONS, payoutMethodFormSchema, payoutMethodCreateSchema, payoutMethodUpdateSchema, type PayoutMethodFormValues, shippingConfigFormSchema, SHIPPING_METHOD_OPTIONS, shippingConfigCreateSchema, shippingConfigUpdateSchema, type ShippingConfigFormValues, customRoleFormSchema, customRoleCreateSchema, customRoleUpdateSchema, isKnownPermission, type CustomRoleFormValues, moderationReviewFormSchema, moderationReviewUpdateSchema, MODERATION_REVIEWER_STATUSES, type ModerationReviewFormValues, reportReviewFormSchema, reportReviewUpdateSchema, REPORT_REVIEWER_STATUSES, REPORT_TERMINAL_STATUSES, type ReportReviewFormValues, reportCreateSchema, type ReportCreateValues, itemRequestCreateSchema, type ItemRequestCreateValues, REPORT_ENTITY_TYPES, REPORT_REASONS, analyticsAlertCreateSchema, type AnalyticsAlertCreateValues, analyticsCardCreateSchema, type AnalyticsCardCreateValues, ANALYTICS_ALERT_OPERATORS, ANALYTICS_CARD_TYPES, storeGoogleConfigUpdateSchema, type StoreGoogleConfigFormValues, toSellerGoogleConfig, type SellerGoogleConfig, adminNotificationCreateSchema, type AdminNotificationCreateValues, ADMIN_NOTIFICATION_CATEGORIES, ADMIN_NOTIFICATION_SEVERITIES, STORE_CATEGORIES_COLLECTION, STORE_CATEGORY_INDEXED_FIELDS, DEFAULT_STORE_CATEGORY_DATA, type ListingTemplateType, type ListingTemplateDocument, LISTING_TEMPLATES_COLLECTION, LISTING_TEMPLATE_INDEXED_FIELDS, DEFAULT_LISTING_TEMPLATE_DATA, type ModerationStatus, type ModerationMediaType, type ModerationQueueDocument, MODERATION_QUEUE_COLLECTION, MODERATION_QUEUE_INDEXED_FIELDS, DEFAULT_MODERATION_QUEUE_DATA, type ReportEntityType, type ReportStatus, type ReportReason, type ReportDocument, REPORTS_COLLECTION, REPORT_INDEXED_FIELDS, DEFAULT_REPORT_DATA, type AdminNotificationCategory, type AdminNotificationDocument, ADMIN_NOTIFICATIONS_COLLECTION, ADMIN_NOTIFICATION_INDEXED_FIELDS, DEFAULT_ADMIN_NOTIFICATION_DATA, type ItemRequestStatus, type ItemRequestReply, type ItemRequestDocument, ITEM_REQUESTS_COLLECTION, ITEM_REQUEST_INDEXED_FIELDS, DEFAULT_ITEM_REQUEST_DATA, type StoreGoogleConfigDocument, STORE_GOOGLE_CONFIG_COLLECTION, STORE_GOOGLE_CONFIG_INDEXED_FIELDS, DEFAULT_STORE_GOOGLE_CONFIG_DATA, type StoreWhatsAppConfigDocument, STORE_WHATSAPP_CONFIG_COLLECTION, STORE_WHATSAPP_CONFIG_INDEXED_FIELDS, DEFAULT_STORE_WHATSAPP_CONFIG_DATA, type CustomRoleDocument, CUSTOM_ROLES_COLLECTION, CUSTOM_ROLE_INDEXED_FIELDS, DEFAULT_CUSTOM_ROLE_DATA, type RoleOverrideDocument, ROLE_OVERRIDES_COLLECTION, ROLE_OVERRIDE_INDEXED_FIELDS, DEFAULT_ROLE_OVERRIDE_DATA, PayoutMethodsRepository, ShippingConfigsRepository, AnalyticsCardsRepository, AnalyticsAlertsRepository, StoreCategoriesRepository, ListingTemplatesRepository, ModerationQueueRepository, ReportsRepository, AdminNotificationsRepository, ItemRequestsRepository, StoreGoogleConfigRepository, StoreWhatsAppConfigRepository, CustomRolesRepository, RoleOverridesRepository, payoutMethodsRepository, shippingConfigsRepository, analyticsCardsRepository, analyticsAlertsRepository, storeCategoriesRepository, listingTemplatesRepository, moderationQueueRepository, reportsRepository, adminNotificationsRepository, itemRequestsRepository, storeGoogleConfigRepository, storeWhatsAppConfigRepository, customRolesRepository, roleOverridesRepository, } from "./features/store-extensions/index";
 export { BaseRepository } from "./repositories/index";
 export { BlogRepository } from "./repositories/index";
 export { CartRepository } from "./repositories/index";
@@ -2195,12 +2195,12 @@ export { actionTracker, setActionTrackerSink, resetActionTrackerSink, type Actio
 export { cartRequiresShipping, cartIsDigitalOnly, cartIsChatOnly, } from "./_internal/shared/listing-types/cart-shipping";
 export { ACTIONS, action, act, canPerformAction, actionsForListingType, actionLabel, type ActionDef, type ActionKind, type ActionResource, type ActionTree, type ActionConfirmation, } from "./_internal/shared/actions/action-registry";
 export { buildBulkAction } from "./_internal/shared/actions/bulk-helpers";
-export { computeCheckoutFees, allocateCheckoutFees, computePayoutDeduction, computeCodHandlingFee, computeGiftWrapFee, computeShipmentProtectionFee, computeSaleProtectionFee, calculateGst, } from "./_internal/shared/fees/calculator";
+export { computeCheckoutFees, allocateCheckoutFees, computePayoutDeduction, computeCodHandlingFee, computeWhatsAppNotifyFee, computeGiftWrapFee, computeShipmentProtectionFee, computeSaleProtectionFee, calculateGst, } from "./_internal/shared/fees/calculator";
 export { searchPriceIndex, PRICE_INDEX_SEARCH_LIMIT, PRICE_INDEX_MIN_QUERY_LENGTH } from "./_internal/server/features/price-index/search";
 export type { PriceIndexSearchResponse, PriceIndexSearchResult, PriceIndexSearchResultBand, } from "./_internal/server/features/price-index/search";
 export { protectionAvailability, computeProtectionFees, adjudicateClaim, badgesFor, showsRiskNotice, showsSafetyBadge, returnDestination, rtoDestination, PROTECTION_KINDS, } from "./_internal/shared/features/shipping/protections";
 export type { ProtectionKind, ProtectionAvailability, ProtectionTierInput, ProtectionUnavailableReason, ClaimFinding, ClaimOutcome, } from "./_internal/shared/features/shipping/protections";
-export type { FeeCommissionRates, CheckoutFees, PayoutDeduction, CodHandlingFeeRates, GiftWrapFeeRates, ShipmentProtectionFeeRates, SaleProtectionFeeRates, GstBreakdown, } from "./_internal/shared/fees/calculator";
+export type { FeeCommissionRates, CheckoutFees, PayoutDeduction, CodHandlingFeeRates, WhatsAppNotifyFeeRates, GiftWrapFeeRates, ShipmentProtectionFeeRates, SaleProtectionFeeRates, GstBreakdown, } from "./_internal/shared/fees/calculator";
 export { checkEmiEligibility, computeEmiSchedule, computeBuyerEmiQuote } from "./_internal/shared/features/emi/schedule";
 export type { BuyerEmiQuote } from "./_internal/shared/features/emi/schedule";
 export { amountDueNow, groupEmiGate, groupEmiQuote, groupEmiSchedule, emiOrderFields } from "./_internal/shared/features/emi/group";
@@ -2700,8 +2700,25 @@ export { updateStoreAddressForSeller } from "./features/stores/server";
 export type { StoreContentParams } from "./features/stores/server";
 export type { StoreQueryListParams } from "./features/stores/server";
 export type { StoreReviewsResult } from "./features/stores/server";
-export { buildPaymentProofReviewMessage } from "./features/orders/utils/payment-proof-message";
-export type { PaymentProofReviewMessageInput } from "./features/orders/utils/payment-proof-message";
+export { WhatsAppChatButton } from "./features/whatsapp-bot/index";
+export { SellerWhatsAppSettingsView } from "./features/whatsapp-bot/index";
+export type { SellerWhatsAppSettingsViewProps } from "./features/whatsapp-bot/index";
+export type { CheckoutMessageInput } from "./features/whatsapp-bot/index";
+export type { IncomingWebhookPayload } from "./features/whatsapp-bot/index";
+export type { OrderStatusKey } from "./features/whatsapp-bot/index";
+export type { SendWhatsAppInput } from "./features/whatsapp-bot/index";
+export type { StatusMessageInput } from "./features/whatsapp-bot/index";
+export type { StatusNotificationInput } from "./features/whatsapp-bot/index";
+export type { WebhookVerifyInput } from "./features/whatsapp-bot/index";
+export { buildCheckoutMessageURL } from "./features/whatsapp-bot/server";
+export { buildStatusMessage } from "./features/whatsapp-bot/server";
+export { buildStatusNotificationURL } from "./features/whatsapp-bot/server";
+export { buildPaymentProofReviewMessage } from "./features/whatsapp-bot/server";
+export { isAdminNumber } from "./features/whatsapp-bot/server";
+export { parseIncomingWebhookPayload } from "./features/whatsapp-bot/server";
+export { sendWhatsAppMessage } from "./features/whatsapp-bot/server";
+export { sendWhatsAppBusinessMessage, syncProductsToCatalog, buildPurchaseAnnouncementMessage, buildGroupShareLink } from "./features/whatsapp-bot/server";
+export type { WaBusinessSendInput, CatalogSyncProduct, CatalogSyncInput, CatalogSyncResult, PurchaseAnnouncementInput } from "./features/whatsapp-bot/index";
 export { WishlistCard } from "./features/wishlist/index";
 export { WishlistPage } from "./features/wishlist/index";
 export { WishlistHeartButton } from "./features/wishlist/index";
@@ -3015,7 +3032,7 @@ export { sublistingCategoryFormSchema } from "./features/store-extensions/schema
 export { adminStoreUpdateSchema, announcementBarSchema, } from "./features/admin/schemas/admin-editor-forms";
 export { adminOrderUpdateSchema, employeeInviteSchema, hardBanReasonSchema, featureFlagsUpdateSchema, adminAdFormSchema, } from "./features/admin/schemas/admin-ops-forms";
 export { changeEmailSchema } from "./features/account/schemas/index";
-export { adminUserUpdateSchema, lotteryPullSchema, } from "./features/admin/schemas/admin-user-form";
+export { adminUserUpdateSchema, whatsappSettingsSchema, lotteryPullSchema, } from "./features/admin/schemas/admin-user-form";
 export { siteSettingsFormSchema } from "./features/admin/schemas/site-settings-form";
 export { createReviewSchema as reviewSubmitSchema } from "./_internal/shared/features/reviews/schema";
 export { wishlistAddSchema } from "./schemas/api-routes";

package/dist/index.js

@@ -903,11 +903,11 @@ export { requireRole } from "./security/index.js";
 // AddressesRepository - unified top-level addresses collection (SB-UNI-A 2026-05-13).
 export { AddressesRepository } from "./repositories/index.js";
 // S-STORE foundation — 14 schemas + 14 repositories + RBAC.
-export { PAYOUT_METHODS_COLLECTION, PAYOUT_METHOD_INDEXED_FIELDS, DEFAULT_PAYOUT_METHOD_DATA, SHIPPING_CONFIGS_COLLECTION, SHIPPING_CONFIG_INDEXED_FIELDS, DEFAULT_SHIPPING_CONFIG_DATA, ANALYTICS_CARDS_COLLECTION, ANALYTICS_CARD_INDEXED_FIELDS, DEFAULT_ANALYTICS_CARD_DATA, ANALYTICS_ALERTS_COLLECTION, ANALYTICS_ALERT_INDEXED_FIELDS, DEFAULT_ANALYTICS_ALERT_DATA, storeCategoryFormSchema, storeCategoryCreateSchema, storeCategoryUpdateSchema, listingTemplateFormSchema, listingTemplateCreateSchema, listingTemplateUpdateSchema, LISTING_TEMPLATE_TYPES, LISTING_TEMPLATE_TYPE_OPTIONS, payoutMethodFormSchema, payoutMethodCreateSchema, payoutMethodUpdateSchema, shippingConfigFormSchema, SHIPPING_METHOD_OPTIONS, shippingConfigCreateSchema, shippingConfigUpdateSchema, customRoleFormSchema, customRoleCreateSchema, customRoleUpdateSchema, isKnownPermission, moderationReviewFormSchema, moderationReviewUpdateSchema, MODERATION_REVIEWER_STATUSES, reportReviewFormSchema, reportReviewUpdateSchema, REPORT_REVIEWER_STATUSES, REPORT_TERMINAL_STATUSES, reportCreateSchema, itemRequestCreateSchema, REPORT_ENTITY_TYPES, REPORT_REASONS, analyticsAlertCreateSchema, analyticsCardCreateSchema, ANALYTICS_ALERT_OPERATORS, ANALYTICS_CARD_TYPES, storeGoogleConfigUpdateSchema, toSellerGoogleConfig, adminNotificationCreateSchema, ADMIN_NOTIFICATION_CATEGORIES, ADMIN_NOTIFICATION_SEVERITIES, STORE_CATEGORIES_COLLECTION, STORE_CATEGORY_INDEXED_FIELDS, DEFAULT_STORE_CATEGORY_DATA, LISTING_TEMPLATES_COLLECTION, LISTING_TEMPLATE_INDEXED_FIELDS, DEFAULT_LISTING_TEMPLATE_DATA, MODERATION_QUEUE_COLLECTION, MODERATION_QUEUE_INDEXED_FIELDS, DEFAULT_MODERATION_QUEUE_DATA, REPORTS_COLLECTION, REPORT_INDEXED_FIELDS, DEFAULT_REPORT_DATA, ADMIN_NOTIFICATIONS_COLLECTION, ADMIN_NOTIFICATION_INDEXED_FIELDS, DEFAULT_ADMIN_NOTIFICATION_DATA, ITEM_REQUESTS_COLLECTION, ITEM_REQUEST_INDEXED_FIELDS, DEFAULT_ITEM_REQUEST_DATA, STORE_GOOGLE_CONFIG_COLLECTION, STORE_GOOGLE_CONFIG_INDEXED_FIELDS, DEFAULT_STORE_GOOGLE_CONFIG_DATA, CUSTOM_ROLES_COLLECTION, CUSTOM_ROLE_INDEXED_FIELDS, DEFAULT_CUSTOM_ROLE_DATA, ROLE_OVERRIDES_COLLECTION, ROLE_OVERRIDE_INDEXED_FIELDS, DEFAULT_ROLE_OVERRIDE_DATA, 
+export { PAYOUT_METHODS_COLLECTION, PAYOUT_METHOD_INDEXED_FIELDS, DEFAULT_PAYOUT_METHOD_DATA, SHIPPING_CONFIGS_COLLECTION, SHIPPING_CONFIG_INDEXED_FIELDS, DEFAULT_SHIPPING_CONFIG_DATA, ANALYTICS_CARDS_COLLECTION, ANALYTICS_CARD_INDEXED_FIELDS, DEFAULT_ANALYTICS_CARD_DATA, ANALYTICS_ALERTS_COLLECTION, ANALYTICS_ALERT_INDEXED_FIELDS, DEFAULT_ANALYTICS_ALERT_DATA, storeCategoryFormSchema, storeCategoryCreateSchema, storeCategoryUpdateSchema, listingTemplateFormSchema, listingTemplateCreateSchema, listingTemplateUpdateSchema, LISTING_TEMPLATE_TYPES, LISTING_TEMPLATE_TYPE_OPTIONS, payoutMethodFormSchema, payoutMethodCreateSchema, payoutMethodUpdateSchema, shippingConfigFormSchema, SHIPPING_METHOD_OPTIONS, shippingConfigCreateSchema, shippingConfigUpdateSchema, customRoleFormSchema, customRoleCreateSchema, customRoleUpdateSchema, isKnownPermission, moderationReviewFormSchema, moderationReviewUpdateSchema, MODERATION_REVIEWER_STATUSES, reportReviewFormSchema, reportReviewUpdateSchema, REPORT_REVIEWER_STATUSES, REPORT_TERMINAL_STATUSES, reportCreateSchema, itemRequestCreateSchema, REPORT_ENTITY_TYPES, REPORT_REASONS, analyticsAlertCreateSchema, analyticsCardCreateSchema, ANALYTICS_ALERT_OPERATORS, ANALYTICS_CARD_TYPES, storeGoogleConfigUpdateSchema, toSellerGoogleConfig, adminNotificationCreateSchema, ADMIN_NOTIFICATION_CATEGORIES, ADMIN_NOTIFICATION_SEVERITIES, STORE_CATEGORIES_COLLECTION, STORE_CATEGORY_INDEXED_FIELDS, DEFAULT_STORE_CATEGORY_DATA, LISTING_TEMPLATES_COLLECTION, LISTING_TEMPLATE_INDEXED_FIELDS, DEFAULT_LISTING_TEMPLATE_DATA, MODERATION_QUEUE_COLLECTION, MODERATION_QUEUE_INDEXED_FIELDS, DEFAULT_MODERATION_QUEUE_DATA, REPORTS_COLLECTION, REPORT_INDEXED_FIELDS, DEFAULT_REPORT_DATA, ADMIN_NOTIFICATIONS_COLLECTION, ADMIN_NOTIFICATION_INDEXED_FIELDS, DEFAULT_ADMIN_NOTIFICATION_DATA, ITEM_REQUESTS_COLLECTION, ITEM_REQUEST_INDEXED_FIELDS, DEFAULT_ITEM_REQUEST_DATA, STORE_GOOGLE_CONFIG_COLLECTION, STORE_GOOGLE_CONFIG_INDEXED_FIELDS, DEFAULT_STORE_GOOGLE_CONFIG_DATA, STORE_WHATSAPP_CONFIG_COLLECTION, STORE_WHATSAPP_CONFIG_INDEXED_FIELDS, DEFAULT_STORE_WHATSAPP_CONFIG_DATA, CUSTOM_ROLES_COLLECTION, CUSTOM_ROLE_INDEXED_FIELDS, DEFAULT_CUSTOM_ROLE_DATA, ROLE_OVERRIDES_COLLECTION, ROLE_OVERRIDE_INDEXED_FIELDS, DEFAULT_ROLE_OVERRIDE_DATA, 
 // Repositories — classes
-PayoutMethodsRepository, ShippingConfigsRepository, AnalyticsCardsRepository, AnalyticsAlertsRepository, StoreCategoriesRepository, ListingTemplatesRepository, ModerationQueueRepository, ReportsRepository, AdminNotificationsRepository, ItemRequestsRepository, StoreGoogleConfigRepository, CustomRolesRepository, RoleOverridesRepository, 
+PayoutMethodsRepository, ShippingConfigsRepository, AnalyticsCardsRepository, AnalyticsAlertsRepository, StoreCategoriesRepository, ListingTemplatesRepository, ModerationQueueRepository, ReportsRepository, AdminNotificationsRepository, ItemRequestsRepository, StoreGoogleConfigRepository, StoreWhatsAppConfigRepository, CustomRolesRepository, RoleOverridesRepository, 
 // Repositories — singletons
-payoutMethodsRepository, shippingConfigsRepository, analyticsCardsRepository, analyticsAlertsRepository, storeCategoriesRepository, listingTemplatesRepository, moderationQueueRepository, reportsRepository, adminNotificationsRepository, itemRequestsRepository, storeGoogleConfigRepository, customRolesRepository, roleOverridesRepository, } from "./features/store-extensions/index.js";
+payoutMethodsRepository, shippingConfigsRepository, analyticsCardsRepository, analyticsAlertsRepository, storeCategoriesRepository, listingTemplatesRepository, moderationQueueRepository, reportsRepository, adminNotificationsRepository, itemRequestsRepository, storeGoogleConfigRepository, storeWhatsAppConfigRepository, customRolesRepository, roleOverridesRepository, } from "./features/store-extensions/index.js";
 // [DB]-Database layer â€" uses firebase-admin or another server-side DB SDK; can only run in a trusted server environment.
 // BaseRepository - Shared export for base repository.
 export { BaseRepository } from "./repositories/index.js";
@@ -2173,7 +2173,7 @@ export { markAllNotificationsRead } from "./features/admin/server.js";
 // markNotificationRead - Shared export for mark notification read.
 export { markNotificationRead } from "./features/admin/server.js";
 // [SERVER-ONLY]-Server-only â€" uses Node.js, Next.js server internals, or third-party server SDKs (auth, email, payment, shipping).
-// sendNotification - Multi-channel notification dispatcher (in-app + optional email).
+// sendNotification - Multi-channel notification dispatcher (in-app + optional email/WhatsApp).
 export { sendNotification } from "./features/admin/server.js";
 // [SERVER-ONLY]-Server-only â€" uses Node.js, Next.js server internals, or third-party server SDKs (auth, email, payment, shipping).
 // revokeSession - Shared export for revoke session.
@@ -4086,7 +4086,7 @@ export { cartRequiresShipping, cartIsDigitalOnly, cartIsChatOnly, } from "./_int
 // SB-UNI-W-1 2026-05-13 â€" CTA action registry shell.
 export { ACTIONS, action, act, canPerformAction, actionsForListingType, actionLabel, } from "./_internal/shared/actions/action-registry.js";
 export { buildBulkAction } from "./_internal/shared/actions/bulk-helpers.js";
-// Shared fee calculator — platform/gateway/GST/COD handling/addon fee math (pure, client-safe).
+// Shared fee calculator — platform/gateway/GST/COD handling/WhatsApp-addon fee math (pure, client-safe).
 export { computeCheckoutFees, 
 // The per-group split of the ONE capped commission. Exported for the capture
 // route's points tender: the tender is applied per order group against the
@@ -4094,7 +4094,7 @@ export { computeCheckoutFees,
 // it the route would have to re-derive the apportionment — and the allocator
 // also carries the `minimumTransactionFee` floor (D41), which already spent
 // a release being re-implemented by hand in that very file.
-allocateCheckoutFees, computePayoutDeduction, computeCodHandlingFee, computeGiftWrapFee, computeShipmentProtectionFee, computeSaleProtectionFee, calculateGst, } from "./_internal/shared/fees/calculator.js";
+allocateCheckoutFees, computePayoutDeduction, computeCodHandlingFee, computeWhatsAppNotifyFee, computeGiftWrapFee, computeShipmentProtectionFee, computeSaleProtectionFee, calculateGst, } from "./_internal/shared/fees/calculator.js";
 // C5e buyer protections — the pure three-tier gate plus the one fee pair
 // every money path must agree on. Public API because the capture route
 // (/api/payment/create-order) is one of the three sites that must agree.
@@ -4835,6 +4835,7 @@ export { AdminTeamGuideView } from "./features/admin/components/AdminTeamGuideVi
 export { AdminAnalyticsGuideView } from "./features/admin/components/AdminAnalyticsGuideView.js";
 // [CLIENT-SSR]-Admin trust & safety guide — static view, no firebase-admin.
 export { AdminTrustGuideView } from "./features/admin/components/AdminTrustGuideView.js";
+// [CLIENT-SSR]-Admin WhatsApp integration guide — static view, no firebase-admin.
 // [CLIENT-SSR]-Admin payments (Razorpay) guide — static view, no firebase-admin.
 export { AdminPaymentsGuideView } from "./features/admin/components/AdminPaymentsGuideView.js";
 // [CLIENT-SSR]-Buyer shopping guide — static view, no firebase-admin.
@@ -4857,6 +4858,7 @@ export { StoreFinanceGuideView } from "./features/stores/components/StoreFinance
 export { StoreCapabilitiesGuideView } from "./features/stores/components/StoreCapabilitiesGuideView.js";
 // [CLIENT-SSR]-Store settings guide — static view, no firebase-admin.
 export { StoreSettingsGuideView } from "./features/stores/components/StoreSettingsGuideView.js";
+// [CLIENT-SSR]-Store WhatsApp catalog sync guide — static view, no firebase-admin.
 export { StorePreOrdersListing } from "./features/stores/components/StorePreOrdersListing.js";
 // [CLIENT-SSR]-Runs in both SSR and browser â€" React component or hook that does not depend on browser-only APIs.
 // buildStoreColumns - Helper for build store columns.
@@ -4932,11 +4934,35 @@ export { storeSlugGET } from "./features/stores/server.js";
 // [SERVER-ONLY]-Server-only â€" uses Node.js, Next.js server internals, or third-party server SDKs (auth, email, payment, shipping).
 // updateStoreAddressForSeller - Helper for update store address for seller.
 export { updateStoreAddressForSeller } from "./features/stores/server.js";
-// ./features/orders/utils/payment-proof-message
-// [CLIENT-SAFE] Pure wa.me share-link message builder — no crypto, no network.
-// The WhatsApp Cloud API integration was removed 2026-10-20; this survived
-// because a wa.me deep link needs no token, number or Meta billing account.
-export { buildPaymentProofReviewMessage } from "./features/orders/utils/payment-proof-message.js";
+// ./features/whatsapp-bot/index
+// [CLIENT-SSR]-Runs in both SSR and browser â€" React component or hook that does not depend on browser-only APIs.
+// WhatsAppChatButton - Component for whats app chat button.
+export { WhatsAppChatButton } from "./features/whatsapp-bot/index.js";
+export { SellerWhatsAppSettingsView } from "./features/whatsapp-bot/index.js";
+// ./features/whatsapp-bot/server
+// [SERVER-ONLY]-Server-only â€" uses Node.js, Next.js server internals, or third-party server SDKs (auth, email, payment, shipping).
+// buildCheckoutMessageURL - Helper for build checkout message url.
+export { buildCheckoutMessageURL } from "./features/whatsapp-bot/server.js";
+// [SERVER-ONLY]-Server-only â€" uses Node.js, Next.js server internals, or third-party server SDKs (auth, email, payment, shipping).
+// buildStatusMessage - Helper for build status message.
+export { buildStatusMessage } from "./features/whatsapp-bot/server.js";
+// [SERVER-ONLY]-Server-only â€" uses Node.js, Next.js server internals, or third-party server SDKs (auth, email, payment, shipping).
+// buildStatusNotificationURL - Helper for build status notification url.
+export { buildStatusNotificationURL } from "./features/whatsapp-bot/server.js";
+// [SERVER-ONLY]-Server-only â€" uses Node.js, Next.js server internals, or third-party server SDKs (auth, email, payment, shipping).
+// buildPaymentProofReviewMessage - Helper for build payment proof review message (Tier PP).
+export { buildPaymentProofReviewMessage } from "./features/whatsapp-bot/server.js";
+// [SERVER-ONLY]-Server-only â€" uses Node.js, Next.js server internals, or third-party server SDKs (auth, email, payment, shipping).
+// isAdminNumber - Shared export for is admin number.
+export { isAdminNumber } from "./features/whatsapp-bot/server.js";
+// [SERVER-ONLY]-Server-only â€" uses Node.js, Next.js server internals, or third-party server SDKs (auth, email, payment, shipping).
+// parseIncomingWebhookPayload - Helper for parse incoming webhook payload.
+export { parseIncomingWebhookPayload } from "./features/whatsapp-bot/server.js";
+// [SERVER-ONLY]-Server-only â€" uses Node.js, Next.js server internals, or third-party server SDKs (auth, email, payment, shipping).
+// sendWhatsAppMessage - Shared export for send whats app message.
+export { sendWhatsAppMessage } from "./features/whatsapp-bot/server.js";
+// [SERVER-ONLY] Meta WhatsApp Business Cloud API helpers (WA1-WA8 integration)
+export { sendWhatsAppBusinessMessage, syncProductsToCatalog, buildPurchaseAnnouncementMessage, buildGroupShareLink } from "./features/whatsapp-bot/server.js";
 // ./features/wishlist/index
 // [CLIENT-SSR]-Runs in both SSR and browser â€" React component or hook that does not depend on browser-only APIs.
 // WishlistCard - Component for wishlist card.
@@ -5369,7 +5395,7 @@ export { sublistingCategoryFormSchema } from "./features/store-extensions/schema
 export { adminStoreUpdateSchema, announcementBarSchema, } from "./features/admin/schemas/admin-editor-forms.js";
 export { adminOrderUpdateSchema, employeeInviteSchema, hardBanReasonSchema, featureFlagsUpdateSchema, adminAdFormSchema, } from "./features/admin/schemas/admin-ops-forms.js";
 export { changeEmailSchema } from "./features/account/schemas/index.js";
-export { adminUserUpdateSchema, lotteryPullSchema, } from "./features/admin/schemas/admin-user-form.js";
+export { adminUserUpdateSchema, whatsappSettingsSchema, lotteryPullSchema, } from "./features/admin/schemas/admin-user-form.js";
 export { siteSettingsFormSchema } from "./features/admin/schemas/site-settings-form.js";
 /*
  * Two schemas that existed and whose own routes did not use them.

package/dist/next/routing/route-map.d.ts

@@ -261,6 +261,7 @@ export declare const DEFAULT_ROUTE_MAP: {
         readonly ADDRESSES_NEW: "/store/addresses/new";
         readonly ADDRESSES_EDIT: (id: string) => string;
         readonly OFFERS: "/store/offers";
+        readonly WHATSAPP: "/store/whatsapp";
         readonly REVIEWS: "/store/reviews";
         readonly BIDS: "/store/bids";
         readonly BID_DETAIL: (id: string) => string;
@@ -770,6 +771,7 @@ export declare const ROUTES: {
         readonly ADDRESSES_NEW: "/store/addresses/new";
         readonly ADDRESSES_EDIT: (id: string) => string;
         readonly OFFERS: "/store/offers";
+        readonly WHATSAPP: "/store/whatsapp";
         readonly REVIEWS: "/store/reviews";
         readonly BIDS: "/store/bids";
         readonly BID_DETAIL: (id: string) => string;
@@ -1056,6 +1058,7 @@ export declare const SELLER_ROUTES: {
     readonly ADDRESSES_NEW: "/store/addresses/new";
     readonly ADDRESSES_EDIT: (id: string) => string;
     readonly OFFERS: "/store/offers";
+    readonly WHATSAPP: "/store/whatsapp";
     readonly REVIEWS: "/store/reviews";
     readonly BIDS: "/store/bids";
     readonly BID_DETAIL: (id: string) => string;

package/dist/next/routing/route-map.js

@@ -396,6 +396,7 @@ export const DEFAULT_ROUTE_MAP = {
         ADDRESSES_NEW: "/store/addresses/new",
         ADDRESSES_EDIT: (id) => `/store/addresses/${id}/edit`,
         OFFERS: "/store/offers",
+        WHATSAPP: "/store/whatsapp",
         REVIEWS: "/store/reviews",
         BIDS: "/store/bids",
         BID_DETAIL: (id) => `/store/bids/${id}/view`,

package/dist/providers/db-firebase/base.repository.d.ts

@@ -19,7 +19,7 @@ export declare abstract class BaseRepository<T extends DocumentData> {
      *
      * It is a SEPARATE hook because a list is not a detail read. A repository
      * whose `mapDoc` decrypts a secret must not hand that secret to a list —
-     * A subclass overrides this when a list row must drop a field, since
+     * `StoreRepository` overrides this to drop the WhatsApp token, since
      * `listStores(activeOnly)` backs the PUBLIC /stores page.
      */
     protected mapDocForList<D = T>(snap: DocumentSnapshot): D;

package/dist/providers/db-firebase/base.repository.js

@@ -56,7 +56,7 @@ export class BaseRepository {
      *
      * It is a SEPARATE hook because a list is not a detail read. A repository
      * whose `mapDoc` decrypts a secret must not hand that secret to a list —
-     * A subclass overrides this when a list row must drop a field, since
+     * `StoreRepository` overrides this to drop the WhatsApp token, since
      * `listStores(activeOnly)` backs the PUBLIC /stores page.
      */
     mapDocForList(snap) {

package/dist/repositories/index.d.ts

@@ -40,7 +40,7 @@ export { shipmentItemsRepository } from "../features/shipments/repository/shipme
 export { catalogueRepository } from "../features/catalogue/repository/catalogue.repository";
 export { SavedPaymentMethodsRepository, savedPaymentMethodsRepository, } from "../features/payments/repository/saved-payment-methods.repository";
 export { GroupedListingsRepository, groupedListingsRepository, } from "../features/grouped/repository/grouped-listings.repository";
-export { payoutMethodsRepository, shippingConfigsRepository, analyticsCardsRepository, analyticsAlertsRepository, storeCategoriesRepository, listingTemplatesRepository, moderationQueueRepository, reportsRepository, itemRequestsRepository, storeGoogleConfigRepository, PayoutMethodsRepository, ShippingConfigsRepository, AnalyticsCardsRepository, AnalyticsAlertsRepository, StoreCategoriesRepository, ListingTemplatesRepository, ModerationQueueRepository, ReportsRepository, ItemRequestsRepository, StoreGoogleConfigRepository, } from "../features/store-extensions/repository/store-extensions.repositories";
+export { payoutMethodsRepository, shippingConfigsRepository, analyticsCardsRepository, analyticsAlertsRepository, storeCategoriesRepository, listingTemplatesRepository, moderationQueueRepository, reportsRepository, itemRequestsRepository, storeWhatsAppConfigRepository, storeGoogleConfigRepository, PayoutMethodsRepository, ShippingConfigsRepository, AnalyticsCardsRepository, AnalyticsAlertsRepository, StoreCategoriesRepository, ListingTemplatesRepository, ModerationQueueRepository, ReportsRepository, ItemRequestsRepository, StoreWhatsAppConfigRepository, StoreGoogleConfigRepository, } from "../features/store-extensions/repository/store-extensions.repositories";
 export { roleOverridesRepository, customRolesRepository, adminNotificationsRepository, RoleOverridesRepository, CustomRolesRepository, AdminNotificationsRepository, } from "../features/store-extensions/repository/rbac.repositories";
 export { OfferRepository, offerRepository, } from "../features/seller/repository/offer.repository";
 export { wishlistRepository, type UserWishlistItem as WishlistItem, WishlistFullError, } from "../features/wishlist/repository/user-wishlist.repository";

package/dist/repositories/index.js

@@ -56,7 +56,7 @@ export { SavedPaymentMethodsRepository, savedPaymentMethodsRepository, } from ".
 // Grouped listings repository
 export { GroupedListingsRepository, groupedListingsRepository, } from "../features/grouped/repository/grouped-listings.repository.js";
 // S-STORE-CROSS — 11 new collection repositories
-export { payoutMethodsRepository, shippingConfigsRepository, analyticsCardsRepository, analyticsAlertsRepository, storeCategoriesRepository, listingTemplatesRepository, moderationQueueRepository, reportsRepository, itemRequestsRepository, storeGoogleConfigRepository, PayoutMethodsRepository, ShippingConfigsRepository, AnalyticsCardsRepository, AnalyticsAlertsRepository, StoreCategoriesRepository, ListingTemplatesRepository, ModerationQueueRepository, ReportsRepository, ItemRequestsRepository, StoreGoogleConfigRepository, } from "../features/store-extensions/repository/store-extensions.repositories.js";
+export { payoutMethodsRepository, shippingConfigsRepository, analyticsCardsRepository, analyticsAlertsRepository, storeCategoriesRepository, listingTemplatesRepository, moderationQueueRepository, reportsRepository, itemRequestsRepository, storeWhatsAppConfigRepository, storeGoogleConfigRepository, PayoutMethodsRepository, ShippingConfigsRepository, AnalyticsCardsRepository, AnalyticsAlertsRepository, StoreCategoriesRepository, ListingTemplatesRepository, ModerationQueueRepository, ReportsRepository, ItemRequestsRepository, StoreWhatsAppConfigRepository, StoreGoogleConfigRepository, } from "../features/store-extensions/repository/store-extensions.repositories.js";
 // S-STORE RBAC + admin notifications
 export { roleOverridesRepository, customRolesRepository, adminNotificationsRepository, RoleOverridesRepository, CustomRolesRepository, AdminNotificationsRepository, } from "../features/store-extensions/repository/rbac.repositories.js";
 export { OfferRepository, offerRepository, } from "../features/seller/repository/offer.repository.js";