@rovela-ai/sdk 0.4.1 → 0.4.2

package/dist/admin/hooks/useAdminStats.js

@@ -0,0 +1,128 @@
+'use client';
+/**
+ * @rovela/sdk/admin/hooks/useAdminStats
+ *
+ * Dashboard statistics hook for admin panel.
+ */
+import { useState, useCallback, useEffect } from 'react';
+import { fetchAdminApi } from './fetchAdminApi';
+// =============================================================================
+// Hook Implementation
+// =============================================================================
+/**
+ * Dashboard statistics hook.
+ *
+ * @param options - Configuration options
+ * @returns Stats data and methods
+ *
+ * @example
+ * ```typescript
+ * function Dashboard() {
+ *   const { stats, lowStock, recentOrders, isLoading, error, refresh } = useAdminStats()
+ *
+ *   if (isLoading) return <div>Loading...</div>
+ *   if (error) return <div>Error: {error}</div>
+ *
+ *   return (
+ *     <div>
+ *       <StatsCards stats={stats} />
+ *       <RecentOrders orders={recentOrders} />
+ *       <LowStockAlert items={lowStock} />
+ *       <button onClick={refresh}>Refresh</button>
+ *     </div>
+ *   )
+ * }
+ * ```
+ */
+export function useAdminStats(options = {}) {
+    const { includeRevenue = false, includeOrderStatus = false, lowStockThreshold = 10, recentOrdersLimit = 5, autoFetch = true, period, } = options;
+    const [stats, setStats] = useState(null);
+    const [lowStock, setLowStock] = useState([]);
+    const [recentOrders, setRecentOrders] = useState([]);
+    const [revenueByDay, setRevenueByDay] = useState([]);
+    const [ordersByStatus, setOrdersByStatus] = useState([]);
+    const [summary, setSummary] = useState(null);
+    const [isLoading, setIsLoading] = useState(false);
+    const [error, setError] = useState(null);
+    /**
+     * Fetch dashboard stats from API.
+     */
+    const refresh = useCallback(async () => {
+        setIsLoading(true);
+        setError(null);
+        const params = new URLSearchParams();
+        if (includeRevenue)
+            params.set('includeRevenue', 'true');
+        if (includeOrderStatus)
+            params.set('includeOrderStatus', 'true');
+        params.set('lowStockThreshold', lowStockThreshold.toString());
+        params.set('recentOrdersLimit', recentOrdersLimit.toString());
+        if (period)
+            params.set('period', period);
+        const res = await fetchAdminApi(`/api/admin/stats?${params.toString()}`);
+        setIsLoading(false);
+        if (!res.ok) {
+            setError(res.error);
+            return;
+        }
+        setStats(res.data.stats);
+        setLowStock(res.data.lowStock || []);
+        setRecentOrders((res.data.recentOrders || []).map((order) => ({
+            id: order.id,
+            email: order.email,
+            status: order.status,
+            total: order.total,
+            createdAt: order.createdAt,
+        })));
+        if (res.data.revenueByDay)
+            setRevenueByDay(res.data.revenueByDay);
+        if (res.data.ordersByStatus)
+            setOrdersByStatus(res.data.ordersByStatus);
+        setSummary(res.data.summary ?? null);
+    }, [includeRevenue, includeOrderStatus, lowStockThreshold, recentOrdersLimit, period]);
+    // Auto-fetch on mount.
+    // Pattern C — populate state from async-loaded admin stats.
+    // Alternative is a data-fetching library (TanStack Query / SWR).
+    useEffect(() => {
+        if (autoFetch) {
+            // eslint-disable-next-line react-hooks/set-state-in-effect
+            refresh();
+        }
+    }, [autoFetch, refresh]);
+    // Throttled refetch when the user returns to the tab after a focus loss.
+    // Without this, a tab left open for hours shows stale numbers. We throttle
+    // to once per 30s so quick alt-tabs don't hammer the endpoint.
+    useEffect(() => {
+        if (!autoFetch)
+            return;
+        let lastRefreshAt = Date.now();
+        const REFETCH_THROTTLE_MS = 30 * 1000;
+        const maybeRefresh = () => {
+            if (typeof document !== 'undefined' && document.visibilityState !== 'visible')
+                return;
+            const now = Date.now();
+            if (now - lastRefreshAt < REFETCH_THROTTLE_MS)
+                return;
+            lastRefreshAt = now;
+            refresh();
+        };
+        window.addEventListener('focus', maybeRefresh);
+        document.addEventListener('visibilitychange', maybeRefresh);
+        return () => {
+            window.removeEventListener('focus', maybeRefresh);
+            document.removeEventListener('visibilitychange', maybeRefresh);
+        };
+    }, [autoFetch, refresh]);
+    return {
+        stats,
+        lowStock,
+        recentOrders,
+        revenueByDay,
+        ordersByStatus,
+        summary,
+        isLoading,
+        error,
+        refresh,
+    };
+}
+//# sourceMappingURL=useAdminStats.js.map

package/dist/admin/hooks/useAdminStats.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAdminStats.js","sourceRoot":"","sources":["../../../src/admin/hooks/useAdminStats.ts"],"names":[],"mappings":"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"}

