@gengage/assistant-fe 0.1.0

package/dist/common/customization-factories.d.ts

@@ -0,0 +1,63 @@
+import { ChatWidgetConfig } from '../chat/types.js';
+import { QNAWidgetConfig } from '../qna/types.js';
+import { SimRelWidgetConfig } from '../simrel/types.js';
+import { AnalyticsClientConfig } from './analytics.js';
+import { WidgetTheme } from './types.js';
+export declare const DEFAULT_CUSTOMIZATION_LOCALE = "tr";
+export interface AccountIdentityConfig {
+    accountId: string;
+    middlewareUrl: string;
+    locale?: string;
+}
+export interface AccountIdentity {
+    ACCOUNT_ID: string;
+    MIDDLEWARE_URL: string;
+    LOCALE: string;
+}
+interface BaseAccountWidgetConfigInput {
+    accountId: string;
+    middlewareUrl: string;
+    sessionId: string;
+    theme?: WidgetTheme;
+}
+export interface FloatingChatConfigInput extends BaseAccountWidgetConfigInput {
+    locale?: string;
+}
+export interface PdpQnaConfigInput extends BaseAccountWidgetConfigInput {
+    sku: string;
+    mountTarget: QNAWidgetConfig['mountTarget'];
+}
+export interface PdpSimRelConfigInput extends BaseAccountWidgetConfigInput {
+    sku: string;
+    mountTarget: SimRelWidgetConfig['mountTarget'];
+}
+type FloatingChatConfigOverrides = Omit<Partial<ChatWidgetConfig>, 'accountId' | 'middlewareUrl' | 'session' | 'variant' | 'theme' | 'locale'>;
+type PdpQnaConfigOverrides = Omit<Partial<QNAWidgetConfig>, 'accountId' | 'middlewareUrl' | 'session' | 'pageContext' | 'mountTarget' | 'theme'>;
+type SimRelAccountConfig = Omit<SimRelWidgetConfig, 'onAddToCart' | 'onProductNavigate'>;
+type PdpSimRelConfigOverrides = Omit<Partial<SimRelAccountConfig>, 'accountId' | 'middlewareUrl' | 'session' | 'sku' | 'mountTarget' | 'theme'>;
+type DefaultAnalyticsConfigOverrides = Omit<AnalyticsClientConfig, 'middlewareUrl'>;
+/**
+ * Shared account identity factory used by all customization folders.
+ * Keeps middleware URL + locale defaults centralized in the SDK layer.
+ */
+export declare function createAccountIdentity(config: AccountIdentityConfig): AccountIdentity;
+/**
+ * Shared floating-chat baseline used by account customizations.
+ * Account files only pass differences via `overrides`.
+ */
+export declare function createFloatingChatConfig(input: FloatingChatConfigInput, overrides?: FloatingChatConfigOverrides): ChatWidgetConfig;
+/**
+ * Shared PDP QNA baseline used by account customizations.
+ */
+export declare function createPdpQnaConfig(input: PdpQnaConfigInput, overrides?: PdpQnaConfigOverrides): QNAWidgetConfig;
+/**
+ * Shared PDP SimRel baseline used by account customizations.
+ * Host-level commerce callbacks stay in account init wrappers.
+ */
+export declare function createPdpSimRelConfig(input: PdpSimRelConfigInput, overrides?: PdpSimRelConfigOverrides): SimRelAccountConfig;
+/**
+ * Shared analytics defaults for account customization wrappers.
+ */
+export declare function createDefaultAnalyticsConfig(middlewareUrl: string, overrides?: DefaultAnalyticsConfigOverrides): AnalyticsClientConfig;
+export {};
+//# sourceMappingURL=customization-factories.d.ts.map

