@loopback/context 1.23.5 → 2.0.0

package/dist/context-observer.d.ts

@@ -1,7 +1,7 @@
 import { Binding } from './binding';
 import { BindingFilter } from './binding-filter';
-import { ValueOrPromise } from './value-promise';
 import { Context } from './context';
+import { ValueOrPromise } from './value-promise';
 /**
  * Context event types. We support `bind` and `unbind` for now but
  * keep it open for new types
@@ -34,38 +34,3 @@ export interface ContextObserver {
  * Context event observer type - An instance of `ContextObserver` or a function
  */
 export declare type ContextEventObserver = ContextObserver | ContextObserverFn;
-/**
- * Subscription of context events. It's modeled after
- * https://github.com/tc39/proposal-observable.
- */
-export interface Subscription {
-    /**
-     * unsubscribe
-     */
-    unsubscribe(): void;
-    /**
-     * Is the subscription closed?
-     */
-    closed: boolean;
-}
-/**
- * Event data for observer notifications
- */
-export declare type Notification = {
-    /**
-     * Context event type - bind/unbind
-     */
-    eventType: ContextEventType;
-    /**
-     * Binding added/removed
-     */
-    binding: Readonly<Binding<unknown>>;
-    /**
-     * Owner context for the binding
-     */
-    context: Context;
-    /**
-     * A snapshot of observers when the original event is emitted
-     */
-    observers: Set<ContextEventObserver>;
-};

package/dist/context-subscription.d.ts

@@ -0,0 +1,147 @@
+/// <reference types="node" />
+import { EventEmitter } from 'events';
+import { Context } from './context';
+import { ContextEvent, ContextEventListener } from './context-event';
+import { ContextEventObserver, ContextObserver } from './context-observer';
+/**
+ * Subscription of context events. It's modeled after
+ * https://github.com/tc39/proposal-observable.
+ */
+export interface Subscription {
+    /**
+     * unsubscribe
+     */
+    unsubscribe(): void;
+    /**
+     * Is the subscription closed?
+     */
+    closed: boolean;
+}
+/**
+ * Event data for observer notifications
+ */
+export interface Notification extends ContextEvent {
+    /**
+     * A snapshot of observers when the original event is emitted
+     */
+    observers: Set<ContextEventObserver>;
+}
+/**
+ * Manager for context observer subscriptions
+ */
+export declare class ContextSubscriptionManager extends EventEmitter {
+    protected readonly context: Context;
+    /**
+     * A listener to watch parent context events
+     */
+    protected _parentContextEventListener?: ContextEventListener;
+    /**
+     * A list of registered context observers. The Set will be created when the
+     * first observer is added.
+     */
+    protected _observers: Set<ContextEventObserver> | undefined;
+    /**
+     * Internal counter for pending notification events which are yet to be
+     * processed by observers.
+     */
+    private pendingNotifications;
+    /**
+     * Queue for background notifications for observers
+     */
+    private notificationQueue;
+    constructor(context: Context);
+    /**
+     * @internal
+     */
+    get parentContextEventListener(): ContextEventListener | undefined;
+    /**
+     * @internal
+     */
+    get observers(): Set<ContextEventObserver> | undefined;
+    /**
+     * Wrap the debug statement so that it always print out the context name
+     * as the prefix
+     * @param args - Arguments for the debug
+     */
+    private _debug;
+    /**
+     * Set up an internal listener to notify registered observers asynchronously
+     * upon `bind` and `unbind` events. This method will be called lazily when
+     * the first observer is added.
+     */
+    private setupEventHandlersIfNeeded;
+    private handleParentEvent;
+    /**
+     * A strongly-typed method to emit context events
+     * @param type Event type
+     * @param event Context event
+     */
+    private emitEvent;
+    /**
+     * Emit an `error` event
+     * @param err Error
+     */
+    private emitError;
+    /**
+     * Start a background task to listen on context events and notify observers
+     */
+    private startNotificationTask;
+    /**
+     * Publish an event to the registered observers. Please note the
+     * notification is queued and performed asynchronously so that we allow fluent
+     * APIs such as `ctx.bind('key').to(...).tag(...);` and give observers the
+     * fully populated binding.
+     *
+     * @param event - Context event
+     * @param observers - Current set of context observers
+     */
+    protected notifyObservers(event: ContextEvent, observers?: Set<ContextEventObserver> | undefined): Promise<void>;
+    /**
+     * Process notification events as they arrive on the queue
+     */
+    private processNotifications;
+    /**
+     * Listen on given event types and emit `notification` event. This method
+     * merge multiple event types into one for notification.
+     * @param eventTypes - Context event types
+     */
+    private setupNotification;
+    /**
+     * Wait until observers are notified for all of currently pending notification
+     * events.
+     *
+     * This method is for test only to perform assertions after observers are
+     * notified for relevant events.
+     */
+    waitUntilPendingNotificationsDone(timeout?: number): Promise<void>;
+    /**
+     * Add a context event observer to the context
+     * @param observer - Context observer instance or function
+     */
+    subscribe(observer: ContextEventObserver): Subscription;
+    /**
+     * Remove the context event observer from the context
+     * @param observer - Context event observer
+     */
+    unsubscribe(observer: ContextEventObserver): boolean;
+    /**
+     * Check if an observer is subscribed to this context
+     * @param observer - Context observer
+     */
+    isSubscribed(observer: ContextObserver): boolean;
+    /**
+     * Handle errors caught during the notification of observers
+     * @param err - Error
+     */
+    private handleNotificationError;
+    /**
+     * Close the context: clear observers, stop notifications, and remove event
+     * listeners from its parent context.
+     *
+     * @remarks
+     * This method MUST be called to avoid memory leaks once a context object is
+     * no longer needed and should be recycled. An example is the `RequestContext`,
+     * which is created per request.
+     */
+    close(): void;
+}

