backend

package
v0.0.1 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Nov 16, 2026 License: Apache-2.0 Imports: 15 Imported by: 0

Documentation

Index

Constants

View Source
const (
	ExecutionBackendRiver  = "river"
	ExecutionBackendPoller = "poller"
)

Variables

This section is empty.

Functions

This section is empty.

Types

type AbuseControlsConfig

type AbuseControlsConfig struct {
	AuthAttempts            int             `` /* 213-byte string literal not displayed */
	AuthWindow              config.Duration `` /* 186-byte string literal not displayed */
	ExpensiveClientAttempts int             `` /* 191-byte string literal not displayed */
	ExpensiveTenantAttempts int             `` /* 191-byte string literal not displayed */
	CredentialAttempts      int             `` /* 202-byte string literal not displayed */
	ExpensiveWindow         config.Duration `` /* 191-byte string literal not displayed */
}

AbuseControlsConfig defines shared PostgreSQL-backed request budgets. These values apply across API replicas and survive process restarts.

type AuthConfig

type AuthConfig struct {
	GoogleClientID                 string `` /* 151-byte string literal not displayed */
	GoogleClientSecret             string `` /* 155-byte string literal not displayed */
	GoogleRedirectURI              string `` /* 154-byte string literal not displayed */
	SelfServiceRegistrationEnabled bool   `` /* 203-byte string literal not displayed */
}

AuthConfig contains backend authentication configuration.

type BigQueryConfig

type BigQueryConfig struct {
	OAuthClientID     string `` /* 169-byte string literal not displayed */
	OAuthClientSecret string `` /* 185-byte string literal not displayed */
	OAuthRedirectURI  string `` /* 164-byte string literal not displayed */
	BaseURL           string `` /* 195-byte string literal not displayed */
	TokenURL          string `` /* 203-byte string literal not displayed */
	AllowPrivateHosts bool   `` /* 234-byte string literal not displayed */
}

BigQueryConfig contains deployment-owned OAuth and runtime endpoint configuration.

type CORSConfig

type CORSConfig struct {
	AllowedOrigins []string `toml:"allowed_origins" env:"CORS_ALLOWED_ORIGINS" flag:"cors-allowed-origins" desc:"Comma-separated allowed CORS origins"`
}

CORSConfig contains backend CORS configuration.

type Config

type Config struct {
	Deployment    config.DeploymentConfig `toml:"deployment"`
	Server        ServerConfig            `toml:"server"`
	Database      DatabaseConfig          `toml:"database"`
	Session       SessionConfig           `toml:"session"`
	Security      SecurityConfig          `toml:"security"`
	Auth          AuthConfig              `toml:"auth"`
	AbuseControls AbuseControlsConfig     `toml:"abuse_controls"`

	PrivatePostgres   PrivatePostgresConfig   `toml:"private_postgres"`
	Proof             config.ProofConfig      `toml:"proof"`
	ProofObservations ProofObservationsConfig `toml:"proof_observations"`
	HTTPOAuth         HTTPOAuthConfig         `toml:"http_oauth"`
	HubSpot           HubSpotConfig           `toml:"hubspot"`
	Slack             SlackConfig             `toml:"slack"`
	GitLab            GitLabConfig            `toml:"gitlab"`
	GitHubProof       GitHubProofConfig       `toml:"github_proof"`
	BigQuery          BigQueryConfig          `toml:"bigquery"`
	GoogleWorkspace   GoogleWorkspaceConfig   `toml:"google_workspace"`
	Snowflake         SnowflakeConfig         `toml:"snowflake"`
	CORS              CORSConfig              `toml:"cors"`
	SMTP              config.SMTP             `toml:"smtp"`
	Logging           LoggingConfig           `toml:"logging"`
	Tracing           config.TracingConfig    `toml:"tracing"`
	Metrics           config.MetricsConfig    `toml:"metrics"`
	Execution         ExecutionConfig         `toml:"execution"`
	ExecutionLimits   ExecutionLimitsConfig   `toml:"execution_limits"`
	Worker            WorkerConfig            `toml:"worker"`
	FrontendURL       string                  `` /* 151-byte string literal not displayed */
	DefaultLanguage   string                  `toml:"default_language" env:"DEFAULT_LANGUAGE" flag:"default-language" desc:"Default language for the application"`
}

