Function toCanonicalFormatOptionsWithRoutes

toCanonicalFormatOptionsWithRoutes(
    productId: string,
    formatOptions: readonly V2ProductFormatDeclaration[],
): {
    formatOptions: CanonicalFormatDeclaration[];
    routes: CanonicalFormatLegacyRoute[];
}
Conceal migration-only legacy identities from canonical format declarations while extracting their durable downgrade routes first.

This is the declaration-array counterpart to toAdditiveCanonicalProduct. It is intended for persisted catalogs and other consumers that do not hold a complete Product. The source array and declarations are never mutated.
Parameters
- productId: string
- formatOptions: readonly V2ProductFormatDeclaration[]
Returns {
formatOptions: CanonicalFormatDeclaration[];
routes: CanonicalFormatLegacyRoute[];
}
Throws
TypeError when a canonical declaration uses a direct legacy identity alias such as agent_url or agentUrl instead of v1_format_ref.
- Defined in src/lib/v2/projection/augment-response.ts:335