@classytic/commerce-sdk 0.1.2 → 0.2.1

package/dist/chunk-2YAZ5WG6.js

@@ -1,479 +0,0 @@
-import { BaseApi } from './chunk-QCTXAMLA.js';
-import { getToastHandler } from './chunk-U3XT35GZ.js';
-import { handleApiRequest } from './chunk-IHCBBLLW.js';
-import { useQuery, useQueryClient, useMutation } from '@tanstack/react-query';
-
-// src/logistics/api/logistics.ts
-var LogisticsApi = class extends BaseApi {
-  constructor(config = {}) {
-    super("logistics", config);
-  }
-  // ============================================
-  // CHARGE CALCULATION (Public)
-  // ============================================
-  /**
-   * Calculate delivery charge via provider API (e.g., RedX)
-   * GET /logistics/charge
-   *
-   * Use this to get real-time delivery charges from the logistics provider
-   * before creating an order.
-   *
-   * @param deliveryAreaId - Area internalId from @classytic/bd-areas
-   * @param amount - COD amount in BDT (use 0 for prepaid orders)
-   * @param weight - Parcel weight in grams (default: 500g)
-   *
-   * @example
-   * import { searchAreas } from '@classytic/bd-areas';
-   *
-   * // 1. User selects area
-   * const areas = searchAreas('mohamm');
-   * const selectedArea = areas[0]; // { internalId: 1206, name: 'Mohammadpur', ... }
-   *
-   * // 2. Calculate delivery charge
-   * const { data } = await logisticsApi.calculateCharge({
-   *   deliveryAreaId: selectedArea.internalId,
-   *   amount: isCOD ? cartTotal : 0,
-   * });
-   * // { deliveryCharge: 60, codCharge: 15, totalCharge: 75 }
-   */
-  async calculateCharge({
-    deliveryAreaId,
-    pickupAreaId,
-    amount,
-    weight,
-    provider,
-    options = {}
-  }) {
-    if (!deliveryAreaId || amount === void 0) {
-      throw new Error("deliveryAreaId and amount are required");
-    }
-    const queryString = this.createQueryString({
-      deliveryAreaId,
-      pickupAreaId,
-      amount,
-      weight,
-      provider
-    });
-    return handleApiRequest("GET", `${this.baseUrl}/charge?${queryString}`, {
-      cache: "no-store",
-      ...options
-    });
-  }
-  // ============================================
-  // CONFIG ENDPOINTS (Admin - Read-only)
-  // ============================================
-  /**
-   * Get logistics configuration (read-only from .env)
-   * GET /logistics/config
-   *
-   * NOTE: Configuration is managed via environment variables.
-   * To change settings, update .env file and restart server.
-   */
-  async getConfig({
-    token,
-    options = {}
-  }) {
-    return handleApiRequest("GET", `${this.baseUrl}/config`, {
-      token,
-      cache: "no-store",
-      ...options
-    });
-  }
-  // ============================================
-  // PICKUP STORES (Admin)
-  // ============================================
-  /**
-   * Get pickup stores from RedX API
-   * GET /logistics/pickup-stores
-   *
-   * Pickup stores are created by admin in RedX dashboard.
-   * Use this to list available pickup locations when creating shipments.
-   *
-   * @example
-   * // Admin: List pickup stores for shipment creation
-   * const { data: stores } = await logisticsApi.getPickupStores({ token });
-   *
-   * // Display in dropdown for admin to select
-   * stores.forEach(store => {
-   *   console.log(`${store.name} - ${store.areaName} (ID: ${store.id})`);
-   * });
-   *
-   * // Use selected store when creating shipment
-   * await logisticsApi.createShipment({
-   *   token,
-   *   data: {
-   *     orderId: order._id,
-   *     pickupStoreId: selectedStore.id,  // From dropdown
-   *   },
-   * });
-   */
-  async getPickupStores({
-    token,
-    provider,
-    options = {}
-  }) {
-    const queryString = provider ? `?provider=${provider}` : "";
-    return handleApiRequest(
-      "GET",
-      `${this.baseUrl}/pickup-stores${queryString}`,
-      {
-        token,
-        cache: "no-store",
-        ...options
-      }
-    );
-  }
-  // ============================================
-  // SHIPPING ENDPOINTS (Admin/Store Manager)
-  // ============================================
-  /**
-   * Request shipping for an order (manual or provider API)
-   * POST /orders/:id/shipping
-   *
-   * This updates the order.shipping object and optionally triggers
-   * provider API shipment creation when useProviderApi=true.
-   *
-   * @example
-   * // Manual: Record tracking details
-   * const shipping = await logisticsApi.createShipment({
-   *   token,
-   *   orderId: order._id,
-   *   data: {
-   *     provider: "other",
-   *     trackingNumber: "COURIER123456",
-   *     trackingUrl: "https://courier-website.com/track/COURIER123456",
-   *   },
-   * });
-   *
-   * @example
-   * // Provider API: Create shipment with pickup store
-   * const { data: stores } = await logisticsApi.getPickupStores({ token });
-   * const shipping = await logisticsApi.createShipment({
-   *   token,
-   *   orderId: order._id,
-   *   data: {
-   *     provider: "redx",
-   *     useProviderApi: true,
-   *     pickupStoreId: stores[0].id,  // Select pickup location
-   *     weight: 500,                  // Parcel weight in grams
-   *     instructions: 'Handle with care',
-   *   },
-   * });
-   */
-  async createShipment({
-    token,
-    orderId,
-    data,
-    options = {}
-  }) {
-    if (!orderId) throw new Error("Order ID is required");
-    const response = await handleApiRequest("POST", `${this.config.basePath}/orders/${orderId}/shipping`, {
-      token,
-      body: data,
-      ...options
-    });
-    const normalizedData = response.data && typeof response.data === "object" && "shipping" in response.data ? response.data.shipping : response.data;
-    return {
-      success: response.success,
-      message: response.message,
-      ...normalizedData ? { data: normalizedData } : {}
-    };
-  }
-  /**
-   * Get shipping info for an order
-   * GET /orders/:id/shipping
-   */
-  async getShipment({
-    token,
-    id,
-    options = {}
-  }) {
-    if (!id) throw new Error("Order ID is required");
-    return handleApiRequest("GET", `${this.config.basePath}/orders/${id}/shipping`, {
-      token,
-      cache: "no-store",
-      ...options
-    });
-  }
-  /**
-   * Track shipment (fetch latest from provider)
-   * GET /logistics/shipments/:id/track
-   *
-   * @param id - Order ID or tracking number
-   */
-  async trackShipment({
-    token,
-    id,
-    options = {}
-  }) {
-    if (!id) throw new Error("Shipment ID or tracking number is required");
-    return handleApiRequest("GET", `${this.baseUrl}/shipments/${id}/track`, {
-      token,
-      cache: "no-store",
-      ...options
-    });
-  }
-  /**
-   * Update shipping status for an order
-   * PATCH /orders/:id/shipping
-   */
-  async updateShipmentStatus({
-    token,
-    id,
-    data,
-    options = {}
-  }) {
-    if (!id) throw new Error("Order ID is required");
-    if (!data?.status) throw new Error("Status is required");
-    return handleApiRequest("PATCH", `${this.config.basePath}/orders/${id}/shipping`, {
-      token,
-      body: data,
-      ...options
-    });
-  }
-  /**
-   * Cancel shipment
-   * POST /logistics/shipments/:id/cancel
-   *
-   * @param id - Order ID or tracking number
-   */
-  async cancelShipment({
-    token,
-    id,
-    data,
-    options = {}
-  }) {
-    if (!id) throw new Error("Shipment ID or tracking number is required");
-    return handleApiRequest("POST", `${this.baseUrl}/shipments/${id}/cancel`, {
-      token,
-      body: data || {},
-      ...options
-    });
-  }
-  // ============================================
-  // HEALTH & MONITORING (Admin)
-  // ============================================
-  /**
-   * Get circuit breaker status for all providers
-   * GET /logistics/health/circuit-status
-   */
-  async getCircuitStatus({
-    token,
-    options = {}
-  }) {
-    return handleApiRequest("GET", `${this.baseUrl}/health/circuit-status`, {
-      token,
-      cache: "no-store",
-      ...options
-    });
-  }
-  /**
-   * Reset circuit breaker for a provider
-   * POST /logistics/health/circuit-reset/:provider
-   */
-  async resetProviderCircuit({
-    token,
-    provider,
-    options = {}
-  }) {
-    if (!provider) throw new Error("Provider name is required");
-    return handleApiRequest(
-      "POST",
-      `${this.baseUrl}/health/circuit-reset/${provider}`,
-      {
-        token,
-        body: {},
-        ...options
-      }
-    );
-  }
-};
-var logisticsApi = new LogisticsApi();
-var LOGISTICS_KEYS = {
-  all: ["logistics"],
-  pickupStores: (provider) => [...LOGISTICS_KEYS.all, "pickup-stores", provider],
-  shipment: (id) => [...LOGISTICS_KEYS.all, "shipment", id],
-  tracking: (id) => [...LOGISTICS_KEYS.all, "tracking", id],
-  charge: (params) => [...LOGISTICS_KEYS.all, "charge", params],
-  config: () => [...LOGISTICS_KEYS.all, "config"]
-};
-function usePickupStores(token, provider, options = {}) {
-  return useQuery({
-    queryKey: LOGISTICS_KEYS.pickupStores(provider),
-    queryFn: async () => {
-      const response = await logisticsApi.getPickupStores({ token, provider });
-      return response.data || [];
-    },
-    enabled: options.enabled !== false && !!token,
-    staleTime: options.staleTime ?? 5 * 60 * 1e3
-  });
-}
-function useDeliveryChargeCalculation(token, params, options = {}) {
-  const hasValidParams = !!params?.deliveryAreaId && params?.amount !== void 0;
-  return useQuery({
-    queryKey: LOGISTICS_KEYS.charge(
-      params ? { deliveryAreaId: params.deliveryAreaId, amount: params.amount, weight: params.weight } : { deliveryAreaId: 0, amount: 0 }
-    ),
-    queryFn: async () => {
-      if (!params) throw new Error("Params required");
-      const response = await logisticsApi.calculateCharge({
-        deliveryAreaId: params.deliveryAreaId,
-        pickupAreaId: params.pickupAreaId,
-        amount: params.amount,
-        weight: params.weight,
-        provider: params.provider
-      });
-      if (!response.data) throw new Error("No charge data returned");
-      return response.data;
-    },
-    enabled: options.enabled !== false && hasValidParams,
-    staleTime: options.staleTime ?? 60 * 1e3
-  });
-}
-function useDeliveryCharge({
-  deliveryAreaId,
-  amount,
-  weight = 500,
-  enabled = true
-}) {
-  const { data, isLoading, isFetching, error, refetch } = useQuery({
-    queryKey: LOGISTICS_KEYS.charge({
-      deliveryAreaId: deliveryAreaId || 0,
-      amount,
-      weight
-    }),
-    queryFn: async () => {
-      if (!deliveryAreaId) return null;
-      const response = await logisticsApi.calculateCharge({
-        deliveryAreaId,
-        amount,
-        weight
-      });
-      return response.data || null;
-    },
-    enabled: enabled && !!deliveryAreaId,
-    staleTime: 5 * 60 * 1e3,
-    gcTime: 10 * 60 * 1e3,
-    retry: 1
-  });
-  return {
-    charges: data || null,
-    deliveryCharge: data?.deliveryCharge ?? 0,
-    codCharge: data?.codCharge ?? 0,
-    totalCharge: data?.totalCharge ?? 0,
-    isLoading,
-    isFetching,
-    error,
-    refetch
-  };
-}
-function useShipment(token, orderId, options = {}) {
-  return useQuery({
-    queryKey: LOGISTICS_KEYS.shipment(orderId || ""),
-    queryFn: async () => {
-      if (!orderId) throw new Error("Order ID required");
-      const response = await logisticsApi.getShipment({ token, id: orderId });
-      if (!response.data) throw new Error("Shipping info not found");
-      return response.data;
-    },
-    enabled: options.enabled !== false && !!token && !!orderId,
-    staleTime: options.staleTime ?? 30 * 1e3
-  });
-}
-function useTrackShipment(token, shipmentId, options = {}) {
-  return useQuery({
-    queryKey: LOGISTICS_KEYS.tracking(shipmentId || ""),
-    queryFn: async () => {
-      if (!shipmentId) throw new Error("Order ID or tracking number required");
-      const response = await logisticsApi.trackShipment({ token, id: shipmentId });
-      if (!response.data) throw new Error("Tracking data not found");
-      return response.data;
-    },
-    enabled: options.enabled !== false && !!token && !!shipmentId,
-    staleTime: options.staleTime ?? 60 * 1e3,
-    refetchInterval: options.refetchInterval ?? 5 * 60 * 1e3
-  });
-}
-function useCreateShipment(token) {
-  const queryClient = useQueryClient();
-  const toast = getToastHandler();
-  return useMutation({
-    mutationFn: async ({ orderId, data }) => {
-      const response = await logisticsApi.createShipment({ token, orderId, data });
-      return response.data;
-    },
-    onSuccess: () => {
-      toast.success("Shipment created successfully");
-      queryClient.invalidateQueries({ queryKey: ["orders"] });
-      queryClient.invalidateQueries({ queryKey: LOGISTICS_KEYS.all });
-    },
-    onError: (error) => {
-      toast.error(error.message || "Failed to create shipment");
-    }
-  });
-}
-function useCancelShipment(token) {
-  const queryClient = useQueryClient();
-  const toast = getToastHandler();
-  return useMutation({
-    mutationFn: async ({ shipmentId, reason }) => {
-      const response = await logisticsApi.cancelShipment({
-        token,
-        id: shipmentId,
-        data: { reason }
-      });
-      return response.data;
-    },
-    onSuccess: () => {
-      toast.success("Shipment cancelled");
-      queryClient.invalidateQueries({ queryKey: ["orders"] });
-      queryClient.invalidateQueries({ queryKey: LOGISTICS_KEYS.all });
-    },
-    onError: (error) => {
-      toast.error(error.message || "Failed to cancel shipment");
-    }
-  });
-}
-function useUpdateShipmentStatus(token) {
-  const queryClient = useQueryClient();
-  const toast = getToastHandler();
-  return useMutation({
-    mutationFn: async ({
-      shipmentId,
-      data
-    }) => {
-      const response = await logisticsApi.updateShipmentStatus({
-        token,
-        id: shipmentId,
-        data
-      });
-      return response.data;
-    },
-    onSuccess: () => {
-      toast.success("Shipment status updated");
-      queryClient.invalidateQueries({ queryKey: ["orders"] });
-      queryClient.invalidateQueries({ queryKey: LOGISTICS_KEYS.all });
-    },
-    onError: (error) => {
-      toast.error(error.message || "Failed to update status");
-    }
-  });
-}
-function useLogisticsActions(token) {
-  const createShipmentMutation = useCreateShipment(token);
-  const cancelShipmentMutation = useCancelShipment(token);
-  const updateStatusMutation = useUpdateShipmentStatus(token);
-  return {
-    createShipment: createShipmentMutation.mutateAsync,
-    isCreatingShipment: createShipmentMutation.isPending,
-    cancelShipment: cancelShipmentMutation.mutateAsync,
-    isCancellingShipment: cancelShipmentMutation.isPending,
-    updateShipmentStatus: updateStatusMutation.mutateAsync,
-    isUpdatingStatus: updateStatusMutation.isPending,
-    isLoading: createShipmentMutation.isPending || cancelShipmentMutation.isPending || updateStatusMutation.isPending
-  };
-}
-
-export { LOGISTICS_KEYS, LogisticsApi, logisticsApi, useCancelShipment, useCreateShipment, useDeliveryCharge, useDeliveryChargeCalculation, useLogisticsActions, usePickupStores, useShipment, useTrackShipment, useUpdateShipmentStatus };
-//# sourceMappingURL=chunk-2YAZ5WG6.js.map
-//# sourceMappingURL=chunk-2YAZ5WG6.js.map

