@mohasinac/appkit 2.3.2 → 2.4.0

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

@@ -0,0 +1,113 @@
+/**
+ * Support Ticket Firestore Document Types & Constants
+ *
+ * Canonical types for the supportTickets collection. Tickets are the primary
+ * channel through which users contest bans and report order/billing issues.
+ *
+ * Collection: supportTickets
+ * Document ID prefix: ticket- (semantic, no auto-ID)
+ *
+ * Ticket creation rules (enforced server-side, never client-trusted):
+ *  - Max 2 active general tickets per user
+ *  - Max 1 ticket per active (non-completed) order
+ *  - No guest creation — authentication required
+ *  - No creation if user has create_support_tickets soft ban
+ *  - No new ticket in the same category while existing one is waiting_on_user
+ */
+export declare const TicketCategoryValues: {
+    readonly ORDER_ISSUE: "order_issue";
+    readonly BILLING_PAYMENT: "billing_payment";
+    readonly ACCOUNT: "account";
+    readonly LISTING_DISPUTE: "listing_dispute";
+    readonly SCAM_REPORT: "scam_report";
+    readonly REFUND_REQUEST: "refund_request";
+    readonly AUCTION_DISPUTE: "auction_dispute";
+    readonly GENERAL: "general";
+};
+export type TicketCategory = (typeof TicketCategoryValues)[keyof typeof TicketCategoryValues];
+export declare const TicketStatusValues: {
+    readonly OPEN: "open";
+    readonly IN_PROGRESS: "in_progress";
+    readonly WAITING_ON_USER: "waiting_on_user";
+    readonly RESOLVED: "resolved";
+    readonly CLOSED: "closed";
+};
+export type TicketStatus = (typeof TicketStatusValues)[keyof typeof TicketStatusValues];
+export declare const TicketPriorityValues: {
+    readonly LOW: "low";
+    readonly NORMAL: "normal";
+    readonly HIGH: "high";
+    readonly URGENT: "urgent";
+};
+export type TicketPriority = (typeof TicketPriorityValues)[keyof typeof TicketPriorityValues];
+/** Statuses considered "active" for limit-enforcement purposes. */
+export declare const ACTIVE_TICKET_STATUSES: TicketStatus[];
+/** Order statuses that are eligible for a support ticket. */
+export declare const ELIGIBLE_ORDER_STATUSES_FOR_TICKET: readonly ["PENDING", "PROCESSING", "SHIPPED", "RETURN_REQUESTED"];
+export interface TicketMessage {
+    id: string;
+    authorId: string;
+    authorRole: "user" | "support" | "admin";
+    /** Plain text or safe HTML body. */
+    body: string;
+    /** Media URLs (screenshots, attachments — /media/ proxy URLs, never raw Storage). */
+    attachments?: string[];
+    createdAt: Date;
+}
+export interface SupportTicketDocument {
+    id: string;
+    userId: string;
+    /** Denormalized — for admin table display. */
+    userEmail: string;
+    /** Denormalized — for admin table display. */
+    userDisplayName: string;
+    category: TicketCategory;
+    subject: string;
+    /** Initial description written by the user when opening the ticket. */
+    description: string;
+    /** Linked order ID — required when category === "order_issue". */
+    orderId?: string;
+    status: TicketStatus;
+    priority: TicketPriority;
+    /** UID of the assigned employee. */
+    assignedTo?: string;
+    /** Denormalized display name of the assignee. */
+    assignedToName?: string;
+    /**
+     * Internal-only notes visible only to admins/employees, never shown to the ticket author.
+     * Append-only — never overwrite, always append with timestamp.
+     */
+    internalNotes?: string;
+    /** Threaded conversation. Ordered by createdAt asc. */
+    messages: TicketMessage[];
+    resolvedAt?: Date;
+    closedAt?: Date;
+    createdAt: Date;
+    updatedAt: Date;
+}
+export type SupportTicketCreateInput = Pick<SupportTicketDocument, "userId" | "userEmail" | "userDisplayName" | "category" | "subject" | "description" | "orderId">;
+export type SupportTicketUpdateInput = Partial<Pick<SupportTicketDocument, "status" | "priority" | "assignedTo" | "assignedToName" | "internalNotes" | "resolvedAt" | "closedAt">>;
+export declare const SUPPORT_TICKET_COLLECTION: "supportTickets";
+export declare const SUPPORT_TICKET_ID_PREFIX: "ticket-";
+export declare const SUPPORT_TICKET_INDEXED_FIELDS: readonly ["userId", "status", "category", "priority", "assignedTo", "orderId", "createdAt", "updatedAt"];
+export declare const DEFAULT_SUPPORT_TICKET_DATA: Partial<SupportTicketDocument>;
+export declare const SUPPORT_TICKET_FIELDS: {
+    readonly ID: "id";
+    readonly USER_ID: "userId";
+    readonly USER_EMAIL: "userEmail";
+    readonly USER_DISPLAY_NAME: "userDisplayName";
+    readonly CATEGORY: "category";
+    readonly SUBJECT: "subject";
+    readonly DESCRIPTION: "description";
+    readonly ORDER_ID: "orderId";
+    readonly STATUS: "status";
+    readonly PRIORITY: "priority";
+    readonly ASSIGNED_TO: "assignedTo";
+    readonly ASSIGNED_TO_NAME: "assignedToName";
+    readonly INTERNAL_NOTES: "internalNotes";
+    readonly MESSAGES: "messages";
+    readonly RESOLVED_AT: "resolvedAt";
+    readonly CLOSED_AT: "closedAt";
+    readonly CREATED_AT: "createdAt";
+    readonly UPDATED_AT: "updatedAt";
+};

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

