@voxgig/sdkgen 4.34.0 → 4.34.1

package/dist/helpers/generated.js

@@ -0,0 +1,363 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GENERATED_LOG = void 0;
+exports.readGenerated = readGenerated;
+exports.claimedFiles = claimedFiles;
+exports.pruneGenerated = pruneGenerated;
+const node_path_1 = __importDefault(require("node:path"));
+const copies_1 = require("../action/copies");
+const component_1 = require("./component");
+// Every file each generate run emitted, by output root: the only record that
+// tells a file the model stopped producing from one nothing generated.
+const GENERATED_LOG = 'log/generated.jsonl';
+exports.GENERATED_LOG = GENERATED_LOG;
+// Every list a run's result can name a file in.
+const EMITTED = [
+    'written', 'unchanged', 'merged', 'presented', 'diffed', 'preserved', 'conflicted',
+];
+// jostraca leaves a file holding this marker as it is.
+const PROTECT = 'JOSTRACA_PROTECT';
+const SHOWN = 5;
+function logPath(project) {
+    return node_path_1.default.join(project, '.sdk', ...GENERATED_LOG.split('/'));
+}
+// The record is read as untrusted: a line that does not parse as an entry is
+// skipped rather than failing the run, and pruning checks each path again.
+function readGenerated(fs, project) {
+    const record = {};
+    const path = logPath(project);
+    if (!fs.existsSync(path)) {
+        return record;
+    }
+    for (const line of String(fs.readFileSync(path, 'utf8')).split('\n')) {
+        const entry = parseEntry(line);
+        if (null == entry) {
+            continue;
+        }
+        const files = record[entry.root] ?? (record[entry.root] = new Map());
+        for (const [rel, owner] of Object.entries(entry.files)) {
+            if ('string' === typeof owner) {
+                files.set(rel, owner);
+            }
+            else if (null === owner) {
+                files.delete(rel);
+            }
+        }
+    }
+    return record;
+}
+function parseEntry(line) {
+    if ('' === line.trim()) {
+        return undefined;
+    }
+    try {
+        const entry = JSON.parse(line);
+        return 'string' === typeof entry?.root &&
+            null != entry.files && 'object' === typeof entry.files ? entry : undefined;
+    }
+    catch (err) {
+        return undefined;
+    }
+}
+// A path jostraca reported or a claim names, relative to the root with
+// forward slashes, or undefined outside it. Such a path is absolute, or
+// relative to the working directory when the output folder is.
+function inside(root, path) {
+    return under(root, node_path_1.default.resolve(path));
+}
+// A recorded path, relative to the root it was recorded under.
+function canonical(root, rel) {
+    return under(root, node_path_1.default.resolve(root, rel));
+}
+function under(root, abs) {
+    const rel = node_path_1.default.relative(node_path_1.default.resolve(root), abs).split(node_path_1.default.sep).join('/');
+    return ('' === rel || '..' === rel || rel.startsWith('../') || node_path_1.default.isAbsolute(rel)) ?
+        undefined : rel;
+}
+function rootKey(project, out) {
+    return node_path_1.default.relative(node_path_1.default.resolve(project), node_path_1.default.resolve(out))
+        .split(node_path_1.default.sep).join('/') || '.';
+}
+function within(out, paths, outside) {
+    const found = new Set();
+    for (const path of paths) {
+        const rel = inside(out, path);
+        if (null == rel) {
+            outside.add(path);
+        }
+        else if (!rel.startsWith('.jostraca/')) {
+            found.add(rel);
+        }
+    }
+    return found;
+}
+// Every path a save decided on, written or not. A file jostraca declined to
+// write, protected or by its `existing` option, is in no result list.
+function savedPaths(jres) {
+    const audit = 'function' === typeof jres?.audit ? jres.audit() : [];
+    return (Array.isArray(audit) ? audit : [])
+        .map((entry) => entry?.[1])
+        .filter((meta) => 'string' === typeof meta?.action && 'string' === typeof meta?.path)
+        .map((meta) => meta.path);
+}
+// Each File node's output path, written or not, and each Inject's target. A
+// file written only when absent is the project's once it exists, and an
+// Inject edits a region of a file it does not own, so neither is ever the
+// record's. A Copy's files are owned by the scope that copied them, found by
+// destination, as the tree holds no node per copied file.
+function claimedFiles(node, folder) {
+    const claims = { files: {}, once: [], injected: [], copies: [], scopes: [] };
+    claimTree(node, folder, [], '', claims);
+    return claims;
+}
+// `base` follows the folder stack jostraca builds from Project and Folder
+// nodes; a component's own `name` prop joins its path but makes no folder.
+function claimTree(node, base, chain, owner, claims) {
+    if (null == node) {
+        return;
+    }
+    const name = node.meta?.[component_1.COMPONENT];
+    if ('string' === typeof name && '' !== name) {
+        chain = [...chain, name];
+        owner = chain.join('/') + (0 < (node.path?.length ?? 0) ? '@' + node.path.join('/') : '');
+        claims.scopes.push(owner);
+    }
+    if ('project' === node.kind && 'string' === typeof node.folder) {
+        base = node.folder;
+    }
+    else if ('folder' === node.kind && 'string' === typeof node.name) {
+        base = base + '/' + node.name;
+    }
+    else if ('copy' === node.kind) {
+        claims.copies.push({
+            to: 'string' === typeof node.name ? base + '/' + node.name : base, owner,
+        });
+    }
+    else if ('string' === typeof node.fullpath) {
+        if ('file' === node.kind) {
+            claims.files[node.fullpath] = owner;
+            if (writtenOnce(node)) {
+                claims.once.push(node.fullpath);
+            }
+        }
+        else if ('inject' === node.kind) {
+            claims.injected.push(node.fullpath);
+        }
+    }
+    for (const child of node.children ?? []) {
+        claimTree(child, base, chain, owner, claims);
+    }
+}
+// As jostraca's FileOp reads `exclude` for an existing file.
+function writtenOnce(node) {
+    const exclude = node.exclude;
+    return true === exclude ||
+        ('string' === typeof exclude ? [exclude] : Array.isArray(exclude) ? exclude : [])
+            .includes(node.path?.join('/'));
+}
+// The owner of an emitted file: its File claim, else the deepest Copy whose
+// destination holds it, else '' for a file no scope accounts for.
+function claimOwners(out, claims, outside) {
+    const files = new Map();
+    for (const [path, owner] of Object.entries(claims?.files ?? {})) {
+        const rel = inside(out, path);
+        if (null != rel) {
+            files.set(rel, owner);
+        }
+    }
+    const copies = [];
+    for (const copy of claims?.copies ?? []) {
+        const prefix = node_path_1.default.resolve(copy.to) === node_path_1.default.resolve(out) ? '' : inside(out, copy.to);
+        if (null == prefix) {
+            outside.add(copy.to);
+        }
+        else {
+            copies.push({ prefix, owner: copy.owner });
+        }
+    }
+    return (rel) => {
+        const direct = files.get(rel);
+        if (null != direct) {
+            return direct;
+        }
+        let best;
+        for (const copy of copies) {
+            if (('' === copy.prefix || rel === copy.prefix || rel.startsWith(copy.prefix + '/')) &&
+                (null == best || best.prefix.length < copy.prefix.length)) {
+                best = copy;
+            }
+        }
+        return best?.owner ?? '';
+    };
+}
+function isFile(fs, abs) {
+    try {
+        return fs.lstatSync(abs).isFile();
+    }
+    catch (err) {
+        return undefined;
+    }
+}
+function protectedFile(fs, abs) {
+    try {
+        return fs.readFileSync(abs).includes(PROTECT);
+    }
+    catch (err) {
+        return false;
+    }
+}
+// Whether a directory between `out` and the file is a symbolic link, through
+// which a delete could leave the root.
+function linked(fs, out, rel) {
+    let at = node_path_1.default.resolve(out);
+    for (const name of rel.split('/').slice(0, -1)) {
+        at = node_path_1.default.join(at, name);
+        try {
+            if (fs.lstatSync(at).isSymbolicLink()) {
+                return true;
+            }
+        }
+        catch (err) {
+            return false;
+        }
+    }
+    return false;
+}
+function removeEmptyDirs(fs, out, abs) {
+    const top = node_path_1.default.resolve(out);
+    let dir = node_path_1.default.dirname(abs);
+    while (dir !== top && null != inside(top, dir)) {
+        try {
+            if (0 < fs.readdirSync(dir).length) {
+                return;
+            }
+            fs.rmdirSync(dir);
+        }
+        catch (err) {
+            return;
+        }
+        dir = node_path_1.default.dirname(dir);
+    }
+}
+// Why a recorded file this run did not emit is not this record's to delete.
+function keptBecause(fs, out, rel, folded) {
+    const abs = node_path_1.default.resolve(out, rel);
+    return folded.has(rel.toLowerCase()) ? 'a generated file has its name in another case' :
+        linked(fs, out, rel) ? 'a folder above it is a symbolic link' :
+            true !== isFile(fs, abs) ? 'it is not a plain file' :
+                protectedFile(fs, abs) ? 'it carries the ' + PROTECT + ' marker' :
+                    undefined;
+}
+function shown(paths) {
+    return paths.slice(0, SHOWN).join(', ') + (SHOWN < paths.length ? ', ...' : '');
+}
+// After a run into `out`: delete each recorded file this run did not emit
+// whose scope ran again, then record what changed. The first run into a root
+// prunes nothing. A file whose scope did not run (a target or a phase
+// switched off), one jostraca saw and declined to write, and one carrying
+// the protect marker are left as they are.
+function pruneGenerated(ctx) {
+    const { fs, log, out } = ctx;
+    const root = rootKey(ctx.project, out);
+    const record = readGenerated(fs, ctx.project);
+    const known = record[root];
+    const outside = new Set();
+    const emitted = within(out, EMITTED.flatMap((list) => ctx.jres?.files?.[list] ?? []), outside);
+    const seen = within(out, savedPaths(ctx.jres), outside);
+    const declared = within(out, Object.keys(ctx.claims?.files ?? {}), outside);
+    const once = within(out, ctx.claims?.once ?? [], outside);
+    const injected = within(out, ctx.claims?.injected ?? [], outside);
+    const ownerOf = claimOwners(out, ctx.claims, outside);
+    const scopes = new Set(ctx.claims?.scopes ?? []);
+    if (0 < outside.size) {
+        const paths = Array.from(outside).sort();
+        log.warn({ point: 'generate-record-outside', folder: out, files: paths,
+            note: paths.length + ' path(s) resolve outside ' + out +
+                ', so they are not recorded: ' + shown(paths) });
+    }
+    for (const rel of once) {
+        emitted.delete(rel);
+    }
+    for (const rel of injected) {
+        if (!declared.has(rel)) {
+            emitted.delete(rel);
+        }
+    }
+    const folded = new Set(Array.from(emitted).map((rel) => rel.toLowerCase()));
+    const files = {};
+    const pruned = [];
+    const unowned = [];
+    for (const rel of emitted) {
+        const owner = ownerOf(rel);
+        if ('' === owner) {
+            unowned.push(rel);
+        }
+        if (known?.get(rel) !== owner) {
+            files[rel] = owner;
+        }
+    }
+    if (0 < unowned.length) {
+        unowned.sort();
+        log.warn({ point: 'generate-record-unowned', folder: out, files: unowned,
+            note: unowned.length + ' generated file(s) came from no component made with ' +
+                'sdkgen\'s cmp, so they are recorded but never removed: ' + shown(unowned) });
+    }
+    for (const [rel, owner] of known ?? []) {
+        if (emitted.has(rel) || seen.has(rel) || declared.has(rel) || injected.has(rel) ||
+            canonical(out, rel) !== rel) {
+            continue;
+        }
+        if (!fs.existsSync(node_path_1.default.resolve(out, rel))) {
+            files[rel] = null;
+            continue;
+        }
+        if (!scopes.has(owner)) {
+            continue;
+        }
+        const why = keptBecause(fs, out, rel, folded);
+        if (null == why) {
+            pruned.push(rel);
+        }
+        else {
+            log.warn({ point: 'generate-prune-kept', file: rel,
+                note: 'kept ' + rel + ', no longer generated: ' + why });
+        }
+        files[rel] = null;
+    }
+    pruned.sort();
+    for (const rel of pruned) {
+        log.info({ point: 'generate-prune', file: rel,
+            note: (ctx.dryrun ? 'would remove ' : 'removed ') + rel + ', no longer generated' });
+        if (!ctx.dryrun) {
+            const abs = node_path_1.default.resolve(out, rel);
+            fs.unlinkSync(abs);
+            removeEmptyDirs(fs, out, abs);
+        }
+    }
+    if (!ctx.dryrun && 0 < Object.keys(files).length) {
+        appendEntry(ctx, root, files, null == known);
+    }
+    return pruned;
+}
+function appendEntry(ctx, root, files, fresh) {
+    const { fs } = ctx;
+    const path = logPath(ctx.project);
+    const sorted = Object.fromEntries(Object.keys(files).sort().map((rel) => [rel, files[rel]]));
+    const firstlog = !fs.existsSync(path);
+    fs.mkdirSync(node_path_1.default.dirname(path), { recursive: true });
+    fs.appendFileSync(path, JSON.stringify({
+        at: new Date(ctx.jres?.when ?? Date.now()).toISOString(),
+        op: fresh ? 'record' : 'generate',
+        root,
+        files: sorted,
+    }) + '\n');
+    if (firstlog && (0, copies_1.ignoredLog)(fs, node_path_1.default.join(ctx.project, '.sdk'))) {
+        ctx.log.warn({ point: 'generate-log-ignored', note: '.sdk/.gitignore ignores ' +
+                'log/, so .sdk/' + GENERATED_LOG + ' is not committed and a fresh clone ' +
+                'cannot prune what an earlier run generated. Delete the log/ line.' });
+    }
+}
+//# sourceMappingURL=generated.js.map

