@gluwa/connect-kit 0.1.0-next.0 → 0.1.0-next.2

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @gluwa/wallet-kit
 
+## 0.1.0-next.2
+
+### Patch Changes
+
+- d44580e: add provider
+
+## 0.1.0-next.1
+
+### Patch Changes
+
+- f4de564: refactor
+
 ## 0.1.0-next.0
 
 ### Minor Changes

package/dist/index.d.ts

@@ -1,11 +1,16 @@
-import { FC } from 'react';
+import { ReactNode, FC } from 'react';
 import { createConnector } from '@wagmi/core';
 import { StorageProvider } from '@gluwa/credit-connect-sdk/storage';
 import { E2EEProvider } from '@gluwa/credit-connect-sdk/e2ee';
 import { HubFactoryProvider } from '@gluwa/credit-connect-sdk/hub';
 
 type ConnectorId = 'CREDIT_WALLET' | 'CREDIT_CONNECT' | 'METAMASK' | 'WALLET_CONNECT';
-type ValidConnectors = Array<Exclude<ConnectorId, 'WALLET_CONNECT'>> | Array<Exclude<ConnectorId, 'CREDIT_WALLET'>>;
+type CreditWalletStrategy = 'walletConnect' | 'creditConnect';
+interface Connectors {
+    creditWallet?: CreditWalletStrategy | false;
+    metamask?: boolean;
+    walletConnect?: boolean;
+}
 interface WCWallet {
     id: string;
     name: string;
@@ -23,17 +28,60 @@ interface ConnectResult {
     address: `0x${string}`;
     connectorId: ConnectorId;
 }
+type ConnectErrorReason = 'rejected' | 'unsupported' | 'unknown';
+interface ConnectErrorContext {
+    connectorId: ConnectorId;
+    reason: ConnectErrorReason;
+    error: Error;
+    retry: () => void;
+    dismiss: () => void;
+}
 interface ConnectModalProps {
     open: boolean;
-    connectors: ValidConnectors;
+    connectors: Connectors;
     onConnect: (result: ConnectResult) => void;
     onClose: () => void;
     onLog?: (message: string, error?: Error) => void;
     wcProjectId?: string;
+    requiredChainId?: number;
+    renderConnectError?: (ctx: ConnectErrorContext) => ReactNode;
 }
 
 declare const ConnectModal: FC<ConnectModalProps>;
 
+interface ConnectKitProviderProps {
+    children: ReactNode;
+    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;
+}
+interface ConnectKitContextValue {
+    isOpen: boolean;
+    open: () => void;
+    close: () => void;
+    isConnected: boolean;
+    address: `0x${string}` | undefined;
+    connectorId: ConnectorId | null;
+    disconnect: () => Promise<void>;
+}
+declare const ConnectKitProvider: FC<ConnectKitProviderProps>;
+declare const useConnectKit: () => ConnectKitContextValue;
+
 type CreditConnectConnectorOptions = {
     projectKey: string;
     serverUrl: string;
@@ -44,4 +92,4 @@ type CreditConnectConnectorOptions = {
 };
 declare const creditConnectConnector: (options: CreditConnectConnectorOptions) => ReturnType<typeof createConnector>;
 
-export { ConnectModal, type ConnectModalProps, type ConnectResult, type ConnectorId, type CreditConnectConnectorOptions, type WCSubView, type WCWallet, creditConnectConnector };
+export { type ConnectErrorContext, type ConnectErrorReason, type ConnectKitContextValue, ConnectKitProvider, type ConnectKitProviderProps, ConnectModal, type ConnectModalProps, type ConnectResult, type ConnectorId, type Connectors, type CreditConnectConnectorOptions, type CreditWalletStrategy, type WCSubView, type WCWallet, creditConnectConnector, useConnectKit };