universal-parcel-scraper 0.80.0-main.943 → 0.82.0-main.949

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 (40) hide show
  1. package/README.md +2 -2
  2. package/data/catalog.json +34 -4
  3. package/data/coverage-summary.json +1 -1
  4. package/data/detection-golden.json +114 -9
  5. package/dist/browser/scraper.js +35 -7
  6. package/dist/carriers/helthjem/adapter.d.ts +15 -0
  7. package/dist/carriers/helthjem/adapter.js +75 -0
  8. package/dist/carriers/helthjem/carrier.json +70 -8
  9. package/dist/carriers/helthjem/numbers.json +38 -4
  10. package/dist/carriers/helthjem/parser.d.ts +23 -0
  11. package/dist/carriers/helthjem/parser.js +145 -0
  12. package/dist/carriers/helthjem/status.d.ts +14 -0
  13. package/dist/carriers/helthjem/status.js +50 -0
  14. package/dist/carriers/helthjem/statuses.json +20 -1
  15. package/dist/carriers/matkahuolto/adapter.d.ts +15 -0
  16. package/dist/carriers/matkahuolto/adapter.js +72 -0
  17. package/dist/carriers/matkahuolto/carrier.json +50 -7
  18. package/dist/carriers/matkahuolto/numbers.json +54 -4
  19. package/dist/carriers/matkahuolto/parser.d.ts +22 -0
  20. package/dist/carriers/matkahuolto/parser.js +163 -0
  21. package/dist/carriers/matkahuolto/status.d.ts +26 -0
  22. package/dist/carriers/matkahuolto/status.js +77 -0
  23. package/dist/carriers/matkahuolto/statuses.json +16 -1
  24. package/dist/carriers/ptt/adapter.d.ts +14 -0
  25. package/dist/carriers/ptt/adapter.js +66 -0
  26. package/dist/carriers/ptt/carrier.json +50 -7
  27. package/dist/carriers/ptt/numbers.json +8 -8
  28. package/dist/carriers/ptt/parser.d.ts +15 -0
  29. package/dist/carriers/ptt/parser.js +152 -0
  30. package/dist/carriers/ptt/status.d.ts +13 -0
  31. package/dist/carriers/ptt/status.js +57 -0
  32. package/dist/carriers/ptt/statuses.json +19 -1
  33. package/dist/core/catalog/statusMaps.js +9 -5
  34. package/dist/data/catalog.json +34 -4
  35. package/dist/generated/catalog.d.ts +29 -4
  36. package/dist/generated/catalog.js +37 -7
  37. package/dist/generated/recognition.js +3 -0
  38. package/dist/generated/registry.js +9 -3
  39. package/dist/server/openapi.json +1 -1
  40. package/package.json +1 -1
package/README.md CHANGED
@@ -13,7 +13,7 @@ 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 **137 dedicated adapters** and **5 universal fallbacks**
16
+ **3,500+ carriers** through **140 dedicated adapters** and **5 universal fallbacks**
17
17
 
18
18
  <sub>207 catalog entries · 66 countries represented</sub>
19
19
  <!-- /GENERATED:summary -->
@@ -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 3,887 such statuses, each filed under one stage.
158
+ The carrier folders record 3,936 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.
package/data/catalog.json CHANGED
@@ -6520,7 +6520,8 @@
6520
6520
  "timezone": "Europe/Oslo",
6521
6521
  "tracking": {
6522
6522
  "mode": "automatic",
6523
- "adapter": "universal"
6523
+ "adapter": "helthjem",
6524
+ "recognitionRank": 71
6524
6525
  },
6525
6526
  "canaryUrl": "https://helthjem.no/sporing",
6526
6527
  "trackingUrlTemplate": "https://helthjem.no/sporing/{trackingNumber}",
@@ -6542,7 +6543,20 @@
6542
6543
  ]
6543
6544
  }
6544
6545
  ],
6545
- "detectionRules": []
6546
+ "detectionRules": [
6547
+ {
6548
+ "pattern": "^37072476\\d{10}$",
6549
+ "confidence": "low",
6550
+ "checksum": "gs1",
6551
+ "preferred": true
6552
+ },
6553
+ {
6554
+ "pattern": "^0037072476\\d{10}$",
6555
+ "confidence": "low",
6556
+ "checksum": "sscc",
6557
+ "preferred": true
6558
+ }
6559
+ ]
6546
6560
  },
