@zalify/cli 0.12.1 → 0.13.0

package/dist/cli.js

@@ -12836,6 +12836,36 @@ async function shopifyImport(storeDir, options = {}) {
         console.log(`  ✓ pruned ${node.handle}`);
     }
   }
+  for (const pg of catalog.pages ?? []) {
+    const existing = await gql(auth, `query($q: String!) { pages(first: 1, query: $q) { nodes { id handle } } }`, { q: `handle:${pg.handle}` });
+    const node = existing.pages.nodes[0];
+    if (node?.handle === pg.handle) {
+      const res = await gql(auth, `mutation($id: ID!, $page: PageUpdateInput!) {
+          pageUpdate(id: $id, page: $page) { userErrors { field message } }
+        }`, { id: node.id, page: { title: pg.title, body: pg.bodyHtml } });
+      const errs = res.pageUpdate.userErrors;
+      if (errs.length)
+        console.error(`  ✗ page ${pg.handle}: ${joinErrors(errs)}`);
+      else
+        console.log(`  ✓ page ${pg.handle} updated`);
+    } else {
+      const res = await gql(auth, `mutation($page: PageCreateInput!) {
+          pageCreate(page: $page) { userErrors { field message } }
+        }`, {
+        page: {
+          title: pg.title,
+          handle: pg.handle,
+          body: pg.bodyHtml,
+          isPublished: true
+        }
+      });
+      const errs = res.pageCreate.userErrors;
+      if (errs.length)
+        console.error(`  ✗ page ${pg.handle}: ${joinErrors(errs)}`);
+      else
+        console.log(`  ✓ page ${pg.handle} created`);
+    }
+  }
   const collectionIds = [];
   for (const c of catalog.collections ?? []) {
     const existing = await gql(auth, `query($q: String!) { collections(first: 1, query: $q) { nodes { id handle } } }`, { q: `handle:${c.handle}` });
@@ -12872,6 +12902,40 @@ async function shopifyImport(storeDir, options = {}) {
       console.log(`  ✓ collection ${c.handle}`);
     }
   }
