universal-parcel-scraper 0.495.1 → 0.496.0-main.2375

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 **539 dedicated adapters** and **5 universal fallbacks**
+**3,500+ carriers** through **540 dedicated adapters** and **5 universal fallbacks**
 
 <sub>772 catalog entries · 134 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 15,411 such statuses, each filed under one stage.
+The carrier folders record 15,413 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

@@ -16054,7 +16054,9 @@
     "timezone": "America/Los_Angeles",
     "tracking": {
       "mode": "automatic",
-      "adapter": "universal"
+      "adapter": "hovership",
+      "recognitionRank": 687,
+      "localClocks": true
     },
     "canaryUrl": "https://www.hovership.com/track/",
     "trackingUrlTemplate": "https://www.hovership.com/track/{trackingNumber}/",

package/data/coverage-summary.json

@@ -1,6 +1,6 @@
 {
   "catalog": 772,
-  "activeAdapters": 539,
+  "activeAdapters": 540,
   "countries": 134,
   "referenceCarriers": 100,
   "comparison": {

package/dist/browser/scraper.js

@@ -12333,7 +12333,9 @@ var Ue = {
 		timezone: "America/Los_Angeles",
 		tracking: {
 			mode: "automatic",
-			adapter: "universal"
+			adapter: "hovership",
+			recognitionRank: 687,
+			localClocks: !0
 		},
 		canaryUrl: "https://www.hovership.com/track/",
 		trackingUrlTemplate: "https://www.hovership.com/track/{trackingNumber}/",
@@ -29686,6 +29688,7 @@ var Tl = {
 	"hermes-at": 876,
 	"hermes-de": 840,
 	"houng-ah-loun": 637,
+	hovership: 687,
 	"hr-parcel": 887,
 	"hrvatska-posta": 160,
 	hywl: 993,

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

@@ -0,0 +1,17 @@
+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 tracking page on www.hovership.com; one parcel's page is its number under it. */
+export declare const HOVERSHIP_TRACK = "https://www.hovership.com/track/";
+/** The page the tracking form opens for one whole number. */
+export declare function hovershipTrackUrl(number: string): string;
+export declare class HovershipTracker {
+    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/hovership/adapter.js

@@ -0,0 +1,53 @@
+import { accepted, recognizeFromLookup } from '../../core/adapter/index.js';
+import { NotFoundError, 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 { CARRIER, HOVERSHIP_MAX_BYTES, isHovershipNotFound, normalizeHovershipNumber, parseHovership, PROVIDER } from './parser.js';
+/** The tracking page on www.hovership.com; one parcel's page is its number under it. */
+export const HOVERSHIP_TRACK = 'https://www.hovership.com/track/';
+const REDIRECTS = [301, 302, 303, 307, 308];
+/** The page the tracking form opens for one whole number. */
+export function hovershipTrackUrl(number) {
+    return `${HOVERSHIP_TRACK}${encodeURIComponent(normalizeHovershipNumber(number))}/`;
+}
+export class HovershipTracker {
+    options;
+    constructor(options = {}) {
+        this.options = options;
+    }
+    async fetch(raw, context = {}) {
+        const number = normalizeHovershipNumber(raw);
+        const read = async (signal, timeoutMs) => {
+            const { response, bytes } = await fetchBounded(hovershipTrackUrl(number), { method: 'GET', signal, headers: {
+                    Accept: 'text/html', 'User-Agent': userAgentOf(this.options.userAgent),
+                } }, { provider: PROVIDER, timeoutMs: Math.max(1, Math.floor(timeoutMs)), maxBytes: HOVERSHIP_MAX_BYTES, redirect: 'manual',
+                fetcher: this.options.fetcher, allowHttpStatuses: [...REDIRECTS, 404, 410] });
+            if (REDIRECTS.includes(response.status))
+                throw new TransportError(PROVIDER, 'Hovership redirected its tracking page');
+            // The page answers a number it has no shipment for with HTTP 404 and its own notice;
+            // any other 404 is a moved route.
+            if (response.status === 404 && isHovershipNotFound(decodeText(bytes)))
+                throw new NotFoundError(PROVIDER);
+            if (!response.ok)
+                throw new TransportError(PROVIDER, 'Hovership tracking page is unavailable');
+            return parseHovership(decodeText(bytes), number);
+        };
+        // A request that fails to reach the site, or hangs, gets one more try: the
+        // first gets half of the budget, so the retry fits in the rest.
+        return runSteps({ carrier: CARRIER, 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 HovershipTracker({ fetcher: environment.fetcher, recorder: environment.recorder, userAgent: environment.userAgent });
+    return {
+        id: CARRIER, recordsSteps: true, steps: ['direct', 'retry'],
+        track: (input, context) => tracker.fetch(input.number, context),
+        recognize: (number, context) => recognizeFromLookup(() => tracker.fetch(number, context), () => accepted(() => normalizeHovershipNumber(number))),
+    };
+};

package/dist/carriers/hovership/carrier.json

@@ -17,18 +17,68 @@
   "timezone": "America/Los_Angeles",
   "tracking": {
     "mode": "automatic",
-    "adapter": "universal",
-    "steps": []
+    "adapter": "hovership",
+    "steps": [
+      "direct",
+      "retry"
+    ],
+    "recognition": {
+      "rank": 687
+    },
+    "localClocks": true
   },
-  "capabilities": [],
+  "capabilities": [
+    "history",
+    "provider_code",
+    "delivered_at",
+    "eta",
+    "offset_timestamps"
+  ],
   "portal": {
     "url": "https://www.hovership.com/track/{trackingNumber}/",
     "searchUrl": "https://www.hovership.com/track/",
     "canaryUrl": "https://www.hovership.com/track/",
-    "shows": [],
-    "scraped": [],
-    "discarded": [],
-    "unavailable": []
+    "shows": [
+      "status",
+      "progress_rail",
+      "history",
+      "eta",
+      "delivered_at",
+      "offset_timestamps",
+      "origin",
+      "destination",
+      "recipient_address",
+      "proof_of_delivery",
+      "driver_name",
+      "coordinates"
+    ],
+    "scraped": [
+      "status",
+      "history",
+      "provider_code",
+      "eta",
+      "delivered_at",
+      "offset_timestamps"
+    ],
+    "discarded": [
+      "progress_rail",
+      "origin",
+      "destination",
+      "recipient_address",
+      "proof_of_delivery",
+      "driver_name",
+      "coordinates"
+    ],
+    "unavailable": [
+      "location",
+      "weight",
+      "service_name",
+      "sender_name",
+      "recipient_name",
+      "pickup_point",
+      "delivery_partner",
+      "delivery_tracking_number"
+    ]
   },
   "links": [
     {

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

@@ -0,0 +1,19 @@
+import type { CarrierResult } from '../../core/result/index.js';
+export declare const PROVIDER = "Hovership";
+export declare const CARRIER = "hovership";
+export declare const HOVERSHIP_MAX_BYTES: number;
+/** A number for Hovership's tracker, in upper case as its form sends it; anything else is not one it issues. */
+export declare function normalizeHovershipNumber(raw: string): string;
+/** A scan's line without phone numbers, and a delivery's without who took the parcel. */
+export declare function hovershipWording(detail: string, delivered: boolean): string;
+/** Whether a page is the tracker's own answer for a number it has no shipment for. */
+export declare function isHovershipNotFound(html: string): boolean;
+/**
+ * The page `www.hovership.com/track/{number}/` answers. The server renders the
+ * parcel under its number, a headline status with its latest delivery time or
+ * its delivery, and the history newest first, each scan a title, a clock and a
+ * line. The progress rail, the origin and destination towns and the form that
+ * unlocks the address and proof of delivery for the delivery ZIP code are not
+ * read.
+ */
+export declare function parseHovership(html: string, raw: string): CarrierResult;

package/dist/carriers/hovership/parser.js

@@ -0,0 +1,196 @@
+import { load } from 'cheerio';
+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 { calendarDay } from '../../core/time/index.js';
+import { clean } from '../../core/transport/index.js';
+import { hovershipHeadlineStage, hovershipStage } from './status.js';
+export const PROVIDER = 'Hovership';
+export const CARRIER = 'hovership';
+// A parcel's page is about 45 kilobytes, most of it the site's menus.
+export const HOVERSHIP_MAX_BYTES = 512 * 1024;
+// The tracking form's rule, six to thirty letters, digits, underscores and
+// dashes, without the dashes the library's normalization removes.
+const NUMBER = /^(?=[A-Z0-9_]*[A-Z0-9])[A-Z0-9_]{6,30}$/;
+// The line over a parcel's status, "Tracking · {number}".
+const MARKER = /^Tracking\s*·\s*(\S+)$/;
+// The page's answer for a number it has no shipment for.
+const NOT_FOUND = /^Tracking number not found$/i;
+// The page's headline note for a parcel not yet delivered: its latest delivery time.
+const ESTIMATE = /^Arriving (?:no later than|by) (.+)$/;
+const DELIVERED = /^Delivered (.+)$/;
+const MONTHS = ['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec'];
+// "Sep 9, 2026, 2:15 PM PDT": the clock in US English, then its zone's short name.
+const STAMP = /^([A-Z][a-z]{2}) (\d{1,2}), (\d{4}), (\d{1,2}):(\d{2}) ([AP]M)(?: (\S{2,9}))?$/;
+// The short names US English gives the zones of the states Hovership serves, and their offsets in minutes.
+const OFFSETS = {
+    EST: -300, EDT: -240, CST: -360, CDT: -300, MST: -420, MDT: -360, PST: -480, PDT: -420,
+    AKST: -540, AKDT: -480, HST: -600, HDT: -540, AST: -240, UTC: 0, GMT: 0,
+};
+// A zone US English has no short name for, written as its offset ("GMT-7", "GMT+5:30").
+const GMT_OFFSET = /^GMT([+-])(\d{1,2})(?::(\d{2}))?$/;
+// Bot checks a CDN or firewall could put in place of the page.
+const CHALLENGE = /_cf_chl_opt|cf-turnstile|challenge-platform|<title>\s*(?:Just a moment|Attention Required|Access Denied|ERROR: The request could not be satisfied)|AwsWafIntegration|awswaf\.com|gokuProps/i;
+// A run of nine or more digits, with spaces, brackets, dots or hyphens between them, as phone numbers are written.
+const PHONE = /(?<![A-Z\d])\+?\(?\d(?:[\s().-]{0,2}\d){8,}(?![A-Z\d])/gi;
+// Who took a delivered parcel, after the scan's line ("Delivered, signed by …").
+const RECEIVER = /\s*[,;:.\-–]?\s*\b(?:signed(?: for)? by|received by|accepted by|left with)\b[\s\S]*$/i;
+const MAX_ROWS = 300;
+const MAX_EVENTS = 100;
+/** A number for Hovership's tracker, in upper case as its form sends it; anything else is not one it issues. */
+export function normalizeHovershipNumber(raw) {
+    const number = raw.length <= 64 ? normalizeTrackingNumber(raw) : '';
+    if (!NUMBER.test(number))
+        throw new InvalidInputError(PROVIDER, 'Hovership numbers are six to thirty letters, digits and underscores');
+    return number;
+}
+function invalid(message) {
+    throw new SchemaError(PROVIDER, message);
+}
+/** The offset a zone's short name stands for, as an ISO suffix; null for a name not on the list. */
+function zoneOffset(name) {
+    const gmt = name ? GMT_OFFSET.exec(name) : null;
+    const minutes = name && Object.hasOwn(OFFSETS, name) ? OFFSETS[name]
+        : gmt && Number(gmt[2]) <= 14 && Number(gmt[3] ?? 0) <= 59 ? (gmt[1] === '-' ? -1 : 1) * (Number(gmt[2]) * 60 + Number(gmt[3] ?? 0))
+            : null;
+    if (minutes === null)
+        return null;
+    if (minutes === 0)
+        return 'Z';
+    const whole = Math.abs(minutes);
+    return `${minutes < 0 ? '-' : '+'}${String(Math.floor(whole / 60)).padStart(2, '0')}:${String(whole % 60).padStart(2, '0')}`;
+}
+/** A clock the page prints, or null when it is not one. Date libraries accept 0:00 PM, so the fields are checked here. */
+function readStamp(text) {
+    const match = STAMP.exec(text);
+    if (!match)
+        return null;
+    const [, monthName, date, year, hour, minute, half, zone] = match;
+    const day = calendarDay(Number(year), MONTHS.indexOf(monthName) + 1, Number(date));
+    if (!day || Number(hour) < 1 || Number(hour) > 12 || Number(minute) > 59)
+        return null;
+    const hours = (Number(hour) % 12) + (half === 'PM' ? 12 : 0);
+    return { day, wall: `${day}T${String(hours).padStart(2, '0')}:${minute}:00`, offset: zoneOffset(zone) };
+}
+/**
+ * A scan's clock: an instant in the offset of the zone the page names after
+ * it. A zone the page names some other way leaves the wall clock in
+ * `local_time`.
+ */
+function scanClock(text) {
+    const stamp = readStamp(text) ?? invalid('Hovership returned an invalid scan time');
+    return stamp.offset ? { time: `${stamp.wall}${stamp.offset}` } : { local_time: stamp.wall };
+}
+/** A scan's line without phone numbers, and a delivery's without who took the parcel. */
+export function hovershipWording(detail, delivered) {
+    const line = delivered ? detail.replace(RECEIVER, '') : detail;
+    return clean(line.replace(PHONE, ' ').replace(/\s+([,;:.])/g, '$1'), 300).replace(/^[\s,;:.\-–]+|[\s,;:\-–]+$/g, '');
+}
+/** The history's rows, newest first as the page lists them; none when the page has no history. */
+function historyRows($) {
+    const labels = $('main p.stat-card-label').filter((_, label) => clean($(label).text()) === 'Tracking history');
+    if (labels.length > 1)
+        invalid('Hovership returned repeated histories');
+    if (!labels.length)
+        return [];
+    const lists = labels.parent().find('ol');
+    if (lists.length !== 1)
+        invalid('Hovership returned a history without its list');
+    return lists.children('li').toArray();
+}
+function projectRow($, row) {
+    const times = $(row).find('time');
+    if (times.length !== 1)
+        invalid('Hovership returned an incomplete scan');
+    const header = times.parent();
+    const label = clean(header.children('p').first().text(), 80);
+    if (!label)
+        invalid('Hovership returned a scan without its title');
+    const clock = scanClock(clean(times.text(), 60));
+    const detail = clean(header.nextAll('p').first().text(), 400);
+    const staged = hovershipStage(label, detail);
+    const description = hovershipWording(detail, staged?.stage === 'delivered') || label;
+    return {
+        ...clock,
+        description,
+        provider_code: label,
+        ...(staged ? { stage: staged.stage, stage_source: staged.source } : {}),
+    };
+}
+/** The headline note's clock after `pattern`, as an instant or else its day; null when the note is something else. */
+function noteClock(note, pattern) {
+    const text = pattern.exec(note)?.[1];
+    const stamp = text ? readStamp(text) : null;
+    return stamp ? { time: stamp.offset ? `${stamp.wall}${stamp.offset}` : null, day: stamp.day } : null;
+}
+/** Whether a page is the tracker's own answer for a number it has no shipment for. */
+export function isHovershipNotFound(html) {
+    return NOT_FOUND.test(clean(load(html)('main h1').first().text(), 120));
+}
+/**
+ * The page `www.hovership.com/track/{number}/` answers. The server renders the
+ * parcel under its number, a headline status with its latest delivery time or
+ * its delivery, and the history newest first, each scan a title, a clock and a
+ * line. The progress rail, the origin and destination towns and the form that
+ * unlocks the address and proof of delivery for the delivery ZIP code are not
+ * read.
+ */
+export function parseHovership(html, raw) {
+    const number = normalizeHovershipNumber(raw);
+    const $ = load(html);
+    const headline = $('main h1').first();
+    const heading = clean(headline.text(), 120);
+    if (NOT_FOUND.test(heading))
+        throw new NotFoundError(PROVIDER);
+    const markers = $('main p.section-marker').map((_, marker) => clean($(marker).text(), 80)).get()
+        .filter((text) => MARKER.test(text));
+    if (markers.length !== 1 || !heading) {
+        if (CHALLENGE.test(html.slice(0, 64_000)))
+            throw new ChallengeError(PROVIDER, 'Hovership answered with a browser check');
+        invalid('Hovership returned a page without a parcel');
+    }
+    const verify = $('form[data-verify-form]').attr('data-tracking');
+    if (MARKER.exec(markers[0])[1].toUpperCase() !== number || (verify !== undefined && clean(verify, 64).toUpperCase() !== number)) {
+        throw new IndeterminateError(PROVIDER, 'Hovership answered for another parcel');
+    }
+    const rows = historyRows($);
+    if (rows.length > MAX_ROWS)
+        invalid('Hovership returned an oversized history');
+    const seen = new Set();
+    const events = [];
+    for (const row of rows) {
+        const event = projectRow($, row);
+        const key = JSON.stringify([event.time ?? event.local_time, event.provider_code, event.description]);
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        events.push(event);
+    }
+    // Newest first, as the page lists them; an oldest-first list is turned round.
+    const first = events[0]?.time;
+    const last = events.at(-1)?.time;
+    if (first && last && Date.parse(first) < Date.parse(last))
+        events.reverse();
+    const note = clean(headline.nextAll('p').first().text(), 120);
+    const summary = hovershipHeadlineStage(heading);
+    const current = events.find((event) => event.stage);
+    const stage = (current?.stage ?? summary);
+    const final = stage === 'delivered' || stage === 'returned';
+    const estimate = final ? null : noteClock(note, ESTIMATE);
+    const delivered = stage === 'delivered' ? current?.time ?? noteClock(note, DELIVERED)?.time : undefined;
+    const newest = events[0];
+    if (!newest && !summary)
+        throw new NoHistoryError(PROVIDER);
+    return {
+        status: stage ? languageStageStatus(stage) : 'unknown',
+        ...(stage ? { current_stage: stage, current_stage_source: current?.stage_source ?? 'carrier_map' } : {}),
+        last_status_text: newest?.description ?? heading,
+        last_update: newest?.time ?? null,
+        ...(typeof newest?.local_time === 'string' ? { last_update_local: newest.local_time } : {}),
+        expected_delivery: estimate ? estimate.time ?? estimate.day : null,
+        ...(delivered ? { delivered_at: delivered } : {}),
+        ...(newest ? {} : { summary_only: true }),
+        events: events.slice(0, MAX_EVENTS),
+        ...(events.length > MAX_EVENTS ? { history_truncated: true } : {}),
+    };
+}

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

@@ -0,0 +1,9 @@
+import { type ClassifiedWording, type Stage } from '../../core/status/index.js';
+import type { CarrierStatusMap } from '../../core/status/statusMap.js';
+/** The stage a scan's title gives. */
+export declare function hovershipLabelStage(label: string): Stage | undefined;
+/** The stage the page's headline gives the parcel. */
+export declare function hovershipHeadlineStage(headline: string): Stage | undefined;
+/** A scan's stage: its title, else the shared wording rules on the title, then on its line, else nothing. */
+export declare function hovershipStage(label: string, detail: string): ClassifiedWording | null;
+export declare const statusMap: CarrierStatusMap;

package/dist/carriers/hovership/status.js

@@ -0,0 +1,44 @@
+import { classifyWording } from '../../core/status/index.js';
+/**
+ * The titles the tracking page gives its scans, seen in histories. They name
+ * the shipment statuses of Hovership's API, such as `POSSESSION`; the API's
+ * exception and return statuses have not been seen on the page and fall to
+ * the shared wording rules.
+ */
+const LABELS = new Map([
+    ['label created', 'registered'], // The shipper made the label; Hovership has not scanned the parcel.
+    ['in possession', 'accepted'], // Scanned in at a Hovership sort facility.
+    ['in transit', 'in_transit'],
+    ['out for delivery', 'out_for_delivery'],
+    ['delivered', 'delivered'],
+]);
+/** The page's headline over the history, the parcel's current status. */
+const HEADLINES = new Map([
+    ['in our possession', 'accepted'],
+    ['delivered', 'delivered'],
+]);
+const key = (text) => text.replace(/\s+/g, ' ').trim().toLowerCase();
+/** The stage a scan's title gives. */
+export function hovershipLabelStage(label) {
+    return LABELS.get(key(label));
+}
+/** The stage the page's headline gives the parcel. */
+export function hovershipHeadlineStage(headline) {
+    return HEADLINES.get(key(headline));
+}
+/** A scan's stage: its title, else the shared wording rules on the title, then on its line, else nothing. */
+export function hovershipStage(label, detail) {
+    const mapped = hovershipLabelStage(label);
+    if (mapped)
+        return { stage: mapped, source: 'carrier_map' };
+    for (const text of [label, detail]) {
+        const worded = text ? classifyWording(text, 'in_transit') : null;
+        if (worded && worded.source !== 'none')
+            return worded;
+    }
+    return null;
+}
+export const statusMap = {
+    stage: (code) => (code ? hovershipLabelStage(code) : undefined),
+    gaps: [],
+};

package/dist/carriers/hovership/statuses.json

@@ -1,12 +1,14 @@
 {
   "carrier": "hovership",
   "entries": [
-    {"wording": "Label Created", "stage": "registered", "language": "en", "confirmedBy": "portal", "note": "An event title in an archived capture of Hovership's tracker."},
-    {"wording": "Shipment label created", "stage": "registered", "language": "en", "confirmedBy": "portal", "note": "The description under Label Created in an archived capture of Hovership's tracker."},
-    {"wording": "In Possession", "stage": "accepted", "language": "en", "confirmedBy": "portal", "note": "An event title in an archived capture of Hovership's tracker; Hovership has the parcel at a facility."},
-    {"wording": "In our possession", "stage": "accepted", "language": "en", "confirmedBy": "portal", "note": "The headline status of an archived capture of Hovership's tracker while the parcel was In Possession."},
-    {"wording": "In transit", "stage": "in_transit", "language": "en", "confirmedBy": "portal", "note": "A step of the progress bar in an archived capture of Hovership's tracker."},
-    {"wording": "Out for delivery", "stage": "out_for_delivery", "language": "en", "confirmedBy": "portal", "note": "A step of the progress bar in an archived capture of Hovership's tracker."},
-    {"wording": "Delivered", "stage": "delivered", "language": "en", "confirmedBy": "portal", "note": "A step of the progress bar in an archived capture of Hovership's tracker."}
+    {"code": "Label Created", "wording": "Shipment label created", "stage": "registered", "language": "en", "confirmedBy": "live", "note": "A scan's title and its line; the shipper made the label and Hovership has not scanned the parcel yet."},
+    {"code": "In Possession", "wording": "Arrived at Hayward Sort Facility", "stage": "accepted", "language": "en", "confirmedBy": "live", "note": "The scan that takes the parcel into Hovership's network at a sort facility, which its line names."},
+    {"code": "In Transit", "wording": "Arrived at Hayward Sort Facility", "stage": "in_transit", "language": "en", "confirmedBy": "live", "note": "A later scan at the sort facility that took the parcel in, before it went out for delivery."},
+    {"code": "Out for Delivery", "wording": "Shipment scanned out for delivery", "stage": "out_for_delivery", "language": "en", "confirmedBy": "live"},
+    {"code": "Delivered", "wording": "Delivered to Front Door", "stage": "delivered", "language": "en", "confirmedBy": "live", "note": "The line says where the parcel was left."},
+    {"wording": "In our possession", "stage": "accepted", "language": "en", "confirmedBy": "portal", "note": "The headline of an archived capture of Hovership's tracker while the newest scan was In Possession."},
+    {"wording": "Delivered", "stage": "delivered", "language": "en", "confirmedBy": "live", "note": "The headline over a delivered parcel's history, and the last step of the progress bar."},
+    {"wording": "In transit", "stage": "in_transit", "language": "en", "confirmedBy": "live", "note": "A step of the progress bar."},
+    {"wording": "Out for delivery", "stage": "out_for_delivery", "language": "en", "confirmedBy": "live", "note": "A step of the progress bar."}
   ]
 }

package/dist/core/catalog/statusMaps.js

@@ -206,6 +206,7 @@ import { statusMap as hepsijet } from '../../carriers/hepsijet/status.js';
 import { statusMap as hermesAt } from '../../carriers/hermes-at/status.js';
 import { statusMap as hispapost } from '../../carriers/hispapost/status.js';
 import { statusMap as houngAhLoun } from '../../carriers/houng-ah-loun/status.js';
+import { statusMap as hovership } from '../../carriers/hovership/status.js';
 import { statusMap as hrParcel } from '../../carriers/hr-parcel/status.js';
 import { statusMap as hrvatskaPosta } from '../../carriers/hrvatska-posta/status.js';
 import { statusMap as hunterExpress } from '../../carriers/hunter-express/status.js';
@@ -495,8 +496,9 @@ export const STATUS_MAPS = {
     'gebrueder-weiss': gebruederWeiss, geis, 'geniki-taxydromiki': geniki, 'geodis-pl': geodisPl, 'gls-es': glsEs, 'gls-it': glsIt,
     globalpost, 'go-express': goExpress, go4, gobolt, gofo, 'gofo-fr': gofoFr, 'gofo-it': gofoIt, 'gofo-nl': gofoNl, 'gogo-xpress': gogoXpress,
     'gs-postbox': gsPostbox, 'gsi-express': gsiExpress, 'gta-airskip': gtaAirskip, gzyl, hanjin, 'happy-post': happyPost, haypost,
-    'hct-logistics': hctLogistics, helthjem, hepsijet, 'hermes-at': hermesAt, hispapost, 'houng-ah-loun': houngAhLoun, 'hr-parcel': hrParcel,
-    'hrvatska-posta': hrvatskaPosta, 'hunter-express': hunterExpress, huahan, hywl, 'ics-courier': icsCourier, 'ids-logistik': idsLogistik,
+    'hct-logistics': hctLogistics, helthjem, hepsijet, 'hermes-at': hermesAt, hispapost, 'houng-ah-loun': houngAhLoun, hovership,
+    'hr-parcel': hrParcel, 'hrvatska-posta': hrvatskaPosta, huahan, 'hunter-express': hunterExpress, hywl, 'ics-courier': icsCourier,
+    'ids-logistik': idsLogistik,
     'ilyang-logis': ilyangLogis, imile, 'indah-logistik': indahLogistik,
     instabox, 'internet-express': internetExpress, interrapidisimo,
     'intex-paketdienst': intexPaketdienst, 'israel-post': israelPost, 'j-and-t': jAndT, 'j-and-t-cargo': jntCargo,

package/dist/data/catalog.json

@@ -16054,7 +16054,9 @@
         "timezone": "America/Los_Angeles",
         "tracking": {
             "mode": "automatic",
-            "adapter": "universal"
+            "adapter": "hovership",
+            "recognitionRank": 687,
+            "localClocks": true
         },
         "canaryUrl": "https://www.hovership.com/track/",
         "trackingUrlTemplate": "https://www.hovership.com/track/{trackingNumber}/",

package/dist/generated/catalog.d.ts

@@ -10389,7 +10389,9 @@ export declare const CARRIER_CATALOG: {
         readonly timezone: "America/Los_Angeles";
         readonly tracking: {
             readonly mode: "automatic";
-            readonly adapter: "universal";
+            readonly adapter: "hovership";
+            readonly recognitionRank: 687;
+            readonly localClocks: true;
         };
         readonly canaryUrl: "https://www.hovership.com/track/";
         readonly trackingUrlTemplate: "https://www.hovership.com/track/{trackingNumber}/";

package/dist/generated/catalog.js

@@ -16055,7 +16055,9 @@ export const CARRIER_CATALOG = {
         "timezone": "America/Los_Angeles",
         "tracking": {
             "mode": "automatic",
-            "adapter": "universal"
+            "adapter": "hovership",
+            "recognitionRank": 687,
+            "localClocks": true
         },
         "canaryUrl": "https://www.hovership.com/track/",
         "trackingUrlTemplate": "https://www.hovership.com/track/{trackingNumber}/",

package/dist/generated/recognition.js

@@ -187,6 +187,7 @@ export const CARRIER_RECOGNITION_RANKS = {
     "hermes-at": 876,
     "hermes-de": 840,
     "houng-ah-loun": 637,
+    "hovership": 687,
     "hr-parcel": 887,
     "hrvatska-posta": 160,
     "hywl": 993,

package/dist/generated/registry.js

@@ -239,6 +239,7 @@ import { adapter as hermesDe } from '../carriers/hermes-de/adapter.js';
 import { adapter as hispapost } from '../carriers/hispapost/adapter.js';
 import { adapter as hongkongPost } from '../carriers/hongkong-post/adapter.js';
 import { adapter as houngAhLoun } from '../carriers/houng-ah-loun/adapter.js';
+import { adapter as hovership } from '../carriers/hovership/adapter.js';
 import { adapter as hrParcel } from '../carriers/hr-parcel/adapter.js';
 import { adapter as hrvatskaPosta } from '../carriers/hrvatska-posta/adapter.js';
 import { adapter as huahan } from '../carriers/huahan/adapter.js';
@@ -780,6 +781,7 @@ export const REGISTRY = {
         "hispapost": hispapost,
         "hongkong-post": hongkongPost,
         "houng-ah-loun": houngAhLoun,
+        "hovership": hovership,
         "hr-parcel": hrParcel,
         "hrvatska-posta": hrvatskaPosta,
         "huahan": huahan,
@@ -1412,7 +1414,7 @@ export const REGISTRY = {
         "horoz": "universal",
         "hound-express": "universal",
         "houng-ah-loun": "houng-ah-loun",
-        "hovership": "universal",
+        "hovership": "hovership",
         "hp-mostar": "universal",
         "hr-parcel": "hr-parcel",
         "hrvatska-posta": "hrvatska-posta",

package/dist/server/openapi.json

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

package/package.json

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