Write a Custom Storage Backend

​

The Storage interface

​

The storagetest package

package mystorage_test

import (
    "testing"

    "github.com/glincker/theauth-go/v2/storagetest"
    "myapp/mystorage"
)

func TestConformance(t *testing.T) {
    store := mystorage.New(/* your config */)
    storagetest.Run(t, store)
}

​

Extension interfaces

type OAuthServerStorage interface {
    Storage
    // OAuth clients, authorization codes, refresh tokens,
    // JWKS keys, agents, delegation grants, etc.
}

​

Stability note

​

Migration append-only rule

​

Tips

• Use the in-memory adapter as a reference implementation. It is well-commented and covers every interface method.
• Use storage/postgres for understanding the expected SQL semantics (keyset pagination, UPSERT patterns, etc.).
• The conformance suite tests edge cases like duplicate key errors, not-found errors, and pagination cursor behavior. Pass it before shipping.