reflet-sdk 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,29 @@
+# Changelog
+
+All notable changes to `reflet-sdk` will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.1.0] - 2025-01-30
+
+### Added
+
+- Initial release of the Reflet SDK
+- **Core Client** (`reflet-sdk`)
+  - `Reflet` class for direct API interaction
+  - Full TypeScript support with comprehensive types
+  - Methods: `list`, `get`, `create`, `vote`, `comment`, `subscribe`, `unsubscribe`
+  - Board configuration and roadmap/changelog fetching
+  - Custom error classes: `RefletError`, `RefletAuthError`, `RefletNotFoundError`, `RefletValidationError`
+
+- **React Bindings** (`reflet-sdk/react`)
+  - `RefletProvider` for app-wide configuration
+  - Query hooks: `useFeedbackList`, `useFeedback`, `useComments`, `useBoardConfig`, `useRoadmap`, `useChangelog`
+  - Mutation hooks: `useCreateFeedback`, `useVote`, `useAddComment`, `useSubscription`
+  - Built-in loading, error, and refetch states
+
+- **Server Utilities** (`reflet-sdk/server`)
+  - `signUser` function for secure JWT token generation
+  - `verifyUser` function for token validation
+  - Server-side user signing for production security

package/README.md

@@ -0,0 +1,342 @@
+# reflet-sdk
+
+Official SDK for integrating Reflet feedback collection into your application. Collect user feedback, feature requests, and bug reports directly from your app.
+
+## Installation
+
+```bash
+npm install reflet-sdk
+# or
+yarn add reflet-sdk
+# or
+pnpm add reflet-sdk
+# or
+bun add reflet-sdk
+```
+
+## Quick Start
+
+### 1. Get Your API Keys
+
+Go to your Reflet dashboard → Board Settings → API Keys & Widget to generate your keys:
+
+- **Public Key** (`fb_pub_...`) - Safe to use in frontend code
+- **Secret Key** (`fb_sec_...`) - Keep secure, use only on your server
+
+### 2. Basic Usage (Vanilla JavaScript/TypeScript)
+
+```typescript
+import { Reflet } from 'reflet-sdk';
+
+const reflet = new Reflet({
+  publicKey: 'fb_pub_your_key_here',
+  user: {
+    id: 'user_123',
+    email: 'jane@example.com',
+    name: 'Jane Doe',
+  },
+});
+
+// List feedback
+const { items } = await reflet.list({ status: 'open' });
+
+// Get single feedback with comments
+const feedback = await reflet.get('feedback_id');
+
+// Create new feedback
+const { feedbackId } = await reflet.create({
+  title: 'Dark mode support',
+  description: 'Would love to have a dark theme option!',
+});
+
+// Vote on feedback
+await reflet.vote('feedback_id');
+
+// Add a comment
+await reflet.comment({
+  feedbackId: 'feedback_id',
+  body: 'This would be amazing!',
+});
+```
+
+### 3. React Usage
+
+```tsx
+import { RefletProvider, useFeedbackList, useVote, useCreateFeedback } from 'reflet-sdk/react';
+
+// Wrap your app with the provider
+function App() {
+  const currentUser = useCurrentUser(); // Your auth system
+
+  return (
+    <RefletProvider
+      publicKey="fb_pub_your_key_here"
+      user={currentUser}
+    >
+      <FeedbackPage />
+    </RefletProvider>
+  );
+}
+
+// Use hooks in your components
+function FeedbackPage() {
+  const { data, isLoading, error } = useFeedbackList({ sortBy: 'votes' });
+  const { mutate: vote } = useVote();
+  const { mutate: createFeedback } = useCreateFeedback();
+
+  if (isLoading) return <div>Loading...</div>;
+  if (error) return <div>Error: {error.message}</div>;
+
+  return (
+    <div>
+      {data?.items.map((item) => (
+        <div key={item.id}>
+          <h3>{item.title}</h3>
+          <p>{item.description}</p>
+          <button onClick={() => vote({ feedbackId: item.id })}>
+            {item.hasVoted ? 'Voted' : 'Vote'} ({item.voteCount})
+          </button>
+        </div>
+      ))}
+    </div>
+  );
+}
+```
+
+### 4. Server-Side User Signing (Most Secure)
+
+For production apps, sign user tokens on your server to prevent spoofing:
+
+```typescript
+// On your server (Next.js API route, Express, etc.)
+import { signUser } from 'reflet-sdk/server';
+
+export async function getUserToken(user: User) {
+  const { token, expiresAt } = signUser(
+    {
+      id: user.id,
+      email: user.email,
+      name: user.name,
+      avatar: user.avatarUrl,
+    },
+    process.env.REFLET_SECRET_KEY!
+  );
+
+  return { token, expiresAt };
+}
+```
+
+```tsx
+// On the client
+import { Reflet } from 'reflet-sdk';
+
+const reflet = new Reflet({
+  publicKey: 'fb_pub_your_key_here',
+  userToken: tokenFromServer, // JWT from your server
+});
+```
+
+## API Reference
+
+### `Reflet` Client
+
+```typescript
+const reflet = new Reflet(config: RefletConfig);
+```
+
+#### Configuration
+
+| Option | Type | Required | Description |
+|--------|------|----------|-------------|
+| `publicKey` | `string` | Yes | Your board's public API key |
+| `user` | `RefletUser` | No | User information for identification |
+| `userToken` | `string` | No | Signed JWT from your server (alternative to `user`) |
+| `baseUrl` | `string` | No | Custom API endpoint |
+
+#### Methods
+
+| Method | Description |
+|--------|-------------|
+| `list(params?)` | List feedback with optional filtering |
+| `get(feedbackId)` | Get single feedback with full details |
+| `create(params)` | Submit new feedback |
+| `vote(feedbackId, type?)` | Vote on feedback (toggle) |
+| `comment(params)` | Add a comment |
+| `subscribe(feedbackId)` | Subscribe to updates |
+| `unsubscribe(feedbackId)` | Unsubscribe from updates |
+| `getConfig()` | Get board configuration |
+| `getRoadmap()` | Get roadmap data |
+| `getChangelog(limit?)` | Get changelog entries |
+
+### React Hooks
+
+| Hook | Description |
+|------|-------------|
+| `useFeedbackList(options?)` | Fetch feedback list with filters |
+| `useFeedback(feedbackId)` | Fetch single feedback item |
+| `useComments(feedbackId)` | Fetch comments for feedback |
+| `useVote()` | Vote mutation hook |
+| `useCreateFeedback()` | Create feedback mutation hook |
+| `useAddComment()` | Add comment mutation hook |
+| `useSubscription()` | Subscribe/unsubscribe hooks |
+| `useBoardConfig()` | Fetch board configuration |
+| `useRoadmap()` | Fetch roadmap data |
+| `useChangelog(limit?)` | Fetch changelog entries |
+
+### Server Utilities
+
+```typescript
+import { signUser, verifyUser } from 'reflet-sdk/server';
+
+// Sign a user token
+const { token, expiresAt } = signUser(user, secretKey, expiresInSeconds?);
+
+// Verify a token (optional - server-side validation)
+const user = verifyUser(token, secretKey);
+```
+
+## Types
+
+```typescript
+interface RefletUser {
+  id: string;
+  email?: string;
+  name?: string;
+  avatar?: string;
+}
+
+interface FeedbackItem {
+  id: string;
+  title: string;
+  description: string;
+  status: FeedbackStatus;
+  voteCount: number;
+  commentCount: number;
+  hasVoted: boolean;
+  author?: FeedbackAuthor;
+  tags: FeedbackTag[];
+  createdAt: string;
+}
+
+interface FeedbackDetail extends FeedbackItem {
+  isSubscribed: boolean;
+  comments: Comment[];
+}
+
+type FeedbackStatus =
+  | 'open'
+  | 'under_review'
+  | 'planned'
+  | 'in_progress'
+  | 'completed'
+  | 'closed';
+```
+
+## Error Handling
+
+The SDK provides typed errors for better error handling:
+
+```typescript
+import { RefletError, RefletAuthError, RefletNotFoundError } from 'reflet-sdk';
+
+try {
+  await reflet.vote('invalid_id');
+} catch (error) {
+  if (error instanceof RefletNotFoundError) {
+    console.log('Feedback not found');
+  } else if (error instanceof RefletAuthError) {
+    console.log('Authentication required');
+  } else if (error instanceof RefletError) {
+    console.log('API error:', error.message);
+  }
+}
+```
+
+## Examples
+
+### Feedback Widget Component
+
+```tsx
+import { RefletProvider, useFeedbackList, useCreateFeedback, useVote } from 'reflet-sdk/react';
+import { useState } from 'react';
+
+function FeedbackWidget() {
+  const [isOpen, setIsOpen] = useState(false);
+  const { data, refetch } = useFeedbackList({ limit: 5, sortBy: 'votes' });
+  const { mutate: createFeedback, isLoading } = useCreateFeedback();
+  const { mutate: vote } = useVote();
+  const [title, setTitle] = useState('');
+
+  const handleSubmit = async (e: React.FormEvent) => {
+    e.preventDefault();
+    await createFeedback({ title, description: '' });
+    setTitle('');
+    refetch();
+  };
+
+  return (
+    <div className="feedback-widget">
+      <button onClick={() => setIsOpen(!isOpen)}>
+        Feedback
+      </button>
+
+      {isOpen && (
+        <div className="feedback-panel">
+          <form onSubmit={handleSubmit}>
+            <input
+              value={title}
+              onChange={(e) => setTitle(e.target.value)}
+              placeholder="What's on your mind?"
+            />
+            <button type="submit" disabled={isLoading}>
+              Submit
+            </button>
+          </form>
+
+          <ul>
+            {data?.items.map((item) => (
+              <li key={item.id}>
+                <button onClick={() => vote({ feedbackId: item.id })}>
+                  {item.voteCount}
+                </button>
+                <span>{item.title}</span>
+              </li>
+            ))}
+          </ul>
+        </div>
+      )}
+    </div>
+  );
+}
+```
+
+### Next.js App Router Integration
+
+```tsx
+// app/providers.tsx
+'use client';
+
+import { RefletProvider } from 'reflet-sdk/react';
+import { useSession } from 'next-auth/react';
+
+export function Providers({ children }: { children: React.ReactNode }) {
+  const { data: session } = useSession();
+
+  return (
+    <RefletProvider
+      publicKey={process.env.NEXT_PUBLIC_REFLET_KEY!}
+      user={session?.user ? {
+        id: session.user.id,
+        email: session.user.email!,
+        name: session.user.name!,
+      } : undefined}
+    >
+      {children}
+    </RefletProvider>
+  );
+}
+```
+
+## License
+
+MIT

