universal-parcel-scraper 0.96.0-main.994 → 0.97.0-main.997

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 **155 dedicated adapters** and **5 universal fallbacks**
+**3,500+ carriers** through **156 dedicated adapters** and **5 universal fallbacks**
 
 <sub>208 catalog entries · 66 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 4,349 such statuses, each filed under one stage.
+The carrier folders record 4,357 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

@@ -4852,11 +4852,24 @@
     "timezone": "Europe/London",
     "tracking": {
       "mode": "automatic",
-      "adapter": "universal"
+      "adapter": "apc-overnight",
+      "recognitionRank": 870,
+      "localClocks": true
     },
     "canaryUrl": "https://apc.co.uk/",
+    "trackingUrlTemplate": "https://apcchoice.apc-overnight.com/track-parcel?id={trackingNumber}",
     "trackingSearchUrl": "https://apc.co.uk/",
-    "linkRules": [],
+    "linkRules": [
+      {
+        "domains": [
+          "apcchoice.apc-overnight.com"
+        ],
+        "pathPattern": "^/track-parcel/?$",
+        "params": [
+          "id"
+        ]
+      }
+    ],
     "detectionRules": [
       {
         "pattern": "^20[12]\\d(?:0[1-9]|1[0-2])(?:0[1-9]|[12]\\d|3[01])\\d{14}$",

package/data/coverage-summary.json

@@ -1,6 +1,6 @@
 {
   "catalog": 208,
-  "activeAdapters": 155,
+  "activeAdapters": 156,
   "countries": 66,
   "referenceCarriers": 100,
   "comparison": {

package/data/detection-golden.json

@@ -9600,6 +9600,7 @@
       "apc-overnight"
     ],
     "asked": [
+      "apc-overnight",
       "austrian-post"
     ]
   },
@@ -9663,6 +9664,7 @@
       "apc-overnight"
     ],
     "asked": [
+      "apc-overnight",
       "austrian-post"
     ]
   },
@@ -9686,6 +9688,7 @@
       "apc-overnight"
     ],
     "asked": [
+      "apc-overnight",
       "austrian-post"
     ]
   },
@@ -9703,6 +9706,7 @@
       "apc-overnight"
     ],
     "asked": [
+      "apc-overnight",
       "austrian-post"
     ]
   },

package/dist/browser/scraper.js

