@mohasinac/appkit 2.3.0 → 2.3.1

package/dist/features/layout/TitleBar.js

@@ -0,0 +1,23 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useCartCount } from "../cart/hooks/useCartCount";
+import { useDashboardNav } from "./DashboardNavContext";
+import { TitleBarLayout } from "./TitleBarLayout";
+/**
+ * TitleBar � domain shell over TitleBarLayout.
+ *
+ * Reads `useCartCount` and `useDashboardNav` from appkit.
+ * Pass `user` from your consumer`s auth context.
+ *
+ * Wrap with `DashboardNavProvider` at the app root to enable the
+ * dashboard nav button in nested admin/seller/user routes.
+ */
+export function TitleBar({ suppressDashboardNav, onBeforeToggleDashboardNav, ...rest }) {
+    const cartCount = useCartCount();
+    const { hasNav: hasDashboardNav, toggleNav: toggleDashboardNav } = useDashboardNav();
+    return (_jsx(TitleBarLayout, { ...rest, cartCount: cartCount, hasDashboardNav: suppressDashboardNav ? false : hasDashboardNav, onToggleDashboardNav: suppressDashboardNav
+            ? undefined
+            : () => {
+                onBeforeToggleDashboardNav?.();
+                toggleDashboardNav();
+            }, hideSidebarToggle: rest.hideSidebarToggle ?? suppressDashboardNav }));
+}

package/dist/features/layout/TitleBarLayout.d.ts

@@ -0,0 +1,50 @@
+import React from "react";
+/** Minimal user shape required by the title bar. */
+export interface TitleBarUser {
+    displayName: string | null;
+    email: string | null;
+    photoURL: string | null;
+    /** Role string — used for display only. */
+    role?: string;
+}
+export interface TitleBarLayoutProps {
+    onToggleSidebar: () => void;
+    sidebarOpen: boolean;
+    onSearchToggle: () => void;
+    searchOpen: boolean;
+    brandName: string;
+    brandShortName?: string;
+    logoHref: string;
+    promotionsHref?: string;
+    /** Href for the compare page/drawer. When provided, renders a Compare icon button. */
+    compareHref?: string;
+    cartHref?: string;
+    cartCount?: number;
+    profileHref?: string;
+    user?: TitleBarUser | null;
+    /** Slot rendered between the search button and profile link (e.g. NotificationBell). */
+    notificationSlot?: React.ReactNode;
+    /** Optional dev-only action slot rendered in the right-side action group. */
+    devSlot?: React.ReactNode;
+    /** Optional nav slot rendered between logo and right action icons (desktop only). */
+    navSlot?: React.ReactNode;
+    /** When set, renders a dismissable promo micro-strip above the header. */
+    promoStripText?: string;
+    isDark?: boolean;
+    onToggleTheme?: () => void;
+    /** Whether a dashboard section has registered a secondary navigation drawer. */
+    hasDashboardNav?: boolean;
+    /** Callback to toggle the registered dashboard navigation drawer. */
+    onToggleDashboardNav?: () => void;
+    /** Hide the public sidebar toggle button when nested layouts own navigation. */
+    hideSidebarToggle?: boolean;
+    id?: string;
+    className?: string;
+}
+/**
+ * TitleBarLayout — generic top sticky title-bar shell.
+ *
+ * Receives all domain data as props — zero domain imports.
+ * Domain shell reads useAuth() and SITE_CONFIG and passes values in.
+ */
+export declare function TitleBarLayout({ onToggleSidebar, sidebarOpen, onSearchToggle, searchOpen, brandName, brandShortName, logoHref, promotionsHref, compareHref, cartHref, cartCount, profileHref, user, notificationSlot, devSlot, navSlot, promoStripText, isDark, onToggleTheme, hasDashboardNav, onToggleDashboardNav, hideSidebarToggle, id, className, }: TitleBarLayoutProps): import("react/jsx-runtime").JSX.Element;

package/dist/features/layout/TitleBarLayout.js

