Release 0.1.0

.fernignore

@@ -0,0 +1 @@
+# Specify files that shouldn't be modified by Fern

.github/workflows/ci.yml

@@ -0,0 +1,48 @@
+name: ci
+
+on: [push]
+
+jobs:
+  compile:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repo
+        uses: actions/checkout@v4
+
+      - name: Setup PHP
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: "8.1"
+
+      - name: Install tools
+        run: |
+          composer install
+
+      - name: Build
+        run: |
+          composer build
+
+      - name: Analyze
+        run: |
+          composer analyze
+
+  unit-tests:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repo
+        uses: actions/checkout@v4
+
+      - name: Setup PHP
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: "8.1"
+
+      - name: Install tools
+        run: |
+          composer install
+
+      - name: Run Tests
+        run: |
+          composer test

.gitignore

@@ -0,0 +1,4 @@
+.php-cs-fixer.cache
+.phpunit.result.cache
+composer.lock
+vendor/

composer.json

@@ -0,0 +1,40 @@
+
+{
+  "name": "ssoready/ssoready",
+  "version": "0.1.0",
+  "description": "Ssoready PHP Library",
+  "keywords": [
+    "ssoready",
+    "api",
+    "sdk"
+  ],
+  "license": [],
+  "require": {
+    "php": "^8.1",
+    "ext-json": "*",
+    "guzzlehttp/guzzle": "^7.9"
+  },
+  "require-dev": {
+    "phpunit/phpunit": "^9.0",
+    "friendsofphp/php-cs-fixer": "3.5.0",
+    "phpstan/phpstan": "^1.12"
+  },
+  "autoload": {
+    "psr-4": {
+      "Ssoready\\": "src/"
+    }
+  },
+  "autoload-dev": {
+    "psr-4": {
+      "\\Ssoready\\Tests\\": "tests/"
+    }
+  },
+  "scripts": {
+    "build": [
+      "@php -l src",
+      "@php -l tests"
+    ],
+    "test": "phpunit",
+    "analyze": "phpstan analyze src tests"
+  }
+}

phpstan.neon

@@ -0,0 +1,5 @@
+parameters:
+    level: max
+    paths:
+        - src
+        - tests

phpunit.xml

@@ -0,0 +1,7 @@
+<phpunit bootstrap="vendor/autoload.php">
+    <testsuites>
+        <testsuite name="Test Suite">
+            <directory suffix="Test.php">tests</directory>
+        </testsuite>
+    </testsuites>
+</phpunit>

src/Core/Client/BaseApiRequest.php

@@ -0,0 +1,22 @@
+<?php
+
+namespace Ssoready\Core\Client;
+
+abstract class BaseApiRequest
+{
+    /**
+     * @param string $baseUrl The base URL for the request
+     * @param string $path The path for the request
+     * @param HttpMethod $method The HTTP method for the request
+     * @param array<string, string> $headers Additional headers for the request (optional)
+     * @param array<string, mixed> $query Query parameters for the request (optional)
+     */
+    public function __construct(
+        public readonly string      $baseUrl,
+        public readonly string      $path,
+        public readonly HttpMethod  $method,
+        public readonly array       $headers = [],
+        public readonly array       $query = [],
+    ) {
+    }
+}

src/Core/Client/HttpMethod.php

@@ -0,0 +1,12 @@
+<?php
+
+namespace Ssoready\Core\Client;
+
+enum HttpMethod
+{
+    case GET;
+    case POST;
+    case PUT;
+    case PATCH;
+    case DELETE;
+}

src/Core/Client/RawClient.php