package/dist/admin/hooks/useAdminUsers.d.ts

@@ -0,0 +1,3 @@
+import type { UseAdminUsersReturn } from '../types';
+export declare function useAdminUsers(): UseAdminUsersReturn;
+//# sourceMappingURL=useAdminUsers.d.ts.map

package/dist/admin/hooks/useAdminUsers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAdminUsers.d.ts","sourceRoot":"","sources":["../../../src/admin/hooks/useAdminUsers.ts"],"names":[],"mappings":"AA8BA,OAAO,KAAK,EAKV,mBAAmB,EACpB,MAAM,UAAU,CAAA;AAOjB,wBAAgB,aAAa,IAAI,mBAAmB,CA0NnD"}

package/dist/admin/hooks/useAdminUsers.js

@@ -0,0 +1,177 @@
+'use client';
+/**
+ * @rovela/sdk/admin/hooks/useAdminUsers
+ *
+ * Admin user management data hook. Mirrors `useAdminCustomers` — state for
+ * the list, fetchers, and mutation helpers (deactivate, reactivate, delete,
+ * invite, resendInvite, cancelInvite, changeRole).
+ *
+ * All HTTP calls go through `fetchAdminApi` — see its file-level comment
+ * for the rationale. All mutations optimistically refetch the current page
+ * afterward so the table always reflects server state.
+ *
+ * @example
+ * ```tsx
+ * function UsersPage() {
+ *   const { users, isLoading, fetchUsers, deactivate } = useAdminUsers()
+ *
+ *   useEffect(() => { fetchUsers() }, [fetchUsers])
+ *
+ *   const handleDeactivate = async (id: string) => {
+ *     const result = await deactivate(id)
+ *     if (!result.success) toast.error(result.error)
+ *   }
+ * }
+ * ```
+ */
+import { useState, useCallback, useRef } from 'react';
+import { fetchAdminApi } from './fetchAdminApi';
+// =============================================================================
+// Hook
+// =============================================================================
+export function useAdminUsers() {
+    const [users, setUsers] = useState([]);
+    const [total, setTotal] = useState(0);
+    const [page, setPage] = useState(1);
+    const [isLoading, setIsLoading] = useState(false);
+    const [error, setError] = useState(null);
+    // Keep the last fetch options around so mutation handlers can refetch
+    // the exact same view without the caller passing them in again.
+    const lastOptionsRef = useRef({});
+    const fetchUsers = useCallback(async (options = {}) => {
+        const merged = {
+            page: 1,
+            limit: 20,
+            ...options,
+        };
+        lastOptionsRef.current = merged;
+        setIsLoading(true);
+        setError(null);
+        const params = new URLSearchParams();
+        if (merged.search)
+            params.set('search', merged.search);
+        if (merged.status && merged.status !== 'all')
+            params.set('status', merged.status);
+        if (merged.role && merged.role !== 'all')
+            params.set('role', merged.role);
+        params.set('page', String(merged.page ?? 1));
+        params.set('limit', String(merged.limit ?? 20));
+        const res = await fetchAdminApi(`/api/admin/users?${params.toString()}`);
+        setIsLoading(false);
+        if (!res.ok) {
+            setError(res.error);
+            setUsers([]);
+            return;
+        }
+        setUsers(res.data.data ?? []);
+        setTotal(res.data.total ?? 0);
+        setPage(res.data.page ?? 1);
+    }, []);
+    const getUser = useCallback(async (id) => {
+        const res = await fetchAdminApi(`/api/admin/users/${id}`);
+        if (!res.ok)
+            return null;
+        return res.data.data ?? null;
+    }, []);
+    // Internal helper: PATCH with action discriminator
+    const patchAction = useCallback(async (id, action) => {
+        const res = await fetchAdminApi(`/api/admin/users/${id}`, {
+            method: 'PATCH',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ action }),
+        });
+        if (!res.ok) {
+            return { success: false, error: res.error };
+        }
+        if (!res.data?.success) {
+            return { success: false, error: `Failed to ${action} user` };
+        }
+        // Refresh current view so the table reflects the new state
+        await fetchUsers(lastOptionsRef.current);
+        return { success: true };
+    }, [fetchUsers]);
+    const deactivate = useCallback((id) => patchAction(id, 'deactivate'), [patchAction]);
+    const reactivate = useCallback((id) => patchAction(id, 'reactivate'), [patchAction]);
+    const deleteUser = useCallback(async (id) => {
+        const res = await fetchAdminApi(`/api/admin/users/${id}`, { method: 'DELETE' });
+        if (!res.ok) {
+            return { success: false, error: res.error };
+        }
+        if (!res.data?.success) {
+            return { success: false, error: 'Failed to delete user' };
+        }
+        await fetchUsers(lastOptionsRef.current);
+        return { success: true };
+    }, [fetchUsers]);
+    // =========================================================================
+    // Phase 3 — invite, resend, cancel, change role
+    // =========================================================================
+    const invite = useCallback(async (payload) => {
+        const res = await fetchAdminApi('/api/admin/users', {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify(payload),
+        });
+        if (!res.ok) {
+            return { success: false, error: res.error };
+        }
+        if (!res.data?.success) {
+            return { success: false, error: 'Failed to send invite' };
+        }
+        await fetchUsers(lastOptionsRef.current);
+        return {
+            success: true,
+            adminId: res.data.adminId,
+            inviteUrl: res.data.inviteUrl,
+        };
+    }, [fetchUsers]);
+    const resendInvite = useCallback(async (id) => {
+        const res = await fetchAdminApi(`/api/admin/users/${id}`, {
+            method: 'PATCH',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ action: 'resend_invite' }),
+        });
+        if (!res.ok) {
+            return { success: false, error: res.error };
+        }
+        if (!res.data?.success) {
+            return { success: false, error: 'Failed to resend invite' };
+        }
+        await fetchUsers(lastOptionsRef.current);
+        return { success: true, inviteUrl: res.data.inviteUrl };
+    }, [fetchUsers]);
+    const cancelInvite = useCallback((id) => patchAction(id, 'cancel_invite'), [patchAction]);
+    const changeRole = useCallback(async (id, newRole) => {
+        const res = await fetchAdminApi(`/api/admin/users/${id}`, {
+            method: 'PATCH',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ action: 'change_role', role: newRole }),
+        });
+        if (!res.ok) {
+            return { success: false, error: res.error };
+        }
+        if (!res.data?.success) {
+            return { success: false, error: 'Failed to change role' };
+        }
+        await fetchUsers(lastOptionsRef.current);
+        return { success: true };
+    }, [fetchUsers]);
+    return {
+        users,
+        total,
+        page,
+        isLoading,
+        error,
+        fetchUsers,
+        getUser,
+        deactivate,
+        reactivate,
+        deleteUser,
+        // Phase 3
+        invite,
+        resendInvite,
+        cancelInvite,
+        changeRole,
+    };
+}
+//# sourceMappingURL=useAdminUsers.js.map

