@gqloom/core 0.10.0 → 0.11.0

package/dist/context.js

@@ -1,242 +1,247 @@
-import {
-  getMemoizationMap,
-  getResolvingFields,
-  isOnlyMemoryPayload,
-  onlyMemoization
-} from "./chunk-JWAIAFGL.js";
-
-// src/context/context.ts
+import { getMemoizationMap, getResolvingFields, isOnlyMemoryPayload, onlyMemoization } from "./context-CpbCknos.js";
 import { AsyncLocalStorage } from "node:async_hooks";
 
-// src/context/async-iterator.ts
+//#region src/context/async-iterator.ts
 function bindAsyncIterator(storage, generator) {
-  const store = storage.getStore();
-  const next = generator.next;
-  Object.defineProperty(generator, "next", {
-    value: (...args) => storage.run(store, () => next.apply(generator, args)),
-    writable: false
-  });
-  return generator;
+	const store = storage.getStore();
+	const next = generator.next;
+	Object.defineProperty(generator, "next", {
+		value: (...args) => storage.run(store, () => next.apply(generator, args)),
+		writable: false
+	});
+	return generator;
 }
 function isAsyncIterator(value) {
-  return value !== null && typeof value === "object" && "next" in value && typeof value.next === "function";
+	return value !== null && typeof value === "object" && "next" in value && typeof value.next === "function";
 }
 
-// src/context/context.ts
-var resolverPayloadStorage = new AsyncLocalStorage();
+//#endregion
+//#region src/context/context.ts
+/**
+* the AsyncLocalStorage instance to store the resolver payload
+*/
+const resolverPayloadStorage = new AsyncLocalStorage();
+/**
+* use detailed payload of the current resolver
+* @returns the resolver payload
+*/
 function useResolverPayload() {
-  const payload = resolverPayloadStorage.getStore();
-  if (payload === void 0 || isOnlyMemoryPayload(payload)) return;
-  return payload;
+	const payload = resolverPayloadStorage.getStore();
+	if (payload === void 0 || isOnlyMemoryPayload(payload)) return;
+	return payload;
 }
+/**
+* use context of the current resolver
+* @returns the context of the current resolver
+*/
 function useContext() {
-  return useResolverPayload()?.context;
+	return useResolverPayload()?.context;
 }
+/**
+* use the MemoizationMap of the current context
+*/
 function useMemoizationMap() {
-  const payload = resolverPayloadStorage.getStore();
-  if (payload == null) return;
-  return getMemoizationMap(payload);
+	const payload = resolverPayloadStorage.getStore();
+	if (payload == null) return;
+	return getMemoizationMap(payload);
 }
+/**
+* A class that provides dependency injection and context sharing capabilities.
+* It allows you to create injectable dependencies that can be shared across different parts of your application.
+*
+* @template T The type of the value that will be injected
+*
+*/
 var InjectableContext = class {
-  /**
-   * Creates a new instance of InjectableContext.
-   *
-   * @param getter - A function that returns the default value when no custom implementation is provided
-   * @param options - Optional configuration for the context
-   * @param options.getContextMap - A function that returns the WeakMap used to store context values. Defaults to useMemoizationMap
-   * @param options.key - A unique key used to identify this context in the WeakMap. Defaults to the getter function
-   */
-  constructor(getter, options = {}) {
-    this.getter = getter;
-    this.getter = getter;
-    this.getContextMap = options.getContextMap ?? useMemoizationMap;
-    this.key = options.key ?? this.getter;
-  }
-  /**
-   * A function that returns the WeakMap used to store context values.
-   * This can be customized to use different storage mechanisms.
-   */
-  getContextMap;
-  /**
-   * A unique key used to identify this context in the WeakMap.
-   * This is used to store and retrieve values from the context map.
-   */
-  key;
-  /**
-   * Retrieves the value from the context.
-   * If a custom implementation is provided, it will be used.
-   * Otherwise, the default getter function will be called.
-   *
-   * @returns The value of type T
-   */
-  get() {
-    const getter = this.getContextMap()?.get(this.key) ?? this.getter;
-    if (typeof getter === "function") return getter();
-    return getter;
-  }
-  /**
-   * Provides a new implementation for this context.
-   *
-   * @param getter - A function that returns the new value
-   * @returns A tuple containing the key and the new getter function
-   */
-  provide(getter) {
-    return [this.key, getter];
-  }
+	/**
+	* Creates a new instance of InjectableContext.
+	*
+	* @param getter - A function that returns the default value when no custom implementation is provided
+	* @param options - Optional configuration for the context
+	* @param options.getContextMap - A function that returns the WeakMap used to store context values. Defaults to useMemoizationMap
+	* @param options.key - A unique key used to identify this context in the WeakMap. Defaults to the getter function
+	*/
+	constructor(getter, options = {}) {
+		this.getter = getter;
+		this.getter = getter;
+		this.getContextMap = options.getContextMap ?? useMemoizationMap;
+		this.key = options.key ?? this.getter;
+	}
+	/**
+	* A function that returns the WeakMap used to store context values.
+	* This can be customized to use different storage mechanisms.
+	*/
+	getContextMap;
+	/**
+	* A unique key used to identify this context in the WeakMap.
+	* This is used to store and retrieve values from the context map.
+	*/
+	key;
+	/**
+	* Retrieves the value from the context.
+	* If a custom implementation is provided, it will be used.
+	* Otherwise, the default getter function will be called.
+	*
+	* @returns The value of type T
+	*/
+	get() {
+		const getter = this.getContextMap()?.get(this.key) ?? this.getter;
+		if (typeof getter === "function") return getter();
+		return getter;
+	}
+	/**
+	* Provides a new implementation for this context.
+	*
+	* @param getter - A function that returns the new value
+	* @returns A tuple containing the key and the new getter function
+	*/
+	provide(getter) {
+		return [this.key, getter];
+	}
 };
