@accesly/react 1.1.3 → 1.2.0

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { Environment, CognitoConfig, AuthClient, SessionStorage, DeviceStore, TelemetrySink, TokenManager, AccesslyEndpoints, AuthStatus, CredentialRecord, EncryptedEnvelope, WalletActivityEvent } from '@accesly/core';
+import { Environment, CognitoConfig, AuthClient, SessionStorage, DeviceStore, TelemetrySink, TokenManager, AccesslyEndpoints, AuthStatus, CredentialRecord, EncryptedEnvelope } from '@accesly/core';
 import * as react from 'react';
 import { ReactNode } from 'react';
 
@@ -60,6 +60,13 @@ declare const AcceslyContext: react.Context<AcceslyContextValue | null>;
 
 interface EnvironmentDefaults {
     readonly apiUrl: string;
+    /**
+     * Lambda Function URL del `wallet-stream` Lambda — Server-Sent Events
+     * que multiplexa status + balance + activity en una sola conexión.
+     * Si está vacío, los hooks `useBalance` / `useWalletActivity` /
+     * `useWalletStatus` caen al polling fallback (mucho menos eficiente).
+     */
+    readonly walletStreamUrl: string;
     readonly cognito: CognitoConfig;
     readonly stellar: {
         readonly networkPassphrase: string;
@@ -650,101 +657,151 @@ interface AcceslyHook {
 declare function useAccesly(): AcceslyHook;
 
 /**
- * `useWalletStatus()` — hook event-driven que sustituye al
- * `setInterval(fetchRemote, 30_000)` que cada integrador escribía en su
- * `Wallet.tsx` / `CreateWallet.tsx`.
- *
- * Comportamiento:
- *
- *   1. **SSE-first.** Si la infra del backend expone `GET /wallets/stream`
- *      (Lambda function URL con response streaming), el hook se suscribe vía
- *      `EventSource` y reacciona instantáneamente a cambios on-chain. Cero
- *      polling, cero latencia.
+ * `useWalletStatus()` — status on-chain del Smart Account del user actual con
+ * push real-time vía SSE.
  *
- *   2. **Polling con backoff inteligente como fallback.** Si SSE no está
- *      disponible (backend viejo, sandbox sin streaming, browser sin
- *      `EventSource`), cae a polling con backoff exponencial:
- *        - mientras la wallet NO está `'on-chain'`: 2s → 5s → 10s → 20s →
- *          30s (cap).
- *        - si llega `'on-chain'` o el tab queda oculto: polling pausado.
- *        - llamadas de `refresh()` resetean el backoff a 2s.
- *      Mucho mejor UX que el `30s` constante del legacy.
+ * Reemplaza el polling cada 30s del legacy. Comportamiento:
  *
- *   3. **`document.visibilityState` aware.** Pausa cuando el tab está oculto;
- *      retoma + refresca inmediatamente cuando vuelve a visible.
+ *   1. SSE-first: si `walletStreamUrl` está configurado y `EventSource` existe,
+ *      se suscribe al canal `status` del `wallet-stream` Lambda. Cero polling.
+ *   2. Fallback a polling backoff (1s → 30s) si SSE no está disponible.
+ *   3. Pausa cuando `document.hidden`, retoma al volver.
+ *   4. `refresh()` fuerza fetch HTTP inmediato.
  *
- *   4. **Cross-tab via `BroadcastChannel`.** Si el user tiene la app abierta
- *      en 2 tabs, el primero que reciba un update lo emite por el canal
- *      `accesly:wallet:<username>` y los otros tabs lo aplican sin hacer su
- *      propio fetch — un solo round-trip por update.
- *
- * Devuelve `{ status, walletAddress, onChain, isStale, refresh }`. `refresh()`
- * fuerza un fetch inmediato + resetea backoff. `isStale` = `true` si no se ha
- * podido confirmar status en > 60s (red/Soroban RPC caído).
+ * El status del Smart Account vive en DDB (lo que el backend reporta de su
+ * verificación contra Soroban). El backend push-ea cambios cuando los detecta
+ * (cada 5s en el loop del wallet-stream).
  */
 type WalletStatusValue = 'on-chain' | 'pending-deploy' | 'unknown' | 'no-wallet';
 interface UseWalletStatusResult {
-    /** Status actual. `'no-wallet'` si el backend nunca recibió un POST /wallets. */
     readonly status: WalletStatusValue;
-    /** Address C…, o null si no hay wallet. */
     readonly walletAddress: string | null;
-    /** Mirror del campo `onChain` del backend (true / false / null). */
     readonly onChain: boolean | null;
-    /** True si el último fetch exitoso fue hace más de 60s — UI puede mostrar warning. */
     readonly isStale: boolean;
-    /** Fuerza fetch inmediato + resetea backoff. Llamalo tras submit/recovery. */
     refresh(): Promise<void>;
 }
 declare function useWalletStatus(): UseWalletStatusResult;
 
 /**
- * `useBalance(walletAddress?)` — hook que devuelve el balance XLM del Smart
- * Account con auto-refresh.
+ * `useBalance(walletAddress?)` — devuelve el balance XLM del Smart Account
+ * con push real-time vía SSE.
+ *
+ * Si SSE está configurado (env tiene `walletStreamUrl` y `EventSource` existe),
+ * el hook se suscribe al canal `balance` del `wallet-stream` Lambda y se
+ * actualiza instantáneamente cuando cambia el balance on-chain.
  *
- * Si no se le pasa `walletAddress`, intenta auto-resolverlo via
- * `wallet.getStoredCredential(username)` del DeviceStore — el flujo más
- * común (un solo wallet por user en este device).
+ * Fallback automático a polling cada 10s si SSE no está disponible (entorno
+ * que no lo soporta o backend self-hosteado sin el endpoint).
  *
- * Polling: 8s mientras tab visible, pausa cuando hidden, retoma al volver.
- * También se refresca inmediatamente cuando `useWalletStatus` reporta
- * `'on-chain'` (via cross-tab `BroadcastChannel`) para mostrar el balance
- * tras un deploy fresco.
+ * El `walletAddress` se auto-resuelve desde el `DeviceStore` si no se pasa
+ * (cubrir el caso "wallet del user actual sin tener que pasarla a mano").
  */
 interface UseBalanceResult {
     /** Stroops como string base-10. `null` mientras se carga o no hay address. */
     readonly stroops: string | null;
     /** Mismo balance como string decimal en XLM. `null` mientras se carga. */
     readonly xlm: string | null;
-    /** True durante el primer fetch (subsiguientes ediciones son silent). */
     readonly isLoading: boolean;
-    /** Error del último fetch, si lo hubo. */
     readonly error: Error | null;
-    /** Fuerza fetch inmediato. */
+    /** Fuerza fetch HTTP inmediato (útil tras una operación del user). */
     refresh(): Promise<void>;
 }
 declare function useBalance(walletAddress?: string | null): UseBalanceResult;
 
 /**
- * `useWalletActivity(walletAddress?, opts?)` — hook que devuelve los últimos
- * eventos on-chain del Smart Account, auto-refrescados cada 20s mientras la
- * tab está visible.
+ * `WalletSubscription` — singleton manager por wallet address que abre UNA
+ * sola conexión `EventSource` al `wallet-stream` Lambda y desmultiplexa los
+ * eventos a múltiples subscribers (hooks).
+ *
+ * Beneficios:
+ *  - 3 hooks (`useBalance`, `useWalletActivity`, `useWalletStatus`) sobre la
+ *    misma wallet → 1 sola conexión TCP, no 3 polls separados.
+ *  - Auto-reconnect cuando el server cierra (default de EventSource — `retry:`).
+ *  - Ref-count: la conexión se abre con el primer subscriber y se cierra
+ *    cuando no quedan listeners (`useEffect` cleanup en cada hook).
+ *  - Eventos cacheados: el último valor recibido de cada tipo se replay-ea
+ *    a nuevos subscribers para que no esperen el próximo push.
+ *
+ * Sin SSE configurado (`walletStreamUrl` vacío) o cuando `EventSource` no
+ * existe (SSR / workers), los hooks individuales detectan el flag
+ * `unavailable` y caen al polling fallback que ya existe.
+ */
+type WalletStreamEventType = 'status' | 'balance' | 'activity';
+interface WalletStreamStatusPayload {
+    readonly walletAddress: string | null;
+    readonly onChain: boolean | null;
+}
+interface WalletStreamBalancePayload {
+    readonly stroops: string;
+    readonly xlm: string;
+}
+/**
+ * Activity emitida por el backend ya **filtrada y tipada** — solo eventos
+ * relevantes para una wallet de Accesly (rotación de signers + transfers
+ * IN/OUT de XLM). Otros eventos on-chain (debug, errores host, eventos
+ * irrelevantes) se descartan en el server.
+ */
+type WalletActivityItem = {
+    readonly type: 'signer-rotated';
+    readonly txHash: string;
+    readonly ledger: number;
+    readonly timestamp: string | null;
+    readonly newOwnerEd25519Hex: string;
+} | {
+    readonly type: 'transfer-in';
+    readonly txHash: string;
+    readonly ledger: number;
+    readonly timestamp: string | null;
+    readonly from: string;
+    readonly amountStroops: string;
+} | {
+    readonly type: 'transfer-out';
+    readonly txHash: string;
+    readonly ledger: number;
+    readonly timestamp: string | null;
+    readonly to: string;
+    readonly amountStroops: string;
+};
+interface WalletStreamActivityPayload {
+    readonly events: readonly WalletActivityItem[];
+}
+type Listener<T> = (payload: T) => void;
+/**
+ * Suscribirse a un tipo de evento de la wallet. Devuelve una función
+ * de cleanup que el caller (típicamente `useEffect`) debe llamar para
+ * desuscribir y, eventualmente, cerrar la conexión SSE.
+ *
+ * Si SSE no está disponible (URL vacía, EventSource undefined), devuelve
+ * `null` para indicar al caller que use el fallback de polling.
+ */
+declare function subscribeToWalletEvent<T extends WalletStreamEventType>(streamUrl: string, walletAddress: string, eventType: T, listener: T extends 'status' ? Listener<WalletStreamStatusPayload> : T extends 'balance' ? Listener<WalletStreamBalancePayload> : Listener<WalletStreamActivityPayload>): (() => void) | null;
+/**
+ * Cierra TODAS las conexiones SSE activas. Útil para tests o cuando el user
+ * cierra sesión y querés limpiar conexiones colgadas. Llamar en `auth.signOut`
+ * lo tienen pendiente como mejora — por ahora el cleanup natural de los
+ * unmount basta.
+ */
+declare function closeAllWalletSubscriptions(): void;
+
+/**
+ * `useWalletActivity(walletAddress?, opts?)` — actividad on-chain relevante de
+ * la wallet (rotate_signer + transfers in/out de XLM) con push real-time vía SSE.
  *
- * Pasos:
- *   1. Resuelve `walletAddress` desde el DeviceStore si no se pasa explícito.
- *   2. Fetch inicial inmediato → guarda en estado.
- *   3. Polling cada 20s (pausado si tab oculta).
- *   4. `refresh()` para fetch on-demand tras una operación del user.
+ * El backend YA filtra eventos irrelevantes — el integrador solo recibe
+ * `WalletActivityItem` tipados (`signer-rotated` | `transfer-in` | `transfer-out`).
+ * Sin parsing manual de XDR ni lógica de filtrado client-side.
  *
- * Mejor UX que el "ver explorer link" porque la app puede renderizar la
- * lista de tx en su propio look — sin abrir otro tab a Stellar Expert.
+ * Fallback: si SSE no está disponible, polling cada 25s al endpoint
+ * `/wallets/:address/activity`. Mucho menos eficiente pero garantiza data.
  */
 
 interface UseWalletActivityOptions {
-    /** Cantidad de eventos a pedir. Default 20, max 50. */
+    /** Cantidad de eventos a mostrar (cap del buffer del cliente). Default 20. */
     readonly limit?: number;
 }
 interface UseWalletActivityResult {
-    readonly events: readonly WalletActivityEvent[];
+    /** Eventos tipados, más recientes primero. */
+    readonly events: readonly WalletActivityItem[];
     readonly isLoading: boolean;
     readonly error: Error | null;
     refresh(): Promise<void>;
@@ -775,4 +832,4 @@ declare function useWalletActivity(walletAddress?: string | null, opts?: UseWall
  */
 declare const REACT_ADAPTER_VERSION = "0.0.0";
 
-export { AcceslyContext, type AcceslyContextValue, type AcceslyHook, AcceslyProvider, type AcceslyProviderProps, type AuthNamespace, type BootstrapWalletInput, type CreateWalletInput, type CreatedWalletInfo, ENVIRONMENT_DEFAULTS, type EnsureWalletResult, type EnvironmentDefaults, type FinalizeRecoveryInput, type FinalizeRecoveryResult, type KycNamespace, NotImplementedYetError, REACT_ADAPTER_VERSION, type ReconstructedSeed, type RecoveryNamespace, type RemoteWalletInfo, type RetryDeployResult, type SendXlmInput, type SendXlmResult, type SessionNamespace, type SettingsNamespace, type TxNamespace, type UnlockedSigningMaterial, type UseBalanceResult, type UseWalletActivityOptions, type UseWalletActivityResult, type UseWalletStatusResult, type WalletNamespace, type WalletStatus, type WalletStatusValue, type YieldNamespace, useAccesly, useBalance, useWalletActivity, useWalletStatus };
+export { AcceslyContext, type AcceslyContextValue, type AcceslyHook, AcceslyProvider, type AcceslyProviderProps, type AuthNamespace, type BootstrapWalletInput, type CreateWalletInput, type CreatedWalletInfo, ENVIRONMENT_DEFAULTS, type EnsureWalletResult, type EnvironmentDefaults, type FinalizeRecoveryInput, type FinalizeRecoveryResult, type KycNamespace, NotImplementedYetError, REACT_ADAPTER_VERSION, type ReconstructedSeed, type RecoveryNamespace, type RemoteWalletInfo, type RetryDeployResult, type SendXlmInput, type SendXlmResult, type SessionNamespace, type SettingsNamespace, type TxNamespace, type UnlockedSigningMaterial, type UseBalanceResult, type UseWalletActivityOptions, type UseWalletActivityResult, type UseWalletStatusResult, type WalletActivityItem, type WalletNamespace, type WalletStatus, type WalletStatusValue, type WalletStreamActivityPayload, type WalletStreamBalancePayload, type WalletStreamEventType, type WalletStreamStatusPayload, type YieldNamespace, closeAllWalletSubscriptions, subscribeToWalletEvent, useAccesly, useBalance, useWalletActivity, useWalletStatus };

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { Environment, CognitoConfig, AuthClient, SessionStorage, DeviceStore, TelemetrySink, TokenManager, AccesslyEndpoints, AuthStatus, CredentialRecord, EncryptedEnvelope, WalletActivityEvent } from '@accesly/core';
+import { Environment, CognitoConfig, AuthClient, SessionStorage, DeviceStore, TelemetrySink, TokenManager, AccesslyEndpoints, AuthStatus, CredentialRecord, EncryptedEnvelope } from '@accesly/core';
 import * as react from 'react';
 import { ReactNode } from 'react';
 
@@ -60,6 +60,13 @@ declare const AcceslyContext: react.Context<AcceslyContextValue | null>;
 
 interface EnvironmentDefaults {
     readonly apiUrl: string;
+    /**
+     * Lambda Function URL del `wallet-stream` Lambda — Server-Sent Events
+     * que multiplexa status + balance + activity en una sola conexión.
+     * Si está vacío, los hooks `useBalance` / `useWalletActivity` /
+     * `useWalletStatus` caen al polling fallback (mucho menos eficiente).
+     */
+    readonly walletStreamUrl: string;
     readonly cognito: CognitoConfig;
     readonly stellar: {
         readonly networkPassphrase: string;
@@ -650,101 +657,151 @@ interface AcceslyHook {
 declare function useAccesly(): AcceslyHook;
 
 /**
- * `useWalletStatus()` — hook event-driven que sustituye al
- * `setInterval(fetchRemote, 30_000)` que cada integrador escribía en su
- * `Wallet.tsx` / `CreateWallet.tsx`.
- *
- * Comportamiento:
- *
- *   1. **SSE-first.** Si la infra del backend expone `GET /wallets/stream`
- *      (Lambda function URL con response streaming), el hook se suscribe vía
- *      `EventSource` y reacciona instantáneamente a cambios on-chain. Cero
- *      polling, cero latencia.
+ * `useWalletStatus()` — status on-chain del Smart Account del user actual con
+ * push real-time vía SSE.
  *
- *   2. **Polling con backoff inteligente como fallback.** Si SSE no está
- *      disponible (backend viejo, sandbox sin streaming, browser sin
- *      `EventSource`), cae a polling con backoff exponencial:
- *        - mientras la wallet NO está `'on-chain'`: 2s → 5s → 10s → 20s →
- *          30s (cap).
- *        - si llega `'on-chain'` o el tab queda oculto: polling pausado.
- *        - llamadas de `refresh()` resetean el backoff a 2s.
- *      Mucho mejor UX que el `30s` constante del legacy.
+ * Reemplaza el polling cada 30s del legacy. Comportamiento:
  *
- *   3. **`document.visibilityState` aware.** Pausa cuando el tab está oculto;
- *      retoma + refresca inmediatamente cuando vuelve a visible.
+ *   1. SSE-first: si `walletStreamUrl` está configurado y `EventSource` existe,
+ *      se suscribe al canal `status` del `wallet-stream` Lambda. Cero polling.
+ *   2. Fallback a polling backoff (1s → 30s) si SSE no está disponible.
+ *   3. Pausa cuando `document.hidden`, retoma al volver.
+ *   4. `refresh()` fuerza fetch HTTP inmediato.
  *
- *   4. **Cross-tab via `BroadcastChannel`.** Si el user tiene la app abierta
- *      en 2 tabs, el primero que reciba un update lo emite por el canal
- *      `accesly:wallet:<username>` y los otros tabs lo aplican sin hacer su
- *      propio fetch — un solo round-trip por update.
- *
- * Devuelve `{ status, walletAddress, onChain, isStale, refresh }`. `refresh()`
- * fuerza un fetch inmediato + resetea backoff. `isStale` = `true` si no se ha
- * podido confirmar status en > 60s (red/Soroban RPC caído).
+ * El status del Smart Account vive en DDB (lo que el backend reporta de su
+ * verificación contra Soroban). El backend push-ea cambios cuando los detecta
+ * (cada 5s en el loop del wallet-stream).
  */
 type WalletStatusValue = 'on-chain' | 'pending-deploy' | 'unknown' | 'no-wallet';
 interface UseWalletStatusResult {
-    /** Status actual. `'no-wallet'` si el backend nunca recibió un POST /wallets. */
     readonly status: WalletStatusValue;
-    /** Address C…, o null si no hay wallet. */
     readonly walletAddress: string | null;
-    /** Mirror del campo `onChain` del backend (true / false / null). */
     readonly onChain: boolean | null;
-    /** True si el último fetch exitoso fue hace más de 60s — UI puede mostrar warning. */
     readonly isStale: boolean;
-    /** Fuerza fetch inmediato + resetea backoff. Llamalo tras submit/recovery. */
     refresh(): Promise<void>;
 }
 declare function useWalletStatus(): UseWalletStatusResult;
 
 /**
- * `useBalance(walletAddress?)` — hook que devuelve el balance XLM del Smart
- * Account con auto-refresh.
+ * `useBalance(walletAddress?)` — devuelve el balance XLM del Smart Account
+ * con push real-time vía SSE.
+ *
+ * Si SSE está configurado (env tiene `walletStreamUrl` y `EventSource` existe),
+ * el hook se suscribe al canal `balance` del `wallet-stream` Lambda y se
+ * actualiza instantáneamente cuando cambia el balance on-chain.
  *
- * Si no se le pasa `walletAddress`, intenta auto-resolverlo via
- * `wallet.getStoredCredential(username)` del DeviceStore — el flujo más
- * común (un solo wallet por user en este device).
+ * Fallback automático a polling cada 10s si SSE no está disponible (entorno
+ * que no lo soporta o backend self-hosteado sin el endpoint).
  *
- * Polling: 8s mientras tab visible, pausa cuando hidden, retoma al volver.
- * También se refresca inmediatamente cuando `useWalletStatus` reporta
- * `'on-chain'` (via cross-tab `BroadcastChannel`) para mostrar el balance
- * tras un deploy fresco.
+ * El `walletAddress` se auto-resuelve desde el `DeviceStore` si no se pasa
+ * (cubrir el caso "wallet del user actual sin tener que pasarla a mano").
  */
 interface UseBalanceResult {
     /** Stroops como string base-10. `null` mientras se carga o no hay address. */
     readonly stroops: string | null;
     /** Mismo balance como string decimal en XLM. `null` mientras se carga. */
     readonly xlm: string | null;
-    /** True durante el primer fetch (subsiguientes ediciones son silent). */
     readonly isLoading: boolean;
-    /** Error del último fetch, si lo hubo. */
     readonly error: Error | null;
-    /** Fuerza fetch inmediato. */
+    /** Fuerza fetch HTTP inmediato (útil tras una operación del user). */
     refresh(): Promise<void>;
 }
 declare function useBalance(walletAddress?: string | null): UseBalanceResult;
 
 /**
- * `useWalletActivity(walletAddress?, opts?)` — hook que devuelve los últimos
- * eventos on-chain del Smart Account, auto-refrescados cada 20s mientras la
- * tab está visible.
+ * `WalletSubscription` — singleton manager por wallet address que abre UNA
+ * sola conexión `EventSource` al `wallet-stream` Lambda y desmultiplexa los
+ * eventos a múltiples subscribers (hooks).
+ *
+ * Beneficios:
+ *  - 3 hooks (`useBalance`, `useWalletActivity`, `useWalletStatus`) sobre la
+ *    misma wallet → 1 sola conexión TCP, no 3 polls separados.
+ *  - Auto-reconnect cuando el server cierra (default de EventSource — `retry:`).
+ *  - Ref-count: la conexión se abre con el primer subscriber y se cierra
+ *    cuando no quedan listeners (`useEffect` cleanup en cada hook).
+ *  - Eventos cacheados: el último valor recibido de cada tipo se replay-ea
+ *    a nuevos subscribers para que no esperen el próximo push.
+ *
+ * Sin SSE configurado (`walletStreamUrl` vacío) o cuando `EventSource` no
+ * existe (SSR / workers), los hooks individuales detectan el flag
+ * `unavailable` y caen al polling fallback que ya existe.
+ */
+type WalletStreamEventType = 'status' | 'balance' | 'activity';
+interface WalletStreamStatusPayload {
+    readonly walletAddress: string | null;
+    readonly onChain: boolean | null;
+}
+interface WalletStreamBalancePayload {
+    readonly stroops: string;
+    readonly xlm: string;
+}
+/**
+ * Activity emitida por el backend ya **filtrada y tipada** — solo eventos
+ * relevantes para una wallet de Accesly (rotación de signers + transfers
+ * IN/OUT de XLM). Otros eventos on-chain (debug, errores host, eventos
+ * irrelevantes) se descartan en el server.
+ */
+type WalletActivityItem = {
+    readonly type: 'signer-rotated';
+    readonly txHash: string;
+    readonly ledger: number;
+    readonly timestamp: string | null;
+    readonly newOwnerEd25519Hex: string;
+} | {
+    readonly type: 'transfer-in';
+    readonly txHash: string;
+    readonly ledger: number;
+    readonly timestamp: string | null;
+    readonly from: string;
+    readonly amountStroops: string;
+} | {
+    readonly type: 'transfer-out';
+    readonly txHash: string;
+    readonly ledger: number;
+    readonly timestamp: string | null;
+    readonly to: string;
+    readonly amountStroops: string;
+};
+interface WalletStreamActivityPayload {
+    readonly events: readonly WalletActivityItem[];
+}
+type Listener<T> = (payload: T) => void;
+/**
+ * Suscribirse a un tipo de evento de la wallet. Devuelve una función
+ * de cleanup que el caller (típicamente `useEffect`) debe llamar para
+ * desuscribir y, eventualmente, cerrar la conexión SSE.
+ *
+ * Si SSE no está disponible (URL vacía, EventSource undefined), devuelve
+ * `null` para indicar al caller que use el fallback de polling.
+ */
+declare function subscribeToWalletEvent<T extends WalletStreamEventType>(streamUrl: string, walletAddress: string, eventType: T, listener: T extends 'status' ? Listener<WalletStreamStatusPayload> : T extends 'balance' ? Listener<WalletStreamBalancePayload> : Listener<WalletStreamActivityPayload>): (() => void) | null;
+/**
+ * Cierra TODAS las conexiones SSE activas. Útil para tests o cuando el user
+ * cierra sesión y querés limpiar conexiones colgadas. Llamar en `auth.signOut`
+ * lo tienen pendiente como mejora — por ahora el cleanup natural de los
+ * unmount basta.
+ */
+declare function closeAllWalletSubscriptions(): void;
+
+/**
+ * `useWalletActivity(walletAddress?, opts?)` — actividad on-chain relevante de
+ * la wallet (rotate_signer + transfers in/out de XLM) con push real-time vía SSE.
  *
- * Pasos:
- *   1. Resuelve `walletAddress` desde el DeviceStore si no se pasa explícito.
- *   2. Fetch inicial inmediato → guarda en estado.
- *   3. Polling cada 20s (pausado si tab oculta).
- *   4. `refresh()` para fetch on-demand tras una operación del user.
+ * El backend YA filtra eventos irrelevantes — el integrador solo recibe
+ * `WalletActivityItem` tipados (`signer-rotated` | `transfer-in` | `transfer-out`).
+ * Sin parsing manual de XDR ni lógica de filtrado client-side.
  *
- * Mejor UX que el "ver explorer link" porque la app puede renderizar la
- * lista de tx en su propio look — sin abrir otro tab a Stellar Expert.
+ * Fallback: si SSE no está disponible, polling cada 25s al endpoint
+ * `/wallets/:address/activity`. Mucho menos eficiente pero garantiza data.
  */
 
 interface UseWalletActivityOptions {
-    /** Cantidad de eventos a pedir. Default 20, max 50. */
+    /** Cantidad de eventos a mostrar (cap del buffer del cliente). Default 20. */
     readonly limit?: number;
 }
 interface UseWalletActivityResult {
-    readonly events: readonly WalletActivityEvent[];
+    /** Eventos tipados, más recientes primero. */
+    readonly events: readonly WalletActivityItem[];
     readonly isLoading: boolean;
     readonly error: Error | null;
     refresh(): Promise<void>;
@@ -775,4 +832,4 @@ declare function useWalletActivity(walletAddress?: string | null, opts?: UseWall
  */
 declare const REACT_ADAPTER_VERSION = "0.0.0";
 
-export { AcceslyContext, type AcceslyContextValue, type AcceslyHook, AcceslyProvider, type AcceslyProviderProps, type AuthNamespace, type BootstrapWalletInput, type CreateWalletInput, type CreatedWalletInfo, ENVIRONMENT_DEFAULTS, type EnsureWalletResult, type EnvironmentDefaults, type FinalizeRecoveryInput, type FinalizeRecoveryResult, type KycNamespace, NotImplementedYetError, REACT_ADAPTER_VERSION, type ReconstructedSeed, type RecoveryNamespace, type RemoteWalletInfo, type RetryDeployResult, type SendXlmInput, type SendXlmResult, type SessionNamespace, type SettingsNamespace, type TxNamespace, type UnlockedSigningMaterial, type UseBalanceResult, type UseWalletActivityOptions, type UseWalletActivityResult, type UseWalletStatusResult, type WalletNamespace, type WalletStatus, type WalletStatusValue, type YieldNamespace, useAccesly, useBalance, useWalletActivity, useWalletStatus };
+export { AcceslyContext, type AcceslyContextValue, type AcceslyHook, AcceslyProvider, type AcceslyProviderProps, type AuthNamespace, type BootstrapWalletInput, type CreateWalletInput, type CreatedWalletInfo, ENVIRONMENT_DEFAULTS, type EnsureWalletResult, type EnvironmentDefaults, type FinalizeRecoveryInput, type FinalizeRecoveryResult, type KycNamespace, NotImplementedYetError, REACT_ADAPTER_VERSION, type ReconstructedSeed, type RecoveryNamespace, type RemoteWalletInfo, type RetryDeployResult, type SendXlmInput, type SendXlmResult, type SessionNamespace, type SettingsNamespace, type TxNamespace, type UnlockedSigningMaterial, type UseBalanceResult, type UseWalletActivityOptions, type UseWalletActivityResult, type UseWalletStatusResult, type WalletActivityItem, type WalletNamespace, type WalletStatus, type WalletStatusValue, type WalletStreamActivityPayload, type WalletStreamBalancePayload, type WalletStreamEventType, type WalletStreamStatusPayload, type YieldNamespace, closeAllWalletSubscriptions, subscribeToWalletEvent, useAccesly, useBalance, useWalletActivity, useWalletStatus };