universal-parcel-scraper 0.78.0-main.939 → 0.79.0-main.941

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 **135 dedicated adapters** and **5 universal fallbacks**
+**3,500+ carriers** through **136 dedicated adapters** and **5 universal fallbacks**
 
 <sub>207 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 3,852 such statuses, each filed under one stage.
+The carrier folders record 3,871 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

@@ -8285,7 +8285,9 @@
     "timezone": "Europe/Istanbul",
     "tracking": {
       "mode": "automatic",
-      "adapter": "universal"
+      "adapter": "yurtici-kargo",
+      "recognitionRank": 66,
+      "localClocks": true
     },
     "canaryUrl": "https://www.yurticikargo.com/tr/online-servisler/gonderi-sorgula",
     "trackingUrlTemplate": "https://www.yurticikargo.com/tr/online-servisler/gonderi-sorgula?code={trackingNumber}",

package/data/coverage-summary.json

@@ -1,6 +1,6 @@
 {
   "catalog": 207,
-  "activeAdapters": 135,
+  "activeAdapters": 136,
   "countries": 66,
   "referenceCarriers": 100,
   "comparison": {

package/dist/browser/scraper.js

@@ -6522,7 +6522,9 @@ var ye = {
 		timezone: "Europe/Istanbul",
 		tracking: {
 			mode: "automatic",
-			adapter: "universal"
+			adapter: "yurtici-kargo",
+			recognitionRank: 66,
+			localClocks: !0
 		},
 		canaryUrl: "https://www.yurticikargo.com/tr/online-servisler/gonderi-sorgula",
 		trackingUrlTemplate: "https://www.yurticikargo.com/tr/online-servisler/gonderi-sorgula?code={trackingNumber}",
@@ -11772,7 +11774,8 @@ var _c = {
 	tnt: 44,
 	ukrposhta: 5,
 	uniuni: 33,
-	venipak: 63
+	venipak: 63,
+	"yurtici-kargo": 66
 }, vc = 5;
 function yc(e) {
 	let t = y(e);

package/dist/carriers/yurtici-kargo/adapter.d.ts

@@ -0,0 +1,18 @@
+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 YURTICI_SEARCH_URL = "https://www.yurticikargo.com/service/shipmentstrackingsearch";
+export declare const YURTICI_DETAIL_URL = "https://www.yurticikargo.com/service/shipmentstracking";
+export declare const YURTICI_MOVEMENT_URL = "https://www.yurticikargo.com/service/shipmenttrackingmovement";
+export declare class YurticiKargoTracker {
+    private readonly options;
+    constructor(options?: {
+        fetcher?: typeof fetch;
+        recorder?: StepRecorder;
+        userAgent?: string;
+    });
+    fetch(raw: string, context?: TrackingContext): Promise<CarrierResult>;
+    private lookup;
+    private get;
+}
+export declare const adapter: AdapterFactory;

package/dist/carriers/yurtici-kargo/adapter.js

@@ -0,0 +1,72 @@
+import { accepted, recognizeFromLookup } from '../../core/adapter/index.js';
+import { ChallengeError, SchemaError, TransportError, UpstreamHttpError } from '../../core/errors/index.js';
+import { runSteps } from '../../core/runner/index.js';
+import { NOOP_RECORDER } from '../../core/telemetry/index.js';
+import { decodeText, fetchBounded, parseJsonBytes, userAgentOf } from '../../core/transport/index.js';
+import { isRecord } from '../../core/types.js';
+import { normalizeYurticiNumber, parseYurtici, parseYurticiSearch, PROVIDER, YURTICI_MAX_BYTES } from './parser.js';
+// The tracker on www.yurticikargo.com/en/online-servisler/gonderi-sorgula reads these
+// anonymously: a search for the code, then the shipment's details, then its movements.
+const SERVICE = 'https://www.yurticikargo.com/service';
+export const YURTICI_SEARCH_URL = `${SERVICE}/shipmentstrackingsearch`;
+export const YURTICI_DETAIL_URL = `${SERVICE}/shipmentstracking`;
+export const YURTICI_MOVEMENT_URL = `${SERVICE}/shipmenttrackingmovement`;
+/** The firewall in front of www.yurticikargo.com rejects a request with an HTML page. */
+function rejected(bytes) {
+    return /Request Rejected|The requested URL was rejected/i.test(decodeText(bytes.subarray(0, 4_000)));
+}
+export class YurticiKargoTracker {
+    options;
+    constructor(options = {}) {
+        this.options = options;
+    }
+    async fetch(raw, context = {}) {
+        const number = normalizeYurticiNumber(raw);
+        const budgetMs = context.budgetMs ?? 15_000;
+        if (!Number.isFinite(budgetMs) || budgetMs <= 0)
+            throw new TypeError('Yurtiçi Kargo budget must be a positive number of milliseconds');
+        return runSteps({ carrier: 'yurtici-kargo', budgetMs, signal: context.signal, recorder: this.options.recorder ?? NOOP_RECORDER }, [
+            { id: 'direct', run: step => this.lookup(number, step) },
+        ]);
+    }
+    async lookup(number, { signal, remainingMs }) {
+        const deadline = performance.now() + remainingMs;
+        const get = (url, id) => this.get(url, id, signal, Math.max(1, Math.floor(deadline - performance.now())));
+        const search = parseYurticiSearch(await get(YURTICI_SEARCH_URL, number), number);
+        const detail = await get(YURTICI_DETAIL_URL, search.id);
+        // The tracker lists movements until the parcel is delivered or returned, and only asks then.
+        const movements = isOpen(detail) ? await get(YURTICI_MOVEMENT_URL, number) : undefined;
+        return parseYurtici(detail, movements, number, search);
+    }
+    async get(url, id, signal, timeoutMs) {
+        signal.throwIfAborted();
+        let bytes;
+        try {
+            ({ bytes } = await fetchBounded(`${url}?${new URLSearchParams({ id, language: 'en' })}`, { signal, headers: { Accept: 'application/json', 'User-Agent': userAgentOf(this.options.userAgent) } }, { provider: PROVIDER, timeoutMs, maxBytes: YURTICI_MAX_BYTES, fetcher: this.options.fetcher, retryTransient: true }));
+        }
+        catch (error) {
+            // A missing route is not a missing shipment.
+            if (error instanceof UpstreamHttpError && [404, 410].includes(error.status)) {
+                throw new TransportError(PROVIDER, 'Yurtiçi Kargo tracking service is unavailable', { cause: error });
+            }
+            throw error;
+        }
+        try {
+            return parseJsonBytes(bytes, PROVIDER);
+        }
+        catch (cause) {
+            if (rejected(bytes))
+                throw new ChallengeError(PROVIDER, 'Yurtiçi Kargo rejected the tracking request', { cause });
+            throw new SchemaError(PROVIDER, 'Yurtiçi Kargo returned invalid tracking JSON', { cause });
+        }
+    }
+}
+/** Details of a parcel not yet delivered or returned, whose movements the tracker lists. */
+function isOpen(detail) {
+    return isRecord(detail) && detail.IsDelivered === false && detail.ErrorMessage === undefined;
+}
+export const adapter = environment => {
+    const tracker = new YurticiKargoTracker({ fetcher: environment.fetcher, recorder: environment.recorder, userAgent: environment.userAgent });
+    return { id: 'yurtici-kargo', recordsSteps: true, steps: ['direct'], track: (input, context) => tracker.fetch(input.number, context),
+        recognize: (number, context) => recognizeFromLookup(() => tracker.fetch(number, context), () => accepted(() => normalizeYurticiNumber(number))) };
+};

package/dist/carriers/yurtici-kargo/carrier.json

@@ -17,18 +17,58 @@
   "timezone": "Europe/Istanbul",
   "tracking": {
     "mode": "automatic",
-    "adapter": "universal",
-    "steps": []
+    "adapter": "yurtici-kargo",
+    "steps": [
+      "direct"
+    ],
+    "recognition": {
+      "rank": 66
+    },
+    "localClocks": true
   },
-  "capabilities": [],
+  "capabilities": [
+    "history",
+    "location",
+    "eta",
+    "service_name",
+    "pickup_point"
+  ],
   "portal": {
     "url": "https://www.yurticikargo.com/tr/online-servisler/gonderi-sorgula?code={trackingNumber}",
     "searchUrl": "https://www.yurticikargo.com/tr/online-servisler/gonderi-sorgula",
     "canaryUrl": "https://www.yurticikargo.com/tr/online-servisler/gonderi-sorgula",
-    "shows": [],
-    "scraped": [],
-    "discarded": [],
-    "unavailable": []
+    "shows": [
+      "status",
+      "history",
+      "location",
+      "eta",
+      "service_name",
+      "pickup_point",
+      "recipient_name",
+      "sender_name",
+      "signatory",
+      "contact_details",
+      "payment_details"
+    ],
+    "scraped": [
+      "status",
+      "history",
+      "location",
+      "eta",
+      "service_name",
+      "pickup_point"
+    ],
+    "discarded": [
+      "recipient_name",
+      "sender_name",
+      "signatory",
+      "contact_details",
+      "payment_details"
+    ],
+    "unavailable": [
+      "weight",
+      "proof_of_delivery"
+    ]
   },
   "links": [
     {

package/dist/carriers/yurtici-kargo/numbers.json

@@ -12,7 +12,7 @@
         "access": "full_page"
       },
       "context": {
-        "assessment": "candidate"
+        "assessment": "confirmed"
       },
       "expect": {
         "carrier": "unknown",
@@ -30,7 +30,7 @@
           "lbc-express"
         ]
       },
-      "note": "A complaint on Şikayetvar's Yurtiçi Kargo page calls it the parcel's tracking number."
+      "note": "A complaint on Şikayetvar's Yurtiçi Kargo page calls it the parcel's tracking number; Yurtiçi Kargo's tracking knows the shipment."
     },
     {
       "number": "108886350393",
@@ -43,7 +43,7 @@
         "access": "full_page"
       },
       "context": {
-        "assessment": "candidate"
+        "assessment": "confirmed"
       },
       "expect": {
         "carrier": "unknown",
@@ -61,7 +61,7 @@
           "lbc-express"
         ]
       },
-      "note": "A complaint on Şikayetvar's Yurtiçi Kargo page calls it the parcel's tracking number."
+      "note": "A complaint on Şikayetvar's Yurtiçi Kargo page calls it the parcel's tracking number; Yurtiçi Kargo's tracking knows the shipment."
     },
     {
       "number": "114011114595",
@@ -74,7 +74,7 @@
         "access": "full_page"
       },
       "context": {
-        "assessment": "candidate"
+        "assessment": "confirmed"
       },
       "expect": {
         "carrier": "unknown",
@@ -92,7 +92,7 @@
           "lbc-express"
         ]
       },
