@mohasinac/appkit 4.53.1 → 4.54.0-next.0

package/scripts/seed-cli.mjs

@@ -387,6 +387,104 @@ const COLLECTION_MAP = {
  * A root with no mapping yields NO franchise (living collectibles are not an
  * IP) — see `FRANCHISE_BY_CATEGORY_ROOT`.
  */
+/**
+ * The real, sellable catalogue — everything else in the product seed is demo
+ * furniture and is DROPPED HERE, before anything is written.
+ *
+ * ── 🛑 WHY A FILTER AND NOT A DELETION ────────────────────────────────────
+ *
+ * The fixtures stay in their files on purpose: they are the only coverage
+ * several features have (every `preOrderProductionStatus` value, a sold-out
+ * reservation, a depleted digital-code pool, an ended-unsold auction), and
+ * the tester checklist deep-links to them by id. Deleting them would silently
+ * remove that coverage. Not LOADING them is the part that was wanted.
+ *
+ * ── 🛑 WHY THIS HAD TO EXIST ──────────────────────────────────────────────
+ *
+ * `appkit-seed load` writes every registered row and `purge` deletes
+ * `seedPurpose: "test"` afterwards — so the demo listings came BACK on every
+ * reseed, and anyone who ran `load` to fix imagery silently republished 76
+ * fake products to the live storefront. That happened twice in one session.
+ * The owner's instruction was "delete them from the seed itself and make sure
+ * they do not return"; this is the point where that can be guaranteed, since
+ * every write path funnels through here.
+ *
+ * ── The discriminator is the STORE, not the listing type ──────────────────
+ *
+ * `store-beyblade-arena` is the fictional demo seller; `store-letitrip-
+ * official` is the real one. Keying on the store rather than on a per-file
+ * allow-list means a fixture added to ANY product seed file later is excluded
+ * automatically, which is the failure mode this is replacing — a list that
+ * has to be remembered is a list that drifts.
+ *
+ * Set `SEED_INCLUDE_DEMO=1` to load them anyway, for local demo work.
+ */
+const REAL_STORE_IDS = new Set(["store-letitrip-official"]);
+
+function realListingsOnly(products) {
+  if (process.env.SEED_INCLUDE_DEMO === "1") {
+    console.log("▌ SEED_INCLUDE_DEMO=1 — demo listings INCLUDED");
+    return products;
+  }
+  /*
+   * 🛑 TWO rules, because the store alone is not enough. Six prize-draw
+   * fixtures live under the REAL store and are still demo furniture — their
+   * imagery is a 460-byte generated colour tile from /images/seed-tiles/,
+   * which is the giveaway: a listing nobody photographed is a listing nobody
+   * intends to sell. Measured before writing this: every one of the six, and
+   * nothing real, matches.
+   */
+  const isPlaceholder = (p) => {
+    const urls = [p?.mainImage, ...(Array.isArray(p?.images) ? p.images : [])]
+      .map((v) => (typeof v === "string" ? v : v?.url))
+      .filter(Boolean);
+    return urls.length > 0 && urls.every((u) => String(u).includes("/images/seed-tiles/"));
+  };
+  const kept = products.filter((p) => REAL_STORE_IDS.has(p?.storeId) && !isPlaceholder(p));
+  const dropped = products.length - kept.length;
+  if (dropped > 0) {
+    console.log(`  • ${dropped} demo listing(s) not loaded (set SEED_INCLUDE_DEMO=1 to include)`);
+  }
+  return kept;
+}
+
+/**
+ * Drop bundle categories whose members are not in the loaded catalogue.
+ *
+ * 🛑 A bundle is ALL-OR-NOTHING — `canAddToCart` buys every member together —
+ * so a bundle missing even one member is unsellable, and one missing ALL of
+ * them is a card that opens an empty page. Measured right after the demo
+ * listings stopped loading: of the five seeded bundles, three had zero
+ * surviving members and the other two had 1-of-4 and 2-of-3. All five were
+ * still `isActive: true`, and all five rendered on the HOMEPAGE as collage
+ * cards built from `display.mosaicImages` — which are baked at seed time from
+ * the members' own imagery, so they kept showing pictures of products that no
+ * longer exist. That is 92 placeholder-tile references on the homepage.
+ *
+ * Derived rather than hand-maintained for the same reason as the product
+ * filter: a bundle that becomes valid later starts loading again on its own,
+ * and one that breaks stops, with nobody having to remember either.
+ *
+ * Only `categoryType: "bundle"` rows are considered. Every other category is
+ * taxonomy and is never touched — rebuilding the tree is expensive and is
+ * explicitly not what this is for.
+ */
+function loadableBundlesOnly(categories, loadedProducts) {
+  const live = new Set(loadedProducts.map((p) => p?.id).filter(Boolean));
+  let dropped = 0;
+  const kept = categories.filter((c) => {
+    if (c?.categoryType !== "bundle") return true;
+    const ids = Array.isArray(c.bundleProductIds) ? c.bundleProductIds : [];
+    const ok = ids.length > 0 && ids.every((id) => live.has(id));
+    if (!ok) dropped++;
+    return ok;
+  });
+  if (dropped > 0) {
+    console.log(`  • ${dropped} bundle(s) not loaded — members missing from the catalogue`);
+  }
+  return kept;
+}
+
 function withFranchise(products) {
   let stamped = 0;
   const out = products.map((p) => {
@@ -469,32 +567,13 @@ function withDerivedCategoryFields(products) {
   return out;
 }
 
-const SEED_DATA_MAP = {
-  users: usersSeedData,
-  /*
-   * store-extensions. COLLECTION_MAP was only HALF the wiring: load() reads
-   * SEED_DATA_MAP and short-circuits on an empty array, so adding the ten
-   * collection names alone produced "no seed data, skipping" for all ten.
-   * Same shape as the art/stickers note further down -- added everywhere
-   * except the map that actually runs.
-   */
-  payoutMethods: payoutMethodsSeedData,
-  shippingConfigs: shippingConfigsSeedData,
-  analyticsCards: analyticsCardsSeedData,
-  analyticsAlerts: analyticsAlertsSeedData,
-  storeCategories: storeCategoriesSeedData,
-  listingTemplates: listingTemplatesSeedData,
-  moderationQueue: moderationQueueSeedData,
-  reports: reportsSeedData,
-  itemRequests: itemRequestsSeedData,
-  storeGoogleConfig: storeGoogleConfigSeedData,
-  addresses: addressesSeedData,
-  storeAddresses: storeAddressesSeedData,
-  // SB-UNI-C: brands were merged into categories (categoryType:"brand") — no
-  // standalone brands collection/seed exists anymore.
-  categories: categoriesSeedData,
-  stores: storesSeedData,
-  products: withFranchise(withDerivedCategoryFields([
+/**
+ * The real catalogue, computed ONCE so the bundle filter and the product
+ * loader cannot disagree about what "loaded" means. Deriving it twice is
+ * Root Cause #75's shape — two copies of one rule, one of which learns about
+ * a change and the other does not.
+ */
+const REAL_PRODUCTS = realListingsOnly([
     ...(productsStandardSeedData || []),
     // Real, wiki-verified Beyblade X listings under store-letitrip-official —
     // added 2026-10-19 for PhonePe merchant registration, which requires at
@@ -536,7 +615,34 @@ const SEED_DATA_MAP = {
      * what should happen to a leaf that now has BOTH a real listing and a
      * generated one.
      */
-  ])),
+  ]);
+
+const SEED_DATA_MAP = {
+  users: usersSeedData,
+  /*
+   * store-extensions. COLLECTION_MAP was only HALF the wiring: load() reads
+   * SEED_DATA_MAP and short-circuits on an empty array, so adding the ten
+   * collection names alone produced "no seed data, skipping" for all ten.
+   * Same shape as the art/stickers note further down -- added everywhere
+   * except the map that actually runs.
+   */
+  payoutMethods: payoutMethodsSeedData,
+  shippingConfigs: shippingConfigsSeedData,
+  analyticsCards: analyticsCardsSeedData,
+  analyticsAlerts: analyticsAlertsSeedData,
+  storeCategories: storeCategoriesSeedData,
+  listingTemplates: listingTemplatesSeedData,
+  moderationQueue: moderationQueueSeedData,
+  reports: reportsSeedData,
+  itemRequests: itemRequestsSeedData,
+  storeGoogleConfig: storeGoogleConfigSeedData,
+  addresses: addressesSeedData,
+  storeAddresses: storeAddressesSeedData,
+  // SB-UNI-C: brands were merged into categories (categoryType:"brand") — no
+  // standalone brands collection/seed exists anymore.
+  categories: loadableBundlesOnly(categoriesSeedData, REAL_PRODUCTS),
+  stores: storesSeedData,
+  products: withFranchise(withDerivedCategoryFields(REAL_PRODUCTS)),
   orders: ordersSeedData,
   reviews: reviewsSeedData,
   bids: bidsSeedData,

package/dist/_internal/server/jobs/core/whatsappCatalogImport.d.ts

@@ -1,27 +0,0 @@
-/**
- * Core: async WhatsApp Business Catalog import (`whatsappCatalogImport` job).
- *
- * `POST /api/store/whatsapp-settings/catalog-import` used to do this inline:
- * one Meta fetch capped at `limit=250`, then a sequential per-item loop doing
- * up to 2 `findBySlug` reads plus 1 `create` write EACH — a real 10s-timeout
- * risk on Vercel Hobby (CLAUDE.md Rule #6) well before the cap was reached.
- * It also declared `paging.next` in its response type and never followed it,
- * so a catalog larger than 250 items silently imported only the first page.
- *
- * Running here instead buys the Function's 300s budget, which is what makes
- * following `paging.next` safe rather than making the timeout worse.
- *
- * Two efficiency changes vs. the old route:
- *  - Existing-slug detection is ONE `findByStore` read into a Set, not 2 reads
- *    per item. A seller's WA catalog is populated by pushing their own store's
- *    products, so store-scoped lookup is equivalent to the old global
- *    `findBySlug` here while costing a single query.
- *  - That Set is updated as we create, so duplicate rows within one Meta
- *    response can't produce two products.
- */
-import type { JobContext } from "../runtime/types";
-import type { JobRunResult } from "./jobRunners";
-export interface WhatsAppCatalogImportPayload {
-    storeSlug: string;
-}
-export declare function runWhatsAppCatalogImport(payload: WhatsAppCatalogImportPayload, ctx: JobContext): Promise<JobRunResult>;

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

@@ -1,172 +0,0 @@
-/**
- * Core: async WhatsApp Business Catalog import (`whatsappCatalogImport` job).
- *
- * `POST /api/store/whatsapp-settings/catalog-import` used to do this inline:
- * one Meta fetch capped at `limit=250`, then a sequential per-item loop doing
- * up to 2 `findBySlug` reads plus 1 `create` write EACH — a real 10s-timeout
- * risk on Vercel Hobby (CLAUDE.md Rule #6) well before the cap was reached.
- * It also declared `paging.next` in its response type and never followed it,
- * so a catalog larger than 250 items silently imported only the first page.
- *
- * Running here instead buys the Function's 300s budget, which is what makes
- * following `paging.next` safe rather than making the timeout worse.
- *
- * Two efficiency changes vs. the old route:
- *  - Existing-slug detection is ONE `findByStore` read into a Set, not 2 reads
- *    per item. A seller's WA catalog is populated by pushing their own store's
- *    products, so store-scoped lookup is equivalent to the old global
- *    `findBySlug` here while costing a single query.
- *  - That Set is updated as we create, so duplicate rows within one Meta
- *    response can't produce two products.
- */
-import { normalizeError } from "../../../../errors/normalize.js";
-import { storeRepository, productRepository } from "../../../../repositories/index.js";
-import { decryptPii } from "../../../../security/index.js";
-const META_GRAPH_BASE = "https://graph.facebook.com/v20.0";
-const SLUG_PREFIX = "product-";
-const PAGE_SIZE = 250;
-/**
- * Defensive stop. 40 pages x 250 = 10,000 items, far beyond any realistic
- * seller catalog — this exists so a malformed/looping `paging.next` from Meta
- * can't spin until the Function's 300s ceiling kills the job mid-write.
- */
-const MAX_PAGES = 40;
-/** Meta returns "<amount> <currency>", e.g. "450.00 INR". */
-function parseMetaPrice(raw) {
-    if (!raw)
-        return 0;
-    const digits = raw.replace(/[^0-9.]/g, "");
-    return Math.round((parseFloat(digits) || 0) * 100) / 100;
-}
-/**
- * The LetItRip slug a Meta item claims to correspond to, if any. Items we
- * pushed carry it in `description` (see catalog-sync's field mapping) and/or
- * `retailer_id`; items authored natively in Meta carry neither.
- */
-function claimedSlug(item) {
-    const description = (item.description ?? "").trim();
-    if (description.startsWith(SLUG_PREFIX))
-        return description;
-    const retailerId = (item.retailer_id ?? "").trim();
-    if (retailerId.startsWith(SLUG_PREFIX))
-        return retailerId;
-    return null;
-}
-export async function runWhatsAppCatalogImport(payload, ctx) {
-    const { storeSlug } = payload;
-    const empty = { total: 0, succeeded: 0, skipped: 0, failed: 0 };
-    const store = await storeRepository.findBySlug(storeSlug);
-    if (!store) {
-        return {
-            summary: empty,
-            succeeded: [],
-            skipped: [],
-            failed: [{ id: storeSlug, reason: "Store not found" }],
-        };
-    }
-    const cfg = store.whatsappConfig;
-    const token = cfg?.accessToken ? decryptPii(cfg.accessToken) : null;
-    // Re-checked here even though the route gates on the same conditions — the
-    // job doc outlives the request, and the seller could disconnect in between.
-    if (!cfg?.connected || !cfg.catalogId || !token) {
-        return {
-            summary: empty,
-            succeeded: [],
-            skipped: [],
-            failed: [{ id: storeSlug, reason: "WhatsApp is not connected for this store" }],
-        };
-    }
-    const existing = await productRepository.findByStore(store.storeSlug);
-    const knownSlugs = new Set(existing.map((p) => p.slug).filter((s) => Boolean(s)));
-    const imported = [];
-    const skipped = [];
-    const failed = [];
-    let url = `${META_GRAPH_BASE}/${cfg.catalogId}/products` +
-        `?fields=name,price,currency,image_url,description,retailer_id&limit=${PAGE_SIZE}`;
-    let page = 0;
-    let truncated = false;
-    while (url) {
-        if (page >= MAX_PAGES) {
-            truncated = true;
-            ctx.logger.warn("whatsappCatalogImport: page cap reached — catalog truncated", {
-                storeSlug,
-                maxPages: MAX_PAGES,
-                importedSoFar: imported.length,
-            });
-            break;
-        }
-        page++;
-        const res = await fetch(url, { headers: { Authorization: `Bearer ${token}` } });
-        if (!res.ok) {
-            const body = (await res.json().catch(() => ({})));
-            const reason = body.error?.message ?? res.statusText;
-            ctx.logger.error("whatsappCatalogImport: Meta fetch failed", null, { storeSlug, page, reason });
-            failed.push({ id: `page-${page}`, reason: `Meta fetch failed: ${reason}` });
-            break;
-        }
-        const body = (await res.json());
-        const items = body.data ?? [];
-        for (const item of items) {
-            const slug = claimedSlug(item);
-            if (slug && knownSlugs.has(slug)) {
-                skipped.push(item.id);
-                continue;
-            }
-            const input = {
-                title: item.name ?? `WhatsApp Import ${item.id}`,
-                description: "",
-                slug: "",
-                listingType: "standard",
-                status: "draft",
-                price: parseMetaPrice(item.price),
-                currency: "INR",
-                mainImage: item.image_url ?? "",
-                images: [],
-                stockQuantity: 1,
-                condition: "new",
-                storeId: store.id,
-                storeName: store.storeName,
-                tags: ["whatsapp-import"],
-                categorySlugs: [],
-                featured: false,
-            };
-            try {
-                const created = await productRepository.create(input);
-                // Guard against the same item appearing twice in one Meta response.
-                if (slug)
-                    knownSlugs.add(slug);
-                if (created.slug)
-                    knownSlugs.add(created.slug);
-                imported.push(created.id);
-            }
-            catch (err) {
-                void normalizeError(err);
-                failed.push({
-                    id: item.id,
-                    reason: err instanceof Error ? err.message : "Product create failed",
-                });
-            }
-        }
-        url = body.paging?.next;
-    }
-    ctx.logger.info("whatsappCatalogImport: complete", {
-        storeSlug,
-        pages: page,
-        imported: imported.length,
-        skipped: skipped.length,
-        failed: failed.length,
-        truncated,
-    });
-    return {
-        summary: {
-            total: imported.length + skipped.length + failed.length,
-            succeeded: imported.length,
-            skipped: skipped.length,
-            failed: failed.length,
-        },
-        succeeded: imported,
-        skipped,
-        failed,
-        data: { imported: imported.length, skipped: skipped.length, pages: page, truncated },
-    };
-}

package/dist/_internal/server/jobs/core/whatsappNotify.d.ts

@@ -1,35 +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 type { JobContext } from "../runtime/types";
-import type { JobRunResult } from "./jobRunners";
-export interface WhatsAppNotifyPayload {
-    toPhone: string;
-    title: string;
-    message: string;
-    type: string;
-    /** Approved Meta template name for this notification type, if configured. */
-    templateName?: string;
-    /** BCP-47 language code the template was approved in. Defaults to "en". */
-    templateLanguage?: string;
-    notificationId: string;
-    phoneNumberId: string;
-    accessToken: string;
-}
-export declare function runWhatsAppNotify(payload: WhatsAppNotifyPayload, ctx: JobContext): Promise<JobRunResult>;

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;