universal-parcel-scraper 0.3.3-main.315 → 0.3.4-main.317

package/README.md

@@ -149,7 +149,7 @@ createTracker({ providers: ['ParcelsApp', 'Ship24', '17TRACK', 'Postal Ninja', '
 <!-- GENERATED:stages -->
 <img src="docs/assets/stages.svg" alt="DHL: Die Sendung wurde in das Zustellfahrzeug geladen.; Mondial Relay: En cours de livraison; Correios Brazil: Objeto saiu para entrega ao destinatário; Correos Express: EN REPARTO; Yamato Transport: 配達中; La Poste / Colissimo: DISTOU. All are filed under out_for_delivery." width="760">
 
-The carrier folders record 1,672 such statuses, each filed under one stage.
+The carrier folders record 1,673 such statuses, each filed under one stage.
 <!-- /GENERATED:stages -->
 
 Wording nobody recorded yet goes through a classifier that reads seven European languages.

package/dist/carriers/delhivery/parser.js

@@ -22,7 +22,8 @@ export function parseDelhivery(payload, number) {
         throw new SchemaError('Delhivery');
     if (!payload.data.length && payload.message === 'invalid AWB or very old package')
         throw new NotFoundError('Delhivery');
-    const matches = payload.data.filter(isRecord).filter(item => clean(item.awb, 64) === requested);
+    const matches = payload.data.filter(isRecord).filter(item => (typeof item.awb === 'string' ? item.awb.trim()
+        : typeof item.awb === 'number' && Number.isSafeInteger(item.awb) ? String(item.awb) : '') === requested);
     if (matches.length !== 1)
         throw new SchemaError('Delhivery', 'Delhivery did not return one matching shipment');
     const item = matches[0];
@@ -31,7 +32,14 @@ export function parseDelhivery(payload, number) {
     const description = clean(item.status.status, 200);
     if (!description)
         throw new IndeterminateError('Delhivery', 'Delhivery returned no current status');
-    const mapped = classifyDelhiveryStatus(description);
+    const returning = item.status.statusType === 'RT' || item.currentFlow === 'Returned' || item.currentFlow === 'Reverse';
+    // RETURNED names a flow, including parcels still travelling to the sender.
+    // The separate shipment status establishes movement or completed delivery.
+    const snapshotDescription = returning && description.toUpperCase() === 'RETURNED'
+        ? clean(item.hqStatus, 200) : description;
+    const current = classifyDelhiveryStatus(snapshotDescription);
+    const mapped = returning && current?.stage === 'delivered'
+        ? classifyDelhiveryStatus('RTO DELIVERED') : current;
     const updated = scanTime(item.status.statusDateTime);
     const currentTimeText = clean(item.status.statusDateTime, 64);
     const events = [];
@@ -56,21 +64,25 @@ export function parseDelhivery(payload, number) {
             const time = scanTime(scan.scanDateTime);
             const timeText = clean(scan.scanDateTime, 64);
             const location = clean(scan.cityLocation, 160);
-            const key = `${time?.timestamp ?? timeText}\u0000${label}\u0000${location}`;
+            const returnScan = scan.scanType === 'RT' || item.currentFlow === 'Reverse';
+            const key = `${time?.timestamp ?? timeText}\u0000${label}\u0000${location}\u0000${returnScan ? 'return' : ''}`;
             if (seen.has(key))
                 continue;
             seen.add(key);
-            const classified = classifyDelhiveryStatus(label);
+            const scanStatus = classifyDelhiveryStatus(label);
+            const classified = returnScan && scanStatus?.stage === 'delivered'
+                ? classifyDelhiveryStatus('RTO DELIVERED') : scanStatus;
             events.push({ description: label, ...(time ? { time: time.iso } : timeText ? { provider_time_text: timeText } : {}), ...(location ? { location } : {}),
-                ...(classified ? { stage: classified.stage } : {}) });
+                ...(classified ? { stage: classified.stage } : {}), ...(returnScan ? { provider_leg: 'return' } : {}) });
         }
     }
     // Repeated scan labels cannot bind a summary timestamp to a particular
     // historical location. Keep the dated status snapshot separate.
-    if (!updated || !events.some(event => event.time && Date.parse(event.time) === updated.timestamp
-        && event.description?.toUpperCase() === description.toUpperCase())) {
-        events.unshift({ description, ...(updated ? { time: updated.iso } : currentTimeText ? { provider_time_text: currentTimeText } : {}),
-            ...(mapped ? { stage: mapped.stage } : {}), summary_snapshot: true });
+    if (snapshotDescription && (!updated || !events.some(event => event.time && Date.parse(event.time) === updated.timestamp
+        && event.description?.toUpperCase() === snapshotDescription.toUpperCase() && event.stage === mapped?.stage
+        && (!returning || event.provider_leg === 'return')))) {
+        events.unshift({ description: snapshotDescription, ...(updated ? { time: updated.iso } : currentTimeText ? { provider_time_text: currentTimeText } : {}),
+            ...(mapped ? { stage: mapped.stage } : {}), ...(returning ? { provider_leg: 'return' } : {}), summary_snapshot: true });
     }
     const dated = events.filter(event => event.time).sort((a, b) => Date.parse(b.time) - Date.parse(a.time));
     const undated = events.filter(event => !event.time);

package/dist/carriers/delhivery/status.js

@@ -2,9 +2,11 @@ const statuses = {
     DELIVERED: { status: 'delivered', stage: 'delivered' },
     'OUT FOR DELIVERY': { status: 'out_for_delivery', stage: 'out_for_delivery' },
     'IN TRANSIT': { status: 'in_transit', stage: 'in_transit' },
+    'IN TRANSIT FOR RETURN': { status: 'in_transit', stage: 'in_transit' },
     'PICKED UP': { status: 'in_transit', stage: 'accepted' },
     MANIFESTED: { status: 'pending', stage: 'registered' },
     'RTO DELIVERED': { status: 'exception', stage: 'returned' },
+    DELIVERED_SELLER: { status: 'exception', stage: 'returned' },
 };
 export function classifyDelhiveryStatus(value) {
     return statuses[value.toUpperCase()];

package/dist/carriers/delhivery/statuses.json

@@ -6,6 +6,12 @@
       "language": "en",
       "stage": "delivered",
       "confirmedBy": "live"
+    },
+    {
+      "wording": "In Transit",
+      "language": "en",
+      "stage": "in_transit",
+      "confirmedBy": "live"
     }
   ]
 }

package/dist/carriers/packeta/adapter.js

@@ -1,5 +1,5 @@
 import { lookupBudget } from '../../core/adapter/index.js';
-import { InvalidInputError, NotFoundError, SchemaError } from '../../core/errors/index.js';
+import { IndeterminateError, InvalidInputError, NotFoundError, SchemaError } from '../../core/errors/index.js';
 import { zonedTime } from '../../core/time/index.js';
 import { clean, fetchBounded, parseJsonBytes, UpstreamHttpError, userAgentOf } from '../../core/transport/index.js';
 import { isRecord } from '../../core/types.js';
@@ -52,11 +52,13 @@ export function parsePacketaTrackingResponse(payload, trackingNumber) {
     if (!isRecord(payload))
         throw new SchemaError('Packeta', 'Packeta returned an invalid tracking response');
     const item = payload.item;
-    // A 200 carrying an error instead of an item is Packeta's second unknown-code
-    // signal (mirrors the HTTP 404 contract); it is a domain outcome, not a crash.
+    // Only the named notFound error establishes absence; other API errors say
+    // nothing about the requested parcel.
     if (!isRecord(item)) {
-        if (typeof payload.error === 'string')
+        if (payload.error === 'notFound')
             throw new NotFoundError('Packeta');
+        if (typeof payload.error === 'string')
+            throw new IndeterminateError('Packeta', 'Packeta returned a tracking error');
         throw new SchemaError('Packeta', 'Packeta returned an invalid tracking response');
     }
     const returned = typeof item.barcode === 'string'
@@ -159,8 +161,18 @@ export class PacketaTracker {
             allowHttpError: true,
             fetcher: this.fetcher,
         });
-        if (response.status === 404)
-            throw new NotFoundError('Packeta');
+        if (response.status === 404) {
+            let payload;
+            try {
+                payload = parseJsonBytes(bytes, 'Packeta tracking');
+            }
+            catch {
+                throw new UpstreamHttpError('Packeta tracking', response.status);
+            }
+            if (isRecord(payload) && payload.error === 'notFound')
+                throw new NotFoundError('Packeta');
+            throw new UpstreamHttpError('Packeta tracking', response.status);
+        }
         if (!response.ok)
             throw new UpstreamHttpError('Packeta tracking', response.status);
         return parsePacketaTrackingResponse(parseJsonBytes(bytes, 'Packeta tracking'), trackingNumber);

package/dist/server/openapi.json

@@ -2,7 +2,7 @@
   "openapi": "3.1.0",
   "info": {
     "title": "Universal Parcel Scraper",
-    "version": "0.3.3"
+    "version": "0.3.4"
   },
   "paths": {
     "/health": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "universal-parcel-scraper",
-  "version": "0.3.3-main.315",
+  "version": "0.3.4-main.317",
   "description": "Self-hosted parcel tracking: carrier detection, dedicated scrapers and optional universal providers.",
   "type": "module",
   "license": "Apache-2.0",