package/dist/chunk-RDQP4VCA.js

@@ -0,0 +1,241 @@
+// src/types.ts
+var RefletError = class extends Error {
+  status;
+  code;
+  constructor(message, status, code) {
+    super(message);
+    this.name = "RefletError";
+    this.status = status;
+    this.code = code;
+  }
+};
+var RefletAuthError = class extends RefletError {
+  constructor(message) {
+    super(message, 401, "AUTH_ERROR");
+    this.name = "RefletAuthError";
+  }
+};
+var RefletValidationError = class extends RefletError {
+  constructor(message) {
+    super(message, 400, "VALIDATION_ERROR");
+    this.name = "RefletValidationError";
+  }
+};
+var RefletNotFoundError = class extends RefletError {
+  constructor(message) {
+    super(message, 404, "NOT_FOUND");
+    this.name = "RefletNotFoundError";
+  }
+};
+
+// src/client.ts
+var DEFAULT_BASE_URL = "https://grateful-butterfly-1.convex.cloud";
+var Reflet = class {
+  publicKey;
+  baseUrl;
+  userToken;
+  user;
+  constructor(config) {
+    this.publicKey = config.publicKey;
+    this.baseUrl = config.baseUrl ?? DEFAULT_BASE_URL;
+    this.userToken = config.userToken;
+    this.user = config.user;
+    if (!this.publicKey) {
+      throw new Error("Reflet: publicKey is required");
+    }
+  }
+  /**
+   * Update the user identification
+   */
+  setUser(user) {
+    this.user = user;
+    this.userToken = void 0;
+  }
+  /**
+   * Set the user token directly (for server-signed tokens)
+   */
+  setUserToken(token) {
+    this.userToken = token;
+    this.user = void 0;
+  }
+  /**
+   * Get the board configuration
+   */
+  async getConfig() {
+    return await this.request("GET", "/api/v1/feedback");
+  }
+  /**
+   * List feedback items with optional filtering
+   */
+  async list(params) {
+    const searchParams = new URLSearchParams();
+    if (params?.statusId) {
+      searchParams.set("statusId", params.statusId);
+    }
+    if (params?.status) {
+      searchParams.set("status", params.status);
+    }
+    if (params?.search) {
+      searchParams.set("search", params.search);
+    }
+    if (params?.sortBy) {
+      searchParams.set("sortBy", params.sortBy);
+    }
+    if (params?.limit) {
+      searchParams.set("limit", String(params.limit));
+    }
+    if (params?.offset) {
+      searchParams.set("offset", String(params.offset));
+    }
+    const query = searchParams.toString();
+    const url = `/api/v1/feedback/list${query ? `?${query}` : ""}`;
+    return await this.request("GET", url);
+  }
+  /**
+   * Get a single feedback item by ID
+   */
+  async get(feedbackId) {
+    const result = await this.request(
+      "GET",
+      `/api/v1/feedback/item?id=${encodeURIComponent(feedbackId)}`
+    );
+    if (!result) {
+      throw new RefletNotFoundError("Feedback not found");
+    }
+    return result;
+  }
+  /**
+   * Create new feedback
+   * Requires user identification
+   */
+  async create(params) {
+    return await this.request(
+      "POST",
+      "/api/v1/feedback/create",
+      params
+    );
+  }
+  /**
+   * Toggle vote on feedback
+   * Requires user identification
+   */
+  async vote(feedbackId, type = "upvote") {
+    return await this.request("POST", "/api/v1/feedback/vote", {
+      feedbackId,
+      voteType: type
+    });
+  }
+  /**
+   * Get comments for a feedback item
+   */
+  async getComments(feedbackId, sortBy = "oldest") {
+    return await this.request(
+      "GET",
+      `/api/v1/feedback/comments?feedbackId=${encodeURIComponent(feedbackId)}&sortBy=${sortBy}`
+    );
+  }
+  /**
+   * Add a comment to feedback
+   * Requires user identification
+   */
+  async comment(params) {
+    return await this.request(
+      "POST",
+      "/api/v1/feedback/comment",
+      params
+    );
+  }
+  /**
+   * Subscribe to feedback updates
+   * Requires user identification
+   */
+  async subscribe(feedbackId) {
+    return await this.request(
+      "POST",
+      "/api/v1/feedback/subscribe",
+      {
+        feedbackId
+      }
+    );
+  }
+  /**
+   * Unsubscribe from feedback updates
+   * Requires user identification
+   */
+  async unsubscribe(feedbackId) {
+    return await this.request(
+      "POST",
+      "/api/v1/feedback/unsubscribe",
+      {
+        feedbackId
+      }
+    );
+  }
+  /**
+   * Get roadmap data
+   */
+  async getRoadmap() {
+    return await this.request("GET", "/api/v1/feedback/roadmap");
+  }
+  /**
+   * Get changelog entries
+   */
+  async getChangelog(limit) {
+    const url = limit ? `/api/v1/feedback/changelog?limit=${limit}` : "/api/v1/feedback/changelog";
+    return await this.request("GET", url);
+  }
+  /**
+   * Make an authenticated API request
+   */
+  async request(method, path, body) {
+    const headers = {
+      "Content-Type": "application/json",
+      Authorization: `Bearer ${this.publicKey}`
+    };
+    const token = this.userToken ?? this.generateUserToken();
+    if (token) {
+      headers["X-User-Token"] = token;
+    }
+    const response = await fetch(`${this.baseUrl}${path}`, {
+      method,
+      headers,
+      body: body ? JSON.stringify(body) : void 0
+    });
+    const data = await response.json();
+    if (!response.ok) {
+      const errorMessage = data.error ?? "Request failed";
+      if (response.status === 401) {
+        throw new RefletAuthError(errorMessage);
+      }
+      if (response.status === 404) {
+        throw new RefletNotFoundError(errorMessage);
+      }
+      throw new RefletError(errorMessage, response.status);
+    }
+    return data;
+  }
+  /**
+   * Generate a simple user token for client-side use
+   * Note: For production, use server-side token signing
+   */
+  generateUserToken() {
+    if (!this.user) {
+      return void 0;
+    }
+    const payload = {
+      id: this.user.id,
+      email: this.user.email,
+      name: this.user.name,
+      iat: Math.floor(Date.now() / 1e3),
+      exp: Math.floor(Date.now() / 1e3) + 86400
+      // 24 hours
+    };
+    const header = btoa(JSON.stringify({ alg: "none", typ: "JWT" }));
+    const payloadB64 = btoa(JSON.stringify(payload));
+    return `${header}.${payloadB64}.`;
+  }
+};
+
+export { Reflet, RefletAuthError, RefletError, RefletNotFoundError, RefletValidationError };
+//# sourceMappingURL=chunk-RDQP4VCA.js.map
+//# sourceMappingURL=chunk-RDQP4VCA.js.map

