@compose-market/theme 0.0.2 → 0.0.3

package/dist/hooks/use-chat.js

@@ -0,0 +1,350 @@
+/**
+ * Unified Chat Hook
+ *
+ * Consolidates:
+ * - Chat state management (messages, streaming, scroll)
+ * - File attachment handling (upload to Pinata)
+ * - Audio recording (MediaRecorder + Pinata upload)
+ *
+ * Provides O(1) message updates, RAF-batched streaming, and stick-to-bottom scroll.
+ */
+import { useState, useRef, useCallback, useEffect } from "react";
+import { uploadConversationFile, fileToDataUrl, cleanupConversationFiles } from "@/lib/pinata";
+export function useChat(options = {}) {
+    const { conversationId: providedId, onError, rafBatching = true, maxFiles = 1, } = options;
+    // Stable conversationId - capture on first render only
+    const conversationIdRef = useRef(providedId ?? `conv-${Date.now()}`);
+    // === Message State ===
+    const [messages, setMessages] = useState([]);
+    // === File Attachment State ===
+    const [attachedFiles, setAttachedFiles] = useState([]);
+    const [uploadedCids, setUploadedCids] = useState([]);
+    const fileInputRef = useRef(null);
+    // === Recording State ===
+    const [isRecording, setIsRecording] = useState(false);
+    const [recordingSupported, setRecordingSupported] = useState(true);
+    const mediaRecorderRef = useRef(null);
+    const audioChunksRef = useRef([]);
+    const mediaStreamRef = useRef(null);
+    // === RAF Batching Refs ===
+    const streamedTextRef = useRef("");
+    const rafRef = useRef(null);
+    const currentAssistantIdRef = useRef(null);
+    // === Scroll Refs ===
+    const scrollContainerRef = useRef(null);
+    const messagesEndRef = useRef(null);
+    // Check if recording is supported on mount
+    useEffect(() => {
+        if (!navigator.mediaDevices?.getUserMedia) {
+            setRecordingSupported(false);
+        }
+    }, []);
+    // ==========================================================================
+    // Message Functions
+    // ==========================================================================
+    const addUserMessage = useCallback((content, msgOptions) => {
+        const id = crypto.randomUUID();
+        const message = {
+            id,
+            role: "user",
+            content,
+            timestamp: Date.now(),
+            type: msgOptions?.type || "text",
+            imageUrl: msgOptions?.imageUrl,
+            audioUrl: msgOptions?.audioUrl,
+        };
+        setMessages(prev => [...prev, message]);
+        return id;
+    }, []);
+    const createAssistantPlaceholder = useCallback((type) => {
+        const id = crypto.randomUUID();
+        currentAssistantIdRef.current = id;
+        streamedTextRef.current = "";
+        setMessages(prev => [...prev, {
+                id,
+                role: "assistant",
+                content: "",
+                timestamp: Date.now(),
+                type: type || "text",
+            }]);
+        return id;
+    }, []);
+    const updateAssistantMessage = useCallback((id, update) => {
+        setMessages(prev => {
+            const next = [...prev];
+            const last = next[next.length - 1];
+            // Fast path: updating last message
+            if (last?.id === id) {
+                next[next.length - 1] = { ...last, ...update };
+                return next;
+            }
+            // Fallback: find by ID
+            const idx = next.findIndex(m => m.id === id);
+            if (idx >= 0) {
+                next[idx] = { ...next[idx], ...update };
+            }
+            return next;
+        });
+    }, []);
+    const clearMessages = useCallback(() => {
+        setMessages([]);
+        streamedTextRef.current = "";
+        currentAssistantIdRef.current = null;
+    }, []);
+    // ==========================================================================
+    // Streaming Functions
+    // ==========================================================================
+    const flushStreamContent = useCallback(() => {
+        if (rafRef.current !== null) {
+            cancelAnimationFrame(rafRef.current);
+            rafRef.current = null;
+        }
+        const assistantId = currentAssistantIdRef.current;
+        const content = streamedTextRef.current;
+        if (assistantId && content) {
+            updateAssistantMessage(assistantId, { content });
+        }
+    }, [updateAssistantMessage]);
+    const scheduleStreamUpdate = useCallback((content) => {
+        streamedTextRef.current = content;
+        if (!rafBatching) {
+            const assistantId = currentAssistantIdRef.current;
+            if (assistantId) {
+                updateAssistantMessage(assistantId, { content });
+            }
+            return;
+        }
+        if (rafRef.current === null) {
+            rafRef.current = requestAnimationFrame(() => {
+                rafRef.current = null;
+                const assistantId = currentAssistantIdRef.current;
+                if (assistantId) {
+                    updateAssistantMessage(assistantId, { content: streamedTextRef.current });
+                }
+            });
+        }
+    }, [rafBatching, updateAssistantMessage]);
+    // ==========================================================================
+    // JSON Response Handler (delegates to centralized parseJsonResponse)
+    // ==========================================================================
+    const handleJsonResponse = useCallback((id, data) => {
+        // Import dynamically to avoid circular dependencies
+        Promise.all([
+            import("@/lib/api"),
+            import("@/lib/multimodal"),
+        ]).then(async ([{ parseJsonResponse }, { uploadBase64ToPinata }]) => {
+            const result = parseJsonResponse(data);
+            if (!result.success) {
+                updateAssistantMessage(id, { content: `Error: ${result.error || "Unknown error"}` });
+                return;
+            }
+            // Upload base64 to Pinata if present and no URL
+            let url = result.url;
+            if (!url && result.base64 && (result.type === "image" || result.type === "audio" || result.type === "video")) {
+                try {
+                    url = await uploadBase64ToPinata(result.base64, result.type, conversationIdRef.current);
+                }
+                catch (err) {
+                    console.error("[use-chat] Pinata upload failed:", err);
+                }
+            }
+            // Determine content
+            // Fix: Only apply fallback if non-text media
+            let finalContent = result.content;
+            if (!finalContent) {
+                if (result.type !== "text") {
+                    finalContent = `Generated ${result.type}`;
+                }
+                else {
+                    finalContent = ""; // Empty string for text (e.g. tool-only)
+                }
+            }
+            updateAssistantMessage(id, {
+                content: finalContent,
+                type: result.type,
+                imageUrl: result.type === "image" ? url : undefined,
+                audioUrl: result.type === "audio" ? url : undefined,
+                videoUrl: result.type === "video" ? url : undefined,
+            });
+        });
+    }, [updateAssistantMessage]);
+    // ==========================================================================
+    // Scroll Functions
+    // ==========================================================================
+    const isNearBottom = useCallback(() => {
+        const el = scrollContainerRef.current;
+        if (!el)
+            return true;
+        return el.scrollHeight - el.scrollTop - el.clientHeight < 120;
+    }, []);
+    useEffect(() => {
+        if (!isNearBottom())
+            return;
+        messagesEndRef.current?.scrollIntoView({ behavior: "auto" });
+    }, [messages, isNearBottom]);
+    // ==========================================================================
+    // File Attachment Functions
+    // ==========================================================================
+    const handleFileSelect = useCallback(async (e) => {
+        if (!e.target.files || e.target.files.length === 0)
+            return;
+        const file = e.target.files[0];
+        const type = file.type.startsWith("image/")
+            ? "image"
+            : file.type.startsWith("video/")
+                ? "video"
+                : "audio";
+        try {
+            const preview = await fileToDataUrl(file);
+            const newFile = {
+                file,
+                preview,
+                uploading: true,
+                type,
+            };
+            if (maxFiles === 1) {
+                setAttachedFiles([newFile]);
+            }
+            else {
+                setAttachedFiles(prev => prev.length >= maxFiles
+                    ? [...prev.slice(1), newFile]
+                    : [...prev, newFile]);
+            }
+            const { cid, url } = await uploadConversationFile(file, conversationIdRef.current);
+            setAttachedFiles(prev => prev.map(f => f.file === file ? { ...f, cid, url, uploading: false } : f));
+            setUploadedCids(prev => [...prev, cid]);
+        }
+        catch (err) {
+            console.error("File upload failed:", err);
+            setAttachedFiles(prev => prev.filter(f => f.file !== file));
+            onError?.("Failed to upload file");
+        }
+        e.target.value = "";
+    }, [maxFiles, onError]);
+    const handleRemoveFile = useCallback((file) => {
+        setAttachedFiles(prev => prev.filter(f => f.file !== file));
+    }, []);
+    const clearFiles = useCallback(() => {
+        setAttachedFiles([]);
+        if (fileInputRef.current) {
+            fileInputRef.current.value = "";
+        }
+    }, []);
+    const cleanupFiles = useCallback(async () => {
+        if (uploadedCids.length > 0) {
+            await cleanupConversationFiles(uploadedCids);
+            setUploadedCids([]);
+        }
+    }, [uploadedCids]);
+    const isUploading = attachedFiles.some(f => f.uploading);
+    // ==========================================================================
+    // Audio Recording Functions
+    // ==========================================================================
+    const startRecording = useCallback(async () => {
+        if (!recordingSupported) {
+            onError?.("Audio recording not supported in this browser");
+            return;
+        }
+        try {
+            const stream = await navigator.mediaDevices.getUserMedia({ audio: true });
+            mediaStreamRef.current = stream;
+            const recorder = new MediaRecorder(stream, { mimeType: "audio/webm" });
+            mediaRecorderRef.current = recorder;
+            audioChunksRef.current = [];
+            recorder.ondataavailable = (e) => {
+                if (e.data.size > 0) {
+                    audioChunksRef.current.push(e.data);
+                }
+            };
+            recorder.onstop = async () => {
+                mediaStreamRef.current?.getTracks().forEach((track) => track.stop());
+                mediaStreamRef.current = null;
+                const audioBlob = new Blob(audioChunksRef.current, { type: "audio/webm" });
+                const audioFile = new File([audioBlob], `recording-${Date.now()}.webm`, { type: "audio/webm" });
+                try {
+                    const preview = await fileToDataUrl(audioFile);
+                    const attachedFile = {
+                        file: audioFile,
+                        preview,
+                        uploading: true,
+                        type: "audio",
+                    };
+                    // Add to attached files
+                    if (maxFiles === 1) {
+                        setAttachedFiles([attachedFile]);
+                    }
+                    else {
+                        setAttachedFiles(prev => [...prev, attachedFile]);
+                    }
+                    // Upload to Pinata
+                    const { cid, url } = await uploadConversationFile(audioFile, conversationIdRef.current);
+                    setAttachedFiles(prev => prev.map(f => f.file === audioFile ? { ...f, cid, url, uploading: false } : f));
+                    setUploadedCids(prev => [...prev, cid]);
+                }
+                catch (err) {
+                    console.error("Recording upload failed:", err);
+                    onError?.("Failed to upload recording");
+                }
+            };
+            recorder.start();
+            setIsRecording(true);
+        }
+        catch (err) {
+            console.error("Failed to start recording:", err);
+            onError?.("Failed to access microphone. Please check permissions.");
+        }
+    }, [recordingSupported, maxFiles, onError]);
+    const stopRecording = useCallback(() => {
+        if (mediaRecorderRef.current && isRecording) {
+            mediaRecorderRef.current.stop();
+            setIsRecording(false);
+        }
+    }, [isRecording]);
+    // ==========================================================================
+    // Cleanup
+    // ==========================================================================
+    useEffect(() => {
+        return () => {
+            if (rafRef.current !== null) {
+                cancelAnimationFrame(rafRef.current);
+            }
+            if (mediaStreamRef.current) {
+                mediaStreamRef.current.getTracks().forEach((track) => track.stop());
+            }
+        };
+    }, []);
+    return {
+        // Messages
+        messages,
+        setMessages,
+        addUserMessage,
+        createAssistantPlaceholder,
+        updateAssistantMessage,
+        handleJsonResponse,
+        clearMessages,
+        // Streaming
+        streamedTextRef,
+        currentAssistantIdRef,
+        scheduleStreamUpdate,
+        flushStreamContent,
+        // Scroll
+        scrollContainerRef,
+        messagesEndRef,
+        isNearBottom,
+        // Files
+        attachedFiles,
+        fileInputRef,
+        handleFileSelect,
+        handleRemoveFile,
+        clearFiles,
+        cleanupFiles,
+        isUploading,
+        uploadedCids,
+        // Recording
+        isRecording,
+        recordingSupported,
+        startRecording,
+        stopRecording,
+    };
+}
+//# sourceMappingURL=use-chat.js.map