+/**
+* Create a memoization in context to store the result of a getter function
+*/
 var ContextMemoization = class {
-  constructor(getter, options = {}) {
-    this.getter = getter;
-    this.getter = getter;
-    this.getContextMap = options.getContextMap ?? useMemoizationMap;
-    this.key = options.key ?? this.getter;
-  }
-  getContextMap;
-  key;
-  /**
-   * Get the value in memoization or call the getter function
-   * @returns the value of the getter function
-   */
-  get() {
-    const map = this.getContextMap();
-    if (!map) return this.getter();
-    if (!map.has(this.key)) {
-      map.set(this.key, this.getter());
-    }
-    return map.get(this.key);
-  }
-  /**
-   * Clear the memoization
-   * @returns true if the memoization is cleared, undefined if the context is not found
-   */
-  clear() {
-    const map = this.getContextMap();
-    if (!map) return;
-    return map.delete(this.key);
-  }
-  /**
-   * Check if the memoization exists
-   * @returns true if the memoization exists, undefined if the context is not found
-   */
-  exists() {
-    const map = this.getContextMap();
-    if (!map) return;
-    return map.has(this.key);
-  }
-  /**
-   * Set a new value to the memoization
-   * @param value  the new value to set
-   * @returns the memoization map or undefined if the context is not found
-   */
-  set(value) {
-    const map = this.getContextMap();
-    if (!map) return;
-    return map.set(this.key, value);
-  }
-  provide(value) {
-    return [this.key, value];
-  }
+	constructor(getter, options = {}) {
+		this.getter = getter;
+		this.getter = getter;
+		this.getContextMap = options.getContextMap ?? useMemoizationMap;
+		this.key = options.key ?? this.getter;
+	}
+	getContextMap;
+	key;
+	/**
+	* Get the value in memoization or call the getter function
+	* @returns the value of the getter function
+	*/
+	get() {
+		const map = this.getContextMap();
+		if (!map) return this.getter();
+		if (!map.has(this.key)) map.set(this.key, this.getter());
+		return map.get(this.key);
+	}
+	/**
+	* Clear the memoization
+	* @returns true if the memoization is cleared, undefined if the context is not found
+	*/
+	clear() {
+		const map = this.getContextMap();
+		if (!map) return;
+		return map.delete(this.key);
+	}
+	/**
+	* Check if the memoization exists
+	* @returns true if the memoization exists, undefined if the context is not found
+	*/
+	exists() {
+		const map = this.getContextMap();
+		if (!map) return;
+		return map.has(this.key);
+	}
+	/**
+	* Set a new value to the memoization
+	* @param value  the new value to set
+	* @returns the memoization map or undefined if the context is not found
+	*/
+	set(value) {
+		const map = this.getContextMap();
+		if (!map) return;
+		return map.set(this.key, value);
+	}
+	provide(value) {
+		return [this.key, value];
+	}
 };
+/**
+* Create a callable context
+* @param args - The arguments to pass to the InjectableContext constructor
+* @returns A callable context
+*/
 function createContext(...args) {
-  const context = new InjectableContext(...args);
-  const callable = () => context.get();
-  Object.defineProperty(context, "key", {
-    value: callable,
-    writable: false,
-    configurable: false
-  });
-  return Object.assign(callable, {
-    key: context.key,
-    get: () => context.get(),
-    provide: (getter) => context.provide(getter),
-    getContextMap: () => context.getContextMap(),
-    getter: context.getter
-  });
+	const context = new InjectableContext(...args);
+	const callable = () => context.get();
+	Object.defineProperty(context, "key", {
+		value: callable,
+		writable: false,
+		configurable: false
+	});
+	return Object.assign(callable, {
+		key: context.key,
+		get: () => context.get(),
+		provide: (getter) => context.provide(getter),
+		getContextMap: () => context.getContextMap(),
+		getter: context.getter
+	});
 }
