feat(v2.1.0): upgrade Aura Courier MCP with 4 couriers (Steadfast, Pathao, RedX, Paperfly), multi-client configs, Glama badge & AI fraud engine

src/adapters/paperfly.ts

@@ -0,0 +1,111 @@
+import axios, { AxiosInstance } from "axios";
+import { CourierAdapter } from "./base.js";
+import {
+  BalanceResponse,
+  LocationResolutionResponse,
+  ParcelCreateRequest,
+  ParcelResponse,
+  SupportedCourier,
+  TrackingResponse,
+} from "../types.js";
+
+export class PaperflyAdapter implements CourierAdapter {
+  courierName: SupportedCourier = "paperfly";
+  private client: AxiosInstance;
+  private user: string;
+  private pass: string;
+  private key: string;
+  private enabled: boolean;
+
+  constructor(
+    user: string,
+    pass: string,
+    key: string,
+    baseUrl: string = "https://api.paperfly.com.bd"
+  ) {
+    this.user = user;
+    this.pass = pass;
+    this.key = key;
+    this.enabled = Boolean(user && pass && key);
+
+    const token = Buffer.from(`${user}:${pass}`).toString("base64");
+    this.client = axios.create({
+      baseURL: baseUrl,
+      headers: {
+        Authorization: `Basic ${token}`,
+        pap_key: key,
+        "Content-Type": "application/json",
+      },
+      timeout: 10000,
+    });
+  }
+
+  isConfigured(): boolean {
+    return this.enabled;
+  }
+
+  async createParcel(req: ParcelCreateRequest): Promise<ParcelResponse> {
+    if (!this.enabled) {
+      throw new Error("Paperfly Courier credentials (User / Pass / Key) are not configured.");
+    }
+
+    const payload = {
+      merOrderRef: req.invoice,
+      pickMerchantName: "Aura AI Commerce",
+      pickMerchantAddress: "Dhaka, Bangladesh",
+      custName: req.recipient_name,
+      custPhone: req.recipient_phone,
+      custAddr: req.recipient_address,
+      customerDistrict: "Dhaka",
+      customerThana: "Gulshan",
+      packagePrice: req.cod_amount,
+      max_weight: req.item_weight || 0.5,
+      productBrief: req.item_type || "General Ecommerce item",
+      deliveryOption: "regular",
+    };
+
+    const response = await this.client.post("/OrderPlacement", payload);
+    const trackingCode = response.data?.tracking_number || req.invoice;
+
+    return {
+      success: true,
+      courier: "paperfly",
+      tracking_code: trackingCode,
+      consignment_id: trackingCode,
+      invoice: req.invoice,
+      status: "order_placed",
+      cod_amount: req.cod_amount,
+      created_at: new Date().toISOString(),
+      raw_response: response.data,
+    };
+  }
+
+  async trackParcel(trackingCode: string): Promise<TrackingResponse> {
+    if (!this.enabled) {
+      throw new Error("Paperfly Courier credentials are not configured.");
+    }
+
+    const response = await this.client.post("/Tracking", {
+      ReferenceNumber: trackingCode,
+    });
+    const data = response.data;
+
+    return {
+      success: true,
+      courier: "paperfly",
+      tracking_code: trackingCode,
+      status: data?.Status || "in_progress",
+      updated_at: new Date().toISOString(),
+      raw_response: data,
+    };
+  }
+
+  async getBalance(): Promise<BalanceResponse> {
+    return {
+      success: true,
+      courier: "paperfly",
+      current_balance: 0,
+      raw_response: { message: "Paperfly merchant settlements processed weekly via Wingman portal." },
+    };
+  }
+}