@rovela-ai/sdk 0.4.1 → 0.4.2

package/dist/admin/hooks/useAdminOrders.js

@@ -0,0 +1,118 @@
+'use client';
+/**
+ * @rovela/sdk/admin/hooks/useAdminOrders
+ *
+ * Order management hook for admin panel. All HTTP calls go through
+ * `fetchAdminApi` — see its file-level comment for the rationale.
+ */
+import { useState, useCallback } from 'react';
+import { fetchAdminApi } from './fetchAdminApi';
+// =============================================================================
+// Hook Implementation
+// =============================================================================
+export function useAdminOrders() {
+    const [orders, setOrders] = useState([]);
+    const [total, setTotal] = useState(0);
+    const [page, setPage] = useState(1);
+    const [isLoading, setIsLoading] = useState(false);
+    const [error, setError] = useState(null);
+    const fetchOrders = useCallback(async (options = {}) => {
+        const { status, page: pageNum = 1, limit = 20 } = options;
+        setIsLoading(true);
+        setError(null);
+        const params = new URLSearchParams();
+        if (status)
+            params.set('status', status);
+        params.set('page', pageNum.toString());
+        params.set('limit', limit.toString());
+        const res = await fetchAdminApi(`/api/admin/orders?${params.toString()}`);
+        setIsLoading(false);
+        if (!res.ok) {
+            setError(res.error);
+            return;
+        }
+        setOrders(res.data.data || []);
+        setTotal(res.data.total || 0);
+        setPage(res.data.page || 1);
+    }, []);
+    const updateStatus = useCallback(async (orderId, status, notifyCustomer = true, trackingInfo) => {
+        const res = await fetchAdminApi(`/api/admin/orders/${orderId}`, {
+            method: 'PUT',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({
+                status,
+                notifyCustomer,
+                ...trackingInfo,
+            }),
+        });
+        if (!res.ok) {
+            setError(res.error);
+            return { success: false, error: res.error };
+        }
+        setError(null);
+        return { success: true };
+    }, []);
+    const processRefund = useCallback(async (orderId, amount, reason) => {
+        const res = await fetchAdminApi(`/api/admin/orders/${orderId}/refund`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({
+                amount,
+                reason,
+                notifyCustomer: true,
+            }),
+        });
+        if (!res.ok) {
+            return { success: false, error: res.error };
+        }
+        return { success: true, refundId: res.data.refundId };
+    }, []);
+    const getOrder = useCallback(async (orderId) => {
+        const res = await fetchAdminApi(`/api/admin/orders/${orderId}`);
+        if (!res.ok) {
+            setError(res.error);
+            return null;
+        }
+        return res.data.data;
+    }, []);
+    const approveReturn = useCallback(async (orderId, notifyCustomer = true) => {
+        const res = await fetchAdminApi(`/api/admin/orders/${orderId}/return/approve`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ notifyCustomer }),
+        });
+        if (!res.ok) {
+            return { success: false, error: res.error };
+        }
+        return {
+            success: true,
+            refundId: res.data.refundId,
+            message: res.data.message,
+        };
+    }, []);
+    const rejectReturn = useCallback(async (orderId, reason, notifyCustomer = true) => {
+        const res = await fetchAdminApi(`/api/admin/orders/${orderId}/return/reject`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ reason, notifyCustomer }),
+        });
+        if (!res.ok) {
+            return { success: false, error: res.error };
+        }
+        return { success: true, message: res.data.message };
+    }, []);
+    return {
+        orders,
+        total,
+        page,
+        isLoading,
+        error,
+        fetchOrders,
+        updateStatus,
+        processRefund,
+        getOrder,
+        approveReturn,
+        rejectReturn,
+    };
+}
+//# sourceMappingURL=useAdminOrders.js.map

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

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"useAdminPermissions.d.ts","sourceRoot":"","sources":["../../../src/admin/hooks/useAdminPermissions.ts"],"names":[],"mappings":"AAuCA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,UAAU,CAAA;AAMzD,wBAAgB,mBAAmB,IAAI,yBAAyB,CA8B/D"}

