@voxgig/apidef 1.8.0 → 2.0.0

package/dist/builder/flow/flowHeuristic01.js

@@ -0,0 +1,125 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.flowHeuristic01 = flowHeuristic01;
+const struct_1 = require("@voxgig/struct");
+const jostraca_1 = require("jostraca");
+async function flowHeuristic01(ctx) {
+    let entity = ctx.model.main.api.guide.entity;
+    const flows = [];
+    (0, jostraca_1.each)(entity, (entity) => {
+        flows.push(resolveBasicEntityFlow(ctx, entity));
+    });
+    return flows;
+}
+function resolveBasicEntityFlow(ctx, entity) {
+    const { apimodel, model } = ctx;
+    const apiEntity = apimodel.main.api.entity[entity.name];
+    const flow = {
+        name: 'Basic' + apiEntity.Name
+    };
+    const refs = [
+        `${apiEntity.name}01`,
+        `${apiEntity.name}02`,
+        `${apiEntity.name}03`,
+    ];
+    const idmap = refs.reduce((a, ref) => (a[ref] = ref.toUpperCase(), a), {});
+    flow.model = {
+        name: flow.Name,
+        param: {
+            [`${model.NAME}_TEST_${apiEntity.NAME}_ENTID`]: idmap
+        },
+        test: { entity: { [apiEntity.Name]: {} } },
+        step: []
+    };
+    (0, jostraca_1.names)(flow, flow.name);
+    const data = flow.model.test.entity[apiEntity.Name];
+    refs.map((ref, i) => {
+        const id = idmap[ref];
+        const ent = data[id] = {};
+        let num = (i * (0, struct_1.size)(apiEntity.field) * 10);
+        (0, jostraca_1.each)(apiEntity.field, (field) => {
+            ent[field.name] =
+                'number' === field.type ? num :
+                    'boolean' === field.type ? 0 === num % 2 :
+                        'object' === field.type ? {} :
+                            'array' === field.type ? [] :
+                                's' + (num.toString(16));
+            num++;
+        });
+        ent.id = id;
+    });
+    const steps = flow.model.step;
+    let num = 0;
+    let name;
+    if (apiEntity.op.load) {
+        name = `load_${apiEntity.name}${num}`;
+        steps.push({
+            name,
+            kind: 'entity',
+            entity: `${apiEntity.name}`,
+            action: 'load',
+            match: {
+                id: `\`dm$=p.${model.NAME}_TEST_${apiEntity.NAME}_ENTID.${apiEntity.name}01\``
+            },
+            valid: {
+                '`$OPEN`': true,
+                id: `\`dm$=s.${name}.match.id\``
+            }
+        });
+    }
+    if (apiEntity.op.update && apiEntity.op.load) {
+        num++;
+        name = `update_${apiEntity.name}${num}`;
+        const id = idmap[`${apiEntity.name}01`];
+        const loadref = `load_${apiEntity.name}${num - 1}`;
+        const reqdata = makeUpdateData(name, apiEntity, flow, id);
+        const valid = makeUpdateValid(name, apiEntity, flow, id, reqdata);
+        steps.push({
+            name,
+            ref: loadref,
+            action: 'update',
+            reqdata,
+            valid: {
+                '`$OPEN`': true,
+                id: `\`dm$=s.${loadref}.match.id\``,
+                ...valid
+            }
+        });
+        num++;
+        name = `load_${apiEntity.name}${num}`;
+        steps.push({
+            name,
+            kind: 'entity',
+            entity: `${apiEntity.name}`,
+            action: 'load',
+            match: {
+                id: `\`dm$=p.${model.NAME}_TEST_${apiEntity.NAME}_ENTID.${apiEntity.name}01\``
+            },
+            valid: {
+                '`$OPEN`': true,
+                id: `\`dm$=s.${loadref}.match.id\``,
+                ...valid
+            }
+        });
+    }
+    return flow;
+}
+function makeUpdateData(name, apiEntity, flow, id) {
+    const ud = {};
+    const data = flow.model.test.entity[apiEntity.Name];
+    const dataFields = (0, jostraca_1.each)(apiEntity.field).filter(f => 'id' !== f.name && !f.name.includes('_id'));
+    const stringFields = (0, jostraca_1.each)(dataFields).filter(f => 'string' === f.type);
+    if (0 < (0, struct_1.size)(stringFields)) {
+        const f = stringFields[0];
+        ud[f.name] = data[id][f.name] + '-`$WHEN`';
+    }
+    return ud;
+}
+function makeUpdateValid(name, apiEntity, flow, id, reqdata) {
+    const vd = {};
+    (0, jostraca_1.each)(reqdata, (n) => {
+        vd[n.key$] = `\`dm$=s.${name}.reqdata.${n.key$}\``;
+    });
+    return vd;
+}
+//# sourceMappingURL=flowHeuristic01.js.map