-      "note": "A complaint on Şikayetvar's Yurtiçi Kargo page calls it the parcel's tracking number."
+      "note": "A complaint on Şikayetvar's Yurtiçi Kargo page calls it the parcel's tracking number; Yurtiçi Kargo's tracking knows the shipment."
     },
     {
       "number": "412078984222",
@@ -105,7 +105,7 @@
         "access": "full_page"
       },
       "context": {
-        "assessment": "candidate"
+        "assessment": "confirmed"
       },
       "expect": {
         "carrier": "unknown",
@@ -122,7 +122,7 @@
           "lbc-express"
         ]
       },
-      "note": "A complaint on Şikayetvar's Yurtiçi Kargo page calls it the parcel's tracking number."
+      "note": "A complaint on Şikayetvar's Yurtiçi Kargo page calls it the parcel's tracking number; Yurtiçi Kargo's tracking knows the shipment."
     },
     {
       "number": "191329680164",
@@ -135,7 +135,7 @@
         "access": "full_page"
       },
       "context": {
-        "assessment": "candidate"
+        "assessment": "confirmed"
       },
       "expect": {
         "carrier": "unknown",
@@ -153,7 +153,7 @@
           "lbc-express"
         ]
       },
-      "note": "A complaint on Şikayetvar's Yurtiçi Kargo page calls it the parcel's tracking number."
+      "note": "A complaint on Şikayetvar's Yurtiçi Kargo page calls it the parcel's tracking number; Yurtiçi Kargo's tracking knows the shipment."
     },
     {
       "number": "118977181376",
@@ -166,7 +166,7 @@
         "access": "full_page"
       },
       "context": {
-        "assessment": "candidate"
+        "assessment": "confirmed"
       },
       "expect": {
         "carrier": "unknown",
@@ -187,7 +187,7 @@
           "lbc-express"
         ]
       },
