reflet-sdk 0.1.5 → 0.3.0

package/dist/react.d.ts

@@ -1,25 +1,72 @@
-import { RefletUser, Reflet, FeedbackListParams, AddCommentParams, ChangelogEntry, Comment, CreateFeedbackParams, FeedbackDetail, FeedbackItem, OrganizationConfig, Roadmap } from './index.js';
-export { FeedbackStatus, FeedbackTag, OrganizationSettings, OrganizationStatus, RefletConfig, RoadmapItem, RoadmapLane } from './index.js';
-import * as react_jsx_runtime from 'react/jsx-runtime';
-import { ReactNode } from 'react';
-
+import { D as RoadmapItem, E as Roadmap, O as RoadmapLane, _ as OrganizationConfig, d as FeedbackDetail, f as FeedbackItem, g as FeedbackTag, h as FeedbackStatus, i as Comment, o as CreateFeedbackParams, p as FeedbackListParams, r as ChangelogEntry, s as CreateFeedbackResponse, t as AddCommentParams, v as OrganizationSettings, w as RefletUser, x as RefletConfig, y as OrganizationStatus } from "./types-UKPPJGrA.js";
+import { t as Reflet } from "./client-CSyPxFPK.js";
+import { ReactNode } from "react";
+//#region src/react-changelog-widget.d.ts
+interface ChangelogWidgetProps {
+  autoOpenForNew?: boolean;
+  locale?: string;
+  maxEntries?: number;
+  mode?: "card" | "popup" | "trigger";
+  onClose?: () => void;
+  onEntryClick?: (entry: ChangelogEntry) => void;
+  onOpen?: () => void;
+  position?: "bottom-right" | "bottom-left";
+  primaryColor?: string;
+  publicKey: string;
+  theme?: "light" | "dark" | "auto";
+  triggerSelector?: string;
+}
+interface WidgetInstance {
+  close: () => void;
+  destroy: () => void;
+  getUnreadCount: () => number;
+  init: () => Promise<void>;
+  markAsRead: () => void;
+  open: () => void;
+}
+declare global {
+  interface Window {
+    RefletChangelogWidget?: new (config: ChangelogWidgetProps) => WidgetInstance;
+  }
+}
+/**
+ * React component that wraps the Reflet Changelog Widget.
+ *
+ * Dynamically loads and initializes a RefletChangelogWidget instance.
+ *
+ * @example
+ * ```tsx
+ * import { ChangelogWidget } from 'reflet-sdk/react';
+ *
+ * export function MyApp() {
+ *   return <ChangelogWidget publicKey="fb_pub_xxx" mode="card" theme="auto" />;
+ * }
+ * ```
+ */
+declare function ChangelogWidget({ publicKey, mode, position, theme, primaryColor, maxEntries, triggerSelector, autoOpenForNew, locale, onOpen, onClose, onEntryClick }: ChangelogWidgetProps): null;
+//#endregion
+//#region src/react-context.d.ts
 interface RefletContextValue {
-    client: Reflet;
-    isReady: boolean;
-    user: RefletUser | undefined;
-    setUser: (user: RefletUser | undefined) => void;
+  baseUrl?: string;
+  client: Reflet;
+  isReady: boolean;
+  publicKey: string;
+  setUser: (user: RefletUser | undefined) => void;
+  user: RefletUser | undefined;
+  userToken: string | undefined;
 }
+declare const RefletContext: import("react").Context<RefletContextValue | null>;
 interface RefletProviderProps {
-    /** Your organization's public API key */
-    publicKey: string;
-    /** API base URL (optional, defaults to Reflet production API) */
-    baseUrl?: string;
-    /** Initial user identification */
-    user?: RefletUser;
-    /** Pre-signed user token (alternative to user) */
-    userToken?: string;
-    /** Children */
-    children: ReactNode;
+  /** API base URL (optional, defaults to Reflet production API) */
+  baseUrl?: string;
+  /** Children */
+  children: ReactNode;
+  /** Your organization's public API key */
+  publicKey: string;
+  /** Initial user identification */
+  user?: RefletUser;
+  /** Pre-signed user token (alternative to user) */
+  userToken?: string;
 }
 /**
  * Provider component for Reflet SDK
@@ -40,65 +87,117 @@ interface RefletProviderProps {
  * }
  * ```
  */
-declare function RefletProvider({ publicKey, baseUrl, user: initialUser, userToken, children, }: RefletProviderProps): react_jsx_runtime.JSX.Element;
+declare function RefletProvider({ publicKey, baseUrl, user: initialUser, userToken, children }: RefletProviderProps): import("react").JSX.Element;
 declare function useRefletContext(): RefletContextValue;
 declare function useRefletClient(): Reflet;
