@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
|
@@ -0,0 +1,143 @@
|
|
|
1
|
+
import http from "node:http";
|
|
2
|
+
// ─── Live reload local ──────────────────────────────────────────────────────
|
|
3
|
+
// El watcher abre un canal en 127.0.0.1 y la vista previa (solo ella) se
|
|
4
|
+
// conecta para recargarse al guardar. Nunca se expone fuera de la máquina:
|
|
5
|
+
// - bind explícito a 127.0.0.1
|
|
6
|
+
// - una sola ruta (GET /events), todo lo demás 404
|
|
7
|
+
// - sin datos del tema: solo avisa "cambió algo"
|
|
8
|
+
const HOST = "127.0.0.1";
|
|
9
|
+
const MIN_PORT = 1024;
|
|
10
|
+
const MAX_PORT = 65535;
|
|
11
|
+
const HEARTBEAT_MS = 15_000;
|
|
12
|
+
/** Valida el puerto pedido por el usuario; null si no es usable. */
|
|
13
|
+
export function parseLivePort(raw) {
|
|
14
|
+
if (raw === undefined)
|
|
15
|
+
return null;
|
|
16
|
+
const value = raw.trim();
|
|
17
|
+
if (!/^\d+$/.test(value)) {
|
|
18
|
+
throw new Error("--live-port debe ser un número entre 1024 y 65535.");
|
|
19
|
+
}
|
|
20
|
+
const port = Number(value);
|
|
21
|
+
if (!Number.isSafeInteger(port) || port < MIN_PORT || port > MAX_PORT) {
|
|
22
|
+
throw new Error("--live-port debe estar entre 1024 y 65535.");
|
|
23
|
+
}
|
|
24
|
+
return port;
|
|
25
|
+
}
|
|
26
|
+
function corsHeaders() {
|
|
27
|
+
return {
|
|
28
|
+
"Access-Control-Allow-Origin": "*",
|
|
29
|
+
"Access-Control-Allow-Methods": "GET, OPTIONS",
|
|
30
|
+
"Access-Control-Allow-Headers": "*",
|
|
31
|
+
// Chrome puede pedir permiso explícito para hablar con la red local.
|
|
32
|
+
"Access-Control-Allow-Private-Network": "true",
|
|
33
|
+
"Cache-Control": "no-store",
|
|
34
|
+
};
|
|
35
|
+
}
|
|
36
|
+
function listen(server, port) {
|
|
37
|
+
return new Promise((resolve, reject) => {
|
|
38
|
+
const onError = (err) => {
|
|
39
|
+
server.removeListener("listening", onListening);
|
|
40
|
+
reject(err);
|
|
41
|
+
};
|
|
42
|
+
const onListening = () => {
|
|
43
|
+
server.removeListener("error", onError);
|
|
44
|
+
const address = server.address();
|
|
45
|
+
resolve(typeof address === "object" && address ? address.port : port);
|
|
46
|
+
};
|
|
47
|
+
server.once("error", onError);
|
|
48
|
+
server.once("listening", onListening);
|
|
49
|
+
server.listen(port, HOST);
|
|
50
|
+
});
|
|
51
|
+
}
|
|
52
|
+
/** Busca un puerto libre en el rango permitido. */
|
|
53
|
+
async function listenFree(server) {
|
|
54
|
+
for (let attempt = 0; attempt < 20; attempt += 1) {
|
|
55
|
+
const candidate = MIN_PORT + Math.floor(Math.random() * 10000);
|
|
56
|
+
try {
|
|
57
|
+
return await listen(server, candidate);
|
|
58
|
+
}
|
|
59
|
+
catch {
|
|
60
|
+
// Puerto ocupado: probar otro.
|
|
61
|
+
}
|
|
62
|
+
}
|
|
63
|
+
throw new Error("No se encontró un puerto libre para el live reload.");
|
|
64
|
+
}
|
|
65
|
+
/**
|
|
66
|
+
* Levanta el canal de recarga. Si `preferred` está ocupado, usa otro libre.
|
|
67
|
+
*/
|
|
68
|
+
export async function startLiveReloadServer(preferred, onChange) {
|
|
69
|
+
const clients = new Set();
|
|
70
|
+
const heartbeat = setInterval(() => {
|
|
71
|
+
for (const res of clients)
|
|
72
|
+
res.write(": ping\n\n");
|
|
73
|
+
}, HEARTBEAT_MS);
|
|
74
|
+
heartbeat.unref();
|
|
75
|
+
const server = http.createServer((req, res) => {
|
|
76
|
+
const url = new URL(req.url ?? "/", `http://${HOST}`);
|
|
77
|
+
if (req.method === "OPTIONS") {
|
|
78
|
+
res.writeHead(204, corsHeaders());
|
|
79
|
+
res.end();
|
|
80
|
+
return;
|
|
81
|
+
}
|
|
82
|
+
// Estricto: una sola ruta y solo GET.
|
|
83
|
+
if (req.method !== "GET" || url.pathname !== "/events") {
|
|
84
|
+
res.writeHead(404, { ...corsHeaders(), "Content-Type": "text/plain" });
|
|
85
|
+
res.end("No encontrado");
|
|
86
|
+
return;
|
|
87
|
+
}
|
|
88
|
+
res.writeHead(200, {
|
|
89
|
+
...corsHeaders(),
|
|
90
|
+
"Content-Type": "text/event-stream; charset=utf-8",
|
|
91
|
+
Connection: "keep-alive",
|
|
92
|
+
"X-Accel-Buffering": "no",
|
|
93
|
+
});
|
|
94
|
+
res.write(": conectado\n\n");
|
|
95
|
+
clients.add(res);
|
|
96
|
+
onChange?.(clients.size);
|
|
97
|
+
const drop = () => {
|
|
98
|
+
clients.delete(res);
|
|
99
|
+
onChange?.(clients.size);
|
|
100
|
+
};
|
|
101
|
+
req.on("close", drop);
|
|
102
|
+
req.on("error", drop);
|
|
103
|
+
});
|
|
104
|
+
let port;
|
|
105
|
+
if (preferred) {
|
|
106
|
+
try {
|
|
107
|
+
port = await listen(server, preferred);
|
|
108
|
+
}
|
|
109
|
+
catch {
|
|
110
|
+
port = await listenFree(server);
|
|
111
|
+
}
|
|
112
|
+
}
|
|
113
|
+
else {
|
|
114
|
+
port = await listenFree(server);
|
|
115
|
+
}
|
|
116
|
+
if (port < MIN_PORT || port > MAX_PORT) {
|
|
117
|
+
server.close();
|
|
118
|
+
throw new Error("El puerto del live reload quedó fuera del rango permitido.");
|
|
119
|
+
}
|
|
120
|
+
return {
|
|
121
|
+
port,
|
|
122
|
+
url: `http://${HOST}:${port}/events`,
|
|
123
|
+
notify() {
|
|
124
|
+
const data = JSON.stringify({ at: new Date().toISOString() });
|
|
125
|
+
for (const res of clients)
|
|
126
|
+
res.write(`event: reload\ndata: ${data}\n\n`);
|
|
127
|
+
},
|
|
128
|
+
close() {
|
|
129
|
+
clearInterval(heartbeat);
|
|
130
|
+
for (const res of clients) {
|
|
131
|
+
try {
|
|
132
|
+
res.end();
|
|
133
|
+
}
|
|
134
|
+
catch {
|
|
135
|
+
// La pestaña ya se había cerrado.
|
|
136
|
+
}
|
|
137
|
+
}
|
|
138
|
+
clients.clear();
|
|
139
|
+
server.close();
|
|
140
|
+
},
|
|
141
|
+
};
|
|
142
|
+
}
|
|
143
|
+
//# sourceMappingURL=liveReload.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"liveReload.js","sourceRoot":"","sources":["../../src/lib/liveReload.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,42 @@
|
|
|
1
|
+
import type { ReleaseAsset, ThemeAsset, ThemeState } from "../types.js";
|
|
2
|
+
/** Carpetas del tema que viajan al servidor. La raíz nunca se sincroniza. */
|
|
3
|
+
export declare const ALLOWED_DIRS: string[];
|
|
4
|
+
/** Archivo de sincronización local; vive en la raíz a propósito. */
|
|
5
|
+
export declare const STATE_FILE = ".velsefy-state.json";
|
|
6
|
+
/** Archivo del tema localizado en disco, con su ruta relativa normalizada. */
|
|
7
|
+
export interface ThemeFile {
|
|
8
|
+
relative: string;
|
|
9
|
+
full: string;
|
|
10
|
+
}
|
|
11
|
+
export declare function extOf(filePath: string): string;
|
|
12
|
+
export declare function isBinary(filePath: string): boolean;
|
|
13
|
+
export declare function hashOf(content: Buffer | string): string;
|
|
14
|
+
/** Hash del archivo tal como está en disco (binarios: bytes reales). */
|
|
15
|
+
export declare function hashOfAsset(assetPath: string, content: string): string;
|
|
16
|
+
export declare function walkTree(root: string): string[];
|
|
17
|
+
/** Une las opciones `--only` (paths o prefijos) con el listado completo. */
|
|
18
|
+
export declare function matchesOnly(relative: string, only?: string[]): boolean;
|
|
19
|
+
/**
|
|
20
|
+
* Recorre SOLO las carpetas permitidas y devuelve los archivos candidatos.
|
|
21
|
+
* No valida rutas ni extensiones: cada comando decide cómo tratarlas.
|
|
22
|
+
*/
|
|
23
|
+
export declare function listThemeFiles(dir: string, only?: string[]): ThemeFile[];
|
|
24
|
+
/** Lee los archivos indicados y calcula assets + hashes. */
|
|
25
|
+
export declare function readAssetsFromFiles(files: ThemeFile[]): {
|
|
26
|
+
assets: ReleaseAsset[];
|
|
27
|
+
hashes: Record<string, string>;
|
|
28
|
+
};
|
|
29
|
+
/**
|
|
30
|
+
* Lee el tema local: recorre SOLO las carpetas permitidas, ignora symlinks y
|
|
31
|
+
* archivos ocultos, y codifica binarios en base64 (el servidor guarda texto).
|
|
32
|
+
*/
|
|
33
|
+
export declare function readAssetsFromDir(dir: string, only?: string[]): {
|
|
34
|
+
assets: ReleaseAsset[];
|
|
35
|
+
hashes: Record<string, string>;
|
|
36
|
+
};
|
|
37
|
+
/** Escribe un asset respetando binario (base64) vs texto. */
|
|
38
|
+
export declare function writeAsset(targetDir: string, assetPath: string, content: string): void;
|
|
39
|
+
export declare function statePath(dir: string): string;
|
|
40
|
+
export declare function readState(dir: string): ThemeState | null;
|
|
41
|
+
export declare function writeState(dir: string, state: ThemeState): void;
|
|
42
|
+
export declare function maxUpdatedAt(assets: ThemeAsset[]): string | undefined;
|
|
@@ -0,0 +1,135 @@
|
|
|
1
|
+
import fs from "node:fs";
|
|
2
|
+
import path from "node:path";
|
|
3
|
+
import crypto from "node:crypto";
|
|
4
|
+
import { validateThemePath } from "@velsefy/theme-validate";
|
|
5
|
+
/** Carpetas del tema que viajan al servidor. La raíz nunca se sincroniza. */
|
|
6
|
+
export const ALLOWED_DIRS = ["assets", "sections", "layout", "snippets", "config", "templates"];
|
|
7
|
+
/** Archivo de sincronización local; vive en la raíz a propósito. */
|
|
8
|
+
export const STATE_FILE = ".velsefy-state.json";
|
|
9
|
+
/** Extensiones que viajan en base64 (binario real). El resto es texto UTF-8. */
|
|
10
|
+
const BINARY_EXTENSIONS = new Set([
|
|
11
|
+
"png", "jpg", "jpeg", "webp", "gif", "ico", "woff", "woff2", "ttf",
|
|
12
|
+
]);
|
|
13
|
+
export function extOf(filePath) {
|
|
14
|
+
return path.extname(filePath).replace(/^\./, "").toLowerCase();
|
|
15
|
+
}
|
|
16
|
+
export function isBinary(filePath) {
|
|
17
|
+
return BINARY_EXTENSIONS.has(extOf(filePath));
|
|
18
|
+
}
|
|
19
|
+
export function hashOf(content) {
|
|
20
|
+
return crypto.createHash("sha256").update(content).digest("hex");
|
|
21
|
+
}
|
|
22
|
+
/** Hash del archivo tal como está en disco (binarios: bytes reales). */
|
|
23
|
+
export function hashOfAsset(assetPath, content) {
|
|
24
|
+
return hashOf(isBinary(assetPath) ? Buffer.from(content, "base64") : content);
|
|
25
|
+
}
|
|
26
|
+
export function walkTree(root) {
|
|
27
|
+
const out = [];
|
|
28
|
+
const stack = [root];
|
|
29
|
+
while (stack.length > 0) {
|
|
30
|
+
const current = stack.pop();
|
|
31
|
+
const stat = fs.lstatSync(current);
|
|
32
|
+
if (stat.isSymbolicLink())
|
|
33
|
+
continue;
|
|
34
|
+
if (stat.isDirectory()) {
|
|
35
|
+
for (const name of fs.readdirSync(current)) {
|
|
36
|
+
if (name.startsWith("."))
|
|
37
|
+
continue;
|
|
38
|
+
stack.push(path.join(current, name));
|
|
39
|
+
}
|
|
40
|
+
}
|
|
41
|
+
else {
|
|
42
|
+
out.push(current);
|
|
43
|
+
}
|
|
44
|
+
}
|
|
45
|
+
return out;
|
|
46
|
+
}
|
|
47
|
+
/** Une las opciones `--only` (paths o prefijos) con el listado completo. */
|
|
48
|
+
export function matchesOnly(relative, only) {
|
|
49
|
+
if (!only || only.length === 0)
|
|
50
|
+
return true;
|
|
51
|
+
return only.some((entry) => relative === entry || relative.startsWith(entry.endsWith("/") ? entry : `${entry}/`));
|
|
52
|
+
}
|
|
53
|
+
/**
|
|
54
|
+
* Recorre SOLO las carpetas permitidas y devuelve los archivos candidatos.
|
|
55
|
+
* No valida rutas ni extensiones: cada comando decide cómo tratarlas.
|
|
56
|
+
*/
|
|
57
|
+
export function listThemeFiles(dir, only) {
|
|
58
|
+
if (!fs.existsSync(dir))
|
|
59
|
+
throw new Error(`El directorio del tema no existe: ${dir}`);
|
|
60
|
+
const files = [];
|
|
61
|
+
for (const folder of ALLOWED_DIRS) {
|
|
62
|
+
const fullFolder = path.join(dir, folder);
|
|
63
|
+
if (!fs.existsSync(fullFolder))
|
|
64
|
+
continue;
|
|
65
|
+
for (const file of walkTree(fullFolder)) {
|
|
66
|
+
const relative = path.relative(dir, file).split(path.sep).join("/");
|
|
67
|
+
if (!matchesOnly(relative, only))
|
|
68
|
+
continue;
|
|
69
|
+
files.push({ relative, full: file });
|
|
70
|
+
}
|
|
71
|
+
}
|
|
72
|
+
return files;
|
|
73
|
+
}
|
|
74
|
+
/** Lee los archivos indicados y calcula assets + hashes. */
|
|
75
|
+
export function readAssetsFromFiles(files) {
|
|
76
|
+
const assets = [];
|
|
77
|
+
const hashes = {};
|
|
78
|
+
for (const file of files) {
|
|
79
|
+
if (!validateThemePath(file.relative)) {
|
|
80
|
+
throw new Error(`Path inválido en el tema local: ${file.relative}`);
|
|
81
|
+
}
|
|
82
|
+
const raw = fs.readFileSync(file.full);
|
|
83
|
+
const content = isBinary(file.relative) ? raw.toString("base64") : raw.toString("utf8");
|
|
84
|
+
assets.push({ path: file.relative, content });
|
|
85
|
+
hashes[file.relative] = hashOf(raw);
|
|
86
|
+
}
|
|
87
|
+
return { assets, hashes };
|
|
88
|
+
}
|
|
89
|
+
/**
|
|
90
|
+
* Lee el tema local: recorre SOLO las carpetas permitidas, ignora symlinks y
|
|
91
|
+
* archivos ocultos, y codifica binarios en base64 (el servidor guarda texto).
|
|
92
|
+
*/
|
|
93
|
+
export function readAssetsFromDir(dir, only) {
|
|
94
|
+
return readAssetsFromFiles(listThemeFiles(dir, only));
|
|
95
|
+
}
|
|
96
|
+
/** Escribe un asset respetando binario (base64) vs texto. */
|
|
97
|
+
export function writeAsset(targetDir, assetPath, content) {
|
|
98
|
+
const target = path.join(targetDir, assetPath.split("/").join(path.sep));
|
|
99
|
+
fs.mkdirSync(path.dirname(target), { recursive: true });
|
|
100
|
+
if (isBinary(assetPath)) {
|
|
101
|
+
fs.writeFileSync(target, Buffer.from(content, "base64"));
|
|
102
|
+
}
|
|
103
|
+
else {
|
|
104
|
+
fs.writeFileSync(target, content, "utf8");
|
|
105
|
+
}
|
|
106
|
+
}
|
|
107
|
+
export function statePath(dir) {
|
|
108
|
+
return path.join(dir, STATE_FILE);
|
|
109
|
+
}
|
|
110
|
+
export function readState(dir) {
|
|
111
|
+
try {
|
|
112
|
+
const parsed = JSON.parse(fs.readFileSync(statePath(dir), "utf8"));
|
|
113
|
+
return {
|
|
114
|
+
installId: typeof parsed.installId === "string" ? parsed.installId : undefined,
|
|
115
|
+
sku: typeof parsed.sku === "string" ? parsed.sku : undefined,
|
|
116
|
+
baseUpdatedAt: typeof parsed.baseUpdatedAt === "string" ? parsed.baseUpdatedAt : undefined,
|
|
117
|
+
files: parsed.files && typeof parsed.files === "object" ? parsed.files : {},
|
|
118
|
+
};
|
|
119
|
+
}
|
|
120
|
+
catch {
|
|
121
|
+
return null;
|
|
122
|
+
}
|
|
123
|
+
}
|
|
124
|
+
export function writeState(dir, state) {
|
|
125
|
+
fs.mkdirSync(dir, { recursive: true });
|
|
126
|
+
fs.writeFileSync(statePath(dir), JSON.stringify(state, null, 2), "utf8");
|
|
127
|
+
}
|
|
128
|
+
export function maxUpdatedAt(assets) {
|
|
129
|
+
const max = assets.reduce((acc, asset) => {
|
|
130
|
+
const ts = asset.updated_at ?? asset.updatedAt ?? null;
|
|
131
|
+
return ts && (!acc || new Date(ts).getTime() > new Date(acc).getTime()) ? ts : acc;
|
|
132
|
+
}, null);
|
|
133
|
+
return max ?? undefined;
|
|
134
|
+
}
|
|
135
|
+
//# sourceMappingURL=themeAssets.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"themeAssets.js","sourceRoot":"","sources":["../../src/lib/themeAssets.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
/** Cambios que un push debe enviar: subidas y bajas. */
|
|
2
|
+
export interface WatchPlan {
|
|
3
|
+
changed: string[];
|
|
4
|
+
deleted: string[];
|
|
5
|
+
}
|
|
6
|
+
/**
|
|
7
|
+
* Calcula el plan de sincronización comparando el estado local con los hashes
|
|
8
|
+
* del disco. Función pura: no toca el sistema de archivos ni la red.
|
|
9
|
+
*
|
|
10
|
+
* - `changed`: archivos nuevos o con hash distinto al del estado.
|
|
11
|
+
* - `deleted`: archivos del estado que ya no existen en el disco.
|
|
12
|
+
*
|
|
13
|
+
* Con `--only`, ambos lados se limitan al alcance elegido: lo que queda fuera
|
|
14
|
+
* no se sube ni se borra.
|
|
15
|
+
*/
|
|
16
|
+
export declare function planWatchChanges(stateFiles: Record<string, string>, hashes: Record<string, string>, only?: string[]): WatchPlan;
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
import { matchesOnly } from "./themeAssets.js";
|
|
2
|
+
/**
|
|
3
|
+
* Calcula el plan de sincronización comparando el estado local con los hashes
|
|
4
|
+
* del disco. Función pura: no toca el sistema de archivos ni la red.
|
|
5
|
+
*
|
|
6
|
+
* - `changed`: archivos nuevos o con hash distinto al del estado.
|
|
7
|
+
* - `deleted`: archivos del estado que ya no existen en el disco.
|
|
8
|
+
*
|
|
9
|
+
* Con `--only`, ambos lados se limitan al alcance elegido: lo que queda fuera
|
|
10
|
+
* no se sube ni se borra.
|
|
11
|
+
*/
|
|
12
|
+
export function planWatchChanges(stateFiles, hashes, only) {
|
|
13
|
+
const changed = Object.keys(hashes)
|
|
14
|
+
.filter((relative) => matchesOnly(relative, only) && stateFiles[relative] !== hashes[relative])
|
|
15
|
+
.sort();
|
|
16
|
+
const deleted = Object.keys(stateFiles)
|
|
17
|
+
.filter((relative) => matchesOnly(relative, only) && !(relative in hashes))
|
|
18
|
+
.sort();
|
|
19
|
+
return { changed, deleted };
|
|
20
|
+
}
|
|
21
|
+
//# sourceMappingURL=watchPlan.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"watchPlan.js","sourceRoot":"","sources":["../../src/lib/watchPlan.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAQ/C;;;;;;;;;GASG;AACH,MAAM,UAAU,gBAAgB,CAC9B,UAAkC,EAClC,MAA8B,EAC9B,IAAe;IAEf,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC;SAChC,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,WAAW,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,UAAU,CAAC,QAAQ,CAAC,KAAK,MAAM,CAAC,QAAQ,CAAC,CAAC;SAC9F,IAAI,EAAE,CAAC;IACV,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC;SACpC,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,WAAW,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,QAAQ,IAAI,MAAM,CAAC,CAAC;SAC1E,IAAI,EAAE,CAAC;IACV,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AAC9B,CAAC"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@velsefy/cli",
|
|
3
|
-
"version":
|
|
3
|
+
"version": "0.4.0",
|
|
4
4
|
"description": "CLI cross-platform de VELSEFY para gestionar temas (eCommerce + POS multi-tenant).",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"bin": {
|
|
@@ -11,7 +11,9 @@
|
|
|
11
11
|
"files": [
|
|
12
12
|
"dist",
|
|
13
13
|
"examples",
|
|
14
|
-
"
|
|
14
|
+
"README.md",
|
|
15
|
+
"THEME-DEVELOPMENT.md",
|
|
16
|
+
"!dist/**/*.test.*"
|
|
15
17
|
],
|
|
16
18
|
"workspaces": [
|
|
17
19
|
"packages/*"
|
|
@@ -22,6 +24,7 @@
|
|
|
22
24
|
"pretypecheck": "npm run build --workspace @velsefy/theme-validate",
|
|
23
25
|
"typecheck": "tsc --noEmit",
|
|
24
26
|
"lint": "eslint .",
|
|
27
|
+
"test": "node --test \"dist/**/*.test.js\"",
|
|
25
28
|
"prepublishOnly": "node scripts/check-internal-deps.mjs \u0026\u0026 npm run build",
|
|
26
29
|
"prepack": "npm run build",
|
|
27
30
|
"prepare": "husky"
|