universal-parcel-scraper 0.0.0-stage → 0.2.0

package/dist/carriers/dtdc/statuses.json

@@ -0,0 +1,65 @@
+{
+  "carrier": "dtdc",
+  "entries": [
+    {
+      "wording": "Pickup Awaited",
+      "language": "en",
+      "stage": "registered",
+      "confirmedBy": "live"
+    },
+    {
+      "wording": "Pickup Scheduled",
+      "language": "en",
+      "stage": "registered",
+      "confirmedBy": "live"
+    },
+    {
+      "wording": "Booked",
+      "language": "en",
+      "stage": "registered",
+      "confirmedBy": "live"
+    },
+    {
+      "wording": "Booked at Origin Branch",
+      "language": "en",
+      "stage": "registered",
+      "confirmedBy": "live"
+    },
+    {
+      "wording": "Picked Up",
+      "language": "en",
+      "stage": "accepted",
+      "confirmedBy": "live"
+    },
+    {
+      "wording": "Pickup Completed",
+      "language": "en",
+      "stage": "accepted",
+      "confirmedBy": "live"
+    },
+    {
+      "wording": "In Transit",
+      "language": "en",
+      "stage": "in_transit",
+      "confirmedBy": "live"
+    },
+    {
+      "wording": "Out For Delivery",
+      "language": "en",
+      "stage": "out_for_delivery",
+      "confirmedBy": "live"
+    },
+    {
+      "wording": "Delivered",
+      "language": "en",
+      "stage": "delivered",
+      "confirmedBy": "live"
+    },
+    {
+      "wording": "RTO Booked",
+      "language": "en",
+      "stage": "exception",
+      "confirmedBy": "live"
+    }
+  ]
+}

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

@@ -0,0 +1,11 @@
+import type { AdapterFactory, TrackingContext } from '../../core/adapter/index.js';
+import { type StepRecorder } from '../../core/telemetry/index.js';
+export declare class EcoscootingTracker {
+    private readonly options;
+    constructor(options?: {
+        fetcher?: typeof fetch;
+        recorder?: StepRecorder;
+    });
+    fetch(raw: string, context?: TrackingContext): Promise<import("../../index.js").CarrierResult>;
+}
+export declare const adapter: AdapterFactory;

package/dist/carriers/ecoscooting/adapter.js

@@ -0,0 +1,42 @@
+import { SchemaError, TransportError, UpstreamHttpError } from '../../core/errors/index.js';
+import { runSteps } from '../../core/runner/index.js';
+import { NOOP_RECORDER } from '../../core/telemetry/index.js';
+import { fetchBounded, parseJsonBytes } from '../../core/transport/index.js';
+import { normalizeEcoscootingNumber, parseEcoscooting } from './parser.js';
+const ENDPOINT = 'https://de-link.cainiao.com/gateway/link.do';
+export class EcoscootingTracker {
+    options;
+    constructor(options = {}) {
+        this.options = options;
+    }
+    async fetch(raw, context = {}) {
+        const number = normalizeEcoscootingNumber(raw);
+        return runSteps({ carrier: 'ecoscooting', budgetMs: context.budgetMs ?? 15_000, signal: context.signal,
+            recorder: this.options.recorder ?? NOOP_RECORDER }, [{ id: 'direct', run: async ({ signal, remainingMs }) => {
+                    try {
+                        // Fixed public configuration from Ecoscooting's own anonymous client,
+                        // not an issued account credential or a guessed merchant signature.
+                        const body = new URLSearchParams({ logistics_interface: JSON.stringify({ mailNo: number, locale: 'en_US', role: 'endUser' }),
+                            msg_type: 'CN_OVERSEA_LOGISTICS_INQUIRY_TRACKING', logistic_provider_id: 'DISTRIBUTOR_30250031', data_digest: 'suibianxie', to_code: 'CNL_EU' });
+                        const { bytes } = await fetchBounded(ENDPOINT, { method: 'POST', signal, headers: { 'Content-Type': 'application/x-www-form-urlencoded' }, body: body.toString() }, { provider: 'Ecoscooting', timeoutMs: Math.max(1, Math.floor(remainingMs)), maxBytes: 1_000_000, fetcher: this.options.fetcher });
+                        let payload;
+                        try {
+                            payload = parseJsonBytes(bytes, 'Ecoscooting');
+                        }
+                        catch (cause) {
+                            throw new SchemaError('Ecoscooting', 'Ecoscooting returned invalid tracking JSON', { cause });
+                        }
+                        return parseEcoscooting(payload, number);
+                    }
+                    catch (error) {
+                        if (error instanceof UpstreamHttpError && [404, 410].includes(error.status))
+                            throw new TransportError('Ecoscooting', 'Ecoscooting tracking endpoint is unavailable', { cause: error });
+                        throw error;
+                    }
+                } }]);
+    }
+}
+export const adapter = environment => {
+    const tracker = new EcoscootingTracker({ fetcher: environment.fetcher, recorder: environment.recorder });
+    return { id: 'ecoscooting', recordsSteps: true, steps: ['direct'], track: (input, context) => tracker.fetch(input.number, context) };
+};

