npm - atomic-di - Versions diffs - 0.8.0-beta.1 → 0.8.1-beta.1 - Mend

atomic-di 0.8.0-beta.1 → 0.8.1-beta.1

Files changed (7) hide show

package/dist/index.d.mts CHANGED Viewed

@@ -88,7 +88,7 @@ type Scope = Map<Provider<any>, any>;
 declare const createScope: () => Scope;
 /**
- * A wrapper around the resolver for contextual dependency resolution.
+ * A wrapper around the resolver(factory) for contextual dependency resolution.
  *
  * Resolves an instance by calling a resolver
  * with a resolution context that will be propagated
@@ -132,7 +132,7 @@ type ResolutionContext = {
 };
 /**
  * Creates a provider instance,
- * a wrapper around a resolver for contextual dependency resolution.
+ * a wrapper around a resolver(factory) for contextual dependency resolution.
  *
  * @param lifetime
  * A resolution lifetime.
@@ -155,7 +155,7 @@ type ResolutionContext = {
 declare const provide: <T>(lifetime: Lifetime, resolver: Resolver<T>) => Provider<T>;
 /**
  * Creates a transient provider instance,
- * a wrapper around a resolver for contextual dependency resolution
+ * a wrapper around a resolver(factory) for contextual dependency resolution
  * that will create a new instance on each request.
  *
  * @param resolver
@@ -166,7 +166,7 @@ declare const provide: <T>(lifetime: Lifetime, resolver: Resolver<T>) => Provide
 declare const transient: <T>(resolver: Resolver<T>) => Provider<T>;
 /**
  * Creates a transient provider instance,
- * a wrapper around a resolver for contextual dependency resolution
+ * a wrapper around a resolver(factory) for contextual dependency resolution
  * that will create an instance once and return it in subsequent requests.
  *
  * @param resolver
@@ -177,7 +177,7 @@ declare const transient: <T>(resolver: Resolver<T>) => Provider<T>;
 declare const singleton: <T>(resolver: Resolver<T>) => Provider<T>;
 /**
  * Creates a transient provider instance,
- * a wrapper around a resolver for contextual dependency resolution
+ * a wrapper around a resolver(factory) for contextual dependency resolution
  * that will take its resolution from a provided scope
  * or create a new one and save it if there is none.
  * If no scope is passed, it will create a new instance on each request.

package/dist/index.d.ts CHANGED Viewed

@@ -88,7 +88,7 @@ type Scope = Map<Provider<any>, any>;
 declare const createScope: () => Scope;
 /**
- * A wrapper around the resolver for contextual dependency resolution.
+ * A wrapper around the resolver(factory) for contextual dependency resolution.
  *
  * Resolves an instance by calling a resolver
  * with a resolution context that will be propagated
@@ -132,7 +132,7 @@ type ResolutionContext = {
 };
 /**
  * Creates a provider instance,
- * a wrapper around a resolver for contextual dependency resolution.
+ * a wrapper around a resolver(factory) for contextual dependency resolution.
  *
  * @param lifetime
  * A resolution lifetime.
@@ -155,7 +155,7 @@ type ResolutionContext = {
 declare const provide: <T>(lifetime: Lifetime, resolver: Resolver<T>) => Provider<T>;
 /**
  * Creates a transient provider instance,
- * a wrapper around a resolver for contextual dependency resolution
+ * a wrapper around a resolver(factory) for contextual dependency resolution
  * that will create a new instance on each request.
  *
  * @param resolver
@@ -166,7 +166,7 @@ declare const provide: <T>(lifetime: Lifetime, resolver: Resolver<T>) => Provide
 declare const transient: <T>(resolver: Resolver<T>) => Provider<T>;
 /**
  * Creates a transient provider instance,
- * a wrapper around a resolver for contextual dependency resolution
+ * a wrapper around a resolver(factory) for contextual dependency resolution
  * that will create an instance once and return it in subsequent requests.
  *
  * @param resolver
@@ -177,7 +177,7 @@ declare const transient: <T>(resolver: Resolver<T>) => Provider<T>;
 declare const singleton: <T>(resolver: Resolver<T>) => Provider<T>;
 /**
  * Creates a transient provider instance,
- * a wrapper around a resolver for contextual dependency resolution
+ * a wrapper around a resolver(factory) for contextual dependency resolution
  * that will take its resolution from a provided scope
  * or create a new one and save it if there is none.
  * If no scope is passed, it will create a new instance on each request.

package/dist/index.js CHANGED Viewed

@@ -44,18 +44,17 @@ var once = (fn) => {
 // src/provider.ts
 var provide = (lifetime, resolver) => {
-  const getSelf = once(() => resolve);
   resolver = lifetime === "singleton" ? once(resolver) : resolver;
   const resolve = (context) => {
     var _a;
-    const maybeOwnMock = (_a = context == null ? void 0 : context.mocks) == null ? void 0 : _a.get(getSelf());
+    const maybeOwnMock = (_a = context == null ? void 0 : context.mocks) == null ? void 0 : _a.get(resolve);
     if (maybeOwnMock) return maybeOwnMock(context);
     if (lifetime !== "scoped" || !(context == null ? void 0 : context.scope)) return resolver(context);
-    const resolution = context.scope.has(getSelf()) ? context.scope.get(getSelf()) : resolver(context);
-    context.scope.set(getSelf(), resolution);
+    const resolution = context.scope.has(resolve) ? context.scope.get(resolve) : resolver(context);
+    context.scope.set(resolve, resolution);
     return resolution;
   };
-  return getSelf();
+  return resolve;
 };
 var transient = (resolver) => provide("transient", resolver);
 var singleton = (resolver) => provide("singleton", resolver);
@@ -64,7 +63,7 @@ var scoped = (resolver) => provide("scoped", resolver);
 // src/scope.ts
 var createScope = () => /* @__PURE__ */ new Map();
