@mohasinac/appkit 4.53.2 → 4.54.1

package/dist/_internal/server/jobs/core/whatsappNotify.js

@@ -1,140 +0,0 @@
-/**
- * Core: async WhatsApp notification dispatch (`whatsappNotify` job).
- *
- * `sendNotification()` (appkit/src/features/admin/actions/notification-actions.ts)
- * no longer calls the Meta Cloud API synchronously in-request — it enqueues
- * this job instead (CLAUDE.md Rule #6 async job primitive) and returns
- * immediately. This runner does the actual send, with a bounded retry, and
- * writes the outcome back onto `notifications/{notificationId}` so admins
- * have visibility beyond the `jobs/{jobId}` doc itself.
- *
- * Retry note: `sendWhatsAppTemplateMessage`/`sendWhatsAppBusinessMessage`
- * return a plain boolean (not a status code), so this runner cannot cleanly
- * distinguish a transient 5xx from a terminal 4xx (bad token, unknown
- * template) the way a status-code-aware client could. It retries any
- * failure up to MAX_ATTEMPTS with a short backoff — an acceptable
- * simplification since this runs off the critical path, well inside the
- * Firebase Function's 300s budget, and a terminal error just burns two
- * extra fast failures before giving up.
- */
-import { normalizeError } from "../../../../errors/normalize.js";
-import { notificationRepository } from "../../../../features/admin/repository/notification.repository.js";
-import { sendWhatsAppTemplateMessage, sendWhatsAppBusinessMessage, } from "../../../../features/whatsapp-bot/helpers/whatsapp.js";
-import { isChannelHealthy, recordChannelOutcome } from "../../notifications/channel-health.js";
-import { guardSend, logSuppressedSend } from "../../notifications/send-guard.js";
-const MAX_ATTEMPTS = 3;
-const RETRY_DELAY_MS = 1500;
-function delay(ms) {
-    return new Promise((resolve) => setTimeout(resolve, ms));
-}
-export async function runWhatsAppNotify(payload, ctx) {
-    const { toPhone, title, message, type, templateName, templateLanguage, notificationId, phoneNumberId, accessToken } = payload;
-    /*
-     * The messaging guard, applied HERE rather than inside
-     * `sendWhatsAppBusinessMessage` itself.
-     *
-     * 🛑 That placement is deliberate and must not be "improved" by pushing a
-     * required guard parameter down into the sender. `features/whatsapp-bot/helpers/whatsapp.ts`
-     * is re-exported from `appkit/src/index.ts` (via `isAdminNumber`), and
-     * `guardSend` reaches `firebase-admin` through the settings and budget
-     * repositories. A static import of it from that file would put
-     * `firebase-admin` in the main entry's import graph, which is precisely the
-     * Turbopack client-bundle trap in Root Cause #6/#24 — it builds fine locally
-     * on webpack and fails every page in production.
-     *
-     * So the senders stay pure and each of the three real call sites guards
-     * itself; `scripts/audit-unguarded-send.mjs` enforces that a file calling a
-     * WhatsApp sender also calls `guardSend`.
-     *
-     * Note this job is only ever reached for an email/WhatsApp-ELIGIBLE type —
-     * `sendNotification` returns before enqueuing otherwise — so this is the
-     * ceiling and kill-switch check, not the type check.
-     */
-    const guard = {
-        channel: "whatsapp",
-        feature: type,
-        audience: "user",
-    };
-    const decision = await guardSend(guard);
-    if (!decision.allow) {
-        logSuppressedSend(guard, decision);
-        await notificationRepository
-            .update(notificationId, { whatsappStatus: "skipped" })
-            .catch((err) => {
-            void normalizeError(err);
-        });
-        return {
-            summary: { total: 1, succeeded: 0, skipped: 1, failed: 0 },
-            succeeded: [],
-            skipped: [notificationId],
-            failed: [],
-        };
-    }
-    if (!(await isChannelHealthy("whatsapp"))) {
-        ctx.logger.warn("whatsappNotify: WhatsApp channel circuit is open — skipping send", { notificationId });
-        await notificationRepository
-            .update(notificationId, { whatsappStatus: "skipped" })
-            .catch((err) => {
-            void normalizeError(err);
-        });
-        return {
-            summary: { total: 1, succeeded: 0, skipped: 1, failed: 0 },
-            succeeded: [],
-            skipped: [notificationId],
-            failed: [],
-        };
-    }
-    let sent = false;
-    let lastError;
-    for (let attempt = 1; attempt <= MAX_ATTEMPTS && !sent; attempt++) {
-        try {
-            sent = templateName
-                ? await sendWhatsAppTemplateMessage({
-                    toPhone,
-                    phoneNumberId,
-                    accessToken,
-                    templateName,
-                    languageCode: templateLanguage ?? "en",
-                    bodyParams: [title, message],
-                })
-                : await sendWhatsAppBusinessMessage({
-                    toPhone,
-                    phoneNumberId,
-                    accessToken,
-                    message: `*${title}*\n${message}`,
-                });
-            if (!sent)
-                lastError = "Meta WhatsApp API returned a non-OK response";
-        }
-        catch (err) {
-            void normalizeError(err);
-            lastError = err instanceof Error ? err.message : String(err);
-        }
-        if (!sent && attempt < MAX_ATTEMPTS) {
-            ctx.logger.warn("whatsappNotify: send attempt failed, retrying", { notificationId, attempt, error: lastError ?? "" });
-            await delay(RETRY_DELAY_MS * attempt);
-        }
-    }
-    if (!templateName) {
-        ctx.logger.warn("whatsappNotify: no approved template configured for this notification type — sent as free-form text, which Meta rejects outside the 24h customer-service window", { notificationId });
-    }
-    await recordChannelOutcome("whatsapp", sent);
-    await notificationRepository
-        .update(notificationId, { whatsappStatus: sent ? "sent" : "failed" })
-        .catch((err) => {
-        void normalizeError(err);
-        ctx.logger.warn("whatsappNotify: failed to write back whatsappStatus onto notification doc", {
-            notificationId,
-            error: err instanceof Error ? err.message : String(err),
-        });
-    });
-    if (!sent) {
-        throw new Error(lastError ?? "WhatsApp send failed after retries");
-    }
-    return {
-        summary: { total: 1, succeeded: 1, skipped: 0, failed: 0 },
-        succeeded: [notificationId],
-        skipped: [],
-        failed: [],
-    };
-}

