@velsefy/cli 0.1.1 → 0.2.1

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
@@ -45,13 +45,19 @@ node dist/bin/velsefy.js --help
45
45
  |---|---|---|
46
46
  | `velsefy login --token <token>` | Guarda el token (almacén seguro del SO) | — |
47
47
  | `velsefy logout` | Elimina el token guardado | — |
48
- | `velsefy theme list` | Lista los temas instalados de tu tienda | token de acceso |
48
+ | `velsefy theme init [dir]` | Crea un tema local desde el starter oficial (ya válido) | — |
49
+ | `velsefy theme list [--json]` | Lista los temas instalados de tu tienda | token de acceso |
50
+ | `velsefy theme install --sku <sku>` | Instala un tema del catálogo en tu tienda | token de acceso |
49
51
  | `velsefy theme pull --install <id> -o <dir>` | Descarga los assets de un tema instalado | token de acceso |
50
- | `velsefy theme pull-catalog --sku <sku> -o <dir>` | Descarga los assets del **catálogo global** (el base) | credenciales de plataforma |
51
- | `velsefy theme push --install <id> --dir <dir>` | Sube los assets (con detección de 409/ETag) | token de acceso |
52
- | `velsefy theme validate --dir <dir>` | Validación LOCAL (Liquid/JSON/paths/semver) | No requiere |
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 publish --install <id>` | Activa el tema instalado en la tienda | token de acceso |
54
+ | `velsefy theme preview --install <id> --session <token>` | URL de vista previa (necesita sesión de usuario) | token de acceso |
55
+ | `velsefy theme validate --dir <dir>` | Validación LOCAL (Liquid/JSON/schema/paths/semver/inicio) | No requiere |
53
56
  | `velsefy theme create --sku <sku> --name "<Nombre>" [--from <baseSku>]` | Crea un tema base nuevo en el catálogo global | credenciales de plataforma |
54
- | `velsefy theme release --sku <sku> --changelog "..." --dir <dir>` | Publica una release al catálogo de temas | 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 |
55
61
 
56
62
  ---
57
63
 
@@ -72,8 +78,15 @@ velsefy theme validate --dir ./mi-tema
72
78
 
73
79
  # subir los cambios (409 si hubo conflicto en otro lado)
74
80
  velsefy theme push --install <installId> --dir ./mi-tema
81
+
82
+ # verlo sin activarlo, y activarlo cuando esté listo
83
+ velsefy theme preview --install <installId> --session <sessionToken>
84
+ velsefy theme publish --install <installId>
75
85
  ```
76
86
 
87
+ Los borrados viajan con el push: si eliminas un archivo en local, deja de existir en la
88
+ instalación. Sin cambios reales el push no hace peticiones.
89
+
77
90
  ### Publicar al catálogo global (solo plataforma)
78
91
 
79
92
  ```bash
@@ -83,8 +96,8 @@ velsefy theme pull-catalog --sku THEME-DEFAULT -o ./mi-tema
83
96
 
84
97
  # editar en VS Code… validar… y publicar la nueva versión
85
98
  velsefy theme validate --dir ./mi-tema
86
- velsefy theme release --sku THEME-DEFAULT --changelog "[minor] nuevo hero" --dir ./mi-tema
87
- # → { ok: true, version: 1 }
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" }
88
101
  ```
89
102
 
90
103
  ---