package/dist/chunk-RDQP4VCA.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types.ts","../src/client.ts"],"names":[],"mappings":"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","file":"chunk-RDQP4VCA.js","sourcesContent":["/**\n * Reflet SDK Types\n */\n\n// ============================================\n// Configuration\n// ============================================\n\nexport interface RefletConfig {\n  /** Your board's public API key (fb_pub_xxx) */\n  publicKey: string;\n  /** API base URL (defaults to https://api.reflet.app) */\n  baseUrl?: string;\n  /** User identification for SSO */\n  user?: RefletUser;\n  /** Pre-signed user token (alternative to user object) */\n  userToken?: string;\n}\n\nexport interface RefletUser {\n  /** Unique identifier for the user in your system */\n  id: string;\n  /** User's email address */\n  email?: string;\n  /** User's display name */\n  name?: string;\n  /** URL to user's avatar image */\n  avatar?: string;\n  /** Additional metadata */\n  metadata?: Record<string, unknown>;\n}\n\n// ============================================\n// API Responses\n// ============================================\n\nexport interface BoardConfig {\n  id: string;\n  name: string;\n  slug: string;\n  description?: string;\n  isPublic: boolean;\n  settings?: BoardSettings;\n  organization: {\n    id: string;\n    name: string;\n    slug: string;\n    logo?: string;\n    primaryColor?: string;\n  };\n  statuses: BoardStatus[];\n}\n\nexport interface BoardSettings {\n  allowAnonymousVoting?: boolean;\n  requireApproval?: boolean;\n  defaultStatus?: FeedbackStatus;\n}\n\nexport interface BoardStatus {\n  id: string;\n  name: string;\n  color: string;\n  icon?: string;\n  order: number;\n}\n\nexport type FeedbackStatus =\n  | \"open\"\n  | \"under_review\"\n  | \"planned\"\n  | \"in_progress\"\n  | \"completed\"\n  | \"closed\";\n\n// ============================================\n// Feedback\n// ============================================\n\nexport interface FeedbackItem {\n  id: string;\n  title: string;\n  description: string;\n  status: FeedbackStatus;\n  voteCount: number;\n  commentCount: number;\n  isPinned: boolean;\n  hasVoted: boolean;\n  createdAt: number;\n  updatedAt: number;\n  completedAt?: number;\n  tags: FeedbackTag[];\n  boardStatus: {\n    id: string;\n    name: string;\n    color: string;\n  } | null;\n  author: FeedbackAuthor | null;\n}\n\nexport interface FeedbackDetail extends FeedbackItem {\n  isSubscribed: boolean;\n}\n\nexport interface FeedbackTag {\n  id: string;\n  name: string;\n  color: string;\n}\n\nexport interface FeedbackAuthor {\n  name?: string;\n  email?: string;\n  avatar?: string;\n  isExternal: boolean;\n}\n\nexport interface FeedbackListResponse {\n  items: FeedbackItem[];\n  total: number;\n  hasMore: boolean;\n}\n\nexport interface FeedbackListParams {\n  /** Filter by custom status ID */\n  statusId?: string;\n  /** Filter by status name */\n  status?: FeedbackStatus;\n  /** Search in title and description */\n  search?: string;\n  /** Sort order */\n  sortBy?: \"votes\" | \"newest\" | \"oldest\" | \"comments\";\n  /** Number of items to return (max 100) */\n  limit?: number;\n  /** Offset for pagination */\n  offset?: number;\n}\n\nexport interface CreateFeedbackParams {\n  title: string;\n  description: string;\n}\n\nexport interface CreateFeedbackResponse {\n  feedbackId: string;\n  isApproved: boolean;\n}\n\nexport interface VoteResponse {\n  voted: boolean;\n  voteCount: number;\n}\n\n// ============================================\n// Comments\n// ============================================\n\nexport interface Comment {\n  id: string;\n  body: string;\n  isOfficial: boolean;\n  author: FeedbackAuthor | null;\n  replies: CommentReply[];\n  createdAt: number;\n  updatedAt: number;\n}\n\nexport interface CommentReply {\n  id: string;\n  body: string;\n  isOfficial: boolean;\n  author: FeedbackAuthor | null;\n  createdAt: number;\n  updatedAt: number;\n}\n\nexport interface AddCommentParams {\n  feedbackId: string;\n  body: string;\n  parentId?: string;\n}\n\nexport interface AddCommentResponse {\n  commentId: string;\n}\n\n// ============================================\n// Subscriptions\n// ============================================\n\nexport interface SubscribeResponse {\n  subscribed: boolean;\n  alreadySubscribed?: boolean;\n}\n\nexport interface UnsubscribeResponse {\n  unsubscribed: boolean;\n  wasNotSubscribed?: boolean;\n}\n\n// ============================================\n// Roadmap\n// ============================================\n\nexport interface Roadmap {\n  lanes: RoadmapLane[];\n}\n\nexport interface RoadmapLane {\n  id: string;\n  name: string;\n  color: string;\n  items: RoadmapItem[];\n}\n\nexport interface RoadmapItem {\n  id: string;\n  title: string;\n  status: FeedbackStatus;\n  voteCount: number;\n}\n\n// ============================================\n// Changelog\n// ============================================\n\nexport interface ChangelogEntry {\n  id: string;\n  title: string;\n  description?: string;\n  version?: string;\n  publishedAt?: number;\n  feedback: { id: string; title: string }[];\n}\n\n// ============================================\n// Errors\n// ============================================\n\nexport class RefletError extends Error {\n  readonly status: number;\n  readonly code?: string;\n\n  constructor(message: string, status: number, code?: string) {\n    super(message);\n    this.name = \"RefletError\";\n    this.status = status;\n    this.code = code;\n  }\n}\n\nexport class RefletAuthError extends RefletError {\n  constructor(message: string) {\n    super(message, 401, \"AUTH_ERROR\");\n    this.name = \"RefletAuthError\";\n  }\n}\n\nexport class RefletValidationError extends RefletError {\n  constructor(message: string) {\n    super(message, 400, \"VALIDATION_ERROR\");\n    this.name = \"RefletValidationError\";\n  }\n}\n\nexport class RefletNotFoundError extends RefletError {\n  constructor(message: string) {\n    super(message, 404, \"NOT_FOUND\");\n    this.name = \"RefletNotFoundError\";\n  }\n}\n","import {\n  type AddCommentParams,\n  type AddCommentResponse,\n  type BoardConfig,\n  type ChangelogEntry,\n  type Comment,\n  type CreateFeedbackParams,\n  type CreateFeedbackResponse,\n  type FeedbackDetail,\n  type FeedbackListParams,\n  type FeedbackListResponse,\n  RefletAuthError,\n  type RefletConfig,\n  RefletError,\n  RefletNotFoundError,\n  type RefletUser,\n  type Roadmap,\n  type SubscribeResponse,\n  type UnsubscribeResponse,\n  type VoteResponse,\n} from \"./types\";\n\nconst DEFAULT_BASE_URL = \"https://grateful-butterfly-1.convex.cloud\";\n\n/**\n * Reflet SDK Client\n *\n * @example\n * ```ts\n * import { Reflet } from '@reflet/sdk';\n *\n * const reflet = new Reflet({\n *   publicKey: 'fb_pub_xxx',\n *   user: { id: 'user_123', email: 'user@example.com', name: 'John' }\n * });\n *\n * // List feedback\n * const { items } = await reflet.list({ status: 'open' });\n *\n * // Vote on feedback\n * await reflet.vote('feedback_id');\n *\n * // Submit new feedback\n * await reflet.create({ title: 'Great idea', description: 'Details...' });\n * ```\n */\nexport class Reflet {\n  private readonly publicKey: string;\n  private readonly baseUrl: string;\n  private userToken: string | undefined;\n  private user: RefletUser | undefined;\n\n  constructor(config: RefletConfig) {\n    this.publicKey = config.publicKey;\n    this.baseUrl = config.baseUrl ?? DEFAULT_BASE_URL;\n    this.userToken = config.userToken;\n    this.user = config.user;\n\n    if (!this.publicKey) {\n      throw new Error(\"Reflet: publicKey is required\");\n    }\n  }\n\n  /**\n   * Update the user identification\n   */\n  setUser(user: RefletUser | undefined): void {\n    this.user = user;\n    this.userToken = undefined;\n  }\n\n  /**\n   * Set the user token directly (for server-signed tokens)\n   */\n  setUserToken(token: string | undefined): void {\n    this.userToken = token;\n    this.user = undefined;\n  }\n\n  /**\n   * Get the board configuration\n   */\n  async getConfig(): Promise<BoardConfig> {\n    return await this.request<BoardConfig>(\"GET\", \"/api/v1/feedback\");\n  }\n\n  /**\n   * List feedback items with optional filtering\n   */\n  async list(params?: FeedbackListParams): Promise<FeedbackListResponse> {\n    const searchParams = new URLSearchParams();\n\n    if (params?.statusId) {\n      searchParams.set(\"statusId\", params.statusId);\n    }\n    if (params?.status) {\n      searchParams.set(\"status\", params.status);\n    }\n    if (params?.search) {\n      searchParams.set(\"search\", params.search);\n    }\n    if (params?.sortBy) {\n      searchParams.set(\"sortBy\", params.sortBy);\n    }\n    if (params?.limit) {\n      searchParams.set(\"limit\", String(params.limit));\n    }\n    if (params?.offset) {\n      searchParams.set(\"offset\", String(params.offset));\n    }\n\n    const query = searchParams.toString();\n    const url = `/api/v1/feedback/list${query ? `?${query}` : \"\"}`;\n\n    return await this.request<FeedbackListResponse>(\"GET\", url);\n  }\n\n  /**\n   * Get a single feedback item by ID\n   */\n  async get(feedbackId: string): Promise<FeedbackDetail> {\n    const result = await this.request<FeedbackDetail | null>(\n      \"GET\",\n      `/api/v1/feedback/item?id=${encodeURIComponent(feedbackId)}`\n    );\n\n    if (!result) {\n      throw new RefletNotFoundError(\"Feedback not found\");\n    }\n\n    return result;\n  }\n\n  /**\n   * Create new feedback\n   * Requires user identification\n   */\n  async create(params: CreateFeedbackParams): Promise<CreateFeedbackResponse> {\n    return await this.request<CreateFeedbackResponse>(\n      \"POST\",\n      \"/api/v1/feedback/create\",\n      params\n    );\n  }\n\n  /**\n   * Toggle vote on feedback\n   * Requires user identification\n   */\n  async vote(\n    feedbackId: string,\n    type: \"upvote\" | \"downvote\" = \"upvote\"\n  ): Promise<VoteResponse> {\n    return await this.request<VoteResponse>(\"POST\", \"/api/v1/feedback/vote\", {\n      feedbackId,\n      voteType: type,\n    });\n  }\n\n  /**\n   * Get comments for a feedback item\n   */\n  async getComments(\n    feedbackId: string,\n    sortBy: \"newest\" | \"oldest\" = \"oldest\"\n  ): Promise<Comment[]> {\n    return await this.request<Comment[]>(\n      \"GET\",\n      `/api/v1/feedback/comments?feedbackId=${encodeURIComponent(feedbackId)}&sortBy=${sortBy}`\n    );\n  }\n\n  /**\n   * Add a comment to feedback\n   * Requires user identification\n   */\n  async comment(params: AddCommentParams): Promise<AddCommentResponse> {\n    return await this.request<AddCommentResponse>(\n      \"POST\",\n      \"/api/v1/feedback/comment\",\n      params\n    );\n  }\n\n  /**\n   * Subscribe to feedback updates\n   * Requires user identification\n   */\n  async subscribe(feedbackId: string): Promise<SubscribeResponse> {\n    return await this.request<SubscribeResponse>(\n      \"POST\",\n      \"/api/v1/feedback/subscribe\",\n      {\n        feedbackId,\n      }\n    );\n  }\n\n  /**\n   * Unsubscribe from feedback updates\n   * Requires user identification\n   */\n  async unsubscribe(feedbackId: string): Promise<UnsubscribeResponse> {\n    return await this.request<UnsubscribeResponse>(\n      \"POST\",\n      \"/api/v1/feedback/unsubscribe\",\n      {\n        feedbackId,\n      }\n    );\n  }\n\n  /**\n   * Get roadmap data\n   */\n  async getRoadmap(): Promise<Roadmap> {\n    return await this.request<Roadmap>(\"GET\", \"/api/v1/feedback/roadmap\");\n  }\n\n  /**\n   * Get changelog entries\n   */\n  async getChangelog(limit?: number): Promise<ChangelogEntry[]> {\n    const url = limit\n      ? `/api/v1/feedback/changelog?limit=${limit}`\n      : \"/api/v1/feedback/changelog\";\n\n    return await this.request<ChangelogEntry[]>(\"GET\", url);\n  }\n\n  /**\n   * Make an authenticated API request\n   */\n  private async request<T>(\n    method: string,\n    path: string,\n    body?: unknown\n  ): Promise<T> {\n    const headers: Record<string, string> = {\n      \"Content-Type\": \"application/json\",\n      Authorization: `Bearer ${this.publicKey}`,\n    };\n\n    // Add user token if available\n    const token = this.userToken ?? this.generateUserToken();\n    if (token) {\n      headers[\"X-User-Token\"] = token;\n    }\n\n    const response = await fetch(`${this.baseUrl}${path}`, {\n      method,\n      headers,\n      body: body ? JSON.stringify(body) : undefined,\n    });\n\n    const data = (await response.json()) as T | { error: string };\n\n    if (!response.ok) {\n      const errorMessage =\n        (data as { error?: string }).error ?? \"Request failed\";\n\n      if (response.status === 401) {\n        throw new RefletAuthError(errorMessage);\n      }\n      if (response.status === 404) {\n        throw new RefletNotFoundError(errorMessage);\n      }\n\n      throw new RefletError(errorMessage, response.status);\n    }\n\n    return data as T;\n  }\n\n  /**\n   * Generate a simple user token for client-side use\n   * Note: For production, use server-side token signing\n   */\n  private generateUserToken(): string | undefined {\n    if (!this.user) {\n      return undefined;\n    }\n\n    // Simple base64 encoding for client-side use\n    // In production, tokens should be signed server-side\n    const payload = {\n      id: this.user.id,\n      email: this.user.email,\n      name: this.user.name,\n      iat: Math.floor(Date.now() / 1000),\n      exp: Math.floor(Date.now() / 1000) + 86_400, // 24 hours\n    };\n\n    const header = btoa(JSON.stringify({ alg: \"none\", typ: \"JWT\" }));\n    const payloadB64 = btoa(JSON.stringify(payload));\n\n    return `${header}.${payloadB64}.`;\n  }\n}\n"]}