@loopback/context 1.23.5 → 2.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (80) hide show
  1. package/CHANGELOG.md +81 -0
  2. package/dist/binding-config.js +1 -1
  3. package/dist/binding-config.js.map +1 -1
  4. package/dist/binding-filter.d.ts +19 -1
  5. package/dist/binding-filter.js +40 -7
  6. package/dist/binding-filter.js.map +1 -1
  7. package/dist/binding-inspector.js +12 -11
  8. package/dist/binding-inspector.js.map +1 -1
  9. package/dist/binding-sorter.js +2 -2
  10. package/dist/binding-sorter.js.map +1 -1
  11. package/dist/binding.d.ts +42 -4
  12. package/dist/binding.js +40 -10
  13. package/dist/binding.js.map +1 -1
  14. package/dist/context-event.d.ts +23 -0
  15. package/dist/context-event.js +7 -0
  16. package/dist/context-event.js.map +1 -0
  17. package/dist/context-observer.d.ts +1 -36
  18. package/dist/context-subscription.d.ts +147 -0
  19. package/dist/context-subscription.js +336 -0
  20. package/dist/context-subscription.js.map +1 -0
  21. package/dist/context-tag-indexer.d.ts +42 -0
  22. package/dist/context-tag-indexer.js +134 -0
  23. package/dist/context-tag-indexer.js.map +1 -0
  24. package/dist/context-view.d.ts +2 -1
  25. package/dist/context-view.js +5 -2
  26. package/dist/context-view.js.map +1 -1
  27. package/dist/context.d.ts +35 -66
  28. package/dist/context.js +78 -250
  29. package/dist/context.js.map +1 -1
  30. package/dist/index.d.ts +5 -3
  31. package/dist/index.js +4 -3
  32. package/dist/index.js.map +1 -1
  33. package/dist/inject-config.js +3 -3
  34. package/dist/inject-config.js.map +1 -1
  35. package/dist/inject.d.ts +2 -2
  36. package/dist/inject.js +18 -11
  37. package/dist/inject.js.map +1 -1
  38. package/dist/interception-proxy.d.ts +15 -3
  39. package/dist/interception-proxy.js +20 -4
  40. package/dist/interception-proxy.js.map +1 -1
  41. package/dist/interceptor-chain.js +5 -2
  42. package/dist/interceptor-chain.js.map +1 -1
  43. package/dist/interceptor.d.ts +6 -0
  44. package/dist/interceptor.js +38 -12
  45. package/dist/interceptor.js.map +1 -1
  46. package/dist/invocation.d.ts +20 -2
  47. package/dist/invocation.js +14 -12
  48. package/dist/invocation.js.map +1 -1
  49. package/dist/keys.d.ts +6 -0
  50. package/dist/keys.js +6 -0
  51. package/dist/keys.js.map +1 -1
  52. package/dist/resolution-session.d.ts +1 -0
  53. package/dist/resolution-session.js +13 -6
  54. package/dist/resolution-session.js.map +1 -1
  55. package/dist/resolver.js +13 -8
  56. package/dist/resolver.js.map +1 -1
  57. package/dist/value-promise.d.ts +1 -3
  58. package/package.json +9 -9
  59. package/src/binding-config.ts +1 -1
  60. package/src/binding-filter.ts +61 -9
  61. package/src/binding-inspector.ts +6 -8
  62. package/src/binding-sorter.ts +2 -2
  63. package/src/binding.ts +73 -9
  64. package/src/context-event.ts +30 -0
  65. package/src/context-observer.ts +1 -38
  66. package/src/context-subscription.ts +403 -0
  67. package/src/context-tag-indexer.ts +149 -0
  68. package/src/context-view.ts +3 -6
  69. package/src/context.ts +94 -293
  70. package/src/index.ts +5 -3
  71. package/src/inject-config.ts +3 -3
  72. package/src/inject.ts +19 -10
  73. package/src/interception-proxy.ts +25 -3
  74. package/src/interceptor-chain.ts +1 -1
  75. package/src/interceptor.ts +34 -8
  76. package/src/invocation.ts +26 -7
  77. package/src/keys.ts +7 -0
  78. package/src/resolution-session.ts +9 -5
  79. package/src/resolver.ts +5 -5
  80. package/src/value-promise.ts +1 -1
