cata-centavo 0.1.0

package/dist/pluggy/client.js

@@ -0,0 +1,123 @@
+import { failureFor, parse, readJson, ResponseShapeError } from "./errors.js";
+import { toAccount, toBill, toConnection, toConsent, toTransaction } from "./mapper.js";
+import { createTransport } from "./transport.js";
+import { ACCOUNT, ACCOUNT_PAGE, BILL_PAGE, CONSENT_PAGE, ITEM, TRANSACTION_PAGE } from "./wire.js";
+const MAX_TRANSACTION_HOPS = 500;
+function createTransactionWalker(get) {
+    return async (account) => {
+        const transactions = [];
+        const seenIds = new Set();
+        let query = `?accountId=${encodeURIComponent(account.id)}`;
+        for (let hop = 0; hop < MAX_TRANSACTION_HOPS; hop += 1) {
+            const page = await get(`/v2/transactions${query}`, TRANSACTION_PAGE, `transactions ${account.id}`);
+            for (const row of page.results) {
+                if (seenIds.has(row.id)) {
+                    throw new ResponseShapeError(`Transaction ${row.id} was already seen while walking ${account.id}`);
+                }
+                seenIds.add(row.id);
+                transactions.push(toTransaction(row, account));
+            }
+            if (page.next === null) {
+                return transactions;
+            }
+            if (page.next === query) {
+                throw new ResponseShapeError(`The cursor stopped advancing while walking ${account.id}`);
+            }
+            query = page.next;
+        }
+        throw new ResponseShapeError(`Walking ${account.id} exceeded ${MAX_TRANSACTION_HOPS} pages without reaching the end`);
+    };
+}
+function newestBillFirst(left, right) {
+    if (left.closingDate === null) {
+        if (right.closingDate !== null) {
+            return 1;
+        }
+    }
+    else if (right.closingDate === null) {
+        return -1;
+    }
+    else {
+        const closingDateOrder = right.closingDate.localeCompare(left.closingDate);
+        if (closingDateOrder !== 0) {
+            return closingDateOrder;
+        }
+    }
+    return right.dueDate.localeCompare(left.dueDate);
+}
+/**
+ * The Pluggy client, written rather than taken from `pluggy-sdk`.
+ *
+ * The SDK resolves the key lazily and checks the JWT already, so the ADR's
+ * original complaint does not apply to it. What it has no way to offer is a
+ * margin, a single-flight, a 401 retry or a rate limiter, because the key cache
+ * is private instance state and the send function is not ours. ADR §15 Phase 0
+ * records the whole comparison. All four live in `transport.ts`; what is left
+ * here is the vocabulary of connections.
+ *
+ * Construction performs no I/O (§16.2).
+ */
+// eslint-disable-next-line max-lines-per-function -- a factory that assembles and returns one object, not logic to cut apart
+export function createPluggyClient(options) {
+    const transport = createTransport(options);
+    async function get(path, schema, describe) {
+        const response = await transport.authorized("GET", path);
+        if (!response.ok) {
+            throw await failureFor(response, describe);
+        }
+        return parse(schema, await readJson(response), describe);
+    }
+    const walkTransactions = createTransactionWalker(get);
+    return {
+        verifyCredentials: async () => {
+            await transport.key();
+        },
+        getConnection: async (id) => {
+            const item = await get(`/items/${encodeURIComponent(id)}`, ITEM, `connection ${id}`);
+            return toConnection(item);
+        },
+        getAccounts: async (connectionId) => {
+            const encodedConnectionId = encodeURIComponent(connectionId);
+            const [item, firstPage] = await Promise.all([
+                get(`/items/${encodedConnectionId}`, ITEM, `connection ${connectionId}`),
+                get(`/accounts?itemId=${encodedConnectionId}&pageSize=500&page=1`, ACCOUNT_PAGE, `accounts ${connectionId}`),
+            ]);
+            const connection = toConnection(item);
+            const pages = await Promise.all(Array.from({ length: firstPage.totalPages - 1 }, (_, index) => get(`/accounts?itemId=${encodedConnectionId}&pageSize=500&page=${index + 2}`, ACCOUNT_PAGE, `accounts ${connectionId}`)));
+            return [firstPage, ...pages].flatMap((page) => page.results.map((account) => toAccount(account, connection)));
+        },
+        getAccount: async (accountId) => {
+            const account = await get(`/accounts/${encodeURIComponent(accountId)}`, ACCOUNT, `account ${accountId}`);
+            const item = await get(`/items/${encodeURIComponent(account.itemId)}`, ITEM, `connection ${account.itemId}`);
+            return toAccount(account, toConnection(item));
+        },
+        getTransactions: (account) => walkTransactions(account),
+        getBills: async (account) => {
+            const encodedAccountId = encodeURIComponent(account.id);
+            const firstPage = await get(`/bills?accountId=${encodedAccountId}&pageSize=500&page=1`, BILL_PAGE, `bills ${account.id}`);
+            const pages = await Promise.all(Array.from({ length: firstPage.totalPages - 1 }, (_, index) => get(`/bills?accountId=${encodedAccountId}&pageSize=500&page=${index + 2}`, BILL_PAGE, `bills ${account.id}`)));
+            const seenIds = new Set();
+            const bills = [];
+            for (const page of [firstPage, ...pages]) {
+                for (const row of page.results) {
+                    if (seenIds.has(row.id)) {
+                        throw new ResponseShapeError(`Bill ${row.id} was already seen while walking ${account.id}`);
+                    }
+                    seenIds.add(row.id);
+                    bills.push(toBill(row, account));
+                }
+            }
+            return bills.sort(newestBillFirst);
+        },
+        getConsent: async (connectionId) => {
+            const encodedConnectionId = encodeURIComponent(connectionId);
+            const page = await get(`/consents?itemId=${encodedConnectionId}`, CONSENT_PAGE, `consent ${connectionId}`);
+            const [first] = page.results;
+            if (first === undefined) {
+                return null;
+            }
+            return toConsent(first);
+        },
+    };
+}
+//# sourceMappingURL=client.js.map

