@cheqi/sdk 0.1.1 → 0.1.2

package/dist/services/decryption.js

@@ -2,7 +2,7 @@ import { constants, createDecipheriv, createPrivateKey, privateDecrypt } from "n
 import { AES_KEY_LENGTH, GCM_IV_LENGTH, GCM_TAG_LENGTH } from "../crypto.js";
 import { DecryptionError } from "../errors.js";
 import { CreditNoteContextEnvelopeFromJSON } from "../models/generated/CreditNoteContextEnvelope.js";
-import { parseBase64Der } from "../utils.js";
+import { decodeKey } from "../utils.js";
 function rsaDecrypt(encryptedKeyBase64, privateKeyBase64) {
     if (!encryptedKeyBase64) {
         throw new DecryptionError("Encrypted key cannot be empty");
@@ -11,7 +11,7 @@ function rsaDecrypt(encryptedKeyBase64, privateKeyBase64) {
         throw new DecryptionError("Private key is required for decryption");
     }
     const privateKey = createPrivateKey({
-        key: parseBase64Der(privateKeyBase64),
+        key: decodeKey(privateKeyBase64),
         format: "der",
         type: "pkcs8"
     });

package/dist/services/decryption.js.map

@@ -1 +1 @@
-{"version":3,"file":"decryption.js","sourceRoot":"","sources":["../../src/services/decryption.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"decryption.js","sourceRoot":"","sources":["../../src/services/decryption.ts"],"names":[],"mappings":"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"}

package/dist/services/encryption.js

@@ -1,7 +1,22 @@
 import { constants, createCipheriv, createPublicKey, publicEncrypt, randomBytes } from "node:crypto";
 import { AES_KEY_LENGTH, GCM_IV_LENGTH } from "../crypto.js";
 import { EncryptionError } from "../errors.js";
-import { parseBase64Der } from "../utils.js";
+import { decodeKey } from "../utils.js";
+/**
+ * Parse an RSA public key, supporting both X.509 SubjectPublicKeyInfo (SPKI) and
+ * raw PKCS#1 RSAPublicKey DER (the format produced by iOS
+ * `SecKeyCopyExternalRepresentation`). Mirrors the Java SDK `RSAPublicKeyParser`.
+ */
+function parsePublicKey(publicKeyBase64) {
+    const der = decodeKey(publicKeyBase64);
+    try {
+        return createPublicKey({ key: der, format: "der", type: "spki" });
+    }
+    catch {
+        // Fall back to raw PKCS#1 RSA public key (iOS SecKeyCopyExternalRepresentation).
+        return createPublicKey({ key: der, format: "der", type: "pkcs1" });
+    }
+}
 function hybridEncrypt(plaintext, publicKeyBase64) {
     if (!publicKeyBase64) {
         throw new EncryptionError("Public key is required for encryption");
@@ -12,11 +27,7 @@ function hybridEncrypt(plaintext, publicKeyBase64) {
     const ciphertext = Buffer.concat([cipher.update(plaintext, "utf8"), cipher.final()]);
     const tag = cipher.getAuthTag();
     const encryptedData = Buffer.concat([iv, ciphertext, tag]).toString("base64");
-    const publicKey = createPublicKey({
-        key: parseBase64Der(publicKeyBase64),
-        format: "der",
-        type: "spki"
-    });
+    const publicKey = parsePublicKey(publicKeyBase64);
     const encryptedKey = publicEncrypt({
         key: publicKey,
         oaepHash: "sha256",

package/dist/services/encryption.js.map

@@ -1 +1 @@
-{"version":3,"file":"encryption.js","sourceRoot":"","sources":["../../src/services/encryption.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"encryption.js","sourceRoot":"","sources":["../../src/services/encryption.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,eAAe,EAAE,aAAa,EAAE,WAAW,EAAkB,MAAM,aAAa,CAAC;AACrH,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC;;;;GAIG;AACH,SAAS,cAAc,CAAC,eAAuB;IAC7C,MAAM,GAAG,GAAG,SAAS,CAAC,eAAe,CAAC,CAAC;IACvC,IAAI,CAAC;QACH,OAAO,eAAe,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IACpE,CAAC;IAAC,MAAM,CAAC;QACP,iFAAiF;QACjF,OAAO,eAAe,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;IACrE,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CAAC,SAAiB,EAAE,eAAuB;IAC/D,IAAI,CAAC,eAAe,EAAE,CAAC;QACrB,MAAM,IAAI,eAAe,CAAC,uCAAuC,CAAC,CAAC;IACrE,CAAC;IAED,MAAM,MAAM,GAAG,WAAW,CAAC,cAAc,CAAC,CAAC;IAC3C,MAAM,EAAE,GAAG,WAAW,CAAC,aAAa,CAAC,CAAC;IACtC,MAAM,MAAM,GAAG,cAAc,CAAC,aAAa,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;IACzD,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IACrF,MAAM,GAAG,GAAG,MAAM,CAAC,UAAU,EAAE,CAAC;IAChC,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,UAAU,EAAE,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAE9E,MAAM,SAAS,GAAG,cAAc,CAAC,eAAe,CAAC,CAAC;IAElD,MAAM,YAAY,GAAG,aAAa,CAChC;QACE,GAAG,EAAE,SAAS;QACd,QAAQ,EAAE,QAAQ;QAClB,OAAO,EAAE,SAAS,CAAC,sBAAsB;KAC1C,EACD,MAAM,CACP,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAErB,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,CAAC;AACzC,CAAC;AAED;;;GAGG;AACH,MAAM,OAAO,iBAAiB;IAC5B;;;;;OAKG;IACH,0BAA0B,CAAC,WAAmB,EAAE,SAA2B;QACzE,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,IAAI,eAAe,CAAC,sCAAsC,CAAC,CAAC;QACpE,CAAC;QAED,IAAI,CAAC;YACH,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,CAAC;gBAClB,MAAM,IAAI,eAAe,CAAC,yCAAyC,CAAC,CAAC;YACvE,CAAC;YACD,MAAM,SAAS,GAAG,SAAS,CAAC,SAAS,IAAI,EAAE,CAAC;YAC5C,MAAM,EAAE,aAAa,EAAE,YAAY,EAAE,GAAG,aAAa,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;YAE9E,OAAO;gBACL,WAAW,EAAE,SAAS,CAAC,EAAE;gBACzB,SAAS;gBACT,gBAAgB,EAAE,aAAa;gBAC/B,qBAAqB,EAAE,YAAY;aACpC,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,eAAe;gBAAE,MAAM,KAAK,CAAC;YAClD,MAAM,IAAI,eAAe,CAAC,4CAA4C,SAAS,CAAC,EAAE,IAAI,SAAS,EAAE,EAAE;gBACjG,KAAK,EAAE,KAAK;aACb,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,6BAA6B,CAAC,cAAsB,EAAE,SAA2B;QAM/E,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,IAAI,eAAe,CAAC,sCAAsC,CAAC,CAAC;QACpE,CAAC;QAED,IAAI,CAAC;YACH,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,CAAC;gBAClB,MAAM,IAAI,eAAe,CAAC,yCAAyC,CAAC,CAAC;YACvE,CAAC;YACD,MAAM,SAAS,GAAG,SAAS,CAAC,SAAS,IAAI,EAAE,CAAC;YAC5C,MAAM,EAAE,aAAa,EAAE,YAAY,EAAE,GAAG,aAAa,CAAC,cAAc,EAAE,SAAS,CAAC,CAAC;YAEjF,OAAO;gBACL,WAAW,EAAE,SAAS,CAAC,EAAE;gBACzB,SAAS;gBACT,mBAAmB,EAAE,aAAa;gBAClC,qBAAqB,EAAE,YAAY;aACpC,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,eAAe;gBAAE,MAAM,KAAK,CAAC;YAClD,MAAM,IAAI,eAAe,CAAC,gDAAgD,SAAS,CAAC,EAAE,IAAI,SAAS,EAAE,EAAE;gBACrG,KAAK,EAAE,KAAK;aACb,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF"}

package/dist/services/matching.js

@@ -1,4 +1,4 @@
-import { CheqiApiError, ErrorCodes } from "../errors.js";
+import { CheqiApiError, CheqiSDKError, ErrorCodes } from "../errors.js";
 import { coalesceString } from "../utils.js";
 export class MatchingService {
     apiClient;
@@ -7,7 +7,7 @@ export class MatchingService {
     }
     async matchCustomer(identificationDetails, accessToken) {
         if (!this.hasValidIdentifiers(identificationDetails)) {
-            throw new Error("Identification details must contain at least one identifier (card details, payment account details, or email)");
+            throw new CheqiSDKError("Identification details must contain at least one identifier (card details, payment account details, or email)", { errorCode: ErrorCodes.VALIDATION_ERROR, httpStatusCode: 400 });
         }
         try {
             return await this.apiClient.matchCustomer(identificationDetails, accessToken);

package/dist/services/matching.js.map

@@ -1 +1 @@
-{"version":3,"file":"matching.js","sourceRoot":"","sources":["../../src/services/matching.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAEzD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C,MAAM,OAAO,eAAe;IACG;IAA7B,YAA6B,SAAgD;QAAhD,cAAS,GAAT,SAAS,CAAuC;IAAG,CAAC;IAEjF,KAAK,CAAC,aAAa,CACjB,qBAA4C,EAC5C,WAA2B;QAE3B,IAAI,CAAC,IAAI,CAAC,mBAAmB,CAAC,qBAAqB,CAAC,EAAE,CAAC;YACrD,MAAM,IAAI,KAAK,CAAC,+GAA+G,CAAC,CAAC;QACnI,CAAC;QAED,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,qBAAqB,EAAE,WAAW,CAAC,CAAC;QAChF,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,aAAa,EAAE,CAAC;gBACnC,MAAM,KAAK,CAAC;YACd,CAAC;YACD,MAAM,IAAI,aAAa,CAAC,6BAA6B,MAAM,CAAE,KAAe,CAAC,OAAO,CAAC,EAAE,EAAE;gBACvF,SAAS,EAAE,UAAU,CAAC,aAAa;gBACnC,KAAK,EAAE,KAAK;aACb,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAEO,mBAAmB,CAAC,qBAA+D;QACzF,IAAI,CAAC,qBAAqB,EAAE,CAAC;YAC3B,OAAO,KAAK,CAAC;QACf,CAAC;QAED,OAAO,OAAO,CACZ,cAAc,CACX,qBAAqB,CAAC,WAA6D,EAAE,oBAAoB,EAC1G,qBAAqB,CAAC,WAAW,EAAE,uBAAuB,EAC1D,qBAAqB,CAAC,qBAAqB,EAAE,UAAU,EACvD,qBAAqB,CAAC,cAAc,EACpC,qBAAqB,CAAC,cAAc,EACpC,qBAAqB,CAAC,WAAW,CAClC,CACF,CAAC;IACJ,CAAC;CACF"}
+{"version":3,"file":"matching.js","sourceRoot":"","sources":["../../src/services/matching.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAExE,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C,MAAM,OAAO,eAAe;IACG;IAA7B,YAA6B,SAAgD;QAAhD,cAAS,GAAT,SAAS,CAAuC;IAAG,CAAC;IAEjF,KAAK,CAAC,aAAa,CACjB,qBAA4C,EAC5C,WAA2B;QAE3B,IAAI,CAAC,IAAI,CAAC,mBAAmB,CAAC,qBAAqB,CAAC,EAAE,CAAC;YACrD,MAAM,IAAI,aAAa,CACrB,+GAA+G,EAC/G,EAAE,SAAS,EAAE,UAAU,CAAC,gBAAgB,EAAE,cAAc,EAAE,GAAG,EAAE,CAChE,CAAC;QACJ,CAAC;QAED,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,qBAAqB,EAAE,WAAW,CAAC,CAAC;QAChF,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,aAAa,EAAE,CAAC;gBACnC,MAAM,KAAK,CAAC;YACd,CAAC;YACD,MAAM,IAAI,aAAa,CAAC,6BAA6B,MAAM,CAAE,KAAe,CAAC,OAAO,CAAC,EAAE,EAAE;gBACvF,SAAS,EAAE,UAAU,CAAC,aAAa;gBACnC,KAAK,EAAE,KAAK;aACb,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAEO,mBAAmB,CAAC,qBAA+D;QACzF,IAAI,CAAC,qBAAqB,EAAE,CAAC;YAC3B,OAAO,KAAK,CAAC;QACf,CAAC;QAED,OAAO,OAAO,CACZ,cAAc,CACX,qBAAqB,CAAC,WAA6D,EAAE,oBAAoB,EAC1G,qBAAqB,CAAC,WAAW,EAAE,uBAAuB,EAC1D,qBAAqB,CAAC,qBAAqB,EAAE,UAAU,EACvD,qBAAqB,CAAC,cAAc,EACpC,qBAAqB,CAAC,cAAc,EACpC,qBAAqB,CAAC,WAAW,CAClC,CACF,CAAC;IACJ,CAAC;CACF"}

package/dist/services/receipt-processor.d.ts

@@ -0,0 +1,27 @@
+import type { DecryptedReceipt, EncryptedReceipt } from "../types.js";
+import { DecryptionService } from "./decryption.js";
+/**
+ * Decrypts an encrypted receipt and merges the receipt context (receiving party
+ * and payment means) into both the UBL XML and CheqiReceipt formats.
+ *
+ * Mirrors the Java SDK `ReceiptProcessor` + `ReceiptMergeService`:
+ *  - UBL XML: the `<cac:AccountingCustomerParty/>` placeholder is replaced with
+ *    the `xmlReceivingParty` fragment.
+ *  - UBL XML: `xmlPaymentMeans` is injected immediately after the
+ *    AccountingCustomerParty element when present.
+ *  - CheqiReceipt: the `receivingParty` is injected from the receipt context.
+ */
+export declare class ReceiptProcessor {
+    private readonly decryptionService;
+    constructor(decryptionService: DecryptionService);
+    /**
+     * Decrypt an encrypted receipt and return a fully merged {@link DecryptedReceipt}.
+     * @param encryptedReceipt  The encrypted receipt payload.
+     * @param privateKey        Base64-encoded PKCS#8 DER private key.
+     */
+    processEncryptedReceipt(encryptedReceipt: EncryptedReceipt, privateKey: string): DecryptedReceipt;
+    private merge;
+    private mergeXmlParty;
+    private mergeXmlPaymentMeans;
+    private mergeReceivingParty;
+}

package/dist/services/receipt-processor.js

@@ -0,0 +1,111 @@
+import { DecryptionError } from "../errors.js";
+import { ReceiptContextEnvelopeFromJSON } from "../models/generated/ReceiptContextEnvelope.js";
+import { ReceiptEnvelopeFromJSON } from "../models/generated/ReceiptEnvelope.js";
+const CUSTOMER_PARTY_PLACEHOLDER = "<cac:AccountingCustomerParty/>";
+const CUSTOMER_PARTY_CLOSING_TAG = "</cac:AccountingCustomerParty>";
+/**
+ * Decrypts an encrypted receipt and merges the receipt context (receiving party
+ * and payment means) into both the UBL XML and CheqiReceipt formats.
+ *
+ * Mirrors the Java SDK `ReceiptProcessor` + `ReceiptMergeService`:
+ *  - UBL XML: the `<cac:AccountingCustomerParty/>` placeholder is replaced with
+ *    the `xmlReceivingParty` fragment.
+ *  - UBL XML: `xmlPaymentMeans` is injected immediately after the
+ *    AccountingCustomerParty element when present.
+ *  - CheqiReceipt: the `receivingParty` is injected from the receipt context.
+ */
+export class ReceiptProcessor {
+    decryptionService;
+    constructor(decryptionService) {
+        this.decryptionService = decryptionService;
+    }
+    /**
+     * Decrypt an encrypted receipt and return a fully merged {@link DecryptedReceipt}.
+     * @param encryptedReceipt  The encrypted receipt payload.
+     * @param privateKey        Base64-encoded PKCS#8 DER private key.
+     */
+    processEncryptedReceipt(encryptedReceipt, privateKey) {
+        const { receiptContent, customerDetails } = this.decryptionService.decryptReceipt(encryptedReceipt, privateKey);
+        let receiptEnvelope;
+        try {
+            receiptEnvelope = ReceiptEnvelopeFromJSON(JSON.parse(receiptContent));
+        }
+        catch (error) {
+            throw new DecryptionError("Failed to deserialize decrypted receipt envelope", { cause: error });
+        }
+        let receiptContextEnvelope = null;
+        if (customerDetails && customerDetails.trim() !== "") {
+            try {
+                receiptContextEnvelope = ReceiptContextEnvelopeFromJSON(JSON.parse(customerDetails));
+            }
+            catch (error) {
+                throw new DecryptionError("Failed to deserialize decrypted receipt context envelope", { cause: error });
+            }
+        }
+        const decrypted = {
+            receiptEnvelope,
+            receiptContextEnvelope,
+            rawReceiptJson: receiptContent,
+            rawReceiptContextJson: customerDetails
+        };
+        this.merge(decrypted);
+        return decrypted;
+    }
+    merge(decrypted) {
+        const context = decrypted.receiptContextEnvelope;
+        if (!context) {
+            return;
+        }
+        this.mergeXmlParty(decrypted.receiptEnvelope, context);
+        this.mergeXmlPaymentMeans(decrypted.receiptEnvelope, context);
+        this.mergeReceivingParty(decrypted.receiptEnvelope, context);
+    }
+    mergeXmlParty(receiptEnvelope, context) {
+        const xmlReceivingParty = context.receivingParty?.xmlReceivingParty;
+        if (!xmlReceivingParty) {
+            return;
+        }
+        receiptEnvelope.ublPurchaseReceipt = mergeXmlPayload(receiptEnvelope.ublPurchaseReceipt, xmlReceivingParty);
+        receiptEnvelope.ublInvoice = mergeXmlPayload(receiptEnvelope.ublInvoice, xmlReceivingParty);
+    }
+    mergeXmlPaymentMeans(receiptEnvelope, context) {
+        const xmlPaymentMeans = context.paymentMeans?.xmlPaymentMeans;
+        if (!xmlPaymentMeans) {
+            return;
+        }
+        receiptEnvelope.ublPurchaseReceipt = injectPaymentMeans(receiptEnvelope.ublPurchaseReceipt, xmlPaymentMeans);
+        receiptEnvelope.ublInvoice = injectPaymentMeans(receiptEnvelope.ublInvoice, xmlPaymentMeans);
+    }
+    mergeReceivingParty(receiptEnvelope, context) {
+        const receivingParty = context.receivingParty?.receivingParty;
+        if (!receivingParty || !receiptEnvelope.cheqi) {
+            return;
+        }
+        receiptEnvelope.cheqi = {
+            ...receiptEnvelope.cheqi,
+            receivingParty
+        };
+    }
+}
+function mergeXmlPayload(xml, xmlReceivingParty) {
+    if (xml == null) {
+        return xml;
+    }
+    if (!xml.includes(CUSTOMER_PARTY_PLACEHOLDER)) {
+        return xml;
+    }
+    return xml.replace(CUSTOMER_PARTY_PLACEHOLDER, xmlReceivingParty);
+}
+function injectPaymentMeans(xml, xmlPaymentMeans) {
+    if (xml == null) {
+        return xml;
+    }
+    if (xml.includes(CUSTOMER_PARTY_CLOSING_TAG)) {
+        return xml.replace(CUSTOMER_PARTY_CLOSING_TAG, CUSTOMER_PARTY_CLOSING_TAG + xmlPaymentMeans);
+    }
+    if (xml.includes(CUSTOMER_PARTY_PLACEHOLDER)) {
+        return xml.replace(CUSTOMER_PARTY_PLACEHOLDER, CUSTOMER_PARTY_PLACEHOLDER + xmlPaymentMeans);
+    }
+    return xml;
+}
+//# sourceMappingURL=receipt-processor.js.map

package/dist/services/receipt-processor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"receipt-processor.js","sourceRoot":"","sources":["../../src/services/receipt-processor.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -4,22 +4,62 @@ export type JsonValue = JsonPrimitive | JsonObject | JsonValue[];
 export interface JsonObject {
     [key: string]: JsonValue | undefined;
 }
-export type { AddressDTO, BarcodeType, BuyerType, CardDetails, CreditNoteContextEnvelope, Charge, CheqiCreditNote, CheqiReceipt, CreateStoreRequest, CreditNoteTemplateGenerationRequest, CreditNoteTemplateRequest, CreditNoteTemplateResponse, Discount, EncryptedCreditNote, EncryptedCreditNoteInitiationRequest, EncryptedReceiptRequest, EncryptedReceiptsRequest, IdentificationDetails, Identifier, MatchedRecipient, NotificationDisplayCode, PaymentAccountDetails, Period, Product, ReceiptCreatedResponse, ReceiptEnvelope, ReceiptFormat, ReceiptTemplateGenerationRequest, ReceiptTemplateRequest, ReceiptTemplateResponse, RecipientResolutionResponse, SellingParty, ReceivingParty, StoreDTO, Tax, VatMetadata, } from "./models/generated/index.js";
+export type { AddressDTO, BarcodeType, BuyerType, CardDetails, CreditNoteContextEnvelope, ReceiptContextEnvelope, Charge, CheqiCreditNote, CheqiReceipt, CreateStoreRequest, CreditNoteTemplateGenerationRequest, CreditNoteTemplateRequest, CreditNoteTemplateResponse, Discount, EncryptedCreditNote, EncryptedCreditNoteInitiationRequest, EncryptedReceiptRequest, EncryptedReceiptsRequest, IdentificationDetails, Identifier, MatchedRecipient, NotificationDisplayCode, PaymentAccountDetails, Period, Product, ReceiptCreatedResponse, ReceiptEnvelope, ReceiptFormat, ReceiptTemplateGenerationRequest, ReceiptTemplateRequest, ReceiptTemplateResponse, RecipientResolutionResponse, SellingParty, ReceivingParty, StoreDTO, Tax, VatMetadata, } from "./models/generated/index.js";
 export type CompanyDTO = import("./models/generated/index.js").CompanyCreationRequest;
 export type IdentificationDetailsPaymentTypeEnum = import("./models/generated/index.js").PaymentType;
 export type ProvisionCompanyRequest = import("./models/generated/index.js").CreateChildCompanyRequest;
 export type ProvisionCompanyResponse = import("./models/generated/index.js").CompanyResponseBody;
-export type ReceiverType = import("./models/generated/index.js").EncryptedReceiptDtoReceiverTypeEnum;
+export type ReceiverType = import("./models/generated/index.js").ReceiverType;
 export interface CreditNoteEnvelope {
     cheqiCreditNote?: import("./models/generated/index.js").CheqiCreditNote;
     ublCreditNote?: string;
 }
+/** Condition of a returned line item. Mirrors the Java SDK `ReturnCondition`. */
+export type ReturnCondition = "DEFECTIVE" | "DAMAGED" | "WRONG_ITEM" | "NOT_AS_DESCRIBED" | "UNWANTED" | "EXPIRED" | "INCOMPLETE";
+/** Refund preference for a customer-initiated return. Mirrors the Java SDK `RefundPreference`. */
+export type RefundPreference = "ORIGINAL_PAYMENT_METHOD" | "BANK_TRANSFER" | "STORE_CREDIT";
+/** Bank account details for a bank-transfer refund. Mirrors the Java SDK `RefundBankAccount`. */
+export interface RefundBankAccount {
+    iban?: string;
+    bic?: string;
+    accountHolder?: string;
+}
+/** A single returned line item. Mirrors the Java SDK `ReturnLineItem`. */
+export interface ReturnLineItem {
+    lineItemId?: string;
+    quantityReturned?: number;
+    condition?: ReturnCondition;
+    conditionNotes?: string;
+}
+/**
+ * A decrypted customer-initiated credit-note (return) request.
+ * Mirrors the Java SDK `CreditNoteInitiationRequest`.
+ */
+export interface CreditNoteInitiationRequest {
+    cheqiReceiptId?: string;
+    receiptId?: string;
+    returnReason?: string;
+    returnReasonDescription?: string;
+    lineItems?: ReturnLineItem[];
+    refundPreference?: RefundPreference;
+    refundBankAccount?: RefundBankAccount;
+}
 export interface DecryptedDeliveredCreditNote {
     creditNoteEnvelope: CreditNoteEnvelope;
     creditNoteContextEnvelope: import("./models/generated/index.js").CreditNoteContextEnvelope | null;
     rawJson: string;
     rawCreditNoteContextJson: string | null;
 }
+/**
+ * A decrypted receipt with its context merged into both receipt formats.
+ * Mirrors the Java SDK `DecryptedReceipt` returned by `ReceiptProcessor`.
+ */
+export interface DecryptedReceipt {
+    receiptEnvelope: import("./models/generated/index.js").ReceiptEnvelope;
+    receiptContextEnvelope: import("./models/generated/index.js").ReceiptContextEnvelope | null;
+    rawReceiptJson: string;
+    rawReceiptContextJson: string | null;
+}
 export interface EncryptedReceipt {
     recipientId?: string;
     receiptId?: string;

package/dist/utils.d.ts

@@ -7,5 +7,18 @@ export declare function sha256Hex(value: string): string;
 export declare function toCamelCase(value: string): string;
 export declare function normalizeValue<T>(value: T): unknown;
 export declare function serializeJson<T>(value: T): string;
+/**
+ * Decode a key string into raw DER bytes.
+ *
+ * Accepts:
+ *  - raw base64-encoded DER (the common case),
+ *  - PEM-wrapped keys (`-----BEGIN ... KEY-----`), and
+ *  - base64-encoded PEM (a PEM document that was itself base64-encoded).
+ *
+ * Mirrors the Java SDK `PemUtils.decodeKey` so both PEM-wrapped and raw base64
+ * keys are accepted interchangeably.
+ */
+export declare function decodeKey(keyString: string): Buffer;
+/** @deprecated Use {@link decodeKey}, which also handles PEM-wrapped keys. */
 export declare function parseBase64Der(base64: string): Buffer;
 export declare function sleep(ms: number): Promise<void>;

package/dist/utils.js

@@ -45,8 +45,39 @@ export function normalizeValue(value) {
 export function serializeJson(value) {
     return JSON.stringify(normalizeValue(value));
 }
+/**
+ * Decode a key string into raw DER bytes.
+ *
+ * Accepts:
+ *  - raw base64-encoded DER (the common case),
+ *  - PEM-wrapped keys (`-----BEGIN ... KEY-----`), and
+ *  - base64-encoded PEM (a PEM document that was itself base64-encoded).
+ *
+ * Mirrors the Java SDK `PemUtils.decodeKey` so both PEM-wrapped and raw base64
+ * keys are accepted interchangeably.
+ */
+export function decodeKey(keyString) {
+    // If the input doesn't contain PEM headers, it may be base64-encoded PEM.
+    if (!keyString.includes("-----BEGIN")) {
+        try {
+            const decoded = Buffer.from(keyString.replace(/\s+/g, ""), "base64").toString("latin1");
+            if (decoded.includes("-----BEGIN")) {
+                return decodeKey(decoded);
+            }
+        }
+        catch {
+            // Not base64-encoded PEM — fall through to plain base64 handling.
+        }
+    }
+    const cleanKey = keyString
+        .replace(/-+BEGIN [A-Z ]+KEY-+/g, "")
+        .replace(/-+END [A-Z ]+KEY-+/g, "")
+        .replace(/\s+/g, "");
+    return Buffer.from(cleanKey, "base64");
+}
+/** @deprecated Use {@link decodeKey}, which also handles PEM-wrapped keys. */
 export function parseBase64Der(base64) {
-    return Buffer.from(base64, "base64");
+    return decodeKey(base64);
 }
 export function sleep(ms) {
     return new Promise((resolve) => setTimeout(resolve, ms));

package/dist/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,GAAG,MAAiB;IACjD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,gBAAgB,CAAC,KAAK,CAAC,EAAE,CAAC;YAC5B,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,OAAO,4BAA4B,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,KAAa;IACrC,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAClE,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,OAAO,KAAK,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC,EAAE,SAAiB,EAAE,EAAE,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC,CAAC;AAC1F,CAAC;AAED,MAAM,UAAU,cAAc,CAAI,KAAQ;IACxC,IAAI,KAAK,YAAY,IAAI,EAAE,CAAC;QAC1B,OAAO,KAAK,CAAC,WAAW,EAAE,CAAC;IAC7B,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC;IACrD,CAAC;IACD,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACrB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,UAAU,GAA4B,EAAE,CAAC;IAC/C,KAAK,MAAM,CAAC,GAAG,EAAE,UAAU,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACtD,IAAI,UAAU,KAAK,SAAS,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;YACpD,SAAS;QACX,CAAC;QACD,UAAU,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,GAAG,cAAc,CAAC,UAAU,CAAC,CAAC;IAC5D,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,aAAa,CAAI,KAAQ;IACvC,OAAO,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,MAAc;IAC3C,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,EAAU;IAC9B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC"}
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"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"}

package/dist/xml.d.ts

@@ -1,2 +1,8 @@
+/**
+ * Canonicalizes an XML string using Exclusive XML Canonicalization 1.0 (comments omitted).
+ *
+ * @throws if `xml` is null/empty or cannot be parsed.
+ */
 export declare function canonicalizeXml(xml: string): string;
+/** Canonicalize XML and return its SHA-256 hash as a lowercase hex string. */
 export declare function canonicalizeAndHashXml(xml: string): string;

package/dist/xml.js

@@ -1,10 +1,162 @@
+import { DOMParser } from "@xmldom/xmldom";
 import { sha256Hex } from "./utils.js";
-function stripFormattingWhitespace(xml) {
-    return xml.replace(/>\s+</g, "><").trim();
+/**
+ * XML Exclusive Canonicalization (C14N) 1.0 — W3C `xml-exc-c14n#`, comments omitted.
+ *
+ * Produces byte-for-byte deterministic output matching:
+ *  - iOS: libxml2 `xmlC14NDocDumpMemory` with `XML_C14N_EXCLUSIVE_1_0`
+ *  - Java backend: Apache Santuario `Canonicalizer.ALGO_ID_C14N_EXCL_OMIT_COMMENTS`
+ *  - Cheqi Java SDK: `XMLCanonicalService` (javax.xml.crypto.dsig EXCLUSIVE)
+ *
+ * Mirrors the Java SDK behaviour of stripping whitespace-only text nodes before
+ * canonicalizing so formatting differences do not affect the resulting hash.
+ */
+const XMLNS_NS = "http://www.w3.org/2000/xmlns/";
+const ELEMENT_NODE = 1;
+const TEXT_NODE = 3;
+const CDATA_SECTION_NODE = 4;
+const PROCESSING_INSTRUCTION_NODE = 7;
+const DOCUMENT_NODE = 9;
+function escapeText(value) {
+    return value
+        .replace(/&/g, "&amp;")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;")
+        .replace(/\r/g, "&#xD;");
 }
+function escapeAttr(value) {
+    return value
+        .replace(/&/g, "&amp;")
+        .replace(/</g, "&lt;")
+        .replace(/"/g, "&quot;")
+        .replace(/\t/g, "&#x9;")
+        .replace(/\n/g, "&#xA;")
+        .replace(/\r/g, "&#xD;");
+}
+function isWhitespaceOnly(value) {
+    return value.trim() === "";
+}
+function compare(a, b) {
+    return a < b ? -1 : a > b ? 1 : 0;
+}
+function serializeElement(el, ancestorNamespaces, out) {
+    // Copy of the namespace declarations visible to children (output-ancestor context).
+    const rendered = new Map(ancestorNamespaces);
+    // Collect "visibly utilized" namespaces (element prefix + prefixed attributes).
+    const utilized = new Map();
+    utilized.set(el.prefix ?? "", el.namespaceURI ?? "");
+    const regularAttrs = [];
+    if (el.attributes) {
+        for (let i = 0; i < el.attributes.length; i++) {
+            const attr = el.attributes.item(i);
+            // Skip namespace declaration attributes — these are reconstructed from namespaceURI.
+            if (attr.nodeName === "xmlns" || attr.prefix === "xmlns" || attr.namespaceURI === XMLNS_NS) {
+                continue;
+            }
+            regularAttrs.push(attr);
+            if (attr.prefix) {
+                utilized.set(attr.prefix, attr.namespaceURI ?? "");
+            }
+        }
+    }
+    // Decide which namespace declarations must be emitted on this element.
+    const nsToRender = [];
+    for (const [prefix, value] of utilized) {
+        if (prefix === "") {
+            if (value !== "") {
+                if (rendered.get("") !== value) {
+                    nsToRender.push(["", value]);
+                    rendered.set("", value);
+                }
+            }
+            else {
+                // Element is in no namespace — only emit xmlns="" to undeclare an inherited default.
+                const current = rendered.get("");
+                if (current !== undefined && current !== "") {
+                    nsToRender.push(["", ""]);
+                    rendered.set("", "");
+                }
+            }
+        }
+        else if (rendered.get(prefix) !== value) {
+            nsToRender.push([prefix, value]);
+            rendered.set(prefix, value);
+        }
+    }
+    // Namespace declarations sorted by prefix (default namespace first).
+    nsToRender.sort((a, b) => compare(a[0], b[0]));
+    // Attributes sorted by namespace URI (empty first) then local name.
+    regularAttrs.sort((a, b) => {
+        const uriCmp = compare(a.namespaceURI ?? "", b.namespaceURI ?? "");
+        if (uriCmp !== 0) {
+            return uriCmp;
+        }
+        return compare(a.localName ?? a.nodeName, b.localName ?? b.nodeName);
+    });
+    const qname = el.nodeName;
+    out.push("<", qname);
+    for (const [prefix, value] of nsToRender) {
+        out.push(prefix === "" ? ` xmlns="${escapeAttr(value)}"` : ` xmlns:${prefix}="${escapeAttr(value)}"`);
+    }
+    for (const attr of regularAttrs) {
+        out.push(` ${attr.nodeName}="${escapeAttr(attr.value ?? "")}"`);
+    }
+    out.push(">");
+    serializeChildren(el, rendered, out);
+    out.push("</", qname, ">");
+}
+function serializeChildren(node, rendered, out) {
+    const children = node.childNodes;
+    if (!children) {
+        return;
+    }
+    for (let i = 0; i < children.length; i++) {
+        serializeNode(children.item(i), rendered, out);
+    }
+}
+function serializeNode(node, rendered, out) {
+    switch (node.nodeType) {
+        case ELEMENT_NODE:
+            serializeElement(node, rendered, out);
+            break;
+        case TEXT_NODE:
+        case CDATA_SECTION_NODE: {
+            const text = node.nodeValue ?? "";
+            // Mirror the Java SDK: whitespace-only (formatting) text nodes are dropped.
+            if (!isWhitespaceOnly(text)) {
+                out.push(escapeText(text));
+            }
+            break;
+        }
+        case PROCESSING_INSTRUCTION_NODE: {
+            const data = node.data ?? "";
+            out.push(data ? `<?${node.target} ${data}?>` : `<?${node.target}?>`);
+            break;
+        }
+        // Comments are omitted (exc-c14n#, OMIT_COMMENTS).
+        default:
+            break;
+    }
+}
+/**
+ * Canonicalizes an XML string using Exclusive XML Canonicalization 1.0 (comments omitted).
+ *
+ * @throws if `xml` is null/empty or cannot be parsed.
+ */
 export function canonicalizeXml(xml) {
-    return stripFormattingWhitespace(xml);
+    if (xml == null || xml.trim() === "") {
+        throw new Error("XML string cannot be null or empty");
+    }
+    const doc = new DOMParser().parseFromString(xml, "text/xml");
+    const root = doc.nodeType === DOCUMENT_NODE ? doc.documentElement ?? null : doc;
+    if (!root) {
+        throw new Error("XML Exclusive C14N canonicalization failed: no document element");
+    }
+    const out = [];
+    serializeNode(root, new Map(), out);
+    return out.join("");
 }
+/** Canonicalize XML and return its SHA-256 hash as a lowercase hex string. */
 export function canonicalizeAndHashXml(xml) {
     return sha256Hex(canonicalizeXml(xml));
 }

package/dist/xml.js.map

@@ -1 +1 @@
-{"version":3,"file":"xml.js","sourceRoot":"","sources":["../src/xml.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEvC,SAAS,yBAAyB,CAAC,GAAW;IAC5C,OAAO,GAAG,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,OAAO,yBAAyB,CAAC,GAAG,CAAC,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,GAAW;IAChD,OAAO,SAAS,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC;AACzC,CAAC"}
+{"version":3,"file":"xml.js","sourceRoot":"","sources":["../src/xml.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cheqi/sdk",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "Cheqi TypeScript SDK for encrypted receipt and credit note processing",
   "license": "MIT",
   "author": "Cheqi",
@@ -52,5 +52,8 @@
   "devDependencies": {
     "@types/node": "^25.5.0",
     "typescript": "^5.9.3"
+  },
+  "dependencies": {
+    "@xmldom/xmldom": "^0.9.10"
   }
 }