@mcp-abap-adt/adt-clients 8.0.0 → 9.0.0

package/README.md

@@ -205,7 +205,7 @@ await utils.getWhereUsed({ object_name: 'ZCL_TEST', object_type: 'class' });
 
 ```typescript
 import { AdtClientsWS } from '@mcp-abap-adt/adt-clients';
-import type { IWebSocketTransport } from '@mcp-abap-adt/adt-clients';
+import type { IWebSocketTransport } from '@mcp-abap-adt/interfaces';
 
 const transport: IWebSocketTransport = createYourTransport();
 const wsClient = new AdtClientsWS(transport, console, {
@@ -301,7 +301,7 @@ console.log(runWithProfilingResult.traceId);
 `readObjectMetadata` and `readObjectSource` accept strict object type unions to prevent invalid inputs like `view:ZOBJ`.
 
 ```typescript
-import type { AdtObjectType, AdtSourceObjectType } from '@mcp-abap-adt/adt-clients';
+import type { AdtObjectType, AdtSourceObjectType } from '@mcp-abap-adt/interfaces';
 
 await utils.readObjectMetadata('DDLS/DF' satisfies AdtObjectType, 'ZOK_I_CDS_TEST');
 await utils.readObjectSource('view' satisfies AdtSourceObjectType, 'ZOK_I_CDS_TEST');
@@ -427,7 +427,7 @@ See [Tools Documentation](tools/README.md) for complete details and options.
 ### AdtClient Overview
 
 - Factory accessors for ADT objects: `client.getClass()`, `client.getProgram()`, `client.getDdl()` (DDL sources — CDS views, AMDP table functions; formerly `getView()`), `client.getTable()`, `client.getScalarFunction()`, `client.getScalarFunctionImplementation()`, `client.getAppendStructure()`, `client.getRequest()`, `client.getUtils()`, etc.
