@leaven-graphql/nestjs 0.1.0

package/dist/decorators.d.ts

@@ -0,0 +1,205 @@
+/**
+ * @leaven-graphql/nestjs - Decorators
+ *
+ * Copyright 2026 Pegasus Heavy Industries LLC
+ * Licensed under the Apache License, Version 2.0
+ */
+/**
+ * Metadata key for resolver complexity
+ */
+export declare const COMPLEXITY_KEY = "leaven:complexity";
+/**
+ * Metadata key for field deprecation
+ */
+export declare const DEPRECATED_KEY = "leaven:deprecated";
+/**
+ * Metadata key for field description
+ */
+export declare const DESCRIPTION_KEY = "leaven:description";
+/**
+ * Metadata key for caching
+ */
+export declare const CACHE_KEY = "leaven:cache";
+/**
+ * Metadata key for subscription filter
+ */
+export declare const SUBSCRIPTION_FILTER_KEY = "leaven:subscription:filter";
+/**
+ * Inject the GraphQL context
+ *
+ * @example
+ * ```typescript
+ * @Query(() => User)
+ * async me(@Context() ctx: GqlContext) {
+ *   return ctx.req.user;
+ * }
+ * ```
+ */
+export declare const Context: (...dataOrPipes: (string | import("@nestjs/common").PipeTransform<any, any> | import("@nestjs/common").Type<import("@nestjs/common").PipeTransform<any, any>>)[]) => ParameterDecorator;
+/**
+ * Inject the GraphQL info object
+ *
+ * @example
+ * ```typescript
+ * @Query(() => [Post])
+ * async posts(@Info() info: GraphQLResolveInfo) {
+ *   // Access field selection, etc.
+ * }
+ * ```
+ */
+export declare const Info: (...dataOrPipes: unknown[]) => ParameterDecorator;
+/**
+ * Inject the root/parent value
+ *
+ * @example
+ * ```typescript
+ * @ResolveField(() => String)
+ * async fullName(@Root() user: User) {
+ *   return `${user.firstName} ${user.lastName}`;
+ * }
+ * ```
+ */
+export declare const Root: (...dataOrPipes: unknown[]) => ParameterDecorator;
+/**
+ * Alias for Root decorator
+ */
+export declare const Parent: (...dataOrPipes: unknown[]) => ParameterDecorator;
+/**
+ * Inject resolver arguments
+ *
+ * @example
+ * ```typescript
+ * @Query(() => User)
+ * async user(@Args('id') id: string) {
+ *   return this.userService.findById(id);
+ * }
+ * ```
+ */
+export declare const Args: (...dataOrPipes: (string | import("@nestjs/common").PipeTransform<any, any> | import("@nestjs/common").Type<import("@nestjs/common").PipeTransform<any, any>>)[]) => ParameterDecorator;
+/**
+ * Set complexity for a resolver
+ *
+ * @example
+ * ```typescript
+ * @Query(() => [Post])
+ * @Complexity(10)
+ * async posts() {
+ *   return this.postService.findAll();
+ * }
+ * ```
+ */
+export declare function Complexity(value: number | ComplexityEstimator): MethodDecorator;
+/**
+ * Complexity estimator function type
+ */
+export type ComplexityEstimator = (options: ComplexityEstimatorArgs) => number;
+/**
+ * Arguments for complexity estimator
+ */
+export interface ComplexityEstimatorArgs {
+    field: unknown;
+    args: Record<string, unknown>;
+    childComplexity: number;
+}
+/**
+ * Mark a field as deprecated
+ *
+ * @example
+ * ```typescript
+ * @Query(() => String)
+ * @Deprecated('Use newField instead')
+ * async oldField() {
+ *   return 'deprecated';
+ * }
+ * ```
+ */
+export declare function Deprecated(reason: string): MethodDecorator;
+/**
+ * Add description to a field
+ *
+ * @example
+ * ```typescript
+ * @Query(() => User)
+ * @Description('Fetch the currently authenticated user')
+ * async me() {
+ *   return this.authService.getCurrentUser();
+ * }
+ * ```
+ */
+export declare function Description(text: string): MethodDecorator;
+/**
+ * Enable caching for a resolver
+ *
+ * @example
+ * ```typescript
+ * @Query(() => Settings)
+ * @CacheHint({ maxAge: 3600 })
+ * async settings() {
+ *   return this.settingsService.getAll();
+ * }
+ * ```
+ */
+export declare function CacheHint(options: CacheHintOptions): MethodDecorator;
+/**
+ * Cache hint options
+ */
+export interface CacheHintOptions {
+    /**
+     * Maximum age in seconds
+     */
+    maxAge?: number;
+    /**
+     * Cache scope
+     */
+    scope?: 'PUBLIC' | 'PRIVATE';
+}
+/**
+ * Add filter to subscription
+ *
+ * @example
+ * ```typescript
+ * @Subscription(() => Comment)
+ * @SubscriptionFilter((payload, variables) => payload.postId === variables.postId)
+ * commentAdded() {
+ *   return pubSub.asyncIterator('COMMENT_ADDED');
+ * }
+ * ```
+ */
+export declare function SubscriptionFilter(filter: (payload: unknown, variables: unknown, context: unknown) => boolean | Promise<boolean>): MethodDecorator;
+/**
+ * Compose multiple decorators
+ *
+ * @example
+ * ```typescript
+ * @Query(() => [Post])
+ * @PublicQuery() // combines Complexity, Description, and CacheHint
+ * async publicPosts() {
+ *   return this.postService.findPublic();
+ * }
+ *
+ * function PublicQuery() {
+ *   return Decorators(
+ *     Complexity(5),
+ *     Description('Fetch public posts'),
+ *     CacheHint({ maxAge: 60, scope: 'PUBLIC' })
+ *   );
+ * }
+ * ```
+ */
+export declare function Decorators(...decorators: MethodDecorator[]): MethodDecorator;
+/**
+ * Create a custom context decorator
+ *
+ * @example
+ * ```typescript
+ * export const CurrentUser = createContextDecorator<User>('user');
+ *
+ * // Usage:
+ * @Query(() => Profile)
+ * async profile(@CurrentUser() user: User) {
+ *   return this.profileService.getByUserId(user.id);
+ * }
+ * ```
+ */
+export declare function createContextDecorator<T>(key: string): () => ParameterDecorator;
+//# sourceMappingURL=decorators.d.ts.map

