extension

type Config struct {
	// DisableRoutes prevents HTTP route registration.
	//
	// Deprecated: the extension never mounts routes; mount the api or proxy packages on your router yourself.
	DisableRoutes bool `json:"disable_routes" mapstructure:"disable_routes" yaml:"disable_routes"`

	// DisableMigrate prevents auto-migration of the persistence store on start.
	DisableMigrate bool `json:"disable_migrate" mapstructure:"disable_migrate" yaml:"disable_migrate"`

	// BasePath is the URL prefix for gateway routes (default: "/nexus").
	//
	// Deprecated: the extension never mounts routes; mount the api or proxy packages on your router yourself.
	BasePath string `json:"base_path" mapstructure:"base_path" yaml:"base_path"`

	// DefaultTimeout is the default timeout for provider requests.
	DefaultTimeout time.Duration `json:"default_timeout" mapstructure:"default_timeout" yaml:"default_timeout"`

	// DefaultMaxRetries is the default number of retries per request.
	DefaultMaxRetries int `json:"default_max_retries" mapstructure:"default_max_retries" yaml:"default_max_retries"`

	// GlobalRateLimit is the global rate limit in requests per minute (0 = unlimited).
	GlobalRateLimit int `json:"global_rate_limit" mapstructure:"global_rate_limit" yaml:"global_rate_limit"`

	// LogLevel is the log level for the gateway's internal logger (default: "info").
	LogLevel string `json:"log_level" mapstructure:"log_level" yaml:"log_level"`

	// EnableUsage enables usage tracking (default: true).
	EnableUsage *bool `json:"enable_usage" mapstructure:"enable_usage" yaml:"enable_usage"`

	// RequireAPIKey makes the HTTP edges refuse a request without a valid
	// nxs_ key (default: true).
	RequireAPIKey *bool `json:"require_api_key" mapstructure:"require_api_key" yaml:"require_api_key"`

	// EnableCache enables response caching (default: false).
	EnableCache bool `json:"enable_cache" mapstructure:"enable_cache" yaml:"enable_cache"`

	// GroveDatabase is the name of a grove.DB registered in the DI container.
	// When set, the extension resolves this named database and auto-constructs
	// the appropriate store based on the driver type (pg/sqlite/mongo).
	// When empty and WithGroveDatabase was called, the default (unnamed) DB is used.
	GroveDatabase string `json:"grove_database" mapstructure:"grove_database" yaml:"grove_database"`

	// BootstrapAdminKey is the raw value of the first admin key: "nxs_" and
	// 64 lowercase hex digits, for example "nxs_" plus the output of
	// `openssl rand -hex 32`. On start, after migration, the extension stores
	// it under the "operator" tenant with the admin scope, once. When empty,
	// the NEXUS_BOOTSTRAP_ADMIN_KEY environment variable is used. It is a
	// secret: prefer the env var to a file under source control. The
	// extension never logs it.
	BootstrapAdminKey string `json:"bootstrap_admin_key" mapstructure:"bootstrap_admin_key" yaml:"bootstrap_admin_key"`

	// RequireConfig requires config to be present in YAML files.
	// If true and no config is found, Register returns an error.
	RequireConfig bool `json:"-" yaml:"-"`
}

type Extension struct {
	*forge.BaseExtension
	// contains filtered or unexported fields
}

type Option func(*Extension)