@decaf-ts/integrations 0.3.12 → 0.4.1-0

package/lib/types/plugins/superset/host.d.cts

@@ -0,0 +1,20 @@
+/**
+ * @module integrations/plugins/superset/host
+ * @summary Angular host-side helpers for the Superset embed plugin.
+ * @description DOM-free convenience helpers the Angular host uses to build the
+ * embedded URL and send switch-dashboard messages to the embedded Superset
+ * plugin via the SDK handle.
+ */
+import { type EmbedMessageTarget, type EmbedUrlOptions, type SwitchDashboardPayload } from "../contract.d.cts";
+import { buildSupersetEmbedUrl } from "./installer.d.cts";
+export { buildSupersetEmbedUrl };
+/**
+ * Send a switch-dashboard message to the embedded Superset dashboard.
+ *
+ * The Angular host passes the embedded SDK's `EmbeddedDashboard` handle
+ * (wrapped to satisfy `EmbedMessageTarget.switchDashboard`) and the Superset
+ * origin as `targetOrigin`.
+ */
+export declare function sendSupersetSwitchDashboardMessage(target: EmbedMessageTarget, payload: SwitchDashboardPayload, targetOrigin: string): void;
+/** Re-export the URL options type for host convenience. */
+export type { EmbedUrlOptions };

package/lib/types/plugins/superset/host.d.mts

@@ -0,0 +1,20 @@
+/**
+ * @module integrations/plugins/superset/host
+ * @summary Angular host-side helpers for the Superset embed plugin.
+ * @description DOM-free convenience helpers the Angular host uses to build the
+ * embedded URL and send switch-dashboard messages to the embedded Superset
+ * plugin via the SDK handle.
+ */
+import { type EmbedMessageTarget, type EmbedUrlOptions, type SwitchDashboardPayload } from "../contract.d.mts";
+import { buildSupersetEmbedUrl } from "./installer.d.mts";
+export { buildSupersetEmbedUrl };
+/**
+ * Send a switch-dashboard message to the embedded Superset dashboard.
+ *
+ * The Angular host passes the embedded SDK's `EmbeddedDashboard` handle
+ * (wrapped to satisfy `EmbedMessageTarget.switchDashboard`) and the Superset
+ * origin as `targetOrigin`.
+ */
+export declare function sendSupersetSwitchDashboardMessage(target: EmbedMessageTarget, payload: SwitchDashboardPayload, targetOrigin: string): void;
+/** Re-export the URL options type for host convenience. */
+export type { EmbedUrlOptions };

package/lib/types/plugins/superset/index.d.cts

@@ -0,0 +1,15 @@
+/**
+ * @module integrations/plugins/superset
+ * @summary Superset dashboard embed plugin surface.
+ * @description Org-agnostic multi-tenant Superset dashboard embed plugin
+ * (patch-and-build strategy). Same API as the Kibana plugin. Decaf holds
+ * patch scripts that modify Superset's internal embedded frontend and SDK
+ * source files to add a `switchDashboard` method, keeping the iframe element,
+ * document, contentWindow, React runtime, and Switchboard MessageChannel alive.
+ */
+export * from "../contract.d.cts";
+export * from "./types.d.cts";
+export * from "./manifest.d.cts";
+export * from "./templates.d.cts";
+export { SupersetDashboardEmbedPlugin, supersetDashboardEmbedPlugin, createSupersetDashboardEmbedPlugin, buildSupersetEmbedUrl, SUPERSET_DEFAULT_BASE_PATH, type SupersetInstallOptions, } from "./installer.d.cts";
+export { sendSupersetSwitchDashboardMessage, } from "./host.d.cts";

package/lib/types/plugins/superset/index.d.mts

