@buenojs/bueno 0.8.9 → 0.8.11

package/dist/graphql/context-builder.js

@@ -0,0 +1,91 @@
+/**
+ * GraphQL Context Builder
+ *
+ * Builds the GraphQL context from an HTTP Context and enriches
+ * the HTTP context with GraphQL-specific metadata for guards/interceptors.
+ */
+/**
+ * Builds a GraphQL context from an HTTP Context.
+ * Extracts user, request, and exposes the raw httpContext.
+ */
+export function buildGraphQLContext(httpContext) {
+    return {
+        request: httpContext.req,
+        user: httpContext.get("user"),
+        httpContext,
+    };
+}
+/**
+ * Enriches the HTTP context with GraphQL-specific metadata.
+ * This allows guards and interceptors to inspect GraphQL operation details.
+ *
+ * Guards that read context.get('graphql:operation') can make operation-specific decisions.
+ * Guards that read context.get('graphql:type') can differentiate queries vs mutations.
+ *
+ * @example Guard usage:
+ * ```typescript
+ * class MyGuard implements CanActivate {
+ *   canActivate(context: Context): boolean {
+ *     const op = context.get('graphql:type');
+ *     if (op === 'mutation') {
+ *       return !!context.req.headers.get('Authorization');
+ *     }
+ *     return true; // Queries are public
+ *   }
+ * }
+ * ```
+ */
+export function enrichContextForGraphQL(httpContext, operationName, operationType, resolverClass) {
+    httpContext.set("graphql:operation", operationName);
+    httpContext.set("graphql:type", operationType);
+    httpContext.set("graphql:resolverClass", resolverClass);
+}
+/**
+ * Extracts the parsed request body for GraphQL.
+ * Handles both JSON body and GET query string (for playground requests).
+ */
+export async function parseGraphQLRequest(request) {
+    if (request.method === "POST") {
+        try {
+            const body = await request.clone().json();
+            if (typeof body.query !== "string") {
+                return null;
+            }
+            return {
+                query: body.query,
+                variables: typeof body.variables === "object" && body.variables !== null
+                    ? body.variables
+                    : {},
+                operationName: typeof body.operationName === "string"
+                    ? body.operationName
+                    : undefined,
+            };
+        }
+        catch {
+            return null;
+        }
+    }
+    if (request.method === "GET") {
+        const url = new URL(request.url);
+        const query = url.searchParams.get("query");
+        if (!query)
+            return null;
+        const varsStr = url.searchParams.get("variables");
+        let variables = {};
+        if (varsStr) {
+            try {
+                variables = JSON.parse(varsStr);
+            }
+            catch {
+                // ignore parse error
+            }
+        }
+        return {
+            query,
+            variables,
+            operationName: url.searchParams.get("operationName") ?? undefined,
+        };
+    }
+    return null;
+}
+//# sourceMappingURL=context-builder.js.map

package/dist/graphql/context-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-builder.js","sourceRoot":"","sources":["../../src/graphql/context-builder.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,WAAoB;IACvD,OAAO;QACN,OAAO,EAAE,WAAW,CAAC,GAAG;QACxB,IAAI,EAAE,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC;QAC7B,WAAW;KACX,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,uBAAuB,CACtC,WAAoB,EACpB,aAAqB,EACrB,aAAoD,EACpD,aAAkD;IAElD,WAAW,CAAC,GAAG,CAAC,mBAAmB,EAAE,aAAa,CAAC,CAAC;IACpD,WAAW,CAAC,GAAG,CAAC,cAAc,EAAE,aAAa,CAAC,CAAC;IAC/C,WAAW,CAAC,GAAG,CAAC,uBAAuB,EAAE,aAAa,CAAC,CAAC;AACzD,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,OAAgB;IAKzD,IAAI,OAAO,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;QAC/B,IAAI,CAAC;YACJ,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC,IAAI,EAItC,CAAC;YACF,IAAI,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;gBACpC,OAAO,IAAI,CAAC;YACb,CAAC;YACD,OAAO;gBACN,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,SAAS,EACR,OAAO,IAAI,CAAC,SAAS,KAAK,QAAQ,IAAI,IAAI,CAAC,SAAS,KAAK,IAAI;oBAC5D,CAAC,CAAE,IAAI,CAAC,SAAqC;oBAC7C,CAAC,CAAC,EAAE;gBACN,aAAa,EACZ,OAAO,IAAI,CAAC,aAAa,KAAK,QAAQ;oBACrC,CAAC,CAAC,IAAI,CAAC,aAAa;oBACpB,CAAC,CAAC,SAAS;aACb,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACR,OAAO,IAAI,CAAC;QACb,CAAC;IACF,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;QAC9B,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACjC,MAAM,KAAK,GAAG,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC5C,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAC;QACxB,MAAM,OAAO,GAAG,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAClD,IAAI,SAAS,GAA4B,EAAE,CAAC;QAC5C,IAAI,OAAO,EAAE,CAAC;YACb,IAAI,CAAC;gBACJ,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAA4B,CAAC;YAC5D,CAAC;YAAC,MAAM,CAAC;gBACR,qBAAqB;YACtB,CAAC;QACF,CAAC;QACD,OAAO;YACN,KAAK;YACL,SAAS;YACT,aAAa,EAAE,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,eAAe,CAAC,IAAI,SAAS;SACjE,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACb,CAAC"}

