@appgram/react 0.1.1 → 0.1.3

package/dist/hooks/index.d.mts

@@ -1,572 +1,3 @@
-import { W as WishFilters, b as Wish, c as Comment, k as CommentCreateInput, o as Roadmap, p as RoadmapColumn, d as Release, g as HelpArticle, H as HelpCollection, f as HelpFlow, h as SupportRequest, S as SupportRequestInput } from '../useVote-CLhkwtLT.mjs';
-export { U as UseVoteOptions, y as UseVoteResult, E as useVote } from '../useVote-CLhkwtLT.mjs';
-
-/**
- * useWishes Hook
- *
- * Fetches and manages a list of wishes with filtering and pagination.
- * Provides headless access to the wishes API for custom UI implementations.
- *
- * @example
- * ```tsx
- * import { useWishes } from '@appgram/react'
- *
- * function WishList() {
- *   const { wishes, isLoading, error, setFilters, refetch } = useWishes({
- *     filters: { sort_by: 'votes', status: 'pending' },
- *     refreshInterval: 30000,
- *   })
- *
- *   if (isLoading) return <Spinner />
- *   if (error) return <Error message={error} onRetry={refetch} />
- *
- *   return (
- *     <ul>
- *       {wishes.map(wish => (
- *         <li key={wish.id}>{wish.title}</li>
- *       ))}
- *     </ul>
- *   )
- * }
- * ```
- *
- * @example
- * ```tsx
- * // With search and pagination
- * function SearchableWishes() {
- *   const { wishes, isLoading, setFilters, page, totalPages, setPage } = useWishes()
- *
- *   const handleSearch = (query: string) => {
- *     setFilters({ search: query, page: 1 })
- *   }
- *
- *   return (
- *     <>
- *       <Search onSearch={handleSearch} />
- *       <WishGrid wishes={wishes} loading={isLoading} />
- *       <Pagination
- *         current={page}
- *         total={totalPages}
- *         onChange={setPage}
- *       />
- *     </>
- *   )
- * }
- * ```
- */
-
-interface UseWishesOptions {
-    /**
-     * Initial filters
-     */
-    filters?: WishFilters;
-    /**
-     * Auto-refresh interval in milliseconds (0 to disable)
-     * @default 0
-     */
-    refreshInterval?: number;
-    /**
-     * Skip initial fetch
-     * @default false
-     */
-    skip?: boolean;
-}
-interface UseWishesResult {
-    /**
-     * List of wishes
-     */
-    wishes: Wish[];
-    /**
-     * Loading state
-     */
-    isLoading: boolean;
-    /**
-     * Error message if any
-     */
-    error: string | null;
-    /**
-     * Total number of wishes
-     */
-    total: number;
-    /**
-     * Current page
-     */
-    page: number;
-    /**
-     * Total pages
-     */
-    totalPages: number;
-    /**
-     * Update filters
-     */
-    setFilters: (filters: WishFilters) => void;
-    /**
-     * Go to a specific page
-     */
-    setPage: (page: number) => void;
-    /**
-     * Manually refetch data
-     */
-    refetch: () => Promise<void>;
-}
-declare function useWishes(options?: UseWishesOptions): UseWishesResult;
-
-/**
- * useWish Hook
- *
- * Fetches and manages a single wish.
- */
-
-interface UseWishOptions {
-    /**
-     * The wish ID to fetch
-     */
-    wishId: string;
-    /**
-     * Skip initial fetch
-     * @default false
-     */
-    skip?: boolean;
-}
-interface UseWishResult {
-    /**
-     * The wish data
-     */
-    wish: Wish | null;
-    /**
-     * Loading state
-     */
-    isLoading: boolean;
-    /**
-     * Error message if any
-     */
-    error: string | null;
-    /**
-     * Manually refetch data
-     */
-    refetch: () => Promise<void>;
-}
-declare function useWish(options: UseWishOptions): UseWishResult;
-
-/**
- * useComments Hook
- *
- * Fetches and manages comments for a wish.
- */
-
-interface UseCommentsOptions {
-    /**
-     * The wish ID to fetch comments for
-     */
-    wishId: string;
-    /**
-     * Number of comments per page
-     * @default 20
-     */
-    perPage?: number;
-    /**
-     * Skip initial fetch
-     * @default false
-     */
-    skip?: boolean;
-}
-interface UseCommentsResult {
-    /**
-     * List of comments
-     */
-    comments: Comment[];
-    /**
-     * Loading state
-     */
-    isLoading: boolean;
-    /**
-     * Loading state for creating a comment
-     */
-    isCreating: boolean;
-    /**
-     * Error message if any
-     */
-    error: string | null;
-    /**
-     * Total number of comments
-     */
-    total: number;
-    /**
-     * Current page
-     */
-    page: number;
-    /**
-     * Total pages
-     */
-    totalPages: number;
-    /**
-     * Go to next page
-     */
-    nextPage: () => void;
-    /**
-     * Go to previous page
-     */
-    prevPage: () => void;
-    /**
-     * Go to specific page
-     */
-    setPage: (page: number) => void;
-    /**
-     * Create a new comment
-     */
-    createComment: (data: Omit<CommentCreateInput, 'wish_id'>) => Promise<Comment | null>;
-    /**
-     * Manually refetch data
-     */
-    refetch: () => Promise<void>;
-}
-declare function useComments(options: UseCommentsOptions): UseCommentsResult;
-
-/**
- * useRoadmap Hook
- *
- * Fetches and manages roadmap data for custom UI implementations.
- *
- * @example
- * ```tsx
- * import { useRoadmap } from '@appgram/react'
- *
- * function CustomRoadmap() {
- *   const { roadmap, isLoading, error, refetch } = useRoadmap({
- *     refreshInterval: 60000,
- *   })
- *
- *   if (isLoading) return <Skeleton />
- *   if (error) return <Error message={error} />
- *
- *   return (
- *     <div className="roadmap-columns">
- *       {roadmap?.columns.map(col => (
- *         <Column key={col.id} title={col.title} items={col.items} />
- *       ))}
- *     </div>
- *   )
- * }
- * ```
- */
-
-interface UseRoadmapOptions {
-    /**
-     * Auto-refresh interval in milliseconds (0 to disable)
-     * @default 0
-     */
-    refreshInterval?: number;
-    /**
-     * Skip initial fetch
-     * @default false
-     */
-    skip?: boolean;
-}
-interface UseRoadmapResult {
-    /**
-     * Roadmap data
-     */
-    roadmap: Roadmap | null;
-    /**
-     * Roadmap columns with items
-     */
-    columns: RoadmapColumn[];
-    /**
-     * Total number of items
-     */
-    totalItems: number;
-    /**
-     * Loading state
-     */
-    isLoading: boolean;
-    /**
-     * Error message if any
-     */
-    error: string | null;
-    /**
-     * Manually refetch data
-     */
-    refetch: () => Promise<void>;
-}
-declare function useRoadmap(options?: UseRoadmapOptions): UseRoadmapResult;
-
-/**
- * useReleases Hook
- *
- * Fetches and manages releases/changelog data for custom UI implementations.
- *
- * @example
- * ```tsx
- * import { useReleases } from '@appgram/react'
- *
- * function ChangelogList() {
- *   const { releases, isLoading, error, refetch } = useReleases({ limit: 10 })
- *
- *   if (isLoading) return <Spinner />
- *   if (error) return <Alert>{error}</Alert>
- *
- *   return (
- *     <ul className="changelog">
- *       {releases.map(release => (
- *         <li key={release.id}>
- *           <h3>{release.title}</h3>
- *           <time>{formatDate(release.published_at)}</time>
- *           <div dangerouslySetInnerHTML={{ __html: release.content }} />
- *         </li>
- *       ))}
- *     </ul>
- *   )
- * }
- * ```
- */
-
-interface UseReleasesOptions {
-    /**
-     * Maximum number of releases to fetch
-     * @default 50
-     */
-    limit?: number;
-    /**
-     * Skip initial fetch
-     * @default false
-     */
-    skip?: boolean;
-}
-interface UseReleasesResult {
-    /**
-     * List of releases
-     */
-    releases: Release[];
-    /**
-     * Loading state
-     */
-    isLoading: boolean;
-    /**
-     * Error message if any
-     */
-    error: string | null;
-    /**
-     * Manually refetch data
-     */
-    refetch: () => Promise<void>;
-}
-declare function useReleases(options?: UseReleasesOptions): UseReleasesResult;
-/**
- * useRelease Hook
- *
- * Fetches a single release by slug.
- */
-interface UseReleaseOptions {
-    /**
-     * The release slug to fetch
-     */
-    releaseSlug: string;
-    /**
-     * Skip initial fetch
-     * @default false
-     */
-    skip?: boolean;
-}
-interface UseReleaseResult {
-    /**
-     * The release data
-     */
-    release: Release | null;
-    /**
-     * Loading state
-     */
-    isLoading: boolean;
-    /**
-     * Error message if any
-     */
-    error: string | null;
-    /**
-     * Manually refetch data
-     */
-    refetch: () => Promise<void>;
-}
-declare function useRelease(options: UseReleaseOptions): UseReleaseResult;
-
-/**
- * useHelpCenter Hook
- *
- * Fetches and manages help center data.
- */
-
-interface UseHelpCenterOptions {
-    /**
-     * Skip initial fetch
-     * @default false
-     */
-    skip?: boolean;
-}
-interface UseHelpCenterResult {
-    /**
-     * Help collection
-     */
-    collection: HelpCollection | null;
-    /**
-     * Help flows
-     */
-    flows: HelpFlow[];
-    /**
-     * Loading state
-     */
-    isLoading: boolean;
-    /**
-     * Error message if any
-     */
-    error: string | null;
-    /**
-     * Manually refetch data
-     */
-    refetch: () => Promise<void>;
-}
-declare function useHelpCenter(options?: UseHelpCenterOptions): UseHelpCenterResult;
-/**
- * useHelpFlow Hook
- *
- * Fetches a single help flow by slug.
- */
-interface UseHelpFlowOptions {
-    /**
-     * The flow slug to fetch
-     */
-    flowSlug: string;
-    /**
-     * Skip initial fetch
-     * @default false
-     */
-    skip?: boolean;
-}
-interface UseHelpFlowResult {
-    /**
-     * The flow data
-     */
-    flow: HelpFlow | null;
-    /**
-     * Loading state
-     */
-    isLoading: boolean;
-    /**
-     * Error message if any
-     */
-    error: string | null;
-    /**
-     * Manually refetch data
-     */
-    refetch: () => Promise<void>;
-}
-declare function useHelpFlow(options: UseHelpFlowOptions): UseHelpFlowResult;
-/**
- * useHelpArticle Hook
- *
- * Fetches a single help article by slug.
- */
-interface UseHelpArticleOptions {
-    /**
-     * The article slug to fetch
-     */
-    articleSlug: string;
-    /**
-     * The flow ID the article belongs to
-     */
-    flowId: string;
-    /**
-     * Skip initial fetch
-     * @default false
-     */
-    skip?: boolean;
-}
-interface UseHelpArticleResult {
-    /**
-     * The article data
-     */
-    article: HelpArticle | null;
-    /**
-     * Loading state
-     */
-    isLoading: boolean;
-    /**
-     * Error message if any
-     */
-    error: string | null;
-    /**
-     * Manually refetch data
-     */
-    refetch: () => Promise<void>;
-}
-declare function useHelpArticle(options: UseHelpArticleOptions): UseHelpArticleResult;
-
-/**
- * useSupport Hook
- *
- * Manages support ticket submissions and access.
- */
-
-interface UseSupportOptions {
-    /**
-     * Callback when a ticket is successfully submitted
-     */
-    onSubmitSuccess?: (ticket: SupportRequest) => void;
-    /**
-     * Callback when a submission fails
-     */
-    onSubmitError?: (error: string) => void;
-}
-interface UseSupportResult {
-    /**
-     * Loading state for ticket submission
-     */
-    isSubmitting: boolean;
-    /**
-     * Loading state for magic link request
-     */
-    isSendingMagicLink: boolean;
-    /**
-     * Loading state for token verification
-     */
-    isVerifying: boolean;
-    /**
-     * Error message if any
-     */
-    error: string | null;
-    /**
-     * Success message after submitting
-     */
-    successMessage: string | null;
-    /**
-     * Submit a new support ticket
-     */
-    submitTicket: (data: SupportRequestInput) => Promise<SupportRequest | null>;
-    /**
-     * Request a magic link to access tickets
-     */
-    requestMagicLink: (email: string) => Promise<boolean>;
-    /**
-     * Verify a magic link token
-     */
-    verifyToken: (token: string) => Promise<{
-        tickets: SupportRequest[];
-        userEmail: string;
-    } | null>;
-    /**
-     * Get a specific ticket by ID with token
-     */
-    getTicket: (ticketId: string, token: string) => Promise<SupportRequest | null>;
-    /**
-     * Add a message to a ticket
-     */
-    addMessage: (ticketId: string, token: string, content: string) => Promise<{
-        id: string;
-        content: string;
-        created_at: string;
-    } | null>;
-    /**
-     * Clear any error or success messages
-     */
-    clearMessages: () => void;
-}
-declare function useSupport(options?: UseSupportOptions): UseSupportResult;
-
-export { type UseCommentsOptions, type UseCommentsResult, type UseHelpArticleOptions, type UseHelpArticleResult, type UseHelpCenterOptions, type UseHelpCenterResult, type UseHelpFlowOptions, type UseHelpFlowResult, type UseReleaseOptions, type UseReleaseResult, type UseReleasesOptions, type UseReleasesResult, type UseRoadmapOptions, type UseRoadmapResult, type UseSupportOptions, type UseSupportResult, type UseWishOptions, type UseWishResult, type UseWishesOptions, type UseWishesResult, useComments, useHelpArticle, useHelpCenter, useHelpFlow, useRelease, useReleases, useRoadmap, useSupport, useWish, useWishes };
+export { U as UseCommentsOptions, s as UseCommentsResult, t as UseContactFormOptions, u as UseContactFormResult, v as UseContactFormSubmitOptions, w as UseContactFormSubmitResult, x as UseHelpArticleOptions, y as UseHelpArticleResult, z as UseHelpCenterOptions, A as UseHelpCenterResult, B as UseHelpFlowOptions, D as UseHelpFlowResult, E as UseReleaseOptions, F as UseReleaseResult, G as UseReleasesOptions, H as UseReleasesResult, I as UseRoadmapOptions, J as UseRoadmapResult, K as UseStatusOptions, L as UseStatusResult, M as UseSupportOptions, N as UseSupportResult, O as UseSurveyOptions, P as UseSurveyResult, Q as UseSurveySubmitOptions, R as UseSurveySubmitResult, T as UseWishOptions, V as UseWishResult, W as UseWishesOptions, X as UseWishesResult, Y as useComments, Z as useContactForm, _ as useContactFormSubmit, $ as useHelpArticle, a0 as useHelpCenter, a1 as useHelpFlow, a2 as useRelease, a3 as useReleases, a4 as useRoadmap, a5 as useStatus, a6 as useSupport, a7 as useSurvey, a8 as useSurveySubmit, a9 as useWish, aa as useWishes } from '../index-X95JANOa.mjs';
+export { U as UseVoteOptions, L as UseVoteResult, Q as useVote } from '../StatusBoard-DhKRu-An.mjs';
+import 'react';