[dashboards as code] move map embeddable reference handling to server (#234806)

PR moves map embeddable reference handling to the server.

dashboard CRUD APIs no longer contain references from map panels. In the
screen shot below, notice how `indexPatternId` contain saved object ids
and are not references. Notice how the reference array for the dashboard
is empty.
<img width="2041" height="1014" alt="Screenshot 2025-09-11 at 6 59
55 PM"
src="https://github.com/user-attachments/assets/44a7c26c-b189-4c04-9f19-2159068ecc74"
/>

References are extracted on server and stored in dashboard saved object.
In the screen shot below, notice how `indexPatternId` has been replaced
with `indexPatternRefName` and points to a reference that contains the
saved objec tid.
<img width="2046" height="999" alt="Screenshot 2025-09-11 at 7 01 41 PM"
src="https://github.com/user-attachments/assets/ecbe6c80-21fb-4a88-8233-5555153d9430"
/>

---------

Co-authored-by: Elastic Machine <[email protected]>

Author: nreese

x-pack/platform/plugins/private/canvas/canvas_plugin_src/renderers/embeddable/input_type_to_expression/map.ts

@@ -5,14 +5,14 @@
  * 2.0.
  */
 
-import type { MapSerializedState } from '@kbn/maps-plugin/public';
+import type { MapByReferenceState, MapEmbeddableState } from '@kbn/maps-plugin/common';
 
-export function toExpression(input: MapSerializedState & { id: string }): string {
+export function toExpression(input: MapEmbeddableState & { id: string }): string {
   const expressionParts = [] as string[];
 
   expressionParts.push('savedMap');
 
-  expressionParts.push(`id="${input.savedObjectId}"`);
+  expressionParts.push(`id="${(input as MapByReferenceState).savedObjectId}"`);
 
   if (input.title !== undefined) {
     expressionParts.push(`title="${input.title}"`);

x-pack/platform/plugins/shared/maps/common/embeddable/transforms/get_transform_in.ts

@@ -0,0 +1,64 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+
+import type { EnhancementsRegistry } from '@kbn/embeddable-plugin/common/enhancements/registry';
+import type { Reference } from '@kbn/content-management-utils';
+import type { MapByReferenceState, MapByValueState, MapEmbeddableState } from '../types';
+import type { StoredMapEmbeddableState } from './types';
+import { MAP_SAVED_OBJECT_TYPE } from '../../constants';
+import { extractReferences } from '../../migrations/references';
+
+export const MAP_SAVED_OBJECT_REF_NAME = 'savedObjectRef';
+
+export function getTransformIn(transformEnhancementsIn: EnhancementsRegistry['transformIn']) {
+  function transformIn(state: MapEmbeddableState): {
+    state: StoredMapEmbeddableState;
+    references: Reference[];
+  } {
+    const { enhancementsState, enhancementsReferences } = state.enhancements
+      ? transformEnhancementsIn(state.enhancements)
+      : { enhancementsState: undefined, enhancementsReferences: [] };
+
+    // by ref
+    if ((state as MapByReferenceState).savedObjectId) {
+      const { savedObjectId, ...rest } = state as MapByReferenceState;
+      return {
+        state: {
+          ...rest,
+          ...(enhancementsState ? { enhancements: enhancementsState } : {}),
+        } as StoredMapEmbeddableState,
+        references: [
+          {
+            name: MAP_SAVED_OBJECT_REF_NAME,
+            type: MAP_SAVED_OBJECT_TYPE,
+            id: savedObjectId!,
+          },
+          ...enhancementsReferences,
+        ],
+      };
+    }
+
+    // by value
+    if ((state as MapByValueState).attributes) {
+      const { attributes, references } = extractReferences({
+        attributes: (state as MapByValueState).attributes,
+      });
+
+      return {
+        state: {
+          ...state,
+          ...(enhancementsState ? { enhancements: enhancementsState } : {}),
+          attributes,
+        } as MapByValueState,
+        references: [...references, ...enhancementsReferences],
+      };
+    }
+
+    throw new Error('Unable to extract references from Map state, unexpected state');
+  }
+  return transformIn;
+}

x-pack/platform/plugins/shared/maps/common/embeddable/transforms/get_transform_out.ts

@@ -0,0 +1,49 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+
+import type { Reference } from '@kbn/content-management-utils/src/types';
+import type { EnhancementsRegistry } from '@kbn/embeddable-plugin/common/enhancements/registry';
+import type { StoredMapEmbeddableState } from './types';
+import { MAP_SAVED_OBJECT_REF_NAME } from './get_transform_in';
+import type { MapByValueState } from '../types';
+import { injectReferences } from '../../migrations/references';
+import { MAP_SAVED_OBJECT_TYPE } from '../../constants';
+
+export function getTransformOut(transformEnhancementsOut: EnhancementsRegistry['transformOut']) {
+  function transformOut(state: StoredMapEmbeddableState, references?: Reference[]) {
+    const enhancementsState = state.enhancements
+      ? transformEnhancementsOut(state.enhancements, references ?? [])
+      : undefined;
+
+    // by ref
+    const savedObjectRef = (references ?? []).find(
+      (ref) => MAP_SAVED_OBJECT_TYPE === ref.type && ref.name === MAP_SAVED_OBJECT_REF_NAME
+    );
+    if (savedObjectRef) {
+      return {
+        ...state,
+        ...(enhancementsState ? { enhancements: enhancementsState } : {}),
+        savedObjectId: savedObjectRef.id,
+      };
+    }
+
+    // by value
+    if ((state as MapByValueState).attributes) {
+      return {
+        ...state,
+        ...(enhancementsState ? { enhancements: enhancementsState } : {}),
+        attributes: injectReferences({
+          attributes: (state as MapByValueState).attributes,
+          references: references ?? [],
+        }).attributes,
+      };
+    }
+
+    throw new Error('Unable to inject references from Map state, unexpected state');
+  }
+  return transformOut;
+}

x-pack/platform/plugins/shared/maps/common/embeddable/transforms/get_transforms.ts

@@ -0,0 +1,20 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+
+import type { EnhancementsRegistry } from '@kbn/embeddable-plugin/common/enhancements/registry';
+import { getTransformIn } from './get_transform_in';
+import { getTransformOut } from './get_transform_out';
+
+export function getTransforms(
+  transformEnhancementsIn: EnhancementsRegistry['transformIn'],
+  transformEnhancementsOut: EnhancementsRegistry['transformOut']
+) {
+  return {
+    transformIn: getTransformIn(transformEnhancementsIn),
+    transformOut: getTransformOut(transformEnhancementsOut),
+  };
+}

x-pack/platform/plugins/shared/maps/common/embeddable/index.ts renamed to x-pack/platform/plugins/shared/maps/common/embeddable/transforms/types.ts

@@ -5,6 +5,8 @@
  * 2.0.
  */
 
-export type { MapEmbeddablePersistableState } from './types';
-export { extract } from './extract';
-export { inject } from './inject';
+import type { MapByReferenceState, MapByValueState } from '../types';
+
+export type StoredMapByReferenceState = Omit<MapByReferenceState, 'savedObjectId'>;
+
+export type StoredMapEmbeddableState = StoredMapByReferenceState | MapByValueState;

x-pack/platform/plugins/shared/maps/common/embeddable/types.ts

@@ -5,9 +5,30 @@
  * 2.0.
  */
 
-import type { SerializableRecord } from '@kbn/utility-types';
-import type { EmbeddableStateWithType } from '@kbn/embeddable-plugin/common';
+import type { DynamicActionsSerializedState } from '@kbn/embeddable-enhanced-plugin/public';
+import type { SerializedTimeRange, SerializedTitles } from '@kbn/presentation-publishing';
+import type { MapCenterAndZoom, MapExtent, MapSettings } from '../descriptor_types';
+import type { MapAttributes } from '../content_management';
 
-export type MapEmbeddablePersistableState = EmbeddableStateWithType & {
-  attributes: SerializableRecord;
+export type MapEmbeddableBaseState = SerializedTimeRange &
+  SerializedTitles &
+  Partial<DynamicActionsSerializedState> & {
+    isLayerTOCOpen?: boolean;
+    openTOCDetails?: string[];
+    mapCenter?: MapCenterAndZoom;
+    mapBuffer?: MapExtent;
+    mapSettings?: Partial<MapSettings>;
+    hiddenLayers?: string[];
+    filterByMapExtent?: boolean;
+    isMovementSynchronized?: boolean;
+  };
+
+export type MapByReferenceState = MapEmbeddableBaseState & {
+  savedObjectId: string;
+};
+
+export type MapByValueState = MapEmbeddableBaseState & {
+  attributes: MapAttributes;
 };
+
+export type MapEmbeddableState = MapByReferenceState | MapByValueState;

x-pack/platform/plugins/shared/maps/common/index.ts

@@ -42,3 +42,5 @@ export type {
   VectorStyleDescriptor,
   VectorSourceRequestMeta,
 } from './descriptor_types';
+
+export type { MapEmbeddableState, MapByReferenceState, MapByValueState } from './embeddable/types';

x-pack/platform/plugins/shared/maps/public/index.ts

@@ -29,7 +29,7 @@ export type {
 export type { MapsSetupApi, MapsStartApi } from './api';
 export type { CreateLayerDescriptorParams } from './classes/sources/es_search_source/create_layer_descriptor';
 
-export { type MapApi, type MapSerializedState, isMapApi } from './react_embeddable/types';
+export { type MapApi, isMapApi } from './react_embeddable/types';
 
 export type { EMSTermJoinConfig, SampleValuesConfig } from './ems_autosuggest';
 

x-pack/platform/plugins/shared/maps/public/lens/passive_map.tsx

@@ -10,9 +10,10 @@ import useMountedState from 'react-use/lib/useMountedState';
 import type { Subscription } from 'rxjs';
 import { EmbeddableRenderer } from '@kbn/embeddable-plugin/public';
 import type { LayerDescriptor } from '../../common/descriptor_types';
+import type { MapEmbeddableState } from '../../common';
 import { INITIAL_LOCATION, MAP_SAVED_OBJECT_TYPE } from '../../common';
 import { createBasemapLayerDescriptor } from '../classes/layers/create_basemap_layer_descriptor';
-import type { MapApi, MapSerializedState } from '../react_embeddable/types';
+import type { MapApi } from '../react_embeddable/types';
 
 export interface Props {
   passiveLayer: LayerDescriptor;
@@ -50,7 +51,7 @@ export function PassiveMap(props: Props) {
 
   return (
     <div className="mapEmbeddableContainer">
-      <EmbeddableRenderer<MapSerializedState, MapApi>
+      <EmbeddableRenderer<MapEmbeddableState, MapApi>
         type={MAP_SAVED_OBJECT_TYPE}
         getParentApi={() => ({
           hideFilterActions: true,

x-pack/platform/plugins/shared/maps/public/react_embeddable/embeddable_module.ts

@@ -8,3 +8,4 @@
 export { MapRenderer } from './map_renderer/map_renderer';
 export { PassiveMap } from '../lens/passive_map';
 export { mapEmbeddableFactory } from './map_react_embeddable';
+export { getTransforms } from '../../common/embeddable/transforms/get_transforms';