@visma-swno/gaia-chat-ui 2.1.3 → 4.0.0

package/CHANGELOG.md

@@ -1,5 +1,52 @@
 # Changelog
 
+## [4.0.0](https://github.com/visma-swno/vsn-assistant/compare/web-component@v3.0.0...web-component@v4.0.0) (2025-12-02)
+
+
+### Features
+
+* add Dutch and Finnish language support ([#1488](https://github.com/visma-swno/vsn-assistant/issues/1488)) ([1e2bf12](https://github.com/visma-swno/vsn-assistant/commit/1e2bf12b9fb544a248b1e666d2684efbceb9a93c))
+* add icon component ([#1209](https://github.com/visma-swno/vsn-assistant/issues/1209)) ([ec48ccd](https://github.com/visma-swno/vsn-assistant/commit/ec48ccd63c1737388168a40431b28d6dd7cd2931))
+* add popover/tooltip component for icon buttons ([#1169](https://github.com/visma-swno/vsn-assistant/issues/1169)) ([#1318](https://github.com/visma-swno/vsn-assistant/issues/1318)) ([9eeed50](https://github.com/visma-swno/vsn-assistant/commit/9eeed50f2b502f618dd0a11dcc244e6cc8cd486d))
+* implement Host Context API for context-aware conversations ([#1313](https://github.com/visma-swno/vsn-assistant/issues/1313)) ([3a7a973](https://github.com/visma-swno/vsn-assistant/commit/3a7a9733c4f6d6c21d1952c137a36e7f3ccc88f0))
+* **support:** web-component sends outbound support requests over HTTP ([#1435](https://github.com/visma-swno/vsn-assistant/issues/1435)) ([0f6c5a0](https://github.com/visma-swno/vsn-assistant/commit/0f6c5a0693f21bab2f312d3d987d7ce16eea763b))
+* **web-component:** support relative image sources ([#1487](https://github.com/visma-swno/vsn-assistant/issues/1487)) ([6ccc8f9](https://github.com/visma-swno/vsn-assistant/commit/6ccc8f91a1305c13422f1ffa7e444b5cb92ba7b7))
+
+
+### Bug Fixes
+
+* add white background ([#1207](https://github.com/visma-swno/vsn-assistant/issues/1207)) ([9fb01d4](https://github.com/visma-swno/vsn-assistant/commit/9fb01d4b0579f195915243ed5e39d0d726d43b65)), closes [#1202](https://github.com/visma-swno/vsn-assistant/issues/1202)
+* **deps:** bump js-yaml from 4.1.0 to 4.1.1 in /web-component ([#1408](https://github.com/visma-swno/vsn-assistant/issues/1408)) ([475aa18](https://github.com/visma-swno/vsn-assistant/commit/475aa1893ce03351785a1031cab3f4bf29fa1c53))
+* popover is hidden when slot element is disabled ([#1334](https://github.com/visma-swno/vsn-assistant/issues/1334)) ([fe78b8f](https://github.com/visma-swno/vsn-assistant/commit/fe78b8fc936b06db2b91d504ee4cb62c73963a46))
+* re-add supporthub methods so support both old and new gaia-chat ([#1438](https://github.com/visma-swno/vsn-assistant/issues/1438)) ([ae86b2d](https://github.com/visma-swno/vsn-assistant/commit/ae86b2d76bf05050e213f24c499130475c4c6a15))
+
+
+### Build System
+
+* **deps-dev:** bump happy-dom from 19.0.2 to 20.0.0 in /web-component in the npm_and_yarn group across 1 directory ([#1187](https://github.com/visma-swno/vsn-assistant/issues/1187)) ([1aab790](https://github.com/visma-swno/vsn-assistant/commit/1aab790aac45be55497fe29ddc82ca542e30ef69))
+
+## [3.0.0](https://github.com/visma-swno/vsn-assistant/compare/web-component@v2.1.3...web-component@v3.0.0) (2025-10-14)
+
+
+### ⚠ BREAKING CHANGES
+
+* The authentication system has been completely redesigned for better flexibility and security.
+* **deps-dev:** <a href="https://redirect.github.com/capricorn86/happy-dom/issues/1620">#1620</a> Release v18.0.0</li> <li>See full diff in <a href="https://github.com/capricorn86/happy-dom/compare/v18.0.1...v19.0.2">compare view</a></li> </ul> </details> <br />
+
+### Features
+
+* add on-demand callback for token refresh ([#1192](https://github.com/visma-swno/vsn-assistant/issues/1192)) ([e5d6918](https://github.com/visma-swno/vsn-assistant/commit/e5d6918a9dc3eacecb2a4df77e724b9a53805a85))
+
+
+### Bug Fixes
+
+* add fixed container sizes ([#1188](https://github.com/visma-swno/vsn-assistant/issues/1188)) ([b2b30c9](https://github.com/visma-swno/vsn-assistant/commit/b2b30c91da672beff532409436ab3037f53c66bc))
+
+
+### Build System
+
+* **deps-dev:** bump happy-dom from 18.0.1 to 19.0.2 in /web-component ([#1158](https://github.com/visma-swno/vsn-assistant/issues/1158)) ([8eb4203](https://github.com/visma-swno/vsn-assistant/commit/8eb420315bbf0f2daae0b121570aba374c5af7a5))
+
 ## [2.1.3](https://github.com/visma-swno/vsn-assistant/compare/web-component@v2.1.2...web-component@v2.1.3) (2025-09-26)
 
 

package/README.md

@@ -1,6 +1,6 @@
 # @visma-swno/gaia-chat-ui
 
-Web component library for the Gaia Assistant Chat UI, built with Lit for Visma Software Nordic products.
+Web component library for the GAiA Assistant Chat UI, built with Lit for Visma Software Nordic products.
 
 ## Installation
 
@@ -21,13 +21,35 @@ import '@visma-swno/gaia-chat-ui';
 ```
 
 ```html
-<gaia-chat 
-  profile-id="default" 
-  base-url="https://your-api-endpoint.com" 
-  is-visitor>
+<gaia-chat
+  profile-id="YOUR_PROFILE_ID"
+  base-url="https://api.assistant.vsn.dev"
+  auth-strategy="visitor"
+>
 </gaia-chat>
 ```
 
+For authenticated Visma users, switch to the Visma strategy and provide a token provider. Implement caching and refresh: reuse a valid token until shortly before its `exp` claim, then silently refresh.
+
+```html
+<gaia-chat
+  id="assistant"
+  profile-id="YOUR_PROFILE_ID"
+  base-url="https://api.assistant.vsn.dev"
+  auth-strategy="visma"
+>
+</gaia-chat>
+<script type="module">
+  const assistant = document.getElementById('assistant');
+
+  assistant.tokenProvider = async () => {
+    const res = await fetch('/api/auth/assistant-token');
+    const { token } = await res.json();
+    return token;
+  };
+</script>
+```
+
 ## Documentation
 
 For detailed documentation and development instructions, see the [main repository](https://github.com/visma-swno/vsn-assistant).

package/dist/app/app.d.ts

@@ -0,0 +1,41 @@
+import { PropertyValues } from 'lit';
+import { TokenProvider } from '../auth/types';
+import { HostContextProvider } from '../core/types/host-context';
+import { StrategyType } from '../auth/strategy-factory';
+import { BaseElement } from '../components/shared/base-element';
+export declare class ChatApp extends BaseElement {
+    static styles: import('lit').CSSResult[];
+    baseUrl: string;
+    profileId: string;
+    /**
+     * @deprecated Use hostContextProvider instead
+     */
+    supportPartnerId?: string;
+    tokenProvider?: TokenProvider;
+    hostContextProvider?: HostContextProvider;
+    authStrategy: StrategyType;
+    closeable: boolean;
+    private langObserver?;
+    private store;
+    private bootstrapEffect;
+    private streamEffect;
+    private supportEffect;
+    private conversationEffect;
+    private feedbackEffect;
+    private state;
+    private isConnectedToSupport;
+    private unsubscribe?;
+    private strategyFactory;
+    private authProvider;
+    private apiClient;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    private handleAuthChanged;
+    willUpdate(changedProperties: PropertyValues): void;
+    render(): import('lit-html').TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'gaia-chat': ChatApp;
+    }
+}

package/dist/app/app.styles.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import('lit').CSSResult;
+export default _default;

package/dist/{src/app → app}/controllers/error-controller.d.ts

@@ -8,4 +8,3 @@ export declare class ErrorController implements ReactiveController {
     private onOffline;
     private onOnline;
 }
-//# sourceMappingURL=error-controller.d.ts.map

package/dist/{src/app → app}/localization.d.ts

@@ -3,5 +3,4 @@ export declare const getLocale: (() => string) & {
 }, setLocale: ((newLocale: string) => Promise<void>) & {
     _LIT_LOCALIZE_SET_LOCALE_?: never;
 };
-export declare function parseLocaleCode(locale: string): "en" | "da" | "nb" | "sv";
-//# sourceMappingURL=localization.d.ts.map
+export declare function parseLocaleCode(locale: string): "en" | "da" | "fi" | "nb" | "nl" | "sv";

package/dist/auth/auth-errors.d.ts

@@ -0,0 +1,17 @@
+export declare class AuthError extends Error {
+    readonly code: string;
+    constructor(message: string, code: string);
+}
+export declare class TokenExpiredError extends AuthError {
+    constructor();
+}
+export declare class TokenInvalidError extends AuthError {
+    constructor(reason?: string);
+}
+export declare class TokenRefreshError extends AuthError {
+    readonly innerError?: unknown | undefined;
+    constructor(innerError?: unknown | undefined);
+}
+export declare class StrategyNotConfiguredError extends AuthError {
+    constructor();
+}

package/dist/auth/auth-provider.d.ts

@@ -0,0 +1,10 @@
+import { AuthStrategy } from './strategies/base-strategy';
+export declare class AuthProvider {
+    private strategy;
+    useStrategy(strategy: AuthStrategy): void;
+    getStrategy(): AuthStrategy;
+    getIdentifier(): string | null;
+    getAccessToken(): Promise<string | null>;
+    refresh(): Promise<void>;
+    clear(): void;
+}

package/dist/auth/strategies/base-strategy.d.ts

@@ -0,0 +1,21 @@
+import { TokenParser } from '../token-parser';
+import { TokenStorage } from '../types';
+import { TokenCache } from '../token-cache';
+export interface AuthStrategy {
+    getName(): string;
+    getIdentifier(): string | null;
+    getAccessToken(): Promise<string | null>;
+    refresh(): Promise<void>;
+    clear(): void;
+}
+export declare abstract class BaseAuthStrategy implements AuthStrategy {
+    protected readonly parser: TokenParser;
+    protected readonly cache: TokenCache;
+    constructor(parser: TokenParser, storage?: TokenStorage);
+    abstract getName(): string;
+    protected abstract fetchToken(): Promise<string>;
+    getIdentifier(): string | null;
+    getAccessToken(): Promise<string | null>;
+    refresh(): Promise<void>;
+    clear(): void;
+}

package/dist/auth/strategies/null-auth-strategy.d.ts

@@ -0,0 +1,8 @@
+import { AuthStrategy } from './base-strategy';
+export declare class NullAuthStrategy implements AuthStrategy {
+    getName(): string;
+    getIdentifier(): string | null;
+    getAccessToken(): Promise<string | null>;
+    refresh(): Promise<void>;
+    clear(): void;
+}

package/dist/auth/strategies/visitor-token-strategy.d.ts

@@ -0,0 +1,9 @@
+import { TokenParser } from '../token-parser';
+import { TokenStorage } from '../types';
+import { BaseAuthStrategy } from './base-strategy';
+export declare class VisitorTokenStrategy extends BaseAuthStrategy {
+    private readonly baseUrl;
+    constructor(baseUrl: string, parser: TokenParser, storage?: TokenStorage);
+    getName(): string;
+    protected fetchToken(): Promise<string>;
+}

package/dist/auth/strategies/visma-token-strategy.d.ts

@@ -0,0 +1,9 @@
+import { TokenParser } from '../token-parser';
+import { TokenProvider } from '../types';
+import { BaseAuthStrategy } from './base-strategy';
+export declare class VismaTokenStrategy extends BaseAuthStrategy {
+    private readonly tokenProvider;
+    constructor(tokenProvider: TokenProvider, parser: TokenParser);
+    getName(): string;
+    protected fetchToken(): Promise<string>;
+}

package/dist/auth/strategy-factory.d.ts

@@ -0,0 +1,13 @@
+import { AuthStrategy } from './strategies/base-strategy';
+import { TokenProvider, TokenStorage } from './types';
+import { TokenParser } from './token-parser';
+export type StrategyType = 'visma' | 'visitor';
+export interface StrategyFactoryConfig {
+    parser?: TokenParser;
+    storage?: TokenStorage;
+}
+export declare class StrategyFactory {
+    private readonly config;
+    constructor(config: StrategyFactoryConfig);
+    create(type: StrategyType, tokenProvider?: TokenProvider, baseUrl?: string): AuthStrategy;
+}

package/dist/auth/token-cache.d.ts

@@ -0,0 +1,17 @@
+import { TokenParser } from './token-parser';
+import { TokenInfo, TokenStorage } from './types';
+export declare class TokenCache {
+    private readonly parser;
+    private readonly storage?;
+    private currentToken;
+    private refreshPromise;
+    constructor(parser: TokenParser, storage?: TokenStorage | undefined);
+    private loadFromStorage;
+    get(): TokenInfo | null;
+    set(token: string): TokenInfo;
+    clear(): void;
+    isExpired(): boolean;
+    getIdentifier(): string | null;
+    refreshWith(refreshFn: () => Promise<string>): Promise<TokenInfo | null>;
+    private performRefresh;
+}

package/dist/auth/token-parser.d.ts

@@ -0,0 +1,6 @@
+import { TokenInfo } from './types';
+export declare class TokenParser {
+    parse(token: string): TokenInfo;
+    isExpired(tokenInfo: TokenInfo): boolean;
+    getTimeToExpiry(tokenInfo: TokenInfo): number;
+}

package/dist/auth/types.d.ts

@@ -0,0 +1,17 @@
+export type TokenProvider = () => Promise<string>;
+export interface DecodedToken {
+    exp: number;
+    sub: string;
+    [key: string]: unknown;
+}
+export interface TokenInfo {
+    raw: string;
+    decoded: DecodedToken;
+    expiresAt: number;
+    subject: string;
+}
+export interface TokenStorage {
+    load(): string | null;
+    save(token: string): void;
+    clear(): void;
+}

package/dist/components/app-header/app-header.d.ts

@@ -0,0 +1,25 @@
+import { IConversationEffect } from '../../core/effects/conversation-effect';
+import { ISupportEffect } from '../../core/effects/support-effect';
+import { BaseElement } from '../shared/base-element';
+import { AppStore } from '../../core/state';
+export default class GaiaAppHeader extends BaseElement {
+    static styles: import('lit').CSSResult[];
+    store: AppStore;
+    conversationEffect: IConversationEffect;
+    supportEffect: ISupportEffect;
+    private disabled;
+    private isFeedbackOpen;
+    closeable: boolean;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    private unsubscribe?;
+    private handleClearConversation;
+    private handleToggleFeedback;
+    private handleCloseChat;
+    render(): import('lit-html').TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'gaia-app-header': GaiaAppHeader;
+    }
+}

package/dist/components/app-header/app-header.styles.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import('lit').CSSResult;
+export default _default;

package/dist/components/avatar/avatar.d.ts

@@ -0,0 +1,17 @@
+import { IconName } from '../icon/icon-library';
+import { BaseElement } from '../shared/base-element';
+export default class GaiaAvatar extends BaseElement {
+    static styles: import('lit').CSSResult[];
+    private hasError;
+    label: string;
+    image: string | undefined;
+    icon: IconName;
+    bordered: boolean;
+    private handleImageLoadError;
+    render(): import('lit-html').TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'gaia-avatar': GaiaAvatar;
+    }
+}

package/dist/components/avatar/avatar.styles.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import('lit').CSSResult;
+export default _default;

package/dist/components/button/button.d.ts

@@ -0,0 +1,16 @@
+import { BaseElement } from '../shared/base-element';
+export default class GaiaButton extends BaseElement {
+    static styles: import('lit').CSSResult[];
+    labelSlot: HTMLSlotElement;
+    private isIconButton;
+    variant: 'primary' | 'secondary' | 'ghost' | 'transparent';
+    disabled: boolean;
+    loading: boolean;
+    private handleLabelSlotChange;
+    render(): import('lit-html').TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'gaia-button': GaiaButton;
+    }
+}

package/dist/components/button/button.styles.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import('lit').CSSResult;
+export default _default;

package/dist/components/conversation/conversation.d.ts

@@ -0,0 +1,39 @@
+import { PropertyValues } from 'lit';
+import { UiMessage } from '../../core/types';
+import { BaseElement } from '../shared/base-element';
+export declare class GaiaConversation extends BaseElement {
+    static styles: import('lit').CSSResult[];
+    private containerRef;
+    private scrollViewRef;
+    private lastMessageRef;
+    private scrollController;
+    private store;
+    private streamEffect;
+    private supportEffect;
+    private conversationEffect;
+    private welcomeMessage?;
+    private isThinking;
+    private isFeedbackOpen;
+    private channel;
+    private error?;
+    messages: UiMessage[];
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    private unsubscribe?;
+    private closeFeedbackIfOpen;
+    private handleApproveToolCall;
+    private handleDeclineToolCall;
+    private handleNewConversation;
+    private handleProvideSupportFeedback;
+    /**
+     * Callbacks passed to message renderers
+     */
+    private get messageCallbacks();
+    protected updated(changedProperties: PropertyValues): Promise<void>;
+    render(): import('lit-html').TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'gaia-conversation': GaiaConversation;
+    }
+}

package/dist/components/conversation/conversation.styles.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import('lit').CSSResult;
+export default _default;

package/dist/components/conversation/message-renderers.d.ts

@@ -0,0 +1,39 @@
+import { DirectiveResult } from 'lit/directive.js';
+import { RefDirective } from 'lit/directives/ref.js';
+import { nothing, TemplateResult } from 'lit';
+import { AssistantMessage, OperatorMessage, SystemMessage, UiMessage, UserMessage } from '../../core/types';
+/**
+ * Callback types for message interactions
+ */
+export type ToolCallHandler = (turnId: string, messageId: string) => void;
+export interface MessageRendererCallbacks {
+    onApproveToolCall: ToolCallHandler;
+    onDeclineToolCall: ToolCallHandler;
+    onNewConversation: () => void;
+    onProvideFeedback: () => void;
+}
+/**
+ * Renders an assistant message with citations and tool call approval UI
+ */
+export declare function renderAssistantMessage(message: AssistantMessage, ref: DirectiveResult<typeof RefDirective>, callbacks: MessageRendererCallbacks): TemplateResult;
+/**
+ * Renders an operator message with typing indicator support
+ */
+export declare function renderOperatorMessage(message: OperatorMessage, ref: DirectiveResult<typeof RefDirective>): TemplateResult;
+/**
+ * Renders a system message
+ */
+export declare function renderSystemMessage(message: SystemMessage, ref: DirectiveResult<typeof RefDirective>, callbacks: MessageRendererCallbacks): TemplateResult;
+/**
+ * Renders a user message
+ */
+export declare function renderUserMessage(message: UserMessage, ref: DirectiveResult<typeof RefDirective>): TemplateResult;
+/**
+ * Message renderer factory that dispatches to the appropriate renderer based on message role.
+ * Note: Tool messages should be filtered out before calling this function as they have no content.
+ */
+export declare function renderMessage(message: UiMessage, ref: DirectiveResult<typeof RefDirective>, callbacks: MessageRendererCallbacks): TemplateResult | typeof nothing;
+/**
+ * Filter messages to only those with content
+ */
+export declare function filterMessagesWithContent(messages: UiMessage[]): UiMessage[];

package/dist/components/conversation/scroll-controller.d.ts

@@ -0,0 +1,47 @@
+import { ReactiveController, ReactiveControllerHost } from 'lit';
+import { Ref } from 'lit/directives/ref.js';
+import { default as GaiaMessage } from '../message/message';
+/**
+ * Scroll behavior types
+ */
+type ScrollBehavior = 'instant' | 'smooth';
+/**
+ * Controller for managing scroll behavior in the conversation view.
+ * Handles automatic scrolling, user message anchoring, and scroll container height management.
+ */
+export declare class ScrollController implements ReactiveController {
+    private host;
+    private container;
+    private scrollView;
+    private lastMessageElement;
+    constructor(host: ReactiveControllerHost, container: Ref<HTMLDivElement>, scrollView: Ref<HTMLDivElement>, lastMessageElement: Ref<GaiaMessage>);
+    hostConnected(): void;
+    hostDisconnected(): void;
+    /**
+     * Get the role of the last message
+     */
+    private get lastMessageRole();
+    /**
+     * Reset scroll container height to auto
+     */
+    resetScroll(): Promise<void>;
+    /**
+     * Scroll to the bottom of the conversation
+     */
+    scrollToBottom(behavior?: ScrollBehavior): Promise<void>;
+    /**
+     * Anchor the last user message to the top of the viewport.
+     * This creates a smooth transition when waiting for assistant response.
+     */
+    anchorUserMessage(behavior?: ScrollBehavior): Promise<void>;
+    /**
+     * Handle scroll updates based on conversation state changes
+     */
+    handleScrollUpdate(params: {
+        messageCount: number;
+        previousMessageCount: number;
+        channel: string;
+        isFeedbackOpen: boolean;
+    }): Promise<void>;
+}
+export {};

package/dist/components/disclaimer/disclaimer.d.ts

@@ -0,0 +1,10 @@
+import { BaseElement } from '../shared/base-element';
+export default class GaiaDisclaimer extends BaseElement {
+    static styles: import('lit').CSSResult[];
+    render(): import('lit-html').TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'gaia-disclaimer': GaiaDisclaimer;
+    }
+}

package/dist/components/disclaimer/disclaimer.styles.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import('lit').CSSResult;
+export default _default;

package/dist/components/error-notification/error-notification.d.ts

@@ -0,0 +1,16 @@
+import { nothing } from 'lit';
+import { AppError } from '../../core/errors/app-error';
+import { BaseElement } from '../shared/base-element';
+export default class GaiaErrorNotification extends BaseElement {
+    static styles: import('lit').CSSResult[];
+    private store;
+    absolute: boolean;
+    error?: AppError;
+    private handleClearError;
+    render(): import('lit-html').TemplateResult<1> | typeof nothing;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'gaia-error-notification': GaiaErrorNotification;
+    }
+}

package/dist/components/error-notification/error-notification.styles.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import('lit').CSSResult;
+export default _default;

package/dist/components/feedback/feedback.d.ts

@@ -0,0 +1,26 @@
+import { BaseElement } from '../shared/base-element';
+export default class GaiaFeedback extends BaseElement {
+    static styles: import('lit').CSSResult[];
+    private store?;
+    private feedbackEffect;
+    private ratingInput;
+    private commentInput;
+    private selectedRating;
+    private comment;
+    private target;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    private unsubscribe?;
+    private canSubmit;
+    private handleRatingChange;
+    private handleCommentChange;
+    private handleSubmit;
+    private handleReset;
+    private handleClose;
+    render(): import('lit-html').TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'gaia-feedback': GaiaFeedback;
+    }
+}

package/dist/components/feedback/feedback.styles.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import('lit').CSSResult;
+export default _default;