package/dist/carriers/ecoscooting/carrier.json

@@ -0,0 +1,76 @@
+{
+  "id": "ecoscooting",
+  "displayName": "Ecoscooting",
+  "aliases": [],
+  "region": {
+    "countries": [
+      "ES",
+      "PT"
+    ]
+  },
+  "brand": {
+    "color": "#3fa7ff"
+  },
+  "selectable": true,
+  "timezone": "UTC",
+  "tracking": {
+    "mode": "automatic",
+    "adapter": "ecoscooting",
+    "steps": [
+      "direct"
+    ],
+    "localClocks": true
+  },
+  "capabilities": [
+    "history",
+    "pickup_point",
+    "weight",
+    "delivered_at"
+  ],
+  "portal": {
+    "url": "https://ecoscooting.com/tracking/{trackingNumber}",
+    "canaryUrl": "https://ecoscooting.com/tracking/1",
+    "shows": [
+      "status",
+      "history",
+      "pickup_point",
+      "weight",
+      "delivered_at"
+    ],
+    "scraped": [
+      "status",
+      "history",
+      "pickup_point",
+      "weight",
+      "delivered_at"
+    ],
+    "discarded": [
+      "postcodes",
+      "coordinates",
+      "order_references",
+      "routing_features",
+      "pickup_code"
+    ],
+    "unavailable": []
+  },
+  "links": [
+    {
+      "domains": [
+        "ecoscooting.com"
+      ],
+      "path": "^/tracking/([^/?#]+)/?$"
+    }
+  ],
+  "detection": [
+    {
+      "id": "ecoscooting-1",
+      "pattern": "^\\d{18}$",
+      "confidence": "low"
+    },
+    {
+      "id": "ecoscooting-2",
+      "pattern": "^CN(?:ESP|PRT)\\d{20}$",
+      "confidence": "high"
+    }
+  ]
+}

package/dist/carriers/ecoscooting/numbers.json

