@gqloom/core 0.10.0 → 0.11.0

package/dist/context.d.cts

@@ -1,11 +1,12 @@
-import { P as OnlyMemoizationPayload, R as ResolverPayload, B as BaseField, v as Middleware, K as ResolvingFields } from './context-uzUlbx3r.cjs';
-import { AsyncLocalStorage } from 'node:async_hooks';
-import 'graphql';
+import { BaseField, Middleware, OnlyMemoizationPayload, ResolverPayload, ResolvingFields } from "./index-DUqXX1Tm.cjs";
+import { AsyncLocalStorage } from "node:async_hooks";
+
+//#region src/context/context.d.ts
 
 /**
  * the AsyncLocalStorage instance to store the resolver payload
  */
-declare const resolverPayloadStorage: AsyncLocalStorage<OnlyMemoizationPayload | ResolverPayload<object, BaseField>>;
+declare const resolverPayloadStorage: AsyncLocalStorage<ResolverPayload<object, BaseField> | OnlyMemoizationPayload>;
 /**
  * use detailed payload of the current resolver
  * @returns the resolver payload
@@ -21,8 +22,8 @@ declare function useContext<TContextType = object>(): TContextType;
  */
 declare function useMemoizationMap(): WeakMap<WeakKey, any> | undefined;
 interface ContextOptions {
-    getContextMap: () => WeakMap<WeakKey, any> | undefined;
-    key: WeakKey;
+  getContextMap: () => WeakMap<WeakKey, any> | undefined;
+  key: WeakKey;
 }
 /**
  * A class that provides dependency injection and context sharing capabilities.
@@ -32,75 +33,75 @@ interface ContextOptions {
  *
  */
 declare class InjectableContext<T> implements ContextOptions {
-    readonly getter: () => T;
-    /**
-     * 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: () => T, options?: Partial<ContextOptions>);
-    /**
-     * A function that returns the WeakMap used to store context values.
-     * This can be customized to use different storage mechanisms.
-     */
-    getContextMap: () => WeakMap<WeakKey, any> | undefined;
-    /**
-     * A unique key used to identify this context in the WeakMap.
-     * This is used to store and retrieve values from the context map.
-     */
-    readonly key: WeakKey;
-    /**
-     * 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(): T;
-    /**
-     * 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: () => T): [WeakKey, () => T];
+  readonly getter: () => T;
+  /**
+   * 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: () => T, options?: Partial<ContextOptions>);
+  /**
+   * A function that returns the WeakMap used to store context values.
+   * This can be customized to use different storage mechanisms.
+   */
+  getContextMap: () => WeakMap<WeakKey, any> | undefined;
+  /**
+   * A unique key used to identify this context in the WeakMap.
+   * This is used to store and retrieve values from the context map.
+   */
+  readonly key: WeakKey;
+  /**
+   * 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(): T;
+  /**
+   * 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: () => T): [WeakKey, () => T];
 }
 /**
  * Create a memoization in context to store the result of a getter function
  */
 declare class ContextMemoization<T> implements ContextOptions {
-    readonly getter: () => T;
-    constructor(getter: () => T, options?: Partial<ContextOptions>);
-    getContextMap: () => WeakMap<WeakKey, any> | undefined;
-    readonly key: WeakKey;
-    /**
-     * Get the value in memoization or call the getter function
-     * @returns the value of the getter function
-     */
-    get(): T;
-    /**
-     * Clear the memoization
-     * @returns true if the memoization is cleared, undefined if the context is not found
-     */
-    clear(): boolean | undefined;
-    /**
-     * Check if the memoization exists
-     * @returns true if the memoization exists, undefined if the context is not found
-     */
-    exists(): boolean | undefined;
-    /**
-     * 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: T): WeakMap<WeakKey, any> | undefined;
-    provide(value: T): [WeakKey, T];
+  readonly getter: () => T;
+  constructor(getter: () => T, options?: Partial<ContextOptions>);
+  getContextMap: () => WeakMap<WeakKey, any> | undefined;
+  readonly key: WeakKey;
+  /**
+   * Get the value in memoization or call the getter function
+   * @returns the value of the getter function
+   */
+  get(): T;
+  /**
+   * Clear the memoization
+   * @returns true if the memoization is cleared, undefined if the context is not found
+   */
+  clear(): boolean | undefined;
+  /**
+   * Check if the memoization exists
+   * @returns true if the memoization exists, undefined if the context is not found
+   */
+  exists(): boolean | undefined;
+  /**
+   * 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: T): WeakMap<WeakKey, any> | undefined;
+  provide(value: T): [WeakKey, T];
 }
 interface CallableContext<T> extends InjectableContext<T> {
-    (): T;
+  (): T;
 }
 /**
  * Create a callable context
@@ -112,54 +113,55 @@ declare function createContext<T>(...args: ConstructorParameters<typeof Injectab
  * Async Memoization with a callable function
  */
 interface CallableContextMemoization<T> extends ContextMemoization<T> {
-    (): T;
+  (): T;
 }
 /**
  * Create a memoization in context to store the result of a getter function
  */
 declare function createMemoization<T>(...args: ConstructorParameters<typeof ContextMemoization<T>>): CallableContextMemoization<T>;
 interface AsyncContextProvider extends Middleware {
-    /**
-     * Creates a middleware that injects key-value pairs into the context during resolver execution.
-     * The injected values will be available throughout the entire resolver execution chain.
-     *
-     * @param keyValues - An array of tuples containing a WeakKey and its corresponding value
-     * @returns A middleware function that injects the provided key-value pairs into the context
-     *
-     * @example
-     * ```ts
-     * const executor = resolver.toExecutor(
-     *   asyncContextProvider.with(
-     *     useDefaultName.provide(() => "Default Name")
-     *   )
-     * )
-     * ```
-     */
-    with: (...keyValues: [WeakKey, any][]) => Middleware;
-    /**
-     * Executes an async function with injected context values.
-     * The provided key-value pairs will be available in the context during the function execution.
-     *
-     * @template T - The return type of the async function
-     * @param resolve - The async function to execute
-     * @param keyValues - An array of tuples containing a WeakKey and its corresponding value
-     * @returns A Promise that resolves to the result of the async function
-     *
-     * @example
-     * ```ts
-     * const result = await asyncContextProvider.run(
-     *   async () => {
-     *     const name = useDefaultName()
-     *     return `Hello, ${name}!`
-     *   },
-     *   useDefaultName.provide(() => "John")
-     * )
-     * ```
-     */
-    run: <T>(resolve: () => Promise<T>, ...keyValues: [WeakKey, any][]) => Promise<T>;
+  /**
+   * Creates a middleware that injects key-value pairs into the context during resolver execution.
+   * The injected values will be available throughout the entire resolver execution chain.
+   *
+   * @param keyValues - An array of tuples containing a WeakKey and its corresponding value
+   * @returns A middleware function that injects the provided key-value pairs into the context
+   *
+   * @example
+   * ```ts
+   * const executor = resolver.toExecutor(
+   *   asyncContextProvider.with(
+   *     useDefaultName.provide(() => "Default Name")
+   *   )
+   * )
+   * ```
+   */
+  with: (...keyValues: [WeakKey, any][]) => Middleware;
+  /**
+   * Executes an async function with injected context values.
+   * The provided key-value pairs will be available in the context during the function execution.
+   *
+   * @template T - The return type of the async function
+   * @param resolve - The async function to execute
+   * @param keyValues - An array of tuples containing a WeakKey and its corresponding value
+   * @returns A Promise that resolves to the result of the async function
+   *
+   * @example
+   * ```ts
+   * const result = await asyncContextProvider.run(
+   *   async () => {
+   *     const name = useDefaultName()
+   *     return `Hello, ${name}!`
+   *   },
+   *   useDefaultName.provide(() => "John")
+   * )
+   * ```
+   */
+  run: <T>(resolve: () => Promise<T>, ...keyValues: [WeakKey, any][]) => Promise<T>;
 }
 declare const asyncContextProvider: AsyncContextProvider;
-
+//#endregion
+//#region src/context/use-resolving-fields.d.ts
 /**
  * A hook that analyzes and processes field resolution in a GraphQL query.
  *
@@ -167,8 +169,9 @@ declare const asyncContextProvider: AsyncContextProvider;
  * or undefined if no resolver payload is available
  */
 declare const useResolvingFields: CallableContext<ResolvingFields | undefined>;
-
+//#endregion
+//#region src/context/async-iterator.d.ts
 declare function bindAsyncIterator<TAsyncLocalStorage extends AsyncLocalStorage<unknown>, TAsyncIterator extends AsyncIterator<unknown, unknown, unknown>>(storage: TAsyncLocalStorage, generator: TAsyncIterator): TAsyncIterator;
 declare function isAsyncIterator(value: unknown): value is AsyncIterator<unknown, unknown, unknown>;
-
-export { type AsyncContextProvider, type CallableContext, type CallableContextMemoization, ContextMemoization, InjectableContext, asyncContextProvider, bindAsyncIterator, createContext, createMemoization, isAsyncIterator, resolverPayloadStorage, useContext, useMemoizationMap, useResolverPayload, useResolvingFields };
+//#endregion
+export { AsyncContextProvider, CallableContext, CallableContextMemoization, ContextMemoization, InjectableContext, asyncContextProvider, bindAsyncIterator, createContext, createMemoization, isAsyncIterator, resolverPayloadStorage, useContext, useMemoizationMap, useResolverPayload, useResolvingFields };

package/dist/context.d.ts

@@ -1,11 +1,12 @@
-import { P as OnlyMemoizationPayload, R as ResolverPayload, B as BaseField, v as Middleware, K as ResolvingFields } from './context-uzUlbx3r.js';
-import { AsyncLocalStorage } from 'node:async_hooks';
-import 'graphql';
+import { BaseField, Middleware, OnlyMemoizationPayload, ResolverPayload, ResolvingFields } from "./index-GSWAHvDy.js";
+import { AsyncLocalStorage } from "node:async_hooks";
+
+//#region src/context/context.d.ts
 
 /**
  * the AsyncLocalStorage instance to store the resolver payload
  */
-declare const resolverPayloadStorage: AsyncLocalStorage<OnlyMemoizationPayload | ResolverPayload<object, BaseField>>;
+declare const resolverPayloadStorage: AsyncLocalStorage<ResolverPayload<object, BaseField> | OnlyMemoizationPayload>;
 /**
  * use detailed payload of the current resolver
  * @returns the resolver payload
@@ -21,8 +22,8 @@ declare function useContext<TContextType = object>(): TContextType;
  */
 declare function useMemoizationMap(): WeakMap<WeakKey, any> | undefined;
 interface ContextOptions {
-    getContextMap: () => WeakMap<WeakKey, any> | undefined;
-    key: WeakKey;
+  getContextMap: () => WeakMap<WeakKey, any> | undefined;
+  key: WeakKey;
 }
 /**
  * A class that provides dependency injection and context sharing capabilities.
@@ -32,75 +33,75 @@ interface ContextOptions {
  *
  */
 declare class InjectableContext<T> implements ContextOptions {
-    readonly getter: () => T;
-    /**
-     * 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: () => T, options?: Partial<ContextOptions>);
-    /**
-     * A function that returns the WeakMap used to store context values.
-     * This can be customized to use different storage mechanisms.
-     */
-    getContextMap: () => WeakMap<WeakKey, any> | undefined;
-    /**
-     * A unique key used to identify this context in the WeakMap.
-     * This is used to store and retrieve values from the context map.
-     */
-    readonly key: WeakKey;
-    /**
-     * 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(): T;
-    /**
-     * 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: () => T): [WeakKey, () => T];
+  readonly getter: () => T;
+  /**
+   * 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: () => T, options?: Partial<ContextOptions>);
+  /**
+   * A function that returns the WeakMap used to store context values.
+   * This can be customized to use different storage mechanisms.
+   */
+  getContextMap: () => WeakMap<WeakKey, any> | undefined;
+  /**
+   * A unique key used to identify this context in the WeakMap.
+   * This is used to store and retrieve values from the context map.
+   */
+  readonly key: WeakKey;
+  /**
+   * 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(): T;
+  /**
+   * 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: () => T): [WeakKey, () => T];
 }
 /**
  * Create a memoization in context to store the result of a getter function
  */
 declare class ContextMemoization<T> implements ContextOptions {
-    readonly getter: () => T;
-    constructor(getter: () => T, options?: Partial<ContextOptions>);
-    getContextMap: () => WeakMap<WeakKey, any> | undefined;
-    readonly key: WeakKey;
-    /**
-     * Get the value in memoization or call the getter function
-     * @returns the value of the getter function
-     */
-    get(): T;
-    /**
-     * Clear the memoization
-     * @returns true if the memoization is cleared, undefined if the context is not found
-     */
-    clear(): boolean | undefined;
-    /**
-     * Check if the memoization exists
-     * @returns true if the memoization exists, undefined if the context is not found
-     */
-    exists(): boolean | undefined;
-    /**
-     * 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: T): WeakMap<WeakKey, any> | undefined;
-    provide(value: T): [WeakKey, T];
+  readonly getter: () => T;
+  constructor(getter: () => T, options?: Partial<ContextOptions>);
+  getContextMap: () => WeakMap<WeakKey, any> | undefined;
+  readonly key: WeakKey;
+  /**
+   * Get the value in memoization or call the getter function
+   * @returns the value of the getter function
+   */
+  get(): T;
+  /**
+   * Clear the memoization
+   * @returns true if the memoization is cleared, undefined if the context is not found
+   */
+  clear(): boolean | undefined;
+  /**
+   * Check if the memoization exists
+   * @returns true if the memoization exists, undefined if the context is not found
+   */
+  exists(): boolean | undefined;
+  /**
+   * 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: T): WeakMap<WeakKey, any> | undefined;
+  provide(value: T): [WeakKey, T];
 }
 interface CallableContext<T> extends InjectableContext<T> {
-    (): T;
+  (): T;
 }
 /**
  * Create a callable context
@@ -112,54 +113,55 @@ declare function createContext<T>(...args: ConstructorParameters<typeof Injectab
  * Async Memoization with a callable function
  */
 interface CallableContextMemoization<T> extends ContextMemoization<T> {
-    (): T;
+  (): T;
 }
 /**
  * Create a memoization in context to store the result of a getter function
  */
 declare function createMemoization<T>(...args: ConstructorParameters<typeof ContextMemoization<T>>): CallableContextMemoization<T>;
 interface AsyncContextProvider extends Middleware {
-    /**
-     * Creates a middleware that injects key-value pairs into the context during resolver execution.
-     * The injected values will be available throughout the entire resolver execution chain.
-     *
-     * @param keyValues - An array of tuples containing a WeakKey and its corresponding value
-     * @returns A middleware function that injects the provided key-value pairs into the context
-     *
-     * @example
-     * ```ts
-     * const executor = resolver.toExecutor(
-     *   asyncContextProvider.with(
-     *     useDefaultName.provide(() => "Default Name")
-     *   )
-     * )
-     * ```
-     */
-    with: (...keyValues: [WeakKey, any][]) => Middleware;
-    /**
-     * Executes an async function with injected context values.
-     * The provided key-value pairs will be available in the context during the function execution.
-     *
-     * @template T - The return type of the async function
-     * @param resolve - The async function to execute
-     * @param keyValues - An array of tuples containing a WeakKey and its corresponding value
-     * @returns A Promise that resolves to the result of the async function
-     *
-     * @example
-     * ```ts
-     * const result = await asyncContextProvider.run(
-     *   async () => {
-     *     const name = useDefaultName()
-     *     return `Hello, ${name}!`
-     *   },
-     *   useDefaultName.provide(() => "John")
-     * )
-     * ```
-     */
-    run: <T>(resolve: () => Promise<T>, ...keyValues: [WeakKey, any][]) => Promise<T>;
+  /**
+   * Creates a middleware that injects key-value pairs into the context during resolver execution.
+   * The injected values will be available throughout the entire resolver execution chain.
+   *
+   * @param keyValues - An array of tuples containing a WeakKey and its corresponding value
+   * @returns A middleware function that injects the provided key-value pairs into the context
+   *
+   * @example
+   * ```ts
+   * const executor = resolver.toExecutor(
+   *   asyncContextProvider.with(
+   *     useDefaultName.provide(() => "Default Name")
+   *   )
+   * )
+   * ```
+   */
+  with: (...keyValues: [WeakKey, any][]) => Middleware;
+  /**
+   * Executes an async function with injected context values.
+   * The provided key-value pairs will be available in the context during the function execution.
+   *
+   * @template T - The return type of the async function
+   * @param resolve - The async function to execute
+   * @param keyValues - An array of tuples containing a WeakKey and its corresponding value
+   * @returns A Promise that resolves to the result of the async function
+   *
+   * @example
+   * ```ts
+   * const result = await asyncContextProvider.run(
+   *   async () => {
+   *     const name = useDefaultName()
+   *     return `Hello, ${name}!`
+   *   },
+   *   useDefaultName.provide(() => "John")
+   * )
+   * ```
+   */
+  run: <T>(resolve: () => Promise<T>, ...keyValues: [WeakKey, any][]) => Promise<T>;
 }
 declare const asyncContextProvider: AsyncContextProvider;
-
+//#endregion
+//#region src/context/use-resolving-fields.d.ts
 /**
  * A hook that analyzes and processes field resolution in a GraphQL query.
  *
@@ -167,8 +169,9 @@ declare const asyncContextProvider: AsyncContextProvider;
  * or undefined if no resolver payload is available
  */
 declare const useResolvingFields: CallableContext<ResolvingFields | undefined>;
-
+//#endregion
+//#region src/context/async-iterator.d.ts
 declare function bindAsyncIterator<TAsyncLocalStorage extends AsyncLocalStorage<unknown>, TAsyncIterator extends AsyncIterator<unknown, unknown, unknown>>(storage: TAsyncLocalStorage, generator: TAsyncIterator): TAsyncIterator;
 declare function isAsyncIterator(value: unknown): value is AsyncIterator<unknown, unknown, unknown>;
-
-export { type AsyncContextProvider, type CallableContext, type CallableContextMemoization, ContextMemoization, InjectableContext, asyncContextProvider, bindAsyncIterator, createContext, createMemoization, isAsyncIterator, resolverPayloadStorage, useContext, useMemoizationMap, useResolverPayload, useResolvingFields };
+//#endregion
+export { AsyncContextProvider, CallableContext, CallableContextMemoization, ContextMemoization, InjectableContext, asyncContextProvider, bindAsyncIterator, createContext, createMemoization, isAsyncIterator, resolverPayloadStorage, useContext, useMemoizationMap, useResolverPayload, useResolvingFields };