universal-parcel-scraper 0.82.0-main.949 → 0.83.0-main.951

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 **140 dedicated adapters** and **5 universal fallbacks**
+**3,500+ carriers** through **141 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,936 such statuses, each filed under one stage.
+The carrier folders record 3,952 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

@@ -8105,7 +8105,8 @@
     "timezone": "Europe/Paris",
     "tracking": {
       "mode": "automatic",
-      "adapter": "universal"
+      "adapter": "vinted-go",
+      "recognitionRank": 72
     },
     "canaryUrl": "https://vintedgo.com/en/tracking",
     "trackingUrlTemplate": "https://vintedgo.com/en/tracking/{trackingNumber}",

package/data/coverage-summary.json

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

package/data/detection-golden.json

@@ -7748,6 +7748,7 @@
       "vinted-go"
     ],
     "asked": [
+      "vinted-go",
       "tnt",
       "dhl-ecommerce"
     ]
@@ -7927,6 +7928,7 @@
       "vinted-go"
     ],
     "asked": [
+      "vinted-go",
       "tnt",
       "dhl-ecommerce"
     ]
@@ -7942,6 +7944,7 @@
       "vinted-go"
     ],
     "asked": [
+      "vinted-go",
       "tnt",
       "dhl-ecommerce"
     ]
@@ -7957,6 +7960,7 @@
       "vinted-go"
     ],
     "asked": [
+      "vinted-go",
       "tnt",
       "dhl-ecommerce"
     ]
@@ -7972,6 +7976,7 @@
       "vinted-go"
     ],
     "asked": [
+      "vinted-go",
       "tnt",
       "dhl-ecommerce"
     ]
@@ -7987,6 +7992,7 @@
       "vinted-go"
     ],
     "asked": [
+      "vinted-go",
       "tnt",
       "dhl-ecommerce"
     ]

package/dist/browser/scraper.js

