Class IpManager

The active license tier. Resolves to 'free' until init completes.

Close and release MaxMind file handles.

Enrich an IP address for a given deviceId. Saves a snapshot and returns the enrichment + risk delta.

Free-tier callers are limited to FREE_TIER_MAX_DEVICES unique devices. When the cap is reached, snapshots for new device IDs are silently dropped and a console warning is emitted.

Returns the full IP history for a deviceId.

Explicitly initialise enrichers (opens mmdb files, fetches Tor list) and validates the Polar license key if one was supplied.

Call this once at application startup before processing requests. Safe to await multiple times — subsequent calls return the cached promise.

Registers this IpManager with a DeviceManager instance by wrapping its identify method. Any call to deviceManager.identify(data, { ip, headers, ... }) will automatically enrich the result with IP signals.