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 (
|
|
68
|
+
if (!carrier)
|
|
69
|
+
unmapped = true;
|
|
70
|
+
else if (!refused.has(carrier))
|
|
65
71
|
detected.add(carrier);
|
|
66
72
|
}
|
|
67
|
-
|
|
68
|
-
|
|
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
|
}
|
package/dist/server/openapi.json
CHANGED
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "universal-parcel-scraper",
|
|
3
|
-
"version": "0.
|
|
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",
|