ConfigCat

Load a ConfigCat setting’s value as config.

Install

go get github.com/xavidop/mamori/providers/configcat

import _ "github.com/xavidop/mamori/providers/configcat"

Using the ref

A configcat:// ref points at one setting key. It resolves to that setting’s evaluated value.

configcat://<setting-key>

The value maps to bytes by type: a boolean setting resolves to true / false, a string to its string, a number to its decimal form. A key not present in the config resolves to not-found (mamori does not silently return the SDK default for a missing key).

Examples

• configcat://isAwesomeFeatureEnabled resolves to true / false - pair it with a bool field.
• configcat://maxUploadSizeMB resolves to e.g. 50 - pair it with an int field.

Close() is idempotent and terminal: after it returns, every Resolve reports errors.Is(err, mamori.ErrUnavailable) locally, without contacting ConfigCat. It releases the underlying ConfigCat SDK client and its background auto-polling goroutine. This provider has no option to inject a pre-built client, so the client Close releases is always the one it built itself.

Watch

The ConfigCat SDK auto-polls its config; mamori polls (WithPollInterval + jitter) on top.

Error classification

ConfigCat’s client surface returns a bare value with no error, so this provider has no error vocabulary beyond not-found. It is conformance-exempt from the ErrorClassification case via providertest.Config.NoResolveErrors.

Configuration

import configcatprov "github.com/xavidop/mamori/providers/configcat"

mamori.WithProvider(configcatprov.New(configcatprov.WithSDKKey(os.Getenv("CONFIGCAT_SDK_KEY"))))

Verified with an injected fake (un-seeded keys resolve to not-found); live behavior is covered by //go:build integration tests.