pan-stack-cli 0.2.1 → 0.2.2

package/lib/ui/api.js

@@ -1,202 +0,0 @@
-// lib/ui/api.js — HTTP client cho Pan Studio backend (device-flow auth + project/file/export).
-// Dùng Node18 `fetch` global (không thêm dep như axios) — xem docs §3, §4.2.
-// Chỉ ĐỊNH NGHĨA hàm gọi endpoint theo solution §3/§5; backend device-flow/guard đang xây
-// song song nên một số endpoint có thể chưa tồn tại/chưa test được (honest-TODO cuối file).
-
-/**
- * @typedef {{ apiUrl: string, token?: string }} ApiClientOptions
- */
-
-/**
- * Lỗi HTTP có kèm status + body đã parse (nếu là JSON) để caller phân loại.
- */
-class ApiError extends Error {
-  constructor(message, { status, body } = {}) {
-    super(message);
-    this.name = "ApiError";
-    this.status = status;
-    this.body = body;
-  }
-}
-
-function messageForStatus(status, fallback) {
-  if (status === 401) {
-    return "Chưa đăng nhập hoặc key đã hết hạn — chạy `pan ui init` để đăng nhập lại.";
-  }
-  if (status === 403) {
-    return "Không đủ quyền truy cập tài nguyên này (kiểm tra scope key hoặc quyền dự án).";
-  }
-  if (status === 404) {
-    return "Không tìm thấy tài nguyên (404) — kiểm tra lại id/đường dẫn.";
-  }
-  if (status >= 500) {
-    return `Lỗi máy chủ Pan Studio (${status}) — thử lại sau.`;
-  }
-  return fallback;
-}
-
-/**
- * @param {string} base - `<apiUrl>/api/v1`
- * @param {string} pathName
- * @param {{ method?: string, token?: string, body?: any, headers?: Record<string,string>, raw?: boolean }} [opts]
- */
-async function request(base, pathName, opts = {}) {
-  const { method = "GET", token, body, headers = {}, raw = false } = opts;
-  const url = `${base}${pathName}`;
-  const finalHeaders = { Accept: "application/json", ...headers };
-  if (token) {
-    finalHeaders.Authorization = `Bearer ${token}`;
-  }
-  let payload;
-  if (body !== undefined && !raw) {
-    finalHeaders["Content-Type"] = "application/json";
-    payload = JSON.stringify(body);
-  } else if (raw) {
-    payload = body;
-  }
-
-  let res;
-  try {
-    res = await fetch(url, { method, headers: finalHeaders, body: payload });
-  } catch (err) {
-    throw new ApiError(
-      `Không kết nối được Pan Studio API (${url}): ${err.message}`,
-      { status: 0 }
-    );
-  }
-
-  const contentType = res.headers.get("content-type") || "";
-  const isJson = contentType.includes("application/json");
-  const text = await res.text();
-  const parsed = isJson && text ? safeJsonParse(text) : text;
-
-  if (!res.ok) {
-    const fallback =
-      (parsed && typeof parsed === "object" && (parsed.message || parsed.error)) ||
-      `HTTP ${res.status} ${res.statusText}`;
-    throw new ApiError(messageForStatus(res.status, fallback), {
-      status: res.status,
-      body: parsed,
-    });
-  }
-
-  return parsed;
-}
-
-function safeJsonParse(text) {
-  try {
-    return JSON.parse(text);
-  } catch {
-    return null;
-  }
-}
-
-/**
- * @param {ApiClientOptions} options
- */
-function createApiClient(options) {
-  const apiUrl = String(options.apiUrl || "").replace(/\/+$/, "");
-  const base = `${apiUrl}/api/v1`;
-  const token = options.token;
-
-  const call = (pathName, opts) => request(base, pathName, { token, ...opts });
-
-  return {
-    /** POST /auth/device/start — { clientName, scope, expiresInDays } */
-    deviceStart(opts = {}) {
-      return call("/auth/device/start", { method: "POST", body: opts });
-    },
-
-    /** POST /auth/device/poll — { deviceCode } */
-    devicePoll(deviceCode) {
-      return call("/auth/device/poll", { method: "POST", body: { deviceCode } });
-    },
-
-    /** GET /projects */
-    listProjects() {
-      return call("/projects");
-    },
-
-    /** GET /projects/:id */
-    getProject(id) {
-      return call(`/projects/${encodeURIComponent(id)}`);
-    },
-
-    /** GET /projects/:id/files */
-    listFiles(id) {
-      return call(`/projects/${encodeURIComponent(id)}/files`);
-    },
-
-    /** GET /projects/:id/files/content?path= */
-    getContent(id, filePath) {
-      const qs = new URLSearchParams({ path: filePath }).toString();
-      return call(`/projects/${encodeURIComponent(id)}/files/content?${qs}`);
-    },
-
-    /** PUT /projects/:id/files — { path, content, editNote } */
-    putFile(id, { path: filePath, content, editNote }) {
-      return call(`/projects/${encodeURIComponent(id)}/files`, {
-        method: "PUT",
-        body: { path: filePath, content, editNote },
-      });
-    },
-
-    /** DELETE /projects/:id/files?path= */
-    deleteFile(id, filePath) {
-      const qs = new URLSearchParams({ path: filePath }).toString();
-      return call(`/projects/${encodeURIComponent(id)}/files?${qs}`, {
-        method: "DELETE",
-      });
-    },
-
-    /** POST /projects/:id/export/html */
-    exportHtml(id) {
-      return call(`/projects/${encodeURIComponent(id)}/export/html`, {
-        method: "POST",
-      });
-    },
-
-    /** POST /projects/:id/export/react */
-    exportReact(id) {
-      return call(`/projects/${encodeURIComponent(id)}/export/react`, {
-        method: "POST",
-      });
-    },
-
-    /** GET /projects/:id/export/versions — poll trạng thái build */
-    pollExport(id) {
-      return call(`/projects/${encodeURIComponent(id)}/export/versions`);
-    },
-
-    /**
-     * Tải file nhị phân (vd export/versions/:vid/download) — trả Buffer.
-     * `url` có thể là path tương đối (nối base) hoặc URL tuyệt đối.
-     */
-    async download(downloadUrl) {
-      const target = /^https?:\/\//i.test(downloadUrl)
-        ? downloadUrl
-        : `${base}${downloadUrl}`;
-      const headers = token ? { Authorization: `Bearer ${token}` } : {};
-      let res;
-      try {
-        res = await fetch(target, { headers });
-      } catch (err) {
-        throw new ApiError(`Không tải được file (${target}): ${err.message}`, {
-          status: 0,
-        });
-      }
-      if (!res.ok) {
-        throw new ApiError(messageForStatus(res.status, `HTTP ${res.status}`), {
-          status: res.status,
-        });
-      }
-      const arrayBuffer = await res.arrayBuffer();
-      return Buffer.from(arrayBuffer);
-    },
-  };
-}
-
-module.exports = {
-  ApiError,
-  createApiClient,
-};

