@mohasinac/appkit 4.3.2 → 4.4.0

package/dist/features/events/actions/event-actions.js

@@ -11,6 +11,7 @@ import { eventRepository } from "../repository/events.repository";
 import { eventEntryRepository } from "../repository/event-entry.repository";
 import { ERROR_MESSAGES, AuthorizationError, ValidationError, NotFoundError, } from "../../../errors";
 import { resolveDate } from "../../../utils";
+import { hashGuestIdentity } from "../../../security/rate-limit";
 const ERR_EVENT_NOT_FOUND = "Event not found";
 import { coerceMediaField, getMediaUrl } from "../../../utils";
 import { finalizeStagedMediaField, finalizeStagedMediaObject, finalizeStagedMediaObjectArray, } from "../../media/finalize";
@@ -148,6 +149,61 @@ export async function getEventLeaderboard(eventId) {
         return [];
     return eventEntryRepository.getLeaderboard(event.id);
 }
+/**
+ * Last N spins that actually won a prize, most recent first — powers the
+ * public "Last 10 Spin Results" tab on spin_wheel events. Joins each entry's
+ * `spinPrizeId` against the event's `spinPrizes` config for a human label
+ * (the entries repository has no access to the events collection, mirroring
+ * `getEventPollResults`' join pattern above) and marks guest spins so the
+ * caller can render a generic "Guest" label instead of a raw hash.
+ */
+export async function getEventSpinResults(eventId, limit = 10) {
+    const event = await eventRepository.findByIdOrSlug(eventId);
+    if (!event || event.type !== "spin_wheel")
+        return [];
+    const prizeTitleById = new Map((event.spinPrizes ?? []).map((p) => [p.id, p.label]));
+    const entries = await eventEntryRepository.getRecentSpinResults(event.id, limit);
+    return entries.map((entry) => ({
+        id: entry.id,
+        userDisplayName: entry.userId ? entry.userDisplayName : undefined,
+        isGuest: !entry.userId,
+        spinPrizeId: entry.spinPrizeId,
+        spinPrizeTitle: entry.spinPrizeId ? prizeTitleById.get(entry.spinPrizeId) : undefined,
+        spinWonAt: entry.spinWonAt ? new Date(entry.spinWonAt).toISOString() : undefined,
+    }));
+}
+/**
+ * Per-option vote tally for a poll event — replaces the voter-ranked
+ * leaderboard for event.type === "poll", where ranking "who happened to
+ * vote" is meaningless. Mirrors the resultsVisibility gating already used by
+ * the /api/events/[id] live-tally response: results are only surfaced when
+ * pollConfig.resultsVisibility is "always", or "after_end" once the event
+ * has actually ended. ("after_vote" visibility needs per-viewer vote state,
+ * which this public/cached read path has no user context for, so it's
+ * treated as not-yet-visible here.)
+ */
+export async function getEventPollResults(eventId) {
+    const event = await eventRepository.findByIdOrSlug(eventId);
+    if (!event || event.type !== "poll" || !event.pollConfig)
+        return [];
+    const visibility = event.pollConfig.resultsVisibility;
+    const canShow = visibility === "always" ||
+        (visibility === "after_end" && event.status === "ended");
+    if (!canShow)
+        return [];
+    const tally = await eventEntryRepository.getPollResults(event.id);
+    const countByOption = new Map(tally.map((t) => [t.optionId, t.count]));
+    const total = tally.reduce((sum, t) => sum + t.count, 0) || 1;
+    return event.pollConfig.options.map((opt) => {
+        const count = countByOption.get(opt.id) ?? 0;
+        return {
+            optionId: opt.id,
+            label: opt.label,
+            count,
+            percent: Math.round((count / total) * 100),
+        };
+    });
+}
 /** Related events — other active events sharing at least one tag, excluding this one. */
 export async function getRelatedEvents(tags, excludeId, limit = 6) {
     const docs = await eventRepository.findByTagsOverlap(tags, limit + 1);
@@ -188,7 +244,7 @@ export async function adminGetEventStats(eventId) {
     };
 }
 // --- Public: Enter Event ---------------------------------------------------
