Add public theme palette endpoints

Author: etewiah

app/controllers/api_public/v1/theme_controller.rb

@@ -39,29 +39,42 @@ def index
         I18n.locale = locale if locale.present?
 
         website = Pwb::Current.website
+        palette_id = params[:palette_id].presence
 
         # Cache theme for 1 hour - changes infrequently
-        etag_data = [website.id, website.updated_at, website.style_variables]
+        etag_data = [website.id, website.updated_at, website.style_variables, palette_id]
         set_long_cache(max_age: 1.hour, etag_data: etag_data)
         return if performed?
 
         render json: {
-          theme: build_theme_response(website)
+          theme: build_theme_response(website, palette_id: palette_id)
         }
       end
 
       private
 
-      def build_theme_response(website)
+      def build_theme_response(website, palette_id: nil)
+        theme = website.current_theme
+        palette_override = palette_id.present? && theme&.valid_palette?(palette_id) ? palette_id : nil
+        base_vars = website.style_variables_for_theme&.dig("default") ||
+          Pwb::WebsiteStyleable::DEFAULT_STYLE_VARIABLES.dup
+        palette_colors = palette_override ? theme.palette_colors(palette_override) : nil
+        colors = palette_colors.present? ? base_vars.merge(palette_colors) : website.style_variables
+        css_variables = if palette_override && theme
+          website.palette_loader.generate_full_css(theme.name, palette_override)
+        else
+          website.css_variables_with_dark_mode
+        end
+
         {
           name: website.theme_name || "default",
-          palette_id: website.effective_palette_id,
+          palette_id: palette_override || website.effective_palette_id,
           palette_mode: website.respond_to?(:palette_mode) ? (website.palette_mode || "dynamic") : "dynamic",
-          colors: website.style_variables,
+          colors: colors,
           fonts: extract_fonts(website),
           border_radius: extract_border_radius(website),
           dark_mode: build_dark_mode_config(website),
-          css_variables: website.css_variables_with_dark_mode,
+          css_variables: css_variables,
           custom_css: website.respond_to?(:raw_css) ? website.raw_css : nil,
           map_config: build_map_config(website)
         }

app/controllers/api_public/v1/theme_palettes_controller.rb

@@ -0,0 +1,62 @@
+# frozen_string_literal: true
+
+module ApiPublic
+  module V1
+    # Public API endpoints for theme palettes
+    # Lists available palettes and returns palette details for a theme
+    class ThemePalettesController < BaseController
+      include ApiPublic::Cacheable
+
+      # GET /api_public/v1/themes/:theme_name/palettes
+      def index
+        theme = find_theme
+        return render_not_found unless theme
+
+        set_long_cache(max_age: 1.hour, etag_data: [theme.name, theme.palettes.keys])
+        return if performed?
+
+        render json: {
+          theme: theme.name,
+          palettes: theme.list_palettes
+        }
+      end
+
+      # GET /api_public/v1/themes/:theme_name/palettes/:palette_id
+      def show
+        theme = find_theme
+        return render_not_found unless theme
+
+        palette_id = params[:palette_id].to_s
+        palette = theme.palette(palette_id)
+        return render_palette_not_found unless palette
+
+        set_long_cache(max_age: 1.hour, etag_data: [theme.name, palette_id])
+        return if performed?
+
+        render json: {
+          theme: theme.name,
+          palette: palette.merge(
+            "css_variables" => theme.generate_palette_css(palette_id)
+          )
+        }
+      end
+
+      private
+
+      def find_theme
+        theme_name = params[:theme_name].to_s
+        return nil if theme_name.blank?
+
+        Pwb::Theme.find_by(name: theme_name)
+      end
+
+      def render_not_found
+        render json: { error: "Theme not found" }, status: :not_found
+      end
+
+      def render_palette_not_found
+        render json: { error: "Palette not found" }, status: :not_found
+      end
+    end
+  end
+end

config/routes.rb

@@ -729,6 +729,8 @@
       get "/site_details" => "site_details#index"
       get "/select_values" => "select_values#index"
       get "/theme" => "theme#index"
+      get "/themes/:theme_name/palettes" => "theme_palettes#index"
+      get "/themes/:theme_name/palettes/:palette_id" => "theme_palettes#show"
       get "/search/config" => "search_config#index"
       get "/search/facets" => "search_facets#index"
       get "/testimonials" => "testimonials#index"

swagger/v1/api_public_swagger.yaml

@@ -918,6 +918,11 @@ paths:
         required: false
         schema:
           type: string
+      - name: palette_id
+        in: query
+        required: false
+        schema:
+          type: string
       responses:
         '200':
           description: theme found
@@ -974,6 +979,103 @@ paths:
                       custom_css:
                         type: string
                         nullable: true
+  "/api_public/v1/themes/{theme_name}/palettes":
+    get:
+      summary: Lists available palettes for a theme
+      tags:
+      - Theme Palettes
+      parameters:
+      - name: theme_name
+        in: path
+        required: true
+        schema:
+          type: string
+      responses:
+        '200':
+          description: palette list found
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  theme:
+                    type: string
+                  palettes:
+                    type: array
+                    items:
+                      type: object
+                      properties:
+                        id:
+                          type: string
+                        name:
+                          type: string
+                        description:
+                          type: string
+                          nullable: true
+                        preview_colors:
+                          type: array
+                          items:
+                            type: string
+                        is_default:
+                          type: boolean
+                        supports_dark_mode:
+                          type: boolean
+                        has_explicit_dark_mode:
+                          type: boolean
+  "/api_public/v1/themes/{theme_name}/palettes/{palette_id}":
+    get:
+      summary: Retrieves a single palette for a theme
+      tags:
+      - Theme Palettes
+      parameters:
+      - name: theme_name
+        in: path
+        required: true
+        schema:
+          type: string
+      - name: palette_id
+        in: path
+        required: true
+        schema:
+          type: string
+      responses:
+        '200':
+          description: palette found
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  theme:
+                    type: string
+                  palette:
+                    type: object
+                    properties:
+                      id:
+                        type: string
+                      name:
+                        type: string
+                      description:
+                        type: string
+                        nullable: true
+                      preview_colors:
+                        type: array
+                        items:
+                          type: string
+                      is_default:
+                        type: boolean
+                      supports_dark_mode:
+                        type: boolean
+                      colors:
+                        type: object
+                        additionalProperties:
+                          type: string
+                      modes:
+                        type: object
+                        additionalProperties:
+                          type: object
+                      css_variables:
+                        type: string
   "/api_public/v1/search/config":
     get:
       summary: Retrieves search configuration