@buenojs/bueno 0.8.9 → 0.8.11

package/dist/graphql/execution-pipeline.js

@@ -0,0 +1,127 @@
+/**
+ * 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 { executeGuards, getClassGuards, getMethodGuards, } from "../modules/guards";
+import { executeInterceptors, getClassInterceptors, getMethodInterceptors, isNestInterceptor, isInterceptorFn, } from "../modules/interceptors";
+import { enrichContextForGraphQL } from "./context-builder";
+// ============= Pipeline Executor =============
+/**
+ * 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 async function executeResolverWithPipeline(options) {
+    const { resolverClass, fieldName, resolvedField, args, graphqlContext, httpContext, container, globalGuards, globalInterceptors, operationType, } = options;
+    // Enrich HTTP context with GraphQL metadata for guard inspection
+    enrichContextForGraphQL(httpContext, fieldName, operationType, resolverClass);
+    // Read class-level and method-level guards/interceptors
+    const classGuards = getClassGuards(resolverClass) ?? [];
+    const methodGuards = getMethodGuards(resolverClass.prototype, fieldName) ?? [];
+    const classInterceptors = getClassInterceptors(resolverClass) ?? [];
+    const methodInterceptors = getMethodInterceptors(resolverClass.prototype, fieldName) ?? [];
+    // Guard resolver helper
+    const resolveGuard = (guard) => {
+        if (typeof guard === "object" &&
+            guard !== null &&
+            !("canActivate" in guard)) {
+            try {
+                return container.resolve(guard);
+            }
+            catch {
+                return null;
+            }
+        }
+        return null;
+    };
+    // Interceptor resolver helper
+    const resolveInterceptor = (interceptor) => {
+        if (!isNestInterceptor(interceptor) && !isInterceptorFn(interceptor)) {
+            try {
+                return container.resolve(interceptor);
+            }
+            catch {
+                return null;
+            }
+        }
+        return null;
+    };
+    // Step 1: Execute guards
+    const guardsPassed = await executeGuards(httpContext, {
+        globalGuards,
+        classGuards,
+        methodGuards,
+        resolveGuard,
+    });
+    if (!guardsPassed) {
+        throw new GraphQLForbiddenError(`Access denied to field '${fieldName}'`);
+    }
+    // Step 2: Execute interceptors wrapping the resolver call
+    return executeInterceptors(httpContext, async () => {
+        return callResolver(resolvedField, args, graphqlContext);
+    }, {
+        globalInterceptors,
+        classInterceptors,
+        methodInterceptors,
+        resolveInterceptor,
+    });
+}
+// ============= Resolver Caller =============
+/**
+ * Calls the actual resolver method with the correct argument list.
+ * Resolves @Args and @GqlContext parameters at their declared positions.
+ */
+export async function callResolver(field, args, gqlContext) {
+    const instance = field.resolverInstance;
+    const methodArgs = buildMethodArgs(field, args, gqlContext);
+    const result = instance[field.methodName](...methodArgs);
+    return result instanceof Promise ? await result : result;
+}
+function buildMethodArgs(field, args, gqlContext) {
+    const methodArgs = [];
+    for (const param of field.paramMetadata) {
+        switch (param.kind) {
+            case "context":
+                methodArgs[param.index] = gqlContext;
+                break;
+            case "args":
+                methodArgs[param.index] = param.argName ? args[param.argName] : args;
+                break;
+            case "argsObject":
+                methodArgs[param.index] = param.argName ? args[param.argName] : args;
+                break;
+        }
+    }
+    return methodArgs;
+}
+// ============= Custom Error =============
+export class GraphQLForbiddenError extends Error {
+    extensions = { code: "FORBIDDEN" };
+    constructor(message = "Forbidden") {
+        super(message);
+        this.name = "GraphQLForbiddenError";
+    }
+    toGraphQLError() {
+        return {
+            message: this.message,
+            extensions: this.extensions,
+        };
+    }
+}
+//# sourceMappingURL=execution-pipeline.js.map

package/dist/graphql/execution-pipeline.js.map

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

package/dist/graphql/graphql-module.d.ts

