Directory-submission readiness: add MCP tool annotations (title + readOnlyHint/destructiveHint), /privacy policy route + README Privacy Policy section, bump to 2.3.2

dist/adapters/paperfly.js

@@ -1,25 +1,22 @@
 import axios from "axios";
 export class PaperflyAdapter {
     courierName = "paperfly";
+    apiKey;
+    username;
+    password;
+    storeName;
     client;
-    user;
-    pass;
-    key;
     enabled;
-    constructor(user, pass, key, baseUrl = "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");
+    constructor(apiKey, username, password, storeName, baseUrl) {
+        this.apiKey = apiKey;
+        this.username = username;
+        this.password = password;
+        this.storeName = storeName;
+        this.enabled = Boolean(apiKey && username && password);
         this.client = axios.create({
             baseURL: baseUrl,
-            headers: {
-                Authorization: `Basic ${token}`,
-                pap_key: key,
-                "Content-Type": "application/json",
-            },
-            timeout: 10000,
+            timeout: 15000,
+            headers: { "Content-Type": "application/json" },
         });
     }
     isConfigured() {
@@ -27,59 +24,73 @@ export class PaperflyAdapter {
     }
     async createParcel(req) {
         if (!this.enabled) {
-            throw new Error("Paperfly Courier credentials (User / Pass / Key) are not configured.");
+            throw new Error("Paperfly credentials (paperflykey + merchant username & password) are not configured.");
+        }
+        if (!this.storeName) {
+            throw new Error("Paperfly store name is required to create a parcel.");
         }
         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",
+            merchantOrderReference: req.invoice,
+            storeName: this.storeName,
+            productBrief: req.item_type || "Product",
+            packagePrice: String(req.value ?? req.cod_amount ?? 0),
+            max_weight: String(req.item_weight ?? 0.5),
+            customerName: req.recipient_name,
+            customerAddress: req.recipient_address,
+            customerPhone: req.recipient_phone,
         };
-        const response = await this.client.post("/OrderPlacement", payload);
-        const trackingCode = response.data?.tracking_number || req.invoice;
+        const response = await this.client.post("/merchant/api/service/new_order_v2.php", payload, {
+            headers: { paperflykey: this.apiKey },
+            auth: { username: this.username, password: this.password },
+        });
+        const data = response.data;
+        const ok = data?.success;
+        if (!ok?.tracking_number) {
+            throw new Error(`Paperfly API error: ${JSON.stringify(data?.error || data?.message || data)}`);
+        }
         return {
             success: true,
             courier: "paperfly",
-            tracking_code: trackingCode,
-            consignment_id: trackingCode,
+            tracking_code: ok.tracking_number,
+            consignment_id: ok.tracking_barcode || ok.tracking_number,
             invoice: req.invoice,
-            status: "order_placed",
+            status: ok.message || "created",
             cod_amount: req.cod_amount,
             created_at: new Date().toISOString(),
-            raw_response: response.data,
+            raw_response: data,
         };
     }
     async trackParcel(trackingCode) {
         if (!this.enabled) {
-            throw new Error("Paperfly Courier credentials are not configured.");
+            throw new Error("Paperfly credentials are not configured.");
         }
-        const response = await this.client.post("/Tracking", {
-            ReferenceNumber: trackingCode,
-        });
+        if (!this.username || !this.password) {
+            throw new Error("Paperfly tracking needs your merchant-panel username & password (Basic Auth). Add them to use track_parcel.");
+        }
+        // Paperfly tracks by your merchant order reference (merchantOrderReference), not its tracking number.
+        const response = await this.client.post("/API-Order-Tracking", { ReferenceNumber: trackingCode }, { headers: { paperflykey: this.apiKey }, auth: { username: this.username, password: this.password } });
         const data = response.data;
+        const st = data?.success?.trackingStatus?.[0] || {};
+        const stages = [
+            [st.Delivered, "delivered"],
+            [st.Partial, "partial-delivery"],
+            [st.Returned, "returned"],
+            [st.PickedForDelivery, "out-for-delivery"],
+            [st.inTransit, "in-transit"],
+            [st.ReceivedAtPoint, "received-at-point"],
+            [st.Pick, "picked-up"],
+        ];
+        const status = stages.find(([v]) => v && String(v).trim())?.[1] || data?.success?.message || "pending";
         return {
             success: true,
             courier: "paperfly",
             tracking_code: trackingCode,
-            status: data?.Status || "in_progress",
+            status,
             updated_at: new Date().toISOString(),
             raw_response: data,
         };
     }
     async getBalance() {
-        return {
-            success: true,
-            courier: "paperfly",
-            current_balance: 0,
-            raw_response: { message: "Paperfly merchant settlements processed weekly via Wingman portal." },
-        };
+        throw new Error("Paperfly does not expose a merchant balance endpoint via its public API — check the Paperfly merchant panel.");
     }
 }