Merge pull request #1 from airlst/feature/event-resource

Added event resource

.github/workflows/ci.yml

@@ -0,0 +1,31 @@
+name: CI
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+    branches:
+      - main
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v2
+
+      - name: Set up PHP
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: 8.3
+
+      - name: Install dependencies
+        run: composer install --prefer-dist --no-progress --no-suggest
+
+      - name: Run PHPUnit
+        run: vendor/bin/phpunit
+
+      - name: Run PHPStan
+        run: vendor/bin/phpstan analyze -l 6 src

composer.json

@@ -2,7 +2,7 @@
   "name": "airlst/sdk-php",
   "description": "This package is a SDK for handling AirLST Core API calls",
   "type": "library",
-  "minimum-stability": "dev",
+  "minimum-stability": "stable",
   "authors": [
     {
       "name": "Jantinn Erezo",
@@ -12,13 +12,12 @@
   ],
   "require": {
     "guzzlehttp/guzzle": "^6.0|^7.0",
-    "php": "^8.2"
+    "php": "^8.3"
   },
   "require-dev": {
     "friendsofphp/php-cs-fixer": "^2.0|^3.14",
     "mockery/mockery": "^1.4",
-    "nunomaduro/larastan": "^1.0|^2.4",
-    "orchestra/testbench": "^6.0|^7.0|^8.0",
+    "orchestra/testbench": "^6.0|^7.0|^8.0|^9.0",
     "phpunit/phpunit": "^8.0|^9.0|^10.0"
   },
   "autoload": {
@@ -35,16 +34,9 @@
     "test": "./vendor/bin/phpunit",
     "test-coverage": "XDEBUG_MODE=coverage ./vendor/bin/phpunit --coverage-html .coverage",
     "fix": "PHP_CS_FIXER_IGNORE_ENV=1 ./vendor/bin/php-cs-fixer fix --verbose --config=.php-cs-fixer.php",
-    "phpstan": "./vendor/bin/phpstan analyse"
+    "phpstan": "./vendor/bin/phpstan analyse src"
   },
   "config": {
     "sort-packages": true
-  },
-  "extra": {
-    "laravel": {
-      "providers": [
-        "AirLST\\SdkPhp\\Laravel\\AirLSTSdkPhpServiceProvider"
-      ]
-    }
   }
-}
+}

src/CoreApi.php

@@ -0,0 +1,95 @@
+<?php
+
+declare(strict_types=1);
+
+namespace AirLST\SdkPhp;
+
+use GuzzleHttp\Client;
+use GuzzleHttp\Exception\ClientException;
+use GuzzleHttp\HandlerStack;
+
+class CoreApi
+{
+    public string $baseURL = 'https://airlst.app';
+    public string $apiKey;
+    public string $locale = 'de-DE';
+    public string $eventId;
+    protected ?HandlerStack $handler = null;
+
+    public function setBaseURL(string $baseURL): self
+    {
+        $this->baseURL = $baseURL;
+
+        return $this;
+    }
+
+    public function setApiKey(string $apiKey): self
+    {
+        $this->apiKey = $apiKey;
+
+        return $this;
+    }
+
+    public function setLocale(string $locale): self
+    {
+        $this->locale = $locale;
+
+        return $this;
+    }
+
+    public function setEventId(string $eventId): self
+    {
+        $this->eventId = $eventId;
+
+        return $this;
+    }
+
+    /** 
+     * @return array<string, string>
+     */
+    public function getRequestHeaders(): array
+    {
+        return [
+            'content-type' => 'application/json',
+            'accept' => 'application/json',
+            'x-api-key' => $this->apiKey,
+            'accept-language' => $this->locale,
+        ];
+    }
+
+    public function setHandler(HandlerStack $handler): void
+    {
+        $this->handler = $handler;
+    }
+
+    /**
+     * @param string $uri
+     * @param RequestMethod $method
+     * @param array<mixed> $options
+     * @return array<mixed>
+     */
+    public function send(
+        string $uri, 
+        RequestMethod $method = RequestMethod::GET, 
+        array $options = []
+    ): array
+    {        
+        try {
+            $client = new Client([
+                'base_uri' => $this->baseURL,
+                'headers' => $this->getRequestHeaders(),
+                'handler' => $this->handler
+            ]);
+
+            $response = $client->request($method->value, "/api$uri", $options);
+
+            return json_decode((string) $response->getBody(), true);
+        } catch (ClientException $exception) {
+            throw new \RuntimeException(
+                $exception->getResponse()->getBody()->getContents(),
+                $exception->getCode(),
+                $exception
+            );
+        }
+    }
+}

src/Resources/Event.php

@@ -0,0 +1,16 @@
+<?php
+
+namespace AirLST\SdkPhp\Resources;
+
+use AirLST\SdkPhp\CoreApi;
+
+class Event extends CoreApi
+{
+    /**
+     * @return array<mixed>
+     */
+    public function get(): array
+    {
+        return $this->send("/events/{$this->eventId}");
+    }
+}

src/Resources/Guest.php

@@ -4,38 +4,59 @@
 
 namespace AirLST\SdkPhp\Resources;
 
-use AirLST\SdkPhp\Client;
+use AirLST\SdkPhp\CoreApi;
 use AirLST\SdkPhp\RequestMethod;
 
-class Guest extends Resource
+class Guest extends CoreApi
 {
-    public function __construct(protected Client $client)
-    {
-    }
-
+    /** 
+     * @return array{'data': array{'code': string}}
+     */
     public function validateCode(string $code): array
     {
-        return $this->client->send("{$this->getEventURL()}/guests/validate-code", RequestMethod::POST, [
-            'form_params' => ['code' => $code],
-        ]);
+        return $this->send(
+            uri: "{$this->getEventURL()}/guests/validate-code", 
+            method: RequestMethod::POST, 
+            options: ['form_params' => ['code' => $code]]
+        );
     }
 
+    /** 
+     * @return array{'data': array<mixed>}
+     */
     public function get(string $code): array
     {
-        return $this->client->send("{$this->getEventURL()}/guests/{$code}");
+        return $this->send("{$this->getEventURL()}/guests/{$code}");
     }
 
+    /** 
+     * @param array<mixed> $data
+     * @return array{'data': array<mixed>}
+     */
     public function create(array $data): array
     {
-        return $this->client->send("{$this->getEventURL()}/guests", RequestMethod::POST, [
-            'form_params' => $data
-        ]);
+        return $this->send(
+            uri: "{$this->getEventURL()}/guests", 
+            method: RequestMethod::POST, 
+            options: ['form_params' => $data]
+        );
     }
 
+    /** 
+     * @param array<mixed> $data
+     * @return array{'data': array<mixed>}
+     */
     public function update(string $code, array $data): array
     {
-        return $this->client->send("{$this->getEventURL()}/guests/{$code}", RequestMethod::PUT, [
-            'form_params' => $data
-        ]);
+        return $this->send(
+            uri: "{$this->getEventURL()}/guests/{$code}", 
+            method: RequestMethod::PUT, 
+            options: ['form_params' => $data]
+        );
+    }
+
+    public function getEventURL(): string
+    {
+        return "/events/{$this->eventId}";
     }
 }