@gluwa/connect-kit 0.1.0-next.3 → 0.2.0-next.1

package/dist/package.json

@@ -1,12 +1,14 @@
 {
   "name": "@gluwa/connect-kit",
-  "version": "0.1.0-next.3",
+  "version": "0.2.0-next.1",
   "type": "module",
   "exports": {
     ".": {
+      "types": "./src/index.ts",
       "default": "./src/index.ts"
     },
     "./credit-connect": {
+      "types": "./src/credit-connect.ts",
       "default": "./src/credit-connect.ts"
     },
     "./package.json": "./package.json"
@@ -27,7 +29,10 @@
       "./index.css": "./dist/index.css"
     }
   },
-  "sideEffects": true,
+  "sideEffects": [
+    "**/*.scss",
+    "**/*.css"
+  ],
   "scripts": {
     "prepack": "pnpm build && cp package.json dist/ && cp README.md dist/",
     "build": "tsup",
@@ -38,7 +43,9 @@
   "author": "",
   "license": "ISC",
   "dependencies": {
-    "qrcode.react": "^3.2.0"
+    "qrcode.react": "^4.2.0",
+    "wagmi": "^2.15.6",
+    "@wagmi/core": "^2.16.7"
   },
   "devDependencies": {
     "@gluwa/credit-connect-sdk": "workspace:*",
@@ -57,10 +64,8 @@
   "peerDependencies": {
     "@gluwa/credit-connect-sdk": "workspace:*",
     "@tanstack/react-query": ">=5.0.0",
-    "@wagmi/core": ">=2.0.0",
     "react": "^18.0.0 || ^19.0.0",
-    "viem": ">=2.0.0",
-    "wagmi": ">=2.0.0"
+    "viem": ">=2.0.0"
   },
   "peerDependenciesMeta": {
     "@gluwa/credit-connect-sdk": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gluwa/connect-kit",
-  "version": "0.1.0-next.3",
+  "version": "0.2.0-next.1",
   "type": "module",
   "exports": {
     ".": {
@@ -16,11 +16,16 @@
   "publishConfig": {
     "access": "public"
   },
-  "sideEffects": true,
+  "sideEffects": [
+    "**/*.scss",
+    "**/*.css"
+  ],
   "author": "",
   "license": "ISC",
   "dependencies": {
-    "qrcode.react": "^3.2.0"
+    "qrcode.react": "^4.2.0",
+    "wagmi": "^2.15.6",
+    "@wagmi/core": "^2.16.7"
   },
   "devDependencies": {
     "@tanstack/react-query": "^5.62.0",
@@ -38,10 +43,8 @@
   },
   "peerDependencies": {
     "@tanstack/react-query": ">=5.0.0",
-    "@wagmi/core": ">=2.0.0",
     "react": "^18.0.0 || ^19.0.0",
     "viem": ">=2.0.0",
-    "wagmi": ">=2.0.0",
     "@gluwa/credit-connect-sdk": "0.2.0-next.1"
   },
   "peerDependenciesMeta": {

package/src/ConnectKitProvider.tsx

@@ -9,46 +9,28 @@ import {
   type FC,
   type ReactNode,
 } from 'react';
-import { WagmiProvider, useAccount, useDisconnect } from 'wagmi';
-import type { Config } from 'wagmi';
+import { WagmiProvider, useAccount, useDisconnect, useSwitchChain } from 'wagmi';
 import { QueryClient, QueryClientProvider } from '@tanstack/react-query';
 import { ConnectModal } from './ConnectModal';
-import type { ConnectErrorContext, ConnectResult, ConnectorId, Connectors } from './types';
+import { getConfig, getKitConfig, initConfig } from './core/config';
+import type {
+  ConnectErrorContext,
+  ConnectKitConfig,
+  ConnectResult,
+  ConnectorId,
+  Connectors,
+} from './types';
 
-// wagmiConfig prop으로 기존 프로젝트 통합 시 내부에서 사용하는 QueryClient.
-// 모듈 레벨에 한 번만 생성 — 연결 플로우용으로만 쓰이므로 공유해도 무방.
 const internalQueryClient = new QueryClient();
 
 export interface ConnectKitProviderProps {
   children: ReactNode;
+  kitConfig?: ConnectKitConfig;
   connectors: Connectors;
-  wcProjectId?: string;
-  /**
-   * 연결돼 있는 동안 강제할 체인 ID. 다른 체인에 연결돼 있으면
-   * 자동으로 스위치 모달이 떠서 사용자에게 전환 또는 disconnect를 요구.
-   */
   requiredChainId?: number;
-  /**
-   * 연결이 정상적으로 끝나고(체인 검증까지 통과) "사용 가능한 상태"가 됐을 때 한 번 호출.
-   * 재연결(reconnect)에서는 호출되지 않음 — 그쪽은 dApp의 watchAccount 책임.
-   */
   onConnect?: (result: ConnectResult) => void;
   onLog?: (message: string, error?: Error) => void;
-  /**
-   * 연결 실패(거절/미설치/기타) 시 모달 안에 표시할 fallback UI를 dApp이 직접 그리고 싶을 때.
-   * 미제공 시 기본 동작은 selector로 복귀.
-   */
   renderConnectError?: (ctx: ConnectErrorContext) => ReactNode;
-  /**
-   * 기존 프로젝트 통합용. wagmi config를 넘기면 ConnectKitProvider 내부에서
-   * WagmiProvider를 직접 세운다.
-   *
-   * - 기존 프로젝트: 앱에 WagmiProvider가 없으므로 wagmiConfig를 넘긴다.
-   *   ConnectKitProvider가 같은 config 인스턴스로 WagmiProvider를 셀프 마운트하므로
-   *   기존 wagmi 상태 store와 단일 config를 공유한다.
-   * - 신규 프로젝트: 앱이 이미 WagmiProvider를 감싸므로 이 prop은 불필요하다.
-   */
-  wagmiConfig?: Config;
 }
 
 export interface ConnectKitContextValue {
@@ -74,22 +56,30 @@ const resolveConnectorId = (wagmiConnectorId: string | undefined): ConnectorId |
 };
 
 export const ConnectKitProvider: FC<ConnectKitProviderProps> = (props) => {
-  if (props.wagmiConfig) {
-    return (
-      <WagmiProvider config={props.wagmiConfig}>
-        <QueryClientProvider client={internalQueryClient}>
-          <ConnectKitProviderInner {...props} />
-        </QueryClientProvider>
-      </WagmiProvider>
-    );
-  }
-  return <ConnectKitProviderInner {...props} />;
+  const wagmiConfig = useMemo(
+    () => (props.kitConfig ? initConfig(props.kitConfig) : getConfig()),
+    [props.kitConfig],
+  );
+
+  const resolvedKitConfig = props.kitConfig ?? getKitConfig();
+
+  return (
+    <WagmiProvider config={wagmiConfig} reconnectOnMount={false}>
+      <QueryClientProvider client={internalQueryClient}>
+        <ConnectKitProviderInner {...props} kitConfig={resolvedKitConfig} />
+      </QueryClientProvider>
+    </WagmiProvider>
+  );
+};
+
+type ConnectKitProviderInnerProps = Omit<ConnectKitProviderProps, 'kitConfig'> & {
+  kitConfig: ConnectKitConfig;
 };
 
-const ConnectKitProviderInner: FC<ConnectKitProviderProps> = ({
+const ConnectKitProviderInner: FC<ConnectKitProviderInnerProps> = ({
   children,
   connectors,
-  wcProjectId,
+  kitConfig,
   requiredChainId,
   onConnect,
   onLog,
@@ -100,21 +90,62 @@ const ConnectKitProviderInner: FC<ConnectKitProviderProps> = ({
 
   const account = useAccount();
   const { disconnectAsync } = useDisconnect();
+  const { switchChainAsync } = useSwitchChain();
 
-  // dApp의 onConnect는 ref로 잡아 effect 재실행 노이즈 차단
   const onConnectRef = useRef(onConnect);
   useEffect(() => {
     onConnectRef.current = onConnect;
   }, [onConnect]);
 
-  // chain mismatch invariant: 연결돼 있지만 요구 체인이 아니면 modal force-open
   const chainMismatch =
     requiredChainId != null &&
     account.status === 'connected' &&
     account.chainId != null &&
     account.chainId !== requiredChainId;
 
-  const effectiveOpen = isOpen || chainMismatch;
+  const [autoSwitchFailedKey, setAutoSwitchFailedKey] = useState<string | null>(null);
+  const autoSwitchInFlightRef = useRef(false);
+  const isMountedRef = useRef(true);
+  useEffect(() => {
+    isMountedRef.current = true;
+    return () => {
+      isMountedRef.current = false;
+    };
+  }, []);
+
+  const mismatchKey =
+    chainMismatch && account.chainId != null && requiredChainId != null
+      ? `${account.chainId}->${requiredChainId}`
+      : null;
+
+  useEffect(() => {
+    if (!chainMismatch || requiredChainId == null) return;
+    if (autoSwitchInFlightRef.current) return;
+    if (mismatchKey != null && mismatchKey === autoSwitchFailedKey) return;
+
+    autoSwitchInFlightRef.current = true;
+    switchChainAsync({ chainId: requiredChainId })
+      .catch((err: unknown) => {
+        if (!isMountedRef.current) return;
+        const normalized = err instanceof Error ? err : new Error(String(err));
+        onLog?.(`[connect-kit] silent switch chain failed: ${normalized.message}`, normalized);
+        if (mismatchKey != null) {
+          setAutoSwitchFailedKey(mismatchKey);
+        }
+      })
+      .finally(() => {
+        autoSwitchInFlightRef.current = false;
+      });
+  }, [chainMismatch, mismatchKey, requiredChainId, autoSwitchFailedKey, switchChainAsync, onLog]);
+
+  useEffect(() => {
+    if (!chainMismatch && autoSwitchFailedKey != null) {
+      setAutoSwitchFailedKey(null);
+    }
+  }, [chainMismatch, autoSwitchFailedKey]);
+
+  const autoSwitchFailedForCurrent = mismatchKey != null && mismatchKey === autoSwitchFailedKey;
+  const effectiveOpen = isOpen || (chainMismatch && autoSwitchFailedForCurrent);
 
   const open = useCallback((): void => {
     setIsOpen(true);
@@ -128,22 +159,17 @@ const ConnectKitProviderInner: FC<ConnectKitProviderProps> = ({
     await disconnectAsync();
   }, [disconnectAsync]);
 
-  // ConnectModal → Provider: 연결 결과를 일단 보류했다가
-  // chain 검증까지 통과한 후에만 dApp으로 forward
   const handleModalConnect = useCallback((result: ConnectResult): void => {
     setPendingResult(result);
   }, []);
 
-  // pendingResult가 있고, 연결 + chain 매칭이 충족되면 dApp으로 발화
   useEffect(() => {
     if (!pendingResult) return;
     if (account.status !== 'connected') {
-      // 연결이 끊겼거나 진행 중 — pending 폐기
       setPendingResult(null);
       return;
     }
     if (requiredChainId != null && account.chainId !== requiredChainId) {
-      // chain 아직 안 맞음 — switch 후 다시 평가
       return;
     }
     onConnectRef.current?.(pendingResult);
@@ -178,7 +204,7 @@ const ConnectKitProviderInner: FC<ConnectKitProviderProps> = ({
       <ConnectModal
         open={effectiveOpen}
         connectors={connectors}
-        wcProjectId={wcProjectId}
+        wcProjectId={kitConfig.wcProjectId}
         requiredChainId={requiredChainId}
         renderConnectError={renderConnectError}
         onConnect={handleModalConnect}

package/src/ConnectModal.tsx

@@ -21,28 +21,60 @@ import { WalletConnectView } from './views/WalletConnectView';
 import { SwitchChainView } from './views/SwitchChainView';
 
 const RECENT_KEY = 'connect-kit:recent';
+const VALID_CONNECTOR_IDS: ReadonlySet<ConnectorId> = new Set<ConnectorId>([
+  'CREDIT_CONNECT',
+  'CREDIT_WALLET',
+  'METAMASK',
+  'WALLET_CONNECT',
+]);
+
 const readRecentConnector = (): ConnectorId | null => {
   try {
-    return localStorage.getItem(RECENT_KEY) as ConnectorId | null;
+    const raw = localStorage.getItem(RECENT_KEY);
+    if (raw == null) return null;
+    return VALID_CONNECTOR_IDS.has(raw as ConnectorId) ? (raw as ConnectorId) : null;
   } catch {
     return null;
   }
 };
 
-const writeRecentConnector = (id: ConnectorId): void => {
+const writeRecentConnector = (
+  id: ConnectorId,
+  onLog?: (message: string, error?: Error) => void,
+): void => {
   try {
     localStorage.setItem(RECENT_KEY, id);
-  } catch {}
+  } catch (err) {
+    const normalized = err instanceof Error ? err : new Error(String(err));
+    onLog?.(`[connect-kit] writeRecentConnector failed: ${normalized.message}`, normalized);
+  }
 };
 
+const REJECTED_ERROR_CODES = new Set<unknown>([
+  4001, // EIP-1193 user rejected
+  'ACTION_REJECTED', // ethers v6
+]);
+
 const classifyError = (error: Error): ConnectErrorReason => {
   const code =
     typeof error === 'object' && error !== null && 'code' in error
       ? (error as unknown as { code: unknown }).code
       : undefined;
-  if (code === 4001) return 'rejected';
+  if (code != null && REJECTED_ERROR_CODES.has(code)) return 'rejected';
   const message = error.message?.toLowerCase() ?? '';
-  if (message.includes('user rejected') || message.includes('user denied')) return 'rejected';
+  if (
+    message.includes('user rejected') ||
+    message.includes('user denied') ||
+    message.includes('user cancel') ||
+    message.includes('rejected by user') ||
+    message.includes('action_rejected') ||
+    message.includes('사용자가 거부') ||
+    message.includes('사용자가 취소') ||
+    message.includes('ユーザーが拒否') ||
+    message.includes('ユーザーがキャンセル')
+  ) {
+    return 'rejected';
+  }
   if (message.includes('unsupported') || message.includes('not installed')) return 'unsupported';
   return 'unknown';
 };
@@ -270,8 +302,6 @@ const resolveConnectorsFromConfig = (connectorsConfig?: Connectors): ConnectorId
 };
 
 export const ConnectModal: FC<ConnectModalProps> = (props) => {
-  // open=false면 내부 컴포넌트를 마운트하지 않음
-  // → useConfig 등 wagmi hooks가 실행되지 않아 WagmiProvider 없이도 렌더링 가능
   if (!props.open) return null;
 
   const resolvedConnectors = resolveConnectorsFromConfig(props.connectors);
@@ -312,7 +342,6 @@ const ConnectModalInner: FC<ConnectModalInnerProps> = ({
 
   const wc = useWCState();
 
-  // wagmi 상태 — chain mismatch invariant 판정용
   const account = useAccount();
   const { disconnectAsync } = useDisconnect();
   const wagmiConfig = useConfig();
@@ -328,24 +357,19 @@ const ConnectModalInner: FC<ConnectModalInnerProps> = ({
     return wagmiConfig.chains.find((chain) => chain.id === requiredChainId)?.name;
   }, [wagmiConfig.chains, requiredChainId]);
 
-  // QR URI 수신
   const handleQrUri = useCallback((uri: string | null) => {
     setQrUri(uri);
   }, []);
 
-  // 연결 완료
   const handleConnect = useCallback(
     (result: Parameters<typeof onConnect>[0]) => {
       setErrorState(null);
       onConnect(result);
-      // chain mismatch가 있으면 모달은 SwitchChainView로 자동 전환됨 (닫지 않음)
-      // Provider 측에서 requiredChainId가 매칭될 때까지 force-open 유지
       onClose();
     },
     [onConnect, onClose],
   );
 
-  // 연결 실패
   const handleError = useCallback(
     (error: unknown, connectorId: ConnectorId): void => {
       const normalizedError = error instanceof Error ? error : new Error(String(error));
@@ -364,14 +388,12 @@ const ConnectModalInner: FC<ConnectModalInnerProps> = ({
     [onLog, wc.resetView, renderConnectError],
   );
 
-  // 연결 시도
   const { triggerConnect, cancelConnect } = useWagmiConnect({
     onConnect: handleConnect,
     onError: handleError,
     onQrUri: handleQrUri,
   });
 
-  // wagmi connector icon 매핑
   const connectorLogoMap = useMemo(() => {
     const map: Partial<Record<ConnectorId, string>> = {};
     const connectorIds: ConnectorId[] = [
@@ -387,13 +409,11 @@ const ConnectModalInner: FC<ConnectModalInnerProps> = ({
     return map;
   }, [wagmiConfig.connectors]);
 
-  // 최근 연결 기록 로드
   useEffect(() => {
     setRecentConnector(readRecentConnector());
     setHasMetaMaskExtension(detectMetaMaskExtension());
   }, []);
 
-  // 모달 닫힐 때 상태 초기화
   useEffect(() => {
     if (!open) {
       setSelectedConnector(null);
@@ -404,7 +424,6 @@ const ConnectModalInner: FC<ConnectModalInnerProps> = ({
     }
   }, [open, cancelConnect, wc.reset]);
 
-  // 커넥터 선택 — 선택할 때마다 QR을 초기화해 새 세션 URI가 표시되도록 함
   const handleSelectConnector = useCallback(
     (id: ConnectorId): void => {
       if (id === selectedConnector && !errorState) return;
@@ -412,7 +431,7 @@ const ConnectModalInner: FC<ConnectModalInnerProps> = ({
       setQrUri(null);
       setErrorState(null);
       wc.resetView();
-      writeRecentConnector(id);
+      writeRecentConnector(id, onLog);
       setRecentConnector(id);
 
       if (id === 'WALLET_CONNECT' && wcProjectId) {
@@ -430,10 +449,10 @@ const ConnectModalInner: FC<ConnectModalInnerProps> = ({
       wcProjectId,
       wc.resetView,
       wc.loadWalletList,
+      onLog,
     ],
   );
 
-  // 뒤로가기
   const handleBack = useCallback((): void => {
     if (errorState) {
       setErrorState(null);
@@ -446,7 +465,6 @@ const ConnectModalInner: FC<ConnectModalInnerProps> = ({
     cancelConnect();
   }, [selectedConnector, errorState, wc.handleBack, cancelConnect]);
 
-  // chain mismatch 상태에서의 disconnect (Switch chain pane의 cancel)
   const handleSwitchChainDisconnect = useCallback((): void => {
     disconnectAsync().catch((err: unknown) => {
       const normalized = err instanceof Error ? err : new Error(String(err));
@@ -454,13 +472,11 @@ const ConnectModalInner: FC<ConnectModalInnerProps> = ({
     });
   }, [disconnectAsync, onLog]);
 
-  // overlay 클릭 — chain mismatch 상태에선 무시 (실수 클릭 방어)
   const handleOverlayClick = useCallback((): void => {
     if (chainMismatch) return;
     onClose();
   }, [chainMismatch, onClose]);
 
-  // close 버튼 — chain mismatch 상태에선 disconnect
   const handleCloseClick = useCallback((): void => {
     if (chainMismatch) {
       handleSwitchChainDisconnect();
@@ -490,8 +506,6 @@ const ConnectModalInner: FC<ConnectModalInnerProps> = ({
     return renderConnectError(ctx);
   }, [errorState, renderConnectError, triggerConnect, cancelConnect]);
 
-  // chain mismatch면 단일 pane (selector/detail 숨김)
-  // requiredChainId != null 재확인은 TS narrowing용 — chainMismatch true면 이미 보장됨
   if (chainMismatch && requiredChainId != null) {
     return (
       <div className="ck-root">

package/src/api/account.ts

@@ -0,0 +1,21 @@
+import {
+  getAccount as wagmiGetAccount,
+  signMessage as wagmiSignMessage,
+  signTypedData as wagmiSignTypedData,
+  type GetAccountReturnType,
+  type SignMessageParameters,
+  type SignTypedDataParameters,
+} from '@wagmi/core';
+import { getConfig } from '../core/config';
+
+export const getAccount = (): GetAccountReturnType => {
+  return wagmiGetAccount(getConfig());
+};
+
+export const signMessage = (params: SignMessageParameters): Promise<`0x${string}`> => {
+  return wagmiSignMessage(getConfig(), params);
+};
+
+export const signTypedData = (params: SignTypedDataParameters): Promise<`0x${string}`> => {
+  return wagmiSignTypedData(getConfig(), params);
+};

package/src/api/balance.ts

@@ -0,0 +1,10 @@
+import {
+  getBalance as wagmiGetBalance,
+  type GetBalanceParameters,
+  type GetBalanceReturnType,
+} from '@wagmi/core';
+import { getConfig } from '../core/config';
+
+export const getBalance = (params: GetBalanceParameters): Promise<GetBalanceReturnType> => {
+  return wagmiGetBalance(getConfig(), params);
+};

package/src/api/chain.ts

@@ -0,0 +1,17 @@
+import {
+  switchChain as wagmiSwitchChain,
+  getPublicClient as wagmiGetPublicClient,
+  type SwitchChainParameters,
+  type GetPublicClientParameters,
+  type GetPublicClientReturnType,
+} from '@wagmi/core';
+import type { Chain } from 'viem';
+import { getConfig } from '../core/config';
+
+export const switchChain = (params: SwitchChainParameters): Promise<Chain> => {
+  return wagmiSwitchChain(getConfig(), params);
+};
+
+export const getPublicClient = (params?: GetPublicClientParameters): GetPublicClientReturnType => {
+  return wagmiGetPublicClient(getConfig(), params);
+};

package/src/api/contract.ts

@@ -0,0 +1,33 @@
+import {
+  readContract as wagmiReadContract,
+  writeContract as wagmiWriteContract,
+  type ReadContractParameters,
+  type ReadContractReturnType,
+  type WriteContractParameters,
+  type WriteContractReturnType,
+  type Config,
+} from '@wagmi/core';
+import type { Abi, ContractFunctionArgs, ContractFunctionName } from 'viem';
+import { getConfig } from '../core/config';
+
+export function readContract<
+  const abi extends Abi | readonly unknown[],
+  functionName extends ContractFunctionName<abi, 'pure' | 'view'>,
+  args extends ContractFunctionArgs<abi, 'pure' | 'view', functionName>,
+>(
+  parameters: ReadContractParameters<abi, functionName, args, Config>,
+): Promise<ReadContractReturnType<abi, functionName, args>> {
+  return wagmiReadContract(getConfig(), parameters as any) as Promise<
+    ReadContractReturnType<abi, functionName, args>
+  >;
+}
+
+export function writeContract<
+  const abi extends Abi | readonly unknown[],
+  functionName extends ContractFunctionName<abi, 'nonpayable' | 'payable'>,
+  args extends ContractFunctionArgs<abi, 'nonpayable' | 'payable', functionName>,
+>(
+  parameters: WriteContractParameters<abi, functionName, args, Config>,
+): Promise<WriteContractReturnType> {
+  return wagmiWriteContract(getConfig(), parameters as any);
+}

package/src/api/transaction.ts

@@ -0,0 +1,12 @@
+import {
+  waitForTransactionReceipt as wagmiWaitForTransactionReceipt,
+  type WaitForTransactionReceiptParameters,
+  type WaitForTransactionReceiptReturnType,
+} from '@wagmi/core';
+import { getConfig } from '../core/config';
+
+export const waitForTransactionReceipt = (
+  params: WaitForTransactionReceiptParameters,
+): Promise<WaitForTransactionReceiptReturnType> => {
+  return wagmiWaitForTransactionReceipt(getConfig(), params);
+};

package/src/components/QRFrame.tsx

@@ -14,7 +14,7 @@ export const QRFrame: FC<QRFrameProps> = ({ qrUri, logoUrl }) => (
         size={196}
         level="H"
         imageSettings={
-          logoUrl ? { src: logoUrl, width: 40, height: 40, excavate: true } : undefined
+          logoUrl ? { src: logoUrl, width: 50, height: 50, excavate: true } : undefined
         }
       />
     ) : (
@@ -34,7 +34,7 @@ export const CopyLinkButton: FC<CopyLinkButtonProps> = ({ qrUri }) => {
       type="button"
       className="ck-copy-link"
       onClick={() => {
-        navigator.clipboard.writeText(qrUri);
+        navigator.clipboard?.writeText(qrUri).catch(() => {});
       }}
     >
       Copy link

package/src/core/config.ts

@@ -0,0 +1,83 @@
+import { createConfig, createStorage } from 'wagmi';
+import { metaMask, walletConnect, injected } from 'wagmi/connectors';
+import type { Config } from 'wagmi';
+import type { ConnectKitConfig } from '../types';
+
+type KitSlot = {
+  config: Config | null;
+  kitConfig: ConnectKitConfig | null;
+};
+
+const SLOT_KEY = Symbol.for('@gluwa/connect-kit:slot');
+
+type GlobalWithSlot = typeof globalThis & {
+  [SLOT_KEY]?: KitSlot;
+};
+
+const getSlot = (): KitSlot => {
+  const g = globalThis as GlobalWithSlot;
+  if (!g[SLOT_KEY]) {
+    g[SLOT_KEY] = { config: null, kitConfig: null };
+  }
+  return g[SLOT_KEY];
+};
+
+export const initConfig = (kitConfig: ConnectKitConfig): Config => {
+  const slot = getSlot();
+  if (slot.config) {
+    if (slot.kitConfig !== kitConfig) {
+      // eslint-disable-next-line no-console
+      console.warn(
+        '[connect-kit] initConfig called again with a different kitConfig — new chains/transports ignored. Call resetConfig() first to re-init.',
+      );
+    }
+    return slot.config;
+  }
+
+  const connectors = [];
+
+  if (kitConfig.wcProjectId) {
+    connectors.push(walletConnect({ projectId: kitConfig.wcProjectId, showQrModal: false }));
+  }
+
+  connectors.push(metaMask({ storage: { enabled: true } }), injected({ shimDisconnect: false }));
+
+  if (kitConfig.extraConnectors?.length) {
+    connectors.push(...kitConfig.extraConnectors);
+  }
+
+  const isBrowser = typeof window !== 'undefined';
+
+  slot.config = createConfig({
+    ssr: true,
+    chains: kitConfig.chains,
+    connectors,
+    transports: kitConfig.transports,
+    storage: isBrowser ? createStorage({ storage: window.localStorage }) : undefined,
+  });
+  slot.kitConfig = kitConfig;
+
+  return slot.config;
+};
+
+export const getConfig = (): Config => {
+  const slot = getSlot();
+  if (!slot.config) {
+    throw new Error('ConnectKit config not initialized. Make sure ConnectKitProvider is mounted.');
+  }
+  return slot.config;
+};
+
+export const getKitConfig = (): ConnectKitConfig => {
+  const slot = getSlot();
+  if (!slot.kitConfig) {
+    throw new Error('ConnectKit config not initialized. Make sure ConnectKitProvider is mounted.');
+  }
+  return slot.kitConfig;
+};
+
+export const resetConfig = (): void => {
+  const slot = getSlot();
+  slot.config = null;
+  slot.kitConfig = null;
+};