@mohasinac/appkit 4.59.0 → 4.60.1

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

@@ -1,5 +1,5 @@
 "use client";
-import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { SIEVE_OP, Stack, sieveFilter } from "@mohasinac/appkit/client";
 import { sortBy } from "@mohasinac/appkit/client";
 import React, { useMemo } from "react";
@@ -101,5 +101,5 @@ export function AdminFaqsView({ children, onBulkArchive, onBulkDelete, ...props
     if (React.Children.count(children) > 0) {
         return (_jsxs(ListingLayout, { portal: "admin", ...props, children: [_jsx(Heading, { level: 1, className: "sr-only", children: "FAQs" }), children] }));
     }
-    return (_jsxs(_Fragment, { children: [_jsx(Heading, { level: 1, className: "sr-only", children: "FAQs" }), _jsx(DataListingView, { config: config })] }));
+    return _jsx(DataListingView, { config: config });
 }

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

@@ -0,0 +1,54 @@
+/**
+ * AdminGatewayEventsView — the webhook inbox, readable for the first time.
+ *
+ * ## What this is for
+ *
+ * `gatewayEvents` records every delivery verbatim, including event types we are
+ * subscribed to but do not implement — which is the whole reason the inbox
+ * exists rather than a logger line. Before it, a `payment.dispute.created`
+ * arriving ahead of the dispute handler would simply have vanished.
+ *
+ * This page answers three operator questions: did it arrive, what did we do
+ * with it, and can it be made to arrive again.
+ *
+ * ## 🛑 "Reopen for redelivery" is NOT "reprocess", and the UI must not imply it
+ *
+ * Nothing here can replay an event. R1's own header explains why: dispatching
+ * from anywhere but the webhook route would duplicate that route's whole switch
+ * and its RTDB signalling in a second place (Root Cause #75). The action only
+ * stops the inbox from refusing the NEXT delivery as a duplicate — the operator
+ * still presses Resend in the gateway dashboard.
+ *
+ * So the button says what it does, and the confirmation says what is left to
+ * do. A button labelled "Reprocess" doing only this would be the worst kind of
+ * half-truth: it would look like the work had happened.
+ *
+ * ## 🛑 Two statuses that look like failures and are not
+ *
+ * `ignored` means an event type we do not implement was recorded verbatim —
+ * healthy, and the inbox's purpose. `conflict` means a LATE event would have
+ * regressed an order's status, so it was recorded and not applied; the ack was
+ * 200 because the event is not wrong, it is out of date. Labelling either as an
+ * error would send operators chasing non-problems, which is how a queue stops
+ * being read.
+ *
+ * ## 🛑 No search box, and no sort on `status`
+ *
+ * `searchPlaceholder` is omitted because the endpoint does not read `q`;
+ * declaring it is what makes a dead box exist. And `status` is `canSort: false`
+ * in `SIEVE_FIELDS`, so a sort on it would be DROPPED silently by sievejs
+ * (Root Cause #63) — the status FILTER is the control, and it is in the panel.
+ *
+ * EXPORTS: AdminGatewayEventsView, type AdminGatewayEventsViewProps
+ *
+ * @tag domain:gateway-events
+ * @tag layer:component
+ * @tag pattern:listing
+ * @tag access:client
+ * @tag consumers:admin/maintenance/gateway-events
+ * @tag sideEffects:network
+ */
+import React from "react";
+import type { ListingLayoutProps } from "../../../ui";
+export type AdminGatewayEventsViewProps = ListingLayoutProps;
+export declare function AdminGatewayEventsView({ children, ...props }: AdminGatewayEventsViewProps): React.JSX.Element;

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

@@ -0,0 +1,209 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+/**
+ * AdminGatewayEventsView — the webhook inbox, readable for the first time.
+ *
+ * ## What this is for
+ *
+ * `gatewayEvents` records every delivery verbatim, including event types we are
+ * subscribed to but do not implement — which is the whole reason the inbox
+ * exists rather than a logger line. Before it, a `payment.dispute.created`
+ * arriving ahead of the dispute handler would simply have vanished.
+ *
+ * This page answers three operator questions: did it arrive, what did we do
+ * with it, and can it be made to arrive again.
+ *
+ * ## 🛑 "Reopen for redelivery" is NOT "reprocess", and the UI must not imply it
+ *
+ * Nothing here can replay an event. R1's own header explains why: dispatching
+ * from anywhere but the webhook route would duplicate that route's whole switch
+ * and its RTDB signalling in a second place (Root Cause #75). The action only
+ * stops the inbox from refusing the NEXT delivery as a duplicate — the operator
+ * still presses Resend in the gateway dashboard.
+ *
+ * So the button says what it does, and the confirmation says what is left to
+ * do. A button labelled "Reprocess" doing only this would be the worst kind of
+ * half-truth: it would look like the work had happened.
+ *
+ * ## 🛑 Two statuses that look like failures and are not
+ *
+ * `ignored` means an event type we do not implement was recorded verbatim —
+ * healthy, and the inbox's purpose. `conflict` means a LATE event would have
+ * regressed an order's status, so it was recorded and not applied; the ack was
+ * 200 because the event is not wrong, it is out of date. Labelling either as an
+ * error would send operators chasing non-problems, which is how a queue stops
+ * being read.
+ *
+ * ## 🛑 No search box, and no sort on `status`
+ *
+ * `searchPlaceholder` is omitted because the endpoint does not read `q`;
+ * declaring it is what makes a dead box exist. And `status` is `canSort: false`
+ * in `SIEVE_FIELDS`, so a sort on it would be DROPPED silently by sievejs
+ * (Root Cause #63) — the status FILTER is the control, and it is in the panel.
+ *
+ * EXPORTS: AdminGatewayEventsView, type AdminGatewayEventsViewProps
+ *
+ * @tag domain:gateway-events
+ * @tag layer:component
+ * @tag pattern:listing
+ * @tag access:client
+ * @tag consumers:admin/maintenance/gateway-events
+ * @tag sideEffects:network
+ */
+import React, { useState } from "react";
+import { sieveFilter, SIEVE_OP, sortBy, } from "@mohasinac/appkit/client";
+import { FilterChipGroup, ListingLayout, Modal, RecordDetailModal, Row, RowActionMenu, Stack, Text, Button, } from "../../../ui/index.js";
+import { ADMIN_ENDPOINTS } from "../../../constants/api-endpoints.js";
+import { ADMIN_GATEWAY_EVENT_KIND_TABS, ADMIN_GATEWAY_EVENT_STATUS_TABS, } from "../constants/filter-tabs.js";
+import { toRecordArray, toRelativeDate, toStringValue, } from "../hooks/useAdminListingData.js";
+import { DataListingView } from "./DataListingView.js";
+/** Operator-facing status names — see the 🛑 about `ignored` and `conflict`. */
+const STATUS_LABEL = {
+    received: "Received, not yet settled",
+    processing: "Being processed",
+    processed: "Processed",
+    failed: "Failed",
+    conflict: "Arrived late — recorded, not applied",
+    ignored: "Recorded, no handler for this type",
+};
+export function AdminGatewayEventsView({ children, ...props }) {
+    const [detail, setDetail] = useState(null);
+    const [reopenId, setReopenId] = useState(null);
+    const [busy, setBusy] = useState(false);
+    const [revision, setRevision] = useState(0);
+    if (React.Children.count(children) > 0) {
+        return (_jsx(ListingLayout, { portal: "admin", ...props, children: children }));
+    }
+    const reopen = async (id) => {
+        setBusy(true);
+        try {
+            const res = await fetch(ADMIN_ENDPOINTS.MAINTENANCE_GATEWAY_EVENTS, {
+                method: "PATCH",
+                headers: { "Content-Type": "application/json" },
+                body: JSON.stringify({ id }),
+            });
+            if (!res.ok)
+                throw new Error(`Could not reopen that event (${res.status})`);
+            setRevision((r) => r + 1);
+            setReopenId(null);
+            setDetail(null);
+        }
+        finally {
+            setBusy(false);
+        }
+    };
+    const config = {
+        portal: "admin",
+        title: "Gateway events",
+        subtitle: "Every webhook delivery, recorded verbatim — including event types we have no handler for. Read-only apart from reopening one for redelivery.",
+        emptyLabel: "No gateway events recorded",
+        // 🛑 No `searchPlaceholder` — the endpoint does not read `q`.
+        filterKeys: ["status", "kind"],
+        /*
+         * `receivedAt`, which every row has. 🛑 NOT `status`, which is
+         * `canSort: false` in SIEVE_FIELDS and would therefore be dropped by
+         * sievejs with no error (Root Cause #63); and not `processedAt`, which is
+         * optional — a Firestore `orderBy` excludes documents lacking the field, so
+         * it would hide every unsettled event, i.e. exactly the ones worth seeing
+         * (Root Cause #100).
+         */
+        defaultSort: sortBy("receivedAt", "DESC"),
+        queryKey: ["admin", "gateway-events", "listing", String(revision)],
+        endpoint: ADMIN_ENDPOINTS.MAINTENANCE_GATEWAY_EVENTS,
+        /*
+         * 🛑 ONLY `receivedAt`, and the omission is an index-weight decision rather
+         * than a shortfall.
+         *
+         * `attempts` is `canSort: true`, so "Most attempts" would work — but each
+         * filter+sort combination needs its own composite index, and a sort on a
+         * second field triples them: `(status, attempts)`, `(kind, attempts)`,
+         * `(status, kind, attempts)` on top of the three `receivedAt` ones.
+         *
+         * `gatewayEvents` takes a row for every webhook delivery, which makes it
+         * the highest-write collection in this subsystem — and a composite index is
+         * a write multiplier on EVERY document, forever, not a read-time cost. Six
+         * indexes to rank a rarely-opened diagnostic by a number the `failed` status
+         * filter already finds is the wrong trade.
+         *
+         * Two indexes are added for the filter combinations that remain:
+         * `(status, receivedAt desc)` and `(status, kind, receivedAt desc)`.
+         * `(kind, receivedAt desc)` already existed.
+         */
+        sortOptions: [
+            { value: sortBy("receivedAt", "DESC"), label: "Newest" },
+            { value: sortBy("receivedAt", "ASC"), label: "Oldest" },
+        ],
+        mapRows: (response) => toRecordArray(response.items).map((item, index) => {
+            const status = toStringValue(item.status, "received");
+            const attempts = typeof item.attempts === "number" ? item.attempts : 0;
+            return {
+                id: toStringValue(item.id, `event-${index}`),
+                primary: `${toStringValue(item.gateway, "?")} · ${toStringValue(item.kind, "other")}`,
+                secondary: [
+                    STATUS_LABEL[status] ?? status,
+                    toStringValue(item.gatewayOrderId, "") || null,
+                    toStringValue(item.gatewayPaymentId, "") || null,
+                    // Only when informative — "1 attempt" is the normal case and noise.
+                    attempts > 1 ? `${attempts} attempts` : null,
+                    item.terminal === true ? "terminal" : null,
+                ]
+                    .filter(Boolean)
+                    .join(" · "),
+                status,
+                updatedAt: toRelativeDate(item.receivedAt),
+                _raw: item,
+            };
+        }),
+        getTotal: (response, mappedRows) => typeof response.meta?.total === "number" ? response.meta.total : mappedRows.length,
+        onRowClick: (row) => setDetail(row._raw),
+        buildFilters: (state) => {
+            const parts = [];
+            if (state.status && state.status !== "All")
+                parts.push(sieveFilter("status", SIEVE_OP.EQ, state.status));
+            if (state.kind && state.kind !== "All")
+                parts.push(sieveFilter("kind", SIEVE_OP.EQ, state.kind));
+            return parts.length > 0 ? parts.join(",") : undefined;
+        },
+        renderRowActions: (row) => (_jsx(RowActionMenu, { actions: [
+                { label: "View details", onClick: () => setDetail(row._raw) },
+                { label: "Reopen for redelivery", onClick: () => setReopenId(row.id) },
+            ] })),
+        renderFilterPanel: ({ pendingFilters, setPendingFilters }) => (_jsxs(Stack, { gap: "md", children: [_jsx(FilterChipGroup, { label: "Status", tabs: ADMIN_GATEWAY_EVENT_STATUS_TABS, value: pendingFilters.status ?? "", onChange: (id) => setPendingFilters((p) => ({ ...p, status: id })) }), _jsx(FilterChipGroup, { label: "Kind", tabs: ADMIN_GATEWAY_EVENT_KIND_TABS, value: pendingFilters.kind ?? "", onChange: (id) => setPendingFilters((p) => ({ ...p, kind: id })) })] })),
+    };
+    const detailStatus = detail ? toStringValue(detail.status, "") : "";
+    return (_jsxs(_Fragment, { children: [_jsx(DataListingView, { config: config }), _jsx(RecordDetailModal, { isOpen: detail !== null, onClose: () => setDetail(null), title: detail
+                    ? `${toStringValue(detail.gateway, "?")} · ${toStringValue(detail.kind, "other")}`
+                    : "Gateway event", badges: detail
+                    ? [
+                        { label: STATUS_LABEL[detailStatus] ?? detailStatus },
+                        ...(detail.terminal === true
+                            ? [{ label: "terminal", variant: "warning" }]
+                            : []),
+                    ]
+                    : undefined, fields: detail
+                    ? [
+                        { label: "Event id", value: toStringValue(detail.id, "") },
+                        { label: "Provider event id", value: toStringValue(detail.providerEventId, "") || "— (deduped on the body digest instead)" },
+                        { label: "Body SHA-256", value: toStringValue(detail.bodySha256, "") },
+                        { label: "Gateway order", value: toStringValue(detail.gatewayOrderId, "") || "—" },
+                        { label: "Gateway payment", value: toStringValue(detail.gatewayPaymentId, "") || "—" },
+                        { label: "Amount", value: typeof detail.amount === "number" ? `₹${detail.amount.toFixed(2)}` : "—" },
+                        { label: "Orders placed", value: Array.isArray(detail.orderIds) ? detail.orderIds.join(", ") : "—" },
+                        { label: "Received", value: toStringValue(detail.receivedAt, "") },
+                        { label: "Settled", value: toStringValue(detail.processedAt, "") || "— not settled" },
+                        { label: "Attempts", value: String(detail.attempts ?? 0) },
+                        { label: "Lease expires", value: toStringValue(detail.leaseExpiresAt, "") },
+                        { label: "Last error", value: toStringValue(detail.lastError, "") || "—" },
+                        { label: "Retention expiry", value: toStringValue(detail.expiresAt, "") },
+                    ]
+                    : undefined, 
+                /*
+                 * `payload` is the REDACTED projection, never the raw body — Razorpay's
+                 * payment entity carries email, contact, card.last4, vpa and bank, and
+                 * `redactGatewayPayload` strips them recursively. `bodySha256` above
+                 * preserves integrity regardless, which is what makes redaction safe.
+                 */
+                metadata: detail && detail.payload && typeof detail.payload === "object"
+                    ? detail.payload
+                    : undefined, footer: detail ? (_jsx(Button, { variant: "outline", size: "sm", onClick: () => setReopenId(toStringValue(detail.id, "")), children: "Reopen for redelivery" })) : undefined }), _jsx(Modal, { isOpen: reopenId !== null, onClose: () => setReopenId(null), title: "Reopen this event for redelivery", size: "sm", children: _jsxs(Stack, { gap: "md", children: [_jsxs(Text, { size: "sm", children: ["This clears the terminal flag and the attempt count so the inbox will ", _jsx("strong", { children: "accept" }), " the next delivery of this event instead of refusing it as a duplicate."] }), _jsx(Row, { surface: "warning-surface", padding: "sm", rounded: "default", children: _jsxs(Text, { size: "sm", color: "warning", children: ["It does not reprocess anything by itself. Nothing outside the webhook route knows how to handle an event, so after this you still need to press ", _jsx("strong", { children: "Resend" }), " on this delivery in the gateway dashboard \u2014 or wait for the gateway\u2019s own retry."] }) }), _jsxs(Row, { justify: "end", gap: "sm", children: [_jsx(Button, { variant: "ghost", onClick: () => setReopenId(null), disabled: busy, children: "Cancel" }), _jsx(Button, { variant: "primary", isLoading: busy, disabled: busy, onClick: () => reopen(reopenId), children: "Reopen" })] })] }) })] }));
+}

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

@@ -81,5 +81,5 @@ export function AdminGuideHubView({ permissions = [], isFullAdmin = false }) {
     const hasPermission = (perm) => isFullAdmin || permissions.includes(perm);
     const visibleCards = GUIDE_CARDS.filter((c) => hasPermission(c.permission));
     const hasAny = visibleCards.length > 0;
-    return (_jsxs(Stack, { gap: "xl", padding: "b-2xl", children: [_jsx(Section, { overflow: "hidden", className: "border border-[var(--appkit-color-border)] bg-[var(--appkit-color-surface)]", rounded: "2xl", shadow: "sm", children: _jsxs(Div, { paddingX: "x-md-xl", paddingY: "y-xl", className: "[background:linear-gradient(135deg,var(--appkit-color-primary-700)_0%,var(--appkit-color-cobalt)_60%,var(--appkit-color-secondary-400)_100%)]", children: [_jsxs(Row, { className: "mb-3", align: "center", gap: "3", children: [_jsx(Row, { className: "flex-shrink-0 w-10 h-10", surface: "default", align: "center", justify: "center", rounded: "xl", children: _jsx(BookOpen, { className: "w-5 h-5 text-white" }) }), _jsx(Text, { color: "inverse", className: "/80 tracking-widest", size: "sm", weight: "semibold", transform: "uppercase", children: "Admin & Employee Guide" })] }), _jsx(Heading, { color: "inverse", level: 1, className: "mb-2", mdSize: "3xl", size: "2xl", weight: "bold", children: "LetItRip Internal Guide" }), _jsx(Text, { color: "inverse", className: "/80", size: "base", children: "Everything you need to operate and manage LetItRip \u2014 India's largest collectibles marketplace." })] }) }), _jsx(Alert, { variant: "info", compact: true, children: "These guides describe expected platform behaviour. Real access to each section is enforced independently by the permission system \u2014 this page is reference only." }), !hasAny && (_jsx(Alert, { variant: "info", title: "Limited access", children: "Your permission set doesn't include read access to any admin sections yet. Contact your admin to request the permissions you need." })), hasAny && (_jsxs(Section, { children: [_jsx(Heading, { level: 2, className: "text-[var(--appkit-color-text)] mb-4", size: "lg", weight: "semibold", children: "Guides" }), _jsx(Grid, { cols: "cards", gap: "md", children: visibleCards.map(({ Icon, title, description, href }) => (_jsxs(TextLink, { variant: "bare", href: href, rounded: "xl", layout: "flex-col", gap: "md", paddingX: "lg", paddingY: "lg", shadow: "hover-md", className: "group border border-[var(--appkit-color-border)] bg-[var(--appkit-color-surface)] hover:border-[var(--appkit-color-primary)] transition-all", children: [_jsxs(Row, { align: "center", gap: "3", children: [_jsx(Row, { className: "flex-shrink-0 w-9 h-9 [background:linear-gradient(135deg,var(--appkit-color-primary-700)_0%,var(--appkit-color-cobalt)_100%)]", align: "center", justify: "center", rounded: "lg", children: _jsx(Icon, { className: "w-4 h-4 text-white" }) }), _jsx(Text, { className: "text-[var(--appkit-color-text)] group-hover:text-[var(--appkit-color-primary)] transition-colors", weight: "semibold", children: title })] }), _jsx(Text, { className: "text-[var(--appkit-color-text-muted)] leading-relaxed", size: "sm", children: description }), _jsx(Text, { className: "text-[var(--appkit-color-primary)] mt-auto", size: "xs", weight: "medium", children: "Read guide \u2192" })] }, title))) })] })), _jsx(Section, { className: CLS_WARN_PANEL, children: _jsxs(Row, { align: "start", gap: "3", children: [_jsx(AlertTriangle, { className: "w-5 h-5 text-warning flex-shrink-0 mt-0.5" }), _jsxs(Div, { children: [_jsx(Text, { className: CLS_WARN_HEAD, children: "Remember: with great access comes responsibility" }), _jsx(Text, { className: CLS_WARN_BODY, children: "Admin actions are logged. Never access user PII (email, phone) without a legitimate support reason. Never grant capabilities or permissions without documented approval. When in doubt, escalate to a senior admin." })] })] }) })] }));
+    return (_jsxs(Stack, { gap: "xl", padding: "b-2xl", children: [_jsx(Section, { overflow: "hidden", className: "border border-[var(--appkit-color-border)] bg-[var(--appkit-color-surface)]", rounded: "2xl", shadow: "sm", children: _jsxs(Div, { paddingX: "x-md-xl", paddingY: "y-xl", className: "[background:linear-gradient(135deg,var(--appkit-color-primary-700)_0%,var(--appkit-color-cobalt)_60%,var(--appkit-color-secondary-400)_100%)]", children: [_jsxs(Row, { className: "mb-3", align: "center", gap: "3", children: [_jsx(Row, { className: "flex-shrink-0 w-10 h-10", surface: "default", align: "center", justify: "center", rounded: "xl", children: _jsx(BookOpen, { className: "w-5 h-5 text-white" }) }), _jsx(Text, { color: "inverse-muted", className: "tracking-widest", size: "sm", weight: "semibold", transform: "uppercase", children: "Admin & Employee Guide" })] }), _jsx(Heading, { color: "inverse", level: 1, className: "mb-2", mdSize: "3xl", size: "2xl", weight: "bold", children: "LetItRip Internal Guide" }), _jsx(Text, { color: "inverse-muted", size: "base", children: "Everything you need to operate and manage LetItRip \u2014 India's largest collectibles marketplace." })] }) }), _jsx(Alert, { variant: "info", compact: true, children: "These guides describe expected platform behaviour. Real access to each section is enforced independently by the permission system \u2014 this page is reference only." }), !hasAny && (_jsx(Alert, { variant: "info", title: "Limited access", children: "Your permission set doesn't include read access to any admin sections yet. Contact your admin to request the permissions you need." })), hasAny && (_jsxs(Section, { children: [_jsx(Heading, { level: 2, className: "text-[var(--appkit-color-text)] mb-4", size: "lg", weight: "semibold", children: "Guides" }), _jsx(Grid, { cols: "cards", gap: "md", children: visibleCards.map(({ Icon, title, description, href }) => (_jsxs(TextLink, { variant: "bare", href: href, rounded: "xl", layout: "flex-col", gap: "md", paddingX: "lg", paddingY: "lg", shadow: "hover-md", className: "group border border-[var(--appkit-color-border)] bg-[var(--appkit-color-surface)] hover:border-[var(--appkit-color-primary)] transition-all", children: [_jsxs(Row, { align: "center", gap: "3", children: [_jsx(Row, { className: "flex-shrink-0 w-9 h-9 [background:linear-gradient(135deg,var(--appkit-color-primary-700)_0%,var(--appkit-color-cobalt)_100%)]", align: "center", justify: "center", rounded: "lg", children: _jsx(Icon, { className: "w-4 h-4 text-white" }) }), _jsx(Text, { className: "text-[var(--appkit-color-text)] group-hover:text-[var(--appkit-color-primary)] transition-colors", weight: "semibold", children: title })] }), _jsx(Text, { className: "text-[var(--appkit-color-text-muted)] leading-relaxed", size: "sm", children: description }), _jsx(Text, { className: "text-[var(--appkit-color-primary)] mt-auto", size: "xs", weight: "medium", children: "Read guide \u2192" })] }, title))) })] })), _jsx(Section, { className: CLS_WARN_PANEL, children: _jsxs(Row, { align: "start", gap: "3", children: [_jsx(AlertTriangle, { className: "w-5 h-5 text-warning flex-shrink-0 mt-0.5" }), _jsxs(Div, { children: [_jsx(Text, { className: CLS_WARN_HEAD, children: "Remember: with great access comes responsibility" }), _jsx(Text, { className: CLS_WARN_BODY, children: "Admin actions are logged. Never access user PII (email, phone) without a legitimate support reason. Never grant capabilities or permissions without documented approval. When in doubt, escalate to a senior admin." })] })] }) })] }));
 }

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

@@ -0,0 +1,60 @@
+/**
+ * AdminMoneyCasesView — the operator queue for everything where money is at
+ * risk, and the FIRST surface `paymentCases` has ever had.
+ *
+ * ## Why this page is the point of the whole payment-protection spine
+ *
+ * The event inbox, the four reconcilers, the obligation sweep, the dispute
+ * ingest, the protection claims and the grievance intake all converge on one
+ * collection — and until this view existed, **nothing could read it.** Thirty-six
+ * commits of detection wrote rows into a queue with no screen. That is Root
+ * Cause #56 at the scale of a subsystem: *a feature is built, one of its
+ * surfaces is missing, and nothing notices.*
+ *
+ * The daily digest was the only consumer, and it was built first for exactly
+ * that reason — it PUSHES, so the queue had one reader from day one. This is
+ * the pull side.
+ *
+ * ## 🛑 It is NOT under `/admin/maintenance/`
+ *
+ * Maintenance means "something broke, look when you can" and is granted to
+ * `maintenance_employee`. A case here can carry a gateway's own `respond_by` —
+ * miss it and the chargeback is lost by default irrespective of who was right —
+ * and an `amountAtRisk` in real rupees. Hence its own section and
+ * `admin:payment-cases:read|write`, admin only.
+ *
+ * ## 🛑 NO SEARCH BOX, and that is a decision
+ *
+ * `ListingViewConfig.searchPlaceholder` is optional and *"declaring it is what
+ * makes the box exist"*. `/api/admin/payment-cases` does not read `q`, and
+ * ~39 views in this codebase already render a box whose endpoint ignores the
+ * term — the user types, the request carries it, nothing changes, no error.
+ * Omitting it is the fix; a placeholder describing a capability the endpoint
+ * lacks is the defect.
+ *
+ * ## 🛑 The default sort cannot be `dueAt`
+ *
+ * `dueAt` is OPTIONAL and most cases have none — only a dispute and a grievance
+ * carry an external clock. A Firestore `orderBy` on an optional field silently
+ * EXCLUDES every document that lacks it (Root Cause #100), so sorting by
+ * deadline would hide the great majority of the queue while looking like it had
+ * simply ordered it. `lastObservedAt` is written by `openOrObserve` on every
+ * case, every time, so it is the only safe default — and it happens to be the
+ * right one: "what has been seen most recently".
+ *
+ * Deadline pressure is surfaced instead by the `dueAt` row text and by R4,
+ * which escalates and re-notifies at T-72h and T-24h.
+ *
+ * EXPORTS: AdminMoneyCasesView, type AdminMoneyCasesViewProps
+ *
+ * @tag domain:payment-cases
+ * @tag layer:component
+ * @tag pattern:listing
+ * @tag access:client
+ * @tag consumers:admin/money-cases
+ * @tag sideEffects:network
+ */
+import React from "react";
+import type { ListingLayoutProps } from "../../../ui";
+export type AdminMoneyCasesViewProps = ListingLayoutProps;
+export declare function AdminMoneyCasesView({ children, ...props }: AdminMoneyCasesViewProps): React.JSX.Element;