@obhco/pay 0.0.0-stage → 0.1.0

package/dist/pay.js

@@ -0,0 +1,427 @@
+import { randomBytes } from "node:crypto";
+import { PayError } from "./errors.js";
+import { digipayPaymentAdapter, mellatPaymentAdapter, sadadPaymentAdapter, zarinpalPaymentAdapter, } from "./gateways/index.js";
+import { FinanceReporter } from "./report.js";
+import { PaymentProviderError, } from "./types.js";
+const BUILT_IN_ADAPTERS = [
+    sadadPaymentAdapter,
+    zarinpalPaymentAdapter,
+    mellatPaymentAdapter,
+    digipayPaymentAdapter,
+];
+const INSTALLMENT_PURCHASE_TYPES = new Set(["BNPL", "CREDIT"]);
+function createReference() {
+    return `PAY-${randomBytes(8).toString("hex").toUpperCase()}`;
+}
+function describeError(error) {
+    return error instanceof Error ? error.message : "Unknown error";
+}
+function installmentFrom(metadata) {
+    const purchaseType = metadata.purchaseType;
+    return typeof purchaseType === "string" &&
+        INSTALLMENT_PURCHASE_TYPES.has(purchaseType)
+        ? { purchaseType, count: null }
+        : null;
+}
+export class Pay {
+    store;
+    config;
+    adapters = new Map();
+    reporter;
+    environment;
+    pendingTtlMs;
+    constructor(config) {
+        this.config = config;
+        this.store = config.store;
+        this.environment =
+            config.environment ??
+                (process.env.PAY_ENVIRONMENT?.trim().toLowerCase() === "test"
+                    ? "test"
+                    : "live");
+        this.pendingTtlMs = (config.pendingTtlMinutes ?? 30) * 60_000;
+        const requested = config.gateways ?? BUILT_IN_ADAPTERS;
+        for (const entry of requested) {
+            const adapter = typeof entry === "string"
+                ? BUILT_IN_ADAPTERS.find((candidate) => candidate.code === entry)
+                : entry;
+            if (!adapter) {
+                throw new PayError("GATEWAY_NOT_AVAILABLE", `Unknown gateway "${String(entry)}". Built-in gateways: ${BUILT_IN_ADAPTERS.map((item) => item.code).join(", ")}.`);
+            }
+            // When no explicit list is given, only configured gateways are offered.
+            if (config.gateways || adapter.isConfigured()) {
+                this.adapters.set(adapter.code, adapter);
+            }
+        }
+        this.reporter = this.createReporter(config.report);
+    }
+    createReporter(report) {
+        if (report === false) {
+            return null;
+        }
+        if (report) {
+            return new FinanceReporter(report);
+        }
+        const baseUrl = process.env.OBH_BASE_URL?.trim();
+        const secretKey = process.env.OBH_SERVICE_KEY?.trim();
+        return baseUrl && secretKey
+            ? new FinanceReporter({ baseUrl, secretKey })
+            : null;
+    }
+    /** Gateways this service can offer right now. */
+    listGateways() {
+        const fallback = this.defaultGatewayCode();
+        return [...this.adapters.values()]
+            .filter((adapter) => adapter.isConfigured())
+            .map((adapter) => ({
+            ...adapter.descriptor,
+            isDefault: adapter.code === fallback,
+        }));
+    }
+    /** Checks the OBH credential and connectivity. Throws on failure. */
+    async pingObh() {
+        if (!this.reporter) {
+            throw new PayError("REPORT_FAILED", "Finance reporting is not configured (OBH_BASE_URL / OBH_SERVICE_KEY).");
+        }
+        return this.reporter.ping();
+    }
+    defaultGatewayCode() {
+        if (this.config.defaultGateway &&
+            this.adapters.has(this.config.defaultGateway)) {
+            return this.config.defaultGateway;
+        }
+        return ([...this.adapters.values()].find((adapter) => adapter.isConfigured())
+            ?.code ?? null);
+    }
+    getAdapter(code) {
+        const resolved = code ?? this.defaultGatewayCode();
+        const adapter = resolved ? this.adapters.get(resolved) : undefined;
+        if (!adapter || !adapter.isConfigured()) {
+            throw new PayError("GATEWAY_NOT_AVAILABLE", resolved
+                ? `Gateway "${resolved}" is not enabled or has no credentials.`
+                : "No payment gateway is configured.");
+        }
+        return adapter;
+    }
+    callbackUrl(gateway) {
+        const path = (this.config.callbackPath ?? "/api/pay/{gateway}/callback")
+            .replace("{gateway}", encodeURIComponent(gateway));
+        return `${this.config.baseUrl.replace(/\/+$/, "")}${path}`;
+    }
+    /**
+     * Opens a payment session at the chosen gateway and returns where to send
+     * the customer. The attempt is stored before the gateway is called so a
+     * fast callback can always find it.
+     */
+    async start(input) {
+        const orderId = input.orderId?.trim();
+        const amount = String(input.amount).trim();
+        if (!orderId || orderId.length > 191) {
+            throw new PayError("INVALID_REQUEST", "orderId is required (max 191).");
+        }
+        if (!/^[1-9]\d{0,17}$/.test(amount)) {
+            throw new PayError("INVALID_REQUEST", "amount must be a whole Rial amount greater than zero.");
+        }
+        if (!input.description?.trim()) {
+            throw new PayError("INVALID_REQUEST", "description is required.");
+        }
+        const adapter = this.getAdapter(input.gateway);
+        const min = adapter.descriptor.minAmount;
+        if (min && BigInt(amount) < BigInt(min)) {
+            throw new PayError("INVALID_REQUEST", `${adapter.descriptor.name} requires at least ${min} Rials.`);
+        }
+        if (adapter.descriptor.requiresCustomerMobile && !input.customerMobile) {
+            throw new PayError("INVALID_REQUEST", `${adapter.descriptor.name} requires customerMobile.`);
+        }
+        const previous = await this.store.listByOrderId(orderId);
+        const now = new Date();
+        if (previous.some((record) => record.status === "completed")) {
+            throw new PayError("ORDER_ALREADY_PAID", `Order ${orderId} already has a completed payment.`);
+        }
+        // An open session for the same order, gateway and amount is resumed so a
+        // double click does not create two bank sessions.
+        const open = previous.find((record) => record.status === "pending" &&
+            record.gateway === adapter.code &&
+            record.amount === amount &&
+            record.redirect &&
+            record.expiresAt &&
+            record.expiresAt.getTime() > now.getTime());
+        if (open?.redirect) {
+            return { payment: open, redirect: open.redirect, reused: true };
+        }
+        const gatewayOrderId = await this.store.nextGatewayOrderId(adapter.code);
+        const record = {
+            reference: createReference(),
+            orderId,
+            attempt: previous.length + 1,
+            gateway: adapter.code,
+            gatewayOrderId,
+            amount,
+            currency: "IRR",
+            description: input.description.trim(),
+            status: "pending",
+            environment: this.environment,
+            returnUrl: input.returnUrl ?? null,
+            customerMobile: input.customerMobile ?? null,
+            metadata: input.metadata ?? {},
+            providerSessionId: null,
+            providerReference: null,
+            traceNumber: null,
+            maskedCardNumber: null,
+            resultCode: null,
+            resultText: null,
+            installment: null,
+            redirect: null,
+            callbackPayload: null,
+            createdAt: now,
+            expiresAt: null,
+            callbackReceivedAt: null,
+            completedAt: null,
+            failedAt: null,
+            reportedStatus: null,
+            reportedAt: null,
+        };
+        await this.store.insert(record);
+        try {
+            const session = await adapter.createCheckoutSession({
+                paymentReference: record.reference,
+                gatewayOrderId,
+                serviceSlug: this.config.service,
+                amount,
+                currency: "IRR",
+                description: record.description,
+                returnUrl: record.returnUrl,
+                callbackUrl: this.callbackUrl(adapter.code),
+                metadata: record.metadata,
+                customerMobile: record.customerMobile,
+            });
+            const redirect = session.redirect ??
+                (session.checkoutUrl
+                    ? { method: "GET", url: session.checkoutUrl }
+                    : (() => {
+                        throw new PayError("GATEWAY_ERROR", `${adapter.descriptor.name} returned no checkout URL.`);
+                    })());
+            const payment = await this.store.update(record.reference, {
+                providerSessionId: session.providerSessionId,
+                providerReference: session.providerReference,
+                redirect,
+                expiresAt: session.expiresAt,
+                resultCode: session.resultCode,
+                resultText: session.resultMessage,
+            });
+            // Fire and forget: opening a session must not wait on OBH.
+            void this.report(payment);
+            return { payment, redirect, reused: false };
+        }
+        catch (error) {
+            const text = error instanceof PaymentProviderError || error instanceof PayError
+                ? error.message
+                : "Could not open a payment session.";
+            const failed = await this.store.transition(record.reference, "pending", {
+                status: "failed",
+                failedAt: new Date(),
+                resultCode: error instanceof PaymentProviderError
+                    ? (error.resultCode ?? null)
+                    : null,
+                resultText: text,
+            });
+            if (failed) {
+                await this.report(failed);
+            }
+            if (error instanceof PayError) {
+                throw error;
+            }
+            throw new PayError("GATEWAY_ERROR", text, {
+                gateway: adapter.code,
+                reference: record.reference,
+            });
+        }
+    }
+    /**
+     * Processes the request the bank sends the customer back with: finds the
+     * payment, verifies it server-to-server and records the outcome. Safe to
+     * call twice; the second call returns the final payment unchanged.
+     */
+    async handleCallback(gateway, payload) {
+        const adapter = this.getAdapter(gateway);
+        const parsed = adapter.parseCallback(payload);
+        let payment = null;
+        if (parsed.sessionId) {
+            payment = await this.store.findBySessionId(gateway, parsed.sessionId);
+        }
+        if (!payment && !parsed.sessionId && parsed.gatewayOrderId) {
+            payment = await this.store.findByGatewayOrderId(gateway, parsed.gatewayOrderId);
+        }
+        if (!payment && parsed.sessionId && parsed.gatewayOrderId) {
+            // Sadad can omit the token; the order number is then the only key.
+            payment = await this.store.findByGatewayOrderId(gateway, parsed.gatewayOrderId);
+        }
+        if (!payment) {
+            throw new PayError("PAYMENT_NOT_FOUND", "Payment was not found.");
+        }
+        if (parsed.gatewayOrderId &&
+            parsed.gatewayOrderId !== payment.gatewayOrderId) {
+            throw new PayError("ORDER_MISMATCH", "Callback order number does not match the stored payment.");
+        }
+        if (payment.status !== "pending") {
+            return { payment, replayed: true };
+        }
+        const now = new Date();
+        payment = await this.store.update(payment.reference, {
+            callbackReceivedAt: payment.callbackReceivedAt ?? now,
+            maskedCardNumber: parsed.maskedCardNumber ?? payment.maskedCardNumber,
+            providerReference: parsed.providerReference ?? payment.providerReference,
+            resultCode: parsed.resultCode,
+            resultText: parsed.resultText,
+            callbackPayload: parsed.payload,
+        });
+        if (parsed.outcome === "failed") {
+            return this.finish(payment, {
+                status: "failed",
+                failedAt: now,
+                resultCode: parsed.resultCode,
+                resultText: parsed.resultText,
+            });
+        }
+        return this.verify(payment);
+    }
+    /** Verifies a pending payment with the gateway and records the result. */
+    async verify(payment) {
+        const adapter = this.getAdapter(payment.gateway);
+        let verification;
+        try {
+            verification = await adapter.verifyPayment({
+                providerSessionId: payment.providerSessionId,
+                providerReference: payment.providerReference,
+                gatewayOrderId: payment.gatewayOrderId,
+                expectedAmount: payment.amount,
+                payload: payment.callbackPayload ?? undefined,
+            });
+        }
+        catch (error) {
+            // Not proof of failure; leave it pending so reconcile() retries.
+            await this.store.update(payment.reference, {
+                resultText: `Verify could not complete: ${describeError(error)}`,
+            });
+            return { payment: (await this.store.findByReference(payment.reference)) ?? payment, replayed: false };
+        }
+        if (verification.status === "PENDING") {
+            const updated = await this.store.update(payment.reference, {
+                resultCode: verification.resultCode,
+                resultText: verification.resultMessage,
+            });
+            return { payment: updated, replayed: false };
+        }
+        const verifiedAmount = verification.verifiedAmount;
+        if (verification.status === "COMPLETED" &&
+            verifiedAmount !== null &&
+            verifiedAmount !== payment.amount) {
+            // The bank settled a different amount than we asked for. Never mark it
+            // paid; keep the evidence on the failed record for manual review.
+            return this.finish(payment, {
+                status: "failed",
+                failedAt: new Date(),
+                resultCode: verification.resultCode,
+                resultText: `Amount mismatch: expected ${payment.amount}, bank verified ${verifiedAmount}.`,
+                providerReference: verification.providerReference,
+                traceNumber: verification.traceNumber,
+            });
+        }
+        const at = verification.verifiedAt ?? new Date();
+        const completed = verification.status === "COMPLETED";
+        return this.finish(payment, {
+            status: completed ? "completed" : "failed",
+            completedAt: completed ? at : null,
+            failedAt: completed ? null : at,
+            providerReference: verification.providerReference,
+            traceNumber: verification.traceNumber,
+            maskedCardNumber: verification.maskedCardNumber ?? payment.maskedCardNumber,
+            resultCode: verification.resultCode,
+            resultText: verification.resultMessage,
+            installment: completed ? installmentFrom(verification.metadata) : null,
+        });
+    }
+    async finish(payment, patch) {
+        const updated = await this.store.transition(payment.reference, "pending", patch);
+        if (!updated) {
+            // Another request finished it first; return whatever it recorded.
+            const current = await this.store.findByReference(payment.reference);
+            return { payment: current ?? payment, replayed: true };
+        }
+        await this.report(updated);
+        return { payment: updated, replayed: false };
+    }
+    async get(reference) {
+        return this.store.findByReference(reference);
+    }
+    /**
+     * Verifies a still-pending payment again, now. Use it when the customer
+     * is back (result page, "check again") and the first verify did not come
+     * back with an answer. Only payments whose bank callback arrived are
+     * verified; anything else is returned unchanged.
+     */
+    async recheck(reference) {
+        const payment = await this.store.findByReference(reference);
+        if (!payment || payment.status !== "pending" || !payment.callbackReceivedAt) {
+            return payment;
+        }
+        return (await this.verify(payment)).payment;
+    }
+    /**
+     * Housekeeping to run every few minutes (cron, queue, or a scheduled
+     * route): expires abandoned sessions, retries verifies that hit a network
+     * error, and re-sends reports OBH has not acknowledged.
+     */
+    async reconcile(limit = 100) {
+        const summary = { expired: 0, reverified: 0, reported: 0 };
+        const cutoff = new Date(Date.now() - 2 * 60_000);
+        for (const payment of await this.store.listPending(cutoff, limit)) {
+            if (payment.callbackReceivedAt) {
+                const result = await this.verify(payment);
+                if (result.payment.status !== "pending") {
+                    summary.reverified += 1;
+                }
+                continue;
+            }
+            const age = Date.now() - payment.createdAt.getTime();
+            if (age >= this.pendingTtlMs) {
+                const expired = await this.store.transition(payment.reference, "pending", {
+                    status: "expired",
+                    failedAt: new Date(),
+                    resultText: "No gateway callback was received before expiry.",
+                });
+                if (expired) {
+                    summary.expired += 1;
+                    await this.report(expired);
+                }
+            }
+        }
+        for (const payment of await this.store.listUnreported(limit)) {
+            if (await this.report(payment)) {
+                summary.reported += 1;
+            }
+        }
+        return summary;
+    }
+    /** Sends one snapshot to OBH. Returns true when OBH acknowledged it. */
+    async report(payment) {
+        if (!this.reporter) {
+            return false;
+        }
+        try {
+            await this.reporter.sendPayment(payment);
+            await this.store.update(payment.reference, {
+                reportedStatus: payment.status,
+                reportedAt: new Date(),
+            });
+            return true;
+        }
+        catch (error) {
+            this.config.onReportError?.(error, payment);
+            return false;
+        }
+    }
+}
+export function createPay(config) {
+    return new Pay(config);
+}
+//# sourceMappingURL=pay.js.map

package/dist/pay.js.map

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

package/dist/report.d.ts

@@ -0,0 +1,71 @@
+import type { PaymentRecord } from "./store.js";
+/**
+ * Finance event contract between a service and OBH. The payload is a full
+ * snapshot of one payment attempt, so OBH can upsert it by
+ * `(service, reference)`; a missed, duplicated or reordered event never
+ * leaves the books wrong, it only delays them until the next snapshot.
+ */
+export type PaymentSnapshot = {
+    reference: string;
+    orderId: string;
+    attempt: number;
+    gateway: string;
+    gatewayOrderId: string;
+    /** Whole Rials as a digit string. */
+    amount: string;
+    currency: "IRR";
+    status: PaymentRecord["status"];
+    environment: PaymentRecord["environment"];
+    description: string;
+    providerReference: string | null;
+    traceNumber: string | null;
+    maskedCardNumber: string | null;
+    resultCode: number | null;
+    resultText: string | null;
+    installment: PaymentRecord["installment"];
+    createdAt: string;
+    callbackReceivedAt: string | null;
+    completedAt: string | null;
+    failedAt: string | null;
+    /** Only present when the service opts in with `includeMetadata`. */
+    metadata?: Record<string, unknown>;
+};
+export type FinanceEvent = {
+    type: "payment.snapshot";
+    /** Stable per reference and status, so retries are deduplicated. */
+    eventId: string;
+    sentAt: string;
+    data: PaymentSnapshot;
+};
+export type ReporterOptions = {
+    /** OBH origin, e.g. `https://obhco.ir`. */
+    baseUrl: string;
+    /** Service credential in `keyId.secret` form. Server-side only. */
+    secretKey: string;
+    timeoutMs?: number;
+    /** Send `metadata` with each snapshot. Off by default to keep PII out. */
+    includeMetadata?: boolean;
+    fetch?: typeof fetch;
+};
+export type PingResult = {
+    ok: true;
+    service: {
+        slug: string;
+        name: string;
+    };
+};
+export declare function toSnapshot(record: PaymentRecord, includeMetadata?: boolean): PaymentSnapshot;
+export declare class FinanceReporter {
+    private readonly baseUrl;
+    private readonly secretKey;
+    private readonly timeoutMs;
+    private readonly includeMetadata;
+    private readonly fetchImpl;
+    constructor(options: ReporterOptions);
+    /** Sends one payment snapshot. Throws a `PayError` when OBH rejects it. */
+    sendPayment(record: PaymentRecord): Promise<void>;
+    /** Checks the credential and connectivity without sending any data. */
+    ping(): Promise<PingResult>;
+    private request;
+}
+//# sourceMappingURL=report.d.ts.map

