static-injector 2.2.1 → 4.0.0

package/import/commonjs/index.js

@@ -163,6 +163,21 @@ function stringify(token) {
     const newLineIndex = res.indexOf('\n');
     return newLineIndex === -1 ? res : res.substring(0, newLineIndex);
 }
+/**
+ * Ellipses the string in the middle when longer than the max length
+ *
+ * @param string
+ * @param maxLength of the output string
+ * @returns ellipsed string with ... in the middle
+ */
+function truncateMiddle(str, maxLength = 100) {
+    if (!str || maxLength < 1 || str.length <= maxLength)
+        return str;
+    if (maxLength == 1)
+        return str.substring(0, 1) + '...';
+    const halfLimit = Math.round(maxLength / 2);
+    return (str.substring(0, halfLimit) + '...' + str.substring(str.length - halfLimit));
+}
 
 /**
  * @license
@@ -268,8 +283,8 @@ function isForwardRef(fn) {
  */
 /** Throws an error when a token is not found in DI. */
 function throwProviderNotFoundError(token, injectorName) {
-    const injectorDetails = injectorName ? ` in ${injectorName}` : '';
-    throw new RuntimeError(-201 /* RuntimeErrorCode.PROVIDER_NOT_FOUND */, null);
+    const errorMessage = null;
+    throw new RuntimeError(-201 /* RuntimeErrorCode.PROVIDER_NOT_FOUND */, errorMessage);
 }
 
 /**
@@ -451,7 +466,7 @@ function injectRootLimpMode(token, notFoundValue, flags) {
         return null;
     if (notFoundValue !== undefined)
         return notFoundValue;
-    throwProviderNotFoundError(stringify(token), 'Injector');
+    throwProviderNotFoundError(token, 'Injector');
 }
 
 /**
@@ -516,6 +531,27 @@ function ɵɵinject(token, flags = exports.InjectFlags.Default) {
 function ɵɵinvalidFactoryDep(index) {
     throw new RuntimeError(202 /* RuntimeErrorCode.INVALID_FACTORY_DEPENDENCY */, null);
 }
+/**
+ * @param token A token that represents a static attribute on the host node that should be injected.
+ * @returns Value of the attribute if it exists.
+ * @throws If called outside of a supported context or the attribute does not exist.
+ *
+ * @publicApi
+ */
+/**
+ * @param token A token that represents a static attribute on the host node that should be injected.
+ * @returns Value of the attribute if it exists, otherwise `null`.
+ * @throws If called outside of a supported context.
+ *
+ * @publicApi
+ */
+/**
+ * @param token A token that represents a static attribute on the host node that should be injected.
+ * @returns Value of the attribute if it exists.
+ * @throws If called outside of a supported context or the attribute does not exist.
+ *
+ * @publicApi
+ */
 /**
  * Injects a token from the currently active injector.
  * `inject` is only supported in an [injection context](/guide/dependency-injection-context). It can
@@ -582,6 +618,8 @@ function ɵɵinvalidFactoryDep(index) {
  * @publicApi
  */
 function inject(token, flags = exports.InjectFlags.Default) {
+    // The `as any` here _shouldn't_ be necessary, but without it JSCompiler
+    // throws a disambiguation  error due to the multiple signatures.
     return ɵɵinject(token, convertToBitFlags(flags));
 }
 // Converts object-based DI flags (`InjectOptions`) to bit flags (`InjectFlags`).
@@ -776,17 +814,6 @@ function getFactoryDef(type, throwNotFound) {
     return hasFactoryDef ? type[NG_FACTORY_DEF] : null;
 }
 
