@cognigy/rest-api-client 0.20.0 → 4.94.0

package/dist/esm/shared/charts/descriptors/apps/initAppSession.js

@@ -0,0 +1,482 @@
+import { __awaiter } from "tslib";
+/* Custom modules */
+import { createNodeDescriptor } from "../../createNodeDescriptor";
+import { buildAppUrl } from "./utils/buildAppUrl";
+/**
+ * Node name: 'initAppSession'
+ *
+ * Purpose:
+ * Initializes a new Cognigy App Session.
+ */
+export const INIT_APP_SESSION = createNodeDescriptor({
+    type: "initAppSession",
+    defaultLabel: "xApp: Init Session",
+    summary: "UI__NODE_EDITOR__INIT_APP_SESSION__SUMMARY",
+    appearance: {
+        showIcon: false,
+    },
+    fields: [
+        // Style Customization
+        {
+            type: "cognigyText",
+            key: "backgroundColor",
+            label: "UI__NODE_EDITOR__INIT_APP_SESSION__BACKGROUND_COLOR__LABEL",
+            description: "UI__NODE_EDITOR__INIT_APP_SESSION__BACKGROUND_COLOR__DESCRIPTION",
+        },
+        {
+            type: "cognigyText",
+            key: "textColor",
+            label: "UI__NODE_EDITOR__INIT_APP_SESSION__TEXT_COLOR__LABEL",
+            description: "UI__NODE_EDITOR__INIT_APP_SESSION__TEXT_COLOR__DESCRIPTION",
+        },
+        {
+            type: "select",
+            key: "logo",
+            label: "UI__NODE_EDITOR__INIT_APP_SESSION__LOGO__LABEL",
+            description: "UI__NODE_EDITOR__INIT_APP_SESSION__LOGO__DESCRIPTION",
+            params: {
+                options: [
+                    {
+                        label: "UI__NODE_EDITOR__INIT_APP_SESSION__LOGO__DEFAULT__LABEL",
+                        value: "default",
+                    },
+                    {
+                        label: "UI__NODE_EDITOR__INIT_APP_SESSION__LOGO__NONE__LABEL",
+                        value: "none",
+                    },
+                    {
+                        label: "UI__NODE_EDITOR__INIT_APP_SESSION__LOGO__CUSTOM__LABEL",
+                        value: "custom",
+                    },
+                ],
+            },
+            defaultValue: "default",
+        },
+        {
+            type: "cognigyText",
+            key: "logoUrl",
+            label: "UI__NODE_EDITOR__INIT_APP_SESSION__LOGO_URL__LABEL",
+            description: "UI__NODE_EDITOR__INIT_APP_SESSION__LOGO_URL__DESCRIPTION",
+            condition: {
+                key: "logo",
+                value: "custom",
+            },
+        },
+        {
+            type: "cognigyText",
+            key: "faviconUrl",
+            label: "UI__NODE_EDITOR__INIT_APP_SESSION__FAVICON_URL__LABEL",
+            description: "UI__NODE_EDITOR__INIT_APP_SESSION__FAVICON_URL__DESCRIPTION",
+            params: {
+                maxLength: 256,
+            },
+        },
+        {
+            type: "cognigyText",
+            key: "pageTitle",
+            label: "UI__NODE_EDITOR__INIT_APP_SESSION__PAGE_TITLE__LABEL",
+            description: "UI__NODE_EDITOR__INIT_APP_SESSION__PAGE_TITLE__DESCRIPTION",
+            params: {
+                maxLength: 256,
+            },
+        },
+        // App Pages
+        {
+            type: "description",
+            key: "appSectionDescription",
+            label: " ",
+            params: {
+                text: "UI__NODE_EDITOR__INIT_APP_SESSION__APP_SECTION_DESCRIPTION__TEXT",
+            },
+        },
+        {
+            type: "cognigyText",
+            key: "appLoadingText",
+            label: "UI__NODE_EDITOR__INIT_APP_SESSION__APP_LOADING_TEXT__LABEL",
+            description: "UI__NODE_EDITOR__INIT_APP_SESSION__APP_LOADING_TEXT__DESCRIPTION",
+            params: {
+                maxLength: 256,
+            },
+        },
+        {
+            type: "cognigyText",
+            key: "appLaunchErrorText",
+            label: "UI__NODE_EDITOR__INIT_APP_SESSION__APP_LAUNCH_ERROR_TEXT__LABEL",
+            description: "UI__NODE_EDITOR__INIT_APP_SESSION__APP_LAUNCH_ERROR_TEXT__DESCRIPTION",
+            params: {
+                maxLength: 256,
+            },
+        },
+        {
+            type: "cognigyText",
+            key: "appErrorText",
+            label: "UI__NODE_EDITOR__INIT_APP_SESSION__APP_ERROR_TEXT__LABEL",
+            description: "UI__NODE_EDITOR__INIT_APP_SESSION__APP_ERROR_TEXT__DESCRIPTION",
+            params: {
+                maxLength: 256,
+            },
+        },
+        // Intermediate Screen
+        {
+            type: "description",
+            key: "intermediateScreenDescription",
+            label: " ",
+            params: {
+                text: "UI__NODE_EDITOR__INIT_APP_SESSION__INTERMEDIATE_SCREEN_DESCRIPTION__TEXT",
+            },
+        },
+        {
+            type: "select",
+            key: "intermediateScreenCustomizationType",
+            label: "UI__NODE_EDITOR__INIT_APP_SESSION__INTERMEDIATE_SCREEN_CUSTOMIZATION_TYPE__LABEL",
+            params: {
+                options: [
+                    {
+                        label: "UI__NODE_EDITOR__INIT_APP_SESSION__INTERMEDIATE_SCREEN_CUSTOMIZATION_TYPE__NONE__LABEL",
+                        value: "none",
+                    },
+                    {
+                        label: "UI__NODE_EDITOR__INIT_APP_SESSION__INTERMEDIATE_SCREEN_CUSTOMIZATION_TYPE__OVERRIDE__LABEL",
+                        value: "override",
+                    },
+                    {
+                        label: "UI__NODE_EDITOR__INIT_APP_SESSION__INTERMEDIATE_SCREEN_CUSTOMIZATION_TYPE__APP__LABEL",
+                        value: "app",
+                    },
+                ],
+            },
+            defaultValue: "none",
+        },
+        // Intermediate Screen - Override
+        {
+            type: "cognigyText",
+            key: "intermediateScreenOverrideText",
+            label: "UI__NODE_EDITOR__INIT_APP_SESSION__INTERMEDIATE_SCREEN_OVERRIDE_TEXT__LABEL",
+            description: "UI__NODE_EDITOR__INIT_APP_SESSION__INTERMEDIATE_SCREEN_OVERRIDE_TEXT__DESCRIPTION",
+            defaultValue: "Nothing to do...",
+            condition: {
+                key: "intermediateScreenCustomizationType",
+                value: "override",
+            },
+            params: {
+                maxLength: 256,
+            },
+        },
+        // Intermediate Screen - Custom App
+        {
+            type: "cognigyText",
+            key: "intermediateScreenAppTemplateId",
+            label: "UI__NODE_EDITOR__INIT_APP_SESSION__INTERMEDIATE_SCREEN_APP_TEMPLATE_ID__LABEL",
+            description: "UI__NODE_EDITOR__INIT_APP_SESSION__INTERMEDIATE_SCREEN_APP_TEMPLATE_ID__DESCRIPTION",
+            defaultValue: "",
+            condition: {
+                key: "intermediateScreenCustomizationType",
+                value: "app",
+            },
+            params: {
+                required: true,
+            },
+        },
+        {
+            type: "json",
+            key: "intermediateScreenAppTemplateData",
+            label: "UI__NODE_EDITOR__INIT_APP_SESSION__INTERMEDIATE_SCREEN_APP_TEMPLATE_DATA__LABEL",
+            description: "UI__NODE_EDITOR__INIT_APP_SESSION__INTERMEDIATE_SCREEN_APP_TEMPLATE_DATA__DESCRIPTION",
+            defaultValue: "{}",
+            condition: {
+                key: "intermediateScreenCustomizationType",
+                value: "app",
+            },
+        },
+        // Connection Screen
+        {
+            type: "description",
+            key: "connectionScreenDescription",
+            label: " ",
+            params: {
+                text: "UI__NODE_EDITOR__INIT_APP_SESSION__CONNECTION_SCREEN_DESCRIPTION__TEXT",
+            },
+        },
+        {
+            type: "select",
+            key: "connectionScreenCustomizationType",
+            label: "UI__NODE_EDITOR__INIT_APP_SESSION__CONNECTION_SCREEN_CUSTOMIZATION_TYPE__LABEL",
+            params: {
+                options: [
+                    {
+                        label: "UI__NODE_EDITOR__INIT_APP_SESSION__CONNECTION_SCREEN_CUSTOMIZATION_TYPE__NONE__LABEL",
+                        value: "none",
+                    },
+                    {
+                        label: "UI__NODE_EDITOR__INIT_APP_SESSION__CONNECTION_SCREEN_CUSTOMIZATION_TYPE__OVERRIDE__LABEL",
+                        value: "override",
+                    },
+                    {
+                        label: "UI__NODE_EDITOR__INIT_APP_SESSION__CONNECTION_SCREEN_CUSTOMIZATION_TYPE__APP__LABEL",
+                        value: "app",
+                    },
+                ],
+            },
+            defaultValue: "none",
+        },
+        // Connection Screen - Override
+        {
+            type: "cognigyText",
+            key: "connectionScreenOverrideConnectingText",
+            label: "UI__NODE_EDITOR__INIT_APP_SESSION__CONNECTION_SCREEN_OVERRIDE_CONNECTING_TEXT__LABEL",
+            description: "UI__NODE_EDITOR__INIT_APP_SESSION__CONNECTION_SCREEN_OVERRIDE_CONNECTING_TEXT__DESCRIPTION",
+            defaultValue: "Connecting...",
+            condition: {
+                key: "connectionScreenCustomizationType",
+                value: "override",
+            },
+            params: {
+                maxLength: 256,
+            },
+        },
+        {
+            type: "cognigyText",
+            key: "connectionScreenOverrideInvalidText",
+            label: "UI__NODE_EDITOR__INIT_APP_SESSION__CONNECTION_SCREEN_OVERRIDE_INVALID_TEXT__LABEL",
+            description: "UI__NODE_EDITOR__INIT_APP_SESSION__CONNECTION_SCREEN_OVERRIDE_INVALID_TEXT__DESCRIPTION",
+            defaultValue: "This session does not exist or is no longer active.",
+            condition: {
+                key: "connectionScreenCustomizationType",
+                value: "override",
+            },
+            params: {
+                maxLength: 256,
+            },
+        },
+        {
+            type: "cognigyText",
+            key: "connectionScreenOverrideUnavailableText",
+            label: "UI__NODE_EDITOR__INIT_APP_SESSION__CONNECTION_SCREEN_OVERRIDE_UNAVAILABLE_TEXT__LABEL",
+            description: "UI__NODE_EDITOR__INIT_APP_SESSION__CONNECTION_SCREEN_OVERRIDE_UNAVAILABLE_TEXT__DESCRIPTION",
+            defaultValue: "The application is not available right now.",
+            condition: {
+                key: "connectionScreenCustomizationType",
+                value: "override",
+            },
+            params: {
+                maxLength: 256,
+            },
+        },
+        // Connection Screen - Custom App
+        {
+            type: "cognigyText",
+            key: "connectionScreenAppTemplateId",
+            label: "UI__NODE_EDITOR__INIT_APP_SESSION__CONNECTION_SCREEN_APP_TEMPLATE_ID__LABEL",
+            description: "UI__NODE_EDITOR__INIT_APP_SESSION__CONNECTION_SCREEN_APP_TEMPLATE_ID__DESCRIPTION",
+            defaultValue: "",
+            condition: {
+                key: "connectionScreenCustomizationType",
+                value: "app",
+            },
+            params: {
+                required: true,
+            },
+        },
+        {
+            type: "json",
+            key: "connectionScreenAppTemplateData",
+            label: "UI__NODE_EDITOR__INIT_APP_SESSION__CONNECTION_SCREEN_APP_TEMPLATE_DATA__LABEL",
+            description: "UI__NODE_EDITOR__INIT_APP_SESSION__CONNECTION_SCREEN_APP_TEMPLATE_DATA__DESCRIPTION",
+            defaultValue: "{}",
+            condition: {
+                key: "connectionScreenCustomizationType",
+                value: "app",
+            },
+        },
+    ],
+    sections: [
+        {
+            label: "UI__NODE_EDITOR__INIT_APP_SESSION__STYLE_SECTION__LABEL",
+            key: "styleSection",
+            fields: [
+                "backgroundColor",
+                "textColor",
+                "errorTextColor",
+                "logo",
+                "logoUrl",
+                "faviconUrl",
+                "pageTitle",
+            ],
+            defaultCollapsed: false,
+        },
+        {
+            label: "UI__NODE_EDITOR__INIT_APP_SESSION__APP_SCREENS_SECTION__LABEL",
+            key: "appScreensSection",
+            fields: ["appLoadingText", "appLaunchErrorText", "appErrorText"],
+            defaultCollapsed: false,
+        },
+        {
+            label: "UI__NODE_EDITOR__INIT_APP_SESSION__INTERMEDIATE_SCREEN_SECTION__LABEL",
+            key: "intermediateScreenSection",
+            fields: [
+                "intermediateScreenDescription",
+                "intermediateScreenCustomizationType",
+                "intermediateScreenOverrideText",
+                "intermediateScreenAppTemplateId",
+                "intermediateScreenAppTemplateData",
+            ],
+            defaultCollapsed: false,
+        },
+        {
+            label: "UI__NODE_EDITOR__INIT_APP_SESSION__CONNECTION_SCREEN_SECTION__LABEL",
+            key: "connectionScreenSection",
+            fields: [
+                "connectionScreenDescription",
+                "connectionScreenCustomizationType",
+                "connectionScreenOverrideConnectingText",
+                "connectionScreenOverrideInvalidText",
+                "connectionScreenOverrideUnavailableText",
+                "connectionScreenAppTemplateId",
+                "connectionScreenAppTemplateData",
+            ],
+            defaultCollapsed: false,
+        },
+    ],
+    form: [
+        {
+            type: "section",
+            key: "styleSection",
+        },
+        {
+            type: "section",
+            key: "appScreensSection",
+        },
+        {
+            type: "section",
+            key: "intermediateScreenSection",
+        },
+        {
+            type: "section",
+            key: "connectionScreenSection",
+        },
+    ],
+    tags: ["basic", "apps", "xApps"],
+    tokens: [
+        {
+            type: "input",
+            label: "UI__NODE_EDITOR__INIT_APP_SESSION__TOKEN_XAPP_SESSION_URL__LABEL",
+            script: "input.apps.url || ''",
+        },
+    ],
+    function: ({ cognigy, config }) => __awaiter(void 0, void 0, void 0, function* () {
+        var _a;
+        const { api, input } = cognigy;
+        const { 
+        // styling
+        backgroundColor, textColor, errorTextColor, logo, logoUrl, faviconUrl, pageTitle, 
+        // apps screen
+        appLoadingText, appLaunchErrorText, appErrorText, 
+        // intermediate screen
+        intermediateScreenCustomizationType, intermediateScreenOverrideText, intermediateScreenAppTemplateId, intermediateScreenAppTemplateData, 
+        // status screen
+        connectionScreenCustomizationType, connectionScreenOverrideConnectingText, connectionScreenOverrideInvalidText, connectionScreenOverrideUnavailableText, connectionScreenAppTemplateId, connectionScreenAppTemplateData, } = config;
+        const style = (() => {
+            const ret = {};
+            if (backgroundColor !== "" && backgroundColor !== undefined) {
+                ret.backgroundColor = backgroundColor;
+            }
+            if (textColor !== "" && textColor !== undefined) {
+                ret.textColor = textColor;
+            }
+            if (errorTextColor !== "" && errorTextColor !== undefined) {
+                ret.errorTextColor = errorTextColor;
+            }
+            if (faviconUrl) {
+                ret.faviconUrl = faviconUrl;
+            }
+            if (pageTitle) {
+                ret.pageTitle = pageTitle;
+            }
+            switch (logo) {
+                case "none":
+                    ret.logoUrl = null;
+                    break;
+                case "custom":
+                    if (logoUrl !== "" && logoUrl !== undefined) {
+                        ret.logoUrl = logoUrl;
+                    }
+                    break;
+                default:
+                case "default":
+                    break;
+            }
+            return ret;
+        })();
+        const appScreenCustomization = {
+            loadingText: appLoadingText,
+            launchErrorText: appLaunchErrorText,
+            appErrorText: appErrorText,
+        };
+        const intermediateScreenCustomization = (() => {
+            switch (intermediateScreenCustomizationType) {
+                case "override": {
+                    return {
+                        type: "regular",
+                        idleText: intermediateScreenOverrideText || "",
+                        // TODO successText
+                    };
+                }
+                case "app": {
+                    return {
+                        type: "app",
+                        appTemplateUrl: intermediateScreenAppTemplateId,
+                        appTemplateData: intermediateScreenAppTemplateData,
+                    };
+                }
+                case "none":
+                default: {
+                    return undefined;
+                }
+            }
+        })();
+        const statusScreenCustomization = (() => {
+            switch (connectionScreenCustomizationType) {
+                case "override": {
+                    return {
+                        type: "regular",
+                        connectingText: connectionScreenOverrideConnectingText || "",
+                        invalidTokenText: connectionScreenOverrideInvalidText || "",
+                        unavailableText: connectionScreenOverrideUnavailableText || "",
+                        // TODO connectionErrorText
+                    };
+                }
+                case "app": {
+                    return {
+                        type: "app",
+                        appTemplateUrl: connectionScreenAppTemplateId,
+                        appTemplateData: connectionScreenAppTemplateData,
+                    };
+                }
+                case "none":
+                default: {
+                    return undefined;
+                }
+            }
+        })();
+        const customization = (() => {
+            // TODO filter empty values
+            return {
+                style: style,
+                intermediateScreen: intermediateScreenCustomization,
+                statusScreen: statusScreenCustomization,
+                appScreen: appScreenCustomization,
+            };
+        })();
+        if (!input.apps.session.token) {
+            const appSessionToken = yield api.initAppSession({
+                styleConfig: customization,
+            });
+            api.addToInput("apps.session.token", appSessionToken);
+        }
+        const finalUrl = buildAppUrl(input.apps.baseUrl, (_a = input.apps.session) === null || _a === void 0 ? void 0 : _a.token);
+        api.addToInput("apps.url", finalUrl);
+        api.addToInput("apps.customization", customization || null);
+        api.logDebugMessage(`Token: ${input.apps.session.token}<br>URL: <a href="${input.apps.url} " target="_blank">${input.apps.url}</a>`);
+    }),
+});
+//# sourceMappingURL=initAppSession.js.map