package/dist/decorators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorators.d.ts","sourceRoot":"","sources":["../src/decorators.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAUH;;GAEG;AACH,eAAO,MAAM,cAAc,sBAAsB,CAAC;AAElD;;GAEG;AACH,eAAO,MAAM,cAAc,sBAAsB,CAAC;AAElD;;GAEG;AACH,eAAO,MAAM,eAAe,uBAAuB,CAAC;AAEpD;;GAEG;AACH,eAAO,MAAM,SAAS,iBAAiB,CAAC;AAExC;;GAEG;AACH,eAAO,MAAM,uBAAuB,+BAA+B,CAAC;AAEpE;;;;;;;;;;GAUG;AACH,eAAO,MAAM,OAAO,yLAUnB,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,IAAI,mDAKhB,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,IAAI,mDAKhB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,MAAM,mDAAO,CAAC;AAE3B;;;;;;;;;;GAUG;AACH,eAAO,MAAM,IAAI,yLAWhB,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,mBAAmB,GAAG,eAAe,CAE/E;AAED;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,EAAE,uBAAuB,KAAK,MAAM,CAAC;AAE/E;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,CAE1D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,CAEzD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,eAAe,CAEpE;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,KAAK,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;CAC9B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,GAC7F,eAAe,CAEjB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,UAAU,CAAC,GAAG,UAAU,EAAE,eAAe,EAAE,GAAG,eAAe,CAE5E;AAYD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,kBAAkB,CAM/E"}

package/dist/driver.d.ts

@@ -0,0 +1,95 @@
+/**
+ * @leaven-graphql/nestjs - Leaven Driver for NestJS GraphQL
+ *
+ * Copyright 2026 Pegasus Heavy Industries LLC
+ * Licensed under the Apache License, Version 2.0
+ */
+import { type OnModuleInit, type OnModuleDestroy } from '@nestjs/common';
+import type { GraphQLSchema, DocumentNode } from 'graphql';
+import { LeavenExecutor } from '@leaven-graphql/core';
+import type { LeavenModuleOptions, GqlContext, GraphQLFormattedError } from './types';
+/**
+ * Request handler result
+ */
+export interface HandlerResult {
+    data?: Record<string, unknown> | null;
+    errors?: readonly GraphQLFormattedError[];
+    extensions?: Record<string, unknown>;
+}
+/**
+ * Leaven Driver for NestJS GraphQL
+ *
+ * This driver integrates Leaven's high-performance GraphQL execution
+ * with NestJS's dependency injection and module system.
+ */
+export declare class LeavenDriver implements OnModuleInit, OnModuleDestroy {
+    private executor;
+    private schema;
+    private readonly options;
+    constructor(options: LeavenModuleOptions);
+    /**
+     * Initialize the driver with a schema
+     */
+    onModuleInit(): Promise<void>;
+    /**
+     * Cleanup resources on module destroy
+     */
+    onModuleDestroy(): Promise<void>;
+    /**
+     * Set the GraphQL schema
+     */
+    setSchema(schema: GraphQLSchema): void;
+    /**
+     * Get the current schema
+     */
+    getSchema(): GraphQLSchema | null;
+    /**
+     * Get the executor instance
+     */
+    getExecutor(): LeavenExecutor | null;
+    /**
+     * Initialize the Leaven executor
+     */
+    private initializeExecutor;
+    /**
+     * Execute a GraphQL request
+     */
+    execute<TData = Record<string, unknown>>(query: string | DocumentNode, variables?: Record<string, unknown>, context?: GqlContext, operationName?: string): Promise<HandlerResult>;
+    /**
+     * Handle an HTTP request
+     */
+    handleRequest(request: Request, response: Response): Promise<HandlerResult>;
+    /**
+     * Parse the request body
+     */
+    private parseRequestBody;
+    /**
+     * Create context for the request
+     */
+    private createContext;
+    /**
+     * Convert DocumentNode to string
+     */
+    private documentToString;
+    /**
+     * Check if playground should be enabled
+     */
+    isPlaygroundEnabled(): boolean;
+    /**
+     * Check if introspection should be enabled
+     */
+    isIntrospectionEnabled(): boolean;
+    /**
+     * Get the GraphQL path
+     */
+    getPath(): string;
+    /**
+     * Get cache statistics
+     */
+    getCacheStats(): ReturnType<LeavenExecutor['getCacheStats']> | null;
+    /**
+     * Clear all caches
+     */
+    clearCaches(): void;
+}
+//# sourceMappingURL=driver.d.ts.map

package/dist/driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver.d.ts","sourceRoot":"","sources":["../src/driver.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAc,KAAK,YAAY,EAAE,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACrF,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAuB,MAAM,sBAAsB,CAAC;AAC3E,OAAO,KAAK,EACV,mBAAmB,EACnB,UAAU,EACV,qBAAqB,EACtB,MAAM,SAAS,CAAC;AAEjB;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACtC,MAAM,CAAC,EAAE,SAAS,qBAAqB,EAAE,CAAC;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED;;;;;GAKG;AACH,qBACa,YAAa,YAAW,YAAY,EAAE,eAAe;IAChE,OAAO,CAAC,QAAQ,CAA+B;IAC/C,OAAO,CAAC,MAAM,CAA8B;IAC5C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsB;gBAElC,OAAO,EAAE,mBAAmB;IAIxC;;OAEG;IACU,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAO1C;;OAEG;IACU,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAO7C;;OAEG;IACI,SAAS,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI;IAK7C;;OAEG;IACI,SAAS,IAAI,aAAa,GAAG,IAAI;IAIxC;;OAEG;IACI,WAAW,IAAI,cAAc,GAAG,IAAI;IAI3C;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAe1B;;OAEG;IACU,OAAO,CAAC,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClD,KAAK,EAAE,MAAM,GAAG,YAAY,EAC5B,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,OAAO,CAAC,EAAE,UAAU,EACpB,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC,aAAa,CAAC;IA2DzB;;OAEG;IACU,aAAa,CACxB,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,QAAQ,GACjB,OAAO,CAAC,aAAa,CAAC;IAYzB;;OAEG;YACW,gBAAgB;IAiC9B;;OAEG;YACW,aAAa;IAiB3B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAMxB;;OAEG;IACI,mBAAmB,IAAI,OAAO;IAOrC;;OAEG;IACI,sBAAsB,IAAI,OAAO;IAOxC;;OAEG;IACI,OAAO,IAAI,MAAM;IAIxB;;OAEG;IACI,aAAa,IAAI,UAAU,CAAC,cAAc,CAAC,eAAe,CAAC,CAAC,GAAG,IAAI;IAI1E;;OAEG;IACI,WAAW,IAAI,IAAI;CAG3B"}

package/dist/execution-context.d.ts

@@ -0,0 +1,147 @@
+/**
+ * @leaven-graphql/nestjs - GraphQL Execution Context
+ *
+ * Provides a helper class for accessing GraphQL-specific context in guards,
+ * interceptors, and other NestJS constructs.
+ *
+ * Copyright 2026 Pegasus Heavy Industries LLC
+ * Licensed under the Apache License, Version 2.0
+ */
+import type { ExecutionContext, ArgumentsHost } from '@nestjs/common';
+import type { GraphQLResolveInfo } from 'graphql';
+import type { GqlContext } from './types';
+/**
+ * GraphQL execution context helper
+ *
+ * Provides easy access to GraphQL resolver arguments from NestJS execution context.
+ *
+ * @example
+ * ```typescript
+ * @Injectable()
+ * export class AuthGuard implements CanActivate {
+ *   canActivate(context: ExecutionContext): boolean {
+ *     const gqlContext = GqlExecutionContext.create(context);
+ *     const ctx = gqlContext.getContext();
+ *     const args = gqlContext.getArgs();
+ *     const info = gqlContext.getInfo();
+ *
+ *     return !!ctx.user;
+ *   }
+ * }
+ * ```
+ */
+export declare class GqlExecutionContext {
+    private readonly host;
+    private readonly args;
+    private constructor();
+    /**
+     * Create a GqlExecutionContext from an ExecutionContext
+     */
+    static create(context: ExecutionContext): GqlExecutionContext;
+    /**
+     * Get the GraphQL context object
+     *
+     * The context is the third argument in GraphQL resolvers:
+     * (root, args, context, info)
+     */
+    getContext<T = GqlContext>(): T;
+    /**
+     * Get the root/parent value
+     *
+     * The root is the first argument in GraphQL resolvers:
+     * (root, args, context, info)
+     */
+    getRoot<T = unknown>(): T;
+    /**
+     * Get the resolver arguments
+     *
+     * The args is the second argument in GraphQL resolvers:
+     * (root, args, context, info)
+     */
+    getArgs<T = Record<string, unknown>>(): T;
+    /**
+     * Get the GraphQL resolve info
+     *
+     * The info is the fourth argument in GraphQL resolvers:
+     * (root, args, context, info)
+     */
+    getInfo<T = GraphQLResolveInfo>(): T;
+    /**
+     * Get a specific argument by name
+     */
+    getArg<T = unknown>(name: string): T | undefined;
+    /**
+     * Get a specific context property by name
+     */
+    getContextProperty<T = unknown>(name: string): T | undefined;
+    /**
+     * Get the underlying ArgumentsHost
+     */
+    getHost(): ArgumentsHost;
+    /**
+     * Get the type of the execution context
+     * For GraphQL resolvers, this typically returns 'graphql'
+     */
+    getType(): string;
+    /**
+     * Check if this is a GraphQL context
+     */
+    isGraphQL(): boolean;
+    /**
+     * Get the handler (method) being executed
+     */
+    getHandler(): Function | undefined;
+    /**
+     * Get the class containing the handler
+     */
+    getClass(): Function | undefined;
+    /**
+     * Get the field name being resolved
+     */
+    getFieldName(): string | undefined;
+    /**
+     * Get the parent type name
+     */
+    getParentTypeName(): string | undefined;
+    /**
+     * Get the return type name
+     */
+    getReturnTypeName(): string | undefined;
+    /**
+     * Get the operation name from the query
+     */
+    getOperationName(): string | undefined;
+    /**
+     * Get the operation type (query, mutation, subscription)
+     */
+    getOperationType(): 'query' | 'mutation' | 'subscription' | undefined;
+    /**
+     * Get the variable values from the operation
+     */
+    getVariables<T = Record<string, unknown>>(): T;
+    /**
+     * Get the path to the current field
+     */
+    getPath(): string[];
+    /**
+     * Get the requested fields (first level)
+     */
+    getSelectedFields(): string[];
+}
+/**
+ * Helper function to extract GraphQL context from execution context
+ */
+export declare function getGqlContext<T = GqlContext>(context: ExecutionContext): T;
+/**
+ * Helper function to extract GraphQL args from execution context
+ */
+export declare function getGqlArgs<T = Record<string, unknown>>(context: ExecutionContext): T;
+/**
+ * Helper function to extract GraphQL info from execution context
+ */
+export declare function getGqlInfo<T = GraphQLResolveInfo>(context: ExecutionContext): T;
+/**
+ * Helper function to extract GraphQL root from execution context
+ */
+export declare function getGqlRoot<T = unknown>(context: ExecutionContext): T;
+//# sourceMappingURL=execution-context.d.ts.map

package/dist/execution-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-context.d.ts","sourceRoot":"","sources":["../src/execution-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACtE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE1C;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,mBAAmB;IAGV,OAAO,CAAC,QAAQ,CAAC,IAAI;IAFzC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAY;IAEjC,OAAO;IAIP;;OAEG;WACW,MAAM,CAAC,OAAO,EAAE,gBAAgB,GAAG,mBAAmB;IAIpE;;;;;OAKG;IACI,UAAU,CAAC,CAAC,GAAG,UAAU,KAAK,CAAC;IAItC;;;;;OAKG;IACI,OAAO,CAAC,CAAC,GAAG,OAAO,KAAK,CAAC;IAIhC;;;;;OAKG;IACI,OAAO,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC;IAIhD;;;;;OAKG;IACI,OAAO,CAAC,CAAC,GAAG,kBAAkB,KAAK,CAAC;IAI3C;;OAEG;IACI,MAAM,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAKvD;;OAEG;IACI,kBAAkB,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAKnE;;OAEG;IACI,OAAO,IAAI,aAAa;IAI/B;;;OAGG;IACI,OAAO,IAAI,MAAM;IAIxB;;OAEG;IACI,SAAS,IAAI,OAAO;IAI3B;;OAEG;IACI,UAAU,IAAI,QAAQ,GAAG,SAAS;IAIzC;;OAEG;IACI,QAAQ,IAAI,QAAQ,GAAG,SAAS;IAIvC;;OAEG;IACI,YAAY,IAAI,MAAM,GAAG,SAAS;IAKzC;;OAEG;IACI,iBAAiB,IAAI,MAAM,GAAG,SAAS;IAK9C;;OAEG;IACI,iBAAiB,IAAI,MAAM,GAAG,SAAS;IAK9C;;OAEG;IACI,gBAAgB,IAAI,MAAM,GAAG,SAAS;IAK7C;;OAEG;IACI,gBAAgB,IAAI,OAAO,GAAG,UAAU,GAAG,cAAc,GAAG,SAAS;IAK5E;;OAEG;IACI,YAAY,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC;IAKrD;;OAEG;IACI,OAAO,IAAI,MAAM,EAAE;IAiB1B;;OAEG;IACI,iBAAiB,IAAI,MAAM,EAAE;CAQrC;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,CAAC,GAAG,UAAU,EAAE,OAAO,EAAE,gBAAgB,GAAG,CAAC,CAE1E;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,gBAAgB,GAAG,CAAC,CAEpF;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,CAAC,GAAG,kBAAkB,EAAE,OAAO,EAAE,gBAAgB,GAAG,CAAC,CAE/E;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,CAAC,GAAG,OAAO,EAAE,OAAO,EAAE,gBAAgB,GAAG,CAAC,CAEpE"}

package/dist/guards.d.ts

@@ -0,0 +1,183 @@
+/**
+ * @leaven-graphql/nestjs - Guards
+ *
+ * Copyright 2026 Pegasus Heavy Industries LLC
+ * Licensed under the Apache License, Version 2.0
+ */
+import { type CanActivate, type ExecutionContext } from '@nestjs/common';
+import { Reflector } from '@nestjs/core';
+import type { GqlContext } from './types';
+/**
+ * Metadata key for public resolvers
+ */
+export declare const IS_PUBLIC_KEY = "leaven:isPublic";
+/**
+ * Metadata key for required roles
+ */
+export declare const ROLES_KEY = "leaven:roles";
+/**
+ * Metadata key for required permissions
+ */
+export declare const PERMISSIONS_KEY = "leaven:permissions";
+/**
+ * Mark a resolver as public (no authentication required)
+ *
+ * @example
+ * ```typescript
+ * @Query(() => String)
+ * @Public()
+ * async publicInfo() {
+ *   return 'This is public';
+ * }
+ * ```
+ */
+export declare const Public: () => ClassDecorator & MethodDecorator;
+/**
+ * Require specific roles
+ *
+ * @example
+ * ```typescript
+ * @Query(() => [User])
+ * @Roles('admin', 'moderator')
+ * async users() {
+ *   return this.userService.findAll();
+ * }
+ * ```
+ */
+export declare const Roles: (...roles: string[]) => ClassDecorator & MethodDecorator;
+/**
+ * Require specific permissions
+ *
+ * @example
+ * ```typescript
+ * @Mutation(() => User)
+ * @Permissions('user:write', 'user:delete')
+ * async deleteUser(@Args('id') id: string) {
+ *   return this.userService.delete(id);
+ * }
+ * ```
+ */
+export declare const Permissions: (...permissions: string[]) => ClassDecorator & MethodDecorator;
+/**
+ * Authentication guard for GraphQL resolvers
+ *
+ * Ensures the user is authenticated before accessing protected resolvers.
+ *
+ * @example
+ * ```typescript
+ * @UseGuards(AuthGuard)
+ * @Resolver(() => User)
+ * export class UserResolver {
+ *   // All resolvers in this class require authentication
+ * }
+ * ```
+ */
+export declare class AuthGuard implements CanActivate {
+    private readonly reflector;
+    constructor(reflector: Reflector);
+    canActivate(context: ExecutionContext): boolean;
+    /**
+     * Get GraphQL context from execution context
+     */
+    protected getGqlContext(context: ExecutionContext): GqlContext;
+    /**
+     * Extract user from context
+     * Override this method to customize user extraction
+     */
+    protected extractUser(context: GqlContext): unknown;
+}
+/**
+ * Role-based access guard
+ *
+ * Ensures the user has the required roles.
+ *
+ * @example
+ * ```typescript
+ * @UseGuards(AuthGuard, RolesGuard)
+ * @Roles('admin')
+ * @Resolver(() => Admin)
+ * export class AdminResolver {
+ *   // Only admins can access these resolvers
+ * }
+ * ```
+ */
+export declare class RolesGuard implements CanActivate {
+    private readonly reflector;
+    constructor(reflector: Reflector);
+    canActivate(context: ExecutionContext): boolean;
+    /**
+     * Get GraphQL context from execution context
+     */
+    protected getGqlContext(context: ExecutionContext): GqlContext;
+    /**
+     * Extract user from context
+     */
+    protected extractUser(context: GqlContext): unknown;
+    /**
+     * Extract roles from user
+     * Override this method to customize role extraction
+     */
+    protected extractRoles(user: unknown): string[];
+}
+/**
+ * Permission-based access guard
+ *
+ * Ensures the user has the required permissions.
+ *
+ * @example
+ * ```typescript
+ * @UseGuards(AuthGuard, PermissionsGuard)
+ * @Permissions('posts:read', 'posts:write')
+ * @Resolver(() => Post)
+ * export class PostResolver {
+ *   // Users need posts:read and posts:write permissions
+ * }
+ * ```
+ */
+export declare class PermissionsGuard implements CanActivate {
+    private readonly reflector;
+    constructor(reflector: Reflector);
+    canActivate(context: ExecutionContext): boolean;
+    /**
+     * Get GraphQL context from execution context
+     */
+    protected getGqlContext(context: ExecutionContext): GqlContext;
+    /**
+     * Extract user from context
+     */
+    protected extractUser(context: GqlContext): unknown;
+    /**
+     * Extract permissions from user
+     * Override this method to customize permission extraction
+     */
+    protected extractPermissions(user: unknown): string[];
+}
+/**
+ * Complexity limit guard
+ *
+ * Prevents queries that exceed complexity limits.
+ */
+export declare class ComplexityGuard implements CanActivate {
+    private readonly maxComplexity;
+    constructor(maxComplexity: number);
+    canActivate(context: ExecutionContext): boolean;
+    /**
+     * Get GraphQL context from execution context
+     */
+    private getGqlContext;
+}
+/**
+ * Depth limit guard
+ *
+ * Prevents queries that exceed depth limits.
+ */
+export declare class DepthGuard implements CanActivate {
+    private readonly maxDepth;
+    constructor(maxDepth: number);
+    canActivate(context: ExecutionContext): boolean;
+    /**
+     * Get GraphQL context from execution context
+     */
+    private getGqlContext;
+}
+//# sourceMappingURL=guards.d.ts.map

package/dist/guards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guards.d.ts","sourceRoot":"","sources":["../src/guards.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAEL,KAAK,WAAW,EAChB,KAAK,gBAAgB,EAKtB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE1C;;GAEG;AACH,eAAO,MAAM,aAAa,oBAAoB,CAAC;AAE/C;;GAEG;AACH,eAAO,MAAM,SAAS,iBAAiB,CAAC;AAExC;;GAEG;AACH,eAAO,MAAM,eAAe,uBAAuB,CAAC;AAEpD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,MAAM,QAAO,cAAc,GAAG,eAAmD,CAAC;AAE/F;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,KAAK,GAAI,GAAG,OAAO,MAAM,EAAE,KAAG,cAAc,GAAG,eAAgD,CAAC;AAE7G;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,WAAW,GAAI,GAAG,aAAa,MAAM,EAAE,KAAG,cAAc,GAAG,eAC7B,CAAC;AAE5C;;;;;;;;;;;;;GAaG;AACH,qBACa,SAAU,YAAW,WAAW;IAC/B,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAAT,SAAS,EAAE,SAAS;IAE1C,WAAW,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO;IAqBtD;;OAEG;IACH,SAAS,CAAC,aAAa,CAAC,OAAO,EAAE,gBAAgB,GAAG,UAAU;IAK9D;;;OAGG;IACH,SAAS,CAAC,WAAW,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO;CAQpD;AAED;;;;;;;;;;;;;;GAcG;AACH,qBACa,UAAW,YAAW,WAAW;IAChC,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAAT,SAAS,EAAE,SAAS;IAE1C,WAAW,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO;IA6BtD;;OAEG;IACH,SAAS,CAAC,aAAa,CAAC,OAAO,EAAE,gBAAgB,GAAG,UAAU;IAK9D;;OAEG;IACH,SAAS,CAAC,WAAW,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO;IAQnD;;;OAGG;IACH,SAAS,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,EAAE;CAchD;AAED;;;;;;;;;;;;;;GAcG;AACH,qBACa,gBAAiB,YAAW,WAAW;IACtC,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAAT,SAAS,EAAE,SAAS;IAE1C,WAAW,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO;IA+BtD;;OAEG;IACH,SAAS,CAAC,aAAa,CAAC,OAAO,EAAE,gBAAgB,GAAG,UAAU;IAK9D;;OAEG;IACH,SAAS,CAAC,WAAW,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO;IAQnD;;;OAGG;IACH,SAAS,CAAC,kBAAkB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,EAAE;CActD;AAED;;;;GAIG;AACH,qBACa,eAAgB,YAAW,WAAW;IAEd,OAAO,CAAC,QAAQ,CAAC,aAAa;gBAAb,aAAa,EAAE,MAAM;IAGlE,WAAW,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO;IAatD;;OAEG;IACH,OAAO,CAAC,aAAa;CAItB;AAED;;;;GAIG;AACH,qBACa,UAAW,YAAW,WAAW;IAEd,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,MAAM;IAGxD,WAAW,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO;IAatD;;OAEG;IACH,OAAO,CAAC,aAAa;CAItB"}

package/dist/index.d.ts

@@ -0,0 +1,37 @@
+/**
+ * @leaven-graphql/nestjs - NestJS integration for Leaven GraphQL
+ *
+ * This package provides seamless integration between NestJS and Leaven,
+ * allowing you to use Leaven's high-performance GraphQL execution engine
+ * within your NestJS applications.
+ *
+ * @example
+ * ```typescript
+ * import { Module } from '@nestjs/common';
+ * import { LeavenModule } from '@leaven-graphql/nestjs';
+ *
+ * @Module({
+ *   imports: [
+ *     LeavenModule.forRoot({
+ *       playground: true,
+ *       introspection: true,
+ *     }),
+ *   ],
+ * })
+ * export class AppModule {}
+ * ```
+ *
+ * Copyright 2026 Pegasus Heavy Industries LLC
+ * Licensed under the Apache License, Version 2.0
+ */
+export { LeavenModule, LEAVEN_MODULE_OPTIONS, LEAVEN_DRIVER } from './module';
+export { LeavenDriver, type HandlerResult } from './driver';
+export type { LeavenModuleOptions, LeavenModuleAsyncOptions, LeavenOptionsFactory, BuildSchemaOptions, DirectiveDefinition, ContextFactory, FormatErrorFn, GraphQLFormattedError, LeavenPlugin, PluginContext, CorsOptions, GqlContext, GqlExecutionContext as GqlExecutionContextInterface, } from './types';
+export { Context, Info, Root, Parent, Args, Complexity, Deprecated, Description, CacheHint, SubscriptionFilter, Decorators, createContextDecorator, COMPLEXITY_KEY, DEPRECATED_KEY, DESCRIPTION_KEY, CACHE_KEY, SUBSCRIPTION_FILTER_KEY, type ComplexityEstimator, type ComplexityEstimatorArgs, type CacheHintOptions, } from './decorators';
+export { AuthGuard, RolesGuard, PermissionsGuard, ComplexityGuard, DepthGuard, Public, Roles, Permissions, IS_PUBLIC_KEY, ROLES_KEY, PERMISSIONS_KEY, } from './guards';
+export { LoggingInterceptor, ErrorFormattingInterceptor, ComplexityInterceptor, CachingInterceptor, MetricsInterceptor, type OperationMetrics, type MetricsSummary, } from './interceptors';
+export { GraphQLMiddleware, createGraphQLMiddleware } from './middleware';
+export { GqlExecutionContext, getGqlContext, getGqlArgs, getGqlInfo, getGqlRoot, } from './execution-context';
+export { SchemaBuilderService, generateSchemaFile, getResolverMetadata, registerResolverMetadata, clearResolverMetadata, type SchemaSource, type SchemaFileOptions, type ResolverMetadata, } from './schema-builder';
+export { SubscriptionManager, Subscription, InjectPubSub, type SubscriptionConfig, type SubscriptionContext, type SubscribeMessage, type CompleteMessage, type ExecutionArgs, } from './subscriptions';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAGH,OAAO,EAAE,YAAY,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAG9E,OAAO,EAAE,YAAY,EAAE,KAAK,aAAa,EAAE,MAAM,UAAU,CAAC;AAG5D,YAAY,EACV,mBAAmB,EACnB,wBAAwB,EACxB,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,EACnB,cAAc,EACd,aAAa,EACb,qBAAqB,EACrB,YAAY,EACZ,aAAa,EACb,WAAW,EACX,UAAU,EACV,mBAAmB,IAAI,4BAA4B,GACpD,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,OAAO,EACP,IAAI,EACJ,IAAI,EACJ,MAAM,EACN,IAAI,EACJ,UAAU,EACV,UAAU,EACV,WAAW,EACX,SAAS,EACT,kBAAkB,EAClB,UAAU,EACV,sBAAsB,EACtB,cAAc,EACd,cAAc,EACd,eAAe,EACf,SAAS,EACT,uBAAuB,EACvB,KAAK,mBAAmB,EACxB,KAAK,uBAAuB,EAC5B,KAAK,gBAAgB,GACtB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,SAAS,EACT,UAAU,EACV,gBAAgB,EAChB,eAAe,EACf,UAAU,EACV,MAAM,EACN,KAAK,EACL,WAAW,EACX,aAAa,EACb,SAAS,EACT,eAAe,GAChB,MAAM,UAAU,CAAC;AAGlB,OAAO,EACL,kBAAkB,EAClB,0BAA0B,EAC1B,qBAAqB,EACrB,kBAAkB,EAClB,kBAAkB,EAClB,KAAK,gBAAgB,EACrB,KAAK,cAAc,GACpB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAG1E,OAAO,EACL,mBAAmB,EACnB,aAAa,EACb,UAAU,EACV,UAAU,EACV,UAAU,GACX,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,EACnB,wBAAwB,EACxB,qBAAqB,EACrB,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,GACtB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,mBAAmB,EACnB,YAAY,EACZ,YAAY,EACZ,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,aAAa,GACnB,MAAM,iBAAiB,CAAC"}