-      "note": "A complaint on Şikayetvar's Yurtiçi Kargo page calls it the parcel's tracking number."
+      "note": "A complaint on Şikayetvar's Yurtiçi Kargo page calls it the parcel's tracking number; Yurtiçi Kargo's tracking knows the shipment."
     },
     {
       "number": "173962210543",
@@ -200,7 +200,7 @@
         "access": "full_page"
       },
       "context": {
-        "assessment": "candidate"
+        "assessment": "confirmed"
       },
       "expect": {
         "carrier": "unknown",
@@ -219,7 +219,7 @@
           "lbc-express"
         ]
       },
-      "note": "A complaint on Şikayetvar's Yurtiçi Kargo page calls it the parcel's tracking number."
+      "note": "A complaint on Şikayetvar's Yurtiçi Kargo page calls it the parcel's tracking number; Yurtiçi Kargo's tracking knows the shipment."
     },
     {
       "number": "174361470154",
@@ -232,7 +232,7 @@
         "access": "full_page"
       },
       "context": {
-        "assessment": "candidate"
+        "assessment": "confirmed"
       },
       "expect": {
         "carrier": "unknown",
@@ -250,7 +250,7 @@
           "lbc-express"
         ]
       },
-      "note": "A complaint on Şikayetvar's Yurtiçi Kargo page calls it the parcel's tracking number."
+      "note": "A complaint on Şikayetvar's Yurtiçi Kargo page calls it the parcel's tracking number; Yurtiçi Kargo's tracking knows the shipment."
     },
     {
       "number": "308377408751",
@@ -263,7 +263,7 @@
         "access": "full_page"
       },
       "context": {
-        "assessment": "candidate"
+        "assessment": "confirmed"
       },
       "expect": {
         "carrier": "unknown",
@@ -280,7 +280,7 @@
           "lbc-express"
         ]
       },
-      "note": "A complaint on Şikayetvar's Yurtiçi Kargo page calls it the parcel's tracking number."
+      "note": "A complaint on Şikayetvar's Yurtiçi Kargo page calls it the parcel's tracking number; Yurtiçi Kargo's tracking knows the shipment."
     },
     {
       "number": "104985633362",
@@ -293,7 +293,7 @@
         "access": "full_page"
       },
       "context": {
-        "assessment": "candidate"
+        "assessment": "confirmed"
       },
       "expect": {
         "carrier": "unknown",
@@ -314,7 +314,7 @@
           "sagawa"
         ]
       },
-      "note": "A complaint on Şikayetvar's Yurtiçi Kargo page calls it the parcel's tracking number."
+      "note": "A complaint on Şikayetvar's Yurtiçi Kargo page calls it the parcel's tracking number; Yurtiçi Kargo's tracking knows the shipment."
     }
   ]
 }

package/dist/carriers/yurtici-kargo/parser.d.ts

@@ -0,0 +1,26 @@
+import type { CarrierResult } from '../../core/result/index.js';
+export declare const PROVIDER = "Yurti\u00E7i Kargo";
+export declare const YURTICI_MAX_BYTES = 256000;
+/**
+ * What the tracker's field takes: a twelve-digit shipment code or a
+ * sixteen-digit international AWB code, digits only.
+ */
+export declare function normalizeYurticiNumber(raw: string): string;
+export interface YurticiSearch {
+    /** The id the tracker asks for the shipment's details. */
+    readonly id: string;
+}
+/**
+ * The search the tracker runs first: the shipment's id, or the tracker's
+ * notice for a code it does not know. A domestic shipment's id is its code.
+ * An international shipment is read from its AWB record, which the adapter
+ * does not read.
+ */
+export declare function parseYurticiSearch(payload: unknown, raw: string): YurticiSearch;
+/**
+ * The shipment's details, with its movements when the tracker lists them.
+ * The tracker stops listing movements once a parcel is delivered or returned;
+ * the details then give the shipment date and the final status, and the
+ * answer is a summary.
+ */
+export declare function parseYurtici(detail: unknown, movements: unknown, raw: string, search: YurticiSearch): CarrierResult;