package/dist/features/admin/components/AdminWhatsAppGuideView.d.ts

@@ -1,2 +0,0 @@
-import React from "react";
-export declare function AdminWhatsAppGuideView(): React.JSX.Element;

package/dist/features/admin/components/AdminWhatsAppGuideView.js

@@ -1,35 +0,0 @@
-import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
-import { Building2, Smartphone, KeyRound, MessageSquare, Power, FlaskConical } from "lucide-react";
-import { Alert, Code, Div, Heading, Li, Row, Section, Span, Stack, Table, Tbody, Td, Text, Th, Thead, Tr, Ul } from "../../../ui/index.js";
-import { GC } from "../../_guide-cls.js";
-export function AdminWhatsAppGuideView() {
-    return (_jsxs(Stack, { className: "max-w-3xl mx-auto", padding: "b-2xl", gap: "xl", children: [_jsxs(Section, { children: [_jsxs(Row, { className: "mb-2", align: "center", gap: "3", children: [_jsx(Row, { className: "flex-shrink-0 w-10 h-10 [background:linear-gradient(135deg,var(--appkit-color-primary-700)_0%,var(--appkit-color-cobalt)_100%)]", align: "center", justify: "center", rounded: "xl", children: _jsx(MessageSquare, { className: "w-5 h-5 text-white" }) }), _jsx(Text, { className: "text-[var(--appkit-color-text-muted)] tracking-widest", size: "sm", weight: "semibold", transform: "uppercase", children: "Admin Guide" })] }), _jsx(Heading, { level: 1, className: "text-[var(--appkit-color-text)] mb-2", mdSize: "3xl", size: "2xl", weight: "bold", children: "WhatsApp Integration" }), _jsx(Text, { className: "text-[var(--appkit-color-text-muted)]", children: "Connecting a real Meta WhatsApp Business Cloud API account so the platform-level order-notification addon and admin purchase announcements actually deliver. Do these steps outside the codebase, then paste the resulting values into Site Settings \u2192 WhatsApp." })] }), [
-                {
-                    Icon: Building2, title: "Meta Business Manager & App",
-                    content: (_jsxs(Ul, { className: GC.listMuted, children: [_jsxs(Li, { children: ["Create or verify a Business account at ", _jsx(Span, { weight: "bold", children: "business.facebook.com" }), ". Complete Business Verification (legal name, address, phone) \u2014 most message-template categories require a verified business before they'll be approved."] }), _jsxs(Li, { children: ["In ", _jsx(Span, { weight: "bold", children: "developers.facebook.com" }), ", create an App and add the ", _jsx(Span, { weight: "bold", children: "WhatsApp" }), " product. This gives you a test phone number for development immediately."] })] })),
-                },
-                {
-                    Icon: Smartphone, title: "Register the Real Business Phone Number",
-                    content: (_jsxs(Ul, { className: GC.listMuted, children: [_jsx(Li, { children: "WhatsApp Manager \u2192 Phone Numbers \u2192 Add phone number \u2192 verify via SMS or voice OTP." }), _jsx(Li, { children: "Complete Display Name review \u2014 Meta approves the shown business name before it goes live." })] })),
-                },
-                {
-                    Icon: KeyRound, title: "System User & Permanent Access Token",
-                    content: (_jsxs(_Fragment, { children: [_jsxs(Ul, { className: GC.listMuted, children: [_jsxs(Li, { children: ["Business Settings \u2192 Users \u2192 System Users \u2192 create a System User with ", _jsx(Span, { weight: "bold", children: "Admin" }), " role."] }), _jsxs(Li, { children: ["Assign it the WhatsApp Business Account asset with ", _jsx(Code, { size: "xs", padding: "xs", rounded: "default", surface: "subtle", children: "whatsapp_business_messaging" }), " + ", _jsx(Code, { size: "xs", padding: "xs", rounded: "default", surface: "subtle", children: "whatsapp_business_management" }), " permissions, then generate a token. System User tokens don't expire the way personal User tokens do, so this is the one to use in production."] })] }), _jsxs(Text, { className: "text-[var(--appkit-color-text-muted)] mt-3", size: "sm", children: ["Copy the token into ", _jsx(Span, { weight: "bold", children: "Site Settings \u2192 WhatsApp \u2192 Cloud API System User Token" }), ", and the ", _jsx(Span, { weight: "bold", children: "Phone Number ID" }), " (WhatsApp Manager \u2192 API Setup) into ", _jsx(Span, { weight: "bold", children: "Site Settings \u2192 WhatsApp \u2192 Phone Number ID" }), "."] })] })),
-                },
-                {
-                    Icon: MessageSquare, title: "Message Templates",
-                    content: (_jsxs(_Fragment, { children: [_jsx(Text, { className: "text-[var(--appkit-color-text-muted)] mb-3", size: "sm", children: "Meta's Cloud API only allows free-form text messages within a 24-hour window after the customer has messaged the business first. Any business-initiated proactive notification \u2014 order placed, shipped, delivered, cancelled, refund initiated \u2014 needs a pre-approved Message Template." }), _jsxs(Text, { className: "text-[var(--appkit-color-text-muted)] mb-3", size: "sm", children: ["WhatsApp Manager \u2192 Message Templates \u2192 create one template per notification type, category ", _jsx(Span, { weight: "bold", children: "UTILITY" }), " (transactional order updates get cheaper, faster approval than MARKETING):"] }), _jsx(Div, { overflow: "x-auto", children: _jsxs(Table, { size: "sm", children: [_jsx(Thead, { children: _jsxs(Tr, { className: "border-b border-[var(--appkit-color-border)]", children: [_jsx(Th, { align: "left", paddingSide: "pr-md", className: "text-[var(--appkit-color-text)]", padding: "xs-tall", weight: "semibold", children: "Notification type" }), _jsx(Th, { align: "left", className: "text-[var(--appkit-color-text)]", padding: "xs-tall", weight: "semibold", children: "Suggested template name" })] }) }), _jsx(Tbody, { size: "sm", color: "muted", children: [
-                                                ["Order placed", "order_placed_update"],
-                                                ["Order confirmed", "order_confirmed_update"],
-                                                ["Order shipped", "order_shipped_update"],
-                                                ["Order delivered", "order_delivered_update"],
-                                                ["Order cancelled", "order_cancelled_update"],
-                                                ["Refund initiated", "refund_initiated_update"],
-                                            ].map(([type, name]) => (_jsxs(Tr, { className: "border-b border-[var(--appkit-color-border)]/50", children: [_jsx(Td, { paddingSide: "pr-md", padding: "xs-tall", children: type }), _jsx(Td, { padding: "xs-tall", children: _jsx(Code, { size: "xs", padding: "xs", rounded: "default", surface: "subtle", children: name }) })] }, type))) })] }) }), _jsxs(Text, { className: "text-[var(--appkit-color-text-muted)] mt-3", size: "sm", children: ["Give each template two ", _jsx(Code, { size: "xs", padding: "xs", rounded: "default", surface: "subtle", children: "{{1}}" }), "/", _jsx(Code, { size: "xs", padding: "xs", rounded: "default", surface: "subtle", children: "{{2}}" }), " body variables \u2014 the runner substitutes the notification title and message text in that order. Submit for review; approval usually takes minutes to ~24 hours. Don't go live on a template until its status shows ", _jsx(Span, { weight: "bold", children: "APPROVED" }), "."] }), _jsxs(Text, { className: "text-[var(--appkit-color-text-muted)] mt-2", size: "sm", children: ["Once each template is approved, copy its exact template name (not the display label you gave it in Meta's UI) into ", _jsx(Span, { weight: "bold", children: "Site Settings \u2192 WhatsApp \u2192 [type] template name" }), ", and set the approved language code (e.g. ", _jsx(Code, { size: "xs", padding: "xs", rounded: "default", surface: "subtle", children: "en" }), ") in ", _jsx(Span, { weight: "bold", children: "Template language code" }), "."] })] })),
-                },
-                {
-                    Icon: Power, title: "Enable the Addon & Test",
-                    content: (_jsxs(Ul, { className: GC.listMuted, children: [_jsxs(Li, { children: [_jsx(Span, { weight: "bold", children: "Site Settings \u2192 Fees \u2192 \"Offer the WhatsApp order-updates addon at checkout\"" }), " \u2014 turn this on once credentials + at least one template are configured. Set the fee amount (default \u20B910)."] }), _jsx(Li, { children: "Place a real test order with the addon checked. Confirm the buyer receives the templated WhatsApp message. Until real credentials + an approved template exist, the async delivery job will fail at the Meta API call with a clear credential/template error \u2014 that's expected, not a code bug." })] })),
-                },
-            ].map(({ Icon, title, content }) => (_jsxs(Section, { overflow: "hidden", className: "border border-[var(--appkit-color-border)] bg-[var(--appkit-color-surface)]", rounded: "2xl", children: [_jsxs(Row, { className: "border-b border-[var(--appkit-color-border)] bg-[var(--appkit-color-surface-2,var(--appkit-color-border))]/20", padding: "inlineLg", align: "center", gap: "3", children: [_jsx(Icon, { className: "w-5 h-5 text-[var(--appkit-color-primary)]" }), _jsx(Heading, { level: 2, size: "base", weight: "semibold", children: title })] }), _jsx(Div, { paddingY: "y-md-lg", padding: "x-lg", children: content })] }, title))), _jsx(Alert, { variant: "info", children: _jsxs(Row, { align: "center", gap: "sm", children: [_jsx(FlaskConical, { className: "w-4 h-4 flex-shrink-0" }), _jsx(Text, { size: "sm", children: "Store-level Meta Commerce Catalog sync (product catalog on WhatsApp) uses separate, per-store credentials \u2014 see the Seller Guide's \"WhatsApp Catalog Sync\" page (Store dashboard \u2192 Guides). It shares the same Meta Business Manager account but not the same access token. The inbound-reply webhook (buyer messages the business number within 24h) uses the free-text send path and doesn't need a template." })] }) })] }));
-}