+  const menuEntries = Object.entries(catalog.menus ?? {});
+  if (menuEntries.length) {
+    const toMenuItems = (items) => items.map((i) => ({
+      title: i.title,
+      type: "HTTP",
+      url: i.url,
+      items: i.items ? toMenuItems(i.items) : []
+    }));
+    const titleize = (handle) => handle.replaceAll("-", " ").replace(/^./, (c) => c.toUpperCase());
+    const list = await gql(auth, `{ menus(first: 50) { nodes { id handle title } } }`);
+    for (const [handle, items] of menuEntries) {
+      const existing = list.menus.nodes.find((n) => n.handle === handle);
+      const input = toMenuItems(items);
+      if (existing) {
+        const res = await gql(auth, `mutation($id: ID!, $title: String!, $items: [MenuItemUpdateInput!]!) {
+            menuUpdate(id: $id, title: $title, items: $items) { userErrors { field message } }
+          }`, { id: existing.id, title: existing.title, items: input });
+        const errs = res.menuUpdate.userErrors;
+        if (errs.length)
+          console.error(`  ✗ menu ${handle}: ${joinErrors(errs)}`);
+        else
+          console.log(`  ✓ menu ${handle} updated (${items.length} top-level items)`);
+      } else {
+        const res = await gql(auth, `mutation($title: String!, $handle: String!, $items: [MenuItemCreateInput!]!) {
+            menuCreate(title: $title, handle: $handle, items: $items) { userErrors { field message } }
+          }`, { title: titleize(handle), handle, items: input });
+        const errs = res.menuCreate.userErrors;
+        if (errs.length)
+          console.error(`  ✗ menu ${handle}: ${joinErrors(errs)}`);
+        else
+          console.log(`  ✓ menu ${handle} created (${items.length} top-level items)`);
+      }
+    }
+  }
   try {
     const pubs = await gql(auth, `{ publications(first: 10) { nodes { id name } } }`);
     const online = pubs.publications.nodes.find((n) => n.name === "Online Store");
@@ -13006,6 +13070,20 @@ alone. Validate anytime with \`zalify brand validate\` (defaults to cwd).
 - Prices are strings with 2 decimals, in the store currency. Honest
   markdowns only (15–25% off typical).
 - Colors and variants get evocative names per brand.md — never "Gray 02".
+- **Pages** (\`pages\`): the standard store pages, upserted to Shopify by
+  \`brand push\` and linked from the footer menu. Keep the scaffold's six
+  handles (about, shipping-delivery, returns-exchanges, faq,
+  privacy-policy, terms-of-service); write \`bodyHtml\` in the brand
+  voice (simple HTML: h2/p/ul/li). The \`contact\` page already exists in
+  every Shopify store — link it, don't create it.
+- **Menus** (\`menus\`): \`main-menu\` (header nav) and \`footer\`, upserted
+  by \`brand push\`; the catalog is the source of truth (a push replaces
+  the menu's items). Items are \`{ title, url, items? }\`, max 3 levels.
+  A top-level main-menu item with children opens the theme's mega
+  panel; footer top-level items with children become footer columns
+  (Shop / Help / Company is the standard trio). URLs are relative
+  (\`/collections/<handle>\`, \`/pages/<handle>\`) and must point at
+  handles that exist in this file.
 
 ## images/manifest.json rules
 
@@ -13127,7 +13205,83 @@ var CATALOG_JSON = (vendor, currency) => JSON.stringify({
       descriptionHtml: "<p>Real markdowns on favorites.</p>",
       rule: { tag: "collection:sale" }
     }
-  ]
+  ],
+  pages: [
+    {
+      handle: "about",
+      title: "About",
+      bodyHtml: "<p><Two-three paragraphs in the brand voice: who we are, what we make, why it matters.></p>"
+    },
+    {
+      handle: "shipping-delivery",
+      title: "Shipping & Delivery",
+      bodyHtml: "<p><Shipping promise in the brand voice: threshold for free shipping, carriers, timing, tracking.></p>"
+    },
+    {
+      handle: "returns-exchanges",
+      title: "Returns & Exchanges",
+      bodyHtml: "<p><Return window, condition rules, how to start a return, refund timing — friendly and concrete.></p>"
+    },
+    {
+      handle: "faq",
+      title: "FAQ",
+      bodyHtml: "<h2>Question one?</h2><p>Answer.</p><h2>Question two?</h2><p>Answer. 5-8 real questions a shopper would ask.</p>"
+    },
+    {
+      handle: "privacy-policy",
+      title: "Privacy Policy",
+      bodyHtml: "<p><Plain-language privacy policy: what's collected, why, cookies, contact email.></p>"
+    },
+    {
+      handle: "terms-of-service",
+      title: "Terms of Service",
+      bodyHtml: "<p><Plain-language terms: orders, pricing, liability, governing law.></p>"
+    }
+  ],
+  menus: {
+    "main-menu": [
+      { title: "New in", url: "/collections/all" },
+      {
+        title: "Shop",
+        url: "/collections/all",
+        items: [
+          { title: "Best sellers", url: "/collections/best-sellers" },
+          { title: "Sale", url: "/collections/sale" }
+        ]
+      },
+      { title: "Sale", url: "/collections/sale" }
+    ],
+    footer: [
+      {
+        title: "Shop",
+        url: "/collections/all",
+        items: [
+          { title: "Shop all", url: "/collections/all" },
+          { title: "Best sellers", url: "/collections/best-sellers" },
+          { title: "Sale", url: "/collections/sale" }
+        ]
+      },
+      {
+        title: "Help",
+        url: "/pages/shipping-delivery",
+        items: [
+          { title: "Shipping & Delivery", url: "/pages/shipping-delivery" },
+          { title: "Returns & Exchanges", url: "/pages/returns-exchanges" },
+          { title: "FAQ", url: "/pages/faq" },
+          { title: "Contact", url: "/pages/contact" }
+        ]
+      },
+      {
+        title: "Company",
+        url: "/pages/about",
+        items: [
+          { title: "About", url: "/pages/about" },
+          { title: "Privacy Policy", url: "/pages/privacy-policy" },
+          { title: "Terms of Service", url: "/pages/terms-of-service" }
+        ]
+      }
+    ]
+  }
 }, null, 2) + `
 `;
 var MANIFEST_JSON = JSON.stringify({
@@ -13284,6 +13438,46 @@ function brandValidate(dir2 = ".") {
         }
       }
     }
+    const pageHandles = new Set;
+    for (const pg of catalog.pages ?? []) {
+      const where = `page "${pg.handle ?? pg.title ?? "?"}"`;
+      if (!pg.handle || !pg.title || !pg.bodyHtml) {
+        problems.push(`${where}: handle, title, and bodyHtml are required`);
+      }
+      if (pg.handle) {
+        if (pageHandles.has(pg.handle))
+          problems.push(`${where}: duplicate handle`);
+        pageHandles.add(pg.handle);
+      }
+      if (pg.bodyHtml?.includes("<p><")) {
+        warnings.push(`${where}: bodyHtml still contains a scaffold placeholder`);
+      }
+    }
+    const collectionHandles = new Set((catalog.collections ?? []).map((c) => c.handle).filter(Boolean));
+    const checkMenu = (nodes, menu, depth) => {
+      if (depth > 3) {
+        problems.push(`menu "${menu}": nested deeper than 3 levels`);
+        return;
+      }
+      for (const node of nodes) {
+        const where = `menu "${menu}" item "${node.title ?? "?"}"`;
+        if (!node.title || !node.url)
+          problems.push(`${where}: title and url required`);
+        const col = node.url?.match(/^\/collections\/([a-z0-9-]+)$/)?.[1];
+        if (col && col !== "all" && !collectionHandles.has(col)) {
+          problems.push(`${where}: collection "${col}" not in catalog.json`);
+        }
+        const pageRef = node.url?.match(/^\/pages\/([a-z0-9-]+)$/)?.[1];
+        if (pageRef && pageRef !== "contact" && !pageHandles.has(pageRef)) {
+          problems.push(`${where}: page "${pageRef}" not in catalog.json pages`);
+        }
+        if (node.items?.length)
+          checkMenu(node.items, menu, depth + 1);
+      }
+    };
+    for (const [menuHandle, nodes] of Object.entries(catalog.menus ?? {})) {
+      checkMenu(nodes ?? [], menuHandle, 1);
+    }
   }
   const manifest = readJson2("images/manifest.json");
   if (manifest) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zalify/cli",
-  "version": "0.12.1",
+  "version": "0.13.0",
   "description": "Zalify CLI - command-line interface for Zalify",
   "type": "module",
   "main": "dist/cli.js",