@cobre-npm/library-portal-core 0.37.0 → 0.38.0

package/README.md

@@ -136,15 +136,15 @@ 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 |
-| **Without i18n** | the label is fixed (or there is none) | `getX()` | currencies (inline label), accountProviders, movementStatus |
+| **Without i18n** | the label is fixed (or there is none) | `getX()` | currencies (inline label), accountProviders |
 
-`currencies`/`providers`/`status` **don't take `lang`** because there's no translation — the signature is honest.
+`currencies`/`providers` **don't take `lang`** because there's no translation — the signature is honest.
 
 ### Type convention
 
 - **`XOption`** = the catalog record **+ `label`** (what `getX(lang)` returns in i18n domains). This is the type
   consumers use to type results.
-- **`XRecord`** = the raw record. In non-i18n domains (currencies/providers/status) it is the result type
+- **`XRecord`** = the raw record. In non-i18n domains (currencies/providers) it is the result type
   (the label is already inline); in i18n domains it is **internal** (only input to `XOption`) and is not exported.
 - **`X`** (e.g. `AccountType`, `Currency`) = the union of codes. Always public (for typing variables/params).
 
@@ -222,14 +222,16 @@ hasCountryISOFlag("col")                // true — whether a flag asset is avai
 import {
   getMovementTypes, queryMovementTypes, type MovementType, type MovementTypeGroupLabel,
   type MovementTypeOption, type MovementTypeQuery,
-  getMovementStatuses, type MovementStatus, type MovementStatusRecord,
+  getMovementStatuses, queryMovementStatuses, type MovementStatus, type MovementStatusType,
+  type MovementStatusOption, type MovementStatusQuery,
 } from "@cobre-npm/library-portal-core/movements"
 
 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)
