Release 0.0.1

Author: fern-api[bot]

.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,5 @@
+.idea
+.php-cs-fixer.cache
+.phpunit.result.cache
+composer.lock
+vendor/

README.md

@@ -0,0 +1,39 @@
+{
+  "name": "vapi/vapi",
+  "version": "0.0.1",
+  "description": "Vapi PHP Library",
+  "keywords": [
+    "vapi",
+    "api",
+    "sdk"
+  ],
+  "license": [],
+  "require": {
+    "php": "^8.1",
+    "ext-json": "*",
+    "guzzlehttp/guzzle": "^7.4"
+  },
+  "require-dev": {
+    "phpunit/phpunit": "^9.0",
+    "friendsofphp/php-cs-fixer": "3.5.0",
+    "phpstan/phpstan": "^1.12"
+  },
+  "autoload": {
+    "psr-4": {
+      "Vapi\\": "src/"
+    }
+  },
+  "autoload-dev": {
+    "psr-4": {
+      "Vapi\\Tests\\": "tests/"
+    }
+  },
+  "scripts": {
+    "build": [
+      "@php -l src",
+      "@php -l tests"
+    ],
+    "test": "phpunit",
+    "analyze": "phpstan analyze src tests --memory-limit=1G"
+  }
+}

composer.json

@@ -0,0 +1,6 @@
+parameters:
+    level: max
+    reportUnmatchedIgnoredErrors: false
+    paths:
+        - src
+        - tests

phpstan.neon

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

phpunit.xml

@@ -0,0 +1,108 @@
+<?php
+
+namespace Vapi\Analytics;
+
+use GuzzleHttp\ClientInterface;
+use Vapi\Core\Client\RawClient;
+use Vapi\Analytics\Requests\AnalyticsQueryDto;
+use Vapi\Types\AnalyticsQueryResult;
+use Vapi\Exceptions\VapiException;
+use Vapi\Exceptions\VapiApiException;
+use Vapi\Core\Json\JsonApiRequest;
+use Vapi\Environments;
+use Vapi\Core\Client\HttpMethod;
+use Vapi\Core\Json\JsonDecoder;
+use JsonException;
+use GuzzleHttp\Exception\RequestException;
+use Psr\Http\Client\ClientExceptionInterface;
+
+class AnalyticsClient
+{
+    /**
+     * @var array{
+     *   baseUrl?: string,
+     *   client?: ClientInterface,
+     *   maxRetries?: int,
+     *   timeout?: float,
+     *   headers?: array<string, string>,
+     * } $options
+     */
+    private array $options;
+
+    /**
+     * @var RawClient $client
+     */
+    private RawClient $client;
+
+    /**
+     * @param RawClient $client
+     * @param ?array{
+     *   baseUrl?: string,
+     *   client?: ClientInterface,
+     *   maxRetries?: int,
+     *   timeout?: float,
+     *   headers?: array<string, string>,
+     * } $options
+     */
+    public function __construct(
+        RawClient $client,
+        ?array $options = null,
+    ) {
+        $this->client = $client;
+        $this->options = $options ?? [];
+    }
+
+    /**
+     * @param AnalyticsQueryDto $request
+     * @param ?array{
+     *   baseUrl?: string,
+     *   maxRetries?: int,
+     *   timeout?: float,
+     *   headers?: array<string, string>,
+     *   queryParameters?: array<string, mixed>,
+     *   bodyProperties?: array<string, mixed>,
+     * } $options
+     * @return array<AnalyticsQueryResult>
+     * @throws VapiException
+     * @throws VapiApiException
+     */
+    public function get(AnalyticsQueryDto $request, ?array $options = null): array
+    {
+        $options = array_merge($this->options, $options ?? []);
+        try {
+            $response = $this->client->sendRequest(
+                new JsonApiRequest(
+                    baseUrl: $options['baseUrl'] ?? $this->client->options['baseUrl'] ?? Environments::Default_->value,
+                    path: "analytics",
+                    method: HttpMethod::POST,
+                    body: $request,
+                ),
+                $options,
+            );
+            $statusCode = $response->getStatusCode();
+            if ($statusCode >= 200 && $statusCode < 400) {
+                $json = $response->getBody()->getContents();
+                return JsonDecoder::decodeArray($json, [AnalyticsQueryResult::class]); // @phpstan-ignore-line
+            }
+        } catch (JsonException $e) {
+            throw new VapiException(message: "Failed to deserialize response: {$e->getMessage()}", previous: $e);
+        } catch (RequestException $e) {
+            $response = $e->getResponse();
+            if ($response === null) {
+                throw new VapiException(message: $e->getMessage(), previous: $e);
+            }
+            throw new VapiApiException(
+                message: "API request failed",
+                statusCode: $response->getStatusCode(),
+                body: $response->getBody()->getContents(),
+            );
+        } catch (ClientExceptionInterface $e) {
+            throw new VapiException(message: $e->getMessage(), previous: $e);
+        }
+        throw new VapiApiException(
+            message: 'API request failed',
+            statusCode: $statusCode,
+            body: $response->getBody()->getContents(),
+        );
+    }
+}

src/Analytics/AnalyticsClient.php

@@ -0,0 +1,28 @@
+<?php
+
+namespace Vapi\Analytics\Requests;
+
+use Vapi\Core\Json\JsonSerializableType;
+use Vapi\Types\AnalyticsQuery;
+use Vapi\Core\Json\JsonProperty;
+use Vapi\Core\Types\ArrayType;
+
+class AnalyticsQueryDto extends JsonSerializableType
+{
+    /**
+     * @var array<AnalyticsQuery> $queries This is the list of metric queries you want to perform.
+     */
+    #[JsonProperty('queries'), ArrayType([AnalyticsQuery::class])]
+    public array $queries;
+
+    /**
+     * @param array{
+     *   queries: array<AnalyticsQuery>,
+     * } $values
+     */
+    public function __construct(
+        array $values,
+    ) {
+        $this->queries = $values['queries'];
+    }
+}