🚀 Feature: a way to start a machine, send an event, then continue

[boneskull]

Feature Request Checklist

• I have searched for related issues and found none that matched my issue.

Overview

I find myself doing stuff like:

const actor = createActor(logic);
const promise = runUntilDone(actor);
actor.send({type: 'EVENT'});
await promise;

It'd be helpful to provide an API to do this easily.

We could piggyback on AuditionOptions, e.g.:

export type AuditionOptions = {
  // ...

  /**
   * Send event immediately after starting the actor
   * (This should be generic on the logic's events, 
   * and should only apply to actors which accept events)
   */
  send?: EventObject,

  /**
   * Delay sending the event specified by {@link AuditionOptions.send}
   * by this many milliseconds. Ignored if `AuditionOptions.send` is unset
   */
  sendAfter?: number,
};

A benefit of the above is that it'd be compatible with all extant functions accepting AuditionOptions.

It pains me to note that providing a fluent API based on custom thenables could work:

await runUntilDone(actor).withEvent({type: 'EVENT'}).after(200);

I'm leaning towards hating this (especially the implementation), but could be convinced otherwise.

Open to suggestions.

Additional Info

No response