@ecomcx/create-ecomweb 1.30.0 → 1.31.0

package/bin/ecomweb.mjs

@@ -29,7 +29,7 @@ const HELP = `${c.bold("create-ecomweb")} — công cụ viết theme/plugin cho
   ${c.cyan("test")} [thư-mục]                      đóng gói + chạy test xUnit trong tests/ trên CMS thử (Cms.Plugin.Testing)
   ${c.cyan("check")} [thư-mục]                     chạy thử trên CMS: manifest, biên dịch, quét bảo mật (như khi cài / nộp Store)
   ${c.cyan("pack")} [thư-mục] [--out dist]         đóng gói → dist/<slug>-<version>.zip
-  ${c.cyan("deploy")} [thư-mục] [--activate]       đóng gói + cài lên CMS (--url, --user, --password)
+  ${c.cyan("deploy")} [thư-mục] [--activate]       đóng gói + cài lên CMS (--url, --user, --password; --accept-permissions, --accept-risk)
   ${c.cyan("dev")} [thư-mục]                       tự đóng gói + cài lại mỗi khi sửa file
   ${c.cyan("env")} up [--dev] [--build DIR] | status | logs [api|builder] [-f] | down [--purge]
                                       CMS chạy bằng Docker để thử theme/plugin (--dev: sửa là thấy, không build lại)
@@ -47,6 +47,8 @@ function connection() {
     user: args.user ?? (process.env.CMS_USER ? undefined : saved?.user),
     password: args.password ?? (process.env.CMS_PASSWORD ? undefined : saved?.password),
     activate: !!args.activate,
+    acceptPermissions: !!args["accept-permissions"],
+    acceptRisk: !!args["accept-risk"],
   };
 }
 

package/lib/deploy.mjs

@@ -2,7 +2,7 @@ import fs from "node:fs";
 import { c } from "./util.mjs";
 
 /** Đăng nhập CMS và upload gói zip (dùng cho `cms deploy` / `cms dev`). */
-export async function deploy({ zipPath, kind, manifest }, { url, user, password, activate }) {
+export async function deploy({ zipPath, kind, manifest }, { url, user, password, activate, acceptPermissions = false, acceptRisk = false }) {
   const base = (url ?? process.env.CMS_URL ?? "http://localhost:5100").replace(/\/$/, "");
   user ??= process.env.CMS_USER ?? "admin";
   password ??= process.env.CMS_PASSWORD;
@@ -13,30 +13,30 @@ export async function deploy({ zipPath, kind, manifest }, { url, user, password,
   const { accessToken } = await login.json();
   const auth = { authorization: `Bearer ${accessToken}` };
 
+  // CMS hỏi lại khi gói xin quyền mới (409) hoặc bộ quét thấy hành vi rủi ro cao (422, canOverride): quản trị viên phải đồng ý.
+  // Trên máy dev của chính bạn: --accept-permissions / --accept-risk để đồng ý thay (giống bấm "Đồng ý" trong trang Plugin).
+  const query = new URLSearchParams();
+  if (acceptPermissions) query.set("acceptPermissions", manifest.slug);
+  if (acceptRisk) query.set("acceptRisk", "true");
   const form = new FormData();
   form.append("file", new Blob([fs.readFileSync(zipPath)], { type: "application/zip" }), zipPath.split("/").pop());
-  const res = await fetch(`${base}/api/admin/${kind === "theme" ? "themes" : "plugins"}/upload`, { method: "POST", headers: auth, body: form });
+  const res = await fetch(`${base}/api/admin/${kind === "theme" ? "themes" : "plugins"}/upload${query.size ? `?${query}` : ""}`, { method: "POST", headers: auth, body: form });
   const body = await res.json().catch(() => ({}));
   if (!res.ok) {
     const details = body.errors ? "\n" + Object.values(body.errors).flat().map((e) => "  - " + e).join("\n") : "";
+    const asked = body.data?.permissionsRequired;
+    if (res.status === 409 && asked)
+      throw new Error(`${body.title} (409)\n  Quyền xin thêm: ${asked.added.join(", ")} — đồng ý: chạy lại với --accept-permissions`);
+    if (res.status === 422 && body.canOverride) {
+      const findings = (body.scan?.findings ?? []).filter((f) => f.severity !== "info").map((f) => `  - [${f.severity}] ${f.message} (${f.file ?? ""})`).join("\n");
+      throw new Error(`${body.title} (422)\n${findings}\n  Tin nguồn gốc gói: chạy lại với --accept-risk`);
+    }
     throw new Error(`${body.title ?? "Upload thất bại"} (${res.status})${details}`);
   }
   console.log(c.green(`  ✓ ${body.message}`));
   if (body.restartRequired) await waitHealthy(base);
 
-  if (body.buildId) {
-    process.stdout.write(c.dim(`  • Đang build #${body.buildId}`));
-    for (let i = 0; i < 600; i++) {
-      await new Promise((r) => setTimeout(r, 1000));
-      let b;
-      try { b = await (await fetch(`${base}/api/admin/builds/${body.buildId}`, { headers: auth })).json(); }
-      catch { process.stdout.write("?"); continue; } // CMS đang khởi động lại
-
-      if (b.status === "succeeded") { console.log(c.green(" ✓ build thành công")); break; }
-      if (b.status === "failed") { console.log(c.red(" ✗ build lỗi\n") + (b.log ?? "").split("\n").slice(-25).join("\n")); throw new Error("Build thất bại"); }
-      process.stdout.write(".");
-    }
-  }
+  if (body.buildId) await waitBuild(base, auth, body.buildId);
 
   if (kind === "plugin" && activate) {
     const r = await fetch(`${base}/api/admin/plugins/${manifest.slug}/activate`, { method: "POST", headers: auth });
@@ -44,14 +44,34 @@ export async function deploy({ zipPath, kind, manifest }, { url, user, password,
     if (!r.ok) throw new Error(b.title ?? "Kích hoạt thất bại");
     console.log(c.green(`  ✓ ${b.message}`));
     if (b.restartRequired) await waitHealthy(base);
+    // Plugin có phần website: được bật khi website build xong — chờ để báo đúng kết quả
+    if (b.buildId) await waitBuild(base, auth, b.buildId);
   }
   if (kind === "theme" && activate) {
     const r = await fetch(`${base}/api/admin/themes/${manifest.slug}/activate`, { method: "POST", headers: auth });
-    if (!r.ok) throw new Error(((await r.json().catch(() => ({}))).title) ?? "Kích hoạt theme thất bại");
+    const b = await r.json().catch(() => ({}));
+    if (!r.ok) throw new Error(b.title ?? "Kích hoạt theme thất bại");
+    // Bật theme = build website với theme mới; website chỉ chuyển theme khi build xong (lỗi → giữ theme cũ)
+    if (b.buildId) await waitBuild(base, auth, b.buildId);
     console.log(c.green("  ✓ Đã kích hoạt theme"));
   }
 }
 
+/** Chờ một lượt build của website; lỗi → in 25 dòng cuối của log và ném lỗi (website vẫn chạy bản trước). */
+async function waitBuild(base, auth, id) {
+  process.stdout.write(c.dim(`  • Đang build #${id}`));
+  for (let i = 0; i < 900; i++) {
+    await new Promise((r) => setTimeout(r, 1000));
+    let b;
+    try { b = await (await fetch(`${base}/api/admin/builds/${id}`, { headers: auth })).json(); }
+    catch { process.stdout.write("?"); continue; } // CMS đang khởi động lại
+    if (b.status === "succeeded") { console.log(c.green(" ✓ build thành công")); return; }
+    if (b.status === "failed") { console.log(c.red(" ✗ build lỗi\n") + (b.log ?? "").split("\n").slice(-25).join("\n")); throw new Error("Build thất bại — website vẫn chạy bản trước"); }
+    process.stdout.write(".");
+  }
+  throw new Error(`Build #${id} chưa xong sau 15 phút — xem Giao diện › Lịch sử build`);
+}
+
 async function waitHealthy(base) {
   process.stdout.write(c.dim("  • Chờ CMS khởi động lại"));
   await new Promise((r) => setTimeout(r, 1500));

package/lib/scaffold.mjs

@@ -3,6 +3,9 @@ import fs from "node:fs";
 import path from "node:path";
 import { c, pascal, slugify, write, findCmsRepo } from "./util.mjs";
 
+/** Bản Ecomweb.Plugin.Sdk / .Testing cho plugin dạng dự án và dự án test — cùng bản với core có các API mà SDK npm này nhắm tới (CMS 1.20.0). */
+export const PLUGIN_SDK_VERSION = "1.20.0";
+
 export function scaffoldTheme(name, { parent, dir, blocks = false } = {}) {
   const slug = slugify(name);
   const root = path.resolve(dir ?? slug);
@@ -197,15 +200,25 @@ a { color: var(--primary); }
     { type: "column", content: [{ type: "navigation", attrs: { location: "primary" } }] },
   ] }));
   write(path.join(root, "parts", "footer.json"), doc({ type: "copyright" }));
