npm - @bhooai/nexus-cli - Versions diffs - 0.1.0 - Mend

@bhooai/nexus-cli 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (75) hide show

package/PLAN.md +141 -0
package/README.md +34 -0
package/package.json +25 -0
package/src/commands/cluster.ts +133 -0
package/src/commands/dev.ts +133 -0
package/src/commands/doctor.ts +199 -0
package/src/commands/init.ts +960 -0
package/src/commands/node.ts +101 -0
package/src/commands/pysetup.ts +136 -0
package/src/commands/sync.ts +116 -0
package/src/commands/uninstall.ts +287 -0
package/src/config-sync.ts +384 -0
package/src/dotenv.ts +39 -0
package/src/index.ts +94 -0
package/src/supervisor.ts +384 -0
package/src/util.ts +123 -0
package/src/wizard.ts +149 -0
package/templates/Dockerfile +60 -0
package/templates/README.md +69 -0
package/templates/apps/admin/index.html +12 -0
package/templates/apps/admin/package.json +24 -0
package/templates/apps/admin/postcss.config.js +6 -0
package/templates/apps/admin/src/main.tsx +10 -0
package/templates/apps/admin/src/vite-env.d.ts +18 -0
package/templates/apps/admin/tailwind.config.js +9 -0
package/templates/apps/admin/tsconfig.json +17 -0
package/templates/apps/admin/vite.config.ts +64 -0
package/templates/apps/ai-server/main.py +43 -0
package/templates/apps/ai-server/providers/__init__.py +3 -0
package/templates/apps/ai-server/providers/base.py +111 -0
package/templates/apps/ai-server/requirements.txt +3 -0
package/templates/apps/ai-server/routers/__init__.py +3 -0
package/templates/apps/ai-server/routers/chat.py +47 -0
package/templates/apps/ai-server/routers/embeddings.py +30 -0
package/templates/apps/ai-server/routers/lint.py +167 -0
package/templates/apps/ai-server/routers/models.py +23 -0
package/templates/apps/ai-server/routers/preflight.py +169 -0
package/templates/apps/ai-server/settings.py +48 -0
package/templates/apps/backend/package.json +33 -0
package/templates/apps/backend/src/main.ts +375 -0
package/templates/apps/backend/src/modules/admin/adminRoutes.ts +732 -0
package/templates/apps/backend/src/modules/admin/clusterRoutes.ts +391 -0
package/templates/apps/backend/src/modules/admin/databaseRoutes.ts +161 -0
package/templates/apps/backend/src/modules/admin/lintProxy.ts +89 -0
package/templates/apps/backend/src/modules/admin/preflightProxy.ts +242 -0
package/templates/apps/backend/src/modules/admin/roleCatalog.ts +78 -0
package/templates/apps/backend/src/modules/admin/schemaRoutes.ts +449 -0
package/templates/apps/backend/src/modules/ai/aiProxy.ts +265 -0
package/templates/apps/backend/src/modules/auth/authRoutes.ts +220 -0
package/templates/apps/backend/src/modules/payments/paymentRoutes.ts +100 -0
package/templates/apps/backend/src/modules/payments/paymentStore.ts +172 -0
package/templates/apps/backend/src/modules/requests/requestLog.ts +175 -0
package/templates/apps/backend/src/modules/users/userGraph.ts +83 -0
package/templates/apps/backend/src/modules/users/userModel.ts +88 -0
package/templates/apps/backend/src/plugins/CronScheduler.ts +69 -0
package/templates/apps/backend/src/plugins/loadPlugins.ts +107 -0
package/templates/apps/backend/tsconfig.json +14 -0
package/templates/apps/frontend/index.html +12 -0
package/templates/apps/frontend/package.json +19 -0
package/templates/apps/frontend/src/main.tsx +64 -0
package/templates/apps/frontend/vite.config.ts +63 -0
package/templates/bin/nexus.js +35 -0
package/templates/bin/serve-all.mjs +45 -0
package/templates/dockerignore +15 -0
package/templates/gitignore +12 -0
package/templates/nexus.config.ts +69 -0
package/templates/package.json +47 -0
package/templates/tsconfig.json +17 -0
package/templates/uploads/.gitkeep +0 -0
package/tests/cli.test.ts +45 -0
package/tests/config-sync.test.ts +201 -0
package/tests/dotenv.test.ts +51 -0
package/tsconfig.json +9 -0
package/vitest.config.ts +9 -0
package/vitest.config.ts.timestamp-1786095205351-444061f6ff5c58.mjs +13 -0

