AshOaskit.Core.PathRegistry (AshOasKit v0.4.1)

Conflict detection and stable operation identifiers for generated path maps.

Summary

Disambiguates generated identifiers with a deterministic method/path suffix.

Merges path maps without silently replacing operations.

Adds an operation, rejecting conflicting methods and equivalent path templates.

Returns a stable identifier suffix for a method and served path.

Checks global operationId uniqueness, including explicit controller identifiers.

@spec disambiguate(map()) :: map()

Disambiguates generated identifiers with a deterministic method/path suffix.

@spec merge(map(), map()) :: map()

Merges path maps without silently replacing operations.

@spec put(map(), String.t(), String.t(), map()) :: map()

Adds an operation, rejecting conflicting methods and equivalent path templates.

@spec suffix(atom() | String.t(), String.t()) :: String.t()

Returns a stable identifier suffix for a method and served path.

@spec validate_ids!(map()) :: map()

Checks global operationId uniqueness, including explicit controller identifiers.