@loopback/core 4.0.0-alpha.9 → 4.0.2

package/dist/keys.js

@@ -0,0 +1,109 @@
+"use strict";
+// Copyright IBM Corp. and LoopBack contributors 2017,2020. All Rights Reserved.
+// Node module: @loopback/core
+// This file is licensed under the MIT License.
+// License text available at https://opensource.org/licenses/MIT
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CoreTags = exports.CoreBindings = void 0;
+const context_1 = require("@loopback/context");
+/**
+ * Namespace for core binding keys
+ */
+var CoreBindings;
+(function (CoreBindings) {
+    // application
+    /**
+     * Binding key for application instance itself
+     */
+    CoreBindings.APPLICATION_INSTANCE = context_1.BindingKey.create('application.instance');
+    /**
+     * Binding key for application configuration
+     */
+    CoreBindings.APPLICATION_CONFIG = context_1.BindingKey.create('application.config');
+    /**
+     * Binding key for the content of `package.json`
+     */
+    CoreBindings.APPLICATION_METADATA = context_1.BindingKey.create('application.metadata');
+    // server
+    /**
+     * Binding key for servers
+     */
+    CoreBindings.SERVERS = 'servers';
+    // component
+    /**
+     * Binding key for components
+     */
+    CoreBindings.COMPONENTS = 'components';
+    // controller
+    CoreBindings.CONTROLLERS = 'controllers';
+    /**
+     * Binding key for the controller class resolved in the current request
+     * context
+     */
+    CoreBindings.CONTROLLER_CLASS = context_1.BindingKey.create('controller.current.ctor');
+    /**
+     * Binding key for the controller method resolved in the current request
+     * context
+     */
+    CoreBindings.CONTROLLER_METHOD_NAME = context_1.BindingKey.create('controller.current.operation');
+    /**
+     * Binding key for the controller method metadata resolved in the current
+     * request context
+     */
+    CoreBindings.CONTROLLER_METHOD_META = 'controller.method.meta';
+    /**
+     * Binding key for the controller instance resolved in the current request
+     * context
+     */
+    CoreBindings.CONTROLLER_CURRENT = context_1.BindingKey.create('controller.current');
+    CoreBindings.LIFE_CYCLE_OBSERVERS = 'lifeCycleObservers';
+    /**
+     * Binding key for life cycle observer options
+     */
+    CoreBindings.LIFE_CYCLE_OBSERVER_REGISTRY = context_1.BindingKey.create('lifeCycleObserver.registry');
+    /**
+     * Binding key for life cycle observer options
+     */
+    CoreBindings.LIFE_CYCLE_OBSERVER_OPTIONS = context_1.BindingKey.create('lifeCycleObserver.options');
+})(CoreBindings = exports.CoreBindings || (exports.CoreBindings = {}));
+var CoreTags;
+(function (CoreTags) {
+    /**
+     * Binding tag for components
+     */
+    CoreTags.COMPONENT = 'component';
+    /**
+     * Binding tag for servers
+     */
+    CoreTags.SERVER = 'server';
+    /**
+     * Binding tag for controllers
+     */
+    CoreTags.CONTROLLER = 'controller';
+    /**
+     * Binding tag for services
+     */
+    CoreTags.SERVICE = 'service';
+    /**
+     * Binding tag for the service interface
+     */
+    CoreTags.SERVICE_INTERFACE = 'serviceInterface';
+    /**
+     * Binding tag for life cycle observers
+     */
+    CoreTags.LIFE_CYCLE_OBSERVER = 'lifeCycleObserver';
+    /**
+     * Binding tag for group name of life cycle observers
+     */
+    CoreTags.LIFE_CYCLE_OBSERVER_GROUP = 'lifeCycleObserverGroup';
+    /**
+     * Binding tag for extensions to specify name of the extension point that an
+     * extension contributes to.
+     */
+    CoreTags.EXTENSION_FOR = 'extensionFor';
+    /**
+     * Binding tag for an extension point to specify name of the extension point
+     */
+    CoreTags.EXTENSION_POINT = 'extensionPoint';
+})(CoreTags = exports.CoreTags || (exports.CoreTags = {}));
+//# sourceMappingURL=keys.js.map

