@cheqi/sdk 0.1.1

package/dist/services/encryption.d.ts

@@ -0,0 +1,25 @@
+import type { EncryptedReceiptRequest, MatchedRecipient } from "../types.js";
+/**
+ * Performs hybrid RSA-OAEP + AES-256-GCM encryption of receipts and credit
+ * notes for individual recipients.
+ */
+export declare class EncryptionService {
+    /**
+     * Encrypt a receipt JSON payload for a single recipient.
+     * @param receiptJson   Serialised receipt envelope (JSON string).
+     * @param recipient     Matched recipient with a public key.
+     * @returns An {@link EncryptedReceiptRequest} ready to be sent to the API.
+     */
+    encryptReceiptForRecipient(receiptJson: string, recipient: MatchedRecipient): EncryptedReceiptRequest;
+    /**
+     * Encrypt a credit-note JSON payload for a single recipient.
+     * @param creditNoteJson  Serialised credit-note envelope (JSON string).
+     * @param recipient       Matched recipient with a public key.
+     */
+    encryptCreditNoteForRecipient(creditNoteJson: string, recipient: MatchedRecipient): {
+        recipientId?: string;
+        publicKey: string;
+        encryptedCreditNote: string;
+        encryptedSymmetricKey: string;
+    };
+}

package/dist/services/encryption.js

@@ -0,0 +1,94 @@
+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";
+function hybridEncrypt(plaintext, publicKeyBase64) {
+    if (!publicKeyBase64) {
+        throw new EncryptionError("Public key is required for encryption");
+    }
+    const aesKey = randomBytes(AES_KEY_LENGTH);
+    const iv = randomBytes(GCM_IV_LENGTH);
+    const cipher = createCipheriv("aes-256-gcm", aesKey, iv);
+    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 encryptedKey = publicEncrypt({
+        key: publicKey,
+        oaepHash: "sha256",
+        padding: constants.RSA_PKCS1_OAEP_PADDING
+    }, aesKey).toString("base64");
+    return { encryptedData, encryptedKey };
+}
+/**
+ * Performs hybrid RSA-OAEP + AES-256-GCM encryption of receipts and credit
+ * notes for individual recipients.
+ */
+export class EncryptionService {
+    /**
+     * Encrypt a receipt JSON payload for a single recipient.
+     * @param receiptJson   Serialised receipt envelope (JSON string).
+     * @param recipient     Matched recipient with a public key.
+     * @returns An {@link EncryptedReceiptRequest} ready to be sent to the API.
+     */
+    encryptReceiptForRecipient(receiptJson, recipient) {
+        if (!recipient) {
+            throw new EncryptionError("Recipient is required for encryption");
+        }
+        try {
+            if (!recipient.id) {
+                throw new EncryptionError("Recipient ID is required for encryption");
+            }
+            const publicKey = recipient.publicKey ?? "";
+            const { encryptedData, encryptedKey } = hybridEncrypt(receiptJson, publicKey);
+            return {
+                recipientId: recipient.id,
+                publicKey,
+                encryptedReceipt: encryptedData,
+                encryptedSymmetricKey: encryptedKey
+            };
+        }
+        catch (error) {
+            if (error instanceof EncryptionError)
+                throw error;
+            throw new EncryptionError(`Failed to encrypt receipt for recipient: ${recipient.id ?? "unknown"}`, {
+                cause: error
+            });
+        }
+    }
+    /**
+     * Encrypt a credit-note JSON payload for a single recipient.
+     * @param creditNoteJson  Serialised credit-note envelope (JSON string).
+     * @param recipient       Matched recipient with a public key.
+     */
+    encryptCreditNoteForRecipient(creditNoteJson, recipient) {
+        if (!recipient) {
+            throw new EncryptionError("Recipient is required for encryption");
+        }
+        try {
+            if (!recipient.id) {
+                throw new EncryptionError("Recipient ID is required for encryption");
+            }
+            const publicKey = recipient.publicKey ?? "";
+            const { encryptedData, encryptedKey } = hybridEncrypt(creditNoteJson, publicKey);
+            return {
+                recipientId: recipient.id,
+                publicKey,
+                encryptedCreditNote: encryptedData,
+                encryptedSymmetricKey: encryptedKey
+            };
+        }
+        catch (error) {
+            if (error instanceof EncryptionError)
+                throw error;
+            throw new EncryptionError(`Failed to encrypt credit note for recipient: ${recipient.id ?? "unknown"}`, {
+                cause: error
+            });
+        }
+    }
+}
+//# sourceMappingURL=encryption.js.map

