@mcp-abap-adt/interfaces-adt 21.0.0 → 23.0.0

package/dist/adt/AdtTypeTables.js

@@ -23,9 +23,10 @@ exports.ADT_TYPES_BASIS_740 = exports.ADT_TYPES_CLOUD = exports.ADT_TYPES_ONPREM
 /**
  * What the library serves on **S/4HANA 2025 on-premise**, API by API.
  *
- * Identical in operations to {@link ADT_TYPES_CLOUD}: the library has no
- * on-premise or cloud branch. The two differ where the releases do —
- * `SRVD/SRV` takes 40 characters here and 30 on ABAP cloud.
+ * The library has no on-premise or cloud branch; the two tables differ where
+ * the releases do — `SRVD/SRV` takes 40 characters here and 30 on ABAP
+ * cloud, and a program or an include is created and changed, a program run,
+ * and a feature toggle created, changed and switched, only here.
  */
 exports.ADT_TYPES_ONPREM = {
     class: {
@@ -41,6 +42,7 @@ exports.ADT_TYPES_ONPREM = {
                     'source',
                     'readMetadata',
                     'update',
+                    'updateMetadata',
                     'lock',
                     'unlock',
                     'activate',
@@ -77,6 +79,7 @@ exports.ADT_TYPES_ONPREM = {
                     'source',
                     'readMetadata',
                     'update',
+                    'updateMetadata',
                     'lock',
                     'unlock',
                     'activate',
@@ -104,6 +107,7 @@ exports.ADT_TYPES_ONPREM = {
                     'source',
                     'readMetadata',
                     'update',
+                    'updateMetadata',
                     'lock',
                     'unlock',
                     'activate',
@@ -195,6 +199,7 @@ exports.ADT_TYPES_ONPREM = {
                     'source',
                     'readMetadata',
                     'update',
+                    'updateMetadata',
                     'lock',
                     'unlock',
                     'activate',
@@ -276,6 +281,7 @@ exports.ADT_TYPES_ONPREM = {
                     'source',
                     'readMetadata',
                     'update',
+                    'updateMetadata',
                     'lock',
                     'unlock',
                     'activate',
@@ -956,7 +962,23 @@ exports.ADT_TYPES_ONPREM = {
 /**
  * What the library serves on **ABAP cloud** (measured on the BTP trial), API by
  * API. The same operations as {@link ADT_TYPES_ONPREM}, and this release's
- * name lengths.
+ * name lengths, but for a program (`PROG/P`), an include (`PROG/I`) and a
+ * feature toggle (`FTG2/FT`), each only read here. The cloud has no program
+ * or include of one's own — its discovery gives neither collection an
+ * `app:accept`, and the create is refused (`403`, S_DEVELOP) — so they list
+ * what a delivered one answers (measured): the reads, the check, the versions,
+ * the deletion check, the enhancement reads and, for a program, the ABAP Unit
+ * runs. Its transport is `404`, and running or profiling it is refused.
+ *
+ * A read is listed where the release's discovery has its endpoint. An
+ * operation that changes an object (`create`, `update`, `updateMetadata`,
+ * `lock`, `unlock`, `activate`, `delete`, a feature toggle's switch, and the
+ * `validate` that prepares a create) is listed where the release offers it —
+ * its discovery, and a measurement — and left out where a measurement on the
+ * release refused it: a feature toggle (`FTG2/FT`) is only read here, while a
+ * function include (`FUGR/I`) is created in its group. `typestructure`'s
+ * `USER_AUTHORIZATIONS` says why a measuring user was refused, for that user
+ * on that system; it explains the table, it does not fill it.
  */
 exports.ADT_TYPES_CLOUD = {
     class: {
@@ -972,6 +994,7 @@ exports.ADT_TYPES_CLOUD = {
                     'source',
                     'readMetadata',
                     'update',
+                    'updateMetadata',
                     'lock',
                     'unlock',
                     'activate',
@@ -1008,6 +1031,7 @@ exports.ADT_TYPES_CLOUD = {
                     'source',
                     'readMetadata',
                     'update',
+                    'updateMetadata',
                     'lock',
                     'unlock',
                     'activate',
@@ -1030,24 +1054,14 @@ exports.ADT_TYPES_CLOUD = {
                 parent: null,
                 nameMaxLength: 40,
                 operations: [
-                    'create',
                     'read',
                     'source',
                     'readMetadata',
-                    'update',
-                    'lock',
-                    'unlock',
-                    'activate',
                     'check',
-                    'validate',
                     'versions',
                     'deletionCheck',
-                    'delete',
-                    'transport',
                     'readEnhancementElements',
                     'readEnhancementOptions',
-                    'run',
-                    'profile',
                     'unitTestRun',
                     'unitTestRunSync',
                     'unitTestStatus',
@@ -1065,17 +1079,10 @@ exports.ADT_TYPES_CLOUD = {
                 parent: null,
                 nameMaxLength: 40,
                 operations: [
-                    'create',
                     'read',
                     'source',
                     'readMetadata',
-                    'update',
-                    'lock',
-                    'unlock',
-                    'activate',
-                    'validate',
                     'deletionCheck',
-                    'delete',
                     'readEnhancementElements',
                     'readEnhancementOptions',
                 ],
@@ -1126,6 +1133,7 @@ exports.ADT_TYPES_CLOUD = {
                     'source',
                     'readMetadata',
                     'update',
+                    'updateMetadata',
                     'lock',
                     'unlock',
                     'activate',
@@ -1207,6 +1215,7 @@ exports.ADT_TYPES_CLOUD = {
                     'source',
                     'readMetadata',
                     'update',
+                    'updateMetadata',
                     'lock',
                     'unlock',
                     'activate',
@@ -1661,21 +1670,11 @@ exports.ADT_TYPES_CLOUD = {
                 parent: null,
                 nameMaxLength: 30,
                 operations: [
-                    'create',
                     'read',
                     'source',
                     'readMetadata',
-                    'update',
-                    'updateMetadata',
-                    'lock',
-                    'unlock',
-                    'activate',
                     'check',
-                    'validate',
                     'deletionCheck',
-                    'delete',
-                    'switchOn',
-                    'switchOff',
                     'getRuntimeState',
                     'checkState',
                 ],

package/dist/adt/AdtUtilityCodes.d.ts

@@ -0,0 +1,146 @@
+/**
+ * The codes the cross-cutting utilities take beyond the API tables, per
+ * release variant: a code no API of the library serves, but that a group
+ * operation or a repository read addresses (`VIEW/DV`), and a code whose API
+ * a variant lacks or does not list the operation for, that a utility still
+ * sends (`DEVC/K`).
+ *
+ * **Why a table of its own, not an API entry.** An entry in `ADT_TYPES_*`
+ * makes a factory callable on that variant and an operation part of
+ * `AdtOperation`. A package entry on 7.40 would gate `getPackage()` open
+ * where every package member is refused, and a new operation word would
+ * widen the closed vocabulary a 21.0.0 consumer maps exhaustively. These codes
+ * belong to `getUtils()`, which is no entry (ruling R5), so they are typed
+ * where its members read them.
+ *
+ * Constants and types only, like the API tables.
+ */
+import type { AdtTypeCode, AdtVariant } from './AdtTypeTables';
+import type { AdtCollection, AdtTypeEvidence } from './IAdtTypeTable';
+/** What a utility of `getUtils()` does with a code of these tables. */
+export type AdtUtilityOperation = 
+/** `activateObjectsGroup` */
+'groupActivation'
+/** `deleteObjectsGroup` */
+ | 'groupDeletion'
+/** `getWhereUsed`, `getWhereUsedScope` */
+ | 'whereUsed'
+/** `fetchNodeStructure` */
+ | 'nodeStructure';
+/** What a utility table says about one code. */
+export interface IAdtUtilityCodeFacts<R extends string> {
+    /** What the utilities do with it, at least one. */
+    readonly operations: readonly [AdtUtilityOperation, ...AdtUtilityOperation[]];
+    /**
+     * Whether a live run measured these operations answered. `false` is a
+     * request the library sends and nothing has proved.
+     */
+    readonly measured: boolean;
+    /** The corpus case that lists the code on this release. */
+    readonly evidence: AdtTypeEvidence<R>;
+    /** The collection its objects are addressed under, where the code has no API. */
+    readonly collection?: AdtCollection;
+}
+/** What a utility table `satisfies`. */
+export type AdtUtilityCodeTable<R extends string> = {
+    readonly [code: string]: IAdtUtilityCodeFacts<R>;
+};
+/**
+ * On **S/4HANA 2025**: `VIEW/DV`, a DDIC database view, which group
+ * activation, group deletion and where-used address under
+ * `/sap/bc/adt/ddic/views` and no API serves; and `DEVC/K` in a group
+ * activation, which the API table lists no `activate` for — sent, unmeasured.
+ */
+export declare const ADT_UTILITY_CODES_ONPREM: {
+    readonly 'VIEW/DV': {
+        readonly operations: readonly ["groupActivation", "groupDeletion", "whereUsed"];
+        readonly measured: false;
+        readonly evidence: "system-description-s4-2025--07-typestructure";
+        readonly collection: "/sap/bc/adt/ddic/views";
+    };
+    readonly 'DEVC/K': {
+        readonly operations: readonly ["groupActivation"];
+        readonly measured: false;
+        readonly evidence: "system-description-s4-2025--07-typestructure";
+    };
+};
+/** On **ABAP cloud**: the same as {@link ADT_UTILITY_CODES_ONPREM}. */
+export declare const ADT_UTILITY_CODES_CLOUD: {
+    readonly 'VIEW/DV': {
+        readonly operations: readonly ["groupActivation", "groupDeletion", "whereUsed"];
+        readonly measured: false;
+        readonly evidence: "system-description-abap-cloud--07-typestructure";
+        readonly collection: "/sap/bc/adt/ddic/views";
+    };
+    readonly 'DEVC/K': {
+        readonly operations: readonly ["groupActivation"];
+        readonly measured: false;
+        readonly evidence: "system-description-abap-cloud--07-typestructure";
+    };
+};
+/**
+ * On **SAP_BASIS 7.40 SP04**: `VIEW/DV` as on the newer releases, and
+ * `DEVC/K` in `fetchNodeStructure` — a package's contents are a node
+ * structure of the package, measured served (the legacy `UtilsReaders`
+ * cycle, `fetchNodeStructure('DEVC/K', '$TMP')`), though 7.40's API table has
+ * no package entry.
+ */
+export declare const ADT_UTILITY_CODES_BASIS_740: {
+    readonly 'VIEW/DV': {
+        readonly operations: readonly ["groupActivation", "groupDeletion", "whereUsed"];
+        readonly measured: false;
+        readonly evidence: "system-description-basis-740--07-typestructure";
+        readonly collection: "/sap/bc/adt/ddic/views";
+    };
+    readonly 'DEVC/K': {
+        readonly operations: readonly ["nodeStructure"];
+        readonly measured: true;
+        readonly evidence: "system-description-basis-740--07-typestructure";
+    };
+};
+/** The utility table of each variant, by its name. */
+export interface IAdtUtilityCodeTables {
+    readonly onprem: typeof ADT_UTILITY_CODES_ONPREM;
+    readonly cloud: typeof ADT_UTILITY_CODES_CLOUD;
+    readonly basis740: typeof ADT_UTILITY_CODES_BASIS_740;
+}
+type UtilityCodesWithIn<T, Op extends AdtUtilityOperation> = {
+    [C in keyof T]: T[C] extends {
+        readonly operations: readonly (infer O)[];
+    } ? [Op] extends [O] ? C : never : never;
+}[keyof T] & string;
+type VariantsWhereUtilityHas<C, Op extends AdtUtilityOperation> = {
+    [W in AdtVariant]: C extends UtilityCodesWithIn<IAdtUtilityCodeTables[W], Op> ? W : never;
+}[AdtVariant];
+/**
+ * The codes for which every variant of `V` lists utility operation `Op` —
+ * intersecting, like `AdtCodeWith`: the default modern variant gets what both
+ * newer tables list.
+ */
+export type AdtUtilityCodeWith<V extends AdtVariant, Op extends AdtUtilityOperation> = Extract<{
+    [C in {
+        [W in V]: UtilityCodesWithIn<IAdtUtilityCodeTables[W], Op>;
+    }[V]]: [V] extends [VariantsWhereUtilityHas<C, Op>] ? C : never;
+}[{
+    [W in V]: UtilityCodesWithIn<IAdtUtilityCodeTables[W], Op>;
+}[V]], AdtUtilityCode>;
+/** Every code a utility table holds: a code of the API tables, or a group-only one. */
+export type AdtUtilityCode = AdtTypeCode | AdtGroupOnlyCode;
+/**
+ * The codes the utilities address that no API table holds — `VIEW/DV`. A
+ * group-only code: it reaches a group operation or where-used, never a
+ * factory.
+ */
+export type AdtGroupOnlyCode = Exclude<{
+    [W in AdtVariant]: keyof IAdtUtilityCodeTables[W];
+}[AdtVariant], AdtTypeCode>;
+/** The group-only codes every variant of `V` lists. */
+export type AdtGroupOnlyCodeOf<V extends AdtVariant> = {
+    [C in AdtGroupOnlyCode]: [V] extends [
+        {
+            [W in AdtVariant]: C extends keyof IAdtUtilityCodeTables[W] ? W : never;
+        }[AdtVariant]
+    ] ? C : never;
+}[AdtGroupOnlyCode];
+export {};
+//# sourceMappingURL=AdtUtilityCodes.d.ts.map

package/dist/adt/AdtUtilityCodes.d.ts.map

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

package/dist/adt/AdtUtilityCodes.js

@@ -0,0 +1,73 @@
+"use strict";
+/**
+ * The codes the cross-cutting utilities take beyond the API tables, per
+ * release variant: a code no API of the library serves, but that a group
+ * operation or a repository read addresses (`VIEW/DV`), and a code whose API
+ * a variant lacks or does not list the operation for, that a utility still
+ * sends (`DEVC/K`).
+ *
+ * **Why a table of its own, not an API entry.** An entry in `ADT_TYPES_*`
+ * makes a factory callable on that variant and an operation part of
+ * `AdtOperation`. A package entry on 7.40 would gate `getPackage()` open
+ * where every package member is refused, and a new operation word would
+ * widen the closed vocabulary a 21.0.0 consumer maps exhaustively. These codes
+ * belong to `getUtils()`, which is no entry (ruling R5), so they are typed
+ * where its members read them.
+ *
+ * Constants and types only, like the API tables.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ADT_UTILITY_CODES_BASIS_740 = exports.ADT_UTILITY_CODES_CLOUD = exports.ADT_UTILITY_CODES_ONPREM = void 0;
+/**
+ * On **S/4HANA 2025**: `VIEW/DV`, a DDIC database view, which group
+ * activation, group deletion and where-used address under
+ * `/sap/bc/adt/ddic/views` and no API serves; and `DEVC/K` in a group
+ * activation, which the API table lists no `activate` for — sent, unmeasured.
+ */
+exports.ADT_UTILITY_CODES_ONPREM = {
+    'VIEW/DV': {
+        operations: ['groupActivation', 'groupDeletion', 'whereUsed'],
+        measured: false,
+        evidence: 'system-description-s4-2025--07-typestructure',
+        collection: '/sap/bc/adt/ddic/views',
+    },
+    'DEVC/K': {
+        operations: ['groupActivation'],
+        measured: false,
+        evidence: 'system-description-s4-2025--07-typestructure',
+    },
+};
+/** On **ABAP cloud**: the same as {@link ADT_UTILITY_CODES_ONPREM}. */
+exports.ADT_UTILITY_CODES_CLOUD = {
+    'VIEW/DV': {
+        operations: ['groupActivation', 'groupDeletion', 'whereUsed'],
+        measured: false,
+        evidence: 'system-description-abap-cloud--07-typestructure',
+        collection: '/sap/bc/adt/ddic/views',
+    },
+    'DEVC/K': {
+        operations: ['groupActivation'],
+        measured: false,
+        evidence: 'system-description-abap-cloud--07-typestructure',
+    },
+};
+/**
+ * On **SAP_BASIS 7.40 SP04**: `VIEW/DV` as on the newer releases, and
+ * `DEVC/K` in `fetchNodeStructure` — a package's contents are a node
+ * structure of the package, measured served (the legacy `UtilsReaders`
+ * cycle, `fetchNodeStructure('DEVC/K', '$TMP')`), though 7.40's API table has
+ * no package entry.
+ */
+exports.ADT_UTILITY_CODES_BASIS_740 = {
+    'VIEW/DV': {
+        operations: ['groupActivation', 'groupDeletion', 'whereUsed'],
+        measured: false,
+        evidence: 'system-description-basis-740--07-typestructure',
+        collection: '/sap/bc/adt/ddic/views',
+    },
+    'DEVC/K': {
+        operations: ['nodeStructure'],
+        measured: true,
+        evidence: 'system-description-basis-740--07-typestructure',
+    },
+};

package/dist/adt/IAdtShared.d.ts

@@ -1,7 +1,8 @@
 /**
  * Shared types for cross-cutting ADT operations
  */
-import type { AdtParentedTypeCode, AdtTypeCode } from './AdtTypeTables';
+import type { AdtCodeOf, AdtCodeWith, AdtModernVariant, AdtParentedTypeCode, AdtTypeCode, AdtVariant } from './AdtTypeTables';
+import type { AdtGroupOnlyCode, AdtUtilityCodeWith } from './AdtUtilityCodes';
 /**
  * An object as an answer named it: its type code when the tables know it, the
  * code as it came when they do not.
@@ -36,8 +37,12 @@ export type IAdtAnsweredObject = {
  * code known only as `AdtTypeCode` compiles, and an interface can extend it.
  * A union of one member per code would do neither — it exceeds the 25
  * combinations TypeScript checks an object literal against.
+ *
+ * **Since 22.0.0 `C` may be a group-only code** (`IObjectReference<'VIEW/DV'>`):
+ * the constraint is wider, the default is not, so `IObjectReference` alone is
+ * what it was in 21.0.0.
  */
-export type IObjectReference<C extends AdtTypeCode = AdtTypeCode> = {
+export type IObjectReference<C extends AdtTypeCode | AdtGroupOnlyCode = AdtTypeCode> = {
     /** Object name, `adtcore:name`. */
     name: string;
     /** ADT object type code, e.g. `'CLAS/OC'`: a code of the tables. */
@@ -100,16 +105,16 @@ export interface IGetDiscoveryParams {
 /**
  * Where-used scope parameters (Step 1: get available object types)
  */
-export interface IGetWhereUsedScopeParams {
+export interface IGetWhereUsedScopeParams<C extends AdtTypeCode | AdtGroupOnlyCode = AdtTypeCode> {
     object_name: string;
-    object_type: AdtTypeCode;
+    object_type: C;
 }
 /**
  * Where-used parameters (Step 2: execute search)
  */
-export interface IGetWhereUsedParams {
+export interface IGetWhereUsedParams<C extends AdtTypeCode | AdtGroupOnlyCode = AdtTypeCode> {
     object_name: string;
-    object_type: AdtTypeCode;
+    object_type: C;
     /**
      * Optional: scope XML from getWhereUsedScope() with user-modified selections.
      * When omitted, the search runs unscoped (SAP's default scope) — getWhereUsed()
@@ -135,4 +140,53 @@ export interface IGetVirtualFoldersContentsParams {
     withVersions?: boolean;
     ignoreShortDescriptions?: boolean;
 }
+/**
+ * The codes a group activation activates on every variant of `V`: those whose
+ * API lists `activate`, and the utility codes listing `groupActivation`
+ * (`VIEW/DV`; `DEVC/K` on the newer releases, unmeasured).
+ */
+export type AdtGroupActivationCode<V extends AdtVariant = AdtModernVariant> = AdtCodeWith<V, 'activate'> | AdtUtilityCodeWith<V, 'groupActivation'>;
+/** The codes a group deletion check asks about: those listing `deletionCheck`. */
+export type AdtGroupDeletionCheckCode<V extends AdtVariant = AdtModernVariant> = AdtCodeWith<V, 'deletionCheck'>;
+/**
+ * The codes a group deletion deletes: those listing `delete`, but a message of
+ * a message class (`MSAG/NN`), which has no address of its own — it is a row
+ * of its class — and the utility codes listing `groupDeletion` (`VIEW/DV`).
+ */
+export type AdtGroupDeletionCode<V extends AdtVariant = AdtModernVariant> = Exclude<AdtCodeWith<V, 'delete'>, 'MSAG/NN'> | AdtUtilityCodeWith<V, 'groupDeletion'>;
+/**
+ * The codes where-used is asked of: every code of `V` but a function include,
+ * whose group the where-used request has no field for, and a message class
+ * message, which has no address of its own; and the utility codes listing
+ * `whereUsed` (`VIEW/DV`).
+ */
+export type AdtWhereUsedCode<V extends AdtVariant = AdtModernVariant> = Exclude<AdtCodeOf<V>, 'FUGR/I' | 'MSAG/NN'> | AdtUtilityCodeWith<V, 'whereUsed'>;
+/**
+ * A reference to one of the codes `C`, with `parentName` required for each
+ * code that has a parent API (`FUGR/FF`, `FUGR/I`) and optional for the rest.
+ *
+ * Per code, but not as a union of one member per code: TypeScript relates an
+ * object literal whose `type` is itself a union to such a union only up to 25
+ * combinations, and a code set runs past it. So it is one reference over all
+ * of `C`, joined with "names its parent, or is a code without one" — a literal
+ * naming `parentName` matches the first without the `type` being split, and
+ * one without it must have a code of the second.
+ */
+export type IAdtCodedReference<C extends AdtTypeCode | AdtGroupOnlyCode> = [
+    Extract<C, AdtParentedTypeCode>
+] extends [never] ? IObjectReference<C> : IObjectReference<C> & ({
+    parentName: string;
+} | {
+    type: Exclude<C, AdtParentedTypeCode>;
+});
+/** What `activateObjectsGroup` is given, per object, on variant `V`. */
+export type IAdtGroupActivationReference<V extends AdtVariant = AdtModernVariant> = IAdtCodedReference<AdtGroupActivationCode<V>>;
+/** What `checkDeletionGroup` is given, per object, on variant `V`. */
+export type IAdtGroupDeletionCheckReference<V extends AdtVariant = AdtModernVariant> = IAdtCodedReference<AdtGroupDeletionCheckCode<V>>;
+/** What `deleteObjectsGroup` is given, per object, on variant `V`. */
+export type IAdtGroupDeletionReference<V extends AdtVariant = AdtModernVariant> = IAdtCodedReference<AdtGroupDeletionCode<V>>;
+/** What where-used is given on variant `V`. */
+export type IAdtWhereUsedParamsOf<V extends AdtVariant = AdtModernVariant> = IGetWhereUsedParams<AdtWhereUsedCode<V>>;
+/** What the where-used scope is given on variant `V`. */
+export type IAdtWhereUsedScopeParamsOf<V extends AdtVariant = AdtModernVariant> = IGetWhereUsedScopeParams<AdtWhereUsedCode<V>>;
 //# sourceMappingURL=IAdtShared.d.ts.map

package/dist/adt/IAdtShared.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"IAdtShared.d.ts","sourceRoot":"","sources":["../../src/adt/IAdtShared.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAExE;;;;;;;;;;GAUG;AACH,MAAM,MAAM,kBAAkB,GAC1B;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,WAAW,CAAC,EAAE,KAAK,CAAA;CAAE,GAC1C;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,KAAK,CAAA;CAAE,CAAC;AAE1C;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,IAAI;IAClE,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,oEAAoE;IACpE,IAAI,EAAE,CAAC,CAAC;IACR,uEAAuE;IACvE,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,mBAAmB,CAAC,GAClC;IACE,iEAAiE;IACjE,UAAU,EAAE,MAAM,CAAC;CACpB,GACD;IACE,8DAA8D;IAC9D,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC,CAAC;AAEP;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,qDAAqD;IACrD,UAAU,CAAC,EAAE,WAAW,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;;;;;;;;;;OAcG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,WAAW,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,WAAW,CAAC;IACzB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,gCAAgC;IAC/C,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,YAAY,CAAC,EAAE,2BAA2B,EAAE,CAAC;IAC7C,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,uBAAuB,CAAC,EAAE,OAAO,CAAC;CACnC"}
+{"version":3,"file":"IAdtShared.d.ts","sourceRoot":"","sources":["../../src/adt/IAdtShared.ts"],"names":[],"mappings":"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"}

package/dist/adt/IAdtUtilities.d.ts

@@ -98,11 +98,11 @@
  * shape of the thing rather than a finished one.
  */
 import type { IReadOptions } from '../shared/IReadOptions';
-import type { AdtSourceTypeCode, AdtTypeCode } from './AdtTypeTables';
+import type { AdtModernVariant, AdtSourceTypeCode, AdtTypeCode, AdtVariant } from './AdtTypeTables';
 import type { IAdtHeaders } from './IAdtContentTypes';
 import type { IAdtAnalyseOptions, IAnalyse } from './IAdtObject';
 import type { IAdtError, IAdtResponse, IResultStrategy } from './IAdtResponse';
-import type { IGetDiscoveryParams, IGetSqlQueryParams, IGetTableContentsParams, IGetVirtualFoldersContentsParams, IGetWhereUsedParams, IGetWhereUsedScopeParams, IObjectReference, ISearchObjectsParams } from './IAdtShared';
+import type { IAdtGroupActivationReference, IAdtGroupDeletionCheckReference, IAdtGroupDeletionReference, IAdtWhereUsedParamsOf, IAdtWhereUsedScopeParamsOf, IGetDiscoveryParams, IGetSqlQueryParams, IGetTableContentsParams, IGetVirtualFoldersContentsParams, IGetWhereUsedParams, IGetWhereUsedScopeParams, IObjectReference, ISearchObjectsParams } from './IAdtShared';
 /**
  * `/sap/bc/adt/repository/informationsystem/*` — everything ADT answers about
  * *where* something is: what exists, what uses it, and what the repository will
@@ -498,6 +498,13 @@ export interface IUtilResults {
     readonly contents: IResultStrategy<unknown>;
     /** The discovery catalogue — `/discovery`. */
     readonly discovery: IResultStrategy<unknown>;
+    /**
+     * What `POST /repository/typestructure` answers — the system's object types
+     * ({@link IAdtTypeStructure}). Optional, so a set written for 21.0.0
+     * still is one; an implementation offering the
+     * member that wants its reading injected requires it.
+     */
+    readonly typeStructure?: IResultStrategy<unknown>;
     /** An object's source — `<objectUri>/source/main`. */
     readonly source: IResultStrategy<unknown>;
     /** An object's metadata document, without its source. */
@@ -510,4 +517,91 @@ export interface IUtilResults {
      */
     readonly objectProperties: IResultStrategy<unknown>;
 }
+/**
+ * `POST /sap/bc/adt/repository/typestructure` — every object type the system
+ * knows, with its code, label, category, `URI_TEMPLATE`, parent type, name
+ * length and capabilities. No body; the Accept and Content-Type are the
+ * caller's, as for every member whose request sets both. Recorded on S/4HANA
+ * 2025, ABAP cloud and SAP_BASIS 7.40 SP04, each answering `200`. It is what
+ * the conformance check of the ADT type tables reads.
+ *
+ * **Its own atom, not part of {@link IAdtInformationSystem}**, like
+ * {@link IAdtObjectProperties}: adding it to a composite would make every
+ * implementation of that composite stop compiling over a member it never
+ * claimed. Added in 22.0.0; its reading is `IUtilResults.typeStructure`.
+ */
+export interface IAdtTypeStructure<TTypeStructure> {
+    /** The system's object types. One request. */
+    getTypeStructure<E extends IAdtError>(options: {
+        headers: IAdtHeaders;
+    } & IAdtAnalyseOptions<E> & {
+        analyse: IAnalyse<E>;
+    }): Promise<IAdtResponse<TTypeStructure, E>>;
+    getTypeStructure(options: {
+        headers: IAdtHeaders;
+    } & IAdtAnalyseOptions): Promise<IAdtResponse<TTypeStructure>>;
+}
+/**
+ * {@link IAdtGroupLifecycle}'s three group members, typed per operation and
+ * variant: each takes only the references its request serves —
+ * {@link IAdtGroupActivationReference}, {@link IAdtGroupDeletionCheckReference},
+ * {@link IAdtGroupDeletionReference} — so a message class is no activation
+ * object, a function module names its group, and `VIEW/DV` is accepted.
+ *
+ * **Beside the 21.0.0 atom, not in place of it.** The members have the same
+ * names; an implementation declaring both offers both sets of signatures, and a
+ * caller passing `IObjectReference[]` keeps compiling against the old one.
+ * Adding these signatures to {@link IAdtGroupLifecycle} itself would make
+ * every 21.0.0 implementation of it stop compiling, so they are an atom of
+ * their own (22.0.0).
+ */
+export interface IAdtTypedGroupLifecycle<TActivation, TDeletionCheck, TDeletion, V extends AdtVariant = AdtModernVariant> {
+    activateObjectsGroup<E extends IAdtError>(objects: IAdtGroupActivationReference<V>[], preauditRequested: boolean | undefined, options: {
+        headers: IAdtHeaders;
+    } & IAdtAnalyseOptions<E> & {
+        analyse: IAnalyse<E>;
+    }): Promise<IAdtResponse<TActivation, E>>;
+    activateObjectsGroup(objects: IAdtGroupActivationReference<V>[], preauditRequested: boolean | undefined, options: {
+        headers: IAdtHeaders;
+    } & IAdtAnalyseOptions): Promise<IAdtResponse<TActivation>>;
+    checkDeletionGroup<E extends IAdtError>(objects: IAdtGroupDeletionCheckReference<V>[], options: {
+        headers: IAdtHeaders;
+    } & IAdtAnalyseOptions<E> & {
+        analyse: IAnalyse<E>;
+    }): Promise<IAdtResponse<TDeletionCheck, E>>;
+    checkDeletionGroup(objects: IAdtGroupDeletionCheckReference<V>[], options: {
+        headers: IAdtHeaders;
+    } & IAdtAnalyseOptions): Promise<IAdtResponse<TDeletionCheck>>;
+    deleteObjectsGroup<E extends IAdtError>(objects: IAdtGroupDeletionReference<V>[], transportRequest: string | undefined, options: {
+        headers: IAdtHeaders;
+    } & IAdtAnalyseOptions<E> & {
+        analyse: IAnalyse<E>;
+    }): Promise<IAdtResponse<TDeletion, E>>;
+    deleteObjectsGroup(objects: IAdtGroupDeletionReference<V>[], transportRequest: string | undefined, options: {
+        headers: IAdtHeaders;
+    } & IAdtAnalyseOptions): Promise<IAdtResponse<TDeletion>>;
+}
+/**
+ * {@link IAdtWhereUsed}'s two requests, typed by the codes where-used is asked
+ * of on variant `V` (`VIEW/DV` among them). Beside the 21.0.0 atom, for the
+ * reason {@link IAdtTypedGroupLifecycle} gives (22.0.0).
+ */
+export interface IAdtTypedWhereUsed<TWhereUsed, TScope, V extends AdtVariant = AdtModernVariant> {
+    getWhereUsed<E extends IAdtError>(params: IAdtWhereUsedParamsOf<V>, options: {
+        headers: IAdtHeaders;
+    } & IAdtAnalyseOptions<E> & {
+        analyse: IAnalyse<E>;
+    }): Promise<IAdtResponse<TWhereUsed, E>>;
+    getWhereUsed(params: IAdtWhereUsedParamsOf<V>, options: {
+        headers: IAdtHeaders;
+    } & IAdtAnalyseOptions): Promise<IAdtResponse<TWhereUsed>>;
+    getWhereUsedScope<E extends IAdtError>(params: IAdtWhereUsedScopeParamsOf<V>, options: {
+        headers: IAdtHeaders;
+    } & IAdtAnalyseOptions<E> & {
+        analyse: IAnalyse<E>;
+    }): Promise<IAdtResponse<TScope, E>>;
+    getWhereUsedScope(params: IAdtWhereUsedScopeParamsOf<V>, options: {
+        headers: IAdtHeaders;
+    } & IAdtAnalyseOptions): Promise<IAdtResponse<TScope>>;
+}
 //# sourceMappingURL=IAdtUtilities.d.ts.map