@@ -0,0 +1,15 @@
+/**
+ * @module integrations/plugins/superset
+ * @summary Superset dashboard embed plugin surface.
+ * @description Org-agnostic multi-tenant Superset dashboard embed plugin
+ * (patch-and-build strategy). Same API as the Kibana plugin. Decaf holds
+ * patch scripts that modify Superset's internal embedded frontend and SDK
+ * source files to add a `switchDashboard` method, keeping the iframe element,
+ * document, contentWindow, React runtime, and Switchboard MessageChannel alive.
+ */
+export * from "../contract.d.mts";
+export * from "./types.d.mts";
+export * from "./manifest.d.mts";
+export * from "./templates.d.mts";
+export { SupersetDashboardEmbedPlugin, supersetDashboardEmbedPlugin, createSupersetDashboardEmbedPlugin, buildSupersetEmbedUrl, SUPERSET_DEFAULT_BASE_PATH, type SupersetInstallOptions, } from "./installer.d.mts";
+export { sendSupersetSwitchDashboardMessage, } from "./host.d.mts";

package/lib/types/plugins/superset/installer.d.cts

@@ -0,0 +1,70 @@
+import { type DashboardEmbedPlugin, type DashboardEmbedPluginDescriptor, type EmbedMessageTarget, type EmbedUrlOptions, type PluginInstallOptions, type PluginInstallResult, type SwitchDashboardPayload, type SwitchDashboardMessage } from "../contract.d.cts";
+/** Default Superset base path when none is provided. */
+export declare const SUPERSET_DEFAULT_BASE_PATH = "superset";
+/**
+ * Extension of `PluginInstallOptions` for Superset-specific build configuration.
+ */
+export interface SupersetInstallOptions extends PluginInstallOptions {
+    /** Path to an existing Superset source checkout. If absent, the installer clones via git. */
+    supersetSourcePath?: string;
+    /** Git URL to clone Superset from (used when `supersetSourcePath` is absent). */
+    supersetGitUrl?: string;
+    /** Git ref/branch/tag to checkout after cloning. */
+    supersetGitRef?: string;
+    /** Docker image tag to build (when provided, builds a Docker image instead of just SDK+frontend). */
+    dockerImageTag?: string;
+}
+/**
+ * Build the Superset embedded URL.
+ *
+ * For Superset, the `dashboardId` field in `EmbedUrlOptions` is the
+ * embedded-configuration UUID used in `/embedded/:uuid`.
+ *
+ * @example
+ *   buildSupersetEmbedUrl({ host: "superset.example.com", dashboardId: "abc-uuid", parentOrigin: "https://app.example.com" })
+ *   // => "//superset.example.com/superset/embedded/abc-uuid?parentOrigin=https%3A%2F%2Fapp.example.com"
+ */
+export declare function buildSupersetEmbedUrl(options: EmbedUrlOptions): string;
+/**
+ * @class SupersetDashboardEmbedPlugin
+ * @summary Superset implementation of the `DashboardEmbedPlugin` contract.
+ * @description Org-agnostic multi-tenant dashboard embed plugin for Superset
+ * using a patch-and-build strategy. Same API as `KibanaDashboardEmbedPlugin`.
+ */
+export declare class SupersetDashboardEmbedPlugin implements DashboardEmbedPlugin {
+    readonly descriptor: DashboardEmbedPluginDescriptor;
+    constructor(targetVersion?: string);
+    manifest(targetVersion?: string): Record<string, unknown>;
+    buildEmbedUrl(options: EmbedUrlOptions): string;
+    createSwitchDashboardMessage(payload: SwitchDashboardPayload): SwitchDashboardMessage;
+    sendSwitchDashboardMessage(target: EmbedMessageTarget, payload: SwitchDashboardPayload, targetOrigin: string): void;
+    /**
+     * Materialize the patch and build scripts into `targetPath/`, and when
+     * `build` is true, clone/use Superset source, apply patches, and build
+     * (SDK + frontend + optionally Docker image).
+     *
+     * Unlike Kibana (which generates plugin source), Superset's "plugin" is a
+     * patch-and-build strategy: Decaf holds scripts that modify Superset's
+     * existing internal source files.
+     */
+    install(options: SupersetInstallOptions): Promise<PluginInstallResult>;
+    /**
+     * Resolve the Superset source root: use an existing checkout or clone via git.
+     */
+    protected resolveSupersetRoot(pluginDir: string, options: SupersetInstallOptions): Promise<string>;
+    /**
+     * Apply patches, verify, and build (SDK + frontend + optionally Docker).
+     */
+    protected runPatchAndBuild(pluginDir: string, supersetRoot: string, options: SupersetInstallOptions): Promise<{
+        ok: boolean;
+        output: string;
+    }>;
+    /**
+     * Run a command and capture stdout+stderr.
+     */
+    protected runCommand(cmd: string, args: string[], cwd: string): Promise<string>;
+}
+/** Default singleton instance. */
+export declare const supersetDashboardEmbedPlugin: SupersetDashboardEmbedPlugin;
+/** Factory accepting a target Superset version. */
+export declare function createSupersetDashboardEmbedPlugin(targetVersion: string): SupersetDashboardEmbedPlugin;