package/dist/admin/hooks/useAdminUsers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAdminUsers.js","sourceRoot":"","sources":["../../../src/admin/hooks/useAdminUsers.ts"],"names":[],"mappings":"AAAA,YAAY,CAAA;AAEZ;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,OAAO,CAAA;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAU/C,gFAAgF;AAChF,OAAO;AACP,gFAAgF;AAEhF,MAAM,UAAU,aAAa;IAC3B,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAkB,EAAE,CAAC,CAAA;IACvD,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAA;IACrC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAA;IACnC,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAA;IACjD,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAgB,IAAI,CAAC,CAAA;IAEvD,sEAAsE;IACtE,gEAAgE;IAChE,MAAM,cAAc,GAAG,MAAM,CAAuB,EAAE,CAAC,CAAA;IAEvD,MAAM,UAAU,GAAG,WAAW,CAC5B,KAAK,EAAE,UAAgC,EAAE,EAAiB,EAAE;QAC1D,MAAM,MAAM,GAAyB;YACnC,IAAI,EAAE,CAAC;YACP,KAAK,EAAE,EAAE;YACT,GAAG,OAAO;SACX,CAAA;QACD,cAAc,CAAC,OAAO,GAAG,MAAM,CAAA;QAE/B,YAAY,CAAC,IAAI,CAAC,CAAA;QAClB,QAAQ,CAAC,IAAI,CAAC,CAAA;QAEd,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAA;QACpC,IAAI,MAAM,CAAC,MAAM;YAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,CAAA;QACtD,IAAI,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,KAAK,KAAK;YAC1C,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,CAAA;QACrC,IAAI,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI,KAAK,KAAK;YAAE,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,CAAA;QACzE,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAA;QAC5C,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAA;QAE/C,MAAM,GAAG,GAAG,MAAM,aAAa,CAI5B,oBAAoB,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAA;QAE3C,YAAY,CAAC,KAAK,CAAC,CAAA;QAEnB,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;YACnB,QAAQ,CAAC,EAAE,CAAC,CAAA;YACZ,OAAM;QACR,CAAC;QAED,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,CAAA;QAC7B,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,CAAA;QAC7B,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC,CAAA;IAC7B,CAAC,EACD,EAAE,CACH,CAAA;IAED,MAAM,OAAO,GAAG,WAAW,CACzB,KAAK,EAAE,EAAU,EAAiC,EAAE;QAClD,MAAM,GAAG,GAAG,MAAM,aAAa,CAC7B,oBAAoB,EAAE,EAAE,CACzB,CAAA;QACD,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,OAAO,IAAI,CAAA;QACxB,OAAO,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAA;IAC9B,CAAC,EACD,EAAE,CACH,CAAA;IAED,mDAAmD;IACnD,MAAM,WAAW,GAAG,WAAW,CAC7B,KAAK,EACH,EAAU,EACV,MAAqD,EACN,EAAE;QACjD,MAAM,GAAG,GAAG,MAAM,aAAa,CAC7B,oBAAoB,EAAE,EAAE,EACxB;YACE,MAAM,EAAE,OAAO;YACf,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;SACjC,CACF,CAAA;QACD,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,CAAA;QAC7C,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC;YACvB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,aAAa,MAAM,OAAO,EAAE,CAAA;QAC9D,CAAC;QACD,2DAA2D;QAC3D,MAAM,UAAU,CAAC,cAAc,CAAC,OAAO,CAAC,CAAA;QACxC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;IAC1B,CAAC,EACD,CAAC,UAAU,CAAC,CACb,CAAA;IAED,MAAM,UAAU,GAAG,WAAW,CAC5B,CAAC,EAAU,EAAE,EAAE,CAAC,WAAW,CAAC,EAAE,EAAE,YAAY,CAAC,EAC7C,CAAC,WAAW,CAAC,CACd,CAAA;IAED,MAAM,UAAU,GAAG,WAAW,CAC5B,CAAC,EAAU,EAAE,EAAE,CAAC,WAAW,CAAC,EAAE,EAAE,YAAY,CAAC,EAC7C,CAAC,WAAW,CAAC,CACd,CAAA;IAED,MAAM,UAAU,GAAG,WAAW,CAC5B,KAAK,EAAE,EAAU,EAAiD,EAAE;QAClE,MAAM,GAAG,GAAG,MAAM,aAAa,CAC7B,oBAAoB,EAAE,EAAE,EACxB,EAAE,MAAM,EAAE,QAAQ,EAAE,CACrB,CAAA;QACD,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,CAAA;QAC7C,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC;YACvB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,uBAAuB,EAAE,CAAA;QAC3D,CAAC;QACD,MAAM,UAAU,CAAC,cAAc,CAAC,OAAO,CAAC,CAAA;QACxC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;IAC1B,CAAC,EACD,CAAC,UAAU,CAAC,CACb,CAAA;IAED,4EAA4E;IAC5E,gDAAgD;IAChD,4EAA4E;IAE5E,MAAM,MAAM,GAAG,WAAW,CACxB,KAAK,EAAE,OAAwB,EAAkC,EAAE;QACjE,MAAM,GAAG,GAAG,MAAM,aAAa,CAI5B,kBAAkB,EAAE;YACrB,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;SAC9B,CAAC,CAAA;QACF,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,CAAA;QAC7C,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC;YACvB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,uBAAuB,EAAE,CAAA;QAC3D,CAAC;QACD,MAAM,UAAU,CAAC,cAAc,CAAC,OAAO,CAAC,CAAA;QACxC,OAAO;YACL,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,GAAG,CAAC,IAAI,CAAC,OAAO;YACzB,SAAS,EAAE,GAAG,CAAC,IAAI,CAAC,SAAS;SAC9B,CAAA;IACH,CAAC,EACD,CAAC,UAAU,CAAC,CACb,CAAA;IAED,MAAM,YAAY,GAAG,WAAW,CAC9B,KAAK,EAAE,EAAU,EAAkC,EAAE;QACnD,MAAM,GAAG,GAAG,MAAM,aAAa,CAG5B,oBAAoB,EAAE,EAAE,EAAE;YAC3B,MAAM,EAAE,OAAO;YACf,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC;SAClD,CAAC,CAAA;QACF,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,CAAA;QAC7C,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC;YACvB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,yBAAyB,EAAE,CAAA;QAC7D,CAAC;QACD,MAAM,UAAU,CAAC,cAAc,CAAC,OAAO,CAAC,CAAA;QACxC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,CAAC,IAAI,CAAC,SAAS,EAAE,CAAA;IACzD,CAAC,EACD,CAAC,UAAU,CAAC,CACb,CAAA;IAED,MAAM,YAAY,GAAG,WAAW,CAC9B,CAAC,EAAU,EAAE,EAAE,CAAC,WAAW,CAAC,EAAE,EAAE,eAAe,CAAC,EAChD,CAAC,WAAW,CAAC,CACd,CAAA;IAED,MAAM,UAAU,GAAG,WAAW,CAC5B,KAAK,EACH,EAAU,EACV,OAAkB,EAC6B,EAAE;QACjD,MAAM,GAAG,GAAG,MAAM,aAAa,CAC7B,oBAAoB,EAAE,EAAE,EACxB;YACE,MAAM,EAAE,OAAO;YACf,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;SAC/D,CACF,CAAA;QACD,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,CAAA;QAC7C,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC;YACvB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,uBAAuB,EAAE,CAAA;QAC3D,CAAC;QACD,MAAM,UAAU,CAAC,cAAc,CAAC,OAAO,CAAC,CAAA;QACxC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;IAC1B,CAAC,EACD,CAAC,UAAU,CAAC,CACb,CAAA;IAED,OAAO;QACL,KAAK;QACL,KAAK;QACL,IAAI;QACJ,SAAS;QACT,KAAK;QACL,UAAU;QACV,OAAO;QACP,UAAU;QACV,UAAU;QACV,UAAU;QACV,UAAU;QACV,MAAM;QACN,YAAY;QACZ,YAAY;QACZ,UAAU;KACX,CAAA;AACH,CAAC"}

