@gqloom/core 0.9.2 → 0.9.3

package/dist/context.cjs

@@ -424,6 +424,14 @@ var asyncContextProvider = Object.assign(
     ],
     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);
     }
   }
 );

package/dist/context.d.cts

@@ -119,7 +119,44 @@ interface CallableContextMemoization<T> extends ContextMemoization<T> {
  */
 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>;
 }
 declare const asyncContextProvider: AsyncContextProvider;
 

package/dist/context.d.ts

@@ -119,7 +119,44 @@ interface CallableContextMemoization<T> extends ContextMemoization<T> {
  */
 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>;
 }
 declare const asyncContextProvider: AsyncContextProvider;
 

package/dist/context.js

@@ -206,6 +206,14 @@ var asyncContextProvider = Object.assign(
     ],
     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);
     }
   }
 );

package/dist/index.d.cts

@@ -467,4 +467,4 @@ interface GQLoomExtensionAttribute {
     directives?: string[];
 }
 
-export { BaseField, type BatchLoadFn, ChainResolver, type CoreSchemaWeaverConfig, type CoreSchemaWeaverConfigOptions, type DirectiveItem, type DirectiveRecord, EasyDataLoader, Field, FieldChainFactory, FieldFactoryWithUtils, FieldOptions, FieldOrOperation, type GQLoomExtensionAttribute, type GQLoomExtensions, type GlobalWeaverContext, GraphQLFieldOptions, GraphQLSchemaLoom, GraphQLSilk, InferInputI, type ListSilk, LoomObjectType, MayPromise, Middleware, Mutation, MutationChainFactory, MutationFactoryWithChain, MutationOptions, type NonNullSilk, type NullableSilk, OPERATION_OBJECT_NAMES, ObjectChainResolver, OmitInUnion, Operation, Query, QueryChainFactory, QueryFactoryWithChain, QueryOptions, Resolver, type ResolverFactory, ResolverOptions, ResolverOptionsWithExtensions, ResolverPayload, type SchemaWeaver, StandardSchemaV1, Subscription, SubscriptionChainFactory, SubscriptionFactoryWithChain, SubscriptionOptions, type ToExecutorProps, ValueOf, type WeaverConfig, type WeaverContext, capitalize, collectName, collectNames, createField, createMutation, createQuery, createSubscription, deepMerge, defaultSubscriptionResolve, ensureInputObjectType, ensureInputType, ensureInterfaceType, field, getCacheType, getFieldOptions, getGraphQLType, getOperationOptions, getSubscriptionOptions, initWeaverContext, inputToArgs, isSchemaVendorWeaver, isSilk, listSilk, loom, mapValue, markErrorLocation, markLocation, meta, mutation, nonNullSilk, notNullish, nullableSilk, parseSilk, pascalCase, provideWeaverContext, query, resolver, screamingSnakeCase, silk, subscription, toObjMap, tryIn, weave, weaverContext };
+export { BaseField, type BatchLoadFn, ChainResolver, type CoreSchemaWeaverConfig, type CoreSchemaWeaverConfigOptions, type DirectiveItem, type DirectiveRecord, EasyDataLoader, type Executor, Field, FieldChainFactory, FieldFactoryWithUtils, FieldOptions, FieldOrOperation, type GQLoomExtensionAttribute, type GQLoomExtensions, type GlobalWeaverContext, GraphQLFieldOptions, GraphQLSchemaLoom, GraphQLSilk, InferInputI, type ListSilk, LoomObjectType, MayPromise, Middleware, Mutation, MutationChainFactory, MutationFactoryWithChain, MutationOptions, type NonNullSilk, type NullableSilk, OPERATION_OBJECT_NAMES, ObjectChainResolver, OmitInUnion, Operation, Query, QueryChainFactory, QueryFactoryWithChain, QueryOptions, Resolver, type ResolverFactory, ResolverOptions, ResolverOptionsWithExtensions, ResolverPayload, type SchemaWeaver, StandardSchemaV1, Subscription, SubscriptionChainFactory, SubscriptionFactoryWithChain, SubscriptionOptions, type ToExecutorProps, ValueOf, type WeaverConfig, type WeaverContext, capitalize, collectName, collectNames, createField, createMutation, createQuery, createSubscription, deepMerge, defaultSubscriptionResolve, ensureInputObjectType, ensureInputType, ensureInterfaceType, field, getCacheType, getFieldOptions, getGraphQLType, getOperationOptions, getSubscriptionOptions, initWeaverContext, inputToArgs, isSchemaVendorWeaver, isSilk, listSilk, loom, mapValue, markErrorLocation, markLocation, meta, mutation, nonNullSilk, notNullish, nullableSilk, parseSilk, pascalCase, provideWeaverContext, query, resolver, screamingSnakeCase, silk, subscription, toObjMap, tryIn, weave, weaverContext };

