@cobre-npm/library-portal-core 0.33.0 → 0.35.0

package/README.md

@@ -212,15 +212,33 @@ hasCountryISOFlag("col")                // true — whether a flag asset is avai
 
 ```ts
 import {
-  getMovementTypes, type MovementType, type MovementTypeOption,
+  getMovementTypes, queryMovementTypes, type MovementType, type MovementTypeGroupLabel,
+  type MovementTypeOption, type MovementTypeQuery,
   getMovementStatuses, type MovementStatus, type MovementStatusRecord,
 } from "@cobre-npm/library-portal-core/movements"
 
-getMovementTypes("en").ach.label        // "ACH"
-getMovementStatuses().completed         // { code: "completed" }   (no i18n)
+getMovementTypes("en").ach.label                    // "ACH"
+getMovementTypes("en").on_ramp.groupLabel            // "Stablecoin"
+getMovementTypes("en").on_ramp.label                 // "On Ramp" (individual label, unchanged)
+queryMovementTypes({ lang: "en", groupLabel: "Stablecoin" })  // global, off_ramp, on_ramp, stable_payout
+getMovementStatuses().completed                      // { code: "completed" }   (no i18n)
 ```
 
-- **types** (i18n): movement types (ACH, SPEI, R2P, …).
+- **types** (i18n): movement types (ACH, SPEI, R2P, …). `on_ramp`/`off_ramp`/`stable_payout`/`global`
+  additionally carry `groupLabel: "Stablecoin"` — a display grouping for views that need to show them
+  under one label. `getMovementTypes()` keeps returning each rail's own individual `label` unchanged; a
+  consumer that wants the grouped label picks `groupLabel ?? label`. There's no separate `getXLabel`
+  for this — the value already comes back inside `getMovementTypes()`, same as everything else in this
+  catalog.
+- **types query** (i18n `queryX()`): `queryMovementTypes({ lang, ...filters })` — same rules as
+  `queryTransactionTypes`/`queryDocumentTypes`, no default field. `groupLabel` is the only filterable
+  field besides `code`, and it's optional on the record: **a key that is present always filters**, so
+  `groupLabel: undefined` matches the 19 rails that don't carry a group, not "no filter". An optional UI
+  filter has to be spread in conditionally:
+
+  ```ts
+  queryMovementTypes({ lang, ...(group.value ? { groupLabel: group.value } : {}) })
+  ```
 - **status** (no i18n): movement statuses (`initiated`, `processing`, `completed`, …).
 
 ### `subclients`

package/dist/movements/index.d.ts

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

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/movements/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AACnD,cAAc,mCAAmC,CAAA;AAEjD,YAAY,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAA;AAC5E,cAAc,sCAAsC,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/movements/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,YAAY,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAA;AAC3E,cAAc,mCAAmC,CAAA;AAEjD,YAAY,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAA;AAC5E,cAAc,sCAAsC,CAAA"}

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

