pathao-merchant-sdk 1.0.0

package/dist/index.d.ts

@@ -0,0 +1,246 @@
+/**
+ * Pathao Courier API Types
+ *
+ * Official API Details:
+ * - Authentication: OAuth2 with client_id, client_secret, username, password
+ * - Live URL: https://api-hermes.pathao.com
+ * - All endpoints use /aladdin/api/v1/ prefix
+ */
+interface PathaoAuthResponse {
+    token_type: string;
+    expires_in: number;
+    access_token: string;
+    refresh_token: string;
+}
+interface PathaoOrderRequest {
+    store_id: number;
+    merchant_order_id?: string;
+    recipient_name: string;
+    recipient_phone: string;
+    recipient_secondary_phone?: string;
+    recipient_address: string;
+    recipient_city?: number;
+    recipient_zone?: number;
+    recipient_area?: number;
+    delivery_type: number;
+    item_type: number;
+    special_instruction?: string;
+    item_quantity: number;
+    item_weight: number;
+    item_description?: string;
+    amount_to_collect: number;
+}
+interface PathaoStoreRequest {
+    name: string;
+    contact_name: string;
+    contact_number: string;
+    address: string;
+    city_id: number;
+    zone_id: number;
+    area_id: number;
+    store_type: number;
+}
+interface PathaoOrderResponse {
+    type: string;
+    code: number;
+    message: string;
+    data: {
+        consignment_id: string;
+        invoice_id: string;
+        merchant_order_id: string;
+        store_id: number;
+        recipient_name: string;
+        recipient_phone: string;
+        recipient_address: string;
+        recipient_city: string;
+        recipient_zone: string;
+        recipient_area: string;
+        delivery_type: string;
+        item_type: string;
+        item_quantity: number;
+        item_weight: number;
+        item_description: string;
+        amount_to_collect: number;
+        special_instruction: string;
+        status: string;
+        created_at: string;
+        updated_at: string;
+    };
+}
+interface PathaoStoreResponse {
+    type: string;
+    code: number;
+    message: string;
+    data: {
+        store_id: number;
+        name: string;
+        contact_name: string;
+        contact_number: string;
+        address: string;
+        city_id: number;
+        zone_id: number;
+        area_id: number;
+        store_type: number;
+        status: string;
+        created_at: string;
+        updated_at: string;
+    };
+}
+interface PathaoPriceRequest {
+    store_id: number;
+    item_type: number;
+    item_weight: number;
+    delivery_type: number;
+    recipient_city: number;
+    recipient_zone: number;
+    recipient_area: number;
+}
+interface PathaoPriceResponse {
+    type: string;
+    code: number;
+    message: string;
+    data: {
+        store_id: number;
+        item_type: string;
+        item_weight: number;
+        delivery_type: string;
+        recipient_city: string;
+        recipient_zone: string;
+        recipient_area: string;
+        delivery_charge: number;
+        cod_charge: number;
+        total_charge: number;
+        currency: string;
+    };
+}
+interface PathaoCityResponse {
+    type: string;
+    code: number;
+    message: string;
+    data: Array<{
+        city_id: number;
+        city_name: string;
+        zone_list: Array<{
+            zone_id: number;
+            zone_name: string;
+            area_list: Array<{
+                area_id: number;
+                area_name: string;
+            }>;
+        }>;
+    }>;
+}
+interface PathaoOrderStatusResponse {
+    type: string;
+    code: number;
+    message: string;
+    data: {
+        consignment_id: string;
+        invoice_id: string;
+        merchant_order_id: string;
+        store_id: number;
+        recipient_name: string;
+        recipient_phone: string;
+        recipient_address: string;
+        recipient_city: string;
+        recipient_zone: string;
+        recipient_area: string;
+        delivery_type: string;
+        item_type: string;
+        item_quantity: number;
+        item_weight: number;
+        item_description: string;
+        amount_to_collect: number;
+        special_instruction: string;
+        status: string;
+        status_updated_at: string;
+        created_at: string;
+        updated_at: string;
+    };
+}
+interface PathaoAreaResponse {
+    type: string;
+    code: number;
+    message: string;
+    data: Array<{
+        area_id: number;
+        area_name: string;
+        zone_id: number;
+        zone_name: string;
+        city_id: number;
+        city_name: string;
+    }>;
+}
+interface PathaoConfig {
+    clientId: string;
+    clientSecret: string;
+    username: string;
+    password: string;
+    baseURL?: string;
+    timeout?: number;
+}
+interface PathaoError {
+    type: string;
+    code: number;
+    message: string;
+    errors?: Record<string, string[]>;
+    validation?: Record<string, string[]>;
+}
+declare enum DeliveryType {
+    NORMAL = 48,
+    ON_DEMAND = 12
+}
+declare enum ItemType {
+    DOCUMENT = 1,
+    PARCEL = 2
+}
+declare enum StoreType {
+    PICKUP_POINT = 1,
+    SERVICE_POINT = 2
+}
+
+/**
+ * Pathao Merchant API Service (Unofficial SDK)
+ *
+ * This is an unofficial SDK for the Pathao Merchant API.
+ *
+ * API Details (based on public documentation):
+ * - Authentication: OAuth2 with client_id, client_secret, username, password
+ * - Live URL: https://api-hermes.pathao.com
+ * - All endpoints use /aladdin/api/v1/ prefix
+ *
+ * Features implemented:
+ * - Token-based authentication with refresh token support
+ * - Store management (create, list stores)
+ * - Order creation (single and bulk)
+ * - Order tracking and status
+ * - Dynamic price calculation
+ * - City, zone, and area management
+ */
+
+declare class PathaoApiService {
+    private pathaoClient;
+    private accessToken;
+    private refreshToken;
+    private tokenExpiry;
+    private config;
+    constructor(config: PathaoConfig);
+    private ensureAuthenticated;
+    private authenticate;
+    private refreshAccessToken;
+    private getErrorMessage;
+    createOrder(orderData: PathaoOrderRequest): Promise<PathaoOrderResponse>;
+    createStore(storeData: PathaoStoreRequest): Promise<PathaoStoreResponse>;
+    getStores(): Promise<PathaoStoreResponse[]>;
+    calculatePrice(priceData: PathaoPriceRequest): Promise<PathaoPriceResponse>;
+    getCities(): Promise<PathaoCityResponse>;
+    getAreas(): Promise<PathaoAreaResponse>;
+    getOrderStatus(consignmentId: string): Promise<PathaoOrderStatusResponse>;
+    static validatePhoneNumber(phone: string): boolean;
+    static formatPhoneNumber(phone: string): string;
+    static validateAddress(address: string): boolean;
+    static validateWeight(weight: number): boolean;
+    static validateRecipientName(name: string): boolean;
+}
+
+export { DeliveryType, ItemType, PathaoApiService, type PathaoAreaResponse, type PathaoAuthResponse, type PathaoCityResponse, type PathaoConfig, type PathaoError, type PathaoOrderRequest, type PathaoOrderResponse, type PathaoOrderStatusResponse, type PathaoPriceRequest, type PathaoPriceResponse, type PathaoStoreRequest, type PathaoStoreResponse, StoreType };