@@ -3976,11 +3976,18 @@ var be = {
 		timezone: "Europe/London",
 		tracking: {
 			mode: "automatic",
-			adapter: "universal"
+			adapter: "apc-overnight",
+			recognitionRank: 870,
+			localClocks: !0
 		},
 		canaryUrl: "https://apc.co.uk/",
+		trackingUrlTemplate: "https://apcchoice.apc-overnight.com/track-parcel?id={trackingNumber}",
 		trackingSearchUrl: "https://apc.co.uk/",
-		linkRules: [],
+		linkRules: [{
+			domains: ["apcchoice.apc-overnight.com"],
+			pathPattern: "^/track-parcel/?$",
+			params: ["id"]
+		}],
 		detectionRules: [{
 			pattern: "^20[12]\\d(?:0[1-9]|1[0-2])(?:0[1-9]|[12]\\d|3[01])\\d{14}$",
 			confidence: "low",
@@ -11920,6 +11927,7 @@ var bc = {
 	"acs-courier": 570,
 	aliexpress: 140,
 	"allegro-one": 770,
+	"apc-overnight": 870,
 	"aras-kargo": 670,
 	"australia-post": 60,
 	"austrian-post": 390,

package/dist/carriers/apc-overnight/adapter.d.ts

@@ -0,0 +1,14 @@
+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';
+export declare const APC_OVERNIGHT_ENDPOINT = "https://apcchoice.apc-overnight.com/track-parcel";
+export declare class ApcOvernightTracker {
+    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/apc-overnight/adapter.js

@@ -0,0 +1,53 @@
+import { accepted, recognizeFromLookup } from '../../core/adapter/index.js';
+import { IndeterminateError, 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 { APC_OVERNIGHT_MAX_BYTES, normalizeApcOvernightNumber, parseApcOvernight, PROVIDER } from './parser.js';
+// APC Choice's public tracking page, which merchants link to with the waybill as `id`.
+export const APC_OVERNIGHT_ENDPOINT = 'https://apcchoice.apc-overnight.com/track-parcel';
+const REDIRECTS = [301, 302, 303, 307, 308];
+// A missing route is not a missing consignment: the tracker answers unknown waybills with a notice.
+const GONE = [404, 410];
+export class ApcOvernightTracker {
+    options;
+    constructor(options = {}) {
+        this.options = options;
+    }
+    async fetch(raw, context = {}) {
+        const number = normalizeApcOvernightNumber(raw);
+        const url = `${APC_OVERNIGHT_ENDPOINT}?${new URLSearchParams({ id: number })}`;
+        const read = async (signal, timeoutMs) => {
+            const { response, bytes } = await fetchBounded(url, { method: 'GET', signal, headers: {
+                    Accept: 'text/html,application/xhtml+xml',
+                    'User-Agent': userAgentOf(this.options.userAgent),
+                } }, { provider: PROVIDER, timeoutMs: Math.max(1, Math.floor(timeoutMs)), maxBytes: APC_OVERNIGHT_MAX_BYTES,
+                redirect: 'manual', allowHttpStatuses: [...REDIRECTS, ...GONE], fetcher: this.options.fetcher });
+            // The site sends its errors to the search page with a message in the address.
+            if (REDIRECTS.includes(response.status))
+                throw new IndeterminateError(PROVIDER, 'APC Overnight sent the lookup to another page');
+            if (GONE.includes(response.status))
+                throw new TransportError(PROVIDER, 'APC Overnight tracking page is unavailable');
+            const html = decodeText(bytes);
+            if (!html.trim())
+                throw new IndeterminateError(PROVIDER, 'APC Overnight returned an empty page');
+            return parseApcOvernight(html, number);
+        };
+        // A request that fails to reach APC, or hangs, gets one more try: the
+        // first gets half of the budget, so the retry fits in the rest.
+        return runSteps({ carrier: 'apc-overnight', 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 ApcOvernightTracker({ fetcher: environment.fetcher, recorder: environment.recorder, userAgent: environment.userAgent });
+    return {
+        id: 'apc-overnight', recordsSteps: true, steps: ['direct', 'retry'],
+        track: (input, context) => tracker.fetch(input.number, context),
+        recognize: (number, context) => recognizeFromLookup(() => tracker.fetch(number, context), () => accepted(() => normalizeApcOvernightNumber(number))),
+    };
+};

package/dist/carriers/apc-overnight/carrier.json

@@ -17,19 +17,66 @@
   "timezone": "Europe/London",
   "tracking": {
     "mode": "automatic",
-    "adapter": "universal",
-    "steps": []
+    "adapter": "apc-overnight",
+    "steps": [
+      "direct",
+      "retry"
+    ],
+    "recognition": {
+      "rank": 870
+    },
+    "localClocks": true
   },
-  "capabilities": [],
+  "capabilities": [
+    "history",
+    "weight",
+    "service_name"
+  ],
   "portal": {
+    "url": "https://apcchoice.apc-overnight.com/track-parcel?id={trackingNumber}",
     "searchUrl": "https://apc.co.uk/",
     "canaryUrl": "https://apc.co.uk/",
-    "shows": [],
-    "scraped": [],
-    "discarded": [],
-    "unavailable": []
+    "shows": [
+      "status",
+      "history",
+      "weight",
+      "service_name",
+      "parcel_count",
+      "customer_reference",
+      "office_contact_details",
+      "proof_of_delivery"
+    ],
+    "scraped": [
+      "status",
+      "history",
+      "weight",
+      "service_name"
+    ],
+    "discarded": [
+      "parcel_count",
+      "customer_reference",
+      "office_contact_details",
+      "proof_of_delivery"
+    ],
+    "unavailable": [
+      "location",
+      "eta",
+      "sender_name",
+      "recipient_name",
+      "offset_timestamps"
+    ]
   },
-  "links": [],
+  "links": [
+    {
+      "domains": [
+        "apcchoice.apc-overnight.com"
+      ],
+      "pathPattern": "^/track-parcel/?$",
+      "params": [
+        "id"
+      ]
+    }
+  ],
   "detection": [
     {
       "id": "apc-overnight-1",

package/dist/carriers/apc-overnight/numbers.json

@@ -10,7 +10,7 @@
         "access": "full_page"
       },
       "context": {
-        "assessment": "candidate"
+        "assessment": "confirmed"
       },
       "expect": {
         "carrier": "unknown",
@@ -22,7 +22,7 @@
           "estafeta"
         ]
       },
-      "note": "A seller on Amazon's seller forum gives it as an APC Overnight consignment number."
+      "note": "A seller on Amazon's seller forum gives it as an APC Overnight consignment number. APC's tracker returns its history."
     },
     {
       "number": "2026100902014380018924",
@@ -35,7 +35,7 @@
         "access": "full_page"
       },
       "context": {
-        "assessment": "candidate"
+        "assessment": "confirmed"
       },
       "expect": {
         "carrier": "unknown",
@@ -47,7 +47,7 @@
           "estafeta"
         ]
       },
-      "note": "ParcelPanel's APC Overnight page offered it as a sample to try on 11 Oct 2026; it is not described as a live shipment."
+      "note": "ParcelPanel's APC Overnight page offered it as a sample to try on 11 Oct 2026. APC's tracker returns its history."
     },
     {
       "number": "2026090302014380017949",
@@ -60,7 +60,7 @@
         "access": "full_page"
       },
       "context": {
-        "assessment": "candidate"
+        "assessment": "confirmed"
       },
       "expect": {
         "carrier": "unknown",
@@ -72,7 +72,7 @@
           "estafeta"
         ]
       },
-      "note": "ParcelPanel's APC Overnight page offered it as a sample to try on 11 Oct 2026; it is not described as a live shipment."
+      "note": "ParcelPanel's APC Overnight page offered it as a sample to try on 11 Oct 2026. APC's tracker returns its history."
     },
     {
       "number": "2018041910099660000599",
@@ -95,7 +95,7 @@
           "estafeta"
         ]
       },
-      "note": "The Glama listing of an open-source MCP server for APC Overnight's booking API uses it as the waybill in an example prompt; it is not described as a live shipment."
+      "note": "The Glama listing of an open-source MCP server for APC Overnight's booking API uses it as the waybill in an example prompt; it is not described as a live shipment. APC's tracker no longer finds it."
     }
   ]
 }

