@loopback/context 4.0.0-alpha.8 → 4.1.0

package/dist/value-promise.js

@@ -0,0 +1,277 @@
+"use strict";
+// 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
+Object.defineProperty(exports, "__esModule", { value: true });
+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.
+ */
+const uuid_1 = require("uuid");
+/**
+ * Check whether a value is a Promise-like instance.
+ * Recognizes both native promises and third-party promise libraries.
+ *
+ * @param value - The value to check.
+ */
+function isPromiseLike(value) {
+    if (!value)
+        return false;
+    if (typeof value !== 'object' && typeof value !== 'function')
+        return false;
+    return typeof value.then === 'function';
+}
+exports.isPromiseLike = isPromiseLike;
+/**
+ * Get nested properties of an object by path
+ * @param value - Value of the source object
+ * @param path - Path to the property
+ */
+function getDeepProperty(value, path) {
+    let result = value;
+    const props = path.split('.').filter(Boolean);
+    for (const p of props) {
+        if (result == null) {
+            return undefined;
+        }
+        result = result[p];
+    }
+    return result;
+}
+exports.getDeepProperty = getDeepProperty;
+/**
+ * Resolve entries of an object into a new object with the same keys. If one or
+ * more entries of the source object are resolved to a promise by the `resolver`
+ * function, this method returns a promise which will be resolved to the new
+ * object with fully resolved entries.
+ *
+ * @example
+ *
+ * - Example 1: resolve all entries synchronously
+ * ```ts
+ * const result = resolveMap({a: 'x', b: 'y'}, v => v.toUpperCase());
+ * ```
+ * The `result` will be `{a: 'X', b: 'Y'}`.
+ *
+ * - Example 2: resolve one or more entries asynchronously
+ * ```ts
+ * const result = resolveMap({a: 'x', b: 'y'}, v =>
+ *   Promise.resolve(v.toUpperCase()),
+ * );
+ * ```
+ * The `result` will be a promise of `{a: 'X', b: 'Y'}`.
+ *
+ * @param map - The original object containing the source entries
+ * @param resolver - A function resolves an entry to a value or promise. It will
+ * be invoked with the property value, the property name, and the source object.
+ */
+function resolveMap(map, resolver) {
+    const result = {};
+    let asyncResolvers = undefined;
+    const setter = (key) => (val) => {
+        if (val !== undefined) {
+            // Only set the value if it's not undefined so that the default value
+            // for a key will be honored
+            result[key] = val;
+        }
+    };
+    for (const key in map) {
+        const valueOrPromise = resolver(map[key], key, map);
+        if (isPromiseLike(valueOrPromise)) {
+            if (!asyncResolvers)
+                asyncResolvers = [];
+            asyncResolvers.push(valueOrPromise.then(setter(key)));
+        }
+        else {
+            if (valueOrPromise !== undefined) {
+                // Only set the value if it's not undefined so that the default value
+                // for a key will be honored
+                result[key] = valueOrPromise;
+            }
+        }
+    }
+    if (asyncResolvers) {
+        return Promise.all(asyncResolvers).then(() => result);
+    }
+    else {
+        return result;
+    }
+}
+exports.resolveMap = resolveMap;
+/**
+ * Resolve entries of an array into a new array with the same indexes. If one or
+ * more entries of the source array are resolved to a promise by the `resolver`
+ * function, this method returns a promise which will be resolved to the new
+ * array with fully resolved entries.
+ *
+ * @example
+ *
+ * - Example 1: resolve all entries synchronously
+ * ```ts
+ * const result = resolveList(['a', 'b'], v => v.toUpperCase());
+ * ```
+ * The `result` will be `['A', 'B']`.
+ *
+ * - Example 2: resolve one or more entries asynchronously
+ * ```ts
+ * const result = resolveList(['a', 'b'], v =>
+ *   Promise.resolve(v.toUpperCase()),
+ * );
+ * ```
+ * The `result` will be a promise of `['A', 'B']`.
+ *
+ * @param list - The original array containing the source entries
+ * @param resolver - A function resolves an entry to a value or promise. It will
+ * be invoked with the property value, the property index, and the source array.
+ */
+function resolveList(list, resolver) {
+    const result = new Array(list.length);
+    let asyncResolvers = undefined;
+    const setter = (index) => (val) => {
+        result[index] = val;
+    };
+    for (let ix = 0; ix < list.length; ix++) {
+        const valueOrPromise = resolver(list[ix], ix, list);
+        if (isPromiseLike(valueOrPromise)) {
+            if (!asyncResolvers)
+                asyncResolvers = [];
+            asyncResolvers.push(valueOrPromise.then(setter(ix)));
+        }
+        else {
+            result[ix] = valueOrPromise;
+        }
+    }
+    if (asyncResolvers) {
+        return Promise.all(asyncResolvers).then(() => result);
+    }
+    else {
+        return result;
+    }
+}
+exports.resolveList = resolveList;
+/**
+ * Try to run an action that returns a promise or a value
+ * @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) {
+        result = reject(err);
+    }
+    if (isPromiseLike(result)) {
+        return result.then(resolve, reject);
+    }
+    return resolve(result);
+    function resolve(value) {
+        try {
+            return value;
+        }
+        finally {
+            finalAction();
+        }
+    }
+    function reject(err) {
+        try {
+            return errorAction(err);
+        }
+        finally {
+            finalAction();
+        }
+    }
+}
+exports.tryCatchFinally = tryCatchFinally;
+/**
+ * Resolve an iterator of source values into a result until the evaluator
+ * returns `true`
+ * @param source - The iterator of source values
+ * @param resolver - The resolve function that maps the source value to a result
+ * @param evaluator - The evaluate function that decides when to stop
+ */
+function resolveUntil(source, resolver, evaluator) {
+    // Do iteration in loop for synchronous values to avoid stack overflow
+    // eslint-disable-next-line no-constant-condition
+    while (true) {
+        const next = source.next();
+        if (next.done)
+            return undefined; // End of the iterator
+        const sourceVal = next.value;
+        const valueOrPromise = resolver(sourceVal);
+        if (isPromiseLike(valueOrPromise)) {
+            return valueOrPromise.then(v => {
+                if (evaluator(sourceVal, v)) {
+                    return v;
+                }
+                else {
+                    return resolveUntil(source, resolver, evaluator);
+                }
+            });
+        }
+        else {
+            if (evaluator(sourceVal, valueOrPromise)) {
+                return valueOrPromise;
+            }
+            // Continue with the while loop
+        }
+    }
+}
+exports.resolveUntil = resolveUntil;
+/**
+ * Transform a value or promise with a function that produces a new value or
+ * promise
+ * @param valueOrPromise - The value or promise
+ * @param transformer - A function that maps the source value to a value or promise
+ */
+function transformValueOrPromise(valueOrPromise, transformer) {
+    if (isPromiseLike(valueOrPromise)) {
+        return valueOrPromise.then(transformer);
+    }
+    else {
+        return transformer(valueOrPromise);
+    }
+}
+exports.transformValueOrPromise = transformValueOrPromise;
+/**
+ * A utility to generate uuid v4
+ *
+ * @deprecated Use `generateUniqueId`, [uuid](https://www.npmjs.com/package/uuid)
+ * or [hyperid](https://www.npmjs.com/package/hyperid) instead.
+ */
+function uuid() {
+    return (0, uuid_1.v4)();
+}
+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

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