@@ -0,0 +1,291 @@
+{
+  "carrier": "ecoscooting",
+  "records": [
+    {
+      "number": "024000000109776633",
+      "role": "shipment",
+      "evidence": "public_shipment_report",
+      "source": {
+        "url": "https://www.trustpilot.com/reviews/6ab43348dde9a585fb7ee200",
+        "date": "2026-09-23"
+      },
+      "expect": {
+        "carrier": "unknown",
+        "confidence": "low",
+        "candidates": [
+          "bpost",
+          "ecoscooting"
+        ]
+      },
+      "note": "The anonymous native gateway identifies this reference as an Ecoscooting parcel."
+    },
+    {
+      "number": "035010000109668280",
+      "role": "shipment",
+      "evidence": "public_shipment_report",
+      "source": {
+        "url": "https://www.trustpilot.com/reviews/6ab29a65ba413b1cba7cb0c5",
+        "date": "2026-09-22"
+      },
+      "expect": {
+        "carrier": "unknown",
+        "confidence": "low",
+        "candidates": [
+          "bpost",
+          "ecoscooting"
+        ]
+      },
+      "note": "The anonymous native gateway identifies this reference as an Ecoscooting parcel."
+    },
+    {
+      "number": "081730000038942441",
+      "role": "shipment",
+      "evidence": "public_shipment_report",
+      "source": {
+        "url": "https://www.ocu.org/reclamar/lista-reclamaciones-publicas/cuidado-con-ecoscooting/eec55dfee3121ef28c",
+        "date": "2025-09-09"
+      },
+      "expect": {
+        "carrier": "unknown",
+        "confidence": "low",
+        "candidates": [
+          "bpost",
+          "ecoscooting"
+        ]
+      },
+      "note": "Publicly reported shipment number; the attribution was not independently verified. The source attributes it to Ecoscooting, which stays one candidate among several."
+    },
+    {
+      "number": "081980000095765434",
+      "role": "shipment",
+      "evidence": "public_shipment_report",
+      "source": {
+        "url": "https://www.trustpilot.com/reviews/6a33fb70972ddd0b68268042",
+        "date": "2026-06-18"
+      },
+      "expect": {
+        "carrier": "unknown",
+        "confidence": "low",
+        "candidates": [
+          "bpost",
+          "ecoscooting"
+        ]
+      },
+      "note": "The anonymous native gateway identifies this reference as an Ecoscooting parcel."
+    },
+    {
+      "number": "083030000063547779",
+      "role": "shipment",
+      "evidence": "public_shipment_report",
+      "source": {
+        "url": "https://www.ocu.org/reclamar/lista-reclamaciones-publicas/pedido-nunca-llega/571d0533088b8ba848",
+        "date": "2025-12-30"
+      },
+      "expect": {
+        "carrier": "unknown",
+        "confidence": "low",
+        "candidates": [
+          "bpost",
+          "ecoscooting"
+        ]
+      },
+      "note": "Publicly reported shipment number; the attribution was not independently verified. The source attributes it to Ecoscooting, which stays one candidate among several."
+    },
+    {
+      "number": "083300000108897658",
+      "role": "shipment",
+      "evidence": "public_shipment_report",
+      "source": {
+        "url": "https://www.trustpilot.com/reviews/6ab4e2956837367f1f188fb5",
+        "date": "2026-09-24"
+      },
+      "expect": {
+        "carrier": "unknown",
+        "confidence": "low",
+        "candidates": [
+          "bpost",
+          "ecoscooting"
+        ]
+      },
+      "note": "The anonymous native gateway identifies this reference as an Ecoscooting parcel."
+    },
+    {
+      "number": "083920000098172383",
+      "role": "shipment",
+      "evidence": "public_shipment_report",
+      "source": {
+        "url": "https://www.trustpilot.com/reviews/6a47a16090acdf482c93b61b",
+        "date": "2026-07-03"
+      },
+      "expect": {
+        "carrier": "unknown",
+        "confidence": "low",
+        "candidates": [
+          "bpost",
+          "ecoscooting"
+        ]
+      },
+      "note": "The anonymous native gateway identifies this reference as an Ecoscooting parcel."
+    },
+    {
+      "number": "084700000100323091",
+      "role": "shipment",
+      "evidence": "public_shipment_report",
+      "source": {
+        "url": "https://www.trustpilot.com/reviews/6a53935f5e2987b1e2b40ce9",
+        "date": "2026-07-12"
+      },
+      "expect": {
+        "carrier": "unknown",
+        "confidence": "low",
+        "candidates": [
+          "bpost",
+          "ecoscooting"
+        ]
+      },
+      "note": "The anonymous native gateway identifies this reference as an Ecoscooting parcel."
+    },
+    {
+      "number": "174570000102955436",
+      "role": "shipment",
+      "evidence": "public_shipment_report",
+      "source": {
+        "url": "https://www.trustpilot.com/reviews/6a78466a8aaf5ffaf828e312",
+        "date": "2026-08-09"
+      },
+      "expect": {
+        "carrier": "unknown",
+        "confidence": "low",
+        "candidates": [
+          "bpost",
+          "ecoscooting"
+        ]
+      },
+      "note": "The anonymous native gateway identifies this reference as an Ecoscooting parcel."
+    },
+    {
+      "number": "289700000110328320",
+      "role": "shipment",
+      "evidence": "public_shipment_report",
+      "source": {
+        "url": "https://www.trustpilot.com/reviews/6aba48d1c0ccd119e8896bf1",
+        "date": "2026-09-28"
+      },
+      "expect": {
+        "carrier": "unknown",
+        "confidence": "low",
+        "candidates": [
+          "bpost",
+          "ecoscooting"
+        ]
+      },
+      "note": "The anonymous native gateway identifies this reference as an Ecoscooting parcel."
+    },
+    {
+      "number": "380030000066362966",
+      "role": "shipment",
+      "evidence": "public_shipment_report",
+      "source": {
+        "url": "https://www.ocu.org/reclamar/lista-reclamaciones-publicas/las-entregas-no-llegan-/a9ac02ca080289f896",
+        "date": "2026-03-22"
+      },
+      "expect": {
+        "carrier": "unknown",
+        "confidence": "low",
+        "candidates": [
+          "bpost",
+          "ecoscooting"
+        ]
+      },
+      "note": "Publicly reported shipment number; the attribution was not independently verified. The source attributes it to Ecoscooting, which stays one candidate among several."
+    },
+    {
+      "number": "380030000066782505",
+      "role": "shipment",
+      "evidence": "public_shipment_report",
+      "source": {
+        "url": "https://www.ocu.org/reclamar/lista-reclamaciones-publicas/las-entregas-no-llegan-/a9ac02ca080289f896",
+        "date": "2026-03-22"
+      },
+      "expect": {
+        "carrier": "unknown",
+        "confidence": "low",
+        "candidates": [
+          "bpost",
+          "ecoscooting"
+        ]
+      },
+      "note": "Publicly reported shipment number; the attribution was not independently verified. The source attributes it to Ecoscooting, which stays one candidate among several."
+    },
+    {
+      "number": "460150000103706789",
+      "role": "shipment",
+      "evidence": "public_shipment_report",
+      "source": {
+        "url": "https://www.trustpilot.com/reviews/6a834c5986b128939ce798fb",
+        "date": "2026-08-17"
+      },
+      "expect": {
+        "carrier": "unknown",
+        "confidence": "low",
+        "candidates": [
+          "bpost",
+          "ecoscooting"
+        ]
+      },
+      "note": "The anonymous native gateway identifies this reference as an Ecoscooting parcel."
+    },
+    {
+      "number": "CNESP00000123400000000001",
+      "role": "shipment",
+      "evidence": "synthetic",
+      "derivedFrom": "official_shape",
+      "shapeConfirmed": "2026-09-29",
+      "expect": {
+        "carrier": "ecoscooting",
+        "confidence": "high"
+      },
+      "note": "Made-up Spanish reference in the public CNESP layout, with zeros for the postcode digits."
+    },
+    {
+      "number": "CNPRT00000001234000000001",
+      "role": "shipment",
+      "evidence": "synthetic",
+      "derivedFrom": "official_shape",
+      "shapeConfirmed": "2026-09-29",
+      "expect": {
+        "carrier": "ecoscooting",
+        "confidence": "high"
+      },
+      "note": "Made-up Portuguese reference in the public CNPRT layout, with zeros for the postcode digits."
+    },
+    {
+      "number": "CNPRT19501971234009605248",
+      "role": "shipment",
+      "evidence": "public_shipment_report",
+      "source": {
+        "url": "https://www.deco.proteste.pt/reclamar/todas-as-reclamacoes/falsa-entrega/70a3a590891f3a8160",
+        "date": "2026-09-29"
+      },
+      "expect": {
+        "carrier": "ecoscooting",
+        "confidence": "high"
+      },
+      "note": "The anonymous native gateway identifies this Portuguese reference as an Ecoscooting parcel."
+    },
+    {
+      "number": "CQ343770772DE",
+      "role": "shipment",
+      "evidence": "public_shipment_report",
+      "source": {
+        "url": "https://www.ocu.org/reclamar/lista-reclamaciones-publicas/paquete-extraviado-cq34377077/a9305cbaea4cb4fa5a",
+        "date": "2025-01-09"
+      },
+      "expect": {
+        "carrier": "dhl",
+        "confidence": "high"
+      },
+      "note": "Publicly reported shipment number; the attribution was not independently verified. The source attributes it to Ecoscooting; detection selects DHL."
+    }
+  ]
+}

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

