@feedhog/js 0.1.0

package/README.md

@@ -0,0 +1,215 @@
+# @feedhog/js
+
+JavaScript SDK for [Feedhog](https://feedhog.com) - collect user feedback from any website or application.
+
+## Installation
+
+```bash
+npm install @feedhog/js
+# or
+pnpm add @feedhog/js
+# or
+yarn add @feedhog/js
+```
+
+### CDN Usage
+
+```html
+<script src="https://feedhog.com/sdk.js"></script>
+<script>
+  const feedhog = new Feedhog({ apiKey: 'fhpk_xxx' });
+</script>
+```
+
+## Quick Start
+
+```typescript
+import Feedhog from '@feedhog/js';
+
+// Initialize with your public API key
+const feedhog = new Feedhog({
+  apiKey: 'fhpk_xxx',
+  baseUrl: 'https://feedhog.com' // Optional, defaults to production
+});
+
+// Identify the current user (optional but recommended)
+await feedhog.identify({
+  externalId: 'user-123',
+  email: 'user@example.com',
+  name: 'John Doe',
+  metadata: { plan: 'pro' }
+});
+
+// Submit feedback
+const feedback = await feedhog.submit({
+  title: 'Add dark mode',
+  description: 'Would love a dark theme option',
+  type: 'idea' // 'bug' | 'idea' | 'question' | 'other'
+});
+```
+
+## API Reference
+
+### `new Feedhog(config)`
+
+Create a new Feedhog instance.
+
+```typescript
+const feedhog = new Feedhog({
+  apiKey: 'fhpk_xxx',     // Required: Your public API key
+  baseUrl: 'https://...'  // Optional: Custom API URL
+});
+```
+
+### `feedhog.identify(user)`
+
+Identify the current user. This associates all subsequent feedback and votes with this user.
+
+```typescript
+await feedhog.identify({
+  externalId: 'user-123',      // Required: Your system's user ID
+  email: 'user@example.com',   // Optional
+  name: 'John Doe',            // Optional
+  avatarUrl: 'https://...',    // Optional
+  metadata: { plan: 'pro' }    // Optional: Custom data
+});
+```
+
+User identity is persisted in localStorage, so returning users are automatically recognized.
+
+### `feedhog.submit(input)`
+
+Submit new feedback.
+
+```typescript
+const feedback = await feedhog.submit({
+  title: 'Feature request',           // Required
+  description: 'Detailed description', // Optional
+  type: 'idea',                        // Optional: 'bug' | 'idea' | 'question' | 'other'
+  metadata: { page: '/settings' }      // Optional: Custom data
+});
+```
+
+### `feedhog.list(options)`
+
+List feedback items with optional filters.
+
+```typescript
+const { items, total, page, totalPages } = await feedhog.list({
+  status: ['new', 'planned'],  // Filter by status(es)
+  type: 'idea',                // Filter by type
+  search: 'dark mode',         // Search query
+  sortBy: 'votes',             // 'newest' | 'oldest' | 'votes' | 'comments'
+  page: 1,                     // Page number
+  limit: 20                    // Items per page (max 100)
+});
+```
+
+### `feedhog.get(feedbackId)`
+
+Get a single feedback item with full details including comments.
+
+```typescript
+const feedback = await feedhog.get('abc123');
+console.log(feedback.comments);
+console.log(feedback.userHasVoted);
+```
+
+### `feedhog.vote(feedbackId)`
+
+Toggle vote on a feedback item.
+
+```typescript
+const { voted, voteCount } = await feedhog.vote('abc123');
+// voted: true if vote was added, false if removed
+```
+
+### `feedhog.hasVoted(feedbackId)`
+
+Check if the current user has voted on a feedback item.
+
+```typescript
+const { voted, voteCount } = await feedhog.hasVoted('abc123');
+```
+
+### `feedhog.reset()`
+
+Clear the current user and stored data. Use when a user logs out.
+
+```typescript
+feedhog.reset();
+```
+
+### `feedhog.user`
+
+Get the currently identified user.
+
+```typescript
+if (feedhog.user) {
+  console.log('Logged in as:', feedhog.user.name);
+}
+```
+
+## Events
+
+Subscribe to SDK events:
+
+```typescript
+// User identified
+feedhog.on('identify', (user) => {
+  console.log('User identified:', user);
+});
+
+// Feedback submitted
+feedhog.on('submit', (feedback) => {
+  console.log('Feedback submitted:', feedback.id);
+});
+
+// Vote toggled
+feedhog.on('vote', ({ feedbackId, result }) => {
+  console.log('Vote toggled:', result.voted);
+});
+
+// Error occurred
+feedhog.on('error', (error) => {
+  console.error('SDK error:', error);
+});
+
+// User reset
+feedhog.on('reset', () => {
+  console.log('User logged out');
+});
+```
+
+## TypeScript
+
+The SDK is fully typed. Import types as needed:
+
+```typescript
+import Feedhog, {
+  type FeedbackType,
+  type FeedbackStatus,
+  type FeedbackListItem,
+  type UserIdentity
+} from '@feedhog/js';
+```
+
+## Error Handling
+
+```typescript
+import Feedhog, { FeedhogApiError } from '@feedhog/js';
+
+try {
+  await feedhog.submit({ title: '' });
+} catch (error) {
+  if (error instanceof FeedhogApiError) {
+    console.log('Status:', error.status);
+    console.log('Message:', error.message);
+    console.log('Field errors:', error.details?.fieldErrors);
+  }
+}
+```
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,426 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  Feedhog: () => Feedhog,
+  FeedhogApiError: () => FeedhogApiError,
+  default: () => index_default
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/utils.ts
+var STORAGE_KEY = "feedhog_user";
+function storeUser(user) {
+  if (typeof window === "undefined" || !window.localStorage) return;
+  try {
+    localStorage.setItem(STORAGE_KEY, JSON.stringify(user));
+  } catch {
+  }
+}
+function getStoredUser() {
+  if (typeof window === "undefined" || !window.localStorage) return null;
+  try {
+    const stored = localStorage.getItem(STORAGE_KEY);
+    if (!stored) return null;
+    return JSON.parse(stored);
+  } catch {
+    return null;
+  }
+}
+function clearStoredUser() {
+  if (typeof window === "undefined" || !window.localStorage) return;
+  try {
+    localStorage.removeItem(STORAGE_KEY);
+  } catch {
+  }
+}
+function buildUrl(baseUrl, path, params) {
+  const url = new URL(path, baseUrl);
+  if (params) {
+    for (const [key, value] of Object.entries(params)) {
+      if (value === void 0) continue;
+      if (Array.isArray(value)) {
+        url.searchParams.set(key, value.join(","));
+      } else {
+        url.searchParams.set(key, String(value));
+      }
+    }
+  }
+  return url.toString();
+}
+function isBrowser() {
+  return typeof window !== "undefined" && typeof document !== "undefined";
+}
+var EventEmitter = class {
+  constructor() {
+    this.listeners = /* @__PURE__ */ new Map();
+  }
+  on(event, callback) {
+    if (!this.listeners.has(event)) {
+      this.listeners.set(event, /* @__PURE__ */ new Set());
+    }
+    this.listeners.get(event).add(callback);
+    return () => {
+      this.listeners.get(event)?.delete(callback);
+    };
+  }
+  emit(event, data) {
+    this.listeners.get(event)?.forEach((callback) => callback(data));
+  }
+  off(event, callback) {
+    this.listeners.get(event)?.delete(callback);
+  }
+};
+
+// src/client.ts
+var DEFAULT_BASE_URL = "https://feedhog.com";
+var FeedhogClient = class {
+  constructor(config) {
+    if (!config.apiKey) {
+      throw new Error("Feedhog: apiKey is required");
+    }
+    this.apiKey = config.apiKey;
+    this.baseUrl = (config.baseUrl || DEFAULT_BASE_URL).replace(/\/$/, "");
+  }
+  /**
+   * Make an authenticated API request
+   */
+  async request(method, path, options) {
+    const url = options?.params ? buildUrl(this.baseUrl, path, options.params) : `${this.baseUrl}${path}`;
+    const response = await fetch(url, {
+      method,
+      headers: {
+        "Content-Type": "application/json",
+        "x-api-key": this.apiKey
+      },
+      body: options?.body ? JSON.stringify(options.body) : void 0
+    });
+    const data = await response.json();
+    if (!response.ok) {
+      const error = data;
+      throw new FeedhogApiError(
+        error.error || "Unknown error",
+        response.status,
+        error.details
+      );
+    }
+    return data;
+  }
+  /**
+   * Identify or create an end user
+   */
+  async identify(user) {
+    const response = await this.request(
+      "POST",
+      "/api/v1/identify",
+      { body: user }
+    );
+    return response.user;
+  }
+  /**
+   * Submit new feedback
+   */
+  async submit(input, user) {
+    const body = {
+      ...input
+    };
+    if (user) {
+      body.endUser = user;
+    }
+    const response = await this.request(
+      "POST",
+      "/api/v1/feedback",
+      { body }
+    );
+    return response.feedback;
+  }
+  /**
+   * List feedback items (paginated)
+   */
+  async list(options) {
+    return this.request(
+      "GET",
+      "/api/v1/feedback",
+      {
+        params: {
+          status: options?.status ? Array.isArray(options.status) ? options.status : [options.status] : void 0,
+          type: options?.type ? Array.isArray(options.type) ? options.type : [options.type] : void 0,
+          search: options?.search,
+          sortBy: options?.sortBy,
+          page: options?.page,
+          limit: options?.limit
+        }
+      }
+    );
+  }
+  /**
+   * Get a single feedback item with details
+   */
+  async get(feedbackId, endUserId) {
+    const response = await this.request(
+      "GET",
+      `/api/v1/feedback/${feedbackId}`,
+      {
+        params: endUserId ? { endUserId } : void 0
+      }
+    );
+    return response.feedback;
+  }
+  /**
+   * Toggle vote on feedback
+   */
+  async vote(feedbackId, user) {
+    return this.request("POST", `/api/v1/feedback/${feedbackId}/vote`, {
+      body: user ? { endUser: user } : {}
+    });
+  }
+  /**
+   * Check if user has voted on feedback
+   */
+  async hasVoted(feedbackId, endUserId) {
+    return this.request("GET", `/api/v1/feedback/${feedbackId}/vote`, {
+      params: endUserId ? { endUserId } : void 0
+    });
+  }
+};
+var FeedhogApiError = class extends Error {
+  constructor(message, status, details) {
+    super(message);
+    this.status = status;
+    this.details = details;
+    this.name = "FeedhogApiError";
+  }
+};
+
+// src/index.ts
+var Feedhog = class extends EventEmitter {
+  constructor(config) {
+    super();
+    this.currentUser = null;
+    this.client = new FeedhogClient(config);
+    if (isBrowser()) {
+      const stored = getStoredUser();
+      if (stored) {
+        this.currentUser = { ...stored, identified: false };
+      }
+    }
+  }
+  /**
+   * Get the currently identified user
+   */
+  get user() {
+    return this.currentUser;
+  }
+  /**
+   * Identify the current user
+   *
+   * This associates feedback and votes with a specific user in your system.
+   * User data is persisted in localStorage for subsequent sessions.
+   *
+   * @param user - User identity data
+   * @returns Promise resolving to the identified user
+   *
+   * @example
+   * ```typescript
+   * await feedhog.identify({
+   *   externalId: 'user-123',
+   *   email: 'user@example.com',
+   *   name: 'John Doe',
+   *   metadata: { plan: 'pro' }
+   * });
+   * ```
+   */
+  async identify(user) {
+    try {
+      const identified = await this.client.identify(user);
+      this.currentUser = {
+        ...user,
+        identified: true
+      };
+      if (isBrowser()) {
+        storeUser(user);
+      }
+      this.emit("identify", identified);
+      return identified;
+    } catch (error) {
+      this.emit("error", error);
+      throw error;
+    }
+  }
+  /**
+   * Submit new feedback
+   *
+   * If a user has been identified, the feedback will be associated with them.
+   *
+   * @param input - Feedback data
+   * @returns Promise resolving to the created feedback item
+   *
+   * @example
+   * ```typescript
+   * const feedback = await feedhog.submit({
+   *   title: 'Add dark mode',
+   *   description: 'Would love a dark theme option',
+   *   type: 'idea'
+   * });
+   * console.log('Feedback submitted:', feedback.id);
+   * ```
+   */
+  async submit(input) {
+    try {
+      const feedback = await this.client.submit(
+        input,
+        this.currentUser || void 0
+      );
+      this.emit("submit", feedback);
+      return feedback;
+    } catch (error) {
+      this.emit("error", error);
+      throw error;
+    }
+  }
+  /**
+   * List feedback items
+   *
+   * Returns a paginated list of feedback for the project.
+   *
+   * @param options - Filter and pagination options
+   * @returns Promise resolving to paginated feedback list
+   *
+   * @example
+   * ```typescript
+   * // Get all ideas in "planned" status
+   * const { items, total } = await feedhog.list({
+   *   status: ['planned', 'in-progress'],
+   *   type: 'idea',
+   *   sortBy: 'votes',
+   *   limit: 10
+   * });
+   * ```
+   */
+  async list(options) {
+    try {
+      return await this.client.list(options);
+    } catch (error) {
+      this.emit("error", error);
+      throw error;
+    }
+  }
+  /**
+   * Get a single feedback item with full details
+   *
+   * @param feedbackId - ID of the feedback item
+   * @returns Promise resolving to feedback details including comments
+   *
+   * @example
+   * ```typescript
+   * const feedback = await feedhog.get('abc123');
+   * console.log('Comments:', feedback.comments.length);
+   * console.log('Has voted:', feedback.userHasVoted);
+   * ```
+   */
+  async get(feedbackId) {
+    try {
+      return await this.client.get(
+        feedbackId,
+        this.currentUser?.externalId
+      );
+    } catch (error) {
+      this.emit("error", error);
+      throw error;
+    }
+  }
+  /**
+   * Toggle vote on a feedback item
+   *
+   * If the user has already voted, this will remove their vote.
+   * If they haven't voted, it will add their vote.
+   *
+   * @param feedbackId - ID of the feedback item to vote on
+   * @returns Promise resolving to vote result
+   *
+   * @example
+   * ```typescript
+   * const { voted, voteCount } = await feedhog.vote('abc123');
+   * console.log(voted ? 'Vote added' : 'Vote removed');
+   * console.log('Total votes:', voteCount);
+   * ```
+   */
+  async vote(feedbackId) {
+    try {
+      const result = await this.client.vote(
+        feedbackId,
+        this.currentUser || void 0
+      );
+      this.emit("vote", { feedbackId, result });
+      return result;
+    } catch (error) {
+      this.emit("error", error);
+      throw error;
+    }
+  }
+  /**
+   * Check if the current user has voted on a feedback item
+   *
+   * @param feedbackId - ID of the feedback item
+   * @returns Promise resolving to vote status
+   *
+   * @example
+   * ```typescript
+   * const { voted, voteCount } = await feedhog.hasVoted('abc123');
+   * ```
+   */
+  async hasVoted(feedbackId) {
+    try {
+      return await this.client.hasVoted(
+        feedbackId,
+        this.currentUser?.externalId
+      );
+    } catch (error) {
+      this.emit("error", error);
+      throw error;
+    }
+  }
+  /**
+   * Reset the SDK state
+   *
+   * Clears the current user and removes stored data.
+   * Use this when a user logs out.
+   *
+   * @example
+   * ```typescript
+   * feedhog.reset();
+   * ```
+   */
+  reset() {
+    this.currentUser = null;
+    if (isBrowser()) {
+      clearStoredUser();
+    }
+    this.emit("reset", void 0);
+  }
+};
+var index_default = Feedhog;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  Feedhog,
+  FeedhogApiError
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/utils.ts","../src/client.ts"],"sourcesContent":["/**\n * Feedhog JavaScript SDK\n *\n * Collect user feedback from any website or application.\n *\n * @example\n * ```typescript\n * import Feedhog from '@feedhog/js';\n *\n * const feedhog = new Feedhog({ apiKey: 'fhpk_xxx' });\n *\n * // Identify the current user (optional but recommended)\n * feedhog.identify({\n *   externalId: 'user-123',\n *   email: 'user@example.com',\n *   name: 'John Doe'\n * });\n *\n * // Submit feedback\n * await feedhog.submit({\n *   title: 'Add dark mode',\n *   description: 'Would love a dark theme option',\n *   type: 'idea'\n * });\n * ```\n */\n\nimport { FeedhogClient, FeedhogApiError } from \"./client\";\nimport {\n  storeUser,\n  getStoredUser,\n  clearStoredUser,\n  EventEmitter,\n  isBrowser,\n} from \"./utils\";\nimport type {\n  FeedhogConfig,\n  UserIdentity,\n  SubmitFeedbackInput,\n  ListFeedbackOptions,\n  FeedbackListItem,\n  FeedbackDetail,\n  PaginatedResponse,\n  VoteResult,\n  IdentifiedUser,\n  CurrentUser,\n  FeedbackType,\n  FeedbackStatus,\n  SortBy,\n} from \"./types\";\n\n// SDK Events\ninterface FeedhogEvents {\n  [key: string]: unknown;\n  identify: IdentifiedUser;\n  submit: FeedbackListItem;\n  vote: { feedbackId: string; result: VoteResult };\n  error: Error;\n  reset: void;\n}\n\n/**\n * Feedhog SDK main class\n */\nexport class Feedhog extends EventEmitter<FeedhogEvents> {\n  private readonly client: FeedhogClient;\n  private currentUser: CurrentUser | null = null;\n\n  constructor(config: FeedhogConfig) {\n    super();\n    this.client = new FeedhogClient(config);\n\n    // Try to restore user from storage\n    if (isBrowser()) {\n      const stored = getStoredUser();\n      if (stored) {\n        this.currentUser = { ...stored, identified: false };\n      }\n    }\n  }\n\n  /**\n   * Get the currently identified user\n   */\n  get user(): CurrentUser | null {\n    return this.currentUser;\n  }\n\n  /**\n   * Identify the current user\n   *\n   * This associates feedback and votes with a specific user in your system.\n   * User data is persisted in localStorage for subsequent sessions.\n   *\n   * @param user - User identity data\n   * @returns Promise resolving to the identified user\n   *\n   * @example\n   * ```typescript\n   * await feedhog.identify({\n   *   externalId: 'user-123',\n   *   email: 'user@example.com',\n   *   name: 'John Doe',\n   *   metadata: { plan: 'pro' }\n   * });\n   * ```\n   */\n  async identify(user: UserIdentity): Promise<IdentifiedUser> {\n    try {\n      const identified = await this.client.identify(user);\n\n      this.currentUser = {\n        ...user,\n        identified: true,\n      };\n\n      // Persist to storage\n      if (isBrowser()) {\n        storeUser(user);\n      }\n\n      this.emit(\"identify\", identified);\n      return identified;\n    } catch (error) {\n      this.emit(\"error\", error as Error);\n      throw error;\n    }\n  }\n\n  /**\n   * Submit new feedback\n   *\n   * If a user has been identified, the feedback will be associated with them.\n   *\n   * @param input - Feedback data\n   * @returns Promise resolving to the created feedback item\n   *\n   * @example\n   * ```typescript\n   * const feedback = await feedhog.submit({\n   *   title: 'Add dark mode',\n   *   description: 'Would love a dark theme option',\n   *   type: 'idea'\n   * });\n   * console.log('Feedback submitted:', feedback.id);\n   * ```\n   */\n  async submit(input: SubmitFeedbackInput): Promise<FeedbackListItem> {\n    try {\n      const feedback = await this.client.submit(\n        input,\n        this.currentUser || undefined\n      );\n      this.emit(\"submit\", feedback);\n      return feedback;\n    } catch (error) {\n      this.emit(\"error\", error as Error);\n      throw error;\n    }\n  }\n\n  /**\n   * List feedback items\n   *\n   * Returns a paginated list of feedback for the project.\n   *\n   * @param options - Filter and pagination options\n   * @returns Promise resolving to paginated feedback list\n   *\n   * @example\n   * ```typescript\n   * // Get all ideas in \"planned\" status\n   * const { items, total } = await feedhog.list({\n   *   status: ['planned', 'in-progress'],\n   *   type: 'idea',\n   *   sortBy: 'votes',\n   *   limit: 10\n   * });\n   * ```\n   */\n  async list(\n    options?: ListFeedbackOptions\n  ): Promise<PaginatedResponse<FeedbackListItem>> {\n    try {\n      return await this.client.list(options);\n    } catch (error) {\n      this.emit(\"error\", error as Error);\n      throw error;\n    }\n  }\n\n  /**\n   * Get a single feedback item with full details\n   *\n   * @param feedbackId - ID of the feedback item\n   * @returns Promise resolving to feedback details including comments\n   *\n   * @example\n   * ```typescript\n   * const feedback = await feedhog.get('abc123');\n   * console.log('Comments:', feedback.comments.length);\n   * console.log('Has voted:', feedback.userHasVoted);\n   * ```\n   */\n  async get(feedbackId: string): Promise<FeedbackDetail> {\n    try {\n      return await this.client.get(\n        feedbackId,\n        this.currentUser?.externalId\n      );\n    } catch (error) {\n      this.emit(\"error\", error as Error);\n      throw error;\n    }\n  }\n\n  /**\n   * Toggle vote on a feedback item\n   *\n   * If the user has already voted, this will remove their vote.\n   * If they haven't voted, it will add their vote.\n   *\n   * @param feedbackId - ID of the feedback item to vote on\n   * @returns Promise resolving to vote result\n   *\n   * @example\n   * ```typescript\n   * const { voted, voteCount } = await feedhog.vote('abc123');\n   * console.log(voted ? 'Vote added' : 'Vote removed');\n   * console.log('Total votes:', voteCount);\n   * ```\n   */\n  async vote(feedbackId: string): Promise<VoteResult> {\n    try {\n      const result = await this.client.vote(\n        feedbackId,\n        this.currentUser || undefined\n      );\n      this.emit(\"vote\", { feedbackId, result });\n      return result;\n    } catch (error) {\n      this.emit(\"error\", error as Error);\n      throw error;\n    }\n  }\n\n  /**\n   * Check if the current user has voted on a feedback item\n   *\n   * @param feedbackId - ID of the feedback item\n   * @returns Promise resolving to vote status\n   *\n   * @example\n   * ```typescript\n   * const { voted, voteCount } = await feedhog.hasVoted('abc123');\n   * ```\n   */\n  async hasVoted(feedbackId: string): Promise<VoteResult> {\n    try {\n      return await this.client.hasVoted(\n        feedbackId,\n        this.currentUser?.externalId\n      );\n    } catch (error) {\n      this.emit(\"error\", error as Error);\n      throw error;\n    }\n  }\n\n  /**\n   * Reset the SDK state\n   *\n   * Clears the current user and removes stored data.\n   * Use this when a user logs out.\n   *\n   * @example\n   * ```typescript\n   * feedhog.reset();\n   * ```\n   */\n  reset(): void {\n    this.currentUser = null;\n    if (isBrowser()) {\n      clearStoredUser();\n    }\n    this.emit(\"reset\", undefined);\n  }\n}\n\n// Export as default for UMD builds\nexport default Feedhog;\n\n// Export types\nexport type {\n  FeedhogConfig,\n  UserIdentity,\n  SubmitFeedbackInput,\n  ListFeedbackOptions,\n  FeedbackListItem,\n  FeedbackDetail,\n  PaginatedResponse,\n  VoteResult,\n  IdentifiedUser,\n  CurrentUser,\n  FeedbackType,\n  FeedbackStatus,\n  SortBy,\n};\n\n// Export error class\nexport { FeedhogApiError };\n","/**\n * Feedhog SDK Utilities\n */\n\nconst STORAGE_KEY = \"feedhog_user\";\n\n/**\n * Store user identity in localStorage (if available)\n */\nexport function storeUser(user: {\n  externalId: string;\n  email?: string;\n  name?: string;\n  avatarUrl?: string;\n}): void {\n  if (typeof window === \"undefined\" || !window.localStorage) return;\n\n  try {\n    localStorage.setItem(STORAGE_KEY, JSON.stringify(user));\n  } catch {\n    // Ignore storage errors (quota exceeded, private mode, etc.)\n  }\n}\n\n/**\n * Retrieve stored user identity from localStorage\n */\nexport function getStoredUser(): {\n  externalId: string;\n  email?: string;\n  name?: string;\n  avatarUrl?: string;\n} | null {\n  if (typeof window === \"undefined\" || !window.localStorage) return null;\n\n  try {\n    const stored = localStorage.getItem(STORAGE_KEY);\n    if (!stored) return null;\n    return JSON.parse(stored);\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Clear stored user identity\n */\nexport function clearStoredUser(): void {\n  if (typeof window === \"undefined\" || !window.localStorage) return;\n\n  try {\n    localStorage.removeItem(STORAGE_KEY);\n  } catch {\n    // Ignore storage errors\n  }\n}\n\n/**\n * Build URL with query parameters\n */\nexport function buildUrl(\n  baseUrl: string,\n  path: string,\n  params?: Record<string, string | string[] | number | undefined>\n): string {\n  const url = new URL(path, baseUrl);\n\n  if (params) {\n    for (const [key, value] of Object.entries(params)) {\n      if (value === undefined) continue;\n\n      if (Array.isArray(value)) {\n        url.searchParams.set(key, value.join(\",\"));\n      } else {\n        url.searchParams.set(key, String(value));\n      }\n    }\n  }\n\n  return url.toString();\n}\n\n/**\n * Check if we're running in a browser environment\n */\nexport function isBrowser(): boolean {\n  return typeof window !== \"undefined\" && typeof document !== \"undefined\";\n}\n\n/**\n * Simple event emitter for SDK events\n */\nexport class EventEmitter<Events extends { [key: string]: unknown }> {\n  private listeners: Map<keyof Events, Set<(data: unknown) => void>> =\n    new Map();\n\n  on<K extends keyof Events>(\n    event: K,\n    callback: (data: Events[K]) => void\n  ): () => void {\n    if (!this.listeners.has(event)) {\n      this.listeners.set(event, new Set());\n    }\n    this.listeners.get(event)!.add(callback as (data: unknown) => void);\n\n    // Return unsubscribe function\n    return () => {\n      this.listeners.get(event)?.delete(callback as (data: unknown) => void);\n    };\n  }\n\n  emit<K extends keyof Events>(event: K, data: Events[K]): void {\n    this.listeners.get(event)?.forEach((callback) => callback(data));\n  }\n\n  off<K extends keyof Events>(\n    event: K,\n    callback: (data: Events[K]) => void\n  ): void {\n    this.listeners.get(event)?.delete(callback as (data: unknown) => void);\n  }\n}\n","/**\n * Feedhog API Client\n * Handles all HTTP communication with the Feedhog API.\n */\n\nimport type {\n  FeedhogConfig,\n  UserIdentity,\n  SubmitFeedbackInput,\n  ListFeedbackOptions,\n  FeedbackListItem,\n  FeedbackDetail,\n  PaginatedResponse,\n  VoteResult,\n  IdentifiedUser,\n  ApiError,\n} from \"./types\";\nimport { buildUrl } from \"./utils\";\n\nconst DEFAULT_BASE_URL = \"https://feedhog.com\";\n\nexport class FeedhogClient {\n  private readonly apiKey: string;\n  private readonly baseUrl: string;\n\n  constructor(config: FeedhogConfig) {\n    if (!config.apiKey) {\n      throw new Error(\"Feedhog: apiKey is required\");\n    }\n\n    this.apiKey = config.apiKey;\n    this.baseUrl = (config.baseUrl || DEFAULT_BASE_URL).replace(/\\/$/, \"\");\n  }\n\n  /**\n   * Make an authenticated API request\n   */\n  private async request<T>(\n    method: string,\n    path: string,\n    options?: {\n      body?: unknown;\n      params?: Record<string, string | string[] | number | undefined>;\n    }\n  ): Promise<T> {\n    const url = options?.params\n      ? buildUrl(this.baseUrl, path, options.params)\n      : `${this.baseUrl}${path}`;\n\n    const response = await fetch(url, {\n      method,\n      headers: {\n        \"Content-Type\": \"application/json\",\n        \"x-api-key\": this.apiKey,\n      },\n      body: options?.body ? JSON.stringify(options.body) : undefined,\n    });\n\n    const data = await response.json();\n\n    if (!response.ok) {\n      const error = data as ApiError;\n      throw new FeedhogApiError(\n        error.error || \"Unknown error\",\n        response.status,\n        error.details\n      );\n    }\n\n    return data as T;\n  }\n\n  /**\n   * Identify or create an end user\n   */\n  async identify(user: UserIdentity): Promise<IdentifiedUser> {\n    const response = await this.request<{ user: IdentifiedUser }>(\n      \"POST\",\n      \"/api/v1/identify\",\n      { body: user }\n    );\n    return response.user;\n  }\n\n  /**\n   * Submit new feedback\n   */\n  async submit(\n    input: SubmitFeedbackInput,\n    user?: UserIdentity\n  ): Promise<FeedbackListItem> {\n    const body: SubmitFeedbackInput & { endUser?: UserIdentity } = {\n      ...input,\n    };\n    if (user) {\n      body.endUser = user;\n    }\n\n    const response = await this.request<{ feedback: FeedbackListItem }>(\n      \"POST\",\n      \"/api/v1/feedback\",\n      { body }\n    );\n    return response.feedback;\n  }\n\n  /**\n   * List feedback items (paginated)\n   */\n  async list(\n    options?: ListFeedbackOptions\n  ): Promise<PaginatedResponse<FeedbackListItem>> {\n    return this.request<PaginatedResponse<FeedbackListItem>>(\n      \"GET\",\n      \"/api/v1/feedback\",\n      {\n        params: {\n          status: options?.status\n            ? Array.isArray(options.status)\n              ? options.status\n              : [options.status]\n            : undefined,\n          type: options?.type\n            ? Array.isArray(options.type)\n              ? options.type\n              : [options.type]\n            : undefined,\n          search: options?.search,\n          sortBy: options?.sortBy,\n          page: options?.page,\n          limit: options?.limit,\n        },\n      }\n    );\n  }\n\n  /**\n   * Get a single feedback item with details\n   */\n  async get(feedbackId: string, endUserId?: string): Promise<FeedbackDetail> {\n    const response = await this.request<{ feedback: FeedbackDetail }>(\n      \"GET\",\n      `/api/v1/feedback/${feedbackId}`,\n      {\n        params: endUserId ? { endUserId } : undefined,\n      }\n    );\n    return response.feedback;\n  }\n\n  /**\n   * Toggle vote on feedback\n   */\n  async vote(feedbackId: string, user?: UserIdentity): Promise<VoteResult> {\n    return this.request<VoteResult>(\"POST\", `/api/v1/feedback/${feedbackId}/vote`, {\n      body: user ? { endUser: user } : {},\n    });\n  }\n\n  /**\n   * Check if user has voted on feedback\n   */\n  async hasVoted(feedbackId: string, endUserId?: string): Promise<VoteResult> {\n    return this.request<VoteResult>(\"GET\", `/api/v1/feedback/${feedbackId}/vote`, {\n      params: endUserId ? { endUserId } : undefined,\n    });\n  }\n}\n\n/**\n * API Error with status code and optional validation details\n */\nexport class FeedhogApiError extends Error {\n  constructor(\n    message: string,\n    public readonly status: number,\n    public readonly details?: {\n      formErrors: string[];\n      fieldErrors: Record<string, string[]>;\n    }\n  ) {\n    super(message);\n    this.name = \"FeedhogApiError\";\n  }\n}\n"],"mappings":"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","names":[]}