@@ -0,0 +1,16 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import Image from "next/image";
+import Link from "next/link";
+import { BlockHeader, Button, Div, Row, Span } from "../../ui";
+/**
+ * TitleBarLayout — generic top sticky title-bar shell.
+ *
+ * Receives all domain data as props — zero domain imports.
+ * Domain shell reads useAuth() and SITE_CONFIG and passes values in.
+ */
+export function TitleBarLayout({ onToggleSidebar, sidebarOpen, onSearchToggle, searchOpen, brandName, brandShortName, logoHref, promotionsHref, compareHref, cartHref, cartCount = 0, profileHref, user, notificationSlot, devSlot, navSlot, promoStripText, isDark = false, onToggleTheme, hasDashboardNav = false, onToggleDashboardNav, hideSidebarToggle = false, id = "titlebar", className = "", }) {
+    void searchOpen;
+    return (_jsxs(BlockHeader, { id: id, className: `sticky top-0 z-50 bg-white/95 dark:bg-slate-950/95 backdrop-blur-md border-b border-zinc-100 dark:border-slate-800 shadow-sm ${className}`, children: [promoStripText && (_jsx(Div, { className: "bg-gradient-to-r from-primary-700 to-blue-700 dark:from-secondary-700 dark:to-blue-700 text-white text-xs py-1 text-center font-medium", children: promoStripText })), _jsx(Div, { className: "container mx-auto px-4 sm:px-6 lg:px-8 max-w-[1920px]", children: _jsxs(Row, { justify: "between", gap: "none", className: "h-14", children: [_jsxs(Row, { gap: "3", children: [hasDashboardNav && onToggleDashboardNav && (_jsx(Button, { type: "button", variant: "ghost", size: "sm", "aria-label": "Toggle dashboard navigation", onClick: onToggleDashboardNav, className: "flex items-center justify-center w-9 h-9 rounded-lg text-zinc-600 dark:text-zinc-400 hover:bg-primary-50 hover:text-primary-700 dark:hover:bg-slate-800 dark:hover:text-secondary-400 transition-colors", children: _jsx("svg", { className: "w-5 h-5", fill: "none", stroke: "currentColor", viewBox: "0 0 24 24", "aria-hidden": "true", children: _jsx("path", { strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: 2, d: "M4 6h16M4 12h16M4 18h16" }) }) })), _jsx(Link, { href: logoHref, className: "font-bold text-xl tracking-tight text-zinc-900 dark:text-zinc-50 hover:text-primary dark:hover:text-secondary transition-colors", children: brandShortName ? (_jsxs(_Fragment, { children: [_jsx(Span, { className: "md:hidden", children: brandShortName }), _jsx(Span, { className: "hidden md:inline", children: brandName })] })) : (brandName) })] }), navSlot && _jsx(Div, { className: "hidden md:flex", children: navSlot }), _jsxs(Row, { gap: "xs", children: [promotionsHref && (_jsxs(Link, { href: promotionsHref, "aria-label": "Today's deals", className: "hidden lg:flex items-center gap-1 px-3 py-1 rounded-full text-xs font-bold bg-primary-100 text-primary-700 dark:bg-secondary-900/40 dark:text-secondary-400 hover:bg-primary-200 dark:hover:bg-secondary-900/60 transition-colors border border-primary-200/60 dark:border-secondary-700/40", children: [_jsx("svg", { className: "w-3 h-3", viewBox: "0 0 24 24", fill: "currentColor", "aria-hidden": "true", children: _jsx("path", { d: "M21.41 11.58l-9-9C12.05 2.22 11.55 2 11 2H4c-1.1 0-2 .9-2 2v7c0 .55.22 1.05.59 1.42l9 9c.36.37.86.58 1.41.58.55 0 1.05-.21 1.41-.59l7-7c.37-.36.59-.86.59-1.41 0-.55-.23-1.06-.59-1.42zM5.5 7C4.67 7 4 6.33 4 5.5S4.67 4 5.5 4 7 4.67 7 5.5 6.33 7 5.5 7z" }) }), "Today's Deals"] })), compareHref && (_jsx(Link, { href: compareHref, "aria-label": "Compare items", className: "hidden lg:flex items-center justify-center w-9 h-9 rounded-lg text-zinc-600 dark:text-zinc-400 hover:bg-primary-50 hover:text-primary-700 dark:hover:bg-slate-800 dark:hover:text-secondary-400 transition-colors", children: _jsx("svg", { className: "w-5 h-5", fill: "none", stroke: "currentColor", viewBox: "0 0 24 24", "aria-hidden": "true", children: _jsx("path", { strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: 2, d: "M9 19v-6a2 2 0 00-2-2H5a2 2 0 00-2 2v6a2 2 0 002 2h2a2 2 0 002-2zm0 0V9a2 2 0 012-2h2a2 2 0 012 2v10m-6 0a2 2 0 002 2h2a2 2 0 002-2m0 0V5a2 2 0 012-2h2a2 2 0 012 2v14a2 2 0 01-2 2h-2a2 2 0 01-2-2z" }) }) })), _jsx(Button, { type: "button", variant: "ghost", size: "sm", "aria-label": "Search", onClick: onSearchToggle, className: "flex items-center justify-center w-9 h-9 rounded-lg text-zinc-600 dark:text-zinc-400 hover:bg-primary-50 hover:text-primary-700 dark:hover:bg-slate-800 dark:hover:text-secondary-400 transition-colors", children: _jsx("svg", { className: "w-5 h-5", fill: "none", stroke: "currentColor", viewBox: "0 0 24 24", "aria-hidden": "true", children: _jsx("path", { strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: 2, d: "M21 21l-4.35-4.35M17 11A6 6 0 1 1 5 11a6 6 0 0 1 12 0z" }) }) }), notificationSlot, devSlot, onToggleTheme && (_jsx(Button, { type: "button", variant: "ghost", size: "sm", "aria-label": isDark ? "Switch to light mode" : "Switch to dark mode", onClick: onToggleTheme, className: "flex items-center justify-center w-9 h-9 rounded-lg text-zinc-600 dark:text-zinc-400 hover:bg-primary-50 hover:text-primary-700 dark:hover:bg-slate-800 dark:hover:text-secondary-400 transition-colors", children: isDark ? (_jsx("svg", { className: "w-5 h-5", fill: "none", stroke: "currentColor", viewBox: "0 0 24 24", "aria-hidden": "true", children: _jsx("path", { strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: 2, d: "M12 3v1m0 16v1m8.66-9h-1M4.34 12h-1m15.07-6.07-.71.71M6.34 17.66l-.71.71m12.73 0-.71-.71M6.34 6.34l-.71-.71M12 5a7 7 0 1 0 0 14A7 7 0 0 0 12 5z" }) })) : (_jsx("svg", { className: "w-5 h-5", fill: "none", stroke: "currentColor", viewBox: "0 0 24 24", "aria-hidden": "true", children: _jsx("path", { strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: 2, d: "M21 12.79A9 9 0 1 1 11.21 3a7 7 0 1 0 9.79 9.79z" }) })) })), cartHref && (_jsxs(Link, { href: cartHref, "aria-label": `Cart${cartCount > 0 ? `, ${cartCount} items` : ""}`, className: "relative flex items-center justify-center w-9 h-9 rounded-lg text-zinc-600 dark:text-zinc-400 hover:bg-primary-50 hover:text-primary-700 dark:hover:bg-slate-800 dark:hover:text-secondary-400 transition-colors", children: [_jsx("svg", { className: "w-5 h-5", fill: "none", stroke: "currentColor", viewBox: "0 0 24 24", "aria-hidden": "true", children: _jsx("path", { strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: 2, d: "M2.25 3h1.386c.51 0 .955.343 1.087.835l.383 1.437M7.5 14.25a3 3 0 0 0-3 3h15.75m-12.75-3h11.218c1.121-2.3 2.1-4.684 2.924-7.138a60.114 60.114 0 0 0-16.536-1.84M7.5 14.25 5.106 5.272M6 20.25a.75.75 0 1 1-1.5 0 .75.75 0 0 1 1.5 0zm12.75 0a.75.75 0 1 1-1.5 0 .75.75 0 0 1 1.5 0z" }) }), cartCount > 0 && (_jsx(Span, { className: "absolute -top-0.5 -right-0.5 flex items-center justify-center w-4 h-4 rounded-full bg-red-500 text-white text-[10px] font-bold leading-none", children: cartCount > 9 ? "9+" : cartCount }))] })), !hideSidebarToggle && (_jsx(Button, { type: "button", variant: "ghost", size: "sm", "aria-label": sidebarOpen ? "Close menu" : "Open menu", "aria-expanded": sidebarOpen, "aria-controls": "secondary-sidebar", onClick: onToggleSidebar, className: "flex items-center justify-center w-9 h-9 rounded-lg text-zinc-600 dark:text-zinc-400 hover:bg-primary-50 hover:text-primary-700 dark:hover:bg-slate-800 dark:hover:text-secondary-400 transition-colors", children: _jsx("svg", { className: "w-5 h-5", fill: "none", stroke: "currentColor", viewBox: "0 0 24 24", "aria-hidden": "true", children: sidebarOpen ? (_jsx("path", { strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: 2, d: "M6 18L18 6M6 6l12 12" })) : (_jsx("path", { strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: 2, d: "M4 6h16M4 12h16M4 18h16" })) }) })), profileHref && (_jsx(Link, { href: profileHref, "aria-label": user
+                                        ? `Profile — ${user.displayName ?? user.email}`
+                                        : "Sign in", className: "flex items-center justify-center w-9 h-9 rounded-lg text-zinc-600 dark:text-zinc-400 hover:bg-primary-50 hover:text-primary-700 dark:hover:bg-slate-800 dark:hover:text-secondary-400 transition-colors", children: user?.photoURL ? (_jsx(Image, { src: user.photoURL, alt: user.displayName ?? "Profile", width: 28, height: 28, className: "w-7 h-7 rounded-full object-cover" })) : (_jsx("svg", { className: "w-5 h-5", fill: "none", stroke: "currentColor", viewBox: "0 0 24 24", "aria-hidden": "true", children: _jsx("path", { strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: 2, d: "M15.75 6a3.75 3.75 0 1 1-7.5 0 3.75 3.75 0 0 1 7.5 0zM4.501 20.118a7.5 7.5 0 0 1 14.998 0A17.933 17.933 0 0 1 12 21.75c-2.676 0-5.216-.584-7.499-1.632z" }) })) }))] })] }) })] }));
+}

