@0xmonaco/react 1.0.38 → 1.0.39

package/dist/hooks/useTokenLifecycle/types.d.ts

@@ -1,23 +1,37 @@
 import type { AuthState } from "@0xmonaco/types";
+/**
+ * Configuration for the session lifecycle hook.
+ *
+ * The `persistTokens` field name is a retained legacy compatibility name; it
+ * persists the ed25519 session key (the `AuthState`), not any JWT or bearer
+ * credential.
+ */
 export interface TokenLifecycleConfig {
-    /** Enable automatic token refresh (default: true) */
+    /** Enable automatic session refresh before expiry (default: true) */
     autoRefresh?: boolean;
-    /** Enable token persistence in localStorage (default: true) */
+    /** Persist the session in localStorage so it survives reloads (default: true) */
     persistTokens?: boolean;
-    /** Buffer time in seconds before token expiry to trigger refresh (default: 300 = 5 minutes) */
+    /** Buffer time in seconds before session expiry to trigger a refresh (default: 300 = 5 minutes) */
     refreshBufferSeconds?: number;
-    /** Callback when token refresh fails */
+    /** Callback when a session refresh fails */
     onRefreshError?: (error: Error) => void;
-    /** Callback when token is refreshed successfully */
+    /** Callback when the session is refreshed successfully */
     onRefreshSuccess?: (authState: AuthState) => void;
 }
+/**
+ * Return shape of the session lifecycle hook.
+ *
+ * The `initializeTokens`, `clearTokens`, `refreshTokens`, and `isTokenExpired`
+ * member names are retained legacy compatibility names; they all act on the
+ * session key.
+ */
 export interface UseTokenLifecycleReturn {
-    /** Initialize token lifecycle with auth state */
+    /** Start managing a session from an auth state (persists it and schedules auto-refresh) */
     initializeTokens: (authState: AuthState) => void;
-    /** Clear tokens and stop lifecycle management */
+    /** Stop managing the session, cancel scheduled refreshes, and clear persistence */
     clearTokens: () => void;
-    /** Manually trigger token refresh */
+    /** Manually extend the session's expiry now */
     refreshTokens: () => Promise<AuthState | null>;
-    /** Check if token is expired or near expiry */
+    /** Whether the session is expired or within the refresh buffer of expiry */
     isTokenExpired: (authState: AuthState | null) => boolean;
 }

package/dist/hooks/useTokenLifecycle/useTokenLifecycle.d.ts

@@ -1,11 +1,23 @@
 import type { MonacoSDK } from "@0xmonaco/core";
 import type { TokenLifecycleConfig, UseTokenLifecycleReturn } from "./types";
 /**
- * Hook for managing token lifecycle including automatic refresh and persistence
+ * Hook for managing the authenticated session lifecycle, including automatic
+ * refresh and persistence.
+ *
+ * Monaco authenticates with a wallet-authorized ed25519 session key (the
+ * `AuthState` returned by `login()`), not a JWT or bearer credential. This hook
+ * extends that session's expiry via `sdk.refreshAuth()` and persists the
+ * resulting `AuthState`; there is no separate access or refresh credential.
+ *
+ * The exported members and config fields listed here — `useTokenLifecycle`,
+ * `TokenLifecycleConfig`, `persistTokens`, `initializeTokens`, `clearTokens`,
+ * `refreshTokens`, `isTokenExpired`, and the like — are retained legacy
+ * compatibility names kept stable for existing consumers; they all operate on
+ * the session key.
  *
  * @param sdk - Monaco SDK instance
- * @param config - Configuration options for token lifecycle
- * @returns Token lifecycle management functions
+ * @param config - Configuration options for the session lifecycle
+ * @returns Session lifecycle management functions
  *
  * @example
  * ```tsx
@@ -13,7 +25,7 @@ import type { TokenLifecycleConfig, UseTokenLifecycleReturn } from "./types";
  *   autoRefresh: true,
  *   persistTokens: true,
  *   refreshBufferSeconds: 300, // 5 minutes
- *   onRefreshError: (error) => console.error('Token refresh failed:', error),
+ *   onRefreshError: (error) => console.error('Session refresh failed:', error),
  * });
  * ```
  */

package/dist/hooks/useTokenLifecycle/useTokenLifecycle.js