package/dist/admin/hooks/useLinkedCustomerStatus.d.ts

@@ -0,0 +1,3 @@
+export type LinkedCustomerStatus = 'loading' | 'linked' | 'none';
+export declare function useLinkedCustomerStatus(): LinkedCustomerStatus;
+//# sourceMappingURL=useLinkedCustomerStatus.d.ts.map

package/dist/admin/hooks/useLinkedCustomerStatus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useLinkedCustomerStatus.d.ts","sourceRoot":"","sources":["../../../src/admin/hooks/useLinkedCustomerStatus.ts"],"names":[],"mappings":"AAiBA,MAAM,MAAM,oBAAoB,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAA;AAEhE,wBAAgB,uBAAuB,IAAI,oBAAoB,CAkC9D"}

package/dist/admin/hooks/useLinkedCustomerStatus.js

@@ -0,0 +1,48 @@
+'use client';
+/**
+ * @rovela/sdk/admin/hooks/useLinkedCustomerStatus
+ *
+ * Tells the admin UI whether the current admin also has a customer row on
+ * this store (same email exists in `customers`). Powers the conditional
+ * "My customer account" entry in `AdminUserMenu` (R112).
+ *
+ * One fetch per mount. Low-volatility state — refresh on page reload.
+ * Uses the cancelled-flag pattern to discard late responses if the hook
+ * unmounts before the fetch settles.
+ */
+import { useEffect, useState } from 'react';
+import { useAdminAuth } from './useAdminAuth';
+export function useLinkedCustomerStatus() {
+    const { isAuthenticated, isLoading } = useAdminAuth();
+    const [status, setStatus] = useState('loading');
+    // Pattern C — populate state from async-loaded linked-customer probe.
+    // Alternative is a data-fetching library (TanStack Query / SWR).
+    useEffect(() => {
+        // Admin auth still resolving — stay in loading.
+        if (isLoading)
+            return;
+        // Not an admin session → nothing to link.
+        if (!isAuthenticated) {
+            // eslint-disable-next-line react-hooks/set-state-in-effect
+            setStatus('none');
+            return;
+        }
+        let cancelled = false;
+        fetch('/api/admin/linked-customer')
+            .then((res) => (res.ok ? res.json() : null))
+            .then((data) => {
+            if (cancelled)
+                return;
+            setStatus(data?.hasLinkedCustomer ? 'linked' : 'none');
+        })
+            .catch(() => {
+            if (!cancelled)
+                setStatus('none');
+        });
+        return () => {
+            cancelled = true;
+        };
+    }, [isAuthenticated, isLoading]);
+    return status;
+}
+//# sourceMappingURL=useLinkedCustomerStatus.js.map

