.dockerignore

@@ -1,2 +0,0 @@
-.git
-node_modules

.eslintrc.json

@@ -0,0 +1,54 @@
+{
+    "env": {
+        "es2021": true,
+        "node": true
+    },
+    "extends": ["eslint:recommended", "plugin:@stylistic/all-extends"],
+    "ignorePatterns": ["node_modules", "*example.js"],
+    "parserOptions": {
+        "ecmaVersion": 2021,
+        "sourceType": "module"
+    },
+    "rules": {
+        "curly": "error",
+        "no-implicit-coercion": "error",
+        "no-unused-vars": [
+            "error",
+            {
+                "vars": "all",
+                "args": "none",
+                "ignoreRestSiblings": false
+            }
+        ],
+        "@stylistic/array-bracket-newline": ["error", "consistent"],
+        "@stylistic/array-element-newline": ["error", "consistent"],
+        "@stylistic/arrow-parens": "off",
+        "@stylistic/comma-dangle": ["error", "always-multiline"],
+        "@stylistic/dot-location": ["error", "property"],
+        "@stylistic/function-call-argument-newline": ["error", "consistent"],
+        "@stylistic/function-paren-newline": "off",
+        "@stylistic/indent": ["error", "tab"],
+        "@stylistic/indent-binary-ops": ["error", "tab"],
+        "@stylistic/max-len": "off",
+        "@stylistic/multiline-ternary": ["error", "always-multiline"],
+        "@stylistic/newline-per-chained-call": ["error", { "ignoreChainWithDepth": 1 }],
+        "@stylistic/no-mixed-operators": "off",
+        "@stylistic/no-tabs": "off",
+        "@stylistic/object-property-newline": "off",
+        "@stylistic/one-var-declaration-per-line": "off",
+        "@stylistic/operator-linebreak": ["error", "before"],
+        "@stylistic/padded-blocks": "off",
+        "@stylistic/quote-props": ["error", "consistent-as-needed"],
+        "@stylistic/quotes": ["error", "single"]
+    },
+    "overrides": [
+        {
+            "files": [
+                "test/**"
+            ],
+            "rules": {
+                "no-unused-vars": "off"
+            }
+        }
+    ]
+}

.github/workflows/build.yml

@@ -1,59 +0,0 @@
-name: Build NPM Package & Docker
-
-on:
-  push:
-    tags:
-      - 'v*'
-  workflow_dispatch:
-
-env:
-  REGISTRY: ghcr.io
-  IMAGE_NAME: ${{ github.repository }}
-
-jobs:
-  build-and-push-docker:
-    runs-on: ubuntu-latest
-    permissions:
-      contents: read
-      packages: write
-      attestations: write
-      id-token: write
-    steps:
-      - name: Checkout repository
-        uses: actions/checkout@v4
-      - name: Log in to the Container registry
-        uses: docker/login-action@65b78e6e13532edd9afa3aa52ac7964289d1a9c1
-        with:
-          registry: ${{ env.REGISTRY }}
-          username: ${{ github.actor }}
-          password: ${{ secrets.GITHUB_TOKEN }}
-      - name: Extract metadata (tags, labels) for Docker
-        id: meta
-        uses: docker/metadata-action@9ec57ed1fcdbf14dcef7dfbe97b2010124a938b7
-        with:
-          images: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}
-      - name: Build and push Docker image
-        id: push
-        uses: docker/build-push-action@f2a1d5e99d037542a71f64918e516c093c6f3fc4
-        with:
-          context: .
-          push: true
-          tags: ${{ steps.meta.outputs.tags }}
-          labels: ${{ steps.meta.outputs.labels }}
-
-  build-pkg:
-    runs-on: ubuntu-latest
-    permissions:
-      contents: read
-      packages: write
-      id-token: write
-    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
-        with:
-          node-version: '20.x'
-          registry-url: 'https://registry.npmjs.org'
-      - run: npm ci
-      - run: npm publish --provenance --access public
-        env:
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}      

.github/workflows/test.yml

@@ -1,34 +1,17 @@
 name: test
 
-on: [push, pull_request, workflow_call]
+on: [push, pull_request]
 
 env:
   npm_config_cache: /tmp/npm-cache
 
 jobs:
-  lint-and-spellcheck:
-    runs-on: ubuntu-latest
-    timeout-minutes: 15
-    steps:
-      - name: "Checkout code"
-        uses: actions/checkout@v4
-      - name: "Use Node.js"
-        uses: actions/setup-node@v4
-        with:
-          node-version: 'lts/*'
-      - run: npm install
-
-      - name: Run lint check
-        run: npm run lint
-
-      - name: Run spell check
-        run: npm run test-spelling
-
   unit-tests:
     runs-on: ubuntu-latest
     strategy:
       matrix:
         node-version:
+          - 16.x
           - 18.x
           - 20.x
           - 22.x
@@ -42,12 +25,13 @@ jobs:
 
     - id: cache-npm
       name: restore npm cache
-      uses: actions/cache@v4
+      uses: actions/cache@v3
       with:
-        key: npm-cache-${{ github.ref_name }}-${{ matrix.node-version }}-unit-tests
+        key: npm-cache-${{ github.ref_name }}
         path: ${{ env.npm_config_cache }}
     - run: npm install
 
+    - run: npm run lint
     - run: npm run test-unit
 
   integration-tests:
@@ -55,6 +39,7 @@ jobs:
     strategy:
       matrix:
         node-version:
+          - 16.x
           - 18.x
           - 20.x
           - 22.x
@@ -68,9 +53,9 @@ jobs:
 
     - id: cache-npm
       name: restore npm cache
-      uses: actions/cache@v4
+      uses: actions/cache@v3
       with:
-        key: npm-cache-${{ github.ref_name }}-${{ matrix.node-version }}-integration-tests
+        key: npm-cache-${{ github.ref_name }}
         path: ${{ env.npm_config_cache }}
     - run: npm install
 
@@ -81,7 +66,7 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        node-version: [18.x]
+        node-version: [16.x]
     steps:
     - name: checkout
       uses: actions/checkout@v4
@@ -92,9 +77,9 @@ jobs:
 
     - id: cache-npm
       name: restore npm cache
-      uses: actions/cache@v4
+      uses: actions/cache@v3
       with:
-        key: npm-cache-${{ github.ref_name }}-${{ matrix.node-version }}-e2e-tests
+        key: npm-cache-${{ github.ref_name }}
         path: ${{ env.npm_config_cache }}
     - run: npm install
 

.gitignore

@@ -5,5 +5,6 @@ Thumbs.db
 node_modules
 npm-debug.log
 
+package-lock.json
+
 /.tap
-*.ign.*

.gitmodules

@@ -0,0 +1,4 @@
+[submodule "tools/transport-apis"]
+	path = tools/transport-apis
+	url = https://github.com/public-transport/transport-apis.git
+	branch = v1

Dockerfile

@@ -1,22 +0,0 @@
-FROM node:18-alpine
-LABEL org.opencontainers.image.title="db-vendo-client"
-LABEL org.opencontainers.image.description="A clean REST API wrapping around the new Deutsche Bahn API."
-LABEL org.opencontainers.image.authors="Traines <git@traines.eu>"
-LABEL org.opencontainers.image.documentation="https://github.com/public-transport/db-vendo-client"
-LABEL org.opencontainers.image.source="https://github.com/public-transport/db-vendo-client"
-LABEL org.opencontainers.image.licenses="ISC"
-WORKDIR /app
-
-# install dependencies
-#RUN apk add --update git
-ADD package.json package-lock.json /app/
-RUN npm install && npm cache clean --force
-
-# add source code
-ADD . /app
-
-EXPOSE 3000
-
-ENV PORT 3000
-
-CMD ["node", "api.js"]

api.js

@@ -1,52 +0,0 @@
-import {createClient} from './index.js';
-import {profile as dbProfile} from './p/db/index.js';
-import {profile as dbnavProfile} from './p/dbnav/index.js';
-import {profile as dbwebProfile} from './p/dbweb/index.js';
-import {profile as dbrisProfile} from './p/dbris/index.js';
-import {profile as dbbahnhofProfile} from './p/dbbahnhof/index.js';
-import {profile as dbregioguideProfile} from './p/dbregioguide/index.js';
-import {mapRouteParsers} from './lib/api-parsers.js';
-import {createHafasRestApi as createApi} from 'hafas-rest-api';
-
-const config = {
-	hostname: process.env.HOSTNAME || 'localhost',
-	port: process.env.PORT ? parseInt(process.env.PORT) : 3000,
-	name: 'db-vendo-client',
-	description: 'db-vendo-client',
-	homepage: 'https://github.com/public-transport/db-vendo-client',
-	version: '6',
-	docsLink: 'https://github.com/public-transport/db-vendo-client',
-	openapiSpec: true,
-	logging: true,
-	aboutPage: true,
-	enrichStations: true,
-	etags: 'strong',
-	csp: 'default-src \'none\'; style-src \'self\' \'unsafe-inline\'; img-src https:',
-	mapRouteParsers,
-};
-
-const profiles = {
-	db: dbProfile,
-	dbnav: dbnavProfile,
-	dbweb: dbwebProfile,
-	dbris: dbrisProfile,
-	dbbahnhof: dbbahnhofProfile,
-	dbregioguide: dbregioguideProfile,
-};
-
-const start = async () => {
-	const vendo = createClient(
-		profiles[process.env.DB_PROFILE] || dbnavProfile,
-		process.env.USER_AGENT || 'link-to-your-project-or-email',
-		config,
-	);
-	const api = await createApi(vendo, config);
-
-	api.listen(config.port, (err) => {
-		if (err) {
-			console.error(err);
-		}
-	});
-};
-
-start();

cspell.config.json

@@ -1,644 +0,0 @@
-{
-  "version": "0.2",
-  "language": "en",
-  "words": [
-    "Abfahrt",
-    "abfahrten",
-    "abfahrts",
-    "abfrage",
-    "abgangs",
-    "Abgelaufen",
-    "Abonnement",
-    "Abschnitte",
-    "abschnitts",
-    "Adelsheim",
-    "Adenauerplatz",
-    "agilis",
-    "Ahorn",
-    "Ahrensfelde",
-    "Aktualisierung",
-    "Alexanderplatz",
-    "alterseingabe",
-    "Altstadt",
-    "Alzey",
-    "andere",
-    "Anfang",
-    "anfrage",
-    "Anfrage",
-    "anfragezeit",
-    "Angebot",
-    "angebote",
-    "angebots",
-    "angebotsbeziehung",
-    "angebotseinholung",
-    "ANGEBOTSINFORMATION",
-    "Angebotsoption",
-    "angefragten",
-    "Angeltürn",
-    "ankuenfte",
-    "ankunft",
-    "ankunfts",
-    "Anmeldung",
-    "ANRUFPFLICHTIG",
-    "ANRUFPFLICHTIGEVERKEHRE",
-    "Anteil",
-    "anzahl",
-    "anzeige",
-    "Anzeigen",
-    "APPLEPAY",
-    "ARGUMENTE",
-    "arrs",
-    "Arverio",
-    "Aschaffenburg",
-    "attribut",
-    "Atze",
-    "Auerbach",
-    "AUSFALL",
-    "ausgegeben",
-    "auslastung",
-    "auslastungs",
-    "Auslastungsinformation",
-    "auslastungsmeldungen",
-    "auslastungstexte",
-    "Ausreserviert",
-    "außergewöhnlich",
-    "Ausserhalb",
-    "außerhalb",
-    "Ausstattung",
-    "Auswahl",
-    "autonome",
-    "bahnbonus",
-    "BAHNCARD",
-    "Bahnhof",
-    "bahnhofs",
-    "Bahnhofsinfo",
-    "bahnhofstafel",
-    "bahnhofstafeln",
-    "BARRIEREFREI",
-    "Bayerischer",
-    "BEFÖRDERER",
-    "begrenzt",
-    "behaviour",
-    "Behindertengerechte",
-    "Behindertengerechtes",
-    "Benoit",
-    "Beratzhausen",
-    "bereits",
-    "besonderer",
-    "Besucherpark",
-    "betrag",
-    "Beusselstraße",
-    "bezeichnung",
-    "Bietigheim",
-    "Bismarckstr",
-    "Bissingen",
-    "bitmasks",
-    "Blaschkoallee",
-    "Blissestr",
-    "BNWNZF",
-    "Böhme",
-    "BONVOYO",
-    "Bordbistro",
-    "Bordrestaurant",
-    "Boxberg",
-    "Breckerfeld",
-    "Britz",
-    "brokentrip",
-    "brutto",
-    "Buch",
-    "Buchbar",
-    "buchbarkeit",
-    "BUCHEN",
-    "BUCHUNG",
-    "buchungs",
-    "Bundesbahnen",
-    "Bundesplatz",
-    "BUSSE",
-    "bzgl",
-    "capacitorjs",
-    "Chaussee",
-    "checkin",
-    "childrens",
-    "CITYTICKET",
-    "clie",
-    "cncl",
-    "codeshares",
-    "conds",
-    "consumability",
-    "Consumability",
-    "Creglingen",
-    "crosssell",
-    "Ctrf",
-    "customisation",
-    "customisations",
-    "Damm",
-    "Daten",
-    "Dauer",
-    "dauerhaft",
-    "dbnav",
-    "dbregioguide",
-    "dbris",
-    "dbweb",
-    "Deldicque",
-    "DELFI",
-    "derhuerst",
-    "Deutz",
-    "dhid",
-    "differenzpreis",
-    "Dinkelsbühl",
-    "distanz",
-    "Dombühl",
-    "echtzeit",
-    "Eggmühl",
-    "ehemals",
-    "Eicholzheim",
-    "einchecken",
-    "eine",
-    "einfache",
-    "Einrichtung",
-    "Einstieg",
-    "einstiegs",
-    "Einstiegshilfe",
-    "Einstiegstyp",
-    "Eisenacher",
-    "emis",
-    "empfehlen",
-    "Ende",
-    "entfällt",
-    "Entgelt",
-    "ereignis",
-    "Erforderlich",
-    "erforderlicher",
-    "Ergoldsbach",
-    "Erlenbach",
-    "ERMAESSIGUNG",
-    "ermaessigungen",
-    "erster",
-    "ERWACHSENER",
-    "erwarten",
-    "erwartet",
-    "Eubigheim",
-    "Eurocity",
-    "eventuell",
-    "externe",
-    "Fahrkarte",
-    "fahrplan",
-    "Fahrplanperiode",
-    "Fahrpreis",
-    "Fahrradbeförderung",
-    "FAHRRADMITNAHME",
-    "Fahrt",
-    "FAHRZEUG",
-    "Fahrzeuggebundene",
-    "FAMILIENKIND",
-    "Fehler",
-    "Fehrbelliner",
-    "Fernbf",
-    "Fernverkehr",
-    "Flexpreis",
-    "Flix",
-    "Fltr",
-    "Flughafen",
-    "FPTF",
-    "Freising",
-    "Friedrichshall",
-    "Friedrichstr",
-    "frueher",
-    "Frwd",
-    "FUSSWEG",
-    "Fußweg",
-    "FVFFLPI",
-    "FVFSPPI",
-    "FVFSSPI",
-    "FVKBACI",
-    "GARE",
-    "Garten",
-    "Gastronomie",
-    "Gattung",
-    "gekauft",
-    "Geltungzeitpunkt",
-    "GENERALABONNEMENT",
-    "geolocation",
-    "geopositions",
-    "Geringe",
-    "gesamt",
-    "Gesundbrunnen",
-    "gleis",
-    "Gneisenaustr",
-    "Goerdelersteg",
-    "grafisch",
-    "Greifswalder",
-    "Grenzallee",
-    "Grünanlagen",
-    "gruppen",
-    "Gütersloh",
-    "GUTSCHEIN",
-    "haben",
-    "hafas",
-    "Hagelstadt",
-    "Halbtax",
-    "HALBTAXABO",
-    "Halemweg",
-    "Halensee",
-    "Hallerstraße",
-    "halte",
-    "Haltestellen",
-    "Hansering",
-    "Hansestadt",
-    "Haselhorst",
-    "Hauptbahnhof",
-    "Heidelberger",
-    "Hennef",
-    "Hermannplatz",
-    "Hermannstraße",
-    "hessen",
-    "Heuchelhof",
-    "HINFAHRT",
-    "Hinweis",
-    "Hinweise",
-    "HOCH",
-    "HOCHGESCHWINDIGKEITSZUEGE",
-    "Hohe",
-    "Hohenstadt",
-    "Hohenzollerndamm",
-    "Hüngheim",
-    "IBNR",
-    "Ihren",
-    "Ihrer",
-    "Informationen",
-    "INKLUSIVE",
-    "Innsbrucker",
-    "Instanz",
-    "INTERCITYUNDEUROCITYZUEGE",
-    "INTERREGIOUNDSCHNELLZUEGE",
-    "inventarsystem",
-    "irregulaere",
-    "Jakob",
-    "Jannis",
-    "Jannowitzbrücke",
-    "jetzt",
-    "Johannisthaler",
-    "journeystop",
-    "JUGENDLICHER",
-    "Jungfernheide",
-    "Kanal",
-    "KATALOG",
-    "kategorie",
-    "Kategorien",
-    "kategorisierung",
-    "kein",
-    "KEINE",
-    "Kennung",
-    "Kennzeichen",
-    "Kirche",
-    "klasse",
-    "KLASSENLOS",
-    "KLEINKIND",
-    "Kleistpark",
-    "Klima",
-    "KLIMATICKET",
-    "Köfering",
-    "Köln",
-    "kombinations",
-    "komfort",
-    "konditionen",
-    "konditions",
-    "Konstanzer",
-    "kontext",
-    "Kontingente",
-    "KRCC",
-    "KREDITKARTE",
-    "Kristjan",
-    "Kurz",
-    "kurztext",
-    "Landsberger",
-    "Landshut",
-    "langtext",
-    "LASTSCHRIFT",
-    "Lauda",
-    "letzte",
-    "letztes",
-    "leuchtturm",
-    "Lichtenberg",
-    "liegt",
-    "linien",
-    "Lipschitzallee",
-    "Loesungs",
-    "Ludwigsburg",
-    "luxon",
-    "materialisierungs",
-    "Maxnet",
-    "MBAAA",
-    "Mehringdamm",
-    "Meidling",
-    "Meldungen",
-    "Merchingen",
-    "Messe",
-    "Mierendorffplatz",
-    "Millis",
-    "Minden",
-    "mitteltext",
-    "mittlere",
-    "Mobilitätseingeschränkte",
-    "Mobilitätsservice",
-    "Möckernbrücke",
-    "Möckmühl",
-    "modul",
-    "moeckmuehl",
-    "Moeglich",
-    "möglich",
-    "Montabaur",
-    "Moosburg",
-    "Mosbach",
-    "Movas",
-    "München",
-    "Musiktheater",
-    "mwst",
-    "mxtxm",
-    "Nachgelagert",
-    "Nachricht",
-    "Nahreisezug",
-    "NAHVERKEHRSONSTIGEZUEGE",
-    "Naturkundemuseum",
-    "Neckarsulm",
-    "netto",
-    "Neufahrn",
-    "Neukölln",
-    "Neumarkt",
-    "NICHT",
-    "Niederbay",
-    "NIEDRIG",
-    "noch",
-    "noopener",
-    "Nord",
-    "noreferrer",
-    "Notiz",
-    "Notizen",
-    "NULLPREIS",
-    "nummer",
-    "nutzungs",
-    "Obereubigheim",
-    "Oberpf",
-    "Oberschefflenz",
-    "Obertraubling",
-    "Oberwittstadt",
-    "Ohne",
-    "orte",
-    "Ostbahnhof",
-    "Osterburken",
-    "Österreichische",
-    "Ostkreuz",
-    "Parchimer",
-    "Parsberg",
-    "passend",
-    "Passlist",
-    "Paulsternstr",
-    "Pauschalpreis",
-    "Pergamonkeller",
-    "Pergamonweg",
-    "Perleberg",
-    "PFLICHT",
-    "PLAETZE",
-    "planungs",
-    "platf",
-    "Platz",
-    "platzbedarfe",
-    "platzprofil",
-    "pollyjs",
-    "polyline",
-    "polylines",
-    "Positionen",
-    "Preis",
-    "preise",
-    "preisunterdrueckung",
-    "Prenzlauer",
-    "prio",
-    "priorisierte",
-    "prioritaet",
-    "produkt",
-    "produkte",
-    "produktgattungen",
-    "Profil",
-    "PRUEFEN",
-    "PUBLICTRANSPORT",
-    "Punkte",
-    "rabatt",
-    "Radzio",
-    "RAILPLUS",
-    "randomised",
-    "Ravenstein",
-    "Referenz",
-    "referenzen",
-    "referenziertes",
-    "Regio",
-    "Regionalbf",
-    "regulaere",
-    "regulaerer",
-    "reise",
-    "REISEANGEBOT",
-    "reiseloesung",
-    "reisende",
-    "reisenden",
-    "REISESTELLENKARTE",
-    "reisetag",
-    "Reisezentrum",
-    "REMENTR",
-    "REMRESR",
-    "Reservierbar",
-    "Reservieren",
-    "Reservierung",
-    "reservierungen",
-    "reservierungs",
-    "RESERVIERUNGSANGEBOT",
-    "RESERVIERUNGSENTGELT",
-    "reservierungspflicht",
-    "Rhein",
-    "richtung",
-    "roehrt",
-    "Rohrdamm",
-    "Roigheim",
-    "Rollstuhl",
-    "rollstuhlgerechte",
-    "Römisches",
-    "Rosenthal",
-    "Rothenburg",
-    "Rudow",
-    "Rueck",
-    "Rüsselsheim",
-    "Saale",
-    "Sammelfaehig",
-    "satz",
-    "SBAHN",
-    "SBAHNEN",
-    "Scharnweberstr",
-    "SCHIFF",
-    "SCHIFFE",
-    "Schlachthof",
-    "schnelle",
-    "Schöneberg",
-    "Schönefeld",
-    "Schönhauser",
-    "Schwedter",
-    "Seckach",
-    "Sennfeld",
-    "servicekategorie",
-    "SHCARD",
-    "sich",
-    "SICT",
-    "Sieg",
-    "Siegburg",
-    "Siemensdamm",
-    "Siglingen",
-    "sitzplatz",
-    "Sitzplatzreservierung",
-    "slugg",
-    "Sonnenallee",
-    "Sören",
-    "spaeter",
-    "Sparpreis",
-    "spezifische",
-    "Spichernstr",
-    "Spittelmarkt",
-    "Stadtgebiet",
-    "Stadtmitte",
-    "Stadtpark",
-    "Steinach",
-    "Storkower",
-    "STRASSENBAHN",
-    "stufe",
-    "stufenfrei",
-    "suchbegriff",
-    "Suche",
-    "Südkreuz",
-    "Südstern",
-    "Sutter",
-    "tage",
-    "täglich",
-    "tapjs",
-    "tarif",
-    "Tarifbereiche",
-    "Tarifgebiet",
-    "Tarifzone",
-    "Tauber",
-    "teilpreis",
-    "teilstrecken",
-    "Tempelhof",
-    "Texte",
-    "Tiergarten",
-    "Toel",
-    "Torfstr",
-    "Torfstraße",
-    "Traines",
-    "traveller",
-    "Travellers",
-    "travelling",
-    "Treptower",
-    "Tsua",
-    "tvlr",
-    "UBAHN",
-    "ueber",
-    "uebergreifende",
-    "ueberschrift",
-    "Uiffingen",
-    "Umbuchungen",
-    "Umstiege",
-    "umstiegs",
-    "Umstiegsdauer",
-    "Umstiegszeit",
-    "unsere",
-    "unter",
-    "Unterwittstadt",
-    "upsell",
-    "ursprungs",
-    "ushrp",
-    "uuidv",
-    "Vaihingen",
-    "vendo",
-    "verbindung",
-    "verbindungen",
-    "verbindungs",
-    "verbindungsabschnitt",
-    "verbindungssuche",
-    "Verfuegbar",
-    "verfügbar",
-    "verkehrmittel",
-    "verkehrsmittel",
-    "Verkehrstage",
-    "VERKNUEPFT",
-    "Verlauf",
-    "vertraglicher",
-    "vlexx",
-    "Voordeelurenabo",
-    "Vorhanden",
-    "VORTEILE",
-    "VORTEILSCARD",
-    "Vorverkaufszeitraum",
-    "waehrung",
-    "wagenreihung",
-    "wählen",
-    "Wannsee",
-    "Wegener",
-    "Weichselstr",
-    "wenden",
-    "wenn",
-    "Westbahn",
-    "Westend",
-    "Westf",
-    "westhafen",
-    "Westkreuz",
-    "wichtig",
-    "Wilmersdorfer",
-    "wird",
-    "Witzleben",
-    "wochentage",
-    "Worringen",
-    "wunsch",
-    "Wunschplatz",
-    "Württemberg",
-    "württembergallee",
-    "Würzburg",
-    "Wutzkyallee",
-    "Yorckstr",
-    "Yureka",
-    "Zahlungsarten",
-    "Zeitpunkt",
-    "Zeitraum",
-    "zgck",
-    "ziel",
-    "Zimmern",
-    "Zitadelle",
-    "Zoologischer",
-    "Zuege",
-    "zugart",
-    "zugattrib",
-    "zugattribute",
-    "Zuges",
-    "zugfahrt",
-    "zuglaeufe",
-    "Zuglauf",
-    "zugnummer",
-    "zulaessige",
-    "Zusammenfassung",
-    "Züttlingen",
-    "Zwickauer",
-    "zwischenhalte",
-    "bestprice",
-    "intervalle",
-    "Intervalle",
-    "tagesbest",
-    "dbbahnhof",
-    "Deutschlandticket",
-    "fahrverguenstigungen",
-    "cancelation"
-  ],
-  "ignorePaths": [
-    "docs/dumps/**",
-    "test/e2e/fixtures/**",
-    "test/fixtures/**",
-    "test/parse/remarks.js",
-	  "test/parse/dbnav-journey.js"
-  ],
-  "dictionaries": [
-    "node"
-  ]
-}

docs/api.md

