tiendu 0.1.1

package/lib/preview.mjs

@@ -0,0 +1,295 @@
+import { loadConfigOrFail, writeConfig } from "./config.mjs";
+import { apiFetch } from "./api.mjs";
+
+const buildPreviewUrl = (apiBaseUrl, previewHostname) => {
+  const base = new URL(apiBaseUrl);
+  const hasExplicitPort = previewHostname.includes(":");
+  return `${base.protocol}//${previewHostname}${!hasExplicitPort && base.port ? `:${base.port}` : ""}/`;
+};
+
+/**
+ * @param {string} apiBaseUrl
+ * @param {string} apiKey
+ * @param {number} storeId
+ * @param {string} [name]
+ * @returns {Promise<{ ok: true, data: any } | { ok: false, error: string }>}
+ */
+export const createPreview = async (apiBaseUrl, apiKey, storeId, name) => {
+  try {
+    const response = await apiFetch(
+      apiBaseUrl,
+      apiKey,
+      `/api/v2/stores/${storeId}/theme-previews`,
+      {
+        method: "POST",
+        body: JSON.stringify({ name: name ?? "Dev" }),
+      },
+    );
+
+    if (response.status === 409) {
+      const body = await response.json().catch(() => ({}));
+      const message =
+        body?.error?.message ??
+        "Ya existe un preview para esta tienda. Eliminalo antes de crear uno nuevo.";
+      return { ok: false, error: message };
+    }
+
+    if (!response.ok) {
+      const body = await response.text().catch(() => "");
+      return {
+        ok: false,
+        error: `Error del servidor: ${response.status}${body ? ` — ${body}` : ""}`,
+      };
+    }
+
+    const preview = await response.json();
+    return { ok: true, data: preview };
+  } catch (error) {
+    return {
+      ok: false,
+      error: `No se pudo crear el preview: ${error.message}`,
+    };
+  }
+};
+
+/**
+ * @param {string} apiBaseUrl
+ * @param {string} apiKey
+ * @param {number} storeId
+ * @returns {Promise<{ ok: true, data: any[] } | { ok: false, error: string }>}
+ */
+export const listPreviews = async (apiBaseUrl, apiKey, storeId) => {
+  try {
+    const response = await apiFetch(
+      apiBaseUrl,
+      apiKey,
+      `/api/v2/stores/${storeId}/theme-previews`,
+    );
+
+    if (!response.ok) {
+      return { ok: false, error: `Error del servidor: ${response.status}` };
+    }
+
+    const body = await response.json();
+    const previews = body?.previews ?? [];
+    return { ok: true, data: previews };
+  } catch (error) {
+    return { ok: false, error: `No se pudo listar previews: ${error.message}` };
+  }
+};
+
+/**
+ * @param {string} apiBaseUrl
+ * @param {string} apiKey
+ * @param {number} storeId
+ * @param {string} previewKey
+ * @returns {Promise<{ ok: true } | { ok: false, error: string }>}
+ */
+export const deletePreview = async (
+  apiBaseUrl,
+  apiKey,
+  storeId,
+  previewKey,
+) => {
+  try {
+    const response = await apiFetch(
+      apiBaseUrl,
+      apiKey,
+      `/api/v2/stores/${storeId}/theme-previews/${previewKey}`,
+      {
+        method: "DELETE",
+      },
+    );
+
+    if (!response.ok) {
+      const body = await response.text().catch(() => "");
+      return {
+        ok: false,
+        error: `Error del servidor: ${response.status}${body ? ` — ${body}` : ""}`,
+      };
+    }
+
+    return { ok: true };
+  } catch (error) {
+    return {
+      ok: false,
+      error: `No se pudo eliminar el preview: ${error.message}`,
+    };
+  }
+};
+
+/**
+ * @param {string} apiBaseUrl
+ * @param {string} apiKey
+ * @param {number} storeId
+ * @param {string} previewKey
+ * @returns {Promise<{ ok: true } | { ok: false, error: string }>}
+ */
+export const publishPreview = async (
+  apiBaseUrl,
+  apiKey,
+  storeId,
+  previewKey,
+) => {
+  try {
+    const response = await apiFetch(
+      apiBaseUrl,
+      apiKey,
+      `/api/v2/stores/${storeId}/theme-previews/${previewKey}/publish`,
+      {
+        method: "POST",
+      },
+    );
+
+    if (!response.ok) {
+      const body = await response.text().catch(() => "");
+      return {
+        ok: false,
+        error: `Error del servidor: ${response.status}${body ? ` — ${body}` : ""}`,
+      };
+    }
+
+    return { ok: true };
+  } catch (error) {
+    return {
+      ok: false,
+      error: `No se pudo publicar el preview: ${error.message}`,
+    };
+  }
+};
+
+// ---------------------------------------------------------------------------
+// CLI commands
+// ---------------------------------------------------------------------------
+
+export const previewCreate = async (name) => {
+  const { config, credentials } = await loadConfigOrFail();
+
+  console.log("");
+  console.log("Creando preview...");
+
+  const result = await createPreview(
+    config.apiBaseUrl,
+    credentials.apiKey,
+    config.storeId,
+    name,
+  );
+
+  if (!result.ok) {
+    console.error(`Error: ${result.error}`);
+    process.exit(1);
+  }
+
+  const preview = result.data;
+  console.log(`Preview creado: ${preview.previewKey}`);
+  console.log(
+    `URL: ${buildPreviewUrl(config.apiBaseUrl, preview.previewHostname)}`,
+  );
+  console.log("");
+
+  // Save preview key to config
+  await writeConfig({ ...config, previewKey: preview.previewKey });
+};
+
+export const previewList = async () => {
+  const { config, credentials } = await loadConfigOrFail();
+
+  const result = await listPreviews(
+    config.apiBaseUrl,
+    credentials.apiKey,
+    config.storeId,
+  );
+
+  if (!result.ok) {
+    console.error(`Error: ${result.error}`);
+    process.exit(1);
+  }
+
+  console.log("");
+  if (result.data.length === 0) {
+    console.log("No hay previews para esta tienda.");
+  } else {
+    console.log("Previews:");
+    for (const preview of result.data) {
+      const active =
+        config.previewKey === preview.previewKey ? " (activo)" : "";
+      console.log(
+        `  ${preview.previewKey}  ${preview.name}  ${buildPreviewUrl(config.apiBaseUrl, preview.previewHostname)}${active}`,
+      );
+    }
+  }
+  console.log("");
+};
+
+export const previewDelete = async () => {
+  const { config, credentials } = await loadConfigOrFail();
+
+  if (!config.previewKey) {
+    console.error("No hay preview activo. Creá uno con: tiendu preview create");
+    process.exit(1);
+  }
+
+  console.log("");
+  console.log(`Eliminando preview ${config.previewKey}...`);
+
+  const result = await deletePreview(
+    config.apiBaseUrl,
+    credentials.apiKey,
+    config.storeId,
+    config.previewKey,
+  );
+
+  if (!result.ok) {
+    console.error(`Error: ${result.error}`);
+    process.exit(1);
+  }
+
+  console.log("Preview eliminado.");
+  console.log("");
+
+  // Remove preview key from config
+  const { previewKey, ...rest } = config;
+  await writeConfig(rest);
+};
+
+export const previewOpen = async () => {
+  const { config } = await loadConfigOrFail();
+
+  if (!config.previewKey) {
+    console.error("No hay preview activo. Creá uno con: tiendu preview create");
+    process.exit(1);
+  }
+
+  // Find the preview to get its hostname
+  const { credentials } = await loadConfigOrFail();
+  const result = await listPreviews(
+    config.apiBaseUrl,
+    credentials.apiKey,
+    config.storeId,
+  );
+
+  if (!result.ok) {
+    console.error(`Error: ${result.error}`);
+    process.exit(1);
+  }
+
+  const preview = result.data.find((p) => p.previewKey === config.previewKey);
+  if (!preview) {
+    console.error("El preview activo ya no existe en el servidor.");
+    process.exit(1);
+  }
+
+  const url = buildPreviewUrl(config.apiBaseUrl, preview.previewHostname);
+  console.log(`Abriendo ${url}...`);
+
+  // Open URL in browser
+  const { exec } = await import("node:child_process");
+  const platform = process.platform;
+  const cmd =
+    platform === "darwin"
+      ? "open"
+      : platform === "win32"
+        ? "start"
+        : "xdg-open";
+  exec(`${cmd} ${url}`);
+};

