@athoscommerce/snap-preact 1.4.0 → 1.5.1-beta.110

package/dist/esm/components/src/utilities/snapify.js

@@ -1,7 +1,7 @@
 import { configure as configureMobx } from 'mobx';
-import { SearchController, AutocompleteController, RecommendationController } from '@athoscommerce/snap-controller';
+import { SearchController, AutocompleteController, RecommendationController, ChatController } from '@athoscommerce/snap-controller';
 import { Client } from '@athoscommerce/snap-client';
-import { SearchStore, AutocompleteStore, RecommendationStore } from '@athoscommerce/snap-store-mobx';
+import { SearchStore, AutocompleteStore, RecommendationStore, ChatStore } from '@athoscommerce/snap-store-mobx';
 import { UrlManager, UrlTranslator, reactLinker } from '@athoscommerce/snap-url-manager';
 import { EventManager } from '@athoscommerce/snap-event-manager';
 import { Profiler } from '@athoscommerce/snap-profiler';
@@ -42,6 +42,20 @@ export class Snapify {
         cntrlr.init();
         return cntrlr;
     }
+    static chat(config) {
+        const id = config.id;
+        if (controllers[id]) {
+            return controllers[id];
+        }
+        const cntrlr = (controllers[id] = createChatController({ client, controller: config }));
+        cntrlr.on('afterStore', async ({ controller }, next) => {
+            controller.log.debug('controller', controller);
+            controller.log.debug('store', controller.store.toJSON());
+            await next();
+        });
+        cntrlr.init();
+        return cntrlr;
+    }
     static search(config) {
         const id = config.id;
         if (controllers[id]) {
@@ -83,6 +97,19 @@ function createRecommendationController(config) {
     });
     return cntrlr;
 }
