rm-hull / dot-block / 23951399368

40%

Build Type

push

github

Committed by web-flow

Commit Message

feat: add automated IP2Location database updates (#96)

* feat: add automated IP2Location database updates

- Introduce `GeoIpLookup` wrapper with `RWMutex` to support
hot-reloading
  of the IP2Location database.
- Add an automated cron job to fetch and reload the database monthly.
- Update `.env.example` to include necessary API tokens.
- Refactor `GetAll` method usage across the codebase.

```mermaid
sequenceDiagram
    participant C as Cron Job
    participant F as Fetcher
    participant G as GeoIpLookup
    participant DB as File System

    C->>F: Run()
    F->>DB: Download latest .BIN file
    C->>G: Reopen()
    G->>DB: Open new .BIN file
    G->>G: Swap DB handles
    G->>G: Close old DB handle
```

* feat: integrate IP2Location auto-update cron job

- Initialize the cron scheduler earlier in the application startup.
- Register the `Ip2LocationUpdaterCronJob` to handle periodic database
  updates.
- Reorder initialization logic to ensure dependencies are available
  before job scheduling.

```mermaid
sequenceDiagram
    participant App
    participant Cron
    participant IP2LocationUpdater

    App->>Cron: New()
    App->>IP2LocationUpdater: New(geoIpLookup)
    App->>Cron: AddJob(schedule, updater)
    Cron->>Cron: Start()
```

* fix: return error when geoblock db is uninitialized

Return a concrete error instead of an empty record
when the database is nil. This prevents silent
failures in services consuming the `GetAll` method.

* docs: add ip2location cron schedule to readme

Document the `--cron-schedule:ip2location` configuration option and its
default monthly execution schedule.

Run Details

1 of 63 new or added lines in 5 files covered. (1.59%)

51 existing lines in 3 files now uncovered.

495 of 1232 relevant lines covered (40.18%)

0.43 hits per line