rapitapir 0.1.2 → 2.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (161) hide show
  1. checksums.yaml +4 -4
  2. data/.rubocop.yml +7 -7
  3. data/.rubocop_todo.yml +88 -0
  4. data/CHANGELOG.md +29 -1
  5. data/README.md +1339 -236
  6. data/RUBY_WEEKLY_LAUNCH_POST.md +200 -0
  7. data/docs/RAILS_INTEGRATION_IMPLEMENTATION.md +209 -0
  8. data/docs/SINATRA_EXTENSION.md +399 -348
  9. data/docs/STRICT_VALIDATION.md +229 -0
  10. data/docs/VALIDATION_IMPROVEMENTS.md +218 -0
  11. data/docs/adr/0001-base-class-strategy.md +33 -0
  12. data/docs/adr/0002-type-shortcut-and-type-system.md +30 -0
  13. data/docs/adr/0003-openapi-source-of-truth.md +32 -0
  14. data/docs/adr/0004-client-generation-typescript-first.md +34 -0
  15. data/docs/adr/0005-auth-architecture.md +32 -0
  16. data/docs/adr/0006-observability-defaults.md +30 -0
  17. data/docs/adr/0007-ai-scope-and-boundaries.md +30 -0
  18. data/docs/adr/README.md +46 -0
  19. data/docs/adr/template.md +24 -0
  20. data/docs/ai-integration-plan.md +112 -0
  21. data/docs/auto-derivation.md +505 -92
  22. data/docs/blueprint.md +92 -4
  23. data/docs/endpoint-definition.md +536 -129
  24. data/docs/implementation-status.md +1 -1
  25. data/docs/n8n-integration.md +212 -0
  26. data/docs/observability.md +810 -500
  27. data/docs/using-mcp.md +93 -0
  28. data/examples/ai/knowledge_base_rag.rb +83 -0
  29. data/examples/ai/user_management_mcp.rb +92 -0
  30. data/examples/ai/user_validation_llm.rb +187 -0
  31. data/examples/auto_derivation_ruby_friendly.rb +44 -113
  32. data/examples/cli/user_api_endpoints.rb +63 -36
  33. data/examples/demo_api.rb +57 -18
  34. data/examples/enterprise_extension_demo.rb +13 -13
  35. data/examples/enterprise_rapitapir_api.rb +81 -93
  36. data/examples/nocodb/nocodb_scaffold/Gemfile +22 -0
  37. data/examples/nocodb/nocodb_scaffold/README.md +10 -0
  38. data/examples/nocodb/nocodb_scaffold/Rakefile +7 -0
  39. data/examples/nocodb/nocodb_scaffold/app/api/app.rb +1139 -0
  40. data/examples/nocodb/nocodb_scaffold/app/models/email_template.rb +6 -0
  41. data/examples/nocodb/nocodb_scaffold/app/models/faq.rb +6 -0
  42. data/examples/nocodb/nocodb_scaffold/app/models/feature.rb +6 -0
  43. data/examples/nocodb/nocodb_scaffold/app/models/idea.rb +6 -0
  44. data/examples/nocodb/nocodb_scaffold/app/models/itinerary_day.rb +6 -0
  45. data/examples/nocodb/nocodb_scaffold/app/models/route.rb +6 -0
  46. data/examples/nocodb/nocodb_scaffold/app/models/subscriber.rb +6 -0
  47. data/examples/nocodb/nocodb_scaffold/app/models/tour.rb +6 -0
  48. data/examples/nocodb/nocodb_scaffold/app/models/webhook.rb +6 -0
  49. data/examples/nocodb/nocodb_scaffold/app/models_loader.rb +3 -0
  50. data/examples/nocodb/nocodb_scaffold/config/database.yml +11 -0
  51. data/examples/nocodb/nocodb_scaffold/config.ru +9 -0
  52. data/examples/nocodb/nocodb_scaffold/db/migrate/20250808152012_create_features.rb +10 -0
  53. data/examples/nocodb/nocodb_scaffold/db/migrate/20250808152013_create_tours.rb +10 -0
  54. data/examples/nocodb/nocodb_scaffold/db/migrate/20250808152014_create_routes.rb +10 -0
  55. data/examples/nocodb/nocodb_scaffold/db/migrate/20250808152015_create_itinerary_days.rb +10 -0
  56. data/examples/nocodb/nocodb_scaffold/db/migrate/20250808152016_create_subscribers.rb +10 -0
  57. data/examples/nocodb/nocodb_scaffold/db/migrate/20250808152017_create_email_templates.rb +10 -0
  58. data/examples/nocodb/nocodb_scaffold/db/migrate/20250808152018_create_faqs.rb +10 -0
  59. data/examples/nocodb/nocodb_scaffold/db/migrate/20250808152019_create_webhooks.rb +10 -0
  60. data/examples/nocodb/nocodb_scaffold/db/migrate/20250808152020_create_ideas.rb +10 -0
  61. data/examples/nocodb/swagger.json +4378 -0
  62. data/examples/production_ready_example.rb +78 -58
  63. data/examples/rails/RAILS_8_GUIDE.md +165 -0
  64. data/examples/rails/RAILS_LOADING_FIX.rb +35 -0
  65. data/examples/rails/README.md +497 -0
  66. data/examples/rails/comprehensive_test.rb +91 -0
  67. data/examples/rails/config/routes.rb +48 -0
  68. data/examples/rails/debug_controller.rb +63 -0
  69. data/examples/rails/detailed_test.rb +46 -0
  70. data/examples/rails/enhanced_users_controller.rb +278 -0
  71. data/examples/rails/final_server_test.rb +50 -0
  72. data/examples/rails/hello_world_app.rb +116 -0
  73. data/examples/rails/hello_world_controller.rb +186 -0
  74. data/examples/rails/hello_world_routes.rb +28 -0
  75. data/examples/rails/rails8_minimal_demo.rb +132 -0
  76. data/examples/rails/rails8_simple_demo.rb +140 -0
  77. data/examples/rails/rails8_working_demo.rb +255 -0
  78. data/examples/rails/real_world_blog_api.rb +510 -0
  79. data/examples/rails/server_test.rb +46 -0
  80. data/examples/rails/test_direct_processing.rb +41 -0
  81. data/examples/rails/test_hello_world.rb +80 -0
  82. data/examples/rails/test_rails_integration.rb +54 -0
  83. data/examples/rails/traditional_app/Gemfile +37 -0
  84. data/examples/rails/traditional_app/README.md +265 -0
  85. data/examples/rails/traditional_app/app/controllers/api/v1/posts_controller.rb +254 -0
  86. data/examples/rails/traditional_app/app/controllers/api/v1/users_controller.rb +220 -0
  87. data/examples/rails/traditional_app/app/controllers/application_controller.rb +86 -0
  88. data/examples/rails/traditional_app/app/controllers/application_controller_simplified.rb +87 -0
  89. data/examples/rails/traditional_app/app/controllers/documentation_controller.rb +149 -0
  90. data/examples/rails/traditional_app/app/controllers/health_controller.rb +42 -0
  91. data/examples/rails/traditional_app/config/routes.rb +25 -0
  92. data/examples/rails/traditional_app/config/routes_best_practice.rb +25 -0
  93. data/examples/rails/traditional_app/config/routes_simplified.rb +36 -0
  94. data/examples/rails/traditional_app_runnable.rb +406 -0
  95. data/examples/rails/users_controller.rb +4 -1
  96. data/examples/serverless/Gemfile +43 -0
  97. data/examples/serverless/QUICKSTART.md +331 -0
  98. data/examples/serverless/README.md +520 -0
  99. data/examples/serverless/aws_lambda_example.rb +307 -0
  100. data/examples/serverless/aws_sam_template.yaml +215 -0
  101. data/examples/serverless/azure_functions_example.rb +407 -0
  102. data/examples/serverless/deploy.rb +204 -0
  103. data/examples/serverless/gcp_cloud_functions_example.rb +367 -0
  104. data/examples/serverless/gcp_function.yaml +23 -0
  105. data/examples/serverless/host.json +24 -0
  106. data/examples/serverless/package.json +32 -0
  107. data/examples/serverless/spec/aws_lambda_spec.rb +196 -0
  108. data/examples/serverless/spec/spec_helper.rb +89 -0
  109. data/examples/serverless/vercel.json +31 -0
  110. data/examples/serverless/vercel_example.rb +404 -0
  111. data/examples/simple_demo_api.rb +40 -7
  112. data/examples/strict_validation_examples.rb +104 -0
  113. data/examples/user_api.rb +130 -132
  114. data/examples/validation_error_examples.rb +173 -0
  115. data/lib/rapitapir/ai/llm_instruction.rb +456 -0
  116. data/lib/rapitapir/ai/mcp.rb +134 -0
  117. data/lib/rapitapir/ai/rag.rb +287 -0
  118. data/lib/rapitapir/ai/rag_middleware.rb +147 -0
  119. data/lib/rapitapir/auth/oauth2.rb +44 -58
  120. data/lib/rapitapir/cli/command.rb +392 -6
  121. data/lib/rapitapir/cli/mcp_export.rb +18 -0
  122. data/lib/rapitapir/cli/scaffold_generator.rb +639 -0
  123. data/lib/rapitapir/cli/validator.rb +3 -7
  124. data/lib/rapitapir/core/endpoint.rb +59 -6
  125. data/lib/rapitapir/core/enhanced_endpoint.rb +3 -7
  126. data/lib/rapitapir/dsl/enhanced_structures.rb +1 -1
  127. data/lib/rapitapir/dsl/fluent_endpoint_builder.rb +53 -0
  128. data/lib/rapitapir/endpoint_registry.rb +47 -0
  129. data/lib/rapitapir/observability/health_check.rb +4 -4
  130. data/lib/rapitapir/observability/logging.rb +10 -10
  131. data/lib/rapitapir/openapi/schema_generator.rb +46 -2
  132. data/lib/rapitapir/schema.rb +2 -2
  133. data/lib/rapitapir/server/enhanced_rack_adapter.rb +11 -8
  134. data/lib/rapitapir/server/middleware.rb +2 -2
  135. data/lib/rapitapir/server/rack_adapter.rb +1 -3
  136. data/lib/rapitapir/server/rails/configuration.rb +77 -0
  137. data/lib/rapitapir/server/rails/controller_base.rb +185 -0
  138. data/lib/rapitapir/server/rails/documentation_helpers.rb +76 -0
  139. data/lib/rapitapir/server/rails/resource_builder.rb +181 -0
  140. data/lib/rapitapir/server/rails/routes.rb +114 -0
  141. data/lib/rapitapir/server/rails_adapter.rb +10 -3
  142. data/lib/rapitapir/server/rails_adapter_class.rb +1 -3
  143. data/lib/rapitapir/server/rails_controller.rb +1 -3
  144. data/lib/rapitapir/server/rails_integration.rb +67 -0
  145. data/lib/rapitapir/server/rails_response_handler.rb +16 -3
  146. data/lib/rapitapir/server/sinatra_adapter.rb +29 -5
  147. data/lib/rapitapir/server/sinatra_integration.rb +4 -4
  148. data/lib/rapitapir/sinatra/extension.rb +2 -2
  149. data/lib/rapitapir/sinatra/oauth2_helpers.rb +34 -40
  150. data/lib/rapitapir/types/array.rb +4 -0
  151. data/lib/rapitapir/types/auto_derivation.rb +4 -20
  152. data/lib/rapitapir/types/datetime.rb +1 -3
  153. data/lib/rapitapir/types/float.rb +2 -6
  154. data/lib/rapitapir/types/hash.rb +40 -2
  155. data/lib/rapitapir/types/integer.rb +4 -12
  156. data/lib/rapitapir/types/object.rb +6 -2
  157. data/lib/rapitapir/types.rb +6 -2
  158. data/lib/rapitapir/version.rb +1 -1
  159. data/lib/rapitapir.rb +5 -3
  160. data/rapitapir.gemspec +3 -2
  161. metadata +142 -8
