universal-parcel-scraper 0.3.0-main.306 → 0.3.0

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,671 such statuses, each filed under one stage.
+The carrier folders record 1,672 such statuses, each filed under one stage.
 <!-- /GENERATED:stages -->
 
 Wording nobody recorded yet goes through a classifier that reads seven European languages.

package/dist/app.d.ts

@@ -1,13 +1,14 @@
 /**
  * Helpers shaped for the parcel app this package was extracted from: its
  * parcel view, carrier-name hints for provider results, the clock helpers
- * its sync uses, and the country a scan's location names. They change with
- * that app and carry no stability promise; the tracking contract is the
- * other entry points.
+ * its sync uses, carrier scan-identity policies, and the country a scan's
+ * location names. They change with that app and carry no stability promise;
+ * the tracking contract is the other entry points.
  */
 export * from './core/catalog/parcel.js';
 export * from './core/catalog/hints.js';
 export * from './core/time/result.js';
+export { sameInstantIdentityPolicy, type SameInstantIdentityPolicy } from './core/catalog/eventIdentity.js';
 export { universalCarrierHints } from './providers/shared/hints.js';
 export { recognitionAskedCarriers } from './core/catalog/recognition.js';
 export { countryFlag, countryName, trackingLocationCountry, trackingPlace, type TrackingPlace } from './places/trackingLocation.js';

package/dist/app.js

@@ -1,13 +1,14 @@
 /**
  * Helpers shaped for the parcel app this package was extracted from: its
  * parcel view, carrier-name hints for provider results, the clock helpers
- * its sync uses, and the country a scan's location names. They change with
- * that app and carry no stability promise; the tracking contract is the
- * other entry points.
+ * its sync uses, carrier scan-identity policies, and the country a scan's
+ * location names. They change with that app and carry no stability promise;
+ * the tracking contract is the other entry points.
  */
 export * from './core/catalog/parcel.js';
 export * from './core/catalog/hints.js';
 export * from './core/time/result.js';
+export { sameInstantIdentityPolicy } from './core/catalog/eventIdentity.js';
 export { universalCarrierHints } from './providers/shared/hints.js';
 export { recognitionAskedCarriers } from './core/catalog/recognition.js';
 export { countryFlag, countryName, trackingLocationCountry, trackingPlace } from './places/trackingLocation.js';

package/dist/carriers/dpd/app.d.ts

@@ -0,0 +1,2 @@
+import type { SameInstantIdentityPolicy } from '../../core/catalog/eventIdentity.js';
+export declare const sameInstantIdentityPolicy: SameInstantIdentityPolicy;

package/dist/carriers/dpd/app.js

@@ -0,0 +1,5 @@
+// Verified and postcode-free replies reword the same scans at the same instants.
+// A universal provider can also have stored those scans while DPD was unavailable.
+export const sameInstantIdentityPolicy = {
+    sourceCarrierId: 'dpd', storedSources: ['dpd', 'unknown'], requireProviderCode: false,
+};

package/dist/carriers/india-post/adapter.js

@@ -109,6 +109,24 @@ const AIRPORT_ZONES = {
     LAX: 'America/Los_Angeles', SFO: 'America/Los_Angeles', YYZ: 'America/Toronto',
     SYD: 'Australia/Sydney', MEL: 'Australia/Melbourne',
 };