package/dist/carriers/apc-overnight/parser.d.ts

@@ -0,0 +1,17 @@
+import type { CarrierResult } from '../../core/result/index.js';
+export declare const PROVIDER = "APC Overnight";
+export declare const APC_OVERNIGHT_MAX_BYTES: number;
+/**
+ * An APC waybill: twenty-two digits that start with the consignment's booking
+ * date, as 20YYMMDD, and end with its seven-digit consignment number. The
+ * tracker looks a consignment up only by the whole waybill.
+ */
+export declare function normalizeApcOvernightNumber(raw: string): string;
+/**
+ * The tracking page for one waybill: a consignment summary, then each item's
+ * journey through the network and its delivery summary, each row a wording
+ * with its day and minute. The page names the consignment by its seven-digit
+ * number, the end of the waybill it was asked for. A waybill the tracker does
+ * not have, or of another shape, comes back on the search page with a notice.
+ */
+export declare function parseApcOvernight(html: string, rawNumber: string): CarrierResult;

package/dist/carriers/apc-overnight/parser.js

@@ -0,0 +1,166 @@
+import { load } from 'cheerio';
+import { DateTime } from 'luxon';
+import { normalizeTrackingNumber } from '../../core/detection/index.js';
+import { ChallengeError, IndeterminateError, InvalidInputError, NoHistoryError, NotFoundError, SchemaError } from '../../core/errors/index.js';
+import { languageStageStatus } from '../../core/status/index.js';
+import { clean } from '../../core/transport/index.js';
+import { apcOvernightStage, isApcOvernightNotice } from './status.js';
+export const PROVIDER = 'APC Overnight';
+// A consignment's page is about 12 kB and the search page about 17 kB.
+export const APC_OVERNIGHT_MAX_BYTES = 512 * 1024;
+const MAX_ITEMS = 200;
+const MAX_ROWS = 2000;
+// The search page's notice for a whole number the tracker does not have.
+const NOT_FOUND = 'Your consignment could not be found';
+// Its notice for an identifier of the wrong shape.
+const INVALID = 'Consignment identifier is invalid';
+// A firewall or bot check's page, which can come back with HTTP 200.
+const BLOCKED = /<title>\s*(?:Request Rejected|Access Denied|Attention Required|Just a moment)|requested URL was rejected|_cf_chl_opt|cf-turnstile/i;
+// "At Hub (10-Oct-2026 00:31)": the wording, then the day and minute in brackets.
+const ROW = /^(.+?) \((\d{2}-[A-Z][a-z]{2}-\d{4} \d{2}:\d{2})\)$/;
+const WEIGHT = /^(\d{1,6}(?:\.\d{1,3})?) kg$/;
+// "NC16 (Next Business Day Non-Conveyable Parcel)": the service's code, then its name.
+const SERVICE = /^[A-Z0-9]{1,8} \((.{1,80})\)$/;
+/**
+ * An APC waybill: twenty-two digits that start with the consignment's booking
+ * date, as 20YYMMDD, and end with its seven-digit consignment number. The
+ * tracker looks a consignment up only by the whole waybill.
+ */
+export function normalizeApcOvernightNumber(raw) {
+    const number = normalizeTrackingNumber(raw);
+    if (/^20\d{20}$/.test(number) && DateTime.fromFormat(number.slice(0, 8), 'yyyyMMdd', { zone: 'UTC' }).isValid)
+        return number;
+    throw new InvalidInputError(PROVIDER, 'APC Overnight tracks its twenty-two-digit waybills, which start with their booking date');
+}
+/** "09-Oct-2026 17:58" as a wall clock. The page gives no offset. */
+function wallClock(stamp) {
+    // UTC only checks the calendar fields. No offset is assigned.
+    const parsed = DateTime.fromFormat(stamp, 'dd-LLL-yyyy HH:mm', { zone: 'UTC', locale: 'en-GB' });
+    return parsed.isValid ? parsed.toFormat("yyyy-MM-dd'T'HH:mm:ss") : null;
+}
+/** The consignment summary's value next to one label, or '' without one. */
+function summaryValue($, label) {
+    const cells = $('div.con-summary tr').filter((_, row) => clean($(row).children('th').text(), 80) === label).children('td');
+    return cells.length === 1 ? clean(cells.text(), 200) : '';
+}
+/** The search page APC sends back for a number it has no consignment page for. */
+function searchPage($, html, number) {
+    const notices = $('p.login-error');
+    if (!notices.length) {
+        if (BLOCKED.test(html.slice(0, 64_000)))
+            throw new ChallengeError(PROVIDER, 'APC Overnight answered with a block page');
+        throw new SchemaError(PROVIDER, 'APC Overnight did not return a consignment page');
+    }
+    const notice = notices.length === 1 ? clean(notices.text(), 200) : '';
+    // The page puts the identifier it was asked for back into its search field.
+    const fields = $('input#ConsignmentNumber');
+    const echoed = fields.length === 1 ? normalizeTrackingNumber(clean(fields.attr('value'), 80)) : '';
+    if (notice === NOT_FOUND || notice === INVALID) {
+        if (echoed !== number)
+            throw new SchemaError(PROVIDER, 'APC Overnight answered for a different number');
+        if (notice === NOT_FOUND)
+            throw new NotFoundError(PROVIDER);
+        throw new InvalidInputError(PROVIDER, 'APC Overnight does not accept the number');
+    }
+    throw new IndeterminateError(PROVIDER, 'APC Overnight answered with another notice');
+}
+function row(text, index) {
+    const match = ROW.exec(text);
+    const time = match ? wallClock(match[2]) : null;
+    if (!match || !time)
+        throw new SchemaError(PROVIDER, 'APC Overnight returned a row without its wording and clock');
+    return { local_time: time, description: match[1], index };
+}
+/**
+ * The tracking page for one waybill: a consignment summary, then each item's
+ * journey through the network and its delivery summary, each row a wording
+ * with its day and minute. The page names the consignment by its seven-digit
+ * number, the end of the waybill it was asked for. A waybill the tracker does
+ * not have, or of another shape, comes back on the search page with a notice.
+ */
+export function parseApcOvernight(html, rawNumber) {
+    const number = normalizeApcOvernightNumber(rawNumber);
+    const $ = load(html);
+    const summaries = $('div.tracking-container div.con-summary');
+    if (!summaries.length)
+        searchPage($, html, number);
+    if (summaries.length !== 1)
+        throw new SchemaError(PROVIDER, 'APC Overnight returned an unexpected consignment page');
+    if (summaryValue($, 'Consignment number:') !== number.slice(-7)) {
+        throw new SchemaError(PROVIDER, 'APC Overnight answered for a different consignment');
+    }
+    const items = $('div.details-container > div.item-details');
+    if (!items.length || items.length > MAX_ITEMS)
+        throw new SchemaError(PROVIDER, 'APC Overnight returned an invalid item list');
+    const rows = [];
+    const seen = new Set();
+    items.each((_, item) => {
+        const journey = $(item).children('div.detailed-journey-container').children('ul');
+        const delivery = $(item).children('div.detailed-delivery-container');
+        if (journey.length !== 1 || delivery.length !== 1)
+            throw new SchemaError(PROVIDER, 'APC Overnight item layout changed');
+        // Only the first line of a delivery record is read: it is the record's
+        // wording and clock, and nothing after it.
+        const texts = [
+            ...journey.children('li').toArray().map(node => clean($(node).text(), 300)),
+            ...delivery.children('div.pod-details').toArray().map(node => clean($(node).children('p').first().text(), 300)),
+        ];
+        for (const text of texts) {
+            if (rows.length >= MAX_ROWS)
+                throw new SchemaError(PROVIDER, 'APC Overnight returned too many rows');
+            const parsed = row(text, rows.length);
+            // Every item repeats the consignment's delivery records, and items
+            // travelling together share their scans.
+            const identity = JSON.stringify([parsed.local_time, parsed.description]);
+            if (seen.has(identity))
+                continue;
+            seen.add(identity);
+            rows.push(parsed);
+        }
+    });
+    if (!rows.length)
+        throw new NoHistoryError(PROVIDER);
+    // Oldest first, equal clocks in the page's order: a notice keeps the stage
+    // before it, and a delivery once the consignment was sent back reaches its
+    // sender.
+    rows.sort((left, right) => left.local_time < right.local_time ? -1 : left.local_time > right.local_time ? 1 : left.index - right.index);
+    const events = [];
+    let previous;
+    let returning = false;
+    for (const { local_time, description } of rows) {
+        const event = { local_time, description };
+        events.push(event);
+        if (isApcOvernightNotice(description)) {
+            Object.assign(event, { stage: previous ?? 'registered', stage_source: 'none' });
+            continue;
+        }
+        const classified = apcOvernightStage(description);
+        if (!classified)
+            continue;
+        let stage = classified.stage;
+        if (stage === 'delivered' && returning)
+            stage = 'returned';
+        if (stage === 'returned')
+            returning = true;
+        Object.assign(event, { stage, stage_source: classified.source });
+        previous = stage;
+    }
+    events.reverse();
+    const latest = events[0];
+    const decider = events.find(event => event.stage && event.stage_source !== 'none');
+    const stage = decider?.stage;
+    const weight = WEIGHT.exec(summaryValue($, 'Total weight:'))?.[1];
+    const service = summaryValue($, 'Consignment service:');
+    const serviceName = SERVICE.exec(service)?.[1]?.trim() ?? '';
+    return {
+        status: stage ? languageStageStatus(stage) : 'unknown',
+        ...(stage ? { current_stage: stage, current_stage_source: decider.stage_source } : {}),
+        last_status_text: latest.description,
+        last_update: null,
+        last_update_local: latest.local_time,
+        expected_delivery: null,
+        ...(weight && Number(weight) > 0 ? { weight_kg: Number(weight) } : {}),
+        ...(serviceName ? { service_name: serviceName } : {}),
+        events,
+    };
+}