package/dist/pluggy/client.js.map

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

package/dist/pluggy/errors.js

@@ -0,0 +1,152 @@
+import { API_ERROR } from "./wire.js";
+/**
+ * Typed failures from the Pluggy boundary, and the translation from a response
+ * into one of them.
+ *
+ * They exist because ADR §16.4 requires deciding *per failure* between a
+ * protocol error and readable `isError` tool content, and that decision needs
+ * something to switch on. Anything the model should recover from — a revoked
+ * consent, an unknown connection — has to arrive as a distinguishable type
+ * rather than as a status code buried in a string.
+ *
+ * The translation lives here rather than beside either caller because both the
+ * transport and the client need it: a refused `POST /auth` and a refused
+ * `GET /items/{id}` are the same failure wearing different sentences.
+ *
+ * No constructor here performs I/O and nothing calls `process.exit` (§16.2).
+ */
+export class PluggyError extends Error {
+    status;
+    kind;
+    constructor(message, kind, status) {
+        super(message);
+        this.name = new.target.name;
+        this.kind = kind;
+        this.status = status;
+    }
+}
+/** Credentials refused, or a key that could not be renewed. */
+export class AuthError extends PluggyError {
+    constructor(message, status) {
+        super(message, "auth", status);
+    }
+}
+/** The resource does not exist, or belongs to another Pluggy account. */
+export class NotFoundError extends PluggyError {
+    constructor(message, status) {
+        super(message, "unknown-connection", status);
+    }
+}
+/** Rate limited. Recoverable by waiting; see the limiter in `transport.ts`. */
+export class RateLimitError extends PluggyError {
+    constructor(message, status) {
+        super(message, "rate-limited", status);
+    }
+}
+/** Any other non-2xx response. */
+export class HttpError extends PluggyError {
+    constructor(message, status) {
+        super(message, "unavailable", status);
+    }
+}
+/**
+ * A 2xx body that does not match what we expected. Separate from `HttpError`
+ * because it means Pluggy changed, not that the request was wrong — the case
+ * Phase 0.5 step 5 warns about, where trusting a shape we never checked deletes
+ * the evidence before a human sees it.
+ */
+export class ResponseShapeError extends PluggyError {
+    constructor(message, status) {
+        super(message, "bad-response", status);
+    }
+}
+/** Turns a thrown boundary error into the core's portable failure contract. */
+export function toFailure(error) {
+    if (error instanceof PluggyError) {
+        return { kind: error.kind, message: error.message };
+    }
+    return { kind: "unavailable", message: String(error) };
+}
+/**
+ * Which failure this is, decided once. §16.4 requires choosing per case between
+ * a protocol error and readable tool content, and that choice needs these to be
+ * distinguishable rather than a status code inside a message.
+ */
+export function classify(status, describe, detail = null) {
+    if (status === 401 || status === 403) {
+        return new AuthError(`Pluggy refused the request while ${describe} — check PLUGGY_CLIENT_ID and PLUGGY_CLIENT_SECRET`, status);
+    }
+    if (status === 404) {
+        return new NotFoundError("not found — wrong id, or an id belonging to another Pluggy account", status);
+    }
+    if (status === 429) {
+        return new RateLimitError(`Pluggy rate limited the request while ${describe}`, status);
+    }
+    return new HttpError(`Pluggy returned ${status} while ${describe}${because(detail)}`, status);
+}
+function because(detail) {
+    if (detail === null) {
+        return "";
+    }
+    return ` — ${detail}`;
+}
+/**
+ * The failure with Pluggy's own explanation attached, when it gave one. A 404
+ * already has a better sentence than Pluggy's, so that one keeps ours.
+ */
+export async function failureFor(response, describe) {
+    let detail;
+    if (response.status === 404) {
+        detail = null;
+    }
+    else {
+        detail = await readErrorDetail(response);
+    }
+    return classify(response.status, describe, detail);
+}
+export async function readErrorDetail(response) {
+    const parsed = API_ERROR.safeParse(await readJsonOrNull(response));
+    if (parsed.success) {
+        return detailOf(parsed.data);
+    }
+    return null;
+}
+function detailOf(error) {
+    const parts = [error.codeDescription, error.message, retryHint(error.data?.canRetryAfterDate)];
+    const detail = parts.filter((part) => part !== null && part !== undefined).join(": ");
+    if (detail === "") {
+        return null;
+    }
+    return detail;
+}
+function retryHint(at) {
+    if (at === null || at === undefined) {
+        return null;
+    }
+    return `retry after ${at}`;
+}
+async function readJsonOrNull(response) {
+    try {
+        return await response.json();
+    }
+    catch {
+        return null;
+    }
+}
+export async function readJson(response) {
+    try {
+        return await response.json();
+    }
+    catch {
+        throw new ResponseShapeError("Pluggy returned a body that is not JSON", response.status);
+    }
+}
+export function parse(schema, body, describe) {
+    const result = schema.safeParse(body);
+    if (!result.success) {
+        const where = result.error.issues.map((issue) => issue.path.join(".") || "(root)").join(", ");
+        throw new ResponseShapeError(`${describe} did not match the shape we expect, at: ${where}`);
+    }
+    return result.data;
+}
+//# sourceMappingURL=errors.js.map