@@ -2,11 +2,23 @@ import { useCallback, useEffect, useMemo, useRef } from "react";
 import { clearAuthState, getTimeUntilExpiry, isTokenExpired, saveAuthState } from "../../utils";
 import { validateRefreshBuffer } from "./utils";
 /**
- * Hook for managing token lifecycle including automatic refresh and persistence
+ * Hook for managing the authenticated session lifecycle, including automatic
+ * refresh and persistence.
+ *
+ * Monaco authenticates with a wallet-authorized ed25519 session key (the
+ * `AuthState` returned by `login()`), not a JWT or bearer credential. This hook
+ * extends that session's expiry via `sdk.refreshAuth()` and persists the
+ * resulting `AuthState`; there is no separate access or refresh credential.
+ *
+ * The exported members and config fields listed here — `useTokenLifecycle`,
+ * `TokenLifecycleConfig`, `persistTokens`, `initializeTokens`, `clearTokens`,
+ * `refreshTokens`, `isTokenExpired`, and the like — are retained legacy
+ * compatibility names kept stable for existing consumers; they all operate on
+ * the session key.
  *
  * @param sdk - Monaco SDK instance
- * @param config - Configuration options for token lifecycle
- * @returns Token lifecycle management functions
+ * @param config - Configuration options for the session lifecycle
+ * @returns Session lifecycle management functions
  *
  * @example
  * ```tsx
@@ -14,7 +26,7 @@ import { validateRefreshBuffer } from "./utils";
  *   autoRefresh: true,
  *   persistTokens: true,
  *   refreshBufferSeconds: 300, // 5 minutes
- *   onRefreshError: (error) => console.error('Token refresh failed:', error),
+ *   onRefreshError: (error) => console.error('Session refresh failed:', error),
  * });
  * ```
  */
@@ -61,7 +73,7 @@ export const useTokenLifecycle = (sdk, config = {}) => {
             try {
                 // Re-check SDK in case it became null during async operations
                 if (!sdk) {
-                    console.warn("SDK became null during token refresh");
+                    console.warn("SDK became null during session refresh");
                     return null;
                 }
                 const newAuthState = await sdk.refreshAuth();
@@ -75,7 +87,7 @@ export const useTokenLifecycle = (sdk, config = {}) => {
             }
             catch (error) {
                 const err = error instanceof Error ? error : new Error(String(error));
-                console.error("Failed to refresh tokens:", err);
+                console.error("Failed to refresh session:", err);
                 if (persistTokens) {
                     clearAuthState();
                 }

package/dist/hooks/useUserMovements/useUserMovements.js

@@ -75,21 +75,17 @@ export function useUserMovements(options = {}) {
         sdk.profile
             .getPaginatedUserMovements({ pageSize: requestLimit, entryType, transactionType, assetId })
             .then(async (response) => {
-            // Combine latest_movements (from the live engine cache) with movements (from PostgreSQL)
-            // latest_movements contains real-time data that may not yet be in PostgreSQL
-            // Deduplicate by id, preferring latest_movements (newer data)
-            const latestMovements = (response.latest_movements || []).map((m) => ledgerMovementToEvent(m, userId));
+            // Deduplicate the paginated movements by id, keeping the first occurrence.
             const historicalMovements = response.movements.map((m) => ledgerMovementToEvent(m, userId));
-            // Merge: latest_movements first, then historical, deduplicated by id
             const seenIds = new Set();
-            const mergedMovements = [];
-            for (const movement of [...latestMovements, ...historicalMovements]) {
+            const dedupedMovements = [];
+            for (const movement of historicalMovements) {
                 if (!seenIds.has(movement.data.id)) {
                     seenIds.add(movement.data.id);
-                    mergedMovements.push(movement);
+                    dedupedMovements.push(movement);
                 }
             }
-            setMovements(mergedMovements.slice(0, sliceSize));
+            setMovements(dedupedMovements.slice(0, sliceSize));
             // Subscribe to WebSocket movement updates after initial data is loaded
             // This prevents race conditions where WS events could be overwritten by REST response
             try {

package/dist/hooks/useUserOrders/useUserOrders.js

@@ -27,21 +27,16 @@ export function useUserOrders(maxOrders = 50) {
                 pageSize: maxOrders,
                 pageToken: "",
             });
-            // Combine latest_orders (from the live engine cache) with orders (from PostgreSQL)
-            // latest_orders contains real-time data that may not yet be in PostgreSQL
-            // Deduplicate by id, preferring latest_orders (newer data)
-            const latestOrders = response.latest_orders || [];
-            const historicalOrders = response.orders;
-            // Merge: latest_orders first, then historical, deduplicated by id
+            // Deduplicate the paginated orders by id, keeping the first occurrence.
             const seenIds = new Set();
-            const mergedOrders = [];
-            for (const order of [...latestOrders, ...historicalOrders]) {
+            const dedupedOrders = [];
+            for (const order of response.orders) {
                 if (!seenIds.has(order.id)) {
                     seenIds.add(order.id);
-                    mergedOrders.push(order);
+                    dedupedOrders.push(order);
                 }
             }
-            setOrders(mergedOrders.slice(0, maxOrders));
+            setOrders(dedupedOrders.slice(0, maxOrders));
         }
         catch (err) {
             setError(err instanceof Error ? err : new Error(String(err)));

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@0xmonaco/react",
-	"version": "1.0.38",
+	"version": "1.0.39",
 	"type": "module",
 	"repository": {
 		"type": "git",
@@ -20,8 +20,8 @@
 		"lint": "biome lint ."
 	},
 	"dependencies": {
-		"@0xmonaco/core": "1.0.38",
-		"@0xmonaco/types": "1.0.38"
+		"@0xmonaco/core": "1.0.39",
+		"@0xmonaco/types": "1.0.39"
 	},
 	"devDependencies": {
 		"@types/react": "^19.1.12",