package/dist/graphql/decorators.d.ts

@@ -0,0 +1,162 @@
+/**
+ * GraphQL Decorators
+ *
+ * Code-first decorator API for defining GraphQL schemas from TypeScript classes.
+ * Follows the same WeakMap metadata pattern as the OpenAPI module.
+ *
+ * @example
+ * ```typescript
+ * @ObjectType()
+ * class User {
+ *   @Field(() => String)  id: string;
+ *   @Field(() => String)  name: string;
+ * }
+ *
+ * @Resolver()
+ * class UserResolver {
+ *   @Query(() => [User])
+ *   users(): User[] { return []; }
+ * }
+ * ```
+ */
+import type { Constructor, TypeFn, FieldDecoratorOptions, FieldOptions } from "./types";
+/**
+ * Marks a class as a GraphQL resolver.
+ * Dependencies are resolved from the DI container via @Inject.
+ *
+ * @param name - Optional GraphQL type name this resolver is for (e.g. 'User').
+ *               Omit for root-level Query/Mutation/Subscription resolvers.
+ *
+ * @example
+ * ```typescript
+ * @Resolver()
+ * class UserResolver { ... }
+ *
+ * @Resolver('User')
+ * class UserFieldResolver { ... }
+ * ```
+ */
+export declare function Resolver(name?: string): ClassDecorator;
+/**
+ * Marks a class as a GraphQL output type.
+ *
+ * @example
+ * ```typescript
+ * @ObjectType()
+ * class User {
+ *   @Field(() => String) id: string;
+ * }
+ * ```
+ */
+export declare function ObjectType(name?: string, options?: {
+    description?: string;
+}): ClassDecorator;
+/**
+ * Marks a class as a GraphQL input type.
+ *
+ * @example
+ * ```typescript
+ * @InputType()
+ * class CreateUserInput {
+ *   @Field(() => String) name: string;
+ * }
+ * ```
+ */
+export declare function InputType(name?: string, options?: {
+    description?: string;
+}): ClassDecorator;
+/**
+ * Marks a method as a GraphQL Query field.
+ *
+ * @param typeFn - Thunk returning the return type constructor
+ * @param options - Field options (nullable, description, name override)
+ *
+ * @example
+ * ```typescript
+ * @Query(() => [User])
+ * async users(): Promise<User[]> { ... }
+ *
+ * @Query(() => User, { nullable: true })
+ * async user(@Args('id') id: string): Promise<User | null> { ... }
+ * ```
+ */
+export declare function Query(typeFn: TypeFn, options?: FieldOptions): MethodDecorator;
+/**
+ * Marks a method as a GraphQL Mutation field.
+ *
+ * @example
+ * ```typescript
+ * @Mutation(() => User)
+ * async createUser(@Args('input', CreateUserInput) input: CreateUserInput): Promise<User> { ... }
+ * ```
+ */
+export declare function Mutation(typeFn: TypeFn, options?: FieldOptions): MethodDecorator;
+/**
+ * Marks a method as a GraphQL Subscription field.
+ * The method must return an AsyncGenerator.
+ *
+ * Requires an engine with supportsSubscriptions = true (e.g. GraphQLJsAdapter).
+ * Requires subscriptions: true in GraphQLModule.setup().
+ *
+ * @example
+ * ```typescript
+ * @Subscription(() => Message)
+ * async *messageAdded(): AsyncGenerator<Message> {
+ *   yield* pubSub.subscribe('message:added');
+ * }
+ * ```
+ */
+export declare function Subscription(typeFn: TypeFn, options?: FieldOptions): MethodDecorator;
+/**
+ * Marks a property as a GraphQL field.
+ * Used on @ObjectType and @InputType classes.
+ *
+ * @param typeFn - Thunk returning the field type
+ * @param options - Field options
+ *
+ * @example
+ * ```typescript
+ * @ObjectType()
+ * class User {
+ *   @Field(() => String)                    id: string;
+ *   @Field(() => String, { nullable: true }) bio?: string;
+ *   @Field(() => [Post])                    posts: Post[];
+ * }
+ * ```
+ */
+export declare function Field(typeFn: TypeFn, options?: FieldDecoratorOptions): PropertyDecorator;
+/**
+ * Extracts a specific GraphQL argument by name into a method parameter.
+ *
+ * @param name - The argument name as it appears in the GraphQL query
+ * @param inputTypeFn - Optional: type thunk for object input types (validates shape)
+ *
+ * @example
+ * ```typescript
+ * @Query(() => User)
+ * async user(@Args('id') id: string): Promise<User> { ... }
+ *
+ * @Mutation(() => User)
+ * async createUser(@Args('input', CreateUserInput) input: CreateUserInput): Promise<User> { ... }
+ * ```
+ */
+export declare function Args(name: string, inputType?: Constructor): ParameterDecorator;
+/**
+ * Injects the GraphQL context object into a resolver method parameter.
+ *
+ * Named @GqlContext to avoid collision with the HTTP Context class.
+ *
+ * @example
+ * ```typescript
+ * @Mutation(() => Post)
+ * async createPost(
+ *   @Args('title') title: string,
+ *   @GqlContext() ctx: GraphQLContext,
+ * ): Promise<Post> {
+ *   const userId = (ctx.user as User).id;
+ *   ...
+ * }
+ * ```
+ */
+export declare function GqlContext(): ParameterDecorator;
+//# sourceMappingURL=decorators.d.ts.map