package/dist/pluggy/errors.js.map

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

package/dist/pluggy/mapper.js

@@ -0,0 +1,155 @@
+import { ACCOUNT_TYPES } from "../core/account.js";
+import { ResponseShapeError } from "./errors.js";
+import { toCents } from "./money.js";
+export { toCents } from "./money.js";
+export { toTransaction } from "./transaction-mapper.js";
+/**
+ * Where Pluggy's vocabulary stops and ours begins (ADR §14.0). An *item* is a
+ * connection, and no domain type past this file mentions the other word.
+ *
+ * This is also the only place that knows dates arrive as strings, since we
+ * parse the raw body rather than going through the SDK's date reviver.
+ */
+export function toConnection(item) {
+    let lastUpdatedAt;
+    if (item.lastUpdatedAt === null) {
+        lastUpdatedAt = null;
+    }
+    else {
+        lastUpdatedAt = new Date(item.lastUpdatedAt);
+    }
+    return {
+        id: item.id,
+        institution: item.connector.name,
+        status: item.status,
+        executionStatus: item.executionStatus ?? null,
+        lastUpdatedAt,
+        parameter: item.parameter?.label ?? null,
+        warnings: toWarnings(item.statusDetail),
+        failedLogins: item.consecutiveFailedLoginAttempts ?? null,
+    };
+}
+/** The consent's own `itemId` never reaches this function; see `wire.ts`. */
+export function toConsent(consent) {
+    return {
+        expiresAt: toNullableDate(consent.expiresAt),
+        revokedAt: toNullableDate(consent.revokedAt),
+        products: consent.products ?? [],
+    };
+}
+function toNullableDate(value) {
+    if (value === null || value === undefined) {
+        return null;
+    }
+    return new Date(value);
+}
+/** Maps Pluggy's account vocabulary and raw monetary values onto our domain. */
+export function toAccount(account, connection) {
+    let credit;
+    if (account.type === ACCOUNT_TYPES.credit) {
+        credit = toCreditDetails(account.creditData);
+    }
+    else {
+        credit = null;
+    }
+    return {
+        id: account.id,
+        connectionId: connection.id,
+        institution: connection.institution,
+        name: account.marketingName ?? account.name,
+        type: toAccountType(account.type),
+        subtype: account.subtype ?? null,
+        amountCents: toCents(account.balance),
+        currency: account.currencyCode,
+        lastUpdatedAt: connection.lastUpdatedAt,
+        credit,
+    };
+}
+/** Maps Pluggy's bill body onto our statement vocabulary. */
+export function toBill(bill, account) {
+    return {
+        id: bill.id,
+        closingDate: utcDayOrNull(bill.billClosingDate),
+        dueDate: utcDayOf(bill.dueDate),
+        totalCents: toCents(bill.totalAmount),
+        currency: bill.totalAmountCurrencyCode ?? account.currency,
+        minimumPaymentCents: toNullableCents(bill.minimumPaymentAmount),
+        financeChargesCents: sumAmounts(bill.financeCharges),
+        paymentsCents: sumAmounts(bill.payments),
+        paymentCount: bill.payments.length,
+    };
+}
+function utcDayOrNull(value) {
+    if (value === null || value === undefined) {
+        return null;
+    }
+    return utcDayOf(value);
+}
+function utcDayOf(value) {
+    const date = new Date(value);
+    if (Number.isNaN(date.getTime())) {
+        throw new ResponseShapeError(`Pluggy returned an invalid bill date: ${value}`);
+    }
+    const year = date.getUTCFullYear();
+    const month = String(date.getUTCMonth() + 1).padStart(2, "0");
+    const day = String(date.getUTCDate()).padStart(2, "0");
+    return `${year}-${month}-${day}`;
+}
+function sumAmounts(rows) {
+    return rows.reduce((sum, row) => sum + toCents(row.amount), 0);
+}
+function toAccountType(type) {
+    if (type === ACCOUNT_TYPES.bank || type === ACCOUNT_TYPES.credit) {
+        return type;
+    }
+    throw new ResponseShapeError(`Pluggy returned an unrecognised account type: ${type}`);
+}
+/**
+ * Selects the limit the cardholder actually has. Pluggy's available amount can
+ * be based on a customized limit rather than the bank's headline limit.
+ */
+function toLimitCents(creditData) {
+    const total = creditData.disaggregatedCreditLimits?.find((line) => line.creditLineLimitType === "LIMITE_CREDITO_TOTAL");
+    return toNullableCents(total?.customizedLimitAmount ?? creditData.creditLimit);
+}
+function toCreditDetails(creditData) {
+    if (creditData === null || creditData === undefined) {
+        return null;
+    }
+    return {
+        limitCents: toLimitCents(creditData),
+        availableLimitCents: toNullableCents(creditData.availableCreditLimit),
+        balanceCloseDate: toDate(creditData.balanceCloseDate),
+        balanceDueDate: toDate(creditData.balanceDueDate),
+        brand: creditData.brand ?? null,
+    };
+}
+function toNullableCents(value) {
+    if (value === null || value === undefined) {
+        return null;
+    }
+    return toCents(value);
+}
+function toDate(value) {
+    if (value === null || value === undefined || /^\d{4}-\d{2}$/.test(value)) {
+        return null;
+    }
+    const parsed = new Date(value);
+    if (Number.isNaN(parsed.getTime())) {
+        return null;
+    }
+    return parsed;
+}
+/**
+ * `statusDetail` is keyed by product, and a `PARTIAL_SUCCESS` puts the reason one
+ * product went unrefreshed in its `warnings`. Flattened with the product name in
+ * front, because "credit card bills hit their monthly quota" is the useful
+ * sentence and "the monthly quota was reached" on its own is not.
+ */
+function toWarnings(statusDetail) {
+    if (statusDetail === null || statusDetail === undefined) {
+        return [];
+    }
+    return Object.entries(statusDetail).flatMap(([product, detail]) => (detail?.warnings ?? []).map((warning) => `${product}: ${warning.message}`));
+}
+//# sourceMappingURL=mapper.js.map

