@classytic/commerce-sdk 0.1.0

package/dist/chunk-5L6EXDGH.js

@@ -0,0 +1,465 @@
+import { BaseApi } from './chunk-I5TIKUIQ.js';
+import { getToastHandler } from './chunk-U3XT35GZ.js';
+import { handleApiRequest } from './chunk-VR36QVX2.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
+      }
+    );
+  }
+  // ============================================
+  // SHIPMENT ENDPOINTS (Admin/Store Manager)
+  // ============================================
+  /**
+   * Create shipment for an order via RedX API
+   * POST /logistics/shipments
+   *
+   * This creates a parcel in RedX and updates the order with tracking info.
+   *
+   * @example
+   * // Basic: Create shipment with default pickup store
+   * const shipment = await logisticsApi.createShipment({
+   *   token,
+   *   data: { orderId: order._id },
+   * });
+   *
+   * @example
+   * // With specific pickup store (from getPickupStores)
+   * const { data: stores } = await logisticsApi.getPickupStores({ token });
+   * const shipment = await logisticsApi.createShipment({
+   *   token,
+   *   data: {
+   *     orderId: order._id,
+   *     pickupStoreId: stores[0].id,  // Select pickup location
+   *     weight: 500,                   // Parcel weight in grams
+   *     instructions: 'Handle with care',
+   *   },
+   * });
+   *
+   * // Response includes tracking ID
+   * console.log(`Tracking: ${shipment.data.trackingId}`);
+   */
+  async createShipment({
+    token,
+    data,
+    options = {}
+  }) {
+    if (!data?.orderId) throw new Error("Order ID is required");
+    return handleApiRequest("POST", `${this.baseUrl}/shipments`, {
+      token,
+      body: data,
+      ...options
+    });
+  }
+  /**
+   * Get shipment by ID
+   * GET /logistics/shipments/:id
+   */
+  async getShipment({
+    token,
+    id,
+    options = {}
+  }) {
+    if (!id) throw new Error("Shipment ID is required");
+    return handleApiRequest("GET", `${this.baseUrl}/shipments/${id}`, {
+      token,
+      cache: "no-store",
+      ...options
+    });
+  }
+  /**
+   * Track shipment (fetch latest from provider)
+   * GET /logistics/shipments/:id/track
+   */
+  async trackShipment({
+    token,
+    id,
+    options = {}
+  }) {
+    if (!id) throw new Error("Shipment ID is required");
+    return handleApiRequest("GET", `${this.baseUrl}/shipments/${id}/track`, {
+      token,
+      cache: "no-store",
+      ...options
+    });
+  }
+  /**
+   * Update shipment status manually
+   * PATCH /logistics/shipments/:id/status
+   */
+  async updateShipmentStatus({
+    token,
+    id,
+    data,
+    options = {}
+  }) {
+    if (!id) throw new Error("Shipment ID is required");
+    if (!data?.status) throw new Error("Status is required");
+    return handleApiRequest("PATCH", `${this.baseUrl}/shipments/${id}/status`, {
+      token,
+      body: data,
+      ...options
+    });
+  }
+  /**
+   * Cancel shipment
+   * POST /logistics/shipments/:id/cancel
+   */
+  async cancelShipment({
+    token,
+    id,
+    data,
+    options = {}
+  }) {
+    if (!id) throw new Error("Shipment ID 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, shipmentId, options = {}) {
+  return useQuery({
+    queryKey: LOGISTICS_KEYS.shipment(shipmentId || ""),
+    queryFn: async () => {
+      if (!shipmentId) throw new Error("Shipment ID required");
+      const response = await logisticsApi.getShipment({ token, id: shipmentId });
+      if (!response.data) throw new Error("Shipment not found");
+      return response.data;
+    },
+    enabled: options.enabled !== false && !!token && !!shipmentId,
+    staleTime: options.staleTime ?? 30 * 1e3
+  });
+}
+function useTrackShipment(token, shipmentId, options = {}) {
+  return useQuery({
+    queryKey: LOGISTICS_KEYS.tracking(shipmentId || ""),
+    queryFn: async () => {
+      if (!shipmentId) throw new Error("Shipment ID 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 (data) => {
+      const response = await logisticsApi.createShipment({ token, 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,
+      status,
+      message
+    }) => {
+      const response = await logisticsApi.updateShipmentStatus({
+        token,
+        id: shipmentId,
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        data: { status, message }
+      });
+      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-5L6EXDGH.js.map
+//# sourceMappingURL=chunk-5L6EXDGH.js.map

package/dist/chunk-5L6EXDGH.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/logistics/api/logistics.ts","../src/logistics/hooks/logistics.ts"],"names":[],"mappings":"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","file":"chunk-5L6EXDGH.js","sourcesContent":["// @/logistics/api/logistics.ts\r\nimport { BaseApi, type RequestOptions, type ApiResponse } from \"../../core/api-factory\";\r\nimport { handleApiRequest } from \"../../core/api-handler\";\r\nimport type {\r\n  Shipment,\r\n  TrackingResult,\r\n  PickupStore,\r\n  LogisticsConfig,\r\n  ProviderCharges,\r\n  CreateShipmentPayload,\r\n  UpdateShipmentStatusPayload,\r\n  CancelShipmentPayload,\r\n  ProviderName,\r\n} from \"../types/logistics\";\r\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\r\n *\r\n * Manages shipments and delivery charge calculation.\r\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 * Shipment Endpoints (Admin/Store Manager):\r\n * - POST /logistics/shipments - Create shipment\r\n * - GET /logistics/shipments/:id - Get shipment\r\n * - GET /logistics/shipments/:id/track - Track shipment\r\n * - PATCH /logistics/shipments/:id/status - Update status manually\r\n * - POST /logistics/shipments/:id/cancel - Cancel shipment\r\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<Shipment, CreateShipmentPayload> {\r\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  // ============================================\r\n  // SHIPMENT ENDPOINTS (Admin/Store Manager)\r\n  // ============================================\r\n\r\n  /**\r\n   * Create shipment for an order via RedX API\r\n   * POST /logistics/shipments\r\n   *\r\n   * This creates a parcel in RedX and updates the order with tracking info.\r\n   *\r\n   * @example\r\n   * // Basic: Create shipment with default pickup store\r\n   * const shipment = await logisticsApi.createShipment({\r\n   *   token,\r\n   *   data: { orderId: order._id },\r\n   * });\r\n   *\r\n   * @example\r\n   * // With specific pickup store (from getPickupStores)\r\n   * const { data: stores } = await logisticsApi.getPickupStores({ token });\r\n   * const shipment = await logisticsApi.createShipment({\r\n   *   token,\r\n   *   data: {\r\n   *     orderId: order._id,\r\n   *     pickupStoreId: stores[0].id,  // Select pickup location\r\n   *     weight: 500,                   // Parcel weight in grams\r\n   *     instructions: 'Handle with care',\r\n   *   },\r\n   * });\r\n   *\r\n   * // Response includes tracking ID\r\n   * console.log(`Tracking: ${shipment.data.trackingId}`);\r\n   */\r\n  async createShipment({\r\n    token,\r\n    data,\r\n    options = {},\r\n  }: {\r\n    token: string;\r\n    data: CreateShipmentPayload;\r\n    options?: FetchOptions;\r\n  }): Promise<ApiResponse<Shipment>> {\r\n    if (!data?.orderId) throw new Error(\"Order ID is required\");\r\n\r\n    return handleApiRequest(\"POST\", `${this.baseUrl}/shipments`, {\r\n      token,\r\n      body: data,\r\n      ...options,\r\n    });\r\n  }\r\n\r\n  /**\r\n   * Get shipment by ID\r\n   * GET /logistics/shipments/:id\r\n   */\r\n  async getShipment({\r\n    token,\r\n    id,\r\n    options = {},\r\n  }: {\r\n    token: string;\r\n    id: string;\r\n    options?: FetchOptions;\r\n  }): Promise<ApiResponse<Shipment>> {\r\n    if (!id) throw new Error(\"Shipment ID is required\");\r\n\r\n    return handleApiRequest(\"GET\", `${this.baseUrl}/shipments/${id}`, {\r\n      token,\r\n      cache: \"no-store\",\r\n      ...options,\r\n    });\r\n  }\r\n\r\n  /**\r\n   * Track shipment (fetch latest from provider)\r\n   * GET /logistics/shipments/:id/track\r\n   */\r\n  async trackShipment({\r\n    token,\r\n    id,\r\n    options = {},\r\n  }: {\r\n    token: string;\r\n    id: string;\r\n    options?: FetchOptions;\r\n  }): Promise<ApiResponse<TrackingResult>> {\r\n    if (!id) throw new Error(\"Shipment ID is required\");\r\n\r\n    return handleApiRequest(\"GET\", `${this.baseUrl}/shipments/${id}/track`, {\r\n      token,\r\n      cache: \"no-store\",\r\n      ...options,\r\n    });\r\n  }\r\n\r\n  /**\r\n   * Update shipment status manually\r\n   * PATCH /logistics/shipments/:id/status\r\n   */\r\n  async updateShipmentStatus({\r\n    token,\r\n    id,\r\n    data,\r\n    options = {},\r\n  }: {\r\n    token: string;\r\n    id: string;\r\n    data: UpdateShipmentStatusPayload;\r\n    options?: FetchOptions;\r\n  }): Promise<ApiResponse<Shipment>> {\r\n    if (!id) throw new Error(\"Shipment ID is required\");\r\n    if (!data?.status) throw new Error(\"Status is required\");\r\n\r\n    return handleApiRequest(\"PATCH\", `${this.baseUrl}/shipments/${id}/status`, {\r\n      token,\r\n      body: data,\r\n      ...options,\r\n    });\r\n  }\r\n\r\n  /**\r\n   * Cancel shipment\r\n   * POST /logistics/shipments/:id/cancel\r\n   */\r\n  async cancelShipment({\r\n    token,\r\n    id,\r\n    data,\r\n    options = {},\r\n  }: {\r\n    token: string;\r\n    id: string;\r\n    data?: CancelShipmentPayload;\r\n    options?: FetchOptions;\r\n  }): Promise<ApiResponse<Shipment>> {\r\n    if (!id) throw new Error(\"Shipment ID is required\");\r\n\r\n    return handleApiRequest(\"POST\", `${this.baseUrl}/shipments/${id}/cancel`, {\r\n      token,\r\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  Shipment,\n  PickupStore,\n  TrackingResult,\n  CreateShipmentPayload,\n  ProviderCharges,\n  ProviderName,\n} from \"../types/logistics\";\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: (data: CreateShipmentPayload) => Promise<Shipment | undefined>;\n  isCreatingShipment: boolean;\n  cancelShipment: (params: { shipmentId: string; reason?: string }) => Promise<Shipment | undefined>;\n  isCancellingShipment: boolean;\n  updateShipmentStatus: (params: { shipmentId: string; status: string; message?: string }) => Promise<Shipment | undefined>;\n  isUpdatingStatus: boolean;\n  isLoading: boolean;\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 shipment by ID\n *\n * @param token - Auth token\n * @param shipmentId - Shipment ID\n * @param options - Query options\n */\nexport function useShipment(\n  token: string,\n  shipmentId: string | null,\n  options: QueryOptions = {}\n) {\n  return useQuery({\n    queryKey: LOGISTICS_KEYS.shipment(shipmentId || \"\"),\n    queryFn: async (): Promise<Shipment> => {\n      if (!shipmentId) throw new Error(\"Shipment ID required\");\n      const response = await logisticsApi.getShipment({ token, id: shipmentId });\n      if (!response.data) throw new Error(\"Shipment not found\");\n      return response.data;\n    },\n    enabled: options.enabled !== false && !!token && !!shipmentId,\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 - Shipment ID\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(\"Shipment ID 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={() => mutate({ orderId: order._id })}\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 (data: CreateShipmentPayload) => {\n      const response = await logisticsApi.createShipment({ token, 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      status,\n      message,\n    }: {\n      shipmentId: string;\n      status: string;\n      message?: string;\n    }) => {\n      const response = await logisticsApi.updateShipmentStatus({\n        token,\n        id: shipmentId,\n        // eslint-disable-next-line @typescript-eslint/no-explicit-any\n        data: { status: status as any, message },\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 onClick={() => createShipment({ orderId: order._id })}>\n *         Create Shipment\n *       </Button>\n *       <Button onClick={() => cancelShipment({ shipmentId: order.shipment._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"]}