package/dist/hooks/use-chat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-chat.js","sourceRoot":"","sources":["../../src/hooks/use-chat.ts"],"names":[],"mappings":"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"}

package/dist/hooks/use-coordinator.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Agentic Coordinator Models Hook
+ *
+ * React Query hook for fetching curated agentic coordinator models.
+ * These models are specifically designed for multi-agent workflows,
+ * tool-calling, and long-horizon reasoning tasks.
+ *
+ * Follows the pattern from use-model.ts but with a restricted selection
+ * of agentic-specialized models.
+ */
+export interface AgenticModel {
+    id: string;
+    name: string;
+    provider: string;
+    contextLength: number;
+    activeParams: string;
+    keyStrength: string;
+    description: string;
+}
+export declare const coordinatorModels: AgenticModel[];
+/**
+ * Hook to get all agentic coordinator models
+ */
+export declare function useAgenticModels(): any;
+/**
+ * Hook to get a specific agentic model by ID
+ */
+export declare function useAgenticModel(modelId: string | undefined): any;
+/**
+ * Get the default coordinator model (MiniMax M2.1 for largest context)
+ */
+export declare function getDefaultCoordinatorModel(): string;
+/**
+ * Get all agentic model IDs (for filtering)
+ */
+export declare function getAgenticModelIds(): string[];
+/**
+ * Check if a model ID is an approved agentic coordinator model
+ */
+export declare function isAgenticCoordinatorModel(modelId: string): boolean;
+//# sourceMappingURL=use-coordinator.d.ts.map