package/dist/features/orders/components/MarketplaceOrderCard.d.ts

@@ -1,36 +0,0 @@
-export interface MarketplaceOrderCardOrder {
-    id: string;
-    status: string;
-    orderDate: string | Date;
-    totalPrice: number;
-    currency?: string;
-    productId?: string;
-    productTitle?: string;
-    trackingNumber?: string;
-    items?: Array<unknown>;
-}
-export interface MarketplaceOrderCardLabels {
-    orderNumber: string;
-    placedOn: string;
-    items: string;
-    trackOrder: string;
-    writeReview: string;
-    viewOrder: string;
-}
-export interface MarketplaceOrderCardLinks {
-    detailHref: (order: MarketplaceOrderCardOrder) => string;
-    trackHref?: (order: MarketplaceOrderCardOrder) => string;
-    reviewHref?: (order: MarketplaceOrderCardOrder) => string;
-}
-export interface MarketplaceOrderCardProps {
-    order: MarketplaceOrderCardOrder;
-    links?: MarketplaceOrderCardLinks;
-    labels?: Partial<MarketplaceOrderCardLabels>;
-    className?: string;
-    variant?: "grid" | "list";
-    selectable?: boolean;
-    isSelected?: boolean;
-    onSelect?: (id: string, selected: boolean) => void;
-    onNavigate?: (href: string) => void;
-}
-export declare function MarketplaceOrderCard({ order, links, labels, className, variant, selectable, isSelected, onSelect, onNavigate, }: MarketplaceOrderCardProps): import("react").JSX.Element;

