@padosoft/react-native-ecr17 0.0.0 → 2.0.0

package/cpp/Ecr17Response/Ecr17Response.hpp

@@ -1,113 +1,113 @@
-#pragma once
-
-#include <cstdint>
-#include <string>
-
-// Parsers for ECR17 terminal *response* application messages. They take the
-// application payload (the bytes between STX and ETX, i.e. DecodedPacket.payload)
-// and return plain C++ structs — intentionally independent of Nitro so they can
-// be unit-tested standalone. HybridEcr17Client maps these to the generated Nitro
-// result types. Field offsets follow the spec response tables in docs/.
-//
-// Parsing is defensive: fields beyond the payload length come back empty rather
-// than throwing, so a short/truncated response degrades gracefully.
-
-namespace margelo::nitro::ecr17 {
-
-enum class Outcome {
-    Ok,             // "00"
-    Ko,             // "01"
-    CardNotPresent, // "05"
-    UnknownTag,     // "09"
-    Unknown,        // anything else / missing
-};
-
-Outcome outcomeFromCode(const std::string& code);
-
-// Optional DCC / currency-exchange block (parsed from a 'V'/'v' response).
-// Named DccInfo (not CurrencyExchange) to avoid clashing with the Nitro-generated
-// CurrencyExchange struct in the same namespace.
-struct DccInfo {
-    bool applied = false;
-    std::string rate;          // 8 digits, 4 decimals
-    std::string currencyCode;  // alpha-3
-    std::string amount;        // 12 digits, in transaction currency
-    std::string precision;     // decimals
-};
-
-// Result of a payment-family response ('E' without DCC, 'V' with DCC). Reused
-// for reversal / card verification / pre-auth closure which share the layout.
-struct PaymentResponse {
-    Outcome outcome = Outcome::Unknown;
-    std::string resultCode;       // raw "00"/"01"/"05"/"09"
-    std::string pan;              // positive
-    std::string transactionType;  // positive, raw "ICC"/"MAG"/...
-    std::string authCode;         // positive
-    std::string hostDateTime;     // positive, raw DDDHHMM
-    std::string errorDescription; // negative
-    std::string cardType;         // common, raw "1"/"2"/"3"
-    std::string acquirerId;       // common
-    std::string stan;             // common
-    std::string onlineId;         // common
-    DccInfo currency;             // only when DCC present
-};
-
-struct StatusResponse {
-    std::string terminalId;
-    std::string dateTimeRaw;  // "DDMMYYhhmm"
-    int status = -1;          // 0..6, -1 = unknown/missing
-    std::string softwareRelease;
-};
-
-struct TotalsResponse {
-    Outcome outcome = Outcome::Unknown;
-    std::string resultCode;
-    std::string posTotal;  // 16 digits, cents
-};
-
-struct CloseResponse {
-    Outcome outcome = Outcome::Unknown;
-    std::string resultCode;
-    std::string posTotal;          // positive, 16 digits
-    std::string hostTotal;         // positive, 16 digits
-    std::string errorDescription;  // negative
-    std::string actionCode;        // negative
-};
-
-struct PreAuthResponse {
-    Outcome outcome = Outcome::Unknown;
-    std::string resultCode;
-    std::string pan;
-    std::string transactionType;
-    std::string authCode;
-    std::string preAuthorizedAmount;  // 8 digits, cents
-    std::string preAuthCode;          // 9 digits, unique pre-auth id
-    std::string actionCode;
-    std::string hostDateTime;
-    std::string errorDescription;
-    std::string cardType;
-    std::string acquirerId;
-    std::string stan;
-    std::string onlineId;
-};
-
-struct VasResponse {
-    std::string responseId;       // RESPID parsed from XML ("0" = OK), "" if absent
-    std::string responseMessage;  // RESPMSG
-    std::string orderId;          // ORDER_ID
-    bool moreMessages = false;    // concatenation flag "1"
-    std::string idMessage;        // 3-digit sequence
-    std::string rawXml;           // the XML body of this message
-};
-
-class Ecr17Response {
-   public:
-    static PaymentResponse parsePayment(const std::string& payload);
-    static StatusResponse parseStatus(const std::string& payload);
-    static TotalsResponse parseTotals(const std::string& payload);
-    static CloseResponse parseClose(const std::string& payload);
-    static PreAuthResponse parsePreAuth(const std::string& payload);
-    static VasResponse parseVas(const std::string& payload);
-};
-
-}  // namespace margelo::nitro::ecr17
+#pragma once
+
+#include <cstdint>
+#include <string>
+
+// Parsers for ECR17 terminal *response* application messages. They take the
+// application payload (the bytes between STX and ETX, i.e. DecodedPacket.payload)
+// and return plain C++ structs — intentionally independent of Nitro so they can
+// be unit-tested standalone. HybridEcr17Client maps these to the generated Nitro
+// result types. Field offsets follow the spec response tables in docs/.
+//
+// Parsing is defensive: fields beyond the payload length come back empty rather
+// than throwing, so a short/truncated response degrades gracefully.
+
+namespace margelo::nitro::ecr17 {
+
+enum class Outcome {
+    Ok,             // "00"
+    Ko,             // "01"
+    CardNotPresent, // "05"
+    UnknownTag,     // "09"
+    Unknown,        // anything else / missing
+};
+
+Outcome outcomeFromCode(const std::string& code);
+
+// Optional DCC / currency-exchange block (parsed from a 'V'/'v' response).
+// Named DccInfo (not CurrencyExchange) to avoid clashing with the Nitro-generated
+// CurrencyExchange struct in the same namespace.
+struct DccInfo {
+    bool applied = false;
+    std::string rate;          // 8 digits, 4 decimals
+    std::string currencyCode;  // alpha-3
+    std::string amount;        // 12 digits, in transaction currency
+    std::string precision;     // decimals
+};
+
+// Result of a payment-family response ('E' without DCC, 'V' with DCC). Reused
+// for reversal / card verification / pre-auth closure which share the layout.
+struct PaymentResponse {
+    Outcome outcome = Outcome::Unknown;
+    std::string resultCode;       // raw "00"/"01"/"05"/"09"
+    std::string pan;              // positive
+    std::string transactionType;  // positive, raw "ICC"/"MAG"/...
+    std::string authCode;         // positive
+    std::string hostDateTime;     // positive, raw DDDHHMM
+    std::string errorDescription; // negative
+    std::string cardType;         // common, raw "1"/"2"/"3"
+    std::string acquirerId;       // common
+    std::string stan;             // common
+    std::string onlineId;         // common
+    DccInfo currency;             // only when DCC present
+};
+
+struct StatusResponse {
+    std::string terminalId;
+    std::string dateTimeRaw;  // "DDMMYYhhmm"
+    int status = -1;          // 0..6, -1 = unknown/missing
+    std::string softwareRelease;
+};
+
+struct TotalsResponse {
+    Outcome outcome = Outcome::Unknown;
+    std::string resultCode;
+    std::string posTotal;  // 16 digits, cents
+};
+
+struct CloseResponse {
+    Outcome outcome = Outcome::Unknown;
+    std::string resultCode;
+    std::string posTotal;          // positive, 16 digits
+    std::string hostTotal;         // positive, 16 digits
+    std::string errorDescription;  // negative
+    std::string actionCode;        // negative
+};
+
+struct PreAuthResponse {
+    Outcome outcome = Outcome::Unknown;
+    std::string resultCode;
+    std::string pan;
+    std::string transactionType;
+    std::string authCode;
+    std::string preAuthorizedAmount;  // 8 digits, cents
+    std::string preAuthCode;          // 9 digits, unique pre-auth id
+    std::string actionCode;
+    std::string hostDateTime;
+    std::string errorDescription;
+    std::string cardType;
+    std::string acquirerId;
+    std::string stan;
+    std::string onlineId;
+};
+
+struct VasResponse {
+    std::string responseId;       // RESPID parsed from XML ("0" = OK), "" if absent
+    std::string responseMessage;  // RESPMSG
+    std::string orderId;          // ORDER_ID
+    bool moreMessages = false;    // concatenation flag "1"
+    std::string idMessage;        // 3-digit sequence
+    std::string rawXml;           // the XML body of this message
+};
+
+class Ecr17Response {
+   public:
+    static PaymentResponse parsePayment(const std::string& payload);
+    static StatusResponse parseStatus(const std::string& payload);
+    static TotalsResponse parseTotals(const std::string& payload);
+    static CloseResponse parseClose(const std::string& payload);
+    static PreAuthResponse parsePreAuth(const std::string& payload);
+    static VasResponse parseVas(const std::string& payload);
+};
+
+}  // namespace margelo::nitro::ecr17

