@jskit-ai/create-app 0.1.65 → 0.1.67

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jskit-ai/create-app",
-  "version": "0.1.65",
+  "version": "0.1.67",
   "description": "Scaffold minimal JSKIT app shells.",
   "type": "module",
   "files": [

package/templates/base-shell/packages/main/package.descriptor.mjs

@@ -3,7 +3,7 @@ export default Object.freeze({
   packageId: "@local/main",
   version: "0.1.0",
   kind: "runtime",
-  description: "App-local main module scaffold.",
+  description: "App-local main composition and glue scaffold.",
   dependsOn: [],
   capabilities: {
     provides: [],
@@ -12,13 +12,11 @@ export default Object.freeze({
   options: {},
   runtime: {
     server: {
-      providerEntrypoint: "src/server/index.js",
+      providerEntrypoint: "src/server/MainServiceProvider.js",
       providers: [
         {
-          discover: {
-            dir: "src/server/providers",
-            pattern: "*Provider.js"
-          }
+          entrypoint: "src/server/MainServiceProvider.js",
+          export: "MainServiceProvider"
         }
       ]
     },
@@ -32,6 +30,21 @@ export default Object.freeze({
     }
   },
   metadata: {
+    jskit: {
+      ownershipGuidance: {
+        title: "App-local main lane",
+        summary: "Keep @local/main focused on app composition and lightweight glue. Substantial server features should become dedicated packages instead of growing inside packages/main.",
+        responsibilities: [
+          "packages/main server code: bootstraps app-local configuration and lightweight wiring only",
+          "substantial non-CRUD server features: scaffold a dedicated package with feature-server-generator",
+          "packages/main: do not add service/controller/route/repository feature trees here"
+        ],
+        examples: [
+          "jskit generate feature-server-generator scaffold booking-engine",
+          "jskit generate feature-server-generator scaffold availability-engine --mode orchestrator"
+        ]
+      }
+    },
     server: {
       routes: []
     },

package/templates/base-shell/packages/main/package.json

@@ -6,7 +6,7 @@
   "exports": {
     "./client": "./src/client/index.js",
     "./server": "./src/server/index.js",
-    "./server/providers/MainServiceProvider": "./src/server/providers/MainServiceProvider.js",
+    "./server/MainServiceProvider": "./src/server/MainServiceProvider.js",
     "./shared": "./src/shared/index.js"
   }
 }

package/templates/base-shell/packages/main/src/server/MainServiceProvider.js

@@ -0,0 +1,20 @@
+import { loadAppConfig } from "./loadAppConfig.js";
+
+class MainServiceProvider {
+  static id = "local.main";
+
+  // Register only lightweight app-local composition bindings here.
+  async register(app) {
+    const appConfig = await loadAppConfig({
+      moduleUrl: import.meta.url
+    });
+    app.instance("appConfig", appConfig);
+  }
+
+  // Keep packages/main as app glue only.
+  // When backend behavior becomes substantial, scaffold a dedicated package:
+  //   jskit generate feature-server-generator scaffold <feature-name>
+  boot() {}
+}
+
+export { MainServiceProvider };

package/templates/base-shell/packages/main/src/server/index.js

@@ -1 +1 @@
-export { MainServiceProvider } from "./providers/MainServiceProvider.js";
+export { MainServiceProvider } from "./MainServiceProvider.js";

package/templates/base-shell/packages/main/src/shared/index.js

@@ -1,6 +1,8 @@
 /**
  * Shared entrypoint for code used by both client and server.
  *
+ * Keep this for genuinely app-local shared glue only.
+ *
  * Example:
  * export * from "./schemas/index.js";
  * export * from "./constants/index.js";

package/templates/base-shell/packages/main/src/shared/schemas/index.js

@@ -1,5 +1,6 @@
 /**
- * Shared transport validators/resources live here.
+ * App-local shared transport validators/resources live here.
+ * Dedicated feature packages should keep their own schemas with the feature.
  *
  * Example:
  * import { createSchema } from "json-rest-schema";

package/templates/base-shell/server.js

@@ -83,7 +83,14 @@ function canServeStaticFile(distRoot, relativePath) {
 }
 
 async function createServer() {
-  const app = Fastify({ logger: true });
+  const app = Fastify({
+    logger: true,
+    ajv: {
+      customOptions: {
+        allowUnionTypes: true
+      }
+    }
+  });
 
   app.get("/api/health", async () => {
     return {

package/templates/base-shell/packages/main/src/server/controllers/index.js

@@ -1,9 +0,0 @@
-/**
- * Server controller exports.
- *
- * Controllers adapt HTTP requests to service calls.
- *
- * Example:
- * export { MainHelloController } from "./MainHelloController.js";
- */
-export {};

package/templates/base-shell/packages/main/src/server/providers/MainServiceProvider.js

@@ -1,22 +0,0 @@
-import { loadAppConfig } from "../support/loadAppConfig.js";
-
-class MainServiceProvider {
-  static id = "local.main";
-
-  // Optional: register container bindings here (services/singletons).
-  async register(app) {
-    const appConfig = await loadAppConfig({
-      moduleUrl: import.meta.url
-    });
-    app.instance("appConfig", appConfig);
-  }
-
-  // Start backend features here:
-  // 1) define shared validators/resources in `src/shared/schemas`
-  // 2) resolve router with `app.make("jskit.http.router")`
-  // 3) register routes and handlers
-  // 4) extract to services/controllers/routes as the feature grows
-  boot() {}
-}
-
-export { MainServiceProvider };

package/templates/base-shell/packages/main/src/server/routes/index.js

@@ -1,9 +0,0 @@
-/**
- * Server route definition exports.
- *
- * Route builders define HTTP method/path/schema/handler wiring.
- *
- * Example:
- * export { buildMainRoutes } from "./mainRoutes.js";
- */
-export {};

package/templates/base-shell/packages/main/src/server/services/index.js

@@ -1,9 +0,0 @@
-/**
- * Server service exports.
- *
- * Services hold domain logic and are called by controllers.
- *
- * Example:
- * export { MainHelloService } from "./MainHelloService.js";
- */
-export {};