package/dist/features/layout/hooks/useBottomActions.d.ts

@@ -0,0 +1,7 @@
+import { type BottomAction, type BottomBulkConfig } from "../BottomActionsContext";
+export interface UseBottomActionsOptions {
+    actions?: BottomAction[];
+    bulk?: BottomBulkConfig;
+    infoLabel?: string;
+}
+export declare function useBottomActions(options?: UseBottomActionsOptions): void;

package/dist/features/layout/hooks/useBottomActions.js

@@ -0,0 +1,28 @@
+"use client";
+import { useEffect, useRef } from "react";
+import { useBottomActionsContext, } from "../BottomActionsContext";
+export function useBottomActions(options = {}) {
+    const { setActions, setBulkConfig, setInfoLabel, clearAll } = useBottomActionsContext();
+    const actionsRef = useRef(options.actions ?? []);
+    actionsRef.current = options.actions ?? [];
+    const bulkRef = useRef(options.bulk);
+    bulkRef.current = options.bulk;
+    const actionKey = (options.actions ?? [])
+        .map(({ id, label, variant, badge, disabled, loading, grow }) => `${id}|${label}|${variant}|${badge}|${disabled}|${loading}|${grow}`)
+        .join(",");
+    const bulkCountKey = options.bulk
+        ? `${options.bulk.selectedCount}|${options.bulk.actions.map((a) => `${a.id}|${a.label}|${a.variant}|${a.badge}|${a.disabled}|${a.loading}|${a.grow}`).join(",")}`
+        : "";
+    useEffect(() => {
+        setActions(actionsRef.current);
+    }, [setActions, actionKey]);
+    useEffect(() => {
+        setBulkConfig(bulkRef.current);
+    }, [setBulkConfig, bulkCountKey]);
+    useEffect(() => {
+        setInfoLabel(options.infoLabel);
+    }, [setInfoLabel, options.infoLabel]);
+    useEffect(() => {
+        return () => clearAll();
+    }, [clearAll]);
+}

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

