universal-parcel-scraper 0.484.0-main.2339 → 0.487.0-main.2349

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 (51) hide show
  1. package/README.md +2 -2
  2. package/data/catalog.json +21 -6
  3. package/data/coverage-summary.json +1 -1
  4. package/data/detection-golden.json +44 -267
  5. package/dist/browser/scraper.js +19 -6
  6. package/dist/carriers/fargo-courier/adapter.d.ts +16 -0
  7. package/dist/carriers/fargo-courier/adapter.js +47 -0
  8. package/dist/carriers/fargo-courier/carrier.json +68 -7
  9. package/dist/carriers/fargo-courier/numbers.json +5 -94
  10. package/dist/carriers/fargo-courier/parser.d.ts +18 -0
  11. package/dist/carriers/fargo-courier/parser.js +155 -0
  12. package/dist/carriers/fargo-courier/status.d.ts +9 -0
  13. package/dist/carriers/fargo-courier/status.js +34 -0
  14. package/dist/carriers/fargo-courier/statuses.json +12 -6
  15. package/dist/carriers/gs-postbox/adapter.d.ts +15 -0
  16. package/dist/carriers/gs-postbox/adapter.js +50 -0
  17. package/dist/carriers/gs-postbox/carrier.json +51 -7
  18. package/dist/carriers/gs-postbox/numbers.json +5 -285
  19. package/dist/carriers/gs-postbox/parser.d.ts +14 -0
  20. package/dist/carriers/gs-postbox/parser.js +185 -0
  21. package/dist/carriers/gs-postbox/status.d.ts +7 -0
  22. package/dist/carriers/gs-postbox/status.js +50 -0
  23. package/dist/carriers/gs-postbox/statuses.json +5 -0
  24. package/dist/carriers/kyrgyz-post/adapter.d.ts +17 -0
  25. package/dist/carriers/kyrgyz-post/adapter.js +63 -0
  26. package/dist/carriers/kyrgyz-post/carrier.json +39 -7
  27. package/dist/carriers/kyrgyz-post/numbers.json +57 -0
  28. package/dist/carriers/kyrgyz-post/parser.d.ts +19 -0
  29. package/dist/carriers/kyrgyz-post/parser.js +131 -0
  30. package/dist/carriers/kyrgyz-post/status.d.ts +8 -0
  31. package/dist/carriers/kyrgyz-post/status.js +46 -0
  32. package/dist/carriers/kyrgyz-post/statuses.json +12 -1
  33. package/dist/carriers/mauritius-post/adapter.d.ts +15 -0
  34. package/dist/carriers/mauritius-post/adapter.js +52 -0
  35. package/dist/carriers/mauritius-post/carrier.json +37 -7
  36. package/dist/carriers/mauritius-post/parser.d.ts +23 -0
  37. package/dist/carriers/mauritius-post/parser.js +142 -0
  38. package/dist/carriers/mauritius-post/status.d.ts +11 -0
  39. package/dist/carriers/mauritius-post/status.js +40 -0
  40. package/dist/carriers/mauritius-post/statuses.json +9 -3
  41. package/dist/carriers/united-worldwide-couriers/carrier.json +2 -2
  42. package/dist/core/catalog/statusMaps.js +10 -5
  43. package/dist/data/catalog.json +21 -6
  44. package/dist/generated/catalog.d.ts +16 -6
  45. package/dist/generated/catalog.js +21 -6
  46. package/dist/generated/recognition.js +2 -0
  47. package/dist/generated/registry.js +12 -4
  48. package/dist/scripts/carrier-canary.d.ts +7 -0
  49. package/dist/scripts/carrier-canary.js +35 -7
  50. package/dist/server/openapi.json +1 -1
  51. 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 **526 dedicated adapters** and **5 universal fallbacks**
16
+ **3,500+ carriers** through **530 dedicated adapters** and **5 universal fallbacks**
17
17
 
18
18
  <sub>772 catalog entries · 134 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 15,327 such statuses, each filed under one stage.