@@ -0,0 +1,95 @@
+/**
+ * Support Ticket Firestore Document Types & Constants
+ *
+ * Canonical types for the supportTickets collection. Tickets are the primary
+ * channel through which users contest bans and report order/billing issues.
+ *
+ * Collection: supportTickets
+ * Document ID prefix: ticket- (semantic, no auto-ID)
+ *
+ * Ticket creation rules (enforced server-side, never client-trusted):
+ *  - Max 2 active general tickets per user
+ *  - Max 1 ticket per active (non-completed) order
+ *  - No guest creation — authentication required
+ *  - No creation if user has create_support_tickets soft ban
+ *  - No new ticket in the same category while existing one is waiting_on_user
+ */
+// ============================================================================
+// ENUMS
+// ============================================================================
+export const TicketCategoryValues = {
+    ORDER_ISSUE: "order_issue",
+    BILLING_PAYMENT: "billing_payment",
+    ACCOUNT: "account",
+    LISTING_DISPUTE: "listing_dispute",
+    SCAM_REPORT: "scam_report",
+    REFUND_REQUEST: "refund_request",
+    AUCTION_DISPUTE: "auction_dispute",
+    GENERAL: "general",
+};
+export const TicketStatusValues = {
+    OPEN: "open",
+    IN_PROGRESS: "in_progress",
+    WAITING_ON_USER: "waiting_on_user",
+    RESOLVED: "resolved",
+    CLOSED: "closed",
+};
+export const TicketPriorityValues = {
+    LOW: "low",
+    NORMAL: "normal",
+    HIGH: "high",
+    URGENT: "urgent",
+};
+/** Statuses considered "active" for limit-enforcement purposes. */
+export const ACTIVE_TICKET_STATUSES = [
+    "open",
+    "in_progress",
+    "waiting_on_user",
+];
+/** Order statuses that are eligible for a support ticket. */
+export const ELIGIBLE_ORDER_STATUSES_FOR_TICKET = [
+    "PENDING",
+    "PROCESSING",
+    "SHIPPED",
+    "RETURN_REQUESTED",
+];
+// ============================================================================
+// COLLECTION CONSTANTS
+// ============================================================================
+export const SUPPORT_TICKET_COLLECTION = "supportTickets";
+export const SUPPORT_TICKET_ID_PREFIX = "ticket-";
+export const SUPPORT_TICKET_INDEXED_FIELDS = [
+    "userId",
+    "status",
+    "category",
+    "priority",
+    "assignedTo",
+    "orderId",
+    "createdAt",
+    "updatedAt",
+];
+export const DEFAULT_SUPPORT_TICKET_DATA = {
+    status: "open",
+    priority: "normal",
+    messages: [],
+};
+export const SUPPORT_TICKET_FIELDS = {
+    ID: "id",
+    USER_ID: "userId",
+    USER_EMAIL: "userEmail",
+    USER_DISPLAY_NAME: "userDisplayName",
+    CATEGORY: "category",
+    SUBJECT: "subject",
+    DESCRIPTION: "description",
+    ORDER_ID: "orderId",
+    STATUS: "status",
+    PRIORITY: "priority",
+    ASSIGNED_TO: "assignedTo",
+    ASSIGNED_TO_NAME: "assignedToName",
+    INTERNAL_NOTES: "internalNotes",
+    MESSAGES: "messages",
+    RESOLVED_AT: "resolvedAt",
+    CLOSED_AT: "closedAt",
+    CREATED_AT: "createdAt",
+    UPDATED_AT: "updatedAt",
+};

