@mohasinac/appkit 4.62.0 → 4.63.0

package/dist/features/dispute-reasons/components/AdminDisputeReasonsView.js

@@ -0,0 +1,175 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { useCallback, useState } from "react";
+import { Badge, Button, Row, Stack, Text } from "../../../ui/index.js";
+import { RecordDetailModal } from "../../../ui/components/RecordDetailModal.js";
+import { useToast } from "../../../ui/components/Toast.js";
+import { FieldInput } from "../../../ui/forms/FieldInput.js";
+import { FieldSelect } from "../../../ui/forms/FieldSelect.js";
+import { normalizeError } from "../../../errors/normalize.js";
+import { DataListingView } from "../../admin/components/DataListingView.js";
+import { ACTIONS } from "../../../_internal/shared/actions/action-registry.js";
+import { DISPUTE_KIND, } from "../../../_internal/shared/features/orders/dispute-reasons.js";
+import { DISPUTE_REASON_LABEL_MAX, } from "../schemas/firestore.js";
+/**
+ * What each kind MEANS, in one place.
+ *
+ * 🛑 A `Record<DisputeKind, string>`, so a third kind is a compile error here
+ * rather than a picker option rendering a bare token. The kind is the only
+ * field on a reason with a consequence — it decides which gate a dispute
+ * raised under it inherits — so it is the one that must never read as jargon.
+ */
+const KIND_MEANING = {
+    item: "Item problem — it arrived wrong or damaged",
+    not_reached: "Never arrived — the parcel did not reach the buyer",
+};
+/*
+ * Chips over `isActive`, as ordinary Sieve clauses. `listAll` applies no
+ * `isActive` filter of its own precisely so these work without the repository
+ * growing a method per chip.
+ *
+ * 🛑 "All" carries NO filter rather than `isActive==true|false`. A pipe-joined
+ * OR over a boolean would be two equalities merged for no reason, and — worse —
+ * it would exclude any row written before the field existed, which is the `!=`
+ * trap one step removed.
+ */
+const SCOPE_CHIPS = [
+    { id: "active", label: "Active", filter: "isActive==true" },
+    { id: "retired", label: "Retired", filter: "isActive==false" },
+    { id: "all", label: "All", filter: undefined },
+];
+/**
+ * The two fields, exported so the triage drawer's inline create and this page
+ * cannot drift on the label bound or the kind vocabulary.
+ */
+export function DisputeReasonFields({ label, kind, onLabel, onKind, }) {
+    return (_jsxs(Stack, { gap: "md", children: [_jsx(FieldInput, { name: "label", label: "Reason wording", required: true, value: label, onChange: onLabel, maxLength: DISPUTE_REASON_LABEL_MAX, placeholder: "The courier left it at the wrong flat" }), _jsx(FieldSelect, { name: "kind", label: "Kind", required: true, value: kind, onChange: (v) => onKind(v), 
+                /*
+                 * Two options, so `<FieldSelect>` is correct — `PaginatedSelect` is for
+                 * >5 (Rule #9), and a searchable dropdown over two values is worse than
+                 * a native select. Derived from the shipped union so a third kind
+                 * cannot exist in the gate and be missing here.
+                 */
+                options: DISPUTE_KIND.map((k) => ({ value: k, label: KIND_MEANING[k] })) })] }));
+}
+/** Create form. Shares `DisputeReasonFields` and the endpoint with the drawer. */
+function CreateReasonForm({ onSubmit, }) {
+    const [label, setLabel] = useState("");
+    const [kind, setKind] = useState(DISPUTE_KIND[0]);
+    const [busy, setBusy] = useState(false);
+    const { showToast } = useToast();
+    return (_jsxs(Stack, { gap: "md", children: [_jsx(Text, { size: "sm", color: "muted", children: "Short wording, as a buyer would read it. The detail goes in their own free-text field \u2014 this is a picker option, not the explanation." }), _jsx(DisputeReasonFields, { label: label, kind: kind, onLabel: setLabel, onKind: setKind }), _jsx(Button, { action: ACTIONS.ADMIN["add-dispute-reason"], isLoading: busy, disabled: busy || label.trim().length < 3, onClick: async () => {
+                    setBusy(true);
+                    try {
+                        await onSubmit({ label: label.trim(), kind });
+                    }
+                    catch (err) {
+                        void normalizeError(err);
+                        showToast("Couldn't add that reason.", "error");
+                    }
+                    finally {
+                        setBusy(false);
+                    }
+                } })] }));
+}
+export function AdminDisputeReasonsView({ endpoint, onSetActive, onCreate, }) {
+    const { showToast } = useToast();
+    const [open, setOpen] = useState(null);
+    const [pending, setPending] = useState(null);
+    const setActive = useCallback(async (row, isActive) => {
+        setPending(row.id);
+        try {
+            await onSetActive(row.id, isActive);
+            showToast(isActive ? `"${row.label}" is back in the picker.` : `"${row.label}" retired.`, "success");
+        }
+        catch (err) {
+            void normalizeError(err);
+            /*
+             * No optimistic flip anywhere here, so a failure needs no rollback —
+             * the row still shows what the server last told us. Only a successful
+             * write and the refetch behind it move the list.
+             */
+            showToast("Couldn't save that. Nothing was changed.", "error");
+        }
+        finally {
+            setPending(null);
+        }
+    }, [onSetActive, showToast]);
+    const rowControls = useCallback((row) => (_jsxs(Row, { align: "center", gap: "sm", children: [_jsx(Button, { variant: "ghost", size: "sm", onClick: () => setOpen(row), children: "View" }), _jsx(Button, { action: row.isActive
+                    ? ACTIONS.ADMIN["retire-dispute-reason"]
+                    : ACTIONS.ADMIN["reactivate-dispute-reason"], size: "sm", isLoading: pending === row.id, disabled: pending !== null, onClick: () => setActive(row, !row.isActive) })] })), [pending, setActive]);
+    return (_jsxs(_Fragment, { children: [_jsx(DataListingView, { config: {
+                    portal: "admin",
+                    title: "Dispute reasons",
+                    subtitle: "What buyers can pick when reporting a problem. A reason's kind decides which gate it inherits — the wording is yours.",
+                    endpoint: endpoint,
+                    queryKey: ["admin", "dispute-reasons"],
+                    defaultSort: "label",
+                    /*
+                     * 🛑 REQUIRED on `ListingViewConfig`, and the default must be one of
+                     * these or the dropdown opens with nothing selected (Root Cause #63).
+                     * Eleven rows, so the only orders worth offering are the buyer-facing
+                     * wording and which kind a reason belongs to.
+                     */
+                    sortOptions: [
+                        { value: "label", label: "Wording (A–Z)" },
+                        { value: "-label", label: "Wording (Z–A)" },
+                        { value: "kind", label: "Kind" },
+                    ],
+                    filterKeys: ["scope"],
+                    filterDefaults: { scope: "active" },
+                    buildFilters: (state) => SCOPE_CHIPS.find((c) => c.id === (state.scope ?? "active"))?.filter,
+                    mapRows: (res) => (res.items ?? []).map((r) => ({
+                        id: r.id,
+                        label: r.label,
+                        kind: r.kind,
+                        isActive: r.isActive,
+                        createdByName: r.createdByName,
+                    })),
+                    getTotal: (res, rows) => res.total ?? rows.length,
+                    /*
+                     * 🛑 No `searchPlaceholder` and no `search` — the endpoint does not read
+                     * `q`, and declaring either is what makes the box exist. ~39 views here
+                     * render a box whose endpoint ignores the term: it accepts typing, the
+                     * request carries it, and the results do not change, with no error
+                     * anywhere. Eleven rows with scope chips need no search.
+                     */
+                    emptyLabel: "No reasons in this scope.",
+                    primaryAction: {
+                        label: ACTIONS.ADMIN["add-dispute-reason"].label,
+                        onClick: ({ openCreatePanel }) => openCreatePanel(),
+                    },
+                    renderEditor: ({ closePanel }) => (_jsx(CreateReasonForm, { onSubmit: async (input) => {
+                            await onCreate(input);
+                            closePanel();
+                        } })),
+                    resolveEditorTitle: () => "Add a dispute reason",
+                    onRowClick: (row) => setOpen(row),
+                    renderRowActions: rowControls,
+                    renderCards: (rows) => (_jsx(Stack, { gap: "sm", children: rows.map((row) => (_jsxs(Row, { surface: "card", padding: "md", rounded: "lg", border: "default", align: "center", justify: "between", gap: "md", className: "min-w-0", children: [_jsxs(Stack, { gap: "xs", className: "min-w-0", children: [_jsxs(Row, { align: "center", gap: "sm", className: "min-w-0", children: [_jsx(Text, { weight: "semibold", color: "primary", className: "min-w-0", children: row.label }), _jsx(Badge, { variant: row.isActive ? "success" : "inactive", children: row.isActive ? "Active" : "Retired" })] }), _jsx(Text, { size: "xs", color: "muted", children: KIND_MEANING[row.kind] }), _jsxs(Text, { size: "xs", color: "faint", children: ["Added by ", row.createdByName] })] }), rowControls(row)] }, row.id))) })),
+                } }), open && (_jsx(RecordDetailModal, { isOpen: true, onClose: () => setOpen(null), title: open.label, badges: [
+                    {
+                        label: open.isActive ? "Active" : "Retired",
+                        variant: open.isActive ? "success" : "secondary",
+                    },
+                ], fields: [
+                    { label: "Buyer-facing wording", value: open.label },
+                    { label: "Kind", value: `${open.kind} — ${KIND_MEANING[open.kind]}` },
+                    {
+                        label: "State",
+                        value: open.isActive
+                            ? "Active — buyers see it on the dispute form"
+                            : "Retired — hidden from the form",
+                    },
+                    { label: "Added by", value: open.createdByName },
+                ], metadata: {
+                    id: open.id,
+                    /*
+                     * Stated on the record itself, because it is the fact an agent is
+                     * most likely to be unsure about at the moment they are deciding
+                     * whether to retire: the order snapshots the LABEL, so retiring
+                     * cannot rewrite what a past dispute said.
+                     */
+                    retiringIsNeverADelete: "Disputes already raised under this reason keep their wording — the order snapshots the label rather than pointing at this row.",
+                } }))] }));
+}