158
+ The carrier folders record 15,354 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
@@ -13373,7 +13373,8 @@
13373
13373
  "timezone": "Africa/Nairobi",
13374
13374
  "tracking": {
13375
13375
  "mode": "automatic",
13376
- "adapter": "universal"
13376
+ "adapter": "fargo-courier",
13377
+ "localClocks": true
13377
13378
  },
13378
13379
  "canaryUrl": "https://www.fargocourier.co.ke/",
13379
13380
  "trackingUrlTemplate": "https://www.fargocourier.co.ke/waybill-viewer/?wayBill={trackingNumber}",
@@ -13408,6 +13409,15 @@
13408
13409
  "params": [
13409
13410
  "waybill_number"
13410
13411
  ]
13412
+ },
13413
+ {
13414
+ "domains": [
13415
+ "portal.fargocourier.co.ke"
13416
+ ],
13417
+ "pathPattern": "^/track/?$",
13418
+ "params": [
13419
+ "wayBillNumber"
13420
+ ]
13411
13421
  }
13412
13422
  ],
13413
13423
  "detectionRules": [
@@ -15331,7 +15341,9 @@
15331
15341
  "timezone": "Asia/Seoul",
15332
15342
  "tracking": {
15333
15343
  "mode": "automatic",
15334
- "adapter": "universal"
15344
+ "adapter": "gs-postbox",
15345
+ "recognitionRank": 634,
15346
+ "localClocks": true
15335
15347
  },
15336
15348
  "canaryUrl": "https://www.cvsnet.co.kr/reservation-inquiry/delivery/index.do",
15337
15349
  "trackingUrlTemplate": "https://www.cvsnet.co.kr/invoice/tracking.do?invoice_no={trackingNumber}",
@@ -18294,7 +18306,9 @@
18294
18306
  "timezone": "Asia/Bishkek",
18295
18307
  "tracking": {
18296
18308
  "mode": "automatic",
18297
- "adapter": "universal"
18309
+ "adapter": "kyrgyz-post",
18310
+ "recognitionRank": 702,
18311
+ "localClocks": true
18298
18312
  },
18299
18313
  "canaryUrl": "https://post.kg/language/ru/treking-posylok/",
18300
18314
  "trackingSearchUrl": "https://post.kg/language/ru/treking-posylok/",
@@ -19864,7 +19878,8 @@
19864
19878
  "timezone": "Indian/Mauritius",
19865
19879
  "tracking": {
19866
19880
  "mode": "automatic",
19867
- "adapter": "universal"
19881
+ "adapter": "mauritius-post",
19882
+ "localClocks": true
19868
19883
  },
19869
19884
  "canaryUrl": "https://www.mauritiuspost.mu/track-trace/",
19870
19885
  "trackingUrlTemplate": "https://www.mauritiuspost.mu/track-trace/?tracking_code={trackingNumber}",
@@ -29333,8 +29348,8 @@
29333
29348
  "mode": "automatic",
29334
29349
  "adapter": "universal"
29335
29350
  },
