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.
- package/dist/index.d.ts +5 -5
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +21 -21
- package/dist/index.js.map +1 -1
- package/dist/serviceFactory.d.ts +35 -35
- package/dist/serviceFactory.d.ts.map +1 -1
- package/dist/serviceFactory.js +53 -53
- package/dist/serviceFactory.js.map +1 -1
- package/dist/serviceKey.d.ts +6 -6
- package/dist/serviceKey.d.ts.map +1 -1
- package/dist/serviceKey.js +12 -12
- package/dist/serviceKey.js.map +1 -1
- package/dist/serviceModule.d.ts +33 -33
- package/dist/serviceModule.d.ts.map +1 -1
- package/dist/serviceModule.js +103 -103
- package/dist/serviceModule.js.map +1 -1
- package/dist/{ServiceScope.d.ts → serviceScope.d.ts} +6 -6
- package/dist/serviceScope.d.ts.map +1 -0
- package/dist/{ServiceScope.js → serviceScope.js} +11 -11
- package/dist/serviceScope.js.map +1 -0
- package/dist/utils.d.ts +33 -33
- package/dist/utils.js +114 -115
- package/dist/utils.js.map +1 -1
- package/package.json +3 -2
- package/src/index.ts +5 -5
- package/src/{ServiceFactory.ts → serviceFactory.ts} +83 -83
- package/src/{ServiceModule.ts → serviceModule.ts} +123 -123
- package/src/{ServiceScope.ts → serviceScope.ts} +7 -7
- package/src/utils.ts +2 -2
- package/dist/ServiceScope.d.ts.map +0 -1
- package/dist/ServiceScope.js.map +0 -1
- /package/src/{ServiceKey.ts → serviceKey.ts} +0 -0
|
@@ -1,123 +1,123 @@
|
|
|
1
|
-
import { ServiceKey } from './
|
|
2
|
-
import { ServiceFactory } from './
|
|
3
|
-
import { ServiceScope } from './
|
|
4
|
-
|
|
5
|
-
type GenericFactory = ServiceFactory<
|
|
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 './
|
|
2
|
-
import { ServiceKey } from './
|
|
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"}
|
package/dist/ServiceScope.js.map
DELETED
|
@@ -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
|