@decaf-ts/integrations 0.4.0 → 0.4.1-0

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

@@ -0,0 +1,45 @@
+import { type DashboardEmbedPlugin, type DashboardEmbedPluginDescriptor, type EmbedUrlOptions, type PluginInstallOptions, type PluginInstallResult, type SwitchDashboardPayload, type SwitchDashboardMessage, type EmbedMessageTarget } from "../contract.d.cts";
+/** Default Kibana base path when none is provided. */
+export declare const KIBANA_DEFAULT_BASE_PATH = "kibana";
+/**
+ * Build the stable Kibana embed iframe URL.
+ *
+ * @example
+ *   buildKibanaEmbedUrl({ host: "ptp.host", dashboardId: "abc", parentOrigin: "https://app.example.com" })
+ *   // => "//ptp.host/kibana/app/org_dashboard_embed?dashboardId=abc&parentOrigin=https%3A%2F%2Fapp.example.com"
+ */
+export declare function buildKibanaEmbedUrl(options: EmbedUrlOptions): string;
+/**
+ * @class KibanaDashboardEmbedPlugin
+ * @summary Kibana implementation of the `DashboardEmbedPlugin` contract.
+ * @description Org-agnostic multi-tenant dashboard embed plugin for Kibana.
+ */
+export declare class KibanaDashboardEmbedPlugin 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 generated Kibana plugin into `targetPath/org_dashboard_embed/`.
+     *
+     * Kibana plugins must be built within the Kibana repo against the exact
+     * Kibana version. When `build` is true, this attempts `yarn build` in the
+     * plugin directory (best-effort); real builds require the Kibana plugin
+     * helpers environment.
+     */
+    install(options: PluginInstallOptions): Promise<PluginInstallResult>;
+    /**
+     * Best-effort `yarn build` in the plugin directory. Real builds require the
+     * Kibana plugin helpers environment; failures are captured, not thrown.
+     */
+    protected runBuild(pluginDir: string): Promise<{
+        ok: boolean;
+        output: string;
+    }>;
+}
+/** Default singleton instance. */
+export declare const kibanaDashboardEmbedPlugin: KibanaDashboardEmbedPlugin;
+/** Factory accepting a target Kibana version. */
+export declare function createKibanaDashboardEmbedPlugin(targetVersion: string): KibanaDashboardEmbedPlugin;

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

@@ -0,0 +1,45 @@
+import { type DashboardEmbedPlugin, type DashboardEmbedPluginDescriptor, type EmbedUrlOptions, type PluginInstallOptions, type PluginInstallResult, type SwitchDashboardPayload, type SwitchDashboardMessage, type EmbedMessageTarget } from "../contract.d.mts";
+/** Default Kibana base path when none is provided. */
+export declare const KIBANA_DEFAULT_BASE_PATH = "kibana";
+/**
+ * Build the stable Kibana embed iframe URL.
+ *
+ * @example
+ *   buildKibanaEmbedUrl({ host: "ptp.host", dashboardId: "abc", parentOrigin: "https://app.example.com" })
+ *   // => "//ptp.host/kibana/app/org_dashboard_embed?dashboardId=abc&parentOrigin=https%3A%2F%2Fapp.example.com"
+ */
+export declare function buildKibanaEmbedUrl(options: EmbedUrlOptions): string;
+/**
+ * @class KibanaDashboardEmbedPlugin
+ * @summary Kibana implementation of the `DashboardEmbedPlugin` contract.
+ * @description Org-agnostic multi-tenant dashboard embed plugin for Kibana.
+ */
+export declare class KibanaDashboardEmbedPlugin 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 generated Kibana plugin into `targetPath/org_dashboard_embed/`.
+     *
+     * Kibana plugins must be built within the Kibana repo against the exact
+     * Kibana version. When `build` is true, this attempts `yarn build` in the
+     * plugin directory (best-effort); real builds require the Kibana plugin
+     * helpers environment.
+     */
+    install(options: PluginInstallOptions): Promise<PluginInstallResult>;
+    /**
+     * Best-effort `yarn build` in the plugin directory. Real builds require the
+     * Kibana plugin helpers environment; failures are captured, not thrown.
+     */
+    protected runBuild(pluginDir: string): Promise<{
+        ok: boolean;
+        output: string;
+    }>;
+}
+/** Default singleton instance. */
+export declare const kibanaDashboardEmbedPlugin: KibanaDashboardEmbedPlugin;
+/** Factory accepting a target Kibana version. */
+export declare function createKibanaDashboardEmbedPlugin(targetVersion: string): KibanaDashboardEmbedPlugin;

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

@@ -0,0 +1,31 @@
+/**
+ * @module integrations/plugins/kibana/manifest
+ * @summary Kibana embed plugin manifest builder.
+ * @description Builds the `kibana.json` manifest for the org-agnostic
+ * `orgDashboardEmbed` plugin against a target Kibana version.
+ */
+import { EMBED_MESSAGE_TYPE } from "../contract.d.cts";
+export declare const KIBANA_PLUGIN_ID = "orgDashboardEmbed";
+export declare const KIBANA_APP_ID = "org_dashboard_embed";
+export declare const KIBANA_PLUGIN_VERSION = "1.0.0";
+export interface KibanaManifest {
+    id: string;
+    version: string;
+    kibanaVersion: string;
+    server: boolean;
+    ui: boolean;
+    requiredPlugins: string[];
+    optionalPlugins: string[];
+    requiredBundles?: string[];
+}
+/**
+ * Build the `kibana.json` manifest for a target Kibana version.
+ *
+ * @param targetVersion - Kibana version (defaults to "kibana").
+ */
+export declare function buildKibanaManifest(targetVersion?: string): KibanaManifest;
+/**
+ * Message type constants re-exported so the generated plugin templates can
+ * reference the same protocol identifiers as the host helpers.
+ */
+export { EMBED_MESSAGE_TYPE };

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

@@ -0,0 +1,31 @@
+/**
+ * @module integrations/plugins/kibana/manifest
+ * @summary Kibana embed plugin manifest builder.
+ * @description Builds the `kibana.json` manifest for the org-agnostic
+ * `orgDashboardEmbed` plugin against a target Kibana version.
+ */
+import { EMBED_MESSAGE_TYPE } from "../contract.d.mts";
+export declare const KIBANA_PLUGIN_ID = "orgDashboardEmbed";
+export declare const KIBANA_APP_ID = "org_dashboard_embed";
+export declare const KIBANA_PLUGIN_VERSION = "1.0.0";
+export interface KibanaManifest {
+    id: string;
+    version: string;
+    kibanaVersion: string;
+    server: boolean;
+    ui: boolean;
+    requiredPlugins: string[];
+    optionalPlugins: string[];
+    requiredBundles?: string[];
+}
+/**
+ * Build the `kibana.json` manifest for a target Kibana version.
+ *
+ * @param targetVersion - Kibana version (defaults to "kibana").
+ */
+export declare function buildKibanaManifest(targetVersion?: string): KibanaManifest;
+/**
+ * Message type constants re-exported so the generated plugin templates can
+ * reference the same protocol identifiers as the host helpers.
+ */
+export { EMBED_MESSAGE_TYPE };

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

@@ -0,0 +1,12 @@
+export interface KibanaPluginFile {
+    /** Relative path within the plugin directory. */
+    path: string;
+    /** File contents. */
+    content: string;
+}
+/**
+ * Returns the full set of generated plugin files for a target Kibana version.
+ *
+ * @param targetVersion - Kibana version baked into `kibana.json`.
+ */
+export declare function kibanaPluginFiles(targetVersion: string): KibanaPluginFile[];

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

@@ -0,0 +1,12 @@
+export interface KibanaPluginFile {
+    /** Relative path within the plugin directory. */
+    path: string;
+    /** File contents. */
+    content: string;
+}
+/**
+ * Returns the full set of generated plugin files for a target Kibana version.
+ *
+ * @param targetVersion - Kibana version baked into `kibana.json`.
+ */
+export declare function kibanaPluginFiles(targetVersion: string): KibanaPluginFile[];

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

@@ -0,0 +1,9 @@
+/**
+ * @module integrations/plugins/kibana/types
+ * @summary Kibana embed plugin types.
+ * @description Re-exports the shared contract types and exposes Kibana-specific
+ * constants/types for the org-agnostic dashboard embed plugin.
+ */
+export * from "../contract.d.cts";
+export { KIBANA_PLUGIN_ID, KIBANA_APP_ID, KIBANA_PLUGIN_VERSION, buildKibanaManifest, type KibanaManifest, } from "./manifest.d.cts";
+export { kibanaPluginFiles, type KibanaPluginFile } from "./templates.d.cts";

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

@@ -0,0 +1,9 @@
+/**
+ * @module integrations/plugins/kibana/types
+ * @summary Kibana embed plugin types.
+ * @description Re-exports the shared contract types and exposes Kibana-specific
+ * constants/types for the org-agnostic dashboard embed plugin.
+ */
+export * from "../contract.d.mts";
+export { KIBANA_PLUGIN_ID, KIBANA_APP_ID, KIBANA_PLUGIN_VERSION, buildKibanaManifest, type KibanaManifest, } from "./manifest.d.mts";
+export { kibanaPluginFiles, type KibanaPluginFile } from "./templates.d.mts";

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.4.0",
+  "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": "latest",
+    "@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": "latest",
+    "@decaf-ts/for-nest": "0.12.2-0",
     "jose": ">=5.0.0"
   },
   "peerDependenciesMeta": {