slicejs-cli 3.1.0 → 3.3.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 (43) hide show
  1. package/.github/ISSUE_TEMPLATE/bug_report.md +29 -0
  2. package/.github/ISSUE_TEMPLATE/feature_request.md +25 -0
  3. package/.github/pull_request_template.md +22 -0
  4. package/.github/workflows/docs-render-cicd.yml +65 -0
  5. package/CODE_OF_CONDUCT.md +126 -0
  6. package/ECOSYSTEM.md +9 -0
  7. package/LICENSE +21 -0
  8. package/README.md +104 -308
  9. package/client.js +644 -557
  10. package/commands/Print.js +167 -167
  11. package/commands/Validations.js +103 -103
  12. package/commands/build/build.js +40 -40
  13. package/commands/buildProduction/buildProduction.js +579 -579
  14. package/commands/bundle/bundle.js +235 -235
  15. package/commands/createComponent/VisualComponentTemplate.js +55 -55
  16. package/commands/createComponent/createComponent.js +126 -126
  17. package/commands/deleteComponent/deleteComponent.js +77 -77
  18. package/commands/doctor/doctor.js +369 -369
  19. package/commands/getComponent/getComponent.js +747 -747
  20. package/commands/init/init.js +261 -261
  21. package/commands/listComponents/listComponents.js +175 -175
  22. package/commands/startServer/startServer.js +264 -264
  23. package/commands/startServer/watchServer.js +79 -79
  24. package/commands/types/types.js +538 -0
  25. package/commands/utils/LocalCliDelegation.js +53 -53
  26. package/commands/utils/PathHelper.js +68 -68
  27. package/commands/utils/VersionChecker.js +167 -167
  28. package/commands/utils/bundling/BundleGenerator.js +2292 -2292
  29. package/commands/utils/bundling/DependencyAnalyzer.js +933 -933
  30. package/commands/utils/updateManager.js +453 -453
  31. package/docs/superpowers/specs/2026-05-10-pwa-generate-design.md +182 -0
  32. package/package.json +46 -46
  33. package/post.js +65 -25
  34. package/tests/bundle-generator.test.js +708 -708
  35. package/tests/bundle-v2-register-output.test.js +470 -470
  36. package/tests/client-launcher-contract.test.js +211 -211
  37. package/tests/client-update-flow-contract.test.js +272 -272
  38. package/tests/dependency-analyzer.test.js +24 -24
  39. package/tests/local-cli-delegation.test.js +79 -79
  40. package/tests/postinstall-command.test.js +72 -0
  41. package/tests/types-generator.test.js +356 -0
  42. package/tests/update-manager-notifications.test.js +88 -88
  43. package/refactor.md +0 -271
