@nlxai/core 1.2.4-alpha.9 → 1.2.6

package/.eslintrc.cjs

@@ -1,5 +1,5 @@
 /** @type {import('eslint').Linter.Config } */
 module.exports = {
   root: true,
-  extends: ["nlx", "nlx/documentation"],
+  extends: ["@nlxai/eslint-config", "@nlxai/eslint-config/documentation"],
 };

package/README.md

@@ -562,26 +562,60 @@ The configuration necessary to create a conversation.
 optional applicationUrl: string;
 ```
 
-The URL at which your conversational application is running.
-Fetch this from the application's API channel tab.
+The URL at which your conversational application is running. Fetch this from the application's API channel tab.
+Currently, there are a few ways to specify the application URL:
 
-##### headers
+- (recommended) leave out `applicationUrl` and specify `protocol`, `host`, `deploymentKey` and `channelKey`.
+- specify the full `applicationUrl` as well as the `protocol`.
+- (legacy) specify the `applicationUrl` generated either as an HTTP or websocket URL. Use `experimental.streamHttp` to control streaming.
+
+##### protocol?
 
 ```ts
-headers: Record<string, string> & object;
+optional protocol: Protocol;
 ```
 
-Headers to forward to the NLX API.
+Specify the protocol (http, websocket or httpWithStreaming)
 
-###### Type Declaration
+##### host?
+
+```ts
+optional host: string;
+```
+
+Hostname of the application deployment, without a leading `https://`.
+
+##### deploymentKey?
+
+```ts
+optional deploymentKey: string;
+```
+
+Deployment key.
+
+##### channelKey?
+
+```ts
+optional channelKey: string;
+```
+
+Channel key.
+
+##### apiKey?
+
+```ts
+optional apiKey: string;
+```
 
-###### nlx-api-key
+API key.
+
+##### headers?
 
 ```ts
-nlx-api-key: string;
+optional headers: Record<string, string>;
 ```
 
-The `nlx-api-key` is required. Fetch this from the application's API channel tab.
+Headers to forward to the NLX API.
 
 ##### conversationId?
 
@@ -698,7 +732,7 @@ The slots to populate
 sendChoice: (choiceId, context?, metadata?) => void;
 ```
 
-Respond to [a choice](https://docs.studio.nlx.ai/intentflows/documentation-flows/flows-build-mode/nodes#user-choice) from the application.
+Respond to [a choice](https://docs.nlx.ai/platform/nlx-platform-guide/flows-and-building-blocks/overview/nodes#user-choice) from the application.
 
 ###### Parameters
 
@@ -758,13 +792,13 @@ Trigger a specific flow.
 
 `string`
 
-the flow to trigger. The id is the name under the application's _Intents_.
+the flow to trigger. The id is the name under the application's _Flows_.
 
 ###### context?
 
 [`Context`](#context)
 
-[Context](https://docs.nlx.ai/platform/nlx-platform-guide/build-with-nlx/flows/context-variables#what-are-context-variables) for usage later in the intent.
+[Context](https://docs.nlx.ai/platform/nlx-platform-guide/build-with-nlx/flows/context-variables#what-are-context-variables) for usage later in the flow.
 
 ###### Returns
 
@@ -784,7 +818,7 @@ Send context without sending a message
 
 [`Context`](#context)
 
-[Context](https://docs.nlx.ai/platform/nlx-platform-guide/build-with-nlx/flows/context-variables#what-are-context-variables) for usage later in the intent.
+[Context](https://docs.nlx.ai/platform/nlx-platform-guide/build-with-nlx/flows/context-variables#what-are-context-variables) for usage later in the flow.
 
 ###### Returns
 
@@ -817,7 +851,7 @@ the response with optional timestamps.
 sendStructured: (request, context?) => void;
 ```
 
-Send a combination of choice, slots, and intent in one request.
+Send a combination of choice, slots, and flow in one request.
 
 ###### Parameters
 
