phase 1 and 2

2026-04-03 00:23:01 +03:00
parent 4976742c29
commit 9dcf3c36d7
33 changed files with 2563 additions and 5 deletions
@@ -0,0 +1,119 @@
+<?php
+
+namespace App\Services\JobApi\Clients;
+
+use App\Services\JobApi\DTO\JobData;
+use App\Services\JobApi\Exceptions\ApiException;
+use App\Services\JobApi\Transformers\JobTransformer;
+use App\Services\JobApi\Transformers\RemotiveTransformer;
+use Illuminate\Http\Client\PendingRequest;
+
+class RemotiveClient extends JobApiClient
+{
+    protected function getTransformer(): JobTransformer
+    {
+        return new RemotiveTransformer();
+    }
+
+    protected function attachAuthentication(PendingRequest $client): PendingRequest
+    {
+        // Remotive API doesn't require authentication
+        return $client;
+    }
+
+    /**
+     * Fetch jobs from Remotive API
+     *
+     * @param array $params [
+     *   'search' => string,     // Job title keywords
+     *   'company_name' => string,
+     *   'category' => string,   // e.g., 'software-dev', 'customer-support'
+     *   'limit' => int,         // Number of results (default 50)
+     * ]
+     * @return array<JobData>
+     */
+    public function fetchJobs(array $params = []): array
+    {
+        try {
+            $queryParams = $this->buildQueryParams($params);
+
+            $response = $this->makeRequest('GET', 'remote-jobs', $queryParams);
+
+            $data = $response->json();
+
+            if (!isset($data['jobs']) || !is_array($data['jobs'])) {
+                throw new ApiException(
+                    'Invalid response structure from Remotive API',
+                    $this->source->name,
+                    ['response' => $data]
+                );
+            }
+
+            $this->updateLastFetched();
+
+            return $this->transformer->transformMany($data['jobs']);
+
+        } catch (ApiException $e) {
+            throw $e;
+        } catch (\Throwable $e) {
+            throw new ApiException(
+                'Failed to fetch jobs from Remotive',
+                $this->source->name,
+                ['error' => $e->getMessage()],
+                0,
+                $e
+            );
+        }
+    }
+
+    /**
+     * Build query parameters for the API request
+     */
+    private function buildQueryParams(array $params): array
+    {
+        $queryParams = [];
+
+        if (!empty($params['search'])) {
+            $queryParams['search'] = $params['search'];
+        }
+
+        if (!empty($params['company_name'])) {
+            $queryParams['company_name'] = $params['company_name'];
+        }
+
+        if (!empty($params['category'])) {
+            $queryParams['category'] = $params['category'];
+        }
+
+        if (!empty($params['limit'])) {
+            $queryParams['limit'] = min((int) $params['limit'], 100);
+        }
+
+        return $queryParams;
+    }
+
+    /**
+     * Get available job categories from Remotive
+     */
+    public function getCategories(): array
+    {
+        // Remotive categories (as of API documentation)
+        return [
+            'software-dev',
+            'customer-support',
+            'design',
+            'marketing',
+            'sales',
+            'product',
+            'business',
+            'data',
+            'devops',
+            'finance',
+            'hr',
+            'legal',
+            'operations',
+            'qa',
+            'writing',
+        ];
+    }
+}