universal-parcel-scraper 0.0.0-stage → 0.2.0

package/dist/carriers/heppner/carrier.json

@@ -0,0 +1,74 @@
+{
+  "id": "heppner",
+  "displayName": "Heppner",
+  "aliases": [
+    "Heppner Group"
+  ],
+  "region": {
+    "countries": [
+      "FR",
+      "CH"
+    ]
+  },
+  "brand": {
+    "color": "#005baa"
+  },
+  "selectable": true,
+  "timezone": "Europe/Paris",
+  "tracking": {
+    "mode": "automatic",
+    "adapter": "heppner",
+    "requirements": [
+      {
+        "field": "dpdPostcode",
+        "validator": "swissOrFrancePostcode",
+        "label": "Delivery postcode",
+        "type": "text",
+        "placeholder": "75001",
+        "help": "Heppner uses the recipient postcode to verify the shipment in France or Switzerland.",
+        "pattern": "^[0-9]{4,5}$",
+        "maxLength": 5,
+        "inputMode": "numeric",
+        "autoComplete": "postal-code"
+      }
+    ],
+    "steps": [
+      "direct"
+    ]
+  },
+  "capabilities": [
+    "history",
+    "provider_code"
+  ],
+  "portal": {
+    "url": "https://www.heppner-group.com/destinataire-suivez-votre-marchandise/",
+    "canaryUrl": "https://myportal.heppner-group.com/tracking",
+    "shows": [
+      "status",
+      "history",
+      "sender_name",
+      "recipient_name",
+      "recipient_address",
+      "delivery_instructions"
+    ],
+    "scraped": [
+      "status",
+      "history"
+    ],
+    "discarded": [
+      "sender_name",
+      "recipient_name",
+      "recipient_address",
+      "delivery_instructions"
+    ],
+    "unavailable": []
+  },
+  "links": [],
+  "detection": [
+    {
+      "id": "heppner-1",
+      "pattern": "^\\d{8}$",
+      "confidence": "low"
+    }
+  ]
+}

package/dist/carriers/heppner/numbers.json

@@ -0,0 +1,39 @@
+{
+  "carrier": "heppner",
+  "records": [
+    {
+      "number": "23456789",
+      "role": "shipment",
+      "evidence": "synthetic",
+      "derivedFrom": "invented",
+      "shapeConfirmed": "2026-09-10",
+      "expect": {
+        "carrier": "unknown",
+        "confidence": "low",
+        "candidates": [
+          "mondial-relay",
+          "heppner"
+        ]
+      },
+      "note": "Invented placeholder used as a shape check. Filed under Heppner, which stays one candidate among several."
+    },
+    {
+      "number": "25631818",
+      "role": "shipment",
+      "evidence": "public_shipment_report",
+      "source": {
+        "url": "https://www.trustpilot.com/reviews/6a6485a6cfb88b339bde0519",
+        "date": "2026-07-25"
+      },
+      "expect": {
+        "carrier": "unknown",
+        "confidence": "low",
+        "candidates": [
+          "mondial-relay",
+          "heppner"
+        ]
+      },
+      "note": "Publicly reported shipment number; the attribution was not independently verified. The source attributes it to Heppner, which stays one candidate among several."
+    }
+  ]
+}

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

@@ -0,0 +1,28 @@
+/**
+ * Heppner milestone, state and event-code vocabulary → product stage.
+ *
+ * The public recipient endpoint sends three fields per scan: a `step` (the
+ * milestone reached), a `state` (the shipment-level state) and an event `code`
+ * whose prefix repeats the milestone. Mapping reads the milestone first and
+ * the code prefix second, so a code we have not seen inside a known milestone
+ * still lands on the right stage.
+ *
+ * The endpoint carries no human-readable wording, only these identifiers, so
+ * each mapped entry also supplies the English description we display. Anything
+ * unmapped keeps a neutral description and no explicit stage assignment beyond
+ * the transit default the previous implementation used.
+ */
+import type { CarrierStatus } from '../../core/result/index.js';
+import type { Stage } from '../../generated/catalog.js';
+export interface ClassifiedHeppnerEvent {
+    status: CarrierStatus;
+    stage: Stage;
+    description: string;
+}
+/**
+ * Normalize a provider step, state or event code. Values that are not an
+ * upper-case identifier become '' so they can never reach a result field.
+ */
+export declare function heppnerCode(value: unknown): string;
+/** Map one scan to a stage. Order matters: terminal milestones win over transit ones. */
+export declare function classifyHeppnerEvent(stepValue: unknown, stateValue: unknown, codeValue: unknown): ClassifiedHeppnerEvent;