package/dist/builder/flow/flowHeuristic01.js.map

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

package/dist/builder/flow.d.ts

@@ -0,0 +1,2 @@
+declare function makeFlowBuilder(ctx: any): Promise<() => void>;
+export { makeFlowBuilder };

package/dist/builder/flow.js

@@ -0,0 +1,41 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.makeFlowBuilder = makeFlowBuilder;
+const node_path_1 = __importDefault(require("node:path"));
+const jostraca_1 = require("jostraca");
+const utility_1 = require("../utility");
+const flowHeuristic01_1 = require("./flow/flowHeuristic01");
+async function makeFlowBuilder(ctx) {
+    let flows = [];
+    if ('heuristic01' === ctx.opts.strategy) {
+        flows = await (0, flowHeuristic01_1.flowHeuristic01)(ctx);
+    }
+    else {
+        throw new Error('Unknown guide strategy: ' + ctx.opts.strategy);
+    }
+    return function flowBuilder() {
+        (0, jostraca_1.Folder)({ name: 'flow' }, () => {
+            const barrel = [
+                '# Flows\n'
+            ];
+            (0, jostraca_1.each)(flows, (flow) => {
+                let flowfile = node_path_1.default.join(ctx.opts.folder, 'flow', (null == ctx.opts.outprefix ? '' : ctx.opts.outprefix) +
+                    flow.Name + 'Flow.jsonic');
+                let flowModelSrc = (0, utility_1.formatJsonSrc)(JSON.stringify(flow.model, null, 2));
+                let flowsrc = `# ${flow.Name}Flow
+
+main: sdk: flow: ${flow.Name}Flow:
+` + flowModelSrc;
+                barrel.push(`@"${node_path_1.default.basename(flowfile)}"`);
+                (0, jostraca_1.File)({ name: node_path_1.default.basename(flowfile) }, () => (0, jostraca_1.Content)(flowsrc));
+            });
+            (0, jostraca_1.File)({
+                name: (null == ctx.opts.outprefix ? '' : ctx.opts.outprefix) + 'flow-index.jsonic'
+            }, () => (0, jostraca_1.Content)(barrel.join('\n')));
+        });
+    };
+}
+//# sourceMappingURL=flow.js.map

package/dist/builder/flow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow.js","sourceRoot":"","sources":["../../src/builder/flow.ts"],"names":[],"mappings":";;;;;AA0DE,0CAAe;AAzDjB,0DAA4B;AAE5B,uCAAsD;AAEtD,wCAEmB;AAGnB,4DAAwD;AAGxD,KAAK,UAAU,eAAe,CAAC,GAAQ;IACrC,IAAI,KAAK,GAAU,EAAE,CAAA;IAErB,IAAI,aAAa,KAAK,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACxC,KAAK,GAAG,MAAM,IAAA,iCAAe,EAAC,GAAG,CAAC,CAAA;IACpC,CAAC;SACI,CAAC;QACJ,MAAM,IAAI,KAAK,CAAC,0BAA0B,GAAG,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;IACjE,CAAC;IAED,OAAO,SAAS,WAAW;QAEzB,IAAA,iBAAM,EAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE;YAC5B,MAAM,MAAM,GAAG;gBACb,WAAW;aACZ,CAAA;YAED,IAAA,eAAI,EAAC,KAAK,EAAE,CAAC,IAAS,EAAE,EAAE;gBACxB,IAAI,QAAQ,GACV,mBAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,EAC/B,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC;oBACtD,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC,CAAA;gBAE9B,IAAI,YAAY,GAAG,IAAA,uBAAa,EAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAA;gBAErE,IAAI,OAAO,GAAG,KAAK,IAAI,CAAC,IAAI;;mBAEjB,IAAI,CAAC,IAAI;CAC3B,GAAG,YAAY,CAAA;gBAER,MAAM,CAAC,IAAI,CAAC,KAAK,mBAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAA;gBAE5C,IAAA,eAAI,EAAC,EAAE,IAAI,EAAE,mBAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,IAAA,kBAAO,EAAC,OAAO,CAAC,CAAC,CAAA;YACjE,CAAC,CAAC,CAAA;YAEF,IAAA,eAAI,EAAC;gBACH,IAAI,EAAE,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,mBAAmB;aACnF,EAAE,GAAG,EAAE,CAAC,IAAA,kBAAO,EAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACtC,CAAC,CAAC,CAAA;IACJ,CAAC,CAAA;AACH,CAAC"}

