@cobre-npm/library-portal-core 0.57.0 → 0.59.0

package/README.md

@@ -4,6 +4,10 @@ Shared catalogs, configuration and interfaces for Cobre's Portal MFEs (Vue 3 + T
 It is a **static data** library (no app runtime): account types, counterparties, countries, currencies,
 movement types, document types, etc., together with their translated labels.
 
+The vocabulary these catalogs share with the Portal and the BFF (rail, movement type, line, business category,
+product type, nature, …) is defined in [`GLOSSARY.md`](./GLOSSARY.md); [`GLOSSARY-MAP.md`](./GLOSSARY-MAP.md)
+lists it together with the glossary local to `canonicalTransactions`.
+
 - No runtime dependencies (only `devDependencies`).
 - Published compiled to `dist/` (CommonJS + `.d.ts`).
 - Managed with **pnpm**; built with plain `tsc`.
@@ -43,8 +47,9 @@ import { getCountries }    from "@cobre-npm/library-portal-core/countries"
 | `@cobre-npm/library-portal-core/subclients` | Subclient statuses + `Subclient`/`SubclientPerson` interfaces |
 | `@cobre-npm/library-portal-core/documentTypes` | Document types (definition + per-country applicability) |
 | `@cobre-npm/library-portal-core/currencies` | Currencies |
+| `@cobre-npm/library-portal-core/blockchains` | Blockchains (chains of the counterparty dropdown) |
 | `@cobre-npm/library-portal-core/transactions` | Transaction types + interfaces |
-| `@cobre-npm/library-portal-core/canonicalTransactions` | Canonical transaction/money-movement detail interfaces |
+| `@cobre-npm/library-portal-core/canonicalTransactions` | Canonical transaction/money-movement detail interfaces + product type and nature catalogs |
 | `@cobre-npm/library-portal-core/search` | Search / aggregation interfaces |
 | `@cobre-npm/library-portal-core/filterClassification` | Grouped type-filter vocabulary (families, sections, categories), `splitTypeLabel`, group-selection helpers |
 | `@cobre-npm/library-portal-core/trustedSessions` | Trusted session (OTP elevation window) interfaces + constants |
@@ -145,7 +150,7 @@ one-off predicates even where `queryX()` exists.
 
 | Class | When | Signature | Examples |
 |---|---|---|---|
-| **With i18n** | the label depends on the language | `getX(lang)` | accountTypes, counterpartyTypes, movementTypes, transactionTypes, countries, countriesISO, documentTypes |
+| **With i18n** | the label depends on the language | `getX(lang)` | accountTypes, counterpartyTypes, movementTypes, transactionTypes, countries, countriesISO, documentTypes, blockchains, productTypes, natures |
 | **Without i18n** | the label is fixed (or there is none) | `getX()` | currencies (inline label), accountProviders |
 
 `currencies`/`providers` **don't take `lang`** because there's no translation — the signature is honest.
@@ -567,9 +572,30 @@ caller stop attaching an `otp_token` per request while the window is active.
 `constants/trustedSessions.constants.ts` — the pattern for a domain that needs standalone constants
 (no catalog, no i18n): a `constants/<domain>.constants.ts` file, re-exported from the barrel.
 
+### `blockchains`
+
+```ts
+import {
+  getBlockchains, queryBlockchains,
+  type Blockchain, type BlockchainOption, type BlockchainQuery,
+} from "@cobre-npm/library-portal-core/blockchains"
+
+getBlockchains("en").stellar.label       // "Stellar"  → point lookup of a chain code
+queryBlockchains({ lang: "en" })        // the 7 chains as a list → dropdowns
+queryBlockchains({ lang: "en", code: ["tron", "base"] })   // [ tron, base ]
+```
+
+- Single i18n catalog (`code` + `label`), 7 chains: `ethereum`, `tron`, `solana`, `polygon`, `base`, `xrpl`, `stellar`.
+  Labels are proper names, so `en` and `es-mex` match today.
+- No logo field: the logo is a presentation concern of the consumer (Portal derives it from `code`).
+- `counterparty_chain` / `chain` stay `string` in the counterparties and accounts interfaces — a `string` from
+  the backend may not be a `Blockchain`, so consumers narrow it themselves before indexing `getBlockchains()`.
+- No visibility field, so `queryBlockchains({ lang })` returns all 7 (same rule as every `queryX()`: a key that is
+  present always filters, so `{ code: undefined }` returns `[]`).
+
 ### `canonicalTransactions`
 