package/dist/admin/hooks/useLinkedCustomerStatus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useLinkedCustomerStatus.js","sourceRoot":"","sources":["../../../src/admin/hooks/useLinkedCustomerStatus.ts"],"names":[],"mappings":"AAAA,YAAY,CAAA;AAEZ;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAI7C,MAAM,UAAU,uBAAuB;IACrC,MAAM,EAAE,eAAe,EAAE,SAAS,EAAE,GAAG,YAAY,EAAE,CAAA;IACrD,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,QAAQ,CAAuB,SAAS,CAAC,CAAA;IAErE,sEAAsE;IACtE,iEAAiE;IACjE,SAAS,CAAC,GAAG,EAAE;QACb,gDAAgD;QAChD,IAAI,SAAS;YAAE,OAAM;QAErB,0CAA0C;QAC1C,IAAI,CAAC,eAAe,EAAE,CAAC;YACrB,2DAA2D;YAC3D,SAAS,CAAC,MAAM,CAAC,CAAA;YACjB,OAAM;QACR,CAAC;QAED,IAAI,SAAS,GAAG,KAAK,CAAA;QACrB,KAAK,CAAC,4BAA4B,CAAC;aAChC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;aAC3C,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE;YACb,IAAI,SAAS;gBAAE,OAAM;YACrB,SAAS,CAAC,IAAI,EAAE,iBAAiB,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAA;QACxD,CAAC,CAAC;aACD,KAAK,CAAC,GAAG,EAAE;YACV,IAAI,CAAC,SAAS;gBAAE,SAAS,CAAC,MAAM,CAAC,CAAA;QACnC,CAAC,CAAC,CAAA;QAEJ,OAAO,GAAG,EAAE;YACV,SAAS,GAAG,IAAI,CAAA;QAClB,CAAC,CAAA;IACH,CAAC,EAAE,CAAC,eAAe,EAAE,SAAS,CAAC,CAAC,CAAA;IAEhC,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/admin/hooks/useSetupGuide.d.ts

@@ -0,0 +1,45 @@
+export type SetupTaskId = 'stripe' | 'products' | 'shipping' | 'tax' | 'logo' | 'domain' | 'legal' | 'team' | 'analytics';
+export type SetupTier = 1 | 2 | 3;
+export interface SetupTask {
+    id: SetupTaskId;
+    tier: SetupTier;
+    status: 'complete' | 'incomplete';
+    auto: boolean;
+    hasManualOverride?: boolean;
+}
+export interface SetupGuideData {
+    tasks: SetupTask[];
+    progress: {
+        total: number;
+        complete: number;
+        tier1: {
+            complete: number;
+            total: number;
+        };
+        tier2: {
+            complete: number;
+            total: number;
+        };
+        tier3: {
+            complete: number;
+            total: number;
+        };
+    };
+    visibility: 'show' | 'hide';
+    dismissedAt: string | null;
+}
+export type ManualMarkKey = 'taxNoneNeeded' | 'legalPagesReviewed' | 'firstProductTouched' | 'logoUploaded' | 'dismiss' | 'reopen';
+export interface UseSetupGuideReturn {
+    data: SetupGuideData | null;
+    isLoading: boolean;
+    error: string | null;
+    refresh: () => Promise<void>;
+    /** Toggle a manual flag (e.g. legalPagesReviewed=true). Refreshes state on success. */
+    mark: (key: ManualMarkKey, value: boolean) => Promise<boolean>;
+    /** Permanent dismiss (only meaningful at 100% complete). */
+    dismiss: () => Promise<boolean>;
+    /** Re-open after dismiss (e.g. from the Settings page link). */
+    reopen: () => Promise<boolean>;
+}
+export declare function useSetupGuide(): UseSetupGuideReturn;
+//# sourceMappingURL=useSetupGuide.d.ts.map

