HTM-1961| HTM-1962: Initial implemententation of /events and /extract endpoints with CSV output format

[mprins]

• HTM-1961: Definition and initial implemententation of /events endpoint
• HTM-1961: Initial implemententation of /extract endpoint
• HTM-1962: CSV output format

Note: this will merge to the feature branch/PR, not the main branch

[github-actions]

Dependency Review

The following issues were found:

• ✅ 0 vulnerable package(s)
• ✅ 0 package(s) with incompatible licenses
• ✅ 0 package(s) with invalid SPDX license definitions
• ⚠️ 1 package(s) with unknown licenses.

See the Details below.

Snapshot Warnings

⚠️: No snapshots were found for the head SHA 36c89fa.

Ensure that dependencies are being submitted on PR branches and consider enabling retry-on-snapshot-warnings. See the documentation for more information and troubleshooting advice.

License Issues

pom.xml

Package	Version	License	Issue Type
org.geotools:gt-csv		Null	Unknown License

Allowed Licenses:

MIT, Apache-2.0, BSD-2-Clause, BSD-3-Clause, ISC, MPL-2.0, LGPL-2.1-only, EPL-2.0, EPL-1.0

Excluded from license check:

pkg:maven/org.eclipse.angus/jakarta.mail@2.0.5?type=jar, pkg:maven/jakarta.ws.rs:jakarta.ws.rs-api@4.0.0?type=jar

OpenSSF Scorecard

Package	Version	Score	Details
maven/org.geotools:gt-csv		Unknown	Unknown

Scanned Files

• pom.xml

[github-actions]

Test Results

489 tests  +10   488 ✅ +11   6m 44s ⏱️ + 1m 20s
 58 suites + 4     1 💤 ± 0 
 58 files   + 4     0 ❌  -  1 

Results for commit 36c89fa. ± Comparison against base commit faf5c2f.

♻️ This comment has been updated with latest results.

[Copilot]

Pull request overview

Implements initial Server-Sent Events (/events) and layer attribute extraction (/extract) flow, with asynchronous extract job execution and CSV output support, plus accompanying OpenAPI and integration test coverage.

Changes:

• Added /events/{clientId} SSE subscription endpoint with scheduled keep-alives and clientId validation.
• Added /extract endpoints for listing allowed formats, starting extracts asynchronously, and downloading generated files.
• Introduced UUIDv7 utility for time-sortable IDs, extract file creation/cleanup logic, and updated OpenAPI + tests.

Reviewed changes

Copilot reviewed 19 out of 19 changed files in this pull request and generated 12 comments.

Show a summary per file

File	Description
src/test/resources/application.properties	Adds extract-related test properties and defaults.
src/test/resources/application-postgresql.properties	Tunes Hikari pool size for PostgreSQL tests.
src/test/java/org/tailormap/api/util/UUIDv7Test.java	Adds unit tests for UUIDv7 generation/parsing/timestamps.
src/test/java/org/tailormap/api/controller/ServerSentEventsControllerInvalidInputIntegrationTest.java	Integration test for SSE invalid clientId handling.
src/test/java/org/tailormap/api/controller/ServerSentEventsControllerIntegrationTest.java	Integration test for SSE keep-alive delivery.
src/test/java/org/tailormap/api/controller/LayerExtractControllerRestrictedFormatsIntegrationTest.java	Integration tests for extract format restriction and invalid inputs.
src/test/java/org/tailormap/api/controller/LayerExtractControllerIntegrationTest.java	End-to-end extract-to-download integration tests (CSV).
src/main/resources/openapi/viewer-api.yaml	Adds/updates OpenAPI definitions for /events and /extract.
src/main/resources/openapi/status-responses.yaml	Updates SSE response schema (eventType enum/details).
src/main/resources/application.properties	Adds extract configuration defaults and comments.
src/main/java/org/tailormap/api/util/UUIDv7.java	Adds UUIDv7 generator + timestamp extraction/parsing utility.
src/main/java/org/tailormap/api/service/CreateLayerExtractService.java	Implements async extract creation, CSV datastore writing, SSE progress/error events, and cleanup job.
src/main/java/org/tailormap/api/controller/ServerSentEventsController.java	Adds SSE controller and scheduled keep-alive publisher.
src/main/java/org/tailormap/api/controller/LayerExtractController.java	Adds extract start/formats/download endpoints and request validation.
src/main/java/org/tailormap/api/configuration/base/WebMvcConfig.java	Registers enum converter for extract output format.
src/main/java/org/tailormap/api/configuration/AsyncConfig.java	Adds dedicated async executor for extract jobs.
pom.xml	Adds GeoTools CSV module dependency.
build/qa/PMD-ruleset_for_TM.xml	Extends PMD assertion detection to include Awaitility untilAsserted.
build/ci/docker-compose.yml	Adjusts CI Postgres max_connections configuration.

Comments suppressed due to low confidence (2)

src/main/resources/openapi/viewer-api.yaml:1914

• The OpenAPI spec defines the extract request body as application/json, but the controller uses @RequestParam (and tests send application/x-www-form-urlencoded). Generated clients will send JSON and fail to bind. Align the OpenAPI requestBody content type/shape with the actual controller contract (or switch the controller to @RequestBody).

      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object

src/main/resources/openapi/viewer-api.yaml:1925

• The outputFormat example is still an old MIME type (application/geo+json), while the API (controller + allowed formats properties) expects values like csv, geojson, xlsx, shape. Update the example (and ideally document the allowed values explicitly) to prevent client confusion.

                outputFormat:
                  description: 'Output format.
                    The allowed formats are configured per instance using `tailormap-api.extract.allowed-outputformats`.
                    The (default) geometry is included even if not requested.'
                  type: string
                  nullable: false
                  example: 'application/geo+json'
                attributes:

[codecov]

Codecov Report

❌ Patch coverage is 65.62500% with 99 lines in your changes missing coverage. Please review.
✅ All tests successful. No failed tests found.

Files with missing lines	Patch %	Lines
...ilormap/api/service/CreateLayerExtractService.java	57%	56 Missing and 9 partials ⚠️
...ilormap/api/controller/LayerExtractController.java	73%	12 Missing and 10 partials ⚠️
src/main/java/org/tailormap/api/util/UUIDv7.java	63%	7 Missing and 5 partials ⚠️

@@                                      Coverage Diff                                       @@
##             HTM-1960_Custom_extract_functionality_for_layer_attributes   #1677     +/-   ##
==============================================================================================
+ Coverage                                                             5%     77%    +73%     
- Complexity                                                          130     136      +6     
==============================================================================================
  Files                                                               157     161      +4     
  Lines                                                              7799    8087    +288     
  Branches                                                            715     751     +36     
==============================================================================================
+ Hits                                                                351    6220   +5869     
+ Misses                                                             7420    1427   -5993     
- Partials                                                             28     440    +412     

Files with missing lines	Coverage Δ	Complexity Δ
...a/org/tailormap/api/configuration/AsyncConfig.java	100% <100%> (+100%)	0 <0> (ø)
...tailormap/api/configuration/base/WebMvcConfig.java	100% <100%> (+100%)	0 <0> (ø)
...map/api/controller/ServerSentEventsController.java	100% <100%> (ø)	0 <0> (?)
src/main/java/org/tailormap/api/util/UUIDv7.java	63% <63%> (ø)	6 <6> (?)
...ilormap/api/controller/LayerExtractController.java	73% <73%> (ø)	0 <0> (?)
...ilormap/api/service/CreateLayerExtractService.java	57% <57%> (ø)	0 <0> (?)

... and 138 files with indirect coverage changes

🚀 New features to boost your workflow:

• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.