@nevios/cli 0.1.0 → 0.2.0

package/bin/nevios.mjs

@@ -19,7 +19,15 @@ import { execSync, spawn } from "node:child_process";
 import { readdir, readFile } from "node:fs/promises";
 import { resolve } from "node:path";
 
-import { collectAssets, collectModules, deployStore, detectGit, undeployStore } from "../src/index.mjs";
+import {
+  collectAssets,
+  collectModules,
+  deployStore,
+  deriveRoutesFromFiles,
+  detectGit,
+  syncRoutes,
+  undeployStore,
+} from "../src/index.mjs";
 
 function parseArgs(argv) {
   const a = { _: [] };
@@ -76,8 +84,10 @@ const fail = (m) => {
 async function main() {
   const args = parseArgs(process.argv.slice(2));
   const cmd = args._[0];
-  if (!cmd || !["start", "push", "preview", "undeploy"].includes(cmd)) {
-    fail(`usage: nevios <start|push|preview|undeploy> [--build] [--dir <path>] [--store h] [--account h]`);
+  if (!cmd || !["start", "push", "preview", "undeploy", "routes"].includes(cmd)) {
+    fail(
+      `usage: nevios <start|push|preview|undeploy|routes sync> [--build] [--dir <path>] [--store h] [--account h]`,
+    );
   }
   const cwd = process.cwd();
   await loadDotenv(cwd);
@@ -107,6 +117,54 @@ async function main() {
   if (!store) fail("store is required (--store / NEVIOS_STORE / nevios.json)");
   if (!token) fail("token is required (--token / NEVIOS_PAT)");
 
+  if (cmd === "routes") {
+    // `nevios routes sync` — register the store's static pages in the Nevios
+    // route registry (feeds sitemap/SEO/dashboard "Live pages"). Reads the
+    // manifest `nevios.routes.json`: { app, patterns, exclude, routes: {"/path": {title, seo}} }.
+    if (args._[1] !== "sync") fail(`usage: nevios routes sync [--app ./app]`);
+    let manifest = {};
+    try {
+      manifest = JSON.parse(await readFile(resolve(cwd, "nevios.routes.json"), "utf8"));
+    } catch {
+      /* optional — defaults below */
+    }
+    const appDir = resolve(cwd, args.app ?? manifest.app ?? "./app");
+    const exclude = manifest.exclude ?? ["/checkout", "/account", "/cart", "/search", "/design", "/order"];
+    let files = [];
+    try {
+      files = (await readdir(resolve(appDir, "routes"), { withFileTypes: true }))
+        .filter((e) => e.isFile())
+        .map((e) => e.name);
+    } catch (e) {
+      fail(`could not read ${appDir}/routes: ${e.message}`);
+    }
+    const meta = manifest.routes ?? {};
+    const routes = deriveRoutesFromFiles(files, { exclude }).map((path) => ({
+      path,
+      title: meta[path]?.title ?? null,
+      seo: meta[path]?.seo ?? undefined,
+    }));
+    console.log(`\nnevios routes sync — ${store} @ ${account} → ${apiUrl}`);
+    for (const r of routes) console.log(`  ${r.path}${r.title ? ` — ${r.title}` : ""}`);
+    if (args["dry-run"]) {
+      console.log(`\n(dry run — nothing synced)\n`);
+      return;
+    }
+    const result = await syncRoutes({
+      apiUrl,
+      token,
+      account,
+      store,
+      source: manifest.source ?? "storefront",
+      patterns: manifest.patterns,
+      routes,
+    }).catch((e) => fail(e.message));
+    console.log(
+      `\n✓ routes synced — +${result.added ?? 0} added · ~${result.updated ?? 0} updated · −${result.deactivated ?? 0} deactivated (${result.active_total ?? routes.length} active)\n`,
+    );
+    return result;
+  }
+
   if (cmd === "undeploy") {
     console.log(`\nnevios undeploy — ${store} @ ${account}`);
     const sf = await undeployStore({ apiUrl, token, account, store }).catch((e) => fail(e.message));

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@nevios/cli",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "type": "module",
-  "description": "nevios \u2014 the storefront developer CLI: push a React store to Nevios hosting (Cloudflare), preview, and scaffold.",
+  "description": "nevios — the storefront developer CLI: push a React store to Nevios hosting (Cloudflare), preview, and scaffold.",
   "bin": {
     "nevios": "bin/nevios.mjs"
   },

package/src/index.mjs

@@ -145,6 +145,89 @@ export async function deployStore({
   return json?.storefront ?? json;
 }
 
+/**
+ * Derive the store's custom-route paths from its flat-route filenames
+ * (React Router / Remix flat-file convention). Only STATIC routes come out —
+ * dynamic segments ($handle) are entity routes, represented by `patterns`
+ * server-side, never registered one-by-one.
+ *
+ *   _index.tsx            → /
+ *   o-nas.tsx             → /o-nas
+ *   account_.verify.tsx   → /account/verify
+ *   collections._index.tsx→ /collections
+ *   products.$handle.tsx  → (skipped — dynamic)
+ *   design.*              → (drop via manifest `exclude`)
+ */
+export function deriveRoutesFromFiles(fileNames, { exclude = [] } = {}) {
+  const paths = new Set();
+  for (const name of fileNames) {
+    const m = /^(.*)\.(tsx|ts|jsx|js|mdx?)$/.exec(name);
+    if (!m) continue; // not a route module (css, maps, …)
+    const base = m[1];
+    if (!base || base.includes("$")) continue; // dynamic → covered by patterns
+    const segments = [];
+    // Split on `.` only outside [x] escapes, so sitemap[.]xml stays one segment.
+    for (const raw of base.split(/\.(?![^[\]]*\])/)) {
+      if (raw === "_index") continue; // index of its parent path
+      if (raw.startsWith("_")) continue; // pathless layout segment
+      if (raw.startsWith("(") && raw.endsWith(")")) continue; // optional segment — default URL omits it
+      // trailing `_` (account_) opts out of layout nesting; URL segment unchanged.
+      const seg = raw.endsWith("_") ? raw.slice(0, -1) : raw;
+      if (!seg) continue;
+      // [x] escapes a literal char: sitemap[.]xml → sitemap.xml
+      segments.push(seg.replace(/\[(.*?)\]/g, "$1"));
+    }
+    const path = "/" + segments.join("/");
+    if (exclude.some((e) => path === e || path.startsWith(e.endsWith("/") ? e : e + "/"))) continue;
+    paths.add(path);
+  }
+  return [...paths].sort();
+}
+
+/**
+ * POST the store's full custom-route set to Nevios (admin twin of the
+ * storefront routes/sync). Authorized by the same NEVIOS_PAT deploy token as
+ * `push` — new pages register themselves on every deploy.
+ */
+export async function syncRoutes({
+  apiUrl,
+  token,
+  account,
+  store,
+  source = "storefront",
+  patterns,
+  routes,
+  apiVersion = DEFAULT_VERSION,
+  fetch = globalThis.fetch,
+}) {
+  if (!apiUrl) throw new Error("routes sync: apiUrl is required");
+  if (!token) throw new Error("routes sync: token (NEVIOS_PAT) is required");
+  if (!account) throw new Error("routes sync: account handle is required");
+  if (!store) throw new Error("routes sync: store handle is required");
+  const base = apiUrl.replace(/\/+$/, "");
+  const url = `${base}/admin/${apiVersion}/${encodeURIComponent(account)}/storefronts/${encodeURIComponent(store)}/routes/sync.json`;
+  const body = { source, routes };
+  if (patterns && Object.keys(patterns).length) body.patterns = patterns;
+  const res = await fetch(url, {
+    method: "POST",
+    headers: {
+      Authorization: `Bearer ${token}`,
+      "Content-Type": "application/json",
+      Accept: "application/json",
+    },
+    body: JSON.stringify(body),
+  });
+  const text = await res.text();
+  let json = null;
+  try {
+    json = text ? JSON.parse(text) : null;
+  } catch {
+    json = null;
+  }
+  if (!res.ok) throw new Error(json?.error?.message || `routes sync failed (HTTP ${res.status})`);
+  return json?.routes_sync ?? json;
+}
+
 /** Undeploy a store's isolate → back to the shared default. */
 export async function undeployStore({
   apiUrl,