feat: npm publication with only the specification

So that consumers can run their own generator.

Author: slisson

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

@@ -35,15 +35,15 @@ fabrikt {
         }
     }
     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/build/bundled/workspaces-v1.yaml")
+        apiFile = rootProject.layout.projectDirectory.file("redocly/bundled/workspaces-v1.yaml")
         basePackage = "org.modelix.services.workspaces.stubs"
     }
 }

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,8 +7,6 @@
     "@redocly/cli": "^1.34.2"
   },
   "scripts": {
-    "bundle": "redocly bundle",
-    "join": "redocly join build/bundled/**/*.yaml --output=build/joined.yaml",
-    "bundle-and-join": "$npm_execpath run bundle && $npm_execpath run join"
+    "bundle": "redocly bundle"
   }
 }

redocly/redocly.yaml

@@ -4,16 +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: ./build/bundled/workspaces-v1.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,4 +1,4 @@
-openapi: "3.0.3"
+openapi: "3.1.0"
 info:
   title: "Modelix Maven Connector"
   version: "1.0.0"

specifications/repository/v3/repository.yaml

@@ -1,4 +1,4 @@
-openapi: "3.0.3"
+openapi: "3.1.0"
 info:
   title: "Modelix Model Repository"
   version: "3.0.0"