@golemio/pid 5.9.1-dev.2464819473 → 5.9.1

package/docs/implementation_documentation.md

@@ -1522,6 +1522,44 @@ Worker má na starost stahování VYMI (JIS) událostí a infotextů, jejich tra
 -  zdrojové tabulky
     -   `jis_infotexts`, `jis_infotexts_ropidgtfs_stops`, `ropidgtfs_stops`
 
+### PID Departure Boards v4
+
+#### _/v4/pid/transferboards_
+
+-   načte odjezdy pro přestupní tabule ve vozidlech na základě aktuální polohy vozidla a aktivní infotexty exportované z aplikace VYMI (JIS) Infotexty
+-   parametry
+    -   `aswId` + `vehicleRegistrationNumber` + `routeType` – identifikace zastávky a vozidla přes ASW číselník (vzájemně se vylučuje s `cisId`+`tripNumber`)
+    -   `cisId` + `tripNumber` – identifikace zastávky a spoje přes CIS číselník (zatím neimplementováno, vrací 501)
+    -   `timeFrom` – volitelný ISO8601 čas příjezdu (pokud není zadán, použije se reálný čas příjezdu z RT dat)
+    -   `limit` – volitelný počet odjezdů (výchozí 8, max 30)
+-   cachováno na 5 sekund (stale-while-revalidate 5 sekund)
+-   zdrojové cache záznamy
+    -   `gtfsStopsCache:*` – převod ASW node ID na GTFS stop_id
+    -   `gtfsDelayComputation:*` – zjištění zastávek spoje a predikovaného času příjezdu
+    -   `vpPublicCache:*` – aktuální poloha a zpoždění vozidla
+    -   `gtfsPublicDepartureCache:*` – statické odjezdy ze zastávek (vč. `connections` a `wheelchair_accessible`)
+    -   `vpPublicStopTimeCache:*` – live zastávkové časy pro spoje se známou polohou
+    -   `jisCache:*` – aktivní infotexty pro dané zastávky
+-   načítání odjezdů z cache (`gtfsPublicDepartureCache`)
+    -   z každé zastávky se načte `max(80, min(120, limit × 10))` položek v časovém okně `[plannedTimeFrom − 61 min, plannedTimeFrom + 60 min + delay]`; lookback 61 minut zajišťuje, že se zachytí i navazující spoj, jehož plánovaný odjezd je v minulosti, ale díky vlastnímu zpoždění (až 60 minut) dorazí na zastávku až po příjezdu aktuálního vozidla
+    -   ihned po načtení se aplikuje pre-filter: odjezdy autobusů, tramvají a trolejbusů ze zastávek s jiným názvem než aktuální zastávka jsou zahozeny; metro/vlak/přívoz/lanovka procházejí vždy; odjezdy s neprázdným polem `connections[]` jsou zachovány bez ohledu na název zastávky (potenciální garantovaný přestup)
+-   garantované přestupy (`is_guaranteed_transfer`)
+    -   označují odjezdy, které na příjezd aktuálního spoje čekají – detekováno z pole `connections` v `gtfsPublicDepartureCache`, kde `from_trip_id` odpovídá aktuálnímu spoji a `arrivalTime < departure_datetime + max_wait_sec`
+    -   zobrazované minuty u garantovaného přestupu jsou nastaveny na čas příjezdu aktuálního spoje (ne na plánovaný odjezd navazujícího spoje)
+    -   garantované přestupy jsou vyjmuty z filtru opačného směru a filtru podskupiny linky – jsou přidány do `tripIdsToKeep` před spuštěním `findRelevantTripIdsFromLines`, takže projdou bez ohledu na zastávkovou sekvenci
+    -   typy "vždy zobrazit" (metro, vlak, přívoz, lanovka) filtr `findRelevantTripIdsFromLines` zcela přeskakují
+-   dostupnost pro vozíčkáře (`is_wheelchair_accessible`)
+    -   **metro**: určeno výhradně podle `wheelchair_boarding` zastávky (hodnota `1` = přístupná)
+    -   **ostatní typy dopravy**: primárně z RT dat vozidla (`detailed_info.is_wheelchair_accessible`); pokud RT data nejsou k dispozici, použije se GTFS příznak `wheelchair_accessible` z `trips.txt` (`1` = přístupné vozidlo)
+-   odfiltrování odjezdů stejné linky v opačném směru (`TransferFacade.isDifferentLine`) — odjezdy se shodným `route_short_name` + `route_type`, ale odlišným `direction_id` oproti aktuálnímu vozidlu jsou odstraněny; odjezdy s neznámým `direction_id` (null) jsou ponechány
+-   seskupování a omezení výstupu (`TransferDepartureCacheTransformation`)
+    -   **metro**: seskupuje se podle `route_short_name + route_type + direction_id`; na jeden záznam výstupu připadají až 2 hodnoty v poli `departure_timestamp.minutes[]`
+    -   **ostatní typy**: seskupuje se podle `route_short_name + route_type + direction_id`; na skupinu připadají nejvýše 2 samostatné záznamy odjezdů
+    -   `direction_id` se řeší s fallback řetězcem: `departure.direction_id` (z cache odjezdů) → `position.detailed_info.direction_id` (z RT poloh vozidel) → in-memory cache (klíč `route_short_name + trip_headsign`) → `0`
+-   konfigurace filtrování opačného směru (backtracking)
+    -   `module.pid.vehicle-positions.transferboards.isOppositeDirectionFilterStopNameStrict` (boolean, výchozí `true`) – pokud `true`, zastávka je považována za "zpětnou" pouze pokud se shoduje `stop_id` i `stop_name`; pokud `false`, stačí shoda `stop_id`
+    -   `module.pid.vehicle-positions.transferboards.countPreviousStopsToAllow` (integer, výchozí `0`) – kolik předchozích zastávek aktuálního spoje smí kandidátní spoj sdílet ve svých nadcházejících zastávkách, než je považován za zpětný směr a odfiltrován; `0` znamená žádná shoda není povolena
+
 ### Public v2
 
 #### _/v2/public/gtfs/trips/{gtfsTripId}_

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@golemio/pid",
-    "version": "5.9.1-dev.2464819473",
+    "version": "5.9.1",
     "description": "Golemio PID Module",
     "main": "dist/index.js",
     "types": "dist/index.d.ts",