+getMovementStatuses("en").completed             // { code: "completed", label: "Completed", type: "success", icon: "icon-check" }
+queryMovementStatuses({ lang: "en", type: "error" })  // error, failed, rejected — localized
 ```
 
 - **types** (i18n): movement types (ACH, SPEI, R2P, …). `on_ramp`/`off_ramp`/`stable_payout`/`global`
@@ -247,7 +249,18 @@ getMovementStatuses().completed                      // { code: "completed" }
   ```ts
   queryMovementTypes({ lang, ...(group.value ? { groupLabel: group.value } : {}) })
   ```
-- **status** (no i18n): movement statuses (`initiated`, `processing`, `completed`, …).
+- **status** (i18n): movement statuses (`initiated`, `processing`, `completed`, …). Each record also
+  carries `type: MovementStatusType` (`success | warning | error | info | neutral | pending`) — a
+  Design-System-agnostic classification, not a UI component's prop value. Note it's `pending`, not
+  `status-pending`: the latter is a `ds-v3` `CobreBadge` variant name, and using it would tie this
+  library to that Design System. Mapping `type` to an actual badge variant/CSS class is each consumer's
+  job. `icon` is present on 9 of the 11 statuses (`under_review` and `pending_funds` have none) — unlike
+  `type`, `icon` **is** coupled to the portal's current icon set (its values are that set's class names);
+  a consumer without it should map its own icon from `code`/`type` instead.
+- **status query** (i18n `queryX()`): `queryMovementStatuses({ lang, ...filters })` — `code` and `type`
+  are the filterable fields; there's no `label` filter, same as every other `queryX()` here. `type` is
+  the real use case: `queryMovementStatuses({ lang, type: "error" })` returns `error`, `failed`,
+  `rejected`, replacing a hand-maintained list of codes with a query.
 
 ### `subclients`
 

package/dist/movements/index.d.ts

@@ -1,5 +1,5 @@
 export type { MovementType, MovementTypeGroup, MovementTypeGroupLabel } from "./types/catalog";
 export * from "./types/utils/movement-type.utils";
-export type { MovementStatus, MovementStatusRecord } from "./status/catalog";
+export type { MovementStatus, MovementStatusType } from "./status/catalog";
 export * from "./status/utils/movement-status.utils";
 //# sourceMappingURL=index.d.ts.map

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,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAA;AAC9F,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,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAA;AAC9F,cAAc,mCAAmC,CAAA;AAEjD,YAAY,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AAC1E,cAAc,sCAAsC,CAAA"}

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

@@ -1,38 +1,61 @@
+export type MovementStatusType = "success" | "warning" | "error" | "info" | "neutral" | "pending";
 export declare const MOVEMENT_STATUSES: {
     readonly initiated: {
         readonly code: "initiated";
+        readonly type: "info";
+        readonly icon: "icon-hourglass-03";
     };
     readonly processing: {
         readonly code: "processing";
+        readonly type: "info";
+        readonly icon: "icon-refresh-ccw-02";
     };
     readonly completed: {
         readonly code: "completed";
+        readonly type: "success";
+        readonly icon: "icon-check";
     };
     readonly canceled: {
         readonly code: "canceled";
+        readonly type: "neutral";
+        readonly icon: "icon-x-circle";
     };
     readonly under_review: {
         readonly code: "under_review";
+        readonly type: "warning";
     };
     readonly returned: {
         readonly code: "returned";
+        readonly type: "neutral";
+        readonly icon: "icon-flip-backward";
     };
     readonly rejected: {
         readonly code: "rejected";
+        readonly type: "error";
+        readonly icon: "icon-file-question-01";
     };
     readonly failed: {
         readonly code: "failed";
+        readonly type: "error";
+        readonly icon: "icon-file-x-01";
     };
     readonly pending_approval: {
         readonly code: "pending_approval";
+        readonly type: "pending";
+        readonly icon: "icon-file-question-01";
     };
     readonly pending_funds: {
         readonly code: "pending_funds";
+        readonly type: "warning";
     };
     readonly error: {
         readonly code: "error";
+        readonly type: "error";
+        readonly icon: "icon-file-x-03";
     };
 };
 export type MovementStatus = keyof typeof MOVEMENT_STATUSES;
-export type MovementStatusRecord = (typeof MOVEMENT_STATUSES)[MovementStatus];
+export type MovementStatusRecord = (typeof MOVEMENT_STATUSES)[MovementStatus] & {
+    readonly icon?: string;
+};
 //# sourceMappingURL=catalog.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../../src/movements/status/catalog.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAYpB,CAAA;AAEV,MAAM,MAAM,cAAc,GAAG,MAAM,OAAO,iBAAiB,CAAA;AAC3D,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,cAAc,CAAC,CAAA"}
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../../src/movements/status/catalog.ts"],"names":[],"mappings":"AASA,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,CAAA;AAEjG,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAYgE,CAAA;AAE9F,MAAM,MAAM,cAAc,GAAG,MAAM,OAAO,iBAAiB,CAAA;AAM3D,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,cAAc,CAAC,GAC3E;IAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA"}

package/dist/movements/status/catalog.js

@@ -2,16 +2,16 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MOVEMENT_STATUSES = void 0;
 exports.MOVEMENT_STATUSES = {
-    initiated: { code: "initiated" },
-    processing: { code: "processing" },
-    completed: { code: "completed" },
-    canceled: { code: "canceled" },
-    under_review: { code: "under_review" },
-    returned: { code: "returned" },
-    rejected: { code: "rejected" },
-    failed: { code: "failed" },
-    pending_approval: { code: "pending_approval" },
-    pending_funds: { code: "pending_funds" },
-    error: { code: "error" },
+    initiated: { code: "initiated", type: "info", icon: "icon-hourglass-03" },
+    processing: { code: "processing", type: "info", icon: "icon-refresh-ccw-02" },
+    completed: { code: "completed", type: "success", icon: "icon-check" },
+    canceled: { code: "canceled", type: "neutral", icon: "icon-x-circle" },
+    under_review: { code: "under_review", type: "warning" },
+    returned: { code: "returned", type: "neutral", icon: "icon-flip-backward" },
+    rejected: { code: "rejected", type: "error", icon: "icon-file-question-01" },
+    failed: { code: "failed", type: "error", icon: "icon-file-x-01" },
+    pending_approval: { code: "pending_approval", type: "pending", icon: "icon-file-question-01" },
+    pending_funds: { code: "pending_funds", type: "warning" },
+    error: { code: "error", type: "error", icon: "icon-file-x-03" },
 };
 //# sourceMappingURL=catalog.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../../../src/movements/status/catalog.ts"],"names":[],"mappings":";;;AAAa,QAAA,iBAAiB,GAAG;IAC/B,SAAS,EAAU,EAAE,IAAI,EAAE,WAAW,EAAE;IACxC,UAAU,EAAS,EAAE,IAAI,EAAE,YAAY,EAAE;IACzC,SAAS,EAAU,EAAE,IAAI,EAAE,WAAW,EAAE;IACxC,QAAQ,EAAW,EAAE,IAAI,EAAE,UAAU,EAAE;IACvC,YAAY,EAAO,EAAE,IAAI,EAAE,cAAc,EAAE;IAC3C,QAAQ,EAAW,EAAE,IAAI,EAAE,UAAU,EAAE;IACvC,QAAQ,EAAW,EAAE,IAAI,EAAE,UAAU,EAAE;IACvC,MAAM,EAAa,EAAE,IAAI,EAAE,QAAQ,EAAE;IACrC,gBAAgB,EAAG,EAAE,IAAI,EAAE,kBAAkB,EAAE;IAC/C,aAAa,EAAM,EAAE,IAAI,EAAE,eAAe,EAAE;IAC5C,KAAK,EAAc,EAAE,IAAI,EAAE,OAAO,EAAE;CAC5B,CAAA"}
+{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../../../src/movements/status/catalog.ts"],"names":[],"mappings":";;;AAWa,QAAA,iBAAiB,GAAG;IAC/B,SAAS,EAAU,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,mBAAmB,EAAE;IACjF,UAAU,EAAS,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,qBAAqB,EAAE;IACpF,SAAS,EAAU,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,YAAY,EAAE;IAC7E,QAAQ,EAAW,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,eAAe,EAAE;IAC/E,YAAY,EAAO,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,SAAS,EAAE;IAC5D,QAAQ,EAAW,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,oBAAoB,EAAE;IACpF,QAAQ,EAAW,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,uBAAuB,EAAE;IACrF,MAAM,EAAa,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAE;IAC5E,gBAAgB,EAAG,EAAE,IAAI,EAAE,kBAAkB,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,uBAAuB,EAAE;IAC/F,aAAa,EAAM,EAAE,IAAI,EAAE,eAAe,EAAE,IAAI,EAAE,SAAS,EAAE;IAC7D,KAAK,EAAc,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAE;CACiB,CAAA"}

package/dist/movements/status/locales/en.json

@@ -0,0 +1,15 @@
+{
+    "movementStatuses": {
+        "initiated": "Initiated",
+        "processing": "Processing",
+        "completed": "Completed",
+        "canceled": "Canceled",
+        "under_review": "Under Review",
+        "returned": "Returned",
+        "rejected": "Rejected",
+        "failed": "Failed",
+        "pending_approval": "Pending Approval",
+        "pending_funds": "Waiting funds",
+        "error": "Error"
+    }
+}

package/dist/movements/status/locales/es-mex.json

@@ -0,0 +1,15 @@
+{
+    "movementStatuses": {
+        "initiated": "Iniciado",
+        "processing": "Procesando",
+        "completed": "Completado",
+        "canceled": "Cancelado",
+        "under_review": "Bajo revisión",
+        "returned": "Devuelto",
+        "rejected": "Rechazado",
+        "failed": "Fallido",
+        "pending_approval": "Por aprobar",
+        "pending_funds": "Esperando fondos",
+        "error": "Error"
+    }
+}

package/dist/movements/status/utils/movement-status.utils.d.ts

@@ -1,3 +1,17 @@
 import type { MovementStatus, MovementStatusRecord } from "../catalog";
-export declare const getMovementStatuses: () => Record<MovementStatus, MovementStatusRecord>;
+import type { Locale } from "../../../lang";
+import type { CatalogQuery } from "../../../utils/catalog-query.utils";
+export type MovementStatusOption = MovementStatusRecord & {
+    label: string;
+};
+export declare const getMovementStatuses: (lang: Locale) => Record<MovementStatus, MovementStatusOption>;
+/** i18n domain: `lang` is required, inside the query object — see matchesQuery for the matching rules. */
+export type MovementStatusQuery = CatalogQuery<MovementStatusRecord> & {
+    lang: Locale;
+};
+/**
+ * The catalog as a list narrowed by the query, each record enriched with its label for `query.lang`.
+ * `code` is the only filterable field — `label` is display text, added after filtering, never a query key.
+ */
+export declare const queryMovementStatuses: (query: MovementStatusQuery) => MovementStatusOption[];
 //# sourceMappingURL=movement-status.utils.d.ts.map

package/dist/movements/status/utils/movement-status.utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"movement-status.utils.d.ts","sourceRoot":"","sources":["../../../../src/movements/status/utils/movement-status.utils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAA;AAEtE,eAAO,MAAM,mBAAmB,QAAO,MAAM,CAAC,cAAc,EAAE,oBAAoB,CAAsB,CAAA"}
+{"version":3,"file":"movement-status.utils.d.ts","sourceRoot":"","sources":["../../../../src/movements/status/utils/movement-status.utils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAA;AAGtE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AAE3C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAA;AAItE,MAAM,MAAM,oBAAoB,GAAG,oBAAoB,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAAA;AAE3E,eAAO,MAAM,mBAAmB,GAAI,MAAM,MAAM,KAAG,MAAM,CAAC,cAAc,EAAE,oBAAoB,CAS7F,CAAA;AAED,0GAA0G;AAC1G,MAAM,MAAM,mBAAmB,GAAG,YAAY,CAAC,oBAAoB,CAAC,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAA;AAEvF;;;GAGG;AACH,eAAO,MAAM,qBAAqB,GAAI,OAAO,mBAAmB,KAAG,oBAAoB,EAMtF,CAAA"}

package/dist/movements/status/utils/movement-status.utils.js

@@ -1,7 +1,32 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getMovementStatuses = void 0;
+exports.queryMovementStatuses = exports.getMovementStatuses = void 0;
 const catalog_1 = require("../catalog");
-const getMovementStatuses = () => catalog_1.MOVEMENT_STATUSES;
+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 getMovementStatuses = (lang) => {
+    const locale = locales[lang];
+    const result = {};
+    for (const record of Object.values(catalog_1.MOVEMENT_STATUSES)) {
+        result[record.code] = { ...record, label: locale.movementStatuses[record.code] };
+    }
+    return result;
+};
 exports.getMovementStatuses = getMovementStatuses;
+/**
+ * The catalog as a list narrowed by the query, each record enriched with its label for `query.lang`.
+ * `code` is the only filterable field — `label` is display text, added after filtering, never a query key.
+ */
+const queryMovementStatuses = (query) => {
+    const { lang, ...filters } = query;
+    return Object.values(catalog_1.MOVEMENT_STATUSES)
+        .filter(record => (0, catalog_query_utils_1.matchesQuery)(record, filters))
+        .map(record => ({ ...record, label: locales[lang].movementStatuses[record.code] }));
+};
+exports.queryMovementStatuses = queryMovementStatuses;
 //# sourceMappingURL=movement-status.utils.js.map

package/dist/movements/status/utils/movement-status.utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"movement-status.utils.js","sourceRoot":"","sources":["../../../../src/movements/status/utils/movement-status.utils.ts"],"names":[],"mappings":";;;AAAA,wCAA8C;AAGvC,MAAM,mBAAmB,GAAG,GAAiD,EAAE,CAAC,2BAAiB,CAAA;AAA3F,QAAA,mBAAmB,uBAAwE"}
+{"version":3,"file":"movement-status.utils.js","sourceRoot":"","sources":["../../../../src/movements/status/utils/movement-status.utils.ts"],"names":[],"mappings":";;;;;;AAAA,wCAA8C;AAE9C,iEAAyC;AACzC,yEAAgD;AAEhD,4EAAiE;AAGjE,MAAM,OAAO,GAAuC,EAAE,EAAE,EAAE,iBAAQ,EAAE,QAAQ,EAAE,qBAAW,EAAE,CAAA;AAIpF,MAAM,mBAAmB,GAAG,CAAC,IAAY,EAAgD,EAAE;IAChG,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC5B,MAAM,MAAM,GAAG,EAAkD,CAAA;IAEjE,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,2BAAiB,CAAC,EAAE,CAAC;QACtD,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,gBAAgB,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAA;IAClF,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC,CAAA;AATY,QAAA,mBAAmB,uBAS/B;AAKD;;;GAGG;AACI,MAAM,qBAAqB,GAAG,CAAC,KAA0B,EAA0B,EAAE;IAC1F,MAAM,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,GAAG,KAAK,CAAA;IAElC,OAAO,MAAM,CAAC,MAAM,CAAC,2BAAiB,CAAC;SACpC,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,gBAAgB,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAA;AACvF,CAAC,CAAA;AANY,QAAA,qBAAqB,yBAMjC"}

package/package.json

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