create-next-imagicma 0.1.9 → 0.1.10

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-next-imagicma",
-  "version": "0.1.9",
+  "version": "0.1.10",
   "type": "module",
   "bin": {
     "create-next-imagicma": "./bin/create-next-imagicma.mjs"

package/template-hono/server/index.ts

@@ -8,6 +8,11 @@ const LAUNCH_TOKEN_FILE = path.resolve(
   ".imagicma",
   "launch-token.json",
 );
+const RUNTIME_ENV_FILE = path.resolve(
+  process.cwd(),
+  ".imagicma",
+  "runtime.env",
+);
 
 function isScriptLaunch(mode: "dev" | "start") {
   return (
@@ -51,18 +56,47 @@ async function assertStartAuthorized() {
   );
 }
 
-function resolveRuntimePort(raw = process.env.PORT) {
-  if (raw === undefined || raw === null || raw === "") {
-    throw new Error("[imagicma] 缺少端口配置：请通过 PORT 提供运行时端口");
+async function readRuntimeEnvPort() {
+  try {
+    const raw = await fs.readFile(RUNTIME_ENV_FILE, "utf8");
+    const lines = raw.split(/\r?\n/);
+    for (const line of lines) {
+      const trimmed = line.trim();
+      if (!trimmed || trimmed.startsWith("#")) continue;
+      const separatorIndex = trimmed.indexOf("=");
+      if (separatorIndex <= 0) continue;
+      const key = trimmed.slice(0, separatorIndex).trim();
+      if (key !== "PORT") continue;
+      return trimmed.slice(separatorIndex + 1).trim();
+    }
+  } catch (error) {
+    if (error && typeof error === "object" && "code" in error && error.code === "ENOENT") {
+      return null;
+    }
+    throw error;
+  }
+
+  return null;
+}
+
+async function resolveRuntimePort(raw = process.env.PORT) {
+  let candidate = raw;
+  if (candidate === undefined || candidate === null || candidate === "") {
+    candidate = await readRuntimeEnvPort();
+  }
+
+  if (candidate === undefined || candidate === null || candidate === "") {
+    throw new Error("[imagicma] 缺少端口配置：请通过 .imagicma/runtime.env 或 PORT 提供运行时端口");
   }
 
-  const port = Number(raw);
+  const port = Number(candidate);
   if (!Number.isInteger(port) || port < 1 || port > 65535) {
     throw new Error(
-      `[imagicma] 无效端口配置：PORT=${JSON.stringify(raw)}（期望 1-65535 的整数）`,
+      `[imagicma] 无效端口配置：PORT=${JSON.stringify(candidate)}（期望 1-65535 的整数）`,
     );
   }
 
+  process.env.PORT = String(port);
   return port;
 }
 
@@ -70,7 +104,7 @@ async function main() {
   await assertStartAuthorized();
 
   const app = createApp({ serveClient: true });
-  const port = resolveRuntimePort();
+  const port = await resolveRuntimePort();
 
   serve(
     {

package/template-hono/vite.config.ts

@@ -14,6 +14,11 @@ const LAUNCH_TOKEN_FILE = path.resolve(
   ".imagicma",
   "launch-token.json",
 );
+const RUNTIME_ENV_FILE = path.resolve(
+  __dirname,
+  ".imagicma",
+  "runtime.env",
+);
 
 function isScriptLaunch(mode: "dev" | "start") {
   return (
@@ -22,18 +27,47 @@ function isScriptLaunch(mode: "dev" | "start") {
   );
 }
 
-function resolveRuntimePort(raw = process.env.PORT) {
-  if (raw === undefined || raw === null || raw === "") {
-    throw new Error("[imagicma] 缺少端口配置：请通过 PORT 提供运行时端口");
+async function readRuntimeEnvPort() {
+  try {
+    const raw = await fs.readFile(RUNTIME_ENV_FILE, "utf8");
+    const lines = raw.split(/\r?\n/);
+    for (const line of lines) {
+      const trimmed = line.trim();
+      if (!trimmed || trimmed.startsWith("#")) continue;
+      const separatorIndex = trimmed.indexOf("=");
+      if (separatorIndex <= 0) continue;
+      const key = trimmed.slice(0, separatorIndex).trim();
+      if (key !== "PORT") continue;
+      return trimmed.slice(separatorIndex + 1).trim();
+    }
+  } catch (error) {
+    if (error && typeof error === "object" && "code" in error && error.code === "ENOENT") {
+      return null;
+    }
+    throw error;
+  }
+
+  return null;
+}
+
+async function resolveRuntimePort(raw = process.env.PORT) {
+  let candidate = raw;
+  if (candidate === undefined || candidate === null || candidate === "") {
+    candidate = await readRuntimeEnvPort();
+  }
+
+  if (candidate === undefined || candidate === null || candidate === "") {
+    throw new Error("[imagicma] 缺少端口配置：请通过 .imagicma/runtime.env 或 PORT 提供运行时端口");
   }
 
-  const port = Number(raw);
+  const port = Number(candidate);
   if (!Number.isInteger(port) || port < 1 || port > 65535) {
     throw new Error(
-      `[imagicma] 无效端口配置：PORT=${JSON.stringify(raw)}（期望 1-65535 的整数）`,
+      `[imagicma] 无效端口配置：PORT=${JSON.stringify(candidate)}（期望 1-65535 的整数）`,
     );
   }
 
+  process.env.PORT = String(port);
   return port;
 }
 
@@ -73,7 +107,7 @@ async function assertLaunchAuthorized(mode: "dev" | "start") {
 }
 
 export default defineConfig(async ({ command }) => {
-  const runtimePort = command === "serve" ? resolveRuntimePort() : null;
+  const runtimePort = command === "serve" ? await resolveRuntimePort() : null;
   const enableComponentDebugger = command === "serve";
   const componentDebugger =
     enableComponentDebugger