package/dist/carriers/yurtici-kargo/parser.js

@@ -0,0 +1,250 @@
+import { normalizeTrackingNumber } from '../../core/detection/index.js';
+import { IndeterminateError, InvalidInputError, NotFoundError, SchemaError } from '../../core/errors/index.js';
+import { languageStageStatus } from '../../core/status/index.js';
+import { calendarDay } from '../../core/time/index.js';
+import { clean, cleanScalar } from '../../core/transport/index.js';
+import { isRecord } from '../../core/types.js';
+import { yurticiScanStage, yurticiSummaryStage } from './status.js';
+export const PROVIDER = 'Yurtiçi Kargo';
+export const YURTICI_MAX_BYTES = 256_000;
+const MAX_ROWS = 300;
+const MAX_EVENTS = 100;
+/**
+ * What the tracker's field takes: a twelve-digit shipment code or a
+ * sixteen-digit international AWB code, digits only.
+ */
+export function normalizeYurticiNumber(raw) {
+    const number = normalizeTrackingNumber(raw);
+    if (!/^(?:\d{12}|\d{16})$/.test(number)) {
+        throw new InvalidInputError(PROVIDER, 'Yurtiçi Kargo shipment codes are twelve digits and AWB codes sixteen');
+    }
+    return number;
+}
+/** The tracker's notice for a code it does not know, in English and in Turkish. */
+const NOT_FOUND = new Set([
+    'No record found. Please try with a different tracking code.',
+    'Sorguladığınız gönderi koduyla bir kargo bulunamadı.Lütfen gönderi kodunu kontrol ederek tekrar deneyiniz.',
+]);
+/** The carrier's notice, or undefined when the reply carries none. */
+function notice(payload) {
+    if (payload.ErrorMessage === undefined)
+        return undefined;
+    return clean(payload.ErrorMessage, 300);
+}
+/** The shipment id the search answers with, as a string of digits. */
+function shipmentId(value) {
+    const text = typeof value === 'number' ? (Number.isSafeInteger(value) && value > 0 ? String(value) : '') : cleanScalar(value, 20);
+    return /^\d{1,16}$/.test(text) ? text : '';
+}
+/** A shipment id as the twelve-digit code it is printed as. */
+const printed = (id) => id.padStart(12, '0');
+/**
+ * The search the tracker runs first: the shipment's id, or the tracker's
+ * notice for a code it does not know. A domestic shipment's id is its code.
+ * An international shipment is read from its AWB record, which the adapter
+ * does not read.
+ */
+export function parseYurticiSearch(payload, raw) {
+    const number = normalizeYurticiNumber(raw);
+    if (!isRecord(payload))
+        throw new SchemaError(PROVIDER);
+    const message = notice(payload);
+    if (message !== undefined) {
+        if (NOT_FOUND.has(message))
+            throw new NotFoundError(PROVIDER);
+        throw new IndeterminateError(PROVIDER, 'Yurtiçi Kargo could not complete the search');
+    }
+    if (payload.IsAbroad === true) {
+        throw new IndeterminateError(PROVIDER, 'Yurtiçi Kargo tracks this shipment through its international record', { reason: 'international_shipment' });
+    }
+    const id = shipmentId(payload.DocId);
+    if (!id || payload.IsAbroad !== false)
+        throw new SchemaError(PROVIDER, 'Yurtiçi Kargo returned a search result without a shipment');
+    if (number.length === 12 && printed(id) !== number)
+        throw new SchemaError(PROVIDER, 'Yurtiçi Kargo did not identify the requested shipment');
+    return { id };
+}
+const MONTHS = new Map([
+    ...['january', 'february', 'march', 'april', 'may', 'june', 'july', 'august', 'september', 'october', 'november', 'december'],
+    ...['ocak', 'şubat', 'mart', 'nisan', 'mayıs', 'haziran', 'temmuz', 'ağustos', 'eylül', 'ekim', 'kasım', 'aralık'],
+].map((name, index) => [name, (index % 12) + 1]));
+const month = (name) => MONTHS.get(name.toLocaleLowerCase('tr-TR')) ?? MONTHS.get(name.toLowerCase());
+// "Monday, October 5, 2026 10:30 AM" in English; "5 Ekim 2026 Pazartesi 10:30" in Turkish.
+const ENGLISH_DATE = /^(?:[A-Za-z]+,\s*)?([A-Za-z]+)\s+(\d{1,2}),\s*(\d{4})(?:\s+(\d{1,2}):(\d{2})\s*([AP]M))?$/i;
+const TURKISH_DATE = /^(\d{1,2})\s+(\p{L}+)\s+(\d{4})(?:\s+\p{L}+)?(?:\s+(\d{1,2}):(\d{2}))?$/u;
+/** A day, or a day and a wall clock, as the tracker writes them in either language. */
+function writtenDate(value) {
+    const text = clean(value, 64);
+    let year, monthNumber, dayNumber, hour, minute;
+    const english = ENGLISH_DATE.exec(text);
+    const turkish = english ? null : TURKISH_DATE.exec(text);
+    if (english) {
+        [year, monthNumber, dayNumber] = [Number(english[3]), month(english[1]), Number(english[2])];
+        if (english[4] !== undefined) {
+            const twelve = Number(english[4]);
+            if (twelve < 1 || twelve > 12)
+                return null;
+            hour = String((twelve % 12) + (english[6].toUpperCase() === 'PM' ? 12 : 0)).padStart(2, '0');
+            minute = english[5];
+        }
+    }
+    else if (turkish) {
+        [year, monthNumber, dayNumber] = [Number(turkish[3]), month(turkish[2]), Number(turkish[1])];
+        hour = turkish[4]?.padStart(2, '0');
+        minute = turkish[5];
+    }
+    else
+        return null;
+    const day = monthNumber ? calendarDay(year, monthNumber, dayNumber) : null;
+    if (!day)
+        return null;
+    if (hour === undefined)
+        return { day };
+    if (Number(hour) > 23 || Number(minute) > 59)
+        return null;
+    return { day, clock: `${day}T${hour}:${minute}:00` };
+}
+/** A `yyyyMMddHHmmss` stamp of the summary as a wall clock. */
+function stamp(value) {
+    const match = /^(\d{4})(\d{2})(\d{2})(\d{2})(\d{2})(\d{2})$/.exec(clean(value, 14));
+    if (!match)
+        return null;
+    const day = calendarDay(Number(match[1]), Number(match[2]), Number(match[3]));
+    if (!day || Number(match[4]) > 23 || Number(match[5]) > 59 || Number(match[6]) > 59)
+        return null;
+    return `${day}T${match[4]}:${match[5]}:${match[6]}`;
+}
+/** A unit's "City - County"; a transfer between units has an empty one. */
+function place(value) {
+    const text = clean(value, 120);
+    return /^[\s-]*$/.test(text) ? '' : text;
+}
+/** The first movement's wording, which the summary's shipment date stands for. */
+const ISSUED = 'The transport document was issued.';
+/**
+ * The movements the tracker lists for a parcel on its way, oldest first by
+ * their order number. Each names its unit's city and county, and the unit's
+ * own name, which the adapter does not read. A reason, such as why a
+ * delivery failed, is appended in brackets; a delivery's reason is never
+ * read, as it could name who took the parcel.
+ */
+function movementsOf(payload) {
+    if (isRecord(payload)) {
+        const message = notice(payload);
+        if (message !== undefined)
+            throw new IndeterminateError(PROVIDER, 'Yurtiçi Kargo could not list the movements');
+    }
+    if (!Array.isArray(payload) || payload.length > MAX_ROWS)
+        throw new SchemaError(PROVIDER, 'Yurtiçi Kargo returned an invalid movement list');
+    const rows = payload.map((row, index) => {
+        if (!isRecord(row))
+            throw new SchemaError(PROVIDER, 'Yurtiçi Kargo returned an invalid movement');
+        const order = Number.isSafeInteger(row.OrderNo) ? row.OrderNo : null;
+        return { row, order, index };
+    });
+    // The list comes in its order numbers; without them it keeps the order it came in.
+    if (rows.every(({ order }) => order !== null))
+        rows.sort((left, right) => left.order - right.order || left.index - right.index);
+    const scans = [];
+    const seen = new Set();
+    for (const { row } of rows) {
+        const wording = clean(row.Description, 200);
+        if (!wording)
+            throw new SchemaError(PROVIDER, 'Yurtiçi Kargo returned a movement without wording');
+        const stage = yurticiScanStage(wording);
+        const reason = stage === 'delivered' ? '' : clean(row.DetailDescription, 160).replace(/[()]/g, '');
+        const description = reason && reason !== wording ? `${wording} (${reason})` : wording;
+        const written = writtenDate(row.EventDate);
+        const text = clean(row.EventDate, 64);
+        if (!written?.clock && !text)
+            throw new SchemaError(PROVIDER, 'Yurtiçi Kargo returned a movement without a date');
+        const location = place(row.Title);
+        const clock = written?.clock ? { local_time: written.clock } : { provider_time_text: text };
+        const event = { ...clock, description, ...(location ? { location } : {}),
+            ...(stage ? { stage, stage_source: 'carrier_map' } : {}) };
+        const key = JSON.stringify(event);
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        scans.push({ event, local: written?.clock ?? null });
+    }
+    return scans.reverse();
+}
+const cityCounty = (city, county) => [clean(city, 60), clean(county, 60)].filter(Boolean).join(' - ');
+/** Stages before the parcel reaches its recipient, while an estimate still means something. */
+const MOVING = new Set(['registered', 'accepted', 'in_transit', 'out_for_delivery']);
+/**
+ * The shipment's details, with its movements when the tracker lists them.
+ * The tracker stops listing movements once a parcel is delivered or returned;
+ * the details then give the shipment date and the final status, and the
+ * answer is a summary.
+ */
+export function parseYurtici(detail, movements, raw, search) {
+    const number = normalizeYurticiNumber(raw);
+    if (!isRecord(detail))
+        throw new SchemaError(PROVIDER);
+    const message = notice(detail);
+    if (message !== undefined) {
+        // The search knows the code, but the tracker no longer holds its record.
+        if (NOT_FOUND.has(message)) {
+            throw new IndeterminateError(PROVIDER, 'Yurtiçi Kargo no longer holds this shipment', { reason: 'history_expired' });
+        }
+        throw new IndeterminateError(PROVIDER, 'Yurtiçi Kargo could not read the shipment');
+    }
+    if (shipmentId(detail.Id) !== search.id)
+        throw new SchemaError(PROVIDER, 'Yurtiçi Kargo answered for a different shipment');
+    const summary = clean(detail.ShipmentStatus, 80);
+    if (!summary || typeof detail.IsDelivered !== 'boolean')
+        throw new SchemaError(PROVIDER, 'Yurtiçi Kargo returned a shipment without a status');
+    const delivered = detail.IsDelivered;
+    const listed = movements === undefined ? [] : movementsOf(movements);
+    const scans = [...listed];
+    if (!scans.length) {
+        const issued = stamp(detail.Title);
+        const departure = cityCounty(detail.DepartureCityName, detail.DepartureCountyName);
+        if (issued)
+            scans.push({ local: issued, event: { local_time: issued, description: ISSUED,
+                    ...(departure ? { location: departure } : {}), stage: 'accepted', stage_source: 'carrier_map' } });
+    }
+    // A delivered or returned parcel: the summary says which, else whether it was turned back.
+    const summaryStage = yurticiSummaryStage(summary);
+    const final = delivered
+        ? (summaryStage === 'delivered' || summaryStage === 'returned' ? summaryStage
+            : detail.RejectStatus === '0' ? 'delivered' : detail.RejectStatus === '2' ? 'returned' : undefined)
+        : undefined;
+    if (delivered && !listed.length) {
+        const closed = stamp(detail.LastProcessDate);
+        const destination = cityCounty(detail.DeliveryCityName, detail.DeliveryCountyName);
+        if (closed)
+            scans.unshift({ local: closed, event: { local_time: closed, description: summary,
+                    ...(destination ? { location: destination } : {}), ...(final ? { stage: final, stage_source: 'carrier_map' } : {}) } });
+    }
+    const events = scans.map(({ event }) => event);
+    // The summary settles a delivery, a return and a return that has not reached the sender; otherwise the newest movement does.
+    // A finished parcel whose summary settles neither keeps no stage rather than an earlier one.
+    const settled = final ?? (!delivered && summaryStage === 'exception' ? summaryStage : undefined);
+    const stage = settled ?? (delivered ? undefined : events.find(event => event.stage)?.stage);
+    if (!events.length && !stage)
+        throw new IndeterminateError(PROVIDER, 'Yurtiçi Kargo returned a shipment without dates or a known status');
+    const newest = scans.find(({ local }) => local)?.local ?? null;
+    const estimate = writtenDate(detail.EstimatedDeliveryDate)?.day;
+    const expected = stage && MOVING.has(stage) && estimate && (!newest || estimate >= newest.slice(0, 10)) ? estimate : null;
+    // A parcel the recipient collects from the delivery branch.
+    const branch = stage === 'delivered' && detail.IsAddressDelivery === false ? clean(detail.DeliveryUnitName, 80) : '';
+    const service = clean(detail.ProductName, 80);
+    const canonical = number.length === 16 ? printed(search.id) : '';
+    return {
+        status: stage ? languageStageStatus(stage) : 'unknown',
+        ...(stage ? { current_stage: stage, current_stage_source: 'carrier_map' } : {}),
+        last_status_text: settled ? summary : events[0]?.description ?? summary,
+        ...(listed.length ? {} : { summary_only: true }),
+        last_update: null,
+        last_update_local: newest,
+        expected_delivery: expected,
+        ...(service ? { service_name: service } : {}),
+        ...(branch ? { pickup_point: branch } : {}),
+        ...(canonical && canonical !== number ? { canonical_tracking_number: canonical } : {}),
+        events: events.slice(0, MAX_EVENTS),
+        ...(events.length > MAX_EVENTS ? { history_truncated: true } : {}),
+    };
+}

