@funkit/connect 9.23.1 → 9.24.0-next.0

package/dist/interfaces/logTransport.d.ts

@@ -0,0 +1,51 @@
+/** Severity levels emitted by `FunLogger`. */
+export type LogLevel = 'info' | 'debug' | 'warn' | 'error';
+/** User tracking consent, mirroring the Datadog browser SDK's values. */
+export type TrackingConsent = 'granted' | 'not-granted';
+/**
+ * The structured context `FunLogger` assembles for every record: the caller's
+ * data plus the logger's resolved user/session fields. Concrete (rather than
+ * `object`) so transport implementors get property access and autocomplete.
+ */
+export interface LogContext {
+    /** Caller-supplied structured data for this log line, if any. */
+    data?: object;
+    apiKey: string | null;
+    userId: string | null;
+    userName: string | null;
+    userAddress: string | null;
+    userLoginType: string | null;
+    typeLabel: string | null;
+    sdkVersion: string | null;
+}
+/** A single fully-assembled log record handed to a transport. */
+export interface LogRecord {
+    level: LogLevel;
+    title: string;
+    /** Assembled by `FunLogger` so transports stay dumb sinks. */
+    context: LogContext;
+    /** Present only for `error`-level records. */
+    error?: Error;
+}
+/**
+ * Platform sink for `FunLogger`. The logger (queueing, env detection, level
+ * routing, console fallback, context tracking) is platform-agnostic; everything
+ * platform-specific about *emitting* lives behind this interface.
+ *
+ * Part of the React Native split (see docs/connect-rn-architecture.md): web
+ * implements it with `DatadogBrowserLogsTransport`, React Native will implement
+ * it with a Datadog React Native transport (`@datadog/mobile-react-native`).
+ * Kept free of DOM/`@datadog/browser-logs` types so it can move to
+ * `@funkit/connect-core` untouched.
+ */
+export interface LogTransport {
+    /** Emit one record to the platform sink. */
+    log(record: LogRecord): void;
+    /**
+     * Reflect the resolved environment (e.g. `'development'` | `'production'`).
+     * Optional — sinks that don't segment by environment can omit it.
+     */
+    setEnv?(environment: string): void;
+    /** Reflect user tracking consent. Optional. */
+    setTrackingConsent?(consent: TrackingConsent): void;
+}

package/dist/interfaces/swapped-transport.d.ts