package/templates/apps/backend/tsconfig.json ADDED Viewed

@@ -0,0 +1,14 @@
+{
+  "extends": "../../tsconfig.json",
+  "compilerOptions": {
+    "rootDir": "src",
+    "outDir": "dist",
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "target": "ES2022",
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "types": ["node"]
+  },
+  "include": ["src"]
+}

package/templates/apps/frontend/index.html ADDED Viewed

@@ -0,0 +1,12 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>My Nexus App</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html>

package/templates/apps/frontend/package.json ADDED Viewed

@@ -0,0 +1,19 @@
+{
+  "name": "my-nexus-frontend",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "vite",
+    "build": "vite build",
+    "preview": "vite preview"
+  },
+  "dependencies": {
+    "react": "^18.3.0",
+    "react-dom": "^18.3.0"
+  },
+  "devDependencies": {
+    "@vitejs/plugin-react": "^4.3.0",
+    "typescript": "^5.6.0",
+    "vite": "^5.4.0"
+  }
+}

package/templates/apps/frontend/src/main.tsx ADDED Viewed

@@ -0,0 +1,64 @@
+import React from 'react';
+import { createRoot } from 'react-dom/client';
+// Generated placeholder frontend. The framework's own apps/frontend has the full
+// auth / GraphQL / streaming / checkout UI — copy what you need from there.
+async function pingHealth() {
+  try {
+    const res = await fetch('/health');
+    const body = await res.json();
+    document.getElementById('status')!.textContent = `${body.status} @ ${new Date(body.time).toLocaleTimeString()}`;
+  } catch {
+    document.getElementById('status')!.textContent = 'backend not reachable';
+  }
+}
+function App() {
+  const [file, setFile] = React.useState<File | null>(null);
+  const [uploadStatus, setUploadStatus] = React.useState('');
+  React.useEffect(() => {
+    pingHealth();
+    const id = setInterval(pingHealth, 5000);
+    return () => clearInterval(id);
+  }, []);
+  async function uploadFile() {
+    if (!file) return;
+    setUploadStatus('uploading...');
+    try {
+      const csrfResponse = await fetch('/csrf-token', { credentials: 'include' });
+      const { token } = await csrfResponse.json() as { token: string };
+      const form = new FormData();
+      form.append('file', file);
+      const response = await fetch('/uploads', {
+        method: 'POST',
+        body: form,
+        credentials: 'include',
+        headers: { 'x-csrf-token': token },
+      });
+      const body = await response.json() as { files?: Array<{ url: string }>; error?: { message?: string } };
+      if (!response.ok) throw new Error(body.error?.message ?? 'upload failed');
+      setUploadStatus(`uploaded: ${body.files?.[0]?.url ?? 'ok'}`);
+    } catch (error) {
+      setUploadStatus(error instanceof Error ? error.message : 'upload failed');
+    }
+  }
+  return (
+    <main style={{ fontFamily: 'system-ui, sans-serif', padding: '2rem' }}>
+      <h1>My Nexus App</h1>
+      <p>Backend health: <span id="status">checking…</span></p>
+      <h2>Upload a file</h2>
+      <input type="file" onChange={(event) => setFile(event.target.files?.[0] ?? null)} />
+      <button type="button" onClick={uploadFile} disabled={!file}>Upload</button>
+      <p>{uploadStatus}</p>
+    </main>
+  );
+}
+createRoot(document.getElementById('root')!).render(
+  <React.StrictMode>
+    <App />
+  </React.StrictMode>,
+);