@@ -0,0 +1,3 @@
+import type { CarrierResult } from '../../core/result/index.js';
+export declare function normalizeEcoscootingNumber(raw: string): string;
+export declare function parseEcoscooting(payload: unknown, rawNumber: string): CarrierResult;

package/dist/carriers/ecoscooting/parser.js

@@ -0,0 +1,88 @@
+import { normalizeTrackingNumber } from '../../core/detection/index.js';
+import { IndeterminateError, SchemaError } from '../../core/errors/index.js';
+import { epochMillisTime } from '../../core/time/index.js';
+import { clean } from '../../core/transport/index.js';
+import { isRecord } from '../../core/types.js';
+import { ecoscootingStatus } from './status.js';
+const COLLECTED = ['PUDO Sign Success', 'Your shipment has been collected by consignee at the parcelshop'];
+/** Status name and description that confirm each completion code. */
+const COMPLETION_LABELS = new Map([
+    ['GTMS_SIGNED', ['Delivery Success', 'Parcel has been delivered successfully']],
+    ['LM_SIGN_SUCCESS', ['Delivery Success', 'Your shipment has been delivered successfully']],
+    ['GTMS_PUDO_SIGNED', COLLECTED],
+    ['PUDO_SIGN_SUCCESS', COLLECTED],
+]);
+/** Scans that place the parcel at a pickup point, in either code family. */
+const PICKUP_POINT_CODES = new Set(['GTMS_PUDO_INBOUND', 'GTMS_STA_SIGNED', 'GTMS_PUDO_SIGNED', 'GTMS_PUDO_OVERDUE',
+    'PUDO_INBOUND', 'PUDO_DELIVERY', 'PUDO_SIGN_SUCCESS', 'PUDO_OVERDUE']);
+export function normalizeEcoscootingNumber(raw) {
+    const number = normalizeTrackingNumber(raw);
+    if (!/^(?:\d{18}|CN(?:ESP|PRT)\d{20})$/.test(number))
+        throw new TypeError('Ecoscooting requires a numeric, CNESP or CNPRT parcel reference');
+    return number;
+}
+export function parseEcoscooting(payload, rawNumber) {
+    const number = normalizeEcoscootingNumber(rawNumber);
+    if (!isRecord(payload))
+        throw new SchemaError('Ecoscooting');
+    // The same query error is returned for absent and unavailable orders. It
+    // neither identifies a parcel nor proves that Ecoscooting does not know it.
+    if (payload.success !== 'true')
+        throw new IndeterminateError('Ecoscooting', 'Ecoscooting could not complete the tracking query');
+    if (!isRecord(payload.packageParam) || payload.packageParam.trackingNumber !== number)
+        throw new SchemaError('Ecoscooting', 'Ecoscooting returned a different parcel');
+    if (!Array.isArray(payload.statuses) || payload.statuses.length > 500 || !payload.statuses.every(isRecord))
+        throw new SchemaError('Ecoscooting');
+    if (!payload.statuses.length)
+        throw new IndeterminateError('Ecoscooting', 'Ecoscooting returned no parcel history');
+    const events = [];
+    const seen = new Set();
+    for (const row of payload.statuses) {
+        const code = clean(row.actionCode, 64);
+        const description = clean(row.description, 500) || clean(row.statusName, 500);
+        if (!code || !description)
+            throw new SchemaError('Ecoscooting', 'Ecoscooting returned an incomplete scan');
+        if (['trackingNumber', 'mailNo'].some(key => row[key] != null && row[key] !== number))
+            throw new SchemaError('Ecoscooting', 'Ecoscooting returned a scan for a different parcel');
+        if (row.opTimestamp != null && (typeof row.opTimestamp !== 'string' || !/^\d{13}$/.test(row.opTimestamp)))
+            throw new SchemaError('Ecoscooting', 'Ecoscooting returned an invalid millisecond timestamp');
+        const time = row.opTimestamp == null ? null : epochMillisTime(row.opTimestamp);
+        if (row.opTimestamp != null && !time)
+            throw new SchemaError('Ecoscooting', 'Ecoscooting returned an invalid scan timestamp');
+        const display = clean(row.datetime, 64);
+        const mapped = ecoscootingStatus(code);
+        // Either code family may come with or without completion flags. A delivery
+        // or a collection needs its exact code and both affirmative labels, and
+        // flags, when present, must both affirm it.
+        const labels = COMPLETION_LABELS.get(code);
+        const flagsAgree = (!Object.hasOwn(row, 'statusGroup') && !Object.hasOwn(row, 'status'))
+            || (row.statusGroup === 'delivered' && row.status === 'finish');
+        const completed = !!labels && row.statusName === labels[0] && description === labels[1] && flagsAgree;
+        if (mapped?.stage === 'delivered' && !completed)
+            throw new IndeterminateError('Ecoscooting', 'Ecoscooting returned inconsistent delivery evidence');
+        const event = { ...(time ? { time: time.iso } : display ? { provider_time_text: display } : {}), description, provider_code: code, ...(mapped ? { stage: mapped.stage } : {}) };
+        const key = JSON.stringify(event);
+        if (!seen.has(key)) {
+            seen.add(key);
+            events.push(event);
+        }
+    }
+    const latest = events[0];
+    const current = ecoscootingStatus(String(latest.provider_code));
+    const dims = isRecord(payload.packageParam.dimWeight) ? payload.packageParam.dimWeight : {};
+    const grams = typeof dims.weight === 'string' && /^\d+(?:\.\d+)?$/.test(dims.weight) ? Number(dims.weight) : Number.NaN;
+    return { status: current?.status ?? 'unknown', ...(current ? { current_stage: current.stage } : {}),
+        last_status_text: latest.description, last_update: latest.time ?? null, expected_delivery: null,
+        ...(current?.stage === 'delivered' && latest.time ? { delivered_at: latest.time } : {}),
+        ...(dims.weightUnit === 'g' && Number.isFinite(grams) && grams > 0 ? { weight_kg: grams / 1000 } : {}),
+        ...pickupPoint(payload.popStationParam, events), events: events.slice(0, 100) };
+}
+// A shop's name and address, once a scan places the parcel there. It stays
+// after collection so the parcel still says where it was collected. The pickup
+// PIN, the shop's phone and the station id are never read.
+function pickupPoint(station, events) {
+    if (!isRecord(station) || !events.some(event => PICKUP_POINT_CODES.has(String(event.provider_code))))
+        return {};
+    const lines = [...new Set([clean(station.stationName, 160), clean(station.detailAddress, 300)].filter(Boolean))];
+    return lines.length ? { pickup_point: lines.join('\n') } : {};
+}

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

