Workspaces API for the new frontend

.github/workflows/build.yaml

@@ -28,8 +28,6 @@ jobs:
 
       - name: Set up pnpm
         uses: pnpm/action-setup@v4
-        with:
-          version: 10
 
       - name: Setup Gradle
         uses: gradle/actions/setup-gradle@v3

.github/workflows/publish.yaml

@@ -30,8 +30,6 @@ jobs:
 
       - name: Set up pnpm
         uses: pnpm/action-setup@v4
-        with:
-          version: 10
 
       - name: Setup Gradle
         uses: gradle/actions/setup-gradle@v3

api-server-stubs-ktor/build.gradle.kts

@@ -30,15 +30,22 @@ fabrikt {
             suspendModifier = enabled
             completionStage = enabled
         }
+        typeOverrides {
+            uuid = String
+        }
     }
     generate("mavenConnector") {
-        apiFile = rootProject.layout.projectDirectory.file("redocly/build/bundled/maven-connector-v1.yaml")
+        apiFile = rootProject.layout.projectDirectory.file("redocly/bundled/maven-connector-v1.yaml")
         basePackage = "org.modelix.services.maven_connector.stubs"
     }
     generate("repository") {
-        apiFile = rootProject.layout.projectDirectory.file("redocly/build/bundled/repository-v3.yaml")
+        apiFile = rootProject.layout.projectDirectory.file("redocly/bundled/repository-v3.yaml")
         basePackage = "org.modelix.services.repository.stubs"
     }
+    generate("workspaces") {
+        apiFile = rootProject.layout.projectDirectory.file("redocly/bundled/workspaces-v1.yaml")
+        basePackage = "org.modelix.services.workspaces.stubs"
+    }
 }
 
 tasks.withType<FabriktGenerateTask> {

build.gradle.kts

@@ -16,9 +16,12 @@ fun computeVersion(): String {
         versionFile.readText().trim()
     } else {
         val gitVersion: groovy.lang.Closure<String> by extra
-        val version = gitVersion()
-        versionFile.writeText(version)
-        version
+        gitVersion()
+        .let {
+            // Normalize the version so that is always a valid NPM version.
+            if (it.matches("""\d+\.\d+.\d+-.*""".toRegex())) it else "0.0.1-$it"
+        }
+        .also { versionFile.writeText(it) }
     }
 }
 
@@ -30,9 +33,9 @@ subprojects {
     apply(plugin = "maven-publish")
 
     repositories {
-        mavenLocal()
         maven { url = uri("https://artifacts.itemis.cloud/repository/maven-mps/") }
         mavenCentral()
+        mavenLocal()
     }
 
     publishing {

client-ts/build.gradle.kts

@@ -40,6 +40,7 @@ fun registerNpmPackageTasks(
                     "npmRepository" to "https://artifacts.itemis.cloud/repository/npm-open/",
                     "npmVersion" to project.version.toString(),
                     "npmName" to "@modelix/$npmPackageName",
+                    "supportsES6" to "true",
                 )
             gitUserId = "modelix"
             gitRepoId = "modelix.openapi"

package.json

@@ -17,5 +17,6 @@
   },
   "dependencies": {
     "@stoplight/spectral-cli": "^6.14.2"
-  }
+  },
+  "packageManager": "[email protected]+sha512.0486e394640d3c1fb3c9d43d49cf92879ff74f8516959c235308f5a8f62e2e19528a65cdc2a3058f587cde71eba3d5b56327c8c33a97e4c4051ca48a10ca2d5f"
 }

redocly/build.gradle.kts

@@ -1,8 +1,61 @@
+import com.github.gradle.node.npm.task.NpmTask
+import org.gradle.kotlin.dsl.register
+
 plugins {
     base
     alias(libs.plugins.node)
 }
 
-tasks.named("npm_run_join") {
+tasks.assemble {
     dependsOn("npm_run_bundle")
 }
+
+val bundledDir = layout.projectDirectory.dir("bundled")
+val publicationFile = bundledDir.file("modelix-openapi-specifications-${project.version}.tgz")
+
+val updateVersionTask = tasks.register<NpmTask>("updatePackageVersion") {
+    workingDir.set(bundledDir.asFile)
+    npmCommand = listOf("version")
+    args.set(listOf(
+        project.version.toString(),
+        "--allow-same-version"
+    ))
+}
+
+val npmPackTask =
+    tasks.register<NpmTask>("npmPack") {
+        group = "build"
+        dependsOn("npm_run_bundle")
+        dependsOn(updateVersionTask)
+
+        workingDir.set(bundledDir.asFile)
+        npmCommand = listOf("pack")
+    }
+
+val npmPublishTask =
+    tasks.register<NpmTask>("npmPublish") {
+        group = "publishing"
+        dependsOn(npmPackTask)
+
+        inputs.file(publicationFile)
+
+        workingDir.set(bundledDir.asFile)
+        npmCommand.set(listOf("publish"))
+        args.set(
+            listOf(
+                publicationFile.asFile.absolutePath,
+                "--registry=https://artifacts.itemis.cloud/repository/npm-open/",
+                "--//artifacts.itemis.cloud/repository/npm-open/:_authToken=${project.findProperty(
+                    "artifacts.itemis.cloud.npm.token",
+                )}",
+            ),
+        )
+    }
+
+tasks.assemble {
+    dependsOn(npmPackTask)
+}
+
+tasks.publish {
+    dependsOn(npmPublishTask)
+}

redocly/bundled/.gitignore

@@ -0,0 +1,2 @@
+*.tgz
+*.yaml

