universal-parcel-scraper 0.807.0-main.4337 → 0.807.2-main.4341

package/dist/carriers/aliexpress/clock.d.ts

@@ -3,7 +3,9 @@ export declare const CAINIAO_CHINA_ZONE = "Asia/Shanghai";
 /**
  * The wordings of Cainiao's steps in China, from the seller's to the
  * departing flight, and of its return warehouse. Its feed dates them on
- * China's clock wherever the parcel goes. Its later steps are on their site's
+ * China's clock wherever the parcel goes. So is the order's cancellation:
+ * on any clock west of UTC+7:36 it came after the check that first returned
+ * it, on a parcel to Portugal. Its later steps are on their site's
  * clock, which varies by parcel, so they are not listed: "Arrived at linehaul
  * office" came at China's digits on one parcel and Europe's on another. The
  * list holds Cainiao's English, as ParcelsApp relays it, and Postal Ninja's

package/dist/carriers/aliexpress/clock.js

@@ -3,14 +3,16 @@ export const CAINIAO_CHINA_ZONE = 'Asia/Shanghai';
 /**
  * The wordings of Cainiao's steps in China, from the seller's to the
  * departing flight, and of its return warehouse. Its feed dates them on
- * China's clock wherever the parcel goes. Its later steps are on their site's
+ * China's clock wherever the parcel goes. So is the order's cancellation:
+ * on any clock west of UTC+7:36 it came after the check that first returned
+ * it, on a parcel to Portugal. Its later steps are on their site's
  * clock, which varies by parcel, so they are not listed: "Arrived at linehaul
  * office" came at China's digits on one parcel and Europe's on another. The
  * list holds Cainiao's English, as ParcelsApp relays it, and Postal Ninja's
  * translation of it, which keeps Cainiao's digits.
  */
 export const CAINIAO_CHINA_LEG = [
-    'pending shipping by the seller', 'order received successfully', 'package finished', 'leave the warehouse',
+    'pending shipping by the seller', 'order received successfully', 'order has been cancelled', 'package finished', 'leave the warehouse',
     'departed from warehouse', 'accepted by carrier', 'shipment information received by warehouse electronically',
     'package ready for shipping from warehouse', 'package shipped out from warehouse',
     '(?:inbound|outbound) in sorting center', 'processing at sorting center', 'departed from sorting center',

package/dist/carriers/amazon-shipping/eligibility.d.ts

@@ -1,4 +1,8 @@
 import { type AmazonShippingOptions } from './adapter.js';
 import type { TrackingContext } from '../../core/adapter/index.js';
-/** A public eligibility check; transport errors remain errors for the consumer to report. */
+/**
+ * A public eligibility check; transport errors remain errors for the consumer to report. It asks
+ * Amazon's tracker without the adapter registry, so it refuses placeholder numbers itself, as the
+ * registry does: trackers show other people's shipments under them.
+ */
 export declare function amazonShippingEligibility(number: string, options?: AmazonShippingOptions, context?: TrackingContext): Promise<'available' | 'expired' | 'not-found'>;

package/dist/carriers/amazon-shipping/eligibility.js

@@ -1,7 +1,15 @@
 import { AmazonShippingTracker } from './adapter.js';
-import { CarrierError } from '../../core/errors/index.js';
-/** A public eligibility check; transport errors remain errors for the consumer to report. */
+import { isPlaceholderNumber } from '../../core/detection/index.js';
+import { CarrierError, InvalidInputError } from '../../core/errors/index.js';
+/**
+ * A public eligibility check; transport errors remain errors for the consumer to report. It asks
+ * Amazon's tracker without the adapter registry, so it refuses placeholder numbers itself, as the
+ * registry does: trackers show other people's shipments under them.
+ */
 export async function amazonShippingEligibility(number, options = {}, context = {}) {
+    if (isPlaceholderNumber(number)) {
+        throw new InvalidInputError('amazon-shipping', 'A placeholder number is not looked up', { reason: 'placeholder_number' });
+    }
     try {
         await new AmazonShippingTracker({ ...options, timeoutMs: options.timeoutMs ?? 5_000 }).fetch(number, context);
         return 'available';

package/dist/server/openapi.json

@@ -2,7 +2,7 @@
   "openapi": "3.1.0",
   "info": {
     "title": "Universal Parcel Scraper",
-    "version": "0.807.0-main.4337"
+    "version": "0.807.2-main.4341"
   },
   "paths": {
     "/health": {

package/package.json

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