universal-parcel-scraper 0.53.0-main.672 → 0.54.0-main.701

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.
Files changed (97) hide show
  1. package/README.md +3 -3
  2. package/data/carrier.schema.json +1 -0
  3. package/data/catalog.json +97 -11
  4. package/data/coverage-summary.json +2 -2
  5. package/data/detection-golden.json +424 -29
  6. package/dist/browser/scraper.js +1062 -956
  7. package/dist/carriers/aliexpress/carrier.json +7 -0
  8. package/dist/carriers/aliexpress/numbers.json +95 -0
  9. package/dist/carriers/amazon-shipping/adapter.js +46 -6
  10. package/dist/carriers/amazon-shipping/app.js +3 -2
  11. package/dist/carriers/amazon-shipping/statuses.json +2 -0
  12. package/dist/carriers/australia-post/adapter.d.ts +1 -1
  13. package/dist/carriers/australia-post/adapter.js +5 -1
  14. package/dist/carriers/australia-post/carrier.json +23 -1
  15. package/dist/carriers/australia-post/numbers.json +197 -6
  16. package/dist/carriers/austrian-post/identity.js +4 -2
  17. package/dist/carriers/brt/carrier.json +1 -1
  18. package/dist/carriers/chronopost/parser.js +15 -10
  19. package/dist/carriers/chronopost/status.d.ts +3 -0
  20. package/dist/carriers/chronopost/status.js +22 -1
  21. package/dist/carriers/chronopost/statuses.json +62 -0
  22. package/dist/carriers/ciblex/parser.js +4 -3
  23. package/dist/carriers/cne/carrier.json +2 -1
  24. package/dist/carriers/delhivery/parser.js +4 -2
  25. package/dist/carriers/dhl/carrier.json +1 -0
  26. package/dist/carriers/dhl-ecommerce/adapter.d.ts +6 -0
  27. package/dist/carriers/dhl-ecommerce/adapter.js +27 -4
  28. package/dist/carriers/dpd/adapter.d.ts +7 -1
  29. package/dist/carriers/dpd/adapter.js +33 -5
  30. package/dist/carriers/dpd-de/adapter.js +5 -3
  31. package/dist/carriers/dpd-de/app.d.ts +2 -0
  32. package/dist/carriers/dpd-de/app.js +2 -0
  33. package/dist/carriers/dpd-de/service.d.ts +8 -5
  34. package/dist/carriers/dpd-de/service.js +14 -7
  35. package/dist/carriers/dpd-pl/adapter.d.ts +12 -0
  36. package/dist/carriers/dpd-pl/adapter.js +64 -0
  37. package/dist/carriers/dpd-pl/carrier.json +88 -0
  38. package/dist/carriers/dpd-pl/numbers.json +245 -0
  39. package/dist/carriers/dpd-pl/parser.d.ts +11 -0
  40. package/dist/carriers/dpd-pl/parser.js +154 -0
  41. package/dist/carriers/dpd-pl/status.d.ts +19 -0
  42. package/dist/carriers/dpd-pl/status.js +60 -0
  43. package/dist/carriers/dpd-pl/statuses.json +27 -0
  44. package/dist/carriers/dpd-uk/numbers.json +2 -0
  45. package/dist/carriers/estafeta/carrier.json +1 -1
  46. package/dist/carriers/gls-fr/adapter.d.ts +8 -2
  47. package/dist/carriers/gls-fr/adapter.js +53 -12
  48. package/dist/carriers/gls-fr/statuses.json +1 -1
  49. package/dist/carriers/hermes/numbers.json +3 -4
  50. package/dist/carriers/intl-post/numbers.json +1 -0
  51. package/dist/carriers/nacex/carrier.json +1 -1
  52. package/dist/carriers/old-dominion/carrier.json +4 -2
  53. package/dist/carriers/ontrac/status.js +4 -1
  54. package/dist/carriers/ontrac/statuses.json +9 -0
  55. package/dist/carriers/poczta-polska/numbers.json +38 -0
  56. package/dist/carriers/postnord/adapter.d.ts +1 -1
  57. package/dist/carriers/postnord/adapter.js +3 -1
  58. package/dist/carriers/postnord/carrier.json +4 -1
  59. package/dist/carriers/seur/carrier.json +1 -1
  60. package/dist/carriers/the-courier-guy/carrier.json +1 -1
  61. package/dist/carriers/tipsa/carrier.json +1 -1
  62. package/dist/carriers/ukrposhta/adapter.d.ts +1 -1
  63. package/dist/carriers/ukrposhta/adapter.js +23 -6
  64. package/dist/carriers/ukrposhta/carrier.json +10 -0
  65. package/dist/carriers/ukrposhta/numbers.json +19 -0
  66. package/dist/carriers/ups/adapter.d.ts +10 -1
  67. package/dist/carriers/ups/adapter.js +39 -6
  68. package/dist/carriers/ups/carrier.json +7 -3
  69. package/dist/carriers/ups/status.js +10 -6
  70. package/dist/carriers/ups/statuses.json +5 -0
  71. package/dist/carriers/usps/carrier.json +6 -0
  72. package/dist/carriers/usps/numbers.json +6 -15
  73. package/dist/carriers/yanwen/adapter.js +11 -4
  74. package/dist/carriers/yanwen/carrier.json +5 -0
  75. package/dist/carriers/yanwen/numbers.json +4 -4
  76. package/dist/carriers/yunexpress/adapter.js +20 -9
  77. package/dist/carriers/yunexpress/status.js +2 -0
  78. package/dist/carriers/yunexpress/statuses.json +8 -0
  79. package/dist/core/catalog/hints.js +7 -5
  80. package/dist/core/catalog/statusMaps.js +3 -2
  81. package/dist/core/catalog/types.d.ts +2 -0
  82. package/dist/core/status/language.js +5 -2
  83. package/dist/core/time/index.js +3 -5
  84. package/dist/core/time/townNames.d.ts +2 -0
  85. package/dist/core/time/townNames.js +13 -0
  86. package/dist/core/transport/transportOf.d.ts +4 -0
  87. package/dist/core/transport/transportOf.js +15 -0
  88. package/dist/data/catalog.json +97 -11
  89. package/dist/facade/index.js +3 -2
  90. package/dist/generated/catalog.d.ts +72 -7
  91. package/dist/generated/catalog.js +104 -16
  92. package/dist/generated/recognition.js +4 -0
  93. package/dist/generated/registry.js +3 -0
  94. package/dist/places/trackingLocation.js +7 -2
  95. package/dist/providers/shared/hints.js +1 -1
  96. package/dist/server/openapi.json +1 -1
  97. package/package.json +1 -1