+// Only verified names are expanded; other airport codes stay as the carrier wrote them.
+const AIRPORT_PLACES = {
+    BOM: { name: 'Mumbai Airport', country: 'India' },
+    DEL: { name: 'Delhi Airport', country: 'India' },
+    FRA: { name: 'Frankfurt Airport', country: 'Germany' },
+    CDG: { name: 'Paris Charles de Gaulle Airport', country: 'France' },
+};
+function departureAirport(office) {
+    return /^Office - ([A-Z]{3})\b/.exec(office)?.[1];
+}
+/** Flight remarks have a narrow format; unrelated remarks can contain recipient details. */
+function flightDescription(remarks, office) {
+    const match = /^Flight No:\s*([A-Z0-9]{2}\d{1,4}[A-Z]?)\s*\(From ([A-Z]{3}) To ([A-Z]{3})\)$/.exec(clean(remarks, 500));
+    if (!match || match[2] !== departureAirport(office))
+        return 'Aircraft Departure';
+    const airport = (code) => AIRPORT_PLACES[code] ? `${AIRPORT_PLACES[code].name} (${code})` : code;
+    return `Flight ${match[1]} departed: ${airport(match[2])} → ${airport(match[3])}`;
+}
 /**
  * The zone a take-off row's clock is kept in. Its `tracked_at` is the
  * departure airport's wall clock under a UTC label: a take-off was seen
@@ -120,7 +138,7 @@ const AIRPORT_ZONES = {
 function takeOffZone(providerCode, office, trackedAt) {
     if (providerCode !== TAKE_OFF_CODE || !UTC_LABEL.test(trackedAt))
         return null;
-    const airport = /^Office - ([A-Z]{3})\b/.exec(office)?.[1];
+    const airport = departureAirport(office);
     return airport ? AIRPORT_ZONES[airport] ?? null : null;
 }
 /**
@@ -172,13 +190,16 @@ export function parseIndiaPostTrackingHtml(html, trackingNumber) {
         const time = zone
             ? mislabeledLocalTime(rawEvent.tracked_at, zone, 100)
             : isoTime(rawEvent.tracked_at, 'Asia/Kolkata', 100);
-        const description = eventText(clean(rawEvent.event));
+        const takeOff = providerCode === TAKE_OFF_CODE;
+        const description = takeOff ? flightDescription(rawEvent.remarks, office) : eventText(clean(rawEvent.event));
         if (!time || !description)
             return;
         const pincode = /^\d{6}$/.test(clean(rawEvent.pincode, 6))
             ? clean(rawEvent.pincode, 6)
             : '';
         const point = officePoint(rawEvent, office);
+        const airportCode = takeOff ? departureAirport(office) : undefined;
+        const airport = airportCode ? AIRPORT_PLACES[airportCode] : undefined;
         const identity = JSON.stringify([time.iso, description, office, pincode, providerCode]);
         if (seen.has(identity))
             return;
@@ -190,7 +211,7 @@ export function parseIndiaPostTrackingHtml(html, trackingNumber) {
             // deliberately never retained.
             event: {
                 time: time.iso,
-                location: [office, pincode].filter(Boolean).join(' '),
+                location: airport ? `${airport.name} (${airportCode}), ${airport.country}` : [office, pincode].filter(Boolean).join(' '),
                 description,
                 stage: classified.stage,
                 ...(providerCode ? { provider_code: providerCode } : {}),

package/dist/carriers/india-post/app.d.ts

@@ -0,0 +1,2 @@
+import type { SameInstantIdentityPolicy } from '../../core/catalog/eventIdentity.js';
+export declare const sameInstantIdentityPolicy: SameInstantIdentityPolicy;

package/dist/carriers/india-post/app.js

@@ -0,0 +1,4 @@
+// MySpeedPost changes a scan's wording while its instant and event_type stay the same.
+export const sameInstantIdentityPolicy = {
+    sourceCarrierId: 'india-post', storedSources: ['india-post'], requireProviderCode: true,
+};

package/dist/carriers/india-post/status.js

@@ -11,6 +11,8 @@ function includesAny(value, candidates) {
  * `in_transit` stage.
  */
 export function classifyIndiaPostEvent(...values) {
+    if (statusKey(values[0]) === 'aircrafttakeoff')
+        return { status: 'in_transit', stage: 'in_transit' };
     const key = values.map(statusKey).filter(Boolean).join(' ');
     if (includesAny(key, [
         'returntosender',

package/dist/carriers/india-post/statuses.json

@@ -1,6 +1,7 @@
 {
   "carrier": "india-post",
   "entries": [
+    { "code": "AircraftTakeOff", "wording": "Aircraft Departure / UPLIFT", "language": "en", "stage": "in_transit", "confirmedBy": "live", "firstSeen": "2026-10-04", "note": "Departure from the airport named by the office; flight remarks name the route, not a destination arrival." },
     { "code": "ItemBooked", "wording": "Item Booked", "language": "en", "stage": "accepted", "confirmedBy": "fixture", "firstSeen": "2026-09-01", "note": "Substring key `itembooked`; `articlebooked` and `bookingconfirmed` map the same way." },
     { "code": "ItemDispatched", "wording": "Item Dispatched", "language": "en", "stage": "in_transit", "confirmedBy": "fixture", "firstSeen": "2026-09-01", "note": "Substring key `itemdispatched`." },
     { "wording": "Item Bagged", "language": "en", "stage": "in_transit", "confirmedBy": "prior-art", "firstSeen": "2026-09-01", "note": "Substring key `itembagged`." },

package/dist/core/catalog/eventIdentity.d.ts

@@ -0,0 +1,8 @@
+/** Carrier evidence the parcel app uses when updating a stored scan in place. */
+export interface SameInstantIdentityPolicy {
+    readonly sourceCarrierId: string;
+    readonly storedSources: readonly string[];
+    readonly requireProviderCode: boolean;
+}
+/** Unlisted sources cannot identify a reworded scan by its instant alone. */
+export declare function sameInstantIdentityPolicy(sourceCarrierId: string): SameInstantIdentityPolicy | undefined;

package/dist/core/catalog/eventIdentity.js

@@ -0,0 +1,7 @@
+import { sameInstantIdentityPolicy as dpd } from '../../carriers/dpd/app.js';
+import { sameInstantIdentityPolicy as indiaPost } from '../../carriers/india-post/app.js';
+const policies = new Map([dpd, indiaPost].map((policy) => [policy.sourceCarrierId, policy]));
+/** Unlisted sources cannot identify a reworded scan by its instant alone. */
+export function sameInstantIdentityPolicy(sourceCarrierId) {
+    return policies.get(sourceCarrierId);
+}

package/package.json

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