package/dist/features/orders/components/MarketplaceOrderCard.js

@@ -1,57 +0,0 @@
-"use client";
-import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
-import { useCallback } from "react";
-import { Package } from "lucide-react";
-import { BaseListingCard, Button, Caption, Row, Span, Stack, StatusBadge, Text, TextLink, Div } from "../../../ui/index.js";
-import { formatCurrency, formatDate } from "../../../utils/index.js";
-import { OrderStatusValues } from "../schemas/index.js";
-import { useLongPress } from "../../../react/hooks/useLongPress.js";
-const CLS_ACTION_BUTTON = "min-w-0 flex-1 px-[var(--appkit-space-2)] text-[length:var(--appkit-text-xs)]";
-const STATUS_MAP = {
-    pending: "pending",
-    confirmed: "info",
-    shipped: "info",
-    delivered: "success",
-    cancelled: "danger",
-    returned: "danger",
-};
-const DEFAULT_LABELS = {
-    orderNumber: "Order",
-    placedOn: "Placed on",
-    items: "Items",
-    trackOrder: "Track",
-    writeReview: "Review",
-    viewOrder: "View",
-};
-function defaultNavigate(href) {
-    if (typeof window !== "undefined") {
-        window.location.assign(href);
-    }
-}
-export function MarketplaceOrderCard({ order, links, labels, className = "", variant = "grid", selectable = false, isSelected = false, onSelect, onNavigate, }) {
-    const mergedLabels = { ...DEFAULT_LABELS, ...labels };
-    const navigate = onNavigate ?? defaultNavigate;
-    const orderId = order.id ?? "";
-    const shortId = `#${orderId.slice(0, 8).toUpperCase()}`;
-    const status = STATUS_MAP[order.status] ?? "pending";
-    const statusLabel = order.status.charAt(0).toUpperCase() + order.status.slice(1);
-    const isDelivered = order.status === OrderStatusValues.DELIVERED;
-    const isShipped = order.status === OrderStatusValues.SHIPPED;
-    const detailHref = links?.detailHref(order) ?? `/orders/${order.id}`;
-    const trackHref = links?.trackHref?.(order);
-    const reviewHref = links?.reviewHref?.(order);
-    const handleSelect = useCallback((event) => {
-        event.preventDefault();
-        event.stopPropagation();
-        onSelect?.(orderId, !isSelected);
-    }, [orderId, isSelected, onSelect]);
-    const longPress = useLongPress(() => onSelect?.(orderId, !isSelected));
-    const isListVariant = variant === "list";
-    const itemCount = order.items?.length ?? 0;
-    const infoBlock = (_jsxs(_Fragment, { children: [_jsx(Row, { className: "h-10 w-10 flex-shrink-0", surface: "subtle", align: "center", justify: "center", rounded: "lg", children: _jsx(Package, { className: "h-5 w-5 text-[var(--appkit-color-text-muted)] text-[var(--appkit-color-text-muted)]" }) }), _jsxs(Stack, { className: "min-w-0", gap: "xs", children: [_jsx(TextLink, { href: detailHref, className: "leading-tight", children: _jsx(Text, { weight: "semibold", className: "truncate", children: order.productTitle ?? shortId }) }), _jsxs(Caption, { className: "font-mono", children: [mergedLabels.orderNumber, " ", shortId] }), _jsxs(Caption, { children: [mergedLabels.placedOn, " ", formatDate(order.orderDate)] }), itemCount > 1 && (_jsxs(Caption, { children: [mergedLabels.items, ": ", _jsx(Span, { weight: "medium", children: itemCount })] }))] })] }));
-    const statusPriceBlock = (_jsxs(_Fragment, { children: [_jsx(StatusBadge, { status: status, label: statusLabel }), _jsx(Text, { weight: "semibold", className: "tabular-nums", children: formatCurrency(order.totalPrice, order.currency) })] }));
-    const actionsRow = (_jsxs(Row, { align: "center", gap: "sm", wrap: true, children: [(isShipped || isDelivered) &&
-                trackHref &&
-                order.trackingNumber && (_jsx(Button, { variant: "ghost", size: "sm", className: CLS_ACTION_BUTTON, onClick: () => navigate(trackHref), children: mergedLabels.trackOrder })), isDelivered && reviewHref && (_jsx(Button, { variant: "outline", size: "sm", className: CLS_ACTION_BUTTON, onClick: () => navigate(reviewHref), children: mergedLabels.writeReview })), _jsx(Button, { variant: "secondary", size: "sm", className: CLS_ACTION_BUTTON, onClick: () => navigate(detailHref), children: mergedLabels.viewOrder })] }));
-    return (_jsxs(Div, { rounded: "xl", border: "subtle", shadow: "hover-md", className: `group relative overflow-hidden bg-[var(--appkit-color-surface)] transition-all duration-200 ${isSelected ? "ring-2 ring-primary-500 dark:ring-primary-400" : ""} ${className}`, onMouseDown: onSelect && !isSelected ? longPress.onMouseDown : undefined, onMouseUp: onSelect && !isSelected ? longPress.onMouseUp : undefined, onMouseLeave: onSelect && !isSelected ? longPress.onMouseLeave : undefined, onTouchStart: onSelect && !isSelected ? longPress.onTouchStart : undefined, onTouchEnd: onSelect && !isSelected ? longPress.onTouchEnd : undefined, onTouchCancel: onSelect && !isSelected ? longPress.onTouchCancel : undefined, "data-section": "marketplaceordercard-div-411", children: [onSelect && (_jsx(BaseListingCard.Checkbox, { selected: isSelected, onSelect: handleSelect, label: isSelected ? "Deselect order" : "Select order", position: "top-2 left-2", className: selectable || isSelected ? "opacity-100" : "opacity-0 pointer-events-none group-hover:opacity-100 group-hover:pointer-events-auto transition-opacity" })), isListVariant ? (_jsxs(Row, { align: "center", justify: "between", gap: "md", padding: "md", "data-section": "marketplaceordercard-div-412", children: [_jsx(Div, { layout: "flex", align: "start", gap: "3", paddingX: selectable ? "l-xl" : undefined, className: "min-w-0 flex-1", "data-section": "marketplaceordercard-div-413", children: infoBlock }), _jsxs(Row, { align: "center", gap: "md", className: "flex-shrink-0", "data-section": "marketplaceordercard-div-416", children: [_jsx(Row, { align: "center", gap: "md", "data-section": "marketplaceordercard-div-417", children: statusPriceBlock }), actionsRow] })] })) : (_jsxs(Stack, { gap: "md", padding: "md", "data-section": "marketplaceordercard-div-412", children: [_jsx(Div, { layout: "flex", align: "start", gap: "3", paddingX: selectable ? "l-xl" : undefined, "data-section": "marketplaceordercard-div-413", children: infoBlock }), _jsxs(Stack, { gap: "3", "data-section": "marketplaceordercard-div-416", children: [_jsx(Row, { wrap: true, align: "center", justify: "between", gap: "3", "data-section": "marketplaceordercard-div-417", children: statusPriceBlock }), actionsRow] })] }))] }));
-}