package/dist/services/encryption.js.map

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

package/dist/services/matching.d.ts

@@ -0,0 +1,7 @@
+import type { CheqiApiClient, IdentificationDetails, RecipientResolutionResponse } from "../types.js";
+export declare class MatchingService {
+    private readonly apiClient;
+    constructor(apiClient: Pick<CheqiApiClient, "matchCustomer">);
+    matchCustomer(identificationDetails: IdentificationDetails, accessToken?: string | null): Promise<RecipientResolutionResponse>;
+    private hasValidIdentifiers;
+}

package/dist/services/matching.js

@@ -0,0 +1,32 @@
+import { CheqiApiError, ErrorCodes } from "../errors.js";
+import { coalesceString } from "../utils.js";
+export class MatchingService {
+    apiClient;
+    constructor(apiClient) {
+        this.apiClient = apiClient;
+    }
+    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)");
+        }
+        try {
+            return await this.apiClient.matchCustomer(identificationDetails, accessToken);
+        }
+        catch (error) {
+            if (error instanceof CheqiApiError) {
+                throw error;
+            }
+            throw new CheqiApiError(`Customer matching failed: ${String(error.message)}`, {
+                errorCode: ErrorCodes.UNKNOWN_ERROR,
+                cause: error
+            });
+        }
+    }
+    hasValidIdentifiers(identificationDetails) {
+        if (!identificationDetails) {
+            return false;
+        }
+        return Boolean(coalesceString(identificationDetails.cardDetails?.paymentAccountNumber, identificationDetails.cardDetails?.paymentAccountReference, identificationDetails.paymentAccountDetails?.identifier, identificationDetails.recipientEmail, identificationDetails.cheqiReceiptId, identificationDetails.pairingCode));
+    }
+}
+//# sourceMappingURL=matching.js.map

package/dist/services/matching.js.map

@@ -0,0 +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"}

package/dist/services/receipt.d.ts

@@ -0,0 +1,17 @@
+import { ReceiptResult } from "../models.js";
+import type { CheqiApiClient, EncryptedReceiptRequest, IdentificationDetails, MatchedRecipient, NotificationDisplayCode, ReceiptTemplateGenerationRequest, ReceiptTemplateRequest, ReceiptTemplateResponse, RecipientResolutionResponse } from "../types.js";
+import { EncryptionService } from "./encryption.js";
+import { MatchingService } from "./matching.js";
+export declare class ReceiptService {
+    private readonly apiClient;
+    private readonly encryptionService;
+    private readonly matchingService;
+    constructor(apiClient: Pick<CheqiApiClient, "generateReceiptTemplate" | "sendEncryptedReceipts" | "sendReceiptViaEmail">, encryptionService: EncryptionService, matchingService: MatchingService);
+    processCompleteReceipt(identificationDetails: IdentificationDetails, receiptRequest: ReceiptTemplateRequest, accessToken?: string | null, notificationDisplayCode?: NotificationDisplayCode | null): Promise<ReceiptResult>;
+    generateReceiptTemplate(request: ReceiptTemplateGenerationRequest, accessToken?: string | null): Promise<ReceiptTemplateResponse>;
+    createEncryptedReceipts(purchaseReceipt: string, recipient: MatchedRecipient, notificationDisplayCode?: NotificationDisplayCode | null): EncryptedReceiptRequest;
+    sendEncryptedReceipts(encryptedReceipts: EncryptedReceiptRequest[], templateHash: string, matchResponse: RecipientResolutionResponse, accessToken?: string | null): Promise<Record<string, unknown>>;
+    sendReceiptViaEmail(customerEmail: string, cheqiReceipt: Record<string, unknown>, accessToken?: string | null): Promise<ReceiptResult>;
+    private buildEncryptedReceipts;
+    private validateProcessInputs;
+}

package/dist/services/receipt.js

@@ -0,0 +1,186 @@
+import { CheqiSDKError, ErrorCodes, ReceiptProcessingError } from "../errors.js";
+import { ReceiptResult } from "../models.js";
+import { isValidEmail, serializeJson, sha256Hex } from "../utils.js";
+function uniqueFormats(recipients = []) {
+    const seen = new Set();
+    const formats = [];
+    for (const recipient of recipients) {
+        for (const format of recipient.acceptedFormats ?? []) {
+            if (!seen.has(format)) {
+                seen.add(format);
+                formats.push(format);
+            }
+        }
+    }
+    return formats;
+}
+function routeFound(matchResponse) {
+    return Boolean(matchResponse.routeFound ?? matchResponse.customerFound);
+}
+function matchedRecipients(matchResponse) {
+    return matchResponse.recipients ?? matchResponse.matchedRecipients ?? [];
+}
+export class ReceiptService {
+    apiClient;
+    encryptionService;
+    matchingService;
+    constructor(apiClient, encryptionService, matchingService) {
+        this.apiClient = apiClient;
+        this.encryptionService = encryptionService;
+        this.matchingService = matchingService;
+    }
+    async processCompleteReceipt(identificationDetails, receiptRequest, accessToken = null, notificationDisplayCode = null) {
+        this.validateProcessInputs(identificationDetails, receiptRequest);
+        try {
+            const matchResponse = await this.matchingService.matchCustomer(identificationDetails, accessToken);
+            const recipientEmail = identificationDetails.recipientEmail;
+            if (!routeFound(matchResponse) && !recipientEmail) {
+                return ReceiptResult.customerNotFound();
+            }
+            const templateGenerationRequest = {
+                receiptTemplateRequest: enrichWithVatContext(receiptRequest, matchResponse),
+                formats: uniqueFormats(matchedRecipients(matchResponse)),
+                buyerCountryCode: getRequestBuyerCountryCode(receiptRequest) ?? matchResponse.buyerCountryCode,
+                buyerType: getRequestBuyerType(receiptRequest) ?? matchResponse.buyerType,
+                taxesApplied: resolveTaxesApplied(receiptRequest)
+            };
+            const templateResponse = await this.generateReceiptTemplate(templateGenerationRequest, accessToken);
+            if (routeFound(matchResponse)) {
+                const encryptedReceipts = this.buildEncryptedReceipts(matchResponse, templateResponse, notificationDisplayCode);
+                const templateContent = templateResponse.cheqi
+                    ? serializeJson(templateResponse.cheqi)
+                    : (templateResponse.ublPurchaseReceipt ?? "");
+                const templateHash = sha256Hex(templateContent);
+                const createdResponse = await this.sendEncryptedReceipts(encryptedReceipts, templateHash, matchResponse, accessToken);
+                return ReceiptResult.deliveredToApp(createdResponse, templateContent);
+            }
+            return this.sendReceiptViaEmail(recipientEmail ?? "", (templateResponse.cheqi ?? {}), accessToken);
+        }
+        catch (error) {
+            if (error instanceof CheqiSDKError) {
+                throw error;
+            }
+            throw new ReceiptProcessingError(`Receipt processing failed: ${String(error.message)}`, {
+                cause: error
+            });
+        }
+    }
+    generateReceiptTemplate(request, accessToken = null) {
+        if (!request) {
+            throw new CheqiSDKError("Receipt template request cannot be null", {
+                errorCode: ErrorCodes.VALIDATION_ERROR,
+                httpStatusCode: 400
+            });
+        }
+        return this.apiClient.generateReceiptTemplate(request, accessToken);
+    }
+    createEncryptedReceipts(purchaseReceipt, recipient, notificationDisplayCode = null) {
+        if (!purchaseReceipt.trim()) {
+            throw new CheqiSDKError("Purchase receipt cannot be null or empty", {
+                errorCode: ErrorCodes.VALIDATION_ERROR,
+                httpStatusCode: 400
+            });
+        }
+        if (!recipient) {
+            throw new CheqiSDKError("Recipient cannot be null", {
+                errorCode: ErrorCodes.VALIDATION_ERROR,
+                httpStatusCode: 400
+            });
+        }
+        return {
+            ...this.encryptionService.encryptReceiptForRecipient(purchaseReceipt, recipient),
+            notificationDisplayCode: notificationDisplayCode ?? undefined
+        };
+    }
+    sendEncryptedReceipts(encryptedReceipts, templateHash, matchResponse, accessToken = null) {
+        if (encryptedReceipts.length === 0) {
+            throw new CheqiSDKError("Encrypted receipts cannot be null or empty", {
+                errorCode: ErrorCodes.VALIDATION_ERROR,
+                httpStatusCode: 400
+            });
+        }
+        if (!templateHash.trim()) {
+            throw new CheqiSDKError("Template hash cannot be null or empty", {
+                errorCode: ErrorCodes.VALIDATION_ERROR,
+                httpStatusCode: 400
+            });
+        }
+        if (!routeFound(matchResponse) || !matchResponse.matchId) {
+            throw new CheqiSDKError("Cannot send receipts: customer was not found during matching", {
+                errorCode: ErrorCodes.CUSTOMER_NOT_FOUND,
+                httpStatusCode: 400
+            });
+        }
+        return this.apiClient.sendEncryptedReceipts(matchResponse.matchId, encryptedReceipts, templateHash, accessToken);
+    }
+    async sendReceiptViaEmail(customerEmail, cheqiReceipt, accessToken = null) {
+        if (!isValidEmail(customerEmail)) {
+            throw new CheqiSDKError("Valid customer email is required", {
+                errorCode: ErrorCodes.VALIDATION_ERROR,
+                httpStatusCode: 400
+            });
+        }
+        await this.apiClient.sendReceiptViaEmail(customerEmail, cheqiReceipt, accessToken);
+        return ReceiptResult.deliveredViaEmail(customerEmail);
+    }
+    buildEncryptedReceipts(matchResponse, templateResponse, notificationDisplayCode) {
+        const encryptedReceipts = [];
+        for (const recipient of matchedRecipients(matchResponse)) {
+            const acceptedFormats = recipient.acceptedFormats ?? [];
+            const envelope = {};
+            if (acceptedFormats.includes("CHEQI") && templateResponse.cheqi) {
+                envelope.cheqi = templateResponse.cheqi;
+            }
+            if (acceptedFormats.includes("UBL_PURCHASE_RECEIPT") && templateResponse.ublPurchaseReceipt) {
+                envelope.ublPurchaseReceipt = templateResponse.ublPurchaseReceipt;
+            }
+            if (acceptedFormats.includes("UBL_INVOICE") && templateResponse.ublInvoice) {
+                envelope.ublInvoice = templateResponse.ublInvoice;
+            }
+            if (templateResponse.vatMetadata) {
+                envelope.vatMetaData = templateResponse.vatMetadata;
+            }
+            encryptedReceipts.push(this.createEncryptedReceipts(serializeJson(envelope), recipient, notificationDisplayCode));
+        }
+        return encryptedReceipts;
+    }
+    validateProcessInputs(identificationDetails, receiptRequest) {
+        if (!identificationDetails) {
+            throw new CheqiSDKError("Identification details cannot be null", {
+                errorCode: ErrorCodes.VALIDATION_ERROR,
+                httpStatusCode: 400
+            });
+        }
+        if (!receiptRequest) {
+            throw new CheqiSDKError("Receipt template request cannot be null", {
+                errorCode: ErrorCodes.VALIDATION_ERROR,
+                httpStatusCode: 400
+            });
+        }
+    }
+}
+function enrichWithVatContext(request, matchResponse) {
+    return {
+        ...request,
+        buyerCountryCode: getRequestBuyerCountryCode(request) ?? matchResponse.buyerCountryCode,
+        buyerType: getRequestBuyerType(request) ?? matchResponse.buyerType,
+        taxesApplied: resolveTaxesApplied(request)
+    };
+}
+function resolveTaxesApplied(request) {
+    const enriched = request;
+    if (enriched.taxesApplied !== undefined && enriched.taxesApplied !== null) {
+        return enriched.taxesApplied;
+    }
+    if (typeof request.totalTaxAmount === "number" && request.totalTaxAmount > 0) {
+        return true;
+    }
+    return Array.isArray(request.taxes) && request.taxes.length > 0;
+}
+function getRequestBuyerCountryCode(request) {
+    return request.buyerCountryCode;
+}
+function getRequestBuyerType(request) {
+    return request.buyerType;
+}
+//# sourceMappingURL=receipt.js.map

package/dist/services/receipt.js.map

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

package/dist/services/store.d.ts

@@ -0,0 +1,16 @@
+import type { CheqiApiClient, CreateStoreRequest } from "../types.js";
+export declare class StoreService {
+    private readonly apiClient;
+    constructor(apiClient: Pick<CheqiApiClient, "createStore" | "getStores" | "getStore" | "updateStore" | "deleteStore" | "activateStore" | "deactivateStore">);
+    createStore(companyId: string, request: CreateStoreRequest, accessToken?: string | null): Promise<Record<string, unknown>>;
+    getStores(companyId: string, activeOnly?: boolean | undefined, accessToken?: string | null): Promise<Record<string, unknown>>;
+    getActiveStores(companyId: string, accessToken?: string | null): Promise<Record<string, unknown>>;
+    getStore(companyId: string, storeId: string, accessToken?: string | null): Promise<Record<string, unknown>>;
+    updateStore(companyId: string, storeId: string, request: CreateStoreRequest | null | undefined, accessToken?: string | null): Promise<Record<string, unknown>>;
+    deleteStore(companyId: string, storeId: string, accessToken?: string | null): Promise<void>;
+    activateStore(companyId: string, storeId: string, accessToken?: string | null): Promise<void>;
+    deactivateStore(companyId: string, storeId: string, accessToken?: string | null): Promise<void>;
+    private validateCompanyId;
+    private validateStoreId;
+    private validateAccessToken;
+}

package/dist/services/store.js

@@ -0,0 +1,89 @@
+import { CheqiSDKError, ErrorCodes } from "../errors.js";
+import { getCreateStoreRequestValidationErrors } from "../validators.js";
+export class StoreService {
+    apiClient;
+    constructor(apiClient) {
+        this.apiClient = apiClient;
+    }
+    createStore(companyId, request, accessToken = null) {
+        this.validateCompanyId(companyId);
+        this.validateAccessToken(accessToken);
+        const validationErrors = getCreateStoreRequestValidationErrors(request);
+        if (validationErrors.length > 0) {
+            throw new CheqiSDKError(`Invalid store request: ${validationErrors.join(", ")}`, {
+                errorCode: ErrorCodes.VALIDATION_ERROR,
+                httpStatusCode: 400
+            });
+        }
+        return this.apiClient.createStore(companyId, request, accessToken);
+    }
+    getStores(companyId, activeOnly = undefined, accessToken = null) {
+        this.validateCompanyId(companyId);
+        this.validateAccessToken(accessToken);
+        return this.apiClient.getStores(companyId, activeOnly, accessToken);
+    }
+    getActiveStores(companyId, accessToken = null) {
+        return this.getStores(companyId, true, accessToken);
+    }
+    getStore(companyId, storeId, accessToken = null) {
+        this.validateCompanyId(companyId);
+        this.validateStoreId(storeId);
+        this.validateAccessToken(accessToken);
+        return this.apiClient.getStore(companyId, storeId, accessToken);
+    }
+    updateStore(companyId, storeId, request, accessToken = null) {
+        this.validateCompanyId(companyId);
+        this.validateStoreId(storeId);
+        this.validateAccessToken(accessToken);
+        if (!request) {
+            throw new CheqiSDKError("Store request cannot be null", {
+                errorCode: ErrorCodes.VALIDATION_ERROR,
+                httpStatusCode: 400
+            });
+        }
+        return this.apiClient.updateStore(companyId, storeId, request, accessToken);
+    }
+    deleteStore(companyId, storeId, accessToken = null) {
+        this.validateCompanyId(companyId);
+        this.validateStoreId(storeId);
+        this.validateAccessToken(accessToken);
+        return this.apiClient.deleteStore(companyId, storeId, accessToken);
+    }
+    activateStore(companyId, storeId, accessToken = null) {
+        this.validateCompanyId(companyId);
+        this.validateStoreId(storeId);
+        this.validateAccessToken(accessToken);
+        return this.apiClient.activateStore(companyId, storeId, accessToken);
+    }
+    deactivateStore(companyId, storeId, accessToken = null) {
+        this.validateCompanyId(companyId);
+        this.validateStoreId(storeId);
+        this.validateAccessToken(accessToken);
+        return this.apiClient.deactivateStore(companyId, storeId, accessToken);
+    }
+    validateCompanyId(companyId) {
+        if (!companyId) {
+            throw new CheqiSDKError("Company ID cannot be null", {
+                errorCode: ErrorCodes.VALIDATION_ERROR,
+                httpStatusCode: 400
+            });
+        }
+    }
+    validateStoreId(storeId) {
+        if (!storeId) {
+            throw new CheqiSDKError("Store ID cannot be null", {
+                errorCode: ErrorCodes.VALIDATION_ERROR,
+                httpStatusCode: 400
+            });
+        }
+    }
+    validateAccessToken(accessToken) {
+        if (!accessToken?.trim()) {
+            throw new CheqiSDKError("Access token cannot be null or empty", {
+                errorCode: ErrorCodes.AUTHENTICATION_FAILED,
+                httpStatusCode: 401
+            });
+        }
+    }
+}
+//# sourceMappingURL=store.js.map

package/dist/services/store.js.map

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

package/dist/services/verification.d.ts

@@ -0,0 +1,10 @@
+export declare class VerificationService {
+    calculateCheqiReceiptHash(cheqiReceipt: string | object): string;
+    canonicalizeCheqiReceipt(cheqiReceipt: string | object): string;
+    canonicalizeAndHashJson(json: string | object): string;
+    verifyJsonHash(json: string | object, expectedHash: string): boolean;
+    calculateUblHash(xml: string): string;
+    canonicalizeUbl(xml: string): string;
+    canonicalizeAndHashXml(xml: string): string;
+    verifyXmlHash(xml: string, expectedHash: string): boolean;
+}

package/dist/services/verification.js

@@ -0,0 +1,30 @@
+import { canonicalizeJson } from "../rfc8785.js";
+import { sha256Hex } from "../utils.js";
+import { canonicalizeAndHashXml, canonicalizeXml } from "../xml.js";
+export class VerificationService {
+    calculateCheqiReceiptHash(cheqiReceipt) {
+        return this.canonicalizeAndHashJson(cheqiReceipt);
+    }
+    canonicalizeCheqiReceipt(cheqiReceipt) {
+        return canonicalizeJson(cheqiReceipt);
+    }
+    canonicalizeAndHashJson(json) {
+        return sha256Hex(canonicalizeJson(json));
+    }
+    verifyJsonHash(json, expectedHash) {
+        return this.canonicalizeAndHashJson(json) === expectedHash;
+    }
+    calculateUblHash(xml) {
+        return this.canonicalizeAndHashXml(xml);
+    }
+    canonicalizeUbl(xml) {
+        return canonicalizeXml(xml);
+    }
+    canonicalizeAndHashXml(xml) {
+        return canonicalizeAndHashXml(xml);
+    }
+    verifyXmlHash(xml, expectedHash) {
+        return this.canonicalizeAndHashXml(xml) === expectedHash;
+    }
+}
+//# sourceMappingURL=verification.js.map

package/dist/services/verification.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verification.js","sourceRoot":"","sources":["../../src/services/verification.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAEpE,MAAM,OAAO,mBAAmB;IAC9B,yBAAyB,CAAC,YAA6B;QACrD,OAAO,IAAI,CAAC,uBAAuB,CAAC,YAAY,CAAC,CAAC;IACpD,CAAC;IAED,wBAAwB,CAAC,YAA6B;QACpD,OAAO,gBAAgB,CAAC,YAAY,CAAC,CAAC;IACxC,CAAC;IAED,uBAAuB,CAAC,IAAqB;QAC3C,OAAO,SAAS,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC;IAC3C,CAAC;IAED,cAAc,CAAC,IAAqB,EAAE,YAAoB;QACxD,OAAO,IAAI,CAAC,uBAAuB,CAAC,IAAI,CAAC,KAAK,YAAY,CAAC;IAC7D,CAAC;IAED,gBAAgB,CAAC,GAAW;QAC1B,OAAO,IAAI,CAAC,sBAAsB,CAAC,GAAG,CAAC,CAAC;IAC1C,CAAC;IAED,eAAe,CAAC,GAAW;QACzB,OAAO,eAAe,CAAC,GAAG,CAAC,CAAC;IAC9B,CAAC;IAED,sBAAsB,CAAC,GAAW;QAChC,OAAO,sBAAsB,CAAC,GAAG,CAAC,CAAC;IACrC,CAAC;IAED,aAAa,CAAC,GAAW,EAAE,YAAoB;QAC7C,OAAO,IAAI,CAAC,sBAAsB,CAAC,GAAG,CAAC,KAAK,YAAY,CAAC;IAC3D,CAAC;CACF"}

package/dist/types.d.ts

@@ -0,0 +1,70 @@
+export type Nullable<T> = T | null;
+export type JsonPrimitive = string | number | boolean | null;
+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 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 interface CreditNoteEnvelope {
+    cheqiCreditNote?: import("./models/generated/index.js").CheqiCreditNote;
+    ublCreditNote?: string;
+}
+export interface DecryptedDeliveredCreditNote {
+    creditNoteEnvelope: CreditNoteEnvelope;
+    creditNoteContextEnvelope: import("./models/generated/index.js").CreditNoteContextEnvelope | null;
+    rawJson: string;
+    rawCreditNoteContextJson: string | null;
+}
+export interface EncryptedReceipt {
+    recipientId?: string;
+    receiptId?: string;
+    receiverType?: string;
+    encryptedReceipt?: string;
+    encryptedSymmetricKey?: string;
+    finalHash?: string;
+    publicKey?: string;
+    supplierPartyId?: string;
+    notificationDisplayCode?: {
+        type: string;
+        data: string;
+    };
+    encryptedCustomerDetails?: string;
+    encryptedCustomerAesKey?: string;
+}
+export interface CheqiSDKOptions {
+    environment?: string;
+    customApiEndpoint?: string;
+    apiKey?: Nullable<string>;
+    privateKey?: Nullable<string>;
+    timeoutSeconds?: number;
+    maxRetries?: number;
+    logger?: import("./logger.js").Logger;
+}
+export interface RequestOptions {
+    body?: unknown;
+    params?: Record<string, string | number | boolean | null | undefined>;
+    accessToken?: string | null;
+    operation: string;
+}
+export type FetchLike = typeof fetch;
+export interface CheqiApiClient {
+    generateReceiptTemplate(request: import("./models/generated/index.js").ReceiptTemplateGenerationRequest, accessToken?: string | null): Promise<import("./models/generated/index.js").ReceiptTemplateResponse>;
+    generateCreditNoteTemplate(request: import("./models/generated/index.js").CreditNoteTemplateGenerationRequest, accessToken?: string | null): Promise<import("./models/generated/index.js").CreditNoteTemplateResponse>;
+    matchCustomer(request: import("./models/generated/index.js").IdentificationDetails, accessToken?: string | null): Promise<import("./models/generated/index.js").RecipientResolutionResponse>;
+    sendEncryptedReceipts(matchId: string, encryptedReceipts: import("./models/generated/index.js").EncryptedReceiptRequest[], templateHash: string, accessToken?: string | null): Promise<Record<string, unknown>>;
+    sendEncryptedCreditNotes(matchId: string, parentCheqiReceiptId: string, encryptedCreditNotes: import("./models/generated/index.js").EncryptedCreditNote[], templateHash: string, accessToken?: string | null): Promise<Record<string, unknown>>;
+    sendReceiptViaEmail(customerEmail: string, receipt: Record<string, unknown> | string, accessToken?: string | null): Promise<void>;
+    provisionCompany(request: ProvisionCompanyRequest): Promise<Record<string, unknown>>;
+    createStore(companyId: string, request: import("./models/generated/index.js").CreateStoreRequest, accessToken?: string | null): Promise<Record<string, unknown>>;
+    getStores(companyId: string, activeOnly?: boolean, accessToken?: string | null): Promise<Record<string, unknown>>;
+    getStore(companyId: string, storeId: string, accessToken?: string | null): Promise<Record<string, unknown>>;
+    updateStore(companyId: string, storeId: string, request: import("./models/generated/index.js").CreateStoreRequest, accessToken?: string | null): Promise<Record<string, unknown>>;
+    deleteStore(companyId: string, storeId: string, accessToken?: string | null): Promise<void>;
+    activateStore(companyId: string, storeId: string, accessToken?: string | null): Promise<void>;
+    deactivateStore(companyId: string, storeId: string, accessToken?: string | null): Promise<void>;
+}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/utils.d.ts

@@ -0,0 +1,11 @@
+export declare function isRecord(value: unknown): value is Record<string, unknown>;
+export declare function isNonEmptyString(value: unknown): value is string;
+export declare function coalesceString(...values: unknown[]): string | undefined;
+/** Basic email format check: local@domain with at least one dot in domain. */
+export declare function isValidEmail(value: string): boolean;
+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;
+export declare function parseBase64Der(base64: string): Buffer;
+export declare function sleep(ms: number): Promise<void>;