Údaje o zariadení a polohe

Balík nikdy neparsuje user agent ani nezisťuje polohu IP adresy — už spracované údaje dodáva aplikácia cez dve DTO:

use RoundlyConsulting\RefreshTokens\DataTransferObjects\DeviceData;
use RoundlyConsulting\RefreshTokens\DataTransferObjects\LocationData;
use RoundlyConsulting\RefreshTokens\Enums\DeviceType;

// Pass the RefreshToken model you already hold, or its id:
RefreshTokens::session($new->token)->enrich(
    new DeviceData(browser: 'Firefox', os: 'Linux', deviceType: DeviceType::Desktop, isBot: false),
    new LocationData(country: 'Slovakia', city: 'Bratislava', countryCode: 'SK', ipAddress: '203.0.113.9'),
);

• DeviceData — browser, browserVersion, os, osVersion, deviceType (prípad DeviceType alebo reťazec) a isBot. Všetko voliteľné.
• LocationData — country, city, countryCode a ipAddress. Všetko voliteľné.

Pravidlá zápisu

• session() prijíma model RefreshToken, celé číslo alebo reťazcový kľúč; neznámy kľúč vyhodí SessionNotFoundException.
• Mení len stĺpce zariadenia a polohy — nikdy token_hash, revoked_at, expires_at, access_reference ani family_id.
• Šesť stĺpcov zariadenia sa vždy prepíše — chýbajúce pole DeviceData nastaví svoj stĺpec na null.
• Stĺpce polohy sa zapíšu len vtedy, keď odovzdáte LocationData, takže neskoršie obohatenie len o zariadenie neprepíše uloženú polohu.
• Doplnené údaje sa pri rotácii prenesú do každej náhrady.

Asynchrónne obohatenie

Napojte sa na RefreshTokenIssued a spracovanie presuňte mimo požiadavky:

use Illuminate\Support\Facades\Event;
use RoundlyConsulting\RefreshTokens\Events\RefreshTokenIssued;

Event::listen(function (RefreshTokenIssued $event): void {
    // queue your own job: parse the user agent, geolocate the IP,
    // then call RefreshTokens::session($event->tokenId)->enrich($device, $location)
});