package/dist/carriers/yurtici-kargo/status.d.ts

@@ -0,0 +1,11 @@
+import type { Stage } from '../../core/status/index.js';
+import { type CarrierStatusMap } from '../../core/status/statusMap.js';
+/** The stage a movement's wording gives it, its appended reason aside. */
+export declare function yurticiScanStage(wording: string): Stage | undefined;
+/** The stage a summary status gives the shipment, when it settles one. */
+export declare function yurticiSummaryStage(wording: string): Stage | undefined;
+/**
+ * Movements and summary statuses carry wording only. A summary status words
+ * the newest event of a parcel whose movements the tracker no longer lists.
+ */
+export declare const statusMap: CarrierStatusMap;

package/dist/carriers/yurtici-kargo/status.js

@@ -0,0 +1,58 @@
+import { normalizeStatusWording } from '../../core/status/statusMap.js';
+/**
+ * The wording of the movements Yurtiçi's tracker lists for a parcel on its
+ * way, in English and in Turkish. Movements carry no code. The transport
+ * document is the waybill the departure branch issues when it takes the
+ * parcel; "Distribution exited" is the parcel out on a courier's round. A
+ * parcel turned back to its sender is sent to its departure branch for the
+ * return, which is not yet a return.
+ */
+const SCANS = [
+    ['The transport document was issued.', 'accepted'],
+    ['Taşıma belgesi düzenlendi.', 'accepted'],
+    ['In the transfer process.', 'in_transit'],
+    ['Transfer Sürecinde', 'in_transit'],
+    ['Reached the delivery unit.', 'in_transit'],
+    ['Teslim birimine ulaştı.', 'in_transit'],
+    ['Redirected to New Delivery Unit.', 'in_transit'],
+    ['Yeni Teslim Birimine Yönlendirildi', 'in_transit'],
+    ['Distribution exited.', 'out_for_delivery'],
+    ['Dağıtıma çıkarıldı.', 'out_for_delivery'],
+    ['NOT DELIVERED / WAITING AT BRANCH', 'failed_attempt'],
+    ['Teslim edilemedi.', 'failed_attempt'],
+    ['Redirected to Exit Unit for Return Process.', 'exception'],
+    ['İade Süreci için Çıkış Birimine Yönlendirildi', 'exception'],
+];
+/**
+ * The shipment's summary status. The English tracker translates some and
+ * keeps others in Turkish. A return that has not reached its sender is a
+ * problem, not yet a return.
+ */
+const SUMMARIES = [
+    ['DELIVERED', 'delivered'],
+    ['TESLİM EDİLDİ', 'delivered'],
+    ['İADE EDİLDİ', 'returned'],
+    ['NOT RETURNED', 'exception'],
+    ['İADE EDİLEMEDİ', 'exception'],
+];
+const keyed = (entries) => new Map(entries.map(([wording, stage]) => [normalizeStatusWording(wording), stage]));
+const SCAN_KEYS = keyed(SCANS);
+const SUMMARY_KEYS = keyed(SUMMARIES);
+/** A movement's reason, which the adapter appends in brackets. */
+const REASON = /\s*\([^()]*\)$/;
+/** The stage a movement's wording gives it, its appended reason aside. */
+export function yurticiScanStage(wording) {
+    return SCAN_KEYS.get(normalizeStatusWording(wording.replace(REASON, '')));
+}
+/** The stage a summary status gives the shipment, when it settles one. */
+export function yurticiSummaryStage(wording) {
+    return SUMMARY_KEYS.get(normalizeStatusWording(wording));
+}
+/**
+ * Movements and summary statuses carry wording only. A summary status words
+ * the newest event of a parcel whose movements the tracker no longer lists.
+ */
+export const statusMap = {
+    stage: (code, wording) => code === null ? yurticiScanStage(wording) ?? yurticiSummaryStage(wording) : undefined,
+    gaps: [],
+};