@@ -0,0 +1,78 @@
+import type { PaymentGroupType } from '@funkit/api-base';
+import type { SwappedTheme } from '../utils/swapped';
+/**
+ * Typed contract for the message bridge between the SDK and the embedded
+ * Swapped flow. On web this is bridged over an `<iframe>` + `window.postMessage`
+ * (see {@link createIframeSwappedTransport}); React Native will bridge the same
+ * messages over a `WebView`. Freezing the event catalog here lets both
+ * platforms share the `SwappedProvider` state machine and turns any drift in
+ * the message shapes into a compile-time error.
+ *
+ * Reference: the inbound switch in `SwappedIframeController` and the sends in
+ * `SwappedProvider`.
+ *
+ * This module is platform-agnostic and is slated to move to
+ * `@funkit/connect-core/interfaces/` during the RN extraction.
+ */
+/**
+ * Navigation steps reported by the Swapped embed. Open-ended — the embed may
+ * emit steps we don't enumerate, which fall through to the default handler.
+ */
+export type SwappedStep = 'EMPTY' | 'KYC_ADDRESS' | 'KYC_AWAITING_IDENTITY' | 'KYC_IDENTITY' | 'KYC_PERSONAL' | 'KYC_SUMSUB' | 'LOGIN_EMAIL' | 'LOGIN_EMAIL_VERIFICATION' | 'PAYMENT' | 'ORDER_CONFIRMATION' | (string & {});
+/**
+ * Opaque payloads — the SDK never introspects these, it only forwards them to
+ * analytics via `JSON.stringify`. Typed as `unknown` so callers must stringify
+ * rather than read fields.
+ */
+export type SwappedErrorPayload = unknown;
+export type SwappedTxPayload = unknown;
+/** embed → parent */
+export type SwappedInboundMessage = {
+    type: 'SWAPPED_READY';
+} | {
+    type: 'SWAPPED_GO_BACK';
+} | {
+    type: 'SWAPPED_CLOSE';
+} | {
+    type: 'SWAPPED_NEW_DEPOSIT';
+} | {
+    type: 'SWAPPED_ERROR';
+    data?: SwappedErrorPayload;
+} | {
+    type: 'SWAPPED_NAVIGATION';
+    data?: {
+        step?: SwappedStep;
+    };
+} | {
+    type: 'SWAPPED_ORDER_DATA';
+    data?: unknown;
+} | {
+    type: 'SWAPPED_TRANSACTION_SUCCESSFUL';
+    data?: SwappedTxPayload;
+} | {
+    type: 'SWAPPED_LOGOUT';
+};
+/** parent → embed */
+export type SwappedOutboundMessage = {
+    type: 'SWAPPED_METHOD';
+    method: PaymentGroupType;
+} | {
+    type: 'SWAPPED_THEME';
+    data: SwappedTheme;
+} | {
+    type: 'SWAPPED_FOCUS';
+};
+export interface SwappedTransport {
+    /**
+     * Send a message to the embed. Returns `true` if the message was dispatched,
+     * `false` if the embed isn't reachable yet (so callers can mirror today's
+     * behavior of logging only on a successful send).
+     */
+    send(msg: SwappedOutboundMessage): boolean;
+    /**
+     * Subscribe to messages from the embed. The handler is only invoked for
+     * messages whose origin has already been validated by the transport. Returns
+     * an unsubscribe function.
+     */
+    onMessage(handler: (msg: SwappedInboundMessage) => void): () => void;
+}

package/dist/modals/CheckoutModal/SourceChange/EmptyFormOfPaymentsMessage.d.ts

@@ -0,0 +1,4 @@
+import React from 'react';
+export declare function EmptyFormOfPaymentsMessage({ minHeight, }: {
+    minHeight: number;
+}): React.JSX.Element;

package/dist/modals/CheckoutModal/SourceChange/useUpdateSourceAssetForCard.d.ts

@@ -0,0 +1,4 @@
+export declare function useUpdateCardSourceAsset(): {
+    onSelectCard: () => Promise<void>;
+    isUpdating: boolean;
+};

package/dist/modals/CheckoutModal/SwappedIframe/SwappedErrorMessage.d.ts

@@ -0,0 +1,6 @@
+import React from 'react';
+import { type BoxProps } from '../../../components/Box/Box';
+export declare function SwappedErrorMessage({ minHeight, paddingBottom, }: {
+    minHeight: number;
+    paddingBottom?: BoxProps['paddingBottom'];
+}): React.JSX.Element;

package/dist/providers/FunkitCheckoutContext/types.d.ts

