@crowdstrike/logscale-search 1.133.0--build-1000--sha-eda0b20aa7989fb26e09b9fc1d187b51b1281400 → 1.136.0--build-1093--sha-79e81f65f3475d1356318149af241973c7f30ec4

package/index.d.ts

@@ -193,7 +193,7 @@ export declare interface DashboardParams {
      */
     end?: string;
     /** Set to true to make the dashboard `live`. Defaults to `false` */
-    isLive?: boolean;
+    live?: boolean;
     /**
      * Set to `true` to make all dashboard queries use `start` and `end` as time window.
      */
@@ -250,6 +250,35 @@ export declare type FieldColumn = {
     header?: string;
 };
 
+/**
+ * A field interaction consists of an `id` used to correlate interaction events to source `FieldInteraction`,
+ * and a `label` used to create the label in the field interaction context menu generating clicking a field on an event.
+ *
+ * The `id` field corresponds to the `interactionId` field on `FieldInteractionEventDetails`.
+ *
+ * @public
+ */
+export declare type FieldInteraction = {
+    id: string;
+    label: string;
+};
+
+/**
+ * Event details for the invocation of a `FieldInteraction`.
+ *
+ * - The `interactionId` field matches the `id` field of a `FieldInteraction`
+ * and is used to identify the source `FieldInteraction`of the event.
+ * - The `fieldName` field is the name of the field which was clicked on.
+ * - The `fieldValue` field carries the value of the field which was clicked on.
+ *
+ * @public
+ */
+export declare type FieldInteractionEventDetails = {
+    interactionId: string;
+    fieldName: string;
+    fieldValue: JsonValue;
+};
+
 /**
  * A column type for displaying all field values.
  *
@@ -285,6 +314,22 @@ export declare type InteractionCondition = {
     "argument": string;
 };
 
+/**
+ * A typed representation a JSON object.
+ *
+ * @public
+ */
+export declare type JsonObject = {
+    [key: string]: JsonValue;
+};
+
+/**
+ * A typed representation of JSON value.
+ *
+ * @public
+ */
+export declare type JsonValue = string | number | boolean | Array<JsonValue> | JsonObject;
+
 /**
  * The NavigationTarget type specifies the target of a LogScale navigation event.
  * These are handled by the `onNavigationTargetChange` hook. Sources of Navigation targets are:
@@ -306,7 +351,7 @@ export declare interface Options extends CommonOptions, SearchViewParams {
     /** Name of LogScale repository or view */
     repoOrViewName: string;
     /** Will initialize the webcomponent in light or dark mode. The theme can be switched through the `setTheme()` method after initialization. */
-    theme: 'light' | 'dark';
+    theme: "light" | "dark";
     /** If the LSP websocket server is accessed from a different URL than the `apiUrl`, you can set this. */
     lspURL?: string;
     /** If provided, this token will be passed in the Authentication header as a Bearer token.
@@ -345,6 +390,13 @@ export declare interface Options extends CommonOptions, SearchViewParams {
      * interactions panel inside LogScale.
      */
     hostInteractions?: Array<Interaction>;
+    /**
+     * Set custom field interactions available on fields of event.
+     *
+     * Implement the `onFieldInteractionInvoked` hook on the SearchView instance
+     * to react to events related to custom field interactions,
+     */
+    fieldInteractions?: Array<FieldInteraction>;
     /**
      * Hook for handling LogScale navigation targets, e.g. navigating from SearchView to Dashboard or vice versa.
      *
@@ -390,22 +442,6 @@ export declare interface Options extends CommonOptions, SearchViewParams {
     showInteractionsPanel?: boolean;
 }
 
-/**
- * A value for a visualization configuration option.
- *
- * @public
- */
-export declare type OptionValue = string | number | boolean | Array<OptionValue> | OptionValues;
-
-/**
- * Options for visualization configuration.
- *
- * @public
- */
-export declare type OptionValues = {
-    [key: string]: OptionValue;
-};
-
 /**
  * LogScale parameter values is a map with parameter ids as keys,
  * and either a string or a string array as single / multi value parameter args, respectively.
@@ -502,6 +538,14 @@ export declare type SearchNavigationTargetInfo = SearchViewParams & {
  * @public
  */
 export declare class SearchView extends WebcomponentBase<Options> {
+    /**
+     * Set the state of the SearchView.
+     *
+     * @param searchViewParams - the new search view state
+     *
+     * @public
+     */
+    setState(searchViewParams: SearchViewParams): void;
     /**
      * Set the query string of the SearchView query editor.
      *
@@ -544,6 +588,14 @@ export declare class SearchView extends WebcomponentBase<Options> {
      * @public
      */
     onSearchViewStateChanged(callback: (searchViewState: SearchNavigationTargetInfo) => void | null): void;
+    /**
+     * Implement this hook to receive notifications about invocations of `FieldInteractions` configured on `Options`.
+     *
+     * @param callback - function for handling notifications of `FieldInteraction` invocations.
+     *
+     * @public
+     */
+    onFieldInteractionInvoked(callback: (eventDetails: FieldInteractionEventDetails) => void | null): void;
 }
 
 /**
@@ -596,7 +648,7 @@ export declare interface SearchViewParams {
 export declare type SearchViewVisualization = {
     type?: WidgetType;
     /** The configuration options of a LogScale visualization. */
-    options?: OptionValues;
+    options?: JsonObject;
 };
 
 /**