postgres

package

v0.16.1 Latest Latest Go to latest Published: Feb 10, 2026 License: Apache-2.0 Imports: 6 Imported by: 0

Details

Package postgres provides PostgreSQL storage for sessions.

This section is empty.

This section is empty.

This section is empty.

type Config struct {
	TTL time.Duration
}

Config configures the PostgreSQL session store.

type Store struct {
	// contains filtered or unexported fields
}

Store implements session.Store using PostgreSQL.

func New(db *sql.DB, cfg Config) *Store

New creates a new PostgreSQL session store.

func (s *Store) Cleanup(ctx context.Context) error

Cleanup removes expired sessions.

func (s *Store) Close() error

Close stops the cleanup goroutine and waits for it to exit. It is safe to call Close even if StartCleanupRoutine was never called.

func (s *Store) Create(ctx context.Context, sess *session.Session) error

Create persists a new session.

func (s *Store) Delete(ctx context.Context, id string) error

Delete removes a session.

func (s *Store) Get(ctx context.Context, id string) (*session.Session, error)

Get retrieves a session by ID. Returns nil, nil if not found or expired.

func (s *Store) List(ctx context.Context) ([]*session.Session, error)

List returns all non-expired sessions.

func (s *Store) StartCleanupRoutine(interval time.Duration)

StartCleanupRoutine starts a background goroutine that periodically removes expired sessions. The goroutine is stopped when Close is called.

func (s *Store) Touch(ctx context.Context, id string) error

Touch updates LastActiveAt and extends ExpiresAt by the store's TTL.

func (s *Store) UpdateState(ctx context.Context, id string, state map[string]any) error

UpdateState merges state into the session's State map using JSONB concatenation.