@bhooai/nexus-core 2.0.19 → 2.0.21

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@bhooai/nexus-core",
-    "version": "2.0.19",
+    "version": "2.0.21",
     "publishConfig": {
         "access": "public"
     },

package/src/app/createNexusApp.ts

@@ -20,7 +20,7 @@ import { Container } from '../di/Container.js';
 import { Router } from '../http/Router.js';
 import { NexusServer } from '../http/Server.js';
 import { bodyParser } from '../http/bodyParser.js';
-import type { Handler, Middleware } from '../http/context.js';
+import type { Handler, Middleware, RequestContext } from '../http/context.js';
 import { discoverBackend, importDefault, type DiscoveryResult } from './discover.js';
 import type { RoutesFile, RouteDef } from './defineRoutes.js';
 import { DefaultErrorHandler, ErrorHandler } from './ErrorHandler.js';
@@ -42,9 +42,36 @@ import { registerAuthRoutes } from './authModule.js';
 import { issueCsrfToken, getCsrfToken, csrf, authToken, requireRole } from '@bhooai/nexus-auth';
 import { connect } from '@bhooai/nexus-data';
 import { ensureLicense } from '@bhooai/nexus-crypto';
-import { createGateway, createFederatedGateway, graphqlHttpHandler, getExplorerHtml, helloSubgraph, SubscriptionServer } from '@bhooai/nexus-graphql';
 import type { Subgraph, GraphQLContext } from '@bhooai/nexus-graphql';
 
+/**
+ * Lazily loaded `@bhooai/nexus-graphql` — an optional peer, not a hard
+ * dependency. Static-importing it here would make merely *loading*
+ * `@bhooai/nexus-core` (e.g. `nexus init`, which never serves GraphQL)
+ * crash when the peer isn't installed. Call sites `await graphqlApi()`
+ * instead; null means "not installed" and the gateway mount is skipped
+ * with a warning.
+ *
+ * Typed as `any` (not `typeof import(...)`) so the emitted declarations
+ * don't require the peer's types to be present for consumers.
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+let _graphqlApi: any = undefined;
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+async function graphqlApi(): Promise<any> {
+  if (_graphqlApi !== undefined) return _graphqlApi;
+  try {
+    _graphqlApi = await import('@bhooai/nexus-graphql');
+  } catch (e) {
+    if ((e as { code?: string })?.code === 'ERR_MODULE_NOT_FOUND') {
+      _graphqlApi = null;
+    } else {
+      throw e;
+    }
+  }
+  return _graphqlApi;
+}
+
 export interface CreateNexusAppOptions {
   /** Identifier for this backend, used in admin, telemetry, logs. */
   name?: string;
