#Hosi121/lifetime_js

#API

• wait(life, register, discard?) turns a one-shot callback into a cancellable async operation. register receives (Result[T, PortError]) -> Unit and returns a synchronous unregister callback. It may complete synchronously.
• acquire(life, register, release~) uses the same release function for both discarded values and values adopted by the lifetime. Ownership is registered before returning, with no intervening async suspension.
• run(life, task, failed) enters official async from a synchronous host callback. task receives TaskGroup[Unit]; its children stay in that group. Root completion or failure closes life. Failure is reported after cleanup; cancellation is observed without an unhandled Promise rejection.
• guard_sync(fn) converts a synchronous host exception to checked PortError. Async callback exceptions need their own boundary conversion.
• check(life) raises Stopped when closed. This is distinct from official async's cancellation signal.
• Inbox[T](life, limit~) is bounded ingress from JS callbacks to one async reader. offer returns false when full or closed; next waits via the official Promise bridge and raises ConcurrentRead on overlapping reads. limit must be positive (invalid programmer input aborts). Queued values must not require disposal; closing drops them, and rejected values remain with the producer.

#Ownership