@svgrid/studio 0.4.0 → 0.6.0

package/dist/cli.js

@@ -14,7 +14,7 @@ import { mkdir, readFile, writeFile } from 'node:fs/promises';
 import { spawnSync } from 'node:child_process';
 import { createInterface } from 'node:readline/promises';
 import { dirname, resolve } from 'node:path';
-import { buildStudioBugReport, createProject, deployCommands, emitStudioAppBundle, emitStudioFragment, introspectDatabase, introspectOpenApi, runtimeDeps, listDatabaseTables, missingEnvKeys, parseProject, resolveDeployTarget, resolveSchemas, runStudioAdd, runStudioAddApp, runStudioInit, serializeProject, setEntityDataSource, summarizeVerify, } from '@svgrid/enterprise/studio';
+import { buildStudioBugReport, createProject, deployCommands, emitStudioAppBundle, emitStudioFragment, introspectDatabase, introspectOpenApi, isUserError, runtimeDeps, listDatabaseTables, missingEnvKeys, parseProject, resolveDeployTarget, resolveSchemas, runStudioAdd, runStudioAddApp, runStudioInit, sampleApps, serializeProject, setEntityDataSource, summarizeVerify, UserError, } from '@svgrid/enterprise/studio';
 import { connect } from './db-connect.js';
 import { ensureDriverInstalled } from './driver-install.js';
 import { startDesignerServer } from './designer-server.js';
