x-api-key: fhpk_your_public_key

curl -X POST https://feedhog.com/api/v1/identify \
  -H "Content-Type: application/json" \
  -H "x-api-key: fhpk_your_public_key" \
  -d '{
    "externalId": "user-123",
    "email": "user@example.com",
    "name": "John Doe",
    "avatarUrl": "https://example.com/avatar.jpg",
    "metadata": {
      "plan": "pro",
      "company": "Acme Inc"
    }
  }'

{
  "user": {
    "id": "user-123",
    "email": "user@example.com",
    "name": "John Doe",
    "avatarUrl": "https://example.com/avatar.jpg",
    "createdAt": "2024-01-15T10:30:00.000Z"
  }
}

curl -X POST https://feedhog.com/api/v1/feedback \
  -H "Content-Type: application/json" \
  -H "x-api-key: fhpk_your_public_key" \
  -d '{
    "title": "Add dark mode",
    "description": "Would love a dark theme option for better night-time usage",
    "type": "idea",
    "metadata": {
      "page": "/settings",
      "browser": "Chrome"
    },
    "endUser": {
      "externalId": "user-123",
      "email": "user@example.com",
      "name": "John Doe"
    }
  }'

{
  "feedback": {
    "id": "fb_abc123xyz",
    "title": "Add dark mode",
    "description": "Would love a dark theme option for better night-time usage",
    "type": "idea",
    "status": "new",
    "voteCount": 1,
    "commentCount": 0,
    "createdAt": "2024-01-15T10:30:00.000Z",
    "endUser": {
      "name": "John Doe",
      "avatarUrl": null
    }
  }
}

curl -X GET "https://feedhog.com/api/v1/feedback?status=planned,in-progress&type=idea&sortBy=votes&page=1&limit=10" \
  -H "x-api-key: fhpk_your_public_key"

{
  "items": [
    {
      "id": "fb_abc123xyz",
      "title": "Add dark mode",
      "description": "Would love a dark theme option",
      "type": "idea",
      "status": "planned",
      "voteCount": 42,
      "commentCount": 5,
      "createdAt": "2024-01-15T10:30:00.000Z",
      "endUser": {
        "name": "John Doe",
        "avatarUrl": null
      }
    }
  ],
  "total": 42,
  "page": 1,
  "limit": 10,
  "totalPages": 5
}

curl -X GET "https://feedhog.com/api/v1/feedback/fb_abc123xyz?endUserId=user-123" \
  -H "x-api-key: fhpk_your_public_key"

{
  "feedback": {
    "id": "fb_abc123xyz",
    "title": "Add dark mode",
    "description": "Would love a dark theme option",
    "type": "idea",
    "status": "planned",
    "voteCount": 42,
    "commentCount": 2,
    "createdAt": "2024-01-15T10:30:00.000Z",
    "userHasVoted": true,
    "endUser": {
      "name": "John Doe",
      "avatarUrl": null
    },
    "comments": [
      {
        "id": "cmt_xyz789",
        "content": "Great idea! We're planning to add this in Q2.",
        "createdAt": "2024-01-16T09:00:00.000Z",
        "author": {
          "name": "Product Team",
          "isTeam": true
        }
      },
      {
        "id": "cmt_abc456",
        "content": "Can't wait for this feature!",
        "createdAt": "2024-01-16T10:30:00.000Z",
        "author": {
          "name": "Jane Smith",
          "avatarUrl": "https://example.com/jane.jpg"
        }
      }
    ]
  }
}

curl -X POST https://feedhog.com/api/v1/feedback/fb_abc123xyz/vote \
  -H "Content-Type: application/json" \
  -H "x-api-key: fhpk_your_public_key" \
  -d '{
    "endUser": {
      "externalId": "user-123",
      "email": "user@example.com"
    }
  }'

curl -X POST https://feedhog.com/api/v1/feedback/fb_abc123xyz/vote \
  -H "Content-Type: application/json" \
  -H "x-api-key: fhpk_your_public_key" \
  -d '{}'

{
  "voted": true,
  "voteCount": 43
}

curl -X GET "https://feedhog.com/api/v1/feedback/fb_abc123xyz/vote?endUserId=user-123" \
  -H "x-api-key: fhpk_your_public_key"

{
  "voted": true,
  "voteCount": 43
}

{
  "error": "Invalid input",
  "details": {
    "formErrors": [],
    "fieldErrors": {
      "title": ["Title is required"],
      "type": ["Invalid type. Must be one of: bug, idea, question, other"]
    }
  }
}

{
  "error": "Missing x-api-key header"
}

{
  "error": "Invalid API key"
}

{
  "error": "Feedback not found"
}

{
  "error": "Too many requests, please slow down"
}

{
  "error": "Internal server error"
}

type FeedbackType = "bug" | "idea" | "question" | "other";

type FeedbackStatus =
  | "new"
  | "under-review"
  | "planned"
  | "in-progress"
  | "completed"
  | "closed";

interface FeedbackListItem {
  id: string;
  title: string;
  description: string | null;
  type: FeedbackType;
  status: FeedbackStatus;
  voteCount: number;
  commentCount: number;
  createdAt: string;
  endUser: {
    name: string | null;
    avatarUrl: string | null;
  } | null;
}

interface FeedbackDetail extends FeedbackListItem {
  userHasVoted: boolean;
  comments: {
    id: string;
    content: string;
    createdAt: string;
    author: {
      name: string | null;
      avatarUrl?: string | null;
      isTeam?: boolean;
    } | null;
  }[];
}

interface IdentifiedUser {
  id: string;
  email: string | null;
  name: string | null;
  avatarUrl: string | null;
  createdAt: string;
}

interface VoteResult {
  voted: boolean;
  voteCount: number;
}

interface PaginatedResponse<T> {
  items: T[];
  total: number;
  page: number;
  limit: number;
  totalPages: number;
}