package/dist/chunk-2YAZ5WG6.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/logistics/api/logistics.ts","../src/logistics/hooks/logistics.ts"],"names":[],"mappings":"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","file":"chunk-2YAZ5WG6.js","sourcesContent":["// @/logistics/api/logistics.ts\r\nimport { BaseApi, type RequestOptions, type ApiResponse } from \"../../core/api-factory\";\nimport { handleApiRequest } from \"../../core/api-handler\";\nimport type {\n  TrackingResult,\n  PickupStore,\n  LogisticsConfig,\n  ProviderCharges,\n  CreateShipmentPayload,\n  UpdateShipmentStatusPayload,\n  CancelShipmentPayload,\n  ProviderName,\n  CancelShipmentResult,\n} from \"../types/logistics\";\nimport type { OrderShipping } from \"../../sales/types/order\";\n\r\n// ==================== Request Options ====================\r\n\r\ntype FetchOptions = Omit<RequestOptions, 'token' | 'organizationId'>;\r\n\r\n// ==================== Logistics API ====================\r\n\r\n/**\r\n * Logistics API\n *\n * Manages logistics utilities and delivery charge calculation.\n *\r\n * NOTE: For area data (divisions, districts, areas), use @classytic/bd-areas directly:\r\n * ```typescript\r\n * import { searchAreas, getAreasByDistrict, getArea } from '@classytic/bd-areas';\r\n * ```\r\n *\r\n * Public Endpoints:\r\n * - GET /logistics/charge - Calculate delivery charge via provider (RedX)\r\n *\r\n * Shipping Endpoints (Admin/Store Manager):\n * - POST /orders/:id/shipping - Request shipping (manual or provider API)\n * - PATCH /orders/:id/shipping - Update shipping status\n * - GET /orders/:id/shipping - Get shipping info\n * - GET /logistics/shipments/:id/track - Track shipment\n * - POST /logistics/shipments/:id/cancel - Cancel shipment\n *\r\n * Admin Endpoints:\r\n * - GET /logistics/config - Get config (read-only)\r\n * - GET /logistics/pickup-stores - List pickup stores\r\n * - GET /logistics/health/circuit-status - Get circuit breaker status\r\n * - POST /logistics/health/circuit-reset/:provider - Reset circuit breaker\r\n */\r\nclass LogisticsApi extends BaseApi<OrderShipping, CreateShipmentPayload> {\n  constructor(config = {}) {\r\n    super('logistics', config);\r\n  }\r\n\r\n  // ============================================\r\n  // CHARGE CALCULATION (Public)\r\n  // ============================================\r\n\r\n  /**\r\n   * Calculate delivery charge via provider API (e.g., RedX)\r\n   * GET /logistics/charge\r\n   *\r\n   * Use this to get real-time delivery charges from the logistics provider\r\n   * before creating an order.\r\n   *\r\n   * @param deliveryAreaId - Area internalId from @classytic/bd-areas\r\n   * @param amount - COD amount in BDT (use 0 for prepaid orders)\r\n   * @param weight - Parcel weight in grams (default: 500g)\r\n   *\r\n   * @example\r\n   * import { searchAreas } from '@classytic/bd-areas';\r\n   *\r\n   * // 1. User selects area\r\n   * const areas = searchAreas('mohamm');\r\n   * const selectedArea = areas[0]; // { internalId: 1206, name: 'Mohammadpur', ... }\r\n   *\r\n   * // 2. Calculate delivery charge\r\n   * const { data } = await logisticsApi.calculateCharge({\r\n   *   deliveryAreaId: selectedArea.internalId,\r\n   *   amount: isCOD ? cartTotal : 0,\r\n   * });\r\n   * // { deliveryCharge: 60, codCharge: 15, totalCharge: 75 }\r\n   */\r\n  async calculateCharge({\r\n    deliveryAreaId,\r\n    pickupAreaId,\r\n    amount,\r\n    weight,\r\n    provider,\r\n    options = {},\r\n  }: {\r\n    deliveryAreaId: number;\r\n    pickupAreaId?: number;\r\n    amount: number;\r\n    weight?: number;\r\n    provider?: ProviderName;\r\n    options?: FetchOptions;\r\n  }): Promise<ApiResponse<ProviderCharges>> {\r\n    if (!deliveryAreaId || amount === undefined) {\r\n      throw new Error(\"deliveryAreaId and amount are required\");\r\n    }\r\n\r\n    const queryString = this.createQueryString({\r\n      deliveryAreaId,\r\n      pickupAreaId,\r\n      amount,\r\n      weight,\r\n      provider,\r\n    });\r\n\r\n    return handleApiRequest(\"GET\", `${this.baseUrl}/charge?${queryString}`, {\r\n      cache: \"no-store\",\r\n      ...options,\r\n    });\r\n  }\r\n\r\n  // ============================================\r\n  // CONFIG ENDPOINTS (Admin - Read-only)\r\n  // ============================================\r\n\r\n  /**\r\n   * Get logistics configuration (read-only from .env)\r\n   * GET /logistics/config\r\n   *\r\n   * NOTE: Configuration is managed via environment variables.\r\n   * To change settings, update .env file and restart server.\r\n   */\r\n  async getConfig({\r\n    token,\r\n    options = {},\r\n  }: {\r\n    token: string;\r\n    options?: FetchOptions;\r\n  }): Promise<ApiResponse<LogisticsConfig>> {\r\n    return handleApiRequest(\"GET\", `${this.baseUrl}/config`, {\r\n      token,\r\n      cache: \"no-store\",\r\n      ...options,\r\n    });\r\n  }\r\n\r\n  // ============================================\r\n  // PICKUP STORES (Admin)\r\n  // ============================================\r\n\r\n  /**\r\n   * Get pickup stores from RedX API\r\n   * GET /logistics/pickup-stores\r\n   *\r\n   * Pickup stores are created by admin in RedX dashboard.\r\n   * Use this to list available pickup locations when creating shipments.\r\n   *\r\n   * @example\r\n   * // Admin: List pickup stores for shipment creation\r\n   * const { data: stores } = await logisticsApi.getPickupStores({ token });\r\n   *\r\n   * // Display in dropdown for admin to select\r\n   * stores.forEach(store => {\r\n   *   console.log(`${store.name} - ${store.areaName} (ID: ${store.id})`);\r\n   * });\r\n   *\r\n   * // Use selected store when creating shipment\r\n   * await logisticsApi.createShipment({\r\n   *   token,\r\n   *   data: {\r\n   *     orderId: order._id,\r\n   *     pickupStoreId: selectedStore.id,  // From dropdown\r\n   *   },\r\n   * });\r\n   */\r\n  async getPickupStores({\r\n    token,\r\n    provider,\r\n    options = {},\r\n  }: {\r\n    token: string;\r\n    provider?: string;\r\n    options?: FetchOptions;\r\n  }): Promise<ApiResponse<PickupStore[]>> {\r\n    const queryString = provider ? `?provider=${provider}` : '';\r\n    return handleApiRequest(\r\n      \"GET\",\r\n      `${this.baseUrl}/pickup-stores${queryString}`,\r\n      {\r\n        token,\r\n        cache: \"no-store\",\r\n        ...options,\r\n      }\r\n    );\r\n  }\r\n\r\n  // ============================================\n  // SHIPPING ENDPOINTS (Admin/Store Manager)\n  // ============================================\n\n  /**\n   * Request shipping for an order (manual or provider API)\n   * POST /orders/:id/shipping\n   *\n   * This updates the order.shipping object and optionally triggers\n   * provider API shipment creation when useProviderApi=true.\n   *\n   * @example\n   * // Manual: Record tracking details\n   * const shipping = await logisticsApi.createShipment({\n   *   token,\n   *   orderId: order._id,\n   *   data: {\n   *     provider: \"other\",\n   *     trackingNumber: \"COURIER123456\",\n   *     trackingUrl: \"https://courier-website.com/track/COURIER123456\",\n   *   },\n   * });\n   *\n   * @example\n   * // Provider API: Create shipment with pickup store\n   * const { data: stores } = await logisticsApi.getPickupStores({ token });\n   * const shipping = await logisticsApi.createShipment({\n   *   token,\n   *   orderId: order._id,\n   *   data: {\n   *     provider: \"redx\",\n   *     useProviderApi: true,\n   *     pickupStoreId: stores[0].id,  // Select pickup location\n   *     weight: 500,                  // Parcel weight in grams\n   *     instructions: 'Handle with care',\n   *   },\n   * });\n   */\n  async createShipment({\n    token,\n    orderId,\n    data,\n    options = {},\n  }: {\n    token: string;\n    orderId: string;\n    data: CreateShipmentPayload;\n    options?: FetchOptions;\n  }): Promise<ApiResponse<OrderShipping>> {\n    if (!orderId) throw new Error(\"Order ID is required\");\n\n    const response = await handleApiRequest<\n      ApiResponse<OrderShipping> | ApiResponse<{ shipping: OrderShipping }>\n    >(\"POST\", `${this.config.basePath}/orders/${orderId}/shipping`, {\n      token,\n      body: data,\n      ...options,\n    });\n\n    const normalizedData =\n      response.data && typeof response.data === \"object\" && \"shipping\" in response.data\n        ? (response.data as { shipping: OrderShipping }).shipping\n        : response.data;\n\n    return {\n      success: response.success,\n      message: response.message,\n      ...(normalizedData ? { data: normalizedData as OrderShipping } : {}),\n    };\n  }\n\n  /**\n   * Get shipping info for an order\n   * GET /orders/:id/shipping\n   */\n  async getShipment({\n    token,\n    id,\n    options = {},\n  }: {\n    token: string;\n    id: string;\n    options?: FetchOptions;\n  }): Promise<ApiResponse<OrderShipping | null>> {\n    if (!id) throw new Error(\"Order ID is required\");\n\n    return handleApiRequest(\"GET\", `${this.config.basePath}/orders/${id}/shipping`, {\n      token,\n      cache: \"no-store\",\n      ...options,\n    });\n  }\n\r\n  /**\n   * Track shipment (fetch latest from provider)\n   * GET /logistics/shipments/:id/track\n   *\n   * @param id - Order ID or tracking number\n   */\n  async trackShipment({\n    token,\n    id,\n    options = {},\n  }: {\n    token: string;\n    id: string;\n    options?: FetchOptions;\n  }): Promise<ApiResponse<TrackingResult>> {\n    if (!id) throw new Error(\"Shipment ID or tracking number is required\");\n\n    return handleApiRequest(\"GET\", `${this.baseUrl}/shipments/${id}/track`, {\n      token,\n      cache: \"no-store\",\n      ...options,\n    });\r\n  }\r\n\r\n  /**\n   * Update shipping status for an order\n   * PATCH /orders/:id/shipping\n   */\n  async updateShipmentStatus({\n    token,\n    id,\n    data,\n    options = {},\n  }: {\n    token: string;\n    id: string;\n    data: UpdateShipmentStatusPayload;\n    options?: FetchOptions;\n  }): Promise<ApiResponse<OrderShipping>> {\n    if (!id) throw new Error(\"Order ID is required\");\n    if (!data?.status) throw new Error(\"Status is required\");\n\n    return handleApiRequest(\"PATCH\", `${this.config.basePath}/orders/${id}/shipping`, {\n      token,\n      body: data,\n      ...options,\n    });\n  }\n\r\n  /**\n   * Cancel shipment\n   * POST /logistics/shipments/:id/cancel\n   *\n   * @param id - Order ID or tracking number\n   */\n  async cancelShipment({\n    token,\n    id,\n    data,\n    options = {},\n  }: {\n    token: string;\n    id: string;\n    data?: CancelShipmentPayload;\n    options?: FetchOptions;\n  }): Promise<ApiResponse<CancelShipmentResult>> {\n    if (!id) throw new Error(\"Shipment ID or tracking number is required\");\n\n    return handleApiRequest(\"POST\", `${this.baseUrl}/shipments/${id}/cancel`, {\n      token,\n      body: data || {},\r\n      ...options,\r\n    });\r\n  }\r\n\r\n  // ============================================\r\n  // HEALTH & MONITORING (Admin)\r\n  // ============================================\r\n\r\n  /**\r\n   * Get circuit breaker status for all providers\r\n   * GET /logistics/health/circuit-status\r\n   */\r\n  async getCircuitStatus({\r\n    token,\r\n    options = {},\r\n  }: {\r\n    token: string;\r\n    options?: FetchOptions;\r\n  }): Promise<ApiResponse<Record<string, { state: string; failureCount: number }>>> {\r\n    return handleApiRequest(\"GET\", `${this.baseUrl}/health/circuit-status`, {\r\n      token,\r\n      cache: \"no-store\",\r\n      ...options,\r\n    });\r\n  }\r\n\r\n  /**\r\n   * Reset circuit breaker for a provider\r\n   * POST /logistics/health/circuit-reset/:provider\r\n   */\r\n  async resetProviderCircuit({\r\n    token,\r\n    provider,\r\n    options = {},\r\n  }: {\r\n    token: string;\r\n    provider: string;\r\n    options?: FetchOptions;\r\n  }): Promise<ApiResponse<{ message: string }>> {\r\n    if (!provider) throw new Error(\"Provider name is required\");\r\n\r\n    return handleApiRequest(\r\n      \"POST\",\r\n      `${this.baseUrl}/health/circuit-reset/${provider}`,\r\n      {\r\n        token,\r\n        body: {},\r\n        ...options,\r\n      }\r\n    );\r\n  }\r\n}\r\n\r\n// Create and export singleton instance\r\nexport const logisticsApi = new LogisticsApi();\r\n\r\n// Export class for custom configurations\r\nexport { LogisticsApi };\r\n","\"use client\";\n\nimport { useQuery, useMutation, useQueryClient } from \"@tanstack/react-query\";\nimport { logisticsApi } from \"../api/logistics\";\nimport { getToastHandler } from \"../../core/react/mutation.factory\";\nimport type {\n  PickupStore,\n  TrackingResult,\n  CreateShipmentPayload,\n  ProviderCharges,\n  ProviderName,\n  CancelShipmentResult,\n} from \"../types/logistics\";\nimport type { OrderShipping, ShippingStatus } from \"../../sales/types/order\";\n\n// ============================================\n// Query Keys\n// ============================================\n\nexport const LOGISTICS_KEYS = {\n  all: [\"logistics\"] as const,\n  pickupStores: (provider?: string) => [...LOGISTICS_KEYS.all, \"pickup-stores\", provider] as const,\n  shipment: (id: string) => [...LOGISTICS_KEYS.all, \"shipment\", id] as const,\n  tracking: (id: string) => [...LOGISTICS_KEYS.all, \"tracking\", id] as const,\n  charge: (params: { deliveryAreaId: number; amount: number; weight?: number }) =>\n    [...LOGISTICS_KEYS.all, \"charge\", params] as const,\n  config: () => [...LOGISTICS_KEYS.all, \"config\"] as const,\n};\n\n// ============================================\n// Types\n// ============================================\n\ninterface QueryOptions {\n  enabled?: boolean;\n  staleTime?: number;\n  refetchInterval?: number | false;\n}\n\ninterface ChargeParams {\n  deliveryAreaId: number;\n  pickupAreaId?: number;\n  amount: number;\n  weight?: number;\n  provider?: ProviderName;\n}\n\ninterface UseDeliveryChargeParams {\n  deliveryAreaId: number | null | undefined;\n  amount: number;\n  weight?: number;\n  enabled?: boolean;\n}\n\nexport interface UseDeliveryChargeReturn {\n  charges: ProviderCharges | null;\n  deliveryCharge: number;\n  codCharge: number;\n  totalCharge: number;\n  isLoading: boolean;\n  isFetching: boolean;\n  error: Error | null;\n  refetch: () => void;\n}\n\nexport interface UseLogisticsActionsReturn {\n  createShipment: (params: { orderId: string; data: CreateShipmentPayload }) => Promise<OrderShipping | undefined>;\n  isCreatingShipment: boolean;\n  cancelShipment: (params: { shipmentId: string; reason?: string }) => Promise<CancelShipmentResult | undefined>;\n  isCancellingShipment: boolean;\n  updateShipmentStatus: (params: { shipmentId: string; data: UpdateShipmentStatusParams }) => Promise<OrderShipping | undefined>;\n  isUpdatingStatus: boolean;\n  isLoading: boolean;\n}\n\ninterface UpdateShipmentStatusParams {\n  status: ShippingStatus | string;\n  note?: string;\n  metadata?: Record<string, unknown>;\n}\n\n// ============================================\n// Query Hooks\n// ============================================\n\n/**\n * Fetch pickup stores from logistics provider\n *\n * @param token - Auth token (admin required)\n * @param provider - Optional provider filter\n * @param options - Query options\n *\n * @example\n * ```tsx\n * function PickupStoreSelect() {\n *   const { data: stores, isLoading } = usePickupStores(token);\n *\n *   return (\n *     <Select>\n *       {stores?.map(store => (\n *         <SelectItem key={store.id} value={store.id.toString()}>\n *           {store.name} - {store.areaName}\n *         </SelectItem>\n *       ))}\n *     </Select>\n *   );\n * }\n * ```\n */\nexport function usePickupStores(\n  token: string,\n  provider?: string,\n  options: QueryOptions = {}\n) {\n  return useQuery({\n    queryKey: LOGISTICS_KEYS.pickupStores(provider),\n    queryFn: async (): Promise<PickupStore[]> => {\n      const response = await logisticsApi.getPickupStores({ token, provider });\n      return response.data || [];\n    },\n    enabled: options.enabled !== false && !!token,\n    staleTime: options.staleTime ?? 5 * 60 * 1000,\n  });\n}\n\n/**\n * Calculate delivery charge via provider API\n *\n * @param token - Auth token (optional for public)\n * @param params - Charge calculation parameters\n * @param options - Query options\n *\n * @example\n * ```tsx\n * const { data: charges } = useDeliveryChargeCalculation(token, {\n *   deliveryAreaId: 1206,\n *   amount: isCOD ? cartTotal : 0,\n * });\n * ```\n */\nexport function useDeliveryChargeCalculation(\n  token: string | null,\n  params: ChargeParams | null,\n  options: QueryOptions = {}\n) {\n  const hasValidParams = !!params?.deliveryAreaId && params?.amount !== undefined;\n\n  return useQuery({\n    queryKey: LOGISTICS_KEYS.charge(\n      params\n        ? { deliveryAreaId: params.deliveryAreaId, amount: params.amount, weight: params.weight }\n        : { deliveryAreaId: 0, amount: 0 }\n    ),\n    queryFn: async (): Promise<ProviderCharges> => {\n      if (!params) throw new Error(\"Params required\");\n      const response = await logisticsApi.calculateCharge({\n        deliveryAreaId: params.deliveryAreaId,\n        pickupAreaId: params.pickupAreaId,\n        amount: params.amount,\n        weight: params.weight,\n        provider: params.provider,\n      });\n      if (!response.data) throw new Error(\"No charge data returned\");\n      return response.data;\n    },\n    enabled: options.enabled !== false && hasValidParams,\n    staleTime: options.staleTime ?? 60 * 1000,\n  });\n}\n\n/**\n * Convenience hook for delivery charge with extracted values\n *\n * @param params - Delivery charge parameters\n *\n * @example\n * ```tsx\n * function CheckoutDelivery({ areaId, subtotal, isCOD }) {\n *   const { deliveryCharge, isLoading } = useDeliveryCharge({\n *     deliveryAreaId: areaId,\n *     amount: isCOD ? subtotal : 0,\n *   });\n *\n *   return (\n *     <p>Delivery: {isLoading ? \"...\" : `৳${deliveryCharge}`}</p>\n *   );\n * }\n * ```\n */\nexport function useDeliveryCharge({\n  deliveryAreaId,\n  amount,\n  weight = 500,\n  enabled = true,\n}: UseDeliveryChargeParams): UseDeliveryChargeReturn {\n  const { data, isLoading, isFetching, error, refetch } = useQuery<ProviderCharges | null>({\n    queryKey: LOGISTICS_KEYS.charge({\n      deliveryAreaId: deliveryAreaId || 0,\n      amount,\n      weight,\n    }),\n    queryFn: async () => {\n      if (!deliveryAreaId) return null;\n\n      const response = await logisticsApi.calculateCharge({\n        deliveryAreaId,\n        amount,\n        weight,\n      });\n\n      return response.data || null;\n    },\n    enabled: enabled && !!deliveryAreaId,\n    staleTime: 5 * 60 * 1000,\n    gcTime: 10 * 60 * 1000,\n    retry: 1,\n  });\n\n  return {\n    charges: data || null,\n    deliveryCharge: data?.deliveryCharge ?? 0,\n    codCharge: data?.codCharge ?? 0,\n    totalCharge: data?.totalCharge ?? 0,\n    isLoading,\n    isFetching,\n    error: error as Error | null,\n    refetch,\n  };\n}\n\n/**\n * Get shipping info by order ID\n *\n * @param token - Auth token\n * @param orderId - Order ID\n * @param options - Query options\n */\nexport function useShipment(\n  token: string,\n  orderId: string | null,\n  options: QueryOptions = {}\n) {\n  return useQuery({\n    queryKey: LOGISTICS_KEYS.shipment(orderId || \"\"),\n    queryFn: async (): Promise<OrderShipping> => {\n      if (!orderId) throw new Error(\"Order ID required\");\n      const response = await logisticsApi.getShipment({ token, id: orderId });\n      if (!response.data) throw new Error(\"Shipping info not found\");\n      return response.data;\n    },\n    enabled: options.enabled !== false && !!token && !!orderId,\n    staleTime: options.staleTime ?? 30 * 1000,\n  });\n}\n\n/**\n * Track shipment - fetches latest status from provider\n *\n * @param token - Auth token\n * @param shipmentId - Order ID or tracking number\n * @param options - Query options (supports refetchInterval for auto-refresh)\n *\n * @example\n * ```tsx\n * function ShipmentTracker({ shipmentId }) {\n *   const { data, isLoading } = useTrackShipment(token, shipmentId, {\n *     refetchInterval: 5 * 60 * 1000, // Auto-refresh every 5 minutes\n *   });\n *\n *   return (\n *     <Timeline events={data?.tracking?.timeline || []} />\n *   );\n * }\n * ```\n */\nexport function useTrackShipment(\n  token: string,\n  shipmentId: string | null,\n  options: QueryOptions = {}\n) {\n  return useQuery({\n    queryKey: LOGISTICS_KEYS.tracking(shipmentId || \"\"),\n    queryFn: async (): Promise<TrackingResult> => {\n      if (!shipmentId) throw new Error(\"Order ID or tracking number required\");\n      const response = await logisticsApi.trackShipment({ token, id: shipmentId });\n      if (!response.data) throw new Error(\"Tracking data not found\");\n      return response.data;\n    },\n    enabled: options.enabled !== false && !!token && !!shipmentId,\n    staleTime: options.staleTime ?? 60 * 1000,\n    refetchInterval: options.refetchInterval ?? 5 * 60 * 1000,\n  });\n}\n\n// ============================================\n// Mutation Hooks\n// ============================================\n\n/**\n * Create shipment mutation\n *\n * @param token - Auth token\n *\n * @example\n * ```tsx\n * function CreateShipmentButton({ order }) {\n *   const { mutate, isPending } = useCreateShipment(token);\n *\n *   return (\n *     <Button\n *       onClick={() =>\n *         mutate({\n *           orderId: order._id,\n *           data: { provider: \"redx\", useProviderApi: true },\n *         })\n *       }\n *       disabled={isPending}\n *     >\n *       Create Shipment\n *     </Button>\n *   );\n * }\n * ```\n */\nexport function useCreateShipment(token: string) {\n  const queryClient = useQueryClient();\n  const toast = getToastHandler();\n\n  return useMutation({\n    mutationFn: async ({ orderId, data }: { orderId: string; data: CreateShipmentPayload }) => {\n      const response = await logisticsApi.createShipment({ token, orderId, data });\n      return response.data;\n    },\n    onSuccess: () => {\n      toast.success(\"Shipment created successfully\");\n      queryClient.invalidateQueries({ queryKey: [\"orders\"] });\n      queryClient.invalidateQueries({ queryKey: LOGISTICS_KEYS.all });\n    },\n    onError: (error: Error) => {\n      toast.error(error.message || \"Failed to create shipment\");\n    },\n  });\n}\n\n/**\n * Cancel shipment mutation\n *\n * @param token - Auth token\n */\nexport function useCancelShipment(token: string) {\n  const queryClient = useQueryClient();\n  const toast = getToastHandler();\n\n  return useMutation({\n    mutationFn: async ({ shipmentId, reason }: { shipmentId: string; reason?: string }) => {\n      const response = await logisticsApi.cancelShipment({\n        token,\n        id: shipmentId,\n        data: { reason },\n      });\n      return response.data;\n    },\n    onSuccess: () => {\n      toast.success(\"Shipment cancelled\");\n      queryClient.invalidateQueries({ queryKey: [\"orders\"] });\n      queryClient.invalidateQueries({ queryKey: LOGISTICS_KEYS.all });\n    },\n    onError: (error: Error) => {\n      toast.error(error.message || \"Failed to cancel shipment\");\n    },\n  });\n}\n\n/**\n * Update shipment status mutation\n *\n * @param token - Auth token\n */\nexport function useUpdateShipmentStatus(token: string) {\n  const queryClient = useQueryClient();\n  const toast = getToastHandler();\n\n  return useMutation({\n    mutationFn: async ({\n      shipmentId,\n      data,\n    }: {\n      shipmentId: string;\n      data: UpdateShipmentStatusParams;\n    }) => {\n      const response = await logisticsApi.updateShipmentStatus({\n        token,\n        id: shipmentId,\n        data,\n      });\n      return response.data;\n    },\n    onSuccess: () => {\n      toast.success(\"Shipment status updated\");\n      queryClient.invalidateQueries({ queryKey: [\"orders\"] });\n      queryClient.invalidateQueries({ queryKey: LOGISTICS_KEYS.all });\n    },\n    onError: (error: Error) => {\n      toast.error(error.message || \"Failed to update status\");\n    },\n  });\n}\n\n/**\n * Combined hook for all logistics mutations\n *\n * @param token - Auth token\n *\n * @example\n * ```tsx\n * function ShipmentActions({ order }) {\n *   const {\n *     createShipment,\n *     cancelShipment,\n *     isLoading,\n *   } = useLogisticsActions(token);\n *\n *   return (\n *     <>\n *       <Button\n *         onClick={() =>\n *           createShipment({\n *             orderId: order._id,\n *             data: { provider: \"redx\", useProviderApi: true },\n *           })\n *         }\n *       >\n *         Create Shipment\n *       </Button>\n *       <Button onClick={() => cancelShipment({ shipmentId: order._id })}>\n *         Cancel\n *       </Button>\n *     </>\n *   );\n * }\n * ```\n */\nexport function useLogisticsActions(token: string): UseLogisticsActionsReturn {\n  const createShipmentMutation = useCreateShipment(token);\n  const cancelShipmentMutation = useCancelShipment(token);\n  const updateStatusMutation = useUpdateShipmentStatus(token);\n\n  return {\n    createShipment: createShipmentMutation.mutateAsync,\n    isCreatingShipment: createShipmentMutation.isPending,\n    cancelShipment: cancelShipmentMutation.mutateAsync,\n    isCancellingShipment: cancelShipmentMutation.isPending,\n    updateShipmentStatus: updateStatusMutation.mutateAsync,\n    isUpdatingStatus: updateStatusMutation.isPending,\n    isLoading:\n      createShipmentMutation.isPending ||\n      cancelShipmentMutation.isPending ||\n      updateStatusMutation.isPending,\n  };\n}\n"]}