package/templates/apps/frontend/vite.config.ts ADDED Viewed

@@ -0,0 +1,63 @@
+import { defineConfig } from 'vite';
+import react from '@vitejs/plugin-react';
+import { existsSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+import { fileURLToPath, pathToFileURL } from 'node:url';
+const PROJECT_ROOT = resolve(dirname(fileURLToPath(import.meta.url)), '..', '..');
+// Read the merged host/port values from the project's single nexus config file
+// (ts/js/mjs/cjs, discovery order matches the backend loader) plus NEXUS_*
+// env overrides, so this Vite dev server and its proxy stay in one source of
+// truth: nexus.config.js.
+async function loadConfig() {
+  const exts = ['ts', 'js', 'mjs', 'cjs'];
+  let user: Record<string, any> = {};
+  for (const ext of exts) {
+    const file = join(PROJECT_ROOT, `nexus.config.${ext}`);
+    if (existsSync(file)) {
+      const mod = (await import(pathToFileURL(file).href + `?v=${Date.now()}`)) as Record<string, any>;
+      user = mod.default ?? mod.config ?? {};
+      break;
+    }
+  }
+  const num = (v: string | undefined, fallback: number) => (v !== undefined && Number.isFinite(Number(v)) ? Number(v) : fallback);
+  const str = (v: string | undefined, fallback: string) => (v !== undefined && v !== '' ? v : fallback);
+  return {
+    server: {
+      host: str(process.env.NEXUS_SERVER_HOST, user.server?.host ?? '0.0.0.0'),
+      port: num(process.env.NEXUS_SERVER_PORT, user.server?.port ?? 4000),
+    },
+    frontend: {
+      host: str(process.env.NEXUS_FRONTEND_HOST, user.frontend?.host ?? 'localhost'),
+      port: num(process.env.NEXUS_FRONTEND_PORT, user.frontend?.port ?? 3000),
+      enabled: user.frontend?.enabled ?? true,
+    },
+  };
+}
+export default defineConfig(async () => {
+  const cfg = await loadConfig();
+  const backendHost = cfg.server.host === '0.0.0.0' || cfg.server.host === '::' ? '127.0.0.1' : cfg.server.host;
+  const backend = `http://${backendHost}:${cfg.server.port}`;
+  const backendWs = `ws://${backendHost}:${cfg.server.port}`;
+  return {
+    plugins: [react()],
+    server: {
+      port: cfg.frontend.port,
+      host: cfg.frontend.host,
+      proxy: {
+        '/health': { target: backend, changeOrigin: true },
+        '/auth': { target: backend, changeOrigin: true },
+        '/csrf-token': { target: backend, changeOrigin: true },
+        '/graphql': { target: backend, changeOrigin: true, ws: true },
+        '/ai': { target: backend, changeOrigin: true },
+        '/payments': { target: backend, changeOrigin: true },
+        '/uploads': { target: backend, changeOrigin: true },
+        '/ws': { target: backendWs, ws: true, changeOrigin: true },
+      },
+    },
+  };
+});

package/templates/bin/nexus.js ADDED Viewed

@@ -0,0 +1,35 @@
+#!/usr/bin/env node
+/**
+ * Generated Nexus CLI entry. Resolves the `@bhooai/nexus-cli` package and
+ * dispatches the command. The CLI package's main points at TypeScript source
+ * (run via tsx) so there is no build step; if a compiled dist is present it is
+ * used directly.
+ */
+import { existsSync } from 'node:fs';
+import { extname } from 'node:path';
+import { pathToFileURL } from 'node:url';
+import { createRequire } from 'node:module';
+const require = createRequire(import.meta.url);
+async function main() {
+  // Resolve the CLI through the installed package exports. In a freshly init'd
+  // project the CLI is vendored under packages/nexus-cli, so this resolves to
+  // the vendored TypeScript source (no junction into the framework required).
+  const cliEntry = require.resolve('@bhooai/nexus-cli');
+  let mod;
+  if (existsSync(cliEntry) && extname(cliEntry) === '.js') {
+    mod = await import(pathToFileURL(cliEntry).href);
+  } else {
+    const { tsImport } = await import('tsx/esm/api');
+    mod = await tsImport(pathToFileURL(cliEntry).href, import.meta.url);
+  }
+  const cmd = process.argv[2] ?? 'help';
+  const rest = process.argv.slice(3);
+  await mod.run(cmd, rest);
+}
+main().catch((err) => {
+  console.error(err?.stack ?? err);
+  process.exit(1);
+});

package/templates/bin/serve-all.mjs ADDED Viewed

@@ -0,0 +1,45 @@
+// Runs the whole Nexus stack in one process tree (used as the Docker CMD):
+//   backend  -> nexus node serve --role=backend --port=<NEXUS_NODE_PORT|7575>
+//               (cluster node agent on :7575 + backend role service)
+//   frontend -> vite preview on :3000          (built SPA, proxies API)
+//   admin    -> vite preview on :3001          (built admin SPA, proxies API)
+// Forwards signals / reaps children so `docker stop` shuts down cleanly.
+import { spawn } from 'node:child_process';
+import { join, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+const root = join(dirname(fileURLToPath(import.meta.url)), '..');
+const npm = process.platform === 'win32' ? 'npm.cmd' : 'npm';
+const node = process.execPath;
+const nodePort = process.env.NEXUS_NODE_PORT ?? '7575';
+const children = [];
+let shuttingDown = false;
+function run(name, cwd, cmd, args) {
+  const p = spawn(cmd, args, { cwd, stdio: ['ignore', 'inherit', 'inherit'], env: process.env });
+  children.push(p);
+  p.on('exit', (code) => {
+    if (shuttingDown) return;
+    console.error(`[serve-all] ${name} exited with code ${code ?? 1}`);
+    shutdown(code ?? 1);
+  });
+  p.on('error', (err) => {
+    if (shuttingDown) return;
+    console.error(`[serve-all] ${name} failed to start: ${err.message}`);
+    shutdown(1);
+  });
+}
+function shutdown(code) {
+  if (shuttingDown) return;
+  shuttingDown = true;
+  for (const c of children) c.kill('SIGTERM');
+  setTimeout(() => process.exit(code), 3000);
+}
+process.on('SIGINT', () => shutdown(0));
+process.on('SIGTERM', () => shutdown(0));
+run('backend', root, node, ['bin/nexus.js', 'node', 'serve', '--role=backend', `--port=${nodePort}`]);
+run('frontend', join(root, 'apps', 'frontend'), npm, ['run', 'preview', '--', '--host', '0.0.0.0', '--port', '3000']);
+run('admin', join(root, 'apps', 'admin'), npm, ['run', 'preview', '--', '--host', '0.0.0.0', '--port', '3001']);

package/templates/dockerignore ADDED Viewed

@@ -0,0 +1,15 @@
+node_modules/
+**/node_modules/
+dist/
+logs/
+*.log
+.env
+nexus.runtime.json
+.nexus-sync.json
+.git/
+.DS_Store
+README.md
+PROGRESS.md
+.dockerignore
+Dockerfile
+*.tsbuildinfo

package/templates/gitignore ADDED Viewed

@@ -0,0 +1,12 @@
+node_modules/
+dist/
+.env
+nexus.runtime.json
+.nexus-sync.json
+cluster.runtime.json
+logs/
+certs/
+uploads/*
+!uploads/.gitkeep
+__pycache__/
+.venv/

package/templates/nexus.config.ts ADDED Viewed

@@ -0,0 +1,69 @@
+import type { NexusConfig } from '@bhooai/nexus-core';
+/**
+ * THE single, human-edited config file for every server host/port.
+ *
+ * Precedence (low → high): code defaults < this file < nexus.runtime.json
+ * (admin, gitignored) < NEXUS_* env vars < CLI flags. Admin writes only
+ * `nexus.runtime.json`, so this file stays clean.
+ *
+ * The backend, MongoDB, Redis, the AI server, the frontend and admin Vite
+ * dev servers, and the node mesh all read their host/port from here. The
+ * Vite dev servers (apps/admin/vite.config.ts, apps/frontend/vite.config.ts)
+ * open the SAME file, so change host/port in ONE place.
+ */
+const config: Partial<NexusConfig> = {
+  env: 'development',
+  // The HTTP API server the browser/cluster proxy to.
+  server: { port: 4000, host: '0.0.0.0', https: false, trustProxy: false, bodyLimit: 12 * 1024 * 1024 },
+  // Vite dev server for the frontend — hosts guests visit.
+  frontend: { port: 3000, host: 'localhost', enabled: true },
+  // Python AI server (first /ai/* proxy hops to this).
+  ai: { serverUrl: 'http://localhost:8000', timeoutMs: 60_000, defaultProvider: 'auto', schemaModel: 'llama3:latest' },
+  // Vite dev server for the admin app.
+  admin: { port: 3001, host: 'localhost', enabled: true },
+  // Node mesh: set kind via —as=root|node at init (this file stays minimal).
+  cluster: { enabled: false, failOpenSingleNode: true, lbHost: '0.0.0.0', lbPort: 8080, nodeAgentHost: '0.0.0.0', nodeAgentPort: 7575, registryFile: 'cluster.runtime.json', token: '' },
+  // File uploads.
+  uploads: { dir: 'uploads', path: '/uploads', maxFileSize: 10 * 1024 * 1024, maxFiles: 20, allowedTypes: [] },
+  // MongoDB host/port/database.
+  db: { uri: 'mongodb://localhost:27017/acme-app', maxPoolSize: 10, autoIndex: true },
+  // Redis host/port.
+  redis: { url: 'redis://localhost:6379', keyPrefix: 'acme:' },
+  // GraphQL API server (first /graphql proxy hops to this).
+  graphql: { path: '/graphql', federation: 'in-process', subscriptions: true, introspection: true },
+  //Web Socket server for the browser/cluster proxy to.
+  ws: { path: '/ws', heartbeatMs: 30_000, requireCsrf: true },
+  auth: {
+    // JWT secret comes ONLY from NEXUS_AUTH_JWT_SECRET in .env — never here.
+    jwt: { accessTtl: 60 * 15, refreshTtl: 60 * 60 * 24 * 30 },
+    cookieName: 'nexus_sid',
+    refreshCookieName: 'nexus_rid',
+    requireEmailVerification: false,
+  },
+  payments: { webhookPath: '/payments/webhook/:provider', currency: 'INR',
+    razorpay: { enabled: false, sandbox: true },
+    paypal: { enabled: false, sandbox: true },
+    payu: { enabled: false, sandbox: true },
+    skrill: { enabled: false, sandbox: true },
+    payoneer: { enabled: false, sandbox: true },
+   },
+  email: { provider: 'log', from: 'no-reply@acme.local' },
+  // Certificates for HTTPS, WebRTC, etc.
+  certs: { dir: 'certs', keyType: 'rsa', rsaModulus: 2048, ecCurve: 'prime256v1', validityDays: 365 },
+  // Google Ads API (first /ads proxy hops to this).
+  ads: { enabled: false, developerToken: '', clientId: '', clientSecret: '', refreshToken: '', customerId: '' },
+  // WebRTC server (first /webrtc proxy hops to this).
+  webrtc: { rtcMinPort: 40000, rtcMaxPort: 40100, announceIp: '127.0.0.1' },
+  // Logging and plugins.
+  logging: { level: 'info', format: 'pretty', console: true, dir: 'logs', maxFileSize: 10 * 1024 * 1024, maxFiles: 7 },
+  plugins: { dir: 'plugins', entries: [] },
+};
+export default config;

package/templates/package.json ADDED Viewed

@@ -0,0 +1,47 @@
+{
+  "name": "my-nexus-app",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "workspaces": [
+    "../bhooai-nexus/packages/*",
+    "apps/backend",
+    "apps/admin",
+    "apps/frontend"
+  ],
+  "scripts": {
+    "init": "nexus init .",
+    "dev": "nexus dev",
+    "build": "nexus build",
+    "test": "nexus test",
+    "doctor": "nexus doctor",
+    "pysetup": "nexus pysetup",
+    "uninstall": "nexus uninstall",
+    "start": "tsx apps/backend/src/main.ts"
+  },
+  "dependencies": {
+    "bhooai-nexus": "file:../bhooai-nexus",
+    "@bhooai/admin": "*",
+    "@bhooai/nexus-cli": "*",
+    "@bhooai/nexus-core": "*",
+    "@bhooai/nexus-auth": "*",
+    "@bhooai/nexus-data": "*",
+    "@bhooai/nexus-telemetry": "*",
+    "@bhooai/nexus-realtime": "*",
+    "@bhooai/nexus-graphql": "*",
+    "@bhooai/nexus-cache": "*",
+    "@bhooai/nexus-email": "*",
+    "@bhooai/nexus-payments": "*",
+    "@bhooai/nexus-crypto": "*",
+    "@bhooai/nexus-cluster": "*",
+    "@bhooai/nexus-ads": "*",
+    "@bhooai/nexus-plugins": "*",
+    "@bhooai/nexus-ai-client": "*"
+  },
+  "devDependencies": {
+    "tsx": "^4.19.0",
+    "typescript": "^5.6.0",
+    "@types/node": "^22.0.0",
+    "vitest": "^2.1.0"
+  }
+}

package/templates/tsconfig.json ADDED Viewed

@@ -0,0 +1,17 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "lib": ["ES2022", "DOM"],
+    "jsx": "react-jsx",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "resolveJsonModule": true,
+    "allowImportingTsExtensions": true,
+    "noEmit": true,
+    "types": ["node"]
+  },
+  "include": ["apps/**/*", "nexus.config.ts"]
+}