@@ -14,6 +14,11 @@ module RapiTapir
14
14
  # inputs: [path_param(:id, :integer)],
15
15
  # outputs: [json_output(user_schema)]
16
16
  # )
17
+ # method: :get,
18
+ # path: '/users/{id}',
19
+ # inputs: [path_param(:id, :integer)],
20
+ # outputs: [json_output(user_schema)]
21
+ # )
17
22
  class Endpoint
18
23
  HTTP_METHODS = %i[get post put patch delete options head].freeze
19
24
 
@@ -77,6 +82,58 @@ module RapiTapir
77
82
  with_metadata(deprecated: flag_value)
78
83
  end
79
84
 
85
+ # Mark this endpoint for MCP export
86
+ def mcp_export
87
+ with_metadata(mcp_export: true)
88
+ end
89
+
90
+ # Returns true if this endpoint is marked for MCP export
91
+ def mcp_export?
92
+ metadata[:mcp_export] == true
93
+ end
94
+
95
+ # Configure RAG inference for this endpoint
96
+ def rag_inference(llm:, retrieval:, context_fields: [], config: {})
97
+ rag_config = {
98
+ llm: llm,
99
+ retrieval: retrieval,
100
+ context_fields: context_fields,
101
+ config: config
102
+ }
103
+ with_metadata(rag_inference: rag_config)
104
+ end
105
+
106
+ # Returns true if this endpoint has RAG inference configured
107
+ def rag_inference?
108
+ metadata.key?(:rag_inference)
109
+ end
110
+
111
+ # Get RAG configuration for this endpoint
112
+ def rag_config
113
+ metadata[:rag_inference]
114
+ end
115
+
116
+ # Configure LLM instruction generation for this endpoint
117
+ def llm_instruction(purpose:, fields: :all, **options)
118
+ llm_config = {
119
+ purpose: purpose,
120
+ fields: fields,
121
+ options: options
122
+ }
123
+
124
+ with_metadata(llm_instruction: llm_config)
125
+ end
126
+
127
+ # Check if this endpoint has LLM instruction generation configured
128
+ def llm_instruction?
129
+ metadata.key?(:llm_instruction)
130
+ end
131
+
132
+ # Get LLM instruction configuration for this endpoint
133
+ def llm_instruction_config
134
+ metadata[:llm_instruction]
135
+ end
136
+
80
137
  # Validate input/output types for a given input/output hash
