@salesforce/agentforce-conversation-client 11.67.0 → 11.68.0

package/dist/index.d.ts

@@ -3,87 +3,8 @@
  * All rights reserved.
  * For full license text, see the LICENSE.txt file
  */
-import { LightningOutApplication } from "@salesforce/lightning-out";
-export declare const AGENTFORCE_CLIENT_ELEMENT_TAG = "runtime_copilot-acc-sdk-wrapper";
-export declare const AGENTFORCE_CLIENT_NAMESPACE = "runtime_copilot";
-export declare const AGENTFORCE_CLIENT_COMPONENT_NAME = "accSdkWrapper";
-export declare const AGENTFORCE_LO_APP_DATA_ATTR = "data-lo";
-export declare const AGENTFORCE_CLIENT_COMPONENT_NAME_ALIAS = "runtime_copilot/accSdkWrapper as runtime_copilot-acc-sdk-wrapper";
-export declare const RenderingMode: Readonly<{
-    readonly INLINE: "inline";
-    readonly FLOATING: "floating";
-}>;
-export type RenderingModeValue = (typeof RenderingMode)[keyof typeof RenderingMode];
-export type StyleTokens = Record<string, string>;
-export interface TypewriterConfig {
-    charsPerFrame?: number;
-    charsPerFrameMarkdown?: number;
-    queueThresholdMedium?: number;
-    queueThresholdHigh?: number;
-    queueThresholdCritical?: number;
-    frameDelayMs?: number;
-    idleCursorTimeoutMs?: number;
-    rushToEndMs?: number;
-}
-export interface AgentforceClientConfig {
-    styleTokens?: StyleTokens;
-    agentId?: string;
-    agentLabel?: string;
-    renderingConfig?: {
-        mode?: RenderingModeValue;
-        width?: string | number;
-        height?: string | number;
-        headerEnabled?: boolean;
-        showHeaderIcon?: boolean;
-        showAvatar?: boolean;
-        agentAvatarUrl?: string;
-        agentAvatarAltText?: string;
-        headerIconName?: string;
-        headerIconSize?: string;
-        headerImageUrl?: string;
-        headerImageAlt?: string;
-    };
-    channel?: string;
-    messageInputPlaceholderText?: string;
-    isHistoryIntroNeeded?: boolean;
-    isFileBased?: boolean;
-    typewriterConfig?: TypewriterConfig;
-    floatingButtonLabel?: string;
-    floatingButtonIcon?: string;
-    floatingButtonImage?: string;
-    floatingButtonImageAlt?: string;
-    iconPosition?: "left" | "right";
-}
-export interface AgentforceLoErrorEvent {
-    type: "lo.application.error" | "lo.iframe.error";
-    detail: unknown;
-}
-export type AgentforceErrorHandler = (error: AgentforceLoErrorEvent) => void;
-export type AgentforceReadyHandler = (detail: unknown) => void;
-export interface EmbedAgentforceClientOptions {
-    container: string | HTMLElement;
-    salesforceOrigin?: string;
-    appId?: string;
-    frontdoorUrl?: string;
-    sitePrefix?: string;
-    agentforceClientConfig?: AgentforceClientConfig;
-    onError?: AgentforceErrorHandler;
-    onReady?: AgentforceReadyHandler;
-}
-export interface EmbedAgentforceClientResult {
-    loApp: LightningOutApplication;
-    chatClientComponent: HTMLElement;
-}
-/**
- * Embeds the Agentforce Conversation Client into a DOM container.
- * Embed is hidden (opacity 0) until the frame receives the "accready" event.
- *
- * @example
- * const { loApp, chatClientComponent } = embedAgentforceClient({
- *   container: '#agentforce-container',
- *   salesforceOrigin: 'https://myorg.my.salesforce.com',
- *   agentforceClientConfig: { renderingConfig: { mode: 'floating' } }
- * });
- */
-export declare function embedAgentforceClient(options?: EmbedAgentforceClientOptions | null): EmbedAgentforceClientResult;
+export { AGENTFORCE_CLIENT_ELEMENT_TAG, AGENTFORCE_CLIENT_NAMESPACE, AGENTFORCE_CLIENT_COMPONENT_NAME, AGENTFORCE_LO_APP_DATA_ATTR, AGENTFORCE_CLIENT_COMPONENT_NAME_ALIAS, AGENTFORCE_FRONTDOOR_URL_REQUIRED_EVENT, RenderingMode, } from "./constants.js";
+export type { RenderingModeValue } from "./constants.js";
+export type { StyleTokens, TypewriterConfig, AgentforceClientConfig, AgentforceLoErrorEvent, AgentforceErrorHandler, AgentforceReadyHandler, AgentforceSessionRecoveryRequest, AgentforceSessionManagementConfig, EmbedAgentforceClientOptions, AgentforceLightningOutApplication, EmbedAgentforceClientResult, } from "./types.js";
+export { embedAgentforceClient } from "./embed.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACN,6BAA6B,EAC7B,2BAA2B,EAC3B,gCAAgC,EAChC,2BAA2B,EAC3B,sCAAsC,EACtC,uCAAuC,EACvC,aAAa,GACb,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEzD,YAAY,EACX,WAAW,EACX,gBAAgB,EAChB,sBAAsB,EACtB,sBAAsB,EACtB,sBAAsB,EACtB,sBAAsB,EACtB,gCAAgC,EAChC,iCAAiC,EACjC,4BAA4B,EAC5B,iCAAiC,EACjC,2BAA2B,GAC3B,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -3,299 +3,5 @@
  * All rights reserved.
  * For full license text, see the LICENSE.txt file
  */