package/dist/pluggy/mapper.js.map

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

package/dist/pluggy/money.js

@@ -0,0 +1,53 @@
+function parseDecimalDigits(value) {
+    const representation = Math.abs(value).toString();
+    const match = /^(\d+)(?:\.(\d+))?(?:e([+-]?\d+))?$/.exec(representation);
+    if (match === null) {
+        throw new Error(`Cannot parse numeric value: ${representation}`);
+    }
+    const integerDigits = match[1] ?? "0";
+    const fractionDigits = match[2] ?? "";
+    const exponent = Number(match[3] ?? "0");
+    return {
+        coefficient: BigInt(`${integerDigits}${fractionDigits}`),
+        decimalPlaces: fractionDigits.length - exponent,
+    };
+}
+function roundDecimalCents({ coefficient, decimalPlaces }) {
+    if (decimalPlaces <= 2) {
+        return coefficient * 10n ** BigInt(2 - decimalPlaces);
+    }
+    const divisor = 10n ** BigInt(decimalPlaces - 2);
+    const whole = coefficient / divisor;
+    const remainder = coefficient % divisor;
+    let roundingUp;
+    if (remainder * 2n >= divisor) {
+        roundingUp = 1n;
+    }
+    else {
+        roundingUp = 0n;
+    }
+    return whole + roundingUp;
+}
+/** Money as integer cents, rounded half away from zero without binary floats. */
+export function toCents(value) {
+    if (!Number.isFinite(value)) {
+        throw new RangeError("Money value must be finite");
+    }
+    let sign;
+    if (value < 0) {
+        sign = -1;
+    }
+    else {
+        sign = 1;
+    }
+    const roundedCents = roundDecimalCents(parseDecimalDigits(value));
+    const result = sign * Number(roundedCents);
+    if (!Number.isSafeInteger(result)) {
+        throw new RangeError("Money value exceeds the safe integer cent range");
+    }
+    if (result === 0) {
+        return 0;
+    }
+    return result;
+}
+//# sourceMappingURL=money.js.map