@@ -0,0 +1,2 @@
+import type { ClassifiedStatus } from '../../core/status/index.js';
+export declare function ecoscootingStatus(code: string): ClassifiedStatus | undefined;

package/dist/carriers/ecoscooting/status.js

@@ -0,0 +1,50 @@
+const DELIVERED = { status: 'delivered', stage: 'delivered' };
+// A pickup point signing for the parcel or receiving it means it waits there.
+const AT_PICKUP_POINT = { status: 'out_for_delivery', stage: 'ready_for_pickup' };
+const RETURNED = { status: 'exception', stage: 'returned' };
+const CODES = new Map([
+    // Codes of the GTMS/TD family.
+    ['GTMS_SIGNED', DELIVERED],
+    ['GTMS_PUDO_SIGNED', DELIVERED],
+    ['GTMS_STA_SIGNED', AT_PICKUP_POINT],
+    ['GTMS_PUDO_INBOUND', AT_PICKUP_POINT],
+    ['GTMS_PUDO_OVERDUE', RETURNED],
+    ['GTMS_SIGN_FAILURE', RETURNED],
+    ['RT_SIGNIN_SUCCESS', RETURNED],
+    ['RT_DO_DEPART', RETURNED],
+    ['RT_DO_ARRIVE', RETURNED],
+    ['RT_WH_OUTBOUND', RETURNED],
+    ['RT_WH_INBOUND', RETURNED],
+    ['GTMS_DO_DEPART', { status: 'out_for_delivery', stage: 'out_for_delivery' }],
+    ['GTMS_DEL_FAILURE', { status: 'exception', stage: 'failed_attempt' }],
+    ['GTMS_ACCEPT', { status: 'in_transit', stage: 'accepted' }],
+    ['TD_TRANSWH_OUTBOUND', { status: 'in_transit', stage: 'in_transit' }],
+    ['TD_TRANS_ARRIVE_C', { status: 'in_transit', stage: 'in_transit' }],
+    ['In_transit', { status: 'in_transit', stage: 'in_transit' }],
+    ['Partner_outbound', { status: 'in_transit', stage: 'in_transit' }],
+    ['create', { status: 'pending', stage: 'registered' }],
+    ['Label_created', { status: 'pending', stage: 'registered' }],
+    // Codes of the last-mile family, which every CN reference uses.
+    ['LM_SIGN_SUCCESS', DELIVERED],
+    ['PUDO_SIGN_SUCCESS', DELIVERED],
+    ['PUDO_DELIVERY', AT_PICKUP_POINT],
+    ['PUDO_INBOUND', AT_PICKUP_POINT],
+    ['PUDO_OVERDUE', RETURNED],
+    ['LM_UNREACHABLE_RETURN', RETURNED],
+    ['RT_LM_SIGN_SUCCESS', RETURNED],
+    ['RT_LM_DELIVERY_DEPART', RETURNED],
+    ['RT_LM_DELIVERY_ARRIVE', RETURNED],
+    ['RT_SC_OUTBOUND', RETURNED],
+    ['RT_SC_INBOUND', RETURNED],
+    ['LM_DELIVERY_DEPART', { status: 'out_for_delivery', stage: 'out_for_delivery' }],
+    ['LM_DELIVERY_FAILURE', { status: 'exception', stage: 'failed_attempt' }],
+    ['LM_PARCEL_EXCEPTION', { status: 'exception', stage: 'exception' }],
+    ['SL_ACCEPT', { status: 'in_transit', stage: 'accepted' }],
+    ['TRANSFER_ARRIVE', { status: 'in_transit', stage: 'in_transit' }],
+    ['TRANSFER_DEPART', { status: 'in_transit', stage: 'in_transit' }],
+    ['SC_OUTBOUND', { status: 'in_transit', stage: 'in_transit' }],
+    ['SC_INBOUND', { status: 'in_transit', stage: 'in_transit' }],
+    ['PU_PICKUP_SUCCESS', { status: 'in_transit', stage: 'accepted' }],
+    ['CREATE_ORDER_CES', { status: 'pending', stage: 'registered' }],
+]);
+export function ecoscootingStatus(code) { return CODES.get(code); }