@voxgig/sdkgen 0.16.0 → 0.18.0

package/project/.sdk/src/cmp/js/MainEntity_js.ts

@@ -0,0 +1,22 @@
+
+
+import { cmp, each, File, Content } from '@voxgig/sdkgen'
+
+
+const MainEntity = cmp(async function MainEntity(props: any) {
+  const { entity } = props
+
+  Content(`
+  ${entity.Name}(data) {
+    const self = this
+    return new ${entity.Name}Entity(self,data)
+  }
+
+`)
+
+})
+
+
+export {
+  MainEntity
+}

package/project/.sdk/src/cmp/js/Main_js.ts

@@ -0,0 +1,88 @@
+
+import * as Path from 'node:path'
+
+import {
+  cmp, each, names, cmap,
+  List, File, Content, Copy, Folder, Fragment, Line, FeatureHook,
+} from '@voxgig/sdkgen'
+
+
+import { Package } from './Package_js'
+import { Config } from './Config_js'
+import { MainEntity } from './MainEntity_js'
+import { Test } from './Test_js'
+
+
+const Main = cmp(async function Main(props: any) {
+  const { target } = props
+  const { model } = props.ctx$
+
+  const { entity } = model.main.api
+  const { feature } = model.main.sdk
+
+  Package({ target })
+
+  Test({ target })
+
+  Folder({ name: 'src' }, () => {
+
+    File({ name: model.const.Name + 'SDK.' + target.name }, () => {
+
+      Line(`// ${model.const.Name} ${target.Name} SDK\n`)
+
+      List({ item: feature }, ({ item }: any) =>
+        Line(`const { ${item.Name + 'Feature'} } = ` +
+          `require('./feature/${item.name}/${item.Name}Feature')`))
+
+      List({ item: entity }, ({ item }: any) =>
+        Line(`const { ${item.Name}Entity } = require('./entity/${item.Name}Entity')`))
+
+      Fragment({
+        from: Path.normalize(__dirname + '/../../../src/cmp/js/fragment/Main.fragment.js'),
+        replace: {
+          Name: model.const.Name,
+
+
+          '#FeatureOptions': ({ indent }: any) =>
+            Line({ indent }, `const fopts = this.#options.feature || {}`),
+
+          '#BuildFeature': ({ indent }: any) => {
+            List({ item: feature, line: false }, ({ item }: any) =>
+              Line({ indent }, `${item.name}: ` +
+                `new ${item.Name}Feature(this, fopts.${item.name}, ` +
+                `${JSON.stringify(item.config || {})}), `))
+          },
+
+          '#Feature-Hook': ({ name, indent }: any) =>
+            FeatureHook({ name }, (f: any) =>
+              Line({ indent },
+                `${f.await ? 'await ' : ''}this.#features.${f.name}.${name}({ client: this })`)),
+
+          '#TestOptions': ({ indent }: any) => {
+            const topts = {
+              feature: cmap(feature, {
+                active: false
+              }),
+            }
+            Content({ indent },
+              JSON.stringify(topts, null, 2)
+                .replace(/^{\n  /, '').replace(/\n}$/, ',\n').replace(/\n  /g, '\n'))
+          }
+        }
+      }, () => {
+        each(entity, (entity: any) => {
+          // console.log('ENTITY', entity.name)
+          MainEntity({ target, entity, entitySDK: model.main.sdk.entity[entity.name] })
+        })
+      })
+    })
+
+    Config({ target })
+
+  })
+})
+
+
+export {
+  Main
+}

package/project/.sdk/src/cmp/js/Package_js.ts

