@ichicraft/widgets-widget-base 1.7.11 → 1.8.2

package/README.md

@@ -8,6 +8,13 @@ All notable changes to this project will be documented here.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## 1.8.2 - 2022-07-06
+* Added `subtitle` property to the `WidgetResource` interface.
+
+## 1.8.1 - 2022-06-17
+* Added new section `analytics` to `WidgetManifestConfig` interface to allow definition of time-based events that can be raised by a widget.
+* Added `raiseEvent(...)` to the `instance` object of the `WidgetContent` interface, allowing widgets to raise an event.
+
 ## 1.7.11 - 2022-03-23
 * Added `setWidgetHeaderVisibilty()` function to the `instance` object of the `WidgetContext` interface, allowing widgets to render in full height.
 

package/lib/types/index.d.ts

@@ -63,6 +63,16 @@ export interface WidgetContext {
          * Removes the custom command bar item that was added by the [registerCommandBarItem] function
          */
         unregisterCustomCommandBarItem?: () => void;
+        /**
+         * Raises an event to be handled by the Time-based Events feature of Ichicraft Boards.
+         * @param object The object this event concerns (e.g. app, report, newsArticle, ...). Use camelCase.
+         * @param action The action that was performed to/on the object (e.g. viewed, clicked, deleted, ...). Use camelCase.
+         * @param data Optionally provide extra metadata to be included with the raised event.
+         * widgetAlias property (from manifest) and variantTitle property will automatically be added by the widget board.
+         */
+        raiseEvent?: (object: string, action: string, data?: {
+            [key: string]: string;
+        }) => void;
     };
     /**
      * Metadata and functions in the context of a widget's definition. A widget definition is
@@ -272,6 +282,7 @@ export interface WidgetImages {
 export interface WidgetResource {
     lang: number;
     title: string;
+    subtitle?: string;
     shortDescription: string;
     instructions: string;
     images: WidgetImages;
@@ -402,6 +413,30 @@ export interface WidgetManifestConfig {
             };
         };
     };
+    /**
+     * Everything related to analytics of this widget in Ichicraft Boards
+     */
+    analytics?: {
+        /**
+         * A list of time-based events this widget can raise. All the possible events MUST be
+         * described in this list for the widget board to be able to pick them up.
+         * @ref Use WidgetContext.instance.raiseEvent(object: string, action: string, data?: { [key: string]: string }) to raise these events
+         */
+        timeBasedEvents: {
+            /**
+             * The object this event concerns (e.g. app, report, newsArticle, ...). Use camelCase.
+             */
+            object: string;
+            /**
+             * The action that was performed to/on the object (e.g. viewed, clicked, deleted, ...). Use camelCase.
+             */
+            action: string;
+            /**
+             * A descriptive text used in the Administration panel to describe this event
+             */
+            description: string;
+        }[];
+    };
 }
 export declare enum DebugComponentType {
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@ichicraft/widgets-widget-base",
-    "version": "1.7.11",
+    "version": "1.8.2",
     "description": "Part of the Widget Development Kit for building widgets for Ichicraft Boards",
     "main": "lib/index.js",
     "types": "lib/index.d.ts",