1
28%
main: 28%

Ran 06 May 2026 09:18PM UTC

Files 19

Run time 0s

Badge

Embed ▾

Committed 06 May 2026 09:17PM UTC coverage: 28.278% (+0.2%) from 28.031%

Job # 25461678005.1

Build Type

push

github

Committed by

web-flow

Commit Message

feat: add Traveline fallback for SIRI rate limits (#14)

Implement a fallback mechanism to fetch bus departures from Traveline
when the primary SIRI API exceeds its usage limits. This ensures service
availability even after the daily TransportAPI quota is exhausted.

-   Introduces `FallbackManager` to track rate-limit state.
- Adds `TravelineClient` to scrape live departures from the Traveline
website.
- Includes a daily **CRON** job to reset the fallback state at midnight.
-   Updates `NextDepartures` route to automatically switch providers.

Fixes #12 

```mermaid
sequenceDiagram
    participant User
    participant API as API Server
    participant SIRI as SIRI API
    participant FM as Fallback Manager
    participant TVL as Traveline

    User->>API: GET /v1/next-departures/:id
    API->>FM: IsSiriRateLimited?
    alt No
        API->>SIRI: Request departures
        alt Success
            SIRI-->>API: Departure data
        else Rate Limited (429/403)
            SIRI-->>API: Limit Exceeded
            API->>FM: SetSiriRateLimited(true)
            API->>TVL: Scrape departures
            TVL-->>API: Fallback data
        end
    else Yes
        API->>TVL: Scrape departures
        TVL-->>API: Fallback data
    end
    API-->>User: JSON Response
```

Coverage Stats

317 of 1121 relevant lines covered (28.28%)

0.31 hits per line

rm-hull / next-departures-api / 25461678005 / 1
28%
main: 28%

README BADGES
x

Markdown

Textile

RDoc

HTML

Rst

Source Files on job 25461678005.1

rm-hull / next-departures-api / 25461678005 / 1 28% main: 28%

README BADGES x

Markdown

Textile

RDoc

HTML

Rst

Source Files on job 25461678005.1

rm-hull / next-departures-api / 25461678005 / 1
28%
main: 28%

README BADGES
x