package/lib/ui/clone.js

@@ -1,115 +0,0 @@
-// lib/ui/clone.js — chọn dự án trên Pan Studio, tải cây file về local, ghi backend.id
-// vào app.panui.yaml (§4.4). Không tự xóa thư mục đích nếu đã tồn tại.
-const fs = require("fs");
-const path = require("path");
-const { createApiClient } = require("./api");
-const { getApiConfig, loadCredential, isExpired } = require("./config");
-const { findWorkspaceRoot, writeBackendId } = require("./workspace");
-const { menuSelect } = require("../menu-prompt");
-const { t } = require("../i18n");
-
-async function loadInquirer() {
-  const inq = await import("@inquirer/prompts").catch(() => null);
-  if (!inq) {
-    throw new Error("Cần TTY (@inquirer/prompts) cho lệnh này.");
-  }
-  return inq;
-}
-
-function toList(res) {
-  if (Array.isArray(res)) return res;
-  if (res && Array.isArray(res.items)) return res.items;
-  if (res && Array.isArray(res.data)) return res.data;
-  return [];
-}
-
-async function run(_args) {
-  const workspaceRoot = findWorkspaceRoot() || process.cwd();
-  const { apiUrl } = getApiConfig(workspaceRoot);
-  const cred = loadCredential(apiUrl);
-  if (!cred || isExpired(cred)) {
-    throw new Error("Chưa đăng nhập hoặc key đã hết hạn — chạy `pan ui init` trước.");
-  }
-  const api = createApiClient({ apiUrl, token: cred.token });
-
-  const projectsRes = await api.listProjects();
-  const list = toList(projectsRes);
-  if (!list.length) {
-    console.log("Chưa có dự án nào trên Pan Studio — tạo dự án trước khi clone.");
-    return;
-  }
-
-  const message = "Chọn dự án để clone:";
-  const choices = list.map((p) => ({
-    name: `${p.name || p.id}  (${p.id})`,
-    value: p.id,
-  }));
-  const hotkeys = [{ key: "x", label: t("EXIT_LABEL"), value: "__exit__" }];
-
-  let projectId;
-  try {
-    projectId = await menuSelect({ message, choices, hotkeys });
-  } catch (err) {
-    if (String(err && err.message) !== "no-core") throw err;
-    const inq = await loadInquirer();
-    projectId = await inq.select({
-      message,
-      choices: [...choices, new inq.Separator(), { name: `x  ${t("EXIT_LABEL")}`, value: "__exit__" }],
-      loop: false,
-    });
-  }
-  if (projectId === "__exit__") {
-    console.log(t("EXITED"));
-    process.exit(0);
-  }
-  const project = list.find((p) => p.id === projectId) || { id: projectId };
-
-  // BUGFIX (2026-07-23): `inq` chỉ được gán trong nhánh catch (fallback khi menuSelect lỗi
-  // "no-core") — khi menuSelect (hệ thống menu mới) chạy THÀNH CÔNG, `inq` chưa từng tồn tại
-  // → "inq is not defined" ở bước nhập thư mục đích. Tự nạp riêng, không phụ thuộc nhánh trên.
-  const inqInput = await loadInquirer();
-  const targetInput = await inqInput.input({
-    message: "Thư mục đích để clone (vd: pan-ui, ./design/landing, /abs/path):",
-    default: "pan-ui",
-  });
-  const targetDir = path.isAbsolute(targetInput)
-    ? targetInput
-    : path.resolve(process.cwd(), targetInput);
-
-  if (fs.existsSync(targetDir)) {
-    throw new Error(`Thư mục đã tồn tại: ${targetDir} — xóa thủ công rồi thử lại.`);
-  }
-
-  console.log(`Tải dự án '${project.name || project.id}' về ${targetDir} ...`);
-  const treeRes = await api.listFiles(projectId);
-  const files = toList(treeRes);
-
-  fs.mkdirSync(targetDir, { recursive: true });
-  let count = 0;
-  for (const f of files) {
-    if (f.fileType === "directory" || f.fileType === "dir") {
-      continue;
-    }
-    const filePath = f.filePath || f.path;
-    if (!filePath) continue;
-    const contentRes = await api.getContent(projectId, filePath);
-    const content =
-      typeof contentRes === "string" ? contentRes : contentRes && contentRes.content;
-    const dest = path.join(targetDir, filePath);
-    fs.mkdirSync(path.dirname(dest), { recursive: true });
-    fs.writeFileSync(dest, content ?? "", "utf8");
-    console.log(`  + ${filePath}`);
-    count += 1;
-  }
-
-  const appYamlPath = path.join(targetDir, "app.panui.yaml");
-  if (!fs.existsSync(appYamlPath)) {
-    fs.mkdirSync(path.dirname(appYamlPath), { recursive: true });
-    fs.writeFileSync(appYamlPath, "", "utf8");
-  }
-  writeBackendId(appYamlPath, { id: projectId, apiUrl });
-
-  console.log(`Đã clone ${count} file vào: ${targetDir}`);
-}
-
-module.exports = { run };