package/dist/hooks/use-coordinator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-coordinator.d.ts","sourceRoot":"","sources":["../../src/hooks/use-coordinator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAQH,MAAM,WAAW,YAAY;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACvB;AAOD,eAAO,MAAM,iBAAiB,EAAE,YAAY,EA8C3C,CAAC;AAMF;;GAEG;AACH,wBAAgB,gBAAgB,QAO/B;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,OAW1D;AAED;;GAEG;AACH,wBAAgB,0BAA0B,IAAI,MAAM,CAEnD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,EAAE,CAE7C;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAElE"}

package/dist/hooks/use-coordinator.js

@@ -0,0 +1,110 @@
+/**
+ * Agentic Coordinator Models Hook
+ *
+ * React Query hook for fetching curated agentic coordinator models.
+ * These models are specifically designed for multi-agent workflows,
+ * tool-calling, and long-horizon reasoning tasks.
+ *
+ * Follows the pattern from use-model.ts but with a restricted selection
+ * of agentic-specialized models.
+ */
+import { useQuery } from "@tanstack/react-query";
+// =============================================================================
+// Curated Agentic Coordinator Models
+// Model IDs verified against the project's normalized registry in models.json
+// =============================================================================
+export const coordinatorModels = [
+    {
+        id: "nvidia/nemotron-3-nano-30b-a3b:free",
+        name: "Nemotron 3 Nano 30B",
+        provider: "nvidia",
+        contextLength: 128000,
+        activeParams: "30B",
+        keyStrength: "Multi-step tool orchestration, RAG, reasoning",
+        description: "Post-trained for agentic workflows with SFT across math, code, and science.",
+    },
+    {
+        id: "moonshotai/kimi-k2-thinking",
+        name: "Kimi K2 Thinking",
+        provider: "moonshotai",
+        contextLength: 256000,
+        activeParams: "32B",
+        keyStrength: "200-300 sequential tool calls, long-horizon reasoning",
+        description: "Advanced agentic capabilities with tool-use learning and general RL.",
+    },
+    {
+        id: "minimax/minimax-m2.1",
+        name: "MiniMax M2.1",
+        provider: "minimax",
+        contextLength: 4000000,
+        activeParams: "45.9B",
+        keyStrength: "Interleaved Thinking (plan→act→reflect), 4M context",
+        description: "Agentic-first design with dynamic Plan→Act→Reflect loop.",
+    },
+    {
+        id: "nex-agi/deepseek-v3.1-nex-n1:free",
+        name: "DeepSeek V3.1 Nex N1",
+        provider: "nex-agi",
+        contextLength: 164000,
+        activeParams: "~10B",
+        keyStrength: "Autonomous operation, tool adherence",
+        description: "Post-trained for agent autonomy, tool use, and real-world productivity.",
+    },
+    {
+        id: "allenai/olmo-3.1-32b-think",
+        name: "OLMo 3.1 Think 32B",
+        provider: "allenai",
+        contextLength: 128000,
+        activeParams: "32B",
+        keyStrength: "Fully open, long chain-of-thought reasoning",
+        description: "Ai2's strongest fully open reasoning model with tool use support.",
+    },
+];
+// =============================================================================
+// Hooks
+// =============================================================================
+/**
+ * Hook to get all agentic coordinator models
+ */
+export function useAgenticModels() {
+    return useQuery({
+        queryKey: ["agentic-coordinator-models"],
+        queryFn: () => Promise.resolve(coordinatorModels),
+        staleTime: Infinity, // Static data, never stale
+        gcTime: Infinity,
+    });
+}
+/**
+ * Hook to get a specific agentic model by ID
+ */
+export function useAgenticModel(modelId) {
+    return useQuery({
+        queryKey: ["agentic-coordinator-model", modelId],
+        queryFn: () => {
+            const model = coordinatorModels.find(m => m.id === modelId);
+            return model || null;
+        },
+        enabled: !!modelId,
+        staleTime: Infinity,
+        gcTime: Infinity,
+    });
+}
+/**
+ * Get the default coordinator model (MiniMax M2.1 for largest context)
+ */
+export function getDefaultCoordinatorModel() {
+    return "minimax/minimax-m2.1";
+}
+/**
+ * Get all agentic model IDs (for filtering)
+ */
+export function getAgenticModelIds() {
+    return coordinatorModels.map(m => m.id);
+}
+/**
+ * Check if a model ID is an approved agentic coordinator model
+ */
+export function isAgenticCoordinatorModel(modelId) {
+    return coordinatorModels.some(m => m.id === modelId);
+}
+//# sourceMappingURL=use-coordinator.js.map