package/dist/keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keys.js","sourceRoot":"","sources":["../src/keys.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,8BAA8B;AAC9B,+CAA+C;AAC/C,gEAAgE;;;AAEhE,+CAA6C;AAY7C;;GAEG;AACH,IAAiB,YAAY,CA4E5B;AA5ED,WAAiB,YAAY;IAC3B,cAAc;IACd;;OAEG;IACU,iCAAoB,GAAG,oBAAU,CAAC,MAAM,CACnD,sBAAsB,CACvB,CAAC;IAEF;;OAEG;IACU,+BAAkB,GAC7B,oBAAU,CAAC,MAAM,CAAoB,oBAAoB,CAAC,CAAC;IAE7D;;OAEG;IACU,iCAAoB,GAAG,oBAAU,CAAC,MAAM,CACnD,sBAAsB,CACvB,CAAC;IAEF,SAAS;IACT;;OAEG;IACU,oBAAO,GAAG,SAAS,CAAC;IAEjC,YAAY;IACZ;;OAEG;IACU,uBAAU,GAAG,YAAY,CAAC;IAEvC,aAAa;IACA,wBAAW,GAAG,aAAa,CAAC;IAEzC;;;OAGG;IACU,6BAAgB,GAC3B,oBAAU,CAAC,MAAM,CAAkB,yBAAyB,CAAC,CAAC;IAEhE;;;OAGG;IACU,mCAAsB,GAAG,oBAAU,CAAC,MAAM,CACrD,8BAA8B,CAC/B,CAAC;IAEF;;;OAGG;IACU,mCAAsB,GAAG,wBAAwB,CAAC;IAE/D;;;OAGG;IACU,+BAAkB,GAAG,oBAAU,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;IAE7D,iCAAoB,GAAG,oBAAoB,CAAC;IACzD;;OAEG;IACU,yCAA4B,GACvC,oBAAU,CAAC,MAAM,CAA4B,4BAA4B,CAAC,CAAC;IAE7E;;OAEG;IACU,wCAA2B,GACtC,oBAAU,CAAC,MAAM,CAA2B,2BAA2B,CAAC,CAAC;AAC7E,CAAC,EA5EgB,YAAY,GAAZ,oBAAY,KAAZ,oBAAY,QA4E5B;AAED,IAAiB,QAAQ,CA6CxB;AA7CD,WAAiB,QAAQ;IACvB;;OAEG;IACU,kBAAS,GAAG,WAAW,CAAC;IAErC;;OAEG;IACU,eAAM,GAAG,QAAQ,CAAC;IAE/B;;OAEG;IACU,mBAAU,GAAG,YAAY,CAAC;IAEvC;;OAEG;IACU,gBAAO,GAAG,SAAS,CAAC;IACjC;;OAEG;IACU,0BAAiB,GAAG,kBAAkB,CAAC;IAEpD;;OAEG;IACU,4BAAmB,GAAG,mBAAmB,CAAC;IAEvD;;OAEG;IACU,kCAAyB,GAAG,wBAAwB,CAAC;IAElE;;;OAGG;IACU,sBAAa,GAAG,cAAc,CAAC;IAE5C;;OAEG;IACU,wBAAe,GAAG,gBAAgB,CAAC;AAClD,CAAC,EA7CgB,QAAQ,GAAR,gBAAQ,KAAR,gBAAQ,QA6CxB"}

package/dist/lifecycle-registry.d.ts

