cupthread-android-sdk/dev.cupthread.feedback/FeatureRequestItem

FeatureRequestItem

data class FeatureRequestItem(val id: String, val appId: String, val title: String, val description: String, val status: String, val columnId: String?, val columnSlug: String?, val columnName: String?, val columnColor: String? = null, val versionId: String?, val versionLabel: String?, val releasedVersion: String?, val requesterName: String?, val requesterAvatarUrl: String? = null, val requesterClerkId: String? = null, val approved: Boolean, val voteCount: Int, val hasVoted: Boolean, val isOwnRequest: Boolean, val recentCommenters: List<RecentCommenter> = emptyList(), val hasMoreCommenters: Boolean = false, val createdAt: String, val updatedAt: String)(source)

A public feature request, as returned by FeedbackClient.fetchFeatureRequests.

Includes live vote counts, the current user's vote state, roadmap column placement, moderation status, and recent commenter avatars.

Example:

val result = client.fetchFeatureRequests(userToken = token)
result.requests.forEach { item ->
    println("${item.title} - ${item.voteCount} votes (Voted: ${item.hasVoted})")
}

Constructors

FeatureRequestItem

constructor(id: String, appId: String, title: String, description: String, status: String, columnId: String?, columnSlug: String?, columnName: String?, columnColor: String? = null, versionId: String?, versionLabel: String?, releasedVersion: String?, requesterName: String?, requesterAvatarUrl: String? = null, requesterClerkId: String? = null, approved: Boolean, voteCount: Int, hasVoted: Boolean, isOwnRequest: Boolean, recentCommenters: List<RecentCommenter> = emptyList(), hasMoreCommenters: Boolean = false, createdAt: String, updatedAt: String)

Properties

val appId: String

Identifier of the owning application.

val approved: Boolean

Whether a moderator has approved this request for public display.

val columnColor: String?

Optional accent color of the associated column.

val columnId: String?

Associated roadmap BoardColumn ID, or null if uncategorized.

val columnName: String?

Display name of the associated roadmap column, or null.

val columnSlug: String?

Slug of the associated roadmap column, or null.

val createdAt: String

ISO 8601 creation timestamp.

val description: String

Detailed description; may contain inline Markdown formatting rendered by dev.cupthread.feedback.ui.MarkdownText.

hasMoreCommenters

val hasMoreCommenters: Boolean

Whether additional commenters exist beyond recentCommenters.

val hasVoted: Boolean

Whether the current user (identified by userToken) has upvoted this request.

Unique identifier for the feature request; used in FeedbackClient.toggleVote and comments.

val isOwnRequest: Boolean

Whether the current user created this request (users cannot vote on their own requests).

recentCommenters

val recentCommenters: List<RecentCommenter>

Up to 3 most recent commenters for rendering avatar stacks.

releasedVersion

val releasedVersion: String?

Actual release version label once shipped, or null.

requesterAvatarUrl

val requesterAvatarUrl: String?

Hosted avatar image URL of the requester, or null.

requesterClerkId

val requesterClerkId: String?

User account ID of the requester if signed in, or null.

val requesterName: String?

Display name of the user who submitted the request, or null.

val stageName: String

Display name of the roadmap stage: returns columnName when on the board, otherwise falls back to the raw status slug.

val status: String

Workflow status slug (e.g., "backlog", "planned", "completed").

val title: String

Brief summary of the proposed feature.

val updatedAt: String

ISO 8601 last update timestamp.

val versionId: String?

Target AppVersion ID where this feature is scheduled to ship, or null.

val versionLabel: String?

Display label of the target release version, or null.

val voteCount: Int

Total number of upvotes.

Functions

fun withVoteState(voted: Boolean, count: Int): FeatureRequestItem

Creates a copy of this item with updated vote state.