@cobre-npm/library-portal-core 0.64.0 → 0.66.0

package/README.md

@@ -286,9 +286,12 @@ queryMovementStatuses({ lang: "en", type: "error" })  // error, failed, rejected
   `section: FilterClassificationSection` (`cop | mxn | usd_global | eur | corridors | stablecoin | …`), the heading it
   is listed under in grouped filters. `getMovementTypes()` returns each rail's own `label` unchanged.
 - **types query** (i18n `queryX()`): `queryMovementTypes({ lang, ...filters })` — same rules as
-  `queryTransactionTypes`/`queryDocumentTypes`, no default field. `code`, `line`, `category` and `section` are
-  filterable (equality only; a list matches any of its values). A present key always filters, so an optional UI
-  filter has to be spread in conditionally:
+  `queryTransactionTypes`/`queryDocumentTypes`. `code`, `line`, `category` and `section` are
+  filterable (equality only; a list matches any of its values). `scope` is the one field with a default: `mint` and
+  `redeem` carry `scope: "internal_ops"` (internal operations of a single client), so they never come back from
+  `queryMovementTypes({ lang })` and no filter offers them. To read their label use `getMovementTypes(lang).mint`, or
+  ask for them with `{ scope: "internal_ops" }`; `{ code: "mint" }` alone returns `[]`. A present key always filters,
+  so an optional UI filter has to be spread in conditionally:
 
   ```ts
   queryMovementTypes({ lang, ...(section.value ? { section: section.value } : {}) })
@@ -410,6 +413,9 @@ queryCurrencies({ type: "fiat" })       // [ cop, mxn, usd ]  → the list a pic
 
 No `lang`: the `label` is fixed (a display code, the same in any language).
 
+`symbol` is the token's display ticker (`usdt` → `USDT`, `usdc` → `USDC`, `copco` → `COPco`) and exists only on
+tokens: `label` can't serve as one (the label of `usdc` is `USD (USDC)`). Fall back to `code.toUpperCase()` when absent.
+
 **Which one to use.** `getCurrencies()` is the catalog keyed by code — use it to look a single currency
 up (`getCurrencies()[code]`) or when you genuinely want all of them. `queryCurrencies()` returns a
 **list**, narrowed by the query, and is what a dropdown, table filter or picker should call.
@@ -498,7 +504,7 @@ queryTransactionTypes({ lang: "en", category: "top_up" })  // col_top_up_credit
 
   ```ts
   collapseTransactionTypes({ lang: "en", category: "conversions" }).map(option => option.code)
-  // 7 conversion types → 4 options: ["on_ramp", "off_ramp", "stable_payout", "offramp_treasury_credit"]
+  // 10 conversion types → 7 options: ["on_ramp", "off_ramp", "stable_payout", "offramp_treasury_credit", "stable_credit", "stable_debit", "stable_refund"]
   collapseTransactionTypes({ lang: "en", creditDebitType: "debit" })  // no group survives: plain legs only
   const groups = collapseTransactionTypes({ lang: "en" }).filter(isGroupOption)
   expandGroupSelection(["cbmm", "spei_debit"], groups)  // ["cbmm_debit", "cbmm_credit", "spei_debit"]