@@ -0,0 +1,146 @@
+<?php
+
+namespace Ssoready\Core\Client;
+
+use GuzzleHttp\Client;
+use GuzzleHttp\ClientInterface;
+use GuzzleHttp\Psr7\MultipartStream;
+use GuzzleHttp\Psr7\Request;
+use GuzzleHttp\Psr7\Utils;
+use InvalidArgumentException;
+use Psr\Http\Client\ClientExceptionInterface;
+use Psr\Http\Message\ResponseInterface;
+use Psr\Http\Message\StreamInterface;
+use Ssoready\Core\Json\JsonApiRequest;
+use Ssoready\Core\Multipart\MultipartApiRequest;
+
+class RawClient
+{
+    /**
+     * @var ClientInterface $client
+     */
+    private ClientInterface $client;
+
+    /**
+     * @var array<string, string> $headers
+     */
+    private array $headers;
+
+    /**
+     * @param ?array{
+     *   baseUrl?: string,
+     *   client?: ClientInterface,
+     *   headers?: array<string, string>,
+     * } $options
+     */
+    public function __construct(
+        public readonly ?array $options = null,
+    ) {
+        $this->client = $this->options['client'] ?? new Client();
+        $this->headers = $this->options['headers'] ?? [];
+    }
+
+    /**
+     * @throws ClientExceptionInterface
+     */
+    public function sendRequest(
+        BaseApiRequest $request,
+    ): ResponseInterface {
+        $httpRequest = $this->buildRequest($request);
+        return $this->client->send($httpRequest);
+    }
+
+    private function buildRequest(
+        BaseApiRequest $request
+    ): Request {
+        $url = $this->buildUrl($request);
+        $headers = $this->encodeHeaders($request);
+        $body = $this->encodeRequestBody($request);
+        return new Request(
+            $request->method->name,
+            $url,
+            $headers,
+            $body,
+        );
+    }
+
+    /**
+     * @return array<string, string>
+     */
+    private function encodeHeaders(
+        BaseApiRequest $request
+    ): array {
+        return match (get_class($request)) {
+            JsonApiRequest::class => array_merge(
+                ["Content-Type" => "application/json"],
+                $this->headers,
+                $request->headers
+            ),
+            MultipartApiRequest::class => array_merge(
+                $this->headers,
+                $request->headers
+            ),
+            default => throw new InvalidArgumentException('Unsupported request type: ' . get_class($request)),
+        };
+    }
+
+    private function encodeRequestBody(
+        BaseApiRequest $request
+    ): ?StreamInterface {
+        return match (get_class($request)) {
+            JsonApiRequest::class => $request->body != null ? Utils::streamFor(json_encode($request->body)) : null,
+            MultipartApiRequest::class => $request->body != null ? new MultipartStream($request->body->toArray()) : null,
+            default => throw new InvalidArgumentException('Unsupported request type: '.get_class($request)),
+        };
+    }
+
+    private function buildUrl(
+        BaseApiRequest $request
+    ): string {
+        $baseUrl = $request->baseUrl;
+        $trimmedBaseUrl = rtrim($baseUrl, '/');
+        $trimmedBasePath = ltrim($request->path, '/');
+        $url = "{$trimmedBaseUrl}/{$trimmedBasePath}";
+
+        if (!empty($request->query)) {
+            $url .= '?' . $this->encodeQuery($request->query);
+        }
+
+        return $url;
+    }
+
+    /**
+     * @param array<string, mixed> $query
+     */
+    private function encodeQuery(
+        array $query
+    ): string {
+        $parts = [];
+        foreach ($query as $key => $value) {
+            if (is_array($value)) {
+                foreach ($value as $item) {
+                    $parts[] = urlencode($key).'='.$this->encodeQueryValue($item);
+                }
+            } else {
+                $parts[] = urlencode($key).'='.$this->encodeQueryValue($value);
+            }
+        }
+        return implode('&', $parts);
+    }
+
+    private function encodeQueryValue(
+        mixed $value
+    ): string {
+        if (is_string($value)) {
+            return urlencode($value);
+        }
+        if (is_scalar($value)) {
+            return urlencode((string)$value);
+        }
+        if (is_null($value)) {
+            return 'null';
+        }
+        // Unreachable, but included for a best effort.
+        return urlencode(strval(json_encode($value)));
+    }
+}

src/Core/Json/JsonApiRequest.php

@@ -0,0 +1,28 @@
+<?php
+
+namespace Ssoready\Core\Json;
+
+use Ssoready\Core\Client\BaseApiRequest;
+use Ssoready\Core\Client\HttpMethod;
+
+class JsonApiRequest extends BaseApiRequest
+{
+    /**
+     * @param string $baseUrl The base URL for the request
+     * @param string $path The path for the request
+     * @param HttpMethod $method The HTTP method for the request
+     * @param array<string, string> $headers Additional headers for the request (optional)
+     * @param array<string, mixed> $query Query parameters for the request (optional)
+     * @param mixed|null $body The JSON request body (optional)
+     */
+    public function __construct(
+        string $baseUrl,
+        string $path,
+        HttpMethod $method,
+        array $headers = [],
+        array $query = [],
+        public readonly mixed $body = null
+    ) {
+        parent::__construct($baseUrl, $path, $method, $headers, $query);
+    }
+}