-
+//#endregion
+//#region src/react-feedback-dialog-types.d.ts
+type FeedbackCategory = "feature" | "bug" | "question";
+interface FeedbackDialogLabels {
+  cancel?: string;
+  categoryBug?: string;
+  categoryFeature?: string;
+  categoryQuestion?: string;
+  descriptionPlaceholder?: string;
+  emailLabel?: string;
+  emailPlaceholder?: string;
+  required?: string;
+  submit?: string;
+  successMessage?: string;
+  successTitle?: string;
+  title?: string;
+  titlePlaceholder?: string;
+}
+interface FeedbackDialogProps {
+  /** API base URL override */
+  baseUrl?: string;
+  /** Categories to show (default: all three) */
+  categories?: FeedbackCategory[];
+  /** Default selected category */
+  defaultCategory?: FeedbackCategory;
+  /** Custom labels / i18n */
+  labels?: FeedbackDialogLabels;
+  /** Called when dialog closes */
+  onClose?: () => void;
+  /** Called when dialog opens */
+  onOpen?: () => void;
+  /** Callback when open state changes */
+  onOpenChange: (open: boolean) => void;
+  /** Called after successful submission */
+  onSubmit?: (result: CreateFeedbackResponse) => void;
+  /** Whether the dialog is open */
+  open: boolean;
+  /** Primary brand color (CSS value) */
+  primaryColor?: string;
+  /** Public API key (falls back to RefletProvider context) */
+  publicKey?: string;
+  /** Color theme */
+  theme?: "light" | "dark" | "auto";
+  /** User identification (falls back to RefletProvider context) */
+  user?: RefletUser;
+  /** Pre-signed user token */
+  userToken?: string;
+}
+//#endregion
+//#region src/react-feedback-dialog.d.ts
+declare function FeedbackDialog({ open, onOpenChange, publicKey, baseUrl, user, userToken, theme, primaryColor, defaultCategory, categories, labels: labelsProp, onSubmit, onOpen, onClose }: FeedbackDialogProps): import("react").JSX.Element | null;
+//#endregion
+//#region src/react-feedback-button.d.ts
+interface FeedbackButtonProps {
+  /**
+   * Render as child element instead of the default button.
+   * When true, the first child element receives the onClick handler.
+   */
+  asChild?: boolean;
+  /** API base URL override */
+  baseUrl?: string;
+  /** Categories to show */
+  categories?: FeedbackCategory[];
+  /** Custom trigger content or element (used with asChild) */
+  children?: ReactNode;
+  /** Custom CSS class for the default trigger button */
+  className?: string;
+  /** Default selected category */
+  defaultCategory?: FeedbackCategory;
+  /** Custom labels / i18n */
+  labels?: FeedbackDialogLabels & {
+    trigger?: string;
+  };
+  /** Called when dialog closes */
+  onClose?: () => void;
+  /** Called when dialog opens */
+  onOpen?: () => void;
+  /** Called after successful submission */
+  onSubmit?: (result: CreateFeedbackResponse) => void;
+  /** Primary brand color (CSS value) */
+  primaryColor?: string;
+  /** Public API key (falls back to RefletProvider context) */
+  publicKey?: string;
+  /** Color theme */
+  theme?: "light" | "dark" | "auto";
+  /** User identification (falls back to RefletProvider context) */
+  user?: RefletUser;
+  /** Pre-signed user token */
+  userToken?: string;
+}
+declare function FeedbackButton({ publicKey, baseUrl, user, userToken, theme, primaryColor, defaultCategory, categories, labels, onSubmit, onOpen, onClose, className, asChild, children }: FeedbackButtonProps): import("react").JSX.Element;
+//#endregion
+//#region src/react-hooks-types.d.ts
 interface UseQueryResult<T> {
-    data: T | undefined;
-    isLoading: boolean;
-    error: Error | null;
-    refetch: () => Promise<void>;
+  data: T | undefined;
+  error: Error | null;
+  isLoading: boolean;
+  refetch: () => Promise<void>;
 }
 interface UseMutationResult<TData, TVariables> {
-    mutate: (variables: TVariables) => Promise<TData>;
-    isLoading: boolean;
-    error: Error | null;
-    data: TData | undefined;
-    reset: () => void;
+  data: TData | undefined;
+  error: Error | null;
+  isLoading: boolean;
+  mutate: (variables: TVariables) => Promise<TData>;
+  reset: () => void;
 }