@@ -0,0 +1,70 @@
+/**
+ * GraphQL Module
+ *
+ * Static factory class for setting up GraphQL support in a Bueno application.
+ *
+ * ## Quick Start
+ *
+ * ```typescript
+ * import { createApp } from '@buenojs/bueno';
+ * import { GraphQLModule } from '@buenojs/bueno/graphql';
+ *
+ * const app = createApp(AppModule);
+ *
+ * GraphQLModule.setup(app, {
+ *   resolvers: [UserResolver, PostResolver],
+ *   playground: true,
+ *   subscriptions: true,
+ * });
+ *
+ * await app.listen(3000);
+ * ```
+ *
+ * ## Resolver Dependencies
+ * Resolvers are instantiated after app.init() via deferred initialization.
+ * Dependencies registered in @Module({ providers }) are available automatically.
+ *
+ * ## Guard/Interceptor Compatibility
+ * Guards and interceptors receive the HTTP Context enriched with GraphQL metadata:
+ * - context.get('graphql:operation') → field name being resolved
+ * - context.get('graphql:type')      → 'query' | 'mutation' | 'subscription'
+ * Works with: auth guards, API key guards, logging interceptors.
+ * May need adaptation: CSRF guards (all GraphQL = POST), route-based guards.
+ */
+import type { Application } from "../modules";
+import type { GraphQLModuleOptions } from "./types";
+import type { ResolvedSchema } from "./types";
+export declare class GraphQLModuleInstance {
+    readonly sdl: string;
+    readonly resolvedSchema: ResolvedSchema;
+    readonly path: string;
+    constructor(sdl: string, resolvedSchema: ResolvedSchema, path: string);
+}
+export declare class GraphQLModule {
+    /**
+     * Set up the GraphQL module on a Bueno application.
+     *
+     * Registers:
+     * - POST <path>    — GraphQL query/mutation endpoint
+     * - GET  <path>    — GraphiQL playground (if enabled)
+     * - GET  <path>/schema — SDL endpoint (if introspection enabled)
+     *
+     * @param app - The Bueno Application instance
+     * @param options - GraphQL configuration
+     * @returns GraphQLModuleInstance (access .sdl after first request)
+     */
+    static setup(app: Application, options: GraphQLModuleOptions): GraphQLModuleInstance;
+    /**
+     * Executes a GraphQL request by:
+     * 1. Parsing with the engine
+     * 2. Running guards/interceptors per top-level field
+     * 3. Passing execution back to the engine for sub-selection resolution
+     *
+     * For the built-in engine this is simple since it handles everything.
+     * For external engines, we run guards/interceptors on the top-level
+     * operation fields, then delegate full execution to the engine.
+     */
+    private static executeWithPipeline;
+    private static fieldToApiProperty;
+}
+//# sourceMappingURL=graphql-module.d.ts.map

package/dist/graphql/graphql-module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graphql-module.d.ts","sourceRoot":"","sources":["../../src/graphql/graphql-module.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,OAAO,KAAK,EAAE,oBAAoB,EAAiB,MAAM,SAAS,CAAC;AAWnE,OAAO,KAAK,EAAiB,cAAc,EAAwB,MAAM,SAAS,CAAC;AAgCnF,qBAAa,qBAAqB;IAEhC,QAAQ,CAAC,GAAG,EAAE,MAAM;IACpB,QAAQ,CAAC,cAAc,EAAE,cAAc;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM;gBAFZ,GAAG,EAAE,MAAM,EACX,cAAc,EAAE,cAAc,EAC9B,IAAI,EAAE,MAAM;CAEtB;AA6FD,qBAAa,aAAa;IACzB;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,KAAK,CACX,GAAG,EAAE,WAAW,EAChB,OAAO,EAAE,oBAAoB,GAC3B,qBAAqB;IAmJxB;;;;;;;;;OASG;mBACkB,mBAAmB;IA+DxC,OAAO,CAAC,MAAM,CAAC,kBAAkB;CAoCjC"}

package/dist/graphql/graphql-module.js

