@voxgig/create-sdkgen 0.1.1 → 0.2.0

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

@@ -0,0 +1,233 @@
+
+import {
+  names,
+  cmp,
+  each,
+  getx,
+
+  Project,
+  Folder,
+
+  Main,
+  Entity,
+  Feature,
+  Readme,
+
+} from '@voxgig/sdkgen'
+
+
+import { transform, select, ismap } from '@voxgig/struct'
+
+import { PointUtil, Content } from 'jostraca'
+
+const {
+  buildPoints,
+  SerialPoint,
+} = PointUtil
+
+
+import { Top } from './Top'
+
+
+const Root = cmp(function Root(props: any) {
+  const { model, ctx$ } = props
+
+  ctx$.util = ctx$.util || {}
+  ctx$.util.makeFlow = makeFlow
+
+  // TODO: move to @voxgig/util as duplicated
+  model.const = { name: model.name }
+  names(model.const, model.name)
+  model.const.year = new Date().getFullYear()
+
+  ctx$.model = model
+
+  const target = model.main.sdk.target || {}
+  const feature = model.main.sdk.feature || {}
+  const entity = model.main.api.entity || {}
+
+  ctx$.log.debug({
+    point: 'cmp-root', target, entity, feature, note: [
+      '\ntarget: \n' + Object.keys(target).map(s => '  ' + s).join('\n'),
+      '\nentity:\n' + Object.keys(entity).map(s => '  ' + s).join('\n'),
+      '\nfeature:\n' + Object.keys(feature).map(s => '  ' + s).join('\n'),
+    ].join('\n')
+  })
+
+  names(model, model.name)
+  // console.log('MODEL name', model.name, model.Name)
+
+  // Standard Replacements
+  ctx$.stdrep = {}
+  names(ctx$.stdrep, model.Name, 'ProjectName')
+  // console.log('STDREP', stdrep)
+
+  Project({}, () => {
+
+    // TODO: jostraca should accept no props
+    Top({})
+
+    each(target, (target: any) => {
+      names(target, target.name)
+
+      Folder({ name: target.name }, () => {
+
+        each(entity, (entity: any) => {
+          names(entity, entity.name)
+          Entity({ target, entity })
+        })
+
+        // each(feature).filter((feature: any) => feature.active).map((feature: any) => {
+        each(feature).filter((feature: any) => feature.active).map((feature: any) => {
+          names(feature, feature.name)
+          Feature({ target, feature })
+        })
+
+        Main({ target })
+
+        Readme({ target })
+
+      })
+    })
+
+  })
+})
+
+
+function makeFlow(def: any, data: any, stepMakers: Record<string, any>) {
+
+  const steps: any = {}
+  each(stepMakers, (n: any) => {
+    // TODO: support after?
+    if ('function' === typeof n.val$) {
+      steps[n.key$] = (id: any, pdef: any) => makeFlowStep(id(), pdef, n.val$)
+    }
+    else if ('string' === typeof n.val$) {
+      steps[n.key$] = (id: any, pdef: any) => makeFlowStep(id(), pdef, (sd: any, pctx: any) => {
+        Content({
+          indent: pctx.data.indent,
+          extra: {
+            __stepdef: sd
+          },
+        }, n.val$)
+      })
+    }
+    else if (Array.isArray(n)) {
+      steps[(n as any).key$] =
+        (id: any, pdef: any) => makeFlowStep(id(), pdef, (sd: any, pctx: any) => {
+          const extra = {
+            __stepdef: sd
+          }
+          for (let tmdef of n) {
+            let tmtxt
+            if ('string' === typeof tmdef) {
+              tmtxt = tmdef
+            }
+            else if (Array.isArray(tmdef)) {
+              let pass = true
+              let cond = tmdef[0]
+              tmtxt = tmdef[1]
+
+              if ('string' === typeof cond) {
+                pass = (null != getx(extra, tmdef[0]) || null != getx(pctx.data.model, tmdef[0]))
+              }
+              else if (ismap(cond)) {
+                let children = [{ ...pctx.data.model, ...extra }]
+                let found = select(
+                  children,
+                  cond
+                )
+                pass = 0 < found.length
+              }
+
+              if (!pass) {
+                tmtxt = tmdef[2]
+              }
+            }
+            else if ('function' === typeof tmdef) {
+              tmdef(sd, pctx)
+            }
+
+            if (null != tmtxt) {
+              Content({
+                indent: pctx.data.indent,
+                extra,
+              }, tmtxt)
+            }
+          }
+        })
+    }
+  })
+
+  each(def.step, (step: any) => {
+    names(step, step.entity, 'entity')
+  })
+
+  // console.log('STEPS', stepMakers, steps, def)
+
+  const spec = transform(def, {
+    p: ['`$EACH`', 'step', {
+      k: 'FlowStep',
+      a: '`.`',
+      p: [
+        { k: 'GetEntity', a: '`...`' },
+        { k: 'EntityMatch', a: '`...`' },
+        { k: 'EntityData', a: '`...`' },
+        { k: 'EntityAction', a: '`...`' },
+        { k: 'ExplainAction', a: '`...`' },
+        { k: 'ValidateAction', a: '`...`' },
+      ]
+    }]
+  })
+
+  const rootPoint = buildPoints(spec, steps) as any
+
+  data = data || {}
+  data.step = {}
+
+  rootPoint.direct(data)
+}
+
+
+function makeFlowStep(
+  id: string,
+  pdef: any,
+  before: any,
+  after?: any,
+  _parent?: any
+): any {
+
+  class FlowStep extends SerialPoint {
+    pdef: any
+
+    constructor(id: string, pdef: any) {
+      super(id)
+      this.pdef = pdef
+    }
+
+    async run(pctx: any): Promise<void> {
+      const stepdef = pdef.a
+      if (stepdef.ref) {
+        const refstep = pctx.data.step[stepdef.ref]
+        stepdef.kind = refstep.kind
+        stepdef.entity = refstep.entity
+        stepdef._ref = stepdef.ref
+        delete stepdef.ref
+      }
+
+      before.call(this, stepdef, pctx)
+      super.run(pctx)
+      after && after.call(this, stepdef, pctx)
+    }
+  }
+
+  return new FlowStep(id, pdef)
+}
+
+
+
+
+export {
+  Root
+}
+

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/project/standard/.sdk/src/cmp/README.md

