universal-parcel-scraper 0.149.0-main.1190 → 0.150.0-main.1192

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -21,6 +21,8 @@ export declare const ADAPTER_CHECKED_RULES: ReadonlySet<string>;
21
21
  * carrier whose adapter would refuse it for a failed check digit. A tracker
22
22
  * that also finds parcels by their delivery partner's number ("Global Eco",
23
23
  * Evri International's tracker) names the partner whose rule claims it.
24
+ * Several names that all map to the catalog can be one journey's legs; see
25
+ * `journeyOwner`.
24
26
  */
25
27
  export declare function universalCarrierHints(raw: unknown[], trackingNumber?: string): {
26
28
  reported_carriers: string[];
@@ -1,4 +1,5 @@
1
1
  import { carrierTimezone } from '../../core/catalog/index.js';
2
+ import { CARRIER_DEFINITIONS } from '../../core/catalog/definitions.js';
2
3
  import { partnerNumberOwner } from '../../core/catalog/partners.js';
3
4
  import { brandCarrierIds, brandTimeZones, carrierIdFromName, carrierNameCountryZone } from '../../core/catalog/hints.js';
4
5
  import { checksumFailures } from '../../core/detection/detect.js';
@@ -51,6 +52,8 @@ export const ADAPTER_CHECKED_RULES = new Set([
51
52
  * carrier whose adapter would refuse it for a failed check digit. A tracker
52
53
  * that also finds parcels by their delivery partner's number ("Global Eco",
53
54
  * Evri International's tracker) names the partner whose rule claims it.
55
+ * Several names that all map to the catalog can be one journey's legs; see
56
+ * `journeyOwner`.
54
57
  */
55
58
  export function universalCarrierHints(raw, trackingNumber) {
56
59
  const names = [...new Set(raw.filter((value) => typeof value === 'string'
@@ -58,13 +61,39 @@ export function universalCarrierHints(raw, trackingNumber) {
58
61
  const refused = new Set(trackingNumber ? checksumFailures(trackingNumber)
59
62
  .filter(({ rule }) => ADAPTER_CHECKED_RULES.has(rule)).map(({ carrier }) => carrier) : []);
60
63
  const detected = new Set();
64
+ let unmapped = false;
61
65
  for (const name of names) {
62
66
  const named = carrierIdFromName(name) ?? (trackingNumber ? brandCarrierForNumber(name, trackingNumber) : undefined);
63
67
  const carrier = named && trackingNumber ? partnerNumberOwner(named, trackingNumber) ?? named : named;
64
- if (carrier && !refused.has(carrier))
68
+ if (!carrier)
69
+ unmapped = true;
70
+ else if (!refused.has(carrier))
65
71
  detected.add(carrier);
66
72
  }
67
- return { reported_carriers: names,
68
- ...(names.length === 1 && detected.size === 1 ? { discovered_carrier: [...detected][0] } : {}),
69
- };
73
+ // A name outside the catalog may be the number's owner, so it leaves no hint.
74
+ const discovered = unmapped ? undefined : detected.size === 1 ? [...detected][0]
75
+ : detected.size > 1 && trackingNumber ? journeyOwner([...detected], trackingNumber) : undefined;
76
+ return { reported_carriers: names, ...(discovered ? { discovered_carrier: discovered } : {}) };
77
+ }
78
+ /**
79
+ * A provider can name an origin and the carrier it hands the parcel to, such
80
+ * as DHLink and SwiftX. The number is the one carrier's whose rules fit it,
81
+ * or that a preferred rule backs among several. When none fits, a carrier whose numbers all have a layout of their own
82
+ * (only high-confidence rules, SwiftX's SWX and eighteen digits) is named for
83
+ * its own leg, and the one carrier left is the hint.
84
+ */
85
+ function journeyOwner(carriers, trackingNumber) {
86
+ const { candidates, preferred } = detectCarrierMatch(trackingNumber);
87
+ const fitting = carriers.filter((carrier) => candidates.includes(carrier));
88
+ if (fitting.length === 1)
89
+ return fitting[0];
90
+ if (fitting.length > 1) {
91
+ const backed = fitting.filter((carrier) => preferred.includes(carrier));
92
+ return backed.length === 1 ? backed[0] : undefined;
93
+ }
94
+ const open = carriers.filter((carrier) => {
95
+ const rules = CARRIER_DEFINITIONS[carrier]?.detectionRules ?? [];
96
+ return rules.length === 0 || rules.some((rule) => rule.confidence !== 'high');
97
+ });
98
+ return open.length === 1 ? open[0] : undefined;
70
99
  }
@@ -2,7 +2,7 @@
2
2
  "openapi": "3.1.0",
3
3
  "info": {
4
4
  "title": "Universal Parcel Scraper",
5
- "version": "0.149.0"
5
+ "version": "0.150.0"
6
6
  },
7
7
  "paths": {
8
8
  "/health": {
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "universal-parcel-scraper",
3
- "version": "0.149.0-main.1190",
3
+ "version": "0.150.0-main.1192",
4
4
  "description": "Self-hosted parcel tracking: carrier detection, dedicated scrapers and optional universal providers.",
5
5
  "type": "module",
6
6
  "license": "Apache-2.0",