@decaf-ts/integrations 0.1.1

package/lib/types/kibana/services/KibanaAuthService.d.mts

@@ -0,0 +1,16 @@
+import { MaybeContextualArg } from "@decaf-ts/core";
+import { ClientBasedService } from "@decaf-ts/core";
+import type { KibanaSetupConfig, KibanaUser } from "../types.d.mts";
+import { AxiosInstance } from "axios";
+export declare class KibanaAuthService extends ClientBasedService<AxiosInstance, KibanaSetupConfig> {
+    initialize(...args: MaybeContextualArg<any>): Promise<{
+        config: KibanaSetupConfig;
+        client: AxiosInstance;
+    }>;
+    loginToKibana(username: string | undefined, password: string | undefined, ...args: MaybeContextualArg<any>): Promise<string[] | undefined>;
+    logout(user: KibanaUser, ...args: MaybeContextualArg<any>): Promise<void>;
+    protected parseError(error: Error): Error;
+    private createHttpClient;
+    private isSecureEnvironment;
+    private request;
+}

package/lib/types/kibana/services/KibanaDashboardService.d.cts

@@ -0,0 +1,31 @@
+import { MaybeContextualArg } from "@decaf-ts/core";
+import { ClientBasedService } from "@decaf-ts/core";
+import type { KibanaSetupConfig } from "../types.d.cts";
+import { type AxiosInstance } from "axios";
+import { KibanaAuthService } from "./KibanaAuthService.d.cts";
+export declare class KibanaDashboardService extends ClientBasedService<AxiosInstance, KibanaSetupConfig> {
+    protected authService: KibanaAuthService;
+    initialize(...args: MaybeContextualArg<any>): Promise<{
+        config: KibanaSetupConfig;
+        client: AxiosInstance;
+    }>;
+    cloneDefaultDashboards(realmName: string, ...args: MaybeContextualArg<any>): Promise<string | undefined>;
+    generateDashboardEmbedUrl(options: {
+        space: string;
+        dashboardId: string;
+        showTimeFilter?: boolean;
+        showQueryInput?: boolean;
+        showFilterBar?: boolean;
+        hidePanelTitles?: boolean;
+        timeRange?: {
+            from: string;
+            to: string;
+        };
+    }): string;
+    verifySpaceSetup(realmName: string, ...args: MaybeContextualArg<any>): Promise<void>;
+    private createHttpClient;
+    protected parseError(error: Error): Error;
+    private isSecureEnvironment;
+    private request;
+    private parseJson;
+}

package/lib/types/kibana/services/KibanaDashboardService.d.mts

@@ -0,0 +1,31 @@
+import { MaybeContextualArg } from "@decaf-ts/core";
+import { ClientBasedService } from "@decaf-ts/core";
+import type { KibanaSetupConfig } from "../types.d.mts";
+import { type AxiosInstance } from "axios";
+import { KibanaAuthService } from "./KibanaAuthService.d.mts";
+export declare class KibanaDashboardService extends ClientBasedService<AxiosInstance, KibanaSetupConfig> {
+    protected authService: KibanaAuthService;
+    initialize(...args: MaybeContextualArg<any>): Promise<{
+        config: KibanaSetupConfig;
+        client: AxiosInstance;
+    }>;
+    cloneDefaultDashboards(realmName: string, ...args: MaybeContextualArg<any>): Promise<string | undefined>;
+    generateDashboardEmbedUrl(options: {
+        space: string;
+        dashboardId: string;
+        showTimeFilter?: boolean;
+        showQueryInput?: boolean;
+        showFilterBar?: boolean;
+        hidePanelTitles?: boolean;
+        timeRange?: {
+            from: string;
+            to: string;
+        };
+    }): string;
+    verifySpaceSetup(realmName: string, ...args: MaybeContextualArg<any>): Promise<void>;
+    private createHttpClient;
+    protected parseError(error: Error): Error;
+    private isSecureEnvironment;
+    private request;
+    private parseJson;
+}

package/lib/types/kibana/services/KibanaDataViewService.d.cts

