@yunsoft/yuncms 0.1.13 → 0.1.15

package/README.md

@@ -15,7 +15,9 @@ npx --yes @yunsoft/yuncms start
 
 `init` creates the project `.env`, asks for MySQL connection details, applies the required database migrations and creates the first Administrator account.
 
-The current directory is used as the YunCMS project directory, including local Files and local `extensions/`.
+The current directory is used as the YunCMS project directory. Initialization also creates an `uploads/` directory, a Plesk-compatible `start.js`, a 200-response health endpoint example under `extensions/health/`, and a minimal hook example under `extensions/example-hook/`. Existing project files are preserved and are not overwritten by the scaffold.
+
+The generated health extension is available at `/extensions/health`. The core `/health` and `/ready` routes remain unchanged.
 
 ## Persistent project dependency
 
@@ -30,6 +32,12 @@ npx yuncms start
 
 Once installed locally, `npx yuncms ...` resolves the project's pinned package version.
 
+For Plesk, install `@yunsoft/yuncms` locally and use the generated `start.js` as the application startup file. The same entry can be checked manually with:
+
+```bash
+node start.js
+```
+
 Production maintenance commands:
 
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yunsoft/yuncms",
-  "version": "0.1.13",
+  "version": "0.1.15",
   "description": "Command-line setup and runtime launcher for YunCMS.",
   "license": "MIT",
   "type": "module",
@@ -30,7 +30,7 @@
     "test": "node --test"
   },
   "dependencies": {
-    "@yunsoft/yuncms-api": "0.1.13",
-    "@yunsoft/yuncms-core": "0.1.13"
+    "@yunsoft/yuncms-api": "0.1.15",
+    "@yunsoft/yuncms-core": "0.1.15"
   }
 }

package/src/init-command.js

