@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 +22 -0
- package/README.md +1 -1
- package/dist/IAbapRequestOptions.d.ts +24 -0
- package/dist/IAbapRequestOptions.d.ts.map +1 -1
- package/package.json +1 -1
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;
|
|
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.
|
|
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",
|