Feature Requests

// Get all requests
const { data, total } = await stackbe.featureRequests.list();

// Filter by status
const planned = await stackbe.featureRequests.list({
  status: 'planned'
});

// Sort by votes (most popular first)
const popular = await stackbe.featureRequests.list({
  sortBy: 'votes'
});

// Filter by category
const uiRequests = await stackbe.featureRequests.list({
  category: 'UI',
  sortBy: 'newest',
});

const request = await stackbe.featureRequests.create({
  title: 'Export to PDF',
  description: 'Allow exporting reports as PDF documents',
  category: 'Export', // optional
});

console.log(request.id); // 'req_abc123'

// Upvote a request (idempotent - safe to call multiple times)
const { voteCount, alreadyVoted } = await stackbe.featureRequests.vote('req_123');

// Remove your vote
const { voteCount } = await stackbe.featureRequests.removeVote('req_123');

// Add a comment
await stackbe.featureRequests.addComment('req_123', {
  content: 'This would save me hours every week!',
});

// Get request with all comments
const request = await stackbe.featureRequests.get('req_123');
request.comments.forEach(c => {
  console.log(`${c.customerEmail}: ${c.content}`);
  if (c.isAdminReply) console.log('  ^ Official response');
});

// Mark as planned
await stackbe.featureRequests.update('req_123', {
  status: 'planned',
});

// Start working on it
await stackbe.featureRequests.update('req_123', {
  status: 'in_progress',
  category: 'Q1 2025',
});

// Mark as completed
await stackbe.featureRequests.update('req_123', {
  status: 'completed',
});

const {
  author,
  voters,
  totalInterested
} = await stackbe.featureRequests.getInterestedCustomers('req_123');

console.log(`${totalInterested} users want this feature`);

// Author info
console.log(`Submitted by: ${author.email} on ${author.submittedAt}`);

// All voters
voters.forEach(v => {
  console.log(`Voted: ${v.email} on ${v.votedAt}`);
});

// Get all emails to notify when feature ships
const emails = [author.email, ...voters.map(v => v.email)];
await sendNotification(emails, 'Your requested feature is now live!');

const activity = await stackbe.featureRequests.getCustomerActivity('cust_123');

console.log(`Submitted ${activity.totalSubmitted} requests`);
console.log(`Voted on ${activity.totalVotes} requests`);

// Their submitted requests
activity.submitted.forEach(r => {
  console.log(`Submitted: ${r.title} (${r.status}) - ${r.voteCount} votes`);
});

// Requests they voted on
activity.votedOn.forEach(r => {
  console.log(`Interested in: ${r.title} (${r.status})`);
});

// Delete spam or duplicate requests
await stackbe.featureRequests.delete('req_123');