globalpayments-api 3.11.2 → 3.11.3

package/lib/test/Unit/Terminals/UPA/Responses/UpaSAFResponse.test.js

@@ -0,0 +1,95 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * Live-device unit tests for UpaSAFResponse (ISAFResponse contract).
+ *
+ * Exercises sendStoreAndForward() and deleteSaf() over live MITC and
+ * asserts every mapped field on UpaSAFResponse plus every optional
+ * bucket declared by ISAFResponse per UPA §12.4.14 / §12.4.15.
+ *
+ * No mocks — this test only runs against a real device+gateway.
+ */
+const src_1 = require("../../../../../src");
+const UpaSAFResponse_1 = require("../../../../../src/Terminals/UPA/Reponses/UpaSAFResponse");
+const UpaHelpertest_1 = require("../UpaHelpertest");
+jest.setTimeout(240000);
+function sleep(delayMs) {
+    return new Promise((resolve) => setTimeout(resolve, delayMs));
+}
+async function settleDevice(delayMs = 8000) {
+    if (UpaHelpertest_1.useLiveMic) {
+        await sleep(delayMs);
+    }
+}
+afterEach(async () => {
+    await settleDevice();
+});
+(0, UpaHelpertest_1.describeUpaLive)("UPA Response – UpaSAFResponse (all fields, live MITC)", () => {
+    let device;
+    beforeEach(() => {
+        device = (0, UpaHelpertest_1.createTestDevice)();
+    });
+    test("sendStoreAndForward() populates every IDeviceResponse + ISAFResponse field", async () => {
+        const response = (await device.sendStoreAndForward());
+        expect(response).toBeInstanceOf(UpaSAFResponse_1.UpaSAFResponse);
+        expect(response.command).toBe("SendSAF");
+        expect(typeof response.status).toBe("string");
+        expect(response.status.length).toBeGreaterThan(0);
+        expect(typeof response.deviceResponseCode).toBe("string");
+        expect(typeof response.deviceResponseText).toBe("string");
+        expect(typeof response.referenceNumber).toBe("string");
+        expect(typeof response.version).toBe("string");
+        // ISAFResponse-only optional fields — must at least be typed
+        expect(response.totalCount === undefined ||
+            typeof response.totalCount === "number").toBe(true);
+        expect(response.totalAmount === undefined ||
+            typeof response.totalAmount === "number").toBe(true);
+        expect(response.multipleMessage === undefined ||
+            typeof response.multipleMessage === "string").toBe(true);
+    });
+    test("sendStoreAndForward() populates approved/pending/declined buckets when SAF data exists", async () => {
+        const response = (await device.sendStoreAndForward());
+        if (response.status !== "Success") {
+            console.warn(`sendStoreAndForward() returned ${response.deviceResponseCode} (${response.deviceResponseMessage}). Bucket assertions skipped — device has no SAF records.`);
+            return;
+        }
+        expect(response.deviceResponseCode).toBe("00");
+        expect(response.totalCount).toBeDefined();
+        expect(response.totalAmount).toBeDefined();
+        expect(response.totalCount).toBeGreaterThanOrEqual(0);
+        expect(response.totalAmount).toBeGreaterThanOrEqual(0);
+        // Bucket dictionaries are optional; when populated their entries must
+        // conform to the UpaSafSummaryResponse shape.
+        const allBuckets = [response.approved, response.pending, response.declined];
+        const populated = allBuckets.filter((b) => b !== undefined);
+        if (populated.length === 0) {
+            console.warn("sendStoreAndForward() success returned no bucket dictionaries; device reported totals only.");
+            return;
+        }
+        for (const bucket of populated) {
+            for (const summary of Object.values(bucket)) {
+                expect(summary).toBeDefined();
+                expect(typeof summary.summaryType).toBe("number");
+                expect([
+                    src_1.SummaryType.Approved,
+                    src_1.SummaryType.Pending,
+                    src_1.SummaryType.Declined,
+                ].includes(summary.summaryType)).toBe(true);
+                expect(Array.isArray(summary.transactions)).toBe(true);
+                expect(typeof summary.count === "number").toBe(true);
+                expect(typeof summary.totalAmount === "number").toBe(true);
+            }
+        }
+    });
+    test("deleteSaf() returns a fully populated UpaSAFResponse (command = DeleteSAF)", async () => {
+        const response = (await device.deleteSaf("NON-EXISTENT-REF", "NON-EXISTENT-TRAN"));
+        expect(response).toBeInstanceOf(UpaSAFResponse_1.UpaSAFResponse);
+        // requestType tag ensures extractCommand surfaces "DeleteSAF" even when
+        // the device echoes back a generic "SendCommand".
+        expect(["DeleteSAF", "SendCommand"]).toContain(response.command);
+        expect(typeof response.status).toBe("string");
+        expect(typeof response.deviceResponseCode).toBe("string");
+        expect(typeof response.deviceResponseText).toBe("string");
+    });
+});
+//# sourceMappingURL=UpaSAFResponse.test.js.map

package/lib/test/Unit/Terminals/UPA/Responses/UpaSAFResponse.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UpaSAFResponse.test.js","sourceRoot":"","sources":["../../../../../../test/Unit/Terminals/UPA/Responses/UpaSAFResponse.test.ts"],"names":[],"mappings":"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"}

package/lib/test/Unit/Terminals/UPA/Responses/UpaTransactionResponse.test.d.ts

@@ -0,0 +1 @@
+export {};