universal-parcel-scraper 0.0.0-stage → 0.2.0

package/dist/carriers/gls-ch/statuses.json

@@ -0,0 +1,31 @@
+{
+  "carrier": "gls-ch",
+  "entries": [
+    { "code": "PREADVICE", "stage": "registered", "confirmedBy": "fixture", "firstSeen": "2026-08-30", "note": "Data entered, parcel not yet with GLS." },
+    { "code": "PLANNEDPICKUP", "stage": "registered", "confirmedBy": "prior-art", "firstSeen": "2026-08-30", "note": "" },
+    { "code": "NOTPICKEDUP", "stage": "returned", "confirmedBy": "prior-art", "firstSeen": "2026-08-30", "note": "Uncollected; reported as status 'exception'." },
+    { "code": "INPICKUP", "stage": "accepted", "confirmedBy": "prior-art", "firstSeen": "2026-08-30", "note": "" },
+    { "code": "INTRANSIT", "stage": "in_transit", "confirmedBy": "fixture", "firstSeen": "2026-08-30", "note": "" },
+    { "code": "INWAREHOUSE", "stage": "in_transit", "confirmedBy": "fixture", "firstSeen": "2026-08-30", "note": "Final parcel center." },
+    { "code": "INDELIVERY", "stage": "out_for_delivery", "confirmedBy": "fixture", "firstSeen": "2026-08-30", "note": "" },
+    { "code": "DELIVERED", "wording": "The parcel has been delivered.", "language": "en", "stage": "delivered", "confirmedBy": "fixture", "firstSeen": "2026-08-30", "note": "" },
+    { "code": "DELIVEREDPS", "wording": "The parcel is ready for collection at the ParcelShop.", "language": "en", "stage": "ready_for_pickup", "confirmedBy": "fixture", "firstSeen": "2026-08-30", "note": "ParcelShop/locker arrival. GLS labels it 'delivered'; the recipient does not have it yet, so it is reported as status 'out_for_delivery'." },
+    { "code": "NOTDELIVERED", "stage": "failed_attempt", "confirmedBy": "fixture", "firstSeen": "2026-08-30", "note": "" },
+    { "code": "RETURNED", "stage": "returned", "confirmedBy": "prior-art", "firstSeen": "2026-08-30", "note": "" },
+    { "code": "CANCELED", "stage": "returned", "confirmedBy": "prior-art", "firstSeen": "2026-08-30", "note": "Both spellings appear." },
+    { "code": "CANCELLED", "stage": "returned", "confirmedBy": "prior-art", "firstSeen": "2026-08-30", "note": "Both spellings appear." },
+    { "code": "FINAL", "stage": "returned", "confirmedBy": "prior-art", "firstSeen": "2026-08-30", "note": "" },
+    { "code": "NORECORD", "stage": "pending", "confirmedBy": "prior-art", "firstSeen": "2026-08-30", "note": "Reported as status 'unknown'." },
+    { "wording": "The parcel has not been handed over to GLS.", "language": "en", "confirmedBy": "fixture", "firstSeen": "2026-08-30", "note": "Deliberately unmapped: a negative handoff does not prove GLS possession. Reported as status 'unknown' with stage in_transit." },
+    { "wording": "The parcel was handed over to GLS.", "language": "en", "stage": "accepted", "confirmedBy": "fixture", "firstSeen": "2026-08-30", "note": "Wording rule for rows with no status code." },
+    { "wording": "The parcel data was entered into the GLS IT system…", "language": "en", "stage": "registered", "confirmedBy": "fixture", "firstSeen": "2026-08-30", "note": "Wording rule; contains 'not yet handed over to GLS' and must not read as a handoff." },
+    { "wording": "The parcel was released by customs.", "language": "en", "stage": "in_transit", "confirmedBy": "fixture", "firstSeen": "2026-08-30", "note": "Release is completion, not active clearance." },
+    { "wording": "The parcel has not been released by customs.", "language": "en", "stage": "customs", "confirmedBy": "fixture", "firstSeen": "2026-08-30", "note": "Negated release stays in customs." },
+    { "wording": "Customs Consignment via Customs Portal", "language": "en", "stage": "customs", "confirmedBy": "fixture", "firstSeen": "2026-08-30", "note": "" },
+    { "wording": "The parcel has reached / left the parcel center; depot", "language": "en", "stage": "in_transit", "confirmedBy": "fixture", "firstSeen": "2026-08-30", "note": "Wording rule." },
+    { "wording": "The parcel is in delivery.", "language": "en", "stage": "out_for_delivery", "confirmedBy": "fixture", "firstSeen": "2026-08-30", "note": "Wording rule." },
+    { "wording": "ready for pickup / parcelshop / locker", "language": "en", "stage": "ready_for_pickup", "confirmedBy": "prior-art", "firstSeen": "2026-08-30", "note": "Wording rule." },
+    { "wording": "returned to sender / cancelled / delivery failed / not delivered", "language": "en", "stage": "returned", "confirmedBy": "prior-art", "firstSeen": "2026-08-30", "note": "Returns take 'returned'; the other phrases take 'failed_attempt'. Checked before the broad 'delivered' word." },
+    { "wording": "any other wording", "confirmedBy": "prior-art", "firstSeen": "2026-08-30", "note": "Falls through to the package's shared multilingual classifier (core/status); if that also declines, the row is reported as status 'unknown' with stage in_transit and recorded for review." }
+  ]
+}

package/dist/carriers/gls-de/adapter.d.ts

@@ -0,0 +1,28 @@
+import type { AdapterFactory } from '../../core/adapter/index.js';
+import { NotFoundError } from '../../core/errors/index.js';
+import type { CarrierResult } from '../../core/result/index.js';
+export interface GLSGermanyOptions {
+    timeoutMs?: number;
+    now?: () => number;
+    /** Test seam; production uses the global fetch. */
+    fetcher?: typeof fetch;
+}
+/** Kept as a named class: the host's grouped live suite asserts this error's name. */
+export declare class GLSGermanyTrackingError extends NotFoundError {
+    constructor();
+}
+export declare class GLSGermanyTracker {
+    #private;
+    readonly timeoutMs: number;
+    readonly now: () => number;
+    constructor(options?: number | GLSGermanyOptions);
+    fetch(rawTrackingNumber: string, rawPostcode: string): Promise<CarrierResult>;
+    /**
+     * Whether GLS Germany itself recognizes an ambiguous numeric shape. Used by
+     * the host's carrier-detection route, which promotes a number to `gls-de`
+     * only after this returns true; a provider failure must stay a failure.
+     */
+    recognizes(rawTrackingNumber: string): Promise<boolean>;
+    private request;
+}
+export declare const adapter: AdapterFactory;

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

