@needle-di/core 0.7.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Dirk Luijk
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,83 @@
+# Needle DI 💉
+
+> A lightweight, type-safe Dependency Injection (DI) library for JavaScript and TypeScript projects.
+
+[![NPM version](http://img.shields.io/npm/v/needle-di.svg?style=flat-square)](https://www.npmjs.com/package/needle-di)
+[![NPM downloads](http://img.shields.io/npm/dm/needle-di.svg?style=flat-square)](https://www.npmjs.com/package/needle-di)
+[![Build status](https://github.com/dirkluijk/needle-di/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/dirkluijk/needle-di/actions/workflows/main.yml)
+
+Needle DI is a lightweight, TypeScript-first library for dependency injection (DI). It is designed to be both easy to use and highly efficient.
+
+### Key Features
+
+- Stand-alone: No additional dependencies required
+- Intended for both JavaScript-only and TypeScript projects
+- Supports [tree-shakeable injection tokens](https://needle-di.io/advanced/tree-shaking.html): optimize your builds for production.
+- Inspired by [Angular](https://angular.dev/) and [InversifyJS](https://github.com/inversify/InversifyJS), familiar to developers coming from these frameworks.
+- Uses native [ECMAScript TC39 decorators](https://github.com/tc39/proposal-decorators) (currently stage 3)
+- No need for `experimentalDecorators` and `emitDecoratorMetadata`
+- No reflection libraries needed, like `reflect-metadata` or other reflection mechanisms.
+
+## Basic example
+
+Here’s a simple example using constructor injection to inject one service into another.
+
+```typescript
+import { injectable, inject } from "needle-di";
+
+@injectable()
+class FooService {}
+
+@injectable()
+class BarService {
+  constructor(private fooService = inject(FooService)) {}
+  //                  ^? Type will be inferred as `FooService`
+}
+```
+
+The `@injectable` decorator eliminates the need to manually register services. To construct the `BarService`, create a
+dependency injection container, and use the `container.get()` method:
+
+```typescript
+import { Container } from "needle-di";
+
+const container = new Container();
+const barService = container.get(BarService);
+//    ^? Type will be inferred as `BarService`
+```
+
+Check out the [docs](https://needle-di.io/concepts/binding.html) to learn more!
+
+## Installation
+
+```
+npm install --save needle-di
+```
+
+## Docs
+
+Check out our docs on [https://needle-di.io](https://needle-di.io/concepts/binding.html).
+
+## License
+
+License under the MIT License (MIT)
+
+Copyright (c) 2024 Dirk Luijk
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/container.d.ts

@@ -0,0 +1,92 @@
+import { type Token } from "./tokens.js";
+import { type Provider } from "./providers.js";
+export declare class Container {
+    private readonly providers;
+    private readonly singletons;
+    bindAll<A>(p1: Provider<A>): this;
+    bindAll<A, B>(p1: Provider<A>, p2: Provider<B>): this;
+    bindAll<A, B, C>(p1: Provider<A>, p2: Provider<B>, p3: Provider<C>): this;
+    bindAll<A, B, C, D>(p1: Provider<A>, p2: Provider<B>, p3: Provider<C>, p4: Provider<D>): this;
+    bindAll<A, B, C, D, E>(p1: Provider<A>, p2: Provider<B>, p3: Provider<C>, p4: Provider<D>, p5: Provider<E>): this;
+    bindAll<A, B, C, D, E, F>(p1: Provider<A>, p2: Provider<B>, p3: Provider<C>, p4: Provider<D>, p5: Provider<E>, p6: Provider<F>): this;
+    bindAll<A, B, C, D, E, F, G>(p1: Provider<A>, p2: Provider<B>, p3: Provider<C>, p4: Provider<D>, p5: Provider<E>, p6: Provider<F>, p7: Provider<G>): this;
+    bindAll<A, B, C, D, E, F, G, H>(p1: Provider<A>, p2: Provider<B>, p3: Provider<C>, p4: Provider<D>, p5: Provider<E>, p6: Provider<F>, p7: Provider<G>, p8: Provider<H>): this;
+    bindAll<A, B, C, D, E, F, G, H, I>(p1: Provider<A>, p2: Provider<B>, p3: Provider<C>, p4: Provider<D>, p5: Provider<E>, p6: Provider<F>, p7: Provider<G>, p8: Provider<H>, p9: Provider<I>): this;
+    bindAll<A, B, C, D, E, F, G, H, I>(p1: Provider<A>, p2: Provider<B>, p3: Provider<C>, p4: Provider<D>, p5: Provider<E>, p6: Provider<F>, p7: Provider<G>, p8: Provider<H>, p9: Provider<I>, ...providers: Provider<any>[]): this;
+    bind<T>(provider: Provider<T>): this;
+    get<T>(token: Token<T>, options: {
+        multi: true;
+    }): T[];
+    get<T>(token: Token<T>, options: {
+        optional: true;
+    }): T | undefined;
+    get<T>(token: Token<T>, options: {
+        multi: true;
+        optional: true;
+    }): T[] | undefined;
+    get<T>(token: Token<T>, options?: {
+        optional?: boolean;
+        multi?: boolean;
+    }): T;
+    getAsync<T>(token: Token<T>, options: {
+        multi: true;
+    }): Promise<T[]>;
+    getAsync<T>(token: Token<T>, options: {
+        optional: true;
+    }): Promise<T | undefined>;
+    getAsync<T>(token: Token<T>, options: {
+        multi: true;
+        optional: true;
+    }): Promise<T[] | undefined>;
+    getAsync<T>(token: Token<T>, options?: {
+        optional?: boolean;
+        multi?: boolean;
+    }): Promise<T>;
+    private construct;
+    private constructAsync;
+    private doConstructAsync;
+    private autoBindIfNeeded;
+    private existingProviderAlreadyProvided;
+}
+/**
+ * Injects a service within the current injection context, using the token provided.
+ */
+export declare function inject<T>(token: Token<T>, options: {
+    multi: true;
+}): T[];
+export declare function inject<T>(token: Token<T>, options: {
+    optional: true;
+}): T | undefined;
+export declare function inject<T>(token: Token<T>, options: {
+    multi: true;
+    optional: true;
+}): T[] | undefined;
+export declare function inject<T>(token: Token<T>, options?: {
+    optional?: boolean;
+    multi?: boolean;
+}): T;
+/**
+ * Injects a service asynchronously within the current injection context, using the token provided.
+ */
+export declare function injectAsync<T>(token: Token<T>, options: {
+    multi: true;
+}): Promise<T[]>;
+export declare function injectAsync<T>(token: Token<T>, options: {
+    optional: true;
+}): Promise<T | undefined>;
+export declare function injectAsync<T>(token: Token<T>, options: {
+    multi: true;
+    optional: true;
+}): Promise<T[] | undefined>;
+export declare function injectAsync<T>(token: Token<T>, options?: {
+    optional?: boolean;
+    multi?: boolean;
+}): Promise<T>;
+/**
+ * Bootstraps a new container and obtains a service using the provided token.
+ */
+export declare function bootstrap<T>(token: Token<T>): T;
+/**
+ * Bootstraps a new container and obtains a service asynchronously using the provided token.
+ */
+export declare function bootstrapAsync<T>(token: Token<T>): Promise<T>;

package/dist/container.js

@@ -0,0 +1,262 @@
+import { isClassToken, toString, isInjectionToken } from "./tokens.js";
+import { isClassProvider, isFactoryProvider, isConstructorProvider, isValueProvider, isAsyncFactoryProvider, isMultiProvider, isExistingProvider, } from "./providers.js";
+import { getInjectableTargets, isInjectable } from "./decorators.js";
+import { assertPresent, getParentClasses, windowedSlice } from "./utils.js";
+export class Container {
+    providers = new Map();
+    singletons = new Map();
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    bindAll(...providers) {
+        providers.forEach((it) => this.bind(it));
+        return this;
+    }
+    bind(provider) {
+        const token = isConstructorProvider(provider) ? provider : provider.provide;
+        const multi = isMultiProvider(provider);
+        if (isExistingProvider(provider) && provider.provide === provider.useExisting) {
+            throw Error(`The provider for token ${toString(token)} with "useExisting" cannot refer to itself.`);
+        }
+        if (!isExistingProvider(provider) && this.singletons.has(token)) {
+            throw Error(`Cannot bind a new provider for ${toString(token)}, since the existing provider was already constructed.`);
+        }
+        const existingProviders = this.providers.get(token) ?? [];
+        // ignore this provider if it was already provided as existingProvider
+        if (isExistingProvider(provider) &&
+            isMultiProvider(provider) &&
+            this.existingProviderAlreadyProvided(token, provider.useExisting)) {
+            return this;
+        }
+        if (multi && existingProviders.some((it) => !isMultiProvider(it))) {
+            throw Error(`Cannot bind ${toString(token)} as multi-provider, since there is already a provider which is not a multi-provider.`);
+        }
+        else if (!multi && existingProviders.some((it) => isMultiProvider(it))) {
+            if (!existingProviders.every(isExistingProvider)) {
+                throw Error(`Cannot bind ${toString(token)} as provider, since there are already provider(s) that are multi-providers.`);
+            }
+        }
+        this.providers.set(token, multi ? [...existingProviders, provider] : [provider]);
+        // inheritance support: also bind parent classes to their immediate child classes
+        if (isClassToken(token) && (isClassProvider(provider) || isConstructorProvider(provider))) {
+            windowedSlice([token, ...getParentClasses(token)]).forEach(([childClass, parentClass]) => {
+                const parentProvider = {
+                    provide: parentClass,
+                    useExisting: childClass,
+                    multi: true,
+                };
+                const existingParentProviders = this.providers.get(parentClass) ?? [];
+                if (!this.existingProviderAlreadyProvided(parentClass, childClass)) {
+                    this.providers.set(parentClass, [...existingParentProviders, parentProvider]);
+                }
+            });
+        }
+        return this;
+    }
+    get(token, options) {
+        this.autoBindIfNeeded(token);
+        const optional = options?.optional ?? false;
+        const multi = options?.multi ?? false;
+        if (!this.providers.has(token)) {
+            if (optional) {
+                return undefined;
+            }
+            throw Error(`No provider(s) found for ${toString(token)}`);
+        }
+        const providers = assertPresent(this.providers.get(token));
+        if (!this.singletons.has(token)) {
+            if (providers.some(isAsyncFactoryProvider)) {
+                throw new AsyncProvidersInSyncInjectionContextError(token);
+            }
+            this.singletons.set(token, providers.flatMap((it) => this.construct(it, this)));
+        }
+        const singletons = assertPresent(this.singletons.get(token));
+        if (multi) {
+            return singletons;
+        }
+        else if (singletons.length > 1) {
+            throw Error(`Requesting a single value for ${toString(token)}, but multiple values were provided. ` +
+                `Consider passing "{ multi: true }" to inject all values, or adjust your bindings accordingly.`);
+        }
+        else {
+            return assertPresent(singletons.at(0));
+        }
+    }
+    async getAsync(token, options) {
+        this.autoBindIfNeeded(token);
+        const optional = options?.optional ?? false;
+        const multi = options?.multi ?? false;
+        if (!this.providers.has(token)) {
+            if (optional) {
+                return undefined;
+            }
+            throw Error(`No provider(s) found for ${toString(token)}`);
+        }
+        const existingProviders = this.providers.get(token) ?? [];
+        if (!this.singletons.has(token)) {
+            const values = await Promise.all(existingProviders.map((it) => this.constructAsync(it, this)));
+            this.singletons.set(token, values.flat());
+        }
+        const singletons = assertPresent(this.singletons.get(token));
+        if (multi) {
+            return Promise.all(singletons.map(promisify));
+        }
+        else if (singletons.length > 1) {
+            throw Error(`Requesting a single value for ${toString(token)}, but multiple values were provided. ` +
+                `Consider passing "{ multi: true }" to inject all values, or adjust your bindings accordingly.`);
+        }
+        else {
+            return promisify(singletons.at(0));
+        }
+    }
+    construct(provider, scope) {
+        const originalScope = currentScope;
+        try {
+            currentScope = scope;
+            return doConstruct(provider, scope);
+        }
+        finally {
+            currentScope = originalScope;
+        }
+    }
+    async constructAsync(provider, scope) {
+        const originalScope = currentScope;
+        try {
+            currentScope = scope;
+            return await this.doConstructAsync(provider, scope);
+        }
+        finally {
+            currentScope = originalScope;
+        }
+    }
+    async doConstructAsync(provider, scope) {
+        if (isAsyncFactoryProvider(provider)) {
+            return [await provider.useFactory()];
+        }
+        else if (isExistingProvider(provider)) {
+            return scope.getAsync(provider.useExisting, { multi: true });
+        }
+        else if (isClassProvider(provider) || isConstructorProvider(provider)) {
+            while (true) {
+                try {
+                    return doConstruct(provider, scope);
+                }
+                catch (error) {
+                    if (error instanceof AsyncProvidersInSyncInjectionContextError) {
+                        const values = await injectAsync(error.token, { multi: true, optional: true });
+                        if (values) {
+                            this.singletons.set(error.token, values);
+                        }
+                    }
+                    else {
+                        throw error;
+                    }
+                }
+            }
+        }
+        else {
+            return doConstruct(provider, scope);
+        }
+    }
+    autoBindIfNeeded(token) {
+        if (this.singletons.has(token)) {
+            return;
+        }
+        if (isClassToken(token) && isInjectable(token)) {
+            const targetClasses = getInjectableTargets(token);
+            targetClasses
+                .filter((targetClass) => !this.providers.has(targetClass))
+                .forEach((targetClass) => {
+                this.bind({
+                    provide: targetClass,
+                    useClass: targetClass,
+                    multi: true,
+                });
+            });
+        }
+        else if (!this.providers.has(token) && isInjectionToken(token) && token.options?.factory) {
+            const async = token.options.async;
+            if (!async) {
+                this.bind({
+                    provide: token,
+                    async: false,
+                    useFactory: token.options.factory,
+                });
+            }
+            else if (async) {
+                this.bind({
+                    provide: token,
+                    async: true,
+                    useFactory: token.options.factory,
+                });
+            }
+        }
+    }
+    existingProviderAlreadyProvided(token, existingToken) {
+        return (this.providers.get(token) ?? []).some((it) => isExistingProvider(it) && it.provide === token && it.useExisting === existingToken);
+    }
+}
+let currentScope = undefined;
+export function inject(token, options) {
+    if (currentScope === undefined) {
+        if (options?.optional)
+            return undefined;
+        throw new Error("You can only invoke inject() from the injection context");
+    }
+    return currentScope.get(token, options);
+}
+export async function injectAsync(token, options) {
+    if (currentScope === undefined) {
+        if (options?.optional)
+            return undefined;
+        throw new Error("You can only invoke injectAsync() from the injection context");
+    }
+    return currentScope.getAsync(token, options);
+}
+// see: https://github.com/tc39/proposal-promise-try
+async function promisify(value) {
+    return new Promise((resolve) => resolve(value));
+}
+function doConstruct(provider, scope) {
+    if (isConstructorProvider(provider)) {
+        return [new provider()];
+    }
+    else if (isClassProvider(provider)) {
+        return [new provider.useClass()];
+    }
+    else if (isValueProvider(provider)) {
+        return [provider.useValue];
+    }
+    else if (isFactoryProvider(provider)) {
+        return [provider.useFactory()];
+    }
+    else if (isAsyncFactoryProvider(provider)) {
+        throw Error("Invalid state");
+    }
+    else {
+        return scope.get(provider.useExisting, { multi: true });
+    }
+}
+/**
+ * Bootstraps a new container and obtains a service using the provided token.
+ */
+export function bootstrap(token) {
+    return new Container().get(token);
+}
+/**
+ * Bootstraps a new container and obtains a service asynchronously using the provided token.
+ */
+export function bootstrapAsync(token) {
+    return new Container().getAsync(token);
+}
+/**
+ * An error that occurs when an async provider is requested in a synchronous context.
+ *
+ * @internal
+ */
+class AsyncProvidersInSyncInjectionContextError extends Error {
+    token;
+    constructor(token) {
+        super(`Some providers for token ${toString(token)} are async, please use injectAsync() or container.getAsync() instead`);
+        this.token = token;
+    }
+}
+//# sourceMappingURL=container.js.map

package/dist/container.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"container.js","sourceRoot":"","sources":["../src/container.ts"],"names":[],"mappings":"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"}

package/dist/decorators.d.ts

@@ -0,0 +1,10 @@
+import { type AbstractClass, type Class } from "./utils.js";
+type ClassDecorator<C extends Class<unknown>> = (target: C) => C | void;
+export declare const injectableSymbol: unique symbol;
+export type InjectableClass<T = unknown> = (Class<T> | AbstractClass<T>) & {
+    [injectableSymbol]: Class<unknown>[];
+};
+export declare function injectable<C extends Class<unknown>>(): ClassDecorator<C>;
+export declare function isInjectable<T>(target: AbstractClass<T>): target is InjectableClass<T>;
+export declare function getInjectableTargets<T>(target: InjectableClass<T>): Class<unknown>[];
+export {};

package/dist/decorators.js

@@ -0,0 +1,31 @@
+import { getParentClasses } from "./utils.js";
+export const injectableSymbol = Symbol("injectable");
+export function injectable() {
+    return (target) => {
+        getParentClasses(target).forEach((parentClass) => {
+            if (!Object.getOwnPropertyDescriptor(parentClass, injectableSymbol)) {
+                Object.defineProperty(parentClass, injectableSymbol, {
+                    value: [target],
+                    writable: true,
+                    enumerable: false,
+                });
+            }
+            else {
+                const injectableParentClass = parentClass;
+                injectableParentClass[injectableSymbol] = [...injectableParentClass[injectableSymbol], target];
+            }
+        });
+        Object.defineProperty(target, injectableSymbol, {
+            value: [target],
+            writable: true,
+        });
+    };
+}
+export function isInjectable(target) {
+    // eslint-disable-next-line no-prototype-builtins
+    return target.hasOwnProperty(injectableSymbol);
+}
+export function getInjectableTargets(target) {
+    return target[injectableSymbol];
+}
+//# sourceMappingURL=decorators.js.map

package/dist/decorators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorators.js","sourceRoot":"","sources":["../src/decorators.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkC,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAK9E,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC;AAIrD,MAAM,UAAU,UAAU;IACxB,OAAO,CAAC,MAAM,EAAE,EAAE;QAChB,gBAAgB,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,EAAE;YAC/C,IAAI,CAAC,MAAM,CAAC,wBAAwB,CAAC,WAAW,EAAE,gBAAgB,CAAC,EAAE,CAAC;gBACpE,MAAM,CAAC,cAAc,CAAC,WAAW,EAAE,gBAAgB,EAAE;oBACnD,KAAK,EAAE,CAAC,MAAM,CAAC;oBACf,QAAQ,EAAE,IAAI;oBACd,UAAU,EAAE,KAAK;iBAClB,CAAC,CAAC;YACL,CAAC;iBAAM,CAAC;gBACN,MAAM,qBAAqB,GAAG,WAA8B,CAAC;gBAC7D,qBAAqB,CAAC,gBAAgB,CAAC,GAAG,CAAC,GAAG,qBAAqB,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC,CAAC;YACjG,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,gBAAgB,EAAE;YAC9C,KAAK,EAAE,CAAC,MAAM,CAAC;YACf,QAAQ,EAAE,IAAI;SACf,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,YAAY,CAAI,MAAwB;IACtD,iDAAiD;IACjD,OAAO,MAAM,CAAC,cAAc,CAAC,gBAAgB,CAAC,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAI,MAA0B;IAChE,OAAO,MAAM,CAAC,gBAAgB,CAAC,CAAC;AAClC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { inject, Container, bootstrap, bootstrapAsync, injectAsync } from "./container.js";
+export { injectable } from "./decorators.js";
+export type { FactoryProvider, ExistingProvider, Provider, ConstructorProvider, ClassProvider, ValueProvider, AsyncFactoryProvider, } from "./providers.js";
+export { InjectionToken } from "./tokens.js";
+export type { Token } from "./tokens.js";

package/dist/index.js

@@ -0,0 +1,4 @@
+export { inject, Container, bootstrap, bootstrapAsync, injectAsync } from "./container.js";
+export { injectable } from "./decorators.js";
+export { InjectionToken } from "./tokens.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC3F,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAU7C,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC"}

package/dist/providers.d.ts

@@ -0,0 +1,63 @@
+import type { Token } from "./tokens.js";
+import { type Class } from "./utils.js";
+/**
+ * A provider states how, for a given token, a service should be constructed.
+ */
+export type Provider<T> = ConstructorProvider<T> | ClassProvider<T> | ValueProvider<T> | FactoryProvider<T> | AsyncFactoryProvider<T> | ExistingProvider<T>;
+/**
+ * A constructor provider refers to a class constructor,
+ * which is the same class as the token itself.
+ */
+export type ConstructorProvider<T> = Class<T>;
+/**
+ * A class provider refers to a class constructor,
+ * which may be the same class as the token, or a subclass.
+ */
+export interface ClassProvider<T> {
+    provide: Token<T>;
+    useClass: Class<NoInfer<T>>;
+    multi?: true;
+}
+/**
+ * A value provider refers to a static value.
+ */
+export interface ValueProvider<T> {
+    provide: Token<T>;
+    useValue: T;
+    multi?: true;
+}
+/**
+ * A factory provider refers to a value which is lazily returned
+ * by a synchronous factory function.
+ */
+export interface FactoryProvider<T> {
+    provide: Token<T>;
+    async?: false;
+    multi?: true;
+    useFactory: () => NoInfer<T>;
+}
+/**
+ * An async factory provider refers to a value which is lazily returned
+ * by an asynchronous factory function.
+ */
+export interface AsyncFactoryProvider<T> {
+    provide: Token<T>;
+    async: true;
+    multi?: true;
+    useFactory: () => Promise<NoInfer<T>>;
+}
+/**
+ * An existing provider refers to a value provided by another provider.
+ */
+export interface ExistingProvider<T> {
+    provide: Token<T>;
+    useExisting: Token<T>;
+    multi?: boolean;
+}
+export declare function isConstructorProvider<T>(provider: Provider<T>): provider is ConstructorProvider<T>;
+export declare function isClassProvider<T>(provider: Provider<T>): provider is ClassProvider<T>;
+export declare function isValueProvider<T>(provider: Provider<T>): provider is ValueProvider<T>;
+export declare function isFactoryProvider<T>(provider: Provider<T>): provider is FactoryProvider<T>;
+export declare function isAsyncFactoryProvider<T>(provider: Provider<T>): provider is AsyncFactoryProvider<T>;
+export declare function isExistingProvider<T>(provider: Provider<T>): provider is ExistingProvider<T>;
+export declare function isMultiProvider<T>(provider: Provider<T>): boolean;

package/dist/providers.js

@@ -0,0 +1,23 @@
+import { isClassLike } from "./utils.js";
+export function isConstructorProvider(provider) {
+    return isClassLike(provider);
+}
+export function isClassProvider(provider) {
+    return "provide" in provider && "useClass" in provider;
+}
+export function isValueProvider(provider) {
+    return "provide" in provider && "useValue" in provider;
+}
+export function isFactoryProvider(provider) {
+    return "provide" in provider && "useFactory" in provider && !provider.async;
+}
+export function isAsyncFactoryProvider(provider) {
+    return "provide" in provider && "useFactory" in provider && provider.async === true;
+}
+export function isExistingProvider(provider) {
+    return "provide" in provider && "useExisting" in provider;
+}
+export function isMultiProvider(provider) {
+    return "provide" in provider && "multi" in provider && provider.multi === true;
+}
+//# sourceMappingURL=providers.js.map

package/dist/providers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"providers.js","sourceRoot":"","sources":["../src/providers.ts"],"names":[],"mappings":"AACA,OAAO,EAAc,WAAW,EAAE,MAAM,YAAY,CAAC;AAqErD,MAAM,UAAU,qBAAqB,CAAI,QAAqB;IAC5D,OAAO,WAAW,CAAC,QAAQ,CAAC,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,eAAe,CAAI,QAAqB;IACtD,OAAO,SAAS,IAAI,QAAQ,IAAI,UAAU,IAAI,QAAQ,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,eAAe,CAAI,QAAqB;IACtD,OAAO,SAAS,IAAI,QAAQ,IAAI,UAAU,IAAI,QAAQ,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAI,QAAqB;IACxD,OAAO,SAAS,IAAI,QAAQ,IAAI,YAAY,IAAI,QAAQ,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;AAC9E,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAI,QAAqB;IAC7D,OAAO,SAAS,IAAI,QAAQ,IAAI,YAAY,IAAI,QAAQ,IAAI,QAAQ,CAAC,KAAK,KAAK,IAAI,CAAC;AACtF,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAI,QAAqB;IACzD,OAAO,SAAS,IAAI,QAAQ,IAAI,aAAa,IAAI,QAAQ,CAAC;AAC5D,CAAC;AAED,MAAM,UAAU,eAAe,CAAI,QAAqB;IACtD,OAAO,SAAS,IAAI,QAAQ,IAAI,OAAO,IAAI,QAAQ,IAAI,QAAQ,CAAC,KAAK,KAAK,IAAI,CAAC;AACjF,CAAC"}

package/dist/tokens.d.ts

@@ -0,0 +1,39 @@
+import { type AbstractClass, type Class } from "./utils.js";
+/**
+ * A token is a reference to a service in the dependency injection (DI) container.
+ * When obtaining a service from the container, you should use this token.
+ */
+export type Token<T> = Class<T> | AbstractClass<T> | string | symbol | InjectionToken<T>;
+/**
+ * A unique injection token object, that is used by reference. Can hold a generic type.
+ * Can optionally hold an (async) factory.
+ */
+export declare class InjectionToken<T> {
+    private description;
+    options?: InjectionTokenOptions<T> | undefined;
+    constructor(description: string | symbol, options?: InjectionTokenOptions<T> | undefined);
+    toString(): string;
+}
+type InjectionTokenOptions<T> = {
+    async?: false;
+    factory: () => T;
+} | {
+    async: true;
+    factory: () => Promise<T>;
+};
+/**
+ * Type-guard to check if a token is a class reference.
+ * @internal
+ */
+export declare function isClassToken<T>(token: Token<T>): token is Class<T>;
+/**
+ * Type-guard to check if a token is an InjectionToken
+ * @internal
+ */
+export declare function isInjectionToken<T>(token: Token<T>): token is InjectionToken<T>;
+/**
+ * Describes a token, useful for error messages.
+ * @internal
+ */
+export declare function toString<T>(token: Token<T>): string;
+export {};

package/dist/tokens.js

@@ -0,0 +1,49 @@
+import { isClassLike } from "./utils.js";
+/**
+ * A unique injection token object, that is used by reference. Can hold a generic type.
+ * Can optionally hold an (async) factory.
+ */
+export class InjectionToken {
+    description;
+    options;
+    constructor(description, options) {
+        this.description = description;
+        this.options = options;
+    }
+    toString() {
+        return `InjectionToken "${String(this.description)}"`;
+    }
+}
+/**
+ * Type-guard to check if a token is a class reference.
+ * @internal
+ */
+export function isClassToken(token) {
+    return isClassLike(token);
+}
+/**
+ * Type-guard to check if a token is an InjectionToken
+ * @internal
+ */
+export function isInjectionToken(token) {
+    return token instanceof InjectionToken;
+}
+/**
+ * Describes a token, useful for error messages.
+ * @internal
+ */
+export function toString(token) {
+    if (isClassLike(token)) {
+        return token.name;
+    }
+    else if (typeof token === "symbol") {
+        return token.description ?? String(token);
+    }
+    else if (token instanceof InjectionToken) {
+        return token.toString();
+    }
+    else {
+        return token;
+    }
+}
+//# sourceMappingURL=tokens.js.map

package/dist/tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.js","sourceRoot":"","sources":["../src/tokens.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkC,WAAW,EAAE,MAAM,YAAY,CAAC;AAQzE;;;GAGG;AACH,MAAM,OAAO,cAAc;IAEf;IACD;IAFT,YACU,WAA4B,EAC7B,OAAkC;QADjC,gBAAW,GAAX,WAAW,CAAiB;QAC7B,YAAO,GAAP,OAAO,CAA2B;IACxC,CAAC;IAEG,QAAQ;QACb,OAAO,mBAAmB,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC;IACxD,CAAC;CACF;AAYD;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAI,KAAe;IAC7C,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC;AAC5B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAI,KAAe;IACjD,OAAO,KAAK,YAAY,cAAc,CAAC;AACzC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAI,KAAe;IACzC,IAAI,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,KAAK,CAAC,IAAI,CAAC;IACpB,CAAC;SAAM,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACrC,OAAO,KAAK,CAAC,WAAW,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC;IAC5C,CAAC;SAAM,IAAI,KAAK,YAAY,cAAc,EAAE,CAAC;QAC3C,OAAO,KAAK,CAAC,QAAQ,EAAE,CAAC;IAC1B,CAAC;SAAM,CAAC;QACN,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/utils.d.ts

@@ -0,0 +1,25 @@
+export type Class<T> = new (...args: any[]) => T;
+export interface AbstractClass<T> {
+    prototype: T;
+    name: string;
+}
+/**
+ * Type-guard to assert if the given object is an (abstract) class.
+ * @internal
+ */
+export declare function isClassLike(target: unknown): target is Class<unknown> | AbstractClass<unknown>;
+/**
+ * Returns all parent classes of a given class.
+ * @internal
+ */
+export declare function getParentClasses(target: Class<unknown>): Class<unknown>[];
+/**
+ * Ensures a given value is not null or undefined.
+ * @internal
+ */
+export declare function assertPresent<T>(value: T | null | undefined): T;
+/**
+ * @internal
+ */
+export declare function windowedSlice<T>(array: T[], step?: 2): [T, T][];
+export declare function windowedSlice<T>(array: T[], step: number): T[][];

package/dist/utils.js

@@ -0,0 +1,41 @@
+/**
+ * Type-guard to assert if the given object is an (abstract) class.
+ * @internal
+ */
+export function isClassLike(target) {
+    return typeof target === "function";
+}
+/**
+ * Returns all parent classes of a given class.
+ * @internal
+ */
+export function getParentClasses(target) {
+    const parentClasses = [];
+    let currentClass = target;
+    while (Object.getPrototypeOf(currentClass).name) {
+        const parentClass = Object.getPrototypeOf(currentClass);
+        parentClasses.push(parentClass);
+        currentClass = parentClass;
+    }
+    return parentClasses;
+}
+/**
+ * Ensures a given value is not null or undefined.
+ * @internal
+ */
+export function assertPresent(value) {
+    if (value === null || value === undefined) {
+        throw Error(`Expected value to be not null or undefined`);
+    }
+    return value;
+}
+export function windowedSlice(array, step = 2) {
+    const result = [];
+    array.some((_, i) => {
+        if (i + step > array.length)
+            return true;
+        result.push(array.slice(i, i + step));
+    });
+    return result;
+}
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAQA;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,MAAe;IACzC,OAAO,OAAO,MAAM,KAAK,UAAU,CAAC;AACtC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAsB;IACrD,MAAM,aAAa,GAAqB,EAAE,CAAC;IAC3C,IAAI,YAAY,GAAG,MAAM,CAAC;IAC1B,OAAO,MAAM,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC,IAAI,EAAE,CAAC;QAChD,MAAM,WAAW,GAAmB,MAAM,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC;QACxE,aAAa,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAChC,YAAY,GAAG,WAAW,CAAC;IAC7B,CAAC;IACD,OAAO,aAAa,CAAC;AACvB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAI,KAA2B;IAC1D,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QAC1C,MAAM,KAAK,CAAC,4CAA4C,CAAC,CAAC;IAC5D,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAOD,MAAM,UAAU,aAAa,CAAI,KAAU,EAAE,IAAI,GAAG,CAAC;IACnD,MAAM,MAAM,GAAU,EAAE,CAAC;IACzB,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QAClB,IAAI,CAAC,GAAG,IAAI,GAAG,KAAK,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC;QACzC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;IACH,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@needle-di/core",
+  "version": "0.7.0",
+  "description": "A simple TypeScript library for dependency injection",
+  "license": "MIT",
+  "keywords": [
+    "dependency injection",
+    "di",
+    "dependency",
+    "injection",
+    "typescript",
+    "type-safe"
+  ],
+  "homepage": "https://needle-di.io",
+  "author": {
+    "name": "Dirk Luijk",
+    "email": "mail@dirkluijk.nl"
+  },
+  "private": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/dirkluijk/needle-di.git"
+  },
+  "type": "module",
+  "module": "dist/index.js",
+  "exports": "./dist/index.js",
+  "types": "dist/index.d.ts",
+  "sideEffects": false,
+  "files": [
+    "dist/**/**"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "build:watch": "tsc -w",
+    "test": "vitest run && tsc -p tsconfig.test.json",
+    "test:watch": "vitest",
+    "test:ci": "vitest run --silent --coverage",
+    "lint": "eslint src",
+    "lint:fix": "eslint src --fix",
+    "reformat": "prettier src/**/*.ts README.md --write",
+    "docs:dev": "vitepress dev docs",
+    "docs:build": "vitepress build docs",
+    "docs:preview": "vitepress preview docs"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.10.0",
+    "@total-typescript/tsconfig": "github:total-typescript/tsconfig",
+    "@vitest/coverage-v8": "^2.1.1",
+    "eslint": "^9.10.0",
+    "prettier": "^3.3.3",
+    "typescript": "~5.5.0",
+    "typescript-eslint": "^8.6.0",
+    "vitepress": "^1.3.4",
+    "vitest": "^2.1.1"
+  }
+}