@fluojs/graphql 1.0.4 → 2.0.0

package/dist/decorators.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"decorators.d.ts","sourceRoot":"","sources":["../src/decorators.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAoB,cAAc,EAAE,qBAAqB,EAA6C,MAAM,YAAY,CAAC;AAGrI,KAAK,wBAAwB,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,qBAAqB,KAAK,IAAI,CAAC;AAC1F,KAAK,yBAAyB,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,2BAA2B,KAAK,IAAI,CAAC;AACjG,KAAK,wBAAwB,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,0BAA0B,CAAC,IAAI,EAAE,KAAK,CAAC,KAAK,IAAI,CAAC;AAE1H;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAC1C,UAAU,CAAC,EAAE,qBAAqB,CAAC;CACpC;AAED,KAAK,kBAAkB,GAAG,wBAAwB,CAAC;AACnD,KAAK,mBAAmB,GAAG,yBAAyB,CAAC;AACrD,KAAK,kBAAkB,GAAG,wBAAwB,CAAC;AAyGnD;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,kBAAkB,CAQ9D;AAED;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,kBAAkB,CAAC,EAAE,MAAM,GAAG,qBAAqB,GAAG,mBAAmB,CAE9F;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,GAAG,qBAAqB,GAAG,mBAAmB,CAEjG;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,kBAAkB,CAAC,EAAE,MAAM,GAAG,qBAAqB,GAAG,mBAAmB,CAErG;AAED;;;;;GAKG;AACH,wBAAgB,GAAG,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,kBAAkB,CAmBxD"}
+{"version":3,"file":"decorators.d.ts","sourceRoot":"","sources":["../src/decorators.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAIV,cAAc,EACd,qBAAqB,EAGtB,MAAM,YAAY,CAAC;AAGpB,KAAK,wBAAwB,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,qBAAqB,KAAK,IAAI,CAAC;AAC1F,KAAK,yBAAyB,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,2BAA2B,KAAK,IAAI,CAAC;AACjG,KAAK,wBAAwB,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,0BAA0B,CAAC,IAAI,EAAE,KAAK,CAAC,KAAK,IAAI,CAAC;AAE1H;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAC1C,UAAU,CAAC,EAAE,qBAAqB,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,IAAI,CAAC,EAAE,qBAAqB,CAAC;IAC7B,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,KAAK,kBAAkB,GAAG,wBAAwB,CAAC;AACnD,KAAK,mBAAmB,GAAG,yBAAyB,CAAC;AACrD,KAAK,kBAAkB,GAAG,wBAAwB,CAAC;AAoLnD;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,kBAAkB,CAQ9D;AAED;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,kBAAkB,CAAC,EAAE,MAAM,GAAG,qBAAqB,GAAG,mBAAmB,CAE9F;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,GAAG,qBAAqB,GAAG,mBAAmB,CAEjG;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,kBAAkB,CAAC,EAAE,MAAM,GAAG,qBAAqB,GAAG,mBAAmB,CAErG;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,kBAAkB,CAAC,EAAE,MAAM,GAAG,oBAAoB,GAAG,mBAAmB,CAerG;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,MAAM,CAAC,cAAc,SAAI,GAAG,mBAAmB,CAE9D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,OAAO,CAAC,cAAc,SAAI,GAAG,mBAAmB,CAE/D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,IAAI,CAAC,cAAc,SAAI,GAAG,mBAAmB,CAE5D;AAED;;;;;GAKG;AACH,wBAAgB,GAAG,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,kBAAkB,CAmBxD"}

package/dist/decorators.js

@@ -1,10 +1,14 @@
 import { ensureMetadataSymbol } from '@fluojs/core/internal';
-import { argMetadataSymbol, handlerMetadataSymbol, resolverMetadataSymbol } from './metadata.js';
+import { argMetadataSymbol, fieldResolverParameterMetadataSymbol, handlerMetadataSymbol, resolverMetadataSymbol } from './metadata.js';
 
 /**
  * Describes the resolver method options contract.
  */
 
+/**
+ * Describes an object field resolver's field name and optional output type override.
+ */
+
 ensureMetadataSymbol();
 function getStandardMetadataBag(metadata) {
   return metadata;
@@ -53,11 +57,28 @@ function defineStandardHandlerMetadata(metadata, propertyKey, handlerMetadata) {
     argTypes: handlerMetadata.argTypes,
     fieldName: handlerMetadata.fieldName,
     inputClass: handlerMetadata.inputClass,
+    nullable: handlerMetadata.nullable,
     outputType: handlerMetadata.outputType,
     type: handlerMetadata.type
   });
   bag[handlerMetadataSymbol] = map;
 }