@@ -1,264 +1,264 @@
1
- // commands/startServer/startServer.js - MEJORADO CON VALIDACIÓN Y FEEDBACK
2
-
3
- import fs from 'fs-extra';
4
- import path from 'path';
5
- import { fileURLToPath } from 'url';
6
- import { spawn } from 'child_process';
7
- import { createServer } from 'net';
8
- import setupWatcher, { stopWatcher } from './watchServer.js';
9
- import Print from '../Print.js';
10
- import { getConfigPath, getApiPath, getSrcPath, getDistPath } from '../utils/PathHelper.js';
11
- import build from '../build/build.js';
12
-
13
- const __dirname = path.dirname(fileURLToPath(import.meta.url));
14
-
15
- /**
16
- * Carga la configuración desde sliceConfig.json
17
- */
18
- const loadConfig = () => {
19
- try {
20
- const configPath = getConfigPath(import.meta.url);
21
- const rawData = fs.readFileSync(configPath, 'utf-8');
22
- return JSON.parse(rawData);
23
- } catch (error) {
24
- Print.error(`Loading configuration: ${error.message}`);
25
- return null;
26
- }
27
- };
28
-
29
- /**
30
- * Verifica si un puerto está disponible
31
- */
32
- async function isPortAvailable(port) {
33
- return new Promise((resolve) => {
34
- const server = createServer();
35
-
36
- server.once('error', (err) => {
37
- if (err.code === 'EADDRINUSE') {
38
- resolve(false);
39
- } else {
40
- resolve(false);
41
- }
42
- });
43
-
44
- server.once('listening', () => {
45
- server.close();
46
- resolve(true);
47
- });
48
-
49
- server.listen(port);
50
- });
51
- }
52
-
53
- /**
54
- * Verifica si existe un build de producción
55
- */
56
- async function checkProductionBuild() {
57
- const distDir = getDistPath(import.meta.url);
58
- const bundleConfigPath = path.join(distDir, 'bundles', 'bundle.config.json');
59
- return (await fs.pathExists(distDir)) && (await fs.pathExists(bundleConfigPath));
60
- }
61
-
62
- /**
63
- * Verifica si existe la estructura de desarrollo
64
- */
65
- async function checkDevelopmentStructure() {
66
- const srcDir = getSrcPath(import.meta.url);
67
- const apiDir = getApiPath(import.meta.url);
68
-
69
- return (await fs.pathExists(srcDir)) && (await fs.pathExists(apiDir));
70
- }
71
-
72
- /**
73
- * Inicia el servidor Node.js con argumentos y mejor feedback
74
- */
75
- function startNodeServer(port, mode) {
76
- return new Promise((resolve, reject) => {
77
- const apiIndexPath = getApiPath(import.meta.url, 'index.js');
78
-
79
- // Verificar que el archivo existe
80
- if (!fs.existsSync(apiIndexPath)) {
81
- reject(new Error(`Server file not found: ${apiIndexPath}`));
82
- return;
83
- }
84
-
85
- Print.serverStatus('starting', 'Starting server...');
86
-
87
- // Construir argumentos basados en el modo
88
- const args = [apiIndexPath];
89
- if (mode === 'production') {
90
- args.push('--production');
91
- } else {
92
- args.push('--development');
93
- }
94
-
95
- // Ensure the spawned server process receives NODE_ENV consistent with the
96
- // requested mode. This guarantees code that only checks process.env.NODE_ENV
97
- // (instead of CLI flags) will behave as expected.
98
- const serverEnv = {
99
- ...process.env,
100
- PORT: port,
101
- NODE_ENV: mode === 'production' ? 'production' : (process.env.NODE_ENV || 'development')
102
- };
103
-
104
- const serverProcess = spawn('node', args, {
105
- stdio: ['inherit', 'pipe', 'pipe'],
106
- env: serverEnv
107
- });
108
-
109
- let serverStarted = false;
110
- let outputBuffer = '';
111
-
112
- // Capturar la salida para detectar cuando el servidor está listo
113
- serverProcess.stdout.on('data', (data) => {
114
- const output = data.toString();
115
- outputBuffer += output;
116
-
117
- // Detectar mensajes comunes que indican que el servidor ha iniciado
118
- if (!serverStarted && (
119
- output.includes('Server running') ||
120
- output.includes('listening on') ||
121
- output.includes('Started on') ||
122
- output.includes(`port ${port}`)
123
- )) {
124
- serverStarted = true;
125
- Print.serverReady(port);
126
- }
127
-
128
- // Mostrar la salida del servidor
129
- process.stdout.write(output);
130
- });
131
-
132
- serverProcess.stderr.on('data', (data) => {
133
- const output = data.toString();
134
- process.stderr.write(output);
135
- });
136
-
137
- serverProcess.on('error', (error) => {
138
- if (!serverStarted) {
139
- Print.serverStatus('error', `Failed to start server: ${error.message}`);
140
- reject(error);
141
- }
142
- });
143
-
144
- serverProcess.on('exit', (code, signal) => {
145
- if (code !== null && code !== 0 && !serverStarted) {
146
- reject(new Error(`Server exited with code ${code}`));
147
- }
148
- });
149
-
150
- // Manejar Ctrl+C
151
- process.on('SIGINT', () => {
152
- Print.newLine();
153
- Print.info('Shutting down server...');
154
- serverProcess.kill('SIGINT');
155
- setTimeout(() => {
156
- process.exit(0);
157
- }, 100);
158
- });
159
-
160
- process.on('SIGTERM', () => {
161
- serverProcess.kill('SIGTERM');
162
- });
163
-
164
- // Si después de 3 segundos no detectamos inicio, asumimos que está listo
165
- setTimeout(() => {
166
- if (!serverStarted) {
167
- serverStarted = true;
168
- Print.serverReady(port);
169
- }
170
- resolve(serverProcess);
171
- }, 3000);
172
- });
173
- }
174
-
175
- /**
176
- * Función principal para iniciar servidor
177
- */
178
- export default async function startServer(options = {}) {
179
- const config = loadConfig();
180
- const defaultPort = config?.server?.port || 3000;
181
-
182
- const { mode = 'development', port = defaultPort, watch = false } = options;
183
-
184
- try {
185
- Print.title(`🚀 Starting Slice.js ${mode} server...`);
186
- Print.newLine();
187
-
188
- // Verificar estructura del proyecto
189
- if (!await checkDevelopmentStructure()) {
190
- throw new Error('Project structure not found. Run "slice init" first.');
191
- }
192
-
193
- let actualPort = await isPortAvailable(port) ? port : port + 1; // Try one more port
194
- if(actualPort !== port) {
195
- // Check if the fallback is available
196
- const fallbackAvailable = await isPortAvailable(actualPort);
197
- if(!fallbackAvailable) {
198
- throw new Error(`Ports ${port} and ${actualPort} are in use.`);
199
- }
200
- Print.info(`ℹ️ Port ${port} in use, using ${actualPort} instead.`);
201
- }
202
-
203
- Print.serverStatus('checking', `Port ${actualPort} available ✓`);
204
- Print.newLine();
205
-
206
- if (mode === 'production') {
207
- // Verificar que existe build de producción
208
- if (!await checkProductionBuild()) {
209
- Print.info('No production build found. Running "slice build"...');
210
- const success = await build({});
211
- if (!success) {
212
- throw new Error('Build failed. Cannot start production server.');
213
- }
214
- }
215
- Print.info('Production mode: serving optimized files from /dist');
216
- } else {
217
- Print.info('Development mode: serving files from /src (HMR enabled)');
218
- }
219
-
220
- Print.newLine();
221
-
222
- // Iniciar el servidor con argumentos
223
- let serverProcess = await startNodeServer(actualPort, mode);
224
-
225
- // Configurar watch mode si está habilitado
226
- if (watch) {
227
- Print.newLine();
228
- const watcher = setupWatcher(serverProcess, async (changedPath) => {
229
- if (serverProcess) {
230
- serverProcess.kill();
231
- }
232
-
233
- // Short delay to ensure port is freed
234
- await new Promise(r => setTimeout(r, 500));
235
-
236
- try {
237
- Print.info('🔄 File changed. Restarting server...');
238
-
239
- serverProcess = await startNodeServer(actualPort, mode);
240
- } catch (e) {
241
- Print.error(`Failed to restart server: ${e.message}`);
242
- }
243
- });
244
-
245
- // Cleanup en exit
246
- const cleanup = () => {
247
- stopWatcher(watcher);
248
- };
249
-
250
- process.on('SIGINT', cleanup);
251
- process.on('SIGTERM', cleanup);
252
- }
253
-
254
- } catch (error) {
255
- Print.newLine();
256
- Print.error(error.message);
257
- throw error;
258
- }
259
- }
260
-
261
- /**
262
- * Funciones de utilidad exportadas
263
- */
264
- export { checkProductionBuild, checkDevelopmentStructure, isPortAvailable };
1
+ // commands/startServer/startServer.js - MEJORADO CON VALIDACIÓN Y FEEDBACK
2
+
3
+ import fs from 'fs-extra';
4
+ import path from 'path';
5
+ import { fileURLToPath } from 'url';
6
+ import { spawn } from 'child_process';
7
+ import { createServer } from 'net';
8
+ import setupWatcher, { stopWatcher } from './watchServer.js';
9
+ import Print from '../Print.js';
10
+ import { getConfigPath, getApiPath, getSrcPath, getDistPath } from '../utils/PathHelper.js';
11
+ import build from '../build/build.js';
12
+
13
+ const __dirname = path.dirname(fileURLToPath(import.meta.url));
14
+
15
+ /**
16
+ * Carga la configuración desde sliceConfig.json
17
+ */
18
+ const loadConfig = () => {
19
+ try {
20
+ const configPath = getConfigPath(import.meta.url);
21
+ const rawData = fs.readFileSync(configPath, 'utf-8');
22
+ return JSON.parse(rawData);
23
+ } catch (error) {
24
+ Print.error(`Loading configuration: ${error.message}`);
25
+ return null;
26
+ }
27
+ };
28
+
29
+ /**
30
+ * Verifica si un puerto está disponible
31
+ */
32
+ async function isPortAvailable(port) {
33
+ return new Promise((resolve) => {
34
+ const server = createServer();
35
+
36
+ server.once('error', (err) => {
37
+ if (err.code === 'EADDRINUSE') {
38
+ resolve(false);
39
+ } else {
40
+ resolve(false);
41
+ }
42
+ });
43
+
44
+ server.once('listening', () => {
45
+ server.close();
46
+ resolve(true);
47
+ });
48
+
49
+ server.listen(port);
50
+ });
51
+ }
52
+
53
+ /**
54
+ * Verifica si existe un build de producción
55
+ */
56
+ async function checkProductionBuild() {
57
+ const distDir = getDistPath(import.meta.url);
58
+ const bundleConfigPath = path.join(distDir, 'bundles', 'bundle.config.json');
59
+ return (await fs.pathExists(distDir)) && (await fs.pathExists(bundleConfigPath));
60
+ }
61
+
62
+ /**
63
+ * Verifica si existe la estructura de desarrollo
64
+ */
65
+ async function checkDevelopmentStructure() {
66
+ const srcDir = getSrcPath(import.meta.url);
67
+ const apiDir = getApiPath(import.meta.url);
68
+
69
+ return (await fs.pathExists(srcDir)) && (await fs.pathExists(apiDir));
70
+ }
71
+
72
+ /**
73
+ * Inicia el servidor Node.js con argumentos y mejor feedback
74
+ */
75
+ function startNodeServer(port, mode) {
76
+ return new Promise((resolve, reject) => {
77
+ const apiIndexPath = getApiPath(import.meta.url, 'index.js');
78
+
79
+ // Verificar que el archivo existe
80
+ if (!fs.existsSync(apiIndexPath)) {
81
+ reject(new Error(`Server file not found: ${apiIndexPath}`));
82
+ return;
83
+ }
84
+
85
+ Print.serverStatus('starting', 'Starting server...');
86
+
87
+ // Construir argumentos basados en el modo
88
+ const args = [apiIndexPath];
89
+ if (mode === 'production') {
90
+ args.push('--production');
91
+ } else {
92
+ args.push('--development');
93
+ }
94
+
95
+ // Ensure the spawned server process receives NODE_ENV consistent with the
96
+ // requested mode. This guarantees code that only checks process.env.NODE_ENV
97
+ // (instead of CLI flags) will behave as expected.
98
+ const serverEnv = {
99
+ ...process.env,
100
+ PORT: port,
101
+ NODE_ENV: mode === 'production' ? 'production' : (process.env.NODE_ENV || 'development')
102
+ };
103
+
104
+ const serverProcess = spawn('node', args, {
105
+ stdio: ['inherit', 'pipe', 'pipe'],
106
+ env: serverEnv
107
+ });
108
+
109
+ let serverStarted = false;
110
+ let outputBuffer = '';
111
+
112
+ // Capturar la salida para detectar cuando el servidor está listo
113
+ serverProcess.stdout.on('data', (data) => {
114
+ const output = data.toString();
115
+ outputBuffer += output;
116
+
117
+ // Detectar mensajes comunes que indican que el servidor ha iniciado
118
+ if (!serverStarted && (
119
+ output.includes('Server running') ||
120
+ output.includes('listening on') ||
121
+ output.includes('Started on') ||
122
+ output.includes(`port ${port}`)
123
+ )) {
124
+ serverStarted = true;
125
+ Print.serverReady(port);
126
+ }
127
+
128
+ // Mostrar la salida del servidor
129
+ process.stdout.write(output);
130
+ });
131
+
132
+ serverProcess.stderr.on('data', (data) => {
133
+ const output = data.toString();
134
+ process.stderr.write(output);
135
+ });
136
+
137
+ serverProcess.on('error', (error) => {
138
+ if (!serverStarted) {
139
+ Print.serverStatus('error', `Failed to start server: ${error.message}`);
140
+ reject(error);
141
+ }
142
+ });
143
+
144
+ serverProcess.on('exit', (code, signal) => {
145
+ if (code !== null && code !== 0 && !serverStarted) {
146
+ reject(new Error(`Server exited with code ${code}`));
147
+ }
148
+ });
149
+
150
+ // Manejar Ctrl+C
151
+ process.on('SIGINT', () => {
152
+ Print.newLine();
153
+ Print.info('Shutting down server...');
154
+ serverProcess.kill('SIGINT');
155
+ setTimeout(() => {
156
+ process.exit(0);
157
+ }, 100);
158
+ });
159
+
160
+ process.on('SIGTERM', () => {
161
+ serverProcess.kill('SIGTERM');
162
+ });
163
+
164
+ // Si después de 3 segundos no detectamos inicio, asumimos que está listo
165
+ setTimeout(() => {
166
+ if (!serverStarted) {
167
+ serverStarted = true;
168
+ Print.serverReady(port);
169
+ }
170
+ resolve(serverProcess);
171
+ }, 3000);
172
+ });
173
+ }
174
+
175
+ /**
176
+ * Función principal para iniciar servidor
177
+ */
178
+ export default async function startServer(options = {}) {
179
+ const config = loadConfig();
180
+ const defaultPort = config?.server?.port || 3000;
181
+
182
+ const { mode = 'development', port = defaultPort, watch = false } = options;
183
+
184
+ try {
185
+ Print.title(`🚀 Starting Slice.js ${mode} server...`);
186
+ Print.newLine();
187
+
188
+ // Verificar estructura del proyecto
189
+ if (!await checkDevelopmentStructure()) {
190
+ throw new Error('Project structure not found. Run "slice init" first.');
191
+ }
192
+
193
+ let actualPort = await isPortAvailable(port) ? port : port + 1; // Try one more port
194
+ if(actualPort !== port) {
195
+ // Check if the fallback is available
196
+ const fallbackAvailable = await isPortAvailable(actualPort);
197
+ if(!fallbackAvailable) {
198
+ throw new Error(`Ports ${port} and ${actualPort} are in use.`);
199
+ }
200
+ Print.info(`ℹ️ Port ${port} in use, using ${actualPort} instead.`);
201
+ }
202
+
203
+ Print.serverStatus('checking', `Port ${actualPort} available ✓`);
204
+ Print.newLine();
205
+
206
+ if (mode === 'production') {
207
+ // Verificar que existe build de producción
208
+ if (!await checkProductionBuild()) {
209
+ Print.info('No production build found. Running "slice build"...');
210
+ const success = await build({});
211
+ if (!success) {
212
+ throw new Error('Build failed. Cannot start production server.');
213
+ }
214
+ }
215
+ Print.info('Production mode: serving optimized files from /dist');
216
+ } else {
217
+ Print.info('Development mode: serving files from /src (HMR enabled)');
218
+ }
219
+
220
+ Print.newLine();
221
+
222
+ // Iniciar el servidor con argumentos
223
+ let serverProcess = await startNodeServer(actualPort, mode);
224
+
225
+ // Configurar watch mode si está habilitado
226
+ if (watch) {
227
+ Print.newLine();
228
+ const watcher = setupWatcher(serverProcess, async (changedPath) => {
229
+ if (serverProcess) {
230
+ serverProcess.kill();
231
+ }
232
+
233
+ // Short delay to ensure port is freed
234
+ await new Promise(r => setTimeout(r, 500));
235
+
236
+ try {
237
+ Print.info('🔄 File changed. Restarting server...');
238
+
239
+ serverProcess = await startNodeServer(actualPort, mode);
240
+ } catch (e) {
241
+ Print.error(`Failed to restart server: ${e.message}`);
242
+ }
243
+ });
244
+
245
+ // Cleanup en exit
246
+ const cleanup = () => {
247
+ stopWatcher(watcher);
248
+ };
249
+
250
+ process.on('SIGINT', cleanup);
251
+ process.on('SIGTERM', cleanup);
252
+ }
253
+
254
+ } catch (error) {
255
+ Print.newLine();
256
+ Print.error(error.message);
257
+ throw error;
258
+ }
259
+ }
260
+
261
+ /**
262
+ * Funciones de utilidad exportadas
263
+ */
264
+ export { checkProductionBuild, checkDevelopmentStructure, isPortAvailable };