Support dynamic mapping behavior

Author: stevebauman

README.md

@@ -42,6 +42,7 @@ use DirectoryTree\OpenSearchAdapter\Indices\Mapping;
 use DirectoryTree\OpenSearchAdapter\Indices\Settings;
 
 $mapping = (new Mapping)
+    ->dynamic('strict')
     ->keyword('id')
     ->text('title')
     ->object('author', [

src/Indices/Mapping.php

@@ -10,6 +10,11 @@
  */
 class Mapping
 {
+    /**
+     * The dynamic field mapping behavior.
+     */
+    protected bool|string|null $dynamic = null;
+
     /**
      * The mapping property definitions.
      */
@@ -712,6 +717,18 @@ public function disableSource(): self
         return $this;
     }
 
+    /**
+     * Set the dynamic field mapping behavior.
+     *
+     * @see https://docs.opensearch.org/latest/mappings/mapping-parameters/dynamic/
+     */
+    public function dynamic(bool|string $dynamic): self
+    {
+        $this->dynamic = $dynamic;
+
+        return $this;
+    }
+
     /**
      * Add a dynamic template definition.
      *
@@ -737,6 +754,10 @@ public function toArray(): array
 
         $properties = $this->properties->toArray();
 
+        if (isset($this->dynamic)) {
+            $mapping['dynamic'] = $this->dynamic;
+        }
+
         if (isset($this->isFieldNamesEnabled)) {
             $mapping['_field_names'] = [
                 'enabled' => $this->isFieldNamesEnabled,

tests/Unit/Indices/MappingTest.php

@@ -44,6 +44,19 @@
     ], $mapping->toArray());
 });
 
+it('sets dynamic field mapping behavior', function (bool|string $dynamic) {
+    $mapping = (new Mapping)->dynamic($dynamic);
+
+    expect($mapping->toArray())->toBe([
+        'dynamic' => $dynamic,
+    ]);
+})->with([
+    true,
+    false,
+    'strict',
+    'strict_allow_templates',
+]);
+
 it('casts default values to an empty array', function () {
     $this->assertSame([], (new Mapping)->toArray());
 });