29336
- "canaryUrl": "https://www.unitedcouriers.biz/Track.aspx",
29337
- "trackingSearchUrl": "https://www.unitedcouriers.biz/Track.aspx",
29351
+ "canaryUrl": "https://www.unitedcouriers.biz/tracking",
29352
+ "trackingSearchUrl": "https://www.unitedcouriers.biz/tracking",
29338
29353
  "linkRules": [
29339
29354
  {
29340
29355
  "domains": [
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "catalog": 772,
3
- "activeAdapters": 526,
3
+ "activeAdapters": 530,
4
4
  "countries": 134,
5
5
  "referenceCarriers": 100,
6
6
  "comparison": {
@@ -23487,12 +23487,15 @@
23487
23487
  ]
23488
23488
  },
23489
23489
  {
23490
- "input": "210019328875",
23490
+ "input": "210000091000",
23491
23491
  "carrier": "unknown",
23492
23492
  "confidence": "low",
23493
23493
  "candidates": [
23494
+ "gls-ch",
23494
23495
  "mondial-relay",
23496
+ "gls-fr",
23495
23497
  "colis-prive",
23498
+ "gls-de",
23496
23499
  "mrw",
23497
23500
  "brt",
23498
23501
  "japan-post",
@@ -23503,14 +23506,15 @@
23503
23506
  "j-and-t",
23504
23507
  "lbc-express",
23505
23508
  "metropolitan-warehouse",
23506
- "sagawa"
23509
+ "sagawa",
23510
+ "saia"
23507
23511
  ],
23508
23512
  "asked": [
23513
+ "gls-fr",
23514
+ "gls-de",
23515
+ "gls-ch",
23509
23516
  "brt",
23510
- "colis-prive",
23511
- "sto",
23512
- "j-and-t",
23513
- "zto"
23517
+ "colis-prive"
23514
23518
  ]
23515
23519
  },
23516
23520
  {
@@ -23647,37 +23651,6 @@
23647
23651
  "delhivery"
23648
23652
  ]
23649
23653
  },
23650
- {
23651
- "input": "210112597100",
23652
- "carrier": "unknown",
23653
- "confidence": "low",
23654
- "candidates": [
23655
- "gls-ch",
23656
- "mondial-relay",
23657
- "gls-fr",
23658
- "colis-prive",
23659
- "gls-de",
23660
- "mrw",
23661
- "brt",
23662
- "japan-post",
23663
- "sf-express",
23664
- "sto",
23665
- "zto",
23666
- "yamato",
23667
- "j-and-t",
23668
- "lbc-express",
23669
- "metropolitan-warehouse",
23670
- "sagawa",
23671
- "saia"
23672
- ],
23673
- "asked": [
23674
- "gls-fr",
23675
- "gls-de",
23676
- "gls-ch",
23677
- "brt",
23678
- "colis-prive"
23679
- ]
23680
- },
23681
23654
  {
23682
23655
  "input": "2101217760966",
23683
23656
  "carrier": "unknown",
@@ -23747,34 +23720,6 @@
23747
23720
  "seur"
23748
23721
  ]
23749
23722
  },
23750
- {
23751
- "input": "210149357316",
23752
- "carrier": "unknown",
23753
- "confidence": "low",
23754
- "candidates": [
23755
- "mondial-relay",
23756
- "colis-prive",
23757
- "mrw",
23758
- "brt",
23759
- "purolator",
23760
- "japan-post",
23761
- "sf-express",
23762
- "sto",
23763
- "zto",
23764
- "yamato",
23765
- "j-and-t",
23766
- "lbc-express",
23767
- "metropolitan-warehouse",
23768
- "sagawa"
23769
- ],
23770
- "asked": [
23771
- "purolator",
23772
- "brt",
23773
- "colis-prive",
23774
- "sto",
23775
- "j-and-t"
23776
- ]
23777
- },
23778
23723
  {
23779
23724
  "input": "2101501383925",
23780
23725
  "carrier": "unknown",
@@ -23985,36 +23930,6 @@
23985
23930
  "dpd-de"
23986
23931
  ]
23987
23932
  },
23988
- {
23989
- "input": "210418851215",
23990
- "carrier": "unknown",
23991
- "confidence": "low",
23992
- "candidates": [
23993
- "sf-express",
23994
- "mondial-relay",
23995
- "colis-prive",
23996
- "mrw",
23997
- "brt",
23998
- "japan-post",
23999
- "sto",
24000
- "zto",
24001
- "yamato",
24002
- "j-and-t",
24003
- "lbc-express",
24004
- "metropolitan-warehouse",
24005
- "sagawa"
24006
- ],
24007
- "preferred": [
24008
- "sf-express"
24009
- ],
24010
- "asked": [
24011
- "brt",
24012
- "colis-prive",
24013
- "sto",
24014
- "j-and-t",
24015
- "zto"
24016
- ]
24017
- },
24018
23933
  {
24019
23934
  "input": "21048100002863",
24020
23935
  "carrier": "unknown",
@@ -24040,64 +23955,6 @@
24040
23955
  "seur"
24041
23956
  ]