81
138
  # Raises validation errors if invalid, returns true if valid
82
139
  def validate!(input_hash = {}, output_hash = {}) # rubocop:disable Naming/PredicateMethod
@@ -141,14 +198,10 @@ module RapiTapir
141
198
  def validate_outputs!(output_hash)
142
199
  outputs.each do |output|
143
200
  if output.type.is_a?(Hash)
144
- unless output.valid_type?(output_hash)
145
- raise TypeError, "Invalid output hash: expected #{output.type}, got #{output_hash}"
146
- end
201
+ raise TypeError, "Invalid output hash: expected #{output.type}, got #{output_hash}" unless output.valid_type?(output_hash)
147
202
  else
148
203
  output_hash.each do |k, v|
149
- unless output.valid_type?(v)
150
- raise TypeError, "Invalid type for output '#{k}': expected #{output.type}, got #{v.class}"
151
- end
204
+ raise TypeError, "Invalid type for output '#{k}': expected #{output.type}, got #{v.class}" unless output.valid_type?(v)
152
205
  end
153
206
  end
154
207
  end
@@ -198,7 +198,7 @@ module RapiTapir
198
198
  end
199
199
 
200
200
  def copy_with_validators(new_validators)
201
- new_endpoint = copy_with({})
201
+ new_endpoint = copy_with
202
202
  new_endpoint.instance_variable_set(:@custom_validators, new_validators)
