add dynamic property to type definition (#58852) (#58886)

docs/development/core/server/kibana-plugin-server.savedobjectstypemappingdefinition.dynamic.md

@@ -0,0 +1,13 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [kibana-plugin-server](./kibana-plugin-server.md) &gt; [SavedObjectsTypeMappingDefinition](./kibana-plugin-server.savedobjectstypemappingdefinition.md) &gt; [dynamic](./kibana-plugin-server.savedobjectstypemappingdefinition.dynamic.md)
+
+## SavedObjectsTypeMappingDefinition.dynamic property
+
+The dynamic property of the mapping. either `false` or 'strict'. Defaults to strict
+
+<b>Signature:</b>
+
+```typescript
+dynamic?: false | 'strict';
+```

docs/development/core/server/kibana-plugin-server.savedobjectstypemappingdefinition.md

@@ -41,5 +41,6 @@ const typeDefinition: SavedObjectsTypeMappingDefinition = {
 
 |  Property | Type | Description |
 |  --- | --- | --- |
-|  [properties](./kibana-plugin-server.savedobjectstypemappingdefinition.properties.md) | <code>SavedObjectsMappingProperties</code> |  |
+|  [dynamic](./kibana-plugin-server.savedobjectstypemappingdefinition.dynamic.md) | <code>false &#124; 'strict'</code> | The dynamic property of the mapping. either <code>false</code> or 'strict'. Defaults to strict |
+|  [properties](./kibana-plugin-server.savedobjectstypemappingdefinition.properties.md) | <code>SavedObjectsMappingProperties</code> | The underlying properties of the type mapping |
 

docs/development/core/server/kibana-plugin-server.savedobjectstypemappingdefinition.properties.md

@@ -4,6 +4,8 @@
 
 ## SavedObjectsTypeMappingDefinition.properties property
 
+The underlying properties of the type mapping
+
 <b>Signature:</b>
 
 ```typescript

src/core/server/saved_objects/mappings/types.ts

@@ -45,6 +45,9 @@
  * @public
  */
 export interface SavedObjectsTypeMappingDefinition {
+  /** The dynamic property of the mapping. either `false` or 'strict'. Defaults to strict */
+  dynamic?: false | 'strict';
+  /** The underlying properties of the type mapping */
   properties: SavedObjectsMappingProperties;
 }
 

src/core/server/saved_objects/migrations/core/build_active_mappings.test.ts

@@ -17,7 +17,7 @@
  * under the License.
  */
 
-import { IndexMapping } from './../../mappings';
+import { IndexMapping, SavedObjectsTypeMappingDefinitions } from './../../mappings';
 import { buildActiveMappings, diffMappings } from './build_active_mappings';
 
 describe('buildActiveMappings', () => {
@@ -49,6 +49,23 @@ describe('buildActiveMappings', () => {
     );
   });
 
+  test('handles the `dynamic` property of types', () => {
+    const typeMappings: SavedObjectsTypeMappingDefinitions = {
+      firstType: {
+        dynamic: 'strict',
+        properties: { field: { type: 'keyword' } },
+      },
+      secondType: {
+        dynamic: false,
+        properties: { field: { type: 'long' } },
+      },
+      thirdType: {
+        properties: { field: { type: 'text' } },
+      },
+    };
+    expect(buildActiveMappings(typeMappings)).toMatchSnapshot();
+  });
+
   test('generated hashes are stable', () => {
     const properties = {
       aaa: { type: 'keyword', fields: { a: { type: 'keyword' }, b: { type: 'text' } } },

src/core/server/server.api.md

@@ -2058,7 +2058,7 @@ export interface SavedObjectsType {
 
 // @public
 export interface SavedObjectsTypeMappingDefinition {
-    // (undocumented)
+    dynamic?: false | 'strict';
     properties: SavedObjectsMappingProperties;
 }