@@ -0,0 +1,91 @@
+import { Binding, Context, ContextView } from '@loopback/context';
+import { LifeCycleObserver } from './lifecycle';
+/**
+ * A group of life cycle observers
+ */
+export declare type LifeCycleObserverGroup = {
+    /**
+     * Observer group name
+     */
+    group: string;
+    /**
+     * Bindings for observers within the group
+     */
+    bindings: Readonly<Binding<LifeCycleObserver>>[];
+};
+export declare type LifeCycleObserverOptions = {
+    /**
+     * Control the order of observer groups for notifications. For example,
+     * with `['datasource', 'server']`, the observers in `datasource` group are
+     * notified before those in `server` group during `start`. Please note that
+     * observers are notified in the reverse order during `stop`.
+     */
+    orderedGroups: string[];
+    /**
+     * Override and disable lifecycle observer groups. This setting applies to
+     * both ordered groups (i.e. those defined in `orderedGroups`) and unordered
+     * groups.
+     */
+    disabledGroups?: string[];
+    /**
+     * Notify observers of the same group in parallel, default to `true`
+     */
+    parallel?: boolean;
+};
+export declare const DEFAULT_ORDERED_GROUPS: string[];
+/**
+ * A context-based registry for life cycle observers
+ */
+export declare class LifeCycleObserverRegistry implements LifeCycleObserver {
+    protected readonly context: Context;
+    protected readonly observersView: ContextView<LifeCycleObserver>;
+    protected readonly options: LifeCycleObserverOptions;
+    constructor(context: Context, observersView: ContextView<LifeCycleObserver>, options?: LifeCycleObserverOptions);
+    setOrderedGroups(groups: string[]): void;
+    /**
+     * Get observer groups ordered by the group
+     */
+    getObserverGroupsByOrder(): LifeCycleObserverGroup[];
+    /**
+     * Get the group for a given life cycle observer binding
+     * @param binding - Life cycle observer binding
+     */
+    protected getObserverGroup(binding: Readonly<Binding<LifeCycleObserver>>): string;
+    /**
+     * Sort the life cycle observer bindings so that we can start/stop them
+     * in the right order. By default, we can start other observers before servers
+     * and stop them in the reverse order
+     * @param bindings - Life cycle observer bindings
+     */
+    protected sortObserverBindingsByGroup(bindings: Readonly<Binding<LifeCycleObserver>>[]): LifeCycleObserverGroup[];
+    /**
+     * Notify an observer group of the given event
+     * @param group - A group of bindings for life cycle observers
+     * @param event - Event name
+     */
+    protected notifyObservers(observers: LifeCycleObserver[], bindings: Readonly<Binding<LifeCycleObserver>>[], event: keyof LifeCycleObserver): Promise<void>;
+    /**
+     * Invoke an observer for the given event
+     * @param observer - A life cycle observer
+     * @param event - Event name
+     */
+    protected invokeObserver(observer: LifeCycleObserver, event: keyof LifeCycleObserver): Promise<void>;
+    /**
+     * Emit events to the observer groups
+     * @param events - Event names
+     * @param groups - Observer groups
+     */
+    protected notifyGroups(events: (keyof LifeCycleObserver)[], groups: LifeCycleObserverGroup[], reverse?: boolean): Promise<void>;
+    /**
+     * Notify all life cycle observers by group of `init`
+     */
+    init(): Promise<void>;
+    /**
+     * Notify all life cycle observers by group of `start`
+     */
+    start(): Promise<void>;
+    /**
+     * Notify all life cycle observers by group of `stop`
+     */
+    stop(): Promise<void>;
+}

package/dist/lifecycle-registry.js