@@ -0,0 +1,23 @@
+import { MaybeContextualArg } from "@decaf-ts/core";
+import { ClientBasedService } from "@decaf-ts/core";
+import type { KibanaDataViewConfig, KibanaSetupConfig } from "../types.d.cts";
+import { AxiosInstance } from "axios";
+import { KibanaAuthService } from "./KibanaAuthService.d.cts";
+export declare class KibanaDataViewService extends ClientBasedService<AxiosInstance, KibanaSetupConfig> {
+    protected authService: KibanaAuthService;
+    initialize(...args: MaybeContextualArg<any>): Promise<{
+        config: KibanaSetupConfig;
+        client: AxiosInstance;
+    }>;
+    createDataView(realmName: string, spec: KibanaDataViewConfig, ...args: MaybeContextualArg<any>): Promise<void>;
+    updateDataView(realmName: string, spec: KibanaDataViewConfig, ...args: MaybeContextualArg<any>): Promise<void>;
+    createDataViews(realmName: string, dataViews: KibanaDataViewConfig[] | undefined, ...args: MaybeContextualArg<any>): Promise<void>;
+    setDefaultDataView(realmName: string, dataViewId: string | undefined, ...args: MaybeContextualArg<any>): Promise<void>;
+    private createHttpClient;
+    protected parseError(error: Error): Error;
+    private isSecureEnvironment;
+    private normalizeDataViewConfig;
+    private defaultDataViewConfigs;
+    private request;
+    private parseJson;
+}

package/lib/types/kibana/services/KibanaDataViewService.d.mts

@@ -0,0 +1,23 @@
+import { MaybeContextualArg } from "@decaf-ts/core";
+import { ClientBasedService } from "@decaf-ts/core";
+import type { KibanaDataViewConfig, KibanaSetupConfig } from "../types.d.mts";
+import { AxiosInstance } from "axios";
+import { KibanaAuthService } from "./KibanaAuthService.d.mts";
+export declare class KibanaDataViewService extends ClientBasedService<AxiosInstance, KibanaSetupConfig> {
+    protected authService: KibanaAuthService;
+    initialize(...args: MaybeContextualArg<any>): Promise<{
+        config: KibanaSetupConfig;
+        client: AxiosInstance;
+    }>;
+    createDataView(realmName: string, spec: KibanaDataViewConfig, ...args: MaybeContextualArg<any>): Promise<void>;
+    updateDataView(realmName: string, spec: KibanaDataViewConfig, ...args: MaybeContextualArg<any>): Promise<void>;
+    createDataViews(realmName: string, dataViews: KibanaDataViewConfig[] | undefined, ...args: MaybeContextualArg<any>): Promise<void>;
+    setDefaultDataView(realmName: string, dataViewId: string | undefined, ...args: MaybeContextualArg<any>): Promise<void>;
+    private createHttpClient;
+    protected parseError(error: Error): Error;
+    private isSecureEnvironment;
+    private normalizeDataViewConfig;
+    private defaultDataViewConfigs;
+    private request;
+    private parseJson;
+}

package/lib/types/kibana/services/KibanaRoleService.d.cts

@@ -0,0 +1,19 @@
+import { MaybeContextualArg } from "@decaf-ts/core";
+import { ClientBasedService } from "@decaf-ts/core";
+import type { KibanaRoleConfig, KibanaSetupConfig } from "../types.d.cts";
+import { AxiosInstance } from "axios";
+import { KibanaAuthService } from "./KibanaAuthService.d.cts";
+export declare class KibanaRoleService extends ClientBasedService<AxiosInstance, KibanaSetupConfig> {
+    protected authService: KibanaAuthService;
+    initialize(...args: MaybeContextualArg<any>): Promise<{
+        config: KibanaSetupConfig;
+        client: AxiosInstance;
+    }>;
+    createRole(realmName: string, payload: Partial<KibanaRoleConfig> | undefined, ...args: MaybeContextualArg<any>): Promise<void>;
+    updateRole(realmName: string, payload: Partial<KibanaRoleConfig>, ...args: MaybeContextualArg<any>): Promise<void>;
+    private createHttpClient;
+    protected parseError(error: Error): Error;
+    private isSecureEnvironment;
+    private normalizeRoleConfig;
+    private request;
+}

package/lib/types/kibana/services/KibanaRoleService.d.mts

