reflet-sdk 0.1.5 → 0.3.0

package/dist/index.d.ts

@@ -1,297 +1,3 @@
-/**
- * Reflet SDK Types
- */
-interface RefletConfig {
-    /** Your organization's public API key (fb_pub_xxx) */
-    publicKey: string;
-    /** API base URL (optional, defaults to Reflet production API) */
-    baseUrl?: string;
-    /** User identification for SSO */
-    user?: RefletUser;
-    /** Pre-signed user token (alternative to user object) */
-    userToken?: string;
-}
-interface RefletUser {
-    /** Unique identifier for the user in your system */
-    id: string;
-    /** User's email address */
-    email?: string;
-    /** User's display name */
-    name?: string;
-    /** URL to user's avatar image */
-    avatar?: string;
-    /** Additional metadata */
-    metadata?: Record<string, unknown>;
-}
-interface OrganizationConfig {
-    id: string;
-    name: string;
-    slug: string;
-    description?: string;
-    isPublic: boolean;
-    settings?: OrganizationSettings;
-    logo?: string;
-    primaryColor?: string;
-    statuses: OrganizationStatus[];
-}
-interface OrganizationSettings {
-    allowAnonymousVoting?: boolean;
-    requireApproval?: boolean;
-    defaultStatus?: FeedbackStatus;
-}
-interface OrganizationStatus {
-    id: string;
-    name: string;
-    color: string;
-    icon?: string;
-    order: number;
-}
-type FeedbackStatus = "open" | "under_review" | "planned" | "in_progress" | "completed" | "closed";
-interface FeedbackItem {
-    id: string;
-    title: string;
-    description: string;
-    status: FeedbackStatus;
-    voteCount: number;
-    commentCount: number;
-    isPinned: boolean;
-    hasVoted: boolean;
-    createdAt: number;
-    updatedAt: number;
-    completedAt?: number;
-    tags: FeedbackTag[];
-    organizationStatus: {
-        id: string;
-        name: string;
-        color: string;
-    } | null;
-    author: FeedbackAuthor | null;
-}
-interface FeedbackDetail extends FeedbackItem {
-    isSubscribed: boolean;
-}
-interface FeedbackTag {
-    id: string;
-    name: string;
-    color: string;
-}
-interface FeedbackAuthor {
-    name?: string;
-    email?: string;
-    avatar?: string;
-    isExternal: boolean;
-}
-interface FeedbackListResponse {
-    items: FeedbackItem[];
-    total: number;
-    hasMore: boolean;
-}
-interface FeedbackListParams {
-    /** Filter by custom status ID */
-    statusId?: string;
-    /** Filter by status name */
-    status?: FeedbackStatus;
-    /** Search in title and description */
-    search?: string;
-    /** Sort order */
-    sortBy?: "votes" | "newest" | "oldest" | "comments";
-    /** Number of items to return (max 100) */
-    limit?: number;
-    /** Offset for pagination */
-    offset?: number;
-}
-interface CreateFeedbackParams {
-    title: string;
-    description: string;
-}
-interface CreateFeedbackResponse {
-    feedbackId: string;
-    isApproved: boolean;
-}
-interface VoteResponse {
-    voted: boolean;
-    voteCount: number;
-}
-interface Comment {
-    id: string;
-    body: string;
-    isOfficial: boolean;
-    author: FeedbackAuthor | null;
-    replies: CommentReply[];
-    createdAt: number;
-    updatedAt: number;
-}
-interface CommentReply {
-    id: string;
-    body: string;
-    isOfficial: boolean;
-    author: FeedbackAuthor | null;
-    createdAt: number;
-    updatedAt: number;
-}
-interface AddCommentParams {
-    feedbackId: string;
-    body: string;
-    parentId?: string;
-}
-interface AddCommentResponse {
-    commentId: string;
-}
-interface SubscribeResponse {
-    subscribed: boolean;
-    alreadySubscribed?: boolean;
-}
-interface UnsubscribeResponse {
-    unsubscribed: boolean;
-    wasNotSubscribed?: boolean;
-}
-interface Roadmap {
-    lanes: RoadmapLane[];
-}
-interface RoadmapLane {
-    id: string;
-    name: string;
-    color: string;
-    items: RoadmapItem[];
-}
-interface RoadmapItem {
-    id: string;
-    title: string;
-    status: FeedbackStatus;
-    voteCount: number;
-}
-interface ChangelogEntry {
-    id: string;
-    title: string;
-    description?: string;
-    version?: string;
-    publishedAt?: number;
-    feedback: {
-        id: string;
-        title: string;
-    }[];
-}
-declare class RefletError extends Error {
-    readonly status: number;
-    readonly code?: string;
-    constructor(message: string, status: number, code?: string);
-}
-declare class RefletAuthError extends RefletError {
-    constructor(message: string);
-}
-declare class RefletValidationError extends RefletError {
-    constructor(message: string);
-}
-declare class RefletNotFoundError extends RefletError {
-    constructor(message: string);
-}
-
-/**
- * Reflet SDK Client
- *
- * @example
- * ```ts
- * import { Reflet } from 'reflet-sdk';
- *
- * const reflet = new Reflet({
- *   publicKey: 'fb_pub_xxx',
- *   user: { id: 'user_123', email: 'user@example.com', name: 'John' }
- * });
- *
- * // List feedback
- * const { items } = await reflet.list({ status: 'open' });
- *
- * // Vote on feedback
- * await reflet.vote('feedback_id');
- *
- * // Submit new feedback
- * await reflet.create({ title: 'Great idea', description: 'Details...' });
- * ```
- */
-declare class Reflet {
-    private readonly publicKey;
-    private readonly baseUrl;
-    private userToken;
-    private user;
-    constructor(config: RefletConfig);
-    /**
-     * Update the user identification
-     */
-    setUser(user: RefletUser | undefined): void;
-    /**
-     * Set the user token directly (for server-signed tokens)
-     */
-    setUserToken(token: string | undefined): void;
-    /**
-     * Get the organization configuration
-     */
-    getConfig(): Promise<OrganizationConfig>;
-    /**
-     * List feedback items with optional filtering
-     */
-    list(params?: FeedbackListParams): Promise<FeedbackListResponse>;
-    /**
-     * Get a single feedback item by ID
-     */
-    get(feedbackId: string): Promise<FeedbackDetail>;
-    /**
-     * Create new feedback
-     * Requires user identification
-     */
-    create(params: CreateFeedbackParams): Promise<CreateFeedbackResponse>;
-    /**
-     * Toggle vote on feedback
-     * Requires user identification
-     */
-    vote(feedbackId: string, type?: "upvote" | "downvote"): Promise<VoteResponse>;
-    /**
-     * Get comments for a feedback item
-     */
-    getComments(feedbackId: string, sortBy?: "newest" | "oldest"): Promise<Comment[]>;
-    /**
-     * Add a comment to feedback
-     * Requires user identification
-     */
-    comment(params: AddCommentParams): Promise<AddCommentResponse>;
-    /**
-     * Subscribe to feedback updates
-     * Requires user identification
-     */
-    subscribe(feedbackId: string): Promise<SubscribeResponse>;
-    /**
-     * Unsubscribe from feedback updates
-     * Requires user identification
-     */
-    unsubscribe(feedbackId: string): Promise<UnsubscribeResponse>;
-    /**
-     * Get roadmap data
-     */
-    getRoadmap(): Promise<Roadmap>;
-    /**
-     * Get changelog entries
-     */
-    getChangelog(limit?: number): Promise<ChangelogEntry[]>;
-    /**
-     * Build request headers with authentication
-     */
-    private buildHeaders;
-    /**
-     * Parse JSON response text safely
-     */
-    private parseJsonSafely;
-    /**
-     * Throw appropriate error based on status code
-     */
-    private throwHttpError;
-    /**
-     * Make an authenticated API request
-     */
-    private request;
-    /**
-     * Generate a simple user token for client-side use
-     * Note: For production, use server-side token signing
-     */
-    private generateUserToken;
-}
-
-export { type AddCommentParams, type AddCommentResponse, type ChangelogEntry, type Comment, type CommentReply, type CreateFeedbackParams, type CreateFeedbackResponse, type FeedbackAuthor, type FeedbackDetail, type FeedbackItem, type FeedbackListParams, type FeedbackListResponse, type FeedbackStatus, type FeedbackTag, type OrganizationConfig, type OrganizationSettings, type OrganizationStatus, Reflet, RefletAuthError, type RefletConfig, RefletError, RefletNotFoundError, type RefletUser, RefletValidationError, type Roadmap, type RoadmapItem, type RoadmapLane, type SubscribeResponse, type UnsubscribeResponse, type VoteResponse };
+import { A as SubscribeResponse, C as RefletNotFoundError, D as RoadmapItem, E as Roadmap, M as VoteResponse, O as RoadmapLane, S as RefletError, T as RefletValidationError, _ as OrganizationConfig, a as CommentReply, b as RefletAuthError, d as FeedbackDetail, f as FeedbackItem, g as FeedbackTag, h as FeedbackStatus, i as Comment, j as UnsubscribeResponse, l as FeedbackAuthor, m as FeedbackListResponse, n as AddCommentResponse, 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";
+export { type AddCommentParams, type AddCommentResponse, type ChangelogEntry, type Comment, type CommentReply, type CreateFeedbackParams, type CreateFeedbackResponse, type FeedbackAuthor, type FeedbackDetail, type FeedbackItem, type FeedbackListParams, type FeedbackListResponse, type FeedbackStatus, type FeedbackTag, type OrganizationConfig, type OrganizationSettings, type OrganizationStatus, Reflet, RefletAuthError, type RefletConfig, RefletError, RefletNotFoundError, type RefletUser, RefletValidationError, type Roadmap, type RoadmapItem, type RoadmapLane, type SubscribeResponse, type UnsubscribeResponse, type VoteResponse };

package/dist/index.js

@@ -1,3 +1,2 @@
-export { Reflet, RefletAuthError, RefletError, RefletNotFoundError, RefletValidationError } from './chunk-GD7FQQBT.js';
-//# sourceMappingURL=index.js.map
-//# sourceMappingURL=index.js.map
+import { a as RefletValidationError, i as RefletNotFoundError, n as RefletAuthError, r as RefletError, t as Reflet } from "./client-BYuSKJw5.js";
+export { Reflet, RefletAuthError, RefletError, RefletNotFoundError, RefletValidationError };

package/dist/react-context-DZw_HHjj.js

@@ -0,0 +1,85 @@
+import { t as Reflet } from "./client-BYuSKJw5.js";
+import { createContext, useContext, useEffect, useMemo, useState } from "react";
+import { jsx } from "react/jsx-runtime";
+//#region src/react-context.tsx
+const RefletContext = createContext(null);
+/**
+* Provider component for Reflet SDK
+*
+* @example
+* ```tsx
+* import { RefletProvider } from 'reflet-sdk/react';
+*
+* function App() {
+*   return (
+*     <RefletProvider
+*       publicKey="fb_pub_xxx"
+*       user={{ id: 'user_123', email: 'user@example.com', name: 'John' }}
+*     >
+*       <YourApp />
+*     </RefletProvider>
+*   );
+* }
+* ```
+*/
+function RefletProvider({ publicKey, baseUrl, user: initialUser, userToken, children }) {
+	const [user, setUser] = useState(initialUser);
+	const [isReady, setIsReady] = useState(false);
+	const client = useMemo(() => {
+		return new Reflet({
+			baseUrl,
+			publicKey,
+			user,
+			userToken
+		});
+	}, [
+		publicKey,
+		baseUrl,
+		user,
+		userToken
+	]);
+	useEffect(() => {
+		if (userToken) client.setUserToken(userToken);
+		else client.setUser(user);
+	}, [
+		client,
+		user,
+		userToken
+	]);
+	useEffect(() => {
+		setIsReady(true);
+	}, []);
+	const value = useMemo(() => ({
+		baseUrl,
+		client,
+		isReady,
+		publicKey,
+		setUser,
+		user,
+		userToken
+	}), [
+		client,
+		publicKey,
+		baseUrl,
+		isReady,
+		user,
+		userToken
+	]);
+	return /* @__PURE__ */ jsx(RefletContext.Provider, {
+		value,
+		children
+	});
+}
+function useRefletContext() {
+	const context = useContext(RefletContext);
+	if (!context) throw new Error("useRefletContext must be used within a RefletProvider");
+	return context;
+}
+function useRefletClient() {
+	const { client } = useRefletContext();
+	return client;
+}
+//#endregion
+export { useRefletContext as i, RefletProvider as n, useRefletClient as r, RefletContext as t };
+
+//# sourceMappingURL=react-context-DZw_HHjj.js.map

package/dist/react-context-DZw_HHjj.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"react-context-DZw_HHjj.js","names":[],"sources":["../src/react-context.tsx"],"sourcesContent":["import {\n  createContext,\n  type ReactNode,\n  useContext,\n  useEffect,\n  useMemo,\n  useState,\n} from \"react\";\nimport { Reflet } from \"./client\";\nimport type { RefletConfig, RefletUser } from \"./types\";\n\n// ============================================\n// Context Types\n// ============================================\n\nexport interface RefletContextValue {\n  baseUrl?: string;\n  client: Reflet;\n  isReady: boolean;\n  publicKey: string;\n  setUser: (user: RefletUser | undefined) => void;\n  user: RefletUser | undefined;\n  userToken: string | undefined;\n}\n\n// ============================================\n// Context\n// ============================================\n\nexport const RefletContext = createContext<RefletContextValue | null>(null);\n\n// ============================================\n// Provider\n// ============================================\n\nexport interface RefletProviderProps {\n  /** API base URL (optional, defaults to Reflet production API) */\n  baseUrl?: string;\n  /** Children */\n  children: ReactNode;\n  /** Your organization's public API key */\n  publicKey: string;\n  /** Initial user identification */\n  user?: RefletUser;\n  /** Pre-signed user token (alternative to user) */\n  userToken?: string;\n}\n\n/**\n * Provider component for Reflet SDK\n *\n * @example\n * ```tsx\n * import { RefletProvider } from 'reflet-sdk/react';\n *\n * function App() {\n *   return (\n *     <RefletProvider\n *       publicKey=\"fb_pub_xxx\"\n *       user={{ id: 'user_123', email: 'user@example.com', name: 'John' }}\n *     >\n *       <YourApp />\n *     </RefletProvider>\n *   );\n * }\n * ```\n */\nexport function RefletProvider({\n  publicKey,\n  baseUrl,\n  user: initialUser,\n  userToken,\n  children,\n}: RefletProviderProps) {\n  const [user, setUser] = useState<RefletUser | undefined>(initialUser);\n  const [isReady, setIsReady] = useState(false);\n\n  const client = useMemo(() => {\n    const config: RefletConfig = {\n      baseUrl,\n      publicKey,\n      user,\n      userToken,\n    };\n    return new Reflet(config);\n  }, [publicKey, baseUrl, user, userToken]);\n\n  // Update client when user changes\n  useEffect(() => {\n    if (userToken) {\n      client.setUserToken(userToken);\n    } else {\n      client.setUser(user);\n    }\n  }, [client, user, userToken]);\n\n  // Mark as ready after mount\n  useEffect(() => {\n    setIsReady(true);\n  }, []);\n\n  const value = useMemo(\n    () => ({\n      baseUrl,\n      client,\n      isReady,\n      publicKey,\n      setUser,\n      user,\n      userToken,\n    }),\n    [client, publicKey, baseUrl, isReady, user, userToken]\n  );\n\n  return (\n    <RefletContext.Provider value={value}>{children}</RefletContext.Provider>\n  );\n}\n\n// ============================================\n// Hook to access context\n// ============================================\n\nexport function useRefletContext(): RefletContextValue {\n  const context = useContext(RefletContext);\n  if (!context) {\n    throw new Error(\"useRefletContext must be used within a RefletProvider\");\n  }\n  return context;\n}\n\nexport function useRefletClient(): Reflet {\n  const { client } = useRefletContext();\n  return client;\n}\n"],"mappings":";;;;AA6BA,MAAa,gBAAgB,cAAyC,IAAI;;;;;;;;;;;;;;;;;;;;AAsC1E,SAAgB,eAAe,EAC7B,WACA,SACA,MAAM,aACN,WACA,YACsB;CACtB,MAAM,CAAC,MAAM,WAAW,SAAiC,WAAW;CACpE,MAAM,CAAC,SAAS,cAAc,SAAS,KAAK;CAE5C,MAAM,SAAS,cAAc;EAO3B,OAAO,IAAI,OAAO;GALhB;GACA;GACA;GACA;EAEqB,CAAC;CAC1B,GAAG;EAAC;EAAW;EAAS;EAAM;CAAS,CAAC;CAGxC,gBAAgB;EACd,IAAI,WACF,OAAO,aAAa,SAAS;OAE7B,OAAO,QAAQ,IAAI;CAEvB,GAAG;EAAC;EAAQ;EAAM;CAAS,CAAC;CAG5B,gBAAgB;EACd,WAAW,IAAI;CACjB,GAAG,CAAC,CAAC;CAEL,MAAM,QAAQ,eACL;EACL;EACA;EACA;EACA;EACA;EACA;EACA;CACF,IACA;EAAC;EAAQ;EAAW;EAAS;EAAS;EAAM;CAAS,CACvD;CAEA,OACE,oBAAC,cAAc,UAAf;EAA+B;EAAQ;CAAiC,CAAA;AAE5E;AAMA,SAAgB,mBAAuC;CACrD,MAAM,UAAU,WAAW,aAAa;CACxC,IAAI,CAAC,SACH,MAAM,IAAI,MAAM,uDAAuD;CAEzE,OAAO;AACT;AAEA,SAAgB,kBAA0B;CACxC,MAAM,EAAE,WAAW,iBAAiB;CACpC,OAAO;AACT"}