@aikaara/chat-sdk 0.6.1 → 0.7.0

package/dist/headless.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const i=require("./MountTenant-HkluWr4X.cjs");class s extends i.EventEmitter{registration=null;pendingEdits=[];constructor(e){super(),this.setupListeners(e)}registerForm(e){this.registration=e;const t=this.pendingEdits.filter(r=>r.entity_type===e.entityType&&String(r.entity_id)===String(e.entityId));if(t.length>0){for(const r of t)e.onFieldUpdate(r.fields),this.emit("edit:applied",{entityType:r.entity_type,entityId:r.entity_id,fields:r.fields});this.pendingEdits=this.pendingEdits.filter(r=>!(r.entity_type===e.entityType&&String(r.entity_id)===String(e.entityId)))}}unregisterForm(e,t){this.registration?.entityType===e&&String(this.registration?.entityId)===String(t)&&(this.registration=null)}get currentForm(){return this.registration}pushFieldUpdates(e,t,r){this.registration&&this.registration.entityType===e&&String(this.registration.entityId)===String(t)?(this.registration.onFieldUpdate(r),this.emit("edit:applied",{entityType:e,entityId:t,fields:r})):(this.pendingEdits.push({action:"edit_entity",entity_type:e,entity_id:t,fields:r}),this.emit("edit:pending",{entityType:e,entityId:t,fields:r}))}async requestSave(){if(!this.registration)return{success:!1,error:"No form registered"};try{return await this.registration.onSave(),this.emit("save:success",{entityType:this.registration.entityType,entityId:this.registration.entityId}),{success:!0}}catch(e){const t=e instanceof Error?e.message:"Save failed";return this.emit("save:error",{entityType:this.registration.entityType,entityId:this.registration.entityId,error:t}),{success:!1,error:t}}}async requestTest(e){if(!this.registration?.onTest)return{success:!1,error:"Current form does not support testing"};try{return await this.registration.onTest(e),{success:!0}}catch(t){return{success:!1,error:t instanceof Error?t.message:"Test failed"}}}setupListeners(e){e.on("action:edit_entity",t=>{this.pushFieldUpdates(t.entity_type,t.entity_id,t.fields)}),e.on("action:save_entity",t=>{this.requestSave()}),e.on("action:test_tool",t=>{this.emit("test:triggered",{toolId:t.tool_id,parameters:t.parameters}),this.requestTest(t.parameters)})}}exports.ActionCableClient=i.ActionCableClient;exports.AikaaraChatClient=i.AikaaraChatClient;exports.ApiClient=i.ApiClient;exports.ChannelSubscription=i.ChannelSubscription;exports.ConnectionManager=i.ConnectionManager;exports.ConversationManager=i.ConversationManager;exports.EventEmitter=i.EventEmitter;exports.MessageStore=i.MessageStore;exports.SessionAuthAdapter=i.SessionAuthAdapter;exports.TiledeskTransport=i.TiledeskTransport;exports.clearPersistedConversationId=i.clearPersistedConversationId;exports.createFetchUploadAdapter=i.createFetchUploadAdapter;exports.createPresigned3StepUploadAdapter=i.createPresigned3StepUploadAdapter;exports.createTiledeskHistoryAdapter=i.createTiledeskHistoryAdapter;exports.extractTiledeskFileEnvelope=i.extractTiledeskFileEnvelope;exports.inferTiledeskRole=i.inferTiledeskRole;exports.isTiledeskSelfEcho=i.isTiledeskSelfEcho;exports.mountFromSlug=i.mountFromSlug;exports.mountTenantWidget=i.mount;exports.parseTiledeskTemplate=i.parseTiledeskTemplate;exports.FormBridge=s;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const i=require("./MountTenant-B9HM04oO.cjs");class s extends i.EventEmitter{registration=null;pendingEdits=[];constructor(e){super(),this.setupListeners(e)}registerForm(e){this.registration=e;const t=this.pendingEdits.filter(r=>r.entity_type===e.entityType&&String(r.entity_id)===String(e.entityId));if(t.length>0){for(const r of t)e.onFieldUpdate(r.fields),this.emit("edit:applied",{entityType:r.entity_type,entityId:r.entity_id,fields:r.fields});this.pendingEdits=this.pendingEdits.filter(r=>!(r.entity_type===e.entityType&&String(r.entity_id)===String(e.entityId)))}}unregisterForm(e,t){this.registration?.entityType===e&&String(this.registration?.entityId)===String(t)&&(this.registration=null)}get currentForm(){return this.registration}pushFieldUpdates(e,t,r){this.registration&&this.registration.entityType===e&&String(this.registration.entityId)===String(t)?(this.registration.onFieldUpdate(r),this.emit("edit:applied",{entityType:e,entityId:t,fields:r})):(this.pendingEdits.push({action:"edit_entity",entity_type:e,entity_id:t,fields:r}),this.emit("edit:pending",{entityType:e,entityId:t,fields:r}))}async requestSave(){if(!this.registration)return{success:!1,error:"No form registered"};try{return await this.registration.onSave(),this.emit("save:success",{entityType:this.registration.entityType,entityId:this.registration.entityId}),{success:!0}}catch(e){const t=e instanceof Error?e.message:"Save failed";return this.emit("save:error",{entityType:this.registration.entityType,entityId:this.registration.entityId,error:t}),{success:!1,error:t}}}async requestTest(e){if(!this.registration?.onTest)return{success:!1,error:"Current form does not support testing"};try{return await this.registration.onTest(e),{success:!0}}catch(t){return{success:!1,error:t instanceof Error?t.message:"Test failed"}}}setupListeners(e){e.on("action:edit_entity",t=>{this.pushFieldUpdates(t.entity_type,t.entity_id,t.fields)}),e.on("action:save_entity",t=>{this.requestSave()}),e.on("action:test_tool",t=>{this.emit("test:triggered",{toolId:t.tool_id,parameters:t.parameters}),this.requestTest(t.parameters)})}}exports.ActionCableClient=i.ActionCableClient;exports.AikaaraChatClient=i.AikaaraChatClient;exports.ApiClient=i.ApiClient;exports.ChannelSubscription=i.ChannelSubscription;exports.ConnectionManager=i.ConnectionManager;exports.ConversationManager=i.ConversationManager;exports.EventEmitter=i.EventEmitter;exports.MessageStore=i.MessageStore;exports.SessionAuthAdapter=i.SessionAuthAdapter;exports.TiledeskTransport=i.TiledeskTransport;exports.clearPersistedConversationId=i.clearPersistedConversationId;exports.createFetchUploadAdapter=i.createFetchUploadAdapter;exports.createPresigned3StepUploadAdapter=i.createPresigned3StepUploadAdapter;exports.createTiledeskHistoryAdapter=i.createTiledeskHistoryAdapter;exports.extractTiledeskFileEnvelope=i.extractTiledeskFileEnvelope;exports.inferTiledeskRole=i.inferTiledeskRole;exports.isTiledeskSelfEcho=i.isTiledeskSelfEcho;exports.mountFromSlug=i.mountFromSlug;exports.mountTenantWidget=i.mount;exports.parseTiledeskTemplate=i.parseTiledeskTemplate;exports.FormBridge=s;