package/dist/guide/heuristic01.d.ts

@@ -0,0 +1,2 @@
+declare function heuristic01(ctx: any): Promise<Record<string, any>>;
+export { heuristic01 };

package/dist/guide/heuristic01.js

@@ -0,0 +1,178 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.heuristic01 = heuristic01;
+const jostraca_1 = require("jostraca");
+async function heuristic01(ctx) {
+    let guide = ctx.model.main.api.guide;
+    const entityDescs = resolveEntityDescs(ctx);
+    // console.log('entityDescs')
+    // console.dir(entityDescs, { depth: null })
+    guide = {
+        control: guide.control,
+        entity: entityDescs,
+    };
+    return guide;
+}
+const METHOD_IDOP = {
+    get: 'load',
+    post: 'create',
+    put: 'update',
+    patch: 'update',
+    delete: 'remove',
+};
+function resolveEntityDescs(ctx) {
+    const entityDescs = {};
+    const paths = ctx.def.paths;
+    (0, jostraca_1.each)(paths, (pathdef, pathname) => {
+        // look for rightmmost /entname/{entid}
+        const m = pathname.match(/\/([a-zA-Z0-1_-]+)\/\{([a-zA-Z0-1_-]+)\}$/);
+        if (m) {
+            let origentname = (0, jostraca_1.snakify)(m[1]);
+            let entname = depluralize(origentname);
+            let entdesc = (entityDescs[entname] = entityDescs[entname] || { name: entname });
+            entdesc.plural = origentname;
+            (0, jostraca_1.names)(entdesc, entname);
+            entdesc.alias = entdesc.alias || {};
+            if ('id' != m[2]) {
+                entdesc.alias.id = m[2];
+                entdesc.alias[m[2]] = 'id';
+            }
+            entdesc.path = (entdesc.path || {});
+            const op = {};
+            entdesc.path[pathname] = { op };
+            (0, jostraca_1.each)(pathdef, (mdef, method) => {
+                const opname = METHOD_IDOP[method];
+                if (null == opname)
+                    return;
+                const transform = {
+                // reqform: '`reqdata`',
+                // resform: '`body`',
+                };
+                const resokdef = mdef.responses[200] || mdef.responses[201];
+                const resbody = resokdef?.content?.['application/json']?.schema;
+                if (resbody) {
+                    if (resbody[origentname]) {
+                        // TODO: use quotes when @voxgig/struct updated to support them
+                        // transform.resform = '`body."'+origentname+'"`'
+                        transform.resform = '`body.' + origentname + '`';
+                    }
+                    else if (resbody[entname]) {
+                        transform.resform = '`body.' + entname + '`';
+                    }
+                }
+                const reqdef = mdef.requestBody?.content?.['application/json']?.schema?.properties;
+                if (reqdef) {
+                    if (reqdef[origentname]) {
+                        transform.reqform = { [origentname]: '`reqdata`' };
+                    }
+                    else if (reqdef[entname]) {
+                        transform.reqform = { [entname]: '`reqdata`' };
+                    }
+                }
+                op[opname] = {
+                    // TODO: in actual guide, remove "standard" method ops since redundant
+                    method,
+                };
+                if (0 < Object.entries(transform).length) {
+                    op[opname].transform = transform;
+                }
+            });
+        }
+    });
+    (0, jostraca_1.each)(paths, (pathdef, pathname) => {
+        // look for rightmmost /entname/{entid}
+        const m = pathname.match(/\/([a-zA-Z0-1_-]+)$/);
+        if (m) {
+            let origentname = (0, jostraca_1.snakify)(m[1]);
+            let entname = depluralize(origentname);
+            let entdesc = entityDescs[entname];
+            if (entdesc) {
+                entdesc.path = (entdesc.path || {});
+                if (pathdef.get) {
+                    const op = { list: { method: 'get' } };
+                    entdesc.path[pathname] = { op };
+                    const transform = {};
+                    const mdef = pathdef.get;
+                    const resokdef = mdef.responses[200] || mdef.responses[201];
+                    const resbody = resokdef?.content?.['application/json']?.schema;
+                    if (resbody) {
+                        if (resbody[origentname]) {
+                            // TODO: use quotes when @voxgig/struct updated to support them
+                            // transform.resform = '`body."'+origentname+'"`'
+                            transform.resform = '`body.' + origentname + '`';
+                        }
+                        else if (resbody[entname]) {
+                            transform.resform = '`body.' + entname + '`';
+                        }
+                    }
+                    if (0 < Object.entries(transform).length) {
+                        op.transform = transform;
+                    }
+                }
+            }
+        }
+    });
+    return entityDescs;
+}
+function depluralize(word) {
+    if (!word || word.length === 0) {
+        return word;
+    }
+    // Common irregular plurals
+    const irregulars = {
+        'children': 'child',
+        'men': 'man',
+        'women': 'woman',
+        'teeth': 'tooth',
+        'feet': 'foot',
+        'geese': 'goose',
+        'mice': 'mouse',
+        'people': 'person',
+        'data': 'datum',
+        'criteria': 'criterion',
+        'phenomena': 'phenomenon',
+        'indices': 'index',
+        'matrices': 'matrix',
+        'vertices': 'vertex',
+        'analyses': 'analysis',
+        'axes': 'axis',
+        'crises': 'crisis',
+        'diagnoses': 'diagnosis',
+        'oases': 'oasis',
+        'theses': 'thesis',
+        'appendices': 'appendix'
+    };
+    if (irregulars[word]) {
+        return irregulars[word];
+    }
+    // Rules for regular plurals (applied in order)
+    // -ies -> -y (cities -> city)
+    if (word.endsWith('ies') && word.length > 3) {
+        return word.slice(0, -3) + 'y';
+    }
+    // -ves -> -f or -fe (wolves -> wolf, knives -> knife)
+    if (word.endsWith('ves')) {
+        const stem = word.slice(0, -3);
+        // Check if it should be -fe (like knife, wife, life)
+        if (['kni', 'wi', 'li'].includes(stem)) {
+            return stem + 'fe';
+        }
+        return stem + 'f';
+    }
+    // -oes -> -o (potatoes -> potato)
+    if (word.endsWith('oes')) {
+        return word.slice(0, -2);
+    }
+    // -ses, -xes, -zes, -shes, -ches -> remove -es (boxes -> box)
+    if (word.endsWith('ses') || word.endsWith('xes') || word.endsWith('zes') ||
+        word.endsWith('shes') || word.endsWith('ches')) {
+        return word.slice(0, -2);
+    }
+    // -s -> remove -s (cats -> cat)
+    if (word.endsWith('s') && !word.endsWith('ss')) {
+        return word.slice(0, -1);
+    }
+    // If none of the rules apply, return as is
+    return word;
+}
+//# sourceMappingURL=heuristic01.js.map