package/dist/common/customization-factories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"customization-factories.d.ts","sourceRoot":"","sources":["../../src/common/customization-factories.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,eAAO,MAAM,4BAA4B,OAAO,CAAC;AAEjD,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,4BAA4B;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,WAAW,CAAC;CACrB;AAED,MAAM,WAAW,uBAAwB,SAAQ,4BAA4B;IAC3E,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iBAAkB,SAAQ,4BAA4B;IACrE,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,eAAe,CAAC,aAAa,CAAC,CAAC;CAC7C;AAED,MAAM,WAAW,oBAAqB,SAAQ,4BAA4B;IACxE,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,kBAAkB,CAAC,aAAa,CAAC,CAAC;CAChD;AAED,KAAK,2BAA2B,GAAG,IAAI,CACrC,OAAO,CAAC,gBAAgB,CAAC,EACzB,WAAW,GAAG,eAAe,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,CAC3E,CAAC;AACF,KAAK,qBAAqB,GAAG,IAAI,CAC/B,OAAO,CAAC,eAAe,CAAC,EACxB,WAAW,GAAG,eAAe,GAAG,SAAS,GAAG,aAAa,GAAG,aAAa,GAAG,OAAO,CACpF,CAAC;AACF,KAAK,mBAAmB,GAAG,IAAI,CAAC,kBAAkB,EAAE,aAAa,GAAG,mBAAmB,CAAC,CAAC;AACzF,KAAK,wBAAwB,GAAG,IAAI,CAClC,OAAO,CAAC,mBAAmB,CAAC,EAC5B,WAAW,GAAG,eAAe,GAAG,SAAS,GAAG,KAAK,GAAG,aAAa,GAAG,OAAO,CAC5E,CAAC;AACF,KAAK,+BAA+B,GAAG,IAAI,CAAC,qBAAqB,EAAE,eAAe,CAAC,CAAC;AAEpF;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,qBAAqB,GAAG,eAAe,CAMpF;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,uBAAuB,EAC9B,SAAS,GAAE,2BAAgC,GAC1C,gBAAgB,CAalB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,iBAAiB,EAAE,SAAS,GAAE,qBAA0B,GAAG,eAAe,CAanH;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,oBAAoB,EAC3B,SAAS,GAAE,wBAA6B,GACvC,mBAAmB,CAarB;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAC1C,aAAa,EAAE,MAAM,EACrB,SAAS,GAAE,+BAAoC,GAC9C,qBAAqB,CASvB"}

package/dist/common/events.d.ts

@@ -0,0 +1,47 @@
+import { GengageEventDetailMap, GengageEventName } from './types.js';
+/**
+ * Dispatch a typed Gengage event on window.
+ *
+ * @example
+ * dispatch('gengage:qna:action', { title: 'About shipping', type: 'query', payload: 'shipping' });
+ */
+export declare function dispatch<K extends GengageEventName>(name: K, detail: GengageEventDetailMap[K]): void;
+/**
+ * Listen for a typed Gengage event on window.
+ * Returns an unsubscribe function.
+ *
+ * @example
+ * const off = listen('gengage:qna:action', (detail) => {
+ *   window.gengage?.chat?.openWithAction(detail);
+ * });
+ * // Later:
+ * off();
+ */
+export declare function listen<K extends GengageEventName>(name: K, handler: (detail: GengageEventDetailMap[K]) => void): () => void;
+export interface WireQNAToChatOptions {
+    onChatUnavailable?: () => void;
+}
+/**
+ * Convenience: wire QNA → Chat automatically.
+ * Call this once after both widgets are initialised.
+ *
+ * Listens for 'gengage:qna:action' and forwards to window.gengage.chat.openWithAction().
+ * Listens for 'gengage:qna:open-chat' and forwards to window.gengage.chat.open().
+ *
+ * If chat is not available at dispatch time, emits a one-time console.warn and
+ * calls options.onChatUnavailable (every time) if provided.
+ *
+ * @returns unsubscribe function that removes both listeners.
+ */
+export declare function wireQNAToChat(options?: WireQNAToChatOptions): () => void;
+/**
+ * Convenience: wire Similar Products → Chat for cross-page session continuity.
+ * Call this once after both widgets are initialised.
+ *
+ * When the user navigates to a product page, the chat widget can restore
+ * the conversation where it left off using saveSession().
+ *
+ * @returns unsubscribe function.
+ */
+export declare function wireSimilarToChat(): () => void;
+//# sourceMappingURL=events.d.ts.map

