{"version":3,"file":"deferrable-map.mjs","sources":["../../../src/utils/deferrable-map.ts"],"sourcesContent":["import { Future } from '../room/utils';\nimport { type Throws } from './throws';\n\n/** An error which is thrown if a {@link DeferrableMap#getDeferred} call is aborted midway\n * through. */\nexport class DeferrableMapAbortError extends DOMException {\n  reason: unknown;\n\n  constructor(message: string, reason?: unknown) {\n    super(message, 'AbortError');\n    this.reason = reason;\n  }\n}\n\n/**\n * A Map-like container keyed by unique strings that supports the ability to wait\n * for future keys to show up in the map.\n *\n * @example\n * // An already existing key:\n * const value = map.get(\"key\");\n * // Wait for a key which will be added soon:\n * const value = await map.getDeferred(\"key\");\n */\nexport class DeferrableMap<K, V> extends Map<K, V> {\n  private pending: Map<K, Array<Future<V, DeferrableMapAbortError>>> = new Map();\n\n  set(key: K, value: V): this {\n    super.set(key, value);\n\n    // Resolve any futures waiting on this key.\n    const futures = this.pending?.get(key);\n    if (futures) {\n      for (const future of futures) {\n        if (!future.isResolved) {\n          future.resolve?.(value);\n        }\n      }\n      this.pending.delete(key);\n    }\n\n    return this;\n  }\n\n  get [Symbol.toStringTag](): string {\n    return 'DeferrableMap';\n  }\n\n  /**\n   * Returns the value for `key` immediately if it exists, otherwise returns a\n   * promise that resolves once `set(key, value)` is called.\n   *\n   * If an `AbortSignal` is provided and it is aborted before the key appears,\n   * the returned promise rejects with an {@link DeferrableMapAbortError}.\n   */\n  getDeferred(key: K): Promise<V>;\n  getDeferred(key: K, signal: AbortSignal): Promise<Throws<V, DeferrableMapAbortError>>;\n  async getDeferred(key: K, signal?: AbortSignal) {\n    const existing = this.get(key);\n    if (typeof existing !== 'undefined') {\n      return existing;\n    }\n\n    // Bail out immediately if the signal is already aborted.\n    if (signal?.aborted) {\n      throw new DeferrableMapAbortError('The operation was aborted.', signal.reason);\n    }\n\n    const future = new Future<V, DeferrableMapAbortError>(undefined, () => {\n      // Clean up the pending list when the future settles.\n      const futures = this.pending.get(key);\n      if (!futures) {\n        return;\n      }\n\n      const idx = futures.indexOf(future);\n      if (idx !== -1) {\n        futures.splice(idx, 1);\n      }\n      if (futures.length === 0) {\n        this.pending.delete(key);\n      }\n    });\n\n    const existingFutures = this.pending.get(key);\n    if (existingFutures) {\n      existingFutures.push(future);\n    } else {\n      this.pending.set(key, [future]);\n    }\n\n    // If a signal was provided, listen for abort and reject the future.\n    if (signal) {\n      const onAbort = () => {\n        if (!future.isResolved) {\n          future.reject?.(new DeferrableMapAbortError('The operation was aborted.', signal.reason));\n        }\n      };\n      signal.addEventListener('abort', onAbort, { once: true });\n\n      // Clean up the listener once the future settles (resolved or rejected). Handle both\n      // outcomes here: a `.finally()` chain would re-reject with the abort error and surface\n      // as an unhandled rejection even when the caller catches the returned promise.\n      const removeAbortListener = () => {\n        signal.removeEventListener('abort', onAbort);\n      };\n      future.promise.then(removeAbortListener, removeAbortListener);\n    }\n\n    return future.promise;\n  }\n}\n"],"names":["DeferrableMapAbortError","DOMException","constructor","message","reason","DeferrableMap","Map","pending","set","key","value","futures","_a","get","future","isResolved","_b","resolve","call","delete","Symbol","toStringTag","getDeferred","signal","existing","aborted","Future","undefined","idx","indexOf","splice","length","existingFutures","push","onAbort","reject","addEventListener","once","removeAbortListener","removeEventListener","promise","then"],"mappings":"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"}