package/dist/guide/heuristic01.js.map

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

package/dist/guide.d.ts

@@ -0,0 +1,2 @@
+declare function resolveGuide(ctx: any): Promise<() => void>;
+export { resolveGuide };

package/dist/guide.js

@@ -0,0 +1,62 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveGuide = resolveGuide;
+const node_path_1 = __importDefault(require("node:path"));
+const jostraca_1 = require("jostraca");
+const heuristic01_1 = require("./guide/heuristic01");
+async function resolveGuide(ctx) {
+    // console.log('GUIDE CTX', ctx)
+    let guide = ctx.model.main.api.guide;
+    if ('heuristic01' === ctx.opts.strategy) {
+        guide = await (0, heuristic01_1.heuristic01)(ctx);
+    }
+    else {
+        throw new Error('Unknown guide strategy: ' + ctx.opts.strategy);
+    }
+    guide = cleanGuide(guide);
+    ctx.model.main.api.guide = guide;
+    const guideFile = node_path_1.default.join(ctx.opts.folder, (null == ctx.opts.outprefix ? '' : ctx.opts.outprefix) + 'guide.jsonic');
+    const guideBlocks = [
+        '# Guide',
+        '',
+        'main: api: guide: { ',
+        '',
+    ];
+    guideBlocks.push(...(0, jostraca_1.each)(guide.entity, (entity, entityname) => {
+        guideBlocks.push(`\nentity: ${entityname}: path: {`);
+        (0, jostraca_1.each)(entity.path, (path, pathname) => {
+            guideBlocks.push(`  '${pathname}': op: {`);
+            (0, jostraca_1.each)(path.op, (op, opname) => {
+                guideBlocks.push(`    '${opname}': method: ${op.method}`);
+                if (op.transform?.reqform) {
+                    guideBlocks.push(`    '${opname}': transform: reqform: ${JSON.stringify(op.transform.reqform)}`);
+                }
+            });
+            guideBlocks.push(`  }`);
+        });
+        guideBlocks.push(`}`);
+    }));
+    guideBlocks.push('}');
+    const guideSrc = guideBlocks.join('\n');
+    // console.log(guideSrc)
+    return () => {
+        (0, jostraca_1.File)({ name: node_path_1.default.basename(guideFile) }, () => (0, jostraca_1.Content)(guideSrc));
+    };
+}
+function cleanGuide(guide) {
+    const clean = {
+        control: guide.control,
+        entity: {}
+    };
+    (0, jostraca_1.each)(guide.entity, (entity, name) => {
+        let ent = clean.entity[name] = clean.entity[name] = { name, path: {} };
+        (0, jostraca_1.each)(entity.path, (path, pathname) => {
+            ent.path[pathname] = path;
+        });
+    });
+    return clean;
+}
+//# sourceMappingURL=guide.js.map

