clearbank-sdk 1.0.0

package/dist/cjs/domains/webhooks/service.js

@@ -0,0 +1,173 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WebhooksService = exports.buildAckBody = void 0;
+const crypto_js_1 = require("../../core/crypto.js");
+const index_js_1 = require("../../types/index.js");
+var types_js_1 = require("./types.js");
+Object.defineProperty(exports, "buildAckBody", { enumerable: true, get: function () { return types_js_1.buildAckBody; } });
+/**
+ * Webhook signature verification and typed event dispatch.
+ *
+ * @example
+ * ```ts
+ * const webhooks = client.webhooks;
+ *
+ * app.post('/webhooks', async (req, res) => {
+ *   const body = JSON.stringify(req.body);
+ *   const isValid = await webhooks.verifySignature(body, req.headers['digitalsignature'], publicKeyPem);
+ *   if (!isValid) return res.status(401).send('Invalid signature');
+ *
+ *   await webhooks.dispatch(req.body, {
+ *     TransactionSettled: async (event) => {
+ *       await processPayment(event);
+ *     },
+ *     onUnknown: (envelope) => console.log('Unknown event:', envelope.Type),
+ *   });
+ *
+ *   res.json(webhooks.buildAck(req.body));
+ * });
+ * ```
+ */
+class WebhooksService {
+    /**
+     * Verifies a ClearBank `DigitalSignature` header using ClearBank's public key.
+     * Download the public key from Portal → Webhook Management.
+     *
+     * @param body       Raw request body as a string (before JSON.parse).
+     * @param signature  Value of the `DigitalSignature` header.
+     * @param publicKeyPem ClearBank RSA public key in PEM format.
+     */
+    async verifySignature(body, signature, publicKeyPem) {
+        return (0, crypto_js_1.verifySignature)(body, signature, publicKeyPem);
+    }
+    /**
+     * Parses and validates a raw webhook body into a typed envelope.
+     *
+     * @throws {ClearBankError} if the body is not valid JSON or is missing the Type field.
+     */
+    parseEnvelope(rawBody) {
+        let parsed;
+        if (typeof rawBody === 'string') {
+            try {
+                parsed = JSON.parse(rawBody);
+            }
+            catch {
+                throw new index_js_1.ClearBankError({
+                    message: 'Webhook body is not valid JSON',
+                    statusCode: null,
+                });
+            }
+        }
+        else {
+            parsed = rawBody;
+        }
+        if (!parsed || typeof parsed !== 'object') {
+            throw new index_js_1.ClearBankError({ message: 'Webhook body must be an object', statusCode: null });
+        }
+        const obj = parsed;
+        if (typeof obj['Type'] !== 'string' || !obj['Type']) {
+            throw new index_js_1.ClearBankError({
+                message: 'Webhook envelope missing Type field',
+                statusCode: null,
+            });
+        }
+        return {
+            Type: obj['Type'],
+            Version: typeof obj['Version'] === 'number' ? obj['Version'] : 0,
+            Nonce: typeof obj['Nonce'] === 'number' ? obj['Nonce'] : 0,
+            Payload: obj['Payload'] ?? {},
+        };
+    }
+    /**
+     * Parses the Payload of an envelope into a strongly-typed event object.
+     * Returns `null` for unknown event types (forward-compatible).
+     */
+    parseEvent(envelope, eventType) {
+        if (envelope.Type !== eventType)
+            return null;
+        return envelope.Payload;
+    }
+    /**
+     * Dispatches a webhook envelope to the appropriate handler.
+     *
+     * Only the handlers you provide are called — unhandled event types are silently
+     * ignored unless you provide `onUnknown`. This makes it easy to add handlers
+     * incrementally as you subscribe to more webhook event types.
+     *
+     * @param envelope   Parsed webhook envelope (from `parseEnvelope`).
+     * @param handlers   Object mapping event type names to handler functions.
+     */
+    async dispatch(envelope, handlers) {
+        const type = envelope.Type;
+        switch (type) {
+            case 'FITestEvent':
+                await handlers.FITestEvent?.(envelope.Payload, envelope);
+                break;
+            case 'TransactionSettled':
+                await handlers.TransactionSettled?.(envelope.Payload, envelope);
+                break;
+            case 'PaymentMessageAssessmentFailed':
+                await handlers.PaymentMessageAssessmentFailed?.(envelope.Payload, envelope);
+                break;
+            case 'PaymentMessageValidationFailed':
+                await handlers.PaymentMessageValidationFailed?.(envelope.Payload, envelope);
+                break;
+            case 'TransactionRejected':
+                await handlers.TransactionRejected?.(envelope.Payload, envelope);
+                break;
+            case 'FpsPaymentReturnCreated':
+                await handlers.FpsPaymentReturnCreated?.(envelope.Payload, envelope);
+                break;
+            case 'BacsPaymentCreated':
+                await handlers.BacsPaymentCreated?.(envelope.Payload, envelope);
+                break;
+            case 'BacsMandateCreated':
+                await handlers.BacsMandateCreated?.(envelope.Payload, envelope);
+                break;
+            case 'BacsMandateCancelled':
+                await handlers.BacsMandateCancelled?.(envelope.Payload, envelope);
+                break;
+            case 'BacsMandateMigrated':
+                await handlers.BacsMandateMigrated?.(envelope.Payload, envelope);
+                break;
+            case 'ChapsPaymentCreated':
+                await handlers.ChapsPaymentCreated?.(envelope.Payload, envelope);
+                break;
+            case 'ChapsReturnCreated':
+                await handlers.ChapsReturnCreated?.(envelope.Payload, envelope);
+                break;
+            case 'CopOutboundResponse':
+                await handlers.CopOutboundResponse?.(envelope.Payload, envelope);
+                break;
+            case 'MccyTransactionCreated':
+                await handlers.MccyTransactionCreated?.(envelope.Payload, envelope);
+                break;
+            case 'FxTradeCreated':
+                await handlers.FxTradeCreated?.(envelope.Payload, envelope);
+                break;
+            case 'FxTradeSettled':
+                await handlers.FxTradeSettled?.(envelope.Payload, envelope);
+                break;
+            case 'CustomerKycStatusChanged':
+                await handlers.CustomerKycStatusChanged?.(envelope.Payload, envelope);
+                break;
+            case 'EmbeddedAccountCreated':
+                await handlers.EmbeddedAccountCreated?.(envelope.Payload, envelope);
+                break;
+            case 'EmbeddedTransactionSettled':
+                await handlers.EmbeddedTransactionSettled?.(envelope.Payload, envelope);
+                break;
+            default:
+                await handlers.onUnknown?.(envelope);
+        }
+    }
+    /**
+     * Builds the JSON acknowledgement body to send in the webhook response.
+     * ClearBank uses the nonce to track delivered events.
+     */
+    buildAck(envelope) {
+        return { nonce: envelope.Nonce };
+    }
+}
+exports.WebhooksService = WebhooksService;
+//# sourceMappingURL=service.js.map

