feat: added criterion and criteria

Signed-off-by: Julien Guittard <julien.guittard@me.com>

Author: jguittard

src/Operation/Query/Criteria.php

@@ -0,0 +1,46 @@
+<?php
+
+/**
+ * This file is part of phayne-io/php-dynamodb and is proprietary and confidential.
+ * Unauthorized copying of this file, via any medium is strictly prohibited.
+ *
+ * @see       https://github.com/phayne-io/php-dynamodb for the canonical source repository
+ * @copyright Copyright (c) 2024-2025 Phayne Limited. (https://phayne.io)
+ */
+
+declare(strict_types=1);
+
+namespace Phayne\DynamoDB\Operation\Query;
+
+/**
+ * Class Criteria
+ *
+ * @package Phayne\DynamoDB\Operation\Query
+ */
+final readonly class Criteria
+{
+    private array $criteria;
+
+    public function __construct(Criterion ...$criteria)
+    {
+        $this->criteria = $criteria;
+    }
+
+    public static function from(Criterion ...$criteria): Criteria
+    {
+        return new self(...$criteria);
+    }
+
+    public function toArray(): array
+    {
+        $criteria = [];
+        foreach ($this->criteria as $criterion) {
+            $criteria[$criterion->field] = [
+                'operator' => $criterion->operator->value,
+                'value' => $criterion->value,
+            ];
+        }
+
+        return $criteria;
+    }
+}

src/Operation/Query/Criterion.php

@@ -0,0 +1,42 @@
+<?php
+
+/**
+ * This file is part of phayne-io/php-dynamodb and is proprietary and confidential.
+ * Unauthorized copying of this file, via any medium is strictly prohibited.
+ *
+ * @see       https://github.com/phayne-io/php-dynamodb for the canonical source repository
+ * @copyright Copyright (c) 2024-2025 Phayne Limited. (https://phayne.io)
+ */
+
+declare(strict_types=1);
+
+namespace Phayne\DynamoDB\Operation\Query;
+
+use Phayne\DynamoDB\Enum\Operator;
+
+/**
+ * Class Criterion
+ *
+ * @package Phayne\DynamoDB\Operation\Query
+ */
+final readonly class Criterion
+{
+    private function __construct(
+        public Operator $operator,
+        public string $field,
+        public mixed $value,
+    ) {
+    }
+
+    public static function from(Operator $operator, string $field, mixed $value): Criterion
+    {
+        return new self($operator, $field, $value);
+    }
+
+    public function toArray(bool $fieldAsKey = false): array
+    {
+        return $fieldAsKey
+            ? [$this->field => ['operator' => $this->operator->value, 'value' => $this->value]]
+            : ['operator' => $this->operator->value, 'name' => $this->field, 'value' => $this->value];
+    }
+}