feat: add logCounter and logBatchCounter methods for usage metrics

- Introduced logCounter method to log individual usage counter metrics with upsert behavior.
- Added logBatchCounter method to log multiple usage counter metrics in batch, allowing for individual entries without aggregation.
- Updated logBatch method to accept a batch size parameter for better control over batch processing.
- Enhanced Usage class to support new logging methods and batch size functionality.
- Implemented tests for new methods, including scenarios for batch sizes, counter behavior, and metrics with tags.

Author: lohanidamodar

src/Usage/Adapter.php

@@ -25,8 +25,24 @@ abstract public function log(string $metric, int $value, string $period = Usage:
      * Log multiple metrics in batch
      *
      * @param  array<array{metric: string, value: int, period?: string, tags?: array<string,mixed>}>  $metrics
+     * @param  int  $batchSize  Maximum number of metrics per INSERT statement
      */
-    abstract public function logBatch(array $metrics): bool;
+    abstract public function logBatch(array $metrics, int $batchSize = 1000): bool;
+
+    /**
+     * Log usage counter metric (individual entry without aggregation)
+     *
+     * @param  array<string,mixed>  $tags
+     */
+    abstract public function logCounter(string $metric, int $value, string $period = Usage::PERIOD_1H, array $tags = []): bool;
+
+    /**
+     * Log multiple counter metrics in batch (individual entries without aggregation)
+     *
+     * @param  array<array{metric: string, value: int, period?: string, tags?: array<string,mixed>}>  $metrics
+     * @param  int  $batchSize  Maximum number of metrics per INSERT statement
+     */
+    abstract public function logBatchCounter(array $metrics, int $batchSize = 1000): bool;
 
     /**
      * Get usage metrics by period