bhooai-nexus 3.0.6 → 3.0.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bhooai-nexus",
-  "version": "3.0.6",
+  "version": "3.0.7",
   "description": "BhooAI Nexus - a Node-based full-stack framework (websockets, GraphQL federation, inbuilt security, custom ODM, OAuth, payments, WebRTC, AI, plugins). v2: multi-app, Laravel-style folders, Docker-based scaling.",
   "license": "MIT",
   "author": "BhooAI - oravianando",
@@ -97,6 +97,7 @@
     "init": "node bin/nexus.js init",
     "doctor": "node bin/nexus.js doctor",
     "typecheck": "tsc --noEmit -p tsconfig.json",
+    "publish:packages": "node scripts/publish.mjs",
     "lint": "eslint \"packages/**/*.ts\" \"apps/**/*.{ts,tsx}\"",
     "format": "prettier --write ."
   },

package/packages/nexus-admin/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bhooai/nexus-admin",
-  "version": "2.0.18",
+  "version": "2.0.20",
   "description": "BhooAI Nexus v2 admin SPA — Apps-tab-first, live registry/health/logs/config/users/payments/AI",
   "type": "module",
   "license": "MIT",

package/packages/nexus-ads/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@bhooai/nexus-ads",
-    "version": "2.0.16",
+    "version": "2.0.18",
     "publishConfig": {
         "access": "public"
     },

package/packages/nexus-ai-client/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@bhooai/nexus-ai-client",
-    "version": "2.0.16",
+    "version": "2.0.18",
     "publishConfig": {
         "access": "public"
     },

package/packages/nexus-auth/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@bhooai/nexus-auth",
-    "version": "2.0.16",
+    "version": "2.0.18",
     "publishConfig": {
         "access": "public"
     },

package/packages/nexus-cache/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@bhooai/nexus-cache",
-    "version": "2.0.16",
+    "version": "2.0.18",
     "publishConfig": {
         "access": "public"
     },

package/packages/nexus-cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bhooai/nexus-cli",
-  "version": "2.0.18",
+  "version": "2.0.20",
   "description": "BhooAI Nexus v2 CLI — init, dev, build, test, scaffolding, plugins, queue, db.",
   "license": "MIT",
   "type": "module",
@@ -21,6 +21,7 @@
     "@bhooai/nexus-core": "^2.0.1",
     "@bhooai/nexus-crypto": "^2.0.1",
     "@bhooai/nexus-examples": "^2.0.1",
+    "mongodb": "^6.9.0",
     "tsx": "^4.19.0",
     "zod": "^3.23.8"
   },

package/packages/nexus-cli/src/browser.ts