-export async function enterEvent(eventId, input, user) {
+export async function enterEvent(eventId, input, user, request) {
     const event = await eventRepository.findByIdOrSlug(eventId);
     if (!event || event.status !== "active") {
         throw new NotFoundError(ERROR_MESSAGES.EVENT.ENTRIES_CLOSED);
@@ -202,12 +258,37 @@ export async function enterEvent(eventId, input, user) {
     if (endsAt && now > endsAt) {
         throw new ValidationError(ERROR_MESSAGES.EVENT.ENTRIES_CLOSED);
     }
-    const requiresLogin = event.type === "poll" ||
+    // Baseline per-type login requirement, before the admin's per-event
+    // `allowGuestParticipation` override is applied. Anonymous feedback is a
+    // distinct opt-in concept (the event itself declares no identity is ever
+    // collected) so it stays open regardless of the guest-participation flag.
+    const perTypeRequiresLogin = event.type === "poll" ||
         event.type === "survey" ||
-        (event.type === "feedback" && !event.feedbackConfig?.anonymous);
+        (event.type === "feedback" && !event.feedbackConfig?.anonymous) ||
+        event.type === "raffle" ||
+        event.type === "spin_wheel";
+    // Every event type that reaches enterEvent() is now gated by the single
+    // admin-controlled flag — raffle/spin_wheel no longer get accidental free
+    // guest access just because they were absent from the old per-type list.
+    const requiresLogin = !event.allowGuestParticipation && perTypeRequiresLogin;
     if (requiresLogin && !user) {
         throw new AuthorizationError(ERROR_MESSAGES.EVENT.LOGIN_REQUIRED);
     }
+    // Guest path: dedupe by a hashed IP scoped to this event so an anonymous
+    // visitor can't submit unlimited entries. The raw IP is never persisted.
+    let guestIpHash;
+    if (!user && event.allowGuestParticipation) {
+        if (!request) {
+            // Every real HTTP caller passes the incoming Request — fail closed
+            // rather than silently letting an untracked guest entry through.
+            throw new AuthorizationError(ERROR_MESSAGES.EVENT.LOGIN_REQUIRED);
+        }
+        guestIpHash = hashGuestIdentity(resolvedEventId, request);
+        const alreadyEntered = await eventEntryRepository.hasGuestEntered(resolvedEventId, guestIpHash);
+        if (alreadyEntered) {
+            throw new ValidationError(ERROR_MESSAGES.EVENT.ALREADY_ENTERED);
+        }
+    }
     if (user && event.type === "survey" && event.surveyConfig) {
         const userEntryCount = await eventEntryRepository.countUserEntries(resolvedEventId, user.uid);
         if (userEntryCount >= event.surveyConfig.maxEntriesPerUser) {
@@ -247,6 +328,7 @@ export async function enterEvent(eventId, input, user) {
         userId: user?.uid,
         userDisplayName: user?.displayName,
         userEmail: user?.email,
+        guestIpHash,
         pollVotes: input.pollVotes,
         pollComment: input.pollComment,
         formResponses: input.formResponses,

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

@@ -115,6 +115,7 @@ const DEFAULT_DRAFT = {
     tags: [],
     status: "draft",
     createdBy: "",
+    allowGuestParticipation: false,
     discountPercent: "10",
     saleBannerText: "",
     couponId: "",
@@ -184,6 +185,12 @@ function buildEventRaffleFields(draft) {
     }
     return fields;
 }
+// Extracted out of the raffle/spin step's render() so that closure stays
+// under the LARGE_COMPONENT line-count threshold — purely a line-count
+// split, no behavior change from when this was inline.
+function SpinPrizesEditor({ values, onChange, }) {
+    return (_jsxs(Stack, { gap: "sm", rounded: "lg", border: "default", padding: "sm", children: [_jsx(Text, { size: "xs", weight: "medium", color: "muted", children: "Spin prizes (weighted random)" }), values.spinPrizes.length === 0 && (_jsx(Text, { size: "xs", color: "muted", children: "No spin prizes yet. Add at least one to enable spinning." })), values.spinPrizes.map((p) => (_jsxs(Grid, { align: "end", gap: "xs", className: "grid-cols-12", children: [_jsx(Div, { className: "col-span-5", children: _jsx(Input, { label: "Label", value: p.label, onChange: (e) => onChange({ spinPrizes: values.spinPrizes.map((sp) => sp.id === p.id ? { ...sp, label: e.target.value } : sp) }), placeholder: "\u20B9100 off" }) }), _jsxs(Div, { className: "col-span-3", children: [_jsx(Text, { size: "xs", weight: "medium", className: "mb-1", children: "Coupon" }), _jsx(CouponInlineSelect, { scope: "admin", value: p.couponId ?? "", onChange: (id) => onChange({ spinPrizes: values.spinPrizes.map((sp) => sp.id === p.id ? { ...sp, couponId: id || undefined } : sp) }), placeholder: "Search\u2026", allowCreate: false })] }), _jsx(Div, { className: "col-span-2", children: _jsx(Input, { label: "Weight", type: "number", value: String(p.weight), onChange: (e) => onChange({ spinPrizes: values.spinPrizes.map((sp) => sp.id === p.id ? { ...sp, weight: Number(e.target.value) || 0 } : sp) }) }) }), _jsx(Row, { centered: true, className: "col-span-1", padding: "b-xs", children: _jsx(Toggle, { checked: p.isActive, onChange: (v) => onChange({ spinPrizes: values.spinPrizes.map((sp) => sp.id === p.id ? { ...sp, isActive: v } : sp) }), label: "" }) }), _jsx(Row, { centered: true, className: "col-span-1", padding: "b-xs", children: _jsx(Button, { variant: "ghost", type: "button", onClick: () => onChange({ spinPrizes: values.spinPrizes.filter((sp) => sp.id !== p.id) }), className: CLS_REMOVE_BTN_LG, "aria-label": "Remove prize", children: "\u00D7" }) })] }, p.id))), _jsx(Button, { type: "button", variant: "outline", size: "sm", onClick: () => onChange({ spinPrizes: [...values.spinPrizes, { id: `prize-${Date.now()}`, label: "", couponId: undefined, weight: 1, isActive: true }] }), children: "+ Add spin prize" }), _jsx(Input, { label: "Max spins per user", type: "number", value: values.spinMaxPerUser, onChange: (e) => onChange({ spinMaxPerUser: e.target.value }), placeholder: "1" }), _jsxs(Grid, { cols: 2, gap: "sm", children: [_jsx(Input, { label: "Spin window start", type: "datetime-local", value: values.spinWindowStart, onChange: (e) => onChange({ spinWindowStart: e.target.value }) }), _jsx(Input, { label: "Spin window end", type: "datetime-local", value: values.spinWindowEnd, onChange: (e) => onChange({ spinWindowEnd: e.target.value }) })] })] }));
+}
 // --- Component ---------------------------------------------------------------
 export function AdminEventEditorView({ eventId, onSaved, embedded, allowedTypes, ...rest }) {
     const isEdit = Boolean(eventId);
@@ -221,6 +228,7 @@ export function AdminEventEditorView({ eventId, onSaved, embedded, allowedTypes,
             tags: Array.isArray(event.tags) ? event.tags : [],
             status: event.status || "draft",
             createdBy: event.createdBy || "",
+            allowGuestParticipation: Boolean(event.allowGuestParticipation),
             discountPercent: String(event.saleConfig?.discountPercent ?? 10),
             saleBannerText: event.saleConfig?.bannerText || "",
             couponId: event.offerConfig?.couponId || "",
@@ -269,6 +277,7 @@ export function AdminEventEditorView({ eventId, onSaved, embedded, allowedTypes,
                 startsAt: toISOString(draft.startsAt),
                 endsAt: toISOString(draft.endsAt),
                 coverImageUrl: draft.coverImageUrl || undefined,
+                allowGuestParticipation: draft.allowGuestParticipation,
                 ...buildEventTypeConfig(draft),
                 ...buildEventRaffleFields(draft),
             };
@@ -342,7 +351,7 @@ export function AdminEventEditorView({ eventId, onSaved, embedded, allowedTypes,
                     return "Poll events require at least 2 options";
                 return null;
             },
-            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 })] })), 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 }) })] }))] })),
+            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 }) })] }))] })),
         },
         {
             label: "Raffle / Spin",
@@ -350,7 +359,7 @@ export function AdminEventEditorView({ eventId, onSaved, embedded, allowedTypes,
                 const isRaffleType = values.type === "raffle" || values.type === "spin_wheel";
                 const showRaffleConfig = isRaffleType || values.hasRaffle;
                 const isSpinMode = values.type === "spin_wheel" || values.raffleType === "spin_wheel";
-                return (_jsxs(Stack, { gap: "md", children: [_jsx(Heading, { level: 3, className: "mb-2", children: "Raffle & Spin Wheel" }), !isRaffleType && (_jsx(Toggle, { checked: values.hasRaffle, onChange: (v) => onChange({ hasRaffle: v }), label: "Attach a raffle to this event" })), !isRaffleType && !values.hasRaffle && (_jsx(Text, { size: "sm", color: "muted", children: "Enable the toggle above to attach a raffle draw to this event. Not applicable for this event type by default." })), showRaffleConfig && (_jsxs(Stack, { gap: "md", rounded: "xl", border: "default", padding: "md", children: [_jsxs(Grid, { cols: 2, gap: "sm", children: [_jsx(Select, { label: "Raffle type", value: values.type === "spin_wheel" ? "spin_wheel" : values.raffleType, options: RAFFLE_TYPE_OPTIONS, onChange: (e) => onChange({ raffleType: e.target.value }), disabled: values.type === "spin_wheel" }), _jsx(Input, { label: "Top N (for top-N raffle types)", type: "number", value: values.raffleTopN, onChange: (e) => onChange({ raffleTopN: e.target.value }), placeholder: "10" })] }), _jsx(Input, { label: "Prize description", value: values.rafflePrize, onChange: (e) => onChange({ rafflePrize: e.target.value }), placeholder: "\u20B92,000 store credit + exclusive Pikachu sticker" }), _jsxs(Div, { children: [_jsx(Text, { size: "sm", weight: "medium", className: "mb-1", children: "Coupon for winner (optional)" }), _jsx(CouponInlineSelect, { scope: "admin", value: values.rafflePrizeCouponId, onChange: (id) => onChange({ rafflePrizeCouponId: id ?? "" }), placeholder: "Search coupons\u2026", allowCreate: false })] }), _jsxs(Div, { children: [_jsx(Text, { size: "sm", weight: "medium", className: "mb-1", children: "Prize products (optional)" }), _jsx(ProductInlineSelect, { scope: "admin", multiple: true, value: values.rafflePrizeProductIds, onChange: (ids) => onChange({ rafflePrizeProductIds: ids }), placeholder: "Search products to feature as prizes\u2026" }), _jsx(Text, { size: "xs", color: "muted", className: "mt-1", children: "Products shown to winners or displayed as the prize showcase." })] }), isSpinMode && (_jsxs(Stack, { gap: "sm", rounded: "lg", border: "default", padding: "sm", children: [_jsx(Text, { size: "xs", weight: "medium", color: "muted", children: "Spin prizes (weighted random)" }), values.spinPrizes.length === 0 && (_jsx(Text, { size: "xs", color: "muted", children: "No spin prizes yet. Add at least one to enable spinning." })), values.spinPrizes.map((p) => (_jsxs(Grid, { align: "end", gap: "xs", className: "grid-cols-12", children: [_jsx(Div, { className: "col-span-5", children: _jsx(Input, { label: "Label", value: p.label, onChange: (e) => onChange({ spinPrizes: values.spinPrizes.map((sp) => sp.id === p.id ? { ...sp, label: e.target.value } : sp) }), placeholder: "\u20B9100 off" }) }), _jsxs(Div, { className: "col-span-3", children: [_jsx(Text, { size: "xs", weight: "medium", className: "mb-1", children: "Coupon" }), _jsx(CouponInlineSelect, { scope: "admin", value: p.couponId ?? "", onChange: (id) => onChange({ spinPrizes: values.spinPrizes.map((sp) => sp.id === p.id ? { ...sp, couponId: id || undefined } : sp) }), placeholder: "Search\u2026", allowCreate: false })] }), _jsx(Div, { className: "col-span-2", children: _jsx(Input, { label: "Weight", type: "number", value: String(p.weight), onChange: (e) => onChange({ spinPrizes: values.spinPrizes.map((sp) => sp.id === p.id ? { ...sp, weight: Number(e.target.value) || 0 } : sp) }) }) }), _jsx(Row, { centered: true, className: "col-span-1", padding: "b-xs", children: _jsx(Toggle, { checked: p.isActive, onChange: (v) => onChange({ spinPrizes: values.spinPrizes.map((sp) => sp.id === p.id ? { ...sp, isActive: v } : sp) }), label: "" }) }), _jsx(Row, { centered: true, className: "col-span-1", padding: "b-xs", children: _jsx(Button, { variant: "ghost", type: "button", onClick: () => onChange({ spinPrizes: values.spinPrizes.filter((sp) => sp.id !== p.id) }), className: CLS_REMOVE_BTN_LG, "aria-label": "Remove prize", children: "\u00D7" }) })] }, p.id))), _jsx(Button, { type: "button", variant: "outline", size: "sm", onClick: () => onChange({ spinPrizes: [...values.spinPrizes, { id: `prize-${Date.now()}`, label: "", couponId: undefined, weight: 1, isActive: true }] }), children: "+ Add spin prize" }), _jsx(Input, { label: "Max spins per user", type: "number", value: values.spinMaxPerUser, onChange: (e) => onChange({ spinMaxPerUser: e.target.value }), placeholder: "1" }), _jsxs(Grid, { cols: 2, gap: "sm", children: [_jsx(Input, { label: "Spin window start", type: "datetime-local", value: values.spinWindowStart, onChange: (e) => onChange({ spinWindowStart: e.target.value }) }), _jsx(Input, { label: "Spin window end", type: "datetime-local", value: values.spinWindowEnd, onChange: (e) => onChange({ spinWindowEnd: e.target.value }) })] })] })), isEdit && (_jsxs(Stack, { gap: "xs", rounded: "lg", padding: "sm", className: CLS_RAFFLE_PANEL, children: [_jsxs(Row, { justify: "between", gap: "sm", children: [_jsx(Text, { size: "sm", weight: "medium", className: CLS_RAFFLE_HEADING, children: raffleWinnerName ? `Winner: ${raffleWinnerName}` : "Raffle not yet triggered" }), _jsx(Button, { type: "button", variant: "primary", size: "sm", onClick: () => triggerRaffleMutation.mutate(), disabled: triggerRaffleMutation.isPending || Boolean(raffleWinnerName), children: triggerRaffleMutation.isPending ? "Triggering…" : raffleWinnerName ? "Already triggered" : "Trigger Raffle Now" })] }), raffleEntryCount !== null && _jsxs(Text, { size: "xs", className: CLS_RAFFLE_BODY, children: ["Pool size: ", raffleEntryCount] }), raffleGithubUrl && _jsxs(Text, { size: "xs", className: `break-all ${CLS_RAFFLE_BODY}`, children: ["Fairness proof: ", raffleGithubUrl] }), triggerMessage && _jsx(Text, { size: "xs", className: CLS_RAFFLE_HEADING, children: triggerMessage })] }))] }))] }));
+                return (_jsxs(Stack, { gap: "md", children: [_jsx(Heading, { level: 3, className: "mb-2", children: "Raffle & Spin Wheel" }), !isRaffleType && (_jsx(Toggle, { checked: values.hasRaffle, onChange: (v) => onChange({ hasRaffle: v }), label: "Attach a raffle to this event" })), !isRaffleType && !values.hasRaffle && (_jsx(Text, { size: "sm", color: "muted", children: "Enable the toggle above to attach a raffle draw to this event. Not applicable for this event type by default." })), showRaffleConfig && (_jsxs(Stack, { gap: "md", rounded: "xl", border: "default", padding: "md", children: [_jsxs(Grid, { cols: 2, gap: "sm", children: [_jsx(Select, { label: "Raffle type", value: values.type === "spin_wheel" ? "spin_wheel" : values.raffleType, options: RAFFLE_TYPE_OPTIONS, onChange: (e) => onChange({ raffleType: e.target.value }), disabled: values.type === "spin_wheel" }), _jsx(Input, { label: "Top N (for top-N raffle types)", type: "number", value: values.raffleTopN, onChange: (e) => onChange({ raffleTopN: e.target.value }), placeholder: "10" })] }), _jsx(Input, { label: "Prize description", value: values.rafflePrize, onChange: (e) => onChange({ rafflePrize: e.target.value }), placeholder: "\u20B92,000 store credit + exclusive Pikachu sticker" }), _jsxs(Div, { children: [_jsx(Text, { size: "sm", weight: "medium", className: "mb-1", children: "Coupon for winner (optional)" }), _jsx(CouponInlineSelect, { scope: "admin", value: values.rafflePrizeCouponId, onChange: (id) => onChange({ rafflePrizeCouponId: id ?? "" }), placeholder: "Search coupons\u2026", allowCreate: false })] }), _jsxs(Div, { children: [_jsx(Text, { size: "sm", weight: "medium", className: "mb-1", children: "Prize products (optional)" }), _jsx(ProductInlineSelect, { scope: "admin", multiple: true, value: values.rafflePrizeProductIds, onChange: (ids) => onChange({ rafflePrizeProductIds: ids }), placeholder: "Search products to feature as prizes\u2026" }), _jsx(Text, { size: "xs", color: "muted", className: "mt-1", children: "Products shown to winners or displayed as the prize showcase." })] }), isSpinMode && _jsx(SpinPrizesEditor, { values: values, onChange: onChange }), isEdit && (_jsxs(Stack, { gap: "xs", rounded: "lg", padding: "sm", className: CLS_RAFFLE_PANEL, children: [_jsxs(Row, { justify: "between", gap: "sm", children: [_jsx(Text, { size: "sm", weight: "medium", className: CLS_RAFFLE_HEADING, children: raffleWinnerName ? `Winner: ${raffleWinnerName}` : "Raffle not yet triggered" }), _jsx(Button, { type: "button", variant: "primary", size: "sm", onClick: () => triggerRaffleMutation.mutate(), disabled: triggerRaffleMutation.isPending || Boolean(raffleWinnerName), children: triggerRaffleMutation.isPending ? "Triggering…" : raffleWinnerName ? "Already triggered" : "Trigger Raffle Now" })] }), raffleEntryCount !== null && _jsxs(Text, { size: "xs", className: CLS_RAFFLE_BODY, children: ["Pool size: ", raffleEntryCount] }), raffleGithubUrl && _jsxs(Text, { size: "xs", className: `break-all ${CLS_RAFFLE_BODY}`, children: ["Fairness proof: ", raffleGithubUrl] }), triggerMessage && _jsx(Text, { size: "xs", className: CLS_RAFFLE_HEADING, children: triggerMessage })] }))] }))] }));
             },
         },
     ];

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

