universal-parcel-scraper 0.330.0-main.1887 → 0.331.0-main.1889

package/README.md

@@ -13,7 +13,7 @@ The engine behind [Peek](https://peektracker.com) ([GitHub](https://github.com/p
 [![License: Apache-2.0](https://img.shields.io/badge/core-Apache--2.0-blue.svg)](LICENSE)
 
 <!-- GENERATED:summary -->
-**3,500+ carriers** through **368 dedicated adapters** and **5 universal fallbacks**
+**3,500+ carriers** through **369 dedicated adapters** and **5 universal fallbacks**
 
 <sub>687 catalog entries · 131 countries represented</sub>
 <!-- /GENERATED:summary -->
@@ -155,7 +155,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 13,010 such statuses, each filed under one stage.
+The carrier folders record 13,019 such statuses, each filed under one stage.
 <!-- /GENERATED:stages -->
 
 Wording nobody recorded yet goes through a classifier that reads seven European languages.

package/data/catalog.json

@@ -11783,7 +11783,9 @@
     "timezone": "Asia/Shanghai",
     "tracking": {
       "mode": "automatic",
-      "adapter": "universal"
+      "adapter": "equick",
+      "recognitionRank": 853,
+      "localClocks": true
     },
     "canaryUrl": "https://api.equick.cn/",
     "linkRules": [
@@ -11795,7 +11797,12 @@
         "fragment": "^/support/supportWay\\?(?:[^#]*&)?nums=([^&,]+)"
       }
     ],
-    "detectionRules": []
+    "detectionRules": [
+      {
+        "pattern": "^EQK[A-Z]{2}\\d{10}YQ$",
+        "confidence": "high"
+      }
+    ]
   },
   "estes": {
     "displayName": "Estes",

package/data/coverage-summary.json

@@ -1,6 +1,6 @@
 {
   "catalog": 687,
-  "activeAdapters": 368,
+  "activeAdapters": 369,
   "countries": 131,
   "referenceCarriers": 100,
   "comparison": {

package/data/detection-golden.json

@@ -67090,15 +67090,19 @@
   },
   {
     "input": "EQKPT8586061210YQ",
-    "carrier": "unknown",
-    "confidence": "none",
-    "candidates": []
+    "carrier": "equick",
+    "confidence": "high",
+    "candidates": [
+      "equick"
+    ]
   },
   {
     "input": "EQKPT8613050786YQ",
-    "carrier": "unknown",
-    "confidence": "none",
-    "candidates": []
+    "carrier": "equick",
+    "confidence": "high",
+    "candidates": [
+      "equick"
+    ]
   },
   {
     "input": "ER107045826VN",

package/dist/browser/scraper.js

@@ -9174,14 +9174,19 @@ var Pe = {
 		timezone: "Asia/Shanghai",
 		tracking: {
 			mode: "automatic",
-			adapter: "universal"
+			adapter: "equick",
+			recognitionRank: 853,
+			localClocks: !0
 		},
 		canaryUrl: "https://api.equick.cn/",
 		linkRules: [{
 			domains: ["www.equick.cn", "equick.cn"],
 			fragment: "^/support/supportWay\\?(?:[^#]*&)?nums=([^&,]+)"
 		}],
-		detectionRules: []
+		detectionRules: [{
+			pattern: "^EQK[A-Z]{2}\\d{10}YQ$",
+			confidence: "high"
+		}]
 	},
 	estes: {
 		displayName: "Estes",
@@ -21274,7 +21279,7 @@ var Pe = {
 	"envia-colombia": [],
 	envialia: [],
 	"epost-global": ["epost-global-1"],
-	equick: [],
+	equick: ["equick-eqk"],
 	estes: [],
 	"estes-forwarding": [],
 	"ethiopian-post": [],
@@ -26933,6 +26938,7 @@ var pl = {
 	"envia-colombia": 912,
 	envialia: 260,
 	"epost-global": 65,
+	equick: 853,
 	estes: 20,
 	evri: 605,
 	"evri-uk": 615,

package/dist/carriers/equick/adapter.d.ts

@@ -0,0 +1,19 @@
+import { type AdapterFactory, type TrackingContext } from '../../core/adapter/index.js';
+import type { CarrierResult } from '../../core/result/index.js';
+import { type StepRecorder } from '../../core/telemetry/index.js';
+/**
+ * The lookup Equick's tracking page makes for the numbers typed in. The page
+ * calls the same service on `api.equick.cn:8080` over plain HTTP; its HTTPS
+ * host answers the same.
+ */
+export declare const EQUICK_API = "https://api.equick.cn/api/traceQuery";
+export declare class EquickTracker {
+    private readonly options;
+    constructor(options?: {
+        fetcher?: typeof fetch;
+        recorder?: StepRecorder;
+        userAgent?: string;
+    });
+    fetch(raw: string, context?: TrackingContext): Promise<CarrierResult>;
+}
+export declare const adapter: AdapterFactory;

package/dist/carriers/equick/adapter.js

@@ -0,0 +1,65 @@
+import { accepted, recognizeFromLookup } from '../../core/adapter/index.js';
+import { ChallengeError, IndeterminateError, SchemaError, TransportError } from '../../core/errors/index.js';
+import { runSteps } from '../../core/runner/index.js';
+import { firstAttemptMs, networkRetryStep } from '../../core/runner/networkRetry.js';
+import { NOOP_RECORDER } from '../../core/telemetry/index.js';
+import { decodeText, fetchBounded, userAgentOf } from '../../core/transport/index.js';
+import { EQUICK_MAX_BYTES, normalizeEquickNumber, parseEquick, PROVIDER } from './parser.js';
+/**
+ * The lookup Equick's tracking page makes for the numbers typed in. The page
+ * calls the same service on `api.equick.cn:8080` over plain HTTP; its HTTPS
+ * host answers the same.
+ */
+export const EQUICK_API = 'https://api.equick.cn/api/traceQuery';
+const REDIRECTS = [301, 302, 303, 307, 308];
+// A missing route is not a missing parcel: an unknown number gets an empty result.
+const GONE = [404, 405, 410];
+// Bot checks a CDN or firewall could put in place of the reply.
+const CHALLENGE = /_cf_chl_opt|cf-turnstile|<title>\s*(?:Just a moment|Attention Required|Access Denied|403 Forbidden)|acw_sc__v2|aliyun_waf|_____tmd_____|captcha|<title>\s*(?:滑动验证|验证码|安全验证)/i;
+function json(body) {
+    try {
+        return JSON.parse(body);
+    }
+    catch (cause) {
+        if (CHALLENGE.test(body.slice(0, 64_000)))
+            throw new ChallengeError(PROVIDER, 'Equick answered with a browser check', { cause });
+        throw new SchemaError(PROVIDER, 'Equick returned a reply that is not JSON', { cause });
+    }
+}
+export class EquickTracker {
+    options;
+    constructor(options = {}) {
+        this.options = options;
+    }
+    async fetch(raw, context = {}) {
+        const number = normalizeEquickNumber(raw);
+        const read = async (signal, timeoutMs) => {
+            const { response, bytes } = await fetchBounded(EQUICK_API, { method: 'POST', signal, headers: {
+                    Accept: 'application/json, text/plain, */*', 'Content-Type': 'application/json', 'User-Agent': userAgentOf(this.options.userAgent),
+                }, body: JSON.stringify({ txtDanHao: number }) }, { provider: PROVIDER, timeoutMs: Math.max(1, Math.floor(timeoutMs)),
+                maxBytes: EQUICK_MAX_BYTES, redirect: 'manual', fetcher: this.options.fetcher, allowHttpStatuses: [...REDIRECTS, ...GONE] });
+            if (REDIRECTS.includes(response.status))
+                throw new TransportError(PROVIDER, 'Equick redirected its tracking lookup');
+            if (GONE.includes(response.status))
+                throw new TransportError(PROVIDER, 'Equick tracking lookup is unavailable', { status: response.status });
+            if (response.status !== 200)
+                throw new IndeterminateError(PROVIDER, 'Equick did not answer with its tracking result');
+            return parseEquick(json(decodeText(bytes)), number);
+        };
+        // A read that fails to reach Equick, or hangs, gets one more: the first gets
+        // half of the budget, so the retry fits in the rest.
+        return runSteps({ carrier: 'equick', budgetMs: context.budgetMs ?? 15_000, signal: context.signal,
+            recorder: this.options.recorder ?? NOOP_RECORDER }, [
+            { id: 'direct', run: ({ signal, remainingMs }) => read(signal, firstAttemptMs(remainingMs)) },
+            networkRetryStep(({ signal, remainingMs }) => read(signal, remainingMs)),
+        ]);
+    }
+}
+export const adapter = (environment) => {
+    const tracker = new EquickTracker({ fetcher: environment.fetcher, recorder: environment.recorder, userAgent: environment.userAgent });
+    return {
+        id: 'equick', recordsSteps: true, steps: ['direct', 'retry'],
+        track: (input, context) => tracker.fetch(input.number, context),
+        recognize: (number, context) => recognizeFromLookup(() => tracker.fetch(number, context), () => accepted(() => normalizeEquickNumber(number))),
+    };
+};

package/dist/carriers/equick/carrier.json

@@ -23,16 +23,51 @@
   "timezone": "Asia/Shanghai",
   "tracking": {
     "mode": "automatic",
-    "adapter": "universal",
-    "steps": []
+    "adapter": "equick",
+    "steps": [
+      "direct",
+      "retry"
+    ],
+    "recognition": {
+      "rank": 853
+    },
+    "localClocks": true
   },
-  "capabilities": [],
+  "capabilities": [
+    "history",
+    "location",
+    "destination_country",
+    "delivery_tracking_number"
+  ],
   "portal": {
     "canaryUrl": "https://api.equick.cn/",
-    "shows": [],
-    "scraped": [],
+    "shows": [
+      "status",
+      "history",
+      "location",
+      "destination_country"
+    ],
+    "scraped": [
+      "status",
+      "history",
+      "location",
+      "destination_country",
+      "delivery_tracking_number"
+    ],
     "discarded": [],
-    "unavailable": []
+    "unavailable": [
+      "eta",
+      "delivered_at",
+      "offset_timestamps",
+      "weight",
+      "service_name",
+      "delivery_partner",
+      "provider_code",
+      "origin_country",
+      "sender_name",
+      "recipient_name",
+      "proof_of_delivery"
+    ]
   },
   "links": [
     {
@@ -43,5 +78,11 @@
       "fragment": "^/support/supportWay\\?(?:[^#]*&)?nums=([^&,]+)"
     }
   ],
-  "detection": []
+  "detection": [
+    {
+      "id": "equick-eqk",
+      "pattern": "^EQK[A-Z]{2}\\d{10}YQ$",
+      "confidence": "high"
+    }
+  ]
 }

package/dist/carriers/equick/numbers.json

@@ -53,15 +53,14 @@
         "dateKind": "capture",
         "access": "full_page"
       },
-      "quarantine": true,
       "context": {
-        "assessment": "review"
+        "assessment": "confirmed"
       },
       "expect": {
-        "carrier": "unknown",
-        "confidence": "none"
+        "carrier": "equick",
+        "confidence": "high"
       },
-      "note": "ParcelPanel's Equick China page offers it as the sample number to try; nothing from Equick shows the EQK layout."
+      "note": "ParcelPanel's Equick China page offers it as the sample number to try. Equick's own tracker knows it."
     },
     {
       "number": "EQKPT8586061210YQ",
@@ -73,15 +72,14 @@
         "dateKind": "capture",
         "access": "full_page"
       },
-      "quarantine": true,
       "context": {
-        "assessment": "review"
+        "assessment": "candidate"
       },
       "expect": {
-        "carrier": "unknown",
-        "confidence": "none"
+        "carrier": "equick",
+        "confidence": "high"
       },
-      "note": "TrackingMore's Equick China page gives it as a format example; nothing from Equick shows the EQK layout."
+      "note": "TrackingMore's Equick China page gives it as a format example, in the layout of the numbers Equick's own tracker knows."
     }
   ]
 }

package/dist/carriers/equick/parser.d.ts

@@ -0,0 +1,16 @@
+import type { CarrierResult } from '../../core/result/index.js';
+export declare const PROVIDER = "Equick";
+export declare const EQUICK_MAX_BYTES: number;
+/** An Equick number, in capitals; anything else is not one Equick issues. */
+export declare function normalizeEquickNumber(raw: string): string;
+/** A scan's wording without who signed for it or phone numbers. */
+export declare function equickWording(value: string): string;
+/**
+ * The reply of the tracker's `POST /api/traceQuery` for one number:
+ * `{"code":1,"msg":"success","data":{…}}`, where `data` keys each number asked,
+ * as it was sent, to its scans. A number the tracker does not know has no key,
+ * so one asked alone gets `{}`, which the page reports as no result. A `code`
+ * other than 1 is a lookup the service did not complete. Every scan must name
+ * the whole number asked.
+ */
+export declare function parseEquick(payload: unknown, raw: string): CarrierResult;

package/dist/carriers/equick/parser.js

@@ -0,0 +1,151 @@
+import { normalizeTrackingNumber } from '../../core/detection/index.js';
+import { IndeterminateError, InvalidInputError, NoHistoryError, NotFoundError, SchemaError } from '../../core/errors/index.js';
+import { languageStageStatus } from '../../core/status/index.js';
+import { calendarDay, countryCode } from '../../core/time/index.js';
+import { clean } from '../../core/transport/index.js';
+import { isRecord } from '../../core/types.js';
+import { equickScanStage } from './status.js';
+export const PROVIDER = 'Equick';
+// A long history is a few kilobytes; the tracker answers up to fifty numbers a request.
+export const EQUICK_MAX_BYTES = 512 * 1024;
+// EQK, two letters, ten digits and YQ, as the current tracker's numbers read, or the nine
+// digits of the older tracker's.
+const NUMBER = /^(?:EQK[A-Z]{2}\d{10}YQ|\d{9})$/;
+// The delivering carrier's number.
+const PARTNER_NUMBER = /^(?=.*\d)[A-Z0-9]{4,40}$/;
+// "2029-12-14 18:35:22", the scan's wall clock.
+const CLOCK = /^(\d{4})-(\d{2})-(\d{2}) (\d{2}):(\d{2})(?::(\d{2}))?$/;
+// A run of nine or more digits, with spaces, brackets, dots or hyphens between them, as phone
+// numbers are written; a date stays.
+const PHONE = /(?<![A-Z\d])(?!\d{4}-\d{2}-\d{2}(?!\d))\+?\d(?:[\s().-]{0,2}\d){8,}(?![A-Z\d])/gi;
+// Who took a delivered parcel, after the delivery's own words.
+const RECEIVER = /\s*[,;:.\-–]?\s*\b(?:signed(?: for)? by|signatory|received by)\b[\s\S]*$/i;
+const MAX_NUMBERS = 50;
+const MAX_ROWS = 500;
+/** An Equick number, in capitals; anything else is not one Equick issues. */
+export function normalizeEquickNumber(raw) {
+    const number = raw.length <= 64 ? normalizeTrackingNumber(raw) : '';
+    if (!NUMBER.test(number))
+        throw new InvalidInputError(PROVIDER, 'Equick numbers are EQK, two letters, ten digits and YQ, or nine digits');
+    return number;
+}
+/** An optional text field; anything but a string is a changed reply. */
+function text(row, key, maxLength = 300) {
+    const value = row[key];
+    if (value === null || value === undefined)
+        return '';
+    if (typeof value !== 'string')
+        throw new SchemaError(PROVIDER, `Equick returned an invalid ${key}`);
+    return clean(value, maxLength);
+}
+/** A scan's wording without who signed for it or phone numbers. */
+export function equickWording(value) {
+    return clean(value.replace(RECEIVER, '').replace(PHONE, '').replace(/\s+([,;:.])/g, '$1'))
+        .replace(/^[\s,;:\-–]+|[\s,;:\-–]+$/g, '');
+}
+/** A scan's clock as an ISO wall time, to the second; the day and time must exist. */
+function wallClock(value) {
+    const match = CLOCK.exec(value);
+    const date = match ? calendarDay(Number(match[1]), Number(match[2]), Number(match[3])) : null;
+    const [hour, minute, second] = [Number(match?.[4]), Number(match?.[5]), Number(match?.[6] ?? 0)];
+    if (!date || hour > 23 || minute > 59 || second > 59)
+        throw new SchemaError(PROVIDER, 'Equick returned an invalid scan time');
+    return `${date}T${match[4]}:${match[5]}:${match[6] ?? '00'}`;
+}
+/** The scans under the number's key, deduplicated, with the delivering carrier's numbers they carry. */
+function scans(rows, number) {
+    const seen = new Set();
+    const events = [];
+    const partners = new Set();
+    let country = '';
+    for (const row of rows) {
+        if (!isRecord(row) || typeof row.traceLabelNo !== 'string')
+            throw new SchemaError(PROVIDER, 'Equick returned an invalid scan');
+        // Every scan names the shipment it belongs to.
+        if (normalizeTrackingNumber(row.traceLabelNo) !== number)
+            throw new IndeterminateError(PROVIDER, 'Equick answered for another shipment');
+        const said = text(row, 'traceContent', 2000);
+        if (!said)
+            throw new SchemaError(PROVIDER, 'Equick returned a scan without its wording');
+        const local = wallClock(text(row, 'traceDateTime', 40));
+        const description = equickWording(said);
+        country ||= text(row, 'traceCountry', 80);
+        const partner = text(row, 'destinationWBNo', 200);
+        if (partner && normalizeTrackingNumber(partner) !== number)
+            partners.add(normalizeTrackingNumber(partner));
+        if (!description)
+            continue;
+        const location = text(row, 'traceLocation', 120);
+        const key = JSON.stringify([local, description, location]);
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        const staged = equickScanStage(description);
+        events.push({
+            local_time: local,
+            description,
+            ...(location ? { location } : {}),
+            ...(staged ? { stage: staged.stage, stage_source: staged.source } : {}),
+        });
+    }
+    return { events, country, partners };
+}
+/**
+ * The reply of the tracker's `POST /api/traceQuery` for one number:
+ * `{"code":1,"msg":"success","data":{…}}`, where `data` keys each number asked,
+ * as it was sent, to its scans. A number the tracker does not know has no key,
+ * so one asked alone gets `{}`, which the page reports as no result. A `code`
+ * other than 1 is a lookup the service did not complete. Every scan must name
+ * the whole number asked.
+ */
+export function parseEquick(payload, raw) {
+    const number = normalizeEquickNumber(raw);
+    if (!isRecord(payload) || typeof payload.code !== 'number')
+        throw new SchemaError(PROVIDER, 'Equick returned an invalid envelope');
+    if (payload.code !== 1)
+        throw new IndeterminateError(PROVIDER, 'Equick did not complete the lookup');
+    const data = payload.data;
+    // The service's answer to a request without a number.
+    if (data === null)
+        throw new IndeterminateError(PROVIDER, 'Equick returned an empty result');
+    if (!isRecord(data))
+        throw new SchemaError(PROVIDER, 'Equick returned an invalid result');
+    const keys = Object.keys(data);
+    if (keys.length > MAX_NUMBERS)
+        throw new SchemaError(PROVIDER, 'Equick returned too many results');
+    if (!keys.length)
+        throw new NotFoundError(PROVIDER);
+    const mine = keys.filter((key) => normalizeTrackingNumber(key) === number);
+    if (!mine.length)
+        throw new IndeterminateError(PROVIDER, 'Equick answered for another number');
+    if (mine.length > 1)
+        throw new IndeterminateError(PROVIDER, 'Equick returned several results for the number');
+    const rows = data[mine[0]];
+    if (!Array.isArray(rows))
+        throw new SchemaError(PROVIDER, 'Equick returned a shipment with invalid scans');
+    if (rows.length > MAX_ROWS)
+        throw new SchemaError(PROVIDER, 'Equick returned an oversized history');
+    const { events, country, partners } = scans(rows, number);
+    if (!events.length)
+        throw new NoHistoryError(PROVIDER);
+    // Newest first, as the tracker lists them by wall clock; an oldest-first reply is turned round.
+    // The clocks can be several places', so the order otherwise stands.
+    const newestFirst = events[0].local_time < events.at(-1).local_time ? events.reverse() : events;
+    const newest = newestFirst[0];
+    const scanned = newestFirst.find((event) => event.stage);
+    const stage = scanned?.stage;
+    const destination = country ? countryCode(country) : null;
+    const [partner] = partners;
+    return {
+        status: stage ? languageStageStatus(stage) : 'unknown',
+        ...(stage ? { current_stage: stage, current_stage_source: scanned.stage_source } : {}),
+        last_status_text: newest.description,
+        last_update: null,
+        last_update_local: newest.local_time,
+        expected_delivery: null,
+        ...(destination ? { destination_country: destination } : country ? { destination_country_name: country } : {}),
+        // The delivering carrier's number, when the scans carry one; the reply does not name the carrier.
+        ...(partners.size === 1 && PARTNER_NUMBER.test(partner) ? { delivery_tracking_number: partner } : {}),
+        events: newestFirst,
+    };
+}

package/dist/carriers/equick/status.d.ts

@@ -0,0 +1,11 @@
+import { type ClassifiedWording, type Stage } from '../../core/status/index.js';
+import { type CarrierStatusMap } from '../../core/status/statusMap.js';
+/** The stage Equick's map gives a scan's wording. */
+export declare function equickStage(wording: string): Stage | undefined;
+/** A scan's stage: Equick's map, else the shared wording rules, else none. */
+export declare function equickScanStage(wording: string): ClassifiedWording | null;
+/**
+ * Scans come without a code. The tracker's Status column (`In progress`,
+ * `Hold`) is not kept: it sets no stage, the wording does.
+ */
+export declare const statusMap: CarrierStatusMap;

package/dist/carriers/equick/status.js

@@ -0,0 +1,30 @@
+import { classifyWording } from '../../core/status/index.js';
+import { normalizeStatusWording } from '../../core/status/statusMap.js';
+import statuses from './statuses.json' with { type: 'json' };
+const ENTRIES = statuses.entries;
+/** The scan wordings seen on Equick's trackers, in `normalizeStatusWording` form. */
+const WORDINGS = new Map(ENTRIES.filter((entry) => !entry.code && entry.stage)
+    .map((entry) => [normalizeStatusWording(entry.wording), entry.stage]));
+// A depot, hub, operation centre or airport named by its three-letter code, which changes with the route.
+const SITE_SCAN = /^(?:arrived at|departed from) [a-z]{3} (?:depot|hub|operation center|airport)$/;
+/** The stage Equick's map gives a scan's wording. */
+export function equickStage(wording) {
+    const key = normalizeStatusWording(wording);
+    return WORDINGS.get(key) ?? (SITE_SCAN.test(key) ? 'in_transit' : undefined);
+}
+/** A scan's stage: Equick's map, else the shared wording rules, else none. */
+export function equickScanStage(wording) {
+    const mapped = equickStage(wording);
+    if (mapped)
+        return { stage: mapped, source: 'carrier_map' };
+    const worded = classifyWording(wording, 'in_transit');
+    return worded.source === 'none' ? null : worded;
+}
+/**
+ * Scans come without a code. The tracker's Status column (`In progress`,
+ * `Hold`) is not kept: it sets no stage, the wording does.
+ */
+export const statusMap = {
+    stage: (code, wording) => (code === null ? equickStage(wording) : undefined),
+    gaps: [],
+};

package/dist/carriers/equick/statuses.json

@@ -1,9 +1,18 @@
 {
   "carrier": "equick",
   "entries": [
+    {"code": "In progress", "wording": "In progress", "language": "en", "confirmedBy": "live", "note": "The tracker's Status column on most scans; it sets no stage, the scan's wording does."},
+    {"code": "Hold", "wording": "Hold", "language": "en", "confirmedBy": "live", "note": "Seen in the Status column of a pick-up scan the parcel moved on from, so it sets no stage; the scan's wording does."},
+    {"wording": "Shipping Label Created", "stage": "registered", "language": "en", "confirmedBy": "live"},
     {"wording": "Delivered", "stage": "delivered", "language": "en", "confirmedBy": "portal", "note": "Shown in the Status field above the history."},
-    {"wording": "picked up from shipper", "stage": "accepted", "language": "en", "confirmedBy": "portal", "note": "Pick-up from the sender in China."},
+    {"wording": "picked up from shipper", "stage": "accepted", "language": "en", "confirmedBy": "portal", "note": "Pick-up from the sender in China; the current tracker writes it Picked up from shipper."},
     {"wording": "Accepted by courier", "stage": "accepted", "language": "en", "confirmedBy": "portal"},
+    {"wording": "Arrived at SHA Depot", "stage": "in_transit", "language": "en", "confirmedBy": "live", "note": "Shanghai depot; the code changes with the depot."},
+    {"wording": "Departed from Original Depot", "stage": "in_transit", "language": "en", "confirmedBy": "live"},
+    {"wording": "Arrived at Equick operation center", "stage": "in_transit", "language": "en", "confirmedBy": "live"},
+    {"wording": "Departed from Equick operation center", "stage": "in_transit", "language": "en", "confirmedBy": "live"},
+    {"wording": "Arrived at original airport", "stage": "in_transit", "language": "en", "confirmedBy": "live", "note": "The departure airport in China."},
+    {"wording": "Shipment not yet received or processed", "stage": "in_transit", "language": "en", "confirmedBy": "live", "note": "The destination's delivery carrier has the parcel's data but not the parcel, relayed. Equick took the parcel first, so it does not step back to registered."},
     {"wording": "Arrived at SHA operation center", "stage": "in_transit", "language": "en", "confirmedBy": "portal", "note": "Shanghai operation centre."},
     {"wording": "Arrived at BJS hub", "stage": "in_transit", "language": "en", "confirmedBy": "portal", "note": "Beijing hub."},
     {"wording": "Departed from PVG airport", "stage": "in_transit", "language": "en", "confirmedBy": "portal", "note": "The airport code changes with the route, as in Departed from BJS airport."},

package/dist/core/catalog/statusMaps.js

@@ -103,6 +103,7 @@ import { statusMap as energiaTk } from '../../carriers/energia-tk/status.js';
 import { statusMap as enviaColombia } from '../../carriers/envia-colombia/status.js';
 import { statusMap as envialia } from '../../carriers/envialia/status.js';
 import { statusMap as epostGlobal } from '../../carriers/epost-global/status.js';
+import { statusMap as equick } from '../../carriers/equick/status.js';
 import { statusMap as estes } from '../../carriers/estes/status.js';
 import { statusMap as eurodis } from '../../carriers/eurodis/status.js';
 import { statusMap as expressOne } from '../../carriers/express-one/status.js';
@@ -307,7 +308,7 @@ export const STATUS_MAPS = {
     'danske-fragtmaend': danskeFragtmaend, dao, 'day-ross': dayRoss, dellin, delnext, deppon, 'dhl-express': dhlExpress, 'dhl-freight': dhlFreight, dhlink, dpd, 'dpd-at': dpdAt, 'dpd-be': dpdBe,
     'dpd-de': dpdDe, 'dpd-fr': dpdFr, 'dpd-ie': dpdIe, 'dpd-nl': dpdNl, 'dpd-pl': dpdPl, 'dpd-pt': dpdPt, 'dpd-za': dpdZa, drop2shop, dsv, dx, dynalogic, 'early-bird': earlyBird, 'easy-mail': easyMail,
     econt, 'egypt-post': egyptPost, elta, emile, 'ems-vietnam': emsVietnam, 'energia-tk': energiaTk, 'envia-colombia': enviaColombia, envialia,
-    'epost-global': epostGlobal, estes, eurodis,
+    'epost-global': epostGlobal, equick, estes, eurodis,
     'express-one': expressOne, 'fan-courier': fanCourier, 'fedex-pl': fedexPl, fermopoint, 'fg-delivery': fgDelivery, 'flash-express': flashExpress,
     'flash-express-ph': flashExpressPh,
     'four-px': fourPx, foxpost, fukuyama, gati, gdex,

package/dist/data/catalog.json

@@ -11783,7 +11783,9 @@
         "timezone": "Asia/Shanghai",
         "tracking": {
             "mode": "automatic",
-            "adapter": "universal"
+            "adapter": "equick",
+            "recognitionRank": 853,
+            "localClocks": true
         },
         "canaryUrl": "https://api.equick.cn/",
         "linkRules": [
@@ -11795,7 +11797,12 @@
                 "fragment": "^/support/supportWay\\?(?:[^#]*&)?nums=([^&,]+)"
             }
         ],
-        "detectionRules": []
+        "detectionRules": [
+            {
+                "pattern": "^EQK[A-Z]{2}\\d{10}YQ$",
+                "confidence": "high"
+            }
+        ]
     },
     "estes": {
         "displayName": "Estes",

package/dist/generated/catalog.d.ts

@@ -7650,14 +7650,19 @@ export declare const CARRIER_CATALOG: {
         readonly timezone: "Asia/Shanghai";
         readonly tracking: {
             readonly mode: "automatic";
-            readonly adapter: "universal";
+            readonly adapter: "equick";
+            readonly recognitionRank: 853;
+            readonly localClocks: true;
         };
         readonly canaryUrl: "https://api.equick.cn/";
         readonly linkRules: readonly [{
             readonly domains: readonly ["www.equick.cn", "equick.cn"];
             readonly fragment: "^/support/supportWay\\?(?:[^#]*&)?nums=([^&,]+)";
         }];
-        readonly detectionRules: readonly [];
+        readonly detectionRules: readonly [{
+            readonly pattern: "^EQK[A-Z]{2}\\d{10}YQ$";
+            readonly confidence: "high";
+        }];
     };
     readonly estes: {
         readonly displayName: "Estes";

package/dist/generated/catalog.js

@@ -11784,7 +11784,9 @@ export const CARRIER_CATALOG = {
         "timezone": "Asia/Shanghai",
         "tracking": {
             "mode": "automatic",
-            "adapter": "universal"
+            "adapter": "equick",
+            "recognitionRank": 853,
+            "localClocks": true
         },
         "canaryUrl": "https://api.equick.cn/",
         "linkRules": [
@@ -11796,7 +11798,12 @@ export const CARRIER_CATALOG = {
                 "fragment": "^/support/supportWay\\?(?:[^#]*&)?nums=([^&,]+)"
             }
         ],
-        "detectionRules": []
+        "detectionRules": [
+            {
+                "pattern": "^EQK[A-Z]{2}\\d{10}YQ$",
+                "confidence": "high"
+            }
+        ]
     },
     "estes": {
         "displayName": "Estes",
@@ -28478,7 +28485,7 @@ export const DETECTION_RULE_IDS = {
     "envia-colombia": [],
     "envialia": [],
     "epost-global": ["epost-global-1"],
-    "equick": [],
+    "equick": ["equick-eqk"],
     "estes": [],
     "estes-forwarding": [],
     "ethiopian-post": [],

package/dist/generated/recognition.js

@@ -96,6 +96,7 @@ export const CARRIER_RECOGNITION_RANKS = {
     "envia-colombia": 912,
     "envialia": 260,
     "epost-global": 65,
+    "equick": 853,
     "estes": 20,
     "evri": 605,
     "evri-uk": 615,

package/dist/generated/registry.js

@@ -124,6 +124,7 @@ import { adapter as energiaTk } from '../carriers/energia-tk/adapter.js';
 import { adapter as enviaColombia } from '../carriers/envia-colombia/adapter.js';
 import { adapter as envialia } from '../carriers/envialia/adapter.js';
 import { adapter as epostGlobal } from '../carriers/epost-global/adapter.js';
+import { adapter as equick } from '../carriers/equick/adapter.js';
 import { adapter as estafeta } from '../carriers/estafeta/adapter.js';
 import { adapter as estes } from '../carriers/estes/adapter.js';
 import { adapter as eurodis } from '../carriers/eurodis/adapter.js';
@@ -494,6 +495,7 @@ export const REGISTRY = {
         "envia-colombia": enviaColombia,
         "envialia": envialia,
         "epost-global": epostGlobal,
+        "equick": equick,
         "estafeta": estafeta,
         "estes": estes,
         "eurodis": eurodis,
@@ -947,7 +949,7 @@ export const REGISTRY = {
         "envia-colombia": "envia-colombia",
         "envialia": "envialia",
         "epost-global": "epost-global",
-        "equick": "universal",
+        "equick": "equick",
         "estafeta": "estafeta",
         "estes": "estes",
         "estes-forwarding": "universal",

package/dist/server/openapi.json

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

package/package.json

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