+  // SEO: mỗi trang đúng một H1 — trang danh sách / lưu trữ dùng queryTitle (tên chuyên mục, kết quả tìm kiếm…), bài / trang dùng postTitle
   write(path.join(root, "templates", "index.json"), doc(part("header", "header"), main(
+    { type: "queryTitle" },
+    { type: "query", attrs: { inherit: true }, content: [
+      { type: "postTemplate", content: [{ type: "postTitle", attrs: { level: 2, link: true } }, { type: "postDate" }, { type: "postExcerpt" }] },
+      { type: "pagination" },
+      { type: "queryEmpty", content: [p("Chưa có bài viết.")] },
+    ] }), part("footer", "footer")));
+  write(path.join(root, "templates", "archive.json"), doc(part("header", "header"), main(
+    { type: "breadcrumbs" }, { type: "queryTitle" }, { type: "termDescription" },
     { type: "query", attrs: { inherit: true }, content: [
       { type: "postTemplate", content: [{ type: "postTitle", attrs: { level: 2, link: true } }, { type: "postDate" }, { type: "postExcerpt" }] },
       { type: "pagination" },
       { type: "queryEmpty", content: [p("Chưa có bài viết.")] },
     ] }), part("footer", "footer")));
   write(path.join(root, "templates", "single.json"), doc(part("header", "header"), main(
-    { type: "postTitle" }, { type: "postDate" }, { type: "featuredImage" }, { type: "postContent" }, { type: "postTerms" }, { type: "comments" }), part("footer", "footer")));
-  write(path.join(root, "templates", "page.json"), doc(part("header", "header"), main({ type: "postTitle" }, { type: "postContent" }), part("footer", "footer")));
+    { type: "breadcrumbs" }, { type: "postTitle" }, { type: "postDate" }, { type: "featuredImage" }, { type: "postContent" }, { type: "postTerms" },
+    { type: "postNavigation" }, { type: "comments" }), part("footer", "footer")));
+  write(path.join(root, "templates", "page.json"), doc(part("header", "header"), main({ type: "breadcrumbs" }, { type: "postTitle" }, { type: "postContent" }), part("footer", "footer")));
   write(path.join(root, "templates", "404.json"), doc(part("header", "header"), main(
     { type: "heading", attrs: { level: 1 }, content: [{ type: "text", text: "Không tìm thấy trang" }] }, { type: "search" }), part("footer", "footer")));
 }
