sync-construction-async-property-ui-render-gate-pattern

To export a client with async init, construct the instance synchronously and attach the async work to it via a whenSynced property, allowing consumers to import and call methods immediately while initialization runs in the background.

Use a withCapabilities builder to attach specific async tasks like data loading or persistence to the instance, composing initialization dynamically without blocking the synchronous construction path or immediate module export.

Yes, the sync construction async init pattern suits UI frameworks and module systems where consumers require immediate synchronous access to the exported client while asynchronous initialization tasks run in the background.

Calling methods before async init completes causes undefined returns because background tasks are still running; await the instance's whenSynced property to guarantee the client is fully ready before invoking its methods.

Avoid sync construction with attached async work if your module consumers cannot handle a readiness promise or if your client lacks a synchronous construction path and requires full blocking initialization before export.