Config represents the backend application runtime configuration.

func Load

func Load(path string) (*Config, error)

Load reads and parses backend configuration.

func LoadExecutorWithArgs

func LoadExecutorWithArgs(path string, args []string) (*Config, error)

LoadExecutorWithArgs loads only the configuration required by the dedicated execution worker. It deliberately does not require application encryption, auth, SMTP, session, or control-plane configuration.

func LoadWithArgs

func LoadWithArgs(path string, args []string) (*Config, error)

LoadWithArgs reads backend configuration using an isolated set of shared config flags.

func (*Config) ValidateExecutionRequestKey

func (c *Config) ValidateExecutionRequestKey() error

ValidateExecutionRequestKey rejects missing, placeholder, malformed, or application-key-reused execution envelope keys.

type DatabaseConfig

type DatabaseConfig = config.DatabaseConfig

DatabaseConfig contains backend database connection configuration.

type ExecutionConfig

type ExecutionConfig struct {
	Backend                   string          `` /* 129-byte string literal not displayed */
	RequestTimeout            config.Duration `` /* 149-byte string literal not displayed */
	CompletionTriggersEnabled bool            `` /* 195-byte string literal not displayed */
}

ExecutionConfig selects the deployment-wide execution placement.

type ExecutionLimitsConfig

type ExecutionLimitsConfig struct {
	QueryTimeout                      config.Duration `` /* 239-byte string literal not displayed */
	ConnectorTimeout                  config.Duration `` /* 227-byte string literal not displayed */
	MaxResultRows                     int             `` /* 227-byte string literal not displayed */
	MaxFileBytes                      int64           `` /* 135-byte string literal not displayed */
	MaxResponseBytes                  int64           `` /* 233-byte string literal not displayed */
	ConnectorConcurrencyPerDataSource int             `` /* 259-byte string literal not displayed */
	ConnectorConcurrencyQueueTimeout  config.Duration `` /* 253-byte string literal not displayed */
	ConnectorConcurrencyMaxQueued     int             `` /* 272-byte string literal not displayed */
	HTTPTimeout                       config.Duration `` /* 239-byte string literal not displayed */
	HTTPMaxRedirects                  int             `` /* 229-byte string literal not displayed */
	HTTPMaxRequestBytes               int64           `` /* 233-byte string literal not displayed */
	HTTPMaxResponseBytes              int64           `` /* 234-byte string literal not displayed */
	HTTPRetryAttempts                 int             `` /* 235-byte string literal not displayed */
	HTTPRetryBackoff                  config.Duration `` /* 234-byte string literal not displayed */
	TransformTimeout                  config.Duration `` /* 232-byte string literal not displayed */
	TransformMaxWork                  int64           `` /* 250-byte string literal not displayed */
	TransformMaxIntermediateRows      int             `` /* 236-byte string literal not displayed */
	TransformMaxIntermediateBytes     int64           `` /* 247-byte string literal not displayed */
	TransformMaxOutputRows            int             `` /* 217-byte string literal not displayed */
	TransformMaxOutputBytes           int64           `` /* 229-byte string literal not displayed */
	TransformMaxDepth                 int             `` /* 233-byte string literal not displayed */
}

ExecutionLimitsConfig contains backend runtime guardrails for user-triggered execution.

type GitHubProofConfig

type GitHubProofConfig struct {
	AppID           int64  `` /* 142-byte string literal not displayed */
	ClientID        string `` /* 147-byte string literal not displayed */
	ClientSecret    string `` /* 151-byte string literal not displayed */
	PrivateKeyFile  string `` /* 165-byte string literal not displayed */
	CallbackURL     string `` /* 146-byte string literal not displayed */
	InstallationURL string `` /* 138-byte string literal not displayed */
	WebhookSecret   string `` /* 174-byte string literal not displayed */
}