package/dist/pluggy/money.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"money.js","sourceRoot":"","sources":["../../src/pluggy/money.ts"],"names":[],"mappings":"AAKA,SAAS,kBAAkB,CAAC,KAAa;IACvC,MAAM,cAAc,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE,CAAC;IAClD,MAAM,KAAK,GAAG,qCAAqC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAEzE,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CAAC,+BAA+B,cAAc,EAAE,CAAC,CAAC;IACnE,CAAC;IAED,MAAM,aAAa,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC;IACtC,MAAM,cAAc,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACtC,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC;IAEzC,OAAO;QACL,WAAW,EAAE,MAAM,CAAC,GAAG,aAAa,GAAG,cAAc,EAAE,CAAC;QACxD,aAAa,EAAE,cAAc,CAAC,MAAM,GAAG,QAAQ;KAChD,CAAC;AACJ,CAAC;AAED,SAAS,iBAAiB,CAAC,EAAE,WAAW,EAAE,aAAa,EAAiB;IACtE,IAAI,aAAa,IAAI,CAAC,EAAE,CAAC;QACvB,OAAO,WAAW,GAAG,GAAG,IAAI,MAAM,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC;IACxD,CAAC;IAED,MAAM,OAAO,GAAG,GAAG,IAAI,MAAM,CAAC,aAAa,GAAG,CAAC,CAAC,CAAC;IACjD,MAAM,KAAK,GAAG,WAAW,GAAG,OAAO,CAAC;IACpC,MAAM,SAAS,GAAG,WAAW,GAAG,OAAO,CAAC;IAExC,IAAI,UAAkB,CAAC;IACvB,IAAI,SAAS,GAAG,EAAE,IAAI,OAAO,EAAE,CAAC;QAC9B,UAAU,GAAG,EAAE,CAAC;IAClB,CAAC;SAAM,CAAC;QACN,UAAU,GAAG,EAAE,CAAC;IAClB,CAAC;IAED,OAAO,KAAK,GAAG,UAAU,CAAC;AAC5B,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,OAAO,CAAC,KAAa;IACnC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,UAAU,CAAC,4BAA4B,CAAC,CAAC;IACrD,CAAC;IAED,IAAI,IAAY,CAAC;IACjB,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QACd,IAAI,GAAG,CAAC,CAAC,CAAC;IACZ,CAAC;SAAM,CAAC;QACN,IAAI,GAAG,CAAC,CAAC;IACX,CAAC;IAED,MAAM,YAAY,GAAG,iBAAiB,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC;IAClE,MAAM,MAAM,GAAG,IAAI,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC;IAC3C,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC;QAClC,MAAM,IAAI,UAAU,CAAC,iDAAiD,CAAC,CAAC;IAC1E,CAAC;IAED,IAAI,MAAM,KAAK,CAAC,EAAE,CAAC;QACjB,OAAO,CAAC,CAAC;IACX,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/pluggy/transaction-mapper.js