package/dist/helpers/generated.js.map

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

package/dist/helpers/mcpTools.d.ts

@@ -0,0 +1,11 @@
+import type { ModelEntity, SdkModel } from '../types';
+type McpTool = {
+    op: string;
+    name: string;
+    entities: ModelEntity[];
+};
+declare const MCP_READ_OPS: string[];
+declare const MCP_WRITE_OPS: string[];
+declare function mcpTools(model: SdkModel, target?: string): McpTool[];
+export type { McpTool, };
+export { mcpTools, MCP_READ_OPS, MCP_WRITE_OPS, };

package/dist/helpers/mcpTools.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MCP_WRITE_OPS = exports.MCP_READ_OPS = void 0;
+exports.mcpTools = mcpTools;
+const jostraca_1 = require("jostraca");
+const apidef_1 = require("@voxgig/apidef");
+const opShape_1 = require("./opShape");
+const MCP_READ_OPS = ['list', 'load'];
+exports.MCP_READ_OPS = MCP_READ_OPS;
+const MCP_WRITE_OPS = ['create', 'update', 'patch', 'remove'];
+exports.MCP_WRITE_OPS = MCP_WRITE_OPS;
+// The tools the go-mcp server registers, each for the entities a plain call of
+// its operation runs on, in name order. A tool no entity can serve is left
+// out. The write tools need the target's `tool.write`.
+function mcpTools(model, target = 'go-mcp') {
+    const write = true === model.main?.[apidef_1.KIT]?.target?.[target]?.tool?.write;
+    const slug = String(model.name ?? '').toLowerCase();
+    const entities = (0, jostraca_1.each)((0, apidef_1.getModelPath)(model, `main.${apidef_1.KIT}.entity`) || {})
+        .filter((ent) => null != ent && false !== ent.active);
+    return [...MCP_READ_OPS, ...(write ? MCP_WRITE_OPS : [])]
+        .map((op) => ({
+        op,
+        name: slug + '_' + op,
+        entities: entities.filter((ent) => (0, opShape_1.entityOps)(ent).includes(op)),
+    }))
+        .filter((tool) => 0 < tool.entities.length);
+}
+//# sourceMappingURL=mcpTools.js.map