@@ -33,7 +33,7 @@
         "url": "https://gitlab.com/operator-ict/golemio/code/modules/pid"
     },
     "engines": {
-        "node": ">=22.0.0",
+        "node": ">=20.0.0",
         "npm": ">=8.0.0"
     },
     "devDependencies": {
@@ -48,7 +48,7 @@
         "@types/chai": "4.2.3",
         "@types/chai-as-promised": "7.1.2",
         "@types/mocha": "^10.0.10",
-        "@types/node": "^22.19.17",
+        "@types/node": "^20.12.7",
         "@types/pg-copy-streams": "^1.2.5",
         "@types/sinon": "^9.0.10",
         "@types/supertest": "^2.0.10",
@@ -61,7 +61,7 @@
         "dotenv": "^8.2.0",
         "eslint": "^8.1.1",
         "husky": "^4.3.7",
-        "mocha": "^11.7.5",
+        "mocha": "^10.0.0",
         "npm-run-all": "^4.1.5",
         "nyc": "^17.1.0",
         "prettier": "^2.5.1",
@@ -73,12 +73,12 @@
         "ts-node": "^10.9.2",
         "ts-patch": "^3.3.0",
         "tsconfig-paths": "^4.2.0",
-        "typedoc": "0.28.19",
+        "typedoc": "^0.28.14",
         "typescript": "^5.9.3",
         "typescript-transform-paths": "^3.5.5"
     },
     "peerDependencies": {
-        "@golemio/core": "^3.0.7-dev.2 || ^3.0.0"
+        "@golemio/core": "^3.0.1-dev.2 || ^3.0.0 || ^2.0.1"
     },
     "overrides": {
         "@google-cloud/storage": {