package/lib/ui/config.js

@@ -1,182 +0,0 @@
-// lib/ui/config.js — cấu hình `pan ui`: API/WEB URL (.pan-env-build.yaml) + credential store
-// (~/.pan/credentials.json). Không phụ thuộc lib khác ngoài fs/path/os (giữ nhẹ, dễ test).
-const fs = require("fs");
-const path = require("path");
-const os = require("os");
-
-const CREDENTIALS_DIR = path.join(os.homedir(), ".pan");
-const CREDENTIALS_FILE = path.join(CREDENTIALS_DIR, "credentials.json");
-
-// Fallback mặc định khi KHÔNG set env / KHÔNG khai trong .pan-env-build.yaml — trỏ về Pan Studio
-// backend dev trên OpenShift, để `pan ui` dùng được ngay không cần config gì thêm. Ưu tiên (cao
-// → thấp): process.env > .pan-env-build.yaml > default này.
-//
-// URL được XOR obfuscate (KHÔNG phải bảo mật thật — key nằm ngay trong file) — chỉ để tránh lộ
-// domain trần khi grep/quét source code tìm URL literal. Cần đổi URL mặc định? Sửa `_DEFAULT_URL`
-// (chuỗi thường) rồi chạy `node -e` bên dưới để sinh lại mảng byte, KHÔNG gõ tay mảng byte.
-//   node -e "const u='https://...';const K=0x2A;console.log(JSON.stringify([...u].map(c=>c.charCodeAt(0)^K)))"
-const _OBFUSCATE_KEY = 0x2a;
-const _DEFAULT_URL_BYTES = [
-  66, 94, 94, 90, 89, 16, 5, 5, 90, 75, 68, 7, 89, 94, 95, 78, 67, 69, 7, 75, 90, 67, 4, 78, 79, 92,
-  4, 73, 70, 95, 89, 94, 79, 88, 26, 24, 4, 76, 67, 89, 7, 73, 70, 69, 95, 78, 4, 82, 90, 70, 75, 94,
-  4, 69, 68, 70, 67, 68, 79,
-];
-function _deobfuscate(bytes, key) {
-  return bytes.map((b) => String.fromCharCode(b ^ key)).join("");
-}
-const DEFAULT_API_URL = _deobfuscate(_DEFAULT_URL_BYTES, _OBFUSCATE_KEY);
-const DEFAULT_WEB_URL = DEFAULT_API_URL;
-
-/**
- * Đọc "KEY: value" phẳng từ .pan-env-build.yaml (cùng quy ước với
- * lib/git/git-mr.js loadGitlabToken — KHÔNG phải YAML parser đầy đủ).
- * @param {string} envFile
- * @returns {Record<string,string>}
- */
-function readEnvFile(envFile) {
-  const result = {};
-  if (!fs.existsSync(envFile)) {
-    return result;
-  }
-  const content = fs.readFileSync(envFile, "utf8");
-  for (const rawLine of content.split(/\r?\n/)) {
-    let line = rawLine;
-    const commentIdx = line.indexOf("#");
-    if (commentIdx >= 0) {
-      line = line.slice(0, commentIdx);
-    }
-    line = line.trim();
-    if (!line) {
-      continue;
-    }
-    const idx = line.indexOf(":");
-    if (idx < 0) {
-      continue;
-    }
-    const key = line.slice(0, idx).trim();
-    let val = line.slice(idx + 1).trim();
-    if (
-      (val.startsWith('"') && val.endsWith('"')) ||
-      (val.startsWith("'") && val.endsWith("'"))
-    ) {
-      val = val.slice(1, -1);
-    }
-    if (key && val) {
-      result[key] = val;
-    }
-  }
-  return result;
-}
-
-/**
- * Đọc PAN_STUDIO_API_URL / PAN_STUDIO_WEB_URL. Ưu tiên (cao → thấp):
- *   1. process.env
- *   2. `<workspaceRoot>/.pan-env-build.yaml`
- *   3. DEFAULT_API_URL/DEFAULT_WEB_URL (Pan Studio backend dev — dùng được ngay, không cần config)
- * WEB_URL riêng thiếu ở cả 3 mức trên thì mặc định = API_URL đã resolve.
- * @param {string} workspaceRoot
- * @returns {{ apiUrl: string, webUrl: string }}
- */
-function getApiConfig(workspaceRoot) {
-  const envFile = path.join(workspaceRoot || process.cwd(), ".pan-env-build.yaml");
-  const fromFile = readEnvFile(envFile);
-
-  const apiUrl =
-    process.env.PAN_STUDIO_API_URL || fromFile.PAN_STUDIO_API_URL || DEFAULT_API_URL;
-  // WEB_URL riêng thiếu → mirror theo apiUrl ĐÃ RESOLVE (không nhảy thẳng DEFAULT_WEB_URL) — vd
-  // user chỉ set PAN_STUDIO_API_URL=http://localhost:3001 trong .pan-env-build.yaml thì WEB_URL
-  // phải là localhost:3001 luôn, không phải URL cluster dev mặc định.
-  const webUrl = process.env.PAN_STUDIO_WEB_URL || fromFile.PAN_STUDIO_WEB_URL || apiUrl;
-
-  return { apiUrl: apiUrl.replace(/\/+$/, ""), webUrl: webUrl.replace(/\/+$/, "") };
-}
-
-function readCredentialsStore() {
-  if (!fs.existsSync(CREDENTIALS_FILE)) {
-    return {};
-  }
-  try {
-    const raw = fs.readFileSync(CREDENTIALS_FILE, "utf8");
-    const parsed = JSON.parse(raw);
-    return parsed && typeof parsed === "object" ? parsed : {};
-  } catch {
-    return {};
-  }
-}
-
-function writeCredentialsStore(store) {
-  if (!fs.existsSync(CREDENTIALS_DIR)) {
-    fs.mkdirSync(CREDENTIALS_DIR, { recursive: true, mode: 0o700 });
-  }
-  fs.writeFileSync(CREDENTIALS_FILE, JSON.stringify(store, null, 2), {
-    mode: 0o600,
-  });
-  try {
-    fs.chmodSync(CREDENTIALS_FILE, 0o600);
-  } catch {
-    // best-effort trên hệ điều hành không hỗ trợ chmod (vd Windows)
-  }
-}
-
-/**
- * @param {string} apiUrl
- * @returns {{ token: string, tokenType: string, expiresAt: string, user: object, savedAt: string } | null}
- */
-function loadCredential(apiUrl) {
-  const store = readCredentialsStore();
-  return store[apiUrl] || null;
-}
-
-/**
- * @param {string} apiUrl
- * @param {{ token: string, tokenType?: string, expiresAt: string, user?: object }} cred
- */
-function saveCredential(apiUrl, cred) {
-  const store = readCredentialsStore();
-  store[apiUrl] = {
-    token: cred.token,
-    tokenType: cred.tokenType || "pmcp",
-    expiresAt: cred.expiresAt,
-    user: cred.user || null,
-    savedAt: new Date().toISOString(),
-  };
-  writeCredentialsStore(store);
-  return store[apiUrl];
-}
-
-/**
- * @param {string} apiUrl
- */
-function clearCredential(apiUrl) {
-  const store = readCredentialsStore();
-  if (apiUrl in store) {
-    delete store[apiUrl];
-    writeCredentialsStore(store);
-  }
-}
-
-/**
- * @param {{ expiresAt?: string } | null | undefined} cred
- * @returns {boolean}
- */
-function isExpired(cred) {
-  if (!cred || !cred.expiresAt) {
-    return true;
-  }
-  const expiresAt = Date.parse(cred.expiresAt);
-  if (Number.isNaN(expiresAt)) {
-    return true;
-  }
-  return expiresAt < Date.now();
-}
-
-module.exports = {
-  CREDENTIALS_FILE,
-  DEFAULT_API_URL,
-  DEFAULT_WEB_URL,
-  getApiConfig,
-  loadCredential,
-  saveCredential,
-  clearCredential,
-  isExpired,
-};

