@fecommunity/reactpress 4.0.0-beta.11 → 4.0.0-beta.13

package/out/lib/i18n/strings.js

@@ -70,6 +70,12 @@ const STRINGS = {
         'cli.help.nginx': '  reactpress nginx up          Start reverse proxy (:80)',
         'cli.status.description': 'Project, API, frontend, and Docker status',
         'cli.doctor.description': 'Diagnose Node, Docker, ports, database, and API health',
+        'cli.doctor.showLogs': 'Show recent API error logs after diagnostics',
+        'cli.doctor.logs.description': 'View recent API logs (error, request, response)',
+        'cli.doctor.logs.tailOption': 'Number of lines to show per log file',
+        'cli.doctor.logs.sourceOption': 'Log source: error, request, response, or all',
+        'cli.doctor.logs.grepOption': 'Filter log lines by regex',
+        'cli.doctor.logs.listOption': 'List available log files only',
         'cli.db.description': 'Database operations',
         'cli.db.backup': 'Backup current project database with mysqldump',
         'cli.db.backup.output': 'Output SQL file path',
@@ -78,8 +84,9 @@ const STRINGS = {
         'cli.publish.publish': 'Publish core packages to npm',
         'cli.start.description': 'Start ReactPress (SQLite API + admin + theme)',
         'cli.help.examples': 'Usage:',
-        'cli.help.init': '  reactpress init              Initialize (default)',
+        'cli.help.init': '  reactpress init [dir]        Initialize project',
         'cli.help.doctor': '  reactpress doctor            Diagnose environment issues',
+        'cli.help.doctorLogs': '  reactpress doctor logs       Tail API logs for quick debugging',
         'cli.help.zeroDep': '  Zero deps: Node.js 18+ only — no Docker, nginx, or MySQL',
         'cli.plugin.description': 'Manage ReactPress plugins',
         'cli.plugin.install.description': 'Install a local plugin into .reactpress/plugins',
@@ -408,6 +415,20 @@ const STRINGS = {
         'doctor.checking': 'Checking {name}…',
         'doctor.summary': '{passed} passed  ·  {failed} failed  ·  {total} total',
         'doctor.fixesHeader': 'Suggested fixes',
+        'doctor.logsHint': 'Tip: run reactpress doctor logs --tail 100 to inspect API error logs',
+        'doctor.logs.title': 'ReactPress Doctor · Logs',
+        'doctor.logs.subtitle': 'API log viewer',
+        'doctor.logs.dir': 'Log dir   {path}',
+        'doctor.logs.empty': 'No API log files found yet.',
+        'doctor.logs.emptyHint': 'Start the API with reactpress init — logs are written to .reactpress/logs/server/',
+        'doctor.logs.listHeader': 'Available log files',
+        'doctor.logs.fileHeader': '{file} (showing {count} line(s))',
+        'doctor.logs.noMatchingLines': 'No matching log lines.',
+        'doctor.logs.badPattern': 'Invalid grep pattern: {pattern}',
+        'doctor.logs.noPid': 'No API pid file at {path}',
+        'doctor.logs.pidRunning': 'API pid {pid} (recorded in {path})',
+        'doctor.logs.pidStale': 'Stale pid {pid} in {path} — process not running',
+        'doctor.logs.moreHint': 'Use --tail, --source, --grep, or --list for more control (see reactpress doctor logs --help)',
         'status.title': 'ReactPress project status',
         'status.dir': 'Project     {path}',
         'status.apiSource': 'API source  {source}',
@@ -703,6 +724,12 @@ const STRINGS = {
         'cli.help.nginx': '  reactpress nginx up          启动反向代理 (:80)',
         'cli.status.description': '查看项目、API、前端、Docker 综合状态',
         'cli.doctor.description': '诊断环境：Node、Docker、端口、数据库、API 健康',
+        'cli.doctor.showLogs': '诊断结束后显示最近的 API 错误日志',
+        'cli.doctor.logs.description': '查看 API 日志（error / request / response）',
+        'cli.doctor.logs.tailOption': '每个日志文件显示的行数',
+        'cli.doctor.logs.sourceOption': '日志类型：error、request、response 或 all',
+        'cli.doctor.logs.grepOption': '用正则过滤日志行',
+        'cli.doctor.logs.listOption': '仅列出可用日志文件',
         'cli.db.description': '数据库运维',
         'cli.db.backup': '使用 mysqldump 备份当前项目数据库',
         'cli.db.backup.output': '输出 SQL 文件路径',
@@ -711,8 +738,9 @@ const STRINGS = {
         'cli.publish.publish': '发布核心 npm 包',
         'cli.start.description': '启动 ReactPress（SQLite API + 管理后台 + 主题）',
         'cli.help.examples': '用法:',
-        'cli.help.init': '  reactpress init              初始化（默认命令）',
+        'cli.help.init': '  reactpress init [dir]        初始化项目',
         'cli.help.doctor': '  reactpress doctor            诊断环境问题',
+        'cli.help.doctorLogs': '  reactpress doctor logs       查看 API 日志，快速定位问题',
         'cli.help.zeroDep': '  零依赖：仅需 Node.js 18+，无需 Docker、nginx 或 MySQL',
         'cli.plugin.description': '管理 ReactPress 插件',
         'cli.plugin.install.description': '安装本地插件到 .reactpress/plugins',
@@ -1040,6 +1068,20 @@ const STRINGS = {
         'doctor.checking': '正在检查 {name}…',
         'doctor.summary': '通过 {passed}  ·  失败 {failed}  ·  共 {total} 项',
         'doctor.fixesHeader': '修复建议',
+        'doctor.logsHint': '提示：运行 reactpress doctor logs --tail 100 查看 API 错误日志',
+        'doctor.logs.title': 'ReactPress Doctor · 日志',
+        'doctor.logs.subtitle': 'API 日志查看',
+        'doctor.logs.dir': '日志目录  {path}',
+        'doctor.logs.empty': '尚未找到 API 日志文件。',
+        'doctor.logs.emptyHint': '运行 reactpress init 启动 API 后，日志会写入 .reactpress/logs/server/',
+        'doctor.logs.listHeader': '可用日志文件',
+        'doctor.logs.fileHeader': '{file}（显示 {count} 行）',
+        'doctor.logs.noMatchingLines': '没有匹配的日志行。',
+        'doctor.logs.badPattern': 'grep 正则无效：{pattern}',
+        'doctor.logs.noPid': '未找到 API pid 文件：{path}',
+        'doctor.logs.pidRunning': 'API 进程 pid {pid}（记录在 {path}）',
+        'doctor.logs.pidStale': 'pid 文件 {path} 中的 {pid} 已失效（进程未运行）',
+        'doctor.logs.moreHint': '可用 --tail、--source、--grep、--list 进一步筛选（见 reactpress doctor logs --help）',
         'status.title': 'ReactPress 项目状态',
         'status.dir': '项目目录    {path}',
         'status.apiSource': 'API 来源    {source}',

package/out/lib/lifecycle.js

@@ -1,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 // @ts-nocheck
+const fs = require('fs');
+const path = require('path');
 const { spawn } = require('child_process');
 const ora = require('ora');
 const { ensureProjectEnvironment } = require('./bootstrap');
@@ -92,6 +94,8 @@ async function startApi(projectRoot, { wait = true } = {}) {
     else {
         console.log(t('lifecycle.startingBundledApi'));
     }
+    const serverLogDir = path.join(projectRoot, '.reactpress', 'logs', 'server');
+    fs.mkdirSync(serverLogDir, { recursive: true });
     const child = spawn(process.execPath, [getServerBin(projectRoot)], {
         cwd: getServerDir(projectRoot),
         detached: true,
@@ -99,6 +103,7 @@ async function startApi(projectRoot, { wait = true } = {}) {
         env: {
             ...process.env,
             REACTPRESS_ORIGINAL_CWD: projectRoot,
+            REACTPRESS_SERVER_LOG_DIR: serverLogDir,
         },
     });
     child.unref();

package/out/lib/project-logs.js

@@ -0,0 +1,197 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+// @ts-nocheck
+const fs = require('fs');
+const path = require('path');
+const { brand, divider, gradientText, palette, sectionHeader } = require('../ui/theme');
+const { getServerDir, getPidFile } = require('./paths');
+const { readPid, isProcessRunning } = require('./process');
+const { t } = require('./i18n');
+const LOG_SOURCES = ['error', 'request', 'response'];
+function getProjectServerLogDir(projectRoot) {
+    const preferred = path.join(projectRoot, '.reactpress', 'logs', 'server');
+    if (fs.existsSync(preferred)) {
+        return preferred;
+    }
+    const bundled = path.join(getServerDir(projectRoot), 'logs');
+    if (fs.existsSync(bundled)) {
+        return bundled;
+    }
+    return preferred;
+}
+function normalizeSource(source) {
+    const value = String(source || 'error').toLowerCase();
+    if (value === 'all')
+        return 'all';
+    if (LOG_SOURCES.includes(value))
+        return value;
+    return 'error';
+}
+function listLogFiles(logDir, source = 'error') {
+    const normalized = normalizeSource(source);
+    const sources = normalized === 'all' ? LOG_SOURCES : [normalized];
+    const files = [];
+    for (const name of sources) {
+        const dir = path.join(logDir, name);
+        if (!fs.existsSync(dir))
+            continue;
+        for (const entry of fs.readdirSync(dir)) {
+            if (!entry.endsWith('.log'))
+                continue;
+            const fullPath = path.join(dir, entry);
+            let stat;
+            try {
+                stat = fs.statSync(fullPath);
+            }
+            catch {
+                continue;
+            }
+            if (!stat.isFile())
+                continue;
+            files.push({
+                source: name,
+                path: fullPath,
+                name: entry,
+                mtimeMs: stat.mtimeMs,
+                size: stat.size,
+            });
+        }
+    }
+    files.sort((a, b) => b.mtimeMs - a.mtimeMs);
+    return files;
+}
+function readTailLines(filePath, lineCount = 50) {
+    const maxLines = Math.max(1, Math.min(Number(lineCount) || 50, 5000));
+    let content;
+    try {
+        content = fs.readFileSync(filePath, 'utf8');
+    }
+    catch {
+        return [];
+    }
+    if (!content)
+        return [];
+    const lines = content.split(/\r?\n/);
+    if (lines.length && lines[lines.length - 1] === '') {
+        lines.pop();
+    }
+    if (lines.length <= maxLines)
+        return lines;
+    return lines.slice(-maxLines);
+}
+function filterLines(lines, pattern) {
+    if (!pattern)
+        return lines;
+    let re;
+    try {
+        re = new RegExp(pattern, 'i');
+    }
+    catch {
+        const err = new Error(t('doctor.logs.badPattern', { pattern }));
+        err.code = 'REACTPRESS_LOG_BAD_PATTERN';
+        throw err;
+    }
+    return lines.filter((line) => re.test(line));
+}
+function formatBytes(size) {
+    if (size < 1024)
+        return `${size} B`;
+    if (size < 1024 * 1024)
+        return `${(size / 1024).toFixed(1)} KB`;
+    return `${(size / (1024 * 1024)).toFixed(1)} MB`;
+}
+function formatTimestamp(ms) {
+    return new Date(ms).toISOString().replace('T', ' ').slice(0, 19);
+}
+function printProcessHint(projectRoot) {
+    const pid = readPid(projectRoot);
+    const pidFile = getPidFile(projectRoot);
+    if (!pid) {
+        console.log(`  ${brand.dim(t('doctor.logs.noPid', { path: pidFile }))}`);
+        return;
+    }
+    const alive = isProcessRunning(pid);
+    console.log(`  ${brand.dim(alive
+        ? t('doctor.logs.pidRunning', { pid, path: pidFile })
+        : t('doctor.logs.pidStale', { pid, path: pidFile }))}`);
+}
+async function runDoctorLogs(projectRoot, options = {}) {
+    const tail = Math.max(1, Math.min(parseInt(String(options.tail ?? '50'), 10) || 50, 5000));
+    const source = normalizeSource(options.source);
+    const logDir = getProjectServerLogDir(projectRoot);
+    const files = listLogFiles(logDir, source);
+    const w = 56;
+    console.log('');
+    console.log(`  ${gradientText(t('doctor.logs.title'), [palette.primary, palette.accent], { bold: true })}  ${brand.dim(t('doctor.logs.subtitle'))}`);
+    console.log(`  ${brand.dim(t('doctor.project', { path: projectRoot }))}`);
+    console.log(`  ${brand.dim(t('doctor.logs.dir', { path: logDir }))}`);
+    printProcessHint(projectRoot);
+    console.log(`  ${divider(w)}`);
+    if (options.list) {
+        if (!files.length) {
+            console.log(`  ${brand.warn(t('doctor.logs.empty'))}`);
+            console.log(`  ${brand.dim(t('doctor.logs.emptyHint'))}`);
+            console.log('');
+            return 1;
+        }
+        console.log(sectionHeader(t('doctor.logs.listHeader')));
+        for (const file of files) {
+            const rel = path.join(file.source, file.name);
+            console.log(`    ${brand.primary(rel)}  ${brand.dim(`${formatBytes(file.size)}  ${formatTimestamp(file.mtimeMs)}`)}`);
+        }
+        console.log('');
+        return 0;
+    }
+    if (!files.length) {
+        console.log(`  ${brand.warn(t('doctor.logs.empty'))}`);
+        console.log(`  ${brand.dim(t('doctor.logs.emptyHint'))}`);
+        console.log('');
+        return 1;
+    }
+    const grouped = new Map();
+    for (const file of files) {
+        if (!grouped.has(file.source))
+            grouped.set(file.source, file);
+    }
+    let printed = 0;
+    for (const name of source === 'all' ? LOG_SOURCES : [source]) {
+        const file = grouped.get(name);
+        if (!file)
+            continue;
+        let lines = readTailLines(file.path, tail);
+        lines = filterLines(lines, options.grep);
+        const rel = path.join(file.source, file.name);
+        console.log('');
+        console.log(sectionHeader(t('doctor.logs.fileHeader', {
+            file: rel,
+            count: lines.length,
+        })));
+        if (!lines.length) {
+            console.log(`    ${brand.dim(t('doctor.logs.noMatchingLines'))}`);
+            continue;
+        }
+        for (const line of lines) {
+            const isError = /\[ERROR\]/i.test(line) || name === 'error';
+            console.log(`    ${isError ? brand.warn(line) : brand.dim(line)}`);
+        }
+        printed += lines.length;
+    }
+    if (!printed) {
+        console.log(`  ${brand.warn(t('doctor.logs.noMatchingLines'))}`);
+        console.log('');
+        return 1;
+    }
+    console.log('');
+    console.log(`  ${brand.dim(t('doctor.logs.moreHint'))}`);
+    console.log('');
+    return 0;
+}
+module.exports = {
+    LOG_SOURCES,
+    getProjectServerLogDir,
+    listLogFiles,
+    readTailLines,
+    filterLines,
+    runDoctorLogs,
+};
+//# sourceMappingURL=project-logs.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fecommunity/reactpress",
-  "version": "4.0.0-beta.11",
+  "version": "4.0.0-beta.13",
   "description": "ReactPress 4 — zero-dependency publishing platform. Commands: reactpress init, reactpress doctor",
   "author": "fecommunity",
   "license": "MIT",
@@ -29,6 +29,7 @@
     "dist",
     "server",
     "toolkit",
+    "admin-dist",
     "templates",
     "scripts/install-bundled-runtime.mjs",
     "README.md",

package/server/dist/modules/extension/extension.module.js

@@ -27,7 +27,9 @@ let ExtensionModule = class ExtensionModule {
         this.pluginLoader = pluginLoader;
     }
     onModuleInit() {
-        void this.themeService.ensureDefaultTheme();
+        void this.themeService.ensureDefaultTheme().catch((err) => {
+            console.warn('[ThemeService] ensureDefaultTheme skipped:', err instanceof Error ? err.message : err);
+        });
         void this.pluginLoader.loadActivePlugins();
     }
 };

package/server/dist/modules/extension/theme-registry.bridge.js

@@ -5,11 +5,33 @@ const fs = require("fs");
 const path = require("path");
 const project_root_util_1 = require("../../utils/project-root.util");
 let cached = null;
+function resolveBundledCliPackageRoot() {
+    const serverRoot = path.join(__dirname, '..', '..', '..');
+    const cliRoot = path.dirname(serverRoot);
+    const registryPath = path.join(cliRoot, 'out', 'lib', 'theme-registry.js');
+    if (fs.existsSync(registryPath)) {
+        return cliRoot;
+    }
+    try {
+        const pkgPath = path.join(cliRoot, 'package.json');
+        if (!fs.existsSync(pkgPath))
+            return null;
+        const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
+        if (pkg.name === '@fecommunity/reactpress') {
+            return cliRoot;
+        }
+    }
+    catch (_a) {
+    }
+    return null;
+}
 function resolveThemeRegistryPath(monorepoRoot) {
+    const bundledCliRoot = resolveBundledCliPackageRoot();
     const candidates = [
+        bundledCliRoot ? path.join(bundledCliRoot, 'out', 'lib', 'theme-registry.js') : null,
         path.join(monorepoRoot, 'cli', 'out', 'lib', 'theme-registry.js'),
         path.join(monorepoRoot, 'cli', 'lib', 'theme-registry.js'),
-    ];
+    ].filter(Boolean);
     for (const candidate of candidates) {
         if (fs.existsSync(candidate))
             return candidate;

package/server/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "@fecommunity/reactpress-server",
-  "version": "4.0.0-beta.10",
+  "version": "4.0.0-beta.13",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@fecommunity/reactpress-server",
-      "version": "4.0.0-beta.10",
+      "version": "4.0.0-beta.13",
       "deprecated": "Use the built-in API in @fecommunity/reactpress (CLI). Standalone server publishing stopped from 3.1.",
       "license": "MIT",
       "dependencies": {
@@ -47,8 +47,6 @@
         "passport": "^0.4.1",
         "passport-jwt": "^4.0.0",
         "pm2": "^5.2.0",
-        "react": "^19.2.7",
-        "react-dom": "^19.2.7",
         "reflect-metadata": "^0.1.13",
         "rimraf": "^3.0.0",
         "rxjs": "^6.5.3",
@@ -93,7 +91,7 @@
     },
     "../toolkit": {
       "name": "@fecommunity/reactpress-toolkit",
-      "version": "4.0.0-beta.10",
+      "version": "4.0.0-beta.13",
       "dependencies": {
         "ajv": "^8.17.1",
         "axios": "^1.12.2",
@@ -15827,27 +15825,6 @@
         "node": ">=0.10.0"
       }
     },
-    "node_modules/react": {
-      "version": "19.2.7",
-      "resolved": "https://registry.npmjs.org/react/-/react-19.2.7.tgz",
-      "integrity": "sha512-HNe9WslTbXmFK8o8cmwgAeJFSBvt1bPdHCVKtaaV+WlAN36mpT4hcRpwbf3fY56ar2oIXzsBpOAiIRHAdY0OlQ==",
-      "license": "MIT",
-      "engines": {
-        "node": ">=0.10.0"
-      }
-    },
-    "node_modules/react-dom": {
-      "version": "19.2.7",
-      "resolved": "https://registry.npmjs.org/react-dom/-/react-dom-19.2.7.tgz",
-      "integrity": "sha512-t0BRVXvbiE/o20Hfw669rLbMCDWtYZLvmJigy2f0MxsXF+71pxhR3xOkspmsO8h3ZlNzyibAmtCa3l4lYKk6gQ==",
-      "license": "MIT",
-      "dependencies": {
-        "scheduler": "^0.27.0"
-      },
-      "peerDependencies": {
-        "react": "^19.2.7"
-      }
-    },
     "node_modules/react-is": {
       "version": "16.13.1",
       "resolved": "https://registry.npmjs.org/react-is/-/react-is-16.13.1.tgz",
@@ -16762,12 +16739,6 @@
         "node": ">=11.0.0"
       }
     },
-    "node_modules/scheduler": {
-      "version": "0.27.0",
-      "resolved": "https://registry.npmjs.org/scheduler/-/scheduler-0.27.0.tgz",
-      "integrity": "sha512-eNv+WrVbKu1f3vbYJT/xtiF5syA5HPIMtf9IgY/nKg0sWqzAUEvqY/xm7OcZc/qafLx/iO9FgOmeSAp4v5ti/Q==",
-      "license": "MIT"
-    },
     "node_modules/schema-utils": {
       "version": "1.0.0",
       "resolved": "https://registry.npmjs.org/schema-utils/-/schema-utils-1.0.0.tgz",

package/server/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fecommunity/reactpress-server",
-  "version": "4.0.0-beta.11",
+  "version": "4.0.0-beta.13",
   "deprecated": "Use the built-in API in @fecommunity/reactpress (CLI). Standalone server publishing stopped from 3.1.",
   "description": "ReactPress NestJS CMS API — headless REST for the publishing platform (MySQL or SQLite)",
   "author": "fecommunity",

package/toolkit/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fecommunity/reactpress-toolkit",
-  "version": "4.0.0-beta.11",
+  "version": "4.0.0-beta.13",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "exports": {