package/README.md CHANGED
@@ -13,9 +13,9 @@ The engine behind [Peek](https://peektracker.com) ([GitHub](https://github.com/p
13
13
  [![License: Apache-2.0](https://img.shields.io/badge/core-Apache--2.0-blue.svg)](LICENSE)
14
14
 
15
15
  <!-- GENERATED:summary -->
16
- **3,500+ carriers** through **114 dedicated adapters** and **5 universal fallbacks**
16
+ **3,500+ carriers** through **115 dedicated adapters** and **5 universal fallbacks**
17
17
 
18
- <sub>124 catalog entries · 58 countries represented</sub>
18
+ <sub>125 catalog entries · 58 countries represented</sub>
19
19
  <!-- /GENERATED:summary -->
20
20
 
21
21
  [Try it](#try-it) · [Ways to run it](#ways-to-run-it) · [Benchmark](#benchmark) · [Carriers](carriers/) · [Add a carrier](CONTRIBUTING.md)
@@ -155,7 +155,7 @@ createTracker({ providers: ['ParcelsApp', 'Ship24', '17TRACK', 'Postal Ninja', '
155
155
  <!-- GENERATED:stages -->
156
156
  <img src="docs/assets/stages.svg" alt="DHL: Die Sendung wurde in das Zustellfahrzeug geladen.; Mondial Relay: En cours de livraison; Correios Brazil: Objeto saiu para entrega ao destinatário; Correos Express: EN REPARTO; Yamato Transport: 配達中; La Poste / Colissimo: DISTOU. All are filed under out_for_delivery." width="760">
157
157
 
158
- The carrier folders record 2,998 such statuses, each filed under one stage.
158
+ The carrier folders record 3,036 such statuses, each filed under one stage.
159
159
  <!-- /GENERATED:stages -->
160
160
 
161
161
  Wording nobody recorded yet goes through a classifier that reads seven European languages.
@@ -171,6 +171,7 @@
171
171
  "additionalProperties": false
172
172
  },
173
173
  "localClocks": {
174
+ "description": "True when the adapter can return scans without an instant: a wall clock with no UTC offset, or provider text. Consumers can keep that history beside instants and ask fallback providers for dated scans.",
174
175
  "type": "boolean"
175
176
  },
176
177
  "browserRecognition": {
package/data/catalog.json CHANGED
@@ -222,6 +222,12 @@
222
222
  {
223
223
  "pattern": "^LP\\d{14}$",
224
224
  "confidence": "low"
225
+ },
226
+ {
227
+ "pattern": "^[A-Z]{2}\\d{9}TY$",
228
+ "confidence": "low",
229
+ "checksum": "s10",
230
+ "preferred": true
225
231
  }
226
232
  ]
227
233
  },
@@ -448,6 +454,7 @@
448
454
  "domains": [
449
455
  "dhl.com"
450
456
  ],
457
+ "pathPattern": "^/(?![a-z]+-[a-z]+/(?:home/our-divisions|ecommerce)(?:[/.]|$))",
451
458
  "params": [
452
459
  "tracking-id",
453
460
  "trackingId",
@@ -2101,7 +2108,8 @@
2101
2108
  "timezone": "UTC",
2102
2109
  "tracking": {
2103
2110
  "mode": "automatic",
2104
- "adapter": "postnord"
2111
+ "adapter": "postnord",
2112
+ "recognitionRank": 7
2105
2113
  },
2106
2114
  "canaryUrl": "https://tracking.postnord.com/en/",
2107
2115
  "trackingUrlTemplate": "https://tracking.postnord.com/en/?id={trackingNumber}",
@@ -2235,7 +2243,7 @@
2235
2243
  "www.seur.com",
2236
2244
  "seur.com"
2237
2245
  ],
2238
- "path": "^/miseur/mis-envios(?:/.*)?$",
2246
+ "pathPattern": "^/(?:(?:[a-z]{2}/?)?$|(?:[a-z]{2}/)?miseur/mis-envios(?:/|$)|livetracking(?:/|$))",
2239
2247
  "params": [
2240
2248
  "tracking"
2241
2249
  ]
@@ -2308,7 +2316,7 @@
2308
2316
  "www.nacex.es",
2309
2317
  "nacex.es"
2310
2318
  ],
2311
- "path": "^/seguimientoFormularioExterno\\.do$",
2319
+ "pathPattern": "^/(?:$|(?:irHome|(?:ir)?seguimiento[a-z]*)\\.do(?:;|$))",
2312
2320
  "params": [
2313
2321
  "intcli"
2314
2322
  ]
@@ -2467,7 +2475,7 @@
2467
2475
  "domains": [
2468
2476
  "vas.brt.it"
2469
2477
  ],
2470
- "path": "^/vas/sped_det_new\\.htm$",
2478
+ "pathPattern": "^/(?:$|vas/sped_)",
2471
2479
  "params": [
2472
2480
  "brtCode"
2473
2481
  ]
@@ -2545,7 +2553,7 @@
2545
2553
  "domains": [
2546
2554
  "tip-sa.com"
2547
2555
  ],
2548
- "path": "^/cliente/datos(?:_prestashop|_env)?\\.php$",
2556
+ "pathPattern": "^/(?:$|cliente/datos(?:_prestashop|_env)?\\.php$)",
2549
2557
  "params": [
2550
2558
  "id"
2551
2559
  ]
@@ -2574,6 +2582,7 @@
2574
2582
  "tracking": {
2575
2583
  "mode": "automatic",
2576
2584
  "adapter": "ukrposhta",
2585
+ "recognitionRank": 5,
2577
2586
  "localClocks": true
2578
2587
  },
2579
2588
  "canaryUrl": "https://track.ukrposhta.ua/en/",
@@ -2593,6 +2602,12 @@
2593
2602
  "pattern": "^\\d{13}$",
2594
2603
  "confidence": "low",
2595
2604
  "checksum": "ukrposhta"
2605
+ },
2606
+ {
2607
+ "pattern": "^[A-Z]{2}\\d{9}UA$",
2608
+ "confidence": "low",
2609
+ "checksum": "s10",
2610
+ "preferred": true
2596
2611
  }
2597
2612
  ]
2598
2613
  },
@@ -2645,6 +2660,11 @@
2645
2660
  "pattern": "^\\d{22}$",
2646
2661
  "confidence": "low"
2647
2662
  },
