@foxpixel/react 0.1.1 → 0.2.0

package/dist/index.d.mts

@@ -1,5 +1,5 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { ReactNode, ComponentType } from 'react';
+import React, { ReactNode, ComponentType } from 'react';
 import { AxiosInstance, AxiosRequestConfig } from 'axios';
 
 /**
@@ -188,6 +188,8 @@ interface AuthContextValue {
         phone?: string;
     }) => Promise<void>;
     refetch: () => Promise<void>;
+    /** Stub: returns true when user is logged in and permission is site:content:update. */
+    hasPermission: (permission: string) => boolean;
 }
 interface AuthProviderProps {
     children: ReactNode;
@@ -261,6 +263,54 @@ interface WithAuthOptions {
 }
 declare function withAuth<P extends object>(Component: ComponentType<P>, options?: WithAuthOptions): (props: P) => string | number | true | Iterable<ReactNode> | react_jsx_runtime.JSX.Element | null;
 
+interface EditableProps {
+    contentKey: string;
+    defaultValue: string;
+    as?: keyof JSX.IntrinsicElements;
+    multiline?: boolean;
+    className?: string;
+}
+declare function Editable({ contentKey, defaultValue, as, multiline, className, }: EditableProps): React.ReactElement<{
+    className: string;
+    'aria-busy': boolean;
+    'aria-label': string;
+}, string | React.JSXElementConstructor<any>> | React.DOMElement<{
+    className: string;
+    'data-content-key': string;
+    'data-editable': string | undefined;
+    onClick: ((e: React.MouseEvent) => void) | undefined;
+    title: string | undefined;
+}, Element>;
+/**
+ * Renders rich HTML content from the CMS. Content is sanitized before rendering.
+ */
+declare function EditableHTML({ contentKey, defaultValue, as, className, }: Omit<EditableProps, 'multiline'>): React.ReactElement<{
+    className: string;
+    'aria-busy': boolean;
+}, string | React.JSXElementConstructor<any>> | React.DOMElement<{
+    className: string;
+    'data-content-key': string;
+    'data-editable': string | undefined;
+    onClick: ((e: React.MouseEvent) => void) | undefined;
+    title: string | undefined;
+    dangerouslySetInnerHTML: {
+        __html: string;
+    };
+}, Element>;
+interface EditableImageProps {
+    contentKey: string;
+    defaultValue: string;
+    alt: string;
+    className?: string;
+    width?: number;
+    height?: number;
+    priority?: boolean;
+}
+/**
+ * Renders an image from a CMS-managed URL. Uses native img (no Next.js Image in SDK).
+ */
+declare function EditableImage({ contentKey, defaultValue, alt, className, width, height, priority, }: EditableImageProps): react_jsx_runtime.JSX.Element;
+
 /**
  * Hook to fetch and manage services (Projects module)
  */
@@ -405,6 +455,237 @@ interface UseContactCaptureReturn {
  */
 declare function useContactCapture(): UseContactCaptureReturn;
 
+/**
+ * Hook for managing editable site content (CMS Visual)
+ *
+ * Allows non-developers to edit text content directly on the site.
+ */
+
+interface SiteContent {
+    id: string;
+    contentKey: string;
+    value: string | null;
+    contentType: string;
+    defaultValue: string | null;
+    description: string | null;
+    section: string | null;
+    sortOrder: number;
+    isActive: boolean;
+    updatedAt: string | null;
+}
+interface UseSiteContentOptions {
+    /**
+     * Default value to use if content is not found
+     */
+    defaultValue?: string;
+    /**
+     * Whether to fetch on mount (default: true)
+     */
+    fetchOnMount?: boolean;
+}
+interface UseSiteContentReturn {
+    /**
+     * The content object (null if not found or loading)
+     */
+    data: SiteContent | null;
+    /**
+     * The content value (or defaultValue if not found)
+     */
+    value: string;
+    /**
+     * Whether content is being loaded
+     */
+    isLoading: boolean;
+    /**
+     * Error if request failed
+     */
+    error: ApiError$1 | null;
+    /**
+     * Whether the current user can edit this content
+     */
+    canEdit: boolean;
+    /**
+     * Update the content value
+     */
+    update: (newValue: string) => Promise<void>;
+    /**
+     * Refetch the content
+     */
+    refetch: () => Promise<void>;
+}
+/**
+ * Hook for managing a single site content key.
+ *
+ * @example
+ * ```tsx
+ * function HeroSection() {
+ *   const { value, canEdit, update } = useSiteContent('hero.title', {
+ *     defaultValue: 'Welcome to our site'
+ *   });
+ *
+ *   const [isEditing, setIsEditing] = useState(false);
+ *   const [editValue, setEditValue] = useState(value);
+ *
+ *   const handleSave = async () => {
+ *     await update(editValue);
+ *     setIsEditing(false);
+ *   };
+ *
+ *   if (canEdit && isEditing) {
+ *     return (
+ *       <input
+ *         value={editValue}
+ *         onChange={(e) => setEditValue(e.target.value)}
+ *         onBlur={handleSave}
+ *       />
+ *     );
+ *   }
+ *
+ *   return (
+ *     <h1 onClick={() => canEdit && setIsEditing(true)}>
+ *       {value}
+ *     </h1>
+ *   );
+ * }
+ * ```
+ */
+declare function useSiteContent(contentKey: string, options?: UseSiteContentOptions): UseSiteContentReturn;
+interface UseSiteContentsOptions {
+    /**
+     * Default values map
+     */
+    defaults?: Record<string, string>;
+}
+interface UseSiteContentsReturn {
+    /**
+     * Map of content key to content object
+     */
+    data: Record<string, SiteContent>;
+    /**
+     * Get value by key (with default fallback)
+     */
+    getValue: (key: string, defaultValue?: string) => string;
+    /**
+     * Whether contents are being loaded
+     */
+    isLoading: boolean;
+    /**
+     * Error if request failed
+     */
+    error: ApiError$1 | null;
+    /**
+     * Refetch all contents
+     */
+    refetch: () => Promise<void>;
+}
+/**
+ * Hook for fetching multiple site content keys at once.
+ * More efficient than calling useSiteContent multiple times.
+ *
+ * @example
+ * ```tsx
+ * function Footer() {
+ *   const { getValue, isLoading } = useSiteContents(
+ *     ['footer.copyright', 'footer.address', 'footer.phone'],
+ *     { defaults: { 'footer.copyright': '© 2024' } }
+ *   );
+ *
+ *   if (isLoading) return null;
+ *
+ *   return (
+ *     <footer>
+ *       <p>{getValue('footer.copyright')}</p>
+ *       <p>{getValue('footer.address')}</p>
+ *       <p>{getValue('footer.phone')}</p>
+ *     </footer>
+ *   );
+ * }
+ * ```
+ */
+declare function useSiteContents(contentKeys: string[], options?: UseSiteContentsOptions): UseSiteContentsReturn;
+interface UseSiteContentSectionReturn {
+    /**
+     * List of contents in the section
+     */
+    contents: SiteContent[];
+    /**
+     * Whether contents are being loaded
+     */
+    isLoading: boolean;
+    /**
+     * Error if request failed
+     */
+    error: ApiError$1 | null;
+    /**
+     * Refetch section contents
+     */
+    refetch: () => Promise<void>;
+}
+/**
+ * Hook for fetching all content in a section.
+ *
+ * @example
+ * ```tsx
+ * function HeroSection() {
+ *   const { contents, isLoading } = useSiteContentSection('hero');
+ *
+ *   if (isLoading) return <div>Loading...</div>;
+ *
+ *   return (
+ *     <div>
+ *       {contents.map(content => (
+ *         <div key={content.contentKey}>{content.value}</div>
+ *       ))}
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+declare function useSiteContentSection(section: string): UseSiteContentSectionReturn;
+
+/**
+ * Edit-mode hooks for CMS Visual (iframe communication with Tenant Admin).
+ * When edit-mode=true is in the URL, the site enters edit mode and communicates
+ * with the parent iframe via postMessage.
+ */
+/** Query key used for site content; must match useSiteContentQuery. */
+declare const SITE_CONTENT_QUERY_KEY: "siteContent";
+/**
+ * Returns true when the page is in edit mode (URL has edit-mode=true).
+ * Used to show edit affordances and enable postMessage communication.
+ */
+declare function useEditMode(): boolean;
+/**
+ * Sets up edit-mode messaging: notifies parent when ready and listens for
+ * FOXPIXEL_CONTENT_UPDATED to invalidate the corresponding site content query.
+ * App must be wrapped in QueryClientProvider when using edit mode.
+ */
+declare function useEditModeMessaging(): boolean;
+/**
+ * Returns a callback to send an edit request to the parent iframe.
+ * Only has effect when in edit mode.
+ */
+declare function useSendEditRequest(): (contentKey: string, currentValue: string, contentType?: string, section?: string, description?: string) => void;
+
+/**
+ * React Query-based hook for site content used by Editable components.
+ * Uses queryKey ['siteContent', key] so that useEditModeMessaging can invalidate
+ * on FOXPIXEL_CONTENT_UPDATED. Requires QueryClientProvider.
+ */
+interface UseSiteContentQueryOptions {
+    defaultValue: string;
+}
+interface UseSiteContentQueryReturn {
+    value: string;
+    isLoading: boolean;
+    contentType: string;
+}
+/**
+ * Fetches a single site content by key using React Query. Used by Editable, EditableHTML, EditableImage.
+ * Invalidation is triggered by useEditModeMessaging when the parent sends FOXPIXEL_CONTENT_UPDATED.
+ */
+declare function useSiteContentQuery(contentKey: string, options: UseSiteContentQueryOptions): UseSiteContentQueryReturn;
+
 /**
  * Blog module types for FoxPixel SDK
  * Aligned with backend BlogPostResponse, BlogCategoryResponse, BlogTagResponse
@@ -675,6 +956,8 @@ interface UseNewsletterSubscribeReturn {
 declare function useNewsletterSubscribe(): UseNewsletterSubscribeReturn;
 interface UseNewsletterUnsubscribeReturn {
     unsubscribe: (email: string) => Promise<boolean>;
+    /** Cancelar inscrição pelo token (link no email de confirmação). */
+    unsubscribeByToken: (token: string) => Promise<boolean>;
     isSubmitting: boolean;
     error: ApiError$1 | null;
     success: boolean;
@@ -861,4 +1144,4 @@ interface BlogPostSchemaLdOptions {
  */
 declare function getBlogPostSchemaLd(post: BlogPost, options: BlogPostSchemaLdOptions): Record<string, unknown>;
 
-export { type ApiError$1 as ApiError, AuthProvider, type BlogAnalyticsSummary, type BlogAuthor, type BlogCategory, type BlogComment, type BlogCommentAdmin, type BlogCommentPage, type BlogPost, type BlogPostPage, type BlogPostSchemaLdOptions, type BlogPostStatus, type BlogSettings, type BlogTag, type CreateBlogCommentPayload, type CreateBlogPostPayload, type CreateCategoryPayload, type CreateLeadRequest, type CreateTagPayload, type EndUser, type EndUserLoginRequest, type FoxPixelConfig, FoxPixelHttpClient, FoxPixelProvider, GuestOnlyRoute, type Lead, type NewsletterFrequency, type NewsletterStats, type NewsletterStatus, type NewsletterSubscriber, type NewsletterSubscriberPage, type PostAnalyticsRow, ProtectedRoute, type Service, type ServiceCatalogResponse, type SubscribeNewsletterPayload, type UpdateBlogPostPayload, type UseAdminBlogAnalyticsReturn, type UseAdminBlogCategoriesReturn, type UseAdminBlogCommentsOptions, type UseAdminBlogCommentsReturn, type UseAdminBlogPostMutationsReturn, type UseAdminBlogPostReturn, type UseAdminBlogPostsOptions, type UseAdminBlogPostsReturn, type UseAdminBlogSettingsReturn, type UseAdminBlogTagsReturn, type UseAdminNewsletterStatsReturn, type UseAdminNewsletterSubscribersOptions, type UseAdminNewsletterSubscribersReturn, type UseBlogCategoriesReturn, type UseBlogCommentSubmitReturn, type UseBlogCommentsReturn, type UseBlogFeaturedPostsReturn, type UseBlogPostReturn, type UseBlogPostsOptions, type UseBlogPostsReturn, type UseBlogTagsReturn, type UseNewsletterSubscribeReturn, type UseNewsletterUnsubscribeReturn, getBlogPostSchemaLd, useAdminBlogAnalytics, useAdminBlogCategories, useAdminBlogComments, useAdminBlogPost, useAdminBlogPostMutations, useAdminBlogPosts, useAdminBlogSettings, useAdminBlogTags, useAdminNewsletterStats, useAdminNewsletterSubscribers, useAuth, useBlogCategories, useBlogCommentSubmit, useBlogComments, useBlogFeaturedPosts, useBlogPost, useBlogPosts, useBlogTags, useContactCapture, useFoxPixelContext, useLeadCapture, useNewsletterSubscribe, useNewsletterUnsubscribe, useServices, withAuth };
+export { type ApiError$1 as ApiError, AuthProvider, type BlogAnalyticsSummary, type BlogAuthor, type BlogCategory, type BlogComment, type BlogCommentAdmin, type BlogCommentPage, type BlogPost, type BlogPostPage, type BlogPostSchemaLdOptions, type BlogPostStatus, type BlogSettings, type BlogTag, type CreateBlogCommentPayload, type CreateBlogPostPayload, type CreateCategoryPayload, type CreateLeadRequest, type CreateTagPayload, Editable, EditableHTML, EditableImage, type EditableImageProps, type EditableProps, type EndUser, type EndUserLoginRequest, type FoxPixelConfig, FoxPixelHttpClient, FoxPixelProvider, GuestOnlyRoute, type Lead, type NewsletterFrequency, type NewsletterStats, type NewsletterStatus, type NewsletterSubscriber, type NewsletterSubscriberPage, type PostAnalyticsRow, ProtectedRoute, SITE_CONTENT_QUERY_KEY, type Service, type ServiceCatalogResponse, type SiteContent, type SubscribeNewsletterPayload, type UpdateBlogPostPayload, type UseAdminBlogAnalyticsReturn, type UseAdminBlogCategoriesReturn, type UseAdminBlogCommentsOptions, type UseAdminBlogCommentsReturn, type UseAdminBlogPostMutationsReturn, type UseAdminBlogPostReturn, type UseAdminBlogPostsOptions, type UseAdminBlogPostsReturn, type UseAdminBlogSettingsReturn, type UseAdminBlogTagsReturn, type UseAdminNewsletterStatsReturn, type UseAdminNewsletterSubscribersOptions, type UseAdminNewsletterSubscribersReturn, type UseBlogCategoriesReturn, type UseBlogCommentSubmitReturn, type UseBlogCommentsReturn, type UseBlogFeaturedPostsReturn, type UseBlogPostReturn, type UseBlogPostsOptions, type UseBlogPostsReturn, type UseBlogTagsReturn, type UseNewsletterSubscribeReturn, type UseNewsletterUnsubscribeReturn, type UseSiteContentOptions, type UseSiteContentQueryOptions, type UseSiteContentQueryReturn, type UseSiteContentReturn, type UseSiteContentSectionReturn, type UseSiteContentsOptions, type UseSiteContentsReturn, getBlogPostSchemaLd, useAdminBlogAnalytics, useAdminBlogCategories, useAdminBlogComments, useAdminBlogPost, useAdminBlogPostMutations, useAdminBlogPosts, useAdminBlogSettings, useAdminBlogTags, useAdminNewsletterStats, useAdminNewsletterSubscribers, useAuth, useBlogCategories, useBlogCommentSubmit, useBlogComments, useBlogFeaturedPosts, useBlogPost, useBlogPosts, useBlogTags, useContactCapture, useEditMode, useEditModeMessaging, useFoxPixelContext, useLeadCapture, useNewsletterSubscribe, useNewsletterUnsubscribe, useSendEditRequest, useServices, useSiteContent, useSiteContentQuery, useSiteContentSection, useSiteContents, withAuth };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { ReactNode, ComponentType } from 'react';
+import React, { ReactNode, ComponentType } from 'react';
 import { AxiosInstance, AxiosRequestConfig } from 'axios';
 
 /**
@@ -188,6 +188,8 @@ interface AuthContextValue {
         phone?: string;
     }) => Promise<void>;
     refetch: () => Promise<void>;
+    /** Stub: returns true when user is logged in and permission is site:content:update. */
+    hasPermission: (permission: string) => boolean;
 }
 interface AuthProviderProps {
     children: ReactNode;
@@ -261,6 +263,54 @@ interface WithAuthOptions {
 }
 declare function withAuth<P extends object>(Component: ComponentType<P>, options?: WithAuthOptions): (props: P) => string | number | true | Iterable<ReactNode> | react_jsx_runtime.JSX.Element | null;
 
+interface EditableProps {
+    contentKey: string;
+    defaultValue: string;
+    as?: keyof JSX.IntrinsicElements;
+    multiline?: boolean;
+    className?: string;
+}
+declare function Editable({ contentKey, defaultValue, as, multiline, className, }: EditableProps): React.ReactElement<{
+    className: string;
+    'aria-busy': boolean;
+    'aria-label': string;
+}, string | React.JSXElementConstructor<any>> | React.DOMElement<{
+    className: string;
+    'data-content-key': string;
+    'data-editable': string | undefined;
+    onClick: ((e: React.MouseEvent) => void) | undefined;
+    title: string | undefined;
+}, Element>;
+/**
+ * Renders rich HTML content from the CMS. Content is sanitized before rendering.
+ */
+declare function EditableHTML({ contentKey, defaultValue, as, className, }: Omit<EditableProps, 'multiline'>): React.ReactElement<{
+    className: string;
+    'aria-busy': boolean;
+}, string | React.JSXElementConstructor<any>> | React.DOMElement<{
+    className: string;
+    'data-content-key': string;
+    'data-editable': string | undefined;
+    onClick: ((e: React.MouseEvent) => void) | undefined;
+    title: string | undefined;
+    dangerouslySetInnerHTML: {
+        __html: string;
+    };
+}, Element>;
+interface EditableImageProps {
+    contentKey: string;
+    defaultValue: string;
+    alt: string;
+    className?: string;
+    width?: number;
+    height?: number;
+    priority?: boolean;
+}
+/**
+ * Renders an image from a CMS-managed URL. Uses native img (no Next.js Image in SDK).
+ */
+declare function EditableImage({ contentKey, defaultValue, alt, className, width, height, priority, }: EditableImageProps): react_jsx_runtime.JSX.Element;
+
 /**
  * Hook to fetch and manage services (Projects module)
  */
@@ -405,6 +455,237 @@ interface UseContactCaptureReturn {
  */
 declare function useContactCapture(): UseContactCaptureReturn;
 
+/**
+ * Hook for managing editable site content (CMS Visual)
+ *
+ * Allows non-developers to edit text content directly on the site.
+ */
+
+interface SiteContent {
+    id: string;
+    contentKey: string;
+    value: string | null;
+    contentType: string;
+    defaultValue: string | null;
+    description: string | null;
+    section: string | null;
+    sortOrder: number;
+    isActive: boolean;
+    updatedAt: string | null;
+}
+interface UseSiteContentOptions {
+    /**
+     * Default value to use if content is not found
+     */
+    defaultValue?: string;
+    /**
+     * Whether to fetch on mount (default: true)
+     */
+    fetchOnMount?: boolean;
+}
+interface UseSiteContentReturn {
+    /**
+     * The content object (null if not found or loading)
+     */
+    data: SiteContent | null;
+    /**
+     * The content value (or defaultValue if not found)
+     */
+    value: string;
+    /**
+     * Whether content is being loaded
+     */
+    isLoading: boolean;
+    /**
+     * Error if request failed
+     */
+    error: ApiError$1 | null;
+    /**
+     * Whether the current user can edit this content
+     */
+    canEdit: boolean;
+    /**
+     * Update the content value
+     */
+    update: (newValue: string) => Promise<void>;
+    /**
+     * Refetch the content
+     */
+    refetch: () => Promise<void>;
+}
+/**
+ * Hook for managing a single site content key.
+ *
+ * @example
+ * ```tsx
+ * function HeroSection() {
+ *   const { value, canEdit, update } = useSiteContent('hero.title', {
+ *     defaultValue: 'Welcome to our site'
+ *   });
+ *
+ *   const [isEditing, setIsEditing] = useState(false);
+ *   const [editValue, setEditValue] = useState(value);
+ *
+ *   const handleSave = async () => {
+ *     await update(editValue);
+ *     setIsEditing(false);
+ *   };
+ *
+ *   if (canEdit && isEditing) {
+ *     return (
+ *       <input
+ *         value={editValue}
+ *         onChange={(e) => setEditValue(e.target.value)}
+ *         onBlur={handleSave}
+ *       />
+ *     );
+ *   }
+ *
+ *   return (
+ *     <h1 onClick={() => canEdit && setIsEditing(true)}>
+ *       {value}
+ *     </h1>
+ *   );
+ * }
+ * ```
+ */
+declare function useSiteContent(contentKey: string, options?: UseSiteContentOptions): UseSiteContentReturn;
+interface UseSiteContentsOptions {
+    /**
+     * Default values map
+     */
+    defaults?: Record<string, string>;
+}
+interface UseSiteContentsReturn {
+    /**
+     * Map of content key to content object
+     */
+    data: Record<string, SiteContent>;
+    /**
+     * Get value by key (with default fallback)
+     */
+    getValue: (key: string, defaultValue?: string) => string;
+    /**
+     * Whether contents are being loaded
+     */
+    isLoading: boolean;
+    /**
+     * Error if request failed
+     */
+    error: ApiError$1 | null;
+    /**
+     * Refetch all contents
+     */
+    refetch: () => Promise<void>;
+}
+/**
+ * Hook for fetching multiple site content keys at once.
+ * More efficient than calling useSiteContent multiple times.
+ *
+ * @example
+ * ```tsx
+ * function Footer() {
+ *   const { getValue, isLoading } = useSiteContents(
+ *     ['footer.copyright', 'footer.address', 'footer.phone'],
+ *     { defaults: { 'footer.copyright': '© 2024' } }
+ *   );
+ *
+ *   if (isLoading) return null;
+ *
+ *   return (
+ *     <footer>
+ *       <p>{getValue('footer.copyright')}</p>
+ *       <p>{getValue('footer.address')}</p>
+ *       <p>{getValue('footer.phone')}</p>
+ *     </footer>
+ *   );
+ * }
+ * ```
+ */
+declare function useSiteContents(contentKeys: string[], options?: UseSiteContentsOptions): UseSiteContentsReturn;
+interface UseSiteContentSectionReturn {
+    /**
+     * List of contents in the section
+     */
+    contents: SiteContent[];
+    /**
+     * Whether contents are being loaded
+     */
+    isLoading: boolean;
+    /**
+     * Error if request failed
+     */
+    error: ApiError$1 | null;
+    /**
+     * Refetch section contents
+     */
+    refetch: () => Promise<void>;
+}
+/**
+ * Hook for fetching all content in a section.
+ *
+ * @example
+ * ```tsx
+ * function HeroSection() {
+ *   const { contents, isLoading } = useSiteContentSection('hero');
+ *
+ *   if (isLoading) return <div>Loading...</div>;
+ *
+ *   return (
+ *     <div>
+ *       {contents.map(content => (
+ *         <div key={content.contentKey}>{content.value}</div>
+ *       ))}
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+declare function useSiteContentSection(section: string): UseSiteContentSectionReturn;
+
+/**
+ * Edit-mode hooks for CMS Visual (iframe communication with Tenant Admin).
+ * When edit-mode=true is in the URL, the site enters edit mode and communicates
+ * with the parent iframe via postMessage.
+ */
+/** Query key used for site content; must match useSiteContentQuery. */
+declare const SITE_CONTENT_QUERY_KEY: "siteContent";
+/**
+ * Returns true when the page is in edit mode (URL has edit-mode=true).
+ * Used to show edit affordances and enable postMessage communication.
+ */
+declare function useEditMode(): boolean;
+/**
+ * Sets up edit-mode messaging: notifies parent when ready and listens for
+ * FOXPIXEL_CONTENT_UPDATED to invalidate the corresponding site content query.
+ * App must be wrapped in QueryClientProvider when using edit mode.
+ */
+declare function useEditModeMessaging(): boolean;
+/**
+ * Returns a callback to send an edit request to the parent iframe.
+ * Only has effect when in edit mode.
+ */
+declare function useSendEditRequest(): (contentKey: string, currentValue: string, contentType?: string, section?: string, description?: string) => void;
+
+/**
+ * React Query-based hook for site content used by Editable components.
+ * Uses queryKey ['siteContent', key] so that useEditModeMessaging can invalidate
+ * on FOXPIXEL_CONTENT_UPDATED. Requires QueryClientProvider.
+ */
+interface UseSiteContentQueryOptions {
+    defaultValue: string;
+}
+interface UseSiteContentQueryReturn {
+    value: string;
+    isLoading: boolean;
+    contentType: string;
+}
+/**
+ * Fetches a single site content by key using React Query. Used by Editable, EditableHTML, EditableImage.
+ * Invalidation is triggered by useEditModeMessaging when the parent sends FOXPIXEL_CONTENT_UPDATED.
+ */
+declare function useSiteContentQuery(contentKey: string, options: UseSiteContentQueryOptions): UseSiteContentQueryReturn;
+
 /**
  * Blog module types for FoxPixel SDK
  * Aligned with backend BlogPostResponse, BlogCategoryResponse, BlogTagResponse
@@ -675,6 +956,8 @@ interface UseNewsletterSubscribeReturn {
 declare function useNewsletterSubscribe(): UseNewsletterSubscribeReturn;
 interface UseNewsletterUnsubscribeReturn {
     unsubscribe: (email: string) => Promise<boolean>;
+    /** Cancelar inscrição pelo token (link no email de confirmação). */
+    unsubscribeByToken: (token: string) => Promise<boolean>;
     isSubmitting: boolean;
     error: ApiError$1 | null;
     success: boolean;
@@ -861,4 +1144,4 @@ interface BlogPostSchemaLdOptions {
  */
 declare function getBlogPostSchemaLd(post: BlogPost, options: BlogPostSchemaLdOptions): Record<string, unknown>;
 
-export { type ApiError$1 as ApiError, AuthProvider, type BlogAnalyticsSummary, type BlogAuthor, type BlogCategory, type BlogComment, type BlogCommentAdmin, type BlogCommentPage, type BlogPost, type BlogPostPage, type BlogPostSchemaLdOptions, type BlogPostStatus, type BlogSettings, type BlogTag, type CreateBlogCommentPayload, type CreateBlogPostPayload, type CreateCategoryPayload, type CreateLeadRequest, type CreateTagPayload, type EndUser, type EndUserLoginRequest, type FoxPixelConfig, FoxPixelHttpClient, FoxPixelProvider, GuestOnlyRoute, type Lead, type NewsletterFrequency, type NewsletterStats, type NewsletterStatus, type NewsletterSubscriber, type NewsletterSubscriberPage, type PostAnalyticsRow, ProtectedRoute, type Service, type ServiceCatalogResponse, type SubscribeNewsletterPayload, type UpdateBlogPostPayload, type UseAdminBlogAnalyticsReturn, type UseAdminBlogCategoriesReturn, type UseAdminBlogCommentsOptions, type UseAdminBlogCommentsReturn, type UseAdminBlogPostMutationsReturn, type UseAdminBlogPostReturn, type UseAdminBlogPostsOptions, type UseAdminBlogPostsReturn, type UseAdminBlogSettingsReturn, type UseAdminBlogTagsReturn, type UseAdminNewsletterStatsReturn, type UseAdminNewsletterSubscribersOptions, type UseAdminNewsletterSubscribersReturn, type UseBlogCategoriesReturn, type UseBlogCommentSubmitReturn, type UseBlogCommentsReturn, type UseBlogFeaturedPostsReturn, type UseBlogPostReturn, type UseBlogPostsOptions, type UseBlogPostsReturn, type UseBlogTagsReturn, type UseNewsletterSubscribeReturn, type UseNewsletterUnsubscribeReturn, getBlogPostSchemaLd, useAdminBlogAnalytics, useAdminBlogCategories, useAdminBlogComments, useAdminBlogPost, useAdminBlogPostMutations, useAdminBlogPosts, useAdminBlogSettings, useAdminBlogTags, useAdminNewsletterStats, useAdminNewsletterSubscribers, useAuth, useBlogCategories, useBlogCommentSubmit, useBlogComments, useBlogFeaturedPosts, useBlogPost, useBlogPosts, useBlogTags, useContactCapture, useFoxPixelContext, useLeadCapture, useNewsletterSubscribe, useNewsletterUnsubscribe, useServices, withAuth };
+export { type ApiError$1 as ApiError, AuthProvider, type BlogAnalyticsSummary, type BlogAuthor, type BlogCategory, type BlogComment, type BlogCommentAdmin, type BlogCommentPage, type BlogPost, type BlogPostPage, type BlogPostSchemaLdOptions, type BlogPostStatus, type BlogSettings, type BlogTag, type CreateBlogCommentPayload, type CreateBlogPostPayload, type CreateCategoryPayload, type CreateLeadRequest, type CreateTagPayload, Editable, EditableHTML, EditableImage, type EditableImageProps, type EditableProps, type EndUser, type EndUserLoginRequest, type FoxPixelConfig, FoxPixelHttpClient, FoxPixelProvider, GuestOnlyRoute, type Lead, type NewsletterFrequency, type NewsletterStats, type NewsletterStatus, type NewsletterSubscriber, type NewsletterSubscriberPage, type PostAnalyticsRow, ProtectedRoute, SITE_CONTENT_QUERY_KEY, type Service, type ServiceCatalogResponse, type SiteContent, type SubscribeNewsletterPayload, type UpdateBlogPostPayload, type UseAdminBlogAnalyticsReturn, type UseAdminBlogCategoriesReturn, type UseAdminBlogCommentsOptions, type UseAdminBlogCommentsReturn, type UseAdminBlogPostMutationsReturn, type UseAdminBlogPostReturn, type UseAdminBlogPostsOptions, type UseAdminBlogPostsReturn, type UseAdminBlogSettingsReturn, type UseAdminBlogTagsReturn, type UseAdminNewsletterStatsReturn, type UseAdminNewsletterSubscribersOptions, type UseAdminNewsletterSubscribersReturn, type UseBlogCategoriesReturn, type UseBlogCommentSubmitReturn, type UseBlogCommentsReturn, type UseBlogFeaturedPostsReturn, type UseBlogPostReturn, type UseBlogPostsOptions, type UseBlogPostsReturn, type UseBlogTagsReturn, type UseNewsletterSubscribeReturn, type UseNewsletterUnsubscribeReturn, type UseSiteContentOptions, type UseSiteContentQueryOptions, type UseSiteContentQueryReturn, type UseSiteContentReturn, type UseSiteContentSectionReturn, type UseSiteContentsOptions, type UseSiteContentsReturn, getBlogPostSchemaLd, useAdminBlogAnalytics, useAdminBlogCategories, useAdminBlogComments, useAdminBlogPost, useAdminBlogPostMutations, useAdminBlogPosts, useAdminBlogSettings, useAdminBlogTags, useAdminNewsletterStats, useAdminNewsletterSubscribers, useAuth, useBlogCategories, useBlogCommentSubmit, useBlogComments, useBlogFeaturedPosts, useBlogPost, useBlogPosts, useBlogTags, useContactCapture, useEditMode, useEditModeMessaging, useFoxPixelContext, useLeadCapture, useNewsletterSubscribe, useNewsletterUnsubscribe, useSendEditRequest, useServices, useSiteContent, useSiteContentQuery, useSiteContentSection, useSiteContents, withAuth };