package/dist/common/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/common/events.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE1E;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,gBAAgB,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,qBAAqB,CAAC,CAAC,CAAC,GAAG,IAAI,CAEpG;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,MAAM,CAAC,CAAC,SAAS,gBAAgB,EAC/C,IAAI,EAAE,CAAC,EACP,OAAO,EAAE,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC,CAAC,KAAK,IAAI,GAClD,MAAM,IAAI,CAMZ;AAED,MAAM,WAAW,oBAAoB;IACnC,iBAAiB,CAAC,EAAE,MAAM,IAAI,CAAC;CAChC;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,OAAO,CAAC,EAAE,oBAAoB,GAAG,MAAM,IAAI,CAgCxE;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,IAAI,CAO9C"}

package/dist/common/global-error-toast.d.ts

@@ -0,0 +1,6 @@
+import { GengageEventDetailMap } from './types.js';
+export declare function getGlobalErrorMessage(locale?: string): string;
+export declare function registerGlobalErrorToastListener(): void;
+export declare function showGlobalErrorToast(detail: GengageEventDetailMap['gengage:global:error']): void;
+export declare function dismissGlobalErrorToast(): void;
+//# sourceMappingURL=global-error-toast.d.ts.map

package/dist/common/global-error-toast.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"global-error-toast.d.ts","sourceRoot":"","sources":["../../src/common/global-error-toast.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAaxD,wBAAgB,qBAAqB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAK7D;AAED,wBAAgB,gCAAgC,IAAI,IAAI,CASvD;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,qBAAqB,CAAC,sBAAsB,CAAC,GAAG,IAAI,CAmChG;AAED,wBAAgB,uBAAuB,IAAI,IAAI,CAY9C"}

package/dist/common/index.d.ts

@@ -0,0 +1,36 @@
+export type { PageContext, SessionContext, BaseWidgetConfig, WidgetTheme, GengageWidget, StreamEvent, StreamEventMetadata, StreamEventTextChunk, StreamEventUISpec, StreamEventAction, StreamEventError, StreamEventDone, UISpec, UIElement, ActionPayload, GengageEventName, GengageEventDetailMap, } from './types.js';
+export { BaseWidget } from './widget-base.js';
+export type { ChatPublicAPI } from './widget-base.js';
+export { consumeStream, streamPost } from './streaming.js';
+export type { StreamOptions, StreamEventHandler } from './streaming.js';
+export { dispatch, listen, wireQNAToChat, wireSimilarToChat } from './events.js';
+export type { WireQNAToChatOptions } from './events.js';
+export { bootstrapSession, getWindowPageContext, updatePageContext, resolveSession } from './context.js';
+export { initOverlayWidgets, getOverlayWidgets, destroyOverlayWidgets, buildOverlayIdempotencyKey } from './overlay.js';
+export type { OverlayWidgetsController, OverlayWidgetsOptions, OverlayChatOptions, OverlayQNAOptions, OverlaySimRelOptions, } from './overlay.js';
+export { buildChatEndpointUrl, normalizeMiddlewareUrl } from './api-paths.js';
+export type { ChatTransportConfig, ChatEndpointName } from './api-paths.js';
+export { AccountRuntimeConfigSchema, AnalyticsAuthModeSchema, UnknownActionPolicySchema, parseAccountRuntimeConfig, safeParseAccountRuntimeConfig, createDefaultAccountRuntimeConfig, } from './config-schema.js';
+export type { AccountRuntimeConfig, AnalyticsAuthMode, UnknownActionPolicy } from './config-schema.js';
+export { routeStreamAction } from './action-router.js';
+export type { HostActionHandlers, ActionRouterOptions } from './action-router.js';
+export { AnalyticsClient, createAnalyticsClient } from './analytics.js';
+export type { AnalyticsEnvelope, AnalyticsInput, AnalyticsAuthConfig, AnalyticsClientConfig } from './analytics.js';
+export { streamStartEvent, streamChunkEvent, streamUiSpecEvent, streamDoneEvent, streamErrorEvent, llmUsageEvent, meteringIncrementEvent, meteringSummaryEvent, chatHistorySnapshotEvent, widgetHistorySnapshotEvent, basketAddEvent, checkoutStartEvent, checkoutCompleteEvent, } from './analytics-events.js';
+export type { AnalyticsContext } from './analytics-events.js';
+export { sanitizeHtml } from './safe-html.js';
+export { renderUISpecWithRegistry, defaultUnknownUISpecRenderer } from './renderer/index.js';
+export { mergeUISpecRegistry } from './renderer/index.js';
+export type { UISpecRenderHelpers, UISpecRendererOverrides, UISpecDomComponentRenderParams, UISpecDomComponentRenderer, UISpecDomRegistry, UISpecDomUnknownRendererParams, UISpecDomUnknownRenderer, RenderUISpecWithRegistryOptions, } from './renderer/index.js';
+export { BASE_WIDGET_THEME, withBaseTheme } from './theme-utils.js';
+export { DEFAULT_WIDGET_THEME_TOKENS, withDefaultWidgetTheme } from './ui-theme.js';
+export { registerGlobalErrorToastListener, showGlobalErrorToast, dismissGlobalErrorToast, getGlobalErrorMessage, } from './global-error-toast.js';
+export { DEFAULT_CUSTOMIZATION_LOCALE, createAccountIdentity, createFloatingChatConfig, createPdpQnaConfig, createPdpSimRelConfig, createDefaultAnalyticsConfig, } from './customization-factories.js';
+export type { AccountIdentityConfig, AccountIdentity } from './customization-factories.js';
+export { initGengageClient } from './client.js';
+export type { GengageClientOptions, HostActions } from './client.js';
+export { preflightDiagnostics } from './preflight.js';
+export type { PreflightResult, PreflightWarning } from './preflight.js';
+export { adaptV1Event, productToNormalized, normalizeSimilarProductsResponse, normalizeProductGroupingsResponse, } from './v1-protocol-adapter.js';
+export type { V1Product, NormalizedProduct, SimilarProductsJsonResponse, ProductGroupingsJsonResponse, } from './v1-protocol-adapter.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/common/index.d.ts.map

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

