@mohasinac/appkit 2.6.0 → 2.6.2

package/dist/_internal/client/features/layout/DashboardLayoutClient.d.ts

@@ -0,0 +1,38 @@
+/**
+ * DashboardLayoutClient — unified client island that replaces the ~75 lines of
+ * boilerplate previously duplicated across admin/store/user layout.tsx files.
+ *
+ * Responsibilities:
+ *  - Manage desktop + mobile drawer state (matchMedia-aware).
+ *  - Register handlers with `useDashboardNav()` so the public TitleBar's
+ *    hamburger forwards to this dashboard sidebar.
+ *  - Pick the correct sidebar component for the supplied `variant`.
+ *  - Resolve `activeHref` from `usePathname()` so consumers do not have to.
+ *
+ * Consumers pass:
+ *   <DashboardLayoutClient variant="admin" groups={ADMIN_NAV_GROUPS}>
+ *     {children}
+ *   </DashboardLayoutClient>
+ *
+ * Theming: each variant uses its accent token map from shared/features/layout/config.
+ * Responsive: sidebar is overlay on <md, persistent rail on ≥lg — controlled by
+ * the underlying *Sidebar components.
+ */
+import { type ReactNode } from "react";
+import type { DashboardVariant, SidebarNavGroup, SectionResponsive } from "../../../shared/features/layout/types";
+export interface DashboardLayoutClientProps {
+    /** Drives sidebar component selection + accent colour. */
+    variant: DashboardVariant;
+    /** Grouped nav items. Shape matches all three sidebar components. */
+    groups: SidebarNavGroup[];
+    /** Override active-link highlight. Defaults to usePathname(). */
+    activeHref?: string;
+    /** Responsive controls — currently only hideAt is honoured. */
+    responsive?: SectionResponsive;
+    /** Optional render-prop slot for additional sidebar footer content. */
+    renderSidebarFooter?: () => ReactNode;
+    /** Optional className passed through to the sidebar component. */
+    className?: string;
+    children: ReactNode;
+}
+export declare function DashboardLayoutClient({ variant, groups, activeHref: explicitActiveHref, responsive: _responsive, className, children, }: DashboardLayoutClientProps): import("react/jsx-runtime").JSX.Element;

package/dist/_internal/client/features/layout/DashboardLayoutClient.js

@@ -0,0 +1,75 @@
+"use client";
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * DashboardLayoutClient — unified client island that replaces the ~75 lines of
+ * boilerplate previously duplicated across admin/store/user layout.tsx files.
+ *
+ * Responsibilities:
+ *  - Manage desktop + mobile drawer state (matchMedia-aware).
+ *  - Register handlers with `useDashboardNav()` so the public TitleBar's
+ *    hamburger forwards to this dashboard sidebar.
+ *  - Pick the correct sidebar component for the supplied `variant`.
+ *  - Resolve `activeHref` from `usePathname()` so consumers do not have to.
+ *
+ * Consumers pass:
+ *   <DashboardLayoutClient variant="admin" groups={ADMIN_NAV_GROUPS}>
+ *     {children}
+ *   </DashboardLayoutClient>
+ *
+ * Theming: each variant uses its accent token map from shared/features/layout/config.
+ * Responsive: sidebar is overlay on <md, persistent rail on ≥lg — controlled by
+ * the underlying *Sidebar components.
+ */
+import { useCallback, useEffect, useState, startTransition } from "react";
+import { usePathname } from "next/navigation";
+import { useDashboardNav } from "../../../../features/layout/DashboardNavContext";
+import { AdminSidebar } from "../../../../features/admin/components/AdminSidebar";
+import { StoreSidebar } from "../../../../features/seller/components/SellerSidebar";
+import { UserSidebar } from "../../../../features/account/components/UserSidebar";
+import { DASHBOARD_DESKTOP_MEDIA_QUERY } from "../../../shared/features/layout/config";
+/**
+ * Hoisted drawer-state hook — the matchMedia-aware open/close logic that was
+ * triplicated across admin/store/user layouts. Used internally by
+ * DashboardLayoutClient; not exported because it's not generically useful.
+ */
+function useResponsiveDrawer() {
+    const [desktopOpen, setDesktopOpen] = useState(false);
+    const [mobileOpen, setMobileOpen] = useState(false);
+    const { registerNav, unregisterNav } = useDashboardNav();
+    const isDesktop = useCallback(() => typeof window !== "undefined" && window.matchMedia(DASHBOARD_DESKTOP_MEDIA_QUERY).matches, []);
+    const open = useCallback(() => {
+        startTransition(() => {
+            if (isDesktop())
+                setDesktopOpen(true);
+            else
+                setMobileOpen(true);
+        });
+    }, [isDesktop]);
+    const close = useCallback(() => {
+        startTransition(() => {
+            if (isDesktop())
+                setDesktopOpen(false);
+            else
+                setMobileOpen(false);
+        });
+    }, [isDesktop]);
+    const toggle = useCallback(() => {
+        startTransition(() => {
+            if (isDesktop())
+                setDesktopOpen((prev) => !prev);
+            else
+                setMobileOpen((prev) => !prev);
+        });
+    }, [isDesktop]);
+    useEffect(() => {
+        registerNav({ open, close, toggle });
+        return () => unregisterNav();
+    }, [registerNav, unregisterNav, open, close, toggle]);
+    return { desktopOpen, mobileOpen, close, toggle };
+}
+export function DashboardLayoutClient({ variant, groups, activeHref: explicitActiveHref, responsive: _responsive, className, children, }) {
+    const pathname = usePathname();
+    const activeHref = explicitActiveHref ?? pathname ?? "";
+    const { desktopOpen, mobileOpen, close, toggle } = useResponsiveDrawer();
+    return (_jsxs(_Fragment, { children: [variant === "admin" && (_jsx(AdminSidebar, { variant: "sidebar", desktopOpen: desktopOpen, mobileOpen: mobileOpen, activePath: activeHref, groups: groups, onCloseMobile: close, onToggle: toggle, className: className })), variant === "store" && (_jsx(StoreSidebar, { variant: "sidebar", desktopOpen: desktopOpen, mobileOpen: mobileOpen, activeHref: activeHref, items: [], groups: groups, onCloseMobile: close, onToggle: toggle, className: className })), variant === "user" && (_jsx(UserSidebar, { variant: "sidebar", desktopOpen: desktopOpen, mobileOpen: mobileOpen, items: groups.flatMap((g) => g.items), groups: groups, onCloseMobile: close, onToggle: toggle, className: className })), children] }));
+}

package/dist/_internal/client/features/layout/RoleGuard.d.ts

@@ -0,0 +1,15 @@
+import type { ReactNode } from "react";
+import type { LayoutRole } from "../../../shared/features/layout/types";
+export interface RoleGuardProps {
+    /** Single role or array. Omit for auth-only (any signed-in user). */
+    role?: LayoutRole | LayoutRole[];
+    /** When true, unauthenticated users are redirected (default true). */
+    requireAuth?: boolean;
+    /** Optional route overrides (defaults come from appkit ROUTES). */
+    loginPath?: string;
+    unauthorizedPath?: string;
+    /** Render while loading the session. */
+    loadingComponent?: ReactNode;
+    children: ReactNode;
+}
+export declare function RoleGuard({ role, requireAuth, loginPath, unauthorizedPath, loadingComponent, children, }: RoleGuardProps): import("react/jsx-runtime").JSX.Element;

package/dist/_internal/client/features/layout/RoleGuard.js

@@ -0,0 +1,25 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * RoleGuard — preset wrapper over ProtectedRoute.
+ *
+ * Collapses the boilerplate that every dashboard layout repeats:
+ *   - reading `useSession()`
+ *   - resolving `onNavigate` against the i18n router
+ *   - passing default `routes.loginPath` / `routes.unauthorizedPath`
+ *
+ * Consumers supply only the `role` (or none, for auth-only) plus optional
+ * route overrides. Everything else defaults to appkit's ROUTES.
+ */
+import { useRouter } from "next/navigation";
+import { ProtectedRoute } from "../../../../features/auth/components/Guards";
+import { useSession } from "../../../../react/contexts/SessionContext";
+import { ROUTES } from "../../../../next/routing/route-map";
+export function RoleGuard({ role, requireAuth = true, loginPath, unauthorizedPath, loadingComponent, children, }) {
+    const { user, loading } = useSession();
+    const router = useRouter();
+    return (_jsx(ProtectedRoute, { user: user, loading: loading, requireAuth: requireAuth, requireRole: role, onNavigate: (path) => router.push(path), routes: {
+            loginPath: loginPath ?? String(ROUTES.AUTH.LOGIN),
+            unauthorizedPath: unauthorizedPath ?? String(ROUTES.ERRORS.UNAUTHORIZED),
+        }, loadingComponent: loadingComponent, children: children }));
+}

package/dist/_internal/client/features/layout/index.d.ts

@@ -0,0 +1,5 @@
+/** Layout feature — client islands barrel. */
+export { DashboardLayoutClient } from "./DashboardLayoutClient";
+export type { DashboardLayoutClientProps } from "./DashboardLayoutClient";
+export { RoleGuard } from "./RoleGuard";
+export type { RoleGuardProps } from "./RoleGuard";

package/dist/_internal/client/features/layout/index.js

@@ -0,0 +1,4 @@
+"use client";
+/** Layout feature — client islands barrel. */
+export { DashboardLayoutClient } from "./DashboardLayoutClient";
+export { RoleGuard } from "./RoleGuard";

package/dist/_internal/server/features/brands/actions.d.ts

@@ -1,4 +1,4 @@
-export declare function createBrandAction(input: unknown): Promise<import("../../../..").BrandDocument>;
-export declare function updateBrandAction(brandId: string, input: unknown): Promise<import("../../../..").BrandDocument>;
+export declare function createBrandAction(input: unknown): Promise<import("../../../..").CategoryDocument>;
+export declare function updateBrandAction(brandId: string, input: unknown): Promise<import("../../../..").CategoryDocument>;
 export declare function deleteBrandAction(brandId: string): Promise<void>;
-export declare function toggleBrandActiveAction(brandId: string, isActive: boolean): Promise<import("../../../..").BrandDocument>;
+export declare function toggleBrandActiveAction(brandId: string, isActive: boolean): Promise<import("../../../..").CategoryDocument>;

package/dist/_internal/server/features/brands/actions.js

@@ -1,16 +1,83 @@
 "use server";
-import { brandsRepository } from "../../../../repositories";
+import { categoriesRepository } from "../../../../repositories";
 import { requireRoleUser } from "../../../../providers/auth-firebase/helpers";
 import { brandInputSchema, brandUpdateSchema } from "../../../shared/features/brands/schema";
 import { assertBrandExists, assertBrandSlugUnique } from "./service";
 import { ValidationError } from "../../../shared/errors/index";