@@ -0,0 +1,134 @@
1
+ "use strict";
2
+ // Copyright IBM Corp. 2020. All Rights Reserved.
3
+ // Node module: @loopback/context
4
+ // This file is licensed under the MIT License.
5
+ // License text available at https://opensource.org/licenses/MIT
6
+ Object.defineProperty(exports, "__esModule", { value: true });
7
+ const binding_filter_1 = require("./binding-filter");
8
+ /**
9
+ * Indexer for context bindings by tag
10
+ */
11
+ class ContextTagIndexer {
12
+ constructor(context) {
13
+ this.context = context;
14
+ /**
15
+ * Index for bindings by tag names
16
+ */
17
+ this.bindingsIndexedByTag = new Map();
18
+ this.setupTagIndexForBindings();
19
+ }
20
+ /**
21
+ * Set up context/binding listeners and refresh index for bindings by tag
22
+ */
23
+ setupTagIndexForBindings() {
24
+ this.bindingEventListener = ({ binding, operation }) => {
25
+ if (operation === 'tag') {
26
+ this.updateTagIndexForBinding(binding);
27
+ }
28
+ };
29
+ this.tagIndexListener = event => {
30
+ const { binding, type } = event;
31
+ if (event.context !== this.context)
32
+ return;
33
+ if (type === 'bind') {
34
+ this.updateTagIndexForBinding(binding);
35
+ binding.on('changed', this.bindingEventListener);
36
+ }
37
+ else if (type === 'unbind') {
38
+ this.removeTagIndexForBinding(binding);
39
+ binding.removeListener('changed', this.bindingEventListener);
40
+ }
41
+ };
42
+ this.context.on('bind', this.tagIndexListener);
43
+ this.context.on('unbind', this.tagIndexListener);
44
+ }
45
+ /**
46
+ * Remove tag index for the given binding
47
+ * @param binding - Binding object
48
+ */
49
+ removeTagIndexForBinding(binding) {
50
+ for (const [, bindings] of this.bindingsIndexedByTag) {
51
+ bindings.delete(binding);
52
+ }
53
+ }
54
+ /**
55
+ * Update tag index for the given binding
56
+ * @param binding - Binding object
57
+ */
58
+ updateTagIndexForBinding(binding) {
59
+ this.removeTagIndexForBinding(binding);
60
+ for (const tag of binding.tagNames) {
61
+ let bindings = this.bindingsIndexedByTag.get(tag);
62
+ if (bindings == null) {
63
+ bindings = new Set();
64
+ this.bindingsIndexedByTag.set(tag, bindings);
65
+ }
66
+ bindings.add(binding);
67
+ }
68
+ }
69
+ /**
70
+ * Find bindings by tag leveraging indexes
71
+ * @param tag - Tag name pattern or name/value pairs
72
+ */
73
+ findByTagIndex(tag) {
74
+ let tagNames;
75
+ // A flag to control if a union of matched bindings should be created
76
+ let union = false;
77
+ if (tag instanceof RegExp) {
78
+ // For wildcard/regexp, a union of matched bindings is desired
79
+ union = true;
80
+ // Find all matching tag names
81
+ tagNames = [];
82
+ for (const t of this.bindingsIndexedByTag.keys()) {
83
+ if (tag.test(t)) {
84
+ tagNames.push(t);
85
+ }
86
+ }
87
+ }
88
+ else if (typeof tag === 'string') {
89
+ tagNames = [tag];
90
+ }
91
+ else {
92
+ tagNames = Object.keys(tag);
93
+ }
94
+ let filter;
95
+ let bindings;
96
+ for (const t of tagNames) {
97
+ const bindingsByTag = this.bindingsIndexedByTag.get(t);
98
+ if (bindingsByTag == null)
99
+ break; // One of the tags is not found
100
+ filter = (filter !== null && filter !== void 0 ? filter : binding_filter_1.filterByTag(tag));
101
+ const matched = new Set(Array.from(bindingsByTag).filter(filter));
102
+ if (!union && matched.size === 0)
103
+ break; // One of the tag name/value is not found
104
+ if (bindings == null) {
105
+ // First set of bindings matching the tag
106
+ bindings = matched;
107
+ }
108
+ else {
109
+ if (union) {
110
+ matched.forEach(b => { var _a; return (_a = bindings) === null || _a === void 0 ? void 0 : _a.add(b); });
111
+ }
112
+ else {
113
+ // Now need to find intersected bindings against visited tags
114
+ const intersection = new Set();
115
+ bindings.forEach(b => {
116
+ if (matched.has(b)) {
117
+ intersection.add(b);
118
+ }
119
+ });
120
+ bindings = intersection;
121
+ }
122
+ if (!union && bindings.size === 0)
123
+ break;
124
+ }
125
+ }
126
+ return bindings == null ? [] : Array.from(bindings);
127
+ }
128
+ close() {
129
+ this.context.removeListener('bind', this.tagIndexListener);
130
+ this.context.removeListener('unbind', this.tagIndexListener);
131
+ }
132
+ }
133
+ exports.ContextTagIndexer = ContextTagIndexer;
134
+ //# sourceMappingURL=context-tag-indexer.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"context-tag-indexer.js","sourceRoot":"","sources":["../src/context-tag-indexer.ts"],"names":[],"mappings":"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"}
@@ -4,7 +4,8 @@ import { Binding } from './binding';
4
4
  import { BindingFilter } from './binding-filter';