@@ -0,0 +1,58 @@
+
+import {
+  cmp, omap, each, cmap,
+  File, Content,
+} from '@voxgig/sdkgen'
+
+
+
+const Package = cmp(async function Package(props: any) {
+  const { target, ctx$: { model } } = props
+  const { main: { sdk: { feature } } } = model
+
+  const only = (kind: string, deps: any) =>
+    omap(deps, ([k, v]: any) => [v.active && kind === v.kind ? k : undefined, v.version])
+
+  // merge target and feature deps, by kind
+  const deps =
+    each(feature, (feature: any) =>
+      omap(feature.deps[target.name], ([k, v]: any) =>
+        [v.active ? k : undefined, v]))
+      // TODO: sort by version; rules for version choice?
+      .reduce((a: any, deps: any) => (each(deps, (dep: any) =>
+        a[dep.kind][dep.key$] = dep.version), a),
+        {
+          prod: only('prod', target.deps),
+          peer: only('peer', target.deps),
+          dev: only('dev', target.deps),
+        })
+
+  // TODO: complete SDK meta data in model and use here
+  const pkg = {
+    name: `${model.const.name}-sdk`,
+    version: `0.0.1`,
+    description: 'DESCRIPTION',
+    main: `src/${model.const.Name}SDK.js`,
+    scripts: {
+      'test': 'node --test test/*.test.js',
+      'test-utility': 'node --test test/utility/*.test.js',
+      'test-accept': 'node --test test/accept/*.test.js',
+      'test-all': 'npm run test && npm run test-utility'
+    },
+    author: `${model.const.Name}`,
+    license: 'MIT',
+    dependencies: deps.prod,
+    peerDependencies: deps.peer,
+    devDependencies: deps.dev,
+  }
+
+
+  File({ name: 'package.json' }, () => {
+    Content(JSON.stringify(pkg, null, 2))
+  })
+})
+
+
+export {
+  Package
+}

package/project/.sdk/src/cmp/js/Quick_js.ts

@@ -0,0 +1,82 @@
+
+import { names, getx, each, cmp, File, Content } from '@voxgig/sdkgen'
+
+
+const Quick = cmp(function Quick(props: any) {
+  const { target } = props
+  const { model, meta: { spec } } = props.ctx$
+
+  // get quick entity from target config
+
+  let ent: any
+  let entmap = getx(spec.config.guideModel, 'guide entity?test:quick:active=true')
+
+  if (entmap) {
+    ent = Object.values(entmap)[0]
+    ent.name = Object.keys(entmap)[0]
+  }
+
+  ent = ent || { name: 'Entity' }
+  names(ent, ent.name)// , ent.key$ || 'name')
+
+  // TODO: selected features should be active by default!
+
+  const featureOptions = each(model.main.sdk.feature)
+    .filter((f: any) => f.active)
+    .reduce((a: any, f: any) => a + `\n    ${f.name}: { active: true },`, '')
+
+  // console.log('QUICK', ent, featureOptions)
+
+
+  File({ name: 'quick.' + target.name }, () => {
+
+    Content(`
+// ENT 3
+require('dotenv').config({ path: ['../../.env.local']})
+
+const { ${model.const.Name}SDK } = require('../')
+
+run()
+
+async function run() {
+  const client = new ${model.const.Name}SDK({
+    endpoint: process.env.${model.NAME}_ENDPOINT,
+    apikey: process.env.${model.NAME}_APIKEY,
+    ${featureOptions}
+  })
+
+`)
+
+    if (ent.test?.quick.create) {
+      Content(`    
+  out = await client.${ent.Name}().create(${JSON.stringify(ent.test?.quick.create)})
+  console.log('${ent.Name}.load', out) 
+`)
+    }
+
+    if (ent.test?.quick.load) {
+      Content(`    
+  out = await client.${ent.Name}().load(${JSON.stringify(ent.test?.quick.load)})
+  console.log('${ent.Name}.load', out) 
+`)
+    }
+
+    if (ent.test?.quick.list) {
+      Content(`    
+  out = await client.${ent.Name}().list(${JSON.stringify(ent.test?.quick.list)})
+  console.log('${ent.Name}.list', out)
+`)
+    }
+
+    Content(`
+}
+`)
+
+  })
+})
+
+
+export {
+  Quick
+}
+

package/project/.sdk/src/cmp/js/ReadmeInstall_js.ts

@@ -0,0 +1,19 @@
+
+import { cmp, Content } from '@voxgig/sdkgen'
+
+
+const ReadmeInstall = cmp(function ReadmeInstall(props: any) {
+  const { target } = props
+
+  Content('```js')
+  Content(`
+npm install ${target.module.name}
+`)
+  Content('```')
+
+})
+
+
+export {
+  ReadmeInstall
+}

package/project/.sdk/src/cmp/js/ReadmeQuick_js.ts

