@navios/di 0.8.0 → 0.9.0

package/lib/browser/utils/get-injectable-token.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-injectable-token.d.mts","names":[],"sources":["../../../src/utils/get-injectable-token.mts"],"sourcesContent":[],"mappings":";;;iBAKgB,8BACN,YACP;;AAFH,CAAA,GAGI,cAHY,CAGG,CAHH,CAAA,GAIZ,cAJ8B,CAIf,CAJe,CAAA"}

package/lib/browser/utils/get-injectable-token.mjs

@@ -0,0 +1,13 @@
+import { InjectableTokenMeta } from "../symbols/injectable-token.mjs";
+import { DIError } from "../errors/di-error.mjs";
+
+//#region src/utils/get-injectable-token.mts
+function getInjectableToken(target) {
+	const token = target[InjectableTokenMeta];
+	if (!token) throw DIError.classNotInjectable(target.name);
+	return token;
+}
+
+//#endregion
+export { getInjectableToken };
+//# sourceMappingURL=get-injectable-token.mjs.map

package/lib/browser/utils/get-injectable-token.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-injectable-token.mjs","names":["DIError","InjectableTokenMeta","getInjectableToken","target","token","classNotInjectable","name"],"sources":["../../../src/utils/get-injectable-token.mts"],"sourcesContent":["import type { ClassType, InjectionToken } from '../token/injection-token.mjs'\n\nimport { DIError } from '../errors/di-error.mjs'\nimport { InjectableTokenMeta } from '../symbols/index.mjs'\n\nexport function getInjectableToken<R>(\n  target: ClassType,\n): R extends { create(...args: any[]): infer V }\n  ? InjectionToken<V>\n  : InjectionToken<R> {\n  // @ts-expect-error We inject the token into the class itself\n  const token = target[InjectableTokenMeta] as InjectionToken<any, any>\n  if (!token) {\n    throw DIError.classNotInjectable(target.name)\n  }\n  // @ts-expect-error We detect factory or class\n  return token\n}\n"],"mappings":";;;;AAKA,SAAgBE,mBACdC,QAAiB;CAKjB,MAAMC,QAAQD,OAAOF;AACrB,KAAI,CAACG,MACH,OAAMJ,QAAQK,mBAAmBF,OAAOG,KAAI;AAG9C,QAAOF"}

package/lib/browser/utils/get-injectors.d.mts

@@ -0,0 +1,55 @@
+import { BoundInjectionToken, ClassType, ClassTypeWithArgument, ClassTypeWithoutArguments, FactoryInjectionToken, InjectionToken, InjectionTokenSchemaType } from "../token/injection-token.mjs";
+import { InjectState, Join, UnionToArray } from "./types.mjs";
+import { ServiceInitializationContext } from "../internal/context/service-initialization-context.mjs";
+import { Factorable, FactorableWithArgs } from "../interfaces/factory.interface.mjs";
+import { ZodType, z } from "zod/v4";
+
+//#region src/utils/get-injectors.d.mts
+interface Injectors {
+  asyncInject<T extends ClassTypeWithoutArguments>(token: T): InstanceType<T> extends Factorable<infer R> ? Promise<R> : Promise<InstanceType<T>>;
+  asyncInject<Args, T extends ClassTypeWithArgument<Args>>(token: T, args: Args): Promise<InstanceType<T>>;
+  asyncInject<Schema extends InjectionTokenSchemaType, R, T extends FactorableWithArgs<R, Schema>>(token: T, args: z.input<Schema>): Promise<R>;
+  asyncInject<T, S extends InjectionTokenSchemaType>(token: InjectionToken<T, S>, args: z.input<S>): Promise<T>;
+  asyncInject<T, S extends InjectionTokenSchemaType, R extends boolean>(token: InjectionToken<T, S, R>): R extends false ? Promise<T> : S extends ZodType<infer Type> ? `Error: Your token requires args: ${Join<UnionToArray<keyof Type>, ', '>}` : 'Error: Your token requires args';
+  asyncInject<T>(token: InjectionToken<T, undefined>): Promise<T>;
+  asyncInject<T>(token: BoundInjectionToken<T, any>): Promise<T>;
+  asyncInject<T>(token: FactoryInjectionToken<T, any>): Promise<T>;
+  inject<T extends ClassTypeWithoutArguments>(token: T): InstanceType<T> extends Factorable<infer R> ? R : InstanceType<T>;
+  inject<Args, T extends ClassTypeWithArgument<Args>>(token: T, args: Args): InstanceType<T>;
+  inject<Schema extends InjectionTokenSchemaType, R, T extends FactorableWithArgs<R, Schema>>(token: T, args: z.input<Schema>): R;
+  inject<T, S extends InjectionTokenSchemaType>(token: InjectionToken<T, S>, args: z.input<S>): T;
+  inject<T, S extends InjectionTokenSchemaType, R extends boolean>(token: InjectionToken<T, S, R>): R extends false ? T : S extends ZodType<infer Type> ? `Error: Your token requires args: ${Join<UnionToArray<keyof Type>, ', '>}` : 'Error: Your token requires args';
+  inject<T>(token: InjectionToken<T, undefined>): T;
+  inject<T>(token: BoundInjectionToken<T, any>): T;
+  inject<T>(token: FactoryInjectionToken<T, any>): T;
+  /**
+   * Optional injection that returns null if the service fails to initialize
+   * or is not available. This is useful when you want to inject a service
+   * that may not be configured or may fail gracefully.
+   *
+   * @example
+   * ```ts
+   * class MyService {
+   *   constructor() {
+   *     const optionalService = optional(OptionalServiceToken)
+   *     // optionalService will be null if initialization fails
+   *     if (optionalService) {
+   *       optionalService.doSomething()
+   *     }
+   *   }
+   * }
+   * ```
+   */
+  optional<T extends ClassType>(token: T): (InstanceType<T> extends Factorable<infer R> ? R : InstanceType<T>) | null;
+  optional<T, S extends InjectionTokenSchemaType>(token: InjectionToken<T, S>, args: z.input<S>): T | null;
+  optional<T, S extends InjectionTokenSchemaType, R extends boolean>(token: InjectionToken<T, S, R>): R extends false ? T | null : S extends ZodType<infer Type> ? `Error: Your token requires args: ${Join<UnionToArray<keyof Type>, ', '>}` : 'Error: Your token requires args';
+  optional<T>(token: InjectionToken<T, undefined>): T | null;
+  optional<T>(token: BoundInjectionToken<T, any>): T | null;
+  optional<T>(token: FactoryInjectionToken<T, any>): T | null;
+  wrapSyncInit(cb: () => any): (injectState?: InjectState) => [any, Promise<any>[], InjectState];
+  provideFactoryContext(context: ServiceInitializationContext | null): ServiceInitializationContext | null;
+}
+declare function getInjectors(): Injectors;
+//#endregion
+export { Injectors, getInjectors };
+//# sourceMappingURL=get-injectors.d.mts.map

package/lib/browser/utils/get-injectors.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-injectors.d.mts","names":[],"sources":["../../../src/utils/get-injectors.mts"],"sourcesContent":[],"mappings":"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"}

package/lib/browser/utils/get-injectors.mjs

@@ -0,0 +1,121 @@
+import { InjectableTokenMeta } from "../symbols/injectable-token.mjs";
+import { withoutResolutionContext } from "../internal/context/resolution-context.mjs";
+
+//#region src/utils/get-injectors.mts
+function getInjectors() {
+	let currentFactoryContext = null;
+	function provideFactoryContext(context) {
+		const original = currentFactoryContext;
+		currentFactoryContext = context;
+		return original;
+	}
+	function getFactoryContext() {
+		if (!currentFactoryContext) throw new Error("[Injector] Trying to access injection context outside of a injectable context");
+		return currentFactoryContext;
+	}
+	let promiseCollector = null;
+	let injectState = null;
+	function getRequest(token, args, skipCycleTracking = false) {
+		if (!injectState) throw new Error("[Injector] Trying to make a request outside of a injectable context");
+		if (injectState.isFrozen) {
+			const idx = injectState.currentIndex++;
+			const request$1 = injectState.requests[idx];
+			if (request$1.token !== token) throw new Error(`[Injector] Wrong token order. Expected ${request$1.token.toString()} but got ${token.toString()}`);
+			return request$1;
+		}
+		let result = null;
+		let error = null;
+		const doInject = () => getFactoryContext().inject(token, args).then((r) => {
+			result = r;
+			return r;
+		}).catch((e) => {
+			error = e;
+		});
+		const request = {
+			token,
+			promise: skipCycleTracking ? withoutResolutionContext(doInject) : doInject(),
+			get result() {
+				return result;
+			},
+			get error() {
+				return error;
+			}
+		};
+		injectState.requests.push(request);
+		injectState.currentIndex++;
+		return request;
+	}
+	function asyncInject(token, args) {
+		if (!injectState) throw new Error("[Injector] Trying to access inject outside of a injectable context");
+		const request = getRequest(token[InjectableTokenMeta] ?? token, args, true);
+		return request.promise.then((result) => {
+			if (request.error) throw request.error;
+			return result;
+		});
+	}
+	function wrapSyncInit(cb) {
+		return (previousState) => {
+			const promises = [];
+			const originalPromiseCollector = promiseCollector;
+			const originalInjectState = injectState;
+			injectState = previousState ? {
+				...previousState,
+				currentIndex: 0
+			} : {
+				currentIndex: 0,
+				isFrozen: false,
+				requests: []
+			};
+			promiseCollector = (promise) => {
+				promises.push(promise);
+			};
+			const result = cb();
+			promiseCollector = originalPromiseCollector;
+			const newInjectState = {
+				...injectState,
+				isFrozen: true
+			};
+			injectState = originalInjectState;
+			return [
+				result,
+				promises,
+				newInjectState
+			];
+		};
+	}
+	function inject(token, args) {
+		const realToken = token[InjectableTokenMeta] ?? token;
+		if (!injectState) throw new Error("[Injector] Trying to access inject outside of a injectable context");
+		const ctx = getFactoryContext();
+		const instance = ctx.container.tryGetSync(realToken, args);
+		if (!instance) {
+			const request = getRequest(realToken, args);
+			if (request.error) throw request.error;
+			else if (request.result) return request.result;
+			if (promiseCollector) promiseCollector(request.promise);
+			return new Proxy({}, { get() {
+				throw new Error(`[Injector] Trying to access ${realToken.toString()} before it's initialized, please move the code to a onServiceInit method`);
+			} });
+		}
+		ctx.inject(realToken, args).catch(() => {});
+		return instance;
+	}
+	function optional(token, args) {
+		try {
+			return inject(token, args);
+		} catch {
+			return null;
+		}
+	}
+	return {
+		asyncInject,
+		inject,
+		optional,
+		wrapSyncInit,
+		provideFactoryContext
+	};
+}
+
+//#endregion
+export { getInjectors };
+//# sourceMappingURL=get-injectors.mjs.map

package/lib/browser/utils/get-injectors.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-injectors.mjs","names":["withoutResolutionContext","InjectableTokenMeta","getInjectors","currentFactoryContext","provideFactoryContext","context","original","getFactoryContext","Error","promiseCollector","injectState","getRequest","token","args","skipCycleTracking","isFrozen","idx","currentIndex","request","requests","toString","result","error","doInject","inject","then","r","catch","e","promise","push","asyncInject","realToken","wrapSyncInit","cb","previousState","promises","originalPromiseCollector","originalInjectState","newInjectState","ctx","instance","container","tryGetSync","Proxy","get","optional","injectors"],"sources":["../../../src/utils/get-injectors.mts"],"sourcesContent":["import type { z, ZodObject, ZodType } from 'zod/v4'\n\nimport type {\n  Factorable,\n  FactorableWithArgs,\n} from '../interfaces/factory.interface.mjs'\nimport type { ServiceInitializationContext } from '../internal/context/service-initialization-context.mjs'\nimport type {\n  BoundInjectionToken,\n  ClassType,\n  ClassTypeWithArgument,\n  ClassTypeWithoutArguments,\n  FactoryInjectionToken,\n  InjectionToken,\n  InjectionTokenSchemaType,\n} from '../token/injection-token.mjs'\nimport type {\n  InjectRequest,\n  InjectState,\n  Join,\n  UnionToArray,\n} from './types.mjs'\n\nimport { withoutResolutionContext } from '../internal/context/resolution-context.mjs'\nimport { InjectableTokenMeta } from '../symbols/index.mjs'\n\nexport interface Injectors {\n  // #1 Simple class\n  asyncInject<T extends ClassTypeWithoutArguments>(\n    token: T,\n  ): InstanceType<T> extends Factorable<infer R>\n    ? Promise<R>\n    : Promise<InstanceType<T>>\n  asyncInject<Args, T extends ClassTypeWithArgument<Args>>(\n    token: T,\n    args: Args,\n  ): Promise<InstanceType<T>>\n  asyncInject<\n    Schema extends InjectionTokenSchemaType,\n    R,\n    T extends FactorableWithArgs<R, Schema>,\n  >(\n    token: T,\n    args: z.input<Schema>,\n  ): Promise<R>\n\n  // #2 Token with required Schema\n  asyncInject<T, S extends InjectionTokenSchemaType>(\n    token: InjectionToken<T, S>,\n    args: z.input<S>,\n  ): Promise<T>\n  // #3 Token with optional Schema\n  asyncInject<T, S extends InjectionTokenSchemaType, R extends boolean>(\n    token: InjectionToken<T, S, R>,\n  ): R extends false\n    ? Promise<T>\n    : S extends ZodType<infer Type>\n      ? `Error: Your token requires args: ${Join<\n          UnionToArray<keyof Type>,\n          ', '\n        >}`\n      : 'Error: Your token requires args'\n  // #4 Token with no Schema\n  asyncInject<T>(token: InjectionToken<T, undefined>): Promise<T>\n  asyncInject<T>(token: BoundInjectionToken<T, any>): Promise<T>\n  asyncInject<T>(token: FactoryInjectionToken<T, any>): Promise<T>\n\n  inject<T extends ClassTypeWithoutArguments>(\n    token: T,\n  ): InstanceType<T> extends Factorable<infer R> ? R : InstanceType<T>\n  inject<Args, T extends ClassTypeWithArgument<Args>>(\n    token: T,\n    args: Args,\n  ): InstanceType<T>\n  inject<\n    Schema extends InjectionTokenSchemaType,\n    R,\n    T extends FactorableWithArgs<R, Schema>,\n  >(\n    token: T,\n    args: z.input<Schema>,\n  ): R\n\n  inject<T, S extends InjectionTokenSchemaType>(\n    token: InjectionToken<T, S>,\n    args: z.input<S>,\n  ): T\n  // #3 Token with optional Schema\n  inject<T, S extends InjectionTokenSchemaType, R extends boolean>(\n    token: InjectionToken<T, S, R>,\n  ): R extends false\n    ? T\n    : S extends ZodType<infer Type>\n      ? `Error: Your token requires args: ${Join<\n          UnionToArray<keyof Type>,\n          ', '\n        >}`\n      : 'Error: Your token requires args'\n  inject<T>(token: InjectionToken<T, undefined>): T\n  inject<T>(token: BoundInjectionToken<T, any>): T\n  inject<T>(token: FactoryInjectionToken<T, any>): T\n\n  /**\n   * Optional injection that returns null if the service fails to initialize\n   * or is not available. This is useful when you want to inject a service\n   * that may not be configured or may fail gracefully.\n   *\n   * @example\n   * ```ts\n   * class MyService {\n   *   constructor() {\n   *     const optionalService = optional(OptionalServiceToken)\n   *     // optionalService will be null if initialization fails\n   *     if (optionalService) {\n   *       optionalService.doSomething()\n   *     }\n   *   }\n   * }\n   * ```\n   */\n  optional<T extends ClassType>(\n    token: T,\n  ): (InstanceType<T> extends Factorable<infer R> ? R : InstanceType<T>) | null\n  optional<T, S extends InjectionTokenSchemaType>(\n    token: InjectionToken<T, S>,\n    args: z.input<S>,\n  ): T | null\n  optional<T, S extends InjectionTokenSchemaType, R extends boolean>(\n    token: InjectionToken<T, S, R>,\n  ): R extends false\n    ? T | null\n    : S extends ZodType<infer Type>\n      ? `Error: Your token requires args: ${Join<\n          UnionToArray<keyof Type>,\n          ', '\n        >}`\n      : 'Error: Your token requires args'\n  optional<T>(token: InjectionToken<T, undefined>): T | null\n  optional<T>(token: BoundInjectionToken<T, any>): T | null\n  optional<T>(token: FactoryInjectionToken<T, any>): T | null\n\n  wrapSyncInit(\n    cb: () => any,\n  ): (injectState?: InjectState) => [any, Promise<any>[], InjectState]\n\n  provideFactoryContext(\n    context: ServiceInitializationContext | null,\n  ): ServiceInitializationContext | null\n}\n\nexport function getInjectors() {\n  let currentFactoryContext: ServiceInitializationContext | null = null\n\n  function provideFactoryContext(\n    context: ServiceInitializationContext | null,\n  ): ServiceInitializationContext | null {\n    const original = currentFactoryContext\n    currentFactoryContext = context\n    return original\n  }\n  function getFactoryContext(): ServiceInitializationContext {\n    if (!currentFactoryContext) {\n      throw new Error(\n        '[Injector] Trying to access injection context outside of a injectable context',\n      )\n    }\n    return currentFactoryContext\n  }\n\n  let promiseCollector: null | ((promise: Promise<any>) => void) = null\n  let injectState: InjectState | null = null\n\n  function getRequest(\n    token: InjectionToken<any>,\n    args?: unknown,\n    skipCycleTracking = false,\n  ) {\n    if (!injectState) {\n      throw new Error(\n        '[Injector] Trying to make a request outside of a injectable context',\n      )\n    }\n    if (injectState.isFrozen) {\n      const idx = injectState.currentIndex++\n      const request = injectState.requests[idx]\n      if (request.token !== token) {\n        throw new Error(\n          `[Injector] Wrong token order. Expected ${request.token.toString()} but got ${token.toString()}`,\n        )\n      }\n      return request\n    }\n    let result: any = null\n    let error: Error | null = null\n\n    // For async inject, we run outside the resolution context to skip cycle tracking.\n    // This is because asyncInject returns a promise that doesn't block the constructor,\n    // so it cannot cause a deadlock even with circular dependencies.\n    const doInject = () =>\n      getFactoryContext()\n        .inject(token as any, args as any)\n        .then((r) => {\n          result = r\n          return r\n        })\n        .catch((e) => {\n          // We don't throw here because we have a mechanism to handle errors\n          error = e\n        })\n\n    const promise = skipCycleTracking\n      ? withoutResolutionContext(doInject)\n      : doInject()\n\n    const request: InjectRequest = {\n      token,\n      promise,\n      get result() {\n        return result\n      },\n      get error() {\n        return error\n      },\n    }\n    injectState.requests.push(request)\n    injectState.currentIndex++\n\n    return request\n  }\n\n  function asyncInject(\n    token:\n      | ClassType\n      | InjectionToken<any>\n      | BoundInjectionToken<any, any>\n      | FactoryInjectionToken<any, any>,\n    args?: unknown,\n  ) {\n    if (!injectState) {\n      throw new Error(\n        '[Injector] Trying to access inject outside of a injectable context',\n      )\n    }\n    // @ts-expect-error In case we have a class\n    const realToken = token[InjectableTokenMeta] ?? token\n    // Pass skipCycleTracking=true because asyncInject returns a promise that doesn't\n    // block the constructor, so it cannot cause a deadlock even with circular dependencies.\n    const request = getRequest(realToken, args, true)\n    return request.promise.then((result) => {\n      if (request.error) {\n        // We throw here because we want to fail the asyncInject call if the dependency fails to initialize\n        throw request.error\n      }\n      return result\n    })\n  }\n\n  function wrapSyncInit(cb: () => any) {\n    return (previousState?: InjectState) => {\n      const promises: Promise<any>[] = []\n      const originalPromiseCollector = promiseCollector\n      const originalInjectState = injectState\n      injectState = previousState\n        ? {\n            ...previousState,\n            currentIndex: 0,\n          }\n        : {\n            currentIndex: 0,\n            isFrozen: false,\n            requests: [],\n          }\n      promiseCollector = (promise) => {\n        promises.push(promise)\n      }\n      const result = cb()\n      promiseCollector = originalPromiseCollector\n      const newInjectState = {\n        ...injectState,\n        isFrozen: true,\n      }\n      injectState = originalInjectState\n      return [result, promises, newInjectState]\n    }\n  }\n\n  function inject<\n    T,\n    Token extends\n      | InjectionToken<T>\n      | BoundInjectionToken<T, any>\n      | FactoryInjectionToken<T, any>,\n    S extends ZodObject | unknown = Token['schema'],\n  >(token: Token, args?: S extends ZodObject ? z.input<S> : never): T {\n    // @ts-expect-error In case we have a class\n    const realToken = token[InjectableTokenMeta] ?? token\n\n    if (!injectState) {\n      throw new Error(\n        '[Injector] Trying to access inject outside of a injectable context',\n      )\n    }\n\n    const ctx = getFactoryContext()\n    const instance = ctx.container.tryGetSync(realToken, args)\n    if (!instance) {\n      const request = getRequest(realToken, args)\n      if (request.error) {\n        throw request.error\n      } else if (request.result) {\n        return request.result\n      }\n      if (promiseCollector) {\n        promiseCollector(request.promise)\n      }\n      // Return a dynamic proxy that looks up the instance when accessed\n      return new Proxy(\n        {},\n        {\n          get() {\n            throw new Error(\n              `[Injector] Trying to access ${realToken.toString()} before it's initialized, please move the code to a onServiceInit method`,\n            )\n          },\n        },\n      ) as unknown as T\n    }\n\n    // Even when tryGetSync returns an existing instance, we still need to\n    // track the dependency for scope upgrade. This ensures that if a Singleton\n    // service depends on an already-created Request-scoped service, the\n    // Singleton will be properly upgraded to Request scope.\n    // The ctx.inject call handles dependency tracking and scope upgrades.\n    // We fire-and-forget this since we already have the instance.\n    ctx.inject(realToken, args).catch(() => {\n      // Ignore errors - we already have the instance\n    })\n\n    return instance as unknown as T\n  }\n\n  function optional<\n    T,\n    Token extends\n      | InjectionToken<T>\n      | BoundInjectionToken<T, any>\n      | FactoryInjectionToken<T, any>,\n    S extends ZodObject | unknown = Token['schema'],\n  >(token: Token, args?: S extends ZodObject ? z.input<S> : never): T | null {\n    try {\n      return inject(token, args)\n    } catch {\n      // If injection fails, return null instead of throwing\n      return null\n    }\n  }\n\n  const injectors: Injectors = {\n    asyncInject,\n    inject,\n    optional,\n    wrapSyncInit,\n    provideFactoryContext,\n  } as Injectors\n\n  return injectors\n}\n"],"mappings":"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"}

package/lib/browser/utils/types.d.mts

@@ -0,0 +1,23 @@
+import { BoundInjectionToken, ClassType, FactoryInjectionToken, InjectionToken } from "../token/injection-token.mjs";
+
+//#region src/utils/types.d.mts
+type Join<TElements, TSeparator extends string> = TElements extends Readonly<[infer First, ...infer Rest]> ? Rest extends ReadonlyArray<string> ? First extends string ? `${First}${Rest extends [] ? '' : TSeparator}${Join<Rest, TSeparator>}` : never : never : '';
+type UnionToIntersection<U> = (U extends any ? (k: U) => void : never) extends ((k: infer I) => void) ? I : never;
+type UnionToOvlds<U> = UnionToIntersection<U extends any ? (f: U) => void : never>;
+type PopUnion<U> = UnionToOvlds<U> extends ((a: infer A) => void) ? A : never;
+type IsUnion<T> = [T] extends [UnionToIntersection<T>] ? false : true;
+type UnionToArray<T, A extends unknown[] = []> = IsUnion<T> extends true ? UnionToArray<Exclude<T, PopUnion<T>>, [PopUnion<T>, ...A]> : [T, ...A];
+type InjectRequest = {
+  token: InjectionToken<any> | BoundInjectionToken<any, any> | FactoryInjectionToken<any, any> | ClassType;
+  promise: Promise<any>;
+  readonly result: any;
+  readonly error: Error | null;
+};
+interface InjectState {
+  currentIndex: number;
+  isFrozen: boolean;
+  requests: InjectRequest[];
+}
+//#endregion
+export { InjectRequest, InjectState, IsUnion, Join, PopUnion, UnionToArray, UnionToIntersection, UnionToOvlds };
+//# sourceMappingURL=types.d.mts.map

package/lib/browser/utils/types.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.mts","names":[],"sources":["../../../src/utils/types.mts"],"sourcesContent":[],"mappings":";;;KAQY,6CACV,kBAAkB,sDACD,kDAEN,+BAA+B,aAAa,KAAK,MAAM;KAMxD,0BACV,oBAAoB;AAXV,KAiBA,YAjBI,CAAA,CAAA,CAAA,GAiBc,mBAjBd,CAkBd,CAlBc,SAAA,GAAA,GAAA,CAAA,CAAA,EAkBM,CAlBN,EAAA,GAAA,IAAA,GAAA,KAAA,CAAA;AACd,KAoBU,QApBV,CAAA,CAAA,CAAA,GAqBA,YArBA,CAqBa,CArBb,CAAA,UAAA,CAAA,CAAA,EAAA,KAAA,EAAA,EAAA,GAAA,IAAA,IAAA,CAAA,GAAA,KAAA;AAAkB,KAuBR,OAvBQ,CAAA,CAAA,CAAA,GAAA,CAuBM,CAvBN,CAAA,SAAA,CAuBkB,mBAvBlB,CAuBsC,CAvBtC,CAAA,CAAA,GAAA,KAAA,GAAA,IAAA;AACD,KAwBP,YAxBO,CAAA,CAAA,EAAA,UAAA,OAAA,EAAA,GAAA,EAAA,CAAA,GAyBjB,OAzBiB,CAyBT,CAzBS,CAAA,SAAA,IAAA,GA0Bb,YA1Ba,CA0BA,OA1BA,CA0BQ,CA1BR,EA0BW,QA1BX,CA0BoB,CA1BpB,CAAA,CAAA,EAAA,CA0B0B,QA1B1B,CA0BmC,CA1BnC,CAAA,EAAA,GA0B0C,CA1B1C,CAAA,CAAA,GAAA,CA2BZ,CA3BY,EAAA,GA2BN,CA3BM,CAAA;AAEN,KA2BD,aAAA,GA3BC;EAA+B,KAAA,EA6BtC,cA7BsC,CAAA,GAAA,CAAA,GA8BtC,mBA9BsC,CAAA,GAAA,EAAA,GAAA,CAAA,GA+BtC,qBA/BsC,CAAA,GAAA,EAAA,GAAA,CAAA,GAgCtC,SAhCsC;EAAkB,OAAA,EAiCnD,OAjCmD,CAAA,GAAA,CAAA;EAAM,SAAA,MAAA,EAAA,GAAA;EAAX,SAAA,KAAA,EAmCvC,KAnCuC,GAAA,IAAA;CAAI;AAMjD,UAiCK,WAAA,CAjCc;EAOnB,YAAA,EAAA,MAAY;EACtB,QAAA,EAAA,OAAA;EAAoB,QAAA,EA4BV,aA5BU,EAAA"}