+/**
+* Create a memoization in context to store the result of a getter function
+*/
 function createMemoization(...args) {
-  const memoization = new ContextMemoization(...args);
-  const callable = () => memoization.get();
-  Object.defineProperty(memoization, "key", {
-    value: callable,
-    writable: false,
-    configurable: false
-  });
-  return Object.assign(callable, {
-    key: memoization.key,
-    get: () => memoization.get(),
-    set: (value) => memoization.set(value),
-    clear: () => memoization.clear(),
-    exists: () => memoization.exists(),
-    getter: memoization.getter,
-    provide: (value) => memoization.provide(value),
-    getContextMap: () => memoization.getContextMap()
-  });
+	const memoization = new ContextMemoization(...args);
+	const callable = () => memoization.get();
+	Object.defineProperty(memoization, "key", {
+		value: callable,
+		writable: false,
+		configurable: false
+	});
+	return Object.assign(callable, {
+		key: memoization.key,
+		get: () => memoization.get(),
+		set: (value) => memoization.set(value),
+		clear: () => memoization.clear(),
+		exists: () => memoization.exists(),
+		getter: memoization.getter,
+		provide: (value) => memoization.provide(value),
+		getContextMap: () => memoization.getContextMap()
+	});
 }
-var createProvider = (...keyValues) => {
-  return ({ next, payload, operation }) => {
-    const store = payload ?? onlyMemoization();
-    const map = getMemoizationMap(store);
-    if (map) {
-      for (const [key, value] of keyValues) {
-        map.set(key, value);
-      }
-    }
-    if (operation === "subscription.subscribe") {
-      return resolverPayloadStorage.run(store, async () => {
-        let result = await next();
-        if (isAsyncIterator(result)) {
-          result = bindAsyncIterator(resolverPayloadStorage, result);
-        }
-        return result;
-      });
-    }
-    return resolverPayloadStorage.run(store, next);
-  };
+const createProvider = (...keyValues) => {
+	return ({ next, payload, operation }) => {
+		const store = payload ?? onlyMemoization();
+		const map = getMemoizationMap(store);
+		if (map) for (const [key, value] of keyValues) map.set(key, value);
+		if (operation === "subscription.subscribe") return resolverPayloadStorage.run(store, async () => {
+			let result = await next();
+			if (isAsyncIterator(result)) result = bindAsyncIterator(resolverPayloadStorage, result);
+			return result;
+		});
+		return resolverPayloadStorage.run(store, next);
+	};
 };
-var asyncContextProvider = Object.assign(
-  createProvider(),
-  {
-    operations: [
-      "query",
-      "mutation",
-      "field",
-      "subscription.resolve",
-      "subscription.subscribe",
-      "resolveReference"
-    ],
-    with: (...keyValues) => {
-      return createProvider(...keyValues);
-    },
-    run: async (resolve, ...keyValues) => {
-      const store = onlyMemoization();
-      const map = getMemoizationMap(store);
-      for (const [key, value] of keyValues) {
-        map.set(key, value);
-      }
-      return resolverPayloadStorage.run(store, resolve);
-    }
-  }
-);
+const asyncContextProvider = Object.assign(createProvider(), {
+	operations: [
+		"query",
+		"mutation",
+		"field",
+		"subscription.resolve",
+		"subscription.subscribe",
+		"resolveReference"
+	],
+	with: (...keyValues) => {
+		return createProvider(...keyValues);
+	},
+	run: async (resolve, ...keyValues) => {
+		const store = onlyMemoization();
+		const map = getMemoizationMap(store);
+		for (const [key, value] of keyValues) map.set(key, value);
+		return resolverPayloadStorage.run(store, resolve);
+	}
+});
 
-// src/context/use-resolving-fields.ts
-var useResolvingFields = createContext(
-  () => {
-    const payload = useResolverPayload();
-    if (!payload) return;
-    return getResolvingFields(payload);
-  }
-);
-export {
-  ContextMemoization,
-  InjectableContext,
-  asyncContextProvider,
-  bindAsyncIterator,
-  createContext,
-  createMemoization,
-  isAsyncIterator,
-  resolverPayloadStorage,
-  useContext,
-  useMemoizationMap,
-  useResolverPayload,
-  useResolvingFields
-};
+//#endregion
+//#region src/context/use-resolving-fields.ts
+/**
+* A hook that analyzes and processes field resolution in a GraphQL query.
+*
+* @returns An object containing sets of different field types,
+* or undefined if no resolver payload is available
+*/
+const useResolvingFields = createContext(() => {
+	const payload = useResolverPayload();
+	if (!payload) return;
+	return getResolvingFields(payload);
+});
+
+//#endregion
+export { ContextMemoization, InjectableContext, asyncContextProvider, bindAsyncIterator, createContext, createMemoization, isAsyncIterator, resolverPayloadStorage, useContext, useMemoizationMap, useResolverPayload, useResolvingFields };