feat(analytics): add analytics v2 classes

Author: tharropoulos

src/AnalyticsEventsV2.php

@@ -0,0 +1,45 @@
+<?php
+
+namespace Typesense;
+
+/**
+ * Class AnalyticsEventsV2
+ * 
+ * Implements the updated analytics events API for Typesense v2+
+ *
+ * @package \Typesense
+ */
+class AnalyticsEventsV2
+{
+    const RESOURCE_PATH = '/analytics/events';
+
+    private ApiCall $apiCall;
+
+    public function __construct(ApiCall $apiCall)
+    {
+        $this->apiCall = $apiCall;
+    }
+
+    /**
+     * Create an analytics event
+     * 
+     * @param array $params Event parameters including name, event_type, and data
+     * @return array Response from the API
+     * @throws TypesenseClientError|HttpClientException
+     */
+    public function create(array $params)
+    {
+        return $this->apiCall->post(self::RESOURCE_PATH, $params);
+    }
+
+    /**
+     * Retrieve analytics events
+     * 
+     * @param array $params Query parameters
+     * @return array Response from the API
+     */
+    public function retrieve(array $params = [])
+    {
+        return $this->apiCall->get(self::RESOURCE_PATH, $params);
+    }
+} 

src/AnalyticsRuleV2.php

@@ -0,0 +1,51 @@
+<?php
+
+namespace Typesense;
+
+class AnalyticsRuleV2
+{
+    private string $ruleName;
+    private ApiCall $apiCall;
+
+    public function __construct(string $ruleName, ApiCall $apiCall)
+    {
+        $this->ruleName = $ruleName;
+        $this->apiCall = $apiCall;
+    }
+
+    /**
+     * Retrieve a specific analytics rule
+     * 
+     * @return array Response from the API
+     */
+    public function retrieve()
+    {
+        return $this->apiCall->get($this->endpointPath(), []);
+    }
+
+    /**
+     * Delete a specific analytics rule
+     * 
+     * @return array Response from the API
+     */
+    public function delete()
+    {
+        return $this->apiCall->delete($this->endpointPath());
+    }
+
+    /**
+     * Update a specific analytics rule
+     * 
+     * @param array $params Rule parameters
+     * @return array Response from the API
+     */
+    public function update(array $params)
+    {
+        return $this->apiCall->put($this->endpointPath(), $params);
+    }
+
+    private function endpointPath()
+    {
+        return AnalyticsRulesV2::RESOURCE_PATH . '/' . encodeURIComponent($this->ruleName);
+    }
+} 

src/AnalyticsRulesV2.php

@@ -0,0 +1,70 @@
+<?php
+
+namespace Typesense;
+
+class AnalyticsRulesV2 implements \ArrayAccess
+{
+    const RESOURCE_PATH = '/analytics/rules';
+
+    private ApiCall $apiCall;
+
+    public function __construct(ApiCall $apiCall)
+    {
+        $this->apiCall = $apiCall;
+    }
+
+    /**
+     * Create multiple analytics rules
+     * 
+     * @param array $rules Array of rule objects
+     * @return array Response from the API
+     */
+    public function create(array $rules)
+    {
+        return $this->apiCall->post(self::RESOURCE_PATH, $rules);
+    }
+
+    /**
+     * Retrieve all analytics rules
+     * 
+     * @return array Response from the API
+     */
+    public function retrieve()
+    {
+        return $this->apiCall->get(self::RESOURCE_PATH, []);
+    }
+
+    /**
+     * Get a specific rule by name
+     * 
+     * @param string $ruleName
+     * @return AnalyticsRuleV2
+     */
+    public function __get($ruleName)
+    {
+        return new AnalyticsRuleV2($ruleName, $this->apiCall);
+    }
+
+    /**
+     * ArrayAccess implementation for backwards compatibility
+     */
+    public function offsetExists($offset): bool
+    {
+        return true; // Rules can be accessed by name
+    }
+
+    public function offsetGet($offset): AnalyticsRuleV2
+    {
+        return new AnalyticsRuleV2($offset, $this->apiCall);
+    }
+
+    public function offsetSet($offset, $value): void
+    {
+        // Not implemented for read-only access
+    }
+
+    public function offsetUnset($offset): void
+    {
+        // Not implemented for read-only access
+    }
+} 

src/AnalyticsV2.php

@@ -0,0 +1,35 @@
+<?php
+
+namespace Typesense;
+
+class AnalyticsV2
+{
+    const RESOURCE_PATH = '/analytics';
+
+    private ApiCall $apiCall;
+
+    private AnalyticsRulesV2 $rules;
+
+    private AnalyticsEventsV2 $events;
+
+    public function __construct(ApiCall $apiCall)
+    {
+        $this->apiCall = $apiCall;
+    }
+
+    public function rules()
+    {
+        if (!isset($this->rules)) {
+            $this->rules = new AnalyticsRulesV2($this->apiCall);
+        }
+        return $this->rules;
+    }
+
+    public function events()
+    {
+        if (!isset($this->events)) {
+            $this->events = new AnalyticsEventsV2($this->apiCall);
+        }
+        return $this->events;
+    }
+}