package/dist/common/indexed-db.d.ts

@@ -0,0 +1,74 @@
+import { SerializableChatMessage } from '../chat/types.js';
+import { UISpec } from './types.js';
+export interface SessionData {
+    userId: string;
+    appId: string;
+    sessionId: string;
+    messages: SerializableChatMessage[];
+    currentThreadId: string | null;
+    lastThreadId: string | null;
+    createdAt: string;
+    /** Thread IDs that produced panel content, in creation order. */
+    panelThreads?: string[] | undefined;
+    /** Product thumbnails for ThumbnailsColumn. */
+    thumbnailEntries?: Array<{
+        sku: string;
+        imageUrl: string;
+        threadId: string;
+    }> | undefined;
+    /** Serialized panel HTML keyed by bot message ID (for panel snapshot restore). */
+    panelSnapshotHtml?: Record<string, string> | undefined;
+}
+export interface ContextData {
+    sessionId: string;
+    threadId: string;
+    context: Record<string, unknown>;
+}
+export interface PayloadData {
+    threadId: string;
+    messageId: string;
+    uiSpec: UISpec;
+}
+export interface FavoriteData {
+    userId: string;
+    appId: string;
+    sku: string;
+    name?: string | undefined;
+    imageUrl?: string | undefined;
+    price?: string | undefined;
+    savedAt: string;
+}
+export declare class GengageIndexedDB {
+    private _db;
+    private _dbName;
+    private _version;
+    constructor(dbName?: string, version?: number);
+    open(): Promise<IDBDatabase>;
+    close(): void;
+    saveSession(data: SessionData): Promise<void>;
+    loadSession(userId: string, appId: string, sessionId: string): Promise<SessionData | null>;
+    saveContext(data: ContextData): Promise<void>;
+    loadContext(sessionId: string, threadId: string): Promise<ContextData | null>;
+    /**
+     * Delete all context entries for a session whose threadId is lexicographically
+     * greater than the given threadId. Used during rollback to prune future branches.
+     *
+     * Thread IDs are UUIDv7 (lexicographically sortable by time), so string
+     * comparison is sufficient.
+     */
+    deleteContextsAfterThread(sessionId: string, threadId: string): Promise<void>;
+    /**
+     * Load the most recent context for a session (latest threadId).
+     * Uses lexicographic ordering of UUIDv7 threadIds for chronological sort.
+     */
+    loadLatestContext(sessionId: string): Promise<ContextData | null>;
+    savePayload(data: PayloadData): Promise<void>;
+    loadPayload(threadId: string, messageId: string): Promise<PayloadData | null>;
+    loadPayloadsByThread(threadId: string): Promise<PayloadData[]>;
+    saveFavorite(data: FavoriteData): Promise<void>;
+    removeFavorite(userId: string, appId: string, sku: string): Promise<void>;
+    loadFavorites(userId: string, appId: string): Promise<FavoriteData[]>;
+    isFavorite(userId: string, appId: string, sku: string): Promise<boolean>;
+    private _requireDb;
+}
+//# sourceMappingURL=indexed-db.d.ts.map