203
203
  new_endpoint
204
204
  end
@@ -210,17 +210,13 @@ module RapiTapir
210
210
 
211
211
  def validate_security_schemes!
212
212
  security_schemes.each do |scheme|
213
- unless %i[bearer api_key basic].include?(scheme.options[:auth_type])
214
- raise ArgumentError, "Unknown authentication type: #{scheme.options[:auth_type]}"
215
- end
213
+ raise ArgumentError, "Unknown authentication type: #{scheme.options[:auth_type]}" unless %i[bearer api_key basic].include?(scheme.options[:auth_type])
216
214
  end
217
215
  end
218
216
 
219
217
  def validate_type_consistency!
220
218
  inputs.each do |input|
221
- unless input.type.respond_to?(:validate)
222
- raise ArgumentError, "Input '#{input.name}' type does not support validation"
223
- end
219
+ raise ArgumentError, "Input '#{input.name}' type does not support validation" unless input.type.respond_to?(:validate)
224
220
  end
225
221
 
226
222
  outputs.each do |output|
@@ -332,7 +332,7 @@ module RapiTapir
332
332
  {
333
333
  implicit: {
334
334
  authorizationUrl: @options[:authorization_url] || 'https://example.com/oauth/authorize',
335
- scopes: @scopes.each_with_object({}) { |scope, hash| hash[scope] = scope.to_s.humanize }
335
+ scopes: @scopes.to_h { |scope| [scope, scope.to_s.humanize] }
336
336
  }
337
337
  }
