@ressjs/cli 0.6.0-experimental.0

package/dist/cli/reporters/terminal.js

@@ -0,0 +1,118 @@
+import { bold, cyan, detectFormatEnv, dim, formatBytes, formatDuration, green, red, yellow } from './format.js';
+const LEVEL_RANK = { silent: 0, error: 1, warn: 2, info: 3, debug: 4 };
+export function createTerminalReporter(opts = {}) {
+    const logLevel = opts.logLevel ?? 'info';
+    const stdout = opts.stdout ?? process.stdout;
+    const stderr = opts.stderr ?? process.stderr;
+    const env = detectFormatEnv(Boolean(stdout.isTTY), opts.env ?? process.env);
+    const rank = LEVEL_RANK[logLevel];
+    const out = (line) => {
+        if (rank < LEVEL_RANK.info)
+            return;
+        stdout.write(line + '\n');
+    };
+    const debugOut = (line) => {
+        if (rank < LEVEL_RANK.debug)
+            return;
+        stdout.write(line + '\n');
+    };
+    const warnOut = (line) => {
+        if (rank < LEVEL_RANK.warn)
+            return;
+        stderr.write(line + '\n');
+    };
+    // Un error no se apaga con `--log-level silent`: la regla es "nada en
+    // stdout", no "nada en absoluto". `silent` es para scripts que sólo miran
+    // el código de salida, y ese código lo produce este mismo error.
+    const errOut = (line) => {
+        stderr.write(line + '\n');
+    };
+    return {
+        event(e) {
+            formatEvent(e, env, { out, debugOut, warnOut, errOut });
+        },
+    };
+}
+/**
+ * Un caso por variante de `RessEvent`, a propósito: es lo que el test de
+ * reporter recorre para comprobar que ninguna se quedó sin formato.
+ */
+export function formatEvent(e, env, sinks) {
+    switch (e.type) {
+        case 'config:loaded':
+            sinks.debugOut(dim(env, `  config          ${e.file ?? '(sin archivo)'}  ${formatDuration(e.durationMs)}`));
+            return;
+        case 'routes:scanned': {
+            sinks.out('');
+            sinks.out(bold(env, `  Rutas (${e.entries.length})`));
+            for (const entry of e.entries) {
+                sinks.out(`     ${entry.pattern.padEnd(24)} ${dim(env, entry.sourceFile)}`);
+            }
+            return;
+        }
+        case 'routes:conflict':
+            sinks.warnOut(yellow(env, `  ⚠ conflicto de ruta ${e.pattern}: ${e.files.join(', ')}`));
+            return;
+        case 'routes:changed':
+            for (const file of e.added)
+                sinks.out(`  ${timestamp()}  ruta agregada    ${file}`);
+            for (const file of e.removed)
+                sinks.out(`  ${timestamp()}  ruta eliminada   ${file}`);
+            return;
+        case 'catalog:built':
+            sinks.out(`  Variantes (${e.variants.length})       ${e.variants.join(' · ') || '(ninguna)'}`);
+            return;
+        case 'server:listening':
+            sinks.out('');
+            sinks.out(`  ${bold(env, cyan(env, 'ress.js'))}                          modo: ${e.mode}`);
+            sinks.out('');
+            sinks.out(`  ${green(env, '➜')}  Local:    ${e.url}`);
+            sinks.out('');
+            return;
+        case 'server:extended':
+            sinks.debugOut(dim(env, `  extensión (${e.hook})   ${e.file}`));
+            return;
+        case 'build:start':
+            sinks.out(`  ${dim(env, '·')} construyendo ${e.target}…`);
+            return;
+        case 'build:done':
+            sinks.out(`  ${green(env, '✓')} ${e.target.padEnd(8)} ${formatBytes(e.bytes).padStart(8)}   ${formatDuration(e.durationMs)}`);
+            return;
+        case 'build:artifact':
+            sinks.debugOut(dim(env, `     ${e.file}`));
+            return;
+        case 'config:reload':
+            sinks.out(`  ${timestamp()}  config           recargado: ${e.keys.join(', ')}`);
+            if (e.requiresRestart.length) {
+                sinks.warnOut(yellow(env, `  ${e.requiresRestart.join(', ')} requiere reinicio`));
+            }
+            return;
+        case 'warn':
+            sinks.warnOut(yellow(env, `  ⚠ ${e.message}${e.file ? ` (${e.file})` : ''}`));
+            return;
+        case 'error':
+            sinks.errOut(formatError(e.error, env));
+            return;
+    }
+}
+export function formatError(error, env) {
+    const lines = ['', `  ${red(env, '✖')} ${bold(env, error.title)}`, ''];
+    if (error.files?.length) {
+        for (const file of error.files)
+            lines.push(`    ${file}`);
+        lines.push('');
+    }
+    if (error.reason) {
+        lines.push(`    ${error.reason}`);
+        lines.push('');
+    }
+    if (error.action) {
+        lines.push(`    ${error.action}`);
+        lines.push('');
+    }
+    lines.push(dim(env, `    ress.js · código ${error.code}`));
+    return lines.join('\n');
+}
+function timestamp() {
+    return new Date().toTimeString().slice(0, 8);
+}

package/dist/cli/shutdown.d.ts

@@ -0,0 +1,2 @@
+/** Cierre ordenado ante SIGINT/SIGTERM. Código de salida 130, siempre. */
+export declare function registerShutdown(close: () => Promise<void>): void;

package/dist/cli/shutdown.js

@@ -0,0 +1,17 @@
+/** Cierre ordenado ante SIGINT/SIGTERM. Código de salida 130, siempre. */
+export function registerShutdown(close) {
+    let closing = false;
+    const handler = async () => {
+        if (closing)
+            return;
+        closing = true;
+        try {
+            await close();
+        }
+        finally {
+            process.exit(130);
+        }
+    };
+    process.once('SIGINT', handler);
+    process.once('SIGTERM', handler);
+}

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@ressjs/cli",
+  "version": "0.6.0-experimental.0",
+  "description": "La CLI de ress.js: dev, build, start e info sobre la misma construcción de la aplicación que expone como API.",
+  "type": "module",
+  "bin": {
+    "ress": "./bin/ress.js"
+  },
+  "types": "dist/api/index.d.ts",
+  "main": "dist/api/index.js",
+  "exports": {
+    ".": {
+      "types": "./dist/api/index.d.ts",
+      "require": "./dist/api/index.js",
+      "import": "./dist/api/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "bin"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "clean": "rm -rf dist",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "ressjs",
+    "cli",
+    "ssr",
+    "vite"
+  ],
+  "author": "ress.js team",
+  "license": "MIT",
+  "dependencies": {
+    "@ressjs/vite-router": "0.6.0-experimental.0",
+    "@vitejs/plugin-react": "^6.1.0",
+    "commander": "^12.1.0",
+    "express": "^5.1.0"
+  },
+  "devDependencies": {
+    "@types/express": "^5.0.3",
+    "@types/node": "^22.17.2",
+    "typescript": "~5.9.0",
+    "vitest": "^3.2.4"
+  },
+  "peerDependencies": {
+    "vite": "^8.0.0"
+  },
+  "engines": {
+    "node": ">=20.19.0"
+  }
+}