@@ -0,0 +1,43 @@
+export { NavbarLayout } from "./NavbarLayout";
+export type { NavbarLayoutProps, NavbarLayoutItem } from "./NavbarLayout";
+export { FooterLayout } from "./FooterLayout";
+export type { FooterLayoutProps, FooterLinkGroup, FooterSocialLink, TrustBarItem, } from "./FooterLayout";
+export { SidebarLayout } from "./SidebarLayout";
+export type { SidebarLayoutProps } from "./SidebarLayout";
+export { BottomNavLayout } from "./BottomNavLayout";
+export type { BottomNavLayoutProps } from "./BottomNavLayout";
+export { BottomNavItem } from "./BottomNavItem";
+export type { BottomNavItemProps } from "./BottomNavItem";
+export { NavItem } from "./NavItem";
+export type { NavItemProps } from "./NavItem";
+export { BottomSheet } from "./BottomSheet";
+export type { BottomSheetProps } from "./BottomSheet";
+export { TitleBarLayout } from "./TitleBarLayout";
+export type { TitleBarLayoutProps, TitleBarUser } from "./TitleBarLayout";
+export { AutoBreadcrumbs } from "./AutoBreadcrumbs";
+export type { AutoBreadcrumbsProps } from "./AutoBreadcrumbs";
+export { Breadcrumbs, BreadcrumbItem } from "./Breadcrumbs";
+export type { BreadcrumbsProps, BreadcrumbItemProps } from "./Breadcrumbs";
+export { LocaleSwitcher } from "./LocaleSwitcher";
+export type { LocaleSwitcherProps, LocaleSwitcherOption, } from "./LocaleSwitcher";
+export { BackToTop, SkipToMain } from "./BackToTop";
+export type { BackToTopProps } from "./BackToTop";
+export { ListingLayout } from "./ListingLayout";
+export type { ListingLayoutProps, ListingLayoutLabels } from "./ListingLayout";
+export { LayoutClient } from "./LayoutClient";
+export type { LayoutClientProps, LayoutProvider } from "./LayoutClient";
+export { AppLayoutShell } from "./AppLayoutShell";
+export type { AppLayoutShellProps } from "./AppLayoutShell";
+export { BottomActionsProvider, useBottomActionsContext, } from "./BottomActionsContext";
+export type { BottomAction, BottomBulkConfig, BottomActionsState, } from "./BottomActionsContext";
+export { useBottomActions } from "./hooks/useBottomActions";
+export type { UseBottomActionsOptions } from "./hooks/useBottomActions";
+export { default as BottomActions } from "./BottomActions";
+export { BottomNavbar } from "./BottomNavbar";
+export type { BottomNavbarProps } from "./BottomNavbar";
+export { MainNavbar } from "./MainNavbar";
+export type { MainNavbarProps, MainNavbarItem } from "./MainNavbar";
+export { TitleBar } from "./TitleBar";
+export type { TitleBarProps } from "./TitleBar";
+export { DashboardNavProvider, useDashboardNav } from "./DashboardNavContext";
+export type { DashboardNavState } from "./DashboardNavContext";