package/dist/features/whatsapp-bot/components/SellerWhatsAppSettingsView.d.ts

@@ -0,0 +1,5 @@
+export interface SellerWhatsAppSettingsViewProps {
+    /** Whether this store has the whatsapp_catalog_sync capability */
+    hasCapability: boolean;
+}
+export declare function SellerWhatsAppSettingsView({ hasCapability }: SellerWhatsAppSettingsViewProps): import("react/jsx-runtime").JSX.Element;

package/dist/features/whatsapp-bot/components/SellerWhatsAppSettingsView.js

@@ -0,0 +1,143 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import React from "react";
+import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
+import { Alert, Button, Form, FormActions, Input, Toggle, useToast, } from "../../../ui";
+import { apiClient } from "../../../http";
+import { WHATSAPP_SELLER_ENDPOINTS } from "../../../constants/api-endpoints";
+import { buildPurchaseAnnouncementMessage } from "../helpers/whatsapp";
+// ---------------------------------------------------------------------------
+// Sub-components
+// ---------------------------------------------------------------------------
+function MaskedTokenInput({ label, value, onChange, placeholder, helperText, }) {
+    const [revealed, setRevealed] = React.useState(false);
+    return (_jsxs("div", { className: "relative", children: [_jsx(Input, { label: label, value: value, onChange: (e) => onChange(e.target.value), type: revealed ? "text" : "password", placeholder: placeholder, helperText: helperText }), _jsx("button", { type: "button", onClick: () => setRevealed((r) => !r), className: "absolute right-3 top-8 text-xs text-zinc-400 hover:text-zinc-700 dark:hover:text-zinc-200", children: revealed ? "Hide" : "Reveal" })] }));
+}
+const STEPS = [
+    {
+        n: 1,
+        title: "Create a Meta Business Account",
+        body: "Go to business.facebook.com and create (or use) a Meta Business Manager account.",
+        checkKey: undefined,
+    },
+    {
+        n: 2,
+        title: "Set up a WhatsApp Business App",
+        body: "In Meta for Developers, create an App → add the WhatsApp product → note your Phone Number ID and WABA ID from the API Setup page.",
+        checkKey: "wabaId",
+    },
+    {
+        n: 3,
+        title: "Generate a System User access token",
+        body: 'In Meta Business Manager → System Users → create a System User → assign "WhatsApp Business Management" + "WhatsApp Business Messaging" permissions → generate a token.',
+        checkKey: "accessToken",
+    },
+    {
+        n: 4,
+        title: "Create a WhatsApp Catalog",
+        body: "In Meta Commerce Manager → Catalogs → create a catalog → copy the Catalog ID.",
+        checkKey: "catalogId",
+    },
+    {
+        n: 5,
+        title: "Paste credentials below and save",
+        body: "Fill the form below and click Save & Connect. Once connected, you can sync your products.",
+        checkKey: "connected",
+    },
+];
+const STATUS_COLOR = {
+    success: "bg-green-100 text-green-800 dark:bg-green-900/40 dark:text-green-300",
+    partial: "bg-amber-100 text-amber-800 dark:bg-amber-900/40 dark:text-amber-300",
+    failed: "bg-red-100 text-red-800 dark:bg-red-900/40 dark:text-red-300",
+};
+// ---------------------------------------------------------------------------
+// Main component
+// ---------------------------------------------------------------------------
+export function SellerWhatsAppSettingsView({ hasCapability }) {
+    const queryClient = useQueryClient();
+    const { showToast } = useToast();
+    const { data, isLoading } = useQuery({
+        queryKey: ["store", "whatsapp-settings"],
+        queryFn: async () => {
+            const res = await apiClient.get(WHATSAPP_SELLER_ENDPOINTS.SETTINGS);
+            return (res?.whatsappConfig ?? null);
+        },
+    });
+    const cfg = data ?? null;
+    // Connection form state
+    const [phoneNumber, setPhoneNumber] = React.useState("");
+    const [wabaId, setWabaId] = React.useState("");
+    const [catalogId, setCatalogId] = React.useState("");
+    const [accessToken, setAccessToken] = React.useState("");
+    const [syncEnabled, setSyncEnabled] = React.useState(false);
+    React.useEffect(() => {
+        if (!cfg)
+            return;
+        setPhoneNumber(cfg.phoneNumber ?? "");
+        setWabaId(cfg.wabaId ?? "");
+        setCatalogId(cfg.catalogId ?? "");
+        setAccessToken(cfg.accessToken ?? "");
+        setSyncEnabled(cfg.catalogSyncEnabled ?? false);
+    }, [cfg]);
+    // Save mutation
+    const saveMutation = useMutation({
+        mutationFn: async () => {
+            const payload = {
+                catalogSyncEnabled: syncEnabled,
+            };
+            if (phoneNumber)
+                payload.phoneNumber = phoneNumber;
+            if (wabaId)
+                payload.wabaId = wabaId;
+            if (catalogId)
+                payload.catalogId = catalogId;
+            // Only send accessToken if user has typed a new value (not the masked placeholder)
+            if (accessToken && accessToken !== "••••••")
+                payload.accessToken = accessToken;
+            return apiClient.put(WHATSAPP_SELLER_ENDPOINTS.SETTINGS, payload);
+        },
+        onSuccess: () => {
+            showToast("WhatsApp settings saved", "success");
+            void queryClient.invalidateQueries({ queryKey: ["store", "whatsapp-settings"] });
+        },
+        onError: (err) => {
+            const msg = err instanceof Error ? err.message : "Failed to save settings";
+            showToast(msg, "error");
+        },
+    });
+    // Catalog sync mutation
+    const syncMutation = useMutation({
+        mutationFn: async () => apiClient.post(WHATSAPP_SELLER_ENDPOINTS.CATALOG_SYNC, {}),
+        onSuccess: (res) => {
+            const r = res ?? {};
+            showToast(`Synced ${r.successCount ?? 0} product${(r.successCount ?? 0) !== 1 ? "s" : ""} to WhatsApp catalog`, "success");
+            void queryClient.invalidateQueries({ queryKey: ["store", "whatsapp-settings"] });
+        },
+        onError: (err) => {
+            const msg = err instanceof Error ? err.message : "Sync failed";
+            showToast(msg, "error");
+        },
+    });
+    if (!hasCapability) {
+        return (_jsx("div", { className: "max-w-xl mx-auto py-8 px-4", children: _jsxs(Alert, { variant: "warning", children: [_jsx("p", { className: "font-medium", children: "WhatsApp catalog sync is not enabled for your store." }), _jsx("p", { className: "text-sm mt-1", children: "Contact LetItRip support to request access to the WhatsApp Business integration." })] }) }));
+    }
+    return (_jsxs("div", { className: "max-w-2xl mx-auto space-y-8 py-6 px-4", children: [_jsxs("section", { children: [_jsx("h2", { className: "text-base font-semibold text-zinc-900 dark:text-zinc-100 mb-4", children: "How to connect your WhatsApp Business account" }), _jsx("ol", { className: "space-y-3", children: STEPS.map((step) => {
+                            const done = step.checkKey === undefined
+                                ? false
+                                : step.checkKey === "connected"
+                                    ? cfg?.connected === true
+                                    : Boolean(cfg?.[step.checkKey]);
+                            return (_jsxs("li", { className: "flex gap-3", children: [_jsx("span", { className: `flex-shrink-0 w-6 h-6 rounded-full text-xs font-bold flex items-center justify-center mt-0.5 ${done
+                                            ? "bg-green-500 text-white"
+                                            : "bg-zinc-200 dark:bg-zinc-700 text-zinc-600 dark:text-zinc-300"}`, children: done ? "✓" : step.n }), _jsxs("div", { children: [_jsx("p", { className: "text-sm font-medium text-zinc-900 dark:text-zinc-100", children: step.title }), _jsx("p", { className: "text-xs text-zinc-500 dark:text-zinc-400 mt-0.5", children: step.body })] })] }, step.n));
+                        }) })] }), _jsxs("section", { className: "border border-zinc-200 dark:border-zinc-700 rounded-xl p-5", children: [_jsxs("div", { className: "flex items-center justify-between mb-4", children: [_jsx("h2", { className: "text-sm font-semibold text-zinc-900 dark:text-zinc-100", children: "Connection" }), isLoading ? null : cfg?.connected ? (_jsx("span", { className: "text-xs font-medium px-2 py-0.5 rounded-full bg-green-100 text-green-800 dark:bg-green-900/40 dark:text-green-300", children: "Connected" })) : (_jsx("span", { className: "text-xs font-medium px-2 py-0.5 rounded-full bg-zinc-100 text-zinc-500 dark:bg-zinc-800 dark:text-zinc-400", children: "Not configured" }))] }), _jsxs(Form, { onSubmit: (e) => {
+                            e.preventDefault();
+                            saveMutation.mutate();
+                        }, className: "space-y-4", children: [_jsx(Input, { label: "WhatsApp Business Phone Number", value: phoneNumber, onChange: (e) => setPhoneNumber(e.target.value), placeholder: "919876543210", helperText: "Digits only, include country code (e.g. 91 for India)" }), _jsx(Input, { label: "WABA ID (WhatsApp Business Account ID)", value: wabaId, onChange: (e) => setWabaId(e.target.value), placeholder: "123456789012345", helperText: "From Meta Business Manager \u2192 WhatsApp Accounts" }), _jsx(Input, { label: "Catalog ID", value: catalogId, onChange: (e) => setCatalogId(e.target.value), placeholder: "987654321098765", helperText: "From Meta Commerce Manager \u2192 Catalogs" }), _jsx(MaskedTokenInput, { label: "System User Access Token", value: accessToken, onChange: setAccessToken, placeholder: "EAAxxxxxxxx\u2026", helperText: "Long-lived token with WhatsApp Business permissions" }), _jsx(FormActions, { align: "right", children: _jsx(Button, { type: "submit", isLoading: saveMutation.isPending, disabled: saveMutation.isPending, children: saveMutation.isPending ? "Saving…" : "Save & Connect" }) })] })] }), _jsxs("section", { className: "border border-zinc-200 dark:border-zinc-700 rounded-xl p-5", children: [_jsx("h2", { className: "text-sm font-semibold text-zinc-900 dark:text-zinc-100 mb-4", children: "Catalog Sync" }), _jsxs("div", { className: "flex items-center justify-between mb-4", children: [_jsxs("div", { children: [_jsx("p", { className: "text-sm text-zinc-700 dark:text-zinc-300", children: "Enable catalog sync" }), _jsx("p", { className: "text-xs text-zinc-500 dark:text-zinc-400", children: "When enabled, your published standard products can be synced to WhatsApp." })] }), _jsx(Toggle, { checked: syncEnabled, onChange: setSyncEnabled, disabled: !cfg?.connected })] }), cfg?.lastCatalogSyncAt && (_jsxs("div", { className: "flex items-center gap-2 text-xs text-zinc-500 dark:text-zinc-400 mb-3", children: [_jsxs("span", { children: ["Last sync: ", new Date(cfg.lastCatalogSyncAt).toLocaleString("en-IN")] }), cfg.lastSyncCount !== undefined && _jsxs("span", { children: ["\u00B7 ", cfg.lastSyncCount, " products"] }), cfg.lastSyncStatus && (_jsx("span", { className: `px-1.5 py-0.5 rounded ${STATUS_COLOR[cfg.lastSyncStatus] ?? ""}`, children: cfg.lastSyncStatus }))] })), _jsx("p", { className: "text-xs text-zinc-400 dark:text-zinc-500 mb-3", children: "Only published standard products are synced. Auctions and pre-orders are excluded. Batches of up to 50 products per call." }), _jsx(Button, { onClick: () => syncMutation.mutate(), isLoading: syncMutation.isPending, disabled: !cfg?.connected || !syncEnabled || syncMutation.isPending, variant: "secondary", children: syncMutation.isPending ? "Syncing…" : "Sync Now" })] }), _jsxs("section", { className: "border border-zinc-200 dark:border-zinc-700 rounded-xl p-5", children: [_jsx("h2", { className: "text-sm font-semibold text-zinc-900 dark:text-zinc-100 mb-2", children: "Purchase Announcement Preview" }), _jsx("p", { className: "text-xs text-zinc-500 dark:text-zinc-400 mb-3", children: "This message is sent automatically to your phone and the platform admin when a new order is placed." }), _jsx("div", { className: "bg-zinc-50 dark:bg-zinc-800/60 rounded-lg px-4 py-3 text-sm text-zinc-700 dark:text-zinc-200 font-mono", children: buildPurchaseAnnouncementMessage({
+                            buyerName: "Ravi K.",
+                            firstItemName: "Charizard PSA 9",
+                            additionalItemCount: 2,
+                            totalAmount: 450000,
+                            orderId: "order-3-20260510-a1b2c3",
+                        }) })] })] }));
+}

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

