@formmy.app/chat 0.0.1-alpha.1

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

@@ -0,0 +1,162 @@
+/**
+ * @formmy.app/chat/react - useFormmyChat Hook
+ *
+ * Headless hook for chat functionality, wrapping Vercel AI SDK's useChat.
+ *
+ * Usage:
+ * ```tsx
+ * import { useFormmyChat } from '@formmy.app/chat/react';
+ *
+ * function Chat() {
+ *   const { messages, sendMessage, status } = useFormmyChat({
+ *     agentId: 'agent_123',
+ *   });
+ *
+ *   return (
+ *     <div>
+ *       {messages.map(m => <div key={m.id}>{getMessageText(m)}</div>)}
+ *       <button onClick={() => sendMessage('Hello!')}>Send</button>
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+import { useChat } from "@ai-sdk/react";
+import { DefaultChatTransport } from "ai";
+import { useMemo, useCallback, useState, useEffect } from "react";
+import { useFormmy } from "../ui/provider";
+// Session ID storage key prefix
+const SESSION_KEY_PREFIX = "formmy_session_";
+/**
+ * Extract text content from a message's parts
+ */
+export function getMessageText(message) {
+    if (!message.parts)
+        return "";
+    return message.parts
+        .filter((p) => p.type === "text" && typeof p.text === "string")
+        .map((p) => p.text)
+        .join("");
+}
+/**
+ * Headless chat hook - provides all chat functionality without UI
+ */
+export function useFormmyChat(options) {
+    const { agentId, onError, onFinish } = options;
+    const { publishableKey, baseUrl } = useFormmy();
+    // Generate or retrieve session ID (crypto-secure)
+    const [sessionId] = useState(() => {
+        // SSR safety
+        if (typeof window === "undefined") {
+            return `sdk_${agentId}_${Date.now()}`;
+        }
+        try {
+            const storageKey = `${SESSION_KEY_PREFIX}${agentId}`;
+            const existing = localStorage.getItem(storageKey);
+            if (existing) {
+                return existing;
+            }
+            // Use crypto.getRandomValues for secure random ID
+            const bytes = new Uint8Array(16);
+            crypto.getRandomValues(bytes);
+            const randomPart = Array.from(bytes, (b) => b.toString(16).padStart(2, "0")).join("");
+            const newSessionId = `sdk_${agentId}_${randomPart}`;
+            localStorage.setItem(storageKey, newSessionId);
+            return newSessionId;
+        }
+        catch {
+            // Fallback if localStorage is disabled
+            const bytes = new Uint8Array(16);
+            crypto.getRandomValues(bytes);
+            const randomPart = Array.from(bytes, (b) => b.toString(16).padStart(2, "0")).join("");
+            return `sdk_${agentId}_${randomPart}`;
+        }
+    });
+    // Create transport with SDK authentication
+    const transport = useMemo(() => {
+        return new DefaultChatTransport({
+            api: `${baseUrl}/api/v2/sdk?intent=chat&agentId=${agentId}`,
+            headers: {
+                "X-Publishable-Key": publishableKey || "",
+            },
+            // "Last Message Only" pattern - only send the new message
+            prepareSendMessagesRequest({ messages, id }) {
+                return {
+                    body: {
+                        message: messages[messages.length - 1],
+                        id: id || sessionId,
+                    },
+                };
+            },
+        });
+    }, [baseUrl, agentId, publishableKey, sessionId]);
+    // Use Vercel AI SDK's useChat with our transport
+    const chat = useChat({
+        id: sessionId,
+        transport,
+        onError: (error) => {
+            console.error("[useFormmyChat] Error:", error);
+            onError?.(error);
+        },
+        onFinish: () => {
+            onFinish?.();
+        },
+    });
+    // Load historical messages on mount
+    useEffect(() => {
+        async function loadHistory() {
+            try {
+                const response = await fetch(`${baseUrl}/api/v2/sdk?intent=chat.history&agentId=${agentId}&sessionId=${sessionId}`, {
+                    headers: {
+                        "X-Publishable-Key": publishableKey || "",
+                    },
+                });
+                if (response.ok) {
+                    const data = await response.json();
+                    if (data.messages?.length > 0) {
+                        chat.setMessages(data.messages);
+                    }
+                }
+            }
+            catch (error) {
+                console.warn("[useFormmyChat] Failed to load history:", error);
+            }
+        }
+        loadHistory();
+        // Only run on mount
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, []);
+    // Simplified sendMessage wrapper
+    const sendMessage = useCallback(async (text) => {
+        await chat.sendMessage({
+            role: "user",
+            parts: [{ type: "text", text }],
+        });
+    }, [chat]);
+    // Reset conversation (clear local storage and messages)
+    const reset = useCallback(() => {
+        if (typeof window !== "undefined") {
+            localStorage.removeItem(`${SESSION_KEY_PREFIX}${agentId}`);
+        }
+        chat.setMessages([]);
+    }, [agentId, chat]);
+    return {
+        // State
+        messages: chat.messages,
+        status: chat.status,
+        error: chat.error,
+        // Metadata
+        sessionId,
+        agentId,
+        // Actions
+        sendMessage,
+        reset,
+        stop: chat.stop,
+        setMessages: chat.setMessages,
+        // Utility
+        getMessageText,
+        // Raw chat object for advanced use cases
+        _chat: chat,
+    };
+}
+//# sourceMappingURL=use-formmy-chat.js.map

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

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

package/dist/index.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @formmy.app/chat - Official SDK for Formmy Chat
+ *
+ * This is the core client for backend usage (no React dependency).
+ *
+ * @example Backend Usage
+ * ```typescript
+ * import { Formmy } from '@formmy.app/chat';
+ *
+ * const formmy = new Formmy({ secretKey: 'sk_live_xxx' });
+ *
+ * // Create agent
+ * const agent = await formmy.agents.create({ name: 'My Agent' });
+ *
+ * // List agents
+ * const { agents } = await formmy.agents.list();
+ * ```
+ *
+ * For React components and hooks, use:
+ * ```tsx
+ * import { FormmyProvider, ChatBubble, useFormmyChat } from '@formmy.app/chat/react';
+ * ```
+ */
+export * from "./core/client";
+export * from "./core/types";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAGH,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,27 @@
+/**
+ * @formmy.app/chat - Official SDK for Formmy Chat
+ *
+ * This is the core client for backend usage (no React dependency).
+ *
+ * @example Backend Usage
+ * ```typescript
+ * import { Formmy } from '@formmy.app/chat';
+ *
+ * const formmy = new Formmy({ secretKey: 'sk_live_xxx' });
+ *
+ * // Create agent
+ * const agent = await formmy.agents.create({ name: 'My Agent' });
+ *
+ * // List agents
+ * const { agents } = await formmy.agents.list();
+ * ```
+ *
+ * For React components and hooks, use:
+ * ```tsx
+ * import { FormmyProvider, ChatBubble, useFormmyChat } from '@formmy.app/chat/react';
+ * ```
+ */
+// Re-export everything from core client
+export * from "./core/client";
+export * from "./core/types";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,wCAAwC;AACxC,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC"}

package/dist/react.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @formmy.app/chat/react - React components and hooks
+ *
+ * @example
+ * ```tsx
+ * import { FormmyProvider, ChatBubble, useFormmyChat } from '@formmy.app/chat/react';
+ *
+ * function App() {
+ *   return (
+ *     <FormmyProvider publishableKey="pk_live_xxx">
+ *       <YourApp />
+ *       <ChatBubble agentId="agent_123" />
+ *     </FormmyProvider>
+ *   );
+ * }
+ * ```
+ */
+export type { FormmyConfig, FormmyProviderProps, UseFormmyChatOptions, Message, MessagePart, ChatBubbleProps, ChatTheme, } from "./core/types";
+export { FormmyProvider, useFormmy, useFormmyOptional } from "./ui/provider";
+export { useFormmyChat, getMessageText } from "./hooks/use-formmy-chat";
+export { ChatBubble } from "./ui/chat-bubble";
+//# sourceMappingURL=react.d.ts.map

package/dist/react.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../src/react.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAKH,YAAY,EACV,YAAY,EACZ,mBAAmB,EACnB,oBAAoB,EACpB,OAAO,EACP,WAAW,EACX,eAAe,EACf,SAAS,GACV,MAAM,cAAc,CAAC;AAKtB,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAK7E,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAKxE,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/react.js

@@ -0,0 +1,30 @@
+/**
+ * @formmy.app/chat/react - React components and hooks
+ *
+ * @example
+ * ```tsx
+ * import { FormmyProvider, ChatBubble, useFormmyChat } from '@formmy.app/chat/react';
+ *
+ * function App() {
+ *   return (
+ *     <FormmyProvider publishableKey="pk_live_xxx">
+ *       <YourApp />
+ *       <ChatBubble agentId="agent_123" />
+ *     </FormmyProvider>
+ *   );
+ * }
+ * ```
+ */
+// ═══════════════════════════════════════════════════════════════════════════
+// Provider & Context
+// ═══════════════════════════════════════════════════════════════════════════
+export { FormmyProvider, useFormmy, useFormmyOptional } from "./ui/provider";
+// ═══════════════════════════════════════════════════════════════════════════
+// Hooks
+// ═══════════════════════════════════════════════════════════════════════════
+export { useFormmyChat, getMessageText } from "./hooks/use-formmy-chat";
+// ═══════════════════════════════════════════════════════════════════════════
+// UI Components
+// ═══════════════════════════════════════════════════════════════════════════
+export { ChatBubble } from "./ui/chat-bubble";
+//# sourceMappingURL=react.js.map

package/dist/react.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.js","sourceRoot":"","sources":["../src/react.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAeH,8EAA8E;AAC9E,qBAAqB;AACrB,8EAA8E;AAC9E,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAE7E,8EAA8E;AAC9E,QAAQ;AACR,8EAA8E;AAC9E,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAExE,8EAA8E;AAC9E,gBAAgB;AAChB,8EAA8E;AAC9E,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/ui/chat-bubble.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @formmy.app/react - ChatBubble Component
+ *
+ * Ready-to-use floating chat widget.
+ *
+ * Usage:
+ * ```tsx
+ * import { FormmyProvider, ChatBubble } from '@formmy.app/react';
+ *
+ * function App() {
+ *   return (
+ *     <FormmyProvider publishableKey="pk_live_xxx">
+ *       <YourApp />
+ *       <ChatBubble
+ *         agentId="agent_123"
+ *         position="bottom-right"
+ *         theme={{ primaryColor: '#9A99EA' }}
+ *       />
+ *     </FormmyProvider>
+ *   );
+ * }
+ * ```
+ */
+import type { ChatBubbleProps } from "../core/types";
+export declare function ChatBubble({ agentId, position, theme, defaultOpen, onOpenChange, }: ChatBubbleProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=chat-bubble.d.ts.map

package/dist/ui/chat-bubble.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-bubble.d.ts","sourceRoot":"","sources":["../../src/ui/chat-bubble.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAIH,OAAO,KAAK,EAAE,eAAe,EAAa,MAAM,eAAe,CAAC;AAiChE,wBAAgB,UAAU,CAAC,EACzB,OAAO,EACP,QAAyB,EACzB,KAAU,EACV,WAAmB,EACnB,YAAY,GACb,EAAE,eAAe,2CA8RjB"}

package/dist/ui/chat-bubble.js

@@ -0,0 +1,206 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+/**
+ * @formmy.app/react - ChatBubble Component
+ *
+ * Ready-to-use floating chat widget.
+ *
+ * Usage:
+ * ```tsx
+ * import { FormmyProvider, ChatBubble } from '@formmy.app/react';
+ *
+ * function App() {
+ *   return (
+ *     <FormmyProvider publishableKey="pk_live_xxx">
+ *       <YourApp />
+ *       <ChatBubble
+ *         agentId="agent_123"
+ *         position="bottom-right"
+ *         theme={{ primaryColor: '#9A99EA' }}
+ *       />
+ *     </FormmyProvider>
+ *   );
+ * }
+ * ```
+ */
+import { useState, useRef, useEffect } from "react";
+import { useFormmyChat, getMessageText } from "../hooks/use-formmy-chat";
+// ═══════════════════════════════════════════════════════════════════════════
+// Styles (inline to avoid external dependencies)
+// ═══════════════════════════════════════════════════════════════════════════
+const defaultTheme = {
+    primaryColor: "#9A99EA",
+    backgroundColor: "#ffffff",
+    textColor: "#1a1a1a",
+    borderRadius: "16px",
+};
+function getPositionStyles(position = "bottom-right") {
+    const base = { position: "fixed", zIndex: 9999 };
+    switch (position) {
+        case "bottom-left":
+            return { ...base, bottom: "24px", left: "24px" };
+        case "top-right":
+            return { ...base, top: "24px", right: "24px" };
+        case "top-left":
+            return { ...base, top: "24px", left: "24px" };
+        case "bottom-right":
+        default:
+            return { ...base, bottom: "24px", right: "24px" };
+    }
+}
+// ═══════════════════════════════════════════════════════════════════════════
+// Component
+// ═══════════════════════════════════════════════════════════════════════════
+export function ChatBubble({ agentId, position = "bottom-right", theme = {}, defaultOpen = false, onOpenChange, }) {
+    const [isOpen, setIsOpen] = useState(defaultOpen);
+    const [input, setInput] = useState("");
+    const messagesEndRef = useRef(null);
+    const inputRef = useRef(null);
+    const { messages, sendMessage, status } = useFormmyChat({ agentId });
+    const mergedTheme = { ...defaultTheme, ...theme };
+    const positionStyles = getPositionStyles(position);
+    const isLoading = status === "streaming" || status === "submitted";
+    // Handle open/close
+    const handleToggle = () => {
+        const newState = !isOpen;
+        setIsOpen(newState);
+        onOpenChange?.(newState);
+    };
+    // Auto-scroll to bottom on new messages
+    useEffect(() => {
+        messagesEndRef.current?.scrollIntoView({ behavior: "smooth" });
+    }, [messages]);
+    // Focus input when opened
+    useEffect(() => {
+        if (isOpen) {
+            setTimeout(() => inputRef.current?.focus(), 100);
+        }
+    }, [isOpen]);
+    // Handle send
+    const handleSubmit = async (e) => {
+        e.preventDefault();
+        if (!input.trim() || isLoading)
+            return;
+        const message = input.trim();
+        setInput("");
+        await sendMessage(message);
+    };
+    // Handle Enter key
+    const handleKeyDown = (e) => {
+        if (e.key === "Enter" && !e.shiftKey) {
+            e.preventDefault();
+            handleSubmit(e);
+        }
+    };
+    return (_jsxs("div", { style: positionStyles, children: [isOpen && (_jsxs("div", { style: {
+                    position: "absolute",
+                    bottom: "70px",
+                    right: "0",
+                    width: "380px",
+                    maxWidth: "calc(100vw - 48px)",
+                    height: "500px",
+                    maxHeight: "calc(100vh - 120px)",
+                    backgroundColor: mergedTheme.backgroundColor,
+                    borderRadius: mergedTheme.borderRadius,
+                    boxShadow: "0 8px 32px rgba(0, 0, 0, 0.15)",
+                    display: "flex",
+                    flexDirection: "column",
+                    overflow: "hidden",
+                }, children: [_jsxs("div", { style: {
+                            padding: "16px",
+                            backgroundColor: mergedTheme.primaryColor,
+                            color: "#fff",
+                            fontWeight: 600,
+                            display: "flex",
+                            justifyContent: "space-between",
+                            alignItems: "center",
+                        }, children: [_jsx("span", { children: "Chat" }), _jsx("button", { onClick: handleToggle, style: {
+                                    background: "none",
+                                    border: "none",
+                                    color: "#fff",
+                                    cursor: "pointer",
+                                    fontSize: "20px",
+                                    lineHeight: 1,
+                                }, "aria-label": "Close chat", children: "\u00D7" })] }), _jsxs("div", { style: {
+                            flex: 1,
+                            overflowY: "auto",
+                            padding: "16px",
+                            display: "flex",
+                            flexDirection: "column",
+                            gap: "12px",
+                        }, children: [messages.length === 0 && (_jsx("div", { style: {
+                                    textAlign: "center",
+                                    color: "#666",
+                                    marginTop: "40px",
+                                }, children: "Send a message to start the conversation" })), messages.map((msg) => {
+                                const text = getMessageText(msg);
+                                if (!text)
+                                    return null;
+                                const isUser = msg.role === "user";
+                                return (_jsx("div", { style: {
+                                        display: "flex",
+                                        justifyContent: isUser ? "flex-end" : "flex-start",
+                                    }, children: _jsx("div", { style: {
+                                            maxWidth: "80%",
+                                            padding: "10px 14px",
+                                            borderRadius: "12px",
+                                            backgroundColor: isUser
+                                                ? mergedTheme.primaryColor
+                                                : "#f0f0f0",
+                                            color: isUser ? "#fff" : mergedTheme.textColor,
+                                            fontSize: "14px",
+                                            lineHeight: 1.5,
+                                            whiteSpace: "pre-wrap",
+                                            wordBreak: "break-word",
+                                        }, children: text }) }, msg.id));
+                            }), isLoading && (_jsx("div", { style: { display: "flex", justifyContent: "flex-start" }, children: _jsxs("div", { style: {
+                                        padding: "10px 14px",
+                                        borderRadius: "12px",
+                                        backgroundColor: "#f0f0f0",
+                                        color: "#666",
+                                        fontSize: "14px",
+                                    }, children: [_jsx("span", { style: { animation: "pulse 1.5s infinite" }, children: "\u25CF" }), _jsx("span", { style: { animation: "pulse 1.5s infinite 0.2s" }, children: "\u25CF" }), _jsx("span", { style: { animation: "pulse 1.5s infinite 0.4s" }, children: "\u25CF" })] }) })), _jsx("div", { ref: messagesEndRef })] }), _jsxs("form", { onSubmit: handleSubmit, style: {
+                            padding: "12px 16px",
+                            borderTop: "1px solid #eee",
+                            display: "flex",
+                            gap: "8px",
+                        }, children: [_jsx("input", { ref: inputRef, type: "text", value: input, onChange: (e) => setInput(e.target.value), onKeyDown: handleKeyDown, placeholder: "Type a message...", disabled: isLoading, style: {
+                                    flex: 1,
+                                    padding: "10px 14px",
+                                    borderRadius: "8px",
+                                    border: "1px solid #ddd",
+                                    fontSize: "14px",
+                                    outline: "none",
+                                } }), _jsx("button", { type: "submit", disabled: !input.trim() || isLoading, style: {
+                                    padding: "10px 16px",
+                                    borderRadius: "8px",
+                                    border: "none",
+                                    backgroundColor: mergedTheme.primaryColor,
+                                    color: "#fff",
+                                    fontSize: "14px",
+                                    fontWeight: 500,
+                                    cursor: input.trim() && !isLoading ? "pointer" : "not-allowed",
+                                    opacity: input.trim() && !isLoading ? 1 : 0.6,
+                                }, children: "Send" })] })] })), _jsx("button", { onClick: handleToggle, style: {
+                    width: "56px",
+                    height: "56px",
+                    borderRadius: "50%",
+                    backgroundColor: mergedTheme.primaryColor,
+                    border: "none",
+                    boxShadow: "0 4px 12px rgba(0, 0, 0, 0.15)",
+                    cursor: "pointer",
+                    display: "flex",
+                    alignItems: "center",
+                    justifyContent: "center",
+                    transition: "transform 0.2s",
+                }, "aria-label": isOpen ? "Close chat" : "Open chat", children: _jsx("svg", { width: "24", height: "24", viewBox: "0 0 24 24", fill: "none", stroke: "#fff", strokeWidth: "2", strokeLinecap: "round", strokeLinejoin: "round", children: isOpen ? (
+                    // X icon
+                    _jsxs(_Fragment, { children: [_jsx("line", { x1: "18", y1: "6", x2: "6", y2: "18" }), _jsx("line", { x1: "6", y1: "6", x2: "18", y2: "18" })] })) : (
+                    // Chat icon
+                    _jsx(_Fragment, { children: _jsx("path", { d: "M21 15a2 2 0 0 1-2 2H7l-4 4V5a2 2 0 0 1 2-2h14a2 2 0 0 1 2 2z" }) })) }) }), _jsx("style", { children: `
+        @keyframes pulse {
+          0%, 100% { opacity: 0.4; }
+          50% { opacity: 1; }
+        }
+      ` })] }));
+}
+//# sourceMappingURL=chat-bubble.js.map

package/dist/ui/chat-bubble.js.map

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

package/dist/ui/provider.d.ts

@@ -0,0 +1,35 @@
+/**
+ * @formmy.app/react - Provider Component
+ *
+ * Provides Formmy configuration to all child components.
+ *
+ * Usage:
+ * ```tsx
+ * import { FormmyProvider } from '@formmy.app/react';
+ *
+ * function App() {
+ *   return (
+ *     <FormmyProvider publishableKey="pk_live_xxx">
+ *       <YourApp />
+ *     </FormmyProvider>
+ *   );
+ * }
+ * ```
+ */
+import type { FormmyConfig, FormmyProviderProps } from "../core/types";
+interface FormmyContextValue extends FormmyConfig {
+    baseUrl: string;
+}
+export declare function FormmyProvider({ publishableKey, secretKey, baseUrl, children, }: FormmyProviderProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Hook to access Formmy configuration from context
+ * @throws Error if used outside FormmyProvider
+ */
+export declare function useFormmy(): FormmyContextValue;
+/**
+ * Hook to access Formmy configuration, returns null if not in provider
+ * Useful for optional Formmy integration
+ */
+export declare function useFormmyOptional(): FormmyContextValue | null;
+export {};
+//# sourceMappingURL=provider.d.ts.map

package/dist/ui/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../src/ui/provider.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAIvE,UAAU,kBAAmB,SAAQ,YAAY;IAC/C,OAAO,EAAE,MAAM,CAAC;CACjB;AAID,wBAAgB,cAAc,CAAC,EAC7B,cAAc,EACd,SAAS,EACT,OAA0B,EAC1B,QAAQ,GACT,EAAE,mBAAmB,2CAarB;AAED;;;GAGG;AACH,wBAAgB,SAAS,IAAI,kBAAkB,CAQ9C;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,kBAAkB,GAAG,IAAI,CAE7D"}

package/dist/ui/provider.js

@@ -0,0 +1,49 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * @formmy.app/react - Provider Component
+ *
+ * Provides Formmy configuration to all child components.
+ *
+ * Usage:
+ * ```tsx
+ * import { FormmyProvider } from '@formmy.app/react';
+ *
+ * function App() {
+ *   return (
+ *     <FormmyProvider publishableKey="pk_live_xxx">
+ *       <YourApp />
+ *     </FormmyProvider>
+ *   );
+ * }
+ * ```
+ */
+import { createContext, useContext, useMemo } from "react";
+const DEFAULT_BASE_URL = "https://formmy.app";
+const FormmyContext = createContext(null);
+export function FormmyProvider({ publishableKey, secretKey, baseUrl = DEFAULT_BASE_URL, children, }) {
+    const value = useMemo(() => ({
+        publishableKey,
+        secretKey,
+        baseUrl,
+    }), [publishableKey, secretKey, baseUrl]);
+    return (_jsx(FormmyContext.Provider, { value: value, children: children }));
+}
+/**
+ * Hook to access Formmy configuration from context
+ * @throws Error if used outside FormmyProvider
+ */
+export function useFormmy() {
+    const context = useContext(FormmyContext);
+    if (!context) {
+        throw new Error("useFormmy must be used within a FormmyProvider");
+    }
+    return context;
+}
+/**
+ * Hook to access Formmy configuration, returns null if not in provider
+ * Useful for optional Formmy integration
+ */
+export function useFormmyOptional() {
+    return useContext(FormmyContext);
+}
+//# sourceMappingURL=provider.js.map

package/dist/ui/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../src/ui/provider.tsx"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAG3D,MAAM,gBAAgB,GAAG,oBAAoB,CAAC;AAM9C,MAAM,aAAa,GAAG,aAAa,CAA4B,IAAI,CAAC,CAAC;AAErE,MAAM,UAAU,cAAc,CAAC,EAC7B,cAAc,EACd,SAAS,EACT,OAAO,GAAG,gBAAgB,EAC1B,QAAQ,GACY;IACpB,MAAM,KAAK,GAAG,OAAO,CACnB,GAAG,EAAE,CAAC,CAAC;QACL,cAAc;QACd,SAAS;QACT,OAAO;KACR,CAAC,EACF,CAAC,cAAc,EAAE,SAAS,EAAE,OAAO,CAAC,CACrC,CAAC;IAEF,OAAO,CACL,KAAC,aAAa,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YAAG,QAAQ,GAA0B,CAC1E,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,SAAS;IACvB,MAAM,OAAO,GAAG,UAAU,CAAC,aAAa,CAAC,CAAC;IAE1C,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;IACpE,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB;IAC/B,OAAO,UAAU,CAAC,aAAa,CAAC,CAAC;AACnC,CAAC"}