package/dist/admin/hooks/useAdminPermissions.js

@@ -0,0 +1,51 @@
+'use client';
+/**
+ * @rovela/sdk/admin/hooks/useAdminPermissions
+ *
+ * Client-side permission helpers. Pure wrapper around `admin/permissions.ts`
+ * that reads the current admin's role from `useAdminAuth`.
+ *
+ * No network calls — permissions are a function of the JWT already in memory,
+ * so this hook is cheap and synchronous once the session has loaded.
+ *
+ * Server-side is still the source of truth; this hook exists purely for UI
+ * gating (hide/disable buttons the user couldn't use anyway).
+ *
+ * @example
+ * ```tsx
+ * function UsersPage() {
+ *   const { can, canManageUser, isOwner } = useAdminPermissions()
+ *   if (!can('users.read')) return <NoAccess />
+ *
+ *   return users.map(u => (
+ *     <Row
+ *       user={u}
+ *       canDelete={isOwner && canManageUser(u)}
+ *       canDeactivate={canManageUser(u)}
+ *     />
+ *   ))
+ * }
+ * ```
+ */
+import { useMemo, useCallback } from 'react';
+import { useAdminAuth } from './useAdminAuth';
+import { hasPermission, canManageUser as canManageUserCore, } from '../permissions';
+// =============================================================================
+// Hook
+// =============================================================================
+export function useAdminPermissions() {
+    const { admin } = useAdminAuth();
+    const role = (admin?.role ?? null);
+    const isOwner = role === 'owner';
+    const isAdministrator = role === 'administrator';
+    const can = useCallback((permission) => {
+        return hasPermission(role, permission);
+    }, [role]);
+    const canManageUser = useCallback((target) => {
+        if (!admin)
+            return false;
+        return canManageUserCore({ id: admin.id, role: admin.role }, target);
+    }, [admin]);
+    return useMemo(() => ({ role, isOwner, isAdministrator, can, canManageUser }), [role, isOwner, isAdministrator, can, canManageUser]);
+}
+//# sourceMappingURL=useAdminPermissions.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useAdminPermissions.js","sourceRoot":"","sources":["../../../src/admin/hooks/useAdminPermissions.ts"],"names":[],"mappings":"AAAA,YAAY,CAAA;AAEZ;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAA;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAC7C,OAAO,EACL,aAAa,EACb,aAAa,IAAI,iBAAiB,GAEnC,MAAM,gBAAgB,CAAA;AAIvB,gFAAgF;AAChF,OAAO;AACP,gFAAgF;AAEhF,MAAM,UAAU,mBAAmB;IACjC,MAAM,EAAE,KAAK,EAAE,GAAG,YAAY,EAAE,CAAA;IAEhC,MAAM,IAAI,GAAG,CAAC,KAAK,EAAE,IAAI,IAAI,IAAI,CAAqB,CAAA;IAEtD,MAAM,OAAO,GAAG,IAAI,KAAK,OAAO,CAAA;IAChC,MAAM,eAAe,GAAG,IAAI,KAAK,eAAe,CAAA;IAEhD,MAAM,GAAG,GAAG,WAAW,CACrB,CAAC,UAAsB,EAAW,EAAE;QAClC,OAAO,aAAa,CAAC,IAAI,EAAE,UAAU,CAAC,CAAA;IACxC,CAAC,EACD,CAAC,IAAI,CAAC,CACP,CAAA;IAED,MAAM,aAAa,GAAG,WAAW,CAC/B,CAAC,MAAuC,EAAW,EAAE;QACnD,IAAI,CAAC,KAAK;YAAE,OAAO,KAAK,CAAA;QACxB,OAAO,iBAAiB,CACtB,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAiB,EAAE,EAC/C,MAAM,CACP,CAAA;IACH,CAAC,EACD,CAAC,KAAK,CAAC,CACR,CAAA;IAED,OAAO,OAAO,CACZ,GAAG,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,eAAe,EAAE,GAAG,EAAE,aAAa,EAAE,CAAC,EAC9D,CAAC,IAAI,EAAE,OAAO,EAAE,eAAe,EAAE,GAAG,EAAE,aAAa,CAAC,CACrD,CAAA;AACH,CAAC"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"useAdminProductMetrics.d.ts","sourceRoot":"","sources":["../../../src/admin/hooks/useAdminProductMetrics.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAkB,4BAA4B,EAAE,MAAM,UAAU,CAAA;AAE5E,wBAAgB,sBAAsB,IAAI,4BAA4B,CAwBrE"}

