storage

type Capabilities ¶

type Capabilities struct {
	SupportsReload bool
	ReadReplicas   bool
	MultiTenant    bool
	Metadata       map[string]any
}

Capabilities documents optional behaviours supported by a provider.

type CapabilityReporter ¶

type CapabilityReporter interface {
	Capabilities() Capabilities
}

CapabilityReporter exposes optional provider features (e.g., read replicas, sharding) so repositories can make runtime decisions.

type Config ¶

type Config struct {
	Name     string
	Driver   string
	DSN      string
	ReadOnly bool
	Options  map[string]any
}

Config captures the runtime configuration for a storage provider. Detailed schema validation is handled by higher layers (runtimeconfig/admin services).

type Profile ¶

type Profile struct {
	Name        string            `json:"name"`
	Description string            `json:"description,omitempty"`
	Provider    string            `json:"provider"`
	Config      Config            `json:"config"`
	Fallbacks   []string          `json:"fallbacks,omitempty"`
	Labels      map[string]string `json:"labels,omitempty"`
	Default     bool              `json:"default,omitempty"`
}

Profile captures a named storage configuration that can be referenced by repositories at runtime. Future phases will persist these profiles and drive hot-swap mechanics based on admin updates.

type Provider ¶

type Provider interface {
	Query(ctx context.Context, query string, args ...any) (Rows, error)
	Exec(ctx context.Context, query string, args ...any) (Result, error)
	Transaction(ctx context.Context, fn func(tx Transaction) error) error
}

Provider encapsulates the operations required by go-cms repositories. It embeds the legacy StorageProvider contract and adds optional hooks that dynamic implementations can satisfy to support runtime reconfiguration.

type Reloadable ¶

type Reloadable interface {
	Reload(ctx context.Context, cfg Config) error
}

Reloadable providers can apply a new configuration at runtime. Implementations that do not support reloads may omit this interface; the container will keep using the existing provider.

type Result ¶

type Result interface {
	RowsAffected() (int64, error)
	LastInsertId() (int64, error)
}

type Rows ¶

type Rows interface {
	Next() bool
	Scan(dest ...any) error
	Close() error
}

type Transaction ¶

type Transaction interface {
	Provider
	Commit() error
	Rollback() error
}