package/package.json

@@ -1,31 +1,7 @@
 {
   "name": "@loopback/context",
-  "version": "4.0.0-alpha.8",
-  "description": "LoopBack's container for Inversion of Control",
-  "scripts": {
-    "acceptance": "mocha --opts ../../test/mocha.opts 'test/acceptance/**/*.ts'",
-    "build": "npm run build:lib && npm run build:lib6",
-    "build:lib": "node ../../bin/compile-package es2017",
-    "build:lib6": "node ../../bin/compile-package es2015",
-    "clean": "rm -rf loopback-context*.tgz lib* package",
-    "prepublish": "npm run build",
-    "pretest": "npm run build",
-    "test": "mocha --opts ../../test/mocha.opts 'test/unit/**/*.ts' 'test/acceptance/**/*.ts'",
-    "unit": "mocha --opts ../../test/mocha.opts 'test/unit/**/*.ts'",
-    "verify": "npm pack && tar xf loopback-context*.tgz && tree package && npm run clean"
-  },
-  "author": "IBM",
-  "license": "MIT",
-  "dependencies": {
-    "reflect-metadata": "^0.1.10"
-  },
-  "devDependencies": {
-    "@loopback/testlab": "^4.0.0-alpha.4",
-    "@types/bluebird": "^3.5.2",
-    "bluebird": "^3.5.0",
-    "mocha": "^3.2.0",
-    "typescript": "^2.3.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",
+  "version": "4.1.0",
   "keywords": [
     "LoopBack",
     "IoC",
@@ -35,15 +11,54 @@
     "Decorators",
     "Context"
   ],
+  "license": "MIT",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "author": "IBM Corp.",
+  "copyright.owner": "IBM Corp.",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/loopbackio/loopback-next.git",
+    "directory": "packages/context"
+  },
+  "engines": {
+    "node": "12 || 14 || 16 || 17"
+  },
+  "scripts": {
+    "acceptance": "lb-mocha \"dist/__tests__/acceptance/**/*.js\"",
+    "build": "lb-tsc",
+    "clean": "lb-clean loopback-context*.tgz dist *.tsbuildinfo package",
+    "pretest": "npm run build",
+    "test": "lb-mocha \"dist/__tests__/**/*.js\"",
+    "unit": "lb-mocha \"dist/__tests__/unit/**/*.js\"",
+    "verify": "npm pack && tar xf loopback-context*.tgz && tree package && npm run clean"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
   "files": [
     "README.md",
-    "index.js",
-    "index.d.ts",
-    "lib",
-    "lib6"
+    "dist",
+    "src",
+    "!*/__tests__"
   ],
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/strongloop/loopback-next.git"
-  }
+  "dependencies": {
+    "@loopback/metadata": "^4.1.0",
+    "@types/debug": "^4.1.7",
+    "debug": "^4.3.3",
+    "hyperid": "^3.0.0",
+    "p-event": "^4.2.0",
+    "tslib": "^2.3.1",
+    "uuid": "^8.3.2"
+  },
+  "devDependencies": {
+    "@loopback/build": "^8.1.0",
+    "@loopback/eslint-config": "^12.0.2",
+    "@loopback/testlab": "^4.1.0",
+    "@types/bluebird": "^3.5.36",
+    "@types/node": "^12.20.43",
+    "@types/uuid": "^8.3.4",
+    "bluebird": "^3.7.2"
+  },
+  "gitHead": "e16818ccb01edc0269ef6c45b022c5f1b67f852c"
 }