package/dist/helpers/mcpTools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcpTools.js","sourceRoot":"","sources":["../../src/helpers/mcpTools.ts"],"names":[],"mappings":";;;QA2CE,QAAQ;AA3CV,uCAA+B;AAC/B,2CAAkD;AAIlD,uCAAqC;AAUrC,MAAM,YAAY,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;QA6BnC,YAAY;AA5Bd,MAAM,aAAa,GAAG,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAA;QA6B3D,aAAa;AA1Bf,+EAA+E;AAC/E,2EAA2E;AAC3E,uDAAuD;AACvD,SAAS,QAAQ,CAAC,KAAe,EAAE,MAAM,GAAW,QAAQ;IAC1D,MAAM,KAAK,GAAG,IAAI,KAAK,KAAK,CAAC,IAAI,EAAE,CAAC,YAAG,CAAC,EAAE,MAAM,EAAE,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,KAAK,CAAA;IACvE,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAA;IACnD,MAAM,QAAQ,GAAkB,IAAA,eAAI,EAAC,IAAA,qBAAY,EAAC,KAAK,EAAE,QAAQ,YAAG,SAAS,CAAC,IAAI,EAAE,CAAC;SAClF,MAAM,CAAC,CAAC,GAAgB,EAAE,EAAE,CAAC,IAAI,IAAI,GAAG,IAAI,KAAK,KAAK,GAAG,CAAC,MAAM,CAAC,CAAA;IAEpE,OAAO,CAAC,GAAG,YAAY,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;SACtD,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;QACZ,EAAE;QACF,IAAI,EAAE,IAAI,GAAG,GAAG,GAAG,EAAE;QACrB,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAA,mBAAS,EAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;KAChE,CAAC,CAAC;SACF,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAA;AAC/C,CAAC"}

