@ivlev-dev/silent-di 0.0.0-stage → 0.1.2

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/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 ivlev-dev
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md CHANGED
@@ -1,3 +1,182 @@
1
- # Temporary Holding Version
1
+ # @ivlev-dev/silent-di
2
2
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
3
+ Асинхронный контейнер зависимостей без декораторов: токены, скоупы, кеш промисов и compile-time привязка интерфейсов к реализациям.
4
+
5
+ [![npm version](https://img.shields.io/npm/v/@ivlev-dev/silent-di)](https://www.npmjs.com/package/@ivlev-dev/silent-di)
6
+ [![license](https://img.shields.io/npm/l/@ivlev-dev/silent-di)](https://github.com/ivlev-dev/silent-framework/blob/main/LICENSE)
7
+ [![node](https://img.shields.io/node/v/@ivlev-dev/silent-di)](https://www.npmjs.com/package/@ivlev-dev/silent-di)
8
+
9
+ ## Возможности
10
+
11
+ - DI без декораторов: токены-символы и классы как токены, зависимости как обычные параметры конструктора.
12
+ - Автопоиск реализаций: компилятор строит индекс `интерфейс → реализация` и подставляет единственную реализацию на этапе компиляции.
13
+ - Скоупы: `singleton`, `scoped`, `transient` и дочерние контейнеры с наследованием привязок.
14
+ - Асинхронное разрешение: `resolve` всегда возвращает `Promise`, кеш промисов разделяет параллельные вызовы.
15
+ - Детектор циклов: `CircularDependencyError` с путём из токенов.
16
+ - Точечное управление: `peek`, `has`, `clearCache(token?)`, `onDispose`-хуки, рекурсивный `dispose`.
17
+
18
+ ## Установка
19
+
20
+ ```bash
21
+ pnpm add @ivlev-dev/silent-di
22
+ ```
23
+
24
+ ```bash
25
+ npm install @ivlev-dev/silent-di
26
+ ```
27
+
28
+ ```bash
29
+ yarn add @ivlev-dev/silent-di
30
+ ```
31
+
32
+ Требуется Node.js >= 22. Пакет ESM-only (`type: "module"`).
33
+
34
+ ## Быстрый старт
35
+
36
+ ```ts
37
+ import { container, createToken } from "@ivlev-dev/silent-di";
38
+
39
+ const token = createToken<string>("config");
40
+
41
+ container.bind(token, () => "hello");
42
+
43
+ const value = await container.resolve<string>(token);
44
+
45
+ container.dispose();
46
+ ```
47
+
48
+ `bind` принимает фабрику в виде функции, класса или константы; по умолчанию привязка — `singleton`. `dispose()` рекурсивно очищает контейнер и все дочерние скоупы.
49
+
50
+ ## Интерфейсы и автопоиск
51
+
52
+ Рантайм работает с токенами — `Symbol` с phantom-параметром типа. Токен создаётся функцией `createToken`, класс может выступать токеном напрямую, декораторы не нужны:
53
+
54
+ ```ts
55
+ import type { Store } from "./store.types";
56
+
57
+ export class MemoryStore implements Store {}
58
+ ```
59
+
60
+ Сканер индекса собирает отображение `интерфейс → список реализаций`. При компиляции конструктора, принимающего интерфейс через `import type`, подставляется единственная найденная реализация — её класс становится токеном:
61
+
62
+ ```ts
63
+ import type { Store } from "./store.types";
64
+
65
+ export class ViewModel {
66
+ constructor(private readonly store: Store) {}
67
+ }
68
+ ```
69
+
70
+ Чтобы автопоиск сработал, интерфейс нужно импортировать как `import type`. В рантайме компилятор оборачивает классы через статический метод по символу `DI_CREATE` (`Symbol.for("silent.di.create")`) и передаёт туда контейнер для разрешения зависимостей.
71
+
72
+ Класс без явной привязки при `resolve` автоматически регистрируется как синглтон в контейнере, с которого началось разрешение:
73
+
74
+ ```ts
75
+ import { Container } from "@ivlev-dev/silent-di";
76
+
77
+ class Service {}
78
+
79
+ const root = new Container("root");
80
+ const service = await root.resolve(Service);
81
+ root.has(Service);
82
+ ```
83
+
84
+ Если интерфейс имеет более одной реализации, используйте явный `bind`.
85
+
86
+ ## Скоупы
87
+
88
+ Привязки наследуются: скоуп, созданный через `createScope(name?)`, разрешает привязки родителя, а `dispose` скоупа не затрагивает родителя.
89
+
90
+ ```ts
91
+ import { Container, createToken } from "@ivlev-dev/silent-di";
92
+
93
+ const root = new Container("root");
94
+
95
+ const singletonToken = createToken<object>("singleton");
96
+ const scopedToken = createToken<object>("scoped");
97
+ const transientToken = createToken<object>("transient");
98
+
99
+ root.bind(singletonToken, () => ({}));
100
+ root.bind(scopedToken, () => ({})).inScopedScope();
101
+ root.bind(transientToken, () => ({})).inTransientScope();
102
+
103
+ const scope = root.createScope("request");
104
+
105
+ const singletonA = await scope.resolve(singletonToken);
106
+ const singletonB = await root.resolve(singletonToken);
107
+
108
+ const scopedA = await scope.resolve(scopedToken);
109
+ const scopedB = await scope.resolve(scopedToken);
110
+
111
+ const transientA = await root.resolve(transientToken);
112
+ const transientB = await root.resolve(transientToken);
113
+ ```
114
+
115
+ - `singleton` — экземпляр кешируется в контейнере-владельце привязки и разделяется между всеми скоупами (`singletonA === singletonB`).
116
+ - `scoped` — экземпляр кешируется в контейнере, с которого начался `resolve` (`scopedA === scopedB` внутри одного скоупа, но не между скоупами).
117
+ - `transient` — каждый последовательный `resolve` создаёт новый экземпляр; параллельные вызовы до завершения разрешения разделяют один промис.
118
+
119
+ ## Ошибки и защита
120
+
121
+ - `CircularDependencyError` — выбрасывается при циклической зависимости; поле `path` содержит токены в порядке обхода.
122
+ - Отсутствующая привязка — `resolve` неизвестного токена выбрасывает ошибку `Async DI: no binding registered for token ...`.
123
+ - После `dispose()` — `resolve` выбрасывает ошибку, `has` возвращает `false`, `peek` возвращает `undefined`, повторный `dispose` — no-op.
124
+ - `resolve(undefined)` — выбрасывает ошибку `Async DI: resolve<T>() must be transformed by silentwire before runtime`.
125
+ - При ошибке фабрики кеш токена очищается, следующий `resolve` повторяет попытку.
126
+ - `clearCache()` без аргумента сбрасывает кеш текущего контейнера и всех потомков; `clearCache(token)` — только один токен.
127
+
128
+ ```ts
129
+ import { CircularDependencyError, Container, createToken } from "@ivlev-dev/silent-di";
130
+
131
+ const root = new Container("root");
132
+ const token = createToken<never>("parent");
133
+
134
+ const scope = root.createScope("loop");
135
+ scope.bind(token, (c: Container) => c.resolve(token));
136
+
137
+ try {
138
+ await scope.resolve(token);
139
+ } catch (error) {
140
+ if (error instanceof CircularDependencyError) {
141
+ console.log(error.path.length);
142
+ }
143
+ }
144
+ ```
145
+
146
+ ## API
147
+
148
+ | Символ | Назначение |
149
+ | --- | --- |
150
+ | `Container` | Асинхронный контейнер: `bind`, `resolve`, `createScope`, `peek`, `has`, `clearCache`, `onDispose`, `dispose` |
151
+ | `container` | Глобальный корневой экземпляр `Container("root")` |
152
+ | `createToken` | Создаёт типизированный токен (`symbol` c phantom-типом `T`) |
153
+ | `Token` | Тип токена: `symbol` c phantom-параметром `T` |
154
+ | `DI_CREATE` | Рантайм-символ `Symbol.for("silent.di.create")` для инстанциирования классов компилятором |
155
+ | `CircularDependencyError` | Ошибка циклической зависимости с полем `path` |
156
+ | `ScopeName` | Тип скоупа: `"singleton"`, `"transient"`, `"scoped"` |
157
+ | `Factory` | Фабрика: `(container: Container) => T | Promise<T>` |
158
+ | `Binding` | Привязка: `factory` + `scope` |
159
+ | `BindingBuilder` | Строитель скоупа привязки: `inSingletonScope`, `inTransientScope`, `inScopedScope` |
160
+
161
+ Подробнее — в [справочнике API](https://github.com/ivlev-dev/silent-framework/blob/main/docs/api/di.md).
162
+
163
+ ## Ограничения и совместимость
164
+
165
+ - ESM-only: экспорт только через `import` (`"type": "module"`).
166
+ - Node.js >= 22.
167
+ - Синхронных вызовов нет: `resolve` всегда возвращает `Promise`.
168
+ - Интерфейс должен иметь ровно одну реализацию в индексе; иначе — явный `bind`.
169
+ - Сложные re-export и generic-типы в DI требуют ручной привязки.
170
+ - Автопоиск работает только через компилятор Silent Framework; рантайм сам по себе резолвит только токены и классы.
171
+ - Глобальный `container` один на процесс; для изоляции используйте дочерние скоупы или собственный `Container`.
172
+
173
+ ## Ссылки
174
+
175
+ - Репозиторий: https://github.com/ivlev-dev/silent-framework
176
+ - Документация API: https://github.com/ivlev-dev/silent-framework/blob/main/docs/api/di.md
177
+ - CHANGELOG: https://github.com/ivlev-dev/silent-framework/blob/main/CHANGELOG.md
178
+ - Issues: https://github.com/ivlev-dev/silent-framework/issues
179
+
180
+ ---
181
+
182
+ MIT © ivlev-dev
@@ -0,0 +1,31 @@
1
+ import type { BindingBuilder } from "./types.js";
2
+ export declare class CircularDependencyError extends Error {
3
+ readonly path: unknown[];
4
+ constructor(path: readonly unknown[]);
5
+ }
6
+ export declare class Container {
7
+ readonly name: string;
8
+ private parent?;
9
+ private children;
10
+ private bindings;
11
+ private implicitTokens;
12
+ private cache;
13
+ private resolved;
14
+ private resolving;
15
+ private disposeHooks;
16
+ private disposed;
17
+ constructor(name?: string, parent?: Container);
18
+ bind<T = unknown>(token: unknown, factory?: unknown): BindingBuilder;
19
+ createScope(name?: string): Container;
20
+ resolve<T = unknown>(token: unknown): Promise<T>;
21
+ peek<T = unknown>(token: unknown): T | undefined;
22
+ has(token: unknown): boolean;
23
+ clearCache(token?: unknown): void;
24
+ onDispose(fn: () => void): void;
25
+ dispose(): void;
26
+ private findBindingWithOwner;
27
+ private findExplicitWithOwner;
28
+ private findImplicitWithOwner;
29
+ }
30
+ export declare const container: Container;
31
+ //# sourceMappingURL=container.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"container.d.ts","sourceRoot":"","sources":["../src/container.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAW,cAAc,EAAsB,MAAM,YAAY,CAAC;AAM9E,qBAAa,uBAAwB,SAAQ,KAAK;IAChD,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC;IAEzB,YAAY,IAAI,EAAE,SAAS,OAAO,EAAE,EAInC;CACF;AAuCD,qBAAa,SAAS;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,OAAO,CAAC,MAAM,CAAC,CAAY;IAC3B,OAAO,CAAC,QAAQ,CAAwB;IACxC,OAAO,CAAC,QAAQ,CAAwC;IACxD,OAAO,CAAC,cAAc,CAAsB;IAC5C,OAAO,CAAC,KAAK,CAAwC;IACrD,OAAO,CAAC,QAAQ,CAA+B;IAC/C,OAAO,CAAC,SAAS,CAA+B;IAChD,OAAO,CAAC,YAAY,CAAyB;IAC7C,OAAO,CAAC,QAAQ,CAAS;IAEzB,YAAY,IAAI,SAAS,EAAE,MAAM,CAAC,EAAE,SAAS,EAK5C;IAED,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,cAAc,CAuBnE;IAED,WAAW,CAAC,IAAI,SAA2B,GAAG,SAAS,CAItD;IAED,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,CAgF/C;IAED,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE,OAAO,GAAG,CAAC,GAAG,SAAS,CAU/C;IAED,GAAG,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAE3B;IAED,UAAU,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,IAAI,CAahC;IAED,SAAS,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI,CAE9B;IAED,OAAO,IAAI,IAAI,CAoBd;IAED,OAAO,CAAC,oBAAoB;IAI5B,OAAO,CAAC,qBAAqB;IAQ7B,OAAO,CAAC,qBAAqB;CAS9B;AAED,eAAO,MAAM,SAAS,WAAwB,CAAC"}
@@ -0,0 +1,225 @@
1
+ import { DI_CREATE } from "./token.js";
2
+ export class CircularDependencyError extends Error {
3
+ path;
4
+ constructor(path) {
5
+ super(`Circular dependency detected: ${path.map(String).join(" -> ")}`);
6
+ this.name = "CircularDependencyError";
7
+ this.path = [...path];
8
+ }
9
+ }
10
+ function isFunctionValue(value) {
11
+ return typeof value === "function";
12
+ }
13
+ function isClassSource(fn) {
14
+ return /^class\b/.test(fn.toString().trim());
15
+ }
16
+ function toFactory(factory) {
17
+ if (factory === undefined) {
18
+ return async () => undefined;
19
+ }
20
+ if (!isFunctionValue(factory)) {
21
+ return async () => factory;
22
+ }
23
+ if (!isClassSource(factory)) {
24
+ return async (container) => factory(container);
25
+ }
26
+ return async (container) => {
27
+ const create = factory[DI_CREATE];
28
+ if (typeof create === "function") {
29
+ return create.call(factory, container);
30
+ }
31
+ return new factory();
32
+ };
33
+ }
34
+ function toFallbackFactory(ctor) {
35
+ return async (container) => {
36
+ const create = ctor[DI_CREATE];
37
+ if (typeof create === "function") {
38
+ return create.call(ctor, container);
39
+ }
40
+ return new ctor();
41
+ };
42
+ }
43
+ export class Container {
44
+ name;
45
+ parent;
46
+ children = new Set();
47
+ bindings = new Map();
48
+ implicitTokens = new Set();
49
+ cache = new Map();
50
+ resolved = new Map();
51
+ resolving = new Map();
52
+ disposeHooks = [];
53
+ disposed = false;
54
+ constructor(name = "root", parent) {
55
+ this.name = name;
56
+ if (parent !== undefined) {
57
+ this.parent = parent;
58
+ }
59
+ }
60
+ bind(token, factory) {
61
+ const binding = {
62
+ factory: toFactory(factory),
63
+ scope: "singleton",
64
+ };
65
+ this.bindings.set(token, binding);
66
+ this.implicitTokens.delete(token);
67
+ this.clearCache(token);
68
+ const changeScope = (scope) => {
69
+ if (binding.scope !== scope) {
70
+ binding.scope = scope;
71
+ this.clearCache(token);
72
+ }
73
+ return builder;
74
+ };
75
+ const builder = {
76
+ inSingletonScope: () => changeScope("singleton"),
77
+ inTransientScope: () => changeScope("transient"),
78
+ inScopedScope: () => changeScope("scoped"),
79
+ };
80
+ return builder;
81
+ }
82
+ createScope(name = `scope:${Math.random()}`) {
83
+ const scope = new Container(name, this);
84
+ this.children.add(scope);
85
+ return scope;
86
+ }
87
+ resolve(token) {
88
+ if (this.disposed) {
89
+ throw new Error(`Container "${this.name}" has been disposed`);
90
+ }
91
+ if (token === undefined) {
92
+ throw new Error("Async DI: resolve<T>() must be transformed by silentwire before runtime");
93
+ }
94
+ const found = this.findBindingWithOwner(token);
95
+ if (found === undefined && isFunctionValue(token)) {
96
+ this.bindings.set(token, {
97
+ factory: toFallbackFactory(token),
98
+ scope: "singleton",
99
+ });
100
+ this.implicitTokens.add(token);
101
+ return this.resolve(token);
102
+ }
103
+ if (found === undefined) {
104
+ throw new Error(`Async DI: no binding registered for token ${String(token)}`);
105
+ }
106
+ const { binding, owner } = found;
107
+ const cacheContainer = binding.scope === "singleton" ? owner : this;
108
+ const cached = cacheContainer.cache.get(token);
109
+ if (cached !== undefined) {
110
+ return cached;
111
+ }
112
+ if (cacheContainer.resolving.has(token)) {
113
+ throw new CircularDependencyError([...cacheContainer.resolving.keys()]);
114
+ }
115
+ const marker = {};
116
+ cacheContainer.resolving.set(token, marker);
117
+ const instantiate = async () => {
118
+ try {
119
+ return await binding.factory(cacheContainer);
120
+ }
121
+ finally {
122
+ if (cacheContainer.resolving.get(token) === marker) {
123
+ cacheContainer.resolving.delete(token);
124
+ }
125
+ }
126
+ };
127
+ const promise = instantiate().catch((error) => {
128
+ if (cacheContainer.cache.get(token) === promise) {
129
+ cacheContainer.cache.delete(token);
130
+ }
131
+ throw error;
132
+ });
133
+ cacheContainer.cache.set(token, promise);
134
+ void promise.then((value) => {
135
+ if (binding.scope !== "transient" && cacheContainer.cache.get(token) === promise) {
136
+ cacheContainer.resolved.set(token, value);
137
+ }
138
+ }, () => {
139
+ if (cacheContainer.cache.get(token) === promise) {
140
+ cacheContainer.resolved.delete(token);
141
+ }
142
+ });
143
+ if (binding.scope === "transient") {
144
+ void promise.finally(() => {
145
+ if (cacheContainer.cache.get(token) === promise) {
146
+ cacheContainer.cache.delete(token);
147
+ }
148
+ }).catch(() => undefined);
149
+ }
150
+ return promise;
151
+ }
152
+ peek(token) {
153
+ const found = this.findBindingWithOwner(token);
154
+ if (found === undefined) {
155
+ return undefined;
156
+ }
157
+ const cacheContainer = found.binding.scope === "singleton" ? found.owner : this;
158
+ if (!cacheContainer.resolved.has(token)) {
159
+ return undefined;
160
+ }
161
+ return cacheContainer.resolved.get(token);
162
+ }
163
+ has(token) {
164
+ return this.findBindingWithOwner(token) !== undefined;
165
+ }
166
+ clearCache(token) {
167
+ if (token === undefined) {
168
+ this.cache.clear();
169
+ this.resolved.clear();
170
+ this.resolving.clear();
171
+ }
172
+ else {
173
+ this.cache.delete(token);
174
+ this.resolved.delete(token);
175
+ this.resolving.delete(token);
176
+ }
177
+ for (const child of [...this.children]) {
178
+ child.clearCache(token);
179
+ }
180
+ }
181
+ onDispose(fn) {
182
+ this.disposeHooks.push(fn);
183
+ }
184
+ dispose() {
185
+ if (this.disposed) {
186
+ return;
187
+ }
188
+ this.disposed = true;
189
+ const hooks = [...this.disposeHooks];
190
+ this.disposeHooks.length = 0;
191
+ for (const hook of hooks) {
192
+ hook();
193
+ }
194
+ this.clearCache();
195
+ this.bindings.clear();
196
+ this.implicitTokens.clear();
197
+ const children = [...this.children];
198
+ for (const child of children) {
199
+ child.dispose();
200
+ }
201
+ this.children.clear();
202
+ this.parent?.children.delete(this);
203
+ }
204
+ findBindingWithOwner(token) {
205
+ return this.findExplicitWithOwner(token) ?? this.findImplicitWithOwner(token);
206
+ }
207
+ findExplicitWithOwner(token) {
208
+ const binding = this.bindings.get(token);
209
+ if (binding !== undefined && !this.implicitTokens.has(token)) {
210
+ return { binding, owner: this };
211
+ }
212
+ return this.parent?.findExplicitWithOwner(token);
213
+ }
214
+ findImplicitWithOwner(token) {
215
+ if (this.implicitTokens.has(token)) {
216
+ const binding = this.bindings.get(token);
217
+ if (binding !== undefined) {
218
+ return { binding, owner: this };
219
+ }
220
+ }
221
+ return this.parent?.findImplicitWithOwner(token);
222
+ }
223
+ }
224
+ export const container = new Container("root");
225
+ //# sourceMappingURL=container.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"container.js","sourceRoot":"","sources":["../src/container.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,4 @@
1
+ export * from "./token.js";
2
+ export * from "./types.js";
3
+ export * from "./container.js";
4
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC"}
package/dist/index.js ADDED
@@ -0,0 +1,4 @@
1
+ export * from "./token.js";
2
+ export * from "./types.js";
3
+ export * from "./container.js";
4
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC"}
@@ -0,0 +1,6 @@
1
+ export declare const DI_CREATE: unique symbol;
2
+ export type Token<T> = symbol & {
3
+ readonly __type?: T;
4
+ };
5
+ export declare function createToken<T>(name: string): Token<T>;
6
+ //# sourceMappingURL=token.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"token.d.ts","sourceRoot":"","sources":["../src/token.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,SAAS,EAAE,OAAO,MAAuC,CAAC;AAEvE,MAAM,MAAM,KAAK,CAAC,CAAC,IAAI,MAAM,GAAG;IAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;CAAE,CAAC;AAExD,wBAAgB,WAAW,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAErD"}
package/dist/token.js ADDED
@@ -0,0 +1,5 @@
1
+ export const DI_CREATE = Symbol.for("silent.di.create");
2
+ export function createToken(name) {
3
+ return Symbol(name);
4
+ }
5
+ //# sourceMappingURL=token.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"token.js","sourceRoot":"","sources":["../src/token.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,SAAS,GAAkB,MAAM,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;AAIvE,MAAM,UAAU,WAAW,CAAI,IAAY;IACzC,OAAO,MAAM,CAAC,IAAI,CAAa,CAAC;AAClC,CAAC"}
@@ -0,0 +1,13 @@
1
+ import type { Container } from "./container.js";
2
+ export type ScopeName = "singleton" | "transient" | "scoped";
3
+ export type Factory<T> = (container: Container) => T | Promise<T>;
4
+ export interface Binding<T = unknown> {
5
+ readonly factory: Factory<T>;
6
+ scope: ScopeName;
7
+ }
8
+ export interface BindingBuilder {
9
+ inSingletonScope(): BindingBuilder;
10
+ inTransientScope(): BindingBuilder;
11
+ inScopedScope(): BindingBuilder;
12
+ }
13
+ //# sourceMappingURL=types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,MAAM,MAAM,SAAS,GAAG,WAAW,GAAG,WAAW,GAAG,QAAQ,CAAC;AAE7D,MAAM,MAAM,OAAO,CAAC,CAAC,IAAI,CAAC,SAAS,EAAE,SAAS,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;AAElE,MAAM,WAAW,OAAO,CAAC,CAAC,GAAG,OAAO;IAClC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IAC7B,KAAK,EAAE,SAAS,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,gBAAgB,IAAI,cAAc,CAAC;IACnC,gBAAgB,IAAI,cAAc,CAAC;IACnC,aAAa,IAAI,cAAc,CAAC;CACjC"}
package/dist/types.js ADDED
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}
package/package.json CHANGED
@@ -1,6 +1,48 @@
1
1
  {
2
2
  "name": "@ivlev-dev/silent-di",
3
- "version": "0.0.0-stage",
4
- "stub": true,
5
- "description": "Temporary package placeholder for staged publishing"
3
+ "version": "0.1.2",
4
+ "type": "module",
5
+ "sideEffects": false,
6
+ "main": "./dist/index.js",
7
+ "types": "./dist/index.d.ts",
8
+ "exports": {
9
+ ".": {
10
+ "types": "./dist/index.d.ts",
11
+ "import": "./dist/index.js"
12
+ }
13
+ },
14
+ "files": [
15
+ "dist"
16
+ ],
17
+ "devDependencies": {
18
+ "typescript": "^7.0.2",
19
+ "vitest": "^5.1.0"
20
+ },
21
+ "license": "MIT",
22
+ "repository": {
23
+ "type": "git",
24
+ "url": "git+https://github.com/ivlev-dev/silent-framework.git"
25
+ },
26
+ "homepage": "https://github.com/ivlev-dev/silent-framework#readme",
27
+ "bugs": {
28
+ "url": "https://github.com/ivlev-dev/silent-framework/issues"
29
+ },
30
+ "engines": {
31
+ "node": ">=22"
32
+ },
33
+ "publishConfig": {
34
+ "access": "public"
35
+ },
36
+ "description": "Async dependency injection container with scopes and compile-time interface wiring",
37
+ "keywords": [
38
+ "dependency-injection",
39
+ "di",
40
+ "scopes",
41
+ "typescript"
42
+ ],
43
+ "scripts": {
44
+ "build": "tsc -p tsconfig.json",
45
+ "typecheck": "tsc --noEmit -p tsconfig.json",
46
+ "test": "vitest run"
47
+ }
6
48
  }