package/dist/carriers/yurtici-kargo/statuses.json

@@ -1,4 +1,24 @@
 {
   "carrier": "yurtici-kargo",
-  "entries": []
+  "entries": [
+    { "wording": "The transport document was issued.", "language": "en", "stage": "accepted", "confirmedBy": "live", "note": "Movement: the departure branch issues the waybill when it takes the parcel." },
+    { "wording": "Taşıma belgesi düzenlendi.", "language": "tr", "stage": "accepted", "confirmedBy": "live", "note": "Movement: the departure branch issues the waybill when it takes the parcel." },
+    { "wording": "In the transfer process.", "language": "en", "stage": "in_transit", "confirmedBy": "live", "note": "Movement between units; it names no place." },
+    { "wording": "Transfer Sürecinde", "language": "tr", "stage": "in_transit", "confirmedBy": "live", "note": "Movement between units; it names no place." },
+    { "wording": "Reached the delivery unit.", "language": "en", "stage": "in_transit", "confirmedBy": "live", "note": "Movement: also the departure branch when a return reaches it." },
+    { "wording": "Teslim birimine ulaştı.", "language": "tr", "stage": "in_transit", "confirmedBy": "live", "note": "Movement: also the departure branch when a return reaches it." },
+    { "wording": "Redirected to New Delivery Unit.", "language": "en", "stage": "in_transit", "confirmedBy": "live", "note": "Movement after a failed delivery." },
+    { "wording": "Yeni Teslim Birimine Yönlendirildi", "language": "tr", "stage": "in_transit", "confirmedBy": "live", "note": "Movement after a failed delivery." },
+    { "wording": "Distribution exited.", "language": "en", "stage": "out_for_delivery", "confirmedBy": "live", "note": "Movement: out on a courier's round." },
+    { "wording": "Dağıtıma çıkarıldı.", "language": "tr", "stage": "out_for_delivery", "confirmedBy": "live", "note": "Movement: out on a courier's round." },
+    { "wording": "NOT DELIVERED / WAITING AT BRANCH", "language": "en", "stage": "failed_attempt", "confirmedBy": "live", "note": "Movement: its reason is appended in brackets." },
+    { "wording": "Teslim edilemedi.", "language": "tr", "stage": "failed_attempt", "confirmedBy": "live", "note": "Movement: its reason is appended in brackets." },
+    { "wording": "Redirected to Exit Unit for Return Process.", "language": "en", "stage": "exception", "confirmedBy": "live", "note": "Movement: the parcel heads back to its sender, not yet returned." },
+    { "wording": "İade Süreci için Çıkış Birimine Yönlendirildi", "language": "tr", "stage": "exception", "confirmedBy": "live", "note": "Movement: the parcel heads back to its sender, not yet returned." },
+    { "wording": "DELIVERED", "language": "en", "stage": "delivered", "confirmedBy": "live", "note": "Summary status of a delivered parcel, whose movements the tracker no longer lists." },
+    { "wording": "TESLİM EDİLDİ", "language": "tr", "stage": "delivered", "confirmedBy": "live", "note": "Summary status of a delivered parcel, whose movements the tracker no longer lists." },
+    { "wording": "İADE EDİLDİ", "language": "tr", "stage": "returned", "confirmedBy": "live", "note": "Summary status of a parcel returned to its sender; the English tracker keeps it in Turkish." },
+    { "wording": "NOT RETURNED", "language": "en", "stage": "exception", "confirmedBy": "live", "note": "Summary status of a parcel on its way back that has not reached its sender." },
+    { "wording": "İADE EDİLEMEDİ", "language": "tr", "stage": "exception", "confirmedBy": "live", "note": "Summary status of a parcel on its way back that has not reached its sender." }
+  ]
 }

