@mcp-abap-adt/adt-clients 34.0.0 → 34.2.0

package/dist/index.d.ts

@@ -26,4 +26,5 @@ export * from './index.executors';
 export * from './index.readings';
 export * from './index.runtime';
 export * from './index.ws';
+export { exemptFromAcceptNegotiation, getBaseRequest, } from './utils/acceptNegotiation';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACxD,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACxD,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,OAAO,EACL,2BAA2B,EAC3B,cAAc,GACf,MAAM,2BAA2B,CAAC"}

package/dist/index.js

@@ -34,7 +34,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CT_INCLUDE = exports.AdtInclude = exports.AdtBatchConnection = void 0;
+exports.getBaseRequest = exports.exemptFromAcceptNegotiation = exports.CT_INCLUDE = exports.AdtInclude = exports.AdtBatchConnection = void 0;
 var batch_1 = require("./batch");
 Object.defineProperty(exports, "AdtBatchConnection", { enumerable: true, get: function () { return batch_1.AdtBatchConnection; } });
 var include_1 = require("./core/include");
@@ -46,3 +46,6 @@ __exportStar(require("./index.executors"), exports);
 __exportStar(require("./index.readings"), exports);
 __exportStar(require("./index.runtime"), exports);
 __exportStar(require("./index.ws"), exports);
+var acceptNegotiation_1 = require("./utils/acceptNegotiation");
+Object.defineProperty(exports, "exemptFromAcceptNegotiation", { enumerable: true, get: function () { return acceptNegotiation_1.exemptFromAcceptNegotiation; } });
+Object.defineProperty(exports, "getBaseRequest", { enumerable: true, get: function () { return acceptNegotiation_1.getBaseRequest; } });

package/dist/utils/acceptNegotiation.d.ts

@@ -1,6 +1,13 @@
 import type { IAbapConnection, IAbapRequestOptions, IAdtWireResponse } from '@mcp-abap-adt/interfaces-adt-connection';
 import type { ILogger } from '@mcp-abap-adt/interfaces-utils';
