@jskit-ai/create-app 0.1.1 → 0.1.2

package/bin/jskit-create-app.js

@@ -1,8 +1,5 @@
 #!/usr/bin/env node
-import process from "node:process";
+import { runCliEntrypoint } from "../src/shared/cliEntrypoint.js";
 import { runCli } from "../src/shared/index.js";
 
-const exitCode = await runCli(process.argv.slice(2));
-if (exitCode !== 0) {
-  process.exit(exitCode);
-}
+await runCliEntrypoint(runCli);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jskit-ai/create-app",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "Scaffold minimal JSKIT app shells.",
   "type": "module",
   "files": [
@@ -18,6 +18,7 @@
   "exports": {
     ".": "./src/shared/index.js"
   },
+  "dependencies": {},
   "engines": {
     "node": "20.x"
   },

package/src/shared/cliEntrypoint.js

@@ -0,0 +1,25 @@
+import process from "node:process";
+
+function shellQuote(value) {
+  const raw = String(value ?? "");
+  if (!raw) {
+    return "''";
+  }
+  if (/^[A-Za-z0-9_./:=+,-]+$/.test(raw)) {
+    return raw;
+  }
+  return `'${raw.replace(/'/g, "'\\''")}'`;
+}
+
+async function runCliEntrypoint(runCli, argv = process.argv.slice(2)) {
+  if (typeof runCli !== "function") {
+    throw new TypeError("runCliEntrypoint requires a runCli function");
+  }
+
+  const exitCode = await runCli(argv);
+  if (exitCode !== 0) {
+    process.exit(exitCode);
+  }
+}
+
+export { shellQuote, runCliEntrypoint };

package/src/shared/index.js

@@ -3,6 +3,7 @@ import path from "node:path";
 import process from "node:process";
 import { createInterface } from "node:readline/promises";
 import { fileURLToPath } from "node:url";
+import { shellQuote } from "./cliEntrypoint.js";
 
 const DEFAULT_TEMPLATE = "base-shell";
 const DEFAULT_INITIAL_BUNDLES = "none";
@@ -20,17 +21,6 @@ function createCliError(message, { showUsage = false, exitCode = 1 } = {}) {
   return error;
 }
 
-function shellQuote(value) {
-  const raw = String(value ?? "");
-  if (!raw) {
-    return "''";
-  }
-  if (/^[A-Za-z0-9_./:=+,-]+$/.test(raw)) {
-    return raw;
-  }
-  return `'${raw.replace(/'/g, "'\\''")}'`;
-}
-
 function toAppTitle(appName) {
   const words = String(appName)
     .trim()

package/templates/base-shell/package.json

@@ -23,6 +23,8 @@
   },
   "dependencies": {
     "@jskit-ai/app-scripts": "0.1.0",
+    "@jskit-ai/server-runtime-core": "file:node_modules/@jskit-ai/jskit/packages/runtime/server-runtime-core",
+    "@jskit-ai/surface-routing": "file:node_modules/@jskit-ai/jskit/packages/surface-routing",  
     "fastify": "^5.7.4",
     "vue": "^3.5.13"
   },

package/templates/base-shell/package.json.ACTUAL_CORRECT

@@ -0,0 +1,38 @@
+{
+  "name": "__APP_NAME__",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "description": "Minimal JSKIT base app (Fastify + Vue)",
+  "engines": {
+    "node": "20.x"
+  },
+  "bin": {
+    "jskit": "node_modules/@jskit-ai/jskit/packages/tooling/jskit/bin/jskit.js"
+  },
+  "scripts": {
+    "server": "jskit-app-scripts server",
+    "start": "jskit-app-scripts start",
+    "dev": "jskit-app-scripts dev",
+    "build": "jskit-app-scripts build",
+    "preview": "jskit-app-scripts preview",
+    "lint": "jskit-app-scripts lint",
+    "lint:process-env": "jskit-app-scripts lint:process-env",
+    "test": "jskit-app-scripts test",
+    "test:client": "jskit-app-scripts test:client"
+  },
+  "dependencies": {
+    "@jskit-ai/app-scripts": "0.1.0",
+    "@jskit-ai/server-runtime-core": "file:node_modules/@jskit-ai/jskit/packages/runtime/server-runtime-core",
+    "fastify": "^5.7.4",
+    "vue": "^3.5.13"
+  },
+  "devDependencies": {
+    "@jskit-ai/config-eslint": "0.1.0",
+    "@jskit-ai/jskit": "github:mobily-enterprises/jskit-ai",
+    "@vitejs/plugin-vue": "^5.2.1",
+    "eslint": "^9.39.1",
+    "vite": "^6.1.0",
+    "vitest": "^4.0.18"
+  }
+}

package/templates/base-shell/server.js

@@ -1,15 +1,87 @@
 import Fastify from "fastify";
 import { resolveRuntimeEnv } from "./server/lib/runtimeEnv.js";
+import { registerApiRouteDefinitions } from "@jskit-ai/server-runtime-core/apiRouteRegistration";
+import { createServerRuntimeFromApp, applyContributedRuntimeLifecycle } from "@jskit-ai/server-runtime-core/serverContributions";
+import path from "node:path";
 
-function createServer() {
-  const app = Fastify({ logger: true });
-
+function registerFallbackHealthRoute(app) {
   app.get("/api/v1/health", async () => {
     return {
       ok: true,
       app: "__APP_NAME__"
     };
   });
+}
+
+async function registerContributedRuntime(app, { appRoot, runtimeEnv }) {
+  try {
+    const composed = await createServerRuntimeFromApp({
+      appRoot,
+      strict: false,
+      dependencies: {
+        env: runtimeEnv,
+        logger: app.log
+      },
+      routeConfig: {}
+    });
+
+    const routeCount = Array.isArray(composed.routes) ? composed.routes.length : 0;
+    if (routeCount > 0) {
+      registerApiRouteDefinitions(app, {
+        routes: composed.routes
+      });
+    }
+
+    const lifecycleResult = await applyContributedRuntimeLifecycle({
+      app,
+      runtimeResult: composed,
+      dependencies: {
+        env: runtimeEnv,
+        logger: app.log
+      }
+    });
+
+    app.log.info(
+      {
+        routeCount,
+        pluginCount: lifecycleResult.pluginCount,
+        workerCount: lifecycleResult.workerCount,
+        onBootCount: lifecycleResult.onBootCount,
+        packageOrder: composed.packageOrder
+      },
+      "Registered JSKIT contributed server runtime."
+    );
+
+    return {
+      enabled: true,
+      routeCount,
+      pluginCount: lifecycleResult.pluginCount,
+      workerCount: lifecycleResult.workerCount,
+      onBootCount: lifecycleResult.onBootCount
+    };
+  } catch (error) {
+    const message = String(error?.message || "");
+    if (message.includes("Lock file not found:")) {
+      return {
+        enabled: false,
+        routeCount: 0
+      };
+    }
+    throw error;
+  }
+}
+
+async function createServer() {
+  const app = Fastify({ logger: true });
+  const runtimeEnv = resolveRuntimeEnv();
+  const appRoot = path.resolve(process.cwd());
+  const contributed = await registerContributedRuntime(app, {
+    appRoot,
+    runtimeEnv
+  });
+  if (!contributed.enabled || contributed.routeCount < 1) {
+    registerFallbackHealthRoute(app);
+  }
 
   return app;
 }
@@ -18,7 +90,7 @@ async function startServer(options = {}) {
   const runtimeEnv = resolveRuntimeEnv();
   const port = Number(options?.port) || runtimeEnv.PORT;
   const host = String(options?.host || "").trim() || runtimeEnv.HOST;
-  const app = createServer();
+  const app = await createServer();
   await app.listen({ port, host });
   return app;
 }

package/templates/base-shell/src/App.vue

@@ -0,0 +1,24 @@
+<script setup>
+import { onMounted, ref } from "vue";
+
+const appTitle = "__APP_TITLE__";
+const health = ref("loading...");
+
+onMounted(async () => {
+  try {
+    const response = await fetch("/api/v1/health");
+    const payload = await response.json();
+    health.value = payload?.ok ? "ok" : "unhealthy";
+  } catch {
+    health.value = "unreachable";
+  }
+});
+</script>
+
+<template>
+  <main style="font-family: sans-serif; max-width: 48rem; margin: 3rem auto; padding: 0 1rem;">
+    <h1>{{ appTitle }}</h1>
+    <p>Minimal starter shell is running.</p>
+    <p><strong>Health:</strong> {{ health }}</p>
+  </main>
+</template>

package/templates/base-shell/src/main.js

@@ -1,30 +1,4 @@
-import { createApp, onMounted, ref } from "vue";
-
-const App = {
-  setup() {
-    const health = ref("loading...");
-
-    onMounted(async () => {
-      try {
-        const response = await fetch("/api/v1/health");
-        const payload = await response.json();
-        health.value = payload?.ok ? "ok" : "unhealthy";
-      } catch {
-        health.value = "unreachable";
-      }
-    });
-
-    return {
-      health
-    };
-  },
-  template: `
-    <main style="font-family: sans-serif; max-width: 48rem; margin: 3rem auto; padding: 0 1rem;">
-      <h1>__APP_TITLE__</h1>
-      <p>Minimal starter shell is running.</p>
-      <p><strong>Health:</strong> {{ health }}</p>
-    </main>
-  `
-};
+import { createApp } from "vue";
+import App from "./App.vue";
 
 createApp(App).mount("#app");

package/templates/base-shell/tests/server/minimalShell.contract.test.js

@@ -10,6 +10,7 @@ const APP_ROOT = path.resolve(__dirname, "../..");
 
 const EXPECTED_RUNTIME_DEPENDENCIES = Object.freeze([
   "@jskit-ai/app-scripts",
+  "@jskit-ai/server-runtime-core",
   "fastify",
   "vue"
 ]);
@@ -33,11 +34,13 @@ const EXPECTED_TOP_LEVEL_ENTRIES = Object.freeze([
   "gitignore",
   "index.html",
   "package.json",
+  "package.json.ACTUAL_CORRECT",
   "server.js",
   "server",
   "src",
   "tests",
-  "vite.config.mjs"
+  "vite.config.mjs",
+  "vite.shared.mjs"
 ]);
 
 async function readPackageJson() {

package/templates/base-shell/tests/server/smoke.test.js

@@ -3,7 +3,7 @@ import test from "node:test";
 import { createServer } from "../../server.js";
 
 test("GET /api/v1/health returns ok payload", async () => {
-  const app = createServer();
+  const app = await createServer();
   const response = await app.inject({
     method: "GET",
     url: "/api/v1/health"

package/templates/base-shell/vite.config.mjs

@@ -1,19 +1,33 @@
 import { defineConfig } from "vite";
 import vue from "@vitejs/plugin-vue";
-
-function toPositiveInt(value, fallback) {
-  const parsed = Number.parseInt(String(value || "").trim(), 10);
-  if (Number.isInteger(parsed) && parsed > 0) {
-    return parsed;
-  }
-  return fallback;
-}
+import { toPositiveInt } from "./vite.shared.mjs";
 
 const devPort = toPositiveInt(process.env.VITE_DEV_PORT, 5173);
 const apiProxyTarget = String(process.env.VITE_API_PROXY_TARGET || "").trim() || "http://localhost:3000";
+const clientEntry = (() => {
+  const normalized = String(process.env.VITE_CLIENT_ENTRY || "").trim();
+  if (!normalized) {
+    return "/src/main.js";
+  }
+  if (normalized.startsWith("/")) {
+    return normalized;
+  }
+  if (normalized.startsWith("src/")) {
+    return `/${normalized}`;
+  }
+  return `/src/${normalized}`;
+})();
 
 export default defineConfig({
-  plugins: [vue()],
+  plugins: [
+    vue(),
+    {
+      name: "jskit-client-entry",
+      transformIndexHtml(source) {
+        return String(source || "").replace(/\/src\/main\.js/g, clientEntry);
+      }
+    }
+  ],
   test: {
     include: ["tests/client/**/*.vitest.js"]
   },

package/templates/base-shell/vite.shared.mjs

@@ -0,0 +1,9 @@
+function toPositiveInt(value, fallback) {
+  const parsed = Number.parseInt(String(value || "").trim(), 10);
+  if (Number.isInteger(parsed) && parsed > 0) {
+    return parsed;
+  }
+  return fallback;
+}
+
+export { toPositiveInt };