Migration guide to version 2.0.0

[enjaku4]

This guide covers the breaking changes in Veri 2.0 and how to migrate your application.

Database Migration

Add the original_tenant polymorphic reference to the veri_sessions table:

add_reference :veri_sessions, :original_tenant, polymorphic: true, index: true

For UUID primary keys, add type: :uuid.

Breaking Changes

Veri::Session#shapeshift Method Signature

The shapeshift method now accepts an optional tenant: keyword argument for cross-tenant impersonation in multi-tenant applications.

# Single-tenant or same-tenant impersonation (unchanged)
session.shapeshift(user)

# Cross-tenant impersonation (new)
session.shapeshift(user, tenant: other_company)

Veri::Session.prune Behavior

Veri::Session.prune no longer removes expired or inactive sessions. It now only removes sessions with orphaned tenants.

# Before: removed expired, inactive, AND orphaned tenant sessions
Veri::Session.prune

# After: only removes orphaned tenant sessions
Veri::Session.prune

# Use scopes to clean up expired/inactive sessions
Veri::Session.expired.terminate_all
Veri::Session.inactive.terminate_all