package/dist/helpers/media.d.ts

@@ -0,0 +1,9 @@
+declare const RAW_BODY = "$body";
+declare function opRequestBody(op: any): any;
+declare function opRawBody(op: any): any;
+declare function bodyNote(op: any, target: {
+    values: string;
+    once?: string;
+    binary?: boolean;
+}): string;
+export { RAW_BODY, bodyNote, opRawBody, opRequestBody, };

package/dist/helpers/media.js

@@ -0,0 +1,61 @@
+"use strict";
+/* Copyright (c) 2026 Voxgig Ltd, MIT License */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RAW_BODY = void 0;
+exports.bodyNote = bodyNote;
+exports.opRawBody = opRawBody;
+exports.opRequestBody = opRequestBody;
+const jostraca_1 = require("jostraca");
+// A point's `rb` and `rs` reach the generated config as `body` and `response`.
+const RAW_BODY = '$body';
+exports.RAW_BODY = RAW_BODY;
+// The bodies an operation's active points declare that are not JSON.
+function opBodies(op) {
+    const points = op?.points ? (0, jostraca_1.each)(op.points) : [];
+    return points
+        .filter((pt) => false !== pt?.a)
+        .map((pt) => pt?.rb)
+        .filter((rb) => null != rb && 'json' !== rb.kind);
+}
+// A raw body first: it is the one that needs the caller's `$body`.
+function opRequestBody(op) {
+    const bodies = opBodies(op);
+    return bodies.find((rb) => 'raw' === rb.kind) || bodies[0];
+}
+function opRawBody(op) {
+    const rb = opRequestBody(op);
+    return 'raw' === rb?.kind ? rb : undefined;
+}
+function codeList(types) {
+    return types.map((t) => '`' + t + '`').join(', ');
+}
+// The reference note for a body that is not JSON. `values` names what the
+// target accepts as `$body`, `once` the stream among them, which is read in
+// full before the request is sent, and `binary: false` a target without bytes.
+function bodyNote(op, target) {
+    const rb = opRequestBody(op);
+    if (null == rb || 'string' !== typeof rb.media) {
+        return '';
+    }
+    if ('raw' !== rb.kind) {
+        return 'Declares a `' + rb.media + '` body, which this SDK does not encode yet: ' +
+            'it sends the data as JSON.\n\n';
+    }
+    if (true === rb.binary && false === target.binary) {
+        return 'Declares a binary `' + rb.media + '` body, which this SDK cannot send yet.\n\n';
+    }
+    const others = (Array.isArray(rb.alternatives) ? rb.alternatives : [])
+        .map((alt) => alt?.media).filter((m) => 'string' === typeof m);
+    const encoded = opBodies(op).filter((b) => 'raw' !== b.kind)
+        .map((b) => b.media).filter((m) => 'string' === typeof m);
+    return 'Sends its body unencoded, as `' + rb.media + '`: pass it as `' + RAW_BODY +
+        '`, ' + target.values + '.' +
+        (null == target.once ? '' : ' ' + target.once.charAt(0).toUpperCase() + target.once.slice(1) +
+            ' is read in full before the request is sent, so that a retry sends the same bytes.') +
+        (0 < others.length ? ' The operation also accepts ' + codeList(others) +
+            ': a `content-type` header option that is not JSON replaces the declared one.' : '') +
+        (0 < encoded.length ? ' Its other endpoints declare ' + codeList(encoded) +
+            ' bodies, which this SDK sends as JSON.' : '') +
+        '\n\n';
+}
+//# sourceMappingURL=media.js.map

package/dist/helpers/media.js.map

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