@mcp-abap-adt/adt-backup 1.1.0 → 1.3.0

package/README.md

@@ -1,4 +1,5 @@
 # @mcp-abap-adt/adt-backup
+[![Stand With Ukraine](https://raw.githubusercontent.com/vshymanskyy/StandWithUkraine/main/badges/StandWithUkraine.svg)](https://stand-with-ukraine.pp.ua)
 
 CLI for recursive ADT backups and restores using `@mcp-abap-adt/adt-clients`.
 
@@ -78,6 +79,7 @@ See `docs/roadmap.yaml` for per-object backup/restore status and the plan for re
 | `interface` | implemented | implemented | source |
 | `class` | implemented | implemented | source |
 | `program` | implemented | implemented | source |
+| `transformation` | implemented | implemented | source |
 | `serviceDefinition` | implemented | implemented | source |
 | `serviceBinding` | implemented | implemented | metadata-xml |
 | `metadataExtension` | implemented | implemented | source |
@@ -89,6 +91,10 @@ See `docs/roadmap.yaml` for per-object backup/restore status and the plan for re
 
 > **Note**: Unit tests are stored as classes in backups. When restoring, they are created as test classes in the system.
 
+> **Note**: For `transformation`, the subtype (`SimpleTransformation` for `XSLT/VT` vs `XSLTProgram` for `XSLT/ST`) is detected from the source header (`<?sap.transform simple?>`).
+
+> **Note**: For `serviceBinding`, the publication state (`srvb:published`) is preserved in the backup and re-applied during restore — published bindings are re-published, unpublished bindings are unpublished.
+
 ## Smoke Checklist
 
 When your landscape is ready, use `docs/SMOKE_CHECKLIST.md` for a focused backup/restore/verify checklist.

package/dist/lib/backup/readBasicMetadata.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"readBasicMetadata.d.ts","sourceRoot":"","sources":["../../../src/lib/backup/readBasicMetadata.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAI3C,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE,UAAU,GACf,OAAO,CAAC;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CA0DzD"}
+{"version":3,"file":"readBasicMetadata.d.ts","sourceRoot":"","sources":["../../../src/lib/backup/readBasicMetadata.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAI3C,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE,UAAU,GACf,OAAO,CAAC;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAiEzD"}

package/dist/lib/backup/readBasicMetadata.js

@@ -26,6 +26,13 @@ async function readBasicMetadata(client, spec) {
             const xml = (0, responseToText_1.responseToText)(state.metadataResult);
             return xml ? (0, extractMetadata_1.extractMetadata)(xml) : {};
         }
+        case 'transformation': {
+            const state = await client
+                .getTransformation()
+                .readMetadata({ transformationName: spec.name });
+            const xml = (0, responseToText_1.responseToText)(state.metadataResult);
+            return xml ? (0, extractMetadata_1.extractMetadata)(xml) : {};
+        }
         case 'structure': {
             const state = await client
                 .getStructure()

package/dist/lib/backup/readMetadataXmlForType.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"readMetadataXmlForType.d.ts","sourceRoot":"","sources":["../../../src/lib/backup/readMetadataXmlForType.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAG9C,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE,aAAa,EACnB,IAAI,EAAE,MAAM,EACZ,kBAAkB,CAAC,EAAE,MAAM,GAC1B,OAAO,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,CAsHpC"}
+{"version":3,"file":"readMetadataXmlForType.d.ts","sourceRoot":"","sources":["../../../src/lib/backup/readMetadataXmlForType.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAG9C,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE,aAAa,EACnB,IAAI,EAAE,MAAM,EACZ,kBAAkB,CAAC,EAAE,MAAM,GAC1B,OAAO,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,CA0IpC"}

package/dist/lib/backup/readMetadataXmlForType.js

@@ -4,106 +4,126 @@ exports.readMetadataXmlForType = readMetadataXmlForType;
 const responseToText_1 = require("../utils/responseToText");
 async function readMetadataXmlForType(client, type, name, _functionGroupName) {
     try {
+        let result;
         switch (type) {
             case 'package': {
                 const state = await client
                     .getPackage()
                     .readMetadata({ packageName: name });
-                return (0, responseToText_1.responseToText)(state.metadataResult);
+                result = (0, responseToText_1.responseToText)(state.metadataResult);
+                break;
             }
             case 'class': {
                 const state = await client.getClass().readMetadata({ className: name });
-                return (0, responseToText_1.responseToText)(state.metadataResult);
+                result = (0, responseToText_1.responseToText)(state.metadataResult);
+                break;
             }
             case 'interface': {
                 const state = await client
                     .getInterface()
                     .readMetadata({ interfaceName: name });
-                return (0, responseToText_1.responseToText)(state.metadataResult);
+                result = (0, responseToText_1.responseToText)(state.metadataResult);
+                break;
             }
             case 'domain': {
                 const state = await client
                     .getDomain()
                     .readMetadata({ domainName: name });
-                return (0, responseToText_1.responseToText)(state.metadataResult);
+                result = (0, responseToText_1.responseToText)(state.metadataResult);
+                break;
             }
             case 'dataElement': {
                 const state = await client
                     .getDataElement()
                     .readMetadata({ dataElementName: name });
-                return (0, responseToText_1.responseToText)(state.metadataResult);
+                result = (0, responseToText_1.responseToText)(state.metadataResult);
+                break;
             }
             case 'table': {
                 const state = await client.getTable().readMetadata({ tableName: name });
-                return (0, responseToText_1.responseToText)(state.metadataResult);
+                result = (0, responseToText_1.responseToText)(state.metadataResult);
+                break;
             }
             case 'tableType': {
                 const state = await client
                     .getTableType()
                     .readMetadata({ tableTypeName: name });
-                return (0, responseToText_1.responseToText)(state.metadataResult);
+                result = (0, responseToText_1.responseToText)(state.metadataResult);
+                break;
             }
             case 'structure': {
                 const state = await client
                     .getStructure()
                     .readMetadata({ structureName: name });
-                return (0, responseToText_1.responseToText)(state.metadataResult);
+                result = (0, responseToText_1.responseToText)(state.metadataResult);
+                break;
             }
             case 'view': {
                 const state = await client.getView().readMetadata({ viewName: name });
-                return (0, responseToText_1.responseToText)(state.metadataResult);
+                result = (0, responseToText_1.responseToText)(state.metadataResult);
+                break;
             }
             case 'behaviorDefinition': {
                 const state = await client
                     .getBehaviorDefinition()
                     .readMetadata({ name });
-                return (0, responseToText_1.responseToText)(state.metadataResult);
+                result = (0, responseToText_1.responseToText)(state.metadataResult);
+                break;
             }
             case 'behaviorImplementation': {
                 const state = await client
                     .getBehaviorImplementation()
                     .readMetadata({ className: name });
-                return (0, responseToText_1.responseToText)(state.metadataResult);
+                result = (0, responseToText_1.responseToText)(state.metadataResult);
+                break;
             }
             case 'serviceDefinition': {
                 const state = await client
                     .getServiceDefinition()
                     .readMetadata({ serviceDefinitionName: name });
-                return (0, responseToText_1.responseToText)(state.metadataResult);
+                result = (0, responseToText_1.responseToText)(state.metadataResult);
+                break;
             }
             case 'serviceBinding': {
                 const state = await client
                     .getServiceBinding()
                     .readMetadata({ bindingName: name });
-                return (0, responseToText_1.responseToText)(state.metadataResult);
+                result = (0, responseToText_1.responseToText)(state.metadataResult);
+                break;
             }
             case 'metadataExtension': {
                 const state = await client
                     .getMetadataExtension()
                     .readMetadata({ name });
-                return (0, responseToText_1.responseToText)(state.metadataResult);
+                result = (0, responseToText_1.responseToText)(state.metadataResult);
+                break;
             }
             case 'functionGroup': {
                 const state = await client
                     .getFunctionGroup()
                     .readMetadata({ functionGroupName: name });
-                return (0, responseToText_1.responseToText)(state.metadataResult);
+                result = (0, responseToText_1.responseToText)(state.metadataResult);
+                break;
             }
             case 'enhancement': {
                 const state = await client
                     .getEnhancement()
                     .readMetadata({ enhancementName: name, enhancementType: 'enhoxh' });
-                return (0, responseToText_1.responseToText)(state.metadataResult);
+                result = (0, responseToText_1.responseToText)(state.metadataResult);
+                break;
             }
             case 'accessControl': {
                 const state = await client
                     .getAccessControl()
                     .readMetadata({ accessControlName: name });
-                return (0, responseToText_1.responseToText)(state.metadataResult);
+                result = (0, responseToText_1.responseToText)(state.metadataResult);
+                break;
             }
             default:
                 return undefined;
         }
+        // ADT clients return undefined on 404 — treat as not found
+        return result ?? null;
     }
     catch (error) {
         const status = error.status || error.response?.status;

package/dist/lib/backup/readSourceText.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"readSourceText.d.ts","sourceRoot":"","sources":["../../../src/lib/backup/readSourceText.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAG3C,wBAAsB,cAAc,CAClC,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE,UAAU,EAChB,OAAO,GAAE,QAAQ,GAAG,UAAqB,GACxC,OAAO,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,CAwGpC"}
+{"version":3,"file":"readSourceText.d.ts","sourceRoot":"","sources":["../../../src/lib/backup/readSourceText.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAG3C,wBAAsB,cAAc,CAClC,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE,UAAU,EAChB,OAAO,GAAE,QAAQ,GAAG,UAAqB,GACxC,OAAO,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,CA8GpC"}

package/dist/lib/backup/readSourceText.js

@@ -23,6 +23,12 @@ async function readSourceText(client, spec, version = 'active') {
                     .read({ programName: spec.name }, version);
                 return (0, responseToText_1.responseToText)(state?.readResult);
             }
+            case 'transformation': {
+                const state = await client
+                    .getTransformation()
+                    .read({ transformationName: spec.name }, version);
+                return (0, responseToText_1.responseToText)(state?.readResult);
+            }
             case 'view': {
                 const state = await client
                     .getView()

package/dist/lib/constants/typeOrder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"typeOrder.d.ts","sourceRoot":"","sources":["../../../src/lib/constants/typeOrder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE9C,eAAO,MAAM,SAAS,EAAE,aAAa,EAmBpC,CAAC"}
+{"version":3,"file":"typeOrder.d.ts","sourceRoot":"","sources":["../../../src/lib/constants/typeOrder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE9C,eAAO,MAAM,SAAS,EAAE,aAAa,EAoBpC,CAAC"}

package/dist/lib/constants/typeOrder.js

@@ -14,6 +14,7 @@ exports.typeOrder = [
     'interface',
     'class',
     'program',
+    'transformation',
     'serviceDefinition',
     'serviceBinding',
     'metadataExtension',

package/dist/lib/dependencies/collectTreeDependencies.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"collectTreeDependencies.d.ts","sourceRoot":"","sources":["../../../src/lib/dependencies/collectTreeDependencies.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAK3D,OAAO,KAAK,EAAE,cAAc,EAA6B,MAAM,UAAU,CAAC;AAmC1E,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC,IAAI,CAAC,CA+Ff"}
+{"version":3,"file":"collectTreeDependencies.d.ts","sourceRoot":"","sources":["../../../src/lib/dependencies/collectTreeDependencies.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAK3D,OAAO,KAAK,EAAE,cAAc,EAA6B,MAAM,UAAU,CAAC;AAoC1E,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC,IAAI,CAAC,CA+Ff"}

package/dist/lib/dependencies/collectTreeDependencies.js

@@ -17,6 +17,7 @@ const WHERE_USED_TYPE_MAP = {
     class: 'CLAS/OC',
     interface: 'INTF/IF',
     program: 'PROG/P',
+    transformation: 'XSLT/VT',
     functionGroup: 'FUGR/F',
     functionModule: 'FUGR/FF',
     serviceDefinition: 'SRVD/SRV',

package/dist/lib/restore/analyzeDependencies.d.ts

@@ -10,4 +10,10 @@ export interface RestoreGroup {
  * (e.g. view and behaviorDefinition for the same CDS entity).
  */
 export declare function analyzeDependencies(nodes: BackupTreeNode[]): RestoreGroup[];
+/**
+ * Analyzes dependencies and merges SCCs at the same dependency level
+ * into single groups. Level = max(level of dependencies) + 1.
+ * Independent SCCs (same level) are merged into one group.
+ */
+export declare function analyzeDependencyLevels(nodes: BackupTreeNode[]): RestoreGroup[];
 //# sourceMappingURL=analyzeDependencies.d.ts.map

package/dist/lib/restore/analyzeDependencies.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"analyzeDependencies.d.ts","sourceRoot":"","sources":["../../../src/lib/restore/analyzeDependencies.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,UAAU,EAAE,OAAO,CAAC;CACrB;AAMD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,YAAY,EAAE,CAwM3E"}
+{"version":3,"file":"analyzeDependencies.d.ts","sourceRoot":"","sources":["../../../src/lib/restore/analyzeDependencies.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,UAAU,EAAE,OAAO,CAAC;CACrB;AA+MD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,YAAY,EAAE,CA2B3E;AA4BD;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,cAAc,EAAE,GACtB,YAAY,EAAE,CA8DhB"}

package/dist/lib/restore/analyzeDependencies.js

@@ -1,30 +1,15 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.analyzeDependencies = analyzeDependencies;
+exports.analyzeDependencyLevels = analyzeDependencyLevels;
 const decodeBase64_1 = require("../crypto/decodeBase64");
 function nodeKey(node) {
     return `${node.type}:${node.name}`.toUpperCase();
 }
 /**
- * Robustly analyzes dependencies between objects by scanning both
- * source code and XML metadata.
- * Uses composite type:name keys to handle objects that share the same name
- * (e.g. view and behaviorDefinition for the same CDS entity).
+ * Build adjacency map (forward dependencies) by scanning source code and config.
  */
-function analyzeDependencies(nodes) {
-    const idToNode = new Map();
-    const nameToIds = new Map();
-    const allNames = new Set();
-    for (const node of nodes) {
-        const id = nodeKey(node);
-        const upperName = node.name.toUpperCase();
-        idToNode.set(id, node);
-        allNames.add(upperName);
-        const ids = nameToIds.get(upperName) || [];
-        ids.push(id);
-        nameToIds.set(upperName, ids);
-    }
-    const allIds = new Set(idToNode.keys());
+function buildAdjacency(nodes, allNames, nameToIds, allIds) {
     const adj = new Map();
     for (const node of nodes) {
         const deps = new Set();
@@ -37,13 +22,9 @@ function analyzeDependencies(nodes) {
             for (const targetName of allNames) {
                 if (targetName === nodeNameUpper)
                     continue;
-                // Escape name for regex, specifically handling namespaces with /
                 const escapedTarget = targetName.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
-                // Match only if surrounded by boundaries that are NOT part of an ABAP name
-                // (i.e. not letters, digits, _, or /)
                 const regex = new RegExp(`(?<=[^A-Z0-9_/]|^)${escapedTarget}(?=[^A-Z0-9_/]|$)`, 'g');
                 if (regex.test(contentUpper)) {
-                    // Resolve name to all node IDs with that name
                     const targetIds = nameToIds.get(targetName) || [];
                     for (const tid of targetIds) {
                         if (tid !== id)
@@ -51,9 +32,8 @@ function analyzeDependencies(nodes) {
                     }
                 }
             }
-            // 2. Explicit structural dependencies (from config or XML properties)
-            // Behavior Definition <-> Implementation Class (bidirectional = same SCC group)
-            // From class source: "FOR BEHAVIOR OF <bdef_name>"
+            // 2. Explicit structural dependencies
+            // BIML class -> BDEF (bidirectional = same SCC)
             if (node.type === 'class' || node.type === 'behaviorImplementation') {
                 const bdefMatch = contentUpper.match(/FOR\s+BEHAVIOR\s+OF\s+([A-Z0-9_/]+)/);
                 if (bdefMatch) {
@@ -62,7 +42,7 @@ function analyzeDependencies(nodes) {
                         deps.add(bdefId);
                 }
             }
-            // From BDEF source: "IMPLEMENTATION IN CLASS <class_name>"
+            // BDEF -> BIML class
             if (node.type === 'behaviorDefinition') {
                 for (const m of contentUpper.matchAll(/IMPLEMENTATION\s+IN\s+CLASS\s+([A-Z0-9_/]+)/g)) {
                     const className = m[1];
@@ -93,7 +73,12 @@ function analyzeDependencies(nodes) {
         }
         adj.set(id, deps);
     }
-    // Tarjan's algorithm for SCCs
+    return adj;
+}
+/**
+ * Tarjan's SCC algorithm.
+ */
+function tarjanSCC(allIds, adj) {
     let index = 0;
     const stack = [];
     const onStack = new Set();
@@ -140,7 +125,12 @@ function analyzeDependencies(nodes) {
             strongConnect(id);
         }
     }
-    // Dependency graph of SCCs
+    return sccs;
+}
+/**
+ * Build SCC DAG and topological order from SCCs and adjacency map.
+ */
+function buildSccDag(sccs, adj) {
     const sccAdj = new Map();
     const nodeToSccIndex = new Map();
     sccs.forEach((scc, i) => {
@@ -177,6 +167,31 @@ function analyzeDependencies(nodes) {
     for (let i = 0; i < sccs.length; i++) {
         visit(i);
     }
+    return { sccAdj, order };
+}
+/**
+ * Robustly analyzes dependencies between objects by scanning both
+ * source code and XML metadata.
+ * Uses composite type:name keys to handle objects that share the same name
+ * (e.g. view and behaviorDefinition for the same CDS entity).
+ */
+function analyzeDependencies(nodes) {
+    const idToNode = new Map();
+    const nameToIds = new Map();
+    const allNames = new Set();
+    for (const node of nodes) {
+        const id = nodeKey(node);
+        const upperName = node.name.toUpperCase();
+        idToNode.set(id, node);
+        allNames.add(upperName);
+        const ids = nameToIds.get(upperName) || [];
+        ids.push(id);
+        nameToIds.set(upperName, ids);
+    }
+    const allIds = new Set(idToNode.keys());
+    const adj = buildAdjacency(nodes, allNames, nameToIds, allIds);
+    const sccs = tarjanSCC(allIds, adj);
+    const { order } = buildSccDag(sccs, adj);
     return order.map((i) => {
         const ids = sccs[i];
         return {
@@ -185,3 +200,87 @@ function analyzeDependencies(nodes) {
         };
     });
 }
+/**
+ * Creation order priority within a group.
+ * Lower = created first. Ensures BDEF exists before BIML class, etc.
+ */
+const TYPE_CREATION_ORDER = {
+    domain: 0,
+    dataElement: 1,
+    structure: 2,
+    table: 2,
+    tableType: 2,
+    view: 3,
+    behaviorDefinition: 4,
+    behaviorImplementation: 5,
+    class: 5,
+    interface: 5,
+    accessControl: 6,
+    metadataExtension: 6,
+    program: 7,
+    transformation: 7,
+    functionGroup: 7,
+    functionModule: 8,
+    serviceDefinition: 9,
+    serviceBinding: 10,
+    enhancement: 11,
+};
+/**
+ * Analyzes dependencies and merges SCCs at the same dependency level
+ * into single groups. Level = max(level of dependencies) + 1.
+ * Independent SCCs (same level) are merged into one group.
+ */
+function analyzeDependencyLevels(nodes) {
+    const idToNode = new Map();
+    const nameToIds = new Map();
+    const allNames = new Set();
+    for (const node of nodes) {
+        const id = nodeKey(node);
+        const upperName = node.name.toUpperCase();
+        idToNode.set(id, node);
+        allNames.add(upperName);
+        const ids = nameToIds.get(upperName) || [];
+        ids.push(id);
+        nameToIds.set(upperName, ids);
+    }
+    const allIds = new Set(idToNode.keys());
+    const adj = buildAdjacency(nodes, allNames, nameToIds, allIds);
+    const sccs = tarjanSCC(allIds, adj);
+    const { sccAdj, order } = buildSccDag(sccs, adj);
+    // Compute level for each SCC: level = max(level of deps) + 1
+    const sccLevel = new Map();
+    for (const i of order) {
+        let maxDepLevel = -1;
+        const deps = sccAdj.get(i) || new Set();
+        for (const d of deps) {
+            const depLevel = sccLevel.get(d) ?? 0;
+            if (depLevel > maxDepLevel)
+                maxDepLevel = depLevel;
+        }
+        sccLevel.set(i, maxDepLevel + 1);
+    }
+    // Group SCCs by level, merge into RestoreGroups
+    const levelMap = new Map();
+    for (const i of order) {
+        const level = sccLevel.get(i);
+        if (!levelMap.has(level)) {
+            levelMap.set(level, { nodes: [], hasCircular: false });
+        }
+        const entry = levelMap.get(level);
+        const sccNodes = sccs[i].map((id) => idToNode.get(id));
+        entry.nodes.push(...sccNodes);
+        if (sccs[i].length > 1)
+            entry.hasCircular = true;
+    }
+    const sortedLevels = [...levelMap.keys()].sort((a, b) => a - b);
+    return sortedLevels.map((level) => {
+        const entry = levelMap.get(level);
+        // Sort nodes within group by creation order (views before BDEFs before classes)
+        entry.nodes.sort((a, b) => (TYPE_CREATION_ORDER[a.type || ''] ?? 99) -
+            (TYPE_CREATION_ORDER[b.type || ''] ?? 99));
+        return {
+            nodes: entry.nodes,
+            isCircular: entry.hasCircular || entry.nodes.length > 1,
+        };
+    });
+}

package/dist/lib/restore/restoreObject.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"restoreObject.d.ts","sourceRoot":"","sources":["../../../src/lib/restore/restoreObject.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EAmBV,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAM1D,wBAAsB,aAAa,CACjC,MAAM,EAAE,SAAS,EACjB,GAAG,EAAE,YAAY,EACjB,IAAI,EAAE,WAAW,EACjB,QAAQ,EAAE,OAAO,EACjB,gBAAgB,CAAC,EAAE,MAAM,GACxB,OAAO,CAAC,IAAI,CAAC,CAqSf"}
+{"version":3,"file":"restoreObject.d.ts","sourceRoot":"","sources":["../../../src/lib/restore/restoreObject.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EAoBV,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAO1D,wBAAsB,aAAa,CACjC,MAAM,EAAE,SAAS,EACjB,GAAG,EAAE,YAAY,EACjB,IAAI,EAAE,WAAW,EACjB,QAAQ,EAAE,OAAO,EACjB,gBAAgB,CAAC,EAAE,MAAM,GACxB,OAAO,CAAC,IAAI,CAAC,CA2Tf"}

package/dist/lib/restore/restoreObject.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.restoreObject = restoreObject;
 const applyConfigName_1 = require("../utils/applyConfigName");
 const asConfig_1 = require("../utils/asConfig");
+const detectTransformationType_1 = require("../utils/detectTransformationType");
 const ensureDescription_1 = require("../utils/ensureDescription");
 const applyTransportRequest_1 = require("./applyTransportRequest");
 async function restoreObject(client, obj, mode, activate, transportRequest) {
@@ -128,6 +129,25 @@ async function restoreObject(client, obj, mode, activate, transportRequest) {
             }
             return;
         }
+        case 'transformation': {
+            const transformationType = (0, detectTransformationType_1.detectTransformationType)(obj.source);
+            const baseTxConfig = {
+                ...config,
+                transformationType,
+            };
+            if (mode !== 'update') {
+                await client
+                    .getTransformation()
+                    .create((0, asConfig_1.asConfig)(baseTxConfig), options);
+            }
+            if (obj.source) {
+                await client.getTransformation().update((0, asConfig_1.asConfig)({
+                    ...baseTxConfig,
+                    sourceCode: obj.source,
+                }), options);
+            }
+            return;
+        }
         case 'functionGroup': {
             if (mode !== 'update') {
                 await client

package/dist/lib/restore/restoreObjects.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"restoreObjects.d.ts","sourceRoot":"","sources":["../../../src/lib/restore/restoreObjects.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAmB,MAAM,2BAA2B,CAAC;AAE5E,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AA2B1D,wBAAsB,cAAc,CAClC,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,YAAY,EAAE,EACvB,IAAI,EAAE,WAAW,EACjB,gBAAgB,EAAE,OAAO,EACzB,gBAAgB,CAAC,EAAE,MAAM,EACzB,cAAc,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,EACzC,gBAAgB,UAAO,GACtB,OAAO,CAAC,IAAI,CAAC,CA+Df"}
+{"version":3,"file":"restoreObjects.d.ts","sourceRoot":"","sources":["../../../src/lib/restore/restoreObjects.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAmB,MAAM,2BAA2B,CAAC;AAE5E,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AA4B1D,wBAAsB,cAAc,CAClC,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,YAAY,EAAE,EACvB,IAAI,EAAE,WAAW,EACjB,gBAAgB,EAAE,OAAO,EACzB,gBAAgB,CAAC,EAAE,MAAM,EACzB,cAAc,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,EACzC,gBAAgB,UAAO,GACtB,OAAO,CAAC,IAAI,CAAC,CA+Df"}

package/dist/lib/restore/restoreObjects.js

@@ -16,6 +16,7 @@ const ADT_TYPE_MAP = {
     class: 'CLAS/OC',
     interface: 'INTF/OI',
     program: 'PROG/P',
+    transformation: 'XSLT/VT',
     functionGroup: 'FUGR/FF',
     functionModule: 'FUGR/I',
     serviceDefinition: 'SRVD/SRV',

package/dist/lib/restore/restoreTreeBackup.d.ts

@@ -1,4 +1,4 @@
 import type { AdtClient } from '@mcp-abap-adt/adt-clients';
-import type { BackupTreeNode, RestoreMode } from '../types';
-export declare function restoreTreeBackup(client: AdtClient, root: BackupTreeNode, mode: RestoreMode, activate: boolean, transportRequest?: string, restoreIds?: Set<string>, restoreActions?: Map<string, RestoreMode>, activateOnCreate?: boolean, softwareComponent?: string, superPackageOverride?: string, transportLayer?: string): Promise<void>;
+import type { BackupTreeNode, RestoreMode, RestorePlanGroup } from '../types';
+export declare function restoreTreeBackup(client: AdtClient, root: BackupTreeNode, mode: RestoreMode, activate: boolean, transportRequest?: string, restoreIds?: Set<string>, planGroups?: RestorePlanGroup[], activateOnCreate?: boolean, softwareComponent?: string, superPackageOverride?: string, transportLayer?: string): Promise<void>;
 //# sourceMappingURL=restoreTreeBackup.d.ts.map

package/dist/lib/restore/restoreTreeBackup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"restoreTreeBackup.d.ts","sourceRoot":"","sources":["../../../src/lib/restore/restoreTreeBackup.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAmB,MAAM,2BAA2B,CAAC;AAI5E,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAiB,MAAM,UAAU,CAAC;AAwD3E,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE,cAAc,EACpB,IAAI,EAAE,WAAW,EACjB,QAAQ,EAAE,OAAO,EACjB,gBAAgB,CAAC,EAAE,MAAM,EACzB,UAAU,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,EACxB,cAAc,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,EACzC,gBAAgB,UAAO,EACvB,iBAAiB,CAAC,EAAE,MAAM,EAC1B,oBAAoB,CAAC,EAAE,MAAM,EAC7B,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,IAAI,CAAC,CA2Pf"}
+{"version":3,"file":"restoreTreeBackup.d.ts","sourceRoot":"","sources":["../../../src/lib/restore/restoreTreeBackup.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAmB,MAAM,2BAA2B,CAAC;AAK5E,OAAO,KAAK,EACV,cAAc,EACd,WAAW,EACX,gBAAgB,EAEjB,MAAM,UAAU,CAAC;AAmElB,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE,cAAc,EACpB,IAAI,EAAE,WAAW,EACjB,QAAQ,EAAE,OAAO,EACjB,gBAAgB,CAAC,EAAE,MAAM,EACzB,UAAU,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,EACxB,UAAU,CAAC,EAAE,gBAAgB,EAAE,EAC/B,gBAAgB,UAAO,EACvB,iBAAiB,CAAC,EAAE,MAAM,EAC1B,oBAAoB,CAAC,EAAE,MAAM,EAC7B,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,IAAI,CAAC,CAiZf"}