package/lib/types/plugins/superset/installer.d.mts

@@ -0,0 +1,70 @@
+import { type DashboardEmbedPlugin, type DashboardEmbedPluginDescriptor, type EmbedMessageTarget, type EmbedUrlOptions, type PluginInstallOptions, type PluginInstallResult, type SwitchDashboardPayload, type SwitchDashboardMessage } from "../contract.d.mts";
+/** Default Superset base path when none is provided. */
+export declare const SUPERSET_DEFAULT_BASE_PATH = "superset";
+/**
+ * Extension of `PluginInstallOptions` for Superset-specific build configuration.
+ */
+export interface SupersetInstallOptions extends PluginInstallOptions {
+    /** Path to an existing Superset source checkout. If absent, the installer clones via git. */
+    supersetSourcePath?: string;
+    /** Git URL to clone Superset from (used when `supersetSourcePath` is absent). */
+    supersetGitUrl?: string;
+    /** Git ref/branch/tag to checkout after cloning. */
+    supersetGitRef?: string;
+    /** Docker image tag to build (when provided, builds a Docker image instead of just SDK+frontend). */
+    dockerImageTag?: string;
+}
+/**
+ * Build the Superset embedded URL.
+ *
+ * For Superset, the `dashboardId` field in `EmbedUrlOptions` is the
+ * embedded-configuration UUID used in `/embedded/:uuid`.
+ *
+ * @example
+ *   buildSupersetEmbedUrl({ host: "superset.example.com", dashboardId: "abc-uuid", parentOrigin: "https://app.example.com" })
+ *   // => "//superset.example.com/superset/embedded/abc-uuid?parentOrigin=https%3A%2F%2Fapp.example.com"
+ */
+export declare function buildSupersetEmbedUrl(options: EmbedUrlOptions): string;
+/**
+ * @class SupersetDashboardEmbedPlugin
+ * @summary Superset implementation of the `DashboardEmbedPlugin` contract.
+ * @description Org-agnostic multi-tenant dashboard embed plugin for Superset
+ * using a patch-and-build strategy. Same API as `KibanaDashboardEmbedPlugin`.
+ */
+export declare class SupersetDashboardEmbedPlugin implements DashboardEmbedPlugin {
+    readonly descriptor: DashboardEmbedPluginDescriptor;
+    constructor(targetVersion?: string);
+    manifest(targetVersion?: string): Record<string, unknown>;
+    buildEmbedUrl(options: EmbedUrlOptions): string;
+    createSwitchDashboardMessage(payload: SwitchDashboardPayload): SwitchDashboardMessage;
+    sendSwitchDashboardMessage(target: EmbedMessageTarget, payload: SwitchDashboardPayload, targetOrigin: string): void;
+    /**
+     * Materialize the patch and build scripts into `targetPath/`, and when
+     * `build` is true, clone/use Superset source, apply patches, and build
+     * (SDK + frontend + optionally Docker image).
+     *
+     * Unlike Kibana (which generates plugin source), Superset's "plugin" is a
+     * patch-and-build strategy: Decaf holds scripts that modify Superset's
+     * existing internal source files.
+     */
+    install(options: SupersetInstallOptions): Promise<PluginInstallResult>;
+    /**
+     * Resolve the Superset source root: use an existing checkout or clone via git.
+     */
+    protected resolveSupersetRoot(pluginDir: string, options: SupersetInstallOptions): Promise<string>;
+    /**
+     * Apply patches, verify, and build (SDK + frontend + optionally Docker).
+     */
+    protected runPatchAndBuild(pluginDir: string, supersetRoot: string, options: SupersetInstallOptions): Promise<{
+        ok: boolean;
+        output: string;
+    }>;
+    /**
+     * Run a command and capture stdout+stderr.
+     */
+    protected runCommand(cmd: string, args: string[], cwd: string): Promise<string>;
+}
+/** Default singleton instance. */
+export declare const supersetDashboardEmbedPlugin: SupersetDashboardEmbedPlugin;
+/** Factory accepting a target Superset version. */
+export declare function createSupersetDashboardEmbedPlugin(targetVersion: string): SupersetDashboardEmbedPlugin;

