@leaven-graphql/nestjs 0.1.0

package/dist/types.d.ts

@@ -0,0 +1,229 @@
+/**
+ * @leaven-graphql/nestjs - Type definitions
+ *
+ * Copyright 2026 Pegasus Heavy Industries LLC
+ * Licensed under the Apache License, Version 2.0
+ */
+import type { Type } from '@nestjs/common';
+import type { ModuleMetadata } from '@nestjs/common/interfaces';
+import type { GraphQLSchema, DocumentNode } from 'graphql';
+import type { DocumentCacheConfig } from '@leaven-graphql/core';
+/**
+ * Configuration options for the Leaven GraphQL module
+ */
+export interface LeavenModuleOptions {
+    /**
+     * Path for the GraphQL endpoint
+     * @default '/graphql'
+     */
+    path?: string;
+    /**
+     * Pre-built GraphQL schema (schema-first approach)
+     */
+    schema?: GraphQLSchema;
+    /**
+     * Type definitions for schema-first approach
+     */
+    typeDefs?: string | DocumentNode | Array<string | DocumentNode>;
+    /**
+     * Resolvers for schema-first approach
+     */
+    resolvers?: Record<string, unknown> | Array<Record<string, unknown>>;
+    /**
+     * Enable auto-schema generation (code-first approach)
+     * @default true
+     */
+    autoSchemaFile?: boolean | string;
+    /**
+     * Sort schema alphabetically
+     * @default false
+     */
+    sortSchema?: boolean;
+    /**
+     * Build schema options for code-first
+     */
+    buildSchemaOptions?: BuildSchemaOptions;
+    /**
+     * Enable GraphQL Playground
+     * @default true in development
+     */
+    playground?: boolean;
+    /**
+     * Enable introspection
+     * @default true in development
+     */
+    introspection?: boolean;
+    /**
+     * Document cache configuration
+     */
+    cache?: DocumentCacheConfig | boolean;
+    /**
+     * Maximum query complexity allowed
+     */
+    maxComplexity?: number;
+    /**
+     * Maximum query depth allowed
+     */
+    maxDepth?: number;
+    /**
+     * Enable execution metrics
+     * @default false
+     */
+    metrics?: boolean;
+    /**
+     * Enable debug mode
+     * @default false
+     */
+    debug?: boolean;
+    /**
+     * Context factory function
+     */
+    context?: ContextFactory;
+    /**
+     * Format error function
+     */
+    formatError?: FormatErrorFn;
+    /**
+     * Plugins to use
+     */
+    plugins?: LeavenPlugin[];
+    /**
+     * Enable CORS
+     */
+    cors?: boolean | CorsOptions;
+    /**
+     * Include stack traces in errors (development only)
+     * @default false
+     */
+    includeStacktraceInErrorResponses?: boolean;
+}
+/**
+ * Options for async module configuration
+ */
+export interface LeavenModuleAsyncOptions extends Pick<ModuleMetadata, 'imports'> {
+    /**
+     * Existing provider to use
+     */
+    useExisting?: Type<LeavenOptionsFactory>;
+    /**
+     * Class to instantiate
+     */
+    useClass?: Type<LeavenOptionsFactory>;
+    /**
+     * Factory function
+     */
+    useFactory?: (...args: unknown[]) => Promise<LeavenModuleOptions> | LeavenModuleOptions;
+    /**
+     * Injection tokens for factory
+     */
+    inject?: unknown[];
+}
+/**
+ * Factory interface for creating Leaven options
+ */
+export interface LeavenOptionsFactory {
+    createLeavenOptions(): Promise<LeavenModuleOptions> | LeavenModuleOptions;
+}
+/**
+ * Build schema options for code-first approach
+ */
+export interface BuildSchemaOptions {
+    /**
+     * Date scalar mode
+     */
+    dateScalarMode?: 'isoDate' | 'timestamp';
+    /**
+     * Number scalar mode
+     */
+    numberScalarMode?: 'integer' | 'float';
+    /**
+     * Skip check for resolvers
+     */
+    skipCheck?: boolean;
+    /**
+     * Orphaned types to include
+     */
+    orphanedTypes?: Type[];
+    /**
+     * Directives to include
+     */
+    directives?: DirectiveDefinition[];
+}
+/**
+ * Directive definition
+ */
+export interface DirectiveDefinition {
+    name: string;
+    locations: string[];
+    args?: Record<string, unknown>;
+}
+/**
+ * Context factory function type
+ */
+export type ContextFactory<TContext = Record<string, unknown>> = (request: Request, response: Response) => TContext | Promise<TContext>;
+/**
+ * Error formatting function
+ */
+export type FormatErrorFn = (error: GraphQLFormattedError) => GraphQLFormattedError;
+/**
+ * GraphQL formatted error
+ */
+export interface GraphQLFormattedError {
+    message: string;
+    locations?: Array<{
+        line: number;
+        column: number;
+    }>;
+    path?: Array<string | number>;
+    extensions?: Record<string, unknown>;
+}
+/**
+ * Plugin interface
+ */
+export interface LeavenPlugin {
+    name: string;
+    onInit?: () => void | Promise<void>;
+    onRequest?: (context: PluginContext) => void | Promise<void>;
+    onResponse?: (context: PluginContext, response: unknown) => void | Promise<void>;
+    onError?: (context: PluginContext, error: Error) => void | Promise<void>;
+}
+/**
+ * Plugin context
+ */
+export interface PluginContext {
+    request: Request;
+    response?: Response;
+    schema: GraphQLSchema;
+    document?: DocumentNode;
+    operationName?: string;
+    variables?: Record<string, unknown>;
+}
+/**
+ * CORS options
+ */
+export interface CorsOptions {
+    origin?: string | string[] | boolean;
+    methods?: string | string[];
+    allowedHeaders?: string | string[];
+    exposedHeaders?: string | string[];
+    credentials?: boolean;
+    maxAge?: number;
+}
+/**
+ * Request context passed to resolvers
+ */
+export interface GqlContext<TRequest = Request, TResponse = Response> {
+    req: TRequest;
+    res: TResponse;
+    [key: string]: unknown;
+}
+/**
+ * Execution context for GraphQL operations
+ */
+export interface GqlExecutionContext {
+    getContext<T = GqlContext>(): T;
+    getRoot<T = unknown>(): T;
+    getArgs<T = Record<string, unknown>>(): T;
+    getInfo<T = unknown>(): T;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@leaven-graphql/nestjs",
+  "version": "0.1.0",
+  "description": "NestJS integration for Leaven GraphQL",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "dependencies": {
+    "@leaven-graphql/core": "0.1.0",
+    "@leaven-graphql/context": "0.1.0",
+    "@leaven-graphql/errors": "0.1.0"
+  },
+  "peerDependencies": {
+    "@nestjs/common": ">=10.0.0",
+    "@nestjs/core": ">=10.0.0",
+    "@nestjs/graphql": ">=12.0.0",
+    "graphql": "^16.0.0"
+  },
+  "devDependencies": {
+    "@nestjs/common": "^11.0.20",
+    "@nestjs/core": "^11.0.20",
+    "@nestjs/graphql": "^13.0.6",
+    "@nestjs/testing": "^11.0.20",
+    "graphql": "^16.12.0",
+    "reflect-metadata": "^0.2.2",
+    "rxjs": "^7.8.2",
+    "typescript": "^5.9.3"
+  },
+  "keywords": [
+    "nestjs",
+    "graphql",
+    "leaven",
+    "bun",
+    "api"
+  ],
+  "license": "Apache-2.0",
+  "author": "Pegasus Heavy Industries LLC",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/PegasusHeavyIndustries/leaven.git",
+    "directory": "packages/nestjs"
+  },
+  "scripts": {
+    "build": "bun build ./src/index.ts --outdir ./dist --target bun --external @nestjs/* --external reflect-metadata --external rxjs --external graphql --external class-transformer --external class-validator --external @leaven-graphql/* && tsc -p tsconfig.build.json",
+    "clean": "rm -rf dist",
+    "test": "bun test",
+    "typecheck": "tsc --noEmit"
+  }
+}