package/src/binding-config.ts

@@ -0,0 +1,73 @@
+// Copyright IBM Corp. 2019,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
+
+import {BindingAddress, BindingKey} from './binding-key';
+import {Context} from './context';
+import {ResolutionOptions} from './resolution-session';
+import {ValueOrPromise} from './value-promise';
+
+/**
+ * Resolver for configuration of bindings. It's responsible for finding
+ * corresponding configuration for a given binding key.
+ *
+ * By default, `undefined` is expected if no configuration is provided. The
+ * behavior can be overridden by setting `optional` to `false` in resolution
+ * options.
+ */
+export interface ConfigurationResolver {
+  /**
+   * Resolve config for the binding key
+   *
+   * @param key - Binding key
+   * @param propertyPath - Property path for the option. For example, `x.y`
+   * requests for `<config>.x.y`. If not set, the `config` object will be
+   * returned.
+   * @param resolutionOptions - Options for the resolution.
+   * - optional: if not set or set to `true`, `undefined` will be returned if
+   * no corresponding value is found. Otherwise, an error will be thrown.
+   */
+  getConfigAsValueOrPromise<ConfigValueType>(
+    key: BindingAddress<unknown>,
+    propertyPath?: string,
+    resolutionOptions?: ResolutionOptions,
+  ): ValueOrPromise<ConfigValueType | undefined>;
+}
+
+/**
+ * Resolver for configurations of bindings
+ */
+export class DefaultConfigurationResolver implements ConfigurationResolver {
+  constructor(public readonly context: Context) {}
+
+  getConfigAsValueOrPromise<ConfigValueType>(
+    key: BindingAddress<unknown>,
+    propertyPath?: string,
+    resolutionOptions?: ResolutionOptions,
+  ): ValueOrPromise<ConfigValueType | undefined> {
+    propertyPath = propertyPath ?? '';
+    const configKey = configBindingKeyFor(key, propertyPath);
+
+    const options: ResolutionOptions = Object.assign(
+      {optional: true},
+      resolutionOptions,
+    );
+    return this.context.getValueOrPromise<ConfigValueType>(configKey, options);
+  }
+}
+
+/**
+ * Create binding key for configuration of the binding
+ * @param key - Binding key for the target binding
+ * @param propertyPath - Property path for the configuration
+ */
+export function configBindingKeyFor<ConfigValueType = unknown>(
+  key: BindingAddress,
+  propertyPath?: string,
+) {
+  return BindingKey.create<ConfigValueType>(
+    BindingKey.buildKeyForConfig<ConfigValueType>(key).toString(),
+    propertyPath,
+  );
+}