-- Each accessor returns an `Adt*` object implementing `IAdtObject` operations.
+- Each accessor returns an `Adt*` object typed to its **honest capability set** (since 8.0.0). A full source-backed object (e.g. `getClass()`) returns `IAdtSourceObject`; one with no version history (e.g. `getDomain()`) returns `IAdtNonVersionedObject`; others return the intersection of the capability atoms they actually support. Calling a capability a handler lacks — e.g. `client.getDomain().getVersions(...)` — is now a **compile error** rather than a runtime throw. See the [Type System](#type-system) section.
 - See `src/index.ts` for the full type exports and object configs.
 
 ### AdtObject Methods (with Long Polling Support)
@@ -506,39 +506,89 @@ Notes:
 - Disabled by default.
 - Correction retries once and caches the supported `Accept` per endpoint.
 
-### Specialized Clients
+### Handler classes exported directly
 
-- **ManagementClient**: batch activation + check operations
-- **LockClient**: explicit lock/unlock with `.locks` registry integration
-- **ValidationClient**: name validation mirroring ADT validation endpoint
+The documented route to a handler is a factory — `client.getScalarFunction()` —
+which wires the connection, logger and system context for you. The classes are
+also exported for the rarer case of constructing one against a connection you
+hold yourself:
 
-Refer to the TypeScript typings (`src/index.ts`) for the full API surface.
+<!-- surface:begin -->
+`AdtAppendStructure`, `AdtMessageClass`, `AdtMessageClassMessage`,
+`AdtScalarFunction`, `AdtScalarFunctionImplementation`, `AdtService`.
+<!-- surface:end -->
+
+### System-capability helpers
+
+<!-- surface:begin -->
+`getSystemInformation`, `isModernAdtSystem`, `resolveContentTypes`,
+`fetchDiscoveryEndpoints`, `isEndpointInDiscovery`, `parseSearchResults`
+<!-- surface:end -->
+
+- `getSystemInformation(connection)` — the ADT system record, or `null`.
+- `isModernAdtSystem(connection)` — whether `/sap/bc/adt/core/discovery` is
+  served. S/4 HANA and BTP expose it; BASIS 7.40 and below only have
+  `/sap/bc/adt/discovery`.
+- `resolveContentTypes(connection)` — picks `AdtContentTypesModern` (v2+
+  headers) or `AdtContentTypesBase` (v1, universal) from that answer.
+- `fetchDiscoveryEndpoints(connection)` / `isEndpointInDiscovery(...)` — the
+  discovery document and a membership test over it.
+- `parseSearchResults(xml)` — turn a quickSearch payload you already hold into
+  `ISearchResult[]`. Needs no connection, which is why it is a plain export
+  rather than a method on `getUtils()`.
+
+`src/index.ts` is the full surface; everything reachable from it is public and
+everything else is not.
 
 ## Type System
 
 ### Single Definition Site: `@mcp-abap-adt/interfaces`
 
-Since **7.5.0**, every public type is **defined once**, in `@mcp-abap-adt/interfaces` (`^11.0.0`). This package no longer declares its own copies — the low-level `*Params` interfaces, every `IXxxConfig`/`IXxxState` pair, the option/result types, and the cross-cutting types in `src/core/shared/types.ts` are all re-exports.
+Since **7.5.0**, every public type is **defined once**, in `@mcp-abap-adt/interfaces` (`^13.1.0`). This package declares no copies of its own — the low-level `*Params` interfaces, every `IXxxConfig`/`IXxxState` pair, the option/result types and the cross-cutting shared types all live there.
 
-**Prefer importing types straight from the contract package:**
+**Import them from the package that owns them:**
 
 ```typescript
-// Recommended — import types from the contract package
 import type {
   IClassConfig,
   IClassState,
-  IProgramConfig
+  IProgramConfig,
 } from '@mcp-abap-adt/interfaces';
+```
+
+Since **9.0.0** this is the only route: the package no longer re-exports types it does not own. It used to republish 145 of them, which was more than half its public surface — so a consumer could hold `IClassConfig` believing it came from this client, and a type would appear to change whenever this client released, for reasons that had nothing to do with it. Types now travel on the contract package's release cycle, which is where they are actually decided.
+
+What this package exports is what it owns: the clients, the handler classes, the batch and runtime facades, and a few helpers.
 
-// Still works — this package re-exports the same types unchanged
-import type { IClassConfig } from '@mcp-abap-adt/adt-clients';
+### Honest capability types (since 8.0.0)
+
+`@mcp-abap-adt/interfaces` (`^13.1.0`) splits the fat `IAdtObject` contract into **capability atoms** — `IAdtCreatable`, `IAdtReadable`, `IAdtModifiable` (and `IAdtCrud`, their composite), `IAdtValidatable`, `IAdtCheckable`, `IAdtActivatable`, `IAdtLockable`, `IAdtVersionable`, `IAdtTransportAware`, `IAdtSearchable` — each covering one slice of the lifecycle, plus two named composites: `IAdtSourceObject` and `IAdtNonVersionedObject` (all but versions). Since interfaces 13.0.0 `IAdtObject` is itself assembled from the atoms, so the atoms are the definitions and the composite cannot drift from them.
+
+Since **8.0.0**, each handler `implements` only the atoms it genuinely supports, and `AdtClient.getXxx()` (and `AdtClientBatch.getXxx()`) return types are narrowed to match:
+
+```typescript
+client.getClass().getVersions({ className: 'ZCL_X' });   // ✅ classes have version history
+client.getDomain().getVersions({ domainName: 'ZD_X' });  // ❌ compile error — domains have no /source/main
 ```
 
-Both forms resolve to the identical type. The re-exports exist so that existing code keeps compiling; new code should depend on `@mcp-abap-adt/interfaces` directly, so that types travel independently of this client's release cycle.
+Previously the second call compiled and threw `ADT_UNSUPPORTED_OPERATION` at runtime; now the type system rejects it. This is why 8.0.0 is a major: it is breaking **only** for code that called a capability a handler never had (i.e. code that always threw).
+
+`IAdtObject` remains available but is **`@deprecated`** — it is the full-capability composite, structurally identical to `IAdtSourceObject`, kept for backward compatibility and removed in a later major.
+
+Since **9.0.0** no accessor returns the wide type. `getUnitTest()` and `getCdsUnitTest()` were the last, and now return `IAdtCreatable & IAdtReadable & IAdtValidatable & IAdtTestRunnable` (`IAdtCdsTestRunnable` for CDS): ADT exposes no update, delete, activate, check, lock or version resource for a test run, so the previous type promised thirteen methods of which nine threw — while omitting `run()`, the one thing the handler is for. `getRequest()`, `getFeatureToggle()` and `getServiceBinding()` return their concrete handler types.
 
 Two categories deliberately remain local, because they describe *this client* rather than the wire contract:
 
-- Runtime (value) exports: `ENHANCEMENT_TYPE_CODES` and the enhancement URL helpers, `resolveBindingVariant` / `SERVICE_BINDING_VARIANT_MAP`.
+- Runtime (value) exports:
+  <!-- surface:begin -->
+  `resolveBindingVariant`
+  <!-- surface:end -->
+  `SERVICE_BINDING_VARIANT_MAP` is **not** among them since 9.0.0 — it is defined in
+  `@mcp-abap-adt/interfaces` and is imported from there, like every other type and constant that package owns.
+  `ENHANCEMENT_TYPE_CODES` and the enhancement URL helpers (`getEnhancementBaseUrl`, `getEnhancementUri`,
+  `supportsSourceCode`, `isImplementationType`, `isSpotType`) were listed here but never exported; they are
+  internal to `core/enhancement` and stay that way. Nothing outside this package asked for them, and an export
+  is a promise to keep.
 - `IAdtClientOptions` — constructor options for `AdtClient` itself.
 
 > **Version pairing.** Because the types are now sourced rather than copied, `@mcp-abap-adt/interfaces` is a hard peer of this package's public API. A major bump there implies a bump here; keep the two in step rather than letting a resolver pick a mismatched pair.
@@ -648,7 +698,7 @@ DEBUG_ADT_TESTS=true npm test
 All clients accept a unified `ILogger` interface:
 
 ```typescript
-import type { ILogger } from '@mcp-abap-adt/adt-clients';
+import type { ILogger } from '@mcp-abap-adt/interfaces';
 import { AdtClient } from '@mcp-abap-adt/adt-clients';
 
 // Custom logger example

package/dist/batch/AdtClientBatch.d.ts

@@ -28,8 +28,8 @@ export declare class AdtClientBatch {
     getBehaviorImplementation(): import("@mcp-abap-adt/interfaces").IAdtSourceObject<import("@mcp-abap-adt/interfaces").IBehaviorImplementationConfig, import("@mcp-abap-adt/interfaces").IBehaviorImplementationState>;
     getMetadataExtension(): import("@mcp-abap-adt/interfaces").IAdtSourceObject<import("@mcp-abap-adt/interfaces").IMetadataExtensionConfig, import("@mcp-abap-adt/interfaces").IMetadataExtensionState>;
     getEnhancement(): import("@mcp-abap-adt/interfaces").IAdtSourceObject<import("@mcp-abap-adt/interfaces").IEnhancementConfig, import("@mcp-abap-adt/interfaces").IEnhancementState>;
-    getUnitTest(): import("@mcp-abap-adt/interfaces").IAdtObject<import("@mcp-abap-adt/interfaces").IUnitTestConfig, import("@mcp-abap-adt/interfaces").IUnitTestState>;
-    getCdsUnitTest(): import("@mcp-abap-adt/interfaces").IAdtObject<import("@mcp-abap-adt/interfaces").ICdsUnitTestConfig, import("@mcp-abap-adt/interfaces").ICdsUnitTestState>;
+    getUnitTest(): import("@mcp-abap-adt/interfaces").IAdtCreatable<import("@mcp-abap-adt/interfaces").IUnitTestConfig, import("@mcp-abap-adt/interfaces").IUnitTestState> & import("@mcp-abap-adt/interfaces").IAdtReadable<import("@mcp-abap-adt/interfaces").IUnitTestConfig, import("@mcp-abap-adt/interfaces").IUnitTestState> & import("@mcp-abap-adt/interfaces").IAdtValidatable<import("@mcp-abap-adt/interfaces").IUnitTestConfig, import("@mcp-abap-adt/interfaces").IUnitTestState> & import("@mcp-abap-adt/interfaces").IAdtTestRunnable;
+    getCdsUnitTest(): import("@mcp-abap-adt/interfaces").IAdtCreatable<import("@mcp-abap-adt/interfaces").ICdsUnitTestConfig, import("@mcp-abap-adt/interfaces").ICdsUnitTestState> & import("@mcp-abap-adt/interfaces").IAdtReadable<import("@mcp-abap-adt/interfaces").ICdsUnitTestConfig, import("@mcp-abap-adt/interfaces").ICdsUnitTestState> & import("@mcp-abap-adt/interfaces").IAdtValidatable<import("@mcp-abap-adt/interfaces").ICdsUnitTestConfig, import("@mcp-abap-adt/interfaces").ICdsUnitTestState> & import("@mcp-abap-adt/interfaces").IAdtCdsTestRunnable;
     getRequest(): import("../core/transport").AdtRequest;
     getUtils(): import("../core/shared").AdtUtils;
     getLocalTestClass(): import("@mcp-abap-adt/interfaces").IAdtSourceObject<import("@mcp-abap-adt/interfaces").ILocalTestClassConfig, import("@mcp-abap-adt/interfaces").IClassState>;

package/dist/clients/AdtClient.d.ts

@@ -12,7 +12,7 @@
  * Each factory method returns an IAdtObject instance that can be used
  * to perform operations on a specific object type.
  */
-import type { IAbapConnection, IAdtActivatable, IAdtCheckable, IAdtCrud, IAdtLockable, IAdtNonVersionedObject, IAdtObject, IAdtSourceObject, IAdtTransportAware, IAdtValidatable, IAdtVersionable, ILogger } from '@mcp-abap-adt/interfaces';
+import type { IAbapConnection, IAdtActivatable, IAdtCdsTestRunnable, IAdtCheckable, IAdtCreatable, IAdtCrud, IAdtLockable, IAdtNonVersionedObject, IAdtReadable, IAdtSourceObject, IAdtTestRunnable, IAdtTransportAware, IAdtValidatable, IAdtVersionable, ILogger } from '@mcp-abap-adt/interfaces';
 import { type IAccessControlConfig, type IAccessControlState } from '../core/accessControl';
 import { type IAppendStructureConfig, type IAppendStructureState } from '../core/appendStructure';
 import { type IAuthorizationFieldConfig, type IAuthorizationFieldState } from '../core/authorizationField';
@@ -71,6 +71,35 @@ export declare class AdtClient {
      */
     protected readonly lockRegistry: LockRegistry;
     constructor(connection: IAbapConnection, logger?: ILogger, options?: IAdtClientOptions);
+    /**
+     * Refuses to hand out a handler over a connection nobody connected.
+     *
+     * Connecting is the CONSUMER's job and stays that way — this library does not
+     * own the connection and must not connect on anyone's behalf. What it can do
+     * is catch the case where a connector was injected and `connect()` was never
+     * called, which otherwise surfaces deep in an operation chain: the handlers
+     * collect failures into `state.errors` rather than stopping, so a missing
+     * connection arrives as a state object full of `ADT_NOT_CONNECTED` after the
+     * chain has walked its whole length. Failing here turns that into nothing
+     * having happened at all.
+     *
+     * Only asked of a connection that ANSWERS the question. `isConnected()` lives
+     * on `ISessionLifecycleAware`, not on `IAbapConnection`: an RFC connection has
+     * no HTTP session and no such method, and a transport that cannot answer must
+     * not be blocked on its silence. This is a real limit, not an oversight — a
+     * transport with no session has no "not connected" state to catch, so the
+     * promise this guard makes is necessarily narrower than "every
+     * `IAbapConnection`".
+     *
+     * It checks ONLY `isConnected`, which is the only method it calls. That is a
+     * different rule from the one for a type predicate, and the difference is
+     * worth stating because the two look alike: a predicate narrows to the WHOLE
+     * interface, so it must verify the whole interface or its caller will invoke a
+     * method that is not there. This asks one question and calls one method, so
+     * demanding the other two would only make it step aside for a connection that
+     * could have answered — refusing evidence it was offered.
+     */
+    private assertConnected;
     /**
      * Get high-level operations for Class objects
      * @returns IAdtObject instance for Class operations
@@ -250,15 +279,24 @@ export declare class AdtClient {
      */
     getFeatureToggle(): IFeatureToggleObject;
     /**
-     * Get high-level operations for UnitTest objects
-     * @returns IAdtObject instance for UnitTest operations
+     * Get high-level operations for UnitTest objects.
+     *
+     * A test run is created and read, never edited: ADT exposes no update,
+     * delete, activate, check, lock or version resource for one. The declared
+     * type says so rather than promising thirteen methods of which nine throw.
+     *
+     * It also carries {@link IAdtTestRunnable} — starting a run and collecting
+     * its outcome is the reason this handler exists, and until interfaces 13.1.0
+     * no contract described it, so callers cast past the type to reach it.
      */
-    getUnitTest(): IAdtObject<IUnitTestConfig, IUnitTestState>;
+    getUnitTest(): IAdtCreatable<IUnitTestConfig, IUnitTestState> & IAdtReadable<IUnitTestConfig, IUnitTestState> & IAdtValidatable<IUnitTestConfig, IUnitTestState> & IAdtTestRunnable;
     /**
-     * Get high-level operations for CDS UnitTest objects
-     * @returns IAdtObject instance for CDS UnitTest operations (extends AdtUnitTest with CDS-specific methods)
+     * Get high-level operations for CDS UnitTest objects.
+     *
+     * Same capability set as {@link getUnitTest}; the CDS-specific surface
+     * (`checkCdsTestDoubles`, `getCdsViewName`) is on the concrete class.
      */
-    getCdsUnitTest(): IAdtObject<ICdsUnitTestConfig, ICdsUnitTestState>;
+    getCdsUnitTest(): IAdtCreatable<ICdsUnitTestConfig, ICdsUnitTestState> & IAdtReadable<ICdsUnitTestConfig, ICdsUnitTestState> & IAdtValidatable<ICdsUnitTestConfig, ICdsUnitTestState> & IAdtCdsTestRunnable;
     /**
      * Get high-level operations for Request (Transport Request) objects
      * @returns IAdtObject instance for Request operations

package/dist/clients/AdtClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AdtClient.d.ts","sourceRoot":"","sources":["../../src/clients/AdtClient.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"AdtClient.d.ts","sourceRoot":"","sources":["../../src/clients/AdtClient.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,eAAe,EACf,mBAAmB,EACnB,aAAa,EACb,aAAa,EACb,QAAQ,EACR,YAAY,EACZ,sBAAsB,EAEtB,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,eAAe,EACf,eAAe,EACf,OAAO,EAER,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAEL,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACzB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAEL,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC3B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAEL,KAAK,yBAAyB,EAC9B,KAAK,wBAAwB,EAC9B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAEL,KAAK,yBAAyB,EAC9B,KAAK,wBAAwB,EAC9B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAEL,KAAK,6BAA6B,EAClC,KAAK,4BAA4B,EAClC,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAML,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,uBAAuB,EAC5B,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,EACvB,MAAM,eAAe,CAAC;AACvB,OAAO,EAEL,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACvB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAU,KAAK,UAAU,EAAE,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AACtE,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,YAAY,EAClB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAEL,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACvB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAEL,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACzB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAEL,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC3B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAEL,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EAC1B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACrB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAGL,KAAK,mBAAmB,EACxB,KAAK,0BAA0B,EAC/B,KAAK,yBAAyB,EAC9B,KAAK,kBAAkB,EACxB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAEL,KAAK,wBAAwB,EAC7B,KAAK,uBAAuB,EAC7B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,aAAa,EACnB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,aAAa,EACnB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAEL,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EAC1B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAEL,KAAK,mCAAmC,EACxC,KAAK,kCAAkC,EACxC,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAAqB,KAAK,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAC7E,OAAO,EAEL,KAAK,wBAAwB,EAC7B,KAAK,uBAAuB,EAC7B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnD,OAAO,EAAE,KAAK,WAAW,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC7E,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACrB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAY,KAAK,YAAY,EAAE,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AAC9E,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACrB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAEL,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EAC1B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAGL,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,cAAc,EACpB,MAAM,kBAAkB,CAAC;AAE1B,MAAM,WAAW,iBAAiB;IAChC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yIAAyI;IACzI,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,iBAAiB;IAChC,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uFAAuF;IACvF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,OAAO,6BAA6B,EAAE,gBAAgB,CAAC;IACtE,6GAA6G;IAC7G,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,qBAAa,SAAS;IACpB,SAAS,CAAC,UAAU,EAAE,eAAe,CAAC;IACtC,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC;IAC1B,SAAS,CAAC,aAAa,EAAE,iBAAiB,CAAC;IAC3C,SAAS,CAAC,YAAY,CAAC,EAAE,OAAO,6BAA6B,EAAE,gBAAgB,CAAC;IAChF;;;OAGG;IACH,SAAS,CAAC,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;gBAG5C,UAAU,EAAE,eAAe,EAC3B,MAAM,CAAC,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE,iBAAiB;IAwC7B;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACH,OAAO,CAAC,eAAe;IAcvB;;;OAGG;IACH,QAAQ,IAAI,gBAAgB,CAAC,YAAY,EAAE,WAAW,CAAC;IAWvD;;;OAGG;IACH,UAAU,IAAI,gBAAgB,CAAC,cAAc,EAAE,aAAa,CAAC;IAW7D;;;OAGG;IACH,YAAY,IAAI,gBAAgB,CAAC,gBAAgB,EAAE,eAAe,CAAC;IAWnE;;;OAGG;IACH,SAAS,IAAI,sBAAsB,CAAC,aAAa,EAAE,YAAY,CAAC;IAUhE;;;;;;;OAOG;IACG,SAAS,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAIzC;;;;OAIG;IACH,IAAI,YAAY,IAAI,MAAM,EAAE,CAE3B;IAED;;;;;;;;;OASG;IACG,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC;IAa5C;;;OAGG;IACH,cAAc,IAAI,sBAAsB,CACtC,kBAAkB,EAClB,iBAAiB,CAClB;IAUD;;;OAGG;IACH,qBAAqB,IAAI,QAAQ,CAC/B,yBAAyB,EACzB,wBAAwB,CACzB,GACC,eAAe,CAAC,yBAAyB,EAAE,wBAAwB,CAAC,GACpE,aAAa,CAAC,yBAAyB,EAAE,wBAAwB,CAAC,GAClE,eAAe,CAAC,yBAAyB,EAAE,wBAAwB,CAAC,GACpE,YAAY,CAAC,yBAAyB,EAAE,wBAAwB,CAAC;IAUnE;;;OAGG;IACH,YAAY,IAAI,gBAAgB,CAAC,gBAAgB,EAAE,eAAe,CAAC;IAUnE;;;OAGG;IACH,QAAQ,IAAI,gBAAgB,CAAC,YAAY,EAAE,WAAW,CAAC;IAUvD;;;OAGG;IACH,YAAY,IAAI,gBAAgB,CAAC,gBAAgB,EAAE,eAAe,CAAC;IAUnE;;;;;;OAMG;IACH,MAAM,IAAI,gBAAgB,CAAC,UAAU,EAAE,SAAS,CAAC;IAUjD;;;OAGG;IACH,gBAAgB,IAAI,sBAAsB,CACxC,oBAAoB,EACpB,mBAAmB,CACpB;IAWD;;;OAGG;IACH,iBAAiB,IAAI,gBAAgB,CACnC,qBAAqB,EACrB,oBAAoB,CACrB;IAWD;;;OAGG;IACH,kBAAkB,IAAI,QAAQ,CAC5B,sBAAsB,EACtB,qBAAqB,CACtB,GACC,eAAe,CAAC,sBAAsB,EAAE,qBAAqB,CAAC,GAC9D,aAAa,CAAC,sBAAsB,EAAE,qBAAqB,CAAC,GAC5D,eAAe,CAAC,sBAAsB,EAAE,qBAAqB,CAAC,GAC9D,YAAY,CAAC,sBAAsB,EAAE,qBAAqB,CAAC,GAC3D,eAAe,CAAC,sBAAsB,CAAC;IAWzC;;;OAGG;IACH,UAAU,IAAI,QAAQ,CAAC,cAAc,EAAE,aAAa,CAAC,GACnD,eAAe,CAAC,cAAc,EAAE,aAAa,CAAC,GAC9C,aAAa,CAAC,cAAc,EAAE,aAAa,CAAC,GAC5C,YAAY,CAAC,cAAc,EAAE,aAAa,CAAC,GAC3C,kBAAkB,CAAC,cAAc,EAAE,aAAa,CAAC;IAUnD;;;OAGG;IACH,eAAe,IAAI,QAAQ,CAAC,mBAAmB,EAAE,kBAAkB,CAAC,GAClE,eAAe,CAAC,mBAAmB,EAAE,kBAAkB,CAAC,GACxD,YAAY,CAAC,mBAAmB,EAAE,kBAAkB,CAAC;IAUvD;;;;OAIG;IACH,sBAAsB,IAAI,QAAQ,CAChC,0BAA0B,EAC1B,yBAAyB,CAC1B;IAKD;;;OAGG;IACH,gBAAgB,IAAI,gBAAgB,CAClC,oBAAoB,EACpB,mBAAmB,CACpB;IAUD;;;;OAIG;IACH,iBAAiB,IAAI,gBAAgB,CACnC,qBAAqB,EACrB,oBAAoB,CACrB;IAUD;;;OAGG;IACH,oBAAoB,IAAI,gBAAgB,CACtC,wBAAwB,EACxB,uBAAuB,CACxB;IAUD;;OAEG;IACH,iBAAiB,IAAI,gBAAgB,CACnC,qBAAqB,EACrB,oBAAoB,CACrB;IAUD;;OAEG;IACH,+BAA+B,IAAI,gBAAgB,CACjD,mCAAmC,EACnC,kCAAkC,CACnC;IAUD;;OAEG;IACH,kBAAkB,IAAI,gBAAgB,CACpC,sBAAsB,EACtB,qBAAqB,CACtB;IAUD;;;OAGG;IACH,iBAAiB,IAAI,kBAAkB;IASvC;;OAEG;IACH,UAAU,IAAI,kBAAkB;IAIhC;;;OAGG;IACH,qBAAqB,IAAI,gBAAgB,CACvC,yBAAyB,EACzB,wBAAwB,CACzB;IAUD;;;OAGG;IACH,yBAAyB,IAAI,gBAAgB,CAC3C,6BAA6B,EAC7B,4BAA4B,CAC7B;IASD;;;OAGG;IACH,oBAAoB,IAAI,gBAAgB,CACtC,wBAAwB,EACxB,uBAAuB,CACxB;IAUD;;;;;;;;;OASG;IACH,cAAc,IAAI,gBAAgB,CAAC,kBAAkB,EAAE,iBAAiB,CAAC;IAUzE;;;OAGG;IACH,gBAAgB,IAAI,oBAAoB;IAUxC;;;;;;;;;;OAUG;IACH,WAAW,IAAI,aAAa,CAAC,eAAe,EAAE,cAAc,CAAC,GAC3D,YAAY,CAAC,eAAe,EAAE,cAAc,CAAC,GAC7C,eAAe,CAAC,eAAe,EAAE,cAAc,CAAC,GAChD,gBAAgB;IAKlB;;;;;OAKG;IACH,cAAc,IAAI,aAAa,CAAC,kBAAkB,EAAE,iBAAiB,CAAC,GACpE,YAAY,CAAC,kBAAkB,EAAE,iBAAiB,CAAC,GACnD,eAAe,CAAC,kBAAkB,EAAE,iBAAiB,CAAC,GACtD,mBAAmB;IAKrB;;;OAGG;IACH,UAAU,IAAI,UAAU;IAKxB;;;;;;;;;;;OAWG;IACH,QAAQ,IAAI,QAAQ;IAKpB;;;OAGG;IACH,iBAAiB,IAAI,gBAAgB,CAAC,qBAAqB,EAAE,WAAW,CAAC;IAWzE;;;OAGG;IACH,aAAa,IAAI,gBAAgB,CAAC,iBAAiB,EAAE,WAAW,CAAC;IAWjE;;;OAGG;IACH,mBAAmB,IAAI,gBAAgB,CACrC,uBAAuB,EACvB,WAAW,CACZ;IAWD;;;OAGG;IACH,cAAc,IAAI,gBAAgB,CAAC,kBAAkB,EAAE,WAAW,CAAC;CAUpE"}

package/dist/clients/AdtClient.js

@@ -15,6 +15,7 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AdtClient = void 0;
+const interfaces_1 = require("@mcp-abap-adt/interfaces");
 const accessControl_1 = require("../core/accessControl");
 const appendStructure_1 = require("../core/appendStructure");
 const authorizationField_1 = require("../core/authorizationField");
@@ -87,11 +88,51 @@ class AdtClient {
             }
         }
     }
+    /**
+     * Refuses to hand out a handler over a connection nobody connected.
+     *
+     * Connecting is the CONSUMER's job and stays that way — this library does not
+     * own the connection and must not connect on anyone's behalf. What it can do
+     * is catch the case where a connector was injected and `connect()` was never
+     * called, which otherwise surfaces deep in an operation chain: the handlers
+     * collect failures into `state.errors` rather than stopping, so a missing
+     * connection arrives as a state object full of `ADT_NOT_CONNECTED` after the
+     * chain has walked its whole length. Failing here turns that into nothing
+     * having happened at all.
+     *
+     * Only asked of a connection that ANSWERS the question. `isConnected()` lives
+     * on `ISessionLifecycleAware`, not on `IAbapConnection`: an RFC connection has
+     * no HTTP session and no such method, and a transport that cannot answer must
+     * not be blocked on its silence. This is a real limit, not an oversight — a
+     * transport with no session has no "not connected" state to catch, so the
+     * promise this guard makes is necessarily narrower than "every
+     * `IAbapConnection`".
+     *
+     * It checks ONLY `isConnected`, which is the only method it calls. That is a
+     * different rule from the one for a type predicate, and the difference is
+     * worth stating because the two look alike: a predicate narrows to the WHOLE
+     * interface, so it must verify the whole interface or its caller will invoke a
+     * method that is not there. This asks one question and calls one method, so
+     * demanding the other two would only make it step aside for a connection that
+     * could have answered — refusing evidence it was offered.
+     */
+    assertConnected() {
+        const candidate = this.connection;
+        if (typeof candidate.isConnected !== 'function')
+            return;
+        if (!candidate.isConnected()) {
+            const error = new Error('AdtClient: the connection is not connected. Call connect() on it before ' +
+                'requesting a handler — this library does not connect on your behalf.');
+            error.code = interfaces_1.ADT_SESSION_ERROR.NOT_CONNECTED;
+            throw error;
+        }
+    }
     /**
      * Get high-level operations for Class objects
      * @returns IAdtObject instance for Class operations
      */
     getClass() {
+        this.assertConnected();
         return new class_1.AdtClass(this.connection, this.logger, this.systemContext, this.contentTypes, this.lockRegistry);
     }
     /**
@@ -99,6 +140,7 @@ class AdtClient {
      * @returns IAdtObject instance for Program operations
      */
     getProgram() {
+        this.assertConnected();
         return new program_1.AdtProgram(this.connection, this.logger, this.systemContext, this.contentTypes, this.lockRegistry);
     }
     /**
@@ -106,6 +148,7 @@ class AdtClient {
      * @returns IAdtObject instance for Interface operations
      */
     getInterface() {
+        this.assertConnected();
         return new interface_1.AdtInterface(this.connection, this.logger, this.systemContext, undefined, this.lockRegistry);
     }
     /**
@@ -113,6 +156,7 @@ class AdtClient {
      * @returns IAdtObject instance for Domain operations
      */
     getDomain() {
+        this.assertConnected();
         return new domain_1.AdtDomain(this.connection, this.logger, this.systemContext, this.lockRegistry);
     }
     /**
@@ -157,6 +201,7 @@ class AdtClient {
      * @returns IAdtObject instance for DataElement operations
      */
     getDataElement() {
+        this.assertConnected();
         return new dataElement_1.AdtDataElement(this.connection, this.logger, this.systemContext, this.lockRegistry);
     }
     /**
@@ -164,6 +209,7 @@ class AdtClient {
      * @returns IAdtObject instance for AuthorizationField operations
      */
     getAuthorizationField() {
+        this.assertConnected();
         return new authorizationField_1.AdtAuthorizationField(this.connection, this.logger, this.systemContext, this.lockRegistry);
     }
     /**
@@ -171,6 +217,7 @@ class AdtClient {
      * @returns IAdtObject instance for Structure operations
      */
     getStructure() {
+        this.assertConnected();
         return new structure_1.AdtStructure(this.connection, this.logger, this.systemContext, this.lockRegistry);
     }
     /**
@@ -178,6 +225,7 @@ class AdtClient {
      * @returns IAdtObject instance for Table operations
      */
     getTable() {
+        this.assertConnected();
         return new table_1.AdtTable(this.connection, this.logger, this.systemContext, this.lockRegistry);
     }
     /**
@@ -185,6 +233,7 @@ class AdtClient {
      * @returns IAdtObject instance for TableType operations
      */
     getTableType() {
+        this.assertConnected();
         return new tabletype_1.AdtDdicTableType(this.connection, this.logger, this.systemContext, this.lockRegistry);
     }
     /**
@@ -195,6 +244,7 @@ class AdtClient {
      * @returns IAdtObject instance for DDL source operations
      */
     getDdl() {
+        this.assertConnected();
         return new ddl_1.AdtDdl(this.connection, this.logger, this.systemContext, this.lockRegistry);
     }
     /**
@@ -202,6 +252,7 @@ class AdtClient {
      * @returns IAdtObject instance for FunctionGroup operations
      */
     getFunctionGroup() {
+        this.assertConnected();
         return new functionGroup_1.AdtFunctionGroup(this.connection, this.logger, this.systemContext, this.contentTypes, this.lockRegistry);
     }
     /**
@@ -209,6 +260,7 @@ class AdtClient {
      * @returns IAdtObject instance for FunctionModule operations
      */
     getFunctionModule() {
+        this.assertConnected();
         return new functionModule_1.AdtFunctionModule(this.connection, this.logger, this.systemContext, this.contentTypes, this.lockRegistry);
     }
     /**
@@ -216,6 +268,7 @@ class AdtClient {
      * @returns IAdtObject instance for FunctionInclude operations
      */
     getFunctionInclude() {
+        this.assertConnected();
         return new functionInclude_1.AdtFunctionInclude(this.connection, this.logger, this.systemContext, this.contentTypes, this.lockRegistry);
     }
     /**
@@ -223,6 +276,7 @@ class AdtClient {
      * @returns IAdtObject instance for Package operations
      */
     getPackage() {
+        this.assertConnected();
         return new package_1.AdtPackage(this.connection, this.logger, this.systemContext, this.lockRegistry);
     }
     /**
@@ -230,6 +284,7 @@ class AdtClient {
      * @returns IAdtObject instance for MessageClass operations
      */
     getMessageClass() {
+        this.assertConnected();
         return new messageClass_1.AdtMessageClass(this.connection, this.logger, this.systemContext, this.lockRegistry);
     }
     /**
@@ -238,6 +293,7 @@ class AdtClient {
      * @returns IAdtObject instance for MessageClassMessage operations
      */
     getMessageClassMessage() {
+        this.assertConnected();
         return new messageClass_1.AdtMessageClassMessage(this.connection, this.logger);
     }
     /**
@@ -245,6 +301,7 @@ class AdtClient {
      * @returns IAdtObject instance for AccessControl operations
      */
     getAccessControl() {
+        this.assertConnected();
         return new accessControl_1.AdtAccessControl(this.connection, this.logger, this.systemContext, this.lockRegistry);
     }
     /**
@@ -253,6 +310,7 @@ class AdtClient {
      * @returns IAdtObject instance for Transformation operations
      */
     getTransformation() {
+        this.assertConnected();
         return new transformation_1.AdtTransformation(this.connection, this.logger, this.systemContext, this.lockRegistry);
     }
     /**
@@ -260,24 +318,28 @@ class AdtClient {
      * @returns IAdtObject instance for ServiceDefinition operations
      */
     getServiceDefinition() {
+        this.assertConnected();
         return new serviceDefinition_1.AdtServiceDefinition(this.connection, this.logger, this.systemContext, this.lockRegistry);
     }
     /**
      * Get high-level operations for CDS Scalar Function (DSFD/SCF) objects
      */
     getScalarFunction() {
+        this.assertConnected();
         return new scalarFunction_1.AdtScalarFunction(this.connection, this.logger, this.systemContext, this.lockRegistry);
     }
     /**
      * Get high-level operations for Scalar Function Implementation (DSFI/SFI) objects
      */
     getScalarFunctionImplementation() {
+        this.assertConnected();
         return new scalarFunctionImplementation_1.AdtScalarFunctionImplementation(this.connection, this.logger, this.systemContext, this.lockRegistry);
     }
     /**
      * Get high-level operations for Append Structure (TABL/DS) objects
      */
     getAppendStructure() {
+        this.assertConnected();
         return new appendStructure_1.AdtAppendStructure(this.connection, this.logger, this.systemContext, this.lockRegistry);
     }
     /**
@@ -285,6 +347,7 @@ class AdtClient {
      * @returns IAdtServiceBinding instance for ServiceBinding CRUD and lifecycle operations
      */
     getServiceBinding() {
+        this.assertConnected();
         return new service_1.AdtServiceBinding(this.connection, this.logger, this.systemContext);
     }
     /**
@@ -298,6 +361,7 @@ class AdtClient {
      * @returns IAdtObject instance for BehaviorDefinition operations
      */
     getBehaviorDefinition() {
+        this.assertConnected();
         return new behaviorDefinition_1.AdtBehaviorDefinition(this.connection, this.logger, this.systemContext, this.lockRegistry);
     }
     /**
@@ -305,6 +369,7 @@ class AdtClient {
      * @returns IAdtObject instance for BehaviorImplementation operations
      */
     getBehaviorImplementation() {
+        this.assertConnected();
         return new behaviorImplementation_1.AdtBehaviorImplementation(this.connection, this.logger, this.lockRegistry);
     }
     /**
@@ -312,6 +377,7 @@ class AdtClient {
      * @returns IAdtObject instance for MetadataExtension operations
      */
     getMetadataExtension() {
+        this.assertConnected();
         return new metadataExtension_1.AdtMetadataExtension(this.connection, this.logger, this.systemContext, this.lockRegistry);
     }
     /**
@@ -325,6 +391,7 @@ class AdtClient {
      * @returns IAdtObject instance for Enhancement operations
      */
     getEnhancement() {
+        this.assertConnected();
         return new enhancement_1.AdtEnhancement(this.connection, this.logger, this.systemContext, this.lockRegistry);
     }
     /**
@@ -332,20 +399,32 @@ class AdtClient {
      * @returns IFeatureToggleObject instance for FeatureToggle operations
      */
     getFeatureToggle() {
+        this.assertConnected();
         return new featureToggle_1.AdtFeatureToggle(this.connection, this.logger, this.systemContext, this.lockRegistry);
     }
     /**
-     * Get high-level operations for UnitTest objects
-     * @returns IAdtObject instance for UnitTest operations
+     * Get high-level operations for UnitTest objects.
+     *
+     * A test run is created and read, never edited: ADT exposes no update,
+     * delete, activate, check, lock or version resource for one. The declared
+     * type says so rather than promising thirteen methods of which nine throw.
+     *
+     * It also carries {@link IAdtTestRunnable} — starting a run and collecting
+     * its outcome is the reason this handler exists, and until interfaces 13.1.0
+     * no contract described it, so callers cast past the type to reach it.
      */
     getUnitTest() {
+        this.assertConnected();
         return new unitTest_1.AdtUnitTest(this.connection, this.logger);
     }
     /**
-     * Get high-level operations for CDS UnitTest objects
-     * @returns IAdtObject instance for CDS UnitTest operations (extends AdtUnitTest with CDS-specific methods)
+     * Get high-level operations for CDS UnitTest objects.
+     *
+     * Same capability set as {@link getUnitTest}; the CDS-specific surface
+     * (`checkCdsTestDoubles`, `getCdsViewName`) is on the concrete class.
      */
     getCdsUnitTest() {
+        this.assertConnected();
         return new unitTest_1.AdtCdsUnitTest(this.connection, this.logger);
     }
     /**
@@ -353,6 +432,7 @@ class AdtClient {
      * @returns IAdtObject instance for Request operations
      */
     getRequest() {
+        this.assertConnected();
         return new transport_1.AdtRequest(this.connection, this.logger, this.systemContext);
     }
     /**
@@ -368,6 +448,7 @@ class AdtClient {
      * @returns AdtUtils instance for utility operations
      */
     getUtils() {
+        this.assertConnected();
         return new AdtUtils_1.AdtUtils(this.connection, this.logger);
     }
     /**
@@ -375,6 +456,7 @@ class AdtClient {
      * @returns IAdtObject instance for LocalTestClass operations
      */
     getLocalTestClass() {
+        this.assertConnected();
         return new class_1.AdtLocalTestClass(this.connection, this.logger, this.systemContext, this.contentTypes, this.lockRegistry);
     }
     /**
@@ -382,6 +464,7 @@ class AdtClient {
      * @returns IAdtObject instance for LocalTypes operations
      */
     getLocalTypes() {
+        this.assertConnected();
         return new class_1.AdtLocalTypes(this.connection, this.logger, this.systemContext, this.contentTypes, this.lockRegistry);
     }
     /**
@@ -389,6 +472,7 @@ class AdtClient {
      * @returns IAdtObject instance for LocalDefinitions operations
      */
     getLocalDefinitions() {
+        this.assertConnected();
         return new class_1.AdtLocalDefinitions(this.connection, this.logger, this.systemContext, this.contentTypes, this.lockRegistry);
     }
     /**
@@ -396,6 +480,7 @@ class AdtClient {
      * @returns IAdtObject instance for LocalMacros operations
      */
     getLocalMacros() {
+        this.assertConnected();
         return new class_1.AdtLocalMacros(this.connection, this.logger, this.systemContext, this.contentTypes, this.lockRegistry);
     }
 }

package/dist/clients/AdtClientLegacy.d.ts

@@ -12,7 +12,7 @@
  * Unsupported types are determined by /sap/bc/adt/discovery catalog —
  * endpoints not present in legacy system discovery are blocked here.
  */
-import type { IAbapConnection, IAdtCheckable, IAdtCrud, IAdtLockable, IAdtNonVersionedObject, IAdtObject, IAdtSourceObject, IAdtTransportAware, IAdtValidatable, ILogger } from '@mcp-abap-adt/interfaces';
+import type { IAbapConnection, IAdtCheckable, IAdtCreatable, IAdtCrud, IAdtLockable, IAdtNonVersionedObject, IAdtReadable, IAdtSourceObject, IAdtTestRunnable, IAdtTransportAware, IAdtValidatable, ILogger } from '@mcp-abap-adt/interfaces';
 import type { IClassConfig, IClassState } from '../core/class';
 import type { IDdlConfig, IDdlState } from '../core/ddl';
 import type { IFunctionGroupConfig, IFunctionGroupState } from '../core/functionGroup';
@@ -33,7 +33,7 @@ export declare class AdtClientLegacy extends AdtClient {
     getFunctionModule(): IAdtSourceObject<IFunctionModuleConfig, IFunctionModuleState>;
     getPackage(): IAdtCrud<IPackageConfig, IPackageState> & IAdtValidatable<IPackageConfig, IPackageState> & IAdtCheckable<IPackageConfig, IPackageState> & IAdtLockable<IPackageConfig, IPackageState> & IAdtTransportAware<IPackageConfig, IPackageState>;
     getDdl(): IAdtSourceObject<IDdlConfig, IDdlState>;
-    getUnitTest(): IAdtObject<IUnitTestConfig, IUnitTestState>;
+    getUnitTest(): IAdtCreatable<IUnitTestConfig, IUnitTestState> & IAdtReadable<IUnitTestConfig, IUnitTestState> & IAdtValidatable<IUnitTestConfig, IUnitTestState> & IAdtTestRunnable;
     getRequest(): AdtRequest;
     getUtils(): AdtUtils;
     getCdsUnitTest(): never;

package/dist/clients/AdtClientLegacy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AdtClientLegacy.d.ts","sourceRoot":"","sources":["../../src/clients/AdtClientLegacy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,aAAa,EACb,QAAQ,EACR,YAAY,EACZ,sBAAsB,EACtB,UAAU,EACV,gBAAgB,EAChB,kBAAkB,EAClB,eAAe,EACf,OAAO,EACR,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE/D,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAEzD,OAAO,KAAK,EACV,oBAAoB,EACpB,mBAAmB,EACpB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,KAAK,EACV,qBAAqB,EACrB,oBAAoB,EACrB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAE3E,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErE,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAGxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAExE,OAAO,EAAE,SAAS,EAAE,KAAK,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAehE,qBAAa,eAAgB,SAAQ,SAAS;gBAE1C,UAAU,EAAE,eAAe,EAC3B,MAAM,CAAC,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE,iBAAiB;IAWpB,UAAU,IAAI,gBAAgB,CAAC,cAAc,EAAE,aAAa,CAAC;IAS7D,QAAQ,IAAI,gBAAgB,CAAC,YAAY,EAAE,WAAW,CAAC;IASvD,YAAY,IAAI,gBAAgB,CAAC,gBAAgB,EAAE,eAAe,CAAC;IASnE,gBAAgB,IAAI,sBAAsB,CACjD,oBAAoB,EACpB,mBAAmB,CACpB;IASQ,iBAAiB,IAAI,gBAAgB,CAC5C,qBAAqB,EACrB,oBAAoB,CACrB;IASQ,UAAU,IAAI,QAAQ,CAAC,cAAc,EAAE,aAAa,CAAC,GAC5D,eAAe,CAAC,cAAc,EAAE,aAAa,CAAC,GAC9C,aAAa,CAAC,cAAc,EAAE,aAAa,CAAC,GAC5C,YAAY,CAAC,cAAc,EAAE,aAAa,CAAC,GAC3C,kBAAkB,CAAC,cAAc,EAAE,aAAa,CAAC;IAQ1C,MAAM,IAAI,gBAAgB,CAAC,UAAU,EAAE,SAAS,CAAC;IAMjD,WAAW,IAAI,UAAU,CAAC,eAAe,EAAE,cAAc,CAAC;IAM1D,UAAU,IAAI,UAAU;IAUxB,QAAQ,IAAI,QAAQ;IAMpB,cAAc,IAAI,KAAK;IAWvB,SAAS,IAAI,KAAK;IAIlB,cAAc,IAAI,KAAK;IAMvB,YAAY,IAAI,KAAK;IAMrB,QAAQ,IAAI,KAAK;IAIjB,YAAY,IAAI,KAAK;IAMrB,gBAAgB,IAAI,KAAK;IAMzB,oBAAoB,IAAI,KAAK;IAM7B,iBAAiB,IAAI,KAAK;IAS1B,UAAU,IAAI,KAAK;IASnB,qBAAqB,IAAI,KAAK;IAS9B,yBAAyB,IAAI,KAAK;IASlC,oBAAoB,IAAI,KAAK;IAM7B,cAAc,IAAI,KAAK;CAKjC"}
+{"version":3,"file":"AdtClientLegacy.d.ts","sourceRoot":"","sources":["../../src/clients/AdtClientLegacy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,aAAa,EACb,aAAa,EACb,QAAQ,EACR,YAAY,EACZ,sBAAsB,EAEtB,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,eAAe,EACf,OAAO,EACR,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE/D,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAEzD,OAAO,KAAK,EACV,oBAAoB,EACpB,mBAAmB,EACpB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,KAAK,EACV,qBAAqB,EACrB,oBAAoB,EACrB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAE3E,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErE,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAGxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAExE,OAAO,EAAE,SAAS,EAAE,KAAK,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAehE,qBAAa,eAAgB,SAAQ,SAAS;gBAE1C,UAAU,EAAE,eAAe,EAC3B,MAAM,CAAC,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE,iBAAiB;IAWpB,UAAU,IAAI,gBAAgB,CAAC,cAAc,EAAE,aAAa,CAAC;IAS7D,QAAQ,IAAI,gBAAgB,CAAC,YAAY,EAAE,WAAW,CAAC;IASvD,YAAY,IAAI,gBAAgB,CAAC,gBAAgB,EAAE,eAAe,CAAC;IASnE,gBAAgB,IAAI,sBAAsB,CACjD,oBAAoB,EACpB,mBAAmB,CACpB;IASQ,iBAAiB,IAAI,gBAAgB,CAC5C,qBAAqB,EACrB,oBAAoB,CACrB;IASQ,UAAU,IAAI,QAAQ,CAAC,cAAc,EAAE,aAAa,CAAC,GAC5D,eAAe,CAAC,cAAc,EAAE,aAAa,CAAC,GAC9C,aAAa,CAAC,cAAc,EAAE,aAAa,CAAC,GAC5C,YAAY,CAAC,cAAc,EAAE,aAAa,CAAC,GAC3C,kBAAkB,CAAC,cAAc,EAAE,aAAa,CAAC;IAQ1C,MAAM,IAAI,gBAAgB,CAAC,UAAU,EAAE,SAAS,CAAC;IAMjD,WAAW,IAAI,aAAa,CAAC,eAAe,EAAE,cAAc,CAAC,GACpE,YAAY,CAAC,eAAe,EAAE,cAAc,CAAC,GAC7C,eAAe,CAAC,eAAe,EAAE,cAAc,CAAC,GAChD,gBAAgB;IAMT,UAAU,IAAI,UAAU;IAUxB,QAAQ,IAAI,QAAQ;IAMpB,cAAc,IAAI,KAAK;IAWvB,SAAS,IAAI,KAAK;IAIlB,cAAc,IAAI,KAAK;IAMvB,YAAY,IAAI,KAAK;IAMrB,QAAQ,IAAI,KAAK;IAIjB,YAAY,IAAI,KAAK;IAMrB,gBAAgB,IAAI,KAAK;IAMzB,oBAAoB,IAAI,KAAK;IAM7B,iBAAiB,IAAI,KAAK;IAS1B,UAAU,IAAI,KAAK;IASnB,qBAAqB,IAAI,KAAK;IAS9B,yBAAyB,IAAI,KAAK;IASlC,oBAAoB,IAAI,KAAK;IAM7B,cAAc,IAAI,KAAK;CAKjC"}

package/dist/core/accessControl/activation.d.ts

@@ -1,6 +1,6 @@
-import type { IAdtResponse as AxiosResponse, IAbapConnection } from '@mcp-abap-adt/interfaces';
+import type { IAbapConnection, IAdtResponse } from '@mcp-abap-adt/interfaces';
 /**
  * Activate access control
  */
-export declare function activateAccessControl(connection: IAbapConnection, accessControlName: string): Promise<AxiosResponse>;
+export declare function activateAccessControl(connection: IAbapConnection, accessControlName: string): Promise<IAdtResponse>;
 //# sourceMappingURL=activation.d.ts.map