type GitLabConfig

type GitLabConfig struct {
	OAuthClientID     string `` /* 128-byte string literal not displayed */
	OAuthClientSecret string `` /* 132-byte string literal not displayed */
	OAuthRedirectURI  string `` /* 126-byte string literal not displayed */
	OAuthBaseURL      string `` /* 155-byte string literal not displayed */
}

GitLabConfig contains deployment-owned GitLab OAuth application settings.

type GoogleWorkspaceConfig

type GoogleWorkspaceConfig struct {
	OAuthClientID     string `` /* 162-byte string literal not displayed */
	OAuthClientSecret string `` /* 178-byte string literal not displayed */
	OAuthRedirectURI  string `` /* 157-byte string literal not displayed */
	PickerAPIKey      string `` /* 192-byte string literal not displayed */
	ProjectNumber     string `` /* 186-byte string literal not displayed */
}

GoogleWorkspaceConfig contains deployment-owned Workspace OAuth and Picker settings. OAuth settings are independent of BigQuery because callbacks and consent scopes differ.

type HTTPOAuthConfig

type HTTPOAuthConfig struct {
	OAuthRedirectURI string `` /* 141-byte string literal not displayed */
}

HTTPOAuthConfig pins the callback independently of customer app endpoints.

type HubSpotConfig

type HubSpotConfig struct {
	BaseURL           string `` /* 174-byte string literal not displayed */
	AllowPrivateHosts bool   `` /* 185-byte string literal not displayed */
	OAuthClientID     string `` /* 140-byte string literal not displayed */
	OAuthClientSecret string `` /* 144-byte string literal not displayed */
	OAuthRedirectURI  string `` /* 143-byte string literal not displayed */
	OAuthBaseURL      string `` /* 161-byte string literal not displayed */
}

HubSpotConfig contains backend runtime overrides for the HubSpot connector.

type LoggingConfig

type LoggingConfig struct {
	Level            string          `` /* 131-byte string literal not displayed */
	File             string          `` /* 140-byte string literal not displayed */
	RotationInterval config.Duration `` /* 131-byte string literal not displayed */
	LogHTTPRequests  bool            `` /* 126-byte string literal not displayed */
	MaxFileSizeMB    int             `` /* 132-byte string literal not displayed */
	Environment      string          `` /* 131-byte string literal not displayed */
	OTLPLogsEndpoint string          `` /* 155-byte string literal not displayed */
}

LoggingConfig contains backend logging configuration.

type PrivatePostgresConfig

type PrivatePostgresConfig struct {
	Organization string `` /* 156-byte string literal not displayed */
	Source       string `toml:"source" env:"PRIVATE_POSTGRES_SOURCE" flag:"private-postgres-source" desc:"Exact private PostgreSQL data source slug"`
	Host         string `toml:"host" env:"PRIVATE_POSTGRES_HOST" flag:"private-postgres-host" desc:"Private PostgreSQL TLS hostname"`
	Address      string `` /* 137-byte string literal not displayed */
}

func (PrivatePostgresConfig) Validate

func (c PrivatePostgresConfig) Validate(profile string) error

Validate enforces the operator-owned private destination grant boundary.

type ProofObservationsConfig

type ProofObservationsConfig struct {
	Enabled        bool   `` /* 142-byte string literal not displayed */
	EvidenceKeyHex string `` /* 169-byte string literal not displayed */
}

ProofObservationsConfig controls explicitly authorized live metadata execution.

type SecurityConfig

