1.5.1 (2026年06月12日)

Bug Fixes

• cross-endpoint type name collisions (0a756f2)
• cross-endpoint type name collisions (supersedes #71) (5c6ddab)
• schema: collapse redundant polymorphic unions to discriminated parent refs (ba95511)

Highlights

• Adds @OpenAPIQueryParam / repeatable @OpenAPIQueryParams support for dynamically read query parameters.
• Includes nested component de-duplication and required-field fixes.
• Includes issue #59 schema fixes for Jakarta constraints on @JsonValue wrappers and polymorphic subtype titles.
• Aligns repository, docs, release manifest, and Maven artifact versions to 1.5.0.
• Hardens the Maven Central release workflow so release version drift fails fast.

Refs #62.

What changed

• Added schema generation support for Optional<T>, including top-level optionals.
• Improved @JsonValue wrapper handling so scalar wrappers keep the expected OpenAPI type and format metadata.
• Preserved real anyOf, oneOf, and allOf compositions while still unwrapping nullable-only compositions.
• Added regression coverage for Optional fields, JsonValue wrappers, and composed schemas.

Released from #42. Full diff: v1.3.0...v1.4.0

Maven coordinate: sh.oso:akka-openapi-maven-plugin:1.4.0

1.3.0 (2026年05月06日)

Features

• add Akka SDK shim for compile-time compatibility (80377d6)
• initial release of Akka OpenAPI Maven Plugin (77b75f2)
• security: honour includeSecuritySchemes flag (10455ee)
• security: Mojo-side validation for missing schemeName/name (8b491eb)
• security: restrict scheme types to apiKey with explicit validation (f16d5ef)

Bug Fixes

• add Akka SDK repository for dependency resolution (9f7ee53)
• auto-publish releases end-to-end (b9077f6)
• auto-publish releases end-to-end, no manual click needed (d2df6e3)
• ci: skip invoker ITs in coverage job (923d729)
• ci: skip invoker ITs in coverage job (jacoco/argLine collision) (f07e45a)
• close openAPISummaryShouldTargetMethodOnly test method (b3c1a5c)
• correct release workflow trigger conditions (50ea8e7)
• docs: update published usage examples (9e0fff9)
• docs: update published usage examples (2f125a2)
• document raw Akka HttpResponse schemas (36433b3)
• pin actions to commit SHAs, fix deprecated set-output (1dd351e)
• pin GitHub Actions to immutable commit SHAs (601f705)
• pin SonarSource action to commit SHA (aa6e6ae)
• release: publish Maven Central releases from release-please (f6a9953)
• release: publish Maven Central releases from release-please (6556db6)
• resolve merge-conflict markers in AnnotationRetentionTest (52b62ce)
• rewrite verify-release-secrets expiry check in bash (0e1aeb5)
• rewrite verify-release-secrets expiry check in bash (2787ed6)
• switch to central-publishing-maven-plugin for Central Portal (9f93488)
• update to use Sonatype Central Portal URLs (61b1a99)
• use GPG agent instead of Bouncy Castle for signing (1db8350)
• use mvn verify instead of compile for release validation (b4eed25)
• wire up OpenAPI annotation extraction (53c08c6)
• wire up OpenAPI annotation extraction (#17) (9f702f9)

Documentation

• document <security> block + @OpenAPISummary; expose includeSecuritySchemes flag (dccdaee)
• prepare CHANGELOG for v1.0.1 release (910ca5c)

Features

• generate deterministic OpenAPI output by sorting paths and schemas
• generate Jackson polymorphic interface schemas with discriminator mappings
• add stripServerPathPrefix configuration for server-path de-duplication
• add notification example covering polymorphic request and response schemas

Bug Fixes

• avoid duplicate numeric subtype components when polymorphic schemas are revisited through collections
• include discriminator properties on subtype schemas for client-generation compatibility
• apply server-path stripping to annotation-provided servers and prefer the longest matching prefix

1.1.0 (2026年05月05日)

Features

• security: honour includeSecuritySchemes flag (10455ee)
• security: Mojo-side validation for missing schemeName/name (8b491eb)
• security: restrict scheme types to apiKey with explicit validation (f16d5ef)

Bug Fixes

• auto-publish releases end-to-end (b9077f6)
• auto-publish releases end-to-end, no manual click needed (d2df6e3)
• ci: skip invoker ITs in coverage job (923d729)
• ci: skip invoker ITs in coverage job (jacoco/argLine collision) (f07e45a)
• close openAPISummaryShouldTargetMethodOnly test method (b3c1a5c)
• document raw Akka HttpResponse schemas (36433b3)
• release: publish Maven Central releases from release-please (f6a9953)
• release: publish Maven Central releases from release-please (6556db6)
• resolve merge-conflict markers in AnnotationRetentionTest (52b62ce)

Documentation

• document <security> block + @OpenAPISummary; expose includeSecuritySchemes flag (dccdaee)

Akka OpenAPI Maven Plugin v1.0.1

Installation

Add to your pom.xml:

<plugin>
 <groupId>sh.oso</groupId>
 <artifactId>akka-openapi-maven-plugin</artifactId>
 <version>1.0.1</version>
 <executions>
 <execution>
 <goals>
 <goal>generate</goal>
 </goals>
 </execution>
 </executions>
</plugin>

Changes

See CHANGELOG.md for details.

🤖 Generated with GitHub Actions

What's Changed

• fix: wire up OpenAPI annotation extraction by @sionsmith in #18
• fix: pin SonarSource action to commit SHA by @sionsmith in #19
• chore: prepare v1.0.1 release by @sionsmith in #20
• fix: rewrite verify-release-secrets expiry check in bash by @sionsmith in #21

New Contributors

• @sionsmith made their first contribution in #18

Full Changelog: v1.0.0...v1.0.1

Contributors

• @sionsmith

Akka OpenAPI Maven Plugin v1.0.0

Installation

Add to your pom.xml:

<plugin>
 <groupId>sh.oso</groupId>
 <artifactId>akka-openapi-maven-plugin</artifactId>
 <version>1.0.0</version>
 <executions>
 <execution>
 <goals>
 <goal>generate</goal>
 </goals>
 </execution>
 </executions>
</plugin>

Changes

See CHANGELOG.md for details.

🤖 Generated with GitHub Actions

Full Changelog: https://github.com/osodevops/akka-openapi-maven-plugin/commits/v1.0.0