package/lib/types/plugins/superset/manifest.d.cts

@@ -0,0 +1,28 @@
+/**
+ * @module integrations/plugins/superset/manifest
+ * @summary Superset embed plugin manifest builder (stub).
+ * @description Superset has no Kibana-style native plugin system. This builder
+ * returns a placeholder manifest describing the embed strategy. Detailed
+ * Superset support is deferred ("to be ignored for now").
+ */
+import { EMBED_MESSAGE_TYPE } from "../contract.d.cts";
+export declare const SUPERSET_PLUGIN_ID = "orgDashboardEmbedSuperset";
+export declare const SUPERSET_APP_ID = "org_dashboard_embed_superset";
+export declare const SUPERSET_PLUGIN_VERSION = "1.0.0";
+export interface SupersetManifest {
+    id: string;
+    version: string;
+    targetVersion: string;
+    tool: "superset";
+    server: boolean;
+    ui: boolean;
+    embedStrategy: "iframe";
+    status: "stub";
+    requiredPlugins: string[];
+    optionalPlugins: string[];
+}
+/**
+ * Build the placeholder Superset manifest for a target Superset version.
+ */
+export declare function buildSupersetManifest(targetVersion?: string): SupersetManifest;
+export { EMBED_MESSAGE_TYPE };

package/lib/types/plugins/superset/manifest.d.mts

@@ -0,0 +1,28 @@
+/**
+ * @module integrations/plugins/superset/manifest
+ * @summary Superset embed plugin manifest builder (stub).
+ * @description Superset has no Kibana-style native plugin system. This builder
+ * returns a placeholder manifest describing the embed strategy. Detailed
+ * Superset support is deferred ("to be ignored for now").
+ */
+import { EMBED_MESSAGE_TYPE } from "../contract.d.mts";
+export declare const SUPERSET_PLUGIN_ID = "orgDashboardEmbedSuperset";
+export declare const SUPERSET_APP_ID = "org_dashboard_embed_superset";
+export declare const SUPERSET_PLUGIN_VERSION = "1.0.0";
+export interface SupersetManifest {
+    id: string;
+    version: string;
+    targetVersion: string;
+    tool: "superset";
+    server: boolean;
+    ui: boolean;
+    embedStrategy: "iframe";
+    status: "stub";
+    requiredPlugins: string[];
+    optionalPlugins: string[];
+}
+/**
+ * Build the placeholder Superset manifest for a target Superset version.
+ */
+export declare function buildSupersetManifest(targetVersion?: string): SupersetManifest;
+export { EMBED_MESSAGE_TYPE };

package/lib/types/plugins/superset/templates.d.cts

@@ -0,0 +1,12 @@
+export interface SupersetPatchFile {
+    /** Relative path within the target directory. */
+    path: string;
+    /** File contents. */
+    content: string;
+    /** Whether to mark the file executable on POSIX. */
+    executable?: boolean;
+}
+/**
+ * Returns the full set of patch and build script files.
+ */
+export declare function supersetPatchFiles(): SupersetPatchFile[];