@@ -36,56 +36,73 @@ const io = {
 function parse(args) {
     const out = {};
     const positional = [];
-    for (let i = 0; i < args.length; i++) {
+    /**
+     * Read the value that follows a flag. A missing or flag-shaped value used to
+     * come back as `undefined` and read as "not passed", so `--url` at the end of
+     * the line silently fell through to a different code path instead of saying
+     * what was wrong.
+     */
+    let i = 0;
+    const value = (flag) => {
+        const next = args[i + 1];
+        if (next === undefined || next.startsWith('-')) {
+            throw new UserError(`${flag} needs a value.`, 'Run `svgrid-studio --help` to see what each flag expects.');
+        }
+        i++;
+        return next;
+    };
+    for (i = 0; i < args.length; i++) {
         const a = args[i];
         if (a === '--from')
-            out.from = args[++i];
+            out.from = value(a);
         else if (a === '--table')
-            out.table = args[++i];
+            out.table = value(a);
         else if (a === '--route')
-            out.route = args[++i];
+            out.route = value(a);
         else if (a === '--api')
-            out.apiRoute = args[++i];
+            out.apiRoute = value(a);
         else if (a === '--sql')
             out.dataSource = 'sql';
         else if (a === '--db')
-            out.db = args[++i];
+            out.db = value(a);
         else if (a === '--url')
-            out.url = args[++i];
+            out.url = value(a);
         else if (a === '--all')
             out.all = true;
         else if (a === '--config')
-            out.config = args[++i];
+            out.config = value(a);
         else if (a === '--out')
-            out.outDir = args[++i];
+            out.outDir = value(a);
         else if (a === '--port')
-            out.port = Number(args[++i]);
+            out.port = Number(value(a));
         else if (a === '--template')
-            out.template = args[++i];
+            out.template = value(a);
         else if (a === '--no-open')
             out.noOpen = true;
         else if (a === '--target')
-            out.target = args[++i];
+            out.target = value(a);
         else if (a === '--dry-run')
             out.dryRun = true;
         else if (a === '--ai')
             out.ai = true;
         else if (a === '--app-port')
-            out.appPort = Number(args[++i]);
+            out.appPort = Number(value(a));
         else if (a === '--fragment')
             out.fragment = true;
         else if (a === '--supabase-url')
-            out.supabaseUrl = args[++i];
+            out.supabaseUrl = value(a);
         else if (a === '--supabase-key')
-            out.supabaseKey = args[++i];
+            out.supabaseKey = value(a);
         else if (a === '--dataset')
-            out.dataset = args[++i];
+            out.dataset = value(a);
         else if (a === '--theme')
-            out.theme = args[++i];
+            out.theme = value(a);
         else if (a === '--dark')
             out.dark = true;
         else if (a === '--title')
-            out.title = args[++i];
+            out.title = value(a);
+        else if (a === '-f' || a === '--force')
+            out.force = true;
         else if (a === '-y' || a === '--yes')
             out.yes = true;
         else if (a === '-h' || a === '--help')
@@ -100,6 +117,28 @@ function parse(args) {
         out.table = name;
     return out;
 }
+/**
+ * Every sample id, wrapped so the help stays readable. Built from the registry
+ * rather than a hand-kept list: a new sample used to be invisible here until
+ * someone remembered to update the sentence.
+ */
+function templateIds(width = 62) {
+    const lines = [];
+    let line = '';
+    for (const id of sampleApps.map((s) => s.id)) {
+        const next = line ? `${line} | ${id}` : id;
+        if (next.length > width) {
+            lines.push(line);
+            line = id;
+        }
+        else {
+            line = next;
+        }
+    }
+    if (line)
+        lines.push(line);
+    return lines.join('\n                   ');
+}
 const HELP = `svgrid-studio - scaffold CRUD screens from a schema file or a live database
 
 Usage:
@@ -126,6 +165,7 @@ Running \`svgrid-studio\` with no arguments starts it too.
   --out <dir>      folder to write the app into (default: .)
   --theme <id>     design-system preset      --dark   dark mode
   -y, --yes        take every default, ask nothing
+  -f, --force      write into a folder that already holds another app
 
 Deploy (build first, then the provider CLI; target from --target, else
 studio.config.json, else the adapter in svelte.config.js):
@@ -133,7 +173,8 @@ studio.config.json, else the adapter in svelte.config.js):
   --dry-run        print the resolved commands without running anything
 
 Designer (visual app builder, auto-saves to studio.config.json):
-  --template <id>  open a ready-made sample app (crm | ecommerce | projects | support)
+  --template <id>  open a ready-made sample app:
+                   ${templateIds()}
   --config <path>  studio.config.json to load + auto-save (default: ./studio.config.json)
   --out <dir>      folder to write the generated app into (default: .)
   --port <n>       port to serve on (default: 4321)
@@ -255,6 +296,7 @@ async function main() {
             ...(opts.dark ? { dark: true } : {}),
             ...(opts.title ? { title: opts.title } : {}),
             ...(opts.yes ? { yes: true } : {}),
+            ...(opts.force ? { force: true } : {}),
         });
         return;
     }
@@ -494,6 +536,14 @@ async function writeCrashReport(err) {
 }
 main().catch(async (err) => {
     process.stderr.write(`svgrid-studio: ${err instanceof Error ? err.message : String(err)}\n`);
+    // A mistyped connection string is not a bug. Only real crashes earn a report -
+    // otherwise ordinary fat-fingering ends with "report this on GitHub", which
+    // teaches people to distrust the message and file noise.
+    if (isUserError(err)) {
+        if (err.hint)
+            process.stderr.write(`  ${err.hint}\n`);
+        process.exit(1);
+    }
     try {
         await writeCrashReport(err);
     }

package/package.json

@@ -4,7 +4,7 @@
     "type": "commercial",
     "url": "https://svgrid.com/pricing"
   },
-  "version": "0.4.0",
+  "version": "0.6.0",
   "description": "SvGrid Studio CLI: scaffold a full CRUD screen (grid + edit panel + SvelteKit API route) from a Drizzle schema in one command.",
   "license": "SEE LICENSE IN LICENSE",
   "author": "jQWidgets <sales@jqwidgets.com>",
@@ -27,7 +27,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@svgrid/enterprise": "^2.4.0"
+    "@svgrid/enterprise": "^2.6.1"
   },
   "devDependencies": {
     "@types/node": "^22.10.7",