@@ -0,0 +1,124 @@
+import { localDayOf } from "../core/date.js";
+import { normalizeDescription } from "../core/description.js";
+import { ResponseShapeError } from "./errors.js";
+import { toCents } from "./money.js";
+function toDigits(value) {
+    if (value === null || value === undefined) {
+        return null;
+    }
+    const digits = value.replace(/\D/gu, "");
+    if (digits === "") {
+        return null;
+    }
+    return digits;
+}
+function signFor(type) {
+    switch (type) {
+        case "BANK":
+            return 1;
+        case "CREDIT":
+            return -1;
+        default:
+            throw new ResponseShapeError(`${type} accounts have no transaction feed on /v2/transactions`);
+    }
+}
+function localDayOrThrow(value) {
+    try {
+        return localDayOf(value);
+    }
+    catch (error) {
+        if (error instanceof RangeError) {
+            throw new ResponseShapeError(`Pluggy returned an invalid transaction date: ${value}`);
+        }
+        throw error;
+    }
+}
+function originalDetails(wire, sign) {
+    const foreign = wire.amountInAccountCurrency !== null && wire.amountInAccountCurrency !== undefined;
+    if (!foreign) {
+        return { originalAmountCents: null, originalCurrency: null };
+    }
+    return { originalAmountCents: sign * toCents(wire.amount), originalCurrency: wire.currencyCode ?? null };
+}
+function paymentDetails(wire) {
+    if (wire.paymentData === null || wire.paymentData === undefined) {
+        return { document: null, counterpartyName: null, paymentMethod: null };
+    }
+    const receiver = receiverDetails(wire.paymentData.receiver);
+    return { ...receiver, paymentMethod: wire.paymentData.paymentMethod ?? null };
+}
+function receiverDetails(receiver) {
+    if (receiver === null || receiver === undefined) {
+        return { document: null, counterpartyName: null };
+    }
+    return {
+        document: toDigits(receiver.documentNumber?.value),
+        counterpartyName: receiver.name ?? null,
+    };
+}
+function cardDetails(wire) {
+    if (wire.creditCardMetadata === null || wire.creditCardMetadata === undefined) {
+        return {
+            mcc: null,
+            billId: null,
+            billForecastDate: null,
+            instalmentNumber: null,
+            instalmentTotal: null,
+            purchaseDate: null,
+        };
+    }
+    return cardMetadataDetails(wire.creditCardMetadata);
+}
+function cardMetadataDetails(metadata) {
+    return {
+        mcc: mccOf(metadata.payeeMCC),
+        billId: stringOrNull(metadata.billId),
+        billForecastDate: stringOrNull(metadata.billForecastDate),
+        instalmentNumber: numberOrNull(metadata.installmentNumber),
+        instalmentTotal: numberOrNull(metadata.totalInstallments),
+        purchaseDate: stringOrNull(metadata.purchaseDate),
+    };
+}
+function mccOf(value) {
+    if (value === undefined) {
+        return null;
+    }
+    return value.toString();
+}
+function stringOrNull(value) {
+    if (value === undefined) {
+        return null;
+    }
+    return value;
+}
+function numberOrNull(value) {
+    if (value === undefined) {
+        return null;
+    }
+    return value;
+}
+/** One Pluggy transaction, in our vocabulary, with the sign normalized. */
+export function toTransaction(wire, account) {
+    const sign = signFor(account.type);
+    const original = originalDetails(wire, sign);
+    const payment = paymentDetails(wire);
+    const card = cardDetails(wire);
+    return {
+        ...original,
+        ...payment,
+        ...card,
+        id: wire.id,
+        accountId: account.id,
+        connectionId: account.connectionId,
+        accountType: account.type,
+        accountSubtype: account.subtype,
+        occurredAt: wire.date,
+        localDate: localDayOrThrow(wire.date),
+        amountCents: sign * toCents(wire.amountInAccountCurrency ?? wire.amount),
+        currency: account.currency,
+        description: wire.description,
+        descriptionNorm: normalizeDescription(wire.description),
+        categoryId: wire.categoryId ?? null,
+    };
+}
+//# sourceMappingURL=transaction-mapper.js.map

package/dist/pluggy/transaction-mapper.js.map

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