+function defineStandardFieldResolverParameterMetadata(metadata, propertyKey, parameterIndex, kind) {
+  const bag = getStandardMetadataBag(metadata);
+  const current = bag[fieldResolverParameterMetadataSymbol];
+  const methods = current ?? new Map();
+  const bindings = methods.get(propertyKey) ?? new Map();
+  const existing = bindings.get(parameterIndex);
+  if (existing) {
+    throw new Error(`GraphQL field resolver parameter ${String(parameterIndex)} on ${String(propertyKey)} is already bound to ${existing.kind}.`);
+  }
+  bindings.set(parameterIndex, {
+    index: parameterIndex,
+    kind
+  });
+  methods.set(propertyKey, bindings);
+  bag[fieldResolverParameterMetadataSymbol] = methods;
+}
 function defineStandardArgFieldMetadata(metadata, propertyKey, argFieldMetadata) {
   const bag = getStandardMetadataBag(metadata);
   const current = bag[argMetadataSymbol];
@@ -82,6 +103,42 @@ function createMethodDecorator(type, fieldNameOrOptions) {
   };
   return decorator;
 }
+function normalizeFieldResolverMetadata(fieldNameOrOptions) {
+  if (typeof fieldNameOrOptions === 'string') {
+    return {
+      fieldName: fieldNameOrOptions.trim() || undefined,
+      type: 'field'
+    };
+  }
+  return {
+    argTypes: fieldNameOrOptions?.argTypes,
+    fieldName: fieldNameOrOptions?.fieldName?.trim() || undefined,
+    inputClass: fieldNameOrOptions?.input,
+    nullable: fieldNameOrOptions?.nullable,
+    outputType: fieldNameOrOptions?.type,
+    type: 'field'
+  };
+}
+function createFieldResolverParameterDecorator(kind, parameterIndex) {
+  const decoratorName = {
+    context: 'Context',
+    input: 'Args',
+    parent: 'Parent'
+  }[kind];
+  if (!Number.isSafeInteger(parameterIndex) || parameterIndex < 0) {
+    throw new Error(`@${decoratorName}() parameter index must be a non-negative integer.`);
+  }
+  const decorator = (_value, context) => {
+    if (context.private) {
+      throw new Error(`@${decoratorName}() cannot be used on private methods.`);
+    }
+    if (context.static) {
+      throw new Error(`@${decoratorName}() cannot be used on static methods.`);
+    }
+    defineStandardFieldResolverParameterMetadata(context.metadata, context.name, parameterIndex, kind);
+  };
+  return decorator;
+}
 
 /**
  * Resolver.
@@ -128,6 +185,71 @@ export function Subscription(fieldNameOrOptions) {
   return createMethodDecorator('subscription', fieldNameOrOptions);
 }
 
+/**
+ * Marks a public instance method as the resolver for one field on the object type owned by `@Resolver(typeName)`.
+ *
+ * @param fieldNameOrOptions Field name or object field resolver options.
+ * @returns A TC39 standard method decorator.
+ */
+export function FieldResolver(fieldNameOrOptions) {
+  const metadata = normalizeFieldResolverMetadata(fieldNameOrOptions);
+  const decorator = (_value, context) => {
+    if (context.private) {
+      throw new Error('@FieldResolver() cannot be used on private methods.');
+    }
+    if (context.static) {
+      throw new Error('@FieldResolver() cannot be used on static methods.');
+    }
+    defineStandardHandlerMetadata(context.metadata, context.name, metadata);
+  };
+  return decorator;
+}
+
+/**
+ * Binds a field resolver method parameter to GraphQL's parent/source object.
+ *
+ * @remarks
+ * TC39 standard decorators do not support parameter-decorator syntax, so this
+ * standard method decorator records the parameter index explicitly. The default
+ * index is `0`.
+ *
+ * @param parameterIndex Zero-based method parameter index to receive the parent value.
+ * @returns A TC39 standard method decorator.
+ */
+export function Parent(parameterIndex = 0) {
+  return createFieldResolverParameterDecorator('parent', parameterIndex);
+}
+
+/**
+ * Binds a field resolver method parameter to the active `GraphQLContext`.
+ *
+ * @remarks
+ * TC39 standard decorators do not support parameter-decorator syntax, so this
+ * standard method decorator records the parameter index explicitly. The default
+ * index is `1`.
+ *
+ * @param parameterIndex Zero-based method parameter index to receive the context value.
+ * @returns A TC39 standard method decorator.
+ */
+export function Context(parameterIndex = 1) {
+  return createFieldResolverParameterDecorator('context', parameterIndex);
+}
+
+/**
+ * Binds a field resolver method parameter to the DTO materialized from GraphQL field arguments.
+ *
+ * @remarks
+ * TC39 standard decorators do not support parameter decorators, so this
+ * standard method decorator records the parameter index explicitly. The default
+ * index is `0`. Pair it with `@FieldResolver({ input: InputDto })`.
+ *
+ * @param parameterIndex Zero-based method parameter index to receive the validated input DTO.
+ * @returns A TC39 standard method decorator.
+ */
+export function Args(parameterIndex = 0) {
+  return createFieldResolverParameterDecorator('input', parameterIndex);
+}
+
 /**
  * Arg.
  *

package/dist/discovery.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../src/discovery.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAGtD,OAAO,KAAK,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAkI3E;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CACzC,eAAe,EAAE,SAAS,cAAc,EAAE,EAC1C,OAAO,EAAE,oBAAoB,GAC5B,kBAAkB,EAAE,CA8CtB"}
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../src/discovery.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAQtD,OAAO,KAAK,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAkI3E;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CACzC,eAAe,EAAE,SAAS,cAAc,EAAE,EAC1C,OAAO,EAAE,oBAAoB,GAC5B,kBAAkB,EAAE,CAoEtB"}

package/dist/discovery.js

@@ -1,5 +1,5 @@
 import { getClassDiMetadata } from '@fluojs/core/internal';
-import { getArgFieldMetadataEntries, getResolverHandlerMetadataEntries, getResolverMetadata } from './metadata.js';
+import { getArgFieldMetadataEntries, getFieldResolverParameterMetadataEntries, getResolverHandlerMetadataEntries, getResolverMetadata } from './metadata.js';
 function scopeFromProvider(provider, factoryResolverClass) {
   if (typeof provider === 'function') {
     return getClassDiMetadata(provider)?.scope ?? 'singleton';
@@ -127,6 +127,16 @@ export function discoverResolverDescriptors(compiledModules, options) {
       handlers: getResolverHandlerMetadataEntries(candidate.targetType.prototype).map(entry => {
         const inputClass = entry.metadata.inputClass;
         const argFields = inputClass !== undefined ? getArgFieldMetadataEntries(inputClass.prototype).map(argField => argField.metadata) : [];
+        const parameterBindings = getFieldResolverParameterMetadataEntries(candidate.targetType.prototype, entry.propertyKey);
+        if (entry.metadata.type !== 'field' && parameterBindings.length > 0) {
+          throw new Error(`@Parent() and @Context() can only bind parameters on @FieldResolver() methods; @Args() follows the same rule. ` + `Invalid placement: ${candidate.targetType.name}.${methodKeyToName(entry.propertyKey)}.`);
+        }
+        if (entry.metadata.type === 'field' && inputClass !== undefined && !parameterBindings.some(binding => binding.kind === 'input')) {
+          throw new Error(`@FieldResolver({ input }) requires @Args() on ${candidate.targetType.name}.${methodKeyToName(entry.propertyKey)}.`);
+        }
+        if (entry.metadata.type === 'field' && inputClass === undefined && parameterBindings.some(binding => binding.kind === 'input')) {
+          throw new Error(`@Args() requires @FieldResolver({ input }) on ${candidate.targetType.name}.${methodKeyToName(entry.propertyKey)}.`);
+        }
         return {
           argFields,
           argTypes: entry.metadata.argTypes,
@@ -134,7 +144,9 @@ export function discoverResolverDescriptors(compiledModules, options) {
           inputClass,
           methodKey: entry.propertyKey,
           methodName: methodKeyToName(entry.propertyKey),
+          nullable: entry.metadata.nullable,
           outputType: entry.metadata.outputType,
+          parameterBindings,
           type: entry.metadata.type
         };
       }),

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 export * from './dataloader.js';
 export * from './decorators.js';
 export { GraphqlModule } from './module.js';
+export type { ArgFieldMetadata, FieldResolverParameterBindingMetadata, FieldResolverParameterKind, GraphQLContext, GraphqlArgType, GraphqlAsyncModuleOptions, GraphqlListTypeRef, GraphqlModuleOptions, GraphqlRequestContext, GraphqlRequestLimitsOptions, GraphqlRootOutputNamedType, GraphqlRootOutputType, GraphqlScalarTypeName, GraphqlSubscriptionsOptions, GraphqlWebSocketLimitsOptions, GraphqlWebSocketSubscriptionsOptions, ResolverHandlerMetadata, ResolverHandlerType, ResolverMetadata, } from './types.js';
 export { isGraphqlListTypeRef, listOf, } from './types.js';
-export type { ArgFieldMetadata, GraphQLContext, GraphqlArgType, GraphqlListTypeRef, GraphqlModuleOptions, GraphqlRequestLimitsOptions, GraphqlRequestContext, GraphqlRootOutputNamedType, GraphqlRootOutputType, GraphqlScalarTypeName, GraphqlSubscriptionsOptions, GraphqlWebSocketSubscriptionsOptions, ResolverHandlerMetadata, ResolverHandlerType, ResolverMetadata, } from './types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EACL,oBAAoB,EACpB,MAAM,GACP,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,kBAAkB,EAClB,oBAAoB,EACpB,2BAA2B,EAC3B,qBAAqB,EACrB,0BAA0B,EAC1B,qBAAqB,EACrB,qBAAqB,EACrB,2BAA2B,EAC3B,oCAAoC,EACpC,uBAAuB,EACvB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,YAAY,EACV,gBAAgB,EAChB,qCAAqC,EACrC,0BAA0B,EAC1B,cAAc,EACd,cAAc,EACd,yBAAyB,EACzB,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,EACrB,2BAA2B,EAC3B,0BAA0B,EAC1B,qBAAqB,EACrB,qBAAqB,EACrB,2BAA2B,EAC3B,6BAA6B,EAC7B,oCAAoC,EACpC,uBAAuB,EACvB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,oBAAoB,EACpB,MAAM,GACP,MAAM,YAAY,CAAC"}

package/dist/instance-of-patch.d.ts

@@ -0,0 +1,21 @@
+/** Represents a GraphQL constructor inspected by the private `instanceOf` helper. */
+export type GraphqlConstructor = Function & {
+    readonly prototype: {
+        readonly [Symbol.toStringTag]?: string;
+    };
+};
+/** Represents the private GraphQL `instanceOf` helper signature. */
+export type GraphqlInstanceOf = (value: unknown, constructor: GraphqlConstructor) => boolean;
+/** Represents the mutable private GraphQL module object that owns the helper. */
+export type GraphqlInstanceOfModule = {
+    instanceOf: GraphqlInstanceOf;
+};
+/**
+ * Installs and releases a cross-realm GraphQL `instanceOf` patch for one module object.
+ *
+ * @param instanceOfModule The GraphQL module object that owns the `instanceOf` helper.
+ * @param allowedObjects The active application's cross-realm GraphQL object allowlist.
+ * @returns A one-time release callback for the application's allowlist.
+ */
+export declare function installGraphqlInstanceOfPatch(instanceOfModule: GraphqlInstanceOfModule, allowedObjects: WeakSet<object>): () => void;
+//# sourceMappingURL=instance-of-patch.d.ts.map

