universal-parcel-scraper 0.769.9-main.4113 → 0.770.1-main.4120

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 **631 dedicated adapters** and **5 universal fallbacks**
+**3,500+ carriers** through **632 dedicated adapters** and **5 universal fallbacks**
 
 <sub>807 catalog entries · 135 countries represented</sub>
 <!-- /GENERATED:summary -->
@@ -161,7 +161,7 @@ the command line's `track --source ParcelsApp` does the same.
 <!-- 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 16,928 such statuses, each filed under one stage.
+The carrier folders record 16,929 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

@@ -16959,7 +16959,8 @@
     "timezone": "Europe/Istanbul",
     "tracking": {
       "mode": "automatic",
-      "adapter": "universal"
+      "adapter": "horoz",
+      "localClocks": true
     },
     "canaryUrl": "https://app3.horoz.com.tr/wsKurumsal/_genel/frmGonderiTakip.aspx",
     "trackingUrlTemplate": "https://app3.horoz.com.tr/wsKurumsal/_genel/frmAtfDetay.aspx?Ptn={trackingNumber}",

package/data/coverage-summary.json

@@ -1,6 +1,6 @@
 {
   "catalog": 807,
-  "activeAdapters": 631,
+  "activeAdapters": 632,
   "countries": 135,
   "referenceCarriers": 100,
   "comparison": {

package/dist/browser/scraper.js

@@ -13098,7 +13098,8 @@ var Ze = {
 		timezone: "Europe/Istanbul",
 		tracking: {
 			mode: "automatic",
-			adapter: "universal"
+			adapter: "horoz",
+			localClocks: !0
 		},
 		canaryUrl: "https://app3.horoz.com.tr/wsKurumsal/_genel/frmGonderiTakip.aspx",
 		trackingUrlTemplate: "https://app3.horoz.com.tr/wsKurumsal/_genel/frmAtfDetay.aspx?Ptn={trackingNumber}",

package/dist/carriers/dpd-de/adapter.js

@@ -1,6 +1,7 @@
 import { carrierErrorKind, IndeterminateError, NotFoundError } from '../../core/errors/index.js';
 import { fillPartialAnswer } from '../../core/result/partial.js';
 import { NOOP_RECORDER } from '../../core/telemetry/index.js';
+import { dateLocalClocks } from '../../places/clocks.js';
 import { DPDTracker } from '../dpd/adapter.js';
 import { adapter as dpdAt } from '../dpd-at/adapter.js';
 import { DPDFranceTracker } from '../dpd-fr/adapter.js';
@@ -12,9 +13,10 @@ import { DpdDeAppClient } from './app.js';
 import { DpdOtherCountryError, sharedDpdAppService } from './service.js';
 /** Left to the guest API when the app's session is still opening ahead of it. */
 const GUEST_RESERVE_MS = 20_000;
+// A unit's wall clocks are dated as its own lookup dates them, not on Germany's clock.
 const adapterUnit = (factory) => (environment) => {
     const unit = factory({ ...environment, recorder: NOOP_RECORDER });
-    return (number, context) => unit.track({ number }, context);
+    return async (number, context) => dateLocalClocks(unit.id, await unit.track({ number }, context));
 };
 /**
  * DPD's other units with a source of their own that takes DPD parcel numbers, by the country code

package/dist/carriers/dpd-de/identity.js

@@ -16,6 +16,8 @@ function matches(incoming, stored) {
         && !incoming.providerCode !== !stored.providerCode
         && (location === saved || !location || !saved);
 }
+// A unit abroad's scans, which a release dates on that unit's clock rather than Germany's, keep their rows.
 export const sameInstantIdentityPolicy = {
     sourceCarrierId: 'dpd-de', storedSources: ['dpd-de'], requireProviderCode: false, matchEachScan: true, matches, matchWithinMinute: true,
+    matchWallClock: true,
 };

package/dist/carriers/dpd-pt/parser.js

@@ -5,7 +5,7 @@ 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 { DPD_PT_COLLECTION, DPD_PT_DELIVERY, DPD_PT_POINT_RECEIPT, DPD_PT_RETURN, dpdPtStage, isDpdPtNotice } from './status.js';
+import { DPD_PT_COLLECTION, DPD_PT_DELIVERY, DPD_PT_FORECAST, DPD_PT_POINT_RECEIPT, DPD_PT_RETURN, dpdPtStage, isDpdPtNotice } from './status.js';
 export const PROVIDER = 'DPD Portugal';
 // The page is under 50 kB with a long history.
 export const DPD_PT_MAX_BYTES = 1024 * 1024;
@@ -111,6 +111,9 @@ export function parseDpdPt(html, raw) {
             throw new SchemaError(PROVIDER, 'DPD Portugal returned an invalid scan code');
         if (!description)
             throw new SchemaError(PROVIDER, 'DPD Portugal returned a scan without wording');
+        // Its day and time are when DPD set the expected day: as a step it would show a day the parcel was not due.
+        if (code === DPD_PT_FORECAST)
+            continue;
         // The comment column mixes the receiver's name, delivery windows, depot
         // and pickup point codes and references; only a pickup point's name is read.
         const comment = code === DPD_PT_POINT_RECEIPT ? clean(cells.eq(4).text(), 120) : '';
@@ -121,6 +124,8 @@ export function parseDpdPt(html, raw) {
         seen.add(key);
         scans.push({ code, comment, event: { local_time, description, provider_code: code } });
     }
+    if (!scans.length)
+        throw new NoHistoryError(PROVIDER);
     // Oldest first: a collection and a delivery take their stage from the scans
     // before them, and a notice keeps the stage of the scan before it.
     let previous;

package/dist/carriers/dpd-pt/status.d.ts

@@ -8,6 +8,8 @@ export declare const DPD_PT_DELIVERY = "POD";
 export declare const DPD_PT_RETURN = "424";
 /** The pickup point's own scan; its comment names the point. */
 export declare const DPD_PT_POINT_RECEIPT = "002";
+/** The expected delivery day, dated when DPD set it rather than with the day: the history leaves it out. */
+export declare const DPD_PT_FORECAST = "714";
 /** The stage DPD Portugal's code gives a scan, if any, read without the scans before it. */
 export declare function dpdPtMappedStage(code: string): Stage | undefined;
 export declare function isDpdPtNotice(code: string): boolean;

package/dist/carriers/dpd-pt/status.js

@@ -40,12 +40,14 @@ export const DPD_PT_DELIVERY = 'POD';
 export const DPD_PT_RETURN = '424';
 /** The pickup point's own scan; its comment names the point. */
 export const DPD_PT_POINT_RECEIPT = '002';
+/** The expected delivery day, dated when DPD set it rather than with the day: the history leaves it out. */
+export const DPD_PT_FORECAST = '714';
 // Messages to the recipient and requests for a new delivery or address: no
 // movement, so the parcel keeps its stage.
 const NOTICES = new Map([
     ['706', 'A message giving the recipient a delivery window; it moves nothing.'],
     ['709', 'A message telling the recipient of the next delivery; it moves nothing.'],
-    ['714', 'The expected delivery day; it moves nothing.'],
+    ['714', 'The expected delivery day, which the history leaves out; it moves nothing.'],
     ['741', 'A request for a new delivery; the scans after it show what happened.'],
     ['743', 'A request to change the address; the scans after it show what happened.'],
 ]);

package/dist/carriers/dpd-pt/statuses.json

@@ -10,7 +10,7 @@
     {"code": "OFD", "wording": "EM DISTRIBUIÇÃO", "stage": "out_for_delivery", "language": "pt", "confirmedBy": "portal"},
     {"code": "706", "wording": "HORÁRIO DE ENTREGA ENVIADA AO DESTINATÁRIO", "language": "pt", "confirmedBy": "portal", "note": "A message giving the recipient a delivery window, which the comment column shows; it is not a scan."},
     {"code": "709", "wording": "MENSAGEM \"A PROXIMA ENTREGA\" ENVIADA", "language": "pt", "confirmedBy": "portal", "note": "A message telling the recipient of the next delivery; it is not a scan."},
-    {"code": "714", "wording": "DATA PREVISTA DE ENTREGA", "language": "pt", "confirmedBy": "live", "firstSeen": "2026-10-27", "note": "The expected delivery day, relayed by DPD Germany beside the depot's intake; it is not a scan."},
+    {"code": "714", "wording": "DATA PREVISTA DE ENTREGA", "language": "pt", "confirmedBy": "live", "firstSeen": "2026-10-27", "note": "The expected delivery day, dated when DPD set it, beside the depot's intake. It is not a scan, and the history leaves it out."},
     {"code": "500", "wording": "ENDEREÇO DO DESTINATÁRIO INCORRECTO OU DESCONHECIDO", "stage": "failed_attempt", "language": "pt", "confirmedBy": "portal", "note": "Not delivered because the address is wrong or unknown; the parcel went out again."},
     {"code": "501", "wording": "ENDEREÇO DO DESTINATÁRIO INCOMPLETO OU ILEGÍVEL", "stage": "failed_attempt", "language": "pt", "confirmedBy": "portal", "note": "Not delivered because the address is incomplete or unreadable."},
     {"code": "506", "wording": "AUSÊNCIA DO DESTINATÁRIO", "stage": "failed_attempt", "language": "pt", "confirmedBy": "portal", "note": "The recipient was not in."},

package/dist/carriers/horoz/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 delivery-note page, which looks up the number in its address. */
+export declare const HOROZ_PAGE = "https://app3.horoz.com.tr/wsKurumsal/_genel/frmAtfDetay.aspx";
+/** The delivery-note page's address for a number, as Horoz's links build it. */
+export declare function horozLookupUrl(number: string): string;
+export declare class HorozTracker {
+    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/horoz/adapter.js

@@ -0,0 +1,52 @@
+import { accepted, recognizeFromLookup } from '../../core/adapter/index.js';
+import { ChallengeError, 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, HOROZ_MAX_BYTES, normalizeHorozNumber, parseHoroz, PROVIDER } from './parser.js';
+/** The delivery-note page, which looks up the number in its address. */
+export const HOROZ_PAGE = 'https://app3.horoz.com.tr/wsKurumsal/_genel/frmAtfDetay.aspx';
+const REDIRECTS = [301, 302, 303, 307, 308];
+// The page answers an unknown number with empty fields: a missing route is not a missing shipment.
+const GONE = [404, 405, 410];
+/** The delivery-note page's address for a number, as Horoz's links build it. */
+export function horozLookupUrl(number) {
+    return `${HOROZ_PAGE}?${new URLSearchParams({ Ptn: number })}`;
+}
+export class HorozTracker {
+    options;
+    constructor(options = {}) {
+        this.options = options;
+    }
+    async fetch(raw, context = {}) {
+        const number = normalizeHorozNumber(raw);
+        const read = async (signal, timeoutMs) => {
+            const { response, bytes } = await fetchBounded(horozLookupUrl(number), { method: 'GET', signal, headers: {
+                    Accept: 'text/html', 'User-Agent': userAgentOf(this.options.userAgent),
+                } }, { provider: PROVIDER, timeoutMs: Math.max(1, Math.floor(timeoutMs)), maxBytes: HOROZ_MAX_BYTES, redirect: 'manual',
+                fetcher: this.options.fetcher, allowHttpStatuses: [...REDIRECTS, ...GONE, 403] });
+            const status = response.status;
+            if (status === 403)
+                throw new ChallengeError(PROVIDER, 'Horoz Lojistik refused the lookup', { status });
+            if (REDIRECTS.includes(status) || GONE.includes(status))
+                throw new TransportError(PROVIDER, 'Horoz Lojistik tracking page is unavailable', { status });
+            return parseHoroz(decodeText(bytes), number);
+        };
+        // A read 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 HorozTracker({ 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(() => normalizeHorozNumber(number))),
+    };
+};

package/dist/carriers/horoz/carrier.json

@@ -17,18 +17,64 @@
   "timezone": "Europe/Istanbul",
   "tracking": {
     "mode": "automatic",
-    "adapter": "universal",
-    "steps": []
+    "adapter": "horoz",
+    "steps": [
+      "direct",
+      "retry"
+    ],
+    "localClocks": true
   },
-  "capabilities": [],
+  "capabilities": [
+    "history"
+  ],
   "portal": {
     "url": "https://app3.horoz.com.tr/wsKurumsal/_genel/frmAtfDetay.aspx?Ptn={trackingNumber}",
     "searchUrl": "https://app3.horoz.com.tr/wsKurumsal/_genel/frmGonderiTakip.aspx",
     "canaryUrl": "https://app3.horoz.com.tr/wsKurumsal/_genel/frmGonderiTakip.aspx",
-    "shows": [],
-    "scraped": [],
-    "discarded": [],
-    "unavailable": []
+    "shows": [
+      "status",
+      "history",
+      "location",
+      "eta",
+      "delivered_at",
+      "service_name",
+      "waybill",
+      "sender_name",
+      "recipient_name",
+      "origin",
+      "destination",
+      "recipient_address",
+      "parcel_count",
+      "volume",
+      "order_contents",
+      "vehicle"
+    ],
+    "scraped": [
+      "status",
+      "history",
+      "location",
+      "eta"
+    ],
+    "discarded": [
+      "delivered_at",
+      "service_name",
+      "waybill",
+      "sender_name",
+      "recipient_name",
+      "origin",
+      "destination",
+      "recipient_address",
+      "parcel_count",
+      "volume",
+      "order_contents",
+      "vehicle"
+    ],
+    "unavailable": [
+      "provider_code",
+      "offset_timestamps",
+      "pickup_point",
+      "proof_of_delivery"
+    ]
   },
   "links": [
     {

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

@@ -0,0 +1,21 @@
+import type { CarrierResult } from '../../core/result/index.js';
+export declare const PROVIDER = "Horoz Lojistik";
+export declare const CARRIER = "horoz";
+export declare const HOROZ_MAX_BYTES: number;
+/** A number for Horoz Lojistik's tracker; anything else is not one it issues. */
+export declare function normalizeHorozNumber(raw: string): string;
+/** A firewall or bot-check page in place of the tracker's own. */
+export declare function isBlockPage(html: string): boolean;
+/**
+ * The delivery note (ATF) Horoz Lojistik's tracker shows at
+ * `frmAtfDetay.aspx?Ptn={number}`: a headline status, the note's details,
+ * the masked sender and recipient, and a table of movements, oldest first.
+ * Each movement is a departure from or an arrival at a centre, with its
+ * clock; a delivered parcel's last row is the delivery. A number the tracker
+ * does not know gets the same page with every field empty and no table.
+ *
+ * The page's form must name the whole number asked. The masked names, the
+ * provinces and addresses, the waybill, the vehicle plates, the destination
+ * centres and the record clocks are not read.
+ */
+export declare function parseHoroz(html: string, raw: string): CarrierResult;

package/dist/carriers/horoz/parser.js

@@ -0,0 +1,144 @@
+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 { horozStage } from './status.js';
+export const PROVIDER = 'Horoz Lojistik';
+export const CARRIER = 'horoz';
+// A delivery note with a long movement list is under thirty kilobytes.
+export const HOROZ_MAX_BYTES = 512 * 1024;
+const NUMBER = /^\d{14}$/;
+const HEADINGS = ['İşlem', 'Giriş/Çıkış Merkezi', 'Tarihi', 'Plaka', 'Varış Merkezi', 'İşlem Tarihi'];
+// "14.03.2026 16:27:05": the movement's clock, with seconds.
+const CLOCK = /^(\d{2})\.(\d{2})\.(\d{4}) (\d{2}):(\d{2}):(\d{2})$/;
+const DAY = /^(\d{2})\.(\d{2})\.(\d{4})$/;
+// The page posts back to itself, so its form names the number it was opened with.
+const FORM_ACTION = /^\.\/frmAtfDetay\.aspx\?Ptn=([^&#]*)$/;
+// Firewall and bot-check pages that could stand in for the tracker's own.
+const BLOCK = /<title>\s*(?:Just a moment|Attention Required|Access Denied|Request Rejected)|The requested URL was rejected|_cf_chl_opt|cf-turnstile|challenge-platform|captcha/i;
+const MAX_ROWS = 500;
+const FINAL = new Set(['delivered', 'returned']);
+/** A number for Horoz Lojistik's tracker; anything else is not one it issues. */
+export function normalizeHorozNumber(raw) {
+    const number = typeof raw === 'string' && raw.length <= 64 ? normalizeTrackingNumber(raw) : '';
+    if (!NUMBER.test(number))
+        throw new InvalidInputError(PROVIDER, 'Horoz Lojistik numbers are fourteen digits');
+    return number;
+}
+/** A firewall or bot-check page in place of the tracker's own. */
+export function isBlockPage(html) {
+    return BLOCK.test(html.slice(0, 64_000));
+}
+/** A movement's date and second as one wall time. The page gives no zone. */
+function wallClock(text) {
+    const match = CLOCK.exec(text);
+    // UTC only checks the calendar fields; no offset is assigned.
+    const parsed = match ? DateTime.fromObject({ year: Number(match[3]), month: Number(match[2]), day: Number(match[1]),
+        hour: Number(match[4]), minute: Number(match[5]), second: Number(match[6]) }, { zone: 'UTC' }) : null;
+    // Luxon rolls 24:00 over to the next day; only a clock that reads back unchanged is kept.
+    if (!match || !parsed?.isValid || parsed.year < 2000 || parsed.toFormat('dd.MM.yyyy HH:mm:ss') !== text) {
+        throw new SchemaError(PROVIDER, 'Horoz Lojistik returned an invalid movement time');
+    }
+    return parsed.toFormat("yyyy-MM-dd'T'HH:mm:ss");
+}
+/** The delivery date the note expects, as a calendar day, when it gives a real one. */
+function expectedDay(text) {
+    const match = DAY.exec(text);
+    const parsed = match ? DateTime.fromObject({ year: Number(match[3]), month: Number(match[2]), day: Number(match[1]) }, { zone: 'UTC' }) : null;
+    return parsed?.isValid && parsed.year >= 2000 && parsed.toFormat('dd.MM.yyyy') === text ? parsed.toISODate() : null;
+}
+/**
+ * The delivery note (ATF) Horoz Lojistik's tracker shows at
+ * `frmAtfDetay.aspx?Ptn={number}`: a headline status, the note's details,
+ * the masked sender and recipient, and a table of movements, oldest first.
+ * Each movement is a departure from or an arrival at a centre, with its
+ * clock; a delivered parcel's last row is the delivery. A number the tracker
+ * does not know gets the same page with every field empty and no table.
+ *
+ * The page's form must name the whole number asked. The masked names, the
+ * provinces and addresses, the waybill, the vehicle plates, the destination
+ * centres and the record clocks are not read.
+ */
+export function parseHoroz(html, raw) {
+    const number = normalizeHorozNumber(raw);
+    if (isBlockPage(html))
+        throw new ChallengeError(PROVIDER, 'Horoz Lojistik answered with a browser check');
+    const $ = load(html);
+    const forms = $('form#form1');
+    const action = forms.length === 1 ? FORM_ACTION.exec(forms.attr('action') ?? '') : null;
+    const note = $('span#lblatfno');
+    if (!action || note.length !== 1 || $('span#LblBaslik').length !== 1)
+        throw new SchemaError(PROVIDER, 'Horoz Lojistik returned an unexpected page');
+    let asked;
+    try {
+        asked = decodeURIComponent(action[1]);
+    }
+    catch {
+        throw new SchemaError(PROVIDER, 'Horoz Lojistik returned an unexpected page');
+    }
+    if (asked !== number)
+        throw new IndeterminateError(PROVIDER, 'Horoz Lojistik answered for another shipment');
+    const tables = $('table#grdAtfHareket');
+    if (!clean(note.text(), 40)) {
+        // Empty fields and no movements are the answer for an unknown number.
+        if (!tables.length)
+            throw new NotFoundError(PROVIDER);
+        throw new SchemaError(PROVIDER, 'Horoz Lojistik returned movements without a delivery note');
+    }
+    if (!tables.length)
+        throw new NoHistoryError(PROVIDER);
+    const rows = tables.length === 1 ? tables.find('tr') : null;
+    const headings = rows?.first().children('td').map((_, element) => clean($(element).text(), 40)).get() ?? [];
+    if (!rows || headings.join('|') !== HEADINGS.join('|'))
+        throw new SchemaError(PROVIDER, 'Horoz Lojistik history layout changed');
+    if (rows.length - 1 > MAX_ROWS)
+        throw new SchemaError(PROVIDER, 'Horoz Lojistik returned an oversized history');
+    const seen = new Set();
+    const movements = [];
+    rows.slice(1).each((index, element) => {
+        const cells = $(element).children('td');
+        if (cells.length !== HEADINGS.length)
+            throw new SchemaError(PROVIDER, 'Horoz Lojistik returned an invalid movement');
+        const description = clean(cells.eq(0).text(), 200);
+        if (!description)
+            throw new SchemaError(PROVIDER, 'Horoz Lojistik returned a movement without wording');
+        const centre = clean(cells.eq(1).text(), 200);
+        const local = wallClock(clean(cells.eq(2).text(), 60));
+        // A row the page lists twice is kept once.
+        const identity = JSON.stringify([local, description, centre]);
+        if (seen.has(identity))
+            return;
+        seen.add(identity);
+        const staged = horozStage(description);
+        movements.push({ local, index, event: {
+                local_time: local,
+                description,
+                ...(centre ? { location: centre } : {}),
+                ...(staged ? { stage: staged.stage, stage_source: staged.source } : {}),
+            } });
+    });
+    if (!movements.length)
+        throw new NoHistoryError(PROVIDER);
+    // Newest first; of equal clocks, the row further down the page is the newer.
+    movements.sort((left, right) => right.local.localeCompare(left.local) || right.index - left.index);
+    const events = movements.map(({ event }) => event);
+    const newest = events[0];
+    // The headline sums the note up; without a stage of its own, the newest staged movement stands.
+    const headline = clean($('span#LblBaslik').text(), 200);
+    const summary = headline ? horozStage(headline) : null;
+    const latest = events.find((event) => event.stage);
+    const current = summary ?? (latest ? { stage: latest.stage, source: latest.stage_source } : null);
+    const stage = current?.stage;
+    const expected = stage && FINAL.has(stage) ? null : expectedDay(clean($('span#lblolasiteslimtarihi').text(), 40));
+    return {
+        status: stage ? languageStageStatus(stage) : 'unknown',
+        ...(stage ? { current_stage: stage, current_stage_source: current.source } : {}),
+        last_status_text: headline || newest.description,
+        last_update: null,
+        last_update_local: newest.local_time,
+        expected_delivery: expected,
+        events,
+    };
+}

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

@@ -0,0 +1,8 @@
+import { type ClassifiedWording, type Stage } from '../../core/status/index.js';
+import { type CarrierStatusMap } from '../../core/status/statusMap.js';
+/** The stage Horoz Lojistik's map gives a wording in `normalizeStatusWording` form. */
+export declare function horozMappedStage(wording: string): Stage | undefined;
+/** A wording's stage: the map, else the shared wording rules, else nothing. */
+export declare function horozStage(wording: string): ClassifiedWording | null;
+/** Every wording seen is mapped. */
+export declare const statusMap: CarrierStatusMap;

package/dist/carriers/horoz/status.js

@@ -0,0 +1,39 @@
+import { classifyWording } from '../../core/status/index.js';
+import { normalizeStatusWording } from '../../core/status/statusMap.js';
+/**
+ * The wordings of Horoz Lojistik's delivery note, which carry no code: the
+ * movements of its table, its headline, and the states complaints quote from
+ * its tracking screen. Another wording falls to the shared wording rules.
+ */
+const WORDINGS = new Map([
+    // A departure from, or an arrival at, a centre: the sender's depot or one of Horoz's.
+    ['Çıkış', 'in_transit'],
+    ['Giriş', 'in_transit'],
+    ['dağıtım şubesinde', 'in_transit'],
+    ['dağıtımda', 'out_for_delivery'],
+    ['dağıtıma çıktı', 'out_for_delivery'],
+    // Not delivered: the recipient was not found, or the address was not enough.
+    ['adreste bulunamadı', 'failed_attempt'],
+    ['siparişiniz teslim edilememiştir', 'failed_attempt'],
+    ['adres yetersiz', 'failed_attempt'],
+    ['Teslim', 'delivered'],
+    ['teslim edildi', 'delivered'],
+    ['GÖNDERİNİZ TESLİM EDİLMİŞTİR', 'delivered'],
+].map(([wording, stage]) => [normalizeStatusWording(wording), stage]));
+/** The stage Horoz Lojistik's map gives a wording in `normalizeStatusWording` form. */
+export function horozMappedStage(wording) {
+    return WORDINGS.get(wording);
+}
+/** A wording's stage: the map, else the shared wording rules, else nothing. */
+export function horozStage(wording) {
+    const mapped = horozMappedStage(normalizeStatusWording(wording));
+    if (mapped)
+        return { stage: mapped, source: 'carrier_map' };
+    const worded = classifyWording(wording, 'in_transit');
+    return worded.source === 'none' ? null : worded;
+}
+/** Every wording seen is mapped. */
+export const statusMap = {
+    stage: (_code, wording) => horozMappedStage(wording),
+    gaps: [],
+};

package/dist/carriers/horoz/statuses.json

@@ -4,6 +4,7 @@
     {"wording": "Çıkış", "stage": "in_transit", "language": "tr", "confirmedBy": "portal", "note": "Departure from a centre, in the delivery note's movement list."},
     {"wording": "Giriş", "stage": "in_transit", "language": "tr", "confirmedBy": "portal", "note": "Arrival at a centre, in the delivery note's movement list."},
     {"wording": "Teslim", "stage": "delivered", "language": "tr", "confirmedBy": "portal", "note": "Last movement of a delivered parcel."},
+    {"wording": "GÖNDERİNİZ TESLİM EDİLMİŞTİR", "stage": "delivered", "language": "tr", "confirmedBy": "portal", "note": "The delivery note's headline once the parcel is delivered."},
     {"wording": "dağıtım şubesinde", "stage": "in_transit", "language": "tr", "confirmedBy": "source", "note": "Quoted in Şikayetvar complaints as the tracking state; at the delivery branch."},
     {"wording": "dağıtımda", "stage": "out_for_delivery", "language": "tr", "confirmedBy": "source", "note": "Quoted in Şikayetvar complaints as the tracking state."},
     {"wording": "dağıtıma çıktı", "stage": "out_for_delivery", "language": "tr", "confirmedBy": "source", "note": "Quoted in a Şikayetvar complaint as the tracking state."},

package/dist/carriers/ups/adapter.js

@@ -8,7 +8,7 @@ import { uspsPackageIdentifier } from '../../core/detection/usps.js';
 import { runSteps, singleFlight, takeTurn } from '../../core/runner/index.js';
 import { languageStageStatus } from '../../core/status/index.js';
 import { NOOP_RECORDER } from '../../core/telemetry/index.js';
-import { calendarDay } from '../../core/time/index.js';
+import { calendarDay, countryCode, countryTimeZone, firstOccurrence } from '../../core/time/index.js';
 import { clean, cleanScalar, decodeText, fetchBounded, parseJsonBytes, TRAWL_TRANSPORT_ALLOWANCE_MS } from '../../core/transport/index.js';
 import { isRecord } from '../../core/types.js';
 import { UPSApiClient, upsApiCredentials, upsApiNotFound, upsApiNotices } from './api.js';
@@ -314,6 +314,35 @@ function statedOffset(stated) {
     const offset = /^([+-])(0\d|1[0-4]):([0-5]\d)$/.exec(stated);
     return offset ? (offset[1] === '-' ? -1 : 1) * (Number(offset[2]) * 60 + Number(offset[3])) : null;
 }
+/**
+ * The zone of a scan's place, from its country's code or English name, when the country keeps one
+ * civil time. Spain and Portugal have none here: their islands keep a clock an hour from the
+ * mainland's, the offset the mainland keeps in the other season.
+ */
+function placeZone(country) {
+    const code = countryCode(country);
+    return code && code !== 'ES' && code !== 'PT' ? countryTimeZone(code) : null;
+}
+/**
+ * A scan UPS states on its place's offset for the other season, one the place's zone does not
+ * keep at that wall clock but keeps at another time of the year, dated on the place's clock.
+ * After the clocks went back, UPS dated deliveries in France on the summer offset: each reached
+ * its answer an hour after the instant that offset gives, and the wall clock was the place's.
+ * The scan keeps that wall clock, and the instant says its zone is the place's.
+ */
+function placeClock(wall, offset, zone) {
+    if (!zone)
+        return null;
+    const readings = DateTime.fromISO(wall, { zone }).getPossibleOffsets();
+    if (!readings.length || readings.some((reading) => reading.offset === offset))
+        return null;
+    const year = Number(wall.slice(0, 4));
+    const seasons = [1, 7].map((month) => DateTime.utc(year, month, 1).setZone(zone).offset);
+    if (seasons[0] === seasons[1] || !seasons.includes(offset))
+        return null;
+    const time = firstOccurrence(DateTime.fromISO(wall, { zone })).toISO({ suppressMilliseconds: true });
+    return time ? { time, local_time: wall, time_zone: zone, time_zone_basis: 'place' } : null;
+}
 /** The UTC pair, `gmtDate` (YYYYMMDD) and `gmtTime` (HH:MM:SS; the API's schema also shows HMMSS), as an ISO wall clock. */
 function utcPair(activity) {
     const date = /^(\d{4})(\d{2})(\d{2})$/.exec(cleanScalar(activity.gmtDate));
@@ -328,30 +357,37 @@ function utcPair(activity) {
  * the second, is written on that offset when the local pair reads the same
  * minute on it, so the scan keeps its place's clock; otherwise it stays in
  * UTC. A zero offset is written as UTC was, `+00:00`. Without the UTC pair,
- * the local pair and its offset become the time, and no zone is ever guessed.
- * A local pair without an offset stays a `local_time`, a scan UPS dates by
- * its day alone, as it does some drop-offs, keeps that day, other text stays
- * as UPS wrote it, and a scan with no clock at all, like some label scans,
- * gets none. The page's reply and the official API write the local pair
- * differently and the rest alike, so one scan gets one time from either.
+ * the local pair and its offset become the time. An offset the place cannot
+ * have at that time of year gives way to the place's zone (`placeClock`);
+ * otherwise no zone is guessed. A local pair without an offset stays a
+ * `local_time`, a scan UPS dates by its day alone, as it does some drop-offs,
+ * keeps that day, other text stays as UPS wrote it, and a scan with no clock
+ * at all, like some label scans, gets none. The page's reply and the official
+ * API write the local pair differently and the rest alike, so one scan gets
+ * one time from either.
  */
-function scanClock(activity, local, day, raw) {
+function scanClock(activity, local, day, raw, zone) {
     const stated = cleanScalar(activity.gmtOffset);
     const offset = statedOffset(stated);
     const utc = utcPair(activity);
     if (utc) {
-        const shown = offset ? DateTime.fromISO(utc, { zone: 'utc' }).setZone(FixedOffsetZone.instance(offset)) : null;
-        return { time: shown?.isValid && local && shown.toFormat("yyyy-MM-dd'T'HH:mm") === local.slice(0, 16)
-                ? shown.toISO({ suppressMilliseconds: true }) : `${utc}+00:00` };
+        const shown = offset === null ? null : DateTime.fromISO(utc, { zone: 'utc' }).setZone(FixedOffsetZone.instance(offset));
+        if (!shown?.isValid || !local || shown.toFormat("yyyy-MM-dd'T'HH:mm") !== local.slice(0, 16))
+            return { time: `${utc}+00:00` };
+        return placeClock(shown.toFormat("yyyy-MM-dd'T'HH:mm:ss"), offset, zone)
+            ?? { time: offset ? shown.toISO({ suppressMilliseconds: true }) : `${utc}+00:00` };
+    }
+    if (local) {
+        if (offset === null)
+            return /^[+-]\d{2}:\d{2}$/.test(stated) ? { time: `${local}${stated}` } : { local_time: local };
+        return placeClock(local, offset, zone) ?? { time: `${local}${stated}` };
     }
-    if (local)
-        return /^[+-]\d{2}:\d{2}$/.test(stated) ? { time: `${local}${stated}` } : { local_time: local };
     if (day)
         return { local_time: day };
     return raw ? { provider_time_text: raw } : {};
 }
-/** The clock of a scan in the page's reply, whose local pair reads `08/04/2026` and `9:12 A.M.`. */
-function activityClock(activity) {
+/** The clock of a scan in the page's reply, whose local pair reads `08/04/2026` and `9:12 A.M.`, at a place such as `ZUERICH, CH`. */
+function activityClock(activity, place) {
     const localDate = cleanScalar(activity.date);
     const localTime = cleanScalar(activity.time);
     const dateMatch = /^(\d{2})\/(\d{2})\/(\d{4})$/.exec(localDate);
@@ -361,7 +397,7 @@ function activityClock(activity) {
         ? `${dateMatch[3]}-${dateMatch[1]}-${dateMatch[2]}T${String(hour % 12 + (timeMatch[3].toUpperCase() === 'P' ? 12 : 0)).padStart(2, '0')}:${timeMatch[2]}:00`
         : null;
     const day = dateMatch && !localTime ? calendarDay(Number(dateMatch[3]), Number(dateMatch[1]), Number(dateMatch[2])) : null;
-    return scanClock(activity, local, day, clean(`${localDate} ${localTime}`));
+    return scanClock(activity, local, day, clean(`${localDate} ${localTime}`), placeZone(place.split(',').at(-1).trim()));
 }
 /** The clock of a scan in the official API's reply, whose local pair reads `20260804` and `091204`. */
 function apiActivityClock(activity) {
@@ -371,7 +407,8 @@ function apiActivityClock(activity) {
     const timeMatch = /^([01]\d|2[0-3])([0-5]\d)([0-5]\d)$/.exec(localTime);
     const day = dateMatch ? calendarDay(Number(dateMatch[1]), Number(dateMatch[2]), Number(dateMatch[3])) : null;
     const local = day && timeMatch ? `${day}T${timeMatch[1]}:${timeMatch[2]}:${timeMatch[3]}` : null;
-    return scanClock(activity, local, localTime ? null : day, clean(`${localDate} ${localTime}`));
+    const address = isRecord(activity.location) && isRecord(activity.location.address) ? activity.location.address : {};
+    return scanClock(activity, local, localTime ? null : day, clean(`${localDate} ${localTime}`), placeZone(cleanScalar(address.countryCode || address.country, 8)));
 }
 const MONTHS = {
     jan: 1, feb: 2, mar: 3, apr: 4, may: 5, jun: 6,
@@ -455,7 +492,7 @@ export function parseUPSTrackingResponse(payload, trackingNumber, today = new Da
             const code = cleanScalar(raw.actCode, 8).toUpperCase();
             const stage = code ? upsActivityStage(code) : upsUncodedScanStage(description);
             events.push({
-                ...activityClock(raw),
+                ...activityClock(raw, text(raw.location)),
                 location: pagePlace(text(raw.location)),
                 description,
                 ...(/^[A-Z0-9]{1,4}$/.test(code) ? { provider_code: code } : {}),

package/dist/carriers/ups/app.js

@@ -19,9 +19,11 @@ function sameTown(incoming, stored) {
 }
 // UPS can add a location later. Its wording distinguishes scans sharing a clock,
 // unless both carry an activity code: the official API words a scan without the
-// page's second sentence and writes its town in capitals.
+// page's second sentence and writes its town in capitals. A scan UPS stated on the
+// offset its place keeps in the other season, which a release dates on the place's
+// clock, keeps its row.
 export const sameInstantIdentityPolicy = {
-    sourceCarrierId: 'ups', storedSources: ['ups'], requireProviderCode: false,
+    sourceCarrierId: 'ups', storedSources: ['ups'], requireProviderCode: false, matchWallClock: true,
     matches(incoming, stored) {
         if (incoming.stage === '' || incoming.stage === 'unknown' || !sameActivity(incoming, stored))
             return false;

package/dist/core/catalog/statusMaps.js

@@ -285,6 +285,7 @@ import { statusMap as hermesDe } from '../../carriers/hermes-de/status.js';
 import { statusMap as hispapost } from '../../carriers/hispapost/status.js';
 import { statusMap as homexpress } from '../../carriers/homexpress/status.js';
 import { statusMap as hongkongPost } from '../../carriers/hongkong-post/status.js';
+import { statusMap as horoz } from '../../carriers/horoz/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';
@@ -680,7 +681,7 @@ export const STATUS_MAPS = {
     globalpost, 'gms-worldwide': gmsWorldwide, 'go-express': goExpress, go4, gobolt, gofo, 'gofo-ca': gofoCa, 'gofo-fr': gofoFr, 'gofo-it': gofoIt, 'gofo-nl': gofoNl, 'gogo-xpress': gogoXpress,
     'grand-slam-express': grandSlamExpress, 'gs-postbox': gsPostbox, 'gsi-express': gsiExpress, 'gta-airskip': gtaAirskip, 'gtl-goto': gtlGoto, guatex, gzyl,
     hanjin, 'happy-post': happyPost, haypost, 'hct-logistics': hctLogistics, helthjem, heppner, hepsijet, hermes, 'hermes-at': hermesAt, 'hermes-de': hermesDe, hispapost, homexpress, 'hongkong-post': hongkongPost,
-    'houng-ah-loun': houngAhLoun, hovership, 'hr-parcel': hrParcel, 'hrvatska-posta': hrvatskaPosta, huahan, 'hunter-express': hunterExpress, hywl,
+    horoz, 'houng-ah-loun': houngAhLoun, hovership, 'hr-parcel': hrParcel, 'hrvatska-posta': hrvatskaPosta, huahan, 'hunter-express': hunterExpress, hywl,
     'icc-worldwide': iccWorldwide, 'ics-courier': icsCourier, 'ids-logistik': idsLogistik, 'ilyang-logis': ilyangLogis, imile,
     'indah-logistik': indahLogistik, 'india-post': indiaPost, inpost, instabox, 'integral-pack': integralPack, 'intel-valley': intelValley, intelcom, 'internet-express': internetExpress, interrapidisimo,
     'intex-paketdienst': intexPaketdienst, 'israel-post': israelPost, 'j-and-t': jAndT, 'j-and-t-au': jAndTAu, 'j-and-t-de': jAndTDe, 'j-and-t-cargo': jntCargo,

package/dist/data/catalog.json

@@ -16959,7 +16959,8 @@
         "timezone": "Europe/Istanbul",
         "tracking": {
             "mode": "automatic",
-            "adapter": "universal"
+            "adapter": "horoz",
+            "localClocks": true
         },
         "canaryUrl": "https://app3.horoz.com.tr/wsKurumsal/_genel/frmGonderiTakip.aspx",
         "trackingUrlTemplate": "https://app3.horoz.com.tr/wsKurumsal/_genel/frmAtfDetay.aspx?Ptn={trackingNumber}",

package/dist/generated/catalog.d.ts

@@ -10990,7 +10990,8 @@ export declare const CARRIER_CATALOG: {
         readonly timezone: "Europe/Istanbul";
         readonly tracking: {
             readonly mode: "automatic";
-            readonly adapter: "universal";
+            readonly adapter: "horoz";
+            readonly localClocks: true;
         };
         readonly canaryUrl: "https://app3.horoz.com.tr/wsKurumsal/_genel/frmGonderiTakip.aspx";
         readonly trackingUrlTemplate: "https://app3.horoz.com.tr/wsKurumsal/_genel/frmAtfDetay.aspx?Ptn={trackingNumber}";

package/dist/generated/catalog.js

@@ -16960,7 +16960,8 @@ export const CARRIER_CATALOG = {
         "timezone": "Europe/Istanbul",
         "tracking": {
             "mode": "automatic",
-            "adapter": "universal"
+            "adapter": "horoz",
+            "localClocks": true
         },
         "canaryUrl": "https://app3.horoz.com.tr/wsKurumsal/_genel/frmGonderiTakip.aspx",
         "trackingUrlTemplate": "https://app3.horoz.com.tr/wsKurumsal/_genel/frmAtfDetay.aspx?Ptn={trackingNumber}",

package/dist/generated/registry.js

@@ -274,6 +274,7 @@ import { adapter as hermesDe } from '../carriers/hermes-de/adapter.js';
 import { adapter as hispapost } from '../carriers/hispapost/adapter.js';
 import { adapter as homexpress } from '../carriers/homexpress/adapter.js';
 import { adapter as hongkongPost } from '../carriers/hongkong-post/adapter.js';
+import { adapter as horoz } from '../carriers/horoz/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';
@@ -907,6 +908,7 @@ export const REGISTRY = {
         "hispapost": hispapost,
         "homexpress": homexpress,
         "hongkong-post": hongkongPost,
+        "horoz": horoz,
         "houng-ah-loun": houngAhLoun,
         "hovership": hovership,
         "hr-parcel": hrParcel,
@@ -1603,7 +1605,7 @@ export const REGISTRY = {
         "hispapost": "hispapost",
         "homexpress": "homexpress",
         "hongkong-post": "hongkong-post",
-        "horoz": "universal",
+        "horoz": "horoz",
         "hound-express": "universal",
         "houng-ah-loun": "houng-ah-loun",
         "hovership": "hovership",

package/dist/server/openapi.json

@@ -2,7 +2,7 @@
   "openapi": "3.1.0",
   "info": {
     "title": "Universal Parcel Scraper",
-    "version": "0.769.9-main.4113"
+    "version": "0.770.1-main.4120"
   },
   "paths": {
     "/health": {

package/package.json

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