@voxgig/create-sdkgen 0.1.2 → 0.3.0

package/bin/create-sdkgen

@@ -74,6 +74,8 @@ function generate(options) {
     target: options.target,
     feature: options.feature,
   }
+
+  // console.log('OPTIONS', options)
   
   createSdkGen.generate(spec)
 }

package/bin/create-sdkgen~

@@ -0,0 +1,261 @@
+#!/usr/bin/env node
+
+const Path = require('node:path')
+const { statSync } = require('node:fs')
+const { parseArgs } = require('node:util')
+
+const { Gubu, Fault, One } = require('gubu')
+
+const Pkg = require('../package.json')
+
+const { CreateSdkGen } = require('../dist/create-sdkgen.js') 
+
+const rootpath = require.resolve('../dist/standard/Root')
+
+let KONSOLE = global['con'+'sole']
+
+
+run()
+
+
+async function run() {
+  try {
+    let options = resolveOptions()
+
+    if(options.debug) {
+      DEBUG = true
+    }
+
+    if(options.version) {
+      version()
+    }
+
+    if(options.help) {
+      help()
+    }
+
+    if(options.version || options.help) {
+      exit()
+    }
+
+    options = validateOptions(options)
+
+    generate(options)
+  }
+  catch(err) {
+    handleError(err)
+  }
+}
+
+
+function exit(err) {
+  let code = 0
+  if(err) {
+    code = 1
+  }
+  process.exit(code)
+}
+
+
+function generate(options) {
+  const createSdkGen = CreateSdkGen({
+    debug: options.debug
+  })
+
+
+  const spec = {
+    root: 'Root',
+
+    name: options.name,
+    def: options.def,
+    dryrun: options.dryrun,
+    project: options.project,
+    install: options.install,
+    target: options.target,
+    feature: options.feature,
+  }
+  
+  createSdkGen.generate(spec)
+}
+
+
+
+function resolveOptions() {
+
+  let args
+
+  try {
+    args = parseArgs({
+      allowPositionals: true,
+      allowNegative: true,
+      options: {
+        def: {
+          type: 'string',
+          short: 'd',
+          default: ''
+        },
+
+        project: {
+          type: 'string',
+          short: 'p',
+          default: 'standard'
+        },
+
+        dryrun: {
+          type: 'boolean',
+          short: 'y',
+        },
+
+        install: {
+          type: 'boolean',
+          short: 'y',
+          default: true,
+        },
+
+        target: {
+          type: 'string',
+          short: 't',
+          multiple: true
+        },
+
+        feature: {
+          type: 'string',
+          short: 'f',
+          multiple: true
+        },
+
+        debug: {
+          type: 'string',
+          short: 'g',
+          default: 'info'
+        },
+        
+        help: {
+          type: 'boolean',
+          short: 'h',
+        },
+        
+        version: {
+          type: 'boolean',
+          short: 'v',
+        },
+        
+      }
+    })
+  }
+  catch(err) {
+    if('ERR_PARSE_ARGS_UNKNOWN_OPTION' === err.code) {
+      handleError(err.message.replace(/\. .+$/,'.'))
+    }
+    throw err
+  }
+
+  // Set fake name if -v or -h used.
+  let name = args.positionals[0]
+  name = null == name ? '' : name
+  name = '' === name && (args.values.help || args.values.version) ? '__none__' : name
+
+  targets = args.values.target || []
+  if( 1 < args.positionals.length ) {
+    targets.push(args.positionals.slice(1))
+  }
+
+  features = args.values.feature || []
+  
+  const options = {
+    name,
+    def: args.values.def,
+    project: args.values.project,
+    dryrun: !!args.values.dryrun,
+    install: !!args.values.install,
+    target: targets,
+    feature: features,
+    debug: args.values.debug,
+    help: !!args.values.help,
+    version: !!args.values.version,
+  }
+
+  // console.log('ARGS', args, options)
+  
+  return options
+}
+
+
+function validateOptions(rawOptions) {
+  const optShape = Gubu({
+    name: Fault('The first argument must be the project name.', String),
+    def: '',
+    project: String,
+    dryrun: Boolean,
+    install: Boolean,
+    target: [String],
+    feature: [String],
+    debug: String,
+    help: Boolean,
+    version: Boolean,
+  })
+
+  const err = []
+  const options = optShape(rawOptions,{err})
+
+  if(err[0]) {
+    handleError(err[0].text)
+  }
+
+  return options
+}
+
+
+function handleError(err) {
+  KONSOLE.log('Voxgig Create SDK Error: '+err)
+  exit(err)
+}
+
+
+function version() {
+  KONSOLE.log(Pkg.version)
+}
+
+
+function help() {
+  let s = `
+Create a Voxgig SDK Generator project.
+
+Usage: npm create @voxgig/sdkgen@latest <name> <args> 
+
+  <name> is the name of the SDK project. This is also used to
+    create a project folder. If run against an existing folder
+    generated files will be overwritten.
+
+  <args> are the command arguments:
+
+    --def        Path to the OpenAPI definition file (optional).
+    -d            
+
+    --project    Project template (folder or package reference). Default: standard.
+    -p            
+
+    --dryrun     Perform a dry run, where no files are modified.
+    -y
+
+    --debug      Set log level (default: info): trace, error, debug, info, warn, fatal.
+    -g             
+
+    --help       Print this help message.
+    -h
+
+    --version    Print version number.
+    -v
+
+
+Examples:
+
+# Basic usage
+> npm create @voxgig/sdkgen@latest foo
+# Creates the SDK Project in the folder ./foo
+
+See also: https://voxgig.com/sdkgen
+`
+
+  KONSOLE.log(s)
+}

