Services

Service-oriented entry points for Sometic engines that sit beside UI components: authentication orchestration and the HTTP client.

These pages mirror the deeper guides under Authentication and Utilities. Use this hub when navigating from architecture or API maps.

Inventory

ServicePackageDeep docs
Auth controller@sometic/authAuthentication · Auth service
HTTP client@sometic/httpHTTP utility · HTTP service
Auth HTTP seam@sometic/http/authInterceptors

When to use this hub

  • You need the package-oriented view of auth / HTTP next to Primitives
  • You are wiring createAuth + createHttp without opening every auth subguide first
  • You want the provider capability matrix in one place

When to use the deep guides instead

  • Full session, refresh, authorization, and provider setup → Authentication
  • Full HTTP recipes, retries, and SSR fetch injection → HTTP utility

Honesty

  • Provider SDKs (Firebase, Supabase) are optional peers on @sometic/auth-firebase and @sometic/auth-supabase.
  • @sometic/auth core has no Firebase / Supabase / OIDC lock-in.
  • @sometic/http optionally peers on @sometic/auth; it never embeds provider SDKs.
  • Client can() and HTTP status handling do not secure APIs. Servers enforce authorization.

Capability matrix (auth providers)

Capabilitytestlocalfirebasesupabaseoidc
signIn
signOut
register
getSession
refresh
getUser
passwordReset
emailVerification
oauth✓*
mfa

* When signInWithOAuth exists on the injected Supabase client.