@@ -0,0 +1,25 @@
+
+import { cmp, Content } from '@voxgig/sdkgen'
+
+
+const ReadmeQuick = cmp(function ReadmeQuick(props: any) {
+  const { target, ctx$: { model } } = props
+
+  Content('```js')
+  Content(`
+const { ${model.const.Name}SDK } = require('${target.module.name}')
+
+const client = ${model.const.Name}SDK.make({
+  endpoint: process.env.${model.NAME}_ENDPOINT,
+  apikey: process.env.${model.NAME}_APIKEY,
+})
+
+`)
+  Content('```')
+
+})
+
+
+export {
+  ReadmeQuick
+}

package/project/.sdk/src/cmp/js/TestAcceptEntity_js.ts

@@ -0,0 +1,13 @@
+
+import { cmp, camelify, Content } from '@voxgig/sdkgen'
+
+
+const TestAcceptEntity = cmp(function TestEntity(props: any) {
+  const { entity } = props
+
+})
+
+
+export {
+  TestAcceptEntity
+}

package/project/.sdk/src/cmp/js/TestAccept_js.ts

@@ -0,0 +1,18 @@
+
+import { cmp, each, File, Content } from '@voxgig/sdkgen'
+
+
+import { TestAcceptEntity } from './TestAcceptEntity_js'
+
+
+const TestAccept = cmp(function TestMain(props: any) {
+  const { target } = props
+  const { model } = props.ctx$
+
+})
+
+
+export {
+  TestAccept
+}
+

package/project/.sdk/src/cmp/js/TestEntity_js.ts

@@ -0,0 +1,13 @@
+
+import { cmp, camelify, Content } from '@voxgig/sdkgen'
+
+
+const TestEntity = cmp(function TestEntity(props: any) {
+  const { entity } = props
+
+})
+
+
+export {
+  TestEntity
+}

package/project/.sdk/src/cmp/js/TestMain_js.ts

@@ -0,0 +1,19 @@
+
+import { cmp, each, File, Content } from '@voxgig/sdkgen'
+
+
+import { TestEntity } from './TestEntity_js'
+
+
+const TestMain = cmp(function TestMain(props: any) {
+  const { target } = props
+  const { model } = props.ctx$
+
+
+})
+
+
+export {
+  TestMain
+}
+

package/project/.sdk/src/cmp/js/Test_js.ts

@@ -0,0 +1,24 @@
+
+import { cmp, File, Content, Folder } from '@voxgig/sdkgen'
+
+import { Quick } from './Quick_js'
+import { TestMain } from './TestMain_js'
+import { TestAccept } from './TestAccept_js'
+
+
+const Test = cmp(function Test(props: any) {
+  const { target } = props
+
+  Folder({ name: 'test' }, () => {
+    Quick({ target })
+    TestMain({ target })
+    Folder({ name: 'accept' }, () => {
+      TestAccept({ target })
+    })
+  })
+})
+
+
+export {
+  Test
+}

package/project/.sdk/src/cmp/js/fragment/Entity.fragment.js