package/dist/instance-of-patch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instance-of-patch.d.ts","sourceRoot":"","sources":["../src/instance-of-patch.ts"],"names":[],"mappings":"AAAA,qFAAqF;AACrF,MAAM,MAAM,kBAAkB,GAAG,QAAQ,GAAG;IAC1C,QAAQ,CAAC,SAAS,EAAE;QAClB,QAAQ,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,EAAE,MAAM,CAAC;KACxC,CAAC;CACH,CAAC;AAEF,oEAAoE;AACpE,MAAM,MAAM,iBAAiB,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,kBAAkB,KAAK,OAAO,CAAC;AAE7F,iFAAiF;AACjF,MAAM,MAAM,uBAAuB,GAAG;IACpC,UAAU,EAAE,iBAAiB,CAAC;CAC/B,CAAC;AA0IF;;;;;;GAMG;AACH,wBAAgB,6BAA6B,CAC3C,gBAAgB,EAAE,uBAAuB,EACzC,cAAc,EAAE,OAAO,CAAC,MAAM,CAAC,GAC9B,MAAM,IAAI,CAmCZ"}

package/dist/instance-of-patch.js

@@ -0,0 +1,126 @@
+/** Represents a GraphQL constructor inspected by the private `instanceOf` helper. */
+
+/** Represents the private GraphQL `instanceOf` helper signature. */
+
+/** Represents the mutable private GraphQL module object that owns the helper. */
+
+const graphqlInstanceOfPatchStateRegistryKey = Symbol.for('@fluojs/graphql.instance-of-patch-state-registry/v1');
+function isGraphqlInstanceOfPatchStateRegistry(value) {
+  if (typeof value !== 'object' || value === null) {
+    return false;
+  }
+  return Reflect.get(value, 'states') instanceof WeakMap;
+}
+function getGraphqlInstanceOfPatchStates() {
+  const registeredValue = Reflect.get(globalThis, graphqlInstanceOfPatchStateRegistryKey);
+  if (isGraphqlInstanceOfPatchStateRegistry(registeredValue)) {
+    return registeredValue.states;
+  }
+  const registry = {
+    states: new WeakMap()
+  };
+  Object.defineProperty(globalThis, graphqlInstanceOfPatchStateRegistryKey, {
+    configurable: false,
+    enumerable: false,
+    value: registry,
+    writable: false
+  });
+  return registry.states;
+}
+function createGraphqlInstanceOfPatchState(originalInstanceOf) {
+  let patchState;
+  const allowedObjectSets = new Set();
+  const patchedInstanceOf = (value, constructor) => {
+    if (patchState.isEvaluatingDelegate) {
+      return isAllowedCrossRealmGraphqlObject(value, constructor, allowedObjectSets);
+    }
+    patchState.isEvaluatingDelegate = true;
+    try {
+      try {
+        if (patchState.originalInstanceOf(value, constructor)) {
+          return true;
+        }
+      } catch (error) {
+        if (isAllowedCrossRealmGraphqlObject(value, constructor, allowedObjectSets)) {
+          return true;
+        }
+        throw error;
+      }
+      return isAllowedCrossRealmGraphqlObject(value, constructor, allowedObjectSets);
+    } finally {
+      patchState.isEvaluatingDelegate = false;
+    }
+  };
+  patchState = {
+    allowedObjectSets,
+    isEvaluatingDelegate: false,
+    originalInstanceOf,
+    patchedInstanceOf
+  };
+  return patchState;
+}
+function getCrossRealmGraphqlTag(value, constructor) {
+  const prototypeTag = constructor.prototype?.[Symbol.toStringTag];
+  const className = typeof prototypeTag === 'string' ? prototypeTag : constructor.name;
+  if (typeof className !== 'string' || !className.startsWith('GraphQL')) {
+    return undefined;
+  }
+  if (typeof value !== 'object' || value === null) {
+    return undefined;
+  }
+  const valueTag = Reflect.get(value, Symbol.toStringTag);
+  if (typeof valueTag === 'string') {
+    return valueTag === className ? className : undefined;
+  }
+  const valueConstructor = Reflect.get(value, 'constructor');
+  const valueClassName = typeof valueConstructor === 'object' && valueConstructor !== null || typeof valueConstructor === 'function' ? Reflect.get(valueConstructor, 'name') : undefined;
+  return typeof valueClassName === 'string' && valueClassName === className ? className : undefined;
+}
+function isAllowedCrossRealmGraphqlObject(value, constructor, allowedObjectSets) {
+  if (typeof value !== 'object' || value === null) {
+    return false;
+  }
+  for (const allowedObjects of allowedObjectSets) {
+    if (allowedObjects.has(value)) {
+      return getCrossRealmGraphqlTag(value, constructor) !== undefined;
+    }
+  }
+  return false;
+}
+
+/**
+ * Installs and releases a cross-realm GraphQL `instanceOf` patch for one module object.
+ *
+ * @param instanceOfModule The GraphQL module object that owns the `instanceOf` helper.
+ * @param allowedObjects The active application's cross-realm GraphQL object allowlist.
+ * @returns A one-time release callback for the application's allowlist.
+ */
+export function installGraphqlInstanceOfPatch(instanceOfModule, allowedObjects) {
+  const patchStates = getGraphqlInstanceOfPatchStates();
+  let patchState = patchStates.get(instanceOfModule);
+  if (patchState === undefined) {
+    patchState = createGraphqlInstanceOfPatchState(instanceOfModule.instanceOf);
+    patchStates.set(instanceOfModule, patchState);
+  } else if (instanceOfModule.instanceOf !== patchState.patchedInstanceOf) {
+    patchState.originalInstanceOf = instanceOfModule.instanceOf;
+  }
+  instanceOfModule.instanceOf = patchState.patchedInstanceOf;
+  patchState.allowedObjectSets.add(allowedObjects);
+  let released = false;
+  return () => {
+    if (released) {
+      return;
+    }
+    released = true;
+    patchState.allowedObjectSets.delete(allowedObjects);
+    if (patchState.allowedObjectSets.size > 0) {
+      return;
+    }
+    if (instanceOfModule.instanceOf === patchState.patchedInstanceOf) {
+      instanceOfModule.instanceOf = patchState.originalInstanceOf;
+    }
+    if (patchStates.get(instanceOfModule) === patchState) {
+      patchStates.delete(instanceOfModule);
+    }
+  };
+}

