@velsefy/cli 0.2.1 → 0.4.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.
package/README.md CHANGED
@@ -50,14 +50,12 @@ node dist/bin/velsefy.js --help
50
50
  | `velsefy theme install --sku <sku>` | Instala un tema del catálogo en tu tienda | token de acceso |
51
51
  | `velsefy theme pull --install <id> -o <dir>` | Descarga los assets de un tema instalado | token de acceso |
52
52
  | `velsefy theme push --install <id> --dir <dir>` | Sube cambios y borra en el servidor lo que eliminaste local (409 si hay conflicto) | token de acceso |
53
+ | `velsefy theme watch --install <id> --dir <dir>` | Vigila la carpeta y sube los cambios al guardar | token de acceso |
53
54
  | `velsefy theme publish --install <id>` | Activa el tema instalado en la tienda | token de acceso |
54
55
  | `velsefy theme preview --install <id> --session <token>` | URL de vista previa (necesita sesión de usuario) | token de acceso |
55
56
  | `velsefy theme validate --dir <dir>` | Validación LOCAL (Liquid/JSON/schema/paths/semver/inicio) | No requiere |
56
- | `velsefy theme create --sku <sku> --name "<Nombre>" [--from <baseSku>]` | Crea un tema base nuevo en el catálogo global | credenciales de plataforma |
57
- | `velsefy theme pull-catalog --sku <sku> -o <dir>` | Descarga los assets del **catálogo global** (el base) | credenciales de plataforma |
58
- | `velsefy theme release --sku <sku> --changelog "..." --dir <dir> --yes` | Publica una release al catálogo de temas | credenciales de plataforma |
59
- | `velsefy theme releases --sku <sku>` | Historial de releases del tema | credenciales de plataforma |
60
- | `velsefy theme rollback --sku <sku> --release <id>` | Vuelve a una release anterior como versión nueva | credenciales de plataforma |
57
+
58
+ > Los comandos de catálogo (`create`, `release`, `releases`, `rollback`, `pull-catalog`) son de plataforma y solo se registran con `VELSEFY_INTERNAL=1`. Con un token de tienda no aparecen ni funcionan.
61
59
 
62
60
  ---
63
61
 
@@ -87,19 +85,27 @@ velsefy theme publish --install <installId>
87
85
  Los borrados viajan con el push: si eliminas un archivo en local, deja de existir en la
88
86
  instalación. Sin cambios reales el push no hace peticiones.
89
87
 
90
- ### Publicar al catálogo global (solo plataforma)
88
+ Para no repetir el push a mano mientras diseñas:
91
89
 
92
90
  ```bash
93
- # descargar el tema base actual (editable)
94
- velsefy login --token <TU_TOKEN_DE_PLATAFORMA>
95
- velsefy theme pull-catalog --sku THEME-DEFAULT -o ./mi-tema
96
-
97
- # editar en VS Code… validar… y publicar la nueva versión
98
- velsefy theme validate --dir ./mi-tema
99
- velsefy theme release --sku THEME-DEFAULT --changelog "nuevo hero" --dir ./mi-tema --bump minor --yes
100
- # → { ok: true, version: 21, version_semver: "2.8.0" }
91
+ velsefy theme watch --install <installId> --dir ./mi-tema
92
+ # → "Vigilando ./mi-tema (install <installId>). Ctrl+C para salir."
101
93
  ```
102
94
 
95
+ Sube una sola vez por ráfaga de guardados, nunca sube algo que no cambió y cierra con
96
+ `Ctrl+C` subiendo lo pendiente. `--dry-run` muestra el plan sin tocar la tienda.
97
+
98
+ ### Recarga automática de la vista previa
99
+
100
+ `theme watch` abre un canal local en `127.0.0.1`; la vista previa lo usa para recargarse al guardar.
101
+
102
+ 1. Abre la vista previa del tema.
103
+ 2. Agrega `&live_reload=<puerto>` a la URL (la CLI imprime el puerto al arrancar).
104
+ 3. Guarda un archivo: la pestaña se recarga sola.
105
+
106
+ Solo escucha en `127.0.0.1` (nunca sale de tu equipo), no transporta datos del tema y no
107
+ afecta a la tienda pública. `--live-port 7317` fija el puerto; `--no-live-reload` lo desactiva.
108
+
103
109
  ---
104
110
 
105
111
  ## Almacenamiento de credenciales (seguro por SO)
@@ -1,6 +1,6 @@
1
1
  # 🎨 Desarrollo de Temas VELSEFY (Liquid)
2
2
 
3
- Guía para crear/modificar temas de tienda VELSEFY y publicarlos con `velsefy theme release`.
3
+ Guía para crear/modificar temas de tienda VELSEFY y publicarlos en tu tienda.
4
4
  Estructura fiel al estándar **Shopify Online Store 2.0**, con **versionado Shopify-pura** en `theme_info`.
5
5
 
6
6
  ---
@@ -56,12 +56,8 @@ La versión semver (`MAJOR.MINOR.PATCH`) vive **SOLO** en `config/settings_schem
56
56
  ```
57
57
 
58
58
  - La versión se lee de `theme_info.theme_version` (semver, única fuente en el tema).
59
- - La **versión del catálogo** (lo que se compara para "actualización disponible") la gestiona la plataforma al publicar.
60
- - Al publicar con `velsefy theme release`, el servidor **bump** la versión: `patch` por
61
- defecto, o `--bump minor` / `--bump major` cuando el cambio lo justifica.
62
- - Una release sin archivos modificados se rechaza: no se crean versiones vacías.
63
- - Los archivos que borres en local se borran del catálogo al publicar (el release
64
- guarda el estado resultante, así que un rollback nunca deja huérfanos).
59
+ - La versión debe ser semver válida; súbela cuando publiques cambios relevantes.
60
+ - Los archivos que borres en local se borran del servidor al hacer `theme push`.
65
61
 
66
62
  ---
67
63
 
@@ -184,7 +180,7 @@ Reutilizables vía `{% render 'nombre', parametros: valor %}`:
184
180
  ### Contexto
185
181
 
186
182
  - **Token de acceso de tu cuenta** → editas la **copia privada** de tu tema (pull/push).
187
- - **Credenciales de plataforma** (con permiso de publicación) → publicas al **catálogo global**.
183
+ - **`velsefy theme publish`** → activa el tema en tu tienda cuando está listo.
188
184
 
189
185
  ### Flujo de desarrollo (editar tu copia)
190
186
 
@@ -196,11 +192,12 @@ velsefy theme validate --dir ./mi-tema # validación local
196
192
  velsefy theme push --install <installId> --dir ./mi-tema # sube; 409 si hay conflictos
197
193
  ```
198
194
 
199
- ### Flujo de publicación al catálogo (plataforma)
195
+ ### Publicar tu tema en la tienda
200
196
 
201
197
  ```bash