-/**
- * Hook to fetch organization configuration
- */
-declare function useOrganizationConfig(): UseQueryResult<OrganizationConfig>;
-interface UseFeedbackListOptions extends FeedbackListParams {
-    /** Auto-fetch on mount */
-    enabled?: boolean;
-}
-/**
- * Hook to fetch feedback list with filtering
- *
- * @example
- * ```tsx
- * const { data, isLoading } = useFeedbackList({ status: 'open', sortBy: 'votes' });
- * ```
- */
-declare function useFeedbackList(options?: UseFeedbackListOptions): UseQueryResult<{
-    items: FeedbackItem[];
-    total: number;
-    hasMore: boolean;
-}>;
-/**
- * Hook to fetch a single feedback item
- *
- * @example
- * ```tsx
- * const { data: feedback, isLoading } = useFeedback('feedback_id');
- * ```
- */
-declare function useFeedback(feedbackId: string | undefined): UseQueryResult<FeedbackDetail>;
-/**
- * Hook to fetch comments for a feedback item
- */
-declare function useComments(feedbackId: string | undefined, sortBy?: "newest" | "oldest"): UseQueryResult<Comment[]>;
-/**
- * Hook to fetch roadmap data
- */
-declare function useRoadmap(): UseQueryResult<Roadmap>;
-/**
- * Hook to fetch changelog entries
- */
-declare function useChangelog(limit?: number): UseQueryResult<ChangelogEntry[]>;
+//#endregion
+//#region src/react-mutation-hooks.d.ts
 /**
  * Hook to create new feedback
  *
@@ -113,8 +212,8 @@ declare function useChangelog(limit?: number): UseQueryResult<ChangelogEntry[]>;
  * ```
  */
 declare function useCreateFeedback(): UseMutationResult<{
-    feedbackId: string;
-    isApproved: boolean;
+  feedbackId: string;
+  isApproved: boolean;
 }, CreateFeedbackParams>;
 /**
  * Hook to vote on feedback
@@ -129,30 +228,50 @@ declare function useCreateFeedback(): UseMutationResult<{
  * ```
  */
 declare function useVote(): UseMutationResult<{
-    voted: boolean;
-    voteCount: number;
+  voted: boolean;
+  voteCount: number;
 }, {
-    feedbackId: string;
-    type?: "upvote" | "downvote";
+  feedbackId: string;
+  type?: "upvote" | "downvote";
 }>;
 /**
  * Hook to add a comment
  */
 declare function useAddComment(): UseMutationResult<{
-    commentId: string;
+  commentId: string;
 }, AddCommentParams>;
 /**
  * Hook to subscribe/unsubscribe to feedback
  */
 declare function useSubscription(): {
-    subscribe: (feedbackId: string) => Promise<{
-        subscribed: boolean;
-    }>;
-    unsubscribe: (feedbackId: string) => Promise<{
-        unsubscribed: boolean;
-    }>;
-    isLoading: boolean;
-    error: Error | null;
+  subscribe: (feedbackId: string) => Promise<{
+    subscribed: boolean;
+  }>;
+  unsubscribe: (feedbackId: string) => Promise<{
+    unsubscribed: boolean;
+  }>;
+  isLoading: boolean;
+  error: Error | null;
+};
+//#endregion
+//#region src/react-query-hooks.d.ts
+declare function useOrganizationConfig(): UseQueryResult<OrganizationConfig>;
+interface UseFeedbackListOptions extends FeedbackListParams {
+  enabled?: boolean;
+}
+declare function useFeedbackList(options?: UseFeedbackListOptions): UseQueryResult<{
+  items: FeedbackItem[];
+  total: number;
+  hasMore: boolean;
+}>;
+declare function useFeedback(feedbackId: string | undefined): UseQueryResult<FeedbackDetail>;
+declare function useComments(feedbackId: string | undefined, sortBy?: "newest" | "oldest"): UseQueryResult<Comment[]>;
+declare function useRoadmap(): UseQueryResult<Roadmap>;
+declare function useChangelog(limit?: number): UseQueryResult<ChangelogEntry[]>;
+declare function useUnreadChangelogCount(publicKey: string): {
+  unreadCount: number;
+  markAsRead: () => void;
 };