package/dist/features/layout/index.js

@@ -0,0 +1,24 @@
+// @mohasinac/feat-layout
+// Generic layout shell components for any Next.js project.
+export { NavbarLayout } from "./NavbarLayout";
+export { FooterLayout } from "./FooterLayout";
+export { SidebarLayout } from "./SidebarLayout";
+export { BottomNavLayout } from "./BottomNavLayout";
+export { BottomNavItem } from "./BottomNavItem";
+export { NavItem } from "./NavItem";
+export { BottomSheet } from "./BottomSheet";
+export { TitleBarLayout } from "./TitleBarLayout";
+export { AutoBreadcrumbs } from "./AutoBreadcrumbs";
+export { Breadcrumbs, BreadcrumbItem } from "./Breadcrumbs";
+export { LocaleSwitcher } from "./LocaleSwitcher";
+export { BackToTop, SkipToMain } from "./BackToTop";
+export { ListingLayout } from "./ListingLayout";
+export { LayoutClient } from "./LayoutClient";
+export { AppLayoutShell } from "./AppLayoutShell";
+export { BottomActionsProvider, useBottomActionsContext, } from "./BottomActionsContext";
+export { useBottomActions } from "./hooks/useBottomActions";
+export { default as BottomActions } from "./BottomActions";
+export { BottomNavbar } from "./BottomNavbar";
+export { MainNavbar } from "./MainNavbar";
+export { TitleBar } from "./TitleBar";
+export { DashboardNavProvider, useDashboardNav } from "./DashboardNavContext";

package/dist/features/loyalty/api/admin/loyalty/grant/route.d.ts

@@ -0,0 +1,12 @@
+/**
+ * feat-loyalty — POST /api/admin/loyalty/grant
+ *
+ * Admin endpoint to grant loyalty points.
+ *
+ * Consumer stub:
+ * ```ts
+ * export { adminLoyaltyGrantPOST as POST } from "@mohasinac/feat-loyalty";
+ * ```
+ */
+import { NextResponse } from "next/server.js";
+export declare function POST(request: Request): Promise<NextResponse>;

package/dist/features/loyalty/api/admin/loyalty/grant/route.js

@@ -0,0 +1,36 @@
+/**
+ * feat-loyalty — POST /api/admin/loyalty/grant
+ *
+ * Admin endpoint to grant loyalty points.
+ *
+ * Consumer stub:
+ * ```ts
+ * export { adminLoyaltyGrantPOST as POST } from "@mohasinac/feat-loyalty";
+ * ```
+ */
+import { NextResponse } from "next/server.js";
+import { getProviders } from "../../../../../../contracts";
+export async function POST(request) {
+    try {
+        const body = await request.json();
+        const { db } = getProviders();
+        if (!db)
+            return NextResponse.json({ success: false, error: "DB not configured" }, { status: 503 });
+        const repo = db.getRepository("loyalty_transactions");
+        const created = await repo.create({
+            ...body,
+            type: "admin_grant",
+            createdAt: new Date(),
+        });
+        return NextResponse.json({
+            success: true,
+            data: created,
+        }, { status: 201 });
+    }
+    catch (error) {
+        return NextResponse.json({
+            success: false,
+            error: error instanceof Error ? error.message : "Internal server error",
+        }, { status: 500 });
+    }
+}

package/dist/features/loyalty/api/balance/route.d.ts

@@ -0,0 +1,12 @@
+/**
+ * feat-loyalty — GET /api/loyalty/balance
+ *
+ * User loyalty points balance.
+ *
+ * Consumer stub:
+ * ```ts
+ * export { loyaltyBalanceGET as GET } from "@mohasinac/feat-loyalty";
+ * ```
+ */
+import { NextResponse } from "next/server.js";
+export declare function GET(request: Request): Promise<NextResponse>;