@@ -0,0 +1,19 @@
+import { MaybeContextualArg } from "@decaf-ts/core";
+import { ClientBasedService } from "@decaf-ts/core";
+import type { KibanaRoleConfig, KibanaSetupConfig } from "../types.d.mts";
+import { AxiosInstance } from "axios";
+import { KibanaAuthService } from "./KibanaAuthService.d.mts";
+export declare class KibanaRoleService extends ClientBasedService<AxiosInstance, KibanaSetupConfig> {
+    protected authService: KibanaAuthService;
+    initialize(...args: MaybeContextualArg<any>): Promise<{
+        config: KibanaSetupConfig;
+        client: AxiosInstance;
+    }>;
+    createRole(realmName: string, payload: Partial<KibanaRoleConfig> | undefined, ...args: MaybeContextualArg<any>): Promise<void>;
+    updateRole(realmName: string, payload: Partial<KibanaRoleConfig>, ...args: MaybeContextualArg<any>): Promise<void>;
+    private createHttpClient;
+    protected parseError(error: Error): Error;
+    private isSecureEnvironment;
+    private normalizeRoleConfig;
+    private request;
+}

package/lib/types/kibana/services/KibanaService.d.cts

@@ -0,0 +1,55 @@
+import { MaybeContextualArg } from "@decaf-ts/core";
+import { ClientBasedService } from "@decaf-ts/core";
+import type { KibanaDataViewConfig, KibanaRoleConfig, KibanaSetupConfig, KibanaSpaceConfig, KibanaUser } from "../types.d.cts";
+import { AxiosInstance } from "axios";
+import { KibanaSpaceService } from "./KibanaSpaceService.d.cts";
+import { KibanaDataViewService } from "./KibanaDataViewService.d.cts";
+import { KibanaRoleService } from "./KibanaRoleService.d.cts";
+import { KibanaUserService } from "./KibanaUserService.d.cts";
+import { KibanaDashboardService } from "./KibanaDashboardService.d.cts";
+import { KibanaAuthService } from "./KibanaAuthService.d.cts";
+/**
+ * @class KibanaService
+ * @summary Orchestrates Kibana setup and provisioning flows.
+ * @description Boots the lower-level Kibana services, coordinates creation of spaces, data views, roles, users, dashboards, and exposes helper methods for embed URLs and organization setup.
+ */
+export declare class KibanaService extends ClientBasedService<AxiosInstance, KibanaSetupConfig> {
+    protected spaceService: KibanaSpaceService;
+    protected dataViewService: KibanaDataViewService;
+    protected roleService: KibanaRoleService;
+    protected userService: KibanaUserService;
+    protected dashboardService: KibanaDashboardService;
+    protected authService: KibanaAuthService;
+    constructor();
+    initialize(...args: MaybeContextualArg<any>): Promise<{
+        config: KibanaSetupConfig;
+        client: AxiosInstance;
+    }>;
+    setupOrganization(config: KibanaSetupConfig, ...args: MaybeContextualArg<any>): Promise<KibanaSetupConfig>;
+    generateDashboardEmbedUrl(options: {
+        space: string;
+        dashboardId: string;
+        showTimeFilter?: boolean;
+        showQueryInput?: boolean;
+        showFilterBar?: boolean;
+        hidePanelTitles?: boolean;
+        timeRange?: {
+            from: string;
+            to: string;
+        };
+    }): string;
+    createSpace(realmName: string, payload: Partial<KibanaSpaceConfig> | undefined, ...args: MaybeContextualArg<any>): Promise<void>;
+    updateSpace(realmName: string, payload: Partial<KibanaSpaceConfig>, ...args: MaybeContextualArg<any>): Promise<void>;
+    deleteSpace(realmName: string, ...args: MaybeContextualArg<any>): Promise<void>;
+    createDataView(realmName: string, spec: KibanaDataViewConfig, ...args: MaybeContextualArg<any>): Promise<void>;
+    updateDataView(realmName: string, spec: KibanaDataViewConfig, ...args: MaybeContextualArg<any>): Promise<void>;
+    createDataViews(realmName: string, dataViews: KibanaDataViewConfig[] | undefined, ...args: MaybeContextualArg<any>): Promise<void>;
+    setDefaultDataView(realmName: string, dataViewId: string | undefined, ...args: MaybeContextualArg<any>): Promise<void>;
+    cloneDefaultDashboards(realmName: string, ...args: MaybeContextualArg<any>): Promise<string | undefined>;
+    createRole(realmName: string, payload: Partial<KibanaRoleConfig> | undefined, ...args: MaybeContextualArg<any>): Promise<void>;
+    updateRole(realmName: string, payload: Partial<KibanaRoleConfig>, ...args: MaybeContextualArg<any>): Promise<void>;
+    createUser(user: KibanaUser, realmName: string, roleNames: string[] | undefined, ...args: MaybeContextualArg<any>): Promise<void>;
+    updateUser(user: KibanaUser, realmName: string, roleNames: string[] | undefined, ...args: MaybeContextualArg<any>): Promise<void>;
+    verifySpaceSetup(realmName: string, ...args: MaybeContextualArg<any>): Promise<void>;
+    private createHttpClient;
+}