package/dist/graphql/decorators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorators.d.ts","sourceRoot":"","sources":["../../src/graphql/decorators.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EACX,WAAW,EACX,MAAM,EACN,qBAAqB,EACrB,YAAY,EACZ,MAAM,SAAS,CAAC;AAmBjB;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,cAAc,CAOtD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CACzB,IAAI,CAAC,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GAChC,cAAc,CAUhB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,CACxB,IAAI,CAAC,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GAChC,cAAc,CAUhB;AAID;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,YAAiB,GAAG,eAAe,CAmBjF;AAED;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,YAAiB,GAAG,eAAe,CAmBpF;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,YAAiB,GAAG,eAAe,CAmBxF;AAID;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,KAAK,CACpB,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,qBAA0B,GACjC,iBAAiB,CAanB;AAID;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,WAAW,GAAG,kBAAkB,CAiB9E;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,UAAU,IAAI,kBAAkB,CAc/C"}

package/dist/graphql/decorators.js

@@ -0,0 +1,291 @@
+/**
+ * GraphQL Decorators
+ *
+ * Code-first decorator API for defining GraphQL schemas from TypeScript classes.
+ * Follows the same WeakMap metadata pattern as the OpenAPI module.
+ *
+ * @example
+ * ```typescript
+ * @ObjectType()
+ * class User {
+ *   @Field(() => String)  id: string;
+ *   @Field(() => String)  name: string;
+ * }
+ *
+ * @Resolver()
+ * class UserResolver {
+ *   @Query(() => [User])
+ *   users(): User[] { return []; }
+ * }
+ * ```
+ */
+import { setResolverMetadata, setObjectTypeMetadata, setInputTypeMetadata, addQueryField, addMutationField, addSubscriptionField, getQueryFields, getMutationFields, getSubscriptionFields, setGqlPropertyMetadata, setParamMetadata, getParamMetadata, } from "./metadata";
+import { registerTypeClass } from "./schema-builder";
+// ============= Class Decorators =============
+/**
+ * Marks a class as a GraphQL resolver.
+ * Dependencies are resolved from the DI container via @Inject.
+ *
+ * @param name - Optional GraphQL type name this resolver is for (e.g. 'User').
+ *               Omit for root-level Query/Mutation/Subscription resolvers.
+ *
+ * @example
+ * ```typescript
+ * @Resolver()
+ * class UserResolver { ... }
+ *
+ * @Resolver('User')
+ * class UserFieldResolver { ... }
+ * ```
+ */
+export function Resolver(name) {
+    return (target) => {
+        const ctor = target;
+        setResolverMetadata(ctor, {
+            name: name ?? ctor.name,
+        });
+    };
+}
+/**
+ * Marks a class as a GraphQL output type.
+ *
+ * @example
+ * ```typescript
+ * @ObjectType()
+ * class User {
+ *   @Field(() => String) id: string;
+ * }
+ * ```
+ */
+export function ObjectType(name, options) {
+    return (target) => {
+        const ctor = target;
+        setObjectTypeMetadata(ctor, {
+            name: name ?? ctor.name,
+            kind: "object",
+            description: options?.description,
+        });
+        registerTypeClass(ctor);
+    };
+}
+/**
+ * Marks a class as a GraphQL input type.
+ *
+ * @example
+ * ```typescript
+ * @InputType()
+ * class CreateUserInput {
+ *   @Field(() => String) name: string;
+ * }
+ * ```
+ */
+export function InputType(name, options) {
+    return (target) => {
+        const ctor = target;
+        setInputTypeMetadata(ctor, {
+            name: name ?? ctor.name,
+            kind: "input",
+            description: options?.description,
+        });
+        registerTypeClass(ctor);
+    };
+}
+// ============= Method Decorators =============
+/**
+ * Marks a method as a GraphQL Query field.
+ *
+ * @param typeFn - Thunk returning the return type constructor
+ * @param options - Field options (nullable, description, name override)
+ *
+ * @example
+ * ```typescript
+ * @Query(() => [User])
+ * async users(): Promise<User[]> { ... }
+ *
+ * @Query(() => User, { nullable: true })
+ * async user(@Args('id') id: string): Promise<User | null> { ... }
+ * ```
+ */
+export function Query(typeFn, options = {}) {
+    return (target, propertyKey, descriptor) => {
+        const methodName = String(propertyKey);
+        addQueryField(target, {
+            methodName,
+            fieldName: options.name ?? methodName,
+            typeFn,
+            kind: "query",
+            nullable: options.nullable ?? false,
+            description: options.description,
+            deprecationReason: options.deprecationReason,
+            paramMetadata: getParamMetadata(target, methodName),
+        });
+        return descriptor;
+    };
+}
+/**
+ * Marks a method as a GraphQL Mutation field.
+ *
+ * @example
+ * ```typescript
+ * @Mutation(() => User)
+ * async createUser(@Args('input', CreateUserInput) input: CreateUserInput): Promise<User> { ... }
+ * ```
+ */
+export function Mutation(typeFn, options = {}) {
+    return (target, propertyKey, descriptor) => {
+        const methodName = String(propertyKey);
+        addMutationField(target, {
+            methodName,
+            fieldName: options.name ?? methodName,
+            typeFn,
+            kind: "mutation",
+            nullable: options.nullable ?? false,
+            description: options.description,
+            deprecationReason: options.deprecationReason,
+            paramMetadata: getParamMetadata(target, methodName),
+        });
+        return descriptor;
+    };
+}
+/**
+ * Marks a method as a GraphQL Subscription field.
+ * The method must return an AsyncGenerator.
+ *
+ * Requires an engine with supportsSubscriptions = true (e.g. GraphQLJsAdapter).
+ * Requires subscriptions: true in GraphQLModule.setup().
+ *
+ * @example
+ * ```typescript
+ * @Subscription(() => Message)
+ * async *messageAdded(): AsyncGenerator<Message> {
+ *   yield* pubSub.subscribe('message:added');
+ * }
+ * ```
+ */
+export function Subscription(typeFn, options = {}) {
+    return (target, propertyKey, descriptor) => {
+        const methodName = String(propertyKey);
+        addSubscriptionField(target, {
+            methodName,
+            fieldName: options.name ?? methodName,
+            typeFn,
+            kind: "subscription",
+            nullable: options.nullable ?? false,
+            description: options.description,
+            deprecationReason: options.deprecationReason,
+            paramMetadata: getParamMetadata(target, methodName),
+        });
+        return descriptor;
+    };
+}
+// ============= Property Decorator =============
+/**
+ * Marks a property as a GraphQL field.
+ * Used on @ObjectType and @InputType classes.
+ *
+ * @param typeFn - Thunk returning the field type
+ * @param options - Field options
+ *
+ * @example
+ * ```typescript
+ * @ObjectType()
+ * class User {
+ *   @Field(() => String)                    id: string;
+ *   @Field(() => String, { nullable: true }) bio?: string;
+ *   @Field(() => [Post])                    posts: Post[];
+ * }
+ * ```
+ */
+export function Field(typeFn, options = {}) {
+    return (target, propertyKey) => {
+        const key = typeof propertyKey === "symbol" ? propertyKey.toString() : propertyKey;
+        setGqlPropertyMetadata(target, propertyKey, {
+            propertyKey: key,
+            typeFn,
+            nullable: options.nullable ?? false,
+            description: options.description,
+            deprecationReason: options.deprecationReason,
+            defaultValue: options.defaultValue,
+        });
+    };
+}
+// ============= Parameter Decorators =============
+/**
+ * Extracts a specific GraphQL argument by name into a method parameter.
+ *
+ * @param name - The argument name as it appears in the GraphQL query
+ * @param inputTypeFn - Optional: type thunk for object input types (validates shape)
+ *
+ * @example
+ * ```typescript
+ * @Query(() => User)
+ * async user(@Args('id') id: string): Promise<User> { ... }
+ *
+ * @Mutation(() => User)
+ * async createUser(@Args('input', CreateUserInput) input: CreateUserInput): Promise<User> { ... }
+ * ```
+ */
+export function Args(name, inputType) {
+    return (target, propertyKey, parameterIndex) => {
+        if (!propertyKey)
+            return;
+        const methodName = String(propertyKey);
+        setParamMetadata(target, methodName, parameterIndex, {
+            index: parameterIndex,
+            kind: inputType ? "argsObject" : "args",
+            argName: name,
+            inputTypeFn: inputType ? () => inputType : undefined,
+        });
+        // Re-sync param metadata into existing resolver field metadata
+        syncParamMetadata(target, methodName);
+    };
+}
+/**
+ * Injects the GraphQL context object into a resolver method parameter.
+ *
+ * Named @GqlContext to avoid collision with the HTTP Context class.
+ *
+ * @example
+ * ```typescript
+ * @Mutation(() => Post)
+ * async createPost(
+ *   @Args('title') title: string,
+ *   @GqlContext() ctx: GraphQLContext,
+ * ): Promise<Post> {
+ *   const userId = (ctx.user as User).id;
+ *   ...
+ * }
+ * ```
+ */
+export function GqlContext() {
+    return (target, propertyKey, parameterIndex) => {
+        if (!propertyKey)
+            return;
+        const methodName = String(propertyKey);
+        setParamMetadata(target, methodName, parameterIndex, {
+            index: parameterIndex,
+            kind: "context",
+        });
+        syncParamMetadata(target, methodName);
+    };
+}
+// ============= Internal Helper =============
+/**
+ * Re-syncs param metadata into already-registered resolver field entries.
+ * Decorators are applied bottom-up in TypeScript, so @Args/@GqlContext may run
+ * before @Query/@Mutation. This helper updates the field entry with the latest
+ * param metadata after each parameter decorator runs.
+ */
+function syncParamMetadata(prototype, methodName) {
+    const params = getParamMetadata(prototype, methodName);
+    const syncFields = (fields, addFn) => {
+        const field = fields.find((f) => f.methodName === methodName);
+        if (field) {
+            addFn(prototype, { ...field, paramMetadata: params });
+        }
+    };
+    syncFields(getQueryFields(prototype), addQueryField);
+    syncFields(getMutationFields(prototype), addMutationField);
+    syncFields(getSubscriptionFields(prototype), addSubscriptionField);
+}
+//# sourceMappingURL=decorators.js.map