@@ -0,0 +1,191 @@
+"use strict";
+// Copyright IBM Corp. and LoopBack contributors 2018,2020. All Rights Reserved.
+// Node module: @loopback/core
+// This file is licensed under the MIT License.
+// License text available at https://opensource.org/licenses/MIT
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LifeCycleObserverRegistry = exports.DEFAULT_ORDERED_GROUPS = void 0;
+const tslib_1 = require("tslib");
+const context_1 = require("@loopback/context");
+const debug_1 = tslib_1.__importDefault(require("debug"));
+const keys_1 = require("./keys");
+const lifecycle_1 = require("./lifecycle");
+const debug = (0, debug_1.default)('loopback:core:lifecycle');
+exports.DEFAULT_ORDERED_GROUPS = ['server'];
+/**
+ * A context-based registry for life cycle observers
+ */
+let LifeCycleObserverRegistry = class LifeCycleObserverRegistry {
+    constructor(context, observersView, options = {
+        parallel: true,
+        orderedGroups: exports.DEFAULT_ORDERED_GROUPS,
+    }) {
+        this.context = context;
+        this.observersView = observersView;
+        this.options = options;
+    }
+    setOrderedGroups(groups) {
+        this.options.orderedGroups = groups;
+    }
+    /**
+     * Get observer groups ordered by the group
+     */
+    getObserverGroupsByOrder() {
+        const bindings = this.observersView.bindings;
+        const groups = this.sortObserverBindingsByGroup(bindings);
+        if (debug.enabled) {
+            debug('Observer groups: %j', groups.map(g => ({
+                group: g.group,
+                bindings: g.bindings.map(b => b.key),
+            })));
+        }
+        return groups;
+    }
+    /**
+     * Get the group for a given life cycle observer binding
+     * @param binding - Life cycle observer binding
+     */
+    getObserverGroup(binding) {
+        // First check if there is an explicit group name in the tag
+        let group = binding.tagMap[keys_1.CoreTags.LIFE_CYCLE_OBSERVER_GROUP];
+        if (!group) {
+            // Fall back to a tag that matches one of the groups
+            group = this.options.orderedGroups.find(g => binding.tagMap[g] === g);
+        }
+        group = group || '';
+        debug('Binding %s is configured with observer group %s', binding.key, group);
+        return group;
+    }
+    /**
+     * Sort the life cycle observer bindings so that we can start/stop them
+     * in the right order. By default, we can start other observers before servers
+     * and stop them in the reverse order
+     * @param bindings - Life cycle observer bindings
+     */
+    sortObserverBindingsByGroup(bindings) {
+        // Group bindings in a map
+        const groupMap = new Map();
+        (0, context_1.sortBindingsByPhase)(bindings, keys_1.CoreTags.LIFE_CYCLE_OBSERVER_GROUP, this.options.orderedGroups);
+        for (const binding of bindings) {
+            const group = this.getObserverGroup(binding);
+            let bindingsInGroup = groupMap.get(group);
+            if (bindingsInGroup == null) {
+                bindingsInGroup = [];
+                groupMap.set(group, bindingsInGroup);
+            }
+            bindingsInGroup.push(binding);
+        }
+        // Create an array for group entries
+        const groups = [];
+        for (const [group, bindingsInGroup] of groupMap) {
+            groups.push({ group, bindings: bindingsInGroup });
+        }
+        return groups;
+    }
+    /**
+     * Notify an observer group of the given event
+     * @param group - A group of bindings for life cycle observers
+     * @param event - Event name
+     */
+    async notifyObservers(observers, bindings, event) {
+        if (!this.options.parallel) {
+            let index = 0;
+            for (const observer of observers) {
+                debug('Invoking %s observer for binding %s', event, bindings[index].key);
+                index++;
+                await this.invokeObserver(observer, event);
+            }
+            return;
+        }
+        // Parallel invocation
+        const notifiers = observers.map((observer, index) => {
+            debug('Invoking %s observer for binding %s', event, bindings[index].key);
+            return this.invokeObserver(observer, event);
+        });
+        await Promise.all(notifiers);
+    }
+    /**
+     * Invoke an observer for the given event
+     * @param observer - A life cycle observer
+     * @param event - Event name
+     */
+    async invokeObserver(observer, event) {
+        if (typeof observer[event] === 'function') {
+            // Supply `undefined` for legacy callback function expected by
+            // DataSource.stop()
+            await (0, context_1.invokeMethod)(observer, event, this.context, [undefined], {
+                skipInterceptors: true,
+            });
+        }
+    }
+    /**
+     * Emit events to the observer groups
+     * @param events - Event names
+     * @param groups - Observer groups
+     */
+    async notifyGroups(events, groups, reverse = false) {
+        var _a;
+        const observers = await this.observersView.values();
+        const bindings = this.observersView.bindings;
+        const found = observers.some(observer => events.some(e => typeof observer[e] === 'function'));
+        if (!found)
+            return;
+        if (reverse) {
+            // Do not reverse the original `groups` in place
+            groups = [...groups].reverse();
+        }
+        for (const group of groups) {
+            if ((_a = this.options.disabledGroups) === null || _a === void 0 ? void 0 : _a.includes(group.group)) {
+                debug('Notification skipped (Group is disabled): %s', group.group);
+                continue;
+            }
+            const observersForGroup = [];
+            const bindingsInGroup = reverse
+                ? group.bindings.reverse()
+                : group.bindings;
+            for (const binding of bindingsInGroup) {
+                const index = bindings.indexOf(binding);
+                observersForGroup.push(observers[index]);
+            }
+            for (const event of events) {
+                debug('Beginning notification %s of %s...', event);
+                await this.notifyObservers(observersForGroup, group.bindings, event);
+                debug('Finished notification %s of %s', event);
+            }
+        }
+    }
+    /**
+     * Notify all life cycle observers by group of `init`
+     */
+    async init() {
+        debug('Initializing the %s...');
+        const groups = this.getObserverGroupsByOrder();
+        await this.notifyGroups(['init'], groups);
+    }
+    /**
+     * Notify all life cycle observers by group of `start`
+     */
+    async start() {
+        debug('Starting the %s...');
+        const groups = this.getObserverGroupsByOrder();
+        await this.notifyGroups(['start'], groups);
+    }
+    /**
+     * Notify all life cycle observers by group of `stop`
+     */
+    async stop() {
+        debug('Stopping the %s...');
+        const groups = this.getObserverGroupsByOrder();
+        // Stop in the reverse order
+        await this.notifyGroups(['stop'], groups, true);
+    }
+};
+LifeCycleObserverRegistry = tslib_1.__decorate([
+    tslib_1.__param(0, context_1.inject.context()),
+    tslib_1.__param(1, context_1.inject.view(lifecycle_1.lifeCycleObserverFilter)),
+    tslib_1.__param(2, (0, context_1.inject)(keys_1.CoreBindings.LIFE_CYCLE_OBSERVER_OPTIONS, { optional: true })),
+    tslib_1.__metadata("design:paramtypes", [context_1.Context,
+        context_1.ContextView, Object])
+], LifeCycleObserverRegistry);
+exports.LifeCycleObserverRegistry = LifeCycleObserverRegistry;
+//# sourceMappingURL=lifecycle-registry.js.map