package/lib/types/kibana/services/KibanaService.d.mts

@@ -0,0 +1,55 @@
+import { MaybeContextualArg } from "@decaf-ts/core";
+import { ClientBasedService } from "@decaf-ts/core";
+import type { KibanaDataViewConfig, KibanaRoleConfig, KibanaSetupConfig, KibanaSpaceConfig, KibanaUser } from "../types.d.mts";
+import { AxiosInstance } from "axios";
+import { KibanaSpaceService } from "./KibanaSpaceService.d.mts";
+import { KibanaDataViewService } from "./KibanaDataViewService.d.mts";
+import { KibanaRoleService } from "./KibanaRoleService.d.mts";
+import { KibanaUserService } from "./KibanaUserService.d.mts";
+import { KibanaDashboardService } from "./KibanaDashboardService.d.mts";
+import { KibanaAuthService } from "./KibanaAuthService.d.mts";
+/**
+ * @class KibanaService
+ * @summary Orchestrates Kibana setup and provisioning flows.
+ * @description Boots the lower-level Kibana services, coordinates creation of spaces, data views, roles, users, dashboards, and exposes helper methods for embed URLs and organization setup.
+ */
+export declare class KibanaService extends ClientBasedService<AxiosInstance, KibanaSetupConfig> {
+    protected spaceService: KibanaSpaceService;
+    protected dataViewService: KibanaDataViewService;
+    protected roleService: KibanaRoleService;
+    protected userService: KibanaUserService;
+    protected dashboardService: KibanaDashboardService;
+    protected authService: KibanaAuthService;
+    constructor();
+    initialize(...args: MaybeContextualArg<any>): Promise<{
+        config: KibanaSetupConfig;
+        client: AxiosInstance;
+    }>;
+    setupOrganization(config: KibanaSetupConfig, ...args: MaybeContextualArg<any>): Promise<KibanaSetupConfig>;
+    generateDashboardEmbedUrl(options: {
+        space: string;
+        dashboardId: string;
+        showTimeFilter?: boolean;
+        showQueryInput?: boolean;
+        showFilterBar?: boolean;
+        hidePanelTitles?: boolean;
+        timeRange?: {
+            from: string;
+            to: string;
+        };
+    }): string;
+    createSpace(realmName: string, payload: Partial<KibanaSpaceConfig> | undefined, ...args: MaybeContextualArg<any>): Promise<void>;
+    updateSpace(realmName: string, payload: Partial<KibanaSpaceConfig>, ...args: MaybeContextualArg<any>): Promise<void>;
+    deleteSpace(realmName: string, ...args: MaybeContextualArg<any>): Promise<void>;
+    createDataView(realmName: string, spec: KibanaDataViewConfig, ...args: MaybeContextualArg<any>): Promise<void>;
+    updateDataView(realmName: string, spec: KibanaDataViewConfig, ...args: MaybeContextualArg<any>): Promise<void>;
+    createDataViews(realmName: string, dataViews: KibanaDataViewConfig[] | undefined, ...args: MaybeContextualArg<any>): Promise<void>;
+    setDefaultDataView(realmName: string, dataViewId: string | undefined, ...args: MaybeContextualArg<any>): Promise<void>;
+    cloneDefaultDashboards(realmName: string, ...args: MaybeContextualArg<any>): Promise<string | undefined>;
+    createRole(realmName: string, payload: Partial<KibanaRoleConfig> | undefined, ...args: MaybeContextualArg<any>): Promise<void>;
+    updateRole(realmName: string, payload: Partial<KibanaRoleConfig>, ...args: MaybeContextualArg<any>): Promise<void>;
+    createUser(user: KibanaUser, realmName: string, roleNames: string[] | undefined, ...args: MaybeContextualArg<any>): Promise<void>;
+    updateUser(user: KibanaUser, realmName: string, roleNames: string[] | undefined, ...args: MaybeContextualArg<any>): Promise<void>;
+    verifySpaceSetup(realmName: string, ...args: MaybeContextualArg<any>): Promise<void>;
+    private createHttpClient;
+}