5
5
  import { BindingComparator } from './binding-sorter';
6
6
  import { Context } from './context';
7
- import { ContextEventType, ContextObserver, Subscription } from './context-observer';
7
+ import { ContextEventType, ContextObserver } from './context-observer';
8
+ import { Subscription } from './context-subscription';
8
9
  import { Getter } from './inject';
9
10
  import { ResolutionSession } from './resolution-session';
10
11
  import { ValueOrPromise } from './value-promise';
@@ -3,13 +3,16 @@
3
3
  // Node module: @loopback/context
4
4
  // This file is licensed under the MIT License.
5
5
  // License text available at https://opensource.org/licenses/MIT
6
+ var __importDefault = (this && this.__importDefault) || function (mod) {
7
+ return (mod && mod.__esModule) ? mod : { "default": mod };
8
+ };
6
9
  Object.defineProperty(exports, "__esModule", { value: true });
7
- const debugFactory = require("debug");
10
+ const debug_1 = __importDefault(require("debug"));
8
11
  const events_1 = require("events");
9
12
  const util_1 = require("util");
10
13
  const resolution_session_1 = require("./resolution-session");
11
14
  const value_promise_1 = require("./value-promise");
12
- const debug = debugFactory('loopback:context:view');
15
+ const debug = debug_1.default('loopback:context:view');
13
16
  const nextTick = util_1.promisify(process.nextTick);
14
17
  /**
15
18
  * `ContextView` provides a view for a given context chain to maintain a live
@@ -1 +1 @@
1
- {"version":3,"file":"context-view.js","sourceRoot":"","sources":["../src/context-view.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"context-view.js","sourceRoot":"","sources":["../src/context-view.ts"],"names":[],"mappings":"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"}
package/dist/context.d.ts CHANGED
@@ -5,7 +5,10 @@ import { ConfigurationResolver } from './binding-config';
5
5
  import { BindingFilter } from './binding-filter';
6
6
  import { BindingAddress } from './binding-key';
7
7
  import { BindingComparator } from './binding-sorter';
8
- import { ContextEventObserver, ContextEventType, ContextObserver, Subscription } from './context-observer';
8
+ import { ContextEvent } from './context-event';
9
+ import { ContextEventObserver, ContextObserver } from './context-observer';
10
+ import { ContextSubscriptionManager, Subscription } from './context-subscription';
11
+ import { ContextTagIndexer } from './context-tag-indexer';
9
12
  import { ContextView } from './context-view';
10
13
  import { ResolutionOptions, ResolutionOptionsOrSession, ResolutionSession } from './resolution-session';
11
14
  import { BoundValue, ValueOrPromise } from './value-promise';
@@ -22,30 +25,21 @@ export declare class Context extends EventEmitter {
22
25
  */
23
26
  protected readonly registry: Map<string, Binding>;
24
27
  /**
25
- * Parent context
26
- */
27
- protected _parent?: Context;
28
- protected configResolver: ConfigurationResolver;
29
- /**
30
- * Event listeners for parent context keyed by event names. It keeps track
31
- * of listeners from this context against its parent so that we can remove
32
- * these listeners when this context is closed.
28
+ * Indexer for bindings by tag
33
29
  */
34
- protected _parentEventListeners: Map<string, (...args: any[]) => void> | undefined;
30
+ protected readonly tagIndexer: ContextTagIndexer;
35
31
  /**
36
- * A list of registered context observers. The Set will be created when the
37
- * first observer is added.
32
+ * Manager for observer subscriptions
38
33
  */
39
- protected observers: Set<ContextEventObserver> | undefined;
34
+ readonly subscriptionManager: ContextSubscriptionManager;
40
35
  /**
41
- * Internal counter for pending notification events which are yet to be
42
- * processed by observers.
36
+ * Parent context
43
37
  */
44
- private pendingNotifications;
38
+ protected _parent?: Context;
45
39
  /**
46
- * Queue for background notifications for observers
40
+ * Configuration resolver
47
41
  */
48
- private notificationQueue;
42
+ protected configResolver: ConfigurationResolver;
49
43
  /**
50
44
  * Create a new context.
51
45
  *
@@ -69,6 +63,11 @@ export declare class Context extends EventEmitter {
69
63
  * generated as the name
70
64
  */
