Release v1.0.1

Author: sborsje

.github/workflows/test.yml

@@ -0,0 +1,31 @@
+name: Test
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        java-version: ["11", "17", "21"]
+    
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Java ${{ matrix.java-version }}
+        uses: actions/setup-java@v4
+        with:
+          java-version: ${{ matrix.java-version }}
+          distribution: "temurin"
+          cache: "maven"
+
+      - name: Run tests
+        run: mvn test -B
+
+      - name: Build package
+        run: mvn package -B -DskipTests
+

.gitignore

@@ -0,0 +1,38 @@
+# Maven
+target/
+pom.xml.tag
+pom.xml.releaseBackup
+pom.xml.versionsBackup
+pom.xml.next
+release.properties
+dependency-reduced-pom.xml
+buildNumber.properties
+.mvn/timing.properties
+.mvn/wrapper/maven-wrapper.jar
+
+# IDE
+.idea/
+*.iml
+*.ipr
+*.iws
+.project
+.classpath
+.settings/
+.vscode/
+*.swp
+*.swo
+
+# Build
+build/
+dist/
+*.jar
+*.war
+*.ear
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Logs
+*.log
+

CHANGELOG.md

@@ -0,0 +1,11 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [1.0.1] - 2025-12-10
+
+- Java SDK with Maven support and JUnit 5 testing framework
+

CONTRIBUTING.md

@@ -0,0 +1,101 @@
+# Contributing to Klime Java SDK
+
+Thank you for your interest in contributing to the Klime Java SDK!
+
+## Important: Repository Structure
+
+This repository is a **read-only mirror** of our internal monorepo.
+
+### What This Means for Contributors
+
+- **Pull requests are welcome** and will be reviewed
+- If accepted, we'll **manually port changes** to our internal monorepo
+- Changes appear in this repository with the **next release**
+- You'll be credited as a co-author in the commit
+
+## How to Contribute
+
+1. **Fork this repository**
+
+2. **Clone your fork**
+   ```bash
+   git clone https://github.com/YOUR_USERNAME/klime-java.git
+   cd klime-java
+   ```
+
+3. **Create a feature branch**
+   ```bash
+   git checkout -b feature/your-feature-name
+   ```
+
+4. **Make your changes**
+   - Follow Java coding conventions
+   - Add tests for new functionality
+   - Update documentation as needed
+
+5. **Run the tests**
+   ```bash
+   mvn test
+   ```
+
+6. **Commit your changes**
+   ```bash
+   git commit -m "Add: description of your change"
+   ```
+
+7. **Push to your fork**
+   ```bash
+   git push origin feature/your-feature-name
+   ```
+
+8. **Open a Pull Request**
+
+## Development Setup
+
+### Prerequisites
+
+- Java 11 or later
+- Maven 3.6+
+
+### Building
+
+```bash
+# Compile
+mvn compile
+
+# Run tests
+mvn test
+
+# Package
+mvn package
+
+# Install to local Maven repository
+mvn install
+```
+
+### Code Style
+
+- Follow standard Java conventions
+- Use meaningful variable and method names
+- Add Javadoc for public methods
+- Keep methods focused and small
+- Prefer immutability where possible
+
+### Testing
+
+- Write unit tests for all new functionality
+- Integration tests should use the built-in HTTP server (`com.sun.net.httpserver`)
+- Disable auto-flush in tests to avoid flakiness
+- Tests should be fast (< 100ms total)
+
+## Reporting Issues
+
+- Check existing issues before creating a new one
+- Include Java version and Maven version
+- Provide a minimal reproducible example
+- Include stack traces for errors
+
+## Questions?
+
+If you have questions about contributing, feel free to open an issue with the "question" label.
+

LICENSE.md

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2025 Klime
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+