@nexus_js/cli 0.6.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Nexus Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,52 @@
+# Nexus CLI (`nexus`, `create-nexus`)
+
+Command-line tools for [Nexus](https://nexusjs.dev) — the full-stack web framework with islands architecture, Svelte 5 runes, and server actions.
+
+- **Documentation:** [https://nexusjs.dev](https://nexusjs.dev)  
+- **Repository:** [github.com/bierfor/nexus](https://github.com/bierfor/nexus)  
+- **Issues:** [github.com/bierfor/nexus/issues](https://github.com/bierfor/nexus/issues)
+
+## Install
+
+```bash
+pnpm add -D @nexus_js/cli
+# or
+npm install -D @nexus_js/cli
+```
+
+Global install (optional):
+
+```bash
+npm install -g @nexus_js/cli
+```
+
+## Commands
+
+| Command | Description |
+|--------|-------------|
+| `nexus dev` | Start the development server with HMR |
+| `nexus build` | Production build |
+| `nexus start` | Run the production server |
+| `nexus studio` | Open Nexus Studio (dev dashboard) |
+| `nexus routes` | Print the route manifest |
+| `nexus check` | TypeScript check |
+| `create-nexus <name>` | Scaffold a new project |
+
+## New project
+
+```bash
+npm exec --package=@nexus_js/cli@latest -- create-nexus my-app
+```
+
+Or install globally and run the `create-nexus` binary:
+
+```bash
+npm install -g @nexus_js/cli
+create-nexus my-app
+```
+
+See the [full documentation](https://nexusjs.dev) for configuration, routing, `.nx` components, and deployment.
+
+## License
+
+MIT © Nexus contributors

package/dist/add.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Nexus Marketplace — `nexus add <block>`
+ *
+ * Installs pre-built "Nexus Blocks": components, auth systems, DB schemas,
+ * and more — directly scaffolded into your project.
+ *
+ * Registry format (fetched from GitHub or local for offline):
+ *   blocks.json → { id, name, description, files: [{ path, content }] }
+ *
+ * Usage:
+ *   nexus add auth         → Full auth system (middleware + routes + actions)
+ *   nexus add pokecard     → Pre-styled island with Runes configured
+ *   nexus add analytics    → Privacy-first page-view tracker
+ *   nexus add rate-limit   → Edge rate limiter middleware
+ *   nexus add              → Interactive picker (lists available blocks)
+ */
+export interface NexusBlock {
+    id: string;
+    name: string;
+    category: 'auth' | 'ui' | 'data' | 'middleware' | 'analytics';
+    description: string;
+    tags: string[];
+    files: BlockFile[];
+    postInstall?: string;
+}
+interface BlockFile {
+    path: string;
+    content: string;
+}
+/** Entry point called by packages/cli/src/bin.ts */
+export declare function runAdd(opts: {
+    blockId?: string;
+    root: string;
+}): Promise<void>;
+export {};
+//# sourceMappingURL=add.d.ts.map

package/dist/add.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add.d.ts","sourceRoot":"","sources":["../src/add.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAcH,MAAM,WAAW,UAAU;IACzB,EAAE,EAAW,MAAM,CAAC;IACpB,IAAI,EAAS,MAAM,CAAC;IACpB,QAAQ,EAAK,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,YAAY,GAAG,WAAW,CAAC;IACjE,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAS,MAAM,EAAE,CAAC;IACtB,KAAK,EAAQ,SAAS,EAAE,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,UAAU,SAAS;IACjB,IAAI,EAAK,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAkUD,oDAAoD;AACpD,wBAAsB,MAAM,CAAC,IAAI,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAMpF"}

package/dist/add.js

@@ -0,0 +1,342 @@
+/**
+ * Nexus Marketplace — `nexus add <block>`
+ *
+ * Installs pre-built "Nexus Blocks": components, auth systems, DB schemas,
+ * and more — directly scaffolded into your project.
+ *
+ * Registry format (fetched from GitHub or local for offline):
+ *   blocks.json → { id, name, description, files: [{ path, content }] }
+ *
+ * Usage:
+ *   nexus add auth         → Full auth system (middleware + routes + actions)
+ *   nexus add pokecard     → Pre-styled island with Runes configured
+ *   nexus add analytics    → Privacy-first page-view tracker
+ *   nexus add rate-limit   → Edge rate limiter middleware
+ *   nexus add              → Interactive picker (lists available blocks)
+ */
+import { writeFile, mkdir } from 'node:fs/promises';
+import { join, dirname } from 'node:path';
+import { createInterface } from 'node:readline';
+const c = {
+    reset: '\x1b[0m', bold: '\x1b[1m', dim: '\x1b[2m',
+    red: '\x1b[31m', green: '\x1b[32m', yellow: '\x1b[33m',
+    mag: '\x1b[35m', cyan: '\x1b[36m', gray: '\x1b[90m',
+};
+// ── Built-in blocks ───────────────────────────────────────────────────────────
+const BLOCKS = [
+    {
+        id: 'auth',
+        name: 'Nexus Auth',
+        category: 'auth',
+        description: 'Full auth system: login/register routes + session middleware + Server Actions',
+        tags: ['authentication', 'sessions', 'middleware'],
+        postInstall: 'Set AUTH_SECRET in your .env file and run nexus build.',
+        files: [
+            {
+                path: 'src/lib/auth.ts',
+                content: `/**
+ * Nexus Auth — Server-side session helpers.
+ * Generated by: nexus add auth
+ */
+import type { NexusContext } from '@nexus_js/server';
+
+export interface Session {
+  userId:   string;
+  email:    string;
+  role:     'user' | 'admin';
+  expiresAt: number;
+}
+
+export function getSession(ctx: NexusContext): Session | null {
+  const cookie = ctx.request.headers.get('cookie');
+  if (!cookie) return null;
+  const match = /nx-session=([^;]+)/.exec(cookie);
+  if (!match) return null;
+  try {
+    return JSON.parse(atob(match[1])) as Session;
+  } catch { return null; }
+}
+
+export function requireSession(ctx: NexusContext): Session {
+  const session = getSession(ctx);
+  if (!session || session.expiresAt < Date.now()) {
+    ctx.redirect('/login');
+    throw new Error('Unreachable'); // redirect throws
+  }
+  return session;
+}
+`,
+            },
+            {
+                path: 'src/routes/login/+page.nx',
+                content: `---
+import { createAction } from '@nexus_js/server';
+import { defineHead } from '@nexus_js/head';
+
+defineHead({ title: 'Login — Nexus Auth' });
+
+const loginAction = createAction(async (formData: FormData, ctx) => {
+  const email    = formData.get('email')?.toString() ?? '';
+  const password = formData.get('password')?.toString() ?? '';
+
+  // TODO: validate against your DB
+  if (email && password) {
+    ctx.setCookie('nx-session', btoa(JSON.stringify({
+      userId: '1', email, role: 'user', expiresAt: Date.now() + 86400_000
+    })), { httpOnly: true, sameSite: 'lax' });
+    ctx.redirect('/');
+  }
+}, { idempotent: false, race: 'reject' });
+---
+
+<main class="auth-page">
+  <form method="POST" class="auth-form">
+    <h1>Sign in</h1>
+    <input type="email" name="email" placeholder="Email" required />
+    <input type="password" name="password" placeholder="Password" required />
+    <button type="submit">Sign in</button>
+  </form>
+</main>
+
+<style>
+  .auth-page  { display:flex; align-items:center; justify-content:center; min-height:80vh }
+  .auth-form  { display:flex; flex-direction:column; gap:12px; width:320px }
+  .auth-form h1 { font-size:24px; font-weight:700; margin-bottom:8px }
+  .auth-form input { padding:10px 14px; border:1px solid var(--border,#e5e7eb); border-radius:8px }
+  .auth-form button { padding:10px; background:#7c3aed; color:#fff; border:none; border-radius:8px; font-weight:600; cursor:pointer }
+</style>
+`,
+            },
+            {
+                path: 'src/middleware/auth.ts',
+                content: `/**
+ * Nexus Auth Middleware — protects routes requiring a session.
+ * Generated by: nexus add auth
+ */
+import { defineMiddleware } from '@nexus_js/middleware';
+import { getSession } from '../lib/auth.js';
+
+export const authMiddleware = defineMiddleware(async (ctx, next) => {
+  const session = getSession(ctx);
+  const isProtected = ctx.request.url.includes('/dashboard') ||
+                      ctx.request.url.includes('/profile');
+
+  if (isProtected && !session) {
+    return ctx.redirect('/login');
+  }
+  return next();
+});
+`,
+            },
+        ],
+    },
+    {
+        id: 'analytics',
+        name: 'Nexus Analytics',
+        category: 'analytics',
+        description: 'Privacy-first page-view counter using Server Actions + Shield Cache.',
+        tags: ['analytics', 'privacy', 'pageviews'],
+        postInstall: 'Add <Analytics /> to your root layout.',
+        files: [
+            {
+                path: 'src/components/Analytics.nx',
+                content: `---
+// Privacy-first analytics — no cookies, no fingerprinting.
+// Generated by: nexus add analytics
+import { cache } from '@nexus_js/runtime';
+const key = 'nx-' + crypto.randomUUID().slice(0, 8); // ephemeral session id
+---
+
+<script client:idle>
+// Fires a page-view beacon on mount (client:idle = after page paint)
+const path = window.location.pathname;
+navigator.sendBeacon?.('/_nexus/action/track-view', JSON.stringify({ path }));
+</script>
+`,
+            },
+            {
+                path: 'src/routes/api/analytics/+page.nx',
+                content: `---
+import { createAction, registerAction } from '@nexus_js/server';
+
+// In-memory counter (replace with DB in production)
+const views = new Map<string, number>();
+
+registerAction('track-view', async (input: { path: string }) => {
+  views.set(input.path, (views.get(input.path) ?? 0) + 1);
+}, { idempotent: false });
+
+const data = Object.fromEntries(views);
+---
+<pre>{JSON.stringify(data, null, 2)}</pre>
+`,
+            },
+        ],
+    },
+    {
+        id: 'pokecard',
+        name: 'PokéCard Island',
+        category: 'ui',
+        description: 'Pre-styled Pokémon card island with shiny toggle Rune. Demo component.',
+        tags: ['ui', 'island', 'demo', 'runes'],
+        files: [
+            {
+                path: 'src/components/PokéCard.nx',
+                content: `---
+export interface Props {
+  id:     number;
+  name:   string;
+  sprite: string;
+  types:  string[];
+  color:  string;
+}
+const { id, name, sprite, types, color } = $props<Props>();
+---
+
+<script>
+let shiny = $state(false);
+</script>
+
+<a href="/pokemon/{id}" class="pokecard" style="--color: {color}">
+  <div class="card-bg">
+    <img src="{sprite}" alt="{name}" width="120" height="120" />
+    <button onclick="{() => shiny = !shiny}" class="shiny-btn">
+      {shiny ? '✨ Shiny' : '✨ Normal'}
+    </button>
+  </div>
+  <div class="card-body">
+    <span class="dex-num">#{String(id).padStart(3, '0')}</span>
+    <h3>{name}</h3>
+    <div class="types">
+      {#each types as type}
+        <span class="type-badge type-{type}">{type}</span>
+      {/each}
+    </div>
+  </div>
+</a>
+
+<style>
+  .pokecard { display:block; border-radius:16px; overflow:hidden; text-decoration:none; color:inherit; background:var(--surface, #13131f); border:1px solid var(--border, #1e1e30); transition:transform .2s }
+  .pokecard:hover { transform:translateY(-4px) }
+  .card-bg { background:linear-gradient(135deg, color-mix(in srgb, var(--color) 20%, transparent), transparent); padding:20px; display:flex; flex-direction:column; align-items:center; gap:8px }
+  .card-body { padding:12px 16px 16px }
+  .dex-num { font-size:11px; color:#64748b; font-family:monospace }
+  h3 { font-size:16px; font-weight:700; text-transform:capitalize; margin:4px 0 8px }
+  .types { display:flex; gap:4px; flex-wrap:wrap }
+  .type-badge { padding:2px 10px; border-radius:999px; font-size:11px; font-weight:700; background:#374151; color:#fff }
+  .shiny-btn { padding:4px 12px; border-radius:999px; border:1px solid #374151; background:transparent; color:#94a3b8; font-size:11px; cursor:pointer }
+</style>
+`,
+            },
+        ],
+    },
+    {
+        id: 'rate-limit',
+        name: 'Edge Rate Limiter',
+        category: 'middleware',
+        description: 'IP-based rate limiting middleware for API routes and Server Actions.',
+        tags: ['security', 'middleware', 'edge'],
+        files: [
+            {
+                path: 'src/middleware/rate-limit.ts',
+                content: `/**
+ * Nexus Edge Rate Limiter — in-memory sliding window.
+ * Generated by: nexus add rate-limit
+ *
+ * For production, replace the Map with an Upstash/Redis adapter.
+ */
+import { defineMiddleware } from '@nexus_js/middleware';
+
+const windows = new Map<string, { count: number; reset: number }>();
+
+export function createRateLimit(opts: {
+  requests: number;
+  windowMs:  number;
+  message?:  string;
+}) {
+  return defineMiddleware(async (ctx, next) => {
+    const ip  = ctx.request.headers.get('x-forwarded-for')?.split(',')[0].trim() ?? 'unknown';
+    const now = Date.now();
+    const win = windows.get(ip);
+
+    if (!win || now > win.reset) {
+      windows.set(ip, { count: 1, reset: now + opts.windowMs });
+      return next();
+    }
+
+    if (win.count >= opts.requests) {
+      return new Response(
+        JSON.stringify({ error: opts.message ?? 'Too Many Requests' }),
+        { status: 429, headers: { 'content-type': 'application/json', 'retry-after': String(Math.ceil((win.reset - now) / 1000)) } }
+      );
+    }
+
+    win.count++;
+    return next();
+  });
+}
+
+// Default: 100 req / 60s per IP
+export const rateLimitMiddleware = createRateLimit({ requests: 100, windowMs: 60_000 });
+`,
+            },
+        ],
+    },
+];
+// ── CLI logic ─────────────────────────────────────────────────────────────────
+function listBlocks() {
+    console.log(`\n  ${c.mag}${c.bold}◆ Nexus Marketplace${c.reset}\n`);
+    const byCategory = new Map();
+    for (const block of BLOCKS) {
+        if (!byCategory.has(block.category))
+            byCategory.set(block.category, []);
+        byCategory.get(block.category).push(block);
+    }
+    for (const [cat, blocks] of byCategory) {
+        console.log(`  ${c.cyan}${cat}${c.reset}`);
+        for (const b of blocks) {
+            console.log(`    ${c.bold}nexus add ${b.id}${c.reset}  ${c.dim}${b.description}${c.reset}`);
+        }
+        console.log('');
+    }
+    console.log(`  ${c.dim}Run ${c.reset}${c.bold}nexus add <id>${c.reset}${c.dim} to install a block.${c.reset}\n`);
+}
+async function installBlock(blockId, root) {
+    const block = BLOCKS.find((b) => b.id === blockId);
+    if (!block) {
+        console.error(`\n  ${c.red}✖${c.reset}  Block "${blockId}" not found.\n`);
+        listBlocks();
+        process.exit(1);
+    }
+    console.log(`\n  ${c.mag}${c.bold}◆ Nexus Marketplace${c.reset}  Installing ${c.bold}${block.name}${c.reset}...\n`);
+    for (const file of block.files) {
+        const fullPath = join(root, file.path);
+        await mkdir(dirname(fullPath), { recursive: true });
+        await writeFile(fullPath, file.content, 'utf-8');
+        console.log(`  ${c.green}✔${c.reset}  Created ${c.cyan}${file.path}${c.reset}`);
+    }
+    if (block.postInstall) {
+        console.log(`\n  ${c.yellow}→${c.reset}  ${block.postInstall}`);
+    }
+    console.log(`\n  ${c.green}◆${c.reset}  ${block.name} installed successfully.\n`);
+}
+/** Interactive block picker when no ID is given */
+async function pickBlock(root) {
+    listBlocks();
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    const answer = await new Promise((resolve) => {
+        rl.question(`  Which block? ${c.dim}(id)${c.reset} `, resolve);
+    });
+    rl.close();
+    await installBlock(answer.trim(), root);
+}
+/** Entry point called by packages/cli/src/bin.ts */
+export async function runAdd(opts) {
+    if (!opts.blockId) {
+        await pickBlock(opts.root);
+    }
+    else {
+        await installBlock(opts.blockId, opts.root);
+    }
+}
+//# sourceMappingURL=add.js.map

package/dist/add.js.map

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

package/dist/analyzer.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Nexus Bundle Budget Analyzer
+ *
+ * Generates a detailed visual report of JS payload per route.
+ * Runs automatically after `nexus build` or standalone with `nexus analyze`.
+ *
+ * Terminal output:
+ *
+ *   ◆ Nexus Bundle Analysis
+ *   ════════════════════════════════════════════════════════
+ *
+ *   Route: /
+ *   ┌─────────────────────────────┬────────┬────────┬───────┐
+ *   │ Module                      │  Raw   │ Gzip   │ Share │
+ *   ├─────────────────────────────┼────────┼────────┼───────┤
+ *   │ @nexus_js/runtime (shared)     │  4.2KB │  1.8KB │  ███░ │
+ *   │ islands/Counter.client.js   │  1.1KB │  0.5KB │  █░░░ │
+ *   │ islands/SearchBar.client.js │  2.8KB │  1.1KB │  ██░░ │
+ *   ├─────────────────────────────┼────────┼────────┼───────┤
+ *   │ TOTAL                       │  8.1KB │  3.4KB │       │
+ *   └─────────────────────────────┴────────┴────────┴───────┘
+ *   Budget: ✓ Under 10KB limit
+ *
+ *   Route: /blog/[slug]  ← OVER BUDGET ⚠
+ *   ...
+ *
+ *   ─── Summary ─────────────────────────────────────────────
+ *   Routes analyzed:  12
+ *   Under budget:     10
+ *   Over budget:       2  ⚠ /dashboard, /checkout
+ *   Largest route:    /checkout (48KB gzip)
+ *   Zero-JS routes:    4  (/, /about, /blog, /contact)
+ */
+export interface BundleModule {
+    name: string;
+    path: string;
+    rawBytes: number;
+    gzipBytes: number;
+    kind: 'runtime' | 'island' | 'shared' | 'action';
+}
+export interface RouteBudget {
+    route: string;
+    modules: BundleModule[];
+    totalRaw: number;
+    totalGzip: number;
+    isZeroJS: boolean;
+    overBudget: boolean;
+    budgetBytes: number;
+}
+export interface AnalysisReport {
+    routes: RouteBudget[];
+    runtimeSize: number;
+    generatedAt: string;
+    totalIslands: number;
+    zeroJSRoutes: number;
+    overBudgetRoutes: string[];
+}
+export interface AnalyzerOptions {
+    root: string;
+    /** Gzip budget per route in bytes (default: 50KB) */
+    budgetBytes?: number;
+    /** Show per-module breakdown (default: true) */
+    verbose?: boolean;
+    /** Output format */
+    format?: 'terminal' | 'json' | 'html';
+    /** Write report to file */
+    outFile?: string;
+}
+export declare function analyzeBundles(opts: AnalyzerOptions): Promise<AnalysisReport>;
+//# sourceMappingURL=analyzer.d.ts.map

package/dist/analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyzer.d.ts","sourceRoot":"","sources":["../src/analyzer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAOH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;CAClD;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,OAAO,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,qDAAqD;IACrD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gDAAgD;IAChD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,oBAAoB;IACpB,MAAM,CAAC,EAAE,UAAU,GAAG,MAAM,GAAG,MAAM,CAAC;IACtC,2BAA2B;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAmBD,wBAAsB,cAAc,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC,CA+BnF"}