package/dist/esm/shared/charts/descriptors/apps/setAdaptiveCardAppState.js

@@ -0,0 +1,170 @@
+import { __awaiter } from "tslib";
+/* Custom modules */
+import { createNodeDescriptor } from "../../createNodeDescriptor";
+import { BaseContext } from "../../../helper/BaseContext";
+import { getXAppsOverlaySettingsFields, getXAppsOverlaySettingsSection, } from "./utils/getXAppsOverlaySettings";
+/**
+ * Node name: 'setAdaptiveCardAppState'
+ *
+ * Purpose:
+ * Set the state of an AdaptiveCard App
+ */
+export const SET_ADAPTIVE_CARD_APP_STATE = createNodeDescriptor({
+    type: "setAdaptiveCardAppState",
+    defaultLabel: "xApp: Show Adaptive Card",
+    summary: "UI__NODE_EDITOR__SET_ADAPTIVE_CARD_APP_STATE__SUMMARY",
+    appearance: {
+        showIcon: false,
+    },
+    fields: [
+        {
+            key: "card",
+            type: "json",
+            label: "UI__NODE_EDITOR__SET_ADAPTIVE_CARD_APP_STATE__CARD__LABEL",
+            description: "UI__NODE_EDITOR__SET_ADAPTIVE_CARD_APP_STATE__CARD__DESCRIPTION",
+            defaultValue: {},
+        },
+        {
+            key: "primaryColor",
+            type: "cognigyText",
+            label: "UI__NODE_EDITOR__SET_ADAPTIVE_CARD_APP_STATE__PRIMARY_COLOR__LABEL",
+            description: "UI__NODE_EDITOR__SET_ADAPTIVE_CARD_APP_STATE__PRIMARY_COLOR__DESCRIPTION",
+            defaultValue: "",
+        },
+        {
+            key: "primaryContrastColor",
+            type: "cognigyText",
+            label: "UI__NODE_EDITOR__SET_ADAPTIVE_CARD_APP_STATE__PRIMARY_CONTRAST_COLOR__LABEL",
+            description: "UI__NODE_EDITOR__SET_ADAPTIVE_CARD_APP_STATE__PRIMARY_CONTRAST_COLOR__DESCRIPTION",
+            defaultValue: "",
+        },
+        {
+            key: "waitForInput",
+            type: "toggle",
+            label: "UI__NODE_EDITOR__SET_ADAPTIVE_CARD_APP_STATE__WAIT_FOR_INPUT__LABEL",
+            defaultValue: false,
+        },
+        {
+            key: "storeResultInContext",
+            type: "toggle",
+            label: "UI__NODE_EDITOR__SET_ADAPTIVE_CARD_APP_STATE__STORE_RESULT_IN_CONTEXT__LABEL",
+            condition: {
+                key: "waitForInput",
+                value: true,
+            },
+        },
+        {
+            key: "contextKey",
+            type: "cognigyText",
+            label: "UI__NODE_EDITOR__SET_ADAPTIVE_CARD_APP_STATE__CONTEXT_KEY__LABEL",
+            defaultValue: "result",
+            condition: {
+                and: [
+                    {
+                        key: "waitForInput",
+                        value: true,
+                    },
+                    {
+                        key: "storeResultInContext",
+                        value: true,
+                    },
+                ],
+            },
+        },
+        ...getXAppsOverlaySettingsFields(),
+    ],
+    sections: [
+        {
+            key: "overrideSection",
+            defaultCollapsed: true,
+            fields: ["primaryColor", "primaryContrastColor"],
+            label: "UI__NODE_EDITOR__SET_ADAPTIVE_CARD_APP_STATE__OVERRIDE_SECTIONS__LABEL",
+        },
+        {
+            key: "waitingBehavior",
+            defaultCollapsed: true,
+            fields: ["waitForInput", "storeResultInContext", "contextKey"],
+            label: "UI__NODE_EDITOR__SET_ADAPTIVE_CARD_APP_STATE__WAITING_BEHAVIOR__LABEL",
+        },
+        getXAppsOverlaySettingsSection(),
+    ],
+    form: [
+        { type: "field", key: "card" },
+        { type: "section", key: "overrideSection" },
+        { type: "section", key: "waitingBehavior" },
+        { type: "section", key: getXAppsOverlaySettingsSection().key },
+    ],
+    tags: ["basic", "apps", "xApps"],
+    function: ({ cognigy, config, nodeId }) => __awaiter(void 0, void 0, void 0, function* () {
+        var _a, _b;
+        const { api, input, context } = cognigy;
+        const { card, primaryColor, primaryContrastColor, waitForInput, storeResultInContext, contextKey, } = config;
+        const overlaySettings = {
+            autoOpen: config.autoOpen,
+            closeOnSubmit: config.closeOnSubmit,
+            feedbackMessage: config.feedbackMessage,
+            screenTitle: config.screenTitle,
+            sendEventOnCloseIconClick: config.sendEventOnCloseIconClick,
+            showCloseIcon: config.showCloseIcon,
+        };
+        const systemContextWaitingKey = `adaptiveCardAPPWaiting-${nodeId}`;
+        const appTemplateURL = `${input.apps.baseUrl}/apps/adaptivecards/`;
+        // only set the app state once
+        if (!api.getSystemContext(systemContextWaitingKey)) {
+            api.setAppState(appTemplateURL, {
+                card,
+                primaryColor: primaryColor || undefined,
+                primaryContrastColor: primaryContrastColor || undefined
+            }, {
+                webchat3: {
+                    overlaySettingsMetaData: {
+                        overlaySettings,
+                        endpointType: input.endpointType,
+                        url: input.apps.url,
+                        URLToken: input.URLToken
+                    }
+                }
+            });
+            api.logDebugMessage(`UI__DEBUG_MODE__SET_ADAPTIVE_CARD_APP_STATE__MESSAGE`);
+        }
+        if (api.getSystemContext(systemContextWaitingKey) &&
+            contextKey &&
+            ((_b = (_a = input.data) === null || _a === void 0 ? void 0 : _a._cognigy) === null || _b === void 0 ? void 0 : _b._app)) {
+            api.deleteSystemContext(systemContextWaitingKey);
+            setxAppResult({
+                input,
+                storeResultInContext,
+                contextKey,
+                context,
+            });
+            return;
+        }
+        if (waitForInput) {
+            api.setSystemContext(systemContextWaitingKey, true);
+            api.setNextNode(nodeId);
+            api.stopExecution();
+        }
+    }),
+});
+/**
+ * Sets the result of an xApp in the context
+ */
+export const setxAppResult = (params) => {
+    var _a, _b, _c;
+    const { input, storeResultInContext, contextKey, context } = params;
+    const result = (_c = (_b = (_a = input === null || input === void 0 ? void 0 : input.data) === null || _a === void 0 ? void 0 : _a._cognigy) === null || _b === void 0 ? void 0 : _b._app) === null || _c === void 0 ? void 0 : _c.payload;
+    if (storeResultInContext) {
+        // check whether contextKey or inputKey is a deep query and set
+        // storage location accordingly
+        let location = context;
+        let target = contextKey;
+        // deep query
+        if (target.indexOf(".") > -1) {
+            const splits = target.split(".");
+            location = BaseContext.findLocationPathStateless(splits, true, location);
+            target = splits[splits.length - 1];
+        }
+        location[target] = result;
+    }
+};
+//# sourceMappingURL=setAdaptiveCardAppState.js.map