-import { LightningOutApplication } from "@salesforce/lightning-out";
-// ═══════════════════════════════════════════════════════════════════════════════
-// PUBLIC CONSTANTS (API surface)
-// ═══════════════════════════════════════════════════════════════════════════════
-export const AGENTFORCE_CLIENT_ELEMENT_TAG = "runtime_copilot-acc-sdk-wrapper";
-export const AGENTFORCE_CLIENT_NAMESPACE = "runtime_copilot";
-export const AGENTFORCE_CLIENT_COMPONENT_NAME = "accSdkWrapper";
-export const AGENTFORCE_LO_APP_DATA_ATTR = "data-lo";
-export const AGENTFORCE_CLIENT_COMPONENT_NAME_ALIAS = `${AGENTFORCE_CLIENT_NAMESPACE}/${AGENTFORCE_CLIENT_COMPONENT_NAME} as ${AGENTFORCE_CLIENT_ELEMENT_TAG}`;
-export const RenderingMode = Object.freeze({
-    INLINE: "inline",
-    FLOATING: "floating",
-});
-// ═══════════════════════════════════════════════════════════════════════════════
-// INTERNAL CONSTANTS
-// ═══════════════════════════════════════════════════════════════════════════════
-const EVENTS = Object.freeze({
-    ACC_MAXIMIZE: "accmaximize",
-    ACC_MINIMIZE: "accminimize",
-    ACC_READY: "accready",
-});
-const STYLE_ID = "agentforce-client-injected-styles";
-const FLOATING_DIMENSIONS = Object.freeze({
-    MINIMIZED_HEIGHT: "56px",
-    MAXIMIZED_HEIGHT: "742px",
-});
-// ═══════════════════════════════════════════════════════════════════════════════
-// STYLES – Injected CSS (overrides acc-sdk-wrapper inline width/height via !important)
-// ═══════════════════════════════════════════════════════════════════════════════
-const AGENTFORCE_CLIENT_CSS = `
-:root {
-    --minimized-iframe-width: 180px !important;
-    --minimized-iframe-height: 70px !important;
-}
-
-.acc-container:has(> .acc-frame.inline) {
-    height: 100%;
-    width: 100%;
-}
-
-.sds-overrides {
-  width: auto;
-}
-
-.acc-container > .acc-frame {
-    display: block;
-    position: fixed;
-    background: transparent;
-    border: none;
-    outline: none;
-    border-radius: 20px;
-    bottom: 24px;
-    right: 24px;
-    height: 0 !important;
-    width: 0 !important;
-    max-width: calc(100vw - 4rem);
-    max-height: calc(100dvh - 4rem);
-    z-index: 999;
-}
-
-.acc-container > .acc-frame.inline,
-.acc-container > .acc-frame.inline.maximize {
-    height: 100% !important;
-    width: 100% !important;
-    position: static;
-    bottom: 0;
-    right: 0;
-    max-height: 100%;
-    max-width: 100%;
-    box-shadow: none;
-    border-radius: 0;
-}
-
-.acc-container > .acc-frame.inline:not(.maximize) {
-    width: var(--acc-width, auto) !important;
-    height: var(--acc-height, auto) !important;
-}
-
-.acc-container > .acc-frame.initial {
-    height: var(--minimized-iframe-height, 56px) !important;
-    width: var(--minimized-iframe-width, 145px) !important;
-    transition: all 0s ease;
-}
-
-.acc-container > .acc-frame.minimize {
-    height: var(--minimized-iframe-height, 56px) !important;
-    width: var(--minimized-iframe-width, 145px) !important;
-    transition: width 0.25s ease-in-out, height 0.25s ease-in-out;
-}
-
-.acc-container > .acc-frame.maximize {
-    width: 450px !important;
-    height: 700px !important;
-    background: #ffffff;
-    box-shadow: 0 10px 25px -3px rgba(0, 0, 0, 0.1), 0 4px 12px -2px rgba(0, 0, 0, 0.05),
-        0 0 2px 0 rgba(0, 0, 0, 0.05), 0 20px 45px -5px rgba(0, 0, 0, 0.08);
-    transition: all 0.3s ease;
-}
-
-.acc-container > lightning-out-application {
-    background: transparent;
-}
-
-@media (max-width: 639px) {
-    .acc-container > .acc-frame.maximize {
-        bottom: 0;
-        right: 0;
-        width: 100% !important;
-        height: 100vh !important;
-        height: 100dvh !important;
-        border-radius: 0;
-        max-width: 100%;
-        max-height: 100vh;
-        overflow-y: auto;
-        overflow-x: hidden;
-        -webkit-overflow-scrolling: touch;
-        transition: height 0.2s ease-in-out;
-    }
-}
-`;
-function injectStyles(additionalCss = "") {
-    if (document.getElementById(STYLE_ID))
-        return;
-    const style = document.createElement("style");
-    style.id = STYLE_ID;
-    style.textContent = AGENTFORCE_CLIENT_CSS + (additionalCss ? "\n" + additionalCss : "");
-    document.head.appendChild(style);
-}
-function toCssLength(value) {
-    return typeof value === "number" ? `${value}px` : value;
-}
-function normalizeRenderingMode(value) {
-    if (value === RenderingMode.INLINE || value === RenderingMode.FLOATING)
-        return value;
-    return undefined;
-}
-function getRenderingContext(clientConfig) {
-    const renderingConfig = clientConfig?.renderingConfig ?? {};
-    const mode = normalizeRenderingMode(renderingConfig.mode) ?? RenderingMode.FLOATING;
-    const isFloating = mode !== RenderingMode.INLINE;
-    return { mode, isFloating, renderingConfig };
-}
-function applyInlineSizing(container, { width, height }) {
-    if (width != null)
-        container.style.setProperty("--acc-width", toCssLength(width));
-    if (height != null) {
-        const h = toCssLength(height);
-        container.style.setProperty("--acc-height", h);
-        container.style.setProperty("--agentic-chat-container-height", h);
-    }
-}
-function createFrameElement() {
-    const el = document.createElement(AGENTFORCE_CLIENT_ELEMENT_TAG);
-    el.classList.add("acc-frame");
-    return el;
-}
-function applyFrameInitialState(el, context, container) {
-    el.style.opacity = "0";
-    el.style.pointerEvents = "none";
-    el.style.setProperty("--agentic-chat-container-height", "100vh");
-    if (context.isFloating) {
-        el.classList.add("floating");
-        el.classList.remove("maximize", "minimize");
-        el.classList.add("initial");
-    }
-    else {
-        el.classList.add("inline");
-        applyInlineSizing(container, context.renderingConfig);
-    }
-}
-function attachFrameResizeHandlers(el, container, isFloating, loApp) {
-    const onAccReady = () => {
-        el.style.opacity = "";
-        el.style.pointerEvents = "";
-        if (loApp) {
-            loApp.style.opacity = "";
-            loApp.style.pointerEvents = "";
-        }
-    };
-    el.addEventListener(EVENTS.ACC_READY, onAccReady);
-    if (!isFloating)
-        return;
-    const onMaximize = () => {
-        el.classList.remove("initial", "minimize");
-        el.classList.add("maximize");
-    };
-    const onMinimize = () => {
-        el.classList.remove("maximize");
-        el.classList.add("minimize");
-        container.style.setProperty("--agentic-chat-container-height", FLOATING_DIMENSIONS.MINIMIZED_HEIGHT);
-    };
-    el.addEventListener(EVENTS.ACC_MAXIMIZE, onMaximize);
-    el.addEventListener(EVENTS.ACC_MINIMIZE, onMinimize);
-}
-function createAndMountFrame(container, clientConfig, loApp) {
-    injectStyles();
-    const config = { ...(clientConfig ?? {}) };
-    const context = getRenderingContext(config);
-    const el = createFrameElement();
-    el.configuration = config;
-    applyFrameInitialState(el, context, container);
-    attachFrameResizeHandlers(el, container, context.isFloating, loApp);
-    container.appendChild(el);
-    return el;
-}
-// ═══════════════════════════════════════════════════════════════════════════════
-// LIGHTNING OUT – LO app creation and error handling
-// ═══════════════════════════════════════════════════════════════════════════════
-function createAndMountLoApp(container, salesforceOrigin, appId, frontdoorUrl, sitePrefix, onError, onReady) {
-    const loApp = new LightningOutApplication();
-    if (salesforceOrigin)
-        loApp.setAttribute("org-url", salesforceOrigin);
-    loApp.setAttribute("components", AGENTFORCE_CLIENT_COMPONENT_NAME_ALIAS);
-    loApp.setAttribute(AGENTFORCE_LO_APP_DATA_ATTR, `acc`);
-    if (appId)
-        loApp.setAttribute("app-id", appId);
-    if (frontdoorUrl)
-        loApp.setAttribute("frontdoor-url", frontdoorUrl);
-    if (sitePrefix)
-        loApp.setAttribute("site-prefix", sitePrefix);
-    loApp.style.opacity = "0";
-    loApp.style.pointerEvents = "none";
-    attachLoEventHandlers(loApp, onError, onReady);
-    container.appendChild(loApp);
-    return loApp;
-}
-function attachLoEventHandlers(loApp, onError, onReady) {
-    loApp.addEventListener("lo.application.ready", (e) => {
-        const detail = e.detail;
-        console.log("Agentforce Conversation Client: Lightning Out ready", detail != null ? detail : "");
-        onReady?.(detail);
-    });
-    loApp.addEventListener("lo.application.error", (e) => {
-        const detail = e.detail;
-        console.error("Agentforce Conversation Client: Lightning Out error:", detail);
-        onError?.({ type: "lo.application.error", detail });
-    });
-    loApp.addEventListener("lo.iframe.error", (e) => {
-        const detail = e.detail;
-        console.error("Agentforce Conversation Client: Lightning Out iframe error:", detail);
-        onError?.({ type: "lo.iframe.error", detail });
-    });
-}
-// ═══════════════════════════════════════════════════════════════════════════════
-// CONTAINER & EMBED
-// ═══════════════════════════════════════════════════════════════════════════════
-function resolveContainer(container) {
-    if (container instanceof HTMLElement)
-        return container;
-    if (typeof container === "string")
-        return document.querySelector(container);
-    return null;
-}
-function embedIntoContainer(containerElement, options) {
-    const { salesforceOrigin, appId, frontdoorUrl, sitePrefix, agentforceClientConfig = {}, onError, onReady, } = options;
-    containerElement.classList.add("acc-container");
-    const loApp = createAndMountLoApp(containerElement, salesforceOrigin, appId, frontdoorUrl, sitePrefix, onError, onReady);
-    const chatClientComponent = createAndMountFrame(containerElement, agentforceClientConfig, loApp);
-    return { loApp, chatClientComponent };
-}
-// ═══════════════════════════════════════════════════════════════════════════════
-// PUBLIC API
-// ═══════════════════════════════════════════════════════════════════════════════
-/**
- * Embeds the Agentforce Conversation Client into a DOM container.
- * Embed is hidden (opacity 0) until the frame receives the "accready" event.
- *
- * @example
- * const { loApp, chatClientComponent } = embedAgentforceClient({
- *   container: '#agentforce-container',
- *   salesforceOrigin: 'https://myorg.my.salesforce.com',
- *   agentforceClientConfig: { renderingConfig: { mode: 'floating' } }
- * });
- */
-export function embedAgentforceClient(options) {
-    const { container, salesforceOrigin, appId, frontdoorUrl, sitePrefix, agentforceClientConfig = {}, onError, onReady, } = options ?? {};
-    if (!container)
-        throw new Error("Agentforce Conversation Client: container is required");
-    if (!salesforceOrigin && !frontdoorUrl) {
-        throw new Error("Agentforce Conversation Client: salesforceOrigin or frontdoorUrl is required");
-    }
-    const containerElement = resolveContainer(container);
-    if (!containerElement) {
-        throw new Error(`Agentforce Conversation Client: container not found: ${container}`);
-    }
-    return embedIntoContainer(containerElement, {
-        container,
-        salesforceOrigin,
-        appId,
-        frontdoorUrl,
-        sitePrefix,
-        agentforceClientConfig,
-        onError,
-        onReady,
-    });
-}
+export { AGENTFORCE_CLIENT_ELEMENT_TAG, AGENTFORCE_CLIENT_NAMESPACE, AGENTFORCE_CLIENT_COMPONENT_NAME, AGENTFORCE_LO_APP_DATA_ATTR, AGENTFORCE_CLIENT_COMPONENT_NAME_ALIAS, AGENTFORCE_FRONTDOOR_URL_REQUIRED_EVENT, RenderingMode, } from "./constants.js";
+export { embedAgentforceClient } from "./embed.js";