pluginsdk/settings/settings.go

package settings

import "context"

// Settings provides settings access for plugins.
type Settings interface {
	GetSiteSettings(ctx context.Context) (map[string]any, error)
	GetPluginSettings(ctx context.Context, pluginName string) (map[string]any, error)
}

// Updater allows plugins to modify site settings and their own plugin
// settings.
type Updater interface {
	UpdateSiteSetting(ctx context.Context, key string, value any) error
	// UpdatePluginSettings replaces the plugin's own settings map. Across the
	// wasm ABI the host enforces that pluginName matches the calling plugin.
	UpdatePluginSettings(ctx context.Context, pluginName string, settings map[string]any) error
}

// GetStringOr returns a string value from a map, or defaultVal if not found/wrong type.
func GetStringOr(m map[string]any, key, defaultVal string) string {
	if v, ok := m[key].(string); ok {
		return v
	}
	return defaultVal
}

// GetBoolOr returns a bool value from a map, or defaultVal if not found/wrong type.
func GetBoolOr(m map[string]any, key string, defaultVal bool) bool {
	if v, ok := m[key].(bool); ok {
		return v
	}
	return defaultVal
}

// GetIntOr returns an int value from a map, handling both int and float64 (JSON numbers).
func GetIntOr(m map[string]any, key string, defaultVal int) int {
	if v, ok := m[key].(float64); ok {
		return int(v)
	}
	if v, ok := m[key].(int); ok {
		return v
	}
	return defaultVal
}

// GetFloat64Or returns a float64 value from a map, or defaultVal if not found/wrong type.
func GetFloat64Or(m map[string]any, key string, defaultVal float64) float64 {
	if v, ok := m[key].(float64); ok {
		return v
	}
	return defaultVal
}