From 972817620e82fa9f75e81786cb3a3f0d6c186d2d Mon Sep 17 00:00:00 2001
From: Kibana Machine <42973632+kibanamachine@users.noreply.github.com>
Date: Tue, 3 Dec 2024 00:44:13 +1100
Subject: [PATCH] [8.x] [Lens][Embeddable] Expose the &#x60;parentApi&#x60; via
 the embeddable API (#202006) (#202445)

# Backport

This will backport the following commits from `main` to `8.x`:
- [[Lens][Embeddable] Expose the &#x60;parentApi&#x60; via the
embeddable API (#202006)](https://github.com/elastic/kibana/pull/202006)

<!--- Backport version: 9.4.3 -->

### Questions ?
Please refer to the [Backport tool
documentation](https://github.com/sqren/backport)

<!--BACKPORT [{"author":{"name":"Marco
Liberati","email":"dej611@users.noreply.github.com"},"sourceCommit":{"committedDate":"2024-12-02T11:53:34Z","message":"[Lens][Embeddable]
Expose the `parentApi` via the embeddable API (#202006)\n\n##
Summary\r\n\r\nFixes #199736\r\n\r\nThis PR exposes the `parentApi` when
it satisfy the\r\n`PresentationContainer` type: this allows api
consumers (i.e. dashboard\r\nactions) to access the full container
context for complex evaluation of\r\nan action (i.e. are there other
panels? what types are they made of?\r\netc...).\r\n\r\nI've limited it
to `PresentationContainer` as this was the original\r\nintent of the
feature request (and avoids type casting). If it needs to\r\nbe extended
more another follow up can be
done.","sha":"a18be1fb1719b6a1eb77b2da4d4d6b685ea02b37","branchLabelMapping":{"^v9.0.0$":"main","^v8.18.0$":"8.x","^v(\\d+).(\\d+).\\d+$":"$1.$2"}},"sourcePullRequest":{"labels":["Team:Visualizations","release_note:skip","Feature:Lens","v9.0.0","backport:prev-minor"],"title":"[Lens][Embeddable]
Expose the `parentApi` via the embeddable
API","number":202006,"url":"https://github.com/elastic/kibana/pull/202006","mergeCommit":{"message":"[Lens][Embeddable]
Expose the `parentApi` via the embeddable API (#202006)\n\n##
Summary\r\n\r\nFixes #199736\r\n\r\nThis PR exposes the `parentApi` when
it satisfy the\r\n`PresentationContainer` type: this allows api
consumers (i.e. dashboard\r\nactions) to access the full container
context for complex evaluation of\r\nan action (i.e. are there other
panels? what types are they made of?\r\netc...).\r\n\r\nI've limited it
to `PresentationContainer` as this was the original\r\nintent of the
feature request (and avoids type casting). If it needs to\r\nbe extended
more another follow up can be
done.","sha":"a18be1fb1719b6a1eb77b2da4d4d6b685ea02b37"}},"sourceBranch":"main","suggestedTargetBranches":[],"targetPullRequestStates":[{"branch":"main","label":"v9.0.0","branchLabelMappingKey":"^v9.0.0$","isSourceBranch":true,"state":"MERGED","url":"https://github.com/elastic/kibana/pull/202006","number":202006,"mergeCommit":{"message":"[Lens][Embeddable]
Expose the `parentApi` via the embeddable API (#202006)\n\n##
Summary\r\n\r\nFixes #199736\r\n\r\nThis PR exposes the `parentApi` when
it satisfy the\r\n`PresentationContainer` type: this allows api
consumers (i.e. dashboard\r\nactions) to access the full container
context for complex evaluation of\r\nan action (i.e. are there other
panels? what types are they made of?\r\netc...).\r\n\r\nI've limited it
to `PresentationContainer` as this was the original\r\nintent of the
feature request (and avoids type casting). If it needs to\r\nbe extended
more another follow up can be
done.","sha":"a18be1fb1719b6a1eb77b2da4d4d6b685ea02b37"}}]}] BACKPORT-->

Co-authored-by: Marco Liberati <dej611@users.noreply.github.com>
---
 .../initializers/initialize_dashboard_services.ts      | 10 ++++++++--
 x-pack/plugins/lens/public/react_embeddable/types.ts   |  4 ++++
 2 files changed, 12 insertions(+), 2 deletions(-)

diff --git a/x-pack/plugins/lens/public/react_embeddable/initializers/initialize_dashboard_services.ts b/x-pack/plugins/lens/public/react_embeddable/initializers/initialize_dashboard_services.ts
index bf203f5faf32a..67a5d3a89a1c2 100644
--- a/x-pack/plugins/lens/public/react_embeddable/initializers/initialize_dashboard_services.ts
+++ b/x-pack/plugins/lens/public/react_embeddable/initializers/initialize_dashboard_services.ts
@@ -16,7 +16,7 @@ import {
   getUnchangingComparator,
   initializeTitles,
 } from '@kbn/presentation-publishing';
-import { apiPublishesSettings } from '@kbn/presentation-containers';
+import { apiIsPresentationContainer, apiPublishesSettings } from '@kbn/presentation-containers';
 import { buildObservableVariable, isTextBasedLanguage } from '../helper';
 import type {
   LensComponentProps,
@@ -27,6 +27,7 @@ import type {
   LensSharedProps,
   IntegrationCallbacks,
   LensInternalApi,
+  LensApi,
 } from '../types';
 import { apiHasLensComponentProps } from '../type_guards';
 import { StateManagementConfig } from './initialize_state_management';
@@ -39,9 +40,12 @@ export interface DashboardServicesConfig {
     PublishesWritablePanelDescription &
     HasInPlaceLibraryTransforms &
     HasLibraryTransforms<LensRuntimeState> &
+    Pick<LensApi, 'parentApi'> &
     Pick<IntegrationCallbacks, 'updateOverrides' | 'getTriggerCompatibleActions'>;
   serialize: () => SerializedProps;
-  comparators: StateComparators<SerializedProps & { isNewPanel?: boolean }>;
+  comparators: StateComparators<
+    SerializedProps & Pick<LensApi, 'parentApi'> & { isNewPanel?: boolean }
+  >;
   cleanup: () => void;
 }
 
@@ -78,6 +82,7 @@ export function initializeDashboardServices(
 
   return {
     api: {
+      parentApi: apiIsPresentationContainer(parentApi) ? parentApi : undefined,
       defaultPanelTitle: defaultPanelTitle$,
       defaultPanelDescription: defaultPanelDescription$,
       ...titlesApi,
@@ -178,6 +183,7 @@ export function initializeDashboardServices(
       overrides: overridesComparator,
       disableTriggers: disabledTriggersComparator,
       isNewPanel: getUnchangingComparator<{ isNewPanel?: boolean }, 'isNewPanel'>(),
+      parentApi: getUnchangingComparator<Pick<LensApi, 'parentApi'>, 'parentApi'>(),
     },
     cleanup: noop,
   };
diff --git a/x-pack/plugins/lens/public/react_embeddable/types.ts b/x-pack/plugins/lens/public/react_embeddable/types.ts
index 058affe7f8d2f..c860c543570c1 100644
--- a/x-pack/plugins/lens/public/react_embeddable/types.ts
+++ b/x-pack/plugins/lens/public/react_embeddable/types.ts
@@ -17,6 +17,7 @@ import type {
   HasEditCapabilities,
   HasInPlaceLibraryTransforms,
   HasLibraryTransforms,
+  HasParentApi,
   HasSupportedTriggers,
   PublishesBlockingError,
   PublishesDataLoading,
@@ -63,6 +64,7 @@ import type { AllowedGaugeOverrides } from '@kbn/expression-gauge-plugin/common'
 import type { AllowedPartitionOverrides } from '@kbn/expression-partition-vis-plugin/common';
 import type { AllowedXYOverrides } from '@kbn/expression-xy-plugin/common';
 import type { Action } from '@kbn/ui-actions-plugin/public';
+import { PresentationContainer } from '@kbn/presentation-containers';
 import type { LegacyMetricState } from '../../common';
 import type { LensDocument } from '../persistence';
 import type { LensInspector } from '../lens_inspector_service';
@@ -379,6 +381,8 @@ export type LensApi = Simplify<
     HasLibraryTransforms<LensRuntimeState> &
     // Let the container know the view mode
     PublishesViewMode &
+    // forward the parentApi, note that will be exposed only if it satisfy the PresentationContainer interface
+    Partial<HasParentApi<PresentationContainer>> &
     // Let the container know the saved object id
     PublishesSavedObjectId &
     // Lens specific API methods: