@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 +20 -14
- package/THEME-DEVELOPMENT.md +9 -12
- package/dist/commands/theme.js +156 -259
- package/dist/commands/theme.js.map +1 -1
- package/dist/commands/watch.d.ts +2 -0
- package/dist/commands/watch.js +487 -0
- package/dist/commands/watch.js.map +1 -0
- package/dist/lib/liveReload.d.ts +14 -0
- package/dist/lib/liveReload.js +143 -0
- package/dist/lib/liveReload.js.map +1 -0
- package/dist/lib/themeAssets.d.ts +42 -0
- package/dist/lib/themeAssets.js +135 -0
- package/dist/lib/themeAssets.js.map +1 -0
- package/dist/lib/watchPlan.d.ts +16 -0
- package/dist/lib/watchPlan.js +21 -0
- package/dist/lib/watchPlan.js.map +1 -0
- package/package.json +5 -2
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
|
-
|
|
57
|
-
|
|
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
|
-
|
|
88
|
+
Para no repetir el push a mano mientras diseñas:
|
|
91
89
|
|
|
92
90
|
```bash
|
|
93
|
-
|
|
94
|
-
|
|
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)
|
package/THEME-DEVELOPMENT.md
CHANGED
|
@@ -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
|
|
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
|
|
60
|
-
-
|
|
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
|
-
-
|
|
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
|
-
###
|
|
195
|
+
### Publicar tu tema en la tienda
|
|
200
196
|
|
|
201
197
|
```bash
|
|
202
|
-
velsefy
|
|
203
|
-
velsefy theme
|
|
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
|
|
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
|
|
package/dist/commands/theme.js
CHANGED
|
@@ -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
|
-
|
|
11
|
-
|
|
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
|
-
|
|
223
|
-
|
|
224
|
-
|
|
225
|
-
|
|
226
|
-
|
|
227
|
-
|
|
228
|
-
|
|
229
|
-
|
|
230
|
-
|
|
231
|
-
|
|
232
|
-
|
|
233
|
-
|
|
234
|
-
|
|
235
|
-
|
|
236
|
-
|
|
237
|
-
|
|
238
|
-
|
|
239
|
-
|
|
240
|
-
|
|
241
|
-
|
|
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
|
-
|
|
360
|
-
|
|
361
|
-
|
|
362
|
-
|
|
363
|
-
|
|
364
|
-
|
|
365
|
-
|
|
366
|
-
|
|
367
|
-
|
|
368
|
-
|
|
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
|
-
|
|
407
|
-
const
|
|
408
|
-
|
|
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
|
-
|
|
418
|
-
|
|
419
|
-
|
|
420
|
-
|
|
421
|
-
|
|
422
|
-
|
|
423
|
-
|
|
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
|
-
|
|
426
|
-
|
|
427
|
-
|
|
352
|
+
catch (err) {
|
|
353
|
+
logger.error(err instanceof Error ? err.message : String(err));
|
|
354
|
+
process.exitCode = 1;
|
|
428
355
|
}
|
|
429
|
-
|
|
430
|
-
|
|
431
|
-
|
|
432
|
-
|
|
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
|
-
|
|
436
|
-
|
|
437
|
-
|
|
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
|
-
|
|
442
|
-
|
|
443
|
-
|
|
444
|
-
|
|
445
|
-
|
|
446
|
-
|
|
447
|
-
|
|
448
|
-
|
|
449
|
-
|
|
450
|
-
|
|
451
|
-
|
|
452
|
-
|
|
453
|
-
|
|
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)")
|