universal-parcel-scraper 0.2.1-main.296 → 0.3.0-main.298

package/README.md

@@ -124,12 +124,14 @@ curl http://127.0.0.1:8080/v1/track \
 memory and rate-limits callers. It has no database and never polls on its own.
 
 Set `SCRAPER_TOKEN` to require a bearer token. `SCRAPER_DEMO_PAGE=true` serves a small page
-at `/` for trying numbers by hand. The other settings are in [.env.example](.env.example).
+at `/` for trying numbers by hand. Behind a reverse proxy, set `SCRAPER_TRUSTED_PROXIES` so
+the rate limit counts each caller and not the proxy. The other settings are in
+[.env.example](.env.example).
 
 ### Docker
 
 ```sh
-docker run --rm -p 127.0.0.1:8080:8080 ghcr.io/plhery/universal-parcel-scraper:0.2.0
+docker run --rm -p 127.0.0.1:8080:8080 ghcr.io/plhery/universal-parcel-scraper:0.3.0
 ```
 
 The image runs `serve` and ships Chromium, for the carriers that only answer a real browser.
@@ -168,6 +170,9 @@ npm install playwright-core sharp onnxruntime-web
 Then pass `chromiumPath` or `trawlUrl` to `createTracker()`. The CLI and the server read
 `TRACKING_CHROMIUM_PATH` and `FLARESOLVERR_URL`.
 
+Where a carrier accepts a plain client, the adapter names itself with the package's default
+User-Agent. Pass `userAgent`, or set `SCRAPER_USER_AGENT`, to send your own.
+
 When the adapter finds no history, the lookup can move on to an aggregator. Only UPU is on
 by default, for the postal numbers it can serve. The commercial ones are opt-in, and each
 one you enable receives the tracking number:

package/data/carrier.schema.json

@@ -273,9 +273,11 @@
       ],
       "properties": {
         "field": {
-          "description": "Input name; the generator checks it against the validators it accepts.",
-          "type": "string",
-          "minLength": 1
+          "description": "Input name. The generator checks that the validator is one this input accepts.",
+          "enum": [
+            "trackingUrl",
+            "postcode"
+          ]
         },
         "validator": {
           "type": "string",

package/data/catalog.json

@@ -713,7 +713,7 @@
       "adapter": "gls-ch",
       "requirements": [
         {
-          "field": "dpdPostcode",
+          "field": "postcode",
           "validator": "swissPostcode",
           "label": "Delivery postcode",
           "type": "text",
@@ -780,7 +780,7 @@
       "adapter": "dpd",
       "requirements": [
         {
-          "field": "dpdPostcode",
+          "field": "postcode",
           "validator": "swissPostcode",
           "optional": true,
           "label": "Delivery postcode",
@@ -879,7 +879,7 @@
       "adapter": "mondial-relay",
       "requirements": [
         {
-          "field": "dpdPostcode",
+          "field": "postcode",
           "whenTrackingNumber": "^(?![0-9]{26}$).*$",
           "validator": "francePostcode",
           "label": "Delivery postcode",
@@ -1268,7 +1268,7 @@
       "adapter": "heppner",
       "requirements": [
         {
-          "field": "dpdPostcode",
+          "field": "postcode",
           "validator": "swissOrFrancePostcode",
           "label": "Delivery postcode",
           "type": "text",
@@ -1350,7 +1350,7 @@
       "adapter": "paack",
       "requirements": [
         {
-          "field": "dpdPostcode",
+          "field": "postcode",
           "validator": "paackPostcode",
           "label": "Delivery postcode",
           "type": "text",
@@ -1545,7 +1545,7 @@
       "adapter": "gls-de",
       "requirements": [
         {
-          "field": "dpdPostcode",
+          "field": "postcode",
           "validator": "swissOrFrancePostcode",
           "label": "Delivery postcode",
           "type": "text",

package/dist/app.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Helpers shaped for the parcel app this package was extracted from: its
+ * parcel view, carrier-name hints for provider results, and the clock helpers
+ * its sync uses. They change with that app and carry no stability promise;
+ * the tracking contract is the other entry points.
+ */
+export * from './core/catalog/parcel.js';
+export * from './core/catalog/hints.js';
+export * from './core/time/result.js';
+export { universalCarrierHints } from './providers/shared/hints.js';
+export { recognitionAskedCarriers } from './core/catalog/recognition.js';

package/dist/app.js

@@ -0,0 +1,11 @@
+/**
+ * Helpers shaped for the parcel app this package was extracted from: its
+ * parcel view, carrier-name hints for provider results, and the clock helpers
+ * its sync uses. They change with that app and carry no stability promise;
+ * the tracking contract is the other entry points.
+ */
+export * from './core/catalog/parcel.js';
+export * from './core/catalog/hints.js';
+export * from './core/time/result.js';
+export { universalCarrierHints } from './providers/shared/hints.js';
+export { recognitionAskedCarriers } from './core/catalog/recognition.js';