@venizia/ignis-inversion 0.2.0-9 → 0.2.1-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 (91) hide show
  1. package/LICENSE.md +0 -1
  2. package/README.md +83 -117
  3. package/dist/cjs/common/utilities.d.ts +31 -3
  4. package/dist/cjs/common/utilities.d.ts.map +1 -1
  5. package/dist/cjs/common/utilities.js +61 -5
  6. package/dist/cjs/common/utilities.js.map +1 -1
  7. package/dist/cjs/modules/binding/binding.d.ts +3 -0
  8. package/dist/cjs/modules/binding/binding.d.ts.map +1 -1
  9. package/dist/cjs/modules/binding/binding.js +8 -6
  10. package/dist/cjs/modules/binding/binding.js.map +1 -1
  11. package/dist/cjs/modules/binding/common/constants.d.ts.map +1 -1
  12. package/dist/cjs/modules/binding/common/constants.js +2 -6
  13. package/dist/cjs/modules/binding/common/constants.js.map +1 -1
  14. package/dist/cjs/modules/container/base.d.ts +25 -0
  15. package/dist/cjs/modules/container/base.d.ts.map +1 -1
  16. package/dist/cjs/modules/container/base.js +84 -26
  17. package/dist/cjs/modules/container/base.js.map +1 -1
  18. package/dist/cjs/modules/container/container.d.ts +9 -2
  19. package/dist/cjs/modules/container/container.d.ts.map +1 -1
  20. package/dist/cjs/modules/container/container.js +21 -11
  21. package/dist/cjs/modules/container/container.js.map +1 -1
  22. package/dist/cjs/modules/error/app-error.js +2 -5
  23. package/dist/cjs/modules/error/app-error.js.map +1 -1
  24. package/dist/cjs/modules/registry/registry.d.ts.map +1 -1
  25. package/dist/cjs/modules/registry/registry.js +7 -3
  26. package/dist/cjs/modules/registry/registry.js.map +1 -1
  27. package/dist/esm/common/index.d.ts +4 -4
  28. package/dist/esm/common/index.js +4 -4
  29. package/dist/esm/common/utilities.d.ts +32 -4
  30. package/dist/esm/common/utilities.d.ts.map +1 -1
  31. package/dist/esm/common/utilities.js +58 -4
  32. package/dist/esm/common/utilities.js.map +1 -1
  33. package/dist/esm/index.d.ts +2 -2
  34. package/dist/esm/index.js +4 -4
  35. package/dist/esm/modules/binding/binding.d.ts +8 -5
  36. package/dist/esm/modules/binding/binding.d.ts.map +1 -1
  37. package/dist/esm/modules/binding/binding.js +12 -10
  38. package/dist/esm/modules/binding/binding.js.map +1 -1
  39. package/dist/esm/modules/binding/common/constants.d.ts +1 -1
  40. package/dist/esm/modules/binding/common/constants.d.ts.map +1 -1
  41. package/dist/esm/modules/binding/common/constants.js +3 -4
  42. package/dist/esm/modules/binding/common/constants.js.map +1 -1
  43. package/dist/esm/modules/binding/common/index.d.ts +2 -2
  44. package/dist/esm/modules/binding/common/index.js +2 -2
  45. package/dist/esm/modules/binding/common/types.d.ts +3 -3
  46. package/dist/esm/modules/binding/index.d.ts +2 -2
  47. package/dist/esm/modules/binding/index.js +2 -2
  48. package/dist/esm/modules/container/abstract.d.ts +5 -5
  49. package/dist/esm/modules/container/abstract.js +1 -1
  50. package/dist/esm/modules/container/base.d.ts +29 -4
  51. package/dist/esm/modules/container/base.d.ts.map +1 -1
  52. package/dist/esm/modules/container/base.js +89 -31
  53. package/dist/esm/modules/container/base.js.map +1 -1
  54. package/dist/esm/modules/container/common/index.d.ts +1 -1
  55. package/dist/esm/modules/container/common/index.js +1 -1
  56. package/dist/esm/modules/container/common/types.d.ts +3 -3
  57. package/dist/esm/modules/container/container.d.ts +11 -4
  58. package/dist/esm/modules/container/container.d.ts.map +1 -1
  59. package/dist/esm/modules/container/container.js +24 -14
  60. package/dist/esm/modules/container/container.js.map +1 -1
  61. package/dist/esm/modules/container/index.d.ts +4 -4
  62. package/dist/esm/modules/container/index.js +4 -4
  63. package/dist/esm/modules/error/app-error.d.ts +1 -1
  64. package/dist/esm/modules/error/app-error.js +3 -3
  65. package/dist/esm/modules/error/app-error.js.map +1 -1
  66. package/dist/esm/modules/error/common/index.d.ts +1 -1
  67. package/dist/esm/modules/error/common/index.js +1 -1
  68. package/dist/esm/modules/error/common/types.d.ts +1 -1
  69. package/dist/esm/modules/error/definition.d.ts +1 -1
  70. package/dist/esm/modules/error/index.d.ts +4 -4
  71. package/dist/esm/modules/error/index.js +4 -4
  72. package/dist/esm/modules/error/message-code.d.ts +2 -2
  73. package/dist/esm/modules/index.d.ts +5 -5
  74. package/dist/esm/modules/index.js +5 -5
  75. package/dist/esm/modules/metadata/common/index.d.ts +1 -1
  76. package/dist/esm/modules/metadata/common/index.js +1 -1
  77. package/dist/esm/modules/metadata/index.d.ts +2 -2
  78. package/dist/esm/modules/metadata/index.js +2 -2
  79. package/dist/esm/modules/metadata/injectors.d.ts +2 -2
  80. package/dist/esm/modules/metadata/injectors.js +2 -2
  81. package/dist/esm/modules/registry/common/index.d.ts +1 -1
  82. package/dist/esm/modules/registry/common/index.js +1 -1
  83. package/dist/esm/modules/registry/common/types.d.ts +1 -1
  84. package/dist/esm/modules/registry/index.d.ts +2 -2
  85. package/dist/esm/modules/registry/index.js +2 -2
  86. package/dist/esm/modules/registry/registry.d.ts +3 -3
  87. package/dist/esm/modules/registry/registry.d.ts.map +1 -1
  88. package/dist/esm/modules/registry/registry.js +10 -6
  89. package/dist/esm/modules/registry/registry.js.map +1 -1
  90. package/dist/esm/package.json +6 -0
  91. package/package.json +3 -5
package/LICENSE.md CHANGED
@@ -72,7 +72,6 @@ Ignis uses the following open-source libraries. We are grateful to the authors a
72
72
 
73
73
  | Library | License | Description |
74
74
  |---------|---------|-------------|
