proxy

type HookConfig struct {
	// Function is the function name, as discovered by the worker (its directory name).
	Function string `json:"function"`

	// TimeoutMs abandons the hook after this long. The CLI fills a default well below the
	// edge-function ceiling, so a hung hook fails fast instead of holding an invocation slot.
	TimeoutMs int `json:"timeout,omitempty"`

	// OnUnavailable is what a hook that does not *answer* means — a timeout, a connection failure,
	// a 5xx, an unparseable body. "reject" fails the write, "log" allows it.
	//
	// Deliberately not consulted for a 4xx: that is the hook working correctly and saying no, and it
	// reaches the caller as the status the hook chose. Collapsing the two would mean either a broken
	// hook silently passing writes it was meant to check, or a considered rejection reading as an
	// outage.
	OnUnavailable string `json:"onUnavailable,omitempty"`
}

type ProxyOpts struct {
	// StripPrefix removes this prefix from the request path before forwarding.
	StripPrefix string

	// HeaderOverrides sets (or replaces) these headers on every forwarded request.
	HeaderOverrides map[string]string

	// HeaderFunc, when set, is called per-request and its return value is merged
	// with HeaderOverrides (HeaderFunc takes precedence on key conflicts).
	HeaderFunc func(*http.Request) map[string]string

	// RequestTimeout caps the upstream round-trip duration.
	RequestTimeout time.Duration
}

type RouteManifest struct {
	// Schema is the Postgres schema name (default: "public").
	Schema string `json:"schema"`

	// PostgRESTURL overrides SUPATYPE_POSTGREST_URL when set.
	PostgRESTURL string `json:"postgrest_url,omitempty"`

	// GraphQLURL overrides SUPATYPE_GRAPHQL_URL when set.
	GraphQLURL string `json:"graphql_url,omitempty"`

	// StorageURL overrides SUPATYPE_STORAGE_URL when set.
	StorageURL string `json:"storage_url,omitempty"`

	// AppMode overrides SUPATYPE_APP_MODE when set ("none"|"static"|"proxy").
	AppMode string `json:"app_mode,omitempty"`

	// AppStaticDir overrides SUPATYPE_APP_STATIC_DIR when set.
	AppStaticDir string `json:"app_static_dir,omitempty"`

	// AppUpstream overrides SUPATYPE_APP_UPSTREAM when set.
	AppUpstream string `json:"app_upstream,omitempty"`

	// ViteDevURL overrides SUPATYPE_VITE_DEV_URL when set (dev HMR at /_vite/*).
	ViteDevURL string `json:"vite_dev_url,omitempty"`

	// RealtimeEnabled gates /realtime/v1 (tier / feature flag).
	RealtimeEnabled bool `json:"realtime_enabled"`

	// RealtimeURL overrides SUPATYPE_REALTIME_URL when set (internal realtime service base URL).
	RealtimeURL string `json:"realtime_url,omitempty"`

	// FunctionsEnabled indicates the Deno functions subsystem should start.
	FunctionsEnabled bool `json:"functions_enabled"`

	// FunctionsWorkerURL is the per-project worker base URL (Pro+ / self-host).
	FunctionsWorkerURL string `json:"functions_worker_url,omitempty"`

	// FunctionWorkerURLs maps function name → worker base URL (free-tier per-function pool).
	FunctionWorkerURLs map[string]string `json:"function_worker_urls,omitempty"`

	// CorsAllowedOrigins lists allowed browser Origin values (exact match).
	// Merged from Valkey tenant config / manifest in managed mode; may be
	// combined with SUPATYPE_CORS_ALLOW_ORIGINS on the server.
	CorsAllowedOrigins []string `json:"cors_allowed_origins,omitempty"`

	// StaticCacheHTML overrides Cache-Control for HTML responses and SPA fallback (default no-cache).
	StaticCacheHTML string `json:"static_cache_html,omitempty"`

	// StaticCacheHashedAssets overrides Cache-Control for bundled/hashed asset paths (default immutable long cache).
	StaticCacheHashedAssets string `json:"static_cache_hashed_assets,omitempty"`

	// StaticCachePrefixes maps URL path prefix → Cache-Control (longest matching prefix wins).
	StaticCachePrefixes map[string]string `json:"static_cache_prefixes,omitempty"`

	// Hooks maps table name → lifecycle hooks, written by `supatype push`.
	//
	// Keyed by table because that is what a REST path carries; the model name never reaches the
	// wire. Absent for a project that declares none, which is the common case.
	Hooks map[string]TableHooks `json:"hooks,omitempty"`
}

type TableHooks map[string]HookConfig