package/lib/types/kibana/services/KibanaSpaceService.d.cts

@@ -0,0 +1,20 @@
+import { MaybeContextualArg } from "@decaf-ts/core";
+import { ClientBasedService } from "@decaf-ts/core";
+import type { KibanaSetupConfig, KibanaSpaceConfig } from "../types.d.cts";
+import { AxiosInstance } from "axios";
+import { KibanaAuthService } from "./KibanaAuthService.d.cts";
+export declare class KibanaSpaceService extends ClientBasedService<AxiosInstance, KibanaSetupConfig> {
+    protected authService: KibanaAuthService;
+    initialize(...args: MaybeContextualArg<any>): Promise<{
+        config: KibanaSetupConfig;
+        client: AxiosInstance;
+    }>;
+    createSpace(realmName: string, payload: Partial<KibanaSpaceConfig> | undefined, ...args: MaybeContextualArg<any>): Promise<void>;
+    updateSpace(realmName: string, payload: Partial<KibanaSpaceConfig>, ...args: MaybeContextualArg<any>): Promise<void>;
+    deleteSpace(realmName: string, ...args: MaybeContextualArg<any>): Promise<void>;
+    private createHttpClient;
+    protected parseError(error: Error): Error;
+    private isSecureEnvironment;
+    private normalizeSpaceConfig;
+    private request;
+}

package/lib/types/kibana/services/KibanaSpaceService.d.mts

@@ -0,0 +1,20 @@
+import { MaybeContextualArg } from "@decaf-ts/core";
+import { ClientBasedService } from "@decaf-ts/core";
+import type { KibanaSetupConfig, KibanaSpaceConfig } from "../types.d.mts";
+import { AxiosInstance } from "axios";
+import { KibanaAuthService } from "./KibanaAuthService.d.mts";
+export declare class KibanaSpaceService extends ClientBasedService<AxiosInstance, KibanaSetupConfig> {
+    protected authService: KibanaAuthService;
+    initialize(...args: MaybeContextualArg<any>): Promise<{
+        config: KibanaSetupConfig;
+        client: AxiosInstance;
+    }>;
+    createSpace(realmName: string, payload: Partial<KibanaSpaceConfig> | undefined, ...args: MaybeContextualArg<any>): Promise<void>;
+    updateSpace(realmName: string, payload: Partial<KibanaSpaceConfig>, ...args: MaybeContextualArg<any>): Promise<void>;
+    deleteSpace(realmName: string, ...args: MaybeContextualArg<any>): Promise<void>;
+    private createHttpClient;
+    protected parseError(error: Error): Error;
+    private isSecureEnvironment;
+    private normalizeSpaceConfig;
+    private request;
+}

package/lib/types/kibana/services/KibanaUserService.d.cts

