@cobre-npm/library-portal-core 0.67.0 → 0.68.0

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

@@ -3,7 +3,8 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.queryFinancialInstitutions = exports.getFinancialInstitutions = void 0;
+exports.queryFinancialInstitutions = void 0;
+exports.getFinancialInstitutions = getFinancialInstitutions;
 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"));
@@ -18,12 +19,15 @@ const buildFinancialInstitutions = (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;
+function getFinancialInstitutions(...args) {
+    if (args.length !== 0)
+        return buildFinancialInstitutions(args[0]);
+    const result = {};
+    for (const record of Object.values(catalog_1.FINANCIAL_INSTITUTIONS)) {
+        result[record.code] = { ...record };
+    }
+    return result;
+}
 /** The catalog as a list, narrowed by the query — see `matchesQuery` for the matching rules. */
 const queryFinancialInstitutions = (query) => {
     const { lang, ...criteria } = query;

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

@@ -2,3 +2,11 @@ export declare const DEFAULT_EN_LOCALE = "en";
 export declare const DEFAULT_ES_LOCALE = "es-mex";
 export declare const LOCALES: readonly ["en", "es-mex"];
 export type Locale = (typeof LOCALES)[number];
+/**
+ * Narrows any string to a supported `Locale`: an exact member of `LOCALES` passes through, anything else
+ * falls back to `DEFAULT_ES_LOCALE`. The active language is not always a library literal (a user preference
+ * saved without validation, `en-US` from the browser), and every translated `getX(lang)` / `queryX({ lang })`
+ * indexes its messages by the exact string and throws on anything else. Call it once where a pipeline reads
+ * the active language, not at every call site.
+ */
+export declare const toSupportedLocale: (lang: string) => Locale;

package/dist/cjs/lang/index.js

@@ -1,6 +1,16 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.LOCALES = exports.DEFAULT_ES_LOCALE = exports.DEFAULT_EN_LOCALE = void 0;
+exports.toSupportedLocale = exports.LOCALES = exports.DEFAULT_ES_LOCALE = exports.DEFAULT_EN_LOCALE = void 0;
 exports.DEFAULT_EN_LOCALE = "en";
 exports.DEFAULT_ES_LOCALE = "es-mex";
 exports.LOCALES = [exports.DEFAULT_EN_LOCALE, exports.DEFAULT_ES_LOCALE];
+const SUPPORTED_LOCALES = exports.LOCALES;
+/**
+ * Narrows any string to a supported `Locale`: an exact member of `LOCALES` passes through, anything else
+ * falls back to `DEFAULT_ES_LOCALE`. The active language is not always a library literal (a user preference
+ * saved without validation, `en-US` from the browser), and every translated `getX(lang)` / `queryX({ lang })`
+ * indexes its messages by the exact string and throws on anything else. Call it once where a pipeline reads
+ * the active language, not at every call site.
+ */
+const toSupportedLocale = (lang) => SUPPORTED_LOCALES.includes(lang) ? lang : exports.DEFAULT_ES_LOCALE;
+exports.toSupportedLocale = toSupportedLocale;

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

@@ -1,10 +1,13 @@
 import type { MovementStatus, MovementStatusRecord } from "../catalog";
 import type { Locale } from "../../../lang";
 import type { CatalogQuery } from "../../../utils/catalog-query.utils";
+import type { WithoutLabel } from "../../../utils/catalog-label.utils";
 export type MovementStatusOption = MovementStatusRecord & {
     label: string;
 };
-export declare const getMovementStatuses: (lang: Locale) => Record<MovementStatus, MovementStatusOption>;
+/** Without `lang`: the records with no `label`, to read codes and metadata where no language applies. */
+export declare function getMovementStatuses(): Record<MovementStatus, WithoutLabel<MovementStatusOption>>;
+export declare function 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;

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

@@ -3,21 +3,20 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.queryMovementStatuses = exports.getMovementStatuses = void 0;
+exports.queryMovementStatuses = void 0;
+exports.getMovementStatuses = getMovementStatuses;
 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 getMovementStatuses = (lang) => {
-    const locale = locales[lang];
+function getMovementStatuses(...args) {
     const result = {};
     for (const record of Object.values(catalog_1.MOVEMENT_STATUSES)) {
-        result[record.code] = { ...record, label: locale.movementStatuses[record.code] };
+        result[record.code] = args.length === 0 ? { ...record } : { ...record, label: locales[args[0]].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.

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

@@ -1,10 +1,13 @@
 import type { MovementType, MovementTypeRecord, MovementTypeScope } from "../catalog";
 import type { Locale } from "../../../lang";
 import type { CatalogQuery } from "../../../utils/catalog-query.utils";
+import type { WithoutLabel } from "../../../utils/catalog-label.utils";
 export type MovementTypeOption = MovementTypeRecord & {
     label: string;
 };
-export declare const getMovementTypes: (lang: Locale) => Record<MovementType, MovementTypeOption>;
+/** Without `lang`: the records with no `label`, to read codes and metadata where no language applies. */
+export declare function getMovementTypes(): Record<MovementType, WithoutLabel<MovementTypeOption>>;
+export declare function 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<Omit<MovementTypeRecord, "scope">> & {
     lang: Locale;

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

@@ -3,21 +3,20 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.queryMovementTypes = exports.getMovementTypes = void 0;
+exports.queryMovementTypes = void 0;
+exports.getMovementTypes = getMovementTypes;
 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];
+function getMovementTypes(...args) {
     const result = {};
     for (const record of Object.values(catalog_1.MOVEMENT_TYPES)) {
-        result[record.code] = { ...record, label: locale.movementTypes[record.code] };
+        result[record.code] = args.length === 0 ? { ...record } : { ...record, label: locales[args[0]].movementTypes[record.code] };
     }
     return result;
-};
-exports.getMovementTypes = getMovementTypes;
+}
 /**
  * The catalog as a list narrowed by the query, each record enriched with its label for `query.lang`.
  *

package/dist/cjs/subclients/status/utils/subclient-status.utils.d.ts

@@ -1,6 +1,9 @@
 import type { SubclientStatus, SubclientStatusRecord } from "../catalog";
 import type { Locale } from "../../../lang";
+import type { WithoutLabel } from "../../../utils/catalog-label.utils";
 export type SubclientStatusOption = SubclientStatusRecord & {
     label: string;
 };
-export declare const getSubclientStatuses: (lang: Locale) => Record<SubclientStatus, SubclientStatusOption>;
+/** Without `lang`: the records with no `label`, to read codes and metadata where no language applies. */
+export declare function getSubclientStatuses(): Record<SubclientStatus, WithoutLabel<SubclientStatusOption>>;
+export declare function getSubclientStatuses(lang: Locale): Record<SubclientStatus, SubclientStatusOption>;

package/dist/cjs/subclients/status/utils/subclient-status.utils.js

@@ -3,17 +3,15 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getSubclientStatuses = void 0;
+exports.getSubclientStatuses = getSubclientStatuses;
 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 getSubclientStatuses = (lang) => {
-    const locale = locales[lang];
+function getSubclientStatuses(...args) {
     const result = {};
     for (const record of Object.values(catalog_1.SUBCLIENT_STATUSES)) {
-        result[record.code] = { ...record, label: locale.subclientStatuses[record.code] };
+        result[record.code] = args.length === 0 ? { ...record } : { ...record, label: locales[args[0]].subclientStatuses[record.code] };
     }
     return result;
-};
-exports.getSubclientStatuses = getSubclientStatuses;
+}

package/dist/cjs/transactions/types/utils/transaction-type.utils.d.ts

@@ -2,14 +2,17 @@ import type { TransactionType, TransactionTypeGroup, TransactionTypeRecord } fro
 import type { FilterClassificationRecord } from "../../../filterClassification/interfaces/filter-classification.interface";
 import type { Locale } from "../../../lang";
 import type { CatalogQuery } from "../../../utils/catalog-query.utils";
+import type { WithoutLabel } from "../../../utils/catalog-label.utils";
 export type TransactionTypeOption = TransactionTypeRecord & {
     label: string;
 };
+/** Without `lang`: the records with no `label`, to read codes and metadata where no language applies. */
+export declare function getTransactionTypes(): Record<TransactionType, WithoutLabel<TransactionTypeOption>>;
 /**
  * The catalog indexed by code (same shape as TRANSACTION_TYPES), each record enriched
  * with its label for the given language. Access by code directly, or Object.values for a list.
  */
-export declare const getTransactionTypes: (lang: Locale) => Record<TransactionType, TransactionTypeOption>;
+export declare function getTransactionTypes(lang: Locale): Record<TransactionType, TransactionTypeOption>;
 /** i18n domain: `lang` is required, inside the query object — see matchesQuery for the matching rules. */
 export type TransactionTypeQuery = CatalogQuery<TransactionTypeRecord> & {
     lang: Locale;

package/dist/cjs/transactions/types/utils/transaction-type.utils.js

@@ -3,25 +3,20 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.collapseTransactionTypes = exports.queryTransactionTypes = exports.getTransactionTypes = void 0;
+exports.collapseTransactionTypes = exports.queryTransactionTypes = void 0;
+exports.getTransactionTypes = getTransactionTypes;
 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 };
-/**
- * The catalog indexed by code (same shape as TRANSACTION_TYPES), each record enriched
- * with its label for the given language. Access by code directly, or Object.values for a list.
- */
-const getTransactionTypes = (lang) => {
-    const locale = locales[lang];
+function getTransactionTypes(...args) {
     const result = {};
     for (const record of Object.values(catalog_1.TRANSACTION_TYPES)) {
-        result[record.code] = { ...record, label: locale.transactionTypes[record.code] };
+        result[record.code] = args.length === 0 ? { ...record } : { ...record, label: locales[args[0]].transactionTypes[record.code] };
     }
     return result;
-};
-exports.getTransactionTypes = getTransactionTypes;
+}
 /** The catalog as a list narrowed by the query, each record enriched with its label for `query.lang`. */
 const queryTransactionTypes = (query) => {
     const { lang, ...filters } = query;

package/dist/cjs/utils/catalog-label.utils.d.ts

@@ -0,0 +1,8 @@
+/**
+ * A catalog record without its `label`: what an i18n `getX()` returns when called with no language.
+ *
+ * Distributive on purpose. A catalog's record type is a union of its `as const` rows, and a field present on only
+ * some rows (`filterDisplay` in `transactions/types`) would vanish under a plain `Omit`, which computes `keyof` over
+ * the whole union and keeps only the keys every row shares.
+ */
+export type WithoutLabel<T> = T extends unknown ? Omit<T, "label"> : never;

package/dist/cjs/utils/catalog-label.utils.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/esm/accounts/status/utils/account-status.utils.js

@@ -3,14 +3,13 @@ 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 getAccountStatuses = (lang) => {
-    const locale = locales[lang];
+export function getAccountStatuses(...args) {
     const result = {};
     for (const record of Object.values(ACCOUNT_STATUSES)) {
-        result[record.code] = { ...record, label: locale.accountStatuses[record.code] };
+        result[record.code] = args.length === 0 ? { ...record } : { ...record, label: locales[args[0]].accountStatuses[record.code] };
     }
     return result;
-};
+}
 /** The catalog as a list, narrowed by the query — see `matchesQuery` for the matching rules. */
 export const queryAccountStatuses = (query) => {
     const { lang, ...criteria } = query;

package/dist/esm/accounts/types/utils/account-type.utils.js

@@ -3,18 +3,13 @@ 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 ACCOUNT_TYPES), each record enriched
- * with its label for the given language. Access by code directly, or Object.values for a list.
- */
-export const getAccountTypes = (lang) => {
-    const locale = locales[lang];
+export function getAccountTypes(...args) {
     const result = {};
     for (const record of Object.values(ACCOUNT_TYPES)) {
-        result[record.code] = { ...record, label: locale.accountTypes[record.code] };
+        result[record.code] = args.length === 0 ? { ...record } : { ...record, label: locales[args[0]].accountTypes[record.code] };
     }
     return result;
-};
+}
 /** The catalog as a list, narrowed by the query — see `matchesQuery` for the matching rules. */
 export const queryAccountTypes = (query) => {
     const { lang, ...criteria } = query;

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

@@ -3,14 +3,13 @@ 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];
+export function getBlockchains(...args) {
     const result = {};
     for (const record of Object.values(BLOCKCHAINS)) {
-        result[record.code] = { ...record, label: locale.blockchains[record.code] };
+        result[record.code] = args.length === 0 ? { ...record } : { ...record, label: locales[args[0]].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;

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

@@ -2,11 +2,10 @@ 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];
+export function getNatures(...args) {
     const result = {};
     for (const record of Object.values(NATURES)) {
-        result[record.code] = { ...record, label: locale.natures[record.code] };
+        result[record.code] = args.length === 0 ? { ...record } : { ...record, label: locales[args[0]].natures[record.code] };
     }
     return result;
-};
+}

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

@@ -2,11 +2,10 @@ 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];
+export function getProductTypes(...args) {
     const result = {};
     for (const record of Object.values(PRODUCT_TYPES)) {
-        result[record.code] = { ...record, label: locale.productTypes[record.code] };
+        result[record.code] = args.length === 0 ? { ...record } : { ...record, label: locales[args[0]].productTypes[record.code] };
     }
     return result;
-};
+}

package/dist/esm/counterparties/types/utils/counterparty-type.utils.js

@@ -3,14 +3,13 @@ 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 getCounterpartyTypes = (lang) => {
-    const locale = locales[lang];
+export function getCounterpartyTypes(...args) {
     const result = {};
     for (const record of Object.values(COUNTERPARTY_TYPES)) {
-        result[record.code] = { ...record, label: locale.counterpartyTypes[record.code] };
+        result[record.code] = args.length === 0 ? { ...record } : { ...record, label: locales[args[0]].counterpartyTypes[record.code] };
     }
     return result;
-};
+}
 /** The catalog as a list, narrowed by the query — see `matchesQuery` for the matching rules. */
 export const queryCounterpartyTypes = (query) => {
     const { lang, ...criteria } = query;

package/dist/esm/countries/base/utils/country.utils.js

@@ -3,14 +3,13 @@ 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 getCountries = (lang) => {
-    const locale = locales[lang];
+export function getCountries(...args) {
     const result = {};
     for (const record of Object.values(COUNTRIES)) {
-        result[record.code] = { ...record, label: locale.countries[record.code] };
+        result[record.code] = args.length === 0 ? { ...record } : { ...record, label: locales[args[0]].countries[record.code] };
     }
     return result;
-};
+}
 /** The catalog as a list, narrowed by the query — see `matchesQuery` for the matching rules. */
 export const queryCountries = (query) => {
     const { lang, ...criteria } = query;

package/dist/esm/countries/iso/utils/country-iso.utils.js

@@ -5,14 +5,13 @@ import { matchesQuery } from "../../../utils/catalog-query.utils";
 const locales = { en: enLocale, "es-mex": esMexLocale };
 const AVAILABLE_FLAG_CODES = new Set(["col", "mex", "usa"]);
 export const hasCountryISOFlag = (code) => AVAILABLE_FLAG_CODES.has(code);
-export const getCountriesISO = (lang) => {
-    const locale = locales[lang];
+export function getCountriesISO(...args) {
     const result = {};
     for (const record of Object.values(COUNTRIES_ISO)) {
-        result[record.code] = { ...record, label: locale.countriesISO[record.code] };
+        result[record.code] = args.length === 0 ? { ...record } : { ...record, label: locales[args[0]].countriesISO[record.code] };
     }
     return result;
-};
+}
 /** The catalog as a list, narrowed by the query — see `matchesQuery` for the matching rules. */
 export const queryCountriesISO = (query) => {
     const { lang, ...criteria } = query;

package/dist/esm/documentTypes/utils/document-type.utils.js

@@ -3,18 +3,14 @@ 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 };
-/**
- * Documents indexed by code (definition + label). For the unique list (Object.values),
- * validation ([code].minLength / maxLength / type) and label ([code].label).
- */
-export const getDocumentTypes = (lang) => {
-    const locale = locales[lang];
+export function getDocumentTypes(...args) {
     const result = {};
     for (const { code, minLength, maxLength, type } of Object.values(DOCUMENT_TYPES)) {
-        result[code] = { code, minLength, maxLength, type, label: locale.documentTypes[code] };
+        const validation = { code, minLength, maxLength, type };
+        result[code] = args.length === 0 ? validation : { ...validation, label: locales[args[0]].documentTypes[code] };
     }
     return result;
-};
+}
 /** DOCUMENT_TYPES flattened by geo, one row per (code, geo) pair — no label, so it is what gets filtered. */
 const flattenByGeo = () => Object.values(DOCUMENT_TYPES).flatMap(({ geo, ...record }) => {
     const entries = Object.entries(geo);

package/dist/esm/filterClassification/categoryFamilies/utils/filter-classification-category-family.utils.js

@@ -2,11 +2,10 @@ import { FILTER_CLASSIFICATION_CATEGORY_FAMILIES } from "../catalog";
 import enLocale from "../locales/en.json";
 import esMexLocale from "../locales/es-mex.json";
 const locales = { en: enLocale, "es-mex": esMexLocale };
-export const getFilterClassificationCategoryFamilies = (lang) => {
-    const locale = locales[lang];
+export function getFilterClassificationCategoryFamilies(...args) {
     const result = {};
     for (const record of Object.values(FILTER_CLASSIFICATION_CATEGORY_FAMILIES)) {
-        result[record.code] = { ...record, label: locale.categoryFamilies[record.code] };
+        result[record.code] = args.length === 0 ? { ...record } : { ...record, label: locales[args[0]].categoryFamilies[record.code] };
     }
     return result;
-};
+}

package/dist/esm/filterClassification/sections/utils/filter-classification-section.utils.js

@@ -2,12 +2,10 @@ import { FILTER_CLASSIFICATION_SECTIONS } from "../catalog";
 import enLocale from "../locales/en.json";
 import esMexLocale from "../locales/es-mex.json";
 const locales = { en: enLocale, "es-mex": esMexLocale };
-/** The section headings indexed by code, each with its label. A section is a heading: never selectable, never sent to an API. */
-export const getFilterClassificationSections = (lang) => {
-    const locale = locales[lang];
+export function getFilterClassificationSections(...args) {
     const result = {};
     for (const record of Object.values(FILTER_CLASSIFICATION_SECTIONS)) {
-        result[record.code] = { ...record, label: locale.sections[record.code] };
+        result[record.code] = args.length === 0 ? { ...record } : { ...record, label: locales[args[0]].sections[record.code] };
     }
     return result;
-};
+}

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

@@ -12,11 +12,15 @@ const buildFinancialInstitutions = (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);
+export function getFinancialInstitutions(...args) {
+    if (args.length !== 0)
+        return buildFinancialInstitutions(args[0]);
+    const result = {};
+    for (const record of Object.values(FINANCIAL_INSTITUTIONS)) {
+        result[record.code] = { ...record };
+    }
+    return result;
+}
 /** The catalog as a list, narrowed by the query — see `matchesQuery` for the matching rules. */
 export const queryFinancialInstitutions = (query) => {
     const { lang, ...criteria } = query;

package/dist/esm/lang/index.js

@@ -1,3 +1,12 @@
 export const DEFAULT_EN_LOCALE = "en";
 export const DEFAULT_ES_LOCALE = "es-mex";
 export const LOCALES = [DEFAULT_EN_LOCALE, DEFAULT_ES_LOCALE];
+const SUPPORTED_LOCALES = LOCALES;
+/**
+ * Narrows any string to a supported `Locale`: an exact member of `LOCALES` passes through, anything else
+ * falls back to `DEFAULT_ES_LOCALE`. The active language is not always a library literal (a user preference
+ * saved without validation, `en-US` from the browser), and every translated `getX(lang)` / `queryX({ lang })`
+ * indexes its messages by the exact string and throws on anything else. Call it once where a pipeline reads
+ * the active language, not at every call site.
+ */
+export const toSupportedLocale = (lang) => SUPPORTED_LOCALES.includes(lang) ? lang : DEFAULT_ES_LOCALE;

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

@@ -3,14 +3,13 @@ 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 getMovementStatuses = (lang) => {
-    const locale = locales[lang];
+export function getMovementStatuses(...args) {
     const result = {};
     for (const record of Object.values(MOVEMENT_STATUSES)) {
-        result[record.code] = { ...record, label: locale.movementStatuses[record.code] };
+        result[record.code] = args.length === 0 ? { ...record } : { ...record, label: locales[args[0]].movementStatuses[record.code] };
     }
     return result;
-};
+}
 /**
  * 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.

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

@@ -3,14 +3,13 @@ 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 getMovementTypes = (lang) => {
-    const locale = locales[lang];
+export function getMovementTypes(...args) {
     const result = {};
     for (const record of Object.values(MOVEMENT_TYPES)) {
-        result[record.code] = { ...record, label: locale.movementTypes[record.code] };
+        result[record.code] = args.length === 0 ? { ...record } : { ...record, label: locales[args[0]].movementTypes[record.code] };
     }
     return result;
-};
+}
 /**
  * The catalog as a list narrowed by the query, each record enriched with its label for `query.lang`.
  *

package/dist/esm/subclients/status/utils/subclient-status.utils.js

@@ -2,11 +2,10 @@ import { SUBCLIENT_STATUSES } from "../catalog";
 import enLocale from "../locales/en.json";
 import esMexLocale from "../locales/es-mex.json";
 const locales = { en: enLocale, "es-mex": esMexLocale };
-export const getSubclientStatuses = (lang) => {
-    const locale = locales[lang];
+export function getSubclientStatuses(...args) {
     const result = {};
     for (const record of Object.values(SUBCLIENT_STATUSES)) {
-        result[record.code] = { ...record, label: locale.subclientStatuses[record.code] };
+        result[record.code] = args.length === 0 ? { ...record } : { ...record, label: locales[args[0]].subclientStatuses[record.code] };
     }
     return result;
-};
+}

package/dist/esm/transactions/types/utils/transaction-type.utils.js

@@ -3,18 +3,13 @@ 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 TRANSACTION_TYPES), each record enriched
- * with its label for the given language. Access by code directly, or Object.values for a list.
- */
-export const getTransactionTypes = (lang) => {
-    const locale = locales[lang];
+export function getTransactionTypes(...args) {
     const result = {};
     for (const record of Object.values(TRANSACTION_TYPES)) {
-        result[record.code] = { ...record, label: locale.transactionTypes[record.code] };
+        result[record.code] = args.length === 0 ? { ...record } : { ...record, label: locales[args[0]].transactionTypes[record.code] };
     }
     return result;
-};
+}
 /** The catalog as a list narrowed by the query, each record enriched with its label for `query.lang`. */
 export const queryTransactionTypes = (query) => {
     const { lang, ...filters } = query;

package/dist/esm/utils/catalog-label.utils.js

@@ -0,0 +1 @@
+export {};

package/package.json

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