@loopback/context 4.0.0-alpha.8 → 4.1.0

package/dist/context-tag-indexer.js

@@ -0,0 +1,135 @@
+"use strict";
+// Copyright IBM Corp. 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.ContextTagIndexer = void 0;
+const binding_filter_1 = require("./binding-filter");
+/**
+ * Indexer for context bindings by tag
+ */
+class ContextTagIndexer {
+    constructor(context) {
+        this.context = context;
+        /**
+         * Index for bindings by tag names
+         */
+        this.bindingsIndexedByTag = new Map();
+        this.setupTagIndexForBindings();
+    }
+    /**
+     * Set up context/binding listeners and refresh index for bindings by tag
+     */
+    setupTagIndexForBindings() {
+        this.bindingEventListener = ({ binding, operation }) => {
+            if (operation === 'tag') {
+                this.updateTagIndexForBinding(binding);
+            }
+        };
+        this.tagIndexListener = event => {
+            const { binding, type } = event;
+            if (event.context !== this.context)
+                return;
+            if (type === 'bind') {
+                this.updateTagIndexForBinding(binding);
+                binding.on('changed', this.bindingEventListener);
+            }
+            else if (type === 'unbind') {
+                this.removeTagIndexForBinding(binding);
+                binding.removeListener('changed', this.bindingEventListener);
+            }
+        };
+        this.context.on('bind', this.tagIndexListener);
+        this.context.on('unbind', this.tagIndexListener);
+    }
+    /**
+     * Remove tag index for the given binding
+     * @param binding - Binding object
+     */
+    removeTagIndexForBinding(binding) {
+        for (const [, bindings] of this.bindingsIndexedByTag) {
+            bindings.delete(binding);
+        }
+    }
+    /**
+     * Update tag index for the given binding
+     * @param binding - Binding object
+     */
+    updateTagIndexForBinding(binding) {
+        this.removeTagIndexForBinding(binding);
+        for (const tag of binding.tagNames) {
+            let bindings = this.bindingsIndexedByTag.get(tag);
+            if (bindings == null) {
+                bindings = new Set();
+                this.bindingsIndexedByTag.set(tag, bindings);
+            }
+            bindings.add(binding);
+        }
+    }
+    /**
+     * Find bindings by tag leveraging indexes
+     * @param tag - Tag name pattern or name/value pairs
+     */
+    findByTagIndex(tag) {
+        let tagNames;
+        // A flag to control if a union of matched bindings should be created
+        let union = false;
+        if (tag instanceof RegExp) {
+            // For wildcard/regexp, a union of matched bindings is desired
+            union = true;
+            // Find all matching tag names
+            tagNames = [];
+            for (const t of this.bindingsIndexedByTag.keys()) {
+                if (tag.test(t)) {
+                    tagNames.push(t);
+                }
+            }
+        }
+        else if (typeof tag === 'string') {
+            tagNames = [tag];
+        }
+        else {
+            tagNames = Object.keys(tag);
+        }
+        let filter;
+        let bindings;
+        for (const t of tagNames) {
+            const bindingsByTag = this.bindingsIndexedByTag.get(t);
+            if (bindingsByTag == null)
+                break; // One of the tags is not found
+            filter = filter !== null && filter !== void 0 ? filter : (0, binding_filter_1.filterByTag)(tag);
+            const matched = new Set(Array.from(bindingsByTag).filter(filter));
+            if (!union && matched.size === 0)
+                break; // One of the tag name/value is not found
+            if (bindings == null) {
+                // First set of bindings matching the tag
+                bindings = matched;
+            }
+            else {
+                if (union) {
+                    matched.forEach(b => bindings === null || bindings === void 0 ? void 0 : bindings.add(b));
+                }
+                else {
+                    // Now need to find intersected bindings against visited tags
+                    const intersection = new Set();
+                    bindings.forEach(b => {
+                        if (matched.has(b)) {
+                            intersection.add(b);
+                        }
+                    });
+                    bindings = intersection;
+                }
+                if (!union && bindings.size === 0)
+                    break;
+            }
+        }
+        return bindings == null ? [] : Array.from(bindings);
+    }
+    close() {
+        this.context.removeListener('bind', this.tagIndexListener);
+        this.context.removeListener('unbind', this.tagIndexListener);
+    }
+}
+exports.ContextTagIndexer = ContextTagIndexer;
+//# sourceMappingURL=context-tag-indexer.js.map

package/dist/context-tag-indexer.js.map

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

package/dist/context-view.d.ts