@@ -0,0 +1,79 @@
+
+class NameEntity {  
+  #client
+  #options
+  #features
+  #utility
+  #data
+  #match
+  
+  constructor(client, options) {
+    options = options || {}
+    options.active = false !== options.active
+
+    this.#client = client
+    this.#options = options
+    this.#features = client.features()
+    this.#utility = client.utility()
+    this.#data = {}
+    this.#match = {}
+
+    // #PostConstructEntity-Hook
+  }
+
+  options() {
+    return { ...this.#options }
+  }
+
+  client() {
+    return this.#client
+  }
+
+  make() {
+    return new NameEntity(this.#client, this.options())
+  }
+
+  
+  data(data) {
+    // NOTE: data can be mutated.
+    if(null != data) {
+
+      // #SetData-Hook
+      
+      this.#data = { ...data }
+    }
+
+    let out = { ...this.#data }
+
+    // #GetData-Hook
+
+    return out
+  }
+
+  
+  match() {
+    // NOTE: match cannot be mutated.
+    let out = { ...this.#match }
+
+    // #GetMatch-Hook
+
+    return out
+  }
+
+
+  // #LoadOp
+
+  // #ListOp
+
+  // #CreateOp
+
+  // #UpdateOp
+
+  // #RemoveOp
+
+}
+
+
+module.exports = {
+  NameEntity
+}

package/project/.sdk/src/cmp/js/fragment/EntityCreateOp.fragment.js

@@ -0,0 +1,61 @@
+class EntityOperation { // REMOVED
+
+async create(data) {
+  let entity = this
+  let client = this.#client
+  const utility = this.#utility
+  const { operator, spec, request, response, result, error, struct, done } = utility
+  
+  let op = {
+    entity: 'Name',
+    name: 'create',
+    path: 'PATH',
+    params: ['PARAM-LIST'],
+    alias: {'ALIAS':'MAP'},
+    match: this.#match,
+    data: null == data ? this.#data : data,
+    state: {},
+    reqform: 'REQFORM',
+    resform: 'RESFORM',
+  }
+  
+  let ctx = { client, op, utility, entity }
+
+  
+  // #PreOperation-Hook    
+
+  await operator(ctx)
+
+  
+  // #PreSpec-Hook
+
+  this.#data = ctx.op.data
+  
+  await spec(ctx)
+
+  
+  // #PreRequest-Hook
+
+  await request(ctx)
+
+  
+  // #PreResponse-Hook
+
+  await response(ctx)
+
+  
+  // #PreResult-Hook
+
+  await result(ctx)
+
+
+  // #PostOperation-Hook
+
+  if(null != ctx.result.resdata) {
+    this.#data = ctx.result.resdata
+  }
+
+  return done(ctx)
+}
+
+} // REMOVED

package/project/.sdk/src/cmp/js/fragment/EntityListOp.fragment.js

@@ -0,0 +1,57 @@
+class EntityOperation { // REMOVED
+
+async list(match) {
+  let entity = this
+  let client = this.#client
+  const utility = this.#utility
+    const { operator, spec, request, response, result, error, struct, done } = utility
+  
+  let op = {
+    entity: 'Name',
+    name: 'list',
+    path: 'PATH',
+    params: ['PARAM-LIST'],
+    alias: {'ALIAS':'MAP'},
+    match,
+    data: this.#data,
+    state: {},
+    reqform: 'REQFORM',
+    resform: 'RESFORM',
+  }
+
+  let ctx = { client, entity, op, utility}
+
+  
+  // #PreOperation-Hook    
+
+  await operator(ctx)
+
+  
+  // #PreSpec-Hook
+
+  this.#match = ctx.op.match
+  
+  await spec(ctx)
+
+  
+  // #PreRequest-Hook
+
+  await request(ctx)
+
+  
+  // #PreResponse-Hook
+
+  await response(ctx)
+
+  
+  // #PreResult-Hook
+
+  await result(ctx)
+
+
+  // #PostOperation-Hook
+
+  return done(ctx)
+}
+
+} // REMOVED

package/project/.sdk/src/cmp/js/fragment/EntityLoadOp.fragment.js

@@ -0,0 +1,61 @@
+class EntityOperation { // REMOVED
+
+async load(match) {
+  const entity = this
+  const client = this.#client
+  const utility = this.#utility
+  const { operator, spec, request, response, result, error, struct, done } = utility
+  
+  const op = {
+    entity: 'Name',
+    name: 'load',
+    path: 'PATH',
+    params: ['PARAM-LIST'],
+    alias: {'ALIAS':'MAP'},
+    match,
+    data: this.#data,
+    state: {},
+    reqform: 'REQFORM',
+    resform: 'RESFORM',
+  }
+
+  let ctx = { client, entity, op, utility}
+
+  
+  // #PreOperation-Hook    
+
+  await operator(ctx)
+
+  
+  // #PreSpec-Hook
+
+  this.#match = op.match
+  
+  await spec(ctx)
+
+  
+  // #PreRequest-Hook
+
+  await request(ctx)
+
+  
+  // #PreResponse-Hook
+
+  await response(ctx)
+
+  
+  // #PreResult-Hook
+  
+  await result(ctx)
+
+  
+  // #PostOperation-Hook
+
+  if(null != ctx.result.resdata) {
+    this.#data = ctx.result.resdata
+  }
+
+  return done(ctx)
+}
+
+} // REMOVED