@xapp/stentor-chat-widget 1.49.5 → 1.50.0

package/lib/WidgetEnv.d.ts

@@ -1,4 +1,5 @@
 /*! Copyright (c) 2021, XAPPmedia */
+import { Response } from "stentor-models";
 import { WidgetTheme } from "./WidgetTheme";
 export interface CtaConfig {
     readonly message: string;
@@ -87,21 +88,46 @@ export interface WidgetEnv extends WidgetEnvDeprecated {
      */
     readonly theme?: WidgetTheme;
     /**
-     *
+     * Optional configurable message that appears
      */
     readonly cta?: CtaConfig;
+    /**
+     * Optional, configure the chat button tab index
+     */
     readonly chatButton?: WidgetChatButtonConfig;
+    /**
+     * Optional, custom header configuration including messages for the widget.
+     */
     readonly header?: WidgetHeaderConfig;
+    /**
+     * Optional, configure aspects of the footer.
+     */
     readonly footer?: WidgetFooterConfig;
+    /**
+     * Optional menu configuration, add items and configure location of toggle button.
+     */
     readonly menu?: WidgetMenuConfig;
+    /**
+     * Configure input field
+     */
     readonly input?: WidgetInputConfig;
     /**
      * When set, the widget will automatically open when the screen width is wider than what is provided.  This is useful if you want to open
      * on desktop widths automatically but not on mobile.
      */
     readonly autoOpenOnWidth?: string;
+    /**
+     * Configure how the URLs within suggestion chips, markdown and list items are opened.  You can choose same window, new window or new tab.
+     */
     readonly urls?: WidgetUrlsConfig;
+    /**
+     * Configurable error messages.
+     */
     readonly configurableMessages?: WidgetConfigurableMessagesConfig;
+    /**
+     * Optional set of hooks to register with the widget to receive events.
+     */
+    readonly hooks?: WidgetHooks;
 }
 export interface WidgetConfigurableMessagesConfig {
     readonly items?: WidgetConfigurableMessageConfig[];
@@ -157,12 +183,28 @@ export interface WidgetFooterConfig {
     readonly sendButton?: WidgetSendButtonConfig;
 }
 export interface WidgetBrandingConfig {
+    /**
+     * Enable display of the branding text
+     */
     readonly enabled?: boolean;
     readonly text?: string;
 }
 export declare type WidgetMenuItems = WidgetMenuItemConfig | WidgetMenuItemStaticImage | WidgetMenuItemStaticText;
 export interface WidgetMenuConfig {
+    /**
+     * Set the location for the menu button.
+     *
+     * Defaults to "FOOTER" with a two bar icon.
+     *
+     * If set to "HEADER_LEFT" then the menu button will display in the header left position with a three bar icon.
+     */
+    readonly menuButtonLocation?: "HEADER_LEFT" | "FOOTER";
+    /**
+     * Menu items to be displayed.
+     */
     readonly items: readonly WidgetMenuItems[];
+    readonly itemsTabIndex?: string;
+    readonly button?: WidgetMenuButtonConfig;
 }
 export interface WidgetInputConfig {
     readonly placeholder?: string;
@@ -196,3 +238,16 @@ export interface WidgetChatButtonConfig {
 export interface WidgetClearButtonConfig {
     readonly tabIndex?: string;
 }
+export interface WidgetMenuButtonConfig {
+    readonly tabIndex?: string;
+}
+export interface WidgetHooks {
+    /**
+     * Optional callback when a response is received.
+     *
+     * This can be used to parse any part of the message, including additional instructions included in the response.data field.
+     *
+     * @param response
+     */
+    onResponse?(response: Response): void;
+}

package/package.json

@@ -4,7 +4,7 @@
     "publishConfig": {
         "access": "public"
     },
-    "version": "1.49.5",
+    "version": "1.50.0",
     "description": "Chat Widget channel for stentor",
     "types": "lib/index",
     "main": "lib/index",
@@ -38,5 +38,5 @@
         "build": "tsc -d true -p .",
         "clean": "rm -rf ./lib/*"
     },
-    "gitHead": "737dcd08d0a289b006a41825a9016eb4c19f1f2e"
+    "gitHead": "9c2936860632f34f43a7149343466e6e22c69138"
 }