package/dist/esm/shared/charts/descriptors/apps/setAppState.js

@@ -0,0 +1,42 @@
+import { __awaiter } from "tslib";
+/* Custom modules */
+import { createNodeDescriptor } from "../../createNodeDescriptor";
+/**
+ * Node name: 'setAppState'
+ *
+ * Purpose:
+ * Set the state of a Cognigy App Template.
+ */
+export const SET_APP_STATE = createNodeDescriptor({
+    type: "setAppState",
+    defaultLabel: "xApp: Set State",
+    summary: "UI__NODE_EDITOR__SET_APP_STATE__SUMMARY",
+    appearance: {
+        showIcon: false,
+    },
+    fields: [
+        {
+            key: "appTemplateId",
+            type: "cognigyText",
+            label: "UI__NODE_EDITOR__SET_APP_STATE__APP_TEMPLATE_ID__LABEL",
+            description: "UI__NODE_EDITOR__SET_APP_STATE__APP_TEMPLATE_ID__DESCRIPTION",
+            params: {
+                required: true,
+            },
+        },
+        {
+            key: "appTemplateData",
+            type: "json",
+            label: "UI__NODE_EDITOR__SET_APP_STATE__APP_TEMPLATE_DATA__LABEL",
+            description: "UI__NODE_EDITOR__SET_APP_STATE__APP_TEMPLATE_DATA__DESCRIPTION",
+            defaultValue: "{}",
+        },
+    ],
+    tags: ["basic", "apps", "xApps"],
+    function: ({ cognigy, config }) => __awaiter(void 0, void 0, void 0, function* () {
+        const { api } = cognigy;
+        const { appTemplateId, appTemplateData } = config;
+        api.setAppState(appTemplateId, appTemplateData);
+    }),
+});
+//# sourceMappingURL=setAppState.js.map