202
- velsefy login --token <TU_TOKEN_DE_PLATAFORMA>
203
- velsefy theme release --sku THEME-DEFAULT --changelog "v2: nuevo hero" --dir ./mi-tema
198
+ velsefy theme validate --dir ./mi-tema # validación local
199
+ velsefy theme push --install <installId> --dir ./mi-tema # sube; 409 si hay conflictos
200
+ velsefy theme publish --install <installId> # lo activa en la tienda
204
201
  ```
205
202
 
206
203
  El servidor valida cada archivo **antes** de guardar:
@@ -223,7 +220,7 @@ velsefy theme validate --dir ./mi-tema
223
220
 
224
221
  No requiere token (operación 100% local). Chequea: balance Liquid (`{% %}`/`{{ }}`), **tipos de `settings[].type` del `{% schema %}` contra la whitelist** (y exige `id`), JSON válido, paths, semver y extrae `theme_info.theme_version`.
225
222
 
226
- > El servidor aplica la MISMA validación de tipos al publicar (`theme release`) → si usás un tipo no soportado, el publish devuelve `400 validation_failed`.
223
+ > El servidor aplica la MISMA validación de tipos al subir (`theme push`) → si usás un tipo no soportado, devuelve `400 validation_failed`.
227
224
 
228
225
  ### Autocompletado / errores en VS Code (opcional)
229
226
 
@@ -1,125 +1,12 @@
1
1
  import fs from "node:fs";
2
2
  import path from "node:path";
3
- import crypto from "node:crypto";
4
3
  import { fileURLToPath } from "node:url";
5
- import { validateThemePath } from "@velsefy/theme-validate";
6
4
  import { logger } from "../lib/logger.js";
7
5
  import { requireToken } from "../lib/credentials.js";
8
6
  import { createCatalogTheme, installThemeFromCatalog, listCatalogThemes, listReleases, listThemes, previewInstall, publishInstall, pullCatalogThemeAssets, pullThemeAssets, pushThemeAssets, releaseTheme, rollbackRelease, } from "../lib/api.js";
9
7
  import { validate } from "../lib/validate.js";
10
- const ALLOWED_DIRS = ["assets", "sections", "layout", "snippets", "config", "templates"];
11
- /** Extensiones que viajan en base64 (binario real). El resto es texto UTF-8. */
12
- const BINARY_EXTENSIONS = new Set([
13
- "png", "jpg", "jpeg", "webp", "gif", "ico", "woff", "woff2", "ttf",
14
- ]);
15
- const STATE_FILE = ".velsefy-state.json";
16
- function extOf(filePath) {
17
- return path.extname(filePath).replace(/^\./, "").toLowerCase();
18
- }
19
- function isBinary(filePath) {
20
- return BINARY_EXTENSIONS.has(extOf(filePath));
21
- }
22
- function hashOf(content) {
23
- return crypto.createHash("sha256").update(content).digest("hex");
24
- }
25
- /** Hash del archivo tal como está en disco (binarios: bytes reales). */
26
- function hashOfAsset(assetPath, content) {
27
- return hashOf(isBinary(assetPath) ? Buffer.from(content, "base64") : content);
28
- }
29
- function walkTree(root) {
30
- const out = [];
31
- const stack = [root];
32
- while (stack.length > 0) {
33
- const current = stack.pop();
34
- const stat = fs.lstatSync(current);
35
- if (stat.isSymbolicLink())
36
- continue;
37
- if (stat.isDirectory()) {
38
- for (const name of fs.readdirSync(current)) {
39
- if (name.startsWith("."))
40
- continue;
41
- stack.push(path.join(current, name));
42
- }
43
- }
44
- else {
45
- out.push(current);
46
- }
47
- }
48
- return out;
49
- }
50
- /** Une las opciones `--only` (paths o prefijos) con el listado completo. */
51
- function matchesOnly(relative, only) {
52
- if (!only || only.length === 0)
53
- return true;
54
- return only.some((entry) => relative === entry || relative.startsWith(entry.endsWith("/") ? entry : `${entry}/`));
55
- }
56
- /**
57
- * Lee el tema local: recorre SOLO las carpetas permitidas, ignora symlinks y
58
- * archivos ocultos, y codifica binarios en base64 (el servidor guarda texto).
59
- */
60
- function readAssetsFromDir(dir, only) {
61
- if (!fs.existsSync(dir))
62
- throw new Error(`El directorio del tema no existe: ${dir}`);
63
- const assets = [];
64
- const hashes = {};
65
- for (const folder of ALLOWED_DIRS) {
66
- const fullFolder = path.join(dir, folder);
67
- if (!fs.existsSync(fullFolder))
68
- continue;
69
- for (const file of walkTree(fullFolder)) {
70
- const relative = path.relative(dir, file).split(path.sep).join("/");
71
- if (!matchesOnly(relative, only))
72
- continue;
73
- if (!validateThemePath(relative)) {
74
- throw new Error(`Path inválido en el tema local: ${relative}`);
75
- }
76
- const raw = fs.readFileSync(file);
77
- const content = isBinary(relative) ? raw.toString("base64") : raw.toString("utf8");
78
- assets.push({ path: relative, content });
79
- hashes[relative] = hashOf(raw);
80
- }
81
- }
82
- return { assets, hashes };
83
- }
84
- /** Escribe un asset respetando binario (base64) vs texto. */
85
- function writeAsset(targetDir, assetPath, content) {
86
- const target = path.join(targetDir, assetPath.split("/").join(path.sep));
87
- fs.mkdirSync(path.dirname(target), { recursive: true });
88
- if (isBinary(assetPath)) {
89
- fs.writeFileSync(target, Buffer.from(content, "base64"));
90
- }
91
- else {
92
- fs.writeFileSync(target, content, "utf8");
93
- }
94
- }
95
- function statePath(dir) {
96
- return path.join(dir, STATE_FILE);
97
- }
98
- function readState(dir) {
99
- try {
100
- const parsed = JSON.parse(fs.readFileSync(statePath(dir), "utf8"));
101
- return {
102
- installId: typeof parsed.installId === "string" ? parsed.installId : undefined,
103
- sku: typeof parsed.sku === "string" ? parsed.sku : undefined,
104
- baseUpdatedAt: typeof parsed.baseUpdatedAt === "string" ? parsed.baseUpdatedAt : undefined,
105
- files: parsed.files && typeof parsed.files === "object" ? parsed.files : {},
106
- };
107
- }
108
- catch {
109
- return null;
110
- }
111
- }
112
- function writeState(dir, state) {
113
- fs.mkdirSync(dir, { recursive: true });
114
- fs.writeFileSync(statePath(dir), JSON.stringify(state, null, 2), "utf8");
115
- }
116
- function maxUpdatedAt(assets) {
117
- const max = assets.reduce((acc, asset) => {
118
- const ts = asset.updated_at ?? asset.updatedAt ?? null;
119
- return ts && (!acc || new Date(ts).getTime() > new Date(acc).getTime()) ? ts : acc;
120
- }, null);
121
- return max ?? undefined;
122
- }
8
+ import { hashOfAsset, matchesOnly, maxUpdatedAt, readAssetsFromDir, readState, writeAsset, writeState, walkTree, STATE_FILE, } from "../lib/themeAssets.js";
9
+ import { registerWatchCommand } from "./watch.js";
123
10
  /** El directorio de salida debe estar vacío (o usar --force). */
124
11
  function assertWritableDir(dir, force) {
125
12
  if (!fs.existsSync(dir))
@@ -153,6 +40,8 @@ function copyDir(source, target) {
153
40
  }
154
41
  return count;
155
42
  }
43
+ /** Los comandos de catálogo son de plataforma: solo se registran con VELSEFY_INTERNAL=1. */
44
+ const IS_INTERNAL = process.env.VELSEFY_INTERNAL === "1";
156
45
  export function themeCommand(program) {
157
46
  const theme = program.command("theme").description("Gestiona los temas de VELSEFY");
158
47
  theme
@@ -219,27 +108,31 @@ export function themeCommand(program) {
219
108
  });
220
109
  logger.success(`Descargados ${assets.length} asset(s) en ${output}.`);
221
110
  });
222
- theme
223
- .command("pull-catalog")
224
- .description("Descarga los assets del tema base del catálogo")
225
- .requiredOption("--sku <sku>", "SKU del tema del catálogo")
226
- .option("-o, --output <dir>", "Directorio de salida", "./theme-local")
227
- .option("--force", "Sobrescribe el directorio si no está vacío")
228
- .option("--only <paths...>", "Descarga solo estos paths o carpetas")
229
- .action(async (options) => {
230
- const token = requireToken("theme pull-catalog");
231
- const output = options.output;
232
- assertWritableDir(output, options.force);
233
- const all = await pullCatalogThemeAssets(token, options.sku);
234
- const assets = all.filter((asset) => matchesOnly(asset.path, options.only));
235
- for (const asset of assets)
236
- writeAsset(output, asset.path, asset.content);
237
- const files = {};
238
- for (const asset of assets)
239
- files[asset.path] = hashOfAsset(asset.path, asset.content);
240
- writeState(output, { sku: options.sku, files });
241
- logger.success(`Descargados ${assets.length} asset(s) del catálogo en ${output}.`);
242
- });
111
+ // Los comandos de catálogo son de plataforma: un token de tienda responde 403.
112
+ // Solo se registran con VELSEFY_INTERNAL=1 para no exponerlos en el --help público.
113
+ if (IS_INTERNAL) {
114
+ theme
115
+ .command("pull-catalog")
116
+ .description("Descarga los assets del tema base del catálogo")
117
+ .requiredOption("--sku <sku>", "SKU del tema del catálogo")
118
+ .option("-o, --output <dir>", "Directorio de salida", "./theme-local")
119
+ .option("--force", "Sobrescribe el directorio si no está vacío")
120
+ .option("--only <paths...>", "Descarga solo estos paths o carpetas")
121
+ .action(async (options) => {
122
+ const token = requireToken("theme pull-catalog");
123
+ const output = options.output;
124
+ assertWritableDir(output, options.force);
125
+ const all = await pullCatalogThemeAssets(token, options.sku);
126
+ const assets = all.filter((asset) => matchesOnly(asset.path, options.only));
127
+ for (const asset of assets)
128
+ writeAsset(output, asset.path, asset.content);
129
+ const files = {};
130
+ for (const asset of assets)
131
+ files[asset.path] = hashOfAsset(asset.path, asset.content);
132
+ writeState(output, { sku: options.sku, files });
133
+ logger.success(`Descargados ${assets.length} asset(s) del catálogo en ${output}.`);
134
+ });
135
+ }
243
136
  theme
244
137
  .command("push")
245
138
  .description("Sube el tema local al tema instalado (valida antes)")
@@ -306,6 +199,7 @@ export function themeCommand(program) {
306
199
  writeState(dir, {
307
200
  installId: options.install,
308
201
  baseUpdatedAt: result.updatedAt,
202
+ sku: state?.sku,
309
203
  files: nextFiles,
310
204
  });
311
205
  logger.success(`Subidos ${assets.length} archivo(s)${deletedPaths.length ? `, eliminados ${deletedPaths.length}` : ""}.`);
@@ -315,6 +209,7 @@ export function themeCommand(program) {
315
209
  process.exitCode = 1;
316
210
  }
317
211
  });
212
+ registerWatchCommand(theme);
318
213
  theme
319
214
  .command("install")
320
215
  .description("Instala un tema del catálogo en tu tienda")
@@ -356,136 +251,138 @@ export function themeCommand(program) {
356
251
  throw new Error("El servidor no devolvió una URL de preview.");
357
252
  logger.success(result.url);
358
253
  });
359
- theme
360
- .command("catalog")
361
- .description("Lista los temas del catálogo global")
362
- .option("--json", "Salida JSON")
363
- .action(async (options) => {
364
- const token = requireToken("theme catalog");
365
- const themes = await listCatalogThemes(token);
366
- if (options.json) {
367
- console.log(JSON.stringify({ themes }, null, 2));
368
- return;
369
- }
370
- logger.bold("SKU\tNOMBRE\tVERSIÓN\tBASE");
371
- for (const item of themes) {
372
- logger.info(`${item.sku}\t${item.name}\t${item.version_semver ?? "-"}\t${item.is_default ? "sí" : "no"}`);
373
- }
374
- });
375
- theme
376
- .command("create")
377
- .description("Crea un tema base nuevo en el catálogo global")
378
- .requiredOption("--sku <sku>", "SKU del nuevo tema base")
379
- .requiredOption("--name <nombre>", "Nombre del nuevo tema base")
380
- .option("--from <baseSku>", "SKU del tema base del que clonar (opcional)")
381
- .action(async (options) => {
382
- const token = requireToken("theme create");
383
- const result = await createCatalogTheme(token, options.sku, options.name, options.from);
384
- logger.success(`Tema base creado: ${result.sku}`);
385
- });
386
- theme
387
- .command("release")
388
- .description("Publica una release del tema local al catálogo")
389
- .requiredOption("--sku <sku>", "SKU del catálogo")
390
- .option("--changelog <texto>", "Notas de la release")
391
- .option("--dir <dir>", "Directorio del tema local", "./theme-local")
392
- .option("--bump <tipo>", "Tipo de bump: patch | minor | major", "patch")
393
- .option("--deleted <paths...>", "Paths eliminados que se borran del catálogo")
394
- .option("--dry-run", "Muestra qué se publicaría sin escribir")
395
- .option("--yes", "No pide confirmación")
396
- .action(async (options) => {
397
- const token = requireToken("theme release");
398
- const dir = options.dir;
399
- try {
400
- const result = validate(dir);
401
- if (!result.valid) {
402
- for (const issue of result.issues)
403
- logger.warn(`${issue.file}: ${issue.message}`);
404
- throw new Error("El tema no es válido: la release fue cancelada.");
254
+ if (IS_INTERNAL) {
255
+ theme
256
+ .command("catalog")
257
+ .description("Lista los temas del catálogo global")
258
+ .option("--json", "Salida JSON")
259
+ .action(async (options) => {
260
+ const token = requireToken("theme catalog");
261
+ const themes = await listCatalogThemes(token);
262
+ if (options.json) {
263
+ console.log(JSON.stringify({ themes }, null, 2));
264
+ return;
405
265
  }
406
- const { assets, hashes } = readAssetsFromDir(dir);
407
- const state = readState(dir);
408
- const sameBase = state?.sku === options.sku;
409
- const deletedPaths = options.deleted && options.deleted.length > 0
410
- ? options.deleted
411
- : sameBase
412
- ? Object.keys(state.files).filter((p) => !(p in hashes))
413
- : [];
414
- if (assets.length === 0 && deletedPaths.length === 0) {
415
- throw new Error("No hay archivos para publicar en ese directorio.");
266
+ logger.bold("SKU\tNOMBRE\tVERSIÓN\tBASE");
267
+ for (const item of themes) {
268
+ logger.info(`${item.sku}\t${item.name}\t${item.version_semver ?? "-"}\t${item.is_default ? "sí" : "no"}`);
416
269
  }
417
- // Sin cambios reales no se crea una versión vacía (ensuciaría el historial).
418
- const changed = sameBase
419
- ? assets.filter((asset) => state.files[asset.path] !== hashes[asset.path])
420
- : assets;
421
- if (sameBase && changed.length === 0 && deletedPaths.length === 0) {
422
- throw new Error("No hay cambios desde la última versión: la release sería idéntica. " +
423
- "Modifica archivos (o usa `theme pull-catalog` si el tema local está viejo).");
270
+ });
271
+ theme
272
+ .command("create")
273
+ .description("Crea un tema base nuevo en el catálogo global")
274
+ .requiredOption("--sku <sku>", "SKU del nuevo tema base")
275
+ .requiredOption("--name <nombre>", "Nombre del nuevo tema base")
276
+ .option("--from <baseSku>", "SKU del tema base del que clonar (opcional)")
277
+ .action(async (options) => {
278
+ const token = requireToken("theme create");
279
+ const result = await createCatalogTheme(token, options.sku, options.name, options.from);
280
+ logger.success(`Tema base creado: ${result.sku}`);
281
+ });
282
+ theme
283
+ .command("release")
284
+ .description("Publica una release del tema local al catálogo")
285
+ .requiredOption("--sku <sku>", "SKU del catálogo")
286
+ .option("--changelog <texto>", "Notas de la release")
287
+ .option("--dir <dir>", "Directorio del tema local", "./theme-local")
288
+ .option("--bump <tipo>", "Tipo de bump: patch | minor | major", "patch")
289
+ .option("--deleted <paths...>", "Paths eliminados que se borran del catálogo")
290
+ .option("--dry-run", "Muestra qué se publicaría sin escribir")
291
+ .option("--yes", "No pide confirmación")
292
+ .action(async (options) => {
293
+ const token = requireToken("theme release");
294
+ const dir = options.dir;
295
+ try {
296
+ const result = validate(dir);
297
+ if (!result.valid) {
298
+ for (const issue of result.issues)
299
+ logger.warn(`${issue.file}: ${issue.message}`);
300
+ throw new Error("El tema no es válido: la release fue cancelada.");
301
+ }
302
+ const { assets, hashes } = readAssetsFromDir(dir);
303
+ const state = readState(dir);
304
+ const sameBase = state?.sku === options.sku;
305
+ const deletedPaths = options.deleted && options.deleted.length > 0
306
+ ? options.deleted
307
+ : sameBase
308
+ ? Object.keys(state.files).filter((p) => !(p in hashes))
309
+ : [];
310
+ if (assets.length === 0 && deletedPaths.length === 0) {
311
+ throw new Error("No hay archivos para publicar en ese directorio.");
312
+ }
313
+ // Sin cambios reales no se crea una versión vacía (ensuciaría el historial).
314
+ const changed = sameBase
315
+ ? assets.filter((asset) => state.files[asset.path] !== hashes[asset.path])
316
+ : assets;
317
+ if (sameBase && changed.length === 0 && deletedPaths.length === 0) {
318
+ throw new Error("No hay cambios desde la última versión: la release sería idéntica. " +
319
+ "Modifica archivos (o usa `theme pull-catalog` si el tema local está viejo).");
320
+ }
321
+ const bump = (options.bump || "patch").toLowerCase();
322
+ if (!["patch", "minor", "major"].includes(bump)) {
323
+ throw new Error("--bump debe ser patch, minor o major.");
324
+ }
325
+ const changelog = `${bump !== "patch" ? `[${bump}] ` : ""}${options.changelog ?? ""}`.trim();
326
+ if (options.dryRun) {
327
+ logger.info(`[dry-run] release ${options.sku}: ${changed.length} archivo(s) modificado(s), ` +
328
+ `${deletedPaths.length} baja(s), bump=${bump}.`);
329
+ return;
330
+ }
331
+ if (!options.yes) {
332
+ logger.warn(`Vas a publicar ${assets.length} archivo(s) (${changed.length} modificado(s)) y ` +
333
+ `${deletedPaths.length} baja(s) en ${options.sku}. Repite con --yes para confirmar.`);
334
+ process.exitCode = 1;
335
+ return;
336
+ }
337
+ const res = await releaseTheme(token, options.sku, changelog || undefined, assets, deletedPaths);
338
+ const version = res.version_semver ?? (res.version !== undefined ? String(res.version) : "");
339
+ logger.success(`Release creada: ${options.sku}@${version}${res.deleted ? ` (${res.deleted} baja(s))` : ""}`);
340
+ // El tema local queda sincronizado con lo publicado.
341
+ const nextFiles = { ...(state?.files ?? {}) };
342
+ for (const p of deletedPaths)
343
+ delete nextFiles[p];
344
+ Object.assign(nextFiles, hashes);
345
+ writeState(dir, {
346
+ installId: state?.installId,
347
+ baseUpdatedAt: state?.baseUpdatedAt,
348
+ sku: options.sku,
349
+ files: nextFiles,
350
+ });
424
351
  }
425
- const bump = (options.bump || "patch").toLowerCase();
426
- if (!["patch", "minor", "major"].includes(bump)) {
427
- throw new Error("--bump debe ser patch, minor o major.");
352
+ catch (err) {
353
+ logger.error(err instanceof Error ? err.message : String(err));
354
+ process.exitCode = 1;
428
355
  }
429
- const changelog = `${bump !== "patch" ? `[${bump}] ` : ""}${options.changelog ?? ""}`.trim();
430
- if (options.dryRun) {
431
- logger.info(`[dry-run] release ${options.sku}: ${changed.length} archivo(s) modificado(s), ` +
432
- `${deletedPaths.length} baja(s), bump=${bump}.`);
356
+ });
357
+ theme
358
+ .command("releases")
359
+ .description("Lista las releases del catálogo")
360
+ .requiredOption("--sku <sku>", "SKU del catálogo")
361
+ .option("--json", "Salida JSON")
362
+ .action(async (options) => {
363
+ const token = requireToken("theme releases");
364
+ const releases = await listReleases(token, options.sku);
365
+ if (options.json) {
366
+ console.log(JSON.stringify({ releases }, null, 2));
433
367
  return;
434
368
  }
435
- if (!options.yes) {
436
- logger.warn(`Vas a publicar ${assets.length} archivo(s) (${changed.length} modificado(s)) y ` +
437
- `${deletedPaths.length} baja(s) en ${options.sku}. Repite con --yes para confirmar.`);
438
- process.exitCode = 1;
439
- return;
369
+ logger.bold("ID\tVERSIÓN\tESTADO\tCHANGELOG");
370
+ for (const item of releases) {
371
+ logger.info(`${item.id}\t${item.version}\t${item.status}\t${item.changelog ?? ""}`);
440
372
  }
441
- const res = await releaseTheme(token, options.sku, changelog || undefined, assets, deletedPaths);
442
- const version = res.version_semver ?? (res.version !== undefined ? String(res.version) : "");
443
- logger.success(`Release creada: ${options.sku}@${version}${res.deleted ? ` (${res.deleted} baja(s))` : ""}`);
444
- // El tema local queda sincronizado con lo publicado.
445
- const nextFiles = { ...(state?.files ?? {}) };
446
- for (const p of deletedPaths)
447
- delete nextFiles[p];
448
- Object.assign(nextFiles, hashes);
449
- writeState(dir, {
450
- installId: state?.installId,
451
- baseUpdatedAt: state?.baseUpdatedAt,
452
- sku: options.sku,
453
- files: nextFiles,
454
- });
455
- }
456
- catch (err) {
457
- logger.error(err instanceof Error ? err.message : String(err));
458
- process.exitCode = 1;
459
- }
460
- });
461
- theme
462
- .command("releases")
463
- .description("Lista las releases del catálogo")
464
- .requiredOption("--sku <sku>", "SKU del catálogo")
465
- .option("--json", "Salida JSON")
466
- .action(async (options) => {
467
- const token = requireToken("theme releases");
468
- const releases = await listReleases(token, options.sku);
469
- if (options.json) {
470
- console.log(JSON.stringify({ releases }, null, 2));
471
- return;
472
- }
473
- logger.bold("ID\tVERSIÓN\tESTADO\tCHANGELOG");
474
- for (const item of releases) {
475
- logger.info(`${item.id}\t${item.version}\t${item.status}\t${item.changelog ?? ""}`);
476
- }
477
- });
478
- theme
479
- .command("rollback")
480
- .description("Revierte el catálogo a una release anterior")
481
- .requiredOption("--sku <sku>", "SKU del catálogo")
482
- .requiredOption("--release <id>", "ID de la release")
483
- .action(async (options) => {
484
- const token = requireToken("theme rollback");
485
- const result = await rollbackRelease(token, options.sku, options.release);
486
- const version = result.version_semver ?? (result.version !== undefined ? String(result.version) : "");
487
- logger.success(`Rollback publicado: ${options.sku}@${version} (vuelve a la versión ${result.from_version ?? "?"}).`);
488
- });
373
+ });
374
+ theme
375
+ .command("rollback")
376
+ .description("Revierte el catálogo a una release anterior")
377
+ .requiredOption("--sku <sku>", "SKU del catálogo")
378
+ .requiredOption("--release <id>", "ID de la release")
379
+ .action(async (options) => {
380
+ const token = requireToken("theme rollback");
381
+ const result = await rollbackRelease(token, options.sku, options.release);
382
+ const version = result.version_semver ?? (result.version !== undefined ? String(result.version) : "");
383
+ logger.success(`Rollback publicado: ${options.sku}@${version} (vuelve a la versión ${result.from_version ?? "?"}).`);
384
+ });
385
+ }
489
386
  theme
490
387
  .command("validate")
491
388
  .description("Valida un tema local (Liquid, JSON, schema, semver, paths)")