@ressjs/cli 0.6.0-experimental.0 → 0.6.0-rc.0

package/LICENSE

@@ -0,0 +1,69 @@
+ress.js Proprietary License
+
+Copyright (c) 2025-2026 gabrielspisso. All rights reserved.
+
+This license applies to the ress.js packages (the "Software"), published on npm
+under the @ressjs and @gzzy scopes, in every version released from 0.6.0-rc.0
+onwards. Earlier versions were released under the MIT License and remain
+available under those terms.
+
+1. GRANT
+   Subject to this license, the Licensor grants you a worldwide, non-exclusive,
+   non-transferable, non-sublicensable, royalty-free license to install and use
+   the Software, as distributed by the Licensor, to build, run and deploy your
+   own applications and services, including commercial ones, and to charge your
+   own customers for them.
+
+2. RESTRICTIONS
+   You may not:
+   a) fork, copy, or redistribute the Software, in whole or in part, except for
+      the portions that are necessarily included in the build output of your own
+      application in order to run it;
+   b) publish, distribute or make available a modified version of the Software
+      or any work derived from it. Modifications for your own internal use are
+      allowed, but they remain subject to this license;
+   c) use the Software, or any part of it, to build, offer or support a
+      framework, library, tool or service that competes with the Software;
+   d) sell, sublicense, rent or host the Software itself as a product or service
+      for third parties, as opposed to hosting your own application built with
+      it;
+   e) remove or alter copyright, license or attribution notices;
+   f) use the name "ress.js" or the Licensor's names or marks to endorse or
+      promote your products without written permission.
+
+3. SCAFFOLDING OUTPUT
+   Files that @ressjs/create-ress-app copies into your project (templates and
+   generated configuration) are yours: you may use, modify and distribute them
+   without restriction. This does not extend to the Software packages that the
+   generated project installs as dependencies.
+
+4. SUPPORT
+   The Software is provided without any obligation of support, maintenance or
+   updates. The Licensor may offer support, maintenance, training or consulting
+   under a separate paid agreement; that agreement does not change this license
+   unless it says so explicitly and is signed by the Licensor.
+
+5. OWNERSHIP
+   The Software is licensed, not sold. The Licensor retains all rights not
+   expressly granted here. Feedback and suggestions you send may be used by the
+   Licensor without obligation to you.
+
+6. TERMINATION
+   This license ends automatically if you breach it. On termination you must
+   stop using the Software and delete your copies. Sections 4 to 8 survive
+   termination.
+
+7. NO WARRANTY
+   THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+   IMPLIED, INCLUDING THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A
+   PARTICULAR PURPOSE AND NON-INFRINGEMENT.
+
+8. LIMITATION OF LIABILITY
+   TO THE MAXIMUM EXTENT PERMITTED BY LAW, THE LICENSOR WILL NOT BE LIABLE FOR
+   ANY INDIRECT, INCIDENTAL, SPECIAL OR CONSEQUENTIAL DAMAGES, OR FOR LOSS OF
+   PROFITS, DATA OR BUSINESS, ARISING FROM THE USE OF OR INABILITY TO USE THE
+   SOFTWARE. THE LICENSOR'S TOTAL LIABILITY IS LIMITED TO THE AMOUNT YOU PAID
+   FOR THE SOFTWARE, WHICH MAY BE ZERO.
+
+For other uses, including exceptions to section 2, contact the Licensor to
+agree a separate license.

package/dist/api/index.d.ts

@@ -9,7 +9,8 @@ export { createRessApp } from './app.js';
 export { startDevServer } from './dev.js';
 export { startProdServer } from './start.js';
 export { buildApp } from './build.js';
-export { inspectProject, cliVersion } from './inspect.js';
+export { inspectProject } from './inspect.js';
+export { cliVersion } from './version.js';
 export { resolveOptions } from './options.js';
 export { silentReporter, collectingReporter } from './reporter.js';
 export { RessError } from './errors.js';

package/dist/api/index.js

@@ -9,7 +9,8 @@ export { createRessApp } from './app.js';
 export { startDevServer } from './dev.js';
 export { startProdServer } from './start.js';
 export { buildApp } from './build.js';