package/dist/admin/hooks/useAdminProductMetrics.js

@@ -0,0 +1,32 @@
+'use client';
+/**
+ * @rovela/sdk/admin/hooks/useAdminProductMetrics
+ *
+ * Fetches the three metrics shown above the admin product list table:
+ *   - Active product count
+ *   - Out-of-stock count (active-scoped)
+ *   - Best seller (last 30 days, by units)
+ *
+ * Single round-trip via `GET /api/admin/products/stats`. Refresh after any
+ * bulk action that changes counts (activate / archive / delete).
+ */
+import { useState, useCallback } from 'react';
+import { fetchAdminApi } from './fetchAdminApi';
+export function useAdminProductMetrics() {
+    const [metrics, setMetrics] = useState(null);
+    const [isLoading, setIsLoading] = useState(false);
+    const [error, setError] = useState(null);
+    const fetchMetrics = useCallback(async () => {
+        setIsLoading(true);
+        setError(null);
+        const res = await fetchAdminApi('/api/admin/products/stats');
+        setIsLoading(false);
+        if (!res.ok) {
+            setError(res.error);
+            return;
+        }
+        setMetrics(res.data.data);
+    }, []);
+    return { metrics, isLoading, error, fetchMetrics };
+}
+//# sourceMappingURL=useAdminProductMetrics.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useAdminProductMetrics.js","sourceRoot":"","sources":["../../../src/admin/hooks/useAdminProductMetrics.ts"],"names":[],"mappings":"AAAA,YAAY,CAAA;AAEZ;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,OAAO,CAAA;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAG/C,MAAM,UAAU,sBAAsB;IACpC,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAwB,IAAI,CAAC,CAAA;IACnE,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,YAAY,GAAG,WAAW,CAAC,KAAK,IAAmB,EAAE;QACzD,YAAY,CAAC,IAAI,CAAC,CAAA;QAClB,QAAQ,CAAC,IAAI,CAAC,CAAA;QAEd,MAAM,GAAG,GAAG,MAAM,aAAa,CAC7B,2BAA2B,CAC5B,CAAA;QAED,YAAY,CAAC,KAAK,CAAC,CAAA;QAEnB,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;YACnB,OAAM;QACR,CAAC;QAED,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC3B,CAAC,EAAE,EAAE,CAAC,CAAA;IAEN,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,YAAY,EAAE,CAAA;AACpD,CAAC"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"useAdminProducts.d.ts","sourceRoot":"","sources":["../../../src/admin/hooks/useAdminProducts.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAIV,sBAAsB,EAKvB,MAAM,UAAU,CAAA;AAMjB,wBAAgB,gBAAgB,IAAI,sBAAsB,CAsLzD"}

package/dist/admin/hooks/useAdminProducts.js