6547
6561
  "hrvatska-posta": {
6548
6562
  "displayName": "Hrvatska pošta",
@@ -7028,7 +7042,9 @@
7028
7042
  "timezone": "Europe/Helsinki",
7029
7043
  "tracking": {
7030
7044
  "mode": "automatic",
7031
- "adapter": "universal"
7045
+ "adapter": "matkahuolto",
7046
+ "recognitionRank": 69,
7047
+ "localClocks": true
7032
7048
  },
7033
7049
  "canaryUrl": "https://www.matkahuolto.fi/seuranta",
7034
7050
  "trackingUrlTemplate": "https://www.matkahuolto.fi/seuranta?parcelNumber={trackingNumber}",
@@ -7048,6 +7064,12 @@
7048
7064
  {
7049
7065
  "pattern": "^MA\\d{19}$",
7050
7066
  "confidence": "low"
7067
+ },
7068
+ {
7069
+ "pattern": "^MH\\d{9}FI$",
7070
+ "confidence": "low",
7071
+ "checksum": "s10",
7072
+ "preferred": true
7051
7073
  }
7052
7074
  ]
7053
7075
  },
@@ -7522,7 +7544,9 @@
7522
7544
  "timezone": "Europe/Istanbul",
7523
7545
  "tracking": {
7524
7546
  "mode": "automatic",
7525
- "adapter": "universal"
7547
+ "adapter": "ptt",
7548
+ "recognitionRank": 68,
7549
+ "localClocks": true
7526
7550
  },
7527
7551
  "canaryUrl": "https://www.ptt.gov.tr/",
7528
7552
  "trackingUrlTemplate": "https://www.ptt.gov.tr/",
@@ -7532,6 +7556,12 @@
7532
7556
  {
7533
7557
  "pattern": "^KP\\d{11}$",
7534
7558
  "confidence": "high"
7559
+ },
7560
+ {
7561
+ "pattern": "^[A-Z]{2}\\d{9}TR$",
7562
+ "confidence": "low",
7563
+ "checksum": "s10",
7564
+ "preferred": true
7535
7565
  }
7536
7566
  ]
7537
7567
  },
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "catalog": 207,
3
- "activeAdapters": 137,
3
+ "activeAdapters": 140,
4
4
  "countries": 66,
5
5
  "referenceCarriers": 100,