package/cpp/Lcr/Lcr.cpp

@@ -1,42 +1,42 @@
-#include "Lcr.hpp"
-
-namespace margelo::nitro::ecr17 {
-
-static constexpr uint8_t STX = 0x02;
-static constexpr uint8_t ETX = 0x03;
-
-uint8_t Lrc::compute(const std::vector<uint8_t>& payload, LrcMode mode) {
-    uint8_t lrc = BASE;
-
-    switch (mode) {
-        case LrcMode::STX:
-        case LrcMode::STX_NOEXT:
-            lrc ^= STX;
-            break;
-
-        default:
-            break;
-    }
-
-    for (auto b : payload) {
-        lrc ^= b;
-    }
-
-    switch (mode) {
-        case LrcMode::STX:
-        case LrcMode::NOEXT:
-            lrc ^= ETX;
-            break;
-
-        default:
-            break;
-    }
-
-    return lrc;
-}
-
-uint8_t Lrc::compute(const std::string& payload, LrcMode mode) {
-    return compute(std::vector<uint8_t>(payload.begin(), payload.end()), mode);
-}
-
-}  // namespace margelo::nitro::ecr17
+#include "Lcr.hpp"
+
+namespace margelo::nitro::ecr17 {
+
+static constexpr uint8_t STX = 0x02;
+static constexpr uint8_t ETX = 0x03;
+
+uint8_t Lrc::compute(const std::vector<uint8_t>& payload, LrcMode mode) {
+    uint8_t lrc = BASE;
+
+    switch (mode) {
+        case LrcMode::STX:
+        case LrcMode::STX_NOEXT:
+            lrc ^= STX;
+            break;
+
+        default:
+            break;
+    }
+
+    for (auto b : payload) {
+        lrc ^= b;
+    }
+
+    switch (mode) {
+        case LrcMode::STX:
+        case LrcMode::NOEXT:
+            lrc ^= ETX;
+            break;
+
+        default:
+            break;
+    }
+
+    return lrc;
+}
+
+uint8_t Lrc::compute(const std::string& payload, LrcMode mode) {
+    return compute(std::vector<uint8_t>(payload.begin(), payload.end()), mode);
+}
+
+}  // namespace margelo::nitro::ecr17