package/dist/graphql/decorators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorators.js","sourceRoot":"","sources":["../../src/graphql/decorators.ts"],"names":[],"mappings":"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"}

package/dist/graphql/execution-pipeline.d.ts

@@ -0,0 +1,67 @@
+/**
+ * GraphQL Execution Pipeline
+ *
+ * Applies the same guard/interceptor pipeline used for HTTP controllers
+ * to GraphQL resolver methods.
+ *
+ * Guards and interceptors receive the real HTTP Context, enriched with
+ * GraphQL-specific metadata:
+ * - context.get('graphql:operation') → resolver field name (e.g. 'users')
+ * - context.get('graphql:type')      → 'query' | 'mutation' | 'subscription'
+ * - context.get('graphql:resolver')  → resolver class constructor
+ *
+ * ## Guard Compatibility
+ * - ✅ Auth guards reading Authorization/Cookie headers
+ * - ✅ API key guards
+ * - ✅ Custom guards reading any header/cookie
+ * - ⚠️  Route-based guards (reading context.path) — see /graphql for all ops
+ * - ⚠️  CSRF guards (may block all POSTs) — need graphql-aware adaptation
+ */
+import type { Context } from "../context";
+import type { Container } from "../container";
+import type { Guard } from "../modules/guards";
+import type { Interceptor } from "../modules/interceptors";
+import type { GraphQLContext, ResolvedField, GraphQLError } from "./types";
+export type { Guard, Interceptor };
+export interface ResolverPipelineOptions {
+    /** The resolver class constructor (for reading class-level guard metadata) */
+    resolverClass: new (...args: unknown[]) => unknown;
+    /** Field name (for reading method-level guard metadata) */
+    fieldName: string;
+    /** The resolved field descriptor */
+    resolvedField: ResolvedField;
+    /** GraphQL arguments extracted from the query */
+    args: Record<string, unknown>;
+    /** Built GraphQL context */
+    graphqlContext: GraphQLContext;
+    /** HTTP Context from the current request */
+    httpContext: Context;
+    /** DI container for resolving guard/interceptor instances */
+    container: Container;
+    /** Global guards from app.getGlobalGuards() */
+    globalGuards: Guard[];
+    /** Global interceptors from app.getGlobalInterceptors() */
+    globalInterceptors: Interceptor[];
+    /** Operation type for enriching context */
+    operationType: "query" | "mutation" | "subscription";
+}
+/**
+ * Execute a resolver method through the full guard → interceptor pipeline.
+ *
+ * Returns the resolver method's return value, or throws if a guard blocks.
+ * GraphQL errors should be caught by the caller and placed into the errors array.
+ */
+export declare function executeResolverWithPipeline(options: ResolverPipelineOptions): Promise<unknown>;
+/**
+ * Calls the actual resolver method with the correct argument list.
+ * Resolves @Args and @GqlContext parameters at their declared positions.
+ */
+export declare function callResolver(field: ResolvedField, args: Record<string, unknown>, gqlContext: GraphQLContext): Promise<unknown>;
+export declare class GraphQLForbiddenError extends Error {
+    readonly extensions: {
+        code: string;
+    };
+    constructor(message?: string);
+    toGraphQLError(): GraphQLError;
+}
+//# sourceMappingURL=execution-pipeline.d.ts.map

