@classytic/commerce-sdk 0.1.1 → 0.2.1

package/dist/sales/hooks/loyalty.js

@@ -0,0 +1,122 @@
+"use client";
+
+import { useMutationWithTransition } from "../../core/react/mutation.factory.js";
+import { loyaltyApi } from "../api/loyalty.js";
+import { useQuery } from "@tanstack/react-query";
+
+//#region src/sales/hooks/loyalty.ts
+/**
+* Loyalty Hooks
+*
+* React hooks for loyalty program operations.
+*/
+const LOYALTY_KEYS = {
+	all: ["loyalty"],
+	members: () => [...LOYALTY_KEYS.all, "members"],
+	member: (customerId) => [...LOYALTY_KEYS.members(), customerId],
+	history: (customerId) => [...LOYALTY_KEYS.member(customerId), "history"],
+	me: () => [...LOYALTY_KEYS.all, "me"]
+};
+/** Get loyalty member details + balance for a customer */
+function useLoyaltyMember(customerId, options = {}) {
+	return useQuery({
+		queryKey: LOYALTY_KEYS.member(customerId),
+		queryFn: async () => {
+			return (await loyaltyApi.getMember({ customerId })).data;
+		},
+		enabled: !!customerId && options.enabled !== false,
+		staleTime: options.staleTime ?? 3e4
+	});
+}
+/** Get points transaction history for a customer */
+function useLoyaltyHistory(customerId, params = {}, options = {}) {
+	return useQuery({
+		queryKey: [...LOYALTY_KEYS.history(customerId), params],
+		queryFn: async () => {
+			return (await loyaltyApi.getHistory({
+				customerId,
+				params
+			})).data;
+		},
+		enabled: !!customerId && options.enabled !== false,
+		staleTime: options.staleTime ?? 15e3
+	});
+}
+/** Loyalty admin actions (enroll, adjust, deactivate, reactivate) */
+function useLoyaltyActions() {
+	const invalidateQueries = [LOYALTY_KEYS.all, ["customers"]];
+	const enrollMutation = useMutationWithTransition({
+		mutationFn: (customerId) => loyaltyApi.enroll({ data: { customerId } }),
+		invalidateQueries,
+		messages: {
+			success: "Enrolled in loyalty program",
+			error: "Failed to enroll"
+		}
+	});
+	const adjustMutation = useMutationWithTransition({
+		mutationFn: ({ customerId, data }) => loyaltyApi.adjustPoints({
+			customerId,
+			data
+		}),
+		invalidateQueries,
+		messages: {
+			success: "Points adjusted",
+			error: "Failed to adjust points"
+		}
+	});
+	const deactivateMutation = useMutationWithTransition({
+		mutationFn: (customerId) => loyaltyApi.deactivate({ customerId }),
+		invalidateQueries,
+		messages: {
+			success: "Membership deactivated",
+			error: "Failed to deactivate"
+		}
+	});
+	const reactivateMutation = useMutationWithTransition({
+		mutationFn: (customerId) => loyaltyApi.reactivate({ customerId }),
+		invalidateQueries,
+		messages: {
+			success: "Membership reactivated",
+			error: "Failed to reactivate"
+		}
+	});
+	return {
+		enroll: enrollMutation.mutateAsync,
+		adjustPoints: (customerId, data) => adjustMutation.mutateAsync({
+			customerId,
+			data
+		}),
+		deactivate: deactivateMutation.mutateAsync,
+		reactivate: reactivateMutation.mutateAsync,
+		isPending: enrollMutation.isPending || adjustMutation.isPending || deactivateMutation.isPending || reactivateMutation.isPending
+	};
+}
+/** Get my loyalty status (customer-facing) */
+function useMyLoyalty(options = {}) {
+	return useQuery({
+		queryKey: LOYALTY_KEYS.me(),
+		queryFn: async () => {
+			return (await loyaltyApi.getMyStatus()).data;
+		},
+		enabled: options.enabled !== false,
+		staleTime: options.staleTime ?? 6e4
+	});
+}
+/** Self-enroll in loyalty program */
+function useSelfEnroll() {
+	const mutation = useMutationWithTransition({
+		mutationFn: () => loyaltyApi.selfEnroll(),
+		invalidateQueries: [LOYALTY_KEYS.all, ["customers"]],
+		messages: {
+			success: "Welcome to the rewards program!",
+			error: "Failed to enroll"
+		}
+	});
+	return {
+		selfEnroll: mutation.mutateAsync,
+		isPending: mutation.isPending
+	};
+}
+
+//#endregion
+export { LOYALTY_KEYS, useLoyaltyActions, useLoyaltyHistory, useLoyaltyMember, useMyLoyalty, useSelfEnroll };

