@lppedd/di-wise-neo 0.11.0 → 0.11.2

package/dist/es/index.d.mts

@@ -116,11 +116,11 @@ interface FactoryProvider<Value> {
 /**
  * Provides a static - already constructed - value for a token.
  */
-interface ValueProvider<T> {
+interface ValueProvider<Value> {
     /**
      * The static value to associate with the token.
      */
-    readonly useValue: T;
+    readonly useValue: Value;
     /**
      * An optional name to qualify this provider.
      * If specified, the token must be resolved using the same name.
@@ -147,10 +147,7 @@ interface ExistingProvider<Value> {
     /**
      * The existing token to alias.
      */
-    readonly useExisting: Token<Value> | {
-        readonly token: Token<Value>;
-        readonly name?: string;
-    };
+    readonly useExisting: Token<Value> | [Token<Value>, string?];
     /**
      * An optional name to qualify this provider.
      * If specified, the token must be resolved using the same name.
@@ -434,9 +431,9 @@ interface Container {
      *
      * @see The documentation for `resolve(token: Token)`
      */
-    resolveAll<Value>(token: Token<Value>, optional?: false): NonNullable<Value>[];
-    resolveAll<Value>(token: Token<Value>, optional: true): NonNullable<Value>[];
-    resolveAll<Value>(token: Token<Value>, optional?: boolean): NonNullable<Value>[];
+    resolveAll<Value>(token: Token<Value>, optional?: false): Value[];
+    resolveAll<Value>(token: Token<Value>, optional: true): Value[];
+    resolveAll<Value>(token: Token<Value>, optional?: boolean): Value[];
     /**
      * Disposes this container and all its cached values.
      *
@@ -453,7 +450,7 @@ interface Container {
 declare function createContainer(options?: Partial<ContainerOptions>): Container;
 
 /**
- * Class decorator that enables auto-registration of an unregistered class,
+ * Class decorator that enables auto-registration of an unregistered class
  * when the class is first resolved from the container.
  *
  * @example
@@ -497,12 +494,12 @@ interface TokenRef<Value = any> {
     readonly getRefToken: () => Token<Value>;
 }
 /**
- * Allows referencing tokens that are declared later in the file by wrapping them
+ * Allows referencing tokens declared later in the file by wrapping them
  * in a lazily evaluated function.
  */
 declare function forwardRef<Value>(token: () => Tokens<Value>): TokensRef<Value>;
 /**
- * Allows referencing a token that is declared later in the file by wrapping it
+ * Allows referencing a token declared later in the file by wrapping it
  * in a lazily evaluated function.
  */
 declare function forwardRef<Value>(token: () => Token<Value>): TokenRef<Value>;
@@ -522,8 +519,8 @@ declare function Inject<Value>(token: Token<Value>): ParameterDecorator;
 /**
  * Parameter decorator that injects the value associated with the given token.
  *
- * Allows referencing a token that is declared later in the file by using
- * the {@link forwardRef} helper function.
+ * Allows referencing a token declared later in the file by using the
+ * {@link forwardRef} helper function.
  *
  * Throws an error if the token is not registered in the container.
  *
@@ -539,7 +536,7 @@ declare function Inject<Value>(token: Token<Value>): ParameterDecorator;
 declare function Inject<Value>(tokens: TokenRef<Value>): ParameterDecorator;
 
 /**
- * Class decorator that registers additional aliasing tokens for the decorated type,
+ * Class decorator that registers additional aliasing tokens for the decorated type
  * when the type is first registered in the container.
  *
  * The container uses {@link ExistingProvider} under the hood.
@@ -552,7 +549,7 @@ declare function Inject<Value>(tokens: TokenRef<Value>): ParameterDecorator;
  */
 declare function Injectable<This extends object, Value extends This>(...tokens: Tokens<Value>): ClassDecorator;
 /**
- * Class decorator that registers additional aliasing tokens for the decorated type,
+ * Class decorator that registers additional aliasing tokens for the decorated type
  * when the type is first registered in the container.
  *
  * The container uses {@link ExistingProvider} under the hood.
@@ -588,8 +585,8 @@ declare function InjectAll<Value>(token: Token<Value>): ParameterDecorator;
  * Parameter decorator that injects all values provided by the registrations
  * associated with the given token.
  *
- * Allows referencing a token that is declared later in the file by using
- * the {@link forwardRef} helper function.
+ * Allows referencing a token declared later in the file by using the
+ * {@link forwardRef} helper function.
  *
  * Throws an error if the token is not registered in the container.
  *
@@ -638,8 +635,8 @@ declare function Optional<Value>(token: Token<Value>): ParameterDecorator;
  * Parameter decorator that injects the value associated with the given token,
  * or `undefined` if the token is not registered in the container.
  *
- * Allows referencing a token that is declared later in the file by using
- * the {@link forwardRef} helper function.
+ * Allows referencing a token declared later in the file by using the
+ * {@link forwardRef} helper function.
  *
  * @example
  * ```ts
@@ -654,23 +651,23 @@ declare function Optional<Value>(tokens: TokenRef<Value>): ParameterDecorator;
 
 /**
  * Parameter decorator that injects all instances provided by the registrations
- * associated with the given class, or an empty array if the class is not registered
+ * associated with the given class or an empty array if the class is not registered
  * in the container.
  */
 declare function OptionalAll<Instance extends object>(Class: Constructor<Instance>): ParameterDecorator;
 /**
  * Parameter decorator that injects all values provided by the registrations
- * associated with the given token, or an empty array if the token is not registered
+ * associated with the given token or an empty array if the token is not registered
  * in the container.
  */
 declare function OptionalAll<Value>(token: Token<Value>): ParameterDecorator;
 /**
  * Parameter decorator that injects all values provided by the registrations
- * associated with the given token, or an empty array if the token is not registered
+ * associated with the given token or an empty array if the token is not registered
  * in the container.
  *
- * Allows referencing a token that is declared later in the file by using
- * the {@link forwardRef} helper function.
+ * Allows referencing a token declared later in the file by using the
+ * {@link forwardRef} helper function.
  *
  * @example
  * ```ts
@@ -779,7 +776,7 @@ declare function injectAll<Instance extends object>(Class: Constructor<Instance>
  *
  * Throws an error if the token is not registered in the container.
  */
-declare function injectAll<Value>(token: Token<Value>): NonNullable<Value>[];
+declare function injectAll<Value>(token: Token<Value>): Value[];
 
 /**
  * Injector API.
@@ -808,7 +805,7 @@ interface Injector {
      *
      * Throws an error if the token is not registered in the container.
      */
-    injectAll<Value>(token: Token<Value>): NonNullable<Value>[];
+    injectAll<Value>(token: Token<Value>): Value[];
     /**
      * Injects the instance associated with the given class,
      * or `undefined` if the class is not registered in the container.
@@ -820,15 +817,15 @@ interface Injector {
      */
     optional<Value>(token: Token<Value>, name?: string): Value | undefined;
     /**
-     * Injects all instances provided by the registrations associated with the given class,
+     * Injects all instances provided by the registrations associated with the given class
      * or an empty array if the class is not registered in the container.
      */
     optionalAll<Instance extends object>(Class: Constructor<Instance>): Instance[];
     /**
-     * Injects all values provided by the registrations associated with the given token,
+     * Injects all values provided by the registrations associated with the given token
      * or an empty array if the token is not registered in the container.
      */
-    optionalAll<Value>(token: Token<Value>): NonNullable<Value>[];
+    optionalAll<Value>(token: Token<Value>): Value[];
     /**
      * Runs a function inside the injection context of this injector.
      *
@@ -912,7 +909,7 @@ interface Middleware {
 /**
  * Applies middleware functions to a container.
  *
- * Middlewares are applied in array order, but execute in reverse order.
+ * Middlewares are applied in array order but execute in reverse order.
  *
  * @example
  * ```ts
@@ -970,15 +967,15 @@ declare function optionalBy<Instance extends object>(thisArg: any, Class: Constr
 declare function optionalBy<Value>(thisArg: any, token: Token<Value>, name?: string): Value | undefined;
 
 /**
- * Injects all instances provided by the registrations associated with the given class,
+ * Injects all instances provided by the registrations associated with the given class
  * or an empty array if the class is not registered in the container.
  */
 declare function optionalAll<Instance extends object>(Class: Constructor<Instance>): Instance[];
 /**
- * Injects all values provided by the registrations associated with the given token,
+ * Injects all values provided by the registrations associated with the given token
  * or an empty array if the token is not registered in the container.
  */
-declare function optionalAll<Value>(token: Token<Value>): NonNullable<Value>[];
+declare function optionalAll<Value>(token: Token<Value>): Value[];
 
 export { AutoRegister, EagerInstantiate, Inject, InjectAll, Injectable, Injector, Named, Optional, OptionalAll, Scope, Scoped, applyMiddleware, build, createContainer, createType, forwardRef, inject, injectAll, injectBy, optional, optionalAll, optionalBy, setClassIdentityMapping };
 export type { ClassProvider, Constructor, Container, ContainerOptions, ExistingProvider, FactoryProvider, Middleware, MiddlewareComposer, Provider, RegistrationOptions, Token, TokenRef, Tokens, TokensRef, Type, ValueProvider };

package/dist/es/index.mjs

@@ -53,8 +53,7 @@ function getTokenPath(tokens) {
 function getTokenName(token) {
     return token.name || "<unnamed>";
 }
-function getFullTokenName(tokenInfo) {
-    const [token, name] = tokenInfo;
+function getFullTokenName([token, name]) {
     const tokenName = token.name || "<unnamed>";
     return name ? `${tokenName}["${name}"]` : tokenName;
 }
@@ -81,8 +80,7 @@ class KeyedStack {
         return this.myKeys.has(key);
     }
     peek() {
-        const entry = this.myEntries.at(-1);
-        return entry?.value;
+        return this.myEntries.at(-1)?.value;
     }
     push(key, value) {
         check(!this.has(key), "invariant violation");
@@ -130,7 +128,7 @@ class WeakRefMap {
 // @internal
 function createResolution() {
     return {
-        tokenStack: [],
+        tokens: [],
         stack: new KeyedStack(),
         values: new WeakRefMap(),
         dependents: new WeakRefMap()
@@ -328,8 +326,9 @@ const Scope = {
     Container: "Container"
 };
 
-const typeSymbol = Symbol("di-wise-neo.typeToken");
 /**
+ * Type API.
+ */ /**
  * Creates a type token.
  *
  * @example
@@ -343,7 +342,6 @@ const typeSymbol = Symbol("di-wise-neo.typeToken");
         name: `Type<${typeName}>`,
         inter: createType,
         union: createType,
-        __type: typeSymbol,
         toString () {
             return type.name;
         }
@@ -351,10 +349,6 @@ const typeSymbol = Symbol("di-wise-neo.typeToken");
     return type;
 }
 // @internal
-function isType(token) {
-    return token.__type === typeSymbol;
-}
-// @internal
 function isConstructor(token) {
     return typeof token === "function";
 }
@@ -416,22 +410,22 @@ class TokenRegistry {
     }
     delete(token, name) {
         const registrations = this.myMap.get(token);
-        if (registrations) {
-            if (name !== undefined) {
-                const removedRegistrations = [];
-                const newRegistrations = [];
-                for (const registration of registrations){
-                    const array = registration.name === name ? removedRegistrations : newRegistrations;
-                    array.push(registration);
-                }
-                if (removedRegistrations.length > 0) {
-                    this.myMap.set(token, newRegistrations);
-                    return removedRegistrations;
-                }
+        if (!registrations) {
+            return [];
+        }
+        if (name !== undefined) {
+            const removed = [];
+            const updated = [];
+            for (const registration of registrations){
+                (registration.name === name ? removed : updated).push(registration);
+            }
+            if (removed.length > 0) {
+                this.myMap.set(token, updated);
+                return removed;
             }
-            this.myMap.delete(token);
         }
-        return registrations ?? [];
+        this.myMap.delete(token);
+        return registrations;
     }
     deleteAll() {
         const tokens = Array.from(this.myMap.keys());
@@ -593,10 +587,10 @@ function isDisposable(value) {
                 this.myTokenRegistry.set(token, {
                     name: name,
                     provider: {
-                        useExisting: {
-                            token: Class,
-                            name: name
-                        }
+                        useExisting: [
+                            Class,
+                            name
+                        ]
                     }
                 });
             }
@@ -612,7 +606,7 @@ function isDisposable(value) {
                 const metadata = getMetadata(provider.useClass);
                 const registration = {
                     // An explicit provider name overrides what is specified via @Named
-                    name: metadata.name ?? provider.name,
+                    name: metadata.name ?? name,
                     provider: metadata.provider,
                     options: {
                         // Explicit registration options override what is specified via class decorators (e.g., @Scoped)
@@ -666,7 +660,7 @@ function isDisposable(value) {
         if (!registration && isConstructor(token)) {
             registration = this.autoRegisterClass(token, localName);
         }
-        return this.resolveRegistration(token, registration, localOptional, localName);
+        return this.resolveRegistration(token, registration, localOptional, localName)?.value;
     }
     resolveAll(token, optional) {
         this.checkDisposed();
@@ -684,8 +678,7 @@ function isDisposable(value) {
                 token
             ]);
         }
-        return registrations //
-        .map((registration)=>this.resolveRegistration(token, registration, optional)).filter((value)=>value != null);
+        return registrations.map((registration)=>this.resolveRegistration(token, registration, optional)).filter((result)=>result !== undefined).map((result)=>result.value);
     }
     dispose() {
         if (this.myDisposed) {
@@ -745,7 +738,9 @@ function isDisposable(value) {
             ]);
         }
         try {
-            return this.resolveProviderValue(token, registration);
+            return {
+                value: this.resolveProviderValue(token, registration)
+            };
         } catch (e) {
             throwResolutionError([
                 token,
@@ -755,12 +750,8 @@ function isDisposable(value) {
     }
     getTargetToken(provider) {
         const token = provider.useExisting;
-        return isType(token) || isConstructor(token) //
-         ? [
+        return Array.isArray(token) ? token : [
             token
-        ] : [
-            token.token,
-            token.name
         ];
     }
     autoRegisterClass(Class, name) {
@@ -808,7 +799,7 @@ function isDisposable(value) {
         if (resolution.stack.has(provider)) {
             const dependentRef = resolution.dependents.get(provider);
             check(dependentRef, ()=>{
-                const path = getTokenPath(resolution.tokenStack.concat(token).map((t)=>[
+                const path = getTokenPath(resolution.tokens.concat(token).map((t)=>[
                         t
                     ]));
                 return `circular dependency detected while resolving ${path}`;
@@ -818,7 +809,7 @@ function isDisposable(value) {
         const scope = registration.options?.scope ?? this.myOptions.defaultScope;
         const cleanups = [
             provideInjectionContext(context),
-            resolution.tokenStack.push(token) && (()=>resolution.tokenStack.pop()),
+            resolution.tokens.push(token) && (()=>resolution.tokens.pop()),
             !isBuilder(provider) && resolution.stack.push(provider, {
                 provider,
                 scope
@@ -945,7 +936,7 @@ function isDisposable(value) {
 }
 
 /**
- * Class decorator that enables auto-registration of an unregistered class,
+ * Class decorator that enables auto-registration of an unregistered class
  * when the class is first resolved from the container.
  *
  * @example
@@ -1004,8 +995,7 @@ function isDisposable(value) {
 function forwardRef(token) {
     return {
         getRefTokens: ()=>{
-            // Normalize the single token here, so that we don't have
-            // to do it at every getRefTokens call site
+            // Normalize the single token here so that we don't have to do it at every getRefTokens call site
             const tokenOrTokens = token();
             const tokensArray = Array.isArray(tokenOrTokens) ? tokenOrTokens : [
                 tokenOrTokens
@@ -1254,14 +1244,14 @@ function OptionalAll(token) {
         injectAll: (token)=>runInContext(()=>injectAll(token)),
         optional: (token, name)=>runInContext(()=>optional(token, name)),
         optionalAll: (token)=>runInContext(()=>optionalAll(token)),
-        runInContext
+        runInContext: runInContext
     };
 }, "Injector");
 
 /**
  * Applies middleware functions to a container.
  *
- * Middlewares are applied in array order, but execute in reverse order.
+ * Middlewares are applied in array order but execute in reverse order.
  *
  * @example
  * ```ts