package/lib/ui/diff.js

@@ -1,128 +0,0 @@
-// lib/ui/diff.js — so sánh cây file local ↔ backend, dùng chung cho `sync` (§4.5) và
-// GATE của `published-html`/`gen-react-web-code` (§4.6). Không phụ thuộc lib khác ngoài
-// fs/path/crypto core.
-const fs = require("fs");
-const path = require("path");
-const crypto = require("crypto");
-
-const IGNORE_DIRS = new Set(["node_modules", ".git", "dist"]);
-
-/**
- * Quét đệ quy toàn bộ file (không giới hạn cấp — dùng cho 1 dự án panui, không phải
- * monorepo scan), bỏ node_modules/.git/dist.
- * @param {string} rootDir
- * @returns {Array<{ path: string, size: number, full: string }>}
- */
-function listLocalFiles(rootDir) {
-  const results = [];
-  function walk(dir) {
-    let entries;
-    try {
-      entries = fs.readdirSync(dir, { withFileTypes: true });
-    } catch {
-      return;
-    }
-    for (const entry of entries) {
-      if (entry.isDirectory()) {
-        if (IGNORE_DIRS.has(entry.name)) continue;
-        walk(path.join(dir, entry.name));
-        continue;
-      }
-      if (entry.isFile()) {
-        const full = path.join(dir, entry.name);
-        const rel = path.relative(rootDir, full).split(path.sep).join("/");
-        let stat;
-        try {
-          stat = fs.statSync(full);
-        } catch {
-          continue;
-        }
-        results.push({ path: rel, size: stat.size, full });
-      }
-    }
-  }
-  walk(rootDir);
-  return results;
-}
-
-function sha256(content) {
-  return crypto.createHash("sha256").update(content).digest("hex");
-}
-
-/**
- * So khớp local ↔ backend theo path tương đối. Sizes khác → changed ngay (rẻ).
- * Sizes bằng nhau (hoặc backend không có size) → nếu có `getBackendContent`, tải nội
- * dung backend và so hash để chắc chắn (chậm hơn nhưng chính xác — honest-TODO: gọi
- * 1 request/file, có thể chậm với dự án nhiều file bằng size nhau).
- * @param {string} localDir
- * @param {Array<{filePath?:string, path?:string, fileType?:string, fileSize?:number, size?:number}>} backendFiles
- * @param {(relPath:string)=>Promise<string>} [getBackendContent]
- * @returns {Promise<{ added: string[], changed: string[], removed: string[], unchanged: string[] }>}
- */
-async function computeDiff(localDir, backendFiles, getBackendContent) {
-  const local = listLocalFiles(localDir);
-  const localByPath = new Map(local.map((f) => [f.path, f]));
-
-  const backendList = (backendFiles || []).filter(
-    (f) => f.fileType !== "directory" && f.fileType !== "dir"
-  );
-  const backendByPath = new Map(
-    backendList.map((f) => [f.filePath || f.path, f])
-  );
-
-  const added = [];
-  const changed = [];
-  const removed = [];
-  const unchanged = [];
-
-  for (const [relPath, lf] of localByPath) {
-    const bf = backendByPath.get(relPath);
-    if (!bf) {
-      added.push(relPath);
-      continue;
-    }
-    const backendSize = bf.fileSize ?? bf.size;
-    if (typeof backendSize === "number" && backendSize !== lf.size) {
-      changed.push(relPath);
-      continue;
-    }
-    if (getBackendContent) {
-      try {
-        const backendContent = await getBackendContent(relPath);
-        const localContent = fs.readFileSync(lf.full, "utf8");
-        if (sha256(localContent) !== sha256(backendContent || "")) {
-          changed.push(relPath);
-          continue;
-        }
-      } catch {
-        // Không tải được nội dung backend để so — best-effort: coi như không đổi.
-      }
-    }
-    unchanged.push(relPath);
-  }
-
-  for (const relPath of backendByPath.keys()) {
-    if (!localByPath.has(relPath)) {
-      removed.push(relPath);
-    }
-  }
-
-  return { added, changed, removed, unchanged };
-}
-
-function isDiffClean(diff) {
-  return (
-    diff.added.length === 0 && diff.changed.length === 0 && diff.removed.length === 0
-  );
-}
-
-function printDiff(diff) {
-  for (const p of diff.added) console.log(`  + ${p}`);
-  for (const p of diff.changed) console.log(`  ~ ${p}`);
-  for (const p of diff.removed) console.log(`  - ${p}`);
-  console.log(
-    `Tổng: +${diff.added.length} thêm, ~${diff.changed.length} đổi, -${diff.removed.length} xóa, =${diff.unchanged.length} không đổi.`
-  );
-}
-
-module.exports = { listLocalFiles, computeDiff, isDiffClean, printDiff };