@@ -0,0 +1,209 @@
+/// <reference types="node" />
+import { EventEmitter } from 'events';
+import { Binding } from './binding';
+import { BindingFilter } from './binding-filter';
+import { BindingComparator } from './binding-sorter';
+import { Context } from './context';
+import { ContextEvent } from './context-event';
+import { ContextEventType, ContextObserver } from './context-observer';
+import { Subscription } from './context-subscription';
+import { Getter } from './inject';
+import { ResolutionOptions, ResolutionOptionsOrSession, ResolutionSession } from './resolution-session';
+import { ValueOrPromise } from './value-promise';
+/**
+ * An event emitted by a `ContextView`
+ */
+export interface ContextViewEvent<T> extends ContextEvent {
+    /**
+     * Optional cached value for an `unbind` event
+     */
+    cachedValue?: T;
+}
+/**
+ * `ContextView` provides a view for a given context chain to maintain a live
+ * list of matching bindings and their resolved values within the context
+ * hierarchy.
+ *
+ * This class is the key utility to implement dynamic extensions for extension
+ * points. For example, the RestServer can react to `controller` bindings even
+ * they are added/removed/updated after the application starts.
+ *
+ * `ContextView` is an event emitter that emits the following events:
+ * - 'bind': when a binding is added to the view
+ * - 'unbind': when a binding is removed from the view
+ * - 'close': when the view is closed (stopped observing context events)
+ * - 'refresh': when the view is refreshed as bindings are added/removed
+ * - 'resolve': when the cached values are resolved and updated
+ */
+export declare class ContextView<T = unknown> extends EventEmitter implements ContextObserver {
+    readonly context: Context;
+    readonly filter: BindingFilter;
+    readonly comparator?: BindingComparator | undefined;
+    private resolutionOptions?;
+    /**
+     * An array of cached bindings that matches the binding filter
+     */
+    protected _cachedBindings: Readonly<Binding<T>>[] | undefined;
+    /**
+     * A map of cached values by binding
+     */
+    protected _cachedValues: Map<Readonly<Binding<T>>, T> | undefined;
+    private _subscription;
+    /**
+     * Create a context view
+     * @param context - Context object to watch
+     * @param filter - Binding filter to match bindings of interest
+     * @param comparator - Comparator to sort the matched bindings
+     */
+    constructor(context: Context, filter: BindingFilter, comparator?: BindingComparator | undefined, resolutionOptions?: Omit<ResolutionOptions, "session"> | undefined);
+    /**
+     * Update the cached values keyed by binding
+     * @param values - An array of resolved values
+     */
+    private updateCachedValues;
+    /**
+     * Get an array of cached values
+     */
+    private getCachedValues;
+    /**
+     * Start listening events from the context
+     */
+    open(): Subscription | undefined;
+    /**
+     * Stop listening events from the context
+     */
+    close(): void;
+    /**
+     * Get the list of matched bindings. If they are not cached, it tries to find
+     * them from the context.
+     */
+    get bindings(): Readonly<Binding<T>>[];
+    /**
+     * Find matching bindings and refresh the cache
+     */
+    protected findBindings(): Readonly<Binding<T>>[];
+    /**
+     * Listen on `bind` or `unbind` and invalidate the cache
+     */
+    observe(event: ContextEventType, binding: Readonly<Binding<unknown>>, context: Context): void;
+    /**
+     * Refresh the view by invalidating its cache
+     */
+    refresh(): void;
+    /**
+     * Resolve values for the matching bindings
+     * @param session - Resolution session
+     */
+    resolve(session?: ResolutionOptionsOrSession): ValueOrPromise<T[]>;
+    /**
+     * Get the list of resolved values. If they are not cached, it tries to find
+     * and resolve them.
+     */
+    values(session?: ResolutionOptionsOrSession): Promise<T[]>;
+    /**
+     * As a `Getter` function
+     */
+    asGetter(session?: ResolutionOptionsOrSession): Getter<T[]>;
+    /**
+     * Get the single value
+     */
+    singleValue(session?: ResolutionOptionsOrSession): Promise<T | undefined>;
+    /**
+     * 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: <V>(event: ContextViewEvent<V>) => 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: <V>(event: ContextViewEvent<V> & {
+        cachedValue?: V;
+    }) => 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.
+     */
+    on(eventName: 'refresh', listener: <V>(result: V[]) => 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.
+     */
+    on(eventName: 'close', listener: () => void): this;
+    on(event: string | symbol, listener: (...args: any[]) => void): this;
+    /**
+     * 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: <V>(event: ContextViewEvent<V>) => 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: <V>(event: ContextViewEvent<V> & {
+        cachedValue?: V;
+    }) => 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.
+     */
+    once(eventName: 'refresh', listener: <V>(result: V[]) => 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.
+     */
+    once(eventName: 'close', listener: () => void): this;
+    once(event: string | symbol, listener: (...args: any[]) => void): this;
+}
+/**
+ * Create a context view as a getter with the given filter
+ * @param ctx - Context object
+ * @param bindingFilter - A function to match bindings
+ * @param session - Resolution session
+ */
+export declare function createViewGetter<T = unknown>(ctx: Context, bindingFilter: BindingFilter, session?: ResolutionSession): Getter<T[]>;
+/**
+ * Create a context view as a getter with the given filter and sort matched
+ * bindings by the comparator.
+ * @param ctx - Context object
+ * @param bindingFilter - A function to match bindings
+ * @param bindingComparator - A function to compare two bindings
+ * @param session - Resolution session
+ */
+export declare function createViewGetter<T = unknown>(ctx: Context, bindingFilter: BindingFilter, bindingComparator?: BindingComparator, session?: ResolutionOptionsOrSession): Getter<T[]>;

package/dist/context-view.js

@@ -0,0 +1,240 @@
+"use strict";
+// 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
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createViewGetter = exports.ContextView = void 0;
+const tslib_1 = require("tslib");
+const debug_1 = (0, tslib_1.__importDefault)(require("debug"));
+const events_1 = require("events");
+const util_1 = require("util");
+const resolution_session_1 = require("./resolution-session");
+const value_promise_1 = require("./value-promise");
+const debug = (0, debug_1.default)('loopback:context:view');
+const nextTick = (0, util_1.promisify)(process.nextTick);
+/**
+ * `ContextView` provides a view for a given context chain to maintain a live
+ * list of matching bindings and their resolved values within the context
+ * hierarchy.
+ *
+ * This class is the key utility to implement dynamic extensions for extension
+ * points. For example, the RestServer can react to `controller` bindings even
+ * they are added/removed/updated after the application starts.
+ *
+ * `ContextView` is an event emitter that emits the following events:
+ * - 'bind': when a binding is added to the view
+ * - 'unbind': when a binding is removed from the view
+ * - 'close': when the view is closed (stopped observing context events)
+ * - 'refresh': when the view is refreshed as bindings are added/removed
+ * - 'resolve': when the cached values are resolved and updated
+ */
+class ContextView extends events_1.EventEmitter {
+    /**
+     * Create a context view
+     * @param context - Context object to watch
+     * @param filter - Binding filter to match bindings of interest
+     * @param comparator - Comparator to sort the matched bindings
+     */
+    constructor(context, filter, comparator, resolutionOptions) {
+        super();
+        this.context = context;
+        this.filter = filter;
+        this.comparator = comparator;
+        this.resolutionOptions = resolutionOptions;
+    }
+    /**
+     * Update the cached values keyed by binding
+     * @param values - An array of resolved values
+     */
+    updateCachedValues(values) {
+        var _a;
+        if (this._cachedBindings == null)
+            return undefined;
+        this._cachedValues = new Map();
+        for (let i = 0; i < ((_a = this._cachedBindings) === null || _a === void 0 ? void 0 : _a.length); i++) {
+            this._cachedValues.set(this._cachedBindings[i], values[i]);
+        }
+        return this._cachedValues;
+    }
+    /**
+     * Get an array of cached values
+     */
+    getCachedValues() {
+        var _a, _b;
+        return Array.from((_b = (_a = this._cachedValues) === null || _a === void 0 ? void 0 : _a.values()) !== null && _b !== void 0 ? _b : []);
+    }
+    /**
+     * Start listening events from the context
+     */
+    open() {
+        debug('Start listening on changes of context %s', this.context.name);
+        if (this.context.isSubscribed(this)) {
+            return this._subscription;
+        }
+        this._subscription = this.context.subscribe(this);
+        return this._subscription;
+    }
+    /**
+     * Stop listening events from the context
+     */
+    close() {
+        debug('Stop listening on changes of context %s', this.context.name);
+        if (!this._subscription || this._subscription.closed)
+            return;
+        this._subscription.unsubscribe();
+        this._subscription = undefined;
+        this.emit('close');
+    }
+    /**
+     * Get the list of matched bindings. If they are not cached, it tries to find
+     * them from the context.
+     */
+    get bindings() {
+        debug('Reading bindings');
+        if (this._cachedBindings == null) {
+            this._cachedBindings = this.findBindings();
+        }
+        return this._cachedBindings;
+    }
+    /**
+     * Find matching bindings and refresh the cache
+     */
+    findBindings() {
+        debug('Finding matching bindings');
+        const found = this.context.find(this.filter);
+        if (typeof this.comparator === 'function') {
+            found.sort(this.comparator);
+        }
+        /* istanbul ignore if */
+        if (debug.enabled) {
+            debug('Bindings found', found.map(b => b.key));
+        }
+        return found;
+    }
+    /**
+     * Listen on `bind` or `unbind` and invalidate the cache
+     */
+    observe(event, binding, context) {
+        var _a;
+        const ctxEvent = {
+            context,
+            binding,
+            type: event,
+        };
+        debug('Observed event %s %s %s', event, binding.key, context.name);
+        if (event === 'unbind') {
+            const cachedValue = (_a = this._cachedValues) === null || _a === void 0 ? void 0 : _a.get(binding);
+            this.emit(event, { ...ctxEvent, cachedValue });
+        }
+        else {
+            this.emit(event, ctxEvent);
+        }
+        this.refresh();
+    }
+    /**
+     * Refresh the view by invalidating its cache
+     */
+    refresh() {
+        debug('Refreshing the view by invalidating cache');
+        this._cachedBindings = undefined;
+        this._cachedValues = undefined;
+        this.emit('refresh');
+    }
+    /**
+     * Resolve values for the matching bindings
+     * @param session - Resolution session
+     */
+    resolve(session) {
+        debug('Resolving values');
+        if (this._cachedValues != null) {
+            return this.getCachedValues();
+        }
+        const bindings = this.bindings;
+        let result = (0, value_promise_1.resolveList)(bindings, b => {
+            const options = {
+                ...this.resolutionOptions,
+                ...(0, resolution_session_1.asResolutionOptions)(session),
+            };
+            options.session = resolution_session_1.ResolutionSession.fork(options.session);
+            return b.getValue(this.context, options);
+        });
+        if ((0, value_promise_1.isPromiseLike)(result)) {
+            result = result.then(values => {
+                const list = values.filter(v => v != null);
+                this.updateCachedValues(list);
+                this.emit('resolve', list);
+                return list;
+            });
+        }
+        else {
+            // Clone the array so that the cached values won't be mutated
+            const list = (result = result.filter(v => v != null));
+            this.updateCachedValues(list);
+            this.emit('resolve', list);
+        }
+        return result;
+    }
+    /**
+     * Get the list of resolved values. If they are not cached, it tries to find
+     * and resolve them.
+     */
+    async values(session) {
+        debug('Reading values');
+        // Wait for the next tick so that context event notification can be emitted
+        await nextTick();
+        if (this._cachedValues == null) {
+            return this.resolve(session);
+        }
+        return this.getCachedValues();
+    }
+    /**
+     * As a `Getter` function
+     */
+    asGetter(session) {
+        return () => this.values(session);
+    }
+    /**
+     * Get the single value
+     */
+    async singleValue(session) {
+        const values = await this.values(session);
+        if (values.length === 0)
+            return undefined;
+        if (values.length === 1)
+            return values[0];
+        throw new Error('The ContextView has more than one value. Use values() to access them.');
+    }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    on(event, listener) {
+        return super.on(event, listener);
+    }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    once(event, listener) {
+        return super.once(event, listener);
+    }
+}
+exports.ContextView = ContextView;
+/**
+ * Create a context view as a getter
+ * @param ctx - Context object
+ * @param bindingFilter - A function to match bindings
+ * @param bindingComparatorOrSession - A function to sort matched bindings or
+ * resolution session if the comparator is not needed
+ * @param session - Resolution session if the comparator is provided
+ */
+function createViewGetter(ctx, bindingFilter, bindingComparatorOrSession, session) {
+    let bindingComparator = undefined;
+    if (typeof bindingComparatorOrSession === 'function') {
+        bindingComparator = bindingComparatorOrSession;
+    }
+    else if (bindingComparatorOrSession instanceof resolution_session_1.ResolutionSession) {
+        session = bindingComparatorOrSession;
+    }
+    const options = (0, resolution_session_1.asResolutionOptions)(session);
+    const view = new ContextView(ctx, bindingFilter, bindingComparator, options);
+    view.open();
+    return view.asGetter(options);
+}
+exports.createViewGetter = createViewGetter;
+//# sourceMappingURL=context-view.js.map

package/dist/context-view.js.map

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