package/dist/index.js

@@ -0,0 +1,285 @@
+'use strict';
+
+var axios = require('axios');
+
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
+
+var axios__default = /*#__PURE__*/_interopDefault(axios);
+
+// src/pathao-api.ts
+var PathaoApiService = class {
+  constructor(config) {
+    this.accessToken = null;
+    this.refreshToken = null;
+    this.tokenExpiry = null;
+    this.config = {
+      baseURL: "https://api-hermes.pathao.com",
+      timeout: 3e4,
+      ...config
+    };
+    this.pathaoClient = axios__default.default.create({
+      baseURL: this.config.baseURL || "https://api-hermes.pathao.com",
+      timeout: this.config.timeout || 3e4,
+      headers: {
+        "Content-Type": "application/json",
+        "Accept": "application/json"
+      }
+    });
+    if (!this.config.clientId || !this.config.clientSecret || !this.config.username || !this.config.password) {
+      throw new Error("Pathao API credentials are required: clientId, clientSecret, username, password");
+    }
+    this.pathaoClient.interceptors.request.use(async (config2) => {
+      await this.ensureAuthenticated();
+      if (this.accessToken) {
+        config2.headers.Authorization = `Bearer ${this.accessToken}`;
+      }
+      return config2;
+    });
+  }
+  async ensureAuthenticated() {
+    if (this.accessToken && this.tokenExpiry && Date.now() < this.tokenExpiry) {
+      return;
+    }
+    if (this.refreshToken) {
+      try {
+        await this.refreshAccessToken();
+        return;
+      } catch (error) {
+        console.warn("Token refresh failed, attempting fresh authentication");
+      }
+    }
+    await this.authenticate();
+  }
+  async authenticate() {
+    try {
+      const response = await this.pathaoClient.post("/aladdin/api/v1/issue-token", {
+        client_id: this.config.clientId,
+        client_secret: this.config.clientSecret,
+        username: this.config.username,
+        password: this.config.password,
+        grant_type: "password"
+      });
+      this.accessToken = response.data.access_token;
+      this.refreshToken = response.data.refresh_token;
+      this.tokenExpiry = Date.now() + response.data.expires_in * 1e3 - 6e4;
+      console.log("Pathao authentication successful");
+    } catch (error) {
+      console.error("Pathao authentication failed:", error);
+      throw new Error(`Authentication failed: ${this.getErrorMessage(error)}`);
+    }
+  }
+  async refreshAccessToken() {
+    if (!this.refreshToken) {
+      throw new Error("No refresh token available");
+    }
+    try {
+      const response = await this.pathaoClient.post("/aladdin/api/v1/issue-token", {
+        client_id: this.config.clientId,
+        client_secret: this.config.clientSecret,
+        refresh_token: this.refreshToken,
+        grant_type: "refresh_token"
+      });
+      this.accessToken = response.data.access_token;
+      this.refreshToken = response.data.refresh_token;
+      this.tokenExpiry = Date.now() + response.data.expires_in * 1e3 - 6e4;
+      console.log("Pathao token refresh successful");
+    } catch (error) {
+      console.error("Pathao token refresh failed:", error);
+      throw new Error(`Token refresh failed: ${this.getErrorMessage(error)}`);
+    }
+  }
+  getErrorMessage(error) {
+    if (error instanceof axios.AxiosError) {
+      const pathaoError = error.response?.data;
+      if (pathaoError?.message) {
+        return pathaoError.message;
+      }
+      return error.message;
+    }
+    return error.message || "Unknown error";
+  }
+  // Official Pathao API: Create Order
+  async createOrder(orderData) {
+    try {
+      console.log("Creating Pathao order:", {
+        store_id: orderData.store_id,
+        merchant_order_id: orderData.merchant_order_id,
+        recipient_name: orderData.recipient_name,
+        recipient_phone: orderData.recipient_phone,
+        delivery_type: orderData.delivery_type,
+        item_type: orderData.item_type,
+        item_weight: orderData.item_weight,
+        amount_to_collect: orderData.amount_to_collect
+      });
+      const response = await this.pathaoClient.post("/aladdin/api/v1/orders", orderData);
+      console.log("Pathao order created successfully:", {
+        consignment_id: response.data.data?.consignment_id,
+        invoice_id: response.data.data?.invoice_id,
+        status: response.data.data?.status
+      });
+      return response.data;
+    } catch (error) {
+      console.error("Pathao order creation failed:", {
+        error: error.message,
+        response: error.response?.data,
+        status: error.response?.status,
+        orderData
+      });
+      const errorMessage = this.getErrorMessage(error);
+      throw new Error(`Failed to create Pathao order: ${errorMessage}`);
+    }
+  }
+  // Official Pathao API: Create Store
+  async createStore(storeData) {
+    try {
+      console.log("Creating Pathao store:", {
+        name: storeData.name,
+        contact_name: storeData.contact_name,
+        city_id: storeData.city_id,
+        zone_id: storeData.zone_id,
+        area_id: storeData.area_id
+      });
+      const response = await this.pathaoClient.post("/aladdin/api/v1/stores", storeData);
+      console.log("Pathao store created successfully:", {
+        store_id: response.data.data?.store_id,
+        name: response.data.data?.name,
+        status: response.data.data?.status
+      });
+      return response.data;
+    } catch (error) {
+      console.error("Pathao store creation failed:", {
+        error: error.message,
+        response: error.response?.data,
+        status: error.response?.status,
+        storeData
+      });
+      const errorMessage = this.getErrorMessage(error);
+      throw new Error(`Failed to create Pathao store: ${errorMessage}`);
+    }
+  }
+  // Official Pathao API: Get Store List
+  async getStores() {
+    try {
+      const response = await this.pathaoClient.get("/aladdin/api/v1/stores");
+      return response.data.data || [];
+    } catch (error) {
+      console.error("Failed to fetch Pathao stores:", error);
+      const errorMessage = this.getErrorMessage(error);
+      throw new Error(`Failed to fetch Pathao stores: ${errorMessage}`);
+    }
+  }
+  // Official Pathao API: Calculate Price
+  async calculatePrice(priceData) {
+    try {
+      console.log("Calculating Pathao price:", {
+        store_id: priceData.store_id,
+        item_type: priceData.item_type,
+        item_weight: priceData.item_weight,
+        delivery_type: priceData.delivery_type,
+        recipient_city: priceData.recipient_city,
+        recipient_zone: priceData.recipient_zone,
+        recipient_area: priceData.recipient_area
+      });
+      const response = await this.pathaoClient.post("/aladdin/api/v1/merchant/price-check", priceData);
+      console.log("Pathao price calculated:", {
+        delivery_charge: response.data.data?.delivery_charge,
+        cod_charge: response.data.data?.cod_charge,
+        total_charge: response.data.data?.total_charge
+      });
+      return response.data;
+    } catch (error) {
+      console.error("Pathao price calculation failed:", {
+        error: error.message,
+        response: error.response?.data,
+        status: error.response?.status,
+        priceData
+      });
+      const errorMessage = this.getErrorMessage(error);
+      throw new Error(`Failed to calculate Pathao price: ${errorMessage}`);
+    }
+  }
+  // Official Pathao API: Get Cities
+  async getCities() {
+    try {
+      const response = await this.pathaoClient.get("/aladdin/api/v1/cities");
+      return response.data;
+    } catch (error) {
+      console.error("Failed to fetch Pathao cities:", error);
+      const errorMessage = this.getErrorMessage(error);
+      throw new Error(`Failed to fetch Pathao cities: ${errorMessage}`);
+    }
+  }
+  // Official Pathao API: Get Areas
+  async getAreas() {
+    try {
+      const response = await this.pathaoClient.get("/aladdin/api/v1/areas");
+      return response.data;
+    } catch (error) {
+      console.error("Failed to fetch Pathao areas:", error);
+      const errorMessage = this.getErrorMessage(error);
+      throw new Error(`Failed to fetch Pathao areas: ${errorMessage}`);
+    }
+  }
+  // Official Pathao API: Get Order Status
+  async getOrderStatus(consignmentId) {
+    try {
+      const response = await this.pathaoClient.get(`/aladdin/api/v1/orders/${consignmentId}`);
+      return response.data;
+    } catch (error) {
+      console.error("Failed to fetch Pathao order status:", error);
+      const errorMessage = this.getErrorMessage(error);
+      throw new Error(`Failed to fetch Pathao order status: ${errorMessage}`);
+    }
+  }
+  // Helper method to validate phone number
+  static validatePhoneNumber(phone) {
+    const cleanPhone = phone.replace(/\D/g, "");
+    return cleanPhone.length === 11 && cleanPhone.startsWith("01");
+  }
+  // Helper method to format phone number
+  static formatPhoneNumber(phone) {
+    const cleanPhone = phone.replace(/\D/g, "");
+    if (cleanPhone.length === 11 && cleanPhone.startsWith("01")) {
+      return cleanPhone;
+    }
+    throw new Error("Invalid phone number format. Must be 11 digits starting with 01");
+  }
+  // Helper method to validate address
+  static validateAddress(address) {
+    const trimmed = address.trim();
+    return trimmed.length >= 10 && trimmed.length <= 220;
+  }
+  // Helper method to validate weight
+  static validateWeight(weight) {
+    return weight >= 0.5 && weight <= 10;
+  }
+  // Helper method to validate recipient name
+  static validateRecipientName(name) {
+    const trimmed = name.trim();
+    return trimmed.length >= 3 && trimmed.length <= 100;
+  }
+};
+
+// src/types.ts
+var DeliveryType = /* @__PURE__ */ ((DeliveryType2) => {
+  DeliveryType2[DeliveryType2["NORMAL"] = 48] = "NORMAL";
+  DeliveryType2[DeliveryType2["ON_DEMAND"] = 12] = "ON_DEMAND";
+  return DeliveryType2;
+})(DeliveryType || {});
+var ItemType = /* @__PURE__ */ ((ItemType2) => {
+  ItemType2[ItemType2["DOCUMENT"] = 1] = "DOCUMENT";
+  ItemType2[ItemType2["PARCEL"] = 2] = "PARCEL";
+  return ItemType2;
+})(ItemType || {});
+var StoreType = /* @__PURE__ */ ((StoreType2) => {
+  StoreType2[StoreType2["PICKUP_POINT"] = 1] = "PICKUP_POINT";
+  StoreType2[StoreType2["SERVICE_POINT"] = 2] = "SERVICE_POINT";
+  return StoreType2;
+})(StoreType || {});
+
+exports.DeliveryType = DeliveryType;
+exports.ItemType = ItemType;
+exports.PathaoApiService = PathaoApiService;
+exports.StoreType = StoreType;
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/pathao-api.ts","../src/types.ts"],"names":["axios","config","AxiosError","DeliveryType","ItemType","StoreType"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Pathao Merchant API Service (Unofficial SDK)\n * \n * This is an unofficial SDK for the Pathao Merchant API.\n * \n * API Details (based on public documentation):\n * - Authentication: OAuth2 with client_id, client_secret, username, password\n * - Live URL: https://api-hermes.pathao.com\n * - All endpoints use /aladdin/api/v1/ prefix\n * \n * Features implemented:\n * - Token-based authentication with refresh token support\n * - Store management (create, list stores)\n * - Order creation (single and bulk)\n * - Order tracking and status\n * - Dynamic price calculation\n * - City, zone, and area management\n */\n\nimport axios, { AxiosInstance, AxiosError } from 'axios';\nimport {\n  PathaoConfig,\n  PathaoAuthResponse,\n  PathaoOrderRequest,\n  PathaoOrderResponse,\n  PathaoStoreRequest,\n  PathaoStoreResponse,\n  PathaoPriceRequest,\n  PathaoPriceResponse,\n  PathaoCityResponse,\n  PathaoOrderStatusResponse,\n  PathaoAreaResponse,\n  PathaoError\n} from './types';\n\nexport class PathaoApiService {\n  private pathaoClient: AxiosInstance;\n  private accessToken: string | null = null;\n  private refreshToken: string | null = null;\n  private tokenExpiry: number | null = null;\n  private config: PathaoConfig;\n\n  constructor(config: PathaoConfig) {\n    this.config = {\n      baseURL: 'https://api-hermes.pathao.com',\n      timeout: 30000,\n      ...config\n    };\n\n    this.pathaoClient = axios.create({\n      baseURL: this.config.baseURL || 'https://api-hermes.pathao.com',\n      timeout: this.config.timeout || 30000,\n      headers: {\n        'Content-Type': 'application/json',\n        'Accept': 'application/json',\n      },\n    });\n\n    // Validate required credentials\n    if (!this.config.clientId || !this.config.clientSecret || !this.config.username || !this.config.password) {\n      throw new Error('Pathao API credentials are required: clientId, clientSecret, username, password');\n    }\n\n    // Add request interceptor for authentication\n    this.pathaoClient.interceptors.request.use(async (config) => {\n      await this.ensureAuthenticated();\n      if (this.accessToken) {\n        config.headers.Authorization = `Bearer ${this.accessToken}`;\n      }\n      return config;\n    });\n  }\n\n  private async ensureAuthenticated(): Promise<void> {\n    if (this.accessToken && this.tokenExpiry && Date.now() < this.tokenExpiry) {\n      return; // Token is still valid\n    }\n\n    if (this.refreshToken) {\n      try {\n        await this.refreshAccessToken();\n        return;\n      } catch (error) {\n        console.warn('Token refresh failed, attempting fresh authentication');\n      }\n    }\n\n    await this.authenticate();\n  }\n\n  private async authenticate(): Promise<void> {\n    try {\n      const response = await this.pathaoClient.post<PathaoAuthResponse>('/aladdin/api/v1/issue-token', {\n        client_id: this.config.clientId,\n        client_secret: this.config.clientSecret,\n        username: this.config.username,\n        password: this.config.password,\n        grant_type: 'password'\n      });\n\n      this.accessToken = response.data.access_token;\n      this.refreshToken = response.data.refresh_token;\n      this.tokenExpiry = Date.now() + (response.data.expires_in * 1000) - 60000; // 1 minute buffer\n\n      console.log('Pathao authentication successful');\n    } catch (error) {\n      console.error('Pathao authentication failed:', error);\n      throw new Error(`Authentication failed: ${this.getErrorMessage(error)}`);\n    }\n  }\n\n  private async refreshAccessToken(): Promise<void> {\n    if (!this.refreshToken) {\n      throw new Error('No refresh token available');\n    }\n\n    try {\n      const response = await this.pathaoClient.post<PathaoAuthResponse>('/aladdin/api/v1/issue-token', {\n        client_id: this.config.clientId,\n        client_secret: this.config.clientSecret,\n        refresh_token: this.refreshToken,\n        grant_type: 'refresh_token'\n      });\n\n      this.accessToken = response.data.access_token;\n      this.refreshToken = response.data.refresh_token;\n      this.tokenExpiry = Date.now() + (response.data.expires_in * 1000) - 60000; // 1 minute buffer\n\n      console.log('Pathao token refresh successful');\n    } catch (error) {\n      console.error('Pathao token refresh failed:', error);\n      throw new Error(`Token refresh failed: ${this.getErrorMessage(error)}`);\n    }\n  }\n\n  private getErrorMessage(error: any): string {\n    if (error instanceof AxiosError) {\n      const pathaoError = error.response?.data as PathaoError;\n      if (pathaoError?.message) {\n        return pathaoError.message;\n      }\n      return error.message;\n    }\n    return error.message || 'Unknown error';\n  }\n\n  // Official Pathao API: Create Order\n  async createOrder(orderData: PathaoOrderRequest): Promise<PathaoOrderResponse> {\n    try {\n      console.log('Creating Pathao order:', {\n        store_id: orderData.store_id,\n        merchant_order_id: orderData.merchant_order_id,\n        recipient_name: orderData.recipient_name,\n        recipient_phone: orderData.recipient_phone,\n        delivery_type: orderData.delivery_type,\n        item_type: orderData.item_type,\n        item_weight: orderData.item_weight,\n        amount_to_collect: orderData.amount_to_collect\n      });\n      \n      const response = await this.pathaoClient.post<PathaoOrderResponse>('/aladdin/api/v1/orders', orderData);\n      \n      console.log('Pathao order created successfully:', {\n        consignment_id: response.data.data?.consignment_id,\n        invoice_id: response.data.data?.invoice_id,\n        status: response.data.data?.status\n      });\n      \n      return response.data;\n    } catch (error: any) {\n      console.error('Pathao order creation failed:', {\n        error: error.message,\n        response: error.response?.data,\n        status: error.response?.status,\n        orderData: orderData\n      });\n      \n      const errorMessage = this.getErrorMessage(error);\n      throw new Error(`Failed to create Pathao order: ${errorMessage}`);\n    }\n  }\n\n  // Official Pathao API: Create Store\n  async createStore(storeData: PathaoStoreRequest): Promise<PathaoStoreResponse> {\n    try {\n      console.log('Creating Pathao store:', {\n        name: storeData.name,\n        contact_name: storeData.contact_name,\n        city_id: storeData.city_id,\n        zone_id: storeData.zone_id,\n        area_id: storeData.area_id\n      });\n      \n      const response = await this.pathaoClient.post<PathaoStoreResponse>('/aladdin/api/v1/stores', storeData);\n      \n      console.log('Pathao store created successfully:', {\n        store_id: response.data.data?.store_id,\n        name: response.data.data?.name,\n        status: response.data.data?.status\n      });\n      \n      return response.data;\n    } catch (error: any) {\n      console.error('Pathao store creation failed:', {\n        error: error.message,\n        response: error.response?.data,\n        status: error.response?.status,\n        storeData: storeData\n      });\n      \n      const errorMessage = this.getErrorMessage(error);\n      throw new Error(`Failed to create Pathao store: ${errorMessage}`);\n    }\n  }\n\n  // Official Pathao API: Get Store List\n  async getStores(): Promise<PathaoStoreResponse[]> {\n    try {\n      const response = await this.pathaoClient.get<{ data: PathaoStoreResponse[] }>('/aladdin/api/v1/stores');\n      return response.data.data || [];\n    } catch (error: any) {\n      console.error('Failed to fetch Pathao stores:', error);\n      const errorMessage = this.getErrorMessage(error);\n      throw new Error(`Failed to fetch Pathao stores: ${errorMessage}`);\n    }\n  }\n\n  // Official Pathao API: Calculate Price\n  async calculatePrice(priceData: PathaoPriceRequest): Promise<PathaoPriceResponse> {\n    try {\n      console.log('Calculating Pathao price:', {\n        store_id: priceData.store_id,\n        item_type: priceData.item_type,\n        item_weight: priceData.item_weight,\n        delivery_type: priceData.delivery_type,\n        recipient_city: priceData.recipient_city,\n        recipient_zone: priceData.recipient_zone,\n        recipient_area: priceData.recipient_area\n      });\n      \n      const response = await this.pathaoClient.post<PathaoPriceResponse>('/aladdin/api/v1/merchant/price-check', priceData);\n      \n      console.log('Pathao price calculated:', {\n        delivery_charge: response.data.data?.delivery_charge,\n        cod_charge: response.data.data?.cod_charge,\n        total_charge: response.data.data?.total_charge\n      });\n      \n      return response.data;\n    } catch (error: any) {\n      console.error('Pathao price calculation failed:', {\n        error: error.message,\n        response: error.response?.data,\n        status: error.response?.status,\n        priceData: priceData\n      });\n      \n      const errorMessage = this.getErrorMessage(error);\n      throw new Error(`Failed to calculate Pathao price: ${errorMessage}`);\n    }\n  }\n\n  // Official Pathao API: Get Cities\n  async getCities(): Promise<PathaoCityResponse> {\n    try {\n      const response = await this.pathaoClient.get<PathaoCityResponse>('/aladdin/api/v1/cities');\n      return response.data;\n    } catch (error: any) {\n      console.error('Failed to fetch Pathao cities:', error);\n      const errorMessage = this.getErrorMessage(error);\n      throw new Error(`Failed to fetch Pathao cities: ${errorMessage}`);\n    }\n  }\n\n  // Official Pathao API: Get Areas\n  async getAreas(): Promise<PathaoAreaResponse> {\n    try {\n      const response = await this.pathaoClient.get<PathaoAreaResponse>('/aladdin/api/v1/areas');\n      return response.data;\n    } catch (error: any) {\n      console.error('Failed to fetch Pathao areas:', error);\n      const errorMessage = this.getErrorMessage(error);\n      throw new Error(`Failed to fetch Pathao areas: ${errorMessage}`);\n    }\n  }\n\n  // Official Pathao API: Get Order Status\n  async getOrderStatus(consignmentId: string): Promise<PathaoOrderStatusResponse> {\n    try {\n      const response = await this.pathaoClient.get<PathaoOrderStatusResponse>(`/aladdin/api/v1/orders/${consignmentId}`);\n      return response.data;\n    } catch (error: any) {\n      console.error('Failed to fetch Pathao order status:', error);\n      const errorMessage = this.getErrorMessage(error);\n      throw new Error(`Failed to fetch Pathao order status: ${errorMessage}`);\n    }\n  }\n\n  // Helper method to validate phone number\n  static validatePhoneNumber(phone: string): boolean {\n    const cleanPhone = phone.replace(/\\D/g, '');\n    return cleanPhone.length === 11 && cleanPhone.startsWith('01');\n  }\n\n  // Helper method to format phone number\n  static formatPhoneNumber(phone: string): string {\n    const cleanPhone = phone.replace(/\\D/g, '');\n    if (cleanPhone.length === 11 && cleanPhone.startsWith('01')) {\n      return cleanPhone;\n    }\n    throw new Error('Invalid phone number format. Must be 11 digits starting with 01');\n  }\n\n  // Helper method to validate address\n  static validateAddress(address: string): boolean {\n    const trimmed = address.trim();\n    return trimmed.length >= 10 && trimmed.length <= 220;\n  }\n\n  // Helper method to validate weight\n  static validateWeight(weight: number): boolean {\n    return weight >= 0.5 && weight <= 10;\n  }\n\n  // Helper method to validate recipient name\n  static validateRecipientName(name: string): boolean {\n    const trimmed = name.trim();\n    return trimmed.length >= 3 && trimmed.length <= 100;\n  }\n}\n","/**\n * Pathao Courier API Types\n * \n * Official API Details:\n * - Authentication: OAuth2 with client_id, client_secret, username, password\n * - Live URL: https://api-hermes.pathao.com\n * - All endpoints use /aladdin/api/v1/ prefix\n */\n\n// Official Pathao API Authentication Response\nexport interface PathaoAuthResponse {\n  token_type: string;\n  expires_in: number;\n  access_token: string;\n  refresh_token: string;\n}\n\n// Official Pathao Order Creation Request\nexport interface PathaoOrderRequest {\n  store_id: number;\n  merchant_order_id?: string;          // Optional - Your order tracking ID\n  recipient_name: string;              // Required - 3-100 characters\n  recipient_phone: string;             // Required - 11 characters\n  recipient_secondary_phone?: string;  // Optional - 11 characters\n  recipient_address: string;           // Required - 10-220 characters\n  recipient_city?: number;             // Optional - Auto-detected if not provided\n  recipient_zone?: number;             // Optional - Auto-detected if not provided\n  recipient_area?: number;             // Optional - Auto-detected if not provided\n  delivery_type: number;               // Required - 48 (Normal), 12 (On Demand)\n  item_type: number;                   // Required - 1 (Document), 2 (Parcel)\n  special_instruction?: string;        // Optional\n  item_quantity: number;               // Required\n  item_weight: number;                 // Required - 0.5-10 kg\n  item_description?: string;           // Optional\n  amount_to_collect: number;           // Required - COD amount (0 for non-COD)\n}\n\n// Official Pathao Store Creation Request\nexport interface PathaoStoreRequest {\n  name: string;\n  contact_name: string;\n  contact_number: string;\n  address: string;\n  city_id: number;\n  zone_id: number;\n  area_id: number;\n  store_type: number;                  // 1 (Pickup Point), 2 (Service Point)\n}\n\n// Official Pathao Order Response\nexport interface PathaoOrderResponse {\n  type: string;\n  code: number;\n  message: string;\n  data: {\n    consignment_id: string;\n    invoice_id: string;\n    merchant_order_id: string;\n    store_id: number;\n    recipient_name: string;\n    recipient_phone: string;\n    recipient_address: string;\n    recipient_city: string;\n    recipient_zone: string;\n    recipient_area: string;\n    delivery_type: string;\n    item_type: string;\n    item_quantity: number;\n    item_weight: number;\n    item_description: string;\n    amount_to_collect: number;\n    special_instruction: string;\n    status: string;\n    created_at: string;\n    updated_at: string;\n  };\n}\n\n// Official Pathao Store Response\nexport interface PathaoStoreResponse {\n  type: string;\n  code: number;\n  message: string;\n  data: {\n    store_id: number;\n    name: string;\n    contact_name: string;\n    contact_number: string;\n    address: string;\n    city_id: number;\n    zone_id: number;\n    area_id: number;\n    store_type: number;\n    status: string;\n    created_at: string;\n    updated_at: string;\n  };\n}\n\n// Official Pathao Price Calculation Request\nexport interface PathaoPriceRequest {\n  store_id: number;\n  item_type: number;\n  item_weight: number;\n  delivery_type: number;\n  recipient_city: number;\n  recipient_zone: number;\n  recipient_area: number;\n}\n\n// Official Pathao Price Response\nexport interface PathaoPriceResponse {\n  type: string;\n  code: number;\n  message: string;\n  data: {\n    store_id: number;\n    item_type: string;\n    item_weight: number;\n    delivery_type: string;\n    recipient_city: string;\n    recipient_zone: string;\n    recipient_area: string;\n    delivery_charge: number;\n    cod_charge: number;\n    total_charge: number;\n    currency: string;\n  };\n}\n\n// Official Pathao City Response\nexport interface PathaoCityResponse {\n  type: string;\n  code: number;\n  message: string;\n  data: Array<{\n    city_id: number;\n    city_name: string;\n    zone_list: Array<{\n      zone_id: number;\n      zone_name: string;\n      area_list: Array<{\n        area_id: number;\n        area_name: string;\n      }>;\n    }>;\n  }>;\n}\n\n// Official Pathao Order Status Response\nexport interface PathaoOrderStatusResponse {\n  type: string;\n  code: number;\n  message: string;\n  data: {\n    consignment_id: string;\n    invoice_id: string;\n    merchant_order_id: string;\n    store_id: number;\n    recipient_name: string;\n    recipient_phone: string;\n    recipient_address: string;\n    recipient_city: string;\n    recipient_zone: string;\n    recipient_area: string;\n    delivery_type: string;\n    item_type: string;\n    item_quantity: number;\n    item_weight: number;\n    item_description: string;\n    amount_to_collect: number;\n    special_instruction: string;\n    status: string;\n    status_updated_at: string;\n    created_at: string;\n    updated_at: string;\n  };\n}\n\n// Official Pathao Area Response\nexport interface PathaoAreaResponse {\n  type: string;\n  code: number;\n  message: string;\n  data: Array<{\n    area_id: number;\n    area_name: string;\n    zone_id: number;\n    zone_name: string;\n    city_id: number;\n    city_name: string;\n  }>;\n}\n\n// Configuration options for PathaoApiService\nexport interface PathaoConfig {\n  clientId: string;\n  clientSecret: string;\n  username: string;\n  password: string;\n  baseURL?: string;\n  timeout?: number;\n}\n\n// Error response from Pathao API\nexport interface PathaoError {\n  type: string;\n  code: number;\n  message: string;\n  errors?: Record<string, string[]>;\n  validation?: Record<string, string[]>;\n}\n\n// Delivery types enum\nexport enum DeliveryType {\n  NORMAL = 48,\n  ON_DEMAND = 12\n}\n\n// Item types enum\nexport enum ItemType {\n  DOCUMENT = 1,\n  PARCEL = 2\n}\n\n// Store types enum\nexport enum StoreType {\n  PICKUP_POINT = 1,\n  SERVICE_POINT = 2\n}\n"]}