@dxos/context 0.5.3-next.57eca40 → 0.5.3

package/dist/lib/browser/index.mjs

@@ -23,25 +23,28 @@ function _ts_decorate(decorators, target, key, desc) {
 }
 var __dxlog_file = "/home/runner/work/dxos/dxos/packages/common/context/src/context.ts";
 var MAX_SAFE_DISPOSE_CALLBACKS = 300;
+var DEFAULT_ERROR_HANDLER = (error, ctx) => {
+  if (error instanceof ContextDisposedError) {
+    return;
+  }
+  void ctx.dispose();
+  throw error;
+};
 var _a, _b;
 var Context = class _Context {
-  constructor({ name, parent, attributes = {}, onError = (error) => {
-    if (error instanceof ContextDisposedError) {
-      return;
-    }
-    void this.dispose();
-    throw error;
-  } } = {}) {
-    this._disposeCallbacks = [];
-    this._isDisposed = false;
-    this._disposePromise = void 0;
+  constructor({ name, parent, attributes = {}, onError = DEFAULT_ERROR_HANDLER } = {}) {
+    this.#disposeCallbacks = [];
+    this.#name = void 0;
+    this.#parent = void 0;
+    this.#isDisposed = false;
+    this.#disposePromise = void 0;
     this.maxSafeDisposeCallbacks = MAX_SAFE_DISPOSE_CALLBACKS;
     this[_a] = "Context";
     this[_b] = () => this.toString();
-    this._name = name;
-    this._parent = parent;
-    this._attributes = attributes;
-    this._onError = onError;
+    this.#name = name;
+    this.#parent = parent;
+    this.#attributes = attributes;
+    this.#onError = onError;
   }
   static {
     _a = Symbol.toStringTag, _b = inspect.custom;
@@ -49,11 +52,18 @@ var Context = class _Context {
   static default() {
     return new _Context();
   }
+  #disposeCallbacks;
+  #name;
+  #parent;
+  #attributes;
+  #onError;
+  #isDisposed;
+  #disposePromise;
   get disposed() {
-    return this._isDisposed;
+    return this.#isDisposed;
   }
   get disposeCallbacksLength() {
-    return this._disposeCallbacks.length;
+    return this.#disposeCallbacks.length;
   }
   /**
   * Schedules a callback to run when the context is disposed.
@@ -65,35 +75,35 @@ var Context = class _Context {
   * @returns A function that can be used to remove the callback from the dispose list.
   */
   onDispose(callback) {
-    if (this._isDisposed) {
+    if (this.#isDisposed) {
       void (async () => {
         try {
           await callback();
         } catch (error) {
           log.catch(error, void 0, {
             F: __dxlog_file,
-            L: 91,
+            L: 88,
             S: this,
             C: (f, a) => f(...a)
           });
         }
       })();
     }
-    this._disposeCallbacks.push(callback);
-    if (this._disposeCallbacks.length > this.maxSafeDisposeCallbacks) {
+    this.#disposeCallbacks.push(callback);
+    if (this.#disposeCallbacks.length > this.maxSafeDisposeCallbacks) {
       log.warn("Context has a large number of dispose callbacks (this might be a memory leak).", {
-        count: this._disposeCallbacks.length
+        count: this.#disposeCallbacks.length
       }, {
         F: __dxlog_file,
-        L: 98,
+        L: 95,
         S: this,
         C: (f, a) => f(...a)
       });
     }
     return () => {
-      const index = this._disposeCallbacks.indexOf(callback);
+      const index = this.#disposeCallbacks.indexOf(callback);
       if (index !== -1) {
-        this._disposeCallbacks.splice(index, 1);
+        this.#disposeCallbacks.splice(index, 1);
       }
     };
   }
@@ -105,57 +115,63 @@ var Context = class _Context {
   * Disposing context means that onDispose will throw an error and any errors raised will be logged and not propagated.
   */
   async dispose(throwOnError = false) {
-    if (this._disposePromise) {
-      return this._disposePromise;
+    if (this.#disposePromise) {
+      return this.#disposePromise;
     }
-    this._isDisposed = true;
+    this.#isDisposed = true;
     let resolveDispose;
-    this._disposePromise = new Promise((resolve) => {
+    const promise = new Promise((resolve) => {
       resolveDispose = resolve;
     });
-    const callbacks = Array.from(this._disposeCallbacks).reverse();
-    this._disposeCallbacks.length = 0;
-    if (this._name) {
+    this.#disposePromise = promise;
+    const callbacks = Array.from(this.#disposeCallbacks).reverse();
+    this.#disposeCallbacks.length = 0;
+    if (this.#name) {
       log("disposing", {
-        context: this._name,
+        context: this.#name,
         count: callbacks.length
       }, {
         F: __dxlog_file,
-        L: 139,
+        L: 137,
         S: this,
         C: (f, a) => f(...a)
       });
     }
     let i = 0;
     let clean = true;
+    const errors = [];
     for (const callback of callbacks) {
       try {
         await callback();
         i++;
       } catch (err) {
-        log.catch(err, {
-          context: this._name,
-          callback: i,
-          count: callbacks.length
-        }, {
-          F: __dxlog_file,
-          L: 149,
-          S: this,
-          C: (f, a) => f(...a)
-        });
         clean = false;
         if (throwOnError) {
-          throw err;
+          errors.push(err);
+        } else {
+          log.catch(err, {
+            context: this.#name,
+            callback: i,
+            count: callbacks.length
+          }, {
+            F: __dxlog_file,
+            L: 152,
+            S: this,
+            C: (f, a) => f(...a)
+          });
         }
       }
     }
+    if (errors.length > 0) {
+      throw new AggregateError(errors);
+    }
     resolveDispose(clean);
-    if (this._name) {
+    if (this.#name) {
       log("disposed", {
-        context: this._name
+        context: this.#name
       }, {
         F: __dxlog_file,
-        L: 159,
+        L: 163,
         S: this,
         C: (f, a) => f(...a)
       });
@@ -168,11 +184,11 @@ var Context = class _Context {
   * IF the error handler is not set, the error will dispose the context and cause an unhandled rejection.
   */
   raise(error) {
-    if (this._isDisposed) {
+    if (this.#isDisposed) {
       return;
     }
     try {
-      this._onError(error);
+      this.#onError(error, this);
     } catch (err) {
       void Promise.reject(err);
     }
@@ -185,7 +201,7 @@ var Context = class _Context {
           this.raise(error);
         } else {
           try {
-            await onError(error);
+            await onError(error, this);
           } catch {
             this.raise(error);
           }
@@ -198,16 +214,16 @@ var Context = class _Context {
     return newCtx;
   }
   getAttribute(key) {
-    if (key in this._attributes) {
-      return this._attributes[key];
+    if (key in this.#attributes) {
+      return this.#attributes[key];
     }
-    if (this._parent) {
-      return this._parent.getAttribute(key);
+    if (this.#parent) {
+      return this.#parent.getAttribute(key);
     }
     return void 0;
   }
   toString() {
-    return `Context(${this._isDisposed ? "disposed" : "active"})`;
+    return `Context(${this.#isDisposed ? "disposed" : "active"})`;
   }
 };
 Context = _ts_decorate([
@@ -229,13 +245,14 @@ var cancelWithContext = (ctx, promise) => {
 };
 
 // packages/common/context/src/resource.ts
-import "@dxos/util";
+import { throwUnhandledError } from "@dxos/util";
 var LifecycleState;
 (function(LifecycleState2) {
   LifecycleState2["CLOSED"] = "CLOSED";
   LifecycleState2["OPEN"] = "OPEN";
   LifecycleState2["ERROR"] = "ERROR";
 })(LifecycleState || (LifecycleState = {}));
+var CLOSE_RESOURCE_ON_UNHANDLED_ERROR = false;
 var Resource = class {
   #lifecycleState = "CLOSED";
   #openPromise = null;
@@ -250,7 +267,12 @@ var Resource = class {
   * Context that is used to bubble up errors that are not handled by the resource.
   * Provided in the open method.
   */
-  #parentCtx = new Context();
+  #parentCtx = new Context({
+    name: this.#name
+  });
+  get #name() {
+    return Object.getPrototypeOf(this).constructor.name;
+  }
   get _lifecycleState() {
     return this.#lifecycleState;
   }
@@ -272,6 +294,13 @@ var Resource = class {
   * By default, errors are bubbled up to the parent context which is passed to the open method.
   */
   async _catch(err) {
+    if (CLOSE_RESOURCE_ON_UNHANDLED_ERROR) {
+      try {
+        await this.close();
+      } catch (doubleErr) {
+        throwUnhandledError(doubleErr);
+      }
+    }
     throw err;
   }
   /**
@@ -311,12 +340,14 @@ var Resource = class {
   async #open(ctx) {
     this.#closePromise = null;
     if (ctx) {
-      this.#parentCtx = ctx;
+      this.#parentCtx = ctx.derive({
+        name: this.#name
+      });
     }
     await this._open(this.#parentCtx);
     this.#lifecycleState = "OPEN";
   }
-  async #close(ctx = new Context()) {
+  async #close(ctx = Context.default()) {
     this.#openPromise = null;
     await this.#internalCtx.dispose();
     await this._close(ctx);

package/dist/lib/browser/index.mjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/context.ts", "../../../src/context-disposed-error.ts", "../../../src/promise-utils.ts", "../../../src/resource.ts"],
-  "sourcesContent": ["//\n// Copyright 2022 DXOS.org\n//\n\nimport { inspect } from 'node:util';\n\nimport { log } from '@dxos/log';\nimport { safeInstanceof } from '@dxos/util';\n\nimport { ContextDisposedError } from './context-disposed-error';\n\nexport type ContextErrorHandler = (error: Error) => void;\n\nexport type DisposeCallback = () => any | Promise<any>;\n\nexport type CreateContextParams = {\n  name?: string;\n  parent?: Context;\n  attributes?: Record<string, any>;\n  onError?: ContextErrorHandler;\n};\n\n/**\n * Maximum number of dispose callbacks before we start logging warnings.\n */\nconst MAX_SAFE_DISPOSE_CALLBACKS = 300;\n\n@safeInstanceof('Context')\nexport class Context {\n  static default() {\n    return new Context();\n  }\n\n  private readonly _disposeCallbacks: DisposeCallback[] = [];\n\n  private readonly _name?: string;\n  private readonly _parent?: Context;\n  private readonly _attributes: Record<string, any>;\n  private readonly _onError: ContextErrorHandler;\n\n  private _isDisposed = false;\n  private _disposePromise?: Promise<boolean> = undefined;\n\n  public maxSafeDisposeCallbacks = MAX_SAFE_DISPOSE_CALLBACKS;\n\n  constructor({\n    name, // TODO(burdon): Automate?\n    parent,\n    attributes = {},\n    onError = (error) => {\n      if (error instanceof ContextDisposedError) {\n        return;\n      }\n\n      void this.dispose();\n\n      // Will generate an unhandled rejection.\n      throw error;\n    },\n  }: CreateContextParams = {}) {\n    this._name = name;\n    this._parent = parent;\n    this._attributes = attributes;\n    this._onError = onError;\n  }\n\n  get disposed() {\n    return this._isDisposed;\n  }\n\n  get disposeCallbacksLength() {\n    return this._disposeCallbacks.length;\n  }\n\n  /**\n   * Schedules a callback to run when the context is disposed.\n   * May be async, in this case the disposer might choose to wait for all resource to released.\n   * Throwing an error inside the callback will result in the error being logged, but not re-thrown.\n   *\n   * NOTE: Will call the callback immediately if the context is already disposed.\n   *\n   * @returns A function that can be used to remove the callback from the dispose list.\n   */\n  onDispose(callback: DisposeCallback): () => void {\n    if (this._isDisposed) {\n      // Call the callback immediately if the context is already disposed.\n      void (async () => {\n        try {\n          await callback();\n        } catch (error: any) {\n          log.catch(error);\n        }\n      })();\n    }\n\n    this._disposeCallbacks.push(callback);\n    if (this._disposeCallbacks.length > this.maxSafeDisposeCallbacks) {\n      log.warn('Context has a large number of dispose callbacks (this might be a memory leak).', {\n        count: this._disposeCallbacks.length,\n      });\n    }\n\n    // Remove handler.\n    return () => {\n      const index = this._disposeCallbacks.indexOf(callback);\n      if (index !== -1) {\n        this._disposeCallbacks.splice(index, 1);\n      }\n    };\n  }\n\n  /**\n   * Runs all dispose callbacks.\n   * Callbacks are run in the reverse order they were added.\n   * This function never throws.\n   * It is safe to ignore the returned promise if the caller does not wish to wait for callbacks to complete.\n   * Disposing context means that onDispose will throw an error and any errors raised will be logged and not propagated.\n   */\n  async dispose(throwOnError = false): Promise<boolean> {\n    if (this._disposePromise) {\n      return this._disposePromise;\n    }\n\n    // TODO(burdon): Probably should not be set until the dispose is complete, but causes tests to fail if moved.\n    this._isDisposed = true;\n\n    // Set the promise before running the callbacks.\n    let resolveDispose!: (value: boolean) => void;\n    this._disposePromise = new Promise<boolean>((resolve) => {\n      resolveDispose = resolve;\n    });\n\n    // Process last first.\n    // Clone the array so that any mutations to the original array don't affect the dispose process.\n    const callbacks = Array.from(this._disposeCallbacks).reverse();\n    this._disposeCallbacks.length = 0;\n\n    if (this._name) {\n      log('disposing', { context: this._name, count: callbacks.length });\n    }\n\n    let i = 0;\n    let clean = true;\n    for (const callback of callbacks) {\n      try {\n        await callback();\n        i++;\n      } catch (err: any) {\n        log.catch(err, { context: this._name, callback: i, count: callbacks.length });\n        clean = false;\n        if (throwOnError) {\n          throw err;\n        }\n      }\n    }\n\n    resolveDispose(clean);\n    if (this._name) {\n      log('disposed', { context: this._name });\n    }\n\n    return clean;\n  }\n\n  /**\n   * Raise the error inside the context.\n   * The error will be propagated to the error handler.\n   * IF the error handler is not set, the error will dispose the context and cause an unhandled rejection.\n   */\n  raise(error: Error): void {\n    if (this._isDisposed) {\n      // TODO(dmaretskyi): Don't log those.\n      // log.warn('Error in disposed context', error);\n      return;\n    }\n\n    try {\n      this._onError(error);\n    } catch (err) {\n      // Generate an unhandled rejection and stop the error propagation.\n      void Promise.reject(err);\n    }\n  }\n\n  derive({ onError, attributes }: CreateContextParams = {}): Context {\n    const newCtx = new Context({\n      // TODO(dmaretskyi): Optimize to not require allocating a new closure for every context.\n      onError: async (error) => {\n        if (!onError) {\n          this.raise(error);\n        } else {\n          try {\n            await onError(error);\n          } catch {\n            this.raise(error);\n          }\n        }\n      },\n      attributes,\n    });\n\n    const clearDispose = this.onDispose(() => newCtx.dispose());\n    newCtx.onDispose(clearDispose);\n    return newCtx;\n  }\n\n  getAttribute(key: string): any {\n    if (key in this._attributes) {\n      return this._attributes[key];\n    }\n    if (this._parent) {\n      return this._parent.getAttribute(key);\n    }\n\n    return undefined;\n  }\n\n  [Symbol.toStringTag] = 'Context';\n  [inspect.custom] = () => this.toString();\n\n  toString() {\n    return `Context(${this._isDisposed ? 'disposed' : 'active'})`;\n  }\n}\n", "//\n// Copyright 2023 DXOS.org\n//\n\nexport class ContextDisposedError extends Error {\n  constructor() {\n    super('Context disposed.');\n  }\n}\n", "//\n// Copyright 2023 DXOS.org\n//\n\nimport { type Context } from './context';\nimport { ContextDisposedError } from './context-disposed-error';\n\n/**\n * @returns A promise that rejects when the context is disposed.\n */\n// TODO(dmaretskyi): Memory leak.\nexport const rejectOnDispose = (ctx: Context, error = new ContextDisposedError()): Promise<never> =>\n  new Promise((resolve, reject) => {\n    ctx.onDispose(() => reject(error));\n  });\n\n/**\n * Rejects the promise if the context is disposed.\n */\nexport const cancelWithContext = <T>(ctx: Context, promise: Promise<T>): Promise<T> => {\n  let clearDispose: () => void;\n  return Promise.race([\n    promise,\n    new Promise<never>((resolve, reject) => {\n      // Will be called before .finally() handlers.\n      clearDispose = ctx.onDispose(() => reject(new ContextDisposedError()));\n    }),\n  ]).finally(() => clearDispose?.());\n};\n", "//\n// Copyright 2024 DXOS.org\n//\n\nimport '@dxos/util';\n\nimport { Context } from './context';\n\nexport enum LifecycleState {\n  CLOSED = 'CLOSED',\n  OPEN = 'OPEN',\n  ERROR = 'ERROR',\n}\n\nexport interface Lifecycle {\n  open?(ctx?: Context): Promise<any> | any;\n  close?(): Promise<any> | any;\n}\n\n/**\n * Base class for resources that need to be opened and closed.\n */\nexport abstract class Resource implements Lifecycle {\n  #lifecycleState = LifecycleState.CLOSED;\n  #openPromise: Promise<void> | null = null;\n  #closePromise: Promise<void> | null = null;\n\n  /**\n   * Managed internally by the resource.\n   * Recreated on close.\n   * Errors are propagated to the `_catch` method and the parent context.\n   */\n  #internalCtx: Context = this.#createContext();\n\n  /**\n   * Context that is used to bubble up errors that are not handled by the resource.\n   * Provided in the open method.\n   */\n  #parentCtx: Context = new Context();\n\n  protected get _lifecycleState() {\n    return this.#lifecycleState;\n  }\n\n  protected get _ctx() {\n    return this.#internalCtx;\n  }\n\n  /**\n   * To be overridden by subclasses.\n   */\n  protected async _open(ctx: Context): Promise<void> {}\n\n  /**\n   * To be overridden by subclasses.\n   */\n  protected async _close(ctx: Context): Promise<void> {}\n\n  /**\n   * Error handler for errors that are caught by the context.\n   * By default, errors are bubbled up to the parent context which is passed to the open method.\n   */\n  protected async _catch(err: Error): Promise<void> {\n    throw err;\n  }\n\n  /**\n   * Opens the resource.\n   * If the resource is already open, it does nothing.\n   * If the resource is in an error state, it throws an error.\n   * If the resource is closed, it waits for it to close and then opens it.\n   * @param ctx - Context to use for opening the resource. This context will receive errors that are not handled in `_catch`.\n   */\n  async open(ctx?: Context): Promise<this> {\n    switch (this.#lifecycleState) {\n      case LifecycleState.OPEN:\n        return this;\n      case LifecycleState.ERROR:\n        throw new Error(`Invalid state: ${this.#lifecycleState}`);\n      default:\n    }\n\n    await this.#closePromise;\n    await (this.#openPromise ??= this.#open(ctx));\n\n    return this;\n  }\n\n  /**\n   * Closes the resource.\n   * If the resource is already closed, it does nothing.\n   */\n  async close(ctx?: Context): Promise<this> {\n    if (this.#lifecycleState === LifecycleState.CLOSED) {\n      return this;\n    }\n    await this.#openPromise;\n    await (this.#closePromise ??= this.#close(ctx));\n\n    return this;\n  }\n\n  async [Symbol.asyncDispose]() {\n    await this.close();\n  }\n\n  async #open(ctx?: Context) {\n    this.#closePromise = null;\n    if (ctx) {\n      this.#parentCtx = ctx;\n    }\n    await this._open(this.#parentCtx);\n    this.#lifecycleState = LifecycleState.OPEN;\n  }\n\n  async #close(ctx = new Context()) {\n    this.#openPromise = null;\n    await this.#internalCtx.dispose();\n    await this._close(ctx);\n    this.#internalCtx = this.#createContext();\n    this.#lifecycleState = LifecycleState.CLOSED;\n  }\n\n  #createContext() {\n    return new Context({\n      onError: (error) =>\n        queueMicrotask(async () => {\n          try {\n            await this._catch(error);\n          } catch (err: any) {\n            this.#lifecycleState = LifecycleState.ERROR;\n            this.#parentCtx.raise(err);\n          }\n        }),\n    });\n  }\n}\n\nexport const openInContext = async <T extends Lifecycle>(ctx: Context, resource: T): Promise<T> => {\n  await resource.open?.(ctx);\n  ctx.onDispose(() => resource.close?.());\n\n  return resource;\n};\n"],
-  "mappings": "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",
-  "names": ["inspect", "log", "safeInstanceof", "ContextDisposedError", "Error", "constructor", "MAX_SAFE_DISPOSE_CALLBACKS", "Context", "constructor", "name", "parent", "attributes", "onError", "error", "ContextDisposedError", "dispose", "_disposeCallbacks", "_isDisposed", "_disposePromise", "undefined", "maxSafeDisposeCallbacks", "Symbol", "inspect", "toString", "_name", "_parent", "_attributes", "_onError", "toStringTag", "custom", "default", "disposed", "disposeCallbacksLength", "length", "onDispose", "callback", "log", "catch", "push", "warn", "count", "index", "indexOf", "splice", "throwOnError", "resolveDispose", "Promise", "resolve", "callbacks", "Array", "from", "reverse", "context", "i", "clean", "err", "raise", "reject", "derive", "newCtx", "clearDispose", "getAttribute", "key", "safeInstanceof", "rejectOnDispose", "ctx", "error", "ContextDisposedError", "Promise", "resolve", "reject", "onDispose", "cancelWithContext", "promise", "clearDispose", "race", "finally", "LifecycleState", "Resource", "Context", "_lifecycleState", "_ctx", "_open", "ctx", "_close", "_catch", "err", "open", "Error", "close", "Symbol", "asyncDispose", "dispose", "onError", "error", "queueMicrotask", "raise", "openInContext", "resource", "onDispose"]
+  "sourcesContent": ["//\n// Copyright 2022 DXOS.org\n//\n\nimport { inspect } from 'node:util';\n\nimport { log } from '@dxos/log';\nimport { safeInstanceof } from '@dxos/util';\n\nimport { ContextDisposedError } from './context-disposed-error';\n\nexport type ContextErrorHandler = (error: Error, ctx: Context) => void;\n\nexport type DisposeCallback = () => any | Promise<any>;\n\nexport type CreateContextParams = {\n  name?: string;\n  parent?: Context;\n  attributes?: Record<string, any>;\n  onError?: ContextErrorHandler;\n};\n\n/**\n * Maximum number of dispose callbacks before we start logging warnings.\n */\nconst MAX_SAFE_DISPOSE_CALLBACKS = 300;\n\nconst DEFAULT_ERROR_HANDLER: ContextErrorHandler = (error, ctx) => {\n  if (error instanceof ContextDisposedError) {\n    return;\n  }\n\n  void ctx.dispose();\n\n  // Will generate an unhandled rejection.\n  throw error;\n};\n\n@safeInstanceof('Context')\nexport class Context {\n  static default() {\n    return new Context();\n  }\n\n  readonly #disposeCallbacks: DisposeCallback[] = [];\n\n  readonly #name?: string = undefined;\n  readonly #parent?: Context = undefined;\n  readonly #attributes: Record<string, any>;\n  readonly #onError: ContextErrorHandler;\n\n  #isDisposed = false;\n  #disposePromise?: Promise<boolean> = undefined;\n\n  public maxSafeDisposeCallbacks = MAX_SAFE_DISPOSE_CALLBACKS;\n\n  constructor({ name, parent, attributes = {}, onError = DEFAULT_ERROR_HANDLER }: CreateContextParams = {}) {\n    this.#name = name;\n    this.#parent = parent;\n    this.#attributes = attributes;\n    this.#onError = onError;\n  }\n\n  get disposed() {\n    return this.#isDisposed;\n  }\n\n  get disposeCallbacksLength() {\n    return this.#disposeCallbacks.length;\n  }\n\n  /**\n   * Schedules a callback to run when the context is disposed.\n   * May be async, in this case the disposer might choose to wait for all resource to released.\n   * Throwing an error inside the callback will result in the error being logged, but not re-thrown.\n   *\n   * NOTE: Will call the callback immediately if the context is already disposed.\n   *\n   * @returns A function that can be used to remove the callback from the dispose list.\n   */\n  onDispose(callback: DisposeCallback): () => void {\n    if (this.#isDisposed) {\n      // Call the callback immediately if the context is already disposed.\n      void (async () => {\n        try {\n          await callback();\n        } catch (error: any) {\n          log.catch(error);\n        }\n      })();\n    }\n\n    this.#disposeCallbacks.push(callback);\n    if (this.#disposeCallbacks.length > this.maxSafeDisposeCallbacks) {\n      log.warn('Context has a large number of dispose callbacks (this might be a memory leak).', {\n        count: this.#disposeCallbacks.length,\n      });\n    }\n\n    // Remove handler.\n    return () => {\n      const index = this.#disposeCallbacks.indexOf(callback);\n      if (index !== -1) {\n        this.#disposeCallbacks.splice(index, 1);\n      }\n    };\n  }\n\n  /**\n   * Runs all dispose callbacks.\n   * Callbacks are run in the reverse order they were added.\n   * This function never throws.\n   * It is safe to ignore the returned promise if the caller does not wish to wait for callbacks to complete.\n   * Disposing context means that onDispose will throw an error and any errors raised will be logged and not propagated.\n   */\n  async dispose(throwOnError = false): Promise<boolean> {\n    if (this.#disposePromise) {\n      return this.#disposePromise;\n    }\n\n    // TODO(burdon): Probably should not be set until the dispose is complete, but causes tests to fail if moved.\n    this.#isDisposed = true;\n\n    // Set the promise before running the callbacks.\n    let resolveDispose!: (value: boolean) => void;\n    const promise = new Promise<boolean>((resolve) => {\n      resolveDispose = resolve;\n    });\n    this.#disposePromise = promise;\n\n    // Process last first.\n    // Clone the array so that any mutations to the original array don't affect the dispose process.\n    const callbacks = Array.from(this.#disposeCallbacks).reverse();\n    this.#disposeCallbacks.length = 0;\n\n    if (this.#name) {\n      log('disposing', { context: this.#name, count: callbacks.length });\n    }\n\n    let i = 0;\n    let clean = true;\n    const errors: Error[] = [];\n    for (const callback of callbacks) {\n      try {\n        await callback();\n        i++;\n      } catch (err: any) {\n        clean = false;\n        if (throwOnError) {\n          errors.push(err);\n        } else {\n          log.catch(err, { context: this.#name, callback: i, count: callbacks.length });\n        }\n      }\n    }\n\n    if (errors.length > 0) {\n      throw new AggregateError(errors);\n    }\n\n    resolveDispose(clean);\n    if (this.#name) {\n      log('disposed', { context: this.#name });\n    }\n\n    return clean;\n  }\n\n  /**\n   * Raise the error inside the context.\n   * The error will be propagated to the error handler.\n   * IF the error handler is not set, the error will dispose the context and cause an unhandled rejection.\n   */\n  raise(error: Error): void {\n    if (this.#isDisposed) {\n      // TODO(dmaretskyi): Don't log those.\n      // log.warn('Error in disposed context', error);\n      return;\n    }\n\n    try {\n      this.#onError(error, this);\n    } catch (err) {\n      // Generate an unhandled rejection and stop the error propagation.\n      void Promise.reject(err);\n    }\n  }\n\n  derive({ onError, attributes }: CreateContextParams = {}): Context {\n    const newCtx = new Context({\n      // TODO(dmaretskyi): Optimize to not require allocating a new closure for every context.\n      onError: async (error) => {\n        if (!onError) {\n          this.raise(error);\n        } else {\n          try {\n            await onError(error, this);\n          } catch {\n            this.raise(error);\n          }\n        }\n      },\n      attributes,\n    });\n\n    const clearDispose = this.onDispose(() => newCtx.dispose());\n    newCtx.onDispose(clearDispose);\n    return newCtx;\n  }\n\n  getAttribute(key: string): any {\n    if (key in this.#attributes) {\n      return this.#attributes[key];\n    }\n    if (this.#parent) {\n      return this.#parent.getAttribute(key);\n    }\n\n    return undefined;\n  }\n\n  [Symbol.toStringTag] = 'Context';\n  [inspect.custom] = () => this.toString();\n\n  toString() {\n    return `Context(${this.#isDisposed ? 'disposed' : 'active'})`;\n  }\n}\n", "//\n// Copyright 2023 DXOS.org\n//\n\nexport class ContextDisposedError extends Error {\n  constructor() {\n    super('Context disposed.');\n  }\n}\n", "//\n// Copyright 2023 DXOS.org\n//\n\nimport { type Context } from './context';\nimport { ContextDisposedError } from './context-disposed-error';\n\n/**\n * @returns A promise that rejects when the context is disposed.\n */\n// TODO(dmaretskyi): Memory leak.\nexport const rejectOnDispose = (ctx: Context, error = new ContextDisposedError()): Promise<never> =>\n  new Promise((resolve, reject) => {\n    ctx.onDispose(() => reject(error));\n  });\n\n/**\n * Rejects the promise if the context is disposed.\n */\nexport const cancelWithContext = <T>(ctx: Context, promise: Promise<T>): Promise<T> => {\n  let clearDispose: () => void;\n  return Promise.race([\n    promise,\n    new Promise<never>((resolve, reject) => {\n      // Will be called before .finally() handlers.\n      clearDispose = ctx.onDispose(() => reject(new ContextDisposedError()));\n    }),\n  ]).finally(() => clearDispose?.());\n};\n", "//\n// Copyright 2024 DXOS.org\n//\n\nimport { throwUnhandledError } from '@dxos/util';\n\nimport { Context } from './context';\n\nexport enum LifecycleState {\n  CLOSED = 'CLOSED',\n  OPEN = 'OPEN',\n  ERROR = 'ERROR',\n}\n\nexport interface Lifecycle {\n  open?(ctx?: Context): Promise<any> | any;\n  close?(): Promise<any> | any;\n}\n\n// Feature flag to be enabled later.\nconst CLOSE_RESOURCE_ON_UNHANDLED_ERROR = false;\n\n/**\n * Base class for resources that need to be opened and closed.\n */\nexport abstract class Resource implements Lifecycle {\n  #lifecycleState = LifecycleState.CLOSED;\n  #openPromise: Promise<void> | null = null;\n  #closePromise: Promise<void> | null = null;\n\n  /**\n   * Managed internally by the resource.\n   * Recreated on close.\n   * Errors are propagated to the `_catch` method and the parent context.\n   */\n  #internalCtx: Context = this.#createContext();\n\n  /**\n   * Context that is used to bubble up errors that are not handled by the resource.\n   * Provided in the open method.\n   */\n  #parentCtx: Context = new Context({ name: this.#name });\n\n  get #name() {\n    return Object.getPrototypeOf(this).constructor.name;\n  }\n\n  protected get _lifecycleState() {\n    return this.#lifecycleState;\n  }\n\n  protected get _ctx() {\n    return this.#internalCtx;\n  }\n\n  /**\n   * To be overridden by subclasses.\n   */\n  protected async _open(ctx: Context): Promise<void> {}\n\n  /**\n   * To be overridden by subclasses.\n   */\n  protected async _close(ctx: Context): Promise<void> {}\n\n  /**\n   * Error handler for errors that are caught by the context.\n   * By default, errors are bubbled up to the parent context which is passed to the open method.\n   */\n  protected async _catch(err: Error): Promise<void> {\n    if (CLOSE_RESOURCE_ON_UNHANDLED_ERROR) {\n      try {\n        await this.close();\n      } catch (doubleErr: any) {\n        throwUnhandledError(doubleErr);\n      }\n    }\n    throw err;\n  }\n\n  /**\n   * Opens the resource.\n   * If the resource is already open, it does nothing.\n   * If the resource is in an error state, it throws an error.\n   * If the resource is closed, it waits for it to close and then opens it.\n   * @param ctx - Context to use for opening the resource. This context will receive errors that are not handled in `_catch`.\n   */\n  async open(ctx?: Context): Promise<this> {\n    switch (this.#lifecycleState) {\n      case LifecycleState.OPEN:\n        return this;\n      case LifecycleState.ERROR:\n        throw new Error(`Invalid state: ${this.#lifecycleState}`);\n      default:\n    }\n\n    await this.#closePromise;\n    await (this.#openPromise ??= this.#open(ctx));\n\n    return this;\n  }\n\n  /**\n   * Closes the resource.\n   * If the resource is already closed, it does nothing.\n   */\n  async close(ctx?: Context): Promise<this> {\n    if (this.#lifecycleState === LifecycleState.CLOSED) {\n      return this;\n    }\n    await this.#openPromise;\n    await (this.#closePromise ??= this.#close(ctx));\n\n    return this;\n  }\n\n  async [Symbol.asyncDispose]() {\n    await this.close();\n  }\n\n  async #open(ctx?: Context) {\n    this.#closePromise = null;\n    if (ctx) {\n      this.#parentCtx = ctx.derive({ name: this.#name });\n    }\n    await this._open(this.#parentCtx);\n    this.#lifecycleState = LifecycleState.OPEN;\n  }\n\n  async #close(ctx = Context.default()) {\n    this.#openPromise = null;\n    await this.#internalCtx.dispose();\n    await this._close(ctx);\n    this.#internalCtx = this.#createContext();\n    this.#lifecycleState = LifecycleState.CLOSED;\n  }\n\n  #createContext() {\n    return new Context({\n      onError: (error) =>\n        queueMicrotask(async () => {\n          try {\n            await this._catch(error);\n          } catch (err: any) {\n            this.#lifecycleState = LifecycleState.ERROR;\n            this.#parentCtx.raise(err);\n          }\n        }),\n    });\n  }\n}\n\nexport const openInContext = async <T extends Lifecycle>(ctx: Context, resource: T): Promise<T> => {\n  await resource.open?.(ctx);\n  ctx.onDispose(() => resource.close?.());\n\n  return resource;\n};\n"],
+  "mappings": "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",
+  "names": ["inspect", "log", "safeInstanceof", "ContextDisposedError", "Error", "constructor", "MAX_SAFE_DISPOSE_CALLBACKS", "DEFAULT_ERROR_HANDLER", "error", "ctx", "ContextDisposedError", "dispose", "Context", "constructor", "name", "parent", "attributes", "onError", "undefined", "maxSafeDisposeCallbacks", "Symbol", "inspect", "toString", "toStringTag", "custom", "default", "disposed", "disposeCallbacksLength", "length", "onDispose", "callback", "log", "catch", "push", "warn", "count", "index", "indexOf", "splice", "throwOnError", "resolveDispose", "promise", "Promise", "resolve", "callbacks", "Array", "from", "reverse", "context", "i", "clean", "errors", "err", "AggregateError", "raise", "reject", "derive", "newCtx", "clearDispose", "getAttribute", "key", "safeInstanceof", "rejectOnDispose", "ctx", "error", "ContextDisposedError", "Promise", "resolve", "reject", "onDispose", "cancelWithContext", "promise", "clearDispose", "race", "finally", "throwUnhandledError", "LifecycleState", "CLOSE_RESOURCE_ON_UNHANDLED_ERROR", "Resource", "Context", "name", "Object", "getPrototypeOf", "constructor", "_lifecycleState", "_ctx", "_open", "ctx", "_close", "_catch", "err", "close", "doubleErr", "throwUnhandledError", "open", "Error", "Symbol", "asyncDispose", "derive", "default", "dispose", "onError", "error", "queueMicrotask", "raise", "openInContext", "resource", "onDispose"]
 }

package/dist/lib/browser/meta.json

@@ -1 +1 @@
-{"inputs":{"packages/common/context/src/context-disposed-error.ts":{"bytes":817,"imports":[],"format":"esm"},"packages/common/context/src/context.ts":{"bytes":21471,"imports":[{"path":"@dxos/node-std/util","kind":"import-statement","external":true},{"path":"@dxos/log","kind":"import-statement","external":true},{"path":"@dxos/util","kind":"import-statement","external":true},{"path":"packages/common/context/src/context-disposed-error.ts","kind":"import-statement","original":"./context-disposed-error"}],"format":"esm"},"packages/common/context/src/promise-utils.ts":{"bytes":3040,"imports":[{"path":"packages/common/context/src/context-disposed-error.ts","kind":"import-statement","original":"./context-disposed-error"}],"format":"esm"},"packages/common/context/src/resource.ts":{"bytes":11744,"imports":[{"path":"@dxos/util","kind":"import-statement","external":true},{"path":"packages/common/context/src/context.ts","kind":"import-statement","original":"./context"}],"format":"esm"},"packages/common/context/src/index.ts":{"bytes":777,"imports":[{"path":"packages/common/context/src/context.ts","kind":"import-statement","original":"./context"},{"path":"packages/common/context/src/promise-utils.ts","kind":"import-statement","original":"./promise-utils"},{"path":"packages/common/context/src/context-disposed-error.ts","kind":"import-statement","original":"./context-disposed-error"},{"path":"packages/common/context/src/resource.ts","kind":"import-statement","original":"./resource"}],"format":"esm"}},"outputs":{"packages/common/context/dist/lib/browser/index.mjs.map":{"imports":[],"exports":[],"inputs":{},"bytes":17016},"packages/common/context/dist/lib/browser/index.mjs":{"imports":[{"path":"@dxos/node-std/util","kind":"import-statement","external":true},{"path":"@dxos/log","kind":"import-statement","external":true},{"path":"@dxos/util","kind":"import-statement","external":true},{"path":"@dxos/util","kind":"import-statement","external":true}],"exports":["Context","ContextDisposedError","LifecycleState","Resource","cancelWithContext","openInContext","rejectOnDispose"],"entryPoint":"packages/common/context/src/index.ts","inputs":{"packages/common/context/src/context.ts":{"bytesInOutput":5903},"packages/common/context/src/context-disposed-error.ts":{"bytesInOutput":106},"packages/common/context/src/index.ts":{"bytesInOutput":0},"packages/common/context/src/promise-utils.ts":{"bytesInOutput":410},"packages/common/context/src/resource.ts":{"bytesInOutput":2979}},"bytes":9802}}}
+{"inputs":{"packages/common/context/src/context-disposed-error.ts":{"bytes":853,"imports":[],"format":"esm"},"packages/common/context/src/context.ts":{"bytes":22853,"imports":[{"path":"@dxos/node-std/util","kind":"import-statement","external":true},{"path":"@dxos/log","kind":"import-statement","external":true},{"path":"@dxos/util","kind":"import-statement","external":true},{"path":"packages/common/context/src/context-disposed-error.ts","kind":"import-statement","original":"./context-disposed-error"}],"format":"esm"},"packages/common/context/src/promise-utils.ts":{"bytes":3096,"imports":[{"path":"packages/common/context/src/context-disposed-error.ts","kind":"import-statement","original":"./context-disposed-error"}],"format":"esm"},"packages/common/context/src/resource.ts":{"bytes":13662,"imports":[{"path":"@dxos/util","kind":"import-statement","external":true},{"path":"packages/common/context/src/context.ts","kind":"import-statement","original":"./context"}],"format":"esm"},"packages/common/context/src/index.ts":{"bytes":809,"imports":[{"path":"packages/common/context/src/context.ts","kind":"import-statement","original":"./context"},{"path":"packages/common/context/src/promise-utils.ts","kind":"import-statement","original":"./promise-utils"},{"path":"packages/common/context/src/context-disposed-error.ts","kind":"import-statement","original":"./context-disposed-error"},{"path":"packages/common/context/src/resource.ts","kind":"import-statement","original":"./resource"}],"format":"esm"}},"outputs":{"packages/common/context/dist/lib/browser/index.mjs.map":{"imports":[],"exports":[],"inputs":{},"bytes":18172},"packages/common/context/dist/lib/browser/index.mjs":{"imports":[{"path":"@dxos/node-std/util","kind":"import-statement","external":true},{"path":"@dxos/log","kind":"import-statement","external":true},{"path":"@dxos/util","kind":"import-statement","external":true},{"path":"@dxos/util","kind":"import-statement","external":true}],"exports":["Context","ContextDisposedError","LifecycleState","Resource","cancelWithContext","openInContext","rejectOnDispose"],"entryPoint":"packages/common/context/src/index.ts","inputs":{"packages/common/context/src/context.ts":{"bytesInOutput":6283},"packages/common/context/src/context-disposed-error.ts":{"bytesInOutput":106},"packages/common/context/src/index.ts":{"bytesInOutput":0},"packages/common/context/src/promise-utils.ts":{"bytesInOutput":410},"packages/common/context/src/resource.ts":{"bytesInOutput":3372}},"bytes":10575}}}

package/dist/lib/node/index.cjs

@@ -48,25 +48,28 @@ function _ts_decorate(decorators, target, key, desc) {
 }
 var __dxlog_file = "/home/runner/work/dxos/dxos/packages/common/context/src/context.ts";
 var MAX_SAFE_DISPOSE_CALLBACKS = 300;
+var DEFAULT_ERROR_HANDLER = (error, ctx) => {
+  if (error instanceof ContextDisposedError) {
+    return;
+  }
+  void ctx.dispose();
+  throw error;
+};
 var _a, _b;
 var Context = class _Context {
-  constructor({ name, parent, attributes = {}, onError = (error) => {
-    if (error instanceof ContextDisposedError) {
-      return;
-    }
-    void this.dispose();
-    throw error;
-  } } = {}) {
-    this._disposeCallbacks = [];
-    this._isDisposed = false;
-    this._disposePromise = void 0;
+  constructor({ name, parent, attributes = {}, onError = DEFAULT_ERROR_HANDLER } = {}) {
+    this.#disposeCallbacks = [];
+    this.#name = void 0;
+    this.#parent = void 0;
+    this.#isDisposed = false;
+    this.#disposePromise = void 0;
     this.maxSafeDisposeCallbacks = MAX_SAFE_DISPOSE_CALLBACKS;
     this[_a] = "Context";
     this[_b] = () => this.toString();
-    this._name = name;
-    this._parent = parent;
-    this._attributes = attributes;
-    this._onError = onError;
+    this.#name = name;
+    this.#parent = parent;
+    this.#attributes = attributes;
+    this.#onError = onError;
   }
   static {
     _a = Symbol.toStringTag, _b = import_node_util.inspect.custom;
@@ -74,11 +77,18 @@ var Context = class _Context {
   static default() {
     return new _Context();
   }
+  #disposeCallbacks;
+  #name;
+  #parent;
+  #attributes;
+  #onError;
+  #isDisposed;
+  #disposePromise;
   get disposed() {
-    return this._isDisposed;
+    return this.#isDisposed;
   }
   get disposeCallbacksLength() {
-    return this._disposeCallbacks.length;
+    return this.#disposeCallbacks.length;
   }
   /**
   * Schedules a callback to run when the context is disposed.
@@ -90,35 +100,35 @@ var Context = class _Context {
   * @returns A function that can be used to remove the callback from the dispose list.
   */
   onDispose(callback) {
-    if (this._isDisposed) {
+    if (this.#isDisposed) {
       void (async () => {
         try {
           await callback();
         } catch (error) {
           import_log.log.catch(error, void 0, {
             F: __dxlog_file,
-            L: 91,
+            L: 88,
             S: this,
             C: (f, a) => f(...a)
           });
         }
       })();
     }
-    this._disposeCallbacks.push(callback);
-    if (this._disposeCallbacks.length > this.maxSafeDisposeCallbacks) {
+    this.#disposeCallbacks.push(callback);
+    if (this.#disposeCallbacks.length > this.maxSafeDisposeCallbacks) {
       import_log.log.warn("Context has a large number of dispose callbacks (this might be a memory leak).", {
-        count: this._disposeCallbacks.length
+        count: this.#disposeCallbacks.length
       }, {
         F: __dxlog_file,
-        L: 98,
+        L: 95,
         S: this,
         C: (f, a) => f(...a)
       });
     }
     return () => {
-      const index = this._disposeCallbacks.indexOf(callback);
+      const index = this.#disposeCallbacks.indexOf(callback);
       if (index !== -1) {
-        this._disposeCallbacks.splice(index, 1);
+        this.#disposeCallbacks.splice(index, 1);
       }
     };
   }
@@ -130,57 +140,63 @@ var Context = class _Context {
   * Disposing context means that onDispose will throw an error and any errors raised will be logged and not propagated.
   */
   async dispose(throwOnError = false) {
-    if (this._disposePromise) {
-      return this._disposePromise;
+    if (this.#disposePromise) {
+      return this.#disposePromise;
     }
-    this._isDisposed = true;
+    this.#isDisposed = true;
     let resolveDispose;
-    this._disposePromise = new Promise((resolve) => {
+    const promise = new Promise((resolve) => {
       resolveDispose = resolve;
     });
-    const callbacks = Array.from(this._disposeCallbacks).reverse();
-    this._disposeCallbacks.length = 0;
-    if (this._name) {
+    this.#disposePromise = promise;
+    const callbacks = Array.from(this.#disposeCallbacks).reverse();
+    this.#disposeCallbacks.length = 0;
+    if (this.#name) {
       (0, import_log.log)("disposing", {
-        context: this._name,
+        context: this.#name,
         count: callbacks.length
       }, {
         F: __dxlog_file,
-        L: 139,
+        L: 137,
         S: this,
         C: (f, a) => f(...a)
       });
     }
     let i = 0;
     let clean = true;
+    const errors = [];
     for (const callback of callbacks) {
       try {
         await callback();
         i++;
       } catch (err) {
-        import_log.log.catch(err, {
-          context: this._name,
-          callback: i,
-          count: callbacks.length
-        }, {
-          F: __dxlog_file,
-          L: 149,
-          S: this,
-          C: (f, a) => f(...a)
-        });
         clean = false;
         if (throwOnError) {
-          throw err;
+          errors.push(err);
+        } else {
+          import_log.log.catch(err, {
+            context: this.#name,
+            callback: i,
+            count: callbacks.length
+          }, {
+            F: __dxlog_file,
+            L: 152,
+            S: this,
+            C: (f, a) => f(...a)
+          });
         }
       }
     }
+    if (errors.length > 0) {
+      throw new AggregateError(errors);
+    }
     resolveDispose(clean);
-    if (this._name) {
+    if (this.#name) {
       (0, import_log.log)("disposed", {
-        context: this._name
+        context: this.#name
       }, {
         F: __dxlog_file,
-        L: 159,
+        L: 163,
         S: this,
         C: (f, a) => f(...a)
       });
@@ -193,11 +209,11 @@ var Context = class _Context {
   * IF the error handler is not set, the error will dispose the context and cause an unhandled rejection.
   */
   raise(error) {
-    if (this._isDisposed) {
+    if (this.#isDisposed) {
       return;
     }
     try {
-      this._onError(error);
+      this.#onError(error, this);
     } catch (err) {
       void Promise.reject(err);
     }
@@ -210,7 +226,7 @@ var Context = class _Context {
           this.raise(error);
         } else {
           try {
-            await onError(error);
+            await onError(error, this);
           } catch {
             this.raise(error);
           }
@@ -223,16 +239,16 @@ var Context = class _Context {
     return newCtx;
   }
   getAttribute(key) {
-    if (key in this._attributes) {
-      return this._attributes[key];
+    if (key in this.#attributes) {
+      return this.#attributes[key];
     }
-    if (this._parent) {
-      return this._parent.getAttribute(key);
+    if (this.#parent) {
+      return this.#parent.getAttribute(key);
     }
     return void 0;
   }
   toString() {
-    return `Context(${this._isDisposed ? "disposed" : "active"})`;
+    return `Context(${this.#isDisposed ? "disposed" : "active"})`;
   }
 };
 Context = _ts_decorate([
@@ -256,6 +272,7 @@ var LifecycleState;
   LifecycleState2["OPEN"] = "OPEN";
   LifecycleState2["ERROR"] = "ERROR";
 })(LifecycleState || (LifecycleState = {}));
+var CLOSE_RESOURCE_ON_UNHANDLED_ERROR = false;
 var Resource = class {
   #lifecycleState = "CLOSED";
   #openPromise = null;
@@ -270,7 +287,12 @@ var Resource = class {
   * Context that is used to bubble up errors that are not handled by the resource.
   * Provided in the open method.
   */
-  #parentCtx = new Context();
+  #parentCtx = new Context({
+    name: this.#name
+  });
+  get #name() {
+    return Object.getPrototypeOf(this).constructor.name;
+  }
   get _lifecycleState() {
     return this.#lifecycleState;
   }
@@ -292,6 +314,13 @@ var Resource = class {
   * By default, errors are bubbled up to the parent context which is passed to the open method.
   */
   async _catch(err) {
+    if (CLOSE_RESOURCE_ON_UNHANDLED_ERROR) {
+      try {
+        await this.close();
+      } catch (doubleErr) {
+        (0, import_util2.throwUnhandledError)(doubleErr);
+      }
+    }
     throw err;
   }
   /**
@@ -331,12 +360,14 @@ var Resource = class {
   async #open(ctx) {
     this.#closePromise = null;
     if (ctx) {
-      this.#parentCtx = ctx;
+      this.#parentCtx = ctx.derive({
+        name: this.#name
+      });
     }
     await this._open(this.#parentCtx);
     this.#lifecycleState = "OPEN";
   }
-  async #close(ctx = new Context()) {
+  async #close(ctx = Context.default()) {
     this.#openPromise = null;
     await this.#internalCtx.dispose();
     await this._close(ctx);

package/dist/lib/node/index.cjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/context.ts", "../../../src/context-disposed-error.ts", "../../../src/promise-utils.ts", "../../../src/resource.ts"],
-  "sourcesContent": ["//\n// Copyright 2022 DXOS.org\n//\n\nimport { inspect } from 'node:util';\n\nimport { log } from '@dxos/log';\nimport { safeInstanceof } from '@dxos/util';\n\nimport { ContextDisposedError } from './context-disposed-error';\n\nexport type ContextErrorHandler = (error: Error) => void;\n\nexport type DisposeCallback = () => any | Promise<any>;\n\nexport type CreateContextParams = {\n  name?: string;\n  parent?: Context;\n  attributes?: Record<string, any>;\n  onError?: ContextErrorHandler;\n};\n\n/**\n * Maximum number of dispose callbacks before we start logging warnings.\n */\nconst MAX_SAFE_DISPOSE_CALLBACKS = 300;\n\n@safeInstanceof('Context')\nexport class Context {\n  static default() {\n    return new Context();\n  }\n\n  private readonly _disposeCallbacks: DisposeCallback[] = [];\n\n  private readonly _name?: string;\n  private readonly _parent?: Context;\n  private readonly _attributes: Record<string, any>;\n  private readonly _onError: ContextErrorHandler;\n\n  private _isDisposed = false;\n  private _disposePromise?: Promise<boolean> = undefined;\n\n  public maxSafeDisposeCallbacks = MAX_SAFE_DISPOSE_CALLBACKS;\n\n  constructor({\n    name, // TODO(burdon): Automate?\n    parent,\n    attributes = {},\n    onError = (error) => {\n      if (error instanceof ContextDisposedError) {\n        return;\n      }\n\n      void this.dispose();\n\n      // Will generate an unhandled rejection.\n      throw error;\n    },\n  }: CreateContextParams = {}) {\n    this._name = name;\n    this._parent = parent;\n    this._attributes = attributes;\n    this._onError = onError;\n  }\n\n  get disposed() {\n    return this._isDisposed;\n  }\n\n  get disposeCallbacksLength() {\n    return this._disposeCallbacks.length;\n  }\n\n  /**\n   * Schedules a callback to run when the context is disposed.\n   * May be async, in this case the disposer might choose to wait for all resource to released.\n   * Throwing an error inside the callback will result in the error being logged, but not re-thrown.\n   *\n   * NOTE: Will call the callback immediately if the context is already disposed.\n   *\n   * @returns A function that can be used to remove the callback from the dispose list.\n   */\n  onDispose(callback: DisposeCallback): () => void {\n    if (this._isDisposed) {\n      // Call the callback immediately if the context is already disposed.\n      void (async () => {\n        try {\n          await callback();\n        } catch (error: any) {\n          log.catch(error);\n        }\n      })();\n    }\n\n    this._disposeCallbacks.push(callback);\n    if (this._disposeCallbacks.length > this.maxSafeDisposeCallbacks) {\n      log.warn('Context has a large number of dispose callbacks (this might be a memory leak).', {\n        count: this._disposeCallbacks.length,\n      });\n    }\n\n    // Remove handler.\n    return () => {\n      const index = this._disposeCallbacks.indexOf(callback);\n      if (index !== -1) {\n        this._disposeCallbacks.splice(index, 1);\n      }\n    };\n  }\n\n  /**\n   * Runs all dispose callbacks.\n   * Callbacks are run in the reverse order they were added.\n   * This function never throws.\n   * It is safe to ignore the returned promise if the caller does not wish to wait for callbacks to complete.\n   * Disposing context means that onDispose will throw an error and any errors raised will be logged and not propagated.\n   */\n  async dispose(throwOnError = false): Promise<boolean> {\n    if (this._disposePromise) {\n      return this._disposePromise;\n    }\n\n    // TODO(burdon): Probably should not be set until the dispose is complete, but causes tests to fail if moved.\n    this._isDisposed = true;\n\n    // Set the promise before running the callbacks.\n    let resolveDispose!: (value: boolean) => void;\n    this._disposePromise = new Promise<boolean>((resolve) => {\n      resolveDispose = resolve;\n    });\n\n    // Process last first.\n    // Clone the array so that any mutations to the original array don't affect the dispose process.\n    const callbacks = Array.from(this._disposeCallbacks).reverse();\n    this._disposeCallbacks.length = 0;\n\n    if (this._name) {\n      log('disposing', { context: this._name, count: callbacks.length });\n    }\n\n    let i = 0;\n    let clean = true;\n    for (const callback of callbacks) {\n      try {\n        await callback();\n        i++;\n      } catch (err: any) {\n        log.catch(err, { context: this._name, callback: i, count: callbacks.length });\n        clean = false;\n        if (throwOnError) {\n          throw err;\n        }\n      }\n    }\n\n    resolveDispose(clean);\n    if (this._name) {\n      log('disposed', { context: this._name });\n    }\n\n    return clean;\n  }\n\n  /**\n   * Raise the error inside the context.\n   * The error will be propagated to the error handler.\n   * IF the error handler is not set, the error will dispose the context and cause an unhandled rejection.\n   */\n  raise(error: Error): void {\n    if (this._isDisposed) {\n      // TODO(dmaretskyi): Don't log those.\n      // log.warn('Error in disposed context', error);\n      return;\n    }\n\n    try {\n      this._onError(error);\n    } catch (err) {\n      // Generate an unhandled rejection and stop the error propagation.\n      void Promise.reject(err);\n    }\n  }\n\n  derive({ onError, attributes }: CreateContextParams = {}): Context {\n    const newCtx = new Context({\n      // TODO(dmaretskyi): Optimize to not require allocating a new closure for every context.\n      onError: async (error) => {\n        if (!onError) {\n          this.raise(error);\n        } else {\n          try {\n            await onError(error);\n          } catch {\n            this.raise(error);\n          }\n        }\n      },\n      attributes,\n    });\n\n    const clearDispose = this.onDispose(() => newCtx.dispose());\n    newCtx.onDispose(clearDispose);\n    return newCtx;\n  }\n\n  getAttribute(key: string): any {\n    if (key in this._attributes) {\n      return this._attributes[key];\n    }\n    if (this._parent) {\n      return this._parent.getAttribute(key);\n    }\n\n    return undefined;\n  }\n\n  [Symbol.toStringTag] = 'Context';\n  [inspect.custom] = () => this.toString();\n\n  toString() {\n    return `Context(${this._isDisposed ? 'disposed' : 'active'})`;\n  }\n}\n", "//\n// Copyright 2023 DXOS.org\n//\n\nexport class ContextDisposedError extends Error {\n  constructor() {\n    super('Context disposed.');\n  }\n}\n", "//\n// Copyright 2023 DXOS.org\n//\n\nimport { type Context } from './context';\nimport { ContextDisposedError } from './context-disposed-error';\n\n/**\n * @returns A promise that rejects when the context is disposed.\n */\n// TODO(dmaretskyi): Memory leak.\nexport const rejectOnDispose = (ctx: Context, error = new ContextDisposedError()): Promise<never> =>\n  new Promise((resolve, reject) => {\n    ctx.onDispose(() => reject(error));\n  });\n\n/**\n * Rejects the promise if the context is disposed.\n */\nexport const cancelWithContext = <T>(ctx: Context, promise: Promise<T>): Promise<T> => {\n  let clearDispose: () => void;\n  return Promise.race([\n    promise,\n    new Promise<never>((resolve, reject) => {\n      // Will be called before .finally() handlers.\n      clearDispose = ctx.onDispose(() => reject(new ContextDisposedError()));\n    }),\n  ]).finally(() => clearDispose?.());\n};\n", "//\n// Copyright 2024 DXOS.org\n//\n\nimport '@dxos/util';\n\nimport { Context } from './context';\n\nexport enum LifecycleState {\n  CLOSED = 'CLOSED',\n  OPEN = 'OPEN',\n  ERROR = 'ERROR',\n}\n\nexport interface Lifecycle {\n  open?(ctx?: Context): Promise<any> | any;\n  close?(): Promise<any> | any;\n}\n\n/**\n * Base class for resources that need to be opened and closed.\n */\nexport abstract class Resource implements Lifecycle {\n  #lifecycleState = LifecycleState.CLOSED;\n  #openPromise: Promise<void> | null = null;\n  #closePromise: Promise<void> | null = null;\n\n  /**\n   * Managed internally by the resource.\n   * Recreated on close.\n   * Errors are propagated to the `_catch` method and the parent context.\n   */\n  #internalCtx: Context = this.#createContext();\n\n  /**\n   * Context that is used to bubble up errors that are not handled by the resource.\n   * Provided in the open method.\n   */\n  #parentCtx: Context = new Context();\n\n  protected get _lifecycleState() {\n    return this.#lifecycleState;\n  }\n\n  protected get _ctx() {\n    return this.#internalCtx;\n  }\n\n  /**\n   * To be overridden by subclasses.\n   */\n  protected async _open(ctx: Context): Promise<void> {}\n\n  /**\n   * To be overridden by subclasses.\n   */\n  protected async _close(ctx: Context): Promise<void> {}\n\n  /**\n   * Error handler for errors that are caught by the context.\n   * By default, errors are bubbled up to the parent context which is passed to the open method.\n   */\n  protected async _catch(err: Error): Promise<void> {\n    throw err;\n  }\n\n  /**\n   * Opens the resource.\n   * If the resource is already open, it does nothing.\n   * If the resource is in an error state, it throws an error.\n   * If the resource is closed, it waits for it to close and then opens it.\n   * @param ctx - Context to use for opening the resource. This context will receive errors that are not handled in `_catch`.\n   */\n  async open(ctx?: Context): Promise<this> {\n    switch (this.#lifecycleState) {\n      case LifecycleState.OPEN:\n        return this;\n      case LifecycleState.ERROR:\n        throw new Error(`Invalid state: ${this.#lifecycleState}`);\n      default:\n    }\n\n    await this.#closePromise;\n    await (this.#openPromise ??= this.#open(ctx));\n\n    return this;\n  }\n\n  /**\n   * Closes the resource.\n   * If the resource is already closed, it does nothing.\n   */\n  async close(ctx?: Context): Promise<this> {\n    if (this.#lifecycleState === LifecycleState.CLOSED) {\n      return this;\n    }\n    await this.#openPromise;\n    await (this.#closePromise ??= this.#close(ctx));\n\n    return this;\n  }\n\n  async [Symbol.asyncDispose]() {\n    await this.close();\n  }\n\n  async #open(ctx?: Context) {\n    this.#closePromise = null;\n    if (ctx) {\n      this.#parentCtx = ctx;\n    }\n    await this._open(this.#parentCtx);\n    this.#lifecycleState = LifecycleState.OPEN;\n  }\n\n  async #close(ctx = new Context()) {\n    this.#openPromise = null;\n    await this.#internalCtx.dispose();\n    await this._close(ctx);\n    this.#internalCtx = this.#createContext();\n    this.#lifecycleState = LifecycleState.CLOSED;\n  }\n\n  #createContext() {\n    return new Context({\n      onError: (error) =>\n        queueMicrotask(async () => {\n          try {\n            await this._catch(error);\n          } catch (err: any) {\n            this.#lifecycleState = LifecycleState.ERROR;\n            this.#parentCtx.raise(err);\n          }\n        }),\n    });\n  }\n}\n\nexport const openInContext = async <T extends Lifecycle>(ctx: Context, resource: T): Promise<T> => {\n  await resource.open?.(ctx);\n  ctx.onDispose(() => resource.close?.());\n\n  return resource;\n};\n"],
-  "mappings": "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",
-  "names": ["import_util", "ContextDisposedError", "Error", "constructor", "MAX_SAFE_DISPOSE_CALLBACKS", "Context", "name", "parent", "attributes", "onError", "error", "dispose", "_disposeCallbacks", "_isDisposed", "_disposePromise", "undefined", "maxSafeDisposeCallbacks", "Symbol", "inspect", "toString", "_name", "_parent", "_attributes", "_onError", "toStringTag", "custom", "default", "disposed", "disposeCallbacksLength", "length", "onDispose", "callback", "log", "catch", "push", "warn", "count", "index", "indexOf", "splice", "throwOnError", "resolveDispose", "Promise", "resolve", "callbacks", "Array", "from", "reverse", "context", "i", "clean", "err", "raise", "reject", "derive", "newCtx", "clearDispose", "getAttribute", "key", "safeInstanceof", "rejectOnDispose", "ctx", "cancelWithContext", "promise", "race", "finally", "LifecycleState", "Resource", "_lifecycleState", "_ctx", "_open", "_close", "_catch", "open", "close", "asyncDispose", "queueMicrotask", "openInContext", "resource"]
+  "sourcesContent": ["//\n// Copyright 2022 DXOS.org\n//\n\nimport { inspect } from 'node:util';\n\nimport { log } from '@dxos/log';\nimport { safeInstanceof } from '@dxos/util';\n\nimport { ContextDisposedError } from './context-disposed-error';\n\nexport type ContextErrorHandler = (error: Error, ctx: Context) => void;\n\nexport type DisposeCallback = () => any | Promise<any>;\n\nexport type CreateContextParams = {\n  name?: string;\n  parent?: Context;\n  attributes?: Record<string, any>;\n  onError?: ContextErrorHandler;\n};\n\n/**\n * Maximum number of dispose callbacks before we start logging warnings.\n */\nconst MAX_SAFE_DISPOSE_CALLBACKS = 300;\n\nconst DEFAULT_ERROR_HANDLER: ContextErrorHandler = (error, ctx) => {\n  if (error instanceof ContextDisposedError) {\n    return;\n  }\n\n  void ctx.dispose();\n\n  // Will generate an unhandled rejection.\n  throw error;\n};\n\n@safeInstanceof('Context')\nexport class Context {\n  static default() {\n    return new Context();\n  }\n\n  readonly #disposeCallbacks: DisposeCallback[] = [];\n\n  readonly #name?: string = undefined;\n  readonly #parent?: Context = undefined;\n  readonly #attributes: Record<string, any>;\n  readonly #onError: ContextErrorHandler;\n\n  #isDisposed = false;\n  #disposePromise?: Promise<boolean> = undefined;\n\n  public maxSafeDisposeCallbacks = MAX_SAFE_DISPOSE_CALLBACKS;\n\n  constructor({ name, parent, attributes = {}, onError = DEFAULT_ERROR_HANDLER }: CreateContextParams = {}) {\n    this.#name = name;\n    this.#parent = parent;\n    this.#attributes = attributes;\n    this.#onError = onError;\n  }\n\n  get disposed() {\n    return this.#isDisposed;\n  }\n\n  get disposeCallbacksLength() {\n    return this.#disposeCallbacks.length;\n  }\n\n  /**\n   * Schedules a callback to run when the context is disposed.\n   * May be async, in this case the disposer might choose to wait for all resource to released.\n   * Throwing an error inside the callback will result in the error being logged, but not re-thrown.\n   *\n   * NOTE: Will call the callback immediately if the context is already disposed.\n   *\n   * @returns A function that can be used to remove the callback from the dispose list.\n   */\n  onDispose(callback: DisposeCallback): () => void {\n    if (this.#isDisposed) {\n      // Call the callback immediately if the context is already disposed.\n      void (async () => {\n        try {\n          await callback();\n        } catch (error: any) {\n          log.catch(error);\n        }\n      })();\n    }\n\n    this.#disposeCallbacks.push(callback);\n    if (this.#disposeCallbacks.length > this.maxSafeDisposeCallbacks) {\n      log.warn('Context has a large number of dispose callbacks (this might be a memory leak).', {\n        count: this.#disposeCallbacks.length,\n      });\n    }\n\n    // Remove handler.\n    return () => {\n      const index = this.#disposeCallbacks.indexOf(callback);\n      if (index !== -1) {\n        this.#disposeCallbacks.splice(index, 1);\n      }\n    };\n  }\n\n  /**\n   * Runs all dispose callbacks.\n   * Callbacks are run in the reverse order they were added.\n   * This function never throws.\n   * It is safe to ignore the returned promise if the caller does not wish to wait for callbacks to complete.\n   * Disposing context means that onDispose will throw an error and any errors raised will be logged and not propagated.\n   */\n  async dispose(throwOnError = false): Promise<boolean> {\n    if (this.#disposePromise) {\n      return this.#disposePromise;\n    }\n\n    // TODO(burdon): Probably should not be set until the dispose is complete, but causes tests to fail if moved.\n    this.#isDisposed = true;\n\n    // Set the promise before running the callbacks.\n    let resolveDispose!: (value: boolean) => void;\n    const promise = new Promise<boolean>((resolve) => {\n      resolveDispose = resolve;\n    });\n    this.#disposePromise = promise;\n\n    // Process last first.\n    // Clone the array so that any mutations to the original array don't affect the dispose process.\n    const callbacks = Array.from(this.#disposeCallbacks).reverse();\n    this.#disposeCallbacks.length = 0;\n\n    if (this.#name) {\n      log('disposing', { context: this.#name, count: callbacks.length });\n    }\n\n    let i = 0;\n    let clean = true;\n    const errors: Error[] = [];\n    for (const callback of callbacks) {\n      try {\n        await callback();\n        i++;\n      } catch (err: any) {\n        clean = false;\n        if (throwOnError) {\n          errors.push(err);\n        } else {\n          log.catch(err, { context: this.#name, callback: i, count: callbacks.length });\n        }\n      }\n    }\n\n    if (errors.length > 0) {\n      throw new AggregateError(errors);\n    }\n\n    resolveDispose(clean);\n    if (this.#name) {\n      log('disposed', { context: this.#name });\n    }\n\n    return clean;\n  }\n\n  /**\n   * Raise the error inside the context.\n   * The error will be propagated to the error handler.\n   * IF the error handler is not set, the error will dispose the context and cause an unhandled rejection.\n   */\n  raise(error: Error): void {\n    if (this.#isDisposed) {\n      // TODO(dmaretskyi): Don't log those.\n      // log.warn('Error in disposed context', error);\n      return;\n    }\n\n    try {\n      this.#onError(error, this);\n    } catch (err) {\n      // Generate an unhandled rejection and stop the error propagation.\n      void Promise.reject(err);\n    }\n  }\n\n  derive({ onError, attributes }: CreateContextParams = {}): Context {\n    const newCtx = new Context({\n      // TODO(dmaretskyi): Optimize to not require allocating a new closure for every context.\n      onError: async (error) => {\n        if (!onError) {\n          this.raise(error);\n        } else {\n          try {\n            await onError(error, this);\n          } catch {\n            this.raise(error);\n          }\n        }\n      },\n      attributes,\n    });\n\n    const clearDispose = this.onDispose(() => newCtx.dispose());\n    newCtx.onDispose(clearDispose);\n    return newCtx;\n  }\n\n  getAttribute(key: string): any {\n    if (key in this.#attributes) {\n      return this.#attributes[key];\n    }\n    if (this.#parent) {\n      return this.#parent.getAttribute(key);\n    }\n\n    return undefined;\n  }\n\n  [Symbol.toStringTag] = 'Context';\n  [inspect.custom] = () => this.toString();\n\n  toString() {\n    return `Context(${this.#isDisposed ? 'disposed' : 'active'})`;\n  }\n}\n", "//\n// Copyright 2023 DXOS.org\n//\n\nexport class ContextDisposedError extends Error {\n  constructor() {\n    super('Context disposed.');\n  }\n}\n", "//\n// Copyright 2023 DXOS.org\n//\n\nimport { type Context } from './context';\nimport { ContextDisposedError } from './context-disposed-error';\n\n/**\n * @returns A promise that rejects when the context is disposed.\n */\n// TODO(dmaretskyi): Memory leak.\nexport const rejectOnDispose = (ctx: Context, error = new ContextDisposedError()): Promise<never> =>\n  new Promise((resolve, reject) => {\n    ctx.onDispose(() => reject(error));\n  });\n\n/**\n * Rejects the promise if the context is disposed.\n */\nexport const cancelWithContext = <T>(ctx: Context, promise: Promise<T>): Promise<T> => {\n  let clearDispose: () => void;\n  return Promise.race([\n    promise,\n    new Promise<never>((resolve, reject) => {\n      // Will be called before .finally() handlers.\n      clearDispose = ctx.onDispose(() => reject(new ContextDisposedError()));\n    }),\n  ]).finally(() => clearDispose?.());\n};\n", "//\n// Copyright 2024 DXOS.org\n//\n\nimport { throwUnhandledError } from '@dxos/util';\n\nimport { Context } from './context';\n\nexport enum LifecycleState {\n  CLOSED = 'CLOSED',\n  OPEN = 'OPEN',\n  ERROR = 'ERROR',\n}\n\nexport interface Lifecycle {\n  open?(ctx?: Context): Promise<any> | any;\n  close?(): Promise<any> | any;\n}\n\n// Feature flag to be enabled later.\nconst CLOSE_RESOURCE_ON_UNHANDLED_ERROR = false;\n\n/**\n * Base class for resources that need to be opened and closed.\n */\nexport abstract class Resource implements Lifecycle {\n  #lifecycleState = LifecycleState.CLOSED;\n  #openPromise: Promise<void> | null = null;\n  #closePromise: Promise<void> | null = null;\n\n  /**\n   * Managed internally by the resource.\n   * Recreated on close.\n   * Errors are propagated to the `_catch` method and the parent context.\n   */\n  #internalCtx: Context = this.#createContext();\n\n  /**\n   * Context that is used to bubble up errors that are not handled by the resource.\n   * Provided in the open method.\n   */\n  #parentCtx: Context = new Context({ name: this.#name });\n\n  get #name() {\n    return Object.getPrototypeOf(this).constructor.name;\n  }\n\n  protected get _lifecycleState() {\n    return this.#lifecycleState;\n  }\n\n  protected get _ctx() {\n    return this.#internalCtx;\n  }\n\n  /**\n   * To be overridden by subclasses.\n   */\n  protected async _open(ctx: Context): Promise<void> {}\n\n  /**\n   * To be overridden by subclasses.\n   */\n  protected async _close(ctx: Context): Promise<void> {}\n\n  /**\n   * Error handler for errors that are caught by the context.\n   * By default, errors are bubbled up to the parent context which is passed to the open method.\n   */\n  protected async _catch(err: Error): Promise<void> {\n    if (CLOSE_RESOURCE_ON_UNHANDLED_ERROR) {\n      try {\n        await this.close();\n      } catch (doubleErr: any) {\n        throwUnhandledError(doubleErr);\n      }\n    }\n    throw err;\n  }\n\n  /**\n   * Opens the resource.\n   * If the resource is already open, it does nothing.\n   * If the resource is in an error state, it throws an error.\n   * If the resource is closed, it waits for it to close and then opens it.\n   * @param ctx - Context to use for opening the resource. This context will receive errors that are not handled in `_catch`.\n   */\n  async open(ctx?: Context): Promise<this> {\n    switch (this.#lifecycleState) {\n      case LifecycleState.OPEN:\n        return this;\n      case LifecycleState.ERROR:\n        throw new Error(`Invalid state: ${this.#lifecycleState}`);\n      default:\n    }\n\n    await this.#closePromise;\n    await (this.#openPromise ??= this.#open(ctx));\n\n    return this;\n  }\n\n  /**\n   * Closes the resource.\n   * If the resource is already closed, it does nothing.\n   */\n  async close(ctx?: Context): Promise<this> {\n    if (this.#lifecycleState === LifecycleState.CLOSED) {\n      return this;\n    }\n    await this.#openPromise;\n    await (this.#closePromise ??= this.#close(ctx));\n\n    return this;\n  }\n\n  async [Symbol.asyncDispose]() {\n    await this.close();\n  }\n\n  async #open(ctx?: Context) {\n    this.#closePromise = null;\n    if (ctx) {\n      this.#parentCtx = ctx.derive({ name: this.#name });\n    }\n    await this._open(this.#parentCtx);\n    this.#lifecycleState = LifecycleState.OPEN;\n  }\n\n  async #close(ctx = Context.default()) {\n    this.#openPromise = null;\n    await this.#internalCtx.dispose();\n    await this._close(ctx);\n    this.#internalCtx = this.#createContext();\n    this.#lifecycleState = LifecycleState.CLOSED;\n  }\n\n  #createContext() {\n    return new Context({\n      onError: (error) =>\n        queueMicrotask(async () => {\n          try {\n            await this._catch(error);\n          } catch (err: any) {\n            this.#lifecycleState = LifecycleState.ERROR;\n            this.#parentCtx.raise(err);\n          }\n        }),\n    });\n  }\n}\n\nexport const openInContext = async <T extends Lifecycle>(ctx: Context, resource: T): Promise<T> => {\n  await resource.open?.(ctx);\n  ctx.onDispose(() => resource.close?.());\n\n  return resource;\n};\n"],
+  "mappings": "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",
+  "names": ["import_util", "ContextDisposedError", "Error", "constructor", "MAX_SAFE_DISPOSE_CALLBACKS", "DEFAULT_ERROR_HANDLER", "error", "ctx", "dispose", "Context", "name", "parent", "attributes", "onError", "undefined", "maxSafeDisposeCallbacks", "Symbol", "inspect", "toString", "toStringTag", "custom", "default", "disposed", "disposeCallbacksLength", "length", "onDispose", "callback", "log", "catch", "push", "warn", "count", "index", "indexOf", "splice", "throwOnError", "resolveDispose", "promise", "Promise", "resolve", "callbacks", "Array", "from", "reverse", "context", "i", "clean", "errors", "err", "AggregateError", "raise", "reject", "derive", "newCtx", "clearDispose", "getAttribute", "key", "safeInstanceof", "rejectOnDispose", "cancelWithContext", "race", "finally", "LifecycleState", "CLOSE_RESOURCE_ON_UNHANDLED_ERROR", "Resource", "Object", "getPrototypeOf", "_lifecycleState", "_ctx", "_open", "_close", "_catch", "close", "doubleErr", "throwUnhandledError", "open", "asyncDispose", "queueMicrotask", "openInContext", "resource"]
 }

package/dist/lib/node/meta.json

@@ -1 +1 @@
-{"inputs":{"packages/common/context/src/context-disposed-error.ts":{"bytes":817,"imports":[],"format":"esm"},"packages/common/context/src/context.ts":{"bytes":21471,"imports":[{"path":"node:util","kind":"import-statement","external":true},{"path":"@dxos/log","kind":"import-statement","external":true},{"path":"@dxos/util","kind":"import-statement","external":true},{"path":"packages/common/context/src/context-disposed-error.ts","kind":"import-statement","original":"./context-disposed-error"}],"format":"esm"},"packages/common/context/src/promise-utils.ts":{"bytes":3040,"imports":[{"path":"packages/common/context/src/context-disposed-error.ts","kind":"import-statement","original":"./context-disposed-error"}],"format":"esm"},"packages/common/context/src/resource.ts":{"bytes":11744,"imports":[{"path":"@dxos/util","kind":"import-statement","external":true},{"path":"packages/common/context/src/context.ts","kind":"import-statement","original":"./context"}],"format":"esm"},"packages/common/context/src/index.ts":{"bytes":777,"imports":[{"path":"packages/common/context/src/context.ts","kind":"import-statement","original":"./context"},{"path":"packages/common/context/src/promise-utils.ts","kind":"import-statement","original":"./promise-utils"},{"path":"packages/common/context/src/context-disposed-error.ts","kind":"import-statement","original":"./context-disposed-error"},{"path":"packages/common/context/src/resource.ts","kind":"import-statement","original":"./resource"}],"format":"esm"}},"outputs":{"packages/common/context/dist/lib/node/index.cjs.map":{"imports":[],"exports":[],"inputs":{},"bytes":17016},"packages/common/context/dist/lib/node/index.cjs":{"imports":[{"path":"node:util","kind":"import-statement","external":true},{"path":"@dxos/log","kind":"import-statement","external":true},{"path":"@dxos/util","kind":"import-statement","external":true},{"path":"@dxos/util","kind":"import-statement","external":true}],"exports":["Context","ContextDisposedError","LifecycleState","Resource","cancelWithContext","openInContext","rejectOnDispose"],"entryPoint":"packages/common/context/src/index.ts","inputs":{"packages/common/context/src/context.ts":{"bytesInOutput":5893},"packages/common/context/src/context-disposed-error.ts":{"bytesInOutput":106},"packages/common/context/src/index.ts":{"bytesInOutput":0},"packages/common/context/src/promise-utils.ts":{"bytesInOutput":410},"packages/common/context/src/resource.ts":{"bytesInOutput":2979}},"bytes":9792}}}
+{"inputs":{"packages/common/context/src/context-disposed-error.ts":{"bytes":853,"imports":[],"format":"esm"},"packages/common/context/src/context.ts":{"bytes":22853,"imports":[{"path":"node:util","kind":"import-statement","external":true},{"path":"@dxos/log","kind":"import-statement","external":true},{"path":"@dxos/util","kind":"import-statement","external":true},{"path":"packages/common/context/src/context-disposed-error.ts","kind":"import-statement","original":"./context-disposed-error"}],"format":"esm"},"packages/common/context/src/promise-utils.ts":{"bytes":3096,"imports":[{"path":"packages/common/context/src/context-disposed-error.ts","kind":"import-statement","original":"./context-disposed-error"}],"format":"esm"},"packages/common/context/src/resource.ts":{"bytes":13662,"imports":[{"path":"@dxos/util","kind":"import-statement","external":true},{"path":"packages/common/context/src/context.ts","kind":"import-statement","original":"./context"}],"format":"esm"},"packages/common/context/src/index.ts":{"bytes":809,"imports":[{"path":"packages/common/context/src/context.ts","kind":"import-statement","original":"./context"},{"path":"packages/common/context/src/promise-utils.ts","kind":"import-statement","original":"./promise-utils"},{"path":"packages/common/context/src/context-disposed-error.ts","kind":"import-statement","original":"./context-disposed-error"},{"path":"packages/common/context/src/resource.ts","kind":"import-statement","original":"./resource"}],"format":"esm"}},"outputs":{"packages/common/context/dist/lib/node/index.cjs.map":{"imports":[],"exports":[],"inputs":{},"bytes":18172},"packages/common/context/dist/lib/node/index.cjs":{"imports":[{"path":"node:util","kind":"import-statement","external":true},{"path":"@dxos/log","kind":"import-statement","external":true},{"path":"@dxos/util","kind":"import-statement","external":true},{"path":"@dxos/util","kind":"import-statement","external":true}],"exports":["Context","ContextDisposedError","LifecycleState","Resource","cancelWithContext","openInContext","rejectOnDispose"],"entryPoint":"packages/common/context/src/index.ts","inputs":{"packages/common/context/src/context.ts":{"bytesInOutput":6273},"packages/common/context/src/context-disposed-error.ts":{"bytesInOutput":106},"packages/common/context/src/index.ts":{"bytesInOutput":0},"packages/common/context/src/promise-utils.ts":{"bytesInOutput":410},"packages/common/context/src/resource.ts":{"bytesInOutput":3372}},"bytes":10565}}}

package/dist/types/src/context.d.ts

@@ -1,6 +1,6 @@
 /// <reference types="node" />
 import { inspect } from 'node:util';
-export type ContextErrorHandler = (error: Error) => void;
+export type ContextErrorHandler = (error: Error, ctx: Context) => void;
 export type DisposeCallback = () => any | Promise<any>;
 export type CreateContextParams = {
     name?: string;
@@ -9,17 +9,10 @@ export type CreateContextParams = {
     onError?: ContextErrorHandler;
 };
 export declare class Context {
+    #private;
     static default(): Context;
-    private readonly _disposeCallbacks;
-    private readonly _name?;
-    private readonly _parent?;
-    private readonly _attributes;
-    private readonly _onError;
-    private _isDisposed;
-    private _disposePromise?;
     maxSafeDisposeCallbacks: number;
-    constructor({ name, // TODO(burdon): Automate?
-    parent, attributes, onError, }?: CreateContextParams);
+    constructor({ name, parent, attributes, onError }?: CreateContextParams);
     get disposed(): boolean;
     get disposeCallbacksLength(): number;
     /**

package/dist/types/src/context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/context.ts"],"names":[],"mappings":";AAIA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOpC,MAAM,MAAM,mBAAmB,GAAG,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;AAEzD,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;AAEvD,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACjC,OAAO,CAAC,EAAE,mBAAmB,CAAC;CAC/B,CAAC;AAOF,qBACa,OAAO;IAClB,MAAM,CAAC,OAAO;IAId,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAyB;IAE3D,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAU;IACnC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAsB;IAClD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAsB;IAE/C,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,eAAe,CAAC,CAA+B;IAEhD,uBAAuB,SAA8B;gBAEhD,EACV,IAAI,EAAE,0BAA0B;IAChC,MAAM,EACN,UAAe,EACf,OASC,GACF,GAAE,mBAAwB;IAO3B,IAAI,QAAQ,YAEX;IAED,IAAI,sBAAsB,WAEzB;IAED;;;;;;;;OAQG;IACH,SAAS,CAAC,QAAQ,EAAE,eAAe,GAAG,MAAM,IAAI;IA4BhD;;;;;;OAMG;IACG,OAAO,CAAC,YAAY,UAAQ,GAAG,OAAO,CAAC,OAAO,CAAC;IA8CrD;;;;OAIG;IACH,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAezB,MAAM,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,GAAE,mBAAwB,GAAG,OAAO;IAsBlE,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG;IAW9B,CAAC,MAAM,CAAC,WAAW,CAAC,SAAa;IACjC,CAAC,OAAO,CAAC,MAAM,CAAC,eAAyB;IAEzC,QAAQ;CAGT"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/context.ts"],"names":[],"mappings":";AAIA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOpC,MAAM,MAAM,mBAAmB,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,KAAK,IAAI,CAAC;AAEvE,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;AAEvD,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACjC,OAAO,CAAC,EAAE,mBAAmB,CAAC;CAC/B,CAAC;AAkBF,qBACa,OAAO;;IAClB,MAAM,CAAC,OAAO;IAcP,uBAAuB,SAA8B;gBAEhD,EAAE,IAAI,EAAE,MAAM,EAAE,UAAe,EAAE,OAA+B,EAAE,GAAE,mBAAwB;IAOxG,IAAI,QAAQ,YAEX;IAED,IAAI,sBAAsB,WAEzB;IAED;;;;;;;;OAQG;IACH,SAAS,CAAC,QAAQ,EAAE,eAAe,GAAG,MAAM,IAAI;IA4BhD;;;;;;OAMG;IACG,OAAO,CAAC,YAAY,UAAQ,GAAG,OAAO,CAAC,OAAO,CAAC;IAqDrD;;;;OAIG;IACH,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAezB,MAAM,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,GAAE,mBAAwB,GAAG,OAAO;IAsBlE,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG;IAW9B,CAAC,MAAM,CAAC,WAAW,CAAC,SAAa;IACjC,CAAC,OAAO,CAAC,MAAM,CAAC,eAAyB;IAEzC,QAAQ;CAGT"}

package/dist/types/src/promise-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"promise-utils.d.ts","sourceRoot":"","sources":["../../../src/promise-utils.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAEhE;;GAEG;AAEH,eAAO,MAAM,eAAe,QAAS,OAAO,mCAAuC,QAAQ,KAAK,CAG5F,CAAC;AAEL;;GAEG;AACH,eAAO,MAAM,iBAAiB,WAAY,OAAO,oCAShD,CAAC"}
+{"version":3,"file":"promise-utils.d.ts","sourceRoot":"","sources":["../../../src/promise-utils.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAEhE;;GAEG;AAEH,eAAO,MAAM,eAAe,QAAS,OAAO,mCAAuC,QAAQ,KAAK,CAG5F,CAAC;AAEL;;GAEG;AACH,eAAO,MAAM,iBAAiB,WAAY,OAAO,WAAW,QAAQ,CAAC,CAAC,KAAG,QAAQ,CAAC,CASjF,CAAC"}

package/dist/types/src/resource.d.ts

@@ -1,4 +1,3 @@
-import '@dxos/util';
 import { Context } from './context';
 export declare enum LifecycleState {
     CLOSED = "CLOSED",

package/dist/types/src/resource.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resource.d.ts","sourceRoot":"","sources":["../../../src/resource.ts"],"names":[],"mappings":"AAIA,OAAO,YAAY,CAAC;AAEpB,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,oBAAY,cAAc;IACxB,MAAM,WAAW;IACjB,IAAI,SAAS;IACb,KAAK,UAAU;CAChB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;IACzC,KAAK,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;CAC9B;AAED;;GAEG;AACH,8BAAsB,QAAS,YAAW,SAAS;;IAkBjD,SAAS,KAAK,eAAe,mBAE5B;IAED,SAAS,KAAK,IAAI,YAEjB;IAED;;OAEG;cACa,KAAK,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAElD;;OAEG;cACa,MAAM,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAEnD;;;OAGG;cACa,MAAM,CAAC,GAAG,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjD;;;;;;OAMG;IACG,IAAI,CAAC,GAAG,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAexC;;;OAGG;IACG,KAAK,CAAC,GAAG,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAUnC,CAAC,MAAM,CAAC,YAAY,CAAC;CAkC5B;AAED,eAAO,MAAM,aAAa,6BAAoC,OAAO,4BAKpE,CAAC"}
+{"version":3,"file":"resource.d.ts","sourceRoot":"","sources":["../../../src/resource.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,oBAAY,cAAc;IACxB,MAAM,WAAW;IACjB,IAAI,SAAS;IACb,KAAK,UAAU;CAChB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;IACzC,KAAK,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;CAC9B;AAKD;;GAEG;AACH,8BAAsB,QAAS,YAAW,SAAS;;IAsBjD,SAAS,KAAK,eAAe,mBAE5B;IAED,SAAS,KAAK,IAAI,YAEjB;IAED;;OAEG;cACa,KAAK,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAElD;;OAEG;cACa,MAAM,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAEnD;;;OAGG;cACa,MAAM,CAAC,GAAG,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IAWjD;;;;;;OAMG;IACG,IAAI,CAAC,GAAG,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAexC;;;OAGG;IACG,KAAK,CAAC,GAAG,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAUnC,CAAC,MAAM,CAAC,YAAY,CAAC;CAkC5B;AAED,eAAO,MAAM,aAAa,6BAAoC,OAAO,YAAY,CAAC,KAAG,QAAQ,CAAC,CAK7F,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dxos/context",
-  "version": "0.5.3-next.57eca40",
+  "version": "0.5.3",
   "description": "Async utils.",
   "homepage": "https://dxos.org",
   "bugs": "https://github.com/dxos/dxos/issues",
@@ -16,9 +16,9 @@
     "src"
   ],
   "dependencies": {
-    "@dxos/log": "0.5.3-next.57eca40",
-    "@dxos/node-std": "0.5.3-next.57eca40",
-    "@dxos/util": "0.5.3-next.57eca40"
+    "@dxos/log": "0.5.3",
+    "@dxos/util": "0.5.3",
+    "@dxos/node-std": "0.5.3"
   },
   "publishConfig": {
     "access": "public"

package/src/context.ts

@@ -9,7 +9,7 @@ import { safeInstanceof } from '@dxos/util';
 
 import { ContextDisposedError } from './context-disposed-error';
 
-export type ContextErrorHandler = (error: Error) => void;
+export type ContextErrorHandler = (error: Error, ctx: Context) => void;
 
 export type DisposeCallback = () => any | Promise<any>;
 
@@ -25,51 +25,48 @@ export type CreateContextParams = {
  */
 const MAX_SAFE_DISPOSE_CALLBACKS = 300;
 
+const DEFAULT_ERROR_HANDLER: ContextErrorHandler = (error, ctx) => {
+  if (error instanceof ContextDisposedError) {
+    return;
+  }
+
+  void ctx.dispose();
+
+  // Will generate an unhandled rejection.
+  throw error;
+};
+
 @safeInstanceof('Context')
 export class Context {
   static default() {
     return new Context();
   }
 
-  private readonly _disposeCallbacks: DisposeCallback[] = [];
+  readonly #disposeCallbacks: DisposeCallback[] = [];
 
-  private readonly _name?: string;
-  private readonly _parent?: Context;
-  private readonly _attributes: Record<string, any>;
-  private readonly _onError: ContextErrorHandler;
+  readonly #name?: string = undefined;
+  readonly #parent?: Context = undefined;
+  readonly #attributes: Record<string, any>;
+  readonly #onError: ContextErrorHandler;
 
-  private _isDisposed = false;
-  private _disposePromise?: Promise<boolean> = undefined;
+  #isDisposed = false;
+  #disposePromise?: Promise<boolean> = undefined;
 
   public maxSafeDisposeCallbacks = MAX_SAFE_DISPOSE_CALLBACKS;
 
-  constructor({
-    name, // TODO(burdon): Automate?
-    parent,
-    attributes = {},
-    onError = (error) => {
-      if (error instanceof ContextDisposedError) {
-        return;
-      }
-
-      void this.dispose();
-
-      // Will generate an unhandled rejection.
-      throw error;
-    },
-  }: CreateContextParams = {}) {
-    this._name = name;
-    this._parent = parent;
-    this._attributes = attributes;
-    this._onError = onError;
+  constructor({ name, parent, attributes = {}, onError = DEFAULT_ERROR_HANDLER }: CreateContextParams = {}) {
+    this.#name = name;
+    this.#parent = parent;
+    this.#attributes = attributes;
+    this.#onError = onError;
   }
 
   get disposed() {
-    return this._isDisposed;
+    return this.#isDisposed;
   }
 
   get disposeCallbacksLength() {
-    return this._disposeCallbacks.length;
+    return this.#disposeCallbacks.length;
   }
 
   /**
@@ -82,7 +79,7 @@ export class Context {
    * @returns A function that can be used to remove the callback from the dispose list.
    */
   onDispose(callback: DisposeCallback): () => void {
-    if (this._isDisposed) {
+    if (this.#isDisposed) {
       // Call the callback immediately if the context is already disposed.
       void (async () => {
         try {
@@ -93,18 +90,18 @@ export class Context {
       })();
     }
 
-    this._disposeCallbacks.push(callback);
-    if (this._disposeCallbacks.length > this.maxSafeDisposeCallbacks) {
+    this.#disposeCallbacks.push(callback);
+    if (this.#disposeCallbacks.length > this.maxSafeDisposeCallbacks) {
       log.warn('Context has a large number of dispose callbacks (this might be a memory leak).', {
-        count: this._disposeCallbacks.length,
+        count: this.#disposeCallbacks.length,
       });
     }
 
     // Remove handler.
     return () => {
-      const index = this._disposeCallbacks.indexOf(callback);
+      const index = this.#disposeCallbacks.indexOf(callback);
       if (index !== -1) {
-        this._disposeCallbacks.splice(index, 1);
+        this.#disposeCallbacks.splice(index, 1);
       }
     };
   }
@@ -117,46 +114,53 @@ export class Context {
    * Disposing context means that onDispose will throw an error and any errors raised will be logged and not propagated.
    */
   async dispose(throwOnError = false): Promise<boolean> {
-    if (this._disposePromise) {
-      return this._disposePromise;
+    if (this.#disposePromise) {
+      return this.#disposePromise;
     }
 
     // TODO(burdon): Probably should not be set until the dispose is complete, but causes tests to fail if moved.
-    this._isDisposed = true;
+    this.#isDisposed = true;
 
     // Set the promise before running the callbacks.
     let resolveDispose!: (value: boolean) => void;
-    this._disposePromise = new Promise<boolean>((resolve) => {
+    const promise = new Promise<boolean>((resolve) => {
       resolveDispose = resolve;
     });
+    this.#disposePromise = promise;
 
     // Process last first.
     // Clone the array so that any mutations to the original array don't affect the dispose process.
-    const callbacks = Array.from(this._disposeCallbacks).reverse();
-    this._disposeCallbacks.length = 0;
+    const callbacks = Array.from(this.#disposeCallbacks).reverse();
+    this.#disposeCallbacks.length = 0;
 
-    if (this._name) {
-      log('disposing', { context: this._name, count: callbacks.length });
+    if (this.#name) {
+      log('disposing', { context: this.#name, count: callbacks.length });
     }
 
     let i = 0;
     let clean = true;
+    const errors: Error[] = [];
     for (const callback of callbacks) {
       try {
         await callback();
         i++;
       } catch (err: any) {
-        log.catch(err, { context: this._name, callback: i, count: callbacks.length });
         clean = false;
         if (throwOnError) {
-          throw err;
+          errors.push(err);
+        } else {
+          log.catch(err, { context: this.#name, callback: i, count: callbacks.length });
         }
       }
     }
 
+    if (errors.length > 0) {
+      throw new AggregateError(errors);
+    }
+
     resolveDispose(clean);
-    if (this._name) {
-      log('disposed', { context: this._name });
+    if (this.#name) {
+      log('disposed', { context: this.#name });
     }
 
     return clean;
@@ -168,14 +172,14 @@ export class Context {
    * IF the error handler is not set, the error will dispose the context and cause an unhandled rejection.
    */
   raise(error: Error): void {
-    if (this._isDisposed) {
+    if (this.#isDisposed) {
       // TODO(dmaretskyi): Don't log those.
       // log.warn('Error in disposed context', error);
       return;
     }
 
     try {
-      this._onError(error);
+      this.#onError(error, this);
     } catch (err) {
       // Generate an unhandled rejection and stop the error propagation.
       void Promise.reject(err);
@@ -190,7 +194,7 @@ export class Context {
           this.raise(error);
         } else {
           try {
-            await onError(error);
+            await onError(error, this);
           } catch {
             this.raise(error);
           }
@@ -205,11 +209,11 @@ export class Context {
   }
 
   getAttribute(key: string): any {
-    if (key in this._attributes) {
-      return this._attributes[key];
+    if (key in this.#attributes) {
+      return this.#attributes[key];
     }
-    if (this._parent) {
-      return this._parent.getAttribute(key);
+    if (this.#parent) {
+      return this.#parent.getAttribute(key);
     }
 
     return undefined;
@@ -219,6 +223,6 @@ export class Context {
   [inspect.custom] = () => this.toString();
 
   toString() {
-    return `Context(${this._isDisposed ? 'disposed' : 'active'})`;
+    return `Context(${this.#isDisposed ? 'disposed' : 'active'})`;
   }
 }

package/src/resource.ts

@@ -2,7 +2,7 @@
 // Copyright 2024 DXOS.org
 //
 
-import '@dxos/util';
+import { throwUnhandledError } from '@dxos/util';
 
 import { Context } from './context';
 
@@ -17,6 +17,9 @@ export interface Lifecycle {
   close?(): Promise<any> | any;
 }
 
+// Feature flag to be enabled later.
+const CLOSE_RESOURCE_ON_UNHANDLED_ERROR = false;
+
 /**
  * Base class for resources that need to be opened and closed.
  */
@@ -36,7 +39,11 @@ export abstract class Resource implements Lifecycle {
    * Context that is used to bubble up errors that are not handled by the resource.
    * Provided in the open method.
    */
-  #parentCtx: Context = new Context();
+  #parentCtx: Context = new Context({ name: this.#name });
+
+  get #name() {
+    return Object.getPrototypeOf(this).constructor.name;
+  }
 
   protected get _lifecycleState() {
     return this.#lifecycleState;
@@ -61,6 +68,13 @@ export abstract class Resource implements Lifecycle {
    * By default, errors are bubbled up to the parent context which is passed to the open method.
    */
   protected async _catch(err: Error): Promise<void> {
+    if (CLOSE_RESOURCE_ON_UNHANDLED_ERROR) {
+      try {
+        await this.close();
+      } catch (doubleErr: any) {
+        throwUnhandledError(doubleErr);
+      }
+    }
     throw err;
   }
 
@@ -107,13 +121,13 @@ export abstract class Resource implements Lifecycle {
   async #open(ctx?: Context) {
     this.#closePromise = null;
     if (ctx) {
-      this.#parentCtx = ctx;
+      this.#parentCtx = ctx.derive({ name: this.#name });
     }
     await this._open(this.#parentCtx);
     this.#lifecycleState = LifecycleState.OPEN;
   }
 
-  async #close(ctx = new Context()) {
+  async #close(ctx = Context.default()) {
     this.#openPromise = null;
     await this.#internalCtx.dispose();
     await this._close(ctx);