@mohasinac/appkit 2.2.0 → 2.3.1

package/dist/features/account/components/NotificationBell.js

@@ -4,6 +4,7 @@ import { useCallback, useRef, useState } from "react";
 import { Button, Heading, Li, Row, Spinner, Span, Text, TextLink, Ul, } from "../../../ui";
 import { useClickOutside, useMessage } from "../../../react";
 import { formatRelativeTime } from "../../../utils";
+import { THEME_CONSTANTS } from "../../../tokens";
 import { useNotifications } from "../hooks/useNotifications";
 const DEFAULT_ICONS = {
     order_placed: "🛍️",
@@ -61,7 +62,7 @@ export function NotificationBell({ limit = 10, viewAllHref, labels, icons, rende
     ]);
     const renderActionLink = renderLink ??
         ((props) => (_jsx(TextLink, { href: props.href, onClick: props.onClick, className: props.className, children: props.children })));
-    return (_jsxs("div", { className: "relative", ref: dropdownRef, children: [_jsxs(Button, { onClick: handleToggle, className: `${hideOnMobile ? "hidden md:flex" : "flex"} p-2.5 md:p-3 rounded-xl transition-colors relative text-zinc-600 hover:bg-zinc-100 hover:text-zinc-900 dark:text-zinc-300 dark:hover:bg-slate-800 dark:hover:text-white ${buttonClassName}`, "aria-label": labels.title, "aria-expanded": isOpen, children: [_jsx("svg", { className: "w-6 h-6 md:w-7 md:h-7", fill: "none", stroke: "currentColor", viewBox: "0 0 24 24", "aria-hidden": "true", children: _jsx("path", { strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: 2, d: "M15 17h5l-1.405-1.405A2.032 2.032 0 0118 14.158V11a6.002 6.002 0 00-4-5.659V5a2 2 0 10-4 0v.341C7.67 6.165 6 8.388 6 11v3.159c0 .538-.214 1.055-.595 1.436L4 17h5m6 0v1a3 3 0 11-6 0v-1m6 0H9" }) }), unreadCount > 0 && (_jsx(Span, { className: "absolute -top-1 -right-1 bg-red-500 text-white text-xs min-w-[20px] h-5 px-1.5 flex items-center justify-center rounded-full font-semibold shadow-md", children: unreadCount > 99 ? "99+" : unreadCount }))] }), isOpen && (_jsxs("div", { className: `absolute right-0 top-full mt-2 w-80 sm:w-96 rounded-xl shadow-2xl border border-zinc-200 bg-white dark:border-slate-800 dark:bg-slate-950 z-50 overflow-hidden ${dropdownClassName}`, children: [_jsxs(Row, { justify: "between", gap: "none", className: "px-4 py-3 border-b border-zinc-200 dark:border-slate-800", children: [_jsxs(Heading, { level: 3, className: "font-semibold text-zinc-900 dark:text-white", children: [labels.title, unreadCount > 0 && (_jsxs(Span, { className: "ml-2 text-xs bg-red-100 text-red-700 dark:bg-red-900/30 dark:text-red-400 px-2 py-0.5 rounded-full font-medium", children: [unreadCount, " ", labels.unread] }))] }), unreadCount > 0 && (_jsx(Button, { onClick: handleMarkAllRead, disabled: isMarkingAll, className: "text-xs text-primary hover:underline font-medium disabled:opacity-50", children: isMarkingAll ? labels.loading : labels.markAllRead }))] }), _jsx("div", { className: "max-h-96 overflow-y-auto", children: isLoading ? (_jsx("div", { className: "flex items-center justify-center py-10", children: _jsx(Spinner, { size: "md" }) })) : notifications.length === 0 ? (_jsxs("div", { className: "flex flex-col items-center justify-center py-10 px-4 text-center", children: [_jsx("svg", { className: "w-12 h-12 text-zinc-300 dark:text-zinc-600 mb-3", fill: "none", stroke: "currentColor", viewBox: "0 0 24 24", children: _jsx("path", { strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: 1.5, d: "M15 17h5l-1.405-1.405A2.032 2.032 0 0118 14.158V11a6.002 6.002 0 00-4-5.659V5a2 2 0 10-4 0v.341C7.67 6.165 6 8.388 6 11v3.159c0 .538-.214 1.055-.595 1.436L4 17h5m6 0v1a3 3 0 11-6 0v-1m6 0H9" }) }), _jsx(Text, { className: "font-medium text-zinc-900 dark:text-white", children: labels.empty }), _jsx(Text, { size: "sm", className: "mt-1 text-zinc-500 dark:text-zinc-400", children: labels.emptyDesc })] })) : (_jsx(Ul, { children: notifications.map((notification) => (_jsxs(Li, { className: `group flex items-start gap-3 px-4 py-3 border-b border-zinc-200 dark:border-slate-800 last:border-0 transition-colors hover:bg-zinc-50 dark:hover:bg-slate-900 ${!notification.isRead ? "bg-primary/5 dark:bg-primary/10" : ""}`, children: [_jsx(Span, { className: "text-xl flex-shrink-0 mt-0.5", children: notificationIcons[notification.type] ?? "🔔" }), _jsxs("div", { className: "flex-1 min-w-0", children: [_jsxs("div", { className: "flex items-start justify-between gap-2", children: [_jsxs(Text, { size: "sm", className: "font-medium text-zinc-900 dark:text-white leading-tight", children: [notification.title, !notification.isRead && (_jsx(Span, { className: "ml-1.5 inline-block w-2 h-2 rounded-full bg-primary flex-shrink-0 align-middle" }))] }), _jsx(Span, { className: "text-xs text-zinc-500 dark:text-zinc-400 flex-shrink-0", children: formatRelativeTime(notification.createdAt) })] }), _jsx(Text, { size: "sm", className: "text-zinc-600 dark:text-zinc-300 mt-0.5 line-clamp-2", children: notification.message }), _jsxs(Row, { gap: "3", className: "mt-1.5", children: [notification.actionUrl &&
+    return (_jsxs("div", { className: "relative", ref: dropdownRef, "data-section": "notificationbell-div-227", children: [_jsxs(Button, { onClick: handleToggle, className: `${hideOnMobile ? "hidden md:flex" : "flex"} p-2.5 md:p-3 rounded-xl transition-colors relative text-zinc-600 hover:bg-zinc-100 hover:text-zinc-900 dark:text-zinc-300 dark:hover:bg-slate-800 dark:hover:text-white ${buttonClassName}`, "aria-label": labels.title, "aria-expanded": isOpen, children: [_jsx("svg", { className: "w-6 h-6 md:w-7 md:h-7", fill: "none", stroke: "currentColor", viewBox: "0 0 24 24", "aria-hidden": "true", children: _jsx("path", { strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: 2, d: "M15 17h5l-1.405-1.405A2.032 2.032 0 0118 14.158V11a6.002 6.002 0 00-4-5.659V5a2 2 0 10-4 0v.341C7.67 6.165 6 8.388 6 11v3.159c0 .538-.214 1.055-.595 1.436L4 17h5m6 0v1a3 3 0 11-6 0v-1m6 0H9" }) }), unreadCount > 0 && (_jsx(Span, { className: "absolute -top-1 -right-1 bg-red-500 text-white text-xs min-w-[20px] h-5 px-1.5 flex items-center justify-center rounded-full font-semibold shadow-md", children: unreadCount > 99 ? "99+" : unreadCount }))] }), isOpen && (_jsxs("div", { className: `absolute right-0 top-full mt-2 w-80 sm:w-96 rounded-xl shadow-2xl border border-zinc-200 bg-white dark:border-slate-800 dark:bg-slate-950 z-50 overflow-hidden ${dropdownClassName}`, "data-section": "notificationbell-div-228", children: [_jsxs(Row, { justify: "between", gap: "none", className: "px-4 py-3 border-b border-zinc-200 dark:border-slate-800", children: [_jsxs(Heading, { level: 3, className: "font-semibold text-zinc-900 dark:text-white", children: [labels.title, unreadCount > 0 && (_jsxs(Span, { className: "ml-2 text-xs bg-red-100 text-red-700 dark:bg-red-900/30 dark:text-red-400 px-2 py-0.5 rounded-full font-medium", children: [unreadCount, " ", labels.unread] }))] }), unreadCount > 0 && (_jsx(Button, { onClick: handleMarkAllRead, disabled: isMarkingAll, className: "text-xs text-primary hover:underline font-medium disabled:opacity-50", children: isMarkingAll ? labels.loading : labels.markAllRead }))] }), _jsx("div", { className: "max-h-96 overflow-y-auto", "data-section": "notificationbell-div-229", children: isLoading ? (_jsx("div", { className: "flex items-center justify-center py-10", "data-section": "notificationbell-div-230", children: _jsx(Spinner, { size: "md" }) })) : notifications.length === 0 ? (_jsxs("div", { className: "flex flex-col items-center justify-center py-10 px-4 text-center", "data-section": "notificationbell-div-231", children: [_jsx("svg", { className: "w-12 h-12 text-zinc-300 dark:text-zinc-600 mb-3", fill: "none", stroke: "currentColor", viewBox: "0 0 24 24", children: _jsx("path", { strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: 1.5, d: "M15 17h5l-1.405-1.405A2.032 2.032 0 0118 14.158V11a6.002 6.002 0 00-4-5.659V5a2 2 0 10-4 0v.341C7.67 6.165 6 8.388 6 11v3.159c0 .538-.214 1.055-.595 1.436L4 17h5m6 0v1a3 3 0 11-6 0v-1m6 0H9" }) }), _jsx(Text, { className: "font-medium text-zinc-900 dark:text-white", children: labels.empty }), _jsx(Text, { size: "sm", className: "mt-1 text-zinc-500 dark:text-zinc-400", children: labels.emptyDesc })] })) : (_jsx(Ul, { children: notifications.map((notification) => (_jsxs(Li, { className: `group flex items-start gap-3 px-4 py-3 border-b border-zinc-200 dark:border-slate-800 last:border-0 transition-colors hover:bg-zinc-50 dark:hover:bg-slate-900 ${!notification.isRead ? "bg-primary/5 dark:bg-primary/10" : ""}`, children: [_jsx(Span, { className: "text-xl flex-shrink-0 mt-0.5", children: notificationIcons[notification.type] ?? "🔔" }), _jsxs("div", { className: "flex-1 min-w-0", "data-section": "notificationbell-div-232", children: [_jsxs("div", { className: `flex items-start justify-between ${THEME_CONSTANTS.spacing.gap.xs}`, "data-section": "notificationbell-div-233", children: [_jsxs(Text, { size: "sm", className: "font-medium text-zinc-900 dark:text-white leading-tight", children: [notification.title, !notification.isRead && (_jsx(Span, { className: "ml-1.5 inline-block w-2 h-2 rounded-full bg-primary flex-shrink-0 align-middle" }))] }), _jsx(Span, { className: "text-xs text-zinc-500 dark:text-zinc-400 flex-shrink-0", children: formatRelativeTime(notification.createdAt) })] }), _jsx(Text, { size: "sm", className: `text-zinc-600 dark:text-zinc-300 mt-0.5 ${THEME_CONSTANTS.utilities.textClamp2}`, children: notification.message }), _jsxs(Row, { gap: "3", className: "mt-1.5", children: [notification.actionUrl &&
                                                         renderActionLink({
                                                             href: notification.actionUrl,
                                                             onClick: () => {
@@ -71,7 +72,7 @@ export function NotificationBell({ limit = 10, viewAllHref, labels, icons, rende
                                                             },
                                                             className: "text-xs text-primary hover:underline font-medium",
                                                             children: notification.actionLabel ?? labels.viewAction,
-                                                        }), !notification.isRead && (_jsx(Button, { variant: "ghost", onClick: () => void handleMarkRead(notification.id), className: "text-xs text-zinc-500 dark:text-zinc-400 hover:text-zinc-700 dark:hover:text-zinc-200 hover:underline p-0 h-auto", children: labels.markRead }))] })] })] }, notification.id))) })) }), viewAllHref && (_jsx("div", { className: "px-4 py-3 border-t border-zinc-200 dark:border-slate-800 text-center", children: renderActionLink({
+                                                        }), !notification.isRead && (_jsx(Button, { variant: "ghost", onClick: () => void handleMarkRead(notification.id), className: "text-xs text-zinc-500 dark:text-zinc-400 hover:text-zinc-700 dark:hover:text-zinc-200 hover:underline p-0 h-auto", children: labels.markRead }))] })] })] }, notification.id))) })) }), viewAllHref && (_jsx("div", { className: "px-4 py-3 border-t border-zinc-200 dark:border-slate-800 text-center", "data-section": "notificationbell-div-234", children: renderActionLink({
                             href: viewAllHref,
                             onClick: () => setIsOpen(false),
                             className: "text-sm text-primary hover:underline font-medium",

package/dist/features/account/components/UserSidebar.d.ts

@@ -0,0 +1,15 @@
+import React from "react";
+export interface UserNavItem {
+    href: string;
+    label: string;
+    icon?: React.ReactNode;
+}
+export interface UserSidebarProps {
+    items: UserNavItem[];
+    /** Whether the mobile drawer is open */
+    mobileOpen?: boolean;
+    /** Called when the mobile drawer should close */
+    onCloseMobile?: () => void;
+    className?: string;
+}
+export declare function UserSidebar({ items, mobileOpen, onCloseMobile, className, }: UserSidebarProps): import("react/jsx-runtime").JSX.Element;

package/dist/features/account/components/UserSidebar.js

@@ -0,0 +1,18 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import Link from "next/link";
+import { usePathname } from "next/navigation";
+import { Aside, Li, Nav, Span, Ul } from "../../../ui";
+import { BottomSheet } from "../../layout/BottomSheet";
+function SidebarContent({ items, activeHref, onItemClick, }) {
+    return (_jsx(Nav, { "aria-label": "User navigation", className: "flex-1 overflow-y-auto py-3", children: _jsx(Ul, { className: "space-y-0.5 px-2", children: items.map((item) => {
+                const isActive = activeHref === item.href || activeHref.startsWith(item.href + "/");
+                return (_jsx(Li, { children: _jsxs(Link, { href: item.href, onClick: onItemClick, className: `flex items-center gap-3 rounded-lg px-3 py-2 text-sm transition-colors ${isActive
+                            ? "bg-primary-50 dark:bg-primary-900/20 text-primary-600 dark:text-primary-400 font-medium"
+                            : "text-zinc-600 dark:text-zinc-300 hover:bg-zinc-50 dark:hover:bg-slate-800 hover:text-zinc-900 dark:hover:text-zinc-100"}`, children: [item.icon && (_jsx(Span, { className: "shrink-0 text-[1.1rem]", children: item.icon })), _jsx(Span, { className: "flex-1 truncate", children: item.label })] }) }, item.href));
+            }) }) }));
+}
+export function UserSidebar({ items, mobileOpen = false, onCloseMobile, className = "", }) {
+    const pathname = usePathname();
+    return (_jsxs(_Fragment, { children: [_jsx(Aside, { className: `hidden md:flex w-56 shrink-0 flex-col bg-white dark:bg-slate-900 border-r border-zinc-200 dark:border-slate-700 ${className}`, children: _jsx(SidebarContent, { items: items, activeHref: pathname }) }), _jsx(BottomSheet, { open: mobileOpen, onClose: onCloseMobile ?? (() => { }), title: "My Account", children: _jsx(SidebarContent, { items: items, activeHref: pathname, onItemClick: onCloseMobile }) })] }));
+}

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

@@ -1,3 +1,5 @@
+export { UserSidebar } from "./UserSidebar";
+export type { UserSidebarProps, UserNavItem } from "./UserSidebar";
 export { AddressCard, AddressBook } from "./AddressBook";
 export type { AddressCardAddress, AddressCardProps } from "./AddressBook";
 export { AddressForm } from "./AddressForm";

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

@@ -1,3 +1,4 @@
+export { UserSidebar } from "./UserSidebar";
 export { AddressCard, AddressBook } from "./AddressBook";
 export { AddressForm } from "./AddressForm";
 export { AddressSelectorCreate } from "./AddressSelectorCreate";

package/dist/features/account/hooks/useAccount.js

@@ -1,4 +1,3 @@
-"use client";
 import { useQuery } from "@tanstack/react-query";
 import { apiClient } from "../../../http";
 import { ACCOUNT_ENDPOINTS } from "../../../constants/api-endpoints";

package/dist/features/account/hooks/useAddressSelector.js

@@ -1,4 +1,3 @@
-"use client";
 import { useMutation, useQuery } from "@tanstack/react-query";
 import { apiClient } from "../../../http";
 import { ACCOUNT_ENDPOINTS } from "../../../constants/api-endpoints";

package/dist/features/account/hooks/useAddresses.js

@@ -1,4 +1,3 @@
-"use client";
 import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
 import { apiClient } from "../../../http";
 import { ACCOUNT_ENDPOINTS } from "../../../constants/api-endpoints";

package/dist/features/account/hooks/useNotifications.js

@@ -1,4 +1,3 @@
-"use client";
 import { useMutation, useQuery } from "@tanstack/react-query";
 import { apiClient } from "../../../http";
 import { NOTIFICATIONS_ENDPOINTS } from "../../../constants/api-endpoints";

package/dist/features/account/hooks/useProfile.js

@@ -1,4 +1,3 @@
-"use client";
 import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
 import { apiClient } from "../../../http";
 import { ACCOUNT_ENDPOINTS } from "../../../constants/api-endpoints";

package/dist/features/account/hooks/useProfileStats.js

@@ -1,4 +1,3 @@
-"use client";
 import { useQuery } from "@tanstack/react-query";
 import { apiClient } from "../../../http";
 import { ACCOUNT_ENDPOINTS } from "../../../constants/api-endpoints";

package/dist/features/account/hooks/usePublicProfile.js

@@ -1,4 +1,3 @@
-"use client";
 import { useQuery } from "@tanstack/react-query";
 import { hasRole } from "../../auth/auth-helpers";
 import { apiClient } from "../../../http";

package/dist/features/account/repository/address.repository.js

@@ -1,6 +1,6 @@
 import { DatabaseError, NotFoundError } from "../../../errors";
 import { serverLogger } from "../../../monitoring";
-import { deserializeTimestamps, getAdminDb, prepareForFirestore, } from "../../../providers/db-firebase";
+import { deserializeTimestamps, getFirestoreCount, getAdminDb, prepareForFirestore, } from "../../../providers/db-firebase";
 import { ADDRESS_PII_FIELDS, decryptPiiFields, encryptPiiFields, } from "../../../security";
 import { USER_COLLECTION } from "../../auth";
 import { ADDRESS_FIELDS, ADDRESS_SUBCOLLECTION, } from "../schemas";
@@ -53,8 +53,7 @@ export class AddressRepository {
     }
     async count(userId) {
         try {
-            const snapshot = await this.getCollection(userId).count().get();
-            return snapshot.data().count;
+            return await getFirestoreCount(this.getCollection(userId));
         }
         catch (error) {
             throw new DatabaseError(`Failed to count addresses for user: ${userId}`, error);

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

@@ -13,8 +13,8 @@ export declare const userAddressSchema: z.ZodObject<{
     phone: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     id: string;
-    country: string;
     state: string;
+    country: string;
     city: string;
     postalCode: string;
     line1: string;
@@ -24,8 +24,8 @@ export declare const userAddressSchema: z.ZodObject<{
     line2?: string | undefined;
 }, {
     id: string;
-    country: string;
     state: string;
+    country: string;
     city: string;
     postalCode: string;
     line1: string;
@@ -43,14 +43,14 @@ export declare const notificationPreferencesSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     push?: boolean | undefined;
     promotions?: boolean | undefined;
-    orderUpdates?: boolean | undefined;
     newsletter?: boolean | undefined;
+    orderUpdates?: boolean | undefined;
     sms?: boolean | undefined;
 }, {
     push?: boolean | undefined;
     promotions?: boolean | undefined;
-    orderUpdates?: boolean | undefined;
     newsletter?: boolean | undefined;
+    orderUpdates?: boolean | undefined;
     sms?: boolean | undefined;
 }>;
 /**
@@ -84,8 +84,8 @@ export declare const userProfileSchema: z.ZodObject<{
         phone: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         id: string;
-        country: string;
         state: string;
+        country: string;
         city: string;
         postalCode: string;
         line1: string;
@@ -95,8 +95,8 @@ export declare const userProfileSchema: z.ZodObject<{
         line2?: string | undefined;
     }, {
         id: string;
-        country: string;
         state: string;
+        country: string;
         city: string;
         postalCode: string;
         line1: string;
@@ -114,27 +114,26 @@ export declare const userProfileSchema: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         push?: boolean | undefined;
         promotions?: boolean | undefined;
-        orderUpdates?: boolean | undefined;
         newsletter?: boolean | undefined;
+        orderUpdates?: boolean | undefined;
         sms?: boolean | undefined;
     }, {
         push?: boolean | undefined;
         promotions?: boolean | undefined;
-        orderUpdates?: boolean | undefined;
         newsletter?: boolean | undefined;
+        orderUpdates?: boolean | undefined;
         sms?: boolean | undefined;
     }>>;
     createdAt: z.ZodOptional<z.ZodString>;
     updatedAt: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     id: string;
-    createdAt?: string | undefined;
-    updatedAt?: string | undefined;
+    email?: string | undefined;
     displayName?: string | undefined;
     addresses?: {
         id: string;
-        country: string;
         state: string;
+        country: string;
         city: string;
         postalCode: string;
         line1: string;
@@ -143,26 +142,26 @@ export declare const userProfileSchema: z.ZodObject<{
         isDefault?: boolean | undefined;
         line2?: string | undefined;
     }[] | undefined;
-    email?: string | undefined;
-    phone?: string | undefined;
     photoURL?: string | undefined;
+    createdAt?: string | undefined;
+    updatedAt?: string | undefined;
+    phone?: string | undefined;
     bio?: string | undefined;
     notificationPreferences?: {
         push?: boolean | undefined;
         promotions?: boolean | undefined;
-        orderUpdates?: boolean | undefined;
         newsletter?: boolean | undefined;
+        orderUpdates?: boolean | undefined;
         sms?: boolean | undefined;
     } | undefined;
 }, {
     id: string;
-    createdAt?: string | undefined;
-    updatedAt?: string | undefined;
+    email?: string | undefined;
     displayName?: string | undefined;
     addresses?: {
         id: string;
-        country: string;
         state: string;
+        country: string;
         city: string;
         postalCode: string;
         line1: string;
@@ -171,15 +170,16 @@ export declare const userProfileSchema: z.ZodObject<{
         isDefault?: boolean | undefined;
         line2?: string | undefined;
     }[] | undefined;
-    email?: string | undefined;
-    phone?: string | undefined;
     photoURL?: string | undefined;
+    createdAt?: string | undefined;
+    updatedAt?: string | undefined;
+    phone?: string | undefined;
     bio?: string | undefined;
     notificationPreferences?: {
         push?: boolean | undefined;
         promotions?: boolean | undefined;
-        orderUpdates?: boolean | undefined;
         newsletter?: boolean | undefined;
+        orderUpdates?: boolean | undefined;
         sms?: boolean | undefined;
     } | undefined;
 }>;

package/dist/features/account/schemas/index.js

@@ -1,6 +1,6 @@
 export * from "./firestore";
 import { z } from "zod";
-// ─── Sub-schemas ──────────────────────────────────────────────────────────────
+// --- Sub-schemas --------------------------------------------------------------
 export const userAddressSchema = z.object({
     id: z.string(),
     label: z.string().optional(),
@@ -20,7 +20,7 @@ export const notificationPreferencesSchema = z.object({
     sms: z.boolean().optional(),
     push: z.boolean().optional(),
 });
-// ─── Base profile schema ──────────────────────────────────────────────────────
+// --- Base profile schema ------------------------------------------------------
 /**
  * Base Zod schema for a user profile.
  * Apps can extend this to add their own fields:

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

@@ -3,7 +3,6 @@
  *
  * Server-only entry point for account repositories.
  */
-import "server-only";
 export * from "./actions";
 export { AccountRepository } from "./repository/account.repository";
 export { AddressRepository, addressRepository, } from "./repository/address.repository";

package/dist/features/account/server.js

@@ -3,7 +3,6 @@
  *
  * Server-only entry point for account repositories.
  */
-import "server-only";
 export * from "./actions";
 export { AccountRepository } from "./repository/account.repository";
 export { AddressRepository, addressRepository, } from "./repository/address.repository";

package/dist/features/account/types/index.js

@@ -1,2 +1,2 @@
-// ─── Order types ─────────────────────────────────────────────────────────────
+// --- Order types -------------------------------------------------------------
 export {};

package/dist/features/admin/components/AdminAdEditorView.d.ts

@@ -0,0 +1,10 @@
+import type { StackedViewShellProps } from "../../../ui";
+export interface AdminAdEditorViewProps extends Omit<StackedViewShellProps, "sections"> {
+    adId?: string;
+    endpointBase?: string;
+    labels?: {
+        title?: string;
+    };
+    onSaved?: (id: string) => void;
+}
+export declare function AdminAdEditorView({ adId, endpointBase, labels, onSaved, ...rest }: AdminAdEditorViewProps): import("react/jsx-runtime").JSX.Element;

package/dist/features/admin/components/AdminAdEditorView.js

@@ -0,0 +1,225 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import React from "react";
+import { useMutation, useQuery } from "@tanstack/react-query";
+import { Alert, Button, Form, FormActions, Input, Select, StackedViewShell, Text, Toggle, } from "../../../ui";
+import { apiClient } from "../../../http";
+import { ADMIN_ENDPOINTS } from "../../../constants/api-endpoints";
+export function AdminAdEditorView({ adId, endpointBase = ADMIN_ENDPOINTS.ADS, labels = {}, onSaved, ...rest }) {
+    const [name, setName] = React.useState("");
+    const [provider, setProvider] = React.useState("manual");
+    const [status, setStatus] = React.useState("draft");
+    const [priority, setPriority] = React.useState(0);
+    const [requiresConsent, setRequiresConsent] = React.useState(false);
+    const [selectedPlacements, setSelectedPlacements] = React.useState([]);
+    const [startAt, setStartAt] = React.useState("");
+    const [endAt, setEndAt] = React.useState("");
+    const [title, setTitle] = React.useState("");
+    const [body, setBody] = React.useState("");
+    const [imageUrl, setImageUrl] = React.useState("");
+    const [ctaLabel, setCtaLabel] = React.useState("");
+    const [ctaHref, setCtaHref] = React.useState("");
+    const [adsenseSlot, setAdsenseSlot] = React.useState("");
+    const [thirdPartyUrl, setThirdPartyUrl] = React.useState("");
+    const [saveMessage, setSaveMessage] = React.useState(null);
+    const metaQuery = useQuery({
+        queryKey: ["admin-ads-editor-meta", endpointBase],
+        queryFn: () => apiClient.get(endpointBase),
+        staleTime: 15000,
+    });
+    const adQuery = useQuery({
+        queryKey: ["admin-ad-by-id", adId],
+        queryFn: () => apiClient.get(ADMIN_ENDPOINTS.AD_BY_ID(adId)),
+        enabled: Boolean(adId),
+        staleTime: 15000,
+    });
+    React.useEffect(() => {
+        if (!adQuery.data?.item)
+            return;
+        const item = adQuery.data.item;
+        setName(item.name || "");
+        setProvider(item.provider || "manual");
+        setStatus(item.status || "draft");
+        setPriority(item.priority ?? 0);
+        setRequiresConsent(Boolean(item.requiresConsent));
+        setSelectedPlacements(item.placementIds ?? []);
+        setStartAt(item.startAt || "");
+        setEndAt(item.endAt || "");
+        setTitle(item.creative?.title || "");
+        setBody(item.creative?.body || "");
+        setImageUrl(item.creative?.imageUrl || "");
+        setCtaLabel(item.creative?.ctaLabel || "");
+        setCtaHref(item.creative?.ctaHref || "");
+        setAdsenseSlot(item.creative?.adsenseSlot || "");
+        setThirdPartyUrl(item.creative?.thirdPartyUrl || "");
+    }, [adQuery.data]);
+    const saveMutation = useMutation({
+        mutationFn: async () => {
+            const payload = {
+                name,
+                provider,
+                status,
+                priority,
+                requiresConsent,
+                placementIds: selectedPlacements,
+                startAt: startAt || undefined,
+                endAt: endAt || undefined,
+                creative: {
+                    title: title || undefined,
+                    body: body || undefined,
+                    imageUrl: imageUrl || undefined,
+                    ctaLabel: ctaLabel || undefined,
+                    ctaHref: ctaHref || undefined,
+                    adsenseSlot: adsenseSlot || undefined,
+                    thirdPartyUrl: thirdPartyUrl || undefined,
+                },
+            };
+            if (adId) {
+                await apiClient.patch(ADMIN_ENDPOINTS.AD_BY_ID(adId), payload);
+                return adId;
+            }
+            const created = await apiClient.post(endpointBase, payload);
+            return created.id;
+        },
+        onSuccess: (savedId) => {
+            setSaveMessage("Saved successfully.");
+            if (savedId) {
+                onSaved?.(savedId);
+            }
+        },
+        onError: (error) => {
+            setSaveMessage(error instanceof Error ? error.message : "Save failed");
+        },
+    });
+    const placements = adQuery.data?.placements ?? metaQuery.data?.placements ?? [];
+    const providerCredentialStatus = metaQuery.data?.providerCredentialStatus;
+    const publishIssues = React.useMemo(() => {
+        const issues = [];
+        const now = Date.now();
+        if (!name.trim()) {
+            issues.push("Ad name is required");
+        }
+        if (selectedPlacements.length === 0) {
+            issues.push("Select at least one placement");
+        }
+        const knownPlacementIds = new Set(placements.map((placement) => placement.id));
+        const enabledPlacementIds = new Set(placements.filter((placement) => placement.enabled).map((placement) => placement.id));
+        const unknownPlacements = selectedPlacements.filter((placementId) => !knownPlacementIds.has(placementId));
+        if (unknownPlacements.length > 0) {
+            issues.push(`Unknown placements: ${unknownPlacements.join(", ")}`);
+        }
+        const disabledPlacements = selectedPlacements.filter((placementId) => !enabledPlacementIds.has(placementId));
+        if (disabledPlacements.length > 0) {
+            issues.push(`Selected placements are disabled: ${disabledPlacements.join(", ")}`);
+        }
+        const startMs = startAt ? new Date(startAt).getTime() : null;
+        const endMs = endAt ? new Date(endAt).getTime() : null;
+        if (startAt && Number.isNaN(startMs)) {
+            issues.push("Start date must be a valid ISO timestamp");
+        }
+        if (endAt && Number.isNaN(endMs)) {
+            issues.push("End date must be a valid ISO timestamp");
+        }
+        if (startMs !== null &&
+            endMs !== null &&
+            !Number.isNaN(startMs) &&
+            !Number.isNaN(endMs) &&
+            endMs <= startMs) {
+            issues.push("End date must be after start date");
+        }
+        if (status === "scheduled") {
+            if (!startAt || startMs === null || Number.isNaN(startMs)) {
+                issues.push("Scheduled ads require a valid start date");
+            }
+            else if (startMs <= now) {
+                issues.push("Scheduled ads must start in the future");
+            }
+        }
+        if (status === "active") {
+            if (startMs !== null && !Number.isNaN(startMs) && startMs > now) {
+                issues.push("Active ads cannot have a future start date");
+            }
+            if (endMs !== null && !Number.isNaN(endMs) && endMs <= now) {
+                issues.push("Active ads cannot have an end date in the past");
+            }
+        }
+        if (provider === "manual") {
+            if (!title.trim() && !body.trim() && !imageUrl.trim() && !ctaHref.trim()) {
+                issues.push("Manual ads need at least one creative field (title, body, image, or CTA URL)");
+            }
+        }
+        if (provider === "adsense") {
+            if (!adsenseSlot.trim()) {
+                issues.push("AdSense ads require an AdSense slot id");
+            }
+            if (!providerCredentialStatus?.hasAdsenseClientId) {
+                issues.push("AdSense provider credentials are missing in ad settings");
+            }
+        }
+        if (provider === "thirdParty") {
+            if (!thirdPartyUrl.trim()) {
+                issues.push("Third-party ads require a third-party URL");
+            }
+            else {
+                try {
+                    const parsed = new URL(thirdPartyUrl.trim());
+                    if (parsed.protocol !== "https:") {
+                        issues.push("Third-party ad URL must be https");
+                    }
+                }
+                catch {
+                    issues.push("Third-party ad URL must be a valid URL");
+                }
+            }
+            if (!providerCredentialStatus?.hasThirdPartyScriptUrl) {
+                issues.push("Third-party provider script URL is missing in ad settings");
+            }
+        }
+        return issues;
+    }, [
+        adsenseSlot,
+        body,
+        ctaHref,
+        endAt,
+        imageUrl,
+        name,
+        placements,
+        provider,
+        providerCredentialStatus?.hasAdsenseClientId,
+        providerCredentialStatus?.hasThirdPartyScriptUrl,
+        selectedPlacements,
+        startAt,
+        status,
+        thirdPartyUrl,
+        title,
+    ]);
+    const publishHardeningRequired = status === "active" || status === "scheduled";
+    const blockedByPublishValidation = publishHardeningRequired && publishIssues.length > 0;
+    const togglePlacement = (placementId) => {
+        setSelectedPlacements((prev) => prev.includes(placementId)
+            ? prev.filter((id) => id !== placementId)
+            : [...prev, placementId]);
+        setSaveMessage(null);
+    };
+    return (_jsx(StackedViewShell, { portal: "admin", ...rest, title: labels.title ?? (adId ? "Edit Ad" : "Create Ad"), sections: [
+            metaQuery.error ? (_jsx(Alert, { variant: "error", title: "Could not load ad metadata", children: metaQuery.error instanceof Error ? metaQuery.error.message : "Unknown error" })) : null,
+            adQuery.error ? (_jsx(Alert, { variant: "error", title: "Could not load ad", children: adQuery.error instanceof Error ? adQuery.error.message : "Unknown error" })) : null,
+            _jsxs(Form, { onSubmit: (event) => {
+                    event.preventDefault();
+                    if (blockedByPublishValidation) {
+                        setSaveMessage("Cannot save in publish-ready status until validation issues are fixed.");
+                        return;
+                    }
+                    saveMutation.mutate();
+                }, className: "space-y-4", children: [_jsx(Input, { label: "Ad name", value: name, onChange: (event) => setName(event.target.value), placeholder: "Summer Campaign" }), _jsxs("div", { className: "grid grid-cols-1 md:grid-cols-3 gap-3", "data-section": "adminadeditorview-div-235", children: [_jsx(Select, { label: "Provider", value: provider, options: [
+                                    { label: "Manual", value: "manual" },
+                                    { label: "AdSense", value: "adsense" },
+                                    { label: "Third Party", value: "thirdParty" },
+                                ], onChange: (event) => setProvider(event.target.value) }), _jsx(Select, { label: "Status", value: status, options: [
+                                    { label: "Draft", value: "draft" },
+                                    { label: "Active", value: "active" },
+                                    { label: "Scheduled", value: "scheduled" },
+                                    { label: "Paused", value: "paused" },
+                                ], onChange: (event) => setStatus(event.target.value) }), _jsx(Input, { label: "Priority", type: "number", value: String(priority), onChange: (event) => setPriority(Number(event.target.value || 0)) })] }), _jsx(Toggle, { checked: requiresConsent, onChange: setRequiresConsent, label: "Require user ad-consent for this ad" }), _jsxs("div", { className: "space-y-2", "data-section": "adminadeditorview-div-236", children: [_jsx(Text, { className: "text-sm font-medium", children: "Placements" }), _jsx("div", { className: "grid grid-cols-1 md:grid-cols-2 gap-2", "data-section": "adminadeditorview-div-237", children: placements.map((placement) => (_jsxs("label", { className: "flex items-center gap-2 rounded-md border border-neutral-200 dark:border-slate-700 px-3 py-2", children: [_jsx("input", { type: "checkbox", checked: selectedPlacements.includes(placement.id), onChange: () => togglePlacement(placement.id) }), _jsx("span", { className: "text-sm", children: placement.label })] }, placement.id))) })] }), _jsxs("div", { className: "grid grid-cols-1 md:grid-cols-2 gap-3", "data-section": "adminadeditorview-div-238", children: [_jsx(Input, { label: "Start at (ISO)", value: startAt, onChange: (event) => setStartAt(event.target.value), placeholder: "2026-05-01T00:00:00.000Z" }), _jsx(Input, { label: "End at (ISO)", value: endAt, onChange: (event) => setEndAt(event.target.value), placeholder: "2026-05-30T23:59:59.000Z" })] }), _jsxs("div", { className: "grid grid-cols-1 md:grid-cols-2 gap-3", "data-section": "adminadeditorview-div-239", children: [_jsx(Input, { label: "Creative title", value: title, onChange: (event) => setTitle(event.target.value), placeholder: "Catch the mega sale" }), _jsx(Input, { label: "Creative body", value: body, onChange: (event) => setBody(event.target.value), placeholder: "Up to 40% off this weekend" }), _jsx(Input, { label: "Image URL", value: imageUrl, onChange: (event) => setImageUrl(event.target.value), placeholder: "https://..." }), _jsx(Input, { label: "CTA label", value: ctaLabel, onChange: (event) => setCtaLabel(event.target.value), placeholder: "Shop now" }), _jsx(Input, { label: "CTA URL", value: ctaHref, onChange: (event) => setCtaHref(event.target.value), placeholder: "/promotions/deals" }), provider === "adsense" ? (_jsx(Input, { label: "AdSense slot", value: adsenseSlot, onChange: (event) => setAdsenseSlot(event.target.value), placeholder: "1234567890" })) : null, provider === "thirdParty" ? (_jsx(Input, { label: "Third-party URL", value: thirdPartyUrl, onChange: (event) => setThirdPartyUrl(event.target.value), placeholder: "https://adnetwork.example/slot" })) : null] }), _jsxs("div", { className: "rounded-lg border border-neutral-200 dark:border-slate-700 p-3", "data-section": "adminadeditorview-div-240", children: [_jsx(Text, { className: "text-sm font-medium mb-1", children: "Preview" }), _jsx(Text, { className: "text-xs text-neutral-500 dark:text-zinc-400", children: title || name || "Untitled ad" }), body ? _jsx(Text, { className: "text-sm mt-1", children: body }) : null, ctaLabel ? _jsxs(Text, { className: "text-xs mt-1", children: ["CTA: ", ctaLabel, " (", ctaHref || "#", ")"] }) : null] }), publishHardeningRequired && publishIssues.length > 0 ? (_jsx(Alert, { variant: "warning", title: "Publish readiness issues", children: publishIssues.join("; ") })) : null, _jsx(FormActions, { align: "right", children: _jsx(Button, { type: "submit", disabled: saveMutation.isPending || blockedByPublishValidation || !name.trim() || selectedPlacements.length === 0, children: saveMutation.isPending ? "Saving..." : status === "active" ? "Publish ad" : adId ? "Save changes" : "Create ad" }) }), saveMessage ? (_jsx(Alert, { variant: saveMessage.includes("failed") || saveMessage.includes("Failed") ? "error" : "success", title: "Save status", children: saveMessage })) : null] }),
+        ] }));
+}

package/dist/features/admin/components/AdminAdsView.d.ts

@@ -0,0 +1,25 @@
+import React from "react";
+import type { StackedViewShellProps } from "../../../ui";
+export type AdminAdStatus = "draft" | "active" | "scheduled" | "paused";
+export type AdminAdProvider = "manual" | "adsense" | "thirdParty";
+export interface AdminAdItem {
+    id: string;
+    name: string;
+    provider: AdminAdProvider;
+    status: AdminAdStatus;
+    placementIds: string[];
+    requiresConsent: boolean;
+    priority: number;
+    startAt?: string;
+    endAt?: string;
+    updatedAt?: string;
+}
+export interface AdminAdsViewProps extends Omit<StackedViewShellProps, "sections"> {
+    endpoint?: string;
+    labels?: {
+        title?: string;
+    };
+    createHref?: string;
+    renderEditLink?: (item: AdminAdItem) => React.ReactNode;
+}
+export declare function AdminAdsView({ endpoint, labels, createHref, renderEditLink, ...rest }: AdminAdsViewProps): import("react/jsx-runtime").JSX.Element;