package/dist/hooks/use-coordinator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-coordinator.js","sourceRoot":"","sources":["../../src/hooks/use-coordinator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAgBjD,gFAAgF;AAChF,qCAAqC;AACrC,8EAA8E;AAC9E,gFAAgF;AAEhF,MAAM,CAAC,MAAM,iBAAiB,GAAmB;IAC7C;QACI,EAAE,EAAE,qCAAqC;QACzC,IAAI,EAAE,qBAAqB;QAC3B,QAAQ,EAAE,QAAQ;QAClB,aAAa,EAAE,MAAM;QACrB,YAAY,EAAE,KAAK;QACnB,WAAW,EAAE,+CAA+C;QAC5D,WAAW,EAAE,6EAA6E;KAC7F;IACD;QACI,EAAE,EAAE,6BAA6B;QACjC,IAAI,EAAE,kBAAkB;QACxB,QAAQ,EAAE,YAAY;QACtB,aAAa,EAAE,MAAM;QACrB,YAAY,EAAE,KAAK;QACnB,WAAW,EAAE,uDAAuD;QACpE,WAAW,EAAE,sEAAsE;KACtF;IACD;QACI,EAAE,EAAE,sBAAsB;QAC1B,IAAI,EAAE,cAAc;QACpB,QAAQ,EAAE,SAAS;QACnB,aAAa,EAAE,OAAO;QACtB,YAAY,EAAE,OAAO;QACrB,WAAW,EAAE,qDAAqD;QAClE,WAAW,EAAE,0DAA0D;KAC1E;IACD;QACI,EAAE,EAAE,mCAAmC;QACvC,IAAI,EAAE,sBAAsB;QAC5B,QAAQ,EAAE,SAAS;QACnB,aAAa,EAAE,MAAM;QACrB,YAAY,EAAE,MAAM;QACpB,WAAW,EAAE,sCAAsC;QACnD,WAAW,EAAE,yEAAyE;KACzF;IACD;QACI,EAAE,EAAE,4BAA4B;QAChC,IAAI,EAAE,oBAAoB;QAC1B,QAAQ,EAAE,SAAS;QACnB,aAAa,EAAE,MAAM;QACrB,YAAY,EAAE,KAAK;QACnB,WAAW,EAAE,6CAA6C;QAC1D,WAAW,EAAE,mEAAmE;KACnF;CACJ,CAAC;AAEF,gFAAgF;AAChF,QAAQ;AACR,gFAAgF;AAEhF;;GAEG;AACH,MAAM,UAAU,gBAAgB;IAC5B,OAAO,QAAQ,CAAC;QACZ,QAAQ,EAAE,CAAC,4BAA4B,CAAC;QACxC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,iBAAiB,CAAC;QACjD,SAAS,EAAE,QAAQ,EAAE,2BAA2B;QAChD,MAAM,EAAE,QAAQ;KACnB,CAAC,CAAC;AACP,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,OAA2B;IACvD,OAAO,QAAQ,CAAC;QACZ,QAAQ,EAAE,CAAC,2BAA2B,EAAE,OAAO,CAAC;QAChD,OAAO,EAAE,GAAG,EAAE;YACV,MAAM,KAAK,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,OAAO,CAAC,CAAC;YAC5D,OAAO,KAAK,IAAI,IAAI,CAAC;QACzB,CAAC;QACD,OAAO,EAAE,CAAC,CAAC,OAAO;QAClB,SAAS,EAAE,QAAQ;QACnB,MAAM,EAAE,QAAQ;KACnB,CAAC,CAAC;AACP,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,0BAA0B;IACtC,OAAO,sBAAsB,CAAC;AAClC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB;IAC9B,OAAO,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AAC5C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,yBAAyB,CAAC,OAAe;IACrD,OAAO,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,OAAO,CAAC,CAAC;AACzD,CAAC"}

