persistence

type Record struct {
	// ID is the session identifier associated with this stored record.
	ID string `json:"id"`
	// CreatedAt anchors maximum-lifetime checks across session renewals.
	CreatedAt time.Time `json:"created_at"`
	// ExpiresAt is the current idle-expiration deadline persisted with the
	// session.
	ExpiresAt time.Time `json:"expires_at"`
	// Storage contains session values; the decoding view retains raw JSON until
	// typed lookup.
	Storage map[string]any `json:"storage"`

	// Tombstone marks an ID that was retired by logout, destroy, or
	// regeneration. Records written before tombstones existed lack the field
	// and load as live sessions.
	Tombstone bool `json:"tombstone,omitempty"`
}

type Store struct {
	// driver holds the session records.
	Driver cache.Driver

	// locks reduces conflicts between saves and tombstones. Atomic guarded
	// writes, not these expiring leases, enforce retirement correctness.
	Locks *cache.Cache

	// space names JSON records without changing the asymmetric session codec.
	Space cache.Namespace[jsontext.Value]
}