package/lib/publish.mjs

@@ -0,0 +1,34 @@
+import { loadConfigOrFail, writeConfig } from "./config.mjs";
+import { publishPreview } from "./preview.mjs";
+
+export const publish = async () => {
+  const { config, credentials } = await loadConfigOrFail();
+
+  if (!config.previewKey) {
+    console.error("No hay preview activo. Creá uno con: tiendu preview create");
+    process.exit(1);
+  }
+
+  console.log("");
+  console.log(`Publicando preview ${config.previewKey} al storefront live...`);
+
+  const result = await publishPreview(
+    config.apiBaseUrl,
+    credentials.apiKey,
+    config.storeId,
+    config.previewKey,
+  );
+
+  if (!result.ok) {
+    console.error(`Error: ${result.error}`);
+    process.exit(1);
+  }
+
+  console.log("Preview publicado. El storefront live fue actualizado.");
+  console.log("Todos los previews de esta tienda fueron eliminados.");
+  console.log("");
+
+  // Remove preview key from config
+  const { previewKey, ...rest } = config;
+  await writeConfig(rest);
+};

package/lib/pull.mjs

@@ -0,0 +1,41 @@
+import { loadConfigOrFail } from "./config.mjs";
+import { downloadStorefrontArchive } from "./api.mjs";
+import { extractZip } from "./zip.mjs";
+
+export const pull = async () => {
+  const { config, credentials } = await loadConfigOrFail();
+
+  console.log("");
+  console.log(`Descargando tema de tienda #${config.storeId}...`);
+
+  const result = await downloadStorefrontArchive(
+    config.apiBaseUrl,
+    credentials.apiKey,
+    config.storeId,
+  );
+
+  if (!result.ok) {
+    console.error(`Error: ${result.error}`);
+    process.exit(1);
+  }
+
+  console.log(`Archivo ZIP recibido (${formatBytes(result.data.length)})`);
+  console.log("Extrayendo archivos...");
+
+  const outputDir = process.cwd();
+  const extractedFiles = await extractZip(result.data, outputDir);
+
+  console.log("");
+  console.log(`${extractedFiles.length} archivos extraídos:`);
+  for (const file of extractedFiles) {
+    console.log(`  ${file}`);
+  }
+  console.log("");
+};
+
+/** @param {number} bytes */
+const formatBytes = (bytes) => {
+  if (bytes < 1024) return `${bytes} B`;
+  if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)} KB`;
+  return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
+};

package/lib/push.mjs

@@ -0,0 +1,95 @@
+import { readdir, readFile, stat } from "node:fs/promises";
+import path from "node:path";
+import { zipSync } from "fflate";
+import { loadConfigOrFail } from "./config.mjs";
+import { uploadPreviewZip } from "./api.mjs";
+
+const isDotfile = (name) => name.startsWith(".");
+
+/**
+ * Recursively list all files, skipping dotfiles/dotdirs.
+ * @param {string} rootDir
+ * @param {string} currentDir
+ * @returns {Promise<string[]>}
+ */
+const listAllFiles = async (rootDir, currentDir) => {
+  const entries = await readdir(currentDir, { withFileTypes: true });
+  const files = [];
+
+  for (const entry of entries) {
+    if (isDotfile(entry.name)) continue;
+
+    const absolutePath = path.join(currentDir, entry.name);
+
+    if (entry.isDirectory()) {
+      const nested = await listAllFiles(rootDir, absolutePath);
+      files.push(...nested);
+    } else if (entry.isFile()) {
+      files.push(absolutePath);
+    }
+  }
+
+  return files;
+};
+
+/**
+ * Create a zip buffer from the current directory, skipping dotfiles.
+ * @param {string} rootDir
+ * @returns {Promise<Buffer>}
+ */
+const createZipFromDirectory = async (rootDir) => {
+  const absoluteFiles = await listAllFiles(rootDir, rootDir);
+  /** @type {Record<string, Uint8Array>} */
+  const entries = {};
+
+  for (const absoluteFilePath of absoluteFiles) {
+    const relativePath = path
+      .relative(rootDir, absoluteFilePath)
+      .split(path.sep)
+      .join("/");
+    const fileBuffer = await readFile(absoluteFilePath);
+    entries[relativePath] = new Uint8Array(fileBuffer);
+  }
+
+  return Buffer.from(zipSync(entries, { level: 6 }));
+};
+
+export const push = async () => {
+  const { config, credentials } = await loadConfigOrFail();
+
+  if (!config.previewKey) {
+    console.error("No hay preview activo. Creá uno con: tiendu preview create");
+    process.exit(1);
+  }
+
+  const rootDir = process.cwd();
+
+  console.log("");
+  console.log(`Subiendo archivos al preview ${config.previewKey}...`);
+
+  const zipBuffer = await createZipFromDirectory(rootDir);
+  console.log(`ZIP creado (${formatBytes(zipBuffer.length)})`);
+
+  const result = await uploadPreviewZip(
+    config.apiBaseUrl,
+    credentials.apiKey,
+    config.storeId,
+    config.previewKey,
+    zipBuffer,
+  );
+
+  if (!result.ok) {
+    console.error(`Error: ${result.error}`);
+    process.exit(1);
+  }
+
+  console.log("Archivos subidos al preview.");
+  console.log("");
+};
+
+/** @param {number} bytes */
+const formatBytes = (bytes) => {
+  if (bytes < 1024) return `${bytes} B`;
+  if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)} KB`;
+  return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
+};