-
-export { AddCommentParams, ChangelogEntry, Comment, CreateFeedbackParams, FeedbackDetail, FeedbackItem, FeedbackListParams, OrganizationConfig, Reflet, RefletProvider, type RefletProviderProps, RefletUser, Roadmap, type UseFeedbackListOptions, useAddComment, useChangelog, useComments, useCreateFeedback, useFeedback, useFeedbackList, useOrganizationConfig, useRefletClient, useRefletContext, useRoadmap, useSubscription, useVote };
+//#endregion
+export { type AddCommentParams, type ChangelogEntry, ChangelogWidget, type Comment, type CreateFeedbackParams, FeedbackButton, type FeedbackButtonProps, type FeedbackCategory, type FeedbackDetail, FeedbackDialog, type FeedbackDialogLabels, type FeedbackDialogProps, type FeedbackItem, type FeedbackListParams, type FeedbackStatus, type FeedbackTag, type OrganizationConfig, type OrganizationSettings, type OrganizationStatus, Reflet, type RefletConfig, RefletContext, type RefletContextValue, RefletProvider, type RefletProviderProps, type RefletUser, type Roadmap, type RoadmapItem, type RoadmapLane, type UseFeedbackListOptions, useAddComment, useChangelog, useComments, useCreateFeedback, useFeedback, useFeedbackList, useOrganizationConfig, useRefletClient, useRefletContext, useRoadmap, useSubscription, useUnreadChangelogCount, useVote };
+//# sourceMappingURL=react.d.ts.map

package/dist/react.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.d.ts","names":[],"sources":["../src/react-changelog-widget.tsx","../src/react-context.tsx","../src/react-feedback-dialog-types.ts","../src/react-feedback-dialog.tsx","../src/react-feedback-button.tsx","../src/react-hooks-types.ts","../src/react-mutation-hooks.ts","../src/react-query-hooks.ts"],"mappings":";;;;UAGU;EACR;EACA;EACA;EACA;EACA;EACA,gBAAgB,OAAO;EACvB;EACA;EACA;EACA;EACA;EACA;;UAGQ;EACR;EACA;EACA;EACA,YAAY;EACZ;EACA;;QAGM;YACI;IACR,6BACE,QAAQ,yBACL;;;;;;;;;;;;;;;;;iBAkBO,kBACd,WACA,MACA,UACA,OACA,cACA,YACA,iBACA,gBACA,QACA,QACA,SACA,gBACC;;;UC/Cc;EACf;EACA,QAAQ;EACR;EACA;EACA,UAAU,MAAM;EAChB,MAAM;EACN;;cAOW,+BAAa,QAAA;UAMT;;EAEf;;EAEA,UAAU;;EAEV;;EAEA,OAAO;;EAEP;;;;;;;;;;;;;;;;;;;;;iBAsBc,iBACd,WACA,SACA,MAAM,aACN,WACA,YACC,sCAAmB,IAAA;iBAkDN,oBAAoB;iBAQpB,mBAAmB;;;KCjIvB;UAEK;EACf;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;UAGe;;EAEf;;EAEA,aAAa;;EAEb,kBAAkB;;EAElB,SAAS;;EAET;;EAEA;;EAEA,eAAe;;EAEf,YAAY,QAAQ;;EAEpB;;EAEA;;EAEA;;EAEA;;EAEA,OAAO;;EAEP;;;;iBCnCc,iBACd,MACA,cACA,WACA,SACA,MACA,WACA,OACA,cACA,iBACA,YACA,QAAQ,YACR,UACA,QACA,WACC,sCAAmB,IAAA;;;UCRL;;;;;EAKf;;EAEA;;EAEA,aAAa;;EAEb,WAAW;;EAEX;;EAEA,kBAAkB;;EAElB,SAAS;IAAyB;;;EAElC;;EAEA;;EAEA,YAAY,QAAQ;;EAEpB;;EAEA;;EAEA;;EAEA,OAAO;;EAEP;;iBA6Bc,iBACd,WACA,SACA,MACA,WACA,OACA,cACA,iBACA,YACA,QACA,UACA,QACA,SACA,WACA,SACA,YACC,sCAAmB,IAAA;;;UClGL,eAAe;EAC9B,MAAM;EACN,OAAO;EACP;EACA,eAAe;;UAGA,kBAAkB,OAAO;EACxC,MAAM;EACN,OAAO;EACP;EACA,SAAS,WAAW,eAAe,QAAQ;EAC3C;;;;;;;;;;;;;;;;;iBCiDc,qBAAqB;EACjC;EAAoB;GACtB;;;;;;;;;;;;;iBA0Bc,WAAW;EACvB;EAAgB;;EAChB;EAAoB;;;;;iBAuBR,iBAAiB;EAC7B;GACF;;;;iBAiBc;EACd,YAAY,uBAAuB;IAAU;;EAC7C,cAAc,uBAAuB;IAAU;;EAC/C;EACA,OAAO;;;;iBCtFO,yBAAyB,eAAe;UAUvC,+BAA+B;EAC9C;;iBAGc,gBACd,UAAS,yBACR;EAAiB,OAAO;EAAgB;EAAe;;iBAyB1C,YACd,iCACC,eAAe;iBAiBF,YACd,gCACA,+BACC,eAAe;iBAiBF,cAAc,eAAe;iBAU7B,aAAa,iBAAiB,eAAe;iBAe7C,wBAAwB;EACtC;EACA"}