web

web / lib/services/site-resolver

lib/services/site-resolver

Site resolver service for determining the active Site configuration.

Resolves sites in priority order:

1. Custom domain match (e.g., events.city.gov)
2. Default site (isDefault: true)
3. Null (no site configured)

Functions

findSiteByDomain()

findSiteByDomain(payload, domain): Promise<Site | null>

Finds a site by custom domain.

Parameters

payload

BasePayload

domain

string

Returns

Promise<Site | null>

findDefaultSite()

findDefaultSite(payload): Promise<Site | null>

Finds the default site (isDefault: true).

Parameters

payload

BasePayload

Returns

Promise<Site | null>

resolveSite()

resolveSite(payload, host?): Promise<Site | null>

Resolves the active site for a request.

Resolution priority:

1. Custom domain match (skip localhost/dev domains)
2. Default site

Parameters

payload

BasePayload

host?

string | null

Returns

Promise<Site | null>

clearSiteCache()

clearSiteCache(): void

Clears all site caches. Useful for testing or after admin changes.

Returns

void