@funkit/connect 9.12.0 → 9.13.0

package/CHANGELOG.md

@@ -1,5 +1,24 @@
 # @funkit/connect
 
+## 9.13.0
+
+### Minor Changes
+
+- ac8b104: Add `showWalletConnect` option to `uiCustomizations.sourceChangeScreen` to allow hiding the wallet connect payment method
+
+### Patch Changes
+
+- 01826fb: chore(connect): bump postcss
+- ab86ca3: refactor(connect): split `SourceList` into a thin composer + `FlatList`/`GroupedList` layout primitives. Internal-only; no public API change; rendered DOM unchanged.
+- 6039a1b: When `externalUserId` is set for Lighter customers, use it directly as `userId` and `walletAddress` instead of wrapping via `generateSyntheticUserId`
+- 3719658: Split useRecentDeposits into a raw API hook and a pure testable transform function
+- ce7e633: Internal: add `testId` prop to `SourceList` for testability.
+- 7743d5b: Extract withdrawal error notification helpers into ErrorMessage module
+- 7743d5b: Extract WithdrawRecipientAddress into its own module and allow multi-method config to disable connected wallet
+- 7743d5b: Use config source chain for withdrawal source token price lookup
+- Updated dependencies [ec97ba2]
+  - @funkit/fun-relay@2.7.2
+
 ## 9.12.0
 
 ### Minor Changes

package/README.md

@@ -10,3 +10,24 @@ The `@funkit/connect` package elevates decentralize applications via web2 & web3
 ### 📝 Note
 
 This package is currently in closed beta. To learn more, reach out to [developers@fun.xyz](mailto:developers@fun.xyz).