package/dist/metadata.d.ts

@@ -1,5 +1,5 @@
 import type { MetadataPropertyKey } from '@fluojs/core';
-import type { ArgFieldMetadata, ResolverHandlerMetadata, ResolverMetadata } from './types.js';
+import type { ArgFieldMetadata, FieldResolverParameterBindingMetadata, ResolverHandlerMetadata, ResolverMetadata } from './types.js';
 /**
  * Define resolver metadata.
  *
@@ -66,6 +66,22 @@ export declare function getArgFieldMetadataEntries(target: object): Array<{
     metadata: ArgFieldMetadata;
     propertyKey: MetadataPropertyKey;
 }>;
+/**
+ * Define one positional parameter binding for an object field resolver.
+ *
+ * @param target Resolver prototype that owns the decorated method.
+ * @param propertyKey Decorated method key.
+ * @param metadata Positional binding metadata to store.
+ */
+export declare function defineFieldResolverParameterMetadata(target: object, propertyKey: MetadataPropertyKey, metadata: FieldResolverParameterBindingMetadata): void;
+/**
+ * Get the positional parameter bindings declared for one resolver method.
+ *
+ * @param target Resolver prototype that owns the decorated method.
+ * @param propertyKey Decorated method key.
+ * @returns Parameter bindings ordered by their method parameter index.
+ */
+export declare function getFieldResolverParameterMetadataEntries(target: object, propertyKey: MetadataPropertyKey): FieldResolverParameterBindingMetadata[];
 /**
  * Provides the resolver metadata symbol value.
  */
