@mohasinac/appkit 4.1.1 → 4.2.0

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

@@ -3,9 +3,11 @@ import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-run
 import { SIEVE_OP, Stack, sieveFilter } from "@mohasinac/appkit";
 import { sortBy } from "@mohasinac/appkit";
 import React, { useState } from "react";
+import { useRouter } from "next/navigation";
 import { FilterChipGroup, ListingLayout, RowActionMenu, Span, Text } from "../../../ui";
 import { ADMIN_ENDPOINTS } from "../../../constants/api-endpoints";
 import { ROW_ACTION_META, ROW_ACTION_ID } from "../../../features/products/constants/action-defs";
+import { ROUTES } from "../../../next/routing/route-map";
 import { ADMIN_SUPPORT_TICKET_STATUS_TABS, ADMIN_SUPPORT_TICKET_PRIORITY_TABS, } from "../constants/filter-tabs";
 import { toRecordArray, toRelativeDate, toStringValue, } from "../hooks/useAdminListingData";
 import { DataListingView } from "./DataListingView";
@@ -46,6 +48,7 @@ const TICKET_COLUMNS = [
     },
 ];
 export function AdminSupportTicketsView({ children, ...props }) {
+    const router = useRouter();
     const [drawerOpen, setDrawerOpen] = useState(false);
     const [selectedRow, setSelectedRow] = useState(null);
     if (React.Children.count(children) > 0) {
@@ -56,7 +59,7 @@ export function AdminSupportTicketsView({ children, ...props }) {
         title: "Support Tickets",
         searchPlaceholder: "Search by subject",
         emptyLabel: "No support tickets found",
-        filterKeys: ["status", "priority"],
+        filterKeys: ["status", "priority", "showResolved"],
         defaultSort: sortBy("createdAt", "DESC"),
         queryKey: ["admin", "support-tickets", "listing"],
         endpoint: ADMIN_ENDPOINTS.SUPPORT_TICKETS,
@@ -91,8 +94,19 @@ export function AdminSupportTicketsView({ children, ...props }) {
         },
         buildFilters: (f) => {
             const parts = [];
-            if (f.status && f.status !== "All")
+            if (f.status && f.status !== "All") {
                 parts.push(sieveFilter("status", SIEVE_OP.EQ, f.status));
+            }
+            else if (f.showResolved !== "true") {
+                // Hide resolved and closed tickets by default (open-only quick
+                // view). Pipe-joined EQ, not NEQ: sievejs parses a same-field pipe
+                // as an OR group, upgraded by the Firestore adapter to an IN query.
+                // Unlike NEQ, IN has no orderBy-must-match-filtered-field
+                // restriction, so this stays compatible with the default createdAt
+                // sort. See sieve.ts for the documented Sieve/Firestore
+                // incompatibility this avoids.
+                parts.push(sieveFilter("status", SIEVE_OP.EQ, "open|in_progress|waiting_on_user"));
+            }
             if (f.priority && f.priority !== "All")
                 parts.push(sieveFilter("priority", SIEVE_OP.EQ, f.priority));
             return parts.join(",") || undefined;
@@ -105,6 +119,10 @@ export function AdminSupportTicketsView({ children, ...props }) {
                         setDrawerOpen(true);
                     },
                 },
+                {
+                    label: "Open full page",
+                    onClick: () => router.push(String(ROUTES.ADMIN.SUPPORT_TICKET_BY_ID(row.id))),
+                },
             ] })),
         renderFilterPanel: ({ pendingFilters, setPendingFilters }) => (_jsxs(_Fragment, { children: [_jsx(FilterChipGroup, { label: "Status", tabs: ADMIN_SUPPORT_TICKET_STATUS_TABS, value: pendingFilters.status ?? "", onChange: (id) => setPendingFilters((p) => ({ ...p, status: id })) }), _jsx(FilterChipGroup, { label: "Priority", tabs: ADMIN_SUPPORT_TICKET_PRIORITY_TABS, value: pendingFilters.priority ?? "", onChange: (id) => setPendingFilters((p) => ({ ...p, priority: id })) })] })),
     };

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

