@voxgig/sdkgen 0.35.2 → 0.37.0

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

@@ -1,16 +1,12 @@
 
 class EntityOperation {
 
-  #match
-  #data
-  #utility
-
 
   // EJECT-START
 
   async load(reqmatch, ctrl) {
 
-    const utility = this.#utility
+    const utility = this._utility
 
     const {
       makeContext,
@@ -29,8 +25,8 @@ class EntityOperation {
     let ctx = makeContext({
       opname: 'load',
       ctrl,
-      match: this.#match,
-      data: this.#data,
+      match: this._match,
+      data: this._data,
       reqmatch
     }, this._entctx)
 
@@ -79,11 +75,11 @@ class EntityOperation {
 
       if (null != ctx.result) {
         if (null != ctx.result.resmatch) {
-          this.#match = ctx.result.resmatch
+          this._match = ctx.result.resmatch
         }
 
         if (null != ctx.result.resdata) {
-          this.#data = ctx.result.resdata
+          this._data = ctx.result.resdata
         }
       }
 
@@ -92,7 +88,7 @@ class EntityOperation {
     catch (err) {
       // #PreUnexpected-Hook
 
-      err = this.#unexpected(ctx, err)
+      err = this._unexpected(ctx, err)
 
       if (err) {
         throw err
@@ -106,6 +102,6 @@ class EntityOperation {
   // EJECT-END
 
 
-  #unexpected(ctx, err) { return err }
+  _unexpected(ctx, err) { return err }
 }
 

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

@@ -1,16 +1,12 @@
 
 class EntityOperation {
 
-  #match
-  #data
-  #utility
-
 
   // EJECT-START
 
   async remove(reqmatch, ctrl) {
 
-    const utility = this.#utility
+    const utility = this._utility
 
     const {
       makeContext,
@@ -29,8 +25,8 @@ class EntityOperation {
     let ctx = makeContext({
       opname: 'remove',
       ctrl,
-      match: this.#match,
-      data: this.#data,
+      match: this._match,
+      data: this._data,
       reqmatch
     }, this._entctx)
 
@@ -80,11 +76,11 @@ class EntityOperation {
 
       if (null != ctx.result) {
         if (null != ctx.result.resmatch) {
-          this.#match = ctx.result.resmatch
+          this._match = ctx.result.resmatch
         }
 
         if (null != ctx.result.resdata) {
-          this.#data = ctx.result.resdata
+          this._data = ctx.result.resdata
         }
       }
 
@@ -93,7 +89,7 @@ class EntityOperation {
     catch (err) {
       // #PreUnexpected-Hook
 
-      err = this.#unexpected(ctx, err)
+      err = this._unexpected(ctx, err)
 
       if (err) {
         throw err
@@ -107,7 +103,7 @@ class EntityOperation {
   // EJECT-END
 
 
-  #unexpected(ctx, err) { return err }
+  _unexpected(ctx, err) { return err }
 
 }
 

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

@@ -1,16 +1,12 @@
 
 class EntityOperation {
 
-  #match
-  #data
-  #utility
-
 
   // EJECT-START
 
   async update(reqdata, ctrl) {
 
-    const utility = this.#utility
+    const utility = this._utility
 
     const {
       makeContext,
@@ -29,8 +25,8 @@ class EntityOperation {
     let ctx = makeContext({
       opname: 'update',
       ctrl,
-      match: this.#match,
-      data: this.#data,
+      match: this._match,
+      data: this._data,
       reqdata
     }, this._entctx)
 
@@ -80,11 +76,11 @@ class EntityOperation {
 
       if (null != ctx.result) {
         if (null != ctx.result.resmatch) {
-          this.#match = ctx.result.resmatch
+          this._match = ctx.result.resmatch
         }
 
         if (null != ctx.result.resdata) {
-          this.#data = ctx.result.resdata
+          this._data = ctx.result.resdata
         }
       }
 
@@ -93,7 +89,7 @@ class EntityOperation {
     catch (err) {
       // #PreUnexpected-Hook
 
-      err = this.#unexpected(ctx, err)
+      err = this._unexpected(ctx, err)
 
       if (err) {
         throw err
@@ -107,7 +103,7 @@ class EntityOperation {
   // EJECT-END
 
 
-  #unexpected(ctx, err) { return err }
+  _unexpected(ctx, err) { return err }
 
 }
 

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

@@ -3,6 +3,7 @@ const { inspect } = require('node:util')
 
 const { config } = require('./Config')
 const { Utility } = require('./utility/Utility')
+const { ProjectNameEntityBase } = require('./ProjectNameEntityBase')
 
 
 const { BaseFeature } = require('./feature/base/BaseFeature')
@@ -225,6 +226,7 @@ module.exports = {
   stdutil,
 
   BaseFeature,
+  ProjectNameEntityBase,
 
   ProjectNameSDK,
   SDK,

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

@@ -1,6 +1,4 @@
 
-const { Context } = require('./Context')
-
 
 class ProjectNameError extends Error {
 

package/project/.sdk/src/cmp/lua/Config_lua.ts

@@ -0,0 +1,116 @@
+
+import * as Path from 'node:path'
+
+
+import {
+  Content,
+  File,
+  Fragment,
+  Line,
+  cmp,
+  each,
+} from '@voxgig/sdkgen'
+
+
+import {
+  KIT,
+  Model,
+  getModelPath,
+  nom,
+} from '@voxgig/apidef'
+
+
+import {
+  clean,
+  formatLuaTable,
+} from './utility_lua'
+
+
+const Config = cmp(async function Config(props: any) {
+  const ctx$ = props.ctx$
+  const target = props.target
+
+  const model: Model = ctx$.model
+
+  const entity = getModelPath(model, `main.${KIT}.entity`)
+  const feature = getModelPath(model, `main.${KIT}.feature`)
+
+  const headers = getModelPath(model, `main.${KIT}.config.headers`) || {}
+
+  let authPrefix = ''
+  try { authPrefix = getModelPath(model, `main.${KIT}.config.auth.prefix`) } catch (_e) { }
+
+  let baseUrl = ''
+  try { baseUrl = getModelPath(model, `main.${KIT}.info.servers.0.url`) } catch (_e) { }
+
+  File({ name: 'config.' + target.ext }, () => {
+
+    Content(`-- ProjectName SDK configuration
+
+local function make_config()
+  return {
+    main = {
+      name = "${model.const.Name}",
+    },
+    feature = {
+`)
+
+    each(feature, (f: any) => {
+      const fconfig = f.config || {}
+      Content(`      ["${f.name}"] = ${formatLuaTable(fconfig, 3)},
+`)
+    })
+
+    Content(`    },
+    options = {
+      base = "${baseUrl}",
+      auth = {
+        prefix = "${authPrefix}",
+      },
+      headers = ${formatLuaTable(headers, 3)},
+      entity = {
+`)
+
+    each(entity, (entity: any) => {
+      Content(`        ["${entity.name}"] = {},
+`)
+    })
+
+    Content(`      },
+    },
+    entity = ${formatLuaTable(
+      Object.values(entity).reduce((a: any, n: any) => (a[n.name] = clean({
+        fields: n.fields,
+        name: n.name,
+        op: n.op,
+        relations: n.relations,
+      }), a), {}), 2)},
+  }
+end
+
+
+local function make_feature(name)
+  local features = require("features")
+  local factory = features[name]
+  if factory ~= nil then
+    return factory()
+  end
+  return features.base()
+end
+
+
+-- Attach make_feature to the SDK class
+local function setup_sdk(SDK)
+  SDK._make_feature = make_feature
+end
+
+
+return make_config
+`)
+  })
+})
+
+
+export {
+  Config
+}

package/project/.sdk/src/cmp/lua/EntityOperation_lua.ts

@@ -0,0 +1,44 @@
+
+import {
+  cmp, camelify,
+  Content, Fragment
+} from '@voxgig/sdkgen'
+
+
+const EntityOperation = cmp(function Operation(props: any) {
+  const { model } = props.ctx$
+  const { ff, opname, entity, entrep } = props
+
+  let { indent } = props
+
+  if (null != indent) {
+    indent = indent.substring(1)
+    if ('' == indent) {
+      indent = undefined
+    }
+  }
+
+  const entop = entity.op[opname]
+
+  Fragment({
+    from: ff + '/Entity' + camelify(opname) + 'Op.fragment.lua',
+    eject: ['-- EJECT-START', '-- EJECT-END'],
+    indent,
+    replace: {
+      ...entrep,
+      ProjectName: model.const.Name,
+      EntityName: entity.Name,
+      entityname: entity.name,
+      '#Feature-Hook': ({ name, indent }: any) =>
+        Content({ indent }, `
+u.feature_hook(ctx, "${name}")
+`)
+
+    }
+  })
+})
+
+
+export {
+  EntityOperation
+}

package/project/.sdk/src/cmp/lua/Entity_lua.ts

@@ -0,0 +1,62 @@
+
+import * as Path from 'node:path'
+
+import {
+  cmp, each, camelify, names,
+  File, Content, Folder, Fragment, Line, FeatureHook, Slot
+} from '@voxgig/sdkgen'
+
+import { EntityOperation } from './EntityOperation_lua'
+
+
+const Entity = cmp(function Entity(props: any) {
+  const { model, stdrep } = props.ctx$
+  const { target, entity } = props
+
+  const entrep = {
+    ...stdrep,
+  }
+
+  names(entrep, entity.Name, 'EntityName')
+
+  const ff = Path.normalize(__dirname + '/../../../src/cmp/lua/fragment/')
+
+  // Entity files go to entity/ folder
+  Folder({ name: 'entity' }, () => {
+
+    File({ name: entity.name + '_entity.' + target.ext }, () => {
+
+      const opnames = Object.keys(entity.op)
+
+      const opfrags =
+        (['load', 'list', 'create', 'update', 'remove']
+          .reduce((a: any, opname: string) =>
+          (a['-- #' + camelify(opname) + 'Op'] =
+            !opnames.includes(opname) ? '' : ({ indent }: any) => {
+              EntityOperation({ ff, opname, indent, entity, entrep })
+            }, a), {}))
+
+      Fragment({
+        from: ff + 'Entity.fragment.lua',
+        replace: {
+          ...entrep,
+          ProjectName: model.const.Name,
+          EntityName: entity.Name,
+          entityname: entity.name,
+
+          '#Entity-Hook': ({ name, indent }: any) =>
+            Content({ indent }, `utility.feature_hook(ctx, "${name}")`),
+
+          ...opfrags,
+        }
+      })
+
+    })
+  })
+})
+
+
+
+export {
+  Entity
+}

package/project/.sdk/src/cmp/lua/MainEntity_lua.ts

@@ -0,0 +1,23 @@
+
+
+import { cmp, Content } from '@voxgig/sdkgen'
+
+
+const MainEntity = cmp(async function MainEntity(props: any) {
+  const { entity } = props
+  const { model } = props.ctx$
+
+  Content(`
+function ${model.const.Name}SDK:${entity.Name}(data)
+  local EntityMod = require("entity.${entity.name}_entity")
+  return EntityMod.new(self, data)
+end
+
+`)
+
+})
+
+
+export {
+  MainEntity
+}

package/project/.sdk/src/cmp/lua/Main_lua.ts

@@ -0,0 +1,133 @@
+
+import * as Path from 'node:path'
+
+import {
+  cmp, each, names, cmap,
+  List, File, Content, Copy, Folder, Fragment, Line, FeatureHook,
+} from '@voxgig/sdkgen'
+
+
+import type {
+  ModelEntity
+} from '@voxgig/apidef'
+
+
+import {
+  KIT,
+  getModelPath
+} from '@voxgig/apidef'
+
+
+import { Package } from './Package_lua'
+import { Config } from './Config_lua'
+import { MainEntity } from './MainEntity_lua'
+
+
+const Main = cmp(async function Main(props: any) {
+
+  const { target } = props
+  const { model } = props.ctx$
+
+  const entity: ModelEntity = getModelPath(model, `main.${KIT}.entity`)
+  const feature = getModelPath(model, `main.${KIT}.feature`)
+
+  Package({ target })
+
+  // Copy tm/lua files with replacements
+  Copy({
+    from: 'tm/' + target.name,
+    exclude: [/src\//],
+    replace: {
+      ...props.ctx$.stdrep,
+    }
+  })
+
+  // Generate main SDK file
+  File({ name: model.name + '_sdk.' + target.ext }, () => {
+
+    Fragment(
+      {
+        from: Path.normalize(__dirname + '/../../../src/cmp/lua/fragment/Main.fragment.lua'),
+        replace: {
+          ...props.ctx$.stdrep,
+
+          '#BuildFeatures': ({ indent }: any) => {
+            each(feature, (feat: any) => {
+              const fname = feat.name.charAt(0).toUpperCase() + feat.name.slice(1)
+              Content({ indent }, `  -- feature: ${feat.name}
+`)
+            })
+          },
+
+          '#Feature-Hook': ({ name, indent }: any) => Content({ indent }, `
+self._utility.feature_hook(self._rootctx, "${name}")
+`),
+
+        }
+      },
+
+      // Entities - injected at SLOT
+      () => {
+        each(entity, (entity: ModelEntity) => {
+          const entitySDK = getModelPath(model, `main.${KIT}.entity.${entity.name}`)
+          const entprops = { target, entity, entitySDK }
+          MainEntity(entprops)
+        })
+      })
+  })
+
+  // Generate config module
+  Folder({ name: '.' }, () => {
+    Config({ target })
+  })
+
+  // Generate feature factory module
+  File({ name: 'features.' + target.ext }, () => {
+    Content(`-- ProjectName SDK feature factory
+
+local BaseFeature = require("feature.base_feature")
+`)
+
+    each(feature, (feat: any) => {
+      if (feat.name !== 'base') {
+        const fname = feat.name.charAt(0).toUpperCase() + feat.name.slice(1)
+        Content(`local ${fname}Feature = require("feature.${feat.name}_feature")
+`)
+      }
+    })
+
+    Content(`
+
+local features = {}
+
+features.base = function()
+  return BaseFeature.new()
+end
+
+`)
+
+    each(feature, (feat: any) => {
+      if (feat.name !== 'base') {
+        const fname = feat.name.charAt(0).toUpperCase() + feat.name.slice(1)
+        Content(`features["${feat.name}"] = function()
+  return ${fname}Feature.new()
+end
+
+`)
+      }
+    })
+
+    Content(`
+return features
+`)
+  })
+
+  // Generate _make_feature function referenced by Main.fragment.lua
+  // This is part of the main SDK class, inserted via the slot
+
+})
+
+
+export {
+  Main
+}

package/project/.sdk/src/cmp/lua/Package_lua.ts

@@ -0,0 +1,80 @@
+
+import {
+  Content,
+  File,
+  cmp,
+  each,
+} from '@voxgig/sdkgen'
+
+
+import {
+  KIT,
+  Model,
+  getModelPath,
+} from '@voxgig/apidef'
+
+
+const Package = cmp(async function Package(props: any) {
+  const ctx$ = props.ctx$
+  const target = props.target
+
+  const model: Model = ctx$.model
+
+  const feature = getModelPath(model, `main.${KIT}.feature`)
+
+  File({ name: model.name + '.rockspec' }, () => {
+    Content(`package = "${model.name}-sdk"
+version = "0.0-1"
+source = {
+  url = "git://github.com/voxgig/${model.name}-sdk.git"
+}
+description = {
+  summary = "${model.const.Name} SDK for Lua",
+  license = "MIT"
+}
+dependencies = {
+  "lua >= 5.3",
+  "dkjson >= 2.5",
+`)
+
+    // Collect dependencies from features
+    each(feature, (f: any) => {
+      const luaDeps = f.deps?.lua
+      if (luaDeps) {
+        each(luaDeps, (dep: any) => {
+          if (dep.active) {
+            Content(`  "${dep.key$} >= ${dep.version}",
+`)
+          }
+        })
+      }
+    })
+
+    // Add target-level deps
+    const targetDeps = target.deps
+    if (targetDeps) {
+      each(targetDeps, (dep: any) => {
+        if (dep.active !== false) {
+          Content(`  "${dep.key$} >= ${dep.version || '0.0'}",
+`)
+        }
+      })
+    }
+
+    Content(`}
+build = {
+  type = "builtin",
+  modules = {
+    ["${model.name}_sdk"] = "${model.name}_sdk.lua",
+    ["config"] = "config.lua",
+    ["features"] = "features.lua",
+  }
+}
+`)
+  })
+})
+
+
+export {
+  Package
+}

package/project/.sdk/src/cmp/lua/ReadmeExplanation_lua.ts

@@ -0,0 +1,42 @@
+
+import { cmp, Content } from '@voxgig/sdkgen'
+
+
+const ReadmeExplanation = cmp(function ReadmeExplanation(props: any) {
+  const { target, ctx$: { model } } = props
+
+  Content(`### Data as tables
+
+The Lua SDK uses plain Lua tables throughout rather than typed
+objects. This mirrors the dynamic nature of the API and keeps the
+SDK flexible — no code generation is needed when the API schema
+changes.
+
+Use \`helpers.to_map()\` to safely validate that a value is a table.
+
+### Module structure
+
+\`\`\`
+lua/
+├── ${model.name}_sdk.lua    -- Main SDK module
+├── config.lua               -- Configuration
+├── features.lua             -- Feature factory
+├── core/                    -- Core types and context
+├── entity/                  -- Entity implementations
+├── feature/                 -- Built-in features (Base, Test, Log)
+├── utility/                 -- Utility functions and struct library
+└── test/                    -- Test suites
+\`\`\`
+
+The main module (\`${model.name}_sdk\`) exports the SDK constructor
+and test helper. Import entity or utility modules directly only
+when needed.
+
+`)
+
+})
+
+
+export {
+  ReadmeExplanation
+}