package/dist/report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../src/report.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAE/C;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,cAAc,EAAE,MAAM,CAAA;IACtB,qCAAqC;IACrC,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,KAAK,CAAA;IACf,MAAM,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAA;IAC/B,WAAW,EAAE,aAAa,CAAC,aAAa,CAAC,CAAA;IACzC,WAAW,EAAE,MAAM,CAAA;IACnB,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAA;IAChC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAA;IAC/B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,WAAW,EAAE,aAAa,CAAC,aAAa,CAAC,CAAA;IACzC,SAAS,EAAE,MAAM,CAAA;IACjB,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAA;IACjC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,oEAAoE;IACpE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACnC,CAAA;AAED,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,kBAAkB,CAAA;IACxB,oEAAoE;IACpE,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,eAAe,CAAA;CACtB,CAAA;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,2CAA2C;IAC3C,OAAO,EAAE,MAAM,CAAA;IACf,mEAAmE;IACnE,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,0EAA0E;IAC1E,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,KAAK,CAAC,EAAE,OAAO,KAAK,CAAA;CACrB,CAAA;AAED,MAAM,MAAM,UAAU,GAAG;IACvB,EAAE,EAAE,IAAI,CAAA;IACR,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;CACxC,CAAA;AAED,wBAAgB,UAAU,CACxB,MAAM,EAAE,aAAa,EACrB,eAAe,UAAQ,GACtB,eAAe,CA0BjB;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAQ;IAChC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAQ;IAClC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAQ;IAClC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAc;gBAE5B,OAAO,EAAE,eAAe;IAcpC,2EAA2E;IACrE,WAAW,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAWvD,uEAAuE;IACjE,IAAI,IAAI,OAAO,CAAC,UAAU,CAAC;YAInB,OAAO;CAiEtB"}

