@lenne.tech/nest-server 11.14.1 → 11.15.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lenne.tech/nest-server",
-  "version": "11.14.1",
+  "version": "11.15.1",
   "description": "Modern, fast, powerful Node.js web framework in TypeScript based on Nest with a GraphQL API and a connection to MongoDB (or other databases).",
   "keywords": [
     "node",
@@ -14,25 +14,31 @@
   "homepage": "https://github.com/lenneTech/nest-server",
   "license": "MIT",
   "scripts": {
-    "build": "rimraf dist && nest build && npm run build:copy-types && npm run build:copy-templates && npm run build:add-type-references",
+    "build": "rimraf dist && nest build && pnpm run build:copy-types && pnpm run build:copy-templates && pnpm run build:add-type-references",
     "build:copy-types": "mkdir -p dist/types && cp src/types/*.d.ts dist/types/",
     "build:copy-templates": "mkdir -p dist/core/modules/migrate/templates && cp src/core/modules/migrate/templates/migration-project.template.ts dist/core/modules/migrate/templates/",
     "build:add-type-references": "node scripts/add-type-references.js",
-    "build:pack": "npm pack && echo 'use file:/ROOT_PATH_TO_TGZ_FILE to integrate the package'",
-    "build:dev": "npm run build && yalc push --private",
-    "docs": "npm run docs:ci && open http://127.0.0.1:8080/ && open ./public/index.html && compodoc -p tsconfig.json -s ",
+    "build:pack": "pnpm pack && echo 'use file:/ROOT_PATH_TO_TGZ_FILE to integrate the package'",
+    "build:dev": "pnpm run build",
+    "c": "pnpm run check",
+    "check": "pnpm audit && pnpm run format:check && pnpm run lint && pnpm test && pnpm run build && pnpm start",
+    "check:fix": "pnpm install && pnpm audit --fix && pnpm run format && pnpm run lint:fix && pnpm test && pnpm run build && pnpm start",
+    "check:naf": "pnpm install && pnpm run format && pnpm run lint:fix && pnpm test && pnpm run build && pnpm start",
+    "cf": "pnpm run check:fix",
+    "cnaf": "pnpm run check:naf",
+    "docs": "pnpm run docs:ci && open http://127.0.0.1:8080/ && open ./public/index.html && compodoc -p tsconfig.json -s ",
     "docs:bootstrap": "node extras/update-spectaql-version.mjs && node scripts/run-spectaql.mjs",
-    "docs:ci": "ts-node ./scripts/init-server.ts && npm run docs:bootstrap && compodoc -p tsconfig.json",
+    "docs:ci": "ts-node ./scripts/init-server.ts && pnpm run docs:bootstrap && compodoc -p tsconfig.json",
     "format": "oxfmt --write src/",
     "format:check": "oxfmt --check src/",
     "lint": "oxlint --ignore-path .oxlintignore src/ tests/",
     "lint:fix": "oxlint --fix --fix-suggestions --ignore-path .oxlintignore src/ tests/",
-    "prestart:prod": "npm run build",
-    "reinit": "rimraf package-lock.json && rimraf node_modules && npm i && npm run lint && npm run test:e2e && npm run test:ci && npm run build",
-    "reinit:clean": "rimraf package-lock.json && rimraf node_modules && npm cache clean --force && npm i && npm run test:e2e && npm run build",
-    "reinit:force": "rimraf package-lock.json && rimraf node_modules && npm cache clean --force && npm i --force && npm run test:e2e",
-    "reinit:legacy": "rimraf package-lock.json && rimraf node_modules && npm cache clean --force && npm i --legacy-peer-deps && npm run test:e2e",
-    "start": "npm run start:local",
+    "prestart:prod": "pnpm run build",
+    "reinit": "rimraf pnpm-lock.yaml && rimraf node_modules && pnpm install && pnpm run lint && pnpm run test:e2e && pnpm run test:ci && pnpm run build",
+    "reinit:clean": "rimraf pnpm-lock.yaml && rimraf node_modules && pnpm store prune && pnpm install && pnpm run test:e2e && pnpm run build",
+    "reinit:force": "rimraf pnpm-lock.yaml && rimraf node_modules && pnpm store prune && pnpm install --force && pnpm run test:e2e",
+    "reinit:legacy": "rimraf pnpm-lock.yaml && rimraf node_modules && pnpm store prune && pnpm install && pnpm run test:e2e",
+    "start": "pnpm run start:local",
     "start:prod": "NODE_ENV=production node dist/main.js",
     "start:nodemon": "ts-node -r tsconfig-paths/register src/main.ts",
     "start:debug": "nodemon --config nodemon-debug.json",
@@ -40,12 +46,12 @@
     "start:dev:swc": "nest start -b swc -w --type-check",
     "start:local": "NODE_ENV=local nodemon",
     "start:local:swc": "NODE_ENV=local nest start -b swc -w --type-check",
-    "test": "npm run vitest",
-    "test:ci": "npm run vitest:ci",
-    "test:e2e": "npm run vitest",
-    "prepack": "npm run prestart:prod",
-    "prepublishOnly": "npm run lint && npm run test:ci",
-    "preversion": "npm run lint",
+    "test": "pnpm run vitest",
+    "test:ci": "pnpm run vitest:ci",
+    "test:e2e": "pnpm run vitest",
+    "prepack": "pnpm run prestart:prod",
+    "prepublishOnly": "pnpm run lint && pnpm run test:ci",
+    "preversion": "pnpm run lint",
     "vitest": "NODE_ENV=e2e vitest run --config vitest-e2e.config.ts",
     "vitest:ci": "NODE_ENV=ci vitest run --config vitest-e2e.config.ts",
     "vitest:cov": "NODE_ENV=e2e vitest run --coverage --config vitest-e2e.config.ts",
@@ -53,6 +59,7 @@
     "vitest:unit": "vitest run --config vitest.config.ts",
     "test:unit:watch": "vitest --config vitest.config.ts",
     "test:types": "tsc --noEmit --skipLibCheck -p tests/types/tsconfig.json",
+    "test:cleanup": "find tests -type f \\( -name '*.txt' -o -name '*.bin' \\) -not -name '.gitkeep' -delete && echo 'Test artifacts cleaned up'",
     "watch": "npm-watch"
   },
   "repository": {
@@ -152,8 +159,7 @@
     "vite": "7.3.1",
     "vite-plugin-node": "7.0.0",
     "vite-tsconfig-paths": "6.1.0",
-    "vitest": "4.0.18",
-    "yalc": "1.0.0-pre.53"
+    "vitest": "4.0.18"
   },
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -169,7 +175,18 @@
   "watch": {
     "build:dev": "src"
   },
-  "overrides": {
-    "lodash": "4.17.23"
+  "packageManager": "pnpm@10.29.2",
+  "pnpm": {
+    "overrides": {
+      "lodash": "4.17.23"
+    },
+    "onlyBuiltDependencies": [
+      "bcrypt",
+      "@swc/core",
+      "esbuild",
+      "@nestjs/core",
+      "@compodoc/compodoc",
+      "@apollo/protobufjs"
+    ]
   }
 }

package/src/config.env.ts

@@ -77,7 +77,7 @@ const config: { [env: string]: IServerOptions } = {
     errorCode: {
       autoRegister: false,
     },
-    execAfterInit: 'npm run docs:bootstrap',
+    execAfterInit: 'pnpm run docs:bootstrap',
     filter: {
       maxLimit: null,
     },
@@ -183,7 +183,7 @@ const config: { [env: string]: IServerOptions } = {
       verificationLink: 'http://localhost:4200/user/verification',
     },
     env: 'development',
-    execAfterInit: 'npm run docs:bootstrap',
+    execAfterInit: 'pnpm run docs:bootstrap',
     filter: {
       maxLimit: null,
     },
@@ -321,7 +321,7 @@ const config: { [env: string]: IServerOptions } = {
     errorCode: {
       autoRegister: false,
     },
-    execAfterInit: 'npm run docs:bootstrap',
+    execAfterInit: 'pnpm run docs:bootstrap',
     filter: {
       maxLimit: null,
     },
@@ -439,7 +439,7 @@ const config: { [env: string]: IServerOptions } = {
     errorCode: {
       autoRegister: false,
     },
-    execAfterInit: 'npm run docs:bootstrap',
+    execAfterInit: 'pnpm run docs:bootstrap',
     filter: {
       maxLimit: null,
     },
@@ -563,7 +563,7 @@ const config: { [env: string]: IServerOptions } = {
       verificationLink: 'http://localhost:4200/user/verification',
     },
     env: 'production',
-    execAfterInit: 'npm run docs:bootstrap',
+    execAfterInit: 'pnpm run docs:bootstrap',
     filter: {
       maxLimit: null,
     },

package/src/core/common/interfaces/server-options.interface.ts

@@ -1099,28 +1099,32 @@ export interface IServerOptions {
    * Configuration of the GraphQL module
    * see https://docs.nestjs.com/graphql/quick-start
    * and https://www.apollographql.com/docs/apollo-server/api/apollo-server/
+   *
+   * Set to `false` to completely disable GraphQL (no GraphQLModule, no /graphql endpoint).
    */
-  graphQl?: {
-    /**
-     * Driver configuration for Apollo
-     */
-    driver?: ApolloDriverConfig;
+  graphQl?:
+    | false
+    | {
+        /**
+         * Driver configuration for Apollo
+         */
+        driver?: ApolloDriverConfig;
 
-    /**
-     * Subscription authentication
-     */
-    enableSubscriptionAuth?: boolean;
+        /**
+         * Subscription authentication
+         */
+        enableSubscriptionAuth?: boolean;
 
-    /**
-     * Maximum complexity of GraphQL requests
-     */
-    maxComplexity?: number;
+        /**
+         * Maximum complexity of GraphQL requests
+         */
+        maxComplexity?: number;
 
-    /**
-     * Module options (forRootAsync)
-     */
-    options?: GqlModuleAsyncOptions;
-  };
+        /**
+         * Module options (forRootAsync)
+         */
+        options?: GqlModuleAsyncOptions;
+      };
 
   /**
    * Whether to activate health check endpoints

package/src/core.module.ts

@@ -42,11 +42,15 @@ import { CoreSystemSetupModule } from './core/modules/system-setup/core-system-s
 @Global()
 @Module({})
 export class CoreModule implements NestModule {
+  private static graphQlEnabled = true;
+
   /**
    * Integrate middleware, e.g. GraphQL upload handing for express
    */
   configure(consumer: MiddlewareConsumer) {
-    consumer.apply(graphqlUploadExpress()).forRoutes('graphql');
+    if (CoreModule.graphQlEnabled) {
+      consumer.apply(graphqlUploadExpress()).forRoutes('graphql');
+    }
   }
 
   /**
@@ -138,24 +142,35 @@ export class CoreModule implements NestModule {
       };
     }
 
+    // Determine if GraphQL is enabled (false means explicitly disabled)
+    const isGraphQlEnabled = options.graphQl !== false;
+    CoreModule.graphQlEnabled = isGraphQlEnabled;
+
     // Check if autoRegister: false for IAM-only mode (project imports its own BetterAuth module)
     const rawBetterAuth = options?.betterAuth;
     const isAutoRegisterDisabledEarly = typeof rawBetterAuth === 'object' && rawBetterAuth?.autoRegister === false;
 
-    // Build GraphQL driver configuration based on auth mode
-    const graphQlDriverConfig = isIamOnlyMode
-      ? isAutoRegisterDisabledEarly
-        ? this.buildLazyIamGraphQlDriver(cors, options)
-        : this.buildIamOnlyGraphQlDriver(cors, options)
-      : this.buildLegacyGraphQlDriver(AuthService, AuthModule, cors, options);
+    // Build GraphQL driver configuration based on auth mode (only if GraphQL is enabled)
+    let graphQlDriverConfig = {};
+    if (isGraphQlEnabled) {
+      graphQlDriverConfig = isIamOnlyMode
+        ? isAutoRegisterDisabledEarly
+          ? this.buildLazyIamGraphQlDriver(cors, options)
+          : this.buildIamOnlyGraphQlDriver(cors, options)
+        : this.buildLegacyGraphQlDriver(AuthService, AuthModule, cors, options);
+    }
 
     const config: IServerOptions = merge(
       {
         env: 'develop',
-        graphQl: {
-          driver: graphQlDriverConfig,
-          enableSubscriptionAuth: true,
-        },
+        ...(isGraphQlEnabled
+          ? {
+              graphQl: {
+                driver: graphQlDriverConfig,
+                enableSubscriptionAuth: true,
+              },
+            }
+          : {}),
         mongoose: {
           options: {
             connectionFactory: (connection) => {
@@ -190,8 +205,8 @@ export class CoreModule implements NestModule {
       MailjetService,
     ];
 
-    // Add ComplexityPlugin only if not in Vitest (Vitest has dual GraphQL loading issue)
-    if (!process.env.VITEST) {
+    // Add ComplexityPlugin only if not in Vitest (Vitest has dual GraphQL loading issue) and GraphQL is enabled
+    if (!process.env.VITEST && isGraphQlEnabled) {
       providers.push(ComplexityPlugin);
     }
 
@@ -228,12 +243,15 @@ export class CoreModule implements NestModule {
     // and: https://mongoosejs.com/docs/guide.html#strictQuery
     mongoose.set('strictQuery', config.mongoose.strictQuery || false);
 
-    const imports: any[] = [
-      MongooseModule.forRoot(config.mongoose.uri, config.mongoose.options),
-      GraphQLModule.forRootAsync<ApolloDriverConfig>(
-        Object.assign({ driver: ApolloDriver }, config.graphQl.driver, config.graphQl.options),
-      ),
-    ];
+    const imports: any[] = [MongooseModule.forRoot(config.mongoose.uri, config.mongoose.options)];
+
+    if (isGraphQlEnabled && config.graphQl) {
+      imports.push(
+        GraphQLModule.forRootAsync<ApolloDriverConfig>(
+          Object.assign({ driver: ApolloDriver }, config.graphQl.driver, config.graphQl.options),
+        ),
+      );
+    }
 
     // Add ErrorCodeModule based on configuration
     // autoRegister defaults to true (backward compatible)
@@ -311,7 +329,7 @@ export class CoreModule implements NestModule {
 
     // Set exports
     const exports: any[] = [ConfigService, EmailService, TemplateService, MailjetService];
-    if (!process.env.VITEST) {
+    if (!process.env.VITEST && isGraphQlEnabled) {
       exports.push(ComplexityPlugin);
     }
 
@@ -335,6 +353,8 @@ export class CoreModule implements NestModule {
    * This is the recommended mode for new projects.
    */
   private static buildIamOnlyGraphQlDriver(cors: object, options: Partial<IServerOptions>) {
+    // This method is only called when graphQl !== false, extract config with type narrowing
+    const graphQlOpts = typeof options?.graphQl === 'object' ? options.graphQl : undefined;
     return {
       imports: [CoreBetterAuthModule],
       inject: [CoreBetterAuthService, CoreBetterAuthUserMapper],
@@ -350,7 +370,7 @@ export class CoreModule implements NestModule {
                 context: ({ extra }) => extra,
                 onConnect: async (context: Context<any>) => {
                   const { connectionParams, extra } = context;
-                  const enableAuth = options?.graphQl?.enableSubscriptionAuth ?? true;
+                  const enableAuth = graphQlOpts?.enableSubscriptionAuth ?? true;
 
                   if (enableAuth) {
                     // Get headers from raw headers or connection params
@@ -385,7 +405,7 @@ export class CoreModule implements NestModule {
               },
               'subscriptions-transport-ws': {
                 onConnect: async (connectionParams) => {
-                  const enableAuth = options?.graphQl?.enableSubscriptionAuth ?? true;
+                  const enableAuth = graphQlOpts?.enableSubscriptionAuth ?? true;
 
                   if (enableAuth) {
                     const authToken: string = connectionParams?.Authorization?.split(' ')[1];
@@ -415,7 +435,7 @@ export class CoreModule implements NestModule {
               },
             },
           },
-          options?.graphQl?.driver,
+          graphQlOpts?.driver,
         ),
     };
   }
@@ -430,6 +450,8 @@ export class CoreModule implements NestModule {
    * which happens after all modules are initialized.
    */
   private static buildLazyIamGraphQlDriver(cors: object, options: Partial<IServerOptions>) {
+    // This method is only called when graphQl !== false, extract config with type narrowing
+    const graphQlOpts = typeof options?.graphQl === 'object' ? options.graphQl : undefined;
     return {
       useFactory: async () =>
         Object.assign(
@@ -443,7 +465,7 @@ export class CoreModule implements NestModule {
                 context: ({ extra }) => extra,
                 onConnect: async (context: Context<any>) => {
                   const { connectionParams, extra } = context;
-                  const enableAuth = options?.graphQl?.enableSubscriptionAuth ?? true;
+                  const enableAuth = graphQlOpts?.enableSubscriptionAuth ?? true;
 
                   if (enableAuth) {
                     const betterAuthService = CoreBetterAuthModule.getServiceInstance();
@@ -482,7 +504,7 @@ export class CoreModule implements NestModule {
               },
               'subscriptions-transport-ws': {
                 onConnect: async (connectionParams) => {
-                  const enableAuth = options?.graphQl?.enableSubscriptionAuth ?? true;
+                  const enableAuth = graphQlOpts?.enableSubscriptionAuth ?? true;
 
                   if (enableAuth) {
                     const betterAuthService = CoreBetterAuthModule.getServiceInstance();
@@ -517,7 +539,7 @@ export class CoreModule implements NestModule {
               },
             },
           },
-          options?.graphQl?.driver,
+          graphQlOpts?.driver,
         ),
     };
   }
@@ -536,8 +558,9 @@ export class CoreModule implements NestModule {
     cors: object,
     options: Partial<IServerOptions>,
   ) {
-    // Store config reference for use in callbacks
-    const enableSubscriptionAuth = options?.graphQl?.enableSubscriptionAuth ?? true;
+    // This method is only called when graphQl !== false, extract config with type narrowing
+    const graphQlOpts = typeof options?.graphQl === 'object' ? options.graphQl : undefined;
+    const enableSubscriptionAuth = graphQlOpts?.enableSubscriptionAuth ?? true;
 
     return {
       imports: [AuthModule],
@@ -599,7 +622,7 @@ export class CoreModule implements NestModule {
               },
             },
           },
-          options?.graphQl?.driver,
+          graphQlOpts?.driver,
         ),
     };
   }