2663
+ {
2664
+ "pattern": "^420\\d{5}(?:(?!9[2-4])\\d{4})?(?!9[23]61)(?:91\\d{2}9\\d{17}|92\\d{3}9\\d{16}|93\\d{3}[0-8]\\d{16}|9[45]\\d{20})$",
2665
+ "confidence": "high",
2666
+ "checksum": "usps"
2667
+ },
2648
2668
  {
2649
2669
  "pattern": "^420(?:\\d{5}9[1-5]\\d{20}(?:\\d{4})?|\\d{9}9[1-5]\\d{20})$",
2650
2670
  "confidence": "low",
@@ -2969,11 +2989,13 @@
2969
2989
  "detectionRules": [
2970
2990
  {
2971
2991
  "pattern": "^(?:072|777|778|780)\\d{8}$",
2972
- "confidence": "high"
2992
+ "confidence": "high",
2993
+ "checksum": "luhn"
2973
2994
  },
2974
2995
  {
2975
2996
  "pattern": "^80\\d{9}$",
2976
- "confidence": "high"
2997
+ "confidence": "high",
2998
+ "checksum": "luhn"
2977
2999
  },
2978
3000
  {
2979
3001
  "pattern": "^\\d{11}$",
@@ -3087,7 +3109,7 @@
3087
3109
  "domains": [
3088
3110
  "cs.estafeta.com"
3089
3111
  ],
3090
- "path": "^/es/Tracking/searchByGet/?$",
3112
+ "pathPattern": "^/(?:$|(?:[a-z]{2}/)?Tracking/searchByGet/?$)",
3091
3113
  "params": [
3092
3114
  "wayBill"
3093
3115
  ]
@@ -3797,7 +3819,8 @@
3797
3819
  "timezone": "UTC",
3798
3820
  "tracking": {
3799
3821
  "mode": "automatic",
3800
- "adapter": "australia-post"
3822
+ "adapter": "australia-post",
3823
+ "recognitionRank": 6
3801
3824
  },
3802
3825
  "canaryUrl": "https://auspost.com.au/mypost/track/",
3803
3826
  "trackingUrlTemplate": "https://auspost.com.au/mypost/track/details/{trackingNumber}",
@@ -3824,7 +3847,23 @@
3824
3847
  },
3825
3848
  {
3826
3849
  "pattern": "^\\d{2}(?!\\d{3})[A-Z0-9]{3}\\d{7}$",
3850
+ "confidence": "low",
3851
+ "preferred": true
3852
+ },
3853
+ {
3854
+ "pattern": "^(?![A-Z]{2}\\d)(?!\\d{3})[A-Z0-9]{3}\\d{7}$",
3827
3855
  "confidence": "low"
3856
+ },
3857
+ {
3858
+ "pattern": "^0[0-3]\\d{20}$",
3859
+ "confidence": "low",
3860
+ "checksum": "gs1"
3861
+ },
3862
+ {
3863
+ "pattern": "^[A-Z]{2}\\d{9}AU$",
3864
+ "confidence": "low",
3865
+ "checksum": "s10",
3866
+ "preferred": true
3828
3867
  }
3829
3868
  ]
3830
3869
  },