6
6
  "comparison": {
@@ -724,15 +724,18 @@
724
724
  "confidence": "low",
725
725
  "candidates": [
726
726
  "bring-posten",
727
+ "helthjem",
727
728
  "swiss-post-cargo",
728
729
  "postnord",
729
730
  "usps",
730
731
  "nz-post"
731
732
  ],
732
733
  "preferred": [
733
- "bring-posten"
734
+ "bring-posten",
735
+ "helthjem"
734
736
  ],
735
737
  "asked": [
738
+ "helthjem",
736
739
  "swiss-post-cargo",
737
740
  "postnord",
738
741
  "nz-post"
@@ -744,15 +747,18 @@
744
747
  "confidence": "low",
745
748
  "candidates": [
746
749
  "bring-posten",
750
+ "helthjem",
747
751
  "swiss-post-cargo",
748
752
  "postnord",
749
753
  "usps",
750
754
  "nz-post"
751
755
  ],
752
756
  "preferred": [
753
- "bring-posten"
757
+ "bring-posten",
758
+ "helthjem"
754
759
  ],
755
760
  "asked": [
761
+ "helthjem",
756
762
  "swiss-post-cargo",
757
763
  "postnord",
758
764
  "nz-post"
@@ -764,15 +770,18 @@
764
770
  "confidence": "low",
765
771
  "candidates": [
766
772
  "bring-posten",
773
+ "helthjem",
767
774
  "swiss-post-cargo",
768
775
  "postnord",
769
776
  "usps",
770
777
  "nz-post"
771
778
  ],
772
779
  "preferred": [
773
- "bring-posten"
780
+ "bring-posten",
781
+ "helthjem"
774
782
  ],
775
783
  "asked": [
784
+ "helthjem",
776
785
  "swiss-post-cargo",
777
786
  "postnord",
778
787
  "nz-post"
@@ -784,15 +793,18 @@
784
793
  "confidence": "low",
785
794
  "candidates": [
786
795
  "bring-posten",
796
+ "helthjem",
787
797
  "swiss-post-cargo",
788
798
  "postnord",
789
799
  "usps",
790
800
  "nz-post"
791
801
  ],
792
802
  "preferred": [
793
- "bring-posten"
803
+ "bring-posten",
804
+ "helthjem"
794
805
  ],
795
806
  "asked": [
807
+ "helthjem",
796
808
  "swiss-post-cargo",
797
809
  "postnord",
798
810
  "nz-post"
@@ -878,6 +890,26 @@
878
890
  "nz-post"
879
891
  ]
880
892
  },
893
+ {
894
+ "input": "00373325386135005969",
895
+ "carrier": "unknown",
896
+ "confidence": "low",
897
+ "candidates": [
898
+ "bring-posten",
899
+ "swiss-post-cargo",
900
+ "postnord",
901
+ "usps",
902
+ "nz-post"
903
+ ],
904
+ "preferred": [
905
+ "bring-posten"
906
+ ],
907
+ "asked": [
908
+ "swiss-post-cargo",
909
+ "postnord",
910
+ "nz-post"
911
+ ]
912
+ },
881
913
  {
882
914
  "input": "00373402216033677037",
883
915
  "carrier": "unknown",
@@ -13974,13 +14006,16 @@
13974
14006
  "confidence": "low",
13975
14007
  "candidates": [
13976
14008
  "bring-posten",
14009
+ "helthjem",
13977
14010
  "bpost",
13978
14011
  "ecoscooting"
13979
14012
  ],
13980
14013
  "preferred": [
13981
- "bring-posten"
14014
+ "bring-posten",
14015
+ "helthjem"
13982
14016
  ],
13983
14017
  "asked": [
14018
+ "helthjem",
13984
14019
  "bpost"
13985
14020
  ]
13986
14021
  },
@@ -13990,13 +14025,16 @@
13990
14025
  "confidence": "low",
13991
14026
  "candidates": [
13992
14027
  "bring-posten",
14028
+ "helthjem",
13993
14029
  "bpost",
13994
14030
  "ecoscooting"
13995
14031
  ],
13996
14032
  "preferred": [
13997
- "bring-posten"
14033
+ "bring-posten",
14034
+ "helthjem"
13998
14035
  ],
13999
14036
  "asked": [
14037
+ "helthjem",
14000
14038
  "bpost"
14001
14039
  ]
14002
14040
  },
@@ -14006,13 +14044,16 @@
14006
14044
  "confidence": "low",
14007
14045
  "candidates": [
14008
14046
  "bring-posten",
14047
+ "helthjem",
14009
14048
  "bpost",
14010
14049
  "ecoscooting"
14011
14050
  ],
14012
14051
  "preferred": [
14013
- "bring-posten"
14052
+ "bring-posten",
14053
+ "helthjem"
14014
14054
  ],
14015
14055
  "asked": [
14056
+ "helthjem",
14016
14057
  "bpost"
14017
14058
  ]
14018
14059
  },
@@ -14022,13 +14063,16 @@
14022
14063
  "confidence": "low",
14023
14064
  "candidates": [
14024
14065
  "bring-posten",
14066
+ "helthjem",
14025
14067
  "bpost",
14026
14068
  "ecoscooting"
14027
14069
  ],
14028
14070
  "preferred": [
14029
- "bring-posten"
14071
+ "bring-posten",
14072
+ "helthjem"
14030
14073
  ],
14031
14074
  "asked": [
14075
+ "helthjem",
14032
14076
  "bpost"
14033
14077
  ]
14034
14078
  },
@@ -14038,13 +14082,35 @@
14038
14082
  "confidence": "low",
14039
14083
  "candidates": [
14040
14084
  "bring-posten",
14085
+ "helthjem",
14041
14086
  "bpost",
14042
14087
  "ecoscooting"
14043
14088
  ],