338
338
  end
@@ -159,6 +159,9 @@ module RapiTapir
159
159
  copy_with(errors: @errors + [error])
160
160
  end
161
161
 
162
+ # Alias for compatibility with Core::Endpoint
163
+ alias error_out error_response
164
+
162
165
  def bad_request(type_def = nil, **options)
163
166
  error_response(400, type_def, **options)
164
167
  end
@@ -311,6 +314,56 @@ module RapiTapir
311
314
  **options
312
315
  )
313
316
  end
317
+
318
+ public
319
+
320
+ # AI/MCP Extensions
321
+ def mcp_export
322
+ copy_with(metadata: @metadata.merge(mcp_export: true))
323
+ end
324
+
325
+ def mcp_export?
326
+ @metadata[:mcp_export] == true
327
+ end
328
+
329
+ def rag_inference(llm:, retrieval:, context_fields: [], config: {})
330
+ copy_with(metadata: @metadata.merge(
331
+ rag_inference: true,
332
+ rag_config: {
333
+ llm: llm,
334
+ retrieval: retrieval,
335
+ context_fields: context_fields,
336
+ config: config
337
+ }
338
+ ))
339
+ end
340
+
341
+ def rag_inference?
342
+ @metadata[:rag_inference] == true
343
+ end
344
+
345
+ def rag_config
346
+ @metadata[:rag_config]
347
+ end
348
+
349
+ # LLM Instruction Generation
350
+ def llm_instruction(purpose:, fields: :all, **options)
351
+ copy_with(metadata: @metadata.merge(
352
+ llm_instruction: {
353
+ purpose: purpose,
354
+ fields: fields,
355
+ options: options
356
+ }
357
+ ))
358
+ end
359
+
360
+ def llm_instruction?
361
+ @metadata.key?(:llm_instruction)
362
+ end
363
+
364
+ def llm_instruction_config
365
+ @metadata[:llm_instruction]
366
+ end
314
367
  end
315
368
  end
316
369
  end
