@wix/web5-core 1.56.1 → 1.57.1

package/dist/cjs/entity/fetchEntityListData.js

@@ -3,10 +3,11 @@
 exports.__esModule = true;
 exports.__resetEntityListDataCache = __resetEntityListDataCache;
 exports.fetchEntityListData = fetchEntityListData;
+var _listEntityItems = require("./listEntityItems");
 /**
- * GET `/wix-assistant-web5/v1/items?id=<id>&id=<id>…` and return a Map keyed
- * by id. Pure async helper — no React, no host environment. Shared between
- * the main app's `useEntityListData` hook (web50-server-ui) and the
+ * Resolves entities via the `list-items` RPC (POST `{ ids }`) and returns a
+ * Map keyed by id. Pure async helper — no React, no host environment. Shared
+ * between the main app's `useEntityListData` hook (web50-server-ui) and the
  * placement bundle's `useResolveGenericEntityData` impl (DL #099). Both
  * pass an injected `fetchImpl` so the call rides on whichever auth
  * strategy the surface uses (`@wix/sdk` Wix-auth in the placement,
@@ -17,13 +18,6 @@ exports.fetchEntityListData = fetchEntityListData;
  * again inside a placement (or vice-versa) reuses the same lookup.
  */
 const entityCache = new Map();
