Function await

src/platforms/await.h:35–61

/// from any execution context (main thread, coroutine, worker thread).
template<typename T>
fl::task::PromiseResult<T> await(fl::task::Promise<T> promise) FL_NOEXCEPT {
    // Validate promise
    if (!promise.valid()) {
        return fl::task::PromiseResult<T>(fl::task::Error("Invalid promise"));
    }

    // If already completed, return immediately
    if (promise.is_completed()) {
        return promise.is_resolved()
            ? fl::task::PromiseResult<T>(promise.value())
            : fl::task::PromiseResult<T>(promise.error());
    }

    auto& runtime = ICoroutineRuntime::instance();

    // Poll until promise completes, yielding to platform scheduler
    while (!promise.is_completed()) {
        promise.update();
        if (promise.is_completed()) break;
        runtime.suspendMainthread(1000);  // Yield ~1ms
    }

    // Promise completed, return result
    return promise.is_resolved()
        ? fl::task::PromiseResult<T>(promise.value())
        : fl::task::PromiseResult<T>(promise.error());
}

} // namespace platforms
} // namespace fl