package/dist/context-subscription.js

@@ -0,0 +1,336 @@
+"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
+var __asyncValues = (this && this.__asyncValues) || function (o) {
+    if (!Symbol.asyncIterator) throw new TypeError("Symbol.asyncIterator is not defined.");
+    var m = o[Symbol.asyncIterator], i;
+    return m ? m.call(o) : (o = typeof __values === "function" ? __values(o) : o[Symbol.iterator](), i = {}, verb("next"), verb("throw"), verb("return"), i[Symbol.asyncIterator] = function () { return this; }, i);
+    function verb(n) { i[n] = o[n] && function (v) { return new Promise(function (resolve, reject) { v = o[n](v), settle(resolve, reject, v.done, v.value); }); }; }
+    function settle(resolve, reject, d, v) { Promise.resolve(v).then(function(v) { resolve({ value: v, done: d }); }, reject); }
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const debug_1 = __importDefault(require("debug"));
+const events_1 = require("events");
+const debug = debug_1.default('loopback:context:subscription');
+/**
+ * Polyfill Symbol.asyncIterator as required by TypeScript for Node 8.x.
+ * See https://www.typescriptlang.org/docs/handbook/release-notes/typescript-2-3.html
+ */
+if (!Symbol.asyncIterator) {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    Symbol.asyncIterator = Symbol.for('Symbol.asyncIterator');
+}
+/**
+ * WARNING: This following import must happen after the polyfill. The
+ * `auto-import` by an IDE such as VSCode may move the import before the
+ * polyfill. It must be then fixed manually.
+ */
+const p_event_1 = require("p-event");
+/**
+ * An implementation of `Subscription` interface for context events
+ */
+class ContextSubscription {
+    constructor(context, observer) {
+        this.context = context;
+        this.observer = observer;
+        this._closed = false;
+    }
+    unsubscribe() {
+        this.context.unsubscribe(this.observer);
+        this._closed = true;
+    }
+    get closed() {
+        return this._closed;
+    }
+}
+/**
+ * Manager for context observer subscriptions
+ */
+class ContextSubscriptionManager extends events_1.EventEmitter {
+    constructor(context) {
+        super();
+        this.context = context;
+        /**
+         * Internal counter for pending notification events which are yet to be
+         * processed by observers.
+         */
+        this.pendingNotifications = 0;
+        this.setMaxListeners(Infinity);
+    }
+    /**
+     * @internal
+     */
+    get parentContextEventListener() {
+        return this._parentContextEventListener;
+    }
+    /**
+     * @internal
+     */
+    get observers() {
+        return this._observers;
+    }
+    /**
+     * Wrap the debug statement so that it always print out the context name
+     * as the prefix
+     * @param args - Arguments for the debug
+     */
+    _debug(...args) {
+        /* istanbul ignore if */
+        if (!debug.enabled)
+            return;
+        const formatter = args.shift();
+        if (typeof formatter === 'string') {
+            debug(`[%s] ${formatter}`, this.context.name, ...args);
+        }
+        else {
+            debug('[%s] ', this.context.name, formatter, ...args);
+        }
+    }
+    /**
+     * Set up an internal listener to notify registered observers asynchronously
+     * upon `bind` and `unbind` events. This method will be called lazily when
+     * the first observer is added.
+     */
+    setupEventHandlersIfNeeded() {
+        if (this.notificationQueue != null)
+            return;
+        if (this.context.parent != null) {
+            /**
+             * Add an event listener to its parent context so that this context will
+             * be notified of parent events, such as `bind` or `unbind`.
+             */
+            this._parentContextEventListener = event => {
+                this.handleParentEvent(event);
+            };
+            // Listen on the parent context events
+            this.context.parent.on('bind', this._parentContextEventListener);
+            this.context.parent.on('unbind', this._parentContextEventListener);
+        }
+        // The following are two async functions. Returned promises are ignored as
+        // they are long-running background tasks.
+        this.startNotificationTask().catch(err => {
+            this.handleNotificationError(err);
+        });
+        let ctx = this.context.parent;
+        while (ctx) {
+            ctx.subscriptionManager.setupEventHandlersIfNeeded();
+            ctx = ctx.parent;
+        }
+    }
+    handleParentEvent(event) {
+        const { binding, context, type } = event;
+        // Propagate the event to this context only if the binding key does not
+        // exist in this context. The parent binding is shadowed if there is a
+        // binding with the same key in this one.
+        if (this.context.contains(binding.key)) {
+            this._debug('Event %s %s is not re-emitted from %s to %s', type, binding.key, context.name, this.context.name);
+            return;
+        }
+        this._debug('Re-emitting %s %s from %s to %s', type, binding.key, context.name, this.context.name);
+        this.context.emitEvent(type, event);
+    }
+    /**
+     * A strongly-typed method to emit context events
+     * @param type Event type
+     * @param event Context event
+     */
+    emitEvent(type, event) {
+        this.emit(type, event);
+    }
+    /**
+     * Emit an `error` event
+     * @param err Error
+     */
+    emitError(err) {
+        this.emit('error', err);
+    }
+    /**
+     * Start a background task to listen on context events and notify observers
+     */
+    startNotificationTask() {
+        // Set up listeners on `bind` and `unbind` for notifications
+        this.setupNotification('bind', 'unbind');
+        // Create an async iterator for the `notification` event as a queue
+        this.notificationQueue = p_event_1.iterator(this, 'notification');
+        return this.processNotifications();
+    }
+    /**
+     * Publish an event to the registered observers. Please note the
+     * notification is queued and performed asynchronously so that we allow fluent
+     * APIs such as `ctx.bind('key').to(...).tag(...);` and give observers the
+     * fully populated binding.
+     *
+     * @param event - Context event
+     * @param observers - Current set of context observers
+     */
+    async notifyObservers(event, observers = this._observers) {
+        if (!observers || observers.size === 0)
+            return;
+        const { type, binding, context } = event;
+        for (const observer of observers) {
+            if (typeof observer === 'function') {
+                await observer(type, binding, context);
+            }
+            else if (!observer.filter || observer.filter(binding)) {
+                await observer.observe(type, binding, context);
+            }
+        }
+    }
+    /**
+     * Process notification events as they arrive on the queue
+     */
+    async processNotifications() {
+        var e_1, _a;
+        const events = this.notificationQueue;
+        if (events == null)
+            return;
+        try {
+            for (var events_2 = __asyncValues(events), events_2_1; events_2_1 = await events_2.next(), !events_2_1.done;) {
+                const { type, binding, context, observers } = events_2_1.value;
+                // The loop will happen asynchronously upon events
+                try {
+                    // The execution of observers happen in the Promise micro-task queue
+                    await this.notifyObservers({ type, binding, context }, observers);
+                    this.pendingNotifications--;
+                    this._debug('Observers notified for %s of binding %s', type, binding.key);
+                    this.emitEvent('observersNotified', { type, binding, context });
+                }
+                catch (err) {
+                    this.pendingNotifications--;
+                    this._debug('Error caught from observers', err);
+                    // Errors caught from observers. Emit it to the current context.
+                    // If no error listeners are registered, crash the process.
+                    this.emitError(err);
+                }
+            }
+        }
+        catch (e_1_1) { e_1 = { error: e_1_1 }; }
+        finally {
+            try {
+                if (events_2_1 && !events_2_1.done && (_a = events_2.return)) await _a.call(events_2);
+            }
+            finally { if (e_1) throw e_1.error; }
+        }
+    }
+    /**
+     * Listen on given event types and emit `notification` event. This method
+     * merge multiple event types into one for notification.
+     * @param eventTypes - Context event types
+     */
+    setupNotification(...eventTypes) {
+        for (const type of eventTypes) {
+            this.context.on(type, ({ binding, context }) => {
+                // No need to schedule notifications if no observers are present
+                if (!this._observers || this._observers.size === 0)
+                    return;
+                // Track pending events
+                this.pendingNotifications++;
+                // Take a snapshot of current observers to ensure notifications of this
+                // event will only be sent to current ones. Emit a new event to notify
+                // current context observers.
+                this.emitEvent('notification', {
+                    type,
+                    binding,
+                    context,
+                    observers: new Set(this._observers),
+                });
+            });
+        }
+    }
+    /**
+     * Wait until observers are notified for all of currently pending notification
+     * events.
+     *
+     * This method is for test only to perform assertions after observers are
+     * notified for relevant events.
+     */
+    async waitUntilPendingNotificationsDone(timeout) {
+        const count = this.pendingNotifications;
+        if (count === 0)
+            return;
+        await p_event_1.multiple(this, 'observersNotified', { count, timeout });
+    }
+    /**
+     * Add a context event observer to the context
+     * @param observer - Context observer instance or function
+     */
+    subscribe(observer) {
+        var _a;
+        this._observers = (_a = this._observers, (_a !== null && _a !== void 0 ? _a : new Set()));
+        this.setupEventHandlersIfNeeded();
+        this._observers.add(observer);
+        return new ContextSubscription(this.context, observer);
+    }
+    /**
+     * Remove the context event observer from the context
+     * @param observer - Context event observer
+     */
+    unsubscribe(observer) {
+        if (!this._observers)
+            return false;
+        return this._observers.delete(observer);
+    }
+    /**
+     * Check if an observer is subscribed to this context
+     * @param observer - Context observer
+     */
+    isSubscribed(observer) {
+        if (!this._observers)
+            return false;
+        return this._observers.has(observer);
+    }
+    /**
+     * Handle errors caught during the notification of observers
+     * @param err - Error
+     */
+    handleNotificationError(err) {
+        // Bubbling up the error event over the context chain
+        // until we find an error listener
+        let ctx = this.context;
+        while (ctx) {
+            if (ctx.listenerCount('error') === 0) {
+                // No error listener found, try its parent
+                ctx = ctx.parent;
+                continue;
+            }
+            this._debug('Emitting error to context %s', ctx.name, err);
+            ctx.emitError(err);
+            return;
+        }
+        // No context with error listeners found
+        this._debug('No error handler is configured for the context chain', err);
+        // Let it crash now by emitting an error event
+        this.context.emitError(err);
+    }
+    /**
+     * Close the context: clear observers, stop notifications, and remove event
+     * listeners from its parent context.
+     *
+     * @remarks
+     * This method MUST be called to avoid memory leaks once a context object is
+     * no longer needed and should be recycled. An example is the `RequestContext`,
+     * which is created per request.
+     */
+    close() {
+        this._observers = undefined;
+        if (this.notificationQueue != null) {
+            // Cancel the notification iterator
+            this.notificationQueue.return(undefined).catch(err => {
+                this.handleNotificationError(err);
+            });
+            this.notificationQueue = undefined;
+        }
+        if (this.context.parent && this._parentContextEventListener) {
+            this.context.parent.removeListener('bind', this._parentContextEventListener);
+            this.context.parent.removeListener('unbind', this._parentContextEventListener);
+            this._parentContextEventListener = undefined;
+        }
+    }
+}
+exports.ContextSubscriptionManager = ContextSubscriptionManager;
+//# sourceMappingURL=context-subscription.js.map

package/dist/context-subscription.js.map

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

package/dist/context-tag-indexer.d.ts

@@ -0,0 +1,42 @@
+import { Binding, BindingTag } from './binding';
+import { Context } from './context';
+import { BoundValue } from './value-promise';
+/**
+ * Indexer for context bindings by tag
+ */
+export declare class ContextTagIndexer {
+    protected readonly context: Context;
+    /**
+     * Index for bindings by tag names
+     */
+    readonly bindingsIndexedByTag: Map<string, Set<Readonly<Binding<unknown>>>>;
+    /**
+     * A listener for binding events
+     */
+    private bindingEventListener;
+    /**
+     * A listener to maintain tag index for bindings
+     */
+    private tagIndexListener;
+    constructor(context: Context);
+    /**
+     * Set up context/binding listeners and refresh index for bindings by tag
+     */
+    private setupTagIndexForBindings;
+    /**
+     * Remove tag index for the given binding
+     * @param binding - Binding object
+     */
+    private removeTagIndexForBinding;
+    /**
+     * Update tag index for the given binding
+     * @param binding - Binding object
+     */
+    private updateTagIndexForBinding;
+    /**
+     * Find bindings by tag leveraging indexes
+     * @param tag - Tag name pattern or name/value pairs
+     */
+    findByTagIndex<ValueType = BoundValue>(tag: BindingTag | RegExp): Readonly<Binding<ValueType>>[];
+    close(): void;
+}