@@ -1,15 +1,18 @@
 "use client";
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 import { useApiMutation } from "@mohasinac/appkit/client";
 import React from "react";
 import { useQuery, useQueryClient } from "@tanstack/react-query";
-import { Alert, Button, Div, Input, Row, Select, Stack, StackedViewShell, Text } from "../../../ui";
+import { Alert, Button, Div, Input, Row, Select, Stack, StackedViewShell, Text, useToast } from "../../../ui";
 import { apiClient } from "../../../http";
+import { normalizeError } from "../../../errors/normalize";
+import { ACTIONS } from "../../../_internal/shared/actions/action-registry";
 import { DataTable } from "../../admin/components/DataTable";
 import { ADMIN_ENDPOINTS } from "../../../constants/api-endpoints";
 const __P = {
     p4: "p-[var(--appkit-space-4)]",
 };
+const CLS_RESPONSE_TEXT = "whitespace-pre-wrap break-words";
 const REVIEW_STATUS_OPTIONS = [
     { label: "All", value: "all" },
     { label: "Pending", value: "pending" },
@@ -18,6 +21,7 @@ const REVIEW_STATUS_OPTIONS = [
 ];
 export function AdminEventEntriesView({ eventId, entriesEndpoint, entryReviewEndpoint, statsEndpoint, renderHeader, renderStats, renderFilters, renderTable, renderPagination, renderReviewDrawer, ...rest }) {
     const queryClient = useQueryClient();
+    const { showToast } = useToast();
     const [page, setPage] = React.useState(1);
     const [pageSize] = React.useState(20);
     const [statusFilter, setStatusFilter] = React.useState("all");
@@ -122,9 +126,28 @@ export function AdminEventEntriesView({ eventId, entriesEndpoint, entryReviewEnd
         {
             key: "actions",
             header: "Actions",
-            render: (row) => (_jsxs(Row, { align: "center", gap: "sm", wrap: true, children: [_jsx(Button, { size: "sm", variant: "secondary", disabled: reviewMutation.isPending || row.reviewStatus === "approved", onClick: () => reviewMutation.mutate({ entryId: row.id, status: "approved" }), children: "Approve" }), _jsx(Button, { size: "sm", variant: "outline", disabled: reviewMutation.isPending || row.reviewStatus === "flagged", onClick: () => reviewMutation.mutate({ entryId: row.id, status: "flagged" }), children: "Flag" }), row.formResponses && Object.keys(row.formResponses).length > 0 && (_jsx(Button, { size: "sm", variant: "outline", onClick: () => setExpandedEntryId((prev) => (prev === row.id ? null : row.id)), children: expandedEntryId === row.id ? "Hide" : "Responses" }))] })),
+            render: (row) => (_jsxs(Row, { align: "center", gap: "sm", wrap: true, children: [_jsx(Button, { size: "sm", variant: "secondary", disabled: reviewMutation.isPending || row.reviewStatus === "approved", onClick: () => reviewMutation.mutate({ entryId: row.id, status: "approved" }), children: "Approve" }), _jsx(Button, { size: "sm", variant: "outline", disabled: reviewMutation.isPending || row.reviewStatus === "flagged", onClick: () => reviewMutation.mutate({ entryId: row.id, status: "flagged" }), children: "Flag" }), ((row.formResponses && Object.keys(row.formResponses).length > 0) ||
+                        (row.pollVotes && row.pollVotes.length > 0)) && (_jsx(Button, { size: "sm", variant: "outline", onClick: () => setExpandedEntryId((prev) => (prev === row.id ? null : row.id)), children: expandedEntryId === row.id ? "Hide" : "Responses" }))] })),
         },
     ], [reviewMutation, pointsMutation, pointsInputs, expandedEntryId]);
+    const handleExportReport = async () => {
+        if (!eventId)
+            return;
+        try {
+            const blob = await apiClient.blob(ADMIN_ENDPOINTS.EVENT_ENTRIES_EXPORT(eventId));
+            const url = URL.createObjectURL(blob);
+            const a = document.createElement("a");
+            a.href = url;
+            a.download = `event-entries-${eventId}-${new Date().toISOString().slice(0, 10)}.md`;
+            a.click();
+            URL.revokeObjectURL(url);
+        }
+        catch (_err) {
+            void normalizeError(_err);
+            showToast("Report export failed.", "error");
+        }
+    };
+    const exportSection = eventId ? (_jsx(Row, { justify: "end", children: _jsx(Button, { variant: "ghost", action: ACTIONS.ADMIN["export-event-entries"], onClick: handleExportReport }) })) : null;
     const statsSection = (_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) })] }));
     const filtersSection = (_jsxs(Div, { layout: "grid", gap: "3", className: "grid-cols-1 md:grid-cols-3", children: [_jsx(Input, { label: "Search entries", value: searchQuery, onChange: (event) => {
                     setPage(1);
@@ -133,14 +156,24 @@ export function AdminEventEntriesView({ eventId, entriesEndpoint, entryReviewEnd
                     setPage(1);
                     setStatusFilter(event.target.value);
                 } })] }));
+    const pollOptionLabels = React.useMemo(() => {
+        const map = new Map();
+        for (const opt of statsQuery.data?.event?.pollConfig?.options ?? []) {
+            map.set(opt.id, opt.label);
+        }
+        return map;
+    }, [statsQuery.data]);
     const expandedEntry = expandedEntryId ? rows.find((r) => r.id === expandedEntryId) : null;
-    const responsesPanelSection = expandedEntry?.formResponses && Object.keys(expandedEntry.formResponses).length > 0 ? (_jsxs(Stack, { className: `${__P.p4}`, gap: "3", rounded: "xl", surface: "muted", border: "default", children: [_jsxs(Text, { size: "sm", weight: "semibold", color: "primary", children: ["Responses \u2014 ", expandedEntry.userDisplayName || expandedEntry.userId || "Anonymous"] }), _jsx(Stack, { gap: "sm", children: Object.entries(expandedEntry.formResponses).map(([key, value]) => (_jsxs(Stack, { gap: "none", className: "", children: [_jsx(Text, { size: "xs", weight: "medium", color: "muted", children: key }), _jsx(Text, { className: "whitespace-pre-wrap break-words", color: "primary", size: "sm", children: Array.isArray(value) ? value.join(", ") : String(value ?? "—") })] }, key))) })] })) : null;
+    const expandedHasFormResponses = Boolean(expandedEntry?.formResponses && Object.keys(expandedEntry.formResponses).length > 0);
+    const expandedHasPollVotes = Boolean(expandedEntry?.pollVotes && expandedEntry.pollVotes.length > 0);
+    const responsesPanelSection = expandedEntry && (expandedHasFormResponses || expandedHasPollVotes) ? (_jsxs(Stack, { className: `${__P.p4}`, gap: "3", rounded: "xl", surface: "muted", border: "default", children: [_jsxs(Text, { size: "sm", weight: "semibold", color: "primary", children: ["Responses \u2014 ", expandedEntry.userDisplayName || expandedEntry.userId || "Anonymous"] }), expandedHasPollVotes && (_jsxs(Stack, { gap: "sm", children: [_jsx(Text, { size: "xs", weight: "medium", color: "muted", children: "Poll votes" }), _jsx(Text, { className: CLS_RESPONSE_TEXT, color: "primary", size: "sm", children: expandedEntry.pollVotes.map((id) => pollOptionLabels.get(id) ?? id).join(", ") }), expandedEntry.pollComment && (_jsxs(_Fragment, { children: [_jsx(Text, { size: "xs", weight: "medium", color: "muted", children: "Comment" }), _jsx(Text, { className: CLS_RESPONSE_TEXT, color: "primary", size: "sm", children: expandedEntry.pollComment })] }))] })), expandedHasFormResponses && (_jsx(Stack, { gap: "sm", children: Object.entries(expandedEntry.formResponses).map(([key, value]) => (_jsxs(Stack, { gap: "none", className: "", children: [_jsx(Text, { size: "xs", weight: "medium", color: "muted", children: key }), _jsx(Text, { className: CLS_RESPONSE_TEXT, color: "primary", size: "sm", children: Array.isArray(value) ? value.join(", ") : String(value ?? "—") })] }, key))) }))] })) : null;
     const tableSection = (_jsx(DataTable, { columns: columns, rows: rows, isLoading: entriesQuery.isLoading, currentPage: entriesQuery.data?.page ?? page, totalPages: entriesQuery.data?.totalPages ?? 1, onPageChange: setPage, emptyLabel: "No entries found" }));
     const eventTitle = statsQuery.data?.event?.title;
     return (_jsx(StackedViewShell, { portal: "admin", ...rest, title: eventTitle ? `${eventTitle} Entries` : "Event Entries", renderHeader: renderHeader, sections: [
             !eventId ? (_jsx(Alert, { variant: "warning", title: "Missing event id", children: "Event id is required to load entries." })) : null,
             entriesQuery.error ? (_jsx(Alert, { variant: "error", title: "Could not load entries", children: entriesQuery.error instanceof Error ? entriesQuery.error.message : "Unknown error" })) : null,
             statsQuery.error ? (_jsx(Alert, { variant: "error", title: "Could not load event stats", children: statsQuery.error instanceof Error ? statsQuery.error.message : "Unknown error" })) : null,
+            exportSection,
             renderStats?.() ?? statsSection,
             renderFilters?.() ?? filtersSection,
             renderTable?.() ?? tableSection,

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

@@ -1,7 +1,7 @@
 "use client";
 import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
-import { sieveFilter, SIEVE_OP } from "@mohasinac/appkit";
-import { sortBy } from "@mohasinac/appkit";
+import { sieveFilter, SIEVE_OP } from "@mohasinac/appkit/client";
+import { sortBy } from "@mohasinac/appkit/client";
 import React from "react";
 import { FilterChipGroup, ListingLayout } from "../../../ui";
 import { ADMIN_ENDPOINTS } from "../../../constants/api-endpoints";

package/dist/features/events/components/EventLeaderboard.d.ts

@@ -1,5 +1,5 @@
 import React from "react";
-import type { LeaderboardEntry } from "../types";
+import type { LeaderboardEntry, PollResultEntry } from "../types";
 export interface EventLeaderboardProps {
     isLoading?: boolean;
     isEmpty?: boolean;
@@ -9,6 +9,15 @@ export interface EventLeaderboardProps {
     renderEntry?: (entry: LeaderboardEntry, index: number) => React.ReactNode;
     /** Entries — used only when renderEntry is provided */
     entries?: LeaderboardEntry[];
+    /**
+     * When provided, renders a per-option vote-tally view instead of the
+     * ranked voter list — use for event.type === "poll", where a
+     * voter-by-points ranking is meaningless. Takes priority over
+     * `renderList`/`entries` when set.
+     */
+    pollResults?: PollResultEntry[];
+    /** Render a single poll-result row; used when caller wants item-level control */
+    renderPollResult?: (result: PollResultEntry, index: number) => React.ReactNode;
     /** Empty state node */
     renderEmpty?: () => React.ReactNode;
     /** Loading spinner / skeleton */
@@ -17,7 +26,8 @@ export interface EventLeaderboardProps {
         title?: string;
         noEntries?: string;
         points?: string;
+        votes?: string;
     };
     className?: string;
 }
-export declare function EventLeaderboard({ isLoading, isEmpty, renderList, renderEntry, entries, renderEmpty, renderSkeleton, labels, className, }: EventLeaderboardProps): React.JSX.Element;
+export declare function EventLeaderboard({ isLoading, isEmpty, renderList, renderEntry, entries, pollResults, renderPollResult, renderEmpty, renderSkeleton, labels, className, }: EventLeaderboardProps): React.JSX.Element;

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

@@ -1,7 +1,7 @@
 import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import React from "react";
 import { Div, Row, Span, Stack, Text } from "../../../ui";
-export function EventLeaderboard({ isLoading = false, isEmpty = false, renderList, renderEntry, entries = [], renderEmpty, renderSkeleton, labels = {}, className = "", }) {
+export function EventLeaderboard({ isLoading = false, isEmpty = false, renderList, renderEntry, entries = [], pollResults, renderPollResult, renderEmpty, renderSkeleton, labels = {}, className = "", }) {
     if (isLoading) {
         if (renderSkeleton)
             return _jsx(_Fragment, { children: renderSkeleton() });
@@ -12,6 +12,9 @@ export function EventLeaderboard({ isLoading = false, isEmpty = false, renderLis
             return _jsx(_Fragment, { children: renderEmpty() });
         return (_jsx(Text, { paddingY: "md", variant: "secondary", size: "sm", align: "start", children: labels.noEntries ?? "No entries yet." }));
     }
+    if (pollResults) {
+        return (_jsx(Stack, { className: className, gap: "sm", children: pollResults.map((result, i) => renderPollResult ? (_jsx(React.Fragment, { children: renderPollResult(result, i) }, result.optionId)) : (_jsxs(Div, { layout: "flex", align: "center", justify: "between", rounded: "xl", padding: "sm", className: "border", "data-section": "eventleaderboard-pollresult-div", children: [_jsx(Span, { weight: "medium", children: result.label }), _jsxs(Span, { size: "sm", color: "muted", children: [result.count, " ", labels.votes ?? "votes", " (", result.percent, "%)"] })] }, result.optionId))) }));
+    }
     if (renderList)
         return _jsx(Div, { className: className, children: renderList() });
     return (_jsx(Stack, { className: `${className}`, gap: "sm", children: entries.map((entry, i) => renderEntry ? (_jsx(React.Fragment, { children: renderEntry(entry, i) }, entry.userId)) : (_jsxs(Div, { layout: "flex", align: "center", justify: "between", rounded: "xl", padding: "sm", className: "border", "data-section": "eventleaderboard-div-282", children: [_jsxs(Span, { weight: "medium", children: ["#", entry.rank, " ", entry.userDisplayName] }), _jsxs(Span, { children: [entry.totalPoints, " ", labels.points ?? "pts"] })] }, entry.userId))) }));

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

@@ -1,7 +1,7 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { normalizeError } from "../../../errors/normalize";
-import { sieveFilter, sieveAnd, SIEVE_OP } from "@mohasinac/appkit";
-import { sortBy } from "@mohasinac/appkit";
+import { sieveFilter, sieveAnd, SIEVE_OP } from "@mohasinac/appkit/client";
+import { sortBy } from "@mohasinac/appkit/client";
 import { Container, Div, Heading, Section, Stack, Text, } from "../../../ui";
 import { eventRepository } from "../repository/events.repository";
 import { EventCard } from "./EventCard";

package/dist/features/events/repository/event-entry.repository.d.ts

@@ -13,8 +13,47 @@ declare class EventEntryRepository extends BaseRepository<EventEntryDocument> {
      */
     list(model: SieveModel): Promise<FirebaseSieveResult<EventEntryDocument>>;
     hasUserEntered(eventId: string, userId: string): Promise<boolean>;
+    /** Guest (unauthenticated) counterpart of `hasUserEntered` — keyed by the hashed IP, never the raw address. */
+    hasGuestEntered(eventId: string, guestIpHash: string): Promise<boolean>;
+    /**
+     * Last N spins that resulted in a prize being assigned, most recent
+     * first. Firestore's `orderBy` excludes documents missing the ordered
+     * field, so this naturally returns only entries that actually spun
+     * (every write path sets `spinWonAt` and `spinPrizeId` together).
+     */
+    getRecentSpinResults(eventId: string, limit?: number): Promise<EventEntryDocument[]>;
     countUserEntries(eventId: string, userId: string): Promise<number>;
     getLeaderboard(eventId: string, limit?: number): Promise<import("../types").LeaderboardEntry[]>;
+    /**
+     * Raw vote tally per poll option id for a poll-type event. This repository
+     * has no access to the events collection, so it cannot resolve option
+     * labels — the caller (event-actions.ts, which has the EventDocument's
+     * pollConfig.options in hand) joins optionId -> label and computes percent.
+     */
+    getPollResults(eventId: string): Promise<{
+        optionId: string;
+        count: number;
+    }[]>;
+    /**
+     * Markdown export for the admin Event Entries view (AdminEventEntriesView
+     * "Download Report" button). For a poll event, renders the same
+     * per-option vote tally as getPollResults — the caller passes
+     * event.pollConfig.options since this repository has no access to the
+     * events collection to resolve labels itself. For every other event type
+     * (survey included — survey's points-based leaderboard is intentional,
+     * see getEventPollResults' doc comment in event-actions.ts), lists
+     * individual entries: submitter, submission date, review status, points,
+     * and form responses — mirroring what the on-screen table + "Responses"
+     * panel already show.
+     */
+    getExportReport(eventId: string, event: {
+        title: string;
+        type: string;
+        pollOptions?: {
+            id: string;
+            label: string;
+        }[];
+    }): Promise<string>;
     createEntry(input: EventEntryCreateInput): Promise<EventEntryDocument>;
     reviewEntry(id: string, reviewStatus: EventEntryDocument["reviewStatus"], reviewedBy: string, reviewNote?: string, points?: number): Promise<EventEntryDocument>;
 }

package/dist/features/events/repository/event-entry.repository.js

@@ -4,6 +4,18 @@ import { serverLogger } from "../../../monitoring";
 import { BaseRepository, prepareForFirestore, } from "../../../providers/db-firebase";
 import { decryptPiiFields, encryptPiiFields, EVENT_ENTRY_PII_FIELDS, } from "../../../security";
 import { EVENT_ENTRIES_COLLECTION, EVENT_ENTRY_FIELDS, } from "../schemas";
+/** Extracted from getExportReport's poll branch to stay under the max nesting depth. */
+function formatPollResultLines(pollOptions, countByOption, total) {
+    return pollOptions.map((opt) => {
+        const count = countByOption.get(opt.id) ?? 0;
+        const percent = Math.round((count / total) * 100);
+        return `- **${opt.label}** — ${count} vote${count === 1 ? "" : "s"} (${percent}%)`;
+    });
+}
+/** Extracted from getExportReport's per-entry loop to stay under the max nesting depth. */
+function formatFormResponseLines(formResponses) {
+    return Object.entries(formResponses).map(([key, value]) => `  - ${key}: ${Array.isArray(value) ? value.join(", ") : String(value ?? "—")}`);
+}
 class EventEntryRepository extends BaseRepository {
     constructor() {
         super(EVENT_ENTRIES_COLLECTION);
@@ -45,6 +57,41 @@ class EventEntryRepository extends BaseRepository {
             throw new DatabaseError(`Failed to check user entry for event ${eventId}`, error);
         }
     }
+    /** Guest (unauthenticated) counterpart of `hasUserEntered` — keyed by the hashed IP, never the raw address. */
+    async hasGuestEntered(eventId, guestIpHash) {
+        try {
+            const snapshot = await this.getCollection()
+                .where(EVENT_ENTRY_FIELDS.EVENT_ID, "==", eventId)
+                .where(EVENT_ENTRY_FIELDS.GUEST_IP_HASH, "==", guestIpHash)
+                .limit(1)
+                .get();
+            return !snapshot.empty;
+        }
+        catch (error) {
+            void normalizeError(error);
+            throw new DatabaseError(`Failed to check guest entry for event ${eventId}`, error);
+        }
+    }
+    /**
+     * Last N spins that resulted in a prize being assigned, most recent
+     * first. Firestore's `orderBy` excludes documents missing the ordered
+     * field, so this naturally returns only entries that actually spun
+     * (every write path sets `spinWonAt` and `spinPrizeId` together).
+     */
+    async getRecentSpinResults(eventId, limit = 10) {
+        try {
+            const snapshot = await this.getCollection()
+                .where(EVENT_ENTRY_FIELDS.EVENT_ID, "==", eventId)
+                .orderBy(EVENT_ENTRY_FIELDS.SPIN_WON_AT, "desc")
+                .limit(limit)
+                .get();
+            return snapshot.docs.map((doc) => this.mapDoc(doc));
+        }
+        catch (error) {
+            void normalizeError(error);
+            throw new DatabaseError(`Failed to get recent spin results for event ${eventId}`, error);
+        }
+    }
     async countUserEntries(eventId, userId) {
         try {
             const snapshot = await this.getCollection()
@@ -100,6 +147,112 @@ class EventEntryRepository extends BaseRepository {
             throw new DatabaseError(`Failed to get leaderboard for event ${eventId}`, error);
         }
     }
+    /**
+     * Raw vote tally per poll option id for a poll-type event. This repository
+     * has no access to the events collection, so it cannot resolve option
+     * labels — the caller (event-actions.ts, which has the EventDocument's
+     * pollConfig.options in hand) joins optionId -> label and computes percent.
+     */
+    async getPollResults(eventId) {
+        try {
+            const snapshot = await this.getCollection()
+                .where(EVENT_ENTRY_FIELDS.EVENT_ID, "==", eventId)
+                .where(EVENT_ENTRY_FIELDS.REVIEW_STATUS, "==", EVENT_ENTRY_FIELDS.REVIEW_STATUS_VALUES.APPROVED)
+                .get();
+            const counts = new Map();
+            for (const doc of snapshot.docs) {
+                const data = doc.data();
+                for (const optionId of data.pollVotes ?? []) {
+                    counts.set(optionId, (counts.get(optionId) ?? 0) + 1);
+                }
+            }
+            return Array.from(counts.entries()).map(([optionId, count]) => ({
+                optionId,
+                count,
+            }));
+        }
+        catch (error) {
+            void normalizeError(error);
+            throw new DatabaseError(`Failed to get poll results for event ${eventId}`, error);
+        }
+    }
+    /**
+     * Markdown export for the admin Event Entries view (AdminEventEntriesView
+     * "Download Report" button). For a poll event, renders the same
+     * per-option vote tally as getPollResults — the caller passes
+     * event.pollConfig.options since this repository has no access to the
+     * events collection to resolve labels itself. For every other event type
+     * (survey included — survey's points-based leaderboard is intentional,
+     * see getEventPollResults' doc comment in event-actions.ts), lists
+     * individual entries: submitter, submission date, review status, points,
+     * and form responses — mirroring what the on-screen table + "Responses"
+     * panel already show.
+     */
+    async getExportReport(eventId, event) {
+        try {
+            const lines = [];
+            lines.push(`# Event Entries Report — ${event.title}`);
+            lines.push("");
+            lines.push(`Generated ${new Date().toISOString()}`);
+            lines.push("");
+            lines.push("---");
+            lines.push("");
+            if (event.type === "poll" && event.pollOptions) {
+                const tally = await this.getPollResults(eventId);
+                const countByOption = new Map(tally.map((t) => [t.optionId, t.count]));
+                const total = tally.reduce((sum, t) => sum + t.count, 0);
+                lines.push("## Poll Results");
+                lines.push("");
+                if (total === 0) {
+                    lines.push("_No votes yet._");
+                    lines.push("");
+                }
+                else {
+                    lines.push(...formatPollResultLines(event.pollOptions, countByOption, total));
+                    lines.push("");
+                    lines.push(`${total} total vote${total === 1 ? "" : "s"}.`);
+                    lines.push("");
+                }
+                return lines.join("\n");
+            }
+            const snapshot = await this.getCollection()
+                .where(EVENT_ENTRY_FIELDS.EVENT_ID, "==", eventId)
+                .get();
+            const entries = snapshot.docs
+                .map((doc) => this.mapDoc(doc))
+                .sort((a, b) => b.submittedAt.getTime() - a.submittedAt.getTime());
+            lines.push(`## Entries (${entries.length})`);
+            lines.push("");
+            if (entries.length === 0) {
+                lines.push("_No entries yet._");
+                lines.push("");
+                return lines.join("\n");
+            }
+            for (const entry of entries) {
+                const who = entry.userDisplayName || entry.userEmail || entry.userId || "Guest";
+                lines.push(`### ${who}`);
+                lines.push(`- Submitted: ${entry.submittedAt.toISOString()}`);
+                lines.push(`- Status: ${entry.reviewStatus}`);
+                if (typeof entry.points === "number")
+                    lines.push(`- Points: ${entry.points}`);
+                if (entry.pollVotes && entry.pollVotes.length > 0) {
+                    lines.push(`- Poll votes: ${entry.pollVotes.join(", ")}`);
+                    if (entry.pollComment)
+                        lines.push(`- Comment: ${entry.pollComment}`);
+                }
+                if (entry.formResponses && Object.keys(entry.formResponses).length > 0) {
+                    lines.push("- Responses:");
+                    lines.push(...formatFormResponseLines(entry.formResponses));
+                }
+                lines.push("");
+            }
+            return lines.join("\n");
+        }
+        catch (error) {
+            void normalizeError(error);
+            throw new DatabaseError(`Failed to get export report for event ${eventId}`, error);
+        }
+    }
     async createEntry(input) {
         try {
             const now = new Date();