@@ -1 +1,3 @@
 export { WhatsAppChatButton } from "./WhatsAppChatButton";
+export { SellerWhatsAppSettingsView } from "./SellerWhatsAppSettingsView";
+export type { SellerWhatsAppSettingsViewProps } from "./SellerWhatsAppSettingsView";

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

@@ -1 +1,2 @@
 export { WhatsAppChatButton } from "./WhatsAppChatButton";
+export { SellerWhatsAppSettingsView } from "./SellerWhatsAppSettingsView";

package/dist/features/whatsapp-bot/helpers/whatsapp.d.ts

@@ -1,4 +1,4 @@
-import type { CheckoutMessageInput, StatusNotificationInput, WebhookVerifyInput, IncomingWebhookPayload, SendWhatsAppInput, StatusMessageInput } from "../types";
+import type { CheckoutMessageInput, StatusNotificationInput, WebhookVerifyInput, IncomingWebhookPayload, SendWhatsAppInput, StatusMessageInput, WaBusinessSendInput, CatalogSyncInput, CatalogSyncResult, PurchaseAnnouncementInput } from "../types";
 export declare function buildCheckoutMessageURL(input: CheckoutMessageInput): string;
 export declare function buildStatusNotificationURL(input: StatusNotificationInput): string;
 export declare function verifyWebhookSignature(input: WebhookVerifyInput): boolean;
