tiendu 0.7.0 → 0.8.1

package/README.md

@@ -138,8 +138,11 @@ Builds or stages the current theme into its deployable output directory (`dist/`
 
 ```bash
 tiendu build
+tiendu build --skip-instances
 ```
 
+- Use `--skip-instances` to omit template JSON, section group JSON, and `config/settings_data.json` from `dist/`. This is useful when you want to preserve the existing page/section instances on the preview.
+
 The build:
 
 1. Copies theme files from `src/layout/`, `src/templates/`, `src/sections/`, `src/blocks/`, `src/snippets/`, and `src/config/` to `dist/`
@@ -167,8 +170,10 @@ The main development command.
 
 ```bash
 tiendu dev
+tiendu dev --skip-instances
 ```
 
+- Use `--skip-instances` to sync everything except template JSON, section group JSON, and `config/settings_data.json`. Existing instances on the preview are preserved.
 - Prints the preview URL on start
 - Re-syncs the full local theme to the preview on startup
 - Syncs file creates, edits and deletes
@@ -190,8 +195,11 @@ Zips and uploads `dist/` to the active preview, replacing its content entirely.
 tiendu push
 tiendu push --skip-build
 tiendu push --skip-build --non-interactive
+tiendu push --skip-instances
 ```
 
+- Use `--skip-instances` to upload everything except template JSON, section group JSON, and `config/settings_data.json`. Existing instances on the preview are preserved.
+
 ---
 
 ### `tiendu publish`
@@ -205,8 +213,11 @@ Publishes the active preview to the live storefront. Visitors will see the new t
 tiendu publish
 tiendu publish --skip-build
 tiendu publish --skip-build --non-interactive
+tiendu publish --skip-instances
 ```
 
+- Use `--skip-instances` to publish everything except template JSON, section group JSON, and `config/settings_data.json`. Existing instances on the preview are preserved.
+
 In non-interactive mode, the publish confirmation is skipped.
 
 ---

package/bin/tiendu.js

@@ -55,6 +55,7 @@ Global options:
   --non-interactive            Disable prompts, print plain text output, and skip confirmations
   --dir <path>                 Create the project inside a new directory during init
   --skip-build                 Reuse the existing dist/ output for push or publish
+  --skip-instances             Skip template/section group JSON and settings_data.json (preserves existing instances on the preview)
   --help, -h                   Show this help message
   --version, -v                Show the current CLI version
 
@@ -132,6 +133,7 @@ const main = async () => {
   const command = positionals[0];
   const subcommand = positionals[1];
   const skipBuild = flags.has("--skip-build");
+  const skipInstances = flags.has("--skip-instances");
   const nonInteractive =
     flags.has("--non-interactive") || !process.stdin.isTTY || !process.stdout.isTTY;
 
@@ -190,23 +192,23 @@ const main = async () => {
   }
 
   if (command === "build") {
-    const result = await build();
+    const result = await build({ skipInstances });
     if (!result.ok) process.exit(1);
     return;
   }
 
   if (command === "push") {
-    await push({ skipBuild, previewKey: positionals[1] });
+    await push({ skipBuild, previewKey: positionals[1], skipInstances });
     return;
   }
 
   if (command === "dev") {
-    await dev();
+    await dev({ skipInstances });
     return;
   }
 
   if (command === "publish") {
-    await publish({ skipBuild, previewKey: positionals[1] });
+    await publish({ skipBuild, previewKey: positionals[1], skipInstances });
     return;
   }
 

package/lib/api.mjs

@@ -219,23 +219,25 @@ export const downloadPreviewArchive = async (
  * @returns {Promise<{ ok: true } | { ok: false, error: string, retriable?: boolean }>}
  */
 export const uploadPreviewZip = async (
-  apiBaseUrl,
-  apiKey,
-  storeId,
-  previewKey,
-  zipBuffer,
+	apiBaseUrl,
+	apiKey,
+	storeId,
+	previewKey,
+	zipBuffer,
+	preserveInstances = false,
 ) => {
-  try {
-    const response = await apiFetch(
-      apiBaseUrl,
-      apiKey,
-      `/api/admin/stores/${storeId}/theme-previews/${previewKey}/upload`,
-      {
-        method: "POST",
-        body: zipBuffer,
-        contentType: "application/zip",
-      },
-    );
+	try {
+		const query = preserveInstances ? "?preserveInstances=true" : "";
+		const response = await apiFetch(
+			apiBaseUrl,
+			apiKey,
+			`/api/admin/stores/${storeId}/theme-previews/${previewKey}/upload${query}`,
+			{
+				method: "POST",
+				body: zipBuffer,
+				contentType: "application/zip",
+			},
+		);
 
     if (!response.ok) {
       const body = await response.text().catch(() => "");

package/lib/archive.mjs

@@ -13,7 +13,7 @@ export const listAllFiles = async (rootDir) => listFilesRecursive(rootDir);
  * @param {string} rootDir
  * @returns {Promise<Buffer>}
  */
-export const createZipFromDirectory = async (rootDir) => {
+export const createZipFromDirectory = async (rootDir, shouldInclude) => {
   const absoluteFiles = await listAllFiles(rootDir);
   /** @type {Record<string, Uint8Array>} */
   const entries = {};
@@ -23,6 +23,7 @@ export const createZipFromDirectory = async (rootDir) => {
       .relative(rootDir, absolutePath)
       .split(path.sep)
       .join("/");
+    if (shouldInclude && !shouldInclude(relativePath)) continue;
     entries[relativePath] = new Uint8Array(await readFile(absolutePath));
   }
 

package/lib/build.mjs

@@ -36,6 +36,17 @@ const ENTRY_SOURCE_EXTENSIONS = new Set([".js", ".ts", ".css"]);
 const NESTED_ASSET_PATH_PATTERN =
   /\/assets\/([A-Za-z0-9._-]+(?:\/[A-Za-z0-9._/-]+)+)([?#][A-Za-z0-9=&._-]+)?/g;
 
+const INSTANCE_FILE_PATTERNS = [
+  /^templates\/[^/]+\.json$/,
+  /^sections\/[^/]+\.json$/,
+  /^config\/settings_data\.json$/,
+];
+
+export const isInstanceFile = (relativePath) => {
+  const normalized = relativePath.split(path.sep).join("/");
+  return INSTANCE_FILE_PATTERNS.some((pattern) => pattern.test(normalized));
+};
+
 /**
  * Discover optional JS/TS and CSS entry points from src/layout/templates or layout/templates.
  * Returns separate maps for JS and CSS to avoid key collisions.
@@ -118,9 +129,11 @@ const rewriteDirectAssetPaths = (source, knownAssetLogicalPaths) =>
     return flattened ? `/assets/${flattened}${suffix}` : match;
   });
 
-const shouldCopyThemeSourceFile = (sourceRelativePath) => {
+const shouldCopyThemeSourceFile = (sourceRelativePath, outputRelativePath, skipInstances = false) => {
   const extension = path.extname(sourceRelativePath).toLowerCase();
-  return !ENTRY_SOURCE_EXTENSIONS.has(extension);
+  if (ENTRY_SOURCE_EXTENSIONS.has(extension)) return false;
+  if (skipInstances && isInstanceFile(outputRelativePath)) return false;
+  return true;
 };
 
 const copyThemeSourceFile = async (
@@ -152,6 +165,7 @@ const copyThemeFiles = async (
   distDir,
   themeSourceDirs,
   knownAssetLogicalPaths,
+  skipInstances = false,
 ) => {
   for (const sourceDir of themeSourceDirs) {
     const absoluteSourceDir = path.join(rootDir, sourceDir.sourceRelativeDir);
@@ -167,7 +181,7 @@ const copyThemeFiles = async (
         sourceDir.outputRelativeDir,
         nestedRelativePath,
       );
-      if (!shouldCopyThemeSourceFile(sourceRelativePath)) continue;
+      if (!shouldCopyThemeSourceFile(sourceRelativePath, outputRelativePath, skipInstances)) continue;
       await copyThemeSourceFile(
         rootDir,
         distDir,
@@ -247,7 +261,7 @@ const runEntryBuilds = async (jsBuildOptions, cssBuildOptions) => {
  * @param {{ watch?: boolean }} options
  * @returns {Promise<{ ok: boolean, cleanup?: () => Promise<void> }>}
  */
-export const build = async ({ watch: watchMode = false } = {}) => {
+export const build = async ({ watch: watchMode = false, skipInstances = false } = {}) => {
   const rootDir = process.cwd();
   const distDir = path.join(rootDir, "dist");
 
@@ -310,6 +324,7 @@ export const build = async ({ watch: watchMode = false } = {}) => {
     distDir,
     themeSourceDirs,
     knownAssetLogicalPaths,
+    skipInstances,
   );
 
   if (cssCount > 0 && pipeline.postcss) {
@@ -497,7 +512,7 @@ export const build = async ({ watch: watchMode = false } = {}) => {
         const timer = setTimeout(async () => {
           debounceMap.delete(sourceRelativePath);
           try {
-            if (!shouldCopyThemeSourceFile(sourceRelativePath)) {
+            if (!shouldCopyThemeSourceFile(sourceRelativePath, outputRelativePath, skipInstances)) {
               return;
             }
 

package/lib/dev.mjs

@@ -10,7 +10,7 @@ import {
   deletePreviewFile,
   uploadPreviewFileMultipart,
 } from "./api.mjs";
-import { build } from "./build.mjs";
+import { build, isInstanceFile } from "./build.mjs";
 import { isDotfile } from "./fs-utils.mjs";
 import { startLocalPreviewServer } from "./local-preview.mjs";
 import { pushPreparedDirectoryToPreview } from "./push.mjs";
@@ -115,7 +115,7 @@ const deleteFileWithRetries = (
     },
   );
 
-export const dev = async () => {
+export const dev = async ({ skipInstances = false } = {}) => {
   const { config, credentials } = await loadConfigOrFail();
   const { apiBaseUrl, storeId } = config;
   const { apiKey } = credentials;
@@ -123,7 +123,7 @@ export const dev = async () => {
   let buildCleanup = null;
   let localPreviewServer = null;
 
-  const buildResult = await build({ watch: true });
+  const buildResult = await build({ watch: true, skipInstances });
   if (!buildResult.ok) {
     ui.log.error("Initial build failed. Fix errors and try again.");
     process.exit(1);
@@ -161,6 +161,7 @@ export const dev = async () => {
     compressMessage: "Compressing files...",
     retryMessage: (result, nextAttempt) =>
       `Initial push failed. Retrying ${nextAttempt}/${RETRY_ATTEMPTS}... ${result.error}`,
+    skipInstances,
   });
 
   if (!uploadResult.ok) {
@@ -288,6 +289,7 @@ export const dev = async () => {
     if (shouldIgnoreWatchedPath(filename, true)) return;
 
     const relativePath = filename.split(path.sep).join("/");
+    if (skipInstances && isInstanceFile(relativePath)) return;
     queueSync(relativePath);
   });
 

package/lib/publish.mjs

@@ -7,7 +7,7 @@ import {
 import { push } from "./push.mjs";
 import * as ui from "./ui.mjs";
 
-export const publish = async ({ skipBuild = false, previewKey: previewKeyArg } = {}) => {
+export const publish = async ({ skipBuild = false, previewKey: previewKeyArg, skipInstances = false } = {}) => {
   const { config, credentials } = await loadConfigOrFail();
 
   // Resolve preview key: explicit arg > interactive picker
@@ -42,7 +42,7 @@ export const publish = async ({ skipBuild = false, previewKey: previewKeyArg } =
       ? "Syncing existing dist/ output to the preview before publishing..."
       : "Building and syncing the latest dist/ output before publishing...",
   );
-  await push({ skipBuild, previewKey });
+  await push({ skipBuild, previewKey, skipInstances });
 
   const spinner = ui.spinner();
   spinner.start("Publishing preview to live storefront...");

package/lib/push.mjs

@@ -1,7 +1,7 @@
 import { getDistDir, loadConfigOrFail } from "./config.mjs";
 import { uploadPreviewZip } from "./api.mjs";
 import { createZipFromDirectory } from "./archive.mjs";
-import { build } from "./build.mjs";
+import { build, isInstanceFile } from "./build.mjs";
 import {
   fetchPreviewDetails,
   resolvePreviewKeyInteractively,
@@ -26,16 +26,21 @@ export const pushPreparedDirectoryToPreview = async ({
   compressMessage = "Compressing files...",
   uploadMessage,
   retryMessage,
+  skipInstances = false,
 }) => {
   spinner.message(compressMessage);
 
-  const zipBuffer = await createZipFromDirectory(rootDir);
+  const shouldInclude = skipInstances
+    ? (relativePath) => !isInstanceFile(relativePath)
+    : undefined;
+
+  const zipBuffer = await createZipFromDirectory(rootDir, shouldInclude);
   spinner.message(
     uploadMessage ?? `Uploading to preview ${previewKey} (${formatBytes(zipBuffer.length)})...`,
   );
 
   return retryAsync(
-    () => uploadPreviewZip(apiBaseUrl, apiKey, storeId, previewKey, zipBuffer),
+    () => uploadPreviewZip(apiBaseUrl, apiKey, storeId, previewKey, zipBuffer, skipInstances),
     {
       attempts: 3,
       shouldRetry: (uploadResult) => !uploadResult.ok && Boolean(uploadResult.retriable),
@@ -49,11 +54,11 @@ export const pushPreparedDirectoryToPreview = async ({
   );
 };
 
-export const push = async ({ skipBuild = false, previewKey: previewKeyArg } = {}) => {
+export const push = async ({ skipBuild = false, previewKey: previewKeyArg, skipInstances = false } = {}) => {
   const { config, credentials } = await loadConfigOrFail();
 
   if (!skipBuild) {
-    const result = await build();
+    const result = await build({ skipInstances });
     if (!result.ok) {
       process.exit(1);
     }
@@ -84,6 +89,7 @@ export const push = async ({ skipBuild = false, previewKey: previewKeyArg } = {}
     previewKey,
     rootDir,
     spinner,
+    skipInstances,
   });
 
   if (!result.ok) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tiendu",
-  "version": "0.7.0",
+  "version": "0.8.1",
   "description": "CLI para desarrollar y publicar temas en Tiendu",
   "type": "module",
   "bin": {