@mohasinac/appkit 4.53.1 → 4.54.0

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

@@ -1,283 +0,0 @@
-import { normalizeError } from "../../../errors/normalize.js";
-import { createHmac, timingSafeEqual } from "crypto";
-import { getDefaultCurrencySymbol, getDefaultLocale, } from "../../../core/baseline-resolver.js";
-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" : "";
-    const lines = cart.map((i) => `• ${i.name} ×${i.qty} — ${getDefaultCurrencySymbol()}${(i.salePrice * i.qty).toLocaleString(getDefaultLocale())}`);
-    const body = [
-        `${prefix}Hi Hobson! I'd like to place an order:`,
-        "",
-        ...lines,
-        "",
-        `*Total: ${getDefaultCurrencySymbol()}${total.toLocaleString(getDefaultLocale())}*`,
-        "",
-        `Deliver to: ${address.name}, ${address.line1}${address.line2 ? ", " + address.line2 : ""}, ${address.city} - ${address.pincode}`,
-        `Phone: ${address.phone}`,
-        "",
-        "Please share payment details.",
-    ].join("\n");
-    return `https://wa.me/${waNumber}?text=${encodeURIComponent(body)}`;
-}
-export function buildStatusNotificationURL(input) {
-    const { userPhone, template, vars } = input;
-    const body = template.replace(/\{(\w+)\}/g, (_, key) => vars[key] ?? `{${key}}`);
-    return `https://wa.me/${userPhone}?text=${encodeURIComponent(body)}`;
-}
-export function verifyWebhookSignature(input) {
-    const { payload, signature, secret } = input;
-    const expected = createHmac("sha256", secret).update(payload).digest("hex");
-    const expectedBuf = Buffer.from(expected, "hex");
-    const sigBuf = Buffer.from(signature, "hex");
-    if (expectedBuf.length !== sigBuf.length)
-        return false;
-    return timingSafeEqual(expectedBuf, sigBuf);
-}
-export function isAdminNumber(incomingNumber, adminBotNumber) {
-    const clean = (n) => n.replace(/\D/g, "");
-    return clean(incomingNumber).endsWith(clean(adminBotNumber));
-}
-/**
- * Parse an incoming WhatsApp webhook payload (Twilio form-encoded or Wati.io JSON).
- * Returns null if the payload cannot be parsed or is missing required fields.
- */
-export function parseIncomingWebhookPayload(rawBody, contentType) {
-    try {
-        if (contentType.includes("application/x-www-form-urlencoded")) {
-            const params = new URLSearchParams(rawBody);
-            const from = params.get("From") ?? "";
-            const body = params.get("Body") ?? "";
-            if (!from || !body)
-                return null;
-            return {
-                from: from.replace(/^whatsapp:/i, "").replace(/\D/g, ""),
-                body: body.trim(),
-            };
-        }
-        // JSON format (Wati.io or generic)
-        const json = JSON.parse(rawBody);
-        const from = typeof json.senderWaId === "string"
-            ? json.senderWaId
-            : typeof json.from === "string"
-                ? json.from
-                : "";
-        const body = typeof json.text?.body ===
-            "string"
-            ? json.text.body
-            : typeof json.body === "string"
-                ? json.body
-                : "";
-        if (!from || !body)
-            return null;
-        return { from: from.replace(/\D/g, ""), body: body.trim() };
-    }
-    catch (_err) {
-        void normalizeError(_err);
-        return null;
-    }
-}
-const DEFAULT_STATUS_MESSAGES = {
-    pending_payment: "🛒 Your order #{id} has been received and is awaiting payment confirmation.",
-    payment_confirmed: "✅ Payment confirmed for order #{id}! We're getting it ready.",
-    processing: "📦 Your order #{id} is being packed and prepared for dispatch.",
-    shipped: "🚚 Your order #{id} is on its way!{tracking}",
-    out_for_delivery: "🏃 Your order #{id} is out for delivery today!",
-    delivered: "🎉 Order #{id} delivered! Thank you for your order!",
-    cancelled: "❌ Your order #{id} has been cancelled. Contact us if you have any questions.",
-    refund_initiated: "💸 Refund initiated for order #{id}. It should reflect within 5–7 business days.",
-};
-/**
- * Build a human-readable status notification message for an order.
- * Pass a custom `statusMessages` map to override the defaults.
- */
-export function buildStatusMessage(input, statusMessages = DEFAULT_STATUS_MESSAGES) {
-    const { orderId, status, trackingNumber, courierName } = input;
-    const template = statusMessages[status] ??
-        `Your order #${orderId} status updated to: ${status}.`;
-    const trackingLine = trackingNumber
-        ? `\nTracking: ${courierName ? courierName + " — " : ""}${trackingNumber}`
-        : "";
-    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 (_err) {
-        void normalizeError(_err);
-        return false;
-    }
-}
-/**
- * Send a pre-approved Meta message TEMPLATE via WhatsApp Business Cloud API.
- * Required for business-initiated sends outside the 24h customer-service
- * window (proactive order/status notifications) — Meta rejects free-form
- * `sendWhatsAppBusinessMessage` `type: "text"` sends in that case. Returns
- * true on success, false on any failure (including a missing/unapproved
- * template — Meta returns a 4xx with an error body, not a network failure).
- */
-export async function sendWhatsAppTemplateMessage(input) {
-    const { toPhone, phoneNumberId, accessToken, templateName, languageCode, bodyParams } = input;
-    const cleanPhone = toPhone.replace(/\D/g, "");
-    if (!cleanPhone || !phoneNumberId || !accessToken || !templateName)
-        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: "template",
-                template: {
-                    name: templateName,
-                    language: { code: languageCode },
-                    ...(bodyParams?.length
-                        ? {
-                            components: [
-                                {
-                                    type: "body",
-                                    parameters: bodyParams.map((text) => ({ type: "text", text })),
-                                },
-                            ],
-                        }
-                        : {}),
-                },
-            }),
-        });
-        return res.ok;
-    }
-    catch (_err) {
-        void normalizeError(_err);
-        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.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) {
-            void normalizeError(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.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)}`;
-}
-// buildPaymentProofReviewMessage moved to ./payment-proof-message.ts (pure,
-// no crypto import) so it can be exported client-safe. Re-exported here for
-// backward compatibility with existing server-side importers of this file.
-export { buildPaymentProofReviewMessage } from "./payment-proof-message.js";
-/**
- * Send an outbound WhatsApp message via Twilio REST API.
- * Returns true on success, false on failure.
- */
-export async function sendWhatsAppMessage(input) {
-    const { toPhone, message, accountSid, authToken, fromNumber } = input;
-    const cleanPhone = toPhone.replace(/\D/g, "");
-    if (!cleanPhone)
-        return false;
-    const url = `https://api.twilio.com/2010-04-01/Accounts/${accountSid}/Messages.json`;
-    const body = new URLSearchParams({
-        From: fromNumber,
-        To: `whatsapp:+${cleanPhone}`,
-        Body: message,
-    });
-    const res = await fetch(url, {
-        method: "POST",
-        headers: {
-            "Content-Type": "application/x-www-form-urlencoded",
-            Authorization: `Basic ${Buffer.from(`${accountSid}:${authToken}`).toString("base64")}`,
-        },
-        body: body.toString(),
-    });
-    return res.ok;
-}

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

