@jskit-ai/create-app 0.1.0 → 0.1.1

package/README.md

@@ -17,6 +17,8 @@ jskit-create-app --interactive
 - `--template <name>` template name under `templates/` (default `base-shell`)
 - `--title <text>` override the generated app title placeholder
 - `--target <path>` output directory (default `./<app-name>`)
+- `--initial-bundles <preset>` optional framework preset: `none`, `db`, or `db-auth`
+- `--db-provider <provider>` provider for `db` presets: `mysql` or `postgres`
 - `--force` allow writes into non-empty target directories
 - `--dry-run` preview writes only
 - `--interactive` prompt for app values

package/bin/jskit-create-app.js

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

package/package.json

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

package/src/{index.js → shared/index.js}

@@ -5,7 +5,12 @@ import { createInterface } from "node:readline/promises";
 import { fileURLToPath } from "node:url";
 
 const DEFAULT_TEMPLATE = "base-shell";
-const PACKAGE_ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
+const DEFAULT_INITIAL_BUNDLES = "none";
+const DEFAULT_DB_PROVIDER = "mysql";
+const INITIAL_BUNDLE_PRESETS = new Set(["none", "db", "db-auth"]);
+const DB_PROVIDERS = new Set(["mysql", "postgres"]);
+const ALLOWED_EXISTING_TARGET_ENTRIES = new Set([".git"]);
+const PACKAGE_ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "../..");
 const TEMPLATES_ROOT = path.join(PACKAGE_ROOT, "templates");
 
 function createCliError(message, { showUsage = false, exitCode = 1 } = {}) {
@@ -36,6 +41,53 @@ function toAppTitle(appName) {
   return words.length > 0 ? words.join(" ") : "App";
 }
 
+function normalizeInitialBundlesPreset(value, { showUsage = true } = {}) {
+  const normalized = String(value || DEFAULT_INITIAL_BUNDLES).trim().toLowerCase();
+  if (INITIAL_BUNDLE_PRESETS.has(normalized)) {
+    return normalized;
+  }
+
+  throw createCliError(
+    `Invalid --initial-bundles value "${value}". Expected one of: none, db, db-auth.`,
+    { showUsage }
+  );
+}
+
+function normalizeDbProvider(value, { showUsage = true } = {}) {
+  const normalized = String(value || DEFAULT_DB_PROVIDER).trim().toLowerCase();
+  if (DB_PROVIDERS.has(normalized)) {
+    return normalized;
+  }
+
+  throw createCliError(
+    `Invalid --db-provider value "${value}". Expected one of: mysql, postgres.`,
+    { showUsage }
+  );
+}
+
+function buildInitialBundleCommands(initialBundles, dbProvider) {
+  const normalizedPreset = normalizeInitialBundlesPreset(initialBundles, { showUsage: false });
+  const normalizedProvider = normalizeDbProvider(dbProvider, { showUsage: false });
+
+  const commands = [];
+  if (normalizedPreset === "db" || normalizedPreset === "db-auth") {
+    commands.push(`npx jskit add db --provider ${normalizedProvider} --no-install`);
+  }
+  if (normalizedPreset === "db-auth") {
+    commands.push("npx jskit add auth-base --no-install");
+  }
+
+  return commands;
+}
+
+function buildProgressiveBundleCommands(dbProvider) {
+  const normalizedProvider = normalizeDbProvider(dbProvider, { showUsage: false });
+  return [
+    `npx jskit add db --provider ${normalizedProvider} --no-install`,
+    "npx jskit add auth-base --no-install"
+  ];
+}
+
 function validateAppName(appName, { showUsage = true } = {}) {
   if (!appName || typeof appName !== "string") {
     throw createCliError("Missing app name.", { showUsage });
@@ -69,6 +121,8 @@ function parseCliArgs(argv) {
     appTitle: null,
     template: DEFAULT_TEMPLATE,
     target: null,
+    initialBundles: DEFAULT_INITIAL_BUNDLES,
+    dbProvider: DEFAULT_DB_PROVIDER,
     force: false,
     dryRun: false,
     help: false,
@@ -136,6 +190,30 @@ function parseCliArgs(argv) {
       continue;
     }
 
+    if (arg === "--initial-bundles") {
+      const { value, nextIndex } = parseOptionWithValue(args, index, "--initial-bundles");
+      options.initialBundles = value;
+      index = nextIndex;
+      continue;
+    }
+
+    if (arg.startsWith("--initial-bundles=")) {
+      options.initialBundles = arg.slice("--initial-bundles=".length);
+      continue;
+    }
+
+    if (arg === "--db-provider") {
+      const { value, nextIndex } = parseOptionWithValue(args, index, "--db-provider");
+      options.dbProvider = value;
+      index = nextIndex;
+      continue;
+    }
+
+    if (arg.startsWith("--db-provider=")) {
+      options.dbProvider = arg.slice("--db-provider=".length);
+      continue;
+    }
+
     if (arg.startsWith("-")) {
       throw createCliError(`Unknown option: ${arg}`, {
         showUsage: true
@@ -171,6 +249,8 @@ function printUsage(stream = process.stderr) {
   stream.write(`  --template <name>  Template folder under templates/ (default: ${DEFAULT_TEMPLATE})\n`);
   stream.write("  --title <text>     App title used for template replacements\n");
   stream.write("  --target <path>    Target directory (default: ./<app-name>)\n");
+  stream.write("  --initial-bundles <preset>  Optional bundle preset: none | db | db-auth (default: none)\n");
+  stream.write("  --db-provider <provider>    Database provider for db presets: mysql | postgres (default: mysql)\n");
   stream.write("  --force            Allow writing into a non-empty target directory\n");
   stream.write("  --dry-run          Print planned writes without changing the filesystem\n");
   stream.write("  --interactive      Prompt for app values instead of passing all flags\n");
@@ -233,7 +313,8 @@ async function ensureTargetDirectoryState(targetDirectory, { force = false, dryR
   }
 
   const entries = await readdir(targetDirectory);
-  if (entries.length > 0 && !force) {
+  const blockingEntries = entries.filter((entry) => !ALLOWED_EXISTING_TARGET_ENTRIES.has(entry));
+  if (blockingEntries.length > 0 && !force) {
     throw createCliError(
       `Target directory is not empty: ${targetDirectory}. Use --force to allow writing into it.`
     );
@@ -335,11 +416,24 @@ async function askYesNoQuestion(readline, label, defaultValue) {
   }
 }
 
-async function collectInteractiveOptions({ parsed, stdout = process.stdout, stderr = process.stderr, stdin = process.stdin }) {
-  const readline = createInterface({
+function createReadlineInterface({ stdin = process.stdin, stdout = process.stdout } = {}) {
+  return createInterface({
     input: stdin,
     output: stdout
   });
+}
+
+async function collectInteractiveOptions({
+  parsed,
+  stdout = process.stdout,
+  stderr = process.stderr,
+  stdin = process.stdin,
+  readlineFactory = createReadlineInterface
+}) {
+  const readline = readlineFactory({
+    stdin,
+    stdout
+  });
 
   try {
     let appName = String(parsed.appName || "").trim();
@@ -368,12 +462,42 @@ async function collectInteractiveOptions({ parsed, stdout = process.stdout, stde
       Boolean(parsed.force)
     );
 
+    let initialBundles = normalizeInitialBundlesPreset(parsed.initialBundles, { showUsage: false });
+    while (true) {
+      const candidate = await askQuestion(
+        readline,
+        "Initial bundle preset (none|db|db-auth)",
+        initialBundles
+      );
+      try {
+        initialBundles = normalizeInitialBundlesPreset(candidate, { showUsage: false });
+        break;
+      } catch (error) {
+        stderr.write(`Error: ${error?.message || String(error)}\n`);
+      }
+    }
+
+    let dbProvider = normalizeDbProvider(parsed.dbProvider, { showUsage: false });
+    if (initialBundles === "db" || initialBundles === "db-auth") {
+      while (true) {
+        const candidate = await askQuestion(readline, "DB provider (mysql|postgres)", dbProvider);
+        try {
+          dbProvider = normalizeDbProvider(candidate, { showUsage: false });
+          break;
+        } catch (error) {
+          stderr.write(`Error: ${error?.message || String(error)}\n`);
+        }
+      }
+    }
+
     return {
       appName,
       appTitle,
       target,
       template,
-      force
+      force,
+      initialBundles,
+      dbProvider
     };
   } finally {
     readline.close();
@@ -385,6 +509,8 @@ export async function createApp({
   appTitle = null,
   template = DEFAULT_TEMPLATE,
   target = null,
+  initialBundles = DEFAULT_INITIAL_BUNDLES,
+  dbProvider = DEFAULT_DB_PROVIDER,
   force = false,
   dryRun = false,
   cwd = process.cwd()
@@ -393,6 +519,8 @@ export async function createApp({
   validateAppName(resolvedAppName);
 
   const resolvedAppTitle = String(appTitle || "").trim() || toAppTitle(resolvedAppName);
+  const resolvedInitialBundles = normalizeInitialBundlesPreset(initialBundles);
+  const resolvedDbProvider = normalizeDbProvider(dbProvider);
 
   const resolvedCwd = path.resolve(cwd);
   const targetDirectory = path.resolve(resolvedCwd, target ? String(target) : resolvedAppName);
@@ -419,6 +547,10 @@ export async function createApp({
     appName: resolvedAppName,
     appTitle: resolvedAppTitle,
     template: String(template),
+    initialBundles: resolvedInitialBundles,
+    dbProvider: resolvedDbProvider,
+    selectedBundleCommands: buildInitialBundleCommands(resolvedInitialBundles, resolvedDbProvider),
+    progressiveBundleCommands: buildProgressiveBundleCommands(resolvedDbProvider),
     targetDirectory,
     dryRun,
     touchedFiles
@@ -431,7 +563,8 @@ export async function runCli(
     stdout = process.stdout,
     stderr = process.stderr,
     stdin = process.stdin,
-    cwd = process.cwd()
+    cwd = process.cwd(),
+    readlineFactory = createReadlineInterface
   } = {}
 ) {
   try {
@@ -449,7 +582,8 @@ export async function runCli(
             parsed,
             stdout,
             stderr,
-            stdin
+            stdin,
+            readlineFactory
           }))
         }
       : parsed;
@@ -459,6 +593,8 @@ export async function runCli(
       appTitle: resolvedOptions.appTitle,
       template: resolvedOptions.template,
       target: resolvedOptions.target,
+      initialBundles: resolvedOptions.initialBundles,
+      dbProvider: resolvedOptions.dbProvider,
       force: resolvedOptions.force,
       dryRun: resolvedOptions.dryRun,
       cwd
@@ -484,6 +620,19 @@ export async function runCli(
       stdout.write(`- cd ${shellQuote(targetLabel)}\n`);
       stdout.write("- npm install\n");
       stdout.write("- npm run dev\n");
+
+      stdout.write("\n");
+      if (result.selectedBundleCommands.length > 0) {
+        stdout.write(`Initial framework bundle commands (${result.initialBundles}):\n`);
+        for (const command of result.selectedBundleCommands) {
+          stdout.write(`- ${command}\n`);
+        }
+      } else {
+        stdout.write("Add framework capabilities when ready:\n");
+        for (const command of result.progressiveBundleCommands) {
+          stdout.write(`- ${command}\n`);
+        }
+      }
     }
 
     return 0;

package/templates/base-shell/Procfile

@@ -0,0 +1 @@
+web: npm run start

package/templates/base-shell/README.md

@@ -9,7 +9,6 @@ This is the smallest practical JSKIT app host:
 - tiny Fastify server (`/api/v1/health`)
 - tiny Vue client shell
 - standardized scripts via `@jskit-ai/app-scripts`
-- framework composition seed file: `framework/app.manifest.mjs`
 
 ## What This Is Not
 
@@ -31,3 +30,10 @@ npm run server
 npm run test
 npm run test:client
 ```
+
+## Progressive Bundles
+
+```bash
+npx jskit add db --provider mysql --no-install
+npx jskit add auth-base --no-install
+```

package/templates/base-shell/package.json

@@ -7,6 +7,9 @@
   "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",
@@ -25,6 +28,7 @@
   },
   "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",

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

@@ -2,7 +2,7 @@ import assert from "node:assert/strict";
 import test from "node:test";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
-import { readdir, readFile } from "node:fs/promises";
+import { access, readdir, readFile } from "node:fs/promises";
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
@@ -16,6 +16,7 @@ const EXPECTED_RUNTIME_DEPENDENCIES = Object.freeze([
 
 const EXPECTED_DEV_DEPENDENCIES = Object.freeze([
   "@jskit-ai/config-eslint",
+  "@jskit-ai/jskit",
   "@vitejs/plugin-vue",
   "eslint",
   "vite",
@@ -23,12 +24,12 @@ const EXPECTED_DEV_DEPENDENCIES = Object.freeze([
 ]);
 
 const EXPECTED_TOP_LEVEL_ENTRIES = Object.freeze([
+  "Procfile",
   "README.md",
   "app.scripts.config.mjs",
   "bin",
   "eslint.config.mjs",
   "favicon.svg",
-  "framework",
   "gitignore",
   "index.html",
   "package.json",
@@ -87,14 +88,6 @@ test("starter shell keeps a strict top-level footprint", async () => {
   assert.deepEqual(sortStrings(entries), sortStrings(EXPECTED_TOP_LEVEL_ENTRIES));
 });
 
-test("manifest scaffold exists with strict core-only defaults", async () => {
-  const manifestModule = await import(path.join(APP_ROOT, "framework/app.manifest.mjs"));
-  const manifest = manifestModule?.default;
-
-  assert.equal(manifest.manifestVersion, 1);
-  assert.equal(manifest.appId, "__APP_NAME__");
-  assert.equal(manifest.profileId, "web-saas-default");
-  assert.equal(manifest.mode, "strict");
-  assert.equal(manifest.enforceProfileRequired, true);
-  assert.deepEqual(manifest.optionalModulePacks, ["core"]);
+test("legacy app.manifest scaffold is removed from starter shell", async () => {
+  await assert.rejects(access(path.join(APP_ROOT, "framework/app.manifest.mjs")), /ENOENT/);
 });

package/templates/base-shell/framework/app.manifest.mjs

@@ -1,8 +0,0 @@
-export default Object.freeze({
-  manifestVersion: 1,
-  appId: "__APP_NAME__",
-  profileId: "web-saas-default",
-  mode: "strict",
-  enforceProfileRequired: true,
-  optionalModulePacks: ["core"]
-});