@mcp-abap-adt/interfaces-adt-connection 5.2.0 → 5.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -7,6 +7,25 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
7
7
 
8
8
  ## [Unreleased]
9
9
 
10
+ ## [5.3.0] - 2026-11-22
11
+
12
+ ### Added
13
+
14
+ - **`rawText` on `IAbapRequestOptions`**, `true` or absent (`?: true |
15
+ undefined`): the answer body reaches the caller as the exact text SAP sent,
16
+ with no parsing (JSON or otherwise) and no transformation. It takes effect
17
+ only on a connector that supports it; a connection that does not know the flag
18
+ ignores it until it is updated.
19
+
20
+ What stays compatible: an ordinary call that omits `rawText` compiles
21
+ unchanged. Code that reads the type's keys can see the new one; for example,
22
+ an exhaustive `Record<keyof IAbapRequestOptions, …>` that omits `rawText` now
23
+ fails (TS2741), and a conditional type on `keyof IAbapRequestOptions` can
24
+ change its result. Because the flag is typed `true`, a request variable that
25
+ already carries `rawText: false` now fails too (TS2322 on assignment, TS2345
26
+ when passed to `makeAdtRequest`). This is still a minor release, because the
27
+ property was never declared.
28
+
10
29
  ## [5.2.0] - 2026-11-21
11
30
 
12
31
  ### Added
package/README.md CHANGED
@@ -1,4 +1,5 @@
1
1
  # @mcp-abap-adt/interfaces-adt-connection
2
+ [![Stand With Ukraine](https://raw.githubusercontent.com/vshymanskyy/StandWithUkraine/main/badges/StandWithUkraine.svg)](https://stand-with-ukraine.pp.ua)
2
3
 
3
4
  The ABAP connection contract: what an ADT request is sent through, and what
4
5
  comes back off the wire. Types and two constants; no implementation.
@@ -12,7 +13,7 @@ npm install @mcp-abap-adt/interfaces-adt-connection
12
13
  | `IAbapConnection` | a connection an ADT request is made through: `makeAdtRequest(options): Promise<IAdtWireResponse>` (no type parameters since 5.0.0), `connect()`, the session id and type. Since 4.0.0 `getBaseUrl()` answers `Promise<string \| undefined>`: `undefined` for a connection with no HTTP origin (RFC), so a caller narrows before using it — see the CHANGELOG's migration note |
13
14
  | optional members of `IAbapConnection` | what a full connector has beyond the five required members, each with the connector's signature: `disconnect?()`, `flushGoodbye?(timeoutMs?)`, `isConnected?()`, `beginCriticalSection?()` / `endCriticalSection?()`, `getSessionMode?()` / `getSessionType?()`, `sessionCookies?()`, `getConfig?()`. A connection may lack any of them, so a caller calls one with `?.` (`connection.disconnect?.()`); a consumer that needs one present narrows to its capability atom. Since 5.1.0 |
14
15
  | `IAbapConnectionConfig` | what `getConfig()` answers: `connectionType?: 'http' \| 'rfc'`, the transport alone; a connector's own, wider configuration is assignable to it. Since 5.1.0 |
15
- | `IAbapRequestOptions` | what one request carries. Since 5.2.0 three optional flags, each `true` or absent: `noLog` (nothing of the request or its answer is logged), `noResend` (every replay is gated: the CSRF recovery, the resend after credential renewal, the dead-pooled-socket resend; a redirect from SAP's ADT endpoint is returned, not followed) and `stateless` (the request goes stateless whatever the session mode and wins over a stateful session-type header). A flag takes effect only on a connector that supports it |
16
+ | `IAbapRequestOptions` | what one request carries. Since 5.2.0 three optional flags, and since 5.3.0 a fourth, each `true` or absent: `noLog` (nothing of the request or its answer is logged), `noResend` (every replay is gated: the CSRF recovery, the resend after credential renewal, the dead-pooled-socket resend; a redirect from SAP's ADT endpoint is returned, not followed) `stateless` (the request goes stateless whatever the session mode and wins over a stateful session-type header) and `rawText` (the answer body reaches the caller as the exact text SAP sent, with no parsing and no transformation). A flag takes effect only on a connector that supports it |
16
17
  | `IAdtWireResponse` | the answer as it came off the wire — extends `IHttpWireResponse` from `interfaces-network` with the headers ADT sends. Its `data` is `unknown` (since 2.0.0; it was `any`), and since 5.0.0 `makeAdtRequest` takes no type arguments: a caller reads `data` and narrows it — see [`MIGRATION-5.0.md`](MIGRATION-5.0.md). Since 4.2.0 it may carry `sessionLost` (below) |
17
18
  | `ISessionLifecycleAware`, `ICriticalSection`, `IRequestProfiling`, `IDeferredResponseConnection` | the connection's capability atoms — a connection honours the ones it can |
18
19
  | `ADT_SESSION_ERROR` / `AdtSessionErrorCode` | what a session failure is called |
@@ -29,5 +29,11 @@ export interface IAbapRequestOptions {
29
29
  * context cookie from the request.
30
30
  */
31
31
  stateless?: true | undefined;
32
+ /**
33
+ * `true` hands the answer body to the caller as the exact text SAP sent,
34
+ * with no parsing (JSON or otherwise) and no transformation. It takes effect
35
+ * only on a connector that supports it.
36
+ */
37
+ rawText?: true | undefined;
32
38
  }
33
39
  //# sourceMappingURL=IAbapRequestOptions.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"IAbapRequestOptions.d.ts","sourceRoot":"","sources":["../src/IAbapRequestOptions.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEjC;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,IAAI,GAAG,SAAS,CAAC;IACzB;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,IAAI,GAAG,SAAS,CAAC;IAC5B;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,IAAI,GAAG,SAAS,CAAC;CAC9B"}
1
+ {"version":3,"file":"IAbapRequestOptions.d.ts","sourceRoot":"","sources":["../src/IAbapRequestOptions.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEjC;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,IAAI,GAAG,SAAS,CAAC;IACzB;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,IAAI,GAAG,SAAS,CAAC;IAC5B;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,IAAI,GAAG,SAAS,CAAC;IAC7B;;;;OAIG;IACH,OAAO,CAAC,EAAE,IAAI,GAAG,SAAS,CAAC;CAC5B"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@mcp-abap-adt/interfaces-adt-connection",
3
- "version": "5.2.0",
3
+ "version": "5.3.0",
4
4
  "description": "The ABAP connection contract: IAbapConnection, its capability atoms, the wire response, the session error codes and the error a connection throws",
5
5
  "main": "dist/index.js",
6
6
  "types": "dist/index.d.ts",