Hide server initializer from a base URL

[defagos]

Description

As a Pillarbox developer, I want SRG SSR content to be provided only by IL, thus avoiding bad practices within SRG SSR.

Hints

Read internal discussions here.

Acceptance criteria

• There is no way to use a non-official server with CoreBusiness PlayerItems.

Tasks

• Prevent server initializer from a base URL somehow.

[defagos]

The existing public Server.init(baseUrl:queryItems:) promotes a way of using Core Business with services able to pose as the IL. This is what we want to avoid.

Still we want to be able to use this API in our demo during the IL to SAM transition. Some ideas and results:

• Make the method internal and use Swift 6.0 new internal imports: We cannot compile for 6.0 yet.
• Make the method internal and use @testable: This does not work in app targets.
• Mark the method as deprecated: This litters our compilation logs with warnings we cannot silence.
• Keep the method public but use an assertion to ensure it is only used in our demo, and replace the documentation with a warning. This is likely our best option.