@@ -0,0 +1,47 @@
1
+ # frozen_string_literal: true
2
+
3
+ module RapiTapir
4
+ # Global endpoint registry for collecting and managing endpoints
5
+ # Provides a central place to register and discover endpoints for CLI operations
6
+ class EndpointRegistry
7
+ @endpoints = []
8
+ @mutex = Mutex.new
9
+
10
+ class << self
11
+ # Register an endpoint in the global registry
12
+ def register(endpoint)
13
+ @mutex.synchronize do
14
+ @endpoints << endpoint unless @endpoints.include?(endpoint)
15
+ end
16
+ end
17
+
18
+ # Get all registered endpoints
19
+ def all
20
+ @mutex.synchronize { @endpoints.dup }
21
+ end
22
+
23
+ # Get only endpoints marked for MCP export
24
+ def mcp_endpoints
25
+ @mutex.synchronize { @endpoints.select(&:mcp_export?) }
26
+ end
27
+
28
+ # Clear all registered endpoints (useful for testing)
29
+ def clear!
30
+ @mutex.synchronize { @endpoints.clear }
31
+ end
32
+
33
+ # Register multiple endpoints at once
34
+ def register_all(endpoints)
35
+ endpoints.each { |endpoint| register(endpoint) }
36
+ end
37
+
38
+ # Find endpoints by method and path pattern
39
+ def find_by(method: nil, path: nil)
40
+ results = all
41
+ results = results.select { |ep| ep.method == method } if method
42
+ results = results.select { |ep| ep.path&.include?(path) } if path
43
+ results
44
+ end
45
+ end
46
+ end
47
+ end
@@ -73,8 +73,8 @@ module RapiTapir
73
73
  register_default_checks
74
74
  end
75
75
 
76
- def register(name, description = nil, &block)
77
- @checks << Check.new(name, description, &block)
76
+ def register(name, description = nil, &)
77
+ @checks << Check.new(name, description, &)
78
78
  end
79
79
 
80
80
  def run_all
@@ -210,9 +210,9 @@ module RapiTapir
210
210
  @endpoint_path = endpoint
211
211
  end
212
212
 
213
- def register(name, description = nil, &block)
213
+ def register(name, description = nil, &)
214
214
  @registry ||= Registry.new
215
- @registry.register(name, description, &block)
215
+ @registry.register(name, description, &)
216
216
  end
217
217
 
218
218
  def endpoint
@@ -22,24 +22,24 @@ module RapiTapir
22
22
  @logger.formatter = @formatter
23
23
  end
24
24
 
25
- def debug(message = nil, **fields, &block)
26
- log(:debug, message, **fields, &block)
25
+ def debug(message = nil, **fields, &)
26
+ log(:debug, message, **fields, &)
27
27
  end
28
28
 
29
- def info(message = nil, **fields, &block)
30
- log(:info, message, **fields, &block)
29
+ def info(message = nil, **fields, &)
30
+ log(:info, message, **fields, &)
31
31
  end
32
32
 
33
- def warn(message = nil, **fields, &block)
34
- log(:warn, message, **fields, &block)
33
+ def warn(message = nil, **fields, &)
34
+ log(:warn, message, **fields, &)
35
35
  end
36
36
 
37
- def error(message = nil, **fields, &block)
38
- log(:error, message, **fields, &block)
37
+ def error(message = nil, **fields, &)
38
+ log(:error, message, **fields, &)
39
39
  end
40
40
 
41
- def fatal(message = nil, **fields, &block)
42
- log(:fatal, message, **fields, &block)
41
+ def fatal(message = nil, **fields, &)
42
+ log(:fatal, message, **fields, &)
43
43
  end
44
44
 
45
45
  def log_request(**options)
@@ -13,6 +13,7 @@ module RapiTapir
13
13
  @endpoints = endpoints
14
14
  @info = default_info.merge(info)
15
15
  @servers = servers.empty? ? default_servers : servers
16
+ @components_schemas = {}
16
17
  end
17
18
 
18
19
  # Generate complete OpenAPI 3.0 specification
@@ -272,11 +273,23 @@ module RapiTapir
272
273
  end
273
274
 
274
275
  def generate_schema_components
275
- # For now, return empty. In the future, we can extract common schemas
276
- {}
276
+ # Collected during generation when encountering types with a component_name
277
+ @components_schemas
277
278
  end
278
279
 