package/dist/cjs/domains/webhooks/service.js.map

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

package/dist/cjs/domains/webhooks/types.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildAckBody = buildAckBody;
+/** Returns the JSON body to send as the webhook acknowledgement. */
+function buildAckBody(envelope) {
+    return { nonce: envelope.Nonce };
+}
+//# sourceMappingURL=types.js.map

package/dist/cjs/domains/webhooks/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/domains/webhooks/types.ts"],"names":[],"mappings":";;AAwCA,oCAEC;AAHD,oEAAoE;AACpE,SAAgB,YAAY,CAAC,QAAyB;IACpD,OAAO,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,CAAC;AACnC,CAAC"}

package/dist/cjs/index.js

@@ -0,0 +1,73 @@
+"use strict";
+/**
+ * clearbank-sdk — Production-grade TypeScript SDK for the ClearBank UK API.
+ *
+ * @packageDocumentation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ClearBankClient = exports.formatAmount = exports.isValidIBAN = exports.isValidAccountNumber = exports.isValidSortCode = exports.isUUID = exports.generateUUID = exports.buildAckBody = exports.WebhooksService = exports.EmbeddedBankingService = exports.MultiCurrencyService = exports.PaymentsService = exports.AccountsService = exports.ClearBankError = void 0;
+const http_js_1 = require("./core/http.js");
+const config_js_1 = require("./core/config.js");
+const service_js_1 = require("./domains/accounts/service.js");
+const service_js_2 = require("./domains/payments/service.js");
+const service_js_3 = require("./domains/multicurrency/service.js");
+const service_js_4 = require("./domains/embedded/service.js");
+const service_js_5 = require("./domains/webhooks/service.js");
+var index_js_1 = require("./types/index.js");
+Object.defineProperty(exports, "ClearBankError", { enumerable: true, get: function () { return index_js_1.ClearBankError; } });
+// Domain services
+var service_js_6 = require("./domains/accounts/service.js");
+Object.defineProperty(exports, "AccountsService", { enumerable: true, get: function () { return service_js_6.AccountsService; } });
+var service_js_7 = require("./domains/payments/service.js");
+Object.defineProperty(exports, "PaymentsService", { enumerable: true, get: function () { return service_js_7.PaymentsService; } });
+var service_js_8 = require("./domains/multicurrency/service.js");
+Object.defineProperty(exports, "MultiCurrencyService", { enumerable: true, get: function () { return service_js_8.MultiCurrencyService; } });
+var service_js_9 = require("./domains/embedded/service.js");
+Object.defineProperty(exports, "EmbeddedBankingService", { enumerable: true, get: function () { return service_js_9.EmbeddedBankingService; } });
+var service_js_10 = require("./domains/webhooks/service.js");
+Object.defineProperty(exports, "WebhooksService", { enumerable: true, get: function () { return service_js_10.WebhooksService; } });
+var service_js_11 = require("./domains/webhooks/service.js");
+Object.defineProperty(exports, "buildAckBody", { enumerable: true, get: function () { return service_js_11.buildAckBody; } });
+// Utilities
+var index_js_2 = require("./utils/index.js");
+Object.defineProperty(exports, "generateUUID", { enumerable: true, get: function () { return index_js_2.generateUUID; } });
+Object.defineProperty(exports, "isUUID", { enumerable: true, get: function () { return index_js_2.isUUID; } });
+Object.defineProperty(exports, "isValidSortCode", { enumerable: true, get: function () { return index_js_2.isValidSortCode; } });
+Object.defineProperty(exports, "isValidAccountNumber", { enumerable: true, get: function () { return index_js_2.isValidAccountNumber; } });
+Object.defineProperty(exports, "isValidIBAN", { enumerable: true, get: function () { return index_js_2.isValidIBAN; } });
+Object.defineProperty(exports, "formatAmount", { enumerable: true, get: function () { return index_js_2.formatAmount; } });
+// ---------------------------------------------------------------------------
+// ClearBankClient
+// ---------------------------------------------------------------------------
+/**
+ * The top-level ClearBank API client.
+ *
+ * @example
+ * ```ts
+ * const client = new ClearBankClient({
+ *   apiToken: process.env.CLEARBANK_API_TOKEN!,
+ *   privateKey: process.env.CLEARBANK_PRIVATE_KEY!,
+ *   environment: 'simulation',
+ * });
+ *
+ * const accounts = await client.accounts.list();
+ * await client.payments.sendFPS({ accountId, payment: { ... } });
+ * ```
+ */
+class ClearBankClient {
+    constructor(config) {
+        const resolved = (0, config_js_1.resolveConfig)(config);
+        const http = new http_js_1.HttpClient(resolved);
+        this.accounts = new service_js_1.AccountsService(http);
+        this.payments = new service_js_2.PaymentsService(http);
+        this.multiCurrency = new service_js_3.MultiCurrencyService(http);
+        this.embedded = new service_js_4.EmbeddedBankingService(http);
+        this.webhooks = new service_js_5.WebhooksService();
+    }
+    static generateRequestId() {
+        return http_js_1.HttpClient.generateRequestId();
+    }
+}
+exports.ClearBankClient = ClearBankClient;
+exports.default = ClearBankClient;
+//# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH,4CAA4C;AAC5C,gDAAiD;AACjD,8DAAgE;AAChE,8DAAgE;AAChE,mEAA0E;AAC1E,8DAAuE;AACvE,8DAAgE;AAMhE,6CAAkD;AAAzC,0GAAA,cAAc,OAAA;AAgBvB,kBAAkB;AAClB,4DAAgE;AAAvD,6GAAA,eAAe,OAAA;AAkBxB,4DAAgE;AAAvD,6GAAA,eAAe,OAAA;AAoBxB,iEAA0E;AAAjE,kHAAA,oBAAoB,OAAA;AAgB7B,4DAAuE;AAA9D,oHAAA,sBAAsB,OAAA;AA0B/B,6DAAgE;AAAvD,8GAAA,eAAe,OAAA;AACxB,6DAA6D;AAApD,2GAAA,YAAY,OAAA;AA6BrB,YAAY;AACZ,6CAO0B;AANxB,wGAAA,YAAY,OAAA;AACZ,kGAAA,MAAM,OAAA;AACN,2GAAA,eAAe,OAAA;AACf,gHAAA,oBAAoB,OAAA;AACpB,uGAAA,WAAW,OAAA;AACX,wGAAA,YAAY,OAAA;AAGd,8EAA8E;AAC9E,kBAAkB;AAClB,8EAA8E;AAE9E;;;;;;;;;;;;;;GAcG;AACH,MAAa,eAAe;IAO1B,YAAY,MAAuB;QACjC,MAAM,QAAQ,GAAG,IAAA,yBAAa,EAAC,MAAM,CAAC,CAAC;QACvC,MAAM,IAAI,GAAG,IAAI,oBAAU,CAAC,QAAQ,CAAC,CAAC;QAEtC,IAAI,CAAC,QAAQ,GAAG,IAAI,4BAAe,CAAC,IAAI,CAAC,CAAC;QAC1C,IAAI,CAAC,QAAQ,GAAG,IAAI,4BAAe,CAAC,IAAI,CAAC,CAAC;QAC1C,IAAI,CAAC,aAAa,GAAG,IAAI,iCAAoB,CAAC,IAAI,CAAC,CAAC;QACpD,IAAI,CAAC,QAAQ,GAAG,IAAI,mCAAsB,CAAC,IAAI,CAAC,CAAC;QACjD,IAAI,CAAC,QAAQ,GAAG,IAAI,4BAAe,EAAE,CAAC;IACxC,CAAC;IAED,MAAM,CAAC,iBAAiB;QACtB,OAAO,oBAAU,CAAC,iBAAiB,EAAE,CAAC;IACxC,CAAC;CACF;AArBD,0CAqBC;AAED,kBAAe,eAAe,CAAC"}