package/dist/core/catalog/statusMaps.js

@@ -52,6 +52,7 @@ import { statusMap as tnt } from '../../carriers/tnt/status.js';
 import { statusMap as ups } from '../../carriers/ups/status.js';
 import { statusMap as venipak } from '../../carriers/venipak/status.js';
 import { statusMap as yunexpress } from '../../carriers/yunexpress/status.js';
+import { statusMap as yurticiKargo } from '../../carriers/yurtici-kargo/status.js';
 import { statusMap as universal } from '../../providers/status.js';
 import { normalizeStatusWording } from '../status/statusMap.js';
 import { CARRIER_DEFINITIONS } from './definitions.js';
@@ -61,7 +62,7 @@ export const STATUS_MAPS = {
     'dhl-express': dhlExpress, dpd, 'dpd-de': dpdDe, 'dpd-fr': dpdFr, 'dpd-ie': dpdIe, 'dpd-pl': dpdPl, econt, elta, emile, 'fan-courier': fanCourier,
     foxpost, 'geniki-taxydromiki': geniki, 'gls-it': glsIt, 'gofo-fr': gofoFr, 'gofo-it': gofoIt, 'j-and-t': jAndT, 'j-and-t-cargo': jntCargo,
     'la-poste': laPoste, 'old-dominion': oldDominion, omgo, omniva, 'orlen-paczka': orlenPaczka, postlogistics, ppl, sagawa, sameday, speedx, speedy,
-    sto, 'swiss-post': swissPost, 'thailand-post': thailandPost, tnt, ups, venipak, yunexpress,
+    sto, 'swiss-post': swissPost, 'thailand-post': thailandPost, tnt, ups, venipak, yunexpress, 'yurtici-kargo': yurticiKargo,
 };
 /** The carrier the app files the universal providers' scans under. */
 const UNIVERSAL_CARRIER = 'unknown';

