postgres

package

v0.17.0 Latest Latest Go to latest Published: Feb 11, 2026 License: Apache-2.0 Imports: 7 Imported by: 0

Details

Package postgres provides PostgreSQL storage for audit logs.

This section is empty.

This section is empty.

This section is empty.

type Config struct {
	RetentionDays int
}

Config configures the PostgreSQL audit store.

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

Store implements audit.Logger using PostgreSQL.

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

New creates a new PostgreSQL audit store.

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

Cleanup removes audit logs older than retention period.

func (s *Store) Close() error

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

func (s *Store) Count(ctx context.Context, filter audit.QueryFilter) (int, error)

Count returns the number of audit events matching the filter.

func (s *Store) Log(ctx context.Context, event audit.Event) error

Log records an audit event.

func (s *Store) Query(ctx context.Context, filter audit.QueryFilter) ([]audit.Event, error)

Query retrieves audit events matching the filter.

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

StartCleanupRoutine starts a background goroutine that periodically deletes old audit logs. The goroutine is stopped when Close is called.