universal-parcel-scraper 0.2.0 → 0.3.0-main.298

package/dist/carriers/c-chez-vous/adapter.d.ts

@@ -11,7 +11,7 @@
  * credential: never log it, quote it in an issue, or put a real one in a
  * fixture.
  */
-import type { AdapterFactory } from '../../core/adapter/index.js';
+import { type AdapterFactory, type TrackingContext } from '../../core/adapter/index.js';
 import type { CarrierResult } from '../../core/result/index.js';
 export { STEP_DETAILS, stepDetails } from './status.js';
 export declare function normalizeCChezVousCredential(raw: string): string;
@@ -21,11 +21,12 @@ export interface CChezVousTrackerOptions {
     timeoutMs?: number;
     /** Test seam; production uses the global fetch. */
     fetcher?: typeof fetch;
+    userAgent?: string;
 }
 export declare class CChezVousTracker {
     #private;
     readonly timeoutMs: number;
     constructor(options?: CChezVousTrackerOptions);
-    fetch(rawCredential: string): Promise<CarrierResult>;
+    fetch(rawCredential: string, context?: TrackingContext): Promise<CarrierResult>;
 }
 export declare const adapter: AdapterFactory;

package/dist/carriers/c-chez-vous/adapter.js

@@ -12,8 +12,9 @@
  * fixture.
  */
 import { load } from 'cheerio';
-import { NotFoundError, SchemaError } from '../../core/errors/index.js';
-import { UpstreamHttpError, clean, decodeText, fetchBounded } from '../../core/transport/index.js';
+import { lookupBudget } from '../../core/adapter/index.js';
+import { InvalidInputError, NotFoundError, SchemaError } from '../../core/errors/index.js';
+import { UpstreamHttpError, clean, decodeText, fetchBounded, userAgentOf } from '../../core/transport/index.js';
 import { isRecord } from '../../core/types.js';
 import { UNKNOWN_STEP, UNKNOWN_STEP_DESCRIPTION, parcelStep, stepDetails } from './status.js';
 export { STEP_DETAILS, stepDetails } from './status.js';
