@abyss-project/tools 1.0.1 → 1.0.5

package/src/index.ts

@@ -28,6 +28,7 @@ import * as metricsApi from './api/metrics.api';
 import * as organizationApi from './api/organization.api';
 import * as tagApi from './api/tag.api';
 import * as rcbApi from './api/rcb.api';
+import * as monitorApi from './api/monitor.api';
 
 export * from './api';
 export * from './types';
@@ -58,11 +59,8 @@ type AbyssToolsCoreSDK = {
   abyss: {
     admin: {
       activateUserService: typeof abyssAdminApi.activateUserServiceAbyssAdmin;
-      deleteUser: typeof abyssAdminApi.deleteUserAbyssAdmin;
       syncOrganization: typeof abyssAdminApi.syncOrganizationAbyssAdmin;
-      deleteOrganization: typeof abyssAdminApi.deleteOrganizationAbyssAdmin;
       syncProject: typeof abyssAdminApi.syncProjectAbyssAdmin;
-      deleteProject: typeof abyssAdminApi.deleteProjectAbyssAdmin;
       getProjectContentSummary: typeof abyssAdminApi.getProjectContentSummary;
     };
   };
@@ -276,6 +274,9 @@ type AbyssToolsCoreSDK = {
     getOrganizationTools: typeof metricsApi.getOrganizationToolsMetrics;
     getProjectTools: typeof metricsApi.getProjectToolsMetrics;
   };
+  monitor: {
+    up: typeof monitorApi.upMonitor;
+  };
   tag: {
     list: typeof tagApi.listTag;
     create: typeof tagApi.createTag;
@@ -396,11 +397,8 @@ export class AbyssToolsCore {
       abyss: {
         admin: {
           activateUserService: abyssAdminApi.activateUserServiceAbyssAdmin,
-          deleteUser: abyssAdminApi.deleteUserAbyssAdmin,
           syncOrganization: abyssAdminApi.syncOrganizationAbyssAdmin,
-          deleteOrganization: abyssAdminApi.deleteOrganizationAbyssAdmin,
           syncProject: abyssAdminApi.syncProjectAbyssAdmin,
-          deleteProject: abyssAdminApi.deleteProjectAbyssAdmin,
           getProjectContentSummary: abyssAdminApi.getProjectContentSummary,
         },
       },
@@ -615,6 +613,9 @@ export class AbyssToolsCore {
         getOrganizationTools: metricsApi.getOrganizationToolsMetrics,
         getProjectTools: metricsApi.getProjectToolsMetrics,
       },
+      monitor: {
+        up: monitorApi.upMonitor,
+      },
       tag: {
         list: tagApi.listTag,
         create: tagApi.createTag,

package/src/types/enum/pdf-operation.enum.ts

@@ -1,98 +1,98 @@
-export enum PdfOperationType {
-  ANNOTATE_TEXT = 'ANNOTATE_TEXT',
-  ANNOTATE_DRAW = 'ANNOTATE_DRAW',
-  ANNOTATE_IMAGE = 'ANNOTATE_IMAGE',
-  FILL_FIELD = 'FILL_FIELD',
-  PAGE_REORDER = 'PAGE_REORDER',
-  PAGE_DELETE = 'PAGE_DELETE',
-  PAGE_ROTATE = 'PAGE_ROTATE',
-  PAGE_INSERT_FROM_UPLOAD = 'PAGE_INSERT_FROM_UPLOAD',
-  FLATTEN = 'FLATTEN',
-}
-
-export interface IPdfOpAnnotateText {
-  opId: string;
-  type: PdfOperationType.ANNOTATE_TEXT;
-  pageIndex: number;
-  x: number;
-  y: number;
-  text: string;
-  fontSize: number;
-  color: string;
-}
-
-export interface IPdfOpAnnotateDraw {
-  opId: string;
-  type: PdfOperationType.ANNOTATE_DRAW;
-  pageIndex: number;
-  pathSvg: string;
-  color: string;
-  strokeWidth: number;
-}
-
-export type PdfImageSource =
-  | { kind: 'USER_ASSET'; assetId: string }
-  | { kind: 'INLINE'; storageKey: string };
-
-export interface IPdfOpAnnotateImage {
-  opId: string;
-  type: PdfOperationType.ANNOTATE_IMAGE;
-  pageIndex: number;
-  x: number;
-  y: number;
-  /** Width in PDF points (1/72 inch). Aligned with front-core PdfOperation. */
-  widthPt: number;
-  /** Height in PDF points (1/72 inch). Aligned with front-core PdfOperation. */
-  heightPt: number;
-  source: PdfImageSource;
-}
-
-export interface IPdfOpFillField {
-  opId: string;
-  type: PdfOperationType.FILL_FIELD;
-  fieldName: string;
-  value: string | boolean;
-}
-
-export interface IPdfOpPageReorder {
-  opId: string;
-  type: PdfOperationType.PAGE_REORDER;
-  order: number[];
-}
-
-export interface IPdfOpPageDelete {
-  opId: string;
-  type: PdfOperationType.PAGE_DELETE;
-  pageIndex: number;
-}
-
-export interface IPdfOpPageRotate {
-  opId: string;
-  type: PdfOperationType.PAGE_ROTATE;
-  pageIndex: number;
-  deg: 90 | 180 | 270;
-}
-
-export interface IPdfOpPageInsertFromUpload {
-  opId: string;
-  type: PdfOperationType.PAGE_INSERT_FROM_UPLOAD;
-  afterPageIndex: number;
-  uploadKey: string;
-  uploadPages: number[];
-}
-
-export interface IPdfOpFlatten {
-  opId: string;
-  type: PdfOperationType.FLATTEN;
-}
-
-export type PdfOperation =
-  | IPdfOpAnnotateText
-  | IPdfOpAnnotateDraw
-  | IPdfOpAnnotateImage
-  | IPdfOpFillField
-  | IPdfOpPageReorder
-  | IPdfOpPageDelete
-  | IPdfOpPageRotate
-  | IPdfOpPageInsertFromUpload
-  | IPdfOpFlatten;
+export enum PdfOperationType {
+  ANNOTATE_TEXT = 'ANNOTATE_TEXT',
+  ANNOTATE_DRAW = 'ANNOTATE_DRAW',
+  ANNOTATE_IMAGE = 'ANNOTATE_IMAGE',
+  FILL_FIELD = 'FILL_FIELD',
+  PAGE_REORDER = 'PAGE_REORDER',
+  PAGE_DELETE = 'PAGE_DELETE',
+  PAGE_ROTATE = 'PAGE_ROTATE',
+  PAGE_INSERT_FROM_UPLOAD = 'PAGE_INSERT_FROM_UPLOAD',
+  FLATTEN = 'FLATTEN',
+}
+
+export interface IPdfOpAnnotateText {
+  opId: string;
+  type: PdfOperationType.ANNOTATE_TEXT;
+  pageIndex: number;
+  x: number;
+  y: number;
+  text: string;
+  fontSize: number;
+  color: string;
+}
+
+export interface IPdfOpAnnotateDraw {
+  opId: string;
+  type: PdfOperationType.ANNOTATE_DRAW;
+  pageIndex: number;
+  pathSvg: string;
+  color: string;
+  strokeWidth: number;
+}
+
+export type PdfImageSource =
+  | { kind: 'USER_ASSET'; assetId: string }
+  | { kind: 'INLINE'; storageKey: string };
+
+export interface IPdfOpAnnotateImage {
+  opId: string;
+  type: PdfOperationType.ANNOTATE_IMAGE;
+  pageIndex: number;
+  x: number;
+  y: number;
+  /** Width in PDF points (1/72 inch). Aligned with front-core PdfOperation. */
+  widthPt: number;
+  /** Height in PDF points (1/72 inch). Aligned with front-core PdfOperation. */
+  heightPt: number;
+  source: PdfImageSource;
+}
+
+export interface IPdfOpFillField {
+  opId: string;
+  type: PdfOperationType.FILL_FIELD;
+  fieldName: string;
+  value: string | boolean;
+}
+
+export interface IPdfOpPageReorder {
+  opId: string;
+  type: PdfOperationType.PAGE_REORDER;
+  order: number[];
+}
+
+export interface IPdfOpPageDelete {
+  opId: string;
+  type: PdfOperationType.PAGE_DELETE;
+  pageIndex: number;
+}
+
+export interface IPdfOpPageRotate {
+  opId: string;
+  type: PdfOperationType.PAGE_ROTATE;
+  pageIndex: number;
+  deg: 90 | 180 | 270;
+}
+
+export interface IPdfOpPageInsertFromUpload {
+  opId: string;
+  type: PdfOperationType.PAGE_INSERT_FROM_UPLOAD;
+  afterPageIndex: number;
+  uploadKey: string;
+  uploadPages: number[];
+}
+
+export interface IPdfOpFlatten {
+  opId: string;
+  type: PdfOperationType.FLATTEN;
+}
+
+export type PdfOperation =
+  | IPdfOpAnnotateText
+  | IPdfOpAnnotateDraw
+  | IPdfOpAnnotateImage
+  | IPdfOpFillField
+  | IPdfOpPageReorder
+  | IPdfOpPageDelete
+  | IPdfOpPageRotate
+  | IPdfOpPageInsertFromUpload
+  | IPdfOpFlatten;

package/src/types/enum/rcb-bank.enum.ts

@@ -1,137 +1,137 @@
-// ──────────────────────────────────────────────
-// RCB — Formal catalogue of supported banks and versions.
-//
-// Mirrors the server-side registry (BANK_VERSIONS in abyss-tools/apps/api).
-// Use these enums whenever you reference a bank or version in hint mode,
-// UI dropdowns, or per-bank metrics. Adding a bank?
-//   1. Add the entry to BANK_VERSIONS in apps/api.
-//   2. Add the matching id here. CI will catch any mismatch.
-// ──────────────────────────────────────────────
-
-/**
- * Stable id of a bank+version profile. The wire-format string used in
- * `hint.bank` (POST /rcb/extract mode=hint) and returned in
- * extraction.strategy_used.
- */
-export enum RcbBankVersionId {
-  BNP_CONNEXIS_DEFAULT = 'bnp-connexis-default',
-  BNP_PARIBAS_DEFAULT = 'bnp-paribas-default',
-  SOCIETE_GENERALE_DEFAULT = 'societe-generale-default',
-  CREDIT_AGRICOLE_DEFAULT = 'credit-agricole-default',
-  LCL_DEFAULT = 'lcl-default',
-  BOURSORAMA_DEFAULT = 'boursorama-default',
-  SPENDESK_DEFAULT = 'spendesk-default',
-  LA_BANQUE_POSTALE_DEFAULT = 'la-banque-postale-default',
-  CAISSE_EPARGNE_DEFAULT = 'caisse-epargne-default',
-  THEMIS_DEFAULT = 'themis-default',
-  CIC_EBICS_DEFAULT = 'cic-ebics-default',
-  CIC_DEFAULT = 'cic-default',
-  CREDIT_MUTUEL_DEFAULT = 'credit-mutuel-default',
-  N26_DEFAULT = 'n26-default',
-  REVOLUT_DEFAULT = 'revolut-default',
-  HSBC_DEFAULT = 'hsbc-default',
-  HSBC_UK_DEFAULT = 'hsbc-uk-default',
-  WISE_DEFAULT = 'wise-default',
-  CREDIT_DU_NORD_DEFAULT = 'cdn-default',
-  BRED_DEFAULT = 'bred-default',
-  QONTO_DEFAULT = 'qonto-default',
-  SHINE_DEFAULT = 'shine-default',
-  SWAN_DEFAULT = 'swan-default',
-  ROTHSCHILD_DEFAULT = 'rothschild-default',
-  FINOM_DEFAULT = 'finom-default',
-  TIIME_DEFAULT = 'tiime-default',
-  UBS_DEFAULT = 'ubs-default',
-  CAIXA_DEFAULT = 'caixa-default',
-  CDE_NET_DEFAULT = 'cde-net-default',
-  DELUBAC_DEFAULT = 'delubac-default',
-  AIRWALLEX_DEFAULT = 'airwallex-default',
-  PAYPAL_DEFAULT = 'paypal-default',
-  VIVA_WALLET_DEFAULT = 'viva-wallet-default',
-  PALATINE_DEFAULT = 'palatine-default',
-  NATIXIS_DEFAULT = 'natixis-default',
-  JPMORGAN_DEFAULT = 'jpmorgan-default',
-  LA_NEF_V1 = 'la-nef-v1',
-  LA_NEF_V2 = 'la-nef-v2',
-}
-
-/**
- * Display catalogue — one entry per supported (bank, version) pair.
- * Drives dropdowns, "supported banks" pages, and customer docs.
- */
-export interface RcbBankCatalogueEntry {
-  id: RcbBankVersionId;
-  bank: string;
-  version: string;
-  country: 'FR' | 'UK' | 'CH' | 'US' | 'PT' | 'EU' | 'INTL';
-  type: 'retail' | 'business' | 'neobank' | 'fintech' | 'corporate';
-}
-
-export const RCB_BANK_CATALOGUE: ReadonlyArray<RcbBankCatalogueEntry> = [
-  // ─── French retail / business ─────────────
-  { id: RcbBankVersionId.BNP_CONNEXIS_DEFAULT,      bank: 'BNP Connexis',             version: 'default', country: 'FR', type: 'business' },
-  { id: RcbBankVersionId.BNP_PARIBAS_DEFAULT,       bank: 'BNP Paribas',              version: 'default', country: 'FR', type: 'retail' },
-  { id: RcbBankVersionId.SOCIETE_GENERALE_DEFAULT,  bank: 'Société Générale',         version: 'default', country: 'FR', type: 'retail' },
-  { id: RcbBankVersionId.CREDIT_AGRICOLE_DEFAULT,   bank: 'Crédit Agricole',          version: 'default', country: 'FR', type: 'retail' },
-  { id: RcbBankVersionId.LCL_DEFAULT,               bank: 'LCL',                      version: 'default', country: 'FR', type: 'retail' },
-  { id: RcbBankVersionId.BOURSORAMA_DEFAULT,        bank: 'Boursorama',               version: 'default', country: 'FR', type: 'retail' },
-  { id: RcbBankVersionId.LA_BANQUE_POSTALE_DEFAULT, bank: 'La Banque Postale',        version: 'default', country: 'FR', type: 'retail' },
-  { id: RcbBankVersionId.CAISSE_EPARGNE_DEFAULT,    bank: "Caisse d'Épargne",         version: 'default', country: 'FR', type: 'retail' },
-  { id: RcbBankVersionId.CIC_EBICS_DEFAULT,         bank: 'CIC',                      version: 'ebics',   country: 'FR', type: 'business' },
-  { id: RcbBankVersionId.CIC_DEFAULT,               bank: 'CIC',                      version: 'default', country: 'FR', type: 'retail' },
-  { id: RcbBankVersionId.CREDIT_MUTUEL_DEFAULT,     bank: 'Crédit Mutuel',            version: 'default', country: 'FR', type: 'retail' },
-  { id: RcbBankVersionId.BRED_DEFAULT,              bank: 'BRED',                     version: 'default', country: 'FR', type: 'retail' },
-  { id: RcbBankVersionId.CREDIT_DU_NORD_DEFAULT,    bank: 'Crédit du Nord',           version: 'default', country: 'FR', type: 'retail' },
-  { id: RcbBankVersionId.CDE_NET_DEFAULT,           bank: 'CDE Net',                  version: 'default', country: 'FR', type: 'business' },
-  { id: RcbBankVersionId.DELUBAC_DEFAULT,           bank: 'Delubac',                  version: 'default', country: 'FR', type: 'business' },
-  { id: RcbBankVersionId.PALATINE_DEFAULT,          bank: 'Palatine',                 version: 'default', country: 'FR', type: 'business' },
-  { id: RcbBankVersionId.NATIXIS_DEFAULT,           bank: 'Natixis',                  version: 'default', country: 'FR', type: 'corporate' },
-  { id: RcbBankVersionId.THEMIS_DEFAULT,            bank: 'Themis Banque',            version: 'default', country: 'FR', type: 'business' },
-  { id: RcbBankVersionId.ROTHSCHILD_DEFAULT,        bank: 'Rothschild Martin Maurel', version: 'default', country: 'FR', type: 'corporate' },
-  { id: RcbBankVersionId.LA_NEF_V1,                 bank: 'La Nef',                   version: 'v1',      country: 'FR', type: 'retail' },
-  { id: RcbBankVersionId.LA_NEF_V2,                 bank: 'La Nef',                   version: 'v2',      country: 'FR', type: 'retail' },
-
-  // ─── Neobanks / fintech ───────────────────
-  { id: RcbBankVersionId.QONTO_DEFAULT,             bank: 'Qonto',                    version: 'default', country: 'FR', type: 'neobank' },
-  { id: RcbBankVersionId.SHINE_DEFAULT,             bank: 'Shine',                    version: 'default', country: 'FR', type: 'neobank' },
-  { id: RcbBankVersionId.FINOM_DEFAULT,             bank: 'Finom',                    version: 'default', country: 'EU', type: 'neobank' },
-  { id: RcbBankVersionId.TIIME_DEFAULT,             bank: 'Tiime',                    version: 'default', country: 'FR', type: 'neobank' },
-  { id: RcbBankVersionId.SPENDESK_DEFAULT,          bank: 'Spendesk',                 version: 'default', country: 'FR', type: 'fintech' },
-  { id: RcbBankVersionId.SWAN_DEFAULT,              bank: 'Swan',                     version: 'default', country: 'FR', type: 'fintech' },
-  { id: RcbBankVersionId.N26_DEFAULT,               bank: 'N26',                      version: 'default', country: 'EU', type: 'neobank' },
-  { id: RcbBankVersionId.REVOLUT_DEFAULT,           bank: 'Revolut',                  version: 'default', country: 'EU', type: 'neobank' },
-  { id: RcbBankVersionId.WISE_DEFAULT,              bank: 'Wise',                     version: 'default', country: 'INTL', type: 'fintech' },
-  { id: RcbBankVersionId.PAYPAL_DEFAULT,            bank: 'PayPal',                   version: 'default', country: 'INTL', type: 'fintech' },
-  { id: RcbBankVersionId.AIRWALLEX_DEFAULT,         bank: 'Airwallex',                version: 'default', country: 'INTL', type: 'fintech' },
-  { id: RcbBankVersionId.VIVA_WALLET_DEFAULT,       bank: 'Viva Wallet',              version: 'default', country: 'EU', type: 'fintech' },
-
-  // ─── International retail / corporate ─────
-  { id: RcbBankVersionId.HSBC_DEFAULT,              bank: 'HSBC',                     version: 'default', country: 'FR', type: 'retail' },
-  { id: RcbBankVersionId.HSBC_UK_DEFAULT,           bank: 'HSBC UK',                  version: 'default', country: 'UK', type: 'retail' },
-  { id: RcbBankVersionId.UBS_DEFAULT,               bank: 'UBS',                      version: 'default', country: 'CH', type: 'corporate' },
-  { id: RcbBankVersionId.CAIXA_DEFAULT,             bank: 'Caixa',                    version: 'default', country: 'PT', type: 'retail' },
-  { id: RcbBankVersionId.JPMORGAN_DEFAULT,          bank: 'JPMorgan',                 version: 'default', country: 'US', type: 'corporate' },
-];
-
-/**
- * Lookup by id (typed). Returns undefined for unknown ids — callers should
- * treat that as "use auto mode" rather than crash.
- */
-export function getRcbBankCatalogueEntry(
-  id: string,
-): RcbBankCatalogueEntry | undefined {
-  return RCB_BANK_CATALOGUE.find((e) => e.id === id);
-}
-
-/**
- * Group catalogue entries by the bank display name. Useful for UIs that
- * show "BNP Paribas" once with a sub-menu listing all supported versions.
- */
-export function groupRcbCatalogueByBank(): Map<string, RcbBankCatalogueEntry[]> {
-  const out = new Map<string, RcbBankCatalogueEntry[]>();
-  for (const entry of RCB_BANK_CATALOGUE) {
-    const list = out.get(entry.bank) ?? [];
-    list.push(entry);
-    out.set(entry.bank, list);
-  }
-  return out;
-}
+// ──────────────────────────────────────────────
+// RCB — Formal catalogue of supported banks and versions.
+//
+// Mirrors the server-side registry (BANK_VERSIONS in abyss-tools/apps/api).
+// Use these enums whenever you reference a bank or version in hint mode,
+// UI dropdowns, or per-bank metrics. Adding a bank?
+//   1. Add the entry to BANK_VERSIONS in apps/api.
+//   2. Add the matching id here. CI will catch any mismatch.
+// ──────────────────────────────────────────────
+
+/**
+ * Stable id of a bank+version profile. The wire-format string used in
+ * `hint.bank` (POST /rcb/extract mode=hint) and returned in
+ * extraction.strategy_used.
+ */
+export enum RcbBankVersionId {
+  BNP_CONNEXIS_DEFAULT = 'bnp-connexis-default',
+  BNP_PARIBAS_DEFAULT = 'bnp-paribas-default',
+  SOCIETE_GENERALE_DEFAULT = 'societe-generale-default',
+  CREDIT_AGRICOLE_DEFAULT = 'credit-agricole-default',
+  LCL_DEFAULT = 'lcl-default',
+  BOURSORAMA_DEFAULT = 'boursorama-default',
+  SPENDESK_DEFAULT = 'spendesk-default',
+  LA_BANQUE_POSTALE_DEFAULT = 'la-banque-postale-default',
+  CAISSE_EPARGNE_DEFAULT = 'caisse-epargne-default',
+  THEMIS_DEFAULT = 'themis-default',
+  CIC_EBICS_DEFAULT = 'cic-ebics-default',
+  CIC_DEFAULT = 'cic-default',
+  CREDIT_MUTUEL_DEFAULT = 'credit-mutuel-default',
+  N26_DEFAULT = 'n26-default',
+  REVOLUT_DEFAULT = 'revolut-default',
+  HSBC_DEFAULT = 'hsbc-default',
+  HSBC_UK_DEFAULT = 'hsbc-uk-default',
+  WISE_DEFAULT = 'wise-default',
+  CREDIT_DU_NORD_DEFAULT = 'cdn-default',
+  BRED_DEFAULT = 'bred-default',
+  QONTO_DEFAULT = 'qonto-default',
+  SHINE_DEFAULT = 'shine-default',
+  SWAN_DEFAULT = 'swan-default',
+  ROTHSCHILD_DEFAULT = 'rothschild-default',
+  FINOM_DEFAULT = 'finom-default',
+  TIIME_DEFAULT = 'tiime-default',
+  UBS_DEFAULT = 'ubs-default',
+  CAIXA_DEFAULT = 'caixa-default',
+  CDE_NET_DEFAULT = 'cde-net-default',
+  DELUBAC_DEFAULT = 'delubac-default',
+  AIRWALLEX_DEFAULT = 'airwallex-default',
+  PAYPAL_DEFAULT = 'paypal-default',
+  VIVA_WALLET_DEFAULT = 'viva-wallet-default',
+  PALATINE_DEFAULT = 'palatine-default',
+  NATIXIS_DEFAULT = 'natixis-default',
+  JPMORGAN_DEFAULT = 'jpmorgan-default',
+  LA_NEF_V1 = 'la-nef-v1',
+  LA_NEF_V2 = 'la-nef-v2',
+}
+
+/**
+ * Display catalogue — one entry per supported (bank, version) pair.
+ * Drives dropdowns, "supported banks" pages, and customer docs.
+ */
+export interface RcbBankCatalogueEntry {
+  id: RcbBankVersionId;
+  bank: string;
+  version: string;
+  country: 'FR' | 'UK' | 'CH' | 'US' | 'PT' | 'EU' | 'INTL';
+  type: 'retail' | 'business' | 'neobank' | 'fintech' | 'corporate';
+}
+
+export const RCB_BANK_CATALOGUE: ReadonlyArray<RcbBankCatalogueEntry> = [
+  // ─── French retail / business ─────────────
+  { id: RcbBankVersionId.BNP_CONNEXIS_DEFAULT,      bank: 'BNP Connexis',             version: 'default', country: 'FR', type: 'business' },
+  { id: RcbBankVersionId.BNP_PARIBAS_DEFAULT,       bank: 'BNP Paribas',              version: 'default', country: 'FR', type: 'retail' },
+  { id: RcbBankVersionId.SOCIETE_GENERALE_DEFAULT,  bank: 'Société Générale',         version: 'default', country: 'FR', type: 'retail' },
+  { id: RcbBankVersionId.CREDIT_AGRICOLE_DEFAULT,   bank: 'Crédit Agricole',          version: 'default', country: 'FR', type: 'retail' },
+  { id: RcbBankVersionId.LCL_DEFAULT,               bank: 'LCL',                      version: 'default', country: 'FR', type: 'retail' },
+  { id: RcbBankVersionId.BOURSORAMA_DEFAULT,        bank: 'Boursorama',               version: 'default', country: 'FR', type: 'retail' },
+  { id: RcbBankVersionId.LA_BANQUE_POSTALE_DEFAULT, bank: 'La Banque Postale',        version: 'default', country: 'FR', type: 'retail' },
+  { id: RcbBankVersionId.CAISSE_EPARGNE_DEFAULT,    bank: "Caisse d'Épargne",         version: 'default', country: 'FR', type: 'retail' },
+  { id: RcbBankVersionId.CIC_EBICS_DEFAULT,         bank: 'CIC',                      version: 'ebics',   country: 'FR', type: 'business' },
+  { id: RcbBankVersionId.CIC_DEFAULT,               bank: 'CIC',                      version: 'default', country: 'FR', type: 'retail' },
+  { id: RcbBankVersionId.CREDIT_MUTUEL_DEFAULT,     bank: 'Crédit Mutuel',            version: 'default', country: 'FR', type: 'retail' },
+  { id: RcbBankVersionId.BRED_DEFAULT,              bank: 'BRED',                     version: 'default', country: 'FR', type: 'retail' },
+  { id: RcbBankVersionId.CREDIT_DU_NORD_DEFAULT,    bank: 'Crédit du Nord',           version: 'default', country: 'FR', type: 'retail' },
+  { id: RcbBankVersionId.CDE_NET_DEFAULT,           bank: 'CDE Net',                  version: 'default', country: 'FR', type: 'business' },
+  { id: RcbBankVersionId.DELUBAC_DEFAULT,           bank: 'Delubac',                  version: 'default', country: 'FR', type: 'business' },
+  { id: RcbBankVersionId.PALATINE_DEFAULT,          bank: 'Palatine',                 version: 'default', country: 'FR', type: 'business' },
+  { id: RcbBankVersionId.NATIXIS_DEFAULT,           bank: 'Natixis',                  version: 'default', country: 'FR', type: 'corporate' },
+  { id: RcbBankVersionId.THEMIS_DEFAULT,            bank: 'Themis Banque',            version: 'default', country: 'FR', type: 'business' },
+  { id: RcbBankVersionId.ROTHSCHILD_DEFAULT,        bank: 'Rothschild Martin Maurel', version: 'default', country: 'FR', type: 'corporate' },
+  { id: RcbBankVersionId.LA_NEF_V1,                 bank: 'La Nef',                   version: 'v1',      country: 'FR', type: 'retail' },
+  { id: RcbBankVersionId.LA_NEF_V2,                 bank: 'La Nef',                   version: 'v2',      country: 'FR', type: 'retail' },
+
+  // ─── Neobanks / fintech ───────────────────
+  { id: RcbBankVersionId.QONTO_DEFAULT,             bank: 'Qonto',                    version: 'default', country: 'FR', type: 'neobank' },
+  { id: RcbBankVersionId.SHINE_DEFAULT,             bank: 'Shine',                    version: 'default', country: 'FR', type: 'neobank' },
+  { id: RcbBankVersionId.FINOM_DEFAULT,             bank: 'Finom',                    version: 'default', country: 'EU', type: 'neobank' },
+  { id: RcbBankVersionId.TIIME_DEFAULT,             bank: 'Tiime',                    version: 'default', country: 'FR', type: 'neobank' },
+  { id: RcbBankVersionId.SPENDESK_DEFAULT,          bank: 'Spendesk',                 version: 'default', country: 'FR', type: 'fintech' },
+  { id: RcbBankVersionId.SWAN_DEFAULT,              bank: 'Swan',                     version: 'default', country: 'FR', type: 'fintech' },
+  { id: RcbBankVersionId.N26_DEFAULT,               bank: 'N26',                      version: 'default', country: 'EU', type: 'neobank' },
+  { id: RcbBankVersionId.REVOLUT_DEFAULT,           bank: 'Revolut',                  version: 'default', country: 'EU', type: 'neobank' },
+  { id: RcbBankVersionId.WISE_DEFAULT,              bank: 'Wise',                     version: 'default', country: 'INTL', type: 'fintech' },
+  { id: RcbBankVersionId.PAYPAL_DEFAULT,            bank: 'PayPal',                   version: 'default', country: 'INTL', type: 'fintech' },
+  { id: RcbBankVersionId.AIRWALLEX_DEFAULT,         bank: 'Airwallex',                version: 'default', country: 'INTL', type: 'fintech' },
+  { id: RcbBankVersionId.VIVA_WALLET_DEFAULT,       bank: 'Viva Wallet',              version: 'default', country: 'EU', type: 'fintech' },
+
+  // ─── International retail / corporate ─────
+  { id: RcbBankVersionId.HSBC_DEFAULT,              bank: 'HSBC',                     version: 'default', country: 'FR', type: 'retail' },
+  { id: RcbBankVersionId.HSBC_UK_DEFAULT,           bank: 'HSBC UK',                  version: 'default', country: 'UK', type: 'retail' },
+  { id: RcbBankVersionId.UBS_DEFAULT,               bank: 'UBS',                      version: 'default', country: 'CH', type: 'corporate' },
+  { id: RcbBankVersionId.CAIXA_DEFAULT,             bank: 'Caixa',                    version: 'default', country: 'PT', type: 'retail' },
+  { id: RcbBankVersionId.JPMORGAN_DEFAULT,          bank: 'JPMorgan',                 version: 'default', country: 'US', type: 'corporate' },
+];
+
+/**
+ * Lookup by id (typed). Returns undefined for unknown ids — callers should
+ * treat that as "use auto mode" rather than crash.
+ */
+export function getRcbBankCatalogueEntry(
+  id: string,
+): RcbBankCatalogueEntry | undefined {
+  return RCB_BANK_CATALOGUE.find((e) => e.id === id);
+}
+
+/**
+ * Group catalogue entries by the bank display name. Useful for UIs that
+ * show "BNP Paribas" once with a sub-menu listing all supported versions.
+ */
+export function groupRcbCatalogueByBank(): Map<string, RcbBankCatalogueEntry[]> {
+  const out = new Map<string, RcbBankCatalogueEntry[]>();
+  for (const entry of RCB_BANK_CATALOGUE) {
+    const list = out.get(entry.bank) ?? [];
+    list.push(entry);
+    out.set(entry.bank, list);
+  }
+  return out;
+}