package/dist/features/loyalty/api/balance/route.js

@@ -0,0 +1,39 @@
+/**
+ * feat-loyalty — GET /api/loyalty/balance
+ *
+ * User loyalty points balance.
+ *
+ * Consumer stub:
+ * ```ts
+ * export { loyaltyBalanceGET as GET } from "@mohasinac/feat-loyalty";
+ * ```
+ */
+import { NextResponse } from "next/server.js";
+import { getProviders } from "../../../../contracts";
+export async function GET(request) {
+    try {
+        const url = new URL(request.url);
+        const userId = url.searchParams.get("userId");
+        if (!userId) {
+            return NextResponse.json({ success: false, error: "User ID required" }, { status: 400 });
+        }
+        const { db } = getProviders();
+        if (!db)
+            return NextResponse.json({ success: false, error: "DB not configured" }, { status: 503 });
+        const repo = db.getRepository("loyalty_balance");
+        const result = await repo.findAll({
+            filters: `userId==${userId}`,
+            perPage: 1,
+        });
+        return NextResponse.json({
+            success: true,
+            data: result.data[0] ?? { userId, balance: 0 },
+        });
+    }
+    catch (error) {
+        return NextResponse.json({
+            success: false,
+            error: error instanceof Error ? error.message : "Internal server error",
+        }, { status: 500 });
+    }
+}

package/dist/features/loyalty/api/earn/route.d.ts

@@ -0,0 +1,12 @@
+/**
+ * feat-loyalty — POST /api/loyalty/earn
+ *
+ * Record loyalty points earned on transactions.
+ *
+ * Consumer stub:
+ * ```ts
+ * export { loyaltyEarnPOST as POST } from "@mohasinac/feat-loyalty";
+ * ```
+ */
+import { NextResponse } from "next/server.js";
+export declare function POST(request: Request): Promise<NextResponse>;

package/dist/features/loyalty/api/earn/route.js

@@ -0,0 +1,36 @@
+/**
+ * feat-loyalty — POST /api/loyalty/earn
+ *
+ * Record loyalty points earned on transactions.
+ *
+ * Consumer stub:
+ * ```ts
+ * export { loyaltyEarnPOST as POST } from "@mohasinac/feat-loyalty";
+ * ```
+ */
+import { NextResponse } from "next/server.js";
+import { getProviders } from "../../../../contracts";
+export async function POST(request) {
+    try {
+        const body = await request.json();
+        const { db } = getProviders();
+        if (!db)
+            return NextResponse.json({ success: false, error: "DB not configured" }, { status: 503 });
+        const repo = db.getRepository("loyalty_transactions");
+        const created = await repo.create({
+            ...body,
+            type: "earn",
+            createdAt: new Date(),
+        });
+        return NextResponse.json({
+            success: true,
+            data: created,
+        }, { status: 201 });
+    }
+    catch (error) {
+        return NextResponse.json({
+            success: false,
+            error: error instanceof Error ? error.message : "Internal server error",
+        }, { status: 500 });
+    }
+}

package/dist/features/loyalty/api/history/route.d.ts

@@ -0,0 +1,12 @@
+/**
+ * feat-loyalty — GET /api/loyalty/history
+ *
+ * User loyalty transaction history.
+ *
+ * Consumer stub:
+ * ```ts
+ * export { loyaltyHistoryGET as GET } from "@mohasinac/feat-loyalty";
+ * ```
+ */
+import { NextResponse } from "next/server.js";
+export declare function GET(request: Request): Promise<NextResponse>;

package/dist/features/loyalty/api/history/route.js

