@funkit/connect 9.15.1 → 9.17.0

package/dist/domains/checkoutNotifications.d.ts

@@ -0,0 +1,46 @@
+import type { CheckoutHistoryItem, DirectExecution } from '@funkit/api-base';
+/**
+ * Pure, platform-agnostic logic backing the checkout-notifications feature:
+ * merging multi-step direct-execution chains, classifying deposits vs
+ * withdrawals vs token transfers, applying the recency/variant filters, and
+ * deriving which records changed relative to an initial snapshot.
+ *
+ * No React / DOM dependencies — slated to move to `@funkit/connect-core` during
+ * the React Native extraction. Extracted out of `hooks/queries/useRecentDeposits`
+ * (the polling hook) and `modals/.../CheckoutNotifications.tsx` (the view) so the
+ * same derivation runs on both platforms.
+ */
+/**
+ * Default cutoff for notification recency: direct executions / checkouts older
+ * than this window are not surfaced as notifications.
+ */
+export declare const DEFAULT_NOTIF_CUTOFF: number;
+export type NotificationVariant = 'deposit' | 'withdrawal' | 'token_transfer';
+export interface MergedMultiStepDirectExecution extends DirectExecution {
+    /**
+     * In a multi-step DE chain, represents the latest **present** DE of the chain.
+     *
+     * Always `undefined` for single-step DEs.
+     */
+    latestStep?: DirectExecution;
+}
+export declare function mergeMultiStepDirectExecutions(directExecutions: DirectExecution[]): MergedMultiStepDirectExecution[];
+export declare function isTokenTransferDirectExecution(de: DirectExecution): boolean;
+export declare function isWithdrawalDirectExecution(de: DirectExecution): boolean;
+/**
+ * Pure transform: filters, merges multi-step chains, and sorts direct executions.
+ * Testable without React.
+ */
+export declare function processRecentDepositsForNotifications(directExecutions: DirectExecution[] | undefined, { createdAfterMs, cutOffTimeMs, variant, }?: {
+    createdAfterMs?: number;
+    cutOffTimeMs?: number;
+    variant?: NotificationVariant;
+}): MergedMultiStepDirectExecution[] | undefined;
+/**
+ * @returns checkouts that are either not present in the initial checkouts or the data changed somehow
+ */
+export declare const getUpdatedCheckouts: (checkouts: CheckoutHistoryItem[], initialCheckouts?: CheckoutHistoryItem[]) => CheckoutHistoryItem[];
+/**
+ * @returns direct executions that are either not present in the initial set or whose data changed
+ */
+export declare const getUpdatedDirectExecutions: (directExecutions: MergedMultiStepDirectExecution[], initialDirectExecutions?: DirectExecution[]) => MergedMultiStepDirectExecution[];

package/dist/domains/meld.d.ts

@@ -12,5 +12,3 @@ export declare function autoPickBestQuote(quotes: MeldQuote[]): MeldQuote | unde
  * @returns true if the quote is the best price quote, false otherwise
  */
 export declare function isBestPriceQuote(sourceQuotes: MeldQuote[] | undefined, targetQuote: MeldQuote | undefined): boolean;
-export declare function createMoonpayMeldQuote(quote: MeldQuote): MeldQuote;
-export declare function withMoonpayMeldQuote(quotes: MeldQuote[] | undefined): MeldQuote[] | undefined;

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

@@ -0,0 +1,21 @@
+import { type LightningQuoteResponse } from '@funkit/api-base';
+import { type Address } from 'viem';
+import type { GeneralWalletContextProps } from '../../providers/GeneralWalletProvider';
+export declare function usdToSats(usd: number | undefined, btcPrice: number | undefined): bigint | undefined;
+type UseLightningQuoteParams = {
+    depositAddr: Address | undefined;
+    walletAddress: GeneralWalletContextProps['walletAddress'];
+    targetChain: string | undefined;
+    targetAsset: Address | undefined;
+    fiatAmount: number | undefined;
+};
+/**
+ * Holds the displayed invoice until its real `expiresAtMs`, then reveals the
+ * prefetched replacement. `useLightningQuote` prefetches the next invoice early,
+ * so revealing it on arrival would reset the QR/timer while the current invoice
+ * is still valid.
+ *
+ */
+export declare function useDeferredQuote(latestQuote: LightningQuoteResponse | undefined): LightningQuoteResponse | undefined;
+export declare const useLightningQuote: ({ depositAddr, walletAddress, targetChain, targetAsset, fiatAmount, }: UseLightningQuoteParams) => import("@tanstack/react-query").UseQueryResult<LightningQuoteResponse, Error>;
+export {};

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

@@ -1,6 +1,5 @@
 import { type CheckoutHistoryItem } from '@funkit/api-base';
 import { PaymentMethod } from '../../domains/paymentMethods';