-export { inspectProject, cliVersion } from './inspect.js';
+export { inspectProject } from './inspect.js';
+export { cliVersion } from './version.js';
 export { resolveOptions } from './options.js';
 export { silentReporter, collectingReporter } from './reporter.js';
 export { RessError } from './errors.js';

package/dist/api/inspect.d.ts

@@ -63,13 +63,4 @@ export interface ProjectInfo {
         };
     };
 }
-/**
- * La versión de `@ressjs/cli`, leída de su propio `package.json`.
- *
- * Exportada porque `src/cli/main.ts` también la necesita para `--version` y no
- * puede tocar `node:fs` directamente sin romper la regla de separación —
- * "la CLI no reimplementa" incluye no leer archivos por su cuenta cuando la
- * API ya sabe cómo.
- */
-export declare function cliVersion(): Promise<string>;
 export declare function inspectProject(opts?: InspectOptions): Promise<ProjectInfo>;

package/dist/api/inspect.js

@@ -8,10 +8,10 @@
  */
 import os from 'node:os';
 import path from 'node:path';
-import { fileURLToPath, URL } from 'node:url';
 import { readFile } from 'node:fs/promises';
-import { buildVariantCatalog, getPages, loadRouteManifest, OUT_DIR, scanRoutes, } from '@ressjs/vite-router';
+import { buildVariantCatalog, getPages, loadRouteManifest, OUT_DIR, scanRoutes, writeProjectTypes, } from '@ressjs/vite-router';
 import { resolveOptions } from './options.js';
+import { cliVersion } from './version.js';
 import { RessError } from './errors.js';
 async function dirBytes(dir) {
     const { readdir, stat } = await import('node:fs/promises');
@@ -39,23 +39,6 @@ async function packageVersion(root, name) {
         return undefined;
     }
 }