package/dist/common/indexed-db.d.ts.map

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

package/dist/common/overlay.d.ts

@@ -0,0 +1,64 @@
+import { GengageChat } from '../chat/index.js';
+import { ChatI18n, ChatWidgetConfig } from '../chat/types.js';
+import { GengageQNA } from '../qna/index.js';
+import { QNAWidgetConfig } from '../qna/types.js';
+import { GengageSimRel } from '../simrel/index.js';
+import { SimRelWidgetConfig } from '../simrel/types.js';
+import { PageContext, SessionContext, WidgetTheme } from './types.js';
+export interface OverlayChatOptions {
+    enabled?: boolean;
+    variant?: ChatWidgetConfig['variant'];
+    mountTarget?: HTMLElement | string;
+    launcherSvg?: string;
+    hideMobileLauncher?: boolean;
+    mobileBreakpoint?: number;
+    mobileInitialState?: 'half' | 'full';
+    i18n?: Partial<ChatI18n>;
+    actionHandling?: ChatWidgetConfig['actionHandling'];
+}
+export interface OverlayQNAOptions {
+    enabled?: boolean;
+    mountTarget?: HTMLElement | string;
+    ctaText?: string;
+    inputPlaceholder?: QNAWidgetConfig['inputPlaceholder'];
+}
+export interface OverlaySimRelOptions {
+    enabled?: boolean;
+    mountTarget?: HTMLElement | string;
+    discountType?: SimRelWidgetConfig['discountType'];
+}
+export interface OverlayWidgetsOptions {
+    accountId: string;
+    middlewareUrl: string;
+    locale?: string;
+    session?: Partial<SessionContext>;
+    pageContext?: Partial<PageContext>;
+    sku?: string;
+    theme?: WidgetTheme;
+    idempotencyKey?: string;
+    wireQnaToChat?: boolean;
+    chat?: OverlayChatOptions;
+    qna?: OverlayQNAOptions;
+    simrel?: OverlaySimRelOptions;
+    onAddToCart?: SimRelWidgetConfig['onAddToCart'];
+    onProductNavigate?: SimRelWidgetConfig['onProductNavigate'];
+}
+export interface OverlayWidgetsController {
+    readonly idempotencyKey: string;
+    readonly session: SessionContext;
+    readonly chat: GengageChat | null;
+    readonly qna: GengageQNA | null;
+    readonly simrel: GengageSimRel | null;
+    openChat(options?: {
+        state?: 'half' | 'full';
+    }): void;
+    closeChat(): void;
+    updateContext(patch: Partial<PageContext>): Promise<void>;
+    updateSku(sku: string, pageType?: PageContext['pageType']): Promise<void>;
+    destroy(): void;
+}
+export declare function initOverlayWidgets(options: OverlayWidgetsOptions): Promise<OverlayWidgetsController>;
+export declare function getOverlayWidgets(idempotencyKey: string): OverlayWidgetsController | null;
+export declare function destroyOverlayWidgets(idempotencyKey: string): void;
+export declare function buildOverlayIdempotencyKey(accountId: string): string;
+//# sourceMappingURL=overlay.d.ts.map