14044
14089
  "preferred": [
14045
- "bring-posten"
14090
+ "bring-posten",
14091
+ "helthjem"
14092
+ ],
14093
+ "asked": [
14094
+ "helthjem",
14095
+ "bpost"
14096
+ ]
14097
+ },
14098
+ {
14099
+ "input": "370724763572871481",
14100
+ "carrier": "unknown",
14101
+ "confidence": "low",
14102
+ "candidates": [
14103
+ "bring-posten",
14104
+ "helthjem",
14105
+ "bpost",
14106
+ "ecoscooting"
14107
+ ],
14108
+ "preferred": [
14109
+ "bring-posten",
14110
+ "helthjem"
14046
14111
  ],
14047
14112
  "asked": [
14113
+ "helthjem",
14048
14114
  "bpost"
14049
14115
  ]
14050
14116
  },
@@ -14316,6 +14382,22 @@
14316
14382
  "bpost"
14317
14383
  ]
14318
14384
  },
14385
+ {
14386
+ "input": "373325386445334247",
14387
+ "carrier": "unknown",
14388
+ "confidence": "low",
14389
+ "candidates": [
14390
+ "bring-posten",
14391
+ "bpost",
14392
+ "ecoscooting"
14393
+ ],
14394
+ "preferred": [
14395
+ "bring-posten"
14396
+ ],
14397
+ "asked": [
14398
+ "bpost"
14399
+ ]
14400
+ },
14319
14401
  {
14320
14402
  "input": "37340183786",
14321
14403
  "carrier": "unknown",
@@ -26315,6 +26397,7 @@
26315
26397
  "intl-post"
26316
26398
  ],
26317
26399
  "asked": [
26400
+ "ptt",
26318
26401
  "chronopost"
26319
26402
  ]
26320
26403
  },
@@ -27580,6 +27663,7 @@
27580
27663
  "intl-post"
27581
27664
  ],
27582
27665
  "asked": [
27666
+ "ptt",
27583
27667
  "chronopost"
27584
27668
  ]
27585
27669
  },
@@ -31484,6 +31568,9 @@
31484
31568
  "confidence": "low",
31485
31569
  "candidates": [
31486
31570
  "matkahuolto"
31571
+ ],
31572
+ "asked": [
31573
+ "matkahuolto"
31487
31574
  ]
31488
31575
  },
31489
31576
  {
@@ -31492,6 +31579,9 @@
31492
31579
  "confidence": "low",
31493
31580
  "candidates": [
31494
31581
  "matkahuolto"
31582
+ ],
31583
+ "asked": [
31584
+ "matkahuolto"
31495
31585
  ]
31496
31586
  },
31497
31587
  {
@@ -31500,6 +31590,9 @@
31500
31590
  "confidence": "low",
31501
31591
  "candidates": [
31502
31592
  "matkahuolto"
31593
+ ],
31594
+ "asked": [
31595
+ "matkahuolto"
31503
31596
  ]
31504
31597
  },
31505
31598
  {
@@ -31508,6 +31601,9 @@
31508
31601
  "confidence": "low",
31509
31602
  "candidates": [
31510
31603
  "matkahuolto"
31604
+ ],
31605
+ "asked": [
31606
+ "matkahuolto"
31511
31607
  ]
31512
31608
  },
31513
31609
  {
@@ -31522,6 +31618,9 @@
31522
31618
  "confidence": "low",
31523
31619
  "candidates": [
31524
31620
  "matkahuolto"
31621
+ ],
31622
+ "asked": [
31623
+ "matkahuolto"
31525
31624
  ]
31526
31625
  },
31527
31626
  {
@@ -31532,6 +31631,7 @@
31532
31631
  "intl-post"
31533
31632
  ],
31534
31633
  "asked": [
31634
+ "matkahuolto",
31535
31635
  "posti",
31536
31636
  "chronopost"
31537
31637
  ]
@@ -31544,6 +31644,7 @@
31544
31644
  "intl-post"
31545
31645
  ],
31546
31646
  "asked": [
31647
+ "matkahuolto",
31547
31648
  "posti",
31548
31649
  "chronopost"
31549
31650
  ]
@@ -31556,6 +31657,7 @@
31556
31657
  "intl-post"
31557
31658
  ],