-/**
- * La versión de `@ressjs/cli`, leída de su propio `package.json`.
- *
- * Exportada porque `src/cli/main.ts` también la necesita para `--version` y no
- * puede tocar `node:fs` directamente sin romper la regla de separación —
- * "la CLI no reimplementa" incluye no leer archivos por su cuenta cuando la
- * API ya sabe cómo.
- */
-export async function cliVersion() {
-    try {
-        const raw = await readFile(fileURLToPath(new URL('../../package.json', import.meta.url)), 'utf-8');
-        return JSON.parse(raw).version ?? '0.0.0';
-    }
-    catch {
-        return '0.0.0';
-    }
-}
 export async function inspectProject(opts = {}) {
     const root = opts.root ? path.resolve(opts.root) : process.cwd();
     const mode = opts.mode ?? 'development';
@@ -74,6 +57,9 @@ export async function inspectProject(opts = {}) {
         }
         resolvedConfig = options.config;
         configFile = options.configFile.value;
+        // Los tipos de `config.X` salen de la configuración resuelta. Generarlos acá
+        // permite tipar un clon limpio sin levantar el servidor (`ress info && tsc`).
+        await writeProjectTypes(root, options.config.platform);
     }
     catch (cause) {
         valid = false;

package/dist/api/version.d.ts

@@ -0,0 +1,10 @@
+/**
+ * La versión de `@ressjs/cli`, leída de su propio `package.json`.
+ *
+ * Vive en un módulo propio, sin dependencias del runtime, porque
+ * `src/cli/main.ts` la necesita antes de fijar `NODE_ENV`. Importarla desde
+ * `inspect.ts` arrastraba `@ressjs/vite-router` y, con él, React: React elige
+ * su build de desarrollo o de producción al cargarse, así que quedaba en
+ * desarrollo aunque después se fijara `NODE_ENV=production`.
+ */
+export declare function cliVersion(): Promise<string>;

package/dist/api/version.js

@@ -0,0 +1,20 @@
+import { readFile } from 'node:fs/promises';
+import { fileURLToPath, URL } from 'node:url';
+/**
+ * La versión de `@ressjs/cli`, leída de su propio `package.json`.
+ *
+ * Vive en un módulo propio, sin dependencias del runtime, porque
+ * `src/cli/main.ts` la necesita antes de fijar `NODE_ENV`. Importarla desde
+ * `inspect.ts` arrastraba `@ressjs/vite-router` y, con él, React: React elige
+ * su build de desarrollo o de producción al cargarse, así que quedaba en
+ * desarrollo aunque después se fijara `NODE_ENV=production`.
+ */
+export async function cliVersion() {
+    try {
+        const raw = await readFile(fileURLToPath(new URL('../../package.json', import.meta.url)), 'utf-8');
+        return JSON.parse(raw).version ?? '0.0.0';
+    }
+    catch {
+        return '0.0.0';
+    }
+}

package/dist/cli/env.d.ts

@@ -0,0 +1,12 @@
+/**
+ * `NODE_ENV` por comando.
+ *
+ * `ress start` y `ress build` no fijaban `NODE_ENV`, así que en producción
+ * React (y cualquier caché que lea `process.env.NODE_ENV`) seguía corriendo
+ * en modo desarrollo salvo que quien desplegara lo supiera y lo pusiera a
+ * mano. Se fija acá, antes de importar el runtime (`../../api/index.js`,
+ * detrás de un `import()` dinámico en `main.ts`), y no lo pisa si ya venía
+ * declarado desde afuera.
+ */
+export type EnvCommand = 'dev' | 'build' | 'start' | 'info' | 'help' | 'version';
+export declare function applyNodeEnvDefault(command: EnvCommand): void;

package/dist/cli/env.js

@@ -0,0 +1,9 @@
+export function applyNodeEnvDefault(command) {
+    if (command === 'dev') {
+        process.env.NODE_ENV ??= 'development';
+        return;
+    }
+    if (command === 'build' || command === 'start') {
+        process.env.NODE_ENV ??= 'production';
+    }
+}

package/dist/cli/main.js

@@ -6,24 +6,27 @@
  * en `commands/*`.
  */
 import { parseArgv } from './argv.js';
-import { devCommand } from './commands/dev.js';
-import { buildCommand } from './commands/build.js';
-import { startCommand } from './commands/start.js';
-import { infoCommand } from './commands/info.js';
 import { formatError } from './reporters/terminal.js';
 import { detectFormatEnv } from './reporters/format.js';
+import { applyNodeEnvDefault } from './env.js';
 import { RessError } from '../api/errors.js';
-import { cliVersion } from '../api/inspect.js';
-function dispatch(parsed) {
+// Sólo módulos sin el runtime: `cliVersion` vive aparte de `inspect.ts`, que
+// importa `@ressjs/vite-router` y con él React, y React tiene que cargarse
+// después de `applyNodeEnvDefault`.
+import { cliVersion } from '../api/version.js';
+// Import dinámico y no estático: así `NODE_ENV` queda fijado (`applyNodeEnvDefault`,
+// llamado antes de esto) antes de que se cargue `../../api/index.js`, que es
+// donde vive el runtime que lee `process.env.NODE_ENV`.
+async function dispatch(parsed) {
     switch (parsed.command) {
         case 'dev':
-            return devCommand(parsed.flags);
+            return (await import('./commands/dev.js')).devCommand(parsed.flags);
         case 'build':
-            return buildCommand(parsed.flags);
+            return (await import('./commands/build.js')).buildCommand(parsed.flags);
         case 'start':
-            return startCommand(parsed.flags);
+            return (await import('./commands/start.js')).startCommand(parsed.flags);
         case 'info':
-            return infoCommand(parsed.flags);
+            return (await import('./commands/info.js')).infoCommand(parsed.flags);
     }
 }
 export async function main(argv = process.argv.slice(2)) {
@@ -41,6 +44,7 @@ export async function main(argv = process.argv.slice(2)) {
             process.exitCode = 0;
             return;
         }
+        applyNodeEnvDefault(parsed.command);
         process.exitCode = await dispatch(parsed);
     }
     catch (error) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ressjs/cli",
-  "version": "0.6.0-experimental.0",
+  "version": "0.6.0-rc.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": {
@@ -37,9 +37,9 @@
     "vite"
   ],
   "author": "ress.js team",
-  "license": "MIT",
+  "license": "SEE LICENSE IN LICENSE",
   "dependencies": {
-    "@ressjs/vite-router": "0.6.0-experimental.0",
+    "@ressjs/vite-router": "0.6.0-rc.0",
     "@vitejs/plugin-react": "^6.1.0",
     "commander": "^12.1.0",
     "express": "^5.1.0"