type SecurityConfig struct {
	AllowPlaintextConnectors    bool   `` /* 171-byte string literal not displayed */
	Argon2Memory                uint32 `` /* 144-byte string literal not displayed */
	Argon2Iterations            uint32 `` /* 143-byte string literal not displayed */
	Argon2Parallelism           uint8  `` /* 144-byte string literal not displayed */
	Argon2SaltLength            uint32 `` /* 144-byte string literal not displayed */
	Argon2KeyLength             uint32 `` /* 143-byte string literal not displayed */
	EncryptionKeyHex            string `` /* 188-byte string literal not displayed */
	CredentialCurrentKeyID      string `` /* 149-byte string literal not displayed */
	CredentialKeysHex           string `` /* 150-byte string literal not displayed */
	CredentialDisableLegacy     bool   `` /* 169-byte string literal not displayed */
	ExecutionRequestKeyHex      string `` /* 201-byte string literal not displayed */
	AllowPrivateDataSourceHosts bool   `` /* 196-byte string literal not displayed */
}

SecurityConfig contains backend security-related configuration.

func (SecurityConfig) CredentialKeyring

func (s SecurityConfig) CredentialKeyring() (*crypto.CredentialKeyring, error)

CredentialKeyring leaves the original application key available to queued emails and consumers with separate lifecycles when product keys rotate.

type ServerConfig

type ServerConfig struct {
	Host              string          `toml:"host"                 env:"SERVER_HOST"                 flag:"server-host"                 desc:"Server host"`
	Port              int             `toml:"port"                 env:"SERVER_PORT"                 flag:"server-port"                 desc:"Server port"`
	ShutdownTimeout   config.Duration `` /* 145-byte string literal not displayed */
	DrainTimeout      config.Duration `` /* 169-byte string literal not displayed */
	StaticCacheMaxAge uint            `` /* 164-byte string literal not displayed */
	ProxyHeader       string          `` /* 142-byte string literal not displayed */
	TrustedProxies    []string        `` /* 154-byte string literal not displayed */
}

ServerConfig contains backend HTTP server configuration.

func (*ServerConfig) Address

func (s *ServerConfig) Address() string

Address returns the server address string.

type SessionConfig

type SessionConfig struct {
	TableName    string `toml:"table_name"    env:"SESSION_TABLE_NAME"    flag:"session-table-name"    desc:"Session table name"`
	CookieSecure bool   `toml:"cookie_secure" env:"SESSION_COOKIE_SECURE" flag:"session-cookie-secure" desc:"Set Secure flag on session cookies"`
}

SessionConfig contains backend session storage configuration.

type SlackConfig

type SlackConfig struct {
	OAuthClientID     string `toml:"oauth_client_id" env:"SLACK_OAUTH_CLIENT_ID" flag:"slack-oauth-client-id" desc:"Slack app OAuth client ID"`
	OAuthClientSecret string `` /* 128-byte string literal not displayed */
	OAuthRedirectURI  string `toml:"oauth_redirect_uri" env:"SLACK_OAUTH_REDIRECT_URI" flag:"slack-oauth-redirect-uri" desc:"Slack app OAuth callback URI"`
}

SlackConfig contains deployment-owned settings for Slack notification installation.

type SnowflakeConfig

type SnowflakeConfig struct {
	WIFIssuer     string `` /* 157-byte string literal not displayed */
	WIFSocketPath string `` /* 175-byte string literal not displayed */
}

SnowflakeConfig contains backend runtime identity inputs for the Snowflake connector.

type WorkerConfig

type WorkerConfig struct {
	PipelineGitMaxWorkers            int `` /* 214-byte string literal not displayed */
	EmailMaxWorkers                  int `` /* 207-byte string literal not displayed */
	NotificationDeliveryMaxWorkers   int `` /* 223-byte string literal not displayed */
	EventsMaxWorkers                 int `` /* 215-byte string literal not displayed */
	EventMaintenanceMaxWorkers       int `` /* 219-byte string literal not displayed */
	PipelineScheduleMaxWorkers       int `` /* 219-byte string literal not displayed */
	PipelineRetryMaxWorkers          int `` /* 216-byte string literal not displayed */
	PipelineRunMaxWorkers            int `` /* 214-byte string literal not displayed */
	DataSourceSchemaImportMaxWorkers int `` /* 227-byte string literal not displayed */
	ExecutionMaxWorkers              int `` /* 221-byte string literal not displayed */
}

WorkerConfig contains per-process River queue concurrency limits.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL