@leaven-graphql/nestjs 0.1.0

package/dist/interceptors.d.ts

@@ -0,0 +1,156 @@
+/**
+ * @leaven-graphql/nestjs - Interceptors
+ *
+ * Copyright 2026 Pegasus Heavy Industries LLC
+ * Licensed under the Apache License, Version 2.0
+ */
+import { type NestInterceptor, type ExecutionContext, type CallHandler } from '@nestjs/common';
+import { Observable } from 'rxjs';
+import { Reflector } from '@nestjs/core';
+/**
+ * Logging interceptor for GraphQL operations
+ *
+ * Logs timing and operation information for debugging.
+ *
+ * @example
+ * ```typescript
+ * @UseInterceptors(LoggingInterceptor)
+ * @Resolver(() => User)
+ * export class UserResolver {
+ *   // ...
+ * }
+ * ```
+ */
+export declare class LoggingInterceptor implements NestInterceptor {
+    intercept(context: ExecutionContext, next: CallHandler): Observable<unknown>;
+}
+/**
+ * Error formatting interceptor
+ *
+ * Catches errors and formats them consistently.
+ *
+ * @example
+ * ```typescript
+ * @UseInterceptors(ErrorFormattingInterceptor)
+ * @Resolver(() => User)
+ * export class UserResolver {
+ *   // ...
+ * }
+ * ```
+ */
+export declare class ErrorFormattingInterceptor implements NestInterceptor {
+    intercept(_context: ExecutionContext, next: CallHandler): Observable<unknown>;
+    /**
+     * Format an error for GraphQL response
+     */
+    private formatError;
+}
+/**
+ * Complexity tracking interceptor
+ *
+ * Tracks query complexity for monitoring.
+ *
+ * @example
+ * ```typescript
+ * @UseInterceptors(ComplexityInterceptor)
+ * @Resolver(() => User)
+ * export class UserResolver {
+ *   @Query(() => [User])
+ *   @Complexity(10)
+ *   async users() {
+ *     return this.userService.findAll();
+ *   }
+ * }
+ * ```
+ */
+export declare class ComplexityInterceptor implements NestInterceptor {
+    private readonly reflector;
+    constructor(reflector: Reflector);
+    intercept(context: ExecutionContext, next: CallHandler): Observable<unknown>;
+}
+/**
+ * Caching interceptor
+ *
+ * Handles cache hints for responses.
+ *
+ * @example
+ * ```typescript
+ * @UseInterceptors(CachingInterceptor)
+ * @Resolver(() => Settings)
+ * export class SettingsResolver {
+ *   @Query(() => Settings)
+ *   @CacheHint({ maxAge: 3600, scope: 'PUBLIC' })
+ *   async settings() {
+ *     return this.settingsService.getAll();
+ *   }
+ * }
+ * ```
+ */
+export declare class CachingInterceptor implements NestInterceptor {
+    private readonly reflector;
+    constructor(reflector: Reflector);
+    intercept(context: ExecutionContext, next: CallHandler): Observable<unknown>;
+}
+/**
+ * Metrics interceptor
+ *
+ * Collects metrics for GraphQL operations.
+ *
+ * @example
+ * ```typescript
+ * @UseInterceptors(MetricsInterceptor)
+ * @Resolver(() => User)
+ * export class UserResolver {
+ *   // ...
+ * }
+ * ```
+ */
+export declare class MetricsInterceptor implements NestInterceptor {
+    private readonly metrics;
+    intercept(context: ExecutionContext, next: CallHandler): Observable<unknown>;
+    /**
+     * Record a successful operation
+     */
+    private recordSuccess;
+    /**
+     * Record an error
+     */
+    private recordError;
+    /**
+     * Get or create metrics for a key
+     */
+    private getOrCreateMetrics;
+    /**
+     * Get all metrics
+     */
+    getMetrics(): Map<string, OperationMetrics>;
+    /**
+     * Get metrics summary
+     */
+    getSummary(): MetricsSummary[];
+    /**
+     * Reset all metrics
+     */
+    reset(): void;
+}
+/**
+ * Operation metrics
+ */
+export interface OperationMetrics {
+    totalCount: number;
+    successCount: number;
+    errorCount: number;
+    totalDuration: number;
+    lastDuration: number;
+    minDuration: number;
+    maxDuration: number;
+}
+/**
+ * Metrics summary for an operation
+ */
+export interface MetricsSummary extends OperationMetrics {
+    operation: string;
+    averageDuration: number;
+    errorRate: number;
+}
+//# sourceMappingURL=interceptors.d.ts.map

package/dist/interceptors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interceptors.d.ts","sourceRoot":"","sources":["../src/interceptors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,WAAW,EACjB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,UAAU,EAA+B,MAAM,MAAM,CAAC;AAC/D,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAGzC;;;;;;;;;;;;;GAaG;AACH,qBACa,kBAAmB,YAAW,eAAe;IACjD,SAAS,CAAC,OAAO,EAAE,gBAAgB,EAAE,IAAI,EAAE,WAAW,GAAG,UAAU,CAAC,OAAO,CAAC;CAYpF;AAED;;;;;;;;;;;;;GAaG;AACH,qBACa,0BAA2B,YAAW,eAAe;IACzD,SAAS,CAAC,QAAQ,EAAE,gBAAgB,EAAE,IAAI,EAAE,WAAW,GAAG,UAAU,CAAC,OAAO,CAAC;IAUpF;;OAEG;IACH,OAAO,CAAC,WAAW;CAUpB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,qBACa,qBAAsB,YAAW,eAAe;IAC/C,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAAT,SAAS,EAAE,SAAS;IAE1C,SAAS,CAAC,OAAO,EAAE,gBAAgB,EAAE,IAAI,EAAE,WAAW,GAAG,UAAU,CAAC,OAAO,CAAC;CAiBpF;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,qBACa,kBAAmB,YAAW,eAAe;IAC5C,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAAT,SAAS,EAAE,SAAS;IAE1C,SAAS,CAAC,OAAO,EAAE,gBAAgB,EAAE,IAAI,EAAE,WAAW,GAAG,UAAU,CAAC,OAAO,CAAC;CAsBpF;AAED;;;;;;;;;;;;;GAaG;AACH,qBACa,kBAAmB,YAAW,eAAe;IACxD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuC;IAExD,SAAS,CAAC,OAAO,EAAE,gBAAgB,EAAE,IAAI,EAAE,WAAW,GAAG,UAAU,CAAC,OAAO,CAAC;IAmBnF;;OAEG;IACH,OAAO,CAAC,aAAa;IAUrB;;OAEG;IACH,OAAO,CAAC,WAAW;IAQnB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAiB1B;;OAEG;IACI,UAAU,IAAI,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAIlD;;OAEG;IACI,UAAU,IAAI,cAAc,EAAE;IASrC;;OAEG;IACI,KAAK,IAAI,IAAI;CAGrB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,cAAe,SAAQ,gBAAgB;IACtD,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/middleware.d.ts

@@ -0,0 +1,60 @@
+/**
+ * @leaven-graphql/nestjs - Middleware
+ *
+ * Copyright 2026 Pegasus Heavy Industries LLC
+ * Licensed under the Apache License, Version 2.0
+ */
+import { type NestMiddleware, type Type } from '@nestjs/common';
+interface Request {
+    method: string;
+    path: string;
+    body?: Record<string, unknown>;
+    headers: Record<string, string | string[] | undefined>;
+}
+interface Response {
+    status(code: number): Response;
+    json(body: unknown): Response;
+    send(body: unknown): Response;
+    setHeader(name: string, value: string): Response;
+    end(): Response;
+}
+type NextFunction = () => void;
+import { LeavenDriver } from './driver';
+import type { LeavenModuleOptions } from './types';
+/**
+ * GraphQL middleware for handling GraphQL requests
+ *
+ * This middleware intercepts requests to the GraphQL endpoint
+ * and processes them through the Leaven driver.
+ */
+export declare class GraphQLMiddleware implements NestMiddleware {
+    private readonly driver;
+    private readonly options;
+    constructor(driver: LeavenDriver, options: LeavenModuleOptions);
+    /**
+     * Handle incoming requests
+     */
+    use(req: Request, res: Response, next: NextFunction): Promise<void>;
+    /**
+     * Handle GraphQL request
+     */
+    private handleGraphQLRequest;
+    /**
+     * Serve GraphQL Playground HTML
+     */
+    private servePlayground;
+    /**
+     * Handle CORS preflight request
+     */
+    private handleCorsPreFlight;
+    /**
+     * Get the playground HTML
+     */
+    private getPlaygroundHtml;
+}
+/**
+ * Create middleware module with proper configuration
+ */
+export declare function createGraphQLMiddleware(): Type<NestMiddleware>;
+export {};
+//# sourceMappingURL=middleware.d.ts.map

package/dist/middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../src/middleware.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAEL,KAAK,cAAc,EAEnB,KAAK,IAAI,EACV,MAAM,gBAAgB,CAAC;AAGxB,UAAU,OAAO;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC;CACxD;AAED,UAAU,QAAQ;IAChB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC/B,IAAI,CAAC,IAAI,EAAE,OAAO,GAAG,QAAQ,CAAC;IAC9B,IAAI,CAAC,IAAI,EAAE,OAAO,GAAG,QAAQ,CAAC;IAC9B,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,QAAQ,CAAC;IACjD,GAAG,IAAI,QAAQ,CAAC;CACjB;AAED,KAAK,YAAY,GAAG,MAAM,IAAI,CAAC;AAE/B,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAEnD;;;;;GAKG;AACH,qBACa,iBAAkB,YAAW,cAAc;IAE7B,OAAO,CAAC,QAAQ,CAAC,MAAM;IACf,OAAO,CAAC,QAAQ,CAAC,OAAO;gBADf,MAAM,EAAE,YAAY,EACZ,OAAO,EAAE,mBAAmB;IAG9E;;OAEG;IACU,GAAG,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IA6BhF;;OAEG;YACW,oBAAoB;IAyClC;;OAEG;IACH,OAAO,CAAC,eAAe;IAOvB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAwC3B;;OAEG;IACH,OAAO,CAAC,iBAAiB;CA6B1B;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,IAAI,CAAC,cAAc,CAAC,CAE9D"}

package/dist/module.d.ts

@@ -0,0 +1,80 @@
+/**
+ * @leaven-graphql/nestjs - NestJS Module
+ *
+ * Copyright 2026 Pegasus Heavy Industries LLC
+ * Licensed under the Apache License, Version 2.0
+ */
+import { DynamicModule } from '@nestjs/common';
+import type { LeavenModuleOptions, LeavenModuleAsyncOptions } from './types';
+/**
+ * Injection token for Leaven module options
+ */
+export declare const LEAVEN_MODULE_OPTIONS = "LEAVEN_MODULE_OPTIONS";
+/**
+ * Injection token for Leaven driver
+ */
+export declare const LEAVEN_DRIVER = "LEAVEN_DRIVER";
+/**
+ * Leaven GraphQL Module for NestJS
+ *
+ * This module provides integration between NestJS and Leaven GraphQL.
+ * It can be used with both schema-first and code-first approaches.
+ *
+ * @example
+ * ```typescript
+ * // Schema-first approach
+ * @Module({
+ *   imports: [
+ *     LeavenModule.forRoot({
+ *       typeDefs: `
+ *         type Query {
+ *           hello: String!
+ *         }
+ *       `,
+ *       resolvers: {
+ *         Query: {
+ *           hello: () => 'Hello World!',
+ *         },
+ *       },
+ *     }),
+ *   ],
+ * })
+ * export class AppModule {}
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Async configuration
+ * @Module({
+ *   imports: [
+ *     LeavenModule.forRootAsync({
+ *       useFactory: (configService: ConfigService) => ({
+ *         playground: configService.get('GRAPHQL_PLAYGROUND'),
+ *         introspection: configService.get('GRAPHQL_INTROSPECTION'),
+ *       }),
+ *       inject: [ConfigService],
+ *     }),
+ *   ],
+ * })
+ * export class AppModule {}
+ * ```
+ */
+export declare class LeavenModule {
+    /**
+     * Configure the module synchronously
+     */
+    static forRoot(options?: LeavenModuleOptions): DynamicModule;
+    /**
+     * Configure the module asynchronously
+     */
+    static forRootAsync(options: LeavenModuleAsyncOptions): DynamicModule;
+    /**
+     * Create async providers based on configuration
+     */
+    private static createAsyncProviders;
+    /**
+     * Create the async options provider
+     */
+    private static createAsyncOptionsProvider;
+}
+//# sourceMappingURL=module.d.ts.map

package/dist/module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../src/module.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAEL,aAAa,EAKd,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EACV,mBAAmB,EACnB,wBAAwB,EAEzB,MAAM,SAAS,CAAC;AAGjB;;GAEG;AACH,eAAO,MAAM,qBAAqB,0BAA0B,CAAC;AAE7D;;GAEG;AACH,eAAO,MAAM,aAAa,kBAAkB,CAAC;AAE7C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,qBAEa,YAAY;IACvB;;OAEG;WACW,OAAO,CAAC,OAAO,GAAE,mBAAwB,GAAG,aAAa;IAmBvE;;OAEG;WACW,YAAY,CAAC,OAAO,EAAE,wBAAwB,GAAG,aAAa;IAiB5E;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,oBAAoB;IAiBnC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,0BAA0B;CAsB1C"}

package/dist/schema-builder.d.ts

@@ -0,0 +1,119 @@
+/**
+ * @leaven-graphql/nestjs - Schema Builder Integration
+ *
+ * Provides integration with NestJS's code-first schema building approach.
+ *
+ * Copyright 2026 Pegasus Heavy Industries LLC
+ * Licensed under the Apache License, Version 2.0
+ */
+import { type OnModuleInit, type Type } from '@nestjs/common';
+import type { GraphQLSchema } from 'graphql';
+import { LeavenDriver } from './driver';
+import type { LeavenModuleOptions, BuildSchemaOptions } from './types';
+/**
+ * Schema source type - determines how to build the schema
+ */
+export type SchemaSource = {
+    type: 'provided';
+    schema: GraphQLSchema;
+} | {
+    type: 'typeDefs';
+    typeDefs: string;
+    resolvers: Record<string, unknown>;
+} | {
+    type: 'autoSchema';
+    options: BuildSchemaOptions;
+};
+/**
+ * Schema builder service
+ *
+ * Handles building the GraphQL schema from various sources and
+ * integrating it with the Leaven driver.
+ */
+export declare class SchemaBuilderService implements OnModuleInit {
+    private readonly options;
+    private readonly driver;
+    private builtSchema;
+    constructor(options: LeavenModuleOptions, driver: LeavenDriver);
+    /**
+     * Initialize the schema on module init
+     */
+    onModuleInit(): Promise<void>;
+    /**
+     * Build the schema from configured sources
+     */
+    buildSchema(): Promise<GraphQLSchema | null>;
+    /**
+     * Build schema from type definitions (SDL)
+     */
+    private buildFromTypeDefs;
+    /**
+     * Merge multiple type definition strings
+     */
+    private mergeTypeDefs;
+    /**
+     * Merge multiple resolver objects
+     */
+    private mergeResolvers;
+    /**
+     * Get the built schema
+     */
+    getSchema(): GraphQLSchema | null;
+    /**
+     * Set a new schema (for hot-reloading scenarios)
+     */
+    setSchema(schema: GraphQLSchema): void;
+    /**
+     * Check if schema is ready
+     */
+    isSchemaReady(): boolean;
+}
+/**
+ * Schema file generator options
+ */
+export interface SchemaFileOptions {
+    /**
+     * Path to write the schema file
+     */
+    path: string;
+    /**
+     * Sort schema alphabetically
+     */
+    sortSchema?: boolean;
+    /**
+     * Include comments/descriptions
+     */
+    includeDescriptions?: boolean;
+}
+/**
+ * Generate a schema file from the current schema
+ */
+export declare function generateSchemaFile(schema: GraphQLSchema, options: SchemaFileOptions): Promise<void>;
+/**
+ * Resolver decorator metadata storage
+ */
+export interface ResolverMetadata {
+    type: 'Query' | 'Mutation' | 'Subscription' | 'Field';
+    name: string;
+    returnType: Type<unknown> | string;
+    target: Type<unknown>;
+    methodName: string;
+    args?: Array<{
+        name: string;
+        type: Type<unknown> | string;
+        nullable?: boolean;
+    }>;
+}
+/**
+ * Get all registered resolver metadata
+ */
+export declare function getResolverMetadata(): ResolverMetadata[];
+/**
+ * Register resolver metadata
+ */
+export declare function registerResolverMetadata(metadata: ResolverMetadata): void;
+/**
+ * Clear resolver metadata (for testing)
+ */
+export declare function clearResolverMetadata(): void;
+//# sourceMappingURL=schema-builder.d.ts.map

package/dist/schema-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-builder.d.ts","sourceRoot":"","sources":["../src/schema-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAc,KAAK,YAAY,EAAU,KAAK,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAClF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,KAAK,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAEvE;;GAEG;AACH,MAAM,MAAM,YAAY,GACpB;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,MAAM,EAAE,aAAa,CAAA;CAAE,GAC3C;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAC1E;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,OAAO,EAAE,kBAAkB,CAAA;CAAE,CAAC;AAExD;;;;;GAKG;AACH,qBACa,oBAAqB,YAAW,YAAY;IAItB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM;IAJhD,OAAO,CAAC,WAAW,CAA8B;gBAGC,OAAO,EAAE,mBAAmB,EACpC,MAAM,EAAE,YAAY;IAG9D;;OAEG;IACU,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ1C;;OAEG;IACU,WAAW,IAAI,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAqBzD;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA4CzB;;OAEG;IACH,OAAO,CAAC,aAAa;IAuBrB;;OAEG;IACH,OAAO,CAAC,cAAc;IAYtB;;OAEG;IACI,SAAS,IAAI,aAAa,GAAG,IAAI;IAIxC;;OAEG;IACI,SAAS,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI;IAK7C;;OAEG;IACI,aAAa,IAAI,OAAO;CAGhC;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB;;OAEG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,IAAI,CAAC,CAYf;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,OAAO,GAAG,UAAU,GAAG,cAAc,GAAG,OAAO,CAAC;IACtD,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,MAAM,CAAC;IACnC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,KAAK,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,MAAM,CAAC;QAC7B,QAAQ,CAAC,EAAE,OAAO,CAAC;KACpB,CAAC,CAAC;CACJ;AAOD;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,gBAAgB,EAAE,CAExD;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,IAAI,CAEzE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C"}

package/dist/subscriptions.d.ts