package/lib/types/plugins/superset/templates.d.mts

@@ -0,0 +1,12 @@
+export interface SupersetPatchFile {
+    /** Relative path within the target directory. */
+    path: string;
+    /** File contents. */
+    content: string;
+    /** Whether to mark the file executable on POSIX. */
+    executable?: boolean;
+}
+/**
+ * Returns the full set of patch and build script files.
+ */
+export declare function supersetPatchFiles(): SupersetPatchFile[];

package/lib/types/plugins/superset/types.d.cts

@@ -0,0 +1,10 @@
+/**
+ * @module integrations/plugins/superset/types
+ * @summary Superset embed plugin types.
+ * @description Re-exports the shared contract types and Superset-specific
+ * constants/types for the org-agnostic dashboard embed plugin.
+ */
+export * from "../contract.d.cts";
+export { SUPERSET_PLUGIN_ID, SUPERSET_APP_ID, SUPERSET_PLUGIN_VERSION, buildSupersetManifest, type SupersetManifest, } from "./manifest.d.cts";
+export { supersetPatchFiles, type SupersetPatchFile } from "./templates.d.cts";
+export { SupersetDashboardEmbedPlugin, supersetDashboardEmbedPlugin, createSupersetDashboardEmbedPlugin, buildSupersetEmbedUrl, SUPERSET_DEFAULT_BASE_PATH, type SupersetInstallOptions, } from "./installer.d.cts";

package/lib/types/plugins/superset/types.d.mts

@@ -0,0 +1,10 @@
+/**
+ * @module integrations/plugins/superset/types
+ * @summary Superset embed plugin types.
+ * @description Re-exports the shared contract types and Superset-specific
+ * constants/types for the org-agnostic dashboard embed plugin.
+ */
+export * from "../contract.d.mts";
+export { SUPERSET_PLUGIN_ID, SUPERSET_APP_ID, SUPERSET_PLUGIN_VERSION, buildSupersetManifest, type SupersetManifest, } from "./manifest.d.mts";
+export { supersetPatchFiles, type SupersetPatchFile } from "./templates.d.mts";
+export { SupersetDashboardEmbedPlugin, supersetDashboardEmbedPlugin, createSupersetDashboardEmbedPlugin, buildSupersetEmbedUrl, SUPERSET_DEFAULT_BASE_PATH, type SupersetInstallOptions, } from "./installer.d.mts";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decaf-ts/integrations",
-  "version": "0.3.12",
+  "version": "0.4.1-0",
   "type": "module",
   "main": "lib/index.js",
   "types": "lib/index.d.mts",
@@ -71,6 +71,17 @@
       },
       "default": "./lib/esm/nest/graph/index.js"
     },
+    "./loader": {
+      "import": {
+        "types": "./lib/types/loader/index.d.mts",
+        "default": "./lib/esm/loader/index.js"
+      },
+      "require": {
+        "types": "./lib/types/loader/index.d.cts",
+        "default": "./lib/cjs/loader/index.cjs"
+      },
+      "default": "./lib/esm/loader/index.js"
+    },
     "./namespaces": {
       "import": {
         "types": "./lib/types/namespaces/index.d.mts",
@@ -82,6 +93,17 @@
       },
       "default": "./lib/esm/namespaces/index.js"
     },