31558
31659
  "asked": [
31660
+ "matkahuolto",
31559
31661
  "posti",
31560
31662
  "chronopost"
31561
31663
  ]
@@ -31568,6 +31670,7 @@
31568
31670
  "intl-post"
31569
31671
  ],
31570
31672
  "asked": [
31673
+ "matkahuolto",
31571
31674
  "posti",
31572
31675
  "chronopost"
31573
31676
  ]
@@ -33724,6 +33827,7 @@
33724
33827
  "intl-post"
33725
33828
  ],
33726
33829
  "asked": [
33830
+ "ptt",
33727
33831
  "chronopost"
33728
33832
  ]
33729
33833
  },
@@ -36640,6 +36744,7 @@
36640
36744
  "intl-post"
36641
36745
  ],
36642
36746
  "asked": [
36747
+ "matkahuolto",
36643
36748
  "posti",
36644
36749
  "chronopost"
36645
36750
  ]
@@ -5202,7 +5202,8 @@ var ye = {
5202
5202
  timezone: "Europe/Oslo",
5203
5203
  tracking: {
5204
5204
  mode: "automatic",
5205
- adapter: "universal"
5205
+ adapter: "helthjem",
5206
+ recognitionRank: 71
5206
5207
  },
5207
5208
  canaryUrl: "https://helthjem.no/sporing",
5208
5209
  trackingUrlTemplate: "https://helthjem.no/sporing/{trackingNumber}",
@@ -5215,7 +5216,17 @@ var ye = {
5215
5216
  pathPattern: "^/sporing/?$",
5216
5217
  params: ["sporingsnummer"]
5217
5218
  }],
5218
- detectionRules: []
5219
+ detectionRules: [{
5220
+ pattern: "^37072476\\d{10}$",
5221
+ confidence: "low",
5222
+ checksum: "gs1",
5223
+ preferred: !0
5224
+ }, {
5225
+ pattern: "^0037072476\\d{10}$",
5226
+ confidence: "low",
5227
+ checksum: "sscc",
5228
+ preferred: !0
5229
+ }]
5219
5230
  },