package/dist/carriers/apc-overnight/status.d.ts

@@ -0,0 +1,12 @@
+import { type ClassifiedWording, type Stage } from '../../core/status/index.js';
+import { type CarrierStatusMap } from '../../core/status/statusMap.js';
+/** The stage the map gives APC's wording, if it knows it. */
+export declare function apcOvernightScanStage(wording: string): Stage | undefined;
+export declare function isApcOvernightNotice(wording: string): boolean;
+/**
+ * A row's stage from the map, else from the shared wording rules. Wording
+ * neither knows stays without a stage, so it remains visible for review.
+ */
+export declare function apcOvernightStage(wording: string): ClassifiedWording | null;
+/** The rows carry wording only. */
+export declare const statusMap: CarrierStatusMap;

package/dist/carriers/apc-overnight/status.js

@@ -0,0 +1,44 @@
+import { classifyWording } from '../../core/status/index.js';
+import { normalizeStatusWording } from '../../core/status/statusMap.js';
+/**
+ * The wording of APC's tracking page: each item's journey through the
+ * network, then the delivery records the delivering depot keeps for the
+ * consignment. The rows carry no code.
+ */
+const STAGES = new Map([
+    // The sending depot collected the consignment and scanned it in.
+    ['at sending depot', 'accepted'],
+    ['at hub', 'in_transit'],
+    ['at delivery depot', 'in_transit'],
+    ['out for delivery', 'out_for_delivery'],
+    // Nobody was in, and the driver left a "Sorry we missed you" card.
+    ['carded', 'failed_attempt'],
+    ['delivered', 'delivered'],
+    ['returned to sender', 'returned'],
+]);
+// A delivery the recipient moved to another day or option, not a movement:
+// the consignment keeps the stage it had.
+const NOTICES = new Set(['delivery rearranged by customer']);
+/** The stage the map gives APC's wording, if it knows it. */
+export function apcOvernightScanStage(wording) {
+    return STAGES.get(normalizeStatusWording(wording));
+}
+export function isApcOvernightNotice(wording) {
+    return NOTICES.has(normalizeStatusWording(wording));
+}
+/**
+ * A row's stage from the map, else from the shared wording rules. Wording
+ * neither knows stays without a stage, so it remains visible for review.
+ */
+export function apcOvernightStage(wording) {
+    const mapped = apcOvernightScanStage(wording);
+    if (mapped)
+        return { stage: mapped, source: 'carrier_map' };
+    const worded = classifyWording(wording, 'in_transit');
+    return worded.source === 'none' ? null : worded;
+}
+/** The rows carry wording only. */
+export const statusMap = {
+    stage: (code, wording) => (code ? undefined : apcOvernightScanStage(wording)),
+    gaps: [...NOTICES].map(wording => ({ wording, note: 'A delivery moved by the recipient, not a movement: the consignment keeps the stage it had.' })),
+};

