arc-1 1.4.0 → 1.5.0

package/dist/adt/lock-object.js

@@ -0,0 +1,195 @@
+import { checkOperation, OperationType } from './safety.js';
+import { escapeXmlAttr, getNestedArray, parseXml } from './xml-parser.js';
+export const LOCKOBJECT_CONTENT_TYPE = 'application/vnd.sap.adt.lockobjects.v1+xml';
+export const LOCKOBJECT_COLLECTION = '/sap/bc/adt/ddic/lockobjects/sources';
+/** Definition defaults: E/S/X, or no lock for a table used only as a foreign-key link. O is runtime-only. */
+export const LOCK_MODES = ['E', 'S', 'X', ''];
+function asRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value)
+        ? value
+        : undefined;
+}
+function text(value) {
+    return value === undefined || value === null ? '' : String(value).trim();
+}
+function parseLockTable(node) {
+    const rec = (node ?? {});
+    return { tableName: text(rec.tableName), lockMode: text(rec.lockMode) };
+}
+/** Parse the `<enqu:lockobject>` metadata document. */
+export function parseLockObject(xml) {
+    const parsed = parseXml(xml);
+    // After NS strip: enqu:lockobject → lockobject
+    const root = asRecord(parsed.lockobject);
+    if (!root)
+        throw new Error('Invalid ENQU response: expected <enqu:lockobject>.');
+    const adtType = text(root['@_type']);
+    if (adtType && adtType !== 'ENQU/DL') {
+        throw new Error(`Invalid ENQU response: expected adtcore:type="ENQU/DL", got "${adtType}".`);
+    }
+    const content = (root.content ?? {});
+    const pkgRef = (root.packageRef ?? {});
+    return {
+        name: text(root['@_name']),
+        description: text(root['@_description']),
+        package: text(pkgRef['@_name']),
+        version: text(root['@_version']),
+        allowRFC: text(content.allowRFC) === 'true',
+        primaryTable: parseLockTable(content.primaryTable),
+        secondaryTables: getNestedArray(content, 'secondaryTables', 'secondaryTable').map(parseLockTable),
+        lockParameters: getNestedArray(content, 'lockParameters', 'lockParameter').map((rec) => ({
+            parameterName: text(rec.parameterName),
+            tableName: text(rec.tableName),
+            fieldName: text(rec.fieldName),
+            parameterWanted: text(rec.parameterWanted) !== 'false',
+        })),
+        lockModules: getNestedArray(content, 'lockModules', 'lockModule')
+            .map((rec) => text(rec['@_name']))
+            .filter(Boolean),
+    };
+}
+/** Read a lock object. Omitting `version` returns SAP's developer view (a pending inactive edit). */
+export async function getLockObject(http, safety, name, version) {
+    checkOperation(safety, OperationType.Read, 'GetLockObject');
+    const query = version ? `?version=${version}` : '';
+    const resp = await http.get(`${LOCKOBJECT_COLLECTION}/${encodeURIComponent(name)}${query}`, {
+        Accept: LOCKOBJECT_CONTENT_TYPE,
+    });
+    return parseLockObject(resp.body);
+}
+const DDIC_NAME_RE = /^(?:\/[A-Z0-9_]+\/)?[A-Z0-9_]+$/;
+/** Keys SAPRead emits that are not writable — accepted (and ignored) so read output round-trips. */
+const READ_ONLY_KEYS = ['name', 'description', 'package', 'version', 'lockModules'];
+const WRITABLE_KEYS = ['allowRFC', 'primaryTable', 'secondaryTables', 'lockParameters'];
+function invalid(message) {
+    return new Error(`Invalid ENQU source: ${message}`);
+}
+function rejectUnknownKeys(rec, allowed, where) {
+    const unknown = Object.keys(rec).filter((key) => !allowed.includes(key));
+    if (unknown.length)
+        throw invalid(`${where}: unknown key(s) ${unknown.map((key) => `"${key}"`).join(', ')}.`);
+}
+function validateName(value, where) {
+    const name = text(value).toUpperCase();
+    if (!name)
+        throw invalid(`${where} is required.`);
+    if (!DDIC_NAME_RE.test(name))
+        throw invalid(`${where} "${text(value)}" is not a valid DDIC name.`);
+    return name;
+}
+function validateLockTable(value, where) {
+    const rec = asRecord(value);
+    if (!rec)
+        throw invalid(`${where} must be an object {"tableName":"…","lockMode":"E"}.`);
+    rejectUnknownKeys(rec, ['tableName', 'lockMode'], where);
+    // Required: a supplied entry replaces the stored one, so a default would silently reset S/X/"".
+    const lockMode = typeof rec.lockMode === 'string' ? rec.lockMode.trim().toUpperCase() : undefined;
+    if (lockMode === undefined || !LOCK_MODES.includes(lockMode)) {
+        throw invalid(`${where}.lockMode ${JSON.stringify(rec.lockMode)} must be one of ${LOCK_MODES.map((mode) => JSON.stringify(mode)).join(', ')}. Optimistic mode O is a runtime option, not a definition default.`);
+    }
+    return { tableName: validateName(rec.tableName, `${where}.tableName`), lockMode };
+}
+function validateBoolean(value, where) {
+    if (typeof value === 'boolean')
+        return value;
+    if (value === 'true' || value === 'false')
+        return value === 'true';
+    throw invalid(`${where} must be true or false.`);
+}
+/**
+ * Parse and validate the JSON definition from SAPWrite "source". Unknown keys are rejected (a typo
+ * such as "primarytable" would otherwise silently keep the stored value); SAPRead's read-only keys
+ * are ignored so its output can be edited and written back unchanged.
+ */
+export function parseLockObjectDefinition(source) {
+    let raw;
+    try {
+        raw = JSON.parse(source);
+    }
+    catch (err) {
+        throw invalid(`expected a JSON object (${err instanceof Error ? err.message : String(err)}).`);
+    }
+    const rec = asRecord(raw);
+    if (!rec)
+        throw invalid('expected a JSON object.');
+    rejectUnknownKeys(rec, [...WRITABLE_KEYS, ...READ_ONLY_KEYS], 'definition');
+    const def = {};
+    if (rec.allowRFC !== undefined)
+        def.allowRFC = validateBoolean(rec.allowRFC, 'allowRFC');
+    if (rec.primaryTable !== undefined)
+        def.primaryTable = validateLockTable(rec.primaryTable, 'primaryTable');
+    if (rec.secondaryTables !== undefined) {
+        if (!Array.isArray(rec.secondaryTables))
+            throw invalid('secondaryTables must be an array.');
+        def.secondaryTables = rec.secondaryTables.map((t, i) => validateLockTable(t, `secondaryTables[${i}]`));
+    }
+    if (rec.lockParameters !== undefined) {
+        if (!Array.isArray(rec.lockParameters))
+            throw invalid('lockParameters must be an array.');
+        def.lockParameters = rec.lockParameters.map((p, i) => {
+            const where = `lockParameters[${i}]`;
+            const prec = asRecord(p);
+            if (!prec)
+                throw invalid(`${where} must be an object.`);
+            rejectUnknownKeys(prec, ['parameterName', 'tableName', 'fieldName', 'parameterWanted'], where);
+            return {
+                parameterName: validateName(prec.parameterName ?? prec.fieldName, `${where}.parameterName`),
+                tableName: validateName(prec.tableName, `${where}.tableName`),
+                fieldName: validateName(prec.fieldName, `${where}.fieldName`),
+                parameterWanted: validateBoolean(prec.parameterWanted, `${where}.parameterWanted`),
+            };
+        });
+    }
+    return def;
+}
+/**
+ * Overlay a (partial) definition on the stored lock object for a full-document PUT. Omitted keys
+ * keep their stored value.
+ *
+ * Changing the table set requires explicit lockParameters: the stored ones name the old tables, and
+ * when an UPDATE sends an empty list SAP re-derives them from the key fields with
+ * parameterWanted=false (live 8.16; a create derives them with true). That would silently produce
+ * ENQUEUE_/DEQUEUE_ modules without key parameters, so we refuse instead of guessing.
+ */
+export function mergeLockObjectDefinition(existing, def) {
+    const primaryTable = def.primaryTable ?? existing.primaryTable;
+    const secondaryTables = def.secondaryTables ?? existing.secondaryTables;
+    const tableKey = (p, s) => [p.tableName, ...s.map((t) => t.tableName)].join(',');
+    const tablesChanged = tableKey(primaryTable, secondaryTables) !== tableKey(existing.primaryTable, existing.secondaryTables);
+    if (def.lockParameters?.length === 0) {
+        throw invalid('"lockParameters": [] is refused on update: SAP re-derives every parameter with parameterWanted=false, ' +
+            'so ENQUEUE_ locks generically. List each parameter; set parameterWanted=false to exclude one.');
+    }
+    if (tablesChanged && def.lockParameters === undefined) {
+        throw invalid('changing primaryTable/secondaryTables requires "lockParameters" for the new tables ' +
+            '(one {"parameterName","tableName","fieldName","parameterWanted"} per key field). ' +
+            'Without them SAP re-derives the parameters with parameterWanted=false.');
+    }
+    return {
+        allowRFC: def.allowRFC ?? existing.allowRFC,
+        primaryTable,
+        secondaryTables,
+        lockParameters: def.lockParameters ?? existing.lockParameters,
+    };
+}
+/**
+ * Build the create/update body. Element order matches SAP's own GET serialization; the read-only
+ * <enqu:lockModules> is omitted (a PUT without it is accepted, live-verified on 8.16).
+ */
+export function buildLockObjectXml(params) {
+    const { definition } = params;
+    if (!definition.primaryTable) {
+        throw invalid('primaryTable is required, e.g. {"primaryTable":{"tableName":"ZMY_TABLE","lockMode":"E"}}.');
+    }
+    const table = (tag, t) => `<enqu:${tag}><enqu:tableName>${escapeXmlAttr(t.tableName)}</enqu:tableName><enqu:lockMode>${escapeXmlAttr(t.lockMode)}</enqu:lockMode></enqu:${tag}>`;
+    const secondary = (definition.secondaryTables ?? []).map((t) => table('secondaryTable', t)).join('');
+    const parameters = (definition.lockParameters ?? [])
+        .map((p) => `<enqu:lockParameter><enqu:parameterWanted>${p.parameterWanted}</enqu:parameterWanted><enqu:parameterName>${escapeXmlAttr(p.parameterName)}</enqu:parameterName><enqu:tableName>${escapeXmlAttr(p.tableName)}</enqu:tableName><enqu:fieldName>${escapeXmlAttr(p.fieldName)}</enqu:fieldName></enqu:lockParameter>`)
+        .join('');
+    return `<?xml version="1.0" encoding="UTF-8"?>
+<enqu:lockobject xmlns:enqu="http://www.sap.com/adt/ddic/enqu" xmlns:adtcore="http://www.sap.com/adt/core" adtcore:type="ENQU/DL" adtcore:name="${escapeXmlAttr(params.name)}" adtcore:description="${escapeXmlAttr(params.description)}" adtcore:masterLanguage="${escapeXmlAttr(params.masterLanguage)}"${params.responsibleAttr}>
+  <adtcore:packageRef adtcore:name="${escapeXmlAttr(params.package)}"/>
+  <enqu:content><enqu:allowRFC>${definition.allowRFC === true}</enqu:allowRFC>${table('primaryTable', definition.primaryTable)}<enqu:secondaryTables>${secondary}</enqu:secondaryTables><enqu:lockParameters>${parameters}</enqu:lockParameters></enqu:content>
+</enqu:lockobject>`;
+}
+//# sourceMappingURL=lock-object.js.map