package/dist/features/stores/components/StoreWhatsAppGuideView.d.ts

@@ -1,3 +0,0 @@
-import React from "react";
-export type StoreWhatsAppGuideViewProps = Record<string, never>;
-export declare function StoreWhatsAppGuideView(_props: StoreWhatsAppGuideViewProps): React.JSX.Element;

package/dist/features/stores/components/StoreWhatsAppGuideView.js

@@ -1,12 +0,0 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { ArrowLeft } from "lucide-react";
-import { Alert, Code, Div, Heading, Li, Section, Span, Stack, Text, TextLink, Ul } from "../../../ui/index.js";
-import { ROUTES } from "../../../next/routing/route-map.js";
-function GuideSection({ title, children, }) {
-    return (_jsxs(Section, { className: "border border-[var(--appkit-color-border)] bg-[var(--appkit-color-surface)]", rounded: "xl", shadow: "sm", padding: "lg", children: [_jsx(Heading, { level: 2, className: "mb-4 text-[var(--appkit-color-text)]", size: "lg", weight: "semibold", children: title }), children] }));
-}
-const LIST_DISC = "list-disc leading-relaxed";
-const TEXT_MUTED = "leading-relaxed text-[var(--appkit-color-text-muted)]";
-export function StoreWhatsAppGuideView(_props) {
-    return (_jsxs(Stack, { gap: "lg", padding: "b-2xl", children: [_jsxs(TextLink, { variant: "bare", href: String(ROUTES.STORE.GUIDE), size: "sm", layout: "inline-flex", align: "center", gap: "sm", className: "text-[var(--appkit-color-text-muted)] hover:text-[var(--appkit-color-text)] transition-colors", children: [_jsx(ArrowLeft, { className: "h-4 w-4" }), "Back to Seller Guide"] }), _jsxs(Div, { children: [_jsx(Heading, { level: 1, className: "text-[var(--appkit-color-text)]", size: "2xl", weight: "bold", children: "WhatsApp Catalog Sync" }), _jsx(Text, { className: "mt-1 text-[var(--appkit-color-text-muted)]", size: "sm", children: "Push your product catalog to Meta's Commerce Manager for WhatsApp catalog messages and Facebook/Instagram Shops \u2014 and import products back the other way." })] }), _jsx(GuideSection, { title: "1. Create a Commerce Manager catalog", children: _jsxs(Ul, { spacing: "tight", indent: "lg", children: [_jsxs(Li, { className: LIST_DISC, textSize: "sm", color: "muted", children: ["At ", _jsx(Span, { weight: "bold", children: "business.facebook.com/commerce" }), ", create a new catalog for the store (or use an existing one)."] }), _jsxs(Li, { className: LIST_DISC, textSize: "sm", color: "muted", children: ["Note the ", _jsx(Span, { weight: "bold", children: "Catalog ID" }), " shown in the catalog's settings."] })] }) }), _jsx(GuideSection, { title: "2. Generate a catalog-scoped access token", children: _jsxs(Text, { className: TEXT_MUTED, size: "sm", children: ["You need a Meta access token with ", _jsx(Code, { size: "xs", padding: "xs", rounded: "default", surface: "subtle", children: "catalog_management" }), " permission, scoped to that catalog. This is generated the same way as the platform-level WhatsApp System User token (ask your admin \u2014 Admin Guide \u2192 WhatsApp Integration, step 3) but assigned to the ", _jsx(Span, { weight: "bold", children: "catalog" }), " asset instead of the WhatsApp Business Account asset."] }) }), _jsxs(GuideSection, { title: "3. Enter credentials in the seller dashboard", children: [_jsxs(Text, { className: "mb-2 leading-relaxed text-[var(--appkit-color-text-muted)]", size: "sm", children: [_jsx(Span, { weight: "bold", children: "Store \u2192 WhatsApp" }), " settings page:"] }), _jsxs(Ul, { spacing: "tight", indent: "lg", children: [_jsx(Li, { className: LIST_DISC, textSize: "sm", color: "muted", children: "Catalog ID" }), _jsx(Li, { className: LIST_DISC, textSize: "sm", color: "muted", children: "Access Token" })] }), _jsxs(Text, { className: "mt-3 leading-relaxed text-[var(--appkit-color-text-muted)]", size: "sm", children: ["This is a store capability \u2014 it must be enabled for the store (", _jsx(Code, { size: "xs", padding: "xs", rounded: "default", surface: "subtle", children: "whatsapp_catalog_sync" }), " capability) before the settings page and sync actions are available."] })] }), _jsx(GuideSection, { title: "4. Push products to the catalog", children: _jsxs(Text, { className: TEXT_MUTED, size: "sm", children: ["Once connected, trigger a sync that batches published ", _jsx(Code, { size: "xs", padding: "xs", rounded: "default", surface: "subtle", children: "standard" }), "-listing products (up to 50 per API call) to the Meta catalog via the Commerce API ", _jsx(Code, { size: "xs", padding: "xs", rounded: "default", surface: "subtle", children: "items_batch" }), " endpoint \u2014 title, description, price, image, availability, and condition."] }) }), _jsx(GuideSection, { title: "5. Import products from the catalog", children: _jsxs(Text, { className: TEXT_MUTED, size: "sm", children: ["The reverse flow fetches products already in the Meta catalog and creates them as local ", _jsx(Span, { weight: "bold", children: "draft" }), " listings, deduplicating against existing products by slug/retailer-id matching."] }) }), _jsxs(Alert, { variant: "info", children: ["This is unrelated to the platform-level WhatsApp order-notification credentials \u2014 those are for sending order-status messages to buyers, not catalog sync. Only published ", _jsx(Span, { weight: "bold", children: "standard" }), " listings sync \u2014 auctions, pre-orders, and other listing types are not included."] })] }));
-}

