@voxgig/sdkgen 0.35.2 → 0.37.0

package/bin/voxgig-sdkgen

@@ -8,7 +8,7 @@ const { Gubu, Fault, One } = require('gubu')
 
 const { SdkGen } = require('../dist/sdkgen.js')
 
-const VERSION = '0.35.2'
+const VERSION = '0.37.0'
 const KONSOLE = console
 
 

package/dist/cmp/Main.js

@@ -6,18 +6,6 @@ const utility_1 = require("../utility");
 const Main = (0, jostraca_1.cmp)(function Main(props) {
     const { target, ctx$ } = props;
     const { model, stdrep, log } = ctx$;
-    const copyOpts = {
-        // This folder is relative to the .sdk folder in the project, as that is where
-        // the sdk is generated from.
-        from: 'tm/' + target.name,
-        replace: {
-            ...stdrep,
-        }
-    };
-    if (false === target.srcfeature) {
-        copyOpts.exclude = [/src\//];
-    }
-    (0, jostraca_1.Copy)(copyOpts);
     const Main_sdk = (0, utility_1.requirePath)(ctx$, `cmp/${target.name}/Main_${target.name}`);
     Main_sdk['Main']({ model, target, stdrep });
     log.info({ point: 'generate-main', target, note: 'target:' + target.name });

package/dist/cmp/Main.js.map

@@ -1 +1 @@
-{"version":3,"file":"Main.js","sourceRoot":"","sources":["../../src/cmp/Main.ts"],"names":[],"mappings":";;;AACA,uCAA2C;AAE3C,wCAAwC;AAOxC,MAAM,IAAI,GAAG,IAAA,cAAG,EAAC,SAAS,IAAI,CAAC,KAAU;IACvC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,KAAK,CAAA;IAC9B,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,IAAI,CAAA;IAEnC,MAAM,QAAQ,GAAQ;QACpB,8EAA8E;QAC9E,6BAA6B;QAC7B,IAAI,EAAE,KAAK,GAAG,MAAM,CAAC,IAAI;QACzB,OAAO,EAAE;YACP,GAAG,MAAM;SACV;KACF,CAAA;IAED,IAAI,KAAK,KAAK,MAAM,CAAC,UAAU,EAAE,CAAC;QAChC,QAAQ,CAAC,OAAO,GAAG,CAAC,OAAO,CAAC,CAAA;IAC9B,CAAC;IAED,IAAA,eAAI,EAAC,QAAQ,CAAC,CAAA;IAEd,MAAM,QAAQ,GAAG,IAAA,qBAAW,EAAC,IAAI,EAAE,OAAO,MAAM,CAAC,IAAI,SAAS,MAAM,CAAC,IAAI,EAAE,CAAC,CAAA;IAE5E,QAAQ,CAAC,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;IAE3C,GAAG,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,CAAA;AAC7E,CAAC,CAAC,CAAA;AAIA,oBAAI"}
+{"version":3,"file":"Main.js","sourceRoot":"","sources":["../../src/cmp/Main.ts"],"names":[],"mappings":";;;AACA,uCAAqC;AAErC,wCAAwC;AAOxC,MAAM,IAAI,GAAG,IAAA,cAAG,EAAC,SAAS,IAAI,CAAC,KAAU;IACvC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,KAAK,CAAA;IAC9B,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,IAAI,CAAA;IAEnC,MAAM,QAAQ,GAAG,IAAA,qBAAW,EAAC,IAAI,EAAE,OAAO,MAAM,CAAC,IAAI,SAAS,MAAM,CAAC,IAAI,EAAE,CAAC,CAAA;IAE5E,QAAQ,CAAC,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;IAE3C,GAAG,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,CAAA;AAC7E,CAAC,CAAC,CAAA;AAIA,oBAAI"}

package/dist/cmp/Readme.js

@@ -8,23 +8,23 @@ const ReadmeQuick_1 = require("./ReadmeQuick");
 const ReadmeModel_1 = require("./ReadmeModel");
 const ReadmeOptions_1 = require("./ReadmeOptions");
 const ReadmeEntity_1 = require("./ReadmeEntity");
+const ReadmeHowto_1 = require("./ReadmeHowto");
+const ReadmeExplanation_1 = require("./ReadmeExplanation");
 const ReadmeRef_1 = require("./ReadmeRef");
 const Readme = (0, jostraca_1.cmp)(function Readme(props) {
     const { target } = props;
     const { model } = props.ctx$;
     (0, jostraca_1.File)({ name: 'README.md' }, () => {
-        (0, jostraca_1.Content)(`
-# ${model.Name} ${target.title} SDK
-`);
-        // Sections
         (0, ReadmeIntro_1.ReadmeIntro)({ target });
         (0, ReadmeInstall_1.ReadmeInstall)({ target });
         (0, ReadmeQuick_1.ReadmeQuick)({ target });
+        (0, ReadmeHowto_1.ReadmeHowto)({ target });
         (0, ReadmeModel_1.ReadmeModel)({ target });
         (0, ReadmeOptions_1.ReadmeOptions)({ target });
         (0, ReadmeEntity_1.ReadmeEntity)({ target });
+        (0, ReadmeExplanation_1.ReadmeExplanation)({ target });
         (0, jostraca_1.Content)(`
-## Reference
+## Full Reference
 
 See [REFERENCE.md](REFERENCE.md) for complete API reference
 documentation including all method signatures, entity field schemas,

package/dist/cmp/Readme.js.map

@@ -1 +1 @@
-{"version":3,"file":"Readme.js","sourceRoot":"","sources":["../../src/cmp/Readme.ts"],"names":[],"mappings":";;;AACA,uCAA6C;AAG7C,+CAA2C;AAC3C,mDAA+C;AAC/C,+CAA2C;AAC3C,+CAA2C;AAC3C,mDAA+C;AAC/C,iDAA6C;AAC7C,2CAAuC;AAGvC,MAAM,MAAM,GAAG,IAAA,cAAG,EAAC,SAAS,MAAM,CAAC,KAAU;IAC3C,MAAM,EAAE,MAAM,EAAE,GAAG,KAAK,CAAA;IACxB,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC,IAAI,CAAA;IAE5B,IAAA,eAAI,EAAC,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,GAAG,EAAE;QAE/B,IAAA,kBAAO,EAAC;IACR,KAAK,CAAC,IAAI,IAAI,MAAM,CAAC,KAAK;CAC7B,CAAC,CAAA;QACE,WAAW;QACX,IAAA,yBAAW,EAAC,EAAE,MAAM,EAAE,CAAC,CAAA;QACvB,IAAA,6BAAa,EAAC,EAAE,MAAM,EAAE,CAAC,CAAA;QACzB,IAAA,yBAAW,EAAC,EAAE,MAAM,EAAE,CAAC,CAAA;QACvB,IAAA,yBAAW,EAAC,EAAE,MAAM,EAAE,CAAC,CAAA;QACvB,IAAA,6BAAa,EAAC,EAAE,MAAM,EAAE,CAAC,CAAA;QACzB,IAAA,2BAAY,EAAC,EAAE,MAAM,EAAE,CAAC,CAAA;QAExB,IAAA,kBAAO,EAAC;;;;;;CAMX,CAAC,CAAA;IACA,CAAC,CAAC,CAAA;IAEF,4CAA4C;IAC5C,IAAA,qBAAS,EAAC,EAAE,MAAM,EAAE,CAAC,CAAA;AACvB,CAAC,CAAC,CAAA;AAIA,wBAAM"}
+{"version":3,"file":"Readme.js","sourceRoot":"","sources":["../../src/cmp/Readme.ts"],"names":[],"mappings":";;;AACA,uCAA6C;AAG7C,+CAA2C;AAC3C,mDAA+C;AAC/C,+CAA2C;AAC3C,+CAA2C;AAC3C,mDAA+C;AAC/C,iDAA6C;AAC7C,+CAA2C;AAC3C,2DAAuD;AACvD,2CAAuC;AAGvC,MAAM,MAAM,GAAG,IAAA,cAAG,EAAC,SAAS,MAAM,CAAC,KAAU;IAC3C,MAAM,EAAE,MAAM,EAAE,GAAG,KAAK,CAAA;IACxB,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC,IAAI,CAAA;IAE5B,IAAA,eAAI,EAAC,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,GAAG,EAAE;QAE/B,IAAA,yBAAW,EAAC,EAAE,MAAM,EAAE,CAAC,CAAA;QACvB,IAAA,6BAAa,EAAC,EAAE,MAAM,EAAE,CAAC,CAAA;QACzB,IAAA,yBAAW,EAAC,EAAE,MAAM,EAAE,CAAC,CAAA;QACvB,IAAA,yBAAW,EAAC,EAAE,MAAM,EAAE,CAAC,CAAA;QACvB,IAAA,yBAAW,EAAC,EAAE,MAAM,EAAE,CAAC,CAAA;QACvB,IAAA,6BAAa,EAAC,EAAE,MAAM,EAAE,CAAC,CAAA;QACzB,IAAA,2BAAY,EAAC,EAAE,MAAM,EAAE,CAAC,CAAA;QACxB,IAAA,qCAAiB,EAAC,EAAE,MAAM,EAAE,CAAC,CAAA;QAE7B,IAAA,kBAAO,EAAC;;;;;;CAMX,CAAC,CAAA;IACA,CAAC,CAAC,CAAA;IAEF,4CAA4C;IAC5C,IAAA,qBAAS,EAAC,EAAE,MAAM,EAAE,CAAC,CAAA;AACvB,CAAC,CAAC,CAAA;AAIA,wBAAM"}

package/dist/cmp/ReadmeEntity.js

@@ -4,17 +4,20 @@ exports.ReadmeEntity = void 0;
 const jostraca_1 = require("jostraca");
 const types_1 = require("../types");
 const OP_DESC = {
-    load: { method: 'load(match)', desc: 'Load a single entity by match criteria.' },
-    list: { method: 'list(match)', desc: 'List entities matching the criteria.' },
-    create: { method: 'create(data)', desc: 'Create a new entity with the given data.' },
-    update: { method: 'update(data)', desc: 'Update an existing entity.' },
-    remove: { method: 'remove(match)', desc: 'Remove the matching entity.' },
+    load: { method: 'load(match)', goMethod: 'Load(match, ctrl)', desc: 'Load a single entity by match criteria.' },
+    list: { method: 'list(match)', goMethod: 'List(match, ctrl)', desc: 'List entities matching the criteria.' },
+    create: { method: 'create(data)', goMethod: 'Create(data, ctrl)', desc: 'Create a new entity with the given data.' },
+    update: { method: 'update(data)', goMethod: 'Update(data, ctrl)', desc: 'Update an existing entity.' },
+    remove: { method: 'remove(match)', goMethod: 'Remove(match, ctrl)', desc: 'Remove the matching entity.' },
 };
 const ReadmeEntity = (0, jostraca_1.cmp)(function ReadmeEntity(props) {
-    const { ctx$: { model } } = props;
+    const { target } = props;
+    const { model } = props.ctx$;
     const entity = (0, types_1.getModelPath)(model, `main.${types_1.KIT}.entity`);
+    const isGo = target.name === 'go';
+    const lang = isGo ? 'go' : 'ts';
     const publishedEntities = (0, jostraca_1.each)(entity)
-        .filter((entity) => entity.publish);
+        .filter((entity) => entity.active !== false);
     if (0 === publishedEntities.length) {
         return;
     }
@@ -25,7 +28,7 @@ const ReadmeEntity = (0, jostraca_1.cmp)(function ReadmeEntity(props) {
 `);
     publishedEntities.map((entity) => {
         const opnames = Object.keys(entity.op || {});
-        const fields = entity.field || [];
+        const fields = entity.fields || [];
         (0, jostraca_1.Content)(`
 ### ${entity.Name}
 
@@ -35,9 +38,16 @@ const ReadmeEntity = (0, jostraca_1.cmp)(function ReadmeEntity(props) {
 
 `);
         }
-        (0, jostraca_1.Content)(`Create an instance: \`const ${entity.name} = client.${entity.Name}()\`
+        if (isGo) {
+            (0, jostraca_1.Content)(`Create an instance: \`${entity.name} := client.${entity.Name}(nil)\`
 
 `);
+        }
+        else {
+            (0, jostraca_1.Content)(`Create an instance: \`const ${entity.name} = client.${entity.Name}()\`
+
+`);
+        }
         // Operations table
         if (opnames.length > 0) {
             (0, jostraca_1.Content)(`#### Operations
@@ -48,7 +58,8 @@ const ReadmeEntity = (0, jostraca_1.cmp)(function ReadmeEntity(props) {
             opnames.map((opname) => {
                 const info = OP_DESC[opname];
                 if (info) {
-                    (0, jostraca_1.Content)(`| \`${info.method}\` | ${info.desc} |
+                    const method = isGo ? info.goMethod : info.method;
+                    (0, jostraca_1.Content)(`| \`${method}\` | ${info.desc} |
 `);
                 }
             });
@@ -71,40 +82,79 @@ const ReadmeEntity = (0, jostraca_1.cmp)(function ReadmeEntity(props) {
 `);
         }
         // Example usage
-        if (opnames.includes('load')) {
-            (0, jostraca_1.Content)(`#### Example: Load
+        if (isGo) {
+            if (opnames.includes('load')) {
+                (0, jostraca_1.Content)(`#### Example: Load
+
+\`\`\`go
+result, err := client.${entity.Name}(nil).Load(map[string]any{"id": "${entity.name}_id"}, nil)
+\`\`\`
+
+`);
+            }
+            if (opnames.includes('list')) {
+                (0, jostraca_1.Content)(`#### Example: List
+
+\`\`\`go
+results, err := client.${entity.Name}(nil).List(nil, nil)
+\`\`\`
+
+`);
+            }
+            if (opnames.includes('create')) {
+                (0, jostraca_1.Content)(`#### Example: Create
+
+\`\`\`go
+result, err := client.${entity.Name}(nil).Create(map[string]any{
+`);
+                (0, jostraca_1.each)(fields, (field) => {
+                    if ('id' !== field.name && field.req) {
+                        (0, jostraca_1.Content)(`    "${field.name}": /* ${field.type || 'value'} */,
+`);
+                    }
+                });
+                (0, jostraca_1.Content)(`}, nil)
+\`\`\`
+
+`);
+            }
+        }
+        else {
+            if (opnames.includes('load')) {
+                (0, jostraca_1.Content)(`#### Example: Load
 
 \`\`\`ts
 const ${entity.name} = await client.${entity.Name}().load({ id: '${entity.name}_id' })
 \`\`\`
 
 `);
-        }
-        if (opnames.includes('list')) {
-            (0, jostraca_1.Content)(`#### Example: List
+            }
+            if (opnames.includes('list')) {
+                (0, jostraca_1.Content)(`#### Example: List
 
 \`\`\`ts
 const ${entity.name}s = await client.${entity.Name}().list()
 \`\`\`
 
 `);
-        }
-        if (opnames.includes('create')) {
-            (0, jostraca_1.Content)(`#### Example: Create
+            }
+            if (opnames.includes('create')) {
+                (0, jostraca_1.Content)(`#### Example: Create
 
 \`\`\`ts
 const ${entity.name} = await client.${entity.Name}().create({
 `);
-            (0, jostraca_1.each)(fields, (field) => {
-                if ('id' !== field.name && field.req) {
-                    (0, jostraca_1.Content)(`  ${field.name}: /* ${field.type || 'value'} */,
+                (0, jostraca_1.each)(fields, (field) => {
+                    if ('id' !== field.name && field.req) {
+                        (0, jostraca_1.Content)(`  ${field.name}: /* ${field.type || 'value'} */,
 `);
-                }
-            });
-            (0, jostraca_1.Content)(`})
+                    }
+                });
+                (0, jostraca_1.Content)(`})
 \`\`\`
 
 `);
+            }
         }
     });
 });

package/dist/cmp/ReadmeEntity.js.map

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

package/dist/cmp/ReadmeExplanation.d.ts

@@ -0,0 +1,2 @@
+declare const ReadmeExplanation: import("jostraca").Component;
+export { ReadmeExplanation };

package/dist/cmp/ReadmeExplanation.js

@@ -0,0 +1,308 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReadmeExplanation = void 0;
+const jostraca_1 = require("jostraca");
+const types_1 = require("../types");
+const utility_1 = require("../utility");
+const ReadmeExplanation = (0, jostraca_1.cmp)(function ReadmeExplanation(props) {
+    const { target, ctx$ } = props;
+    const { model } = ctx$;
+    const feature = (0, types_1.getModelPath)(model, `main.${types_1.KIT}.feature`);
+    (0, jostraca_1.Content)(`
+## Explanation
+
+### The operation pipeline
+
+Every entity operation (load, list, create, update, remove) follows a
+six-stage pipeline. Each stage fires a feature hook before executing:
+
+\`\`\`
+PrePoint \u2192 PreSpec \u2192 PreRequest \u2192 PreResponse \u2192 PreResult \u2192 PreDone
+\`\`\`
+
+- **PrePoint**: Resolves which API endpoint to call based on the
+  operation name and entity configuration.
+- **PreSpec**: Builds the HTTP spec \u2014 URL, method, headers, body \u2014
+  from the resolved point and the caller's parameters.
+- **PreRequest**: Sends the HTTP request. Features can intercept here
+  to replace the transport (as TestFeature does with mocks).
+- **PreResponse**: Parses the raw HTTP response.
+- **PreResult**: Extracts the business data from the parsed response.
+- **PreDone**: Final stage before returning to the caller. Entity
+  state (match, data) is updated here.
+
+`);
+    // Target-specific error description
+    if (target.name === 'py') {
+        (0, jostraca_1.Content)(`If any stage returns an error, the pipeline short-circuits and the
+error is returned to the caller as the second element in the return tuple.
+
+`);
+    }
+    else if (target.name === 'php') {
+        (0, jostraca_1.Content)(`If any stage returns an error, the pipeline short-circuits and the
+error is returned to the caller as the second element in the return array.
+
+`);
+    }
+    else if (target.name === 'rb') {
+        (0, jostraca_1.Content)(`If any stage returns an error, the pipeline short-circuits and the
+error is returned to the caller as a second return value.
+
+`);
+    }
+    else if (target.name === 'lua') {
+        (0, jostraca_1.Content)(`If any stage returns an error, the pipeline short-circuits and the
+error is returned to the caller as a second return value.
+
+`);
+    }
+    else if (target.name === 'go') {
+        (0, jostraca_1.Content)(`If any stage returns an error, the pipeline short-circuits and the
+error is returned to the caller. An unexpected panic triggers the
+\`PreUnexpected\` hook.
+
+`);
+    }
+    else {
+        (0, jostraca_1.Content)(`If any stage returns an error, the pipeline short-circuits and the
+error is returned to the caller.
+
+An unexpected exception triggers the \`PreUnexpected\` hook before
+propagating.
+
+`);
+    }
+    // Features and hooks
+    (0, jostraca_1.Content)(`### Features and hooks
+
+`);
+    if (target.name === 'py') {
+        (0, jostraca_1.Content)(`Features are the extension mechanism. A feature is a Python class
+with hook methods named after pipeline stages (e.g. \`PrePoint\`,
+\`PreSpec\`). Each method receives the context.
+
+`);
+    }
+    else if (target.name === 'php') {
+        (0, jostraca_1.Content)(`Features are the extension mechanism. A feature is a PHP class
+with hook methods named after pipeline stages (e.g. \`PrePoint\`,
+\`PreSpec\`). Each method receives the context.
+
+`);
+    }
+    else if (target.name === 'rb') {
+        (0, jostraca_1.Content)(`Features are the extension mechanism. A feature is a Ruby class
+with hook methods named after pipeline stages (e.g. \`PrePoint\`,
+\`PreSpec\`). Each method receives the context.
+
+`);
+    }
+    else if (target.name === 'lua') {
+        (0, jostraca_1.Content)(`Features are the extension mechanism. A feature is a Lua table
+with hook methods named after pipeline stages (e.g. \`PrePoint\`,
+\`PreSpec\`). Each method receives the context.
+
+`);
+    }
+    else if (target.name === 'go') {
+        (0, jostraca_1.Content)(`Features are the extension mechanism. A feature implements the
+\`Feature\` interface and provides hooks \u2014 functions keyed by pipeline
+stage names.
+
+`);
+    }
+    else {
+        (0, jostraca_1.Content)(`Features are the extension mechanism. A feature is an object with a
+\`hooks\` map. Each hook key is a pipeline stage name, and the value is
+a function that receives the context.
+
+`);
+    }
+    (0, jostraca_1.Content)(`The SDK ships with built-in features:
+
+`);
+    (0, jostraca_1.each)(feature, (feat) => {
+        if (!feat.active)
+            return;
+        if (!feat.Name)
+            (0, jostraca_1.names)(feat, feat.name);
+        const purpose = feat.title || feat.Name || feat.name;
+        (0, jostraca_1.Content)(`- **${feat.Name}Feature**: ${purpose}
+`);
+    });
+    (0, jostraca_1.Content)(`
+Features are initialized in order. Hooks fire in the order features
+were added, so later features can override earlier ones.
+
+`);
+    // Target-specific explanation
+    const ReadmeExplanation_sdk = (0, utility_1.requirePath)(ctx$, `./cmp/${target.name}/ReadmeExplanation_${target.name}`, { ignore: true });
+    if (ReadmeExplanation_sdk) {
+        ReadmeExplanation_sdk['ReadmeExplanation']({ target });
+    }
+    // Entity state
+    (0, jostraca_1.Content)(`### Entity state
+
+`);
+    if (target.name === 'py') {
+        (0, jostraca_1.Content)(`Entity instances are stateful. After a successful \`load\`, the entity
+stores the returned data and match criteria internally.
+
+\`\`\`python
+moon = client.Moon()
+moon.load({"planet_id": "earth", "id": "luna"})
+
+# moon.data_get() now returns the loaded moon data
+# moon.match_get() returns the last match criteria
+\`\`\`
+
+Call \`make()\` to create a fresh instance with the same configuration
+but no stored state.
+
+`);
+    }
+    else if (target.name === 'php') {
+        (0, jostraca_1.Content)(`Entity instances are stateful. After a successful \`load\`, the entity
+stores the returned data and match criteria internally.
+
+\`\`\`php
+$moon = $client->Moon();
+[$result, $err] = $moon->load(["planet_id" => "earth", "id" => "luna"]);
+
+// $moon->dataGet() now returns the loaded moon data
+// $moon->matchGet() returns the last match criteria
+\`\`\`
+
+Call \`make()\` to create a fresh instance with the same configuration
+but no stored state.
+
+`);
+    }
+    else if (target.name === 'rb') {
+        (0, jostraca_1.Content)(`Entity instances are stateful. After a successful \`load\`, the entity
+stores the returned data and match criteria internally.
+
+\`\`\`ruby
+moon = client.Moon
+moon.load({ "planet_id" => "earth", "id" => "luna" })
+
+# moon.data_get now returns the loaded moon data
+# moon.match_get returns the last match criteria
+\`\`\`
+
+Call \`make\` to create a fresh instance with the same configuration
+but no stored state.
+
+`);
+    }
+    else if (target.name === 'lua') {
+        (0, jostraca_1.Content)(`Entity instances are stateful. After a successful \`load\`, the entity
+stores the returned data and match criteria internally.
+
+\`\`\`lua
+local moon = client:Moon(nil)
+moon:load({ planet_id = "earth", id = "luna" }, nil)
+
+-- moon:data_get() now returns the loaded moon data
+-- moon:match_get() returns the last match criteria
+\`\`\`
+
+Call \`make()\` to create a fresh instance with the same configuration
+but no stored state.
+
+`);
+    }
+    else if (target.name === 'go') {
+        (0, jostraca_1.Content)(`Entity instances are stateful. After a successful \`Load\`, the entity
+stores the returned data and match criteria internally.
+
+\`\`\`go
+moon := client.Moon(nil)
+moon.Load(map[string]any{"planet_id": "earth", "id": "luna"}, nil)
+
+// moon.Data() now returns the loaded moon data
+// moon.Match() returns the last match criteria
+\`\`\`
+
+Call \`Make()\` to create a fresh instance with the same configuration
+but no stored state.
+
+`);
+    }
+    else {
+        (0, jostraca_1.Content)(`Entity instances are stateful. After a successful \`load\`, the entity
+stores the returned data and match criteria internally. Subsequent
+calls on the same instance can rely on this state.
+
+\`\`\`ts
+const moon = client.Moon()
+await moon.load({ planet_id: 'earth', id: 'luna' })
+
+// moon.data() now returns the loaded moon data
+// moon.match() returns { planet_id: 'earth', id: 'luna' }
+\`\`\`
+
+Call \`make()\` to create a fresh instance with the same configuration
+but no stored state.
+
+`);
+    }
+    // Direct vs entity access
+    (0, jostraca_1.Content)(`### Direct vs entity access
+
+The entity interface handles URL construction, parameter placement,
+and response parsing automatically. Use it for standard CRUD operations.
+
+`);
+    if (target.name === 'py') {
+        (0, jostraca_1.Content)(`\`direct()\` gives full control over the HTTP request. Use it for
+non-standard endpoints, bulk operations, or any path not modelled as
+an entity. \`prepare()\` builds the request without sending it \u2014 useful
+for debugging or custom transport.
+
+`);
+    }
+    else if (target.name === 'php') {
+        (0, jostraca_1.Content)(`\`direct()\` gives full control over the HTTP request. Use it for
+non-standard endpoints, bulk operations, or any path not modelled as
+an entity. \`prepare()\` builds the request without sending it \u2014 useful
+for debugging or custom transport.
+
+`);
+    }
+    else if (target.name === 'rb') {
+        (0, jostraca_1.Content)(`\`direct\` gives full control over the HTTP request. Use it for
+non-standard endpoints, bulk operations, or any path not modelled as
+an entity. \`prepare\` builds the request without sending it \u2014 useful
+for debugging or custom transport.
+
+`);
+    }
+    else if (target.name === 'lua') {
+        (0, jostraca_1.Content)(`\`direct()\` gives full control over the HTTP request. Use it for
+non-standard endpoints, bulk operations, or any path not modelled as
+an entity. \`prepare()\` builds the request without sending it \u2014 useful
+for debugging or custom transport.
+
+`);
+    }
+    else if (target.name === 'go') {
+        (0, jostraca_1.Content)(`\`Direct()\` gives full control over the HTTP request. Use it for
+non-standard endpoints, bulk operations, or any path not modelled as
+an entity. \`Prepare()\` builds the request without sending it \u2014 useful
+for debugging or custom transport.
+
+`);
+    }
+    else {
+        (0, jostraca_1.Content)(`The \`direct\` method gives full control over the HTTP request. Use it
+for non-standard endpoints, bulk operations, or any path not modelled
+as an entity. The \`prepare\` method is useful for debugging \u2014 it
+shows exactly what \`direct\` would send.
+
+`);
+    }
+});
+exports.ReadmeExplanation = ReadmeExplanation;
+//# sourceMappingURL=ReadmeExplanation.js.map

package/dist/cmp/ReadmeExplanation.js.map

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

package/dist/cmp/ReadmeHowto.d.ts

@@ -0,0 +1,2 @@
+declare const ReadmeHowto: import("jostraca").Component;
+export { ReadmeHowto };

package/dist/cmp/ReadmeHowto.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReadmeHowto = void 0;
+const jostraca_1 = require("jostraca");
+const utility_1 = require("../utility");
+const ReadmeHowto = (0, jostraca_1.cmp)(function ReadmeHowto(props) {
+    const { target, ctx$ } = props;
+    (0, jostraca_1.Content)(`
+## How-to guides
+
+`);
+    const ReadmeHowto_sdk = (0, utility_1.requirePath)(ctx$, `./cmp/${target.name}/ReadmeHowto_${target.name}`, { ignore: true });
+    if (ReadmeHowto_sdk) {
+        ReadmeHowto_sdk['ReadmeHowto']({ target });
+    }
+});
+exports.ReadmeHowto = ReadmeHowto;
+//# sourceMappingURL=ReadmeHowto.js.map

package/dist/cmp/ReadmeHowto.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReadmeHowto.js","sourceRoot":"","sources":["../../src/cmp/ReadmeHowto.ts"],"names":[],"mappings":";;;AACA,uCAAuC;AAEvC,wCAAwC;AAGxC,MAAM,WAAW,GAAG,IAAA,cAAG,EAAC,SAAS,WAAW,CAAC,KAAU;IACrD,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,KAAK,CAAA;IAE9B,IAAA,kBAAO,EAAC;;;CAGT,CAAC,CAAA;IAEA,MAAM,eAAe,GACnB,IAAA,qBAAW,EAAC,IAAI,EAAE,SAAS,MAAM,CAAC,IAAI,gBAAgB,MAAM,CAAC,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAA;IAExF,IAAI,eAAe,EAAE,CAAC;QACpB,eAAe,CAAC,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAA;IAC5C,CAAC;AACH,CAAC,CAAC,CAAA;AAMA,kCAAW"}

package/dist/cmp/ReadmeIntro.js

@@ -2,34 +2,19 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ReadmeIntro = void 0;
 const jostraca_1 = require("jostraca");
-const types_1 = require("../types");
+const TARGET_INTRO = {
+    ts: 'Provides a type-safe,\nentity-oriented interface with full async/await support.',
+    go: 'Provides an entity-oriented interface\nusing standard Go conventions \u2014 no generics required, data flows as\n`map[string]any`.',
+    js: 'Provides an entity-oriented\ninterface with full async/await support.',
+};
 const ReadmeIntro = (0, jostraca_1.cmp)(function ReadmeIntro(props) {
     const { target } = props;
     const { model } = props.ctx$;
     const desc = model.main.def.desc || '';
-    const entity = (0, types_1.getModelPath)(model, `main.${types_1.KIT}.entity`);
-    const entityNames = Object.values(entity)
-        .filter((e) => e.publish)
-        .map((e) => `\`${e.Name}\``);
-    (0, jostraca_1.Content)(`
-## Introduction
+    const targetIntro = TARGET_INTRO[target.name] || 'Provides an entity-oriented interface.';
+    (0, jostraca_1.Content)(`# ${model.Name} ${target.title} SDK
 
-${desc}
-`);
-    if (entityNames.length > 0) {
-        (0, jostraca_1.Content)(`
-This SDK provides an entity-oriented interface for the ${model.Name} API.
-The following entities are available: ${entityNames.join(', ')}.
-
-`);
-    }
-    (0, jostraca_1.Content)(`
-### Features
-
-- Entity-based API: work with business objects directly.
-- Type safe: full TypeScript definitions included.
-- Direct HTTP access: call any API endpoint using \`client.direct()\`.
-- Testable: built-in test mode with mock support.
+The ${target.title} SDK for the ${model.Name} API. ${targetIntro}
 
 `);
 });

package/dist/cmp/ReadmeIntro.js.map

@@ -1 +1 @@
-{"version":3,"file":"ReadmeIntro.js","sourceRoot":"","sources":["../../src/cmp/ReadmeIntro.ts"],"names":[],"mappings":";;;AACA,uCAAuC;AAEvC,oCAGiB;AAGjB,MAAM,WAAW,GAAG,IAAA,cAAG,EAAC,SAAS,WAAW,CAAC,KAAU;IACrD,MAAM,EAAE,MAAM,EAAE,GAAG,KAAK,CAAA;IACxB,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC,IAAI,CAAA;IAE5B,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAA;IACtC,MAAM,MAAM,GAAG,IAAA,oBAAY,EAAC,KAAK,EAAE,QAAQ,WAAG,SAAS,CAAC,CAAA;IAExD,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC;SACtC,MAAM,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;SAC7B,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,IAAI,IAAI,CAAC,CAAA;IAEnC,IAAA,kBAAO,EAAC;;;EAGR,IAAI;CACL,CAAC,CAAA;IAEA,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3B,IAAA,kBAAO,EAAC;yDAC6C,KAAK,CAAC,IAAI;wCAC3B,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC;;CAE7D,CAAC,CAAA;IACA,CAAC;IAED,IAAA,kBAAO,EAAC;;;;;;;;CAQT,CAAC,CAAA;AAEF,CAAC,CAAC,CAAA;AAMA,kCAAW"}
+{"version":3,"file":"ReadmeIntro.js","sourceRoot":"","sources":["../../src/cmp/ReadmeIntro.ts"],"names":[],"mappings":";;;AACA,uCAAuC;AAQvC,MAAM,YAAY,GAA2B;IAC3C,EAAE,EAAE,iFAAiF;IACrF,EAAE,EAAE,oIAAoI;IACxI,EAAE,EAAE,uEAAuE;CAC5E,CAAA;AAGD,MAAM,WAAW,GAAG,IAAA,cAAG,EAAC,SAAS,WAAW,CAAC,KAAU;IACrD,MAAM,EAAE,MAAM,EAAE,GAAG,KAAK,CAAA;IACxB,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC,IAAI,CAAA;IAE5B,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAA;IAEtC,MAAM,WAAW,GAAG,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,wCAAwC,CAAA;IAEzF,IAAA,kBAAO,EAAC,KAAK,KAAK,CAAC,IAAI,IAAI,MAAM,CAAC,KAAK;;MAEnC,MAAM,CAAC,KAAK,gBAAgB,KAAK,CAAC,IAAI,SAAS,WAAW;;CAE/D,CAAC,CAAA;AAEF,CAAC,CAAC,CAAA;AAMA,kCAAW"}