@@ -0,0 +1,19 @@
+import { MaybeContextualArg } from "@decaf-ts/core";
+import { ClientBasedService } from "@decaf-ts/core";
+import type { KibanaSetupConfig, KibanaUser } from "../types.d.cts";
+import { AxiosInstance } from "axios";
+import { KibanaAuthService } from "./KibanaAuthService.d.cts";
+export declare class KibanaUserService extends ClientBasedService<AxiosInstance, KibanaSetupConfig> {
+    protected authService: KibanaAuthService;
+    initialize(...args: MaybeContextualArg<any>): Promise<{
+        config: KibanaSetupConfig;
+        client: AxiosInstance;
+    }>;
+    createUser(user: KibanaUser, realmName: string, roleNames: string[] | undefined, ...args: MaybeContextualArg<any>): Promise<void>;
+    updateUser(user: KibanaUser, realmName: string, roleNames: string[] | undefined, ...args: MaybeContextualArg<any>): Promise<void>;
+    private createHttpClient;
+    protected parseError(error: Error): Error;
+    private isSecureEnvironment;
+    private normalizeRoleConfig;
+    private request;
+}

package/lib/types/kibana/services/KibanaUserService.d.mts

@@ -0,0 +1,19 @@
+import { MaybeContextualArg } from "@decaf-ts/core";
+import { ClientBasedService } from "@decaf-ts/core";
+import type { KibanaSetupConfig, KibanaUser } from "../types.d.mts";
+import { AxiosInstance } from "axios";
+import { KibanaAuthService } from "./KibanaAuthService.d.mts";
+export declare class KibanaUserService extends ClientBasedService<AxiosInstance, KibanaSetupConfig> {
+    protected authService: KibanaAuthService;
+    initialize(...args: MaybeContextualArg<any>): Promise<{
+        config: KibanaSetupConfig;
+        client: AxiosInstance;
+    }>;
+    createUser(user: KibanaUser, realmName: string, roleNames: string[] | undefined, ...args: MaybeContextualArg<any>): Promise<void>;
+    updateUser(user: KibanaUser, realmName: string, roleNames: string[] | undefined, ...args: MaybeContextualArg<any>): Promise<void>;
+    private createHttpClient;
+    protected parseError(error: Error): Error;
+    private isSecureEnvironment;
+    private normalizeRoleConfig;
+    private request;
+}

package/lib/types/kibana/services/index.d.cts

@@ -0,0 +1,12 @@
+/**
+ * @module integrations/kibana/services
+ * @summary Kibana provisioning services.
+ * @description Re-exports the services used to configure spaces, dashboards, data views, roles, users, and auth flows.
+ */
+export { KibanaSpaceService } from "./KibanaSpaceService.d.cts";
+export { KibanaDataViewService } from "./KibanaDataViewService.d.cts";
+export { KibanaRoleService } from "./KibanaRoleService.d.cts";
+export { KibanaUserService } from "./KibanaUserService.d.cts";
+export { KibanaDashboardService } from "./KibanaDashboardService.d.cts";
+export { KibanaAuthService } from "./KibanaAuthService.d.cts";
+export { KibanaService } from "./KibanaService.d.cts";

package/lib/types/kibana/services/index.d.mts

@@ -0,0 +1,12 @@
+/**
+ * @module integrations/kibana/services
+ * @summary Kibana provisioning services.
+ * @description Re-exports the services used to configure spaces, dashboards, data views, roles, users, and auth flows.
+ */
+export { KibanaSpaceService } from "./KibanaSpaceService.d.mts";
+export { KibanaDataViewService } from "./KibanaDataViewService.d.mts";
+export { KibanaRoleService } from "./KibanaRoleService.d.mts";
+export { KibanaUserService } from "./KibanaUserService.d.mts";
+export { KibanaDashboardService } from "./KibanaDashboardService.d.mts";
+export { KibanaAuthService } from "./KibanaAuthService.d.mts";
+export { KibanaService } from "./KibanaService.d.mts";

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

@@ -0,0 +1,75 @@
+export interface KibanaUser {
+    username: string;
+    password: string;
+    full_name?: string;
+    email?: string;
+    enabled?: boolean;
+    roles?: string[];
+    metadata?: Record<string, unknown>;
+}
+export interface KibanaDashboardTargets {
+    [key: string]: string;
+}
+export interface KibanaSpaceConfig {
+    id: string;
+    name: string;
+    description?: string;
+    initials?: string;
+    color?: string;
+    disabledFeatures?: string[];
+    solution?: string;
+    imageUrl?: string;
+}
+/**
+ * @module integrations/kibana/types
+ * @summary Kibana configuration and payload types.
+ * @description Shared type definitions for Kibana provisioning services and setup payloads.
+ */
+export interface KibanaDataViewConfig {
+    id: string;
+    name: string;
+    title: string;
+    timeFieldName?: string;
+    namespaces?: string[];
+    sourceFilters?: Array<{
+        value: string;
+    }>;
+    runtimeFieldMap?: Record<string, unknown>;
+    fieldAttrs?: Record<string, unknown>;
+    allowNoIndex?: boolean;
+}
+export interface KibanaRoleConfig {
+    name: string;
+    indices?: Array<{
+        names: string[];
+        privileges: string[];
+        allow_restricted_indices?: boolean;
+    }>;
+    applications?: Array<{
+        application: string;
+        privileges: string[];
+        resources: string[];
+    }>;
+    kibana?: Array<{
+        base?: string[];
+        feature?: Record<string, string[]>;
+        spaces?: string[];
+    }>;
+    metadata?: Record<string, unknown>;
+}
+export interface KibanaSetupConfig {
+    id: string;
+    host: string;
+    es_host: string;
+    protocol: "http" | "https";
+    realm: string;
+    space?: Partial<KibanaSpaceConfig>;
+    dataViews?: KibanaDataViewConfig[];
+    role?: Partial<KibanaRoleConfig>;
+    dashboards?: KibanaDashboardTargets;
+    adminApiUser?: KibanaUser;
+    realmApiUser: KibanaUser;
+    dashboardImportPath?: string;
+    dashboardImportOverwrite?: boolean;
+    assets?: string;
+}

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

@@ -0,0 +1,75 @@
+export interface KibanaUser {
+    username: string;
+    password: string;
+    full_name?: string;
+    email?: string;
+    enabled?: boolean;
+    roles?: string[];
+    metadata?: Record<string, unknown>;
+}
+export interface KibanaDashboardTargets {
+    [key: string]: string;
+}
+export interface KibanaSpaceConfig {
+    id: string;
+    name: string;
+    description?: string;
+    initials?: string;
+    color?: string;
+    disabledFeatures?: string[];
+    solution?: string;
+    imageUrl?: string;
+}
+/**
+ * @module integrations/kibana/types
+ * @summary Kibana configuration and payload types.
+ * @description Shared type definitions for Kibana provisioning services and setup payloads.
+ */
+export interface KibanaDataViewConfig {
+    id: string;
+    name: string;
+    title: string;
+    timeFieldName?: string;
+    namespaces?: string[];
+    sourceFilters?: Array<{
+        value: string;
+    }>;
+    runtimeFieldMap?: Record<string, unknown>;
+    fieldAttrs?: Record<string, unknown>;
+    allowNoIndex?: boolean;
+}
+export interface KibanaRoleConfig {
+    name: string;
+    indices?: Array<{
+        names: string[];
+        privileges: string[];
+        allow_restricted_indices?: boolean;
+    }>;
+    applications?: Array<{
+        application: string;
+        privileges: string[];
+        resources: string[];
+    }>;
+    kibana?: Array<{
+        base?: string[];
+        feature?: Record<string, string[]>;
+        spaces?: string[];
+    }>;
+    metadata?: Record<string, unknown>;
+}
+export interface KibanaSetupConfig {
+    id: string;
+    host: string;
+    es_host: string;
+    protocol: "http" | "https";
+    realm: string;
+    space?: Partial<KibanaSpaceConfig>;
+    dataViews?: KibanaDataViewConfig[];
+    role?: Partial<KibanaRoleConfig>;
+    dashboards?: KibanaDashboardTargets;
+    adminApiUser?: KibanaUser;
+    realmApiUser: KibanaUser;
+    dashboardImportPath?: string;
+    dashboardImportOverwrite?: boolean;
+    assets?: string;
+}

package/lib/types/nest/authService.d.cts

@@ -0,0 +1,9 @@
+import type { KeycloakAccessTokenPayload, KeycloakUser } from "./types.d.cts";
+export declare class AuthService {
+    getTokenPayload(jwt: string): KeycloakAccessTokenPayload | null;
+    getRoles(jwt: string): string[];
+    getUser(jwt: string): KeycloakUser | undefined;
+    extractKeycloakRoles(payload: unknown): string[];
+    getRealmFromIssuer(jwt: string): string;
+    assertValidToken(jwt: string): KeycloakAccessTokenPayload;
+}