24042
23957
  },
24043
- {
24044
- "input": "210490806120",
24045
- "carrier": "unknown",
24046
- "confidence": "low",
24047
- "candidates": [
24048
- "fedex",
24049
- "mondial-relay",
24050
- "colis-prive",
24051
- "mrw",
24052
- "brt",
24053
- "japan-post",
24054
- "sf-express",
24055
- "sto",
24056
- "zto",
24057
- "yamato",
24058
- "j-and-t",
24059
- "lbc-express",
24060
- "metropolitan-warehouse",
24061
- "sagawa"
24062
- ],
24063
- "preferred": [
24064
- "fedex"
24065
- ],
24066
- "asked": [
24067
- "brt",
24068
- "colis-prive",
24069
- "sto",
24070
- "j-and-t",
24071
- "zto"
24072
- ]
24073
- },
24074
- {
24075
- "input": "210518693206",
24076
- "carrier": "unknown",
24077
- "confidence": "low",
24078
- "candidates": [
24079
- "mondial-relay",
24080
- "colis-prive",
24081
- "mrw",
24082
- "brt",
24083
- "japan-post",
24084
- "sf-express",
24085
- "sto",
24086
- "zto",
24087
- "yamato",
24088
- "j-and-t",
24089
- "lbc-express",
24090
- "metropolitan-warehouse",
24091
- "sagawa"
24092
- ],
24093
- "asked": [
24094
- "brt",
24095
- "colis-prive",
24096
- "sto",
24097
- "j-and-t",
24098
- "zto"
24099
- ]
24100
- },
24101
23958
  {
24102
23959
  "input": "21055749855",
24103
23960
  "carrier": "unknown",
@@ -24145,33 +24002,6 @@
24145
24002
  "seur"
24146
24003
  ]
24147
24004
  },
24148
- {
24149
- "input": "210561556354",
24150
- "carrier": "unknown",
24151
- "confidence": "low",
24152
- "candidates": [
24153
- "mondial-relay",
24154
- "colis-prive",
24155
- "mrw",
24156
- "brt",
24157
- "japan-post",
24158
- "sf-express",
24159
- "sto",
24160
- "zto",
24161
- "yamato",
24162
- "j-and-t",
24163
- "lbc-express",
24164
- "metropolitan-warehouse",
24165
- "sagawa"
24166
- ],
24167
- "asked": [
24168
- "brt",
24169
- "colis-prive",
24170
- "sto",
24171
- "j-and-t",
24172
- "zto"
24173
- ]
24174
- },
24175
24005
  {
24176
24006
  "input": "21101636263",
24177
24007
  "carrier": "unknown",
@@ -27769,14 +27599,6 @@
27769
27599
  "j-and-t"
27770
27600
  ]
27771
27601
  },
27772
- {
27773
- "input": "2583552",
27774
- "carrier": "unknown",
27775
- "confidence": "low",
27776
- "candidates": [
27777
- "seur"
27778
- ]
27779
- },
27780
27602
  {
27781
27603
  "input": "2584500021846",
27782
27604
  "carrier": "unknown",
@@ -29170,14 +28992,6 @@
29170
28992
  "brt"
29171
28993
  ]
29172
28994
  },
29173
- {
29174
- "input": "2769313",
29175
- "carrier": "unknown",
29176
- "confidence": "low",
29177
- "candidates": [
29178
- "seur"
29179
- ]
29180
- },
29181
28995
  {
29182
28996
  "input": "277113023235",
29183
28997
  "carrier": "unknown",
@@ -34579,35 +34393,6 @@
34579
34393
  "zto"
34580
34394
  ]
34581
34395
  },