@@ -0,0 +1,2 @@
+# Target builder components
+

package/project/standard/.sdk/src/tsconfig.json

@@ -0,0 +1,16 @@
+{
+  "compilerOptions": {
+    "esModuleInterop": true,
+    "module": "nodenext",
+    "noEmitOnError": true,
+    "outDir":"../dist",
+    "rootDir":".",
+    "resolveJsonModule": true,
+    "sourceMap": true,
+    "strict": true,
+    "target": "es2021",
+    "declaration": true,
+    "declarationDir": "../dist"
+  },
+  "exclude": ["**/fragment/*.fragment.ts"]
+}

package/project/standard/.sdk/test/.model-config/model-config.json

@@ -0,0 +1,7 @@
+{
+  "sys": {
+    "model": {
+      "builders": {}
+    }
+  }
+}

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

@@ -0,0 +1,4 @@
+
+@"@voxgig/model/model/.model-config/model-config.jsonic"
+
+sys: model: builders: {}

package/project/standard/.sdk/test/primary/auth.jsonic

@@ -0,0 +1,20 @@
+
+DEF: {
+  client: a: test: options: { apikey: 'APIKEY01' }
+  client: b: test: options: {}
+}
+
+
+basic: set: [
+
+  { ctx: spec:headers:{}
+    client: a
+    match: out:headers:authorization:'Bearer APIKEY01'
+  }
+
+  # { ctx: spec:headers:{}
+  #   client: b
+  #   match: out:headers:authorization:'__UNDEF__' }
+
+]
+

