@mcp-abap-adt/interfaces-adt-connection 5.1.0 → 5.2.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,28 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
7
7
 
8
8
  ## [Unreleased]
9
9
 
10
+ ## [5.2.0] - 2026-11-21
11
+
12
+ ### Added
13
+
14
+ - **Three request flags on `IAbapRequestOptions`**, each `true` or absent
15
+ (`?: true | undefined`):
16
+ - `noLog` keeps the request and its answer out of every log the connection
17
+ and the server's wrapper write;
18
+ - `noResend` makes the first failure the caller's answer: the CSRF recovery,
19
+ the resend after a credential renewal and the dead-pooled-socket resend are
20
+ gated, and a redirect from SAP's ADT endpoint is returned, not followed;
21
+ - `stateless` sends the request stateless on HTTP and RFC whatever the
22
+ connection's session mode, and wins over a `x-sap-adt-sessiontype:
23
+ stateful` header.
24
+
25
+ A caller that sets none of these properties compiles unchanged. A request
26
+ variable that already carries one of them as `false` (`stateless: false`,
27
+ `noLog: false`, `noResend: false`) now fails with TS2322; this is still a
28
+ minor release, because these properties were never declared. A connection
29
+ that does not know a flag ignores it until it is updated to the version that
30
+ honours it.
31
+
10
32
  ## [5.1.0] - 2026-11-14
11
33
 
12
34
  ### Added
package/README.md CHANGED
@@ -12,7 +12,7 @@ npm install @mcp-abap-adt/interfaces-adt-connection
12
12
  | `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
13
  | 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
14
  | `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 |
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
16
  | `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
17
  | `ISessionLifecycleAware`, `ICriticalSection`, `IRequestProfiling`, `IDeferredResponseConnection` | the connection's capability atoms — a connection honours the ones it can |
18
18
  | `ADT_SESSION_ERROR` / `AdtSessionErrorCode` | what a session failure is called |
@@ -5,5 +5,29 @@ export interface IAbapRequestOptions {
5
5
  data?: unknown;
6
6
  params?: unknown;
7
7
  headers?: Record<string, string>;
8
+ /**
9
+ * `true` keeps the request and its answer out of every log: the connection's
10
+ * refusal preview, the RFC status text and body, both wire loggers and the
11
+ * server's wire wrapper. A line, if any, carries the method, the path
12
+ * without its query, the integer status and the byte count. The error the
13
+ * connection throws keeps its fields for the caller.
14
+ */
15
+ noLog?: true | undefined;
16
+ /**
17
+ * `true` makes the first failure the caller's answer: every replay of the
18
+ * request is gated, namely the CSRF recovery, the resend after a credential
19
+ * renewal and the resend on a dead pooled socket. Redirects from SAP's ADT
20
+ * endpoint are returned as they are, not followed. The initial CSRF token
21
+ * fetch before a mutation still happens.
22
+ */
23
+ noResend?: true | undefined;
24
+ /**
25
+ * `true` sends the request stateless on HTTP and RFC whatever the
26
+ * connection's session mode, and wins over a caller's
27
+ * `x-sap-adt-sessiontype: stateful` header in any letter case. On the wire
28
+ * the connector strips that conflicting session header and the session's
29
+ * context cookie from the request.
30
+ */
31
+ stateless?: true | undefined;
8
32
  }
9
33
  //# 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;CAClC"}
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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@mcp-abap-adt/interfaces-adt-connection",
3
- "version": "5.1.0",
3
+ "version": "5.2.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",