Skip to content

mergeConfigs

mergeConfigs<TBindings>(…configs): GatewayConfig<TBindings>

Defined in: src/config/merge.ts:46

Merge multiple partial gateway configs into a single complete config.

Merge semantics by field:

  • routes - concatenated (all routes from all configs, in order)
  • policies - deduplicated by name (later config wins on conflict)
  • admin, debugHeaders - shallow-merged when both are objects; last-defined wins when types differ (boolean vs object)
  • All other scalar fields - last-defined wins (undefined values are skipped)

TBindings = Record<string, unknown>

Worker bindings type, propagated to routes.

Partial<GatewayConfig<TBindings>>[]

Partial configs to merge (left to right, later wins).

GatewayConfig<TBindings>

A merged GatewayConfig.

If the merged result has zero routes.