@gengage/assistant-fe 0.4.5 → 0.4.7

package/dist/chat.js

@@ -1,14 +1,15 @@
-import { c as e, f as t, i as r, l as s, m as n, n as i, o as l, p as C, r as c, s as h, t as o } from "./chat-B1lLKIxj.js";
+import { a as e, c as t, i as r, l as s, n as i, o as n, r as l, s as o, t as C, u as c } from "./runtime-DNbjpTCh.js";
+import { t as p } from "./chat-BRKK63lt.js";
 export {
   t as CHAT_SCROLL_ELEMENT_ID,
-  l as ChatPresentationState,
-  o as GengageChat,
-  r as chatCatalog,
+  r as ChatPresentationState,
+  C as GengageChat,
+  p as chatCatalog,
   i as createChatWidget,
-  h as createDefaultChatUISpecRegistry,
-  e as defaultChatUnknownUISpecRenderer,
-  C as getChatScrollElement,
-  n as invalidateChatScrollCache,
-  c as isSimilarsAppendGrid,
-  s as renderUISpec
+  e as createDefaultChatUISpecRegistry,
+  n as defaultChatUnknownUISpecRenderer,
+  s as getChatScrollElement,
+  c as invalidateChatScrollCache,
+  l as isSimilarsAppendGrid,
+  o as renderUISpec
 };

package/dist/common/config-constants.d.ts

@@ -0,0 +1 @@
+export declare const DEFAULT_IDEMPOTENCY_KEY = "__gengageWidgetsInit";

package/dist/common/config-schema.d.ts

@@ -5,7 +5,6 @@ export declare const AnalyticsAuthModeSchema: z.ZodEnum<{
     "bearer-header": "bearer-header";
     "body-api-key": "body-api-key";
 }>;
