prauga-flexdoc 0.1.0 → 0.2.0

data/lib/prauga/flexdoc/config.rb

@@ -2,13 +2,49 @@
 
 module Prauga
   module FlexDoc
-    Config = Data.define(:path, :spec_url, :title, :theme, :try_it_enabled) do
-      def initialize(path: "/docs", spec_url: "/openapi.json", title: "API Reference", theme: "system", try_it_enabled: true)
+    Config = Data.define(
+      :path,
+      :spec_url,
+      :title,
+      :theme,
+      :try_it_enabled,
+      :expand,
+      :try_it_default_server,
+      :try_it_credentials,
+      :try_it_api_client_persistence_key
+    ) do
+      def initialize(
+        path: "/docs",
+        spec_url: "/openapi.json",
+        title: "API Reference",
+        theme: "system",
+        try_it_enabled: true,
+        expand: nil,
+        try_it_default_server: nil,
+        try_it_credentials: nil,
+        try_it_api_client_persistence_key: nil
+      )
         normalized = "/#{path.to_s.gsub(%r{\A/+|/+$}, "")}"
         normalized = "/docs" if normalized == "/"
         raise ArgumentError, "FlexDoc theme must be system, light, or dark" unless %w[system light dark].include?(theme)
+        if try_it_credentials && !%w[omit same-origin include].include?(try_it_credentials)
+          raise ArgumentError, "FlexDoc Try It credentials must be omit, same-origin, or include"
+        end
+        unless try_it_api_client_persistence_key.nil? || try_it_api_client_persistence_key == false || try_it_api_client_persistence_key.is_a?(String)
+          raise ArgumentError, "FlexDoc API Client persistence key must be a string, false, or nil"
+        end
 
-        super(path: normalized, spec_url:, title:, theme:, try_it_enabled: !!try_it_enabled)
+        super(
+          path: normalized,
+          spec_url: spec_url,
+          title: title,
+          theme: theme,
+          try_it_enabled: !!try_it_enabled,
+          expand: expand,
+          try_it_default_server: try_it_default_server,
+          try_it_credentials: try_it_credentials,
+          try_it_api_client_persistence_key: try_it_api_client_persistence_key
+        )
       end
     end
   end

data/lib/prauga/flexdoc/host.rb

@@ -28,12 +28,18 @@ module Prauga
       end
 
       def documentation
+        try_it = { enabled: config.try_it_enabled }
+        try_it[:defaultServer] = config.try_it_default_server unless config.try_it_default_server.nil?
+        try_it[:credentials] = config.try_it_credentials unless config.try_it_credentials.nil?
+        try_it[:apiClientPersistenceKey] = config.try_it_api_client_persistence_key unless config.try_it_api_client_persistence_key.nil?
+
         options = {
           contractVersion: "1",
           title: config.title,
           theme: config.theme,
-          tryIt: { enabled: config.try_it_enabled }
+          tryIt: try_it
         }
+        options[:expand] = config.expand unless config.expand.nil?
         title = CGI.escapeHTML(config.title.to_s)
         path = CGI.escapeHTML(config.path)
         spec_url = safe_json(config.spec_url)

data/lib/prauga/flexdoc/version.rb

@@ -2,6 +2,6 @@
 
 module Prauga
   module FlexDoc
-    VERSION = "0.1.0"
+    VERSION = "0.2.0"
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: prauga-flexdoc
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Prauga
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-09-03 00:00:00.000000000 Z
+date: 2026-09-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: actionpack