@cheqi/sdk 0.1.1

package/README.md

@@ -0,0 +1,57 @@
+# Cheqi TypeScript SDK
+
+TypeScript-first Cheqi SDK for encrypted receipt and credit note processing.
+
+## Included
+
+- SDK entrypoint with config and service wiring
+- Customer matching
+- Receipt processing flow: match -> template -> encrypt -> send/email fallback
+- Credit note processing flow
+- Hybrid RSA-OAEP + AES-256-GCM encryption/decryption
+- Retry-capable HTTP client
+- JSON canonical hashing and basic XML normalization hashing
+- Company and store service wrappers
+- Generated declarations from the TypeScript source
+
+## Install
+
+```bash
+npm install
+```
+
+## Test
+
+```bash
+npm test
+```
+
+## Usage
+
+```ts
+import { CheqiSDK, Environment } from "@cheqi/sdk";
+
+const sdk = CheqiSDK.builder()
+  .apiEndpoint(Environment.SANDBOX)
+  .apiKey("sk_test_...")
+  .build();
+
+const result = await sdk.receiptService.processCompleteReceipt(
+  {
+    recipientEmail: "customer@example.com"
+  },
+  {
+    documentNumber: "INV-001",
+    currency: "EUR",
+    totalAmount: 12.1
+  }
+);
+```
+
+## Notes
+
+- Models are plain TypeScript object shapes with automatic camelCase serialization.
+- The public service structure now includes Java-style `builder()` and `get*Service()` accessors.
+- The package ships `.d.ts` declarations so it can be consumed directly from TypeScript.
+- The full Java model class hierarchy is still not recreated as class-per-model; the payload contract is represented as typed object shapes instead.
+- XML verification currently normalizes formatting whitespace and hashes the result. If strict XML C14N compatibility is required, that part should be hardened next.

package/dist/cheqi-sdk.d.ts

@@ -0,0 +1,98 @@
+import { CheqiSDKConfig } from "./config.js";
+import { DefaultCheqiApiClient } from "./http/client.js";
+import type { Logger } from "./logger.js";
+import type { CheqiSDKOptions, DecryptedDeliveredCreditNote, EncryptedCreditNote, EncryptedReceipt } from "./types.js";
+import { CompanyService } from "./services/company.js";
+import { CreditNoteService } from "./services/credit-note.js";
+import { DecryptionService } from "./services/decryption.js";
+import { EncryptionService } from "./services/encryption.js";
+import { MatchingService } from "./services/matching.js";
+import { ReceiptService } from "./services/receipt.js";
+import { StoreService } from "./services/store.js";
+import { VerificationService } from "./services/verification.js";
+/**
+ * Fluent builder for constructing a {@link CheqiSDK} instance.
+ *
+ * @example
+ * ```ts
+ * const sdk = CheqiSDK.builder()
+ *   .apiEndpoint("https://sandbox.api.cheqi.io")
+ *   .apiKey("sk_test_abc123")
+ *   .build();
+ * ```
+ */
+export declare class CheqiSDKBuilder {
+    private readonly options;
+    /** Set the API endpoint (e.g. one of the {@link Environment} constants). */
+    apiEndpoint(apiEndpoint: string): this;
+    /** Set a custom API endpoint URL. Takes precedence over {@link apiEndpoint}. */
+    customApiEndpoint(customApiEndpoint: string): this;
+    /** Set the API key (typically starts with `sk_live_` or `sk_test_`). */
+    apiKey(apiKey: string): this;
+    /** Set the RSA private key (base64-encoded PKCS#8 DER) for decryption. */
+    privateKey(privateKey: string): this;
+    /** HTTP request timeout in seconds (default 30, max recommended 300). */
+    timeoutSeconds(timeoutSeconds: number): this;
+    /** Maximum number of retry attempts for transient failures (default 3). */
+    maxRetries(maxRetries: number): this;
+    /** Supply a custom logger (console, pino, winston, etc.). */
+    logger(logger: Logger): this;
+    /** Build and return a configured {@link CheqiSDK} instance. */
+    build(): CheqiSDK;
+}
+/**
+ * Main entry point for the Cheqi SDK.
+ *
+ * Provides access to all services: receipt processing, credit-note
+ * processing, customer matching, encryption/decryption, company
+ * provisioning, and store management.
+ *
+ * @example
+ * ```ts
+ * const sdk = CheqiSDK.builder()
+ *   .apiEndpoint(Environment.SANDBOX)
+ *   .apiKey("sk_test_abc123")
+ *   .build();
+ *
+ * const result = await sdk.receiptService.processCompleteReceipt(
+ *   identificationDetails,
+ *   receiptRequest,
+ *   accessToken
+ * );
+ * ```
+ */
+export declare class CheqiSDK {
+    readonly config: CheqiSDKConfig;
+    readonly verificationService: VerificationService;
+    readonly decryptionService: DecryptionService;
+    readonly encryptionService: EncryptionService;
+    readonly apiClient: DefaultCheqiApiClient;
+    readonly matchingService: MatchingService;
+    readonly receiptService: ReceiptService;
+    readonly companyService: CompanyService;
+    readonly storeService: StoreService;
+    readonly creditNoteService: CreditNoteService;
+    /** Create a new {@link CheqiSDKBuilder}. */
+    static builder(): CheqiSDKBuilder;
+    constructor(options?: CheqiSDKOptions, apiClient?: DefaultCheqiApiClient | null);
+    /**
+     * Decrypt an encrypted receipt using the seller's private key.
+     * @param encryptedReceipt  The encrypted receipt payload.
+     * @param privateKey        Base64-encoded PKCS#8 DER private key.
+     */
+    processEncryptedReceipt(encryptedReceipt: EncryptedReceipt, privateKey: string): {
+        receiptContent: string;
+        customerDetails: string | null;
+    };
+    processEncryptedCreditNote(encryptedCreditNote: EncryptedCreditNote, privateKey: string): DecryptedDeliveredCreditNote;
+    getConfig(): CheqiSDKConfig;
+    getApiClient(): DefaultCheqiApiClient;
+    getEncryptionService(): EncryptionService;
+    getDecryptionService(): DecryptionService;
+    getMatchingService(): MatchingService;
+    getReceiptService(): ReceiptService;
+    getCreditNoteService(): CreditNoteService;
+    getCompanyService(): CompanyService;
+    getStoreService(): StoreService;
+    getVerificationService(): VerificationService;
+}

package/dist/cheqi-sdk.js

@@ -0,0 +1,134 @@
+import { CheqiSDKConfig } from "./config.js";
+import { DefaultCheqiApiClient } from "./http/client.js";
+import { CompanyService } from "./services/company.js";
+import { CreditNoteService } from "./services/credit-note.js";
+import { DecryptionService } from "./services/decryption.js";
+import { EncryptionService } from "./services/encryption.js";
+import { MatchingService } from "./services/matching.js";
+import { ReceiptService } from "./services/receipt.js";
+import { StoreService } from "./services/store.js";
+import { VerificationService } from "./services/verification.js";
+/**
+ * Fluent builder for constructing a {@link CheqiSDK} instance.
+ *
+ * @example
+ * ```ts
+ * const sdk = CheqiSDK.builder()
+ *   .apiEndpoint("https://sandbox.api.cheqi.io")
+ *   .apiKey("sk_test_abc123")
+ *   .build();
+ * ```
+ */
+export class CheqiSDKBuilder {
+    options = {};
+    /** Set the API endpoint (e.g. one of the {@link Environment} constants). */
+    apiEndpoint(apiEndpoint) {
+        this.options.environment = apiEndpoint;
+        return this;
+    }
+    /** Set a custom API endpoint URL. Takes precedence over {@link apiEndpoint}. */
+    customApiEndpoint(customApiEndpoint) {
+        this.options.customApiEndpoint = customApiEndpoint;
+        return this;
+    }
+    /** Set the API key (typically starts with `sk_live_` or `sk_test_`). */
+    apiKey(apiKey) {
+        this.options.apiKey = apiKey;
+        return this;
+    }
+    /** Set the RSA private key (base64-encoded PKCS#8 DER) for decryption. */
+    privateKey(privateKey) {
+        this.options.privateKey = privateKey;
+        return this;
+    }
+    /** HTTP request timeout in seconds (default 30, max recommended 300). */
+    timeoutSeconds(timeoutSeconds) {
+        this.options.timeoutSeconds = timeoutSeconds;
+        return this;
+    }
+    /** Maximum number of retry attempts for transient failures (default 3). */
+    maxRetries(maxRetries) {
+        this.options.maxRetries = maxRetries;
+        return this;
+    }
+    /** Supply a custom logger (console, pino, winston, etc.). */
+    logger(logger) {
+        this.options.logger = logger;
+        return this;
+    }
+    /** Build and return a configured {@link CheqiSDK} instance. */
+    build() {
+        return new CheqiSDK(this.options);
+    }
+}
+/**
+ * Main entry point for the Cheqi SDK.
+ *
+ * Provides access to all services: receipt processing, credit-note
+ * processing, customer matching, encryption/decryption, company
+ * provisioning, and store management.
+ *
+ * @example
+ * ```ts
+ * const sdk = CheqiSDK.builder()
+ *   .apiEndpoint(Environment.SANDBOX)
+ *   .apiKey("sk_test_abc123")
+ *   .build();
+ *
+ * const result = await sdk.receiptService.processCompleteReceipt(
+ *   identificationDetails,
+ *   receiptRequest,
+ *   accessToken
+ * );
+ * ```
+ */
+export class CheqiSDK {
+    config;
+    verificationService;
+    decryptionService;
+    encryptionService;
+    apiClient;
+    matchingService;
+    receiptService;
+    companyService;
+    storeService;
+    creditNoteService;
+    /** Create a new {@link CheqiSDKBuilder}. */
+    static builder() {
+        return new CheqiSDKBuilder();
+    }
+    constructor(options = {}, apiClient = null) {
+        this.config = new CheqiSDKConfig(options);
+        this.verificationService = new VerificationService();
+        this.decryptionService = new DecryptionService();
+        this.encryptionService = new EncryptionService();
+        this.apiClient = apiClient ?? new DefaultCheqiApiClient(this.config);
+        this.matchingService = new MatchingService(this.apiClient);
+        this.receiptService = new ReceiptService(this.apiClient, this.encryptionService, this.matchingService);
+        this.companyService = new CompanyService(this.apiClient);
+        this.storeService = new StoreService(this.apiClient);
+        this.creditNoteService = new CreditNoteService(this.apiClient, this.encryptionService, this.matchingService, this.decryptionService);
+    }
+    /**
+     * Decrypt an encrypted receipt using the seller's private key.
+     * @param encryptedReceipt  The encrypted receipt payload.
+     * @param privateKey        Base64-encoded PKCS#8 DER private key.
+     */
+    processEncryptedReceipt(encryptedReceipt, privateKey) {
+        return this.decryptionService.decryptReceipt(encryptedReceipt, privateKey);
+    }
+    processEncryptedCreditNote(encryptedCreditNote, privateKey) {
+        return this.creditNoteService.decryptDeliveredCreditNote(encryptedCreditNote, privateKey);
+    }
+    getConfig() { return this.config; }
+    getApiClient() { return this.apiClient; }
+    getEncryptionService() { return this.encryptionService; }
+    getDecryptionService() { return this.decryptionService; }
+    getMatchingService() { return this.matchingService; }
+    getReceiptService() { return this.receiptService; }
+    getCreditNoteService() { return this.creditNoteService; }
+    getCompanyService() { return this.companyService; }
+    getStoreService() { return this.storeService; }
+    getVerificationService() { return this.verificationService; }
+}
+//# sourceMappingURL=cheqi-sdk.js.map

package/dist/cheqi-sdk.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,23 @@
+import type { Logger } from "./logger.js";
+import type { CheqiSDKOptions, Nullable } from "./types.js";
+/** Well-known API environment base URLs. */
+export declare const Environment: {
+    readonly SANDBOX: "https://sandbox.api.cheqi.io";
+    readonly TEST: "https://test.api.cheqi.io";
+    readonly PRODUCTION: "https://api.cheqi.io";
+};
+/**
+ * Validated, immutable configuration for the Cheqi SDK.
+ *
+ * Constructed from {@link CheqiSDKOptions} with sensible defaults and
+ * range-checked values.
+ */
+export declare class CheqiSDKConfig {
+    readonly apiEndpoint: string;
+    readonly apiKey: Nullable<string>;
+    readonly privateKey: Nullable<string>;
+    readonly timeoutSeconds: number;
+    readonly maxRetries: number;
+    readonly logger: Logger;
+    constructor(options?: CheqiSDKOptions);
+}

package/dist/config.js

@@ -0,0 +1,63 @@
+import { ConsoleLogger } from "./logger.js";
+/** Well-known API environment base URLs. */
+export const Environment = {
+    SANDBOX: "https://sandbox.api.cheqi.io",
+    TEST: "https://test.api.cheqi.io",
+    PRODUCTION: "https://api.cheqi.io"
+};
+const MAX_TIMEOUT_SECONDS = 300;
+const MAX_RETRIES = 10;
+/**
+ * Validated, immutable configuration for the Cheqi SDK.
+ *
+ * Constructed from {@link CheqiSDKOptions} with sensible defaults and
+ * range-checked values.
+ */
+export class CheqiSDKConfig {
+    apiEndpoint;
+    apiKey;
+    privateKey;
+    timeoutSeconds;
+    maxRetries;
+    logger;
+    constructor(options = {}) {
+        const { environment, customApiEndpoint, apiKey = null, privateKey = null, timeoutSeconds = 30, maxRetries = 3, logger = new ConsoleLogger() } = options;
+        this.logger = logger;
+        // --- endpoint ---
+        this.apiEndpoint = customApiEndpoint ?? environment ?? "";
+        if (!this.apiEndpoint) {
+            throw new Error("Either 'environment' or 'customApiEndpoint' must be provided");
+        }
+        // --- timeout ---
+        if (timeoutSeconds <= 0) {
+            throw new Error(`Timeout must be positive, got: ${timeoutSeconds}`);
+        }
+        if (timeoutSeconds > MAX_TIMEOUT_SECONDS) {
+            this.logger.warn(`Timeout ${timeoutSeconds}s exceeds recommended maximum of ${MAX_TIMEOUT_SECONDS}s`);
+        }
+        this.timeoutSeconds = timeoutSeconds;
+        // --- retries ---
+        if (maxRetries < 0) {
+            throw new Error(`Max retries cannot be negative, got: ${maxRetries}`);
+        }
+        if (maxRetries > MAX_RETRIES) {
+            this.logger.warn(`Max retries ${maxRetries} exceeds recommended maximum of ${MAX_RETRIES}`);
+        }
+        this.maxRetries = maxRetries;
+        // --- api key ---
+        if (apiKey && !isValidApiKeyFormat(apiKey)) {
+            this.logger.warn("API key does not match expected format (sk_live_* or sk_test_*)");
+        }
+        this.apiKey = apiKey;
+        // --- private key ---
+        if (!privateKey) {
+            this.logger.info("No private key configured — decryption features will not be available");
+        }
+        this.privateKey = privateKey;
+        this.logger.info(`SDK configured: endpoint=${this.apiEndpoint}, timeout=${this.timeoutSeconds}s, maxRetries=${this.maxRetries}`);
+    }
+}
+function isValidApiKeyFormat(key) {
+    return key.startsWith("sk_live_") || key.startsWith("sk_test_");
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG5C,4CAA4C;AAC5C,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,OAAO,EAAE,8BAA8B;IACvC,IAAI,EAAE,2BAA2B;IACjC,UAAU,EAAE,sBAAsB;CAC1B,CAAC;AAEX,MAAM,mBAAmB,GAAG,GAAG,CAAC;AAChC,MAAM,WAAW,GAAG,EAAE,CAAC;AAEvB;;;;;GAKG;AACH,MAAM,OAAO,cAAc;IAChB,WAAW,CAAS;IACpB,MAAM,CAAmB;IACzB,UAAU,CAAmB;IAC7B,cAAc,CAAS;IACvB,UAAU,CAAS;IACnB,MAAM,CAAS;IAExB,YAAY,UAA2B,EAAE;QACvC,MAAM,EACJ,WAAW,EACX,iBAAiB,EACjB,MAAM,GAAG,IAAI,EACb,UAAU,GAAG,IAAI,EACjB,cAAc,GAAG,EAAE,EACnB,UAAU,GAAG,CAAC,EACd,MAAM,GAAG,IAAI,aAAa,EAAE,EAC7B,GAAG,OAAO,CAAC;QAEZ,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QAErB,mBAAmB;QACnB,IAAI,CAAC,WAAW,GAAG,iBAAiB,IAAI,WAAW,IAAI,EAAE,CAAC;QAC1D,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;QAClF,CAAC;QAED,kBAAkB;QAClB,IAAI,cAAc,IAAI,CAAC,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,kCAAkC,cAAc,EAAE,CAAC,CAAC;QACtE,CAAC;QACD,IAAI,cAAc,GAAG,mBAAmB,EAAE,CAAC;YACzC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,cAAc,oCAAoC,mBAAmB,GAAG,CAAC,CAAC;QACxG,CAAC;QACD,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;QAErC,kBAAkB;QAClB,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,wCAAwC,UAAU,EAAE,CAAC,CAAC;QACxE,CAAC;QACD,IAAI,UAAU,GAAG,WAAW,EAAE,CAAC;YAC7B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,eAAe,UAAU,mCAAmC,WAAW,EAAE,CAAC,CAAC;QAC9F,CAAC;QACD,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAE7B,kBAAkB;QAClB,IAAI,MAAM,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3C,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,iEAAiE,CAAC,CAAC;QACtF,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QAErB,sBAAsB;QACtB,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,uEAAuE,CAAC,CAAC;QAC5F,CAAC;QACD,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAE7B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,4BAA4B,IAAI,CAAC,WAAW,aAAa,IAAI,CAAC,cAAc,iBAAiB,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;IACnI,CAAC;CACF;AAED,SAAS,mBAAmB,CAAC,GAAW;IACtC,OAAO,GAAG,CAAC,UAAU,CAAC,UAAU,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;AAClE,CAAC"}

package/dist/crypto.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Shared cryptographic constants used by both encryption and decryption services.
+ */
+/** AES-256 key length in bytes. */
+export declare const AES_KEY_LENGTH = 32;
+/** GCM initialization vector length in bytes. */
+export declare const GCM_IV_LENGTH = 12;
+/** GCM authentication tag length in bytes. */
+export declare const GCM_TAG_LENGTH = 16;

package/dist/crypto.js

@@ -0,0 +1,10 @@
+/**
+ * Shared cryptographic constants used by both encryption and decryption services.
+ */
+/** AES-256 key length in bytes. */
+export const AES_KEY_LENGTH = 32;
+/** GCM initialization vector length in bytes. */
+export const GCM_IV_LENGTH = 12;
+/** GCM authentication tag length in bytes. */
+export const GCM_TAG_LENGTH = 16;
+//# sourceMappingURL=crypto.js.map

package/dist/crypto.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"crypto.js","sourceRoot":"","sources":["../src/crypto.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,mCAAmC;AACnC,MAAM,CAAC,MAAM,cAAc,GAAG,EAAE,CAAC;AAEjC,iDAAiD;AACjD,MAAM,CAAC,MAAM,aAAa,GAAG,EAAE,CAAC;AAEhC,8CAA8C;AAC9C,MAAM,CAAC,MAAM,cAAc,GAAG,EAAE,CAAC"}

package/dist/entity/index.d.ts

@@ -0,0 +1 @@
+export * from "../models/entity.js";

package/dist/entity/index.js

@@ -0,0 +1,2 @@
+export * from "../models/entity.js";
+//# sourceMappingURL=index.js.map

package/dist/entity/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/entity/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,40 @@
+export declare const ErrorCodes: {
+    readonly UNKNOWN_ERROR: "UNKNOWN_ERROR";
+    readonly VALIDATION_ERROR: "VALIDATION_ERROR";
+    readonly AUTHENTICATION_FAILED: "AUTHENTICATION_FAILED";
+    readonly AUTHORIZATION_FAILED: "AUTHORIZATION_FAILED";
+    readonly CUSTOMER_NOT_FOUND: "CUSTOMER_NOT_FOUND";
+    readonly RECEIPT_NOT_FOUND: "RECEIPT_NOT_FOUND";
+    readonly ENCRYPTION_ERROR: "ENCRYPTION_ERROR";
+    readonly DECRYPTION_ERROR: "DECRYPTION_ERROR";
+    readonly NETWORK_ERROR: "NETWORK_ERROR";
+    readonly RATE_LIMITED: "RATE_LIMITED";
+    readonly SERVER_ERROR: "SERVER_ERROR";
+    readonly INVALID_RESPONSE: "INVALID_RESPONSE";
+};
+export type ErrorCode = (typeof ErrorCodes)[keyof typeof ErrorCodes];
+export interface CheqiErrorOptions {
+    errorCode?: ErrorCode;
+    httpStatusCode?: number;
+    correlationId?: string | null;
+    cause?: unknown;
+}
+export declare class CheqiSDKError extends Error {
+    readonly errorCode: ErrorCode;
+    readonly httpStatusCode: number;
+    readonly correlationId: string | null;
+    constructor(message: string, options?: CheqiErrorOptions);
+}
+export declare class CheqiApiError extends CheqiSDKError {
+    get isRetryable(): boolean;
+}
+export declare class EncryptionError extends CheqiSDKError {
+    constructor(message: string, options?: Omit<CheqiErrorOptions, "errorCode">);
+}
+export declare class DecryptionError extends CheqiSDKError {
+    constructor(message: string, options?: Omit<CheqiErrorOptions, "errorCode">);
+}
+export declare class ReceiptProcessingError extends CheqiSDKError {
+}
+export declare class CreditNoteProcessingError extends CheqiSDKError {
+}

package/dist/errors.js

@@ -0,0 +1,48 @@
+export const ErrorCodes = {
+    UNKNOWN_ERROR: "UNKNOWN_ERROR",
+    VALIDATION_ERROR: "VALIDATION_ERROR",
+    AUTHENTICATION_FAILED: "AUTHENTICATION_FAILED",
+    AUTHORIZATION_FAILED: "AUTHORIZATION_FAILED",
+    CUSTOMER_NOT_FOUND: "CUSTOMER_NOT_FOUND",
+    RECEIPT_NOT_FOUND: "RECEIPT_NOT_FOUND",
+    ENCRYPTION_ERROR: "ENCRYPTION_ERROR",
+    DECRYPTION_ERROR: "DECRYPTION_ERROR",
+    NETWORK_ERROR: "NETWORK_ERROR",
+    RATE_LIMITED: "RATE_LIMITED",
+    SERVER_ERROR: "SERVER_ERROR",
+    INVALID_RESPONSE: "INVALID_RESPONSE"
+};
+export class CheqiSDKError extends Error {
+    errorCode;
+    httpStatusCode;
+    correlationId;
+    constructor(message, options = {}) {
+        super(message, { cause: options.cause });
+        this.name = new.target.name;
+        this.errorCode = options.errorCode ?? ErrorCodes.UNKNOWN_ERROR;
+        this.httpStatusCode = options.httpStatusCode ?? 0;
+        this.correlationId = options.correlationId ?? null;
+    }
+}
+export class CheqiApiError extends CheqiSDKError {
+    get isRetryable() {
+        return this.httpStatusCode === 408 ||
+            this.httpStatusCode === 429 ||
+            (this.httpStatusCode >= 500 && this.httpStatusCode < 600);
+    }
+}
+export class EncryptionError extends CheqiSDKError {
+    constructor(message, options = {}) {
+        super(message, { ...options, errorCode: ErrorCodes.ENCRYPTION_ERROR });
+    }
+}
+export class DecryptionError extends CheqiSDKError {
+    constructor(message, options = {}) {
+        super(message, { ...options, errorCode: ErrorCodes.DECRYPTION_ERROR });
+    }
+}
+export class ReceiptProcessingError extends CheqiSDKError {
+}
+export class CreditNoteProcessingError extends CheqiSDKError {
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,aAAa,EAAE,eAAe;IAC9B,gBAAgB,EAAE,kBAAkB;IACpC,qBAAqB,EAAE,uBAAuB;IAC9C,oBAAoB,EAAE,sBAAsB;IAC5C,kBAAkB,EAAE,oBAAoB;IACxC,iBAAiB,EAAE,mBAAmB;IACtC,gBAAgB,EAAE,kBAAkB;IACpC,gBAAgB,EAAE,kBAAkB;IACpC,aAAa,EAAE,eAAe;IAC9B,YAAY,EAAE,cAAc;IAC5B,YAAY,EAAE,cAAc;IAC5B,gBAAgB,EAAE,kBAAkB;CAC5B,CAAC;AAWX,MAAM,OAAO,aAAc,SAAQ,KAAK;IAC7B,SAAS,CAAY;IACrB,cAAc,CAAS;IACvB,aAAa,CAAgB;IAEtC,YAAY,OAAe,EAAE,UAA6B,EAAE;QAC1D,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;QACzC,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC;QAC5B,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,UAAU,CAAC,aAAa,CAAC;QAC/D,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC,cAAc,IAAI,CAAC,CAAC;QAClD,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC,aAAa,IAAI,IAAI,CAAC;IACrD,CAAC;CACF;AAED,MAAM,OAAO,aAAc,SAAQ,aAAa;IAC9C,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,cAAc,KAAK,GAAG;YAChC,IAAI,CAAC,cAAc,KAAK,GAAG;YAC3B,CAAC,IAAI,CAAC,cAAc,IAAI,GAAG,IAAI,IAAI,CAAC,cAAc,GAAG,GAAG,CAAC,CAAC;IAC9D,CAAC;CACF;AAED,MAAM,OAAO,eAAgB,SAAQ,aAAa;IAChD,YAAY,OAAe,EAAE,UAAgD,EAAE;QAC7E,KAAK,CAAC,OAAO,EAAE,EAAE,GAAG,OAAO,EAAE,SAAS,EAAE,UAAU,CAAC,gBAAgB,EAAE,CAAC,CAAC;IACzE,CAAC;CACF;AAED,MAAM,OAAO,eAAgB,SAAQ,aAAa;IAChD,YAAY,OAAe,EAAE,UAAgD,EAAE;QAC7E,KAAK,CAAC,OAAO,EAAE,EAAE,GAAG,OAAO,EAAE,SAAS,EAAE,UAAU,CAAC,gBAAgB,EAAE,CAAC,CAAC;IACzE,CAAC;CACF;AAED,MAAM,OAAO,sBAAuB,SAAQ,aAAa;CAAG;AAE5D,MAAM,OAAO,yBAA0B,SAAQ,aAAa;CAAG"}

package/dist/http/client.d.ts

@@ -0,0 +1,32 @@
+import { CheqiSDKConfig } from "../config.js";
+import type { CheqiApiClient, CreateStoreRequest, CreditNoteTemplateGenerationRequest, CreditNoteTemplateResponse, EncryptedCreditNote, EncryptedReceiptRequest, FetchLike, IdentificationDetails, ReceiptTemplateGenerationRequest, ReceiptTemplateResponse, RecipientResolutionResponse, ProvisionCompanyRequest } from "../types.js";
+/**
+ * Default HTTP implementation of {@link CheqiApiClient}.
+ *
+ * Uses the global `fetch` (or an injected implementation) with automatic
+ * retry, bearer-token auth, and structured logging.
+ */
+export declare class DefaultCheqiApiClient implements CheqiApiClient {
+    private readonly config;
+    private readonly fetchImpl;
+    private readonly retryHandler;
+    private readonly userAgent;
+    private readonly logger;
+    constructor(config: CheqiSDKConfig, fetchImpl?: FetchLike);
+    generateReceiptTemplate(request: ReceiptTemplateGenerationRequest, accessToken?: string | null): Promise<ReceiptTemplateResponse>;
+    generateCreditNoteTemplate(request: CreditNoteTemplateGenerationRequest, accessToken?: string | null): Promise<CreditNoteTemplateResponse>;
+    matchCustomer(request: IdentificationDetails, accessToken?: string | null): Promise<RecipientResolutionResponse>;
+    sendEncryptedReceipts(matchId: string, encryptedReceipts: EncryptedReceiptRequest[], templateHash: string, accessToken?: string | null): Promise<Record<string, unknown>>;
+    sendEncryptedCreditNotes(matchId: string, parentCheqiReceiptId: string, encryptedCreditNotes: 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: 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: 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>;
+    private authHeaders;
+    private request;
+}