@mohasinac/appkit 2.1.3 → 2.2.0

package/src/features/whatsapp-bot/helpers/whatsapp.ts

@@ -1,137 +0,0 @@
-import { createHmac, timingSafeEqual } from "crypto";
-import type {
-  CheckoutMessageInput,
-  StatusNotificationInput,
-  WebhookVerifyInput,
-  IncomingWebhookPayload,
-  SendWhatsAppInput,
-  StatusMessageInput,
-} from "../types";
-
-export function buildCheckoutMessageURL(input: CheckoutMessageInput): string {
-  const { waNumber, cart, total, address, isPreorder = false } = input;
-  const prefix = isPreorder ? "\uD83D\uDD16 *PRE-ORDER*\n\n" : "";
-  const lines = cart.map(
-    (i) => `\u2022 ${i.name} \xD7${i.qty} \u2014 \u20B9${(i.salePrice * i.qty).toLocaleString("en-IN")}`,
-  );
-  const body = [
-    `${prefix}Hi Hobson! I'd like to place an order:`,
-    "",
-    ...lines,
-    "",
-    `*Total: \u20B9${total.toLocaleString("en-IN")}*`,
-    "",
-    `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: StatusNotificationInput): string {
-  const { userPhone, template, vars } = input;
-  const body = template.replace(
-    /\{(\w+)\}/g,
-    (_, key: string) => vars[key] ?? `{${key}}`,
-  );
-  return `https://wa.me/${userPhone}?text=${encodeURIComponent(body)}`;
-}
-
-export function verifyWebhookSignature(input: WebhookVerifyInput): boolean {
-  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: string, adminBotNumber: string): boolean {
-  const clean = (n: string) => 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: string,
-  contentType: string,
-): IncomingWebhookPayload | null {
-  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) as Record<string, unknown>;
-    const from =
-      typeof json.senderWaId === "string" ? json.senderWaId :
-      typeof json.from === "string" ? json.from : "";
-    const body =
-      typeof (json.text as Record<string, unknown> | undefined)?.body === "string"
-        ? ((json.text as Record<string, unknown>).body as string)
-        : typeof json.body === "string" ? json.body : "";
-    if (!from || !body) return null;
-    return { from: from.replace(/\D/g, ""), body: body.trim() };
-  } catch {
-    return null;
-  }
-}
-
-const DEFAULT_STATUS_MESSAGES: Record<string, string> = {
-  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: StatusMessageInput,
-  statusMessages: Record<string, string> = DEFAULT_STATUS_MESSAGES,
-): string {
-  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 an outbound WhatsApp message via Twilio REST API.
- * Returns true on success, false on failure.
- */
-export async function sendWhatsAppMessage(input: SendWhatsAppInput): Promise<boolean> {
-  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/src/features/whatsapp-bot/index.ts

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

package/src/features/whatsapp-bot/manifest.ts

@@ -1,15 +0,0 @@
-import type { FeatureManifest } from "../../contracts";
-
-export const manifest: FeatureManifest = {
-  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/src/features/whatsapp-bot/types/index.ts

@@ -1,61 +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;
-}
-
-/** 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/src/features/wishlist/columns/index.ts

@@ -1,65 +0,0 @@
-import type { TableColumn, ColumnExtensionOpts } from "../../../contracts";
-import type { WishlistItem } from "../types";
-
-/**
- * Default admin columns for wishlist items.
- * Use `buildWishlistColumns()` to customise via overrides / extras / omit.
- */
-export const wishlistAdminColumns: TableColumn<WishlistItem>[] = [
-  {
-    key: "productTitle",
-    header: "Product",
-    sortable: false,
-  },
-  {
-    key: "productPrice",
-    header: "Price",
-    sortable: true,
-    render: (item) =>
-      item.productPrice != null
-        ? `${item.productCurrency ?? "INR"} ${item.productPrice}`
-        : "—",
-  },
-  {
-    key: "productStatus",
-    header: "Status",
-    sortable: false,
-  },
-  {
-    key: "addedAt",
-    header: "Added",
-    sortable: true,
-  },
-];
-
-/**
- * Factory that returns columns for the wishlist admin table.
- *
- * @example
- * const cols = buildWishlistColumns<MyWishlistItem>({
- *   extras: [{ key: "alertPrice", header: "Alert", render: (w) => w.alertPrice }],
- *   omit: ["productStatus"],
- * });
- */
-export function buildWishlistColumns<T extends WishlistItem = WishlistItem>(
-  opts?: ColumnExtensionOpts<T>
-): TableColumn<T>[] {
-  let base = wishlistAdminColumns as unknown as TableColumn<T>[];
-
-  if (opts?.omit?.length) {
-    base = base.filter((c) => !opts.omit!.includes(c.key as string));
-  }
-
-  if (opts?.overrides) {
-    base = base.map((c) => {
-      const override = (opts.overrides as Record<string, Partial<TableColumn<T>>>)[c.key as string];
-      return override ? { ...c, ...override } : c;
-    });
-  }
-
-  if (opts?.extras?.length) {
-    base = [...base, ...opts.extras];
-  }
-
-  return base;
-}

package/src/features/wishlist/components/WishlistPage.tsx

@@ -1,118 +0,0 @@
-import { Button, Div, Text } from "../../../ui";
-import type { WishlistItem } from "../types";
-import { formatCurrency } from "../../../utils/number.formatter";
-
-interface WishlistCardProps {
-  item: WishlistItem;
-  onRemove?: (id: string) => void;
-  onProductClick?: (item: WishlistItem) => void;
-}
-
-export function WishlistCard({
-  item,
-  onRemove,
-  onProductClick,
-}: WishlistCardProps) {
-  return (
-    <Div className="flex gap-4 rounded-xl border border-neutral-200 bg-white p-4">
-      <Div
-        role={onProductClick ? "button" : undefined}
-        tabIndex={onProductClick ? 0 : undefined}
-        onClick={onProductClick ? () => onProductClick(item) : undefined}
-        onKeyDown={
-          onProductClick
-            ? (e) => e.key === "Enter" && onProductClick(item)
-            : undefined
-        }
-        className={`h-20 w-20 flex-shrink-0 overflow-hidden rounded-lg bg-neutral-100 ${onProductClick ? "cursor-pointer" : ""}`}
-      >
-        {item.productImage && (
-          <Div
-            role="img"
-            aria-label={item.productTitle ?? ""}
-            className="h-full w-full bg-center bg-cover"
-            style={{ backgroundImage: `url(${item.productImage})` }}
-          />
-        )}
-      </Div>
-      <Div className="flex flex-1 flex-col justify-between">
-        <Text className="font-medium text-neutral-900 line-clamp-2">
-          {item.productTitle}
-        </Text>
-        {item.productPrice !== undefined && (
-          <Text className="text-sm font-semibold text-neutral-900">
-            {formatCurrency(item.productPrice, item.productCurrency ?? "INR")}
-          </Text>
-        )}
-      </Div>
-      {onRemove && (
-        <Button
-          type="button"
-          variant="ghost"
-          size="sm"
-          onClick={() => onRemove(item.id)}
-          aria-label="Remove from wishlist"
-          className="self-start text-neutral-400 transition hover:text-red-500"
-        >
-          ✕
-        </Button>
-      )}
-    </Div>
-  );
-}
-
-interface WishlistPageProps {
-  items: WishlistItem[];
-  isLoading?: boolean;
-  onRemove?: (id: string) => void;
-  onProductClick?: (item: WishlistItem) => void;
-  emptyLabel?: string;
-}
-
-export function WishlistPage({
-  items,
-  isLoading,
-  onRemove,
-  onProductClick,
-  emptyLabel = "Your wishlist is empty",
-}: WishlistPageProps) {
-  if (isLoading) {
-    return (
-      <Div className="space-y-4">
-        {Array.from({ length: 4 }).map((_, i) => (
-          <Div
-            key={i}
-            className="flex animate-pulse gap-4 rounded-xl border border-neutral-200 p-4"
-          >
-            <Div className="h-20 w-20 rounded-lg bg-neutral-200" />
-            <Div className="flex-1 space-y-2">
-              <Div className="h-4 w-3/4 rounded bg-neutral-200" />
-              <Div className="h-4 w-1/3 rounded bg-neutral-200" />
-            </Div>
-          </Div>
-        ))}
-      </Div>
-    );
-  }
-
-  if (items.length === 0) {
-    return (
-      <Text className="py-16 text-center text-sm text-neutral-500">
-        {emptyLabel}
-      </Text>
-    );
-  }
-
-  return (
-    <Div className="space-y-4">
-      {items.map((item) => (
-        <WishlistCard
-          key={item.id}
-          item={item}
-          onRemove={onRemove}
-          onProductClick={onProductClick}
-        />
-      ))}
-    </Div>
-  );
-}

package/src/features/wishlist/components/WishlistToggleButton.tsx

@@ -1,68 +0,0 @@
-"use client";
-
-import type { MouseEvent } from "react";
-import { Button } from "../../../ui";
-
-interface WishlistToggleButtonProps {
-  inWishlist: boolean;
-  isLoading?: boolean;
-  onToggle: (e: MouseEvent) => void | Promise<void>;
-  addLabel: string;
-  removeLabel: string;
-  className?: string;
-  size?: "sm" | "md" | "lg";
-}
-
-const sizeClasses = {
-  sm: "w-7 h-7",
-  md: "w-9 h-9",
-  lg: "w-11 h-11",
-};
-
-export function WishlistToggleButton({
-  inWishlist,
-  isLoading = false,
-  onToggle,
-  addLabel,
-  removeLabel,
-  className = "",
-  size = "md",
-}: WishlistToggleButtonProps) {
-  const label = inWishlist ? removeLabel : addLabel;
-
-  return (
-    <Button
-      type="button"
-      onClick={onToggle}
-      disabled={isLoading}
-      aria-label={label}
-      title={label}
-      className={`
-        flex items-center justify-center rounded-full
-        transition-all duration-150
-        ${
-          inWishlist
-            ? "bg-rose-50 text-rose-500 hover:bg-rose-100"
-            : "bg-white/80 text-zinc-400 hover:text-rose-400"
-        }
-        ${sizeClasses[size]}
-        ${isLoading ? "opacity-50 cursor-not-allowed" : "cursor-pointer"}
-        ${className}
-      `}
-    >
-      <svg
-        className="w-4/6 h-4/6"
-        viewBox="0 0 24 24"
-        fill={inWishlist ? "currentColor" : "none"}
-        stroke="currentColor"
-        strokeWidth={2}
-      >
-        <path
-          strokeLinecap="round"
-          strokeLinejoin="round"
-          d="M4.318 6.318a4.5 4.5 0 000 6.364L12 20.364l7.682-7.682a4.5 4.5 0 00-6.364-6.364L12 7.636l-1.318-1.318a4.5 4.5 0 00-6.364 0z"
-        />
-      </svg>
-    </Button>
-  );
-}

package/src/features/wishlist/components/WishlistView.tsx

@@ -1,150 +0,0 @@
-"use client";
-
-import React from "react";
-import { Div, Heading, Row, Text } from "../../../ui";
-import { useWishlist } from "../hooks/useWishlist";
-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;
-    subtitle?: string;
-    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;
-}
-
-export function WishlistView({
-  userId,
-  initialData,
-  labels = {},
-  renderTabs,
-  renderSearch,
-  renderSort,
-  renderViewToggle,
-  renderProducts,
-  renderTabPlaceholder,
-  renderBulkActions,
-  renderPagination,
-  className = "",
-}: WishlistViewProps) {
-  const [activeTab, setActiveTab] = React.useState<WishlistTab>("products");
-  const [search, setSearch] = React.useState("");
-  const [sort, setSort] = React.useState("-addedAt");
-  const [viewMode, setViewMode] = React.useState("card");
-  const [selectedIds, setSelectedIds] = React.useState<string[]>([]);
-
-  const { items, total, isLoading } = useWishlist(userId, { initialData });
-
-  // Client-side filter + sort for products tab
-  const displayedItems = React.useMemo(() => {
-    if (activeTab !== "products") return [];
-    let result = [...items];
-    const q = search.trim().toLowerCase();
-    if (q) {
-      result = result.filter(
-        (i) =>
-          (i.productTitle ?? "").toLowerCase().includes(q) ||
-          (i.productSlug ?? "").toLowerCase().includes(q),
-      );
-    }
-    result.sort((a, b) => {
-      const desc = sort.startsWith("-");
-      const field = desc ? sort.slice(1) : sort;
-      if (field === "price") {
-        const av = a.productPrice ?? 0;
-        const bv = b.productPrice ?? 0;
-        return desc ? bv - av : av - bv;
-      }
-      const av = new Date(a.addedAt ?? "").getTime();
-      const bv = new Date(b.addedAt ?? "").getTime();
-      return desc ? bv - av : av - bv;
-    });
-    return result;
-  }, [items, activeTab, search, sort]);
-
-  return (
-    <Div className={`min-h-screen ${className}`}>
-      <Div className="py-8 px-4 max-w-screen-xl mx-auto">
-        {/* Header */}
-        <Heading level={1} className="text-2xl font-bold mb-1">
-          {labels.title ?? "My Wishlist"}
-        </Heading>
-        {total > 0 && (
-          <Text variant="secondary" className="mb-4">
-            {labels.subtitle ?? `${total} saved items`}
-          </Text>
-        )}
-
-        {/* Tabs */}
-        {renderTabs?.(activeTab, setActiveTab)}
-
-        {/* Toolbar: search + sort + view toggle */}
-        {activeTab === "products" && (
-          <Row wrap gap="3" className="mb-4">
-            {renderSearch?.(search, setSearch)}
-            {renderSort?.(sort, setSort)}
-            {renderViewToggle?.(viewMode, setViewMode)}
-          </Row>
-        )}
-
-        {/* Bulk actions */}
-        {selectedIds.length > 0 &&
-          renderBulkActions?.(selectedIds, () => setSelectedIds([]))}
-
-        {/* Content */}
-        {activeTab === "products"
-          ? renderProducts(displayedItems, isLoading)
-          : (renderTabPlaceholder?.(activeTab) ?? (
-              <Div className="py-16 text-center">
-                <Text variant="secondary">Coming soon</Text>
-              </Div>
-            ))}
-
-        {/* Pagination */}
-        {renderPagination?.(total)}
-      </Div>
-    </Div>
-  );
-}

package/src/features/wishlist/hooks/useUserWishlist.ts

@@ -1,39 +0,0 @@
-"use client";
-
-import { useQuery } from "@tanstack/react-query";
-import { apiClient } from "../../../http";
-
-export interface UserWishlistItem<TProduct = unknown> {
-  productId: string;
-  addedAt: string;
-  product: TProduct | null;
-}
-
-export interface UserWishlistResponse<TProduct = unknown> {
-  items: UserWishlistItem<TProduct>[];
-  meta: { total: number };
-}
-
-interface UseUserWishlistOptions<TProduct> {
-  enabled?: boolean;
-  endpoint?: string;
-  queryKey?: unknown[];
-  initialData?: UserWishlistResponse<TProduct>;
-}
-
-export function useUserWishlist<TProduct = unknown>(
-  options?: UseUserWishlistOptions<TProduct>,
-) {
-  const endpoint = options?.endpoint ?? "/api/user/wishlist";
-  const query = useQuery<UserWishlistResponse<TProduct>>({
-    queryKey: options?.queryKey ?? ["user", "wishlist"],
-    queryFn: () => apiClient.get<UserWishlistResponse<TProduct>>(endpoint),
-    enabled: options?.enabled ?? true,
-    initialData: options?.initialData,
-  });
-
-  return {
-    ...query,
-    total: query.data?.meta.total ?? 0,
-  };
-}

package/src/features/wishlist/hooks/useWishlist.ts

@@ -1,31 +0,0 @@
-"use client";
-import { useQuery } from "@tanstack/react-query";
-import { apiClient } from "../../../http";
-import type { WishlistResponse } from "../types";
-
-interface UseWishlistOptions {
-  initialData?: WishlistResponse;
-  enabled?: boolean;
-}
-
-export function useWishlist(userId: string, opts?: UseWishlistOptions) {
-  const query = useQuery<WishlistResponse>({
-    queryKey: ["wishlist", userId],
-    queryFn: () =>
-      apiClient.get<WishlistResponse>(`/api/wishlist?userId=${userId}`),
-    initialData: opts?.initialData,
-    enabled: opts?.enabled !== false && !!userId,
-  });
-
-  const ids = new Set((query.data?.items ?? []).map((i) => i.productId));
-
-  return {
-    items: query.data?.items ?? [],
-    total: query.data?.total ?? 0,
-    wishlistedIds: ids,
-    isWishlisted: (productId: string) => ids.has(productId),
-    isLoading: query.isLoading,
-    error: query.error,
-    refetch: query.refetch,
-  };
-}