@@ -0,0 +1,56 @@
+/**
+ * feat-loyalty — GET /api/loyalty/history
+ *
+ * User loyalty transaction history.
+ *
+ * Consumer stub:
+ * ```ts
+ * export { loyaltyHistoryGET as GET } from "@mohasinac/feat-loyalty";
+ * ```
+ */
+import { NextResponse } from "next/server.js";
+import { getProviders } from "../../../../contracts";
+function numParam(url, key, fallback) {
+    const v = url.searchParams.get(key);
+    const n = v !== null ? Number(v) : NaN;
+    return Number.isFinite(n) ? n : fallback;
+}
+export async function GET(request) {
+    try {
+        const url = new URL(request.url);
+        const userId = url.searchParams.get("userId");
+        const page = Math.max(1, numParam(url, "page", 1));
+        const pageSize = Math.min(100, Math.max(1, numParam(url, "pageSize", 20)));
+        if (!userId) {
+            return NextResponse.json({ success: false, error: "User ID required" }, { status: 400 });
+        }
+        const { db } = getProviders();
+        if (!db)
+            return NextResponse.json({ success: false, error: "DB not configured" }, { status: 503 });
+        const repo = db.getRepository("loyalty_transactions");
+        const result = await repo.findAll({
+            filters: `userId==${userId}`,
+            sort: "-createdAt",
+            page,
+            perPage: pageSize,
+        });
+        const totalPages = Math.max(1, Math.ceil(result.total / pageSize));
+        return NextResponse.json({
+            success: true,
+            data: {
+                items: result.data,
+                total: result.total,
+                page,
+                pageSize,
+                totalPages,
+                hasMore: page < totalPages,
+            },
+        });
+    }
+    catch (error) {
+        return NextResponse.json({
+            success: false,
+            error: error instanceof Error ? error.message : "Internal server error",
+        }, { status: 500 });
+    }
+}

package/dist/features/loyalty/api/redeem/route.d.ts

@@ -0,0 +1,12 @@
+/**
+ * feat-loyalty — POST /api/loyalty/redeem
+ *
+ * Redeem loyalty points for rewards.
+ *
+ * Consumer stub:
+ * ```ts
+ * export { loyaltyRedeemPOST as POST } from "@mohasinac/feat-loyalty";
+ * ```
+ */
+import { NextResponse } from "next/server.js";
+export declare function POST(request: Request): Promise<NextResponse>;

package/dist/features/loyalty/api/redeem/route.js

@@ -0,0 +1,36 @@
+/**
+ * feat-loyalty — POST /api/loyalty/redeem
+ *
+ * Redeem loyalty points for rewards.
+ *
+ * Consumer stub:
+ * ```ts
+ * export { loyaltyRedeemPOST as POST } from "@mohasinac/feat-loyalty";
+ * ```
+ */
+import { NextResponse } from "next/server.js";
+import { getProviders } from "../../../../contracts";
+export async function POST(request) {
+    try {
+        const body = await request.json();
+        const { db } = getProviders();
+        if (!db)
+            return NextResponse.json({ success: false, error: "DB not configured" }, { status: 503 });
+        const repo = db.getRepository("loyalty_transactions");
+        const created = await repo.create({
+            ...body,
+            type: "redeem",
+            createdAt: new Date(),
+        });
+        return NextResponse.json({
+            success: true,
+            data: created,
+        }, { status: 201 });
+    }
+    catch (error) {
+        return NextResponse.json({
+            success: false,
+            error: error instanceof Error ? error.message : "Internal server error",
+        }, { status: 500 });
+    }
+}

package/dist/features/loyalty/columns/index.d.ts

@@ -0,0 +1,17 @@
+import type { TableColumn, ColumnExtensionOpts } from "../../../contracts";
+import type { LoyaltyBalance } from "../types";
+/**
+ * Default admin columns for loyalty balance records.
+ * Use `buildLoyaltyColumns()` to customise via overrides / extras / omit.
+ */
+export declare const loyaltyAdminColumns: TableColumn<LoyaltyBalance>[];
+/**
+ * Factory that returns columns for the loyalty admin table.
+ *
+ * @example
+ * const cols = buildLoyaltyColumns<MyLoyaltyBalance>({
+ *   extras: [{ key: "tier", header: "Tier", render: (l) => l.tier }],
+ *   omit: ["coinHistory"],
+ * });
+ */
+export declare function buildLoyaltyColumns<T extends LoyaltyBalance = LoyaltyBalance>(opts?: ColumnExtensionOpts<T>): TableColumn<T>[];

package/dist/features/loyalty/columns/index.js

@@ -0,0 +1,40 @@
+import { buildColumns } from "../../../ui/columns";
+/**
+ * Default admin columns for loyalty balance records.
+ * Use `buildLoyaltyColumns()` to customise via overrides / extras / omit.
+ */
+export const loyaltyAdminColumns = [
+    {
+        key: "uid",
+        header: "User ID",
+        sortable: false,
+    },
+    {
+        key: "hcCoins",
+        header: "Coins",
+        sortable: true,
+    },
+    {
+        key: "coinHistory",
+        header: "Last Transaction",
+        sortable: false,
+        render: (item) => {
+            if (!item.coinHistory?.length)
+                return "—";
+            const last = item.coinHistory[item.coinHistory.length - 1];
+            return last?.timestamp ?? "—";
+        },
+    },
+];
+/**
+ * Factory that returns columns for the loyalty admin table.
+ *
+ * @example
+ * const cols = buildLoyaltyColumns<MyLoyaltyBalance>({
+ *   extras: [{ key: "tier", header: "Tier", render: (l) => l.tier }],
+ *   omit: ["coinHistory"],
+ * });
+ */
+export function buildLoyaltyColumns(opts) {
+    return buildColumns(loyaltyAdminColumns, opts);
+}

