fizzy-cli 0.6.1 → 0.8.0

package/docs/API.md

@@ -553,7 +553,8 @@ __Response:__
       "created_at": "2025-12-05T19:36:35.401Z",
       "url": "http://fizzy.localhost:3006/897362094/users/03f5v9zjw7pz8717a4no1h8a7"
     },
-    "comments_url": "http://fizzy.localhost:3006/897362094/cards/4/comments"
+    "comments_url": "http://fizzy.localhost:3006/897362094/cards/4/comments",
+    "reactions_url": "http://fizzy.localhost:3006/897362094/cards/4/reactions"
   },
 ]
 ```
@@ -614,6 +615,7 @@ __Response:__
     "url": "http://fizzy.localhost:3006/897362094/users/03f5v9zjw7pz8717a4no1h8a7"
   },
   "comments_url": "http://fizzy.localhost:3006/897362094/cards/4/comments",
+  "reactions_url": "http://fizzy.localhost:3006/897362094/cards/4/reactions",
   "steps": [
     {
       "id": "03f8huu0sog76g3s975963b5e",
@@ -928,7 +930,66 @@ __Response:__
 
 Returns `204 No Content` on success.
 
-## Reactions
+## Card Reactions (Boosts)
+
+Card reactions (also called "boosts") let users add short responses directly to cards. These are limited to 16 characters.
+
+### `GET /:account_slug/cards/:card_number/reactions`
+
+Returns a list of reactions on a card.
+
+__Response:__
+
+```json
+[
+  {
+    "id": "03f5v9zo9qlcwwpyc0ascnikz",
+    "content": "👍",
+    "reacter": {
+      "id": "03f5v9zjw7pz8717a4no1h8a7",
+      "name": "David Heinemeier Hansson",
+      "role": "owner",
+      "active": true,
+      "email_address": "david@example.com",
+      "created_at": "2025-12-05T19:36:35.401Z",
+      "url": "http://fizzy.localhost:3006/897362094/users/03f5v9zjw7pz8717a4no1h8a7"
+    },
+    "url": "http://fizzy.localhost:3006/897362094/cards/3/reactions/03f5v9zo9qlcwwpyc0ascnikz"
+  }
+]
+```
+
+### `POST /:account_slug/cards/:card_number/reactions`
+
+Adds a reaction (boost) to a card.
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `content` | string | Yes | The reaction text (max 16 characters) |
+
+__Request:__
+
+```json
+{
+  "reaction": {
+    "content": "Great 👍"
+  }
+}
+```
+
+__Response:__
+
+Returns `201 Created` on success.
+
+### `DELETE /:account_slug/cards/:card_number/reactions/:reaction_id`
+
+Removes your reaction from a card. Only the reaction creator can remove their own reactions.
+
+__Response:__
+
+Returns `204 No Content` on success.
+
+## Comment Reactions
 
 Reactions are short (16-character max) responses to comments.
 

package/internal/api/boards.go

@@ -57,3 +57,37 @@ func (c *Client) PostBoards(ctx context.Context, payload CreateBoardPayload) (bo
 
 	return true, nil
 }
+
+func (c *Client) PutBoard(ctx context.Context, boardID string, payload UpdateBoardPayload) error {
+	endpointURL := c.AccountBaseURL + "/boards/" + boardID
+
+	body := map[string]UpdateBoardPayload{"board": payload}
+
+	req, err := c.newRequest(ctx, http.MethodPut, endpointURL, body)
+	if err != nil {
+		return fmt.Errorf("failed to create update board request: %w", err)
+	}
+
+	_, err = c.decodeResponse(req, nil, http.StatusNoContent)
+	if err != nil {
+		return err
+	}
+
+	return nil
+}
+
+func (c *Client) DeleteBoard(ctx context.Context, boardID string) error {
+	endpointURL := c.AccountBaseURL + "/boards/" + boardID
+
+	req, err := c.newRequest(ctx, http.MethodDelete, endpointURL, nil)
+	if err != nil {
+		return fmt.Errorf("failed to create delete board request: %w", err)
+	}
+
+	_, err = c.decodeResponse(req, nil, http.StatusNoContent)
+	if err != nil {
+		return err
+	}
+
+	return nil
+}

package/internal/api/cards.go

@@ -14,14 +14,48 @@ func (c *Client) GetCards(ctx context.Context, filters CardFilters) ([]Card, err
 		return nil, fmt.Errorf("failed to create get cards request: %w", err)
 	}
 
-	if len(filters.BoardIDs) > 0 {
-		q := req.URL.Query()
-		for _, boardID := range filters.BoardIDs {
-			q.Add("board_ids[]", boardID)
-		}
-		req.URL.RawQuery = q.Encode()
+	q := req.URL.Query()
+
+	for _, boardID := range filters.BoardIDs {
+		q.Add("board_ids[]", boardID)
+	}
+	for _, tagID := range filters.TagIDs {
+		q.Add("tag_ids[]", tagID)
+	}
+	for _, assigneeID := range filters.AssigneeIDs {
+		q.Add("assignee_ids[]", assigneeID)
+	}
+	for _, creatorID := range filters.CreatorIDs {
+		q.Add("creator_ids[]", creatorID)
+	}
+	for _, closerID := range filters.CloserIDs {
+		q.Add("closer_ids[]", closerID)
+	}
+	for _, cardID := range filters.CardIDs {
+		q.Add("card_ids[]", cardID)
+	}
+	for _, term := range filters.Terms {
+		q.Add("terms[]", term)
 	}
 
+	if filters.IndexedBy != "" {
+		q.Set("indexed_by", filters.IndexedBy)
+	}
+	if filters.SortedBy != "" {
+		q.Set("sorted_by", filters.SortedBy)
+	}
+	if filters.AssignmentStatus != "" {
+		q.Set("assignment_status", filters.AssignmentStatus)
+	}
+	if filters.CreationStatus != "" {
+		q.Set("creation", filters.CreationStatus)
+	}
+	if filters.ClosureStatus != "" {
+		q.Set("closure", filters.ClosureStatus)
+	}
+
+	req.URL.RawQuery = q.Encode()
+
 	var response []Card
 	_, err = c.decodeResponse(req, &response)
 	if err != nil {

package/internal/api/columns.go

@@ -27,6 +27,27 @@ func (c *Client) GetColumns(ctx context.Context) ([]Column, error) {
 	return response, nil
 }
 
+func (c *Client) GetColumn(ctx context.Context, columnID string) (*Column, error) {
+	if c.BoardBaseURL == "" {
+		return nil, fmt.Errorf("please select a board first with 'fizzy use --board <board_name>'")
+	}
+
+	endpointURL := c.BoardBaseURL + "/columns/" + columnID
+
+	req, err := c.newRequest(ctx, http.MethodGet, endpointURL, nil)
+	if err != nil {
+		return nil, fmt.Errorf("failed to create request: %w", err)
+	}
+
+	var response Column
+	_, err = c.decodeResponse(req, &response)
+	if err != nil {
+		return nil, err
+	}
+
+	return &response, nil
+}
+
 func (c *Client) PostColumns(ctx context.Context, payload CreateColumnPayload) (bool, error) {
 	if c.BoardBaseURL == "" {
 		return false, fmt.Errorf("please select a board first with 'fizzy use --board <board_name>'")
@@ -48,3 +69,45 @@ func (c *Client) PostColumns(ctx context.Context, payload CreateColumnPayload) (
 
 	return true, nil
 }
+
+func (c *Client) PutColumn(ctx context.Context, columnID string, payload UpdateColumnPayload) error {
+	if c.BoardBaseURL == "" {
+		return fmt.Errorf("please select a board first with 'fizzy use --board <board_name>'")
+	}
+
+	endpointURL := c.BoardBaseURL + "/columns/" + columnID
+
+	body := map[string]UpdateColumnPayload{"column": payload}
+
+	req, err := c.newRequest(ctx, http.MethodPut, endpointURL, body)
+	if err != nil {
+		return fmt.Errorf("failed to create update column request: %w", err)
+	}
+
+	_, err = c.decodeResponse(req, nil, http.StatusNoContent)
+	if err != nil {
+		return err
+	}
+
+	return nil
+}
+
+func (c *Client) DeleteColumn(ctx context.Context, columnID string) error {
+	if c.BoardBaseURL == "" {
+		return fmt.Errorf("please select a board first with 'fizzy use --board <board_name>'")
+	}
+
+	endpointURL := c.BoardBaseURL + "/columns/" + columnID
+
+	req, err := c.newRequest(ctx, http.MethodDelete, endpointURL, nil)
+	if err != nil {
+		return fmt.Errorf("failed to create delete column request: %w", err)
+	}
+
+	_, err = c.decodeResponse(req, nil, http.StatusNoContent)
+	if err != nil {
+		return err
+	}
+
+	return nil
+}

package/internal/api/reactions.go

@@ -67,3 +67,64 @@ func (c *Client) DeleteCommentReaction(ctx context.Context, cardNumber int, comm
 
 	return true, nil
 }
+
+func (c *Client) GetCardReactions(ctx context.Context, cardNumber int) ([]Reaction, error) {
+	endpointURL := fmt.Sprintf("%s/cards/%d/reactions", c.AccountBaseURL, cardNumber)
+
+	req, err := c.newRequest(ctx, http.MethodGet, endpointURL, nil)
+	if err != nil {
+		return nil, fmt.Errorf("failed to create get card reactions request: %w", err)
+	}
+
+	var response []Reaction
+	_, err = c.decodeResponse(req, &response)
+	if err != nil {
+		return nil, err
+	}
+
+	return response, nil
+}
+
+func (c *Client) PostCardReaction(ctx context.Context, cardNumber int, content string) (*Reaction, error) {
+	endpointURL := fmt.Sprintf("%s/cards/%d/reactions", c.AccountBaseURL, cardNumber)
+
+	payload := map[string]map[string]string{
+		"reaction": {"content": content},
+	}
+
+	req, err := c.newRequest(ctx, http.MethodPost, endpointURL, payload)
+	if err != nil {
+		return nil, fmt.Errorf("failed to create post card reaction request: %w", err)
+	}
+
+	res, err := c.HTTPClient.Do(req)
+	if err != nil {
+		return nil, fmt.Errorf("failed to make request: %w", err)
+	}
+	defer res.Body.Close()
+
+	if res.StatusCode != http.StatusCreated {
+		body, _ := io.ReadAll(res.Body)
+		return nil, fmt.Errorf("unexpected status code %d: %s", res.StatusCode, string(body))
+	}
+
+	// API returns 201 Created with Location header, not a response body
+	// Return a Reaction object with the content field set for reference
+	return &Reaction{Content: content}, nil
+}
+
+func (c *Client) DeleteCardReaction(ctx context.Context, cardNumber int, reactionID string) (bool, error) {
+	endpointURL := fmt.Sprintf("%s/cards/%d/reactions/%s", c.AccountBaseURL, cardNumber, reactionID)
+
+	req, err := c.newRequest(ctx, http.MethodDelete, endpointURL, nil)
+	if err != nil {
+		return false, fmt.Errorf("failed to create delete card reaction request: %w", err)
+	}
+
+	_, err = c.decodeResponse(req, nil, http.StatusNoContent)
+	if err != nil {
+		return false, err
+	}
+
+	return true, nil
+}

package/internal/api/types.go

@@ -18,6 +18,13 @@ type CreateBoardPayload struct {
 	PublicDescription  string `json:"public_description"`
 }
 
+type UpdateBoardPayload struct {
+	Name               string `json:"name,omitempty"`
+	AllAccess          *bool  `json:"all_access,omitempty"`
+	AutoPostponePeriod *int   `json:"auto_postpone_period,omitempty"`
+	PublicDescription  string `json:"public_description,omitempty"`
+}
+
 type Column struct {
 	ID        string      `json:"id"`
 	Name      string      `json:"name"`
@@ -35,6 +42,11 @@ type CreateColumnPayload struct {
 	Color *Color `json:"color,omitempty"`
 }
 
+type UpdateColumnPayload struct {
+	Name  string `json:"name,omitempty"`
+	Color *Color `json:"color,omitempty"`
+}
+
 type Card struct {
 	ID              string   `json:"id"`
 	Number          int      `json:"number"`
@@ -109,6 +121,11 @@ type User struct {
 	URL       string `json:"url"`
 }
 
+type UpdateUserPayload struct {
+	Name   string `json:"name,omitempty"`
+	Avatar string `json:"avatar,omitempty"`
+}
+
 type Notification struct {
 	ID        string        `json:"id"`
 	Read      bool          `json:"read"`

package/internal/api/users.go

@@ -0,0 +1,75 @@
+package api
+
+import (
+	"context"
+	"fmt"
+	"net/http"
+)
+
+func (c *Client) GetUsers(ctx context.Context) ([]User, error) {
+	endpointURL := c.AccountBaseURL + "/users"
+
+	req, err := c.newRequest(ctx, http.MethodGet, endpointURL, nil)
+	if err != nil {
+		return nil, fmt.Errorf("failed to create request: %w", err)
+	}
+
+	var response []User
+	_, err = c.decodeResponse(req, &response)
+	if err != nil {
+		return nil, err
+	}
+
+	return response, nil
+}
+
+func (c *Client) GetUser(ctx context.Context, userID string) (*User, error) {
+	endpointURL := c.AccountBaseURL + "/users/" + userID
+
+	req, err := c.newRequest(ctx, http.MethodGet, endpointURL, nil)
+	if err != nil {
+		return nil, fmt.Errorf("failed to create request: %w", err)
+	}
+
+	var response User
+	_, err = c.decodeResponse(req, &response)
+	if err != nil {
+		return nil, err
+	}
+
+	return &response, nil
+}
+
+func (c *Client) PutUser(ctx context.Context, userID string, payload UpdateUserPayload) error {
+	endpointURL := c.AccountBaseURL + "/users/" + userID
+
+	body := map[string]UpdateUserPayload{"user": payload}
+
+	req, err := c.newRequest(ctx, http.MethodPut, endpointURL, body)
+	if err != nil {
+		return fmt.Errorf("failed to create update user request: %w", err)
+	}
+
+	_, err = c.decodeResponse(req, nil, http.StatusNoContent)
+	if err != nil {
+		return err
+	}
+
+	return nil
+}
+
+func (c *Client) DeleteUser(ctx context.Context, userID string) error {
+	endpointURL := c.AccountBaseURL + "/users/" + userID
+
+	req, err := c.newRequest(ctx, http.MethodDelete, endpointURL, nil)
+	if err != nil {
+		return fmt.Errorf("failed to create delete user request: %w", err)
+	}
+
+	_, err = c.decodeResponse(req, nil, http.StatusNoContent)
+	if err != nil {
+		return err
+	}
+
+	return nil
+}

package/internal/ui/board_show.go

@@ -0,0 +1,17 @@
+package ui
+
+import (
+	"fmt"
+	"io"
+
+	"github.com/rogeriopvl/fizzy/internal/api"
+)
+
+func DisplayBoard(w io.Writer, board *api.Board) error {
+	fmt.Fprintf(w, "Board: %s\n", board.Name)
+	fmt.Fprintf(w, "ID: %s\n", board.ID)
+	fmt.Fprintf(w, "All Access: %v\n", board.AllAccess)
+	fmt.Fprintf(w, "Created At: %s\n", FormatTime(board.CreatedAt))
+	fmt.Fprintf(w, "Created By: %s\n", board.Creator.Name)
+	return nil
+}

package/internal/ui/column_show.go

@@ -0,0 +1,16 @@
+package ui
+
+import (
+	"fmt"
+	"io"
+
+	"github.com/rogeriopvl/fizzy/internal/api"
+)
+
+func DisplayColumn(w io.Writer, column *api.Column) error {
+	fmt.Fprintf(w, "Column: %s\n", column.Name)
+	fmt.Fprintf(w, "ID: %s\n", column.ID)
+	fmt.Fprintf(w, "Color: %s (%s)\n", column.Color.Name, column.Color.Value)
+	fmt.Fprintf(w, "Created At: %s\n", FormatTime(column.CreatedAt))
+	return nil
+}

package/internal/ui/format.go

@@ -1,6 +1,9 @@
 package ui
 
-import "github.com/charmbracelet/lipgloss"
+import (
+	"github.com/charmbracelet/lipgloss"
+	"time"
+)
 
 // DisplayMeta returns a formatted metadata string with greyed out styling
 func DisplayMeta(label string, value string) string {
@@ -12,3 +15,13 @@ func DisplayMeta(label string, value string) string {
 func DisplayID(id string) string {
 	return DisplayMeta("id", id)
 }
+
+// FormatTime converts an RFC3339 timestamp string to a human-readable format.
+// If parsing fails, returns the original string.
+func FormatTime(timeStr string) string {
+	t, err := time.Parse(time.RFC3339, timeStr)
+	if err != nil {
+		return timeStr
+	}
+	return t.Format("2006-01-02 15:04:05")
+}

package/internal/ui/user_list.go

@@ -0,0 +1,19 @@
+package ui
+
+import (
+	"fmt"
+	"io"
+
+	"github.com/rogeriopvl/fizzy/internal/api"
+)
+
+func DisplayUsers(w io.Writer, users []api.User) error {
+	for _, user := range users {
+		status := "active"
+		if !user.Active {
+			status = "inactive"
+		}
+		fmt.Fprintf(w, "%s (%s) - %s [%s]\n", user.Name, user.Email, DisplayID(user.ID), status)
+	}
+	return nil
+}

package/internal/ui/user_show.go

@@ -0,0 +1,23 @@
+package ui
+
+import (
+	"fmt"
+	"io"
+
+	"github.com/rogeriopvl/fizzy/internal/api"
+)
+
+func DisplayUser(w io.Writer, user *api.User) error {
+	status := "active"
+	if !user.Active {
+		status = "inactive"
+	}
+
+	fmt.Fprintf(w, "User: %s\n", user.Name)
+	fmt.Fprintf(w, "ID: %s\n", user.ID)
+	fmt.Fprintf(w, "Email: %s\n", user.Email)
+	fmt.Fprintf(w, "Role: %s\n", user.Role)
+	fmt.Fprintf(w, "Status: %s\n", status)
+	fmt.Fprintf(w, "Created At: %s\n", FormatTime(user.CreatedAt))
+	return nil
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fizzy-cli",
-  "version": "0.6.1",
+  "version": "0.8.0",
   "description": "CLI for https://fizzy.do",
   "main": "bin/fizzy",
   "type": "module",