@@ -13,6 +13,28 @@ export declare function parseIncomingWebhookPayload(rawBody: string, contentType
  * Pass a custom `statusMessages` map to override the defaults.
  */
 export declare function buildStatusMessage(input: StatusMessageInput, statusMessages?: Record<string, string>): string;
+/**
+ * Send a WhatsApp message via Meta WhatsApp Business Cloud API.
+ * Distinct from the Twilio-based sendWhatsAppMessage — used for server-initiated
+ * platform announcements. Returns true on success, false on any failure.
+ */
+export declare function sendWhatsAppBusinessMessage(input: WaBusinessSendInput): Promise<boolean>;
+/**
+ * Sync a store's products to a Meta Commerce Catalog via items_batch API.
+ * Batches at 50 items per call (Meta limit). Returns aggregate results.
+ */
+export declare function syncProductsToCatalog(input: CatalogSyncInput): Promise<CatalogSyncResult>;
+/**
+ * Build a plain-text purchase announcement message for WhatsApp.
+ * Sent to admin numbers and store owner when a new order is placed.
+ */
+export declare function buildPurchaseAnnouncementMessage(input: PurchaseAnnouncementInput): string;
+/**
+ * Build a wa.me share link with a pre-filled message.
+ * Opens WhatsApp contact picker — user selects group manually.
+ * This is the only API-compliant way to target a WhatsApp group.
+ */
+export declare function buildGroupShareLink(message: string): string;
 /**
  * Send an outbound WhatsApp message via Twilio REST API.
  * Returns true on success, false on failure.

package/dist/features/whatsapp-bot/helpers/whatsapp.js

@@ -1,5 +1,6 @@
 import { createHmac, timingSafeEqual } from "crypto";
 import { getDefaultCurrencySymbol, getDefaultLocale, } from "../../../core/baseline-resolver";
+const META_GRAPH_BASE = "https://graph.facebook.com/v20.0";
 export function buildCheckoutMessageURL(input) {
     const { waNumber, cart, total, address, isPreorder = false } = input;
     const prefix = isPreorder ? "\uD83D\uDD16 *PRE-ORDER*\n\n" : "";
@@ -97,6 +98,109 @@ export function buildStatusMessage(input, statusMessages = DEFAULT_STATUS_MESSAG
         : "";
     return template.replace("{id}", orderId).replace("{tracking}", trackingLine);
 }
+/**
+ * Send a WhatsApp message via Meta WhatsApp Business Cloud API.
+ * Distinct from the Twilio-based sendWhatsAppMessage — used for server-initiated
+ * platform announcements. Returns true on success, false on any failure.
+ */
+export async function sendWhatsAppBusinessMessage(input) {
+    const { toPhone, message, phoneNumberId, accessToken } = input;
+    const cleanPhone = toPhone.replace(/\D/g, "");
+    if (!cleanPhone || !phoneNumberId || !accessToken)
+        return false;
+    try {
+        const res = await fetch(`${META_GRAPH_BASE}/${phoneNumberId}/messages`, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                Authorization: `Bearer ${accessToken}`,
+            },
+            body: JSON.stringify({
+                messaging_product: "whatsapp",
+                to: cleanPhone,
+                type: "text",
+                text: { body: message },
+            }),
+        });
+        return res.ok;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Sync a store's products to a Meta Commerce Catalog via items_batch API.
+ * Batches at 50 items per call (Meta limit). Returns aggregate results.
+ */
+export async function syncProductsToCatalog(input) {
+    const { catalogId, accessToken, products } = input;
+    const result = {
+        handles: [],
+        successCount: 0,
+        failureCount: 0,
+        errors: [],
+    };
+    const BATCH_SIZE = 50;
+    for (let i = 0; i < products.length; i += BATCH_SIZE) {
+        const batch = products.slice(i, i + BATCH_SIZE);
+        const requests = batch.map((p) => ({
+            method: "UPDATE",
+            retailer_id: p.id,
+            data: {
+                name: p.title,
+                description: p.description,
+                // Meta expects "<amount> <ISO_CURRENCY>" e.g. "450.00 INR"
+                price: `${(p.price / 100).toFixed(2)} ${p.currency}`,
+                image_url: p.imageUrl,
+                availability: p.availability,
+                condition: p.condition,
+                ...(p.link ? { url: p.link } : {}),
+            },
+        }));
+        try {
+            const res = await fetch(`${META_GRAPH_BASE}/${catalogId}/items_batch`, {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/json",
+                    Authorization: `Bearer ${accessToken}`,
+                },
+                body: JSON.stringify({ requests }),
+            });
+            const json = (await res.json());
+            if (res.ok && json.handles) {
+                result.handles.push(...json.handles);
+                result.successCount += batch.length;
+            }
+            else {
+                result.failureCount += batch.length;
+                result.errors.push(json.error?.message ?? `Batch ${i / BATCH_SIZE + 1} failed`);
+            }
+        }
+        catch (err) {
+            result.failureCount += batch.length;
+            result.errors.push(String(err));
+        }
+    }
+    return result;
+}
+/**
+ * Build a plain-text purchase announcement message for WhatsApp.
+ * Sent to admin numbers and store owner when a new order is placed.
+ */
+export function buildPurchaseAnnouncementMessage(input) {
+    const { buyerName, firstItemName, additionalItemCount, totalAmount, orderId } = input;
+    const extra = additionalItemCount > 0 ? ` + ${additionalItemCount} more item${additionalItemCount > 1 ? "s" : ""}` : "";
+    const amount = (totalAmount / 100).toLocaleString("en-IN");
+    return `🛍️ New order! ${buyerName} purchased ${firstItemName}${extra} for ₹${amount}. Order #${orderId}`;
+}
+/**
+ * Build a wa.me share link with a pre-filled message.
+ * Opens WhatsApp contact picker — user selects group manually.
+ * This is the only API-compliant way to target a WhatsApp group.
+ */
+export function buildGroupShareLink(message) {
+    return `https://wa.me/?text=${encodeURIComponent(message)}`;
+}
 /**
  * Send an outbound WhatsApp message via Twilio REST API.
  * Returns true on success, false on failure.

package/dist/features/whatsapp-bot/server.d.ts

@@ -4,3 +4,4 @@
  * Server-only entry point for WhatsApp bot helpers (crypto operations).
  */
 export * from "./helpers/whatsapp";