@@ -4283,6 +4322,10 @@
4283
4322
  "pattern": "^[A-Z]{2}\\d{9}YP$",
4284
4323
  "confidence": "high",
4285
4324
  "checksum": "s10"
4325
+ },
4326
+ {
4327
+ "pattern": "^YW[A-Z]{3}\\d{12}$",
4328
+ "confidence": "high"
4286
4329
  }
4287
4330
  ]
4288
4331
  },
@@ -4308,7 +4351,7 @@
4308
4351
  "portal.thecourierguy.co.za",
4309
4352
  "track.thecourierguy.co.za"
4310
4353
  ],
4311
- "path": "^/track/?$",
4354
+ "pathPattern": "^/(?:track/?)?$",
4312
4355
  "params": [
4313
4356
  "ref"
4314
4357
  ]
@@ -4422,7 +4465,8 @@
4422
4465
  "timezone": "UTC",
4423
4466
  "tracking": {
4424
4467
  "mode": "automatic",
4425
- "adapter": "cne"
4468
+ "adapter": "cne",
4469
+ "localClocks": true
4426
4470
  },
4427
4471
  "canaryUrl": "https://www.cne.com/track",
4428
4472
  "trackingUrlTemplate": "https://www.cne.com/en/track?no={trackingNumber}",
