OneShotReceiver<T> class final

Promise-like receiver for one-shot channels.

Receives exactly one value based on the channel's consumption mode. Provides promise-like waiting semantics with explicit result types.

Consumption modes:

• consumeOnce: true: First recv() gets value, subsequent calls get disconnected
• consumeOnce: false: All recv() calls get the same value

Example - Single consumption:

final (tx, rx) = OneShot.channel<String>(consumeOnce: true);
await tx.send('hello');

final result1 = await rx.recv(); // Gets 'hello'
final result2 = await rx.recv(); // Gets RecvErrorDisconnected

Example - Multiple consumption:

final (tx, rx) = OneShot.channel<Config>(consumeOnce: false);
await tx.send(config);

final config1 = await rx.recv(); // Gets config
final config2 = await rx.recv(); // Gets same config