package/dist/guide.js.map

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

package/dist/parse.d.ts

@@ -1,2 +1,2 @@
-declare function parse(kind: string, source: any): Promise<any>;
+declare function parse(kind: string, source: any, meta?: any): Promise<any>;
 export { parse };

package/dist/parse.js

@@ -3,16 +3,17 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.parse = parse;
 const openapi_core_1 = require("@redocly/openapi-core");
-async function parse(kind, source) {
+// Parse an API definition source into a JSON sructure.
+async function parse(kind, source, meta) {
     if ('OpenAPI' === kind) {
-        return parseOpenAPI(source);
+        return parseOpenAPI(source, meta);
     }
     else {
         throw new Error('@voxgig/apidef-parse: unknown kind: ' + kind);
     }
 }
-async function parseOpenAPI(source) {
-    const config = await (0, openapi_core_1.createConfig)({});
+async function parseOpenAPI(source, meta) {
+    const config = await (0, openapi_core_1.createConfig)(meta?.config || {});
     let bundle;
     bundle = await (0, openapi_core_1.bundleFromString)({
         source,

package/dist/parse.js.map

@@ -1 +1 @@
-{"version":3,"file":"parse.js","sourceRoot":"","sources":["../src/parse.ts"],"names":[],"mappings":";AAAA,4CAA4C;;AAgC1C,sBAAK;AA9BP,wDAAsE;AAGtE,KAAK,UAAU,KAAK,CAAC,IAAY,EAAE,MAAW;IAC5C,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;QACvB,OAAO,YAAY,CAAC,MAAM,CAAC,CAAA;IAC7B,CAAC;SACI,CAAC;QACJ,MAAM,IAAI,KAAK,CAAC,sCAAsC,GAAG,IAAI,CAAC,CAAA;IAChE,CAAC;AACH,CAAC;AAGD,KAAK,UAAU,YAAY,CAAC,MAAW;IACrC,MAAM,MAAM,GAAG,MAAM,IAAA,2BAAY,EAAC,EAAE,CAAC,CAAA;IACrC,IAAI,MAAM,CAAA;IAEV,MAAM,GAAG,MAAM,IAAA,+BAAgB,EAAC;QAC9B,MAAM;QACN,MAAM;QACN,WAAW,EAAE,IAAI;KAClB,CAAC,CAAA;IAEF,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAA;IAEhC,OAAO,GAAG,CAAA;AACZ,CAAC"}
+{"version":3,"file":"parse.js","sourceRoot":"","sources":["../src/parse.ts"],"names":[],"mappings":";AAAA,4CAA4C;;AAkC1C,sBAAK;AAhCP,wDAAsE;AAItE,uDAAuD;AACvD,KAAK,UAAU,KAAK,CAAC,IAAY,EAAE,MAAW,EAAE,IAAU;IACxD,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;QACvB,OAAO,YAAY,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;IACnC,CAAC;SACI,CAAC;QACJ,MAAM,IAAI,KAAK,CAAC,sCAAsC,GAAG,IAAI,CAAC,CAAA;IAChE,CAAC;AACH,CAAC;AAGD,KAAK,UAAU,YAAY,CAAC,MAAW,EAAE,IAAU;IACjD,MAAM,MAAM,GAAG,MAAM,IAAA,2BAAY,EAAC,IAAI,EAAE,MAAM,IAAI,EAAE,CAAC,CAAA;IACrD,IAAI,MAAM,CAAA;IAEV,MAAM,GAAG,MAAM,IAAA,+BAAgB,EAAC;QAC9B,MAAM;QACN,MAAM;QACN,WAAW,EAAE,IAAI;KAClB,CAAC,CAAA;IAEF,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAA;IAEhC,OAAO,GAAG,CAAA;AACZ,CAAC"}

package/dist/resolver.d.ts

@@ -0,0 +1,2 @@
+declare function resolveElements(ctx: any, kind: string, subkind: string, standard: Record<string, any>): Promise<any>;
+export { resolveElements, };

package/dist/resolver.js

@@ -0,0 +1,62 @@
+"use strict";
+/* Copyright (c) 2024-2025 Voxgig, MIT License */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveElements = resolveElements;
+const node_path_1 = __importDefault(require("node:path"));
+async function resolveElements(ctx, kind, subkind, standard) {
+    const { log, model } = ctx;
+    // TODO: model access should be via a utility that generates
+    // useful errors when the target is missing
+    const control = model.main.api.guide.control[kind][subkind];
+    const target = kind + '.' + subkind;
+    const elementNames = control.order
+        .split(/\s*,\s*/)
+        .map((t) => t.trim())
+        .filter((elem) => '' != elem);
+    log.info({
+        point: 'element', note: target + ': order: ' + elementNames.join(';'),
+        order: elementNames
+    });
+    const elementResults = [];
+    for (const en of elementNames) {
+        log.debug({ point: 'element', note: target + ': ' + en });
+        const element = await resolveElement(en, control, target, standard, ctx);
+        const result = await element(ctx);
+        elementResults.push(result);
+    }
+    return elementResults;
+}
+async function resolveElement(en, control, target, standard, ctx) {
+    const { log } = ctx;
+    let element = standard[en];
+    if (element) {
+        return element;
+    }
+    const elemdef = control.element[en];
+    if (null == elemdef) {
+        const err = new Error('Unknown element: ' + en);
+        log.error({ what: 'element', element: target + ': ' + en, fail: 'unknown', err });
+        throw err;
+    }
+    if (!en.startsWith('custom')) {
+        const err = new Error('Custom element name must start with "custom": ' + en);
+        log.error({ what: 'element', element: target + ': ' + en, fail: 'prefix', err });
+        throw err;
+    }
+    const customtpath = node_path_1.default.join(ctx.defpath, elemdef.load);
+    try {
+        const elementModule = require(customtpath);
+        element = elementModule[en];
+    }
+    catch (e) {
+        const err = new Error('Custom element not found: ' +
+            customtpath + ': ' + e.message);
+        log.error({ what: 'element', element: target + ': ' + en, fail: 'require', err });
+        throw err;
+    }
+    return element;
+}
+//# sourceMappingURL=resolver.js.map

package/dist/resolver.js.map

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

package/dist/transform/entity.js

@@ -3,12 +3,14 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.entityTransform = void 0;
 const jostraca_1 = require("jostraca");
 const transform_1 = require("../transform");
-const entityTransform = async function (ctx, guide, tspec, model, def) {
+const entityTransform = async function (ctx) {
+    const { apimodel, model, def } = ctx;
+    const guide = model.main.api.guide;
     let msg = '';
     (0, jostraca_1.each)(guide.entity, (guideEntity) => {
         const entityName = guideEntity.key$;
         ctx.log.debug({ point: 'guide-entity', note: entityName });
-        const entityModel = model.main.api.entity[entityName] = {
+        const entityModel = apimodel.main.api.entity[entityName] = {
             op: {},
             field: {},
             cmd: {},

package/dist/transform/entity.js.map

@@ -1 +1 @@
-{"version":3,"file":"entity.js","sourceRoot":"","sources":["../../src/transform/entity.ts"],"names":[],"mappings":";;;AAEA,uCAA+B;AAI/B,4CAAsC;AAGtC,MAAM,eAAe,GAAc,KAAK,WACtC,GAAiB,EACjB,KAAY,EACZ,KAAoB,EACpB,KAAU,EACV,GAAQ;IAER,IAAI,GAAG,GAAG,EAAE,CAAA;IAEZ,IAAA,eAAI,EAAC,KAAK,CAAC,MAAM,EAAE,CAAC,WAAgB,EAAE,EAAE;QACtC,MAAM,UAAU,GAAG,WAAW,CAAC,IAAI,CAAA;QACnC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAA;QAE1D,MAAM,WAAW,GAAQ,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG;YAC3D,EAAE,EAAE,EAAE;YACN,KAAK,EAAE,EAAE;YACT,GAAG,EAAE,EAAE;YACP,EAAE,EAAE;gBACF,IAAI,EAAE,IAAI;gBACV,KAAK,EAAE,IAAI;aACZ;SACF,CAAA;QAED,IAAA,mBAAO,EAAC,WAAW,EAAE,WAAW,CAAC,IAAI,CAAC,CAAA;QAEtC,IAAA,eAAI,EAAC,WAAW,CAAC,IAAI,EAAE,CAAC,SAAc,EAAE,EAAE;YACxC,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAA;YAC3B,MAAM,OAAO,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;YAE/B,IAAI,IAAI,IAAI,OAAO,EAAE,CAAC;gBACpB,MAAM,IAAI,KAAK,CAAC,6BAA6B,GAAG,IAAI;oBAClD,YAAY,GAAG,WAAW,CAAC,IAAI,GAAG,GAAG,CAAC,CAAA;YAC1C,CAAC;YAED,wBAAwB;YACxB,SAAS,CAAC,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;YAClC,SAAS,CAAC,OAAO,GAAG,SAAS,CAAC,MAAM;iBACjC,MAAM,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;iBACxC,GAAG,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAA;QAErD,CAAC,CAAC,CAAA;QAEF,GAAG,IAAI,WAAW,CAAC,IAAI,GAAG,GAAG,CAAA;IAC/B,CAAC,CAAC,CAAA;IAEF,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,CAAA;AAC1B,CAAC,CAAA;AAIC,0CAAe"}
+{"version":3,"file":"entity.js","sourceRoot":"","sources":["../../src/transform/entity.ts"],"names":[],"mappings":";;;AAEA,uCAA+B;AAI/B,4CAAsC;AAGtC,MAAM,eAAe,GAAc,KAAK,WACtC,GAAQ;IAMR,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,GAAG,CAAA;IACpC,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAA;IAElC,IAAI,GAAG,GAAG,EAAE,CAAA;IAEZ,IAAA,eAAI,EAAC,KAAK,CAAC,MAAM,EAAE,CAAC,WAAgB,EAAE,EAAE;QACtC,MAAM,UAAU,GAAG,WAAW,CAAC,IAAI,CAAA;QACnC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAA;QAE1D,MAAM,WAAW,GAAQ,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG;YAC9D,EAAE,EAAE,EAAE;YACN,KAAK,EAAE,EAAE;YACT,GAAG,EAAE,EAAE;YACP,EAAE,EAAE;gBACF,IAAI,EAAE,IAAI;gBACV,KAAK,EAAE,IAAI;aACZ;SACF,CAAA;QAED,IAAA,mBAAO,EAAC,WAAW,EAAE,WAAW,CAAC,IAAI,CAAC,CAAA;QAEtC,IAAA,eAAI,EAAC,WAAW,CAAC,IAAI,EAAE,CAAC,SAAc,EAAE,EAAE;YACxC,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAA;YAC3B,MAAM,OAAO,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;YAE/B,IAAI,IAAI,IAAI,OAAO,EAAE,CAAC;gBACpB,MAAM,IAAI,KAAK,CAAC,6BAA6B,GAAG,IAAI;oBAClD,YAAY,GAAG,WAAW,CAAC,IAAI,GAAG,GAAG,CAAC,CAAA;YAC1C,CAAC;YAED,wBAAwB;YACxB,SAAS,CAAC,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;YAClC,SAAS,CAAC,OAAO,GAAG,SAAS,CAAC,MAAM;iBACjC,MAAM,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;iBACxC,GAAG,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAA;QAErD,CAAC,CAAC,CAAA;QAEF,GAAG,IAAI,WAAW,CAAC,IAAI,GAAG,GAAG,CAAA;IAC/B,CAAC,CAAC,CAAA;IAEF,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,CAAA;AAC1B,CAAC,CAAA;AAIC,0CAAe"}