@@ -1,19 +1,17 @@
-# `db-vendo-client` API
+# `hafas-client` API
-
-Also see the [root readme](https://github.com/public-transport/db-vendo-client) for a shortlist of differences of db-vendo-client to hafas-client and of differences between the profiles.
 
 - [`journeys(from, to, [opt])`](journeys.md) – get journeys between locations
 - [`refreshJourney(refreshToken, [opt])`](refresh-journey.md) – fetch up-to-date/more details of a `journey`
-- `journeysFromTrip(tripId, previousStopover, to, [opt])` – not supported
+- [`journeysFromTrip(tripId, previousStopover, to, [opt])`](journeys-from-trip.md) – get journeys from a trip to a location
 - [`trip(id, lineName, [opt])`](trip.md) – get details for a trip
-- `tripsByName(lineNameOrFahrtNr, [opt])` – not supported
+- [`tripsByName(lineNameOrFahrtNr, [opt])`](trips-by-name.md) – get all trips matching a name
 - [`departures(station, [opt])`](departures.md) – query the next departures at a station
 - [`arrivals(station, [opt])`](arrivals.md) – query the next arrivals at a station
 - [`locations(query, [opt])`](locations.md) – find stations, POIs and addresses
 - [`stop(id, [opt])`](stop.md) – get details about a stop/station
 - [`nearby(location, [opt])`](nearby.md) – show stations & POIs around
-- `radar(north, west, south, east, [opt])` – not supported
+- [`radar(north, west, south, east, [opt])`](radar.md) – find all vehicles currently in a certain area
-- `reachableFrom(address, [opt])` – not supported
+- [`reachableFrom(address, [opt])`](reachable-from.md) – get all stations reachable from an address within `n` minutes
-- `remarks([opt])` – not supported
+- [`remarks([opt])`](remarks.md) – get all remarks
-- `lines(query, [opt])` – not supported
+- [`lines(query, [opt])`](lines.md) – get all lines matching a name
-- `serverInfo([opt])` – not supported
+- [`serverInfo([opt])`](server-info.md) – fetch meta information from HAFAS

docs/db-apis.md

@@ -1,90 +0,0 @@
-# New DB Board and Route Planning APIs (beyond HAFAS and IRIS)
-
-(Beware that a DB journey is what you usually call a trip (a vehicle travelling at a certain time) and a DB trip is what you usually call a journey (result of a route search from A to B).)
-
-## RIS::Boards
-https://apis.deutschebahn.com/db/apis/ris-boards/v1/public/
-
-EPs:
-* departures/<evaNo>
-* arrivals/<evaNo>
-
-Notes:
-* docs (also helpful for other RIS-based APIs below): https://developers.deutschebahn.com/db-api-marketplace/apis/product/ris-boards-transporteure/api/ris-boards-transporteure#/RISBoards_151/overview
-* needs an API Key
-* provides remarks
-* does not provide loadFactor
-* no route planning
-* uses RIS trip IDs
-* boards up to 12 hours
-
-## bahnhof.de RIS
-https://www.bahnhof.de/api/boards/departures?evaNumbers=8000105&filterTransports=BUS&duration=60&locale=de
-
-Notes:
-* no API Key needed
-* provides remarks
-* uses RIS trip IDs
-* no route planning
-* boards up to 6 hours, only from current time (or unknown parameter)
-
-## Regio Guide RIS
-https://regio-guide.de/@prd/zupo-travel-information/api/public/ri/
-
-EPs:
-* departure/8000105?modeOfTransport=HIGH_SPEED_TRAIN,REGIONAL_TRAIN,CITY_TRAIN,INTER_REGIONAL_TRAIN,UNKNOWN,BUS,TRAM,SUBWAY&timeStart=2024-12-11T15:08:25.678Z&timeEnd=2024-12-12T01:53:25.678&expandTimeFrame=TIME_END&&occupancy=true
-* board/arrival/<evaNo>
-* routing-search (with POST body, see regio-guide.de)
-* trip/<tripId-from-routing-search>
-* journey/<journeyId-from-trip>
-
-Notes:
-* no API Key needed
-* no remarks in boards (or with unknown param), only some in journey
-* cancelled trips are completely missing from boards (?)
-* uses RIS trip IDs, does not expose them directly in the routing-search response
-* loadFactor for some regional services, not for long distance services
-* boards up to 12 hours
-* routing-search returns polylines (!)
-
-## Vendo/Movas Navigator API
-https://app.vendo.noncd.db.de/mob/
-
-EPs:
-* bahnhofstafel/abfahrt
-* bahnhofstafel/ankunft
-* location/search
-* angebote/fahrplan (for route planning)
-* zuglauf
-* zuglaeufe/ICE_947/halte/by-abfahrt/8000207_2024 (coach sequence)
-* angebote/recon (tickets)
-* trip/recon (polylines)
-
-Notes:
-* see [traffic dumps](dumps/)
-* no API Key needed
-* used by new DB Navigator
-* HAFAS trip IDs
-* boards only 1 hour (or unknown param)
-* does not contain machine-readable cancelled info in the boards (only "Halt entfällt" string), but contains relevant remarks
-* loadFactor only on journeys (?)
-* polylines only for zuglauf and trip/recon
-* limited remarks on boards
-
-## Vendo/Movas bahn.de API
-https://int.bahn.de/web/api/
-
-EPs:
-* angebote/fahrplan (for route planning)
-* reiseloesung/orte
-* reiseloesung/orte/nearby
-* reiseloesung/verbindung
-* reiseloesung/fahrt
-* reiseloesung/abfahrten?datum=2024-12-30&zeit=11:55:00&ortExtId=8011160&ortId=A%3D1%40O%3DBerlin+Hbf%40X%3D13369549%40Y%3D52525589%40U%3D80%40L%3D8011160%40i%3DU%C3%97008065969%40&mitVias=true&maxVias=8&verkehrsmittel[]=ICE&verkehrsmittel[]=EC_IC&verkehrsmittel[]=IR&verkehrsmittel[]=REGIONAL
-* reiseloesung/ankuenfte
-
-Notes:
-* no API Key needed
-* uses HAFAS trip IDs
-* provides loadFactor
-* polylines only for /verbindung and /fahrt

docs/departures.md

@@ -24,48 +24,58 @@ With `opt`, you can override the default options, which look like this:
 ```js
 {
 	when:      new Date(),
-	direction: null, // only supported in `dbweb` and with `enrichStations=true` (experimental)
+	direction: null, // only show departures heading to this station
-	line: null, // not supported
+	line: null, // filter by line ID
 	duration:  10, // show departures for the next n minutes
 	results: null, // max. number of results; `null` means "whatever HAFAS wants"
-	subStops: true, // not supported
+	subStops: true, // parse & expose sub-stops of stations?
-	entrances: true, // not supported
+	entrances: true, // parse & expose entrances of stops/stations?
-	linesOfStops: false, // not supported
+	linesOfStops: false, // parse & expose lines at the stop/station?
 	remarks: true, // parse & expose hints & warnings?
-	stopovers: false, // fetch & parse previous/next stopovers?, only supported with `dbweb` profile
+	stopovers: false, // fetch & parse previous/next stopovers?
 	// departures at related stations
 	// e.g. those that belong together on the metro map.
 	includeRelatedStations: true,
-	moreStops: null // also include departures/arrivals for array of up to nine additional station evaNumbers (not supported with dbnav and dbweb)
 	language: 'en' // language to get results in
 }
 ```
-The maximum supported duration depends on the profile (see main readme), e.g. 720 for `db` and 60 for `dbnav`. In order to use the `dbris` profile, you need to pass the env vars `DB_API_KEY` and `DB_CLIENT_ID`.
+
-If you pass an object `opt.products`, its fields will partially override the default products defined in the profile.
+If you pass an object `opt.products`, its fields will partially override the default products defined in the profile. An example with the [BVG profile](../p/bvg):
+
+```js
+import {createClient} from 'hafas-client'
+import {profile as vbbProfile} from 'hafas-client/p/vbb/index.js'
+
+const userAgent = 'link-to-your-project-or-email' // adapt this to your project!
+const client = createClient(vbbProfile, userAgent)
+
+// will query with these products: suburban, subway, bus, express, regional
+await client.departures('900000024101', {products: {tram: false, ferry: false}})
+```
 
 ## Response
 
 *Note:* As stated in the [*Friendly Public Transport Format* v2 draft spec](https://github.com/public-transport/friendly-public-transport-format/blob/3bd36faa721e85d9f5ca58fb0f38cdbedb87bbca/spec/readme.md), the `when` field includes the current delay. The `delay` field, if present, expresses how much the former differs from the schedule.
 
-You may pass a departure's `tripId` into [`trip(id, lineName, [opt])`](trip.md) to get details on the whole trip. For the `dbnav`/`dbweb` profile HAFAS trip ids will be returned, for the `db` profile, RIS trip ids will be returned, then the `trip()` endpoint supports both id types.
+You may pass a departure's `tripId` into [`trip(id, lineName, [opt])`](trip.md) to get details on the whole trip.
 
-For `db` profile, cancelled trips will not be contained in the response! For the `db` and `dbnav` profile, only the most important remarks will be contained in the boards.
+As an example, we're going to use the [VBB profile](../p/vbb):
 
 ```js
-import {createClient} from 'db-vendo-client'
+import {createClient} from 'hafas-client'
-import {profile as dbnavProfile} from 'db-vendo-client/p/dbnav/index.js'
+import {profile as vbbProfile} from 'hafas-client/p/vbb/index.js'
 
 const userAgent = 'link-to-your-project-or-email' // adapt this to your project!
-const client = createClient(dbnavProfile, userAgent)
+const client = createClient(vbbProfile, userAgent)
 
 // S Charlottenburg
 const {
 	departures,
 	realtimeDataUpdatedAt,
-} = await client.departures('8089165', {duration: 3})
+} = await client.departures('900000024101', {duration: 3})
 ```
 
-`realtimeDataUpdatedAt` is currently not set in db-vendo-client, because the upstream APIs don't provide it.
+`realtimeDataUpdatedAt` is a UNIX timestamp reflecting the latest moment when (at least some) of the response's realtime data have been updated.
 
 `departures` may look like this:
 
@@ -77,11 +87,11 @@ const {
 	// Depending on the HAFAS endpoint, the destination may be present:
 	destination: {
 		type: 'stop',
-		id: '8089165',
+		id: '900000029101',
 		name: 'S Spandau',
 		location: {
 			type: 'location',
-			id: '8089165',
+			id: '900029101',
 			latitude: 52.534794,
 			longitude: 13.197477
 		},

docs/dumps/PCAPdroid_02_Jan_15_23_29_moreloyaltycards.txt

@@ -1,18 +0,0 @@
-POST /mob/angebote/fahrplan HTTP/1.1
-Accept: application/x.db.vendo.mob.verbindungssuche.v8+json
-x-feature-reiseketten-enabled: false
-X-Correlation-ID: 68f7ceba-70e7-4a88-b9b0-454809655314_3fbcc823-2a69-46f4-9484-6d94b1c0116a
-X-Device-Os-Name: Android
-X-Device-Os-Version: 32
-X-Device-Model: Google Pixel 3a
-X-App-Version: 24.32.2
-Accept-Language: en,de
-X-INSTANA-ANDROID: 4779d837-2aa8-4613-9904-8f950367c3c0
-Content-Type: application/x.db.vendo.mob.verbindungssuche.v8+json
-Content-Length: 1120
-Host: app.vendo.noncd.db.de
-Connection: Keep-Alive
-Accept-Encoding: gzip
-User-Agent: okhttp/4.12.0
-
-{"autonomeReservierung":false,"einstiegsTypList":["STANDARD"],"klasse":"KLASSE_2","reiseHin":{"wunsch":{"abgangsLocationId":"A\u003d1@O\u003dMünchen Hbf@X\u003d11558339@Y\u003d48140229@U\u003d81@L\u003d8000261@B\u003d1@p\u003d1734722398@i\u003dU×008020347@","verkehrsmittel":["ALL"],"zeitWunsch":{"reiseDatum":"2025-01-02T15:21:31.877957+01:00","zeitPunktArt":"ABFAHRT"},"zielLocationId":"A\u003d1@O\u003dStuttgart Hbf@X\u003d9181636@Y\u003d48784081@U\u003d81@L\u003d8000096@B\u003d1@p\u003d1734722398@i\u003dU×008029034@"}},"reisendenProfil":{"reisende":[{"ermaessigungen":["CH-GENERAL-ABONNEMENT KLASSE_2","CH-GENERAL-ABONNEMENT KLASSE_1","CH-HALBTAXABO_OHNE_RAILPLUS KLASSENLOS","A-VORTEILSCARD KLASSENLOS"],"reisendenTyp":"SENIOR"},{"ermaessigungen":["CH-GENERAL-ABONNEMENT KLASSE_2","CH-GENERAL-ABONNEMENT KLASSE_1","CH-HALBTAXABO_OHNE_RAILPLUS KLASSENLOS","A-VORTEILSCARD KLASSENLOS"],"reisendenTyp":"SENIOR"},{"ermaessigungen":["KLIMATICKET_OE KLASSENLOS","NL-40_OHNE_RAILPLUS KLASSENLOS","BAHNCARD100 KLASSE_1","BAHNCARD100 KLASSE_2"],"reisendenTyp":"ERWACHSENER"}]},"reservierungsKontingenteVorhanden":false}

docs/dumps/PCAPdroid_02_Jan_15_29_10_alter.txt

@@ -1,17 +0,0 @@
-POST /mob/angebote/recon/autonomereservierung HTTP/1.1
-Accept: application/x.db.vendo.mob.verbindungssuche.v8+json
-X-Correlation-ID: 68f7ceba-70e7-4a88-b9b0-454809655314_3fbcc823-2a69-46f4-9484-6d94b1c0116a
-X-Device-Os-Name: Android
-X-Device-Os-Version: 32
-X-Device-Model: Google Pixel 3a
-X-App-Version: 24.32.2
-Accept-Language: en,de
-X-INSTANA-ANDROID: 7d70a4fc-751f-4893-b2e2-11c925c0538b
-Content-Type: application/x.db.vendo.mob.verbindungssuche.v8+json
-Content-Length: 1872
-Host: app.vendo.noncd.db.de
-Connection: Keep-Alive
-Accept-Encoding: gzip
-User-Agent: okhttp/4.12.0
-
-{"einstiegsTypList":["STANDARD"],"klasse":"KLASSE_2","reisendenProfil":{"reisende":[{"alter":63,"ermaessigungen":["KLIMATICKET_OE KLASSENLOS","NL-40_OHNE_RAILPLUS KLASSENLOS"],"reisendenTyp":"ERWACHSENER"}]},"reservierungsKontingenteVorhanden":false,"verbindungHin":{"kontext":"¶HKI¶T$A\u003d1@O\u003dMünchen Hbf@X\u003d11558339@Y\u003d48140229@L\u003d8000261@a\u003d128@$A\u003d1@O\u003dStuttgart Hbf@X\u003d9181636@Y\u003d48784081@L\u003d8000096@a\u003d128@$202501021628$202501021832$ICE  912$$1$$$$$$§T$A\u003d1@O\u003dStuttgart Hbf@X\u003d9181636@Y\u003d48784081@L\u003d8000096@a\u003d128@$A\u003d1@O\u003dParis Est@X\u003d2359120@Y\u003d48876976@L\u003d8700011@a\u003d128@$202501021852$202501022214$TGV 9570$$1$$$$$$¶KC¶#VE#2#CF#100#CA#0#CM#0#SICT#0#AM#81#AM2#0#RT#7#¶KCC¶I1ZFIzEjRVJHIzIjSElOIzAjRUNLIzU2NDAyOHw1NjQwMjh8NTY0Mzc0fDU2NDM3NHwwfDB8NTY1fDU2Mzk1OHwxfDB8MjZ8MHwwfC0yMTQ3NDgzNjQ4I0dBTSMyMDEyNTE2MjgjClojVk4jMSNTVCMxNzM0NzIyMzk4I1BJIzEjWkkjMTk3Mzc3I1RBIzAjREEjMjAxMjUjMVMjODAwMDI2MSMxVCMxNjI4I0xTIzgwMDAwODAjTFQjMjIwMyNQVSM4MSNSVCMxI0NBI0lDRSNaRSM5MTIjWkIjSUNFICA5MTIjUEMjMCNGUiM4MDAwMjYxI0ZUIzE2MjgjVE8jODAwMDA5NiNUVCMxODMyIwpaI1ZOIzEjU1QjMTczNDcyMjM5OCNQSSMxI1pJIzIzOTQ0OSNUQSMwI0RBIzIwMTI1IzFTIzgwMDAwOTYjMVQjMTg1MiNMUyM4NzAwMDExI0xUIzIyMTQjUFUjODEjUlQjMSNDQSNSSFQjWkUjOTU3MCNaQiNUR1YgOTU3MCNQQyMwI0ZSIzgwMDAwOTYjRlQjMTg1MiNUTyM4NzAwMDExI1RUIzIyMTQj¶KRCC¶#VE#1#¶SC¶1_H4sIAAAAAAACA32PS07DMBiEr1J5XarfTtM8JEsmDRWgAhGiCIRYhMZtg/IotlMRRTkHl2HXi/EnEWxA7Dzj8XzjhhykIj6hE8clYyLfDYowmNyHEw+1km/Eb0hR5Qvi2+PuEBAfxqSsTBgbiWEGzAYKjPTmXZp3JrUZBUBr0zec0DF5LepFZtSS+E8NMfW+i0W3NyGG8jLp1MX1HMUhzqq+AphF2ud+03y3HYqRnMj9slwPNVmaYPKUU3HDr46fxXoni9H5y0Y8cEpt27UsTzzyqUunwJgnVtylYsldAGAzKgJ8t+fUsaYOY5bnipSvjh8ALjBAT+AYbYZPLvolsVJ/oqNYpXp0pg1ymWV7lEGPdZ2Z58x+sA5y6T9Yh1IL4Dd2K01UZnWWFugZVcneuiwrVcg6KKsi0cTfxJkeLqJY6yzV5jsr1yUOjHMMNW3bfgFUarsn8gEAAA\u003d\u003d"}}

docs/dumps/PCAPdroid_02_Jan_22_47_29_tickets.txt

@@ -1,18 +0,0 @@
-POST /mob/angebote/recon HTTP/1.1
-Accept: application/x.db.vendo.mob.verbindungssuche.v8+json
-x-feature-reiseketten-enabled: false
-X-Correlation-ID: e1927e98-0d8c-45f2-a161-965622ccd56a_e8cf6ea4-4103-4707-aa44-2287646a87f9
-X-Device-Os-Name: Android
-X-Device-Os-Version: 32
-X-Device-Model: Google Pixel 3a
-X-App-Version: 24.32.2
-Accept-Language: en,de
-X-INSTANA-ANDROID: dcf2d458-4e11-4e40-a6e3-8922544387e8
-Content-Type: application/x.db.vendo.mob.verbindungssuche.v8+json
-Content-Length: 2749
-Host: app.vendo.noncd.db.de
-Connection: Keep-Alive
-Accept-Encoding: gzip
-User-Agent: okhttp/4.12.0
-
-{"einstiegsTypList":["STANDARD"],"klasse":"KLASSE_2","reisendenProfil":{"reisende":[{"ermaessigungen":["KEINE_ERMAESSIGUNG KLASSENLOS"],"reisendenTyp":"ERWACHSENER"}]},"reservierungsKontingenteVorhanden":false,"verbindungHin":{"kontext":"¶HKI¶T$A\u003d1@O\u003dMünchen Hbf@X\u003d11558339@Y\u003d48140229@L\u003d8000261@a\u003d128@$A\u003d1@O\u003dFrankfurt(Main)Hbf@X\u003d8663785@Y\u003d50107149@L\u003d8000105@a\u003d128@$202501030000$202501030438$ICE  618$$1$$$$$$§T$A\u003d1@O\u003dFrankfurt(Main)Hbf@X\u003d8663785@Y\u003d50107149@L\u003d8000105@a\u003d128@$A\u003d1@O\u003dKassel-Wilhelmshöhe@X\u003d9447114@Y\u003d51312558@L\u003d8003200@a\u003d128@$202501030512$202501030644$ICE 1088$$1$$$$$$§T$A\u003d1@O\u003dKassel-Wilhelmshöhe@X\u003d9447114@Y\u003d51312558@L\u003d8003200@a\u003d128@$A\u003d1@O\u003dHamm(Westf)Hbf@X\u003d7807824@Y\u003d51678077@L\u003d8000149@a\u003d128@$202501030703$202501030850$RE 26708$$1$$$$$$§T$A\u003d1@O\u003dHamm(Westf)Hbf@X\u003d7807824@Y\u003d51678077@L\u003d8000149@a\u003d128@$A\u003d1@O\u003dMünster(Westf)Hbf@X\u003d7635716@Y\u003d51956563@L\u003d8000263@a\u003d128@$202501030859$202501030922$RE 32916$$1$$$$$$¶KC¶#VE#2#CF#100#CA#0#CM#0#SICT#0#AM#81#AM2#0#RT#7#¶KCC¶I1ZFIzEjRVJHIzQ1MzE2I0hJTiMwI0VDSyM1NjQ0ODB8NTY0NDgwfDU2NDk1NHw1NjUwNDJ8MHwwfDU2NXw1NjQ0MTN8NHwwfDh8MHwwfC0yMTQ3NDgzNjQ4I0dBTSMzMDEyNTAwMDAjClojVk4jMSNTVCMxNzM0NzIyMzk4I1BJIzEjWkkjMTk1OTUyI1RBIzAjREEjMzAxMjUjMVMjODAwMDI2MSMxVCMwI0xTIzgwMDAxOTkjTFQjMTEyMyNQVSM4MSNSVCMxI0NBI0lDRSNaRSM2MTgjWkIjSUNFICA2MTgjUEMjMCNGUiM4MDAwMjYxI0ZUIzAjVE8jODAwMDEwNSNUVCM0MzgjClojVk4jMSNTVCMxNzM0NzIyMzk4I1BJIzEjWkkjMTkyODc1I1RBIzAjREEjMzAxMjUjMVMjODAwMDEwNSMxVCM1MTIjTFMjODAwMDE5OSNMVCMxMDE4I1BVIzgxI1JUIzEjQ0EjSUNFI1pFIzEwODgjWkIjSUNFIDEwODgjUEMjMCNGUiM4MDAwMTA1I0ZUIzUxMiNUTyM4MDAzMjAwI1RUIzY0NCMKWiNWTiMxI1NUIzE3MzQ3MjIzOTgjUEkjMSNaSSMyMTg2NjIjVEEjMCNEQSMzMDEyNSMxUyM4MDAzMjAwIzFUIzcwMyNMUyM4MDAwMTQ5I0xUIzg1MCNQVSM4MSNSVCMxI0NBI0RQTiNaRSMyNjcwOCNaQiNSRSAyNjcwOCNQQyMzI0ZSIzgwMDMyMDAjRlQjNzAzI1RPIzgwMDAxNDkjVFQjODUwIwpaI1ZOIzEjU1QjMTczNDcyMjM5OCNQSSMxI1pJIzIxNzk5NiNUQSMwI0RBIzMwMTI1IzFTIzgwMDAxNzEjMVQjODQzI0xTIzgwMDAzMTYjTFQjOTUxI1BVIzgxI1JUIzEjQ0EjRFBOI1pFIzMyOTE2I1pCI1JFIDMyOTE2I1BDIzMjRlIjODAwMDE0OSNGVCM4NTkjVE8jODAwMDI2MyNUVCM5MjIj¶KRCC¶#VE#1#¶SC¶1_H4sIAAAAAAACA32P3UrDMACFX0VypVBHfpr+QSB2ZahMV8T5g3hR13SrdO1M0mEpfQ5fxru9mGmLFyJ6l3Nycr6TFuyFBAFAE9cDFhDv2ogonNxFE99oKd5A0IKy3s5AQK3+EIIAWqCqdZRoYcIYYgoRxGAwb/PtYGKbQGisbGg4RRZ4LZtZoeUcBE8t0M2uj8U3i8iEtlXaq4vrqRH7pKh7ZSoJ6J6HTdPNeiw25FTs5tVqrCny1CTPGOILdnX4LFcbUR6dv2T8gSFEqUeIzx+Z7SEbYuzzJfMQnzMPQogdxEPzbseQS2wXY+J7PGfLwweEHsTQeNyMUXr85GxYkkj5J1ppIY/vhdLZyTjAdQh1kWP4FPnUoQ75ySf/8RFE6Dd/LXRcFU2Rl8bTshaDdVnVshRNWNVlqkCQJYUaL+JEqSJX+jsrVlWcyGRrQm3XdV8RCJMF+wEAAA\u003d\u003d"}}

docs/dumps/PCAPdroid_16_Dec_19_30_43_locsearch.txt

@@ -1,17 +0,0 @@
-POST /mob/location/search HTTP/1.1
-Accept: application/x.db.vendo.mob.location.v3+json
-X-Correlation-ID: 4f2e274e-6e5c-4711-9125-87229046bba3_64466773-556f-4aa8-b128-0948c4d60887
-X-Device-Os-Name: Android
-X-Device-Os-Version: 32
-X-Device-Model: Google Pixel 3a
-X-App-Version: 24.32.2
-Accept-Language: en,de
-X-INSTANA-ANDROID: 560187ed-f13a-4654-bc62-b9f69f989563
-Content-Type: application/x.db.vendo.mob.location.v3+json
-Content-Length: 45
-Host: app.vendo.noncd.db.de
-Connection: Keep-Alive
-Accept-Encoding: gzip
-User-Agent: okhttp/4.12.0
-
-{"locationTypes":["ALL"],"searchTerm":"test"}

docs/dumps/PCAPdroid_16_Dec_19_31_06_locsearch.txt

@@ -1,17 +0,0 @@
-HTTP/1.1 200 OK
-Date: Mon, 16 Dec 2024 18:29:33 GMT
-Content-Type: application/x.db.vendo.mob.location.v3+json
-Content-Length: 2994
-Connection: keep-alive
-server-timing: intid;desc=a0c42ccdea3bbb18
-Server-Timing: intid;desc=a0c42ccdea3bbb18
-Server-Timing: intid;desc=a0c42ccdea3bbb18
-x-correlation-id: 4f2e274e-6e5c-4711-9125-87229046bba3_64466773-556f-4aa8-b128-0948c4d60887
-Strict-Transport-Security: max-age=16070400; includeSubDomains
-X-XSS-Protection: 0
-server-timing: intid;desc=a0c42ccdea3bbb18
-Content-Security-Policy: frame-ancestors 'none';
-X-Content-Type-Options: nosniff
-Set-Cookie: TS01be2125=01d513bcd1e15efa531633ee310f49108472c2b1a482b002a4d22b5cf935d3d6970510c0b134616b579c639af340fe261746662484; Path=/; Domain=.app.vendo.noncd.db.de; Secure; HTTPOnly
-
-[{"name":"Tessin West","stationId":"7983","locationId":"A=1@O=Tessin West@X=12442572@Y=54034438@U=81@L=8079604@B=1@p=1734031727@i=U×008030295@","evaNr":"8079604","coordinates":{"latitude":54.0344,"longitude":12.442203},"weight":1489,"products":["NAHVERKEHRSONSTIGEZUEGE","BUSSE","ANRUFPFLICHTIGEVERKEHRE"],"locationType":"ST"},{"name":"Testa Grigia","locationId":"A=1@O=Testa Grigia@X=7707540@Y=45934474@U=81@L=8511303@B=1@p=1734031727@i=U×008511303@","evaNr":"8511303","coordinates":{"latitude":45.934475,"longitude":7.70754},"weight":3825,"products":["NAHVERKEHRSONSTIGEZUEGE"],"locationType":"ST"},{"name":"Teschenhagen","stationId":"6172","locationId":"A=1@O=Teschenhagen@X=13374232@Y=54389368@U=81@L=8013104@B=1@p=1734031727@i=U×008028497@","evaNr":"8013104","coordinates":{"latitude":54.38936,"longitude":13.374196},"weight":3825,"products":["NAHVERKEHRSONSTIGEZUEGE"],"locationType":"ST"},{"name":"Testelt","locationId":"A=1@O=Testelt@X=4946863@Y=51009783@U=81@L=8800244@B=1@p=1734031727@i=U×008833266@","evaNr":"8800244","coordinates":{"latitude":51.009785,"longitude":4.946863},"weight":2627,"products":["INTERCITYUNDEUROCITYZUEGE","NAHVERKEHRSONSTIGEZUEGE"],"locationType":"ST"},{"name":"Tessin","stationId":"6174","locationId":"A=1@O=Tessin@X=12462618@Y=54032020@U=81@L=8013106@B=1@p=1734031727@i=U×008027109@","evaNr":"8013106","coordinates":{"latitude":54.032,"longitude":12.461656},"weight":2402,"products":["NAHVERKEHRSONSTIGEZUEGE","BUSSE"],"locationType":"ST"},{"name":"Chemnitz Zentralhaltestelle","locationId":"A=1@O=Chemnitz Zentralhaltestelle@X=12922263@Y=50831626@U=81@L=8017419@B=1@p=1734031727@i=U×008042918@","evaNr":"8017419","coordinates":{"latitude":50.831627,"longitude":12.922263},"weight":5813,"products":["NAHVERKEHRSONSTIGEZUEGE","BUSSE","STRASSENBAHN","ANRUFPFLICHTIGEVERKEHRE"],"locationType":"ST"},{"name":"Teschow","stationId":"6173","locationId":"A=1@O=Teschow@X=11637956@Y=53994355@U=81@L=8013105@B=1@p=1734031727@i=U×008027118@","evaNr":"8013105","coordinates":{"latitude":53.994175,"longitude":11.637687},"weight":1524,"products":["NAHVERKEHRSONSTIGEZUEGE","BUSSE"],"locationType":"ST"},{"name":"Tesperhude Hudehof, Geesthacht","locationId":"A=1@O=Tesperhude Hudehof, Geesthacht@X=10431253@Y=53404393@U=81@L=694334@B=1@p=1734031727@","evaNr":"694334","coordinates":{"latitude":53.404392,"longitude":10.431253},"weight":912,"products":["BUSSE"],"locationType":"ST"},{"name":"Tesperhude Strandweg, Geesthacht","locationId":"A=1@O=Tesperhude Strandweg, Geesthacht@X=10427424@Y=53402316@U=81@L=694333@B=1@p=1734031727@","evaNr":"694333","coordinates":{"latitude":53.402317,"longitude":10.427424},"weight":912,"products":["BUSSE"],"locationType":"ST"},{"name":"Testorf Umspannwerk, Wangels","locationId":"A=1@O=Testorf Umspannwerk, Wangels@X=10778516@Y=54250161@U=81@L=700240@B=1@p=1734031727@","evaNr":"700240","coordinates":{"latitude":54.25016,"longitude":10.778516},"weight":220,"products":["BUSSE","ANRUFPFLICHTIGEVERKEHRE"],"locationType":"ST"}]

docs/dumps/PCAPdroid_16_Dec_19_33_04_routesearch.txt

@@ -1,18 +0,0 @@
-POST /mob/angebote/fahrplan HTTP/1.1
-Accept: application/x.db.vendo.mob.verbindungssuche.v8+json
-x-feature-reiseketten-enabled: false
-X-Correlation-ID: 0564dcdf-edbf-4412-a147-7299f6481470_64466773-556f-4aa8-b128-0948c4d60887
-X-Device-Os-Name: Android
-X-Device-Os-Version: 32
-X-Device-Model: Google Pixel 3a
-X-App-Version: 24.32.2
-Accept-Language: en,de
-X-INSTANA-ANDROID: 0d0c6c50-3bea-4cb7-b008-09bc92a0d96a
-Content-Type: application/x.db.vendo.mob.verbindungssuche.v8+json
-Content-Length: 679
-Host: app.vendo.noncd.db.de
-Connection: Keep-Alive
-Accept-Encoding: gzip
-User-Agent: okhttp/4.12.0
-
-{"autonomeReservierung":false,"einstiegsTypList":["STANDARD"],"klasse":"KLASSE_2","reiseHin":{"wunsch":{"abgangsLocationId":"A\u003d1@O\u003dBerlin Hbf@X\u003d13369549@Y\u003d52525589@U\u003d81@L\u003d8011160@B\u003d1@p\u003d1734031727@i\u003dU×008065969@","verkehrsmittel":["ALL"],"zeitWunsch":{"reiseDatum":"2024-12-16T19:28:48.659812+01:00","zeitPunktArt":"ABFAHRT"},"zielLocationId":"A\u003d1@O\u003dKöln Hbf@X\u003d6958730@Y\u003d50943029@U\u003d81@L\u003d8000207@B\u003d1@p\u003d1734031727@i\u003dU×008015458@"}},"reisendenProfil":{"reisende":[{"ermaessigungen":["KEINE_ERMAESSIGUNG KLASSENLOS"],"reisendenTyp":"ERWACHSENER"}]},"reservierungsKontingenteVorhanden":false}

docs/dumps/PCAPdroid_16_Dec_19_35_50_triprecon.txt

@@ -1,17 +0,0 @@
-POST /mob/trip/recon HTTP/1.1
-Accept: application/x.db.vendo.mob.verbindungssuche.v8+json
-X-Correlation-ID: 0564dcdf-edbf-4412-a147-7299f6481470_64466773-556f-4aa8-b128-0948c4d60887
-X-Device-Os-Name: Android
-X-Device-Os-Version: 32
-X-Device-Model: Google Pixel 3a
-X-App-Version: 24.32.2
-Accept-Language: en,de
-X-INSTANA-ANDROID: 757b9806-028b-4b0e-bdde-2441c2e1e1ee
-Content-Type: application/x.db.vendo.mob.verbindungssuche.v8+json
-Content-Length: 1162
-Host: app.vendo.noncd.db.de
-Connection: Keep-Alive
-Accept-Encoding: gzip
-User-Agent: okhttp/4.12.0
-
-{"reconCtx":"¶HKI¶T$A\u003d1@O\u003dBerlin Hbf@X\u003d13369549@Y\u003d52525589@L\u003d8011160@a\u003d128@$A\u003d1@O\u003dKöln Hbf@X\u003d6958730@Y\u003d50943029@L\u003d8000207@a\u003d128@$202412161946$202412170057$ICE  842$$1$$$$$$¶KC¶#VE#2#CF#100#CA#0#CM#0#SICT#0#AM#81#AM2#0#RT#7#¶KCC¶I1ZFIzEjRVJHIzEjSElOIzAjRUNLIzUzOTc0Nnw1Mzk3NDZ8NTQwMDU3fDU0MDA1N3wwfDB8NTY1fDUzOTcyNXwxfDB8MTA1MHwwfDB8LTIxNDc0ODM2NDgjR0FNIzE2MTIyNDE5NDYjClojVk4jMSNTVCMxNzM0MDMxNzI3I1BJIzEjWkkjMTc3NjUxI1RBIzAjREEjMTYxMjI0IzFTIzgwMTAyNTUjMVQjMTkzNCNMUyM4MDAwMjA3I0xUIzEwMDU3I1BVIzgxI1JUIzEjQ0EjSUNFI1pFIzg0MiNaQiNJQ0UgIDg0MiNQQyMwI0ZSIzgwMTExNjAjRlQjMTk0NiNUTyM4MDAwMjA3I1RUIzEwMDU3Iw\u003d\u003d¶KRCC¶#VE#1#¶SC¶1_H4sIAAAAAAACA32P7UrDMBiFb0Xyu4436WcKgdiV4cfQIk4U8Udds1lJ25mmw1J6Hd6JN7AbM20ZCIrkT87JyXnet0N7oVCI8MwPkIXEhzYijmb38YwarcQ7CjtUNsUCha41XCIUgoWqRsepFiZMgDiYYA+N5l1eDCamJAAw1mZsOMUWeivbhdRqicKnDul2N8SS25vYhIoqG9TF9dyIfSqbsQKIjfrncab563YqNuRM7JbVeqqReWaSZwzzGxYJJfPy5Pxlwx8Ytm2Pug7lj8wl5rgB5SsWYL5kAWCMPeCR+bVj2LcdsLFPfJ6z1eETIADPpR7lZpRaTysuxjlSpf4EXx2+5JFroIFvw4AF6thAfmABCPj/YLHruMFv7FbopJKt2c14WjVitC6rRpWijaqmzGoUblJZTw9JWtcyr/UxK9ZVkqq0MKGu7/tvvH4lCvABAAA\u003d"}

docs/dumps/PCAPdroid_16_Dec_19_36_19_triprecon.txt

@@ -1,17 +0,0 @@
-POST /mob/trip/recon HTTP/1.1
-Accept: application/x.db.vendo.mob.verbindungssuche.v8+json
-X-Correlation-ID: 0564dcdf-edbf-4412-a147-7299f6481470_64466773-556f-4aa8-b128-0948c4d60887
-X-Device-Os-Name: Android
-X-Device-Os-Version: 32
-X-Device-Model: Google Pixel 3a
-X-App-Version: 24.32.2
-Accept-Language: en,de
-X-INSTANA-ANDROID: f30d7ef5-d9a2-428b-acc2-e8bb68c7d705
-Content-Type: application/x.db.vendo.mob.verbindungssuche.v8+json
-Content-Length: 2507
-Host: app.vendo.noncd.db.de
-Connection: Keep-Alive
-Accept-Encoding: gzip
-User-Agent: okhttp/4.12.0
-
-{"reconCtx":"¶HKI¶T$A\u003d1@O\u003dBerlin Hbf@X\u003d13369549@Y\u003d52525589@L\u003d8098160@a\u003d128@$A\u003d1@O\u003dHannover Hbf@X\u003d9741017@Y\u003d52376764@L\u003d8000152@a\u003d128@$202412162128$202412162322$ICE  840$$1$$$$$$§T$A\u003d1@O\u003dHannover Hbf@X\u003d9741017@Y\u003d52376764@L\u003d8000152@a\u003d128@$A\u003d1@O\u003dHanau Hbf@X\u003d8929003@Y\u003d50120957@L\u003d8000150@a\u003d128@$202412170030$202412170414$IC 60471$$1$$$$$$§T$A\u003d1@O\u003dHanau Hbf@X\u003d8929003@Y\u003d50120957@L\u003d8000150@a\u003d128@$A\u003d1@O\u003dFrankfurt(Main)Hbf@X\u003d8663785@Y\u003d50107149@L\u003d8000105@a\u003d128@$202412170455$202412170515$RB 15501$$1$$$$$$§T$A\u003d1@O\u003dFrankfurt(Main)Hbf@X\u003d8663785@Y\u003d50107149@L\u003d8000105@a\u003d128@$A\u003d1@O\u003dKöln Hbf@X\u003d6958730@Y\u003d50943029@L\u003d8000207@a\u003d128@$202412170526$202412170633$ICE  222$$1$$$$$$¶KC¶#VE#2#CF#100#CA#0#CM#0#SICT#0#AM#81#AM2#0#RT#7#¶KCC¶I1ZFIzEjRVJHIzI2MCNISU4jNDU1I0VDSyM1Mzk4NDh8NTM5ODQ4fDU0MDM5M3w1NDAzOTN8MHwwfDU2NXw1Mzk4NDh8NHwwfDE4fDB8MHwtMjE0NzQ4MzY0OCNHQU0jMTYxMjI0MjEyOCMKWiNWTiMxI1NUIzE3MzQwMzE3MjcjUEkjMSNaSSMxNzc2MTkjVEEjMCNEQSMxNjEyMjQjMVMjODA5ODE2MCMxVCMyMTI4I0xTIzgwMDAxNTIjTFQjMjMyMiNQVSM4MSNSVCMxI0NBI0lDRSNaRSM4NDAjWkIjSUNFICA4NDAjUEMjMCNGUiM4MDk4MTYwI0ZUIzIxMjgjVE8jODAwMDE1MiNUVCMyMzIyIwpaI1ZOIzEjU1QjMTczNDAzMTcyNyNQSSMxI1pJIzE3MzY1MSNUQSMwI0RBIzE2MTIyNCMxUyM4MDAyNTUzIzFUIzIxNTIjTFMjODUwMzAwMCNMVCMxMTAwNSNQVSM4MSNSVCMxI0NBI0lDI1pFIzYwNDcxI1pCI0lDIDYwNDcxI1BDIzEjRlIjODAwMDE1MiNGVCMxMDAzMCNUTyM4MDAwMTUwI1RUIzEwNDE0IwpaI1ZOIzEjU1QjMTczNDAzMTcyNyNQSSMxI1pJIzE4NzYxOCNUQSMwI0RBIzE3MTIyNCMxUyM4MDA2MTMyIzFUIzQxOCNMUyM4MDAwMTA1I0xUIzUxNSNQVSM4MSNSVCMxI0NBI1JCI1pFIzE1NTAxI1pCI1JCIDE1NTAxI1BDIzMjRlIjODAwMDE1MCNGVCM0NTUjVE8jODAwMDEwNSNUVCM1MTUjClojVk4jMSNTVCMxNzM0MDMxNzI3I1BJIzEjWkkjMjExNDMzI1RBIzAjREEjMTcxMjI0IzFTIzgwMDAxMDUjMVQjNTI2I0xTIzg0MDAwNTgjTFQjOTI5I1BVIzgxI1JUIzEjQ0EjSUNFI1pFIzIyMiNaQiNJQ0UgIDIyMiNQQyMwI0ZSIzgwMDAxMDUjRlQjNTI2I1RPIzgwMDAyMDcjVFQjNjMzIw\u003d\u003d¶KRCC¶#VE#1#¶SC¶1_H4sIAAAAAAACA32P7UrDMBiFb0Xyu4436WcKgdiV4cfQIk4U8Udds1lJ25mmw1J6Hd6JN7AbM20ZCIrkT87JyXnet0N7oVCI8MwPkIXEhzYijmb38YwarcQ7CjtUNsUCha41XCIUgoWqRsepFiZMgDiYYA+N5l1eDCamJAAw1mZsOMUWeivbhdRqicKnDul2N8SS25vYhIoqG9TF9dyIfSqbsQKIjfrncab563YqNuRM7JbVeqqReWaSZwzzGxYJJfPy5Pxlwx8Ytm2Pug7lj8wl5rgB5SsWYL5kAWCMPeCR+bVj2LcdsLFPfJ6z1eETIADPpR7lZpRaTysuxjlSpf4EXx2+5JFroIFvw4AF6thAfmABCPj/YLHruMFv7FbopJKt2c14WjVitC6rRpWijaqmzGoUblJZTw9JWtcyr/UxK9ZVkqq0MKGu7/tvvH4lCvABAAA\u003d"}

docs/dumps/PCAPdroid_16_Dec_19_37_19_locationdetails.txt

@@ -1,15 +0,0 @@
-GET /mob/location/details/8011160 HTTP/1.1
-Accept: application/x.db.vendo.mob.location.v3+json
-Content-Type: application/x.db.vendo.mob.location.v3+json
-X-Correlation-ID: 0564dcdf-edbf-4412-a147-7299f6481470_64466773-556f-4aa8-b128-0948c4d60887
-X-Device-Os-Name: Android
-X-Device-Os-Version: 32
-X-Device-Model: Google Pixel 3a
-X-App-Version: 24.32.2
-Accept-Language: en,de
-X-INSTANA-ANDROID: b9bd5e93-e6d2-4998-bc5a-17b72ca65ca3
-Host: app.vendo.noncd.db.de
-Connection: Keep-Alive
-Accept-Encoding: gzip
-User-Agent: okhttp/4.12.0
-

docs/dumps/PCAPdroid_16_Dec_19_37_22_locationdetails.txt

@@ -1,17 +0,0 @@
-HTTP/1.1 200 OK
-Date: Mon, 16 Dec 2024 18:36:50 GMT
-Content-Type: application/x.db.vendo.mob.location.v3+json
-Content-Length: 1158
-Connection: keep-alive
-server-timing: intid;desc=5ae5ce547c4a8b38
-Server-Timing: intid;desc=5ae5ce547c4a8b38
-Server-Timing: intid;desc=5ae5ce547c4a8b38
-x-correlation-id: 0564dcdf-edbf-4412-a147-7299f6481470_64466773-556f-4aa8-b128-0948c4d60887
-Strict-Transport-Security: max-age=16070400; includeSubDomains
-X-XSS-Protection: 0
-server-timing: intid;desc=5ae5ce547c4a8b38
-Content-Security-Policy: frame-ancestors 'none';
-X-Content-Type-Options: nosniff
-Set-Cookie: TS01be2125=01d513bcd125629ac814505605565f3e87a8081db30d56beae22efb148df982534183fd830148fa0901fa5a36116fab13d52c5d86a; Path=/; Domain=.app.vendo.noncd.db.de; Secure; HTTPOnly
-
-{"haltName":"Berlin Hbf","produktGattungen":[{"produktGattung":"HOCHGESCHWINDIGKEITSZUEGE","produkte":[{"name":"ICE"},{"name":"RJ"}]},{"produktGattung":"INTERCITYUNDEUROCITYZUEGE","produkte":[{"name":"EC"},{"name":"IC"},{"name":"NJ"}]},{"produktGattung":"INTERREGIOUNDSCHNELLZUEGE","produkte":[{"name":"BUS"},{"name":"Bus"},{"name":"D"},{"name":"EN"},{"name":"ES"},{"name":"FLX"},{"name":"UEX"}]},{"produktGattung":"NAHVERKEHRSONSTIGEZUEGE","produkte":[{"name":"FEX"},{"name":"HBX"},{"name":"R"},{"name":"RB"},{"name":"RE"},{"name":"RSM"},{"name":"Bus RE3"},{"name":"Bus RE5"},{"name":"Bus RE7"},{"name":"Bus RE8"},{"name":"Bus S7"}]},{"produktGattung":"SBAHNEN","produkte":[{"name":"S 3"},{"name":"S 5"},{"name":"S 7"},{"name":"S 9"},{"name":"S 45"}]},{"produktGattung":"BUSSE","produkte":[{"name":"Bus 120"},{"name":"Bus 123"},{"name":"Bus 142"},{"name":"Bus 147"},{"name":"Bus 245"},{"name":"Bus M41"},{"name":"Bus M85"},{"name":"Bus N5"},{"name":"Bus N20"},{"name":"Bus N40"}]},{"produktGattung":"UBAHN","produkte":[{"name":"U 5"}]},{"produktGattung":"STRASSENBAHN","produkte":[{"name":"STR 12"},{"name":"STR M5"},{"name":"STR M8"},{"name":"STR M10"}]}]}

docs/dumps/PCAPdroid_16_Dec_19_37_26_departures.txt

@@ -1,17 +0,0 @@
-POST /mob/bahnhofstafel/abfahrt HTTP/1.1
-Accept: application/x.db.vendo.mob.bahnhofstafeln.v2+json
-X-Correlation-ID: 0564dcdf-edbf-4412-a147-7299f6481470_64466773-556f-4aa8-b128-0948c4d60887
-X-Device-Os-Name: Android
-X-Device-Os-Version: 32
-X-Device-Model: Google Pixel 3a
-X-App-Version: 24.32.2
-Accept-Language: en,de
-X-INSTANA-ANDROID: b2d3fe71-a8d6-4675-bbe5-a5081368a6ab
-Content-Type: application/x.db.vendo.mob.bahnhofstafeln.v2+json
-Content-Length: 197
-Host: app.vendo.noncd.db.de
-Connection: Keep-Alive
-Accept-Encoding: gzip
-User-Agent: okhttp/4.12.0
-
-{"anfragezeit":"21:28","datum":"2024-12-16","ursprungsBahnhofId":"A\u003d1@O\u003dBerlin Hbf@X\u003d13369549@Y\u003d52525589@U\u003d81@L\u003d8098160@i\u003dU×008031922@","verkehrsmittel":["ALL"]}

docs/dumps/PCAPdroid_16_Dec_19_38_00_departures.txt

@@ -1,17 +0,0 @@
-POST /mob/bahnhofstafel/abfahrt HTTP/1.1
-Accept: application/x.db.vendo.mob.bahnhofstafeln.v2+json
-X-Correlation-ID: 0564dcdf-edbf-4412-a147-7299f6481470_64466773-556f-4aa8-b128-0948c4d60887
-X-Device-Os-Name: Android
-X-Device-Os-Version: 32
-X-Device-Model: Google Pixel 3a
-X-App-Version: 24.32.2
-Accept-Language: en,de
-X-INSTANA-ANDROID: 8c20d0c0-3c0b-40ef-bc95-849c65e375df
-Content-Type: application/x.db.vendo.mob.bahnhofstafeln.v2+json
-Content-Length: 378
-Host: app.vendo.noncd.db.de
-Connection: Keep-Alive
-Accept-Encoding: gzip
-User-Agent: okhttp/4.12.0
-
-{"anfragezeit":"21:28","datum":"2024-12-16","ursprungsBahnhofId":"A\u003d1@O\u003dBerlin Hbf@X\u003d13369549@Y\u003d52525589@U\u003d81@L\u003d8098160@i\u003dU×008031922@","verkehrsmittel":["HOCHGESCHWINDIGKEITSZUEGE","INTERCITYUNDEUROCITYZUEGE","INTERREGIOUNDSCHNELLZUEGE","NAHVERKEHRSONSTIGEZUEGE","SBAHNEN","BUSSE","SCHIFFE","UBAHN","STRASSENBAHN","ANRUFPFLICHTIGEVERKEHRE"]}

docs/dumps/PCAPdroid_16_Dec_19_38_44_arrivals.txt

@@ -1,17 +0,0 @@
-POST /mob/bahnhofstafel/ankunft HTTP/1.1
-Accept: application/x.db.vendo.mob.bahnhofstafeln.v2+json
-X-Correlation-ID: 0564dcdf-edbf-4412-a147-7299f6481470_64466773-556f-4aa8-b128-0948c4d60887
-X-Device-Os-Name: Android
-X-Device-Os-Version: 32
-X-Device-Model: Google Pixel 3a
-X-App-Version: 24.32.2
-Accept-Language: en,de
-X-INSTANA-ANDROID: d7e7526d-1d69-41d1-bf48-9c2ed5f4a302
-Content-Type: application/x.db.vendo.mob.bahnhofstafeln.v2+json
-Content-Length: 378
-Host: app.vendo.noncd.db.de
-Connection: Keep-Alive
-Accept-Encoding: gzip
-User-Agent: okhttp/4.12.0
-
-{"anfragezeit":"21:28","datum":"2024-12-16","ursprungsBahnhofId":"A\u003d1@O\u003dBerlin Hbf@X\u003d13369549@Y\u003d52525589@U\u003d81@L\u003d8098160@i\u003dU×008031922@","verkehrsmittel":["HOCHGESCHWINDIGKEITSZUEGE","INTERCITYUNDEUROCITYZUEGE","INTERREGIOUNDSCHNELLZUEGE","NAHVERKEHRSONSTIGEZUEGE","SBAHNEN","BUSSE","SCHIFFE","UBAHN","STRASSENBAHN","ANRUFPFLICHTIGEVERKEHRE"]}

docs/dumps/PCAPdroid_16_Dec_19_39_50_locsearch_station.txt

@@ -1,17 +0,0 @@
-POST /mob/location/search HTTP/1.1
-Accept: application/x.db.vendo.mob.location.v3+json
-X-Correlation-ID: 0564dcdf-edbf-4412-a147-7299f6481470_64466773-556f-4aa8-b128-0948c4d60887
-X-Device-Os-Name: Android
-X-Device-Os-Version: 32
-X-Device-Model: Google Pixel 3a
-X-App-Version: 24.32.2
-Accept-Language: en,de
-X-INSTANA-ANDROID: 91946e30-da87-4813-9a13-48dce2cd2cdd
-Content-Type: application/x.db.vendo.mob.location.v3+json
-Content-Length: 44
-Host: app.vendo.noncd.db.de
-Connection: Keep-Alive
-Accept-Encoding: gzip
-User-Agent: okhttp/4.12.0
-
-{"locationTypes":["ST"],"searchTerm":"test"}

docs/dumps/PCAPdroid_16_Dec_19_39_53_locsearch_station.txt

@@ -1,17 +0,0 @@
-HTTP/1.1 200 OK
-Date: Mon, 16 Dec 2024 18:39:38 GMT
-Content-Type: application/x.db.vendo.mob.location.v3+json
-Content-Length: 2994
-Connection: keep-alive
-server-timing: intid;desc=6e7cf7863b2dbf7b
-Server-Timing: intid;desc=6e7cf7863b2dbf7b
-Server-Timing: intid;desc=6e7cf7863b2dbf7b
-x-correlation-id: 0564dcdf-edbf-4412-a147-7299f6481470_64466773-556f-4aa8-b128-0948c4d60887
-Strict-Transport-Security: max-age=16070400; includeSubDomains
-X-XSS-Protection: 0
-server-timing: intid;desc=6e7cf7863b2dbf7b
-Content-Security-Policy: frame-ancestors 'none';
-X-Content-Type-Options: nosniff
-Set-Cookie: TS01be2125=01d513bcd109bdf5d864ee9ff6d510d0c0e6688e510fd271d9dba08fe92a99ec7d68b43cb8eddd472ec4074727d7ed3137ea220214; Path=/; Domain=.app.vendo.noncd.db.de; Secure; HTTPOnly
-
-[{"name":"Tessin West","stationId":"7983","locationId":"A=1@O=Tessin West@X=12442572@Y=54034438@U=81@L=8079604@B=1@p=1734031727@i=U×008030295@","evaNr":"8079604","coordinates":{"latitude":54.0344,"longitude":12.442203},"weight":1489,"products":["NAHVERKEHRSONSTIGEZUEGE","BUSSE","ANRUFPFLICHTIGEVERKEHRE"],"locationType":"ST"},{"name":"Testa Grigia","locationId":"A=1@O=Testa Grigia@X=7707540@Y=45934474@U=81@L=8511303@B=1@p=1734031727@i=U×008511303@","evaNr":"8511303","coordinates":{"latitude":45.934475,"longitude":7.70754},"weight":3825,"products":["NAHVERKEHRSONSTIGEZUEGE"],"locationType":"ST"},{"name":"Teschenhagen","stationId":"6172","locationId":"A=1@O=Teschenhagen@X=13374232@Y=54389368@U=81@L=8013104@B=1@p=1734031727@i=U×008028497@","evaNr":"8013104","coordinates":{"latitude":54.38936,"longitude":13.374196},"weight":3825,"products":["NAHVERKEHRSONSTIGEZUEGE"],"locationType":"ST"},{"name":"Testelt","locationId":"A=1@O=Testelt@X=4946863@Y=51009783@U=81@L=8800244@B=1@p=1734031727@i=U×008833266@","evaNr":"8800244","coordinates":{"latitude":51.009785,"longitude":4.946863},"weight":2627,"products":["INTERCITYUNDEUROCITYZUEGE","NAHVERKEHRSONSTIGEZUEGE"],"locationType":"ST"},{"name":"Tessin","stationId":"6174","locationId":"A=1@O=Tessin@X=12462618@Y=54032020@U=81@L=8013106@B=1@p=1734031727@i=U×008027109@","evaNr":"8013106","coordinates":{"latitude":54.032,"longitude":12.461656},"weight":2402,"products":["NAHVERKEHRSONSTIGEZUEGE","BUSSE"],"locationType":"ST"},{"name":"Chemnitz Zentralhaltestelle","locationId":"A=1@O=Chemnitz Zentralhaltestelle@X=12922263@Y=50831626@U=81@L=8017419@B=1@p=1734031727@i=U×008042918@","evaNr":"8017419","coordinates":{"latitude":50.831627,"longitude":12.922263},"weight":5813,"products":["NAHVERKEHRSONSTIGEZUEGE","BUSSE","STRASSENBAHN","ANRUFPFLICHTIGEVERKEHRE"],"locationType":"ST"},{"name":"Teschow","stationId":"6173","locationId":"A=1@O=Teschow@X=11637956@Y=53994355@U=81@L=8013105@B=1@p=1734031727@i=U×008027118@","evaNr":"8013105","coordinates":{"latitude":53.994175,"longitude":11.637687},"weight":1524,"products":["NAHVERKEHRSONSTIGEZUEGE","BUSSE"],"locationType":"ST"},{"name":"Tesperhude Hudehof, Geesthacht","locationId":"A=1@O=Tesperhude Hudehof, Geesthacht@X=10431253@Y=53404393@U=81@L=694334@B=1@p=1734031727@","evaNr":"694334","coordinates":{"latitude":53.404392,"longitude":10.431253},"weight":912,"products":["BUSSE"],"locationType":"ST"},{"name":"Tesperhude Strandweg, Geesthacht","locationId":"A=1@O=Tesperhude Strandweg, Geesthacht@X=10427424@Y=53402316@U=81@L=694333@B=1@p=1734031727@","evaNr":"694333","coordinates":{"latitude":53.402317,"longitude":10.427424},"weight":912,"products":["BUSSE"],"locationType":"ST"},{"name":"Testorf Umspannwerk, Wangels","locationId":"A=1@O=Testorf Umspannwerk, Wangels@X=10778516@Y=54250161@U=81@L=700240@B=1@p=1734031727@","evaNr":"700240","coordinates":{"latitude":54.25016,"longitude":10.778516},"weight":220,"products":["BUSSE","ANRUFPFLICHTIGEVERKEHRE"],"locationType":"ST"}]

docs/dumps/PCAPdroid_16_Dec_19_42_53_specialrouting.txt

@@ -1,18 +0,0 @@
-POST /mob/angebote/fahrplan HTTP/1.1
-Accept: application/x.db.vendo.mob.verbindungssuche.v8+json
-x-feature-reiseketten-enabled: false
-X-Correlation-ID: 67b8a500-1983-49f5-a4ff-177d58b395ed_64466773-556f-4aa8-b128-0948c4d60887
-X-Device-Os-Name: Android
-X-Device-Os-Version: 32
-X-Device-Model: Google Pixel 3a
-X-App-Version: 24.32.2
-Accept-Language: en,de
-X-INSTANA-ANDROID: be862f65-99be-46af-a622-8bc332dc70df
-Content-Type: application/x.db.vendo.mob.verbindungssuche.v8+json
-Content-Length: 1122
-Host: app.vendo.noncd.db.de
-Connection: Keep-Alive
-Accept-Encoding: gzip
-User-Agent: okhttp/4.12.0
-
-{"autonomeReservierung":false,"einstiegsTypList":["STANDARD"],"klasse":"KLASSE_2","reiseHin":{"wunsch":{"abgangsLocationId":"A\u003d1@O\u003dBerlin Hbf@X\u003d13369549@Y\u003d52525589@U\u003d81@L\u003d8011160@B\u003d1@p\u003d1734031727@i\u003dU×008065969@","economic":true,"minUmstiegsdauer":20,"verkehrsmittel":["NAHVERKEHRSONSTIGEZUEGE","SBAHNEN","BUSSE","SCHIFFE","UBAHN","STRASSENBAHN","ANRUFPFLICHTIGEVERKEHRE"],"viaLocations":[{"locationId":"A\u003d1@O\u003dHannover Hbf@X\u003d9741017@Y\u003d52376764@U\u003d81@L\u003d8000152@B\u003d1@p\u003d1734031727@i\u003dU×008013552@","minUmstiegsdauer":60,"verkehrsmittel":["NAHVERKEHRSONSTIGEZUEGE","SBAHNEN","BUSSE","SCHIFFE","UBAHN","STRASSENBAHN","ANRUFPFLICHTIGEVERKEHRE"]}],"zeitWunsch":{"reiseDatum":"2024-12-16T19:28:48.659+01:00","zeitPunktArt":"ABFAHRT"},"zielLocationId":"A\u003d1@O\u003dKöln Hbf@X\u003d6958730@Y\u003d50943029@U\u003d81@L\u003d8000207@B\u003d1@p\u003d1734031727@i\u003dU×008015458@"}},"reisendenProfil":{"reisende":[{"ermaessigungen":["KEINE_ERMAESSIGUNG KLASSENLOS"],"reisendenTyp":"ERWACHSENER"}]},"reservierungsKontingenteVorhanden":false}

docs/dumps/PCAPdroid_16_Dec_19_46_29_bahncard.txt

@@ -1,18 +0,0 @@
-POST /mob/angebote/fahrplan HTTP/1.1
-Accept: application/x.db.vendo.mob.verbindungssuche.v8+json
-x-feature-reiseketten-enabled: false
-X-Correlation-ID: b8d93b08-71ac-4cc2-836e-cd2683e34478_64466773-556f-4aa8-b128-0948c4d60887
-X-Device-Os-Name: Android
-X-Device-Os-Version: 32
-X-Device-Model: Google Pixel 3a
-X-App-Version: 24.32.2
-Accept-Language: en,de
-X-INSTANA-ANDROID: c752e01a-e03e-42a5-bcd3-26b1cc2574b3
-Content-Type: application/x.db.vendo.mob.verbindungssuche.v8+json
-Content-Length: 783
-Host: app.vendo.noncd.db.de
-Connection: Keep-Alive
-Accept-Encoding: gzip
-User-Agent: okhttp/4.12.0
-
-{"autonomeReservierung":false,"einstiegsTypList":["STANDARD"],"klasse":"KLASSE_2","reiseHin":{"wunsch":{"abgangsLocationId":"A\u003d1@O\u003dKöln Hbf@X\u003d6958730@Y\u003d50943029@U\u003d81@L\u003d8000207@B\u003d1@p\u003d1734031727@i\u003dU×008015458@","minUmstiegsdauer":20,"verkehrsmittel":["NAHVERKEHRSONSTIGEZUEGE","SBAHNEN","BUSSE","SCHIFFE","UBAHN","STRASSENBAHN","ANRUFPFLICHTIGEVERKEHRE"],"zeitWunsch":{"reiseDatum":"2024-12-16T19:45:47.459239+01:00","zeitPunktArt":"ABFAHRT"},"zielLocationId":"A\u003d1@O\u003dBerlin Hbf@X\u003d13369549@Y\u003d52525589@U\u003d81@L\u003d8011160@B\u003d1@p\u003d1734031727@i\u003dU×008065969@"}},"reisendenProfil":{"reisende":[{"ermaessigungen":["BAHNCARD25 KLASSE_2"],"reisendenTyp":"SENIOR"}]},"reservierungsKontingenteVorhanden":false}

docs/dumps/PCAPdroid_16_Dec_19_47_54_zuglauf.txt

@@ -1,15 +0,0 @@
-GET /mob/zuglauf/2%7C%23VN%231%23ST%231734031727%23PI%231%23ZI%23178229%23TA%230%23DA%23161224%231S%238000207%231T%231926%23LS%238098160%23LT%2310012%23PU%2381%23RT%231%23CA%23ICE%23ZE%23947%23ZB%23ICE%20%20947%23PC%230%23FR%238000207%23FT%231926%23TO%238098160%23TT%2310012%23 HTTP/1.1
-Accept: application/x.db.vendo.mob.zuglauf.v2+json
-Content-Type: application/x.db.vendo.mob.zuglauf.v2+json
-X-Correlation-ID: b8d93b08-71ac-4cc2-836e-cd2683e34478_64466773-556f-4aa8-b128-0948c4d60887
-X-Device-Os-Name: Android
-X-Device-Os-Version: 32
-X-Device-Model: Google Pixel 3a
-X-App-Version: 24.32.2
-Accept-Language: en,de
-X-INSTANA-ANDROID: 57c6969b-e937-4591-accf-0850e7b72278
-Host: app.vendo.noncd.db.de
-Connection: Keep-Alive
-Accept-Encoding: gzip
-User-Agent: okhttp/4.12.0
-

docs/dumps/PCAPdroid_16_Dec_19_48_15_coachseq.txt

@@ -1,15 +0,0 @@
-GET /mob/zuglaeufe/ICE_947/halte/by-abfahrt/8000207_2024-12-16T19:26:00+01:00/wagenreihung HTTP/1.1
-Accept: application/x.db.vendo.mob.wagenreihung.v3+json
-Content-Type: application/x.db.vendo.mob.wagenreihung.v3+json
-X-Correlation-ID: b8d93b08-71ac-4cc2-836e-cd2683e34478_64466773-556f-4aa8-b128-0948c4d60887
-X-Device-Os-Name: Android
-X-Device-Os-Version: 32
-X-Device-Model: Google Pixel 3a
-X-App-Version: 24.32.2
-Accept-Language: en,de
-X-INSTANA-ANDROID: 4ce19a5d-9da2-480d-a278-543fade2f485
-Host: app.vendo.noncd.db.de
-Connection: Keep-Alive
-Accept-Encoding: gzip
-User-Agent: okhttp/4.12.0
-

docs/dumps/PCAPdroid_16_Dec_19_48_25_coachseq.txt

@@ -1,15 +0,0 @@
-GET /mob/zuglaeufe/ICE_947/halte/by-abfahrt/8000207_2024-12-16T19:26:00+01:00/wagenreihung HTTP/1.1
-Accept: application/x.db.vendo.mob.wagenreihung.v3+json
-Content-Type: application/x.db.vendo.mob.wagenreihung.v3+json
-X-Correlation-ID: b8d93b08-71ac-4cc2-836e-cd2683e34478_64466773-556f-4aa8-b128-0948c4d60887
-X-Device-Os-Name: Android
-X-Device-Os-Version: 32
-X-Device-Model: Google Pixel 3a
-X-App-Version: 24.32.2
-Accept-Language: en,de
-X-INSTANA-ANDROID: 4ce19a5d-9da2-480d-a278-543fade2f485
-Host: app.vendo.noncd.db.de
-Connection: Keep-Alive
-Accept-Encoding: gzip
-User-Agent: okhttp/4.12.0
-

docs/dumps/PCAPdroid_16_Dec_19_49_08_coachseq.txt

@@ -1,17 +0,0 @@
-HTTP/1.1 200 OK
-Date: Mon, 16 Dec 2024 18:48:06 GMT
-Content-Type: application/x.db.vendo.mob.wagenreihung.v3+json
-Content-Length: 4538
-Connection: keep-alive
-server-timing: intid;desc=8f64b8dc41cc78fe
-Server-Timing: intid;desc=8f64b8dc41cc78fe
-Server-Timing: intid;desc=8f64b8dc41cc78fe
-x-correlation-id: b8d93b08-71ac-4cc2-836e-cd2683e34478_64466773-556f-4aa8-b128-0948c4d60887
-Strict-Transport-Security: max-age=16070400; includeSubDomains
-X-XSS-Protection: 0
-server-timing: intid;desc=8f64b8dc41cc78fe
-Content-Security-Policy: frame-ancestors 'none';
-X-Content-Type-Options: nosniff
-Set-Cookie: TS01be2125=01d513bcd1b784b8e477d277c1a5b018395e42eab8d1fee3cb97bf2b9ec80a7dd3763f495c187c41e167ab4fcf87709c96c07cb192; Path=/; Domain=.app.vendo.noncd.db.de; Secure; HTTPOnly
-
-{"status":"MATCHES_SCHEDULE","gleis":{"start":{"position":0},"ende":{"position":487},"sektoren":[{"bezeichnung":"G","start":{"position":0},"ende":{"position":96.75},"gleisabschnittswuerfelPosition":58,"ersteKlasse":false},{"bezeichnung":"F","start":{"position":96.75},"ende":{"position":161.75},"gleisabschnittswuerfelPosition":135.5,"ersteKlasse":false},{"bezeichnung":"E","start":{"position":161.75},"ende":{"position":216.4},"gleisabschnittswuerfelPosition":188,"ersteKlasse":false},{"bezeichnung":"D","start":{"position":216.4},"ende":{"position":275.525},"gleisabschnittswuerfelPosition":244.8,"ersteKlasse":false},{"bezeichnung":"C","start":{"position":275.525},"ende":{"position":327.4},"gleisabschnittswuerfelPosition":306.25,"ersteKlasse":false},{"bezeichnung":"B","start":{"position":327.4},"ende":{"position":371.5},"gleisabschnittswuerfelPosition":348.55,"ersteKlasse":false},{"bezeichnung":"A","start":{"position":371.5},"ende":{"position":487},"gleisabschnittswuerfelPosition":394.45,"ersteKlasse":true}],"bezeichnung":"5"},"fahrzeuggruppen":[{"fahrzeuge":[{"fahrzeugtyp":{"fahrzeugkategorie":"POWERCAR","baureihe":"I4020","ersteKlasse":false,"zweiteKlasse":false},"status":"OPEN","orientierung":"FORWARDS","positionAmGleis":{"start":{"position":427.44},"ende":{"position":448},"sektor":"A"},"ausstattungsmerkmale":[]},{"fahrzeugtyp":{"fahrzeugkategorie":"PASSENGERCARRIAGE_FIRST_CLASS","baureihe":"Apmz","ersteKlasse":true,"zweiteKlasse":false},"status":"OPEN","orientierung":"BACKWARDS","positionAmGleis":{"start":{"position":401.04},"ende":{"position":427.44},"sektor":"A"},"ausstattungsmerkmale":[{"art":"SEATS_SEVERELY_DISABLED","status":"UNDEFINED"},{"art":"AIR_CONDITION","status":"UNDEFINED"},{"art":"ZONE_QUIET","status":"UNDEFINED"}],"ordnungsnummer":27},{"fahrzeugtyp":{"fahrzeugkategorie":"PASSENGERCARRIAGE_FIRST_CLASS","baureihe":"Apmz","ersteKlasse":true,"zweiteKlasse":false},"status":"OPEN","orientierung":"FORWARDS","positionAmGleis":{"start":{"position":374.64},"ende":{"position":401.04},"sektor":"A"},"ausstattungsmerkmale":[{"art":"SEATS_BAHN_COMFORT","status":"UNDEFINED"},{"art":"AIR_CONDITION","status":"UNDEFINED"}],"ordnungsnummer":26},{"fahrzeugtyp":{"fahrzeugkategorie":"DININGCAR","baureihe":"WRmbsz","ersteKlasse":false,"zweiteKlasse":false},"status":"OPEN","orientierung":"BACKWARDS","positionAmGleis":{"start":{"position":348.24},"ende":{"position":374.64},"sektor":"B"},"ausstattungsmerkmale":[{"art":"INFO","status":"UNDEFINED"},{"art":"TOILET_WHEELCHAIR","status":"UNDEFINED"},{"art":"WHEELCHAIR_SPACE","status":"AVAILABLE"}],"ordnungsnummer":25},{"fahrzeugtyp":{"fahrzeugkategorie":"PASSENGERCARRIAGE_ECONOMY_CLASS","baureihe":"Bpmbz","ersteKlasse":false,"zweiteKlasse":true},"status":"OPEN","orientierung":"BACKWARDS","positionAmGleis":{"start":{"position":321.84},"ende":{"position":348.24},"sektor":"B"},"ausstattungsmerkmale":[{"art":"SEATS_SEVERELY_DISABLED","status":"UNDEFINED"},{"art":"ZONE_FAMILY","status":"UNDEFINED"},{"art":"CABIN_INFANT","status":"UNDEFINED"},{"art":"AIR_CONDITION","status":"UNDEFINED"},{"art":"TOILET_WHEELCHAIR","status":"UNDEFINED"},{"art":"WHEELCHAIR_SPACE","status":"AVAILABLE"}],"ordnungsnummer":24},{"fahrzeugtyp":{"fahrzeugkategorie":"PASSENGERCARRIAGE_ECONOMY_CLASS","baureihe":"Bpmz","ersteKlasse":false,"zweiteKlasse":true},"status":"OPEN","orientierung":"BACKWARDS","positionAmGleis":{"start":{"position":295.44},"ende":{"position":321.84},"sektor":"C"},"ausstattungsmerkmale":[{"art":"SEATS_BAHN_COMFORT","status":"UNDEFINED"},{"art":"AIR_CONDITION","status":"UNDEFINED"}],"ordnungsnummer":23},{"fahrzeugtyp":{"fahrzeugkategorie":"PASSENGERCARRIAGE_ECONOMY_CLASS","baureihe":"Bpmz","ersteKlasse":false,"zweiteKlasse":true},"status":"OPEN","orientierung":"BACKWARDS","positionAmGleis":{"start":{"position":269.04},"ende":{"position":295.44},"sektor":"C"},"ausstattungsmerkmale":[{"art":"AIR_CONDITION","status":"UNDEFINED"},{"art":"ZONE_QUIET","status":"UNDEFINED"}],"ordnungsnummer":22},{"fahrzeugtyp":{"fahrzeugkategorie":"CONTROLCAR_ECONOMY_CLASS","baureihe":"Bpmzf","ersteKlasse":false,"zweiteKlasse":true},"status":"OPEN","orientierung":"FORWARDS","positionAmGleis":{"start":{"position":242.64},"ende":{"position":269.04},"sektor":"D"},"ausstattungsmerkmale":[{"art":"AIR_CONDITION","status":"UNDEFINED"}],"ordnungsnummer":21}],"fahrtreferenz":{"typ":"HIGH_SPEED_TRAIN","linie":"","ziel":{"bezeichnung":"Berlin Hbf"},"gattung":"ICE","fahrtnummer":947},"bezeichnung":"ICE0225"}],"fahrtrichtung":"RECHTS","gleisSoll":"4","gleisVorschau":"5"}

docs/dumps/PCAPdroid_16_Dec_20_18_17_reservierung.txt

@@ -1,17 +0,0 @@
-POST /mob/angebote/recon/autonomereservierung HTTP/1.1
-Accept: application/x.db.vendo.mob.verbindungssuche.v8+json
-X-Correlation-ID: b8d93b08-71ac-4cc2-836e-cd2683e34478_64466773-556f-4aa8-b128-0948c4d60887
-X-Device-Os-Name: Android
-X-Device-Os-Version: 32
-X-Device-Model: Google Pixel 3a
-X-App-Version: 24.32.2
-Accept-Language: en,de
-X-INSTANA-ANDROID: c88c72b9-3515-4acf-b052-3e71578c9461
-Content-Type: application/x.db.vendo.mob.verbindungssuche.v8+json
-Content-Length: 2276
-Host: app.vendo.noncd.db.de
-Connection: Keep-Alive
-Accept-Encoding: gzip
-User-Agent: okhttp/4.12.0
-
-{"einstiegsTypList":["STANDARD"],"klasse":"KLASSE_2","reisendenProfil":{"reisende":[{"ermaessigungen":["BAHNCARD25 KLASSE_2"],"reisendenTyp":"SENIOR"}]},"reservierungsKontingenteVorhanden":false,"verbindungHin":{"kontext":"¶HKI¶T$A\u003d1@O\u003dKöln Hbf@X\u003d6958730@Y\u003d50943029@L\u003d8000207@a\u003d128@$A\u003d1@O\u003dFrankfurt(Main)Hbf@X\u003d8663785@Y\u003d50107149@L\u003d8000105@a\u003d128@$202412162342$202412170220$IC 60403$$1$$$$$$§T$A\u003d1@O\u003dFrankfurt(Main)Hbf@X\u003d8663785@Y\u003d50107149@L\u003d8000105@a\u003d128@$A\u003d1@O\u003dErfurt Hbf@X\u003d11037989@Y\u003d50972352@L\u003d8010101@a\u003d128@$202412170249$202412170518$ICE  698$$1$$$$$$§T$A\u003d1@O\u003dErfurt Hbf@X\u003d11037989@Y\u003d50972352@L\u003d8010101@a\u003d128@$A\u003d1@O\u003dBerlin Hbf@X\u003d13369549@Y\u003d52525589@L\u003d8098160@a\u003d128@$202412170527$202412170729$ICE 1606$$1$$$$$$¶KC¶#VE#2#CF#100#CA#0#CM#0#SICT#0#AM#81#AM2#0#RT#7#¶KCC¶I1ZFIzEjRVJHIzQ1MzE1I0hJTiMwI0VDSyM1Mzk5OTV8NTM5OTgyfDU0MDQ0OXw1NDA0NDl8MHwwfDU2NXw1Mzk5NTN8M3wwfDh8MHwwfC0yMTQ3NDgzNjQ4I0dBTSMxNjEyMjQyMzQyIwpaI1ZOIzEjU1QjMTczNDAzMTcyNyNQSSMxI1pJIzE3MzU2MyNUQSMwI0RBIzE2MTIyNCMxUyM4NDAwMDU4IzFUIzIwMTUjTFMjODUwMzAwMCNMVCMxMDgwNSNQVSM4MSNSVCMxI0NBI0lDI1pFIzYwNDAzI1pCI0lDIDYwNDAzI1BDIzEjRlIjODAwMDIwNyNGVCMyMzQyI1RPIzgwMDAxMDUjVFQjMTAyMjAjClojVk4jMSNTVCMxNzM0MDMxNzI3I1BJIzEjWkkjMTc3MTQ3I1RBIzAjREEjMTYxMjI0IzFTIzgwMDAyNjEjMVQjMjE1MSNMUyM4MDk4MTYwI0xUIzEwNzU1I1BVIzgxI1JUIzEjQ0EjSUNFI1pFIzY5OCNaQiNJQ0UgIDY5OCNQQyMwI0ZSIzgwMDAxMDUjRlQjMTAyNDkjVE8jODAxMDEwMSNUVCMxMDUxOCMKWiNWTiMxI1NUIzE3MzQwMzE3MjcjUEkjMSNaSSMxNzQ1MzgjVEEjMCNEQSMxNzEyMjQjMVMjODAxMDEwMSMxVCM1MjcjTFMjODAwMjU1MyNMVCM5MzkjUFUjODEjUlQjMSNDQSNJQ0UjWkUjMTYwNiNaQiNJQ0UgMTYwNiNQQyMwI0ZSIzgwMTAxMDEjRlQjNTI3I1RPIzgwOTgxNjAjVFQjNzI5Iw\u003d\u003d¶KRCC¶#VE#1#¶SC¶1_H4sIAAAAAAACA32P7UrDMBiFb0Xyu443adM2hUDsyvBjaBEnivijrtms9GOm6bCUXod34g3sxkxbBoIi+ZNz3pPzvOnQXioUIDzzfGQh+aGNiMLZfTRjRiv5joIOlU2xQAG1hkuIArBQ1ego0dKECRAHE+yi0bzLisHEzKEAxtqMDafYQm9lu8i1WqLgqUO63Q2x+PYmMqGiSgd1cT03Yp/kzVgBxEb987jT/HU7FRtyKnfLaj3V5Flqkmccixt+dfjKy5Pzl4144C6jvmeDeOQUmGMDYWLFfSyW3AcAAp4IzZsdx57tgI094omMrw6fAD5g6lBfmEVqPX1wMW6RKPUnNpQqz45cbNsG7bABTMyh/g8wxtiFf8AuZS77Dd5KHVd5ayDG06qRo3VZNaqUbVg1ZVqjYJPk9TSIk7rOs1ofs3JdxYlKChPq+r7/Bvf6c1bwAQAA"}}

docs/dumps/PCAPdroid_16_Dec_20_36_36_departureswithnotices.txt

@@ -1,17 +0,0 @@
-POST /mob/bahnhofstafel/abfahrt HTTP/1.1
-Accept: application/x.db.vendo.mob.bahnhofstafeln.v2+json
-X-Correlation-ID: b8d93b08-71ac-4cc2-836e-cd2683e34478_64466773-556f-4aa8-b128-0948c4d60887
-X-Device-Os-Name: Android
-X-Device-Os-Version: 32
-X-Device-Model: Google Pixel 3a
-X-App-Version: 24.32.2
-Accept-Language: en,de
-X-INSTANA-ANDROID: 2b250673-6250-4bcd-8dc3-8cf83c0a7686
-Content-Type: application/x.db.vendo.mob.bahnhofstafeln.v2+json
-Content-Length: 376
-Host: app.vendo.noncd.db.de
-Connection: Keep-Alive
-Accept-Encoding: gzip
-User-Agent: okhttp/4.12.0
-
-{"anfragezeit":"20:35","datum":"2024-12-16","ursprungsBahnhofId":"A\u003d1@O\u003dKöln Hbf@X\u003d6958730@Y\u003d50943029@U\u003d81@L\u003d8000207@i\u003dU×008015458@","verkehrsmittel":["HOCHGESCHWINDIGKEITSZUEGE","INTERCITYUNDEUROCITYZUEGE","INTERREGIOUNDSCHNELLZUEGE","NAHVERKEHRSONSTIGEZUEGE","SBAHNEN","BUSSE","SCHIFFE","UBAHN","STRASSENBAHN","ANRUFPFLICHTIGEVERKEHRE"]}

docs/dumps/PCAPdroid_18_Dec_22_39_50_departures_ondemand.txt

@@ -1,17 +0,0 @@
-HTTP/1.1 200 OK
-Date: Wed, 18 Dec 2024 21:38:58 GMT
-Content-Type: application/x.db.vendo.mob.bahnhofstafeln.v2+json
-Content-Length: 590
-Connection: keep-alive
-server-timing: intid;desc=bf069d97495f8dad
-Server-Timing: intid;desc=bf069d97495f8dad
-Server-Timing: intid;desc=bf069d97495f8dad
-x-correlation-id: faddeefb-53f2-41a9-9879-e1c4edd7845f_5a24d491-8e2e-4cd8-85b5-ddd1d7d322c8
-Strict-Transport-Security: max-age=16070400; includeSubDomains
-X-XSS-Protection: 0
-server-timing: intid;desc=bf069d97495f8dad
-Content-Security-Policy: frame-ancestors 'none';
-X-Content-Type-Options: nosniff
-Set-Cookie: TS01be2125=01d513bcd1e76575d2a4e5c74d05675d588d2a35d6e7b8b0e5cad991641ebd4a05f4c1b051774f52d1a60eac0d3365250488a0be85; Path=/; Domain=.app.vendo.noncd.db.de; Secure; HTTPOnly
-
-{"bahnhofstafelAbfahrtPositionen":[{"zuglaufId":"2|#VN#1#ST#1734378327#PI#1#ZI#514236#TA#0#DA#181224#1S#541958#1T#1944#LS#548569#LT#2108#PU#81#RT#1#CA#rfb#ZE#8175#ZB#RUF 8175#PC#9#FR#541958#FT#1944#TO#548569#TT#2108#","kurztext":"RUF","mitteltext":"RUF 8175","abfrageOrt":{"name":"Penzing Ortsmitte, Aidenbach","locationId":"A=1@O=Penzing Ortsmitte, Aidenbach@X=13063430@Y=48562182@U=81@L=548572@","evaNr":"548572"},"richtung":"Köching Abzw. Haidenburg Wartehäuschen, Aidenbach","echtzeitNotizen":[],"abgangsDatum":"2024-12-18T21:03:00+01:00","produktGattung":"ANRUFPFLICHTIGEVERKEHRE"}]}

docs/dumps/PCAPdroid_18_Dec_22_42_29_departures_ferry.txt

@@ -1,17 +0,0 @@
-HTTP/1.1 200 OK
-Date: Wed, 18 Dec 2024 21:42:04 GMT
-Content-Type: application/x.db.vendo.mob.bahnhofstafeln.v2+json
-Content-Length: 2498
-Connection: keep-alive
-server-timing: intid;desc=4e6f4ce0b26b14cb
-Server-Timing: intid;desc=4e6f4ce0b26b14cb
-Server-Timing: intid;desc=4e6f4ce0b26b14cb
-x-correlation-id: faddeefb-53f2-41a9-9879-e1c4edd7845f_5a24d491-8e2e-4cd8-85b5-ddd1d7d322c8
-Strict-Transport-Security: max-age=16070400; includeSubDomains
-X-XSS-Protection: 0
-server-timing: intid;desc=4e6f4ce0b26b14cb
-Content-Security-Policy: frame-ancestors 'none';
-X-Content-Type-Options: nosniff
-Set-Cookie: TS01be2125=01d513bcd1b5c4411e233c8956b40fa37e9050070c341e1782b80282d570eb1ed0cb63a2fab4db66435d0bad351471a04f949cac0d; Path=/; Domain=.app.vendo.noncd.db.de; Secure; HTTPOnly
-
-{"bahnhofstafelAbfahrtPositionen":[{"zuglaufId":"2|#VN#1#ST#1734378327#PI#1#ZI#989203#TA#17#DA#181224#1S#368702#1T#930#LS#936350#LT#935#PU#81#RT#1#CA#FAE#ZE#FÄ1#ZB#Fähre   #PC#6#FR#368702#FT#930#TO#936350#TT#935#","kurztext":"Fähre","mitteltext":"Fähre","abfrageOrt":{"name":"Hohe Düne Fähre, Rostock","locationId":"A=1@O=Hohe Düne Fähre, Rostock@X=12097404@Y=54176710@U=81@L=368702@","evaNr":"368702"},"richtung":"Warnemünde","echtzeitNotizen":[],"abgangsDatum":"2024-12-18T09:30:00+01:00","produktGattung":"SCHIFF"},{"zuglaufId":"2|#VN#1#ST#1734378327#PI#1#ZI#417851#TA#1#DA#181224#1S#936250#1T#947#LS#939255#LT#1021#PU#81#RT#1#CA#Bus#ZE#18#ZB#Bus   18#PC#5#FR#936250#FT#947#TO#939255#TT#1021#","kurztext":"Bus","mitteltext":"Bus 18","abfrageOrt":{"name":"Hohe Düne Fähre, Rostock","locationId":"A=1@O=Hohe Düne Fähre, Rostock@X=12098627@Y=54176485@U=81@L=936250@","evaNr":"936250"},"richtung":"Dierkower Kreuz","echtzeitNotizen":[],"abgangsDatum":"2024-12-18T09:47:00+01:00","produktGattung":"BUS"},{"zuglaufId":"2|#VN#1#ST#1734378327#PI#1#ZI#989203#TA#18#DA#181224#1S#368702#1T#950#LS#936350#LT#955#PU#81#RT#1#CA#FAE#ZE#FÄ1#ZB#Fähre   #PC#6#FR#368702#FT#950#TO#936350#TT#955#","kurztext":"Fähre","mitteltext":"Fähre","abfrageOrt":{"name":"Hohe Düne Fähre, Rostock","locationId":"A=1@O=Hohe Düne Fähre, Rostock@X=12097404@Y=54176710@U=81@L=368702@","evaNr":"368702"},"richtung":"Warnemünde","echtzeitNotizen":[],"abgangsDatum":"2024-12-18T09:50:00+01:00","produktGattung":"SCHIFF"},{"zuglaufId":"2|#VN#1#ST#1734378327#PI#1#ZI#420342#TA#0#DA#181224#1S#936250#1T#1007#LS#842059#LT#1018#PU#81#RT#1#CA#Bus#ZE#17#ZB#Bus   17#PC#5#FR#936250#FT#1007#TO#842059#TT#1018#","kurztext":"Bus","mitteltext":"Bus 17","abfrageOrt":{"name":"Hohe Düne Fähre, Rostock","locationId":"A=1@O=Hohe Düne Fähre, Rostock@X=12098627@Y=54176485@U=81@L=936250@","evaNr":"936250"},"richtung":"Markgrafenheide Ost","echtzeitNotizen":[],"abgangsDatum":"2024-12-18T10:07:00+01:00","produktGattung":"BUS"},{"zuglaufId":"2|#VN#1#ST#1734378327#PI#1#ZI#989203#TA#19#DA#181224#1S#368702#1T#1010#LS#936350#LT#1015#PU#81#RT#1#CA#FAE#ZE#FÄ1#ZB#Fähre   #PC#6#FR#368702#FT#1010#TO#936350#TT#1015#","kurztext":"Fähre","mitteltext":"Fähre","abfrageOrt":{"name":"Hohe Düne Fähre, Rostock","locationId":"A=1@O=Hohe Düne Fähre, Rostock@X=12097404@Y=54176710@U=81@L=368702@","evaNr":"368702"},"richtung":"Warnemünde","echtzeitNotizen":[],"abgangsDatum":"2024-12-18T10:10:00+01:00","produktGattung":"SCHIFF"}]}

docs/dumps/PCAPdroid_18_Dec_22_43_54_departures_IR_flixtrain.txt

@@ -1,17 +0,0 @@
-HTTP/1.1 200 OK
-Date: Wed, 18 Dec 2024 21:43:02 GMT
-Content-Type: application/x.db.vendo.mob.bahnhofstafeln.v2+json
-Content-Length: 1030
-Connection: keep-alive
-server-timing: intid;desc=3007cc29ce998300
-Server-Timing: intid;desc=3007cc29ce998300
-Server-Timing: intid;desc=3007cc29ce998300
-x-correlation-id: faddeefb-53f2-41a9-9879-e1c4edd7845f_5a24d491-8e2e-4cd8-85b5-ddd1d7d322c8
-Strict-Transport-Security: max-age=16070400; includeSubDomains
-X-XSS-Protection: 0
-server-timing: intid;desc=3007cc29ce998300
-Content-Security-Policy: frame-ancestors 'none';
-X-Content-Type-Options: nosniff
-Set-Cookie: TS01be2125=01d513bcd1778d8a6954cb4376d998b52e8b4b9edfa2de0eed859c823593d6a880ffc23b5ab8f107642d7ccfb36b5be2d8c9d6632f; Path=/; Domain=.app.vendo.noncd.db.de; Secure; HTTPOnly
-
-{"bahnhofstafelAbfahrtPositionen":[{"gleis":"2","zuglaufId":"2|#VN#1#ST#1734378327#PI#1#ZI#338816#TA#0#DA#181224#1S#8000096#1T#712#LS#8100003#LT#1352#PU#81#RT#1#CA#DPF#ZE#963#ZB#WB   963#PC#2#FR#8000096#FT#712#TO#8100003#TT#1352#","kurztext":"WB","mitteltext":"WB 963","abfrageOrt":{"name":"Stuttgart Hbf","locationId":"A=1@O=Stuttgart Hbf@X=9181636@Y=48784081@U=81@L=8000096@i=U×008029034@","evaNr":"8000096","stationId":"6071"},"echtzeitNotizen":[],"abgangsDatum":"2024-12-18T07:12:00+01:00","produktGattung":"IR"},{"gleis":"8","zuglaufId":"2|#VN#1#ST#1734378327#PI#1#ZI#203510#TA#0#DA#181224#1S#8000096#1T#717#LS#8098160#LT#1315#PU#81#RT#1#CA#DPF#ZE#1240#ZB#FLX 1240#PC#2#FR#8000096#FT#717#TO#8098160#TT#1315#","kurztext":"FLX","mitteltext":"FLX 1240","abfrageOrt":{"name":"Stuttgart Hbf","locationId":"A=1@O=Stuttgart Hbf@X=9181636@Y=48784081@U=81@L=8000096@i=U×008029034@","evaNr":"8000096","stationId":"6071"},"richtung":"Berlin Hbf","echtzeitNotizen":[],"abgangsDatum":"2024-12-18T07:17:00+01:00","produktGattung":"IR"}]}

docs/dumps/PCAPdroid_18_Dec_23_19_54_locsearch_addr.txt

@@ -1,17 +0,0 @@
-POST /mob/location/search HTTP/1.1
-Accept: application/x.db.vendo.mob.location.v3+json
-X-Correlation-ID: 0079a47f-6208-4507-9d9a-0e02802ef52c_5a24d491-8e2e-4cd8-85b5-ddd1d7d322c8
-X-Device-Os-Name: Android
-X-Device-Os-Version: 32
-X-Device-Model: Google Pixel 3a
-X-App-Version: 24.32.2
-Accept-Language: en,de
-X-INSTANA-ANDROID: 205f5fd7-f96a-4e07-a47d-bb3edb8c443e
-Content-Type: application/x.db.vendo.mob.location.v3+json
-Content-Length: 52
-Host: app.vendo.noncd.db.de
-Connection: Keep-Alive
-Accept-Encoding: gzip
-User-Agent: okhttp/4.12.0
-
-{"locationTypes":["ALL"],"searchTerm":"schillerstr"}

docs/dumps/PCAPdroid_18_Dec_23_19_57_locsearch_addr.txt

@@ -1,17 +0,0 @@
-HTTP/1.1 200 OK
-Date: Wed, 18 Dec 2024 22:19:20 GMT
-Content-Type: application/x.db.vendo.mob.location.v3+json
-Content-Length: 2877
-Connection: keep-alive
-server-timing: intid;desc=8a52db25dd785bfe
-Server-Timing: intid;desc=8a52db25dd785bfe
-Server-Timing: intid;desc=8a52db25dd785bfe
-x-correlation-id: 0079a47f-6208-4507-9d9a-0e02802ef52c_5a24d491-8e2e-4cd8-85b5-ddd1d7d322c8
-Strict-Transport-Security: max-age=16070400; includeSubDomains
-X-XSS-Protection: 0
-server-timing: intid;desc=8a52db25dd785bfe
-Content-Security-Policy: frame-ancestors 'none';
-X-Content-Type-Options: nosniff
-Set-Cookie: TS01be2125=01d513bcd1de3bcb4b755a3859cad31611f802372756db9780547d536b115fb805b4cb7fe4f2aefad293244318a0660f18cf234872; Path=/; Domain=.app.vendo.noncd.db.de; Secure; HTTPOnly
-
-[{"name":"Schillerstr., Ofterdingen","locationId":"A=1@O=Schillerstr., Ofterdingen@X=9030635@Y=48420917@U=81@L=750308@B=1@p=1734378327@","evaNr":"750308","coordinates":{"latitude":48.420918,"longitude":9.030635},"weight":995,"products":["BUSSE","ANRUFPFLICHTIGEVERKEHRE"],"locationType":"ST"},{"name":"Schillerstr., Lutherstadt Wittenberg","locationId":"A=1@O=Schillerstr., Lutherstadt Wittenberg@X=12660057@Y=51875984@U=81@L=963037@B=1@p=1734378327@","evaNr":"963037","coordinates":{"latitude":51.875984,"longitude":12.660057},"weight":943,"products":["BUSSE","ANRUFPFLICHTIGEVERKEHRE"],"locationType":"ST"},{"name":"Schillerstr., Geithain","locationId":"A=1@O=Schillerstr., Geithain@X=12691420@Y=51058568@U=81@L=200268@B=1@p=1734378327@","evaNr":"200268","coordinates":{"latitude":51.058567,"longitude":12.69142},"weight":941,"products":["BUSSE"],"locationType":"ST"},{"name":"Schillerstr., Zwickau","locationId":"A=1@O=Schillerstr., Zwickau@X=12493001@Y=50715018@U=81@L=983776@B=1@p=1734378327@","evaNr":"983776","coordinates":{"latitude":50.71502,"longitude":12.493001},"weight":941,"products":["NAHVERKEHRSONSTIGEZUEGE","BUSSE","STRASSENBAHN","ANRUFPFLICHTIGEVERKEHRE"],"locationType":"ST"},{"name":"Schillerstr., Überherrn","locationId":"A=1@O=Schillerstr., Überherrn@X=6705494@Y=49239322@U=81@L=835123@B=1@p=1734378327@","evaNr":"835123","coordinates":{"latitude":49.239323,"longitude":6.705494},"weight":941,"products":["BUSSE"],"locationType":"ST"},{"name":"Schillerstr./Forstweg, Brieselang","locationId":"A=1@O=Schillerstr./Forstweg, Brieselang@X=12988073@Y=52583830@U=81@L=734788@B=1@p=1734378327@","evaNr":"734788","coordinates":{"latitude":52.58383,"longitude":12.988073},"weight":941,"products":["BUSSE"],"locationType":"ST"},{"name":"Schillerstr., Berlin","locationId":"A=1@O=Schillerstr., Berlin@X=13410584@Y=52591948@U=81@L=732759@B=1@p=1734378327@","evaNr":"732759","coordinates":{"latitude":52.59195,"longitude":13.410584},"weight":412,"products":["STRASSENBAHN"],"locationType":"ST"},{"name":"Schillerstr., Schöneiche b. Berlin","locationId":"A=1@O=Schillerstr., Schöneiche b. Berlin@X=13709386@Y=52476958@U=81@L=738128@B=1@p=1734378327@","evaNr":"738128","coordinates":{"latitude":52.47696,"longitude":13.709386},"weight":412,"products":["STRASSENBAHN"],"locationType":"ST"},{"name":"Schillerstr., Markdorf","locationId":"A=1@O=Schillerstr., Markdorf@X=9386033@Y=47727336@U=81@L=801101@B=1@p=1734378327@","evaNr":"801101","coordinates":{"latitude":47.727337,"longitude":9.386033},"weight":272,"products":["BUSSE","ANRUFPFLICHTIGEVERKEHRE"],"locationType":"ST"},{"name":"Schillerstr., Salzwedel","locationId":"A=1@O=Schillerstr., Salzwedel@X=11160072@Y=52850918@U=81@L=957938@B=1@p=1734378327@","evaNr":"957938","coordinates":{"latitude":52.850918,"longitude":11.160072},"weight":272,"products":["BUSSE","ANRUFPFLICHTIGEVERKEHRE"],"locationType":"ST"}]

docs/dumps/PCAPdroid_18_Dec_23_20_05_routesearch_fromaddr.txt

@@ -1,18 +0,0 @@
-POST /mob/angebote/fahrplan HTTP/1.1
-Accept: application/x.db.vendo.mob.verbindungssuche.v8+json
-x-feature-reiseketten-enabled: false
-X-Correlation-ID: 84f2ab9b-d4a7-4e98-9a29-113783f0d431_5a24d491-8e2e-4cd8-85b5-ddd1d7d322c8
-X-Device-Os-Name: Android
-X-Device-Os-Version: 32
-X-Device-Model: Google Pixel 3a
-X-App-Version: 24.32.2
-Accept-Language: en,de
-X-INSTANA-ANDROID: a33cf0fb-5fd8-4c2f-befa-d4c1963cf3b7
-Content-Type: application/x.db.vendo.mob.verbindungssuche.v8+json
-Content-Length: 686
-Host: app.vendo.noncd.db.de
-Connection: Keep-Alive
-Accept-Encoding: gzip
-User-Agent: okhttp/4.12.0
-
-{"autonomeReservierung":false,"einstiegsTypList":["STANDARD"],"klasse":"KLASSE_2","reiseHin":{"wunsch":{"abgangsLocationId":"A\u003d2@O\u003dBerlin - Bohnsdorf, Schillerstraße 10@H\u003d10@X\u003d13585128@Y\u003d52398257@U\u003d92@L\u003d980126874@B\u003d1@p\u003d1706613073@","verkehrsmittel":["ALL"],"zeitWunsch":{"reiseDatum":"2024-12-18T22:38:09.928078+01:00","zeitPunktArt":"ABFAHRT"},"zielLocationId":"A\u003d1@O\u003dBerlin Hbf@X\u003d13369549@Y\u003d52525589@U\u003d81@L\u003d8011160@B\u003d1@p\u003d1734031727@i\u003dU×008065969@"}},"reisendenProfil":{"reisende":[{"ermaessigungen":["BAHNCARD25 KLASSE_2"],"reisendenTyp":"SENIOR"}]},"reservierungsKontingenteVorhanden":false}

docs/dumps/readme.md

@@ -1,15 +0,0 @@
-# Dumps from DB Navigator API app.vendo.noncd.db.de
-
-In this directory, some intercepted traffic from DB Navigator. (Repo license does not apply to this directory.)
-
-You can browse some responses of the bahn.de API and others in the [fixtures](https://github.com/public-transport/db-vendo-client/tree/main/test/fixtures) and [e2e fixtures](https://github.com/public-transport/db-vendo-client/tree/main/test/e2e/fixtures).
-
-How to intercept DB Navigator traffic:
-
-1. Download/extract Split APK
-2. Merge APK (e.g. using [APKEditor](https://github.com/REAndroid/APKEditor))
-3. decompile using apktool
-4. edit [res/xml/network_security_config.xml](https://developer.android.com/privacy-and-security/security-config) to allow user CAs not just in debug 
-5. recompile using apktool, sign
-6. install on an Android
-7. intercept with a mitm decryption tool of your choice by installing CA cert into Android store (e.g. [PCAPdroid](https://github.com/emanuele-f/PCAPdroid) with [mitm addon](https://github.com/emanuele-f/PCAPdroid-mitm), no root needed)

docs/hafas-mgate-api.md

@@ -0,0 +1,160 @@
+# HAFAS `mgate.exe` protocol
+
+The protocol of `mgate.exe` HAFAS endpoints is not openly (and freely) documented. The following documentation is based on general observations and reverse-engineering.
+
+*Note:* There are also `rest.exe` (a.k.a. "open API", a.k.a. "REST API") endpoints. This documentation is *not* about them.
+
+## date & time format
+
+Dates are encoded as `YYYYMMDD`, time strings as `HHMMSS`. These are in the timezone configured on the HAFAS/server side, *per endpoint*.
+
+Whenever HAFAS returns a time string that exceeds the day the response describes, it will add a "day offset". As an example, when you query departures at `2019-12-12T23:50+01:00` for the next 30 minutes, it will encode the departure at `2019-12-13T00:13+01:00` as `20191212` & `01001300`.
+
+For working code, check out [`parseDateTime()`](../parse/date-time.js).
+
+## coordinate format
+
+All endpoints I've seen so far use [WGS84](http://wiki.gis.com/wiki/index.php/WGS84). Values are multiplied by `10^6` though, so you would encode `{latitude: 1.23, longitude: -2.34}` as `{Y: 1230000: X: -2340000}`. There's an optional parameter `z` with the elevation.
+
+For working code, check out [`formatAddress()`](../format/address.js).
+
+## querying the API
+
+In many aspects, the API looks and feels like [RPCs](https://en.wikipedia.org/wiki/Remote_procedure_call). You must send queries via HTTP `POST`, with the minimal JSON body looking like this:
+
+```js
+{
+	"auth": {
+		"type": "AID",
+		"aid": "…" // endpoint-specific authentication token, e.g. `1Rxs112shyHLatUX4fofnmdxK`
+	},
+	"ver": "…", // endpoint-specific string, e.g. `1.15`
+	"ext": "…", // endpoint-specific string, e.g. `BVG.1`
+	"client": {
+		"type": "IPA", // might also be `IPH` for "iPhone" or `WEB` for "web client"
+		"id": "…", // endpoint-specific string, e.g. `BVG`
+		"name": "…", // endpoint-specific string, e.g. `FahrInfo`
+		"v": "…" // endpoint-specific string, e.g. `4070700`
+	},
+	"lang": "…", // language, sometimes 2-digit (e.g. `de`), sometimes 3-digit (e.g. `deu`)
+	"svcReqL": [
+		{
+			"meth": "…", // name of the API call, supported values depend on the endpoint
+			"req": {
+				// actual request parameters…
+			}
+			// some endpoints also require this:
+			"cfg": {
+				"cfgGrpL": [],
+				"cfgHash": "…" // endpoint-specific string
+			}
+		}
+	]
+}
+```
+
+- The data in `client` must be correct, otherwise HAFAS will reject your request.
+- HAFAS will return slightly different response formats (and slightly different levels of detail) for different `ver`, `ext` and `client.v` values.
+- All endpoints known support JSON & UTF-8, so make sure to send `Accept: application/json` & `Accept-Charset: utf-8` headers.
+- Most endpoints support at least GZIP compression, so make sure to send a `Accept-Encoding: gzip` header.
+
+For working code, check out [`request()`](lib/request.js).
+
+## Authentication
+
+There are three known types of authentication used among `mgate.exe` endpoints.
+
+For working code, check out [`hafas-client`'s `request()`](lib/request.js), [`public-transport-enabler`'s Java implementation](https://github.com/schildbach/public-transport-enabler/blob/69614c87af627e2feafc576882f2ccccdbf4b7e6/src/de/schildbach/pte/AbstractHafasClientInterfaceProvider.java#L845-L860), [`TripKit`'s Swift implementation](https://github.com/alexander-albers/tripkit/blob/724b6cd8c258c9c61e7443c81e914618b79393cb/TripKit/AbstractHafasClientInterfaceProvider.swift#L1473-L1495) or [`marudor.de`'s TypeScript implementation](https://github.com/marudor/BahnhofsAbfahrten/blob/cf64d53c6902981ec529d3952253b2c83bff9221/src/server/HAFAS/profiles.ts#L30-L54).
+
+### unprotected endpoints
+
+You can just query these, as long as you send a formally correct request.
+
+### endpoints using the `checksum` query parameter
+
+`checksum` is a [message authentication code](https://en.wikipedia.org/wiki/Message_authentication_code): You can compute it by [hashing](https://en.wikipedia.org/wiki/Hash_function) the request body and a secret *salt*.
+
+This secret can be read from the config file inside the accompanying client app. There is no guide for this yet, so please [open an issue](https://github.com/public-transport/hafas-client/issues/new).
+
+### endpoints using the `mic` & `mac` query parameters
+
+`mic` is a [message integrity code](https://en.wikipedia.org/wiki/Message_authentication_code), the [hash](https://en.wikipedia.org/wiki/Hash_function) of the request body.
+
+`mac` is a [message authentication code](https://en.wikipedia.org/wiki/Message_authentication_code), the hash of `mic` and a secret *salt*.
+
+This secret can be read from the config file inside the accompanying client app. There is no guide for this yet, so please [open an issue](https://github.com/public-transport/hafas-client/issues/new).
+
+## API responses
+
+A minimal valid response looks like this:
+
+```js
+{
+	"ver": "…", // endpoint-specific string, e.g. `1.15`
+	"lang": "…", // language
+	"ext": "…", // endpoint-specific string, e.g. `BVG.1`
+	"id": "…", // unique ID for each response?
+	"svcResL": [
+		{
+			"meth": "StationBoard",
+			"err": "OK",
+			"res": {
+				// result of the API call
+			}
+		}
+	]
+}
+```
+
+For working code, check out [`request()`](lib/request.js).
+
+### parse error
+
+todo: generic server error
+
+```js
+{
+	"ver": "…", // endpoint-specific string, e.g. `1.15`
+	"lang": "…", // language, sometimes 2-digit (e.g. `de`), sometimes 3-digit (e.g. `deu`)
+	"err": "PARSE", // error code
+	"errTxt": "…", // error message, not always present
+	"svcResL": []
+}
+```
+
+### authentication error
+
+```js
+{
+	"ver": "…", // endpoint-specific string, e.g. `1.15`
+	"lang": "…", // language
+	"ext": "…", // endpoint-specific string, e.g. `BVG.1`
+	"err": "AUTH", // error code
+	"errTxt": "…", // error message, not always present
+	"svcResL": []
+}
+```
+
+### API-call-specific error
+
+```js
+{
+	"ver": "…", // endpoint-specific string, e.g. `1.15`
+	"lang": "…", // language
+	"ext": "…", // endpoint-specific string, e.g. `BVG.1`
+	"svcResL": [
+		{
+			"meth": "StationBoard",
+			"err": "…", // error code, e.g. `H9300`
+			"errTxt": "…", // error message, e.g. `Unknown arrival station`
+			"res": {}
+		}
+	]
+}
+```
+
+## more ressources
+
+- [@Nakaner's `strecken.info` API docs](https://github.com/Nakaner/bahnstoerungen/tree/62a72b1e0f0255668500b438187ff65aef39242a/api-doc/db-strecken-info)
+- [unfinished HAFAS glossary](https://gist.github.com/derhuerst/74b703e2a0fc64e4a0fa8fbb1f3a61b4)
+- [various `mgate.exe` HTTP traffic recordings](https://gist.github.com/search?q=post+mgate.exe&ref=searchresults)

docs/journeys-from-trip.md

@@ -0,0 +1,51 @@
+# `journeysFromTrip(tripId, previousStopover, to, [opt])`
+
+`to` must be an [*Friendly Public Transport Format* (FPTF) `stop`](https://github.com/public-transport/friendly-public-transport-format/blob/3bd36faa721e85d9f5ca58fb0f38cdbedb87bbca/spec/readme.md#stop) or [`station`](https://github.com/public-transport/friendly-public-transport-format/blob/3bd36faa721e85d9f5ca58fb0f38cdbedb87bbca/spec/readme.md#station). See [`journeys()`](journeys.md) for details.
+
+With `opt`, you can override the default options, which look like this:
+
+```js
+{
+	accessibility: 'none', // 'none', 'partial' or 'complete'
+	stopovers: false, // return stations on the way?
+	polylines: false, // return leg shapes?
+	transferTime: 0, // minimum time for a single transfer in minutes
+	tickets: false, // return tickets?
+	remarks: true // parse & expose hints & warnings?
+}
+```
+
+## Response
+
+*Note:* The returned `departure` and `arrival` times include the current delay. The `departureDelay`/`arrivalDelay` fields express how much they differ from `plannedDeparture`/`plannedArrival`, respectively.
+
+As an example, we're going to use the [*Deutsche Bahn* profile](../p/db):
+
+```js
+import {createClient} from 'hafas-client'
+import {profile as dbProfile} from 'hafas-client/p/db/index.js'
+
+const userAgent = 'link-to-your-project-or-email' // adapt this to your project!
+const client = createClient(dbProfile, userAgent)
+
+const berlinSüdkreuz = '8011113'
+const münchenHbf = '8000261'
+const kölnHbf = '8000207'
+
+// find any journey from Berlin Südkreuz to München Hbf
+const [journey] = await client.journeys(berlinSüdkreuz, münchenHbf, {results: 1, stopovers: true})
+// find the ICE leg
+const leg = journey.legs.find(l => l.line.product === 'nationalExpress')
+// find the stopover at the stop you've just passed
+const previousStopover = leg.stopovers.find(st => st.departure && new Date(st.departure) < Date.now())
+
+// find journeys from the ICE train to Köln Hbf
+const {
+	journeys,
+	realtimeDataUpdatedAt,
+} = await client.journeysFromTrip(leg.id, previousStopover, kölnHbf)
+```
+
+`journeys` is an array of [FPTF `journey`s](https://github.com/public-transport/friendly-public-transport-format/blob/3bd36faa721e85d9f5ca58fb0f38cdbedb87bbca/spec/readme.md#journey), as documented in [`journeys()`](journeys.md).
+
+`realtimeDataUpdatedAt` is a UNIX timestamp reflecting the latest moment when (at least some of) the response's realtime data have been updated.

docs/journeys.md

@@ -53,11 +53,11 @@ With `opt`, you can override the default options, which look like this:
 	stopovers: false, // return stations on the way?
 	transfers: -1, // Maximum nr of transfers. Default: Let HAFAS decide.
 	transferTime: 0, // minimum time for a single transfer in minutes
-	accessibility: 'none', // not supported
+	accessibility: 'none', // 'none', 'partial' or 'complete'
 	bike: false, // only bike-friendly journeys
-	walkingSpeed: 'normal', // not supported
+	walkingSpeed: 'normal', // 'slow', 'normal', 'fast'
 	// Consider walking to nearby stations at the beginning of a journey?
-	startWithWalking: true, // always true (?)
+	startWithWalking: true,
 	products: {
 		// these entries may vary from profile to profile
 		suburban: true,
@@ -65,21 +65,15 @@ With `opt`, you can override the default options, which look like this:
 		tram: true,
 		bus: true,
 		ferry: true,
-		nationalExpress: true,
+		express: true,
-		national: true,
 		regional: true
-		regionalExpress: true // this is actually FlixTrain and co.
 	},
-	tickets: false, // return tickets? only available for [refreshJourney](refresh-journey.md)
+	tickets: false, // return tickets? only available with some profiles
-	polylines: false, // return a shape for each leg? only available for [refreshJourney](refresh-journey.md)
+	polylines: false, // return a shape for each leg?
-	subStops: true, // not supported
+	subStops: true, // parse & expose sub-stops of stations?
-	entrances: true, // not supported
+	entrances: true, // parse & expose entrances of stops/stations?
 	remarks: true, // parse & expose hints & warnings?
-	scheduledDays: false, // returns a field `serviceDays` (instead of `scheduledDays` in hafas-client!) with a different, human-readable structure
+	scheduledDays: false, // parse which days each journey is valid on
-	notOnlyFastRoutes: false, // if true, also show journeys that are mathematically non-optimal
-	bestprice: false, // search for lowest prices across the entire day, returns list of journeys sorted by price
-	firstClass: false, // first or second class for tickets
-	loyaltyCard: null, // BahnCards etc., see below
 	language: 'en', // language to get results in
 }
 ```
@@ -88,16 +82,17 @@ With `opt`, you can override the default options, which look like this:
 
 *Note:* As stated in the [*Friendly Public Transport Format* v2 draft spec](https://github.com/public-transport/friendly-public-transport-format/blob/3bd36faa721e85d9f5ca58fb0f38cdbedb87bbca/spec/readme.md), the returned `departure` and `arrival` times include the current delay. The `departureDelay`/`arrivalDelay` fields express how much they differ from the schedule.
 
+As an example, we're going to use the [VBB profile](../p/vbb):
 
 ```js
-import {createClient} 'db-vendo-client'
+import {createClient} 'hafas-client'
-import {profile as dbProfile} from 'db-vendo-client/p/db/index.js'
+import {profile as vbbProfile} from 'hafas-client/p/vbb/index.js'
 
 const userAgent = 'link-to-your-project-or-email' // adapt this to your project!
-const client = createClient(dbProfile, userAgent)
+const client = createClient(vbbProfile, userAgent)
 
-// Frankfurt to Stuttgart
+// Hauptbahnhof to Heinrich-Heine-Str.
-await client.journeys('8000105', '8000096', {
+await client.journeys('900000003201', '900000100008', {
 	results: 1,
 	stopovers: true
 })
@@ -106,7 +101,7 @@ await client.journeys('8000105', '8000096', {
 `journeys()` will resolve with an object with the following fields:
 - `journeys`
 - `earlierRef`/`laterRef` – pass them as `opt.earlierThan`/`opt.laterThan` into another `journeys()` call to retrieve the next "page" of journeys
-- `realtimeDataUpdatedAt` – is currently not set in db-vendo-client, because the upstream APIs don't provide it.
+- `realtimeDataUpdatedAt` – a UNIX timestamp reflecting the latest moment when (at least some of) the response's realtime data have been updated
 
 This object might look like this:
 
@@ -281,6 +276,44 @@ This object might look like this:
 	realtimeDataUpdatedAt: 1531259400, // 2018-07-10T23:50:00+02
 }
 ```
+
+Some [profiles](../p) are able to parse the ticket information, if returned by the API. For example, if you pass `tickets: true` with the [VBB profile](../p/vbb), each `journey` will have a tickets array that looks like this:
+
+```js
+[ {
+	name: 'Berlin Tarifgebiet A-B: Einzelfahrausweis – Regeltarif',
+	price: 2.8,
+	tariff: 'Berlin',
+	coverage: 'AB',
+	variant: 'adult',
+	amount: 1
+}, {
+	name: 'Berlin Tarifgebiet A-B: Einzelfahrausweis – Ermäßigungstarif',
+	price: 1.7,
+	tariff: 'Berlin',
+	coverage: 'AB',
+	variant: 'reduced',
+	amount: 1,
+	reduced: true
+}, /* … */ {
+	name: 'Berlin Tarifgebiet A-B: Tageskarte – Ermäßigungstarif',
+	price: 4.7,
+	tariff: 'Berlin',
+	coverage: 'AB',
+	variant: '1 day, reduced',
+	amount: 1,
+	reduced: true,
+	fullDay: true
+}, /* … */ {
+	name: 'Berlin Tarifgebiet A-B: 4-Fahrten-Karte – Regeltarif',
+	price: 9,
+	tariff: 'Berlin',
+	coverage: 'AB',
+	variant: '4x adult',
+	amount: 4
+} ]
+```
+
 If a journey leg has been cancelled, a `cancelled: true` will be added. Also, `departure`/`departureDelay`/`departurePlatform` and `arrival`/`arrivalDelay`/`arrivalPlatform` will be `null`.
 
 To get more journeys earlier/later than the current set of results, pass `earlierRef`/`laterRef` into `opt.earlierThan`/`opt.laterThan`. For example, query *later* journeys as follows:
@@ -306,16 +339,19 @@ departure of last journey 2017-12-17T19:07:00+01:00
 departure of first (later) journey 2017-12-17T19:19:00+01:00
 ```
 
-## Using the `loyaltyCard` option
+If you pass `polylines: true`, each journey leg will have a `polyline` field. Refer to [the section in the `trip()` docs](trip.md#polyline-option) for details.
+
+If you pass `scheduledDays: true`, each journey will have a `scheduledDays` object looking like this:
 
 ```js
-import {data as loyaltyCards} from 'db-vendo-client/format/loyalty-cards.js' // see there for a list
+{
-
+	'2018-01-01': true,
-hafas.journeys(from, to, {
+	'2018-01-02': false,
-	loyaltyCard: {type: data.BAHNCARD, discount: 25}
+	// …
-})
+	'2018-10-12': true,
+	'2018-10-13': true,
+	// …
+	'2019-01-02': false,
+	'2019-01-03': false
+}
 ```
-
-## The `routingMode` option
-
-The `routingMode` option is not supported by db-vendo-client. The behavior will be the same as the [`HYBRID` mode of hafas-client](https://github.com/public-transport/hafas-client/blob/main/p/db/readme.md#using-the-routingmode-option), i.e. cancelled trains/infeasible journeys will also be contained for informational purpose.

docs/lines.md

@@ -0,0 +1,70 @@
+# `lines([opt])`
+
+**Fetches all lines known to the HAFAS endpoint**, e.g. warnings about disruptions, planned construction work, and general notices about the operating situation.
+
+## Example
+
+As an example, we're going to use the [SVV profile](../p/svv):
+
+```js
+import {createClient} from 'hafas-client'
+import {profile as svvProfile} from 'hafas-client/p/svv/index.js'
+
+const userAgent = 'link-to-your-project-or-email' // adapt this to your project!
+const client = createClient(svvProfile, userAgent)
+
+const {
+	lines,
+	realtimeDataUpdatedAt,
+} = await client.lines('S1')
+```
+
+`realtimeDataUpdatedAt` is a UNIX timestamp reflecting the latest moment when (at least some of) the response's realtime data have been updated.
+
+`lines` may look like this:
+
+```js
+[
+	{
+		"id": "obb-1-S1-V-j20-1",
+		"type": "line",
+		"name": "S1",
+		"public": true,
+		"mode": "train",
+		"product": "bahn-s-bahn",
+		"operator": {
+			"type": "operator",
+			"id": "montafonerbahn-ag",
+			"name": "Montafonerbahn AG"
+		},
+		"directions": [
+			"Bludenz Bahnhof",
+			"Bregenz Hafen Bahnhof",
+			"Lindau Hbf",
+			"Bregenz Bahnhof",
+			"Schruns Bahnhof",
+			"Lochau Bahnhof"
+		],
+	},
+	// …
+	{
+		"id": "svv-42-50-j20-2",
+		"type": "line",
+		"name": "S1",
+		"public": true,
+		"mode": "train",
+		"product": "bahn-s-bahn",
+		"operator": {
+			"type": "operator",
+			"id": "salzburg-ag-salzburger-lokalbahn",
+			"name": "Salzburg AG - Salzburger Lokalbahn"
+		},
+		"directions": [
+			"Lamprechtshausen Bahnhof",
+			"Salzburg Hauptbahnhof",
+			"Acharting S-Bahn",
+			"Weitwörth-Nussdorf Bahnhof"
+		],
+	},
+]
+```

docs/locations.md

@@ -6,27 +6,28 @@ With `opt`, you can override the default options, which look like this:
 
 ```js
 {
-	  fuzzy:     true // not supported
+	  fuzzy:     true // find only exact matches?
 	, results:   5 // how many search results?
 	, stops:     true // return stops/stations?
 	, addresses: true
 	, poi:       true // points of interest
-	, subStops: true // not supported
+	, subStops: true // parse & expose sub-stops of stations?
-	, entrances: true // not supported
+	, entrances: true // parse & expose entrances of stops/stations?
-	, linesOfStops: false // not supported
+	, linesOfStops: false // parse & expose lines at each stop/station?
 	, language: 'en' // language to get results in
 }
 ```
 
 ## Response
 
+As an example, we're going to use the [VBB profile](../p/vbb):
 
 ```js
-import {createClient} from 'db-vendo-client'
+import {createClient} from 'hafas-client'
-import {profile as dbnavProfile} from 'db-vendo-client/p/dbnav/index.js'
+import {profile as vbbProfile} from 'hafas-client/p/vbb/index.js'
 
 const userAgent = 'link-to-your-project-or-email' // adapt this to your project!
-const client = createClient(dbnavProfile, userAgent)
+const client = createClient(vbbProfile, userAgent)
 
 await client.locations('Alexanderplatz', {results: 3})
 ```

docs/migrating-to-5.md

@@ -0,0 +1,108 @@
+# Migrating to `hafas-client@5`
+
+## If you use Node `8` ("Carbon")…
+
+…migrate to Node `10` ("Dubnium"), sorry. [Node `8` is out of maintenance now](https://nodejs.org/en/about/releases/). 83f43c6
+
+## new fields for departure/arrival time & delays
+
+An arrival/departure now looks like this:
+
+```js
+{
+  when: null, // realtime/prognosed
+  plannedWhen: '2019-10-10T10:10+10:00',
+  platform: '3', // realtime/prognosed
+  plannedPlatform: '4'
+}
+```
+
+A stopover/journey leg now will look like this:
+
+```js
+{
+  arrival: null, // realtime/prognosed
+  plannedArrival: '2019-10-10T10:10+10:00',
+  arrivalDelay: null,
+  arrivalPlatform: '3', // realtime/prognosed
+  plannedArrivalPlatform: '4',
+
+  departure: '2019-10-10T10:12+10:00', // realtime/prognosed
+  plannedDeparture: '2019-10-10T10:10+10:00',
+  departureDelay: 120, // seconds
+  departurePlatform: null, // realtime/prognosed
+  plannedDeparturePlatform: null
+}
+```
+
+If the same stopover/journey leg is `cancelled: true`, it will look like this:
+
+```js
+{
+  arrival: null,
+  prognosedArrival: null,
+  plannedArrival: '2019-10-10T10:10+10:00',
+  arrivalDelay: null,
+  arrivalPlatform: null,
+  prognosedArrivalPlatform: '3',
+  plannedArrivalPlatform: '4',
+
+  departure: null,
+  prognosedDeparture: '2019-10-10T10:12+10:00',
+  plannedDeparture: '2019-10-10T10:10+10:00',
+  departureDelay: 120, // seconds
+  departurePlatform: null,
+  prognosedDeparturePlatform: null,
+  plannedDeparturePlatform: null
+}
+```
+
+## If you use `journeys()`…
+
+…with the `walkingSpeed` option and a custom profile, add `journeysWalkingSpeed` to your profile. 937583e
+…without the `results` option, but *expect* a certain number of results, you must pass `results` now. 0045587
+
+## If you use `departures()`/`arrivals()` with the [BVG profile](../p/bvg)…
+
+With the latest protocol version, the BVG endpoint doesn't support these options anymore:
+
+- `stopovers` – Fetch & parse previous/next stopovers? Default: `false`
+- `includeRelatedStations` – Fepartures at related stations, e.g. those that belong together on the metro map? Default: `true`
+
+2d72391
+
+## If you use a custom profile…
+
+Let's assume you have parse function looking like this:
+
+```js
+const createParseLine = (profile, opt, data) => (rawLine) => {
+	const operator = data.operators[rawLine.oprX] || null
+	if (operator && operator.name === 'foo') {
+		return {
+			type: 'line',
+			name: 'really special tram line',
+			mode: 'tram',
+			product: 'special-tram',
+			operator
+		}
+	}
+	return defaultParseLine(rawLine)
+}
+```
+
+Adapt your parse function like this:
+
+```diff
+const createParseLine = (profile, opt, _) => (rawLine) => {
+-	const operator = data.operators[rawLine.oprX] || null
++	const operator = rawLine.operator || null
+```
+
+See also [`#127`](https://github.com/public-transport/hafas-client/pull/127).
+
+If you use `icons` in `parseWarning`/`parseHint`, adapt the function(s) to take an object `data` as the first argument. You can access the list of *parsed* icons via `data.icons`, *parsed* warnings via `data.warnings`, etc. a229205 b36f0e3
+
+## Other breaking changes
+
+- `journey.price` will be `null` if there's no pricing data returned by the endpoint, instead of `{amount: null}`. 8fe277d

docs/migrating-to-6.md

@@ -0,0 +1,93 @@
+# Migrating to `hafas-client@6`
+
+## If you use Node.js <16 …
+
+… migrate to Node `16` ("Gallium"), sorry. [Node `10`, `12` & `14` are out of (active) LTS now](https://nodejs.org/en/about/releases/).
+
+## If you use `hafas-client` via [CommonJS](https://en.wikipedia.org/wiki/CommonJS) …
+
+… you'll have to either
+- migrate your code to ECMAScript Modules (ESM), or
+- use [dynamic `import()`](https://nodejs.org/docs/latest-v16.x/api/esm.html#import-expressions), or
+- use a (somewhat hacky) tool like [`esm`](https://www.npmjs.com/package/esm).
+
+For more background information, check out [MDN's ESM explainer](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Modules) and [Node.js's ESM docs](https://nodejs.org/docs/latest-v16.x/api/esm.html).
+
+## If you use `departures()` or `arrivals()` …
+
+… adapt your code as follows:
+- `departures()` now returns an object `{departures: […], realtimeDataUpdatedAt: …}`
+- `arrivals()` now returns an object `{arrivals: […], realtimeDataUpdatedAt: …}`
+
+### … with `opt.stopovers: true` …
+
+… check if this still works. If `hafas-client` throws "`opt.stopovers` is not supported by this endpoint", you'll have to use `trip()` for each departure/arrival to get its trip's stopovers.
+
+Most profiles had to be upgraded to a newer HAFAS protocol version to still work, and newer HAFAS protocol versions don't support this flag anymore.
+
+## If you use `journeys()`, `refreshJourney()` or `journeysFromTrip()` …
+
+… use `res.realtimeDataUpdatedAt` instead of `res.realtimeDataFrom`, it has been renamed.
+
+## If you use `refreshJourney()` …
+
+… adapt your code as follows: it now returns an object `{journey: …, realtimeDataUpdatedAt: …}`.
+
+## If you use `trip()` …
+
+… adapt your code as follows: it now returns an object `{trip: …, realtimeDataUpdatedAt: …}`.
+
+… don't pass the `lineName` parameter anymore, it is not needed anymore and has been removed.
+
+## If you use `tripsByName()` …
+
+… adapt your code as follows: it now returns an object `{trips: […], realtimeDataUpdatedAt: …}`.
+
+## If you use `radar()` …
+
+… adapt your code as follows: it now returns an object `{movements: […], realtimeDataUpdatedAt: …}`.
+
+## If you use `reachableFrom()` …
+
+… and it sometimes fails with a server error (a.k.a. HAFAS is unable to process the request), wrap it in a retry logic ([open an Issue](https://github.com/public-transport/hafas-client/issues/new) to get help). Automatic retries have been removed.
+
+## If you use `remarks()` …
+
+… adapt your code as follows: it now returns an object `{remarks: […], realtimeDataUpdatedAt: …}`.
+
+## If you use `lines()` …
+
+… adapt your code as follows: it now returns an object `{lines: […], realtimeDataUpdatedAt: …}`.
+
+## If you use the DB profile …
+
+… be aware that the `regionalExp` product has been renamed to `regionalExpress`. Among other places, you will notice this in `line.product`.
+
+## If you use the BVG or VBB profile …
+
+### … and rely on `stop.weight` …
+
+… use [`vbb-stations`](https://npmjs.com/package/vbb-stations) to get it instead. It has been removed from `hafas-client`.
+
+### … and rely on 12-digit stop IDs …
+
+… adapt your code to handle 9-digit (and sometimes 6-digit?) stop IDs. The translation logic has been removed from `hafas-client`.
+
+## If you rely on `line.adminCode` …
+
+… be aware that `hafas-client` now doesn't remove trailing `-` characters anymore (e.g. `DBS---` instead of `DBS`).
+
+## If you use the VBB profile …
+
+### … and rely on `line.{symbol,nr,metro,express,night}` …
+
+… use [`vbb-parse-line`](https://npmjs.com/package/vbb-parse-line) with `line.name` by yourself. It has been removed from `hafas-client`.
+
+### … and rely on `ticket.{amount,fullDay,group,tariff,coverage,variant}` …
+
+… use [`vbb-parse-ticket`](https://npmjs.com/package/vbb-parse-ticket) to parse details from the ticket identifier ([open an Issue](https://github.com/public-transport/hafas-client/issues/new) to get help). It has been removed from `hafas-client`.
+
+## Other breaking changes
+
+- `warning.fromLoc`/`warning.toLoc` are now called `warning.fromLocation`/`warning.toLocation`
+- `trip()`/`tripsByName()`: remove `trip.reachable` (it didn't make sense anyways)

docs/nearby.md

@@ -10,23 +10,25 @@ With `opt`, you can override the default options, which look like this:
 {
 	results: 8, // maximum number of results
 	distance: null, // maximum walking distance in meters
-	poi:      false, // not supported
+	poi:      false, // return points of interest?
 	stops:    true, // return stops/stations?
-	subStops: true, // not supported
+	subStops: true, // parse & expose sub-stops of stations?
-	entrances: true, // not supported
+	entrances: true, // parse & expose entrances of stops/stations?
-	linesOfStops: false, // not supported
+	linesOfStops: false, // parse & expose lines at each stop/station?
 	language: 'en' // language to get results in
 }
 ```
 
 ## Response
 
+As an example, we're going to use the [VBB profile](../p/vbb):
+
 ```js
-import {createClient} from 'db-vendo-client'
+import {createClient} from 'hafas-client'
-import {profile as dbProfile} from 'db-vendo-client/p/db/index.js'
+import {profile as vbbProfile} from 'hafas-client/p/vbb/index.js'
 
 const userAgent = 'link-to-your-project-or-email' // adapt this to your project!
-const client = createClient(dbProfile, userAgent)
+const client = createClient(vbbProfile, userAgent)
 
 await client.nearby({
 	type: 'location',

docs/profile-boilerplate.js

@@ -0,0 +1,45 @@
+// Refer to the the ./writing-a-profile.md guide.
+
+const products = [
+	{
+		id: 'commuterTrain',
+		mode: 'train',
+		bitmasks: [16],
+		name: 'ACME Commuter Rail',
+		short: 'CR',
+		default: true,
+	},
+	{
+		id: 'metro',
+		mode: 'train',
+		bitmasks: [8],
+		name: 'Foo Bar Metro',
+		short: 'M',
+		default: true,
+	},
+];
+
+const transformReqBody = (body) => {
+	// get these from the recorded app requests
+	// body.client = { … }
+	// body.ver = …
+	// body.auth = { … }
+	// body.lang = …
+	return body;
+};
+
+const insaProfile = {
+	// locale: …,
+	// timezone: …,
+	// endpoint: …,
+	transformReqBody,
+
+	products: products,
+
+	trip: false,
+	radar: false,
+};
+
+export {
+	insaProfile,
+};

docs/radar.md

@@ -0,0 +1,191 @@
+# `radar({north, west, south, east}, [opt])`
+
+Use this method to find all vehicles currently in an area. Note that it is not supported by every profile/endpoint.
+
+`north`, `west`, `south` and `eath` must be numbers (e.g. `52.52411`). Together, they form a [bounding box](https://en.wikipedia.org/wiki/Minimum_bounding_box).
+
+With `opt`, you can override the default options, which look like this:
+
+```js
+{
+	results: 256, // maximum number of vehicles
+	duration: 30, // compute frames for the next n seconds
+	frames: 3, // nr of frames to compute
+	polylines: true, // return a track shape for each vehicle?
+	subStops: true, // parse & expose sub-stops of stations?
+	entrances: true, // parse & expose entrances of stops/stations?
+	language: 'en' // language to get results in
+}
+```
+
+## Response
+
+*Note:* As stated in the [*Friendly Public Transport Format* v2 draft spec](https://github.com/public-transport/friendly-public-transport-format/blob/3bd36faa721e85d9f5ca58fb0f38cdbedb87bbca/spec/readme.md), the returned `departure` and `arrival` times include the current delay. The `departureDelay`/`arrivalDelay` fields express how much they differ from the schedule.
+
+As an example, we're going to use the [VBB profile](../p/vbb):
+
+```js
+import {createClient} from 'hafas-client'
+import {profile as vbbProfile} from 'hafas-client/p/vbb/index.js'
+
+const userAgent = 'link-to-your-project-or-email' // adapt this to your project!
+const client = createClient(vbbProfile, userAgent)
+
+const {
+	movements,
+	realtimeDataUpdatedAt,
+} = await client.radar({
+	north: 52.52411,
+	west: 13.41002,
+	south: 52.51942,
+	east: 13.41709
+}, {results: 5})
+```
+
+`realtimeDataUpdatedAt` is a UNIX timestamp reflecting the latest moment when (at least some of) the response's realtime data have been updated.
+
+`movements` may look like this:
+
+```js
+[ {
+	location: {
+		type: 'location',
+		latitude: 52.521508,
+		longitude: 13.411267
+	},
+
+	line: {
+		type: 'line',
+		id: 's9',
+		fahrtNr: '12345',
+		name: 'S9',
+		public: true,
+		mode: 'train',
+		product: 'suburban',
+		symbol: 'S',
+		nr: 9,
+		metro: false,
+		express: false,
+		night: false,
+		operator: {
+			type: 'operator',
+			id: 's-bahn-berlin-gmbh',
+			name: 'S-Bahn Berlin GmbH'
+		}
+	},
+	direction: 'S Flughafen Berlin-Schönefeld',
+	trip: 31463, // todo: outdated, should be tripId!
+
+	nextStopovers: [ {
+		stop: {
+			type: 'stop',
+			id: '900000029101',
+			name: 'S Spandau',
+			location: {
+				type: 'location',
+				latitude: 52.534794,
+				longitude: 13.197477
+			},
+			products: {
+				suburban: true,
+				subway: false,
+				tram: false,
+				bus: true,
+				ferry: false,
+				express: true,
+				regional: true
+			}
+		},
+		arrival: null,
+		plannedArrival: null,
+		arrivalDelay: null,
+		arrivalPlatform: null,
+		plannedArrivalPlatform: null,
+		departure: null,
+		plannedDeparture: '2017-12-17T19:16:00+01:00',
+		departureDelay: null,
+		departurePlatform: null,
+		plannedDeparturePlatform: '1'
+	} /* … */ ],
+	frames: [ {
+		origin: {
+			type: 'stop',
+			id: '900000100003',
+			name: 'S+U Alexanderplatz',
+			location: { /* … */ },
+			products: { /* … */ }
+		},
+		destination: {
+			type: 'stop',
+			id: '900000100004',
+			name: 'S+U Jannowitzbrücke',
+			location: { /* … */ },
+			products: { /* … */ }
+		},
+		t: 0
+	}, /* … */ {
+		origin: { /* Alexanderplatz */ },
+		destination: { /* Jannowitzbrücke */ },
+		t: 30000
+	} ]
+}, {
+	location: {
+		type: 'location',
+		latitude: 52.523297,
+		longitude: 13.411151
+	},
+	line: {
+		type: 'line',
+		id: 'm2',
+		fahrtNr: '54321',
+		name: 'M2',
+		public: true,
+		mode: 'train',
+		product: 'tram',
+		symbol: 'M',
+		nr: 2,
+		metro: true,
+		express: false,
+		night: false,
+		operator: {
+			type: 'operator',
+			id: 'berliner-verkehrsbetriebe',
+			name: 'Berliner Verkehrsbetriebe'
+		}
+	},
+	direction: 'Heinersdorf',
+	trip: 26321,
+	nextStopovers: [ {
+		stop: { /* S+U Alexanderplatz/Dircksenstr. */ },
+		arrival: null,
+		plannedArrival: null,
+		arrivalDelay: null,
+		departure: null,
+		plannedAeparture: '2017-12-17T19:52:00+01:00',
+		departureDelay: null
+	}, {
+		stop: { /* Memhardstr. */ },
+		arrival: null,
+		plannedArrival: '2017-12-17T19:54:00+01:00',
+		arrivalDelay: null,
+		arrivalPlatform: null,
+		plannedArrivalPlatform: null,
+		departure: null,
+		plannedDeparture: '2017-12-17T19:54:00+01:00',
+		departureDelay: null,
+		departurePlatform: null,
+		plannedDeparturePlatform: '1'
+	}, /* … */ ],
+	frames: [ {
+		origin: { /* S+U Alexanderplatz/Dircksenstr. */ },
+		destination: { /* Memhardstr. */ },
+		t: 0
+	}, /* … */ {
+		origin: { /* Memhardstr. */ },
+		destination: { /* Mollstr./Prenzlauer Allee */ },
+		t: 30000
+	} ]
+}, /* … */ ]
+```
+
+If you pass `polylines: true`, each movement will have a `polyline` field, as documented in [the corresponding section in the `trip()` docs](trip.md#polyline-option), with the exception that station info is missing.

docs/reachable-from.md

@@ -0,0 +1,98 @@
+# `reachableFrom(address, [opt])`
+
+This method can be used to get stations reachable within a certain time from an address. This concept is called [isochrone diagram](https://en.wikipedia.org/wiki/Isochrone_map#Transportation_planning).
+
+*Note*: It appears that HAFAS cannot generate actual isochrones, but only the list of reachable stations, which you can estimate the isochrone(s) from.
+
+`address` must be an [*FPTF* `location` object](https://github.com/public-transport/friendly-public-transport-format/blob/3bd36faa721e85d9f5ca58fb0f38cdbedb87bbca/spec/readme.md#location-objects).
+
+With `opt`, you can override the default options, which look like this:
+
+```js
+{
+	when: new Date(),
+	maxTransfers: 5, // maximum of 5 transfers
+	maxDuration: 20, // maximum travel duration in minutes, pass `null` for infinite
+	products: {
+		// These entries may vary from profile to profile!
+		suburban: true,
+		subway: true
+		// …
+	},
+	subStops: true, // parse & expose sub-stops of stations?
+	entrances: true, // parse & expose entrances of stops/stations?
+}
+```
+
+## Response
+
+`reachableFrom(address, [opt])` returns an array, in which each item has a `duration` and an array of [*Friendly Public Transport Format* `station`s](https://github.com/public-transport/friendly-public-transport-format/blob/3bd36faa721e85d9f5ca58fb0f38cdbedb87bbca/spec/readme.md#station).
+
+As an example, we're going to use the [VBB profile](../p/vbb):
+
+```js
+import {createClient} from 'hafas-client'
+import {profile as vbbProfile} from 'hafas-client/p/vbb/index.js'
+
+const userAgent = 'link-to-your-project-or-email' // adapt this to your project!
+const client = createClient(vbbProfile, userAgent)
+
+const {
+	reachable,
+	realtimeDataUpdatedAt,
+} = await client.reachableFrom({
+	type: 'location',
+	address: '13353 Berlin-Wedding, Torfstr. 17',
+	latitude: 52.541797,
+	longitude: 13.350042
+}, {
+	maxDuration: 10 // minutes
+})
+```
+
+`realtimeDataUpdatedAt` is a UNIX timestamp reflecting the latest moment when (at least some of) the response's realtime data have been updated.
+
+`reachable` may look like this:
+
+```js
+[
+	{
+		duration: 2,
+		stations: [
+			{
+				type: 'stop',
+				id: '900000009101',
+				name: 'U Amrumer Str.',
+				location: {type: 'location', latitude: 52.542201, longitude: 13.34953},
+				products: { /* … */ }
+			}
+		]
+	}, {
+		duration: 3,
+		stations: [
+			{
+				type: 'stop',
+				id: '900000001201',
+				name: 'S+U Westhafen',
+				location: {type: 'location', latitude: 52.536179, longitude: 13.343839},
+				products: { /* … */ }
+			}
+			// …
+		]
+	},
+	// …
+	{
+		duration: 10,
+		stations: [
+			{
+				type: 'stop',
+				id: '900000001203',
+				name: 'Döberitzer Str.',
+				location: {type: 'location', latitude: 52.530668, longitude: 13.36811},
+				products: { /* … */ }
+			}
+			// …
+		]
+	}
+]
+```

docs/readme.md

@@ -1,21 +1,19 @@
-# `db-vendo-client` documentation
+# `hafas-client` documentation
 
-**[JS API documentation](api.md)**
+**[API documentation](api.md)**
 
-[REST API OpenAPI schema](openapi.yaml) ([open in Swagger Editor](https://editor.swagger.io/?url=https://raw.githubusercontent.com/public-transport/db-vendo-client/refs/heads/main/docs/openapi.yaml))
+## Migrating from an old `hafas-client` version
 
-## Migrating from an old (v5) `hafas-client` version
+- [`4` → `5` migration guide](migrating-to-5.md)
-
-`db-vendo-client` tries to be as compatible as possible with `hafas-client` v6. If you were still on v5 or earlier, see the [`5` → `6` migration guide](https://github.com/public-transport/hafas-client/blob/main/docs/migrating-to-6.md) of `hafas-client`.
 
 ## Throttling requests
 
 There's opt-in support for throttling requests to the endpoint.
 
 ```js
-import {createClient} from 'db-vendo-client'
+import {createClient} from 'hafas-client'
-import {withThrottling} from 'db-vendo-client/throttle.js'
+import {withThrottling} from 'hafas-client/throttle.js'
-import {profile as dbProfile} from 'db-vendo-client/p/db/index.js'
+import {profile as dbProfile} from 'hafas-client/p/db/index.js'
 
 const userAgent = 'link-to-your-project-or-email' // adapt this to your project!
 
@@ -39,9 +37,9 @@ const client = createClient(throttledDbProfile, userAgent)
 There's opt-in support for retrying failed requests to the endpoint.
 
 ```js
-import {createClient} from 'db-vendo-client'
+import {createClient} from 'hafas-client'
-import {withRetrying} from 'db-vendo-client/retry.js'
+import {withRetrying} from 'hafas-client/retry.js'
-import {profile as dbProfile} from 'db-vendo-client/p/db/index.js'
+import {profile as dbProfile} from 'hafas-client/p/db/index.js'
 
 const userAgent = 'link-to-your-project-or-email' // adapt this to your project!
 
@@ -63,12 +61,27 @@ const client = createClient(retryingDbProfile, userAgent)
 
 ## User agent randomization
 
-By default, `db-vendo-client` does not randomize the client name that you pass into `createClient`, and sends it as [`User-Agent`](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/User-Agent) as it is. At least DB Navigator always sends the same user agent as well (cf. `dbnav` profile).  You can turn on randomization by setting `profile.randomizeUserAgent` to `false`:
+By default, `hafas-client` randomizes the client name that you pass into `createClient`, and sends it as [`User-Agent`](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/User-Agent) in a randomized form:
+
+```js
+import {createClient} from 'hafas-client'
+// …
+
+const userAgent = 'my-awesome-program'
+const client = createClient(someProfile, userAgent)
+
+await client.journeys(/* … */)
+// User-Agent: my-awee70429some-pre70429ogram
+await client.journeys(/* … */)
+// User-Agent: my-awesom9bb8e2e-prog9bb8e2ram
+```
+
+You can turn this off by setting `profile.randomizeUserAgent` to `false`:
 
 ```js
 const client = createClient({
 	...someProfile,
-	randomizeUserAgent: true,
+	randomizeUserAgent: false,
 }, userAgent)
 ```
 
@@ -79,8 +92,8 @@ You can use `profile.logRequest` and `profile.logResponse` to process the raw [F
 As an example, we can implement a custom logger:
 
 ```js
-import {createClient} from 'db-vendo-client'
+import {createClient} from 'hafas-client'
-import {profile as dbProfile} from 'db-vendo-client/p/db/index.js'
+import {profile as dbProfile} from 'hafas-client/p/db/index.js'
 
 const userAgent = 'link-to-your-project-or-email' // adapt this to your project!
 
@@ -127,14 +140,17 @@ The default `profile.logRequest` [`console.error`](https://nodejs.org/docs/lates
 
 ## Error handling
 
-Unexpected errors – e.g. due to bugs in `db-vendo-client` itself – aside, its methods may reject with the following errors:
+Unexpected errors – e.g. due to bugs in `hafas-client` itself – aside, its methods may reject with the following errors:
 
-- `Error` – A generic error, e.g. if the DB backend returned a HTTP error.
 - `HafasError` – A generic error to signal that something HAFAS-related went wrong, either in the client, or in the HAFAS endpoint.
+- `HafasAccessDeniedError` – The HAFAS endpoint has rejected your request because you're not allowed to access it (or the specific API call). Subclass of `HafasError`.
+- `HafasInvalidRequestError` – The HAFAS endpoint reports that an invalid request has been sent. Subclass of `HafasError`.
+- `HafasNotFoundError` – The HAFAS endpoint does not know about such stop/trip/etc. Subclass of `HafasError`.
+- `HafasServerError` – An error occured within the HAFAS endpoint, so that it can't fulfill the request; For example, this happens when HAFAS' internal backend is unavailable. Subclass of `HafasError`.
 
-Each `HafasError` error has the following properties:
+Each error has the following properties:
 
-- `isHafasError` – Always `true`. Allows you to distinguish HAFAS-related errors from e.g. network errors.
+- `isHafasError` – Always `true`. Allows you to differente HAFAS-related errors from e.g. network errors.
 - `code` – A string representing the error type for all other error classes, e.g. `INVALID_REQUEST` for `HafasInvalidRequestError`. `null` for plain `HafasError`s.
 - `isCausedByServer` – Boolean, telling you if the HAFAS endpoint says that it couldn't process your request because *it* is unavailable/broken.
 - `hafasCode` – A HAFAS-specific error code, if the HAFAS endpoint returned one; e.g. `H890` when no journeys could be found. `null` otherwise.
@@ -142,13 +158,32 @@ Each `HafasError` error has the following properties:
 - `url` – The URL of the request.
 - `response` – The [Fetch API `Response`](https://developer.mozilla.org/en-US/docs/Web/API/Response).
 
+To check **if an error from `hafas-client` is HAFAS-specific, use `error instanceof HafasError`**:
 
-## Using `db-vendo-client` from another language
+```js
+import {HafasError} from 'hafas-client/lib/errors.js'
 
-If you want to use `db-vendo-client` to access DB APIs but work with non-Node.js environments, you can use it together with [hafas-rest-api](https://github.com/public-transport/hafas-rest-api) to create a REST API (see the [root readme](https://github.com/public-transport/db-vendo-client/tree/main#usage) and the Docker image). 
+try {
-Or use [`hafas-client-rpc`](https://github.com/derhuerst/hafas-client-rpc) to create a [JSON-RPC](https://www.jsonrpc.org) interface that you can send commands to.
+	await client.journeys(/* … */)
+} catch (err) {
+	if (err instanceof HafasError) {
+		// HAFAS-specific error
+	} else {
+		// different error, e.g. network (ETIMEDOUT, ENETDOWN)
+	}
+}
+```
 
+To determine **if you should automatically retry an error, use `!error.causedByServer`**.
 
-## General documentation and notes for DB APIs
+## Using `hafas-client` from another language
 
-[`db-apis.md`](db-apis.md)
+If you want to use `hafas-client` to access HAFAS APIs but work with non-Node.js environments, you can use [`hafas-client-rpc`](https://github.com/derhuerst/hafas-client-rpc) to create a [JSON-RPC](https://www.jsonrpc.org) interface that you can send commands to.
+
+## Writing a profile
+
+Check [the guide](writing-a-profile.md).
+
+## General documentation for `mgate.exe` APIs
+
+[`hafas-mgate-api.md`](hafas-mgate-api.md)

docs/refresh-journey.md

@@ -7,10 +7,10 @@ With `opt`, you can override the default options, which look like this:
 ```js
 {
 	stopovers: false, // return stations on the way?
-	polylines: false, // return a shape for each leg? mutually exclusive with tickets
+	polylines: false, // return a shape for each leg?
-	tickets: false, // return tickets? mutually exclusive with polylines
+	tickets: false, // return tickets? only available with some profiles
-	subStops: true, // not supported
+	subStops: true, // parse & expose sub-stops of stations?
-	entrances: true, // not supported
+	entrances: true, // parse & expose entrances of stops/stations?
 	remarks: true, // parse & expose hints & warnings?
 	language: 'en' // language to get results in
 }
@@ -18,14 +18,17 @@ With `opt`, you can override the default options, which look like this:
 
 ## Response
 
+As an example, we're going to use the [VBB profile](../p/vbb):
+
 ```js
-import {createClient} from 'db-vendo-client'
+import {createClient} from 'hafas-client'
-import {profile as dbProfile} from 'db-vendo-client/p/db/index.js'
+import {profile as vbbProfile} from 'hafas-client/p/vbb/index.js'
 
 const userAgent = 'link-to-your-project-or-email' // adapt this to your project!
-const client = createClient(dbProfile, userAgent)
+const client = createClient(vbbProfile, userAgent)
 
-const {journeys} = await client.journeys('8000105', '8000096', {results: 1})
+// Hauptbahnhof to Heinrich-Heine-Str.
+const {journeys} = await client.journeys('900000003201', '900000100008', {results: 1})
 
 // later, fetch up-to-date info on the journey
 const {
@@ -36,4 +39,4 @@ const {
 
 `journey` is a *single* [*Friendly Public Transport Format* v2 draft](https://github.com/public-transport/friendly-public-transport-format/blob/3bd36faa721e85d9f5ca58fb0f38cdbedb87bbca/spec/readme.md) `journey`, in the same format as returned by [`journeys()`](journeys.md).
 
-`realtimeDataUpdatedAt` is currently not set in db-vendo-client, because the upstream APIs don't provide it.
+`realtimeDataUpdatedAt` is a UNIX timestamp reflecting the latest moment when (at least some of) the response's realtime data have been updated.

docs/remarks.md

@@ -0,0 +1,150 @@
+# `remarks([opt])`
+
+**Fetches all remarks known to the HAFAS endpoint**, e.g. warnings about disruptions, planned construction work, and general notices about the operating situation.
+
+With `opt`, you can override the default options, which look like this:
+
+```js
+{
+	results: 100, // maximum number of remarks
+	// filter by time
+	from: Date.now(),
+	to: null,
+	products: null, // filter by affected products
+	language: 'en', // depends on the profile
+}
+```
+
+## Example
+
+As an example, we're going to use the [SVV profile](../p/svv):
+
+```js
+import {createClient} from 'hafas-client'
+import {profile as svvProfile} from 'hafas-client/p/svv/index.js'
+
+const userAgent = 'link-to-your-project-or-email' // adapt this to your project!
+const client = createClient(svvProfile, userAgent)
+
+const {
+	remarks,
+	realtimeDataUpdatedAt,
+} = await client.remarks()
+```
+
+`realtimeDataUpdatedAt` is a UNIX timestamp reflecting the latest moment when (at least some of) the response's realtime data have been updated.
+
+`remarks` may look like this:
+
+```js
+[
+	{
+		id: 'HIM_FREETEXT_110342',
+		type: 'warning',
+		summary: 'Bus will be running at different times',
+		text: 'Due to operational changes, this bus will be running at different times. We apologise for any inconvenience this may cause.',
+		priority: 50,
+		company: 'KGÖVV',
+		validFrom: '2020-07-04T00:00:00+02:00',
+		validUntil: '2020-08-09T23:59:00+02:00',
+		modified: '2020-07-01T14:39:12+02:00',
+		products: {
+			'bahn-s-bahn': true,
+			'u-bahn': true,
+			strassenbahn: true,
+			fernbus: true,
+			regionalbus: true,
+			stadtbus: true,
+			'seilbahn-zahnradbahn': true,
+			schiff: true,
+		},
+		categories: [1],
+		icon: {type: 'HIM1', title: null},
+	},
+	// …
+	{
+		id: 'HIM_FREETEXT_110235',
+		type: 'warning',
+		summary: 'Linie 7 - Umleitungen',
+		text: 'Aufgrund einer Baustelle gibt es bei der Linie 7 umfangreiche Umleitungen.',
+		priority: 100,
+		company: 'VOR',
+		validFrom: '2020-07-13T00:00:00+02:00',
+		validUntil: '2020-08-31T23:59:00+02:00',
+		modified: '2020-06-30T12:37:38+02:00',
+		affectedLines: [{
+			type: 'line',
+			id: '7',
+			name: '7',
+			public: true,
+		}],
+		products: {
+			'bahn-s-bahn': true,
+			'u-bahn': true,
+			strassenbahn: true,
+			fernbus: true,
+			regionalbus: true,
+			stadtbus: true,
+			'seilbahn-zahnradbahn': false,
+			schiff: true,
+		},
+		categories: [1],
+		icon: {type: 'HIM1', title: null},
+	},
+	// …
+	{
+		id: 'HIM_FREETEXT_106619',
+		type: 'warning',
+		summary: 'Stop Bad Hall Bahnhofstraße can not be approached',
+		text: 'The stop at Bad Hall Bahnhofstraße can not be approached during 21.04.-24.07.2020. Please use alternatively the stop at Bad Hall Busterminal (Abzw Bahnhofstraße).',
+		priority: 100,
+		company: 'OÖVG',
+		validFrom: '2020-04-21T00:00:00+02:00',
+		validUntil: '2020-07-24T23:59:00+02:00',
+		modified: '2020-07-08T12:52:13+02:00',
+		affectedLines: [{
+			type: 'line',
+			id: '452',
+			name: '452',
+			public: true,
+		}],
+		products: {
+			'bahn-s-bahn': false,
+			'u-bahn': false,
+			strassenbahn: false,
+			fernbus: false,
+			regionalbus: true,
+			stadtbus: false,
+			'seilbahn-zahnradbahn': false,
+			schiff: false
+		},
+		categories: [1],
+		icon: {type: 'HIM1', title: null},
+	},
+	// …
+	{
+		id: 'HIM_FREETEXT_106671',
+		type: 'warning',
+		summary: 'Neue Haltestellennamen',
+		text: 'Im Zuge der Neuordnung der Regionalbusverkehre werden mit 6.7.2020 neue Fahrpläne und Liniennummern wirksam und dadurch können sich mitunter die Haltestellennamen verändern.',
+		priority: 100,
+		company: 'VOR',
+		validFrom: '2020-04-21T00:00:00+02:00',
+		validUntil: '2020-09-30T23:59:00+02:00',
+		modified: '2020-04-21T13:20:41+02:00',
+		products: {
+			'bahn-s-bahn': true,
+			'u-bahn': true,
+			strassenbahn: true,
+			fernbus: true,
+			regionalbus: true,
+			stadtbus: true,
+			'seilbahn-zahnradbahn': false,
+			schiff: true,
+		},
+		categories: [4],
+		icon: {type: 'HIM4', title: null},
+	},
+	// …
+]
+```

docs/server-info.md

@@ -0,0 +1,38 @@
+# `serverInfo([opt])`
+
+**Fetches meta information from the HAFAS endpoint.**
+
+With `opt`, you can override the default options, which look like this:
+
+```js
+{
+	versionInfo: true, // query HAFAS versions?
+	language: 'en', // depends on the profile
+}
+```
+
+## Example
+
+As an example, we're going to use the [SVV profile](../p/svv):
+
+```js
+import {createClient} from 'hafas-client'
+import {profile as svvProfile} from 'hafas-client/p/svv/index.js'
+
+const userAgent = 'link-to-your-project-or-email' // adapt this to your project!
+const client = createClient(svvProfile, userAgent)
+
+await client.serverInfo()
+```
+
+```js
+{
+	// version of the HAFAS Connection Interface (HCI), the API that hafas-client uses
+	hciVersion: '1.23',
+
+	timetableStart: '20200517',
+	timetableEnd: '20201212',
+	serverTime: '2020-07-19T21:32:12+02:00',
+	realtimeDataUpdatedAt: 1595187102,
+}
+```

docs/stop.md

@@ -1,7 +1,5 @@
 # `stop(id, [opt])`
 
-This endpoint is not available with `dbweb` profile.
-
 `id` must be in one of these formats:
 
 ```js
@@ -25,8 +23,8 @@ With `opt`, you can override the default options, which look like this:
 
 ```js
 {
-	subStops: true, // not supported
+	subStops: true, // parse & expose sub-stops of stations?
-	entrances: true, // not supported
+	entrances: true, // parse & expose entrances of stops/stations?
 	linesOfStops: false, // parse & expose lines at the stop/station?
 	language: 'en' // language to get results in
 }
@@ -34,13 +32,14 @@ With `opt`, you can override the default options, which look like this:
 
 ## Response
 
+As an example, we're going to use the [VBB profile](../p/vbb):
 
 ```js
 import {createClient} from 'hafas-client'
-import {profile as dbProfile} from 'hafas-client/p/db/index.js'
+import {profile as vbbProfile} from 'hafas-client/p/vbb/index.js'
 
 const userAgent = 'link-to-your-project-or-email' // adapt this to your project!
-const client = createClient(dbProfile, userAgent)
+const client = createClient(vbbProfile, userAgent)
 
 await client.stop('900000042101') // U Spichernstr.
 ```
@@ -73,6 +72,11 @@ The result may look like this:
 		product: 'subway',
 		public: true,
 		name: 'U1',
+		symbol: 'U',
+		nr: 1,
+		metro: false,
+		express: false,
+		night: false
 	},
 	// …
 	{
@@ -82,6 +86,21 @@ The result may look like this:
 		product: 'bus',
 		public: true,
 		name: 'N9',
+		symbol: 'N',
+		nr: 9,
+		metro: false,
+		express: false,
+		night: true
 	} ]
 }
 ```
+
+If the endpoint returns a list of entrances for a station, the resulting station object will have an `entrances` array looking similar to this:
+
+```js
+[
+	{type: 'location', latitude: 47.411069, longitude: 10.277412},
+	{type: 'location', latitude: 47.410493, longitude: 10.277223},
+	{type: 'location', latitude: 47.410754, longitude: 10.278023}
+]
+```

docs/tests.md

@@ -1,8 +1,8 @@
-# automated tests in `db-vendo-client`
+# automated tests in `hafas-client`
 
-Because transit data is inherently dynamic (e.g. a different set of departures being returned for a stop now than in 10 minutes), and because it is of paramount importance that `db-vendo-client` actually works with HAFAS endpoints *as they currently work*, its testing setup is a bit unusual.
+Because transit data is inherently dynamic (e.g. a different set of departures being returned for a stop now than in 10 minutes), and because it is of paramount importance that `hafas-client` actually works with HAFAS endpoints *as they currently work*, its testing setup is a bit unusual.
 
-`db-vendo-client` has three kinds of automated tests:
+`hafas-client` has three kinds of automated tests:
 - unit tests, which test individual aspects of the case base in isolation (e.g. the parsing of HAFAS-formatted dates & times) – run via `npm run test-unit`
 - end-to-end (E2E) tests, which run actual HTTP requests against their respective profile's HAFAS endpoint – run via `npm run test-e2e`
 - integration tests, which are the E2E tests running against pre-recorded (and checked-in) HTTP request fixtures – run via `npm run test-integration`
@@ -16,7 +16,7 @@ Because the E2E & integration tests are based on the same code, when changing th
 As an example, let's assume that we have added an entirely new test to [the *DB* profile's E2E tests](../test/e2e/db.js).
 
 The behaviour of the HTTP request recording (into fixtures) and mocking (using the recorded fixtures) is controlled via an environment variable `$VCR_MODE`:
-- By running the test(s) with `VCR_MODE=record`, we can record the HTTP requests being made. The tests will run just like without `$VCR_MODE`, except that they will query data for date+time specified in `T_MOCK` (e.g. [here](https://github.com/public-transport/db-vendo-client/blob/8ff945c07515155380de0acb33584e474d6d547c/test/e2e/db.js#L33)).
+- By running the test(s) with `VCR_MODE=record`, we can record the HTTP requests being made. The tests will run just like without `$VCR_MODE`, except that they will query data for date+time specified in `T_MOCK` (e.g. [here](https://github.com/public-transport/hafas-client/blob/8ff945c07515155380de0acb33584e474d6d547c/test/e2e/db.js#L33)).
 - Then, by running the test(s) with `VCR_MODE=playback`, because their HTTP requests match the pre-recorded fixtures, they work on the corresponding mocked HTTP responses.
 
 Usually, you would not want to update all *already existing* recorded HTTP request fixtures of the test suite you have made changes in, as they are unrelated to the test you have added. To only record your *added* test, temporarily change `tap.test(…)` to read `tap.only(…)`, and run with `TAP_ONLY=1 VCR_MODE=record`; This will skip all unrelated tests entirely.

docs/trip.md

@@ -2,16 +2,19 @@
 
 This method can be used to refetch information about a trip – a vehicle stopping at a set of stops at specific times.
 
+*Note*: This method is not supported by every profile/endpoint.
+
 Let's say you used [`journeys`](journeys.md) and now want to get more up-to-date data about the arrival/departure of a leg. You'd pass in the trip ID from `leg.tripId`, e.g. `'1|24983|22|86|18062017'`, and the name of the line from `leg.line.name` like this:
 
 ```js
-import {createClient} from 'db-vendo-client'
+import {createClient} from 'hafas-client'
-import {profile as dbnavProfile} from 'db-vendo-client/p/dbnav/index.js'
+import {profile as vbbProfile} from 'hafas-client/p/vbb/index.js'
 
 const userAgent = 'link-to-your-project-or-email' // adapt this to your project!
-const client = createClient(dbnavProfile, userAgent)
+const client = createClient(vbbProfile, userAgent)
 
-const {journeys} = client.journeys('8000096', '8000105', {results: 1})
+// Hauptbahnhof to Heinrich-Heine-Str.
+const {journeys} = client.journeys('900000003201', '900000100008', {results: 1})
 const leg = journeys[0].legs[0]
 
 await client.trip(leg.tripId)
@@ -22,9 +25,9 @@ With `opt`, you can override the default options, which look like this:
 ```js
 {
 	stopovers: true, // return stations on the way?
-	polyline: false, // return a shape for the trip? only supported with HAFAS trip id (i.e. not with a trip id from a departure/arrival board of the `db` profile)
+	polyline: false, // return a shape for the trip?
-	subStops: true, // not supported
+	subStops: true, // parse & expose sub-stops of stations?
-	entrances: true, // not supported
+	entrances: true, // parse & expose entrances of stops/stations?
 	remarks: true, // parse & expose hints & warnings?
 	language: 'en' // language to get results in
 }
@@ -34,12 +37,13 @@ With `opt`, you can override the default options, which look like this:
 
 *Note:* As stated in the [*Friendly Public Transport Format* v2 draft spec](https://github.com/public-transport/friendly-public-transport-format/blob/3bd36faa721e85d9f5ca58fb0f38cdbedb87bbca/spec/readme.md), the returned `departure` and `arrival` times include the current delay. The `departureDelay`/`arrivalDelay` fields express how much they differ from the schedule.
 
+As an example, we're going to use the [VBB profile](../p/vbb):
 
 ```js
-import {createClient} from 'db-vendo-client'
+import {createClient} from 'hafas-client'
-import {profile as dbnavProfile} from 'db-vendo-client/p/dbnav/index.js'
+import {profile as vbbProfile} from 'hafas-client/p/vbb/index.js'
 
-const client = createClient(dbnavProfile)
+const client = createClient(vbbProfile)
 
 const {
 	trip,
@@ -49,7 +53,7 @@ const {
 })
 ```
 
-`realtimeDataUpdatedAt` is currently not set in db-vendo-client, because the upstream APIs don't provide it.
+`realtimeDataUpdatedAt` is a UNIX timestamp reflecting the latest moment when (at least some of) the response's realtime data have been updated.
 
 When running the code above, `trip` looked like this:
 
@@ -138,9 +142,9 @@ When running the code above, `trip` looked like this:
 
 ### `polyline` option
 
-Only supported with HAFAS trip id (i.e. not with a trip id from a departure/arrival board of the `db` profile).
+If you pass `polyline: true`, the trip will have a `polyline` field, containing a [GeoJSON](http://geojson.org) [`FeatureCollection`](https://tools.ietf.org/html/rfc7946#section-3.3) of [`Point`s](https://tools.ietf.org/html/rfc7946#appendix-A.1). Every `Point` next to a station will have `properties` containing the station's metadata.
 
-If you pass `polyline: true`, the trip will have a `polyline` field, containing a [GeoJSON](http://geojson.org) [`FeatureCollection`](https://tools.ietf.org/html/rfc7946#section-3.3) of [`Point`s](https://tools.ietf.org/html/rfc7946#appendix-A.1). 
+We'll look at an example for *U6* from *Alt-Mariendorf* to *Alt-Tegel*, taken from the [VBB profile](../p/vbb):
 
 ```js
 {
@@ -148,6 +152,12 @@ If you pass `polyline: true`, the trip will have a `polyline` field, containing
 	features: [
 		{
 			type: 'Feature',
+			properties: {
+				type: 'station',
+				id: '900000070301',
+				name: 'U Alt-Mariendorf',
+				/* … */
+			},
 			geometry: {
 				type: 'Point',
 				coordinates: [13.3875, 52.43993] // longitude, latitude
@@ -156,6 +166,12 @@ If you pass `polyline: true`, the trip will have a `polyline` field, containing
 		/* … */
 		{
 			type: 'Feature',
+			properties: {
+				type: 'station',
+				id: '900000017101',
+				name: 'U Mehringdamm',
+				/* … */
+			},
 			geometry: {
 				type: 'Point',
 				coordinates: [13.38892, 52.49448] // longitude, latitude
@@ -173,6 +189,12 @@ If you pass `polyline: true`, the trip will have a `polyline` field, containing
 		},
 		{
 			type: 'Feature',
+			properties: {
+				type: 'station',
+				id: '900000089301',
+				name: 'U Alt-Tegel',
+				/* … */
+			},
 			geometry: {
 				type: 'Point',
 				coordinates: [13.28406, 52.58915] // longitude, latitude

docs/trips-by-name.md

@@ -0,0 +1,114 @@
+# `tripsByName([lineNameOrFahrtNr], [opt])`
+
+Get all trips matching one or more criteria, e.g. a specific name.
+
+## Response
+
+As an example, we're going to use the [VBB profile](../p/vbb):
+
+```js
+import {createClient} from 'hafas-client'
+import {profile as vbbProfile} from 'hafas-client/p/vbb/index.js'
+
+const userAgent = 'link-to-your-project-or-email' // adapt this to your project!
+const client = createClient(vbbProfile, userAgent)
+
+const {
+	trips,
+	realtimeDataUpdatedAt,
+} = await client.tripsByName('S1')
+```
+
+With `opt`, you can override the default options, which look like this:
+
+```js
+{
+	// use either this
+	when: null,
+	// or these
+	fromWhen: null, untilWhen: null,
+
+	onlyCurrentlyRunning: true,
+	products: {
+		// these entries may vary from profile to profile
+		suburban: true,
+		subway: true,
+		tram: true,
+		bus: true,
+		ferry: true,
+		express: true,
+		regional: true,
+	},
+
+	currentlyStoppingAt: null, // only show trips currently stopping at a stop/station, string
+	lineName: null, // only show trips with this line name, string
+	operatorNames: null, // only show trips with these operator names, array of strings
+}
+```
+
+`realtimeDataUpdatedAt` is a UNIX timestamp reflecting the latest moment when (at least some of) the response's realtime data have been updated.
+
+`trips` may look like this:
+
+```js
+[
+	{
+		id: '1|1214|0|86|16092020'
+		direction: null,
+		line: {
+			type: 'line',
+			id: 's1',
+			fahrtNr: '325',
+			name: 'S1',
+			mode: 'train',
+			product: 'suburban',
+			// …
+		},
+
+		origin: {
+			type: 'stop',
+			id: '900000550239',
+			name: 'Warnemünde, Bhf',
+			location: { /* … */ },
+			products: { /* … */ },
+		},
+		departure: '2020-09-16T04:03:00+02:00',
+		plannedDeparture: '2020-09-16T04:03:00+02:00',
+		departureDelay: null,
+		departurePlatform: null,
+		plannedDeparturePlatform: null,
+
+		destination: {
+			type: 'stop',
+			id: '900000550002',
+			name: 'Rostock, Hbf',
+			location: { /* … */ },
+			products: { /* … */ },
+		},
+		arrival: '2020-09-16T04:24:00+02:00',
+		plannedArrival: '2020-09-16T04:24:00+02:00',
+		arrivalDelay: null,
+		arrivalPlatform: null,
+		plannedArrivalPlatform: null,
+	},
+	// …
+	{
+		id: '1|62554|0|86|16092020'
+		direction: null,
+		line: {
+			type: 'line',
+			id: 's1',
+			fahrtNr: '2001',
+			name: 'S1',
+			public: true,
+			mode: 'train',
+			product: 'suburban',
+			// …
+		},
+
+		origin: { /* … */ },
+		destination: { /* … */ },
+		// …
+	}
+]
+```

docs/writing-a-profile.md

@@ -0,0 +1,163 @@
+# Writing a profile
+
+**Per HAFAS endpoint, `hafas-client` has an endpoint-specific customisation called *profile*.** A profile may, for example, do the following:
+
+- handle the additional requirements of the endpoint (e.g. authentication),
+- extract additional information from the data provided by the endpoint,
+- guard against triggering bugs of certain endpoints (e.g. time limits).
+
+This guide is about writing such a profile. If you just want to use an already supported endpoint, refer to the [main readme](../readme.md) instead.
+
+*Note*: **If you get stuck, ask for help by [creating an issue](https://github.com/public-transport/hafas-client/issues/new)**; We're happy to help you expand the scope of this library!
+
+## 0. How do the profiles work?
+
+A profile may consist of three things:
+
+- **mandatory details about the HAFAS endpoint**
+	- `endpoint`: The protocol, host and path of the endpoint.
+	- `locale`: The [BCP 47](https://en.wikipedia.org/wiki/IETF_language_tag) [locale](https://en.wikipedia.org/wiki/Locale_(computer_software)) of your endpoint (or the area that your endpoint covers).
+	- `timezone`: An [IANA-time-zone](https://www.iana.org/time-zones)-compatible [timezone](https://en.wikipedia.org/wiki/Time_zone) of your endpoint.
+- **flags indicating which features are supported by the endpoint** – e.g. `trip`
+- **methods overriding the [default profile](../lib/default-profile.js)**
+
+Let's use a fictional endpoint for [Austria](https://en.wikipedia.org/wiki/Austria) as an example:
+
+```js
+const myProfile = {
+	endpoint: 'https://example.org/bin/mgate.exe',
+	locale: 'de-AT',
+	timezone: 'Europe/Vienna'
+}
+```
+
+Assuming their HAFAS endpoint returns all line names prefixed with `foo `, we can adapt our profile to clean them:
+
+```js
+// get the default line parser
+import {parseLine} from 'hafas-client/parse/line.js'
+
+// wrapper function with additional logic
+const parseLineWithoutFoo = (ctx, rawLine) => {
+	const line = parseLine(ctx, rawLine)
+	line.name = line.name.replace(/foo /g, '')
+	return line
+}
+
+myProfile.parseLine = parseLineWithoutFoo
+```
+
+If you pass this profile into `hafas-client`, the `parseLine` method will override [the default one](../parse/line.js).
+
+You can also use the `parseHook` helper to reduce boilerplate:
+
+```js
+import {parseHook} from 'hafas-client/lib/profile-hooks.js'
+
+const removeFoo = (ctx, rawLine) => ({
+	...ctx.parsed,
+	name: line.name.replace(/foo /g, '')
+})
+
+myProfile.parseLine = parseHook(parseLine, removeFoo)
+```
+
+## 1. Setup
+
+*Note*: There are many ways to find the required values. This way is rather easy and works with most endpoints by now.
+
+1. **Find the journey planning webapp** corresponding to the API endpoint; Usually, you can find it on the public transport provider's website.
+2. **Open your [browser's devtools](https://developer.mozilla.org/en-US/docs/Learn/Common_questions/What_are_browser_developer_tools)**, switch to the "Network" tab, and **inspect the requests to the HAFAS API**.
+
+If you can't find the webapp or your public transport provider doesn't have one, you can inspect their mobile app's traffic instead:
+
+1. Get an iOS or Android device and **download the "official" app.**
+2. **Configure a [man-in-the-middle HTTP proxy](https://docs.mitmproxy.org/stable/concepts-howmitmproxyworks/)** like [mitmproxy](https://mitmproxy.org).
+	- Configure your device to trust the self-signed SSL certificate, [as outlined in the mitmproxy docs](https://docs.mitmproxy.org/stable/concepts-certificates/).
+	- *Note*: This method does not work if the app uses [public key pinning](https://en.wikipedia.org/wiki/HTTP_Public_Key_Pinning). In this case (the app won't be able to query data), please [create an issue](https://github.com/public-transport/hafas-client/issues/new), so we can discuss other techniques.
+3. **Record requests of the app.**
+	- [There's a video showing this step](https://stuff.jannisr.de/how-to-record-hafas-requests.mp4).
+	- Make sure to cover all relevant sections of the app, e.g. "journeys", "departures", "live map". Better record more than less!
+	- To help others in the future, post the requests (in their entirety!) on GitHub, e.g. in as format like [this](https://gist.github.com/derhuerst/5fa86ed5aec63645e5ae37e23e555886). This will also let us help you if you have any questions.
+
+## 2. Basic profile
+
+*Note:* You should have read the [general documentation on `mgate.exe` APIs](hafas-mgate-api.md) to make sense of the terminology used below.
+
+You may want to start with the [profile boilerplate](profile-boilerplate.js).
+
+- **Identify the `endpoint`.** The protocol, host and path of the endpoint, *but not* the query string.
+	- *Note*: **`hafas-client` for now only supports the interface providing JSON** (generated from XML), which is being used by the corresponding iOS/Android apps. It supports neither the JSONP, nor the XML, nor the HTML interface. If the endpoint does not end in `mgate.exe`, it mostly likely won't work.
+- **Identify the `locale`.** Basically guess work; Use the date & time formats as an indicator.
+- **Identify the `timezone`.** This may be tricky, a for example [Deutsche Bahn](https://en.wikipedia.org/wiki/Deutsche_Bahn) returns departures for Moscow as `+01:00` instead of `+03:00`.
+- **Copy the authentication** and other meta fields, namely `ver`, `ext`, `client` and `lang`.
+	- You can find these fields in the root of each request JSON. Check [a VBB request](https://gist.github.com/derhuerst/ea5d6482b61aeb7384a2c788f43dc11d#file-0-serverinfo-http-L11-L33) and [the corresponding VBB profile](https://github.com/public-transport/hafas-client/blob/2baf2f6f0444ffc67317f8bafe0fe05f687e5fae/p/vbb/base.json#L2-L11) for an example.
+	- Add a function `transformReqBody(ctx, body)` to your profile, which adds the fields to `body`. todo: adapt this
+	- Some profiles have a `checksum` parameter (like [here](https://gist.github.com/derhuerst/2a735268bd82a0a6779633f15dceba33#file-journey-details-1-http-L1)) or two `mic` & `mac` parameters (like [here](https://gist.github.com/derhuerst/5fa86ed5aec63645e5ae37e23e555886#file-1-http-L1)). If you see one of them in your requests, jump to the [*Authentication* section of the `mgate.exe` docs](hafas-mgate-api.md#authentication). Unfortunately, this is necessary to get the profile working.
+
+## 3. Products
+
+In `hafas-client`, there's a distinction between the `mode` and the `product` fields:
+
+- The `mode` field describes the mode of transport in general. [Standardised by the *Friendly Public Transport Format*](https://github.com/public-transport/friendly-public-transport-format/blob/3bd36faa721e85d9f5ca58fb0f38cdbedb87bbca/spec/readme.md#modes), it is on purpose limited to a very small number of possible values, e.g. `train` or `bus`.
+- The value for `product` relates to how a means of transport "works" *in local context*. Example: Even though [*S-Bahn*](https://en.wikipedia.org/wiki/Berlin_S-Bahn) and [*U-Bahn*](https://en.wikipedia.org/wiki/Berlin_U-Bahn) in Berlin are both `train`s, they have different operators, service patterns, stations and look different. Therefore, they are two distinct `product`s `subway` and `suburban`.
+
+**Specify `product`s that appear in the app** you recorded requests of. For a fictional transit network, this may look like this:
+
+```js
+const products = [
+	{
+		id: 'commuterTrain',
+		mode: 'train',
+		bitmasks: [16],
+		name: 'ACME Commuter Rail',
+		short: 'CR',
+		default: true
+	},
+	{
+		id: 'metro',
+		mode: 'train',
+		bitmasks: [8],
+		name: 'Foo Bar Metro',
+		short: 'M',
+		default: true
+	}
+]
+```
+
+Let's break this down:
+
+- `id`: A sensible, [camelCased](https://en.wikipedia.org/wiki/Camel_case#Variations_and_synonyms), alphanumeric identifier. Use it for the key in the `products` array as well.
+- `mode`: A [valid *Friendly Public Transport Format* mode](https://github.com/public-transport/friendly-public-transport-format/blob/3bd36faa721e85d9f5ca58fb0f38cdbedb87bbca/spec/readme.md#modes).
+- `bitmasks`: HAFAS endpoints work with a [bitmask](https://en.wikipedia.org/wiki/Mask_(computing)#Arguments_to_functions) that toggles the individual products. It should be an array of values that toggle the appropriate bit(s) in the bitmask (see below).
+- `name`: A short, but distinct name for the means of transport, *just precise enough in local context*, and in the local language. In Berlin, `S-Bahn-Schnellzug` would be too much, because everyone knows what `S-Bahn` means.
+- `short`: The shortest possible symbol that identifies the product.
+- `default`: Should the product be used for queries (e.g. journeys) by default?
+
+If you want, you can now **verify that the profile works**; We've prepared [a script](https://runkit.com/derhuerst/hafas-client-profile-example/0.2.1) for that. Alternatively, [submit a Pull Request](https://help.github.com/articles/creating-a-pull-request-from-a-fork/) and we will help you out with testing and improvements.
+
+### Finding the right values for the `bitmasks` field
+
+As shown in [the video](https://stuff.jannisr.de/how-to-record-hafas-requests.mp4), search for a journey and toggle off one product at a time, recording the requests. After extracting the products bitmask ([example](https://gist.github.com/derhuerst/193ef489f8aa50c2343f8bf1f2a22069#file-via-http-L34)) you will end up with values looking like these:
+
+```
+toggles                     value  binary  subtraction     bit(s)
+all products                31     11111   31 - 0
+all but ACME Commuter Rail  15     01111   31 - 2^4        2^4
+all but Foo Bar Metro       23     10111   31 - 2^3        2^3
+all but product E           25     11001   31 - 2^2 - 2^1  2^2, 2^1
+all but product F           30     11110   31 - 2^0        2^0
+```
+
+## 4. Additional info
+
+We consider these improvements to be *optional*:
+- **Check if the endpoint supports the `trip()` call.**
+	- In the app, check if you can re-fetch details for the status of a single journey leg. It should load realtime delays and the current progress.
+	- If this feature is supported, add `trip: true` to the profile.
+- **Check if the endpoint supports the live map call.** Does the app have a "live map" showing all vehicles within an area? If so, add `radar: true` to the profile.
+-  **Consider transforming station & line names** into the formats that's most suitable for *local users*. This is just an optimal optimisation that makes it easier for users of the profile to use the data. Some examples:
+	- `M13 (Tram)` -> `M13`. With Berlin context, it is obvious that `M13` is a tram.
+	- `Berlin Jungfernheide Bhf` -> `Berlin Jungfernheide`. With local context, it's obvious that *Jungfernheide* is a train station.
+- **Check if the endpoint has non-obvious limitations** and let use know about these. Examples:
+	- Some endpoints have a time limit, after which they won't return more departures, but silently discard them.

eslint.config.js

@@ -1,62 +0,0 @@
-import eslintPluginJs from '@eslint/js';
-import eslintPluginStylistic from '@stylistic/eslint-plugin';
-import globals from 'globals';
-
-
-const config = [
-	eslintPluginJs.configs.recommended,
-	eslintPluginStylistic.configs['all-flat'],
-	{
-		files: ['**/*.js'],
-		languageOptions: {
-			ecmaVersion: 'latest',
-			globals: {
-				...globals.node,
-			},
-			sourceType: 'module',
-		},
-		rules: {
-			'@stylistic/array-bracket-newline': ['error', 'consistent'],
-			'@stylistic/array-element-newline': ['error', 'consistent'],
-			'@stylistic/arrow-parens': 'off',
-			'@stylistic/comma-dangle': ['error', 'always-multiline'],
-			'@stylistic/dot-location': ['error', 'property'],
-			'@stylistic/function-call-argument-newline': ['error', 'consistent'],
-			'@stylistic/function-paren-newline': 'off',
-			'@stylistic/indent': ['error', 'tab'],
-			'@stylistic/indent-binary-ops': ['error', 'tab'],
-			'@stylistic/max-len': 'off',
-			'@stylistic/multiline-comment-style': 'off',
-			'@stylistic/multiline-ternary': ['error', 'always-multiline'],
-			'@stylistic/newline-per-chained-call': ['error', {ignoreChainWithDepth: 1}],
-			'@stylistic/no-extra-parens': 'off',
-			'@stylistic/no-mixed-operators': 'off',
-			'@stylistic/no-tabs': 'off',
-			'@stylistic/object-property-newline': 'off',
-			'@stylistic/one-var-declaration-per-line': 'off',
-			'@stylistic/operator-linebreak': ['error', 'before'],
-			'@stylistic/padded-blocks': 'off',
-			'@stylistic/quote-props': ['error', 'consistent-as-needed'],
-			'@stylistic/quotes': ['error', 'single'],
-			'curly': 'error',
-			'no-implicit-coercion': 'error',
-			'no-unused-vars': [
-				'error',
-				{
-					vars: 'all',
-					args: 'none',
-					ignoreRestSiblings: false,
-				},
-			],
-		},
-	},
-	{
-		files: ['test/**', '**/example.js'],
-		rules: {
-			'no-unused-vars': 'off',
-			'@stylistic/semi': 'off',
-		},
-	},
-];
-
-export default config;

format/date.js

@@ -16,7 +16,7 @@ const formatDate = (profile, when) => {
 			locale: profile.locale,
 			zone: timezone,
 		})
-		.toFormat('yyyy-MM-dd');
+		.toFormat('yyyyMMdd');
 };
 
 export {

format/filters.js

@@ -0,0 +1,12 @@
+const bike = {type: 'BC', mode: 'INC'};
+
+const accessibility = {
+	none: {type: 'META', mode: 'INC', meta: 'notBarrierfree'},
+	partial: {type: 'META', mode: 'INC', meta: 'limitedBarrierfree'},
+	complete: {type: 'META', mode: 'INC', meta: 'completeBarrierfree'},
+};
+
+export {
+	bike,
+	accessibility,
+};

format/lines-req.js

@@ -0,0 +1,12 @@
+const formatLinesReq = (ctx, query) => {
+	return {
+		meth: 'LineMatch',
+		req: {
+			input: query,
+		},
+	};
+};
+
+export {
+	formatLinesReq,
+};

format/location-filter.js

@@ -0,0 +1,14 @@
+const formatLocationFilter = (stops, addresses, poi) => {
+	if (stops && addresses && poi) {
+		return 'ALL';
+	}
+	return (
+		(stops ? 'S' : '')
+		+ (addresses ? 'A' : '')
+		+ (poi ? 'P' : '')
+	);
+};
+
+export {
+	formatLocationFilter,
+};

format/locations-req.js

@@ -0,0 +1,22 @@
+const formatLocationsReq = (ctx, query) => {
+	const {profile, opt} = ctx;
+
+	return {
+		cfg: {polyEnc: 'GPA'},
+		meth: 'LocMatch',
+		req: {input: {
+			loc: {
+				type: profile.formatLocationFilter(opt.stops, opt.addresses, opt.poi),
+				name: opt.fuzzy
+					? query + '?'
+					: query,
+			},
+			maxLoc: opt.results,
+			field: 'S', // todo: what is this?
+		}},
+	};
+};
+
+export {
+	formatLocationsReq,
+};

format/loyalty-cards.js

@@ -1,65 +0,0 @@
-const c = {
-	NONE: Symbol('no loyalty card'),
-	BAHNCARD: Symbol('Bahncard'),
-	VORTEILSCARD: Symbol('VorteilsCard'),
-	HALBTAXABO: Symbol('HalbtaxAbo'),
-	VOORDEELURENABO: Symbol('Voordeelurenabo'),
-	SHCARD: Symbol('SH-Card'),
-	GENERALABONNEMENT: Symbol('General-Abonnement'),
-	NL_40: Symbol('NL-40%'),
-	AT_KLIMATICKET: Symbol('AT-KlimaTicket'),
-};
-
-const formatLoyaltyCard = (data) => {
-	if (!data) {
-		return {
-			art: 'KEINE_ERMAESSIGUNG',
-			klasse: 'KLASSENLOS',
-		};
-	}
-	const cls = data.class === 1 ? 'KLASSE_1' : 'KLASSE_2';
-	if (data.type.toString() === c.BAHNCARD.toString()) {
-		return {
-			art: 'BAHNCARD' + (data.business ? 'BUSINESS' : '') + data.discount,
-			klasse: cls,
-		};
-	}
-	if (data.type.toString() === c.VORTEILSCARD.toString()) {
-		return {
-			art: 'A-VORTEILSCARD',
-			klasse: 'KLASSENLOS',
-		};
-	}
-	if (data.type.toString() === c.HALBTAXABO.toString()) {
-		return {
-			art: 'CH-HALBTAXABO_OHNE_RAILPLUS',
-			klasse: 'KLASSENLOS',
-		};
-	}
-	if (data.type.toString() === c.GENERALABONNEMENT.toString()) {
-		return {
-			art: 'CH-GENERAL-ABONNEMENT',
-			klasse: cls,
-		};
-	}
-	if (data.type.toString() === c.NL_40.toString()) {
-		return {
-			art: 'NL-40_OHNE_RAILPLUS',
-			klasse: 'KLASSENLOS',
-		};
-	}
-	if (data.type.toString() === c.AT_KLIMATICKET.toString()) {
-		return {
-			art: 'KLIMATICKET_OE',
-			klasse: 'KLASSENLOS',
-		};
-	}
-	return {
-		art: 'KEINE_ERMAESSIGUNG',
-		klasse: 'KLASSENLOS',
-	};
-};
-export {
-	c as data,
-	formatLoyaltyCard,
-};

format/nearby-req.js

@@ -0,0 +1,28 @@
+const formatNearbyReq = (ctx, location) => {
+	const {profile, opt} = ctx;
+
+	return {
+		cfg: {polyEnc: 'GPA'},
+		meth: 'LocGeoPos',
+		req: {
+			ring: {
+				cCrd: {
+					x: profile.formatCoord(location.longitude),
+					y: profile.formatCoord(location.latitude),
+				},
+				maxDist: opt.distance || -1,
+				minDist: 0,
+			},
+			locFltrL: [
+				profile.formatProductsFilter(ctx, opt.products || {}),
+			],
+			getPOIs: Boolean(opt.poi),
+			getStops: Boolean(opt.stops),
+			maxLoc: opt.results,
+		},
+	};
+};
+
+export {
+	formatNearbyReq,
+};

format/products-filter.js

@@ -1,8 +1,8 @@
-const isObj = element => element !== null && 'object' === typeof element && !Array.isArray(element);
+import isObj from 'lodash/isObject.js';
 
 const hasProp = (o, k) => Object.prototype.hasOwnProperty.call(o, k);
 
-const formatProductsFilter = (ctx, filter, key = 'vendo') => {
+const formatProductsFilter = (ctx, filter) => {
 	if (!isObj(filter)) {
 		throw new TypeError('products filter must be an object');
 	}
@@ -16,29 +16,28 @@ const formatProductsFilter = (ctx, filter, key = 'vendo') => {
 	}
 	filter = Object.assign({}, defaultProducts, filter);
 
-	let products = [];
+	let res = 0, products = 0;
-	let foundDeselected = false;
 	for (let product in filter) {
 		if (!hasProp(filter, product) || filter[product] !== true) {
-			foundDeselected = true;
 			continue;
 		}
 		if (!byProduct[product]) {
 			throw new TypeError('unknown product ' + product);
 		}
-		products.push(byProduct[product][key]);
+		products++;
+		for (let bitmask of byProduct[product].bitmasks) {
+			res = res | bitmask;
+		}
 	}
-	if (products.length === 0) {
+	if (products === 0) {
 		throw new Error('no products used');
 	}
-	if (!foundDeselected && key == 'ris') {
-		return undefined;
-	}
-	if (!foundDeselected && key == 'dbnav') {
-		return ['ALL'];
-	}
 
-	return products;
+	return {
+		type: 'PROD',
+		mode: 'INC',
+		value: String(res),
+	};
 };
 
 export {

format/radar-req.js

@@ -0,0 +1,29 @@
+const formatRadarReq = (ctx, north, west, south, east) => {
+	const {profile, opt} = ctx;
+
+	return {
+		meth: 'JourneyGeoPos',
+		req: {
+			maxJny: opt.results,
+			onlyRT: false, // todo: does this mean "only realtime"?
+			date: profile.formatDate(profile, opt.when),
+			time: profile.formatTime(profile, opt.when),
+			// todo: would a ring work here as well?
+			rect: profile.formatRectangle(profile, north, west, south, east),
+			perSize: opt.duration * 1000,
+			perStep: Math.round(opt.duration / Math.max(opt.frames, 1) * 1000),
+			ageOfReport: true, // todo: what is this?
+			jnyFltrL: [
+				profile.formatProductsFilter(ctx, opt.products || {}),
+			],
+			// todo: what is this? what about realtime?
+			// - CALC
+			// - CALC_REPORT (as seen in the INSA Young app)
+			trainPosMode: 'CALC',
+		},
+	};
+};
+
+export {
+	formatRadarReq,
+};

format/reachable-from-req.js

@@ -0,0 +1,24 @@
+const formatReachableFromReq = (ctx, address) => {
+	const {profile, opt} = ctx;
+
+	return {
+		meth: 'LocGeoReach',
+		req: {
+			loc: profile.formatLocation(profile, address, 'address'),
+			maxDur: opt.maxDuration === null
+				? -1
+				: opt.maxDuration,
+			maxChg: opt.maxTransfers,
+			date: profile.formatDate(profile, opt.when),
+			time: profile.formatTime(profile, opt.when),
+			period: 120, // todo: what is this?
+			jnyFltrL: [
+				profile.formatProductsFilter(ctx, opt.products || {}),
+			],
+		},
+	};
+};
+
+export {
+	formatReachableFromReq,
+};

format/rectangle.js

@@ -0,0 +1,16 @@
+const formatRectangle = (profile, north, west, south, east) => {
+	return {
+		llCrd: {
+			x: profile.formatCoord(west),
+			y: profile.formatCoord(south),
+		},
+		urCrd: {
+			x: profile.formatCoord(east),
+			y: profile.formatCoord(north),
+		},
+	};
+};
+
+export {
+	formatRectangle,
+};

format/refresh-journey-req.js

@@ -0,0 +1,24 @@
+const formatRefreshJourneyReq = (ctx, refreshToken) => {
+	const {profile, opt} = ctx;
+
+	const req = {
+		getIST: true, // todo: make an option
+		getPasslist: Boolean(opt.stopovers),
+		getPolyline: Boolean(opt.polylines),
+		getTariff: Boolean(opt.tickets),
+	};
+	if (profile.refreshJourneyUseOutReconL) {
+		req.outReconL = [{ctx: refreshToken}];
+	} else {
+		req.ctxRecon = refreshToken;
+	}
+
+	return {
+		meth: 'Reconstruction',
+		req,
+	};
+};
+
+export {
+	formatRefreshJourneyReq,
+};

format/remarks-req.js

@@ -0,0 +1,38 @@
+const formatRemarksReq = (ctx) => {
+	const {profile, opt} = ctx;
+
+	const himFltrL = [];
+	// todo: https://github.com/marudor/BahnhofsAbfahrten/blob/95fef0217d01344642dd423457473fe9b8b6056e/src/types/HAFAS/index.ts#L76-L91
+	if (opt.products) {
+		himFltrL.push(profile.formatProductsFilter(ctx, opt.products));
+	}
+
+	const req = {
+		himFltrL,
+	};
+	if (profile.remarksGetPolyline) {
+		req.getPolyline = Boolean(opt.polylines);
+	}
+	// todo: stLoc, dirLoc
+	// todo: comp, dept, onlyHimId, onlyToday
+	// todo: dailyB, dailyE
+	// see https://github.com/marudor/BahnhofsAbfahrten/blob/46a74957d68edc15713112df44e1a25150f5a178/src/types/HAFAS/HimSearch.ts#L3-L18
+
+	if (opt.results !== null) {
+		req.maxNum = opt.results;
+	}
+	if (opt.from !== null) {
+		req.dateB = profile.formatDate(profile, opt.from);
+		req.timeB = profile.formatTime(profile, opt.from);
+	}
+	if (opt.to !== null) {
+		req.dateE = profile.formatDate(profile, opt.to);
+		req.timeE = profile.formatTime(profile, opt.to);
+	}
+
+	return {meth: 'HimSearch', req};
+};
+
+export {
+	formatRemarksReq,
+};

format/station-board-req.js

@@ -0,0 +1,42 @@
+const formatStationBoardReq = (ctx, station, type) => {
+	const {profile, opt} = ctx;
+
+	const jnyFltrL = [
+		profile.formatProductsFilter(ctx, opt.products || {}),
+	];
+	if (opt.line !== null) {
+		jnyFltrL.push({type: 'LINEID', mode: 'INC', value: opt.line});
+	}
+
+	const req = {
+		type,
+		date: profile.formatDate(profile, opt.when),
+		time: profile.formatTime(profile, opt.when),
+		stbLoc: station,
+		dirLoc: opt.direction
+			? profile.formatStation(opt.direction)
+			: undefined,
+		jnyFltrL,
+		dur: opt.duration,
+	};
+	if (opt.results !== null) {
+		req.maxJny = opt.results === Infinity
+			? 10000
+			: opt.results;
+	}
+	if (profile.departuresGetPasslist) {
+		req.getPasslist = Boolean(opt.stopovers);
+	}
+	if (profile.departuresStbFltrEquiv) {
+		req.stbFltrEquiv = !opt.includeRelatedStations;
+	}
+
+	return {
+		meth: 'StationBoard',
+		req,
+	};
+};
+
+export {
+	formatStationBoardReq,
+};

format/station.js

@@ -1,11 +1,6 @@
 import {formatLocationIdentifier} from './location-identifier.js';
 
-const isIBNR = /^\d{6,}$/;
-
 const formatStation = (id) => {
-	if (!isIBNR.test(id)) {
-		throw new Error('station ID must be an IBNR.');
-	}
 	return {
 		type: 'S', // station
 		// todo: name necessary?

format/stop-req.js

@@ -0,0 +1,13 @@
+const formatStopReq = (ctx, stopRef) => {
+	return {
+		// todo: there's also `StationDetails`, are there differences?
+		meth: 'LocDetails',
+		req: {
+			locL: [stopRef],
+		},
+	};
+};
+
+export {
+	formatStopReq,
+};

format/time.js

@@ -1,7 +1,8 @@
 import {DateTime, IANAZone} from 'luxon';
 import {luxonIANAZonesByProfile as timezones} from '../lib/luxon-timezones.js';
 
-const getTimezone = (profile) => {
+// todo: change to `(profile) => (when) => {}`
+const formatTime = (profile, when) => {
 	let timezone;
 	if (timezones.has(profile)) {
 		timezone = timezones.get(profile);
@@ -9,35 +10,15 @@ const getTimezone = (profile) => {
 		timezone = new IANAZone(profile.timezone);
 		timezones.set(profile, timezone);
 	}
-	return timezone;
-};
-
-const formatTime = (profile, when, includeOffset = false) => {
-	const timezone = getTimezone(profile);
 
 	return DateTime
 		.fromMillis(Number(when), {
 			locale: profile.locale,
 			zone: timezone,
 		})
-		.startOf('second')
+		.toFormat('HHmmss');
-		.toISO({includeOffset: includeOffset, suppressMilliseconds: true});
-};
-
-const formatTimeOfDay = (profile, when) => {
-	const timezone = getTimezone(profile);
-
-	return DateTime
-		.fromMillis(Number(when), {
-			locale: profile.locale,
-			zone: timezone,
-		})
-		.toFormat('HH:mm');
 };
 
 export {
 	formatTime,
-	formatTimeOfDay,
 };
-
-

format/transfers.js

@@ -1,10 +0,0 @@
-const formatTransfers = (transfers) => {
-	if (transfers === -1) { // profiles may not accept -1: https://github.com/public-transport/db-vendo-client/issues/5
-		return undefined;
-	}
-	return transfers;
-};
-
-export {
-	formatTransfers,
-};

format/travellers.js

@@ -1,48 +0,0 @@
-const formatTraveller = ({profile}, ageGroup, age, loyaltyCard) => {
-	const tvlrAgeGroup = age
-		? profile.ageGroupFromAge(age)
-		: ageGroup;
-	let r = {
-		typ: profile.ageGroupLabel[tvlrAgeGroup || profile.ageGroup.ADULT],
-		anzahl: 1,
-		alter: age
-			? [String(age)]
-			: [],
-		ermaessigungen: [profile.formatLoyaltyCard(loyaltyCard)],
-	};
-	return r;
-};
-
-const validateArr = (field, length) => {
-	return !field || Array.isArray(field) && field.length == length;
-};
-
-const formatTravellers = ({profile, opt}) => {
-	if ('age' in opt && 'ageGroup' in opt) {
-		throw new TypeError(`\
-opt.age and opt.ageGroup are mutually exclusive.
-Pass in just opt.age, and the age group will calculated automatically.`);
-	}
-	let travellers = [];
-	if (Array.isArray(opt.loyaltyCard) || Array.isArray(opt.age) || Array.isArray(opt.ageGroup)) {
-		const len = opt.loyaltyCard?.length || opt.age?.length || opt.ageGroup?.length;
-		if (!validateArr(opt.loyaltyCard, len) || !validateArr(opt.age, len) || !validateArr(opt.ageGroup, len)) {
-			throw new TypeError('If any of loyaltyCard, age or ageGroup are an array, all given must be an array of the same length.');
-		}
-		for (let i = 0; i < len; i++) {
-			travellers.push(formatTraveller({profile}, opt.ageGroup && opt.ageGroup[i], opt.age && opt.age[i], opt.loyaltyCard && opt.loyaltyCard[i]));
-		}
-	} else {
-		travellers.push(formatTraveller({profile}, opt.ageGroup, opt.age, opt.loyaltyCard));
-	}
-
-	const basicCtrfReq = {
-		klasse: opt.firstClass === true ? 'KLASSE_1' : 'KLASSE_2',
-		reisende: travellers,
-	};
-	return basicCtrfReq;
-};
-
-export {
-	formatTravellers,
-};

format/trip-req.js

@@ -0,0 +1,18 @@
+const formatTripReq = ({opt}, id) => {
+	return {
+		cfg: {polyEnc: 'GPA'},
+		meth: 'JourneyDetails',
+		req: {
+			// todo: getTrainComposition
+			jid: id,
+			// HAFAS apparently ignores the date in the trip ID and uses the `date` field.
+			// Thus, it will find a different trip if you pass the wrong date via `opt.when`.
+			// date: profile.formatDate(profile, opt.when),
+			getPolyline: Boolean(opt.polyline),
+		},
+	};
+};
+
+export {
+	formatTripReq,
+};