package/dist/data/catalog.json

@@ -8285,7 +8285,9 @@
         "timezone": "Europe/Istanbul",
         "tracking": {
             "mode": "automatic",
-            "adapter": "universal"
+            "adapter": "yurtici-kargo",
+            "recognitionRank": 66,
+            "localClocks": true
         },
         "canaryUrl": "https://www.yurticikargo.com/tr/online-servisler/gonderi-sorgula",
         "trackingUrlTemplate": "https://www.yurticikargo.com/tr/online-servisler/gonderi-sorgula?code={trackingNumber}",

package/dist/generated/catalog.d.ts

@@ -5550,7 +5550,9 @@ export declare const CARRIER_CATALOG: {
         readonly timezone: "Europe/Istanbul";
         readonly tracking: {
             readonly mode: "automatic";
-            readonly adapter: "universal";
+            readonly adapter: "yurtici-kargo";
+            readonly recognitionRank: 66;
+            readonly localClocks: true;
         };
         readonly canaryUrl: "https://www.yurticikargo.com/tr/online-servisler/gonderi-sorgula";
         readonly trackingUrlTemplate: "https://www.yurticikargo.com/tr/online-servisler/gonderi-sorgula?code={trackingNumber}";

package/dist/generated/catalog.js

@@ -8286,7 +8286,9 @@ export const CARRIER_CATALOG = {
         "timezone": "Europe/Istanbul",
         "tracking": {
             "mode": "automatic",
-            "adapter": "universal"
+            "adapter": "yurtici-kargo",
+            "recognitionRank": 66,
+            "localClocks": true
         },
         "canaryUrl": "https://www.yurticikargo.com/tr/online-servisler/gonderi-sorgula",
         "trackingUrlTemplate": "https://www.yurticikargo.com/tr/online-servisler/gonderi-sorgula?code={trackingNumber}",

package/dist/generated/recognition.js

@@ -69,4 +69,5 @@ export const CARRIER_RECOGNITION_RANKS = {
     "ukrposhta": 5,
     "uniuni": 33,
     "venipak": 63,
+    "yurtici-kargo": 66,
 };

package/dist/generated/registry.js

@@ -134,6 +134,7 @@ import { adapter as yanwen } from '../carriers/yanwen/adapter.js';
 import { adapter as yto } from '../carriers/yto/adapter.js';
 import { adapter as yunda } from '../carriers/yunda/adapter.js';
 import { adapter as yunexpress } from '../carriers/yunexpress/adapter.js';
+import { adapter as yurticiKargo } from '../carriers/yurtici-kargo/adapter.js';
 export const REGISTRY = {
     factories: {
         "acs-courier": acsCourier,
@@ -271,6 +272,7 @@ export const REGISTRY = {
         "yto": yto,
         "yunda": yunda,
         "yunexpress": yunexpress,
+        "yurtici-kargo": yurticiKargo,
     },
     carriers: {
         "99minutos": "universal",
@@ -477,7 +479,7 @@ export const REGISTRY = {
         "yto": "yto",
         "yunda": "yunda",
         "yunexpress": "yunexpress",
-        "yurtici-kargo": "universal",
+        "yurtici-kargo": "yurtici-kargo",
         "zeleris": "universal",
         "zto": "universal",
     },

package/dist/server/openapi.json

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

package/package.json

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