package/dist/admin/hooks/useSetupGuide.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSetupGuide.d.ts","sourceRoot":"","sources":["../../../src/admin/hooks/useSetupGuide.ts"],"names":[],"mappings":"AAqBA,MAAM,MAAM,WAAW,GACnB,QAAQ,GACR,UAAU,GACV,UAAU,GACV,KAAK,GACL,MAAM,GACN,QAAQ,GACR,OAAO,GACP,MAAM,GACN,WAAW,CAAA;AAEf,MAAM,MAAM,SAAS,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;AAEjC,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,WAAW,CAAA;IACf,IAAI,EAAE,SAAS,CAAA;IACf,MAAM,EAAE,UAAU,GAAG,YAAY,CAAA;IACjC,IAAI,EAAE,OAAO,CAAA;IACb,iBAAiB,CAAC,EAAE,OAAO,CAAA;CAC5B;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,SAAS,EAAE,CAAA;IAClB,QAAQ,EAAE;QACR,KAAK,EAAE,MAAM,CAAA;QACb,QAAQ,EAAE,MAAM,CAAA;QAChB,KAAK,EAAE;YAAE,QAAQ,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAA;QAC1C,KAAK,EAAE;YAAE,QAAQ,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAA;QAC1C,KAAK,EAAE;YAAE,QAAQ,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAA;KAC3C,CAAA;IACD,UAAU,EAAE,MAAM,GAAG,MAAM,CAAA;IAC3B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;CAC3B;AAED,MAAM,MAAM,aAAa,GACrB,eAAe,GACf,oBAAoB,GACpB,qBAAqB,GACrB,cAAc,GACd,SAAS,GACT,QAAQ,CAAA;AAEZ,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,cAAc,GAAG,IAAI,CAAA;IAC3B,SAAS,EAAE,OAAO,CAAA;IAClB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAC5B,uFAAuF;IACvF,IAAI,EAAE,CAAC,GAAG,EAAE,aAAa,EAAE,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IAC9D,4DAA4D;IAC5D,OAAO,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAA;IAC/B,gEAAgE;IAChE,MAAM,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAA;CAC/B;AAMD,wBAAgB,aAAa,IAAI,mBAAmB,CAoDnD"}

package/dist/admin/hooks/useSetupGuide.js

@@ -0,0 +1,60 @@
+'use client';
+/**
+ * @rovela/sdk/admin/hooks/useSetupGuide
+ *
+ * Fetches the 9-task setup guide state and surfaces mutation methods for
+ * manual marks + dismiss. Powers the SetupGuide component on the admin
+ * dashboard.
+ *
+ * Endpoints:
+ *   GET  /api/admin/setup-guide                  → all task statuses + progress
+ *   POST /api/admin/setup-guide/manual-mark      → flip one manual flag
+ */
+import { useState, useCallback, useEffect } from 'react';
+import { fetchAdminApi } from './fetchAdminApi';
+// =============================================================================
+// Hook
+// =============================================================================
+export function useSetupGuide() {
+    const [data, setData] = useState(null);
+    const [isLoading, setIsLoading] = useState(false);
+    const [error, setError] = useState(null);
+    const refresh = useCallback(async () => {
+        setIsLoading(true);
+        setError(null);
+        const res = await fetchAdminApi('/api/admin/setup-guide');
+        setIsLoading(false);
+        if (!res.ok) {
+            setError(res.error);
+            return;
+        }
+        setData(res.data);
+    }, []);
+    const mark = useCallback(async (key, value) => {
+        const res = await fetchAdminApi('/api/admin/setup-guide/manual-mark', {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ key, value }),
+        });
+        if (!res.ok) {
+            setError(res.error);
+            return false;
+        }
+        // Optimistic-but-correct: refetch so derived progress + the row's
+        // status badge stay in lockstep with the server (the merchant can also
+        // have completed an auto-detected task in another tab).
+        await refresh();
+        return true;
+    }, [refresh]);
+    const dismiss = useCallback(() => mark('dismiss', true), [mark]);
+    const reopen = useCallback(() => mark('reopen', false), [mark]);
+    // Auto-fetch on mount.
+    // Pattern C — populate state from async-loaded setup-guide data.
+    // Alternative is a data-fetching library (TanStack Query / SWR).
+    useEffect(() => {
+        // eslint-disable-next-line react-hooks/set-state-in-effect
+        refresh();
+    }, [refresh]);
+    return { data, isLoading, error, refresh, mark, dismiss, reopen };
+}
+//# sourceMappingURL=useSetupGuide.js.map