package/dist/features/dispute-reasons/repository/dispute-reasons.repository.d.ts

@@ -0,0 +1,62 @@
+import type { FirebaseSieveFields, FirebaseSieveResult, SieveModel } from "../../../providers/db-firebase";
+import { BaseRepository } from "../../../providers/db-firebase";
+import type { DisputeKind } from "../../../_internal/shared/features/orders/dispute-reasons";
+import { type DisputeReasonDocument } from "../schemas/firestore";
+export declare class DisputeReasonsRepository extends BaseRepository<DisputeReasonDocument> {
+    static readonly SIEVE_FIELDS: FirebaseSieveFields;
+    constructor();
+    /**
+     * The picker's list, scoped to one kind.
+     *
+     * 🛑 Scoped by KIND, not merged. A buyer reporting a damaged item must not be
+     * offered "it never arrived" — that reason belongs to the other gate, and
+     * picking it would produce a dispute the gate then refuses, which reads to
+     * the buyer as the form being broken rather than as the wrong choice.
+     */
+    listActiveByKind(kind: DisputeKind, model: SieveModel): Promise<FirebaseSieveResult<DisputeReasonDocument>>;
+    /**
+     * Add a reason. Staff only — enforced at the route, not here.
+     *
+     * 🛑 Keyed `dreason-<slug>`, so two agents cannot add the same wording twice.
+     * A colliding create returns the EXISTING row rather than overwriting it:
+     * that row has an author and may already be named on live disputes, and the
+     * second agent's intent ("there should be a reason for this") is satisfied by
+     * what exists. Same rule as the shipping-box presets.
+     */
+    createReason(input: {
+        label: string;
+        kind: DisputeKind;
+        createdByUid: string;
+        createdByName: string;
+    }): Promise<{
+        reason: DisputeReasonDocument;
+        created: boolean;
+    }>;
+    /**
+     * Every row, retired included — the staff management list.
+     *
+     * 🛑 Deliberately NOT `listActiveByKind` with the `isActive` clause dropped.
+     * That method also pins `kind`, and a management view must span both kinds:
+     * a reason retired for the wrong gate is exactly the row staff need to find.
+     *
+     * No `isActive` filter is applied here at all, so the caller's own Sieve
+     * filters decide — which is what lets the view offer Active / Retired / All
+     * chips without this method growing a parameter per chip.
+     */
+    listAll(model: SieveModel): Promise<FirebaseSieveResult<DisputeReasonDocument>>;
+    /** Soft-retire. See the schema for why this is never a delete. */
+    retire(id: string): Promise<void>;
+    /**
+     * Put a retired reason back in the picker.
+     *
+     * `createReason` already reactivates on a colliding re-add, which covers the
+     * agent who types the wording again. This covers the different case the
+     * management view creates: a row you can SEE and want back, where re-typing
+     * its exact label to resurrect it would be a trick rather than a control.
+     *
+     * The original `createdByName` is kept — they wrote the wording, and a
+     * reactivation is not authorship.
+     */
+    reactivate(id: string): Promise<void>;
+}
+export declare const disputeReasonsRepository: DisputeReasonsRepository;