@@ -6398,7 +6398,8 @@ var ye = {
 		timezone: "Europe/Paris",
 		tracking: {
 			mode: "automatic",
-			adapter: "universal"
+			adapter: "vinted-go",
+			recognitionRank: 72
 		},
 		canaryUrl: "https://vintedgo.com/en/tracking",
 		trackingUrlTemplate: "https://vintedgo.com/en/tracking/{trackingNumber}",
@@ -11810,6 +11811,7 @@ var _c = {
 	ukrposhta: 5,
 	uniuni: 33,
 	venipak: 63,
+	"vinted-go": 72,
 	"yurtici-kargo": 66
 }, vc = 5;
 function yc(e) {

package/dist/carriers/vinted-go/adapter.d.ts

@@ -0,0 +1,15 @@
+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 VINTED_GO_ENDPOINT = "https://carrier.vintedgo.com/public/v3/tracking_events/";
+export declare function vintedGoTrackingUrl(raw: string): string;
+export declare class VintedGoTracker {
+    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/vinted-go/adapter.js

@@ -0,0 +1,62 @@
+import { accepted, recognizeFromLookup } from '../../core/adapter/index.js';
+import { ChallengeError, IndeterminateError, SchemaError } 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 { normalizeVintedGoNumber, parseVintedGo, parseVintedGoMissing, PROVIDER, VINTED_GO_MAX_BYTES } from './parser.js';
+// The service the tracker's search box asks before it opens a parcel's page.
+export const VINTED_GO_ENDPOINT = 'https://carrier.vintedgo.com/public/v3/tracking_events/';
+const REDIRECTS = [301, 302, 303, 307, 308];
+// Cloudflare's challenge page, which can come instead of the reply.
+const CHALLENGE = /_cf_chl_opt|cf-turnstile|<title>Just a moment/i;
+export function vintedGoTrackingUrl(raw) {
+    return `${VINTED_GO_ENDPOINT}${normalizeVintedGoNumber(raw)}`;
+}
+export class VintedGoTracker {
+    options;
+    constructor(options = {}) {
+        this.options = options;
+    }
+    async fetch(raw, context = {}) {
+        const url = vintedGoTrackingUrl(raw);
+        const read = async (signal, timeoutMs) => {
+            // The scans are worded in the language asked for; English is the one the map and the place rules read.
+            const { response, bytes } = await fetchBounded(url, { signal, headers: {
+                    Accept: 'application/json', 'Accept-Language': 'en', 'User-Agent': userAgentOf(this.options.userAgent),
+                } }, { provider: PROVIDER, timeoutMs: Math.max(1, Math.floor(timeoutMs)), maxBytes: VINTED_GO_MAX_BYTES, redirect: 'manual',
+                allowHttpStatuses: [...REDIRECTS, 404], fetcher: this.options.fetcher });
+            const text = decodeText(bytes);
+            if (response.status === 404)
+                return parseVintedGoMissing(text, response.headers.get('content-type'));
+            // A moved service says nothing about the parcel.
+            if (response.status !== 200)
+                throw new IndeterminateError(PROVIDER, 'Vinted Go tracking service moved');
+            let reply;
+            try {
+                reply = JSON.parse(text);
+            }
+            catch (error) {
+                if (CHALLENGE.test(text))
+                    throw new ChallengeError(PROVIDER, 'Vinted Go answered with a browser challenge', { cause: error });
+                throw new SchemaError(PROVIDER, 'Vinted Go returned a reply that is not JSON', { cause: error });
+            }
+            return parseVintedGo(reply, raw);
+        };
+        // A request that fails to reach Vinted Go, or hangs, gets one more try: the
+        // first gets half of the budget, so the retry fits in the rest.
+        return runSteps({ carrier: 'vinted-go', 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 VintedGoTracker({ fetcher: environment.fetcher, recorder: environment.recorder, userAgent: environment.userAgent });
+    return {
+        id: 'vinted-go', recordsSteps: true, steps: ['direct', 'retry'],
+        track: (input, context) => tracker.fetch(input.number, context),
+        recognize: (number, context) => recognizeFromLookup(() => tracker.fetch(number, context), () => accepted(() => normalizeVintedGoNumber(number))),
+    };
+};

package/dist/carriers/vinted-go/carrier.json

@@ -21,18 +21,65 @@
   "timezone": "Europe/Paris",
   "tracking": {
     "mode": "automatic",
-    "adapter": "universal",
-    "steps": []
+    "adapter": "vinted-go",
+    "steps": [
+      "direct",
+      "retry"
+    ],
+    "recognition": {
+      "rank": 72
+    }
   },
-  "capabilities": [],
+  "capabilities": [
+    "history",
+    "location",
+    "delivered_at",
+    "provider_code",
+    "pickup_point",
+    "delivery_partner",
+    "delivery_tracking_number"
+  ],
   "portal": {
     "url": "https://vintedgo.com/en/tracking/{trackingNumber}",
     "searchUrl": "https://vintedgo.com/en/tracking",
     "canaryUrl": "https://vintedgo.com/en/tracking",
-    "shows": [],
-    "scraped": [],
-    "discarded": [],
-    "unavailable": []
+    "shows": [
+      "status",
+      "history",
+      "location",
+      "delivered_at",
+      "pickup_point",
+      "pickup_point_address",
+      "office_opening_hours",
+      "pickup_deadline",
+      "delivery_partner",
+      "delivery_tracking_number",
+      "notices"
+    ],
+    "scraped": [
+      "status",
+      "history",
+      "location",
+      "delivered_at",
+      "provider_code",
+      "offset_timestamps",
+      "pickup_point",
+      "delivery_partner",
+      "delivery_tracking_number"
+    ],
+    "discarded": [
+      "pickup_point_address",
+      "office_opening_hours",
+      "pickup_deadline",
+      "notices"
+    ],
+    "unavailable": [
+      "eta",
+      "weight",
+      "service_name",
+      "sender_name",
+      "recipient_name"
+    ]
   },
   "links": [
     {

package/dist/carriers/vinted-go/numbers.json

@@ -112,7 +112,7 @@
         "access": "indexed_excerpt"
       },
       "context": {
-        "assessment": "candidate"
+        "assessment": "confirmed"
       },
       "expect": {
         "carrier": "unknown",
@@ -137,7 +137,7 @@
         "access": "indexed_excerpt"
       },
       "context": {
-        "assessment": "candidate"
+        "assessment": "confirmed"
       },
       "expect": {
         "carrier": "unknown",

package/dist/carriers/vinted-go/parser.d.ts

@@ -0,0 +1,19 @@
+import type { CarrierResult } from '../../core/result/index.js';
+export declare const PROVIDER = "Vinted Go";
+export declare const VINTED_GO_MAX_BYTES: number;
+/** A Vinted Go parcel number; anything else is a number Vinted Go does not issue. */
+export declare function normalizeVintedGoNumber(raw: string): string;
+/**
+ * The reply of `GET /public/v3/tracking_events/{number}`. It does not echo the
+ * number: the scans belong to the one in the request's path. The pickup
+ * point's address, its id, the pickup deadline, banners and questions in the
+ * same reply are never read.
+ */
+export declare function parseVintedGo(payload: unknown, raw: string): CarrierResult;
+/**
+ * A 404 from the service. An unknown number gets an empty body in the type
+ * asked for; a number whose label is over six months old gets
+ * `shipment_expired`, whether the parcel existed or not. A missing route
+ * answers "Not found" in plain text and says nothing about the parcel.
+ */
+export declare function parseVintedGoMissing(body: string, contentType: string | null): never;

package/dist/carriers/vinted-go/parser.js

@@ -0,0 +1,187 @@
+import { carrierIdFromPartner } from '../../core/catalog/hints.js';
+import { normalizeTrackingNumber } from '../../core/detection/index.js';
+import { hasLuhnCheckDigit } from '../../core/detection/numericChecksums.js';
+import { IndeterminateError, InvalidInputError, NotFoundError, SchemaError } from '../../core/errors/index.js';
+import { lastMovement } from '../../core/result/pickup.js';
+import { classifyWording, languageStageStatus } from '../../core/status/index.js';
+import { explicitOffsetTime } from '../../core/time/index.js';
+import { clean, cleanScalar } from '../../core/transport/index.js';
+import { isRecord } from '../../core/types.js';
+import { vintedGoCode, vintedGoStage } from './status.js';
+export const PROVIDER = 'Vinted Go';
+// A parcel's reply is a few kilobytes; its scans and a few questions and answers.
+export const VINTED_GO_MAX_BYTES = 512 * 1024;
+// Sixteen digits: the label's creation in Unix milliseconds, two more digits
+// and a Luhn check digit. The service answers a number whose check fails as if
+// it did not exist, whatever its age.
+const NUMBER = /^1\d{15}$/;
+// A sorting centre's town and country, the only place a scan's wording names
+// as the parcel's own. "In transit to" names where it is going.
+const SORTING_CENTER = /^(?:Return: )?At sorting center in ([^,]{2,80}), ([A-Z]{2})$/;
+// The point a parcel is on its way to. Only lockers and parcel shops are named:
+// a neighbourhood point can be someone's home.
+const ON_ITS_WAY = /^The parcel is on its way to the (locker|parcel shop) \((.{1,120})\)$/;
+const READY_AT = /^Ready to collect at the (locker|parcel shop)$/;
+// The milestones whose scan can carry a new tracking code on another network.
+const HANDOVER = new Set(['redirected', 'left_our_network']);
+const MAX_ROWS = 500;
+const MAX_EVENTS = 100;
+/** A Vinted Go parcel number; anything else is a number Vinted Go does not issue. */
+export function normalizeVintedGoNumber(raw) {
+    const number = raw.length <= 64 ? normalizeTrackingNumber(raw) : '';
+    if (!NUMBER.test(number) || !hasLuhnCheckDigit(number)) {
+        throw new InvalidInputError(PROVIDER, 'Vinted Go numbers are sixteen digits starting 1 whose last digit passes the Luhn check');
+    }
+    return number;
+}
+/** An optional text field; an object, array or other non-scalar is a changed reply. */
+function text(row, key, maxLength = 500) {
+    const value = row[key];
+    if (value === null || value === undefined)
+        return '';
+    if (typeof value !== 'string' && typeof value !== 'number')
+        throw new SchemaError(PROVIDER, `Vinted Go returned an invalid ${key}`);
+    return typeof value === 'number' ? cleanScalar(value, maxLength) : clean(value, maxLength);
+}
+function projectScan(row, index) {
+    if (!isRecord(row))
+        throw new SchemaError(PROVIDER, 'Vinted Go returned an invalid scan');
+    const stamp = text(row, 'timestamp', 64);
+    const time = explicitOffsetTime(stamp);
+    if (!time)
+        throw new SchemaError(PROVIDER, 'Vinted Go returned a scan without an offset time');
+    const description = text(row, 'message');
+    if (!description)
+        throw new SchemaError(PROVIDER, 'Vinted Go returned a scan without wording');
+    const group = text(row, 'group', 64);
+    const state = text(row, 'state', 64);
+    const stage = vintedGoStage(state, group);
+    const place = SORTING_CENTER.exec(description);
+    const event = {
+        time: time.iso,
+        description,
+        ...(place ? { location: `${place[1]}, ${place[2]}` } : {}),
+        ...(group && state ? { provider_code: vintedGoCode(state, group) } : {}),
+        ...(stage ? { stage, stage_source: 'carrier_map' } : {}),
+    };
+    const metadata = isRecord(row.metadata) ? row.metadata : {};
+    return { id: text(row, 'id', 64), scan: { event, at: time.timestamp, index, group, state, metadata } };
+}
+/**
+ * The locker or parcel shop a parcel waits at: the point the scan before its
+ * newest ready-to-collect scan sent it on to, when no redirection came between.
+ * On a delivered parcel, the point it was collected from.
+ */
+function pickupPoint(scans, stage) {
+    const events = scans.map((scan) => scan.event);
+    const ready = scans.findIndex((scan) => scan.event.stage === 'ready_for_pickup');
+    if (ready < 0)
+        return '';
+    if (stage === 'delivered') {
+        if (lastMovement(events.slice(1)) !== 'ready_for_pickup')
+            return '';
+    }
+    else if (stage !== 'ready_for_pickup' || ready !== 0) {
+        return '';
+    }
+    const kind = READY_AT.exec(scans[ready].event.description)?.[1];
+    if (!kind)
+        return '';
+    for (const scan of scans.slice(ready + 1)) {
+        if (scan.group === 'redirected')
+            return '';
+        if (scan.group !== 'in_transit')
+            continue;
+        const match = ON_ITS_WAY.exec(scan.event.description);
+        if (match)
+            return match[1] === kind ? match[2] : '';
+    }
+    return '';
+}
+/** The newest new tracking code the parcel was handed over under, with its network when its link names one. */
+function handover(scans, number) {
+    for (const scan of scans) {
+        if (scan.state !== 'delivery' || !HANDOVER.has(scan.group))
+            continue;
+        const code = normalizeTrackingNumber(text(scan.metadata, 'tracking_code', 64));
+        if (!/^[A-Z0-9]{4,40}$/.test(code) || code === number)
+            continue;
+        const partner = carrierIdFromPartner('', text(scan.metadata, 'external_link', 500));
+        return { delivery_tracking_number: code, ...(partner && partner !== 'vinted-go' ? { delivery_carrier: partner } : {}) };
+    }
+    return {};
+}
+/**
+ * The reply of `GET /public/v3/tracking_events/{number}`. It does not echo the
+ * number: the scans belong to the one in the request's path. The pickup
+ * point's address, its id, the pickup deadline, banners and questions in the
+ * same reply are never read.
+ */
+export function parseVintedGo(payload, raw) {
+    const number = normalizeVintedGoNumber(raw);
+    if (!isRecord(payload) || !Array.isArray(payload.tracking_events))
+        throw new SchemaError(PROVIDER, 'Vinted Go returned an unexpected reply');
+    const rows = payload.tracking_events;
+    if (rows.length > MAX_ROWS)
+        throw new SchemaError(PROVIDER, 'Vinted Go returned an oversized history');
+    // The tracker treats an empty list like an unknown number, but no reply showed one.
+    if (!rows.length)
+        throw new IndeterminateError(PROVIDER, 'Vinted Go returned no scans for the parcel');
+    const seen = new Set();
+    const scans = [];
+    rows.forEach((row, index) => {
+        const { id, scan } = projectScan(row, index);
+        const key = id || JSON.stringify(scan.event);
+        if (seen.has(key))
+            return;
+        seen.add(key);
+        scans.push(scan);
+    });
+    // The reply lists scans newest first. Instants order them; equal ones keep its order.
+    scans.sort((left, right) => right.at - left.at || left.index - right.index);
+    const newest = scans[0].event;
+    const current = newest.stage
+        ? { stage: newest.stage, source: 'carrier_map' }
+        : classifyWording(newest.description, 'in_transit');
+    const known = current.source !== 'none';
+    const stage = known ? current.stage : undefined;
+    const point = pickupPoint(scans, stage);
+    return {
+        status: stage ? languageStageStatus(stage) : 'unknown',
+        ...(stage ? { current_stage: stage, current_stage_source: current.source } : {}),
+        last_status_text: newest.description,
+        last_update: newest.time,
+        expected_delivery: null,
+        ...(stage === 'delivered' ? { delivered_at: newest.time } : {}),
+        ...(point ? { pickup_point: point } : {}),
+        ...handover(scans, number),
+        events: scans.slice(0, MAX_EVENTS).map((scan) => scan.event),
+        ...(scans.length > MAX_EVENTS ? { history_truncated: true } : {}),
+    };
+}
+/**
+ * A 404 from the service. An unknown number gets an empty body in the type
+ * asked for; a number whose label is over six months old gets
+ * `shipment_expired`, whether the parcel existed or not. A missing route
+ * answers "Not found" in plain text and says nothing about the parcel.
+ */
+export function parseVintedGoMissing(body, contentType) {
+    const type = (contentType ?? '').toLowerCase();
+    if (!body.trim()) {
+        if (type.includes('application/json'))
+            throw new NotFoundError(PROVIDER);
+        throw new IndeterminateError(PROVIDER, 'Vinted Go tracking service is unavailable');
+    }
+    let reply;
+    try {
+        reply = JSON.parse(body);
+    }
+    catch {
+        throw new IndeterminateError(PROVIDER, 'Vinted Go tracking service is unavailable');
+    }
+    const code = isRecord(reply) && typeof reply.error_code === 'string' ? reply.error_code : '';
+    if (code === 'shipment_expired') {
+        throw new IndeterminateError(PROVIDER, 'Vinted Go no longer keeps the history of parcels over six months old', { reason: 'history_expired' });
+    }
+    throw new IndeterminateError(PROVIDER, 'Vinted Go refused the lookup');
+}

package/dist/carriers/vinted-go/status.d.ts

@@ -0,0 +1,13 @@
+import type { Stage } from '../../core/status/index.js';
+import type { CarrierStatusMap } from '../../core/status/statusMap.js';
+/** The provider code of a scan: its leg, a slash and its milestone ("return/in_transit"). */
+export declare function vintedGoCode(state: string, group: string): string;
+/**
+ * A scan's stage from its leg and milestone. Every movement on the return leg
+ * takes the parcel back to its sender, so it is `returned`; a loss or a
+ * cancellation stays an exception on any leg. A leg or milestone the map does
+ * not know is left to the shared wording rules.
+ */
+export declare function vintedGoStage(state: string, group: string): Stage | undefined;
+/** What the map says about one scan, by its provider code alone. */
+export declare const statusMap: CarrierStatusMap;

package/dist/carriers/vinted-go/status.js

@@ -0,0 +1,47 @@
+// Each scan names its milestone (`group`) and the leg it belongs to (`state`):
+// `delivery` on the way to the recipient, `return` back to the sender and
+// `dispose` for a parcel that will not arrive. The tracker's own labels name
+// the groups; a redirection sends the parcel on to another point or network.
+const GROUPS = {
+    created: 'registered',
+    shipped: 'accepted',
+    in_transit: 'in_transit',
+    redirected: 'in_transit',
+    left_our_network: 'in_transit',
+    ready_for_pickup: 'ready_for_pickup',
+    delivered: 'delivered',
+    return: 'returned',
+    returned: 'returned',
+    lost: 'exception',
+    disposed: 'exception',
+    cancelled: 'exception',
+    empty_locker_found: 'exception',
+};
+const LEGS = new Set(['delivery', 'return', 'dispose']);
+/** The provider code of a scan: its leg, a slash and its milestone ("return/in_transit"). */
+export function vintedGoCode(state, group) {
+    return `${state}/${group}`;
+}
+/**
+ * A scan's stage from its leg and milestone. Every movement on the return leg
+ * takes the parcel back to its sender, so it is `returned`; a loss or a
+ * cancellation stays an exception on any leg. A leg or milestone the map does
+ * not know is left to the shared wording rules.
+ */
+export function vintedGoStage(state, group) {
+    if (!LEGS.has(state) || !Object.hasOwn(GROUPS, group))
+        return undefined;
+    const stage = GROUPS[group];
+    return state === 'return' && stage !== 'exception' ? 'returned' : stage;
+}
+/** What the map says about one scan, by its provider code alone. */
+export const statusMap = {
+    stage: (code) => {
+        const [state, group, ...rest] = (code ?? '').split('/');
+        return state && group && !rest.length ? vintedGoStage(state, group) : undefined;
+    },
+    gaps: [{
+            code: 'delivery/oversized',
+            note: 'The tracker names an oversized parcel, which it then redirects to a larger point. No reply showed one, so it is left to the wording rules.',
+        }],
+};

package/dist/carriers/vinted-go/statuses.json

@@ -1,4 +1,21 @@
 {
   "carrier": "vinted-go",
-  "entries": []
+  "entries": [
+    { "code": "delivery/created", "wording": "Shipment created", "language": "en", "stage": "registered", "confirmedBy": "live", "note": "The label, before the sender drops the parcel off." },
+    { "code": "delivery/shipped", "wording": "Parcel was dropped off at the locker", "language": "en", "stage": "accepted", "confirmedBy": "live", "note": "Also worded \"Parcel was dropped off at the parcel shop\"." },
+    { "code": "delivery/in_transit", "wording": "At sorting center in <town>, <country>", "language": "en", "stage": "in_transit", "confirmedBy": "live", "note": "Also \"In transit to <town>, <country>\" and \"The parcel is on its way to the locker (<point>)\". Only a sorting centre's town becomes the scan's location." },
+    { "code": "delivery/redirected", "wording": "Parcel redirected to the parcel shop", "language": "en", "stage": "in_transit", "confirmedBy": "live", "note": "The selected point could not take the parcel, which goes on to another point, a hub (\"to the hub\", \"to the locker\") or another network (\"Change: Parcel redirected to Colissimo\")." },
+    { "code": "delivery/left_our_network", "wording": "Parcel left our network", "language": "en", "stage": "in_transit", "confirmedBy": "bundle", "note": "The tracker shows this milestone with the new tracking code and the other network's link; no reply showed it, so the wording is a placeholder." },
+    { "code": "delivery/ready_for_pickup", "wording": "Ready to collect at the locker", "language": "en", "stage": "ready_for_pickup", "confirmedBy": "live", "note": "Also \"Ready to collect at the parcel shop\"." },
+    { "code": "delivery/delivered", "wording": "Parcel was collected by the recipient", "language": "en", "stage": "delivered", "confirmedBy": "live", "note": "A second scan worded \"Delivered\" follows within a second." },
+    { "code": "delivery/empty_locker_found", "wording": "Missing from locker", "language": "en", "stage": "exception", "confirmedBy": "bundle", "note": "The tracker's label for the milestone." },
+    { "code": "return/return", "wording": "Return: Parcel will be returned. Reason: pickup time has expired", "language": "en", "stage": "returned", "confirmedBy": "live", "note": "The return leg starts." },
+    { "code": "return/in_transit", "wording": "Return: At sorting center in <town>, <country>", "language": "en", "stage": "returned", "confirmedBy": "live", "note": "Every movement on the return leg takes the parcel back to its sender." },
+    { "code": "return/ready_for_pickup", "wording": "Return ready to collect", "language": "en", "stage": "returned", "confirmedBy": "bundle", "note": "The tracker's label: the returned parcel waits for its sender at a point." },
+    { "code": "return/returned", "wording": "Return delivered", "language": "en", "stage": "returned", "confirmedBy": "bundle", "note": "The tracker's label." },
+    { "code": "dispose/lost", "wording": "Parcel lost", "language": "en", "stage": "exception", "confirmedBy": "live", "note": "Later scans can show the parcel found again." },
+    { "code": "dispose/disposed", "wording": "Couldn’t be delivered", "language": "en", "stage": "exception", "confirmedBy": "bundle", "note": "The tracker's label." },
+    { "code": "dispose/cancelled", "wording": "Shipment was cancelled", "language": "en", "stage": "exception", "confirmedBy": "bundle", "note": "The tracker's label." },
+    { "code": "delivery/oversized", "wording": "Parcel is oversized", "language": "en", "confirmedBy": "bundle", "note": "Left without a stage: the tracker's code names the milestone without a label, and no reply showed it." }
+  ]
 }

package/dist/core/catalog/statusMaps.js

@@ -55,6 +55,7 @@ import { statusMap as thailandPost } from '../../carriers/thailand-post/status.j
 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 vintedGo } from '../../carriers/vinted-go/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';
@@ -67,7 +68,7 @@ export const STATUS_MAPS = {
     emile, 'fan-courier': fanCourier, foxpost, 'geniki-taxydromiki': geniki, 'gls-it': glsIt, 'gofo-fr': gofoFr, 'gofo-it': gofoIt, helthjem,
     'j-and-t': jAndT, 'j-and-t-cargo': jntCargo, 'la-poste': laPoste, matkahuolto, 'old-dominion': oldDominion, omgo, omniva,
     'orlen-paczka': orlenPaczka, postlogistics, ppl, ptt, sagawa, sameday, speedx, speedy, sto, 'swiss-post': swissPost, 'thailand-post': thailandPost,
-    tnt, ups, venipak, yunexpress, 'yurtici-kargo': yurticiKargo,
+    tnt, ups, venipak, 'vinted-go': vintedGo, yunexpress, 'yurtici-kargo': yurticiKargo,
 };
 /** The carrier the app files the universal providers' scans under. */
 const UNIVERSAL_CARRIER = 'unknown';

package/dist/data/catalog.json

@@ -8105,7 +8105,8 @@
         "timezone": "Europe/Paris",
         "tracking": {
             "mode": "automatic",
-            "adapter": "universal"
+            "adapter": "vinted-go",
+            "recognitionRank": 72
         },
         "canaryUrl": "https://vintedgo.com/en/tracking",
         "trackingUrlTemplate": "https://vintedgo.com/en/tracking/{trackingNumber}",

package/dist/generated/catalog.d.ts

@@ -5438,7 +5438,8 @@ export declare const CARRIER_CATALOG: {
         readonly timezone: "Europe/Paris";
         readonly tracking: {
             readonly mode: "automatic";
-            readonly adapter: "universal";
+            readonly adapter: "vinted-go";
+            readonly recognitionRank: 72;
         };
         readonly canaryUrl: "https://vintedgo.com/en/tracking";
         readonly trackingUrlTemplate: "https://vintedgo.com/en/tracking/{trackingNumber}";

package/dist/generated/catalog.js

@@ -8106,7 +8106,8 @@ export const CARRIER_CATALOG = {
         "timezone": "Europe/Paris",
         "tracking": {
             "mode": "automatic",
-            "adapter": "universal"
+            "adapter": "vinted-go",
+            "recognitionRank": 72
         },
         "canaryUrl": "https://vintedgo.com/en/tracking",
         "trackingUrlTemplate": "https://vintedgo.com/en/tracking/{trackingNumber}",

package/dist/generated/recognition.js

@@ -73,5 +73,6 @@ export const CARRIER_RECOGNITION_RANKS = {
     "ukrposhta": 5,
     "uniuni": 33,
     "venipak": 63,
+    "vinted-go": 72,
     "yurtici-kargo": 66,
 };

package/dist/generated/registry.js

@@ -132,6 +132,7 @@ import { adapter as uniuni } from '../carriers/uniuni/adapter.js';
 import { adapter as ups } from '../carriers/ups/adapter.js';
 import { adapter as usps } from '../carriers/usps/adapter.js';
 import { adapter as venipak } from '../carriers/venipak/adapter.js';
+import { adapter as vintedGo } from '../carriers/vinted-go/adapter.js';
 import { adapter as xpressbees } from '../carriers/xpressbees/adapter.js';
 import { adapter as yamato } from '../carriers/yamato/adapter.js';
 import { adapter as yanwen } from '../carriers/yanwen/adapter.js';
@@ -274,6 +275,7 @@ export const REGISTRY = {
         "ups": ups,
         "usps": usps,
         "venipak": venipak,
+        "vinted-go": vintedGo,
         "xpressbees": xpressbees,
         "yamato": yamato,
         "yanwen": yanwen,
@@ -476,7 +478,7 @@ export const REGISTRY = {
         "ups": "ups",
         "usps": "usps",
         "venipak": "venipak",
-        "vinted-go": "universal",
+        "vinted-go": "vinted-go",
         "wanbexpress": "universal",
         "whistl": "universal",
         "xdp": "universal",

package/dist/server/openapi.json

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

package/package.json

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