universal-parcel-scraper 0.5.0-main.321 → 0.5.0-main.322

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

@@ -10,7 +10,7 @@ export declare class DPDChallengeError extends ChallengeError {
 /**
  * The guest API answered, but the answer proves nothing about the shipment
  * (unreachable, malformed, unauthenticated, or an HTTP status the guest flow
- * handles itself). The rendered page is allowed to recover from it.
+ * handles itself, except HTTP 503). The rendered page is allowed to recover from it.
  */
 export declare class DPDAPIError extends IndeterminateError {
     constructor(message: string, options?: CarrierErrorOptions);

package/dist/carriers/dpd/adapter.js

@@ -2,7 +2,7 @@ import { setTimeout as delay } from 'node:timers/promises';
 import { randomBytes } from 'node:crypto';
 import { load } from 'cheerio';
 import { lookupBudget } from '../../core/adapter/index.js';
-import { BudgetExceededError, carrierErrorKind, ChallengeError, IndeterminateError, InvalidInputError, NotFoundError, SchemaError } from '../../core/errors/index.js';
+import { BudgetExceededError, carrierErrorKind, ChallengeError, IndeterminateError, InvalidInputError, NotFoundError, SchemaError, UpstreamHttpError } from '../../core/errors/index.js';
 import { runSteps } from '../../core/runner/index.js';
 import { isoTime, explicitOffsetTime, zonedTime } from '../../core/time/index.js';
 import { TrawlClient, decodeText, fetchBounded, parseJsonBytes } from '../../core/transport/index.js';
@@ -19,7 +19,8 @@ import { API_LABELS, PROOF_OF_DELIVERY_SCAN, apiStage, apiStatus, scanStage, wor
 //   `continueWithoutVerification=true`. A rejected postcode (HTTP 400) is
 //   retried once without verification and reported as unverified rather than
 //   failing the lookup.
-// - The consignee web page is the fallback when the guest API is inconclusive.
+// - The consignee web page is the fallback when the guest API is inconclusive,
+//   except HTTP 503: the service is down, irrespective of the parcel number.
 //   It sits behind Cloudflare, so it is fetched through the browser service's
 //   legacy command API when one is configured and directly otherwise.
 const TRACKING_BASE = 'https://www.dpdgroup.com/ch/mydpd/my-parcels/incoming';
@@ -54,7 +55,7 @@ export class DPDChallengeError extends ChallengeError {
 /**
  * The guest API answered, but the answer proves nothing about the shipment
  * (unreachable, malformed, unauthenticated, or an HTTP status the guest flow
- * handles itself). The rendered page is allowed to recover from it.
+ * handles itself, except HTTP 503). The rendered page is allowed to recover from it.
  */
 export class DPDAPIError extends IndeterminateError {
     constructor(message, options) {
@@ -778,6 +779,10 @@ export class DPDTracker {
         catch (error) {
             throw new DPDAPIError('DPD guest API is unreachable', { cause: error });
         }
+        // A 503 describes DPD's availability, so the page must not turn it into
+        // an answer about the parcel or hold up the caller's other lookups.
+        if (result.response.status === 503)
+            throw new UpstreamHttpError('DPD guest API', 503);
         if (!result.response.ok)
             throw new DPDAPIHttpError(result.response.status);
         let payload;

package/package.json

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