added params validator

Author: dcblogdev

src/Validators/GraphQueryValidator.php

@@ -0,0 +1,43 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Dcblogdev\MsGraph\Validators;
+
+use InvalidArgumentException;
+
+class GraphQueryValidator
+{
+    /**
+     * Allowed query parameters for Microsoft Graph API requests.
+     */
+    protected static array $allowedParams = [
+        '$top', '$skip', '$filter', '$orderby', '$select', '$expand', '$count', '$search', '$format',
+    ];
+
+    /**
+     * Validate and filter query parameters.
+     *
+     * @param  array  $params  Query parameters to validate.
+     * @return array Valid query parameters.
+     *
+     * @throws InvalidArgumentException If invalid parameters are present.
+     */
+    public static function validate(array $params): array
+    {
+        // Filter out invalid parameters
+        $validParams = array_intersect_key($params, array_flip(self::$allowedParams));
+
+        // Identify invalid parameters
+        $invalidParams = array_diff_key($params, $validParams);
+        if (! empty($invalidParams)) {
+            throw new InvalidArgumentException(sprintf(
+                "Invalid query parameters: %s. Allowed parameters: %s.",
+                implode(', ', array_keys($invalidParams)),
+                implode(', ', self::$allowedParams)
+            ));
+        }
+
+        return $validParams;
+    }
+}

tests/Validators/GraphQueryValidatorTest.php

@@ -0,0 +1,43 @@
+<?php
+
+use Dcblogdev\MsGraph\Validators\GraphQueryValidator;
+
+test('can validate', function () {
+    $response = GraphQueryValidator::validate([
+        '$top' => 10,
+        '$skip' => 5,
+        '$filter' => 'name eq \'test\'',
+        '$orderby' => 'name asc',
+        '$select' => 'name',
+        '$expand' => 'children',
+        '$count' => 'true',
+        '$search' => 'test',
+        '$format' => 'pdf',
+    ]);
+
+    expect($response)->toEqual([
+        '$top' => 10,
+        '$skip' => 5,
+        '$filter' => 'name eq \'test\'',
+        '$orderby' => 'name asc',
+        '$select' => 'name',
+        '$expand' => 'children',
+        '$count' => 'true',
+        '$search' => 'test',
+        '$format' => 'pdf',
+    ]);
+});
+
+test('cannot validate none existing params', function () {
+    $response = GraphQueryValidator::validate([
+        '$tops' => 10,
+        '$skip' => 5,
+        '$filter' => 'name eq \'test\'',
+        '$orderby' => 'name asc',
+        '$select' => 'name',
+        '$expand' => 'children',
+        '$count' => 'true',
+        '$search' => 'test',
+        '$format' => 'pdf',
+    ]);
+})->throws(InvalidArgumentException::class, 'Invalid query parameters: $tops. Allowed parameters: $top, $skip, $filter, $orderby, $select, $expand, $count, $search, $format.');