@mohasinac/appkit 2.7.59 → 2.8.0

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

@@ -88,7 +88,10 @@ export declare const ADMIN_USER_STATUS_TABS: readonly [{
     readonly id: "Disabled";
     readonly label: "Disabled";
 }];
-/** Admin > Users — role filter chip set. */
+/** Admin > Users — role filter chip set. IDs match the canonical UserRole
+ *  union ("user" | "seller" | "moderator" | "employee" | "admin") and the
+ *  Firestore `users/{uid}.role` field. The label "Buyer" maps to id "user"
+ *  per SB-UNI-E. Previously sent "buyer" which silently returned 0 rows. */
 export declare const ADMIN_USER_ROLE_TABS: readonly [{
     readonly id: "All";
     readonly label: "All";
@@ -99,11 +102,14 @@ export declare const ADMIN_USER_ROLE_TABS: readonly [{
     readonly id: "seller";
     readonly label: "Seller";
 }, {
-    readonly id: "buyer";
+    readonly id: "user";
     readonly label: "Buyer";
 }, {
     readonly id: "moderator";
     readonly label: "Moderator";
+}, {
+    readonly id: "employee";
+    readonly label: "Employee";
 }];
 /** Admin > Stores — seller-onboarding state filter chip set. */
 export declare const ADMIN_STORE_STATUS_TABS: readonly [{
@@ -122,49 +128,49 @@ export declare const ADMIN_STORE_STATUS_TABS: readonly [{
     readonly id: "rejected";
     readonly label: "Rejected";
 }];
-/** Admin > Payouts — payout state filter chip set. Uppercase IDs match the
- *  `PayoutDocument.status` enum on the server. */
+/** Admin > Payouts — payout state filter chip set. Lowercase IDs match
+ *  `PayoutStatusValues` and the actual Firestore document `status` field. */
 export declare const ADMIN_PAYOUT_STATUS_TABS: readonly [{
     readonly id: "All";
     readonly label: "All";
 }, {
-    readonly id: "PENDING";
+    readonly id: "pending";
     readonly label: "Pending";
 }, {
-    readonly id: "PROCESSING";
+    readonly id: "processing";
     readonly label: "Processing";
 }, {
-    readonly id: "PAID";
+    readonly id: "paid";
     readonly label: "Paid";
 }, {
-    readonly id: "FAILED";
+    readonly id: "failed";
     readonly label: "Failed";
 }];
-/** Admin > Orders — order-state filter chip set. Uppercase IDs match the
- *  `OrderDocument.status` enum on the server. */
+/** Admin > Orders — order-state filter chip set. Lowercase IDs match
+ *  `OrderStatusValues` and the actual Firestore document `status` field. */
 export declare const ADMIN_ORDER_STATUS_TABS: readonly [{
     readonly id: "All";
     readonly label: "All";
 }, {
-    readonly id: "PENDING";
+    readonly id: "pending";
     readonly label: "Pending";
 }, {
-    readonly id: "PROCESSING";
+    readonly id: "processing";
     readonly label: "Processing";
 }, {
-    readonly id: "SHIPPED";
+    readonly id: "shipped";
     readonly label: "Shipped";
 }, {
-    readonly id: "DELIVERED";
+    readonly id: "delivered";
     readonly label: "Delivered";
 }, {
-    readonly id: "CANCELLED";
+    readonly id: "cancelled";
     readonly label: "Cancelled";
 }, {
-    readonly id: "REFUNDED";
+    readonly id: "refunded";
     readonly label: "Refunded";
 }, {
-    readonly id: "RETURN_REQUESTED";
+    readonly id: "return_requested";
     readonly label: "Return Requested";
 }];
 /** Admin > Reviews — moderation state filter chip set. */

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

@@ -43,13 +43,17 @@ export const ADMIN_USER_STATUS_TABS = [
     { id: "Active", label: "Active" },
     { id: "Disabled", label: "Disabled" },
 ];
-/** Admin > Users — role filter chip set. */
+/** Admin > Users — role filter chip set. IDs match the canonical UserRole
+ *  union ("user" | "seller" | "moderator" | "employee" | "admin") and the
+ *  Firestore `users/{uid}.role` field. The label "Buyer" maps to id "user"
+ *  per SB-UNI-E. Previously sent "buyer" which silently returned 0 rows. */
 export const ADMIN_USER_ROLE_TABS = [
     ALL_TAB,
     { id: "admin", label: "Admin" },
     { id: "seller", label: "Seller" },
-    { id: "buyer", label: "Buyer" },
+    { id: "user", label: "Buyer" },
     { id: "moderator", label: "Moderator" },
+    { id: "employee", label: "Employee" },
 ];
 /** Admin > Stores — seller-onboarding state filter chip set. */
 export const ADMIN_STORE_STATUS_TABS = [
@@ -59,26 +63,26 @@ export const ADMIN_STORE_STATUS_TABS = [
     { id: "suspended", label: "Suspended" },
     { id: "rejected", label: "Rejected" },
 ];
-/** Admin > Payouts — payout state filter chip set. Uppercase IDs match the
- *  `PayoutDocument.status` enum on the server. */
+/** Admin > Payouts — payout state filter chip set. Lowercase IDs match
+ *  `PayoutStatusValues` and the actual Firestore document `status` field. */
 export const ADMIN_PAYOUT_STATUS_TABS = [
     ALL_TAB,
-    { id: "PENDING", label: "Pending" },
-    { id: "PROCESSING", label: "Processing" },
-    { id: "PAID", label: "Paid" },
-    { id: "FAILED", label: "Failed" },
+    { id: "pending", label: "Pending" },
+    { id: "processing", label: "Processing" },
+    { id: "paid", label: "Paid" },
+    { id: "failed", label: "Failed" },
 ];
-/** Admin > Orders — order-state filter chip set. Uppercase IDs match the
- *  `OrderDocument.status` enum on the server. */
+/** Admin > Orders — order-state filter chip set. Lowercase IDs match
+ *  `OrderStatusValues` and the actual Firestore document `status` field. */
 export const ADMIN_ORDER_STATUS_TABS = [
     ALL_TAB,
-    { id: "PENDING", label: "Pending" },
-    { id: "PROCESSING", label: "Processing" },
-    { id: "SHIPPED", label: "Shipped" },
-    { id: "DELIVERED", label: "Delivered" },
-    { id: "CANCELLED", label: "Cancelled" },
-    { id: "REFUNDED", label: "Refunded" },
-    { id: "RETURN_REQUESTED", label: "Return Requested" },
+    { id: "pending", label: "Pending" },
+    { id: "processing", label: "Processing" },
+    { id: "shipped", label: "Shipped" },
+    { id: "delivered", label: "Delivered" },
+    { id: "cancelled", label: "Cancelled" },
+    { id: "refunded", label: "Refunded" },
+    { id: "return_requested", label: "Return Requested" },
 ];
 /** Admin > Reviews — moderation state filter chip set. */
 export const ADMIN_REVIEW_STATUS_TABS = [

package/dist/features/admin/hooks/useAdminListing.d.ts

@@ -9,6 +9,7 @@ export interface AdminListingConfig<TResponse, TRow extends {
     mapRows: (response: TResponse) => TRow[];
     getTotal?: (response: TResponse, rows: TRow[]) => number;
     buildFilters: (filterState: Record<string, string>) => string | undefined;
+    initialView?: "grid" | "list" | "table";
 }
 export declare function useAdminListing<TResponse, TRow extends {
     id: string;

package/dist/features/admin/hooks/useAdminListing.js

@@ -6,7 +6,7 @@ import { usePanelUrlSync } from "../../../react/hooks/use-panel-url-sync";
 import { useAdminListingData } from "./useAdminListingData";
 export function useAdminListing(config) {
     const { filterKeys, defaultSort, pageSize = 25, queryKey, endpoint, mapRows, getTotal, buildFilters, } = config;
-    const [view, setView] = useState("table");
+    const [view, setView] = useState(config.initialView ?? "table");
     const table = useUrlTable({ defaults: { pageSize: String(pageSize), sort: defaultSort } });
     const panel = usePanelUrlSync();
     const [searchInput, setSearchInput] = useState(table.get("q") || "");

package/dist/features/admin/schemas/firestore.js

@@ -183,19 +183,18 @@ export const DEFAULT_SITE_SETTINGS_DATA = {
         coupons: true,
         notifications: true,
         sellerRegistration: true,
-        preOrders: false,
+        preOrders: true,
         seedPanel: true,
-        // SB-UNI-X4 2026-05-13 — Phase 1 types enabled by default; Phase 2 types
-        // (classified / digital-code / live) gated until per-type Phase 3 + 5
-        // surfaces ship. Admin Feature Flags UI lets the operator flip them.
+        // W1-37 2026-05-23 — Phase 2 listing types enabled by default; all per-type
+        // surfaces (seller + admin via W1-29 + public) are now shipped.
         listingTypes: {
             standard: true,
             auction: true,
             "pre-order": true,
             "prize-draw": true,
-            classified: false,
-            "digital-code": false,
-            live: false,
+            classified: true,
+            "digital-code": true,
+            live: true,
         },
         categoryTypes: {
             category: true,

package/dist/features/auctions/server.d.ts

@@ -4,6 +4,5 @@
  * Server-only entry point for auction API route handlers.
  */
 export * from "./actions";
-export { AuctionsRepository } from "./repository/auctions.repository";
 export { bidRepository } from "./repository/bid.repository";
 export { GET as bidsGET, GET } from "./api/route";

package/dist/features/auctions/server.js

@@ -4,6 +4,5 @@
  * Server-only entry point for auction API route handlers.
  */
 export * from "./actions";
-export { AuctionsRepository } from "./repository/auctions.repository";
 export { bidRepository } from "./repository/bid.repository";
 export { GET as bidsGET, GET } from "./api/route";

package/dist/features/auth/actions/realtime-token-actions.js

@@ -18,7 +18,7 @@ export async function issueRealtimeToken(userId, userRole) {
     catch (err) {
         serverLogger.warn("Could not resolve chatIds for realtime token", { userId, err });
     }
-    let conversationIds = {};
+    const conversationIds = {};
     try {
         const buyerConvs = await conversationsRepository.listByBuyer(userId);
         buyerConvs.forEach((c) => { conversationIds[c.id] = true; });

package/dist/features/auth/repository/user.repository.js

@@ -22,7 +22,7 @@ export class UserRepository extends BaseRepository {
         // addPiiIndices is intentionally NOT called here — it spreads the original
         // plaintext `data` back into the result, which would overwrite the encrypted
         // ciphertext with the original plaintext values, defeating the encryption.
-        let encrypted = encryptPiiFields(data, [...USER_PII_FIELDS]);
+        const encrypted = encryptPiiFields(data, [...USER_PII_FIELDS]);
         if (encrypted.payoutDetails) {
             encrypted.payoutDetails =
                 encryptPayoutDetails(encrypted.payoutDetails);

package/dist/features/cart/repository/cart.repository.d.ts

@@ -1,9 +1,12 @@
 import type { DocumentReference } from "firebase-admin/firestore";
 import type { DocumentSnapshot } from "../../../providers/db-firebase";
-import { BaseRepository } from "../../../providers/db-firebase";
+import { BaseRepository, type FirebaseSieveResult, type SieveModel } from "../../../providers/db-firebase";
 import { type AddToCartInput, type CartAppliedCoupon, type CartDocument, type UpdateCartItemInput } from "../schemas";
 export declare class CartRepository extends BaseRepository<CartDocument> {
+    private static readonly SIEVE_FIELDS;
     constructor();
+    /** Admin-facing paginated list of carts. */
+    list(model: SieveModel): Promise<FirebaseSieveResult<CartDocument>>;
     protected mapDoc<D = CartDocument>(snap: DocumentSnapshot): D;
     findByUserId(userId: string): Promise<CartDocument | null>;
     getOrCreate(userId: string): Promise<CartDocument>;

package/dist/features/cart/repository/cart.repository.js

@@ -9,6 +9,10 @@ export class CartRepository extends BaseRepository {
     constructor() {
         super(CART_COLLECTION);
     }
+    /** Admin-facing paginated list of carts. */
+    async list(model) {
+        return this.sieveQuery(model, CartRepository.SIEVE_FIELDS);
+    }
     mapDoc(snap) {
         const raw = super.mapDoc(snap);
         return {
@@ -279,4 +283,12 @@ export class CartRepository extends BaseRepository {
         return snap.docs.map((d) => d.ref);
     }
 }
+// W1-42 — admin-facing Sieve list. Filterable on userId, sessionId, updatedAt;
+// sortable on updatedAt.
+CartRepository.SIEVE_FIELDS = {
+    userId: { canFilter: true, canSort: false },
+    sessionId: { canFilter: true, canSort: false },
+    updatedAt: { canFilter: true, canSort: true },
+    createdAt: { canFilter: true, canSort: true },
+};
 export const cartRepository = new CartRepository();

package/dist/features/checkout/hooks/useCheckoutApi.d.ts

@@ -22,8 +22,6 @@ export interface PreflightResponse {
     available: any[];
     unavailable: UnavailableItem[];
 }
-/** @deprecated Use `CreatePaymentOrderResponse` instead. */
-export type CreateRazorpayOrderResponse = CreatePaymentOrderResponse;
 export interface CreatePaymentOrderResponse {
     gatewayOrderId: string;
     amount: number;

package/dist/features/checkout/index.d.ts

@@ -2,7 +2,7 @@ export * from "./types";
 export * from "./schemas";
 export * from "./hooks/useCheckout";
 export { useCheckout as useCheckoutApi } from "./hooks/useCheckoutApi";
-export type { AddressListResponse, CartApiResponse, PlaceOrderResponse, CreatePaymentOrderResponse, CreateRazorpayOrderResponse, UnavailableItem, PreflightResponse, } from "./hooks/useCheckoutApi";
+export type { AddressListResponse, CartApiResponse, PlaceOrderResponse, CreatePaymentOrderResponse, UnavailableItem, PreflightResponse, } from "./hooks/useCheckoutApi";
 export * from "./hooks/usePaymentCheckout";
 export * from "./components";
 export { manifest } from "./manifest";

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

@@ -1,7 +1,7 @@
-import type { ListingViewShellProps } from "../../../ui";
-export interface AdminEventsViewProps extends ListingViewShellProps {
+import type { ListingLayoutProps } from "../../../ui";
+export interface AdminEventsViewProps extends ListingLayoutProps {
     getRowHref?: (row: {
         id: string;
     }) => string;
 }
-export declare function AdminEventsView({ children, getRowHref, ...props }: AdminEventsViewProps): import("react/jsx-runtime").JSX.Element;
+export declare function AdminEventsView({ children, ...props }: AdminEventsViewProps): import("react/jsx-runtime").JSX.Element;

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

@@ -1,28 +1,12 @@
 "use client";
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import React, { useState, useCallback } from "react";
-import { Plus } from "lucide-react";
-import { useUrlTable } from "../../../react/hooks/useUrlTable";
-import { useBulkSelection } from "../../../react/hooks/useBulkSelection";
-import { AdminViewCards } from "../../admin/components/AdminViewCards";
-import { usePanelUrlSync } from "../../../react/hooks/use-panel-url-sync";
-import { BulkActionBar, Button, FilterChipGroup, ListingFilterDrawer, ListingToolbar, Pagination, ListingViewShell, SideDrawer } from "../../../ui";
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import React from "react";
+import { FilterChipGroup, ListingLayout } from "../../../ui";
 import { ADMIN_ENDPOINTS } from "../../../constants/api-endpoints";
 import { ADMIN_EVENT_STATUS_TABS } from "../../admin/constants/filter-tabs";
-import { toRecordArray, toRelativeDate, toStringValue, useAdminListingData, } from "../../admin/hooks/useAdminListingData";
-import { DataTable } from "../../admin/components/DataTable";
+import { toRecordArray, toRelativeDate, toStringValue, } from "../../admin/hooks/useAdminListingData";
+import { DataListingView } from "../../admin/components/DataListingView";
 import { AdminEventEditorView } from "./AdminEventEditorView";
-import { useBottomActions } from "../../layout";
-const PAGE_SIZE = 25;
-const FILTER_KEYS = ["status", "type"];
-const DEFAULT_SORT = "-startsAt";
-const SORT_OPTIONS = [
-    { value: "-startsAt", label: "Starting soonest" },
-    { value: "startsAt", label: "Starting latest" },
-    { value: "-createdAt", label: "Newest" },
-    { value: "title", label: "Title A–Z" },
-];
-const STATUS_OPTIONS = ADMIN_EVENT_STATUS_TABS;
 // TODO(events): TYPE_OPTIONS list pre-dates the SB9 EventType union refresh
 // (sale|offer|poll|survey|feedback|raffle|spin_wheel). Keep current values to
 // avoid silently breaking saved-filter URLs — sync in a dedicated follow-up.
@@ -35,78 +19,58 @@ const TYPE_OPTIONS = [
     { id: "survey", label: "Survey" },
     { id: "flash-sale", label: "Flash Sale" },
 ];
-export function AdminEventsView({ children, getRowHref, ...props }) {
-    const hasChildren = React.Children.count(children) > 0;
-    const [view, setView] = useState("table");
-    const table = useUrlTable({ defaults: { pageSize: String(PAGE_SIZE), sort: DEFAULT_SORT } });
-    const { openCreatePanel, openEditPanel, closePanel, isCreateOpen, isEditOpen, editId } = usePanelUrlSync();
-    const [searchInput, setSearchInput] = useState(table.get("q") || "");
-    const [filterOpen, setFilterOpen] = useState(false);
-    const [pendingFilters, setPendingFilters] = useState(() => Object.fromEntries(FILTER_KEYS.map((k) => [k, table.get(k)])));
-    const openFilters = useCallback(() => {
-        setPendingFilters(Object.fromEntries(FILTER_KEYS.map((k) => [k, table.get(k)])));
-        setFilterOpen(true);
-    }, [table]);
-    const applyFilters = useCallback(() => {
-        const updates = { page: "1" };
-        for (const k of FILTER_KEYS)
-            updates[k] = pendingFilters[k] ?? "";
-        table.setMany(updates);
-        setFilterOpen(false);
-    }, [pendingFilters, table]);
-    const clearFilters = useCallback(() => {
-        setPendingFilters(Object.fromEntries(FILTER_KEYS.map((k) => [k, ""])));
-    }, []);
-    const resetAll = useCallback(() => {
-        const updates = { q: "", sort: "" };
-        for (const k of FILTER_KEYS)
-            updates[k] = "";
-        table.setMany(updates);
-        setSearchInput("");
-    }, [table]);
-    const commitSearch = useCallback(() => {
-        table.set("q", searchInput.trim());
-    }, [searchInput, table]);
-    const activeFilterCount = FILTER_KEYS.filter((k) => !!table.get(k)).length;
-    const hasActiveState = !!table.get("q") || table.get("sort") !== DEFAULT_SORT || activeFilterCount > 0;
-    const filterParts = [];
-    const statusRaw = table.get("status");
-    if (statusRaw && statusRaw !== "All")
-        filterParts.push(`status==${statusRaw}`);
-    const typeRaw = table.get("type");
-    if (typeRaw && typeRaw !== "All")
-        filterParts.push(`type==${typeRaw}`);
-    const filters = filterParts.join(",") || undefined;
-    const { rows, total, isLoading, errorMessage } = useAdminListingData({
+export function AdminEventsView({ children, ...props }) {
+    if (React.Children.count(children) > 0) {
+        return (_jsx(ListingLayout, { portal: "admin", ...props, children: children }));
+    }
+    const config = {
+        portal: "admin",
+        title: "Events",
+        searchPlaceholder: "Search events by title or type",
+        emptyLabel: "No events found",
+        filterKeys: ["status", "type"],
+        defaultSort: "-startsAt",
         queryKey: ["admin", "events", "listing"],
         endpoint: ADMIN_ENDPOINTS.EVENTS,
-        page: table.getNumber("page", 1),
-        pageSize: PAGE_SIZE,
-        sorts: table.get("sort") || DEFAULT_SORT,
-        filters,
-        q: table.get("q") || undefined,
+        sortOptions: [
+            { value: "-startsAt", label: "Starting soonest" },
+            { value: "startsAt", label: "Starting latest" },
+            { value: "-createdAt", label: "Newest" },
+            { value: "title", label: "Title A–Z" },
+        ],
         mapRows: (response) => toRecordArray(response.items).map((item, index) => ({
             id: toStringValue(item.id, `event-${index}`),
             primary: toStringValue(item.title, "Untitled event"),
-            secondary: [
-                toStringValue(item.type, "event"),
-                toStringValue(item.startsAt, ""),
-            ].filter(Boolean).join(" · "),
+            secondary: [toStringValue(item.type, "event"), toStringValue(item.startsAt, "")]
+                .filter(Boolean)
+                .join(" · "),
             status: toStringValue(item.status, "active"),
             updatedAt: toRelativeDate(item.updatedAt ?? item.createdAt),
         })),
         getTotal: (response, mappedRows) => typeof response.total === "number" ? response.total : mappedRows.length,
-    });
-    const currentPage = table.getNumber("page", 1);
-    const totalPages = Math.ceil(total / PAGE_SIZE);
-    const selection = useBulkSelection({ items: rows, keyExtractor: (r) => r.id });
-    if (hasChildren) {
-        return _jsx(ListingViewShell, { portal: "admin", ...props, children: children });
-    }
-    useBottomActions(selection.selectedCount > 0 ? { bulk: { selectedCount: selection.selectedCount, onClearSelection: selection.clearSelection, actions: [
-                { id: "delete", label: "Delete Selected", variant: "secondary", onClick: () => { selection.clearSelection(); } },
-            ] } } : {});
-    return (_jsxs("div", { className: "min-h-screen", children: [_jsx(ListingToolbar, { filterCount: activeFilterCount, onFiltersClick: openFilters, searchValue: searchInput, searchPlaceholder: "Search events by title or type", onSearchChange: setSearchInput, onSearchCommit: commitSearch, sortValue: table.get("sort") || DEFAULT_SORT, sortOptions: SORT_OPTIONS, onSortChange: (v) => { table.set("sort", v); }, showTableView: true, view: view, onViewChange: (v) => setView(v), onResetAll: resetAll, hasActiveState: hasActiveState, extra: _jsxs(Button, { size: "sm", onClick: openCreatePanel, className: "flex items-center gap-1.5", children: [_jsx(Plus, { className: "h-4 w-4" }), "Add Event"] }) }), _jsx(BulkActionBar, { selectedCount: selection.selectedCount, onClearSelection: selection.clearSelection, actions: [
-                    { id: "delete", label: "Delete Selected", variant: "secondary", onClick: () => { selection.clearSelection(); } },
-                ] }), totalPages > 1 && (_jsx("div", { className: "sticky top-[calc(var(--header-height,0px)+44px)] z-10 flex justify-center bg-white/95 dark:bg-slate-900/95 backdrop-blur-sm border-b border-zinc-200 dark:border-slate-700 px-3 py-1.5", children: _jsx(Pagination, { currentPage: currentPage, totalPages: totalPages, onPageChange: (p) => table.setPage(p) }) })), _jsxs("div", { className: "py-4 px-3 sm:px-4", children: [errorMessage && (_jsx("div", { className: "mb-4 rounded-xl border border-red-200 bg-error-surface px-4 py-3 text-sm text-error dark:border-red-900/60", children: errorMessage })), view === "table" ? (_jsx(DataTable, { rows: rows, isLoading: isLoading, emptyLabel: "No events found", onRowClick: (row) => openEditPanel(row.id) })) : (_jsx(AdminViewCards, { rows: rows, view: view, isLoading: isLoading, emptyLabel: "No events found", onRowClick: undefined, selectedIdSet: selection.selectedIdSet, onToggleSelect: selection.toggle }))] }), _jsxs(ListingFilterDrawer, { open: filterOpen, onClose: () => setFilterOpen(false), onApply: applyFilters, onClear: clearFilters, activeCount: activeFilterCount, children: [_jsx(FilterChipGroup, { label: "Status", tabs: STATUS_OPTIONS, value: pendingFilters.status ?? "", onChange: (id) => setPendingFilters((p) => ({ ...p, status: id })) }), _jsx(FilterChipGroup, { label: "Type", tabs: TYPE_OPTIONS, value: pendingFilters.type ?? "", onChange: (id) => setPendingFilters((p) => ({ ...p, type: id })) })] }), _jsx(SideDrawer, { isOpen: isCreateOpen || isEditOpen, onClose: closePanel, title: isCreateOpen ? "Add Event" : "Edit Event", mode: isCreateOpen ? "create" : "edit", children: (isCreateOpen || isEditOpen) && (_jsx(AdminEventEditorView, { eventId: editId ?? undefined, onSaved: closePanel, embedded: true })) })] }));
+        buildFilters: (state) => {
+            const parts = [];
+            if (state.status && state.status !== "All")
+                parts.push(`status==${state.status}`);
+            if (state.type && state.type !== "All")
+                parts.push(`type==${state.type}`);
+            return parts.join(",") || undefined;
+        },
+        primaryAction: {
+            label: "Add Event",
+            onClick: ({ openCreatePanel }) => openCreatePanel(),
+        },
+        buildBulkActions: (selection) => [
+            {
+                id: "delete",
+                label: "Delete Selected",
+                variant: "secondary",
+                onClick: () => selection.clearSelection(),
+            },
+        ],
+        renderFilterPanel: ({ pendingFilters, setPendingFilters }) => (_jsxs(_Fragment, { children: [_jsx(FilterChipGroup, { label: "Status", tabs: ADMIN_EVENT_STATUS_TABS, value: pendingFilters.status ?? "", onChange: (id) => setPendingFilters((p) => ({ ...p, status: id })) }), _jsx(FilterChipGroup, { label: "Type", tabs: TYPE_OPTIONS, value: pendingFilters.type ?? "", onChange: (id) => setPendingFilters((p) => ({ ...p, type: id })) })] })),
+        renderEditor: ({ editId, closePanel }) => (_jsx(AdminEventEditorView, { eventId: editId ?? undefined, onSaved: closePanel, embedded: true })),
+        resolveEditorTitle: ({ isCreate }) => (isCreate ? "Add Event" : "Edit Event"),
+    };
+    return _jsx(DataListingView, { config: config });
 }

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

@@ -0,0 +1,19 @@
+export interface EventOfferCardProps {
+    /** Coupon code to copy. */
+    couponCode: string;
+    /** Description of what the coupon does. */
+    offerDescription?: string;
+    /** Headline. */
+    title?: string;
+    /** Optional filter param for the CTA — e.g. {key: "category", value: "trading-cards"}. */
+    filterParam?: {
+        key: string;
+        value: string;
+    };
+}
+/**
+ * `EventOfferCard` — W1-18 — offer event UI noted as missing in the plan.
+ * Renders a coupon code with copy-to-clipboard + a CTA to the filtered
+ * products page.
+ */
+export declare function EventOfferCard({ couponCode, offerDescription, title, filterParam, }: EventOfferCardProps): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,29 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useState } from "react";
+import Link from "next/link";
+import { Div, Heading, Stack, Text } from "../../../ui";
+import { Button } from "../../../ui/components/Button";
+import { ROUTES } from "../../../next/routing/route-map";
+/**
+ * `EventOfferCard` — W1-18 — offer event UI noted as missing in the plan.
+ * Renders a coupon code with copy-to-clipboard + a CTA to the filtered
+ * products page.
+ */
+export function EventOfferCard({ couponCode, offerDescription, title = "Exclusive offer", filterParam, }) {
+    const [copied, setCopied] = useState(false);
+    const href = filterParam
+        ? `${ROUTES.PUBLIC.PRODUCTS}?${encodeURIComponent(filterParam.key)}=${encodeURIComponent(filterParam.value)}`
+        : String(ROUTES.PUBLIC.PRODUCTS);
+    const copyCode = async () => {
+        try {
+            await navigator.clipboard.writeText(couponCode);
+            setCopied(true);
+            setTimeout(() => setCopied(false), 2000);
+        }
+        catch {
+            /* clipboard unavailable — leave button as-is */
+        }
+    };
+    return (_jsx(Div, { className: "rounded-2xl border border-zinc-200 dark:border-zinc-700 p-6", children: _jsxs(Stack, { gap: "md", children: [_jsxs(Stack, { gap: "xs", children: [_jsx(Heading, { level: 2, className: "text-2xl font-semibold", children: title }), offerDescription ? (_jsx(Text, { className: "text-sm text-zinc-600 dark:text-zinc-400", children: offerDescription })) : null] }), _jsxs(Div, { className: "flex items-center gap-3 rounded-lg bg-zinc-50 dark:bg-zinc-900 px-4 py-3", children: [_jsx("code", { className: "flex-1 font-mono text-lg font-bold text-zinc-900 dark:text-zinc-100", children: couponCode }), _jsx(Button, { type: "button", variant: "outline", onClick: copyCode, children: copied ? "Copied!" : "Copy code" })] }), _jsx(Div, { children: _jsx(Link, { href: href, children: _jsx(Button, { variant: "primary", children: "Apply at checkout" }) }) })] }) }));
+}

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

@@ -0,0 +1,25 @@
+export interface EventRaffleEntryFormProps {
+    /** Event id used for the entry POST. */
+    eventId: string;
+    /** Raffle prize label rendered prominently above the form. */
+    prizeLabel?: string;
+    /** Raffle type — drives the helper copy. */
+    raffleType?: "open_raffle" | "top_n_scorers" | "top_n_participants" | "spin_wheel";
+    /** Top-N value when raffleType supports it. */
+    topN?: number;
+    /** Max entries this user already has (drives the over-limit message). */
+    userEntryCount?: number;
+    /** Server-enforced max entries per user (defaults to 1). */
+    maxEntriesPerUser?: number;
+    /** When true, the form is in a submitted/locked state. */
+    submitted?: boolean;
+    /** Caller-provided submit handler. Receives the user's optional message. */
+    onSubmit: (message: string) => Promise<void> | void;
+}
+/**
+ * `EventRaffleEntryForm` — W1-18 — fills the gap noted in the plan ("Raffle
+ * entry form (71 LOC stub) — no entry form"). Renders the prize hero,
+ * eligibility status, an optional message field, and a submit button. Server
+ * action wiring stays with the caller via the `onSubmit` prop.
+ */
+export declare function EventRaffleEntryForm({ eventId: _eventId, prizeLabel, raffleType, topN, userEntryCount, maxEntriesPerUser, submitted, onSubmit, }: EventRaffleEntryFormProps): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,37 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useState } from "react";
+import { Button } from "../../../ui/components/Button";
+import { Div, Heading, Stack, Text } from "../../../ui";
+import { Badge } from "../../../ui/components/Badge";
+/**
+ * `EventRaffleEntryForm` — W1-18 — fills the gap noted in the plan ("Raffle
+ * entry form (71 LOC stub) — no entry form"). Renders the prize hero,
+ * eligibility status, an optional message field, and a submit button. Server
+ * action wiring stays with the caller via the `onSubmit` prop.
+ */
+export function EventRaffleEntryForm({ eventId: _eventId, prizeLabel, raffleType = "open_raffle", topN, userEntryCount = 0, maxEntriesPerUser = 1, submitted = false, onSubmit, }) {
+    const [message, setMessage] = useState("");
+    const [busy, setBusy] = useState(false);
+    const overLimit = userEntryCount >= maxEntriesPerUser;
+    const handleSubmit = async (e) => {
+        e.preventDefault();
+        if (overLimit || submitted || busy)
+            return;
+        setBusy(true);
+        try {
+            await onSubmit(message.trim());
+        }
+        finally {
+            setBusy(false);
+        }
+    };
+    const eligibilityCopy = raffleType === "open_raffle"
+        ? "Open to all eligible participants — one entry per user."
+        : raffleType === "top_n_scorers"
+            ? `Top ${topN ?? "N"} highest-scoring entries win.`
+            : raffleType === "top_n_participants"
+                ? `Earliest ${topN ?? "N"} entries qualify.`
+                : "Spin the wheel to claim your prize.";
+    return (_jsxs(Div, { className: "rounded-2xl border border-zinc-200 dark:border-zinc-700 p-6 space-y-4", children: [prizeLabel ? (_jsxs(Stack, { gap: "xs", children: [_jsx(Badge, { variant: "warning", children: "Prize" }), _jsx(Heading, { level: 2, className: "text-2xl font-bold", children: prizeLabel })] })) : null, _jsx(Text, { className: "text-sm text-zinc-600 dark:text-zinc-400", children: eligibilityCopy }), submitted ? (_jsx(Div, { className: "rounded-lg bg-success-surface px-4 py-3 text-sm text-success", children: "You're in. Check the leaderboard for results." })) : overLimit ? (_jsxs(Div, { className: "rounded-lg bg-warning-surface px-4 py-3 text-sm text-warning", children: ["You've used all ", maxEntriesPerUser, " entry slot", maxEntriesPerUser === 1 ? "" : "s", " for this raffle."] })) : (_jsxs("form", { onSubmit: handleSubmit, className: "space-y-3", children: [_jsxs("label", { htmlFor: "raffle-message", className: "block text-sm font-medium", children: ["Message ", _jsx("span", { className: "text-zinc-400", children: "(optional)" })] }), _jsx("textarea", { id: "raffle-message", value: message, onChange: (e) => setMessage(e.target.value), rows: 3, maxLength: 500, className: "w-full rounded-lg border border-zinc-300 dark:border-zinc-700 px-3 py-2 text-sm bg-white dark:bg-zinc-900 focus:outline-none focus:ring-2 focus:ring-[var(--appkit-color-primary)]", placeholder: "Share why you'd like to win", disabled: busy }), _jsx(Button, { type: "submit", variant: "primary", disabled: busy, children: busy ? "Submitting…" : "Enter raffle" })] }))] }));
+}

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

@@ -4,9 +4,6 @@ export interface EventRafflesSectionProps {
 }
 /**
  * Renders a live-raffle/spin-wheel strip on the homepage.
- *
- * Reads events with `hasRaffle=true` and status in {"active","upcoming"}. The
- * `hasRaffle` flag is added later with the raffle feature; for now the
- * component renders an empty state and the section ships disabled in seed.
+ * W1-38 (2026-05-23): fetches events with hasRaffle=true and renders the EventCard grid.
  */
 export declare function EventRafflesSection({ config, }: EventRafflesSectionProps): Promise<import("react/jsx-runtime").JSX.Element>;