-const DEFAULT_ENDPOINT = 'https://www.wixapis.com/wix-assistant-web5/v1/items';
-function buildUrl(endpoint, ids) {
-  const url = new URL(endpoint);
-  ids.forEach(id => url.searchParams.append('id', id));
-  return url;
-}
-
 /**
  * Returns a Map of `id → ApiPayloadItem`. Hits the cache first; only
  * uncached ids ride the network. The Map includes both cached and freshly
@@ -47,26 +41,19 @@ async function fetchEntityListData(ids, opts = {}) {
   }
   if (uncachedIds.length === 0) return result;
   const fetchImpl = opts.fetchImpl ?? (typeof window !== 'undefined' ? fetch.bind(window) : fetch);
-  const endpoint = opts.endpoint ?? DEFAULT_ENDPOINT;
-  const url = buildUrl(endpoint, uncachedIds);
+
+  // Entities resolve via the new-RAG `list-items` RPC (POST `{ ids }`).
+  // See listEntityItems.ts.
   try {
-    const res = await fetchImpl(url.toString(), {
-      method: 'GET',
-      headers: {
-        'Content-Type': 'application/json'
-      }
+    const items = await (0, _listEntityItems.listEntityItems)(uncachedIds, {
+      fetchImpl
     });
-    if (!res.ok) return result;
-    const body = await res.json();
-    for (const item of body.results ?? []) {
-      const id = item.id;
-      if (id) {
-        entityCache.set(id, item);
-        result.set(id, item);
-      }
+    for (const [id, item] of items) {
+      entityCache.set(id, item);
+      result.set(id, item);
     }
   } catch {
-    // network / parse error — return whatever we have from cache
+    // network / HTTP / parse error — return whatever we have from cache
   }
   return result;
 }

package/dist/cjs/entity/fetchEntityListData.js.map

@@ -1 +1 @@
-{"version":3,"names":["entityCache","Map","DEFAULT_ENDPOINT","buildUrl","endpoint","ids","url","URL","forEach","id","searchParams","append","fetchEntityListData","opts","result","length","uncachedIds","cached","get","set","push","fetchImpl","window","fetch","bind","res","toString","method","headers","ok","body","json","item","results","__resetEntityListDataCache","clear"],"sources":["../../../src/entity/fetchEntityListData.ts"],"sourcesContent":["import type { ApiPayloadItem } from '../types/entity';\n\n/**\n * GET `/wix-assistant-web5/v1/items?id=<id>&id=<id>…` and return a Map keyed\n * by id. Pure async helper — no React, no host environment. Shared between\n * the main app's `useEntityListData` hook (web50-server-ui) and the\n * placement bundle's `useResolveGenericEntityData` impl (DL #099). Both\n * pass an injected `fetchImpl` so the call rides on whichever auth\n * strategy the surface uses (`@wix/sdk` Wix-auth in the placement,\n * the app's `client.fetchWithAuth` in the main app).\n *\n * The same singleton cache used to live inside `useEntityListData`. Hoisting\n * it here means a section that renders first in the main app and then\n * again inside a placement (or vice-versa) reuses the same lookup.\n */\nconst entityCache = new Map<string, ApiPayloadItem>();\n\nexport interface FetchEntityListDataOptions {\n  /** Wix-API base + path. Default: the prod items endpoint. */\n  endpoint?: string;\n  /** Auth-aware fetch. Required when the host needs Wix OAuth (any cross-origin call). */\n  fetchImpl?: typeof fetch;\n}\n\nconst DEFAULT_ENDPOINT =\n  'https://www.wixapis.com/wix-assistant-web5/v1/items';\n\nfunction buildUrl(endpoint: string, ids: string[]): URL {\n  const url = new URL(endpoint);\n  ids.forEach((id) => url.searchParams.append('id', id));\n  return url;\n}\n\n/**\n * Returns a Map of `id → ApiPayloadItem`. Hits the cache first; only\n * uncached ids ride the network. The Map includes both cached and freshly\n * fetched rows.\n *\n * On HTTP error or network failure, the returned Map omits the requested\n * id; callers decide whether to fire a diagnostic. The promise resolves\n * either way — the caller's UI should keep rendering with whatever it has.\n */\nexport async function fetchEntityListData(\n  ids: string[],\n  opts: FetchEntityListDataOptions = {},\n): Promise<Map<string, ApiPayloadItem>> {\n  const result = new Map<string, ApiPayloadItem>();\n  if (!ids.length) return result;\n\n  const uncachedIds: string[] = [];\n  for (const id of ids) {\n    const cached = entityCache.get(id);\n    if (cached) {\n      result.set(id, cached);\n    } else {\n      uncachedIds.push(id);\n    }\n  }\n  if (uncachedIds.length === 0) return result;\n\n  const fetchImpl =\n    opts.fetchImpl ??\n    (typeof window !== 'undefined' ? fetch.bind(window) : fetch);\n  const endpoint = opts.endpoint ?? DEFAULT_ENDPOINT;\n  const url = buildUrl(endpoint, uncachedIds);\n\n  try {\n    const res = await fetchImpl(url.toString(), {\n      method: 'GET',\n      headers: { 'Content-Type': 'application/json' },\n    });\n    if (!res.ok) return result;\n    const body = (await res.json()) as { results?: ApiPayloadItem[] };\n    for (const item of body.results ?? []) {\n      const id = (item as unknown as { id?: string }).id;\n      if (id) {\n        entityCache.set(id, item);\n        result.set(id, item);\n      }\n    }\n  } catch {\n    // network / parse error — return whatever we have from cache\n  }\n\n  return result;\n}\n\n/** Test helper — drops the singleton cache so specs start clean. */\nexport function __resetEntityListDataCache(): void {\n  entityCache.clear();\n}\n"],"mappings":";;;;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAMA,WAAW,GAAG,IAAIC,GAAG,CAAyB,CAAC;AASrD,MAAMC,gBAAgB,GACpB,qDAAqD;AAEvD,SAASC,QAAQA,CAACC,QAAgB,EAAEC,GAAa,EAAO;EACtD,MAAMC,GAAG,GAAG,IAAIC,GAAG,CAACH,QAAQ,CAAC;EAC7BC,GAAG,CAACG,OAAO,CAAEC,EAAE,IAAKH,GAAG,CAACI,YAAY,CAACC,MAAM,CAAC,IAAI,EAAEF,EAAE,CAAC,CAAC;EACtD,OAAOH,GAAG;AACZ;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,eAAeM,mBAAmBA,CACvCP,GAAa,EACbQ,IAAgC,GAAG,CAAC,CAAC,EACC;EACtC,MAAMC,MAAM,GAAG,IAAIb,GAAG,CAAyB,CAAC;EAChD,IAAI,CAACI,GAAG,CAACU,MAAM,EAAE,OAAOD,MAAM;EAE9B,MAAME,WAAqB,GAAG,EAAE;EAChC,KAAK,MAAMP,EAAE,IAAIJ,GAAG,EAAE;IACpB,MAAMY,MAAM,GAAGjB,WAAW,CAACkB,GAAG,CAACT,EAAE,CAAC;IAClC,IAAIQ,MAAM,EAAE;MACVH,MAAM,CAACK,GAAG,CAACV,EAAE,EAAEQ,MAAM,CAAC;IACxB,CAAC,MAAM;MACLD,WAAW,CAACI,IAAI,CAACX,EAAE,CAAC;IACtB;EACF;EACA,IAAIO,WAAW,CAACD,MAAM,KAAK,CAAC,EAAE,OAAOD,MAAM;EAE3C,MAAMO,SAAS,GACbR,IAAI,CAACQ,SAAS,KACb,OAAOC,MAAM,KAAK,WAAW,GAAGC,KAAK,CAACC,IAAI,CAACF,MAAM,CAAC,GAAGC,KAAK,CAAC;EAC9D,MAAMnB,QAAQ,GAAGS,IAAI,CAACT,QAAQ,IAAIF,gBAAgB;EAClD,MAAMI,GAAG,GAAGH,QAAQ,CAACC,QAAQ,EAAEY,WAAW,CAAC;EAE3C,IAAI;IACF,MAAMS,GAAG,GAAG,MAAMJ,SAAS,CAACf,GAAG,CAACoB,QAAQ,CAAC,CAAC,EAAE;MAC1CC,MAAM,EAAE,KAAK;MACbC,OAAO,EAAE;QAAE,cAAc,EAAE;MAAmB;IAChD,CAAC,CAAC;IACF,IAAI,CAACH,GAAG,CAACI,EAAE,EAAE,OAAOf,MAAM;IAC1B,MAAMgB,IAAI,GAAI,MAAML,GAAG,CAACM,IAAI,CAAC,CAAoC;IACjE,KAAK,MAAMC,IAAI,IAAIF,IAAI,CAACG,OAAO,IAAI,EAAE,EAAE;MACrC,MAAMxB,EAAE,GAAIuB,IAAI,CAAgCvB,EAAE;MAClD,IAAIA,EAAE,EAAE;QACNT,WAAW,CAACmB,GAAG,CAACV,EAAE,EAAEuB,IAAI,CAAC;QACzBlB,MAAM,CAACK,GAAG,CAACV,EAAE,EAAEuB,IAAI,CAAC;MACtB;IACF;EACF,CAAC,CAAC,MAAM;IACN;EAAA;EAGF,OAAOlB,MAAM;AACf;;AAEA;AACO,SAASoB,0BAA0BA,CAAA,EAAS;EACjDlC,WAAW,CAACmC,KAAK,CAAC,CAAC;AACrB","ignoreList":[]}
+{"version":3,"names":["_listEntityItems","require","entityCache","Map","fetchEntityListData","ids","opts","result","length","uncachedIds","id","cached","get","set","push","fetchImpl","window","fetch","bind","items","listEntityItems","item","__resetEntityListDataCache","clear"],"sources":["../../../src/entity/fetchEntityListData.ts"],"sourcesContent":["import type { ApiPayloadItem } from '../types/entity';\nimport { listEntityItems } from './listEntityItems';\n\n/**\n * Resolves entities via the `list-items` RPC (POST `{ ids }`) and returns a\n * Map keyed by id. Pure async helper — no React, no host environment. Shared\n * between the main app's `useEntityListData` hook (web50-server-ui) and the\n * placement bundle's `useResolveGenericEntityData` impl (DL #099). Both\n * pass an injected `fetchImpl` so the call rides on whichever auth\n * strategy the surface uses (`@wix/sdk` Wix-auth in the placement,\n * the app's `client.fetchWithAuth` in the main app).\n *\n * The same singleton cache used to live inside `useEntityListData`. Hoisting\n * it here means a section that renders first in the main app and then\n * again inside a placement (or vice-versa) reuses the same lookup.\n */\nconst entityCache = new Map<string, ApiPayloadItem>();\n\nexport interface FetchEntityListDataOptions {\n  /** Auth-aware fetch. Required when the host needs Wix OAuth (any cross-origin call). */\n  fetchImpl?: typeof fetch;\n}\n\n/**\n * Returns a Map of `id → ApiPayloadItem`. Hits the cache first; only\n * uncached ids ride the network. The Map includes both cached and freshly\n * fetched rows.\n *\n * On HTTP error or network failure, the returned Map omits the requested\n * id; callers decide whether to fire a diagnostic. The promise resolves\n * either way — the caller's UI should keep rendering with whatever it has.\n */\nexport async function fetchEntityListData(\n  ids: string[],\n  opts: FetchEntityListDataOptions = {},\n): Promise<Map<string, ApiPayloadItem>> {\n  const result = new Map<string, ApiPayloadItem>();\n  if (!ids.length) return result;\n\n  const uncachedIds: string[] = [];\n  for (const id of ids) {\n    const cached = entityCache.get(id);\n    if (cached) {\n      result.set(id, cached);\n    } else {\n      uncachedIds.push(id);\n    }\n  }\n  if (uncachedIds.length === 0) return result;\n\n  const fetchImpl =\n    opts.fetchImpl ??\n    (typeof window !== 'undefined' ? fetch.bind(window) : fetch);\n\n  // Entities resolve via the new-RAG `list-items` RPC (POST `{ ids }`).\n  // See listEntityItems.ts.\n  try {\n    const items = await listEntityItems(uncachedIds, { fetchImpl });\n    for (const [id, item] of items) {\n      entityCache.set(id, item);\n      result.set(id, item);\n    }\n  } catch {\n    // network / HTTP / parse error — return whatever we have from cache\n  }\n\n  return result;\n}\n\n/** Test helper — drops the singleton cache so specs start clean. */\nexport function __resetEntityListDataCache(): void {\n  entityCache.clear();\n}\n"],"mappings":";;;;;AACA,IAAAA,gBAAA,GAAAC,OAAA;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAMC,WAAW,GAAG,IAAIC,GAAG,CAAyB,CAAC;AAOrD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,eAAeC,mBAAmBA,CACvCC,GAAa,EACbC,IAAgC,GAAG,CAAC,CAAC,EACC;EACtC,MAAMC,MAAM,GAAG,IAAIJ,GAAG,CAAyB,CAAC;EAChD,IAAI,CAACE,GAAG,CAACG,MAAM,EAAE,OAAOD,MAAM;EAE9B,MAAME,WAAqB,GAAG,EAAE;EAChC,KAAK,MAAMC,EAAE,IAAIL,GAAG,EAAE;IACpB,MAAMM,MAAM,GAAGT,WAAW,CAACU,GAAG,CAACF,EAAE,CAAC;IAClC,IAAIC,MAAM,EAAE;MACVJ,MAAM,CAACM,GAAG,CAACH,EAAE,EAAEC,MAAM,CAAC;IACxB,CAAC,MAAM;MACLF,WAAW,CAACK,IAAI,CAACJ,EAAE,CAAC;IACtB;EACF;EACA,IAAID,WAAW,CAACD,MAAM,KAAK,CAAC,EAAE,OAAOD,MAAM;EAE3C,MAAMQ,SAAS,GACbT,IAAI,CAACS,SAAS,KACb,OAAOC,MAAM,KAAK,WAAW,GAAGC,KAAK,CAACC,IAAI,CAACF,MAAM,CAAC,GAAGC,KAAK,CAAC;;EAE9D;EACA;EACA,IAAI;IACF,MAAME,KAAK,GAAG,MAAM,IAAAC,gCAAe,EAACX,WAAW,EAAE;MAAEM;IAAU,CAAC,CAAC;IAC/D,KAAK,MAAM,CAACL,EAAE,EAAEW,IAAI,CAAC,IAAIF,KAAK,EAAE;MAC9BjB,WAAW,CAACW,GAAG,CAACH,EAAE,EAAEW,IAAI,CAAC;MACzBd,MAAM,CAACM,GAAG,CAACH,EAAE,EAAEW,IAAI,CAAC;IACtB;EACF,CAAC,CAAC,MAAM;IACN;EAAA;EAGF,OAAOd,MAAM;AACf;;AAEA;AACO,SAASe,0BAA0BA,CAAA,EAAS;EACjDpB,WAAW,CAACqB,KAAK,CAAC,CAAC;AACrB","ignoreList":[]}

package/dist/cjs/entity/index.js

@@ -1,8 +1,9 @@
 "use strict";
 
 exports.__esModule = true;
-exports.fetchEntityListData = exports.enrichEntitiesFromPayload = void 0;
+exports.fetchEntityListData = exports.enrichEntitiesFromPayload = exports.LIST_ITEMS_ENDPOINT = void 0;
 exports.getEntityExtractor = getEntityExtractor;
+exports.listEntityItems = void 0;
 exports.registerEntityExtractor = registerEntityExtractor;
 exports.transformToSolutionEntityData = exports.transformToGenericEntityData = exports.transformToBlogPostEntityData = void 0;
 var _defaultExtractor = require("./defaultExtractor");
@@ -14,6 +15,9 @@ var _enrichEntitiesFromPayload = require("./enrichEntitiesFromPayload");
 exports.enrichEntitiesFromPayload = _enrichEntitiesFromPayload.enrichEntitiesFromPayload;
 var _fetchEntityListData = require("./fetchEntityListData");
 exports.fetchEntityListData = _fetchEntityListData.fetchEntityListData;
+var _listEntityItems = require("./listEntityItems");
+exports.listEntityItems = _listEntityItems.listEntityItems;
+exports.LIST_ITEMS_ENDPOINT = _listEntityItems.LIST_ITEMS_ENDPOINT;
 /**
  * Registry of client-specific entity extractors.
  * Only needed if a client requires custom extraction logic beyond the config-driven default.

package/dist/cjs/entity/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["_defaultExtractor","require","exports","defaultExtractor","transformToSolutionEntityData","transformToBlogPostEntityData","transformToGenericEntityData","_enrichEntitiesFromPayload","enrichEntitiesFromPayload","_fetchEntityListData","fetchEntityListData","extractorRegistry","getEntityExtractor","clientId","registerEntityExtractor","extractor"],"sources":["../../../src/entity/index.ts"],"sourcesContent":["import type { EntityExtractor } from './types';\nimport { defaultExtractor } from './defaultExtractor';\n\nexport {\n  defaultExtractor,\n  transformToSolutionEntityData,\n  transformToBlogPostEntityData,\n  transformToGenericEntityData,\n} from './defaultExtractor';\n\nexport { enrichEntitiesFromPayload } from './enrichEntitiesFromPayload';\nexport {\n  fetchEntityListData,\n  type FetchEntityListDataOptions,\n} from './fetchEntityListData';\n\nexport type { EntityExtractor } from './types';\n\n/**\n * Registry of client-specific entity extractors.\n * Only needed if a client requires custom extraction logic beyond the config-driven default.\n */\nconst extractorRegistry: Record<string, EntityExtractor> = {};\n\n/**\n * Get the entity extractor for a specific client.\n * The default extractor is config-driven and works for any client with entityConfig.\n */\nexport function getEntityExtractor(clientId?: string): EntityExtractor {\n  if (clientId && extractorRegistry[clientId]) {\n    return extractorRegistry[clientId];\n  }\n  return defaultExtractor;\n}\n\n/**\n * Register a custom entity extractor for a client\n * Useful for runtime registration or testing\n */\nexport function registerEntityExtractor(\n  clientId: string,\n  extractor: EntityExtractor,\n): void {\n  extractorRegistry[clientId] = extractor;\n}\n"],"mappings":";;;;;;;AACA,IAAAA,iBAAA,GAAAC,OAAA;AAAsDC,OAAA,CAAAC,gBAAA,GAAAH,iBAAA,CAAAG,gBAAA;AAAAD,OAAA,CAAAE,6BAAA,GAAAJ,iBAAA,CAAAI,6BAAA;AAAAF,OAAA,CAAAG,6BAAA,GAAAL,iBAAA,CAAAK,6BAAA;AAAAH,OAAA,CAAAI,4BAAA,GAAAN,iBAAA,CAAAM,4BAAA;AAStD,IAAAC,0BAAA,GAAAN,OAAA;AAAwEC,OAAA,CAAAM,yBAAA,GAAAD,0BAAA,CAAAC,yBAAA;AACxE,IAAAC,oBAAA,GAAAR,OAAA;AAG+BC,OAAA,CAAAQ,mBAAA,GAAAD,oBAAA,CAAAC,mBAAA;AAI/B;AACA;AACA;AACA;AACA,MAAMC,iBAAkD,GAAG,CAAC,CAAC;;AAE7D;AACA;AACA;AACA;AACO,SAASC,kBAAkBA,CAACC,QAAiB,EAAmB;EACrE,IAAIA,QAAQ,IAAIF,iBAAiB,CAACE,QAAQ,CAAC,EAAE;IAC3C,OAAOF,iBAAiB,CAACE,QAAQ,CAAC;EACpC;EACA,OAAOV,kCAAgB;AACzB;;AAEA;AACA;AACA;AACA;AACO,SAASW,uBAAuBA,CACrCD,QAAgB,EAChBE,SAA0B,EACpB;EACNJ,iBAAiB,CAACE,QAAQ,CAAC,GAAGE,SAAS;AACzC","ignoreList":[]}
+{"version":3,"names":["_defaultExtractor","require","exports","defaultExtractor","transformToSolutionEntityData","transformToBlogPostEntityData","transformToGenericEntityData","_enrichEntitiesFromPayload","enrichEntitiesFromPayload","_fetchEntityListData","fetchEntityListData","_listEntityItems","listEntityItems","LIST_ITEMS_ENDPOINT","extractorRegistry","getEntityExtractor","clientId","registerEntityExtractor","extractor"],"sources":["../../../src/entity/index.ts"],"sourcesContent":["import type { EntityExtractor } from './types';\nimport { defaultExtractor } from './defaultExtractor';\n\nexport {\n  defaultExtractor,\n  transformToSolutionEntityData,\n  transformToBlogPostEntityData,\n  transformToGenericEntityData,\n} from './defaultExtractor';\n\nexport { enrichEntitiesFromPayload } from './enrichEntitiesFromPayload';\nexport {\n  fetchEntityListData,\n  type FetchEntityListDataOptions,\n} from './fetchEntityListData';\nexport {\n  listEntityItems,\n  LIST_ITEMS_ENDPOINT,\n  type ListEntityItemsOptions,\n} from './listEntityItems';\n\nexport type { EntityExtractor } from './types';\n\n/**\n * Registry of client-specific entity extractors.\n * Only needed if a client requires custom extraction logic beyond the config-driven default.\n */\nconst extractorRegistry: Record<string, EntityExtractor> = {};\n\n/**\n * Get the entity extractor for a specific client.\n * The default extractor is config-driven and works for any client with entityConfig.\n */\nexport function getEntityExtractor(clientId?: string): EntityExtractor {\n  if (clientId && extractorRegistry[clientId]) {\n    return extractorRegistry[clientId];\n  }\n  return defaultExtractor;\n}\n\n/**\n * Register a custom entity extractor for a client\n * Useful for runtime registration or testing\n */\nexport function registerEntityExtractor(\n  clientId: string,\n  extractor: EntityExtractor,\n): void {\n  extractorRegistry[clientId] = extractor;\n}\n"],"mappings":";;;;;;;;AACA,IAAAA,iBAAA,GAAAC,OAAA;AAAsDC,OAAA,CAAAC,gBAAA,GAAAH,iBAAA,CAAAG,gBAAA;AAAAD,OAAA,CAAAE,6BAAA,GAAAJ,iBAAA,CAAAI,6BAAA;AAAAF,OAAA,CAAAG,6BAAA,GAAAL,iBAAA,CAAAK,6BAAA;AAAAH,OAAA,CAAAI,4BAAA,GAAAN,iBAAA,CAAAM,4BAAA;AAStD,IAAAC,0BAAA,GAAAN,OAAA;AAAwEC,OAAA,CAAAM,yBAAA,GAAAD,0BAAA,CAAAC,yBAAA;AACxE,IAAAC,oBAAA,GAAAR,OAAA;AAG+BC,OAAA,CAAAQ,mBAAA,GAAAD,oBAAA,CAAAC,mBAAA;AAC/B,IAAAC,gBAAA,GAAAV,OAAA;AAI2BC,OAAA,CAAAU,eAAA,GAAAD,gBAAA,CAAAC,eAAA;AAAAV,OAAA,CAAAW,mBAAA,GAAAF,gBAAA,CAAAE,mBAAA;AAI3B;AACA;AACA;AACA;AACA,MAAMC,iBAAkD,GAAG,CAAC,CAAC;;AAE7D;AACA;AACA;AACA;AACO,SAASC,kBAAkBA,CAACC,QAAiB,EAAmB;EACrE,IAAIA,QAAQ,IAAIF,iBAAiB,CAACE,QAAQ,CAAC,EAAE;IAC3C,OAAOF,iBAAiB,CAACE,QAAQ,CAAC;EACpC;EACA,OAAOb,kCAAgB;AACzB;;AAEA;AACA;AACA;AACA;AACO,SAASc,uBAAuBA,CACrCD,QAAgB,EAChBE,SAA0B,EACpB;EACNJ,iBAAiB,CAACE,QAAQ,CAAC,GAAGE,SAAS;AACzC","ignoreList":[]}

package/dist/cjs/entity/listEntityItems.js

@@ -0,0 +1,90 @@
+"use strict";
+
+exports.__esModule = true;
+exports.LIST_ITEMS_ENDPOINT = void 0;
+exports.listEntityItems = listEntityItems;
+/**
+ * Entity resolution via the `list-items` RPC on the ConversationConfiguration
+ * service.
+ *
+ * Entities are resolved through `list-items` (POST `{ ids }`). The response is
+ * `{ items: [...] }` where each row is keyed by `doc_id`. We normalize to
+ * `ApiPayloadItem` keyed by that id (and alias it onto `id`) so both callers
+ * get back the same `Map<id, ApiPayloadItem>` contract.
+ *
+ * TODO(ambassador): the `@wix/ambassador-enterprise-web-five-v1-configuration`
+ * `listItems` builder does NOT yet emit the public URL below — as of 1.0.27 it
+ * resolves to the internal `/v1/conversation-configuration/list-items` path,
+ * which 405s at the www edge (no public mapping). The gateway mapping was added
+ * out-of-band (`/web5/conversation-configuration` → service root), giving the
+ * URL below. Once an ambassador version ships with that mapping, replace the
+ * hand-built request with the builder + `client.fetchWithAuth`, mirroring
+ * `web50-server-ui/src/services/backendConfigService.ts`:
+ *   const options = listItems({ ids })({ isSSR: false, host: 'www.wixapis.com' });
+ *   const url = new URL(options.url!, 'https://www.wixapis.com');
+ */
+
+/**
+ * Public URL for the `list-items` RPC on `www.wixapis.com`. The `/web5/conversation-configuration`
+ * gateway prefix is prepended to the proto path, hence the repeated segment.
+ */
+const LIST_ITEMS_ENDPOINT = exports.LIST_ITEMS_ENDPOINT = 'https://www.wixapis.com/web5/conversation-configuration/v1/conversation-configuration/list-items';
+
+/** Minimal fetch shape accepted by both the placement `fetchImpl` and the main app's `client.fetchWithAuth`. */
+
+/**
+ * POSTs `{ ids }` to the `list-items` endpoint and returns a Map of
+ * `doc_id → ApiPayloadItem`. Throws on network/HTTP error so callers keep their
+ * own diagnostics; on success returns only the rows the BE resolved.
+ */
+async function listEntityItems(ids, opts) {
+  const result = new Map();
+  if (!ids.length) return result;
+  const res = await opts.fetchImpl(LIST_ITEMS_ENDPOINT, {
+    method: 'POST',
+    headers: {
+      'Content-Type': 'application/json'
+    },
+    body: JSON.stringify({
+      ids
+    })
+  });
+  if (!res.ok) {
+    throw new Error(`list-items ${res.status} ${res.statusText}`);
+  }
+  const body = await res.json();
+  const items = body.items ?? [];
+  for (const item of items) {
+    const rec = item;
+    const id = rec.doc_id;
+    if (!id) {
+      continue;
+    }
+    const normalized = {
+      ...rec,
+      id
+    };
+    // Product docs carry the Shopify slug in `handle`; the raw `url` is the
+    // absolute canonical storefront URL (https://www.feature.com/products/…).
+    // Rebuild a host-relative `/products/<handle>` so the link stays same-origin
+    // on whatever host serves the page. `handle` is authoritative here
+    // (no origin/`www.`/path-parsing, unlike deriving it from `url`).
+    if (rec.doc_domain === 'product' && typeof rec.handle === 'string' && rec.handle) {
+      normalized.url = `/products/${rec.handle}`;
+    }
+    // `list-items` carries the image directly (`thumbnail` / `images[]`), but
+    // the shared transform (`transformToGenericEntityData`) reads `img`. Alias
+    // the image onto `img` so images resolve from the payload itself — no
+    // dependence on the SearchSpring catalog, which may not index every product.
+    if (normalized.img == null) {
+      if (typeof rec.thumbnail === 'string' && rec.thumbnail) {
+        normalized.img = rec.thumbnail;
+      } else if (Array.isArray(rec.images) && typeof rec.images[0] === 'string' && rec.images[0]) {
+        normalized.img = rec.images[0];
+      }
+    }
+    result.set(id, normalized);
+  }
+  return result;
+}
+//# sourceMappingURL=listEntityItems.js.map

package/dist/cjs/entity/listEntityItems.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["LIST_ITEMS_ENDPOINT","exports","listEntityItems","ids","opts","result","Map","length","res","fetchImpl","method","headers","body","JSON","stringify","ok","Error","status","statusText","json","items","item","rec","id","doc_id","normalized","doc_domain","handle","url","img","thumbnail","Array","isArray","images","set"],"sources":["../../../src/entity/listEntityItems.ts"],"sourcesContent":["import type { ApiPayloadItem } from '../types/entity';\n\n/**\n * Entity resolution via the `list-items` RPC on the ConversationConfiguration\n * service.\n *\n * Entities are resolved through `list-items` (POST `{ ids }`). The response is\n * `{ items: [...] }` where each row is keyed by `doc_id`. We normalize to\n * `ApiPayloadItem` keyed by that id (and alias it onto `id`) so both callers\n * get back the same `Map<id, ApiPayloadItem>` contract.\n *\n * TODO(ambassador): the `@wix/ambassador-enterprise-web-five-v1-configuration`\n * `listItems` builder does NOT yet emit the public URL below — as of 1.0.27 it\n * resolves to the internal `/v1/conversation-configuration/list-items` path,\n * which 405s at the www edge (no public mapping). The gateway mapping was added\n * out-of-band (`/web5/conversation-configuration` → service root), giving the\n * URL below. Once an ambassador version ships with that mapping, replace the\n * hand-built request with the builder + `client.fetchWithAuth`, mirroring\n * `web50-server-ui/src/services/backendConfigService.ts`:\n *   const options = listItems({ ids })({ isSSR: false, host: 'www.wixapis.com' });\n *   const url = new URL(options.url!, 'https://www.wixapis.com');\n */\n\n/**\n * Public URL for the `list-items` RPC on `www.wixapis.com`. The `/web5/conversation-configuration`\n * gateway prefix is prepended to the proto path, hence the repeated segment.\n */\nexport const LIST_ITEMS_ENDPOINT =\n  'https://www.wixapis.com/web5/conversation-configuration/v1/conversation-configuration/list-items';\n\n/** Minimal fetch shape accepted by both the placement `fetchImpl` and the main app's `client.fetchWithAuth`. */\ntype FetchLike = (\n  input: string | URL,\n  init?: RequestInit,\n) => Promise<Response>;\n\ninterface ListItemsResponse {\n  items?: Record<string, unknown>[] | null;\n}\n\nexport interface ListEntityItemsOptions {\n  /** Auth-aware fetch (`client.fetchWithAuth` in the main app, the placement's Wix-auth fetch). */\n  fetchImpl: FetchLike;\n}\n\n/**\n * POSTs `{ ids }` to the `list-items` endpoint and returns a Map of\n * `doc_id → ApiPayloadItem`. Throws on network/HTTP error so callers keep their\n * own diagnostics; on success returns only the rows the BE resolved.\n */\nexport async function listEntityItems(\n  ids: string[],\n  opts: ListEntityItemsOptions,\n): Promise<Map<string, ApiPayloadItem>> {\n  const result = new Map<string, ApiPayloadItem>();\n  if (!ids.length) return result;\n\n  const res = await opts.fetchImpl(LIST_ITEMS_ENDPOINT, {\n    method: 'POST',\n    headers: { 'Content-Type': 'application/json' },\n    body: JSON.stringify({ ids }),\n  });\n\n  if (!res.ok) {\n    throw new Error(`list-items ${res.status} ${res.statusText}`);\n  }\n\n  const body = (await res.json()) as ListItemsResponse;\n  const items = body.items ?? [];\n  for (const item of items) {\n    const rec = item as Record<string, unknown>;\n    const id = rec.doc_id as string | undefined;\n    if (!id) {\n      continue;\n    }\n    const normalized: Record<string, unknown> = { ...rec, id };\n    // Product docs carry the Shopify slug in `handle`; the raw `url` is the\n    // absolute canonical storefront URL (https://www.feature.com/products/…).\n    // Rebuild a host-relative `/products/<handle>` so the link stays same-origin\n    // on whatever host serves the page. `handle` is authoritative here\n    // (no origin/`www.`/path-parsing, unlike deriving it from `url`).\n    if (\n      rec.doc_domain === 'product' &&\n      typeof rec.handle === 'string' &&\n      rec.handle\n    ) {\n      normalized.url = `/products/${rec.handle}`;\n    }\n    // `list-items` carries the image directly (`thumbnail` / `images[]`), but\n    // the shared transform (`transformToGenericEntityData`) reads `img`. Alias\n    // the image onto `img` so images resolve from the payload itself — no\n    // dependence on the SearchSpring catalog, which may not index every product.\n    if (normalized.img == null) {\n      if (typeof rec.thumbnail === 'string' && rec.thumbnail) {\n        normalized.img = rec.thumbnail;\n      } else if (\n        Array.isArray(rec.images) &&\n        typeof rec.images[0] === 'string' &&\n        rec.images[0]\n      ) {\n        normalized.img = rec.images[0];\n      }\n    }\n    result.set(id, normalized as unknown as ApiPayloadItem);\n  }\n  return result;\n}\n"],"mappings":";;;;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA;AACA;AACA;AACO,MAAMA,mBAAmB,GAAAC,OAAA,CAAAD,mBAAA,GAC9B,kGAAkG;;AAEpG;;AAeA;AACA;AACA;AACA;AACA;AACO,eAAeE,eAAeA,CACnCC,GAAa,EACbC,IAA4B,EACU;EACtC,MAAMC,MAAM,GAAG,IAAIC,GAAG,CAAyB,CAAC;EAChD,IAAI,CAACH,GAAG,CAACI,MAAM,EAAE,OAAOF,MAAM;EAE9B,MAAMG,GAAG,GAAG,MAAMJ,IAAI,CAACK,SAAS,CAACT,mBAAmB,EAAE;IACpDU,MAAM,EAAE,MAAM;IACdC,OAAO,EAAE;MAAE,cAAc,EAAE;IAAmB,CAAC;IAC/CC,IAAI,EAAEC,IAAI,CAACC,SAAS,CAAC;MAAEX;IAAI,CAAC;EAC9B,CAAC,CAAC;EAEF,IAAI,CAACK,GAAG,CAACO,EAAE,EAAE;IACX,MAAM,IAAIC,KAAK,CAAC,cAAcR,GAAG,CAACS,MAAM,IAAIT,GAAG,CAACU,UAAU,EAAE,CAAC;EAC/D;EAEA,MAAMN,IAAI,GAAI,MAAMJ,GAAG,CAACW,IAAI,CAAC,CAAuB;EACpD,MAAMC,KAAK,GAAGR,IAAI,CAACQ,KAAK,IAAI,EAAE;EAC9B,KAAK,MAAMC,IAAI,IAAID,KAAK,EAAE;IACxB,MAAME,GAAG,GAAGD,IAA+B;IAC3C,MAAME,EAAE,GAAGD,GAAG,CAACE,MAA4B;IAC3C,IAAI,CAACD,EAAE,EAAE;MACP;IACF;IACA,MAAME,UAAmC,GAAG;MAAE,GAAGH,GAAG;MAAEC;IAAG,CAAC;IAC1D;IACA;IACA;IACA;IACA;IACA,IACED,GAAG,CAACI,UAAU,KAAK,SAAS,IAC5B,OAAOJ,GAAG,CAACK,MAAM,KAAK,QAAQ,IAC9BL,GAAG,CAACK,MAAM,EACV;MACAF,UAAU,CAACG,GAAG,GAAG,aAAaN,GAAG,CAACK,MAAM,EAAE;IAC5C;IACA;IACA;IACA;IACA;IACA,IAAIF,UAAU,CAACI,GAAG,IAAI,IAAI,EAAE;MAC1B,IAAI,OAAOP,GAAG,CAACQ,SAAS,KAAK,QAAQ,IAAIR,GAAG,CAACQ,SAAS,EAAE;QACtDL,UAAU,CAACI,GAAG,GAAGP,GAAG,CAACQ,SAAS;MAChC,CAAC,MAAM,IACLC,KAAK,CAACC,OAAO,CAACV,GAAG,CAACW,MAAM,CAAC,IACzB,OAAOX,GAAG,CAACW,MAAM,CAAC,CAAC,CAAC,KAAK,QAAQ,IACjCX,GAAG,CAACW,MAAM,CAAC,CAAC,CAAC,EACb;QACAR,UAAU,CAACI,GAAG,GAAGP,GAAG,CAACW,MAAM,CAAC,CAAC,CAAC;MAChC;IACF;IACA5B,MAAM,CAAC6B,GAAG,CAACX,EAAE,EAAEE,UAAuC,CAAC;EACzD;EACA,OAAOpB,MAAM;AACf","ignoreList":[]}

package/dist/cjs/hostScope.js

@@ -0,0 +1,63 @@
+"use strict";
+
+exports.__esModule = true;
+exports.WEB5_SCOPES = exports.WEB5_SCOPE = exports.WEB5_ROOT_ID = exports.WEB5_ROOT_CLASS = exports.WEB5_GLOBAL_TOKENS = void 0;
+/**
+ * The mount-scope contract.
+ *
+ * Several packages have to agree on where Web5 content begins in a host
+ * document:
+ *
+ *   - **web5-core** scopes its own CSS to it (`base-utilities.css` already
+ *     targets `#root`).
+ *   - **the client build** compiles every selector against it (`scopeCss` in
+ *     `web5-core/scripts/scope-css.ts`).
+ *   - **web50-server-ui** stamps `WEB5_ROOT_CLASS` on the element it mounts
+ *     into, and renders the debug panel into `.debug-view`.
+ *   - **embed-placement** mounts the *same* client bundle into
+ *     `[data-web5-placement]` slots on host pages.
+ *
+ * One home for the list, so those cannot drift.
+ *
+ * ## Why it is a list and not just `#root`
+ *
+ * A placement renders client components **outside** `#root`, on the merchant's
+ * own PDP. A stylesheet scoped to `#root` alone leaves every placement — and the
+ * debug panel — completely unstyled. `w5-client-circana` and
+ * `w5-client-feature-com` each discovered this and each hardcoded their own
+ * list; this constant is what replaces both.
+ */
+const WEB5_ROOT_ID = exports.WEB5_ROOT_ID = 'root';
+const WEB5_ROOT_CLASS = exports.WEB5_ROOT_CLASS = 'w5-root';
+
+/**
+ * Every place Web5 content can be mounted.
+ *
+ * `#root` is the id the host runtime has always created, kept so the compiled
+ * stylesheet matches before any script runs. `.w5-root` is stamped at mount and
+ * keeps the contract working if the host ever renames the element.
+ */
+const WEB5_SCOPES = exports.WEB5_SCOPES = [`#${WEB5_ROOT_ID}`, `.${WEB5_ROOT_CLASS}`, '[data-web5-placement]', '.debug-view'];
+
+/**
+ * `:is()` takes the specificity of its most specific argument, so this is worth
+ * (1,0,0) whichever branch matches — enough to outrank the (0,1,1) descendant
+ * selectors host themes use for rich-text typography.
+ */
+const WEB5_SCOPE = exports.WEB5_SCOPE = `:is(${WEB5_SCOPES.join(',')})`;
+
+/**
+ * Custom properties the **host** sets on `:root` at runtime. Their declarations
+ * must stay global: moved into the scope they would shadow the host's value for
+ * our own subtree, which is precisely where it is needed.
+ *
+ * Kept in sync with what `web50-server-ui` and the host offset injectors write.
+ */
+const WEB5_GLOBAL_TOKENS = exports.WEB5_GLOBAL_TOKENS = [/^--web5-host-left-offset$/, /^--web5-host-right-offset$/, /^--web5-window-scroll-top-offset$/];
+
+/**
+ * Per-client overrides for the host adaptation web50-server-ui performs at
+ * mount. Shared behaviour, client values — a client package supplies this on
+ * `clientConfig.hostFit` and never forks the implementation.
+ */
+//# sourceMappingURL=hostScope.js.map

package/dist/cjs/hostScope.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["WEB5_ROOT_ID","exports","WEB5_ROOT_CLASS","WEB5_SCOPES","WEB5_SCOPE","join","WEB5_GLOBAL_TOKENS"],"sources":["../../src/hostScope.ts"],"sourcesContent":["/**\n * The mount-scope contract.\n *\n * Several packages have to agree on where Web5 content begins in a host\n * document:\n *\n *   - **web5-core** scopes its own CSS to it (`base-utilities.css` already\n *     targets `#root`).\n *   - **the client build** compiles every selector against it (`scopeCss` in\n *     `web5-core/scripts/scope-css.ts`).\n *   - **web50-server-ui** stamps `WEB5_ROOT_CLASS` on the element it mounts\n *     into, and renders the debug panel into `.debug-view`.\n *   - **embed-placement** mounts the *same* client bundle into\n *     `[data-web5-placement]` slots on host pages.\n *\n * One home for the list, so those cannot drift.\n *\n * ## Why it is a list and not just `#root`\n *\n * A placement renders client components **outside** `#root`, on the merchant's\n * own PDP. A stylesheet scoped to `#root` alone leaves every placement — and the\n * debug panel — completely unstyled. `w5-client-circana` and\n * `w5-client-feature-com` each discovered this and each hardcoded their own\n * list; this constant is what replaces both.\n */\nexport const WEB5_ROOT_ID = 'root';\n\nexport const WEB5_ROOT_CLASS = 'w5-root';\n\n/**\n * Every place Web5 content can be mounted.\n *\n * `#root` is the id the host runtime has always created, kept so the compiled\n * stylesheet matches before any script runs. `.w5-root` is stamped at mount and\n * keeps the contract working if the host ever renames the element.\n */\nexport const WEB5_SCOPES = [\n  `#${WEB5_ROOT_ID}`,\n  `.${WEB5_ROOT_CLASS}`,\n  '[data-web5-placement]',\n  '.debug-view',\n] as const;\n\n/**\n * `:is()` takes the specificity of its most specific argument, so this is worth\n * (1,0,0) whichever branch matches — enough to outrank the (0,1,1) descendant\n * selectors host themes use for rich-text typography.\n */\nexport const WEB5_SCOPE = `:is(${WEB5_SCOPES.join(',')})`;\n\n/**\n * Custom properties the **host** sets on `:root` at runtime. Their declarations\n * must stay global: moved into the scope they would shadow the host's value for\n * our own subtree, which is precisely where it is needed.\n *\n * Kept in sync with what `web50-server-ui` and the host offset injectors write.\n */\nexport const WEB5_GLOBAL_TOKENS: readonly RegExp[] = [\n  /^--web5-host-left-offset$/,\n  /^--web5-host-right-offset$/,\n  /^--web5-window-scroll-top-offset$/,\n];\n\n/**\n * Per-client overrides for the host adaptation web50-server-ui performs at\n * mount. Shared behaviour, client values — a client package supplies this on\n * `clientConfig.hostFit` and never forks the implementation.\n */\nexport interface HostFitConfig {\n  /** Master switch. Default `true`. */\n  enabled?: boolean;\n  /**\n   * What \"the full available width\" means on this site. Default\n   * `'main, [role=\"main\"]'`; falls back to `<body>` when nothing matches.\n   */\n  containerSelector?: string;\n  /**\n   * Widen the page's content container to the host container's content box.\n   * Default **`false`** — opt in per client.\n   *\n   * Off by default because widening changes the layout of hosts that are\n   * already sized correctly; only a client whose host constrains it (a theme\n   * that drops the mount into a narrow reading column) needs this.\n   */\n  bleed?: boolean;\n  /**\n   * Sticky-header height. `'auto'` (default) measures it; a number pins it.\n   *\n   * Prefer pinning where the host chrome is known. Circana's\n   * `inject-host-nav-offset` measured side rails at runtime, hit false\n   * positives in production (host layout containers and full-height nav panels\n   * matched the filter), and was changed to static values — the same trap\n   * applies to any measured host geometry.\n   */\n  topInset?: number | 'auto';\n}\n"],"mappings":";;;;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,MAAMA,YAAY,GAAAC,OAAA,CAAAD,YAAA,GAAG,MAAM;AAE3B,MAAME,eAAe,GAAAD,OAAA,CAAAC,eAAA,GAAG,SAAS;;AAExC;AACA;AACA;AACA;AACA;AACA;AACA;AACO,MAAMC,WAAW,GAAAF,OAAA,CAAAE,WAAA,GAAG,CACzB,IAAIH,YAAY,EAAE,EAClB,IAAIE,eAAe,EAAE,EACrB,uBAAuB,EACvB,aAAa,CACL;;AAEV;AACA;AACA;AACA;AACA;AACO,MAAME,UAAU,GAAAH,OAAA,CAAAG,UAAA,GAAG,OAAOD,WAAW,CAACE,IAAI,CAAC,GAAG,CAAC,GAAG;;AAEzD;AACA;AACA;AACA;AACA;AACA;AACA;AACO,MAAMC,kBAAqC,GAAAL,OAAA,CAAAK,kBAAA,GAAG,CACnD,2BAA2B,EAC3B,4BAA4B,EAC5B,mCAAmC,CACpC;;AAED;AACA;AACA;AACA;AACA","ignoreList":[]}