+
+## Development
+
+### Running tests
+
+From the monorepo root:
+
+```bash
+# Run all connect tests once
+pnpm --filter=@funkit/connect test
+
+# Run with coverage (terminal summary + lcov + HTML report)
+pnpm --filter=@funkit/connect test:coverage
+
+# Open the Vitest UI (interactive dashboard with live coverage heatmap)
+pnpm --filter=@funkit/connect test:ui
+```
+
+After `test:coverage`, open `packages/connect/coverage/index.html` to browse the HTML report. The `coverage/` directory is gitignored.
+
+Coverage is collected by [`@vitest/coverage-v8`](https://vitest.dev/guide/coverage) and excludes generated files, Storybook stories, vanilla-extract style files (`*.css.ts`), and translation JSON. Update the `coverage` block in `vitest.config.ts` to tweak include/exclude patterns.

package/dist/clients/lighter.js

@@ -120,6 +120,7 @@ var DEFAULT_UI_CUSTOMIZATIONS = {
     },
     showTargetAssetSelection: false,
     showWalletOnInsufficientBalance: false,
+    showWalletConnect: true,
     paymentMethodIcons: {}
   },
   inputAmountScreen: {

package/dist/components/FunOptionBox/FunOptionBox.css.d.ts

@@ -1 +1 @@
-export declare const funOptionBoxStyle: Record<"activeBackground" | "baseStyle" | "compactListStyle" | "defaultBorder" | "defaultModeNotActiveBorder" | "activeBorder" | "disabledOptionBorder" | "defaultBackground" | "uninteractiveBackground", string>;
+export declare const funOptionBoxStyle: Record<"baseStyle" | "compactListStyle" | "defaultBorder" | "defaultModeNotActiveBorder" | "activeBorder" | "disabledOptionBorder" | "defaultBackground" | "activeBackground" | "uninteractiveBackground", string>;

package/dist/hooks/queries/useRecentDeposits.d.ts

@@ -1,47 +1,7 @@
 import { type DirectExecution } from '@funkit/api-base';
+import { type UseQueryResult } from '@tanstack/react-query';
+import type { NotificationVariant } from '../../modals/CheckoutModal/TransferToken/types';
 import { type PurifiedCheckoutHistoryItem } from '../../utils/purifyCheckoutHistoryItem';
-/**
- * Query parameters for the useRecentDeposits hook.
- */
-interface RecentDirectExecutionsQuery {
-    /**
-     * Controls whether the hook should fetch and return data.
-     * When false, the query is disabled and no data will be fetched.
-     */
-    isVisible: boolean;
-    /**
-     * Optional filter function to further refine which deposits are returned.
-     * WARNING: Must be a stable reference (wrap in useMemo), otherwise the hook will constantly re-render.
-     * @param de - The DirectExecution to filter
-     * @returns true to include the deposit, false to exclude it
-     */
-    memoizedFilterFunc?: (de: DirectExecution) => boolean;
-    /**
-     * Maximum number of deposits to fetch from the API.
-     * @default 5
-     */
-    fetchSize?: number;
-    /**
-     * Custom cutoff time in milliseconds for determining which deposits are "recent".
-     * Deposits created after this timestamp will be included.
-     * If not provided, uses Fun's default strategy.
-     */
-    cutOffTimeMs?: number;
-    /**
-     * API key for authenticating requests to Fun's API server.
-     */
-    apiKey: string;
-    /**
-     * User ID for which to fetch direct executions.
-     * Usually user's connected wallet address.
-     */
-    userId: string;
-    /**
-     * Interval in milliseconds for how often to refetch the data.
-     * Determines the polling frequency for keeping deposit data up to date.
-     */
-    refreshIntervalMs: number;
-}
 export interface MergedMultiStepDirectExecution extends DirectExecution {
     /**
      * In a multi-step DE chain, represents the latest **present** DE of the chain.
@@ -53,15 +13,45 @@ export interface MergedMultiStepDirectExecution extends DirectExecution {
 export declare function mergeMultiStepDirectExecutions(directExecutions: DirectExecution[]): MergedMultiStepDirectExecution[];
 export declare function isTokenTransferDirectExecution(de: DirectExecution): boolean;
 export declare function isWithdrawalDirectExecution(de: DirectExecution): boolean;
-type DefaultDEQueryKey = 'apiKey' | 'userId' | 'refreshIntervalMs';
-export type RecentDEQuerySimplified = Omit<RecentDirectExecutionsQuery, DefaultDEQueryKey>;
 /**
- * @returns recent direct executions tied to a recipient address used in the token transfer flow
+ * Pure transform: filters, merges multi-step chains, and sorts direct executions.
+ * Testable without React.
  */
-export declare const useRecentDeposits: ({ isVisible, memoizedFilterFunc, fetchSize, cutOffTimeMs, }: RecentDEQuerySimplified) => {
-    data: MergedMultiStepDirectExecution[] | undefined;
-    rawData: DirectExecution[] | undefined;
+export declare function processRecentDepositsForNotifications(directExecutions: DirectExecution[] | undefined, { createdAfterMs, cutOffTimeMs, variant, }?: {
+    createdAfterMs?: number;
+    cutOffTimeMs?: number;
+    variant?: NotificationVariant;
+}): MergedMultiStepDirectExecution[] | undefined;
+interface RecentDepositsApiQuery {
+    isVisible: boolean;
+    fetchSize?: number;
+    apiKey: string;
+    userId: string;
+    refreshIntervalMs: number;
+}
+type DefaultDEQueryKey = 'apiKey' | 'userId' | 'refreshIntervalMs';
+export type RecentDEQuerySimplified = {
+    isVisible: boolean;
+    fetchSize?: number;
 };
+/**
+ * @returns raw direct executions for the current user (no filtering or transforms applied)
+ */
+export declare const useRecentDeposits: ({ isVisible, fetchSize, }: RecentDEQuerySimplified) => UseQueryResult<DirectExecution[]>;
+/**
+ * Full explicit-params version of `useRecentDeposits` for use outside FunkitProvider context.
+ * Used by SDK wrappers.
+ */
+interface RecentDirectExecutionsQuery extends RecentDepositsApiQuery {
+    cutOffTimeMs?: number;
+    /**
+     * Optional filter function to further refine which deposits are returned.
+     * WARNING: Must be a stable reference (wrap in useMemo), otherwise the hook will constantly re-render.
+     * @param de - The DirectExecution to filter
+     * @returns true to include the deposit, false to exclude it
+     */
+    memoizedFilterFunc?: (de: DirectExecution) => boolean;
+}
 /**
  * Hook for SDK users to fetch recent deposits/direct executions with automatic context integration.
  *
@@ -85,7 +75,7 @@ export declare const useRecentDeposits: ({ isVisible, memoizedFilterFunc, fetchS
  * }
  * ```
  */
-export declare function useFunkitRecentDeposits(query: RecentDEQuerySimplified): {
+export declare function useFunkitRecentDeposits(query: Omit<RecentDirectExecutionsQuery, DefaultDEQueryKey>): {
     data: PurifiedCheckoutHistoryItem[] | undefined;
 };
 /**