package/dist/carriers/apc-overnight/statuses.json

@@ -1,4 +1,13 @@
 {
   "carrier": "apc-overnight",
-  "entries": []
+  "entries": [
+    {"wording": "At sending depot", "stage": "accepted", "language": "en", "confirmedBy": "live", "note": "The sending depot collected the consignment and scanned it in."},
+    {"wording": "At Hub", "stage": "in_transit", "language": "en", "confirmedBy": "live"},
+    {"wording": "At delivery depot", "stage": "in_transit", "language": "en", "confirmedBy": "live"},
+    {"wording": "Out for delivery", "stage": "out_for_delivery", "language": "en", "confirmedBy": "live"},
+    {"wording": "Delivery Rearranged By Customer", "language": "en", "confirmedBy": "live", "note": "A delivery record: the recipient moved the delivery to another day or option. Not a movement, so it has no stage of its own and the consignment keeps the one it had."},
+    {"wording": "Carded", "stage": "failed_attempt", "language": "en", "confirmedBy": "live", "note": "A delivery record: nobody was in and the driver left a card."},
+    {"wording": "Delivered", "stage": "delivered", "language": "en", "confirmedBy": "live", "note": "A delivery record. Once the consignment was sent back, the adapter reads a delivery as returned."},
+    {"wording": "Returned To Sender", "stage": "returned", "language": "en", "confirmedBy": "live", "note": "A delivery record."}
+  ]
 }

