chore: add wrapper and release packaging scripts

Author: nitheeshmk41

.github/workflows/release-artifacts.yml

@@ -0,0 +1,98 @@
+name: Release Artifacts
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+
+permissions:
+  contents: write
+
+jobs:
+  build-jar:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Set up Java 17
+        uses: actions/setup-java@v4
+        with:
+          distribution: temurin
+          java-version: "17"
+
+      - name: Make wrapper executable
+        run: chmod +x ./mvnw
+
+      - name: Build shaded jar
+        run: ./mvnw -B clean package
+
+      - name: Upload JAR artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: mynosql-jar
+          path: |
+            target/mynosql-*.jar
+            !target/original-*.jar
+
+      - name: Attach JAR to GitHub release
+        if: github.event_name == 'release'
+        uses: softprops/action-gh-release@v2
+        with:
+          files: |
+            target/mynosql-*.jar
+            !target/original-*.jar
+
+  build-windows-exe:
+    runs-on: windows-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Set up Java 17
+        uses: actions/setup-java@v4
+        with:
+          distribution: temurin
+          java-version: "17"
+
+      - name: Install WiX Toolset
+        shell: powershell
+        run: choco install wixtoolset --no-progress -y
+
+      - name: Build shaded jar
+        shell: cmd
+        run: mvnw.cmd -B clean package
+
+      - name: Create EXE with jpackage
+        shell: powershell
+        run: |
+          $jar = Get-ChildItem target -Filter 'mynosql-*.jar' |
+            Where-Object { $_.Name -notlike 'original-*' } |
+            Select-Object -First 1
+
+          if (-not $jar) {
+            throw "Could not find packaged JAR in target/."
+          }
+
+          New-Item -Path dist -ItemType Directory -Force | Out-Null
+
+          jpackage `
+            --type exe `
+            --name MyNoSQL `
+            --input target `
+            --main-jar $jar.Name `
+            --main-class com.mynosql.Main `
+            --dest dist `
+            --win-console
+
+      - name: Upload EXE artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: mynosql-windows-exe
+          path: dist/*.exe
+
+      - name: Attach EXE to GitHub release
+        if: github.event_name == 'release'
+        uses: softprops/action-gh-release@v2
+        with:
+          files: dist/*.exe

.gitignore

@@ -0,0 +1,9 @@
+.mvn/wrapper/apache-maven-*
+.mvn/wrapper/*.zip
+.mvn/wrapper/*.tar.gz
+dist/
+dist-app/
+dependency-reduced-pom.xml
+target/*.jar
+target/maven-archiver/
+target/maven-status/

.mvn/wrapper/maven-wrapper.properties

@@ -0,0 +1 @@
+distributionUrl=https://repo.maven.apache.org/maven2/org/apache/maven/apache-maven/3.9.9/apache-maven-3.9.9-bin.zip

README.md

@@ -103,6 +103,16 @@ Or with Maven (if installed):
 mvn clean compile
 ```
 
+Or with the included Maven Wrapper (no global Maven install required):
+
+```bash
+# Linux/macOS
+./mvnw clean compile
+
+# Windows
+mvnw.cmd clean compile
+```
+
 ### Run
 
 ```bash
@@ -118,6 +128,62 @@ java -cp "out;lib/gson-2.10.1.jar" com.mynosql.Main --shell
 > java -cp "out:lib/gson-2.10.1.jar" com.mynosql.Main
 > ```
 
+### Share with Others (JAR or EXE)
+
+#### Option 1: Portable JAR (works on any OS with Java installed)
+
+Build:
+
+```bash
+./mvnw clean package
+```
+
+Share:
+
+- `target/mynosql-1.0.0.jar`
+
+Run on recipient machine:
+
+```bash
+java -jar mynosql-1.0.0.jar
+# or shell only
+java -jar mynosql-1.0.0.jar --shell
+```
+
+Windows helper script:
+
+```bat
+scripts\build-portable.bat
+```
+
+#### Option 2: Native Windows EXE installer
+
+If you want users to launch via an `.exe`, build with `jpackage` (included in modern JDKs):
+
+```bat
+scripts\build-exe.bat
+```
+
+Output:
+
+- Installer and app files in `dist/`
+
+Notes:
+
+- `jpackage` requires JDK 17+ and must be on `PATH`.
+- The generated `.exe` is Windows-specific.
+- If you need macOS/Linux native packages too, run equivalent `jpackage` commands on those OSes.
+
+#### Option 3: Automatic release artifacts via GitHub Actions
+
+This repository includes a workflow at `.github/workflows/release-artifacts.yml` that:
+
+- Builds and uploads shaded JAR artifacts.
+- Builds and uploads Windows EXE artifacts.
+- Automatically attaches both to a GitHub Release when a release is published.
+
+You can also run it manually from the Actions tab using `workflow_dispatch`.
+
 ---
 
 ## Usage

mvnw

@@ -0,0 +1,69 @@
+@echo off
+setlocal
+
+REM Resolve jpackage from PATH first, then fallback to JAVA_HOME\bin
+set "JPACKAGE_EXE="
+for /f "delims=" %%I in ('where jpackage 2^>nul') do (
+  if not defined JPACKAGE_EXE set "JPACKAGE_EXE=%%I"
+)
+
+if not defined JPACKAGE_EXE (
+  if defined JAVA_HOME (
+    for %%I in ("%JAVA_HOME%") do (
+      if exist "%%~fI\bin\jpackage.exe" set "JPACKAGE_EXE=%%~fI\bin\jpackage.exe"
+    )
+  )
+)
+
+if not defined JPACKAGE_EXE (
+  echo jpackage was not found.
+  echo Install JDK 17+ and ensure either:
+  echo   1. jpackage is on PATH, or
+  echo   2. JAVA_HOME points to a JDK root directory.
+  exit /b 1
+)
+
+call mvnw.cmd -q clean package
+if errorlevel 1 (
+  echo Maven build failed.
+  exit /b 1
+)
+
+set "MAIN_JAR="
+for %%F in (target\mynosql-*.jar) do (
+  echo %%~nxF | findstr /I /B "original-" >nul
+  if errorlevel 1 (
+    set "MAIN_JAR=%%~nxF"
+    goto :jarFound
+  )
+)
+
+:jarFound
+if "%MAIN_JAR%"=="" (
+  echo Could not find packaged JAR in target\
+  exit /b 1
+)
+
+if exist dist-app rmdir /s /q dist-app
+mkdir dist-app
+
+"%JPACKAGE_EXE%" ^
+  --type app-image ^
+  --name MyNoSQL ^
+  --input target ^
+  --main-jar %MAIN_JAR% ^
+  --main-class com.mynosql.Main ^
+  --dest dist-app ^
+  --win-console
+
+if errorlevel 1 (
+  echo App-image packaging failed.
+  exit /b 1
+)
+
+echo.
+echo App-image build complete.
+echo Run from:
+echo   dist-app\MyNoSQL\MyNoSQL.exe
+
+endlocal