@devkong/cli-nx 0.0.67-alpha.3 → 0.0.67-alpha.30

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@devkong/cli-nx",
-  "version": "0.0.67-alpha.3",
+  "version": "0.0.67-alpha.30",
   "type": "commonjs",
   "main": "./src/index.js",
   "typings": "./src/index.d.ts",

package/src/generators/preset/files/kotlin/.dockerignore

@@ -0,0 +1,6 @@
+node_modules
+.nx
+.idea
+.vscode
+.kotlin
+build

package/src/generators/preset/files/kotlin/.editorconfig

@@ -0,0 +1,24 @@
+# Editor configuration, see http://editorconfig.org
+root = true
+
+[*]
+indent_size = 2
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+
+[*.{kt,kts}]
+ktlint_code_style = ktlint_official
+ktlint_ignore_back_ticked_identifier = true
+ktlint_standard = enabled
+indent_style = space
+max_line_length = 100
+# Don't allow any wildcard imports
+ij_kotlin_packages_to_use_import_on_demand = unset
+# Prevent wildcard imports
+ij_kotlin_name_count_to_use_star_import = 99
+ij_kotlin_name_count_to_use_star_import_for_members = 99
+
+[*.md]
+max_line_length = off
+trim_trailing_whitespace = false

package/src/generators/preset/files/kotlin/.vscode/extensions.json

@@ -0,0 +1,18 @@
+{
+  "recommendations": [
+    "nrwl.angular-console",
+    "esbenp.prettier-vscode",
+    "mathiasfrohlich.kotlin",
+    "nrwl.angular-console",
+    "redhat.java",
+    "redhat.vscode-microprofile",
+    "redhat.vscode-quarkus",
+    "redhat.vscode-redhat-account",
+    "stylelint.vscode-stylelint",
+    "vscjava.vscode-java-debug",
+    "vscjava.vscode-java-dependency",
+    "vscjava.vscode-java-pack",
+    "vscjava.vscode-java-test",
+    "vscjava.vscode-maven"
+  ]
+}

package/src/generators/preset/files/kotlin/.vscode/launch.json

@@ -0,0 +1,16 @@
+{
+    // Use IntelliSense to learn about possible attributes.
+    // Hover to view descriptions of existing attributes.
+    // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
+    "version": "0.2.0",
+    "configurations": [
+        {
+            "preLaunchTask": "quarkusDev",
+            "type": "java",
+            "request": "attach",
+            "hostName": "localhost",
+            "name": "Debug Quarkus application",
+            "port": 5005
+        }
+    ]
+}

package/src/generators/preset/files/kotlin/.vscode/settings.json

@@ -0,0 +1,7 @@
+{
+    "java.compile.nullAnalysis.mode": "automatic",
+    "java.configuration.runtimes": [
+
+    ],
+    "java.configuration.updateBuildConfiguration": "interactive"
+}

package/src/generators/preset/files/kotlin/.vscode/tasks.json

@@ -0,0 +1,81 @@
+// See https://go.microsoft.com/fwlink/?LinkId=733558
+// for the documentation about the tasks.json format
+{
+	"version": "2.0.0",
+	"tasks": [
+		{
+			"type": "shell",
+			"isBackground": true,
+			"problemMatcher": [
+				{
+					"owner": "quarkus",
+					"fileLocation": [
+						"relative",
+						"${workspaceFolder}/src/main/resources/templates"
+					],
+					"pattern": [
+						{
+							"regexp": "\\[(\\d+)\\]\\s(.*):(\\d+):(\\d+)\\s\\-\\s{(.*)}:\\s(.*)$",
+							"file": 2,
+							"line": 3,
+							"column": 4,
+							"message": 6
+						}
+					],
+					"background": {
+						"activeOnStart": true,
+						"beginsPattern": "^.*Task: ",
+						"endsPattern": "(^.*Quarkus .* started in .*\\.)|(^.* ERROR .* Failed to start)"
+					}
+				}
+			],
+			"group": "build",
+			"label": "quarkusDev",
+			"command": "./gradlew quarkusDev --console=plain",
+			"windows": {
+				"command": ".\\gradlew.bat quarkusDev --console=plain"
+			}
+		},
+		{
+			"type": "shell",
+			"isBackground": true,
+			"problemMatcher": [
+				{
+					"owner": "quarkus",
+					"fileLocation": [
+						"relative",
+						"${workspaceFolder}/src/main/resources/templates"
+					],
+					"pattern": [
+						{
+							"regexp": "\\[(\\d+)\\]\\s(.*):(\\d+):(\\d+)\\s\\-\\s{(.*)}:\\s(.*)$",
+							"file": 2,
+							"line": 3,
+							"column": 4,
+							"message": 6
+						}
+					],
+					"background": {
+						"activeOnStart": true
+					}
+				}
+			],
+			"group": "build",
+			"label": "buildNative",
+			"command": "./gradlew buildNative --console=plain",
+			"windows": {
+				"command": ".\\gradlew.bat buildNative --console=plain"
+			}
+		},
+		{
+            "label": "build",
+            "type": "shell",
+            "command": "./gradlew build -x test",
+            "problemMatcher": [],
+            "group": {
+                "kind": "build",
+                "isDefault": true
+            }
+        }
+	]
+}