package/templates/uploads/.gitkeep ADDED Viewed

File without changes

package/tests/cli.test.ts ADDED Viewed

@@ -0,0 +1,45 @@
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import { run } from '../src/index.js';
+import { mkdtempSync, rmSync, existsSync, readFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+describe('CLI dispatcher', () => {
+  it('prints help and exits 0', async () => {
+    const code = await run('help', []);
+    expect(code).toBe(0);
+  });
+  it('returns 1 for an unknown command', async () => {
+    const code = await run('nope', []);
+    expect(code).toBe(1);
+  });
+});
+describe('CLI init', () => {
+  let dir: string;
+  beforeEach(() => {
+    dir = mkdtempSync(join(tmpdir(), 'nexus-cli-'));
+  });
+  afterEach(() => {
+    rmSync(dir, { recursive: true, force: true });
+  });
+  it('scaffolds the four-terminal tree', async () => {
+    const code = await run('init', [dir, '--skip-install']);
+    expect(code).toBe(0);
+    expect(existsSync(join(dir, 'nexus.config.ts'))).toBe(true);
+    expect(existsSync(join(dir, 'apps/backend/src/main.ts'))).toBe(true);
+    expect(existsSync(join(dir, 'apps/frontend/src/main.tsx'))).toBe(true);
+    expect(existsSync(join(dir, 'apps/ai-server/main.py'))).toBe(true);
+    expect(existsSync(join(dir, 'apps/admin/src/main.tsx'))).toBe(true);
+  });
+  it('is idempotent (skips existing files without --force)', async () => {
+    await run('init', [dir, '--skip-install']);
+    const code = await run('init', [dir, '--skip-install']);
+    expect(code).toBe(0);
+    const cfg = readFileSync(join(dir, 'nexus.config.ts'), 'utf8');
+    expect(cfg).toContain('NexusConfig');
+  });
+});