Release v1.0.1

Author: sborsje

.github/workflows/test.yml

@@ -0,0 +1,32 @@
+name: Test
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+
+    strategy:
+      matrix:
+        php-version: ["8.1", "8.2", "8.3"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up PHP ${{ matrix.php-version }}
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: ${{ matrix.php-version }}
+          extensions: curl, json
+          coverage: none
+
+      - name: Install dependencies
+        run: composer install --prefer-dist --no-progress
+
+      - name: Run tests
+        run: vendor/bin/phpunit --testdox
+

.gitignore

@@ -0,0 +1,5 @@
+/vendor/
+/composer.lock
+/.phpunit.cache/
+/.phpunit.result.cache
+

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
+
+- Implement PHP SDK with core functionality for Klime API integration
+

CONTRIBUTING.md

@@ -0,0 +1,129 @@
+# Contributing to Klime PHP SDK
+
+Thank you for your interest in contributing to the Klime PHP SDK!
+
+## Important: Repository Structure
+
+This repository is a **read-only mirror** of our internal monorepo. We develop and maintain the SDK internally, then mirror releases to this public repository.
+
+### What This Means for Contributors
+
+- **Pull requests are welcome** and will be reviewed by our team
+- If accepted, we'll **manually port your changes** to our internal monorepo
+- Your changes will appear in this repository with the **next release**
+- You'll be credited as a co-author in the commit
+
+## How to Contribute
+
+### Reporting Bugs
+
+1. Check if the bug has already been reported in [Issues](../../issues)
+2. If not, create a new issue with:
+   - A clear, descriptive title
+   - Steps to reproduce the bug
+   - Expected vs actual behavior
+   - Your environment (PHP version, OS, etc.)
+   - Any relevant code snippets or error messages
+
+### Suggesting Features
+
+1. Check if the feature has already been suggested in [Issues](../../issues)
+2. Create a new issue describing:
+   - The problem you're trying to solve
+   - Your proposed solution
+   - Any alternatives you've considered
+
+### Submitting Code Changes
+
+1. Fork this repository
+2. Create a feature branch (`git checkout -b feat/amazing-feature`)
+3. Make your changes
+4. Write or update tests as needed
+5. Ensure all tests pass (`composer test`)
+6. Commit using [Conventional Commits](https://www.conventionalcommits.org/):
+   ```
+   feat: add new tracking method
+   fix: handle edge case in batch processing
+   docs: update README examples
+   ```
+7. Push to your fork and open a Pull Request
+
+### Pull Request Guidelines
+
+- Provide a clear description of what the PR does
+- Reference any related issues
+- Include tests for new functionality
+- Update documentation if needed
+- Keep PRs focused - one feature or fix per PR
+
+## Development Setup
+
+```bash
+# Clone your fork
+git clone https://github.com/YOUR_USERNAME/klime-php.git
+cd klime-php
+
+# Install dependencies
+composer install
+
+# Run tests
+composer test
+
+# Or run PHPUnit directly
+vendor/bin/phpunit --testdox
+```
+
+## Project Structure
+
+```
+klime-php/
+├── src/
+│   ├── Client.php              # Main client implementation
+│   ├── Event.php               # Event class
+│   ├── EventType.php           # Event type constants
+│   ├── EventContext.php        # Event context
+│   ├── LibraryInfo.php         # Library info
+│   ├── BatchResponse.php       # API response
+│   ├── ValidationError.php     # Validation error
+│   └── ConfigurationException.php
+├── tests/
+│   ├── ClientTest.php
+│   ├── EventTest.php
+│   └── ...
+├── composer.json
+├── phpunit.xml
+└── README.md
+```
+
+## Code Style
+
+- Follow [PSR-12](https://www.php-fig.org/psr/psr-12/) coding standard
+- Use strict types (`declare(strict_types=1)`)
+- Add PHPDoc comments for public methods
+- Use type hints for all parameters and return types
+- Keep methods small and focused
+
+## Running Tests
+
+```bash
+# Run all tests
+composer test
+
+# Run with verbose output
+vendor/bin/phpunit --testdox
+
+# Run specific test file
+vendor/bin/phpunit tests/EventTest.php
+
+# Run specific test method
+vendor/bin/phpunit --filter testGeneratesUuid
+```
+
+## Questions?
+
+If you have questions about contributing, feel free to open an issue and we'll be happy to help!
+
+## License
+
+By contributing, you agree that your contributions will be licensed under the MIT License.
+

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.
+