@@ -631,16 +637,17 @@ import type {
 - `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` /
+  `nature` values of the BFF's `rail-mapper.interface.ts` (the source of truth), plus the `mint` and `redeem` natures,
+  which the BFF adds in BLCK-33095, 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()`).
+  local", `mint` → "Emisión", `redeem` → "Canje"). 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`.
+  `movements/types` has 28 rail codes (26 regular plus `mint`/`redeem`), not 5 classes. The only shared label is `cross_border`.
 
 ### `exports`
 
@@ -706,12 +713,14 @@ import {
 import {
   getFinancialInstitutions, queryFinancialInstitutions,
   type FinancialInstitution, type FinancialInstitutionGeo,
-  type FinancialInstitutionOption, type FinancialInstitutionQuery, type FinancialInstitutionScope,
+  type FinancialInstitutionCatalog, type FinancialInstitutionOption, type FinancialInstitutionQuery,
+  type FinancialInstitutionScope,
 } from "@cobre-npm/library-portal-core/financialInstitutions"
 
 getFinancialInstitutions("en").pr_col_1007            // { code: "pr_col_1007", rawCode: "1007", geo: "col", label: "Bancolombia" }
 queryFinancialInstitutions({ lang: "en", geo: "col" }) // FinancialInstitutionOption[]  → every COL institution
 queryFinancialInstitutions({ lang: "en", geo: "col", scope: "checkout" }) // → only the COL ones the checkout offers
+getFinancialInstitutions("en")[`pr_col_${bankCode}`]?.label ?? bankCode // bankCode: string from an API payload, no cast
 ```
 
 - **institutions** (i18n): `getFinancialInstitutions(lang)`; each record carries `code`, `rawCode`, `geo`
@@ -728,6 +737,11 @@ queryFinancialInstitutions({ lang: "en", geo: "col", scope: "checkout" }) // →
 - `scope` (`"checkout"`, optional on the record) marks the subset of institutions the checkout offers for PSE.
   Unlike `scope` in `currencies` it has **no default**: leaving it out returns the whole catalog, and
   `scope: "checkout"` narrows it. An institution without `scope` is not offered in the checkout.
+- `getFinancialInstitutions(lang)` is also indexable by a plain `string`, for codes that arrive from a payload
+  (`pr_<geo>_<rawCode>` built from a bare bank code): a known code stays non-optional, any other
+  string reads as `FinancialInstitutionOption | undefined`, so an unknown code is handled with `?.` and no cast.
+  The catch is `Object.values(getFinancialInstitutions(lang))`, which is then typed
+  `(FinancialInstitutionOption | undefined)[]`: for a list use `queryFinancialInstitutions`.
 - Bank names have no real translation between `en` and `es-mex`: `es-mex` keeps the name as published by
   the source (accented characters included, e.g. `"Banco de Bogotá"`), `en` is the same string with
   special Spanish characters stripped (`"Banco de Bogota"`) rather than left untranslated with accents.

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

@@ -17,6 +17,12 @@ export declare const NATURES: {
     readonly off_ramp: {
         readonly code: "off_ramp";
     };
+    readonly mint: {
+        readonly code: "mint";
+    };
+    readonly redeem: {
+        readonly code: "redeem";
+    };
 };
 export type Nature = keyof typeof NATURES;
 export type NatureRecord = (typeof NATURES)[Nature];

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

@@ -8,4 +8,6 @@ exports.NATURES = {
     fx_conversion: { code: "fx_conversion" },
     on_ramp: { code: "on_ramp" },
     off_ramp: { code: "off_ramp" },
+    mint: { code: "mint" },
+    redeem: { code: "redeem" },
 };

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

@@ -5,6 +5,8 @@
         "return": "Return",
         "fx_conversion": "FX Conversion",
         "on_ramp": "On Ramp",
-        "off_ramp": "Off Ramp"
+        "off_ramp": "Off Ramp",
+        "mint": "Mint",
+        "redeem": "Redemption"
     }
 }

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

@@ -5,6 +5,8 @@
         "return": "Reversión",
         "fx_conversion": "Conversión FX",
         "on_ramp": "Conversión a stablecoin",
-        "off_ramp": "Conversión a moneda local"
+        "off_ramp": "Conversión a moneda local",
+        "mint": "Emisión",
+        "redeem": "Canje"
     }
 }

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

@@ -44,6 +44,7 @@ export declare const CURRENCIES: {
         readonly flagAsset: "usdt";
         readonly minAmount: 1;
         readonly type: "stablecoin";
+        readonly symbol: "USDT";
     };
     readonly usdc: {
         readonly code: "usdc";
@@ -53,6 +54,7 @@ export declare const CURRENCIES: {
         readonly flagAsset: "usdc";
         readonly minAmount: 1;
         readonly type: "stablecoin";
+        readonly symbol: "USDC";
     };
     readonly copco: {
         readonly code: "copco";
@@ -62,6 +64,7 @@ export declare const CURRENCIES: {
         readonly flagAsset: "cop_stable";
         readonly minAmount: 1;
         readonly type: "stable";
+        readonly symbol: "COPco";
     };
     readonly cny: {
         readonly code: "cny";
@@ -88,4 +91,5 @@ export type Currency = keyof typeof CURRENCIES;
 export type CurrencyType = (typeof CURRENCIES)[Currency]["type"];
 export type CurrencyRecord = (typeof CURRENCIES)[Currency] & {
     readonly scope?: CurrencyScope;
+    readonly symbol?: string;
 };

package/dist/cjs/currencies/catalog.js

@@ -6,9 +6,9 @@ exports.CURRENCIES = {
     mxn: { code: "mxn", label: "MXN", isoCode: "MXN", geo: "mex", flagAsset: "mex", minAmount: 0.01, type: "fiat" },
     usd: { code: "usd", label: "USD", isoCode: "USD", geo: "usa", flagAsset: "eu", minAmount: 100, type: "fiat" },
     usd_stable: { code: "usd_stable", label: "USD Stable", isoCode: "USD", geo: "global", flagAsset: "usd_stable", minAmount: 1, type: "stable" },
-    usdt: { code: "usdt", label: "USD (USDT)", isoCode: "USD", geo: "usa", flagAsset: "usdt", minAmount: 1, type: "stablecoin" },
-    usdc: { code: "usdc", label: "USD (USDC)", isoCode: "USD", geo: "usa", flagAsset: "usdc", minAmount: 1, type: "stablecoin" },
-    copco: { code: "copco", label: "COPco", isoCode: "COP", geo: "col", flagAsset: "cop_stable", minAmount: 1, type: "stable" },
+    usdt: { code: "usdt", label: "USD (USDT)", isoCode: "USD", geo: "usa", flagAsset: "usdt", minAmount: 1, type: "stablecoin", symbol: "USDT" },
+    usdc: { code: "usdc", label: "USD (USDC)", isoCode: "USD", geo: "usa", flagAsset: "usdc", minAmount: 1, type: "stablecoin", symbol: "USDC" },
+    copco: { code: "copco", label: "COPco", isoCode: "COP", geo: "col", flagAsset: "cop_stable", minAmount: 1, type: "stable", symbol: "COPco" },
     cny: { code: "cny", label: "RMB", isoCode: "CNY", geo: "chn", flagAsset: "chn", minAmount: 100, type: "fiat", scope: "counterparties" },
     eur: { code: "eur", label: "EUR", isoCode: "EUR", geo: "eur", flagAsset: "eur", minAmount: 100, type: "fiat", scope: "counterparties" },
 };

package/dist/cjs/financialInstitutions/utils/financial-institution.utils.d.ts

@@ -4,11 +4,18 @@ import type { CatalogQuery } from "../../utils/catalog-query.utils";
 export type FinancialInstitutionOption = FinancialInstitutionRecord & {
     label: string;
 };
+/**
+ * The catalog by code. Indexed by a plain string (e.g. a code from an API payload) instead of a known code,
+ * the lookup is `FinancialInstitutionOption | undefined`, so an unknown code needs no cast to be handled.
+ */
+export interface FinancialInstitutionCatalog extends Record<FinancialInstitution, FinancialInstitutionOption> {
+    [code: string]: FinancialInstitutionOption | undefined;
+}
 /**
  * The catalog indexed by code (same shape as FINANCIAL_INSTITUTIONS), each record enriched
- * with its label for the given language. Access by code directly, or Object.values for a list.
+ * with its label for the given language. Access by code directly; for a list use `queryFinancialInstitutions`.
  */
-export declare const getFinancialInstitutions: (lang: Locale) => Record<FinancialInstitution, FinancialInstitutionOption>;
+export declare const getFinancialInstitutions: (lang: Locale) => FinancialInstitutionCatalog;
 /** `lang` is required (i18n domain, no default) and travels inside the query object, never positional. */
 export type FinancialInstitutionQuery = CatalogQuery<FinancialInstitutionRecord> & {
     lang: Locale;

package/dist/cjs/financialInstitutions/utils/financial-institution.utils.js

@@ -9,11 +9,8 @@ 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 };
-/**
- * The catalog indexed by code (same shape as FINANCIAL_INSTITUTIONS), each record enriched
- * with its label for the given language. Access by code directly, or Object.values for a list.
- */
-const getFinancialInstitutions = (lang) => {
+// Built with the strict type so `queryFinancialInstitutions` lists it without the string index signature.
+const buildFinancialInstitutions = (lang) => {
     const locale = locales[lang];
     const result = {};
     for (const record of Object.values(catalog_1.FINANCIAL_INSTITUTIONS)) {
@@ -21,11 +18,15 @@ const getFinancialInstitutions = (lang) => {
     }
     return result;
 };
+/**
+ * The catalog indexed by code (same shape as FINANCIAL_INSTITUTIONS), each record enriched
+ * with its label for the given language. Access by code directly; for a list use `queryFinancialInstitutions`.
+ */
+const getFinancialInstitutions = (lang) => buildFinancialInstitutions(lang);
 exports.getFinancialInstitutions = getFinancialInstitutions;
 /** The catalog as a list, narrowed by the query — see `matchesQuery` for the matching rules. */
 const queryFinancialInstitutions = (query) => {
     const { lang, ...criteria } = query;
-    const institutions = (0, exports.getFinancialInstitutions)(lang);
-    return Object.values(institutions).filter(institution => (0, catalog_query_utils_1.matchesQuery)(institution, criteria));
+    return Object.values(buildFinancialInstitutions(lang)).filter(institution => (0, catalog_query_utils_1.matchesQuery)(institution, criteria));
 };
 exports.queryFinancialInstitutions = queryFinancialInstitutions;

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

@@ -1,4 +1,4 @@
-export type { MovementType } from "./types/catalog";
+export type { MovementType, MovementTypeScope } from "./types/catalog";
 export * from "./types/utils/movement-type.utils";
 export type { MovementStatus, MovementStatusType } from "./status/catalog";
 export * from "./status/utils/movement-status.utils";

package/dist/cjs/movements/types/catalog.d.ts

@@ -1,3 +1,4 @@
+export type MovementTypeScope = "internal_ops";
 export declare const MOVEMENT_TYPES: {
     readonly ach: {
         readonly code: "ach";
@@ -155,6 +156,22 @@ export declare const MOVEMENT_TYPES: {
         readonly category: "payments";
         readonly section: "eur";
     };
+    readonly mint: {
+        readonly code: "mint";
+        readonly line: "stable";
+        readonly category: "conversions";
+        readonly section: "stablecoin";
+        readonly scope: "internal_ops";
+    };
+    readonly redeem: {
+        readonly code: "redeem";
+        readonly line: "stable";
+        readonly category: "conversions";
+        readonly section: "stablecoin";
+        readonly scope: "internal_ops";
+    };
 };
 export type MovementType = keyof typeof MOVEMENT_TYPES;
-export type MovementTypeRecord = (typeof MOVEMENT_TYPES)[MovementType];
+export type MovementTypeRecord = (typeof MOVEMENT_TYPES)[MovementType] & {
+    readonly scope?: MovementTypeScope;
+};

package/dist/cjs/movements/types/catalog.js

@@ -28,4 +28,6 @@ exports.MOVEMENT_TYPES = {
     global_pay_to_generic: { code: "global_pay_to_generic", line: "payout", category: "payments", section: "usd_global" },
     swift: { code: "swift", line: "payout", category: "payments", section: "usd_global" },
     sepa: { code: "sepa", line: "payout", category: "payments", section: "eur" },
+    mint: { code: "mint", line: "stable", category: "conversions", section: "stablecoin", scope: "internal_ops" },
+    redeem: { code: "redeem", line: "stable", category: "conversions", section: "stablecoin", scope: "internal_ops" },
 };

package/dist/cjs/movements/types/locales/en.json

@@ -25,6 +25,8 @@
         "breb": "Instant payment · Bre-B",
         "global_pay_to_generic": "International payment",
         "swift": "International transfer · Swift",
-        "sepa": "International transfer · SEPA"
+        "sepa": "International transfer · SEPA",
+        "mint": "Stablecoin mint",
+        "redeem": "Stablecoin redemption"
     }
 }

package/dist/cjs/movements/types/locales/es-mex.json

@@ -25,6 +25,8 @@
         "breb": "Pago instantáneo · Bre-B",
         "global_pay_to_generic": "Pago internacional",
         "swift": "Transferencia internacional · Swift",
-        "sepa": "Transferencia internacional · SEPA"
+        "sepa": "Transferencia internacional · SEPA",
+        "mint": "Emisión de stablecoin",
+        "redeem": "Canje de stablecoin"
     }
 }

package/dist/cjs/movements/types/utils/movement-type.utils.d.ts

@@ -1,4 +1,4 @@
-import type { MovementType, MovementTypeRecord } from "../catalog";
+import type { MovementType, MovementTypeRecord, MovementTypeScope } from "../catalog";
 import type { Locale } from "../../../lang";
 import type { CatalogQuery } from "../../../utils/catalog-query.utils";
 export type MovementTypeOption = MovementTypeRecord & {
@@ -6,8 +6,15 @@ export type MovementTypeOption = MovementTypeRecord & {
 };
 export declare const getMovementTypes: (lang: Locale) => Record<MovementType, MovementTypeOption>;
 /** i18n domain: `lang` is required, inside the query object — see matchesQuery for the matching rules. */
-export type MovementTypeQuery = CatalogQuery<MovementTypeRecord> & {
+export type MovementTypeQuery = CatalogQuery<Omit<MovementTypeRecord, "scope">> & {
     lang: Locale;
+    scope?: MovementTypeScope | readonly MovementTypeScope[];
 };
-/** The catalog as a list narrowed by the query, each record enriched with its label for `query.lang`. */
+/**
+ * The catalog as a list narrowed by the query, each record enriched with its label for `query.lang`.
+ *
+ * `scope` is the one field with a default: leave the key out and only regular movement types come back, so a
+ * filter never inherits the internal ones by accident. That is also why `{ code: "mint" }` returns nothing —
+ * looking a movement type up by code is `getMovementTypes(lang)[code]`.
+ */
 export declare const queryMovementTypes: (query: MovementTypeQuery) => MovementTypeOption[];

package/dist/cjs/movements/types/utils/movement-type.utils.js

@@ -18,11 +18,18 @@ const getMovementTypes = (lang) => {
     return result;
 };
 exports.getMovementTypes = getMovementTypes;
-/** The catalog as a list narrowed by the query, each record enriched with its label for `query.lang`. */
+/**
+ * The catalog as a list narrowed by the query, each record enriched with its label for `query.lang`.
+ *
+ * `scope` is the one field with a default: leave the key out and only regular movement types come back, so a
+ * filter never inherits the internal ones by accident. That is also why `{ code: "mint" }` returns nothing —
+ * looking a movement type up by code is `getMovementTypes(lang)[code]`.
+ */
 const queryMovementTypes = (query) => {
     const { lang, ...filters } = query;
+    const withScopeDefault = "scope" in filters ? filters : { ...filters, scope: undefined };
     return Object.values(catalog_1.MOVEMENT_TYPES)
-        .filter(record => (0, catalog_query_utils_1.matchesQuery)(record, filters))
+        .filter(record => (0, catalog_query_utils_1.matchesQuery)(record, withScopeDefault))
         .map(record => ({ ...record, label: locales[lang].movementTypes[record.code] }));
 };
 exports.queryMovementTypes = queryMovementTypes;

package/dist/cjs/transactions/types/catalog.d.ts

@@ -388,6 +388,30 @@ export declare const TRANSACTION_TYPES: {
         readonly section: "usd_global";
         readonly group: "off_ramp";
     };
+    readonly stable_credit: {
+        readonly creditDebitType: "credit";
+        readonly code: "stable_credit";
+        readonly line: "stable";
+        readonly category: "conversions";
+        readonly section: "usd_global";
+        readonly group: null;
+    };
+    readonly stable_debit: {
+        readonly creditDebitType: "debit";
+        readonly code: "stable_debit";
+        readonly line: "stable";
+        readonly category: "conversions";
+        readonly section: "usd_global";
+        readonly group: null;
+    };
+    readonly stable_refund: {
+        readonly creditDebitType: "credit";
+        readonly code: "stable_refund";
+        readonly line: "stable";
+        readonly category: "conversions";
+        readonly section: "usd_global";
+        readonly group: null;
+    };
 };
 /** `when_present`: shown in the grouped type filter only when the data contains it. */
 export type TransactionTypeFilterDisplay = "when_present";

package/dist/cjs/transactions/types/catalog.js

@@ -391,4 +391,28 @@ exports.TRANSACTION_TYPES = {
         section: "usd_global",
         group: "off_ramp",
     },
+    stable_credit: {
+        creditDebitType: "credit",
+        code: "stable_credit",
+        line: "stable",
+        category: "conversions",
+        section: "usd_global",
+        group: null,
+    },
+    stable_debit: {
+        creditDebitType: "debit",
+        code: "stable_debit",
+        line: "stable",
+        category: "conversions",
+        section: "usd_global",
+        group: null,
+    },
+    stable_refund: {
+        creditDebitType: "credit",
+        code: "stable_refund",
+        line: "stable",
+        category: "conversions",
+        section: "usd_global",
+        group: null,
+    },
 };

package/dist/cjs/transactions/types/locales/en.json

@@ -47,7 +47,10 @@
         "global_rejected": "Rejection · Global",
         "offramp_treasury_credit": "Treasury conversion · Off-Ramp",
         "onramp_debit": "Conversion to stablecoin · On-Ramp · debit",
-        "offramp_credit": "Conversion to local currency · Off-Ramp · credit"
+        "offramp_credit": "Conversion to local currency · Off-Ramp · credit",
+        "stable_credit": "Stablecoin payment received",
+        "stable_debit": "Stablecoin payment",
+        "stable_refund": "Stablecoin payment refund"
     },
     "transactionTypeGroups": {
         "cbmm": "Cross-border movement · Debit and credit",

package/dist/cjs/transactions/types/locales/es-mex.json

@@ -47,7 +47,10 @@
         "global_rejected": "Rechazo · Global",
         "offramp_treasury_credit": "Conversión de tesorería · Off-Ramp",
         "onramp_debit": "Conversión a stablecoin · On-Ramp · débito",
-        "offramp_credit": "Conversión a moneda local · Off-Ramp · crédito"
+        "offramp_credit": "Conversión a moneda local · Off-Ramp · crédito",
+        "stable_credit": "Pago en stablecoin recibido",
+        "stable_debit": "Pago en stablecoin",
+        "stable_refund": "Reembolso de pago en stablecoin"
     },
     "transactionTypeGroups": {
         "cbmm": "Movimiento cross-border · Débito y crédito",

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

@@ -5,4 +5,6 @@ export const NATURES = {
     fx_conversion: { code: "fx_conversion" },
     on_ramp: { code: "on_ramp" },
     off_ramp: { code: "off_ramp" },
+    mint: { code: "mint" },
+    redeem: { code: "redeem" },
 };

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

@@ -5,6 +5,8 @@
         "return": "Return",
         "fx_conversion": "FX Conversion",
         "on_ramp": "On Ramp",
-        "off_ramp": "Off Ramp"
+        "off_ramp": "Off Ramp",
+        "mint": "Mint",
+        "redeem": "Redemption"
     }
 }

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

@@ -5,6 +5,8 @@
         "return": "Reversión",
         "fx_conversion": "Conversión FX",
         "on_ramp": "Conversión a stablecoin",
-        "off_ramp": "Conversión a moneda local"
+        "off_ramp": "Conversión a moneda local",
+        "mint": "Emisión",
+        "redeem": "Canje"
     }
 }

package/dist/esm/currencies/catalog.js

@@ -3,9 +3,9 @@ export const CURRENCIES = {
     mxn: { code: "mxn", label: "MXN", isoCode: "MXN", geo: "mex", flagAsset: "mex", minAmount: 0.01, type: "fiat" },
     usd: { code: "usd", label: "USD", isoCode: "USD", geo: "usa", flagAsset: "eu", minAmount: 100, type: "fiat" },
     usd_stable: { code: "usd_stable", label: "USD Stable", isoCode: "USD", geo: "global", flagAsset: "usd_stable", minAmount: 1, type: "stable" },
-    usdt: { code: "usdt", label: "USD (USDT)", isoCode: "USD", geo: "usa", flagAsset: "usdt", minAmount: 1, type: "stablecoin" },
-    usdc: { code: "usdc", label: "USD (USDC)", isoCode: "USD", geo: "usa", flagAsset: "usdc", minAmount: 1, type: "stablecoin" },
-    copco: { code: "copco", label: "COPco", isoCode: "COP", geo: "col", flagAsset: "cop_stable", minAmount: 1, type: "stable" },
+    usdt: { code: "usdt", label: "USD (USDT)", isoCode: "USD", geo: "usa", flagAsset: "usdt", minAmount: 1, type: "stablecoin", symbol: "USDT" },
+    usdc: { code: "usdc", label: "USD (USDC)", isoCode: "USD", geo: "usa", flagAsset: "usdc", minAmount: 1, type: "stablecoin", symbol: "USDC" },
+    copco: { code: "copco", label: "COPco", isoCode: "COP", geo: "col", flagAsset: "cop_stable", minAmount: 1, type: "stable", symbol: "COPco" },
     cny: { code: "cny", label: "RMB", isoCode: "CNY", geo: "chn", flagAsset: "chn", minAmount: 100, type: "fiat", scope: "counterparties" },
     eur: { code: "eur", label: "EUR", isoCode: "EUR", geo: "eur", flagAsset: "eur", minAmount: 100, type: "fiat", scope: "counterparties" },
 };

package/dist/esm/financialInstitutions/utils/financial-institution.utils.js

@@ -3,11 +3,8 @@ 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 };
-/**
- * The catalog indexed by code (same shape as FINANCIAL_INSTITUTIONS), each record enriched
- * with its label for the given language. Access by code directly, or Object.values for a list.
- */
-export const getFinancialInstitutions = (lang) => {
+// Built with the strict type so `queryFinancialInstitutions` lists it without the string index signature.
+const buildFinancialInstitutions = (lang) => {
     const locale = locales[lang];
     const result = {};
     for (const record of Object.values(FINANCIAL_INSTITUTIONS)) {
@@ -15,9 +12,13 @@ export const getFinancialInstitutions = (lang) => {
     }
     return result;
 };
+/**
+ * The catalog indexed by code (same shape as FINANCIAL_INSTITUTIONS), each record enriched
+ * with its label for the given language. Access by code directly; for a list use `queryFinancialInstitutions`.
+ */
+export const getFinancialInstitutions = (lang) => buildFinancialInstitutions(lang);
 /** The catalog as a list, narrowed by the query — see `matchesQuery` for the matching rules. */
 export const queryFinancialInstitutions = (query) => {
     const { lang, ...criteria } = query;
-    const institutions = getFinancialInstitutions(lang);
-    return Object.values(institutions).filter(institution => matchesQuery(institution, criteria));
+    return Object.values(buildFinancialInstitutions(lang)).filter(institution => matchesQuery(institution, criteria));
 };

package/dist/esm/movements/types/catalog.js

@@ -25,4 +25,6 @@ export const MOVEMENT_TYPES = {
     global_pay_to_generic: { code: "global_pay_to_generic", line: "payout", category: "payments", section: "usd_global" },
     swift: { code: "swift", line: "payout", category: "payments", section: "usd_global" },
     sepa: { code: "sepa", line: "payout", category: "payments", section: "eur" },
+    mint: { code: "mint", line: "stable", category: "conversions", section: "stablecoin", scope: "internal_ops" },
+    redeem: { code: "redeem", line: "stable", category: "conversions", section: "stablecoin", scope: "internal_ops" },
 };

package/dist/esm/movements/types/locales/en.json

@@ -25,6 +25,8 @@
         "breb": "Instant payment · Bre-B",
         "global_pay_to_generic": "International payment",
         "swift": "International transfer · Swift",
-        "sepa": "International transfer · SEPA"
+        "sepa": "International transfer · SEPA",
+        "mint": "Stablecoin mint",
+        "redeem": "Stablecoin redemption"
     }
 }

package/dist/esm/movements/types/locales/es-mex.json

@@ -25,6 +25,8 @@
         "breb": "Pago instantáneo · Bre-B",
         "global_pay_to_generic": "Pago internacional",
         "swift": "Transferencia internacional · Swift",
-        "sepa": "Transferencia internacional · SEPA"
+        "sepa": "Transferencia internacional · SEPA",
+        "mint": "Emisión de stablecoin",
+        "redeem": "Canje de stablecoin"
     }
 }

package/dist/esm/movements/types/utils/movement-type.utils.js

@@ -11,10 +11,17 @@ export const getMovementTypes = (lang) => {
     }
     return result;
 };
-/** The catalog as a list narrowed by the query, each record enriched with its label for `query.lang`. */
+/**
+ * The catalog as a list narrowed by the query, each record enriched with its label for `query.lang`.
+ *
+ * `scope` is the one field with a default: leave the key out and only regular movement types come back, so a
+ * filter never inherits the internal ones by accident. That is also why `{ code: "mint" }` returns nothing —
+ * looking a movement type up by code is `getMovementTypes(lang)[code]`.
+ */
 export const queryMovementTypes = (query) => {
     const { lang, ...filters } = query;
+    const withScopeDefault = "scope" in filters ? filters : { ...filters, scope: undefined };
     return Object.values(MOVEMENT_TYPES)
-        .filter(record => matchesQuery(record, filters))
+        .filter(record => matchesQuery(record, withScopeDefault))
         .map(record => ({ ...record, label: locales[lang].movementTypes[record.code] }));
 };

package/dist/esm/transactions/types/catalog.js

@@ -388,4 +388,28 @@ export const TRANSACTION_TYPES = {
         section: "usd_global",
         group: "off_ramp",
     },
+    stable_credit: {
+        creditDebitType: "credit",
+        code: "stable_credit",
+        line: "stable",
+        category: "conversions",
+        section: "usd_global",
+        group: null,
+    },
+    stable_debit: {
+        creditDebitType: "debit",
+        code: "stable_debit",
+        line: "stable",
+        category: "conversions",
+        section: "usd_global",
+        group: null,
+    },
+    stable_refund: {
+        creditDebitType: "credit",
+        code: "stable_refund",
+        line: "stable",
+        category: "conversions",
+        section: "usd_global",
+        group: null,
+    },
 };

package/dist/esm/transactions/types/locales/en.json

@@ -47,7 +47,10 @@
         "global_rejected": "Rejection · Global",
         "offramp_treasury_credit": "Treasury conversion · Off-Ramp",
         "onramp_debit": "Conversion to stablecoin · On-Ramp · debit",
-        "offramp_credit": "Conversion to local currency · Off-Ramp · credit"
+        "offramp_credit": "Conversion to local currency · Off-Ramp · credit",
+        "stable_credit": "Stablecoin payment received",
+        "stable_debit": "Stablecoin payment",
+        "stable_refund": "Stablecoin payment refund"
     },
     "transactionTypeGroups": {
         "cbmm": "Cross-border movement · Debit and credit",

package/dist/esm/transactions/types/locales/es-mex.json

@@ -47,7 +47,10 @@
         "global_rejected": "Rechazo · Global",
         "offramp_treasury_credit": "Conversión de tesorería · Off-Ramp",
         "onramp_debit": "Conversión a stablecoin · On-Ramp · débito",
-        "offramp_credit": "Conversión a moneda local · Off-Ramp · crédito"
+        "offramp_credit": "Conversión a moneda local · Off-Ramp · crédito",
+        "stable_credit": "Pago en stablecoin recibido",
+        "stable_debit": "Pago en stablecoin",
+        "stable_refund": "Reembolso de pago en stablecoin"
     },
     "transactionTypeGroups": {
         "cbmm": "Movimiento cross-border · Débito y crédito",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cobre-npm/library-portal-core",
-  "version": "0.64.0",
+  "version": "0.66.0",
   "description": "Shared configurations and resources for Portal MFEs",
   "main": "./dist/cjs/index.js",
   "module": "./dist/esm/index.js",