-function deepForEach(input, fn) {
-    input.forEach((value) => Array.isArray(value) ? deepForEach(value, fn) : fn(value));
-}
-function newArray(size, value) {
-    const list = [];
-    for (let i = 0; i < size; i++) {
-        list.push(value);
-    }
-    return list;
-}
-
 /**
  * @license
  * Copyright Google LLC All Rights Reserved.
@@ -823,11 +850,17 @@ if (false) {
  * `InjectionToken` is parameterized on `T` which is the type of object which will be returned by
  * the `Injector`. This provides an additional level of type safety.
  *
- * ```
- * interface MyInterface {...}
- * const myInterface = injector.get(new InjectionToken<MyInterface>('SomeToken'));
- * // myInterface is inferred to be MyInterface.
- * ```
+ * <div class="alert is-helpful">
+ *
+ * **Important Note**: Ensure that you use the same instance of the `InjectionToken` in both the
+ * provider and the injection call. Creating a new instance of `InjectionToken` in different places,
+ * even with the same description, will be treated as different tokens by Angular's DI system,
+ * leading to a `NullInjectorError`.
+ *
+ * </div>
+ *
+ * <code-example format="typescript" language="typescript" path="injection-token/src/main.ts"
+ * region="InjectionToken"></code-example>
  *
  * When creating an `InjectionToken`, you can optionally specify a factory function which returns
  * (possibly by creating) a default value of the parameterized type `T`. This sets up the
@@ -854,7 +887,6 @@ if (false) {
  *
  * {@example core/di/ts/injector_spec.ts region='ShakableInjectionToken'}
  *
- *
  * @publicApi
  */
 class InjectionToken {
@@ -872,6 +904,8 @@ class InjectionToken {
         this._desc = _desc;
         this.ɵprov = undefined;
         if (typeof options == 'number') {
+            // This is a special hack to assign __NG_ELEMENT_ID__ to this instance.
+            // See `InjectorMarkers`
         }
         else if (options !== undefined) {
             this.ɵprov = ɵɵdefineInjectable({
@@ -905,7 +939,7 @@ class InjectionToken {
  *
  * @publicApi
  */
-const ENVIRONMENT_INITIALIZER = new InjectionToken('ENVIRONMENT_INITIALIZER');
+const ENVIRONMENT_INITIALIZER = new InjectionToken('');
 
 /**
  * @license
@@ -922,11 +956,10 @@ const ENVIRONMENT_INITIALIZER = new InjectionToken('ENVIRONMENT_INITIALIZER');
  *
  * @publicApi
  */
-const INJECTOR = new InjectionToken('INJECTOR', 
+const INJECTOR = new InjectionToken('', 
 // Disable tslint because this is const enum which gets inlined not top level prop access.
 // tslint:disable-next-line: no-toplevel-property-access
--1 /* InjectorMarkers.Injector */ // Special value used by Ivy to identify `Injector`.
-);
+-1 /* InjectorMarkers.Injector */);
 
 /**
  * @license
@@ -946,7 +979,7 @@ function isEnvironmentProviders(value) {
  * Use of this source code is governed by an MIT-style license that can be
  * found in the LICENSE file at https://angular.io/license
  */
-const INJECTOR_DEF_TYPES = new InjectionToken('INJECTOR_DEF_TYPES');
+const INJECTOR_DEF_TYPES = new InjectionToken('');
 
 /**
  * @license
@@ -1082,7 +1115,7 @@ function isClassProvider(value) {
  * as a root scoped injector when processing requests for unknown tokens which may indicate
  * they are provided in the root scope.
  */
-const INJECTOR_SCOPE = new InjectionToken('Set Injector scope.');
+const INJECTOR_SCOPE = new InjectionToken('');
 
 /**
  * @license
@@ -1161,7 +1194,7 @@ class R3Injector extends EnvironmentInjector {
         if (record != null && typeof record.value === 'string') {
             this.scopes.add(record.value);
         }
-        this.injectorDefTypes = new Set(this.get(INJECTOR_DEF_TYPES.multi, EMPTY_ARRAY, exports.InjectFlags.Self));
+        this.injectorDefTypes = new Set(this.get(INJECTOR_DEF_TYPES, EMPTY_ARRAY, exports.InjectFlags.Self));
     }
     /**
      * Destroy the injector and release references to every instance or provider associated with it.
@@ -1235,6 +1268,8 @@ class R3Injector extends EnvironmentInjector {
                     if (def && this.injectableDefInScope(def)) {
                         // Found an injectable def and it's scoped to this injector. Pretend as if it was here
                         // all along.
+                        if (false) {
+                        }
                         record = makeRecord(injectableDefOrInjectorDefFactory(token), NOT_YET);
                     }
                     else {
@@ -1291,7 +1326,7 @@ class R3Injector extends EnvironmentInjector {
         if (false) {
         }
         try {
-            const initializers = this.get(ENVIRONMENT_INITIALIZER.multi, EMPTY_ARRAY, exports.InjectFlags.Self);
+            const initializers = this.get(ENVIRONMENT_INITIALIZER, EMPTY_ARRAY, exports.InjectFlags.Self);
             if (false) {
             }
             for (const initializer of initializers) {
@@ -1348,29 +1383,32 @@ class R3Injector extends EnvironmentInjector {
             multiRecord.multi.push(provider);
         }
         else {
-            const existing = this.records.get(token);
             if (false) {
             }
         }
         this.records.set(token, record);
     }
     hydrate(token, record) {
-        if (false) {
-        }
-        else if (record.value === NOT_YET) {
-            record.value = CIRCULAR;
+        try {
             if (false) {
             }
-            else {
-                record.value = record.factory();
+            else if (record.value === NOT_YET) {
+                record.value = CIRCULAR;
+                if (false) {
+                }
+                else {
+                    record.value = record.factory();
+                }
+            }
+            if (typeof record.value === 'object' &&
+                record.value &&
+                hasOnDestroy(record.value)) {
+                this._ngOnDestroyHooks.add(record.value);
             }
+            return record.value;
         }
-        if (typeof record.value === 'object' &&
-            record.value &&
-            hasOnDestroy(record.value)) {
-            this._ngOnDestroyHooks.add(record.value);
+        finally {
         }
-        return record.value;
     }
     injectableDefInScope(def) {
         if (!def.providedIn) {
@@ -1414,7 +1452,6 @@ function getUndecoratedInjectableFactory(token) {
     // If the token has parameters then it has dependencies that we cannot resolve implicitly.
     const paramLength = token.length;
     if (paramLength > 0) {
-        const args = newArray(paramLength, '?');
         throw new RuntimeError(204 /* RuntimeErrorCode.INVALID_INJECTION_TOKEN */, null);
     }
     // The constructor function appears to have no parameters.
@@ -1550,10 +1587,10 @@ function createInjectorWithoutInjectorInstances(defType, parent = null, addition
  */
 /**
  * Concrete injectors implement this interface. Injectors are configured
- * with [providers](guide/glossary#provider) that associate
- * dependencies of various types with [injection tokens](guide/glossary#di-token).
+ * with [providers](guide/dependency-injection-providers) that associate
+ * dependencies of various types with [injection tokens](guide/dependency-injection-providers).
  *
- * @see ["DI Providers"](guide/dependency-injection-providers).
+ * @see [DI Providers](guide/dependency-injection-providers).
  * @see {@link StaticProvider}
  *
  * @usageNotes
@@ -1597,6 +1634,13 @@ class Injector {
     static __NG_ELEMENT_ID__ = -1 /* InjectorMarkers.Injector */;
 }
 
+/**
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.io/license
+ */
 /**
  * Throws an error indicating that a factory function could not be generated by the compiler for a
  * particular class.
@@ -1692,9 +1736,9 @@ exports.injectInjectorOnly = injectInjectorOnly;
 exports.isInjectable = isInjectable;
 exports.providerToFactory = providerToFactory;
 exports.setCurrentInjector = setCurrentInjector;
-exports["ɵɵdefineInjectable"] = ɵɵdefineInjectable;
-exports["ɵɵdefineInjector"] = ɵɵdefineInjector;
-exports["ɵɵgetInheritedFactory"] = ɵɵgetInheritedFactory;
-exports["ɵɵinject"] = ɵɵinject;
-exports["ɵɵinvalidFactory"] = ɵɵinvalidFactory;
-exports["ɵɵinvalidFactoryDep"] = ɵɵinvalidFactoryDep;
+exports.ɵɵdefineInjectable = ɵɵdefineInjectable;
+exports.ɵɵdefineInjector = ɵɵdefineInjector;
+exports.ɵɵgetInheritedFactory = ɵɵgetInheritedFactory;
+exports.ɵɵinject = ɵɵinject;
+exports.ɵɵinvalidFactory = ɵɵinvalidFactory;
+exports.ɵɵinvalidFactoryDep = ɵɵinvalidFactoryDep;

package/import/es2022/di/index.js

@@ -0,0 +1 @@
+export {};

package/import/es2022/di/initializer_token.js

@@ -12,4 +12,4 @@ import { InjectionToken } from './injection_token';
  *
  * @publicApi
  */
-export const ENVIRONMENT_INITIALIZER = new InjectionToken('ENVIRONMENT_INITIALIZER');
+export const ENVIRONMENT_INITIALIZER = new InjectionToken('');

package/import/es2022/di/inject_switch.js

@@ -6,7 +6,6 @@
  * found in the LICENSE file at https://angular.io/license
  */
 import { throwProviderNotFoundError } from '../render3/errors_di';
-import { stringify } from '../util/stringify';
 import { getInjectableDef } from './interface/defs';
 import { InjectFlags } from './interface/injector';
 /**
@@ -48,5 +47,5 @@ export function injectRootLimpMode(token, notFoundValue, flags) {
         return null;
     if (notFoundValue !== undefined)
         return notFoundValue;
-    throwProviderNotFoundError(stringify(token), 'Injector');
+    throwProviderNotFoundError(token, 'Injector');
 }

package/import/es2022/di/injection_token.js

@@ -16,11 +16,17 @@ import { ɵɵdefineInjectable } from './interface/defs';
  * `InjectionToken` is parameterized on `T` which is the type of object which will be returned by
  * the `Injector`. This provides an additional level of type safety.
  *
- * ```
- * interface MyInterface {...}
- * const myInterface = injector.get(new InjectionToken<MyInterface>('SomeToken'));
- * // myInterface is inferred to be MyInterface.
- * ```
+ * <div class="alert is-helpful">
+ *
+ * **Important Note**: Ensure that you use the same instance of the `InjectionToken` in both the
+ * provider and the injection call. Creating a new instance of `InjectionToken` in different places,
+ * even with the same description, will be treated as different tokens by Angular's DI system,
+ * leading to a `NullInjectorError`.
+ *
+ * </div>
+ *
+ * <code-example format="typescript" language="typescript" path="injection-token/src/main.ts"
+ * region="InjectionToken"></code-example>
  *
  * When creating an `InjectionToken`, you can optionally specify a factory function which returns
  * (possibly by creating) a default value of the parameterized type `T`. This sets up the
@@ -47,7 +53,6 @@ import { ɵɵdefineInjectable } from './interface/defs';
  *
  * {@example core/di/ts/injector_spec.ts region='ShakableInjectionToken'}
  *
- *
  * @publicApi
  */
 export class InjectionToken {
@@ -65,6 +70,8 @@ export class InjectionToken {
         this._desc = _desc;
         this.ɵprov = undefined;
         if (typeof options == 'number') {
+            // This is a special hack to assign __NG_ELEMENT_ID__ to this instance.
+            // See `InjectorMarkers`
         }
         else if (options !== undefined) {
             this.ɵprov = ɵɵdefineInjectable({

package/import/es2022/di/injector.js

@@ -12,10 +12,10 @@ import { ɵɵdefineInjectable } from './interface/defs';
 import { NullInjector } from './null_injector';
 /**
  * Concrete injectors implement this interface. Injectors are configured
- * with [providers](guide/glossary#provider) that associate
- * dependencies of various types with [injection tokens](guide/glossary#di-token).
+ * with [providers](guide/dependency-injection-providers) that associate
+ * dependencies of various types with [injection tokens](guide/dependency-injection-providers).
  *
- * @see ["DI Providers"](guide/dependency-injection-providers).
+ * @see [DI Providers](guide/dependency-injection-providers).
  * @see {@link StaticProvider}
  *
  * @usageNotes

package/import/es2022/di/injector_compatibility.js

@@ -65,6 +65,27 @@ export function ɵɵinject(token, flags = InjectFlags.Default) {
 export function ɵɵinvalidFactoryDep(index) {
     throw new RuntimeError(202 /* RuntimeErrorCode.INVALID_FACTORY_DEPENDENCY */, null);
 }
+/**
+ * @param token A token that represents a static attribute on the host node that should be injected.
+ * @returns Value of the attribute if it exists.
+ * @throws If called outside of a supported context or the attribute does not exist.
+ *
+ * @publicApi
+ */
+/**
+ * @param token A token that represents a static attribute on the host node that should be injected.
+ * @returns Value of the attribute if it exists, otherwise `null`.
+ * @throws If called outside of a supported context.
+ *
+ * @publicApi
+ */
+/**
+ * @param token A token that represents a static attribute on the host node that should be injected.
+ * @returns Value of the attribute if it exists.
+ * @throws If called outside of a supported context or the attribute does not exist.
+ *
+ * @publicApi
+ */
 /**
  * Injects a token from the currently active injector.
  * `inject` is only supported in an [injection context](/guide/dependency-injection-context). It can
@@ -131,6 +152,8 @@ export function ɵɵinvalidFactoryDep(index) {
  * @publicApi
  */
 export function inject(token, flags = InjectFlags.Default) {
+    // The `as any` here _shouldn't_ be necessary, but without it JSCompiler
+    // throws a disambiguation  error due to the multiple signatures.
     return ɵɵinject(token, convertToBitFlags(flags));
 }
 // Converts object-based DI flags (`InjectOptions`) to bit flags (`InjectFlags`).

package/import/es2022/di/injector_token.js

@@ -14,8 +14,7 @@ import { InjectionToken } from './injection_token';
  *
  * @publicApi
  */
-export const INJECTOR = new InjectionToken('INJECTOR', 
+export const INJECTOR = new InjectionToken('', 
 // Disable tslint because this is const enum which gets inlined not top level prop access.
 // tslint:disable-next-line: no-toplevel-property-access
--1 /* InjectorMarkers.Injector */ // Special value used by Ivy to identify `Injector`.
-);
+-1 /* InjectorMarkers.Injector */);

package/import/es2022/di/internal_tokens.js

@@ -6,4 +6,4 @@
  * found in the LICENSE file at https://angular.io/license
  */
 import { InjectionToken } from './injection_token';
-export const INJECTOR_DEF_TYPES = new InjectionToken('INJECTOR_DEF_TYPES');
+export const INJECTOR_DEF_TYPES = new InjectionToken('');

package/import/es2022/di/r3_injector.js

@@ -8,7 +8,6 @@
 import { RuntimeError } from '../errors';
 import { getFactoryDef } from '../render3/definition_factory';
 import { NG_ENV_ID } from '../render3/fields';
-import { newArray } from '../util/array_utils';
 import { EMPTY_ARRAY } from '../util/empty';
 import { stringify } from '../util/stringify';
 import { resolveForwardRef } from './forward_ref';
@@ -94,7 +93,7 @@ export class R3Injector extends EnvironmentInjector {
         if (record != null && typeof record.value === 'string') {
             this.scopes.add(record.value);
         }
-        this.injectorDefTypes = new Set(this.get(INJECTOR_DEF_TYPES.multi, EMPTY_ARRAY, InjectFlags.Self));
+        this.injectorDefTypes = new Set(this.get(INJECTOR_DEF_TYPES, EMPTY_ARRAY, InjectFlags.Self));
     }
     /**
      * Destroy the injector and release references to every instance or provider associated with it.
@@ -168,6 +167,8 @@ export class R3Injector extends EnvironmentInjector {
                     if (def && this.injectableDefInScope(def)) {
                         // Found an injectable def and it's scoped to this injector. Pretend as if it was here
                         // all along.
+                        if (false) {
+                        }
                         record = makeRecord(injectableDefOrInjectorDefFactory(token), NOT_YET);
                     }
                     else {
@@ -224,7 +225,7 @@ export class R3Injector extends EnvironmentInjector {
         if (false) {
         }
         try {
-            const initializers = this.get(ENVIRONMENT_INITIALIZER.multi, EMPTY_ARRAY, InjectFlags.Self);
+            const initializers = this.get(ENVIRONMENT_INITIALIZER, EMPTY_ARRAY, InjectFlags.Self);
             if (false) {
             }
             for (const initializer of initializers) {
@@ -281,29 +282,32 @@ export class R3Injector extends EnvironmentInjector {
             multiRecord.multi.push(provider);
         }
         else {
-            const existing = this.records.get(token);
             if (false) {
             }
         }
         this.records.set(token, record);
     }
     hydrate(token, record) {
-        if (false) {
-        }
-        else if (record.value === NOT_YET) {
-            record.value = CIRCULAR;
+        try {
             if (false) {
             }
-            else {
-                record.value = record.factory();
+            else if (record.value === NOT_YET) {
+                record.value = CIRCULAR;
+                if (false) {
+                }
+                else {
+                    record.value = record.factory();
+                }
             }
+            if (typeof record.value === 'object' &&
+                record.value &&
+                hasOnDestroy(record.value)) {
+                this._ngOnDestroyHooks.add(record.value);
+            }
+            return record.value;
         }
-        if (typeof record.value === 'object' &&
-            record.value &&
-            hasOnDestroy(record.value)) {
-            this._ngOnDestroyHooks.add(record.value);
+        finally {
         }
-        return record.value;
     }
     injectableDefInScope(def) {
         if (!def.providedIn) {
@@ -347,7 +351,6 @@ function getUndecoratedInjectableFactory(token) {
     // If the token has parameters then it has dependencies that we cannot resolve implicitly.
     const paramLength = token.length;
     if (paramLength > 0) {
-        const args = newArray(paramLength, '?');
         throw new RuntimeError(204 /* RuntimeErrorCode.INVALID_INJECTION_TOKEN */, null);
     }
     // The constructor function appears to have no parameters.

package/import/es2022/di/scope.js

@@ -11,4 +11,4 @@ import { InjectionToken } from './injection_token';
  * as a root scoped injector when processing requests for unknown tokens which may indicate
  * they are provided in the root scope.
  */
-export const INJECTOR_SCOPE = new InjectionToken('Set Injector scope.');
+export const INJECTOR_SCOPE = new InjectionToken('');

package/import/es2022/di.js

@@ -0,0 +1,24 @@
+/**
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.io/license
+ */
+/**
+ * This file should not be necessary because node resolution should just default to `./di/index`!
+ *
+ * However it does not seem to work and it breaks:
+ *  - //packages/animations/browser/test:test_web_chromium-local
+ *  - //packages/compiler-cli/test:extract_i18n
+ *  - //packages/compiler-cli/test:ngc
+ *  - //packages/compiler-cli/test:perform_watch
+ *  - //packages/compiler-cli/test/diagnostics:check_types
+ *  - //packages/compiler-cli/test/transformers:test
+ *  - //packages/compiler/test:test
+ *  - //tools/public_api_guard:core_api
+ *
+ * Remove this file once the above is solved or wait until `ngc` is deleted and then it should be
+ * safe to delete this file.
+ */
+export * from './di/index';

package/import/es2022/render3/errors_di.js

@@ -8,6 +8,6 @@
 import { RuntimeError } from '../errors';
 /** Throws an error when a token is not found in DI. */
 export function throwProviderNotFoundError(token, injectorName) {
-    const injectorDetails = injectorName ? ` in ${injectorName}` : '';
-    throw new RuntimeError(-201 /* RuntimeErrorCode.PROVIDER_NOT_FOUND */, null);
+    const errorMessage = null;
+    throw new RuntimeError(-201 /* RuntimeErrorCode.PROVIDER_NOT_FOUND */, errorMessage);
 }

package/import/es2022/render3/instructions/di.js

@@ -1,3 +1,10 @@
+/**
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.io/license
+ */
 /**
  * Throws an error indicating that a factory function could not be generated by the compiler for a
  * particular class.

package/import/es2022/render3/util/stringify_utils.js

@@ -22,6 +22,7 @@ export function renderStringify(value) {
 }
 /**
  * Used to stringify a value so that it can be displayed in an error message.
+ *
  * Important! This function contains a megamorphic read and should only be
  * used for error messages.
  */

package/import/es2022/util/array_utils.js

@@ -1,3 +1,10 @@
+/**
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.io/license
+ */
 export function deepForEach(input, fn) {
     input.forEach((value) => Array.isArray(value) ? deepForEach(value, fn) : fn(value));
 }

package/import/es2022/util/stringify.js

@@ -28,3 +28,18 @@ export function stringify(token) {
     const newLineIndex = res.indexOf('\n');
     return newLineIndex === -1 ? res : res.substring(0, newLineIndex);
 }
+/**
+ * Ellipses the string in the middle when longer than the max length
+ *
+ * @param string
+ * @param maxLength of the output string
+ * @returns ellipsed string with ... in the middle
+ */
+export function truncateMiddle(str, maxLength = 100) {
+    if (!str || maxLength < 1 || str.length <= maxLength)
+        return str;
+    if (maxLength == 1)
+        return str.substring(0, 1) + '...';
+    const halfLimit = Math.round(maxLength / 2);
+    return (str.substring(0, halfLimit) + '...' + str.substring(str.length - halfLimit));
+}