package/dist/cjs/index.js

@@ -1,9 +1,9 @@
 "use strict";
 
 exports.__esModule = true;
-exports.fetchProductsByHandles = exports.fetchEntityListData = exports.extractProtocol = exports.extractLinkMetadata = exports.extractIntentFromMarkdown = exports.extractContentMarkdown = exports.extractContent = exports.escapeWeb5Links = exports.ensureMinLightness = exports.enrichEntitiesFromPayload = exports.detectLinkType = exports.deriveRole = exports.deriveLightColor = exports.deriveDarkGradient = exports.deriveDarkColor = exports.defaultExtractor = exports.decodeLinkText = exports.createWixAuthFetch = exports.createSdkRegistry = exports.createPageSection = exports.createFeatureToggleReader = exports.createErrorMarkdown = exports.convertToBlockElementsWithMapping = exports.convertToBlockElements = exports.cn = exports.clearForwardStack = exports.buildPlacementDependencies = exports.buildImageSearchFilter = exports.backgroundFilter = exports.addToCart = exports.Web5UrlType = exports.WEB5_USER_QUERY_EVENT = exports.WEB5_REDIRECT_EVENT = exports.WEB5_ANSWER_UPDATED_EVENT = exports.UserQuery = exports.UnifiedMarkdownParser = exports.UnifiedLink = exports.TextBlockSectionDefinition = exports.TableRow = exports.TableHeader = exports.TableHead = exports.TableFooter = exports.TableCell = exports.TableCaption = exports.TableBody = exports.Table = exports.SmartIcon = exports.SkipNodesSectionDefinition = exports.ShopifyStorefrontClient = exports.SectionSkeleton = exports.SearchSectionDefinition = exports.SearchSection = exports.STREAMING_TIMEOUT_MS = exports.PromptEntryEmptyState = exports.PlacementSmoothHeight = exports.PlacementResponseRenderer = exports.PlacementPayloadProvider = exports.PlacementLoader = exports.PRODUCT_BY_HANDLE_QUERY = exports.OptimizedImage = exports.NextStepsSectionDefinition = exports.MarkdownText = exports.Loader = exports.ListItemsSectionDefinition = exports.LinkType = exports.KpiSectionDefinition = exports.Intent = exports.ImageSearchFilterToken = exports.HtmlCommentSectionDefinition = exports.HeroSectionDefinition = exports.HeroEntitySectionDefinition = exports.FeedbackBar = exports.FeatureToggleProvider = exports.FeatureSection9PlusDefinition = exports.FeatureCardsSectionDefinition = exports.FallbackSectionDefinition = exports.ErrorSectionDefinition = exports.EntitySectionDefinition = exports.EXPERIMENT_IDS = exports.ERROR_MARKDOWN = exports.Disclaimer = exports.DiagnosticsCollector = exports.DIAGNOSTIC_TYPES = exports.DEFAULT_ERROR_TEMPLATES = exports.DEFAULT_CONVERSATION_API = exports.CtaBannerSectionDefinition = exports.ComponentTracking = exports.ComponentRegistry = exports.ComponentDependenciesProvider = exports.ComparisonSectionDefinition = exports.ChipsProvider = exports.CalloutSectionDefinition = exports.CalloutBlock = exports.CONVERSATION_MODE = exports.CONVERSATION_API_KEY = exports.COLLECTION_BY_HANDLE_QUERY = exports.CLIENT_IDS = exports.CALLOUT_KINDS = exports.BottomContainer = exports.ARTICLE_BY_HANDLE_QUERY = void 0;
-exports.useWeb5Link = exports.useResolvedImageSources = exports.useResolveShopifyEntityData = exports.useResolveSearchSpringEntityData = exports.useResolveGenericEntityData = exports.usePlacementPayload = exports.useMarkdownUtils = exports.useFeatureToggles = exports.useFeatureToggle = exports.useEntityTransforms = exports.useDebugImageContext = exports.useConversation = exports.useComponentDependencies = exports.useChips = exports.tryParseComponent = exports.trimTrailingWhitespace = exports.transformToSolutionEntityData = exports.transformToGenericEntityData = exports.transformToBlogPostEntityData = exports.transformShopifyProduct = exports.transformShopifyEntityToItemData = exports.transformShopifyCollection = exports.transformShopifyArticle = exports.transformSSProductToEntityItemData = exports.toRgb = exports.stripMarkdown = exports.startNewChatId = exports.setForwardStack = exports.setConversationApi = exports.setChatId = exports.rgbToHsl = exports.resolveShopifyEntity = exports.resolveShopifyConfig = exports.resolveErrorTemplate = exports.resolveConversationMode = exports.resetChatIdForTests = exports.registerEntityExtractor = exports.pushToForwardStack = exports.pushPromptSubmit = exports.pushLinkClick = exports.pushExit = exports.pushEvent = exports.pushError = exports.pushEntityFiltered = exports.preprocessMarkdown = exports.popFromForwardStack = exports.parseWeb5Url = exports.parseMarkdownToComponents = exports.parseMarkdownToAst = exports.parseEntityLink = exports.parseAstToMarkdown = exports.normalizeImageUrl = exports.normalizeIconUrls = exports.nodesToParts = exports.mergeSectionsWithStableReferences = exports.matchMarkdown = exports.matchAllSections = exports.loadClientBundle = exports.isWeb5Url = exports.isWeb5SearchUrl = exports.isWeb5ImageUrl = exports.isWeb5IconUrl = exports.isWeb5EntityUrl = exports.isWeb5AskUrl = exports.isWeb5ActionUrl = exports.isValidWeb5Url = exports.isValidLinkUrl = exports.isTrustedBundleHost = exports.isNavigableUrl = exports.isLegacyUrl = exports.isHtmlComment = exports.isEntityLink = exports.hslToRgb = exports.hasImage = exports.hasAnalyticsConsent = exports.getSessionId = exports.getResizedImageUrl = exports.getPartsByType = exports.getPartByRole = exports.getOrCreateSessionId = exports.getLinks = exports.getIntentFromMarkdown = exports.getImages = exports.getHeading = exports.getForwardStack = exports.getErrorTypeFromStatus = exports.getEntityExtractor = exports.getConversationApi = exports.getContextualImageFilename = exports.getClientBundleOverride = exports.getChatId = exports.getAllByRole = exports.generateSectionId = exports.generateId = exports.fixMalformedLinks = exports.findKeywordsInContent = exports.findInvalidWeb5Links = exports.findImageInNode = exports.findImageInChildren = exports.fetchProductsByHandlesMap = void 0;
-exports.validatePatternWithBlocks = exports.validatePatternSyntax = exports.validatePattern = exports.validateLinkUrl = exports.usesTurnApi = void 0;
+exports.deriveLightColor = exports.deriveDarkGradient = exports.deriveDarkColor = exports.defaultExtractor = exports.decodeLinkText = exports.createWixAuthFetch = exports.createSdkRegistry = exports.createPageSection = exports.createFeatureToggleReader = exports.createErrorMarkdown = exports.convertToBlockElementsWithMapping = exports.convertToBlockElements = exports.computeContentBBox = exports.cn = exports.clearForwardStack = exports.buildProbeUrl = exports.buildPlacementDependencies = exports.buildImageSearchFilter = exports.backgroundFilter = exports.analyzeBackdrop = exports.addToCart = exports.Web5UrlType = exports.WEB5_USER_QUERY_EVENT = exports.WEB5_SCOPES = exports.WEB5_SCOPE = exports.WEB5_ROOT_ID = exports.WEB5_ROOT_CLASS = exports.WEB5_REDIRECT_EVENT = exports.WEB5_GLOBAL_TOKENS = exports.WEB5_ANSWER_UPDATED_EVENT = exports.UserQueryProvider = exports.UserQuery = exports.UnifiedMarkdownParser = exports.UnifiedLink = exports.TextBlockSectionDefinition = exports.TableRow = exports.TableHeader = exports.TableHead = exports.TableFooter = exports.TableCell = exports.TableCaption = exports.TableBody = exports.Table = exports.SmartIcon = exports.SkipNodesSectionDefinition = exports.ShopifyStorefrontClient = exports.SectionSkeleton = exports.SearchSectionDefinition = exports.SearchSection = exports.STREAMING_TIMEOUT_MS = exports.REFRESH_PROMPTS_WINDOW_MS = exports.REFRESH_PROMPTS_UNTIL_KEY = exports.PromptEntryEmptyState = exports.PlacementSmoothHeight = exports.PlacementResponseRenderer = exports.PlacementPayloadProvider = exports.PlacementLoader = exports.PRODUCT_BY_HANDLE_QUERY = exports.PRODUCT_BACK_SESSION_KEY = exports.OptimizedImage = exports.NextStepsSectionDefinition = exports.MarkdownText = exports.Loader = exports.ListItemsSectionDefinition = exports.LinkType = exports.LIST_ITEMS_ENDPOINT = exports.KpiSectionDefinition = exports.ImageSearchFilterToken = exports.HtmlCommentSectionDefinition = exports.HeroSectionDefinition = exports.HeroEntitySectionDefinition = exports.FeedbackBar = exports.FeatureToggleProvider = exports.FeatureSection9PlusDefinition = exports.FeatureCardsSectionDefinition = exports.FallbackSectionDefinition = exports.ErrorSectionDefinition = exports.EntitySectionDefinition = exports.EXPERIMENT_IDS = exports.ERROR_MARKDOWN = exports.Disclaimer = exports.DiagnosticsCollector = exports.DIAGNOSTIC_TYPES = exports.DEFAULT_ERROR_TEMPLATES = exports.DEFAULT_BACKEND_ENVIRONMENT = exports.CtaBannerSectionDefinition = exports.ComponentTracking = exports.ComponentRegistry = exports.ComponentDependenciesProvider = exports.ComparisonSectionDefinition = exports.ChipsProvider = exports.CalloutSectionDefinition = exports.CalloutBlock = exports.COLLECTION_BY_HANDLE_QUERY = exports.CLIENT_IDS = exports.CALLOUT_KINDS = exports.BottomContainer = exports.BACKEND_ENVIRONMENT_QUERY_PARAM = exports.BACKEND_ENVIRONMENT_KEY = exports.ARTICLE_BY_HANDLE_QUERY = void 0;
+exports.transformShopifyProduct = exports.transformShopifyEntityToItemData = exports.transformShopifyCollection = exports.transformShopifyArticle = exports.transformSSProductToEntityItemData = exports.toRgb = exports.stripMarkdown = exports.startNewChatId = exports.shouldRefreshPrompts = exports.setForwardStack = exports.setChatId = exports.setBackendEnvironment = exports.rgbToHsl = exports.resolveShopifyEntity = exports.resolveShopifyConfig = exports.resolveErrorTemplate = exports.resetChatIdForTests = exports.registerEntityExtractor = exports.readProductBackHandoff = exports.pushToForwardStack = exports.pushPromptSubmit = exports.pushLinkClick = exports.pushExit = exports.pushEvent = exports.pushError = exports.pushEntityFiltered = exports.preprocessMarkdown = exports.popFromForwardStack = exports.parseWeb5Url = exports.parseMarkdownToComponents = exports.parseMarkdownToAst = exports.parseEntityLink = exports.parseAstToMarkdown = exports.normalizeImageUrl = exports.normalizeIconUrls = exports.nodesToParts = exports.mergeSectionsWithStableReferences = exports.matchMarkdown = exports.matchAllSections = exports.loadImagePixels = exports.loadClientBundle = exports.loadBackdropAnalysis = exports.listEntityItems = exports.isWeb5Url = exports.isWeb5SearchUrl = exports.isWeb5ImageUrl = exports.isWeb5IconUrl = exports.isWeb5EntityUrl = exports.isWeb5AskUrl = exports.isWeb5ActionUrl = exports.isValidWeb5Url = exports.isValidLinkUrl = exports.isTrustedBundleHost = exports.isNavigableUrl = exports.isLegacyUrl = exports.isHtmlComment = exports.isEntityLink = exports.hslToRgb = exports.hasImage = exports.hasAnalyticsConsent = exports.getSessionId = exports.getResizedImageUrl = exports.getRefreshPromptsExpiry = exports.getPartsByType = exports.getPartByRole = exports.getOrCreateSessionId = exports.getLinks = exports.getIntentFromMarkdown = exports.getImages = exports.getHeading = exports.getForwardStack = exports.getErrorTypeFromStatus = exports.getEntityExtractor = exports.getContextualImageFilename = exports.getClientBundleOverride = exports.getChatId = exports.getBackendEnvironment = exports.getAllByRole = exports.generateSectionId = exports.generateId = exports.fixMalformedLinks = exports.findKeywordsInContent = exports.findInvalidWeb5Links = exports.findImageInNode = exports.findImageInChildren = exports.fetchProductsByHandlesMap = exports.fetchProductsByHandles = exports.fetchEntityListData = exports.extractProtocol = exports.extractLinkMetadata = exports.extractIntentFromMarkdown = exports.extractContentMarkdown = exports.extractContent = exports.escapeWeb5Links = exports.ensureMinLightness = exports.enrichEntitiesFromPayload = exports.enableRefreshPrompts = exports.disableRefreshPrompts = exports.detectLinkType = exports.deriveRole = void 0;
+exports.writeProductBackHandoff = exports.validatePatternWithBlocks = exports.validatePatternSyntax = exports.validatePattern = exports.validateLinkUrl = exports.usesStagingBackend = exports.useWeb5Link = exports.useUserQuery = exports.useResolvedImageSources = exports.useResolveShopifyEntityData = exports.useResolveSearchSpringEntityData = exports.useResolveGenericEntityData = exports.usePlacementPayload = exports.useMarkdownUtils = exports.useFeatureToggles = exports.useFeatureToggle = exports.useEntityTransforms = exports.useDebugImageContext = exports.useConversation = exports.useComponentDependencies = exports.useChips = exports.tryParseComponent = exports.trimTrailingWhitespace = exports.transformToSolutionEntityData = exports.transformToGenericEntityData = exports.transformToBlogPostEntityData = void 0;
 var _clients = require("./clients");
 exports.CLIENT_IDS = _clients.CLIENT_IDS;
 exports.EXPERIMENT_IDS = _clients.EXPERIMENT_IDS;
