@mohasinac/appkit 4.14.0 → 4.16.0

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

@@ -2,14 +2,14 @@
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 import { normalizeError } from "../../../errors/normalize";
 import { useApiMutation } from "@mohasinac/appkit/client";
-import React, { useEffect, useMemo } from "react";
-import { z } from "zod";
+import React, { useEffect } from "react";
 import { useQuery } from "@tanstack/react-query";
 import { Alert, Button, Div, Grid, Heading, Input, Label, RichTextEditor, Row, Select, Stack, StackedViewShell, TagInput, Text, Textarea, Toggle, } from "../../../ui";
 import { FormShellContext, useFormShellState, applyZodIssues, FormErrorSummary } from "../../../ui/forms";
 import { apiClient } from "../../../http";
 import { ADMIN_ENDPOINTS } from "../../../constants/api-endpoints";
-import { StepForm } from "../../shell";
+import { SectionForm, useSectionFormNav } from "../../shell";
+import { eventDraftSchema } from "../schemas/event-form";
 import { ProductInlineSelect } from "../../seller/components/ProductInlineSelect";
 import { CouponInlineSelect } from "../../seller/components/CouponInlineSelect";
 // Covers the cross-type required fields plus the two conditional rules the
@@ -19,27 +19,6 @@ import { CouponInlineSelect } from "../../seller/components/CouponInlineSelect";
 // form-builder arrays, raffle/spin config) are deliberately left unvalidated
 // — modeling their full conditional shape correctly would need much deeper
 // per-type domain rules than this pass is scoped for.
-const eventDraftSchema = z.object({
-    type: z.string(),
-    title: z.string().min(1, "Title is required"),
-    startsAt: z.string().min(1, "Start date is required"),
-    endsAt: z.string().min(1, "End date is required"),
-    couponId: z.string(),
-    displayCode: z.string(),
-    pollOptions: z.array(z.object({ id: z.string(), label: z.string() })),
-}).passthrough().superRefine((v, ctx) => {
-    if (v.type === "offer") {
-        if (!v.couponId.trim()) {
-            ctx.addIssue({ code: z.ZodIssueCode.custom, path: ["couponId"], message: "Coupon is required for offer events" });
-        }
-        if (!v.displayCode.trim()) {
-            ctx.addIssue({ code: z.ZodIssueCode.custom, path: ["displayCode"], message: "Display code is required for offer events" });
-        }
-    }
-    if (v.type === "poll" && v.pollOptions.filter((o) => o.label.trim()).length < 2) {
-        ctx.addIssue({ code: z.ZodIssueCode.custom, path: ["pollOptions"], message: "Poll events require at least 2 options" });
-    }
-});
 const __P = {
     p4: "p-[var(--appkit-space-4)]",
 };