package/dist/sales/hooks/order.d.ts

@@ -0,0 +1,219 @@
+import { CreateOrderPayload, FulfillOrderPayload, GuestCheckoutPayload, Order, OrderShipping, RequestShippingPayload, UpdateShippingPayload } from "../types/order.js";
+import * as _tanstack_react_query0 from "@tanstack/react-query";
+import * as _classytic_arc_next_query0 from "@classytic/arc-next/query";
+import * as _classytic_arc_next0 from "@classytic/arc-next";
+
+//#region src/sales/hooks/order.d.ts
+/**
+ * Order hooks using createCrudHooks factory
+ *
+ * Provides:
+ * - useOrders: List orders with filtering/pagination
+ * - useOrderDetail: Get single order
+ * - useOrderActions: Create, update, delete mutations
+ * - useOrderNavigation: Navigation between orders
+ */
+declare const orderHooks: _classytic_arc_next0.CrudHooksReturn<Order, CreateOrderPayload, Partial<Order>>;
+declare const ORDER_KEYS: {
+  all: readonly ["orders"];
+  lists: () => readonly ["orders", "list"];
+  list: (params?: Record<string, unknown>) => readonly ["orders", "list", Record<string, unknown> | undefined];
+  details: () => readonly ["orders", "detail"];
+  detail: (id: string) => readonly ["orders", "detail", string];
+  myOrders: (params?: Record<string, unknown>) => readonly ["orders", "my", Record<string, unknown> | undefined];
+  myDetail: (id: string) => readonly ["orders", "my", "detail", string];
+};
+declare const useOrders: {
+    (params?: Record<string, unknown>, options?: _classytic_arc_next_query0.ListQueryOptions<Order> | undefined): _classytic_arc_next_query0.ListQueryResult<Order>;
+    (token: string | null, params?: Record<string, unknown>, options?: _classytic_arc_next_query0.ListQueryOptions<Order> | undefined): _classytic_arc_next_query0.ListQueryResult<Order>;
+  }, useOrderDetail: {
+    (id: string | null, options?: _classytic_arc_next_query0.DetailQueryOptions<Order> | undefined): _classytic_arc_next_query0.DetailQueryResult<Order>;
+    (id: string | null, token: string | null, options?: _classytic_arc_next_query0.DetailQueryOptions<Order> | undefined): _classytic_arc_next_query0.DetailQueryResult<Order>;
+  }, useOrderActions: () => _classytic_arc_next0.CrudActions<Order, CreateOrderPayload, Partial<Order>>, useOrderNavigation: () => _classytic_arc_next0.NavigateFn<Order>;
+interface QueryOptions {
+  enabled?: boolean;
+  staleTime?: number;
+}
+interface UseMyOrdersReturn {
+  orders: Order[];
+  total: number;
+  page: number;
+  limit: number;
+  hasMore: boolean;
+  isLoading: boolean;
+  isFetching: boolean;
+  error: Error | null;
+  refetch: () => void;
+}
+interface UseCustomerOrderActionsReturn {
+  checkout: (data: CreateOrderPayload) => Promise<Order>;
+  isCheckingOut: boolean;
+  requestCancel: (params: {
+    orderId: string;
+    reason?: string;
+  }) => Promise<Order>;
+  isRequestingCancel: boolean;
+  isLoading: boolean;
+}
+interface UseAdminOrderActionsReturn {
+  updateStatus: (params: {
+    orderId: string;
+    status: string;
+    note?: string;
+  }) => Promise<Order>;
+  isUpdatingStatus: boolean;
+  fulfillOrder: (params: FulfillOrderPayload & {
+    orderId: string;
+  }) => Promise<Order>;
+  isFulfilling: boolean;
+  refundOrder: (params: {
+    orderId: string;
+    amount?: number;
+    reason?: string;
+  }) => Promise<Order>;
+  isRefunding: boolean;
+  cancelOrder: (params: {
+    orderId: string;
+    reason?: string;
+    refund?: boolean;
+  }) => Promise<Order>;
+  isCancelling: boolean;
+  requestShipping: (params: RequestShippingPayload & {
+    orderId: string;
+  }) => Promise<OrderShipping>;
+  isRequestingShipping: boolean;
+  updateShipping: (params: UpdateShippingPayload & {
+    orderId: string;
+  }) => Promise<OrderShipping>;
+  isUpdatingShipping: boolean;
+  isLoading: boolean;
+}
+/**
+ * Get customer's own orders
+ *
+ * @param token - Auth token
+ * @param params - Query params { page, limit, status, sort }
+ * @param options - Query options
+ *
+ * @example
+ * ```tsx
+ * function MyOrdersPage() {
+ *   const { orders, isLoading, hasMore } = useMyOrders(token, { limit: 10 });
+ *
+ *   return (
+ *     <OrderList orders={orders} loading={isLoading} />
+ *   );
+ * }
+ * ```
+ */
+declare function useMyOrders(token: string, params?: Record<string, unknown>, options?: QueryOptions): UseMyOrdersReturn;
+/**
+ * Get customer's own order detail
+ *
+ * @param token - Auth token
+ * @param orderId - Order ID
+ * @param options - Query options
+ *
+ * @example
+ * ```tsx
+ * function OrderDetailPage({ orderId }) {
+ *   const { data: order, isLoading } = useMyOrderDetail(token, orderId);
+ *
+ *   if (isLoading) return <Skeleton />;
+ *   return <OrderDetail order={order} />;
+ * }
+ * ```
+ */
+declare function useMyOrderDetail(token: string, orderId: string, options?: QueryOptions): _tanstack_react_query0.UseQueryResult<Order, Error>;
+/**
+ * Customer order actions (checkout, request cancellation)
+ *
+ * @param token - Customer auth token
+ *
+ * @example
+ * ```tsx
+ * function CheckoutButton({ cart }) {
+ *   const { checkout, isCheckingOut } = useCustomerOrderActions(token);
+ *
+ *   const handleCheckout = async () => {
+ *     const order = await checkout({
+ *       items: cart.items,
+ *       shipping: shippingAddress,
+ *       payment: { method: 'bkash' },
+ *     });
+ *     router.push(`/orders/${order._id}`);
+ *   };
+ *
+ *   return (
+ *     <Button onClick={handleCheckout} disabled={isCheckingOut}>
+ *       {isCheckingOut ? 'Processing...' : 'Place Order'}
+ *     </Button>
+ *   );
+ * }
+ * ```
+ */
+declare function useCustomerOrderActions(token: string): UseCustomerOrderActionsReturn;
+interface UseGuestCheckoutReturn {
+  guestCheckout: (data: GuestCheckoutPayload) => Promise<Order>;
+  isCheckingOut: boolean;
+}
+/**
+ * Guest checkout mutation (no auth required)
+ *
+ * For unauthenticated users. Items are sent from FE localStorage.
+ *
+ * @example
+ * ```tsx
+ * function GuestCheckoutButton({ cartItems, guestInfo, address }) {
+ *   const { guestCheckout, isCheckingOut } = useGuestCheckout();
+ *
+ *   const handleCheckout = async () => {
+ *     const order = await guestCheckout({
+ *       items: cartItems,
+ *       guest: guestInfo,
+ *       deliveryAddress: address,
+ *       delivery: { method: 'standard', price: 80 },
+ *     });
+ *     router.push(`/order-confirmation/${order._id}`);
+ *   };
+ *
+ *   return (
+ *     <Button onClick={handleCheckout} disabled={isCheckingOut}>
+ *       {isCheckingOut ? 'Processing...' : 'Place Order'}
+ *     </Button>
+ *   );
+ * }
+ * ```
+ */
+declare function useGuestCheckout(): UseGuestCheckoutReturn;
+/**
+ * Admin order actions (status, fulfill, refund, cancel, shipping)
+ *
+ * @param token - Admin auth token
+ *
+ * @example
+ * ```tsx
+ * function OrderActions({ order }) {
+ *   const {
+ *     updateStatus,
+ *     fulfillOrder,
+ *     cancelOrder,
+ *     isLoading,
+ *   } = useAdminOrderActions(token);
+ *
+ *   return (
+ *     <>
+ *       <Button onClick={() => updateStatus({ orderId: order._id, status: 'processing' })}>
+ *         Mark Processing
+ *       </Button>
+ *       <Button onClick={() => fulfillOrder({ orderId: order._id, branchId: 'branch_123' })}>
+ *         Fulfill Order
+ *       </Button>
+ *     </>
+ *   );
+ * }
+ * ```
+ */
+declare function useAdminOrderActions(token: string): UseAdminOrderActionsReturn;
+//#endregion
+export { ORDER_KEYS, UseAdminOrderActionsReturn, UseCustomerOrderActionsReturn, UseGuestCheckoutReturn, UseMyOrdersReturn, orderHooks, useAdminOrderActions, useCustomerOrderActions, useGuestCheckout, useMyOrderDetail, useMyOrders, useOrderActions, useOrderDetail, useOrderNavigation, useOrders };