package/src/binding-decorator.ts

@@ -0,0 +1,136 @@
+// 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
+
+import {ClassDecoratorFactory} from '@loopback/metadata';
+import {
+  asBindingTemplate,
+  asClassOrProvider,
+  asProvider,
+  BindingMetadata,
+  BindingSpec,
+  BINDING_METADATA_KEY,
+  isProviderClass,
+  removeNameAndKeyTags,
+} from './binding-inspector';
+import {Constructor} from './value-promise';
+
+/**
+ * Decorator factory for `@injectable`
+ */
+class InjectableDecoratorFactory extends ClassDecoratorFactory<BindingMetadata> {
+  mergeWithInherited(inherited: BindingMetadata, target: Function) {
+    if (inherited) {
+      return {
+        templates: [
+          ...inherited.templates,
+          removeNameAndKeyTags,
+          ...this.spec.templates,
+        ],
+        target: this.spec.target,
+      };
+    } else {
+      this.withTarget(this.spec, target);
+      return this.spec;
+    }
+  }
+
+  mergeWithOwn(ownMetadata: BindingMetadata) {
+    return {
+      templates: [...ownMetadata.templates, ...this.spec.templates],
+      target: this.spec.target,
+    };
+  }
+
+  withTarget(spec: BindingMetadata, target: Function) {
+    spec.target = target as Constructor<unknown>;
+    return spec;
+  }
+}
+
+/**
+ * Decorate a class with binding configuration
+ *
+ * @example
+ * ```ts
+ * @injectable((binding) => {binding.inScope(BindingScope.SINGLETON).tag('controller')}
+ * )
+ * @injectable({scope: BindingScope.SINGLETON})
+ * export class MyController {
+ * }
+ * ```
+ *
+ * @param specs - A list of binding scope/tags or template functions to
+ * configure the binding
+ */
+export function injectable(...specs: BindingSpec[]): ClassDecorator {
+  const templateFunctions = specs.map(t => {
+    if (typeof t === 'function') {
+      return t;
+    } else {
+      return asBindingTemplate(t);
+    }
+  });
+
+  return (target: Function) => {
+    const cls = target as Constructor<unknown>;
+    const spec: BindingMetadata = {
+      templates: [asClassOrProvider(cls), ...templateFunctions],
+      target: cls,
+    };
+
+    const decorator = InjectableDecoratorFactory.createDecorator(
+      BINDING_METADATA_KEY,
+      spec,
+      {decoratorName: '@injectable'},
+    );
+    decorator(target);
+  };
+}
+
+/**
+ * A namespace to host shortcuts for `@injectable`
+ */
+export namespace injectable {
+  /**
+   * `@injectable.provider` to denote a provider class
+   *
+   * A list of binding scope/tags or template functions to configure the binding
+   */
+  export function provider(
+    ...specs: BindingSpec[]
+  ): (target: Constructor<unknown>) => void {
+    return (target: Constructor<unknown>) => {
+      if (!isProviderClass(target)) {
+        throw new Error(`Target ${target} is not a Provider`);
+      }
+      injectable(
+        // Set up the default for providers
+        asProvider(target),
+        // Call other template functions
+        ...specs,
+      )(target);
+    };
+  }
+}
+
+/**
+ * `@bind` is now an alias to {@link injectable} for backward compatibility
+ * {@inheritDoc injectable}
+ */
+export function bind(...specs: BindingSpec[]): ClassDecorator {
+  return injectable(...specs);
+}
+
+/**
+ * Alias namespace `bind` to `injectable` for backward compatibility
+ *
+ * It should have the same members as `bind`.
+ */
+export namespace bind {
+  /**
+   * {@inheritDoc injectable.provider}
+   */
+  export const provider = injectable.provider;
+}