@voxgig/apidef 2.4.0 → 3.0.2

package/dist/builder/flow/flowHeuristic01.js

@@ -3,6 +3,9 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.flowHeuristic01 = flowHeuristic01;
 const struct_1 = require("@voxgig/struct");
 const jostraca_1 = require("jostraca");
+const struct_2 = require("@voxgig/struct");
+const types_1 = require("../../types");
+const utility_1 = require("../../utility");
 async function flowHeuristic01(ctx) {
     let entity = ctx.guide.entity;
     const flows = [];
@@ -13,9 +16,10 @@ async function flowHeuristic01(ctx) {
 }
 function resolveBasicEntityFlow(ctx, entity) {
     const { apimodel, model } = ctx;
-    const apiEntity = apimodel.main.api.entity[entity.name];
+    const kit = apimodel.main[types_1.KIT];
+    const apiEntity = kit.entity[entity.name];
     const flow = {
-        name: 'Basic' + apiEntity.Name + 'Flow'
+        name: 'Basic' + (0, utility_1.nom)(apiEntity, 'Name') + 'Flow'
     };
     const refs = [
         `${apiEntity.name}01`,
@@ -27,7 +31,7 @@ function resolveBasicEntityFlow(ctx, entity) {
         name: flow.name,
         active: true,
         param: {
-            [`${model.NAME}_TEST_${apiEntity.NAME}_ENTID`]: idmap,
+            [`${model.NAME}_TEST_${(0, utility_1.nom)(apiEntity, 'NAME')}_ENTID`]: idmap,
             [`${model.NAME}_TEST_LIVE`]: "FALSE",
             [`${model.NAME}_TEST_EXPLAIN`]: "FALSE",
         },
@@ -39,8 +43,8 @@ function resolveBasicEntityFlow(ctx, entity) {
     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) => {
+        let num = (i * (0, struct_1.size)(apiEntity.fields) * 10);
+        (0, jostraca_1.each)(apiEntity.fields, (field) => {
             ent[field.name] =
                 'number' === field.type ? num :
                     'boolean' === field.type ? 0 === num % 2 :
@@ -55,9 +59,11 @@ function resolveBasicEntityFlow(ctx, entity) {
     let num = 0;
     let name;
     const am = {};
-    if (apiEntity.op.load) {
+    const entop = apiEntity.op ?? {};
+    if (entop.load) {
+        const alt = findMainLoadAlt(entop.load);
         // Get additional required match properties
-        (0, jostraca_1.each)(apiEntity.op.load.param, (param) => {
+        (0, jostraca_1.each)(alt?.args.param, (param) => {
             if (param.required) {
                 let ancestorName = param.name;
                 let ancestorEntity = apimodel.main.api.entity[ancestorName];
@@ -71,7 +77,7 @@ function resolveBasicEntityFlow(ctx, entity) {
                     };
                     am[param.name] =
                         `\`dm$=p.${model.NAME}_TEST_${ancestorEntity.NAME}_ENTID.${ancestorEntity.name}01\``;
-                    data[`${apiEntity.NAME}01`][param.name] = ancestorEntity.NAME + '01';
+                    data[`${(0, utility_1.nom)(apiEntity, 'NAME')}01`][param.name] = ancestorEntity.NAME + '01';
                 }
             }
         });
@@ -82,7 +88,7 @@ function resolveBasicEntityFlow(ctx, entity) {
             entity: `${apiEntity.name}`,
             action: 'load',
             match: {
-                id: `\`dm$=p.${model.NAME}_TEST_${apiEntity.NAME}_ENTID.${apiEntity.name}01\``,
+                id: `\`dm$=p.${model.NAME}_TEST_${(0, utility_1.nom)(apiEntity, 'NAME')}_ENTID.${apiEntity.name}01\``,
                 ...am,
             },
             valid: {
@@ -92,7 +98,7 @@ function resolveBasicEntityFlow(ctx, entity) {
             }
         });
     }
-    if (apiEntity.op.update && apiEntity.op.load) {
+    if (entop.update && entop.load) {
         num++;
         name = `update_${apiEntity.name}${num}`;
         const id = idmap[`${apiEntity.name}01`];
@@ -119,7 +125,7 @@ function resolveBasicEntityFlow(ctx, entity) {
             entity: `${apiEntity.name}`,
             action: 'load',
             match: {
-                id: `\`dm$=p.${model.NAME}_TEST_${apiEntity.NAME}_ENTID.${apiEntity.name}01\``,
+                id: `\`dm$=p.${model.NAME}_TEST_${(0, utility_1.nom)(apiEntity, 'NAME')}_ENTID.${apiEntity.name}01\``,
                 ...am,
             },
             valid: {
@@ -132,6 +138,10 @@ function resolveBasicEntityFlow(ctx, entity) {
     }
     return flow;
 }
+function findMainLoadAlt(op) {
+    let cands = op.alts.filter(a => '{id}' === (0, struct_2.getelem)(a.parts, -1));
+    return cands[0];
+}
 function makeUpdateData(name, apiEntity, flow, id) {
     const ud = {};
     const data = flow.model.test.entity[apiEntity.name];

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

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

package/dist/builder/flow.d.ts

@@ -1,2 +1,3 @@
-declare function makeFlowBuilder(ctx: any): Promise<() => void>;
+import { ApiDefContext } from '../types';
+declare function makeFlowBuilder(ctx: ApiDefContext): Promise<Function>;
 export { makeFlowBuilder };

package/dist/builder/flow.js

@@ -1,4 +1,5 @@
 "use strict";
+// TODO: move this to sdkgen
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
@@ -6,17 +7,40 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.makeFlowBuilder = makeFlowBuilder;
 const node_path_1 = __importDefault(require("node:path"));
 const jostraca_1 = require("jostraca");
+const types_1 = require("../types");
 const utility_1 = require("../utility");
 const flowHeuristic01_1 = require("./flow/flowHeuristic01");
 async function makeFlowBuilder(ctx) {
     let flows = [];
+    let flowBuilder = () => {
+        ctx.warn({
+            step: 'flow',
+            note: 'Unable to generate flow definitions as flows were not resolved.'
+        });
+    };
     if ('heuristic01' === ctx.opts.strategy) {
-        flows = await (0, flowHeuristic01_1.flowHeuristic01)(ctx);
+        try {
+            flows = await (0, flowHeuristic01_1.flowHeuristic01)(ctx);
+        }
+        catch (err) {
+            err.foo = { x: 1, y: [2] };
+            err.foo.z = err.foo;
+            ctx.warn({
+                step: 'flow',
+                note: 'Unable to resolve flows due to unexpected error: ' + err.message,
+                err,
+            });
+            return flowBuilder;
+        }
     }
     else {
-        throw new Error('Unknown guide strategy: ' + ctx.opts.strategy);
+        ctx.warn({
+            step: 'flow',
+            note: 'Unable to resolve flows: unknown guide strategy: ' + ctx.opts.strategy
+        });
+        return flowBuilder;
     }
-    return function flowBuilder() {
+    flowBuilder = () => {
         (0, jostraca_1.Folder)({ name: 'flow' }, () => {
             const barrel = [
                 '# Flows\n'
@@ -27,7 +51,7 @@ async function makeFlowBuilder(ctx) {
                 let flowModelSrc = (0, utility_1.formatJsonSrc)(JSON.stringify(flow.model, null, 2));
                 let flowsrc = `# ${flow.Name}
 
-main: sdk: flow: ${flow.Name}:
+main: ${types_1.KIT}: flow: ${flow.Name}:
 ` + 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));
@@ -37,5 +61,6 @@ main: sdk: flow: ${flow.Name}:
             }, () => (0, jostraca_1.Content)(barrel.join('\n')));
         });
     };
+    return flowBuilder;
 }
 //# sourceMappingURL=flow.js.map

package/dist/builder/flow.js.map

@@ -1 +1 @@
-{"version":3,"file":"flow.js","sourceRoot":"","sources":["../../src/builder/flow.ts"],"names":[],"mappings":";;;;;AA2DE,0CAAe;AA1DjB,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;IAGD,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,SAAS,CAAC,CAAA;gBAE1B,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"}
+{"version":3,"file":"flow.js","sourceRoot":"","sources":["../../src/builder/flow.ts"],"names":[],"mappings":"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"}

package/dist/def.d.ts

@@ -0,0 +1,62 @@
+type PathDef = {
+    summary?: string;
+    description?: string;
+    get?: MethodDef;
+    put?: MethodDef;
+    post?: MethodDef;
+    delete?: MethodDef;
+    options?: MethodDef;
+    head?: MethodDef;
+    patch?: MethodDef;
+    trace?: MethodDef;
+    servers?: ServerDef[];
+    parameters?: ParameterDef[];
+    tags?: any;
+};
+type MethodDef = {
+    tags?: string[];
+    summary?: string;
+    description?: string;
+    operationId?: string;
+    parameters?: ParameterDef[];
+    deprecated?: boolean;
+    servers?: ServerDef[];
+};
+type ServerDef = {
+    url: string;
+    description?: string;
+    variables?: Record<string, ServerVariableDef>;
+};
+type ServerVariableDef = {
+    enum?: string[];
+    default: string;
+    description?: string;
+};
+type ParameterDef = {
+    name: string;
+    in: "query" | "header" | "path" | "cookie";
+    description?: string;
+    required?: boolean;
+    deprecated?: boolean;
+    schema?: SchemaDef;
+    nullable?: boolean;
+    example?: any;
+};
+type SchemaDef = {
+    title?: string;
+    description?: string;
+    type?: string;
+    format?: string;
+    enum?: any[];
+    items?: SchemaDef;
+    properties?: Record<string, SchemaDef>;
+    required?: string[];
+    additionalProperties?: boolean | SchemaDef;
+    allOf?: SchemaDef[];
+    oneOf?: SchemaDef[];
+    anyOf?: SchemaDef[];
+    nullable?: boolean;
+    default?: any;
+    example?: any;
+};
+export type { PathDef, MethodDef, ServerDef, ServerVariableDef, ParameterDef, SchemaDef, };

package/dist/def.js

@@ -0,0 +1,4 @@
+"use strict";
+/* Copyright (c) 2024-2025 Voxgig, MIT License */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=def.js.map

package/dist/def.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"def.js","sourceRoot":"","sources":["../src/def.ts"],"names":[],"mappings":";AAAA,iDAAiD"}

package/dist/desc.d.ts

@@ -0,0 +1,89 @@
+import type { PathMatch } from './utility';
+import type { MethodName } from './types';
+import type { ParameterDef } from './def';
+type GuidePathRename = {
+    param?: Record<string, string>;
+};
+type GuideOp = {
+    method: MethodName;
+};
+type GuidePath = {
+    rename?: GuidePathRename;
+    op?: Record<string, GuideOp>;
+};
+type CmpDesc = {
+    namedesc?: any;
+    path_rate: number;
+    method_rate: number;
+};
+type BasicMethodDesc = {
+    name: MethodName;
+    def: Record<string, any>;
+    path: string;
+};
+type MethodDesc = {
+    path: string;
+    method: string;
+    summary: string;
+    tags: string[];
+    parameters: any[];
+    responses: Record<string, any>;
+    requestBody: Record<string, any>;
+    MethodEntity: MethodEntityDesc;
+};
+type MethodEntityDesc = {
+    ref: string;
+    cmp: string | null;
+    origcmp: string | null;
+    origcmpref: string | null;
+    why_cmp: string[];
+    cmpoccur: number;
+    path_rate: number;
+    method_rate: number;
+    entname: string;
+    why_op: string[];
+    rename: Record<string, any>;
+    why_rename: Record<string, any>;
+    rename_orig: string[];
+    opname: string;
+    why_opname: string[];
+    pm?: any;
+};
+type EntityDesc = {
+    name: string;
+    origname: string;
+    plural: string;
+    path: Record<string, EntityPathDesc>;
+    alias: Record<string, string>;
+    cmp: CmpDesc;
+};
+type EntityPathDesc = {
+    op: Record<string, any>;
+    pm: PathMatch;
+    rename: {
+        param: Record<string, string>;
+    };
+    why_rename: {
+        why_param: Record<string, string[]>;
+    };
+    action: Record<string, {
+        why_action: string[];
+    }>;
+    why_action: Record<string, string[]>;
+    why_ent: string[];
+    why_path: string[];
+};
+type PathDesc = {
+    orig: string;
+    method: MethodName;
+    parts: string[];
+    rename: GuidePathRename;
+    op: GuidePath["op"];
+    def: {
+        parameters?: ParameterDef[];
+    };
+};
+type OpDesc = {
+    paths: PathDesc[];
+};
+export type { GuidePathRename, GuideOp, GuidePath, CmpDesc, BasicMethodDesc, MethodDesc, MethodEntityDesc, EntityDesc, EntityPathDesc, PathDesc, OpDesc, };

package/dist/desc.js

@@ -0,0 +1,4 @@
+"use strict";
+/* Copyright (c) 2024-2025 Voxgig, MIT License */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=desc.js.map

package/dist/desc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"desc.js","sourceRoot":"","sources":["../src/desc.ts"],"names":[],"mappings":";AAAA,iDAAiD"}

package/dist/guide/guide.d.ts

@@ -1,2 +1,3 @@
-declare function buildGuide(ctx: any): Promise<any>;
+import { ApiDefContext } from '../types';
+declare function buildGuide(ctx: ApiDefContext): Promise<any>;
 export { buildGuide };

package/dist/guide/guide.js

@@ -12,11 +12,11 @@ const heuristic01_1 = require("./heuristic01");
 const utility_1 = require("../utility");
 // Log non-fatal wierdness.
 const dlog = (0, utility_1.getdlog)('apidef', __filename);
+const aontu = new aontu_1.Aontu();
 async function buildGuide(ctx) {
+    const log = ctx.log;
     const errs = [];
-    // console.log(ctx)
     const folder = node_path_1.default.resolve(ctx.opts.folder);
-    // console.log('GUIDE folder', folder)
     try {
         const basejres = await buildBaseGuide(ctx);
     }
@@ -25,61 +25,126 @@ async function buildGuide(ctx) {
     }
     handleErrors(ctx, errs);
     let src = '';
-    let guidePath = node_path_1.default.join(folder, 'guide', (null == ctx.opts.outprefix ? '' : ctx.opts.outprefix) + 'guide.jsonic');
+    let guidepath = node_path_1.default.join(folder, 'guide', (null == ctx.opts.outprefix ? '' : ctx.opts.outprefix) + 'guide.jsonic');
+    log.info({
+        point: 'generate-guide',
+        note: guidepath.replace(process.cwd(), '.'),
+        guidepath,
+    });
     try {
-        src = ctx.fs.readFileSync(guidePath, 'utf8');
+        src = ctx.fs.readFileSync(guidepath, 'utf8');
     }
     catch (err) {
         errs.push(err);
     }
     handleErrors(ctx, errs);
-    const opts = {
-        path: guidePath
-    };
-    const guideRoot = (0, aontu_1.Aontu)(src, opts);
-    errs.push(...guideRoot.err);
-    handleErrors(ctx, errs);
-    let genctx = new aontu_1.Context({ root: guideRoot });
-    const guideModel = guideRoot.gen(genctx);
-    errs.push(...genctx.err);
-    handleErrors(ctx, errs);
-    return guideModel;
+    if (0 === errs.length) {
+        const opts = {
+            path: guidepath,
+            fs: ctx.fs,
+            errs,
+        };
+        const guideModel = aontu.generate(src, opts);
+        // console.log('GUIDE-MODEL', guideModel, errs)
+        // console.dir(guideModel, { depth: null })
+        handleErrors(ctx, errs);
+        return guideModel;
+    }
 }
 function handleErrors(ctx, errs) {
     if (0 < errs.length) {
-        let topmsg = [];
+        const topmsg = [];
+        const stacks = [];
         for (let err of errs) {
-            topmsg.push((err?.message?.split('\n')[0]) || '');
-            ctx.log.error({ err });
+            err = err instanceof Error ? err :
+                err.err instanceof Error ? err.err :
+                    Array.isArray(err.err) && null != err.err[0] ? err.err[0] :
+                        err;
+            const msg = 'string' === typeof err?.message ? err.message :
+                err instanceof Error ? err.message : '' + err;
+            topmsg.push(msg);
+            stacks.push('' + err.stack);
         }
-        throw new Error('SUMMARY: ' + topmsg.join('; '));
+        const summary = new Error(`SUMMARY (${errs.length} errors): ` + topmsg.join(' | '));
+        summary.stack = stacks.join('\n');
+        ctx.log.error(summary);
+        summary.errs = () => errs;
+        throw summary;
     }
 }
 async function buildBaseGuide(ctx) {
-    let baseguide = {};
+    let baseguide;
     if ('heuristic01' === ctx.opts.strategy) {
         baseguide = await (0, heuristic01_1.heuristic01)(ctx);
     }
     else {
         throw new Error('Unknown guide strategy: ' + ctx.opts.strategy);
     }
+    // console.dir(baseguide, { depth: null })
     const guideBlocks = [
         '# Guide',
         '',
         'guide: {',
     ];
-    (0, struct_1.items)(baseguide.entity).map(([entityname, entity]) => {
+    const metrics = baseguide.metrics;
+    // TODO: these should influence the IS_ENTCMP_METHOD_RATE etc. values
+    const epr = 0 < metrics.count.path ? (metrics.count.entity / metrics.count.path).toFixed(3) : -1;
+    const emr = 0 < metrics.count.method ? (metrics.count.entity / metrics.count.method).toFixed(3) : -1;
+    ctx.log.info({
+        point: 'metrics',
+        metrics,
+        note: `epr=${epr}  emr=${emr}  ` +
+            `(entity=${metrics.count.entity} ` +
+            `paths=${metrics.count.path} methods=${metrics.count.method})`
+    });
+    validateBaseBuide(ctx, baseguide);
+    const sw = (s) => ctx.opts.why?.show ? s : '';
+    const qs = (v) => JSON.stringify(v);
+    const qt = (v) => '(' + qs(v) + ')';
+    guideBlocks.push(`  metrics: count: entity: ${metrics.count.entity}
+  metrics: count: path: ${metrics.count.path}
+  metrics: count: method: ${metrics.count.method}`);
+    // NOTE: items(...) sorts the iteration elements, so the generated model code
+    // is deterministic.
+    (0, struct_1.items)(baseguide.entity).map(([entname, entity]) => {
         guideBlocks.push(`
-  entity: ${entityname}: {` +
-            (0 < entity.why_name.length ? ' # name:' + entity.why_name.join(';') : ''));
-        (0, struct_1.items)(entity.path).map(([pathname, path]) => {
-            guideBlocks.push(`    path: '${pathname}': op: {` +
-                (0 < path.why_ent.length ? ' # ent:' + path.why_ent.join(';') : ''));
+  entity: ${entname}: {`
+        // sw(0 < entity.why_name.length ? '  # name:' + entity.why_name.join(';') : '')
+        );
+        // NOTE: items(...) sorts the paths
+        (0, struct_1.items)(entity.path).map(([pathstr, path]) => {
+            (0, utility_1.debugpath)(pathstr, null, 'BASE-GUIDE', entname, pathstr, (0, utility_1.formatJSONIC)(path, { hsepd: 0, $: true, color: true }));
+            guideBlocks.push(`    path: ${qs(pathstr)}: {` +
+                sw(0 < path.why_path.length ?
+                    '  # ent=' + entname + ';' +
+                        (entity.orig !== entname && null != entity.orig ? 'orig=' + entity.orig + ';' : '') +
+                        path.why_path.join(';') : ''));
+            if (!(0, struct_1.isempty)(path.action)) {
+                (0, struct_1.items)(path.action).map(([actname, actdesc]) => {
+                    guideBlocks.push(`      action: ${qs(actname)}: {}` +
+                        sw(0 < actdesc.why_action.length ?
+                            '  # ' + actdesc.why_action.join(';') : ''));
+                });
+            }
+            if (!(0, struct_1.isempty)(path.rename?.param)) {
+                (0, struct_1.items)(path.rename.param).map(([psrc, rp]) => {
+                    guideBlocks.push(`      rename: param: ${qs(psrc)}: *${qs(rp.target)}` +
+                        sw(0 < rp.why_rename.length ?
+                            '  # ' + rp.why_rename.join(';') : ''));
+                });
+            }
             (0, struct_1.items)(path.op).map(([opname, op]) => {
-                guideBlocks.push(`      '${opname}': method: ${op.method}` +
-                    (0 < op.why_op.length ? ' # ' + op.why_op : ''));
-                if (op.transform?.reqform) {
-                    guideBlocks.push(`      '${opname}': transform: reqform: ${JSON.stringify(op.transform.reqform)}`);
+                guideBlocks.push(`      op: ${opname}: method: *${op.method}` +
+                    sw(0 < op.why_op.length ? '  # ' + op.why_op : ''));
+                if (null != op.transform.req) {
+                    guideBlocks.push(
+                    // `      op: ${opname}: transform: res: *${qt(op.transform.res)}|top`)
+                    `      op: ${opname}: transform: res: *${qt(op.transform.res)}|top`);
+                }
+                if (null != op.transform.res) {
+                    guideBlocks.push(
+                    // `      op: ${opname}: transform: res: *${qt(op.transform.res)}|top`)
+                    `      op: ${opname}: transform: res: *${qt(op.transform.res)}|top`);
                 }
             });
             guideBlocks.push(`    }`);
@@ -104,4 +169,70 @@ async function buildBaseGuide(ctx) {
     }, root);
     return jres;
 }
+function validateBaseBuide(ctx, baseguide) {
+    const srcm = {};
+    // Each orig path.
+    (0, jostraca_1.each)(ctx.def.paths, (pdef) => {
+        const pathStr = pdef.key$;
+        // Each orig method.
+        (0, jostraca_1.each)(pdef, (mdef) => {
+            if (mdef.key$.match(/^get|post|put|patch|delete|head|options$/i)) {
+                let key = pathStr + ' ' + mdef.key$.toUpperCase();
+                let desc = (srcm[key] = (srcm[key] || { c: 0 }));
+                desc.c++;
+            }
+        });
+    });
+    const genm = {};
+    // Each entity.
+    (0, jostraca_1.each)(baseguide.entity, (entm) => {
+        if ((0, struct_1.isempty)(entm.path)) {
+            ctx.warn({
+                note: `No paths defined for entity=${entm.name}`,
+                entm,
+            });
+        }
+        // Each path.
+        (0, jostraca_1.each)(entm.path, (pathm, pathStr) => {
+            if ((0, struct_1.isempty)(pathm.op)) {
+                ctx.warn({
+                    note: `No operations defined for entity=${entm.name} path=${pathStr}`,
+                    path: pathStr,
+                    entm,
+                    pathm,
+                });
+            }
+            // Each op.
+            (0, jostraca_1.each)(pathm.op, (odef) => {
+                let key = pathStr + ' ' + odef.method;
+                let desc = (genm[key] = (genm[key] || { c: 0 }));
+                desc.c++;
+            });
+        });
+    });
+    const srcp = Object.keys(srcm).sort()
+        .reduce((a, k) => (a.push(k + ':c=' + srcm[k].c), a), []);
+    const genp = Object.keys(genm).sort()
+        .reduce((a, k) => (a.push(k + ':c=' + genm[k].c), a), []);
+    // Check that all paths have been assigned to entities.
+    if (srcp.join(';') !== genp.join(';')) {
+        console.log('     ', 'SRC-PATH'.padEnd(60, ' '), 'GEN-PATH');
+        for (let i = 0, j = 0; i < srcp.length || j < genp.length; i++, j++) {
+            let srcps = srcp[i];
+            let genps = genp[j];
+            let prefix = '     ';
+            if (srcps !== genps) {
+                prefix = ' *** ';
+                if (srcps === genp[j + 1]) {
+                    j++;
+                }
+                else if (genps === srcp[i + 1]) {
+                    i++;
+                }
+            }
+            console.log(prefix, srcps.padEnd(60, ' '), genps);
+        }
+        throw new Error('PATH MISMATCH');
+    }
+}
 //# sourceMappingURL=guide.js.map