locator

type AuthoritativeLocator ¶ added in v0.2.0

type AuthoritativeLocator interface{ Owns(string) bool }

AuthoritativeLocator distinguishes an owned absence from provider fallback.

type BodyNullPolicyLocator ¶ added in v0.4.0

type BodyNullPolicyLocator interface {
	ValueWithBodyNullPolicy(context.Context, reflect.Type, string, string) (any, bool, error)
}

BodyNullPolicyLocator recognizes body null in its native source decoder. The policy is invocation-local: implementations must never mutate a provider or treat an arbitrary provider's nil value as evidence of JSON literal null.

type CachePolicy ¶ added in v0.2.0

type CachePolicy interface{ DefaultCacheable() bool }

type Locator ¶

type Locator interface {
	Value(ctx context.Context, targetType reflect.Type, name string) (interface{}, bool, error)
	Kind() string
}

type MetadataScope ¶ added in v0.2.0

type MetadataScope interface{ MetadataRequested() bool }

MetadataScope is an optional capability; existing Scope implementations need not implement it. Providers may avoid producing metadata unless requested.

type Provider ¶

type Provider interface {
	Locate(state *structology.State) Locator
	Kind() string
	Priority() int
}

func ComposeProviders(kind string, layers ...ProviderLayer) (Provider, error)

type ProviderLayer ¶ added in v0.2.0

type ProviderLayer struct {
	Name     string
	Provider Provider
}

type Registry ¶

type Registry struct {
	internal.Map[string, Provider]
	// contains filtered or unexported fields
}

func NewRegistry() *Registry

func (r *Registry) Child() *Registry

func (r *Registry) Keys() []string

func (r *Registry) Lookup(kind string) (Provider, bool)

func (r *Registry) Register(provider Provider) error

func (r *Registry) Unregister(kind string)

type Resolver ¶

type Resolver interface {
	Value(ctx context.Context, location *state.Location) (interface{}, bool, error)
}

type Scope ¶ added in v0.2.0

type Scope interface {
	Resolver
	Bind(context.Context, any) error
	BindTarget(context.Context, any) error
}

type ScopedLocator ¶ added in v0.2.0

type ScopedLocator interface {
	Locator
	ValueInScope(context.Context, Scope, reflect.Type, string) (any, bool, error)
}

type SourceCapturer ¶ added in v0.2.0

type SourceCapturer interface {
	CaptureSource(context.Context, reflect.Type, string) (any, bool, error)
}

SourceCapturer lets a source preserve its raw representation before target decoding (for example JSON body omission/number precision). JSON source bytes use json.RawMessage; other values retain normal declared source conversion. Implementations must not bind targets or evaluate downstream dependencies.

type ValueWithMetadata ¶ added in v0.2.0

type ValueWithMetadata struct {
	Value    any
	Metadata any
}

ValueWithMetadata is a reserved provider result envelope. Bindly exposes Value through its ordinary APIs and transports Metadata only to an opt-in observer. Metadata is opaque, invocation-scoped, and must be immutable or otherwise safe for all consumers of a cached resolution. It is never serialized by Bindly.