@adobe/acc-js-sdk 1.1.62 → 1.2.0

package/src/xtkEntityCache.js

@@ -10,25 +10,25 @@ OF ANY KIND, either express or implied. See the License for the specific languag
 governing permissions and limitations under the License.
 */
 (function() {
-"use strict";
+  "use strict";
 
-const DomUtil = require('./domUtil.js').DomUtil;
-const { Cache } = require('./cache.js');
+  const DomUtil = require('./domUtil.js').DomUtil;
+  const { Cache } = require('./cache.js');
 
 
-/**********************************************************************************
+  /**********************************************************************************
  * 
  * Caches Xtk Entities (schemas, etc...) 
  * 
  *********************************************************************************/
 
-/**
+  /**
  * @private
  * @class
  * @constructor
  * @memberof Campaign
  */
-class XtkEntityCache extends Cache {
+  class XtkEntityCache extends Cache {
     
     /**
      * A in-memory cache for xtk entities. Not intended to be used directly,
@@ -42,20 +42,20 @@ class XtkEntityCache extends Cache {
      * @param {string} rootKey is an optional root key to use for the storage object
      * @param {number} ttl is the TTL for objects in ms. Defaults to 5 mins
      */
-     constructor(storage, rootKey, ttl) {
-        super(storage, rootKey, ttl, (entityType, entityFullName) => entityType + "|" + entityFullName, (item, serDeser) => {
-            if (serDeser) {
-                if (!item || !item.value) throw Error(`Cannot serialize falsy cached item`);
-                const value = Object.assign({}, item);
-                value.value = DomUtil.toXMLString(item.value);
-                return JSON.stringify(value);
-            }
-            else {
-                const json = JSON.parse(item);
-                json.value = DomUtil.parse(json.value).documentElement;
-                return json;
-            }
-        });
+    constructor(storage, rootKey, ttl) {
+      super(storage, rootKey, ttl, (entityType, entityFullName) => entityType + "|" + entityFullName, (item, serDeser) => {
+        if (serDeser) {
+          if (!item || !item.value) throw Error(`Cannot serialize falsy cached item`);
+          const value = Object.assign({}, item);
+          value.value = DomUtil.toXMLString(item.value);
+          return JSON.stringify(value);
+        }
+        else {
+          const json = JSON.parse(item);
+          json.value = DomUtil.parse(json.value).documentElement;
+          return json;
+        }
+      });
     }
 
     /**
@@ -65,7 +65,7 @@ class XtkEntityCache extends Cache {
      * @returns {*} the cached entity, or undefined if not found
      */
     async get(entityType, entityFullName) {
-        return await super.get(entityType, entityFullName);
+      return await super.get(entityType, entityFullName);
     }
 
     /**
@@ -75,22 +75,22 @@ class XtkEntityCache extends Cache {
      * @param {*} entity is the entity
      */
     async put(entityType, entityFullName, entity) {
-        await super.put(entityType, entityFullName, entity);
-        // For schemas, cache interfaces
-        if (entityType == "xtk:schema") {
-            const namespace = entity.getAttribute("namespace");
-            var interfaceElement = DomUtil.getFirstChildElement(entity, "interface");
-            while (interfaceElement) {
-                const name = `${namespace}:${interfaceElement.getAttribute("name")}`;
-                await super.put(entityType, name, interfaceElement);
-                interfaceElement = DomUtil.getNextSiblingElement(interfaceElement, "interface");
-            }
+      await super.put(entityType, entityFullName, entity);
+      // For schemas, cache interfaces
+      if (entityType == "xtk:schema") {
+        const namespace = entity.getAttribute("namespace");
+        var interfaceElement = DomUtil.getFirstChildElement(entity, "interface");
+        while (interfaceElement) {
+          const name = `${namespace}:${interfaceElement.getAttribute("name")}`;
+          await super.put(entityType, name, interfaceElement);
+          interfaceElement = DomUtil.getNextSiblingElement(interfaceElement, "interface");
         }
+      }
     }
-}
+  }
 
 
-// Public exports
-exports.XtkEntityCache = XtkEntityCache;
+  // Public exports
+  exports.XtkEntityCache = XtkEntityCache;
 
 })();

package/src/xtkJob.js

@@ -10,13 +10,13 @@ OF ANY KIND, either express or implied. See the License for the specific languag
 governing permissions and limitations under the License.
 */
 (function() {
-"use strict";
+  "use strict";
 
-const { CampaignException } = require("./campaign.js");
-const { DomUtil } = require("./domUtil.js");
-const { XtkCaster } = require("./xtkCaster.js");
+  const { CampaignException } = require("./campaign.js");
+  const { DomUtil } = require("./domUtil.js");
+  const { XtkCaster } = require("./xtkCaster.js");
 
-/**
+  /**
  * @namespace Campaign
  * 
  * @typedef {DOMElement} SoapMethodDefinition
@@ -25,7 +25,7 @@ const { XtkCaster } = require("./xtkCaster.js");
 
 
 
-/**
+  /**
  * The complete Triforce, or one or more components of the Triforce.
  * @typedef {Object} XtkSoapCallSpec
  * @property {string} method - the Soap method name (without any schema information)
@@ -36,7 +36,7 @@ const { XtkCaster } = require("./xtkCaster.js");
  * @memberOf Campaign
  */
 
-/**
+  /**
  * @typedef {Object} XtkJobLog
  * @property {number} id - the job log id, which can be used for subsequent calls to getStatus
  * @property {number} iRc - the job return code (0 = ok)
@@ -49,7 +49,7 @@ const { XtkCaster } = require("./xtkCaster.js");
  */
 
 
-/**
+  /**
  * @typedef {Object} XtkJobStatus
  * @property {number} status - the job status code, as defined in the xtk:job:jobStatus enumeration
  * @property {XtkJobLog[]} logs - the job log messages
@@ -57,19 +57,19 @@ const { XtkCaster } = require("./xtkCaster.js");
  * @memberOf Campaign
  */
 
-/**********************************************************************************
+  /**********************************************************************************
  *
  * Job Interface
  * Wraps the xtk:jobInterface interface into convenient JavaScript class
  *
  *********************************************************************************/
-/**
+  /**
  * @private
  * @class
  * @constructor
  * @memberof Campaign
  */
-class XtkJobInterface {
+  class XtkJobInterface {
 
     /**
      * Create a job interface from a client and a SOAP call definition. This method is not meant to be called directly, 
@@ -78,22 +78,22 @@ class XtkJobInterface {
      * @param {Campaign.XtkSoapCallSpec} soapCallSpec the definition of the SOAP call
      */
     constructor(client, soapCallSpec) {
-        this._reset();
-        this._client = client;
-        this._soapCall = soapCallSpec;
-        this._maxLogCount = 100; // default fetch size
-        this.jobId = soapCallSpec ? soapCallSpec.jobId : undefined;
+      this._reset();
+      this._client = client;
+      this._soapCall = soapCallSpec;
+      this._maxLogCount = 100; // default fetch size
+      this.jobId = soapCallSpec ? soapCallSpec.jobId : undefined;
     }
 
     // Reset state before executing or submitting a job
     _reset() {
-        this.jobId = undefined;
-        this.status = undefined;
-        this.result = undefined;
-        this.lastLogId = 0;
-        this.iRc = 0;
-        this.lastErrorCode = undefined;
-        this.firstErrorCode = undefined;
+      this.jobId = undefined;
+      this.status = undefined;
+      this.result = undefined;
+      this.lastLogId = 0;
+      this.iRc = 0;
+      this.lastErrorCode = undefined;
+      this.firstErrorCode = undefined;
     }
 
     /**
@@ -103,21 +103,21 @@ class XtkJobInterface {
      * @returns {string} a job id
      */
     async execute() {
-        this._reset();
-        const methodName = this._soapCall.method;
-        const entitySchemaId = this._soapCall.xtkschema ? this._soapCall.xtkschema : (this._soapCall.object ? this._soapCall.object.xtkschema : undefined);
-        if (!entitySchemaId)
-            throw CampaignException.SOAP_UNKNOWN_METHOD(entitySchemaId, methodName, `No schema was provided in soap call or object`);
-        const callContext = {
-            client: this._client,
-            object: this._soapCall.object,
-            schemaId: 'xtk:jobInterface',
-            entitySchemaId: entitySchemaId,
-            headers: this._client._connectionParameters._options.extraHttpHeaders
-        };
-        var jobId = await callContext.client._callMethod("Execute", callContext, [ methodName ]);
-        this.jobId = jobId;
-        return jobId;
+      this._reset();
+      const methodName = this._soapCall.method;
+      const entitySchemaId = this._soapCall.xtkschema ? this._soapCall.xtkschema : (this._soapCall.object ? this._soapCall.object.xtkschema : undefined);
+      if (!entitySchemaId)
+        throw CampaignException.SOAP_UNKNOWN_METHOD(entitySchemaId, methodName, `No schema was provided in soap call or object`);
+      const callContext = {
+        client: this._client,
+        object: this._soapCall.object,
+        schemaId: 'xtk:jobInterface',
+        entitySchemaId: entitySchemaId,
+        headers: this._client._connectionParameters._options.extraHttpHeaders
+      };
+      var jobId = await callContext.client._callMethod("Execute", callContext, [ methodName ]);
+      this.jobId = jobId;
+      return jobId;
     }
 
     /**
@@ -126,22 +126,22 @@ class XtkJobInterface {
      * Static methods are not supported
      * @returns {string} a job id
      */
-     async submit() {
-        this._reset();
-        const methodName = this._soapCall.method;
-        const entitySchemaId = this._soapCall.xtkschema ? this._soapCall.xtkschema : (this._soapCall.object ? this._soapCall.object.xtkschema : undefined);
-        if (!entitySchemaId)
-            throw CampaignException.SOAP_UNKNOWN_METHOD(entitySchemaId, methodName, `No schema was provided in soap call or object`);
-        const callContext = {
-            client: this._client,
-            object: this._soapCall.object,
-            schemaId: 'xtk:jobInterface',
-            entitySchemaId: entitySchemaId,
-            headers: this._client._connectionParameters._options.extraHttpHeaders
-        };
-        var jobId = await callContext.client._callMethod("Submit", callContext, [ this._soapCall.method ]);
-        this.jobId = jobId;
-        return jobId;
+    async submit() {
+      this._reset();
+      const methodName = this._soapCall.method;
+      const entitySchemaId = this._soapCall.xtkschema ? this._soapCall.xtkschema : (this._soapCall.object ? this._soapCall.object.xtkschema : undefined);
+      if (!entitySchemaId)
+        throw CampaignException.SOAP_UNKNOWN_METHOD(entitySchemaId, methodName, `No schema was provided in soap call or object`);
+      const callContext = {
+        client: this._client,
+        object: this._soapCall.object,
+        schemaId: 'xtk:jobInterface',
+        entitySchemaId: entitySchemaId,
+        headers: this._client._connectionParameters._options.extraHttpHeaders
+      };
+      var jobId = await callContext.client._callMethod("Submit", callContext, [ this._soapCall.method ]);
+      this.jobId = jobId;
+      return jobId;
     }
 
     /**
@@ -150,58 +150,58 @@ class XtkJobInterface {
      * Static methods are not supported
      * @returns {string} a job id
      */
-     async submitSoapCall() {
-        this._reset();
-        const entitySchemaId = this._soapCall.xtkschema ? this._soapCall.xtkschema : (this._soapCall.object ? this._soapCall.object.xtkschema : undefined);
-        const callContext = {
-            client: this._client,
-            object: this._soapCall.object,
-            schemaId: 'xtk:jobInterface',
-            entitySchemaId: entitySchemaId,
-            headers: this._client._connectionParameters._options.extraHttpHeaders
-        };
-        const methodName = this._soapCall.method;
-        var schema = await this._client.getSchema(entitySchemaId, "xml", true);
-        if (!schema)
-            throw CampaignException.SOAP_UNKNOWN_METHOD(entitySchemaId, methodName, `Schema '${entitySchemaId}' not found`);
-        var method = await this._client._methodCache.get(entitySchemaId, methodName);
-        if (!method)
-            throw CampaignException.SOAP_UNKNOWN_METHOD(entitySchemaId, methodName, `Method '${methodName}' of schema '${entitySchemaId}' not found`);
+    async submitSoapCall() {
+      this._reset();
+      const entitySchemaId = this._soapCall.xtkschema ? this._soapCall.xtkschema : (this._soapCall.object ? this._soapCall.object.xtkschema : undefined);
+      const callContext = {
+        client: this._client,
+        object: this._soapCall.object,
+        schemaId: 'xtk:jobInterface',
+        entitySchemaId: entitySchemaId,
+        headers: this._client._connectionParameters._options.extraHttpHeaders
+      };
+      const methodName = this._soapCall.method;
+      var schema = await this._client.getSchema(entitySchemaId, "xml", true);
+      if (!schema)
+        throw CampaignException.SOAP_UNKNOWN_METHOD(entitySchemaId, methodName, `Schema '${entitySchemaId}' not found`);
+      var method = await this._client._methodCache.get(entitySchemaId, methodName);
+      if (!method)
+        throw CampaignException.SOAP_UNKNOWN_METHOD(entitySchemaId, methodName, `Method '${methodName}' of schema '${entitySchemaId}' not found`);
 
-        const isStatic = DomUtil.getAttributeAsBoolean(method, "static");
+      const isStatic = DomUtil.getAttributeAsBoolean(method, "static");
 
-        var jobId = null;
-        if ( !isStatic)
-            jobId = await callContext.client._callMethod("SubmitSoapCall", callContext, [ {
-                name: this._soapCall.method,
-                service: this._soapCall.xtkschema,
-                param: [
-                    { name:"this", type:"DOMDocument", value: this._soapCall.object },
-                    { name:"bStart", type:"boolean", value:"false" },
-                ]
-            } ]);
-        else {
-            // for non-persistant job, override object to intialize job properties
-            callContext.object = {
-                doNotPersist: "true",
-                xtkschema: this._soapCall.xtkschema,
-                id: this._soapCall.jobId,
-                properties: {
-                    warning: false,
-                }
-            };
-            // SubmitSoapCall now supports static method
-            // no need parameter type as it's already present in API definition
-            jobId = await callContext.client._callMethod("SubmitSoapCall", callContext,
-                    {                
-                        name: this._soapCall.method,
-                        service: this._soapCall.xtkschema,
-                        param : this._soapCall.args
-                    },
-             );
-        }
-        this.jobId = jobId;
-        return jobId;
+      var jobId = null;
+      if ( !isStatic)
+        jobId = await callContext.client._callMethod("SubmitSoapCall", callContext, [ {
+          name: this._soapCall.method,
+          service: this._soapCall.xtkschema,
+          param: [
+            { name:"this", type:"DOMDocument", value: this._soapCall.object },
+            { name:"bStart", type:"boolean", value:"false" },
+          ]
+        } ]);
+      else {
+        // for non-persistant job, override object to intialize job properties
+        callContext.object = {
+          doNotPersist: "true",
+          xtkschema: this._soapCall.xtkschema,
+          id: this._soapCall.jobId,
+          properties: {
+            warning: false,
+          }
+        };
+        // SubmitSoapCall now supports static method
+        // no need parameter type as it's already present in API definition
+        jobId = await callContext.client._callMethod("SubmitSoapCall", callContext,
+          {                
+            name: this._soapCall.method,
+            service: this._soapCall.xtkschema,
+            param : this._soapCall.args
+          },
+        );
+      }
+      this.jobId = jobId;
+      return jobId;
     }
 
     /**
@@ -213,32 +213,32 @@ class XtkJobInterface {
      * @returns {Campaign.XtkJobStatus} an object containing the job status, all logs fetched so for, and job properties
      */
     async getStatus(lastLogId, maxLogCount) {
-        if (lastLogId === undefined) lastLogId = this.lastLogId;
-        if (maxLogCount === null || maxLogCount === undefined) maxLogCount = this._maxLogCount;
-        var status = await this._client.NLWS.xtkJob.getStatus(this.jobId, lastLogId, maxLogCount);
-        if (this._client._representation === "xml") {
-            status[1] = this._client._toRepresentation(status[1], "SimpleJson");
-            status[2] = this._client._toRepresentation(status[2], "SimpleJson");
-        }
-        status = this._makeJobStatus(status);
-        this._updateStatus(status);
-        return status;
+      if (lastLogId === undefined) lastLogId = this.lastLogId;
+      if (maxLogCount === null || maxLogCount === undefined) maxLogCount = this._maxLogCount;
+      var status = await this._client.NLWS.xtkJob.getStatus(this.jobId, lastLogId, maxLogCount);
+      if (this._client._representation === "xml") {
+        status[1] = this._client._toRepresentation(status[1], "SimpleJson");
+        status[2] = this._client._toRepresentation(status[2], "SimpleJson");
+      }
+      status = this._makeJobStatus(status);
+      this._updateStatus(status);
+      return status;
     }
 
     // Aggregate new status with previously fetched status
     _updateStatus(status) {
-        for (var i=0; i<status.logs.length; i++) {
-            if (status.logs[i].id > this.lastLogId)
-                this.lastLogId = status.logs[i].id;
-        }
-        if (this.status === undefined) {
-            this.status = status;
-        }
-        else {
-            const oldLogs = this.status.logs;
-            this.status = status;
-            this.status.logs = oldLogs.concat(this.status.logs);
-        }
+      for (var i=0; i<status.logs.length; i++) {
+        if (status.logs[i].id > this.lastLogId)
+          this.lastLogId = status.logs[i].id;
+      }
+      if (this.status === undefined) {
+        this.status = status;
+      }
+      else {
+        const oldLogs = this.status.logs;
+        this.status = status;
+        this.status.logs = oldLogs.concat(this.status.logs);
+      }
     }
 
     /**
@@ -246,9 +246,9 @@ class XtkJobInterface {
      * @returns {number} the current job progress as a percentage value
      */
     getProgress() {
-        if (!this.status || !this.status.properties || !this.status.properties.progress) return 0;
-        if (!this.status.properties.progress.max) return 0;
-        return this.status.properties.progress.current / this.status.properties.progress.max;
+      if (!this.status || !this.status.properties || !this.status.properties.progress) return 0;
+      if (!this.status.properties.progress.max) return 0;
+      return this.status.properties.progress.current / this.status.properties.progress.max;
     }
 
     /**
@@ -257,104 +257,104 @@ class XtkJobInterface {
      * @returns {*} the job result
      */
     async getResult() {
-        var result = await this._client.NLWS.xtkJob.getResult(this.jobId);
-        result = this._makeJobResult(result);
-        this.result = result;
-        return result;
+      var result = await this._client.NLWS.xtkJob.getResult(this.jobId);
+      result = this._makeJobResult(result);
+      this.result = result;
+      return result;
     }
 
     // Convert the job result into a typed object
     _makeJobResult(rawResult) {
-        return rawResult;
+      return rawResult;
     }
 
     // Convert job logs into a type object
     _makeLogs(rawLogs) {
-        const logs = [];
-        rawLogs = rawLogs || {};
-        rawLogs = XtkCaster.asArray(rawLogs.log);
-        for (var i=0; i<rawLogs.length; i++) {
-            const rawLog = rawLogs[i];
-            var message = XtkCaster.asString(rawLog.message);
-            const match = message.match(/(\w{3}-\d{6})(.*)/);
-            var errorCode = undefined;
-            if (match && match.length >= 2) {
-                errorCode = match[1];
-                message = match[2] || "";
-                message = message.trim();
-            }
-            rawLog.id = XtkCaster.asLong(rawLog.id);
-            rawLog.iRc = XtkCaster.asLong(rawLog.iRc);
-            rawLog.logDate = XtkCaster.asDatetime(rawLog.logDate);
-            rawLog.logType = XtkCaster.asLong(rawLog.logType);
-            rawLog.message = message;
-            rawLog.object = XtkCaster.asString(rawLog.object);
-            rawLog.errorCode = errorCode;
-            logs.push(rawLog);
-
-            if (errorCode) 
-                this.lastErrorCode = errorCode;
-            if (errorCode && !this.firstErrorCode)
-                this.firstErrorCode = errorCode;
-            if (rawLog.iRc != 0)
-                this.iRc = rawLog.iRc;
+      const logs = [];
+      rawLogs = rawLogs || {};
+      rawLogs = XtkCaster.asArray(rawLogs.log);
+      for (var i=0; i<rawLogs.length; i++) {
+        const rawLog = rawLogs[i];
+        var message = XtkCaster.asString(rawLog.message);
+        const match = message.match(/(\w{3}-\d{6})(.*)/);
+        var errorCode = undefined;
+        if (match && match.length >= 2) {
+          errorCode = match[1];
+          message = match[2] || "";
+          message = message.trim();
         }
-        return logs;
+        rawLog.id = XtkCaster.asLong(rawLog.id);
+        rawLog.iRc = XtkCaster.asLong(rawLog.iRc);
+        rawLog.logDate = XtkCaster.asDatetime(rawLog.logDate);
+        rawLog.logType = XtkCaster.asLong(rawLog.logType);
+        rawLog.message = message;
+        rawLog.object = XtkCaster.asString(rawLog.object);
+        rawLog.errorCode = errorCode;
+        logs.push(rawLog);
+
+        if (errorCode) 
+          this.lastErrorCode = errorCode;
+        if (errorCode && !this.firstErrorCode)
+          this.firstErrorCode = errorCode;
+        if (rawLog.iRc != 0)
+          this.iRc = rawLog.iRc;
+      }
+      return logs;
     }
 
     // Convert job properties into a typed object
     _makeProperties(rawProperties) {
-        rawProperties = rawProperties || {};
-        rawProperties.warning = XtkCaster.asBoolean(rawProperties.warning);
-        if (!rawProperties.progress) rawProperties.progress = {};
-        rawProperties.progress.current = XtkCaster.asLong(rawProperties.progress.current);
-        rawProperties.progress.max = XtkCaster.asLong(rawProperties.progress.max);
-        return rawProperties;
+      rawProperties = rawProperties || {};
+      rawProperties.warning = XtkCaster.asBoolean(rawProperties.warning);
+      if (!rawProperties.progress) rawProperties.progress = {};
+      rawProperties.progress.current = XtkCaster.asLong(rawProperties.progress.current);
+      rawProperties.progress.max = XtkCaster.asLong(rawProperties.progress.max);
+      return rawProperties;
     }
 
     // Parse the result of GetStatus API. The result is an array of 3 object. The first is the status code,
     // followed by the the logs, and finally the properties
     _makeJobStatus(rawStatus) {
-        if (!rawStatus) rawStatus = [];
-        return {
-            status: XtkCaster.asLong(rawStatus[0]),
-            logs: this._makeLogs(rawStatus[1]),
-            properties: this._makeProperties(rawStatus[2])
-        };
+      if (!rawStatus) rawStatus = [];
+      return {
+        status: XtkCaster.asLong(rawStatus[0]),
+        logs: this._makeLogs(rawStatus[1]),
+        properties: this._makeProperties(rawStatus[2])
+      };
     }
 
     /**
      * Cancel a preciously submitted job
      */
-     async cancel() {
-        await this._client.NLWS.xtkJob.cancel(this.jobId);
+    async cancel() {
+      await this._client.NLWS.xtkJob.cancel(this.jobId);
     }
 
     /**
      * Pause a preciously submitted job
      */
     async   pause() {
-        await this._client.NLWS.xtkJob.pause(this.jobId);
+      await this._client.NLWS.xtkJob.pause(this.jobId);
     }
     
     /**
      * Waits until a job is actually cancelled
      * @param {number} timeoutSeconds in seconds
      */
-     async waitJobCancelled(timeoutSeconds) {
-        await this._client.NLWS.xtkJob.waitJobCancelled(this.jobId, timeoutSeconds);
+    async waitJobCancelled(timeoutSeconds) {
+      await this._client.NLWS.xtkJob.waitJobCancelled(this.jobId, timeoutSeconds);
     }
 
     /**
      * Queries if warnings or errors have been generated for this job
      * @return {boolean} Returns 'true' if there has been at least one warning or error message
      */
-     async hasWarning() {
-        return XtkCaster.asBoolean(await this._client.NLWS.xtkJob.hasWarning(this.jobId));
+    async hasWarning() {
+      return XtkCaster.asBoolean(await this._client.NLWS.xtkJob.hasWarning(this.jobId));
     }
-}
+  }
 
-// Public exports
-exports.XtkJobInterface = XtkJobInterface;
+  // Public exports
+  exports.XtkJobInterface = XtkJobInterface;
 
 })();

package/test/AGENTS.md

@@ -0,0 +1,37 @@
+---
+last_compiled_date: 2026-04-04
+version: 1.0
+---
+
+# test/AGENTS.md
+
+## Scope
+
+- Unit tests for all `src/` modules with 100% coverage enforcement (branches, lines, statements)
+- Transport-level mocking via `mock.js` — no real HTTP calls
+
+## Key Files
+
+- `mock.js` (shared) — `Mock.makeClient()`, `Mock.withMockConsole()`, and pre-built SOAP response constants (`LOGON_RESPONSE`, `LOGOFF_RESPONSE`, `R_TEST`, etc.)
+- `jest.config.js` (config) — Coverage thresholds, Babel transform, `transformIgnorePatterns` for ESM packages
+- `client.test.js` (largest) — 5000+ lines covering NLWS proxy, SOAP dispatch, session management
+
+## Patterns
+
+### Adding a New Test File
+
+1. Create `test/<module>.test.js` mirroring `src/<module>.js`
+2. Import the module under test and `Mock` from `./mock.js`:
+   ```js
+   const sdk = require('../src/index.js');
+   const Mock = require('./mock.js').Mock;
+   ```
+3. Create client: `const client = await Mock.makeClient();`
+4. Mock transport responses: `client._transport.mockReturnValueOnce(Promise.resolve(xmlString));`
+5. Run: `npm run unit-tests`
+6. Coverage must remain at 100% — add tests for every branch
+
+## Related
+
+- `src/` — source modules under test
+- `mock.js` — shared mock utilities and SOAP response fixtures