@mohasinac/appkit 3.8.2 → 3.9.1

package/dist/utils/number.formatter.d.ts

@@ -5,13 +5,8 @@ export declare function formatCurrency(amount: number, currency?: string, locale
 export declare function formatNumber(num: number, locale?: string, options?: {
     decimals?: number;
 }): string;
-/**
- * Formats an integer paise amount as a currency string, e.g. 349900 -> "₹3,499".
- * Canonical helper for every paise-denominated amount across the codebase —
- * see CLAUDE.md's Recurrent Root Cause Patterns for why this was previously
- * duplicated as a local `formatPaise`/`toRupees` in 5+ admin/seller views.
- */
-export declare function formatPaise(paise: number, currency?: string, locale?: string): string;
+/** Rounds to 2 decimal places for rupee-denominated money math (avoids float drift). */
+export declare function roundRupees(amount: number): number;
 export declare function formatPercentage(num: number, decimals?: number): string;
 export declare function formatFileSize(bytes: number): string;
 export declare function formatCompactNumber(num: number): string;

package/dist/utils/number.formatter.js

@@ -17,14 +17,9 @@ export function formatNumber(num, locale, options) {
         maximumFractionDigits: options?.decimals,
     }).format(num);
 }
-/**
- * Formats an integer paise amount as a currency string, e.g. 349900 -> "₹3,499".
- * Canonical helper for every paise-denominated amount across the codebase —
- * see CLAUDE.md's Recurrent Root Cause Patterns for why this was previously
- * duplicated as a local `formatPaise`/`toRupees` in 5+ admin/seller views.
- */
-export function formatPaise(paise, currency, locale) {
-    return formatCurrency(paise / 100, currency, locale);
+/** Rounds to 2 decimal places for rupee-denominated money math (avoids float drift). */
+export function roundRupees(amount) {
+    return Math.round(amount * 100) / 100;
 }
 export function formatPercentage(num, decimals = 0) {
     return `${(num * 100).toFixed(decimals)}%`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mohasinac/appkit",
-  "version": "3.8.2",
+  "version": "3.9.1",
   "license": "MIT",
   "publishConfig": {
     "access": "public"

package/scripts/seed-cli.mjs

@@ -161,6 +161,12 @@ console.log(`✓ Connected to project: ${process.env.FIREBASE_ADMIN_PROJECT_ID |
 // Pull seed data + helpers from @mohasinac/appkit
 // ---------------------------------------------------------------------------
 const appkit = await import("@mohasinac/appkit");
+// PII crypto functions moved server-only in appkit 3.8.1 (they touch
+// firebase-admin's crypto chain) — no longer exported from the main
+// client-safe barrel, only from "@mohasinac/appkit/server". The *_PII_FIELDS
+// / *_PII_INDEX_MAP constants are plain data and stay in the main barrel.
+const appkitServer = await import("@mohasinac/appkit/server");
+const { encryptPiiFields, addPiiIndices, encryptPayoutDetails, encryptPayoutBankAccount, encryptShippingConfig } = appkitServer;
 
 const {
   // seed data
@@ -191,9 +197,8 @@ const {
   GROUPED_LISTINGS_COLLECTION, SCAMMER_COLLECTION,
   WISHLIST_COLLECTION, HISTORY_COLLECTION, PRODUCT_FEATURES_COLLECTION,
   TESTER_CHECKLIST_ITEM_COLLECTION,
-  // PII helpers
-  encryptPiiFields, addPiiIndices,
-  encryptPayoutDetails, encryptPayoutBankAccount, encryptShippingConfig,
+  // PII field/index constants (plain data, still in the main barrel — the
+  // crypto functions themselves come from appkitServer above)
   USER_PII_FIELDS, USER_PII_INDEX_MAP,
   ADDRESS_PII_FIELDS, ORDER_PII_FIELDS, BID_PII_FIELDS, PAYOUT_PII_FIELDS,
   REVIEW_PII_FIELDS, OFFER_PII_FIELDS, EVENT_ENTRY_PII_FIELDS, CHAT_PII_FIELDS,

package/dist/_internal/client/scaffolds/DashboardScaffold.d.ts

@@ -1,34 +0,0 @@
-/**
- * DashboardScaffold — admin / seller / user dashboard chrome.
- *
- * Responsive nav strategy (mobile-first):
- *   xs / sm — bottom nav bar  (visible <lg)
- *   md      — off-canvas drawer triggered by `slotMenuToggle`
- *   lg+     — sticky left sidebar (always visible)
- *
- * Drives nav rendering through `renderNav` so consumers can pipe in any
- * nav config (admin/store/user groups). The scaffold owns the responsive
- * placement; the consumer owns the items.
- */
-import * as React from "react";
-export interface DashboardScaffoldRenderContext {
-    /** Whether the off-canvas drawer is open. */
-    drawerOpen: boolean;
-    /** Imperatively toggle the drawer (consumer-supplied trigger calls this). */
-    toggleDrawer: () => void;
-}
-export interface DashboardScaffoldProps {
-    children: React.ReactNode;
-    /** Top breadcrumb / page-title strip. */
-    slotPageHeader?: React.ReactNode;
-    /** Navigation items — rendered into all three placements (sidebar, drawer, bottom). */
-    renderNav?: (ctx: DashboardScaffoldRenderContext) => React.ReactNode;
-    /** Compact bottom nav (mobile only). If omitted, falls back to renderNav. */
-    renderBottomNav?: (ctx: DashboardScaffoldRenderContext) => React.ReactNode;
-    /** Trigger element that toggles the off-canvas drawer (md only). */
-    slotMenuToggle?: React.ReactNode;
-    /** Initial drawer-open state. */
-    initialDrawerOpen?: boolean;
-    className?: string;
-}
-export declare function DashboardScaffold({ children, slotPageHeader, renderNav, renderBottomNav, slotMenuToggle, initialDrawerOpen, className, }: DashboardScaffoldProps): React.JSX.Element;

package/dist/_internal/client/scaffolds/DashboardScaffold.js

@@ -1,26 +0,0 @@
-"use client";
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-/**
- * DashboardScaffold — admin / seller / user dashboard chrome.
- *
- * Responsive nav strategy (mobile-first):
- *   xs / sm — bottom nav bar  (visible <lg)
- *   md      — off-canvas drawer triggered by `slotMenuToggle`
- *   lg+     — sticky left sidebar (always visible)
- *
- * Drives nav rendering through `renderNav` so consumers can pipe in any
- * nav config (admin/store/user groups). The scaffold owns the responsive
- * placement; the consumer owns the items.
- */
-import * as React from "react";
-import { Div, Main, Nav, Span, Stack } from "../../../ui";
-import { useVisualViewportInset } from "../../../react/hooks/useVisualViewportInset";
-export function DashboardScaffold({ children, slotPageHeader, renderNav, renderBottomNav, slotMenuToggle, initialDrawerOpen = false, className, }) {
-    const [drawerOpen, setDrawerOpen] = React.useState(initialDrawerOpen);
-    const toggleDrawer = React.useCallback(() => setDrawerOpen((v) => !v), []);
-    const ctx = { drawerOpen, toggleDrawer };
-    const isKeyboardOpen = useVisualViewportInset();
-    const nav = renderNav ? renderNav(ctx) : null;
-    const bottomNav = renderBottomNav ? renderBottomNav(ctx) : nav;
-    return (_jsxs(Div, { layout: "flex", className: `appkit-dashboard-scaffold min-h-screen ${className ?? ""}`, children: [nav ? (_jsx("aside", { className: "sticky top-0 hidden h-screen w-64 shrink-0 overflow-y-auto border-r border-[var(--appkit-color-border)] lg:block", "data-dashboard-slot": "sidebar", children: nav })) : null, nav ? (_jsxs("div", { className: `fixed inset-0 z-40 transition-transform md:block lg:hidden ${drawerOpen ? "translate-x-0" : "-translate-x-full"}`, "data-dashboard-slot": "drawer", "aria-hidden": !drawerOpen, children: [_jsx("div", { className: "absolute inset-0 bg-black/40", onClick: () => setDrawerOpen(false), role: "presentation" }), _jsx(Nav, { "aria-label": "Dashboard sidebar", className: "relative h-full w-64 overflow-y-auto bg-[var(--appkit-color-surface)] shadow-xl", children: nav })] })) : null, _jsxs(Stack, { className: "min-w-0 flex-1", children: [(slotPageHeader || slotMenuToggle) && (_jsxs("div", { className: "sticky top-0 z-20 flex items-center gap-[var(--appkit-space-3)] border-b border-[var(--appkit-color-border)] bg-[var(--appkit-color-surface)] px-[var(--appkit-space-4)] py-[var(--appkit-space-2)]", "data-dashboard-slot": "page-header", children: [slotMenuToggle ? (_jsx(Span, { className: "lg:hidden", onClick: toggleDrawer, role: "presentation", children: slotMenuToggle })) : null, _jsx(Div, { className: "min-w-0 flex-1", children: slotPageHeader })] })), _jsx(Main, { className: "min-w-0 flex-1 pb-[var(--appkit-space-20)] lg:pb-[var(--appkit-space-0)]", "data-dashboard-slot": "main", children: children }), bottomNav ? (_jsx(Nav, { "aria-label": "Bottom navigation", "aria-hidden": isKeyboardOpen, className: `fixed bottom-0 left-0 right-0 z-[var(--appkit-z-bottom-nav)] border-t border-[var(--appkit-color-border)] bg-[var(--appkit-color-surface)] lg:hidden transition-transform duration-200 ease-out ${isKeyboardOpen ? "translate-y-full pointer-events-none" : "translate-y-0"}`, "data-dashboard-slot": "bottom-nav", children: bottomNav })) : null] })] }));
-}

package/dist/_internal/client/theme/__tests__/ThemeProvider.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/_internal/client/theme/__tests__/ThemeProvider.test.js

@@ -1,109 +0,0 @@
-import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
-import { render, screen, act } from "@testing-library/react";
-import { describe, it, expect, beforeEach, vi } from "vitest";
-import { ThemeProvider, useTheme } from "../ThemeProvider";
-import { buildThemeRegistry } from "../buildRegistry";
-import { DEFAULT_DARK_THEME, DEFAULT_LIGHT_THEME, } from "../../../../tokens/themes";
-const MEDIA_QUERY = "(prefers-color-scheme: dark)";
-function mockMatchMedia(prefersDark) {
-    const listeners = [];
-    Object.defineProperty(window, "matchMedia", {
-        writable: true,
-        value: (query) => ({
-            matches: query === MEDIA_QUERY ? prefersDark : false,
-            media: query,
-            onchange: null,
-            addEventListener: (_event, cb) => listeners.push(cb),
-            removeEventListener: (_event, cb) => {
-                const idx = listeners.indexOf(cb);
-                if (idx !== -1)
-                    listeners.splice(idx, 1);
-            },
-            addListener: () => undefined,
-            removeListener: () => undefined,
-            dispatchEvent: () => true,
-        }),
-    });
-    return listeners;
-}
-function Probe() {
-    const { effectiveMode, activeTheme, preference } = useTheme();
-    return (_jsxs("div", { "data-testid": "probe", children: ["mode=", effectiveMode, " pref=", preference, " themeId=", activeTheme.id] }));
-}
-describe("ThemeProvider", () => {
-    beforeEach(() => {
-        window.localStorage.clear();
-        document.documentElement.removeAttribute("data-theme");
-        document.documentElement.className = "";
-        document.documentElement.style.cssText = "";
-    });
-    it("applies the default light theme when prefers-color-scheme is light", () => {
-        mockMatchMedia(false);
-        render(_jsx(ThemeProvider, { children: _jsx(Probe, {}) }));
-        expect(screen.getByTestId("probe").textContent).toContain(`themeId=${DEFAULT_LIGHT_THEME.id}`);
-        expect(document.documentElement.getAttribute("data-theme")).toBe(DEFAULT_LIGHT_THEME.id);
-    });
-    it("applies the default dark theme when prefers-color-scheme is dark", () => {
-        mockMatchMedia(true);
-        render(_jsx(ThemeProvider, { children: _jsx(Probe, {}) }));
-        expect(screen.getByTestId("probe").textContent).toContain(`themeId=${DEFAULT_DARK_THEME.id}`);
-        expect(document.documentElement.classList.contains("dark")).toBe(true);
-    });
-    it("toggleTheme flips preference between light and dark", () => {
-        mockMatchMedia(false);
-        const captured = {
-            current: null,
-        };
-        function Capture() {
-            captured.current = useTheme();
-            return null;
-        }
-        render(_jsx(ThemeProvider, { children: _jsx(Capture, {}) }));
-        expect(captured.current?.effectiveMode).toBe("light");
-        act(() => captured.current?.toggleTheme());
-        expect(captured.current?.effectiveMode).toBe("dark");
-        expect(captured.current?.preference).toBe("dark");
-    });
-    it("writes inline CSS variables from the active theme to <html>", () => {
-        mockMatchMedia(false);
-        render(_jsx(ThemeProvider, { children: _jsx(Probe, {}) }));
-        expect(document.documentElement.style.getPropertyValue("--appkit-color-primary")).toBe(DEFAULT_LIGHT_THEME.tokens["appkit-color-primary"]);
-    });
-    it("buildThemeRegistry falls back to built-ins for missing ids", () => {
-        const registry = buildThemeRegistry({
-            themes: [],
-            defaultLightThemeId: "missing",
-            defaultDarkThemeId: "missing-too",
-        });
-        expect(registry.defaultLightThemeId).toBe(DEFAULT_LIGHT_THEME.id);
-        expect(registry.defaultDarkThemeId).toBe(DEFAULT_DARK_THEME.id);
-    });
-    it("buildThemeRegistry merges admin records with built-ins", () => {
-        const adminTheme = {
-            id: "sunset-bright",
-            name: "Sunset Bright",
-            mode: "light",
-            builtIn: false,
-            tokens: { "appkit-color-primary": "#ff9900" },
-            gradients: {},
-        };
-        const registry = buildThemeRegistry({
-            themes: [adminTheme],
-            defaultLightThemeId: "sunset-bright",
-            defaultDarkThemeId: DEFAULT_DARK_THEME.id,
-        });
-        expect(registry.defaultLightThemeId).toBe("sunset-bright");
-        expect(registry.themes.find((t) => t.id === "sunset-bright")).toBeDefined();
-        expect(registry.themes.find((t) => t.id === DEFAULT_LIGHT_THEME.id)).toBeDefined();
-    });
-    it("useTheme throws outside the provider", () => {
-        // Suppress the expected console.error from React.
-        const spy = vi.spyOn(console, "error").mockImplementation(() => undefined);
-        function Naked() {
-            useTheme();
-            return null;
-        }
-        expect(() => render(_jsx(Naked, {}))).toThrow(/useTheme/);
-        spy.mockRestore();
-    });
-});

package/dist/_internal/server/features/auctions/__tests__/service.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/_internal/server/features/auctions/__tests__/service.test.js

@@ -1,140 +0,0 @@
-import { describe, it, expect, vi, beforeEach } from "vitest";
-vi.mock("../../../../../repositories", () => ({
-    productRepository: {
-        findByIdOrSlug: vi.fn(),
-    },
-    bidRepository: {
-        findHighestBid: vi.fn(),
-    },
-}));
-import { computeMinBid, assertBidAmount, assertNotAuctionOwner, shouldAutoExtend, computeExtendedEndDate, } from "../service";
-import { productRepository } from "../../../../../repositories";
-import { BidTooLowError, BidOnOwnAuctionError, } from "../../../../shared/features/auctions/errors";
-import { AUCTION_MIN_BID_INCREMENT_PAISE, AUCTION_SNIPING_WINDOW_SECONDS, AUCTION_DEFAULT_EXTENSION_MINUTES, } from "../../../../shared/features/auctions/config";
-function makeAuction(overrides = {}) {
-    const future = new Date(Date.now() + 60 * 60 * 1000); // 1 hour from now
-    return {
-        id: "auction-test",
-        storeId: "store-owner",
-        listingType: "auction",
-        status: "published",
-        auctionEndDate: future,
-        autoExtendable: true,
-        auctionExtensionMinutes: AUCTION_DEFAULT_EXTENSION_MINUTES,
-        ...overrides,
-    };
-}
-beforeEach(() => {
-    vi.clearAllMocks();
-});
-describe("computeMinBid", () => {
-    it("no current bid → returns startingBid + default increment", () => {
-        const product = makeAuction({ startingBid: 10000, currentBid: undefined });
-        expect(computeMinBid(product)).toBe(10000 + AUCTION_MIN_BID_INCREMENT_PAISE);
-    });
-    it("currentBid set → returns currentBid + default increment", () => {
-        const product = makeAuction({ currentBid: 50000 });
-        expect(computeMinBid(product)).toBe(50000 + AUCTION_MIN_BID_INCREMENT_PAISE);
-    });
-    it("uses the product's configured minBidIncrement when present", () => {
-        const product = makeAuction({ currentBid: 10000, minBidIncrement: 500 });
-        expect(computeMinBid(product)).toBe(10500);
-    });
-    it("no currentBid and no startingBid → 0 + increment", () => {
-        const product = makeAuction({ currentBid: undefined, startingBid: undefined });
-        expect(computeMinBid(product)).toBe(AUCTION_MIN_BID_INCREMENT_PAISE);
-    });
-});
-describe("assertBidAmount", () => {
-    it("bidAmount >= computeMinBid → no throw", () => {
-        const product = makeAuction({ currentBid: 10000 });
-        const min = computeMinBid(product);
-        expect(() => assertBidAmount(product, min)).not.toThrow();
-        expect(() => assertBidAmount(product, min + 100)).not.toThrow();
-    });
-    it("bidAmount < computeMinBid → throws BidTooLowError", () => {
-        const product = makeAuction({ currentBid: 10000 });
-        const min = computeMinBid(product);
-        expect(() => assertBidAmount(product, min - 1)).toThrow(BidTooLowError);
-    });
-    it("BidTooLowError contains the expected minimum", () => {
-        const product = makeAuction({ currentBid: 10000 });
-        const min = computeMinBid(product);
-        let caught;
-        try {
-            assertBidAmount(product, 0);
-        }
-        catch (e) {
-            caught = e;
-        }
-        expect(caught).toBeInstanceOf(BidTooLowError);
-        expect(caught?.message).toContain(String(min));
-    });
-});
-describe("assertNotAuctionOwner", () => {
-    it("bidderId !== storeId (owner) → no throw", () => {
-        const product = makeAuction({ storeId: "store-owner" });
-        expect(() => assertNotAuctionOwner(product, "different-user")).not.toThrow();
-    });
-    it("bidderId === storeId → throws BidOnOwnAuctionError", () => {
-        const product = makeAuction({ storeId: "store-owner" });
-        expect(() => assertNotAuctionOwner(product, "store-owner")).toThrow(BidOnOwnAuctionError);
-    });
-});
-describe("shouldAutoExtend", () => {
-    it("bid placed within sniping window → returns true", () => {
-        const nearlyEnd = new Date(Date.now() + (AUCTION_SNIPING_WINDOW_SECONDS - 30) * 1000);
-        const product = makeAuction({ auctionEndDate: nearlyEnd, autoExtendable: true });
-        expect(shouldAutoExtend(product)).toBe(true);
-    });
-    it("bid placed well outside sniping window → returns false", () => {
-        const farFuture = new Date(Date.now() + 60 * 60 * 1000); // 1 hour
-        const product = makeAuction({ auctionEndDate: farFuture, autoExtendable: true });
-        expect(shouldAutoExtend(product)).toBe(false);
-    });
-    it("autoExtendable=false → always returns false, even if within window", () => {
-        const nearlyEnd = new Date(Date.now() + 10 * 1000); // 10 seconds
-        const product = makeAuction({ auctionEndDate: nearlyEnd, autoExtendable: false });
-        expect(shouldAutoExtend(product)).toBe(false);
-    });
-});
-describe("computeExtendedEndDate", () => {
-    it("returns endDate + configured extensionMinutes", () => {
-        const end = new Date("2026-01-01T12:00:00Z");
-        const product = makeAuction({ auctionEndDate: end, auctionExtensionMinutes: 10 });
-        const result = computeExtendedEndDate(product);
-        expect(result.getTime()).toBe(end.getTime() + 10 * 60 * 1000);
-    });
-    it("uses AUCTION_DEFAULT_EXTENSION_MINUTES when not configured", () => {
-        const end = new Date("2026-01-01T12:00:00Z");
-        const product = makeAuction({ auctionEndDate: end, auctionExtensionMinutes: undefined });
-        const result = computeExtendedEndDate(product);
-        expect(result.getTime()).toBe(end.getTime() + AUCTION_DEFAULT_EXTENSION_MINUTES * 60 * 1000);
-    });
-});
-describe("assertAuctionActive (integration with repo mock)", async () => {
-    const { assertAuctionActive } = await import("../service");
-    it("auction exists + active → returns product", async () => {
-        const activeAuction = makeAuction();
-        productRepository.findByIdOrSlug.mockResolvedValue(activeAuction);
-        const result = await assertAuctionActive("auction-test");
-        expect(result).toBeDefined();
-    });
-    it("product not found → throws AuctionNotFoundError", async () => {
-        productRepository.findByIdOrSlug.mockResolvedValue(null);
-        const { AuctionNotFoundError } = await import("../../../../shared/features/auctions/errors");
-        await expect(assertAuctionActive("nonexistent")).rejects.toBeInstanceOf(AuctionNotFoundError);
-    });
-    it("product found but not an auction listing → throws AuctionNotFoundError", async () => {
-        const standardProduct = makeAuction({ listingType: "standard" });
-        productRepository.findByIdOrSlug.mockResolvedValue(standardProduct);
-        const { AuctionNotFoundError } = await import("../../../../shared/features/auctions/errors");
-        await expect(assertAuctionActive("auction-test")).rejects.toBeInstanceOf(AuctionNotFoundError);
-    });
-    it("auction exists but endDate in past → throws AuctionEndedError", async () => {
-        const expiredAuction = makeAuction({ auctionEndDate: new Date(Date.now() - 1000) });
-        productRepository.findByIdOrSlug.mockResolvedValue(expiredAuction);
-        const { AuctionEndedError } = await import("../../../../shared/features/auctions/errors");
-        await expect(assertAuctionActive("auction-test")).rejects.toBeInstanceOf(AuctionEndedError);
-    });
-});

package/dist/_internal/server/features/checkout/__tests__/actions.test.d.ts

@@ -1 +0,0 @@
-export {};