@@ -4717,6 +4761,48 @@
4717
4761
  }
4718
4762
  ]
4719
4763
  },
4764
+ "dpd-pl": {
4765
+ "displayName": "DPD Poland",
4766
+ "color": "#dc0032",
4767
+ "aliases": [
4768
+ "DPD Polska"
4769
+ ],
4770
+ "countries": [
4771
+ "PL"
4772
+ ],
4773
+ "selectable": true,
4774
+ "timezone": "Europe/Warsaw",
4775
+ "tracking": {
4776
+ "mode": "automatic",
4777
+ "adapter": "dpd-pl",
4778
+ "recognitionRank": 8
4779
+ },
4780
+ "canaryUrl": "https://tracktrace.dpd.com.pl/EN/findParcel",
4781
+ "trackingUrlTemplate": "https://tracktrace.dpd.com.pl/EN/parcelDetails?typ=1&p1={trackingNumber}",
4782
+ "linkRules": [
4783
+ {
4784
+ "domains": [
4785
+ "tracktrace.dpd.com.pl",
4786
+ "tt.dpd.com.pl"
4787
+ ],
4788
+ "pathPattern": "^/(?:EN/)?parcelDetails$",
4789
+ "params": [
4790
+ "p1"
4791
+ ]
4792
+ }
4793
+ ],
4794
+ "detectionRules": [
4795
+ {
4796
+ "pattern": "^\\d{13}[A-Z]$",
4797
+ "confidence": "high"
4798
+ },
4799
+ {
4800
+ "pattern": "^13\\d{12}$",
4801
+ "confidence": "low",
4802
+ "preferred": true
4803
+ }
4804
+ ]
4805
+ },
4720
4806
  "dpd-uk": {
4721
4807
  "displayName": "DPD UK",
4722
4808
  "color": "#dc0032",
@@ -1,6 +1,6 @@
1
1
  {
2
- "catalog": 124,
3
- "activeAdapters": 114,
2
+ "catalog": 125,
3
+ "activeAdapters": 115,
4
4
  "countries": 58,
5
5
  "referenceCarriers": 114,
6
6
  "comparison": {