@@ -50,7 +50,6 @@ exports.FallbackSectionDefinition = _componentDefinitions.FallbackSectionDefinit
 exports.createSdkRegistry = _componentDefinitions.createSdkRegistry;
 var _registry = require("./registry");
 exports.ComponentRegistry = _registry.ComponentRegistry;
-exports.Intent = _registry.Intent;
 var _patternValidator = require("./patternValidator");
 exports.validatePattern = _patternValidator.validatePattern;
 exports.validatePatternSyntax = _patternValidator.validatePatternSyntax;
@@ -90,6 +89,9 @@ exports.nodesToParts = _match.nodesToParts;
 var _ComponentDependenciesContext = require("./context/ComponentDependenciesContext");
 exports.ComponentDependenciesProvider = _ComponentDependenciesContext.ComponentDependenciesProvider;
 exports.useComponentDependencies = _ComponentDependenciesContext.useComponentDependencies;
+var _UserQueryContext = require("./context/UserQueryContext");
+exports.UserQueryProvider = _UserQueryContext.UserQueryProvider;
+exports.useUserQuery = _UserQueryContext.useUserQuery;
 var _ChipsContext = require("./context/ChipsContext");
 exports.ChipsProvider = _ChipsContext.ChipsProvider;
 exports.useChips = _ChipsContext.useChips;