package/lib/zip.mjs

@@ -0,0 +1,36 @@
+import { mkdir, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { unzipSync } from "fflate";
+
+/**
+ * Extract a zip buffer into the given output directory.
+ * Returns an array of extracted file paths (relative).
+ *
+ * @param {Buffer} zipBuffer
+ * @param {string} outputDir
+ * @returns {Promise<string[]>}
+ */
+export const extractZip = async (zipBuffer, outputDir) => {
+  const archiveEntries = unzipSync(new Uint8Array(zipBuffer));
+  const extractedFiles = [];
+  const resolvedOutputDir = path.resolve(outputDir);
+
+  for (const [relativePath, fileContent] of Object.entries(archiveEntries)) {
+    if (!relativePath || relativePath.endsWith("/")) continue;
+
+    const outputPath = path.join(outputDir, relativePath);
+    const resolvedPath = path.resolve(outputPath);
+    if (
+      !resolvedPath.startsWith(`${resolvedOutputDir}${path.sep}`) &&
+      resolvedPath !== resolvedOutputDir
+    ) {
+      continue;
+    }
+
+    await mkdir(path.dirname(outputPath), { recursive: true });
+    await writeFile(outputPath, fileContent);
+    extractedFiles.push(relativePath);
+  }
+
+  return extractedFiles.sort((left, right) => left.localeCompare(right));
+};

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "tiendu",
+  "version": "0.1.1",
+  "description": "CLI para desarrollar y publicar temas en Tiendu",
+  "type": "module",
+  "bin": {
+    "tiendu": "./bin/tiendu.js"
+  },
+  "files": [
+    "bin",
+    "lib",
+    "LICENSE",
+    "README.md"
+  ],
+  "scripts": {
+    "dev": "node bin/tiendu.mjs"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "keywords": [
+    "tiendu",
+    "ecommerce",
+    "theme",
+    "storefront",
+    "cli"
+  ],
+  "author": "Tiendu",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/squiel91/tiendu-cli"
+  },
+  "homepage": "https://tiendu.uy",
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "fflate": "^0.8.2"
+  }
+}