@@ -7,8 +7,10 @@ import { spawn } from 'node:child_process';
 export function openBrowser(url: string): void {
   try {
     if (process.platform === 'win32') {
-      // `start` is a cmd builtin; the empty "" is the window title.
-      spawn('cmd', ['/c', 'start', '', url], { stdio: 'ignore', detached: true }).unref();
+      // `rundll32` receives the URL as a plain argv (no shell), so `&` in the
+      // query string is NOT treated as a command separator. `cmd /c start`
+      // would truncate at the first `&`, dropping state/code_challenge.
+      spawn('rundll32.exe', ['url.dll,FileProtocolHandler', url], { stdio: 'ignore', detached: true }).unref();
     } else if (process.platform === 'darwin') {
       spawn('open', [url], { stdio: 'ignore', detached: true }).unref();
     } else {

package/packages/nexus-cli/src/commands/dev.ts

@@ -12,7 +12,7 @@ import { join, dirname } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import type { CommandContext } from '../dispatcher.js';
 import { loadConfigAuto } from '@bhooai/nexus-core';
-import { ensureLicense } from '@bhooai/nexus-crypto';
+import { ensureLicense, resolveLicenseToken } from '@bhooai/nexus-crypto';
 import { resolveConfiguredPorts, findFreeShift, describePortHolder } from '../ports.js';
 import { ServiceManager, type ServiceSpec } from '../devServiceManager.js';
 import { startDevPanel } from '../devPanel.js';
@@ -31,12 +31,19 @@ export async function run(ctx: CommandContext): Promise<void> {
   // check fails we still start the services: the backend boots in a
   // license-error state and answers requests with 402 LICENSE_REQUIRED, so the
   // UI can show the error instead of a proxy 500.
+  // The console's "Add license" banner is offered ONLY when no license token
+  // exists at all (missing nexus/licence/licence.jwt and no NEXUS_LICENSE_KEY) —
+  // transient verify failures (offline authority, expired token, …) just warn.
+  let licenseError: string | null = null;
   try {
     await ensureLicense({ projectDir: projectRoot });
   } catch (err) {
-    console.warn(`⚠ License check failed: ${(err as Error).message}`);
+    licenseError = (err as Error).message;
+    console.warn(`⚠ License check failed: ${licenseError}`);
+    console.warn('  Run `nexus license add` to authorize this project.');
     console.warn('  Starting anyway — API requests will return 402 LICENSE_REQUIRED.');
   }
+  const licenseMissing = !resolveLicenseToken({ projectDir: projectRoot });
 
   const noPanel = !!ctx.args.flags['no-panel'];
   const isTty = Boolean(process.stdin.isTTY && process.stdout.isTTY);
@@ -47,6 +54,11 @@ export async function run(ctx: CommandContext): Promise<void> {
     return;
   }
 
+  // Expose the project root to every service so license resolution finds
+  // `<project>/nexus/licence/licence.jwt` even when an app's own projectRoot is a
+  // subfolder (e.g. apps/backend).
+  for (const s of specs) s.env = { ...(s.env ?? {}), NEXUS_PROJECT_ROOT: projectRoot };
+
   // Coordinated step-up: if any configured port is busy, shift the whole set
   // by the smallest delta that frees every port. nexus.config.ts stays
   // canonical — the shift is ephemeral for this run (NEXUS_PORT_STEP).
@@ -99,7 +111,7 @@ export async function run(ctx: CommandContext): Promise<void> {
   if (isTty && !noPanel) {
     // Full-screen Nexus Console.
     console.log(`nexus dev — ${specs.length} service(s). Opening console...\n`);
-    await startDevPanel({ services: manager, onQuit: teardown });
+    await startDevPanel({ services: manager, onQuit: teardown, licenseError: licenseMissing ? licenseError : null });
     return;
   }
 

package/packages/nexus-cli/src/commands/doctor.ts

@@ -1,5 +1,7 @@
 /**
  * nexus doctor — environment health check. Never hard-fails; reports issues.
+ * Renders a full-screen TUI on a TTY (with a live spinner) and plain text when
+ * piped. `nexus doctor` and the welcome launcher's "Environment check" both use it.
  */
 import { exec } from 'node:child_process';
 import { promisify } from 'node:util';
@@ -7,11 +9,22 @@ import { existsSync } from 'node:fs';
 import { resolve } from 'node:path';
 import { createConnection } from 'node:net';
 import type { CommandContext } from '../dispatcher.js';
+import { ANSI, Tui, isTty, getTermSize, type KeyInfo } from '../tui.js';
+import { fitCell } from '../layout.js';
 
 const execAsync = promisify(exec);
 
+export interface CheckResult {
+  name: string;
+  ok: boolean;
+  detail?: string;
+  /** Optional checks warn (•) but never count as failures. */
+  optional?: boolean;
+}
+
 interface Check {
   name: string;
+  optional?: boolean;
   run(): Promise<{ ok: boolean; detail?: string }>;
 }
 
@@ -39,11 +52,8 @@ async function tcpReachable(host: string, port: number, timeoutMs: number = 1000
   });
 }
 
-export async function run(_ctx: CommandContext): Promise<void> {
-  console.log('nexus doctor — environment check\n');
-
-  const projectRoot = process.cwd();
-  const checks: Check[] = [
+function buildChecks(projectRoot: string): Check[] {
+  return [
     {
       name: 'Node.js ≥ 20.10',
       run: async () => {
@@ -66,50 +76,151 @@ export async function run(_ctx: CommandContext): Promise<void> {
     },
     {
       name: 'Python (optional — for AI server)',
+      optional: true,
       run: async () => {
         const v = await cmdVersion('python', ['--version']);
-        return v ? { ok: true, detail: v } : { ok: false, detail: 'python not found (optional)' };
+        return v ? { ok: true, detail: v } : { ok: false, detail: 'python not found' };
       },
     },
     {
       name: 'Project layout (apps/backend)',
-      run: async () => ({
-        ok: existsSync(resolve(projectRoot, 'apps/backend')),
-        detail: existsSync(resolve(projectRoot, 'apps/backend')) ? 'found' : 'apps/backend missing',
-      }),
+      run: async () => {
+        const ok = existsSync(resolve(projectRoot, 'apps/backend'));
+        return { ok, detail: ok ? 'found' : 'apps/backend missing' };
+      },
     },
     {
       name: 'nexus.config.ts',
-      run: async () => ({
-        ok: existsSync(resolve(projectRoot, 'nexus.config.ts')),
-        detail: existsSync(resolve(projectRoot, 'nexus.config.ts')) ? 'found' : 'missing',
-      }),
+      run: async () => {
+        const ok = existsSync(resolve(projectRoot, 'nexus.config.ts'));
+        return { ok, detail: ok ? 'found' : 'missing' };
+      },
     },
     {
       name: 'MongoDB reachable (localhost:27017)',
-      run: async () => ({
-        ok: await tcpReachable('127.0.0.1', 27017),
-        detail: (await tcpReachable('127.0.0.1', 27017)) ? 'ok' : 'not reachable',
-      }),
+      run: async () => {
+        const ok = await tcpReachable('127.0.0.1', 27017);
+        return { ok, detail: ok ? 'ok' : 'not reachable' };
+      },
     },
     {
       name: 'Redis reachable (localhost:6379)',
-      run: async () => ({
-        ok: await tcpReachable('127.0.0.1', 6379),
-        detail: (await tcpReachable('127.0.0.1', 6379)) ? 'ok' : 'not reachable (optional)',
-      }),
+      optional: true,
+      run: async () => {
+        const ok = await tcpReachable('127.0.0.1', 6379);
+        return { ok, detail: ok ? 'ok' : 'not reachable' };
+      },
     },
   ];
+}
 
-  let failed = 0;
-  for (const check of checks) {
-    const result = await check.run().catch((e) => ({ ok: false, detail: String(e) }));
-    const icon = result.ok ? '✓' : '✗';
-    const detail = result.detail ? `  (${result.detail})` : '';
-    console.log(`${icon} ${check.name}${detail}`);
-    if (!result.ok) failed++;
+/** Run every check and return structured results. */
+export async function runChecks(projectRoot: string): Promise<CheckResult[]> {
+  const out: CheckResult[] = [];
+  for (const check of buildChecks(projectRoot)) {
+    const r = await check.run().catch((e) => ({ ok: false, detail: String(e) }));
+    out.push({ name: check.name, ok: r.ok, detail: r.detail, optional: check.optional });
   }
+  return out;
+}
+
+const SPINNER = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
+
+function statusIcon(r: CheckResult): string {
+  if (r.ok) return `${ANSI.green}✓${ANSI.reset}`;
+  return r.optional ? `${ANSI.yellow}•${ANSI.reset}` : `${ANSI.red}✗${ANSI.reset}`;
+}
 
+function renderResults(results: CheckResult[]): string[] {
+  const W = Math.min(getTermSize().cols - 4, 84);
+  const nameW = Math.min(Math.max(20, ...results.map((r) => r.name.length)) + 2, 46);
+  const lines: string[] = [
+    `${ANSI.bold}${ANSI.cyan}nexus doctor${ANSI.reset} ${ANSI.gray}— environment check${ANSI.reset}`,
+    `${ANSI.gray}${'─'.repeat(Math.max(W, 10))}${ANSI.reset}`,
+    '',
+  ];
+  for (const r of results) {
+    const detail = r.detail ? `  ${ANSI.gray}(${r.detail})${ANSI.reset}` : '';
+    lines.push(`  ${statusIcon(r)} ${fitCell(r.name, nameW)}${detail}`);
+  }
+  const failed = results.filter((r) => !r.ok && !r.optional).length;
+  const warned = results.filter((r) => !r.ok && r.optional).length;
+  lines.push('');
+  if (failed === 0) {
+    const extra = warned > 0 ? ` ${ANSI.gray}(${warned} optional unavailable)${ANSI.reset}` : '';
+    lines.push(`  ${ANSI.green}All checks passed.${ANSI.reset}${extra}`);
+  } else {
+    lines.push(`  ${ANSI.red}${failed} check(s) need attention.${ANSI.reset}`);
+  }
+  return lines;
+}
+
+/** Full-screen doctor TUI: spinner while running, `r` to rerun, `q` to close. */
+async function runDoctorTui(projectRoot: string): Promise<void> {
+  let results: CheckResult[] = [];
+  let running = true;
+  let spin = 0;
+  let timer: ReturnType<typeof setInterval> | null = null;
+
+  const render = (tui: Tui): void => {
+    const lines: string[] = [
+      `${ANSI.bold}${ANSI.cyan}nexus doctor${ANSI.reset} ${ANSI.gray}— environment check${ANSI.reset}`,
+      `${ANSI.gray}${'─'.repeat(Math.max(Math.min(getTermSize().cols - 4, 84), 10))}${ANSI.reset}`,
+      '',
+    ];
+    if (running) {
+      lines.push(`  ${ANSI.cyan}${SPINNER[spin % SPINNER.length]}${ANSI.reset} ${ANSI.gray}running checks…${ANSI.reset}`);
+    } else {
+      lines.push(...renderResults(results).slice(3));
+    }
+    const footer = `${ANSI.gray}${running ? 'please wait…' : 'r rerun · q close'}${ANSI.reset}`;
+    tui.draw(lines, footer);
+  };
+
+  const tui: Tui = new Tui((_str: string, key: KeyInfo) => {
+    if (key.name === 'q' || key.name === 'escape' || (key.name === 'c' && key.ctrl)) {
+      tui.quit = true;
+      return;
+    }
+    if (key.name === 'r' && !running) void refresh();
+  });
+
+  const refresh = async (): Promise<void> => {
+    running = true;
+    if (!timer) timer = setInterval(() => { spin++; render(tui); }, 90);
+    render(tui);
+    results = await runChecks(projectRoot);
+    running = false;
+    if (timer) { clearInterval(timer); timer = null; }
+    render(tui);
+  };
+
+  tui.enter();
+  const onResize = (): void => render(tui);
+  process.stdout.on('resize', onResize);
+  await refresh();
+  await tui.wait();
+  process.stdout.off('resize', onResize);
+  if (timer) clearInterval(timer);
+  tui.exit();
+}
+
+export async function run(_ctx: CommandContext): Promise<void> {
+  const projectRoot = process.cwd();
+
+  if (isTty()) {
+    await runDoctorTui(projectRoot);
+    return;
+  }
+
+  console.log('nexus doctor — environment check\n');
+  const results = await runChecks(projectRoot);
+  for (const r of results) {
+    const icon = r.ok ? '✓' : r.optional ? '•' : '✗';
+    const detail = r.detail ? `  (${r.detail})` : '';
+    console.log(`${icon} ${r.name}${detail}`);
+  }
+  const failed = results.filter((r) => !r.ok && !r.optional).length;
   console.log(failed === 0 ? '\nAll checks passed.' : `\n${failed} check(s) need attention.`);
 }
 

package/packages/nexus-cli/src/commands/init.ts

@@ -32,6 +32,7 @@ interface InitVars {
   name: string;
   nameSlug: string;
   jwtSecret: string;
+  dbActive: 'fusion' | 'mongodb';
   mongoUri: string;
   redisUrl: string;
   example: string;
@@ -41,6 +42,7 @@ interface InitVars {
   adminPort: number;
   aiPort: number;
   pyserverPort: number;
+  fusionPort: number;
   aiProviders: string[];
   /** Rendered `apps: [...]` block body (port layout) for nexus.config.ts. */
   appsBlock: string;
@@ -84,6 +86,7 @@ export async function run(ctx: CommandContext): Promise<void> {
     name,
     nameSlug: name,
     jwtSecret: randomSecret(32),
+    dbActive: (result as { dbActive?: 'fusion' | 'mongodb' }).dbActive ?? 'fusion',
     mongoUri: result.mongoUri,
     redisUrl: result.redisUrl,
     example: result.example,
@@ -93,6 +96,7 @@ export async function run(ctx: CommandContext): Promise<void> {
     adminPort: result.ports.admin,
     aiPort: result.ports.ai,
     pyserverPort: result.ports.pyserver,
+    fusionPort: result.ports.fusion,
     aiProviders: result.aiProviders,
     appsBlock: [
       `    { name: 'backend', port: ${result.ports.backend} },`,
@@ -100,6 +104,7 @@ export async function run(ctx: CommandContext): Promise<void> {
       ...(includeAdmin ? [`    { name: 'admin', port: ${result.ports.admin} },`] : []),
       ...(includeAi ? [`    { name: 'ai-server', port: ${result.ports.ai} },`] : []),
       `    { name: 'pyserver', port: ${result.ports.pyserver} },`,
+      `    { name: 'fusion', port: ${result.ports.fusion} },`,
     ].join('\n'),
   };
 
@@ -199,7 +204,7 @@ export async function run(ctx: CommandContext): Promise<void> {
   // 4. .env
   const envPath = join(targetDir, '.env');
   if (!existsSync(envPath)) {
-    await writeFile(envPath, buildEnvFile(vars), 'utf-8');
+    await writeFile(envPath, buildEnvFile(vars, devMode), 'utf-8');
   }
 
   // 4b. --dev: rewrite bhooai-nexus + @bhooai/* to local file: + live symlink
@@ -253,7 +258,9 @@ Ports allocated:
   ${frontendLine}
   Admin     : ${includeAdmin ? vars.adminPort : '(not included)'}
   AI server : ${includeAi ? vars.aiPort : '(not included)'}
- `);
+  PyServer  : ${vars.pyserverPort}
+  Fusion DB : ${vars.fusionPort}
+  `);
 
   // Ensure stdin is paused so Node can drain naturally after TUI exit (even on npm failure → exit to shell).
   try { process.stdin.pause(); } catch {}
@@ -439,7 +446,7 @@ async function ensureBackendFolderTree(backendDir: string): Promise<void> {
   }
 }
 
-function buildEnvFile(vars: InitVars): string {
+function buildEnvFile(vars: InitVars, dev = false): string {
   return `# BhooAI Nexus — generated .env
 # Secrets live here. Do not commit.
 
@@ -451,13 +458,20 @@ AI_PORT=${vars.aiPort}
 # Set this to the backend host when deploying to a VPS (default: localhost)
 # NEXUS_BACKEND_HOST=
 
-# Database
+# Database — Fusion is the default (embedded, zero-dep).
+# Set NEXUS_DB_ACTIVE=mongodb + NEXUS_DB_MONGODB_ENABLED=true to use Mongo.
+NEXUS_DB_ACTIVE=${vars.dbActive}
 NEXUS_DB_URI=${vars.mongoUri}
 NEXUS_REDIS_URL=${vars.redisUrl}
 
 # Auth
 NEXUS_AUTH_JWT_SECRET=${vars.jwtSecret}
 
+# License authority
+${dev
+  ? '# --dev: verify against the LOCAL authority (nexus-bhooai-com on :3000).\nNEXUS_LICENSE_SERVER=http://localhost:3000'
+  : '# Defaults to https://nexus.bhooai.com — override with NEXUS_LICENSE_SERVER.'}
+
 # AI (ollama is local by default; uncomment others as needed)
 NEXUS_AI_PROVIDER=ollama
 NEXUS_AI_MODEL=llama3.1:8b
@@ -469,6 +483,10 @@ ${vars.aiProviders.filter((p) => p !== 'ollama').map((p) => `# NEXUS_AI_${p.toUp
 PY_PORT=${vars.pyserverPort}
 NEXUS_IMAGES_URL=http://127.0.0.1:${vars.pyserverPort}
 
+# Fusion DB server (nexus dev service "fusion", port from nexus.config.ts apps[])
+FUSION_PORT=${vars.fusionPort}
+NEXUS_FUSION_URL=http://127.0.0.1:${vars.fusionPort}
+
 # Storage (uncomment for S3)
 # NEXUS_STORAGE_S3_BUCKET=
 # NEXUS_STORAGE_S3_REGION=