package/dist/cjs/types/index.js

@@ -0,0 +1,45 @@
+"use strict";
+/**
+ * Core types shared across the ClearBank SDK.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ClearBankError = void 0;
+class ClearBankError extends Error {
+    constructor(params) {
+        super(params.message);
+        this.name = 'ClearBankError';
+        this.statusCode = params.statusCode ?? null;
+        this.code = params.code ?? null;
+        this.correlationId = params.correlationId ?? null;
+        this.requestId = params.requestId ?? null;
+        this.details = params.details ?? null;
+        this.retryAfterSeconds = params.retryAfterSeconds ?? null;
+        // Maintain proper prototype chain
+        Object.setPrototypeOf(this, ClearBankError.prototype);
+    }
+    isNotFound() {
+        return this.statusCode === 404;
+    }
+    isConflict() {
+        return this.statusCode === 409;
+    }
+    isRateLimited() {
+        return this.statusCode === 429;
+    }
+    isUnprocessable() {
+        return this.statusCode === 422;
+    }
+    isRetryable() {
+        return this.statusCode === 429 || this.statusCode === 500 || this.statusCode === 503;
+    }
+    toString() {
+        let msg = `ClearBankError [${this.statusCode ?? 'network'}]: ${this.message}`;
+        if (this.correlationId)
+            msg += ` (X-Correlation-Id: ${this.correlationId})`;
+        if (this.retryAfterSeconds)
+            msg += ` (retry after ${this.retryAfterSeconds}s)`;
+        return msg;
+    }
+}
+exports.ClearBankError = ClearBankError;
+//# sourceMappingURL=index.js.map

package/dist/cjs/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAUH,MAAa,cAAe,SAAQ,KAAK;IAQvC,YAAY,MAQX;QACC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACtB,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,IAAI,IAAI,CAAC;QAC5C,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,IAAI,CAAC;QAChC,IAAI,CAAC,aAAa,GAAG,MAAM,CAAC,aAAa,IAAI,IAAI,CAAC;QAClD,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,IAAI,CAAC;QAC1C,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,IAAI,CAAC;QACtC,IAAI,CAAC,iBAAiB,GAAG,MAAM,CAAC,iBAAiB,IAAI,IAAI,CAAC;QAC1D,kCAAkC;QAClC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,cAAc,CAAC,SAAS,CAAC,CAAC;IACxD,CAAC;IAED,UAAU;QACR,OAAO,IAAI,CAAC,UAAU,KAAK,GAAG,CAAC;IACjC,CAAC;IACD,UAAU;QACR,OAAO,IAAI,CAAC,UAAU,KAAK,GAAG,CAAC;IACjC,CAAC;IACD,aAAa;QACX,OAAO,IAAI,CAAC,UAAU,KAAK,GAAG,CAAC;IACjC,CAAC;IACD,eAAe;QACb,OAAO,IAAI,CAAC,UAAU,KAAK,GAAG,CAAC;IACjC,CAAC;IACD,WAAW;QACT,OAAO,IAAI,CAAC,UAAU,KAAK,GAAG,IAAI,IAAI,CAAC,UAAU,KAAK,GAAG,IAAI,IAAI,CAAC,UAAU,KAAK,GAAG,CAAC;IACvF,CAAC;IAEQ,QAAQ;QACf,IAAI,GAAG,GAAG,mBAAmB,IAAI,CAAC,UAAU,IAAI,SAAS,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;QAC9E,IAAI,IAAI,CAAC,aAAa;YAAE,GAAG,IAAI,uBAAuB,IAAI,CAAC,aAAa,GAAG,CAAC;QAC5E,IAAI,IAAI,CAAC,iBAAiB;YAAE,GAAG,IAAI,iBAAiB,IAAI,CAAC,iBAAiB,IAAI,CAAC;QAC/E,OAAO,GAAG,CAAC;IACb,CAAC;CACF;AAnDD,wCAmDC"}

package/dist/cjs/utils/index.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports._HttpClient = exports.HttpClient = exports.generateUUID = void 0;
+exports.isUUID = isUUID;
+exports.isValidSortCode = isValidSortCode;
+exports.isValidAccountNumber = isValidAccountNumber;
+exports.isValidIBAN = isValidIBAN;
+exports.formatAmount = formatAmount;
+var crypto_js_1 = require("../core/crypto.js");
+Object.defineProperty(exports, "generateUUID", { enumerable: true, get: function () { return crypto_js_1.generateUUID; } });
+var http_js_1 = require("../core/http.js");
+Object.defineProperty(exports, "HttpClient", { enumerable: true, get: function () { return http_js_1.HttpClient; } });
+/** Returns true if a given string is a valid UUID v4 format. */
+function isUUID(value) {
+    return /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(value);
+}
+/** Returns true if a string looks like a UK sort code (6 digits). */
+function isValidSortCode(value) {
+    return /^\d{6}$/.test(value);
+}
+/** Returns true if a string looks like a UK account number (8 digits). */
+function isValidAccountNumber(value) {
+    return /^\d{8}$/.test(value);
+}
+/** Returns true if a string looks like a valid IBAN. */
+function isValidIBAN(value) {
+    return /^[A-Z]{2}\d{2}[A-Z0-9]{1,30}$/.test(value);
+}
+/**
+ * Formats a decimal amount string for display.
+ *
+ * @example formatAmount('1234.5', 'GBP') // '£1,234.50'
+ */
+function formatAmount(amount, currency, locale = 'en-GB') {
+    const num = parseFloat(amount);
+    if (isNaN(num))
+        return amount;
+    return new Intl.NumberFormat(locale, { style: 'currency', currency }).format(num);
+}
+/**
+ * Generates a pre-flight X-Request-Id for idempotent retries.
+ * Store this before sending — use the same ID when retrying on 5XX.
+ */
+var http_js_2 = require("../core/http.js");
+Object.defineProperty(exports, "_HttpClient", { enumerable: true, get: function () { return http_js_2.HttpClient; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":";;;AAIA,wBAEC;AAGD,0CAEC;AAGD,oDAEC;AAGD,kCAEC;AAOD,oCAIC;AAhCD,+CAAiD;AAAxC,yGAAA,YAAY,OAAA;AACrB,2CAA6C;AAApC,qGAAA,UAAU,OAAA;AAEnB,gEAAgE;AAChE,SAAgB,MAAM,CAAC,KAAa;IAClC,OAAO,wEAAwE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC9F,CAAC;AAED,qEAAqE;AACrE,SAAgB,eAAe,CAAC,KAAa;IAC3C,OAAO,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC/B,CAAC;AAED,0EAA0E;AAC1E,SAAgB,oBAAoB,CAAC,KAAa;IAChD,OAAO,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC/B,CAAC;AAED,wDAAwD;AACxD,SAAgB,WAAW,CAAC,KAAa;IACvC,OAAO,+BAA+B,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACrD,CAAC;AAED;;;;GAIG;AACH,SAAgB,YAAY,CAAC,MAAc,EAAE,QAAgB,EAAE,MAAM,GAAG,OAAO;IAC7E,MAAM,GAAG,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;IAC/B,IAAI,KAAK,CAAC,GAAG,CAAC;QAAE,OAAO,MAAM,CAAC;IAC9B,OAAO,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;AACpF,CAAC;AAED;;;GAGG;AACH,2CAA4D;AAAnD,sGAAA,UAAU,OAAe"}

package/dist/esm/core/config.js

@@ -0,0 +1,22 @@
+const BASE_URLS = {
+    simulation: 'https://institution-api-sim.clearbank.co.uk',
+    production: 'https://institution-api.clearbank.co.uk',
+};
+export function resolveConfig(config) {
+    if (!config.apiToken || config.apiToken.trim() === '') {
+        throw new Error('ClearBank SDK: apiToken is required and must not be empty.');
+    }
+    const environment = config.environment ?? 'simulation';
+    const baseUrl = config.baseUrl ?? BASE_URLS[environment];
+    return {
+        apiToken: config.apiToken,
+        privateKey: config.privateKey ?? null,
+        baseUrl,
+        timeoutMs: config.timeoutMs ?? 30000,
+        maxRetries: config.maxRetries ?? 3,
+        retryBaseDelayMs: config.retryBaseDelayMs ?? 1000,
+        retryMaxDelayMs: config.retryMaxDelayMs ?? 30000,
+        telemetryHook: config.telemetryHook ?? null,
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/esm/core/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/core/config.ts"],"names":[],"mappings":"AAIA,MAAM,SAAS,GAAgC;IAC7C,UAAU,EAAE,6CAA6C;IACzD,UAAU,EAAE,yCAAyC;CAC7C,CAAC;AAkCX,MAAM,UAAU,aAAa,CAAC,MAAuB;IACnD,IAAI,CAAC,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACtD,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC;IAChF,CAAC;IAED,MAAM,WAAW,GAAgB,MAAM,CAAC,WAAW,IAAI,YAAY,CAAC;IACpE,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,SAAS,CAAC,WAAW,CAAC,CAAC;IAEzD,OAAO;QACL,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,IAAI;QACrC,OAAO;QACP,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,KAAM;QACrC,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,CAAC;QAClC,gBAAgB,EAAE,MAAM,CAAC,gBAAgB,IAAI,IAAK;QAClD,eAAe,EAAE,MAAM,CAAC,eAAe,IAAI,KAAM;QACjD,aAAa,EAAE,MAAM,CAAC,aAAa,IAAI,IAAI;KAC5C,CAAC;AACJ,CAAC"}

package/dist/esm/core/crypto.js

@@ -0,0 +1,105 @@
+/**
+ * Cryptographic utilities for the ClearBank SDK.
+ *
+ * Uses the Web Crypto API (globally available in Node.js ≥ 18 and all modern browsers).
+ * A Node.js `crypto` module fallback handles PKCS#1 RSA private keys.
+ */
+/**
+ * Generates a UUID v4 string using cryptographically secure random bytes.
+ */
+export function generateUUID() {
+    if (typeof globalThis.crypto?.randomUUID === 'function') {
+        return globalThis.crypto.randomUUID();
+    }
+    const bytes = new Uint8Array(16);
+    globalThis.crypto.getRandomValues(bytes);
+    // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+    bytes[6] = (bytes[6] & 0x0f) | 0x40;
+    // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+    bytes[8] = (bytes[8] & 0x3f) | 0x80;
+    const hex = Array.from(bytes).map((b) => b.toString(16).padStart(2, '0'));
+    return [
+        hex.slice(0, 4).join(''),
+        hex.slice(4, 6).join(''),
+        hex.slice(6, 8).join(''),
+        hex.slice(8, 10).join(''),
+        hex.slice(10, 16).join(''),
+    ].join('-');
+}
+/**
+ * Signs a request body with an RSA private key (PKCS#1 v1.5 + SHA-256).
+ * Returns Base64-encoded signature for the `DigitalSignature` header.
+ */
+export async function signRequestBody(body, privateKeyPem) {
+    const cryptoKey = await importRsaPrivateKey(privateKeyPem);
+    const bodyBytes = toArrayBuffer(new TextEncoder().encode(body));
+    const signature = await globalThis.crypto.subtle.sign({ name: 'RSASSA-PKCS1-v1_5' }, cryptoKey, bodyBytes);
+    return bytesToBase64(new Uint8Array(signature));
+}
+/**
+ * Verifies a ClearBank `DigitalSignature` against the raw body using their RSA public key.
+ */
+export async function verifySignature(body, signatureBase64, publicKeyPem) {
+    const cryptoKey = await importRsaPublicKey(publicKeyPem);
+    const bodyBytes = typeof body === 'string' ? toArrayBuffer(new TextEncoder().encode(body)) : toArrayBuffer(body);
+    const sigBytes = toArrayBuffer(base64ToUint8Array(signatureBase64));
+    return globalThis.crypto.subtle.verify({ name: 'RSASSA-PKCS1-v1_5' }, cryptoKey, sigBytes, bodyBytes);
+}
+// ---------------------------------------------------------------------------
+// Private helpers
+// ---------------------------------------------------------------------------
+async function importRsaPrivateKey(pem) {
+    try {
+        const der = pemToDer(pem);
+        return await globalThis.crypto.subtle.importKey('pkcs8', der, { name: 'RSASSA-PKCS1-v1_5', hash: 'SHA-256' }, false, ['sign']);
+    }
+    catch {
+        // Fall back to Node.js crypto for PKCS#1 (BEGIN RSA PRIVATE KEY)
+        return importPkcs1ViaNode(pem);
+    }
+}
+async function importRsaPublicKey(pem) {
+    const der = pemToDer(pem);
+    return globalThis.crypto.subtle.importKey('spki', der, { name: 'RSASSA-PKCS1-v1_5', hash: 'SHA-256' }, false, ['verify']);
+}
+/** Strips PEM headers and returns a plain ArrayBuffer. */
+function pemToDer(pem) {
+    const stripped = pem
+        .split('\n')
+        .filter((line) => !line.startsWith('-----'))
+        .join('');
+    return toArrayBuffer(base64ToUint8Array(stripped));
+}
+/**
+ * Copies a Uint8Array into a fresh ArrayBuffer.
+ * Required because TypeScript's Web Crypto types expect a plain ArrayBuffer,
+ * not an ArrayBufferLike (which includes SharedArrayBuffer).
+ */
+function toArrayBuffer(bytes) {
+    const buf = new ArrayBuffer(bytes.byteLength);
+    new Uint8Array(buf).set(bytes);
+    return buf;
+}
+/** Decodes a Base64 string to a Uint8Array. */
+function base64ToUint8Array(b64) {
+    const binary = atob(b64);
+    const bytes = new Uint8Array(binary.length);
+    for (let i = 0; i < binary.length; i++) {
+        bytes[i] = binary.charCodeAt(i);
+    }
+    return bytes;
+}
+/** Encodes a Uint8Array to a Base64 string. */
+function bytesToBase64(bytes) {
+    return btoa(Array.from(bytes, (b) => String.fromCharCode(b)).join(''));
+}
+/** Node.js fallback: convert PKCS#1 PEM to Web CryptoKey via the `crypto` built-in. */
+async function importPkcs1ViaNode(pem) {
+    const { createPrivateKey } = await import('node:crypto');
+    const nodeKey = createPrivateKey(pem);
+    const pkcs8Buffer = nodeKey.export({ type: 'pkcs8', format: 'der' });
+    // Slice into a plain ArrayBuffer to satisfy Web Crypto's strict BufferSource constraint.
+    const der = pkcs8Buffer.buffer.slice(pkcs8Buffer.byteOffset, pkcs8Buffer.byteOffset + pkcs8Buffer.byteLength);
+    return globalThis.crypto.subtle.importKey('pkcs8', der, { name: 'RSASSA-PKCS1-v1_5', hash: 'SHA-256' }, false, ['sign']);
+}
+//# sourceMappingURL=crypto.js.map

package/dist/esm/core/crypto.js.map

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