@@ -0,0 +1,113 @@
+import { NotFoundError, SchemaError, UpstreamHttpError } from '../../core/errors/index.js';
+import { fetchBounded, parseJsonBytes } from '../../core/transport/index.js';
+import { isRecord } from '../../core/types.js';
+import { glsSwitzerlandDetailApiUrl, glsDeliveryReference, glsSwitzerlandOverviewApiUrl, GLSSwitzerlandTrackingError, normalizeGLSSwitzerlandPostcode, normalizeGLSSwitzerlandTrackingNumber, parseGLSSwitzerlandTrackingResponse, selectGLSParcel, } from '../gls-ch/adapter.js';
+// GLS's GROUP recipient service covers German and Swiss parcels. Keep the
+// shared response parser; the delivery postcode can be Swiss or German.
+const PROVIDER = 'GLS Germany tracking';
+const CARRIER = 'GLS Germany';
+const DEFAULT_TIMEOUT_MS = 15_000;
+/** Kept as a named class: the host's grouped live suite asserts this error's name. */
+export class GLSGermanyTrackingError extends NotFoundError {
+    constructor() {
+        super(CARRIER);
+        this.name = 'GLSGermanyTrackingError';
+    }
+}
+export class GLSGermanyTracker {
+    timeoutMs;
+    now;
+    #fetcher;
+    constructor(options = {}) {
+        const { timeoutMs = DEFAULT_TIMEOUT_MS, now = Date.now, fetcher } = typeof options === 'number'
+            ? { timeoutMs: options, now: Date.now, fetcher: undefined }
+            : options;
+        if (!Number.isFinite(timeoutMs) || timeoutMs <= 0)
+            throw new TypeError('GLS Germany timeout must be positive');
+        this.timeoutMs = timeoutMs;
+        this.now = now;
+        this.#fetcher = fetcher;
+    }
+    async fetch(rawTrackingNumber, rawPostcode) {
+        const number = normalizeGLSSwitzerlandTrackingNumber(rawTrackingNumber);
+        const postcode = normalizeGLSSwitzerlandPostcode(rawPostcode, '4,5');
+        const overview = await this.request(glsSwitzerlandOverviewApiUrl(number, this.now()));
+        // Validate the overview identity before resolving a Track ID to a parcel number.
+        try {
+            parseGLSSwitzerlandTrackingResponse(overview, number);
+        }
+        catch (error) {
+            if (error instanceof GLSSwitzerlandTrackingError)
+                throw new GLSGermanyTrackingError();
+            throw error;
+        }
+        if (!isRecord(overview) || !Array.isArray(overview.tuStatus)) {
+            throw new SchemaError(CARRIER, 'GLS Germany returned an invalid overview');
+        }
+        const parcel = selectGLSParcel(overview, number);
+        if (!parcel || !/^\d{11,14}$/.test(String(parcel.tuNo))) {
+            throw new SchemaError(CARRIER, 'GLS Germany did not return a numeric parcel number');
+        }
+        const owners = Array.isArray(parcel.owners) ? parcel.owners.filter(isRecord) : [];
+        const owner = owners.find((row) => row.type === 'REQUEST');
+        const detail = await this.request(glsSwitzerlandDetailApiUrl(String(parcel.tuNo), postcode, this.now(), String(owner?.code ?? ''), '4,5'));
+        try {
+            const result = parseGLSSwitzerlandTrackingResponse(detail, String(parcel.tuNo));
+            // Both services use CET/CEST; expose the regional timezone to clients.
+            return { ...result, ...glsDeliveryReference(parseGLSSwitzerlandTrackingResponse(overview, number)), timezone: 'Europe/Berlin' };
+        }
+        catch (error) {
+            if (error instanceof GLSSwitzerlandTrackingError)
+                throw new GLSGermanyTrackingError();
+            throw error;
+        }
+    }
+    /**
+     * Whether GLS Germany itself recognizes an ambiguous numeric shape. Used by
+     * the host's carrier-detection route, which promotes a number to `gls-de`
+     * only after this returns true; a provider failure must stay a failure.
+     */
+    async recognizes(rawTrackingNumber) {
+        const number = normalizeGLSSwitzerlandTrackingNumber(rawTrackingNumber);
+        try {
+            const url = glsSwitzerlandOverviewApiUrl(number, this.now()).replace('/GROUP/en/', '/DE/en/');
+            const overview = await this.request(url);
+            const result = parseGLSSwitzerlandTrackingResponse(overview, number);
+            return result.status !== 'unknown';
+        }
+        catch (error) {
+            if (error instanceof GLSGermanyTrackingError || error instanceof GLSSwitzerlandTrackingError)
+                return false;
+            throw error;
+        }
+    }
+    async request(url) {
+        const { response, bytes } = await fetchBounded(url, {
+            headers: { Accept: 'application/json', Referer: 'https://gls-group.eu/EU/en/parcel-tracking' },
+        }, {
+            provider: PROVIDER,
+            timeoutMs: this.timeoutMs,
+            maxBytes: 1_000_000,
+            allowHttpError: true,
+            ...(this.#fetcher ? { fetcher: this.#fetcher } : {}),
+        });
+        // A challenge, invalid postcode, rate limit or outage must not become "not found".
+        if (response.status === 404) {
+            const payload = parseJsonBytes(bytes, PROVIDER);
+            if (isRecord(payload) && payload.lastError === 'E000')
+                throw new GLSGermanyTrackingError();
+        }
+        if (!response.ok)
+            throw new UpstreamHttpError(PROVIDER, response.status);
+        return parseJsonBytes(bytes, PROVIDER);
+    }
+}
+export const adapter = (environment) => {
+    const tracker = new GLSGermanyTracker({ fetcher: environment.fetcher });
+    return {
+        id: 'gls-de',
+        steps: ['direct'],
+        track: (input) => tracker.fetch(input.number, input.postcode ?? ''),
+        recognize: async (number) => ({ known: await tracker.recognizes(number) }),
+    };
+};

package/dist/carriers/gls-de/carrier.json

@@ -0,0 +1,126 @@
+{
+  "id": "gls-de",
+  "displayName": "GLS Germany",
+  "aliases": [
+    "General Logistics Systems",
+    "GLS Group"
+  ],
+  "region": {
+    "countries": [
+      "DE"
+    ]
+  },
+  "brand": {
+    "color": "#ffdd00"
+  },
+  "selectable": true,
+  "timezone": "Europe/Berlin",
+  "tracking": {
+    "mode": "automatic",
+    "adapter": "gls-de",
+    "requirements": [
+      {
+        "field": "dpdPostcode",
+        "validator": "swissOrFrancePostcode",
+        "label": "Delivery postcode",
+        "type": "text",
+        "placeholder": "10115",
+        "help": "GLS requires the four- or five-digit delivery postcode to show the detailed event history.",
+        "pattern": "^[0-9]{4,5}$",
+        "maxLength": 5,
+        "inputMode": "numeric",
+        "autoComplete": "postal-code"
+      }
+    ],
+    "steps": [
+      "direct"
+    ],
+    "recognition": {
+      "rank": 50
+    },
+    "refresh": {
+      "minMinutes": 60,
+      "afterFailureMinutes": 240
+    }
+  },
+  "capabilities": [
+    "history",
+    "location",
+    "eta",
+    "pickup_point",
+    "weight",
+    "delivered_at",
+    "provider_code"
+  ],
+  "portal": {
+    "url": "https://gls-group.eu/DE/de/paketverfolgung?match={trackingNumber}",
+    "canaryUrl": "https://gls-group.eu/EU/en/parcel-tracking",
+    "shows": [
+      "status",
+      "history",
+      "location",
+      "eta",
+      "pickup_point",
+      "weight",
+      "recipient_name",
+      "recipient_address",
+      "recipient_contact",
+      "signature",
+      "customer_reference"
+    ],
+    "scraped": [
+      "status",
+      "history",
+      "location",
+      "eta",
+      "pickup_point",
+      "weight",
+      "delivered_at",
+      "provider_code"
+    ],
+    "discarded": [
+      "recipient_name",
+      "recipient_address",
+      "recipient_contact",
+      "signature",
+      "customer_reference"
+    ],
+    "unavailable": []
+  },
+  "links": [
+    {
+      "domains": [
+        "gls-group.eu",
+        "gls-group.com"
+      ],
+      "pathPattern": "^/DE/",
+      "params": [
+        "match",
+        "parcelNumber",
+        "matchParcelNumber"
+      ]
+    },
+    {
+      "domains": [
+        "gls-pakete.de"
+      ],
+      "params": [
+        "match",
+        "trackingNumber"
+      ]
+    }
+  ],
+  "detection": [
+    {
+      "id": "gls-de-1",
+      "pattern": "^(?:(?=[A-Z0-9]{8}$)(?=.*[A-Z])(?=.*\\d)[A-Z0-9]{8}|\\d{11})$",
+      "confidence": "low"
+    },
+    {
+      "id": "gls-de-2",
+      "pattern": "^\\d{12}$",
+      "confidence": "low",
+      "checksum": "gls"
+    }
+  ]
+}

package/dist/carriers/gls-de/numbers.json

@@ -0,0 +1,111 @@
+{
+  "carrier": "gls-de",
+  "records": [
+    {
+      "number": "10272483975",
+      "role": "shipment",
+      "evidence": "public_shipment_report",
+      "source": {
+        "url": "https://www.paketda.de/fragen-antworten.php?suche_carrier=gls"
+      },
+      "expect": {
+        "carrier": "unknown",
+        "confidence": "low",
+        "candidates": [
+          "postlogistics",
+          "gls-ch",
+          "gls-fr",
+          "gls-de",
+          "blue-dart",
+          "aramex"
+        ]
+      },
+      "note": "Publicly reported shipment number; the attribution was not independently verified. The source attributes it to GLS Germany, which stays one candidate among several."
+    },
+    {
+      "number": "123456789011",
+      "role": "shipment",
+      "evidence": "synthetic",
+      "derivedFrom": "invented",
+      "shapeConfirmed": "2026-09-12",
+      "expect": {
+        "carrier": "unknown",
+        "confidence": "low",
+        "candidates": [
+          "fedex",
+          "gls-ch",
+          "dpd-fr",
+          "mondial-relay",
+          "gls-fr",
+          "colis-prive",
+          "gls-de",
+          "mrw",
+          "purolator",
+          "sf-express",
+          "sto",
+          "zto",
+          "yamato",
+          "j-and-t"
+        ]
+      },
+      "note": "Invented 12-digit placeholder with a valid GLS check digit; the route only resolves it after a verified GLS lookup. Filed under GLS Germany, which stays one candidate among several."
+    },
+    {
+      "number": "28286849236",
+      "role": "shipment",
+      "evidence": "public_shipment_report",
+      "source": {
+        "url": "https://www.paketda.de/fragen-antworten.php?suche_carrier=gls"
+      },
+      "expect": {
+        "carrier": "unknown",
+        "confidence": "low",
+        "candidates": [
+          "postlogistics",
+          "gls-ch",
+          "gls-fr",
+          "gls-de",
+          "blue-dart",
+          "aramex"
+        ]
+      },
+      "note": "Publicly reported shipment number; the attribution was not independently verified. The source attributes it to GLS, which stays one candidate among several."
+    },
+    {
+      "number": "YVMNN4RO",
+      "role": "shipment",
+      "evidence": "public_shipment_report",
+      "source": {
+        "url": "https://www.paketda.de/fragen-antworten.php?suche=YVMNN4RO"
+      },
+      "expect": {
+        "carrier": "unknown",
+        "confidence": "low",
+        "candidates": [
+          "gls-ch",
+          "gls-fr",
+          "gls-de"
+        ]
+      },
+      "note": "Publicly reported shipment number; the attribution was not independently verified. The source attributes it to GLS, which stays one candidate among several."
+    },
+    {
+      "number": "Z6E5E29R",
+      "role": "shipment",
+      "evidence": "public_shipment_report",
+      "source": {
+        "url": "https://www.paketda.de/fragen-antworten.php?suche_carrier=gls"
+      },
+      "expect": {
+        "carrier": "unknown",
+        "confidence": "low",
+        "candidates": [
+          "gls-ch",
+          "gls-fr",
+          "gls-de"
+        ]
+      },
+      "note": "Publicly reported shipment number; the attribution was not independently verified. The source attributes it to GLS Germany, which stays one candidate among several."
+    }
+  ]
+}

package/dist/carriers/gls-de/status.d.ts

@@ -0,0 +1,10 @@
+/**
+ * GLS Germany status classification.
+ *
+ * Germany and Switzerland are served by the same GROUP recipient service, so
+ * there is one map for both and it lives in the Swiss folder. This module
+ * re-exports it so a reader of this folder finds the vocabulary where the
+ * skeleton says it should be, without a second copy to keep in step.
+ * The observed entries are listed in this folder's `statuses.json`.
+ */
+export { classifyDescription, GLS_STATUSES, glsSwitzerlandStatus as glsGermanyStatus, statusCode, type ClassifiedStatus, } from '../gls-ch/status.js';

package/dist/carriers/gls-de/status.js

@@ -0,0 +1,10 @@
+/**
+ * GLS Germany status classification.
+ *
+ * Germany and Switzerland are served by the same GROUP recipient service, so
+ * there is one map for both and it lives in the Swiss folder. This module
+ * re-exports it so a reader of this folder finds the vocabulary where the
+ * skeleton says it should be, without a second copy to keep in step.
+ * The observed entries are listed in this folder's `statuses.json`.
+ */
+export { classifyDescription, GLS_STATUSES, glsSwitzerlandStatus as glsGermanyStatus, statusCode, } from '../gls-ch/status.js';

package/dist/carriers/gls-de/statuses.json

@@ -0,0 +1,31 @@
+{
+  "carrier": "gls-de",
+  "entries": [
+    { "code": "PREADVICE", "stage": "registered", "confirmedBy": "fixture", "firstSeen": "2026-08-30", "note": "Data entered, parcel not yet with GLS." },
+    { "code": "PLANNEDPICKUP", "stage": "registered", "confirmedBy": "prior-art", "firstSeen": "2026-08-30", "note": "" },
+    { "code": "NOTPICKEDUP", "stage": "returned", "confirmedBy": "prior-art", "firstSeen": "2026-08-30", "note": "Uncollected; reported as status 'exception'." },
+    { "code": "INPICKUP", "stage": "accepted", "confirmedBy": "prior-art", "firstSeen": "2026-08-30", "note": "" },
+    { "code": "INTRANSIT", "stage": "in_transit", "confirmedBy": "fixture", "firstSeen": "2026-08-30", "note": "" },
+    { "code": "INWAREHOUSE", "stage": "in_transit", "confirmedBy": "fixture", "firstSeen": "2026-08-30", "note": "Final parcel center." },
+    { "code": "INDELIVERY", "stage": "out_for_delivery", "confirmedBy": "fixture", "firstSeen": "2026-08-30", "note": "" },
+    { "code": "DELIVERED", "wording": "The parcel has been delivered.", "language": "en", "stage": "delivered", "confirmedBy": "fixture", "firstSeen": "2026-08-30", "note": "" },
+    { "code": "DELIVEREDPS", "wording": "The parcel is ready for collection at the ParcelShop.", "language": "en", "stage": "ready_for_pickup", "confirmedBy": "fixture", "firstSeen": "2026-08-30", "note": "ParcelShop/locker arrival. GLS labels it 'delivered'; the recipient does not have it yet, so it is reported as status 'out_for_delivery'." },
+    { "code": "NOTDELIVERED", "stage": "failed_attempt", "confirmedBy": "fixture", "firstSeen": "2026-08-30", "note": "" },
+    { "code": "RETURNED", "stage": "returned", "confirmedBy": "prior-art", "firstSeen": "2026-08-30", "note": "" },
+    { "code": "CANCELED", "stage": "returned", "confirmedBy": "prior-art", "firstSeen": "2026-08-30", "note": "Both spellings appear." },
+    { "code": "CANCELLED", "stage": "returned", "confirmedBy": "prior-art", "firstSeen": "2026-08-30", "note": "Both spellings appear." },
+    { "code": "FINAL", "stage": "returned", "confirmedBy": "prior-art", "firstSeen": "2026-08-30", "note": "" },
+    { "code": "NORECORD", "stage": "pending", "confirmedBy": "prior-art", "firstSeen": "2026-08-30", "note": "Reported as status 'unknown'." },
+    { "wording": "The parcel has not been handed over to GLS.", "language": "en", "confirmedBy": "fixture", "firstSeen": "2026-08-30", "note": "Deliberately unmapped: a negative handoff does not prove GLS possession. Reported as status 'unknown' with stage in_transit." },
+    { "wording": "The parcel was handed over to GLS.", "language": "en", "stage": "accepted", "confirmedBy": "fixture", "firstSeen": "2026-08-30", "note": "Wording rule for rows with no status code." },
+    { "wording": "The parcel data was entered into the GLS IT system…", "language": "en", "stage": "registered", "confirmedBy": "fixture", "firstSeen": "2026-08-30", "note": "Wording rule; contains 'not yet handed over to GLS' and must not read as a handoff." },
+    { "wording": "The parcel was released by customs.", "language": "en", "stage": "in_transit", "confirmedBy": "fixture", "firstSeen": "2026-08-30", "note": "Release is completion, not active clearance." },
+    { "wording": "The parcel has not been released by customs.", "language": "en", "stage": "customs", "confirmedBy": "fixture", "firstSeen": "2026-08-30", "note": "Negated release stays in customs." },
+    { "wording": "Customs Consignment via Customs Portal", "language": "en", "stage": "customs", "confirmedBy": "fixture", "firstSeen": "2026-08-30", "note": "" },
+    { "wording": "The parcel has reached / left the parcel center; depot", "language": "en", "stage": "in_transit", "confirmedBy": "fixture", "firstSeen": "2026-08-30", "note": "Wording rule." },
+    { "wording": "The parcel is in delivery.", "language": "en", "stage": "out_for_delivery", "confirmedBy": "fixture", "firstSeen": "2026-08-30", "note": "Wording rule." },
+    { "wording": "ready for pickup / parcelshop / locker", "language": "en", "stage": "ready_for_pickup", "confirmedBy": "prior-art", "firstSeen": "2026-08-30", "note": "Wording rule." },
+    { "wording": "returned to sender / cancelled / delivery failed / not delivered", "language": "en", "stage": "returned", "confirmedBy": "prior-art", "firstSeen": "2026-08-30", "note": "Returns take 'returned'; the other phrases take 'failed_attempt'. Checked before the broad 'delivered' word." },
+    { "wording": "any other wording", "confirmedBy": "prior-art", "firstSeen": "2026-08-30", "note": "Falls through to the package's shared multilingual classifier (core/status); if that also declines, the row is reported as status 'unknown' with stage in_transit and recorded for review." }
+  ]
+}

package/dist/carriers/gls-fr/adapter.d.ts

@@ -0,0 +1,29 @@
+/**
+ * GLS France: the public consignee endpoint called by moncolis.gls-france.com.
+ *
+ * One bounded GET per lookup ('direct' step). The response carries the parcel
+ * record, its event list, and blocks describing the people involved; `parse()`
+ * builds its result from an explicit allowlist of status, timing and
+ * operational-location fields, so recipient names, street addresses, contacts,
+ * signatures and delivery instructions never leave this module.
+ */
+import type { AdapterFactory } from '../../core/adapter/index.js';
+import type { CarrierResult } from '../../core/result/index.js';
+export { glsFranceStatus } from './status.js';
+export declare function normalizeGLSFranceTrackingNumber(raw: string): string;
+export declare function glsFranceTrackingUrl(trackingNumber: string): string;
+export declare function glsFranceTrackingApiUrl(trackingNumber: string): string;
+export declare function parseGLSFranceTrackingResponse(payload: unknown, trackingNumber: string): CarrierResult;
+export interface GLSFranceTrackerOptions {
+    timeoutMs?: number;
+    /** Test seam; production uses the global fetch. */
+    fetcher?: typeof fetch;
+}
+export declare class GLSFranceTracker {
+    #private;
+    readonly timeoutMs: number;
+    constructor(options?: GLSFranceTrackerOptions);
+    fetch(trackingNumber: string): Promise<CarrierResult>;
+    private lookup;
+}
+export declare const adapter: AdapterFactory;