package/dist/index.d.ts

@@ -467,4 +467,4 @@ interface GQLoomExtensionAttribute {
     directives?: string[];
 }
 
-export { BaseField, type BatchLoadFn, ChainResolver, type CoreSchemaWeaverConfig, type CoreSchemaWeaverConfigOptions, type DirectiveItem, type DirectiveRecord, EasyDataLoader, Field, FieldChainFactory, FieldFactoryWithUtils, FieldOptions, FieldOrOperation, type GQLoomExtensionAttribute, type GQLoomExtensions, type GlobalWeaverContext, GraphQLFieldOptions, GraphQLSchemaLoom, GraphQLSilk, InferInputI, type ListSilk, LoomObjectType, MayPromise, Middleware, Mutation, MutationChainFactory, MutationFactoryWithChain, MutationOptions, type NonNullSilk, type NullableSilk, OPERATION_OBJECT_NAMES, ObjectChainResolver, OmitInUnion, Operation, Query, QueryChainFactory, QueryFactoryWithChain, QueryOptions, Resolver, type ResolverFactory, ResolverOptions, ResolverOptionsWithExtensions, ResolverPayload, type SchemaWeaver, StandardSchemaV1, Subscription, SubscriptionChainFactory, SubscriptionFactoryWithChain, SubscriptionOptions, type ToExecutorProps, ValueOf, type WeaverConfig, type WeaverContext, capitalize, collectName, collectNames, createField, createMutation, createQuery, createSubscription, deepMerge, defaultSubscriptionResolve, ensureInputObjectType, ensureInputType, ensureInterfaceType, field, getCacheType, getFieldOptions, getGraphQLType, getOperationOptions, getSubscriptionOptions, initWeaverContext, inputToArgs, isSchemaVendorWeaver, isSilk, listSilk, loom, mapValue, markErrorLocation, markLocation, meta, mutation, nonNullSilk, notNullish, nullableSilk, parseSilk, pascalCase, provideWeaverContext, query, resolver, screamingSnakeCase, silk, subscription, toObjMap, tryIn, weave, weaverContext };
+export { BaseField, type BatchLoadFn, ChainResolver, type CoreSchemaWeaverConfig, type CoreSchemaWeaverConfigOptions, type DirectiveItem, type DirectiveRecord, EasyDataLoader, type Executor, Field, FieldChainFactory, FieldFactoryWithUtils, FieldOptions, FieldOrOperation, type GQLoomExtensionAttribute, type GQLoomExtensions, type GlobalWeaverContext, GraphQLFieldOptions, GraphQLSchemaLoom, GraphQLSilk, InferInputI, type ListSilk, LoomObjectType, MayPromise, Middleware, Mutation, MutationChainFactory, MutationFactoryWithChain, MutationOptions, type NonNullSilk, type NullableSilk, OPERATION_OBJECT_NAMES, ObjectChainResolver, OmitInUnion, Operation, Query, QueryChainFactory, QueryFactoryWithChain, QueryOptions, Resolver, type ResolverFactory, ResolverOptions, ResolverOptionsWithExtensions, ResolverPayload, type SchemaWeaver, StandardSchemaV1, Subscription, SubscriptionChainFactory, SubscriptionFactoryWithChain, SubscriptionOptions, type ToExecutorProps, ValueOf, type WeaverConfig, type WeaverContext, capitalize, collectName, collectNames, createField, createMutation, createQuery, createSubscription, deepMerge, defaultSubscriptionResolve, ensureInputObjectType, ensureInputType, ensureInterfaceType, field, getCacheType, getFieldOptions, getGraphQLType, getOperationOptions, getSubscriptionOptions, initWeaverContext, inputToArgs, isSchemaVendorWeaver, isSilk, listSilk, loom, mapValue, markErrorLocation, markLocation, meta, mutation, nonNullSilk, notNullish, nullableSilk, parseSilk, pascalCase, provideWeaverContext, query, resolver, screamingSnakeCase, silk, subscription, toObjMap, tryIn, weave, weaverContext };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gqloom/core",
-  "version": "0.9.2",
+  "version": "0.9.3",
   "description": "Create GraphQL schema and resolvers with TypeScript.",
   "type": "module",
   "main": "./dist/index.js",