package/dist/features/dispute-reasons/repository/dispute-reasons.repository.js

@@ -0,0 +1,108 @@
+import { BaseRepository } from "../../../providers/db-firebase/index.js";
+import { slugify } from "../../../utils/string.formatter.js";
+import { DISPUTE_REASON_COLLECTION, DISPUTE_REASON_FIELDS, DISPUTE_REASON_LABEL_MAX, } from "../schemas/firestore.js";
+export class DisputeReasonsRepository extends BaseRepository {
+    constructor() {
+        super(DISPUTE_REASON_COLLECTION);
+    }
+    /**
+     * The picker's list, scoped to one kind.
+     *
+     * 🛑 Scoped by KIND, not merged. A buyer reporting a damaged item must not be
+     * offered "it never arrived" — that reason belongs to the other gate, and
+     * picking it would produce a dispute the gate then refuses, which reads to
+     * the buyer as the form being broken rather than as the wrong choice.
+     */
+    async listActiveByKind(kind, model) {
+        const baseQuery = this.getCollection()
+            .where(DISPUTE_REASON_FIELDS.IS_ACTIVE, "==", true)
+            .where(DISPUTE_REASON_FIELDS.KIND, "==", kind);
+        return this.sieveQuery(model, DisputeReasonsRepository.SIEVE_FIELDS, { baseQuery, defaultPageSize: 20, maxPageSize: 50 });
+    }
+    /**
+     * Add a reason. Staff only — enforced at the route, not here.
+     *
+     * 🛑 Keyed `dreason-<slug>`, so two agents cannot add the same wording twice.
+     * A colliding create returns the EXISTING row rather than overwriting it:
+     * that row has an author and may already be named on live disputes, and the
+     * second agent's intent ("there should be a reason for this") is satisfied by
+     * what exists. Same rule as the shipping-box presets.
+     */
+    async createReason(input) {
+        const label = input.label.trim().slice(0, DISPUTE_REASON_LABEL_MAX);
+        const id = `dreason-${slugify(label)}`;
+        const existing = await this.findById(id);
+        /*
+         * A retired row that someone re-adds is REACTIVATED rather than duplicated
+         * — otherwise the slug collides forever and the agent can never get their
+         * reason back. Reactivating keeps the original author, which is correct:
+         * they wrote the wording.
+         */
+        if (existing) {
+            if (!existing.isActive) {
+                await this.update(id, { isActive: true, updatedAt: new Date() });
+                return { reason: { ...existing, isActive: true }, created: false };
+            }
+            return { reason: existing, created: false };
+        }
+        const now = new Date();
+        const reason = {
+            id,
+            label,
+            kind: input.kind,
+            isActive: true,
+            createdByUid: input.createdByUid,
+            createdByName: input.createdByName,
+            createdAt: now,
+            updatedAt: now,
+        };
+        await this.createWithId(id, reason);
+        return { reason, created: true };
+    }
+    /**
+     * Every row, retired included — the staff management list.
+     *
+     * 🛑 Deliberately NOT `listActiveByKind` with the `isActive` clause dropped.
+     * That method also pins `kind`, and a management view must span both kinds:
+     * a reason retired for the wrong gate is exactly the row staff need to find.
+     *
+     * No `isActive` filter is applied here at all, so the caller's own Sieve
+     * filters decide — which is what lets the view offer Active / Retired / All
+     * chips without this method growing a parameter per chip.
+     */
+    async listAll(model) {
+        return this.sieveQuery(model, DisputeReasonsRepository.SIEVE_FIELDS, { baseQuery: this.getCollection(), defaultPageSize: 20, maxPageSize: 50 });
+    }
+    /** Soft-retire. See the schema for why this is never a delete. */
+    async retire(id) {
+        await this.update(id, { isActive: false, updatedAt: new Date() });
+    }
+    /**
+     * Put a retired reason back in the picker.
+     *
+     * `createReason` already reactivates on a colliding re-add, which covers the
+     * agent who types the wording again. This covers the different case the
+     * management view creates: a row you can SEE and want back, where re-typing
+     * its exact label to resurrect it would be a trick rather than a control.
+     *
+     * The original `createdByName` is kept — they wrote the wording, and a
+     * reactivation is not authorship.
+     */
+    async reactivate(id) {
+        await this.update(id, { isActive: true, updatedAt: new Date() });
+    }
+}
+DisputeReasonsRepository.SIEVE_FIELDS = {
+    /*
+     * 🛑 `label` must be here because `PaginatedSelect` SEARCHES it. An
+     * unallowlisted searched field does not raise — `sieve.ts` sets
+     * `throwExceptions: false`, so `findField` returns undefined, the clause is
+     * silently dropped, and the picker returns the WHOLE list while looking
+     * exactly like it filtered (Root Cause #62).
+     */
+    label: { canFilter: true, canSort: true },
+    kind: { canFilter: true, canSort: false },
+    isActive: { canFilter: true, canSort: false },
+    createdByUid: { canFilter: true, canSort: false },
+};
+export const disputeReasonsRepository = new DisputeReasonsRepository();