package/project/standard/.sdk/test/primary/body.jsonic

@@ -0,0 +1,27 @@
+
+basic: set: [
+  {
+    ctx: {
+      op:kind:req, op:reqform:'`data.foo`', op:check:nobody:true
+      op:data:foo:{x:1}
+    }
+    out: {x:1}
+  }
+
+  {
+    ctx: {
+      op:kind:req, op:reqform:'`data.bar`', op:check:nobody:false
+      op:data:foo:{x:2}
+    }
+  }
+
+  {
+    ctx: {
+      op:kind:req, op:reqform:'`data.bar`', op:check:nobody:true
+      op:data:foo:{x:3}
+    }
+    err: 'empty'
+  }
+
+]
+

package/project/standard/.sdk/test/primary/contextify.jsonic

@@ -0,0 +1,5 @@
+
+basic: set: [
+  { in:{op:{kind:req}}, match:out:{op:{kind:req}} }
+]
+

package/project/standard/.sdk/test/primary/done.jsonic

@@ -0,0 +1,7 @@
+
+basic: set: [
+  { ctx:{result:{ok:true,resdata:{x:1}}}, out:{x:1} }
+
+  { ctx:{result:{ok:false}}, err:'unknown operation: unknown error' }
+]
+

package/project/standard/.sdk/test/primary/error.jsonic

@@ -0,0 +1,19 @@
+
+basic: set: [
+  { args:[], err:'SDK: unknown operation: unknown error' }
+  { args:[{}], err:'SDK: unknown operation: unknown error' }
+  { args:[{},{}], err:'SDK: unknown operation: unknown error' }
+
+  { args:[{op:{}}], err:'SDK: unknown operation: unknown error' }
+  { args:[{op:name:foo}], err:'SDK: foo: unknown error' }
+  { args:[{op:name:foo,result:{}}], err:'SDK: foo: unknown error' }
+
+  { args:[{op:name:foo,result:{err:message:bar}}], err:'SDK: foo: bar' }
+  { args:[{op:name:foo}, {message:zed}], err:'SDK: foo: zed' }
+
+  { args:[{op:name:o0}, {message:e0}], err:'SDK: o0: e0'
+    match: err:message:'SDK: o0: e0'
+  }
+
+]
+

package/project/standard/.sdk/test/primary/findparam.jsonic

@@ -0,0 +1,22 @@
+
+
+DEF: {
+  ctx0: {op:{}}
+  ctx1: .ctx0 & {op:kind:res}
+  ctx2: .ctx1 & {op:match:{}}
+  ctx3: .ctx2 & {op:match:a:'A'}
+  ctx4: .ctx3 & {op:alias:{}}
+  ctx5: .ctx4 & {op:alias:b:'a',spec:{}}
+}
+
+basic: set: [
+  { mark:10, args: [ .....DEF.ctx0, a ] }
+  { mark:20, args: [ .....DEF.ctx1, a ] }
+  { mark:30, args: [ .....DEF.ctx2, a ] }
+  { mark:40, args: [ .....DEF.ctx3, a ], out: 'A'}
+  { mark:50, args: [ .....DEF.ctx3, b ] }
+  { mark:60, args: [ .....DEF.ctx4, b ] }
+  { mark:70, args: [ .....DEF.ctx5, a ], out: 'A' }
+  { mark:80, args: [ .....DEF.ctx5, b ], out: 'A', match: ctx:spec:alias:a:'b' }
+]
+

package/project/standard/.sdk/test/primary/fullurl.jsonic