+function createChatController(config) {
+    const urlManager = new UrlManager(new UrlTranslator(), reactLinker);
+    const cntrlr = new ChatController(config.controller, {
+        client: new Client(config.client.globals, config.client.config),
+        store: new ChatStore({ ...config.controller, siteId: config.client.globals.siteId }, { urlManager }),
+        urlManager,
+        eventManager: new EventManager(),
+        profiler: new Profiler(),
+        logger: new Logger(),
+        tracker: new Tracker(config.client.globals),
+    });
+    return cntrlr;
+}
 function createAutocompleteController(config) {
     const urlManager = new UrlManager(new UrlTranslator(), reactLinker).detach();
     const cntrlr = new AutocompleteController(config.controller, {

package/dist/esm/src/Instantiators/RecommendationInstantiator.d.ts

@@ -69,6 +69,7 @@ export declare class RecommendationInstantiator {
     plugin(func: (cntrlr: AbstractController, ...args: any) => void | Promise<void>, ...args: unknown[]): void;
     on<T>(event: string, ...func: Middleware<T>[]): void;
     use(attachments: Attachments): void;
+    cleanupStaleControllers(): void;
 }
 type DefinedProps = {
     [key: string]: any;

package/dist/esm/src/Instantiators/RecommendationInstantiator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RecommendationInstantiator.d.ts","sourceRoot":"","sources":["../../../../src/Instantiators/RecommendationInstantiator.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"RecommendationInstantiator.d.ts","sourceRoot":"","sources":["../../../../src/Instantiators/RecommendationInstantiator.tsx"],"names":[],"mappings":"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"}

package/dist/esm/src/Instantiators/RecommendationInstantiator.js

@@ -5,6 +5,7 @@ import { AppMode, DomTargeter, getContext } from '@athoscommerce/snap-toolbox';
 import { Client } from '@athoscommerce/snap-client';
 import { Logger } from '@athoscommerce/snap-logger';
 import { Tracker } from '@athoscommerce/snap-tracker';
+import { createRecommendationController } from '../create';
 const DEFAULT_BRANCH = 'production';
 export class RecommendationInstantiator {
     constructor(config, services, context) {
@@ -40,29 +41,26 @@ export class RecommendationInstantiator {
         this.tracker = services?.tracker || new Tracker(this.config.client.globals);
         this.logger = services?.logger || new Logger({ prefix: 'RecommendationInstantiator ', mode: this.mode });
         const profileCount = {};
+        // script block targeter for "grouped" and "legacy" blocks
         this.targeter = new DomTargeter([
             {
                 selector: `${this.config.selector ||
                     'script[type="searchspring/recommend"], script[type="searchspring/personalized-recommendations"], script[type="athos/recommend"], script[type="athos/personalized-recommendations"]'}, script[type="searchspring/recommend"][profile="email"], script[type="athos/recommend"][profile="email"]`,
                 autoRetarget: true,
                 clickRetarget: true,
-                inject: {
-                    action: 'before',
-                    element: (target, origElement) => {
-                        const profile = origElement.getAttribute('profile') || '';
-                        const recsContainer = document.createElement('div');
-                        recsContainer.setAttribute('searchspring-recommend', profile);
-                        return recsContainer;
-                    },
-                },
+                navigationRetarget: true,
+                emptyTarget: false,
             },
             {
                 selector: 'script[type="searchspring/recommendations"], script[type="athos/recommendations"]',
                 autoRetarget: true,
                 clickRetarget: true,
+                navigationRetarget: true,
                 emptyTarget: false,
             },
-        ], async (target, elem, originalElem) => {
+        ], async (target, elem) => {
+            this.cleanupStaleControllers();
+            const scriptElement = elem;
             const elemContext = getContext([
                 'shopperId',
                 'shopper',
@@ -77,7 +75,7 @@ export class RecommendationInstantiator {
                 'custom',
                 'profiles',
                 'globals',
-            ], (originalElem || elem));
+            ], scriptElement);
             if (elemContext.profiles && elemContext.profiles.length) {
                 // using the "grouped block" integration structure
                 // type the new profile specific integration context variables
@@ -91,34 +89,52 @@ export class RecommendationInstantiator {
                         cart: scriptContextGlobals?.cart && getArrayFunc(scriptContextGlobals.cart),
                         products: scriptContextGlobals?.products,
                         shopper: scriptContextGlobals?.shopper?.id,
-                        batchId: Math.random(),
+                        batchId: Math.floor(Math.random() * Number.MAX_SAFE_INTEGER),
                     }),
                 };
-                const targetsArr = [];
-                // build out the targets array for each profile
-                scriptContextProfiles.forEach((profile) => {
+                // create a per-profile DomTargeter for each profile so each controller
+                // gets its own targeter tracking its specific element
+                scriptContextProfiles.forEach((profile, index) => {
                     if (profile.selector) {
-                        const targetObj = {
+                        const profileTarget = {
                             selector: profile.selector,
                             autoRetarget: true,
-                            clickRetarget: true,
                             profile,
+                            order: index,
                         };
-                        targetsArr.push(targetObj);
-                    }
-                });
-                new DomTargeter(targetsArr, async (target, elem, originalElem) => {
-                    if (target.profile?.profile || target.profile?.tag) {
-                        const profileRequestGlobals = {
-                            ...requestGlobals,
-                            profile: target.profile?.options,
-                            tag: target.profile.tag || target.profile.profile, // have to support both tag and profile due to having profile at release, but will favor tag
-                        };
-                        const profileContext = deepmerge(this.context, defined({ globals: scriptContextGlobals, profile: target.profile }));
-                        if (elemContext.custom) {
-                            profileContext.custom = deepmerge(profileContext.custom, elemContext.custom);
-                        }
-                        readyTheController(this, services || {}, elem, profileContext, profileCount, originalElem, profileRequestGlobals, target);
+                        // track the controller for this profile so multiple matched elements share it
+                        let profileControllerPromise;
+                        new DomTargeter([profileTarget], async (target, targetElem, _originalElem, targeter) => {
+                            // skip retarget if the source script element was removed and release the current target
+                            if (scriptElement.isConnected === false) {
+                                if (targetElem) {
+                                    targeter?.releaseTargets([targetElem]);
+                                }
+                                return;
+                            }
+                            if (target.profile?.profile || target.profile?.tag) {
+                                const profileRequestGlobals = {
+                                    ...requestGlobals,
+                                    profile: { ...target.profile?.options, order: target.order },
+                                    tag: target.profile.tag || target.profile.profile, // have to support both tag and profile due to having profile at release, but will favor tag
+                                };
+                                const profileContext = deepmerge(this.context, defined({ globals: scriptContextGlobals, profile: target.profile }));
+                                if (elemContext.custom) {
+                                    profileContext.custom = deepmerge(profileContext.custom, elemContext.custom);
+                                }
+                                if (!profileControllerPromise) {
+                                    // first element match — create the controller
+                                    profileControllerPromise = readyTheController(this, services || {}, targetElem, profileContext, profileCount, scriptElement, profileRequestGlobals, target, targeter);
+                                }
+                                else {
+                                    // subsequent element matches — reuse the existing controller and just render
+                                    const controller = await profileControllerPromise;
+                                    if (controller && targetElem) {
+                                        renderController(this, services || {}, controller, targetElem, scriptElement, target);
+                                    }
+                                }
+                            }
+                        });
                     }
                 });
             }
@@ -138,7 +154,23 @@ export class RecommendationInstantiator {
                         profile: options,
                     }),
                 };
-                readyTheController(this, services || {}, elem, deepmerge(this.context, elemContext), profileCount, originalElem, profileRequestGlobals, target);
+                // inject a render container before the script element
+                const profileAttr = scriptElement.getAttribute('profile') || '';
+                const recsContainer = scriptElement.ownerDocument.createElement('div');
+                recsContainer.setAttribute('searchspring-recommend', profileAttr);
+                scriptElement.before(recsContainer);
+                const legacyContext = deepmerge(this.context, elemContext);
+                // create a per-element DomTargeter for the injected div (mirrors grouped block pattern)
+                new DomTargeter([{ selector: `[searchspring-recommend="${profileAttr}"]`, name: `legacy_${profile}_${profileCount[profile || ''] || 0}` }], async (_target, targetElem, _originalElem, targeter) => {
+                    // skip retarget if the source script element was removed and release the current target
+                    if (scriptElement.isConnected === false) {
+                        if (targetElem) {
+                            targeter?.releaseTargets([targetElem]);
+                        }
+                        return;
+                    }
+                    readyTheController(this, services || {}, targetElem, legacyContext, profileCount, scriptElement, profileRequestGlobals, target, targeter);
+                });
             }
         });
     }
@@ -151,26 +183,43 @@ export class RecommendationInstantiator {
     use(attachments) {
         this.uses.push(attachments);
     }
+    // cleanup to ensure we release controllers no longer rendering in the DOM (memory leak prevention for SPA's)
+    cleanupStaleControllers() {
+        Object.keys(this.controller).forEach((id) => {
+            const controller = this.controller[id];
+            const targeters = Object.values(controller.targeters);
+            const hasConnectedTarget = targeters.some((targeter) => targeter.getTargetedElems().some((elem) => {
+                const attr = elem.isConnected !== false && elem.getAttribute('ss-controller-id');
+                return attr === id;
+            }));
+            if (!hasConnectedTarget) {
+                Object.keys(controller.targeters).forEach((targeterId) => controller.targeters[targeterId].destroy());
+                controller.targeters = {};
+                delete this.controller[id];
+                if (window.athos?.controller) {
+                    delete window.athos.controller[id];
+                }
+            }
+        });
+    }
 }
-async function readyTheController(instance, services, injectedElem, context, profileCount, elem, controllerGlobals, target) {
+async function readyTheController(instance, services, targetElem, context, profileCount, scriptElem, controllerGlobals, target, targeter) {
     const { profile, batchId, cart, tag } = controllerGlobals;
     const batched = profile?.batched ?? controllerGlobals.batched ?? true;
     if (!tag) {
         // FEEDBACK: change message depending on script integration type (profile vs. legacy)
-        instance.logger.warn(`'tag' is missing from <script> tag, skipping this profile`, elem);
+        instance.logger.warn(`'tag' is missing from <script> tag, skipping this profile`, scriptElem);
         return;
     }
     if (Array.isArray(cart)) {
         instance.tracker.cookies.cart.set(cart);
     }
-    profileCount[tag] = profileCount[tag] + 1 || 1;
     const globals = deepmerge.all([
         instance.config.client?.globals || {},
         instance.config.config?.globals || {},
         controllerGlobals,
     ]);
-    const controllerConfig = {
-        id: `recommend_${tag}_${profileCount[tag] - 1}`,
+    const controllerConfigBase = {
         tag,
         batched: batched ?? instance.config.config?.batched ?? true,
         realtime: Boolean(context.options?.realtime ?? context.profile?.options?.realtime ?? instance.config.config?.realtime),
@@ -179,78 +228,77 @@ async function readyTheController(instance, services, injectedElem, context, pro
         plugins: instance.config.config.plugins,
         branch: instance.config.config?.branch || 'production',
         limit: instance.config.config?.limit,
+        beacon: instance.config.config?.beacon || { enabled: true },
         settings: {
             variants: instance.config.config?.variants,
         },
         globals,
     };
     if (profile?.branch) {
-        controllerConfig.branch = profile?.branch;
+        controllerConfigBase.branch = profile?.branch;
     }
-    // try to find an existing controller by similar configuration
-    let controller = Object.keys(instance.controller)
-        .map((id) => instance.controller[id])
-        .filter((controller) => {
-        return (JSON.stringify({
-            batched: controller.config.batched,
-            branch: controller.config.branch,
-            globals: controller.config.globals,
-            tag: controller.config.tag,
-            realtime: controller.config.realtime,
-        }) ==
-            JSON.stringify({
-                batched: controllerConfig.batched,
-                branch: controllerConfig.branch,
-                globals: controllerConfig.globals,
-                tag: controllerConfig.tag,
-                realtime: controllerConfig.realtime,
-            }));
-    })[0];
-    if (!controller) {
-        // no existing controller found of same configuration - creating a new controller
-        const createRecommendationController = (await import('../create/createRecommendationController')).default;
-        controller = createRecommendationController({
-            url: instance.config.url,
-            controller: controllerConfig,
-            context,
-            mode: instance.config.mode,
-        }, { client: instance.client, tracker: instance.tracker });
-        instance.uses.forEach((attachements) => controller.use(attachements));
-        instance.plugins.forEach((plugin) => controller.plugin(plugin.func, ...plugin.args));
-        instance.middleware.forEach((middleware) => controller.on(middleware.event, ...middleware.func));
+    profileCount[tag] = profileCount[tag] + 1 || 1;
+    const controllerConfig = {
+        id: `recommend_${tag}_${profileCount[tag] - 1}`,
+        ...controllerConfigBase,
+    };
+    const controller = createRecommendationController({
+        url: instance.config.url,
+        controller: controllerConfig,
+        context,
+        mode: instance.config.mode,
+    }, { client: instance.client, tracker: instance.tracker });
+    // mark element with controller id so cleanupStaleControllers knows it's active
+    if (targetElem) {
+        targetElem.setAttribute('ss-controller-id', controller.id);
     }
+    instance.uses.forEach((attachements) => controller.use(attachements));
+    instance.plugins.forEach((plugin) => controller.plugin(plugin.func, ...plugin.args));
+    instance.middleware.forEach((middleware) => controller.on(middleware.event, ...middleware.func));
+    // add controller to instantiator and global namespace
+    instance.controller[controller.config.id] = controller;
+    window.athos.controller = window.athos.controller || {};
+    window.athos.controller[controller.config.id] = controller;
+    // register targeter on the controller for element tracking
+    controller.addTargeter(targeter);
     // run a search on the controller if it is not currently
     if (!controller.store.loading) {
         await controller.search();
     }
-    controller.addTargeter(instance.targeter);
-    instance.controller[controller.config.id] = controller;
-    window.athos.controller = window.athos.controller || {};
-    window.athos.controller[controller.config.id] = controller;
     const profileVars = controller.store.profile.display?.templateParameters;
-    const component = controller.store.profile.display?.template?.component;
     if (controller.store.error) {
         //something went wrong
         //err was already logged - nothing to do.
         return;
     }
     if (!controller.store.profile.display.template) {
-        instance.logger.error(`profile '${tag}' found on the following element is missing a template!\n${elem?.outerHTML}`);
+        instance.logger.error(`profile '${tag}' found on the following element is missing a template!\n${scriptElem?.outerHTML}`);
         return;
     }
     if (!profileVars) {
-        instance.logger.error(`profile '${tag}' found on the following element is missing templateParameters!\n${elem?.outerHTML}`);
+        instance.logger.error(`profile '${tag}' found on the following element is missing templateParameters!\n${scriptElem?.outerHTML}`);
         return;
     }
+    if (targetElem) {
+        await renderController(instance, services, controller, targetElem, scriptElem, target);
+    }
+    return controller;
+}
+async function renderController(instance, services, controller, targetElem, scriptElem, target) {
+    // update the element with the controller id
+    if (targetElem) {
+        targetElem.setAttribute('ss-controller-id', controller.id);
+    }
+    const tag = controller.config.tag;
+    const component = controller.store.profile.display?.template?.component;
     if (!component) {
-        instance.logger.error(`profile '${tag}' found on the following element is missing a component!\n${elem?.outerHTML}`);
+        instance.logger.error(`profile '${tag}' found on the following element is missing a component!\n${scriptElem?.outerHTML}`);
         return;
     }
     let props = {};
     let RecommendationsComponent = undefined;
     props.className = `ss__recommendation-${component.toLowerCase()}`;
-    injectedElem?.setAttribute('id', `${controllerConfig.id}`);
-    instance.config.components[component]?.onTarget?.(target, elem, injectedElem, controller);
+    instance.config.components[component]?.onTarget?.(target, scriptElem, targetElem, controller);
     if (instance.config.components[component] && typeof instance.config.components[component] == 'function') {
         RecommendationsComponent = await instance.config.components[component]();
     }
@@ -263,13 +311,11 @@ async function readyTheController(instance, services, injectedElem, context, pro
         RecommendationsComponent = importResolutions[0];
     }
     if (!RecommendationsComponent) {
-        instance.logger.error(`profile '${tag}' found on the following element is expecting component mapping for '${component}' - verify instantiator config.\n${elem?.outerHTML}`);
+        instance.logger.error(`profile '${tag}' found on the following element is expecting component mapping for '${component}' - verify instantiator config.\n${scriptElem?.outerHTML}`);
         return;
     }
     setTimeout(() => {
-        if (injectedElem && RecommendationsComponent) {
-            render(_jsx(RecommendationsComponent, { controller: controller, snap: services?.snap, ...props }), injectedElem);
-        }
+        render(_jsx(RecommendationsComponent, { controller: controller, snap: services?.snap, ...props }), targetElem);
     });
 }
 function getArrayFunc(arrayOrFunc) {

package/dist/esm/src/Snap.d.ts

@@ -5,11 +5,11 @@ import { AppMode } from '@athoscommerce/snap-toolbox';
 import { ControllerTypes } from '@athoscommerce/snap-controller';
 import { EventManager } from '@athoscommerce/snap-event-manager';
 import type { ClientConfig, ClientGlobals } from '@athoscommerce/snap-client';
-import type { Controllers, AbstractController, SearchControllerConfig, AutocompleteControllerConfig, FinderControllerConfig, RecommendationControllerConfig, ControllerConfigs, ContextVariables } from '@athoscommerce/snap-controller';
+import type { Controllers, AbstractController, SearchControllerConfig, ChatControllerConfig, AutocompleteControllerConfig, FinderControllerConfig, RecommendationControllerConfig, ControllerConfigs, ContextVariables } from '@athoscommerce/snap-controller';
 import type { TrackerConfig, TrackerGlobals } from '@athoscommerce/snap-tracker';
 import type { Target, OnTarget } from '@athoscommerce/snap-toolbox';
 import type { UrlTranslatorConfig } from '@athoscommerce/snap-url-manager';
-import { RecommendationInstantiator, RecommendationInstantiatorConfig } from './Instantiators/RecommendationInstantiator';
+import type { RecommendationInstantiator, RecommendationInstantiatorConfig } from './Instantiators/RecommendationInstantiator';
 import type { SnapControllerServices, InitialUrlConfig, SnapFeatures } from './types';
 import type { TemplatesStore } from './Templates/Stores/TemplateStore';
 export declare const BRANCH_COOKIE = "athosBranch";
@@ -55,6 +55,7 @@ export type SnapConfig = {
     };
     controllers?: {
         search?: SnapConfigControllerDefinition<SearchControllerConfig>[];
+        chat?: SnapConfigControllerDefinition<ChatControllerConfig>[];
         autocomplete?: SnapConfigControllerDefinition<AutocompleteControllerConfig>[];
         finder?: SnapConfigControllerDefinition<FinderControllerConfig>[];
         recommendation?: SnapConfigControllerDefinition<RecommendationControllerConfig>[];

package/dist/esm/src/Snap.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Snap.d.ts","sourceRoot":"","sources":["../../../src/Snap.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"Snap.d.ts","sourceRoot":"","sources":["../../../src/Snap.tsx"],"names":[],"mappings":"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"}

package/dist/esm/src/Snap.js

@@ -95,6 +95,9 @@ export class Snap {
                 case ControllerTypes.recommendation:
                     importPromise = import('./create/createRecommendationController');
                     break;
+                case ControllerTypes.chat:
+                    importPromise = import('./create/createChatController');
+                    break;
                 case ControllerTypes.search:
                 default:
                     importPromise = import('./create/createSearchController');
@@ -141,12 +144,14 @@ export class Snap {
                 let elem = null;
                 elem = event && event.target;
                 while (Object.keys(attributes).length == 0 && elem !== null && levels <= MAX_PARENT_LEVELS) {
-                    Object.values(elem.attributes).forEach((attr) => {
-                        const attrName = attr.nodeName;
-                        if (attributeList.indexOf(attrName) != -1) {
-                            attributes[attrName] = elem && elem.getAttribute(attrName);
-                        }
-                    });
+                    if (elem.attributes) {
+                        Object.values(elem.attributes).forEach((attr) => {
+                            const attrName = attr.nodeName;
+                            if (attributeList.indexOf(attrName) != -1) {
+                                attributes[attrName] = elem && elem.getAttribute(attrName);
+                            }
+                        });
+                    }
                     elem = elem.parentElement;
                     levels++;
                 }
@@ -536,6 +541,75 @@ export class Snap {
                     });
                     break;
                 }
+                case 'chat': {
+                    this.config.controllers[type].forEach((controller, index) => {
+                        if (typeof this._controllerPromises[controller.config.id] != 'undefined') {
+                            this.logger.error(`Controller with id '${controller.config.id}' is already defined`);
+                            return;
+                        }
+                        this._controllerPromises[controller.config.id] = new Promise(async (resolve) => {
+                            try {
+                                const targetFunction = async (target, elem, originalElem) => {
+                                    const onTarget = target.onTarget;
+                                    onTarget && (await onTarget(target, elem, originalElem));
+                                    try {
+                                        const importPromises = [];
+                                        // dynamically import the component
+                                        importPromises.push(target.component());
+                                        const importResolutions = await Promise.all(importPromises);
+                                        const Component = importResolutions[0];
+                                        setTimeout(() => {
+                                            render(_jsx(Component, { controller: this.controllers[controller.config.id], snap: this, ...target.props }), elem);
+                                        });
+                                    }
+                                    catch (err) {
+                                        this.logger.error(err);
+                                        this.logger.error(COMPONENT_ERROR, target);
+                                    }
+                                };
+                                if (!controller?.targeters || controller?.targeters.length === 0) {
+                                    await this._createController(ControllerTypes.chat, controller.config, controller.services, controller.url, controller.context, (cntrlr) => {
+                                        if (cntrlr)
+                                            resolve(cntrlr);
+                                    });
+                                }
+                                controller?.targeters?.forEach((target, target_index) => {
+                                    if (!target.selector) {
+                                        throw new Error(`Targets at index ${target_index} missing selector value (string).`);
+                                    }
+                                    if (!target.component) {
+                                        throw new Error(`Targets at index ${target_index} missing component value (Component).`);
+                                    }
+                                    // Chat mounts at the document level — if the consumer aimed at <body>
+                                    // directly, give DomTargeter a child to render into instead of stomping on body.
+                                    if (target.selector === 'body' && !target.inject) {
+                                        target = {
+                                            ...target,
+                                            inject: {
+                                                action: 'append',
+                                                element: () => {
+                                                    return document.createElement('div');
+                                                },
+                                            },
+                                        };
+                                    }
+                                    const targeter = new DomTargeter([{ ...target }], async (target, elem, originalElem) => {
+                                        const cntrlr = await this._createController(ControllerTypes.chat, controller.config, controller.services, controller.url, controller.context, (cntrlr) => {
+                                            if (cntrlr)
+                                                resolve(cntrlr);
+                                        });
+                                        targetFunction({ controller: cntrlr, ...target }, elem, originalElem);
+                                        cntrlr.addTargeter(targeter);
+                                    });
+                                });
+                            }
+                            catch (err) {
+                                this.logger.error(`Failed to instantiate ${type} controller at index ${index}.`, err);
+                            }
+                        });
+                    });
+                    break;
+                }
                 case 'autocomplete': {
                     this.config.controllers[type].forEach((controller, index) => {
                         if (typeof this._controllerPromises[controller.config.id] != 'undefined') {

package/dist/esm/src/Templates/SnapTemplates.d.ts

@@ -29,10 +29,11 @@ export declare function mapBreakpoints<ControllerConfigSettings>(breakpointsKeys
     [key: string]: ControllerConfigSettings | Record<string, never>;
 };
 export declare const createSearchTargeters: (templateConfig: SnapTemplatesConfig, templatesStore: TemplatesStore) => ExtendedTarget[];
+export declare const createChatTargeters: (templateConfig: SnapTemplatesConfig, templatesStore: TemplatesStore) => ExtendedTarget[];
 export declare function createAutocompleteTargeters(templateConfig: SnapTemplatesConfig, templatesStore: TemplatesStore): ExtendedTarget[];
 export declare function createRecommendationComponentMapping(templateConfig: SnapTemplatesConfig | SnapTemplatesConfigUnlocked, templatesStore: TemplatesStore): {
     [name: string]: RecommendationComponentObject;
 };
 export declare function createSnapConfig(templateConfig: SnapTemplatesConfig | SnapTemplatesConfigUnlocked, templatesStore: TemplatesStore): SnapConfig;
-export declare function createPlugins(templateConfig: SnapTemplatesConfig | SnapTemplatesConfigUnlocked, templatesStore: TemplatesStore, controllerType?: 'autocomplete' | 'search' | 'recommendation'): PluginGrouping[];
+export declare function createPlugins(templateConfig: SnapTemplatesConfig | SnapTemplatesConfigUnlocked, templatesStore: TemplatesStore, controllerType?: 'autocomplete' | 'search' | 'recommendation' | 'chat'): PluginGrouping[];
 //# sourceMappingURL=SnapTemplates.d.ts.map

package/dist/esm/src/Templates/SnapTemplates.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SnapTemplates.d.ts","sourceRoot":"","sources":["../../../../src/Templates/SnapTemplates.tsx"],"names":[],"mappings":"AAGA,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAI/B,OAAO,EAAkB,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAGxE,OAAO,EAAE,KAAK,+BAA+B,EAAE,MAAM,gCAAgC,CAAC;AACtF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAC3E,OAAO,KAAK,EAA0C,cAAc,EAAoB,MAAM,gCAAgC,CAAC;AAC/H,OAAO,KAAK,EAAE,6BAA6B,EAAoC,MAAM,6CAA6C,CAAC;AACnI,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAC1D,OAAO,KAAK,EAMX,0BAA0B,EAC1B,4BAA4B,EAE5B,MAAM,wBAAwB,CAAC;AAoChC,eAAO,MAAM,sBAAsB,gBAAgB,CAAC;AACpD,eAAO,MAAM,wBAAwB,iBAAiB,CAAC;AAEvD,MAAM,MAAM,mBAAmB,GAAG,yBAAyB,CAAC;AAC5D,MAAM,MAAM,2BAA2B,GAAG,4BAA4B,GAAG;IACxE,QAAQ,EAAE,IAAI,CAAC;IACf,GAAG,CAAC,EAAE,mBAAmB,CAAC;IAC1B,QAAQ,CAAC,EAAE,YAAY,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG,0BAA0B,GAAG;IACpE,GAAG,CAAC,EAAE,mBAAmB,CAAC;IAC1B,QAAQ,CAAC,EAAE,YAAY,CAAC;CACxB,CAAC;AAwBF,eAAO,MAAM,gBAAgB,EAAE,YAAiB,CAAC;AAEjD,eAAO,MAAM,wCAAwC,EAAE,+BAItD,CAAC;AAEF,qBAAa,aAAc,SAAQ,IAAI;IACtC,SAAS,EAAE,cAAc,CAAC;gBACd,MAAM,EAAE,mBAAmB,GAAG,2BAA2B;CAoGrE;AAED,wBAAgB,cAAc,CAAC,wBAAwB,EACtD,eAAe,EAAE,MAAM,EAAE,EACzB,kBAAkB,EAAE,wBAAwB,EAAE,GAC5C;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,wBAAwB,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;CAAE,CAKrE;AAED,eAAO,MAAM,qBAAqB,mBAAoB,mBAAmB,kBAAkB,cAAc,KAAG,cAAc,EAoCzH,CAAC;AAEF,wBAAgB,2BAA2B,CAAC,cAAc,EAAE,mBAAmB,EAAE,cAAc,EAAE,cAAc,GAAG,cAAc,EAAE,CAkCjI;AAED,wBAAgB,oCAAoC,CACnD,cAAc,EAAE,mBAAmB,GAAG,2BAA2B,EACjE,cAAc,EAAE,cAAc,GAC5B;IAAE,CAAC,IAAI,EAAE,MAAM,GAAG,6BAA6B,CAAA;CAAE,CAiDnD;AAED,wBAAgB,gBAAgB,CAAC,cAAc,EAAE,mBAAmB,GAAG,2BAA2B,EAAE,cAAc,EAAE,cAAc,GAAG,UAAU,CA2I9I;AAED,wBAAgB,aAAa,CAC5B,cAAc,EAAE,mBAAmB,GAAG,2BAA2B,EACjE,cAAc,EAAE,cAAc,EAC9B,cAAc,CAAC,EAAE,cAAc,GAAG,QAAQ,GAAG,gBAAgB,GAC3D,cAAc,EAAE,CAmFlB"}
+{"version":3,"file":"SnapTemplates.d.ts","sourceRoot":"","sources":["../../../../src/Templates/SnapTemplates.tsx"],"names":[],"mappings":"AAGA,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAI/B,OAAO,EAAkB,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAGxE,OAAO,EAAE,KAAK,+BAA+B,EAAE,MAAM,gCAAgC,CAAC;AACtF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAC3E,OAAO,KAAK,EAA0C,cAAc,EAAoB,MAAM,gCAAgC,CAAC;AAC/H,OAAO,KAAK,EAAE,6BAA6B,EAAoC,MAAM,6CAA6C,CAAC;AACnI,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAC1D,OAAO,KAAK,EAOX,0BAA0B,EAC1B,4BAA4B,EAE5B,MAAM,wBAAwB,CAAC;AAoChC,eAAO,MAAM,sBAAsB,gBAAgB,CAAC;AACpD,eAAO,MAAM,wBAAwB,iBAAiB,CAAC;AAEvD,MAAM,MAAM,mBAAmB,GAAG,yBAAyB,CAAC;AAC5D,MAAM,MAAM,2BAA2B,GAAG,4BAA4B,GAAG;IACxE,QAAQ,EAAE,IAAI,CAAC;IACf,GAAG,CAAC,EAAE,mBAAmB,CAAC;IAC1B,QAAQ,CAAC,EAAE,YAAY,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG,0BAA0B,GAAG;IACpE,GAAG,CAAC,EAAE,mBAAmB,CAAC;IAC1B,QAAQ,CAAC,EAAE,YAAY,CAAC;CACxB,CAAC;AAwBF,eAAO,MAAM,gBAAgB,EAAE,YAAiB,CAAC;AAEjD,eAAO,MAAM,wCAAwC,EAAE,+BAItD,CAAC;AAEF,qBAAa,aAAc,SAAQ,IAAI;IACtC,SAAS,EAAE,cAAc,CAAC;gBACd,MAAM,EAAE,mBAAmB,GAAG,2BAA2B;CAoGrE;AAED,wBAAgB,cAAc,CAAC,wBAAwB,EACtD,eAAe,EAAE,MAAM,EAAE,EACzB,kBAAkB,EAAE,wBAAwB,EAAE,GAC5C;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,wBAAwB,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;CAAE,CAKrE;AAED,eAAO,MAAM,qBAAqB,mBAAoB,mBAAmB,kBAAkB,cAAc,KAAG,cAAc,EAoCzH,CAAC;AAEF,eAAO,MAAM,mBAAmB,mBAAoB,mBAAmB,kBAAkB,cAAc,KAAG,cAAc,EA2CvH,CAAC;AAEF,wBAAgB,2BAA2B,CAAC,cAAc,EAAE,mBAAmB,EAAE,cAAc,EAAE,cAAc,GAAG,cAAc,EAAE,CAqCjI;AAED,wBAAgB,oCAAoC,CACnD,cAAc,EAAE,mBAAmB,GAAG,2BAA2B,EACjE,cAAc,EAAE,cAAc,GAC5B;IAAE,CAAC,IAAI,EAAE,MAAM,GAAG,6BAA6B,CAAA;CAAE,CAiDnD;AAED,wBAAgB,gBAAgB,CAAC,cAAc,EAAE,mBAAmB,GAAG,2BAA2B,EAAE,cAAc,EAAE,cAAc,GAAG,UAAU,CA0J9I;AAED,wBAAgB,aAAa,CAC5B,cAAc,EAAE,mBAAmB,GAAG,2BAA2B,EACjE,cAAc,EAAE,cAAc,EAC9B,cAAc,CAAC,EAAE,cAAc,GAAG,QAAQ,GAAG,gBAAgB,GAAG,MAAM,GACpE,cAAc,EAAE,CAmFlB"}