package/dist/common/overlay.d.ts.map

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

package/dist/common/preflight.d.ts

@@ -0,0 +1,12 @@
+import { AccountRuntimeConfig } from './config-schema.js';
+export interface PreflightWarning {
+    code: string;
+    message: string;
+    severity: 'warn' | 'error';
+}
+export interface PreflightResult {
+    ok: boolean;
+    warnings: PreflightWarning[];
+}
+export declare function preflightDiagnostics(config: AccountRuntimeConfig): PreflightResult;
+//# sourceMappingURL=preflight.d.ts.map

package/dist/common/preflight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preflight.d.ts","sourceRoot":"","sources":["../../src/common/preflight.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE/D,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,OAAO,CAAC;IACZ,QAAQ,EAAE,gBAAgB,EAAE,CAAC;CAC9B;AAWD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,oBAAoB,GAAG,eAAe,CAoDlF"}

package/dist/common/renderer/dom.d.ts

@@ -0,0 +1,4 @@
+import { UISpecDomUnknownRenderer, RenderUISpecWithRegistryOptions } from './types.js';
+export declare const defaultUnknownUISpecRenderer: UISpecDomUnknownRenderer<unknown>;
+export declare function renderUISpecWithRegistry<TContext>(options: RenderUISpecWithRegistryOptions<TContext>): HTMLElement;
+//# sourceMappingURL=dom.d.ts.map

package/dist/common/renderer/dom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dom.d.ts","sourceRoot":"","sources":["../../../src/common/renderer/dom.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,+BAA+B,EAAE,MAAM,YAAY,CAAC;AAE5F,eAAO,MAAM,4BAA4B,EAAE,wBAAwB,CAAC,OAAO,CAW1E,CAAC;AAEF,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,OAAO,EAAE,+BAA+B,CAAC,QAAQ,CAAC,GAAG,WAAW,CAqClH"}

package/dist/common/renderer/index.d.ts