279
280
  def type_to_schema(type)
281
+ # If the type carries a component name, register it and return a $ref
282
+ if type.respond_to?(:metadata)
283
+ name = type.metadata[:component_name]
284
+ if name && !name.to_s.empty?
285
+ add_component_schema(name, schema_payload_for(type))
286
+ return { '$ref' => "#/components/schemas/#{sanitize_component_name(name)}" }
287
+ end
288
+ end
289
+
290
+ # If the type knows how to render itself to JSON Schema, use that
291
+ return type.to_json_schema if type.respond_to?(:to_json_schema)
292
+
280
293
  case type
281
294
  when RapiTapir::Types::String, :string, String
282
295
  { type: 'string' }
@@ -291,6 +304,37 @@ module RapiTapir
291
304
  end
292
305
  end
293
306
 
307
+ def schema_payload_for(type)
308
+ if type.respond_to?(:to_json_schema)
309
+ type.to_json_schema
310
+ else
311
+ generate_complex_type_schema(type)
312
+ end
313
+ end
314
+
315
+ def add_component_schema(name, schema)
316
+ key = sanitize_component_name(name)
317
+ @components_schemas[key] ||= deep_stringify_keys(schema)
318
+ end
319
+
320
+ def sanitize_component_name(name)
321
+ key = name.to_s.strip
322
+ key = key.gsub(/[^A-Za-z0-9_.-]/, '_')
323
+ key = "Model_#{key}" if key.empty? || key =~ /^\d/
324
+ key
325
+ end
326
+
327
+ def deep_stringify_keys(obj)
328
+ case obj
329
+ when Array
330
+ obj.map { |v| deep_stringify_keys(v) }
331
+ when Hash
332
+ obj.each_with_object({}) { |(k, v), h| h[k.to_s] = deep_stringify_keys(v) }
333
+ else
334
+ obj
335
+ end
336
+ end
337
+
294
338
  def generate_complex_type_schema(type)
295
339
  case type
296
340
  when RapiTapir::Types::Array
@@ -24,9 +24,9 @@ module RapiTapir
24
24
  end
25
25
 
26
26
  # Define a schema using a block
27
- def self.define(&block)
27
+ def self.define(&)
28
28
  builder = SchemaBuilder.new
29
- builder.instance_eval(&block)
29
+ builder.instance_eval(&)
30
30
  builder.build
31
31
  end
32
32
 
@@ -203,7 +203,8 @@ module RapiTapir
203
203
  return nil if body.empty?
204
204
 
205
205
  content_type = request.content_type&.downcase
206
- format = input.options[:format] || detect_format_from_content_type(content_type)
206
+ # EnhancedInput exposes `format` directly; fall back to content-type detection
207
+ format = (input.respond_to?(:format) && input.format) || detect_format_from_content_type(content_type)
207
208
 
208
209
  case format
209
210
  when :json
@@ -260,7 +261,8 @@ module RapiTapir
260
261
  validate_response_result(result, output)
261
262
 
262
263
  serialized = output.serialize(result)
263
- content_type = determine_content_type(output)
264
+ # Prefer the explicit content type declared on the output
265
+ content_type = output.respond_to?(:content_type) && output.content_type ? output.content_type : determine_content_type(output)
264
266
 
265
267
  [status_code, { 'Content-Type' => content_type }, [serialized]]
266
268
  end
@@ -274,16 +276,17 @@ module RapiTapir
274
276
  end
275
277
 
276
278
  def build_default_response(result, status_code)
279
+ # For 204 No Content, return an empty body and no content-type header
280
+ return [204, {}, []] if status_code == 204
281
+
277
282
  [status_code, { 'Content-Type' => 'application/json' }, [JSON.generate(result)]]
278
283
  end
279
284
 
280
285
  def determine_content_type(output)
281
- case output.kind
282
- when :text
283
- 'text/plain'
284
- else # Default to JSON for :json and unknown formats
285
- 'application/json'
286
- end
286
+ # Fallback content-type resolution based on output kind
287
+ return 'text/plain' if output.kind == :text
288
+
289
+ 'application/json'
287
290
  end