package/cpp/Lcr/Lcr.hpp

@@ -1,22 +1,22 @@
-// cpp/core/Lrc.hpp
-
-#pragma once
-
-#include <cstdint>
-#include <string>
-#include <vector>
-
-#include "LrcMode.hpp"
-
-namespace margelo::nitro::ecr17 {
-
-class Lrc {
-   public:
-    static constexpr uint8_t BASE = 0x7F;
-
-    static uint8_t compute(const std::vector<uint8_t>& payload, LrcMode mode);
-
-    static uint8_t compute(const std::string& payload, LrcMode mode);
-};
-
+// cpp/core/Lrc.hpp
+
+#pragma once
+
+#include <cstdint>
+#include <string>
+#include <vector>
+
+#include "LrcMode.hpp"
+
+namespace margelo::nitro::ecr17 {
+
+class Lrc {
+   public:
+    static constexpr uint8_t BASE = 0x7F;
+
+    static uint8_t compute(const std::vector<uint8_t>& payload, LrcMode mode);
+
+    static uint8_t compute(const std::string& payload, LrcMode mode);
+};
+
 }  // namespace margelo::nitro::ecr17

package/cpp/PacketCodec/PacketCodec.cpp

@@ -1,146 +1,146 @@
-#include "PacketCodec.hpp"
-
-#include <algorithm>  // std::find
-#include <iterator>   // std::distance
-
-namespace margelo::nitro::ecr17 {
-
-PacketCodec::PacketCodec(LrcMode mode) : lrcMode_(mode) {}
-
-std::vector<uint8_t> PacketCodec::encodeApplication(const std::string& payload) {
-    std::vector<uint8_t> frame;
-
-    frame.push_back(STX);
-
-    frame.insert(frame.end(), payload.begin(), payload.end());
-
-    frame.push_back(ETX);
-
-    uint8_t lrc = Lrc::compute(payload, lrcMode_);
-
-    frame.push_back(lrc);
-
-    return frame;
-}
-
-std::vector<uint8_t> PacketCodec::encodeControl(uint8_t ctrl) {
-    std::vector<uint8_t> frame;
-
-    frame.push_back(ctrl);
-    frame.push_back(ETX);
-
-    uint8_t lrc = Lrc::compute(std::vector<uint8_t>{ctrl}, lrcMode_);
-
-    frame.push_back(lrc);
-
-    return frame;
-}
-
-DecodedPacket PacketCodec::decode(const std::vector<uint8_t>& data) {
-    if (data.empty()) {
-        return {
-            PacketType::UNKNOWN,
-            "",
-            false,
-        };
-    }
-
-    uint8_t first = data[0];
-
-    if (first == ACK) {
-        return {
-            PacketType::ACK,
-            "",
-            true,
-        };
-    }
-
-    if (first == NAK) {
-        return {
-            PacketType::NAK,
-            "",
-            true,
-        };
-    }
-
-    if (first == SOH) {
-        // Progress update packet: SOH + message + EOT (no LRC). We need at least
-        // SOH and the trailing EOT before stripping the first/last byte,
-        // otherwise the iterator range below would be invalid (last < first).
-        if (data.size() < 2) {
-            return {
-                PacketType::UNKNOWN,
-                "",
-                false,
-            };
-        }
-
-        // The spec mandates SOH + 20-char message + EOT. Reject any frame whose
-        // final byte is not EOT so that garbage or a truncated read is never
-        // silently accepted as a valid progress update.
-        if (data.back() != EOT) {
-            return {
-                PacketType::UNKNOWN,
-                "",
-                false,
-            };
-        }
-
-        std::string payload(data.begin() + 1, data.end() - 1);
-
-        return {
-            PacketType::PROGRESS,
-            payload,
-            true,
-        };
-    }
-
-    if (first == STX) {
-        auto etxIt = std::find(data.begin(), data.end(), ETX);
-
-        if (etxIt == data.end()) {
-            return {
-                PacketType::UNKNOWN,
-                "",
-                false,
-            };
-        }
-
-        size_t etxIndex = std::distance(data.begin(), etxIt);
-
-        // A well-formed application frame is exactly STX + payload + ETX + LRC,
-        // so the LRC must be the final byte. Reject both a truncated frame (no
-        // LRC after ETX) and a buffer with trailing bytes -- e.g. a coalesced
-        // socket read holding a second frame ("STX..ETX LRC STX..") or garbage
-        // after the LRC. Splitting a byte stream into individual frames is the
-        // transport layer's responsibility, and DecodedPacket cannot carry the
-        // unconsumed remainder.
-        if (etxIndex + 2 != data.size()) {
-            return {
-                PacketType::UNKNOWN,
-                "",
-                false,
-            };
-        }
-
-        std::string payload(data.begin() + 1, data.begin() + etxIndex);
-
-        uint8_t rxLrc = data[etxIndex + 1];
-
-        uint8_t calcLrc = Lrc::compute(payload, lrcMode_);
-
-        return {
-            PacketType::APPLICATION,
-            payload,
-            rxLrc == calcLrc,
-        };
-    }
-
-    return {
-        PacketType::UNKNOWN,
-        "",
-        false,
-    };
-}
-
+#include "PacketCodec.hpp"
+
+#include <algorithm>  // std::find
+#include <iterator>   // std::distance
+
+namespace margelo::nitro::ecr17 {
+
+PacketCodec::PacketCodec(LrcMode mode) : lrcMode_(mode) {}
+
+std::vector<uint8_t> PacketCodec::encodeApplication(const std::string& payload) {
+    std::vector<uint8_t> frame;
+
+    frame.push_back(STX);
+
+    frame.insert(frame.end(), payload.begin(), payload.end());
+
+    frame.push_back(ETX);
+
+    uint8_t lrc = Lrc::compute(payload, lrcMode_);
+
+    frame.push_back(lrc);
+
+    return frame;
+}
+
+std::vector<uint8_t> PacketCodec::encodeControl(uint8_t ctrl) {
+    std::vector<uint8_t> frame;
+
+    frame.push_back(ctrl);
+    frame.push_back(ETX);
+
+    uint8_t lrc = Lrc::compute(std::vector<uint8_t>{ctrl}, lrcMode_);
+
+    frame.push_back(lrc);
+
+    return frame;
+}
+
+DecodedPacket PacketCodec::decode(const std::vector<uint8_t>& data) {
+    if (data.empty()) {
+        return {
+            PacketType::UNKNOWN,
+            "",
+            false,
+        };
+    }
+
+    uint8_t first = data[0];
+
+    if (first == ACK) {
+        return {
+            PacketType::ACK,
+            "",
+            true,
+        };
+    }
+
+    if (first == NAK) {
+        return {
+            PacketType::NAK,
+            "",
+            true,
+        };
+    }
+
+    if (first == SOH) {
+        // Progress update packet: SOH + message + EOT (no LRC). We need at least
+        // SOH and the trailing EOT before stripping the first/last byte,
+        // otherwise the iterator range below would be invalid (last < first).
+        if (data.size() < 2) {
+            return {
+                PacketType::UNKNOWN,
+                "",
+                false,
+            };
+        }
+
+        // The spec mandates SOH + 20-char message + EOT. Reject any frame whose
+        // final byte is not EOT so that garbage or a truncated read is never
+        // silently accepted as a valid progress update.
+        if (data.back() != EOT) {
+            return {
+                PacketType::UNKNOWN,
+                "",
+                false,
+            };
+        }
+
+        std::string payload(data.begin() + 1, data.end() - 1);
+
+        return {
+            PacketType::PROGRESS,
+            payload,
+            true,
+        };
+    }
+
+    if (first == STX) {
+        auto etxIt = std::find(data.begin(), data.end(), ETX);
+
+        if (etxIt == data.end()) {
+            return {
+                PacketType::UNKNOWN,
+                "",
+                false,
+            };
+        }
+
+        size_t etxIndex = std::distance(data.begin(), etxIt);
+
+        // A well-formed application frame is exactly STX + payload + ETX + LRC,
+        // so the LRC must be the final byte. Reject both a truncated frame (no
+        // LRC after ETX) and a buffer with trailing bytes -- e.g. a coalesced
+        // socket read holding a second frame ("STX..ETX LRC STX..") or garbage
+        // after the LRC. Splitting a byte stream into individual frames is the
+        // transport layer's responsibility, and DecodedPacket cannot carry the
+        // unconsumed remainder.
+        if (etxIndex + 2 != data.size()) {
+            return {
+                PacketType::UNKNOWN,
+                "",
+                false,
+            };
+        }
+
+        std::string payload(data.begin() + 1, data.begin() + etxIndex);
+
+        uint8_t rxLrc = data[etxIndex + 1];
+
+        uint8_t calcLrc = Lrc::compute(payload, lrcMode_);
+
+        return {
+            PacketType::APPLICATION,
+            payload,
+            rxLrc == calcLrc,
+        };
+    }
+
+    return {
+        PacketType::UNKNOWN,
+        "",
+        false,
+    };
+}
+
 }  // namespace margelo::nitro::ecr17