5220
5231
  "hrvatska-posta": {
5221
5232
  displayName: "Hrvatska pošta",
@@ -5576,7 +5587,9 @@ var ye = {
5576
5587
  timezone: "Europe/Helsinki",
5577
5588
  tracking: {
5578
5589
  mode: "automatic",
5579
- adapter: "universal"
5590
+ adapter: "matkahuolto",
5591
+ recognitionRank: 69,
5592
+ localClocks: !0
5580
5593
  },
5581
5594
  canaryUrl: "https://www.matkahuolto.fi/seuranta",
5582
5595
  trackingUrlTemplate: "https://www.matkahuolto.fi/seuranta?parcelNumber={trackingNumber}",
@@ -5589,6 +5602,11 @@ var ye = {
5589
5602
  detectionRules: [{
5590
5603
  pattern: "^MA\\d{19}$",
5591
5604
  confidence: "low"
5605
+ }, {
5606
+ pattern: "^MH\\d{9}FI$",
5607
+ confidence: "low",
5608
+ checksum: "s10",
5609
+ preferred: !0
5592
5610
  }]
5593
5611
  },
5594
5612
  meest: {
@@ -5966,7 +5984,9 @@ var ye = {
5966
5984
  timezone: "Europe/Istanbul",
5967
5985
  tracking: {
5968
5986
  mode: "automatic",
5969
- adapter: "universal"
5987
+ adapter: "ptt",
5988
+ recognitionRank: 68,
5989
+ localClocks: !0
5970
5990
  },
5971
5991
  canaryUrl: "https://www.ptt.gov.tr/",
5972
5992
  trackingUrlTemplate: "https://www.ptt.gov.tr/",
@@ -5975,6 +5995,11 @@ var ye = {
5975
5995
  detectionRules: [{
5976
5996
  pattern: "^KP\\d{11}$",
5977
5997
  confidence: "high"
5998
+ }, {
5999
+ pattern: "^[A-Z]{2}\\d{9}TR$",
6000
+ confidence: "low",
6001
+ checksum: "s10",
6002
+ preferred: !0
5978
6003
  }]
5979
6004
  },
5980
6005
  redpack: {
@@ -6970,7 +6995,7 @@ var ye = {
6970
6995
  "go-express": [],
6971
6996
  "gofo-fr": ["gofo-fr-1", "gofo-fr-2"],
6972
6997
  "gofo-it": ["gofo-it-1"],
6973
- helthjem: [],
6998
+ helthjem: ["helthjem-1", "helthjem-2"],
6974
6999
  "hrvatska-posta": [],
6975
7000
  instabox: [],
6976
7001
  intelcom: [
@@ -6988,7 +7013,7 @@ var ye = {
6988
7013
  lso: ["lso-1"],
6989
7014
  "magyar-posta": [],
6990
7015
  maltapost: [],
6991
- matkahuolto: ["matkahuolto-1"],
7016
+ matkahuolto: ["matkahuolto-1", "matkahuolto-2"],
6992
7017
  meest: [],
6993
7018
  "mng-kargo": [],
6994
7019
  nationex: [],
@@ -7007,7 +7032,7 @@ var ye = {
7007
7032
  "posta-slovenije": [],
7008
7033
  "posta-srbije": [],
7009
7034
  ppl: [],
7010
- ptt: ["ptt-1"],
7035
+ ptt: ["ptt-1", "ptt-s10"],
7011
7036
  redpack: [],
7012
7037
  "rl-carriers": ["rl-carriers-1"],
7013
7038
  "russian-post": [],
@@ -11752,11 +11777,13 @@ var _c = {
11752
11777
  "gls-it": 59,
11753
11778
  "gofo-fr": 3,
11754
11779
  "gofo-it": 2,
11780
+ helthjem: 71,
11755
11781
  "hermes-de": 40,
11756
11782
  inpost: 38,
11757
11783
  "j-and-t": 9,
11758
11784
  "j-and-t-cargo": 47,
11759
11785
  "la-poste": 80,
11786
+ matkahuolto: 69,
11760
11787
  nacex: 41,
11761
11788
  "ninja-van": 28,
11762
11789
  "nz-post": 32,
@@ -11769,6 +11796,7 @@ var _c = {
11769
11796
  posti: 27,
11770
11797
  postlogistics: 26,
11771
11798
  postnord: 7,
11799
+ ptt: 68,
11772
11800
  purolator: 12,
11773
11801
  "relais-colis": 25,
11774
11802
  sameday: 53,
@@ -0,0 +1,15 @@
1
+ import { type AdapterFactory, type TrackingContext } from '../../core/adapter/index.js';
2
+ import type { CarrierResult } from '../../core/result/index.js';
3
+ import { type StepRecorder } from '../../core/telemetry/index.js';
4
+ export declare const HELTHJEM_ENDPOINT = "https://services.helthjem.no/graphql";
5
+ export declare const HELTHJEM_QUERY = "query GetTracking($parcelReference: String!) {\n getParcelTrackingDetails(parcelReference: $parcelReference) {\n parcelReference\n trackingNumber\n shipmentNumber\n status\n isPostnordProduct\n events { apiKey status createdAt location message { content } }\n servicePoint { name }\n shop { name }\n }\n}";
6
+ export declare class HelthjemTracker {
7
+ private readonly options;
8
+ constructor(options?: {
9
+ fetcher?: typeof fetch;
10
+ recorder?: StepRecorder;
11
+ userAgent?: string;
12
+ });
13
+ fetch(raw: string, context?: TrackingContext): Promise<CarrierResult>;
14
+ }
15
+ export declare const adapter: AdapterFactory;
@@ -0,0 +1,75 @@
1
+ import { accepted, recognizeFromLookup } from '../../core/adapter/index.js';
2
+ import { ChallengeError, SchemaError, TransportError, UpstreamHttpError } from '../../core/errors/index.js';
3
+ import { runSteps } from '../../core/runner/index.js';
4
+ import { firstAttemptMs, networkRetryStep } from '../../core/runner/networkRetry.js';
5
+ import { NOOP_RECORDER } from '../../core/telemetry/index.js';
6
+ import { decodeText, fetchBounded, parseJsonBytes, userAgentOf } from '../../core/transport/index.js';
7
+ import { HELTHJEM_MAX_BYTES, normalizeHelthjemNumber, parseHelthjem, PROVIDER } from './parser.js';
8
+ // The GraphQL service helthjem.no/sporing asks, without a key, cookie or token.
9
+ export const HELTHJEM_ENDPOINT = 'https://services.helthjem.no/graphql';
10
+ // The fields the adapter reads: no addresses, postcodes, phone numbers or coordinates.
11
+ export const HELTHJEM_QUERY = `query GetTracking($parcelReference: String!) {
12
+ getParcelTrackingDetails(parcelReference: $parcelReference) {
13
+ parcelReference
14
+ trackingNumber
15
+ shipmentNumber
16
+ status
17
+ isPostnordProduct
18
+ events { apiKey status createdAt location message { content } }
19
+ servicePoint { name }
20
+ shop { name }
21
+ }
22
+ }`;
23
+ // A CloudFront or Cloudflare block page instead of the service's JSON.
24
+ const BLOCKED = /<title>\s*(?:Just a moment|Attention Required|ERROR: The request could not be satisfied)|Request blocked|cf-chl-|cf-turnstile/i;
25
+ export class HelthjemTracker {
26
+ options;
27
+ constructor(options = {}) {
28
+ this.options = options;
29
+ }
30
+ async fetch(raw, context = {}) {
31
+ const { reference } = normalizeHelthjemNumber(raw);
32
+ const body = JSON.stringify({ operationName: 'GetTracking', variables: { parcelReference: reference }, query: HELTHJEM_QUERY });
33
+ const read = async (signal, timeoutMs) => {
34
+ let bytes;
35
+ try {
36
+ // A query the service rejects comes back as HTTP 400 with GraphQL errors.
37
+ ({ bytes } = await fetchBounded(HELTHJEM_ENDPOINT, { method: 'POST', body, signal,
38
+ headers: { Accept: 'application/json', 'Content-Type': 'application/json', 'User-Agent': userAgentOf(this.options.userAgent) } }, { provider: PROVIDER, timeoutMs: Math.max(1, Math.floor(timeoutMs)), maxBytes: HELTHJEM_MAX_BYTES, fetcher: this.options.fetcher,
39
+ allowHttpStatuses: [400] }));
40
+ }
41
+ catch (error) {
42
+ // An unknown number is a null parcel; a missing route is not a missing parcel.
43
+ if (error instanceof UpstreamHttpError && [404, 410].includes(error.status)) {
44
+ throw new TransportError(PROVIDER, 'Helthjem tracking service is unavailable', { cause: error });
45
+ }
46
+ throw error;
47
+ }
48
+ let payload;
49
+ try {
50
+ payload = parseJsonBytes(bytes, PROVIDER);
51
+ }
52
+ catch (cause) {
53
+ if (BLOCKED.test(decodeText(bytes.subarray(0, 64_000))))
54
+ throw new ChallengeError(PROVIDER, 'Helthjem answered with a block page', { cause });
55
+ throw new SchemaError(PROVIDER, 'Helthjem returned invalid tracking JSON', { cause });
56
+ }
57
+ return parseHelthjem(payload, reference);
58
+ };
59
+ // A request that fails to reach Helthjem, or hangs, gets one more try: the
60
+ // first gets half of the budget, so the retry fits in the rest.
61
+ return runSteps({ carrier: 'helthjem', budgetMs: context.budgetMs ?? 15_000, signal: context.signal,
62
+ recorder: this.options.recorder ?? NOOP_RECORDER }, [
63
+ { id: 'direct', run: ({ signal, remainingMs }) => read(signal, firstAttemptMs(remainingMs)) },
64
+ networkRetryStep(({ signal, remainingMs }) => read(signal, remainingMs)),
65
+ ]);
66
+ }
67
+ }
68
+ export const adapter = (environment) => {
69
+ const tracker = new HelthjemTracker({ fetcher: environment.fetcher, recorder: environment.recorder, userAgent: environment.userAgent });
70
+ return {
71
+ id: 'helthjem', recordsSteps: true, steps: ['direct', 'retry'],
72
+ track: (input, context) => tracker.fetch(input.number, context),
73
+ recognize: (number, context) => recognizeFromLookup(() => tracker.fetch(number, context), () => accepted(() => normalizeHelthjemNumber(number))),
74
+ };
75
+ };