@@ -0,0 +1,195 @@
+/**
+ * @leaven-graphql/nestjs - Subscriptions Support
+ *
+ * Provides WebSocket-based GraphQL subscriptions integration for NestJS.
+ *
+ * Copyright 2026 Pegasus Heavy Industries LLC
+ * Licensed under the Apache License, Version 2.0
+ */
+import { type OnModuleInit, type OnModuleDestroy } from '@nestjs/common';
+import { LeavenDriver } from './driver';
+import type { LeavenModuleOptions, GqlContext } from './types';
+/**
+ * Subscription configuration
+ */
+export interface SubscriptionConfig {
+    /**
+     * WebSocket path for subscriptions
+     * @default '/graphql'
+     */
+    path?: string;
+    /**
+     * Keep-alive interval in milliseconds
+     * @default 12000
+     */
+    keepAlive?: number;
+    /**
+     * Connection initialization timeout in milliseconds
+     * @default 3000
+     */
+    connectionInitWaitTimeout?: number;
+    /**
+     * Maximum number of subscriptions per connection
+     * @default 100
+     */
+    maxSubscriptionsPerConnection?: number;
+    /**
+     * Context factory for subscription connections
+     */
+    context?: (ctx: SubscriptionContext) => GqlContext | Promise<GqlContext>;
+    /**
+     * Connection callback - called when a client connects
+     */
+    onConnect?: (ctx: SubscriptionContext) => boolean | Promise<boolean>;
+    /**
+     * Disconnect callback - called when a client disconnects
+     */
+    onDisconnect?: (ctx: SubscriptionContext) => void | Promise<void>;
+    /**
+     * Subscribe callback - called when a subscription starts
+     */
+    onSubscribe?: (ctx: SubscriptionContext, message: SubscribeMessage) => void | Promise<void>;
+    /**
+     * Operation callback - called for each subscription operation
+     */
+    onOperation?: (ctx: SubscriptionContext, message: SubscribeMessage, args: ExecutionArgs) => ExecutionArgs | Promise<ExecutionArgs>;
+    /**
+     * Complete callback - called when a subscription completes
+     */
+    onComplete?: (ctx: SubscriptionContext, message: CompleteMessage) => void | Promise<void>;
+}
+/**
+ * Subscription context
+ */
+export interface SubscriptionContext {
+    /**
+     * The WebSocket connection
+     */
+    socket: WebSocket;
+    /**
+     * Connection parameters from client
+     */
+    connectionParams: Record<string, unknown> | undefined;
+    /**
+     * Extra data attached to the connection
+     */
+    extra?: Record<string, unknown>;
+    /**
+     * Request object (if available)
+     */
+    request: Request | undefined;
+}
+/**
+ * Subscribe message
+ */
+export interface SubscribeMessage {
+    id: string;
+    type: 'subscribe';
+    payload: {
+        query: string;
+        variables?: Record<string, unknown>;
+        operationName?: string;
+        extensions?: Record<string, unknown>;
+    };
+}
+/**
+ * Complete message
+ */
+export interface CompleteMessage {
+    id: string;
+    type: 'complete';
+}
+/**
+ * Execution args for GraphQL
+ */
+export interface ExecutionArgs {
+    schema: unknown;
+    document: unknown;
+    rootValue?: unknown;
+    contextValue?: unknown;
+    variableValues?: Record<string, unknown>;
+    operationName?: string;
+}
+/**
+ * Subscription manager
+ *
+ * Manages WebSocket connections and GraphQL subscriptions.
+ */
+export declare class SubscriptionManager implements OnModuleInit, OnModuleDestroy {
+    private readonly options;
+    private readonly driver;
+    private connections;
+    private config;
+    constructor(options: LeavenModuleOptions, driver: LeavenDriver);
+    /**
+     * Initialize subscription manager
+     */
+    onModuleInit(): Promise<void>;
+    /**
+     * Cleanup on module destroy
+     */
+    onModuleDestroy(): Promise<void>;
+    /**
+     * Normalize subscription configuration
+     */
+    private normalizeConfig;
+    /**
+     * Handle new WebSocket connection
+     */
+    handleConnection(socket: WebSocket, request?: Request): Promise<void>;
+    /**
+     * Handle incoming WebSocket message
+     */
+    private handleMessage;
+    /**
+     * Handle connection initialization
+     */
+    private handleConnectionInit;
+    /**
+     * Handle subscribe message
+     */
+    private handleSubscribe;
+    /**
+     * Handle complete message
+     */
+    private handleComplete;
+    /**
+       * Handle WebSocket close
+       */
+    private handleClose;
+    /**
+     * Handle WebSocket error
+     */
+    private handleError;
+    /**
+     * Send message to client
+     */
+    private send;
+    /**
+     * Send error to client
+     */
+    private sendError;
+    /**
+     * Publish to subscription
+     */
+    publish(id: string, payload: unknown): void;
+    /**
+     * Get connection count
+     */
+    getConnectionCount(): number;
+    /**
+     * Get total subscription count
+     */
+    getSubscriptionCount(): number;
+}
+/**
+ * Create a subscription decorator for NestJS resolvers
+ */
+export declare function Subscription(returns: () => unknown, options?: {
+    filter?: (payload: unknown, variables: unknown, context: unknown) => boolean;
+}): MethodDecorator;
+/**
+ * PubSub decorator for injecting PubSub instance
+ */
+export declare function InjectPubSub(): ParameterDecorator;
+//# sourceMappingURL=subscriptions.d.ts.map

package/dist/subscriptions.d.ts.map

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