@feedhog/js 0.1.0

package/dist/index.js

@@ -0,0 +1,398 @@
+// 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;
+export {
+  Feedhog,
+  FeedhogApiError,
+  index_default as default
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/utils.ts","../src/client.ts","../src/index.ts"],"sourcesContent":["/**\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","/**\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"],"mappings":"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","names":[]}

package/dist/index.min.js

@@ -0,0 +1,2 @@
+"use strict";var Feedhog=(()=>{var l=Object.defineProperty;var k=Object.getOwnPropertyDescriptor;var w=Object.getOwnPropertyNames;var U=Object.prototype.hasOwnProperty;var v=(s,e)=>{for(var t in e)l(s,t,{get:e[t],enumerable:!0})},F=(s,e,t,r)=>{if(e&&typeof e=="object"||typeof e=="function")for(let i of w(e))!U.call(s,i)&&i!==t&&l(s,i,{get:()=>e[i],enumerable:!(r=k(e,i))||r.enumerable});return s};var I=s=>F(l({},"__esModule",{value:!0}),s);var P={};v(P,{Feedhog:()=>u,FeedhogApiError:()=>a,default:()=>S});var f="feedhog_user";function h(s){if(!(typeof window>"u"||!window.localStorage))try{localStorage.setItem(f,JSON.stringify(s))}catch{}}function g(){if(typeof window>"u"||!window.localStorage)return null;try{let s=localStorage.getItem(f);return s?JSON.parse(s):null}catch{return null}}function m(){if(!(typeof window>"u"||!window.localStorage))try{localStorage.removeItem(f)}catch{}}function b(s,e,t){let r=new URL(e,s);if(t)for(let[i,n]of Object.entries(t))n!==void 0&&(Array.isArray(n)?r.searchParams.set(i,n.join(",")):r.searchParams.set(i,String(n)));return r.toString()}function d(){return typeof window<"u"&&typeof document<"u"}var o=class{constructor(){this.listeners=new Map}on(e,t){return this.listeners.has(e)||this.listeners.set(e,new Set),this.listeners.get(e).add(t),()=>{this.listeners.get(e)?.delete(t)}}emit(e,t){this.listeners.get(e)?.forEach(r=>r(t))}off(e,t){this.listeners.get(e)?.delete(t)}};var E="https://feedhog.com",c=class{constructor(e){if(!e.apiKey)throw new Error("Feedhog: apiKey is required");this.apiKey=e.apiKey,this.baseUrl=(e.baseUrl||E).replace(/\/$/,"")}async request(e,t,r){let i=r?.params?b(this.baseUrl,t,r.params):`${this.baseUrl}${t}`,n=await fetch(i,{method:e,headers:{"Content-Type":"application/json","x-api-key":this.apiKey},body:r?.body?JSON.stringify(r.body):void 0}),y=await n.json();if(!n.ok){let p=y;throw new a(p.error||"Unknown error",n.status,p.details)}return y}async identify(e){return(await this.request("POST","/api/v1/identify",{body:e})).user}async submit(e,t){let r={...e};return t&&(r.endUser=t),(await this.request("POST","/api/v1/feedback",{body:r})).feedback}async list(e){return this.request("GET","/api/v1/feedback",{params:{status:e?.status?Array.isArray(e.status)?e.status:[e.status]:void 0,type:e?.type?Array.isArray(e.type)?e.type:[e.type]:void 0,search:e?.search,sortBy:e?.sortBy,page:e?.page,limit:e?.limit}})}async get(e,t){return(await this.request("GET",`/api/v1/feedback/${e}`,{params:t?{endUserId:t}:void 0})).feedback}async vote(e,t){return this.request("POST",`/api/v1/feedback/${e}/vote`,{body:t?{endUser:t}:{}})}async hasVoted(e,t){return this.request("GET",`/api/v1/feedback/${e}/vote`,{params:t?{endUserId:t}:void 0})}},a=class extends Error{constructor(t,r,i){super(t);this.status=r;this.details=i;this.name="FeedhogApiError"}};var u=class extends o{constructor(t){super();this.currentUser=null;if(this.client=new c(t),d()){let r=g();r&&(this.currentUser={...r,identified:!1})}}get user(){return this.currentUser}async identify(t){try{let r=await this.client.identify(t);return this.currentUser={...t,identified:!0},d()&&h(t),this.emit("identify",r),r}catch(r){throw this.emit("error",r),r}}async submit(t){try{let r=await this.client.submit(t,this.currentUser||void 0);return this.emit("submit",r),r}catch(r){throw this.emit("error",r),r}}async list(t){try{return await this.client.list(t)}catch(r){throw this.emit("error",r),r}}async get(t){try{return await this.client.get(t,this.currentUser?.externalId)}catch(r){throw this.emit("error",r),r}}async vote(t){try{let r=await this.client.vote(t,this.currentUser||void 0);return this.emit("vote",{feedbackId:t,result:r}),r}catch(r){throw this.emit("error",r),r}}async hasVoted(t){try{return await this.client.hasVoted(t,this.currentUser?.externalId)}catch(r){throw this.emit("error",r),r}}reset(){this.currentUser=null,d()&&m(),this.emit("reset",void 0)}},S=u;return I(P);})();
+if(typeof Feedhog!=='undefined'&&Feedhog.default)window.Feedhog=Feedhog.default;

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@feedhog/js",
+  "version": "0.1.0",
+  "description": "JavaScript SDK for Feedhog - collect user feedback from any website or app",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  },
+  "keywords": [
+    "feedhog",
+    "feedback",
+    "user-feedback",
+    "widget",
+    "sdk"
+  ],
+  "author": "Feedhog",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/feedhog/feedhog"
+  },
+  "homepage": "https://feedhog.com/docs",
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "typescript": "^5.3.0"
+  },
+  "peerDependencies": {},
+  "engines": {
+    "node": ">=18"
+  }
+}