package/dist/create-sdkgen.js

@@ -45,14 +45,22 @@ const JostracaModule = __importStar(require("jostraca"));
 const util_1 = require("@voxgig/util");
 const package_json_1 = __importDefault(require("../package.json"));
 const { names, Jostraca } = JostracaModule;
+// TODO: CreateSdkGen opts and generate opts should be mostly the same, and
+// generate should override
 function CreateSdkGen(opts) {
     const fs = opts.fs || Fs;
+    const debug = opts.debug;
     const pino = (0, util_1.prettyPino)('create', opts);
     const log = pino.child({ cmp: 'create' });
     const jostraca = Jostraca();
     async function generate(spec) {
         const start = Date.now();
-        log.info({ point: 'generate-start', start, note: spec.project });
+        let dryrun = !!spec.dryrun;
+        log.info({
+            point: 'generate-start',
+            start,
+            note: spec.project + (dryrun ? ' ** DRY RUN **' : '')
+        });
         log.debug({ point: 'generate-spec', spec, note: JSON.stringify(spec, null, 2) });
         const projectFolder = resolveProjectFolder(spec);
         const rootPath = node_path_1.default.join(projectFolder, spec.root);
@@ -63,6 +71,7 @@ function CreateSdkGen(opts) {
         const folder = node_path_1.default.join(process.cwd(), name + (name.endsWith('-sdk') ? '' : '-sdk'));
         const jopts = {
             fs: () => fs,
+            debug,
             folder,
             log: log.child({ cmp: 'jostraca' }),
             meta: { spec },
@@ -72,7 +81,7 @@ function CreateSdkGen(opts) {
                 }
             },
             control: {
-                dryrun: spec.dryrun
+                dryrun,
             }
         };
         const model = {
@@ -84,11 +93,17 @@ function CreateSdkGen(opts) {
         };
         names(model, model.name);
         names(model, model.name, 'project_name');
-        log.debug({ point: 'generate-model', model, note: JSON.stringify(model, null, 2) });
+        log.debug({
+            point: 'generate-jostraca',
+            jostraca: jopts,
+            note: JSON.stringify(jopts, null, 2)
+        });
         const jres = await jostraca.generate(jopts, () => Root({ model, spec }));
-        // logfiles(jres, log)
         (0, util_1.showChanges)(jopts.log, 'generate-result', jres, node_path_1.default.dirname(process.cwd()));
-        if (!spec.dryrun && spec.install) {
+        if (spec.dryrun || !spec.install) {
+            log.info({ point: 'generate-install', note: 'skipping npm install' });
+        }
+        if (!spec.dryrun) {
             await installNpm(spec, jopts, model);
         }
         log.info({ point: 'generate-end' });
@@ -112,9 +127,8 @@ function CreateSdkGen(opts) {
 async function installNpm(spec, opts, model) {
     const folder = opts.folder;
     const log = opts.log;
-    return new Promise((resolve, reject) => {
+    return new Promise(async (resolve, reject) => {
         const cwd = node_path_1.default.resolve(folder, '.sdk');
-        log.info({ point: 'generate-install', install: 'npm', note: 'npm install # ' + cwd });
         const env = {
             ...process.env,
             PATH: `${node_path_1.default.dirname(process.execPath)}${node_path_1.default.delimiter}${process.env.PATH}`,
@@ -125,18 +139,28 @@ async function installNpm(spec, opts, model) {
             env,
             stdio: 'inherit', // Direct passthrough for real-time output
         };
-        const child = (0, child_process_1.spawn)('npm', args, spawn_opts);
-        child.on('error', (err) => reject(new Error(`Failed to start npm: ${err.message}`)));
-        child.on('close', async (code) => {
-            if (code !== 0) {
-                reject(new Error(`npm install exited with code ${code}`));
-            }
-            else {
-                await installTargets(spec, opts, model, spawn_opts);
-                await installFeatures(spec, opts, model, spawn_opts);
-                resolve(null);
-            }
-        });
+        const postInstall = async () => {
+            await installTargets(spec, opts, model, spawn_opts);
+            await installFeatures(spec, opts, model, spawn_opts);
+        };
+        if (spec.install) {
+            log.info({ point: 'generate-install', note: 'running npm install in ' + cwd });
+            const child = (0, child_process_1.spawn)('npm', args, spawn_opts);
+            child.on('error', (err) => reject(new Error(`Failed to start npm: ${err.message}`)));
+            child.on('close', async (code) => {
+                if (code !== 0) {
+                    reject(new Error(`npm install exited with code ${code}`));
+                }
+                else {
+                    await postInstall();
+                    return resolve(null);
+                }
+            });
+        }
+        else {
+            await postInstall();
+            return resolve(null);
+        }
     });
 }
 async function installTargets(spec, opts, model, spawn_opts) {
@@ -152,6 +176,7 @@ async function installTargets(spec, opts, model, spawn_opts) {
             note: 'npm run target-add ' + targetlist
         });
         const args = ['run', 'add-target', targetlist];
+        log.info({ point: 'generate-target', note: 'adding targets: ' + targetlist });
         const child = (0, child_process_1.spawn)('npm', args, spawn_opts);
         child.on('error', (err) => reject(new Error(`Failed to start npm: ${err.message}`)));
         child.on('close', async (code) => {
@@ -177,6 +202,7 @@ async function installFeatures(spec, opts, model, spawn_opts) {
             note: 'npm run feature-add ' + featurelist
         });
         const args = ['run', 'add-feature', featurelist];
+        log.info({ point: 'generate-feature', note: 'adding features: ' + featurelist });
         const child = (0, child_process_1.spawn)('npm', args, spawn_opts);
         child.on('error', (err) => reject(new Error(`Failed to start npm: ${err.message}`)));
         child.on('close', async (code) => {

package/dist/create-sdkgen.js.map

@@ -1 +1 @@
-{"version":3,"file":"create-sdkgen.js","sourceRoot":"","sources":["../src/create-sdkgen.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"create-sdkgen.js","sourceRoot":"","sources":["../src/create-sdkgen.ts"],"names":[],"mappings":"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"}

package/dist/tsconfig.tsbuildinfo

@@ -1 +1 @@
-{"root":["../src/create-sdkgen.ts","../src/project/standard/modelsdk.ts","../src/project/standard/root.ts"],"version":"5.8.3"}
+{"root":["../src/create-sdkgen.ts","../src/project/standard/modelsdk.ts","../src/project/standard/root.ts"],"version":"5.9.2"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voxgig/create-sdkgen",
-  "version": "0.1.2",
+  "version": "0.3.0",
   "main": "dist/create-sdkgen.js",
   "type": "commonjs",
   "types": "dist/create-sdkgen.d.ts",
@@ -20,8 +20,8 @@
     "create-sdkgen": "bin/create-sdkgen"
   },
   "scripts": {
-    "test": "node --enable-source-maps --test dist-test",
-    "test-some": "node --enable-source-maps --test-name-pattern=\"$npm_config_pattern\" --test dist-test",
+    "test": "node --enable-source-maps --test dist-test/**/*.test.js",
+    "test-some": "node --enable-source-maps --test-name-pattern=\"$npm_config_pattern\" --test dist-test/**/*.test.js",
     "watch": "tsc --build src test -w",
     "build": "tsc --build src test",
     "test-model": "voxgig-model project/.sdk/test/test.jsonic",
@@ -42,16 +42,16 @@
   ],
   "devDependencies": {
     "@hapi/code": "^9.0.3",
-    "@types/node": "24.1.0",
+    "@types/node": "24.2.0",
     "esbuild": "^0.25.8",
-    "memfs": "^4.24.0",
-    "typescript": "^5.8.3"
+    "memfs": "^4.36.0",
+    "typescript": "^5.9.2"
   },
   "dependencies": {
     "@voxgig/util": "^0.2.0",
     "aontu": "^0.28.0",
     "chokidar": "^4.0.3",
     "gubu": "^9.0.0",
-    "jostraca": "^0.23.0"
+    "jostraca": "^0.24.1"
   }
 }

package/project/standard/.sdk/model/.model-config/model-config.jsonic

@@ -2,12 +2,14 @@
 
 @'@voxgig/model/model/.model-config/model-config.jsonic'
 
-sys: model: builders: {
+sys: model: action: {
   apidef: load: 'build/apidef.js'
   sdkgen: load: 'build/sdkgen.js'
   // docgen: load: 'build/docgen.js'
 }
 
+sys: model: order: action: 'apidef,sdkgen'
+
 sys: model: watch: {
   'src': {}   # To catch fragment updates.
   'dist': {}

package/project/standard/.sdk/model/sdk.fragment.jsonic

@@ -10,6 +10,7 @@
 
 # SDK Details.
 name: 'NAME'
+origin: 'voxgig'
 def: 'DEF'
 
 

package/project/standard/.sdk/package.json

@@ -1,23 +1,26 @@
 {
   "name": "build-$$const.name$$-sdk",
   "version": "0.0.1",
-  "description": "",
-  "main": "index.js",
+  "description": "$$const.Name$$ SDK Project",
   "scripts": {
-    "model": "voxgig-model model/sdk.jsonic",
-    "model-watch": "voxgig-model -w model/sdk.jsonic",
+    "generate": "voxgig-model model/sdk.jsonic",
+    "watch-generate": "voxgig-model -w model/sdk.jsonic",
+    "dry-generate": "voxgig-model -y model/sdk.jsonic",
+    "watch-dry-generate": "voxgig-model -w -y model/sdk.jsonic",
     "test-model": "voxgig-model test/test.jsonic",
-    "test-model-watch": "voxgig-model -w test/test.jsonic",
+    "watch-test-model": "voxgig-model -w test/test.jsonic",
     "watch": "tsc --build src -w",
     "build": "tsc --build src",
     "test": "echo no-test",
     "clean": "rm -rf node_modules yarn.lock package-lock.json",
     "reset": "npm run clean && npm i && npm run build && npm test",
-    "add-target": "voxgig-sdkgen target add $npm_config_target",
-    "add-feature": "voxgig-sdkgen feature add $npm_config_feature"
+    "add-target": "voxgig-sdkgen target add",
+    "dry-add-target": "voxgig-sdkgen -y target add",
+    "add-feature": "voxgig-sdkgen feature add",
+    "dry-add-feature": "voxgig-sdkgen -y feature add"
   },
-  "author": "",
-  "license": "MIT",
+  "author": "$$const.Name$$",
+  "license": "$$const.License$$",
   "devDependencies": {
     "@types/node": ">=24",
     "typescript": ">=5",

package/project/standard/.sdk/src/Root.ts

@@ -26,6 +26,8 @@ const {
 } = PointUtil
 
 
+import { Top } from './Top'
+
 
 const Root = cmp(function Root(props: any) {
   const { model, ctx$ } = props
@@ -62,6 +64,9 @@ const Root = cmp(function Root(props: any) {
 
   Project({}, () => {
 
+    // TODO: jostraca should accept no props
+    Top({})
+
     each(target, (target: any) => {
       names(target, target.name)
 

package/project/standard/.sdk/src/Top.ts

@@ -0,0 +1,48 @@
+
+
+import {
+  cmp, each, Line, File, Content
+} from '@voxgig/sdkgen'
+
+
+const Top = cmp(function Top(props: any) {
+  const { ctx$ } = props
+  const { model } = ctx$
+
+  File({ name: 'README.md' }, () => {
+    Content(`# ${model.Name} SDKs
+
+## API Entities
+
+\`\`\`mermaid 
+flowchart LR
+`)
+
+    const entityMap = model.main.api.entity
+
+    each(entityMap, (entity: any) => {
+      const ancestors = entity.ancestors || []
+      if (0 < ancestors.length) {
+        const pname = ancestors[ancestors.length - 1]
+        const parent = entityMap[pname]
+        if (null != parent) {
+          Line(`  ${parent.Name} --> ${entity.Name}`)
+        }
+      }
+    })
+
+    Content(`
+\`\`\`
+
+`)
+
+
+
+  })
+})
+
+
+export {
+  Top
+}
+

package/src/create-sdkgen.ts

@@ -36,9 +36,12 @@ type GenerateSpec = {
 
 const { names, Jostraca } = JostracaModule
 
-
+// TODO: CreateSdkGen opts and generate opts should be mostly the same, and
+// generate should override
 function CreateSdkGen(opts: FullCreateSdkGenOptions) {
   const fs = opts.fs || Fs
+
+  const debug = opts.debug
   const pino = prettyPino('create', opts)
   const log = pino.child({ cmp: 'create' })
 
@@ -47,7 +50,13 @@ function CreateSdkGen(opts: FullCreateSdkGenOptions) {
   async function generate(spec: GenerateSpec) {
     const start = Date.now()
 
-    log.info({ point: 'generate-start', start, note: spec.project })
+    let dryrun = !!spec.dryrun
+
+    log.info({
+      point: 'generate-start',
+      start,
+      note: spec.project + (dryrun ? ' ** DRY RUN **' : '')
+    })
     log.debug({ point: 'generate-spec', spec, note: JSON.stringify(spec, null, 2) })
 
     const projectFolder = resolveProjectFolder(spec)
@@ -63,6 +72,7 @@ function CreateSdkGen(opts: FullCreateSdkGenOptions) {
 
     const jopts = {
       fs: () => fs,
+      debug,
       folder,
       log: log.child({ cmp: 'jostraca' }),
       meta: { spec },
@@ -72,7 +82,7 @@ function CreateSdkGen(opts: FullCreateSdkGenOptions) {
         }
       },
       control: {
-        dryrun: spec.dryrun
+        dryrun,
       }
     }
 
@@ -87,15 +97,21 @@ function CreateSdkGen(opts: FullCreateSdkGenOptions) {
     names(model, model.name)
     names(model, model.name, 'project_name')
 
-    log.debug({ point: 'generate-model', model, note: JSON.stringify(model, null, 2) })
+    log.debug({
+      point: 'generate-jostraca',
+      jostraca: jopts,
+      note: JSON.stringify(jopts, null, 2)
+    })
 
     const jres = await jostraca.generate(jopts, () => Root({ model, spec }))
 
-    // logfiles(jres, log)
-
     showChanges(jopts.log, 'generate-result', jres, Path.dirname(process.cwd()))
 
-    if (!spec.dryrun && spec.install) {
+    if (spec.dryrun || !spec.install) {
+      log.info({ point: 'generate-install', note: 'skipping npm install' })
+    }
+
+    if (!spec.dryrun) {
       await installNpm(spec, jopts, model)
     }
 
@@ -135,9 +151,8 @@ async function installNpm(spec: GenerateSpec, opts: any, model: any) {
   const folder = opts.folder
   const log = opts.log
 
-  return new Promise((resolve, reject) => {
+  return new Promise(async (resolve, reject) => {
     const cwd = Path.resolve(folder, '.sdk')
-    log.info({ point: 'generate-install', install: 'npm', note: 'npm install # ' + cwd })
 
     const env = {
       ...process.env,
@@ -152,20 +167,32 @@ async function installNpm(spec: GenerateSpec, opts: any, model: any) {
       stdio: 'inherit', // Direct passthrough for real-time output
     }
 
-    const child = spawn('npm', args, spawn_opts)
+    const postInstall = async () => {
+      await installTargets(spec, opts, model, spawn_opts)
+      await installFeatures(spec, opts, model, spawn_opts)
+    }
 
-    child.on('error', (err) => reject(new Error(`Failed to start npm: ${err.message}`)))
+    if (spec.install) {
+      log.info({ point: 'generate-install', note: 'running npm install in ' + cwd })
 
-    child.on('close', async (code) => {
-      if (code !== 0) {
-        reject(new Error(`npm install exited with code ${code}`))
-      }
-      else {
-        await installTargets(spec, opts, model, spawn_opts)
-        await installFeatures(spec, opts, model, spawn_opts)
-        resolve(null)
-      }
-    })
+      const child = spawn('npm', args, spawn_opts)
+
+      child.on('error', (err) => reject(new Error(`Failed to start npm: ${err.message}`)))
+
+      child.on('close', async (code) => {
+        if (code !== 0) {
+          reject(new Error(`npm install exited with code ${code}`))
+        }
+        else {
+          await postInstall()
+          return resolve(null)
+        }
+      })
+    }
+    else {
+      await postInstall()
+      return resolve(null)
+    }
   })
 }
 
@@ -188,6 +215,7 @@ async function installTargets(spec: GenerateSpec, opts: any, model: any, spawn_o
 
     const args = ['run', 'add-target', targetlist]
 
+    log.info({ point: 'generate-target', note: 'adding targets: ' + targetlist })
     const child = spawn('npm', args, spawn_opts)
 
     child.on('error', (err) => reject(new Error(`Failed to start npm: ${err.message}`)))
@@ -222,6 +250,7 @@ async function installFeatures(spec: GenerateSpec, opts: any, model: any, spawn_
 
     const args = ['run', 'add-feature', featurelist]
 
+    log.info({ point: 'generate-feature', note: 'adding features: ' + featurelist })
     const child = spawn('npm', args, spawn_opts)
 
     child.on('error', (err) => reject(new Error(`Failed to start npm: ${err.message}`)))

package/project/standard/.sdk/model/.model-config/model-config.jsonic~

@@ -1,16 +0,0 @@
-
-
-@'@voxgig/model/model/.model-config/model-config.jsonic'
-
-sys: model: builders: {
-  apidef: load: 'build/apidef.js'
-  sdkgen: load: 'build/sdkgen.js'
-  // docgen: load: 'build/docgen.js'
-}
-
-sys: model: watch: {
-  'dist': {}
-  'tm': {}
-  'def': {}
-  # 'doc/static/src': {}
-}