package/dist/headless.d.ts

@@ -196,6 +196,13 @@ declare class AikaaraChatWidget extends HTMLElement {
     attributeChangedCallback(_name: string, oldVal: string, newVal: string): void;
     configure(config: Partial<WidgetConfig>): void;
     private getConfig;
+    /**
+     * Mirror the theme tokens onto `document.documentElement` so elements
+     * that live OUTSIDE the chat shadow (e.g. the body-level link modal) can
+     * read them via `--aikaara-*`. The widget shadow already gets a copy via
+     * `themeVars()` for in-widget styling.
+     */
+    private propagateThemeToDocument;
     /**
      * Render `--aikaara-*` CSS variables from a theme-token bag.
      * Tokens are kebab-cased, with `radius` / `bubbleRadius` / `buttonRadius`
@@ -703,6 +710,35 @@ export declare function inferTiledeskRole(message: TiledeskMessage, cfg: Tiledes
  */
 export declare function isTiledeskSelfEcho(message: TiledeskMessage, userId: string): boolean;
 
+/**
+ * Descriptor entry for intercepting link clicks. `match` is a glob pattern
+ * (`*` = any, `?` = single char) tested against the full clicked URL.
+ */
+declare interface LinkHandler {
+    /** Glob pattern matched against the clicked URL. */
+    match: string;
+    /** What to do on match. `tab` opens in new tab, `iframe` uses default modal,
+     * `fetch-render` fetches data and mounts `render` inside the modal. */
+    target?: 'tab' | 'iframe' | 'fetch-render';
+    /** Modal title when `target` involves the modal. Default: link text. */
+    title?: string;
+    /** Fetch config (only used with `target: "fetch-render"`). */
+    fetch?: {
+        url: string;
+        method?: 'GET' | 'POST';
+        headers?: Record<string, string>;
+        body?: Record<string, unknown>;
+        /** Bearer source. `session` (default) | `chat` | `none`. */
+        authHeader?: 'session' | 'chat' | 'none';
+    };
+    /** Custom element name to mount in the modal body (e.g. `aikaara-compare-plans`). */
+    render?: string;
+    /** Properties to call on the rendered element. Each key is a method name
+     *  invoked with one argument: the listed value (parsed/static). Default
+     *  passes the API response via `.setData(<response>)`. */
+    props?: Record<string, unknown>;
+}
+
 export declare interface Message {
     id: string;
     conversationId: string;
@@ -830,6 +866,22 @@ declare interface NavigateAction_2 {
 
 export declare function parseTiledeskTemplate(message: TiledeskMessage): TiledeskParsedTemplate;
 
+/**
+ * One HTTP call run by the SDK before auth. Failure of `soft: true` steps
+ * is logged and ignored; failure of strict steps aborts the mount.
+ */
+declare interface PreflightStep {
+    url: string;
+    method?: 'GET' | 'POST' | 'PUT';
+    body?: Record<string, unknown>;
+    headers?: Record<string, string>;
+    /** Bearer source. Default `session`. `none` skips Authorization. */
+    authHeader?: 'session' | 'none';
+    authHeaderTemplate?: string;
+    /** Continue on non-2xx. Default `false` (mount abort). */
+    soft?: boolean;
+}
+
 /**
  * Three-step presigned-S3 upload (sign → PUT → register). Driven entirely
  * by descriptor — no tenant-specific code in host apps.
@@ -1032,6 +1084,8 @@ export declare interface TenantMountOptions {
     overrides?: Partial<WidgetConfigDescriptor>;
     /** Surfaced from the SDK. */
     onError?: (err: Error) => void;
+    /** Bearer source for descriptor.linkHandlers fetches. */
+    getLinkBearer?: (source: 'session' | 'chat' | 'none') => Promise<string | null>;
 }
 
 export declare interface TestToolAction {
@@ -1441,6 +1495,10 @@ export declare interface WidgetConfig extends ChatClientConfig {
     theme?: 'light' | 'dark' | 'auto';
     /** Token set rendered as `--aikaara-*` CSS variables on the widget host. */
     themeTokens?: WidgetTheme;
+    /** Per-URL-pattern link interceptors (modal renderers, fetch-and-render, etc). */
+    linkHandlers?: LinkHandler[];
+    /** Returns a bearer value for a `linkHandlers[].fetch.authHeader` source. */
+    getLinkBearer?: (source: 'session' | 'chat' | 'none') => Promise<string | null>;
     primaryColor?: string;
     fontFamily?: string;
     borderRadius?: number;
@@ -1537,6 +1595,28 @@ export declare interface WidgetConfigDescriptor {
      * itself — the host app no longer needs a `tokenProvider` callback.
      */
     auth?: SessionAuthDescriptor;
+    /**
+     * HTTP calls fired in order before `auth`. Use for backend warmups whose
+     * side effects the auth call depends on (e.g. bandhan's bootstrap
+     * `/chatbuddy/auth` with no serviceType, which seeds the `customerNew`
+     * Mongo doc that the real auth call later reads). Each entry uses the
+     * caller-supplied session token as bearer by default. URLs support
+     * `{userId}`, `{projectId}`, `{slug}` placeholders.
+     */
+    preflight?: PreflightStep[];
+    /**
+     * Per-URL-pattern interceptors for in-message links. When a `<a href>`
+     * matches one of these, the SDK swaps the default iframe modal for a
+     * fetch-and-render flow:
+     *   1. Extract query/path placeholders from the clicked URL.
+     *   2. Fetch `fetch.url` with bearer auth, populate placeholders.
+     *   3. Mount `render` (a custom element name) inside the link modal,
+     *      passing the parsed JSON via `.setData(data)`.
+     *
+     * No match → default iframe modal. `target: "tab"` on the entry → open
+     * in a new tab without the modal.
+     */
+    linkHandlers?: LinkHandler[];
     /**
      * Built-in upload strategy. `mode: "presigned-3step"` runs sign → PUT →
      * register entirely from descriptor config; `mode: "direct"` POSTs as
@@ -1555,6 +1635,28 @@ export declare interface WidgetConfigDescriptor {
         mode: 'presigned-3step';
         tokenSource?: 'session' | 'chat';
     } & Presigned3StepAdapterConfig);
+    /**
+     * Per-templateId override map. Tells the chat SDK which custom element
+     * tag to mount when a Tiledesk template message arrives carrying the
+     * matching `metadata.templateId`. Optionally lazy-loads the bundle from
+     * `scriptUrl` (typically a `/widget-assets`-uploaded S3 URL); once the
+     * script registers the tag via `customElements.define`, subsequent
+     * renders for that templateId resolve synchronously.
+     *
+     * `props` is a method-call map: each key is a method name on the mounted
+     * element, called with the listed value before the standard
+     * `.setPayload(payload, message)` call.
+     *
+     *   templates: {
+     *     "12": { render: "aikaara-template-form", props: { setLayout: "stacked" } },
+     *     "99": { render: "bandhan-loan-quote", scriptUrl: "https://s3.../loan-quote-v3.iife.js" }
+     *   }
+     */
+    templates?: Record<string, {
+        render: string;
+        scriptUrl?: string;
+        props?: Record<string, unknown>;
+    }>;
 }
 
 /**
@@ -1579,6 +1681,14 @@ declare interface WidgetTheme {
     userBubbleText?: string;
     botBubbleBg?: string;
     botBubbleText?: string;
+    /** Link-modal sizing. `modalWidth`/`modalHeight` are CSS strings (e.g.
+     *  "min(900px, 100%)"); `modalMaxWidth`/`modalMaxHeight` clamp them. */
+    modalWidth?: string;
+    modalHeight?: string;
+    modalMaxWidth?: string;
+    modalMaxHeight?: string;
+    /** Padding around the backdrop (string with units, e.g. "24px"). */
+    modalPadding?: string;
 }
 
 export { }

package/dist/headless.mjs

@@ -1,5 +1,5 @@
-import { E as s } from "./MountTenant-CLlH4Zh6.mjs";
-import { A as p, b as g, k as l, C as h, l as y, m as c, M as u, S as m, T as f, n as T, o as S, p as _, q as v, s as E, t as C, u as F, v as A, w as k, x as I } from "./MountTenant-CLlH4Zh6.mjs";
+import { E as s } from "./MountTenant-CFY0Ou0M.mjs";
+import { A as p, b as g, k as l, C as h, l as y, m as c, M as u, S as m, T as f, n as T, o as S, p as _, q as v, s as E, t as C, u as F, v as A, w as k, x as I } from "./MountTenant-CFY0Ou0M.mjs";
 class a extends s {
   registration = null;
   pendingEdits = [];

package/dist/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./MountTenant-HkluWr4X.cjs"),s=require("./headless.cjs");function l(a){e.registerComponents();const t=document.createElement("aikaara-chat-widget"),i={baseUrl:"base-url",userToken:"user-token",apiKey:"api-key",title:"title",subtitle:"subtitle",theme:"theme",primaryColor:"primary-color",position:"position",width:"width",height:"height",placeholder:"placeholder",welcomeMessage:"welcome-message",avatarUrl:"avatar-url"};for(const[n,o]of Object.entries(i)){const r=a[n];r!=null&&t.setAttribute(o,String(r))}return t.configure(a),document.body.appendChild(t),t}function d(){const a=document.querySelector("aikaara-chat-widget");a&&a.remove()}exports.ActionCableClient=e.ActionCableClient;exports.AikaaraChatBubble=e.AikaaraChatBubble;exports.AikaaraChatClient=e.AikaaraChatClient;exports.AikaaraChatHeader=e.AikaaraChatHeader;exports.AikaaraChatInput=e.AikaaraChatInput;exports.AikaaraChatWidget=e.AikaaraChatWidget;exports.AikaaraErrorBanner=e.AikaaraErrorBanner;exports.AikaaraMessageBubble=e.AikaaraMessageBubble;exports.AikaaraMessageList=e.AikaaraMessageList;exports.AikaaraStreamingMessage=e.AikaaraStreamingMessage;exports.AikaaraTypingIndicator=e.AikaaraTypingIndicator;exports.ApiClient=e.ApiClient;exports.ChannelSubscription=e.ChannelSubscription;exports.ConnectionManager=e.ConnectionManager;exports.ConversationManager=e.ConversationManager;exports.EventEmitter=e.EventEmitter;exports.MessageStore=e.MessageStore;exports.SessionAuthAdapter=e.SessionAuthAdapter;exports.TiledeskTransport=e.TiledeskTransport;exports.clearPersistedConversationId=e.clearPersistedConversationId;exports.createFetchUploadAdapter=e.createFetchUploadAdapter;exports.createPresigned3StepUploadAdapter=e.createPresigned3StepUploadAdapter;exports.createTiledeskHistoryAdapter=e.createTiledeskHistoryAdapter;exports.extractTiledeskFileEnvelope=e.extractTiledeskFileEnvelope;exports.inferTiledeskRole=e.inferTiledeskRole;exports.isTiledeskSelfEcho=e.isTiledeskSelfEcho;exports.mountFromSlug=e.mountFromSlug;exports.mountTenantWidget=e.mount;exports.parseTiledeskTemplate=e.parseTiledeskTemplate;exports.registerComponents=e.registerComponents;exports.FormBridge=s.FormBridge;exports.mount=l;exports.unmount=d;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./MountTenant-B9HM04oO.cjs"),s=require("./headless.cjs");function l(a){e.registerComponents();const t=document.createElement("aikaara-chat-widget"),i={baseUrl:"base-url",userToken:"user-token",apiKey:"api-key",title:"title",subtitle:"subtitle",theme:"theme",primaryColor:"primary-color",position:"position",width:"width",height:"height",placeholder:"placeholder",welcomeMessage:"welcome-message",avatarUrl:"avatar-url"};for(const[n,o]of Object.entries(i)){const r=a[n];r!=null&&t.setAttribute(o,String(r))}return t.configure(a),document.body.appendChild(t),t}function d(){const a=document.querySelector("aikaara-chat-widget");a&&a.remove()}exports.ActionCableClient=e.ActionCableClient;exports.AikaaraChatBubble=e.AikaaraChatBubble;exports.AikaaraChatClient=e.AikaaraChatClient;exports.AikaaraChatHeader=e.AikaaraChatHeader;exports.AikaaraChatInput=e.AikaaraChatInput;exports.AikaaraChatWidget=e.AikaaraChatWidget;exports.AikaaraErrorBanner=e.AikaaraErrorBanner;exports.AikaaraMessageBubble=e.AikaaraMessageBubble;exports.AikaaraMessageList=e.AikaaraMessageList;exports.AikaaraStreamingMessage=e.AikaaraStreamingMessage;exports.AikaaraTypingIndicator=e.AikaaraTypingIndicator;exports.ApiClient=e.ApiClient;exports.ChannelSubscription=e.ChannelSubscription;exports.ConnectionManager=e.ConnectionManager;exports.ConversationManager=e.ConversationManager;exports.EventEmitter=e.EventEmitter;exports.MessageStore=e.MessageStore;exports.SessionAuthAdapter=e.SessionAuthAdapter;exports.TiledeskTransport=e.TiledeskTransport;exports.clearPersistedConversationId=e.clearPersistedConversationId;exports.createFetchUploadAdapter=e.createFetchUploadAdapter;exports.createPresigned3StepUploadAdapter=e.createPresigned3StepUploadAdapter;exports.createTiledeskHistoryAdapter=e.createTiledeskHistoryAdapter;exports.extractTiledeskFileEnvelope=e.extractTiledeskFileEnvelope;exports.inferTiledeskRole=e.inferTiledeskRole;exports.isTiledeskSelfEcho=e.isTiledeskSelfEcho;exports.mountFromSlug=e.mountFromSlug;exports.mountTenantWidget=e.mount;exports.parseTiledeskTemplate=e.parseTiledeskTemplate;exports.registerComponents=e.registerComponents;exports.FormBridge=s.FormBridge;exports.mount=l;exports.unmount=d;

package/dist/index.d.ts

@@ -174,6 +174,13 @@ export declare class AikaaraChatWidget extends HTMLElement {
     attributeChangedCallback(_name: string, oldVal: string, newVal: string): void;
     configure(config: Partial<WidgetConfig>): void;
     private getConfig;
+    /**
+     * Mirror the theme tokens onto `document.documentElement` so elements
+     * that live OUTSIDE the chat shadow (e.g. the body-level link modal) can
+     * read them via `--aikaara-*`. The widget shadow already gets a copy via
+     * `themeVars()` for in-widget styling.
+     */
+    private propagateThemeToDocument;
     /**
      * Render `--aikaara-*` CSS variables from a theme-token bag.
      * Tokens are kebab-cased, with `radius` / `bubbleRadius` / `buttonRadius`
@@ -221,6 +228,9 @@ export declare class AikaaraMessageList extends HTMLElement {
     private container;
     private welcomeMessage;
     private showTimestamps;
+    private linkHandlers;
+    private getLinkBearer;
+    setLinkConfig(handlers: LinkHandler[], bearer?: (source: 'session' | 'chat' | 'none') => Promise<string | null>): void;
     constructor();
     connectedCallback(): void;
     setWelcomeMessage(message: string): void;
@@ -241,6 +251,13 @@ export declare class AikaaraMessageList extends HTMLElement {
     private findRenderedMessage;
     private scrollToBottom;
     private formatTime;
+    /**
+     * Resolve a clicked URL against the descriptor's `linkHandlers`. Mounts
+     * the link modal and either iframes the URL, fetches+renders structured
+     * data, or opens in a new tab depending on the matched handler.
+     */
+    private handleLinkClick;
+    private getOrCreateModal;
 }
 
 export declare class AikaaraStreamingMessage extends HTMLElement {
@@ -613,6 +630,35 @@ export declare function inferTiledeskRole(message: TiledeskMessage, cfg: Tiledes
  */
 export declare function isTiledeskSelfEcho(message: TiledeskMessage, userId: string): boolean;
 
+/**
+ * Descriptor entry for intercepting link clicks. `match` is a glob pattern
+ * (`*` = any, `?` = single char) tested against the full clicked URL.
+ */
+declare interface LinkHandler {
+    /** Glob pattern matched against the clicked URL. */
+    match: string;
+    /** What to do on match. `tab` opens in new tab, `iframe` uses default modal,
+     * `fetch-render` fetches data and mounts `render` inside the modal. */
+    target?: 'tab' | 'iframe' | 'fetch-render';
+    /** Modal title when `target` involves the modal. Default: link text. */
+    title?: string;
+    /** Fetch config (only used with `target: "fetch-render"`). */
+    fetch?: {
+        url: string;
+        method?: 'GET' | 'POST';
+        headers?: Record<string, string>;
+        body?: Record<string, unknown>;
+        /** Bearer source. `session` (default) | `chat` | `none`. */
+        authHeader?: 'session' | 'chat' | 'none';
+    };
+    /** Custom element name to mount in the modal body (e.g. `aikaara-compare-plans`). */
+    render?: string;
+    /** Properties to call on the rendered element. Each key is a method name
+     *  invoked with one argument: the listed value (parsed/static). Default
+     *  passes the API response via `.setData(<response>)`. */
+    props?: Record<string, unknown>;
+}
+
 export declare interface Message {
     id: string;
     conversationId: string;
@@ -712,6 +758,22 @@ export declare interface NavigateAction {
 
 export declare function parseTiledeskTemplate(message: TiledeskMessage): TiledeskParsedTemplate;
 
+/**
+ * One HTTP call run by the SDK before auth. Failure of `soft: true` steps
+ * is logged and ignored; failure of strict steps aborts the mount.
+ */
+declare interface PreflightStep {
+    url: string;
+    method?: 'GET' | 'POST' | 'PUT';
+    body?: Record<string, unknown>;
+    headers?: Record<string, string>;
+    /** Bearer source. Default `session`. `none` skips Authorization. */
+    authHeader?: 'session' | 'none';
+    authHeaderTemplate?: string;
+    /** Continue on non-2xx. Default `false` (mount abort). */
+    soft?: boolean;
+}
+
 /**
  * Three-step presigned-S3 upload (sign → PUT → register). Driven entirely
  * by descriptor — no tenant-specific code in host apps.
@@ -901,6 +963,8 @@ export declare interface TenantMountOptions {
     overrides?: Partial<WidgetConfigDescriptor>;
     /** Surfaced from the SDK. */
     onError?: (err: Error) => void;
+    /** Bearer source for descriptor.linkHandlers fetches. */
+    getLinkBearer?: (source: 'session' | 'chat' | 'none') => Promise<string | null>;
 }
 
 export declare interface TestToolAction {
@@ -1182,6 +1246,10 @@ export declare interface WidgetConfig extends ChatClientConfig {
     theme?: 'light' | 'dark' | 'auto';
     /** Token set rendered as `--aikaara-*` CSS variables on the widget host. */
     themeTokens?: WidgetTheme;
+    /** Per-URL-pattern link interceptors (modal renderers, fetch-and-render, etc). */
+    linkHandlers?: LinkHandler[];
+    /** Returns a bearer value for a `linkHandlers[].fetch.authHeader` source. */
+    getLinkBearer?: (source: 'session' | 'chat' | 'none') => Promise<string | null>;
     primaryColor?: string;
     fontFamily?: string;
     borderRadius?: number;
@@ -1278,6 +1346,28 @@ export declare interface WidgetConfigDescriptor {
      * itself — the host app no longer needs a `tokenProvider` callback.
      */
     auth?: SessionAuthDescriptor;
+    /**
+     * HTTP calls fired in order before `auth`. Use for backend warmups whose
+     * side effects the auth call depends on (e.g. bandhan's bootstrap
+     * `/chatbuddy/auth` with no serviceType, which seeds the `customerNew`
+     * Mongo doc that the real auth call later reads). Each entry uses the
+     * caller-supplied session token as bearer by default. URLs support
+     * `{userId}`, `{projectId}`, `{slug}` placeholders.
+     */
+    preflight?: PreflightStep[];
+    /**
+     * Per-URL-pattern interceptors for in-message links. When a `<a href>`
+     * matches one of these, the SDK swaps the default iframe modal for a
+     * fetch-and-render flow:
+     *   1. Extract query/path placeholders from the clicked URL.
+     *   2. Fetch `fetch.url` with bearer auth, populate placeholders.
+     *   3. Mount `render` (a custom element name) inside the link modal,
+     *      passing the parsed JSON via `.setData(data)`.
+     *
+     * No match → default iframe modal. `target: "tab"` on the entry → open
+     * in a new tab without the modal.
+     */
+    linkHandlers?: LinkHandler[];
     /**
      * Built-in upload strategy. `mode: "presigned-3step"` runs sign → PUT →
      * register entirely from descriptor config; `mode: "direct"` POSTs as
@@ -1296,6 +1386,28 @@ export declare interface WidgetConfigDescriptor {
         mode: 'presigned-3step';
         tokenSource?: 'session' | 'chat';
     } & Presigned3StepAdapterConfig);
+    /**
+     * Per-templateId override map. Tells the chat SDK which custom element
+     * tag to mount when a Tiledesk template message arrives carrying the
+     * matching `metadata.templateId`. Optionally lazy-loads the bundle from
+     * `scriptUrl` (typically a `/widget-assets`-uploaded S3 URL); once the
+     * script registers the tag via `customElements.define`, subsequent
+     * renders for that templateId resolve synchronously.
+     *
+     * `props` is a method-call map: each key is a method name on the mounted
+     * element, called with the listed value before the standard
+     * `.setPayload(payload, message)` call.
+     *
+     *   templates: {
+     *     "12": { render: "aikaara-template-form", props: { setLayout: "stacked" } },
+     *     "99": { render: "bandhan-loan-quote", scriptUrl: "https://s3.../loan-quote-v3.iife.js" }
+     *   }
+     */
+    templates?: Record<string, {
+        render: string;
+        scriptUrl?: string;
+        props?: Record<string, unknown>;
+    }>;
 }
 
 /**
@@ -1320,6 +1432,14 @@ declare interface WidgetTheme {
     userBubbleText?: string;
     botBubbleBg?: string;
     botBubbleText?: string;
+    /** Link-modal sizing. `modalWidth`/`modalHeight` are CSS strings (e.g.
+     *  "min(900px, 100%)"); `modalMaxWidth`/`modalMaxHeight` clamp them. */
+    modalWidth?: string;
+    modalHeight?: string;
+    modalMaxWidth?: string;
+    modalMaxHeight?: string;
+    /** Padding around the backdrop (string with units, e.g. "24px"). */
+    modalPadding?: string;
 }
 
 export { }

package/dist/index.mjs

@@ -1,5 +1,5 @@
-import { r as o } from "./MountTenant-CLlH4Zh6.mjs";
-import { A as u, a as m, b as g, c as h, d as k, e as A, f as C, g as b, h as f, i as T, j as v, k as S, C as w, l as y, m as M, E, M as x, S as B, T as F, n as U, o as I, p as j, q, s as H, t as P, u as W, v as K, w as L, x as O } from "./MountTenant-CLlH4Zh6.mjs";
+import { r as o } from "./MountTenant-CFY0Ou0M.mjs";
+import { A as u, a as m, b as g, c as h, d as k, e as A, f as C, g as b, h as f, i as T, j as v, k as S, C as w, l as y, m as M, E, M as x, S as B, T as F, n as U, o as I, p as j, q, s as H, t as P, u as W, v as K, w as L, x as O } from "./MountTenant-CFY0Ou0M.mjs";
 import { FormBridge as z } from "./headless.mjs";
 function l(e) {
   o();

package/dist/ui.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const a=require("./MountTenant-HkluWr4X.cjs");exports.AikaaraChat=a.AikaaraChat;exports.AikaaraChatBubble=a.AikaaraChatBubble;exports.AikaaraChatHeader=a.AikaaraChatHeader;exports.AikaaraChatInput=a.AikaaraChatInput;exports.AikaaraChatWidget=a.AikaaraChatWidget;exports.AikaaraErrorBanner=a.AikaaraErrorBanner;exports.AikaaraMessageBubble=a.AikaaraMessageBubble;exports.AikaaraMessageList=a.AikaaraMessageList;exports.AikaaraModalAction=a.AikaaraModalAction;exports.AikaaraOptionList=a.AikaaraOptionList;exports.AikaaraStreamingMessage=a.AikaaraStreamingMessage;exports.AikaaraSubmitAction=a.AikaaraSubmitAction;exports.AikaaraSystemPill=a.AikaaraSystemPill;exports.AikaaraTemplateRenderer=a.AikaaraTemplateRenderer;exports.AikaaraTypingIndicator=a.AikaaraTypingIndicator;exports.registerComponents=a.registerComponents;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const a=require("./MountTenant-B9HM04oO.cjs");exports.AikaaraChat=a.AikaaraChat;exports.AikaaraChatBubble=a.AikaaraChatBubble;exports.AikaaraChatHeader=a.AikaaraChatHeader;exports.AikaaraChatInput=a.AikaaraChatInput;exports.AikaaraChatWidget=a.AikaaraChatWidget;exports.AikaaraComparePlans=a.AikaaraComparePlans;exports.AikaaraErrorBanner=a.AikaaraErrorBanner;exports.AikaaraLinkModal=a.AikaaraLinkModal;exports.AikaaraMessageBubble=a.AikaaraMessageBubble;exports.AikaaraMessageList=a.AikaaraMessageList;exports.AikaaraModalAction=a.AikaaraModalAction;exports.AikaaraOptionList=a.AikaaraOptionList;exports.AikaaraStreamingMessage=a.AikaaraStreamingMessage;exports.AikaaraSubmitAction=a.AikaaraSubmitAction;exports.AikaaraSystemPill=a.AikaaraSystemPill;exports.AikaaraTemplateRenderer=a.AikaaraTemplateRenderer;exports.AikaaraTypingIndicator=a.AikaaraTypingIndicator;exports.registerComponents=a.registerComponents;

package/dist/ui.d.ts

@@ -175,6 +175,13 @@ export declare class AikaaraChatWidget extends HTMLElement {
     attributeChangedCallback(_name: string, oldVal: string, newVal: string): void;
     configure(config: Partial<WidgetConfig>): void;
     private getConfig;
+    /**
+     * Mirror the theme tokens onto `document.documentElement` so elements
+     * that live OUTSIDE the chat shadow (e.g. the body-level link modal) can
+     * read them via `--aikaara-*`. The widget shadow already gets a copy via
+     * `themeVars()` for in-widget styling.
+     */
+    private propagateThemeToDocument;
     /**
      * Render `--aikaara-*` CSS variables from a theme-token bag.
      * Tokens are kebab-cased, with `radius` / `bubbleRadius` / `buttonRadius`
@@ -190,6 +197,21 @@ export declare class AikaaraChatWidget extends HTMLElement {
     private darkenColor;
 }
 
+export declare class AikaaraComparePlans extends HTMLElement {
+    private shadow;
+    private data;
+    private columns;
+    private features;
+    constructor();
+    connectedCallback(): void;
+    /** Set the `/itr/plans` API response. Triggers re-render. */
+    setData(data: PlansResponse): void;
+    setColumns(columns: Column[]): void;
+    setFeatures(features: FeatureRow[]): void;
+    private priceFor;
+    private render;
+}
+
 export declare class AikaaraErrorBanner extends HTMLElement {
     private shadow;
     private container;
@@ -200,6 +222,35 @@ export declare class AikaaraErrorBanner extends HTMLElement {
     hide(): void;
 }
 
+/**
+ * `<aikaara-link-modal>` — overlay dialog that loads an external URL in an
+ * iframe inside the chat widget instead of navigating away.
+ *
+ * Triggered by clicks on `<a href>` inside bot/assistant bubbles when the
+ * widget is configured to intercept them (default behaviour). Listens for
+ * `aikaara-open-link` on document; emits `aikaara-link-modal-open` /
+ * `aikaara-link-modal-close` for instrumentation.
+ *
+ * Falls back to opening the URL in a new tab if the iframe fails to load
+ * (e.g. upstream sets `X-Frame-Options: DENY`).
+ */
+export declare class AikaaraLinkModal extends HTMLElement {
+    private shadow;
+    private root;
+    private iframe;
+    private fallbackTimer;
+    constructor();
+    connectedCallback(): void;
+    /** Open the modal pointed at `url`. */
+    show(url: string, title?: string): void;
+    /** Open modal with a custom element mounted in the body. */
+    showElement(tagName: string, title?: string, configure?: (el: HTMLElement) => void): void;
+    /** Toggle which body slot is visible (iframe vs custom element host). */
+    private swapBody;
+    close(): void;
+    private render;
+}
+
 export declare class AikaaraMessageBubble extends HTMLElement {
     private shadow;
     private templatePayload;
@@ -222,6 +273,9 @@ export declare class AikaaraMessageList extends HTMLElement {
     private container;
     private welcomeMessage;
     private showTimestamps;
+    private linkHandlers;
+    private getLinkBearer;
+    setLinkConfig(handlers: LinkHandler[], bearer?: (source: 'session' | 'chat' | 'none') => Promise<string | null>): void;
     constructor();
     connectedCallback(): void;
     setWelcomeMessage(message: string): void;
@@ -242,6 +296,13 @@ export declare class AikaaraMessageList extends HTMLElement {
     private findRenderedMessage;
     private scrollToBottom;
     private formatTime;
+    /**
+     * Resolve a clicked URL against the descriptor's `linkHandlers`. Mounts
+     * the link modal and either iframes the URL, fetches+renders structured
+     * data, or opens in a new tab depending on the matched handler.
+     */
+    private handleLinkClick;
+    private getOrCreateModal;
 }
 
 export declare class AikaaraModalAction extends HTMLElement {
@@ -481,6 +542,19 @@ declare interface ChatEvents {
     };
 }
 
+declare interface Column {
+    /** Column header text. */
+    label: string;
+    /** API `planType` value(s) this column corresponds to. First match wins. */
+    match: string[];
+    /** Submit-button label template. `{price}` is replaced with the basePrice. */
+    selectLabel: string;
+    /** Postback `message` value sent to the chat when this column is selected. */
+    postback: string;
+    /** Which features (by row index in `featureRows`) are enabled in this column. */
+    features: boolean[];
+}
+
 declare interface ConnectionConfig {
     baseUrl: string;
     wsUrl?: string;
@@ -546,12 +620,45 @@ declare class EventEmitter<Events extends Record<string, any>> {
     removeAllListeners(): void;
 }
 
+declare interface FeatureRow {
+    label: string;
+}
+
 declare interface FieldUpdate {
     field: string;
     value: unknown;
     previousValue?: unknown;
 }
 
+/**
+ * Descriptor entry for intercepting link clicks. `match` is a glob pattern
+ * (`*` = any, `?` = single char) tested against the full clicked URL.
+ */
+declare interface LinkHandler {
+    /** Glob pattern matched against the clicked URL. */
+    match: string;
+    /** What to do on match. `tab` opens in new tab, `iframe` uses default modal,
+     * `fetch-render` fetches data and mounts `render` inside the modal. */
+    target?: 'tab' | 'iframe' | 'fetch-render';
+    /** Modal title when `target` involves the modal. Default: link text. */
+    title?: string;
+    /** Fetch config (only used with `target: "fetch-render"`). */
+    fetch?: {
+        url: string;
+        method?: 'GET' | 'POST';
+        headers?: Record<string, string>;
+        body?: Record<string, unknown>;
+        /** Bearer source. `session` (default) | `chat` | `none`. */
+        authHeader?: 'session' | 'chat' | 'none';
+    };
+    /** Custom element name to mount in the modal body (e.g. `aikaara-compare-plans`). */
+    render?: string;
+    /** Properties to call on the rendered element. Each key is a method name
+     *  invoked with one argument: the listed value (parsed/static). Default
+     *  passes the API response via `.setData(<response>)`. */
+    props?: Record<string, unknown>;
+}
+
 declare interface Message {
     id: string;
     conversationId: string;
@@ -666,6 +773,31 @@ declare interface OptionListPayload {
     type: 'checkbox' | 'radio' | 'button';
 }
 
+/**
+ * `<aikaara-compare-plans>` — built-in renderer for bandhan-style plan
+ * comparison popups. Configured by `descriptor.linkHandlers` to fire when
+ * the user taps a "Compare DIY with Assisted Plan" link inside a chat
+ * message. Receives the raw `/itr/plans` API response via `.setData()` and
+ * an optional `.setColumns([...])` override (defaults to DIY/DIY+Notice/
+ * Assisted matching the bandhan UI).
+ *
+ * Pure presentation. Selecting a plan emits an `aikaara-plan-select`
+ * CustomEvent (composed) so the host app or template renderer can route the
+ * postback through the chat (`message`-style action).
+ */
+declare interface PlanRow {
+    planType: string;
+    planMaster?: {
+        basePrice?: number;
+        totalAmount?: number;
+    };
+}
+
+declare interface PlansResponse {
+    success?: boolean;
+    data?: PlanRow[];
+}
+
 export declare function registerComponents(): void;
 
 declare interface SaveEntityAction {
@@ -988,6 +1120,10 @@ declare interface WidgetConfig extends ChatClientConfig {
     theme?: 'light' | 'dark' | 'auto';
     /** Token set rendered as `--aikaara-*` CSS variables on the widget host. */
     themeTokens?: WidgetTheme;
+    /** Per-URL-pattern link interceptors (modal renderers, fetch-and-render, etc). */
+    linkHandlers?: LinkHandler[];
+    /** Returns a bearer value for a `linkHandlers[].fetch.authHeader` source. */
+    getLinkBearer?: (source: 'session' | 'chat' | 'none') => Promise<string | null>;
     primaryColor?: string;
     fontFamily?: string;
     borderRadius?: number;
@@ -1034,6 +1170,14 @@ declare interface WidgetTheme {
     userBubbleText?: string;
     botBubbleBg?: string;
     botBubbleText?: string;
+    /** Link-modal sizing. `modalWidth`/`modalHeight` are CSS strings (e.g.
+     *  "min(900px, 100%)"); `modalMaxWidth`/`modalMaxHeight` clamp them. */
+    modalWidth?: string;
+    modalHeight?: string;
+    modalMaxWidth?: string;
+    modalMaxHeight?: string;
+    /** Padding around the backdrop (string with units, e.g. "24px"). */
+    modalPadding?: string;
 }
 
 export { }

package/dist/ui.mjs

@@ -1,19 +1,21 @@
-import { y as i, a as s, c as e, d as t, e as A, f as k, g as n, h as o, z as g, B as d, i as h, D as l, F as m, G as p, j as C, r as b } from "./MountTenant-CLlH4Zh6.mjs";
+import { y as i, a as s, c as e, d as t, e as A, z as k, f as n, B as o, g, h as l, D as d, F as m, i as p, G as C, H as h, I as b, j as M, r as c } from "./MountTenant-CFY0Ou0M.mjs";
 export {
   i as AikaaraChat,
   s as AikaaraChatBubble,
   e as AikaaraChatHeader,
   t as AikaaraChatInput,
   A as AikaaraChatWidget,
-  k as AikaaraErrorBanner,
-  n as AikaaraMessageBubble,
-  o as AikaaraMessageList,
-  g as AikaaraModalAction,
-  d as AikaaraOptionList,
-  h as AikaaraStreamingMessage,
-  l as AikaaraSubmitAction,
-  m as AikaaraSystemPill,
-  p as AikaaraTemplateRenderer,
-  C as AikaaraTypingIndicator,
-  b as registerComponents
+  k as AikaaraComparePlans,
+  n as AikaaraErrorBanner,
+  o as AikaaraLinkModal,
+  g as AikaaraMessageBubble,
+  l as AikaaraMessageList,
+  d as AikaaraModalAction,
+  m as AikaaraOptionList,
+  p as AikaaraStreamingMessage,
+  C as AikaaraSubmitAction,
+  h as AikaaraSystemPill,
+  b as AikaaraTemplateRenderer,
+  M as AikaaraTypingIndicator,
+  c as registerComponents
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aikaara/chat-sdk",
-  "version": "0.6.1",
+  "version": "0.7.0",
   "type": "module",
   "description": "Aikaara Chat SDK — embeddable chat widget and headless client",
   "license": "MIT",