package/dist/hooks/use-dispenser.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Dispenser Hook
+ *
+ * React Query hooks for dispenser operations:
+ * - Check dispenser status across chains
+ * - Check if address has claimed
+ * - Claim USDC from dispenser
+ *
+ * @module hooks/use-dispenser
+ */
+export interface DispenserStatus {
+    chainId: number;
+    chainName: string;
+    totalClaims: number;
+    maxClaims: number;
+    remainingClaims: number;
+    dispenserBalance: string;
+    dispenserBalanceFormatted: string;
+    isPaused: boolean;
+    dispenserAddress: string;
+    usdcAddress: string;
+    isConfigured: boolean;
+}
+export interface DispenserStatusResponse {
+    dispensers: DispenserStatus[];
+    claimAmount: number;
+    claimAmountFormatted: string;
+    maxClaims: number;
+}
+export interface ClaimResult {
+    success: boolean;
+    txHash?: string;
+    error?: string;
+    alreadyClaimed?: boolean;
+    globalClaimStatus?: {
+        claimedOnChain?: number;
+        claimedOnChainName?: string;
+        claimedAt?: number;
+    };
+}
+export interface ClaimCheckResult {
+    address: string;
+    hasClaimed: boolean;
+    claimedOnChain?: number;
+    claimedOnChainName?: string;
+    claimedAt?: number;
+}
+/**
+ * Get dispenser status for all supported chains
+ */
+export declare function useDispenserStatus(): any;
+/**
+ * Check if an address has claimed from any dispenser
+ */
+export declare function useDispenserCheck(address: string | undefined): any;
+/**
+ * Claim USDC from dispenser
+ */
+export declare function useDispenserClaim(): any;
+/**
+ * Get explorer URL for a transaction
+ */
+export declare function getExplorerTxUrl(txHash: string, chainId: number): string;
+/**
+ * Get chain color for UI
+ */
+export declare function getChainColor(chainId: number): string;
+//# sourceMappingURL=use-dispenser.d.ts.map

package/dist/hooks/use-dispenser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-dispenser.d.ts","sourceRoot":"","sources":["../../src/hooks/use-dispenser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AASH,MAAM,WAAW,eAAe;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,yBAAyB,EAAE,MAAM,CAAC;IAClC,QAAQ,EAAE,OAAO,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,uBAAuB;IACpC,UAAU,EAAE,eAAe,EAAE,CAAC;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,iBAAiB,CAAC,EAAE;QAChB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;CACL;AAED,MAAM,WAAW,gBAAgB;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,OAAO,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AA6CD;;GAEG;AACH,wBAAgB,kBAAkB,QAOjC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,OAO5D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,QAiBhC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAQxE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAOrD"}