@@ -203,6 +203,22 @@ export interface WithdrawalConfigBase {
      * stays live without triggering unnecessary re-renders.
      */
     withdrawalSourceTokenBalance?: () => string | number;
+    /**
+     * Optional async hook fired the moment the user commits to the withdrawal —
+     * after they tap the withdraw CTA but **before** the SDK fetches any nonce,
+     * prompts the wallet to sign, or submits the transaction. It is awaited, so
+     * async work completes before signing begins.
+     *
+     * The motivating case is venues where automated activity shares the signing
+     * account: cancelling in-flight strategies here guarantees the withdrawal's
+     * signing nonce is still valid by the time the wallet prompt fires.
+     *
+     * Throw to abort the withdrawal — the thrown error message is surfaced to the
+     * user verbatim in the standard error UI, and no nonce is consumed. Runs on
+     * every withdrawal method and before
+     * {@link WalletWithdrawalConfig['preWithdrawalAction']}.
+     */
+    onBeforeSign?: () => Promise<void> | void;
 }
 export interface WalletWithdrawalConfig extends WithdrawalConfigBase {
     /** Wallet instance used to execute the quote */

package/dist/utils/flags/resolver.d.ts

@@ -0,0 +1,34 @@
+type BaseCondition = {
+    type: 'country';
+    countryCodes: string[];
+};
+type Condition = BaseCondition | {
+    type: 'all';
+    conditions: Condition[];
+} | {
+    type: 'any';
+    conditions: Condition[];
+};
+interface Variant<T> {
+    condition?: Condition;
+    value: T;
+}
+interface VariantConfig<T> {
+    variants: Variant<T>[];
+    value: T;
+}
+interface EvaluationContext {
+    countryCode?: string;
+}
+/**
+ * Type guard to check if a value is a VariantConfig
+ * (used to distinguish from simple static configs)
+ */
+export declare function isVariantConfig<T>(value: unknown): value is VariantConfig<T>;
+/**
+ * Resolves the appropriate value from a VariantConfig based on runtime context.
+ * Evaluates variants in order and returns the first matching variant's value.
+ * Falls back to default value if no variants match.
+ */
+export declare function resolveValue<T>(config: VariantConfig<T>, ctx: EvaluationContext): T;
+export {};

package/dist/wallets/walletConnectors/bifrostWallet/bifrostWallet.js

@@ -1,9 +1,9 @@
 "use client";
 import {
   bifrostWallet
-} from "../chunk-IULPZP2Q.js";
-import "../chunk-N4IJLYFY.js";
+} from "../chunk-4T6ZSRJF.js";
 import "../chunk-OLZ7626J.js";
+import "../chunk-N4IJLYFY.js";
 import "../chunk-IGKXZBTA.js";
 export {
   bifrostWallet

package/dist/wallets/walletConnectors/bitgetWallet/bitgetWallet.js

@@ -1,9 +1,9 @@
 "use client";
 import {
   bitgetWallet
-} from "../chunk-TKB2OY6G.js";
-import "../chunk-N4IJLYFY.js";
+} from "../chunk-CPI4TD43.js";
 import "../chunk-OLZ7626J.js";
+import "../chunk-N4IJLYFY.js";
 import "../chunk-IGKXZBTA.js";
 export {
   bitgetWallet

package/dist/wallets/walletConnectors/bybitWallet/bybitWallet.js

@@ -1,9 +1,9 @@
 "use client";
 import {
   bybitWallet
-} from "../chunk-OX37G4YT.js";
-import "../chunk-N4IJLYFY.js";
+} from "../chunk-F5XEEVG6.js";
 import "../chunk-OLZ7626J.js";