@@ -226,7 +205,6 @@ export function AdminEventEditorView({ eventId, onSaved, embedded, allowedTypes,
     const isEdit = Boolean(eventId);
     const [draft, setDraft] = React.useState(DEFAULT_DRAFT);
     const [slugManual, setSlugManual] = React.useState(false);
-    const [currentStep, setCurrentStep] = React.useState(0);
     const [saveMessage, setSaveMessage] = React.useState(null);
     const [triggerMessage, setTriggerMessage] = React.useState(null);
     const [raffleWinnerName, setRaffleWinnerName] = React.useState("");
@@ -358,44 +336,49 @@ export function AdminEventEditorView({ eventId, onSaved, embedded, allowedTypes,
     });
     const isLoading = saveMutation.isPending || eventQuery.isLoading;
     // --- steps ---
-    const steps = [
+    /**
+     * Sections, not steps — every field reachable at once, one submit at the
+     * bottom. The old wizard gated Settings behind Details validating, so a
+     * missing end date made an event's poll options unreachable.
+     *
+     * Ids match the schema's `section` annotations exactly, which is what lets
+     * `<FormErrorSummary>` jump to the right panel.
+     */
+    const sections = [
         {
+            id: "details",
+            required: true,
+            quick: true,
             label: "Details",
             fields: ["type", "title", "slug", "description", "startsAt", "endsAt", "tags"],
-            validate: (values) => {
-                if (!values.title.trim())
-                    return "Title is required";
-                if (!values.startsAt)
-                    return "Start date is required";
-                if (!values.endsAt)
-                    return "End date is required";
-                return null;
-            },
+            // The per-step `validate` is gone: every rule it stated is already in
+            // eventDraftSchema (title/startsAt/endsAt are .min(1)), and it only ever
+            // acted as a gate to the next step.
             render: ({ values, onChange }) => (_jsxs(Stack, { gap: "md", children: [_jsx(Heading, { level: 3, className: "mb-2", children: "Event Details" }), !isEdit && (_jsx(Select, { label: "Event type", value: values.type, options: allowedTypes ? EVENT_TYPE_OPTIONS.filter((o) => allowedTypes.includes(o.value)) : EVENT_TYPE_OPTIONS, onChange: (e) => onChange({ type: e.target.value }) })), _jsx(Input, { label: "Title", value: values.title, onChange: (e) => {
                             const v = e.target.value;
                             onChange({ title: v, ...(!slugManual && { slug: toEventSlug(v) }) });
                         }, placeholder: "Charizard Flash Sale 2026", required: true }), _jsx(Input, { label: "Slug", value: values.slug, onChange: (e) => { setSlugManual(true); onChange({ slug: e.target.value }); }, placeholder: "event-charizard-flash-sale-2026", helperText: "Auto-generated from title. Must start with 'event-'." }), _jsxs(Stack, { gap: "xs", children: [_jsx(Label, { children: "Description" }), _jsx(RichTextEditor, { value: values.description, onChange: (v) => onChange({ description: v }), minHeightClassName: "min-h-[120px]", placeholder: "Describe this event\u2026" })] }), _jsxs(Grid, { cols: 2, gap: "sm", children: [_jsx(Input, { label: "Starts at", type: "datetime-local", value: values.startsAt, onChange: (e) => onChange({ startsAt: e.target.value }), required: true }), _jsx(Input, { label: "Ends at", type: "datetime-local", value: values.endsAt, onChange: (e) => onChange({ endsAt: e.target.value }), required: true })] }), _jsx(TagInput, { label: "Tags", value: values.tags, onChange: (t) => onChange({ tags: t }), placeholder: "e.g. pokemon, sale, 2026" })] })),
         },
         {
+            id: "media",
             label: "Media",
+            // <Collapse> unmounts its children — without this, collapsing the
+            // section mid-upload discards the transfer.
+            keepMounted: true,
             fields: ["coverImageUrl"],
             render: ({ values, onChange }) => (_jsxs(Stack, { gap: "md", children: [_jsx(Heading, { level: 3, className: "mb-2", children: "Media" }), _jsx(Input, { label: "Cover Image URL (optional)", value: values.coverImageUrl, onChange: (e) => onChange({ coverImageUrl: e.target.value }), placeholder: "https://\u2026", helperText: "Direct link to the event cover image." })] })),
         },
         {
+            id: "settings",
             label: "Settings",
             fields: ["status", "allowGuestParticipation", "discountPercent", "saleBannerText", "couponId", "displayCode", "offerBannerText", "pollOptions", "resultsVisibility", "allowMultiSelect", "allowComment", "maxEntriesPerUser", "hasLeaderboard", "hasPointSystem", "pointsLabel", "entryReviewRequired", "surveyFields", "anonymous", "feedbackFields"],
-            validate: (values) => {
-                if (values.type === "offer" && !values.couponId.trim())
-                    return "Coupon ID is required for offer events";
-                if (values.type === "offer" && !values.displayCode.trim())
-                    return "Display code is required for offer events";
-                if (values.type === "poll" && values.pollOptions.filter((o) => o.label.trim()).length < 2)
-                    return "Poll events require at least 2 options";
-                return null;
-            },
+            // Same: the offer-coupon, offer-display-code and poll-minimum-options
+            // rules are all stated in eventDraftSchema's superRefine, which now
+            // surfaces them inline on the field instead of as a step-blocking banner.
             render: ({ values, onChange }) => (_jsxs(Stack, { gap: "md", children: [_jsx(Heading, { level: 3, className: "mb-2", children: "Event Settings" }), isEdit && (_jsx(Select, { label: "Status", value: values.status, options: EVENT_STATUS_OPTIONS, onChange: (e) => onChange({ status: e.target.value }) })), values.createdBy && (_jsxs(Stack, { gap: "none", children: [_jsx(Text, { size: "sm", weight: "medium", className: "mb-1", children: "Created by" }), _jsx(Text, { size: "sm", color: "muted", children: values.createdBy })] })), _jsxs(Stack, { gap: "xs", surface: "muted", rounded: "lg", border: "default", padding: "sm", children: [_jsx(Toggle, { checked: values.allowGuestParticipation, onChange: (v) => onChange({ allowGuestParticipation: v }), label: "Allow guest participation (no login required)" }), _jsx(Text, { size: "xs", color: "muted", children: "When enabled, unauthenticated visitors can participate in this event (poll vote, survey/feedback response, raffle entry, or wheel spin), identified by a hashed IP address instead of an account. Applies uniformly to whatever entry mechanism this event type uses." })] }), values.type === "sale" && (_jsxs(Stack, { gap: "xs", surface: "muted", rounded: "lg", border: "default", padding: "sm", children: [_jsx(Text, { size: "sm", weight: "semibold", color: "muted", children: "Sale configuration" }), _jsxs(Grid, { cols: 2, gap: "sm", children: [_jsx(Input, { label: "Discount %", type: "number", value: values.discountPercent, onChange: (e) => onChange({ discountPercent: e.target.value }), placeholder: "10" }), _jsx(Input, { label: "Banner text (optional)", value: values.saleBannerText, onChange: (e) => onChange({ saleBannerText: e.target.value }), placeholder: "Limited time \u2014 ends Sunday!" })] })] })), values.type === "offer" && (_jsxs(Stack, { gap: "xs", surface: "muted", rounded: "lg", border: "default", padding: "sm", children: [_jsx(Text, { size: "sm", weight: "semibold", color: "muted", children: "Offer configuration" }), _jsxs(Grid, { cols: 2, gap: "sm", children: [_jsxs(Div, { children: [_jsx(Text, { size: "sm", weight: "medium", className: "mb-1", children: "Coupon" }), _jsx(CouponInlineSelect, { scope: "admin", value: values.couponId, onChange: (id) => onChange({ couponId: id ?? "" }), placeholder: "Search coupons\u2026", allowCreate: false })] }), _jsx(Input, { label: "Display code", value: values.displayCode, onChange: (e) => onChange({ displayCode: e.target.value }), placeholder: "CHARIZARD25", required: true })] }), _jsx(Input, { label: "Banner text (optional)", value: values.offerBannerText, onChange: (e) => onChange({ offerBannerText: e.target.value }), placeholder: "Use CHARIZARD25 at checkout" })] })), values.type === "poll" && (_jsxs(Stack, { gap: "md", rounded: "xl", border: "default", padding: "md", children: [_jsx(Text, { size: "sm", weight: "semibold", color: "muted", children: "Poll configuration" }), _jsxs(Stack, { gap: "xs", children: [_jsx(Text, { size: "xs", color: "muted", children: "Options (minimum 2)" }), values.pollOptions.map((opt, idx) => (_jsxs(Row, { gap: "xs", children: [_jsx(Div, { className: "flex-1", children: _jsx(Input, { value: opt.label, onChange: (e) => onChange({ pollOptions: values.pollOptions.map((o) => o.id === opt.id ? { ...o, label: e.target.value } : o) }), placeholder: `Option ${idx + 1}` }) }), values.pollOptions.length > 2 && (_jsx(Button, { variant: "ghost", type: "button", onClick: () => onChange({ pollOptions: values.pollOptions.filter((o) => o.id !== opt.id) }), className: CLS_REMOVE_BTN_PX2, "aria-label": "Remove option", children: "\u00D7" }))] }, opt.id))), _jsx(Button, { type: "button", variant: "outline", size: "sm", onClick: () => onChange({ pollOptions: [...values.pollOptions, { id: `opt${Date.now()}`, label: "" }] }), children: "+ Add option" })] }), _jsx(Select, { label: "Results visibility", value: values.resultsVisibility, options: POLL_VISIBILITY_OPTIONS, onChange: (e) => onChange({ resultsVisibility: e.target.value }) }), _jsxs(Stack, { gap: "sm", children: [_jsx(Toggle, { checked: values.allowMultiSelect, onChange: (v) => onChange({ allowMultiSelect: v }), label: "Allow multi-select" }), _jsx(Toggle, { checked: values.allowComment, onChange: (v) => onChange({ allowComment: v }), label: "Allow comment with vote" })] })] })), values.type === "survey" && (_jsxs(Stack, { gap: "md", rounded: "xl", border: "default", padding: "md", children: [_jsx(Text, { size: "sm", weight: "semibold", color: "muted", children: "Survey configuration" }), _jsxs(Grid, { cols: 2, gap: "sm", children: [_jsx(Input, { label: "Max entries per user", type: "number", value: values.maxEntriesPerUser, onChange: (e) => onChange({ maxEntriesPerUser: e.target.value }), placeholder: "1" }), values.hasPointSystem && (_jsx(Input, { label: "Points label", value: values.pointsLabel, onChange: (e) => onChange({ pointsLabel: e.target.value }), placeholder: "Points" }))] }), _jsxs(Stack, { gap: "xs", children: [_jsx(Toggle, { checked: values.requireLogin, onChange: (v) => onChange({ requireLogin: v }), label: "Require login to participate" }), _jsx(Toggle, { checked: values.hasLeaderboard, onChange: (v) => onChange({ hasLeaderboard: v }), label: "Show leaderboard" }), _jsx(Toggle, { checked: values.hasPointSystem, onChange: (v) => onChange({ hasPointSystem: v }), label: "Enable point system" }), _jsx(Toggle, { checked: values.entryReviewRequired, onChange: (v) => onChange({ entryReviewRequired: v }), label: "Require employee review before entry is approved" })] }), _jsx(FormFieldBuilder, { fields: values.surveyFields, setFields: (f) => onChange({ surveyFields: f }) })] })), values.type === "feedback" && (_jsxs(Stack, { gap: "md", rounded: "xl", border: "default", padding: "md", children: [_jsx(Text, { size: "sm", weight: "semibold", color: "muted", children: "Feedback configuration" }), _jsx(Toggle, { checked: values.anonymous, onChange: (v) => onChange({ anonymous: v }), label: "Allow anonymous submissions" }), _jsx(FormFieldBuilder, { fields: values.feedbackFields, setFields: (f) => onChange({ feedbackFields: f }) })] }))] })),
         },
         {
+            id: "raffle",
             label: "Raffle / Spin",
             fields: ["hasRaffle", "raffleType", "raffleTopN", "rafflePrize", "rafflePrizeCouponId", "rafflePrizeProductIds", "spinPrizes", "spinMaxPerUser", "spinWindowStart", "spinWindowEnd"],
             render: ({ values, onChange }) => {
@@ -407,16 +390,11 @@ export function AdminEventEditorView({ eventId, onSaved, embedded, allowedTypes,
         },
     ];
     const alertSection = eventQuery.error ? (_jsx(Alert, { variant: "error", title: "Could not load event", children: eventQuery.error instanceof Error ? eventQuery.error.message : "Unknown error" })) : null;
-    const fieldToStepIndex = useMemo(() => {
-        const map = {};
-        steps.forEach((step, i) => {
-            step.fields?.forEach((field) => { map[field] = i; });
-        });
-        return map;
-        // eslint-disable-next-line react-hooks/exhaustive-deps
-    }, [steps.length]);
-    const wizardShellCtx = useMemo(() => ({ ...shellCtx, fieldToStepIndex, goToStep: (n) => setCurrentStep(n) }), [shellCtx, fieldToStepIndex, setCurrentStep]);
-    const formContent = (_jsxs(Stack, { gap: "sm", children: [alertSection, _jsxs(FormShellContext.Provider, { value: wizardShellCtx, children: [_jsx(FormErrorSummary, {}), _jsx(StepForm, { steps: steps, values: draft, onChange: update, onComplete: () => { saveMutation.mutate(); }, formId: "admin-event", currentStep: currentStep, onStepChange: setCurrentStep, completeLabel: isEdit ? "Save Changes" : "Create Event", isLoading: isLoading })] }), saveMessage && (_jsx(Alert, { variant: saveMessage.toLowerCase().includes("fail") || saveMessage.toLowerCase().includes("error") ? "error" : "success", title: "Save status", children: saveMessage }))] }));
+    // Replaces the hand-rolled fieldToStepIndex + goToStep pair. The hook owns
+    // the expand-then-scroll ordering a raw setState cannot: a collapsed panel
+    // must MOUNT before scrollIntoView and focus can reach the offending field.
+    const { openIds, setOpenIds, goToSection, fieldToSectionIndex, sectionMeta } = useSectionFormNav(sections, draft);
+    const formContent = (_jsxs(Stack, { gap: "sm", children: [alertSection, _jsxs(FormShellContext.Provider, { value: shellCtx, children: [_jsx(FormErrorSummary, {}), _jsx(SectionForm, { sections: sections, values: draft, onChange: update, onSubmit: () => { saveMutation.mutate(); }, schema: eventDraftSchema, openIds: openIds, onOpenChange: setOpenIds, submitLabel: isEdit ? "Save Changes" : "Create Event", isLoading: isLoading })] }), saveMessage && (_jsx(Alert, { variant: saveMessage.toLowerCase().includes("fail") || saveMessage.toLowerCase().includes("error") ? "error" : "success", title: "Save status", children: saveMessage }))] }));
     if (embedded) {
         return _jsx(Div, { className: `${__O.yAuto} ${__P.p4}`, children: formContent });
     }

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

@@ -1,9 +1,9 @@
 "use client";
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 import { useApiMutation, sieveFilter, SIEVE_OP, sortBy } from "@mohasinac/appkit/client";
-import React from "react";
+import React, { useState } from "react";
 import { useQuery, useQueryClient } from "@tanstack/react-query";
-import { Alert, Button, Div, Input, Row, Select, Stack, Text, useToast } from "../../../ui";
+import { Alert, Button, Div, Input, Row, Select, Stack, Text, useToast, RecordDetailModal, } from "../../../ui";
 import { apiClient } from "../../../http";
 import { normalizeError } from "../../../errors/normalize";
 import { ACTIONS } from "../../../_internal/shared/actions/action-registry";
@@ -128,6 +128,10 @@ export function AdminEventEntriesView({ eventId, entriesEndpoint, entryReviewEnd
         },
     ];
     const eventTitle = statsQuery.data?.event?.title;
+    // Approve / Waitlist / Cancel were offered on an entry the admin could never
+    // read — the poll vote, the comment and the survey answers were all invisible
+    // (Root Cause #56, "acting blind"). The row already carries the whole entry.
+    const [detail, setDetail] = useState(null);
     const config = {
         portal: "admin",
         title: eventTitle ? `${eventTitle} Entries` : "Event Entries",
@@ -139,6 +143,7 @@ export function AdminEventEntriesView({ eventId, entriesEndpoint, entryReviewEnd
         endpoint: resolvedEntriesEndpoint,
         sortOptions: [{ value: sortBy("submittedAt", "DESC"), label: "Most recent" }],
         columns,
+        onRowClick: (row) => setDetail(row),
         mapRows: (response) => response.items ?? [],
         getTotal: (response) => response.total ?? (response.items ?? []).length,
         buildFilters: (state) => state.reviewStatus ? sieveFilter("reviewStatus", SIEVE_OP.EQ, state.reviewStatus) : undefined,
@@ -146,5 +151,19 @@ export function AdminEventEntriesView({ eventId, entriesEndpoint, entryReviewEnd
         toolbarExtra: eventId ? (_jsx(Button, { variant: "ghost", action: ACTIONS.ADMIN["export-event-entries"], onClick: handleExportReport })) : undefined,
         renderAboveContent: () => (_jsxs(Stack, { gap: "3", className: "px-[var(--appkit-space-3)] pb-[var(--appkit-space-2)]", children: [!eventId ? (_jsx(Alert, { variant: "warning", title: "Missing event id", children: "Event id is required to load entries." })) : null, statsQuery.error ? (_jsx(Alert, { variant: "error", title: "Could not load event stats", children: statsQuery.error instanceof Error ? statsQuery.error.message : "Unknown error" })) : null, _jsxs(Div, { layout: "grid", gap: "3", className: "grid-cols-1 sm:grid-cols-3", children: [_jsx(Alert, { variant: "info", title: "Total entries", children: String(statsQuery.data?.stats?.totalEntries ?? 0) }), _jsx(Alert, { variant: "success", title: "Approved", children: String(statsQuery.data?.stats?.approvedEntries ?? 0) }), _jsx(Alert, { variant: "warning", title: "Flagged", children: String(statsQuery.data?.stats?.flaggedEntries ?? 0) })] })] })),
     };
-    return _jsx(DataListingView, { config: config });
+    return (_jsxs(_Fragment, { children: [_jsx(DataListingView, { config: config }), _jsx(RecordDetailModal, { isOpen: detail !== null, onClose: () => setDetail(null), title: detail?.userDisplayName || detail?.userEmail || "Entry", badges: detail ? [{ label: detail.reviewStatus }] : undefined, description: detail?.pollComment, fields: detail
+                    ? [
+                        { label: "Entrant", value: detail.userDisplayName ?? detail.userId ?? "—" },
+                        { label: "Email", value: detail.userEmail ?? "—" },
+                        { label: "Review status", value: detail.reviewStatus },
+                        { label: "Points", value: detail.points != null ? String(detail.points) : "—" },
+                        { label: "Raffle eligible", value: detail.raffleEligible ? "Yes" : "No" },
+                        { label: "Poll votes", value: detail.pollVotes?.join(", ") || "—" },
+                        { label: "Reviewed by", value: detail.reviewedBy ?? "—" },
+                        { label: "Review note", value: detail.reviewNote ?? "—" },
+                        { label: "Entry ID", value: detail.id },
+                    ]
+                    : undefined, 
+                // The survey/feedback answers — the actual submission being judged.
+                metadata: detail?.formResponses })] }));
 }

package/dist/features/events/schemas/event-form.d.ts

@@ -0,0 +1,113 @@
+import { z } from "zod";
+/**
+ * ## `.passthrough()` STAYS here, deliberately
+ *
+ * `EventDraft` carries ~40 fields; this schema names seven. The blog form's
+ * equivalent was safe to tighten because its draft had fourteen fields and all
+ * fourteen could be named in one sitting. This one cannot: most of its fields
+ * are per-event-type (poll options, survey fields, spin prizes, raffle config)
+ * and only apply under a `type` discriminator, so naming them correctly means
+ * modelling the discriminated union rather than listing keys.
+ *
+ * Tightening it blind is the single most dangerous edit available in this
+ * codebase — `z.object()` strips unknown keys, so every field this schema
+ * failed to name would vanish from the draft the moment passthrough came off.
+ * That is exactly how `productBaseSchema` came to eat every `classified*` /
+ * `digitalCode*` / `liveItem*` / `prize*` field.
+ *
+ * The wire payload is NOT at risk either way: it is built explicitly below
+ * (`type`, `title`, `slug`, … plus `buildEventTypeConfig` /
+ * `buildEventRaffleFields`), never by spreading the draft.
+ *
+ * Prerequisite for removing it: a FULL-collection `roundtrip-diff --entity
+ * event --full`, not a sample — per the data-integrity protocol.
+ *
+ * 🛑 `annotate()` must be the OUTERMOST call on each field — it keys a WeakMap
+ * by schema instance and every zod wrapper returns a new one.
+ */
+export declare const eventDraftSchema: z.ZodEffects<z.ZodObject<{
+    type: z.ZodString;
+    title: z.ZodString;
+    startsAt: z.ZodString;
+    endsAt: z.ZodString;
+    couponId: z.ZodString;
+    displayCode: z.ZodString;
+    pollOptions: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        label: string;
+    }, {
+        id: string;
+        label: string;
+    }>, "many">;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    type: z.ZodString;
+    title: z.ZodString;
+    startsAt: z.ZodString;
+    endsAt: z.ZodString;
+    couponId: z.ZodString;
+    displayCode: z.ZodString;
+    pollOptions: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        label: string;
+    }, {
+        id: string;
+        label: string;
+    }>, "many">;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    type: z.ZodString;
+    title: z.ZodString;
+    startsAt: z.ZodString;
+    endsAt: z.ZodString;
+    couponId: z.ZodString;
+    displayCode: z.ZodString;
+    pollOptions: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        label: string;
+    }, {
+        id: string;
+        label: string;
+    }>, "many">;
+}, z.ZodTypeAny, "passthrough">>, z.objectOutputType<{
+    type: z.ZodString;
+    title: z.ZodString;
+    startsAt: z.ZodString;
+    endsAt: z.ZodString;
+    couponId: z.ZodString;
+    displayCode: z.ZodString;
+    pollOptions: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        label: string;
+    }, {
+        id: string;
+        label: string;
+    }>, "many">;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    type: z.ZodString;
+    title: z.ZodString;
+    startsAt: z.ZodString;
+    endsAt: z.ZodString;
+    couponId: z.ZodString;
+    displayCode: z.ZodString;
+    pollOptions: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        label: string;
+    }, {
+        id: string;
+        label: string;
+    }>, "many">;
+}, z.ZodTypeAny, "passthrough">>;

package/dist/features/events/schemas/event-form.js

@@ -0,0 +1,82 @@
+/*
+ * WHY: Same reason as the blog form schema — keeping it in the `.tsx` view
+ *      would have dragged a React component tree into every API route through
+ *      `SCHEMAS` -> `routeHandler`.
+ * WHAT: The event editor's form schema, with its UI metadata.
+ *
+ * EXPORTS:
+ *   eventDraftSchema
+ *
+ * @tag domain:events
+ * @tag layer:schema
+ * @tag pattern:none
+ * @tag access:isomorphic
+ * @tag consumers:AdminEventEditorView,SCHEMAS.forms
+ * @tag sideEffects:none
+ */
+import { z } from "zod";
+import { annotate } from "../../shell/field-ui-meta";
+/**
+ * ## `.passthrough()` STAYS here, deliberately
+ *
+ * `EventDraft` carries ~40 fields; this schema names seven. The blog form's
+ * equivalent was safe to tighten because its draft had fourteen fields and all
+ * fourteen could be named in one sitting. This one cannot: most of its fields
+ * are per-event-type (poll options, survey fields, spin prizes, raffle config)
+ * and only apply under a `type` discriminator, so naming them correctly means
+ * modelling the discriminated union rather than listing keys.
+ *
+ * Tightening it blind is the single most dangerous edit available in this
+ * codebase — `z.object()` strips unknown keys, so every field this schema
+ * failed to name would vanish from the draft the moment passthrough came off.
+ * That is exactly how `productBaseSchema` came to eat every `classified*` /
+ * `digitalCode*` / `liveItem*` / `prize*` field.
+ *
+ * The wire payload is NOT at risk either way: it is built explicitly below
+ * (`type`, `title`, `slug`, … plus `buildEventTypeConfig` /
+ * `buildEventRaffleFields`), never by spreading the draft.
+ *
+ * Prerequisite for removing it: a FULL-collection `roundtrip-diff --entity
+ * event --full`, not a sample — per the data-integrity protocol.
+ *
+ * 🛑 `annotate()` must be the OUTERMOST call on each field — it keys a WeakMap
+ * by schema instance and every zod wrapper returns a new one.
+ */
+export const eventDraftSchema = z.object({
+    type: annotate(z.string(), {
+        section: "details", sectionLabel: "Details", sectionRequired: true,
+        quick: true, order: 1, row: "pair", kind: "select",
+    }),
+    title: annotate(z.string().min(1, "Title is required"), {
+        section: "details", quick: true, order: 2, row: "full",
+    }),
+    startsAt: annotate(z.string().min(1, "Start date is required"), {
+        section: "details", quick: true, order: 3, row: "pair", kind: "date",
+    }),
+    endsAt: annotate(z.string().min(1, "End date is required"), {
+        section: "details", quick: true, order: 4, row: "pair", kind: "date",
+    }),
+    couponId: annotate(z.string(), {
+        section: "settings", sectionLabel: "Settings", order: 1, row: "pair",
+        help: "Required for offer events.",
+    }),
+    displayCode: annotate(z.string(), {
+        section: "settings", order: 2, row: "pair",
+        help: "Required for offer events.",
+    }),
+    pollOptions: annotate(z.array(z.object({ id: z.string(), label: z.string() })), {
+        section: "settings", order: 3, row: "full", kind: "list",
+    }),
+}).passthrough().superRefine((v, ctx) => {
+    if (v.type === "offer") {
+        if (!v.couponId.trim()) {
+            ctx.addIssue({ code: z.ZodIssueCode.custom, path: ["couponId"], message: "Coupon is required for offer events" });
+        }
+        if (!v.displayCode.trim()) {
+            ctx.addIssue({ code: z.ZodIssueCode.custom, path: ["displayCode"], message: "Display code is required for offer events" });
+        }
+    }
+    if (v.type === "poll" && v.pollOptions.filter((o) => o.label.trim()).length < 2) {
+        ctx.addIssue({ code: z.ZodIssueCode.custom, path: ["pollOptions"], message: "Poll events require at least 2 options" });
+    }
+});

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

@@ -943,10 +943,10 @@ export declare const eventItemSchema: z.ZodObject<{
     title: string;
     createdAt: string;
     updatedAt: string;
+    createdBy: string;
     description: string;
     startsAt: string;
     endsAt: string;
-    createdBy: string;
     stats: {
         totalEntries: number;
         approvedEntries: number;
@@ -1098,10 +1098,10 @@ export declare const eventItemSchema: z.ZodObject<{
     title: string;
     createdAt: string;
     updatedAt: string;
+    createdBy: string;
     description: string;
     startsAt: string;
     endsAt: string;
-    createdBy: string;
     stats: {
         totalEntries: number;
         approvedEntries: number;

package/dist/features/faq/actions/faq-actions.d.ts

@@ -27,10 +27,10 @@ export declare const faqCreateSchema: z.ZodEffects<z.ZodObject<{
     template: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     category: string;
+    priority: number;
     isActive: boolean;
     order: number;
     showOnHomepage: boolean;
-    priority: number;
     question: string;
     answer: {
         text: string;
@@ -51,11 +51,11 @@ export declare const faqCreateSchema: z.ZodEffects<z.ZodObject<{
         format?: "html" | "plain" | "markdown" | undefined;
     };
     template?: string | undefined;
+    priority?: number | undefined;
     tags?: string[] | undefined;
     isActive?: boolean | undefined;
     order?: number | undefined;
     showOnHomepage?: boolean | undefined;
-    priority?: number | undefined;
     showInFooter?: boolean | undefined;
     isPinned?: boolean | undefined;
     relatedFAQs?: string[] | undefined;
@@ -63,10 +63,10 @@ export declare const faqCreateSchema: z.ZodEffects<z.ZodObject<{
     variables?: Record<string, string> | undefined;
 }>, {
     category: string;
+    priority: number;
     isActive: boolean;
     order: number;
     showOnHomepage: boolean;
-    priority: number;
     question: string;
     answer: {
         text: string;
@@ -87,11 +87,11 @@ export declare const faqCreateSchema: z.ZodEffects<z.ZodObject<{
         format?: "html" | "plain" | "markdown" | undefined;
     };
     template?: string | undefined;
+    priority?: number | undefined;
     tags?: string[] | undefined;
     isActive?: boolean | undefined;
     order?: number | undefined;
     showOnHomepage?: boolean | undefined;
-    priority?: number | undefined;
     showInFooter?: boolean | undefined;
     isPinned?: boolean | undefined;
     relatedFAQs?: string[] | undefined;
@@ -125,11 +125,11 @@ export declare const faqUpdateSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     template?: string | undefined;
     category?: string | undefined;
+    priority?: number | undefined;
     tags?: string[] | undefined;
     isActive?: boolean | undefined;
     order?: number | undefined;
     showOnHomepage?: boolean | undefined;
-    priority?: number | undefined;
     question?: string | undefined;
     answer?: {
         text: string;
@@ -143,11 +143,11 @@ export declare const faqUpdateSchema: z.ZodObject<{
 }, {
     template?: string | undefined;
     category?: string | undefined;
+    priority?: number | undefined;
     tags?: string[] | undefined;
     isActive?: boolean | undefined;
     order?: number | undefined;
     showOnHomepage?: boolean | undefined;
-    priority?: number | undefined;
     question?: string | undefined;
     answer?: {
         text: string;

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

@@ -91,6 +91,7 @@ export declare const faqSchema: z.ZodObject<{
     };
     createdAt?: string | undefined;
     updatedAt?: string | undefined;
+    priority?: number | undefined;
     tags?: string[] | undefined;
     isActive?: boolean | undefined;
     order?: number | undefined;
@@ -100,7 +101,6 @@ export declare const faqSchema: z.ZodObject<{
         notHelpful?: number | undefined;
     } | undefined;
     showOnHomepage?: boolean | undefined;
-    priority?: number | undefined;
     showInFooter?: boolean | undefined;
     isPinned?: boolean | undefined;
     relatedFAQs?: string[] | undefined;
@@ -117,6 +117,7 @@ export declare const faqSchema: z.ZodObject<{
     };
     createdAt?: string | undefined;
     updatedAt?: string | undefined;
+    priority?: number | undefined;
     tags?: string[] | undefined;
     isActive?: boolean | undefined;
     order?: number | undefined;
@@ -126,7 +127,6 @@ export declare const faqSchema: z.ZodObject<{
         notHelpful?: number | undefined;
     } | undefined;
     showOnHomepage?: boolean | undefined;
-    priority?: number | undefined;
     showInFooter?: boolean | undefined;
     isPinned?: boolean | undefined;
     relatedFAQs?: string[] | undefined;
@@ -282,10 +282,11 @@ export declare const faqFirestoreSchema: z.ZodObject<{
         toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
     }, z.ZodTypeAny, "passthrough">;
     category: "orders_payment" | "shipping_delivery" | "returns_refunds" | "product_information" | "account_security" | "technical_support" | "general";
+    createdBy: string;
+    priority: number;
     tags: string[];
     isActive: boolean;
     order: number;
-    createdBy: string;
     stats: {
         views: number;
         helpful: number;
@@ -295,7 +296,6 @@ export declare const faqFirestoreSchema: z.ZodObject<{
         }, z.ZodTypeAny, "passthrough"> | undefined;
     };
     showOnHomepage: boolean;
-    priority: number;
     question: string;
     answer: {
         text: string;
@@ -321,10 +321,11 @@ export declare const faqFirestoreSchema: z.ZodObject<{
         toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
     }, z.ZodTypeAny, "passthrough">;
     category: "orders_payment" | "shipping_delivery" | "returns_refunds" | "product_information" | "account_security" | "technical_support" | "general";
+    createdBy: string;
+    priority: number;
     tags: string[];
     isActive: boolean;
     order: number;
-    createdBy: string;
     stats: {
         views: number;
         helpful: number;
@@ -334,7 +335,6 @@ export declare const faqFirestoreSchema: z.ZodObject<{
         }, z.ZodTypeAny, "passthrough"> | undefined;
     };
     showOnHomepage: boolean;
-    priority: number;
     question: string;
     answer: {
         text: string;