@@ -97,6 +99,8 @@ var _entity = require("./entity");
 exports.defaultExtractor = _entity.defaultExtractor;
 exports.enrichEntitiesFromPayload = _entity.enrichEntitiesFromPayload;
 exports.fetchEntityListData = _entity.fetchEntityListData;
+exports.listEntityItems = _entity.listEntityItems;
+exports.LIST_ITEMS_ENDPOINT = _entity.LIST_ITEMS_ENDPOINT;
 exports.getEntityExtractor = _entity.getEntityExtractor;
 exports.registerEntityExtractor = _entity.registerEntityExtractor;
 exports.transformToSolutionEntityData = _entity.transformToSolutionEntityData;
@@ -144,6 +148,12 @@ exports.cn = _utils.cn;
 var _imageUtils = require("./utils/image-utils");
 exports.normalizeImageUrl = _imageUtils.normalizeImageUrl;
 exports.getResizedImageUrl = _imageUtils.getResizedImageUrl;
+var _imageBackdrop = require("./utils/imageBackdrop");
+exports.analyzeBackdrop = _imageBackdrop.analyzeBackdrop;
+exports.computeContentBBox = _imageBackdrop.computeContentBBox;
+exports.buildProbeUrl = _imageBackdrop.buildProbeUrl;
+exports.loadImagePixels = _imageBackdrop.loadImagePixels;
+exports.loadBackdropAnalysis = _imageBackdrop.loadBackdropAnalysis;
 var _parseUtils = require("./component/componentDefinitions/parse-utils");
 exports.stripMarkdown = _parseUtils.stripMarkdown;
 var _colorUtils = require("./color/colorUtils");