@@ -368,8 +395,16 @@ export async function createNexusApp(opts: CreateNexusAppOptions = {}): Promise<
   let graphqlMounted = false;
   // eslint-disable-next-line @typescript-eslint/no-explicit-any
   let graphqlGateway: any = null;
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  let GraphqlSubscriptionServer: any = null;
   if (tech === 'react') {
   {
+    const gql = await graphqlApi();
+    if (!gql) {
+      console.warn(`[${name}] @bhooai/nexus-graphql is not installed — GraphQL gateway skipped (npm i @bhooai/nexus-graphql to enable).`);
+    } else {
+    const { createGateway, createFederatedGateway, graphqlHttpHandler, getExplorerHtml, helloSubgraph, SubscriptionServer } = gql;
+    GraphqlSubscriptionServer = SubscriptionServer;
     const explorerEnabled = (config.graphql as unknown as { explorer?: boolean })?.explorer ?? true;
     const helloEnabled = (config.graphql as unknown as { hello?: boolean })?.hello !== false;
     try {
@@ -415,7 +450,7 @@ export async function createNexusApp(opts: CreateNexusAppOptions = {}): Promise<
           gateway,
           introspection: config.graphql?.introspection ?? true,
           requireMutationCsrf: config.graphql?.requireMutationCsrf ?? true,
-          context: (ctx) => ({ request: ctx, user: (ctx.state.user as GraphQLContext['user']), config: ctx.config ?? config, ...opts.graphqlContext }),
+          context: (ctx: RequestContext) => ({ request: ctx, user: (ctx.state.user as GraphQLContext['user']), config: ctx.config ?? config, ...opts.graphqlContext }),
         });
         if (explorerEnabled) {
           const explorerHtml = getExplorerHtml({
@@ -462,7 +497,7 @@ export async function createNexusApp(opts: CreateNexusAppOptions = {}): Promise<
         if (helloEnabled) {
           // hello is available even in fallback — route through its gateway
           const gw = createGateway({ subgraph: helloSubgraph });
-          const h = graphqlHttpHandler({ gateway: gw, introspection: config.graphql?.introspection ?? true, requireMutationCsrf: config.graphql?.requireMutationCsrf ?? true, context: (ctx) => ({ request: ctx, user: (ctx.state.user as GraphQLContext['user']), config: ctx.config ?? config, ...opts.graphqlContext }) });
+          const h = graphqlHttpHandler({ gateway: gw, introspection: config.graphql?.introspection ?? true, requireMutationCsrf: config.graphql?.requireMutationCsrf ?? true, context: (ctx: RequestContext) => ({ request: ctx, user: (ctx.state.user as GraphQLContext['user']), config: ctx.config ?? config, ...opts.graphqlContext }) });
           return h(ctx);
         }
         ctx.json({ errors: [{ message: 'No GraphQL subgraph found. Add one with: npx nexus make:subgraph <name>  (then restart)' }] }, 404);
@@ -472,7 +507,7 @@ export async function createNexusApp(opts: CreateNexusAppOptions = {}): Promise<
       try {
         if (helloEnabled) {
           const gw = createGateway({ subgraph: helloSubgraph });
-          router.add('POST', graphqlPath, graphqlHttpHandler({ gateway: gw, introspection: config.graphql?.introspection ?? true, requireMutationCsrf: config.graphql?.requireMutationCsrf ?? true, context: (ctx) => ({ request: ctx, user: (ctx.state.user as GraphQLContext['user']), config: ctx.config ?? config, ...opts.graphqlContext }) }));
+          router.add('POST', graphqlPath, graphqlHttpHandler({ gateway: gw, introspection: config.graphql?.introspection ?? true, requireMutationCsrf: config.graphql?.requireMutationCsrf ?? true, context: (ctx: RequestContext) => ({ request: ctx, user: (ctx.state.user as GraphQLContext['user']), config: ctx.config ?? config, ...opts.graphqlContext }) }));
         } else {
           router.add('POST', graphqlPath, async (ctx) => ctx.json({ errors: [{ message: 'No GraphQL subgraph found. Add one with: npx nexus make:subgraph <name>' }] }, 404));
         }
@@ -482,6 +517,7 @@ export async function createNexusApp(opts: CreateNexusAppOptions = {}): Promise<
     }
   }
   }
+}
 
   // ------------------------------------------------------------------
   // Admin module — request log buffer, lazy DB, admin + AI proxy routes
@@ -737,10 +773,10 @@ export async function createNexusApp(opts: CreateNexusAppOptions = {}): Promise<
   // and config.graphql.subscriptions is enabled.
   // ------------------------------------------------------------------
   const graphqlSubscriptions = (config.graphql as unknown as { subscriptions?: boolean })?.subscriptions ?? true;
-  if (graphqlGateway && graphqlSubscriptions && typeof graphqlGateway.subscribe === 'function') {
+  if (graphqlGateway && GraphqlSubscriptionServer && graphqlSubscriptions && typeof graphqlGateway.subscribe === 'function') {
     try {
       const subPath = `${config.graphql?.path ?? '/graphql'}/ws`;
-      new SubscriptionServer({ httpServer: server.httpServer, gateway: graphqlGateway, path: subPath });
+      new GraphqlSubscriptionServer({ httpServer: server.httpServer, gateway: graphqlGateway, path: subPath });
       console.log(`[${name}] GraphQL subscriptions mounted at ${subPath}`);
     } catch (err) {
       console.warn(`[${name}] failed to mount GraphQL subscriptions:`, err);