@@ -0,0 +1,132 @@
+'use client';
+/**
+ * @rovela/sdk/admin/hooks/useAdminProducts
+ *
+ * Product management hook for admin panel. All HTTP calls go through
+ * `fetchAdminApi` which returns a discriminated union instead of throwing
+ * on non-ok responses — that keeps expected 403/404 from surfacing as
+ * Next.js dev overlays and ensures callers receive specific server error
+ * messages (including the friendly "You don't have permission to do this."
+ * translation for curt 403 responses).
+ */
+import { useState, useCallback } from 'react';
+import { fetchAdminApi } from './fetchAdminApi';
+// =============================================================================
+// Hook Implementation
+// =============================================================================
+export function useAdminProducts() {
+    const [products, setProducts] = useState([]);
+    const [total, setTotal] = useState(0);
+    const [page, setPage] = useState(1);
+    const [isLoading, setIsLoading] = useState(false);
+    const [error, setError] = useState(null);
+    const fetchProducts = useCallback(async (options = {}) => {
+        const { search, category, status, sort = 'newest', page: pageNum = 1, limit = 20, } = options;
+        setIsLoading(true);
+        setError(null);
+        const params = new URLSearchParams();
+        if (search)
+            params.set('search', search);
+        if (category)
+            params.set('category', category);
+        if (status)
+            params.set('status', status);
+        if (options.outOfStock)
+            params.set('outOfStock', 'true');
+        params.set('sort', sort);
+        params.set('page', pageNum.toString());
+        params.set('limit', limit.toString());
+        const res = await fetchAdminApi(`/api/admin/products?${params.toString()}`);
+        setIsLoading(false);
+        if (!res.ok) {
+            setError(res.error);
+            return;
+        }
+        setProducts(res.data.data || []);
+        setTotal(res.data.total || 0);
+        setPage(res.data.page || 1);
+    }, []);
+    const getProduct = useCallback(async (id) => {
+        const res = await fetchAdminApi(`/api/admin/products/${id}`);
+        if (!res.ok) {
+            setError(res.error);
+            return null;
+        }
+        return res.data.data;
+    }, []);
+    const createProduct = useCallback(async (data) => {
+        const res = await fetchAdminApi('/api/admin/products', {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify(data),
+        });
+        if (!res.ok) {
+            return { success: false, error: res.error };
+        }
+        return { success: true, data: res.data.data };
+    }, []);
+    const updateProduct = useCallback(async (id, data) => {
+        const res = await fetchAdminApi(`/api/admin/products/${id}`, {
+            method: 'PUT',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify(data),
+        });
+        if (!res.ok) {
+            return { success: false, error: res.error };
+        }
+        return { success: true, data: res.data.data };
+    }, []);
+    const deleteProduct = useCallback(async (id) => {
+        const res = await fetchAdminApi(`/api/admin/products/${id}`, {
+            method: 'DELETE',
+        });
+        if (!res.ok) {
+            setError(res.error);
+            return { success: false, error: res.error };
+        }
+        setError(null);
+        return { success: true };
+    }, []);
+    const updateVariant = useCallback(async (productId, variantId, data) => {
+        const res = await fetchAdminApi(`/api/admin/products/${productId}/variants/${variantId}`, {
+            method: 'PUT',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify(data),
+        });
+        if (!res.ok) {
+            return { success: false, error: res.error };
+        }
+        return { success: true, data: res.data.data };
+    }, []);
+    const bulkAction = useCallback(async (ids, action) => {
+        const res = await fetchAdminApi('/api/admin/products/bulk', {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ ids, action }),
+        });
+        if (!res.ok) {
+            // Network or 4xx/5xx — surface the friendly error on every id so the
+            // caller can show a single failure toast instead of branching.
+            return {
+                succeeded: [],
+                failed: ids.map((id) => ({ id, error: res.error })),
+            };
+        }
+        return res.data;
+    }, []);
+    return {
+        products,
+        total,
+        page,
+        isLoading,
+        error,
+        fetchProducts,
+        getProduct,
+        createProduct,
+        updateProduct,
+        deleteProduct,
+        updateVariant,
+        bulkAction,
+    };
+}
+//# sourceMappingURL=useAdminProducts.js.map

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

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

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