redocly/bundled/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "@modelix/openapi-specifications",
+  "version": "0.0.1-SNAPSHOT.4",
+  "description": "OpenApi yaml files of the Modelix services",
+  "homepage": "https://modelix.org/",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/modelix/modelix.openapi.git"
+  },
+  "license": "Apache 2.0",
+  "files": [
+    "./*.yaml"
+  ],
+  "scripts": {
+    "bundle": "redocly bundle",
+    "package": "npm pack",
+    "update-version": "npm version 0.0.1-SNAPSHOT.4"
+  },
+  "publishConfig": {
+    "registry": "https://artifacts.itemis.cloud/repository/npm-open/"
+  },
+  "devDependencies": {
+    "@redocly/cli": "^1.34.2"
+  }
+}

redocly/package.json

@@ -7,7 +7,6 @@
     "@redocly/cli": "^1.34.2"
   },
   "scripts": {
-    "bundle": "redocly bundle",
-    "join": "redocly join build/bundled/**/*.yaml --output=build/joined.yaml"
+    "bundle": "redocly bundle"
   }
 }

redocly/redocly.yaml

@@ -4,11 +4,16 @@ plugins:
 apis:
   repository@v3:
     root: ../specifications/repository/v3/repository.yaml
-    output: ./build/bundled/repository-v3.yaml
+    output: ./bundled/repository-v3.yaml
     decorators:
       plugin/use-server-path: {}
   maven-connector@v1:
     root: ../specifications/maven-connector/v1/maven.yaml
-    output: ./build/bundled/maven-connector-v1.yaml
+    output: ./bundled/maven-connector-v1.yaml
+    decorators:
+      plugin/use-server-path: {}
+  workspaces@v1:
+    root: ../specifications/workspaces/v1/workspaces.yaml
+    output: ./bundled/workspaces-v1.yaml
     decorators:
       plugin/use-server-path: {}

settings.gradle.kts

@@ -2,5 +2,5 @@
 rootProject.name = "modelix.openapi"
 
 include("redocly")
-include("client-ts")
+//include("client-ts")
 include("api-server-stubs-ktor")

specifications/lionweb/bulk/v2024.1/lionweb.yaml

@@ -1,4 +1,4 @@
-openapi: "3.0.3"
+openapi: "3.1.0"
 info:
   title: "modelix lionweb bulk API adapter"
   description: "modelix lionweb bulk API adapter"

specifications/maven-connector/v1/maven.yaml

@@ -1,17 +1,19 @@
-openapi: "3.0.3"
+openapi: "3.1.0"
 info:
   title: "Modelix Maven Connector"
   version: "1.0.0"
 servers:
-  - url: '/api/modelix/maven-connector'
+  - url: '/modelix/maven-connector'
     description: Makes artifacts from maven repositories available to other services
 tags:
   - name: MavenConnector
+  - name: MavenRepositories
+  - name: MavenArtifacts
 paths:
   /:
     get:
       operationId: getMavenConnectorConfig
-      tags: [MavenConnector]
+      tags: [MavenRepositories, MavenArtifacts]
       responses:
         "200":
           description: OK
@@ -22,6 +24,7 @@ paths:
   /repositories/:
     get:
       operationId: listMavenRepositories
+      tags: [MavenRepositories]
       responses:
         "200":
           description: OK
@@ -32,7 +35,7 @@ paths:
   /repositories/{repositoryId}:
     get:
       operationId: getMavenRepository
-      tags: [MavenConnector]
+      tags: [MavenRepositories]
       parameters:
         - name: repositoryId
           in: path
@@ -48,7 +51,7 @@ paths:
                 $ref: '#/components/schemas/MavenRepository'
     put:
       operationId: updateMavenRepository
-      tags: [MavenConnector]
+      tags: [MavenRepositories]
       parameters:
         - name: repositoryId
           in: path
@@ -65,7 +68,7 @@ paths:
           description: OK
     delete:
       operationId: deleteMavenRepository
-      tags: [MavenConnector]
+      tags: [MavenRepositories]
       parameters:
         - name: repositoryId
           in: path
@@ -78,14 +81,76 @@ paths:
   /artifacts/:
     get:
       operationId: listMavenArtifacts
-      tags: [MavenConnector]
+      tags: [MavenArtifacts]
       responses:
         "200":
           description: OK
           content:
             application/json:
               schema:
                 $ref: '#/components/schemas/MavenArtifactList'
+  /artifacts/{groupId}/{artifactId}:
+    get:
+      operationId: getMavenArtifact
+      tags: [MavenArtifacts]
+      parameters:
+        - name: groupId
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: artifactId
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        "200":
+          description: OK
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/MavenArtifact'
+    put:
+      operationId: updateMavenArtifact
+      tags: [MavenArtifacts]
+      parameters:
+        - name: groupId
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: artifactId
+          in: path
+          required: true
+          schema:
+            type: string
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/MavenArtifact'
+      responses:
+        "200":
+          description: OK
+    delete:
+      operationId: deleteMavenArtifact
+      tags: [MavenArtifacts]
+      parameters:
+        - name: groupId
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: artifactId
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        "200":
+          description: OK
+
 components:
   schemas:
     MavenConnectorConfig:
@@ -114,10 +179,8 @@ components:
       properties:
         id:
           type: string
-          nullable: false
         url:
           type: string
-          nullable: false
     MavenArtifactList:
       type: object
       required: [artifacts]

specifications/repository/v3/repository.yaml

@@ -1,9 +1,9 @@
-openapi: "3.0.3"
+openapi: "3.1.0"
 info:
-  title: "Modelix Workspaces"
+  title: "Modelix Model Repository"
   version: "3.0.0"
 servers:
-  - url: '/api/modelix/repository'
+  - url: '/modelix/repository'
     description: modelix-workspaces-manager
 tags:
   - name: Repository