package/dist/admin/hooks/useSetupGuide.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSetupGuide.js","sourceRoot":"","sources":["../../../src/admin/hooks/useSetupGuide.ts"],"names":[],"mappings":"AAAA,YAAY,CAAA;AAEZ;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AA6D/C,gFAAgF;AAChF,OAAO;AACP,gFAAgF;AAEhF,MAAM,UAAU,aAAa;IAC3B,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,QAAQ,CAAwB,IAAI,CAAC,CAAA;IAC7D,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAA;IACjD,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAgB,IAAI,CAAC,CAAA;IAEvD,MAAM,OAAO,GAAG,WAAW,CAAC,KAAK,IAAmB,EAAE;QACpD,YAAY,CAAC,IAAI,CAAC,CAAA;QAClB,QAAQ,CAAC,IAAI,CAAC,CAAA;QACd,MAAM,GAAG,GAAG,MAAM,aAAa,CAAiB,wBAAwB,CAAC,CAAA;QACzE,YAAY,CAAC,KAAK,CAAC,CAAA;QACnB,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;YACnB,OAAM;QACR,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IACnB,CAAC,EAAE,EAAE,CAAC,CAAA;IAEN,MAAM,IAAI,GAAG,WAAW,CACtB,KAAK,EAAE,GAAkB,EAAE,KAAc,EAAoB,EAAE;QAC7D,MAAM,GAAG,GAAG,MAAM,aAAa,CAC7B,oCAAoC,EACpC;YACE,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC;SACrC,CACF,CAAA;QACD,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;YACnB,OAAO,KAAK,CAAA;QACd,CAAC;QACD,kEAAkE;QAClE,uEAAuE;QACvE,wDAAwD;QACxD,MAAM,OAAO,EAAE,CAAA;QACf,OAAO,IAAI,CAAA;IACb,CAAC,EACD,CAAC,OAAO,CAAC,CACV,CAAA;IAED,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAA;IAChE,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAA;IAE/D,uBAAuB;IACvB,iEAAiE;IACjE,iEAAiE;IACjE,SAAS,CAAC,GAAG,EAAE;QACb,2DAA2D;QAC3D,OAAO,EAAE,CAAA;IACX,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAA;IAEb,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,CAAA;AACnE,CAAC"}

package/dist/admin/index.d.ts