-// src/readonly-map.ts
+// src/immutable-map.ts
 var createImmutableMap = (entries = []) => {
   const get = (key) => {
     var _a;

package/dist/index.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"sources":["../src/index.ts","../src/helpers.ts","../src/provider.ts","../src/scope.ts","../src/readonly-map.ts","../src/mock-map.ts","../src/collection-resolution.ts"],"sourcesContent":["export * from \"./provider\";\nexport * from \"./scope\";\nexport * from \"./mock-map\";\nexport * from \"./collection-resolution\";\n","/*\n Creates a function that will invoke the provided function `fn` only once,\n * caching the result for subsequent calls with the same arguments.\n \n @returns A new function that returns the cached result after the first call.\n /\nexport const once = <A extends any[], R>(\n /\n The function to invoke once and cache the result.\n /\n fn: (...args: A) => R,\n) => {\n let returned = false;\n let result: R \| undefined;\n\n return Object.assign((...args: A): R => {\n if (returned) return result!;\n\n result = fn(...args);\n returned = true;\n\n return result;\n }, fn);\n};\n","import { once } from \"./helpers\";\nimport { MockMap } from \"./mock-map\";\nimport { Scope } from \"./scope\";\n\n/\n A wrapper around the resolver for contextual dependency resolution.\n \n Resolves an instance by calling a resolver\n * with a resolution context that will be propagated\n * throughout a dependency tree.\n \n When passing a scope it will try to get an instance from it\n * or create a new one and put it there.\n \n When passing mocks, it will try to get its own mock version,\n * and if there is one, it will use it instead of itself.\n /\nexport type Provider<T> = (context?: ResolutionContext) => T;\n\n/\n A resolution lifetime.\n \n Passed when creating a provider to determine its behavior.\n \n `\"transient\"` doesn't provide any modifications to a resolver behaviour,\n * so the resolver will create a new instance on each request.\n \n `\"singleton\"` forces the resolver to create an instance once\n * and return it in subsequent requests.\n \n `\"scoped\"` forces the resolver to take its instance from a provided scope\n * or create a new one and save it if there is none.\n * If no scope is passed, it will create a new instance on each request.\n /\nexport type Lifetime = \"transient\" \| \"singleton\" \| \"scoped\";\n\n/\n A function that creates an instance using a resolution context.\n /\nexport type Resolver<T> = (context?: ResolutionContext) => T;\n\n/\n An object that holds information about a scope and provider mocks.\n \n Passed to the provider call to resolve scope instances and mock providers.\n /\nexport type ResolutionContext = {\n scope?: Scope;\n mocks?: MockMap;\n};\n\n/\n Creates a provider instance,\n * a wrapper around a resolver for contextual dependency resolution.\n \n @param lifetime\n * A resolution lifetime.\n \n `\"transient\"` doesn't provide any modifications to a resolver behaviour,\n * so the resolver will create a new instance on each request.\n \n `\"singleton\"` forces the resolver to create an instance once\n * and return it in subsequent requests.\n \n `\"scoped\"` forces the resolver to take its resolution from a provided scope\n * or create a new one and save it if there is none.\n * If no scope is passed, it will create a new instance on each request.\n \n @param resolver\n * The function that creates an instance using a resolution context.\n \n @returns The provider instance.\n /\nexport const provide = <T>(\n lifetime: Lifetime,\n resolver: Resolver<T>,\n): Provider<T> => {\n const getSelf = once(() => resolve);\n\n resolver = lifetime === \"singleton\" ? once(resolver) : resolver;\n\n const resolve: Provider<T> = (context) => {\n const maybeOwnMock = context?.mocks?.get(getSelf());\n if (maybeOwnMock) return maybeOwnMock(context);\n\n if (lifetime !== \"scoped\" \|\| !context?.scope) return resolver(context);\n\n const resolution = context.scope.has(getSelf())\n ? context.scope.get(getSelf())\n : resolver(context);\n context.scope.set(getSelf(), resolution);\n\n return resolution;\n };\n\n return getSelf();\n};\n\n/\n Creates a transient provider instance,\n * a wrapper around a resolver for contextual dependency resolution\n * that will create a new instance on each request.\n \n @param resolver\n * The function that creates an instance using a resolution context.\n \n @returns The transient provider instance.\n /\nexport const transient = <T>(resolver: Resolver<T>) =>\n provide(\"transient\", resolver);\n\n/\n Creates a transient provider instance,\n * a wrapper around a resolver for contextual dependency resolution\n * that will create an instance once and return it in subsequent requests.\n \n @param resolver\n * The function that creates an instance using a resolution context.\n \n @returns The singleton provider instance.\n /\nexport const singleton = <T>(resolver: Resolver<T>) =>\n provide(\"singleton\", resolver);\n\n/\n Creates a transient provider instance,\n * a wrapper around a resolver for contextual dependency resolution\n * that will take its resolution from a provided scope\n * or create a new one and save it if there is none.\n * If no scope is passed, it will create a new instance on each request.\n \n @param resolver\n * The function that creates an instance using a resolution context.\n \n @returns The scoped provider instance.\n /\nexport const scoped = <T>(resolver: Resolver<T>) => provide(\"scoped\", resolver);\n","import { Provider } from \"./provider\";\n\n/\n A map of providers to their instances.\n \n Passed to a provider call in a resolution context object\n * to resolve instances of scoped providers within it.\n * ```ts\n * const scope = createScope()\n * provider({ scope })\n * ```\n /\nexport type Scope = Map<Provider<any>, any>;\n\n/\n Creates a scope instance.\n \n Scope is passed to a provider call in a resolution context object\n * to resolve instances of scoped providers within it.\n * ```ts\n * const scope = createScope()\n * provider({ scope })\n * ```\n \n @returns The scope instance.\n /\nexport const createScope = (): Scope => new Map();\n","export type Entry<K, V> = [K, V];\nexport type Entries<K, V> = Entry<K, V>[];\n\n/\n An immutable map. It's similar to `Map`,\n * but with reduced functionality and readonly builder behavior.\n /\nexport type ImmutableMap<K, V> = {\n /\n Map's entries.\n /\n readonly entries: Entries<K, V>;\n\n /\n Retrieves a possibly existing value under a key.\n \n @param key - The key associated with the value.\n \n @returns The value or undefined.\n /\n get(key: K): V \| undefined;\n\n /\n Sets a value under a key.\n \n @param key - The key that will be associated with the value.\n * @param value - The value to set.\n \n @returns A modified immutable map with the value being set in it.\n /\n set(key: K, value: V): ImmutableMap<K, V>;\n\n /\n Merges two immutable maps. If there're any matching keys,\n * values from the second map will override values from the first map.\n \n @param other The second immutable map.\n \n @returns A new immutable map as a result of merging two maps.\n /\n merge(other: ImmutableMap<K, V>): ImmutableMap<K, V>;\n};\n\n/\n Creates an immutable map. It's similar to `Map`,\n * but with reduced functionality and readonly builder behavior.\n \n @param entries - Map's entries.\n \n @returns The immutable map.\n /\nexport const createImmutableMap = <K, V>(\n entries: Entries<K, V> = [],\n): ImmutableMap<K, V> => {\n const get = (key: K) => entries.find((entry) => entry[0] === key)?.[1];\n\n const set = (key: K, value: V) => {\n if (get(key) !== undefined) {\n const newEntries: Entries<K, V> = entries.map((entry) =>\n entry[0] === key ? [entry[0], value] : entry,\n );\n\n return createImmutableMap(newEntries);\n }\n\n const newEntries: Entries<K, V> = [...entries, [key, value]];\n\n return createImmutableMap(newEntries);\n };\n\n const merge = (other: ImmutableMap<K, V>) => {\n const newEntries: Entries<K, V> = [\n ...entries.filter((entry) => other.get(entry[0]) === undefined),\n ...other.entries,\n ];\n\n return createImmutableMap(newEntries);\n };\n\n return Object.freeze({\n entries,\n get,\n set,\n merge,\n });\n};\n","import { Provider } from \"./provider\";\nimport { createImmutableMap, ImmutableMap } from \"./readonly-map\";\n\n/\n A map of providers to their compatible versions.\n \n Passed to a provider call in a resolution context object\n * in order to replace providers with their mocks.\n * ```ts\n * const mocks = createMockMap().set(otherProvider, otherProviderMock)\n * provider({ mocks })\n * ```\n /\nexport type MockMap = ImmutableMap<Provider<any>, Provider<any>>;\n\n/\n Creates a mock map instance.\n \n Passed to a provider call in a resolution context object\n * in order to replace providers with their mocks.\n * ```ts\n * const mocks = createMockMap().set(otherProvider, otherProviderMock)\n * provider({ mocks })\n * ```\n \n @returns The mock map instance.\n /\nexport const createMockMap = (): MockMap => createImmutableMap();\n","import { Provider, ResolutionContext } from \"./provider\";\n\ntype ProviderList = Provider<any>[];\ntype ProviderRecord = Record<string, Provider<any>>;\n\ntype InferProviderCollectionResolutions<\n Providers extends ProviderList \| ProviderRecord,\n> = {\n [K in keyof Providers]: Providers[K] extends Provider<infer T> ? T : never;\n};\n\n/\n Awaits all promises and wraps the collection in a promise\n * if there'ss at least one `Promise` in the collection,\n * otherwise returns an untouched type.\n /\ntype AwaitAllValuesInCollection<T extends any[] \| Record<any, any>> =\n Promise<any> extends T[keyof T]\n ? Promise<{\n [I in keyof T]: T[I] extends Promise<infer T> ? T : T[I];\n }>\n : T;\n\n/\n Calls every provider in a list with a provided resolution context\n * and returns a list of resolutions. Returns a promise of a list\n * of awaited resolutions if there's at least one promise in the resolutions.\n \n @param providers - The list of providers.\n * @param context - The resolution context.\n \n @returns The list of resolutions.\n /\nexport const resolveList = <const Providers extends ProviderList>(\n providers: Providers,\n context?: ResolutionContext,\n): AwaitAllValuesInCollection<\n InferProviderCollectionResolutions<Providers>\n> => {\n const resolutions = providers.map((provider) => provider(context));\n\n return (\n resolutions.some((resolution) => resolution instanceof Promise)\n ? Promise.all(resolutions)\n : resolutions\n ) as any;\n};\n\n/\n Calls every provider in a map with a provided resolution context\n * and returns a map with identical keys but with resolutions in values instead.\n * Returns a promise of a map of awaited resolutions if there's at least one\n * promise in the resolutions.\n \n @param providers - The map of providers.\n * @param context - The resolution context.\n \n @returns The map of resolutions.\n */\nexport const resolveMap = <const Providers extends ProviderRecord>(\n providers: Providers,\n context?: ResolutionContext,\n): AwaitAllValuesInCollection<\n InferProviderCollectionResolutions<Providers>\n> => {\n let resolutionMapEntries = Object.entries(providers).map(\n ([key, provider]) => [key, provider(context)],\n );\n\n if (\n resolutionMapEntries.some(\n ([, resolution]) => resolution instanceof Promise,\n )\n ) {\n return (async () => {\n resolutionMapEntries = await Promise.all(\n resolutionMapEntries.map(async ([key, resolution]) => [\n key,\n await resolution,\n ]),\n );\n\n return Object.fromEntries(resolutionMapEntries);\n })() as any;\n }\n\n return Object.fromEntries(resolutionMapEntries);\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACMO,IAAM,OAAO,CAIhB,OACC;AACD,MAAI,WAAW;AACf,MAAI;AAEJ,SAAO,OAAO,OAAO,IAAI,SAAe;AACpC,QAAI,SAAU,QAAO;AAErB,aAAS,GAAG,GAAG,IAAI;AACnB,eAAW;AAEX,WAAO;AAAA,EACX,GAAG,EAAE;AACT;;;ACkDO,IAAM,UAAU,CACnB,UACA,aACc;AACd,QAAM,UAAU,KAAK,MAAM,OAAO;AAElC,aAAW,aAAa,cAAc,KAAK,QAAQ,IAAI;AAEvD,QAAM,UAAuB,CAAC,YAAY;AAjF9C;AAkFQ,UAAM,gBAAe,wCAAS,UAAT,mBAAgB,IAAI,QAAQ;AACjD,QAAI,aAAc,QAAO,aAAa,OAAO;AAE7C,QAAI,aAAa,YAAY,EAAC,mCAAS,OAAO,QAAO,SAAS,OAAO;AAErE,UAAM,aAAa,QAAQ,MAAM,IAAI,QAAQ,CAAC,IACxC,QAAQ,MAAM,IAAI,QAAQ,CAAC,IAC3B,SAAS,OAAO;AACtB,YAAQ,MAAM,IAAI,QAAQ,GAAG,UAAU;AAEvC,WAAO;AAAA,EACX;AAEA,SAAO,QAAQ;AACnB;AAYO,IAAM,YAAY,CAAI,aACzB,QAAQ,aAAa,QAAQ;AAY1B,IAAM,YAAY,CAAI,aACzB,QAAQ,aAAa,QAAQ;AAc1B,IAAM,SAAS,CAAI,aAA0B,QAAQ,UAAU,QAAQ;;;AC9GvE,IAAM,cAAc,MAAa,oBAAI,IAAI;;;ACyBzC,IAAM,qBAAqB,CAC9B,UAAyB,CAAC,MACL;AACrB,QAAM,MAAM,CAAC,QAAQ;AAtDzB;AAsD4B,yBAAQ,KAAK,CAAC,UAAU,MAAM,CAAC,MAAM,GAAG,MAAxC,mBAA4C;AAAA;AAEpE,QAAM,MAAM,CAAC,KAAQ,UAAa;AAC9B,QAAI,IAAI,GAAG,MAAM,QAAW;AACxB,YAAMA,cAA4B,QAAQ;AAAA,QAAI,CAAC,UAC3C,MAAM,CAAC,MAAM,MAAM,CAAC,MAAM,CAAC,GAAG,KAAK,IAAI;AAAA,MAC3C;AAEA,aAAO,mBAAmBA,WAAU;AAAA,IACxC;AAEA,UAAM,aAA4B,CAAC,GAAG,SAAS,CAAC,KAAK,KAAK,CAAC;AAE3D,WAAO,mBAAmB,UAAU;AAAA,EACxC;AAEA,QAAM,QAAQ,CAAC,UAA8B;AACzC,UAAM,aAA4B;AAAA,MAC9B,GAAG,QAAQ,OAAO,CAAC,UAAU,MAAM,IAAI,MAAM,CAAC,CAAC,MAAM,MAAS;AAAA,MAC9D,GAAG,MAAM;AAAA,IACb;AAEA,WAAO,mBAAmB,UAAU;AAAA,EACxC;AAEA,SAAO,OAAO,OAAO;AAAA,IACjB;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACJ,CAAC;AACL;;;AC1DO,IAAM,gBAAgB,MAAe,mBAAmB;;;ACMxD,IAAM,cAAc,CACvB,WACA,YAGC;AACD,QAAM,cAAc,UAAU,IAAI,CAAC,aAAa,SAAS,OAAO,CAAC;AAEjE,SACI,YAAY,KAAK,CAAC,eAAe,sBAAsB,OAAO,IACxD,QAAQ,IAAI,WAAW,IACvB;AAEd;AAaO,IAAM,aAAa,CACtB,WACA,YAGC;AACD,MAAI,uBAAuB,OAAO,QAAQ,SAAS,EAAE;AAAA,IACjD,CAAC,CAAC,KAAK,QAAQ,MAAM,CAAC,KAAK,SAAS,OAAO,CAAC;AAAA,EAChD;AAEA,MACI,qBAAqB;AAAA,IACjB,CAAC,CAAC,EAAE,UAAU,MAAM,sBAAsB;AAAA,EAC9C,GACF;AACE,YAAQ,YAAY;AAChB,6BAAuB,MAAM,QAAQ;AAAA,QACjC,qBAAqB,IAAI,OAAO,CAAC,KAAK,UAAU,MAAM;AAAA,UAClD;AAAA,UACA,MAAM;AAAA,QACV,CAAC;AAAA,MACL;AAEA,aAAO,OAAO,YAAY,oBAAoB;AAAA,IAClD,GAAG;AAAA,EACP;AAEA,SAAO,OAAO,YAAY,oBAAoB;AAClD;","names":["newEntries"]}
1	+ {"version":3,"sources":["../src/index.ts","../src/helpers.ts","../src/provider.ts","../src/scope.ts","../src/immutable-map.ts","../src/mock-map.ts","../src/collection-resolution.ts"],"sourcesContent":["export * from \"./provider\";\nexport * from \"./scope\";\nexport * from \"./mock-map\";\nexport * from \"./collection-resolution\";\n","/*\n Creates a function that will invoke the provided function `fn` only once,\n * caching the result for subsequent calls with the same arguments.\n \n @returns A new function that returns the cached result after the first call.\n /\nexport const once = <A extends any[], R>(\n /\n The function to invoke once and cache the result.\n /\n fn: (...args: A) => R,\n) => {\n let returned = false;\n let result: R \| undefined;\n\n return Object.assign((...args: A): R => {\n if (returned) return result!;\n\n result = fn(...args);\n returned = true;\n\n return result;\n }, fn);\n};\n","import { once } from \"./helpers\";\nimport { MockMap } from \"./mock-map\";\nimport { Scope } from \"./scope\";\n\n/\n A wrapper around the resolver(factory) for contextual dependency resolution.\n \n Resolves an instance by calling a resolver\n * with a resolution context that will be propagated\n * throughout a dependency tree.\n \n When passing a scope it will try to get an instance from it\n * or create a new one and put it there.\n \n When passing mocks, it will try to get its own mock version,\n * and if there is one, it will use it instead of itself.\n /\nexport type Provider<T> = (context?: ResolutionContext) => T;\n\n/\n A resolution lifetime.\n \n Passed when creating a provider to determine its behavior.\n \n `\"transient\"` doesn't provide any modifications to a resolver behaviour,\n * so the resolver will create a new instance on each request.\n \n `\"singleton\"` forces the resolver to create an instance once\n * and return it in subsequent requests.\n \n `\"scoped\"` forces the resolver to take its instance from a provided scope\n * or create a new one and save it if there is none.\n * If no scope is passed, it will create a new instance on each request.\n /\nexport type Lifetime = \"transient\" \| \"singleton\" \| \"scoped\";\n\n/\n A function that creates an instance using a resolution context.\n /\nexport type Resolver<T> = (context?: ResolutionContext) => T;\n\n/\n An object that holds information about a scope and provider mocks.\n \n Passed to the provider call to resolve scope instances and mock providers.\n /\nexport type ResolutionContext = {\n scope?: Scope;\n mocks?: MockMap;\n};\n\n/\n Creates a provider instance,\n * a wrapper around a resolver(factory) for contextual dependency resolution.\n \n @param lifetime\n * A resolution lifetime.\n \n `\"transient\"` doesn't provide any modifications to a resolver behaviour,\n * so the resolver will create a new instance on each request.\n \n `\"singleton\"` forces the resolver to create an instance once\n * and return it in subsequent requests.\n \n `\"scoped\"` forces the resolver to take its resolution from a provided scope\n * or create a new one and save it if there is none.\n * If no scope is passed, it will create a new instance on each request.\n \n @param resolver\n * The function that creates an instance using a resolution context.\n \n @returns The provider instance.\n /\nexport const provide = <T>(\n lifetime: Lifetime,\n resolver: Resolver<T>,\n): Provider<T> => {\n resolver = lifetime === \"singleton\" ? once(resolver) : resolver;\n\n const resolve: Provider<T> = (context) => {\n const maybeOwnMock = context?.mocks?.get(resolve);\n if (maybeOwnMock) return maybeOwnMock(context);\n\n if (lifetime !== \"scoped\" \|\| !context?.scope) return resolver(context);\n\n const resolution = context.scope.has(resolve)\n ? context.scope.get(resolve)\n : resolver(context);\n context.scope.set(resolve, resolution);\n\n return resolution;\n };\n\n return resolve;\n};\n\n/\n Creates a transient provider instance,\n * a wrapper around a resolver(factory) for contextual dependency resolution\n * that will create a new instance on each request.\n \n @param resolver\n * The function that creates an instance using a resolution context.\n \n @returns The transient provider instance.\n /\nexport const transient = <T>(resolver: Resolver<T>) =>\n provide(\"transient\", resolver);\n\n/\n Creates a transient provider instance,\n * a wrapper around a resolver(factory) for contextual dependency resolution\n * that will create an instance once and return it in subsequent requests.\n \n @param resolver\n * The function that creates an instance using a resolution context.\n \n @returns The singleton provider instance.\n /\nexport const singleton = <T>(resolver: Resolver<T>) =>\n provide(\"singleton\", resolver);\n\n/\n Creates a transient provider instance,\n * a wrapper around a resolver(factory) for contextual dependency resolution\n * that will take its resolution from a provided scope\n * or create a new one and save it if there is none.\n * If no scope is passed, it will create a new instance on each request.\n \n @param resolver\n * The function that creates an instance using a resolution context.\n \n @returns The scoped provider instance.\n /\nexport const scoped = <T>(resolver: Resolver<T>) => provide(\"scoped\", resolver);\n","import { Provider } from \"./provider\";\n\n/\n A map of providers to their instances.\n \n Passed to a provider call in a resolution context object\n * to resolve instances of scoped providers within it.\n * ```ts\n * const scope = createScope()\n * provider({ scope })\n * ```\n /\nexport type Scope = Map<Provider<any>, any>;\n\n/\n Creates a scope instance.\n \n Scope is passed to a provider call in a resolution context object\n * to resolve instances of scoped providers within it.\n * ```ts\n * const scope = createScope()\n * provider({ scope })\n * ```\n \n @returns The scope instance.\n /\nexport const createScope = (): Scope => new Map();\n","export type Entry<K, V> = [K, V];\nexport type Entries<K, V> = Entry<K, V>[];\n\n/\n An immutable map. It's similar to `Map`,\n * but with reduced functionality and readonly builder behavior.\n /\nexport type ImmutableMap<K, V> = {\n /\n Map's entries.\n /\n readonly entries: Entries<K, V>;\n\n /\n Retrieves a possibly existing value under a key.\n \n @param key - The key associated with the value.\n \n @returns The value or undefined.\n /\n get(key: K): V \| undefined;\n\n /\n Sets a value under a key.\n \n @param key - The key that will be associated with the value.\n * @param value - The value to set.\n \n @returns A modified immutable map with the value being set in it.\n /\n set(key: K, value: V): ImmutableMap<K, V>;\n\n /\n Merges two immutable maps. If there're any matching keys,\n * values from the second map will override values from the first map.\n \n @param other The second immutable map.\n \n @returns A new immutable map as a result of merging two maps.\n /\n merge(other: ImmutableMap<K, V>): ImmutableMap<K, V>;\n};\n\n/\n Creates an immutable map. It's similar to `Map`,\n * but with reduced functionality and readonly builder behavior.\n \n @param entries - Map's entries.\n \n @returns The immutable map.\n /\nexport const createImmutableMap = <K, V>(\n entries: Entries<K, V> = [],\n): ImmutableMap<K, V> => {\n const get = (key: K) => entries.find((entry) => entry[0] === key)?.[1];\n\n const set = (key: K, value: V) => {\n if (get(key) !== undefined) {\n const newEntries: Entries<K, V> = entries.map((entry) =>\n entry[0] === key ? [entry[0], value] : entry,\n );\n\n return createImmutableMap(newEntries);\n }\n\n const newEntries: Entries<K, V> = [...entries, [key, value]];\n\n return createImmutableMap(newEntries);\n };\n\n const merge = (other: ImmutableMap<K, V>) => {\n const newEntries: Entries<K, V> = [\n ...entries.filter((entry) => other.get(entry[0]) === undefined),\n ...other.entries,\n ];\n\n return createImmutableMap(newEntries);\n };\n\n return Object.freeze({\n entries,\n get,\n set,\n merge,\n });\n};\n","import { Provider } from \"./provider\";\nimport { createImmutableMap, ImmutableMap } from \"./immutable-map\";\n\n/\n A map of providers to their compatible versions.\n \n Passed to a provider call in a resolution context object\n * in order to replace providers with their mocks.\n * ```ts\n * const mocks = createMockMap().set(otherProvider, otherProviderMock)\n * provider({ mocks })\n * ```\n /\nexport type MockMap = ImmutableMap<Provider<any>, Provider<any>>;\n\n/\n Creates a mock map instance.\n \n Passed to a provider call in a resolution context object\n * in order to replace providers with their mocks.\n * ```ts\n * const mocks = createMockMap().set(otherProvider, otherProviderMock)\n * provider({ mocks })\n * ```\n \n @returns The mock map instance.\n /\nexport const createMockMap = (): MockMap => createImmutableMap();\n","import { Provider, ResolutionContext } from \"./provider\";\n\ntype ProviderList = Provider<any>[];\ntype ProviderRecord = Record<string, Provider<any>>;\n\ntype InferProviderCollectionResolutions<\n Providers extends ProviderList \| ProviderRecord,\n> = {\n [K in keyof Providers]: Providers[K] extends Provider<infer T> ? T : never;\n};\n\n/\n Awaits all promises and wraps the collection in a promise\n * if there'ss at least one `Promise` in the collection,\n * otherwise returns an untouched type.\n /\ntype AwaitAllValuesInCollection<T extends any[] \| Record<any, any>> =\n Promise<any> extends T[keyof T]\n ? Promise<{\n [I in keyof T]: T[I] extends Promise<infer T> ? T : T[I];\n }>\n : T;\n\n/\n Calls every provider in a list with a provided resolution context\n * and returns a list of resolutions. Returns a promise of a list\n * of awaited resolutions if there's at least one promise in the resolutions.\n \n @param providers - The list of providers.\n * @param context - The resolution context.\n \n @returns The list of resolutions.\n /\nexport const resolveList = <const Providers extends ProviderList>(\n providers: Providers,\n context?: ResolutionContext,\n): AwaitAllValuesInCollection<\n InferProviderCollectionResolutions<Providers>\n> => {\n const resolutions = providers.map((provider) => provider(context));\n\n return (\n resolutions.some((resolution) => resolution instanceof Promise)\n ? Promise.all(resolutions)\n : resolutions\n ) as any;\n};\n\n/\n Calls every provider in a map with a provided resolution context\n * and returns a map with identical keys but with resolutions in values instead.\n * Returns a promise of a map of awaited resolutions if there's at least one\n * promise in the resolutions.\n \n @param providers - The map of providers.\n * @param context - The resolution context.\n \n @returns The map of resolutions.\n */\nexport const resolveMap = <const Providers extends ProviderRecord>(\n providers: Providers,\n context?: ResolutionContext,\n): AwaitAllValuesInCollection<\n InferProviderCollectionResolutions<Providers>\n> => {\n let resolutionMapEntries = Object.entries(providers).map(\n ([key, provider]) => [key, provider(context)],\n );\n\n if (\n resolutionMapEntries.some(\n ([, resolution]) => resolution instanceof Promise,\n )\n ) {\n return (async () => {\n resolutionMapEntries = await Promise.all(\n resolutionMapEntries.map(async ([key, resolution]) => [\n key,\n await resolution,\n ]),\n );\n\n return Object.fromEntries(resolutionMapEntries);\n })() as any;\n }\n\n return Object.fromEntries(resolutionMapEntries);\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACMO,IAAM,OAAO,CAIhB,OACC;AACD,MAAI,WAAW;AACf,MAAI;AAEJ,SAAO,OAAO,OAAO,IAAI,SAAe;AACpC,QAAI,SAAU,QAAO;AAErB,aAAS,GAAG,GAAG,IAAI;AACnB,eAAW;AAEX,WAAO;AAAA,EACX,GAAG,EAAE;AACT;;;ACkDO,IAAM,UAAU,CACnB,UACA,aACc;AACd,aAAW,aAAa,cAAc,KAAK,QAAQ,IAAI;AAEvD,QAAM,UAAuB,CAAC,YAAY;AA/E9C;AAgFQ,UAAM,gBAAe,wCAAS,UAAT,mBAAgB,IAAI;AACzC,QAAI,aAAc,QAAO,aAAa,OAAO;AAE7C,QAAI,aAAa,YAAY,EAAC,mCAAS,OAAO,QAAO,SAAS,OAAO;AAErE,UAAM,aAAa,QAAQ,MAAM,IAAI,OAAO,IACtC,QAAQ,MAAM,IAAI,OAAO,IACzB,SAAS,OAAO;AACtB,YAAQ,MAAM,IAAI,SAAS,UAAU;AAErC,WAAO;AAAA,EACX;AAEA,SAAO;AACX;AAYO,IAAM,YAAY,CAAI,aACzB,QAAQ,aAAa,QAAQ;AAY1B,IAAM,YAAY,CAAI,aACzB,QAAQ,aAAa,QAAQ;AAc1B,IAAM,SAAS,CAAI,aAA0B,QAAQ,UAAU,QAAQ;;;AC5GvE,IAAM,cAAc,MAAa,oBAAI,IAAI;;;ACyBzC,IAAM,qBAAqB,CAC9B,UAAyB,CAAC,MACL;AACrB,QAAM,MAAM,CAAC,QAAQ;AAtDzB;AAsD4B,yBAAQ,KAAK,CAAC,UAAU,MAAM,CAAC,MAAM,GAAG,MAAxC,mBAA4C;AAAA;AAEpE,QAAM,MAAM,CAAC,KAAQ,UAAa;AAC9B,QAAI,IAAI,GAAG,MAAM,QAAW;AACxB,YAAMA,cAA4B,QAAQ;AAAA,QAAI,CAAC,UAC3C,MAAM,CAAC,MAAM,MAAM,CAAC,MAAM,CAAC,GAAG,KAAK,IAAI;AAAA,MAC3C;AAEA,aAAO,mBAAmBA,WAAU;AAAA,IACxC;AAEA,UAAM,aAA4B,CAAC,GAAG,SAAS,CAAC,KAAK,KAAK,CAAC;AAE3D,WAAO,mBAAmB,UAAU;AAAA,EACxC;AAEA,QAAM,QAAQ,CAAC,UAA8B;AACzC,UAAM,aAA4B;AAAA,MAC9B,GAAG,QAAQ,OAAO,CAAC,UAAU,MAAM,IAAI,MAAM,CAAC,CAAC,MAAM,MAAS;AAAA,MAC9D,GAAG,MAAM;AAAA,IACb;AAEA,WAAO,mBAAmB,UAAU;AAAA,EACxC;AAEA,SAAO,OAAO,OAAO;AAAA,IACjB;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACJ,CAAC;AACL;;;AC1DO,IAAM,gBAAgB,MAAe,mBAAmB;;;ACMxD,IAAM,cAAc,CACvB,WACA,YAGC;AACD,QAAM,cAAc,UAAU,IAAI,CAAC,aAAa,SAAS,OAAO,CAAC;AAEjE,SACI,YAAY,KAAK,CAAC,eAAe,sBAAsB,OAAO,IACxD,QAAQ,IAAI,WAAW,IACvB;AAEd;AAaO,IAAM,aAAa,CACtB,WACA,YAGC;AACD,MAAI,uBAAuB,OAAO,QAAQ,SAAS,EAAE;AAAA,IACjD,CAAC,CAAC,KAAK,QAAQ,MAAM,CAAC,KAAK,SAAS,OAAO,CAAC;AAAA,EAChD;AAEA,MACI,qBAAqB;AAAA,IACjB,CAAC,CAAC,EAAE,UAAU,MAAM,sBAAsB;AAAA,EAC9C,GACF;AACE,YAAQ,YAAY;AAChB,6BAAuB,MAAM,QAAQ;AAAA,QACjC,qBAAqB,IAAI,OAAO,CAAC,KAAK,UAAU,MAAM;AAAA,UAClD;AAAA,UACA,MAAM;AAAA,QACV,CAAC;AAAA,MACL;AAEA,aAAO,OAAO,YAAY,oBAAoB;AAAA,IAClD,GAAG;AAAA,EACP;AAEA,SAAO,OAAO,YAAY,oBAAoB;AAClD;","names":["newEntries"]}

package/dist/index.mjs CHANGED Viewed

@@ -12,18 +12,17 @@ var once = (fn) => {
 // src/provider.ts
 var provide = (lifetime, resolver) => {
-  const getSelf = once(() => resolve);
   resolver = lifetime === "singleton" ? once(resolver) : resolver;
   const resolve = (context) => {
     var _a;
-    const maybeOwnMock = (_a = context == null ? void 0 : context.mocks) == null ? void 0 : _a.get(getSelf());
+    const maybeOwnMock = (_a = context == null ? void 0 : context.mocks) == null ? void 0 : _a.get(resolve);
     if (maybeOwnMock) return maybeOwnMock(context);
     if (lifetime !== "scoped" || !(context == null ? void 0 : context.scope)) return resolver(context);
-    const resolution = context.scope.has(getSelf()) ? context.scope.get(getSelf()) : resolver(context);
-    context.scope.set(getSelf(), resolution);
+    const resolution = context.scope.has(resolve) ? context.scope.get(resolve) : resolver(context);
+    context.scope.set(resolve, resolution);
     return resolution;
   };
-  return getSelf();
+  return resolve;
 };
 var transient = (resolver) => provide("transient", resolver);
 var singleton = (resolver) => provide("singleton", resolver);
@@ -32,7 +31,7 @@ var scoped = (resolver) => provide("scoped", resolver);
 // src/scope.ts
 var createScope = () => /* @__PURE__ */ new Map();
-// src/readonly-map.ts
+// src/immutable-map.ts
 var createImmutableMap = (entries = []) => {
   const get = (key) => {
     var _a;

package/dist/index.mjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"sources":["../src/helpers.ts","../src/provider.ts","../src/scope.ts","../src/readonly-map.ts","../src/mock-map.ts","../src/collection-resolution.ts"],"sourcesContent":["/*\n Creates a function that will invoke the provided function `fn` only once,\n * caching the result for subsequent calls with the same arguments.\n \n @returns A new function that returns the cached result after the first call.\n /\nexport const once = <A extends any[], R>(\n /\n The function to invoke once and cache the result.\n /\n fn: (...args: A) => R,\n) => {\n let returned = false;\n let result: R \| undefined;\n\n return Object.assign((...args: A): R => {\n if (returned) return result!;\n\n result = fn(...args);\n returned = true;\n\n return result;\n }, fn);\n};\n","import { once } from \"./helpers\";\nimport { MockMap } from \"./mock-map\";\nimport { Scope } from \"./scope\";\n\n/\n A wrapper around the resolver for contextual dependency resolution.\n \n Resolves an instance by calling a resolver\n * with a resolution context that will be propagated\n * throughout a dependency tree.\n \n When passing a scope it will try to get an instance from it\n * or create a new one and put it there.\n \n When passing mocks, it will try to get its own mock version,\n * and if there is one, it will use it instead of itself.\n /\nexport type Provider<T> = (context?: ResolutionContext) => T;\n\n/\n A resolution lifetime.\n \n Passed when creating a provider to determine its behavior.\n \n `\"transient\"` doesn't provide any modifications to a resolver behaviour,\n * so the resolver will create a new instance on each request.\n \n `\"singleton\"` forces the resolver to create an instance once\n * and return it in subsequent requests.\n \n `\"scoped\"` forces the resolver to take its instance from a provided scope\n * or create a new one and save it if there is none.\n * If no scope is passed, it will create a new instance on each request.\n /\nexport type Lifetime = \"transient\" \| \"singleton\" \| \"scoped\";\n\n/\n A function that creates an instance using a resolution context.\n /\nexport type Resolver<T> = (context?: ResolutionContext) => T;\n\n/\n An object that holds information about a scope and provider mocks.\n \n Passed to the provider call to resolve scope instances and mock providers.\n /\nexport type ResolutionContext = {\n scope?: Scope;\n mocks?: MockMap;\n};\n\n/\n Creates a provider instance,\n * a wrapper around a resolver for contextual dependency resolution.\n \n @param lifetime\n * A resolution lifetime.\n \n `\"transient\"` doesn't provide any modifications to a resolver behaviour,\n * so the resolver will create a new instance on each request.\n \n `\"singleton\"` forces the resolver to create an instance once\n * and return it in subsequent requests.\n \n `\"scoped\"` forces the resolver to take its resolution from a provided scope\n * or create a new one and save it if there is none.\n * If no scope is passed, it will create a new instance on each request.\n \n @param resolver\n * The function that creates an instance using a resolution context.\n \n @returns The provider instance.\n /\nexport const provide = <T>(\n lifetime: Lifetime,\n resolver: Resolver<T>,\n): Provider<T> => {\n const getSelf = once(() => resolve);\n\n resolver = lifetime === \"singleton\" ? once(resolver) : resolver;\n\n const resolve: Provider<T> = (context) => {\n const maybeOwnMock = context?.mocks?.get(getSelf());\n if (maybeOwnMock) return maybeOwnMock(context);\n\n if (lifetime !== \"scoped\" \|\| !context?.scope) return resolver(context);\n\n const resolution = context.scope.has(getSelf())\n ? context.scope.get(getSelf())\n : resolver(context);\n context.scope.set(getSelf(), resolution);\n\n return resolution;\n };\n\n return getSelf();\n};\n\n/\n Creates a transient provider instance,\n * a wrapper around a resolver for contextual dependency resolution\n * that will create a new instance on each request.\n \n @param resolver\n * The function that creates an instance using a resolution context.\n \n @returns The transient provider instance.\n /\nexport const transient = <T>(resolver: Resolver<T>) =>\n provide(\"transient\", resolver);\n\n/\n Creates a transient provider instance,\n * a wrapper around a resolver for contextual dependency resolution\n * that will create an instance once and return it in subsequent requests.\n \n @param resolver\n * The function that creates an instance using a resolution context.\n \n @returns The singleton provider instance.\n /\nexport const singleton = <T>(resolver: Resolver<T>) =>\n provide(\"singleton\", resolver);\n\n/\n Creates a transient provider instance,\n * a wrapper around a resolver for contextual dependency resolution\n * that will take its resolution from a provided scope\n * or create a new one and save it if there is none.\n * If no scope is passed, it will create a new instance on each request.\n \n @param resolver\n * The function that creates an instance using a resolution context.\n \n @returns The scoped provider instance.\n /\nexport const scoped = <T>(resolver: Resolver<T>) => provide(\"scoped\", resolver);\n","import { Provider } from \"./provider\";\n\n/\n A map of providers to their instances.\n \n Passed to a provider call in a resolution context object\n * to resolve instances of scoped providers within it.\n * ```ts\n * const scope = createScope()\n * provider({ scope })\n * ```\n /\nexport type Scope = Map<Provider<any>, any>;\n\n/\n Creates a scope instance.\n \n Scope is passed to a provider call in a resolution context object\n * to resolve instances of scoped providers within it.\n * ```ts\n * const scope = createScope()\n * provider({ scope })\n * ```\n \n @returns The scope instance.\n /\nexport const createScope = (): Scope => new Map();\n","export type Entry<K, V> = [K, V];\nexport type Entries<K, V> = Entry<K, V>[];\n\n/\n An immutable map. It's similar to `Map`,\n * but with reduced functionality and readonly builder behavior.\n /\nexport type ImmutableMap<K, V> = {\n /\n Map's entries.\n /\n readonly entries: Entries<K, V>;\n\n /\n Retrieves a possibly existing value under a key.\n \n @param key - The key associated with the value.\n \n @returns The value or undefined.\n /\n get(key: K): V \| undefined;\n\n /\n Sets a value under a key.\n \n @param key - The key that will be associated with the value.\n * @param value - The value to set.\n \n @returns A modified immutable map with the value being set in it.\n /\n set(key: K, value: V): ImmutableMap<K, V>;\n\n /\n Merges two immutable maps. If there're any matching keys,\n * values from the second map will override values from the first map.\n \n @param other The second immutable map.\n \n @returns A new immutable map as a result of merging two maps.\n /\n merge(other: ImmutableMap<K, V>): ImmutableMap<K, V>;\n};\n\n/\n Creates an immutable map. It's similar to `Map`,\n * but with reduced functionality and readonly builder behavior.\n \n @param entries - Map's entries.\n \n @returns The immutable map.\n /\nexport const createImmutableMap = <K, V>(\n entries: Entries<K, V> = [],\n): ImmutableMap<K, V> => {\n const get = (key: K) => entries.find((entry) => entry[0] === key)?.[1];\n\n const set = (key: K, value: V) => {\n if (get(key) !== undefined) {\n const newEntries: Entries<K, V> = entries.map((entry) =>\n entry[0] === key ? [entry[0], value] : entry,\n );\n\n return createImmutableMap(newEntries);\n }\n\n const newEntries: Entries<K, V> = [...entries, [key, value]];\n\n return createImmutableMap(newEntries);\n };\n\n const merge = (other: ImmutableMap<K, V>) => {\n const newEntries: Entries<K, V> = [\n ...entries.filter((entry) => other.get(entry[0]) === undefined),\n ...other.entries,\n ];\n\n return createImmutableMap(newEntries);\n };\n\n return Object.freeze({\n entries,\n get,\n set,\n merge,\n });\n};\n","import { Provider } from \"./provider\";\nimport { createImmutableMap, ImmutableMap } from \"./readonly-map\";\n\n/\n A map of providers to their compatible versions.\n \n Passed to a provider call in a resolution context object\n * in order to replace providers with their mocks.\n * ```ts\n * const mocks = createMockMap().set(otherProvider, otherProviderMock)\n * provider({ mocks })\n * ```\n /\nexport type MockMap = ImmutableMap<Provider<any>, Provider<any>>;\n\n/\n Creates a mock map instance.\n \n Passed to a provider call in a resolution context object\n * in order to replace providers with their mocks.\n * ```ts\n * const mocks = createMockMap().set(otherProvider, otherProviderMock)\n * provider({ mocks })\n * ```\n \n @returns The mock map instance.\n /\nexport const createMockMap = (): MockMap => createImmutableMap();\n","import { Provider, ResolutionContext } from \"./provider\";\n\ntype ProviderList = Provider<any>[];\ntype ProviderRecord = Record<string, Provider<any>>;\n\ntype InferProviderCollectionResolutions<\n Providers extends ProviderList \| ProviderRecord,\n> = {\n [K in keyof Providers]: Providers[K] extends Provider<infer T> ? T : never;\n};\n\n/\n Awaits all promises and wraps the collection in a promise\n * if there'ss at least one `Promise` in the collection,\n * otherwise returns an untouched type.\n /\ntype AwaitAllValuesInCollection<T extends any[] \| Record<any, any>> =\n Promise<any> extends T[keyof T]\n ? Promise<{\n [I in keyof T]: T[I] extends Promise<infer T> ? T : T[I];\n }>\n : T;\n\n/\n Calls every provider in a list with a provided resolution context\n * and returns a list of resolutions. Returns a promise of a list\n * of awaited resolutions if there's at least one promise in the resolutions.\n \n @param providers - The list of providers.\n * @param context - The resolution context.\n \n @returns The list of resolutions.\n /\nexport const resolveList = <const Providers extends ProviderList>(\n providers: Providers,\n context?: ResolutionContext,\n): AwaitAllValuesInCollection<\n InferProviderCollectionResolutions<Providers>\n> => {\n const resolutions = providers.map((provider) => provider(context));\n\n return (\n resolutions.some((resolution) => resolution instanceof Promise)\n ? Promise.all(resolutions)\n : resolutions\n ) as any;\n};\n\n/\n Calls every provider in a map with a provided resolution context\n * and returns a map with identical keys but with resolutions in values instead.\n * Returns a promise of a map of awaited resolutions if there's at least one\n * promise in the resolutions.\n \n @param providers - The map of providers.\n * @param context - The resolution context.\n \n @returns The map of resolutions.\n */\nexport const resolveMap = <const Providers extends ProviderRecord>(\n providers: Providers,\n context?: ResolutionContext,\n): AwaitAllValuesInCollection<\n InferProviderCollectionResolutions<Providers>\n> => {\n let resolutionMapEntries = Object.entries(providers).map(\n ([key, provider]) => [key, provider(context)],\n );\n\n if (\n resolutionMapEntries.some(\n ([, resolution]) => resolution instanceof Promise,\n )\n ) {\n return (async () => {\n resolutionMapEntries = await Promise.all(\n resolutionMapEntries.map(async ([key, resolution]) => [\n key,\n await resolution,\n ]),\n );\n\n return Object.fromEntries(resolutionMapEntries);\n })() as any;\n }\n\n return Object.fromEntries(resolutionMapEntries);\n};\n"],"mappings":"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","names":["newEntries"]}
1	+ {"version":3,"sources":["../src/helpers.ts","../src/provider.ts","../src/scope.ts","../src/immutable-map.ts","../src/mock-map.ts","../src/collection-resolution.ts"],"sourcesContent":["/*\n Creates a function that will invoke the provided function `fn` only once,\n * caching the result for subsequent calls with the same arguments.\n \n @returns A new function that returns the cached result after the first call.\n /\nexport const once = <A extends any[], R>(\n /\n The function to invoke once and cache the result.\n /\n fn: (...args: A) => R,\n) => {\n let returned = false;\n let result: R \| undefined;\n\n return Object.assign((...args: A): R => {\n if (returned) return result!;\n\n result = fn(...args);\n returned = true;\n\n return result;\n }, fn);\n};\n","import { once } from \"./helpers\";\nimport { MockMap } from \"./mock-map\";\nimport { Scope } from \"./scope\";\n\n/\n A wrapper around the resolver(factory) for contextual dependency resolution.\n \n Resolves an instance by calling a resolver\n * with a resolution context that will be propagated\n * throughout a dependency tree.\n \n When passing a scope it will try to get an instance from it\n * or create a new one and put it there.\n \n When passing mocks, it will try to get its own mock version,\n * and if there is one, it will use it instead of itself.\n /\nexport type Provider<T> = (context?: ResolutionContext) => T;\n\n/\n A resolution lifetime.\n \n Passed when creating a provider to determine its behavior.\n \n `\"transient\"` doesn't provide any modifications to a resolver behaviour,\n * so the resolver will create a new instance on each request.\n \n `\"singleton\"` forces the resolver to create an instance once\n * and return it in subsequent requests.\n \n `\"scoped\"` forces the resolver to take its instance from a provided scope\n * or create a new one and save it if there is none.\n * If no scope is passed, it will create a new instance on each request.\n /\nexport type Lifetime = \"transient\" \| \"singleton\" \| \"scoped\";\n\n/\n A function that creates an instance using a resolution context.\n /\nexport type Resolver<T> = (context?: ResolutionContext) => T;\n\n/\n An object that holds information about a scope and provider mocks.\n \n Passed to the provider call to resolve scope instances and mock providers.\n /\nexport type ResolutionContext = {\n scope?: Scope;\n mocks?: MockMap;\n};\n\n/\n Creates a provider instance,\n * a wrapper around a resolver(factory) for contextual dependency resolution.\n \n @param lifetime\n * A resolution lifetime.\n \n `\"transient\"` doesn't provide any modifications to a resolver behaviour,\n * so the resolver will create a new instance on each request.\n \n `\"singleton\"` forces the resolver to create an instance once\n * and return it in subsequent requests.\n \n `\"scoped\"` forces the resolver to take its resolution from a provided scope\n * or create a new one and save it if there is none.\n * If no scope is passed, it will create a new instance on each request.\n \n @param resolver\n * The function that creates an instance using a resolution context.\n \n @returns The provider instance.\n /\nexport const provide = <T>(\n lifetime: Lifetime,\n resolver: Resolver<T>,\n): Provider<T> => {\n resolver = lifetime === \"singleton\" ? once(resolver) : resolver;\n\n const resolve: Provider<T> = (context) => {\n const maybeOwnMock = context?.mocks?.get(resolve);\n if (maybeOwnMock) return maybeOwnMock(context);\n\n if (lifetime !== \"scoped\" \|\| !context?.scope) return resolver(context);\n\n const resolution = context.scope.has(resolve)\n ? context.scope.get(resolve)\n : resolver(context);\n context.scope.set(resolve, resolution);\n\n return resolution;\n };\n\n return resolve;\n};\n\n/\n Creates a transient provider instance,\n * a wrapper around a resolver(factory) for contextual dependency resolution\n * that will create a new instance on each request.\n \n @param resolver\n * The function that creates an instance using a resolution context.\n \n @returns The transient provider instance.\n /\nexport const transient = <T>(resolver: Resolver<T>) =>\n provide(\"transient\", resolver);\n\n/\n Creates a transient provider instance,\n * a wrapper around a resolver(factory) for contextual dependency resolution\n * that will create an instance once and return it in subsequent requests.\n \n @param resolver\n * The function that creates an instance using a resolution context.\n \n @returns The singleton provider instance.\n /\nexport const singleton = <T>(resolver: Resolver<T>) =>\n provide(\"singleton\", resolver);\n\n/\n Creates a transient provider instance,\n * a wrapper around a resolver(factory) for contextual dependency resolution\n * that will take its resolution from a provided scope\n * or create a new one and save it if there is none.\n * If no scope is passed, it will create a new instance on each request.\n \n @param resolver\n * The function that creates an instance using a resolution context.\n \n @returns The scoped provider instance.\n /\nexport const scoped = <T>(resolver: Resolver<T>) => provide(\"scoped\", resolver);\n","import { Provider } from \"./provider\";\n\n/\n A map of providers to their instances.\n \n Passed to a provider call in a resolution context object\n * to resolve instances of scoped providers within it.\n * ```ts\n * const scope = createScope()\n * provider({ scope })\n * ```\n /\nexport type Scope = Map<Provider<any>, any>;\n\n/\n Creates a scope instance.\n \n Scope is passed to a provider call in a resolution context object\n * to resolve instances of scoped providers within it.\n * ```ts\n * const scope = createScope()\n * provider({ scope })\n * ```\n \n @returns The scope instance.\n /\nexport const createScope = (): Scope => new Map();\n","export type Entry<K, V> = [K, V];\nexport type Entries<K, V> = Entry<K, V>[];\n\n/\n An immutable map. It's similar to `Map`,\n * but with reduced functionality and readonly builder behavior.\n /\nexport type ImmutableMap<K, V> = {\n /\n Map's entries.\n /\n readonly entries: Entries<K, V>;\n\n /\n Retrieves a possibly existing value under a key.\n \n @param key - The key associated with the value.\n \n @returns The value or undefined.\n /\n get(key: K): V \| undefined;\n\n /\n Sets a value under a key.\n \n @param key - The key that will be associated with the value.\n * @param value - The value to set.\n \n @returns A modified immutable map with the value being set in it.\n /\n set(key: K, value: V): ImmutableMap<K, V>;\n\n /\n Merges two immutable maps. If there're any matching keys,\n * values from the second map will override values from the first map.\n \n @param other The second immutable map.\n \n @returns A new immutable map as a result of merging two maps.\n /\n merge(other: ImmutableMap<K, V>): ImmutableMap<K, V>;\n};\n\n/\n Creates an immutable map. It's similar to `Map`,\n * but with reduced functionality and readonly builder behavior.\n \n @param entries - Map's entries.\n \n @returns The immutable map.\n /\nexport const createImmutableMap = <K, V>(\n entries: Entries<K, V> = [],\n): ImmutableMap<K, V> => {\n const get = (key: K) => entries.find((entry) => entry[0] === key)?.[1];\n\n const set = (key: K, value: V) => {\n if (get(key) !== undefined) {\n const newEntries: Entries<K, V> = entries.map((entry) =>\n entry[0] === key ? [entry[0], value] : entry,\n );\n\n return createImmutableMap(newEntries);\n }\n\n const newEntries: Entries<K, V> = [...entries, [key, value]];\n\n return createImmutableMap(newEntries);\n };\n\n const merge = (other: ImmutableMap<K, V>) => {\n const newEntries: Entries<K, V> = [\n ...entries.filter((entry) => other.get(entry[0]) === undefined),\n ...other.entries,\n ];\n\n return createImmutableMap(newEntries);\n };\n\n return Object.freeze({\n entries,\n get,\n set,\n merge,\n });\n};\n","import { Provider } from \"./provider\";\nimport { createImmutableMap, ImmutableMap } from \"./immutable-map\";\n\n/\n A map of providers to their compatible versions.\n \n Passed to a provider call in a resolution context object\n * in order to replace providers with their mocks.\n * ```ts\n * const mocks = createMockMap().set(otherProvider, otherProviderMock)\n * provider({ mocks })\n * ```\n /\nexport type MockMap = ImmutableMap<Provider<any>, Provider<any>>;\n\n/\n Creates a mock map instance.\n \n Passed to a provider call in a resolution context object\n * in order to replace providers with their mocks.\n * ```ts\n * const mocks = createMockMap().set(otherProvider, otherProviderMock)\n * provider({ mocks })\n * ```\n \n @returns The mock map instance.\n /\nexport const createMockMap = (): MockMap => createImmutableMap();\n","import { Provider, ResolutionContext } from \"./provider\";\n\ntype ProviderList = Provider<any>[];\ntype ProviderRecord = Record<string, Provider<any>>;\n\ntype InferProviderCollectionResolutions<\n Providers extends ProviderList \| ProviderRecord,\n> = {\n [K in keyof Providers]: Providers[K] extends Provider<infer T> ? T : never;\n};\n\n/\n Awaits all promises and wraps the collection in a promise\n * if there'ss at least one `Promise` in the collection,\n * otherwise returns an untouched type.\n /\ntype AwaitAllValuesInCollection<T extends any[] \| Record<any, any>> =\n Promise<any> extends T[keyof T]\n ? Promise<{\n [I in keyof T]: T[I] extends Promise<infer T> ? T : T[I];\n }>\n : T;\n\n/\n Calls every provider in a list with a provided resolution context\n * and returns a list of resolutions. Returns a promise of a list\n * of awaited resolutions if there's at least one promise in the resolutions.\n \n @param providers - The list of providers.\n * @param context - The resolution context.\n \n @returns The list of resolutions.\n /\nexport const resolveList = <const Providers extends ProviderList>(\n providers: Providers,\n context?: ResolutionContext,\n): AwaitAllValuesInCollection<\n InferProviderCollectionResolutions<Providers>\n> => {\n const resolutions = providers.map((provider) => provider(context));\n\n return (\n resolutions.some((resolution) => resolution instanceof Promise)\n ? Promise.all(resolutions)\n : resolutions\n ) as any;\n};\n\n/\n Calls every provider in a map with a provided resolution context\n * and returns a map with identical keys but with resolutions in values instead.\n * Returns a promise of a map of awaited resolutions if there's at least one\n * promise in the resolutions.\n \n @param providers - The map of providers.\n * @param context - The resolution context.\n \n @returns The map of resolutions.\n */\nexport const resolveMap = <const Providers extends ProviderRecord>(\n providers: Providers,\n context?: ResolutionContext,\n): AwaitAllValuesInCollection<\n InferProviderCollectionResolutions<Providers>\n> => {\n let resolutionMapEntries = Object.entries(providers).map(\n ([key, provider]) => [key, provider(context)],\n );\n\n if (\n resolutionMapEntries.some(\n ([, resolution]) => resolution instanceof Promise,\n )\n ) {\n return (async () => {\n resolutionMapEntries = await Promise.all(\n resolutionMapEntries.map(async ([key, resolution]) => [\n key,\n await resolution,\n ]),\n );\n\n return Object.fromEntries(resolutionMapEntries);\n })() as any;\n }\n\n return Object.fromEntries(resolutionMapEntries);\n};\n"],"mappings":"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","names":["newEntries"]}

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "atomic-di",
-  "version": "0.8.0-beta.1",
+  "version": "0.8.1-beta.1",
   "description": "A toolset for containerless dependency injection.",
   "repository": {
     "type": "git",