@@ -0,0 +1,23 @@
+export type AdminSessionStatus = 'loading' | 'authenticated' | 'unauthenticated';
+/**
+ * Shape returned by `/api/admin-auth/session` when an admin is signed in.
+ * This mirrors the session.user shape the admin JWT session callback writes.
+ */
+export interface AdminSessionPayload {
+    user: {
+        id: string;
+        email: string;
+        name: string;
+        role: 'owner' | 'admin' | 'administrator' | 'manager' | 'user';
+        sessionVersion?: number;
+    };
+    expires?: string;
+}
+export interface UseAdminSessionReturn {
+    data: AdminSessionPayload | null;
+    status: AdminSessionStatus;
+    /** Re-fetch the session from the server. Returns the new session (or null). */
+    update: () => Promise<AdminSessionPayload | null>;
+}
+export declare function useAdminSession(): UseAdminSessionReturn;
+//# sourceMappingURL=useAdminSession.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useAdminSession.d.ts","sourceRoot":"","sources":["../../../src/admin/hooks/useAdminSession.ts"],"names":[],"mappings":"AAoDA,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,eAAe,GAAG,iBAAiB,CAAA;AAEhF;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE;QACJ,EAAE,EAAE,MAAM,CAAA;QACV,KAAK,EAAE,MAAM,CAAA;QACb,IAAI,EAAE,MAAM,CAAA;QACZ,IAAI,EAAE,OAAO,GAAG,OAAO,GAAG,eAAe,GAAG,SAAS,GAAG,MAAM,CAAA;QAC9D,cAAc,CAAC,EAAE,MAAM,CAAA;KACxB,CAAA;IACD,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,mBAAmB,GAAG,IAAI,CAAA;IAChC,MAAM,EAAE,kBAAkB,CAAA;IAC1B,+EAA+E;IAC/E,MAAM,EAAE,MAAM,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CAAA;CAClD;AAYD,wBAAgB,eAAe,IAAI,qBAAqB,CAiEvD"}

package/dist/admin/hooks/useAdminSession.js