package/dist/adt/lock-object.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock-object.js","sourceRoot":"","sources":["../../src/adt/lock-object.ts"],"names":[],"mappings":"AAqBA,OAAO,EAAE,cAAc,EAAE,aAAa,EAAqB,MAAM,aAAa,CAAC;AAC/E,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAE1E,MAAM,CAAC,MAAM,uBAAuB,GAAG,4CAA4C,CAAC;AACpF,MAAM,CAAC,MAAM,qBAAqB,GAAG,sCAAsC,CAAC;AAE5E,6GAA6G;AAC7G,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,CAAU,CAAC;AAoCvD,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QACzE,CAAC,CAAE,KAAiC;QACpC,CAAC,CAAC,SAAS,CAAC;AAChB,CAAC;AAED,SAAS,IAAI,CAAC,KAAc;IAC1B,OAAO,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;AAC3E,CAAC;AAED,SAAS,cAAc,CAAC,IAAa;IACnC,MAAM,GAAG,GAAG,CAAC,IAAI,IAAI,EAAE,CAA4B,CAAC;IACpD,OAAO,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;AAC1E,CAAC;AAED,uDAAuD;AACvD,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;IAC7B,+CAA+C;IAC/C,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IACzC,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;IACjF,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;IACrC,IAAI,OAAO,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QACrC,MAAM,IAAI,KAAK,CAAC,gEAAgE,OAAO,IAAI,CAAC,CAAC;IAC/F,CAAC;IACD,MAAM,OAAO,GAAG,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAA4B,CAAC;IAChE,MAAM,MAAM,GAAG,CAAC,IAAI,CAAC,UAAU,IAAI,EAAE,CAA4B,CAAC;IAClE,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC1B,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QACxC,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC/B,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAChC,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,MAAM;QAC3C,YAAY,EAAE,cAAc,CAAC,OAAO,CAAC,YAAY,CAAC;QAClD,eAAe,EAAE,cAAc,CAAC,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC;QACjG,cAAc,EAAE,cAAc,CAAC,OAAO,EAAE,gBAAgB,EAAE,eAAe,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;YACvF,aAAa,EAAE,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC;YACtC,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC;YAC9B,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC;YAC9B,eAAe,EAAE,IAAI,CAAC,GAAG,CAAC,eAAe,CAAC,KAAK,OAAO;SACvD,CAAC,CAAC;QACH,WAAW,EAAE,cAAc,CAAC,OAAO,EAAE,aAAa,EAAE,YAAY,CAAC;aAC9D,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC;aACjC,MAAM,CAAC,OAAO,CAAC;KACnB,CAAC;AACJ,CAAC;AAED,qGAAqG;AACrG,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,IAAmB,EACnB,MAAoB,EACpB,IAAY,EACZ,OAA+B;IAE/B,cAAc,CAAC,MAAM,EAAE,aAAa,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC;IAC5D,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,YAAY,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACnD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,GAAG,qBAAqB,IAAI,kBAAkB,CAAC,IAAI,CAAC,GAAG,KAAK,EAAE,EAAE;QAC1F,MAAM,EAAE,uBAAuB;KAChC,CAAC,CAAC;IACH,OAAO,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,YAAY,GAAG,iCAAiC,CAAC;AACvD,oGAAoG;AACpG,MAAM,cAAc,GAAG,CAAC,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC;AACpF,MAAM,aAAa,GAAG,CAAC,UAAU,EAAE,cAAc,EAAE,iBAAiB,EAAE,gBAAgB,CAAC,CAAC;AAExF,SAAS,OAAO,CAAC,OAAe;IAC9B,OAAO,IAAI,KAAK,CAAC,wBAAwB,OAAO,EAAE,CAAC,CAAC;AACtD,CAAC;AAED,SAAS,iBAAiB,CAAC,GAA4B,EAAE,OAAiB,EAAE,KAAa;IACvF,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;IACzE,IAAI,OAAO,CAAC,MAAM;QAAE,MAAM,OAAO,CAAC,GAAG,KAAK,oBAAoB,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,GAAG,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAChH,CAAC;AAED,SAAS,YAAY,CAAC,KAAc,EAAE,KAAa;IACjD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;IACvC,IAAI,CAAC,IAAI;QAAE,MAAM,OAAO,CAAC,GAAG,KAAK,eAAe,CAAC,CAAC;IAClD,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,MAAM,OAAO,CAAC,GAAG,KAAK,KAAK,IAAI,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAAC;IACnG,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAc,EAAE,KAAa;IACtD,MAAM,GAAG,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC5B,IAAI,CAAC,GAAG;QAAE,MAAM,OAAO,CAAC,GAAG,KAAK,sDAAsD,CAAC,CAAC;IACxF,iBAAiB,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,UAAU,CAAC,EAAE,KAAK,CAAC,CAAC;IACzD,gGAAgG;IAChG,MAAM,QAAQ,GAAG,OAAO,GAAG,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IAClG,IAAI,QAAQ,KAAK,SAAS,IAAI,CAAE,UAAgC,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QACpF,MAAM,OAAO,CACX,GAAG,KAAK,aAAa,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,mBAAmB,UAAU,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,oEAAoE,CAClM,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,SAAS,EAAE,YAAY,CAAC,GAAG,CAAC,SAAS,EAAE,GAAG,KAAK,YAAY,CAAC,EAAE,QAAQ,EAAE,CAAC;AACpF,CAAC;AAED,SAAS,eAAe,CAAC,KAAc,EAAE,KAAa;IACpD,IAAI,OAAO,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IAC7C,IAAI,KAAK,KAAK,MAAM,IAAI,KAAK,KAAK,OAAO;QAAE,OAAO,KAAK,KAAK,MAAM,CAAC;IACnE,MAAM,OAAO,CAAC,GAAG,KAAK,yBAAyB,CAAC,CAAC;AACnD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,yBAAyB,CAAC,MAAc;IACtD,IAAI,GAAY,CAAC;IACjB,IAAI,CAAC;QACH,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC3B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,OAAO,CAAC,2BAA2B,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACjG,CAAC;IACD,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;IAC1B,IAAI,CAAC,GAAG;QAAE,MAAM,OAAO,CAAC,yBAAyB,CAAC,CAAC;IACnD,iBAAiB,CAAC,GAAG,EAAE,CAAC,GAAG,aAAa,EAAE,GAAG,cAAc,CAAC,EAAE,YAAY,CAAC,CAAC;IAC5E,MAAM,GAAG,GAAyB,EAAE,CAAC;IACrC,IAAI,GAAG,CAAC,QAAQ,KAAK,SAAS;QAAE,GAAG,CAAC,QAAQ,GAAG,eAAe,CAAC,GAAG,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IACzF,IAAI,GAAG,CAAC,YAAY,KAAK,SAAS;QAAE,GAAG,CAAC,YAAY,GAAG,iBAAiB,CAAC,GAAG,CAAC,YAAY,EAAE,cAAc,CAAC,CAAC;IAC3G,IAAI,GAAG,CAAC,eAAe,KAAK,SAAS,EAAE,CAAC;QACtC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;YAAE,MAAM,OAAO,CAAC,mCAAmC,CAAC,CAAC;QAC5F,GAAG,CAAC,eAAe,GAAG,GAAG,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,CAAC,EAAE,mBAAmB,CAAC,GAAG,CAAC,CAAC,CAAC;IACzG,CAAC;IACD,IAAI,GAAG,CAAC,cAAc,KAAK,SAAS,EAAE,CAAC;QACrC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;YAAE,MAAM,OAAO,CAAC,kCAAkC,CAAC,CAAC;QAC1F,GAAG,CAAC,cAAc,GAAG,GAAG,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YACnD,MAAM,KAAK,GAAG,kBAAkB,CAAC,GAAG,CAAC;YACrC,MAAM,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;YACzB,IAAI,CAAC,IAAI;gBAAE,MAAM,OAAO,CAAC,GAAG,KAAK,qBAAqB,CAAC,CAAC;YACxD,iBAAiB,CAAC,IAAI,EAAE,CAAC,eAAe,EAAE,WAAW,EAAE,WAAW,EAAE,iBAAiB,CAAC,EAAE,KAAK,CAAC,CAAC;YAC/F,OAAO;gBACL,aAAa,EAAE,YAAY,CAAC,IAAI,CAAC,aAAa,IAAI,IAAI,CAAC,SAAS,EAAE,GAAG,KAAK,gBAAgB,CAAC;gBAC3F,SAAS,EAAE,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,KAAK,YAAY,CAAC;gBAC7D,SAAS,EAAE,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,KAAK,YAAY,CAAC;gBAC7D,eAAe,EAAE,eAAe,CAAC,IAAI,CAAC,eAAe,EAAE,GAAG,KAAK,kBAAkB,CAAC;aACnF,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,yBAAyB,CAAC,QAAwB,EAAE,GAAyB;IAC3F,MAAM,YAAY,GAAG,GAAG,CAAC,YAAY,IAAI,QAAQ,CAAC,YAAY,CAAC;IAC/D,MAAM,eAAe,GAAG,GAAG,CAAC,eAAe,IAAI,QAAQ,CAAC,eAAe,CAAC;IACxE,MAAM,QAAQ,GAAG,CAAC,CAAY,EAAE,CAAc,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACzG,MAAM,aAAa,GACjB,QAAQ,CAAC,YAAY,EAAE,eAAe,CAAC,KAAK,QAAQ,CAAC,QAAQ,CAAC,YAAY,EAAE,QAAQ,CAAC,eAAe,CAAC,CAAC;IACxG,IAAI,GAAG,CAAC,cAAc,EAAE,MAAM,KAAK,CAAC,EAAE,CAAC;QACrC,MAAM,OAAO,CACX,wGAAwG;YACtG,+FAA+F,CAClG,CAAC;IACJ,CAAC;IACD,IAAI,aAAa,IAAI,GAAG,CAAC,cAAc,KAAK,SAAS,EAAE,CAAC;QACtD,MAAM,OAAO,CACX,qFAAqF;YACnF,mFAAmF;YACnF,wEAAwE,CAC3E,CAAC;IACJ,CAAC;IACD,OAAO;QACL,QAAQ,EAAE,GAAG,CAAC,QAAQ,IAAI,QAAQ,CAAC,QAAQ;QAC3C,YAAY;QACZ,eAAe;QACf,cAAc,EAAE,GAAG,CAAC,cAAc,IAAI,QAAQ,CAAC,cAAc;KAC9D,CAAC;AACJ,CAAC;AAaD;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAA2B;IAC5D,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,CAAC;IAC9B,IAAI,CAAC,UAAU,CAAC,YAAY,EAAE,CAAC;QAC7B,MAAM,OAAO,CAAC,2FAA2F,CAAC,CAAC;IAC7G,CAAC;IACD,MAAM,KAAK,GAAG,CAAC,GAAW,EAAE,CAAY,EAAE,EAAE,CAC1C,SAAS,GAAG,oBAAoB,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC,mCAAmC,aAAa,CAAC,CAAC,CAAC,QAAQ,CAAC,0BAA0B,GAAG,GAAG,CAAC;IACzJ,MAAM,SAAS,GAAG,CAAC,UAAU,CAAC,eAAe,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,gBAAgB,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACrG,MAAM,UAAU,GAAG,CAAC,UAAU,CAAC,cAAc,IAAI,EAAE,CAAC;SACjD,GAAG,CACF,CAAC,CAAC,EAAE,EAAE,CACJ,6CAA6C,CAAC,CAAC,eAAe,8CAA8C,aAAa,CAAC,CAAC,CAAC,aAAa,CAAC,wCAAwC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC,oCAAoC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC,wCAAwC,CACrT;SACA,IAAI,CAAC,EAAE,CAAC,CAAC;IACZ,OAAO;kJACyI,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,0BAA0B,aAAa,CAAC,MAAM,CAAC,WAAW,CAAC,6BAA6B,aAAa,CAAC,MAAM,CAAC,cAAc,CAAC,IAAI,MAAM,CAAC,eAAe;sCAC5R,aAAa,CAAC,MAAM,CAAC,OAAO,CAAC;iCAClC,UAAU,CAAC,QAAQ,KAAK,IAAI,mBAAmB,KAAK,CAAC,cAAc,EAAE,UAAU,CAAC,YAAY,CAAC,yBAAyB,SAAS,+CAA+C,UAAU;mBACtM,CAAC;AACpB,CAAC"}