+import "../chunk-N4IJLYFY.js";
 import "../chunk-IGKXZBTA.js";
 export {
   bybitWallet

package/dist/wallets/walletConnectors/chunk-2VP2F6EK.js

@@ -0,0 +1,70 @@
+"use client";
+import {
+  getInjectedConnector,
+  hasInjectedProvider
+} from "./chunk-OLZ7626J.js";
+import {
+  getWalletConnectConnector
+} from "./chunk-N4IJLYFY.js";
+
+// src/wallets/walletConnectors/rainbowWallet/rainbowWallet.ts
+import { isAndroid, isIOS } from "@funkit/utils";
+var rainbowWallet = ({
+  projectId,
+  walletConnectParameters
+}) => {
+  const isRainbowInjected = hasInjectedProvider({ flag: "isRainbow" });
+  const shouldUseWalletConnect = !isRainbowInjected;
+  const getUri = (uri) => {
+    return isAndroid() ? uri : isIOS() ? `rainbow://wc?uri=${encodeURIComponent(uri)}&connector=rainbowkit` : `https://rnbwapp.com/wc?uri=${encodeURIComponent(
+      uri
+    )}&connector=rainbowkit`;
+  };
+  return {
+    id: "rainbow",
+    name: "Rainbow",
+    rdns: "me.rainbow",
+    iconUrl: async () => (await import("./rainbowWallet-MFJQCICF.js")).default,
+    iconBackground: "#0c2f78",
+    installed: !shouldUseWalletConnect ? isRainbowInjected : void 0,
+    downloadUrls: {
+      android: "https://play.google.com/store/apps/details?id=me.rainbow&referrer=utm_source%3Drainbowkit&utm_source=rainbowkit",
+      ios: "https://apps.apple.com/app/apple-store/id1457119021?pt=119997837&ct=rainbowkit&mt=8",
+      mobile: "https://rainbow.download?utm_source=rainbowkit",
+      qrCode: "https://rainbow.download?utm_source=rainbowkit&utm_medium=qrcode",
+      browserExtension: "https://rainbow.me/extension?utm_source=rainbowkit"
+    },
+    mobile: { getUri: shouldUseWalletConnect ? getUri : void 0 },
+    qrCode: shouldUseWalletConnect ? {
+      getUri,
+      instructions: {
+        learnMoreUrl: "https://learn.rainbow.me/connect-to-a-website-or-app?utm_source=rainbowkit&utm_medium=connector&utm_campaign=learnmore",
+        steps: [
+          {
+            description: "wallet_connectors.rainbow.qr_code.step1.description",
+            step: "install",
+            title: "wallet_connectors.rainbow.qr_code.step1.title"
+          },
+          {
+            description: "wallet_connectors.rainbow.qr_code.step2.description",
+            step: "create",
+            title: "wallet_connectors.rainbow.qr_code.step2.title"
+          },
+          {
+            description: "wallet_connectors.rainbow.qr_code.step3.description",
+            step: "scan",
+            title: "wallet_connectors.rainbow.qr_code.step3.title"
+          }
+        ]
+      }
+    } : void 0,
+    createConnector: shouldUseWalletConnect ? getWalletConnectConnector({
+      projectId,
+      walletConnectParameters
+    }) : getInjectedConnector({ flag: "isRainbow" })
+  };
+};
+
+export {
+  rainbowWallet
+};

package/dist/wallets/walletConnectors/chunk-4T6ZSRJF.js

@@ -0,0 +1,69 @@
+"use client";
+import {
+  getInjectedConnector,
+  hasInjectedProvider
+} from "./chunk-OLZ7626J.js";
+import {
+  getWalletConnectConnector
+} from "./chunk-N4IJLYFY.js";
+
+// src/wallets/walletConnectors/bifrostWallet/bifrostWallet.ts
+import { isAndroid } from "@funkit/utils";
+var bifrostWallet = ({
+  projectId,
+  walletConnectParameters
+}) => {
+  const isBifrostInjected = hasInjectedProvider({ flag: "isBifrost" });
+  const shouldUseWalletConnect = !isBifrostInjected;
+  const getUri = (uri) => {
+    return isAndroid() ? uri : `https://app.bifrostwallet.com/wc?uri=${encodeURIComponent(uri)}`;
+  };
+  return {
+    id: "bifrostWallet",
+    name: "Bifrost Wallet",
+    iconUrl: async () => (await import("./bifrostWallet-5NQVDZ5P.js")).default,
+    iconBackground: "#fff",
+    installed: !shouldUseWalletConnect ? isBifrostInjected : void 0,
+    downloadUrls: {
+      android: "https://play.google.com/store/apps/details?id=com.bifrostwallet.app",
+      ios: "https://apps.apple.com/us/app/bifrost-wallet/id1577198351",
+      qrCode: "https://bifrostwallet.com/#download-app"
+    },
+    mobile: {
+      getUri: shouldUseWalletConnect ? getUri : void 0
+    },
+    qrCode: shouldUseWalletConnect ? {
+      getUri: (uri) => uri,
+      instructions: {
+        learnMoreUrl: "https://support.bifrostwallet.com/en/articles/6886814-how-to-use-walletconnect",
+        steps: [
+          {
+            description: "wallet_connectors.bifrost.qr_code.step1.description",
+            step: "install",
+            title: "wallet_connectors.bifrost.qr_code.step1.title"
+          },
+          {
+            description: "wallet_connectors.bifrost.qr_code.step2.description",
+            step: "create",
+            title: "wallet_connectors.bifrost.qr_code.step2.title"
+          },
+          {
+            description: "wallet_connectors.bifrost.qr_code.step3.description",
+            step: "scan",
+            title: "wallet_connectors.bifrost.qr_code.step3.title"
+          }
+        ]
+      }
+    } : void 0,
+    createConnector: shouldUseWalletConnect ? getWalletConnectConnector({
+      projectId,
+      walletConnectParameters
+    }) : getInjectedConnector({
+      flag: "isBifrost"
+    })
+  };
+};
+
+export {
+  bifrostWallet
+};

package/dist/wallets/walletConnectors/chunk-6BW3HLBG.js

@@ -0,0 +1,96 @@
+"use client";
+import {
+  getInjectedConnector,
+  hasInjectedProvider
+} from "./chunk-OLZ7626J.js";
+import {
+  getWalletConnectConnector
+} from "./chunk-N4IJLYFY.js";
+
+// src/wallets/walletConnectors/coin98Wallet/coin98Wallet.ts
+var coin98Wallet = ({
+  projectId,
+  walletConnectParameters
+}) => {
+  const isCoin98WalletInjected = hasInjectedProvider({
+    namespace: "coin98.provider",
+    flag: "isCoin98"
+  });
+  const shouldUseWalletConnect = !isCoin98WalletInjected;
+  return {
+    id: "coin98",
+    name: "Coin98 Wallet",
+    iconUrl: async () => (await import("./coin98Wallet-I5CP5KYZ.js")).default,
+    installed: isCoin98WalletInjected,
+    iconAccent: "#CDA349",
+    iconBackground: "#fff",
+    rdns: "coin98.com",
+    downloadUrls: {
+      android: "https://play.google.com/store/apps/details?id=coin98.crypto.finance.media",
+      ios: "https://apps.apple.com/vn/app/coin98-super-app/id1561969966",
+      mobile: "https://coin98.com/wallet",
+      qrCode: "https://coin98.com/wallet",
+      chrome: "https://chrome.google.com/webstore/detail/coin98-wallet/aeachknmefphepccionboohckonoeemg",
+      browserExtension: "https://coin98.com/wallet"
+    },
+    mobile: {
+      getUri: shouldUseWalletConnect ? (uri) => uri : void 0
+    },
+    qrCode: shouldUseWalletConnect ? {
+      getUri: (uri) => uri,
+      instructions: {
+        learnMoreUrl: "https://coin98.com/wallet",
+        steps: [
+          {
+            description: "wallet_connectors.coin98.qr_code.step1.description",
+            step: "install",
+            title: "wallet_connectors.coin98.qr_code.step1.title"
+          },
+          {
+            description: "wallet_connectors.coin98.qr_code.step2.description",
+            step: "create",
+            title: "wallet_connectors.coin98.qr_code.step2.title"
+          },
+          {
+            description: "wallet_connectors.coin98.qr_code.step3.description",
+            step: "scan",
+            title: "wallet_connectors.coin98.qr_code.step3.title"
+          }
+        ]
+      }
+    } : void 0,
+    extension: {
+      instructions: {
+        learnMoreUrl: "https://coin98.com/wallet",
+        steps: [
+          {
+            description: "wallet_connectors.coin98.extension.step1.description",
+            step: "install",
+            title: "wallet_connectors.coin98.extension.step1.title"
+          },
+          {
+            description: "wallet_connectors.coin98.extension.step2.description",
+            step: "create",
+            title: "wallet_connectors.coin98.extension.step2.title"
+          },
+          {
+            description: "wallet_connectors.coin98.extension.step3.description",
+            step: "refresh",
+            title: "wallet_connectors.coin98.extension.step3.title"
+          }
+        ]
+      }
+    },
+    createConnector: shouldUseWalletConnect ? getWalletConnectConnector({
+      projectId,
+      walletConnectParameters
+    }) : getInjectedConnector({
+      namespace: "coin98Wallet",
+      flag: "isCoin98"
+    })
+  };
+};
+
+export {
+  coin98Wallet
+};