71
65
  constructor(_parent?: Context | string, name?: string);
66
+ /**
67
+ * @internal
68
+ * Getter for ContextSubscriptionManager
69
+ */
70
+ get parent(): Context | undefined;
72
71
  /**
73
72
  * Wrap the debug statement so that it always print out the context name
74
73
  * as the prefix
@@ -76,44 +75,16 @@ export declare class Context extends EventEmitter {
76
75
  */
77
76
  private _debug;
78
77
  /**
79
- * Set up an internal listener to notify registered observers asynchronously
80
- * upon `bind` and `unbind` events. This method will be called lazily when
81
- * the first observer is added.
82
- */
83
- private setupEventHandlersIfNeeded;
84
- /**
85
- * Add an event listener to its parent context so that this context will
86
- * be notified of parent events, such as `bind` or `unbind`.
87
- * @param event - Event name
88
- */
89
- private addParentEventListener;
90
- /**
91
- * Handle errors caught during the notification of observers
92
- * @param err - Error
78
+ * A strongly-typed method to emit context events
79
+ * @param type Event type
80
+ * @param event Context event
93
81
  */
94
- private handleNotificationError;
82
+ emitEvent<T extends ContextEvent>(type: string, event: T): void;
95
83
  /**
96
- * Start a background task to listen on context events and notify observers
84
+ * Emit an `error` event
85
+ * @param err Error
97
86
  */
98
- private startNotificationTask;
99
- /**
100
- * Process notification events as they arrive on the queue
101
- */
102
- private processNotifications;
103
- /**
104
- * Listen on given event types and emit `notification` event. This method
105
- * merge multiple event types into one for notification.
106
- * @param eventTypes - Context event types
107
- */
108
- private setupNotification;
109
- /**
110
- * Wait until observers are notified for all of currently pending notification
111
- * events.
112
- *
113
- * This method is for test only to perform assertions after observers are
114
- * notified for relevant events.
115
- */
116
- protected waitUntilPendingNotificationsDone(timeout?: number): Promise<void>;
87
+ emitError(err: unknown): void;
117
88
  /**
118
89
  * Create a binding with the given key in the context. If a locked binding
119
90
  * already exists with the same key, an error will be thrown.
@@ -220,18 +191,6 @@ export declare class Context extends EventEmitter {
220
191
  * @param comparator - A function to sort matched bindings
221
192
  */
222
193
  createView<T = unknown>(filter: BindingFilter, comparator?: BindingComparator): ContextView<T>;
223
- /**
224
- * Publish an event to the registered observers. Please note the
225
- * notification is queued and performed asynchronously so that we allow fluent
226
- * APIs such as `ctx.bind('key').to(...).tag(...);` and give observers the
227
- * fully populated binding.
228
- *
229
- * @param eventType - Event names: `bind` or `unbind`
230
- * @param binding - Binding bound or unbound
231
- * @param context - Owner context
232
- * @param observers - Current set of context observers
233
- */
234
- protected notifyObservers(eventType: ContextEventType, binding: Readonly<Binding<unknown>>, context: Context, observers?: Set<ContextEventObserver> | undefined): Promise<void>;
235
194
  /**
236
195
  * Check if a binding exists with the given key in the local context without
237
196
  * delegating to the parent context
@@ -278,6 +237,11 @@ export declare class Context extends EventEmitter {
278
237
  * `{name: 'my-controller'}`
279
238
  */
280
239
  findByTag<ValueType = BoundValue>(tagFilter: BindingTag | RegExp): Readonly<Binding<ValueType>>[];
240
+ /**
241
+ * Find bindings by tag leveraging indexes
242
+ * @param tag - Tag name pattern or name/value pairs
243
+ */
244
+ protected _findByTagIndex<ValueType = BoundValue>(tag: BindingTag | RegExp): Readonly<Binding<ValueType>>[];
281
245
  protected _mergeWithParent<ValueType>(childList: Readonly<Binding<ValueType>>[], parentList?: Readonly<Binding<ValueType>>[]): Readonly<Binding<ValueType>>[];
282
246
  /**
283
247
  * Get the value bound to the given key, throw an error when no value is
@@ -430,7 +394,12 @@ export declare class Context extends EventEmitter {
430
394
  /**
431
395
  * Create a plain JSON object for the context
432
396
  */
433
- toJSON(): Object;
397
+ toJSON(): object;
398
+ /**
399
+ * Inspect the context and dump out a JSON object representing the context
400
+ * hierarchy
401
+ */
402
+ inspect(): object;
434
403
  }
435
404
  /**
436
405
  * Policy to control if a binding should be created for the context