HTM-1975 | HTM-1976: Remove OpenAPI export endpoint and define extract endpoint

we still need some, now obsoleted, generated code to keep the compiler happy so that is moved to a temporary schema file

Author: mprins

pom.xml

@@ -1219,6 +1219,34 @@ SPDX-License-Identifier: MIT
                             <skipIfSpecIsUnchanged>true</skipIfSpecIsUnchanged>
                         </configuration>
                     </execution>
+                    <execution>
+                        <id>generate-obsolete-viewer-models</id>
+                        <goals>
+                            <goal>generate</goal>
+                        </goals>
+                        <configuration>
+                            <inputSpec>${project.basedir}/src/main/resources/openapi/obsolete-viewer-schemas.yaml</inputSpec>
+                            <generatorName>spring</generatorName>
+                            <modelPackage>org.tailormap.api.viewer.model</modelPackage>
+                            <library>spring-boot</library>
+                            <configOptions>
+                                <dateLibrary>java8</dateLibrary>
+                                <hideGenerationTimestamp>true</hideGenerationTimestamp>
+                                <openApiNullable>false</openApiNullable>
+                                <serializableModel>true</serializableModel>
+                                <generatedConstructorWithRequiredArgs>false</generatedConstructorWithRequiredArgs>
+                                <useOptional>true</useOptional>
+                                <useSpringBoot4>true</useSpringBoot4>
+                                <useJackson3>true</useJackson3>
+                                <additionalModelTypeAnnotations>@Deprecated</additionalModelTypeAnnotations>
+                            </configOptions>
+                            <generateApis>false</generateApis>
+                            <generateModels>true</generateModels>
+                            <generateSupportingFiles>false</generateSupportingFiles>
+                            <generateModelTests>false</generateModelTests>
+                            <skipIfSpecIsUnchanged>true</skipIfSpecIsUnchanged>
+                        </configuration>
+                    </execution>
                     <execution>
                         <id>generate-spec</id>
                         <goals>

src/main/java/org/tailormap/api/controller/LayerExportController.java

@@ -59,8 +59,14 @@
 import org.tailormap.api.repository.FeatureSourceRepository;
 import org.tailormap.api.viewer.model.LayerExportCapabilities;
 
+/**
+ * @deprecated This controller is deprecated and will be removed in a future release. Use the `/extract/` endpoint
+ *     (TODO) instead, which provides more flexible data extraction capabilities and supports more data sources than
+ *     just WFS.
+ */
 @AppRestController
 @RequestMapping(path = "${tailormap-api.base-path}/{viewerKind}/{viewerName}/layer/{appLayerId}/export/")
+@Deprecated(forRemoval = true)
 public class LayerExportController {
   private static final Logger logger =
       LoggerFactory.getLogger(MethodHandles.lookup().lookupClass());

src/main/resources/openapi/obsolete-viewer-schemas.yaml

@@ -0,0 +1,35 @@
+#
+# Copyright (C) 2026 B3Partners B.V.
+#
+# SPDX-License-Identifier: MIT
+#
+openapi: 3.0.4
+info:
+  title: 'obsolete viewer models'
+  description: 'no servers or paths, just obsolete models in this document that need to be generated for backwards 
+              compatibility, but should not be used in the API anymore.'
+  version: '1.0'
+  license:
+    name: 'MIT'
+    url: 'https://mit-license.org/'
+  contact:
+    name: 'B3Partners BV'
+    url: 'https://www.b3partners.nl/'
+    email: 'info@b3partners.nl'
+servers: [ ]
+paths: { }
+
+components:
+  schemas:
+    LayerExportCapabilities:
+      description: '**OBSOLETE**, since the export capabilities are now predefined and no longer need to be discovered per layer'
+      type: object
+      required: [exportable]
+      properties:
+        exportable:
+          nullable: false
+          type: boolean
+        outputFormats:
+          type: array
+          items:
+            type: string

src/main/resources/openapi/status-responses.yaml

@@ -63,3 +63,31 @@ components:
       example:
         code: 500
         message: 'Internal server error'
+
+    ServerSentEventResponse:
+      description: 'Server Sent Event response. 
+      The client can use the `eventType` property to determine the type of event, and the `details` property 
+      to get specific event data.'
+      type: object
+      required:
+        - eventType
+      properties:
+        eventType:
+          description: 'Event type'
+          type: string
+        details:
+          description: 'Event data. Can be any JSON object or nothing, but should include at least a `status` property to indicate the status of the event.'
+          type: object
+          nullable: true
+        id:
+          description: 'optional event identifier, can be used for event ordering and deduplication'
+          type: string
+          format: uuid
+          nullable: true
+      example:
+        eventType: 'extract-started'
+        details:
+          status: 'started'
+          message: 'Extracting data'
+          progress: 10
+        id: '123e4567-e89b-12d3-a456-426614174000'