@@ -1,3 +1,4 @@
+export type MovementTypeGroupLabel = "Stablecoin";
 export declare const MOVEMENT_TYPES: {
     readonly ach: {
         readonly code: "ach";
@@ -40,15 +41,18 @@ export declare const MOVEMENT_TYPES: {
     };
     readonly global: {
         readonly code: "global";
+        readonly groupLabel: "Stablecoin";
     };
     readonly r2p_spei: {
         readonly code: "r2p_spei";
     };
     readonly on_ramp: {
         readonly code: "on_ramp";
+        readonly groupLabel: "Stablecoin";
     };
     readonly off_ramp: {
         readonly code: "off_ramp";
+        readonly groupLabel: "Stablecoin";
     };
     readonly fedwire: {
         readonly code: "fedwire";
@@ -61,6 +65,7 @@ export declare const MOVEMENT_TYPES: {
     };
     readonly stable_payout: {
         readonly code: "stable_payout";
+        readonly groupLabel: "Stablecoin";
     };
     readonly breb: {
         readonly code: "breb";
@@ -70,5 +75,7 @@ export declare const MOVEMENT_TYPES: {
     };
 };
 export type MovementType = keyof typeof MOVEMENT_TYPES;
-export type MovementTypeRecord = (typeof MOVEMENT_TYPES)[MovementType];
+export type MovementTypeRecord = (typeof MOVEMENT_TYPES)[MovementType] & {
+    readonly groupLabel?: MovementTypeGroupLabel;
+};
 //# sourceMappingURL=catalog.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../../src/movements/types/catalog.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwBjB,CAAA;AAEV,MAAM,MAAM,YAAY,GAAG,MAAM,OAAO,cAAc,CAAA;AACtD,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,YAAY,CAAC,CAAA"}
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../../src/movements/types/catalog.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,sBAAsB,GAAG,YAAY,CAAA;AAEjD,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwB+D,CAAA;AAE1F,MAAM,MAAM,YAAY,GAAG,MAAM,OAAO,cAAc,CAAA;AAMtD,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,YAAY,CAAC,GAAG;IAAE,QAAQ,CAAC,UAAU,CAAC,EAAE,sBAAsB,CAAA;CAAE,CAAA"}

package/dist/movements/types/catalog.js

@@ -15,14 +15,14 @@ exports.MOVEMENT_TYPES = {
     r2p_breb: { code: "r2p_breb" },
     r2p_top_up_pse: { code: "r2p_top_up_pse" },
     r2p_top_up_bancolombia: { code: "r2p_top_up_bancolombia" },
-    global: { code: "global" },
+    global: { code: "global", groupLabel: "Stablecoin" },
     r2p_spei: { code: "r2p_spei" },
-    on_ramp: { code: "on_ramp" },
-    off_ramp: { code: "off_ramp" },
+    on_ramp: { code: "on_ramp", groupLabel: "Stablecoin" },
+    off_ramp: { code: "off_ramp", groupLabel: "Stablecoin" },
     fedwire: { code: "fedwire" },
     global_pay_to_usa: { code: "global_pay_to_usa" },
     usa_pay_to_global: { code: "usa_pay_to_global" },
-    stable_payout: { code: "stable_payout" },
+    stable_payout: { code: "stable_payout", groupLabel: "Stablecoin" },
     breb: { code: "breb" },
     global_pay_to_generic: { code: "global_pay_to_generic" },
 };

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

@@ -1 +1 @@
-{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../../../src/movements/types/catalog.ts"],"names":[],"mappings":";;;AAAa,QAAA,cAAc,GAAG;IAC5B,GAAG,EAAqB,EAAE,IAAI,EAAE,KAAK,EAAE;IACvC,QAAQ,EAAgB,EAAE,IAAI,EAAE,UAAU,EAAE;IAC5C,IAAI,EAAoB,EAAE,IAAI,EAAE,MAAM,EAAE;IACxC,SAAS,EAAe,EAAE,IAAI,EAAE,WAAW,EAAE;IAC7C,WAAW,EAAa,EAAE,IAAI,EAAE,aAAa,EAAE;IAC/C,GAAG,EAAqB,EAAE,IAAI,EAAE,KAAK,EAAE;IACvC,eAAe,EAAS,EAAE,IAAI,EAAE,iBAAiB,EAAE;IACnD,SAAS,EAAe,EAAE,IAAI,EAAE,WAAW,EAAE;IAC7C,OAAO,EAAiB,EAAE,IAAI,EAAE,SAAS,EAAE;IAC3C,YAAY,EAAY,EAAE,IAAI,EAAE,cAAc,EAAE;IAChD,QAAQ,EAAgB,EAAE,IAAI,EAAE,UAAU,EAAE;IAC5C,cAAc,EAAU,EAAE,IAAI,EAAE,gBAAgB,EAAE;IAClD,sBAAsB,EAAE,EAAE,IAAI,EAAE,wBAAwB,EAAE;IAC1D,MAAM,EAAkB,EAAE,IAAI,EAAE,QAAQ,EAAE;IAC1C,QAAQ,EAAgB,EAAE,IAAI,EAAE,UAAU,EAAE;IAC5C,OAAO,EAAiB,EAAE,IAAI,EAAE,SAAS,EAAE;IAC3C,QAAQ,EAAgB,EAAE,IAAI,EAAE,UAAU,EAAE;IAC5C,OAAO,EAAiB,EAAE,IAAI,EAAE,SAAS,EAAE;IAC3C,iBAAiB,EAAO,EAAE,IAAI,EAAE,mBAAmB,EAAE;IACrD,iBAAiB,EAAO,EAAE,IAAI,EAAE,mBAAmB,EAAE;IACrD,aAAa,EAAW,EAAE,IAAI,EAAE,eAAe,EAAE;IACjD,IAAI,EAAoB,EAAE,IAAI,EAAE,MAAM,EAAE;IACxC,qBAAqB,EAAG,EAAE,IAAI,EAAE,uBAAuB,EAAE;CACjD,CAAA"}
+{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../../../src/movements/types/catalog.ts"],"names":[],"mappings":";;;AAMa,QAAA,cAAc,GAAG;IAC5B,GAAG,EAAqB,EAAE,IAAI,EAAE,KAAK,EAAE;IACvC,QAAQ,EAAgB,EAAE,IAAI,EAAE,UAAU,EAAE;IAC5C,IAAI,EAAoB,EAAE,IAAI,EAAE,MAAM,EAAE;IACxC,SAAS,EAAe,EAAE,IAAI,EAAE,WAAW,EAAE;IAC7C,WAAW,EAAa,EAAE,IAAI,EAAE,aAAa,EAAE;IAC/C,GAAG,EAAqB,EAAE,IAAI,EAAE,KAAK,EAAE;IACvC,eAAe,EAAS,EAAE,IAAI,EAAE,iBAAiB,EAAE;IACnD,SAAS,EAAe,EAAE,IAAI,EAAE,WAAW,EAAE;IAC7C,OAAO,EAAiB,EAAE,IAAI,EAAE,SAAS,EAAE;IAC3C,YAAY,EAAY,EAAE,IAAI,EAAE,cAAc,EAAE;IAChD,QAAQ,EAAgB,EAAE,IAAI,EAAE,UAAU,EAAE;IAC5C,cAAc,EAAU,EAAE,IAAI,EAAE,gBAAgB,EAAE;IAClD,sBAAsB,EAAE,EAAE,IAAI,EAAE,wBAAwB,EAAE;IAC1D,MAAM,EAAkB,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,YAAY,EAAE;IACpE,QAAQ,EAAgB,EAAE,IAAI,EAAE,UAAU,EAAE;IAC5C,OAAO,EAAiB,EAAE,IAAI,EAAE,SAAS,EAAE,UAAU,EAAE,YAAY,EAAE;IACrE,QAAQ,EAAgB,EAAE,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,YAAY,EAAE;IACtE,OAAO,EAAiB,EAAE,IAAI,EAAE,SAAS,EAAE;IAC3C,iBAAiB,EAAO,EAAE,IAAI,EAAE,mBAAmB,EAAE;IACrD,iBAAiB,EAAO,EAAE,IAAI,EAAE,mBAAmB,EAAE;IACrD,aAAa,EAAW,EAAE,IAAI,EAAE,eAAe,EAAE,UAAU,EAAE,YAAY,EAAE;IAC3E,IAAI,EAAoB,EAAE,IAAI,EAAE,MAAM,EAAE;IACxC,qBAAqB,EAAG,EAAE,IAAI,EAAE,uBAAuB,EAAE;CAC+B,CAAA"}

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

@@ -1,7 +1,20 @@
 import type { MovementType, MovementTypeRecord } from "../catalog";
 import type { Locale } from "../../../lang";
+import type { CatalogQuery } from "../../../utils/catalog-query.utils";
 export type MovementTypeOption = MovementTypeRecord & {
     label: string;
 };
 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> & {
+    lang: Locale;
+};
+/**
+ * The catalog as a list narrowed by the query, each record enriched with its label for `query.lang`.
+ *
+ * `groupLabel` is optional on the record, so `groupLabel: undefined` is a present key like any other —
+ * it matches the 19 records that don't carry a group, not "no filter". A UI filter fed from an optional
+ * ref has to be spread in conditionally: `{ lang, ...(group ? { groupLabel: group } : {}) }`.
+ */
+export declare const queryMovementTypes: (query: MovementTypeQuery) => MovementTypeOption[];
 //# sourceMappingURL=movement-type.utils.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"movement-type.utils.d.ts","sourceRoot":"","sources":["../../../../src/movements/types/utils/movement-type.utils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAGlE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AAI3C,MAAM,MAAM,kBAAkB,GAAG,kBAAkB,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAAA;AAEvE,eAAO,MAAM,gBAAgB,GAAI,MAAM,MAAM,KAAG,MAAM,CAAC,YAAY,EAAE,kBAAkB,CAStF,CAAA"}
+{"version":3,"file":"movement-type.utils.d.ts","sourceRoot":"","sources":["../../../../src/movements/types/utils/movement-type.utils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAGlE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AAE3C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAA;AAItE,MAAM,MAAM,kBAAkB,GAAG,kBAAkB,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAAA;AAEvE,eAAO,MAAM,gBAAgB,GAAI,MAAM,MAAM,KAAG,MAAM,CAAC,YAAY,EAAE,kBAAkB,CAStF,CAAA;AAED,0GAA0G;AAC1G,MAAM,MAAM,iBAAiB,GAAG,YAAY,CAAC,kBAAkB,CAAC,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAA;AAEnF;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,GAAI,OAAO,iBAAiB,KAAG,kBAAkB,EAM/E,CAAA"}

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

@@ -3,10 +3,11 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getMovementTypes = void 0;
+exports.queryMovementTypes = exports.getMovementTypes = 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 getMovementTypes = (lang) => {
     const locale = locales[lang];
@@ -17,4 +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`.
+ *
+ * `groupLabel` is optional on the record, so `groupLabel: undefined` is a present key like any other —
+ * it matches the 19 records that don't carry a group, not "no filter". A UI filter fed from an optional
+ * ref has to be spread in conditionally: `{ lang, ...(group ? { groupLabel: group } : {}) }`.
+ */
+const queryMovementTypes = (query) => {
+    const { lang, ...filters } = query;
+    return Object.values(catalog_1.MOVEMENT_TYPES)
+        .filter(record => (0, catalog_query_utils_1.matchesQuery)(record, filters))
+        .map(record => ({ ...record, label: locales[lang].movementTypes[record.code] }));
+};
+exports.queryMovementTypes = queryMovementTypes;
 //# sourceMappingURL=movement-type.utils.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"movement-type.utils.js","sourceRoot":"","sources":["../../../../src/movements/types/utils/movement-type.utils.ts"],"names":[],"mappings":";;;;;;AAAA,wCAA2C;AAE3C,iEAAyC;AACzC,yEAAgD;AAGhD,MAAM,OAAO,GAAuC,EAAE,EAAE,EAAE,iBAAQ,EAAE,QAAQ,EAAE,qBAAW,EAAE,CAAA;AAIpF,MAAM,gBAAgB,GAAG,CAAC,IAAY,EAA4C,EAAE;IACzF,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC5B,MAAM,MAAM,GAAG,EAA8C,CAAA;IAE7D,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,wBAAc,CAAC,EAAE,CAAC;QACnD,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAA;IAC/E,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC,CAAA;AATY,QAAA,gBAAgB,oBAS5B"}
+{"version":3,"file":"movement-type.utils.js","sourceRoot":"","sources":["../../../../src/movements/types/utils/movement-type.utils.ts"],"names":[],"mappings":";;;;;;AAAA,wCAA2C;AAE3C,iEAAyC;AACzC,yEAAgD;AAEhD,4EAAiE;AAGjE,MAAM,OAAO,GAAuC,EAAE,EAAE,EAAE,iBAAQ,EAAE,QAAQ,EAAE,qBAAW,EAAE,CAAA;AAIpF,MAAM,gBAAgB,GAAG,CAAC,IAAY,EAA4C,EAAE;IACzF,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC5B,MAAM,MAAM,GAAG,EAA8C,CAAA;IAE7D,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,wBAAc,CAAC,EAAE,CAAC;QACnD,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAA;IAC/E,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC,CAAA;AATY,QAAA,gBAAgB,oBAS5B;AAKD;;;;;;GAMG;AACI,MAAM,kBAAkB,GAAG,CAAC,KAAwB,EAAwB,EAAE;IACnF,MAAM,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,GAAG,KAAK,CAAA;IAElC,OAAO,MAAM,CAAC,MAAM,CAAC,wBAAc,CAAC;SACjC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,IAAA,kCAAY,EAAC,MAAM,EAAE,OAAO,CAAC,CAAC;SAC/C,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAA;AACpF,CAAC,CAAA;AANY,QAAA,kBAAkB,sBAM9B"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cobre-npm/library-portal-core",
-  "version": "0.33.0",
+  "version": "0.35.0",
   "description": "Shared configurations and resources for Portal MFEs",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",