-/** Mark a connection so accept negotiation never corrects or resends through it. */
+/**
+ * Mark a connection so accept negotiation never corrects or resends through it.
+ *
+ * Public for a consumer that hands members its own connection over an
+ * `AdtBatchConnection` — a per-call wrapper, say: an `AdtBatchConnection` marks
+ * itself, but a different object is not it, and is negotiated like any other
+ * connection unless it is marked too. The mark is permanent; there is no unmark.
+ */
 export declare function exemptFromAcceptNegotiation(connection: IAbapConnection): void;
 export interface IAcceptNegotiationOptions {
     enableAcceptCorrection?: boolean;
@@ -19,8 +26,10 @@ export declare function extractSupportedContentType(error: unknown): string[];
  * wrapped it: accept negotiation corrects and resends nothing. The
  * connection's own handling (credential, CSRF, session) is untouched.
  *
- * Exported for the batch connection: what SAP answers to an envelope is the
- * caller's to read.
+ * Exported for the batch connection, and public for a consumer that forwards a
+ * batch's envelope through a connection of its own over one an `AdtClient`
+ * wrapped: what SAP answers to an envelope is the caller's to read. For a
+ * connection never wrapped it is the connection's own `makeAdtRequest`, bound.
  */
 export declare function getBaseRequest(connection: IAbapConnection): IAbapConnection['makeAdtRequest'];
 export declare function wrapConnectionAcceptNegotiation(connection: IAbapConnection, logger?: ILogger): void;

package/dist/utils/acceptNegotiation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"acceptNegotiation.d.ts","sourceRoot":"","sources":["../../src/utils/acceptNegotiation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,mBAAmB,EACnB,gBAAgB,EACjB,MAAM,yCAAyC,CAAC;AAEjD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gCAAgC,CAAC;AAkD9D,oFAAoF;AACpF,wBAAgB,2BAA2B,CAAC,UAAU,EAAE,eAAe,GAAG,IAAI,CAM7E;AAaD,MAAM,WAAW,yBAAyB;IACxC,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,2CAA2C;AAC3C,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,eAAe,GAAG,IAAI,CAIlE;AAED,6DAA6D;AAC7D,wBAAgB,0BAA0B,CACxC,UAAU,EAAE,eAAe,EAC3B,OAAO,CAAC,EAAE,OAAO,GAChB,IAAI,CAEN;AAED,wEAAwE;AACxE,wBAAgB,0BAA0B,CACxC,UAAU,EAAE,eAAe,GAC1B,OAAO,CAIT;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,EAAE,CAoC/D;AAED,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,EAAE,CAsCpE;AAMD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,UAAU,EAAE,eAAe,GAC1B,eAAe,CAAC,gBAAgB,CAAC,CAInC;AAED,wBAAgB,+BAA+B,CAC7C,UAAU,EAAE,eAAe,EAC3B,MAAM,CAAC,EAAE,OAAO,GACf,IAAI,CAkBN;AAED,wBAAsB,mCAAmC,CACvD,CAAC,GAAG,OAAO,EACX,CAAC,GAAG,OAAO,EAEX,UAAU,EAAE,eAAe,EAC3B,OAAO,EAAE,mBAAmB,EAC5B,OAAO,CAAC,EAAE,yBAAyB,GAClC,OAAO,CAAC,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAkFjC"}
+{"version":3,"file":"acceptNegotiation.d.ts","sourceRoot":"","sources":["../../src/utils/acceptNegotiation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,mBAAmB,EACnB,gBAAgB,EACjB,MAAM,yCAAyC,CAAC;AAEjD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gCAAgC,CAAC;AAkD9D;;;;;;;GAOG;AACH,wBAAgB,2BAA2B,CAAC,UAAU,EAAE,eAAe,GAAG,IAAI,CAM7E;AAaD,MAAM,WAAW,yBAAyB;IACxC,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,2CAA2C;AAC3C,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,eAAe,GAAG,IAAI,CAIlE;AAED,6DAA6D;AAC7D,wBAAgB,0BAA0B,CACxC,UAAU,EAAE,eAAe,EAC3B,OAAO,CAAC,EAAE,OAAO,GAChB,IAAI,CAEN;AAED,wEAAwE;AACxE,wBAAgB,0BAA0B,CACxC,UAAU,EAAE,eAAe,GAC1B,OAAO,CAIT;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,EAAE,CAoC/D;AAED,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,EAAE,CAsCpE;AAMD;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAC5B,UAAU,EAAE,eAAe,GAC1B,eAAe,CAAC,gBAAgB,CAAC,CAInC;AAED,wBAAgB,+BAA+B,CAC7C,UAAU,EAAE,eAAe,EAC3B,MAAM,CAAC,EAAE,OAAO,GACf,IAAI,CAkBN;AAED,wBAAsB,mCAAmC,CACvD,CAAC,GAAG,OAAO,EACX,CAAC,GAAG,OAAO,EAEX,UAAU,EAAE,eAAe,EAC3B,OAAO,EAAE,mBAAmB,EAC5B,OAAO,CAAC,EAAE,yBAAyB,GAClC,OAAO,CAAC,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAkFjC"}

package/dist/utils/acceptNegotiation.js

@@ -30,7 +30,14 @@ function stateOf(connection) {
  * whatever switch an `AdtClient` built over it was given.
  */
 const NO_NEGOTIATION = Symbol.for('@mcp-abap-adt/adt-clients/acceptNegotiation/none');
-/** Mark a connection so accept negotiation never corrects or resends through it. */
+/**
+ * Mark a connection so accept negotiation never corrects or resends through it.
+ *
+ * Public for a consumer that hands members its own connection over an
+ * `AdtBatchConnection` — a per-call wrapper, say: an `AdtBatchConnection` marks
+ * itself, but a different object is not it, and is negotiated like any other
+ * connection unless it is marked too. The mark is permanent; there is no unmark.
+ */
 function exemptFromAcceptNegotiation(connection) {
     Object.defineProperty(connection, NO_NEGOTIATION, {
         value: true,
@@ -132,8 +139,10 @@ function buildCacheKey(request) {
  * wrapped it: accept negotiation corrects and resends nothing. The
  * connection's own handling (credential, CSRF, session) is untouched.
  *
- * Exported for the batch connection: what SAP answers to an envelope is the
- * caller's to read.
+ * Exported for the batch connection, and public for a consumer that forwards a
+ * batch's envelope through a connection of its own over one an `AdtClient`
+ * wrapped: what SAP answers to an envelope is the caller's to read. For a
+ * connection never wrapped it is the connection's own `makeAdtRequest`, bound.
  */
 function getBaseRequest(connection) {
     return (baseRequestMap.get(connection) ?? connection.makeAdtRequest.bind(connection));

package/docs/usage/BATCH.md

@@ -80,7 +80,13 @@ itself sends through it once. On a connection an `AdtClient` wrapped with
 correction on, a `406` or `415` answered to the envelope reaches `execute()` and
 every part of that envelope as it came. A part's own `401`, `406` or `415` is
 that part's answer like any other status; nothing reads it, corrects it or
-sends it again. A batch is yours, and so is
+sends it again. A connection of your own that members send through instead of
+the batch connection — a per-call wrapper over it, say — is a different object
+and is negotiated like any other; mark it with `exemptFromAcceptNegotiation(wrapper)`
+(exported by the package) and it is exempt too. When the batch connection wraps
+a forwarder of yours over a connection an `AdtClient` wrapped, forward through
+`getBaseRequest(thatConnection)` (exported): the envelope then bypasses that
+connection's accept negotiation and is sent once. A batch is yours, and so is
 what SAP answered to each of its parts. The envelope request itself still goes
 through the connection's own handling — credential renewal, CSRF recovery and
 session — as every request does: that is about the connection to the endpoint,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mcp-abap-adt/adt-clients",
-  "version": "34.0.0",
+  "version": "34.2.0",
   "description": "ADT clients for SAP ABAP systems - AdtClient and AdtRuntimeClient",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",