package/dist/features/dispute-reasons/schemas/firestore.d.ts

@@ -0,0 +1,62 @@
+/**
+ * `disputeReasons` — the staff-curated list a buyer picks from when raising a
+ * dispute.
+ *
+ * ## What this is NOT
+ *
+ * 🛑 It is not policy. Every row carries a `kind`, and the GATE lives on the
+ * kind — see `_internal/shared/features/orders/dispute-reasons.ts`. A row can
+ * never introduce a new kind of claim, because a gate cannot branch on a
+ * user-created string.
+ *
+ * So this list is for TRIAGE and ANALYTICS: "what are buyers actually
+ * reporting", answered without reading free text. Staff (admin + employees)
+ * add rows as real gaps appear; buyers select only.
+ *
+ * ## Why staff-creatable rather than a closed enum
+ *
+ * Its sibling `RETURN_REASON` *is* a closed enum, and deliberately so: each
+ * member there decides whether a final sale can refuse the return, which is a
+ * money consequence that must be reviewed in code. Nothing here decides money.
+ * A support agent who keeps seeing "the courier left it at the wrong flat"
+ * should be able to add it without a release.
+ */
+import type { DisputeKind } from "../../../_internal/shared/features/orders/dispute-reasons";
+import type { BaseDocument } from "../../../_internal/shared/types/base-document";
+export declare const DISPUTE_REASON_COLLECTION = "disputeReasons";
+/** `id` is `dreason-<slug of label>`, so the same reason cannot be added twice. */
+export interface DisputeReasonDocument extends BaseDocument {
+    /** Buyer-facing. Shown verbatim in the picker. */
+    label: string;
+    /** Which gate this reason is subject to. Never free-form. */
+    kind: DisputeKind;
+    /**
+     * 🛑 Soft-retire, never delete.
+     *
+     * A past dispute names this reason. Deleting the row would orphan that
+     * record and take the author with it — and the order snapshots the LABEL
+     * precisely so history survives either way, but a deleted row still loses
+     * "who added this, and when" for anyone auditing the list itself.
+     */
+    isActive: boolean;
+    /** Display name, so a seller or agent can see whose wording this is. */
+    createdByName: string;
+    /** The uid, for moderation. Never rendered. */
+    createdByUid: string;
+}
+export declare const DISPUTE_REASON_FIELDS: {
+    readonly ID: "id";
+    readonly LABEL: "label";
+    readonly KIND: "kind";
+    readonly IS_ACTIVE: "isActive";
+    readonly CREATED_BY_UID: "createdByUid";
+    readonly CREATED_AT: "createdAt";
+};
+/**
+ * Bounds on a label.
+ *
+ * Short on purpose: this is a picker option, not the buyer's explanation. The
+ * detail goes in the free-text field on the dispute itself, which is where a
+ * buyer should describe what actually happened.
+ */
+export declare const DISPUTE_REASON_LABEL_MAX = 80;