@@ -57,7 +57,11 @@ La versión semver (`MAJOR.MINOR.PATCH`) vive **SOLO** en `config/settings_schem
57
57
 
58
58
  - La versión se lee de `theme_info.theme_version` (semver, única fuente en el tema).
59
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 defecto; `[major]`/`[minor]` en el changelog para subir major/minor).
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).
61
65
 
62
66
  ---
63
67
 
@@ -1,5 +1,7 @@
1
1
  import type { Command } from "commander";
2
2
  export interface LoginOptions {
3
3
  token?: string;
4
+ tokenStdin?: boolean;
5
+ verify?: boolean;
4
6
  }
5
7
  export declare function loginCommand(program: Command): void;
@@ -1,16 +1,49 @@
1
+ import fs from "node:fs";
1
2
  import { logger } from "../lib/logger.js";
2
3
  import { setToken } from "../lib/credentials.js";
4
+ import { listCatalogThemes, listThemes } from "../lib/api.js";
5
+ /** Prefijos válidos de token: personal (pat), app (tok) y plataforma (dev). */
6
+ const TOKEN_PREFIX = /^vls_(tok|dev|pat)_[A-Za-z0-9._-]{10,}$/;
7
+ function readStdinToken() {
8
+ try {
9
+ return fs.readFileSync(0, "utf8").trim();
10
+ }
11
+ catch {
12
+ return "";
13
+ }
14
+ }
3
15
  export function loginCommand(program) {
4
16
  program
5
17
  .command("login")
6
18
  .description("Guarda un token de acceso de VELSEFY")
7
- // TODO: OAuth Device Flow (RFC 8628) interactivo no implementado aún.
8
- // Por ahora se acepta un token de acceso (PAT) emitido desde tu cuenta VELSEFY.
9
- .requiredOption("--token <token>", "Token de acceso de VELSEFY")
10
- .action((options) => {
19
+ // TODO: OAuth Device Flow (RFC 8628) interactivo.
20
+ // Por ahora se acepta un token emitido desde tu cuenta (vls_pat_/vls_tok_) o
21
+ // un token de plataforma (vls_dev_) para publicar al catálogo.
22
+ .option("--token <token>", "Token de acceso (evita pasarlo por argv en CI)")
23
+ .option("--token-stdin", "Lee el token desde stdin (recomendado en CI)")
24
+ .option("--verify", "Verifica el token contra la API antes de guardarlo")
25
+ .action(async (options) => {
11
26
  try {
12
- setToken(options.token);
27
+ const raw = options.tokenStdin ? readStdinToken() : options.token;
28
+ const token = (raw ?? "").trim();
29
+ if (!token) {
30
+ throw new Error("Falta el token: usa --token <t> o --token-stdin.");
31
+ }
32
+ if (!TOKEN_PREFIX.test(token)) {
33
+ throw new Error("El token no tiene un formato válido (vls_pat_, vls_tok_ o vls_dev_).");
34
+ }
35
+ if (options.verify) {
36
+ if (token.startsWith("vls_dev_")) {
37
+ await listCatalogThemes(token);
38
+ }
39
+ else {
40
+ await listThemes(token);
41
+ }
42
+ }
43
+ setToken(token);
13
44
  logger.success("Credenciales guardadas.");
45
+ if (options.verify)
46
+ logger.muted("Token verificado contra la API.");
14
47
  }
15
48
  catch (err) {
16
49
  logger.error(err instanceof Error ? err.message : String(err));
@@ -1 +1 @@
1
- {"version":3,"file":"login.js","sourceRoot":"","sources":["../../src/commands/login.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAMjD,MAAM,UAAU,YAAY,CAAC,OAAgB;IAC3C,OAAO;SACJ,OAAO,CAAC,OAAO,CAAC;SAChB,WAAW,CAAC,sCAAsC,CAAC;QACpD,sEAAsE;QACtE,gFAAgF;SAC/E,cAAc,CAAC,iBAAiB,EAAE,4BAA4B,CAAC;SAC/D,MAAM,CAAC,CAAC,OAAqB,EAAE,EAAE;QAChC,IAAI,CAAC;YACH,QAAQ,CAAC,OAAO,CAAC,KAAe,CAAC,CAAC;YAClC,MAAM,CAAC,OAAO,CAAC,yBAAyB,CAAC,CAAC;QAC5C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,KAAK,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;YAC/D,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACvB,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}
1
+ {"version":3,"file":"login.js","sourceRoot":"","sources":["../../src/commands/login.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AAEzB,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAQ9D,+EAA+E;AAC/E,MAAM,YAAY,GAAG,yCAAyC,CAAC;AAE/D,SAAS,cAAc;IACrB,IAAI,CAAC;QACH,OAAO,EAAE,CAAC,YAAY,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;IAC3C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,OAAgB;IAC3C,OAAO;SACJ,OAAO,CAAC,OAAO,CAAC;SAChB,WAAW,CAAC,sCAAsC,CAAC;QACpD,kDAAkD;QAClD,6EAA6E;QAC7E,+DAA+D;SAC9D,MAAM,CAAC,iBAAiB,EAAE,gDAAgD,CAAC;SAC3E,MAAM,CAAC,eAAe,EAAE,8CAA8C,CAAC;SACvE,MAAM,CAAC,UAAU,EAAE,oDAAoD,CAAC;SACxE,MAAM,CAAC,KAAK,EAAE,OAAqB,EAAE,EAAE;QACtC,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;YAClE,MAAM,KAAK,GAAG,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;YACjC,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;YACtE,CAAC;YACD,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC9B,MAAM,IAAI,KAAK,CAAC,sEAAsE,CAAC,CAAC;YAC1F,CAAC;YAED,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;gBACnB,IAAI,KAAK,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;oBACjC,MAAM,iBAAiB,CAAC,KAAK,CAAC,CAAC;gBACjC,CAAC;qBAAM,CAAC;oBACN,MAAM,UAAU,CAAC,KAAK,CAAC,CAAC;gBAC1B,CAAC;YACH,CAAC;YAED,QAAQ,CAAC,KAAK,CAAC,CAAC;YAChB,MAAM,CAAC,OAAO,CAAC,yBAAyB,CAAC,CAAC;YAC1C,IAAI,OAAO,CAAC,MAAM;gBAAE,MAAM,CAAC,KAAK,CAAC,iCAAiC,CAAC,CAAC;QACtE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,KAAK,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;YAC/D,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACvB,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}