@@ -177,6 +187,10 @@ exports.pushToForwardStack = _navigationStack.pushToForwardStack;
 exports.popFromForwardStack = _navigationStack.popFromForwardStack;
 var _UserQuery = require("./components/ui/UserQuery");
 exports.UserQuery = _UserQuery.UserQuery;
+var _productBackHandoff = require("./utils/productBackHandoff");
+exports.PRODUCT_BACK_SESSION_KEY = _productBackHandoff.PRODUCT_BACK_SESSION_KEY;
+exports.writeProductBackHandoff = _productBackHandoff.writeProductBackHandoff;
+exports.readProductBackHandoff = _productBackHandoff.readProductBackHandoff;
 var _PromptEntryEmptyState = require("./components/ui/PromptEntryEmptyState");
 exports.PromptEntryEmptyState = _PromptEntryEmptyState.PromptEntryEmptyState;
 var _SearchSection = require("./components/ui/SearchSection");
@@ -260,15 +274,20 @@ exports.findImageInNode = _propsExtractor.findImageInNode;
 exports.findImageInChildren = _propsExtractor.findImageInChildren;
 var _diagnosticsCollector = require("./utils/diagnosticsCollector");
 exports.DiagnosticsCollector = _diagnosticsCollector.DiagnosticsCollector;