package/dist/features/loyalty/components/CoinsDisplay.d.ts

@@ -0,0 +1,11 @@
+interface CoinsBadgeProps {
+    coins: number;
+    className?: string;
+}
+export declare function CoinsBadge({ coins, className }: CoinsBadgeProps): import("react/jsx-runtime").JSX.Element;
+interface CoinsDisplayProps {
+    coins: number;
+    label?: string;
+}
+export declare function CoinsDisplay({ coins, label }: CoinsDisplayProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/features/loyalty/components/CoinsDisplay.js

@@ -0,0 +1,8 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Div, Span, Text } from "../../../ui";
+export function CoinsBadge({ coins, className }) {
+    return (_jsxs(Span, { className: `inline-flex items-center gap-1 rounded-full bg-amber-100 px-2 py-0.5 text-xs font-semibold text-amber-800 ${className ?? ""}`, children: [_jsx(Span, { "aria-hidden": "true", children: "\uD83E\uDE99" }), coins.toLocaleString()] }));
+}
+export function CoinsDisplay({ coins, label = "HC Coins" }) {
+    return (_jsxs(Div, { className: "flex flex-col items-center gap-1", children: [_jsx(Text, { className: "text-3xl font-bold text-amber-600", children: coins.toLocaleString() }), _jsx(Text, { className: "text-sm text-gray-500", children: label })] }));
+}

package/dist/features/loyalty/components/index.d.ts

@@ -0,0 +1 @@
+export { CoinsBadge, CoinsDisplay } from "./CoinsDisplay";

package/dist/features/loyalty/components/index.js

@@ -0,0 +1 @@
+export { CoinsBadge, CoinsDisplay } from "./CoinsDisplay";

package/dist/features/loyalty/hooks/useLoyaltyBalance.d.ts

@@ -0,0 +1,4 @@
+import type { LoyaltyBalance } from "../types";
+export declare function useLoyaltyBalance(uid: string | undefined, opts?: {
+    endpoint?: string;
+}): import("@tanstack/react-query").UseQueryResult<LoyaltyBalance | null, Error>;

package/dist/features/loyalty/hooks/useLoyaltyBalance.js

@@ -0,0 +1,17 @@
+import { useQuery } from "@tanstack/react-query";
+import { LOYALTY_ENDPOINTS } from "../../../constants/api-endpoints";
+export function useLoyaltyBalance(uid, opts) {
+    return useQuery({
+        queryKey: ["loyalty", "balance", uid],
+        queryFn: async () => {
+            if (!uid)
+                return null;
+            const endpoint = opts?.endpoint ?? LOYALTY_ENDPOINTS.BALANCE(uid);
+            const res = await fetch(endpoint);
+            if (!res.ok)
+                return null;
+            return res.json();
+        },
+        enabled: !!uid,
+    });
+}

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

@@ -0,0 +1,6 @@
+export * from "./types";
+export * from "./schemas";
+export * from "./columns";
+export * from "./hooks/useLoyaltyBalance";
+export * from "./components";
+export { manifest } from "./manifest";

package/dist/features/loyalty/index.js

@@ -0,0 +1,6 @@
+export * from "./types";
+export * from "./schemas";
+export * from "./columns";
+export * from "./hooks/useLoyaltyBalance";
+export * from "./components";
+export { manifest } from "./manifest";

package/dist/features/loyalty/manifest.d.ts

@@ -0,0 +1,2 @@
+import type { FeatureManifest } from "../../contracts";
+export declare const manifest: FeatureManifest;

package/dist/features/loyalty/manifest.js

@@ -0,0 +1,16 @@
+export const manifest = {
+    name: "loyalty",
+    i18nNamespace: "loyalty",
+    envKeys: [],
+    routes: [
+        { segment: "[locale]/account/coins", exports: { default: "LoyaltyPageView" } },
+        { segment: "[locale]/admin/loyalty", exports: { default: "AdminLoyaltyView" }, adminOnly: true },
+    ],
+    apiRoutes: [
+        { segment: "api/loyalty/balance", methods: ["GET"] },
+        { segment: "api/loyalty/earn", methods: ["POST"] },
+        { segment: "api/loyalty/redeem", methods: ["POST"] },
+        { segment: "api/loyalty/history", methods: ["GET"] },
+        { segment: "api/admin/loyalty/grant", methods: ["POST"] },
+    ],
+};