@@ -0,0 +1,66 @@
+/**
+ * @rovela/sdk/admin
+ *
+ * Admin dashboard module: complete store management with separate admin auth.
+ *
+ * ## Features
+ * - Separate admin authentication (independent from customer auth)
+ * - Dashboard with stats, recent orders, and low stock alerts
+ * - Product management with variants and inventory
+ * - Order management with status updates and refunds
+ * - Customer viewing
+ * - Store settings
+ *
+ * ## Usage
+ *
+ * ### Setup Auth (app/api/admin-auth/[...nextauth]/route.ts)
+ * ```typescript
+ * import NextAuth from 'next-auth'
+ * import { createAdminAuthOptions } from '@rovela-ai/sdk/admin'
+ * const handler = NextAuth(createAdminAuthOptions())
+ * export { handler as GET, handler as POST }
+ * ```
+ *
+ * ### Protected Layout (app/admin/layout.tsx)
+ * ```tsx
+ * import { AdminGuard, AdminLayout } from '@rovela/sdk/admin'
+ *
+ * export default function Layout({ children }) {
+ *   return (
+ *     <AdminGuard>
+ *       <AdminLayout storeName="My Store">
+ *         {children}
+ *       </AdminLayout>
+ *     </AdminGuard>
+ *   )
+ * }
+ * ```
+ *
+ * ### Dashboard Page (app/admin/page.tsx)
+ * ```tsx
+ * import { StatsCards, RecentOrders, LowStockAlert, useAdminStats } from '@rovela/sdk/admin'
+ *
+ * export default function DashboardPage() {
+ *   const { stats, isLoading } = useAdminStats()
+ *   return (
+ *     <div>
+ *       <StatsCards stats={stats} isLoading={isLoading} />
+ *       <div className="grid grid-cols-2 gap-6">
+ *         <RecentOrders />
+ *         <LowStockAlert />
+ *       </div>
+ *     </div>
+ *   )
+ * }
+ * ```
+ */
+export type { OrderStatus, ProductStatus, AdminRole, Order, OrderItem, Product, ProductVariant, Customer, StoreAdmin, Category, PaginatedResponse, ApiError, Address, AdminApiError, AdminSession, AdminAuthState, AdminSignInOptions, AdminSignInResult, DashboardStats, DashboardPeriod, DashboardSummaryPayload, LowStockItem, RecentOrder, RevenueDataPoint, OrderStatusDataPoint, UseAdminStatsOptions, ProductFormData, VariantFormData, CategoryFormData, ProductListOptions, OrderListOptions, CustomerListOptions, CrudResult, RefundResult, StoreSettingsData, StoreSettingsInput, ShippingCarrierData, ShippingCarrierInput, ShippingRateData, ShippingZoneData, ShippingZoneInput, ShippingRateInput, ShippingSettingsProps, ShippingZoneFormProps, ShippingRateFormProps, TaxZoneData, TaxZoneInput, TaxSettingsProps, ShippingMode, ShippoAddress, ShippoParcel, ShippoRate, ShippoLabelResult, ShippoValidationResult, AdminOrderListItem, AdminOrderDetail, AdminOrderItem, AdminProductListItem, AdminProductDetail, AdminProductVariant, AdminCustomerListItem, AdminCustomerDetail, AdminCategoryListItem, AdminListItem, AdminUserListOptions, UsersTableProps, UseAdminUsersReturn, UseAdminPermissionsReturn, AdminInviteData, AdminInviteHookResult, InviteUserDialogProps, AdminAcceptInviteFormProps, AdminLayoutProps, AdminGuardProps, AdminLoginFormProps, AdminNavProps, StatsCardsProps, RecentOrdersProps, LowStockAlertProps, ProductTableProps, ProductFormProps, InventoryEditorProps, OrderTableProps, OrderDetailsProps, RefundDialogProps, StoreSettingsProps, CustomerTableProps, CustomerDetailsProps, AdminAuthConfigOptions, UseAdminAuthReturn, UseAdminStatsReturn, UseAdminOrdersReturn, UseAdminProductsReturn, UseAdminCustomersReturn, UseAdminCategoriesReturn, } from './types';
+export { createAdminAuthOptions, getAdminSession, } from './config';
+export { authenticateAdmin, createAdmin, updateAdminPassword, findAdminForSession, findAdminByEmail, findAdminById, updateAdmin, adminEmailExists, countAdmins, requestAdminPasswordReset, validateAdminResetToken, resetAdminPassword, deleteAdminPasswordResetTokens, cleanupExpiredAdminResetTokens, listAdmins, countActiveOwners, deactivateAdmin, reactivateAdmin, hardDeleteAdmin, inviteAdmin, resendAdminInvite, cancelAdminInvite, changeAdminRole, validateInviteToken, acceptAdminInvite, deleteAdminInviteTokens, cleanupExpiredInviteTokens, changeOwnPassword, updateOwnProfile, requireAdmin, invalidateAdminSession, } from './server';
+export { getProducts, createProduct, getProduct, updateProduct, deleteProduct, addVariant, updateVariantHandler, deleteVariantHandler, getOrders, getOrder, updateOrder, processRefund, getStats, getCategories, createCategory, getCategory, updateCategory, deleteCategory, getCustomers, getCustomer, setupAdmin, checkAdminExists, getSettings, updateSettings, getStripeStatus, getShippingCarriers, createShippingCarrier, getShippingCarrier, updateShippingCarrier, deleteShippingCarrier, getShippingZones, createShippingZone, getShippingZone, updateShippingZone, deleteShippingZone, createShippingRate, updateShippingRate, deleteShippingRate, getTaxZones, createTaxZone, getTaxZone, updateTaxZone, deleteTaxZone, } from './api';
+export { useAdminAuth, useAdminSession, useAdminStats, useAdminProducts, useAdminProductMetrics, useAdminOrders, useAdminCategories, useAdminCustomers, useAdminUsers, useAdminPermissions, useAdminMe, useLinkedCustomerStatus, useSetupGuide, } from './hooks';
+export type { AdminSessionPayload, AdminSessionStatus, UseAdminSessionReturn, SetupTaskId as SetupGuideTaskId, SetupTier as SetupGuideTier, SetupTask as SetupGuideTaskItem, SetupGuideData, ManualMarkKey as SetupGuideManualMarkKey, } from './hooks';
+export type { CategoryTreeItem } from './hooks/useAdminCategories';
+export { AdminGuard, AdminLoginForm, AdminLayout, AdminNav, AdminBarBanner, ExampleContentBanner, StatsCards, RecentOrders, LowStockAlert, RevenueChart, OrderStatusChart, PrimaryMetricsRow, SecondaryMetricsRow, PeriodSelector, SetupGuide, ProductTable, ProductForm, InventoryEditor, CategorySelect, CategoryForm, SEOPreview, TagInput, VariantManager, OrderTable, OrderDetails, RefundDialog, StoreSettings, LogoUpload, PaymentSettings, ShippingSettings, TaxSettings, CustomerTable, CustomerDetails, UsersTable, AdminForgotPasswordForm, AdminResetPasswordForm, InviteUserDialog, AdminAcceptInviteForm, AdminAccountPage, PermissionsMatrix, DeleteConfirmDialog, } from './components';
+export type { RevenueChartProps, OrderStatusChartProps, PrimaryMetricsRowProps, SecondaryMetricsRowProps, PeriodSelectorProps, CategorySelectProps, CategoryFormProps, SEOPreviewProps, TagInputProps, VariantManagerProps, VariantOption, VariantData, DeleteConfirmDialogProps, LogoUploadProps, PermissionsMatrixProps, } from './components';
+//# sourceMappingURL=index.d.ts.map

package/dist/admin/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/admin/index.ts"],"names":[],"mappings":"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"}