@@ -1,3 +0,0 @@
-export * from "./types";
-export * from "./components";
-export { manifest } from "./manifest";

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

@@ -1,3 +0,0 @@
-export * from "./types/index.js";
-export * from "./components/index.js";
-export { manifest } from "./manifest.js";

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

@@ -1,2 +0,0 @@
-import type { FeatureManifest } from "../../contracts";
-export declare const manifest: FeatureManifest;

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

@@ -1,13 +0,0 @@
-export const manifest = {
-    name: "whatsappBot",
-    i18nNamespace: "whatsappBot",
-    envKeys: [
-        "WHATSAPP_BOT_NUMBER",
-        "WHATSAPP_WEBHOOK_SECRET",
-    ],
-    routes: [],
-    apiRoutes: [
-        { segment: "api/whatsapp/webhook", methods: ["POST"] },
-        { segment: "api/whatsapp/send-status", methods: ["POST"] },
-    ],
-};

package/dist/features/whatsapp-bot/messages/en.json

@@ -1,7 +0,0 @@
-{
-    "whatsappBot": {
-        "chatNow": "Chat on WhatsApp",
-        "orderViaWhatsapp": "Order via WhatsApp",
-        "supportViaWhatsapp": "Contact support"
-    }
-}

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

@@ -1,7 +0,0 @@
-/**
- * @mohasinac/appkit/features/whatsapp-bot/server
- *
- * Server-only entry point for WhatsApp bot helpers (crypto operations).
- */
-export * from "./helpers/whatsapp";
-export * from "./types";

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

@@ -1,7 +0,0 @@
-/**
- * @mohasinac/appkit/features/whatsapp-bot/server
- *
- * Server-only entry point for WhatsApp bot helpers (crypto operations).
- */
-export * from "./helpers/whatsapp.js";
-export * from "./types/index.js";

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

@@ -1,126 +0,0 @@
-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

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