@@ -39,6 +39,7 @@ export function AdminTesterChecklistItemEditorView({ itemId, onSaved, onDeleted,
     const [description, setDescription] = React.useState("");
     const [href, setHref] = React.useState("");
     const [order, setOrder] = React.useState(0);
+    const [phase, setPhase] = React.useState(1);
     const [isActive, setIsActive] = React.useState(true);
     const [adminOnly, setAdminOnly] = React.useState(false);
     const [deleteConfirmOpen, setDeleteConfirmOpen] = React.useState(false);
@@ -63,6 +64,7 @@ export function AdminTesterChecklistItemEditorView({ itemId, onSaved, onDeleted,
         setDescription(item.description ?? "");
         setHref(item.href ?? "");
         setOrder(typeof item.order === "number" ? item.order : 0);
+        setPhase(typeof item.phase === "number" ? item.phase : 1);
         setIsActive(item.isActive ?? true);
         setAdminOnly(item.adminOnly ?? false);
     }, [itemQuery.data]);
@@ -87,6 +89,7 @@ export function AdminTesterChecklistItemEditorView({ itemId, onSaved, onDeleted,
                 description: description || "",
                 href: href || "",
                 order,
+                phase,
                 isActive,
                 adminOnly,
             };
@@ -116,7 +119,7 @@ export function AdminTesterChecklistItemEditorView({ itemId, onSaved, onDeleted,
     });
     const isSubmitting = saveMutation.isPending || itemQuery.isLoading;
     const canSave = Boolean(groupLabel.trim()) && Boolean(pageLabel.trim()) && Boolean(label.trim());
-    const formSection = (_jsxs(_Fragment, { children: [_jsx(Form, { schema: checklistItemFormSchema, onSubmit: (e) => e.preventDefault(), spacing: "md", children: ({ setFieldError, clearErrors }) => (_jsxs(_Fragment, { children: [_jsxs(Div, { layout: "grid", gap: "4", className: "grid-cols-2", children: [_jsx(FieldInput, { name: "groupLabel", label: "Group", value: groupLabel, onChange: handleGroupLabelChange, required: true, placeholder: "e.g. Buying", hint: "Top-level accordion section on the Tester Hub." }), _jsx(Input, { label: "Group key", value: groupKey, onChange: (e) => setGroupKey(e.target.value), placeholder: "buying", helperText: "Auto-generated from the group name." })] }), _jsxs(Div, { layout: "grid", gap: "4", className: "grid-cols-2", children: [_jsx(FieldInput, { name: "pageLabel", label: "Page", value: pageLabel, onChange: handlePageLabelChange, required: true, placeholder: "e.g. Checkout", hint: "Sub-accordion within the group." }), _jsx(Input, { label: "Page key", value: pageKey, onChange: (e) => setPageKey(e.target.value), placeholder: "checkout", helperText: "Auto-generated from the page name." })] }), _jsx(FieldInput, { name: "label", label: "Test case (Yes/No question)", value: label, onChange: setLabel, required: true, placeholder: "e.g. Coupon discount is correctly reflected in the order total" }), _jsx(FieldTextarea, { name: "description", label: "Description (optional)", value: description, onChange: setDescription, placeholder: "Extra context for the tester." }), _jsx(FieldInput, { name: "href", label: "Deep link (optional)", value: href, onChange: setHref, placeholder: "/cart", hint: "Jumps the tester straight to the feature being tested." }), _jsx(Input, { label: "Display order", value: String(order), onChange: (e) => setOrder(parseInt(e.target.value, 10) || 0), type: "number", min: 0, helperText: "Lower = shown first within the page." }), _jsxs(Stack, { className: `${__P.p4}`, gap: "3", rounded: "lg", border: "default", children: [_jsx(Text, { size: "sm", weight: "medium", color: "muted", children: "Visibility" }), _jsx(Toggle, { label: "Active (visible to testers)", checked: isActive, onChange: setIsActive }), _jsx(Toggle, { label: "Admin-only (requires canTestAdmin)", checked: adminOnly, onChange: setAdminOnly })] }), _jsxs(Row, { gap: "3", padding: "t-xs", children: [_jsx(Button, { type: "submit", isLoading: isSubmitting, disabled: !canSave || isSubmitting, onClick: () => {
+    const formSection = (_jsxs(_Fragment, { children: [_jsx(Form, { schema: checklistItemFormSchema, onSubmit: (e) => e.preventDefault(), spacing: "md", children: ({ setFieldError, clearErrors }) => (_jsxs(_Fragment, { children: [_jsxs(Div, { layout: "grid", gap: "4", className: "grid-cols-2", children: [_jsx(FieldInput, { name: "groupLabel", label: "Group", value: groupLabel, onChange: handleGroupLabelChange, required: true, placeholder: "e.g. Buying", hint: "Top-level accordion section on the Tester Hub." }), _jsx(Input, { label: "Group key", value: groupKey, onChange: (e) => setGroupKey(e.target.value), placeholder: "buying", helperText: "Auto-generated from the group name." })] }), _jsxs(Div, { layout: "grid", gap: "4", className: "grid-cols-2", children: [_jsx(FieldInput, { name: "pageLabel", label: "Page", value: pageLabel, onChange: handlePageLabelChange, required: true, placeholder: "e.g. Checkout", hint: "Sub-accordion within the group." }), _jsx(Input, { label: "Page key", value: pageKey, onChange: (e) => setPageKey(e.target.value), placeholder: "checkout", helperText: "Auto-generated from the page name." })] }), _jsx(FieldInput, { name: "label", label: "Test case (Yes/No question)", value: label, onChange: setLabel, required: true, placeholder: "e.g. Coupon discount is correctly reflected in the order total" }), _jsx(FieldTextarea, { name: "description", label: "Description (optional)", value: description, onChange: setDescription, placeholder: "Extra context for the tester." }), _jsx(FieldInput, { name: "href", label: "Deep link (optional)", value: href, onChange: setHref, placeholder: "/cart", hint: "Jumps the tester straight to the feature being tested." }), _jsxs(Div, { layout: "grid", gap: "4", className: "grid-cols-2", children: [_jsx(Input, { label: "Display order", value: String(order), onChange: (e) => setOrder(parseInt(e.target.value, 10) || 0), type: "number", min: 0, helperText: "Lower = shown first within the page." }), _jsx(Input, { label: "Phase", value: String(phase), onChange: (e) => setPhase(Math.max(1, parseInt(e.target.value, 10) || 1)), type: "number", min: 1, helperText: "Test batch this case belongs to \u2014 testers work through one phase at a time." })] }), _jsxs(Stack, { className: `${__P.p4}`, gap: "3", rounded: "lg", border: "default", children: [_jsx(Text, { size: "sm", weight: "medium", color: "muted", children: "Visibility" }), _jsx(Toggle, { label: "Active (visible to testers)", checked: isActive, onChange: setIsActive }), _jsx(Toggle, { label: "Admin-only (requires canTestAdmin)", checked: adminOnly, onChange: setAdminOnly })] }), _jsxs(Row, { gap: "3", padding: "t-xs", children: [_jsx(Button, { type: "submit", isLoading: isSubmitting, disabled: !canSave || isSubmitting, onClick: () => {
                                         clearErrors();
                                         if (!label.trim()) {
                                             setFieldError("label", "Test case label is required");

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

@@ -16,6 +16,12 @@ const COLUMNS = [
         sortable: true,
         render: (row) => (_jsxs(Stack, { gap: "xs", children: [_jsx(Text, { weight: "semibold", color: "primary", children: row.primary }), _jsx(Text, { size: "xs", color: "muted", children: row.secondary })] })),
     },
+    {
+        key: "phase",
+        header: "Phase",
+        className: "w-20",
+        render: (row) => _jsx(Text, { size: "sm", color: "muted", children: row.phase }),
+    },
     {
         key: "status",
         header: "Status",
@@ -41,6 +47,7 @@ export function AdminTesterChecklistView({ children, onBulkDelete, ...props }) {
         endpoint: ADMIN_ENDPOINTS.TESTER_CHECKLIST_ITEMS,
         sortOptions: [
             { value: "order", label: "Order" },
+            { value: "phase", label: "Phase" },
             { value: sortBy("createdAt", "DESC"), label: "Newest" },
             { value: "label", label: "Test case A–Z" },
         ],
@@ -49,6 +56,7 @@ export function AdminTesterChecklistView({ children, onBulkDelete, ...props }) {
             id: toStringValue(item.id, `checklist-${index}`),
             primary: toStringValue(item.label, "Untitled test case"),
             secondary: `${toStringValue(item.groupLabel, "Uncategorized")} / ${toStringValue(item.pageLabel, "")}`,
+            phase: typeof item.phase === "number" ? item.phase : 1,
             status: toStringValue(typeof item.isActive === "boolean"
                 ? item.isActive
                     ? "Active"

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

@@ -46,6 +46,8 @@ export { AdminStickersView } from "./AdminStickersView";
 export type { AdminStickersViewProps } from "./AdminStickersView";
 export { AdminGroupedListingsView } from "./AdminGroupedListingsView";
 export type { AdminGroupedListingsViewProps } from "./AdminGroupedListingsView";
+export { AdminCarouselGroupEditorView } from "./AdminCarouselGroupEditorView";
+export type { AdminCarouselGroupEditorViewProps } from "./AdminCarouselGroupEditorView";
 export { AdminBundlesView } from "./AdminBundlesView";
 export type { AdminBundlesViewProps } from "./AdminBundlesView";
 export { AdminBundleEditorView } from "./AdminBundleEditorView";

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

@@ -26,6 +26,7 @@ export { AdminLiveView } from "./AdminLiveView";
 export { AdminArtView } from "./AdminArtView";
 export { AdminStickersView } from "./AdminStickersView";
 export { AdminGroupedListingsView } from "./AdminGroupedListingsView";
+export { AdminCarouselGroupEditorView } from "./AdminCarouselGroupEditorView";
 // S-SBUNI-4 2026-05-13 — admin bundle CRUD views.
 export { AdminBundlesView } from "./AdminBundlesView";
 export { AdminBundleEditorView } from "./AdminBundleEditorView";

package/dist/features/admin/constants/filter-tabs.d.ts

@@ -19,12 +19,14 @@ export declare const ALL_TAB: {
     readonly id: "All";
     readonly label: "All";
 };
-/** Admin > Products — listing status filter chip set. */
+/** Admin > Products — listing status filter chip set. Real `ProductStatus`
+ *  is draft|published|in_review|archived — "pending" fixed to "in_review"
+ *  (its real meaning); the previous id never matched any document. */
 export declare const ADMIN_PRODUCT_STATUS_TABS: readonly [{
     readonly id: "All";
     readonly label: "All";
 }, {
-    readonly id: "pending";
+    readonly id: "in_review";
     readonly label: "Pending";
 }, {
     readonly id: "published";
@@ -264,13 +266,15 @@ export declare const ADMIN_EVENT_ENTRY_STATUS_TABS: readonly [{
     readonly id: "CANCELLED";
     readonly label: "Cancelled";
 }];
-/** Admin > Events — event-state filter chip set. */
+/** Admin > Events — event-state filter chip set. Real `EventStatus` is
+ *  draft|active|paused|ended|cancelled — there is no "published" value
+ *  (field-names.ts's copy of this enum is stale; verified against the
+ *  feature's own events/types/index.ts). A "Published" chip previously
+ *  returned zero rows every time — removed rather than aliased since
+ *  "Active" already covers the intended meaning. */
 export declare const ADMIN_EVENT_STATUS_TABS: readonly [{
     readonly id: "All";
     readonly label: "All";
-}, {
-    readonly id: "published";
-    readonly label: "Published";
 }, {
     readonly id: "draft";
     readonly label: "Draft";
@@ -371,12 +375,18 @@ export declare const EMPTY_TAB: {
     readonly id: "";
     readonly label: "All";
 };
-/** Seller > Products — listing-state filter chip set. */
+/** Seller > Products — listing-state filter chip set. Real `ProductStatus`
+ *  is draft|published|in_review|archived — there is no "active" or "sold"
+ *  value on the `status` field. "Active" was fixed to "published" (its real
+ *  meaning); "Sold" was removed since sold-filtering already has its own
+ *  correct, working mechanism (the `isSold`-driven "Show sold" toolbar
+ *  toggle in SellerProductsView.tsx) — the status chip duplicated it with
+ *  a broken `status=="sold"` query that always returned zero rows. */
 export declare const SELLER_PRODUCT_STATUS_TABS: readonly [{
     readonly id: "All";
     readonly label: "All";
 }, {
-    readonly id: "active";
+    readonly id: "published";
     readonly label: "Active";
 }, {
     readonly id: "draft";
@@ -384,33 +394,36 @@ export declare const SELLER_PRODUCT_STATUS_TABS: readonly [{
 }, {
     readonly id: "archived";
     readonly label: "Archived";
-}, {
-    readonly id: "sold";
-    readonly label: "Sold";
 }];
-/** Seller > Auctions — auction-state filter chip set. */
+/** Seller > Auctions — auction-state filter chip set. Real `ProductStatus`
+ *  has no "active"/"ended"/"cancelled" values. "Active" fixed to
+ *  "published". "Ended" and "Cancelled" removed — "ended" is a derived
+ *  state (auctionEndDate vs now), not a stored status, and is now handled
+ *  by SellerAuctionsView's "Show ended" toolbar toggle; there is no stored
+ *  "cancelled" state for auctions at all (an auction that expires with no
+ *  bids becomes `archived`, indistinguishable in storage from a listing the
+ *  seller archived for any other reason — aliasing "Cancelled" to
+ *  `status==archived` would be misleading, so it's dropped rather than
+ *  reintroduced under a wrong mapping). */
 export declare const SELLER_AUCTION_STATUS_TABS: readonly [{
     readonly id: "All";
     readonly label: "All";
 }, {
-    readonly id: "active";
+    readonly id: "published";
     readonly label: "Active";
 }, {
     readonly id: "draft";
     readonly label: "Draft";
-}, {
-    readonly id: "ended";
-    readonly label: "Ended";
-}, {
-    readonly id: "cancelled";
-    readonly label: "Cancelled";
 }];
-/** Seller > Pre-orders — pre-order-state filter chip set. */
+/** Seller > Pre-orders — pre-order-state filter chip set. Same root cause
+ *  and fix as SELLER_AUCTION_STATUS_TABS above — no "active"/"cancelled"
+ *  status values exist; pre-order cancellation, if tracked, lives in the
+ *  separate `preOrderProductionStatus` field, not `status`. */
 export declare const SELLER_PRE_ORDER_STATUS_TABS: readonly [{
     readonly id: "All";
     readonly label: "All";
 }, {
-    readonly id: "active";
+    readonly id: "published";
     readonly label: "Active";
 }, {
     readonly id: "draft";
@@ -418,53 +431,54 @@ export declare const SELLER_PRE_ORDER_STATUS_TABS: readonly [{
 }, {
     readonly id: "archived";
     readonly label: "Archived";
-}, {
-    readonly id: "cancelled";
-    readonly label: "Cancelled";
 }];
-/** Seller > Prize Draws — draw-state filter chip set. */
+/** Seller > Prize Draws — draw-state filter chip set. Same root cause and
+ *  fix as SELLER_AUCTION_STATUS_TABS — "ended" is derived from
+ *  `prizeRevealWindowEnd` vs now (handled by the "Show closed" toolbar
+ *  toggle), no stored "cancelled" state exists. */
 export declare const SELLER_PRIZE_DRAW_STATUS_TABS: readonly [{
     readonly id: "All";
     readonly label: "All";
 }, {
-    readonly id: "active";
+    readonly id: "published";
     readonly label: "Active";
 }, {
     readonly id: "draft";
     readonly label: "Draft";
-}, {
-    readonly id: "ended";
-    readonly label: "Ended";
-}, {
-    readonly id: "cancelled";
-    readonly label: "Cancelled";
 }];
 /** Seller > Orders — order-state filter chip set. Subset of
  *  `ADMIN_ORDER_STATUS_TABS` — sellers don't see `RETURN_REQUESTED` until
- *  the buyer initiates one through support. */
+ *  the buyer initiates one through support. IDs are lowercase to match the
+ *  real stored `OrderStatusValues` (Firestore `==` is byte-exact — the
+ *  previous uppercase ids never matched any document, every chip here
+ *  silently returned zero rows). */
 export declare const SELLER_ORDER_STATUS_TABS: readonly [{
     readonly id: "All";
     readonly label: "All";
 }, {
-    readonly id: "PENDING";
+    readonly id: "pending";
     readonly label: "Pending";
 }, {
-    readonly id: "PROCESSING";
+    readonly id: "processing";
     readonly label: "Processing";
 }, {
-    readonly id: "SHIPPED";
+    readonly id: "shipped";
     readonly label: "Shipped";
 }, {
-    readonly id: "DELIVERED";
+    readonly id: "delivered";
     readonly label: "Delivered";
 }, {
-    readonly id: "CANCELLED";
+    readonly id: "cancelled";
     readonly label: "Cancelled";
 }, {
-    readonly id: "REFUNDED";
+    readonly id: "refunded";
     readonly label: "Refunded";
 }];
-/** Seller > Offers — offer-state filter chip set. */
+/** Seller > Offers — offer-state filter chip set. Real `OfferStatus` is
+ *  pending|accepted|declined|countered|expired|withdrawn|paid — there is no
+ *  "rejected" value, the real one is "declined" (the id below was fixed;
+ *  the previous "rejected" id always returned zero rows). Label kept as
+ *  "Rejected" for continuity with existing seller-facing wording. */
 export declare const SELLER_OFFER_STATUS_TABS: readonly [{
     readonly id: "All";
     readonly label: "All";
@@ -475,7 +489,7 @@ export declare const SELLER_OFFER_STATUS_TABS: readonly [{
     readonly id: "accepted";
     readonly label: "Accepted";
 }, {
-    readonly id: "rejected";
+    readonly id: "declined";
     readonly label: "Rejected";
 }, {
     readonly id: "expired";

package/dist/features/admin/constants/filter-tabs.js

@@ -10,10 +10,12 @@
  * primitive and stay in sync when statuses are added.
  */
 export const ALL_TAB = { id: "All", label: "All" };
-/** Admin > Products — listing status filter chip set. */
+/** Admin > Products — listing status filter chip set. Real `ProductStatus`
+ *  is draft|published|in_review|archived — "pending" fixed to "in_review"
+ *  (its real meaning); the previous id never matched any document. */
 export const ADMIN_PRODUCT_STATUS_TABS = [
     ALL_TAB,
-    { id: "pending", label: "Pending" },
+    { id: "in_review", label: "Pending" },
     { id: "published", label: "Published" },
     { id: "draft", label: "Draft" },
     { id: "archived", label: "Archived" },
@@ -129,10 +131,14 @@ export const ADMIN_EVENT_ENTRY_STATUS_TABS = [
     { id: "WAITLISTED", label: "Waitlisted" },
     { id: "CANCELLED", label: "Cancelled" },
 ];
-/** Admin > Events — event-state filter chip set. */
+/** Admin > Events — event-state filter chip set. Real `EventStatus` is
+ *  draft|active|paused|ended|cancelled — there is no "published" value
+ *  (field-names.ts's copy of this enum is stale; verified against the
+ *  feature's own events/types/index.ts). A "Published" chip previously
+ *  returned zero rows every time — removed rather than aliased since
+ *  "Active" already covers the intended meaning. */
 export const ADMIN_EVENT_STATUS_TABS = [
     ALL_TAB,
-    { id: "published", label: "Published" },
     { id: "draft", label: "Draft" },
     { id: "active", label: "Active" },
     { id: "ended", label: "Ended" },
@@ -184,56 +190,78 @@ export const ADMIN_COUPON_TYPE_TABS = [
  *  filter URL with `""` instead of `"All"` so the `"" == no filter` invariant
  *  stays a single shape across queries. */
 export const EMPTY_TAB = { id: "", label: "All" };
-/** Seller > Products — listing-state filter chip set. */
+/** Seller > Products — listing-state filter chip set. Real `ProductStatus`
+ *  is draft|published|in_review|archived — there is no "active" or "sold"
+ *  value on the `status` field. "Active" was fixed to "published" (its real
+ *  meaning); "Sold" was removed since sold-filtering already has its own
+ *  correct, working mechanism (the `isSold`-driven "Show sold" toolbar
+ *  toggle in SellerProductsView.tsx) — the status chip duplicated it with
+ *  a broken `status=="sold"` query that always returned zero rows. */
 export const SELLER_PRODUCT_STATUS_TABS = [
     ALL_TAB,
-    { id: "active", label: "Active" },
+    { id: "published", label: "Active" },
     { id: "draft", label: "Draft" },
     { id: "archived", label: "Archived" },
-    { id: "sold", label: "Sold" },
 ];
-/** Seller > Auctions — auction-state filter chip set. */
+/** Seller > Auctions — auction-state filter chip set. Real `ProductStatus`
+ *  has no "active"/"ended"/"cancelled" values. "Active" fixed to
+ *  "published". "Ended" and "Cancelled" removed — "ended" is a derived
+ *  state (auctionEndDate vs now), not a stored status, and is now handled
+ *  by SellerAuctionsView's "Show ended" toolbar toggle; there is no stored
+ *  "cancelled" state for auctions at all (an auction that expires with no
+ *  bids becomes `archived`, indistinguishable in storage from a listing the
+ *  seller archived for any other reason — aliasing "Cancelled" to
+ *  `status==archived` would be misleading, so it's dropped rather than
+ *  reintroduced under a wrong mapping). */
 export const SELLER_AUCTION_STATUS_TABS = [
     ALL_TAB,
-    { id: "active", label: "Active" },
+    { id: "published", label: "Active" },
     { id: "draft", label: "Draft" },
-    { id: "ended", label: "Ended" },
-    { id: "cancelled", label: "Cancelled" },
 ];
-/** Seller > Pre-orders — pre-order-state filter chip set. */
+/** Seller > Pre-orders — pre-order-state filter chip set. Same root cause
+ *  and fix as SELLER_AUCTION_STATUS_TABS above — no "active"/"cancelled"
+ *  status values exist; pre-order cancellation, if tracked, lives in the
+ *  separate `preOrderProductionStatus` field, not `status`. */
 export const SELLER_PRE_ORDER_STATUS_TABS = [
     ALL_TAB,
-    { id: "active", label: "Active" },
+    { id: "published", label: "Active" },
     { id: "draft", label: "Draft" },
     { id: "archived", label: "Archived" },
-    { id: "cancelled", label: "Cancelled" },
 ];
-/** Seller > Prize Draws — draw-state filter chip set. */
+/** Seller > Prize Draws — draw-state filter chip set. Same root cause and
+ *  fix as SELLER_AUCTION_STATUS_TABS — "ended" is derived from
+ *  `prizeRevealWindowEnd` vs now (handled by the "Show closed" toolbar
+ *  toggle), no stored "cancelled" state exists. */
 export const SELLER_PRIZE_DRAW_STATUS_TABS = [
     ALL_TAB,
-    { id: "active", label: "Active" },
+    { id: "published", label: "Active" },
     { id: "draft", label: "Draft" },
-    { id: "ended", label: "Ended" },
-    { id: "cancelled", label: "Cancelled" },
 ];
 /** Seller > Orders — order-state filter chip set. Subset of
  *  `ADMIN_ORDER_STATUS_TABS` — sellers don't see `RETURN_REQUESTED` until
- *  the buyer initiates one through support. */
+ *  the buyer initiates one through support. IDs are lowercase to match the
+ *  real stored `OrderStatusValues` (Firestore `==` is byte-exact — the
+ *  previous uppercase ids never matched any document, every chip here
+ *  silently returned zero rows). */
 export const SELLER_ORDER_STATUS_TABS = [
     ALL_TAB,
-    { id: "PENDING", label: "Pending" },
-    { id: "PROCESSING", label: "Processing" },
-    { id: "SHIPPED", label: "Shipped" },
-    { id: "DELIVERED", label: "Delivered" },
-    { id: "CANCELLED", label: "Cancelled" },
-    { id: "REFUNDED", label: "Refunded" },
+    { id: "pending", label: "Pending" },
+    { id: "processing", label: "Processing" },
+    { id: "shipped", label: "Shipped" },
+    { id: "delivered", label: "Delivered" },
+    { id: "cancelled", label: "Cancelled" },
+    { id: "refunded", label: "Refunded" },
 ];
-/** Seller > Offers — offer-state filter chip set. */
+/** Seller > Offers — offer-state filter chip set. Real `OfferStatus` is
+ *  pending|accepted|declined|countered|expired|withdrawn|paid — there is no
+ *  "rejected" value, the real one is "declined" (the id below was fixed;
+ *  the previous "rejected" id always returned zero rows). Label kept as
+ *  "Rejected" for continuity with existing seller-facing wording. */
 export const SELLER_OFFER_STATUS_TABS = [
     ALL_TAB,
     { id: "pending", label: "Pending" },
     { id: "accepted", label: "Accepted" },
-    { id: "rejected", label: "Rejected" },
+    { id: "declined", label: "Rejected" },
     { id: "expired", label: "Expired" },
 ];
 /** Seller > Bids — bid-state filter chip set. Uses the empty-sentinel

package/dist/features/admin/repository/analytics-rollup.repository.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Analytics Rollup Repository
+ *
+ * Singleton `analytics/dashboardRollup` doc — a pre-computed aggregate that
+ * replaces an unbounded `orderRepository.findByStatus("delivered")` scan on
+ * every admin dashboard page load. Written daily by the `revenueRollup`
+ * scheduled Firebase Function (`appkit/src/_internal/server/jobs/core/revenueRollup.ts`),
+ * read by `GET /api/admin/dashboard`.
+ */
+import { BaseRepository } from "../../../providers/db-firebase";
+export interface AnalyticsRollupDocument {
+    id: string;
+    totalRevenue: number;
+    deliveredOrderCount: number;
+    computedAt: Date;
+}
+export declare class AnalyticsRollupRepository extends BaseRepository<AnalyticsRollupDocument> {
+    constructor();
+    getDashboardRollup(): Promise<AnalyticsRollupDocument | null>;
+    setDashboardRollup(data: {
+        totalRevenue: number;
+        deliveredOrderCount: number;
+    }): Promise<void>;
+}
+export declare const analyticsRollupRepository: AnalyticsRollupRepository;

package/dist/features/admin/repository/analytics-rollup.repository.js

@@ -0,0 +1,31 @@
+/**
+ * Analytics Rollup Repository
+ *
+ * Singleton `analytics/dashboardRollup` doc — a pre-computed aggregate that
+ * replaces an unbounded `orderRepository.findByStatus("delivered")` scan on
+ * every admin dashboard page load. Written daily by the `revenueRollup`
+ * scheduled Firebase Function (`appkit/src/_internal/server/jobs/core/revenueRollup.ts`),
+ * read by `GET /api/admin/dashboard`.
+ */
+import { BaseRepository } from "../../../providers/db-firebase";
+const ANALYTICS_COLLECTION = "analytics";
+const DASHBOARD_ROLLUP_ID = "dashboardRollup";
+export class AnalyticsRollupRepository extends BaseRepository {
+    constructor() {
+        super(ANALYTICS_COLLECTION);
+    }
+    async getDashboardRollup() {
+        return this.findById(DASHBOARD_ROLLUP_ID);
+    }
+    async setDashboardRollup(data) {
+        const existing = await this.findById(DASHBOARD_ROLLUP_ID);
+        const payload = { ...data, computedAt: new Date() };
+        if (existing) {
+            await this.update(DASHBOARD_ROLLUP_ID, payload);
+        }
+        else {
+            await this.createWithId(DASHBOARD_ROLLUP_ID, payload);
+        }
+    }
+}
+export const analyticsRollupRepository = new AnalyticsRollupRepository();

package/dist/features/admin/repository/site-settings.repository.js

@@ -72,9 +72,16 @@ export class SiteSettingsRepository extends BaseRepository {
     mergeEncryptedCredentials(existing, updates) {
         const encrypted = { ...existing };
         for (const [key, value] of Object.entries(updates)) {
-            if (value && value.trim()) {
+            if (typeof value === "string" && value.trim()) {
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
                 encrypted[key] = encryptSecret(value.trim());
             }
+            else if (value !== undefined && typeof value !== "string") {
+                // Non-string credential fields (e.g. whatsappTemplates: Record<string,string>)
+                // are stored as-is — they are not secret values to encrypt.
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                encrypted[key] = value;
+            }
             // Empty / undefined → keep whatever was already stored
         }
         return encrypted;

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

@@ -2,6 +2,7 @@
  * Admin Feature Firestore Document Types & Constants
  * Covers: notifications, chat rooms, site settings
  */
+import type { AboutContentDocument } from "../../about/schemas/firestore";
 export declare const ADMIN_CHECKOUT_BYPASS_FLAG_KEY: "adminCheckoutBypass";
 export type NotificationType = "order_placed" | "order_confirmed" | "order_shipped" | "order_delivered" | "order_cancelled" | "bid_placed" | "bid_outbid" | "bid_won" | "bid_lost" | "review_approved" | "review_replied" | "product_available" | "promotion" | "system" | "welcome" | "account_action" | "offer_received" | "offer_responded" | "offer_expired" | "offer_counter_accepted" | "refund_initiated" | "prize_reveal_ready" | "prize_reveal_expired" | "prize_reveal_reminder" | "emi_installment_due_soon" | "emi_installment_overdue" | "payment_review";
 import type { BaseDocument } from "../../../_internal/shared/types/base-document";
@@ -19,6 +20,10 @@ export interface NotificationDocument extends BaseDocument {
     readAt?: Date;
     relatedId?: string;
     relatedType?: "order" | "product" | "bid" | "review" | "blog" | "user" | "offer" | "support_ticket" | "scammer";
+    /** Outcome of the async whatsappNotify job for this notification's WhatsApp send, if one was enqueued. */
+    whatsappStatus?: "queued" | "sent" | "failed" | "skipped";
+    /** jobs/{id} doc that ran (or is running) the WhatsApp send for this notification. */
+    whatsappJobId?: string;
 }
 export declare const NOTIFICATIONS_COLLECTION: "notifications";
 export declare const NOTIFICATIONS_INDEXED_FIELDS: readonly ["userId", "isRead", "createdAt", "type"];
@@ -162,6 +167,23 @@ export interface SiteSettingsCredentials {
     whatsappCloudApiToken?: string;
     /** Comma-separated digits-only phone numbers that receive order announcements */
     whatsappAdminNotifyNumbers?: string;
+    /**
+     * Approved Meta message-template names, one flat string field per
+     * order-lifecycle notification type — every `SiteSettingsCredentials`
+     * field is stored as an individually-encrypted string (see
+     * `getDecryptedCredentials`/`getCredentialsMasked`, which iterate + mask
+     * every field as a string), so this can't be a `Record<string,string>`
+     * map. Business-initiated WhatsApp sends outside the 24h customer-service
+     * window require a pre-approved template.
+     */
+    whatsappTemplateOrderPlaced?: string;
+    whatsappTemplateOrderConfirmed?: string;
+    whatsappTemplateOrderShipped?: string;
+    whatsappTemplateOrderDelivered?: string;
+    whatsappTemplateOrderCancelled?: string;
+    whatsappTemplateRefundInitiated?: string;
+    /** BCP-47 language code the templates above were approved in, e.g. "en" or "en_US". */
+    whatsappTemplateLanguage?: string;
 }
 export interface SiteSettingsCredentialsMasked {
     razorpayKeyId?: string;
@@ -183,6 +205,13 @@ export interface SiteSettingsCredentialsMasked {
     whatsappPhoneNumberId?: string;
     whatsappCloudApiToken?: string;
     whatsappAdminNotifyNumbers?: string;
+    whatsappTemplateOrderPlaced?: string;
+    whatsappTemplateOrderConfirmed?: string;
+    whatsappTemplateOrderShipped?: string;
+    whatsappTemplateOrderDelivered?: string;
+    whatsappTemplateOrderCancelled?: string;
+    whatsappTemplateRefundInitiated?: string;
+    whatsappTemplateLanguage?: string;
 }
 export interface NotificationChannelConfig {
     inApp: {
@@ -319,6 +348,19 @@ export interface SiteSettingsDocument extends BaseDocument {
         /** COD handling fee charged to the buyer: max(codHandlingFeeMin, subtotal × codHandlingFeePercent / 100). */
         codHandlingFeeMin: number;
         codHandlingFeePercent: number;
+        /** Admin master toggle — whether the WhatsApp order-updates addon is offered at checkout at all. */
+        whatsappNotifyFeeEnabled: boolean;
+        /** Flat rupee fee charged to the buyer when they opt into the WhatsApp order-updates addon. */
+        whatsappNotifyFee: number;
+        /** Admin master toggle — whether the gift-wrap addon is offered at checkout at all. */
+        giftWrapFeeEnabled: boolean;
+        /** Flat rupee fee charged to the buyer when they opt into gift wrap. */
+        giftWrapFee: number;
+        /** Admin master toggle — whether the shipment-protection addon is offered at checkout at all. */
+        shipmentProtectionFeeEnabled: boolean;
+        /** Shipment protection fee: max(shipmentProtectionFeeMin, subtotal × shipmentProtectionFeePercent / 100). */
+        shipmentProtectionFeePercent: number;
+        shipmentProtectionFeeMin: number;
         sellerShippingFixed: number;
         platformShippingPercent: number;
         platformShippingFixedMin: number;
@@ -426,6 +468,10 @@ export interface SiteSettingsDocument extends BaseDocument {
             codDeposit: number;
         };
     };
+    /** About Us page content, admin-editable via Site Settings. Optional so
+     * pre-existing docs without it still type-check; `about/page.tsx` falls
+     * back to i18n defaults when absent. */
+    aboutContent?: AboutContentDocument;
     navbarConfig?: {
         hiddenNavItems?: string[];
     };