+export * from "./types";

package/dist/features/whatsapp-bot/server.js

@@ -4,3 +4,4 @@
  * Server-only entry point for WhatsApp bot helpers (crypto operations).
  */
 export * from "./helpers/whatsapp";
+export * from "./types";

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

@@ -40,6 +40,55 @@ export interface SendWhatsAppInput {
     /** 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;
+}
+/** 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 paise (will be converted to INR: price/100) */
+    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 paise */
+    totalAmount: number;
+    orderId: 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 {

package/dist/features/wishlist/components/WishlistView.d.ts

@@ -2,9 +2,7 @@ import React from "react";
 import type { WishlistItem, WishlistResponse } from "../types";
 export type WishlistTab = "products" | "auctions" | "categories" | "stores";
 export interface WishlistViewProps {
-    /** Authenticated user id — required to fetch wishlist */
     userId?: string;
-    /** Optional initial SSR data */
     initialData?: WishlistResponse;
     labels?: {
         title?: string;
@@ -12,21 +10,13 @@ export interface WishlistViewProps {
         emptyTitle?: string;
         emptyDescription?: string;
     };
-    /** Render tab bar (receives active tab and setter) */
     renderTabs?: (activeTab: WishlistTab, onTabChange: (tab: WishlistTab) => void) => React.ReactNode;
-    /** Render search input */
     renderSearch?: (value: string, onChange: (v: string) => void) => React.ReactNode;
-    /** Render sort dropdown */
     renderSort?: (value: string, onChange: (v: string) => void) => React.ReactNode;
-    /** Render view mode toggle */
     renderViewToggle?: (mode: string, onToggle: (m: string) => void) => React.ReactNode;
-    /** Render the products grid */
     renderProducts?: (items: WishlistItem[], isLoading: boolean) => React.ReactNode;
-    /** Render coming-soon placeholder for non-products tabs */
     renderTabPlaceholder?: (tab: WishlistTab) => React.ReactNode;
-    /** Render bulk action bar */
     renderBulkActions?: (selectedIds: string[], onClearSelection: () => void) => React.ReactNode;
-    /** Render pagination */
     renderPagination?: (total: number) => React.ReactNode;
     className?: string;
 }