@loopback/context 3.8.1 → 3.9.2

package/dist/value-promise.js

@@ -4,7 +4,7 @@
 // This file is licensed under the MIT License.
 // License text available at https://opensource.org/licenses/MIT
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.UUID_PATTERN = exports.uuid = exports.transformValueOrPromise = exports.resolveUntil = exports.tryWithFinally = exports.resolveList = exports.resolveMap = exports.getDeepProperty = exports.isPromiseLike = void 0;
+exports.UUID_PATTERN = exports.uuid = exports.transformValueOrPromise = exports.resolveUntil = exports.tryCatchFinally = exports.tryWithFinally = exports.resolveList = exports.resolveMap = exports.getDeepProperty = exports.isPromiseLike = void 0;
 /**
  * This module contains types for values and/or promises as well as a set of
  * utility methods to handle values and/or promises.
@@ -156,34 +156,58 @@ exports.resolveList = resolveList;
  * @param action - A function that returns a promise or a value
  * @param finalAction - A function to be called once the action
  * is fulfilled or rejected (synchronously or asynchronously)
+ *
+ *  @typeParam T - Type for the return value
  */
 function tryWithFinally(action, finalAction) {
+    return tryCatchFinally(action, undefined, finalAction);
+}
+exports.tryWithFinally = tryWithFinally;
+/**
+ * Try to run an action that returns a promise or a value with error and final
+ * actions to mimic `try {} catch(err) {} finally {}` for a value or promise.
+ *
+ * @param action - A function that returns a promise or a value
+ * @param errorAction - A function to be called once the action
+ * is rejected (synchronously or asynchronously). It must either return a new
+ * value or throw an error.
+ * @param finalAction - A function to be called once the action
+ * is fulfilled or rejected (synchronously or asynchronously)
+ *
+ * @typeParam T - Type for the return value
+ */
+function tryCatchFinally(action, errorAction = err => {
+    throw err;
+}, finalAction = () => { }) {
     let result;
     try {
         result = action();
     }
     catch (err) {
-        finalAction();
-        throw err;
+        result = reject(err);
     }
     if (isPromiseLike(result)) {
-        // Once (promise.finally)[https://github.com/tc39/proposal-promise-finally
-        // is supported, the following can be simplifed as
-        // `result = result.finally(finalAction);`
-        result = result.then(val => {
-            finalAction();
-            return val;
-        }, err => {
+        return result.then(resolve, reject);
+    }
+    return resolve(result);
+    function resolve(value) {
+        try {
+            return value;
+        }
+        finally {
             finalAction();
-            throw err;
-        });
+        }
     }
-    else {
-        finalAction();
+    function reject(err) {
+        try {
+            return errorAction(err);
+        }
+        finally {
+            finalAction();
+        }
     }
-    return result;
 }
-exports.tryWithFinally = tryWithFinally;
+exports.tryCatchFinally = tryCatchFinally;
 /**
  * Resolve an iterator of source values into a result until the evaluator
  * returns `true`
@@ -236,6 +260,9 @@ function transformValueOrPromise(valueOrPromise, transformer) {
 exports.transformValueOrPromise = transformValueOrPromise;
 /**
  * A utility to generate uuid v4
+ *
+ * @deprecated Use [uuid](https://www.npmjs.com/package/uuid) or
+ * [hyperid](https://www.npmjs.com/package/hyperid) instead.
  */
 function uuid() {
     return uuid_1.v4();
@@ -243,6 +270,8 @@ function uuid() {
 exports.uuid = uuid;
 /**
  * A regular expression for testing uuid v4 PATTERN
+ * @deprecated This pattern is an internal helper used by unit-tests, we are no
+ * longer using it.
  */
 exports.UUID_PATTERN = /[0-9A-F]{8}-[0-9A-F]{4}-[4][0-9A-F]{3}-[89AB][0-9A-F]{3}-[0-9A-F]{12}/i;
 //# sourceMappingURL=value-promise.js.map

package/dist/value-promise.js.map

@@ -1 +1 @@
-{"version":3,"file":"value-promise.js","sourceRoot":"","sources":["../src/value-promise.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"value-promise.js","sourceRoot":"","sources":["../src/value-promise.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@loopback/context",
-  "version": "3.8.1",
-  "description": "LoopBack's container for Inversion of Control",
+  "version": "3.9.2",
+  "description": "Facilities to manage artifacts and their dependencies in your Node.js applications. The module exposes TypeScript/JavaScript APIs and decorators to register artifacts, declare dependencies, and resolve artifacts by keys. It also serves as an IoC container to support dependency injection",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "engines": {
-    "node": ">=10"
+    "node": ">=10.16"
   },
   "scripts": {
     "acceptance": "lb-mocha \"dist/__tests__/acceptance/**/*.js\"",
@@ -19,20 +19,24 @@
   "author": "IBM Corp.",
   "copyright.owner": "IBM Corp.",
   "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
   "dependencies": {
-    "@loopback/metadata": "^2.1.5",
+    "@loopback/metadata": "^2.2.2",
     "@types/debug": "^4.1.5",
     "debug": "^4.1.1",
-    "p-event": "^4.1.0",
+    "hyperid": "^2.0.5",
+    "p-event": "^4.2.0",
     "tslib": "^2.0.0",
-    "uuid": "^8.0.0"
+    "uuid": "^8.2.0"
   },
   "devDependencies": {
-    "@loopback/build": "^5.4.1",
-    "@loopback/eslint-config": "^7.0.1",
-    "@loopback/testlab": "^3.1.5",
-    "@types/bluebird": "^3.5.31",
-    "@types/node": "^10.17.24",
+    "@loopback/build": "^6.1.0",
+    "@loopback/eslint-config": "^8.0.3",
+    "@loopback/testlab": "^3.2.0",
+    "@types/bluebird": "^3.5.32",
+    "@types/node": "^10.17.26",
     "@types/uuid": "^8.0.0",
     "bluebird": "^3.7.2"
   },
@@ -56,5 +60,5 @@
     "url": "https://github.com/strongloop/loopback-next.git",
     "directory": "packages/context"
   },
-  "gitHead": "62aea854bf85c5a5995b59e6908fe5409f7eea96"
+  "gitHead": "b89db3d3b8be6a36e63e91c2331d217fda7538de"
 }

package/src/binding-decorator.ts

@@ -1,4 +1,4 @@
-// Copyright IBM Corp. 2018,2019. All Rights Reserved.
+// Copyright IBM Corp. 2018,2020. All Rights Reserved.
 // Node module: @loopback/context
 // This file is licensed under the MIT License.
 // License text available at https://opensource.org/licenses/MIT

package/src/binding-inspector.ts

@@ -1,4 +1,4 @@
-// Copyright IBM Corp. 2018,2019. All Rights Reserved.
+// Copyright IBM Corp. 2018,2020. All Rights Reserved.
 // Node module: @loopback/context
 // This file is licensed under the MIT License.
 // License text available at https://opensource.org/licenses/MIT
@@ -178,7 +178,7 @@ export function bindingTemplateFor<T>(
     for (const t of templateFunctions) {
       binding.apply(t);
     }
-    if (spec && spec.target !== cls) {
+    if (spec?.target !== cls) {
       // Remove name/key tags inherited from base classes
       binding.apply(removeNameAndKeyTags);
     }

package/src/binding-key.ts

@@ -3,7 +3,7 @@
 // This file is licensed under the MIT License.
 // License text available at https://opensource.org/licenses/MIT
 
-import {uuid} from './value-promise';
+import {generateUniqueId} from './unique-id';
 
 export type BindingAddress<T = unknown> = string | BindingKey<T>;
 
@@ -123,12 +123,16 @@ export class BindingKey<ValueType> {
   }
 
   /**
-   * Generate a unique binding key with `uuid`
+   * Generate a universally unique binding key.
+   *
+   * Please note the format of they generated key is not specified, you must
+   * not rely on any specific formatting (e.g. UUID style).
+   *
    * @param namespace - Namespace for the binding
    */
   static generate<T>(namespace = ''): BindingKey<T> {
     const prefix = namespace ? `${namespace}.` : '';
-    const name = uuid();
+    const name = generateUniqueId();
     return BindingKey.create(`${prefix}${name}`);
   }
 }

package/src/binding.ts

@@ -16,6 +16,7 @@ import {Provider} from './provider';
 import {
   asResolutionOptions,
   ResolutionContext,
+  ResolutionError,
   ResolutionOptions,
   ResolutionOptionsOrSession,
   ResolutionSession,
@@ -201,7 +202,7 @@ export type BindingEvent = {
   /**
    * Event type
    */
-  type: string;
+  type: 'changed' | string;
   /**
    * Source binding that emits the event
    */
@@ -209,7 +210,7 @@ export type BindingEvent = {
   /**
    * Operation that triggers the event
    */
-  operation: string;
+  operation: 'tag' | 'scope' | 'value' | string;
 };
 
 /**
@@ -309,7 +310,7 @@ export class Binding<T = BoundValue> extends EventEmitter {
     return this._source?.type;
   }
 
-  private _cache: WeakMap<Context, T>;
+  private _cache: WeakMap<Context, ValueOrPromise<T>>;
   private _getValue?: ValueFactory<T>;
 
   /**
@@ -358,18 +359,16 @@ export class Binding<T = BoundValue> extends EventEmitter {
     result: ValueOrPromise<T>,
   ): ValueOrPromise<T> {
     // Initialize the cache as a weakmap keyed by context
-    if (!this._cache) this._cache = new WeakMap<Context, T>();
-    return transformValueOrPromise(result, val => {
-      if (this.scope === BindingScope.SINGLETON) {
-        // Cache the value
-        this._cache.set(ctx.getOwnerContext(this.key)!, val);
-      } else if (this.scope === BindingScope.CONTEXT) {
-        // Cache the value at the current context
-        this._cache.set(ctx, val);
-      }
-      // Do not cache for `TRANSIENT`
-      return val;
-    });
+    if (!this._cache) this._cache = new WeakMap<Context, ValueOrPromise<T>>();
+    if (this.scope === BindingScope.SINGLETON) {
+      // Cache the value
+      this._cache.set(ctx.getOwnerContext(this.key)!, result);
+    } else if (this.scope === BindingScope.CONTEXT) {
+      // Cache the value at the current context
+      this._cache.set(ctx, result);
+    }
+    // Do not cache for `TRANSIENT`
+    return result;
   }
 
   /**
@@ -465,15 +464,19 @@ export class Binding<T = BoundValue> extends EventEmitter {
       }
     }
     const options = asResolutionOptions(optionsOrSession);
+    const resolutionCtx = {
+      context: ctx,
+      binding: this,
+      options,
+    };
     if (typeof this._getValue === 'function') {
       const result = ResolutionSession.runWithBinding(
         s => {
-          const optionsWithSession = Object.assign({}, options, {session: s});
+          const optionsWithSession = {...options, session: s};
           // We already test `this._getValue` is a function. It's safe to assert
           // that `this._getValue` is not undefined.
           return this._getValue!({
-            context: ctx,
-            binding: this,
+            ...resolutionCtx,
             options: optionsWithSession,
           });
         },
@@ -485,7 +488,10 @@ export class Binding<T = BoundValue> extends EventEmitter {
     // `@inject.binding` adds a binding without _getValue
     if (options.optional) return undefined;
     return Promise.reject(
-      new Error(`No value was configured for binding ${this.key}.`),
+      new ResolutionError(
+        `No value was configured for binding ${this.key}.`,
+        resolutionCtx,
+      ),
     );
   }
 
@@ -871,6 +877,42 @@ export class Binding<T = BoundValue> extends EventEmitter {
       [ContextTags.CONFIGURATION_FOR]: key.toString(),
     });
   }
+
+  /**
+   * The "changed" event is emitted by methods such as `tag`, `inScope`, `to`,
+   * and `toClass`.
+   *
+   * @param eventName The name of the event - always `changed`.
+   * @param listener The listener function to call when the event is emitted.
+   */
+  on(eventName: 'changed', listener: BindingEventListener): this;
+
+  // The generic variant inherited from EventEmitter
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  on(event: string | symbol, listener: (...args: any[]) => void): this;
+
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  on(event: string | symbol, listener: (...args: any[]) => void): this {
+    return super.on(event, listener);
+  }
+
+  /**
+   * The "changed" event is emitted by methods such as `tag`, `inScope`, `to`,
+   * and `toClass`.
+   *
+   * @param eventName The name of the event - always `changed`.
+   * @param listener The listener function to call when the event is emitted.
+   */
+  once(eventName: 'changed', listener: BindingEventListener): this;
+
+  // The generic variant inherited from EventEmitter
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  once(event: string | symbol, listener: (...args: any[]) => void): this;
+
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  once(event: string | symbol, listener: (...args: any[]) => void): this {
+    return super.once(event, listener);
+  }
 }
 
 /**

package/src/context-view.ts

@@ -241,6 +241,126 @@ export class ContextView<T = unknown> extends EventEmitter
       'The ContextView has more than one value. Use values() to access them.',
     );
   }
+
+  /**
+   * The "bind" event is emitted when a new binding is added to the view.
+   *
+   * @param eventName The name of the event - always `bind`.
+   * @param listener The listener function to call when the event is emitted.
+   */
+  on(
+    eventName: 'bind',
+    listener: <T>(event: ContextViewEvent<T>) => void,
+  ): this;
+
+  /**
+   * The "unbind" event is emitted a new binding is removed from the view.
+   *
+   * @param eventName The name of the event - always `unbind`.
+   * @param listener The listener function to call when the event is emitted.
+   */
+  on(
+    eventName: 'unbind',
+    listener: <T>(event: ContextViewEvent<T> & {cachedValue?: T}) => void,
+  ): this;
+
+  /**
+   * The "refresh" event is emitted when the view is refreshed as bindings are
+   * added/removed.
+   *
+   * @param eventName The name of the event - always `refresh`.
+   * @param listener The listener function to call when the event is emitted.
+   */
+  on(eventName: 'refresh', listener: () => void): this;
+
+  /**
+   * The "resolve" event is emitted when the cached values are resolved and
+   * updated.
+   *
+   * @param eventName The name of the event - always `refresh`.
+   * @param listener The listener function to call when the event is emitted.
+   */
+  // eslint-disable-next-line @typescript-eslint/unified-signatures
+  on(eventName: 'refresh', listener: <T>(result: T[]) => void): this;
+
+  /**
+   * The "close" event is emitted when the view is closed (stopped observing
+   * context events)
+   *
+   * @param eventName The name of the event - always `close`.
+   * @param listener The listener function to call when the event is emitted.
+   */
+  // eslint-disable-next-line @typescript-eslint/unified-signatures
+  on(eventName: 'close', listener: () => void): this;
+
+  // The generic variant inherited from EventEmitter
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  on(event: string | symbol, listener: (...args: any[]) => void): this;
+
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  on(event: string | symbol, listener: (...args: any[]) => void): this {
+    return super.on(event, listener);
+  }
+
+  /**
+   * The "bind" event is emitted when a new binding is added to the view.
+   *
+   * @param eventName The name of the event - always `bind`.
+   * @param listener The listener function to call when the event is emitted.
+   */
+  once(
+    eventName: 'bind',
+    listener: <T>(event: ContextViewEvent<T>) => void,
+  ): this;
+
+  /**
+   * The "unbind" event is emitted a new binding is removed from the view.
+   *
+   * @param eventName The name of the event - always `unbind`.
+   * @param listener The listener function to call when the event is emitted.
+   */
+  once(
+    eventName: 'unbind',
+    listener: <T>(event: ContextViewEvent<T> & {cachedValue?: T}) => void,
+  ): this;
+
+  /**
+   * The "refresh" event is emitted when the view is refreshed as bindings are
+   * added/removed.
+   *
+   * @param eventName The name of the event - always `refresh`.
+   * @param listener The listener function to call when the event is emitted.
+   */
+  once(eventName: 'refresh', listener: () => void): this;
+
+  /**
+   * The "resolve" event is emitted when the cached values are resolved and
+   * updated.
+   *
+   * @param eventName The name of the event - always `refresh`.
+   * @param listener The listener function to call when the event is emitted.
+   */
+  // eslint-disable-next-line @typescript-eslint/unified-signatures
+  once(eventName: 'refresh', listener: <T>(result: T[]) => void): this;
+
+  /**
+   * The "close" event is emitted when the view is closed (stopped observing
+   * context events)
+   *
+   * @param eventName The name of the event - always `close`.
+   * @param listener The listener function to call when the event is emitted.
+   */
+  // eslint-disable-next-line @typescript-eslint/unified-signatures
+  once(eventName: 'close', listener: () => void): this;
+
+  // The generic variant inherited from EventEmitter
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  once(event: string | symbol, listener: (...args: any[]) => void): this;
+
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  once(event: string | symbol, listener: (...args: any[]) => void): this {
+    return super.once(event, listener);
+  }
 }
 
 /**

package/src/context.ts

@@ -18,7 +18,7 @@ import {
 } from './binding-filter';
 import {BindingAddress, BindingKey} from './binding-key';
 import {BindingComparator} from './binding-sorter';
-import {ContextEvent} from './context-event';
+import {ContextEvent, ContextEventListener} from './context-event';
 import {ContextEventObserver, ContextObserver} from './context-observer';
 import {ContextSubscriptionManager, Subscription} from './context-subscription';
 import {ContextTagIndexer} from './context-tag-indexer';
@@ -27,16 +27,18 @@ import {JSONObject} from './json-types';
 import {ContextBindings} from './keys';
 import {
   asResolutionOptions,
+  ResolutionError,
   ResolutionOptions,
   ResolutionOptionsOrSession,
   ResolutionSession,
 } from './resolution-session';
+import {generateUniqueId} from './unique-id';
 import {
   BoundValue,
   Constructor,
   getDeepProperty,
   isPromiseLike,
-  uuid,
+  transformValueOrPromise,
   ValueOrPromise,
 } from './value-promise';
 
@@ -108,8 +110,8 @@ export class Context extends EventEmitter {
    * const reqCtx = new Context(appCtx, 'request');
    * ```
    * @param _parent - The optional parent context
-   * @param name - Name of the context, if not provided, a `uuid` will be
-   * generated as the name
+   * @param name - Name of the context. If not provided, a unique identifier
+   * will be generated as the name.
    */
   constructor(_parent?: Context | string, name?: string) {
     super();
@@ -151,7 +153,7 @@ export class Context extends EventEmitter {
   }
 
   private generateName() {
-    const id = uuid();
+    const id = generateUniqueId();
     if (this.constructor === Context) return id;
     return `${this.constructor.name}-${id}`;
   }
@@ -502,7 +504,7 @@ export class Context extends EventEmitter {
       if (filter(b)) bindings.push(b);
     }
 
-    const parentBindings = this._parent && this._parent.find(filter);
+    const parentBindings = this._parent?.find(filter);
     return this._mergeWithParent(bindings, parentBindings);
   }
 
@@ -534,7 +536,7 @@ export class Context extends EventEmitter {
     tag: BindingTag | RegExp,
   ): Readonly<Binding<ValueType>>[] {
     const currentBindings = this.tagIndexer.findByTagIndex(tag);
-    const parentBindings = this._parent && this._parent?._findByTagIndex(tag);
+    const parentBindings = this._parent?._findByTagIndex(tag);
     return this._mergeWithParent(currentBindings, parentBindings);
   }
 
@@ -797,21 +799,27 @@ export class Context extends EventEmitter {
   ): ValueOrPromise<ValueType | undefined> {
     const {key, propertyPath} = BindingKey.parseKeyWithPath(keyWithPath);
 
-    optionsOrSession = asResolutionOptions(optionsOrSession);
+    const options = asResolutionOptions(optionsOrSession);
 
-    const binding = this.getBinding<ValueType>(key, optionsOrSession);
-    if (binding == null) return undefined;
-
-    const boundValue = binding.getValue(this, optionsOrSession);
-    if (propertyPath === undefined || propertyPath === '') {
-      return boundValue;
-    }
-
-    if (isPromiseLike(boundValue)) {
-      return boundValue.then(v => getDeepProperty<ValueType>(v, propertyPath));
+    const binding = this.getBinding<ValueType>(key, {optional: true});
+    if (binding == null) {
+      if (options.optional) return undefined;
+      throw new ResolutionError(
+        `The key '${key}' is not bound to any value in context ${this.name}`,
+        {
+          context: this,
+          binding: Binding.bind(key),
+          options,
+        },
+      );
     }
 
-    return getDeepProperty<ValueType>(boundValue, propertyPath);
+    const boundValue = binding.getValue(this, options);
+    return propertyPath == null || propertyPath === ''
+      ? boundValue
+      : transformValueOrPromise(boundValue, v =>
+          getDeepProperty<ValueType>(v, propertyPath),
+        );
   }
 
   /**
@@ -878,6 +886,42 @@ export class Context extends EventEmitter {
     }
     return json;
   }
+
+  /**
+   * The "bind" event is emitted when a new binding is added to the context.
+   * The "unbind" event is emitted when an existing binding is removed.
+   *
+   * @param eventName The name of the event - always `bind` or `unbind`.
+   * @param listener The listener function to call when the event is emitted.
+   */
+  on(eventName: 'bind' | 'unbind', listener: ContextEventListener): this;
+
+  // The generic variant inherited from EventEmitter
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  on(event: string | symbol, listener: (...args: any[]) => void): this;
+
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  on(event: string | symbol, listener: (...args: any[]) => void): this {
+    return super.on(event, listener);
+  }
+
+  /**
+   * The "bind" event is emitted when a new binding is added to the context.
+   * The "unbind" event is emitted when an existing binding is removed.
+   *
+   * @param eventName The name of the event - always `bind` or `unbind`.
+   * @param listener The listener function to call when the event is emitted.
+   */
+  once(eventName: 'bind' | 'unbind', listener: ContextEventListener): this;
+
+  // The generic variant inherited from EventEmitter
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  once(event: string | symbol, listener: (...args: any[]) => void): this;
+
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  once(event: string | symbol, listener: (...args: any[]) => void): this {
+    return super.once(event, listener);
+  }
 }
 
 /**

package/src/inject-config.ts

@@ -129,7 +129,7 @@ export namespace config {
  */
 function getCurrentBindingKey(session: ResolutionSession) {
   // The current binding is not set if `instantiateClass` is invoked directly
-  return session.currentBinding && session.currentBinding.key;
+  return session.currentBinding?.key;
 }
 
 /**

package/src/inject.ts

@@ -133,6 +133,11 @@ export function inject(
   if (injectionMetadata.bindingComparator && !resolve) {
     throw new Error('Binding comparator is only allowed with a binding filter');
   }
+  if (!bindingSelector && typeof resolve !== 'function') {
+    throw new Error(
+      'A non-empty binding selector or resolve function is required for @inject',
+    );
+  }
   return function markParameterOrPropertyAsInjected(
     target: Object,
     member: string | undefined,