package/dist/core/catalog/statusMaps.js

@@ -14,6 +14,7 @@ import { statusMap as acsCourier } from '../../carriers/acs-courier/status.js';
 import { statusMap as aliexpress } from '../../carriers/aliexpress/status.js';
 import { statusMap as allegroOne } from '../../carriers/allegro-one/status.js';
 import { statusMap as anPost } from '../../carriers/an-post/status.js';
+import { statusMap as apcOvernight } from '../../carriers/apc-overnight/status.js';
 import { statusMap as arasKargo } from '../../carriers/aras-kargo/status.js';
 import { statusMap as boxNow } from '../../carriers/box-now/status.js';
 import { statusMap as cacesa } from '../../carriers/cacesa/status.js';
@@ -77,7 +78,7 @@ import { normalizeStatusWording } from '../status/statusMap.js';
 import { CARRIER_DEFINITIONS } from './definitions.js';
 /** By adapter: a carrier served by another's adapter, as Delivengo by La Poste's, reads that map. */
 export const STATUS_MAPS = {
-    'acs-courier': acsCourier, aliexpress, 'allegro-one': allegroOne, 'an-post': anPost, 'aras-kargo': arasKargo, 'box-now': boxNow, cacesa, cargus,
+    'acs-courier': acsCourier, aliexpress, 'allegro-one': allegroOne, 'an-post': anPost, 'apc-overnight': apcOvernight, 'aras-kargo': arasKargo, 'box-now': boxNow, cacesa, cargus,
     'ceska-posta': ceskaPosta, 'china-post': chinaPost, chronopost, 'correos-spain': correosSpain, dao, 'dhl-express': dhlExpress, dpd, 'dpd-de': dpdDe,
     'dpd-fr': dpdFr, 'dpd-ie': dpdIe, 'dpd-pl': dpdPl, econt, elta, emile, 'express-one': expressOne, 'fan-courier': fanCourier, foxpost,
     'geniki-taxydromiki': geniki, 'gls-es': glsEs, 'gls-it': glsIt, 'gofo-fr': gofoFr, 'gofo-it': gofoIt, helthjem, 'hrvatska-posta': hrvatskaPosta,

package/dist/data/catalog.json

@@ -4852,11 +4852,24 @@
         "timezone": "Europe/London",
         "tracking": {
             "mode": "automatic",
-            "adapter": "universal"
+            "adapter": "apc-overnight",
+            "recognitionRank": 870,
+            "localClocks": true
         },
         "canaryUrl": "https://apc.co.uk/",
+        "trackingUrlTemplate": "https://apcchoice.apc-overnight.com/track-parcel?id={trackingNumber}",
         "trackingSearchUrl": "https://apc.co.uk/",
-        "linkRules": [],
+        "linkRules": [
+            {
+                "domains": [
+                    "apcchoice.apc-overnight.com"
+                ],
+                "pathPattern": "^/track-parcel/?$",
+                "params": [
+                    "id"
+                ]
+            }
+        ],
         "detectionRules": [
             {
                 "pattern": "^20[12]\\d(?:0[1-9]|1[0-2])(?:0[1-9]|[12]\\d|3[01])\\d{14}$",

package/dist/generated/catalog.d.ts

@@ -3324,11 +3324,18 @@ export declare const CARRIER_CATALOG: {
         readonly timezone: "Europe/London";
         readonly tracking: {
             readonly mode: "automatic";
-            readonly adapter: "universal";
+            readonly adapter: "apc-overnight";
+            readonly recognitionRank: 870;
+            readonly localClocks: true;
         };
         readonly canaryUrl: "https://apc.co.uk/";
+        readonly trackingUrlTemplate: "https://apcchoice.apc-overnight.com/track-parcel?id={trackingNumber}";
         readonly trackingSearchUrl: "https://apc.co.uk/";
-        readonly linkRules: readonly [];
+        readonly linkRules: readonly [{
+            readonly domains: readonly ["apcchoice.apc-overnight.com"];
+            readonly pathPattern: "^/track-parcel/?$";
+            readonly params: readonly ["id"];
+        }];
         readonly detectionRules: readonly [{
             readonly pattern: "^20[12]\\d(?:0[1-9]|1[0-2])(?:0[1-9]|[12]\\d|3[01])\\d{14}$";
             readonly confidence: "low";

package/dist/generated/catalog.js

@@ -4853,11 +4853,24 @@ export const CARRIER_CATALOG = {
         "timezone": "Europe/London",
         "tracking": {
             "mode": "automatic",
-            "adapter": "universal"
+            "adapter": "apc-overnight",
+            "recognitionRank": 870,
+            "localClocks": true
         },
         "canaryUrl": "https://apc.co.uk/",
+        "trackingUrlTemplate": "https://apcchoice.apc-overnight.com/track-parcel?id={trackingNumber}",
         "trackingSearchUrl": "https://apc.co.uk/",
-        "linkRules": [],
+        "linkRules": [
+            {
+                "domains": [
+                    "apcchoice.apc-overnight.com"
+                ],
+                "pathPattern": "^/track-parcel/?$",
+                "params": [
+                    "id"
+                ]
+            }
+        ],
         "detectionRules": [
             {
                 "pattern": "^20[12]\\d(?:0[1-9]|1[0-2])(?:0[1-9]|[12]\\d|3[01])\\d{14}$",

package/dist/generated/recognition.js

@@ -4,6 +4,7 @@ export const CARRIER_RECOGNITION_RANKS = {
     "acs-courier": 570,
     "aliexpress": 140,
     "allegro-one": 770,
+    "apc-overnight": 870,
     "aras-kargo": 670,
     "australia-post": 60,
     "austrian-post": 390,

package/dist/generated/registry.js

@@ -4,6 +4,7 @@ import { adapter as aliexpress } from '../carriers/aliexpress/adapter.js';
 import { adapter as allegroOne } from '../carriers/allegro-one/adapter.js';
 import { adapter as amazonShipping } from '../carriers/amazon-shipping/adapter.js';
 import { adapter as anPost } from '../carriers/an-post/adapter.js';
+import { adapter as apcOvernight } from '../carriers/apc-overnight/adapter.js';
 import { adapter as aramex } from '../carriers/aramex/adapter.js';
 import { adapter as arasKargo } from '../carriers/aras-kargo/adapter.js';
 import { adapter as asendia } from '../carriers/asendia/adapter.js';
@@ -161,6 +162,7 @@ export const REGISTRY = {
         "allegro-one": allegroOne,
         "amazon-shipping": amazonShipping,
         "an-post": anPost,
+        "apc-overnight": apcOvernight,
         "aramex": aramex,
         "aras-kargo": arasKargo,
         "asendia": asendia,
@@ -321,7 +323,7 @@ export const REGISTRY = {
         "amazon-logistics": null,
         "amazon-shipping": "amazon-shipping",
         "an-post": "an-post",
-        "apc-overnight": "universal",
+        "apc-overnight": "apc-overnight",
         "aramex": "aramex",
         "aras-kargo": "aras-kargo",
         "asendia": "asendia",

package/dist/server/openapi.json

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

package/package.json

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