@@ -0,0 +1,5 @@
+export { renderUISpecWithRegistry, defaultUnknownUISpecRenderer } from './dom.js';
+export { mergeUISpecRegistry } from './registry.js';
+export type { UISpecRenderHelpers, UISpecRendererOverrides } from './overrides.js';
+export type { UISpecDomComponentRenderParams, UISpecDomComponentRenderer, UISpecDomRegistry, UISpecDomUnknownRendererParams, UISpecDomUnknownRenderer, RenderUISpecWithRegistryOptions, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/common/renderer/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/common/renderer/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,4BAA4B,EAAE,MAAM,UAAU,CAAC;AAClF,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,YAAY,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AACnF,YAAY,EACV,8BAA8B,EAC9B,0BAA0B,EAC1B,iBAAiB,EACjB,8BAA8B,EAC9B,wBAAwB,EACxB,+BAA+B,GAChC,MAAM,YAAY,CAAC"}

package/dist/common/renderer/overrides.d.ts

@@ -0,0 +1,24 @@
+import { UISpec } from '../types.js';
+import { UISpecDomRegistry, UISpecDomUnknownRenderer } from './types.js';
+export interface UISpecRenderHelpers<TContext> {
+    registry: UISpecDomRegistry<TContext>;
+    unknownRenderer?: UISpecDomUnknownRenderer<TContext>;
+    defaultRender: (spec: UISpec, context: TContext) => HTMLElement;
+}
+export interface UISpecRendererOverrides<TContext> {
+    /**
+     * Component-level overrides. Merged on top of the widget's default registry.
+     */
+    registry?: Partial<UISpecDomRegistry<TContext>>;
+    /**
+     * Optional fallback for unknown component types.
+     * Defaults to the widget's built-in unknown renderer.
+     */
+    unknownRenderer?: UISpecDomUnknownRenderer<TContext>;
+    /**
+     * Full UISpec rendering override.
+     * Use this to replace the default rendering methodology entirely.
+     */
+    renderUISpec?: (spec: UISpec, context: TContext, helpers: UISpecRenderHelpers<TContext>) => HTMLElement;
+}
+//# sourceMappingURL=overrides.d.ts.map

package/dist/common/renderer/overrides.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overrides.d.ts","sourceRoot":"","sources":["../../../src/common/renderer/overrides.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAE9E,MAAM,WAAW,mBAAmB,CAAC,QAAQ;IAC3C,QAAQ,EAAE,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IACtC,eAAe,CAAC,EAAE,wBAAwB,CAAC,QAAQ,CAAC,CAAC;IACrD,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,KAAK,WAAW,CAAC;CACjE;AAED,MAAM,WAAW,uBAAuB,CAAC,QAAQ;IAC/C;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC,CAAC;IAEhD;;;OAGG;IACH,eAAe,CAAC,EAAE,wBAAwB,CAAC,QAAQ,CAAC,CAAC;IAErD;;;OAGG;IACH,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,mBAAmB,CAAC,QAAQ,CAAC,KAAK,WAAW,CAAC;CACzG"}

package/dist/common/renderer/registry.d.ts

@@ -0,0 +1,3 @@
+import { UISpecDomRegistry } from './types.js';
+export declare function mergeUISpecRegistry<TContext>(base: UISpecDomRegistry<TContext>, overrides?: Partial<UISpecDomRegistry<TContext>>): UISpecDomRegistry<TContext>;
+//# sourceMappingURL=registry.d.ts.map

package/dist/common/renderer/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/common/renderer/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD,wBAAgB,mBAAmB,CAAC,QAAQ,EAC1C,IAAI,EAAE,iBAAiB,CAAC,QAAQ,CAAC,EACjC,SAAS,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC,GAC/C,iBAAiB,CAAC,QAAQ,CAAC,CAS7B"}

package/dist/common/renderer/types.d.ts

@@ -0,0 +1,20 @@
+import { UISpec, UIElement } from '../types.js';
+export interface UISpecDomComponentRenderParams<TContext> {
+    elementId: string;
+    element: UIElement;
+    spec: UISpec;
+    context: TContext;
+    renderElement: (elementId: string) => HTMLElement | null;
+}
+export type UISpecDomComponentRenderer<TContext> = (params: UISpecDomComponentRenderParams<TContext>) => HTMLElement | null;
+export type UISpecDomRegistry<TContext> = Record<string, UISpecDomComponentRenderer<TContext>>;
+export type UISpecDomUnknownRendererParams<TContext> = UISpecDomComponentRenderParams<TContext>;
+export type UISpecDomUnknownRenderer<TContext> = (params: UISpecDomUnknownRendererParams<TContext>) => HTMLElement | null;
+export interface RenderUISpecWithRegistryOptions<TContext> {
+    spec: UISpec;
+    context: TContext;
+    registry: UISpecDomRegistry<TContext>;
+    containerClassName: string;
+    unknownRenderer?: UISpecDomUnknownRenderer<TContext>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/common/renderer/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/common/renderer/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAErD,MAAM,WAAW,8BAA8B,CAAC,QAAQ;IACtD,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,SAAS,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,QAAQ,CAAC;IAClB,aAAa,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,WAAW,GAAG,IAAI,CAAC;CAC1D;AAED,MAAM,MAAM,0BAA0B,CAAC,QAAQ,IAAI,CACjD,MAAM,EAAE,8BAA8B,CAAC,QAAQ,CAAC,KAC7C,WAAW,GAAG,IAAI,CAAC;AAExB,MAAM,MAAM,iBAAiB,CAAC,QAAQ,IAAI,MAAM,CAAC,MAAM,EAAE,0BAA0B,CAAC,QAAQ,CAAC,CAAC,CAAC;AAE/F,MAAM,MAAM,8BAA8B,CAAC,QAAQ,IAAI,8BAA8B,CAAC,QAAQ,CAAC,CAAC;AAEhG,MAAM,MAAM,wBAAwB,CAAC,QAAQ,IAAI,CAC/C,MAAM,EAAE,8BAA8B,CAAC,QAAQ,CAAC,KAC7C,WAAW,GAAG,IAAI,CAAC;AAExB,MAAM,WAAW,+BAA+B,CAAC,QAAQ;IACvD,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,QAAQ,CAAC;IAClB,QAAQ,EAAE,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IACtC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,eAAe,CAAC,EAAE,wBAAwB,CAAC,QAAQ,CAAC,CAAC;CACtD"}

package/dist/common/safe-html.d.ts

@@ -0,0 +1,19 @@
+/**
+ * DOMParser-based HTML sanitizer.
+ *
+ * Backend sends HTML in assistant messages (e.g. KVKK notice).
+ * This module strips dangerous elements/attributes while preserving
+ * safe formatting tags.
+ *
+ * WARNING: Any new injection point that uses innerHTML must call this function first.
+ */
+/**
+ * Sanitize an HTML string for safe insertion via innerHTML.
+ *
+ * - Allowed tags are preserved; disallowed tags are removed entirely.
+ * - Unknown tags are unwrapped (children promoted).
+ * - `<a>` tags are forced to `target="_blank" rel="noopener noreferrer"`.
+ * - Only `https://` is allowed for `<img src>`.
+ */
+export declare function sanitizeHtml(raw: string): string;
+//# sourceMappingURL=safe-html.d.ts.map

package/dist/common/safe-html.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe-html.d.ts","sourceRoot":"","sources":["../../src/common/safe-html.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAsJH;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAYhD"}

package/dist/common/streaming.d.ts

@@ -0,0 +1,32 @@
+import { StreamEvent } from './types.js';
+export type StreamEventHandler = (event: StreamEvent) => void;
+export interface StreamOptions {
+    /** Called for each parsed StreamEvent. */
+    onEvent: StreamEventHandler;
+    /** Called once when the stream closes normally. */
+    onDone?: () => void;
+    /** Called if the stream errors or the response is non-2xx. */
+    onError?: (err: Error) => void;
+    /** AbortController signal to cancel mid-stream. */
+    signal?: AbortSignal;
+}
+/**
+ * Consume an NDJSON streaming response and call onEvent for each line.
+ *
+ * Usage:
+ *   const controller = new AbortController();
+ *   await consumeStream(response, {
+ *     onEvent: (event) => { ... },
+ *     signal: controller.signal,
+ *   });
+ */
+export declare function consumeStream(response: Response, options: StreamOptions): Promise<void>;
+/**
+ * Convenience: POST to a streaming endpoint and consume the response.
+ *
+ * @returns an AbortController that cancels the stream when aborted.
+ */
+export declare function streamPost(url: string, body: unknown, options: StreamOptions & {
+    headers?: Record<string, string>;
+}): AbortController;
+//# sourceMappingURL=streaming.d.ts.map

package/dist/common/streaming.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaming.d.ts","sourceRoot":"","sources":["../../src/common/streaming.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,MAAM,MAAM,kBAAkB,GAAG,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;AA0C9D,MAAM,WAAW,aAAa;IAC5B,0CAA0C;IAC1C,OAAO,EAAE,kBAAkB,CAAC;IAC5B,mDAAmD;IACnD,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,8DAA8D;IAC9D,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,CAAC;IAC/B,mDAAmD;IACnD,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAmDD;;;;;;;;;GASG;AACH,wBAAsB,aAAa,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CA4C7F;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CACxB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,OAAO,EACb,OAAO,EAAE,aAAa,GAAG;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GAC5D,eAAe,CAoBjB"}

package/dist/common/theme-utils.d.ts

@@ -0,0 +1,16 @@
+import { WidgetTheme } from './types.js';
+/**
+ * Shared baseline tokens used by account customizations.
+ *
+ * These values come from historical Gengage host defaults and are
+ * intentionally conservative so account themes can override only what differs.
+ */
+export declare const BASE_WIDGET_THEME: WidgetTheme;
+/**
+ * Merge account overrides on top of the shared base theme.
+ *
+ * Account customization files should call this helper so shared defaults stay
+ * centralized under src/common.
+ */
+export declare function withBaseTheme(overrides: WidgetTheme): WidgetTheme;
+//# sourceMappingURL=theme-utils.d.ts.map

package/dist/common/theme-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-utils.d.ts","sourceRoot":"","sources":["../../src/common/theme-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,EAAE,WA0B/B,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,WAAW,GAAG,WAAW,CAEjE"}