@abapify/adt-contracts 0.4.1 → 0.4.3

package/dist/{base-BsgeOhzu.mjs → base-CJ5t6dbP.mjs}

@@ -1,4 +1,4 @@
-import { acoverageResult, acoverageStatements, adtcore, atc, atcRun, atcworklist, atomFeed, aunitResult, aunitRun, badi, blueSource, checkrun, classes, configuration, configurations as configurations$1, dataelementWrapper, dclSource, ddlSource, discovery, domain, fmodules, groups as groups$1, http as http$2, includes, interfaces, packagesV1, programs, servicebinding, srvdSource, systeminformation, tabletype, transportUseraction, transportfind, transportmanagment, transportmanagmentCreate, transportmanagmentSingle } from "./schemas.mjs";
+import { acoverageResult, acoverageStatements, adtcore, atc, atcRun, atcworklist, atomFeed, aunitResult, aunitRun, badi, blueSource, checkrun, classes, configuration, configurations as configurations$1, dataelementWrapper, dclSource, ddlSource, ddlxSource, discovery, domain, dtebSource, fmodules, groups as groups$1, http as http$2, includes, interfaces, objectProperties, packagesV1, programs, servicebinding, srvdSource, systeminformation, tabletype, transportUseraction, transportfind, transportmanagment, transportmanagmentCreate, transportmanagmentSingle } from "./schemas.mjs";
 import { createClient, http, http as http$1 } from "@abapify/speci/rest";
 
 //#region src/helpers/text-schema.ts