@@ -0,0 +1,50 @@
+
+basic: set: [
+  {
+    ctx: {
+      op: {
+        params: ['a'],
+      },
+      spec: {
+        base: 'base-',
+        prefix: 'prefix-',
+        suffix: 'suffix-',
+        path: '/p0/{a}',
+        params: {
+          a: 'A'
+        },
+        query: {
+          b: 'B'
+        },
+        alias: {}
+      },
+    },
+    out: 'base-/prefix-/p0/A/suffix-?b=B'
+  }
+
+  {
+    ctx: {
+      op: {
+        kind: 'res',
+        params: ['foo_id'],
+        alias: {
+          foo_id: 'id'
+        },
+        match: {
+          id: 'A',
+        },
+      },
+      spec: {
+        base: 'base-',
+        prefix: 'prefix-',
+        suffix: 'suffix-',
+        path: '/p0/{foo_id}',
+        params: {},
+        alias: {}
+      }
+    }
+    out: 'base-/prefix-/p0/A/suffix-'
+  }
+  
+]
+

package/project/standard/.sdk/test/primary/headers.jsonic

@@ -0,0 +1,12 @@
+
+DEF: {
+  client: a: test: options: { headers: { foo:FOO, bar:BAR, accept: '*/*' } }
+}
+
+basic: set: [
+  { ctx: {}, out: { 'content-type': 'application/json', 'accept': 'application/json' } }
+
+  { ctx: {}, client:a,
+   out: { foo:FOO, bar:BAR, 'content-type': 'application/json', 'accept': '*/*' } }
+]
+

package/project/standard/.sdk/test/primary/inward.jsonic

@@ -0,0 +1,3 @@
+
+basic: set: []
+

package/project/standard/.sdk/test/primary/method.jsonic

@@ -0,0 +1,11 @@
+
+basic: set: [
+  { ctx: { op:name:create }, out: POST }
+  { ctx: { op:name:update }, out: PUT }
+  { ctx: { op:name:list }, out: GET }
+  { ctx: { op:name:load }, out: GET }
+  { ctx: { op:name:remove }, out: DELETE }
+
+  { ctx: { op:name:bad } }
+]
+

package/project/standard/.sdk/test/primary/operator.jsonic

@@ -0,0 +1,60 @@
+
+basic: set: [
+  {
+    ctx: {
+      op: {
+        entity: 'Foo',
+        name: 'load',
+        path: '/foo/{foo_id}',
+        params: ['foo_id'],
+        alias: {'foo_id':'id','id':'foo_id'},
+        match: {},
+        data: {},
+        state: {},
+        reqform: '`data`',
+        resform: '`body`',
+        check: {}
+      }
+    }
+    match: {
+      ctx: op: {
+        kind: ''
+        entity: 'Foo',
+        name: 'load',
+        path: '/foo/{foo_id}',
+        params: ['foo_id'],
+        alias: {'foo_id':'id','id':'foo_id'},
+        match: {},
+        data: {},
+        state: {},
+        reqform: '`data`',
+        resform: '`body`',
+        check: {}
+      }
+    } 
+  }
+
+  {
+    ctx: op: {}
+    err: 'Invalid data: Expected field entity to be string, but found no value. | Expected field kind to be exactly equal to one of req, res, but found no value. | Expected field name to be string, but found no value. | Expected field path to be string, but found no value. | Expected field reqform to be one of string, object, function, but found no value. | Expected field resform to be one of string, object, function, but found no value.'
+  }
+
+  {
+    ctx: op: {
+      entity: 11,
+      name: 22,
+      path: 33,
+      params: [44],
+      alias: {'foo_id':55},
+      match: 101,
+      data: 102,
+      state: 103,
+      reqform: 66,
+      resform: 77,
+      check: 88
+    }
+    err: 'Invalid data: Expected field alias.foo_id to be string, but found number: 55. | Expected field check to be object, but found number: 88. | Expected field data to be one of {}, [], but found number: 102. | Expected field data to be array, but found number: 102. | Expected field entity to be string, but found number: 11. | Expected field kind to be exactly equal to one of req, res, but found no value. | Expected field match to be object, but found number: 101. | Expected field name to be string, but found number: 22. | Expected field path to be string, but found number: 33. | Expected field reqform to be one of string, object, function, but found number: 66. | Expected field resform to be one of string, object, function, but found number: 77. | Expected field state to be object, but found number: 103.'
+  }
+
+]
+