package/dist/features/dispute-reasons/schemas/firestore.js

@@ -0,0 +1,40 @@
+/**
+ * `disputeReasons` — the staff-curated list a buyer picks from when raising a
+ * dispute.
+ *
+ * ## What this is NOT
+ *
+ * 🛑 It is not policy. Every row carries a `kind`, and the GATE lives on the
+ * kind — see `_internal/shared/features/orders/dispute-reasons.ts`. A row can
+ * never introduce a new kind of claim, because a gate cannot branch on a
+ * user-created string.
+ *
+ * So this list is for TRIAGE and ANALYTICS: "what are buyers actually
+ * reporting", answered without reading free text. Staff (admin + employees)
+ * add rows as real gaps appear; buyers select only.
+ *
+ * ## Why staff-creatable rather than a closed enum
+ *
+ * Its sibling `RETURN_REASON` *is* a closed enum, and deliberately so: each
+ * member there decides whether a final sale can refuse the return, which is a
+ * money consequence that must be reviewed in code. Nothing here decides money.
+ * A support agent who keeps seeing "the courier left it at the wrong flat"
+ * should be able to add it without a release.
+ */
+export const DISPUTE_REASON_COLLECTION = "disputeReasons";
+export const DISPUTE_REASON_FIELDS = {
+    ID: "id",
+    LABEL: "label",
+    KIND: "kind",
+    IS_ACTIVE: "isActive",
+    CREATED_BY_UID: "createdByUid",
+    CREATED_AT: "createdAt",
+};
+/**
+ * Bounds on a label.
+ *
+ * Short on purpose: this is a picker option, not the buyer's explanation. The
+ * detail goes in the free-text field on the dispute itself, which is where a
+ * buyer should describe what actually happened.
+ */
+export const DISPUTE_REASON_LABEL_MAX = 80;

package/dist/features/events/components/EventSaleBanner.js