-export declare const DEFAULT_IDEMPOTENCY_KEY = "__gengageWidgetsInit";
 export declare const UnknownActionPolicySchema: z.ZodEnum<{
     "log-and-ignore": "log-and-ignore";
     throw: "throw";

package/dist/common/overlay.d.ts

@@ -1,8 +1,8 @@
-import { GengageChat } from '../chat/index.js';
+import { GengageChat } from '../chat/runtime.js';
 import { ChatI18n, ChatWidgetConfig } from '../chat/types.js';
-import { GengageQNA } from '../qna/index.js';
+import { GengageQNA } from '../qna/runtime.js';
 import { QNAWidgetConfig } from '../qna/types.js';
-import { GengageSimRel } from '../simrel/index.js';
+import { GengageSimRel } from '../simrel/runtime.js';
 import { SimRelWidgetConfig } from '../simrel/types.js';
 import { GengageSimBut } from '../simbut/index.js';
 import { SimButWidgetConfig } from '../simbut/types.js';
@@ -47,6 +47,7 @@ export interface OverlayChatOptions {
 export interface OverlayQNAOptions {
     enabled?: boolean;
     mountTarget?: HTMLElement | string;
+    chrome?: QNAWidgetConfig['chrome'];
     ctaText?: string;
     hideButtonRowCta?: boolean;
     inputPlaceholder?: QNAWidgetConfig['inputPlaceholder'];
@@ -66,6 +67,7 @@ export interface OverlaySimRelOptions {
     enabled?: boolean;
     mountTarget?: HTMLElement | string;
     discountType?: SimRelWidgetConfig['discountType'];
+    gridColumns?: SimRelWidgetConfig['gridColumns'];
     /** Custom card element renderer for the direct rendering path (GroupTabs/ProductGrid). */
     renderCardElement?: SimRelWidgetConfig['renderCardElement'];
     /** UISpec renderer overrides for simrel components. */
@@ -74,6 +76,8 @@ export interface OverlaySimRelOptions {
 export interface OverlaySimButOptions {
     enabled?: boolean;
     mountTarget?: HTMLElement | string;
+    layout?: SimButWidgetConfig['layout'];
+    inlineCard?: SimButWidgetConfig['inlineCard'];
     /** `findSimilar` yüküne eklenecek ürün görseli URL’si. */
     imageUrl?: string;
     i18n?: SimButWidgetConfig['i18n'];
@@ -138,7 +142,7 @@ export interface OverlayWidgetsController {
  *
  * @example
  * ```ts
- * import { initOverlayWidgets } from '@gengage/assistant-fe';
+ * import { initOverlayWidgets } from '@gengage/assistant-fe/overlay';
  *
  * const controller = await initOverlayWidgets({
  *   accountId: 'mystore',

package/dist/common/protocol-adapter.d.ts

@@ -26,7 +26,6 @@ export interface V1Product {
         key: string;
         value: string;
     }>;
-    facet_tags?: string[];
     short_name?: string;
     category_ids?: string[];
     category_names?: string[];
@@ -74,6 +73,7 @@ export interface NormalizedProduct {
         value: string;
     }>;
     facetHits?: Record<string, unknown>;
+    categoryNames?: string[];
     shortName?: string;
     /** Pass-through bag for backend fields not consumed by the SDK. */
     extras?: Record<string, unknown>;

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

@@ -7,7 +7,7 @@
  *
  * WARNING: Any new injection point that uses innerHTML must call this function first.
  */
-/** Check if a URL uses a safe protocol (http or https). */
+/** Check if an image URL uses a safe protocol or same-origin absolute path. */
 export declare function isSafeImageUrl(url: string): boolean;
 /**
  * Check if a URL is safe for use in href/src attributes.

package/dist/common-c-awF96O.js

@@ -0,0 +1,491 @@
+import { n as w } from "./api-paths-DR5bPNhi.js";
+import { n as f } from "./widget-base-2-B1Ch5I.js";
+import { a as h, c as s, i as b, o as d, r as u, t as p } from "./schemas-CLo8wCjs.js";
+import { a as T, i as k } from "./overlay-DJ1ZRMfI.js";
+var c = d({ enabled: u().default(!0) }), S = d({
+  chat: s().optional(),
+  qna: s().optional(),
+  simrel: s().optional(),
+  simbut: s().optional()
+}), I = d({}), U = p([
+  "none",
+  "x-api-key-header",
+  "bearer-header",
+  "body-api-key"
+]), _ = d({
+  mode: U.default("none"),
+  key: s().optional(),
+  headerName: s().optional(),
+  bodyField: s().default("api_key")
+}), A = d({
+  enabled: u().default(!0),
+  endpoint: s().default("/analytics"),
+  auth: _.default({
+    mode: "none",
+    bodyField: "api_key"
+  }),
+  fireAndForget: u().default(!0),
+  useBeacon: u().default(!0),
+  keepaliveFetch: u().default(!0),
+  timeoutMs: h().int().positive().default(4e3),
+  maxRetries: h().int().min(0).max(5).default(1)
+}), C = d({
+  idempotencyKey: s().default(T),
+  requireDomReady: u().default(!0)
+}), E = p([
+  "log-and-ignore",
+  "throw",
+  "delegate"
+]), P = d({
+  unknownActionPolicy: E.default("log-and-ignore"),
+  allowScriptCall: u().default(!1)
+}), v = d({
+  version: b("1", { error: 'version must be "1"' }),
+  accountId: s({ error: "accountId must be a non-empty string" }).min(1, { error: "accountId must be a non-empty string" }),
+  middlewareUrl: s({ error: 'middlewareUrl must be a valid URL (e.g. "https://your-backend.example.com")' }).url({ error: 'middlewareUrl must be a valid URL (e.g. "https://your-backend.example.com")' }),
+  locale: s().optional(),
+  widgets: d({
+    chat: c.default({ enabled: !0 }),
+    qna: c.default({ enabled: !0 }),
+    simrel: c.optional(),
+    simbut: c.default({ enabled: !1 })
+  }),
+  mounts: S.default({}),
+  transport: I.default({}),
+  analytics: A.default({
+    enabled: !0,
+    endpoint: "/analytics",
+    auth: {
+      mode: "none",
+      bodyField: "api_key"
+    },
+    fireAndForget: !0,
+    useBeacon: !0,
+    keepaliveFetch: !0,
+    timeoutMs: 4e3,
+    maxRetries: 1
+  }),
+  gtm: C.default({
+    idempotencyKey: "__gengageWidgetsInit",
+    requireDomReady: !0
+  }),
+  actionHandling: P.default({
+    unknownActionPolicy: "log-and-ignore",
+    allowScriptCall: !1
+  })
+});
+function R(e) {
+  f("config", "parsing account runtime config", e);
+  const t = v.parse(e);
+  return f("config", "config resolved", {
+    accountId: t.accountId,
+    middlewareUrl: t.middlewareUrl
+  }), t;
+}
+function L(e) {
+  return v.safeParse(e);
+}
+function Y(e) {
+  return R({
+    version: "1",
+    accountId: e.accountId,
+    middlewareUrl: e.middlewareUrl,
+    locale: e.locale,
+    widgets: {
+      chat: { enabled: !0 },
+      qna: { enabled: !0 },
+      simbut: { enabled: !1 }
+    }
+  });
+}
+var q = {
+  enabled: !0,
+  endpoint: "/analytics",
+  fireAndForget: !0,
+  useBeacon: !0,
+  keepaliveFetch: !0,
+  timeoutMs: 4e3,
+  maxRetries: 0,
+  batchSize: 10,
+  flushIntervalMs: 250
+}, F = {
+  mode: "none",
+  key: "",
+  headerName: "X-API-Key",
+  bodyField: "api_key"
+}, D = class {
+  constructor(e) {
+    this.queue = [], this.flushTimer = null, this.config = {
+      ...q,
+      ...e,
+      auth: {
+        ...F,
+        ...e.auth ?? {}
+      }
+    }, this.onPageHideBound = () => {
+      this.queue.length !== 0 && this.flushAllSync();
+    }, typeof window < "u" && window.addEventListener("pagehide", this.onPageHideBound);
+  }
+  track(e) {
+    if (!this.config.enabled) return;
+    const t = O(e);
+    if (this.queue.push(t), this.queue.length >= this.config.batchSize) {
+      this.scheduleImmediateFlush();
+      return;
+    }
+    this.scheduleFlush();
+  }
+  flush() {
+    if (!this.config.enabled || this.queue.length === 0) return;
+    const e = this.queue.splice(0, this.config.batchSize), t = this.buildTransportBody(e), n = g(this.config.endpoint, this.config.middlewareUrl);
+    this.send(n, t);
+  }
+  flushAll() {
+    for (; this.queue.length > 0; ) this.flush();
+  }
+  destroy() {
+    this.flushTimer && (clearTimeout(this.flushTimer), this.flushTimer = null), this.queue.length > 0 && this.flushAllSync(), typeof window < "u" && window.removeEventListener("pagehide", this.onPageHideBound);
+  }
+  scheduleFlush() {
+    this.flushTimer || (this.flushTimer = setTimeout(() => {
+      this.flushTimer = null, this.flush();
+    }, this.config.flushIntervalMs));
+  }
+  scheduleImmediateFlush() {
+    this.flushTimer && (clearTimeout(this.flushTimer), this.flushTimer = null), this.flush();
+  }
+  buildTransportBody(e) {
+    const t = { events: e };
+    return this.config.auth.mode === "body-api-key" && this.config.auth.key && (t[this.config.auth.bodyField] = this.config.auth.key), t;
+  }
+  send(e, t) {
+    try {
+      const n = JSON.stringify(t);
+      if (this.config.useBeacon && this.config.auth.mode !== "x-api-key-header" && this.config.auth.mode !== "bearer-header" && y()) {
+        const o = new Blob([n], { type: "application/json" });
+        navigator.sendBeacon(e, o);
+        return;
+      }
+      if (typeof fetch > "u") return;
+      const i = { "Content-Type": "application/json" };
+      this.config.auth.mode === "x-api-key-header" && this.config.auth.key && (i[this.config.auth.headerName] = this.config.auth.key), this.config.auth.mode === "bearer-header" && this.config.auth.key && (i.Authorization = `Bearer ${this.config.auth.key}`), fetch(e, {
+        method: "POST",
+        headers: i,
+        body: n,
+        keepalive: !0
+      }).catch(() => {
+      });
+    } catch {
+    }
+  }
+  flushAllSync() {
+    if (!this.config.enabled) return;
+    const e = g(this.config.endpoint, this.config.middlewareUrl);
+    for (; this.queue.length > 0; ) {
+      const t = this.queue.splice(0, this.config.batchSize), n = this.buildTransportBody(t);
+      try {
+        const i = JSON.stringify(n);
+        if (y()) {
+          const o = new Blob([i], { type: "application/json" });
+          navigator.sendBeacon(e, o);
+        }
+      } catch {
+      }
+    }
+  }
+};
+function J(e) {
+  return new D(e);
+}
+function O(e) {
+  const t = {
+    event_name: e.event_name,
+    event_version: e.event_version ?? "1",
+    timestamp_ms: e.timestamp_ms ?? Date.now(),
+    account_id: e.account_id,
+    session_id: e.session_id,
+    correlation_id: e.correlation_id,
+    payload: e.payload
+  };
+  return e.view_id !== void 0 && (t.view_id = e.view_id), e.user_id !== void 0 && (t.user_id = e.user_id), e.widget !== void 0 && (t.widget = e.widget), e.page_type !== void 0 && (t.page_type = e.page_type), e.sku !== void 0 && (t.sku = e.sku), t;
+}
+function g(e, t) {
+  return /^https?:\/\//i.test(e) ? e : `${w(t)}${e.startsWith("/") ? e : `/${e}`}`;
+}
+function y() {
+  return typeof navigator < "u" && typeof navigator.sendBeacon == "function";
+}
+var Q = "tr";
+function V(e) {
+  return {
+    ACCOUNT_ID: e.accountId,
+    MIDDLEWARE_URL: e.middlewareUrl,
+    LOCALE: e.locale ?? "tr"
+  };
+}
+function X(e, t = {}) {
+  const n = {
+    accountId: e.accountId,
+    middlewareUrl: e.middlewareUrl,
+    session: { sessionId: e.sessionId },
+    variant: "floating",
+    locale: e.locale ?? "tr",
+    ...t
+  };
+  return e.theme !== void 0 && (n.theme = e.theme), n;
+}
+function Z(e, t = {}) {
+  const n = {
+    accountId: e.accountId,
+    middlewareUrl: e.middlewareUrl,
+    session: { sessionId: e.sessionId },
+    pageContext: {
+      pageType: "pdp",
+      sku: e.sku
+    },
+    mountTarget: e.mountTarget,
+    ...t
+  };
+  return e.theme !== void 0 && (n.theme = e.theme), n;
+}
+function ee(e, t = {}) {
+  const n = {
+    accountId: e.accountId,
+    middlewareUrl: e.middlewareUrl,
+    session: { sessionId: e.sessionId },
+    sku: e.sku,
+    mountTarget: e.mountTarget,
+    ...t
+  };
+  return e.theme !== void 0 && (n.theme = e.theme), n;
+}
+function te(e, t = {}) {
+  return {
+    enabled: !0,
+    middlewareUrl: e,
+    endpoint: "/analytics",
+    fireAndForget: !0,
+    useBeacon: !0,
+    ...t
+  };
+}
+function x(e) {
+  try {
+    return document.querySelector(e), !0;
+  } catch {
+    return !1;
+  }
+}
+function B(e, t) {
+  const n = [], i = e.mounts, o = [
+    ["qna", i.qna],
+    ["simrel", i.simrel],
+    ["simbut", i.simbut],
+    ["chat", i.chat]
+  ];
+  for (const [a, l] of o)
+    if (l !== void 0) {
+      if (a === "simrel" && e.widgets.simrel === void 0) {
+        n.push({
+          code: "SIMREL_MOUNT_IGNORED",
+          message: "[gengage preflight] mounts.simrel is set but widgets.simrel is not declared — SimRel will not initialize. Add widgets.simrel: { enabled: true } to enable it.",
+          severity: "warn"
+        });
+        continue;
+      }
+      if (!x(l)) {
+        n.push({
+          code: "INVALID_SELECTOR",
+          message: `[gengage preflight] ${a} mount selector is invalid CSS: "${l}"`,
+          severity: "error"
+        });
+        continue;
+      }
+      document.querySelector(l) || n.push({
+        code: "MOUNT_NOT_FOUND",
+        message: `[gengage preflight] ${a} mount target not found: "${l}" — widget will skip or wait for DOM`,
+        severity: "warn"
+      });
+    }
+  if (e.widgets.simbut.enabled && i.simbut === void 0) {
+    const a = "#gengage-simbut";
+    document.querySelector(a) || n.push({
+      code: "SIMBUT_MOUNT_REQUIRED",
+      message: `[gengage preflight] SimBut is enabled but no mount target is configured. Set mounts.simbut to your product image wrapper selector (e.g. "#product-gallery"). The default "${a}" was not found in the DOM.`,
+      severity: "error"
+    });
+  }
+  const r = e.gtm.idempotencyKey;
+  if (window[r] !== void 0 && n.push({
+    code: "DUPLICATE_IDEMPOTENCY",
+    message: `[gengage preflight] window["${r}"] already exists — widgets may have already initialized`,
+    severity: "warn"
+  }), !t?.skipCspCheck) {
+    let a = !1;
+    const l = (m) => {
+      m.blockedURI && e.middlewareUrl.startsWith(m.blockedURI) && (a = !0);
+    };
+    document.addEventListener("securitypolicyviolation", l);
+    try {
+      fetch(e.middlewareUrl, {
+        method: "HEAD",
+        mode: "no-cors"
+      }).catch(() => {
+      });
+    } catch {
+      a = !0;
+    }
+    document.removeEventListener("securitypolicyviolation", l), a && n.push({
+      code: "CSP_BLOCKED",
+      message: `[gengage preflight] middleware URL may be blocked by Content-Security-Policy: "${e.middlewareUrl}". Add it to connect-src.`,
+      severity: "warn"
+    });
+  }
+  for (const a of n) a.severity === "error" ? console.error(a.message) : console.warn(a.message);
+  return {
+    ok: n.every((a) => a.severity !== "error"),
+    warnings: n
+  };
+}
+function M(e) {
+  const t = L(e);
+  if (!t.success) {
+    const n = t.error.issues.map((i) => `${i.path.join(".")}: ${i.message}`).join("; ");
+    throw new Error(`[gengage] Invalid runtime config: ${n}`);
+  }
+  return t.data;
+}
+function N(e, t, n) {
+  const i = {
+    accountId: e.accountId,
+    middlewareUrl: e.middlewareUrl,
+    idempotencyKey: e.gtm.idempotencyKey
+  };
+  return e.locale !== void 0 && (i.locale = e.locale), n !== void 0 && (i.pageContext = n, n.sku !== void 0 && (i.sku = n.sku)), i.chat = { enabled: e.widgets.chat.enabled }, e.mounts.chat !== void 0 && (i.chat.mountTarget = e.mounts.chat), i.qna = { enabled: e.widgets.qna.enabled }, e.mounts.qna !== void 0 && (i.qna.mountTarget = e.mounts.qna), e.widgets.simrel !== void 0 && (i.simrel = {
+    enabled: e.widgets.simrel.enabled,
+    ...e.mounts.simrel !== void 0 ? { mountTarget: e.mounts.simrel } : {}
+  }), i.simbut = { enabled: e.widgets.simbut.enabled }, e.mounts.simbut !== void 0 && (i.simbut.mountTarget = e.mounts.simbut), t?.onAddToCart !== void 0 && (i.onAddToCart = t.onAddToCart), t?.onProductNavigate !== void 0 && (i.onProductNavigate = t.onProductNavigate), t?.onFindSimilar !== void 0 && (i.simbut.onFindSimilar = t.onFindSimilar), t?.onScriptCall !== void 0 && (i.onScriptCall = t.onScriptCall), i;
+}
+async function ne(e) {
+  const t = M(e.runtimeConfig);
+  if (e.preflight !== !1) {
+    const o = B(t);
+    if (!o.ok) {
+      const r = o.warnings.filter((a) => a.severity === "error");
+      throw new Error(`[gengage] Preflight failed: ${r.map((a) => a.message).join("; ")}`);
+    }
+  }
+  const n = e.contextResolver?.(), i = await k(N(t, e.hostActions, n));
+  if (e.contextResolver !== void 0) {
+    const o = e.contextResolver, r = () => {
+      const l = o();
+      i.updateContext(l);
+    };
+    window.addEventListener("gengage:context:update", r);
+    const a = i.destroy.bind(i);
+    i.destroy = () => {
+      window.removeEventListener("gengage:context:update", r), a();
+    };
+  }
+  return i;
+}
+var $ = [
+  {
+    pageType: "home",
+    urlPatterns: [
+      "^/$",
+      "^/index\\.html?$",
+      "^/anasayfa$"
+    ]
+  },
+  {
+    pageType: "search",
+    urlPatterns: [
+      "/arama",
+      "/search",
+      "/ara\\?"
+    ],
+    queryParam: "q"
+  },
+  {
+    pageType: "cart",
+    urlPatterns: [
+      "/sepet",
+      "/cart",
+      "/basket",
+      "/sepetim"
+    ]
+  },
+  {
+    pageType: "plp",
+    urlPatterns: [
+      "/kategori/",
+      "/category/",
+      "/c/",
+      "/koleksiyon/",
+      "/collection/"
+    ]
+  },
+  {
+    pageType: "pdp",
+    urlPatterns: [
+      "/urun/",
+      "/product/",
+      "/p/",
+      "/-p-",
+      "/-pm-"
+    ]
+  }
+];
+function z(e, t) {
+  const n = t ?? (typeof window < "u" ? new URL(window.location.href) : null);
+  if (!n) return "other";
+  const i = e ?? $, o = n.pathname;
+  for (const r of i)
+    if (!(r.urlPatterns && !r.urlPatterns.some((a) => {
+      try {
+        return new RegExp(a, "i").test(o);
+      } catch {
+        return !1;
+      }
+    })) && !(r.queryParam && !n.searchParams.has(r.queryParam)) && !(r.selector && typeof document < "u" && !document.querySelector(r.selector)))
+      return r.pageType;
+  return "other";
+}
+function K(e) {
+  const t = e ?? (typeof window < "u" ? new URL(window.location.href) : null);
+  if (!t) return;
+  const n = t.pathname, i = n.match(/\/(?:p|urun|product)\/([^/?#]+)/i);
+  if (i?.[1]) return i[1];
+  const o = n.match(/-p-(\d+)/i);
+  if (o?.[1]) return o[1];
+}
+function ie(e) {
+  const t = z(e), n = { pageType: t };
+  if (t === "pdp") {
+    const i = K();
+    i && (n.sku = i);
+  }
+  return typeof window < "u" && (n.url = window.location.href), n;
+}
+export {
+  Y as _,
+  B as a,
+  te as c,
+  ee as d,
+  D as f,
+  E as g,
+  U as h,
+  ne as i,
+  X as l,
+  v as m,
+  z as n,
+  Q as o,
+  J as p,
+  K as r,
+  V as s,
+  ie as t,
+  Z as u,
+  R as v,
+  L as y
+};