package/dist/adt/rap-generate.d.ts

@@ -31,7 +31,9 @@
  *   failures rethrow.
  */
 import type { AdtClient } from './client.js';
-import { type RapHandlerRequirement } from './rap-handlers.js';
+import type { AdtHttpClient } from './http.js';
+import { type RapHandlerRequirement, type RapHandlerSourceSections } from './rap-handlers.js';
+import { type SafetyConfig } from './safety.js';
 /** Options for `generateBehaviorImplementation`. */
 export interface RapGenerateOptions {
     /** Explicit BDEF name (overrides rootEntityRef auto-discovery). */
@@ -107,4 +109,6 @@ export declare function isRapGenerateResultSuccess(result: RapGenerateResult): b
  * behavior pool class. See module-level docs for the contract.
  */
 export declare function generateBehaviorImplementation(client: AdtClient, className: string, options?: RapGenerateOptions): Promise<RapGenerateResult>;
+/** Read only the three RAP source sections. Serial reads keep one stateful SAP context in order. */
+export declare function readRapClassSources(http: AdtHttpClient, safety: SafetyConfig, name: string): Promise<RapHandlerSourceSections>;
 //# sourceMappingURL=rap-generate.d.ts.map

package/dist/adt/rap-generate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rap-generate.d.ts","sourceRoot":"","sources":["../../src/adt/rap-generate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAI7C,OAAO,EAKL,KAAK,qBAAqB,EAC3B,MAAM,mBAAmB,CAAC;AAE3B,oDAAoD;AACpD,MAAM,WAAW,kBAAkB;IACjC,mEAAmE;IACnE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,wEAAwE;IACxE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,yDAAyD;IACzD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,0CAA0C;AAC1C,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,qCAAqC;IACrC,MAAM,EAAE,eAAe,GAAG,UAAU,CAAC;IACrC,wDAAwD;IACxD,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,qBAAqB;IACpC,iGAAiG;IACjG,oBAAoB,EAAE,OAAO,CAAC;IAC9B,gHAAgH;IAChH,cAAc,EAAE,OAAO,CAAC;IACxB,uEAAuE;IACvE,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,2FAA2F;IAC3F,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,oBAAoB,CAAC;IAChC,UAAU,EAAE,qBAAqB,CAAC;IAClC,sEAAsE;IACtE,eAAe,EAAE,OAAO,CAAC;IACzB,kFAAkF;IAClF,eAAe,EAAE,KAAK,CAAC,MAAM,GAAG,aAAa,GAAG,iBAAiB,CAAC,CAAC;IACnE,qDAAqD;IACrD,QAAQ,EAAE;QACR,UAAU,EAAE,MAAM,CAAC;QACnB,KAAK,EAAE,MAAM,CAAC;QACd,oBAAoB,EAAE,MAAM,CAAC;KAC9B,CAAC;IACF,4EAA4E;IAC5E,QAAQ,EAAE,qBAAqB,EAAE,CAAC;IAClC,wFAAwF;IACxF,UAAU,CAAC,EAAE,qBAAqB,CAAC;IACnC,+DAA+D;IAC/D,MAAM,EAAE,OAAO,CAAC;CACjB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAI7E;AA8CD;;;GAGG;AACH,wBAAsB,8BAA8B,CAClD,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,iBAAiB,CAAC,CAiN5B"}
+{"version":3,"file":"rap-generate.d.ts","sourceRoot":"","sources":["../../src/adt/rap-generate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAI7C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAKL,KAAK,qBAAqB,EAC1B,KAAK,wBAAwB,EAC9B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAiC,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAE/E,oDAAoD;AACpD,MAAM,WAAW,kBAAkB;IACjC,mEAAmE;IACnE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,wEAAwE;IACxE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,yDAAyD;IACzD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,0CAA0C;AAC1C,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,qCAAqC;IACrC,MAAM,EAAE,eAAe,GAAG,UAAU,CAAC;IACrC,wDAAwD;IACxD,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,qBAAqB;IACpC,iGAAiG;IACjG,oBAAoB,EAAE,OAAO,CAAC;IAC9B,gHAAgH;IAChH,cAAc,EAAE,OAAO,CAAC;IACxB,uEAAuE;IACvE,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,2FAA2F;IAC3F,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,oBAAoB,CAAC;IAChC,UAAU,EAAE,qBAAqB,CAAC;IAClC,sEAAsE;IACtE,eAAe,EAAE,OAAO,CAAC;IACzB,kFAAkF;IAClF,eAAe,EAAE,KAAK,CAAC,MAAM,GAAG,aAAa,GAAG,iBAAiB,CAAC,CAAC;IACnE,qDAAqD;IACrD,QAAQ,EAAE;QACR,UAAU,EAAE,MAAM,CAAC;QACnB,KAAK,EAAE,MAAM,CAAC;QACd,oBAAoB,EAAE,MAAM,CAAC;KAC9B,CAAC;IACF,4EAA4E;IAC5E,QAAQ,EAAE,qBAAqB,EAAE,CAAC;IAClC,wFAAwF;IACxF,UAAU,CAAC,EAAE,qBAAqB,CAAC;IACnC,+DAA+D;IAC/D,MAAM,EAAE,OAAO,CAAC;CACjB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAI7E;AA8CD;;;GAGG;AACH,wBAAsB,8BAA8B,CAClD,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,iBAAiB,CAAC,CAsL5B;AAED,oGAAoG;AACpG,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,aAAa,EACnB,MAAM,EAAE,YAAY,EACpB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,wBAAwB,CAAC,CAqBnC"}

package/dist/adt/rap-generate.js

@@ -32,8 +32,9 @@
  */
 import { lockObject, unlockObject, updateSource } from './crud.js';
 import { activateBatch } from './devtools.js';
-import { AdtApiError, AdtSafetyError } from './errors.js';
+import { AdtApiError, AdtSafetyError, isNotFoundError } from './errors.js';
 import { applyRapHandlerScaffold, extractRapHandlerRequirements, findMissingRapHandlerImplementationStubs, findMissingRapHandlerRequirements, } from './rap-handlers.js';
+import { checkOperation, OperationType } from './safety.js';
 /**
  * Classify a `generate_behavior_implementation` outcome as MCP success vs error.
  *
@@ -117,108 +118,100 @@ export async function generateBehaviorImplementation(client, className, options
             `class metadata has no rootEntityRef. Pass an explicit "bdefName" parameter to override.`);
     }
     bdefName = bdefName.toUpperCase();
-    // ── Phase 2: read sources + cross-validate ────────────────────────────
-    const structured = await client.getClassStructured(cleanClassName);
-    const mainSource = structured.main ?? '';
-    const definitionsSource = structured.definitions ?? '';
-    const implementationsSource = structured.implementations ?? '';
     const bdefRead = await client.getBdef(bdefName);
     const bdefSource = bdefRead.source;
-    const mainBdefMatch = FOR_BEHAVIOR_OF_RE.exec(mainSource);
-    const bdefClassMatch = MANAGED_IMPL_RE.exec(bdefSource);
-    const mainBdefRef = mainBdefMatch?.[1]?.toUpperCase();
-    const bdefClassRef = bdefClassMatch?.[1]?.toUpperCase();
-    const validation = {
-        mainHasForBehaviorOf: Boolean(mainBdefRef),
-        bdefBindsClass: Boolean(bdefClassRef),
-    };
-    const mismatches = [];
-    if (!mainBdefRef) {
-        mismatches.push(`MAIN source for ${cleanClassName} does not contain "FOR BEHAVIOR OF <bdef>"`);
-    }
-    else if (mainBdefRef !== bdefName) {
-        mismatches.push(`MAIN binds BDEF ${mainBdefRef} but discovery resolved to ${bdefName}`);
-    }
-    if (!bdefClassRef) {
-        mismatches.push(`BDEF ${bdefName} does not contain "managed implementation in class <class> unique"`);
-    }
-    else if (bdefClassRef !== cleanClassName.toUpperCase()) {
-        mismatches.push(`BDEF ${bdefName} binds class ${bdefClassRef} but we are generating for ${cleanClassName}`);
-    }
-    if (mismatches.length > 0) {
-        validation.mismatchReason = mismatches.join('; ');
-    }
-    if (validation.mismatchReason && !dryRun) {
-        throw new AdtSafetyError(`generate_behavior_implementation: cross-reference validation failed (${validation.mismatchReason}). ` +
-            `Refusing to mutate. Re-run with dryRun=true to inspect the report and fix the source files first.`);
-    }
-    // ── Phase 3: scaffold plan ────────────────────────────────────────────
-    let requirements = extractRapHandlerRequirements(bdefSource);
-    if (targetAlias) {
-        requirements = requirements.filter((req) => req.entityAlias.toLowerCase() === targetAlias);
-    }
-    const combinedSource = [mainSource, definitionsSource, implementationsSource].filter(Boolean).join('\n\n');
-    const missingSignatures = findMissingRapHandlerRequirements(requirements, combinedSource);
-    const missingStubs = findMissingRapHandlerImplementationStubs(requirements, combinedSource);
-    const scaffoldPlan = applyRapHandlerScaffold({
-        main: mainSource,
-        definitions: definitionsSource || undefined,
-        implementations: implementationsSource || undefined,
-    }, missingSignatures, missingStubs);
-    const result = {
-        discovery: {
-            className: cleanClassName,
-            bdefName,
-            source: discoverySource,
-            classCategory: metadata.category,
-        },
-        validation,
-        scaffoldChanged: scaffoldPlan.changedSections.length > 0,
-        changedSections: scaffoldPlan.changedSections.filter((section) => section === 'main' || section === 'definitions' || section === 'implementations'),
-        inserted: {
-            signatures: scaffoldPlan.insertedSignatureCount,
-            stubs: scaffoldPlan.insertedImplementationStubCount,
-            autoCreatedSkeletons: (scaffoldPlan.skeletons?.createdDefinitions.length ?? 0) +
-                (scaffoldPlan.skeletons?.createdImplementations.length ?? 0),
-        },
-        required: requirements,
-        dryRun,
-    };
-    // Dry-run short-circuits before any side effects.
-    if (dryRun) {
-        return result;
-    }
     const objectUrl = classObjectUrl(cleanClassName);
-    // ── Phase 4: write (only when scaffold has changes) ───────────────────
-    // When scaffoldChanged=false, all handlers are already in place — skip the
-    // lock+write cycle entirely. Activation still runs below if requested, because
-    // a populated-but-inactive class is a realistic rerun/recovery state after
-    // earlier manual include writes (Codex review note on PR #260).
-    if (result.scaffoldChanged) {
-        await client.http.withStatefulSession(async (session) => {
-            const lock = await lockObject(session, client.safety, objectUrl, 'MODIFY');
-            const effectiveTransport = transport ?? (lock.corrNr || undefined);
-            try {
-                if (scaffoldPlan.changed.main && scaffoldPlan.sections.main !== mainSource) {
-                    await updateSource(session, client.safety, classMainSourceUrl(cleanClassName), scaffoldPlan.sections.main, lock.lockHandle, effectiveTransport);
-                }
-                if (scaffoldPlan.changed.definitions && scaffoldPlan.sections.definitions) {
-                    await updateSource(session, client.safety, classIncludeUrlFor(cleanClassName, 'definitions'), scaffoldPlan.sections.definitions, lock.lockHandle, effectiveTransport);
-                }
-                if (scaffoldPlan.changed.implementations && scaffoldPlan.sections.implementations) {
-                    await updateSource(session, client.safety, classIncludeUrlFor(cleanClassName, 'implementations'), scaffoldPlan.sections.implementations, lock.lockHandle, effectiveTransport);
-                }
-            }
-            finally {
-                try {
-                    await unlockObject(session, objectUrl, lock.lockHandle);
-                }
-                catch {
-                    // best-effort-cleanup: surface the original error, not an unlock failure
-                }
-            }
-        });
-    }
+    const scaffold = async (session, save) => {
+        // Read the editable view through the locked session before deriving replacements.
+        const structured = await readRapClassSources(session, client.safety, cleanClassName);
+        const mainSource = structured.main;
+        const definitionsSource = structured.definitions ?? '';
+        const implementationsSource = structured.implementations ?? '';
+        const mainBdefMatch = FOR_BEHAVIOR_OF_RE.exec(mainSource);
+        const bdefClassMatch = MANAGED_IMPL_RE.exec(bdefSource);
+        const mainBdefRef = mainBdefMatch?.[1]?.toUpperCase();
+        const bdefClassRef = bdefClassMatch?.[1]?.toUpperCase();
+        const validation = {
+            mainHasForBehaviorOf: Boolean(mainBdefRef),
+            bdefBindsClass: Boolean(bdefClassRef),
+        };
+        const mismatches = [];
+        if (!mainBdefRef) {
+            mismatches.push(`MAIN source for ${cleanClassName} does not contain "FOR BEHAVIOR OF <bdef>"`);
+        }
+        else if (mainBdefRef !== bdefName) {
+            mismatches.push(`MAIN binds BDEF ${mainBdefRef} but discovery resolved to ${bdefName}`);
+        }
+        if (!bdefClassRef) {
+            mismatches.push(`BDEF ${bdefName} does not contain "managed implementation in class <class> unique"`);
+        }
+        else if (bdefClassRef !== cleanClassName.toUpperCase()) {
+            mismatches.push(`BDEF ${bdefName} binds class ${bdefClassRef} but we are generating for ${cleanClassName}`);
+        }
+        if (mismatches.length > 0) {
+            validation.mismatchReason = mismatches.join('; ');
+        }
+        if (validation.mismatchReason && !dryRun) {
+            throw new AdtSafetyError(`generate_behavior_implementation: cross-reference validation failed (${validation.mismatchReason}). ` +
+                `Refusing to mutate. Re-run with dryRun=true to inspect the report and fix the source files first.`);
+        }
+        // ── Phase 3: scaffold plan ────────────────────────────────────────────
+        let requirements = extractRapHandlerRequirements(bdefSource);
+        if (targetAlias) {
+            requirements = requirements.filter((req) => req.entityAlias.toLowerCase() === targetAlias);
+        }
+        const combinedSource = [mainSource, definitionsSource, implementationsSource].filter(Boolean).join('\n\n');
+        const missingSignatures = findMissingRapHandlerRequirements(requirements, combinedSource);
+        const missingStubs = findMissingRapHandlerImplementationStubs(requirements, combinedSource);
+        const scaffoldPlan = applyRapHandlerScaffold({
+            main: mainSource,
+            definitions: definitionsSource || undefined,
+            implementations: implementationsSource || undefined,
+        }, missingSignatures, missingStubs);
+        const result = {
+            discovery: {
+                className: cleanClassName,
+                bdefName,
+                source: discoverySource,
+                classCategory: metadata.category,
+            },
+            validation,
+            scaffoldChanged: scaffoldPlan.changedSections.length > 0,
+            changedSections: scaffoldPlan.changedSections.filter((section) => section === 'main' || section === 'definitions' || section === 'implementations'),
+            inserted: {
+                signatures: scaffoldPlan.insertedSignatureCount,
+                stubs: scaffoldPlan.insertedImplementationStubCount,
+                autoCreatedSkeletons: (scaffoldPlan.skeletons?.createdDefinitions.length ?? 0) +
+                    (scaffoldPlan.skeletons?.createdImplementations.length ?? 0),
+            },
+            required: requirements,
+            dryRun,
+        };
+        if (!save)
+            return result;
+        if (scaffoldPlan.changed.main && scaffoldPlan.sections.main !== mainSource) {
+            await save(classMainSourceUrl(cleanClassName), scaffoldPlan.sections.main);
+        }
+        if (scaffoldPlan.changed.definitions && scaffoldPlan.sections.definitions) {
+            await save(classIncludeUrlFor(cleanClassName, 'definitions'), scaffoldPlan.sections.definitions);
+        }
+        if (scaffoldPlan.changed.implementations && scaffoldPlan.sections.implementations) {
+            await save(classIncludeUrlFor(cleanClassName, 'implementations'), scaffoldPlan.sections.implementations);
+        }
+        return result;
+    };
+    if (dryRun)
+        return scaffold(client.http);
+    // Even activation-only reruns need the lock to establish that no source change is needed.
+    const result = await client.http.withStatefulSession(async (session) => {
+        const lock = await lockObject(session, client.safety, objectUrl, 'MODIFY');
+        try {
+            return await scaffold(session, (url, source) => updateSource(session, client.safety, url, source, lock.lockHandle, transport ?? (lock.corrNr || undefined)));
+        }
+        finally {
+            await unlockObject(session, objectUrl, lock.lockHandle);
+        }
+    });
     // ── Phase 5: optional activation ──────────────────────────────────────
     if (activateRequested) {
         try {
@@ -259,4 +252,23 @@ export async function generateBehaviorImplementation(client, className, options
     }
     return result;
 }
+/** Read only the three RAP source sections. Serial reads keep one stateful SAP context in order. */
+export async function readRapClassSources(http, safety, name) {
+    checkOperation(safety, OperationType.Read, 'GetRapClassSources');
+    const sections = {
+        main: (await http.get(classMainSourceUrl(name), { 'Cache-Control': 'no-cache' })).body,
+    };
+    for (const include of ['definitions', 'implementations']) {
+        try {
+            sections[include] = (await http.get(classIncludeUrlFor(name, include), { 'Cache-Control': 'no-cache' }, {
+                suppressNotFoundLog: true,
+            })).body;
+        }
+        catch (err) {
+            if (!isNotFoundError(err))
+                throw err;
+        }
+    }
+    return sections;
+}
 //# sourceMappingURL=rap-generate.js.map

package/dist/adt/rap-generate.js.map

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

package/dist/adt/server-driven.d.ts

@@ -55,7 +55,7 @@ export declare function serverDrivenSourceFormat(code: string): SdoSourceFormat;
  * here is the ONLY step needed to expose it — `btp: true` by construction (runtime availability is
  * discovery-gated per system, so a type absent on a release degrades cleanly).
  */
-export declare const SDO_TYPES: readonly ['DESD', 'DTSC', 'CSNM', 'EVTB', 'EVTO', 'COTA', 'DSFD', 'DTDC', 'UIAD', 'DRTY'];
+export declare const SDO_TYPES: readonly ['DESD', 'DTSC', 'CSNM', 'EVTB', 'EVTO', 'COTA', 'DSFD', 'DTDC', 'UIAD', 'DRTY', 'APLO', 'SAJC', 'SAJT'];
 /** Curated registry of high-value server-driven object types — keys are exactly SDO_TYPES. */
 export declare const SDO_REGISTRY: {
     DESD: {
@@ -168,6 +168,39 @@ export declare const SDO_REGISTRY: {
         metadataContentType: string;
         sourceFormat: "text";
     };
+    APLO: {
+        metadataRootLocalName: 'blueSource';
+        metadataRootQName: 'blue:blueSource';
+        metadataNamespace: 'http://www.sap.com/wbobj/blue';
+        discoveryMarker: 'blues';
+        href: string;
+        label: string;
+        createType: string;
+        metadataContentType: string;
+        sourceFormat: "json";
+    };
+    SAJC: {
+        metadataRootLocalName: 'blueSource';
+        metadataRootQName: 'blue:blueSource';
+        metadataNamespace: 'http://www.sap.com/wbobj/blue';
+        discoveryMarker: 'blues';
+        href: string;
+        label: string;
+        createType: string;
+        metadataContentType: string;
+        sourceFormat: "json";
+    };
+    SAJT: {
+        metadataRootLocalName: 'blueSource';
+        metadataRootQName: 'blue:blueSource';
+        metadataNamespace: 'http://www.sap.com/wbobj/blue';
+        discoveryMarker: 'blues';
+        href: string;
+        label: string;
+        createType: string;
+        metadataContentType: string;
+        sourceFormat: "json";
+    };
 };
 /** True when `code` is one of the registered server-driven object types. */
 export declare function isServerDrivenObjectType(code: string): boolean;
@@ -213,9 +246,10 @@ export declare function serverDrivenUnavailableMessage(tool: string, code: strin
 /**
  * Read a server-driven object: its metadata (blue:blueSource or dtdc:dtdcSource) + source (AFF JSON
  * or DDL text). The source is JSON-parsed when possible (raw text otherwise). Throws AdtApiError 404
- * for a nonexistent object. Gate availability with supportsServerDrivenObject() on unknown systems.
+ * for a nonexistent object. Explicit versions must match the returned metadata; omission keeps
+ * SAP's developer view. Gate availability with supportsServerDrivenObject() on unknown systems.
  */
-export declare function getServerDrivenObject(http: AdtHttpClient, safety: SafetyConfig, code: string, name: string): Promise<ServerDrivenObjectResult>;
+export declare function getServerDrivenObject(http: AdtHttpClient, safety: SafetyConfig, code: string, name: string, version?: 'active' | 'inactive'): Promise<ServerDrivenObjectResult>;
 /**
  * Build the minimal metadata create body for a server-driven object — the per-type root element
  * (blue:blueSource or dtdc:dtdcSource) with the verified `createType` for `adtcore:type`
@@ -229,7 +263,7 @@ export declare function getServerDrivenObject(http: AdtHttpClient, safety: Safet
  * registered type.
  */
 export type UiadLanguageVersion = 'standard' | 'keyUser' | 'cloudDevelopment';
-export declare function buildServerDrivenMetadataXml(code: string, name: string, pkg: string, description: string, uiadLanguageVersion?: UiadLanguageVersion): string;
+export declare function buildServerDrivenMetadataXml(code: string, name: string, pkg: string, description: string, uiadLanguageVersion?: UiadLanguageVersion, creationProperties?: Record<string, string>): string;
 /** Options shared by the SDO write operations. */
 export interface ServerDrivenWriteOptions {
     transport?: string;
@@ -239,14 +273,15 @@ export interface ServerDrivenWriteOptions {
 }
 /**
  * Create a server-driven object (metadata only — POST the <blue:blueSource> body to the collection
- * href with the type's blues content-type). Leaves the object INACTIVE; callers follow with source
- * write + activation. Returns the raw response body. Verified live: 201 for all 6 registered types.
+ * href with the type's metadata content-type). APLO is immediately active; other generic types
+ * need activation. Job objects also need their creation reference. Returns the raw response body.
  */
 export declare function createServerDrivenObject(http: AdtHttpClient, safety: SafetyConfig, code: string, name: string, opts: {
     package: string;
     description: string;
     transport?: string;
     uiadLanguageVersion?: UiadLanguageVersion;
+    creationProperties?: Record<string, string>;
 }): Promise<string>;
 /**
  * Write the source of a server-driven object: lock → PUT …/source/main → unlock (guaranteed via
@@ -256,9 +291,6 @@ export declare function createServerDrivenObject(http: AdtHttpClient, safety: Sa
  * crud.ts safeUpdateSource).
  */
 export declare function updateServerDrivenObjectSource(http: AdtHttpClient, safety: SafetyConfig, code: string, name: string, source: string, opts?: ServerDrivenWriteOptions): Promise<void>;
-/**
- * Delete a server-driven object: lock → http.delete(…?lockHandle=…) → best-effort unlock.
- * The unlock is swallowed on failure (the object is already gone after the delete).
- */
+/** Delete under a lock, then verify canonical metadata absence in a fresh request. */
 export declare function deleteServerDrivenObject(http: AdtHttpClient, safety: SafetyConfig, code: string, name: string, opts?: ServerDrivenWriteOptions): Promise<void>;
 //# sourceMappingURL=server-driven.d.ts.map