extension

type Config struct {
	// DisableRoutes prevents HTTP route registration.
	DisableRoutes bool `json:"disable_routes" mapstructure:"disable_routes" yaml:"disable_routes"`

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

	// BasePath is the URL prefix for ledger routes (default: "/ledger").
	BasePath string `json:"base_path" mapstructure:"base_path" yaml:"base_path"`

	// MeterBatchSize is the number of usage events to buffer before flushing
	// to the store (default: 100).
	MeterBatchSize int `json:"meter_batch_size" mapstructure:"meter_batch_size" yaml:"meter_batch_size"`

	// MeterFlushInterval is how frequently the meter buffer is flushed
	// even if the batch size has not been reached (default: 5s).
	MeterFlushInterval time.Duration `json:"meter_flush_interval" mapstructure:"meter_flush_interval" yaml:"meter_flush_interval"`

	// EntitlementCacheTTL controls how long entitlement check results are
	// cached in-process before re-evaluating against the store (default: 30s).
	EntitlementCacheTTL time.Duration `json:"entitlement_cache_ttl" mapstructure:"entitlement_cache_ttl" yaml:"entitlement_cache_ttl"`

	// LifecycleInterval is how often the lifecycle clock runs: it moves ended
	// billing periods forward, enacts scheduled cancellations, ends trials and
	// marks overdue invoices past due (default: 1m). Zero means the default,
	// as for every other duration here, and so does a negative value: neither
	// turns the clock off. Use DisableLifecycle for that.
	LifecycleInterval time.Duration `json:"lifecycle_interval" mapstructure:"lifecycle_interval" yaml:"lifecycle_interval"`

	// DisableLifecycle turns the lifecycle clock off, for a deployment that
	// calls Ledger.Advance from its own scheduler.
	DisableLifecycle bool `json:"disable_lifecycle" mapstructure:"disable_lifecycle" yaml:"disable_lifecycle"`

	// 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"`

	// AppID scopes all operations to a specific application identifier.
	// Used by the dashboard contributor to filter data by app.
	AppID string `json:"app_id" mapstructure:"app_id" yaml:"app_id"`

	// RequireAppClaim refuses dashboard contract requests whose principal
	// carries no app_id claim, even when AppID is set. Turn it on in a
	// multi-app deployment.
	RequireAppClaim bool `json:"require_app_claim" mapstructure:"require_app_claim" yaml:"require_app_claim"`

	// 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)