package/dist/graphql/execution-pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-pipeline.d.ts","sourceRoot":"","sources":["../../src/graphql/execution-pipeline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,KAAK,EAAE,SAAS,EAAS,MAAM,cAAc,CAAC;AACrD,OAAO,KAAK,EAAE,KAAK,EAAwB,MAAM,mBAAmB,CAAC;AACrE,OAAO,KAAK,EAAE,WAAW,EAAkC,MAAM,yBAAyB,CAAC;AAC3F,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAe3E,YAAY,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC;AAInC,MAAM,WAAW,uBAAuB;IACvC,8EAA8E;IAC9E,aAAa,EAAE,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC;IACnD,2DAA2D;IAC3D,SAAS,EAAE,MAAM,CAAC;IAClB,oCAAoC;IACpC,aAAa,EAAE,aAAa,CAAC;IAC7B,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,4BAA4B;IAC5B,cAAc,EAAE,cAAc,CAAC;IAC/B,4CAA4C;IAC5C,WAAW,EAAE,OAAO,CAAC;IACrB,6DAA6D;IAC7D,SAAS,EAAE,SAAS,CAAC;IACrB,+CAA+C;IAC/C,YAAY,EAAE,KAAK,EAAE,CAAC;IACtB,2DAA2D;IAC3D,kBAAkB,EAAE,WAAW,EAAE,CAAC;IAClC,2CAA2C;IAC3C,aAAa,EAAE,OAAO,GAAG,UAAU,GAAG,cAAc,CAAC;CACrD;AAID;;;;;GAKG;AACH,wBAAsB,2BAA2B,CAChD,OAAO,EAAE,uBAAuB,GAC9B,OAAO,CAAC,OAAO,CAAC,CAwFlB;AAID;;;GAGG;AACH,wBAAsB,YAAY,CACjC,KAAK,EAAE,aAAa,EACpB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,UAAU,EAAE,cAAc,GACxB,OAAO,CAAC,OAAO,CAAC,CAQlB;AA4BD,qBAAa,qBAAsB,SAAQ,KAAK;IAC/C,QAAQ,CAAC,UAAU;;MAAyB;gBAEhC,OAAO,SAAc;IAKjC,cAAc,IAAI,YAAY;CAM9B"}