package/dist/lifecycle-registry.js.map

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

package/dist/lifecycle.d.ts

@@ -0,0 +1,47 @@
+import { Binding, BindingSpec, BindingTagFilter, Constructor, ValueOrPromise } from '@loopback/context';
+/**
+ * Observers to handle life cycle init/start/stop events
+ */
+export interface LifeCycleObserver {
+    /**
+     * The method to be invoked during `init`. It will only be called at most once
+     * for a given application instance.
+     */
+    init?(...injectedArgs: unknown[]): ValueOrPromise<void>;
+    /**
+     * The method to be invoked during `start`
+     */
+    start?(...injectedArgs: unknown[]): ValueOrPromise<void>;
+    /**
+     * The method to be invoked during `stop`
+     */
+    stop?(...injectedArgs: unknown[]): ValueOrPromise<void>;
+}
+/**
+ * Test if an object implements LifeCycleObserver
+ * @param obj - An object
+ */
+export declare function isLifeCycleObserver(obj: object): obj is LifeCycleObserver;
+/**
+ * Test if a class implements LifeCycleObserver
+ * @param ctor - A class
+ */
+export declare function isLifeCycleObserverClass(ctor: Constructor<unknown>): ctor is Constructor<LifeCycleObserver>;
+/**
+ * A `BindingTemplate` function to configure the binding as life cycle observer
+ * by tagging it with `CoreTags.LIFE_CYCLE_OBSERVER`.
+ *
+ * @param binding - Binding object
+ */
+export declare function asLifeCycleObserver<T = unknown>(binding: Binding<T>): Binding<T>;
+/**
+ * Find all life cycle observer bindings. By default, a binding tagged with
+ * `CoreTags.LIFE_CYCLE_OBSERVER`. It's used as `BindingFilter`.
+ */
+export declare const lifeCycleObserverFilter: BindingTagFilter;
+/**
+ * Sugar decorator to mark a class as life cycle observer
+ * @param group - Optional observer group name
+ * @param specs - Optional bindings specs
+ */
+export declare function lifeCycleObserver(group?: string, ...specs: BindingSpec[]): ClassDecorator;

package/dist/lifecycle.js

