server

Overview ¶

Send-email hook receiver (POST /internal/v0hooks/send-email).

GoTrue is configured with GOTRUE_HOOK_SEND_EMAIL_ENABLED=true, GOTRUE_HOOK_SEND_EMAIL_URI pointing at this path (or any HTTPS URL for an Edge Function), and GOTRUE_HOOK_SEND_EMAIL_SECRETS matching Standard Webhooks v1 symmetric secrets (same format as outbound hooks). GoTrue then POSTs the payload to that URI instead of calling the mailer directly; this handler verifies the signature and runs DeliverInboundSendEmailHook (same templated path as direct sends).

In local dev, supatype.config.ts `email.send_email_hook` wires these env vars; optional `send_email_hook_uri` / `send_email_hook_secrets` override defaults.

Package server exposes the full supatype-server HTTP surface (auth, admin, rest, graphql, storage, functions, realtime, studio, platform) as an importable handler so it can be embedded in-process by other binaries (e.g. the Supatype Cloud metering/liveness gateway) without re-implementing the bootstrap or adding a network hop.

New performs the same bootstrap that `supatype-server serve` does, minus the listener/TLS/graceful-shutdown loop (which the caller owns). Stock binary behaviour is preserved: cmd/serve_cmd.go calls New and then runs the unchanged listen loop, so routes and config handling are identical.