-Interfaces only (pure types). This is the single source of truth for the canonical money-movement /
+Interfaces plus two small i18n catalogs (`productType`, `nature`). The interfaces are the single source of truth for the canonical money-movement /
 transaction detail — built by `core-portal-bff`'s transaction-canonical BFF, consumed as-is by the
 `portal` MFE (`CanonicalMoneyMovement`), and narrowed with `Pick` by the receipts-generation service:
 
@@ -591,6 +617,19 @@ import type {
   consumers (`portal`, `core-portal-bff`, `util-portal-receipts`) — see `ICanonicalApprovalEvent`'s
   doc comment for one case that's a superset of two non-overlapping shapes rather than a clean merge,
   and revisit it once the real payload is confirmed.
+- `ICanonicalAllowedActions.can_report_problem` is optional until `core-portal-bff` emits it (BLCK-32190); make it
+  required then. `ICanonicalParticipant.subclient` is present only when the movement was made on a subclient's behalf.
+- **productType / nature** (i18n): `getProductTypes(lang)` / `getNatures(lang)` cover the 5 `product_type` and 6
+  `nature` values of the BFF's `rail-mapper.interface.ts` (the source of truth), and `CanonicalProductType` /
+  `CanonicalNature` are derived from them — `conversion`, `on_ramp` and `off_ramp` used to be missing. `en` labels
+  are the humanized code in Title Case (`on_ramp` → "On Ramp"); `es-mex` labels are Design's copy (`payout` →
+  "Transferencia", `payin` → "Depósito", `cross_border` → "Internacional", `payment` → "Pago", `collection` →
+  "Recaudo", `return` → "Reversión", `on_ramp` → "Conversión a stablecoin", `off_ramp` → "Conversión a moneda
+  local"). Only `getX()` for now (no `queryX()`).
+  They are not duplicates of `businessLines` or `movements/types`: `product_type` is the BFF's per-transaction class
+  and flips with the ledger direction (`payin` ↔ `payout`), whereas a `BusinessLine` is fixed per movement type;
+  the value sets differ (`internal_transfer`, `conversion` vs `cbmm`, `stable`, `unclassified`) and
+  `movements/types` has 26 rail codes, not 5 classes. The only shared label is `cross_border`.
 
 ### `exports`
 

package/dist/cjs/blockchains/catalog.d.ts

@@ -0,0 +1,25 @@
+export declare const BLOCKCHAINS: {
+    readonly ethereum: {
+        readonly code: "ethereum";
+    };
+    readonly tron: {
+        readonly code: "tron";
+    };
+    readonly solana: {
+        readonly code: "solana";
+    };
+    readonly polygon: {
+        readonly code: "polygon";
+    };
+    readonly base: {
+        readonly code: "base";
+    };
+    readonly xrpl: {
+        readonly code: "xrpl";
+    };
+    readonly stellar: {
+        readonly code: "stellar";
+    };
+};
+export type Blockchain = keyof typeof BLOCKCHAINS;
+export type BlockchainRecord = (typeof BLOCKCHAINS)[Blockchain];

package/dist/cjs/blockchains/catalog.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BLOCKCHAINS = void 0;
+exports.BLOCKCHAINS = {
+    ethereum: { code: "ethereum" },
+    tron: { code: "tron" },
+    solana: { code: "solana" },
+    polygon: { code: "polygon" },
+    base: { code: "base" },
+    xrpl: { code: "xrpl" },
+    stellar: { code: "stellar" },
+};

package/dist/cjs/blockchains/index.d.ts

@@ -0,0 +1,2 @@
+export type { Blockchain } from "./catalog";
+export * from "./utils/blockchain.utils";

package/dist/cjs/blockchains/index.js

@@ -0,0 +1,17 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./utils/blockchain.utils"), exports);

package/dist/cjs/blockchains/locales/en.json

@@ -0,0 +1,11 @@
+{
+    "blockchains": {
+        "ethereum": "Ethereum",
+        "tron": "Tron",
+        "solana": "Solana",
+        "polygon": "Polygon",
+        "base": "Base",
+        "xrpl": "XRP Ledger",
+        "stellar": "Stellar"
+    }
+}

package/dist/cjs/blockchains/locales/es-mex.json

@@ -0,0 +1,11 @@
+{
+    "blockchains": {
+        "ethereum": "Ethereum",
+        "tron": "Tron",
+        "solana": "Solana",
+        "polygon": "Polygon",
+        "base": "Base",
+        "xrpl": "XRP Ledger",
+        "stellar": "Stellar"
+    }
+}

package/dist/cjs/blockchains/utils/blockchain.utils.d.ts

@@ -0,0 +1,13 @@
+import type { Blockchain, BlockchainRecord } from "../catalog";
+import type { Locale } from "../../lang";
+import type { CatalogQuery } from "../../utils/catalog-query.utils";
+export type BlockchainOption = BlockchainRecord & {
+    label: string;
+};
+export declare const getBlockchains: (lang: Locale) => Record<Blockchain, BlockchainOption>;
+/** `lang` is required (i18n domain, no default) and travels inside the query object, never positional. */
+export type BlockchainQuery = CatalogQuery<BlockchainRecord> & {
+    lang: Locale;
+};
+/** The catalog as a list, narrowed by the query — see `matchesQuery` for the matching rules. */
+export declare const queryBlockchains: (query: BlockchainQuery) => BlockchainOption[];

package/dist/cjs/blockchains/utils/blockchain.utils.js

@@ -0,0 +1,27 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.queryBlockchains = exports.getBlockchains = void 0;
+const catalog_1 = require("../catalog");
+const en_json_1 = __importDefault(require("../locales/en.json"));
+const es_mex_json_1 = __importDefault(require("../locales/es-mex.json"));
+const catalog_query_utils_1 = require("../../utils/catalog-query.utils");
+const locales = { en: en_json_1.default, "es-mex": es_mex_json_1.default };
+const getBlockchains = (lang) => {
+    const locale = locales[lang];
+    const result = {};
+    for (const record of Object.values(catalog_1.BLOCKCHAINS)) {
+        result[record.code] = { ...record, label: locale.blockchains[record.code] };
+    }
+    return result;
+};
+exports.getBlockchains = getBlockchains;
+/** The catalog as a list, narrowed by the query — see `matchesQuery` for the matching rules. */
+const queryBlockchains = (query) => {
+    const { lang, ...criteria } = query;
+    const blockchains = (0, exports.getBlockchains)(lang);
+    return Object.values(blockchains).filter(blockchain => (0, catalog_query_utils_1.matchesQuery)(blockchain, criteria));
+};
+exports.queryBlockchains = queryBlockchains;

package/dist/cjs/canonicalTransactions/index.d.ts

@@ -1,2 +1,6 @@
 export * from "./interfaces/response.interface";
 export * from "./interfaces/request.interface";
+export type { ProductType } from "./productType/catalog";
+export * from "./productType/utils/product-type.utils";
+export type { Nature } from "./nature/catalog";
+export * from "./nature/utils/nature.utils";

package/dist/cjs/canonicalTransactions/index.js

@@ -16,3 +16,5 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./interfaces/response.interface"), exports);
 __exportStar(require("./interfaces/request.interface"), exports);
+__exportStar(require("./productType/utils/product-type.utils"), exports);
+__exportStar(require("./nature/utils/nature.utils"), exports);

package/dist/cjs/canonicalTransactions/interfaces/response.interface.d.ts

@@ -3,9 +3,11 @@ import type { CounterpartyType } from "../../counterparties/types/catalog";
 import type { Currency } from "../../currencies/catalog";
 import type { DocumentType } from "../../documentTypes/catalog";
 import type { MovementStatus } from "../../movements/status/catalog";
+import type { Nature } from "../nature/catalog";
+import type { ProductType } from "../productType/catalog";
 export type CanonicalDirection = "credit" | "debit";
-export type CanonicalProductType = "payout" | "payin" | "internal_transfer" | "cross_border";
-export type CanonicalNature = "payment" | "collection" | "return" | "fx_conversion";
+export type CanonicalProductType = ProductType;
+export type CanonicalNature = Nature;
 export type CanonicalStatusPresentationType = "status-pending" | "info" | "success" | "error" | "neutral" | "warning";
 export type CanonicalAlertType = "danger" | "success" | "warning" | "info";
 export type CanonicalAlertActionType = "open_drawer" | "copy_to_clipboard";
@@ -81,6 +83,10 @@ export interface ICanonicalBeneficiary {
     chain: string | null;
     token: string | null;
 }
+export interface ICanonicalSubclient {
+    id: string;
+    legal_name: string | null;
+}
 export interface ICanonicalOrderingInstrument {
     value: string | null;
     error_code: CanonicalErrorCode | null;
@@ -122,6 +128,7 @@ export interface ICanonicalParticipant {
     beneficiary?: ICanonicalBeneficiary | null;
     payer?: ICanonicalBeneficiary | null;
     ordering_instrument?: ICanonicalOrderingInstrument | null;
+    subclient?: ICanonicalSubclient | null;
 }
 export interface ICanonicalParticipants {
     source: ICanonicalParticipant | null;
@@ -176,6 +183,7 @@ export interface ICanonicalReferences {
     internal_tracking_key: string | null;
     destination_description: string | null;
     account_reference: string | null;
+    settlement_type: string | null;
     alerts: ICanonicalAlert[];
     checkout: ICanonicalCheckout | null;
 }
@@ -272,6 +280,7 @@ export interface ICanonicalAllowedActions {
     can_decline: boolean;
     can_return: boolean;
     can_view_batch: boolean;
+    can_report_problem?: boolean;
 }
 export interface ICanonicalApprovals {
     mm_approval_id: string | null;

package/dist/cjs/canonicalTransactions/nature/catalog.d.ts

@@ -0,0 +1,22 @@
+export declare const NATURES: {
+    readonly payment: {
+        readonly code: "payment";
+    };
+    readonly collection: {
+        readonly code: "collection";
+    };
+    readonly return: {
+        readonly code: "return";
+    };
+    readonly fx_conversion: {
+        readonly code: "fx_conversion";
+    };
+    readonly on_ramp: {
+        readonly code: "on_ramp";
+    };
+    readonly off_ramp: {
+        readonly code: "off_ramp";
+    };
+};
+export type Nature = keyof typeof NATURES;
+export type NatureRecord = (typeof NATURES)[Nature];

package/dist/cjs/canonicalTransactions/nature/catalog.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NATURES = void 0;
+exports.NATURES = {
+    payment: { code: "payment" },
+    collection: { code: "collection" },
+    return: { code: "return" },
+    fx_conversion: { code: "fx_conversion" },
+    on_ramp: { code: "on_ramp" },
+    off_ramp: { code: "off_ramp" },
+};

package/dist/cjs/canonicalTransactions/nature/locales/en.json

@@ -0,0 +1,10 @@
+{
+    "natures": {
+        "payment": "Payment",
+        "collection": "Collection",
+        "return": "Return",
+        "fx_conversion": "FX Conversion",
+        "on_ramp": "On Ramp",
+        "off_ramp": "Off Ramp"
+    }
+}

package/dist/cjs/canonicalTransactions/nature/locales/es-mex.json

@@ -0,0 +1,10 @@
+{
+    "natures": {
+        "payment": "Pago",
+        "collection": "Recaudo",
+        "return": "Reversión",
+        "fx_conversion": "Conversión FX",
+        "on_ramp": "Conversión a stablecoin",
+        "off_ramp": "Conversión a moneda local"
+    }
+}

package/dist/cjs/canonicalTransactions/nature/utils/nature.utils.d.ts

@@ -0,0 +1,6 @@
+import type { Nature, NatureRecord } from "../catalog";
+import type { Locale } from "../../../lang";
+export type NatureOption = NatureRecord & {
+    label: string;
+};
+export declare const getNatures: (lang: Locale) => Record<Nature, NatureOption>;

package/dist/cjs/canonicalTransactions/nature/utils/nature.utils.js

@@ -0,0 +1,19 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getNatures = void 0;
+const catalog_1 = require("../catalog");
+const en_json_1 = __importDefault(require("../locales/en.json"));
+const es_mex_json_1 = __importDefault(require("../locales/es-mex.json"));
+const locales = { en: en_json_1.default, "es-mex": es_mex_json_1.default };
+const getNatures = (lang) => {
+    const locale = locales[lang];
+    const result = {};
+    for (const record of Object.values(catalog_1.NATURES)) {
+        result[record.code] = { ...record, label: locale.natures[record.code] };
+    }
+    return result;
+};
+exports.getNatures = getNatures;

package/dist/cjs/canonicalTransactions/productType/catalog.d.ts

@@ -0,0 +1,19 @@
+export declare const PRODUCT_TYPES: {
+    readonly payout: {
+        readonly code: "payout";
+    };
+    readonly payin: {
+        readonly code: "payin";
+    };
+    readonly internal_transfer: {
+        readonly code: "internal_transfer";
+    };
+    readonly cross_border: {
+        readonly code: "cross_border";
+    };
+    readonly conversion: {
+        readonly code: "conversion";
+    };
+};
+export type ProductType = keyof typeof PRODUCT_TYPES;
+export type ProductTypeRecord = (typeof PRODUCT_TYPES)[ProductType];

package/dist/cjs/canonicalTransactions/productType/catalog.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PRODUCT_TYPES = void 0;
+/*
+  The BFF's `classification.product_type` (core-portal-bff `rail-mapper.interface.ts`). Not a BusinessLine and not
+  a MovementType, even though `payin`/`payout` share a name with the former:
+  - It is assigned per rail and flips with the ledger direction (a debit `payin` becomes `payout` and a credit
+    `payout` becomes `payin`), while a BusinessLine is a fixed property of each movement type.
+  - It has values a BusinessLine lacks (`internal_transfer`, `conversion`, `cross_border`) and vice versa
+    (`cbmm`, `stable`, `unclassified`), and it needs labels, which `businessLines` does not have.
+*/
+exports.PRODUCT_TYPES = {
+    payout: { code: "payout" },
+    payin: { code: "payin" },
+    internal_transfer: { code: "internal_transfer" },
+    cross_border: { code: "cross_border" },
+    conversion: { code: "conversion" },
+};

package/dist/cjs/canonicalTransactions/productType/locales/en.json

@@ -0,0 +1,9 @@
+{
+    "productTypes": {
+        "payout": "Payout",
+        "payin": "Payin",
+        "internal_transfer": "Internal Transfer",
+        "cross_border": "Cross Border",
+        "conversion": "Conversion"
+    }
+}

package/dist/cjs/canonicalTransactions/productType/locales/es-mex.json

@@ -0,0 +1,9 @@
+{
+    "productTypes": {
+        "payout": "Transferencia",
+        "payin": "Depósito",
+        "internal_transfer": "Transferencia interna",
+        "cross_border": "Internacional",
+        "conversion": "Conversión"
+    }
+}

package/dist/cjs/canonicalTransactions/productType/utils/product-type.utils.d.ts

@@ -0,0 +1,6 @@
+import type { ProductType, ProductTypeRecord } from "../catalog";
+import type { Locale } from "../../../lang";
+export type ProductTypeOption = ProductTypeRecord & {
+    label: string;
+};
+export declare const getProductTypes: (lang: Locale) => Record<ProductType, ProductTypeOption>;

package/dist/cjs/canonicalTransactions/productType/utils/product-type.utils.js

@@ -0,0 +1,19 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getProductTypes = void 0;
+const catalog_1 = require("../catalog");
+const en_json_1 = __importDefault(require("../locales/en.json"));
+const es_mex_json_1 = __importDefault(require("../locales/es-mex.json"));
+const locales = { en: en_json_1.default, "es-mex": es_mex_json_1.default };
+const getProductTypes = (lang) => {
+    const locale = locales[lang];
+    const result = {};
+    for (const record of Object.values(catalog_1.PRODUCT_TYPES)) {
+        result[record.code] = { ...record, label: locale.productTypes[record.code] };
+    }
+    return result;
+};
+exports.getProductTypes = getProductTypes;

package/dist/esm/blockchains/catalog.js

@@ -0,0 +1,9 @@
+export const BLOCKCHAINS = {
+    ethereum: { code: "ethereum" },
+    tron: { code: "tron" },
+    solana: { code: "solana" },
+    polygon: { code: "polygon" },
+    base: { code: "base" },
+    xrpl: { code: "xrpl" },
+    stellar: { code: "stellar" },
+};

package/dist/esm/blockchains/index.js

@@ -0,0 +1 @@
+export * from "./utils/blockchain.utils";

package/dist/esm/blockchains/locales/en.json

@@ -0,0 +1,11 @@
+{
+    "blockchains": {
+        "ethereum": "Ethereum",
+        "tron": "Tron",
+        "solana": "Solana",
+        "polygon": "Polygon",
+        "base": "Base",
+        "xrpl": "XRP Ledger",
+        "stellar": "Stellar"
+    }
+}

package/dist/esm/blockchains/locales/es-mex.json

@@ -0,0 +1,11 @@
+{
+    "blockchains": {
+        "ethereum": "Ethereum",
+        "tron": "Tron",
+        "solana": "Solana",
+        "polygon": "Polygon",
+        "base": "Base",
+        "xrpl": "XRP Ledger",
+        "stellar": "Stellar"
+    }
+}

package/dist/esm/blockchains/utils/blockchain.utils.js

@@ -0,0 +1,19 @@
+import { BLOCKCHAINS } from "../catalog";
+import enLocale from "../locales/en.json";
+import esMexLocale from "../locales/es-mex.json";
+import { matchesQuery } from "../../utils/catalog-query.utils";
+const locales = { en: enLocale, "es-mex": esMexLocale };
+export const getBlockchains = (lang) => {
+    const locale = locales[lang];
+    const result = {};
+    for (const record of Object.values(BLOCKCHAINS)) {
+        result[record.code] = { ...record, label: locale.blockchains[record.code] };
+    }
+    return result;
+};
+/** The catalog as a list, narrowed by the query — see `matchesQuery` for the matching rules. */
+export const queryBlockchains = (query) => {
+    const { lang, ...criteria } = query;
+    const blockchains = getBlockchains(lang);
+    return Object.values(blockchains).filter(blockchain => matchesQuery(blockchain, criteria));
+};

package/dist/esm/canonicalTransactions/index.js

@@ -1,2 +1,4 @@
 export * from "./interfaces/response.interface";
 export * from "./interfaces/request.interface";
+export * from "./productType/utils/product-type.utils";
+export * from "./nature/utils/nature.utils";

package/dist/esm/canonicalTransactions/nature/catalog.js

@@ -0,0 +1,8 @@
+export const NATURES = {
+    payment: { code: "payment" },
+    collection: { code: "collection" },
+    return: { code: "return" },
+    fx_conversion: { code: "fx_conversion" },
+    on_ramp: { code: "on_ramp" },
+    off_ramp: { code: "off_ramp" },
+};

package/dist/esm/canonicalTransactions/nature/locales/en.json

@@ -0,0 +1,10 @@
+{
+    "natures": {
+        "payment": "Payment",
+        "collection": "Collection",
+        "return": "Return",
+        "fx_conversion": "FX Conversion",
+        "on_ramp": "On Ramp",
+        "off_ramp": "Off Ramp"
+    }
+}

package/dist/esm/canonicalTransactions/nature/locales/es-mex.json

@@ -0,0 +1,10 @@
+{
+    "natures": {
+        "payment": "Pago",
+        "collection": "Recaudo",
+        "return": "Reversión",
+        "fx_conversion": "Conversión FX",
+        "on_ramp": "Conversión a stablecoin",
+        "off_ramp": "Conversión a moneda local"
+    }
+}

package/dist/esm/canonicalTransactions/nature/utils/nature.utils.js

@@ -0,0 +1,12 @@
+import { NATURES } from "../catalog";
+import enLocale from "../locales/en.json";
+import esMexLocale from "../locales/es-mex.json";
+const locales = { en: enLocale, "es-mex": esMexLocale };
+export const getNatures = (lang) => {
+    const locale = locales[lang];
+    const result = {};
+    for (const record of Object.values(NATURES)) {
+        result[record.code] = { ...record, label: locale.natures[record.code] };
+    }
+    return result;
+};

package/dist/esm/canonicalTransactions/productType/catalog.js

@@ -0,0 +1,15 @@
+/*
+  The BFF's `classification.product_type` (core-portal-bff `rail-mapper.interface.ts`). Not a BusinessLine and not
+  a MovementType, even though `payin`/`payout` share a name with the former:
+  - It is assigned per rail and flips with the ledger direction (a debit `payin` becomes `payout` and a credit
+    `payout` becomes `payin`), while a BusinessLine is a fixed property of each movement type.
+  - It has values a BusinessLine lacks (`internal_transfer`, `conversion`, `cross_border`) and vice versa
+    (`cbmm`, `stable`, `unclassified`), and it needs labels, which `businessLines` does not have.
+*/
+export const PRODUCT_TYPES = {
+    payout: { code: "payout" },
+    payin: { code: "payin" },
+    internal_transfer: { code: "internal_transfer" },
+    cross_border: { code: "cross_border" },
+    conversion: { code: "conversion" },
+};

package/dist/esm/canonicalTransactions/productType/locales/en.json

@@ -0,0 +1,9 @@
+{
+    "productTypes": {
+        "payout": "Payout",
+        "payin": "Payin",
+        "internal_transfer": "Internal Transfer",
+        "cross_border": "Cross Border",
+        "conversion": "Conversion"
+    }
+}

package/dist/esm/canonicalTransactions/productType/locales/es-mex.json

@@ -0,0 +1,9 @@
+{
+    "productTypes": {
+        "payout": "Transferencia",
+        "payin": "Depósito",
+        "internal_transfer": "Transferencia interna",
+        "cross_border": "Internacional",
+        "conversion": "Conversión"
+    }
+}

package/dist/esm/canonicalTransactions/productType/utils/product-type.utils.js

@@ -0,0 +1,12 @@
+import { PRODUCT_TYPES } from "../catalog";
+import enLocale from "../locales/en.json";
+import esMexLocale from "../locales/es-mex.json";
+const locales = { en: enLocale, "es-mex": esMexLocale };
+export const getProductTypes = (lang) => {
+    const locale = locales[lang];
+    const result = {};
+    for (const record of Object.values(PRODUCT_TYPES)) {
+        result[record.code] = { ...record, label: locale.productTypes[record.code] };
+    }
+    return result;
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cobre-npm/library-portal-core",
-  "version": "0.57.0",
+  "version": "0.59.0",
   "description": "Shared configurations and resources for Portal MFEs",
   "main": "./dist/cjs/index.js",
   "module": "./dist/esm/index.js",
@@ -56,6 +56,11 @@
       "import": "./dist/esm/transactions/index.js",
       "require": "./dist/cjs/transactions/index.js"
     },
+    "./blockchains": {
+      "types": "./dist/cjs/blockchains/index.d.ts",
+      "import": "./dist/esm/blockchains/index.js",
+      "require": "./dist/cjs/blockchains/index.js"
+    },
     "./canonicalTransactions": {
       "types": "./dist/cjs/canonicalTransactions/index.d.ts",
       "import": "./dist/esm/canonicalTransactions/index.js",