@@ -258,8 +271,32 @@ export function scaffoldSimplePlugin(name, { dir, tests = false } = {}) {
   return scaffoldPlugin(name, { dir, tests });
 }
 
+/**
+ * Nguồn gói Ecomweb.Plugin.Sdk / .Testing: nuget.org, cộng feed local khi đặt CMS_NUGET_FEED (thư mục chứa .nupkg) hoặc khi
+ * plugin nằm trong repo core (sdk/nuget, tạo bằng scripts/pack-sdk.sh).
+ */
+function nugetFeed(root) {
+  if (process.env.CMS_NUGET_FEED) return path.resolve(process.env.CMS_NUGET_FEED);
+  const repo = findCmsRepo(root);
+  return repo ? path.join(repo, "sdk", "nuget") : null;
+}
+
+/** nuget.config: khai báo XML phải là ký tự đầu tiên của file (dòng trống phía trước → dotnet restore báo lỗi đọc file). */
+function writeNugetConfig(dir, feed) {
+  write(path.join(dir, "nuget.config"), `<?xml version="1.0" encoding="utf-8"?>
+<configuration>
+  <packageSources>
+    <add key="nuget.org" value="https://api.nuget.org/v3/index.json" />
+    <add key="cms-local" value="${feed}" />
+  </packageSources>
+</configuration>
+`);
+}
+
 /** Dự án test xUnit dùng Ecomweb.Plugin.Testing (namespace Cms.Plugin.Testing) — chạy bằng `create-ecomweb test` (cần .NET SDK). */
 function scaffoldTests(root, cls, slug) {
+  const feed = nugetFeed(root);
+  if (feed) writeNugetConfig(path.join(root, "tests"), feed);
   write(path.join(root, "tests", `${cls}.Tests.csproj`), `<Project Sdk="Microsoft.NET.Sdk">
   <PropertyGroup>
     <TargetFramework>net10.0</TargetFramework>
@@ -268,7 +305,7 @@ function scaffoldTests(root, cls, slug) {
     <IsPackable>false</IsPackable>
   </PropertyGroup>
   <ItemGroup>
-    <PackageReference Include="Ecomweb.Plugin.Testing" Version="1.13.0" />
+    <PackageReference Include="Ecomweb.Plugin.Testing" Version="${PLUGIN_SDK_VERSION}" />
     <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.14.1" />
     <PackageReference Include="xunit" Version="2.9.3" />
     <PackageReference Include="xunit.runner.visualstudio" Version="3.1.4" />
@@ -349,9 +386,7 @@ export function scaffoldPlugin(name, { backend = "source", admin = false, fronte
   if (backend === "source") write(path.join(root, `${cls}.cs`), pluginSource(name, slug, cls));
 
   if (backend === "project") {
-    const repo = findCmsRepo(root);
-    // Nguồn Ecomweb.Plugin.Sdk: nuget.org; thêm feed local khi ở trong repo CMS hoặc khi đặt CMS_NUGET_FEED (thư mục chứa .nupkg)
-    const feed = process.env.CMS_NUGET_FEED ? path.resolve(process.env.CMS_NUGET_FEED) : repo ? path.join(repo, "sdk", "nuget") : null;
+    const feed = nugetFeed(root);
     write(path.join(root, "backend", `${cls}.csproj`), `
 <Project Sdk="Microsoft.NET.Sdk">
   <PropertyGroup>
@@ -365,7 +400,7 @@ export function scaffoldPlugin(name, { backend = "source", admin = false, fronte
   </PropertyGroup>
   <ItemGroup>
     <FrameworkReference Include="Microsoft.AspNetCore.App" />
-    <PackageReference Include="Ecomweb.Plugin.Sdk" Version="1.13.0">
+    <PackageReference Include="Ecomweb.Plugin.Sdk" Version="${PLUGIN_SDK_VERSION}">
       <Private>false</Private>
       <ExcludeAssets>runtime</ExcludeAssets>
     </PackageReference>
@@ -390,15 +425,7 @@ export function scaffoldPlugin(name, { backend = "source", admin = false, fronte
   </ItemGroup>
 </Project>
 `);
-    if (feed) write(path.join(root, "backend", "nuget.config"), `
-<?xml version="1.0" encoding="utf-8"?>
-<configuration>
-  <packageSources>
-    <add key="nuget.org" value="https://api.nuget.org/v3/index.json" />
-    <add key="cms-local" value="${feed}" />
-  </packageSources>
-</configuration>
-`);
+    if (feed) writeNugetConfig(path.join(root, "backend"), feed);
     write(path.join(root, "backend", `${cls}Plugin.cs`), pluginSource(name, slug, cls));
   }
 
@@ -451,6 +478,7 @@ registerMetaBox({
     write(path.join(root, "frontend", "index.tsx"), `
 import { definePlugin } from "@ecomcx/ecomweb-theme-sdk";
 
+
 /** Phần hiển thị ngoài website: shortcode, widget, slot, filter. */
 export default definePlugin({
   shortcodes: {

package/lib/util.mjs

@@ -85,7 +85,8 @@ export function findCmsRepo(start = process.cwd()) {
   if (process.env.CMS_REPO && fs.existsSync(path.join(process.env.CMS_REPO, "sdk"))) return path.resolve(process.env.CMS_REPO);
   let dir = path.resolve(start);
   for (let i = 0; i < 8; i++) {
-    if (fs.existsSync(path.join(dir, "sdk", "theme-sdk", "package.json")) && fs.existsSync(path.join(dir, "backend"))) return dir;
+    // Repo core: backend/src/Cms.Plugin.Sdk (bố cục cũ còn có sdk/theme-sdk — SDK npm nay ở repo ecomweb-sdk riêng)
+    if (fs.existsSync(path.join(dir, "backend", "src", "Cms.Plugin.Sdk")) || (fs.existsSync(path.join(dir, "sdk", "theme-sdk", "package.json")) && fs.existsSync(path.join(dir, "backend")))) return dir;
     const parent = path.dirname(dir);
     if (parent === dir) break;
     dir = parent;

package/lib/validate.mjs

@@ -34,6 +34,7 @@ export function validate(dir) {
     if (!okShape) errors.push('translations phải có dạng { "en": { "Chuỗi gốc": "Bản dịch" } }');
   }
   if (!manifest.requires?.cms) warnings.push('Nên khai báo requires.cms, vd ">=1.0.0 <2.0.0"');
+  else if (narrowCmsUpperBound(manifest.requires.cms)) warnings.push(narrowCmsUpperBound(manifest.requires.cms));
   checkPermissions(manifest.permissions, errors, warnings);
   checkCsp(manifest.csp, errors);
 
@@ -65,6 +66,7 @@ export function validate(dir) {
       if (manifest.editing !== "blocks" && folder === "templates" && fs.readdirSync(d).some((f) => f.endsWith(".json")))
         warnings.push('templates/*.json chỉ được dùng khi theme.json có "editing": "blocks"');
     }
+    warnings.push(...seoStructure(dir));
     for (const f of manifest.settings ?? []) {
       if (!f.key) errors.push("settings: thiếu key");
       if (!FIELD_TYPES.includes(f.type)) errors.push(`settings.${f.key}: type "${f.type}" không hợp lệ (${FIELD_TYPES.join(", ")})`);
@@ -287,3 +289,54 @@ function contentDeclarations(manifest, errors, checkNames = false) {
   if (checkNames) for (const name of [...Object.keys(manifest.postTypes ?? {}), ...Object.keys(manifest.taxonomies ?? {})])
     if (!/^[a-z][a-z0-9_-]{0,31}$/.test(name)) errors.push(`Tên kiểu nội dung / phân loại "${name}" không hợp lệ (a-z, 0-9, _ -, bắt đầu bằng chữ, tối đa 32 ký tự)`);
 }
+
+/**
+ * Giới hạn trên hẹp hơn hết major (vd "<1.9.1", "<=1.9.0", "~1.6.0"): core 1.9.2 vẫn cài được (chỉ cảnh báo "chưa kiểm thử",
+ * CMS ≥ 1.20.0) nhưng core cũ hơn 1.20.0 sẽ TỪ CHỐI cài. Core không bớt API trong một major → nên để mở tới major kế tiếp.
+ */
+export function narrowCmsUpperBound(range) {
+  const parts = String(range).trim().split(/\s+/);
+  const min = parts.map((p) => /^(?:>=|\^|~)?v?(\d+)\.(\d+)/.exec(p)).find(Boolean);
+  const major = min ? Number(min[1]) : null;
+  const narrow = parts.some((p) => {
+    const m = /^(<=?|~)v?(\d+)(?:\.(\d+))?(?:\.(\d+))?/.exec(p);
+    if (!m) return false;
+    if (m[1] === "~") return true;
+    const [maj, minor, patch] = [Number(m[2]), Number(m[3] ?? 0), Number(m[4] ?? 0)];
+    return m[1] === "<=" || minor !== 0 || patch !== 0 || (major !== null && maj === major);
+  });
+  if (!narrow) return null;
+  const suggest = major !== null && min ? `">=${min[1]}.${min[2]}.0 <${major + 1}.0.0"` : '">=1.0.0 <2.0.0"';
+  return `requires.cms "${range}" chặn trước các bản core sau này dù vẫn tương thích (trong một major core chỉ thêm API, không bớt) — nên dùng ${suggest}`;
+}
+
+/**
+ * SEO: mỗi template khối (ghép cả phần dùng chung) nên có đúng một H1 — tiêu đề bài (postTitle), tiêu đề trang lưu trữ (queryTitle)
+ * hoặc khối tiêu đề cấp 1. Header có tên website là H1 làm mọi trang thành hai H1.
+ */
+export function seoStructure(dir) {
+  const out = [];
+  const read = (folder, name) => { try { const j = JSON.parse(fs.readFileSync(path.join(dir, folder, `${name}.json`), "utf8")); return j.blocks?.find((b) => b.type === "richtext")?.data ?? (j.type === "doc" ? j : null); } catch { return null; } };
+  const h1s = (node, seen = new Set(), inLoop = false) => {
+    if (!node || typeof node !== "object") return 0;
+    let n = 0;
+    const lvl = node.attrs?.level;
+    if (!inLoop && ((node.type === "postTitle" || node.type === "queryTitle") && (lvl ?? 1) === 1)) n++;
+    if (node.type === "heading" && lvl === 1) n++;
+    if (node.type === "siteTitle" && lvl === 1) n++;
+    if (node.type === "templatePart" && node.attrs?.slug && !seen.has(node.attrs.slug)) { seen.add(node.attrs.slug); n += h1s(read("parts", node.attrs.slug), seen, inLoop); }
+    const loop = inLoop || node.type === "postTemplate";
+    for (const c of node.content ?? []) n += h1s(c, seen, loop);
+    return n;
+  };
+  const tdir = path.join(dir, "templates");
+  if (!fs.existsSync(tdir)) return out;
+  for (const f of fs.readdirSync(tdir).filter((x) => x.endsWith(".json"))) {
+    const name = f.replace(/\.json$/, "");
+    const n = h1s(read("templates", name));
+    if (n === 0) out.push(`SEO: templates/${f} không có thẻ H1 — thêm "Tiêu đề bài" (postTitle) hoặc "Tiêu đề trang lưu trữ" (queryTitle)`);
+    else if (n > 1) out.push(`SEO: templates/${f} có ${n} thẻ H1 (tính cả header / footer) — mỗi trang chỉ nên có một H1`);
+  }
+  return out;
+}
+

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ecomcx/create-ecomweb",
-  "version": "1.30.0",
+  "version": "1.31.0",
   "description": "CLI tạo, kiểm tra, đóng gói và triển khai theme/plugin cho Ecomweb",
   "type": "module",
   "bin": {
@@ -13,9 +13,9 @@
     "README.md"
   ],
   "dependencies": {
-    "@ecomcx/ecomweb-admin-sdk": "1.30.0",
+    "@ecomcx/ecomweb-admin-sdk": "1.31.0",
     "@ecomcx/ecomweb-content": "^1.14.0",
-    "adm-zip": "0.5.18",
+    "adm-zip": "0.6.1",
     "esbuild": "0.25.12",
     "intl-messageformat": "12.1.3"
   },