+    "./feature-flags": {
+      "import": {
+        "types": "./lib/types/feature-flags/index.d.mts",
+        "default": "./lib/esm/feature-flags/index.js"
+      },
+      "require": {
+        "types": "./lib/types/feature-flags/index.d.cts",
+        "default": "./lib/cjs/feature-flags/index.cjs"
+      },
+      "default": "./lib/esm/feature-flags/index.js"
+    },
     "./secrets": {
       "import": {
         "types": "./lib/types/secrets/index.d.mts",
@@ -246,6 +268,39 @@
         "default": "./lib/cjs/graph/shared/index.cjs"
       },
       "default": "./lib/esm/graph/shared/index.js"
+    },
+    "./plugins": {
+      "import": {
+        "types": "./lib/types/plugins/index.d.mts",
+        "default": "./lib/esm/plugins/index.js"
+      },
+      "require": {
+        "types": "./lib/types/plugins/index.d.cts",
+        "default": "./lib/cjs/plugins/index.cjs"
+      },
+      "default": "./lib/esm/plugins/index.js"
+    },
+    "./plugins/kibana": {
+      "import": {
+        "types": "./lib/types/plugins/kibana/index.d.mts",
+        "default": "./lib/esm/plugins/kibana/index.js"
+      },
+      "require": {
+        "types": "./lib/types/plugins/kibana/index.d.cts",
+        "default": "./lib/cjs/plugins/kibana/index.cjs"
+      },
+      "default": "./lib/esm/plugins/kibana/index.js"
+    },
+    "./plugins/superset": {
+      "import": {
+        "types": "./lib/types/plugins/superset/index.d.mts",
+        "default": "./lib/esm/plugins/superset/index.js"
+      },
+      "require": {
+        "types": "./lib/types/plugins/superset/index.d.cts",
+        "default": "./lib/cjs/plugins/superset/index.cjs"
+      },
+      "default": "./lib/esm/plugins/superset/index.js"
     }
   },
   "scripts": {
@@ -262,6 +317,9 @@
     "test:unit": "NODE_OPTIONS=\"--experimental-vm-modules\" jest --watchman=false --testPathPatterns=\"/tests/unit\" --passWithNoTests --detectOpenHandles",
     "test:integration": "NODE_OPTIONS=\"--experimental-vm-modules\" jest --watchman=false --testPathPatterns=\"/tests/(integration)\" --passWithNoTests --detectOpenHandles",
     "test:e2e": "NODE_OPTIONS=\"--experimental-vm-modules\" jest --watchman=false --testPathPatterns=\"/tests/(e2e)\" --passWithNoTests --detectOpenHandles",
+    "test:e2e:plugins": "npx playwright test --config tests/e2e/plugins/playwright.config.ts --project chromium",
+    "test:e2e:plugins:kibana": "npx playwright test --config tests/e2e/plugins/playwright.config.ts tests/e2e/plugins/kibana.e2e.test.ts",
+    "test:e2e:plugins:superset": "npx playwright test --config tests/e2e/plugins/playwright.config.ts tests/e2e/plugins/superset.e2e.test.ts",
     "test:all": "NODE_OPTIONS=\"--experimental-vm-modules\" jest --watchman=false --runInBand --testPathPatterns=\"/tests\" --passWithNoTests",
     "test:circular": "dpdm -T --no-warning --no-tree ./src/index.ts",
     "coverage": "rimraf ./workdocs/reports/data/*.json && npm run test:all -- --coverage --config=./workdocs/reports/jest.coverage.config.cjs",
@@ -307,13 +365,14 @@
     "@decaf-ts/cli": "latest",
     "@decaf-ts/for-http": "latest",
     "@decaf-ts/for-nano": "latest",
-    "@decaf-ts/for-nest": "0.11.2-refactor.9",
+    "@decaf-ts/for-nest": "0.12.2-0",
     "@decaf-ts/utils": "latest",
     "@nestjs/common": "^11.0.0",
     "@nestjs/core": "^11.0.0",
     "@nestjs/platform-express": "^11.0.0",
     "@nestjs/swagger": "^11.4.4",
     "@nestjs/testing": "^11.0.0",
+    "@playwright/test": "^1.61.1",
     "@types/jest": "^30.0.0",
     "@types/supertest": "^6.0.0",
     "reflect-metadata": "^0.2.0",
@@ -323,7 +382,7 @@
   "peerDependencies": {
     "@decaf-ts/as-zod": "latest",
     "@decaf-ts/for-http": "latest",
-    "@decaf-ts/for-nest": "0.11.2-refactor.9",
+    "@decaf-ts/for-nest": "0.12.2-0",
     "jose": ">=5.0.0"
   },
   "peerDependenciesMeta": {

package/plugins/kibana/.gitignore

@@ -0,0 +1,16 @@
+# Ignore everything by default
+*
+
+# Re-include the .gitignore itself
+!.gitignore
+
+# Re-include curated configuration (Dockerfiles, compose, host pages, scripts)
+!Dockerfile
+!docker-compose.yml
+!setup-dashboards.sh
+!dashboards.json
+!host/
+!host/**
+
+# Everything else (generated plugin source org_dashboard_embed/, build artifacts,
+# zips, node_modules) remains ignored

package/plugins/kibana/Dockerfile

@@ -0,0 +1,19 @@
+# Custom Kibana image with the org_dashboard_embed plugin installed.
+#
+# The plugin source is copied into the image and installed via
+# bin/kibana-plugin install, which runs Kibana's optimizer to build the
+# TypeScript/JSX plugin source.
+#
+FROM docker.elastic.co/kibana/kibana:8.14.3
+
+# Copy the plugin zip
+COPY org_dashboard_embed.zip /tmp/org_dashboard_embed.zip
+
+# Install the plugin
+RUN bin/kibana-plugin install file:///tmp/org_dashboard_embed.zip
+
+# Clean up
+RUN rm /tmp/org_dashboard_embed.zip
+
+# Kibana runs as uid 1000
+USER 1000

package/plugins/kibana/docker-compose.yml

@@ -0,0 +1,50 @@
+services:
+  elasticsearch:
+    image: docker.elastic.co/elasticsearch/elasticsearch:8.14.3
+    environment:
+      - discovery.type=single-node
+      - xpack.security.enabled=false
+      - xpack.ml.enabled=false
+      - ES_JAVA_OPTS=-Xms512m -Xmx512m
+    ports:
+      - "9201:9200"
+    healthcheck:
+      test: ["CMD-SHELL", "curl -sf http://localhost:9200/_cluster/health || exit 1"]
+      interval: 5s
+      timeout: 5s
+      retries: 30
+      start_period: 15s
+    networks:
+      - e2e
+
+  kibana:
+    build:
+      context: .
+      dockerfile: Dockerfile
+    environment:
+      - ELASTICSEARCH_HOSTS=http://elasticsearch:9200
+      - XPACK_SECURITY_ENABLED=false
+      - XPACK_ENCRYPTEDSAVEDOBJECTS_ENCRYPTIONKEY=a"something"at"least"32"characters"long
+      - SERVER_HOST=0.0.0.0
+      - SERVER_PORT=5601
+      - ELASTICSEARCH_USERNAME=
+      - ELASTICSEARCH_PASSWORD=
+      - TELEMETRY_ENABLED=false
+      - LOGGING_ROOT_LEVEL=info
+    ports:
+      - "5602:5601"
+    depends_on:
+      elasticsearch:
+        condition: service_healthy
+    healthcheck:
+      test: ["CMD-SHELL", "curl -sf http://localhost:5601/api/status || exit 1"]
+      interval: 10s
+      timeout: 10s
+      retries: 30
+      start_period: 30s
+    networks:
+      - e2e
+
+networks:
+  e2e:
+    driver: bridge

package/plugins/kibana/host/index.html

@@ -0,0 +1,101 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <title>Kibana Embed E2E Test Host</title>
+  <style>
+    * { margin: 0; padding: 0; box-sizing: border-box; }
+    body { font-family: -apple-system, sans-serif; height: 100vh; display: flex; flex-direction: column; }
+    .toolbar { padding: 12px 20px; background: #f0f0f0; border-bottom: 1px solid #ccc; display: flex; gap: 12px; align-items: center; }
+    .toolbar h1 { font-size: 16px; font-weight: 600; margin-right: auto; }
+    .toolbar button { padding: 8px 16px; border: 1px solid #ccc; border-radius: 4px; background: #fff; cursor: pointer; font-size: 14px; }
+    .toolbar button:hover { background: #e8e8e8; }
+    .toolbar button.active { background: #0066cc; color: #fff; border-color: #0066cc; }
+    #status { font-size: 12px; color: #666; padding: 4px 20px; background: #fafafa; }
+    .iframe-container { flex: 1; position: relative; overflow: hidden; }
+    #kibanaFrame { width: 100%; height: 100%; border: 0; }
+  </style>
+</head>
+<body>
+  <div class="toolbar">
+    <h1>Kibana Dashboard Embed E2E</h1>
+    <button id="btn-a" class="active">Dashboard A</button>
+    <button id="btn-b">Dashboard B</button>
+  </div>
+  <div id="status">Initializing...</div>
+  <div class="iframe-container">
+    <iframe id="kibanaFrame" title="Kibana Dashboard"></iframe>
+  </div>
+
+  <script>
+    // These values are injected by the test harness via URL params or window.__E2E_CONFIG
+    const config = window.__E2E_CONFIG || {};
+    const kibanaHost = config.kibanaHost || 'http://localhost:5602';
+    const dashboardA = config.dashboardA || '';
+    const dashboardB = config.dashboardB || '';
+    const parentOrigin = window.location.origin;
+
+    // Build the embed URL with the initial dashboard
+    const embedUrl = `${kibanaHost}/app/org_dashboard_embed?dashboardId=${encodeURIComponent(dashboardA)}&parentOrigin=${encodeURIComponent(parentOrigin)}`;
+    document.getElementById('kibanaFrame').src = embedUrl;
+
+    const iframe = document.getElementById('kibanaFrame');
+    const status = document.getElementById('status');
+
+    // Track messages from the embedded plugin
+    window.addEventListener('message', (event) => {
+      // Accept messages from the Kibana origin
+      if (event.origin !== new URL(kibanaHost).origin && event.origin !== window.location.origin) {
+        return;
+      }
+
+      const msg = event.data;
+      if (!msg || typeof msg !== 'object') return;
+
+      switch (msg.type) {
+        case 'ORG_DASHBOARD_EMBED_READY':
+          status.textContent = `READY — dashboardId: ${msg.dashboardId}`;
+          window.__E2E_READY = true;
+          break;
+        case 'ORG_DASHBOARD_EMBED_RENDERED':
+          status.textContent = `RENDERED — dashboardId: ${msg.dashboardId}`;
+          window.__E2E_RENDERED = msg.dashboardId;
+          break;
+        case 'ORG_DASHBOARD_EMBED_ERROR':
+          status.textContent = `ERROR — ${msg.message}`;
+          window.__E2E_ERROR = msg.message;
+          break;
+      }
+    });
+
+    // Switch dashboard via postMessage
+    function switchDashboard(dashboardId) {
+      window.__E2E_RENDERED = null;
+      iframe.contentWindow.postMessage({
+        type: 'ORG_DASHBOARD_EMBED_SWITCH_DASHBOARD',
+        dashboardId: dashboardId,
+        timeRange: { from: 'now-30d', to: 'now' },
+        query: { language: 'kuery', query: '' }
+      }, kibanaHost);
+      status.textContent = `Switching to ${dashboardId}...`;
+    }
+
+    document.getElementById('btn-a').addEventListener('click', () => {
+      switchDashboard(dashboardA);
+      document.querySelectorAll('.toolbar button').forEach(b => b.classList.remove('active'));
+      document.getElementById('btn-a').classList.add('active');
+    });
+
+    document.getElementById('btn-b').addEventListener('click', () => {
+      switchDashboard(dashboardB);
+      document.querySelectorAll('.toolbar button').forEach(b => b.classList.remove('active'));
+      document.getElementById('btn-b').classList.add('active');
+    });
+
+    // Expose for Playwright
+    window.__E2E_SWITCH = switchDashboard;
+    window.__E2E_IFRAME = iframe;
+    window.__E2E_KIBANA_HOST = kibanaHost;
+  </script>
+</body>
+</html>