@accesly/react 1.2.0 → 1.3.1

package/dist/index.cjs

@@ -1,158 +1,350 @@
 'use strict';
 
-var core = require('@accesly/core');
 var react = require('react');
+var core = require('@accesly/core');
 var jsxRuntime = require('react/jsx-runtime');
 
-// src/provider.tsx
-var AcceslyContext = react.createContext(null);
+var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __esm = (fn, res) => function __init() {
+  return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
+};
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+exports.AcceslyContext = void 0;
+var init_context = __esm({
+  "src/context.ts"() {
+    exports.AcceslyContext = react.createContext(null);
+  }
+});
 
 // src/config.ts
-var ENVIRONMENT_DEFAULTS = {
-  dev: {
-    apiUrl: "https://3fki7eiio5.execute-api.us-east-1.amazonaws.com/dev",
-    walletStreamUrl: "https://ajlmn37thw7fxen3oyykbfmlrm0eecue.lambda-url.us-east-1.on.aws/",
-    cognito: {
-      region: "us-east-1",
-      userPoolId: "us-east-1_K2Nag1tB1",
-      userPoolClientId: "6r64diep7pne50sender4557jt"
-    },
-    stellar: {
-      networkPassphrase: "Test SDF Network ; September 2015",
-      horizonUrl: "https://horizon-testnet.stellar.org",
-      sorobanRpcUrl: "https://soroban-testnet.stellar.org",
-      // OZ Relayer channels-fund — see CloudServices-accesly/docs/Deployed_Resources_dev.md
-      deployerAddress: "GDRHSVLY3VCEHCHCSR5MZR2ALYLCERDDFT3ULCUIELGFVYHTZFCMNU4E",
-      // accesly-contracts Phase 1 deploy on Stellar testnet.
-      ed25519VerifierAddress: "CALVIIGIOMODZMWTMKZLSD4PZFFEPWQBSYERHUFM6MH5FLWKCHW4E4G5"
+exports.ENVIRONMENT_DEFAULTS = void 0;
+var init_config = __esm({
+  "src/config.ts"() {
+    exports.ENVIRONMENT_DEFAULTS = {
+      dev: {
+        apiUrl: "https://3fki7eiio5.execute-api.us-east-1.amazonaws.com/dev",
+        walletStreamUrl: "https://ajlmn37thw7fxen3oyykbfmlrm0eecue.lambda-url.us-east-1.on.aws/",
+        cognito: {
+          region: "us-east-1",
+          userPoolId: "us-east-1_K2Nag1tB1",
+          userPoolClientId: "6r64diep7pne50sender4557jt"
+        },
+        stellar: {
+          networkPassphrase: "Test SDF Network ; September 2015",
+          horizonUrl: "https://horizon-testnet.stellar.org",
+          sorobanRpcUrl: "https://soroban-testnet.stellar.org",
+          // OZ Relayer channels-fund — see CloudServices-accesly/docs/Deployed_Resources_dev.md
+          deployerAddress: "GDRHSVLY3VCEHCHCSR5MZR2ALYLCERDDFT3ULCUIELGFVYHTZFCMNU4E",
+          // accesly-contracts Phase 1 deploy on Stellar testnet.
+          ed25519VerifierAddress: "CALVIIGIOMODZMWTMKZLSD4PZFFEPWQBSYERHUFM6MH5FLWKCHW4E4G5"
+        }
+      },
+      staging: {
+        apiUrl: "https://api-staging.accesly.xyz",
+        walletStreamUrl: "",
+        cognito: {
+          region: "us-east-1",
+          userPoolId: "TBD-staging",
+          userPoolClientId: "TBD-staging"
+        },
+        stellar: {
+          networkPassphrase: "Test SDF Network ; September 2015",
+          horizonUrl: "https://horizon-testnet.stellar.org",
+          sorobanRpcUrl: "https://soroban-testnet.stellar.org",
+          deployerAddress: "GDRHSVLY3VCEHCHCSR5MZR2ALYLCERDDFT3ULCUIELGFVYHTZFCMNU4E",
+          ed25519VerifierAddress: "CALVIIGIOMODZMWTMKZLSD4PZFFEPWQBSYERHUFM6MH5FLWKCHW4E4G5"
+        }
+      },
+      prod: {
+        apiUrl: "https://api.accesly.xyz",
+        walletStreamUrl: "",
+        cognito: {
+          region: "us-east-1",
+          userPoolId: "TBD-prod",
+          userPoolClientId: "TBD-prod"
+        },
+        stellar: {
+          networkPassphrase: "Public Global Stellar Network ; September 2015",
+          horizonUrl: "https://horizon.stellar.org",
+          sorobanRpcUrl: "https://soroban-rpc.mainnet.stellar.org",
+          deployerAddress: "TBD-prod",
+          ed25519VerifierAddress: "TBD-prod"
+        }
+      }
+    };
+  }
+});
+function isSorobanDeployPendingError(err) {
+  if (!(err instanceof core.AccesslyApiError)) return false;
+  const haystack = `${err.message ?? ""} ${err.code ?? ""}`.toLowerCase();
+  return haystack.includes("txsorobaninvalid") || haystack.includes("soroban sendtransaction") || haystack.includes("soroban submit failed") || haystack.includes("scecexceededlimit") || haystack.includes("exceededlimit");
+}
+var init_sorobanDeployStatus = __esm({
+  "src/hooks/sorobanDeployStatus.ts"() {
+  }
+});
+
+// src/hooks/useWalletHistory.ts
+var useWalletHistory_exports = {};
+__export(useWalletHistory_exports, {
+  historyClearOptimistic: () => historyClearOptimistic,
+  historyOptimisticPush: () => historyOptimisticPush,
+  useWalletHistory: () => useWalletHistory
+});
+function useStableRef(value) {
+  const ref = react.useRef(value);
+  ref.current = value;
+  return ref;
+}
+function loadCache(walletAddress) {
+  if (typeof localStorage === "undefined") return null;
+  try {
+    const raw = localStorage.getItem(CACHE_KEY_PREFIX + walletAddress);
+    if (!raw) return null;
+    const parsed = JSON.parse(raw);
+    if (Date.now() - parsed.storedAt > CACHE_TTL_MS) return null;
+    return parsed;
+  } catch {
+    return null;
+  }
+}
+function saveCache(walletAddress, entry) {
+  if (typeof localStorage === "undefined") return;
+  try {
+    localStorage.setItem(CACHE_KEY_PREFIX + walletAddress, JSON.stringify(entry));
+  } catch {
+  }
+}
+function historyOptimisticPush(walletAddress, item) {
+  const current = optimisticItems.get(walletAddress) ?? [];
+  optimisticItems.set(walletAddress, [item, ...current]);
+  const listeners = optimisticListeners.get(walletAddress);
+  if (listeners) {
+    for (const fn of listeners) fn(optimisticItems.get(walletAddress) ?? []);
+  }
+}
+function historyClearOptimistic(walletAddress) {
+  optimisticItems.delete(walletAddress);
+  const listeners = optimisticListeners.get(walletAddress);
+  if (listeners) {
+    for (const fn of listeners) fn([]);
+  }
+}
+function subscribeOptimistic(walletAddress, listener) {
+  let set = optimisticListeners.get(walletAddress);
+  if (!set) {
+    set = /* @__PURE__ */ new Set();
+    optimisticListeners.set(walletAddress, set);
+  }
+  set.add(listener);
+  return () => {
+    set?.delete(listener);
+    if (set && set.size === 0) optimisticListeners.delete(walletAddress);
+  };
+}
+function useWalletHistory(walletAddress, opts = {}) {
+  const { wallet, _internal } = useAccesly();
+  const username = _internal.username;
+  const [resolvedAddress, setResolvedAddress] = react.useState(walletAddress ?? null);
+  const [events, setEvents] = react.useState([]);
+  const [optimistic, setOptimistic] = react.useState([]);
+  const [cursors, setCursors] = react.useState({ smartAccount: null, transfers: null });
+  const [isLoading, setIsLoading] = react.useState(true);
+  const [error, setError] = react.useState(null);
+  const [hasMore, setHasMore] = react.useState(true);
+  const walletRef = useStableRef(wallet);
+  react.useEffect(() => {
+    if (walletAddress) {
+      setResolvedAddress(walletAddress);
+      return;
     }
-  },
-  staging: {
-    apiUrl: "https://api-staging.accesly.xyz",
-    walletStreamUrl: "",
-    cognito: {
-      region: "us-east-1",
-      userPoolId: "TBD-staging",
-      userPoolClientId: "TBD-staging"
-    },
-    stellar: {
-      networkPassphrase: "Test SDF Network ; September 2015",
-      horizonUrl: "https://horizon-testnet.stellar.org",
-      sorobanRpcUrl: "https://soroban-testnet.stellar.org",
-      deployerAddress: "GDRHSVLY3VCEHCHCSR5MZR2ALYLCERDDFT3ULCUIELGFVYHTZFCMNU4E",
-      ed25519VerifierAddress: "CALVIIGIOMODZMWTMKZLSD4PZFFEPWQBSYERHUFM6MH5FLWKCHW4E4G5"
+    if (!username) {
+      setResolvedAddress(null);
+      return;
     }
-  },
-  prod: {
-    apiUrl: "https://api.accesly.xyz",
-    walletStreamUrl: "",
-    cognito: {
-      region: "us-east-1",
-      userPoolId: "TBD-prod",
-      userPoolClientId: "TBD-prod"
-    },
-    stellar: {
-      networkPassphrase: "Public Global Stellar Network ; September 2015",
-      horizonUrl: "https://horizon.stellar.org",
-      sorobanRpcUrl: "https://soroban-rpc.mainnet.stellar.org",
-      deployerAddress: "TBD-prod",
-      ed25519VerifierAddress: "TBD-prod"
+    let cancelled = false;
+    void (async () => {
+      try {
+        const stored = await walletRef.current.getStoredCredential(username);
+        if (cancelled) return;
+        setResolvedAddress(stored?.walletAddress ?? null);
+      } catch {
+        if (!cancelled) setResolvedAddress(null);
+      }
+    })();
+    return () => {
+      cancelled = true;
+    };
+  }, [walletAddress, username, walletRef]);
+  react.useEffect(() => {
+    if (!resolvedAddress) return void 0;
+    setOptimistic(optimisticItems.get(resolvedAddress) ?? []);
+    return subscribeOptimistic(resolvedAddress, setOptimistic);
+  }, [resolvedAddress]);
+  const endpointsRef = useStableRef(_internal.endpoints);
+  const transferScanLimit = opts.transferScanLimit ?? 50;
+  react.useEffect(() => {
+    if (!resolvedAddress) {
+      setIsLoading(false);
+      return void 0;
     }
-  }
-};
-function AcceslyProvider(props) {
-  const defaults = ENVIRONMENT_DEFAULTS[props.env];
-  const apiUrl = props.apiUrl ?? defaults.apiUrl;
-  const cognitoConfig = props.cognitoConfig ?? defaults.cognito;
-  const telemetry = props.telemetry;
-  const instances = react.useMemo(() => {
-    const authClient = props.overrides?.authClient ?? new core.CognitoAuthClient(cognitoConfig);
-    const sessionStorage = props.overrides?.sessionStorage ?? core.defaultSessionStorage();
-    const deviceStore = props.overrides?.deviceStore ?? new core.InMemoryDeviceStore();
-    const tokenManager = new core.TokenManager({ authClient, storage: sessionStorage });
-    const apiClient = new core.AccesslyApiClient({
-      baseUrl: apiUrl,
-      getIdToken: () => tokenManager.getValidIdToken(),
-      ...telemetry ? { telemetry } : {}
-    });
-    const endpoints = new core.AccesslyEndpoints(apiClient);
-    return { authClient, sessionStorage, deviceStore, tokenManager, endpoints };
-  }, [
-    apiUrl,
-    cognitoConfig.region,
-    cognitoConfig.userPoolId,
-    cognitoConfig.userPoolClientId,
-    props.overrides?.authClient,
-    props.overrides?.sessionStorage,
-    props.overrides?.deviceStore
-  ]);
-  const [status, setStatus] = react.useState(() => initialStatus(instances.sessionStorage));
-  const [username, setUsername] = react.useState(
-    () => initialUsername(instances.sessionStorage)
-  );
-  const mountedRef = react.useRef(true);
-  const refreshStatus = react.useCallback(async () => {
-    const next = await instances.tokenManager.getStatus();
-    const tokens = await Promise.resolve(instances.sessionStorage.load());
-    if (mountedRef.current) {
-      setStatus(next);
-      setUsername(tokens?.username ?? null);
+    const cached = loadCache(resolvedAddress);
+    if (cached) {
+      setEvents(cached.items);
+      setCursors(cached.cursors);
+      setIsLoading(false);
     }
-  }, [instances]);
-  react.useEffect(() => {
-    mountedRef.current = true;
-    void refreshStatus();
+    let cancelled = false;
+    const channel = typeof BroadcastChannel !== "undefined" ? new BroadcastChannel(BROADCAST_CHANNEL_PREFIX + resolvedAddress) : null;
+    if (channel) {
+      channel.onmessage = (ev) => {
+        const data = ev.data;
+        if (data && !cancelled) {
+          setEvents(data.items);
+          setCursors(data.cursors);
+          setIsLoading(false);
+        }
+      };
+    }
+    void (async () => {
+      try {
+        const result = await endpointsRef.current.walletHistory(resolvedAddress, {
+          transferScanLimit
+        });
+        if (cancelled) return;
+        const deduped = dedupItems(result.events);
+        setEvents(deduped);
+        setCursors(result.cursors);
+        setIsLoading(false);
+        setError(null);
+        setHasMore(result.cursors.smartAccount !== null || result.cursors.transfers !== null);
+        const entry = {
+          items: deduped,
+          cursors: result.cursors,
+          storedAt: Date.now()
+        };
+        saveCache(resolvedAddress, entry);
+        channel?.postMessage(entry);
+      } catch (err) {
+        if (!cancelled) {
+          setError(err);
+          setIsLoading(false);
+        }
+      }
+    })();
     return () => {
-      mountedRef.current = false;
+      cancelled = true;
+      channel?.close();
     };
-  }, [instances]);
-  const value = react.useMemo(
-    () => ({
-      appId: props.appId,
-      env: props.env,
-      apiUrl,
-      cognitoConfig,
-      authClient: instances.authClient,
-      sessionStorage: instances.sessionStorage,
-      tokenManager: instances.tokenManager,
-      endpoints: instances.endpoints,
-      deviceStore: instances.deviceStore,
-      status,
-      username,
-      refreshStatus
-    }),
-    [props.appId, props.env, apiUrl, cognitoConfig, instances, status, username, refreshStatus]
-  );
-  return /* @__PURE__ */ jsxRuntime.jsx(AcceslyContext.Provider, { value, children: props.children });
-}
-function initialStatus(storage) {
-  const tokens = storage.load();
-  if (tokens instanceof Promise) return "bootstrapping";
-  if (!tokens) return "anonymous";
-  return Date.now() + 5 * 60 * 1e3 >= tokens.expiresAt ? "expired" : "authenticated";
+  }, [resolvedAddress, transferScanLimit, endpointsRef]);
+  const interval = opts.pollIntervalMs ?? POLL_INTERVAL_MS;
+  react.useEffect(() => {
+    if (!resolvedAddress || interval === 0) return void 0;
+    const tick = async () => {
+      if (typeof document !== "undefined" && document.hidden) return;
+      try {
+        const result = await endpointsRef.current.walletHistory(resolvedAddress, {
+          transferScanLimit
+        });
+        setEvents((prev) => mergeAndDedup(prev, result.events));
+        const realTxHashes = new Set(result.events.map((it) => it.txHash));
+        const current = optimisticItems.get(resolvedAddress) ?? [];
+        const remaining = current.filter((it) => !realTxHashes.has(it.txHash));
+        if (remaining.length !== current.length) {
+          optimisticItems.set(resolvedAddress, remaining);
+          const listeners = optimisticListeners.get(resolvedAddress);
+          if (listeners) for (const fn of listeners) fn(remaining);
+        }
+      } catch {
+      }
+    };
+    const id = setInterval(tick, interval);
+    return () => clearInterval(id);
+  }, [resolvedAddress, interval, transferScanLimit, endpointsRef]);
+  const loadMoreImpl = react.useCallback(async () => {
+    if (!resolvedAddress) return;
+    if (!cursors.smartAccount && !cursors.transfers) {
+      setHasMore(false);
+      return;
+    }
+    try {
+      const result = await endpointsRef.current.walletHistory(resolvedAddress, {
+        ...cursors.smartAccount ? { smartAccountCursor: cursors.smartAccount } : {},
+        ...cursors.transfers ? { transfersCursor: cursors.transfers } : {},
+        transferScanLimit
+      });
+      setEvents((prev) => mergeAndDedup(prev, result.events));
+      setCursors(result.cursors);
+      setHasMore(result.cursors.smartAccount !== null || result.cursors.transfers !== null);
+    } catch (err) {
+      setError(err);
+    }
+  }, [resolvedAddress, cursors, transferScanLimit, endpointsRef]);
+  const refreshImpl = react.useCallback(async () => {
+    if (!resolvedAddress) return;
+    setIsLoading(true);
+    try {
+      const result = await endpointsRef.current.walletHistory(resolvedAddress, {
+        transferScanLimit
+      });
+      const deduped = dedupItems(result.events);
+      setEvents(deduped);
+      setCursors(result.cursors);
+      setError(null);
+      saveCache(resolvedAddress, {
+        items: deduped,
+        cursors: result.cursors,
+        storedAt: Date.now()
+      });
+    } catch (err) {
+      setError(err);
+    } finally {
+      setIsLoading(false);
+    }
+  }, [resolvedAddress, transferScanLimit, endpointsRef]);
+  const combined = [...optimistic, ...events];
+  return {
+    events: combined,
+    isLoading,
+    error,
+    hasMore,
+    loadMore: loadMoreImpl,
+    refresh: refreshImpl
+  };
 }
-function initialUsername(storage) {
-  const tokens = storage.load();
-  if (tokens instanceof Promise) return null;
-  return tokens?.username ?? null;
+function dedupItems(items) {
+  const seen = /* @__PURE__ */ new Set();
+  const out = [];
+  for (const item of items) {
+    const key = `${item.type}:${item.txHash}:${item.ledger}`;
+    if (seen.has(key)) continue;
+    seen.add(key);
+    out.push(item);
+  }
+  out.sort((a, b) => b.ledger - a.ledger);
+  return out;
 }
-function isSorobanDeployPendingError(err) {
-  if (!(err instanceof core.AccesslyApiError)) return false;
-  const haystack = `${err.message ?? ""} ${err.code ?? ""}`.toLowerCase();
-  return haystack.includes("txsorobaninvalid") || haystack.includes("soroban sendtransaction") || haystack.includes("soroban submit failed") || haystack.includes("scecexceededlimit") || haystack.includes("exceededlimit");
+function mergeAndDedup(prev, fresh) {
+  return dedupItems([...fresh, ...prev]);
 }
-
-// src/hooks/useAccesly.ts
-var NotImplementedYetError = class extends Error {
-  constructor(namespace, method) {
-    super(
-      `${namespace}.${method}() is not implemented yet. This namespace ships in a later release; see docs/Handoff_Fase7.md for the roadmap.`
-    );
-    this.name = "NotImplementedYetError";
+var POLL_INTERVAL_MS, CACHE_TTL_MS, CACHE_KEY_PREFIX, BROADCAST_CHANNEL_PREFIX, optimisticItems, optimisticListeners;
+var init_useWalletHistory = __esm({
+  "src/hooks/useWalletHistory.ts"() {
+    init_useAccesly();
+    POLL_INTERVAL_MS = 3e4;
+    CACHE_TTL_MS = 12 * 60 * 60 * 1e3;
+    CACHE_KEY_PREFIX = "accesly:history:";
+    BROADCAST_CHANNEL_PREFIX = "accesly:history:";
+    optimisticItems = /* @__PURE__ */ new Map();
+    optimisticListeners = /* @__PURE__ */ new Map();
   }
-};
+});
 function useAccesly() {
-  const ctx = react.useContext(AcceslyContext);
+  const ctx = react.useContext(exports.AcceslyContext);
   if (!ctx) {
     throw new Error(
       "useAccesly: missing <AcceslyProvider>. Wrap your app with <AcceslyProvider appId env>."
@@ -184,7 +376,7 @@ function useAccesly() {
     [ctx]
   );
   const { hexToBytes, hexFromBytes } = react.useMemo(() => coderHelpers(), []);
-  const stellarConfig = ENVIRONMENT_DEFAULTS[ctx.env].stellar;
+  const stellarConfig = exports.ENVIRONMENT_DEFAULTS[ctx.env].stellar;
   const wallet = react.useMemo(() => {
     const c = ctx;
     const postWallet = async (params) => {
@@ -634,6 +826,24 @@ function useAccesly() {
           unsignedXdr: sim.unsignedXdr,
           signedAuthEntryXdr
         });
+        try {
+          const username = ctx.username;
+          if (username) {
+            const stored = await ctx.deviceStore.loadCredential(username);
+            if (stored?.walletAddress) {
+              const { historyOptimisticPush: historyOptimisticPush2 } = await Promise.resolve().then(() => (init_useWalletHistory(), useWalletHistory_exports));
+              historyOptimisticPush2(stored.walletAddress, {
+                type: "transfer-out",
+                txHash: submit.txHash,
+                ledger: Math.floor(Date.now() / 1e3),
+                timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+                to: input.destinationAddress,
+                amountStroops: input.amountStroops
+              });
+            }
+          }
+        } catch {
+        }
         return {
           txHash: submit.txHash,
           status: submit.status,
@@ -851,10 +1061,10 @@ function useAccesly() {
   const session = react.useMemo(
     () => ({
       async create() {
-        throw new NotImplementedYetError("session", "create");
+        throw new exports.NotImplementedYetError("session", "create");
       },
       async revoke() {
-        throw new NotImplementedYetError("session", "revoke");
+        throw new exports.NotImplementedYetError("session", "revoke");
       }
     }),
     []
@@ -862,16 +1072,16 @@ function useAccesly() {
   const settings = react.useMemo(
     () => ({
       async addDevice() {
-        throw new NotImplementedYetError("settings", "addDevice");
+        throw new exports.NotImplementedYetError("settings", "addDevice");
       },
       async removeDevice() {
-        throw new NotImplementedYetError("settings", "removeDevice");
+        throw new exports.NotImplementedYetError("settings", "removeDevice");
       },
       async listDevices() {
-        throw new NotImplementedYetError("settings", "listDevices");
+        throw new exports.NotImplementedYetError("settings", "listDevices");
       },
       async updateSpendingLimit() {
-        throw new NotImplementedYetError("settings", "updateSpendingLimit");
+        throw new exports.NotImplementedYetError("settings", "updateSpendingLimit");
       }
     }),
     []
@@ -879,13 +1089,13 @@ function useAccesly() {
   const yieldOps = react.useMemo(
     () => ({
       async invest() {
-        throw new NotImplementedYetError("yield", "invest");
+        throw new exports.NotImplementedYetError("yield", "invest");
       },
       async redeem() {
-        throw new NotImplementedYetError("yield", "redeem");
+        throw new exports.NotImplementedYetError("yield", "redeem");
       },
       async position() {
-        throw new NotImplementedYetError("yield", "position");
+        throw new exports.NotImplementedYetError("yield", "position");
       }
     }),
     []
@@ -931,6 +1141,111 @@ function base64ToBytes(s) {
   for (let i = 0; i < bin.length; i += 1) arr[i] = bin.charCodeAt(i);
   return arr;
 }
+exports.NotImplementedYetError = void 0;
+var init_useAccesly = __esm({
+  "src/hooks/useAccesly.ts"() {
+    init_context();
+    init_config();
+    init_sorobanDeployStatus();
+    exports.NotImplementedYetError = class extends Error {
+      constructor(namespace, method) {
+        super(
+          `${namespace}.${method}() is not implemented yet. This namespace ships in a later release; see docs/Handoff_Fase7.md for the roadmap.`
+        );
+        this.name = "NotImplementedYetError";
+      }
+    };
+  }
+});
+
+// src/provider.tsx
+init_context();
+init_config();
+function AcceslyProvider(props) {
+  const defaults = exports.ENVIRONMENT_DEFAULTS[props.env];
+  const apiUrl = props.apiUrl ?? defaults.apiUrl;
+  const cognitoConfig = props.cognitoConfig ?? defaults.cognito;
+  const telemetry = props.telemetry;
+  const instances = react.useMemo(() => {
+    const authClient = props.overrides?.authClient ?? new core.CognitoAuthClient(cognitoConfig);
+    const sessionStorage = props.overrides?.sessionStorage ?? core.defaultSessionStorage();
+    const deviceStore = props.overrides?.deviceStore ?? new core.InMemoryDeviceStore();
+    const tokenManager = new core.TokenManager({ authClient, storage: sessionStorage });
+    const apiClient = new core.AccesslyApiClient({
+      baseUrl: apiUrl,
+      getIdToken: () => tokenManager.getValidIdToken(),
+      ...telemetry ? { telemetry } : {}
+    });
+    const endpoints = new core.AccesslyEndpoints(apiClient);
+    return { authClient, sessionStorage, deviceStore, tokenManager, endpoints };
+  }, [
+    apiUrl,
+    cognitoConfig.region,
+    cognitoConfig.userPoolId,
+    cognitoConfig.userPoolClientId,
+    props.overrides?.authClient,
+    props.overrides?.sessionStorage,
+    props.overrides?.deviceStore
+  ]);
+  const [status, setStatus] = react.useState(() => initialStatus(instances.sessionStorage));
+  const [username, setUsername] = react.useState(
+    () => initialUsername(instances.sessionStorage)
+  );
+  const mountedRef = react.useRef(true);
+  const refreshStatus = react.useCallback(async () => {
+    const next = await instances.tokenManager.getStatus();
+    const tokens = await Promise.resolve(instances.sessionStorage.load());
+    if (mountedRef.current) {
+      setStatus(next);
+      setUsername(tokens?.username ?? null);
+    }
+  }, [instances]);
+  react.useEffect(() => {
+    mountedRef.current = true;
+    void refreshStatus();
+    return () => {
+      mountedRef.current = false;
+    };
+  }, [instances]);
+  const value = react.useMemo(
+    () => ({
+      appId: props.appId,
+      env: props.env,
+      apiUrl,
+      cognitoConfig,
+      authClient: instances.authClient,
+      sessionStorage: instances.sessionStorage,
+      tokenManager: instances.tokenManager,
+      endpoints: instances.endpoints,
+      deviceStore: instances.deviceStore,
+      status,
+      username,
+      refreshStatus
+    }),
+    [props.appId, props.env, apiUrl, cognitoConfig, instances, status, username, refreshStatus]
+  );
+  return /* @__PURE__ */ jsxRuntime.jsx(exports.AcceslyContext.Provider, { value, children: props.children });
+}
+function initialStatus(storage) {
+  const tokens = storage.load();
+  if (tokens instanceof Promise) return "bootstrapping";
+  if (!tokens) return "anonymous";
+  return Date.now() + 5 * 60 * 1e3 >= tokens.expiresAt ? "expired" : "authenticated";
+}
+function initialUsername(storage) {
+  const tokens = storage.load();
+  if (tokens instanceof Promise) return null;
+  return tokens?.username ?? null;
+}
+
+// src/index.ts
+init_context();
+init_config();
+init_useAccesly();
+
+// src/hooks/useWalletStatus.ts
+init_useAccesly();
+init_config();
 
 // src/hooks/walletSubscription.ts
 var ACTIVITY_BUFFER_MAX = 50;
@@ -1048,7 +1363,7 @@ function closeAllWalletSubscriptions() {
 // src/hooks/useWalletStatus.ts
 var POLL_BACKOFF_MS = [2e3, 5e3, 1e4, 2e4, 3e4];
 var STALE_THRESHOLD_MS = 6e4;
-function useStableRef(value) {
+function useStableRef2(value) {
   const ref = react.useRef(value);
   ref.current = value;
   return ref;
@@ -1066,9 +1381,9 @@ function useWalletStatus() {
   const [onChain, setOnChain] = react.useState(null);
   const [lastSuccessAt, setLastSuccessAt] = react.useState(0);
   const [isStale, setIsStale] = react.useState(false);
-  const envDefaults = ENVIRONMENT_DEFAULTS[_internal.env];
+  const envDefaults = exports.ENVIRONMENT_DEFAULTS[_internal.env];
   const streamUrl = envDefaults.walletStreamUrl;
-  const walletRef = useStableRef(wallet);
+  const walletRef = useStableRef2(wallet);
   const doFetch = react.useCallback(async () => {
     if (!username) return null;
     try {
@@ -1092,7 +1407,7 @@ function useWalletStatus() {
       return null;
     }
   }, [username, walletRef]);
-  const doFetchRef = useStableRef(doFetch);
+  const doFetchRef = useStableRef2(doFetch);
   react.useEffect(() => {
     if (!username) {
       setStatus("unknown");
@@ -1160,8 +1475,12 @@ function useWalletStatus() {
   }, [doFetchRef]);
   return { status, walletAddress, onChain, isStale, refresh };
 }
+
+// src/hooks/useBalance.ts
+init_useAccesly();
+init_config();
 var POLL_FALLBACK_MS = 1e4;
-function useStableRef2(value) {
+function useStableRef3(value) {
   const ref = react.useRef(value);
   ref.current = value;
   return ref;
@@ -1176,7 +1495,7 @@ function useBalance(walletAddress) {
   const [xlm, setXlm] = react.useState(null);
   const [isLoading, setIsLoading] = react.useState(true);
   const [error, setError] = react.useState(null);
-  const walletRef = useStableRef2(wallet);
+  const walletRef = useStableRef3(wallet);
   react.useEffect(() => {
     if (walletAddress) {
       setResolvedAddress(walletAddress);
@@ -1200,9 +1519,9 @@ function useBalance(walletAddress) {
       cancelled = true;
     };
   }, [walletAddress, username, walletRef]);
-  const envDefaults = ENVIRONMENT_DEFAULTS[_internal.env];
+  const envDefaults = exports.ENVIRONMENT_DEFAULTS[_internal.env];
   const streamUrl = envDefaults.walletStreamUrl;
-  const endpointsRef = useStableRef2(_internal.endpoints);
+  const endpointsRef = useStableRef3(_internal.endpoints);
   const doFetchOnce = react.useCallback(async () => {
     if (!resolvedAddress) return;
     try {
@@ -1216,7 +1535,7 @@ function useBalance(walletAddress) {
       setIsLoading(false);
     }
   }, [resolvedAddress, endpointsRef]);
-  const doFetchRef = useStableRef2(doFetchOnce);
+  const doFetchRef = useStableRef3(doFetchOnce);
   react.useEffect(() => {
     if (!resolvedAddress) {
       setIsLoading(false);
@@ -1261,9 +1580,13 @@ function useBalance(walletAddress) {
   }, [doFetchRef]);
   return { stroops, xlm, isLoading, error, refresh };
 }
+
+// src/hooks/useWalletActivity.ts
+init_useAccesly();
+init_config();
 var POLL_FALLBACK_MS2 = 25e3;
 var DEFAULT_LIMIT = 20;
-function useStableRef3(value) {
+function useStableRef4(value) {
   const ref = react.useRef(value);
   ref.current = value;
   return ref;
@@ -1278,7 +1601,7 @@ function useWalletActivity(walletAddress, opts = {}) {
   const [events, setEvents] = react.useState([]);
   const [isLoading, setIsLoading] = react.useState(true);
   const [error, setError] = react.useState(null);
-  const walletRef = useStableRef3(wallet);
+  const walletRef = useStableRef4(wallet);
   react.useEffect(() => {
     if (walletAddress) {
       setResolvedAddress(walletAddress);
@@ -1302,9 +1625,9 @@ function useWalletActivity(walletAddress, opts = {}) {
       cancelled = true;
     };
   }, [walletAddress, username, walletRef]);
-  const envDefaults = ENVIRONMENT_DEFAULTS[_internal.env];
+  const envDefaults = exports.ENVIRONMENT_DEFAULTS[_internal.env];
   const streamUrl = envDefaults.walletStreamUrl;
-  const endpointsRef = useStableRef3(_internal.endpoints);
+  const endpointsRef = useStableRef4(_internal.endpoints);
   const doFetchOnce = react.useCallback(async () => {
     if (!resolvedAddress) return;
     try {
@@ -1322,7 +1645,7 @@ function useWalletActivity(walletAddress, opts = {}) {
       setIsLoading(false);
     }
   }, [resolvedAddress, limit, endpointsRef]);
-  const doFetchRef = useStableRef3(doFetchOnce);
+  const doFetchRef = useStableRef4(doFetchOnce);
   react.useEffect(() => {
     if (!resolvedAddress) {
       setIsLoading(false);
@@ -1370,18 +1693,19 @@ function adaptRestEvent(ev) {
 }
 
 // src/index.ts
+init_useWalletHistory();
 var REACT_ADAPTER_VERSION = "0.0.0";
 
-exports.AcceslyContext = AcceslyContext;
 exports.AcceslyProvider = AcceslyProvider;
-exports.ENVIRONMENT_DEFAULTS = ENVIRONMENT_DEFAULTS;
-exports.NotImplementedYetError = NotImplementedYetError;
 exports.REACT_ADAPTER_VERSION = REACT_ADAPTER_VERSION;
 exports.closeAllWalletSubscriptions = closeAllWalletSubscriptions;
+exports.historyClearOptimistic = historyClearOptimistic;
+exports.historyOptimisticPush = historyOptimisticPush;
 exports.subscribeToWalletEvent = subscribeToWalletEvent;
 exports.useAccesly = useAccesly;
 exports.useBalance = useBalance;
 exports.useWalletActivity = useWalletActivity;
+exports.useWalletHistory = useWalletHistory;
 exports.useWalletStatus = useWalletStatus;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map