package/dist/features/whatsapp-bot/api/send-status/route.d.ts

@@ -1,12 +0,0 @@
-/**
- * feat-whatsapp-bot — POST /api/whatsapp/send-status
- *
- * WhatsApp message delivery status update.
- *
- * Consumer stub:
- * ```ts
- * export { whatsappSendStatusPOST as POST } from "@mohasinac/feat-whatsapp-bot";
- * ```
- */
-import { NextResponse } from "next/server.js";
-export declare function POST(request: Request): Promise<NextResponse>;

package/dist/features/whatsapp-bot/api/send-status/route.js

@@ -1,38 +0,0 @@
-/**
- * feat-whatsapp-bot — POST /api/whatsapp/send-status
- *
- * WhatsApp message delivery status update.
- *
- * Consumer stub:
- * ```ts
- * export { whatsappSendStatusPOST as POST } from "@mohasinac/feat-whatsapp-bot";
- * ```
- */
-import { NextResponse } from "next/server.js";
-import { getProviders } from "../../../../contracts/index.js";
-import { normalizeError } from "../../../../errors/normalize.js";
-export async function POST(request) {
-    try {
-        const body = await request.json();
-        const { db } = getProviders();
-        if (!db)
-            return NextResponse.json({ success: false, error: "DB not configured" }, { status: 503 });
-        // Update message status in database
-        const repo = db.getRepository("whatsapp_message_status");
-        const updated = await repo.create({
-            ...body,
-            updatedAt: new Date(),
-        });
-        return NextResponse.json({
-            success: true,
-            data: updated,
-        });
-    }
-    catch (error) {
-        void normalizeError(error);
-        return NextResponse.json({
-            success: false,
-            error: error instanceof Error ? error.message : "Internal server error",
-        }, { status: 500 });
-    }
-}

