Add JSON response format to board publication toggle

Allows programmatic clients to publish and unpublish boards via
the API, returning the shareable key and URL on publish.

Author: robzolkos

app/controllers/boards/publications_controller.rb

@@ -5,10 +5,20 @@ class Boards::PublicationsController < ApplicationController
 
   def create
     @board.publish
+
+    respond_to do |format|
+      format.turbo_stream
+      format.json { render json: { key: @board.publication.key, url: published_board_url(@board) }, status: :created }
+    end
   end
 
   def destroy
     @board.unpublish
     @board.reload
+
+    respond_to do |format|
+      format.turbo_stream
+      format.json { head :no_content }
+    end
   end
 end

docs/API.md

@@ -502,6 +502,37 @@ __Response:__
 
 Returns `204 No Content` on success.
 
+## Board Publications
+
+Publishing a board makes it publicly accessible via a shareable link, without requiring authentication. Only board administrators can publish or unpublish a board.
+
+### `POST /:account_slug/boards/:board_id/publication`
+
+Publishes a board, generating a shareable public link.
+
+__Response:__
+
+```
+HTTP/1.1 201 Created
+```
+
+```json
+{
+  "key": "aB3dEfGhIjKlMnOp",
+  "url": "https://app.fizzy.do/1234567/public/boards/aB3dEfGhIjKlMnOp"
+}
+```
+
+If the board is already published, the existing publication is returned.
+
+### `DELETE /:account_slug/boards/:board_id/publication`
+
+Unpublishes a board, removing public access.
+
+__Response:__
+
+Returns `204 No Content` on success.
+
 ## Cards
 
 Cards are tasks or items of work on a board. They can be organized into columns, tagged, assigned to users, and have comments.

test/controllers/boards/publications_controller_test.rb

@@ -27,6 +27,30 @@ class Boards::PublicationsControllerTest < ActionDispatch::IntegrationTest
     assert_turbo_stream action: :replace, target: dom_id(@board, :publication)
   end
 
+  test "publish a board via JSON" do
+    assert_not @board.published?
+
+    assert_changes -> { @board.reload.published? }, from: false, to: true do
+      post board_publication_path(@board), as: :json
+    end
+
+    assert_response :created
+    body = @response.parsed_body
+    assert_equal @board.reload.publication.key, body["key"]
+    assert_includes body["url"], body["key"]
+  end
+
+  test "unpublish a board via JSON" do
+    @board.publish
+    assert @board.published?
+
+    assert_changes -> { @board.reload.published? }, from: true, to: false do
+      delete board_publication_path(@board), as: :json
+    end
+
+    assert_response :no_content
+  end
+
   test "publish requires board admin permission" do
     logout_and_sign_in_as :jz