Class: TrackRelay::ClientId::Session

Inherits:

Object

• Object
• TrackRelay::ClientId::Session

Defined in:

lib/track_relay/client_id/session.rb

Overview

Last-resort resolver that mints a session-stable UUID when no other resolver in the chain produced a client_id.

Default position-2 (final) entry in TrackRelay::Configuration#client_id_resolvers. Stores the generated UUID at ‘session` so subsequent requests on the same Rails session reuse the same value — every visitor gets a consistent client_id even if they have no `_ga` cookie and no Ahoy visit record.

## Storage

Uses the host app’s standard session store (cookie store, Redis, ActiveRecord, etc.) — whatever ‘controller.session` provides. The value is a plain UUID string; no signing or encryption is required (it has no security implications).

## Sessionless contexts

API-only controllers without session middleware (and any controller-less context) have ‘controller.session == nil`. The resolver returns `nil` in that case and the chain falls through to whatever follows — or to `nil` overall, leaving Current.client_id unset (the same outcome as Phase 01).

Constant Summary

SESSION_KEY =

:track_relay_client_id

Instance Method Summary

• #call(controller:) ⇒ String^?

  A stable UUID, or ‘nil` when no session is available.

Instance Method Details

#call(controller:) ⇒ String^?

Returns a stable UUID, or ‘nil` when no session is available.

Parameters:

• controller (#session) —

  any controller-like object with a Rails-style session hash.

Returns:

• (String, nil) —

  a stable UUID, or ‘nil` when no session is available.

# File 'lib/track_relay/client_id/session.rb', line 38

def call(controller:, **)
  session = controller&.session
  return nil unless session

  session[SESSION_KEY] ||= SecureRandom.uuid
end