34582
- {
34583
- "input": "363853763583",
34584
- "carrier": "unknown",
34585
- "confidence": "low",
34586
- "candidates": [
34587
- "fedex",
34588
- "mondial-relay",
34589
- "colis-prive",
34590
- "mrw",
34591
- "poste-italiane",
34592
- "brt",
34593
- "sf-express",
34594
- "sto",
34595
- "zto",
34596
- "j-and-t",
34597
- "lbc-express",
34598
- "metropolitan-warehouse"
34599
- ],
34600
- "preferred": [
34601
- "fedex"
34602
- ],
34603
- "asked": [
34604
- "poste-italiane",
34605
- "brt",
34606
- "colis-prive",
34607
- "sto",
34608
- "j-and-t"
34609
- ]
34610
- },
34611
34396
  {
34612
34397
  "input": "36391986567",
34613
34398
  "carrier": "unknown",
@@ -34686,31 +34471,6 @@
34686
34471
  "zto"
34687
34472
  ]
34688
34473
  },
34689
- {
34690
- "input": "364893684316",
34691
- "carrier": "unknown",
34692
- "confidence": "low",
34693
- "candidates": [
34694
- "mondial-relay",
34695
- "colis-prive",
34696
- "mrw",
34697
- "brt",
34698
- "purolator",
34699
- "sf-express",
34700
- "sto",
34701
- "zto",
34702
- "j-and-t",
34703
- "lbc-express",
34704
- "metropolitan-warehouse"
34705
- ],
34706
- "asked": [
34707
- "purolator",
34708
- "brt",
34709
- "colis-prive",
34710
- "sto",
34711
- "j-and-t"
34712
- ]
34713
- },
34714
34474
  {
34715
34475
  "input": "3650251",
34716
34476
  "carrier": "unknown",
@@ -71891,23 +71651,7 @@
71891
71651
  ]
71892
71652
  },
71893
71653
  {
71894
- "input": "FCLIN10000001",
71895
- "carrier": "fargo-courier",
71896
- "confidence": "high",
71897
- "candidates": [
71898
- "fargo-courier"
71899
- ]
71900
- },
71901
- {
71902
- "input": "FCLIN10845428",
71903
- "carrier": "fargo-courier",
71904
- "confidence": "high",
71905
- "candidates": [
71906
- "fargo-courier"
71907
- ]
71908
- },
71909
- {
71910
- "input": "FCLIN11000000",
71654
+ "input": "FCLIN00000000",
71911
71655
  "carrier": "fargo-courier",
71912
71656
  "confidence": "high",
71913
71657
  "candidates": [
@@ -77828,6 +77572,17 @@
77828
77572
  "chronopost"
77829
77573
  ]
77830
77574
  },
77575
+ {
77576
+ "input": "LS032330034RU",
77577
+ "carrier": "intl-post",
77578
+ "confidence": "high",
77579
+ "candidates": [
77580
+ "intl-post"
77581
+ ],
77582
+ "asked": [
77583
+ "chronopost"
77584
+ ]
77585
+ },
77831
77586
  {
77832
77587
  "input": "LS232735825CH",
77833
77588
  "carrier": "swiss-post",
@@ -84107,6 +83862,17 @@
84107
83862
  "chronopost"
84108
83863
  ]
84109
83864
  },
83865
+ {
83866
+ "input": "RI500204308KG",
83867
+ "carrier": "intl-post",
83868
+ "confidence": "high",
83869
+ "candidates": [
83870
+ "intl-post"
83871
+ ],
83872
+ "asked": [
83873
+ "chronopost"
83874
+ ]
83875
+ },
84110
83876
  {
84111
83877
  "input": "RI542209425MX",
84112
83878
  "carrier": "intl-post",
@@ -84482,6 +84248,17 @@
84482
84248
  "chronopost"
84483
84249
  ]
84484
84250
  },
