universal-parcel-scraper 0.55.0-main.708 → 0.56.0-main.723

package/dist/core/catalog/hints.js

@@ -23,14 +23,17 @@ const CATALOG_NAMES = new Set([
 // Postal lookup candidates, not proof of which operator delivers a shipment.
 // Only operators whose dedicated adapter looks up mail from abroad by its S10
 // number are useful here: India Post's, Pos Malaysia's, CTT's and Poste
-// Italiane's take only numbers of their own. Poczta Polska and Ukrposhta give
-// wall clocks without an offset, so a host cannot tell their scans follow the
-// origin's. The host also checks adapter availability and required inputs
-// before making a request.
+// Italiane's take only numbers of their own. Poczta Polska dates scans at its
+// delivery office, and other inward scans when they name a Polish office; those
+// relayed from the origin keep its wall clock. Ukrposhta now dates its scans in
+// Ukraine, but its status API can miss mail from abroad, and its portal then
+// needs a browser session for every lookup. The host also checks adapter
+// availability and required inputs before making a request.
 const NATIONAL_POSTS = new Map([
     ['AU', 'australia-post'], ['CA', 'canada-post'], ['CH', 'swiss-post'], ['DE', 'dhl'],
     ['ES', 'correos-spain'], ['FI', 'posti'], ['FR', 'la-poste'], ['GB', 'royal-mail'],
-    ['JP', 'japan-post'], ['NL', 'spring-gds'], ['SE', 'postnord'], ['US', 'usps'],
+    ['JP', 'japan-post'], ['NL', 'spring-gds'], ['PL', 'poczta-polska'], ['SE', 'postnord'],
+    ['US', 'usps'],
 ]);
 const englishCountries = new Intl.DisplayNames(['en'], { type: 'region' });
 // Deprecated codes carry their successor's name, so fold them into it ("FX" is France).

package/dist/core/errors/index.d.ts

@@ -57,7 +57,14 @@ export declare class SchemaError extends CarrierError {
 }
 export declare class InputRequiredError extends CarrierError {
     readonly field: string;
-    constructor(provider: string, field: string, message?: string, options?: CarrierErrorOptions);
+    /**
+     * The catalog id of the carrier that asks for the input, when the source names one: a universal
+     * provider relaying a carrier's postcode gate. Absent when the source names none, or none that maps.
+     */
+    readonly carrier?: string;
+    constructor(provider: string, field: string, message?: string, options?: CarrierErrorOptions & {
+        carrier?: string;
+    });
 }
 /**
  * The adapter rejected the number or credential before any request: the format

package/dist/core/errors/index.js

@@ -89,10 +89,17 @@ export class SchemaError extends CarrierError {
 }
 export class InputRequiredError extends CarrierError {
     field;
+    /**
+     * The catalog id of the carrier that asks for the input, when the source names one: a universal
+     * provider relaying a carrier's postcode gate. Absent when the source names none, or none that maps.
+     */
+    carrier;
     constructor(provider, field, message = `${provider} tracking requires ${field}`, options) {
         super('input_required', provider, message, options);
         this.name = 'InputRequiredError';
         this.field = field;
+        if (options?.carrier !== undefined)
+            this.carrier = options.carrier;
     }
 }
 /**

package/dist/core/runner/networkRetry.d.ts

@@ -0,0 +1,15 @@
+import type { StepContext, StepSpec } from './index.js';
+/** Whether an error is, or wraps, a request that did not reach the carrier, including one that timed out. */
+export declare function isNetworkFailure(error: unknown): boolean;
+/** The time a first attempt's request gets out of what is left: half, so a retry still fits. */
+export declare function firstAttemptMs(remainingMs: number): number;
+/** A step that runs the read again after the step before it failed to reach the carrier. */
+export declare function networkRetryStep<T>(run: (context: StepContext) => Promise<T>): StepSpec<T>;
+/**
+ * `attempt` with the time its request may take, then once more after a network failure or a
+ * timeout, while the budget has time left and its signal has not ended.
+ */
+export declare function withNetworkRetry<T>(budget: {
+    signal?: AbortSignal;
+    remainingMs: () => number;
+}, attempt: (timeoutMs: number) => Promise<T>): Promise<T>;

package/dist/core/runner/networkRetry.js

@@ -0,0 +1,51 @@
+/**
+ * One more try at a carrier's own read after a network failure or a timeout, inside the lookup's
+ * budget. The first attempt's request gets at most half of the time left, so a request that hangs
+ * leaves time for the second, which gets the rest. Only a failure to reach the carrier is tried
+ * again: an HTTP status, a reply that does not parse and a definite answer stand, and so does any
+ * failure once the lookup's own signal has ended. Reads only: a request that changes something, or
+ * one bound to a session the failure may have spent, is not replayed.
+ *
+ * Steps run by `runSteps` add `networkRetryStep` after the first and give it `firstAttemptMs` of
+ * what is left, so the retry is recorded as a step of its own. A read outside the runner wraps its
+ * request in `withNetworkRetry`.
+ */
+import { UpstreamNetworkError } from '../errors/index.js';
+const MAX_CAUSE_DEPTH = 8;
+/** Whether an error is, or wraps, a request that did not reach the carrier, including one that timed out. */
+export function isNetworkFailure(error) {
+    const seen = new Set();
+    let current = error;
+    for (let depth = 0; depth < MAX_CAUSE_DEPTH && current instanceof Error && !seen.has(current); depth += 1) {
+        seen.add(current);
+        if (current instanceof UpstreamNetworkError)
+            return true;
+        current = current.cause;
+    }
+    return false;
+}
+/** The time a first attempt's request gets out of what is left: half, so a retry still fits. */
+export function firstAttemptMs(remainingMs) {
+    return Math.max(1, Math.floor(remainingMs / 2));
+}
+/** A step that runs the read again after the step before it failed to reach the carrier. */
+export function networkRetryStep(run) {
+    return { id: 'retry', recovers: isNetworkFailure, run };
+}
+/**
+ * `attempt` with the time its request may take, then once more after a network failure or a
+ * timeout, while the budget has time left and its signal has not ended.
+ */
+export async function withNetworkRetry(budget, attempt) {
+    try {
+        return await attempt(firstAttemptMs(budget.remainingMs()));
+    }
+    catch (error) {
+        if (!isNetworkFailure(error) || budget.signal?.aborted)
+            throw error;
+        const left = budget.remainingMs();
+        if (left <= 1)
+            throw error;
+        return await attempt(left);
+    }
+}

package/dist/core/status/language.js

@@ -44,12 +44,31 @@ export function deliveryForecastRemainder(description) {
 const CARRIER_STEP = String.raw `(?:dispatched|despatched|shipped|sent|received|processed|handed (?:over|in)|posted)\b`;
 /** A handover to a carrier or courier, not to the recipient's side or to customs. */
 const HANDED_TO_CARRIER = String.raw `handed (?:over )?to (?!(?:the |a |an |your )?(?:recipient|addressee|consignee|customer|receiver|neighbou?r|customs|you|person)\b)`;
+/** A carrier by its brand, as handovers to one are worded. */
+const CARRIER_BRAND = String.raw `(?:gls|dpd|dhl|ups|fedex|tnt|hermes|colissimo|chronopost|brt|sda|inpost)\b`;
+/** A place a carrier delivers to, worded after the brand or noun of its network: "DHL Packstation". */
+const CARRIER_PLACE = String.raw `(?:packstation|paketstation|paketshop|parcelshop|shop|filiale|access point|pick ?up|locker|consigne|relais|restante|fermopoint|point|punto|box|station)\b`;
+/** A carrier named on its own, not one of its places. */
+const NOT_A_PLACE = String.raw `(?! ${CARRIER_PLACE})`;
+/**
+ * The same handover negated in French ("n'a pas encore été remis à GLS"),
+ * German ("wurde noch nicht an GLS übergeben", or a heading such as "Paket
+ * noch nicht an DPD übergeben") and Italian ("non è ancora stato affidato a
+ * GLS"): one that has not happened, to a carrier or an operator, not one that
+ * cannot or will not happen, nor one to the carrier's shop, locker or pickup
+ * point.
+ */
+const NOT_HANDED_TO_CARRIER = [
+    String.raw `(?:\bn'(?:a|ont)(?: toujours)? (?:pas|jamais)(?: encore)? ete|\bpas encore) (?:remis|confie)e?s? (?:a|au|aux) (?:(?:la|le|les) |l')?(?:(?:transporteur|livreur|coursier|messagerie|operateur|prestataire)s?|poste|${CARRIER_BRAND})\b${NOT_A_PLACE}`,
+    String.raw `(?:\b(?:wurde|wurden|ist|sind|war|waren)\b(?: [\w'-]+){0,4}? |(?:^|[.;:] )(?:(?:das|die|der|ihr|ihre) )?(?:[\w-]+ )?(?:noch )?)nicht an (?:(?:den|die|das|dem|der|unseren|unsere|unserem) )?(?:[\w-]+ )?(?:zusteller|paketzusteller|paketdienst|kurier|kurierdienst|versanddienst|spediteur|post|${CARRIER_BRAND}) ubergeben\b(?! werden)`,
+    String.raw `\bnon (?:(?:e|sono|ancora|stat[oaie]|mai) )*affidat[oaie] (?:(?:a|ad|al|allo|alla|ai|agli|alle) |all')(?:corrier[ei]|vettor[ei]|trasportator[ei]|spedizionier[ei]|operatore|posta|poste|${CARRIER_BRAND})\b${NOT_A_PLACE}`,
+].join('|');
 /**
  * A step the carrier has not taken yet ("not yet received", "not dispatched
  * yet") or a handover that has not happened ("has not been handed over to
  * GLS"), from the negation to the end of its sentence.
  */
-const NOT_YET = new RegExp(String.raw `(?:\bnot (?:yet (?:been )?${CARRIER_STEP}|(?:been )?${CARRIER_STEP}(?: \w+){0,3}? yet\b)|(?:\bnot|n't)(?: been)? ${HANDED_TO_CARRIER})${SENTENCE}*`, 'g');
+const NOT_YET = new RegExp(String.raw `(?:\bnot (?:yet (?:been )?${CARRIER_STEP}|(?:been )?${CARRIER_STEP}(?: \w+){0,3}? yet\b)|(?:\bnot|n't)(?: been)? ${HANDED_TO_CARRIER}|(?:\bnot|n't) yet(?: been)? ${HANDED_TO_CARRIER}(?!(?:the |a |an |your )?(?:[\w-]+ )?${CARRIER_PLACE})|${NOT_HANDED_TO_CARRIER})${SENTENCE}*`, 'g');
 /** A handover the carrier made, not a pickup order passed on or the sender's own hand-in. */
 const HANDED_TO = String.raw `(?<!\b(?:(?:pick ?up|collection) (?:order|request)|sender|shipper|seller|merchant|consignor)(?: has| have)?(?: been)? )\bhanded (?:over )?to `;
 /**
@@ -59,6 +78,8 @@ const HANDED_TO = String.raw `(?<!\b(?:(?:pick ?up|collection) (?:order|request)
 const COURIER = String.raw `(?:(?:the|a|an|our|your) )?(?:delivery )?couriers?\b(?! (?:compan|service|partner|network|guy\b))`;
 const HANDED_TO_COURIER = new RegExp(`${HANDED_TO}${COURIER}`);
 const HANDED_TO_NETWORK = new RegExp(String.raw `${HANDED_TO}(?!${COURIER})(?:the |a |an |our |your )?(?:[\w-]+ ){0,2}?(?:courier|carrier)s?\b`);
+/** Customs or clearance named in any language. */
+const CUSTOMS = /customs|clearance|douan|formalites (?:d')?(?:import|export)|zoll|dogan|\b(?:des)?aduan[ae]|alfandeg|\bceln|government agency|autorite gouvernementale|staatliche behorde|autorita governativa/;
 /** The side of customs a scan may name: "import", "export", "import/export". */
 const CUSTOMS_SIDE = String.raw `(?:(?:import|export)(?:\/(?:import|export))? |local |destination |origin )?`;
 /**
@@ -167,7 +188,7 @@ export function trackingLanguageStage(description) {
     if (/^(?:a )?(?:new|next|another|further) (?:delivery )?attempt\b/.test(text)
         && !/\b(?:not|unable|fail(?:ed|ure)?|unsuccessful|missed|absent|closed|refused|nobody|no one)\b|n't\b/.test(text))
         return 'in_transit';
-    if (/not (?:yet )?delivered|\bundelivered\b|could not.*deliver|\bcan(?: ?not|'t) be delivered\b|unable to deliver|delivery (?:attempt|failed)|non livre|n'(?:a|avons) (?:pas )?pu.*(?:remis|remettre)|n'a pas pu etre (?:distribue|livre)|\bne (?:peut|pourra|pourrait|pouvait) (?:pas )?etre (?:distribue|livre)|livraison (?:impossible|echouee)|\bechec (?:de (?:la )?)?livraison|tentative de livraison|nicht zugestellt|nicht zugestellt werden|zustellung.*(?:fehlgeschlagen|nicht moglich)|zustellversuch|non consegnat[oa]|non e stato possibile consegnare|consegna (?:fallita|non riuscita)|tentativo di consegna/.test(text))
+    if (/not (?:yet )?delivered|\bundelivered\b|could not.*deliver|\bcan(?: ?not|'t) be delivered\b|unable to deliver|delivery (?:attempt|failed)|non livre|n'(?:a|avons) (?:pas )?pu.*(?:remis|remettre)|n'a pas pu etre (?:distribue|livre)|\bne (?:peut|pourra|pourrait|pouvait) (?:pas )?etre (?:distribue|livre)|livraison (?:impossible|echouee)|\bechec (?:de (?:la )?)?livraison|tentative de livraison|nicht zugestellt|nicht zugestellt werden|zustellung.*(?:fehlgeschlagen|nicht moglich)|zustellversuch|non consegnat[oa]|\bmancata consegna\b|non e stato possibile consegnare|consegna (?:fallita|non riuscita)|tentativo di consegna/.test(text))
         return 'failed_attempt';
     if (/\bno (?:(?:ha|han|hemos|se|le|lo|la|fue|sido|ser|es|era|pudo|puede|podido|posible|todavia|aun) )*(?:entregad[oa]s?|entregar(?:lo|la|le|se)?|repartid[oa]s?|realizar la entrega|efectuar la entrega)\b|\bsin entregar\b|\b(?:entrega|reparto) (?:fallid[oa]|imposible|no (?:(?:ha|han|se|fue|sido|ser|pudo|puede|podido) )*(?:realizad[oa]|efectuad[oa]|completad[oa]|posible|conseguid[oa]))\b|\bimposible (?:entregar|realizar la entrega|efectuar la entrega)\b|\bfallo (?:en la|de) entrega\b|\bintento fallido\b|\bintento de (?:entrega|reparto)\b(?! (?:programad|previst|para (?:hoy|manana|el)|manana|hoy))|\bnao (?:(?:foi|foram|ser|sera|pode|podemos|conseguimos|conseguiu|se|possivel|e|ainda|tem sido|esta|estava) )*(?:entregues?|entregar|efetuar a entrega|efectuar a entrega|realizar a entrega)\b|\bentrega (?:falhada|sem sucesso|impossivel|nao (?:(?:foi|pode|ser|sera|tem sido) )*(?:efetuada|efectuada|realizada|conseguida|concretizada|possivel))\b|\bfalha (?:na|de) entrega\b|\btentativa (?:de entrega|sem sucesso)\b(?! (?:agendada|prevista|programada|para (?:hoje|amanha)|amanha|hoje))|\bcarteiro nao atendido\b/.test(text))
         return 'failed_attempt';
@@ -263,11 +284,16 @@ export function trackingLanguageStage(description) {
         return 'registered';
     // The carrier has not had the parcel yet: "Shipment not yet received or
     // processed". What else the scan reports still counts: "Arrived at hub; not
-    // yet processed" is in transit, and a clearance delay stays with customs.
+    // yet processed" is in transit, and a clearance delay stays with customs,
+    // even worded within the step's own sentence ("Not handed over to the
+    // carrier: awaiting customs clearance"), as a release there moves it on
+    // unless it is still to come ("clearance not completed").
     if (!/\b(?:at|in|by) (?:the )?(?:destination|delivery|recipient|consignee|addressee|customer|customs|office of exchange)\b/.test(text)) {
         const rest = text.replace(NOT_YET, ' ');
-        if (rest !== text)
-            return trackingLanguageStage(rest.replace(/^[\s,;:.!?]+|[\s,;:]+$/g, '')) ?? 'registered';
+        if (rest !== text) {
+            return trackingLanguageStage(rest.replace(/^[\s,;:.!?]+|[\s,;:]+$/g, ''))
+                ?? (CUSTOMS.test(text) ? (!CUSTOMS_PENDING.test(text) && CUSTOMS_RELEASED.test(text) ? 'in_transit' : 'customs') : 'registered');
+        }
     }
     if (/^(?:reported|recorded|announced|item created|enregistre|annonce|erfasst|angekundigt|registrato|annunciato)$/.test(text))
         return 'registered';
@@ -280,7 +306,7 @@ export function trackingLanguageStage(description) {
         return 'customs';
     if (CUSTOMS_RELEASED.test(text))
         return 'in_transit';
-    if (/customs|clearance|douan|formalites (?:d')?(?:import|export)|zoll|dogan|\b(?:des)?aduan[ae]|alfandeg|\bceln|government agency|autorite gouvernementale|staatliche behorde|autorita governativa/.test(text))
+    if (CUSTOMS.test(text))
         return 'customs';
     if (/out for (?:physical )?delivery|\bout with (?:the |a |our |your )?(?:delivery )?(?:courier|driver)s?\b(?! for (?:pick ?up|collection|return))|being delivered|in delivery|(?:loading|loaded).*delivery vehicle|on (?:\w+ )?vehicle for delivery|(?:courier|driver|delivery champion) has (?:the|your) (?:shipment|parcel|package|item)|en cours de livraison|en livraison|de la livraison de (?:son|votre) colis ce jour|charg(?:e|ement).*vehicule de livraison|in zustellung|zustellfahrzeug.*(?:geladen|verladen)|(?:beladen|verladung).*zustellfahrzeug|in consegna|caric(?:at|amento).*veicolo.*consegna/.test(text))
         return 'out_for_delivery';

package/dist/data/catalog.json

@@ -4846,7 +4846,7 @@
                 "domains": [
                     "tracking.dpd.de"
                 ],
-                "path": "^/status/[a-z]{2}_[A-Z]{2}/parcel/(\\d{14})/?$"
+                "path": "^/status/[a-z]{2}_[A-Z]{2}/parcel/(\\d{14}[0-9A-Z]?)/?$"
             },
             {
                 "domains": [
@@ -4909,6 +4909,12 @@
                 "pattern": "^13\\d{12}$",
                 "confidence": "low",
                 "preferred": true
+            },
+            {
+                "pattern": "^13\\d{12}[0-9A-Z]$",
+                "confidence": "low",
+                "checksum": "dpd",
+                "preferred": true
             }
         ]
     },
@@ -4999,6 +5005,41 @@
             }
         ]
     },
+    "emile": {
+        "displayName": "Emile",
+        "color": "#e42920",
+        "aliases": [
+            "Emile Express"
+        ],
+        "countries": [
+            "CA"
+        ],
+        "selectable": true,
+        "timezone": "UTC",
+        "tracking": {
+            "mode": "link-only",
+            "adapter": null
+        },
+        "canaryUrl": "https://www.emileps.com/",
+        "trackingUrlTemplate": "https://www.emileps.com/tracking?tracking={trackingNumber}",
+        "trackingSearchUrl": "https://www.emileps.com/tracking",
+        "linkRules": [
+            {
+                "domains": [
+                    "emileps.com"
+                ],
+                "params": [
+                    "tracking"
+                ]
+            }
+        ],
+        "detectionRules": [
+            {
+                "pattern": "^EM\\d{12}CA$",
+                "confidence": "low"
+            }
+        ]
+    },
     "evri-uk": {
         "displayName": "Evri UK",
         "color": "#00014d",

package/dist/generated/catalog.d.ts

@@ -3321,7 +3321,7 @@ export declare const CARRIER_CATALOG: {
         readonly trackingSearchUrl: "https://www.dpd.com/de/en/empfangen/sendungsverfolgung-und-live-tracking/";
         readonly linkRules: readonly [{
             readonly domains: readonly ["tracking.dpd.de"];
-            readonly path: "^/status/[a-z]{2}_[A-Z]{2}/parcel/(\\d{14})/?$";
+            readonly path: "^/status/[a-z]{2}_[A-Z]{2}/parcel/(\\d{14}[0-9A-Z]?)/?$";
         }, {
             readonly domains: readonly ["my.dpd.de"];
             readonly params: readonly ["parcelno"];
@@ -3362,6 +3362,11 @@ export declare const CARRIER_CATALOG: {
             readonly pattern: "^13\\d{12}$";
             readonly confidence: "low";
             readonly preferred: true;
+        }, {
+            readonly pattern: "^13\\d{12}[0-9A-Z]$";
+            readonly confidence: "low";
+            readonly checksum: "dpd";
+            readonly preferred: true;
         }];
     };
     readonly "dpd-uk": {
@@ -3424,6 +3429,29 @@ export declare const CARRIER_CATALOG: {
             readonly confidence: "high";
         }];
     };
+    readonly emile: {
+        readonly displayName: "Emile";
+        readonly color: "#e42920";
+        readonly aliases: readonly ["Emile Express"];
+        readonly countries: readonly ["CA"];
+        readonly selectable: true;
+        readonly timezone: "UTC";
+        readonly tracking: {
+            readonly mode: "link-only";
+            readonly adapter: null;
+        };
+        readonly canaryUrl: "https://www.emileps.com/";
+        readonly trackingUrlTemplate: "https://www.emileps.com/tracking?tracking={trackingNumber}";
+        readonly trackingSearchUrl: "https://www.emileps.com/tracking";
+        readonly linkRules: readonly [{
+            readonly domains: readonly ["emileps.com"];
+            readonly params: readonly ["tracking"];
+        }];
+        readonly detectionRules: readonly [{
+            readonly pattern: "^EM\\d{12}CA$";
+            readonly confidence: "low";
+        }];
+    };
     readonly "evri-uk": {
         readonly displayName: "Evri UK";
         readonly color: "#00014d";
@@ -3684,7 +3712,7 @@ export declare const CARRIER_CATALOG: {
         }];
     };
 };
-export declare const CARRIER_IDS: readonly ["swiss-post", "swiss-post-cargo", "quickpac", "planzer", "aliexpress", "sunyou", "hermes", "spring-gds", "postlogistics", "dachser", "dhl", "dhl-ecommerce", "ups", "amazon-logistics", "amazon-shipping", "fedex", "gls-ch", "dpd", "dpd-fr", "mondial-relay", "relais-colis", "la-poste", "chronopost", "gls-fr", "colis-prive", "geodis", "colisweb", "c-chez-vous", "heppner", "ciblex", "paack", "asendia", "shipup", "india-post", "hermes-de", "gls-de", "delivengo", "intl-post", "unknown", "royal-mail", "parcelforce", "evri", "inpost", "an-post", "bpost", "austrian-post", "postnord", "posti", "correos-express", "seur", "mrw", "nacex", "ctt", "ctt-express", "poste-italiane", "brt", "ecoscooting", "tipsa", "ukrposhta", "usps", "canada-post", "purolator", "canpar", "ontrac", "speedx", "uniuni", "landmark-global", "old-dominion", "spee-dee", "gofo", "estafeta", "correios-br", "correos-chile", "yunexpress", "four-px", "blue-dart", "delhivery", "nz-post", "singapore-post", "japan-post", "sf-express", "sto", "yunda", "yto", "zto", "jd-logistics", "yamato", "korea-post", "thailand-post", "dtdc", "australia-post", "hongkong-post", "pos-malaysia", "ninja-van", "china-post", "packeta", "poczta-polska", "bring-posten", "aramex", "tnt", "correos-spain", "yanwen", "the-courier-guy", "j-and-t", "ems", "cne", "dhl-ecommerce-es", "dhl-ecommerce-nl", "dhl-ecommerce-pl", "dhl-ecommerce-uk", "dhl-express", "dpd-de", "dpd-pl", "dpd-uk", "ekart", "evri-uk", "intelcom", "j-and-t-cargo", "lbc-express", "nova-poshta", "omgo", "sagawa", "speedpak", "spx-ph", "xpressbees"];
+export declare const CARRIER_IDS: readonly ["swiss-post", "swiss-post-cargo", "quickpac", "planzer", "aliexpress", "sunyou", "hermes", "spring-gds", "postlogistics", "dachser", "dhl", "dhl-ecommerce", "ups", "amazon-logistics", "amazon-shipping", "fedex", "gls-ch", "dpd", "dpd-fr", "mondial-relay", "relais-colis", "la-poste", "chronopost", "gls-fr", "colis-prive", "geodis", "colisweb", "c-chez-vous", "heppner", "ciblex", "paack", "asendia", "shipup", "india-post", "hermes-de", "gls-de", "delivengo", "intl-post", "unknown", "royal-mail", "parcelforce", "evri", "inpost", "an-post", "bpost", "austrian-post", "postnord", "posti", "correos-express", "seur", "mrw", "nacex", "ctt", "ctt-express", "poste-italiane", "brt", "ecoscooting", "tipsa", "ukrposhta", "usps", "canada-post", "purolator", "canpar", "ontrac", "speedx", "uniuni", "landmark-global", "old-dominion", "spee-dee", "gofo", "estafeta", "correios-br", "correos-chile", "yunexpress", "four-px", "blue-dart", "delhivery", "nz-post", "singapore-post", "japan-post", "sf-express", "sto", "yunda", "yto", "zto", "jd-logistics", "yamato", "korea-post", "thailand-post", "dtdc", "australia-post", "hongkong-post", "pos-malaysia", "ninja-van", "china-post", "packeta", "poczta-polska", "bring-posten", "aramex", "tnt", "correos-spain", "yanwen", "the-courier-guy", "j-and-t", "ems", "cne", "dhl-ecommerce-es", "dhl-ecommerce-nl", "dhl-ecommerce-pl", "dhl-ecommerce-uk", "dhl-express", "dpd-de", "dpd-pl", "dpd-uk", "ekart", "emile", "evri-uk", "intelcom", "j-and-t-cargo", "lbc-express", "nova-poshta", "omgo", "sagawa", "speedpak", "spx-ph", "xpressbees"];
 export type CarrierId = (typeof CARRIER_IDS)[number];
 /** Each carrier's detection rule ids, in the order of its `detectionRules`. */
 export declare const DETECTION_RULE_IDS: Readonly<Record<CarrierId, readonly string[]>>;

package/dist/generated/catalog.js

@@ -4847,7 +4847,7 @@ export const CARRIER_CATALOG = {
                 "domains": [
                     "tracking.dpd.de"
                 ],
-                "path": "^/status/[a-z]{2}_[A-Z]{2}/parcel/(\\d{14})/?$"
+                "path": "^/status/[a-z]{2}_[A-Z]{2}/parcel/(\\d{14}[0-9A-Z]?)/?$"
             },
             {
                 "domains": [
@@ -4910,6 +4910,12 @@ export const CARRIER_CATALOG = {
                 "pattern": "^13\\d{12}$",
                 "confidence": "low",
                 "preferred": true
+            },
+            {
+                "pattern": "^13\\d{12}[0-9A-Z]$",
+                "confidence": "low",
+                "checksum": "dpd",
+                "preferred": true
             }
         ]
     },
@@ -5000,6 +5006,41 @@ export const CARRIER_CATALOG = {
             }
         ]
     },
+    "emile": {
+        "displayName": "Emile",
+        "color": "#e42920",
+        "aliases": [
+            "Emile Express"
+        ],
+        "countries": [
+            "CA"
+        ],
+        "selectable": true,
+        "timezone": "UTC",
+        "tracking": {
+            "mode": "link-only",
+            "adapter": null
+        },
+        "canaryUrl": "https://www.emileps.com/",
+        "trackingUrlTemplate": "https://www.emileps.com/tracking?tracking={trackingNumber}",
+        "trackingSearchUrl": "https://www.emileps.com/tracking",
+        "linkRules": [
+            {
+                "domains": [
+                    "emileps.com"
+                ],
+                "params": [
+                    "tracking"
+                ]
+            }
+        ],
+        "detectionRules": [
+            {
+                "pattern": "^EM\\d{12}CA$",
+                "confidence": "low"
+            }
+        ]
+    },
     "evri-uk": {
         "displayName": "Evri UK",
         "color": "#00014d",
@@ -5523,6 +5564,7 @@ export const CARRIER_IDS = [
     "dpd-pl",
     "dpd-uk",
     "ekart",
+    "emile",
     "evri-uk",
     "intelcom",
     "j-and-t-cargo",
@@ -5648,9 +5690,10 @@ export const DETECTION_RULE_IDS = {
     "dhl-ecommerce-uk": ["dhl-ecommerce-uk-2", "dhl-ecommerce-uk-1"],
     "dhl-express": ["dhl-express-waybill"],
     "dpd-de": ["dpd-de-1", "dpd-de-2"],
-    "dpd-pl": ["dpd-pl-1", "dpd-pl-2"],
+    "dpd-pl": ["dpd-pl-1", "dpd-pl-2", "dpd-pl-3"],
     "dpd-uk": ["dpd-uk-3", "dpd-uk-4", "dpd-uk-1", "dpd-uk-2"],
     "ekart": ["ekart-ecommerce"],
+    "emile": ["emile-1"],
     "evri-uk": ["evri-uk-1", "evri-uk-2", "evri-uk-3"],
     "intelcom": ["intelcom-1", "intelcom-2", "intelcom-3"],
     "j-and-t-cargo": ["j-and-t-cargo-1"],

package/dist/generated/registry.js

@@ -278,6 +278,7 @@ export const REGISTRY = {
         "dtdc": "dtdc",
         "ecoscooting": "ecoscooting",
         "ekart": "ekart",
+        "emile": null,
         "ems": "ems",
         "estafeta": "estafeta",
         "evri": "evri",

package/dist/node.d.ts

@@ -8,5 +8,5 @@ export { REGISTRY } from './generated/registry.js';
 export { UniversalTracker, UniversalTrackingError } from './providers/universal.js';
 export { TrackingCaptureError, SeventeenTrackLookupError, SeventeenTrackNoHistoryError, SeventeenTrackVerificationError } from './providers/universal.js';
 export { amazonShippingEligibility } from './carriers/amazon-shipping/eligibility.js';
-export { warmDpdSession, type DpdSession, type DpdSessionStore } from './carriers/dpd-de/service.js';
+export { warmDpdSession, type DpdSession, type DpdSessionEvent, type DpdSessionStore } from './carriers/dpd-de/service.js';
 export { createTrackingServer, type TrackingServerOptions } from './server/index.js';

package/dist/providers/parcelsapp/adapter.js

@@ -250,9 +250,15 @@ function parseHistory(payload, trackingNumber, timezone = null) {
     markReturnLeg(scans);
     latest.check();
     if (!events.length) {
-        const fields = payload.states.flatMap((raw) => isRecord(raw) && Array.isArray(raw.require_fields) ? raw.require_fields : []);
-        if (fields.some((field) => isRecord(field) && field.name === 'zipcode')) {
-            throw new InputRequiredError(SOURCE, 'postcode', 'ParcelsApp requires a valid delivery postcode or further recipient information');
+        const gates = payload.states.filter((raw) => isRecord(raw)
+            && Array.isArray(raw.require_fields) && raw.require_fields.some((field) => isRecord(field) && field.name === 'zipcode'));
+        if (gates.length) {
+            // A gate names the carrier that asks for the postcode, as a scan does. It is
+            // given only when every gate names the same one and it maps to the catalog.
+            const [name, ...others] = gates.map((gate) => stateCarrierName(payload, gate));
+            const carrier = typeof name === 'string' && others.every((other) => other === name)
+                ? universalCarrierHints([name], number).discovered_carrier : undefined;
+            throw new InputRequiredError(SOURCE, 'postcode', 'ParcelsApp requires a valid delivery postcode or further recipient information', carrier ? { carrier } : undefined);
         }
         // An empty history is the NO_DATA answer; states that don't parse are not an answer.
         if (!payload.states.length)

package/dist/server/openapi.json

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

package/package.json

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