tiendu 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Tiendu
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,194 @@
+# tiendu
+
+Official CLI for [Tiendu](https://tiendu.uy) — develop and publish storefront themes from your local machine.
+
+Download your store's theme, edit files locally, preview changes live with a shareable URL, and publish when you're ready — all from the terminal.
+
+---
+
+## Requirements
+
+- Node.js 20 or higher
+- A Tiendu store
+- A Tiendu API key (request one at hola@tiendu.uy)
+
+---
+
+## Installation
+
+```bash
+npm install -g tiendu
+```
+
+---
+
+## Quick start
+
+```bash
+# Create a working directory and enter it
+mkdir my-theme && cd my-theme
+
+# Connect to your store
+tiendu init
+
+# Download the current live theme
+tiendu pull
+
+# Start developing with live preview
+tiendu dev
+```
+
+`tiendu dev` creates a remote preview of your theme, uploads your local files, watches for changes and syncs them automatically, and prints a shareable URL like:
+
+```
+http://preview-xxxxxxxxxxxx.tiendu.uy/
+```
+
+The preview renders with the real Tiendu engine — same output as production. Share the URL with your client or team before publishing.
+
+---
+
+## Commands
+
+### `tiendu init`
+
+Initializes a theme project in the current directory. Prompts for your API key, API base URL (defaults to `https://tiendu.uy`), and store ID. Saves configuration to `.cli/`.
+
+```bash
+tiendu init
+```
+
+> Add `.cli/` to your `.gitignore` if you version-control your theme — it contains your API key.
+
+---
+
+### `tiendu pull`
+
+Downloads the current live theme from your store as local files. Run this once to get started, or to reset your local files to the published version.
+
+```bash
+tiendu pull
+```
+
+---
+
+### `tiendu dev`
+
+The main development command. On first run it creates a remote preview, uploads your local files, and starts watching for changes. Every file you save is automatically synced to the preview.
+
+```bash
+tiendu dev
+```
+
+- Prints the preview URL on start
+- Syncs file creates, edits and deletes
+- Handles both text and binary files (images, fonts, etc.)
+- Press `Ctrl+C` to stop
+
+---
+
+### `tiendu push`
+
+Zips all local files (excluding dotfiles) and uploads them to the active preview, replacing its content entirely. Use this instead of `tiendu dev` if you prefer manual syncs.
+
+```bash
+tiendu push
+```
+
+---
+
+### `tiendu publish`
+
+Publishes the active preview to the live storefront. Visitors will see the new theme immediately. All previews for the store are removed after publishing.
+
+```bash
+tiendu publish
+```
+
+---
+
+### `tiendu preview create [name]`
+
+Creates a new remote preview. Fails with a conflict error if one already exists for your account on this store — delete it first with `tiendu preview delete`.
+
+```bash
+tiendu preview create
+tiendu preview create "Winter campaign"
+```
+
+---
+
+### `tiendu preview list`
+
+Lists all previews for your store.
+
+```bash
+tiendu preview list
+```
+
+---
+
+### `tiendu preview delete`
+
+Deletes the active preview (both remotely and from your local config).
+
+```bash
+tiendu preview delete
+```
+
+---
+
+### `tiendu preview open`
+
+Opens the active preview URL in your default browser.
+
+```bash
+tiendu preview open
+```
+
+---
+
+## Typical workflow
+
+```
+tiendu init        # one time: connect to your store
+tiendu pull        # one time: download the live theme
+
+tiendu dev         # develop: edit locally, see changes live at the preview URL
+
+tiendu publish     # when ready: push to the live storefront
+```
+
+---
+
+## How previews work
+
+A **theme preview** is a remote copy of your theme hosted by Tiendu. It renders with the exact same engine as your live storefront — same Liquid templates, same data, same assets — so what you see in the preview is exactly what production will look like.
+
+- One preview per user per store
+- Preview URLs are stable and shareable
+- Previews are excluded from search engines (`noindex`)
+- Analytics are disabled in preview mode so test traffic doesn't pollute your metrics
+- Cart and checkout work normally in previews (orders placed in a preview are real orders)
+
+---
+
+## Local project structure
+
+After `tiendu pull` your directory will look like your store's theme. The `.cli/` folder holds local CLI configuration and is never uploaded to Tiendu.
+
+```
+my-theme/
+├── .cli/               # local config (API key, store ID, active preview key)
+├── layout/
+├── templates/
+├── snippets/
+├── assets/
+└── ...
+```
+
+---
+
+## License
+
+MIT — see [LICENSE](LICENSE).

package/bin/tiendu.js

@@ -0,0 +1,111 @@
+#!/usr/bin/env node
+
+import { init } from "../lib/init.mjs";
+import { pull } from "../lib/pull.mjs";
+import { push } from "../lib/push.mjs";
+import { dev } from "../lib/dev.mjs";
+import { publish } from "../lib/publish.mjs";
+import {
+  previewCreate,
+  previewList,
+  previewDelete,
+  previewOpen,
+} from "../lib/preview.mjs";
+
+const HELP = `
+tiendu — CLI para desarrollar temas de Tiendu
+
+Uso:
+  tiendu init                Inicializar un tema en el directorio actual
+  tiendu pull                Descargar el tema live desde Tiendu
+  tiendu push                Subir archivos locales al preview activo (ZIP)
+  tiendu dev                 Modo desarrollo: watch + sync automático
+  tiendu publish             Publicar el preview activo al storefront live
+
+  tiendu preview create      Crear un preview remoto
+  tiendu preview list        Listar previews de la tienda
+  tiendu preview delete      Eliminar el preview activo
+  tiendu preview open        Abrir la URL del preview en el navegador
+
+  tiendu help                Mostrar esta ayuda
+
+Opciones:
+  --help, -h                 Mostrar esta ayuda
+`;
+
+const main = async () => {
+  const args = process.argv.slice(2);
+  const command = args[0];
+  const subcommand = args[1];
+
+  if (
+    !command ||
+    command === "help" ||
+    command === "--help" ||
+    command === "-h"
+  ) {
+    console.log(HELP.trim());
+    process.exit(0);
+  }
+
+  if (command === "init") {
+    await init();
+    return;
+  }
+
+  if (command === "pull") {
+    await pull();
+    return;
+  }
+
+  if (command === "push") {
+    await push();
+    return;
+  }
+
+  if (command === "dev") {
+    await dev();
+    return;
+  }
+
+  if (command === "publish") {
+    await publish();
+    return;
+  }
+
+  if (command === "preview") {
+    if (subcommand === "create") {
+      const name = args[2];
+      await previewCreate(name);
+      return;
+    }
+
+    if (subcommand === "list") {
+      await previewList();
+      return;
+    }
+
+    if (subcommand === "delete") {
+      await previewDelete();
+      return;
+    }
+
+    if (subcommand === "open") {
+      await previewOpen();
+      return;
+    }
+
+    console.error(`Subcomando desconocido: preview ${subcommand ?? "(vacío)"}`);
+    console.log(HELP.trim());
+    process.exit(1);
+  }
+
+  console.error(`Comando desconocido: ${command}`);
+  console.log(HELP.trim());
+  process.exit(1);
+};
+
+main().catch((error) => {
+  console.error(error.message || error);
+  process.exit(1);
+});

package/bin/tiendu.mjs

@@ -0,0 +1,111 @@
+#!/usr/bin/env node
+
+import { init } from "../lib/init.mjs";
+import { pull } from "../lib/pull.mjs";
+import { push } from "../lib/push.mjs";
+import { dev } from "../lib/dev.mjs";
+import { publish } from "../lib/publish.mjs";
+import {
+  previewCreate,
+  previewList,
+  previewDelete,
+  previewOpen,
+} from "../lib/preview.mjs";
+
+const HELP = `
+tiendu — CLI para desarrollar temas de Tiendu
+
+Uso:
+  tiendu init                Inicializar un tema en el directorio actual
+  tiendu pull                Descargar el tema live desde Tiendu
+  tiendu push                Subir archivos locales al preview activo (ZIP)
+  tiendu dev                 Modo desarrollo: watch + sync automático
+  tiendu publish             Publicar el preview activo al storefront live
+
+  tiendu preview create      Crear un preview remoto
+  tiendu preview list        Listar previews de la tienda
+  tiendu preview delete      Eliminar el preview activo
+  tiendu preview open        Abrir la URL del preview en el navegador
+
+  tiendu help                Mostrar esta ayuda
+
+Opciones:
+  --help, -h                 Mostrar esta ayuda
+`;
+
+const main = async () => {
+  const args = process.argv.slice(2);
+  const command = args[0];
+  const subcommand = args[1];
+
+  if (
+    !command ||
+    command === "help" ||
+    command === "--help" ||
+    command === "-h"
+  ) {
+    console.log(HELP.trim());
+    process.exit(0);
+  }
+
+  if (command === "init") {
+    await init();
+    return;
+  }
+
+  if (command === "pull") {
+    await pull();
+    return;
+  }
+
+  if (command === "push") {
+    await push();
+    return;
+  }
+
+  if (command === "dev") {
+    await dev();
+    return;
+  }
+
+  if (command === "publish") {
+    await publish();
+    return;
+  }
+
+  if (command === "preview") {
+    if (subcommand === "create") {
+      const name = args[2];
+      await previewCreate(name);
+      return;
+    }
+
+    if (subcommand === "list") {
+      await previewList();
+      return;
+    }
+
+    if (subcommand === "delete") {
+      await previewDelete();
+      return;
+    }
+
+    if (subcommand === "open") {
+      await previewOpen();
+      return;
+    }
+
+    console.error(`Subcomando desconocido: preview ${subcommand ?? "(vacío)"}`);
+    console.log(HELP.trim());
+    process.exit(1);
+  }
+
+  console.error(`Comando desconocido: ${command}`);
+  console.log(HELP.trim());
+  process.exit(1);
+};
+
+main().catch((error) => {
+  console.error(error.message || error);
+  process.exit(1);
+});