@@ -16,5 +16,5 @@ export function EventSaleBanner({ discountPercent, couponCode, title, subtitle,
     const href = filterParam
         ? `${ROUTES.PUBLIC.PRODUCTS}?${encodeURIComponent(filterParam.key)}=${encodeURIComponent(filterParam.value)}`
         : `${ROUTES.PUBLIC.PRODUCTS}?onSale=true`;
-    return (_jsx(Section, { color: "inverse", tone: "accent-banner", className: `${__P.p6}`, rounded: "2xl", shadow: "lg", children: _jsxs(Stack, { gap: "md", children: [_jsxs(Stack, { gap: "xs", children: [_jsx(Heading, { level: 2, weight: "bold", size: "3xl", children: headline }), subtitle ? _jsx(Text, { color: "inverse-muted", size: "base", children: subtitle }) : null] }), couponCode ? (_jsxs(Div, { layout: "inline-flex", gap: "3", align: "center", className: "backdrop-blur", surface: "default", paddingY: "y-xs", paddingX: "x-md", rounded: "lg", children: [_jsx(Span, { size: "xs", className: "tracking-wide opacity-80", transform: "uppercase", children: "Code" }), _jsx(Span, { size: "lg", weight: "bold", className: "font-mono", children: couponCode })] })) : null, _jsx(Div, { children: _jsx(Link, { href: href, children: _jsx(Button, { variant: "secondary", children: "Shop the sale" }) }) })] }) }));
+    return (_jsx(Section, { color: "inverse", tone: "accent-banner", className: `${__P.p6}`, rounded: "2xl", shadow: "lg", children: _jsxs(Stack, { gap: "md", children: [_jsxs(Stack, { gap: "xs", children: [_jsx(Heading, { color: "inverse", variant: "none", level: 2, weight: "bold", size: "3xl", children: headline }), subtitle ? _jsx(Text, { color: "inverse-muted", size: "base", children: subtitle }) : null] }), couponCode ? (_jsxs(Div, { layout: "inline-flex", gap: "3", align: "center", className: "backdrop-blur", surface: "default", paddingY: "y-xs", paddingX: "x-md", rounded: "lg", children: [_jsx(Span, { size: "xs", className: "tracking-wide opacity-80", transform: "uppercase", children: "Code" }), _jsx(Span, { size: "lg", weight: "bold", className: "font-mono", children: couponCode })] })) : null, _jsx(Div, { children: _jsx(Link, { href: href, children: _jsx(Button, { variant: "secondary", children: "Shop the sale" }) }) })] }) }));
 }

package/dist/features/faq/components/FAQAccordion.d.ts

@@ -1,5 +1,6 @@
 import React from "react";
 import type { FAQ, FAQCategory } from "../types";
+import { type PublishedValues } from "../../../_internal/shared/content/published-values";
 export interface FAQAccordionProps {
     faqs: FAQ[];
     className?: string;
@@ -8,8 +9,19 @@ export interface FAQAccordionProps {
     labels?: {
         noResults?: string;
     };
+    /**
+     * Phase 9 — resolved published values, for `{{token}}` substitution in
+     * answers. Build them with `resolvePublishedValues(settings?.commissions)`
+     * at the page level and pass them down.
+     *
+     * 🛑 Passed in rather than read here. This component renders on the server
+     * and in the client, and a settings read inside a presentational component
+     * would both make it unusable in half the places it is needed and fire one
+     * read per accordion on a page that has several.
+     */
+    publishedValues?: PublishedValues;
 }
-export declare function FAQAccordion({ faqs, className, renderExpandedFooter, labels, }: FAQAccordionProps): React.JSX.Element;
+export declare function FAQAccordion({ faqs, className, renderExpandedFooter, labels, publishedValues, }: FAQAccordionProps): React.JSX.Element;
 interface FAQCategoryTabsProps {
     categories: FAQCategory[];
     active?: FAQCategory | null;

package/dist/features/faq/components/FAQAccordion.js

@@ -2,16 +2,41 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { useState } from "react";
 import { Button, Div, RichText, Row, Span, Tabs, TabsList, TabsTrigger, Text } from "../../../ui/index.js";
+/* Phase 9 — `publishedCopyKey`'s first reader. See the 🛑 at the render site. */
+import { resolvePublishedCopy, resolvePublishedValues, } from "../../../_internal/shared/content/published-values.js";
 import { RecordOwnerQuickActions } from "../../admin/components/RecordOwnerQuickActions.js";
-function FAQAccordionItem({ faq, isOpen, onToggle, renderExpandedFooter, }) {
-    return (_jsxs(Div, { className: "border-b border-neutral-200 last:border-0", children: [_jsxs(Button, { variant: "ghost", onClick: onToggle, "aria-expanded": isOpen, justify: "between", className: "w-full gap-[1rem] py-[1rem] text-left text-[0.875rem] font-[500] text-[var(--appkit-color-text)] dark:text-[var(--appkit-color-text)] transition hover:text-primary", children: [_jsx(Span, { children: faq.question }), _jsx(Span, { className: `flex-shrink-0 transition-transform ${isOpen ? "rotate-180" : ""}`, children: _jsx("svg", { width: "16", height: "16", viewBox: "0 0 16 16", fill: "none", "aria-hidden": "true", children: _jsx("path", { d: "M4 6l4 4 4-4", stroke: "currentColor", strokeWidth: "1.5", strokeLinecap: "round", strokeLinejoin: "round" }) }) })] }), isOpen && (_jsxs(Div, { textSize: "sm", className: "text-[var(--appkit-color-text-muted)]", padding: "b-md", children: [faq.tags && faq.tags.length > 0 && (_jsx(Row, { wrap: true, gap: "sm", className: "mb-3", children: faq.tags.map((tag) => (_jsx(Span, { className: "bg-[var(--appkit-color-surface)] py-[0.25rem] text-[var(--appkit-color-text-muted)]", rounded: "md", padding: "x-xs", size: "xs", children: tag }, tag))) })), faq.answer.format === "html" ? (_jsx(RichText, { html: faq.answer.text, className: "prose-sm" })) : (_jsx(Text, { className: "whitespace-pre-line", children: faq.answer.text })), _jsx(Row, { justify: "end", className: "mt-3", children: _jsx(RecordOwnerQuickActions, { resource: "FAQ", recordId: faq.id, placement: "detail", recordLabel: faq.question }) }), renderExpandedFooter?.(faq)] }))] }));
+/**
+ * Code-derived values, resolved once at module scope.
+ *
+ * ## 🛑 Why a DEFAULT rather than a required prop
+ *
+ * `resolvePublishedValues()` with no settings argument is PURE over code
+ * constants — the obligation policies, `LANE_CHECKOUT_WINDOW_MS`,
+ * `POINTS_EARN_PERCENT`. It reads no Firestore and touches no settings, so
+ * calling it here costs one object at import and cannot leak anything.
+ *
+ * That matters because there are FOUR mount sites (the FAQ page, the
+ * searchable list, the category highlights section, and this file's own
+ * loop). Requiring the prop would mean threading it through four callers and
+ * their callers — and the one that got missed would render `{{…}}` to a
+ * visitor. A default that always resolves the code-derived numbers, with an
+ * override for the settings-driven money ones, gets every surface right
+ * immediately.
+ *
+ * A caller WITH settings in hand should still pass them: without them the
+ * money values fall back to the schema defaults, which is correct but is not
+ * the admin's current configuration.
+ */
+const CODE_DERIVED_VALUES = resolvePublishedValues();
+function FAQAccordionItem({ faq, isOpen, onToggle, renderExpandedFooter, publishedValues = CODE_DERIVED_VALUES, }) {
+    return (_jsxs(Div, { className: "border-b border-neutral-200 last:border-0", children: [_jsxs(Button, { variant: "ghost", onClick: onToggle, "aria-expanded": isOpen, justify: "between", className: "w-full gap-[1rem] py-[1rem] text-left text-[0.875rem] font-[500] text-[var(--appkit-color-text)] dark:text-[var(--appkit-color-text)] transition hover:text-primary", children: [_jsx(Span, { children: faq.question }), _jsx(Span, { className: `flex-shrink-0 transition-transform ${isOpen ? "rotate-180" : ""}`, children: _jsx("svg", { width: "16", height: "16", viewBox: "0 0 16 16", fill: "none", "aria-hidden": "true", children: _jsx("path", { d: "M4 6l4 4 4-4", stroke: "currentColor", strokeWidth: "1.5", strokeLinecap: "round", strokeLinejoin: "round" }) }) })] }), isOpen && (_jsxs(Div, { textSize: "sm", className: "text-[var(--appkit-color-text-muted)]", padding: "b-md", children: [faq.tags && faq.tags.length > 0 && (_jsx(Row, { wrap: true, gap: "sm", className: "mb-3", children: faq.tags.map((tag) => (_jsx(Span, { className: "bg-[var(--appkit-color-surface)] py-[0.25rem] text-[var(--appkit-color-text-muted)]", rounded: "md", padding: "x-xs", size: "xs", children: tag }, tag))) })), faq.answer.format === "html" ? (_jsx(RichText, { html: resolvePublishedCopy(faq.answer.text, publishedValues), className: "prose-sm" })) : (_jsx(Text, { className: "whitespace-pre-line", children: resolvePublishedCopy(faq.answer.text, publishedValues) })), _jsx(Row, { justify: "end", className: "mt-3", children: _jsx(RecordOwnerQuickActions, { resource: "FAQ", recordId: faq.id, placement: "detail", recordLabel: faq.question }) }), renderExpandedFooter?.(faq)] }))] }));
 }
-export function FAQAccordion({ faqs, className = "", renderExpandedFooter, labels, }) {
+export function FAQAccordion({ faqs, className = "", renderExpandedFooter, labels, publishedValues, }) {
     const [openId, setOpenId] = useState(null);
     if (faqs.length === 0 && labels?.noResults) {
         return (_jsx(Div, { surface: "card", padding: "xl", className: "text-center", children: _jsx(Text, { className: "text-[var(--appkit-color-text-muted)]", children: labels.noResults }) }));
     }
-    return (_jsx(Div, { surface: "card", className: `divide-y divide-neutral-100 divide-[var(--appkit-color-border)] ${className}`, padding: "x-md", children: faqs.map((faq) => (_jsx(FAQAccordionItem, { faq: faq, isOpen: openId === faq.id, onToggle: () => setOpenId(openId === faq.id ? null : faq.id), renderExpandedFooter: renderExpandedFooter }, faq.id))) }));
+    return (_jsx(Div, { surface: "card", className: `divide-y divide-neutral-100 divide-[var(--appkit-color-border)] ${className}`, padding: "x-md", children: faqs.map((faq) => (_jsx(FAQAccordionItem, { faq: faq, isOpen: openId === faq.id, onToggle: () => setOpenId(openId === faq.id ? null : faq.id), renderExpandedFooter: renderExpandedFooter, publishedValues: publishedValues }, faq.id))) }));
 }
 const ALL_TAB_VALUE = "__all__";
 export function FAQCategoryTabs({ categories, active, onSelect, labels = {}, }) {

package/dist/features/faq/components/FAQPageContent.js

@@ -45,12 +45,12 @@ export function FAQPageContent({ initialCategory = "all", categories, routeHelpe
                     total,
                     categoryCounts,
                     onSelect: handleCategorySelect,
-                }) }), _jsxs(Div, { layout: "grid", gap: "8", className: "grid-cols-1 lg:grid-cols-12", children: [_jsx(Div, { className: "hidden lg:col-span-4 lg:block xl:col-span-3", children: _jsx(FAQCategorySidebar, { selectedCategory: selectedCategory, onCategorySelect: handleCategorySelect, categoryCounts: categoryCounts, categories: categories, allFaqsHref: routeHelpers.allFaqsHref, categoryHref: routeHelpers.faqCategoryHref, contactHref: routeHelpers.contactHref, labels: {
+                }) }), _jsxs(Div, { layout: "grid", gap: "8", className: "lg:grid-cols-12", children: [_jsx(Div, { className: "hidden lg:col-span-4 lg:block xl:col-span-3", children: _jsx(FAQCategorySidebar, { selectedCategory: selectedCategory, onCategorySelect: handleCategorySelect, categoryCounts: categoryCounts, categories: categories, allFaqsHref: routeHelpers.allFaqsHref, categoryHref: routeHelpers.faqCategoryHref, contactHref: routeHelpers.contactHref, labels: {
                                 title: labels.categoriesTitle,
                                 allFaqs: labels.allFaqs,
                                 stillHaveQuestions: labels.stillHaveQuestions,
                                 contactSupport: labels.contactSupport,
-                            } }) }), _jsxs(Div, { className: "col-span-1 lg:col-span-8 xl:col-span-9", children: [_jsx(SlottedListingView, { portal: "public", inlineToolbar: true, className: "space-y-6", renderHeader: () => {
+                            } }) }), _jsxs(Div, { className: "lg:col-span-8 xl:col-span-9", children: [_jsx(SlottedListingView, { portal: "public", inlineToolbar: true, className: "space-y-6", renderHeader: () => {
                                     /*
                                      * The fuller answer, next to the short ones.
                                      *

package/dist/features/gateway-events/schemas/index.d.ts

@@ -44,13 +44,13 @@ export declare const gatewayEventFirestoreSchema: z.ZodObject<{
     terminal?: boolean | undefined;
     amount?: number | undefined;
     seedPurpose?: string | undefined;
+    payload?: Record<string, unknown> | undefined;
     orderIds?: string[] | undefined;
     processedAt?: Date | undefined;
     gatewayPaymentId?: string | undefined;
     gatewayOrderId?: string | undefined;
     providerEventId?: string | undefined;
     lastError?: string | undefined;
-    payload?: Record<string, unknown> | undefined;
     payloadTruncated?: boolean | undefined;
 }, {
     status: "received" | "failed" | "processed" | "processing" | "conflict" | "ignored";
@@ -69,13 +69,13 @@ export declare const gatewayEventFirestoreSchema: z.ZodObject<{
     terminal?: boolean | undefined;
     amount?: number | undefined;
     seedPurpose?: string | undefined;
+    payload?: Record<string, unknown> | undefined;
     orderIds?: string[] | undefined;
     processedAt?: Date | undefined;
     gatewayPaymentId?: string | undefined;
     gatewayOrderId?: string | undefined;
     providerEventId?: string | undefined;
     lastError?: string | undefined;
-    payload?: Record<string, unknown> | undefined;
     payloadTruncated?: boolean | undefined;
 }>;
 export type GatewayEventFromSchema = z.infer<typeof gatewayEventFirestoreSchema>;

package/dist/features/homepage/schemas/index.d.ts

@@ -867,16 +867,16 @@ export declare const carouselSlideFirestoreSchema: z.ZodObject<{
         opacity?: number | undefined;
         subtitle?: string | undefined;
     } | undefined;
+    settings?: {
+        height?: "medium" | "viewport" | "tall" | undefined;
+        autoplayDelayMs?: number | undefined;
+    } | undefined;
     analytics?: {
         views: number;
         lastViewed?: string | Date | z.objectOutputType<{
             toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
         }, z.ZodTypeAny, "passthrough"> | undefined;
     } | undefined;
-    settings?: {
-        height?: "medium" | "viewport" | "tall" | undefined;
-        autoplayDelayMs?: number | undefined;
-    } | undefined;
     carouselId?: string | null | undefined;
 }, {
     id: string;
@@ -976,16 +976,16 @@ export declare const carouselSlideFirestoreSchema: z.ZodObject<{
         opacity?: number | undefined;
         subtitle?: string | undefined;
     } | undefined;
+    settings?: {
+        height?: "medium" | "viewport" | "tall" | undefined;
+        autoplayDelayMs?: number | undefined;
+    } | undefined;
     analytics?: {
         views: number;
         lastViewed?: string | Date | z.objectInputType<{
             toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
         }, z.ZodTypeAny, "passthrough"> | undefined;
     } | undefined;
-    settings?: {
-        height?: "medium" | "viewport" | "tall" | undefined;
-        autoplayDelayMs?: number | undefined;
-    } | undefined;
     carouselId?: string | null | undefined;
 }>;
 export type HomepageSectionFromSchema = z.infer<typeof homepageSectionFirestoreSchema>;