@@ -0,0 +1,442 @@
+/**
+ * GraphQL Module
+ *
+ * Static factory class for setting up GraphQL support in a Bueno application.
+ *
+ * ## Quick Start
+ *
+ * ```typescript
+ * import { createApp } from '@buenojs/bueno';
+ * import { GraphQLModule } from '@buenojs/bueno/graphql';
+ *
+ * const app = createApp(AppModule);
+ *
+ * GraphQLModule.setup(app, {
+ *   resolvers: [UserResolver, PostResolver],
+ *   playground: true,
+ *   subscriptions: true,
+ * });
+ *
+ * await app.listen(3000);
+ * ```
+ *
+ * ## Resolver Dependencies
+ * Resolvers are instantiated after app.init() via deferred initialization.
+ * Dependencies registered in @Module({ providers }) are available automatically.
+ *
+ * ## Guard/Interceptor Compatibility
+ * Guards and interceptors receive the HTTP Context enriched with GraphQL metadata:
+ * - context.get('graphql:operation') → field name being resolved
+ * - context.get('graphql:type')      → 'query' | 'mutation' | 'subscription'
+ * Works with: auth guards, API key guards, logging interceptors.
+ * May need adaptation: CSRF guards (all GraphQL = POST), route-based guards.
+ */
+import { getInjectTokens, resolveForwardRef, } from "../container";
+import { SchemaBuilder, getRegisteredTypeClasses } from "./schema-builder";
+import { BuiltinGraphQLEngine } from "./built-in-engine";
+import { SubscriptionHandler } from "./subscription-handler";
+import { buildGraphQLContext, parseGraphQLRequest } from "./context-builder";
+// ============= Playground HTML =============
+function generatePlaygroundHTML(path) {
+    return `<!DOCTYPE html>
+<html>
+<head>
+  <meta charset="utf-8" />
+  <title>GraphQL Playground</title>
+  <meta name="viewport" content="width=device-width, initial-scale=1" />
+  <link rel="stylesheet" href="https://unpkg.com/graphiql@3/graphiql.min.css" />
+  <style>body { margin: 0; }</style>
+</head>
+<body>
+  <div id="graphiql" style="height:100vh;"></div>
+  <script crossorigin src="https://unpkg.com/react@18/umd/react.production.min.js"></script>
+  <script crossorigin src="https://unpkg.com/react-dom@18/umd/react-dom.production.min.js"></script>
+  <script crossorigin src="https://unpkg.com/graphiql@3/graphiql.min.js"></script>
+  <script>
+    const root = ReactDOM.createRoot(document.getElementById('graphiql'));
+    root.render(React.createElement(GraphiQL, {
+      fetcher: GraphiQL.createFetcher({ url: '${path}' }),
+    }));
+  </script>
+</body>
+</html>`;
+}
+// ============= GraphQL Module Instance =============
+export class GraphQLModuleInstance {
+    sdl;
+    resolvedSchema;
+    path;
+    constructor(sdl, resolvedSchema, path) {
+        this.sdl = sdl;
+        this.resolvedSchema = resolvedSchema;
+        this.path = path;
+    }
+}
+// ============= Deferred Initializer =============
+/**
+ * Handles deferred resolver initialization.
+ * Resolvers can only be instantiated after app.init() completes
+ * (all DI providers must be registered and resolved first).
+ *
+ * The route handler calls ensureInitialized() on first request,
+ * which is always after app.init() has completed.
+ */
+class DeferredInitializer {
+    resolverClasses;
+    app;
+    engine;
+    initialized = false;
+    initPromise = null;
+    initError = null;
+    resolverInstances = new Map();
+    resolverFields = null;
+    resolvedSchema = null;
+    sdl = "";
+    engineSchema = null;
+    constructor(resolverClasses, app, engine) {
+        this.resolverClasses = resolverClasses;
+        this.app = app;
+        this.engine = engine;
+    }
+    async ensureInitialized() {
+        if (this.initialized) {
+            if (this.initError)
+                throw this.initError;
+            return;
+        }
+        if (this.initPromise) {
+            await this.initPromise;
+            if (this.initError)
+                throw this.initError;
+            return;
+        }
+        this.initPromise = this.initialize();
+        await this.initPromise;
+        if (this.initError)
+            throw this.initError;
+    }
+    async initialize() {
+        try {
+            // Instantiate resolvers via DI (same pattern as registerController)
+            for (const ResolverClass of this.resolverClasses) {
+                if (this.resolverInstances.has(ResolverClass))
+                    continue;
+                // Register in container if not already present
+                const token = ResolverClass;
+                if (!this.app.container.has(token)) {
+                    this.app.container.register({
+                        token,
+                        useClass: ResolverClass,
+                    });
+                }
+                // Resolve inject tokens from @Inject decorators
+                const injectTokens = getInjectTokens(ResolverClass, "inject:tokens") ?? [];
+                const deps = injectTokens.map((t) => {
+                    const resolved = resolveForwardRef(t);
+                    return this.app.container.resolve(resolved);
+                });
+                const instance = new ResolverClass(...deps);
+                this.resolverInstances.set(ResolverClass, instance);
+            }
+            // Build schema
+            const builder = new SchemaBuilder(this.resolverClasses, this.resolverInstances);
+            const { sdl, resolvedSchema, resolverFields, typeFields } = builder.build();
+            this.sdl = sdl;
+            this.resolvedSchema = resolvedSchema;
+            this.resolverFields = resolverFields;
+            this.engineSchema = this.engine.buildSchema(resolverFields, typeFields, sdl);
+            this.initialized = true;
+        }
+        catch (err) {
+            this.initError = err instanceof Error ? err : new Error(String(err));
+            throw this.initError;
+        }
+    }
+}
+// ============= GraphQL Module =============
+export class GraphQLModule {
+    /**
+     * Set up the GraphQL module on a Bueno application.
+     *
+     * Registers:
+     * - POST <path>    — GraphQL query/mutation endpoint
+     * - GET  <path>    — GraphiQL playground (if enabled)
+     * - GET  <path>/schema — SDL endpoint (if introspection enabled)
+     *
+     * @param app - The Bueno Application instance
+     * @param options - GraphQL configuration
+     * @returns GraphQLModuleInstance (access .sdl after first request)
+     */
+    static setup(app, options) {
+        const engine = options.engine ?? new BuiltinGraphQLEngine();
+        const path = options.path ?? "/graphql";
+        const introspection = options.introspection !== false;
+        // Determine playground: only auto-enable with engines that support introspection
+        const playgroundEnabled = options.playground !== undefined
+            ? options.playground
+            : engine.supportsIntrospection;
+        if (options.playground === true && !engine.supportsIntrospection) {
+            console.warn("[GraphQL] Playground enabled but the built-in engine does not support " +
+                "introspection. GraphiQL will not work correctly. " +
+                "Use GraphQLJsAdapter for full playground support.");
+        }
+        // Deferred initializer (resolvers instantiated after app.init())
+        const initializer = new DeferredInitializer(options.resolvers, app, engine);
+        // ── POST <path> — Query / Mutation handler ──
+        app.router.post(path, async (httpContext) => {
+            // Parse request body
+            const parsed = await parseGraphQLRequest(httpContext.req);
+            if (!parsed) {
+                return httpContext.json({
+                    errors: [{ message: "Invalid GraphQL request: expected JSON body with 'query' field" }],
+                }, { status: 400 });
+            }
+            // Lazy initialize resolvers (only on first request, after app.init())
+            try {
+                await initializer.ensureInitialized();
+            }
+            catch (err) {
+                return httpContext.json({
+                    errors: [{ message: `GraphQL initialization failed: ${err.message}` }],
+                });
+            }
+            const gqlContext = buildGraphQLContext(httpContext);
+            const schema = initializer.engineSchema;
+            const fields = initializer.resolverFields;
+            // Determine operation type from query string
+            const trimmed = parsed.query.trim();
+            const isMutation = trimmed.startsWith("mutation");
+            const operationType = isMutation ? "mutation" : "query";
+            const operationFields = isMutation ? fields.mutations : fields.queries;
+            // Execute with engine (which calls resolvers via execution pipeline)
+            // We wrap the engine execution to run guards/interceptors per field
+            let result;
+            try {
+                result = await GraphQLModule.executeWithPipeline(engine, schema, parsed, gqlContext, httpContext, operationFields, operationType, isMutation ? "mutation" : "query", options, app);
+            }
+            catch (err) {
+                result = {
+                    errors: [{ message: err.message }],
+                };
+            }
+            return httpContext.json(result);
+        });
+        // ── GET <path>/schema — SDL endpoint ──
+        if (introspection) {
+            app.router.get(`${path}/schema`, async (httpContext) => {
+                await initializer.ensureInitialized().catch(() => { });
+                return httpContext.text(initializer.sdl || "# Schema not yet initialized");
+            });
+        }
+        // ── GET <path> — Playground ──
+        if (playgroundEnabled) {
+            app.router.get(path, (httpContext) => {
+                return httpContext.html(generatePlaygroundHTML(path));
+            });
+        }
+        // ── Subscriptions ──
+        if (options.subscriptions) {
+            if (!engine.supportsSubscriptions) {
+                console.warn("[GraphQL] subscriptions: true but the configured engine does not support " +
+                    "subscriptions. Use GraphQLJsAdapter for subscription support.");
+            }
+            else {
+                const subHandler = new SubscriptionHandler(engine, null, // engineSchema set after init
+                path, app.container, app.getGlobalGuards(), app.getGlobalInterceptors());
+                app.setWebSocketHandler(subHandler.getWebSocketConfig());
+            }
+        }
+        // ── Optional OpenAPI sync ──
+        if (options.syncOpenAPI) {
+            // Deferred: runs after first initialization when type classes are known
+            queueMicrotask(async () => {
+                try {
+                    await initializer.ensureInitialized().catch(() => { });
+                    const typeClasses = getRegisteredTypeClasses();
+                    const { setApiPropertyMetadata } = await import("../openapi/metadata");
+                    const { getGqlPropertyKeys, getGqlPropertyMetadata } = await import("./metadata");
+                    for (const TypeClass of typeClasses) {
+                        const keys = getGqlPropertyKeys(TypeClass.prototype);
+                        for (const key of keys) {
+                            const fieldMeta = getGqlPropertyMetadata(TypeClass.prototype, key);
+                            if (!fieldMeta)
+                                continue;
+                            const apiOptions = GraphQLModule.fieldToApiProperty(fieldMeta);
+                            setApiPropertyMetadata(TypeClass.prototype, key, apiOptions);
+                        }
+                    }
+                }
+                catch {
+                    console.warn("[GraphQL] syncOpenAPI: failed to sync field metadata to OpenAPI store. " +
+                        "Ensure @buenojs/bueno/openapi is available.");
+                }
+            });
+        }
+        return new GraphQLModuleInstance("", {}, path);
+    }
+    // ============= Per-field pipeline execution ============
+    /**
+     * Executes a GraphQL request by:
+     * 1. Parsing with the engine
+     * 2. Running guards/interceptors per top-level field
+     * 3. Passing execution back to the engine for sub-selection resolution
+     *
+     * For the built-in engine this is simple since it handles everything.
+     * For external engines, we run guards/interceptors on the top-level
+     * operation fields, then delegate full execution to the engine.
+     */
+    static async executeWithPipeline(engine, schema, parsed, gqlContext, httpContext, operationFields, operationType, _opTypeStr, options, app) {
+        // Run guards for each top-level operation field in the query
+        // We do a lightweight parse to find top-level field names
+        const topLevelFields = extractTopLevelFields(parsed.query);
+        for (const fieldName of topLevelFields) {
+            const resolvedField = operationFields.get(fieldName);
+            if (!resolvedField)
+                continue;
+            // Find which resolver class owns this field
+            const resolverClass = findResolverClass(options.resolvers, fieldName, operationType);
+            if (!resolverClass)
+                continue;
+            // Run guards and interceptors
+            const guardsPassed = await runGuardsForField(resolverClass, fieldName, httpContext, gqlContext, operationType, app);
+            if (!guardsPassed) {
+                return {
+                    errors: [
+                        {
+                            message: `Access denied to field '${fieldName}'`,
+                            path: [fieldName],
+                            extensions: { code: "FORBIDDEN" },
+                        },
+                    ],
+                };
+            }
+        }
+        // Execute with engine (handles the actual resolver calls for built-in engine,
+        // or full SDL schema execution for external engines)
+        return engine.execute(schema, parsed.query, parsed.variables, gqlContext, parsed.operationName);
+    }
+    // ============= OpenAPI sync helper ============
+    static fieldToApiProperty(fieldMeta) {
+        const type = fieldMeta.typeFn();
+        const isArray = Array.isArray(type);
+        const inner = isArray ? type[0] : type;
+        let apiType;
+        if (inner === String)
+            apiType = "string";
+        else if (inner === Number)
+            apiType = "number";
+        else if (inner === Boolean)
+            apiType = "boolean";
+        else if (inner.name === "GraphQLID")
+            apiType = "string";
+        else if (inner.name === "GraphQLInt")
+            apiType = "integer";
+        else if (inner.name === "GraphQLFloat")
+            apiType = "number";
+        else
+            apiType = inner; // class reference — OpenAPI SchemaGenerator will handle
+        const options = {
+            required: !fieldMeta.nullable,
+        };
+        if (isArray) {
+            options.type = "array";
+            options.items =
+                typeof apiType === "string"
+                    ? { type: apiType }
+                    : { $ref: `#/components/schemas/${inner.name}` };
+        }
+        else {
+            options.type = apiType;
+        }
+        if (fieldMeta.description) {
+            options.description = fieldMeta.description;
+        }
+        return options;
+    }
+}
+// ============= Helpers ============
+/** Quick regex-based top-level field name extractor — avoids full parse overhead */
+function extractTopLevelFields(query) {
+    // Strip operation keyword + optional name + optional variables
+    const stripped = query
+        .trim()
+        .replace(/^(query|mutation)\s*\w*\s*(\([^)]*\))?\s*/, "");
+    // Extract the outermost { ... } and find immediate field names
+    const match = stripped.match(/^\{([\s\S]*)\}$/);
+    if (!match)
+        return [];
+    const body = match[1];
+    const fields = [];
+    // Simple state machine — extract names at depth 0
+    let depth = 0;
+    let nameStart = -1;
+    for (let i = 0; i < body.length; i++) {
+        const ch = body[i];
+        if (ch === "{") {
+            depth++;
+        }
+        else if (ch === "}") {
+            depth--;
+        }
+        else if (depth === 0 && /[A-Za-z_]/.test(ch) && nameStart < 0) {
+            nameStart = i;
+        }
+        else if (depth === 0 && nameStart >= 0 && !/[\w]/.test(ch)) {
+            const name = body.slice(nameStart, i);
+            // Skip alias separator
+            if (body[i] === ":") {
+                // This was an alias — next identifier is the real name
+                nameStart = -1;
+                continue;
+            }
+            if (name !== "on")
+                fields.push(name);
+            nameStart = -1;
+        }
+    }
+    if (nameStart >= 0) {
+        fields.push(body.slice(nameStart));
+    }
+    return [...new Set(fields)]; // deduplicate
+}
+import { getQueryFields, getMutationFields, } from "./metadata";
+function findResolverClass(resolverClasses, fieldName, operationType) {
+    for (const ResolverClass of resolverClasses) {
+        const fields = operationType === "mutation"
+            ? getMutationFields(ResolverClass.prototype)
+            : getQueryFields(ResolverClass.prototype);
+        if (fields.some((f) => f.fieldName === fieldName)) {
+            return ResolverClass;
+        }
+    }
+    return undefined;
+}
+async function runGuardsForField(resolverClass, fieldName, httpContext, gqlContext, operationType, app) {
+    const { executeGuards, getClassGuards, getMethodGuards } = await import("../modules/guards");
+    const { resolveForwardRef } = await import("../container");
+    const classGuards = getClassGuards(resolverClass) ?? [];
+    const methodGuards = getMethodGuards(resolverClass.prototype, fieldName) ?? [];
+    const globalGuards = app.getGlobalGuards();
+    // Enrich context
+    const { enrichContextForGraphQL } = await import("./context-builder");
+    enrichContextForGraphQL(httpContext, fieldName, operationType, resolverClass);
+    return executeGuards(httpContext, {
+        globalGuards,
+        classGuards,
+        methodGuards,
+        resolveGuard: (guard) => {
+            if (typeof guard === "object" &&
+                guard !== null &&
+                !("canActivate" in guard)) {
+                try {
+                    return app.container.resolve(guard);
+                }
+                catch {
+                    return null;
+                }
+            }
+            return null;
+        },
+    });
+}
+//# sourceMappingURL=graphql-module.js.map

package/dist/graphql/graphql-module.js.map

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