+/**
+ * Translate the brand-input wire format (logoURL / bannerURL / website /
+ * country / founded) to the CategoryDocument storage shape after
+ * SB-UNI-C consolidated brands into the categories collection.
+ */
+function brandInputToCategoryFields(input) {
+    const out = {};
+    if ("name" in input && input.name !== undefined)
+        out.name = input.name;
+    if ("slug" in input && input.slug !== undefined) {
+        out.slug = input.slug;
+        out.path = input.slug;
+    }
+    if (input.description !== undefined)
+        out.description = input.description;
+    if (input.website !== undefined)
+        out.brandWebsite = input.website;
+    if (input.country !== undefined)
+        out.brandCountry = input.country;
+    if (input.founded !== undefined)
+        out.brandFounded = input.founded;
+    if (input.bannerURL !== undefined)
+        out.brandBannerImage = input.bannerURL;
+    if (input.logoURL !== undefined) {
+        out.display = { coverImage: input.logoURL, showInMenu: false, showInFooter: false };
+    }
+    if (input.isActive !== undefined)
+        out.isActive = input.isActive;
+    if (input.displayOrder !== undefined)
+        out.order = input.displayOrder;
+    return out;
+}
 export async function createBrandAction(input) {
     await requireRoleUser("admin");
     const parsed = brandInputSchema.safeParse(input);
     if (!parsed.success)
         throw new ValidationError(parsed.error.errors[0]?.message ?? "Invalid brand input");
     await assertBrandSlugUnique(parsed.data.slug);
-    return brandsRepository.createWithId(parsed.data.slug, parsed.data);
+    const fields = brandInputToCategoryFields(parsed.data);
+    return categoriesRepository.createWithId(parsed.data.slug, {
+        id: parsed.data.slug,
+        name: parsed.data.name,
+        slug: parsed.data.slug,
+        categoryType: "brand",
+        rootId: parsed.data.slug,
+        parentIds: [],
+        childrenIds: [],
+        tier: 0,
+        path: parsed.data.slug,
+        position: 0,
+        subtreeSize: 1,
+        order: parsed.data.displayOrder,
+        isLeaf: true,
+        isFeatured: false,
+        isBrand: true,
+        isActive: parsed.data.isActive,
+        isSearchable: true,
+        metrics: {
+            productCount: 0,
+            productIds: [],
+            auctionCount: 0,
+            auctionIds: [],
+            totalProductCount: 0,
+            totalAuctionCount: 0,
+            totalItemCount: 0,
+            lastUpdated: new Date(),
+        },
+        seo: { title: parsed.data.name, description: parsed.data.description ?? "", keywords: [parsed.data.name] },
+        ancestors: [],
+        createdBy: "admin",
+        createdAt: new Date(),
+        updatedAt: new Date(),
+        ...fields,
+    });
 }
 export async function updateBrandAction(brandId, input) {
     await requireRoleUser("admin");
@@ -18,15 +85,15 @@ export async function updateBrandAction(brandId, input) {
     const parsed = brandUpdateSchema.safeParse(input);
     if (!parsed.success)
         throw new ValidationError(parsed.error.errors[0]?.message ?? "Invalid brand input");
-    return brandsRepository.update(brandId, parsed.data);
+    return categoriesRepository.update(brandId, brandInputToCategoryFields(parsed.data));
 }
 export async function deleteBrandAction(brandId) {
     await requireRoleUser("admin");
     await assertBrandExists(brandId);
-    return brandsRepository.delete(brandId);
+    return categoriesRepository.delete(brandId);
 }
 export async function toggleBrandActiveAction(brandId, isActive) {
     await requireRoleUser("admin");
     await assertBrandExists(brandId);
-    return brandsRepository.update(brandId, { isActive });
+    return categoriesRepository.update(brandId, { isActive });
 }

package/dist/_internal/server/features/brands/data.d.ts

@@ -1,12 +1,12 @@
-import type { BrandDocument } from "../../../../features/brands/schemas";
 import type { CategoryDocument } from "../../../../features/categories/schemas/firestore";
-export declare const getBrandForDetail: (slug: string) => Promise<BrandDocument | null>;
 /**
- * Brand-as-category lookup for the brand detail view, deduped per request.
- *
- * BrandDetailPageView renders the categories-collection record (display + metrics
- * fields), not the brands-collection record. Keep both fetchers so
- * generateMetadata can pull BrandDocument fields (logoURL) while the view pulls
- * CategoryDocument.
+ * Brand detail loader — SB-UNI-C moved brands into the `categories`
+ * collection with `categoryType: "brand"`. Both `generateMetadata` and
+ * `BrandDetailPageView` consume the same `CategoryDocument` shape.
+ */
+export declare const getBrandForDetail: (slug: string) => Promise<CategoryDocument | null>;
+/**
+ * @deprecated Identical to getBrandForDetail after SB-UNI-C. Kept as an
+ * alias so existing imports don't break.
  */
 export declare const getBrandCategoryForDetail: (slug: string) => Promise<CategoryDocument | null>;

package/dist/_internal/server/features/brands/data.js

@@ -1,16 +1,15 @@
 import { cache } from "react";
-import { brandsRepository, categoriesRepository } from "../../../../repositories";
+import { categoriesRepository } from "../../../../repositories";
+/**
+ * Brand detail loader — SB-UNI-C moved brands into the `categories`
+ * collection with `categoryType: "brand"`. Both `generateMetadata` and
+ * `BrandDetailPageView` consume the same `CategoryDocument` shape.
+ */
 export const getBrandForDetail = cache(async (slug) => {
-    return (await brandsRepository.findBySlug(slug).catch(() => undefined)) ?? null;
+    return categoriesRepository.findBySlugAndType(slug, "brand").catch(() => null);
 });
 /**
- * Brand-as-category lookup for the brand detail view, deduped per request.
- *
- * BrandDetailPageView renders the categories-collection record (display + metrics
- * fields), not the brands-collection record. Keep both fetchers so
- * generateMetadata can pull BrandDocument fields (logoURL) while the view pulls
- * CategoryDocument.
+ * @deprecated Identical to getBrandForDetail after SB-UNI-C. Kept as an
+ * alias so existing imports don't break.
  */
-export const getBrandCategoryForDetail = cache(async (slug) => {
-    return categoriesRepository.getCategoryBySlug(slug).catch(() => null);
-});
+export const getBrandCategoryForDetail = getBrandForDetail;

package/dist/_internal/server/features/brands/service.d.ts

@@ -1,3 +1,3 @@
-import type { BrandDocument } from "../../../../features/brands/schemas";
-export declare function assertBrandExists(slugOrId: string): Promise<BrandDocument>;
+import type { CategoryDocument } from "../../../../features/categories/schemas/firestore";
+export declare function assertBrandExists(slugOrId: string): Promise<CategoryDocument>;
 export declare function assertBrandSlugUnique(slug: string): Promise<void>;

package/dist/_internal/server/features/brands/service.js

@@ -1,14 +1,14 @@
-import { brandsRepository } from "../../../../repositories";
+import { categoriesRepository } from "../../../../repositories";
 import { BrandNotFoundError, BrandSlugConflictError } from "../../../shared/features/brands/errors";
 export async function assertBrandExists(slugOrId) {
-    const brand = await brandsRepository.findBySlug(slugOrId).catch(() => null)
-        ?? await brandsRepository.findById(slugOrId).catch(() => null);
-    if (!brand)
+    const brand = (await categoriesRepository.findBySlugAndType(slugOrId, "brand").catch(() => null)) ??
+        (await categoriesRepository.findById(slugOrId).catch(() => null));
+    if (!brand || brand.categoryType !== "brand")
         throw new BrandNotFoundError(slugOrId);
     return brand;
 }
 export async function assertBrandSlugUnique(slug) {
-    const existing = await brandsRepository.findBySlug(slug).catch(() => null);
+    const existing = await categoriesRepository.findBySlugAndType(slug, "brand").catch(() => null);
     if (existing)
         throw new BrandSlugConflictError(slug);
 }

package/dist/_internal/server/features/categories/og.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Category OG image renderer — S6 OG1.
+ *
+ * Two layers:
+ *  - `renderCategoryOg(doc, opts)` — high-level: maps a raw category doc
+ *    (from `getCategoryForDetail`) into the OG data shape.
+ *  - `renderCategoryOgImage(data, siteName)` — pure JSX primitive, no
+ *    next/og dependency; consumer wraps with `new ImageResponse(...)`.
+ *
+ * Mirrors the brand/store OG layout so the public catalog feels uniform.
+ */
+import type { ReactElement } from "react";
+export interface CategoryOgData {
+    name: string;
+    description?: string | null;
+    coverImageUrl?: string | null;
+    productCount?: number | null;
+}
+interface CategoryDocLike {
+    name?: string | null;
+    description?: string | null;
+    display?: {
+        coverImage?: string | null;
+    } | null;
+    metrics?: {
+        totalItemCount?: number | null;
+    } | null;
+}
+export declare function renderCategoryOg(doc: CategoryDocLike | null | undefined, opts: {
+    siteName: string;
+}): ReactElement;
+export declare function renderCategoryOgImage(data: CategoryOgData, siteName: string): ReactElement;
+export {};

package/dist/_internal/server/features/categories/og.js

@@ -0,0 +1,75 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+export function renderCategoryOg(doc, opts) {
+    const name = doc?.name ?? "Category";
+    return renderCategoryOgImage({
+        name,
+        description: doc?.description?.slice(0, 140) ??
+            `Browse ${name} on ${opts.siteName}.`,
+        coverImageUrl: doc?.display?.coverImage ?? null,
+        productCount: doc?.metrics?.totalItemCount ?? null,
+    }, opts.siteName);
+}
+export function renderCategoryOgImage(data, siteName) {
+    const { name, description, coverImageUrl, productCount } = data;
+    const itemLabel = typeof productCount === "number" && productCount > 0
+        ? `${productCount.toLocaleString("en-IN")} item${productCount === 1 ? "" : "s"}`
+        : null;
+    return (_jsxs("div", { style: {
+            display: "flex",
+            width: "100%",
+            height: "100%",
+            background: "#0f172a",
+            fontFamily: "sans-serif",
+            position: "relative",
+            overflow: "hidden",
+        }, children: [coverImageUrl && (_jsx("img", { src: coverImageUrl, alt: "", style: {
+                    position: "absolute",
+                    inset: 0,
+                    width: "100%",
+                    height: "100%",
+                    objectFit: "cover",
+                    opacity: 0.35,
+                } })), _jsx("div", { style: {
+                    position: "absolute",
+                    inset: 0,
+                    background: "linear-gradient(135deg, rgba(15, 23, 42, 0.85) 0%, rgba(30, 41, 59, 0.7) 100%)",
+                } }), _jsxs("div", { style: {
+                    position: "relative",
+                    display: "flex",
+                    flexDirection: "column",
+                    gap: 24,
+                    padding: "80px 72px",
+                    width: "100%",
+                    height: "100%",
+                    justifyContent: "flex-end",
+                }, children: [_jsxs("div", { style: {
+                            fontSize: 18,
+                            color: "#94a3b8",
+                            fontWeight: 600,
+                            letterSpacing: 2,
+                            textTransform: "uppercase",
+                        }, children: [siteName, " \u00B7 Category"] }), _jsx("div", { style: {
+                            fontSize: 76,
+                            fontWeight: 800,
+                            color: "#f8fafc",
+                            lineHeight: 1.05,
+                            letterSpacing: -1,
+                        }, children: name }), description && (_jsx("div", { style: {
+                            fontSize: 26,
+                            color: "#cbd5e1",
+                            fontWeight: 400,
+                            lineHeight: 1.35,
+                            maxWidth: 960,
+                        }, children: description })), itemLabel && (_jsx("div", { style: {
+                            display: "inline-flex",
+                            alignSelf: "flex-start",
+                            padding: "10px 22px",
+                            borderRadius: 999,
+                            background: "rgba(56, 189, 248, 0.18)",
+                            color: "#e0f2fe",
+                            fontSize: 22,
+                            fontWeight: 600,
+                            border: "1px solid rgba(56, 189, 248, 0.4)",
+                            marginTop: 8,
+                        }, children: itemLabel }))] })] }));
+}

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

@@ -33,3 +33,27 @@ export declare function attachPaymentAction(input: {
     paymentId: string;
     paidAmount: number;
 }): Promise<void>;
+export interface VerifyAndPlaceRazorpayOrderInput {
+    userId: string;
+    userName: string;
+    userEmail: string;
+    razorpay_order_id: string;
+    razorpay_payment_id: string;
+    razorpay_signature: string;
+    addressId: string;
+    notes?: string;
+}
+/**
+ * Place order(s) from the user's cart after a Razorpay payment is verified.
+ * Mirrors the existing /api/payment/verify route handler.
+ *
+ * Consumers must authenticate the user before calling. The action performs:
+ *   1. HMAC signature verification (rejects forged callbacks)
+ *   2. Cart re-validation against current product prices/stock
+ *   3. Amount cross-check against the Razorpay order record
+ *   4. Atomic stock decrement + cart clear via unitOfWork batch
+ *   5. Multi-coupon pro-rating per order group
+ *   6. order_placed notifications (buyer + seller)
+ *   7. Confirmation email + RTDB success signal (both fire-and-forget)
+ */
+export declare function verifyAndPlaceRazorpayOrderAction(input: VerifyAndPlaceRazorpayOrderInput): Promise<CheckoutOrderResult>;