package/src/generators/preset/files/kotlin/Dockerfile

@@ -0,0 +1,58 @@
+# syntax=docker/dockerfile:1
+
+# ==============================================
+# Stage 1: Build native executable
+# ==============================================
+FROM quay.io/quarkus/ubi-quarkus-mandrel-builder-image:jdk-21 AS build
+
+# Switch to root for installation
+USER root
+RUN microdnf install -y findutils
+
+# Copy Gradle wrapper and build configuration first (for better caching)
+COPY --chown=quarkus:quarkus gradlew /code/gradlew
+COPY --chown=quarkus:quarkus gradle /code/gradle
+COPY --chown=quarkus:quarkus .editorconfig /code/
+COPY --chown=quarkus:quarkus build.gradle.kts /code/
+COPY --chown=quarkus:quarkus settings.gradle.kts /code/
+COPY --chown=quarkus:quarkus gradle.properties /code/
+
+# Switch user for security
+USER quarkus
+WORKDIR /code
+
+# Make Gradle wrapper executable and download dependencies
+RUN --mount=type=cache,target=/home/quarkus/.gradle,uid=1001,gid=1001 \
+    chmod +x gradlew && \
+    ./gradlew dependencies --no-daemon --stacktrace
+
+
+# Build native executable
+COPY --chown=quarkus:quarkus src /code/src
+RUN --mount=type=cache,target=/home/quarkus/.gradle,uid=1001,gid=1001 \
+    ./gradlew build \
+    -Dquarkus.package.main-class=io.kong.sdk.function.template.QuarkusApp \
+    -Dquarkus.native.enabled=true \
+    -Dquarkus.profile=prod \
+    -Dquarkus.package.jar.enabled=false \
+    -x test \
+    --no-daemon \
+    --stacktrace
+
+# ==============================================
+# Stage 2: Create runtime image
+# ==============================================
+FROM quay.io/quarkus/quarkus-micro-image:2.0
+
+WORKDIR /work/
+
+RUN chown 1001 /work \
+    && chmod "g+rwX" /work \
+    && chown 1001:root /work
+COPY --chown=1001:root --from=build /code/build/*-runner /work/application
+
+EXPOSE 8080
+USER 1001
+
+CMD ["./application", "-Dquarkus.http.host=0.0.0.0"]
+

package/src/generators/preset/files/kotlin/README.md

@@ -0,0 +1,172 @@
+# Kong Extension
+
+Welcome to the Kong extension development workspace!
+
+To have a better experience, open this file in preview mode of your IDE.
+
+### Prerequisites
+
+Before you start, make sure you have the following installed depending on your OS:
+
+[▶ Windows](#windows-setup)
+
+[▶ Ubuntu](#ubuntu-setup)
+
+[▶ macOS](#macos-setup)
+
+To verify the installation and check the versions, run the following commands:
+
+```shell script
+node --version
+docker info
+```
+
+### Getting Started
+
+1. Make sure you're in the terminal and inside the extension folder you generated
+2. Run the following commands in your terminal:
+
+```shell script
+# configure the base Kong URL (e.g., https://sandbox.kong.dev.app-dts.net)
+kong configure
+```
+
+and assign aliases for use in the workflow.
+
+### Publish a New Version
+
+To automatically tag your code with an incremented version number (e.g., 1, 2, 3), run:
+
+```shell script
+kong publish-version --verbose
+```
+
+### List Available Versions
+
+To see all available versions of your extension, run:
+
+```shell script
+kong list-versions
+```
+
+### Assign an Alias to a Version
+
+You can assign an alias (e.g., stable, beta) to a specific version. This alias will appear in the UI as a separate step in the workflow. For example, to assign the alias stable to version 1, use:
+
+```shell script
+# send all traffic to version 1
+kong set-alias stable 1
+
+# split live traffic: 80% to version 1, 20% to version 2 (weights must add up to 100)
+kong set-alias stable 1:80 2:20
+
+# same split, plus mirror traffic to version 3 as a shadow (it serves no live traffic)
+kong set-alias stable 1:80 2:20 3:shadow
+```
+
+### Using a Custom Profile
+
+If you're developing an extension that will be used in different regions (or need to work with a specific profile), you can create a new profile using `kong configure`. Then, include the `--profile <name>` parameter when running the publish-version and set-alias commands to use the desired profile.
+
+### Update CLI
+
+To install the latest version of the CLI, run:
+
+```shell script
+npm i -g @devkong/cli@latest
+```
+
+### Setup
+
+<details id="windows-setup">
+<summary><strong>Windows</strong></summary>
+
+### Install Windows Subsystem for Linux (WSL2)
+
+1. Open PowerShell as Administrator.
+2. Run the following command to install WSL and set WSL2 as the default version:
+   ```powershell
+   wsl --install
+   ```
+3. Restart your computer if prompted.
+4. After restarting, install a preferred Linux distribution (e.g., Ubuntu) by running:
+   ```powershell
+   wsl --install -d Ubuntu
+   ```
+
+### Install Docker within WSL2
+
+1. Download Docker Desktop for Windows from [Docker's official website](https://www.docker.com/products/docker-desktop).
+2. Run the installer and follow the setup instructions.
+3. During installation, ensure the "Use the WSL 2 based engine" option is selected.
+4. Once installed, open Docker Desktop, go to Settings > General, and enable "Use WSL 2 based engine" if it isn't already enabled.
+5. Confirm Docker is working in your WSL2 distribution (e.g., Ubuntu) by running:
+   ```bash
+   docker --version
+   ```
+
+### Install Node.js and npm on Windows Host
+
+1. Download the Node.js installer for Windows from the [official Node.js website](https://nodejs.org/).
+2. Run the installer, making sure to include the npm package manager during installation.
+3. Verify installation by opening a new Command Prompt and running:
+   ```cmd
+   node -v
+   npm -v
+   ```
+
+</details>
+
+<details id="ubuntu-setup">
+<summary><strong>Ubuntu</strong></summary>
+
+### Install Docker
+
+1. Follow the installation instructions on [Docker's official website](https://docs.docker.com/engine/install/ubuntu/).
+2. Start Docker and enable it to start on boot:
+   ```bash
+   sudo systemctl start docker
+   sudo systemctl enable docker
+   ```
+
+### Install Node.js and npm
+
+1. Run the following commands:
+   ```bash
+   sudo apt update
+   sudo apt install -y nodejs npm
+   ```
+2. Verify installation:
+   ```bash
+   node -v
+   npm -v
+   ```
+
+</details>
+
+<details id="macos-setup">
+<summary><strong>macOS</strong></summary>
+
+To emulate a Linux platform, you need to install Rosetta:
+
+```shell script
+softwareupdate --install-rosetta
+```
+
+### Install Docker
+
+1. Download and install Docker Desktop for Mac from [Docker's official website](https://www.docker.com/products/docker-desktop).
+
+### Install Node.js and npm
+
+1. Use Homebrew to install:
+   ```bash
+   brew install node
+   ```
+2. Verify installation:
+   ```bash
+   node -v
+   npm -v
+   ```
+
+</details>

package/src/generators/preset/files/kotlin/build.gradle.kts.template

@@ -0,0 +1,64 @@
+val javaVersion: String by project
+val kongVersion: String by project
+val kotlinxCoroutinesTestVersion: String by project
+val quarkusVersion: String by project
+
+plugins {
+  kotlin("jvm")
+  kotlin("plugin.allopen")
+  id("io.quarkus")
+  id("org.jlleitschuh.gradle.ktlint")
+}
+
+repositories {
+  mavenCentral()
+  mavenLocal()
+  maven {
+    url = uri("https://nexus.shared.sg.app-dts.net/repository/maven-releases/")
+  }
+  maven {
+    url = uri("https://nexus.shared.sg.app-dts.net/repository/maven-snapshots/")
+  }
+}
+
+dependencies {
+  implementation("io.kong:kong-common:$kongVersion")
+  implementation("io.kong:kong-sdk-kotlin:$kongVersion")
+  implementation("io.kong:kong-sdk-function-template:$kongVersion")
+
+  implementation(enforcedPlatform("io.quarkus.platform:quarkus-bom:$quarkusVersion"))
+  implementation("io.quarkus:quarkus-arc")
+  implementation("io.quarkus:quarkus-jackson")
+  implementation("io.quarkus:quarkus-kotlin")
+
+  testImplementation("io.quarkus:quarkus-junit5")
+  testImplementation("org.jetbrains.kotlinx:kotlinx-coroutines-test:$kotlinxCoroutinesTestVersion")
+}
+
+group = "io.kong.extension"
+version = "0.0.1-SNAPSHOT"
+
+java {
+  sourceCompatibility = JavaVersion.toVersion(javaVersion)
+  targetCompatibility = JavaVersion.toVersion(javaVersion)
+}
+
+tasks.withType<Test> {
+  systemProperty("java.util.logging.manager", "org.jboss.logmanager.LogManager")
+}
+
+allOpen {
+  annotation("jakarta.ws.rs.Path")
+  annotation("jakarta.enterprise.context.ApplicationScoped")
+  annotation("jakarta.persistence.Entity")
+  annotation("io.quarkus.test.junit.QuarkusTest")
+}
+
+kotlin {
+  compilerOptions {
+    jvmTarget =
+      org.jetbrains.kotlin.gradle.dsl.JvmTarget
+        .fromTarget(javaVersion)
+    javaParameters = true
+  }
+}

package/src/generators/preset/files/kotlin/gradle/wrapper/gradle-wrapper.properties

@@ -0,0 +1,6 @@
+distributionBase=GRADLE_USER_HOME
+distributionPath=wrapper/dists
+distributionUrl=https\://services.gradle.org/distributions/gradle-8.14.4-bin.zip
+networkTimeout=10000
+zipStoreBase=GRADLE_USER_HOME
+zipStorePath=wrapper/dists

package/src/generators/preset/files/kotlin/gradle.properties

@@ -0,0 +1,25 @@
+# Gradle properties
+org.gradle.jvmargs=-Xms4g -Xmx4g -XX:MaxMetaspaceSize=512m -XX:+HeapDumpOnOutOfMemoryError -Dfile.encoding=UTF-8
+kotlin.code.style=official
+javaVersion=21
+
+# kong artifacts
+kongVersion=0.0.41-SNAPSHOT
+
+# https://mvnrepository.com/artifact/org.jlleitschuh.gradle/ktlint-gradle
+jlleitschuhGradlePluginVersion=14.0.1
+
+#https://mvnrepository.com/artifact/com.networknt/json-schema-validator
+jsonSchemaValidatorVersion=1.5.8
+
+# https://mvnrepository.com/artifact/org.jetbrains.kotlin/kotlin-stdlib
+kotlinVersion=2.1.21
+
+# https://mvnrepository.com/artifact/org.jetbrains.kotlinx/kotlinx-coroutines-test
+kotlinxCoroutinesTestVersion=1.10.2
+
+# https://mvnrepository.com/artifact/dev.nx.gradle.project-graph/dev.nx.gradle.project-graph.gradle.plugin
+nxGradleVersion=0.1.21
+
+# https://mvnrepository.com/artifact/io.quarkus/quarkus-core
+quarkusVersion=3.27.3