@@ -132,12 +132,21 @@ function createIncludeOperations(basePath, includeType, nameTransform) {
 function crud(options) {
 	const { basePath, schema, contentType, accept = contentType, nameTransform = (n) => n.toLowerCase(), sources, includes } = options;
 	return {
+		/** Schema for XML serialization/deserialization */
 		bodySchema: schema,
+		/**
+		* GET {basePath}/{name}
+		* Retrieve object metadata
+		*/
 		get: (name, queryOptions) => http.get(`${basePath}/${nameTransform(name)}`, {
 			responses: { 200: schema },
 			headers: { Accept: accept },
 			query: queryOptions?.version ? { version: queryOptions.version } : void 0
 		}),
+		/**
+		* POST {basePath}
+		* Create a new object
+		*/
 		post: (queryOptions) => http.post(basePath, {
 			body: schema,
 			responses: { 200: schema },
@@ -147,6 +156,10 @@ function crud(options) {
 			},
 			query: queryOptions?.corrNr ? { corrNr: queryOptions.corrNr } : void 0
 		}),
+		/**
+		* PUT {basePath}/{name}
+		* Update object metadata
+		*/
 		put: (name, queryOptions) => http.put(`${basePath}/${nameTransform(name)}`, {
 			body: schema,
 			responses: { 200: schema },
@@ -159,6 +172,10 @@ function crud(options) {
 				...queryOptions?.lockHandle ? { lockHandle: queryOptions.lockHandle } : {}
 			}
 		}),
+		/**
+		* DELETE {basePath}/{name}
+		* Delete object
+		*/
 		delete: (name, queryOptions) => http.delete(`${basePath}/${nameTransform(name)}`, {
 			responses: { 204: void 0 },
 			query: {
@@ -166,6 +183,13 @@ function crud(options) {
 				...queryOptions?.lockHandle ? { lockHandle: queryOptions.lockHandle } : {}
 			}
 		}),
+		/**
+		* POST {basePath}/{name}?_action=LOCK
+		* Lock object for modification
+		*
+		* Response contains lock handle in XML format:
+		* <asx:abap>...<DATA><LOCK_HANDLE>xxx</LOCK_HANDLE><CORRNR>yyy</CORRNR>...</DATA>...</asx:abap>
+		*/
 		lock: (name, lockOptions) => http.post(`${basePath}/${nameTransform(name)}`, {
 			responses: { 200: void 0 },
 			headers: {
@@ -179,6 +203,10 @@ function crud(options) {
 				...lockOptions?.corrNr ? { corrNr: lockOptions.corrNr } : {}
 			}
 		}),
+		/**
+		* POST {basePath}/{name}?_action=UNLOCK
+		* Unlock object
+		*/
 		unlock: (name, unlockOptions) => http.post(`${basePath}/${nameTransform(name)}`, {
 			responses: { 200: void 0 },
 			headers: {
@@ -191,6 +219,10 @@ function crud(options) {
 				lockHandle: unlockOptions.lockHandle
 			}
 		}),
+		/**
+		* GET {basePath}/{name}/objectstructure
+		* Get object structure (includes, methods, attributes, etc.)
+		*/
 		objectstructure: (name, structureOptions) => http.get(`${basePath}/${nameTransform(name)}/objectstructure`, {
 			responses: { 200: void 0 },
 			query: {
@@ -243,7 +275,11 @@ function repo(basePath, schema, contentType, nameTransform, accept) {
 /**
 * /sap/bc/adt/cts/transportrequests/valuehelp/attribute
 */
-const attribute = { get: (params) => http.get("/sap/bc/adt/cts/transportrequests/valuehelp/attribute", {
+const attribute = { 
+/**
+* GET /sap/bc/adt/cts/transportrequests/valuehelp/attribute{?maxItemCount}{&name}
+*/
+get: (params) => http.get("/sap/bc/adt/cts/transportrequests/valuehelp/attribute", {
 	query: params,
 	responses: { 200: void 0 },
 	headers: { Accept: "application/xml" }
@@ -254,7 +290,11 @@ const attribute = { get: (params) => http.get("/sap/bc/adt/cts/transportrequests
 /**
 * /sap/bc/adt/cts/transportrequests/valuehelp/target
 */
-const target = { get: (params) => http.get("/sap/bc/adt/cts/transportrequests/valuehelp/target", {
+const target = { 
+/**
+* GET /sap/bc/adt/cts/transportrequests/valuehelp/target{?maxItemCount}{&name}
+*/
+get: (params) => http.get("/sap/bc/adt/cts/transportrequests/valuehelp/target", {
 	query: params,
 	responses: { 200: void 0 },
 	headers: { Accept: "application/xml" }
@@ -265,7 +305,11 @@ const target = { get: (params) => http.get("/sap/bc/adt/cts/transportrequests/va
 /**
 * /sap/bc/adt/cts/transportrequests/valuehelp/ctsproject
 */
-const ctsproject = { get: (params) => http.get("/sap/bc/adt/cts/transportrequests/valuehelp/ctsproject", {
+const ctsproject = { 
+/**
+* GET /sap/bc/adt/cts/transportrequests/valuehelp/ctsproject{?maxItemCount}{&name}
+*/
+get: (params) => http.get("/sap/bc/adt/cts/transportrequests/valuehelp/ctsproject", {
 	query: params,
 	responses: { 200: void 0 },
 	headers: { Accept: "application/xml" }
@@ -276,7 +320,11 @@ const ctsproject = { get: (params) => http.get("/sap/bc/adt/cts/transportrequest
 /**
 * /sap/bc/adt/cts/transportrequests/valuehelp/object
 */
-const object = { get: (field, params) => http.get(`/sap/bc/adt/cts/transportrequests/valuehelp/object/${field}`, {
+const object = { 
+/**
+* GET /sap/bc/adt/cts/transportrequests/valuehelp/object/{field}{?maxItemCount}{&name}
+*/
+get: (field, params) => http.get(`/sap/bc/adt/cts/transportrequests/valuehelp/object/${field}`, {
 	query: params,
 	responses: { 200: void 0 },
 	headers: { Accept: "application/xml" }
@@ -312,14 +360,19 @@ const reference = { get: () => http.get("/sap/bc/adt/cts/transportrequests/refer
 * @schema configurations.xsd, configuration.xsd
 */
 const configurations = contract({
+	/** GET list of search configurations */
 	get: () => http$1.get("/sap/bc/adt/cts/transportrequests/searchconfiguration/configurations", {
 		responses: { 200: configurations$1 },
 		headers: { Accept: "application/vnd.sap.adt.configurations.v1+xml" }
 	}),
+	/** GET a specific configuration by ID */
 	getById: (_configId) => http$1.get("/sap/bc/adt/cts/transportrequests/searchconfiguration/configurations/${configId}", {
 		responses: { 200: configuration },
 		headers: { Accept: "application/vnd.sap.adt.configuration.v1+xml" }
 	}),
+	/** PUT update a specific configuration by ID - body type inferred from schema
+	*  Note: If-Match header is automatically added by the adapter from cached ETag
+	*/
 	put: (_configId) => http$1.put("/sap/bc/adt/cts/transportrequests/searchconfiguration/configurations/${configId}", {
 		responses: { 200: configuration },
 		headers: {
@@ -336,7 +389,9 @@ const configurations = contract({
 * /sap/bc/adt/cts/transportrequests/searchconfiguration/metadata
 * @schema configuration.xsd
 */
-const metadata = contract({ get: () => http$1.get("/sap/bc/adt/cts/transportrequests/searchconfiguration/metadata", {
+const metadata = contract({ 
+/** GET default search configuration metadata */
+get: () => http$1.get("/sap/bc/adt/cts/transportrequests/searchconfiguration/metadata", {
 	responses: { 200: configuration },
 	headers: { Accept: "application/vnd.sap.adt.configuration.metadata.v1+xml" }
 }) });
@@ -351,41 +406,95 @@ const searchconfiguration = {
 	metadata
 };
 
+//#endregion
+//#region src/adt/cts/transportrequests/change-owner-schema.ts
+function isChangeOwnerRoot(root) {
+	if (typeof root !== "object" || root === null) return false;
+	const { useraction, number, targetuser } = root;
+	return useraction === "changeowner" && typeof number === "string" && number.length > 0 && typeof targetuser === "string" && targetuser.length > 0;
+}
+/**
+* Narrow request schema for the CTS change-owner action.
+*
+* SAP models these attributes on the broader transport-management root. This
+* wrapper keeps the call-site body narrow while delegating XML parsing and
+* serialization to that generated SAP schema.
+*/
+const changeOwnerBodySchema = {
+	_infer: void 0,
+	parse: (raw) => {
+		const root = transportmanagment.parse(raw)?.root;
+		if (!isChangeOwnerRoot(root)) throw new Error("Invalid CTS change-owner body");
+		return { root: {
+			number: root.number,
+			targetuser: root.targetuser,
+			useraction: "changeowner"
+		} };
+	},
+	build: (body) => transportmanagment.build(body)
+};
+
+//#endregion
+//#region src/adt/cts/transportrequests/add-task-schema.ts
+/** Narrow body used by SAP's hypermedia `newtask` relation. */
+const addTaskBodySchema = {
+	_infer: void 0,
+	parse: (raw) => {
+		const root = transportmanagment.parse(raw)?.root;
+		if (!root || !root.targetuser) throw new Error("Invalid CTS add-task body");
+		return { root: { targetuser: root.targetuser } };
+	},
+	build: (body) => transportmanagment.build(body)
+};
+
 //#endregion
 //#region src/adt/cts/transportrequests/useraction.ts
 /**
 * /sap/bc/adt/cts/transportrequests - user-action body endpoints
 *
-* SAP ADT uses POST with a `<tm:root tm:useraction="...">` XML body for
-* release / changeowner / newrequest actions. This file exposes typed
-* endpoints that wrap those three operations.
+* SAP ADT uses distinct lifecycle endpoints for release, changeowner, and
+* newrequest and newtask actions. This file exposes typed contracts for them.
 *
-*   release       → POST /{trkorr}
-*   changeowner   → POST /{trkorr}    (requires tm:targetuser, optional tm:recursive)
+*   release       → POST /{trkorr}/newreleasejobs (no body)
+*   changeowner   → PUT  /{trkorr}    (requires tm:number and tm:targetuser)
+*   newtask       → POST /{trkorr}/tasks (requires tm:targetuser)
 *   newrequest    → POST /            (creates a new transport request)
-*
-* All three share the same namespace and content-type but differ in
-* request shape and URL, so we expose them as separate methods with
-* strongly-typed options while sharing a single schema.
 */
 const CONTENT_TYPE = "application/vnd.sap.adt.transportorganizer.v1+xml";
 const useraction = {
-	release: (trkorr) => http$1.post(`/sap/bc/adt/cts/transportrequests/${trkorr}`, {
-		body: transportUseraction,
+	/**
+	* Start and synchronously report a transport/task release job.
+	*/
+	release: (trkorr) => http$1.post(`/sap/bc/adt/cts/transportrequests/${trkorr}/newreleasejobs`, {
+		responses: { 200: transportmanagment },
+		headers: { Accept: CONTENT_TYPE }
+	}),
+	/**
+	* PUT /{trkorr} with useraction="changeowner".
+	*/
+	reassign: (trkorr, _options) => http$1.put(`/sap/bc/adt/cts/transportrequests/${trkorr}`, {
+		body: changeOwnerBodySchema,
 		responses: { 200: transportmanagmentSingle },
 		headers: {
 			Accept: CONTENT_TYPE,
 			"Content-Type": CONTENT_TYPE
 		}
 	}),
-	reassign: (trkorr, _options) => http$1.post(`/sap/bc/adt/cts/transportrequests/${trkorr}`, {
-		body: transportUseraction,
-		responses: { 200: transportmanagmentSingle },
+	/** Create a modifiable task below an existing request. */
+	addTask: (trkorr, _options) => http$1.post(`/sap/bc/adt/cts/transportrequests/${trkorr}/tasks`, {
+		body: addTaskBodySchema,
+		responses: { 200: transportmanagment },
 		headers: {
 			Accept: CONTENT_TYPE,
 			"Content-Type": CONTENT_TYPE
 		}
 	}),
+	/**
+	* POST / with useraction="newrequest"
+	*
+	* Creates a brand-new transport request. Body carries the nested
+	* tm:request / tm:task with desc / type / target / owner.
+	*/
 	create: (_options) => http$1.post("/sap/bc/adt/cts/transportrequests", {
 		body: transportUseraction,
 		responses: { 200: transportmanagmentSingle },
@@ -404,15 +513,18 @@ const useraction = {
 */
 /** Re-export schema for consumers that need direct parsing */
 const transportrequests = {
+	/** GET / - List transports */
 	list: (params) => http$1.get("/sap/bc/adt/cts/transportrequests", {
 		query: params,
 		responses: { 200: transportmanagment },
 		headers: { Accept: "*/*" }
 	}),
+	/** GET /{trkorr} - Get single transport */
 	get: (trkorr) => http$1.get(`/sap/bc/adt/cts/transportrequests/${trkorr}`, {
 		responses: { 200: transportmanagmentSingle },
 		headers: { Accept: "application/vnd.sap.adt.transportorganizer.v1+xml" }
 	}),
+	/** POST / - Create new transport (response has root/request structure like single) */
 	create: () => http$1.post("/sap/bc/adt/cts/transportrequests", {
 		body: transportmanagmentCreate,
 		responses: { 200: transportmanagmentSingle },
@@ -421,6 +533,7 @@ const transportrequests = {
 			"Content-Type": "application/xml"
 		}
 	}),
+	/** POST /{trkorr} - Action on transport (release, etc.) */
 	post: (trkorr) => http$1.post(`/sap/bc/adt/cts/transportrequests/${trkorr}`, {
 		body: transportmanagment,
 		responses: { 200: transportmanagment },
@@ -429,6 +542,7 @@ const transportrequests = {
 			"Content-Type": "application/xml"
 		}
 	}),
+	/** PUT /{trkorr} - Update transport */
 	put: (trkorr) => http$1.put(`/sap/bc/adt/cts/transportrequests/${trkorr}`, {
 		body: transportmanagment,
 		responses: { 200: transportmanagment },
@@ -437,6 +551,7 @@ const transportrequests = {
 			"Content-Type": "application/xml"
 		}
 	}),
+	/** DELETE /{trkorr} - Delete transport */
 	delete: (trkorr) => http$1.delete(`/sap/bc/adt/cts/transportrequests/${trkorr}`, { responses: { 204: void 0 } }),
 	reference,
 	valuehelp,
@@ -458,23 +573,36 @@ const transportrequests = {
 * Transport function codes (TRFUNCTION field)
 */
 const TransportFunction = {
+	/** Workbench request - development objects */
 	WORKBENCH: "K",
+	/** Customizing request - configuration */
 	CUSTOMIZING: "W",
+	/** Transport of copies */
 	TRANSPORT_OF_COPIES: "T",
+	/** Development/correction task */
 	DEVELOPMENT_CORRECTION: "S",
+	/** Repair task */
 	REPAIR: "R",
+	/** Unclassified task */
 	UNCLASSIFIED: "X",
+	/** Customizing task */
 	CUSTOMIZING_TASK: "Q",
+	/** Wildcard - all types */
 	ALL: "*"
 };
 /**
 * Transport status codes (TRSTATUS field) - for response parsing
 */
 const TransportStatus = {
+	/** Modifiable - can be edited */
 	MODIFIABLE: "D",
+	/** Release started - in progress */
 	RELEASE_STARTED: "O",
+	/** Release in preparation */
 	RELEASE_IN_PREPARATION: "P",
+	/** Released - locked, cannot be edited */
 	RELEASED: "R",
+	/** Locked */
 	LOCKED: "L"
 };
 /**
@@ -486,7 +614,30 @@ function normalizeTransportFindResponse(response) {
 	if (!headers) return [];
 	return Array.isArray(headers) ? headers : [headers];
 }
-const transports = { find: (params) => http.get("/sap/bc/adt/cts/transports", {
+const transports = { 
+/**
+* Search transports with filters
+*
+* GET /sap/bc/adt/cts/transports?_action=FIND&user=X&trfunction=*
+*
+* @example
+* // Find all modifiable workbench requests for current user
+* const result = await client.cts.transports.find({
+*   _action: 'FIND',
+*   user: 'PPLENKOV',
+*   trfunction: '*',
+* });
+*
+* @example
+* // Find with status filter
+* const result = await client.cts.transports.find({
+*   _action: 'FIND',
+*   user: '*',
+*   trfunction: 'K',
+*   requestStatus: 'D',  // Modifiable only
+* });
+*/
+find: (params) => http.get("/sap/bc/adt/cts/transports", {
 	query: params,
 	responses: { 200: transportfind },
 	headers: { Accept: "*/*" }
@@ -498,7 +649,11 @@ const transports = { find: (params) => http.get("/sap/bc/adt/cts/transports", {
 * /sap/bc/adt/cts/transportchecks
 * @source transportchecks.json
 */
-const transportchecks = { get: () => http.get("/sap/bc/adt/cts/transportchecks", {
+const transportchecks = { 
+/**
+* GET /sap/bc/adt/cts/transportchecks
+*/
+get: () => http.get("/sap/bc/adt/cts/transportchecks", {
 	responses: { 200: void 0 },
 	headers: { Accept: "application/xml" }
 }) };
@@ -532,11 +687,17 @@ const ctsContract = {
 * @generated - DO NOT EDIT MANUALLY
 */
 const worklistsContract = contract({
+	/**
+	* GET ATC worklist
+	*/
 	get: (worklistId, params) => http$1.get(`/sap/bc/adt/atc/worklists/${worklistId}`, {
 		query: params,
 		responses: { 200: atcworklist },
 		headers: { Accept: "*/*" }
 	}),
+	/**
+	* GET ATC worklist
+	*/
 	objectset: (worklistId, objectSetName, params) => http$1.get(`/sap/bc/adt/atc/worklists/${worklistId}/${objectSetName}`, {
 		query: params,
 		responses: { 200: atcworklist },
@@ -555,31 +716,49 @@ const worklistsContract = contract({
 * @generated - DO NOT EDIT MANUALLY
 */
 const resultsContract = contract({
+	/**
+	* GET ATC results
+	*/
 	active: (params) => http$1.get("/sap/bc/adt/atc/results", {
 		query: params,
 		responses: { 200: atcworklist },
 		headers: { Accept: "application/xml" }
 	}),
+	/**
+	* GET ATC results
+	*/
 	activeforsysid: (params) => http$1.get("/sap/bc/adt/atc/results", {
 		query: params,
 		responses: { 200: atcworklist },
 		headers: { Accept: "application/xml" }
 	}),
+	/**
+	* GET ATC results
+	*/
 	user: (params) => http$1.get("/sap/bc/adt/atc/results", {
 		query: params,
 		responses: { 200: atcworklist },
 		headers: { Accept: "application/xml" }
 	}),
+	/**
+	* GET ATC results
+	*/
 	central: (params) => http$1.get("/sap/bc/adt/atc/results", {
 		query: params,
 		responses: { 200: atcworklist },
 		headers: { Accept: "application/xml" }
 	}),
+	/**
+	* GET ATC results
+	*/
 	centralforsysid: (params) => http$1.get("/sap/bc/adt/atc/results", {
 		query: params,
 		responses: { 200: atcworklist },
 		headers: { Accept: "application/xml" }
 	}),
+	/**
+	* GET ATC results
+	*/
 	displayid: (displayId, params) => http$1.get(`/sap/bc/adt/atc/results/${displayId}`, {
 		query: params,
 		responses: { 200: atcworklist },
@@ -606,7 +785,11 @@ const resultsContract = contract({
 *
 * NOTE: Not in SAP discovery - manually defined
 */
-const customizing = contract({ get: () => http$1.get("/sap/bc/adt/atc/customizing", {
+const customizing = contract({ 
+/**
+* GET /sap/bc/adt/atc/customizing
+*/
+get: () => http$1.get("/sap/bc/adt/atc/customizing", {
 	responses: { 200: atc },
 	headers: { Accept: "application/xml" }
 }) });
@@ -616,7 +799,12 @@ const customizing = contract({ get: () => http$1.get("/sap/bc/adt/atc/customizin
 * NOTE: POST endpoint with body - not in SAP discovery
 * @source atcruns.json
 */
-const runs = contract({ post: (params) => http$1.post("/sap/bc/adt/atc/runs", {
+const runs = contract({ 
+/**
+* POST /sap/bc/adt/atc/runs{?worklistId,clientWait}
+* Run ATC checks on objects specified in the request body
+*/
+post: (params) => http$1.post("/sap/bc/adt/atc/runs", {
 	query: params,
 	body: atcRun,
 	responses: { 200: atcworklist },
@@ -630,7 +818,14 @@ const runs = contract({ post: (params) => http$1.post("/sap/bc/adt/atc/runs", {
 *
 * Adds POST (create) endpoint not in generated contract
 */
-const worklistsExtended = contract({ create: (params) => http$1.post("/sap/bc/adt/atc/worklists", {
+const worklistsExtended = contract({ 
+/**
+* POST /sap/bc/adt/atc/worklists{?checkVariant}
+* Create a new ATC worklist
+*
+* NOTE: Not in SAP discovery - manually defined
+*/
+create: (params) => http$1.post("/sap/bc/adt/atc/worklists", {
 	query: params,
 	responses: { 200: atcworklist },
 	headers: { Accept: "*/*" }
@@ -653,51 +848,6 @@ const atcContract = {
 	}
 };
 
-//#endregion
-//#region src/adt/aunit/coverage-link.ts
-/**
-* Coverage link helper for AUnit responses.
-*
-* When coverage is enabled on an ABAP Unit run, the aunit:runResult
-* contains an atom:link with `rel` referring to the coverage measurement.
-* Example:
-*
-*   <atom:link href="/sap/bc/adt/runtime/traces/coverage/measurements/6D664D9B46CB1FE1859107ADE8729541"
-*              rel="http://www.sap.com/adt/relations/runtime/traces/coverage/measurements"/>
-*
-* The measurement ID is the hex segment after /measurements/.
-*/
-const COVERAGE_MEASUREMENT_HREF_RE = /\/sap\/bc\/adt\/runtime\/traces\/coverage\/measurements\/([A-Fa-f0-9]+)/;
-/**
-* Walk the given node (and, shallowly, its top-level children) searching
-* for an atom:link whose href points to a coverage measurement. Returns
-* the measurement ID (hex string) if found, otherwise undefined.
-*/
-function extractCoverageMeasurementId(result) {
-	if (!result || typeof result !== "object") return void 0;
-	const seen = /* @__PURE__ */ new Set();
-	const queue = [result];
-	while (queue.length > 0) {
-		const current = queue.shift();
-		if (!current || typeof current !== "object" || seen.has(current)) continue;
-		seen.add(current);
-		const obj = current;
-		const links = obj.link;
-		let linkList;
-		if (Array.isArray(links)) linkList = links;
-		else if (links && typeof links === "object") linkList = [links];
-		else linkList = [];
-		for (const link of linkList) {
-			const href = link && typeof link === "object" ? link.href ?? void 0 : void 0;
-			if (!href) continue;
-			const match = COVERAGE_MEASUREMENT_HREF_RE.exec(href);
-			if (match) return match[1];
-		}
-		for (const value of Object.values(obj)) if (Array.isArray(value)) for (const v of value) queue.push(v);
-		else if (value && typeof value === "object") queue.push(value);
-	}
-}
-
 //#endregion
 //#region src/adt/aunit/index.ts
 /**
@@ -715,7 +865,14 @@ function extractCoverageMeasurementId(result) {
 *
 * NOTE: Not in SAP discovery - manually defined
 */
-const testruns = contract({ post: () => http$1.post("/sap/bc/adt/abapunit/testruns", {
+const testruns = contract({ 
+/**
+* POST /sap/bc/adt/abapunit/testruns
+* Execute ABAP Unit test run with a runConfiguration body
+*
+* @returns runResult with programs, test classes, methods, and alerts
+*/
+post: () => http$1.post("/sap/bc/adt/abapunit/testruns", {
 	body: aunitRun,
 	responses: { 200: aunitResult },
 	headers: {
@@ -806,7 +963,12 @@ const interfacesContract = crud({
 * /sap/bc/adt/oo/classrun
 * Execute console application classes (IF_OO_ADT_CLASSRUN)
 */
-const classrunContract = contract({ post: (classname, params) => http$1.post(`/sap/bc/adt/oo/classrun/${classname.toLowerCase()}`, {
+const classrunContract = contract({ 
+/**
+* POST /sap/bc/adt/oo/classrun/{classname}{?profilerId}
+* Execute a class implementing IF_OO_ADT_CLASSRUN
+*/
+post: (classname, params) => http$1.post(`/sap/bc/adt/oo/classrun/${classname.toLowerCase()}`, {
 	query: params,
 	responses: { 200: void 0 },
 	headers: { Accept: "text/plain" }
@@ -828,7 +990,17 @@ const ooContract = {
 * Endpoint: GET /sap/bc/adt/discovery
 * Returns AtomPub service document describing available ADT services.
 */
-const discoveryContract = { getDiscovery: () => http$1.get("/sap/bc/adt/discovery", {
+const discoveryContract = { 
+/**
+* Get Discovery Information
+*
+* Returns the ADT service discovery document in AtomPub format.
+* This document describes all available ADT services, workspaces, and collections.
+*
+* @endpoint GET /sap/bc/adt/discovery
+* @returns AtomPub service document with workspace and collection information
+*/
+getDiscovery: () => http$1.get("/sap/bc/adt/discovery", {
 	responses: { 200: discovery },
 	headers: { Accept: "application/atomsvc+xml" }
 }) };
@@ -851,13 +1023,25 @@ const discoveryContract = { getDiscovery: () => http$1.get("/sap/bc/adt/discover
 * // Create a new package
 * await client.adt.packages.post({ corrNr: 'DEVK900001' });
 */
-const packagesContract = crud({
+const packageCrudContract = crud({
 	basePath: "/sap/bc/adt/packages",
 	schema: packagesV1,
 	contentType: "application/vnd.sap.adt.packages.v2+xml",
 	accept: "application/vnd.sap.adt.packages.v2+xml, application/vnd.sap.adt.packages.v1+xml",
 	nameTransform: (n) => encodeURIComponent(n)
 });
+/**
+* Typed package operations which are not CRUD-shaped. The discovery document
+* advertises this as `/sap/bc/adt/packages/$tree{?packagename,type}`.
+*/
+const packagesContract = contract({
+	...packageCrudContract,
+	tree: (params) => http$1.get("/sap/bc/adt/packages/$tree", {
+		query: params,
+		responses: { 200: packagesV1 },
+		headers: { Accept: "application/vnd.sap.adt.packages.v2+xml" }
+	})
+});
 
 //#endregion
 //#region src/adt/core/http/sessions.ts
@@ -867,7 +1051,18 @@ const packagesContract = crud({
 * HTTP session management and CSRF token initialization.
 * Path: /sap/bc/adt/core/http/sessions
 */
-const sessionsContract = { getSession: () => http$1.get("/sap/bc/adt/core/http/sessions", {
+const sessionsContract = { 
+/**
+* Get or create an HTTP session
+* Also initializes CSRF token for subsequent requests
+*
+* Uses x-sap-security-session: create to establish a proper security session.
+* All subsequent operations should use x-sap-security-session: use to stay
+* within the same security session (required for lock/unlock).
+*
+* @returns Session information with CSRF token and links
+*/
+getSession: () => http$1.get("/sap/bc/adt/core/http/sessions", {
 	responses: { 200: http$2 },
 	headers: {
 		Accept: "application/vnd.sap.adt.core.http.session.v3+xml",
@@ -885,7 +1080,13 @@ const sessionsContract = { getSession: () => http$1.get("/sap/bc/adt/core/http/s
 * Returns system information including SAP release, client, user details.
 * Path: /sap/bc/adt/core/http/systeminformation
 */
-const systeminformationContract = contract({ getSystemInfo: () => http$1.get("/sap/bc/adt/core/http/systeminformation", {
+const systeminformationContract = contract({ 
+/**
+* Get system information
+*
+* @returns System information (systemID, client, userName, etc.)
+*/
+getSystemInfo: () => http$1.get("/sap/bc/adt/core/http/systeminformation", {
 	responses: { 200: systeminformation },
 	headers: { Accept: "application/vnd.sap.adt.core.http.systeminformation.v1+json" }
 }) });
@@ -909,7 +1110,32 @@ const coreContract = { http: httpContract };
 * ABAP object search operations.
 * Path: /sap/bc/adt/repository/informationsystem/search
 */
-const searchContract = { quickSearch: (options) => http$1.get("/sap/bc/adt/repository/informationsystem/search", {
+const searchContract = { 
+/**
+* Quick search for ABAP objects
+*
+* @param query - Search query (supports wildcards like *)
+* @param maxResults - Maximum number of results (default: 50)
+* @param packageName - Filter by package name
+* @param objectType - Filter by object type (e.g., 'CLAS', 'INTF')
+* @returns Object references matching the search query (union of all adtcore element types)
+*
+* @example
+* // Search for classes starting with ZCL
+* const results = await client.repository.informationsystem.search.quickSearch({
+*   query: 'zcl*',
+*   maxResults: 10
+* });
+*
+* @example
+* // List all objects in a package
+* const results = await client.repository.informationsystem.search.quickSearch({
+*   query: '*',
+*   packageName: 'ZABAPGIT_EXAMPLES',
+*   maxResults: 200
+* });
+*/
+quickSearch: (options) => http$1.get("/sap/bc/adt/repository/informationsystem/search", {
 	query: {
 		operation: "quickSearch",
 		query: options.query,
@@ -983,9 +1209,10 @@ function buildUsageReferenceRequestXml(scopeResultXml) {
 		const prologEnd = noProlog.indexOf("?>");
 		if (prologEnd !== -1) noProlog = noProlog.slice(prologEnd + 2).replace(/^\s+/, "");
 	}
+	const scopeElement = noProlog.replaceAll(/usagereferences:usageScopeResult/g, "usagereferences:scope");
 	return `<?xml version="1.0" encoding="UTF-8"?>
 <usagereferences:usageReferenceRequest xmlns:usagereferences="${USAGEREFS_NAMESPACE}">\n  <usagereferences:affectedObjects/>
-  ${noProlog.replaceAll(/usagereferences:usageScopeResult/g, "usagereferences:scope")}\n</usagereferences:usageReferenceRequest>`;
+  ${scopeElement}\n</usagereferences:usageReferenceRequest>`;
 }
 /**
 * Step 1: fetch the default scope for a given object URI.
@@ -1026,11 +1253,80 @@ const usageReferencesContract = {
 	search
 };
 
+//#endregion
+//#region src/adt/repository/sourceversions.ts
+/**
+* ADT Repository source-history contracts.
+*
+* Both operations follow URIs supplied by SAP ADT responses. They deliberately
+* do not construct version paths from an object URI.
+*/
+const ADT_ORIGIN = "https://adt.invalid";
+const ADT_PATH = "/sap/bc/adt";
+const INVALID_URI_MESSAGE = "Expected an ADT-relative URI under /sap/bc/adt";
+/**
+* Guard an opaque ADT URI supplied by SAP before we turn it into an
+* authenticated request.  Other contracts which accept SAP-discovered URIs
+* share this boundary rather than reimplementing a slightly different URL
+* policy.
+*/
+function assertAdtRelativeUri(uri) {
+	let parsed;
+	try {
+		parsed = new URL(uri, ADT_ORIGIN);
+	} catch {
+		throw new TypeError(INVALID_URI_MESSAGE);
+	}
+	const isRootRelative = uri.startsWith("/") && !uri.startsWith("//");
+	const isAdtPath = parsed.pathname === ADT_PATH || parsed.pathname.startsWith(`${ADT_PATH}/`);
+	if (uri !== uri.trim() || !isRootRelative || parsed.origin !== ADT_ORIGIN || !isAdtPath || parsed.hash) throw new TypeError(INVALID_URI_MESSAGE);
+}
+const sourceversionsContract = contract({
+	list: (params) => {
+		assertAdtRelativeUri(params.versionsUri);
+		return http$1.get(params.versionsUri, {
+			responses: { 200: atomFeed },
+			headers: { Accept: "application/atom+xml;type=feed" }
+		});
+	},
+	get: (params) => {
+		assertAdtRelativeUri(params.sourceUri);
+		return http$1.get(params.sourceUri, {
+			responses: { 200: void 0 },
+			headers: { Accept: "text/plain" }
+		});
+	}
+});
+
+//#endregion
+//#region src/adt/repository/informationsystem/objectproperties.ts
+/**
+* ADT Repository Information System — object properties.
+*
+* SAP supplies the canonical object URI through quick search or object
+* metadata.  This endpoint enriches it with generic facets such as package
+* and application component; it does not construct an object-specific URL.
+*/
+const OBJECT_PROPERTIES_RESULT_MIME = "application/vnd.sap.adt.repository.objproperties.result.v1+xml";
+const objectPropertiesContract = { values: (params) => {
+	assertAdtRelativeUri(params.uri);
+	const facets = [...new Set(params.facets ?? [])].filter((facet) => facet.trim().length > 0);
+	return http$1.get("/sap/bc/adt/repository/informationsystem/objectproperties/values", {
+		query: {
+			uri: params.uri,
+			...facets.length > 0 ? { facet: facets } : {}
+		},
+		responses: { 200: objectProperties },
+		headers: { Accept: OBJECT_PROPERTIES_RESULT_MIME }
+	});
+} };
+
 //#endregion
 //#region src/adt/repository/informationsystem/index.ts
 const informationsystemContract = {
 	search: searchContract,
-	usageReferences: usageReferencesContract
+	usageReferences: usageReferencesContract,
+	objectProperties: objectPropertiesContract
 };
 
 //#endregion
@@ -1062,7 +1358,8 @@ const objectstructureContract = contract({ get: (params) => http$1.get(`${params
 //#region src/adt/repository/index.ts
 const repositoryContract = {
 	informationsystem: informationsystemContract,
-	objectstructure: objectstructureContract
+	objectstructure: objectstructureContract,
+	sourceversions: sourceversionsContract
 };
 
 //#endregion
@@ -1178,10 +1475,12 @@ const basePath$4 = "/sap/bc/adt/functions/groups/${groupName}/fmodules";
 * CRUD operations for function modules within a function group
 */
 const functionModulesContract = contract({
+	/** GET .../fmodules/{fmName} - Get function module metadata */
 	get: (_groupName, _fmName) => http$1.get(basePath$4 + "/${fmName}", {
 		responses: { 200: fmodules },
 		headers: { Accept: accept$2 }
 	}),
+	/** POST .../fmodules - Create function module */
 	post: (groupName, queryOptions) => http$1.post(basePath$4, {
 		body: fmodules,
 		responses: { 200: fmodules },
@@ -1191,6 +1490,7 @@ const functionModulesContract = contract({
 		},
 		query: queryOptions?.corrNr ? { corrNr: queryOptions.corrNr } : void 0
 	}),
+	/** PUT .../fmodules/{fmName} - Update function module metadata */
 	put: (groupName, fmName, options) => http$1.put(basePath$4 + "/${fmName}", {
 		body: fmodules,
 		responses: { 200: fmodules },
@@ -1203,6 +1503,7 @@ const functionModulesContract = contract({
 			...options?.corrNr ? { corrNr: options.corrNr } : {}
 		}
 	}),
+	/** DELETE .../fmodules/{fmName} - Delete function module */
 	delete: (groupName, fmName, options) => http$1.delete(basePath$4 + "/${fmName}", {
 		responses: { 204: void 0 },
 		query: {
@@ -1210,6 +1511,7 @@ const functionModulesContract = contract({
 			...options?.corrNr ? { corrNr: options.corrNr } : {}
 		}
 	}),
+	/** POST .../fmodules/{fmName}?_action=LOCK - Lock function module */
 	lock: (groupName, fmName, options) => http$1.post(basePath$4 + "/${fmName}", {
 		responses: { 200: void 0 },
 		headers: {
@@ -1223,6 +1525,7 @@ const functionModulesContract = contract({
 			...options?.corrNr ? { corrNr: options.corrNr } : {}
 		}
 	}),
+	/** POST .../fmodules/{fmName}?_action=UNLOCK - Unlock function module */
 	unlock: (groupName, fmName, options) => http$1.post(basePath$4 + "/${fmName}", {
 		responses: { 200: void 0 },
 		headers: {
@@ -1235,11 +1538,14 @@ const functionModulesContract = contract({
 			lockHandle: options.lockHandle
 		}
 	}),
+	/** Source code operations */
 	source: { main: {
+		/** GET .../fmodules/{fmName}/source/main - Get source code */
 		get: (_groupName, _fmName) => http$1.get(basePath$4 + "/${fmName}/source/main", {
 			responses: { 200: void 0 },
 			headers: { Accept: "text/plain" }
 		}),
+		/** PUT .../fmodules/{fmName}/source/main - Update source code */
 		put: (groupName, fmName, options) => http$1.put(basePath$4 + "/${fmName}/source/main", {
 			body: textPlain,
 			responses: { 200: void 0 },
@@ -1367,7 +1673,9 @@ const tablesContract = {
 * typed as a plain-text endpoint.
 */
 const basePath$1 = "/sap/bc/adt/ddic/db/settings";
-const tablesettingsContract = contract({ get: (name) => http$1.get(`${basePath$1}/${name.toLowerCase()}`, {
+const tablesettingsContract = contract({ 
+/** GET /sap/bc/adt/ddic/db/settings/{name} - Retrieve table settings XML */
+get: (name) => http$1.get(`${basePath$1}/${name.toLowerCase()}`, {
 	responses: { 200: void 0 },
 	headers: { Accept: "application/vnd.sap.adt.table.settings.v2+xml" }
 }) });
@@ -1394,7 +1702,7 @@ const tabletypesContract = crud({
 * ADT CDS DDL Source Contract
 *
 * Endpoint: /sap/bc/adt/ddic/ddl/sources
-* Content-Type: application/vnd.sap.adt.ddl.source.v2+xml
+* Content-Type: application/vnd.sap.adt.ddlSource+xml
 * Object type: DDLS
 *
 * CDS Data Definition sources — the SAP endpoint for CDS views / data
@@ -1404,8 +1712,9 @@ const tabletypesContract = crud({
 const ddlSourcesContract = crud({
 	basePath: "/sap/bc/adt/ddic/ddl/sources",
 	schema: ddlSource,
-	contentType: "application/vnd.sap.adt.ddl.source.v2+xml",
-	accept: "application/vnd.sap.adt.ddl.source.v2+xml, application/vnd.sap.adt.ddl.source.v1+xml",
+	contentType: "application/vnd.sap.adt.ddlSource+xml",
+	accept: "application/vnd.sap.adt.ddlSource+xml",
+	nameTransform: (name) => encodeURIComponent(name.toLowerCase()),
 	sources: ["main"]
 });
 
@@ -1422,14 +1731,15 @@ const ddlContract = { sources: ddlSourcesContract };
 *   (Note: the SAP endpoint for DCL sources lives under `acm/dcl`, not
 *   `ddic/dcl`. The contract is exported under `ddic.dcl` for API
 *   parity with the ADK and the sibling DDL contract.)
-* Content-Type: application/vnd.sap.adt.acm.dcl.source.v1+xml
+* Content-Type: application/vnd.sap.adt.dclSource+xml
 * Object type: DCLS
 */
 const dclSourcesContract = crud({
 	basePath: "/sap/bc/adt/acm/dcl/sources",
 	schema: dclSource,
-	contentType: "application/vnd.sap.adt.acm.dcl.source.v1+xml",
-	accept: "application/vnd.sap.adt.acm.dcl.source.v1+xml",
+	contentType: "application/vnd.sap.adt.dclSource+xml",
+	accept: "application/vnd.sap.adt.dclSource+xml",
+	nameTransform: (name) => encodeURIComponent(name.toLowerCase()),
 	sources: ["main"]
 });
 
@@ -1437,6 +1747,73 @@ const dclSourcesContract = crud({
 //#region src/adt/ddic/dcl/index.ts
 const dclContract = { sources: dclSourcesContract };
 
+//#endregion
+//#region src/adt/ddic/ddlx/sources.ts
+const ddlxSourcesContract = crud({
+	basePath: "/sap/bc/adt/ddic/ddlx/sources",
+	schema: ddlxSource,
+	contentType: "application/vnd.sap.adt.ddic.ddlx.v1+xml",
+	accept: "application/vnd.sap.adt.ddic.ddlx.v1+xml",
+	nameTransform: (name) => encodeURIComponent(name.toLowerCase()),
+	sources: ["main"]
+});
+
+//#endregion
+//#region src/adt/ddic/ddlx/index.ts
+const ddlxContract = { sources: ddlxSourcesContract };
+
+//#endregion
+//#region src/adt/ddic/dsfd/sources.ts
+const dsfdSourcesContract = crud({
+	basePath: "/sap/bc/adt/ddic/dsfd/sources",
+	schema: blueSource,
+	contentType: "application/vnd.sap.adt.blues.v1+xml",
+	accept: "application/vnd.sap.adt.blues.v1+xml",
+	nameTransform: (name) => encodeURIComponent(name.toLowerCase()),
+	sources: ["main"]
+});
+
+//#endregion
+//#region src/adt/ddic/dsfd/index.ts
+const dsfdContract = { sources: dsfdSourcesContract };
+
+//#endregion
+//#region src/adt/ddic/dsfi/index.ts
+const dsfiDefinitionSchema = {
+	_infer: void 0,
+	parse: (raw) => JSON.parse(raw),
+	build: (value) => JSON.stringify(value)
+};
+const baseContract$1 = crud({
+	basePath: "/sap/bc/adt/ddic/dsfi",
+	schema: blueSource,
+	contentType: "application/vnd.sap.adt.blues.v1+xml",
+	accept: "application/vnd.sap.adt.blues.v1+xml",
+	nameTransform: (name) => encodeURIComponent(name.toLowerCase())
+});
+const dsfiContract = {
+	...baseContract$1,
+	source: { main: { get: (name) => http.get(`/sap/bc/adt/ddic/dsfi/${encodeURIComponent(name.toLowerCase())}/source/main`, {
+		responses: { 200: dsfiDefinitionSchema },
+		headers: { Accept: "application/json" }
+	}) } }
+};
+
+//#endregion
+//#region src/adt/ddic/dteb/sources.ts
+const dtebSourcesContract = crud({
+	basePath: "/sap/bc/adt/ddic/dteb/sources",
+	schema: dtebSource,
+	contentType: "application/vnd.sap.adt.ddic.dteb.v1+xml",
+	accept: "application/vnd.sap.adt.ddic.dteb.v1+xml",
+	nameTransform: (name) => encodeURIComponent(name.toLowerCase()),
+	sources: ["main"]
+});
+
+//#endregion
+//#region src/adt/ddic/dteb/index.ts
+const dtebContract = { sources: dtebSourcesContract };
+
 //#endregion
 //#region src/adt/ddic/srvd/sources.ts
 /**
@@ -1458,6 +1835,7 @@ const srvdSourcesContract = crud({
 	schema: srvdSource,
 	contentType: "application/vnd.sap.adt.ddic.srvd.v1+xml",
 	accept: "application/vnd.sap.adt.ddic.srvd.v1+xml",
+	nameTransform: (name) => encodeURIComponent(name.toLowerCase()),
 	sources: ["main"]
 });
 
@@ -1476,6 +1854,10 @@ const ddicContract = {
 	tabletypes: tabletypesContract,
 	ddl: ddlContract,
 	dcl: dclContract,
+	ddlx: ddlxContract,
+	dsfd: dsfdContract,
+	dsfi: dsfiContract,
+	dteb: dtebContract,
 	srvd: srvdContract
 };
 
@@ -1488,6 +1870,16 @@ const ddicContract = {
 * Path: /sap/bc/adt/system/users
 */
 const usersContract = {
+	/**
+	* Search for users by query string
+	*
+	* @param options.querystring - Search query (supports wildcards like *)
+	* @param options.maxcount - Maximum number of results
+	* @returns Atom feed with matching user entries (id = username, title = full name)
+	*
+	* @example
+	* const results = await client.system.users.search({ querystring: 'DEV*', maxcount: 10 });
+	*/
 	search: (options) => http$1.get("/sap/bc/adt/system/users", {
 		query: {
 			querystring: options.querystring,
@@ -1496,6 +1888,15 @@ const usersContract = {
 		responses: { 200: atomFeed },
 		headers: { Accept: "application/atom+xml;type=feed" }
 	}),
+	/**
+	* Get a specific user by username
+	*
+	* @param username - SAP username (e.g., 'DEVELOPER')
+	* @returns Atom feed with a single user entry
+	*
+	* @example
+	* const user = await client.system.users.get('DEVELOPER');
+	*/
 	get: (username) => http$1.get(`/sap/bc/adt/system/users/${encodeURIComponent(username)}`, {
 		responses: { 200: atomFeed },
 		headers: { Accept: "application/atom+xml;type=feed" }
@@ -1525,22 +1926,47 @@ const usersContract = {
 */
 const pemBody = { _infer: void 0 };
 const psesContract = {
+	/**
+	* List all Personal Security Environments (identities).
+	*
+	* `GET /sap/bc/adt/system/security/pses`
+	*/
 	list: () => http$1.get("/sap/bc/adt/system/security/pses", {
 		responses: { 200: atomFeed },
 		headers: { Accept: "application/atom+xml;type=feed" }
 	}),
+	/**
+	* Get a single PSE identified by `{context}/{applic}`.
+	*
+	* `GET /sap/bc/adt/system/security/pses/{context}/{applic}`
+	*/
 	get: (context, applic) => http$1.get(`/sap/bc/adt/system/security/pses/${encodeURIComponent(context)}/${encodeURIComponent(applic)}`, {
 		responses: { 200: atomFeed },
 		headers: { Accept: "application/atom+xml;type=feed" }
 	}),
+	/**
+	* List certificates inside a PSE.
+	*
+	* `GET /sap/bc/adt/system/security/pses/{context}/{applic}/certificates`
+	*/
 	listCertificates: (context, applic) => http$1.get(`/sap/bc/adt/system/security/pses/${encodeURIComponent(context)}/${encodeURIComponent(applic)}/certificates`, {
 		responses: { 200: atomFeed },
 		headers: { Accept: "application/atom+xml;type=feed" }
 	}),
+	/**
+	* Fetch the PEM of a single certificate in a PSE.
+	*
+	* `GET /sap/bc/adt/system/security/pses/{context}/{applic}/certificates/{id}`
+	*/
 	getCertificate: (context, applic, id) => http$1.get(`/sap/bc/adt/system/security/pses/${encodeURIComponent(context)}/${encodeURIComponent(applic)}/certificates/${encodeURIComponent(id)}`, {
 		responses: { 200: void 0 },
 		headers: { Accept: "application/x-pem-file" }
 	}),
+	/**
+	* Upload a PEM certificate into a PSE. The body is the PEM text.
+	*
+	* `POST /sap/bc/adt/system/security/pses/{context}/{applic}/certificates`
+	*/
 	uploadCertificate: (context, applic) => http$1.post(`/sap/bc/adt/system/security/pses/${encodeURIComponent(context)}/${encodeURIComponent(applic)}/certificates`, {
 		body: pemBody,
 		responses: { 200: atomFeed },
@@ -1549,6 +1975,11 @@ const psesContract = {
 			"Content-Type": "application/x-pem-file"
 		}
 	}),
+	/**
+	* Delete a certificate from a PSE.
+	*
+	* `DELETE /sap/bc/adt/system/security/pses/{context}/{applic}/certificates/{id}`
+	*/
 	deleteCertificate: (context, applic, id) => http$1.delete(`/sap/bc/adt/system/security/pses/${encodeURIComponent(context)}/${encodeURIComponent(applic)}/certificates/${encodeURIComponent(id)}`, { responses: { 204: void 0 } })
 };
 
@@ -1578,7 +2009,15 @@ const systemContract = {
 * Request body: checkObjectList (chkrun:CheckObjectList)
 * Response:     checkRunReports (chkrun:CheckReportList)
 */
-const checkObjects = contract({ post: () => http$1.post("/sap/bc/adt/checkruns", {
+const checkObjects = contract({ 
+/**
+* POST /sap/bc/adt/checkruns
+* Submit a checkObjectList and receive checkRunReports.
+*
+* Both request and response use the same `checkrun` schema (union discriminated
+* by the root element: `checkObjectList` for requests, `checkRunReports` for responses).
+*/
+post: () => http$1.post("/sap/bc/adt/checkruns", {
 	body: checkrun,
 	responses: { 200: checkrun },
 	headers: {
@@ -1609,7 +2048,15 @@ const checkrunsContract = { checkObjects };
 * Activate one or more ABAP objects.
 * Request body: adtcore:objectReferences  (AdtcoreSchema variant)
 */
-const activate = contract({ post: (params) => http$1.post("/sap/bc/adt/activation", {
+const activate = contract({ 
+/**
+* POST /sap/bc/adt/activation{?method,preauditRequested}
+*
+* Submit an objectReferences body to activate the listed objects.
+* The `method` query param selects the action (default: "activate").
+* The response XML is not strictly typed here – callers may ignore it.
+*/
+post: (params) => http$1.post("/sap/bc/adt/activation", {
 	query: params,
 	body: adtcore,
 	responses: { 200: adtcore },
@@ -1667,7 +2114,9 @@ const dataPreviewFreestyleRequestSchema = {
 *   Accept:       application/json
 *   Body:         raw ABAP SQL SELECT statement
 */
-const freestyle = { post: (query) => http$1.post("/sap/bc/adt/datapreview/freestyle", {
+const freestyle = { 
+/** POST /datapreview/freestyle - execute a free-style SQL query */
+post: (query) => http$1.post("/sap/bc/adt/datapreview/freestyle", {
 	body: dataPreviewFreestyleRequestSchema,
 	responses: { 200: dataPreviewFreestyleResponseSchema },
 	headers: {
@@ -1690,6 +2139,74 @@ const freestyle = { post: (query) => http$1.post("/sap/bc/adt/datapreview/freest
 */
 const datapreviewContract = { freestyle };
 
+//#endregion
+//#region src/adt/runtime/traces/coverage/request.ts
+const COVERAGE_NAMESPACE = "http://www.sap.com/adt/cov";
+const ADT_CORE_NAMESPACE = "http://www.sap.com/adt/core";
+const STATEMENTS_RELATION = "http://www.sap.com/adt/relations/runtime/traces/coverage/results/statements";
+const coverageXmlBody = {
+	parse: (value) => String(value),
+	build: (value) => value,
+	_infer: void 0
+};
+function escapeXmlAttribute(value) {
+	return value.replaceAll("&", "&amp;").replaceAll("\"", "&quot;").replaceAll("<", "&lt;").replaceAll(">", "&gt;");
+}
+function buildCoverageQuery(objectUris) {
+	const objectReferences = objectUris.map((uri) => `<adtcore:objectReference adtcore:uri="${escapeXmlAttribute(uri)}"/>`).join("\n");
+	return `<?xml version="1.0" encoding="UTF-8"?>
+<cov:query xmlns:cov="${COVERAGE_NAMESPACE}">
+<adtcore:objectSets xmlns:adtcore="${ADT_CORE_NAMESPACE}">
+<objectSet kind="inclusive">
+<adtcore:objectReferences>
+${objectReferences}
+</adtcore:objectReferences>
+</objectSet>
+</adtcore:objectSets>
+</cov:query>`;
+}
+function takeUnseenRecord(value, seenValues) {
+	if (!value || typeof value !== "object" || seenValues.has(value)) return;
+	seenValues.add(value);
+	return value;
+}
+function takeStatementUri(record, seenUris) {
+	const { rel, href } = record;
+	if (rel !== STATEMENTS_RELATION || typeof href !== "string" || seenUris.has(href)) return;
+	seenUris.add(href);
+	return href;
+}
+function enqueueChildObjects(record, queue) {
+	for (const child of Object.values(record)) {
+		if (Array.isArray(child)) {
+			queue.push(...child);
+			continue;
+		}
+		if (child && typeof child === "object") queue.push(child);
+	}
+}
+function extractCoverageStatementUris(value) {
+	const statementUris = [];
+	const seenUris = /* @__PURE__ */ new Set();
+	const seenValues = /* @__PURE__ */ new Set();
+	const queue = [value];
+	while (queue.length > 0) {
+		const record = takeUnseenRecord(queue.shift(), seenValues);
+		if (!record) continue;
+		const statementUri = takeStatementUri(record, seenUris);
+		if (statementUri) statementUris.push(statementUri);
+		enqueueChildObjects(record, queue);
+	}
+	return statementUris;
+}
+function buildStatementsBulkRequest(statementUris) {
+	const requests = statementUris.map((uri) => `<statementsRequest get="${escapeXmlAttribute(uri)}"/>`).join("\n");
+	return `<?xml version="1.0" encoding="UTF-8"?>
+<cov:statementsBulkRequest xmlns:cov="${COVERAGE_NAMESPACE}">
+${requests}
+</cov:statementsBulkRequest>`;
+}
+
 //#endregion
 //#region src/adt/runtime/traces/coverage/measurements.ts
 /**
@@ -1699,16 +2216,25 @@ const datapreviewContract = { freestyle };
 * created measurement. Used as the second step of the aunit → coverage
 * flow: aunit run → atom:link to measurement → POST this endpoint.
 *
-* Content-Type: application/xml+scov
-* Accept:       application/xml+scov
+* Content-Type: application/xml
+* Accept:       application/xml
 */
-const SCOV_CONTENT_TYPE$1 = "application/xml+scov";
-const measurements = contract({ post: (identifier) => http$1.post(`/sap/bc/adt/runtime/traces/coverage/measurements/${identifier}`, {
+const XML_CONTENT_TYPE$1 = "application/xml";
+const measurements = contract({ 
+/**
+* POST /sap/bc/adt/runtime/traces/coverage/measurements/{identifier}
+*   ?withAdditionalTypeInfo=true
+*
+* Returns the coverage tree rooted at ADT_ROOT_NODE with coverage
+* totals (branch/procedure/statement) for each object reference.
+*/
+post: (identifier) => http$1.post(`/sap/bc/adt/runtime/traces/coverage/measurements/${identifier}`, {
 	query: { withAdditionalTypeInfo: true },
+	body: coverageXmlBody,
 	responses: { 200: acoverageResult },
 	headers: {
-		Accept: SCOV_CONTENT_TYPE$1,
-		"Content-Type": SCOV_CONTENT_TYPE$1
+		Accept: XML_CONTENT_TYPE$1,
+		"Content-Type": "application/xml"
 	}
 }) });
 
@@ -1717,15 +2243,24 @@ const measurements = contract({ post: (identifier) => http$1.post(`/sap/bc/adt/r
 /**
 * /sap/bc/adt/runtime/traces/coverage/results/{id}/statements
 *
-* GET returns the cov:statementsBulkResponse with per-method statement
+* POST returns the cov:statementsBulkResponse with per-method statement
 * / branch / procedure coverage details.
 *
-* Content-Type: application/xml+scov
+* Content-Type: application/xml
+* Accept:       application/xml
 */
-const SCOV_CONTENT_TYPE = "application/xml+scov";
-const statements = contract({ get: (identifier) => http$1.get(`/sap/bc/adt/runtime/traces/coverage/results/${identifier}/statements`, {
+const XML_CONTENT_TYPE = "application/xml";
+const statements = contract({ 
+/**
+* POST /sap/bc/adt/runtime/traces/coverage/results/{identifier}/statements
+*/
+post: (identifier) => http$1.post(`/sap/bc/adt/runtime/traces/coverage/results/${identifier}/statements`, {
+	body: coverageXmlBody,
 	responses: { 200: acoverageStatements },
-	headers: { Accept: SCOV_CONTENT_TYPE }
+	headers: {
+		Accept: XML_CONTENT_TYPE,
+		"Content-Type": "application/xml"
+	}
 }) });
 
 //#endregion
@@ -2112,6 +2647,7 @@ const behaviordefinitionsContract = crud({
 	schema: blueSource,
 	contentType: "application/vnd.sap.adt.blues.v1+xml",
 	accept: "application/vnd.sap.adt.blues.v1+xml",
+	nameTransform: (name) => encodeURIComponent(name.toLowerCase()),
 	sources: ["main"]
 });
 
@@ -2125,7 +2661,7 @@ const boContract = { behaviordefinitions: behaviordefinitionsContract };
 * ADT RAP Service Binding (SRVB) Contract
 *
 * Endpoint: /sap/bc/adt/businessservices/bindings
-* Content-Type: application/vnd.sap.adt.businessservices.servicebinding.v1+xml
+* Content-Type: application/vnd.sap.adt.businessservices.servicebinding.v2+xml
 * Object type: SRVB/SVB
 *
 * RAP Service Binding — binds a Service Definition (SRVD) to a runtime
@@ -2140,12 +2676,13 @@ const boContract = { behaviordefinitions: behaviordefinitionsContract };
 * Reference: abapGit handler zcl_abapgit_object_srvb.
 */
 const basePath = "/sap/bc/adt/businessservices/bindings";
-const nameTransform = (n) => n.toLowerCase();
+const nameTransform = (n) => encodeURIComponent(n.toLowerCase());
 const baseContract = crud({
 	basePath,
 	schema: servicebinding,
-	contentType: "application/vnd.sap.adt.businessservices.servicebinding.v1+xml",
-	accept: "application/vnd.sap.adt.businessservices.servicebinding.v1+xml"
+	contentType: "application/vnd.sap.adt.businessservices.servicebinding.v2+xml",
+	accept: "application/vnd.sap.adt.businessservices.servicebinding.v2+xml",
+	nameTransform
 });
 /**
 * Publish/unpublish extension for SRVB.
@@ -2400,6 +2937,56 @@ const completion = contract({ post: (query) => http$1.post("/sap/bc/adt/codeassi
 //#region src/adt/codeassistance/index.ts
 const codeassistanceContract = { completion };
 
+//#endregion
+//#region src/adt/vit/wb/objectproperties.ts
+/**
+* ADT vit/wb — Basic Object Properties (classic Workbench metadata).
+*
+* Endpoint template (from ADT discovery):
+*   GET /sap/bc/adt/vit/wb/object_type/{type}/object_name/{name}
+*
+* Accept: application/vnd.sap.adt.basic.object.properties+xml
+* Response: adtcore:mainObject
+*
+* Classic BAdI uses vit types:
+*   sxsdxd — BAdI definition  (repository type SXSD/XD)
+*   sxcixi — BAdI implementation (repository type SXCI/XI)
+*/
+const BASIC_OBJECT_PROPERTIES_MIME = "application/vnd.sap.adt.basic.object.properties+xml";
+/** vit/wb object_type segment for classic BAdI definitions. */
+const CLASSIC_BADI_DEFINITION_VIT_TYPE = "sxsdxd";
+/** vit/wb object_type segment for classic BAdI implementations. */
+const CLASSIC_BADI_IMPLEMENTATION_VIT_TYPE = "sxcixi";
+function objectPropertiesPath(vitType, objectName) {
+	const normalizedType = vitType.trim().toLowerCase();
+	const normalizedName = objectName.trim().toLowerCase();
+	return `/sap/bc/adt/vit/wb/object_type/${encodeURIComponent(normalizedType)}/object_name/${encodeURIComponent(normalizedName)}`;
+}
+function getByVitType(vitType) {
+	return (objectName) => http$1.get(objectPropertiesPath(vitType, objectName), {
+		responses: { 200: adtcore },
+		headers: { Accept: BASIC_OBJECT_PROPERTIES_MIME }
+	});
+}
+/**
+* /sap/bc/adt/vit/wb/object_type/{type}/object_name/{name}
+*/
+const vitWbObjectPropertiesContract = contract({
+	/** Generic read for any vit/wb object_type segment. */
+	get: (params) => http$1.get(objectPropertiesPath(params.vitType, params.objectName), {
+		responses: { 200: adtcore },
+		headers: { Accept: BASIC_OBJECT_PROPERTIES_MIME }
+	}),
+	/** Classic BAdI definition (SXSD/XD). */
+	getDefinition: getByVitType(CLASSIC_BADI_DEFINITION_VIT_TYPE),
+	/** Classic BAdI implementation (SXCI/XI). */
+	getImplementation: getByVitType(CLASSIC_BADI_IMPLEMENTATION_VIT_TYPE)
+});
+
+//#endregion
+//#region src/adt/vit/index.ts
+const vitContract = { wb: { objectProperties: vitWbObjectPropertiesContract } };
+
 //#endregion
 //#region src/adt/index.ts
 /**
@@ -2427,7 +3014,8 @@ const adtContract = {
 	businessservices: businessservicesContract,
 	enhancements: enhancementsContract,
 	flp: flpContract,
-	codeassistance: codeassistanceContract
+	codeassistance: codeassistanceContract,
+	vit: vitContract
 };
 
 //#endregion
@@ -2464,5 +3052,5 @@ function contract(definition) {
 }
 
 //#endregion
-export { activationContract as $, normalizeTransportFindResponse as $t, gctsCreateBranchResponseSchema as A, USAGEREFS_NAMESPACE as At, runtimeContract as B, discoveryContract as Bt, behaviordefinitionsContract as C, repositoryContract as Ct, gctsCommitResponseSchema as D, SCOPE_RESPONSE_MIME as Dt, gctsCommitBodySchema as E, SCOPE_REQUEST_MIME as Et, gctsPullSchema as F, coreContract as Ft, runtimeDumpListSchema as G, aunitContract as Gt, tracesContract as H, classrunContract as Ht, gctsRepositoriesSchema as I, httpContract as It, coverageContract as J, resultsContract as Jt, runtimeTraceDetailSchema as K, extractCoverageMeasurementId as Kt, gctsRepositorySchema as L, systeminformationContract as Lt, gctsGenericOkSchema as M, buildUsageScopeRequestXml as Mt, gctsLogSchema as N, usageReferencesContract as Nt, gctsConfigSchema as O, SEARCH_REQUEST_MIME as Ot, gctsObjectsSchema as P, searchContract as Pt, freestyle as Q, TransportStatus as Qt, gctsSetConfigBodySchema as R, sessionsContract as Rt, boContract as S, programsContract as St, gctsBranchesSchema as T, informationsystemContract as Tt, profile as U, interfacesContract as Ut, dumps as V, ooContract as Vt, runtimeDumpDetailSchema as W, classesContract as Wt, measurements as X, ctsContract as Xt, statements as Y, worklistsContract as Yt, datapreviewContract as Z, TransportFunction as Zt, normalizeOdataFeed as _, functionsContract as _t, codeassistanceContract as a, srvdContract as at, businessservicesContract as b, programsModuleContract as bt, completionResponseSchema as c, dclSourcesContract as ct, flpCatalogSchema as d, tabletypesContract as dt, transports as en, checkrunsContract as et, flpGroupListSchema as f, tablesettingsContract as ft, normalizeOdataEntity as g, domainsContract as gt, flpTileSchema as h, dataelementsContract as ht, adtContract as i, ddicContract as it, gctsCreateRepositoryBodySchema as j, buildUsageReferenceRequestXml as jt, gctsCreateBranchBodySchema as k, SEARCH_RESPONSE_MIME as kt, flpContract as l, ddlContract as lt, flpTileListSchema as m, structuresContract as mt, createAdtClient as n, repo as nn, psesContract as nt, completion as o, srvdSourcesContract as ot, flpGroupSchema as p, tablesContract as pt, runtimeTraceListSchema as q, atcContract as qt, http$1 as r, usersContract as rt, completionRequestSchema as s, dclContract as st, contract as t, crud as tn, systemContract as tt, flpCatalogListSchema as u, ddlSourcesContract as ut, enhancementsContract as v, functionModulesContract as vt, gctsContract as w, objectstructureContract as wt, bindingsContract as x, includesContract as xt, enhoxhhContract as y, functionGroupsContract as yt, gctsSetItemBodySchema as z, packagesContract as zt };
-//# sourceMappingURL=base-BsgeOhzu.mjs.map
+export { coverageContract as $, usageReferencesContract as $t, gctsBranchesSchema as A, structuresContract as At, gctsPullSchema as B, objectstructureContract as Bt, enhancementsContract as C, dclContract as Ct, boContract as D, tabletypesContract as Dt, bindingsContract as E, ddlSourcesContract as Et, gctsCreateBranchResponseSchema as F, functionGroupsContract as Ft, runtimeContract as G, sourceversionsContract as Gt, gctsRepositorySchema as H, OBJECT_PROPERTIES_RESULT_MIME as Ht, gctsCreateRepositoryBodySchema as I, programsModuleContract as It, profile as J, SEARCH_REQUEST_MIME as Jt, dumps as K, SCOPE_REQUEST_MIME as Kt, gctsGenericOkSchema as L, includesContract as Lt, gctsCommitResponseSchema as M, domainsContract as Mt, gctsConfigSchema as N, functionsContract as Nt, behaviordefinitionsContract as O, tablesettingsContract as Ot, gctsCreateBranchBodySchema as P, functionModulesContract as Pt, runtimeTraceListSchema as Q, buildUsageScopeRequestXml as Qt, gctsLogSchema as R, programsContract as Rt, normalizeOdataFeed as S, ddlxSourcesContract as St, businessservicesContract as T, ddlContract as Tt, gctsSetConfigBodySchema as U, objectPropertiesContract as Ut, gctsRepositoriesSchema as V, informationsystemContract as Vt, gctsSetItemBodySchema as W, assertAdtRelativeUri as Wt, runtimeDumpListSchema as X, USAGEREFS_NAMESPACE as Xt, runtimeDumpDetailSchema as Y, SEARCH_RESPONSE_MIME as Yt, runtimeTraceDetailSchema as Z, buildUsageReferenceRequestXml as Zt, flpGroupListSchema as _, TransportStatus as _n, dtebSourcesContract as _t, vitContract as a, packagesContract as an, extractCoverageStatementUris as at, flpTileSchema as b, crud as bn, dsfdSourcesContract as bt, CLASSIC_BADI_IMPLEMENTATION_VIT_TYPE as c, classrunContract as cn, activationContract as ct, completion as d, aunitContract as dn, psesContract as dt, searchContract as en, statements as et, completionRequestSchema as f, atcContract as fn, usersContract as ft, flpCatalogSchema as g, TransportFunction as gn, dtebContract as gt, flpCatalogListSchema as h, ctsContract as hn, srvdSourcesContract as ht, adtContract as i, sessionsContract as in, coverageXmlBody as it, gctsCommitBodySchema as j, dataelementsContract as jt, gctsContract as k, tablesContract as kt, vitWbObjectPropertiesContract as l, interfacesContract as ln, checkrunsContract as lt, flpContract as m, worklistsContract as mn, srvdContract as mt, createAdtClient as n, httpContract as nn, buildCoverageQuery as nt, BASIC_OBJECT_PROPERTIES_MIME as o, discoveryContract as on, datapreviewContract as ot, completionResponseSchema as p, resultsContract as pn, ddicContract as pt, tracesContract as q, SCOPE_RESPONSE_MIME as qt, http$1 as r, systeminformationContract as rn, buildStatementsBulkRequest as rt, CLASSIC_BADI_DEFINITION_VIT_TYPE as s, ooContract as sn, freestyle as st, contract as t, coreContract as tn, measurements as tt, codeassistanceContract as u, classesContract as un, systemContract as ut, flpGroupSchema as v, normalizeTransportFindResponse as vn, dsfiContract as vt, enhoxhhContract as w, dclSourcesContract as wt, normalizeOdataEntity as x, repo as xn, ddlxContract as xt, flpTileListSchema as y, transports as yn, dsfdContract as yt, gctsObjectsSchema as z, repositoryContract as zt };
+//# sourceMappingURL=base-CJ5t6dbP.mjs.map