@@ -78,4 +94,8 @@ export declare const handlerMetadataSymbol: symbol;
  * Provides the arg metadata symbol value.
  */
 export declare const argMetadataSymbol: symbol;
+/**
+ * Provides the object field-resolver parameter metadata symbol value.
+ */
+export declare const fieldResolverParameterMetadataSymbol: symbol;
 //# sourceMappingURL=metadata.d.ts.map

package/dist/metadata.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../src/metadata.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAGxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAoG9F;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,GAAG,IAAI,CAEvF;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAShF;AAED;;;;;;GAMG;AACH,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,mBAAmB,EAChC,QAAQ,EAAE,uBAAuB,GAChC,IAAI,CAEN;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,mBAAmB,GAC/B,uBAAuB,GAAG,SAAS,CASrC;AAED;;;;;GAKG;AACH,wBAAgB,iCAAiC,CAC/C,MAAM,EAAE,MAAM,GACb,KAAK,CAAC;IAAE,QAAQ,EAAE,uBAAuB,CAAC;IAAC,WAAW,EAAE,mBAAmB,CAAA;CAAE,CAAC,CAOhF;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,mBAAmB,EAAE,QAAQ,EAAE,gBAAgB,GAAG,IAAI,CAEzH;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,mBAAmB,GAAG,gBAAgB,GAAG,SAAS,CASlH;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,MAAM,GACb,KAAK,CAAC;IAAE,QAAQ,EAAE,gBAAgB,CAAC;IAAC,WAAW,EAAE,mBAAmB,CAAA;CAAE,CAAC,CAEzE;AAED;;GAEG;AACH,eAAO,MAAM,sBAAsB,QAA8B,CAAC;AAClE;;GAEG;AACH,eAAO,MAAM,qBAAqB,QAA6B,CAAC;AAChE;;GAEG;AACH,eAAO,MAAM,iBAAiB,QAA8B,CAAC"}
+{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../src/metadata.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAGxD,OAAO,KAAK,EACV,gBAAgB,EAChB,qCAAqC,EACrC,uBAAuB,EACvB,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAwIpB;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,GAAG,IAAI,CAEvF;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAUhF;AAED;;;;;;GAMG;AACH,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,mBAAmB,EAChC,QAAQ,EAAE,uBAAuB,GAChC,IAAI,CAEN;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,mBAAmB,GAC/B,uBAAuB,GAAG,SAAS,CAUrC;AAED;;;;;GAKG;AACH,wBAAgB,iCAAiC,CAC/C,MAAM,EAAE,MAAM,GACb,KAAK,CAAC;IAAE,QAAQ,EAAE,uBAAuB,CAAC;IAAC,WAAW,EAAE,mBAAmB,CAAA;CAAE,CAAC,CAOhF;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,mBAAmB,EAAE,QAAQ,EAAE,gBAAgB,GAAG,IAAI,CAEzH;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,mBAAmB,GAAG,gBAAgB,GAAG,SAAS,CAUlH;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,MAAM,GACb,KAAK,CAAC;IAAE,QAAQ,EAAE,gBAAgB,CAAC;IAAC,WAAW,EAAE,mBAAmB,CAAA;CAAE,CAAC,CAEzE;AAED;;;;;;GAMG;AACH,wBAAgB,oCAAoC,CAClD,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,mBAAmB,EAChC,QAAQ,EAAE,qCAAqC,GAC9C,IAAI,CAKN;AAED;;;;;;GAMG;AACH,wBAAgB,wCAAwC,CACtD,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,mBAAmB,GAC/B,qCAAqC,EAAE,CAczC;AAED;;GAEG;AACH,eAAO,MAAM,sBAAsB,QAA8B,CAAC;AAClE;;GAEG;AACH,eAAO,MAAM,qBAAqB,QAA6B,CAAC;AAChE;;GAEG;AACH,eAAO,MAAM,iBAAiB,QAA8B,CAAC;AAC7D;;GAEG;AACH,eAAO,MAAM,oCAAoC,QAA4C,CAAC"}

package/dist/metadata.js

@@ -3,9 +3,11 @@ void ensureSymbolMetadataPolyfill();
 const standardResolverMetadataKey = Symbol.for('fluo.graphql.standard.resolver');
 const standardHandlerMetadataKey = Symbol.for('fluo.graphql.standard.handler');
 const standardArgFieldMetadataKey = Symbol.for('fluo.graphql.standard.arg-field');
+const standardFieldResolverParameterMetadataKey = Symbol.for('fluo.graphql.standard.field-resolver-parameter');
 const resolverMetadataStore = new WeakMap();
 const handlerMetadataStore = new WeakMap();
 const argFieldMetadataStore = new WeakMap();
+const fieldResolverParameterMetadataStore = new WeakMap();
 function cloneResolverMetadata(metadata) {
   return {
     typeName: metadata.typeName
@@ -16,10 +18,17 @@ function cloneHandlerMetadata(metadata) {
     argTypes: metadata.argTypes,
     fieldName: metadata.fieldName,
     inputClass: metadata.inputClass,
+    nullable: metadata.nullable,
     outputType: metadata.outputType,
     type: metadata.type
   };
 }
+function cloneFieldResolverParameterMetadata(metadata) {
+  return {
+    index: metadata.index,
+    kind: metadata.kind
+  };
+}
 function cloneArgFieldMetadata(metadata) {
   return {
     argName: metadata.argName,
@@ -39,6 +48,9 @@ function getStandardHandlerMap(target) {
 function getStandardArgFieldMap(target) {
   return getStandardConstructorMetadataBag(target)?.[standardArgFieldMetadataKey];
 }
+function getStandardFieldResolverParameterMap(target) {
+  return getStandardConstructorMetadataBag(target)?.[standardFieldResolverParameterMetadataKey];
+}
 function getOrCreateHandlerMetadataMap(target) {
   let map = handlerMetadataStore.get(target);
   if (!map) {
@@ -55,6 +67,14 @@ function getOrCreateArgFieldMetadataMap(target) {
   }
   return map;
 }
+function getOrCreateFieldResolverParameterMetadataMap(target) {
+  let map = fieldResolverParameterMetadataStore.get(target);
+  if (!map) {
+    map = new Map();
+    fieldResolverParameterMetadataStore.set(target, map);
+  }
+  return map;
+}
 function getMergedMetadataEntries(target, stored, standard, resolve) {
   const storedMap = stored ?? new Map();
   const standardMap = standard ?? new Map();
@@ -84,10 +104,11 @@ export function defineResolverMetadata(target, metadata) {
 export function getResolverMetadata(target) {
   const stored = resolverMetadataStore.get(target);
   const standard = getStandardResolverMetadata(target);
-  if (!stored && !standard) {
+  const metadata = stored ?? standard;
+  if (!metadata) {
     return undefined;
   }
-  return cloneResolverMetadata(stored ?? standard);
+  return cloneResolverMetadata(metadata);
 }
 
 /**
@@ -111,10 +132,11 @@ export function defineResolverHandlerMetadata(target, propertyKey, metadata) {
 export function getResolverHandlerMetadata(target, propertyKey) {
   const stored = handlerMetadataStore.get(target)?.get(propertyKey);
   const standard = getStandardHandlerMap(target)?.get(propertyKey);
-  if (!stored && !standard) {
+  const metadata = stored ?? standard;
+  if (!metadata) {
     return undefined;
   }
-  return cloneHandlerMetadata(stored ?? standard);
+  return cloneHandlerMetadata(metadata);
 }
 
 /**
@@ -148,10 +170,11 @@ export function defineArgFieldMetadata(target, propertyKey, metadata) {
 export function getArgFieldMetadata(target, propertyKey) {
   const stored = argFieldMetadataStore.get(target)?.get(propertyKey);
   const standard = getStandardArgFieldMap(target)?.get(propertyKey);
-  if (!stored && !standard) {
+  const metadata = stored ?? standard;
+  if (!metadata) {
     return undefined;
   }
-  return cloneArgFieldMetadata(stored ?? standard);
+  return cloneArgFieldMetadata(metadata);
 }
 
 /**
@@ -164,6 +187,40 @@ export function getArgFieldMetadataEntries(target) {
   return getMergedMetadataEntries(target, argFieldMetadataStore.get(target), getStandardArgFieldMap(target), getArgFieldMetadata);
 }
 
+/**
+ * Define one positional parameter binding for an object field resolver.
+ *
+ * @param target Resolver prototype that owns the decorated method.
+ * @param propertyKey Decorated method key.
+ * @param metadata Positional binding metadata to store.
+ */
+export function defineFieldResolverParameterMetadata(target, propertyKey, metadata) {
+  const methods = getOrCreateFieldResolverParameterMetadataMap(target);
+  const bindings = methods.get(propertyKey) ?? new Map();
+  bindings.set(metadata.index, cloneFieldResolverParameterMetadata(metadata));
+  methods.set(propertyKey, bindings);
+}
+
+/**
+ * Get the positional parameter bindings declared for one resolver method.
+ *
+ * @param target Resolver prototype that owns the decorated method.
+ * @param propertyKey Decorated method key.
+ * @returns Parameter bindings ordered by their method parameter index.
+ */
+export function getFieldResolverParameterMetadataEntries(target, propertyKey) {
+  const stored = fieldResolverParameterMetadataStore.get(target)?.get(propertyKey);
+  const standard = getStandardFieldResolverParameterMap(target)?.get(propertyKey);
+  const merged = new Map();
+  for (const [index, metadata] of standard ?? []) {
+    merged.set(index, cloneFieldResolverParameterMetadata(metadata));
+  }
+  for (const [index, metadata] of stored ?? []) {
+    merged.set(index, cloneFieldResolverParameterMetadata(metadata));
+  }
+  return Array.from(merged.values()).sort((left, right) => left.index - right.index);
+}
+
 /**
  * Provides the resolver metadata symbol value.
  */
@@ -175,4 +232,8 @@ export const handlerMetadataSymbol = standardHandlerMetadataKey;
 /**
  * Provides the arg metadata symbol value.
  */
-export const argMetadataSymbol = standardArgFieldMetadataKey;
+export const argMetadataSymbol = standardArgFieldMetadataKey;
+/**
+ * Provides the object field-resolver parameter metadata symbol value.
+ */
+export const fieldResolverParameterMetadataSymbol = standardFieldResolverParameterMetadataKey;

package/dist/module.d.ts

@@ -1,14 +1,6 @@
-import type { Provider } from '@fluojs/di';
+import type { InjectionToken } from '@fluojs/core';
 import { type ModuleType } from '@fluojs/runtime';
-import type { GraphqlModuleOptions } from './types.js';
-/**
- * Creates GraphQL runtime providers for module-level options and lifecycle wiring.
- *
- * @param options GraphQL module options used by the lifecycle service and endpoint controller.
- * @returns Provider definitions that register only the internal options token and GraphQL lifecycle service; this helper
- * does not register `GraphqlEndpointController` or mount the `/graphql` endpoint by itself.
- */
-export declare function createGraphqlProviders(options: GraphqlModuleOptions): Provider[];
+import type { GraphqlAsyncModuleOptions, GraphqlModuleOptions } from './types.js';
 /**
  * Represents the graphql module.
  */
@@ -21,5 +13,17 @@ export declare class GraphqlModule {
      * module path (not `createGraphqlProviders(...)` alone) when the application should expose `/graphql`.
      */
     static forRoot(options?: GraphqlModuleOptions): ModuleType;
+    /**
+     * Registers GraphQL from options resolved by explicitly injected application dependencies.
+     *
+     * The factory runs once in each application context. Only `inject` and `useFactory` are
+     * supported; NestJS-style `imports`, `useClass`, `useExisting`, and implicit discovery are rejected.
+     *
+     * @param options Injected dependency tokens and the factory that resolves GraphQL options.
+     * @returns A module definition that resolves GraphQL configuration before endpoint lifecycle wiring begins.
+     *
+     * @throws {TypeError} When the options shape requests unsupported registration behavior.
+     */
+    static forRootAsync<const TTokens extends readonly InjectionToken[]>(options: GraphqlAsyncModuleOptions<TTokens>): ModuleType;
 }
 //# sourceMappingURL=module.d.ts.map

package/dist/module.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../src/module.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAgB,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAIhE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEvD;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,oBAAoB,GAAG,QAAQ,EAAE,CAQhF;AAED;;GAEG;AACH,qBAAa,aAAa;IACxB;;;;;;OAMG;IACH,MAAM,CAAC,OAAO,CAAC,OAAO,GAAE,oBAAyB,GAAG,UAAU;CAS/D"}
+{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../src/module.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,OAAO,EAAgB,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAKhE,OAAO,KAAK,EAAE,yBAAyB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAiDlF;;GAEG;AACH,qBAAa,aAAa;IACxB;;;;;;OAMG;IACH,MAAM,CAAC,OAAO,CAAC,OAAO,GAAE,oBAAyB,GAAG,UAAU;IAa9D;;;;;;;;;;OAUG;IACH,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,OAAO,SAAS,SAAS,cAAc,EAAE,EACjE,OAAO,EAAE,yBAAyB,CAAC,OAAO,CAAC,GAC1C,UAAU;CA4Bd"}