84251
+ {
84252
+ "input": "RO176297048RU",
84253
+ "carrier": "intl-post",
84254
+ "confidence": "high",
84255
+ "candidates": [
84256
+ "intl-post"
84257
+ ],
84258
+ "asked": [
84259
+ "chronopost"
84260
+ ]
84261
+ },
84485
84262
  {
84486
84263
  "input": "RO319055313EE",
84487
84264
  "carrier": "intl-post",
@@ -10360,7 +10360,8 @@ var Ue = {
10360
10360
  timezone: "Africa/Nairobi",
10361
10361
  tracking: {
10362
10362
  mode: "automatic",
10363
- adapter: "universal"
10363
+ adapter: "fargo-courier",
10364
+ localClocks: !0
10364
10365
  },
10365
10366
  canaryUrl: "https://www.fargocourier.co.ke/",
10366
10367
  trackingUrlTemplate: "https://www.fargocourier.co.ke/waybill-viewer/?wayBill={trackingNumber}",
@@ -10380,6 +10381,11 @@ var Ue = {
10380
10381
  domains: ["www.fargocourier.co.ke", "fargocourier.co.ke"],
10381
10382
  pathPattern: "^/?$",
10382
10383
  params: ["waybill_number"]
10384
+ },
10385
+ {
10386
+ domains: ["portal.fargocourier.co.ke"],
10387
+ pathPattern: "^/track/?$",
10388
+ params: ["wayBillNumber"]
10383
10389
  }
10384
10390
  ],
10385
10391
  detectionRules: [{
@@ -11802,7 +11808,9 @@ var Ue = {
11802
11808
  timezone: "Asia/Seoul",
11803
11809
  tracking: {
11804
11810
  mode: "automatic",
11805
- adapter: "universal"
11811
+ adapter: "gs-postbox",
11812
+ recognitionRank: 634,
11813
+ localClocks: !0
11806
11814
  },
11807
11815
  canaryUrl: "https://www.cvsnet.co.kr/reservation-inquiry/delivery/index.do",
11808
11816
  trackingUrlTemplate: "https://www.cvsnet.co.kr/invoice/tracking.do?invoice_no={trackingNumber}",
@@ -13996,7 +14004,9 @@ var Ue = {
13996
14004
  timezone: "Asia/Bishkek",
13997
14005
  tracking: {
13998
14006
  mode: "automatic",
13999
- adapter: "universal"
14007
+ adapter: "kyrgyz-post",
14008
+ recognitionRank: 702,
14009
+ localClocks: !0
14000
14010
  },
14001
14011
  canaryUrl: "https://post.kg/language/ru/treking-posylok/",
14002
14012
  trackingSearchUrl: "https://post.kg/language/ru/treking-posylok/",
@@ -15142,7 +15152,8 @@ var Ue = {
15142
15152
  timezone: "Indian/Mauritius",
15143
15153
  tracking: {
15144
15154
  mode: "automatic",
15145
- adapter: "universal"
15155
+ adapter: "mauritius-post",
15156
+ localClocks: !0
15146
15157
  },
15147
15158
  canaryUrl: "https://www.mauritiuspost.mu/track-trace/",
15148
15159
  trackingUrlTemplate: "https://www.mauritiuspost.mu/track-trace/?tracking_code={trackingNumber}",
@@ -22079,8 +22090,8 @@ var Ue = {
22079
22090
  mode: "automatic",
22080
22091
  adapter: "universal"
22081
22092
  },
22082
- canaryUrl: "https://www.unitedcouriers.biz/Track.aspx",
22083
- trackingSearchUrl: "https://www.unitedcouriers.biz/Track.aspx",
22093
+ canaryUrl: "https://www.unitedcouriers.biz/tracking",
22094
+ trackingSearchUrl: "https://www.unitedcouriers.biz/tracking",
22084
22095
  linkRules: [{
22085
22096
  domains: ["www.unitedcouriers.biz", "unitedcouriers.biz"],
22086
22097
  pathPattern: "^/TrackDetails\\.asp$",
@@ -29649,6 +29660,7 @@ var Tl = {
29649
29660
  "gofo-it": 460,
29650
29661
  "gofo-nl": 455,
29651
29662
  "gogo-xpress": 796,
29663
+ "gs-postbox": 634,
29652
29664
  "gta-airskip": 762,
29653
29665
  gzyl: 988,
29654
29666
  hanjin: 545,
@@ -29684,6 +29696,7 @@ var Tl = {
29684
29696
  kex: 959,
29685
29697
  "kex-express-hk": 771,
29686
29698
  "kuehne-nagel": 435,
29699
+ "kyrgyz-post": 702,
29687
29700
  "l-post": 808,
29688
29701
  "la-poste": 1e3,
29689
29702
  labaih: 788,
@@ -0,0 +1,16 @@
1
+ import type { AdapterFactory, 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
+ /** The tracker the home page on fargocourier.co.ke frames, and the customer portal's own search opens. */
5
+ export declare const FARGO_COURIER_TRACKER = "https://portal.fargocourier.co.ke/track";
6
+ export declare class FargoCourierTracker {
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
+ private read;
15
+ }
16
+ export declare const adapter: AdapterFactory;
@@ -0,0 +1,47 @@
1
+ import { TransportError } from '../../core/errors/index.js';
2
+ import { runSteps } from '../../core/runner/index.js';
3
+ import { firstAttemptMs, networkRetryStep } from '../../core/runner/networkRetry.js';
4
+ import { NOOP_RECORDER } from '../../core/telemetry/index.js';
5
+ import { decodeText, fetchBounded, userAgentOf } from '../../core/transport/index.js';
6
+ import { FARGO_COURIER_MAX_BYTES, fargoCourierFailure, normalizeFargoCourierNumber, parseFargoCourier, PROVIDER } from './parser.js';
7
+ /** The tracker the home page on fargocourier.co.ke frames, and the customer portal's own search opens. */
8
+ export const FARGO_COURIER_TRACKER = 'https://portal.fargocourier.co.ke/track';
9
+ const REDIRECTS = [301, 302, 303, 307, 308];
10
+ export class FargoCourierTracker {
11
+ options;
12
+ constructor(options = {}) {
13
+ this.options = options;
14
+ }
15
+ async fetch(raw, context = {}) {
16
+ const number = normalizeFargoCourierNumber(raw);
17
+ // A request that fails to reach Fargo, or hangs, gets one more try: the first gets half of the budget.
18
+ return runSteps({ carrier: 'fargo-courier', budgetMs: context.budgetMs ?? 15_000, signal: context.signal,
19
+ recorder: this.options.recorder ?? NOOP_RECORDER }, [
20
+ { id: 'direct', run: ({ signal, remainingMs }) => this.read(number, signal, firstAttemptMs(remainingMs)) },
21
+ networkRetryStep(({ signal, remainingMs }) => this.read(number, signal, remainingMs)),
22
+ ]);
23
+ }
24
+ async read(number, signal, timeoutMs) {
25
+ // `blank` leaves out the portal's menus, as in the home page's frame.
26
+ const url = `${FARGO_COURIER_TRACKER}?${new URLSearchParams({ blank: '1', wayBillNumber: number })}`;
27
+ const { response, bytes } = await fetchBounded(url, { signal, headers: {
28
+ Accept: 'text/html', 'User-Agent': userAgentOf(this.options.userAgent),
29
+ } }, { provider: PROVIDER, timeoutMs: Math.max(1, Math.floor(timeoutMs)), maxBytes: FARGO_COURIER_MAX_BYTES,
30
+ redirect: 'manual', fetcher: this.options.fetcher, allowHttpStatuses: [...REDIRECTS, 404, 410, 500] });
31
+ if (REDIRECTS.includes(response.status))
32
+ throw new TransportError(PROVIDER, 'Fargo Courier redirected its tracking lookup');
33
+ if (response.status === 404 || response.status === 410)
34
+ throw new TransportError(PROVIDER, 'Fargo Courier tracking page is unavailable');
35
+ const html = decodeText(bytes);
36
+ if (response.status === 500)
37
+ fargoCourierFailure(html);
38
+ return parseFargoCourier(html, number);
39
+ }
40
+ }
41
+ export const adapter = (environment) => {
42
+ const tracker = new FargoCourierTracker({ fetcher: environment.fetcher, recorder: environment.recorder, userAgent: environment.userAgent });
43
+ return {
44
+ id: 'fargo-courier', recordsSteps: true, steps: ['direct', 'retry'],
45
+ track: (input, context) => tracker.fetch(input.number, context),
46
+ };
47
+ };