@@ -54,7 +55,7 @@ export function normalizeCChezVousCredential(raw) {
     const composite = /^([A-Z0-9]{11})--(\d{5})$/.exec(value);
     if (composite) {
         if (!FRENCH_POSTCODE.test(composite[2])) {
-            throw new TypeError('C Chez Vous tracking contains an invalid French postcode');
+            throw new InvalidInputError(PROVIDER, 'C Chez Vous tracking contains an invalid French postcode');
         }
         return `${composite[1]}--${composite[2]}`;
     }
@@ -63,12 +64,12 @@ export function normalizeCChezVousCredential(raw) {
     const compactComposite = /^([A-Z0-9]{11})(\d{5})$/.exec(value);
     if (compactComposite) {
         if (!FRENCH_POSTCODE.test(compactComposite[2])) {
-            throw new TypeError('C Chez Vous tracking contains an invalid French postcode');
+            throw new InvalidInputError(PROVIDER, 'C Chez Vous tracking contains an invalid French postcode');
         }
         return `${compactComposite[1]}--${compactComposite[2]}`;
     }
     if (!/^(?=.*\d)[A-Z0-9]{8,15}$/.test(value)) {
-        throw new TypeError('C Chez Vous tracking requires an 8- to 15-character order number, or an 11-character order followed by -- and a French postcode');
+        throw new InvalidInputError(PROVIDER, 'C Chez Vous tracking requires an 8- to 15-character order number, or an 11-character order followed by -- and a French postcode');
     }
     return value;
 }
@@ -138,24 +139,28 @@ export function parseCChezVousTrackingHtml(html, rawCredential) {
 export class CChezVousTracker {
     timeoutMs;
     #fetcher;
+    #userAgent;
     constructor(options = {}) {
         this.timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
         if (!Number.isFinite(this.timeoutMs) || this.timeoutMs <= 0) {
             throw new TypeError('C Chez Vous timeout must be positive');
         }
         this.#fetcher = options.fetcher;
+        this.#userAgent = userAgentOf(options.userAgent);
     }
-    async fetch(rawCredential) {
+    async fetch(rawCredential, context = {}) {
         const credential = normalizeCChezVousCredential(rawCredential);
+        const budget = lookupBudget(context, this.timeoutMs);
         const { response, bytes } = await fetchBounded(cChezVousTrackingUrl(credential), {
+            signal: budget.signal,
             headers: {
                 Accept: 'text/html,application/xhtml+xml',
                 'Accept-Language': 'fr-FR,fr;q=0.9',
-                'User-Agent': 'Mozilla/5.0 (compatible; DeliveryTracker/1.0)',
+                'User-Agent': this.#userAgent,
             },
         }, {
             provider: 'C Chez Vous tracking',
-            timeoutMs: this.timeoutMs,
+            timeoutMs: Math.min(this.timeoutMs, budget.remainingMs()),
             maxBytes: MAX_RESPONSE_BYTES,
             redirect: 'manual',
             allowHttpError: true,
@@ -171,11 +176,11 @@ export class CChezVousTracker {
     }
 }
 export const adapter = (environment) => {
-    const tracker = new CChezVousTracker({ fetcher: environment.fetcher });
+    const tracker = new CChezVousTracker({ fetcher: environment.fetcher, userAgent: environment.userAgent });
     return {
         id: 'c-chez-vous',
         steps: ['direct'],
         // The postcode, when the order needs one, is already part of the stored number.
-        track: (input) => tracker.fetch(input.number),
+        track: (input, context) => tracker.fetch(input.number, context),
     };
 };

package/dist/carriers/canada-post/adapter.d.ts

@@ -6,6 +6,7 @@ export interface CanadaPostTrackerOptions {
     timeoutMs?: number;
     fetcher?: typeof fetch;
     recorder?: StepRecorder;
+    userAgent?: string;
 }
 export declare class CanadaPostTracker {
     #private;

package/dist/carriers/canada-post/adapter.js

@@ -2,7 +2,7 @@ import { accepted, recognizeFromLookup } from '../../core/adapter/index.js';
 import { BudgetExceededError, 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 { fetchBounded, parseJsonBytes, userAgentOf } from '../../core/transport/index.js';
 import { canadaPostLookupKind, normalizeCanadaPostNumber, parseCanadaPostTrackingResponse, resolveCanadaPostPin } from './parser.js';
 export { normalizeCanadaPostNumber, parseCanadaPostTrackingResponse } from './parser.js';
 const API_BASE = 'https://www.canadapost-postescanada.ca/track-reperage/rs/track/json/package';
@@ -15,11 +15,13 @@ export function canadaPostTrackingUrl(trackingNumber) {
 export class CanadaPostTracker {
     timeoutMs;
     #options;
+    #userAgent;
     constructor(options = {}) {
         this.#options = typeof options === 'number' ? { timeoutMs: options } : options;
         this.timeoutMs = this.#options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
         if (!Number.isFinite(this.timeoutMs) || this.timeoutMs <= 0)
             throw new TypeError('Canada Post timeout must be positive');
+        this.#userAgent = userAgentOf(this.#options.userAgent);
     }
     async fetch(rawTrackingNumber, context = {}) {
         const number = normalizeCanadaPostNumber(rawTrackingNumber);
@@ -40,7 +42,7 @@ export class CanadaPostTracker {
                                     // The public tracking application's interceptor sends empty Basic credentials.
                                     Authorization: 'Basic Og==',
                                     Referer: 'https://www.canadapost-postescanada.ca/track-reperage/en/home',
-                                    'User-Agent': 'Mozilla/5.0 (compatible; DeliveryTracker/1.0)',
+                                    'User-Agent': this.#userAgent,
                                     'X-Requested-With': 'XMLHttpRequest',
                                 } }, { provider: 'canada-post', timeoutMs: Math.max(1, Math.floor(requestBudget)),
                                 maxBytes: 1_000_000, fetcher: this.#options.fetcher }));
@@ -72,7 +74,7 @@ export class CanadaPostTracker {
     }
 }
 export const adapter = (environment) => {
-    const tracker = new CanadaPostTracker({ fetcher: environment.fetcher, recorder: environment.recorder });
+    const tracker = new CanadaPostTracker({ fetcher: environment.fetcher, recorder: environment.recorder, userAgent: environment.userAgent });
     return { id: 'canada-post', recordsSteps: true, steps: ['direct'], track: (input, context) => tracker.fetch(input.number, context),
         recognize: (number, context) => recognizeFromLookup(() => tracker.fetch(number, context), () => accepted(() => normalizeCanadaPostNumber(number))) };
 };

package/dist/carriers/canada-post/parser.js

@@ -1,6 +1,6 @@
 import { DateTime } from 'luxon';
 import { isValidS10TrackingNumber } from '../../core/detection/s10.js';
-import { IndeterminateError, SchemaError } from '../../core/errors/index.js';
+import { IndeterminateError, InvalidInputError, SchemaError } from '../../core/errors/index.js';
 import { explicitOffsetTime } from '../../core/time/index.js';
 import { clean } from '../../core/transport/index.js';
 import { isRecord } from '../../core/types.js';
@@ -8,7 +8,7 @@ import { canadaPostPackageStage, canadaPostScanStage, canadaPostStage, statusFor
 export function normalizeCanadaPostNumber(raw) {
     const value = raw.toUpperCase().replace(/[\s.-]/g, '');
     if (!/^\d{11,24}$/.test(value) && !(value.endsWith('CA') && isValidS10TrackingNumber(value))) {
-        throw new TypeError('Canada Post requires a parcel PIN, numeric reference or valid Canadian postal tracking number');
+        throw new InvalidInputError('canada-post', 'Canada Post requires a parcel PIN, numeric reference or valid Canadian postal tracking number');
     }
     return value;
 }

package/dist/carriers/canpar/parser.js

@@ -1,13 +1,13 @@
 import { DateTime } from 'luxon';
 import { normalizeTrackingNumber } from '../../core/detection/index.js';
-import { IndeterminateError, SchemaError } from '../../core/errors/index.js';
+import { IndeterminateError, InvalidInputError, SchemaError } from '../../core/errors/index.js';
 import { clean } from '../../core/transport/index.js';
 import { isRecord } from '../../core/types.js';
 import { canparStatus } from './status.js';
 export function normalizeCanparNumber(raw) {
     const number = normalizeTrackingNumber(raw);
     if (!/^[CDKLSUXZ]\d{21}$/.test(number))
-        throw new TypeError('Canpar requires a full parcel barcode');
+        throw new InvalidInputError('Canpar', 'Canpar requires a full parcel barcode');
     return number;
 }
 function clock(raw) {

package/dist/carriers/ciblex/parser.js

@@ -1,13 +1,13 @@
 import { load } from 'cheerio';
 import { DateTime } from 'luxon';
-import { IndeterminateError, SchemaError } from '../../core/errors/index.js';
+import { IndeterminateError, InvalidInputError, SchemaError } from '../../core/errors/index.js';
 import { clean } from '../../core/transport/index.js';
 import { calendarDay, zonedTime } from '../../core/time/index.js';
 import { classifyCiblexStatus, comparableText } from './status.js';
 export function normalizeCiblexTrackingNumber(raw) {
     const number = raw.replace(/\s/g, '');
     if (!/^(?:\d{14}|\d{24})$/.test(number))
-        throw new TypeError('Ciblex requires exactly 14 or 24 digits');
+        throw new InvalidInputError('Ciblex', 'Ciblex requires exactly 14 or 24 digits');
     return number;
 }
 export function ciblexTrackingUrl(raw) {

package/dist/carriers/colis-prive/adapter.d.ts

@@ -11,7 +11,7 @@
  * so it is part of the tracking credential: it is never logged, put in an issue
  * or written into a fixture.
  */
-import { type AdapterFactory } from '../../core/adapter/index.js';
+import { type AdapterFactory, type TrackingContext } from '../../core/adapter/index.js';
 import { NotFoundError } from '../../core/errors/index.js';
 import type { CarrierResult } from '../../core/result/index.js';
 export { classifyStatus } from './status.js';
@@ -29,11 +29,12 @@ export interface ColisPriveTrackerOptions {
     timeoutMs?: number;
     /** Test seam; production uses the global fetch. */
     fetcher?: typeof fetch;
+    userAgent?: string;
 }
 export declare class ColisPriveTracker {
     #private;
     readonly timeoutMs: number;
     constructor(options?: ColisPriveTrackerOptions);
-    fetch(rawCredential: string): Promise<CarrierResult>;
+    fetch(rawCredential: string, context?: TrackingContext): Promise<CarrierResult>;
 }
 export declare const adapter: AdapterFactory;

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

@@ -8,7 +8,7 @@
  * milestones, the step and the slot's starting day; everything describing a
  * person or a shop is dropped.
  */
-import type { AdapterFactory } from '../../core/adapter/index.js';
+import { type AdapterFactory, type TrackingContext } from '../../core/adapter/index.js';
 import type { CarrierResult } from '../../core/result/index.js';
 export { classifyStatus } from './status.js';
 export declare function normalizeColiswebTrackingNumber(raw: string): string;
@@ -19,11 +19,12 @@ export interface ColiswebTrackerOptions {
     timeoutMs?: number;
     /** Test seam; production uses the global fetch. */
     fetcher?: typeof fetch;
+    userAgent?: string;
 }
 export declare class ColiswebTracker {
     #private;
     readonly timeoutMs: number;
     constructor(options?: ColiswebTrackerOptions);
-    fetch(rawTrackingNumber: string): Promise<CarrierResult>;
+    fetch(rawTrackingNumber: string, context?: TrackingContext): Promise<CarrierResult>;
 }
 export declare const adapter: AdapterFactory;

package/dist/carriers/colisweb/adapter.js

@@ -8,8 +8,9 @@
  * milestones, the step and the slot's starting day; everything describing a
  * person or a shop is dropped.
  */
-import { IndeterminateError, NotFoundError, SchemaError } from '../../core/errors/index.js';
-import { UpstreamHttpError, clean, decodeText, fetchBounded, parseJsonBytes } from '../../core/transport/index.js';
+import { lookupBudget } from '../../core/adapter/index.js';
+import { IndeterminateError, InvalidInputError, NotFoundError, SchemaError } from '../../core/errors/index.js';
+import { UpstreamHttpError, clean, decodeText, fetchBounded, parseJsonBytes, userAgentOf } from '../../core/transport/index.js';
 import { isRecord } from '../../core/types.js';
 import { classifyStatus } from './status.js';
 export { classifyStatus } from './status.js';
@@ -47,7 +48,7 @@ function saysNotFound(value) {
 export function normalizeColiswebTrackingNumber(raw) {
     const value = raw.replace(/\s/g, '');
     if (!/^\d{8,32}$/.test(value)) {
-        throw new TypeError('Colisweb tracking numbers must contain at least 8 digits');
+        throw new InvalidInputError(PROVIDER, 'Colisweb tracking numbers must contain at least 8 digits');
     }
     return value;
 }
@@ -114,28 +115,32 @@ export function parseColiswebTrackingResponse(payload, rawTrackingNumber) {
 export class ColiswebTracker {
     timeoutMs;
     #fetcher;
+    #userAgent;
     constructor(options = {}) {
         this.timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
         if (!Number.isFinite(this.timeoutMs) || this.timeoutMs <= 0) {
             throw new TypeError('Colisweb timeout must be positive');
         }
         this.#fetcher = options.fetcher;
+        this.#userAgent = userAgentOf(options.userAgent);
     }
-    async fetch(rawTrackingNumber) {
+    async fetch(rawTrackingNumber, context = {}) {
         const trackingNumber = normalizeColiswebTrackingNumber(rawTrackingNumber);
+        const budget = lookupBudget(context, this.timeoutMs);
         const { response, bytes } = await fetchBounded(coliswebTrackingUrl(), {
             method: 'POST',
+            signal: budget.signal,
             headers: {
                 Accept: 'application/json',
                 'Content-Type': 'application/json',
                 Origin: 'https://www.colisweb.com',
                 Referer: 'https://www.colisweb.com/suivi-livraison',
-                'User-Agent': 'Mozilla/5.0 (compatible; DeliveryTracker/1.0)',
+                'User-Agent': this.#userAgent,
             },
             body: coliswebRequestBody(trackingNumber),
         }, {
             provider: 'Colisweb tracking',
-            timeoutMs: this.timeoutMs,
+            timeoutMs: Math.min(this.timeoutMs, budget.remainingMs()),
             maxBytes: MAX_RESPONSE_BYTES,
             redirect: 'error',
             allowHttpError: true,
@@ -157,10 +162,10 @@ export class ColiswebTracker {
     }
 }
 export const adapter = (environment) => {
-    const tracker = new ColiswebTracker({ fetcher: environment.fetcher });
+    const tracker = new ColiswebTracker({ fetcher: environment.fetcher, userAgent: environment.userAgent });
     return {
         id: 'colisweb',
         steps: ['direct'],
-        track: (input) => tracker.fetch(input.number),
+        track: (input, context) => tracker.fetch(input.number, context),
     };
 };

package/dist/carriers/correios-br/parser.js

@@ -1,13 +1,13 @@
 import { DateTime, IANAZone } from 'luxon';
 import { isValidS10TrackingNumber } from '../../core/detection/s10.js';
-import { ChallengeError, IndeterminateError, SchemaError } from '../../core/errors/index.js';
+import { ChallengeError, IndeterminateError, InvalidInputError, SchemaError } from '../../core/errors/index.js';
 import { clean } from '../../core/transport/index.js';
 import { isRecord } from '../../core/types.js';
 import { classifyCorreiosStatus } from './status.js';
 export function normalizeCorreiosNumber(raw) {
     const number = raw.toUpperCase().replace(/[\s.-]/g, '');
     if (!/^[A-Z]{2}\d{9}[A-Z]{2}$/.test(number) || !isValidS10TrackingNumber(number)) {
-        throw new TypeError('Correios requires a valid postal S10 tracking number');
+        throw new InvalidInputError('Correios', 'Correios requires a valid postal S10 tracking number');
     }
     return number;
 }

package/dist/carriers/correos-chile/parser.js

@@ -1,5 +1,5 @@
 import { isValidS10TrackingNumber } from '../../core/detection/s10.js';
-import { ChallengeError, IndeterminateError, RateLimitedError, SchemaError } from '../../core/errors/index.js';
+import { ChallengeError, IndeterminateError, InvalidInputError, RateLimitedError, SchemaError } from '../../core/errors/index.js';
 import { calendarDay } from '../../core/time/index.js';
 import { clean } from '../../core/transport/index.js';
 import { isRecord } from '../../core/types.js';
@@ -10,11 +10,11 @@ const RESOURCE = 'cl_cch_seguimiento_portlet_seguimientoresurcecommand';
 const ALLOWED_PARAMS = new Set(['p_p_id', 'p_p_lifecycle', 'p_p_state', 'p_p_mode', 'p_p_resource_id', 'p_p_cacheability']);
 export function normalizeCorreosChileNumber(raw) {
     if (raw.length > 48)
-        throw new TypeError('Correos de Chile tracking number is too long');
+        throw new InvalidInputError('Correos de Chile', 'Correos de Chile tracking number is too long');
     const number = raw.toUpperCase().replace(/[\s.-]/g, '');
     if (/^\d{13}$/.test(number) || (/^[A-Z]{2}\d{9}CL$/.test(number) && isValidS10TrackingNumber(number)))
         return number;
-    throw new TypeError('Correos de Chile requires 13 digits or a valid Chilean postal number');
+    throw new InvalidInputError('Correos de Chile', 'Correos de Chile requires 13 digits or a valid Chilean postal number');
 }
 export function parseCorreosChileBootstrap(html) {
     if (/Radware (?:Captcha )?Page|We apologize for the inconvenience|Please solve this CAPTCHA/i.test(html)) {

package/dist/carriers/correos-express/parser.js

@@ -1,6 +1,6 @@
 import { load } from 'cheerio';
 import { DateTime } from 'luxon';
-import { IndeterminateError, NotFoundError, SchemaError } from '../../core/errors/index.js';
+import { IndeterminateError, InvalidInputError, NotFoundError, SchemaError } from '../../core/errors/index.js';
 import { calendarDay } from '../../core/time/index.js';
 import { clean } from '../../core/transport/index.js';
 import { classifyCorreosExpressStatus } from './status.js';
@@ -10,7 +10,7 @@ const FAILED_ROUND = 'Su envío no ha podido ser entregado';
 export function normalizeCorreosExpressNumber(raw) {
     const number = raw.replace(/[\s.-]/g, '');
     if (!/^\d{16}$/.test(number))
-        throw new TypeError('Correos Express requires a 16-digit shipment number');
+        throw new InvalidInputError('Correos Express', 'Correos Express requires a 16-digit shipment number');
     return number;
 }
 function scanClock(raw) {

package/dist/carriers/correos-spain/adapter.d.ts

@@ -1,4 +1,4 @@
-import type { AdapterFactory } from '../../core/adapter/index.js';
+import { type AdapterFactory, type TrackingContext } from '../../core/adapter/index.js';
 import type { CarrierResult } from '../../core/result/index.js';
 export declare function normalizeCorreosSpainTrackingNumber(raw: string): string;
 export declare function correosSpainTrackingUrl(rawTrackingNumber: string): string;
@@ -6,10 +6,12 @@ export declare function parseCorreosSpainTrackingResponse(payload: unknown, trac
 export declare class CorreosSpainTracker {
     readonly timeoutMs: number;
     readonly fetcher: typeof fetch | undefined;
+    private readonly userAgent;
     constructor(options?: {
         timeoutMs?: number;
         fetcher?: typeof fetch;
+        userAgent?: string;
     });
-    fetch(rawTrackingNumber: string): Promise<CarrierResult>;
+    fetch(rawTrackingNumber: string, context?: TrackingContext): Promise<CarrierResult>;
 }
 export declare const adapter: AdapterFactory;

package/dist/carriers/correos-spain/adapter.js

@@ -1,6 +1,7 @@
-import { NotFoundError, SchemaError } from '../../core/errors/index.js';
+import { lookupBudget } from '../../core/adapter/index.js';
+import { InvalidInputError, NotFoundError, SchemaError } from '../../core/errors/index.js';
 import { zonedTime } from '../../core/time/index.js';
-import { clean, fetchBounded, parseJsonBytes, UpstreamHttpError } from '../../core/transport/index.js';
+import { clean, fetchBounded, parseJsonBytes, UpstreamHttpError, userAgentOf } from '../../core/transport/index.js';
 import { isRecord } from '../../core/types.js';
 import { classifyCorreosSpainStatus } from './status.js';
 // Protocol provenance:
@@ -16,6 +17,8 @@ import { classifyCorreosSpainStatus } from './status.js';
 //   attempt → office hold → collected); the map lives in status.ts.
 const TRACKING_ENDPOINT = 'https://localizador.correos.es/canonico/eventos_envio_servicio';
 const DEFAULT_TIMEOUT_MS = 15_000;
+/** `fetchBounded` repeats a request that failed in transit once, after this pause. */
+const TRANSIENT_RETRY_DELAY_MS = 1_000;
 const MAX_RESPONSE_BYTES = 1_000_000;
 const MAX_EVENTS_TO_RETURN = 20;
 function parsedTime(dateValue, timeValue) {
@@ -33,7 +36,7 @@ export function normalizeCorreosSpainTrackingNumber(raw) {
     // PR-prefixed); the codError envelope — not the shape — decides unknown.
     const value = raw.toLocaleUpperCase('en-US').replace(/[\s.-]/g, '');
     if (!/^[A-Z0-9]{4,40}$/.test(value) || !/\d/.test(value)) {
-        throw new TypeError('Correos tracking requires a tracking code with letters, numbers and a digit');
+        throw new InvalidInputError('Correos', 'Correos tracking requires a tracking code with letters, numbers and a digit');
     }
     return value;
 }
@@ -151,26 +154,31 @@ export function parseCorreosSpainTrackingResponse(payload, trackingNumber) {
 export class CorreosSpainTracker {
     timeoutMs;
     fetcher;
+    userAgent;
     constructor(options = {}) {
         this.timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
         this.fetcher = options.fetcher;
+        this.userAgent = userAgentOf(options.userAgent);
         if (!Number.isFinite(this.timeoutMs) || this.timeoutMs <= 0) {
             throw new TypeError('Correos tracking timeout must be positive');
         }
     }
-    async fetch(rawTrackingNumber) {
+    async fetch(rawTrackingNumber, context = {}) {
         const trackingNumber = normalizeCorreosSpainTrackingNumber(rawTrackingNumber);
+        // The default budget covers the request, the pause and the one transient retry.
+        const budget = lookupBudget(context, 2 * this.timeoutMs + TRANSIENT_RETRY_DELAY_MS);
         const url = `${TRACKING_ENDPOINT}/${encodeURIComponent(trackingNumber)}`
             + '?codAplicacion=60&codCanal=3&codIdioma=ES&indUltEvento=N';
         const { response, bytes } = await fetchBounded(url, {
+            signal: budget.signal,
             headers: {
                 Accept: 'application/json, text/plain, */*',
                 'Accept-Language': 'en-US,en;q=0.9',
-                'User-Agent': 'Mozilla/5.0 (compatible; DeliveryTracker/1.0)',
+                'User-Agent': this.userAgent,
             },
         }, {
             provider: 'Correos tracking',
-            timeoutMs: this.timeoutMs,
+            timeoutMs: Math.min(this.timeoutMs, budget.remainingMs()),
             maxBytes: MAX_RESPONSE_BYTES,
             retryTransient: true,
             allowHttpError: true,
@@ -182,10 +190,10 @@ export class CorreosSpainTracker {
     }
 }
 export const adapter = (environment) => {
-    const tracker = new CorreosSpainTracker({ fetcher: environment.fetcher });
+    const tracker = new CorreosSpainTracker({ fetcher: environment.fetcher, userAgent: environment.userAgent });
     return {
         id: 'correos-spain',
         steps: ['direct'],
-        track: (input) => tracker.fetch(input.number),
+        track: (input, context) => tracker.fetch(input.number, context),
     };
 };

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

@@ -1,4 +1,4 @@
-import type { AdapterFactory } from '../../core/adapter/index.js';
+import { type AdapterFactory, type TrackingContext } from '../../core/adapter/index.js';
 import { IndeterminateError, MaintenanceError } from '../../core/errors/index.js';
 import type { CarrierResult } from '../../core/result/index.js';
 /** A CTT maintenance window: the backend is up but refuses to answer lookups. */
@@ -22,7 +22,7 @@ export declare class CttTracker {
         timeoutMs?: number;
         fetcher?: typeof fetch;
     });
-    fetch(rawTrackingNumber: string): Promise<CarrierResult>;
+    fetch(rawTrackingNumber: string, context?: TrackingContext): Promise<CarrierResult>;
     private isMaintenance;
     private callAction;
     private ensureApiVersion;