75
- | [Lodash](https://github.com/lodash/lodash) | MIT | Utility library |
76
75
  | [reflect-metadata](https://github.com/rbuckton/reflect-metadata) | Apache-2.0 | Metadata reflection API |
77
76
 
78
77
  ### Documentation Dependencies
package/README.md CHANGED
@@ -1,47 +1,23 @@
1
- <div align="center">
1
+ # @venizia/ignis-inversion
2
2
 
3
- <br />
4
-
5
- # :fire: @venizia/ignis-inversion
6
-
7
- **A small IoC container that works anywhere.**
8
-
9
- [![Docs](https://img.shields.io/badge/Docs-ignis.venizia.ai-2563EB.svg?style=flat-square)](https://ignis.venizia.ai/references/base/dependency-injection)
10
- [![npm](https://img.shields.io/npm/v/@venizia/ignis-inversion.svg?style=flat-square&color=cb3837&label=@venizia/ignis-inversion)](https://www.npmjs.com/package/@venizia/ignis-inversion)
11
- [![License: MIT](https://img.shields.io/badge/License-MIT-3DA639.svg?style=flat-square)](https://opensource.org/licenses/MIT)
12
- [![TypeScript](https://img.shields.io/badge/TypeScript-6.x-3178C6.svg?style=flat-square&logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
13
-
14
- [Documentation](https://ignis.venizia.ai/references/base/dependency-injection) &#8226;
15
- [Core API](https://ignis.venizia.ai/references/) &#8226;
16
- [Changelog](https://ignis.venizia.ai/changelogs/)
17
-
18
- </div>
19
-
20
- ---
21
-
22
- The dependency injection container behind [IGNIS](https://ignis.venizia.ai) - decorator-driven
23
- constructor and property injection, a fluent binding API, singleton/transient scopes, and tag-based
24
- discovery, in roughly 350 lines.
25
-
26
- It has no framework dependency. Reach for it when you want LoopBack 4-style DI without adopting a
27
- framework, and it is small enough to ship into a browser bundle. IGNIS itself uses nothing more than
28
- what is documented here.
3
+ The dependency injection container under IGNIS, and the error type every IGNIS package throws. It
4
+ depends on no other IGNIS package, so you can install it alone to get LoopBack 4-style bindings
5
+ without the framework.
29
6
 
30
7
  ## Install
31
8
 
32
9
  ```bash
33
- bun add @venizia/ignis-inversion reflect-metadata
10
+ bun add @venizia/ignis-inversion
34
11
  ```
35
12
 
36
- > [!IMPORTANT]
37
- > `experimentalDecorators` and `emitDecoratorMetadata` must be `true` in your `tsconfig.json`,
38
- > declared **inline**. Bun does not resolve them through `extends`, and `@inject` is silently
39
- > dropped without them.
13
+ `reflect-metadata` comes as a dependency, and the package entry imports it. Your `tsconfig.json`
14
+ must declare `experimentalDecorators: true` itself (see [Decorators](#decorators)).
40
15
 
41
- ## Usage
16
+ ## Use it
17
+
18
+ Bind values and classes under string keys, then ask the container for a key.
42
19
 
43
20
  ```typescript
44
- import 'reflect-metadata';
45
21
  import { BindingScopes, Container, inject } from '@venizia/ignis-inversion';
46
22
 
47
23
  class GreetingService {
@@ -55,7 +31,7 @@ class GreetingService {
55
31
  }
56
32
  }
57
33
 
58
- const container = new Container({ scope: 'app' });
34
+ const container = new Container();
59
35
 
60
36
  container.bind({ key: 'config.prefix' }).toValue('Hello');
61
37
  container
@@ -66,119 +42,109 @@ container
66
42
  const service = container.get<GreetingService>({ key: 'services.GreetingService' });
67
43
  console.log(service.greet('IGNIS')); // Hello IGNIS (en)
68
44
 
69
- // A key's first segment becomes a tag, so bindings are discoverable as a group.
70
- container.findByTag({ tag: 'services' }); // [Binding('services.GreetingService')]
45
+ // The first segment of a dotted key becomes a tag.
46
+ container.findByTag({ tag: 'services' }); // [the 'services.GreetingService' binding]
71
47
  ```
72
48
 
73
- ## API
49
+ Notice that `config.locale` is never bound. `isOptional: true` makes it resolve to `undefined`
50
+ instead of throwing.
74
51
 
75
- Every method takes an options object - `container.get({ key })`, never `container.get(key)`.
52
+ ## API
76
53
 
77
- ### Container
54
+ Every method takes an options object: `container.get({ key })`, never `container.get(key)`.
78
55
 
79
- | Member | What it does |
56
+ | Container member | What it does |
80
57
  | :--- | :--- |
81
- | `new Container({ scope })` | The default container. `AbstractContainer` (contract) and `BaseContainer` (storage) are exported for custom implementations |
82
58
  | `bind<T>({ key })` | Creates and registers a `Binding`, returned for chaining |
83
- | `get<T>({ key, isOptional })` | Resolves a value. Throws when unbound unless `isOptional` is true |
84
- | `gets<T>({ bindings })` | Resolves several keys at once; every result is optional |
85
- | `getBinding<T>({ key })` | The binding itself, not its value. Accepts `{ namespace, key }` too |
86
- | `isBound({ key })` / `unbind({ key })` | Membership test / removal |
87
- | `set({ binding })` | Registers an externally constructed `Binding` under its own key |
88
- | `instantiate<T>(cls)` | Builds a class from its decorator metadata - `resolve(cls)` is an alias |
89
- | `findByTag({ tag, exclude })` | All bindings carrying a tag. `exclude` takes an array or a `Set` of keys |
90
- | `clear()` / `reset()` | Drops cached singleton instances / drops all bindings |
91
-
92
- ### Binding
93
-
94
- | Member | What it does |
59
+ | `get<T>({ key, isOptional })` | Resolves a key. Throws when the key is unbound, unless `isOptional` is `true`. `key` may also be `{ namespace, key }` |
60
+ | `gets({ bindings })` | Resolves several keys; every entry is optional |
61
+ | `getBinding({ key })`, `isBound({ key })`, `unbind({ key })`, `set({ binding })` | Read, test, remove, or register a `Binding` |
62
+ | `instantiate(cls)` / `resolve(cls)` | Builds a class from its `@inject` metadata without binding it |
63
+ | `findByTag({ tag, exclude })` | Every binding with a tag; `exclude` takes an array or a `Set` of keys |
64
+ | `clear()` / `reset()` | Drops cached singletons / drops every binding |
65
+ | `startResolutionCounting()`, `getResolutionCounts()`, `stopResolutionCounting()` | Counts how often each key is resolved, off by default |
66
+
67
+ | Binding member | What it does |
95
68
  | :--- | :--- |
96
- | `.toValue(value)` | Binds a ready value - returned as-is |
97
- | `.toClass(Class)` | Binds a class, instantiated through the container on resolution |
98
- | `.toProvider(fn \| ProviderClass)` | Binds a factory `(container) => T`, or a class implementing `IProvider<T>` with a `value(container)` method |
99
- | `.setScope(scope)` / `.getScope()` | `BindingScopes.TRANSIENT` (default) or `BindingScopes.SINGLETON` |
100
- | `.setTags(...tags)` / `.hasTag(tag)` / `.getTags()` | Tagging for `findByTag` |
101
- | `.getValue(container)` | Resolves the binding; a container is required for class and provider resolvers |
102
- | `.clearCache()` | Discards a cached singleton instance |
69
+ | `toValue(value)` | Returns the value as-is |
70
+ | `toClass(Class)` | Instantiates the class through the container |
71
+ | `toProvider(factory)` | Calls `(container) => T`, or instantiates a class with a `value(container)` method |
72
+ | `setScope(scope)` | `BindingScopes.TRANSIENT` (default) or `BindingScopes.SINGLETON` |
73
+ | `setTags(...tags)`, `hasTag(tag)`, `getTags()` | Tags for `findByTag` |
74
+ | `clearCache()` | Discards the cached singleton |
103
75
 
104
- ### Decorators
76
+ `AbstractContainer` (the contract) and `BaseContainer` (the storage) are exported for custom
77
+ containers. `BindingKeys.build({ namespace, key })` joins a namespace and a key with a dot.
105
78
 
106
- | Decorator | Where | Notes |
107
- | :--- | :--- | :--- |
108
- | `@inject({ key, isOptional? })` | Constructor parameter | Resolved by index and passed to the constructor |
109
- | `@inject({ key, isOptional? })` | Property | Assigned after construction |
79
+ ## Decorators
110
80
 
111
- Both write into the shared `metadataRegistry` (a `MetadataRegistry` instance). Pass your own through
112
- the `registry` option to isolate metadata - in tests, for example.
81
+ `@inject` marks a constructor parameter or a property. Pass a `key`, or a `target` class to
82
+ resolve through the key that class was registered under.
113
83
 
114
- ### Keys and scopes
84
+ | Option | Type | Meaning |
85
+ | :--- | :--- | :--- |
86
+ | `key` | `string \| symbol` | The binding key to resolve |
87
+ | `target` | class, or a function returning one | Resolve the class's recorded key. The function form survives an import cycle |
88
+ | `isOptional` | `boolean` | Resolve an unbound key to `undefined` instead of throwing |
115
89
 
116
- | Symbol | Notes |
117
- | :--- | :--- |
118
- | `BindingKeys.build({ namespace, key })` | Joins the two with a dot. `key` is required; an empty namespace yields the bare key |
119
- | Namespace auto-tagging | A dotted key tags its binding with the first segment - `services.UserService` is tagged `services` |
120
- | `BindingScopes` | `SINGLETON`, `TRANSIENT` |
121
- | `BindingValueTypes` | `CLASS`, `VALUE`, `PROVIDER` - the resolver kinds |
90
+ Constructor parameters resolve before construction. Properties are assigned after it.
122
91
 
123
- Conventional namespaces across IGNIS: `controllers`, `services`, `repositories`, `datasources`.
92
+ > [!IMPORTANT]
93
+ > Declare `experimentalDecorators: true` in your own `tsconfig.json`, not only through `extends`.
94
+ > Bun can miss an inherited flag when it runs source, and then drops parameter decorators with no
95
+ > error. `emitDecoratorMetadata` is not needed: `@inject` records the parameter index itself.
124
96
 
125
- Full reference: [Dependency injection](https://ignis.venizia.ai/references/base/dependency-injection).
97
+ Decorate every constructor parameter of a class the container builds. An undecorated parameter
98
+ before a decorated one is refused with `Constructor parameter N has no @inject`. An undecorated
99
+ trailing parameter receives `undefined`.
126
100
 
127
101
  ## Errors
128
102
 
129
- This package also ships the error module the whole framework throws through, so a standalone
130
- consumer gets it for free. Never throw a raw `new Error`.
103
+ The package also holds the error type the whole framework throws.
131
104
 
132
105
  ```typescript
133
106
  import { getError, isApplicationError } from '@venizia/ignis-inversion';
134
107
 
135
- throw getError({
136
- message: { text: 'User not found', code: 'user.not_found', args: { id: 42 } },
137
- statusCode: 404,
138
- });
108
+ try {
109
+ throw getError({
110
+ message: { text: 'User not found', code: 'user.not_found', args: { id: 42 } },
111
+ statusCode: 404,
112
+ });
113
+ } catch (error) {
114
+ if (isApplicationError(error)) {
115
+ console.log(error.statusCode, error.normalized); // 404 { text, code, args }
116
+ }
117
+ }
139
118
  ```
140
119
 
141
- `getError` returns an `ApplicationError` - a real `Error` subclass carrying `statusCode`, an
142
- optional `extra` bag, and `normalized`, which is always the same three fields:
120
+ `getError` returns an `ApplicationError`, an `Error` subclass. It carries `statusCode` (default
121
+ `400`), `normalized` (`{ text, code, args }`) and an optional `extra` bag. A bare string `message`
122
+ becomes `text`. A missing code becomes `MessageCode.DEFAULT` (`core.system_error`). Unknown
123
+ top-level keys go into `extra`.
143
124
 
144
- | Field | Meaning |
145
- | :--- | :--- |
146
- | `text` | The human-readable message |
147
- | `code` | A dotted, lower snake_case message code. Falls back to `MessageCode.DEFAULT` (`core.system_error`) |
148
- | `args` | Interpolation arguments, `{}` when there are none |
149
-
150
- `message` also accepts a bare string, which becomes `text`. Unknown top-level keys are swept into
151
- `extra`, so a throw site can attach context the framework does not model.
152
-
153
- > [!IMPORTANT]
154
- > Check errors with `isApplicationError(error)`, never `instanceof ApplicationError`. Several
155
- > packages can carry their own copy of the class, so `instanceof` fails across package boundaries.
156
-
157
- Also exported: `ApplicationError`, `MessageCode`, `ErrorScopes`, and the `TError*` types. Catalogued
158
- errors are declared as `TErrorDefinition` objects and thrown with `getError({ error: Definition })`.
125
+ Test with `isApplicationError(error)`, not `instanceof ApplicationError`. A CommonJS copy and an
126
+ ES module copy of the package can both be loaded, and `instanceof` fails across them.
159
127
 
160
- ## Rules that will burn you
128
+ ## Entry points
161
129
 
162
- **Every constructor parameter of a container-instantiated class must carry `@inject`.** There is no
163
- channel for the container to supply an undecorated one, so a mixed constructor is refused at
164
- instantiation with `[Class] Constructor parameter N has no @inject`. Options a class needs go into
165
- `super({ ... })` or onto a binding, never as a bare parameter.
130
+ | Entry point | What it gives | Extra peers |
131
+ | :--- | :--- | :--- |
132
+ | `@venizia/ignis-inversion` | Everything: container, bindings, `@inject`, `MetadataRegistry`, errors | none |
166
133
 
167
- **This package keeps a dual CJS + ESM build on purpose.** Frontend consumers import it into browser
168
- bundles, so `dist/esm` is load-bearing. Do not "simplify" the build to ESM-only or CJS-only.
134
+ The package ships both CommonJS (`dist/cjs`) and ES modules (`dist/esm`). `import` resolves the ES
135
+ build, `require` the CommonJS one. The ES build is what a browser bundle takes.
169
136
 
170
- **`import 'reflect-metadata'` once, at your entrypoint.** The package imports it, but a consumer
171
- that loads two copies gets two metadata stores and silently empty injection.
137
+ ## Where it sits
172
138
 
173
- **Singleton caching keys on `undefined`.** A singleton binding that resolves to `undefined` is
174
- re-resolved on every `get` rather than cached.
139
+ Depends on nothing in IGNIS. Used by filter, helpers and kernel: dev-configs -> **inversion** ->
140
+ {filter, helpers} -> {boot, kernel} -> connectors -> {core-worker, core-server} -> atlas.
175
141
 
176
142
  ## Links
177
143
 
178
- [Documentation](https://ignis.venizia.ai) &#8226;
179
- [Dependency injection](https://ignis.venizia.ai/references/base/dependency-injection) &#8226;
180
- [Core API](https://ignis.venizia.ai/references/) &#8226;
181
- [Best practices](https://ignis.venizia.ai/best-practices/) &#8226;
182
- [Changelog](https://ignis.venizia.ai/changelogs/)
144
+ - [Inversion (DI) guide](https://ignis.venizia.ai/extensions/helpers/inversion/)
145
+ - [Dependency injection reference](https://ignis.venizia.ai/references/base/dependency-injection)
146
+ - [Error handling](https://ignis.venizia.ai/extensions/helpers/error/)
147
+ - [Changelog](https://ignis.venizia.ai/changelogs/)
148
+ - [Source](https://github.com/VENIZIA-AI/ignis/blob/main/packages/inversion)
183
149
 
184
- MIT licensed. Questions: [GitHub Issues](https://github.com/VENIZIA-AI/ignis/issues) &#8226; developer@venizia.ai
150
+ MIT licensed - see [LICENSE.md](./LICENSE.md).
@@ -1,10 +1,38 @@
1
1
  import type { AnyType, TClass, TInjectTarget, TValueOrAsyncResolver, TValueOrResolver } from './types';
2
+ /**
3
+ * True for a value carrying nothing: `null`/`undefined`, an empty string, array, `Map`, `Set`, or an
4
+ * object with no own enumerable keys. A number, boolean or function is empty too - it holds no
5
+ * entries.
6
+ *
7
+ * Hand-written rather than `lodash/isEmpty`, and NOT a plain `!value`: `!{}` is `false` while an
8
+ * empty object IS empty, so the two disagree on exactly the case a swap would silently flip.
9
+ */
10
+ export declare const isEmpty: (opts: {
11
+ value: unknown;
12
+ }) => boolean;
13
+ /**
14
+ * A shallow copy without `keys`.
15
+ *
16
+ * Hand-written rather than `lodash/omit`: this package is bundled for browsers, where importing
17
+ * lodash for one function costs 24 KB. Matches lodash on the shapes we pass it - a flat key list,
18
+ * never a nested path.
19
+ */
20
+ export declare const omit: <T extends object, K extends PropertyKey>(opts: {
21
+ source: T;
22
+ keys: readonly K[];
23
+ }) => Omit<T, Extract<K, keyof T>>;
2
24
  /** Tells a CONSTRUCTOR from a RESOLVER via source text - `prototype !== undefined` is true of every non-arrow function. Sound only on ES2020+ output (classes emit as `class`); ES5 bundling breaks it. */
3
25
  export declare const isClass: <T>(target: any) => target is TClass<T>;
4
26
  /** Reads a value-or-resolver. A class constructor is returned as-is; only a plain function is called. */
5
- export declare const resolveValue: <T>(valueOrResolver: TValueOrResolver<T>) => T;
27
+ export declare const resolveValue: <T>(opts: {
28
+ value: TValueOrResolver<T>;
29
+ }) => T;
6
30
  /** `resolveValue` for a resolver that may answer a promise. */
7
- export declare const resolveValueAsync: <T>(valueOrResolver: TValueOrAsyncResolver<T>) => Promise<T>;
31
+ export declare const resolveValueAsync: <T>(opts: {
32
+ value: TValueOrAsyncResolver<T>;
33
+ }) => Promise<T>;
8
34
  /** Reads what `@inject({ target })` named. The function form is called HERE, never at decoration: that is what lets a class reached through an import cycle be named at all. Answers `undefined` when the function hands back something that is not a class. The container resolves synchronously, so there is no async form. */
9
- export declare const resolveInjectTarget: (target: TInjectTarget) => TClass<AnyType> | undefined;
35
+ export declare const resolveInjectTarget: (opts: {
36
+ target: TInjectTarget;
37
+ }) => TClass<AnyType> | undefined;
10
38
  //# sourceMappingURL=utilities.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"utilities.d.ts","sourceRoot":"","sources":["../../../src/common/utilities.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,OAAO,EAEP,MAAM,EACN,aAAa,EAEb,qBAAqB,EACrB,gBAAgB,EACjB,MAAM,SAAS,CAAC;AAEjB,2MAA2M;AAC3M,eAAO,MAAM,OAAO,GAAI,CAAC,EAAE,QAAQ,GAAG,KAAG,MAAM,IAAI,MAAM,CAAC,CAAC,CAM1D,CAAC;AAMF,yGAAyG;AACzG,eAAO,MAAM,YAAY,GAAI,CAAC,EAAE,iBAAiB,gBAAgB,CAAC,CAAC,CAAC,KAAG,CACJ,CAAC;AAOpE,+DAA+D;AAC/D,eAAO,MAAM,iBAAiB,GAAU,CAAC,EACvC,iBAAiB,qBAAqB,CAAC,CAAC,CAAC,KACxC,OAAO,CAAC,CAAC,CAA6E,CAAC;AAE1F,iUAAiU;AACjU,eAAO,MAAM,mBAAmB,GAAI,QAAQ,aAAa,KAAG,MAAM,CAAC,OAAO,CAAC,GAAG,SAG7E,CAAC"}
1
+ {"version":3,"file":"utilities.d.ts","sourceRoot":"","sources":["../../../src/common/utilities.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,OAAO,EAEP,MAAM,EACN,aAAa,EAEb,qBAAqB,EACrB,gBAAgB,EACjB,MAAM,SAAS,CAAC;AAEjB;;;;;;;GAOG;AACH,eAAO,MAAM,OAAO,GAAI,MAAM;IAAE,KAAK,EAAE,OAAO,CAAA;CAAE,KAAG,OAwBlD,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,IAAI,GAAI,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,WAAW,EAAE,MAAM;IAClE,MAAM,EAAE,CAAC,CAAC;IACV,IAAI,EAAE,SAAS,CAAC,EAAE,CAAC;CACpB,KAAG,IAAI,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAe9B,CAAC;AAEF,2MAA2M;AAC3M,eAAO,MAAM,OAAO,GAAI,CAAC,EAAE,QAAQ,GAAG,KAAG,MAAM,IAAI,MAAM,CAAC,CAAC,CAM1D,CAAC;AAMF,yGAAyG;AACzG,eAAO,MAAM,YAAY,GAAI,CAAC,EAAE,MAAM;IAAE,KAAK,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAA;CAAE,KAAG,CAGtE,CAAC;AAOF,+DAA+D;AAC/D,eAAO,MAAM,iBAAiB,GAAU,CAAC,EAAE,MAAM;IAC/C,KAAK,EAAE,qBAAqB,CAAC,CAAC,CAAC,CAAC;CACjC,KAAG,OAAO,CAAC,CAAC,CAGZ,CAAC;AAEF,iUAAiU;AACjU,eAAO,MAAM,mBAAmB,GAAI,MAAM;IACxC,MAAM,EAAE,aAAa,CAAC;CACvB,KAAG,MAAM,CAAC,OAAO,CAAC,GAAG,SAGrB,CAAC"}
@@ -1,6 +1,56 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
- exports.resolveInjectTarget = exports.resolveValueAsync = exports.resolveValue = exports.isClass = void 0;
3
+ exports.resolveInjectTarget = exports.resolveValueAsync = exports.resolveValue = exports.isClass = exports.omit = exports.isEmpty = void 0;
4
+ /**
5
+ * True for a value carrying nothing: `null`/`undefined`, an empty string, array, `Map`, `Set`, or an
6
+ * object with no own enumerable keys. A number, boolean or function is empty too - it holds no
7
+ * entries.
8
+ *
9
+ * Hand-written rather than `lodash/isEmpty`, and NOT a plain `!value`: `!{}` is `false` while an
10
+ * empty object IS empty, so the two disagree on exactly the case a swap would silently flip.
11
+ */
12
+ const isEmpty = (opts) => {
13
+ const { value } = opts;
14
+ if (value === null || value === undefined) {
15
+ return true;
16
+ }
17
+ // The types that carry a MEANINGFUL length. Duck-typing on `.length` instead would call
18
+ // `{ length: 0 }` empty, which it is not - it has an own key.
19
+ if (typeof value === 'string' || Array.isArray(value) || ArrayBuffer.isView(value)) {
20
+ return value.length === 0;
21
+ }
22
+ if (value instanceof Map || value instanceof Set) {
23
+ return value.size === 0;
24
+ }
25
+ if (typeof value !== 'object') {
26
+ return true;
27
+ }
28
+ // Own keys only: `for...in` would walk the prototype chain and call an object with an inherited
29
+ // property non-empty.
30
+ return Object.keys(value).length === 0;
31
+ };
32
+ exports.isEmpty = isEmpty;
33
+ /**
34
+ * A shallow copy without `keys`.
35
+ *
36
+ * Hand-written rather than `lodash/omit`: this package is bundled for browsers, where importing
37
+ * lodash for one function costs 24 KB. Matches lodash on the shapes we pass it - a flat key list,
38
+ * never a nested path.
39
+ */
40
+ const omit = (opts) => {
41
+ const { source, keys } = opts;
42
+ const dropped = new Set(keys);
43
+ const kept = {};
44
+ const entries = Object.entries(source);
45
+ for (const [key, value] of entries) {
46
+ if (dropped.has(key)) {
47
+ continue;
48
+ }
49
+ kept[key] = value;
50
+ }
51
+ return kept;
52
+ };
53
+ exports.omit = omit;
4
54
  /** Tells a CONSTRUCTOR from a RESOLVER via source text - `prototype !== undefined` is true of every non-arrow function. Sound only on ES2020+ output (classes emit as `class`); ES5 bundling breaks it. */
5
55
  const isClass = (target) => {
6
56
  if (typeof target !== 'function' || target.prototype === undefined) {
@@ -12,15 +62,21 @@ exports.isClass = isClass;
12
62
  /** A resolver is anything callable that is not a class - a class is a value here, never a factory. */
13
63
  const isResolver = (valueOrResolver) => typeof valueOrResolver === 'function' && !(0, exports.isClass)(valueOrResolver);
14
64
  /** Reads a value-or-resolver. A class constructor is returned as-is; only a plain function is called. */
15
- const resolveValue = (valueOrResolver) => isResolver(valueOrResolver) ? valueOrResolver() : valueOrResolver;
65
+ const resolveValue = (opts) => {
66
+ const { value } = opts;
67
+ return isResolver(value) ? value() : value;
68
+ };
16
69
  exports.resolveValue = resolveValue;
17
70
  const isAsyncResolver = (valueOrResolver) => typeof valueOrResolver === 'function' && !(0, exports.isClass)(valueOrResolver);
18
71
  /** `resolveValue` for a resolver that may answer a promise. */
19
- const resolveValueAsync = async (valueOrResolver) => (isAsyncResolver(valueOrResolver) ? valueOrResolver() : valueOrResolver);
72
+ const resolveValueAsync = async (opts) => {
73
+ const { value } = opts;
74
+ return isAsyncResolver(value) ? value() : value;
75
+ };
20
76
  exports.resolveValueAsync = resolveValueAsync;
21
77
  /** Reads what `@inject({ target })` named. The function form is called HERE, never at decoration: that is what lets a class reached through an import cycle be named at all. Answers `undefined` when the function hands back something that is not a class. The container resolves synchronously, so there is no async form. */
22
- const resolveInjectTarget = (target) => {
23
- const resolved = (0, exports.resolveValue)(target);
78
+ const resolveInjectTarget = (opts) => {
79
+ const resolved = (0, exports.resolveValue)({ value: opts.target });
24
80
  return (0, exports.isClass)(resolved) ? resolved : undefined;
25
81
  };
26
82
  exports.resolveInjectTarget = resolveInjectTarget;
@@ -1 +1 @@
1
- {"version":3,"file":"utilities.js","sourceRoot":"","sources":["../../../src/common/utilities.ts"],"names":[],"mappings":";;;AAUA,2MAA2M;AACpM,MAAM,OAAO,GAAG,CAAI,MAAW,EAAuB,EAAE;IAC7D,IAAI,OAAO,MAAM,KAAK,UAAU,IAAI,MAAM,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;QACnE,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;AACtE,CAAC,CAAC;AANW,QAAA,OAAO,WAMlB;AAEF,sGAAsG;AACtG,MAAM,UAAU,GAAG,CAAI,eAAoC,EAAmC,EAAE,CAC9F,OAAO,eAAe,KAAK,UAAU,IAAI,CAAC,IAAA,eAAO,EAAC,eAAe,CAAC,CAAC;AAErE,yGAAyG;AAClG,MAAM,YAAY,GAAG,CAAI,eAAoC,EAAK,EAAE,CACzE,UAAU,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC,eAAe,CAAC;AADvD,QAAA,YAAY,gBAC2C;AAEpE,MAAM,eAAe,GAAG,CACtB,eAAyC,EACH,EAAE,CACxC,OAAO,eAAe,KAAK,UAAU,IAAI,CAAC,IAAA,eAAO,EAAC,eAAe,CAAC,CAAC;AAErE,+DAA+D;AACxD,MAAM,iBAAiB,GAAG,KAAK,EACpC,eAAyC,EAC7B,EAAE,CAAC,CAAC,eAAe,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC;AAF7E,QAAA,iBAAiB,qBAE4D;AAE1F,iUAAiU;AAC1T,MAAM,mBAAmB,GAAG,CAAC,MAAqB,EAA+B,EAAE;IACxF,MAAM,QAAQ,GAAG,IAAA,oBAAY,EAAC,MAAM,CAAC,CAAC;IACtC,OAAO,IAAA,eAAO,EAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;AAClD,CAAC,CAAC;AAHW,QAAA,mBAAmB,uBAG9B"}
1
+ {"version":3,"file":"utilities.js","sourceRoot":"","sources":["../../../src/common/utilities.ts"],"names":[],"mappings":"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"}
@@ -7,6 +7,7 @@ export declare class Binding<T = any> extends BaseHelper implements IBinding<T>
7
7
  key: string;
8
8
  private bindScope;
9
9
  private tags;
10
+ /** Boxed: a singleton may legitimately be `null`, `false`, `0`, `''` or `undefined`. */
10
11
  private cached?;
11
12
  private resolver;
12
13
  constructor(opts: {
@@ -26,6 +27,8 @@ export declare class Binding<T = any> extends BaseHelper implements IBinding<T>
26
27
  hasTag(tag: string): boolean;
27
28
  getTags(): string[];
28
29
  getScope(): TBindingScope;
30
+ /** True when `getValue` answers without building anything: a cached singleton or a plain value. Nothing it reads can form a cycle. */
31
+ isSettled(): boolean;
29
32
  getValue(container?: IContainer): T;
30
33
  clearCache(): void;
31
34
  }
@@ -1 +1 @@
1
- {"version":3,"file":"binding.d.ts","sourceRoot":"","sources":["../../../../src/modules/binding/binding.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAiB,iBAAiB,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACrF,OAAO,EAAE,QAAQ,EAAmB,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAEpG,qBAAa,OAAO,CAAC,CAAC,GAAG,GAAG,CAAE,SAAQ,UAAW,YAAW,QAAQ,CAAC,CAAC,CAAC;IACrE,GAAG,EAAE,MAAM,CAAC;IAEZ,OAAO,CAAC,SAAS,CAA0C;IAC3D,OAAO,CAAC,IAAI,CAAc;IAC1B,OAAO,CAAC,MAAM,CAAC,CAAI;IAEnB,OAAO,CAAC,QAAQ,CAG4D;gBAEhE,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE;WAajB,IAAI,CAAC,CAAC,GAAG,GAAG,EAAE,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,CAAC,CAAC;IAIhE,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI;IAK/B,OAAO,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI;IAKvB,UAAU,CAAC,KAAK,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,IAAI;IAK5C,cAAc,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,WAAW,CAAC,OAAO,iBAAiB,CAAC,CAAA;KAAE,GAAG,qBAAqB,CAAC,CAAC,CAAC;IAU/F,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI;IAKpC,OAAO,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI;IAKhC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAI5B,OAAO,IAAI,MAAM,EAAE;IAInB,QAAQ,IAAI,aAAa;IAIzB,QAAQ,CAAC,SAAS,CAAC,EAAE,UAAU,GAAG,CAAC;IAuDnC,UAAU;CAOX"}
1
+ {"version":3,"file":"binding.d.ts","sourceRoot":"","sources":["../../../../src/modules/binding/binding.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAiB,iBAAiB,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACrF,OAAO,EAAE,QAAQ,EAAmB,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAEpG,qBAAa,OAAO,CAAC,CAAC,GAAG,GAAG,CAAE,SAAQ,UAAW,YAAW,QAAQ,CAAC,CAAC,CAAC;IACrE,GAAG,EAAE,MAAM,CAAC;IAEZ,OAAO,CAAC,SAAS,CAA0C;IAC3D,OAAO,CAAC,IAAI,CAAc;IAC1B,wFAAwF;IACxF,OAAO,CAAC,MAAM,CAAC,CAAe;IAE9B,OAAO,CAAC,QAAQ,CAG4D;gBAEhE,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE;WAajB,IAAI,CAAC,CAAC,GAAG,GAAG,EAAE,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,CAAC,CAAC;IAIhE,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI;IAK/B,OAAO,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI;IAKvB,UAAU,CAAC,KAAK,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,IAAI;IAK5C,cAAc,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,WAAW,CAAC,OAAO,iBAAiB,CAAC,CAAA;KAAE,GAAG,qBAAqB,CAAC,CAAC,CAAC;IAU/F,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI;IAKpC,OAAO,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI;IAKhC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAI5B,OAAO,IAAI,MAAM,EAAE;IAInB,QAAQ,IAAI,aAAa;IAIzB,sIAAsI;IACtI,SAAS,IAAI,OAAO;IAOpB,QAAQ,CAAC,SAAS,CAAC,EAAE,UAAU,GAAG,CAAC;IAuDnC,UAAU;CAGX"}
@@ -57,9 +57,14 @@ class Binding extends base_helper_1.BaseHelper {
57
57
  getScope() {
58
58
  return this.bindScope;
59
59
  }
60
+ /** True when `getValue` answers without building anything: a cached singleton or a plain value. Nothing it reads can form a cycle. */
61
+ isSettled() {
62
+ return ((this.bindScope === constants_1.BindingScopes.SINGLETON && this.cached !== undefined) ||
63
+ this.resolver.type === constants_1.BindingValueTypes.VALUE);
64
+ }
60
65
  getValue(container) {
61
- if (this.bindScope === constants_1.BindingScopes.SINGLETON && this.cached !== undefined) {
62
- return this.cached;
66
+ if (this.bindScope === constants_1.BindingScopes.SINGLETON && this.cached) {
67
+ return this.cached.value;
63
68
  }
64
69
  let instance;
65
70
  const { type: resolverType } = this.resolver;
@@ -99,14 +104,11 @@ class Binding extends base_helper_1.BaseHelper {
99
104
  }
100
105
  }
101
106
  if (this.bindScope === constants_1.BindingScopes.SINGLETON) {
102
- this.cached = instance;
107
+ this.cached = { value: instance };
103
108
  }
104
109
  return instance;
105
110
  }
106
111
  clearCache() {
107
- if (!this.cached) {
108
- return;
109
- }
110
112
  this.cached = undefined;
111
113
  }
112
114
  }
@@ -1 +1 @@
1
- {"version":3,"file":"binding.js","sourceRoot":"","sources":["../../../../src/modules/binding/binding.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"binding.js","sourceRoot":"","sources":["../../../../src/modules/binding/binding.ts"],"names":[],"mappings":";;;AAAA,oCAAoC;AACpC,sDAAkD;AAGlD,kDAAqF;AACrF,0CAAoG;AAEpG,MAAa,OAAiB,SAAQ,wBAAU;IAa9C,YAAY,IAAqB;QAC/B,KAAK,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;QAXrB,cAAS,GAAkB,yBAAa,CAAC,SAAS,CAAC;QAYzD,IAAI,CAAC,IAAI,GAAG,IAAI,GAAG,CAAC,EAAE,CAAC,CAAC;QAExB,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC;QAEpB,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACrC,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxB,MAAM,CAAC,SAAS,CAAC,GAAG,QAAQ,CAAC;YAC7B,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IAED,MAAM,CAAU,IAAI,CAAU,IAAqB;QACjD,OAAO,IAAI,OAAO,CAAI,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED,OAAO,CAAC,KAAgB;QACtB,IAAI,CAAC,QAAQ,GAAG,EAAE,IAAI,EAAE,6BAAiB,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC;QACzD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,CAAC,KAAQ;QACd,IAAI,CAAC,QAAQ,GAAG,EAAE,IAAI,EAAE,6BAAiB,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC;QACzD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,UAAU,CAAC,KAA0B;QACnC,IAAI,CAAC,QAAQ,GAAG,EAAE,IAAI,EAAE,6BAAiB,CAAC,QAAQ,EAAE,KAAK,EAAE,CAAC;QAC5D,OAAO,IAAI,CAAC;IACd,CAAC;IAED,cAAc,CAAC,IAAqD;QAClE,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,EAAE,CAAC;YACrC,MAAM,IAAA,gBAAQ,EAAC;gBACb,OAAO,EAAE,gDAAgD,IAAI,CAAC,QAAQ,CAAC,IAAI,8BAA8B,IAAI,CAAC,QAAQ,CAAC,IAAI,eAAe,IAAI,CAAC,IAAI,EAAE;aACtJ,CAAC,CAAC;QACL,CAAC;QAED,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;IAC7B,CAAC;IAED,QAAQ,CAAC,KAAoB;QAC3B,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;QACvB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,CAAC,GAAG,IAAc;QACvB,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACpC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,CAAC,GAAW;QAChB,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC5B,CAAC;IAED,OAAO;QACL,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED,sIAAsI;IACtI,SAAS;QACP,OAAO,CACL,CAAC,IAAI,CAAC,SAAS,KAAK,yBAAa,CAAC,SAAS,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC;YACzE,IAAI,CAAC,QAAQ,CAAC,IAAI,KAAK,6BAAiB,CAAC,KAAK,CAC/C,CAAC;IACJ,CAAC;IAED,QAAQ,CAAC,SAAsB;QAC7B,IAAI,IAAI,CAAC,SAAS,KAAK,yBAAa,CAAC,SAAS,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAC9D,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;QAC3B,CAAC;QAED,IAAI,QAAW,CAAC;QAEhB,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC7C,QAAQ,YAAY,EAAE,CAAC;YACrB,KAAK,6BAAiB,CAAC,KAAK,CAAC,CAAC,CAAC;gBAC7B,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;gBAC/B,MAAM;YACR,CAAC;YACD,KAAK,6BAAiB,CAAC,QAAQ,CAAC,CAAC,CAAC;gBAChC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;gBAErC,IAAI,CAAC,SAAS,EAAE,CAAC;oBACf,MAAM,IAAA,gBAAQ,EAAC;wBACb,OAAO,EAAE,sEAAsE,YAAY,WAAW,IAAI,CAAC,GAAG,EAAE;qBACjH,CAAC,CAAC;gBACL,CAAC;gBAED,IAAI,CAAC,IAAA,uBAAe,EAAC,QAAQ,CAAC,EAAE,CAAC;oBAC/B,QAAQ,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC;oBAC/B,MAAM;gBACR,CAAC;gBAED,MAAM,CAAC,GAAG,SAAS,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;gBAC1C,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;gBAC9B,MAAM;YACR,CAAC;YACD,KAAK,6BAAiB,CAAC,KAAK,CAAC,CAAC,CAAC;gBAC7B,IAAI,CAAC,SAAS,EAAE,CAAC;oBACf,MAAM,IAAA,gBAAQ,EAAC;wBACb,OAAO,EAAE,qEAAqE,YAAY,WAAW,IAAI,CAAC,GAAG,EAAE;qBAChH,CAAC,CAAC;gBACL,CAAC;gBAED,QAAQ,GAAG,SAAS,CAAC,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;gBACtD,MAAM;YACR,CAAC;YACD,OAAO,CAAC,CAAC,CAAC;gBACR,MAAM,IAAA,gBAAQ,EAAC;oBACb,OAAO,EAAE,8CAA8C,YAAY,EAAE;iBACtE,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,IAAI,IAAI,CAAC,SAAS,KAAK,yBAAa,CAAC,SAAS,EAAE,CAAC;YAC/C,IAAI,CAAC,MAAM,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;QACpC,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,UAAU;QACR,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;IAC1B,CAAC;CACF;AA/ID,0BA+IC"}
@@ -1 +1 @@
1
- {"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../../src/modules/binding/common/constants.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C,qBAAa,aAAa;IACxB,MAAM,CAAC,QAAQ,CAAC,SAAS,eAAe;IACxC,MAAM,CAAC,QAAQ,CAAC,SAAS,eAAe;CACzC;AACD,MAAM,MAAM,aAAa,GAAG,WAAW,CAAC,OAAO,aAAa,CAAC,CAAC;AAE9D,qBAAa,iBAAiB;IAC5B,MAAM,CAAC,QAAQ,CAAC,KAAK,WAAW;IAChC,MAAM,CAAC,QAAQ,CAAC,KAAK,WAAW;IAChC,MAAM,CAAC,QAAQ,CAAC,QAAQ,cAAc;CACvC;AACD,MAAM,MAAM,iBAAiB,GAAG,WAAW,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAEtE,qBAAa,WAAW;IACtB,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE;CAgBtD"}
1
+ {"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../../src/modules/binding/common/constants.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C,qBAAa,aAAa;IACxB,MAAM,CAAC,QAAQ,CAAC,SAAS,eAAe;IACxC,MAAM,CAAC,QAAQ,CAAC,SAAS,eAAe;CACzC;AACD,MAAM,MAAM,aAAa,GAAG,WAAW,CAAC,OAAO,aAAa,CAAC,CAAC;AAE9D,qBAAa,iBAAiB;IAC5B,MAAM,CAAC,QAAQ,CAAC,KAAK,WAAW;IAChC,MAAM,CAAC,QAAQ,CAAC,KAAK,WAAW;IAChC,MAAM,CAAC,QAAQ,CAAC,QAAQ,cAAc;CACvC;AACD,MAAM,MAAM,iBAAiB,GAAG,WAAW,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAEtE,qBAAa,WAAW;IACtB,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE;CAgBtD"}
@@ -1,10 +1,6 @@
1
1
  "use strict";
2
- var __importDefault = (this && this.__importDefault) || function (mod) {
3
- return (mod && mod.__esModule) ? mod : { "default": mod };
4
- };
5
2
  Object.defineProperty(exports, "__esModule", { value: true });
6
3
  exports.BindingKeys = exports.BindingValueTypes = exports.BindingScopes = void 0;
7
- const isEmpty_1 = __importDefault(require("lodash/isEmpty"));
8
4
  const error_1 = require("../../error");
9
5
  class BindingScopes {
10
6
  static { this.SINGLETON = 'singleton'; }
@@ -21,10 +17,10 @@ class BindingKeys {
21
17
  static build(opts) {
22
18
  const { namespace, key } = opts;
23
19
  const keyParts = [];
24
- if (!(0, isEmpty_1.default)(namespace)) {
20
+ if (namespace) {
25
21
  keyParts.push(namespace);
26
22
  }
27
- if ((0, isEmpty_1.default)(key)) {
23
+ if (!key) {
28
24
  throw (0, error_1.getError)({
29
25
  message: `[BindingKeys][build] Invalid key to build | key: ${key}`,
30
26
  });
@@ -1 +1 @@
1
- {"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../../src/modules/binding/common/constants.ts"],"names":[],"mappings":";;;;;;AAAA,6DAAqC;AACrC,uCAAuC;AAGvC,MAAa,aAAa;aACR,cAAS,GAAG,WAAW,CAAC;aACxB,cAAS,GAAG,WAAW,CAAC;;AAF1C,sCAGC;AAGD,MAAa,iBAAiB;aACZ,UAAK,GAAG,OAAO,CAAC;aAChB,UAAK,GAAG,OAAO,CAAC;aAChB,aAAQ,GAAG,UAAU,CAAC;;AAHxC,8CAIC;AAGD,MAAa,WAAW;IACtB,MAAM,CAAC,KAAK,CAAC,IAAwC;QACnD,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;QAChC,MAAM,QAAQ,GAAkB,EAAE,CAAC;QACnC,IAAI,CAAC,IAAA,iBAAO,EAAC,SAAS,CAAC,EAAE,CAAC;YACxB,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC3B,CAAC;QAED,IAAI,IAAA,iBAAO,EAAC,GAAG,CAAC,EAAE,CAAC;YACjB,MAAM,IAAA,gBAAQ,EAAC;gBACb,OAAO,EAAE,oDAAoD,GAAG,EAAE;aACnE,CAAC,CAAC;QACL,CAAC;QAED,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACnB,OAAO,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC5B,CAAC;CACF;AAjBD,kCAiBC"}
1
+ {"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../../src/modules/binding/common/constants.ts"],"names":[],"mappings":";;;AAAA,uCAAuC;AAGvC,MAAa,aAAa;aACR,cAAS,GAAG,WAAW,CAAC;aACxB,cAAS,GAAG,WAAW,CAAC;;AAF1C,sCAGC;AAGD,MAAa,iBAAiB;aACZ,UAAK,GAAG,OAAO,CAAC;aAChB,UAAK,GAAG,OAAO,CAAC;aAChB,aAAQ,GAAG,UAAU,CAAC;;AAHxC,8CAIC;AAGD,MAAa,WAAW;IACtB,MAAM,CAAC,KAAK,CAAC,IAAwC;QACnD,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;QAChC,MAAM,QAAQ,GAAkB,EAAE,CAAC;QACnC,IAAI,SAAS,EAAE,CAAC;YACd,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC3B,CAAC;QAED,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,MAAM,IAAA,gBAAQ,EAAC;gBACb,OAAO,EAAE,oDAAoD,GAAG,EAAE;aACnE,CAAC,CAAC;QACL,CAAC;QAED,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACnB,OAAO,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC5B,CAAC;CACF;AAjBD,kCAiBC"}
@@ -10,10 +10,35 @@ export declare abstract class BaseContainer extends AbstractContainer {
10
10
  protected isCountingResolutions: boolean;
11
11
  /** Whether `startResolutionCounting` has ever run. A report read without it would name every binding, which is a wrong answer rather than an empty one. */
12
12
  protected hasStartedResolutionCounting: boolean;
13
+ /** The string each BOUND symbol is stored under: `Symbol('x')` twice is two keys, and both print as "Symbol(x)". */
14
+ protected symbolKeys: Map<symbol, string>;
15
+ /** How many symbols have been bound per description, so a new one gets its suffix in one step. */
16
+ protected symbolDescriptionCounts: Map<string, number>;
17
+ /**
18
+ * Nesting depth of the reads in progress. Past {@link CYCLE_CHECK_DEPTH} the keys are tracked, and
19
+ * a key met again is a cycle: a real graph is far shallower, so the common read pays one counter.
20
+ * Only the synchronous part is checked - a cycle through an `await` is not seen.
21
+ */
22
+ protected resolutionDepth: number;
23
+ protected resolvingKeys: Set<string>;
13
24
  constructor(opts?: {
14
25
  scope: string;
15
26
  });
16
27
  getMetadataRegistry(): import("../registry/registry").MetadataRegistry;
28
+ /**
29
+ * The string a key is stored under, or `undefined` for a symbol that was never bound - a lookup
30
+ * never records one, so reading with throwaway symbols leaves nothing behind.
31
+ */
32
+ protected toKeyString(opts: {
33
+ key: TBindingKey | {
34
+ namespace: string;
35
+ key: string;
36
+ };
37
+ }): string | undefined;
38
+ /** A bound symbol's own string: its description, suffixed (`Symbol(x)#2`) when another symbol holds it. */
39
+ protected bindSymbolKey(opts: {
40
+ key: symbol;
41
+ }): string;
17
42
  bind<T>(opts: {
18
43
  key: TBindingKey;
19
44
  }): Binding<T>;
@@ -1 +1 @@
1
- {"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../../src/modules/container/base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChE,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAI7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAE/C,kKAAkK;AAClK,8BAAsB,aAAc,SAAQ,iBAAiB;IAC3D,SAAS,CAAC,QAAQ,4BAA8B;IAEhD,2EAA2E;IAC3E,SAAS,CAAC,gBAAgB,sBAA6B;IAEvD,mJAAmJ;IACnJ,SAAS,CAAC,qBAAqB,UAAS;IAExC,2JAA2J;IAC3J,SAAS,CAAC,4BAA4B,UAAS;gBAEnC,IAAI,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE;IAI3B,mBAAmB;IAInB,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE;QAAE,GAAG,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,CAAC,CAAC;IAQ/C,OAAO,CAAC,IAAI,EAAE;QAAE,GAAG,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO;IAM5C,UAAU,CAAC,CAAC,EAAE,IAAI,EAAE;QAC3B,GAAG,EAAE,WAAW,GAAG;YAAE,SAAS,EAAE,MAAM,CAAC;YAAC,GAAG,EAAE,MAAM,CAAA;SAAE,CAAC;KACvD,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IA2BhB,MAAM,CAAC,IAAI,EAAE;QAAE,GAAG,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO;IAK3C,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAA;KAAE,GAAG,IAAI;IAK3C,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE;QACpB,GAAG,EAAE,WAAW,GAAG;YAAE,SAAS,EAAE,MAAM,CAAC;YAAC,GAAG,EAAE,MAAM,CAAA;SAAE,CAAC;QACtD,UAAU,CAAC,EAAE,KAAK,CAAC;KACpB,GAAG,CAAC;IACI,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE;QACpB,GAAG,EAAE,WAAW,GAAG;YAAE,SAAS,EAAE,MAAM,CAAC;YAAC,GAAG,EAAE,MAAM,CAAA;SAAE,CAAC;QACtD,UAAU,CAAC,EAAE,OAAO,CAAC;KACtB,GAAG,CAAC,GAAG,SAAS;IA0BR,IAAI,CAAC,CAAC,SAAS,OAAO,EAAE,EAAE,IAAI,EAAE;QACvC,QAAQ,EAAE;aACP,CAAC,IAAI,MAAM,CAAC,GAAG;gBACd,GAAG,EAAE,WAAW,GAAG;oBAAE,SAAS,EAAE,MAAM,CAAC;oBAAC,GAAG,EAAE,MAAM,CAAA;iBAAE,CAAC;gBACtD,UAAU,CAAC,EAAE,OAAO,CAAC;aACtB;SACF,CAAC;KACH,GAAG;SAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS;KAAE;IAMxC,gMAAgM;IACvL,uBAAuB,IAAI,IAAI;IAMxC,yFAAyF;IAChF,sBAAsB,IAAI,IAAI;IAIvC,4IAA4I;IACnI,mBAAmB,IAAI,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC;IAIlD,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC;IAI7B,SAAS,CAAC,CAAC,GAAG,GAAG,EAAE,IAAI,EAAE;QAChC,GAAG,EAAE,MAAM,CAAC;QACZ,OAAO,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC;KACvC,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE;IAyBP,KAAK,IAAI,IAAI;IAOb,KAAK,IAAI,IAAI;CAGvB"}
1
+ {"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../../src/modules/container/base.ts"],"names":[],"mappings":"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"}