v0.5.0: batch-first API, player/leaderboard handles, unified naming, Storage is global project storage, catalog list methods

quests.go

@@ -4,6 +4,7 @@ import (
 	"context"
 	"net/http"
 	"net/url"
+	"strconv"
 
 	"hub.rudder.build/rudder/rudder-go-sdk/models"
 )
@@ -12,31 +13,66 @@ type QuestsService struct {
 	transport *transport
 }
 
-func (s *QuestsService) ListPlayerQuests(ctx context.Context, playerID string) ([]models.AdminPlayerQuest, error) {
-	var response models.ListPlayerQuestsResponse
-	if err := s.transport.do(ctx, http.MethodGet, "/players/"+url.PathEscape(playerID)+"/quests", nil, nil, &response); err != nil {
+type ListQuestsParameters struct {
+	Status *string
+	Limit  int
+	Cursor *string
+}
+
+func (s *QuestsService) List(ctx context.Context, parameters ListQuestsParameters) (*models.AdminListQuestsResponse, error) {
+	query := url.Values{}
+	if parameters.Status != nil {
+		query.Set("status", *parameters.Status)
+	}
+	if parameters.Limit > 0 {
+		query.Set("limit", strconv.Itoa(parameters.Limit))
+	}
+	if parameters.Cursor != nil {
+		query.Set("cursor", *parameters.Cursor)
+	}
+
+	var response models.AdminListQuestsResponse
+	if err := s.transport.do(ctx, http.MethodGet, "/quests", query, nil, &response); err != nil {
 		return nil, err
 	}
-	return response.Quests, nil
+	return &response, nil
 }
 
-func (s *QuestsService) ResetPlayerQuest(ctx context.Context, playerID string, questID string) error {
-	body := models.AdminPlayerQuestRequest{
-		QuestID: questID,
-	}
-	return s.transport.do(ctx, http.MethodPost, "/players/"+url.PathEscape(playerID)+"/quests/reset", nil, body, nil)
+type ResetPlayerQuestsParameters struct {
+	IdempotencyKey string
+	Items          []models.BatchPlayerQuestsItem
 }
 
-func (s *QuestsService) ForceCompletePlayerQuest(ctx context.Context, playerID string, questID string) error {
-	body := models.AdminPlayerQuestRequest{
-		QuestID: questID,
+func (s *QuestsService) Reset(ctx context.Context, parameters ResetPlayerQuestsParameters) error {
+	body := models.BatchPlayerQuestsRequest{
+		IdempotencyKey: parameters.IdempotencyKey,
+		Items:          parameters.Items,
 	}
-	return s.transport.do(ctx, http.MethodPost, "/players/"+url.PathEscape(playerID)+"/quests/force-complete", nil, body, nil)
+	return s.transport.do(ctx, http.MethodPost, "/players/quests/reset", nil, body, nil)
 }
 
-func (s *QuestsService) ForceClaimPlayerQuest(ctx context.Context, playerID string, questID string) error {
-	body := models.AdminPlayerQuestRequest{
-		QuestID: questID,
-	}
-	return s.transport.do(ctx, http.MethodPost, "/players/"+url.PathEscape(playerID)+"/quests/force-claim", nil, body, nil)
+type ForceCompletePlayerQuestsParameters struct {
+	IdempotencyKey string
+	Items          []models.BatchPlayerQuestsItem
+}
+
+func (s *QuestsService) ForceComplete(ctx context.Context, parameters ForceCompletePlayerQuestsParameters) error {
+	body := models.BatchPlayerQuestsRequest{
+		IdempotencyKey: parameters.IdempotencyKey,
+		Items:          parameters.Items,
+	}
+	return s.transport.do(ctx, http.MethodPost, "/players/quests/force-complete", nil, body, nil)
+}
+
+type ForceClaimPlayerQuestsParameters struct {
+	IdempotencyKey string
+	Items          []models.BatchPlayerQuestsItem
+}
+
+func (s *QuestsService) ForceClaim(ctx context.Context, parameters ForceClaimPlayerQuestsParameters) error {
+	body := models.BatchPlayerQuestsRequest{
+		IdempotencyKey: parameters.IdempotencyKey,
+		Items:          parameters.Items,
+	}
+	return s.transport.do(ctx, http.MethodPost, "/players/quests/force-claim", nil, body, nil)
 }