@@ -829,7 +863,7 @@ Send a combination of choice, slots, and intent in one request.
 
 [`Context`](#context)
 
-[Context](https://docs.studio.nlx.ai/workspacesettings/documentation-settings/settings-context-attributes) for usage later in the intent.
+[Context](https://docs.nlx.ai/platform/nlx-platform-guide/flows-and-building-blocks/advanced/context-variables) for usage later in the flow.
 
 ###### Returns
 
@@ -1070,7 +1104,7 @@ Remove a listener to one of the handler's custom events
 
 ### SlotValue
 
-Values to fill an intent's [attached slots](https://docs.studio.nlx.ai/intents/documentation-intents/intents-attached-slots).
+Values to fill an flow's [attached slots](https://docs.nlx.ai/platform/nlx-platform-guide/flows-and-building-blocks/overview/setup#attached-slots).
 
 An array of `SlotValue` objects is equivalent to a [SlotsRecord](#slotsrecord).
 
@@ -1090,7 +1124,7 @@ The attached slot's name
 value: any;
 ```
 
-Usually this will be a discrete value matching the slots's [type](https://docs.studio.nlx.ai/slots/documentation-slots/slots-values#system-slots).
+Usually this will be a discrete value matching the slots's [type](https://docs.nlx.ai/platform/nlx-platform-guide/flows-and-building-blocks/overview/setup#custom-vs-built-in-slots).
 for custom slots, this can optionally be the value's ID.
 
 ---
@@ -1178,7 +1212,7 @@ as well as whether the client should poll for more application responses.
 optional payload: string;
 ```
 
-If configured, the [node's payload.](See: https://docs.studio.nlx.ai/intentflows/documentation-flows/flows-build-mode/advanced-messaging-+-functionality#add-functionality)
+If configured, the [node's payload](https://docs.nlx.ai/platform/nlx-platform-guide/flows-and-building-blocks/overview/nodes#node-payload).
 
 ##### modalities?
 
@@ -1211,7 +1245,7 @@ as well as whether the client should poll for more application responses.
 optional intentId: string;
 ```
 
-The conversation's intent
+The conversation's flow ID (called `intentId` here for legacy reasons).
 
 ##### escalation?
 
@@ -1342,7 +1376,7 @@ as well as whether the client should poll for more application responses.
 optional intentId: string;
 ```
 
-The message node's intent
+The message node's flow ID (called `intentId` here for legacy reasons).
 
 ---
 
@@ -1655,7 +1689,7 @@ Label for comment
 ### StructuredRequest
 
 The body of `sendStructured`
-Includes a combination of choice, slots, and intent in one request.
+Includes a combination of choice, slots, and flow in one request.
 
 #### Properties
 
@@ -1871,13 +1905,25 @@ optional nodeId: string;
 Required if you want to change a choice that's already been sent.
 The `nodeId` can be found in the corresponding [ApplicationMessage](#applicationmessage).
 
-##### intentId?
+##### ~~intentId?~~
 
 ```ts
 optional intentId: string;
 ```
 
-Intent ID, used for sending to the NLU to allow it to double-check
+Intent ID, used for sending to the NLU to allow it to double-check.
+
+###### Deprecated
+
+use `flowId` instead.
+
+##### flowId?
+
+```ts
+optional flowId: string;
+```
+
+Flow ID, used for sending to the NLU to allow it to double-check.
 
 ---
 
@@ -1921,6 +1967,38 @@ Interim message event handler
 
 ## Enumerations
 
+### Protocol
+
+The protocol used to communicate with the application
+
+#### Enumeration Members
+
+##### Https
+
+```ts
+Https: "https";
+```
+
+Regular encrypted HTTPS, without support for post-escalation message handling, interim messages and other streaming features.
+
+##### HttpsWithStreaming
+
+```ts
+HttpsWithStreaming: "httpsWithStreaming";
+```
+
+Encrypted HTTPS with streaming enabled. This is the default setting and supports interim messages. Does not support post-escalation message handling.
+
+##### Websocket
+
+```ts
+Websocket: "websocket";
+```
+
+Websocket, with support for post-escalation message handling.
+
+---
+
 ### ResponseType
 
 Response type
@@ -1970,7 +2048,7 @@ voicePlusCommand
 type Context = Record<string, any>;
 ```
 
-[Context](https://docs.studio.nlx.ai/workspacesettings/documentation-settings/settings-context-attributes) for usage later in the intent.
+[Context](https://docs.nlx.ai/platform/nlx-platform-guide/flows-and-building-blocks/advanced/context-variables) for usage later in the flow.
 
 ---
 
@@ -1980,11 +2058,11 @@ type Context = Record<string, any>;
 type SlotsRecord = Record<string, any>;
 ```
 
-Values to fill an intent's [attached slots](https://docs.studio.nlx.ai/intents/documentation-intents/intents-attached-slots).
+Values to fill an flow's [attached slots](https://docs.nlx.ai/platform/nlx-platform-guide/flows-and-building-blocks/overview/setup#attached-slots).
 
 `SlotRecord` Keys are the attached slot's name
 
-`SlotRecord` Values are usually a discrete value matching the slots's [type](https://docs.studio.nlx.ai/slots/documentation-slots/slots-values#system-slots).
+`SlotRecord` Values are usually a discrete value matching the slots's [type](https://docs.nlx.ai/platform/nlx-platform-guide/flows-and-building-blocks/overview/setup#custom-vs-built-in-slots).
 for custom slots, this can optionally be the value's ID.
 
 A `SlotsRecord` is equivalent to an array of [SlotValue](#slotvalue) objects.
@@ -1997,7 +2075,7 @@ A `SlotsRecord` is equivalent to an array of [SlotValue](#slotvalue) objects.
 type SlotsRecordOrArray = SlotsRecord | SlotValue[];
 ```
 
-Values to fill an intent's [attached slots](https://docs.studio.nlx.ai/intents/documentation-intents/intents-attached-slots).
+Values to fill an intent's [attached slots](https://docs.nlx.ai/platform/nlx-platform-guide/flows-and-building-blocks/overview/setup#attached-slots).
 
 Supports either a [SlotsRecord](#slotsrecord) or an array of [SlotValue](#slotvalue) objects
 
@@ -2064,7 +2142,7 @@ The user's message
 optional context: Context;
 ```
 
-[Context](https://docs.studio.nlx.ai/workspacesettings/documentation-settings/settings-context-attributes) for usage later in the intent.
+[Context](https://docs.nlx.ai/platform/nlx-platform-guide/flows-and-building-blocks/advanced/context-variables) for usage later in the flow.
 
 ```ts
 {
@@ -2097,7 +2175,7 @@ Correlates to a `choiceId` in the [ApplicationResponse](#applicationresponse)'s
 optional context: Context;
 ```
 
-[Context](https://docs.studio.nlx.ai/workspacesettings/documentation-settings/settings-context-attributes) for usage later in the intent.
+[Context](https://docs.nlx.ai/platform/nlx-platform-guide/flows-and-building-blocks/advanced/context-variables) for usage later in the flow.
 
 `object` & [`StructuredRequest`](#structuredrequest)
 

package/lib/index.cjs

@@ -6,7 +6,7 @@ var ReconnectingWebSocket = require('reconnecting-websocket');
 var uuid = require('uuid');
 
 var name = "@nlxai/core";
-var version$1 = "1.2.4-alpha.9";
+var version$1 = "1.2.6";
 var description = "Low-level SDK for building NLX experiences";
 var type = "module";
 var main = "lib/index.cjs";
@@ -34,20 +34,20 @@ var scripts = {
 var author = "Peter Szerzo <peter@nlx.ai>";
 var license = "MIT";
 var devDependencies = {
+	"@nlxai/eslint-config": "*",
+	"@nlxai/rollup-config": "*",
 	"@rollup/plugin-commonjs": "^25.0.7",
-	"@rollup/plugin-json": "^6.0.1",
+	"@rollup/plugin-json": "^6.1.0",
 	"@rollup/plugin-node-resolve": "^15.2.3",
 	"@rollup/plugin-replace": "^5.0.5",
 	"@rollup/plugin-terser": "^0.4.4",
-	"@rollup/plugin-typescript": "^11.1.5",
+	"@rollup/plugin-typescript": "^11.1.6",
 	"@types/isomorphic-fetch": "^0.0.39",
 	"@types/node": "^24.10.1",
 	"@types/ramda": "0.31.1",
 	"@types/uuid": "^9.0.7",
-	"eslint-config-nlx": "*",
 	prettier: "^3.1.0",
-	rollup: "^4.3.0",
-	"rollup-config-nlx": "*",
+	rollup: "^4.59.0",
 	"rollup-plugin-node-polyfills": "^0.2.1",
 	typedoc: "^0.28.14",
 	"typedoc-plugin-markdown": "^4.9.0",
@@ -62,7 +62,7 @@ var dependencies = {
 var publishConfig = {
 	access: "public"
 };
-var gitHead = "a749667b96b11c1d187e9f0447abb2ebc755094c";
+var gitHead = "fb9a0b00ca2184fb69ffd1e11e8f55d30fe1d85e";
 var packageJson = {
 	name: name,
 	version: version$1,
@@ -93,6 +93,10 @@ const Console = console;
  */
 exports.Protocol = void 0;
 (function (Protocol) {
+    /**
+     * Supported for development purposes only
+     */
+    Protocol["Http"] = "http";
     /**
      * Regular encrypted HTTPS, without support for post-escalation message handling, interim messages and other streaming features.
      */
@@ -152,48 +156,82 @@ const safeJsonParse = (val) => {
         return null;
     }
 };
-const getBaseDomain = (url) => url.match(/(bots\.dev\.studio\.nlx\.ai|bots\.studio\.nlx\.ai|apps\.nlx\.ai|dev\.apps\.nlx\.ai)/g)?.[0] ?? "apps.nlx.ai";
+const getHost = (url) => url.match(/(bots\.dev\.studio\.nlx\.ai|bots\.studio\.nlx\.ai|apps\.nlx\.ai|dev\.apps\.nlx\.ai)/g)?.[0] ?? "apps.nlx.ai";
 /**
- * When a HTTP URL is provided, deduce the websocket URL. Otherwise, return the argument.
- * @param applicationUrl - the websocket URL
- * @returns httpUrl - the HTTP URL
+ * Parse configuration into structured connection information, taking into account `applicationUrl`-based configs.
+ * @param config - client configuration.
+ * @returns connection - connection information, or `null` if the configuration is invalid.
  */
-const normalizeToWebsocket = (applicationUrl) => {
+const parseConnection = (config) => {
+    const applicationUrl = config.applicationUrl ?? "";
+    const apiKey = config.apiKey ?? config.headers?.["nlx-api-key"] ?? "";
+    const protocol = config.protocol ??
+        /**
+         * Backwards-compatibility: if a websocket URL was specified, assume it's websocket. Otherwise, look at the legacy experimental streamsetting
+         * and only assume non-streaming if it's explicitly set to false.
+         */
+        (isWebsocketUrl(applicationUrl)
+            ? exports.Protocol.Websocket
+            : config.experimental?.streamHttp === false
+                ? exports.Protocol.Https
+                : exports.Protocol.HttpsWithStreaming);
+    if (config.host != null &&
+        config.channelKey != null &&
+        config.deploymentKey != null) {
+        return {
+            protocol,
+            apiKey,
+            host: config.host,
+            channelKey: config.channelKey,
+            deploymentKey: config.deploymentKey,
+        };
+    }
+    // `applicationUrl`-based definition: websocket case
     if (isWebsocketUrl(applicationUrl)) {
-        return applicationUrl;
+        const host = getHost(applicationUrl);
+        const url = new URL(applicationUrl);
+        const params = new URLSearchParams(url.search);
+        const channelKey = params.get("channelKey");
+        const deploymentKey = params.get("deploymentKey");
+        if (channelKey != null && deploymentKey != null) {
+            return { protocol, channelKey, deploymentKey, host, apiKey };
+        }
+        return null;
     }
-    const base = getBaseDomain(applicationUrl);
-    const url = new URL(applicationUrl);
-    const pathChunks = url.pathname.split("/");
-    const deploymentKey = pathChunks[2];
-    const channelKey = pathChunks[3];
-    return `wss://us-east-1-ws.${base}?deploymentKey=${deploymentKey}&channelKey=${channelKey}`;
-};
-/**
- * When a websocket URL is provided, deduce the HTTP URL. Otherwise, return the argument.
- * @param applicationUrl - the websocket URL
- * @returns httpUrl - the HTTP URL
- */
-const normalizeToHttp = (applicationUrl) => {
-    if (!isWebsocketUrl(applicationUrl)) {
-        return applicationUrl;
+    // `applicationUrl`-based definition: http case
+    const urlObject = new URL(applicationUrl);
+    const host = urlObject.host;
+    const parseResult = new URLPattern({
+        pathname: "/c/:deploymentKey/:channelKey",
+    }).exec(applicationUrl);
+    if (parseResult?.pathname.groups.channelKey != null &&
+        parseResult?.pathname.groups.deploymentKey != null) {
+        return {
+            protocol: urlObject.protocol === "http:" ? exports.Protocol.Http : protocol,
+            channelKey: parseResult.pathname.groups.channelKey,
+            deploymentKey: parseResult.pathname.groups.deploymentKey,
+            host,
+            apiKey,
+        };
     }
-    const base = getBaseDomain(applicationUrl);
-    const url = new URL(applicationUrl);
-    const params = new URLSearchParams(url.search);
-    const channelKey = params.get("channelKey");
-    const deploymentKey = params.get("deploymentKey");
-    return `https://${base}/c/${deploymentKey}/${channelKey}`;
+    return null;
+};
+const toWebsocketUrl = (connection) => {
+    return `wss://us-east-1-ws.${connection.host}?deploymentKey=${connection.deploymentKey}&channelKey=${connection.channelKey}&apiKey=${connection.apiKey}`;
+};
+const toHttpUrl = (connection) => {
+    return `${connection.protocol === exports.Protocol.Http ? "http" : "https"}://${connection.host}/c/${connection.deploymentKey}/${connection.channelKey}`;
 };
 const isWebsocketUrl = (url) => {
     return url.indexOf("wss://") === 0;
 };
-const fetchUserMessage = async ({ fullApplicationUrl, headers, body, stream, eventListeners, }) => {
+const fetchUserMessage = async ({ fullApplicationUrl, apiKey, headers, body, stream, eventListeners, }) => {
     const streamRequest = async (body) => {
         const response = await fetch(fullApplicationUrl, {
             method: "POST",
             headers: {
                 ...headers,
+                "nlx-api-key": apiKey,
                 "Content-Type": "application/json",
                 // Legacy header
                 "nlx-sdk-version": packageJson.version,
@@ -279,6 +317,7 @@ const fetchUserMessage = async ({ fullApplicationUrl, headers, body, stream, eve
             method: "POST",
             headers: {
                 ...(headers ?? {}),
+                "nlx-api-key": apiKey,
                 Accept: "application/json",
                 "Content-Type": "application/json",
                 // Legacy header
@@ -318,31 +357,13 @@ function createConversation(configuration) {
     let voicePlusSocket;
     let voicePlusSocketMessageQueue = [];
     let voicePlusSocketMessageQueueCheckInterval = null;
-    const protocol = configuration.protocol ??
-        /**
-         * Backwards-compatibility: if a websocket URL was specified, assume it's websocket. Otherwise, look at the legacy experimental streamsetting
-         * and only assume non-streaming if it's explicitly set to false.
-         */
-        (isWebsocketUrl(configuration.applicationUrl ?? "")
-            ? exports.Protocol.Websocket
-            : configuration.experimental?.streamHttp === false
-                ? exports.Protocol.Https
-                : exports.Protocol.HttpsWithStreaming);
-    /**
-     * TODO: Instead of re-serializing the host/deploymentKey/channelKey combo and normalizing them again into various socket and HTTP URL's,
-     * parse them out of the `applicationUrl` if specified, and use them to build up the URL's in use. This way we avoid serializing and then
-     * parsing again.
-     */
-    const applicationUrl = (() => {
-        if (configuration.host != null &&
-            configuration.deploymentKey != null &&
-            configuration.channelKey != null) {
-            return `https://${configuration.host}/c/${configuration.deploymentKey}/${configuration.channelKey}`;
-        }
-        return configuration.applicationUrl ?? "";
-    })();
-    const websocketApplicationUrl = normalizeToWebsocket(applicationUrl);
-    const httpApplicationUrl = normalizeToHttp(applicationUrl);
+    const connection = parseConnection(configuration);
+    const websocketApplicationUrl = connection != null
+        ? toWebsocketUrl(connection)
+        : configuration.applicationUrl ?? "";
+    const httpApplicationUrl = connection != null
+        ? toHttpUrl(connection)
+        : configuration.applicationUrl ?? "";
     // Check if the application URL has a language code appended to it
     if (/[-|_][a-z]{2,}[-|_][A-Z]{2,}$/.test(httpApplicationUrl)) {
         Console.warn("Since v1.0.0, the language code is no longer added at the end of the application URL. Please remove the modifier (e.g. '-en-US') from the URL, and specify it in the `languageCode` parameter instead.");
@@ -452,7 +473,7 @@ function createConversation(configuration) {
             channelType: configuration.experimental?.channelType,
             environment: configuration.environment,
         };
-        if (protocol === exports.Protocol.Websocket) {
+        if (connection?.protocol === exports.Protocol.Websocket) {
             if (socket?.readyState === 1) {
                 socket.send(JSON.stringify(bodyWithContext));
             }
@@ -464,8 +485,9 @@ function createConversation(configuration) {
             try {
                 const json = await fetchUserMessage({
                     fullApplicationUrl: fullApplicationHttpUrl(),
+                    apiKey: connection?.apiKey ?? "",
                     headers: configuration.headers ?? {},
-                    stream: protocol === exports.Protocol.HttpsWithStreaming,
+                    stream: connection?.protocol === exports.Protocol.HttpsWithStreaming,
                     eventListeners,
                     body: bodyWithContext,
                 });
@@ -500,10 +522,6 @@ function createConversation(configuration) {
             url.searchParams.set("channelKey", `${url.searchParams.get("channelKey") ?? ""}-${state.languageCode}`);
         }
         url.searchParams.set("conversationId", state.conversationId);
-        const apiKey = configuration.headers["nlx-api-key"];
-        if (apiKey != null) {
-            url.searchParams.set("apiKey", apiKey);
-        }
         socket = new ReconnectingWebSocket(url.href);
         socketMessageQueueCheckInterval = setInterval(() => {
             void checkSocketQueue();
@@ -527,9 +545,8 @@ function createConversation(configuration) {
         }
         url.searchParams.set("conversationId", state.conversationId);
         url.searchParams.set("type", "voice-plus");
-        const apiKey = configuration.headers["nlx-api-key"];
-        if (apiKey != null) {
-            url.searchParams.set("apiKey", apiKey);
+        if (connection?.apiKey != null) {
+            url.searchParams.set("apiKey", connection.apiKey);
         }
         voicePlusSocket = new ReconnectingWebSocket(url.href);
         voicePlusSocketMessageQueueCheckInterval = setInterval(() => {
@@ -566,7 +583,7 @@ function createConversation(configuration) {
             voicePlusSocket = undefined;
         }
     };
-    if (protocol === exports.Protocol.Websocket) {
+    if (connection?.protocol === exports.Protocol.Websocket) {
         setupWebsocket();
     }
     setupCommandWebsocket();
@@ -649,7 +666,7 @@ function createConversation(configuration) {
             request: {
                 structured: {
                     nodeId: metadata?.nodeId,
-                    intentId: metadata?.intentId,
+                    intentId: metadata?.flowId ?? metadata?.intentId,
                     choiceId,
                 },
             },
@@ -672,6 +689,7 @@ function createConversation(configuration) {
                 method: "POST",
                 headers: {
                     ...(configuration.headers ?? {}),
+                    "nlx-api-key": connection?.apiKey ?? "",
                     Accept: "application/json",
                     "Content-Type": "application/json",
                     "nlx-conversation-id": state.conversationId,
@@ -757,7 +775,7 @@ function createConversation(configuration) {
                 Console.warn("Attempted to set language code to the one already active.");
                 return;
             }
-            if (protocol === exports.Protocol.Websocket) {
+            if (connection?.protocol === exports.Protocol.Websocket) {
                 setupWebsocket();
             }
             setupCommandWebsocket();
@@ -771,6 +789,7 @@ function createConversation(configuration) {
                 method: "POST",
                 headers: {
                     ...(configuration.headers ?? {}),
+                    "nlx-api-key": connection?.apiKey ?? "",
                     Accept: "application/json",
                     "Content-Type": "application/json",
                     "nlx-conversation-id": state.conversationId,
@@ -806,14 +825,14 @@ function createConversation(configuration) {
                 conversationId: uuid.v4(),
                 responses: options?.clearResponses === true ? [] : state.responses,
             });
-            if (protocol === exports.Protocol.Websocket) {
+            if (connection?.protocol === exports.Protocol.Websocket) {
                 setupWebsocket();
             }
             setupCommandWebsocket();
         },
         destroy: () => {
             subscribers = [];
-            if (protocol === exports.Protocol.Websocket) {
+            if (connection?.protocol === exports.Protocol.Websocket) {
                 teardownWebsocket();
             }
             teardownCommandWebsocket();
@@ -838,13 +857,7 @@ function createConversation(configuration) {
  * @returns Whether the configuration is valid?
  */
 const isConfigValid = (configuration) => {
-    if (configuration.host != null &&
-        configuration.deploymentKey != null &&
-        configuration.channelKey != null) {
-        return true;
-    }
-    const applicationUrl = configuration.applicationUrl ?? "";
-    return applicationUrl.length > 0;
+    return parseConnection(configuration) != null;
 };
 /**
  * Helper method to decide when a new {@link Config} requires creating a new {@link ConversationHandler} or whether the old `Config`'s