package/dist/features/whatsapp-bot/api/webhook/route.d.ts

@@ -1,12 +0,0 @@
-/**
- * feat-whatsapp-bot — POST /api/whatsapp/webhook
- *
- * WhatsApp webhook receiver for incoming messages.
- *
- * Consumer stub:
- * ```ts
- * export { whatsappWebhookPOST as POST } from "@mohasinac/feat-whatsapp-bot";
- * ```
- */
-import { NextResponse } from "next/server.js";
-export declare function POST(request: Request): Promise<NextResponse>;

package/dist/features/whatsapp-bot/api/webhook/route.js

@@ -1,43 +0,0 @@
-/**
- * feat-whatsapp-bot — POST /api/whatsapp/webhook
- *
- * WhatsApp webhook receiver for incoming messages.
- *
- * Consumer stub:
- * ```ts
- * export { whatsappWebhookPOST as POST } from "@mohasinac/feat-whatsapp-bot";
- * ```
- */
-import { NextResponse } from "next/server.js";
-import { getProviders } from "../../../../contracts/index.js";
-import { normalizeError } from "../../../../errors/normalize.js";
-export async function POST(request) {
-    try {
-        const body = await request.json();
-        const { db, eventBus } = getProviders();
-        if (!db)
-            return NextResponse.json({ success: false, error: "DB not configured" }, { status: 503 });
-        // Store webhook payload for processing
-        const repo = db.getRepository("whatsapp_messages");
-        const created = await repo.create({
-            ...body,
-            receivedAt: new Date(),
-            processed: false,
-        });
-        // Emit event for async processing if eventBus available
-        if (eventBus) {
-            await eventBus.emit("whatsapp.message.received", created);
-        }
-        return NextResponse.json({
-            success: true,
-            data: created,
-        }, { status: 201 });
-    }
-    catch (error) {
-        void normalizeError(error);
-        return NextResponse.json({
-            success: false,
-            error: error instanceof Error ? error.message : "Internal server error",
-        }, { status: 500 });
-    }
-}

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

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