package/dist/report.js

@@ -0,0 +1,106 @@
+import { PayError } from "./errors.js";
+export function toSnapshot(record, includeMetadata = false) {
+    const iso = (value) => (value ? value.toISOString() : null);
+    return {
+        reference: record.reference,
+        orderId: record.orderId,
+        attempt: record.attempt,
+        gateway: record.gateway,
+        gatewayOrderId: record.gatewayOrderId,
+        amount: record.amount,
+        currency: record.currency,
+        status: record.status,
+        environment: record.environment,
+        description: record.description,
+        providerReference: record.providerReference,
+        traceNumber: record.traceNumber,
+        maskedCardNumber: record.maskedCardNumber,
+        resultCode: record.resultCode,
+        resultText: record.resultText,
+        installment: record.installment,
+        createdAt: record.createdAt.toISOString(),
+        callbackReceivedAt: iso(record.callbackReceivedAt),
+        completedAt: iso(record.completedAt),
+        failedAt: iso(record.failedAt),
+        ...(includeMetadata ? { metadata: record.metadata } : {}),
+    };
+}
+export class FinanceReporter {
+    baseUrl;
+    secretKey;
+    timeoutMs;
+    includeMetadata;
+    fetchImpl;
+    constructor(options) {
+        if (!options.baseUrl || !options.secretKey) {
+            throw new PayError("REPORT_FAILED", "Finance reporting needs both baseUrl and secretKey.");
+        }
+        this.baseUrl = options.baseUrl.replace(/\/+$/, "");
+        this.secretKey = options.secretKey;
+        this.timeoutMs = options.timeoutMs ?? 8_000;
+        this.includeMetadata = options.includeMetadata ?? false;
+        this.fetchImpl = options.fetch ?? fetch;
+    }
+    /** Sends one payment snapshot. Throws a `PayError` when OBH rejects it. */
+    async sendPayment(record) {
+        const event = {
+            type: "payment.snapshot",
+            eventId: `${record.reference}:${record.status}`,
+            sentAt: new Date().toISOString(),
+            data: toSnapshot(record, this.includeMetadata),
+        };
+        await this.request("POST", "/api/v1/finance/events", event, event.eventId);
+    }
+    /** Checks the credential and connectivity without sending any data. */
+    async ping() {
+        return (await this.request("GET", "/api/v1/finance/ping"));
+    }
+    async request(method, path, body, idempotencyKey) {
+        let lastError;
+        for (let attempt = 0; attempt < 3; attempt += 1) {
+            const controller = new AbortController();
+            const timer = setTimeout(() => controller.abort(), this.timeoutMs);
+            try {
+                const response = await this.fetchImpl(`${this.baseUrl}${path}`, {
+                    method,
+                    headers: {
+                        Accept: "application/json",
+                        Authorization: `Bearer ${this.secretKey}`,
+                        ...(body === undefined
+                            ? {}
+                            : { "Content-Type": "application/json" }),
+                        ...(idempotencyKey ? { "Idempotency-Key": idempotencyKey } : {}),
+                    },
+                    body: body === undefined ? undefined : JSON.stringify(body),
+                    signal: controller.signal,
+                });
+                if (response.ok) {
+                    return (await response.json().catch(() => ({})));
+                }
+                // 4xx other than 429 will not succeed on retry.
+                if (response.status < 500 && response.status !== 429) {
+                    const text = await response.text().catch(() => "");
+                    throw new PayError("REPORT_FAILED", `OBH rejected the report (HTTP ${response.status}).`, { status: response.status, body: text.slice(0, 500) });
+                }
+                lastError = new PayError("REPORT_FAILED", `OBH was unavailable (HTTP ${response.status}).`, { status: response.status });
+            }
+            catch (error) {
+                if (error instanceof PayError && error.details?.status) {
+                    const status = Number(error.details.status);
+                    if (status < 500 && status !== 429) {
+                        throw error;
+                    }
+                }
+                lastError = error;
+            }
+            finally {
+                clearTimeout(timer);
+            }
+            await new Promise((resolve) => setTimeout(resolve, 300 * (attempt + 1)));
+        }
+        throw lastError instanceof PayError
+            ? lastError
+            : new PayError("REPORT_FAILED", "Could not reach OBH to report.");
+    }
+}
+//# sourceMappingURL=report.js.map

package/dist/report.js.map

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