package/project/standard/.sdk/test/primary/options.jsonic

@@ -0,0 +1,60 @@
+
+basic: set: [
+  {
+    in:prep: { config:{}, options:{} }
+    match: out: {
+      base: 'http://localhost:8000',
+      entity: {},
+      prefix: '',
+      suffix: '',
+    }
+  }
+
+  {
+    in:prep: { options: {}, config: options: {
+      base: 'http://cbase.example',
+      prefix: 'cpre-',
+      suffix: 'csuf-',
+      entity: {
+        foo: {}
+      }
+    }}
+    match: out: {
+      base: 'http://cbase.example',
+      prefix: 'cpre-',
+      suffix: 'csuf-',
+      entity: {
+        foo: {
+          alias: {}
+        }
+      }
+    }
+  }
+
+  {
+    in:prep: {
+      options: {
+        base: 'http://cbase.example',
+        prefix: 'cpre-',
+        suffix: 'csuf-',
+        entity: {
+          foo: {}
+        }
+      }
+      config: {}
+    }
+    match: out: {
+      base: 'http://cbase.example',
+      prefix: 'cpre-',
+      suffix: 'csuf-',
+      entity: {
+        foo: {
+          alias: {}
+        }
+      }
+    }
+  }
+
+  
+]
+

package/project/standard/.sdk/test/primary/outward.jsonic

@@ -0,0 +1,3 @@
+
+basic: set: []
+

package/project/standard/.sdk/test/primary/params.jsonic

@@ -0,0 +1,10 @@
+
+basic: set: [
+  { ctx: {op:{}}, out:{} }
+  { ctx: {op:params:[a]}, out:{} }
+  { ctx: {op:params:[a], op:match:a:A}, out:{a:A} }
+  { ctx: {op:params:[a], op:match:b:B}, out:{} }
+  { ctx: {op:params:[a], op:match:a:A,b:B}, out:{a:A} }
+  
+]
+

package/project/standard/.sdk/test/primary/query.jsonic

@@ -0,0 +1,9 @@
+
+basic: set: [
+  { mark:10, ctx: {op:{}}, out: {} }
+  { mark:20, ctx: {op:params:[a]}, out: {} }
+  { mark:30, ctx: {op:params:[a],op:match:a:A}, out: {} }
+  { mark:40, ctx: {op:params:[a],op:match:b:B}, out: {b:B} }
+  { mark:50, ctx: {op:params:[a],op:match:{a:A,b:B}}, out: {b:B} }
+]
+

package/project/standard/.sdk/test/primary/reqform.jsonic

@@ -0,0 +1,9 @@
+
+basic: set: [
+  {
+    ctx: { spec:step:'' op:reqform:'`data.foo`' op:data:foo:x:1 }
+    out: {x:1}
+    match: ctx:spec:step:reqform
+  }
+]
+

package/project/standard/.sdk/test/primary/request.jsonic

@@ -0,0 +1,31 @@
+
+
+DEF: {
+  client: a: test: options: { base: 'b0', system: fetch: '`fetch`' }
+}
+
+
+
+basic: set: [
+  {
+    ctx: {
+      op: params: [],
+      spec: {
+        base: 'http://localhost/base-',
+        prefix: 'prefix-',
+        suffix: 'suffix-',
+        path: '/p0',
+        params: {},
+        query: {},
+        alias: {},
+      }      
+    },
+    client: a
+
+    match:out: {
+      native: '__EXISTS__'
+      err: '__UNDEF__'
+    }
+  }
+]
+