-var _conversationMode = require("./utils/conversationMode");
-exports.CONVERSATION_MODE = _conversationMode.CONVERSATION_MODE;
-exports.resolveConversationMode = _conversationMode.resolveConversationMode;
-var _conversationApi = require("./utils/conversationApi");
-exports.CONVERSATION_API_KEY = _conversationApi.CONVERSATION_API_KEY;
-exports.DEFAULT_CONVERSATION_API = _conversationApi.DEFAULT_CONVERSATION_API;
-exports.getConversationApi = _conversationApi.getConversationApi;
-exports.setConversationApi = _conversationApi.setConversationApi;
-exports.usesTurnApi = _conversationApi.usesTurnApi;
+var _refreshPrompts = require("./utils/refreshPrompts");
+exports.REFRESH_PROMPTS_UNTIL_KEY = _refreshPrompts.REFRESH_PROMPTS_UNTIL_KEY;
+exports.REFRESH_PROMPTS_WINDOW_MS = _refreshPrompts.REFRESH_PROMPTS_WINDOW_MS;
+exports.getRefreshPromptsExpiry = _refreshPrompts.getRefreshPromptsExpiry;
+exports.shouldRefreshPrompts = _refreshPrompts.shouldRefreshPrompts;
+exports.enableRefreshPrompts = _refreshPrompts.enableRefreshPrompts;
+exports.disableRefreshPrompts = _refreshPrompts.disableRefreshPrompts;
+var _backendEnvironment = require("./utils/backendEnvironment");
+exports.BACKEND_ENVIRONMENT_KEY = _backendEnvironment.BACKEND_ENVIRONMENT_KEY;
+exports.BACKEND_ENVIRONMENT_QUERY_PARAM = _backendEnvironment.BACKEND_ENVIRONMENT_QUERY_PARAM;
+exports.DEFAULT_BACKEND_ENVIRONMENT = _backendEnvironment.DEFAULT_BACKEND_ENVIRONMENT;
+exports.getBackendEnvironment = _backendEnvironment.getBackendEnvironment;
+exports.setBackendEnvironment = _backendEnvironment.setBackendEnvironment;
+exports.usesStagingBackend = _backendEnvironment.usesStagingBackend;
 var _wixAuthFetch = require("./client/wixAuthFetch");
 exports.createWixAuthFetch = _wixAuthFetch.createWixAuthFetch;
 var _sessionManager = require("./utils/sessionManager");
@@ -282,4 +301,10 @@ var _componentParser = require("./component/componentParser");
 exports.parseMarkdownToComponents = _componentParser.parseMarkdownToComponents;
 exports.tryParseComponent = _componentParser.tryParseComponent;
 exports.mergeSectionsWithStableReferences = _componentParser.mergeSectionsWithStableReferences;
+var _hostScope = require("./hostScope");
+exports.WEB5_ROOT_ID = _hostScope.WEB5_ROOT_ID;
+exports.WEB5_ROOT_CLASS = _hostScope.WEB5_ROOT_CLASS;
+exports.WEB5_SCOPES = _hostScope.WEB5_SCOPES;
+exports.WEB5_SCOPE = _hostScope.WEB5_SCOPE;
+exports.WEB5_GLOBAL_TOKENS = _hostScope.WEB5_GLOBAL_TOKENS;
 //# sourceMappingURL=index.js.map