@mohasinac/appkit 4.3.2 → 4.4.1

package/dist/features/stores/components/StoreProductsView.js

@@ -1,6 +1,6 @@
 "use client";
 import { jsx as _jsx } from "react/jsx-runtime";
-import { sortBy } from "@mohasinac/appkit";
+import { sortBy } from "@mohasinac/appkit/client";
 import { useState } from "react";
 import { Div, Heading, Input, Select, SlottedListingView } from "../../../ui";
 export function StoreProductsView({ storeSlug, labels = {}, renderProducts, renderSearch, renderSort, renderFilters, renderActiveFilters, renderViewToggle, renderPagination, items = [], total = 0, isLoading = false, className = "", }) {

package/dist/features/stores/components/StoresIndexListing.js

@@ -1,6 +1,6 @@
 "use client";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { Row, SIEVE_OP, Stack, sieveFilter } from "@mohasinac/appkit";
+import { Row, SIEVE_OP, Stack, sieveFilter } from "@mohasinac/appkit/client";
 import { useState, useCallback, useMemo } from "react";
 import { useUrlTable } from "../../../react/hooks/useUrlTable";
 import { useStores } from "../hooks/useStores";

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

@@ -412,19 +412,28 @@ export declare const storeFirestoreSchema: z.ZodObject<{
     }, z.ZodTypeAny, "passthrough">;
     storeName: string;
     isPublic: boolean;
-    storeSlug: string;
     ownerId: string;
+    storeSlug: string;
     location?: string | undefined;
     returnPolicy?: string | undefined;
+    isFeatured?: boolean | undefined;
+    socialLinks?: {
+        instagram?: string | undefined;
+        facebook?: string | undefined;
+        twitter?: string | undefined;
+        linkedin?: string | undefined;
+    } | undefined;
     stats?: {
         itemsSold: number;
         totalProducts: number;
         totalReviews: number;
         averageRating?: number | undefined;
     } | undefined;
-    isFeatured?: boolean | undefined;
-    emiEnabled?: boolean | undefined;
-    website?: string | undefined;
+    storeCategory?: string | undefined;
+    storeDescription?: string | undefined;
+    storeLogoURL?: string | undefined;
+    storeBannerURL?: string | undefined;
+    capabilities?: string[] | undefined;
     shippingConfig?: {
         providers: {
             type: "custom" | "self-courier" | "store-pickup";
@@ -444,21 +453,12 @@ export declare const storeFirestoreSchema: z.ZodObject<{
         }[];
         defaultProviderId: string;
     } | undefined;
-    storeCategory?: string | undefined;
-    storeDescription?: string | undefined;
-    storeLogoURL?: string | undefined;
-    storeBannerURL?: string | undefined;
     bio?: string | undefined;
-    socialLinks?: {
-        instagram?: string | undefined;
-        facebook?: string | undefined;
-        twitter?: string | undefined;
-        linkedin?: string | undefined;
-    } | undefined;
+    website?: string | undefined;
+    emiEnabled?: boolean | undefined;
     shippingPolicy?: string | undefined;
     isVacationMode?: boolean | undefined;
     vacationMessage?: string | undefined;
-    capabilities?: string[] | undefined;
     vacationReturnDate?: string | Date | z.objectOutputType<{
         toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
     }, z.ZodTypeAny, "passthrough"> | undefined;
@@ -497,19 +497,28 @@ export declare const storeFirestoreSchema: z.ZodObject<{
     }, z.ZodTypeAny, "passthrough">;
     storeName: string;
     isPublic: boolean;
-    storeSlug: string;
     ownerId: string;
+    storeSlug: string;
     location?: string | undefined;
     returnPolicy?: string | undefined;
+    isFeatured?: boolean | undefined;
+    socialLinks?: {
+        instagram?: string | undefined;
+        facebook?: string | undefined;
+        twitter?: string | undefined;
+        linkedin?: string | undefined;
+    } | undefined;
     stats?: {
         itemsSold: number;
         totalProducts: number;
         totalReviews: number;
         averageRating?: number | undefined;
     } | undefined;
-    isFeatured?: boolean | undefined;
-    emiEnabled?: boolean | undefined;
-    website?: string | undefined;
+    storeCategory?: string | undefined;
+    storeDescription?: string | undefined;
+    storeLogoURL?: string | undefined;
+    storeBannerURL?: string | undefined;
+    capabilities?: string[] | undefined;
     shippingConfig?: {
         providers: {
             type: "custom" | "self-courier" | "store-pickup";
@@ -529,21 +538,12 @@ export declare const storeFirestoreSchema: z.ZodObject<{
         }[];
         defaultProviderId: string;
     } | undefined;
-    storeCategory?: string | undefined;
-    storeDescription?: string | undefined;
-    storeLogoURL?: string | undefined;
-    storeBannerURL?: string | undefined;
     bio?: string | undefined;
-    socialLinks?: {
-        instagram?: string | undefined;
-        facebook?: string | undefined;
-        twitter?: string | undefined;
-        linkedin?: string | undefined;
-    } | undefined;
+    website?: string | undefined;
+    emiEnabled?: boolean | undefined;
     shippingPolicy?: string | undefined;
     isVacationMode?: boolean | undefined;
     vacationMessage?: string | undefined;
-    capabilities?: string[] | undefined;
     vacationReturnDate?: string | Date | z.objectInputType<{
         toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
     }, z.ZodTypeAny, "passthrough"> | undefined;
@@ -609,8 +609,8 @@ export declare const storeListItemSchema: z.ZodObject<{
     id: string;
     storeName: string;
     isPublic: boolean;
-    storeSlug: string;
     ownerId: string;
+    storeSlug: string;
     createdAt?: string | undefined;
     itemsSold?: number | undefined;
     storeCategory?: string | undefined;
@@ -625,8 +625,8 @@ export declare const storeListItemSchema: z.ZodObject<{
     id: string;
     storeName: string;
     isPublic: boolean;
-    storeSlug: string;
     ownerId: string;
+    storeSlug: string;
     createdAt?: string | undefined;
     itemsSold?: number | undefined;
     storeCategory?: string | undefined;

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

@@ -158,7 +158,7 @@ export declare const supportTicketFirestoreSchema: z.ZodObject<{
         toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
     }, z.ZodTypeAny, "passthrough">;
     userId: string;
-    category: "account" | "general" | "order_issue" | "billing_payment" | "listing_dispute" | "scam_report" | "refund_request" | "auction_dispute" | "store_change_request" | "order_modification_request" | "unban_request";
+    category: "general" | "account" | "order_issue" | "billing_payment" | "listing_dispute" | "scam_report" | "refund_request" | "auction_dispute" | "store_change_request" | "order_modification_request" | "unban_request";
     description: string;
     priority: "normal" | "high" | "low" | "urgent";
     messages: {
@@ -201,7 +201,7 @@ export declare const supportTicketFirestoreSchema: z.ZodObject<{
         toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
     }, z.ZodTypeAny, "passthrough">;
     userId: string;
-    category: "account" | "general" | "order_issue" | "billing_payment" | "listing_dispute" | "scam_report" | "refund_request" | "auction_dispute" | "store_change_request" | "order_modification_request" | "unban_request";
+    category: "general" | "account" | "order_issue" | "billing_payment" | "listing_dispute" | "scam_report" | "refund_request" | "auction_dispute" | "store_change_request" | "order_modification_request" | "unban_request";
     description: string;
     priority: "normal" | "high" | "low" | "urgent";
     messages: {

package/dist/features/tester/seed-data/tester-checklist-seed-data.js

@@ -100,6 +100,16 @@ const rawTesterChecklistItems = [
                 { key: "search", label: "Search returns relevant results", href: "/search" },
                 { key: "filters", label: "Search/listing filters (price, brand, condition) work correctly" },
                 { key: "pagination", label: "Pagination / infinite scroll works on listing pages" },
+                {
+                    key: "compare-custom-fields",
+                    label: "Selecting 2+ items and using the \"Compare\" bulk action shows each item's custom spec fields (dimensions, material, edition, etc.) as extra comparison rows, not just image/price/condition/brand/category/store",
+                    href: "/products",
+                },
+                {
+                    key: "compare-double-row-arrows",
+                    label: "On a homepage section rendered as a double row (e.g. Auctions), the left/right scroll arrows are tall slivers spanning the full row height, not small circular buttons",
+                    href: "/",
+                },
                 {
                     key: "default-listing-not-empty",
                     label: "Products, Auctions, Pre-Orders, Art & Stickers, and Prize Draws listing pages show real items by default — not an empty \"no products found\" state or a toast about a missing Firestore index",
@@ -183,6 +193,11 @@ const rawTesterChecklistItems = [
                 { key: "payment-auto-approve-dispute", label: "An auto-approved order (2h, no admin review) shows the badge, and \"Raise a dispute\" submits successfully" },
                 { key: "checkout-mobile-responsive", label: "The full checkout flow (cart → address → payment → confirmation) is usable and correctly laid out on a mobile viewport" },
                 { key: "checkout-back-navigation", label: "Using the browser back button mid-checkout does not lose cart state or double-submit the order" },
+                {
+                    key: "checkout-manual-payment-consent",
+                    label: "Choosing manual payment (UPI/Cash) at checkout shows a how-it-works guide (payment steps, refund summary, what happens if an item sells out) and requires a consent checkbox before the \"Pay via UPI / Cash\" button becomes clickable",
+                    href: "/checkout",
+                },
             ],
         },
         {
@@ -235,6 +250,11 @@ const rawTesterChecklistItems = [
                 { key: "wishlist-sold-out-item", label: "A wishlist item whose product later sells out or is removed still displays gracefully (no crash) with an appropriate indicator" },
                 { key: "wishlist-empty-state", label: "The empty-wishlist state renders correctly with no items", href: "/wishlist" },
                 { key: "wishlist-add-to-cart-from-list", label: "Adding a wishlist item directly to the cart from the wishlist page works" },
+                { key: "wishlist-card-clickable", label: "Tapping/clicking a wishlist card (not the heart icon) navigates to that product's detail page", href: "/wishlist" },
+                { key: "wishlist-heart-solid-red", label: "The wishlist heart icon on a saved item renders as a clearly visible solid red heart, not a washed-out white-on-pale circle", href: "/wishlist" },
+                { key: "wishlist-view-remove-buttons", label: "Each wishlist card shows explicit \"View\" and \"Remove\" buttons below it, in addition to the heart toggle", href: "/wishlist" },
+                { key: "wishlist-sync-item", label: "Tapping the per-card \"Sync\" button on a wishlist item refreshes its stored price/title/image and removes it if the product is no longer available", href: "/wishlist" },
+                { key: "wishlist-sync-all", label: "The \"Sync all\" button in the wishlist header syncs every item and shows a toast summarizing how many were synced/removed", href: "/wishlist" },
                 { key: "view-history", label: "Recently viewed history shows accurate items in most-recent-first order", href: "/user/history" },
                 { key: "history-revisit-reorders", label: "Re-visiting a product already in history removes the old entry and moves it to the front, rather than duplicating it" },
                 { key: "history-fifo-cap", label: "History silently evicts the oldest entry once more than 50 items have been viewed (no error shown to the user)" },
@@ -254,6 +274,16 @@ const rawTesterChecklistItems = [
                 { key: "cart-guest-to-login-merge", label: "A guest cart's items merge correctly into the account's cart after logging in" },
                 { key: "cart-price-revalidated", label: "If a product's price changes after it was added to the cart, checkout uses the current price and shows the buyer the updated total" },
                 { key: "cart-checkout-button-visible", label: "The \"Proceed to Checkout\" button renders as a clearly visible, prominently-colored primary button — not a dull/near-invisible one blending into the page background", href: "/cart" },
+                {
+                    key: "cart-added-toast-totals",
+                    label: "Adding any item to the cart shows a toast naming the item plus the cart's updated item count and total value (not a bare \"Added to cart\")",
+                    href: "/products",
+                },
+                {
+                    key: "bottom-nav-cart-not-wishlist",
+                    label: "The mobile bottom navigation bar shows a Cart tab with a live item-count badge; Wishlist is no longer a bottom-tab slot but is still reachable from the header",
+                    description: "Wishlist was intentionally removed only from the bottom tab bar, not from the header/app-bar or main navigation — confirm the header wishlist icon is unaffected.",
+                },
             ],
         },
         {
@@ -477,13 +507,38 @@ const rawTesterChecklistItems = [
                     href: "/events",
                 },
                 { key: "poll-vote-inline", label: "Voting in a poll event from the Overview tab works, shows a confirmation, and a repeat visit shows the already-voted state" },
+                {
+                    key: "poll-leaderboard-shows-tally",
+                    label: "A poll event's Leaderboard tab shows option labels with vote counts/percentages, not a list of voters ranked by who voted first",
+                    href: "/events",
+                },
+                {
+                    key: "admin-event-entries-export",
+                    label: "On an event's admin entries page, admin can view poll/form responses inline and download a Markdown report of all entries via the \"Download Report\" button",
+                    href: "/admin/events",
+                },
                 { key: "survey-feedback-submit", label: "Submitting a survey or feedback event's Participate form works, enforces required fields, and shows a success confirmation" },
                 { key: "offer-coupon-display-copy", label: "An offer event shows its coupon code prominently on the Overview tab, and the \"Copy code\" button copies it to the clipboard with visible confirmation" },
                 { key: "raffle-entry", label: "Entering an open_raffle event works and the Participate tab shows the prize hero, eligibility copy, and optional message field (not a blank form)" },
                 { key: "raffle-entry-top-n-scorers", label: "Entering a top_n_scorers raffle event works and the leaderboard reflects entries" },
                 { key: "raffle-entry-top-n-participants", label: "Entering a top_n_participants raffle event works" },
-                { key: "spin-wheel", label: "Spinning the spin-wheel event works and shows the prize immediately (realtime)" },
+                {
+                    key: "spin-wheel",
+                    label: "Spinning the spin-wheel event works on the very first attempt and shows the prize immediately (realtime) — no \"Spin failed\" error",
+                    description: "Previously the first spin always failed because no eventEntries doc existed yet for the user; the spin now finds-or-creates its own entry transactionally.",
+                },
+                { key: "spin-wheel-max-per-user", label: "Spinning again after using up the event's configured spinMaxPerUser is blocked with a clear message, not silently allowed" },
                 { key: "spin-wheel-window-blocked", label: "A second spin attempt within the same spinWindow is blocked with a clear message" },
+                {
+                    key: "spin-results-tab",
+                    label: "A spin_wheel event shows a \"Last 10 Spin Results\" tab listing recent winners (or \"Guest\" for anonymous spins) and their prizes",
+                    href: "/events",
+                },
+                {
+                    key: "event-guest-participation-toggle",
+                    label: "An event created with \"allow guest participation\" enabled accepts one anonymous entry per device/IP and blocks a second attempt from the same device; an event with the toggle off still requires login",
+                    href: "/admin/events",
+                },
                 { key: "leaderboard-live-refresh", label: "After voting/entering an event, navigating to its Leaderboard tab shows the updated standings immediately rather than a stale cached ranking" },
             ],
         },
@@ -587,6 +642,16 @@ const rawTesterChecklistItems = [
                 { key: "sections-social-proof-render", label: "Verified stores, tournaments & events, and collector reviews sections render correctly" },
                 { key: "sections-social-feed-hidden", label: "The social-feed section type is correctly hidden on the homepage since it's disabled in Site Settings" },
                 { key: "hero-welcome-logo-sized-padded", label: "The homepage welcome hero's brand mark/logo panel (desktop, right side) is appropriately sized and padded inside its card — not oversized, cramped, or touching/overflowing the card edges", href: "/" },
+                {
+                    key: "welcome-hero-no-gap",
+                    label: "There is no large empty gap between the sticky header/navbar (or the expanded search bar) and the homepage Welcome hero section below it",
+                    href: "/",
+                },
+                {
+                    key: "promo-banner-overlay",
+                    label: "The promotion/announcement banner overlays the top of the first homepage section (translucent strip) instead of pushing the page content down with extra vertical space",
+                    href: "/",
+                },
             ],
         },
     ]),
@@ -596,6 +661,8 @@ const rawTesterChecklistItems = [
             pageLabel: "Homepage & Core Listing Pages",
             cases: [
                 { key: "homepage-loads", label: "The homepage loads without errors on both desktop and mobile", href: "/" },
+                { key: "about-us-in-main-nav", label: "\"About Us\" appears as an item in the main public top navigation, not just the footer", href: "/about" },
+                { key: "developer-page-loads", label: "The Developer page loads correctly and is linked from the footer's Support column next to About Us", href: "/developer" },
                 { key: "products-listing-page", label: "The products listing page loads and paginates correctly", href: "/products" },
                 { key: "auctions-listing-page", label: "The auctions listing page loads correctly", href: "/auctions" },
                 { key: "preorders-listing-page", label: "The pre-orders listing page loads correctly", href: "/pre-orders" },

package/dist/features/whatsapp-bot/helpers/payment-proof-message.d.ts

@@ -0,0 +1,14 @@
+import type { PaymentProofReviewMessageInput } from "../types";
+/**
+ * Tier PP — message for the payment-proof fast-review WhatsApp push (sent
+ * to every `whatsappAdminNotifyNumbers` number when a buyer uploads proof)
+ * and for the buyer/seller "share for review" wa.me link (same message,
+ * routed through `buildGroupShareLink` instead of the Cloud API push).
+ *
+ * Pure string builder — deliberately kept in its own file, isolated from
+ * `./whatsapp.ts` (which has a top-level `import { createHmac } from
+ * "crypto"`), so it can be safely exported from the client-safe barrel.
+ * The buyer/seller share-link caller (order payment page) needs this
+ * client-side; the crypto-importing sibling functions never can be.
+ */
+export declare function buildPaymentProofReviewMessage(input: PaymentProofReviewMessageInput): string;

package/dist/features/whatsapp-bot/helpers/payment-proof-message.js

@@ -0,0 +1,17 @@
+/**
+ * Tier PP — message for the payment-proof fast-review WhatsApp push (sent
+ * to every `whatsappAdminNotifyNumbers` number when a buyer uploads proof)
+ * and for the buyer/seller "share for review" wa.me link (same message,
+ * routed through `buildGroupShareLink` instead of the Cloud API push).
+ *
+ * Pure string builder — deliberately kept in its own file, isolated from
+ * `./whatsapp.ts` (which has a top-level `import { createHmac } from
+ * "crypto"`), so it can be safely exported from the client-safe barrel.
+ * The buyer/seller share-link caller (order payment page) needs this
+ * client-side; the crypto-importing sibling functions never can be.
+ */
+export function buildPaymentProofReviewMessage(input) {
+    const { orderId, buyerName, productTitle, totalAmount, reviewUrl } = input;
+    const amount = totalAmount.toLocaleString("en-IN");
+    return `💳 Payment proof submitted! ${buyerName} uploaded proof for "${productTitle}" (₹${amount}). Order #${orderId}. Please review within 2 hours or it auto-confirms: ${reviewUrl}`;
+}

package/dist/features/whatsapp-bot/helpers/whatsapp.d.ts

@@ -1,4 +1,4 @@
-import type { CheckoutMessageInput, StatusNotificationInput, WebhookVerifyInput, IncomingWebhookPayload, SendWhatsAppInput, StatusMessageInput, WaBusinessSendInput, WaBusinessTemplateSendInput, CatalogSyncInput, CatalogSyncResult, PurchaseAnnouncementInput, PaymentProofReviewMessageInput } from "../types";
+import type { CheckoutMessageInput, StatusNotificationInput, WebhookVerifyInput, IncomingWebhookPayload, SendWhatsAppInput, StatusMessageInput, WaBusinessSendInput, WaBusinessTemplateSendInput, CatalogSyncInput, CatalogSyncResult, PurchaseAnnouncementInput } from "../types";
 export declare function buildCheckoutMessageURL(input: CheckoutMessageInput): string;
 export declare function buildStatusNotificationURL(input: StatusNotificationInput): string;
 export declare function verifyWebhookSignature(input: WebhookVerifyInput): boolean;
@@ -44,13 +44,7 @@ export declare function buildPurchaseAnnouncementMessage(input: PurchaseAnnounce
  * This is the only API-compliant way to target a WhatsApp group.
  */
 export declare function buildGroupShareLink(message: string): string;
-/**
- * Tier PP — message for the payment-proof fast-review WhatsApp push (sent
- * to every `whatsappAdminNotifyNumbers` number when a buyer uploads proof)
- * and for the buyer/seller "share for review" wa.me link (same message,
- * routed through `buildGroupShareLink` instead of the Cloud API push).
- */
-export declare function buildPaymentProofReviewMessage(input: PaymentProofReviewMessageInput): string;
+export { buildPaymentProofReviewMessage } from "./payment-proof-message";
 /**
  * Send an outbound WhatsApp message via Twilio REST API.
  * Returns true on success, false on failure.

package/dist/features/whatsapp-bot/helpers/whatsapp.js

@@ -252,17 +252,10 @@ export function buildPurchaseAnnouncementMessage(input) {
 export function buildGroupShareLink(message) {
     return `https://wa.me/?text=${encodeURIComponent(message)}`;
 }
-/**
- * Tier PP — message for the payment-proof fast-review WhatsApp push (sent
- * to every `whatsappAdminNotifyNumbers` number when a buyer uploads proof)
- * and for the buyer/seller "share for review" wa.me link (same message,
- * routed through `buildGroupShareLink` instead of the Cloud API push).
- */
-export function buildPaymentProofReviewMessage(input) {
-    const { orderId, buyerName, productTitle, totalAmount, reviewUrl } = input;
-    const amount = totalAmount.toLocaleString("en-IN");
-    return `💳 Payment proof submitted! ${buyerName} uploaded proof for "${productTitle}" (₹${amount}). Order #${orderId}. Please review within 2 hours or it auto-confirms: ${reviewUrl}`;
-}
+// buildPaymentProofReviewMessage moved to ./payment-proof-message.ts (pure,
+// no crypto import) so it can be exported client-safe. Re-exported here for
+// backward compatibility with existing server-side importers of this file.
+export { buildPaymentProofReviewMessage } from "./payment-proof-message";
 /**
  * Send an outbound WhatsApp message via Twilio REST API.
  * Returns true on success, false on failure.

package/dist/features/wishlist/repository/user-wishlist.repository.d.ts

@@ -48,6 +48,17 @@ export declare class UserWishlistRepository {
         productSnapshot?: WishlistItemSnapshot;
     }): Promise<number>;
     removeItem(userSlug: string, productId: string): Promise<void>;
+    /**
+     * Overwrites the stored `productSnapshot` (title/thumb/currentPrice) for
+     * one or more surviving items in place — used by the "sync" feature to
+     * refresh what's persisted on the wishlist doc against the live product,
+     * distinct from `getWishlistItems`'s existing behaviour of just joining in
+     * live product data for *display* without ever writing it back.
+     */
+    syncSnapshots(userSlug: string, updates: {
+        productId: string;
+        snapshot: WishlistItemSnapshot;
+    }[]): Promise<void>;
     clearWishlist(userSlug: string): Promise<void>;
     /** Admin: returns one row per user (for the admin insights view). */
     findAllSummaries(): Promise<{

package/dist/features/wishlist/repository/user-wishlist.repository.js

@@ -170,6 +170,39 @@ export class UserWishlistRepository {
             throw error;
         }
     }
+    /**
+     * Overwrites the stored `productSnapshot` (title/thumb/currentPrice) for
+     * one or more surviving items in place — used by the "sync" feature to
+     * refresh what's persisted on the wishlist doc against the live product,
+     * distinct from `getWishlistItems`'s existing behaviour of just joining in
+     * live product data for *display* without ever writing it back.
+     */
+    async syncSnapshots(userSlug, updates) {
+        if (updates.length === 0)
+            return;
+        const db = getAdminDb();
+        const ref = this.docRef(userSlug);
+        const byId = new Map(updates.map((u) => [u.productId, u.snapshot]));
+        try {
+            await db.runTransaction(async (tx) => {
+                const snap = await tx.get(ref);
+                if (!snap.exists)
+                    return;
+                const items = normaliseItems(snap.data()?.items);
+                const next = items.map((item) => byId.has(item.productId)
+                    ? { ...item, productSnapshot: byId.get(item.productId) }
+                    : item);
+                tx.set(ref, { userId: userSlug, items: next, updatedAt: new Date() });
+            });
+        }
+        catch (error) {
+            serverLogger.error("UserWishlistRepository.syncSnapshots error", {
+                userSlug,
+                error,
+            });
+            throw error;
+        }
+    }
     async clearWishlist(userSlug) {
         try {
             await this.docRef(userSlug).set({

package/dist/index.d.ts

@@ -910,6 +910,8 @@ export { HowOrdersWorkView } from "./features/about/index";
 export { HowPayoutsWorkView } from "./features/about/index";
 export { HowPreOrdersWorkView } from "./features/about/index";
 export { HowReviewsWorkView } from "./features/about/index";
+export { PolicyPageView } from "./features/about/index";
+export { DeveloperView } from "./features/about/index";
 export { PublicProfileView } from "./features/about/index";
 export { SecurityPrivacyView } from "./features/about/index";
 export { ShippingPolicyView } from "./features/about/index";
@@ -932,6 +934,7 @@ export type { HowPayoutsWorkViewProps } from "./features/about/index";
 export type { HowPreOrdersWorkViewProps } from "./features/about/index";
 export type { HowReviewsWorkViewProps } from "./features/about/index";
 export type { PolicyPageViewProps } from "./features/about/index";
+export type { DeveloperViewProps } from "./features/about/index";
 export type { PublicProfileViewProps } from "./features/about/index";
 export type { SecurityPrivacyViewProps } from "./features/about/index";
 export type { ShippingPolicyViewProps } from "./features/about/index";
@@ -1393,6 +1396,7 @@ export { placeBid, buyNowAuction } from "./features/auctions/server";
 export type { PlaceBidInput, BuyNowAuctionInput, BuyNowAuctionResult } from "./features/auctions/server";
 export type { PlaceBidResult } from "./features/auctions/server";
 export { CHECKOUT_VALUE_OTP_VERIFY_RATE_LIMIT } from "./features/auth/checkout-value-otp";
+export { sendCheckoutValueOtp, verifyCheckoutValueOtp, } from "./features/checkout/server";
 export { authMeGET } from "./features/auth/server";
 export { createPasswordResetToken } from "./features/auth/server";
 export { createVerificationToken } from "./features/auth/server";
@@ -1659,11 +1663,6 @@ export { listBrandCategories } from "./features/categories/server";
 export { listCategories } from "./features/categories/server";
 export { listTopLevelCategories } from "./features/categories/server";
 export { updateCategory } from "./features/categories/server";
-export { FailedCheckoutRepository } from "./features/checkout/server";
-export { failedCheckoutRepository } from "./features/checkout/server";
-export { sendCheckoutValueOtp, verifyCheckoutValueOtp, isCheckoutValueOtpVerified, } from "./features/checkout/server";
-export type { FailedCheckoutMeta } from "./features/checkout/server";
-export type { FailedPaymentMeta } from "./features/checkout/server";
 export { FAILED_CHECKOUTS_COLLECTION } from "./features/checkout/schemas/index";
 export { FAILED_PAYMENTS_COLLECTION } from "./features/checkout/schemas/index";
 export type { FailedCheckoutDocument } from "./features/checkout/schemas/index";
@@ -1703,13 +1702,6 @@ export type { ContactFormProps } from "./features/contact/index";
 export type { ContactInfoItem } from "./features/contact/index";
 export type { ContactInfoSidebarProps } from "./features/contact/index";
 export type { UseContactSubmitOptions } from "./features/contact/index";
-export { sendContactEmail } from "./features/contact/server";
-export { sendEmail } from "./features/contact/server";
-export { sendOrderConfirmationEmail } from "./features/contact/server";
-export { sendPasswordResetEmailWithLink } from "./features/contact/server";
-export { sendSiteSettingsChangedEmail } from "./features/contact/server";
-export { sendVerificationEmailWithLink } from "./features/contact/server";
-export type { OrderConfirmationEmailParams } from "./features/contact/server";
 export { AdminCopilotView } from "./features/copilot/index";
 export { useCopilotChat } from "./features/copilot/index";
 export { useCopilotFeedback } from "./features/copilot/index";
@@ -1843,6 +1835,7 @@ export type { EventUpdateInput } from "./features/events/index";
 export type { FeedbackConfig } from "./features/events/index";
 export type { FormFieldType } from "./features/events/index";
 export type { LeaderboardEntry } from "./features/events/index";
+export type { PollResultEntry } from "./features/events/index";
 export type { OfferConfig } from "./features/events/index";
 export type { PollConfig } from "./features/events/index";
 export type { PollResultsVisibility } from "./features/events/index";
@@ -1863,6 +1856,8 @@ export { enterEvent } from "./features/events/server";
 export { eventIdGET } from "./features/events/server";
 export { eventsGET } from "./features/events/server";
 export { getEventLeaderboard } from "./features/events/server";
+export { getEventPollResults } from "./features/events/server";
+export { getEventSpinResults } from "./features/events/server";
 export { getBugHunterLeaderboard } from "./features/tester/server";
 export { getPublicEventById } from "./features/events/server";
 export { listPublicEvents } from "./features/events/server";

package/dist/index.js

@@ -1875,6 +1875,10 @@ export { HowPreOrdersWorkView } from "./features/about/index";
 export { HowReviewsWorkView } from "./features/about/index";
 // [CLIENT-SSR]-Runs in both SSR and browser â€" React component or hook that does not depend on browser-only APIs.
 // PolicyPageView - Component for policy page view.
+export { PolicyPageView } from "./features/about/index";
+// [CLIENT-SSR]-Runs in both SSR and browser â€" React component or hook that does not depend on browser-only APIs.
+// DeveloperView - Component for developer intro/portfolio view.
+export { DeveloperView } from "./features/about/index";
 // [CLIENT-SSR]-Runs in both SSR and browser â€" React component or hook that does not depend on browser-only APIs.
 // PublicProfileView - Component for public profile view.
 export { PublicProfileView } from "./features/about/index";
@@ -2587,6 +2591,12 @@ export { placeBid, buyNowAuction } from "./features/auctions/server";
 // [SERVER-ONLY]-Server-only â€" uses Node.js, Next.js server internals, or third-party server SDKs (auth, email, payment, shipping).
 // CHECKOUT_VALUE_OTP_VERIFY_RATE_LIMIT - Constant used across modules.
 export { CHECKOUT_VALUE_OTP_VERIFY_RATE_LIMIT } from "./features/auth/checkout-value-otp";
+// [SERVER-ONLY] Tier PP — high-value checkout OTP gate. "use server" actions
+// belong in both index.ts and server.ts per the appkit Export Rules table;
+// these were only in server.ts, leaving src/actions/checkout.actions.ts's
+// `import { sendCheckoutValueOtp, verifyCheckoutValueOtp } from "@mohasinac/appkit"`
+// unresolved.
+export { sendCheckoutValueOtp, verifyCheckoutValueOtp, } from "./features/checkout/server";
 // [SERVER-ONLY]-Server-only â€" uses Node.js, Next.js server internals, or third-party server SDKs (auth, email, payment, shipping).
 // authMeGET - Shared export for auth me get.
 export { authMeGET } from "./features/auth/server";
@@ -3122,15 +3132,6 @@ export { listTopLevelCategories } from "./features/categories/server";
 // [SERVER-ONLY]-Server-only â€" uses Node.js, Next.js server internals, or third-party server SDKs (auth, email, payment, shipping).
 // updateCategory - Helper for update category.
 export { updateCategory } from "./features/categories/server";
-// ./features/checkout/server
-// [DB]-Database layer â€" uses firebase-admin or another server-side DB SDK; can only run in a trusted server environment.
-// FailedCheckoutRepository - Shared export for failed checkout repository.
-export { FailedCheckoutRepository } from "./features/checkout/server";
-// [DB]-Database layer â€" uses firebase-admin or another server-side DB SDK; can only run in a trusted server environment.
-// failedCheckoutRepository - Shared export for failed checkout repository.
-export { failedCheckoutRepository } from "./features/checkout/server";
-// [SERVER-ONLY] Tier PP — high-value checkout OTP gate.
-export { sendCheckoutValueOtp, verifyCheckoutValueOtp, isCheckoutValueOtpVerified, } from "./features/checkout/server";
 // ./features/checkout/schemas/index
 // [SCHEMA]-Schema / data-shape constant â€" Zod validator, default-value object, or Firestore collection/field name constant.
 // FAILED_CHECKOUTS_COLLECTION - Constant used across modules.
@@ -3209,25 +3210,6 @@ export { ContactPageView } from "./features/contact/index";
 // [CLIENT-SSR]-Runs in both SSR and browser â€" React component or hook that does not depend on browser-only APIs.
 // useContactSubmit - React hook for use contact submit.
 export { useContactSubmit } from "./features/contact/index";
-// ./features/contact/server
-// [SERVER-ONLY]-Server-only â€" uses Node.js, Next.js server internals, or third-party server SDKs (auth, email, payment, shipping).
-// sendContactEmail - Shared export for send contact email.
-export { sendContactEmail } from "./features/contact/server";
-// [SERVER-ONLY]-Server-only â€" uses Node.js, Next.js server internals, or third-party server SDKs (auth, email, payment, shipping).
-// sendEmail - Shared export for send email.
-export { sendEmail } from "./features/contact/server";
-// [SERVER-ONLY]-Server-only â€" uses Node.js, Next.js server internals, or third-party server SDKs (auth, email, payment, shipping).
-// sendOrderConfirmationEmail - Shared export for send order confirmation email.
-export { sendOrderConfirmationEmail } from "./features/contact/server";
-// [SERVER-ONLY]-Server-only â€" uses Node.js, Next.js server internals, or third-party server SDKs (auth, email, payment, shipping).
-// sendPasswordResetEmailWithLink - Shared export for send password reset email with link.
-export { sendPasswordResetEmailWithLink } from "./features/contact/server";
-// [SERVER-ONLY]-Server-only â€" uses Node.js, Next.js server internals, or third-party server SDKs (auth, email, payment, shipping).
-// sendSiteSettingsChangedEmail - Shared export for send site settings changed email.
-export { sendSiteSettingsChangedEmail } from "./features/contact/server";
-// [SERVER-ONLY]-Server-only â€" uses Node.js, Next.js server internals, or third-party server SDKs (auth, email, payment, shipping).
-// sendVerificationEmailWithLink - Shared export for send verification email with link.
-export { sendVerificationEmailWithLink } from "./features/contact/server";
 // ./features/copilot/index
 // [CLIENT-SSR]-Runs in both SSR and browser â€" React component or hook that does not depend on browser-only APIs.
 // AdminCopilotView - Component for admin copilot view.
@@ -3485,6 +3467,12 @@ export { eventsGET } from "./features/events/server";
 // getEventLeaderboard - Helper for get event leaderboard.
 export { getEventLeaderboard } from "./features/events/server";
 // [SERVER-ONLY]-Server-only â€" uses Node.js, Next.js server internals, or third-party server SDKs (auth, email, payment, shipping).
+// getEventPollResults - Helper for get event poll results (per-option vote tally).
+export { getEventPollResults } from "./features/events/server";
+// [SERVER-ONLY]-Server-only â€" uses Node.js, Next.js server internals, or third-party server SDKs (auth, email, payment, shipping).
+// getEventSpinResults - Last N winning spins for a spin_wheel event, most recent first.
+export { getEventSpinResults } from "./features/events/server";
+// [SERVER-ONLY]-Server-only â€" uses Node.js, Next.js server internals, or third-party server SDKs (auth, email, payment, shipping).
 // getBugHunterLeaderboard - Ranks testers by confirmed-bug count.
 export { getBugHunterLeaderboard } from "./features/tester/server";
 // [SERVER-ONLY]-Server-only â€" uses Node.js, Next.js server internals, or third-party server SDKs (auth, email, payment, shipping).

package/dist/next/components/ErrorView.js

@@ -19,7 +19,7 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { useEffect } from "react";
 import { Heading, Text } from "../../ui/components/Typography";
 import { Button } from "../../ui/components/Button";
-import { Stack } from "@mohasinac/appkit";
+import { Stack } from "@mohasinac/appkit/client";
 import { trackError, ErrorCategory, ErrorSeverity, } from "../../monitoring/error-tracking";
 export function ErrorView({ error, reset, heading = "Something went wrong", description = "An unexpected error occurred. Please try again.", retryLabel = "Try again", }) {
     useEffect(() => {

package/dist/next/components/NotFoundView.js

@@ -20,7 +20,7 @@ import { Heading, Text } from "../../ui/components/Typography";
 import { TextLink } from "../../ui/components/TextLink";
 import { SiteMark } from "../../ui/components/SiteMark";
 import { DEFAULT_ROUTE_MAP } from "../routing/route-map";
-import { Stack } from "@mohasinac/appkit";
+import { Stack } from "@mohasinac/appkit/client";
 export function NotFoundView({ heading = "404 — Page not found", description = "The page you are looking for does not exist.", homeLabel = "Go home", homeHref = DEFAULT_ROUTE_MAP.HOME, }) {
     return (_jsxs(Stack, { justify: "center", className: "min-h-[60vh] text-center", padding: "x-xl", align: "center", children: [_jsx(SiteMark, { size: "xl" }), _jsx(Heading, { level: 1, variant: "primary", size: "7xl", className: "mb-2", weight: "bold", children: "404" }), _jsx(Heading, { level: 2, className: "mb-3", children: heading }), _jsx(Text, { variant: "secondary", className: "mb-8", children: description }), _jsx(TextLink, { href: homeHref, children: homeLabel })] }));
 }

package/dist/next/components/UnauthorizedView.js

@@ -16,7 +16,7 @@ import { Row } from "../../ui/components/Layout";
 import { Heading, Text } from "../../ui/components/Typography";
 import { TextLink } from "../../ui/components/TextLink";
 import { DEFAULT_ROUTE_MAP } from "../routing/route-map";
-import { Stack } from "@mohasinac/appkit";
+import { Stack } from "@mohasinac/appkit/client";
 export function UnauthorizedView({ heading = "401 — Unauthorized", description = "You need to be signed in to view this page.", loginLabel = "Sign in", loginHref = DEFAULT_ROUTE_MAP.AUTH.LOGIN, homeLabel = "Go home", homeHref = DEFAULT_ROUTE_MAP.HOME, }) {
     return (_jsxs(Stack, { justify: "center", className: "min-h-[60vh] text-center", padding: "x-xl", align: "center", children: [_jsx(Heading, { level: 1, variant: "primary", size: "7xl", className: "mb-2", weight: "bold", children: "401" }), _jsx(Heading, { level: 2, className: "mb-3", children: heading }), _jsx(Text, { variant: "secondary", className: "mb-8", children: description }), _jsxs(Row, { gap: "md", children: [_jsx(TextLink, { href: loginHref, children: loginLabel }), _jsx(TextLink, { href: homeHref, children: homeLabel })] })] }));
 }