288
291
 
289
292
  def determine_default_status(method)
@@ -39,8 +39,8 @@ module RapiTapir
39
39
 
40
40
  def default_logger
41
41
  require 'logger'
42
- Logger.new($stdout).tap do |logger|
43
- logger.level = Logger::INFO
42
+ ::Logger.new($stdout).tap do |logger|
43
+ logger.level = ::Logger::INFO
44
44
  logger.formatter = proc do |severity, datetime, _progname, msg|
45
45
  "[#{datetime.strftime('%Y-%m-%d %H:%M:%S')}] #{severity}: #{msg}\n"
46
46
  end
@@ -19,9 +19,7 @@ module RapiTapir
19
19
 
20
20
  # Register an endpoint with the adapter
21
21
  def register_endpoint(endpoint, handler)
22
- unless endpoint.is_a?(RapiTapir::Core::Endpoint)
23
- raise ArgumentError, 'Endpoint must be a RapiTapir::Core::Endpoint'
24
- end
22
+ raise ArgumentError, 'Endpoint must be a RapiTapir::Core::Endpoint' unless endpoint.is_a?(RapiTapir::Core::Endpoint)
25
23
  raise ArgumentError, 'Handler must respond to call' unless handler.respond_to?(:call)
26
24
 
27
25
  endpoint.validate!
@@ -0,0 +1,77 @@
1
+ # frozen_string_literal: true
2
+
3
+ module RapiTapir
4
+ module Server
5
+ module Rails
6
+ # Simple configuration class for Rails integration
7
+ # Provides basic configuration options needed for Rails controllers
8
+ class Configuration
9
+ attr_accessor :docs_path, :openapi_path, :health_check_enabled, :health_check_path
10
+ attr_reader :api_info, :servers, :public_paths, :auth_schemes
11
+
12
+ def initialize
13
+ @api_info = {
14
+ title: 'API Documentation',
15
+ description: 'Generated with RapiTapir',
16
+ version: '1.0.0'
17
+ }
18
+ @servers = []
19
+ @public_paths = []
20
+ @auth_schemes = {}
21
+ @docs_path = '/docs'
22
+ @openapi_path = '/openapi.json'
23
+ @health_check_enabled = false
24
+ @health_check_path = '/health'
25
+ end
26
+
27
+ # API Information configuration
28
+ def info(title: nil, description: nil, version: nil, **options)
29
+ @api_info[:title] = title if title
30
+ @api_info[:description] = description if description
31
+ @api_info[:version] = version if version
32
+ @api_info.merge!(options)
33
+ end
34
+
35
+ # Server configuration
36
+ def server(url:, description: nil)
37
+ @servers << { url: url, description: description }.compact
38
+ end
39
+
40
+ # Add paths that don't require authentication
41
+ def add_public_paths(*paths)
42
+ @public_paths.concat(paths.flatten.map(&:to_s))
43
+ end
44
+
45
+ # Authentication scheme management
46
+ def add_auth_scheme(name, scheme)
47
+ @auth_schemes[name] = scheme
48
+ end
49
+
50
+ def get_auth_scheme(name)
51
+ @auth_schemes[name]
52
+ end
53
+
54
+ # Enable development defaults (docs endpoints, etc.)
55
+ def development_defaults!
56
+ # This would set up automatic documentation endpoints
57
+ # For now, just enable health checks
58
+ @health_check_enabled = true
59
+
60
+ # Enable docs
61
+ enable_docs
62
+ end
63
+
64
+ # Enable documentation endpoints
65
+ def enable_docs(path: '/docs', openapi_path: '/openapi.json')
66
+ @docs_path = path
67
+ @openapi_path = openapi_path
68
+ end
69
+
70
+ # Check if docs are enabled
71
+ def docs_enabled?
72
+ !@docs_path.nil?
73
+ end
74
+ end
75
+ end
76
+ end
77
+ end