package/lib/types/nest/authService.d.mts

@@ -0,0 +1,9 @@
+import type { KeycloakAccessTokenPayload, KeycloakUser } from "./types.d.mts";
+export declare class AuthService {
+    getTokenPayload(jwt: string): KeycloakAccessTokenPayload | null;
+    getRoles(jwt: string): string[];
+    getUser(jwt: string): KeycloakUser | undefined;
+    extractKeycloakRoles(payload: unknown): string[];
+    getRealmFromIssuer(jwt: string): string;
+    assertValidToken(jwt: string): KeycloakAccessTokenPayload;
+}

package/lib/types/nest/index.d.cts

@@ -0,0 +1,11 @@
+export * from "./types.d.cts";
+export * from "./utils.d.cts";
+export * from "./authService.d.cts";
+export * from "./keycloakAuthHandler.d.cts";
+export * from "./keycloakModule.d.cts";
+/**
+ * @summary Nest-style auth integrations.
+ * @description Framework-agnostic auth helpers compatible with Decaf request context handling.
+ * @namespace nest
+ * @memberOf module:integrations
+ */

package/lib/types/nest/index.d.mts

@@ -0,0 +1,11 @@
+export * from "./types.d.mts";
+export * from "./utils.d.mts";
+export * from "./authService.d.mts";
+export * from "./keycloakAuthHandler.d.mts";
+export * from "./keycloakModule.d.mts";
+/**
+ * @summary Nest-style auth integrations.
+ * @description Framework-agnostic auth helpers compatible with Decaf request context handling.
+ * @namespace nest
+ * @memberOf module:integrations
+ */

package/lib/types/nest/keycloakAuthHandler.d.cts

@@ -0,0 +1,7 @@
+import type { AuthExecutionContextLike } from "./types.d.cts";
+import { AuthService } from "./authService.d.cts";
+export declare class KeycloakAuthHandler {
+    private readonly authService;
+    constructor(authService?: AuthService);
+    authorize(context: AuthExecutionContextLike): Promise<void>;
+}

package/lib/types/nest/keycloakAuthHandler.d.mts

@@ -0,0 +1,7 @@
+import type { AuthExecutionContextLike } from "./types.d.mts";
+import { AuthService } from "./authService.d.mts";
+export declare class KeycloakAuthHandler {
+    private readonly authService;
+    constructor(authService?: AuthService);
+    authorize(context: AuthExecutionContextLike): Promise<void>;
+}

package/lib/types/nest/keycloakModule.d.cts

@@ -0,0 +1,15 @@
+/**
+ * @module integrations/nest/keycloakModule
+ * @summary Nest module wiring for Keycloak auth.
+ * @description Exposes the Nest module setup for the integration auth service and Keycloak handler.
+ */
+import { AuthService } from "./authService.d.cts";
+import { KeycloakAuthHandler } from "./keycloakAuthHandler.d.cts";
+export declare class KeycloakModule {
+    readonly authService: AuthService;
+    readonly authHandler: KeycloakAuthHandler;
+    constructor(authService?: AuthService, authHandler?: KeycloakAuthHandler);
+    static create(): KeycloakModule;
+}
+export declare class AuthModule extends KeycloakModule {
+}

package/lib/types/nest/keycloakModule.d.mts

@@ -0,0 +1,15 @@
+/**
+ * @module integrations/nest/keycloakModule
+ * @summary Nest module wiring for Keycloak auth.
+ * @description Exposes the Nest module setup for the integration auth service and Keycloak handler.
+ */
+import { AuthService } from "./authService.d.mts";
+import { KeycloakAuthHandler } from "./keycloakAuthHandler.d.mts";
+export declare class KeycloakModule {
+    readonly authService: AuthService;
+    readonly authHandler: KeycloakAuthHandler;
+    constructor(authService?: AuthService, authHandler?: KeycloakAuthHandler);
+    static create(): KeycloakModule;
+}
+export declare class AuthModule extends KeycloakModule {
+}