Function waitForEvent

Waits for a specific operating system event to occur

⚠️ NOTE: Requires an active event loop to process events

waitForEvent<T extends keyof Events>(
    name: T,
    check?: (...args: Events[T]) => boolean,
    timeout?: number,
): Promise<Events[T]>
Returns a promise that resolves when the specified event occurs.
Type Parameters
- T extends keyof Events
Parameters
- name: T
  The name of the event to wait for
- check: (...args: Events[T]) => boolean = ...
  Optional function to filter events based on their arguments
- timeout: number = 0
  Optional timeout in milliseconds. If 0, waits indefinitely
Returns Promise<Events[T]>
A promise that resolves with the event arguments
Throws
If the timeout is reached before the event occurs
Example
```
try {
  const [itemId, count] = await events.waitForEvent(
    'item_pickup',
    (itemId) => itemId === 64, // Wait for diamond pickup
    5000 // Timeout after 5 seconds
  );
  console.log(`Picked up ${count} diamonds!`);
} catch (error) {
  console.log('Timed out waiting for diamond pickup');
}
```
- Defined in libraries/helpers/src/scheduler.ts:437