package/dist/carriers/heppner/status.js

@@ -0,0 +1,43 @@
+import { cleanScalar } from '../../core/transport/index.js';
+/**
+ * Normalize a provider step, state or event code. Values that are not an
+ * upper-case identifier become '' so they can never reach a result field.
+ */
+export function heppnerCode(value) {
+    const normalized = cleanScalar(value, 64).toLocaleUpperCase('en-US');
+    return /^[A-Z0-9]{2,32}(?:_[A-Z0-9]{2,32})*$/.test(normalized) ? normalized : '';
+}
+/** Map one scan to a stage. Order matters: terminal milestones win over transit ones. */
+export function classifyHeppnerEvent(stepValue, stateValue, codeValue) {
+    const step = heppnerCode(stepValue);
+    const state = heppnerCode(stateValue);
+    const providerCode = heppnerCode(codeValue);
+    if (step === 'MARCHANDISE_RETOURNEE' || /^(?:SOL|RET)_/.test(providerCode)) {
+        return { status: 'exception', stage: 'returned', description: 'Returned to sender' };
+    }
+    if (step === 'LIVREE' || /^(?:LIV|POD)_/.test(providerCode)) {
+        return { status: 'delivered', stage: 'delivered', description: 'Delivered' };
+    }
+    if (state === 'ANOMALIE' || step === 'EN_ATTENTE_INSTRUCTIONS') {
+        return {
+            status: 'exception',
+            stage: 'exception',
+            description: step === 'EN_ATTENTE_INSTRUCTIONS'
+                ? 'Delivery instructions required'
+                : 'Shipment exception',
+        };
+    }
+    if (step === 'LIVRAISON' || providerCode.startsWith('MLV_')) {
+        return { status: 'out_for_delivery', stage: 'out_for_delivery', description: 'Out for delivery' };
+    }
+    if (step === 'PRISE_EN_CHARGE' || providerCode.startsWith('PCH_')) {
+        return { status: 'in_transit', stage: 'accepted', description: 'Shipment collected' };
+    }
+    if (step === 'MARCHANDISE_REEXPEDIEE') {
+        return { status: 'in_transit', stage: 'in_transit', description: 'Shipment forwarded' };
+    }
+    if (step === 'ACHEMINEMENT') {
+        return { status: 'in_transit', stage: 'in_transit', description: 'In transit' };
+    }
+    return { status: 'unknown', stage: 'in_transit', description: 'Heppner tracking update' };
+}

package/dist/carriers/heppner/statuses.json

@@ -0,0 +1,69 @@
+{
+  "carrier": "heppner",
+  "entries": [
+    {
+      "code": "MARCHANDISE_RETOURNEE",
+      "language": "fr",
+      "stage": "returned",
+      "confirmedBy": "fixture",
+      "firstSeen": "2026-09-12",
+      "note": "Milestone (step). Event codes prefixed SOL_ or RET_ map here too."
+    },
+    {
+      "code": "LIVREE",
+      "language": "fr",
+      "stage": "delivered",
+      "confirmedBy": "fixture",
+      "firstSeen": "2026-09-12",
+      "note": "Milestone (step). Event codes prefixed LIV_ or POD_ map here too."
+    },
+    {
+      "code": "EN_ATTENTE_INSTRUCTIONS",
+      "language": "fr",
+      "stage": "exception",
+      "confirmedBy": "fixture",
+      "firstSeen": "2026-09-12",
+      "note": "Milestone (step); shown as \"Delivery instructions required\". Reclassified to exception 2026-09-12."
+    },
+    {
+      "code": "ANOMALIE",
+      "language": "fr",
+      "stage": "exception",
+      "confirmedBy": "fixture",
+      "firstSeen": "2026-09-12",
+      "note": "Shipment-level state rather than a milestone; shown as \"Shipment exception\". Reclassified to exception 2026-09-12."
+    },
+    {
+      "code": "LIVRAISON",
+      "language": "fr",
+      "stage": "out_for_delivery",
+      "confirmedBy": "fixture",
+      "firstSeen": "2026-09-12",
+      "note": "Milestone (step). Event codes prefixed MLV_ map here too."
+    },
+    {
+      "code": "PRISE_EN_CHARGE",
+      "language": "fr",
+      "stage": "accepted",
+      "confirmedBy": "fixture",
+      "firstSeen": "2026-09-12",
+      "note": "Milestone (step). Event codes prefixed PCH_ map here too."
+    },
+    {
+      "code": "MARCHANDISE_REEXPEDIEE",
+      "language": "fr",
+      "stage": "in_transit",
+      "confirmedBy": "fixture",
+      "firstSeen": "2026-09-12",
+      "note": "Milestone (step); shown as \"Shipment forwarded\"."
+    },
+    {
+      "code": "ACHEMINEMENT",
+      "language": "fr",
+      "stage": "in_transit",
+      "confirmedBy": "fixture",
+      "firstSeen": "2026-09-12",
+      "note": "Milestone (step); shown as \"In transit\"."
+    }
+  ]
+}

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

@@ -0,0 +1,17 @@
+import type { AdapterFactory } from '../../core/adapter/index.js';
+import type { CarrierResult } from '../../core/result/index.js';
+import { hermesStatus } from './status.js';
+export { hermesStatus };
+export interface HermesOptions {
+    timeoutMs?: number;
+    /** Test seam; production uses the global fetch. */
+    fetcher?: typeof fetch;
+}
+export declare function parseHermesTrackingResponse(payload: unknown, trackingNumber: string): CarrierResult;
+export declare class HermesTracker {
+    #private;
+    readonly timeoutMs: number;
+    constructor(options?: number | HermesOptions);
+    fetch(trackingNumber: string): Promise<CarrierResult>;
+}
+export declare const adapter: AdapterFactory;

package/dist/carriers/hermes/adapter.js

@@ -0,0 +1,103 @@
+import { NotFoundError, SchemaError } from '../../core/errors/index.js';
+import { fetchBounded, parseJsonBytes } from '../../core/transport/index.js';
+import { isRecord } from '../../core/types.js';
+import { hermesEventStage, hermesStatus } from './status.js';
+export { hermesStatus };
+// Hermes Einrichtungs-Service (two-man furniture and white-goods delivery) is a
+// different company from Hermes Germany's parcel network; its public order
+// lookup lives on myhes.de and takes the consignment number alone.
+const HERMES_API = 'https://myhes.de/api/request/auftragsdaten';
+const PROVIDER = 'Hermes';
+const DEFAULT_TIMEOUT_MS = 15_000;
+function normalizeHermesTrackingNumber(raw) {
+    return String(raw ?? '').replace(/[\s.-]/g, '').toUpperCase();
+}
+export function parseHermesTrackingResponse(payload, trackingNumber) {
+    if (!isRecord(payload))
+        throw new SchemaError(PROVIDER, 'Hermes returned an invalid tracking response');
+    const body = isRecord(payload.body) ? payload.body : payload;
+    if (!isRecord(body.auftragsdaten)) {
+        throw new SchemaError(PROVIDER, 'Hermes returned an invalid tracking response');
+    }
+    const order = body.auftragsdaten;
+    if (!order.lieferscheinnummer
+        || normalizeHermesTrackingNumber(order.lieferscheinnummer)
+            !== normalizeHermesTrackingNumber(trackingNumber))
+        throw new SchemaError(PROVIDER, 'Hermes returned a different shipment');
+    const journey = isRecord(order.statusjourneyDto) ? order.statusjourneyDto : {};
+    if (journey.auftragstatusdaten !== undefined && !Array.isArray(journey.auftragstatusdaten)) {
+        throw new SchemaError(PROVIDER, 'Hermes returned invalid tracking history');
+    }
+    // Hermes's own public UI treats auftragstatusdaten as the customer-facing
+    // timeline. statusdaten contains a second, internal operational stream with
+    // duplicate scans and different identifiers, so it is intentionally ignored.
+    const rawEvents = Array.isArray(journey.auftragstatusdaten)
+        ? journey.auftragstatusdaten.filter(isRecord)
+        : [];
+    // The public API answers a valid, unknown 8- or 9-digit consignment with a
+    // synthetic order whose identifying/status fields are all null. Do not turn
+    // that placeholder into a real-looking pending parcel.
+    if (rawEvents.length === 0
+        && order.auftragId == null
+        && order.auftragsart == null
+        && order.statusjourneyDto == null)
+        throw new NotFoundError(PROVIDER);
+    const meaningfulEvents = rawEvents.filter((event) => (String(event.sendungsstatus ?? '').trim()
+        && String(event.sendungsstatusBuchungszeitpunkt ?? '').trim()));
+    meaningfulEvents.sort((left, right) => String(right.sendungsstatusBuchungszeitpunkt ?? '')
+        .localeCompare(String(left.sendungsstatusBuchungszeitpunkt ?? '')));
+    const events = meaningfulEvents.map((event) => ({
+        time: String(event.sendungsstatusBuchungszeitpunkt ?? ''),
+        location: '',
+        description: String(event.sendungsstatus),
+        stage: hermesEventStage(event.sendungsstatusId, event.sendungsstatus),
+    }));
+    return {
+        status: meaningfulEvents[0]
+            ? hermesStatus(meaningfulEvents[0].sendungsstatusId, meaningfulEvents[0].sendungsstatus)
+            : 'pending',
+        last_status_text: events[0]?.description ?? '',
+        last_update: events[0]?.time || null,
+        expected_delivery: typeof order.lieferdatum === 'string'
+            ? order.lieferdatum
+            : typeof order.hesBasicLieferterminZeit === 'string'
+                ? order.hesBasicLieferterminZeit
+                : null,
+        timezone: 'Europe/Berlin',
+        events,
+    };
+}
+export class HermesTracker {
+    timeoutMs;
+    #fetcher;
+    constructor(options = {}) {
+        const { timeoutMs = DEFAULT_TIMEOUT_MS, fetcher } = typeof options === 'number'
+            ? { timeoutMs: options, fetcher: undefined }
+            : options;
+        this.timeoutMs = timeoutMs;
+        this.#fetcher = fetcher;
+    }
+    async fetch(trackingNumber) {
+        const url = new URL(HERMES_API);
+        url.searchParams.set('parcelNumber', trackingNumber);
+        const { bytes } = await fetchBounded(url, {
+            headers: {
+                Accept: 'application/json',
+                'User-Agent': 'Mozilla/5.0 (compatible; SwissDeliveryTracker/1.0)',
+            },
+        }, {
+            provider: 'Hermes tracking',
+            timeoutMs: this.timeoutMs,
+            ...(this.#fetcher ? { fetcher: this.#fetcher } : {}),
+        });
+        return parseHermesTrackingResponse(parseJsonBytes(bytes, PROVIDER), trackingNumber);
+    }
+}
+export const adapter = (environment) => {
+    const tracker = new HermesTracker({ fetcher: environment.fetcher });
+    return {
+        id: 'hermes',
+        steps: ['direct'],
+        track: (input) => tracker.fetch(input.number),
+    };
+};

package/dist/carriers/hermes/carrier.json

@@ -0,0 +1,58 @@
+{
+  "id": "hermes",
+  "displayName": "Hermes Einrichtungs-Service",
+  "aliases": [
+    "HES",
+    "Hermes Einrichtungsservice"
+  ],
+  "region": {
+    "countries": [
+      "DE"
+    ]
+  },
+  "brand": {
+    "color": "#0091cd"
+  },
+  "selectable": true,
+  "timezone": "Europe/Berlin",
+  "tracking": {
+    "mode": "automatic",
+    "adapter": "hermes",
+    "steps": [
+      "direct"
+    ]
+  },
+  "capabilities": [
+    "history",
+    "eta"
+  ],
+  "portal": {
+    "url": "https://myhes.de/",
+    "canaryUrl": "https://myhes.de/",
+    "shows": [
+      "status",
+      "history",
+      "eta",
+      "sender_name",
+      "recipient_name",
+      "recipient_address",
+      "delivery_instructions"
+    ],
+    "scraped": [
+      "status",
+      "history",
+      "eta"
+    ],
+    "discarded": [
+      "sender_name",
+      "recipient_name",
+      "recipient_address",
+      "delivery_instructions"
+    ],
+    "unavailable": [
+      "location"
+    ]
+  },
+  "links": [],
+  "detection": []
+}

package/dist/carriers/hermes/numbers.json

@@ -0,0 +1,20 @@
+{
+  "carrier": "hermes",
+  "records": [
+    {
+      "number": "62162057330000611",
+      "role": "shipment",
+      "evidence": "synthetic",
+      "derivedFrom": "official_shape",
+      "shapeConfirmed": "2026-09-10",
+      "expect": {
+        "carrier": "unknown",
+        "confidence": "low",
+        "candidates": [
+          "dhl-ecommerce"
+        ]
+      },
+      "note": "Made-up number that follows the published format. Filed under Hermes Einrichtungs-Service, which no rule claims."
+    }
+  ]
+}

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

@@ -0,0 +1,15 @@
+/**
+ * Hermes Einrichtungs-Service status classification.
+ *
+ * The myhes.de order API returns a numeric `sendungsstatusId` per timeline row
+ * plus the German wording shown to the customer. The numeric map below is the
+ * authority; wording is only consulted for ids the map does not know, so a new
+ * id degrades to a sensible stage instead of an invented one.
+ */
+import type { CarrierStatus } from '../../core/result/index.js';
+import type { Stage } from '../../generated/catalog.js';
+/** Observed `sendungsstatusId` values and the status each one means. */
+export declare const HERMES_STATUS: Map<number, CarrierStatus>;
+export declare function hermesStatus(rawStatusId: unknown, rawDescription?: unknown): CarrierStatus;
+/** The event-level stage that follows from the row's status. */
+export declare function hermesEventStage(rawStatusId: unknown, rawDescription: unknown): Stage;

package/dist/carriers/hermes/status.js

@@ -0,0 +1,61 @@
+/** Observed `sendungsstatusId` values and the status each one means. */
+export const HERMES_STATUS = new Map([
+    [40, 'pending'],
+    [100, 'in_transit'],
+    [190, 'in_transit'],
+    [300, 'in_transit'],
+    [307, 'in_transit'],
+    [318, 'exception'],
+    [319, 'exception'],
+    [320, 'exception'],
+    [321, 'exception'],
+    [314, 'in_transit'],
+    [315, 'in_transit'],
+    [500, 'in_transit'],
+    [701, 'delivered'],
+    [702, 'delivered'],
+    [700, 'delivered'],
+    [720, 'delivered'],
+    [721, 'delivered'],
+    [722, 'delivered'],
+    [728, 'delivered'],
+    [731, 'delivered'],
+    [740, 'delivered'],
+    [742, 'delivered'],
+    [430, 'out_for_delivery'],
+]);
+function normalizedText(raw) {
+    return String(raw ?? '').toLocaleLowerCase('de-DE').normalize('NFKD').replace(/\p{M}/gu, '');
+}
+export function hermesStatus(rawStatusId, rawDescription = '') {
+    if (!['string', 'number'].includes(typeof rawStatusId))
+        return 'pending';
+    const statusId = Number(rawStatusId);
+    if (!Number.isFinite(statusId))
+        return 'pending';
+    const known = HERMES_STATUS.get(statusId);
+    if (known)
+        return known;
+    const description = normalizedText(rawDescription);
+    if (/(nicht zugestellt|fehlgeschlagen|storniert|retour|zuruck)/.test(description)) {
+        return 'exception';
+    }
+    if (/(erfolgreich zugestellt|ware geliefert|wurde .* zugestellt|delivered)/.test(description)) {
+        return 'delivered';
+    }
+    if (/(befindet sich auf tour|fahrzeugbeladung|ankunft bei kundenadresse|out for delivery)/
+        .test(description))
+        return 'out_for_delivery';
+    if (description)
+        return statusId === 40 ? 'pending' : 'in_transit';
+    return 'pending';
+}
+/** The event-level stage that follows from the row's status. */
+export function hermesEventStage(rawStatusId, rawDescription) {
+    const status = hermesStatus(rawStatusId, rawDescription);
+    if (status === 'exception')
+        return 'failed_attempt';
+    if (status === 'pending')
+        return 'registered';
+    return status;
+}

package/dist/carriers/hermes/statuses.json

@@ -0,0 +1,31 @@
+{
+  "carrier": "hermes",
+  "entries": [
+    { "code": "40", "stage": "registered", "confirmedBy": "prior-art", "firstSeen": "2026-08-30", "note": "Order announced; the only id that stays pending." },
+    { "code": "100", "stage": "in_transit", "confirmedBy": "prior-art", "firstSeen": "2026-08-30", "note": "" },
+    { "code": "190", "stage": "in_transit", "confirmedBy": "prior-art", "firstSeen": "2026-08-30", "note": "" },
+    { "code": "300", "stage": "in_transit", "confirmedBy": "prior-art", "firstSeen": "2026-08-30", "note": "" },
+    { "code": "307", "stage": "in_transit", "confirmedBy": "prior-art", "firstSeen": "2026-08-30", "note": "" },
+    { "code": "314", "stage": "in_transit", "confirmedBy": "prior-art", "firstSeen": "2026-08-30", "note": "" },
+    { "code": "315", "stage": "in_transit", "confirmedBy": "prior-art", "firstSeen": "2026-08-30", "note": "" },
+    { "code": "318", "stage": "failed_attempt", "confirmedBy": "prior-art", "firstSeen": "2026-08-30", "note": "Exception family 318-321." },
+    { "code": "319", "stage": "failed_attempt", "confirmedBy": "prior-art", "firstSeen": "2026-08-30", "note": "" },
+    { "code": "320", "stage": "failed_attempt", "confirmedBy": "prior-art", "firstSeen": "2026-08-30", "note": "" },
+    { "code": "321", "stage": "failed_attempt", "confirmedBy": "prior-art", "firstSeen": "2026-08-30", "note": "" },
+    { "code": "430", "stage": "out_for_delivery", "confirmedBy": "prior-art", "firstSeen": "2026-08-30", "note": "Delivery tour started." },
+    { "code": "500", "stage": "in_transit", "confirmedBy": "prior-art", "firstSeen": "2026-08-30", "note": "" },
+    { "code": "700", "wording": "Deine Sendung wurde erfolgreich zugestellt.", "language": "de", "stage": "delivered", "confirmedBy": "fixture", "firstSeen": "2026-08-30", "note": "The carrier's own published delivered sample." },
+    { "code": "701", "stage": "delivered", "confirmedBy": "prior-art", "firstSeen": "2026-08-30", "note": "" },
+    { "code": "702", "stage": "delivered", "confirmedBy": "prior-art", "firstSeen": "2026-08-30", "note": "" },
+    { "code": "720", "stage": "delivered", "confirmedBy": "prior-art", "firstSeen": "2026-08-30", "note": "" },
+    { "code": "721", "stage": "delivered", "confirmedBy": "prior-art", "firstSeen": "2026-08-30", "note": "" },
+    { "code": "722", "stage": "delivered", "confirmedBy": "prior-art", "firstSeen": "2026-08-30", "note": "" },
+    { "code": "728", "stage": "delivered", "confirmedBy": "prior-art", "firstSeen": "2026-08-30", "note": "" },
+    { "code": "731", "stage": "delivered", "confirmedBy": "prior-art", "firstSeen": "2026-08-30", "note": "" },
+    { "code": "740", "stage": "delivered", "confirmedBy": "prior-art", "firstSeen": "2026-08-30", "note": "" },
+    { "code": "742", "stage": "delivered", "confirmedBy": "prior-art", "firstSeen": "2026-08-30", "note": "" },
+    { "wording": "nicht zugestellt / fehlgeschlagen / storniert / retour / zurück", "language": "de", "stage": "failed_attempt", "confirmedBy": "prior-art", "firstSeen": "2026-08-30", "note": "Fallback for ids the numeric map does not know." },
+    { "wording": "erfolgreich zugestellt / Ware geliefert / wurde … zugestellt / delivered", "language": "de", "stage": "delivered", "confirmedBy": "prior-art", "firstSeen": "2026-08-30", "note": "Fallback for ids the numeric map does not know." },
+    { "wording": "befindet sich auf Tour / Fahrzeugbeladung / Ankunft bei Kundenadresse / out for delivery", "language": "de", "stage": "out_for_delivery", "confirmedBy": "prior-art", "firstSeen": "2026-08-30", "note": "Fallback for ids the numeric map does not know." }
+  ]
+}

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

@@ -0,0 +1,22 @@
+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 HermesGermanyOptions {
+    timeoutMs?: number;
+    /** Test seam; production uses the global fetch. */
+    fetcher?: typeof fetch;
+}
+export { STATUSES } from './status.js';
+/** Kept as a named class: the grouped live suite asserts this error's name. */
+export declare class HermesGermanyTrackingError extends NotFoundError {
+    constructor();
+}
+export declare function normalizeHermesGermanyNumber(raw: string): string;
+export declare function parseHermesGermanyResponse(payload: unknown, trackingNumber: string): CarrierResult;
+export declare class HermesGermanyTracker {
+    #private;
+    readonly timeoutMs: number;
+    constructor(options?: number | HermesGermanyOptions);
+    fetch(trackingNumber: string): Promise<CarrierResult>;
+}
+export declare const adapter: AdapterFactory;