composed-di 0.2.8-ts4 → 0.2.9

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.
@@ -1,123 +1,123 @@
1
- import { ServiceKey } from './ServiceKey';
2
- import { ServiceFactory } from './ServiceFactory';
3
- import { ServiceScope } from './ServiceScope';
4
-
5
- type GenericFactory = ServiceFactory<any, readonly ServiceKey<any>[]>;
6
- type GenericKey = ServiceKey<any>;
7
-
8
- export class ServiceModule {
9
- private constructor(readonly factories: GenericFactory[]) {
10
- factories.forEach((factory) => {
11
- checkRecursiveDependencies(factory);
12
- checkMissingDependencies(factory, this.factories);
13
- });
14
- }
15
-
16
- public async get<T>(key: ServiceKey<T>): Promise<T> {
17
- const factory = this.factories.find((factory: GenericFactory) => {
18
- return isSuitable(key, factory);
19
- });
20
-
21
- // Check if a factory to supply the requested key was not found
22
- if (!factory) {
23
- throw new Error(`Could not find a suitable factory for ${key.name}`);
24
- }
25
-
26
- // Resolve all dependencies first
27
- const dependencies = await Promise.all(
28
- factory.dependsOn.map((dependencyKey: ServiceKey<unknown>) => {
29
- return this.get(dependencyKey);
30
- }),
31
- );
32
-
33
- // Call the factory to retrieve the dependency
34
- return factory.initialize(...dependencies);
35
- }
36
-
37
- /**
38
- * Disposes of service factories within the specified scope or all factories if no scope is provided.
39
- *
40
- * This method is useful for cleaning up resources and instances held by service factories,
41
- * such as singleton factories, as they may hold database connections or other resources that need to be released.
42
- *
43
- * @param {ServiceScope} [scope] The scope to filter the factories to be disposed.
44
- * If not provided, all factories are disposed of.
45
- * @return {void} No return value.
46
- */
47
- public dispose(scope?: ServiceScope) {
48
- const factories = scope
49
- ? this.factories.filter((f) => f.scope === scope)
50
- : this.factories;
51
-
52
- factories.forEach((factory) => factory.dispose?.());
53
- }
54
-
55
- /**
56
- * Creates a new ServiceModule instance by aggregating and deduplicating a list of
57
- * ServiceModule or GenericFactory instances.
58
- * If multiple factories provide the same
59
- * ServiceKey, the last one in the list takes precedence.
60
- *
61
- * @param {Array<ServiceModule | GenericFactory>} entries - An array of ServiceModule or GenericFactory
62
- * instances to be processed into a single ServiceModule.
63
- * @return {ServiceModule} A new ServiceModule containing the deduplicated factories.
64
- */
65
- static from(entries: (ServiceModule | GenericFactory)[]): ServiceModule {
66
- // Flatten entries and keep only the last factory for each ServiceKey
67
- const flattened = entries.flatMap((e) =>
68
- e instanceof ServiceModule ? e.factories : [e],
69
- );
70
-
71
- const byKey = new Map<symbol, GenericFactory>();
72
- // Later factories overwrite earlier ones (last-wins)
73
- for (const f of flattened) {
74
- byKey.set(f.provides.symbol, f);
75
- }
76
-
77
- return new ServiceModule(Array.from(byKey.values()));
78
- }
79
- }
80
-
81
- function checkRecursiveDependencies(factory: GenericFactory) {
82
- const recursive = factory.dependsOn.some((dependencyKey) => {
83
- return dependencyKey === factory.provides;
84
- });
85
-
86
- if (recursive) {
87
- throw new Error(
88
- 'Recursive dependency detected on: ' + factory.provides.name,
89
- );
90
- }
91
- }
92
-
93
- function checkMissingDependencies(
94
- factory: GenericFactory,
95
- factories: GenericFactory[],
96
- ) {
97
- const missingDependencies = factory.dependsOn.filter(
98
- (dependencyKey: GenericKey) => {
99
- return !isRegistered(dependencyKey, factories);
100
- },
101
- );
102
- if (missingDependencies.length === 0) {
103
- return;
104
- }
105
-
106
- const dependencyList = missingDependencies
107
- .map((dependencyKey) => ` -> ${dependencyKey.name}`)
108
- .join('\n');
109
- throw new Error(
110
- `${factory.provides.name} will fail because it depends on:\n ${dependencyList}`,
111
- );
112
- }
113
-
114
- function isRegistered(key: GenericKey, factories: GenericFactory[]) {
115
- return factories.some((factory) => factory.provides?.symbol === key?.symbol);
116
- }
117
-
118
- function isSuitable<T, D extends readonly ServiceKey<any>[]>(
119
- key: ServiceKey<T>,
120
- factory: ServiceFactory<any, D>,
121
- ): factory is ServiceFactory<T, D> {
122
- return factory?.provides?.symbol === key?.symbol;
123
- }
1
+ import { ServiceKey } from './serviceKey';
2
+ import { ServiceFactory } from './serviceFactory';
3
+ import { ServiceScope } from './serviceScope';
4
+
5
+ type GenericFactory = ServiceFactory<unknown, readonly ServiceKey<any>[]>;
6
+ type GenericKey = ServiceKey<any>;
7
+
8
+ export class ServiceModule {
9
+ private constructor(readonly factories: GenericFactory[]) {
10
+ factories.forEach((factory) => {
11
+ checkRecursiveDependencies(factory);
12
+ checkMissingDependencies(factory, this.factories);
13
+ });
14
+ }
15
+
16
+ public async get<T>(key: ServiceKey<T>): Promise<T> {
17
+ const factory = this.factories.find((factory: GenericFactory) => {
18
+ return isSuitable(key, factory);
19
+ });
20
+
21
+ // Check if a factory to supply the requested key was not found
22
+ if (!factory) {
23
+ throw new Error(`Could not find a suitable factory for ${key.name}`);
24
+ }
25
+
26
+ // Resolve all dependencies first
27
+ const dependencies = await Promise.all(
28
+ factory.dependsOn.map((dependencyKey: ServiceKey<unknown>) => {
29
+ return this.get(dependencyKey);
30
+ }),
31
+ );
32
+
33
+ // Call the factory to retrieve the dependency
34
+ return factory.initialize(...dependencies);
35
+ }
36
+
37
+ /**
38
+ * Disposes of service factories within the specified scope or all factories if no scope is provided.
39
+ *
40
+ * This method is useful for cleaning up resources and instances held by service factories,
41
+ * such as singleton factories, as they may hold database connections or other resources that need to be released.
42
+ *
43
+ * @param {ServiceScope} [scope] The scope to filter the factories to be disposed.
44
+ * If not provided, all factories are disposed of.
45
+ * @return {void} No return value.
46
+ */
47
+ public dispose(scope?: ServiceScope) {
48
+ const factories = scope
49
+ ? this.factories.filter((f) => f.scope === scope)
50
+ : this.factories;
51
+
52
+ factories.forEach((factory) => factory.dispose?.());
53
+ }
54
+
55
+ /**
56
+ * Creates a new ServiceModule instance by aggregating and deduplicating a list of
57
+ * ServiceModule or GenericFactory instances.
58
+ * If multiple factories provide the same
59
+ * ServiceKey, the last one in the list takes precedence.
60
+ *
61
+ * @param {Array<ServiceModule | GenericFactory>} entries - An array of ServiceModule or GenericFactory
62
+ * instances to be processed into a single ServiceModule.
63
+ * @return {ServiceModule} A new ServiceModule containing the deduplicated factories.
64
+ */
65
+ static from(entries: (ServiceModule | GenericFactory)[]): ServiceModule {
66
+ // Flatten entries and keep only the last factory for each ServiceKey
67
+ const flattened = entries.flatMap((e) =>
68
+ e instanceof ServiceModule ? e.factories : [e],
69
+ );
70
+
71
+ const byKey = new Map<symbol, GenericFactory>();
72
+ // Later factories overwrite earlier ones (last-wins)
73
+ for (const f of flattened) {
74
+ byKey.set(f.provides.symbol, f);
75
+ }
76
+
77
+ return new ServiceModule(Array.from(byKey.values()));
78
+ }
79
+ }
80
+
81
+ function checkRecursiveDependencies(factory: GenericFactory) {
82
+ const recursive = factory.dependsOn.some((dependencyKey) => {
83
+ return dependencyKey === factory.provides;
84
+ });
85
+
86
+ if (recursive) {
87
+ throw new Error(
88
+ 'Recursive dependency detected on: ' + factory.provides.name,
89
+ );
90
+ }
91
+ }
92
+
93
+ function checkMissingDependencies(
94
+ factory: GenericFactory,
95
+ factories: GenericFactory[],
96
+ ) {
97
+ const missingDependencies = factory.dependsOn.filter(
98
+ (dependencyKey: GenericKey) => {
99
+ return !isRegistered(dependencyKey, factories);
100
+ },
101
+ );
102
+ if (missingDependencies.length === 0) {
103
+ return;
104
+ }
105
+
106
+ const dependencyList = missingDependencies
107
+ .map((dependencyKey) => ` -> ${dependencyKey.name}`)
108
+ .join('\n');
109
+ throw new Error(
110
+ `${factory.provides.name} will fail because it depends on:\n ${dependencyList}`,
111
+ );
112
+ }
113
+
114
+ function isRegistered(key: GenericKey, factories: GenericFactory[]) {
115
+ return factories.some((factory) => factory.provides?.symbol === key?.symbol);
116
+ }
117
+
118
+ function isSuitable<T, D extends readonly ServiceKey<any>[]>(
119
+ key: ServiceKey<T>,
120
+ factory: ServiceFactory<any, D>,
121
+ ): factory is ServiceFactory<T, D> {
122
+ return factory?.provides?.symbol === key?.symbol;
123
+ }
@@ -1,7 +1,7 @@
1
- export class ServiceScope {
2
- readonly symbol: symbol;
3
-
4
- constructor(readonly name: string) {
5
- this.symbol = Symbol(name);
6
- }
7
- }
1
+ export class ServiceScope {
2
+ readonly symbol: symbol;
3
+
4
+ constructor(readonly name: string) {
5
+ this.symbol = Symbol(name);
6
+ }
7
+ }
package/src/utils.ts CHANGED
@@ -1,5 +1,5 @@
1
- import { ServiceModule } from './ServiceModule';
2
- import { ServiceKey } from './ServiceKey';
1
+ import { ServiceModule } from './serviceModule';
2
+ import { ServiceKey } from './serviceKey';
3
3
 
4
4
  export interface DotGraphOptions {
5
5
  /** Graph direction: 'TB' (top-bottom), 'LR' (left-right), 'BT' (bottom-top), 'RL' (right-left) */
@@ -1 +0,0 @@
1
- {"version":3,"file":"ServiceScope.d.ts","sourceRoot":"","sources":["../src/ServiceScope.ts"],"names":[],"mappings":"AAAA,qBAAa,YAAY;IAGX,QAAQ,CAAC,IAAI,EAAE,MAAM;IAFjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBAEH,IAAI,EAAE,MAAM;CAGlC"}
@@ -1 +0,0 @@
1
- {"version":3,"file":"ServiceScope.js","sourceRoot":"","sources":["../src/ServiceScope.ts"],"names":[],"mappings":";;;AAAA,MAAa,YAAY;IAGvB,YAAqB,IAAY;QAAZ,SAAI,GAAJ,IAAI,CAAQ;QAC/B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;CACF;AAND,oCAMC"}
File without changes