-export declare const DEFAULT_NOTIF_CUTOFF: number;
 interface RecentCheckoutsQuery {
     isVisible: boolean;
     paymentMethod?: PaymentMethod;

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

@@ -1,27 +1,6 @@
 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';
-export interface MergedMultiStepDirectExecution extends DirectExecution {
-    /**
-     * In a multi-step DE chain, represents the latest **present** DE of the chain.
-     *
-     * Always `undefined` for single-step DEs.
-     */
-    latestStep?: DirectExecution;
-}
-export declare function mergeMultiStepDirectExecutions(directExecutions: DirectExecution[]): MergedMultiStepDirectExecution[];
-export declare function isTokenTransferDirectExecution(de: DirectExecution): boolean;
-export declare function isWithdrawalDirectExecution(de: DirectExecution): boolean;
-/**
- * Pure transform: filters, merges multi-step chains, and sorts direct executions.
- * Testable without React.
- */
-export declare function processRecentDepositsForNotifications(directExecutions: DirectExecution[] | undefined, { createdAfterMs, cutOffTimeMs, variant, }?: {
-    createdAfterMs?: number;
-    cutOffTimeMs?: number;
-    variant?: NotificationVariant;
-}): MergedMultiStepDirectExecution[] | undefined;
 interface RecentDepositsApiQuery {
     isVisible: boolean;
     fetchSize?: number;

package/dist/hooks/track/CheckoutModalEvent.d.ts

@@ -7,6 +7,7 @@ export declare enum CheckoutModalEvent {
     NAVIGATE_CONFIRMATION = "fc::navigate::confirmation",
     NAVIGATE_CHECKOUT_COMPLETE = "fc::navigate::checkout_complete",
     NAVIGATE_TRANSFER_TOKEN = "fc::navigate::transfer_token",
+    NAVIGATE_LIGHTNING_INVOICE = "fc::navigate::lightning_invoice",
     NAVIGATE_INPUT_AMOUNT = "fc::navigate::input_amount",
     NAVIGATE_ERROR_SCREEN = "fc::navigate::error_screen",
     NAVIGATE_FIAT_ACCOUNT_DETAIL = "fc::navigate::fiat_account_detail",
@@ -72,5 +73,8 @@ export declare enum CheckoutModalEvent {
     DEPOSIT_TRANSFER_NOTIFICATION_EXPANDED = "fc::deposit::transfer::notification::expanded",
     DEPOSIT_TRANSFER_NOTIFICATION_HIDDEN = "fc::deposit::transfer::notification::hidden",
     COMPLIANCE_REVIEW_BANNER_SHOWN = "fc::compliance_review::banner_shown",
-    COMPLIANCE_REVIEW_GET_HELP_CLICKED = "fc::compliance_review::get_help_clicked"
+    COMPLIANCE_REVIEW_GET_HELP_CLICKED = "fc::compliance_review::get_help_clicked",
+    ADD_TOKEN_TO_WALLET_REQUESTED = "fc::add_token_to_wallet::requested",
+    ADD_TOKEN_TO_WALLET_ADDED = "fc::add_token_to_wallet::added",
+    ADD_TOKEN_TO_WALLET_FAILED = "fc::add_token_to_wallet::failed"
 }

package/dist/hooks/useAssetPrice.d.ts

@@ -1,9 +1,15 @@
-import { type Erc20AssetInfo } from '@funkit/api-base';
+import { type Erc20AssetInfo, type GetAssetPriceInfoResponse } from '@funkit/api-base';
 import type { Address } from 'viem';
+export declare function getAssetPriceInfoWithFallback({ apiKey, chainId, assetTokenAddress, }: {
+    apiKey: string;
+    chainId: string;
+    assetTokenAddress: Address;
+}): Promise<GetAssetPriceInfoResponse>;
 interface UseAssetAddressPriceParams {
     chainId: string | undefined;
     assetTokenAddress: Address | undefined;
-    refetchInterval?: number;
+    /** Pass `false` to fetch once and disable interval polling. */
+    refetchInterval?: number | false;
     /** defaults to 1 hence price returned is unit price */
     amount?: number;
     /** Asset symbol — when provided and the symbol is a stablecoin, price is hardcoded to 1 */
@@ -21,7 +27,7 @@ export declare function useAssetAddressPrice({ chainId, assetTokenAddress, amoun
 type AssetSymbolPriceParams = {
     chainId: string | undefined;
     symbol: string | undefined;
-    refetchInterval?: number;
+    refetchInterval?: number | false;
     /** Disable the query without changing other inputs. Defaults to true. */
     enabled?: boolean;
 };

package/dist/hooks/useCheckoutDirectExecutionHistory.d.ts

@@ -1,5 +1,5 @@
 import { CheckoutRefundState, CheckoutState, type DirectExecution, RelayExecutionStatus } from '@funkit/api-base';
-import type { MergedMultiStepDirectExecution } from './queries/useRecentDeposits';
+import type { MergedMultiStepDirectExecution } from '../domains/checkoutNotifications';
 export declare function mapRelayExecutionStatusToCheckoutState(status: RelayExecutionStatus): CheckoutState;
 export declare function mapRelayExecutionStatusToRefundState(status: RelayExecutionStatus): CheckoutRefundState | undefined;
 export declare function useCheckoutDirectExecutionHistory({ initDirectExecution, disabled, }: {

package/dist/hooks/useIsCheckoutComplete.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Returns `true` when the checkout for `depositAddress` has reached the
+ * `COMPLETED` terminal state. Returns `false` while pending / failed /
+ * not-yet-loaded / no address.
+ *
+ * Composes the same hooks the post-checkout detail components use, so the
+ * direct-execution path gets its real polling-driven status (the merged
+ * list's `state` is hardcoded to `COMPLETED` for DEs — unreliable).
+ *
+ * `depositAddress` is either a deposit address (bridged checkouts) or a tx
+ * hash (direct executions); the underlying hooks pick the right branch.
+ */
+export declare function useIsCheckoutComplete(depositAddress: string | undefined): boolean;