@@ -0,0 +1,56 @@
+"use strict";
+// Copyright IBM Corp. and LoopBack contributors 2018,2020. All Rights Reserved.
+// Node module: @loopback/core
+// This file is licensed under the MIT License.
+// License text available at https://opensource.org/licenses/MIT
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.lifeCycleObserver = exports.lifeCycleObserverFilter = exports.asLifeCycleObserver = exports.isLifeCycleObserverClass = exports.isLifeCycleObserver = void 0;
+const context_1 = require("@loopback/context");
+const keys_1 = require("./keys");
+const lifeCycleMethods = ['init', 'start', 'stop'];
+/**
+ * Test if an object implements LifeCycleObserver
+ * @param obj - An object
+ */
+function isLifeCycleObserver(obj) {
+    const candidate = obj;
+    return lifeCycleMethods.some(m => typeof candidate[m] === 'function');
+}
+exports.isLifeCycleObserver = isLifeCycleObserver;
+/**
+ * Test if a class implements LifeCycleObserver
+ * @param ctor - A class
+ */
+function isLifeCycleObserverClass(ctor) {
+    return ctor.prototype && isLifeCycleObserver(ctor.prototype);
+}
+exports.isLifeCycleObserverClass = isLifeCycleObserverClass;
+/**
+ * A `BindingTemplate` function to configure the binding as life cycle observer
+ * by tagging it with `CoreTags.LIFE_CYCLE_OBSERVER`.
+ *
+ * @param binding - Binding object
+ */
+function asLifeCycleObserver(binding) {
+    return binding.tag(keys_1.CoreTags.LIFE_CYCLE_OBSERVER);
+}
+exports.asLifeCycleObserver = asLifeCycleObserver;
+/**
+ * Find all life cycle observer bindings. By default, a binding tagged with
+ * `CoreTags.LIFE_CYCLE_OBSERVER`. It's used as `BindingFilter`.
+ */
+exports.lifeCycleObserverFilter = (0, context_1.filterByTag)(keys_1.CoreTags.LIFE_CYCLE_OBSERVER);
+/**
+ * Sugar decorator to mark a class as life cycle observer
+ * @param group - Optional observer group name
+ * @param specs - Optional bindings specs
+ */
+function lifeCycleObserver(group = '', ...specs) {
+    return (0, context_1.injectable)(asLifeCycleObserver, {
+        tags: {
+            [keys_1.CoreTags.LIFE_CYCLE_OBSERVER_GROUP]: group,
+        },
+    }, ...specs);
+}
+exports.lifeCycleObserver = lifeCycleObserver;
+//# sourceMappingURL=lifecycle.js.map

package/dist/lifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.js","sourceRoot":"","sources":["../src/lifecycle.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,8BAA8B;AAC9B,+CAA+C;AAC/C,gEAAgE;;;AAEhE,+CAQ2B;AAC3B,iCAAgC;AAqBhC,MAAM,gBAAgB,GAAgC,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;AAEhF;;;GAGG;AACH,SAAgB,mBAAmB,CAAC,GAAW;IAC7C,MAAM,SAAS,GAAG,GAAiC,CAAC;IACpD,OAAO,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,SAAS,CAAC,CAAC,CAAC,KAAK,UAAU,CAAC,CAAC;AACxE,CAAC;AAHD,kDAGC;AAED;;;GAGG;AACH,SAAgB,wBAAwB,CACtC,IAA0B;IAE1B,OAAO,IAAI,CAAC,SAAS,IAAI,mBAAmB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;AAC/D,CAAC;AAJD,4DAIC;AAED;;;;;GAKG;AACH,SAAgB,mBAAmB,CAAc,OAAmB;IAClE,OAAO,OAAO,CAAC,GAAG,CAAC,eAAQ,CAAC,mBAAmB,CAAC,CAAC;AACnD,CAAC;AAFD,kDAEC;AAED;;;GAGG;AACU,QAAA,uBAAuB,GAAqB,IAAA,qBAAW,EAClE,eAAQ,CAAC,mBAAmB,CAC7B,CAAC;AAEF;;;;GAIG;AACH,SAAgB,iBAAiB,CAAC,KAAK,GAAG,EAAE,EAAE,GAAG,KAAoB;IACnE,OAAO,IAAA,oBAAU,EACf,mBAAmB,EACnB;QACE,IAAI,EAAE;YACJ,CAAC,eAAQ,CAAC,yBAAyB,CAAC,EAAE,KAAK;SAC5C;KACF,EACD,GAAG,KAAK,CACT,CAAC;AACJ,CAAC;AAVD,8CAUC"}

package/dist/mixin-target.d.ts