@@ -0,0 +1,117 @@
+'use client';
+/**
+ * @rovela-ai/sdk/admin/hooks/useAdminSession
+ *
+ * Self-contained admin session hook — completely independent from the
+ * `next-auth/react` `<SessionProvider>` tree.
+ *
+ * # Why it exists
+ *
+ * Customer auth (`useSession` from `next-auth/react`) and admin auth both
+ * run on the same page domain but live in separate cookie jars (customer
+ * cookie vs admin cookie). NextAuth v4's client-side `useSession()`
+ * reads from a module-global `__NEXTAUTH` object whose `basePath` can be
+ * only one value at a time — making it impossible to have TWO live
+ * `<SessionProvider basePath>` trees reliably.
+ *
+ * The solution: admin pages don't need `<SessionProvider>` at all. This
+ * hook fetches `/api/admin-auth/session` directly, matching the shape of
+ * NextAuth's `useSession()` return value so `useAdminAuth` (and other
+ * consumers like `AdminBarBanner`) can use it as a drop-in replacement.
+ *
+ * The customer `<SessionProvider>` at the storefront root keeps reading
+ * the customer cookie as normal — the two systems don't touch each other.
+ *
+ * # Return contract
+ *
+ * ```ts
+ * const { data, status, update } = useAdminSession()
+ * // status: 'loading' | 'authenticated' | 'unauthenticated'
+ * // data:   AdminSessionPayload | null
+ * // update(): re-fetches from the server
+ * ```
+ *
+ * # Polling
+ *
+ * Re-fetches on:
+ *   - Mount
+ *   - Window focus (matches NextAuth default `refetchOnWindowFocus`)
+ *   - `update()` imperative call (after sign-in/out)
+ *
+ * No interval polling — the admin UI doesn't need real-time session
+ * refresh beyond what focus/mount already provide, and polling costs
+ * a fetch per tab every N seconds across the whole fleet.
+ */
+import { useCallback, useEffect, useRef, useState } from 'react';
+// =============================================================================
+// Constants
+// =============================================================================
+const ADMIN_SESSION_URL = '/api/admin-auth/session';
+// =============================================================================
+// Hook
+// =============================================================================
+export function useAdminSession() {
+    const [data, setData] = useState(null);
+    const [status, setStatus] = useState('loading');
+    const mountedRef = useRef(true);
+    const fetchSession = useCallback(async () => {
+        try {
+            const res = await fetch(ADMIN_SESSION_URL, {
+                credentials: 'include',
+                headers: { Accept: 'application/json' },
+            });
+            if (!res.ok) {
+                if (!mountedRef.current)
+                    return null;
+                setData(null);
+                setStatus('unauthenticated');
+                return null;
+            }
+            const json = (await res.json());
+            const hasUser = !!(json && json.user?.id);
+            if (!mountedRef.current)
+                return hasUser ? json : null;
+            if (hasUser) {
+                const payload = json;
+                setData(payload);
+                setStatus('authenticated');
+                return payload;
+            }
+            setData(null);
+            setStatus('unauthenticated');
+            return null;
+        }
+        catch {
+            if (!mountedRef.current)
+                return null;
+            setData(null);
+            setStatus('unauthenticated');
+            return null;
+        }
+    }, []);
+    // Initial fetch on mount + refetch on window focus
+    useEffect(() => {
+        mountedRef.current = true;
+        void fetchSession();
+        const onFocus = () => {
+            // Don't thrash: only re-fetch if we're already authenticated or known
+            // unauthenticated. Skip during a still-loading initial fetch.
+            if (mountedRef.current && status !== 'loading') {
+                void fetchSession();
+            }
+        };
+        window.addEventListener('focus', onFocus);
+        return () => {
+            mountedRef.current = false;
+            window.removeEventListener('focus', onFocus);
+        };
+        // Intentionally only depend on fetchSession: we want focus behavior
+        // to reflect the *current* session state without re-subscribing.
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [fetchSession]);
+    const update = useCallback(async () => {
+        return fetchSession();
+    }, [fetchSession]);
+    return { data, status, update };
+}
+//# sourceMappingURL=useAdminSession.js.map

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

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

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

@@ -0,0 +1,47 @@
+import type { DashboardPeriod, UseAdminStatsReturn } from '../types';
+interface StatsOptions {
+    /** Include revenue by day data */
+    includeRevenue?: boolean;
+    /** Include order status breakdown */
+    includeOrderStatus?: boolean;
+    /** Low stock threshold (default 10) */
+    lowStockThreshold?: number;
+    /** Number of recent orders to fetch (default 5) */
+    recentOrdersLimit?: number;
+    /** Auto-fetch on mount (default true) */
+    autoFetch?: boolean;
+    /**
+     * Time window for the period-scoped summary (AOV, refund rate, deltas,
+     * best seller). When set, the API computes the summary in parallel and
+     * returns it in `summary`. When unset, `summary` stays null.
+     */
+    period?: DashboardPeriod;
+}
+/**
+ * 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 declare function useAdminStats(options?: StatsOptions): UseAdminStatsReturn;
+export {};
+//# sourceMappingURL=useAdminStats.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useAdminStats.d.ts","sourceRoot":"","sources":["../../../src/admin/hooks/useAdminStats.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAEV,eAAe,EAMf,mBAAmB,EACpB,MAAM,UAAU,CAAA;AAMjB,UAAU,YAAY;IACpB,kCAAkC;IAClC,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,qCAAqC;IACrC,kBAAkB,CAAC,EAAE,OAAO,CAAA;IAC5B,uCAAuC;IACvC,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,mDAAmD;IACnD,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,yCAAyC;IACzC,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB;;;;OAIG;IACH,MAAM,CAAC,EAAE,eAAe,CAAA;CACzB;AAMD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,aAAa,CAAC,OAAO,GAAE,YAAiB,GAAG,mBAAmB,CAoH7E"}