multitenant

package

v0.24.0 Latest Latest Go to latest Published: Feb 7, 2026 License: MIT Imports: 5 Imported by: 0

Details

This section is empty.

View Source

var ErrTenantResolutionFailed = errors.New("tenant resolution failed")

ErrTenantResolutionFailed is returned when a resolver cannot determine the tenant identifier.

func GetTenant(ctx context.Context) (string, bool)

GetTenant extracts the tenant identifier from the context.

func SetTenant(ctx context.Context, tenantID string) context.Context

SetTenant stores the tenant identifier in the provided context.

type CompositeResolver struct {
	Resolvers   []TenantResolver
	TenantRegex *regexp.Regexp // Optional validation pattern
}

CompositeResolver tries multiple resolvers until one succeeds.

func (r *CompositeResolver) ResolveTenant(ctx context.Context, req *http.Request) (string, error)

ResolveTenant implements TenantResolver.

type HeaderResolver struct {
	HeaderName string
}

HeaderResolver extracts the tenant identifier from a configured request header.

func (r *HeaderResolver) ResolveTenant(ctx context.Context, req *http.Request) (string, error)

ResolveTenant implements TenantResolver.

type SubdomainResolver struct {
	RootDomain   string
	TrustProxies bool
}

SubdomainResolver extracts the tenant identifier from the request host.

func (r *SubdomainResolver) ResolveTenant(ctx context.Context, req *http.Request) (string, error)

ResolveTenant implements TenantResolver.

type TenantResolver interface {
	ResolveTenant(ctx context.Context, req *http.Request) (string, error)
}

TenantResolver resolves the tenant identifier from an incoming request.

type ValidatingResolver struct {
	Resolver    TenantResolver
	TenantRegex *regexp.Regexp
}

ValidatingResolver wraps any resolver with tenant ID validation.

func (r *ValidatingResolver) ResolveTenant(ctx context.Context, req *http.Request) (string, error)

ResolveTenant implements TenantResolver with validation.