@@ -0,0 +1,60 @@
+import { Constructor } from '@loopback/context';
+/**
+ * A replacement for `typeof Target` to be used in mixin class definitions.
+ * This is a workaround for TypeScript limitation described in
+ * - https://github.com/microsoft/TypeScript/issues/17293
+ * - https://github.com/microsoft/TypeScript/issues/17744
+ * - https://github.com/microsoft/TypeScript/issues/36060
+ *
+ * @example
+ *
+ * ```ts
+ * export function MyMixin<T extends MixinTarget<Application>>(superClass: T) {
+ *   return class extends superClass {
+ *     // contribute new class members
+ *   }
+ * };
+ * ```
+ *
+ * TypeScript does not allow class mixins to access protected members from
+ * the base class. You can use the following approach as a workaround:
+ *
+ * ```ts
+ * // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+ * // @ts-ignore
+ * (this as unknown as {YourBaseClass}).protectedMember
+ * ```
+ *
+ * The directive `@ts-ignore` suppresses compiler error about accessing
+ * a protected member from outside. Unfortunately, it also disables other
+ * compile-time checks (e.g. to verify that a protected method was invoked
+ * with correct arguments, and so on). This is the same behavior you
+ * would get by using `Constructor<any>` instead of `MixinTarget<Application>`.
+ * The major improvement is that TypeScript can still infer the return
+ * type of the protected member, therefore `any` is NOT introduced to subsequent
+ * code.
+ *
+ * TypeScript also does not allow mixin class to overwrite a method inherited
+ * from a mapped type, see https://github.com/microsoft/TypeScript/issues/38496
+ * As a workaround, use `@ts-ignore` to disable the error.
+ *
+ * ```ts
+ * export function RepositoryMixin<T extends MixinTarget<Application>>(
+ * superClass: T,
+ * ) {
+ *   return class extends superClass {
+ *    // @ts-ignore
+ *    public component<C extends Component = Component>(
+ *      componentCtor: Constructor<C>,
+ *      nameOrOptions?: string | BindingFromClassOptions,
+ *    ) {
+ *      const binding = super.component(componentCtor, nameOrOptions);
+ *      // ...
+ *      return binding;
+ *    }
+ * }
+ * ```
+ */
+export declare type MixinTarget<T extends object> = Constructor<{
+    [P in keyof T]: T[P];
+}>;

package/{lib6/internal-types.js → dist/mixin-target.js}

@@ -1,8 +1,7 @@
 "use strict";
-// Copyright IBM Corp. 2017. All Rights Reserved.
+// Copyright IBM Corp. and LoopBack contributors 2020. All Rights Reserved.
 // Node module: @loopback/core
 // This file is licensed under the MIT License.
 // License text available at https://opensource.org/licenses/MIT
 Object.defineProperty(exports, "__esModule", { value: true });
-// tslint:enable:no-any
-//# sourceMappingURL=internal-types.js.map
+//# sourceMappingURL=mixin-target.js.map

package/dist/mixin-target.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mixin-target.js","sourceRoot":"","sources":["../src/mixin-target.ts"],"names":[],"mappings":";AAAA,2EAA2E;AAC3E,8BAA8B;AAC9B,+CAA+C;AAC/C,gEAAgE"}

package/dist/server.d.ts

@@ -0,0 +1,16 @@
+import { LifeCycleObserver } from './lifecycle';
+/**
+ * Defines the requirements to implement a Server for LoopBack applications:
+ * start() : Promise<void>
+ * stop() : Promise<void>
+ * It is recommended that each Server implementation creates its own child
+ * Context, which inherits from the parent Application context. This way,
+ * any Server-specific bindings will remain local to the Server instance,
+ * and will avoid polluting its parent module scope.
+ */
+export interface Server extends LifeCycleObserver {
+    /**
+     * Tells whether the server is listening for connections or not
+     */
+    readonly listening: boolean;
+}

package/{lib6/component.js → dist/server.js}

@@ -1,7 +1,7 @@
 "use strict";
-// Copyright IBM Corp. 2017. All Rights Reserved.
+// Copyright IBM Corp. and LoopBack contributors 2017,2020. All Rights Reserved.
 // Node module: @loopback/core
 // This file is licensed under the MIT License.
 // License text available at https://opensource.org/licenses/MIT
 Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=component.js.map
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,8BAA8B;AAC9B,+CAA+C;AAC/C,gEAAgE"}