@swimmesberger/elarion-jsonrpc-client-generator 0.2.3-preview.68.1 → 0.2.3-preview.69.1

package/README.md

@@ -7,6 +7,12 @@ npm install --save-dev @swimmesberger/elarion-jsonrpc-client-generator
 npx elarion-jsonrpc-client-generator --schema rpc-schema.json --out src/generated
 ```
 
+Add `--watch` for a tight dev loop — the generator regenerates whenever `rpc-schema.json` changes (and survives the partial/invalid states a build tool leaves the file in mid-write). Pair it with a server that re-exports the schema on save (e.g. `dotnet watch`) so an edit to a handler flows straight to the typed client:
+
+```bash
+npx elarion-jsonrpc-client-generator --schema rpc-schema.json --out src/generated --watch
+```
+
 The generated files are:
 
 | File | Purpose |

package/dist/cli.js

@@ -1,7 +1,11 @@
 #!/usr/bin/env node
-import { mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { mkdirSync, readFileSync, watchFile, writeFileSync } from 'node:fs';
 import { basename, resolve } from 'node:path';
 import { generateRpcClientFiles } from './generate.js';
+// Poll interval for --watch. Polling (rather than fs.watch) is deliberate: the schema is (re)written by a
+// build tool, often via a temp-file + rename, which event-based watchers miss or double-fire; polling the
+// exact path is robust to that and to delete/recreate, at the cost of up-to-one-interval latency.
+const WATCH_INTERVAL_MS = 300;
 const SUPPORTED_FRAMEWORKS = ['tanstack-start'];
 function parseArgs(argv) {
     const options = {
@@ -15,6 +19,10 @@ function parseArgs(argv) {
             printHelp();
             process.exit(0);
         }
+        if (arg === '--watch') {
+            options.watch = true;
+            continue;
+        }
         if (!next) {
             throw new Error(`Missing value for ${arg}`);
         }
@@ -85,14 +93,34 @@ Options:
                           Supported: tanstack-start (needs the @tanstack/react-start peer dependency)
   --framework-adapter <file> Framework adapter filename (default: start-adapter.ts)
   --source-label <text> Source label written into generated file headers
+  --watch               Regenerate whenever the schema file changes (Ctrl+C to stop)
 `);
 }
-function main() {
-    const options = parseArgs(process.argv.slice(2));
+// Reads the schema and writes the generated files once. Returns false (without throwing) on a missing or
+// malformed schema so --watch can keep running across the transient states a build tool leaves the file in
+// mid-write, and so a one-shot run exits non-zero with a clean message instead of a stack trace.
+function generateOnce(options) {
     const schemaPath = resolve(process.cwd(), options.schemaPath);
     const outDir = resolve(process.cwd(), options.outDir);
-    const raw = readFileSync(schemaPath, 'utf-8');
-    const schema = JSON.parse(raw);
+    let raw;
+    try {
+        raw = readFileSync(schemaPath, 'utf-8');
+    }
+    catch (error) {
+        const code = error.code;
+        console.error(code === 'ENOENT'
+            ? `[jsonrpc-client-generator] Schema not found at ${schemaPath}`
+            : `[jsonrpc-client-generator] Cannot read ${schemaPath}: ${errorMessage(error)}`);
+        return false;
+    }
+    let schema;
+    try {
+        schema = JSON.parse(raw);
+    }
+    catch (error) {
+        console.error(`[jsonrpc-client-generator] Invalid JSON in ${schemaPath}: ${errorMessage(error)}`);
+        return false;
+    }
     const generated = generateRpcClientFiles(schema, {
         sourceLabel: options.sourceLabel ?? basename(schemaPath),
         typesFileName: options.typesFileName,
@@ -117,5 +145,32 @@ function main() {
     }
     const extraNote = extraNotes.length > 0 ? ` (+ ${extraNotes.join(', ')})` : '';
     console.log(`[jsonrpc-client-generator] Generated ${generated.methodCount} RPC method types and schemas${extraNote} -> ${outDir}`);
+    return true;
+}
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+function main() {
+    const options = parseArgs(process.argv.slice(2));
+    const ok = generateOnce(options);
+    if (!options.watch) {
+        if (!ok) {
+            process.exitCode = 1;
+        }
+        return;
+    }
+    const schemaPath = resolve(process.cwd(), options.schemaPath);
+    console.log(`[jsonrpc-client-generator] Watching ${schemaPath} for changes (Ctrl+C to stop)…`);
+    watchFile(schemaPath, { interval: WATCH_INTERVAL_MS }, (curr, prev) => {
+        // mtimeMs === 0 means the file does not currently exist (not yet written, or just deleted); wait for the
+        // next write rather than regenerating from a stale/absent file.
+        if (curr.mtimeMs === 0) {
+            return;
+        }
+        if (curr.mtimeMs === prev.mtimeMs && curr.size === prev.size) {
+            return;
+        }
+        generateOnce(options);
+    });
 }
 main();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@swimmesberger/elarion-jsonrpc-client-generator",
-  "version": "0.2.3-preview.68.1",
+  "version": "0.2.3-preview.69.1",
   "description": "Generate TypeScript RPC contracts, Zod schemas, and a fetch client from Elarion JSON-RPC schema exports.",
   "license": "Apache-2.0",
   "type": "module",