@@ -14,6 +14,7 @@ import {
 
 import { writeEnvFile } from './env-file.js';
 import { createInteractivePrompts } from './prompts.js';
+import { ensureProjectScaffold } from './project-scaffold.js';
 
 export async function collectEnvironment(prompts) {
   const DB_HOST = await prompts.line('MySQL host', { defaultValue: '127.0.0.1' });
@@ -29,6 +30,7 @@ export async function collectEnvironment(prompts) {
     PORT: String(DEFAULT_SERVER_PORT),
     STUDIO_ORIGIN: studioUrl,
     AUTH_PUBLIC_URL: studioUrl,
+    FILES_LOCAL_ROOT: 'uploads',
     DB_HOST,
     DB_PORT,
     DB_DATABASE,
@@ -61,6 +63,11 @@ export async function runInitCommand({
 } = {}) {
   const envPath = join(cwd, '.env');
   const workingEnv = { ...env };
+  const scaffold = await ensureProjectScaffold({ cwd });
+
+  if (scaffold.created.length > 0) {
+    output.log?.(`Created project scaffold: ${scaffold.created.join(', ')}`);
+  }
 
   if (!existsSync(envPath)) {
     output.log?.('YunCMS setup: database configuration');

package/src/process-runner.js

@@ -22,6 +22,13 @@ function positiveInteger(value, code, label, { max = Number.MAX_SAFE_INTEGER } =
   return parsed;
 }
 
+function resolveSpawnCommand(command, platform = process.platform) {
+  if (platform === 'win32' && (command === 'npm' || command === 'npx')) {
+    return `${command}.cmd`;
+  }
+  return command;
+}
+
 export function resolveCommandTimeoutMs(env = process.env, explicitTimeoutMs = null) {
   const value = explicitTimeoutMs ?? env.YUNCMS_CLI_COMMAND_TIMEOUT_MS ?? DEFAULT_COMMAND_TIMEOUT_MS;
   return positiveInteger(
@@ -57,6 +64,7 @@ function spawnCapturedProcess(spawnProcess, command, args, options) {
 export async function runCapturedProcess(command, args = [], {
   cwd = process.cwd(),
   env = process.env,
+  platform = process.platform,
   spawnProcess = spawn,
   maxOutputBytes = DEFAULT_MAX_OUTPUT_BYTES,
   timeoutMs = null,
@@ -75,10 +83,11 @@ export async function runCapturedProcess(command, args = [], {
     'Command output limit',
     { max: 16 * 1024 * 1024 },
   );
+  const resolvedCommand = resolveSpawnCommand(command, platform);
 
   const child = spawnCapturedProcess(
     spawnProcess,
-    command,
+    resolvedCommand,
     args,
     {
       cwd,
@@ -146,7 +155,7 @@ export async function runCapturedProcess(command, args = [], {
           return;
         }
         error.code ||= 'COMMAND_START_FAILED';
-        error.command = command;
+        error.command = resolvedCommand;
         error.args = [...args];
         reject(error);
       });

package/src/project-scaffold.js

@@ -0,0 +1,90 @@
+import { access, mkdir, writeFile } from 'node:fs/promises';
+import { constants as fsConstants } from 'node:fs';
+import { dirname, join } from 'node:path';
+
+const START_FILE = `// Plesk-compatible YunCMS startup file.\n// Install @yunsoft/yuncms locally, then configure Plesk to run: node start.js\nimport('@yunsoft/yuncms/src/runtime-entry.js').catch((error) => {\n  console.error('YunCMS failed to start', error);\n  process.exitCode = 1;\n});\n`;
+
+const HEALTH_PACKAGE = `${JSON.stringify({
+  name: 'yuncms-extension-health',
+  private: true,
+  type: 'module',
+  yuncms: {
+    id: 'health',
+    type: 'endpoint',
+    entry: './index.js',
+  },
+}, null, 2)}\n`;
+
+const HEALTH_EXTENSION = `export default Object.freeze({\n  __yuncms_extension__: true,\n  type: 'endpoint',\n  register(router) {\n    router.get('/', (_req, res) => {\n      res.status(200).json({ status: 'ok' });\n    });\n  },\n});\n`;
+
+const HOOK_PACKAGE = `${JSON.stringify({
+  name: 'yuncms-extension-example-hook',
+  private: true,
+  type: 'module',
+  yuncms: {
+    id: 'example-hook',
+    type: 'hook',
+    entry: './index.js',
+  },
+}, null, 2)}\n`;
+
+const HOOK_EXTENSION = `export default Object.freeze({\n  __yuncms_extension__: true,\n  type: 'hook',\n  register({ init }) {\n    init('app.afterStart', ({ logger }) => {\n      logger.info?.('YunCMS example hook: app.afterStart');\n    });\n  },\n});\n`;
+
+async function pathExists(path) {
+  try {
+    await access(path, fsConstants.F_OK);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+async function ensureDirectory(path, label, created) {
+  if (await pathExists(path)) return;
+  await mkdir(path, { recursive: true });
+  created.push(label);
+}
+
+async function writeIfMissing(path, content, label, created) {
+  if (await pathExists(path)) return;
+  await mkdir(dirname(path), { recursive: true });
+  await writeFile(path, content, 'utf8');
+  created.push(label);
+}
+
+export async function ensureProjectScaffold({ cwd = process.cwd() } = {}) {
+  const created = [];
+  const extensionsDir = join(cwd, 'extensions');
+  const uploadsDir = join(cwd, 'uploads');
+
+  await ensureDirectory(extensionsDir, 'extensions/', created);
+  await ensureDirectory(uploadsDir, 'uploads/', created);
+  await writeIfMissing(join(cwd, 'start.js'), START_FILE, 'start.js', created);
+
+  await writeIfMissing(
+    join(extensionsDir, 'health', 'package.json'),
+    HEALTH_PACKAGE,
+    'extensions/health/package.json',
+    created,
+  );
+  await writeIfMissing(
+    join(extensionsDir, 'health', 'index.js'),
+    HEALTH_EXTENSION,
+    'extensions/health/index.js',
+    created,
+  );
+  await writeIfMissing(
+    join(extensionsDir, 'example-hook', 'package.json'),
+    HOOK_PACKAGE,
+    'extensions/example-hook/package.json',
+    created,
+  );
+  await writeIfMissing(
+    join(extensionsDir, 'example-hook', 'index.js'),
+    HOOK_EXTENSION,
+    'extensions/example-hook/index.js',
+    created,
+  );
+
+  return Object.freeze({ created: Object.freeze(created) });
+}

package/src/runtime-entry.js

@@ -0,0 +1 @@
+import '@yunsoft/yuncms-api/server';