@wix/web5-core 1.56.0

package/dist/cjs/entity/fetchEntityListData.js

@@ -0,0 +1,78 @@
+"use strict";
+
+exports.__esModule = true;
+exports.__resetEntityListDataCache = __resetEntityListDataCache;
+exports.fetchEntityListData = fetchEntityListData;
+/**
+ * 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
+ * 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,
+ * the app's `client.fetchWithAuth` in the main app).
+ *
+ * The same singleton cache used to live inside `useEntityListData`. Hoisting
+ * it here means a section that renders first in the main app and then
+ * 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
+ * fetched rows.
+ *
+ * On HTTP error or network failure, the returned Map omits the requested
+ * id; callers decide whether to fire a diagnostic. The promise resolves
+ * either way — the caller's UI should keep rendering with whatever it has.
+ */
+async function fetchEntityListData(ids, opts = {}) {
+  const result = new Map();
+  if (!ids.length) return result;
+  const uncachedIds = [];
+  for (const id of ids) {
+    const cached = entityCache.get(id);
+    if (cached) {
+      result.set(id, cached);
+    } else {
+      uncachedIds.push(id);
+    }
+  }
+  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);
+  try {
+    const res = await fetchImpl(url.toString(), {
+      method: 'GET',
+      headers: {
+        'Content-Type': 'application/json'
+      }
+    });
+    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);
+      }
+    }
+  } catch {
+    // network / parse error — return whatever we have from cache
+  }
+  return result;
+}
+
+/** Test helper — drops the singleton cache so specs start clean. */
+function __resetEntityListDataCache() {
+  entityCache.clear();
+}
+//# sourceMappingURL=fetchEntityListData.js.map

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

@@ -0,0 +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":[]}

package/dist/cjs/entity/index.js

@@ -0,0 +1,41 @@
+"use strict";
+
+exports.__esModule = true;
+exports.fetchEntityListData = exports.enrichEntitiesFromPayload = void 0;
+exports.getEntityExtractor = getEntityExtractor;
+exports.registerEntityExtractor = registerEntityExtractor;
+exports.transformToSolutionEntityData = exports.transformToGenericEntityData = exports.transformToBlogPostEntityData = void 0;
+var _defaultExtractor = require("./defaultExtractor");
+exports.defaultExtractor = _defaultExtractor.defaultExtractor;
+exports.transformToSolutionEntityData = _defaultExtractor.transformToSolutionEntityData;
+exports.transformToBlogPostEntityData = _defaultExtractor.transformToBlogPostEntityData;
+exports.transformToGenericEntityData = _defaultExtractor.transformToGenericEntityData;
+var _enrichEntitiesFromPayload = require("./enrichEntitiesFromPayload");
+exports.enrichEntitiesFromPayload = _enrichEntitiesFromPayload.enrichEntitiesFromPayload;
+var _fetchEntityListData = require("./fetchEntityListData");
+exports.fetchEntityListData = _fetchEntityListData.fetchEntityListData;
+/**
+ * Registry of client-specific entity extractors.
+ * Only needed if a client requires custom extraction logic beyond the config-driven default.
+ */
+const extractorRegistry = {};
+
+/**
+ * Get the entity extractor for a specific client.
+ * The default extractor is config-driven and works for any client with entityConfig.
+ */
+function getEntityExtractor(clientId) {
+  if (clientId && extractorRegistry[clientId]) {
+    return extractorRegistry[clientId];
+  }
+  return _defaultExtractor.defaultExtractor;
+}
+
+/**
+ * Register a custom entity extractor for a client
+ * Useful for runtime registration or testing
+ */
+function registerEntityExtractor(clientId, extractor) {
+  extractorRegistry[clientId] = extractor;
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +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":[]}

package/dist/cjs/entity/types.js

@@ -0,0 +1,4 @@
+"use strict";
+
+exports.__esModule = true;
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":[],"sources":["../../../src/entity/types.ts"],"sourcesContent":["import type { ApiPayloadItem, EntityConfig } from '../types/entity';\n\n/**\n * Interface for client-specific entity extractors.\n * Provides generic URL parsing and payload lookup — no entity-type-specific methods.\n */\nexport interface EntityExtractor {\n  extractEntityIdFromUrl(\n    entityUrl: string,\n  ): { entityType: string; entityId: string } | null;\n\n  findEntityInPayload(\n    entityType: string,\n    entityId: string,\n    payload: ApiPayloadItem[],\n    entityConfig: EntityConfig,\n  ): ApiPayloadItem | null;\n}\n"],"mappings":"","ignoreList":[]}

package/dist/cjs/errors/conversationErrorTypes.js

@@ -0,0 +1,56 @@
+"use strict";
+
+exports.__esModule = true;
+exports.getErrorTypeFromStatus = exports.createErrorMarkdown = exports.STREAMING_TIMEOUT_MS = exports.ERROR_MARKDOWN = void 0;
+/**
+ * Conversation Error Types
+ *
+ * Canonical error type definitions and utilities for the error handling pipeline.
+ * Maps HTTP status codes and error conditions to typed error identifiers.
+ *
+ * Prefix conventions:
+ *   conversation-  → errors during conversation streaming flow
+ *   history-       → errors during conversation history loading
+ */
+
+/** Error markdown strings that ErrorSectionDefinition recognizes */
+const ERROR_MARKDOWN = exports.ERROR_MARKDOWN = {
+  'conversation-404': 'Error: conversation-404',
+  'conversation-403': 'Error: conversation-403',
+  'conversation-500': 'Error: conversation-500',
+  'conversation-generic-network-error': 'Error: conversation-generic-network-error',
+  'conversation-timeout': 'Error: conversation-timeout',
+  'conversation-streaming-error': 'Error: conversation-streaming-error',
+  'conversation-partial-load': 'Error: conversation-partial-load',
+  'conversation-llm-empty-response': 'Error: conversation-llm-empty-response',
+  'conversation-llm-error-text': 'Error',
+  'history-load-error': 'Error: history-load-error'
+};
+
+/** Maps HTTP status code to error type */
+const getErrorTypeFromStatus = status => {
+  if (status === 404) {
+    return 'conversation-404';
+  }
+  if (status === 403) {
+    return 'conversation-403';
+  }
+  if (status >= 500) {
+    return 'conversation-500';
+  }
+  if (status >= 400) {
+    return 'conversation-generic-network-error';
+  }
+  return 'conversation-llm-error-text';
+};
+
+/** Creates error markdown string for the given error type */
+exports.getErrorTypeFromStatus = getErrorTypeFromStatus;
+const createErrorMarkdown = type => {
+  return ERROR_MARKDOWN[type] || ERROR_MARKDOWN['conversation-llm-error-text'];
+};
+
+/** Streaming timeout in milliseconds (60 seconds) */
+exports.createErrorMarkdown = createErrorMarkdown;
+const STREAMING_TIMEOUT_MS = exports.STREAMING_TIMEOUT_MS = 60000;
+//# sourceMappingURL=conversationErrorTypes.js.map

package/dist/cjs/errors/conversationErrorTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["ERROR_MARKDOWN","exports","getErrorTypeFromStatus","status","createErrorMarkdown","type","STREAMING_TIMEOUT_MS"],"sources":["../../../src/errors/conversationErrorTypes.ts"],"sourcesContent":["/**\n * Conversation Error Types\n *\n * Canonical error type definitions and utilities for the error handling pipeline.\n * Maps HTTP status codes and error conditions to typed error identifiers.\n *\n * Prefix conventions:\n *   conversation-  → errors during conversation streaming flow\n *   history-       → errors during conversation history loading\n */\n\nexport type ConversationErrorType =\n  | 'conversation-llm-error-text'\n  | 'conversation-llm-empty-response'\n  | 'conversation-500'\n  | 'conversation-generic-network-error'\n  | 'conversation-timeout'\n  | 'conversation-streaming-error'\n  | 'conversation-404'\n  | 'conversation-403'\n  | 'conversation-partial-load'\n  | 'history-load-error';\n\n/** Error markdown strings that ErrorSectionDefinition recognizes */\nexport const ERROR_MARKDOWN: Record<ConversationErrorType, string> = {\n  'conversation-404': 'Error: conversation-404',\n  'conversation-403': 'Error: conversation-403',\n  'conversation-500': 'Error: conversation-500',\n  'conversation-generic-network-error':\n    'Error: conversation-generic-network-error',\n  'conversation-timeout': 'Error: conversation-timeout',\n  'conversation-streaming-error': 'Error: conversation-streaming-error',\n  'conversation-partial-load': 'Error: conversation-partial-load',\n  'conversation-llm-empty-response': 'Error: conversation-llm-empty-response',\n  'conversation-llm-error-text': 'Error',\n  'history-load-error': 'Error: history-load-error',\n};\n\n/** Maps HTTP status code to error type */\nexport const getErrorTypeFromStatus = (\n  status: number,\n): ConversationErrorType => {\n  if (status === 404) {\n    return 'conversation-404';\n  }\n  if (status === 403) {\n    return 'conversation-403';\n  }\n  if (status >= 500) {\n    return 'conversation-500';\n  }\n  if (status >= 400) {\n    return 'conversation-generic-network-error';\n  }\n  return 'conversation-llm-error-text';\n};\n\n/** Creates error markdown string for the given error type */\nexport const createErrorMarkdown = (type: ConversationErrorType): string => {\n  return ERROR_MARKDOWN[type] || ERROR_MARKDOWN['conversation-llm-error-text'];\n};\n\n/** Streaming timeout in milliseconds (60 seconds) */\nexport const STREAMING_TIMEOUT_MS = 60000;\n"],"mappings":";;;;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAcA;AACO,MAAMA,cAAqD,GAAAC,OAAA,CAAAD,cAAA,GAAG;EACnE,kBAAkB,EAAE,yBAAyB;EAC7C,kBAAkB,EAAE,yBAAyB;EAC7C,kBAAkB,EAAE,yBAAyB;EAC7C,oCAAoC,EAClC,2CAA2C;EAC7C,sBAAsB,EAAE,6BAA6B;EACrD,8BAA8B,EAAE,qCAAqC;EACrE,2BAA2B,EAAE,kCAAkC;EAC/D,iCAAiC,EAAE,wCAAwC;EAC3E,6BAA6B,EAAE,OAAO;EACtC,oBAAoB,EAAE;AACxB,CAAC;;AAED;AACO,MAAME,sBAAsB,GACjCC,MAAc,IACY;EAC1B,IAAIA,MAAM,KAAK,GAAG,EAAE;IAClB,OAAO,kBAAkB;EAC3B;EACA,IAAIA,MAAM,KAAK,GAAG,EAAE;IAClB,OAAO,kBAAkB;EAC3B;EACA,IAAIA,MAAM,IAAI,GAAG,EAAE;IACjB,OAAO,kBAAkB;EAC3B;EACA,IAAIA,MAAM,IAAI,GAAG,EAAE;IACjB,OAAO,oCAAoC;EAC7C;EACA,OAAO,6BAA6B;AACtC,CAAC;;AAED;AAAAF,OAAA,CAAAC,sBAAA,GAAAA,sBAAA;AACO,MAAME,mBAAmB,GAAIC,IAA2B,IAAa;EAC1E,OAAOL,cAAc,CAACK,IAAI,CAAC,IAAIL,cAAc,CAAC,6BAA6B,CAAC;AAC9E,CAAC;;AAED;AAAAC,OAAA,CAAAG,mBAAA,GAAAA,mBAAA;AACO,MAAME,oBAAoB,GAAAL,OAAA,CAAAK,oBAAA,GAAG,KAAK","ignoreList":[]}

package/dist/cjs/errors/errorTemplates.js

@@ -0,0 +1,86 @@
+"use strict";
+
+exports.__esModule = true;
+exports.resolveErrorTemplate = exports.DEFAULT_ERROR_TEMPLATES = void 0;
+/** Action identifiers for error template buttons — resolved to callbacks by the rendering component */
+
+/** Icon identifiers for error templates — resolved to SVG components by the rendering component */
+
+const retryAndContactButtons = [{
+  text: 'Try Again',
+  action: 'retry',
+  variant: 'cta'
+}, {
+  text: 'Contact Us',
+  variant: 'link'
+}];
+const DEFAULT_ERROR_TEMPLATES = exports.DEFAULT_ERROR_TEMPLATES = {
+  'conversation-llm-error-text': {
+    title: "I couldn't find information about what you asked.\nTry asking about a different topic.",
+    showChips: true
+  },
+  'conversation-llm-empty-response': {
+    title: "I couldn't find information about what you asked.\nTry asking about a different topic.",
+    showChips: true
+  },
+  'conversation-500': {
+    iconType: 'error-500',
+    title: "This page isn't available right now.",
+    buttons: retryAndContactButtons
+  },
+  'conversation-generic-network-error': {
+    iconType: 'timeout',
+    title: 'Something went wrong on our side.\nPlease try again in a moment.',
+    buttons: retryAndContactButtons
+  },
+  'conversation-timeout': {
+    iconType: 'timeout',
+    title: 'Something went wrong on our side.\nPlease try again in a moment.',
+    buttons: retryAndContactButtons
+  },
+  'conversation-streaming-error': {
+    iconType: 'streaming-error',
+    title: 'The connection dropped. Please try again.',
+    buttons: retryAndContactButtons
+  },
+  'conversation-404': {
+    iconType: 'not-found',
+    title: 'Page not found.\nIt happens! Let\u2019s get you back on track',
+    showChips: true,
+    chipsLabel: 'Some ideas to get you started:'
+  },
+  'conversation-403': {
+    iconType: 'forbidden',
+    title: 'Welcome back.\nFor privacy, we couldn\u2019t restore previous content. Ask anything to continue.',
+    showChips: true,
+    chipsLabel: 'Some ideas to get you started:'
+  },
+  'conversation-partial-load': {
+    iconType: 'partial-load',
+    title: 'Some content didn\u2019t load',
+    buttons: retryAndContactButtons
+  },
+  'history-load-error': {
+    iconType: 'streaming-error',
+    title: 'We couldn\u2019t load this conversation.',
+    buttons: [{
+      text: 'New Conversation',
+      action: 'newConversation',
+      variant: 'cta'
+    }, {
+      text: 'Contact Us',
+      variant: 'link'
+    }]
+  }
+};
+
+/** Resolves the error template for a given type, merging client overrides on top of defaults */
+const resolveErrorTemplate = (type, overrides) => {
+  const templates = overrides ? {
+    ...DEFAULT_ERROR_TEMPLATES,
+    ...overrides
+  } : DEFAULT_ERROR_TEMPLATES;
+  return templates[type] ?? templates['conversation-llm-error-text'];
+};
+exports.resolveErrorTemplate = resolveErrorTemplate;
+//# sourceMappingURL=errorTemplates.js.map

package/dist/cjs/errors/errorTemplates.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["retryAndContactButtons","text","action","variant","DEFAULT_ERROR_TEMPLATES","exports","title","showChips","iconType","buttons","chipsLabel","resolveErrorTemplate","type","overrides","templates"],"sources":["../../../src/errors/errorTemplates.ts"],"sourcesContent":["import type { ConversationErrorType } from './conversationErrorTypes';\n\n/** Action identifiers for error template buttons — resolved to callbacks by the rendering component */\nexport type ErrorActionType = 'retry' | 'newConversation' | 'reload';\n\n/** Icon identifiers for error templates — resolved to SVG components by the rendering component */\nexport type ErrorIconType =\n  | 'error-500'\n  | 'timeout'\n  | 'streaming-error'\n  | 'not-found'\n  | 'forbidden'\n  | 'partial-load';\n\nexport interface ErrorTemplateButton {\n  text: string;\n  /** URL for navigation (renders as a link) */\n  href?: string;\n  /** Action identifier — component resolves to a callback */\n  action?: ErrorActionType;\n  variant: 'cta' | 'link';\n}\n\nexport interface ErrorTemplate {\n  title: string;\n  subtitle?: string;\n  /** Icon identifier — component resolves to an SVG */\n  iconType?: ErrorIconType;\n  buttons?: ErrorTemplateButton[];\n  showChips?: boolean;\n  chipsLabel?: string;\n}\n\nexport type ErrorTemplateOverrides = Partial<\n  Record<ConversationErrorType, ErrorTemplate>\n>;\n\nconst retryAndContactButtons: ErrorTemplateButton[] = [\n  { text: 'Try Again', action: 'retry', variant: 'cta' },\n  { text: 'Contact Us', variant: 'link' },\n];\n\nexport const DEFAULT_ERROR_TEMPLATES: Record<\n  ConversationErrorType,\n  ErrorTemplate\n> = {\n  'conversation-llm-error-text': {\n    title:\n      \"I couldn't find information about what you asked.\\nTry asking about a different topic.\",\n    showChips: true,\n  },\n  'conversation-llm-empty-response': {\n    title:\n      \"I couldn't find information about what you asked.\\nTry asking about a different topic.\",\n    showChips: true,\n  },\n  'conversation-500': {\n    iconType: 'error-500',\n    title: \"This page isn't available right now.\",\n    buttons: retryAndContactButtons,\n  },\n  'conversation-generic-network-error': {\n    iconType: 'timeout',\n    title: 'Something went wrong on our side.\\nPlease try again in a moment.',\n    buttons: retryAndContactButtons,\n  },\n  'conversation-timeout': {\n    iconType: 'timeout',\n    title: 'Something went wrong on our side.\\nPlease try again in a moment.',\n    buttons: retryAndContactButtons,\n  },\n  'conversation-streaming-error': {\n    iconType: 'streaming-error',\n    title: 'The connection dropped. Please try again.',\n    buttons: retryAndContactButtons,\n  },\n  'conversation-404': {\n    iconType: 'not-found',\n    title: 'Page not found.\\nIt happens! Let\\u2019s get you back on track',\n    showChips: true,\n    chipsLabel: 'Some ideas to get you started:',\n  },\n  'conversation-403': {\n    iconType: 'forbidden',\n    title:\n      'Welcome back.\\nFor privacy, we couldn\\u2019t restore previous content. Ask anything to continue.',\n    showChips: true,\n    chipsLabel: 'Some ideas to get you started:',\n  },\n  'conversation-partial-load': {\n    iconType: 'partial-load',\n    title: 'Some content didn\\u2019t load',\n    buttons: retryAndContactButtons,\n  },\n  'history-load-error': {\n    iconType: 'streaming-error',\n    title: 'We couldn\\u2019t load this conversation.',\n    buttons: [\n      { text: 'New Conversation', action: 'newConversation', variant: 'cta' },\n      { text: 'Contact Us', variant: 'link' },\n    ],\n  },\n};\n\n/** Resolves the error template for a given type, merging client overrides on top of defaults */\nexport const resolveErrorTemplate = (\n  type: string,\n  overrides?: ErrorTemplateOverrides,\n): ErrorTemplate => {\n  const templates = overrides\n    ? { ...DEFAULT_ERROR_TEMPLATES, ...overrides }\n    : DEFAULT_ERROR_TEMPLATES;\n  return (\n    templates[type as ConversationErrorType] ??\n    templates['conversation-llm-error-text']\n  );\n};\n"],"mappings":";;;;AAEA;;AAGA;;AAgCA,MAAMA,sBAA6C,GAAG,CACpD;EAAEC,IAAI,EAAE,WAAW;EAAEC,MAAM,EAAE,OAAO;EAAEC,OAAO,EAAE;AAAM,CAAC,EACtD;EAAEF,IAAI,EAAE,YAAY;EAAEE,OAAO,EAAE;AAAO,CAAC,CACxC;AAEM,MAAMC,uBAGZ,GAAAC,OAAA,CAAAD,uBAAA,GAAG;EACF,6BAA6B,EAAE;IAC7BE,KAAK,EACH,wFAAwF;IAC1FC,SAAS,EAAE;EACb,CAAC;EACD,iCAAiC,EAAE;IACjCD,KAAK,EACH,wFAAwF;IAC1FC,SAAS,EAAE;EACb,CAAC;EACD,kBAAkB,EAAE;IAClBC,QAAQ,EAAE,WAAW;IACrBF,KAAK,EAAE,sCAAsC;IAC7CG,OAAO,EAAET;EACX,CAAC;EACD,oCAAoC,EAAE;IACpCQ,QAAQ,EAAE,SAAS;IACnBF,KAAK,EAAE,kEAAkE;IACzEG,OAAO,EAAET;EACX,CAAC;EACD,sBAAsB,EAAE;IACtBQ,QAAQ,EAAE,SAAS;IACnBF,KAAK,EAAE,kEAAkE;IACzEG,OAAO,EAAET;EACX,CAAC;EACD,8BAA8B,EAAE;IAC9BQ,QAAQ,EAAE,iBAAiB;IAC3BF,KAAK,EAAE,2CAA2C;IAClDG,OAAO,EAAET;EACX,CAAC;EACD,kBAAkB,EAAE;IAClBQ,QAAQ,EAAE,WAAW;IACrBF,KAAK,EAAE,+DAA+D;IACtEC,SAAS,EAAE,IAAI;IACfG,UAAU,EAAE;EACd,CAAC;EACD,kBAAkB,EAAE;IAClBF,QAAQ,EAAE,WAAW;IACrBF,KAAK,EACH,kGAAkG;IACpGC,SAAS,EAAE,IAAI;IACfG,UAAU,EAAE;EACd,CAAC;EACD,2BAA2B,EAAE;IAC3BF,QAAQ,EAAE,cAAc;IACxBF,KAAK,EAAE,+BAA+B;IACtCG,OAAO,EAAET;EACX,CAAC;EACD,oBAAoB,EAAE;IACpBQ,QAAQ,EAAE,iBAAiB;IAC3BF,KAAK,EAAE,0CAA0C;IACjDG,OAAO,EAAE,CACP;MAAER,IAAI,EAAE,kBAAkB;MAAEC,MAAM,EAAE,iBAAiB;MAAEC,OAAO,EAAE;IAAM,CAAC,EACvE;MAAEF,IAAI,EAAE,YAAY;MAAEE,OAAO,EAAE;IAAO,CAAC;EAE3C;AACF,CAAC;;AAED;AACO,MAAMQ,oBAAoB,GAAGA,CAClCC,IAAY,EACZC,SAAkC,KAChB;EAClB,MAAMC,SAAS,GAAGD,SAAS,GACvB;IAAE,GAAGT,uBAAuB;IAAE,GAAGS;EAAU,CAAC,GAC5CT,uBAAuB;EAC3B,OACEU,SAAS,CAACF,IAAI,CAA0B,IACxCE,SAAS,CAAC,6BAA6B,CAAC;AAE5C,CAAC;AAACT,OAAA,CAAAM,oBAAA,GAAAA,oBAAA","ignoreList":[]}

package/dist/cjs/errors/index.js

@@ -0,0 +1,13 @@
+"use strict";
+
+exports.__esModule = true;
+exports.resolveErrorTemplate = exports.getErrorTypeFromStatus = exports.createErrorMarkdown = exports.STREAMING_TIMEOUT_MS = exports.ERROR_MARKDOWN = exports.DEFAULT_ERROR_TEMPLATES = void 0;
+var _conversationErrorTypes = require("./conversationErrorTypes");
+exports.ERROR_MARKDOWN = _conversationErrorTypes.ERROR_MARKDOWN;
+exports.getErrorTypeFromStatus = _conversationErrorTypes.getErrorTypeFromStatus;
+exports.createErrorMarkdown = _conversationErrorTypes.createErrorMarkdown;
+exports.STREAMING_TIMEOUT_MS = _conversationErrorTypes.STREAMING_TIMEOUT_MS;
+var _errorTemplates = require("./errorTemplates");
+exports.DEFAULT_ERROR_TEMPLATES = _errorTemplates.DEFAULT_ERROR_TEMPLATES;
+exports.resolveErrorTemplate = _errorTemplates.resolveErrorTemplate;
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["_conversationErrorTypes","require","exports","ERROR_MARKDOWN","getErrorTypeFromStatus","createErrorMarkdown","STREAMING_TIMEOUT_MS","_errorTemplates","DEFAULT_ERROR_TEMPLATES","resolveErrorTemplate"],"sources":["../../../src/errors/index.ts"],"sourcesContent":["export {\n  type ConversationErrorType,\n  ERROR_MARKDOWN,\n  getErrorTypeFromStatus,\n  createErrorMarkdown,\n  STREAMING_TIMEOUT_MS,\n} from './conversationErrorTypes';\n\nexport {\n  type ErrorActionType,\n  type ErrorIconType,\n  type ErrorTemplateButton,\n  type ErrorTemplate,\n  type ErrorTemplateOverrides,\n  DEFAULT_ERROR_TEMPLATES,\n  resolveErrorTemplate,\n} from './errorTemplates';\n"],"mappings":";;;;AAAA,IAAAA,uBAAA,GAAAC,OAAA;AAMkCC,OAAA,CAAAC,cAAA,GAAAH,uBAAA,CAAAG,cAAA;AAAAD,OAAA,CAAAE,sBAAA,GAAAJ,uBAAA,CAAAI,sBAAA;AAAAF,OAAA,CAAAG,mBAAA,GAAAL,uBAAA,CAAAK,mBAAA;AAAAH,OAAA,CAAAI,oBAAA,GAAAN,uBAAA,CAAAM,oBAAA;AAElC,IAAAC,eAAA,GAAAN,OAAA;AAQ0BC,OAAA,CAAAM,uBAAA,GAAAD,eAAA,CAAAC,uBAAA;AAAAN,OAAA,CAAAO,oBAAA,GAAAF,eAAA,CAAAE,oBAAA","ignoreList":[]}

package/dist/cjs/external-types.d.js

@@ -0,0 +1,2 @@
+/// <reference types="@wix/yoshi-flow-library/types" />
+//# sourceMappingURL=external-types.d.js.map

package/dist/cjs/external-types.d.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sources":["../../src/external-types.d.ts"],"sourcesContent":["/// <reference types=\"@wix/yoshi-flow-library/types\" />\n"],"mappings":"AAAA","ignoreList":[]}

package/dist/cjs/featureToggles/FeatureToggleContext.js

@@ -0,0 +1,44 @@
+"use strict";
+
+exports.__esModule = true;
+exports.FeatureToggleProvider = FeatureToggleProvider;
+exports.createFeatureToggleReader = createFeatureToggleReader;
+exports.useFeatureToggle = useFeatureToggle;
+exports.useFeatureToggles = useFeatureToggles;
+var _react = _interopRequireWildcard(require("react"));
+var _jsxFileName = "/home/builduser/work/c2b6ca0b3fa984ee/packages/web5-core/dist/cjs/featureToggles/FeatureToggleContext.tsx";
+function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); }
+function createFeatureToggleReader(featureToggles) {
+  const get = id => featureToggles == null ? void 0 : featureToggles[id];
+  return {
+    isEnabled: id => {
+      const result = get(id);
+      return (result == null ? void 0 : result.status) === 'SUCCESSFUL' && result.enabled === true;
+    },
+    get
+  };
+}
+const defaultReader = createFeatureToggleReader(undefined);
+const FeatureToggleContext = /*#__PURE__*/(0, _react.createContext)(defaultReader);
+function FeatureToggleProvider({
+  featureToggles,
+  children
+}) {
+  const reader = (0, _react.useMemo)(() => createFeatureToggleReader(featureToggles), [featureToggles]);
+  return /*#__PURE__*/_react.default.createElement(FeatureToggleContext.Provider, {
+    value: reader,
+    __self: this,
+    __source: {
+      fileName: _jsxFileName,
+      lineNumber: 54,
+      columnNumber: 5
+    }
+  }, children);
+}
+function useFeatureToggles() {
+  return (0, _react.useContext)(FeatureToggleContext);
+}
+function useFeatureToggle(id) {
+  return useFeatureToggles().isEnabled(id);
+}
+//# sourceMappingURL=FeatureToggleContext.js.map

package/dist/cjs/featureToggles/FeatureToggleContext.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_react","_interopRequireWildcard","require","_jsxFileName","e","t","WeakMap","r","n","__esModule","o","i","f","__proto__","default","has","get","set","hasOwnProperty","call","Object","defineProperty","getOwnPropertyDescriptor","createFeatureToggleReader","featureToggles","id","isEnabled","result","status","enabled","defaultReader","undefined","FeatureToggleContext","createContext","FeatureToggleProvider","children","reader","useMemo","createElement","Provider","value","__self","__source","fileName","lineNumber","columnNumber","useFeatureToggles","useContext","useFeatureToggle"],"sources":["../../../src/featureToggles/FeatureToggleContext.tsx"],"sourcesContent":["import React, {\n  createContext,\n  useContext,\n  useMemo,\n  type ReactNode,\n} from 'react';\n\nexport interface EmbedFeatureToggleResult {\n  id: string;\n  enabled: boolean;\n  status:\n    | 'SUCCESSFUL'\n    | 'MISSING_SEED'\n    | 'DID_NOT_FIND_ELIGIBLE_FILTER'\n    | 'ERROR';\n}\n\nexport interface FeatureToggleReader {\n  isEnabled: (id: string) => boolean;\n  get: (id: string) => EmbedFeatureToggleResult | undefined;\n}\n\nexport function createFeatureToggleReader(\n  featureToggles: Record<string, EmbedFeatureToggleResult> | undefined,\n): FeatureToggleReader {\n  const get = (id: string): EmbedFeatureToggleResult | undefined =>\n    featureToggles?.[id];\n\n  return {\n    isEnabled: (id) => {\n      const result = get(id);\n      return result?.status === 'SUCCESSFUL' && result.enabled === true;\n    },\n    get,\n  };\n}\n\nconst defaultReader = createFeatureToggleReader(undefined);\nconst FeatureToggleContext = createContext<FeatureToggleReader>(defaultReader);\n\nexport function FeatureToggleProvider({\n  featureToggles,\n  children,\n}: {\n  featureToggles: Record<string, EmbedFeatureToggleResult> | undefined;\n  children: ReactNode;\n}) {\n  const reader = useMemo(\n    () => createFeatureToggleReader(featureToggles),\n    [featureToggles],\n  );\n\n  return (\n    <FeatureToggleContext.Provider value={reader}>\n      {children}\n    </FeatureToggleContext.Provider>\n  );\n}\n\nexport function useFeatureToggles(): FeatureToggleReader {\n  return useContext(FeatureToggleContext);\n}\n\nexport function useFeatureToggle(id: string): boolean {\n  return useFeatureToggles().isEnabled(id);\n}\n"],"mappings":";;;;;;;AAAA,IAAAA,MAAA,GAAAC,uBAAA,CAAAC,OAAA;AAKe,IAAAC,YAAA;AAAA,SAAAF,wBAAAG,CAAA,EAAAC,CAAA,6BAAAC,OAAA,MAAAC,CAAA,OAAAD,OAAA,IAAAE,CAAA,OAAAF,OAAA,YAAAL,uBAAA,YAAAA,CAAAG,CAAA,EAAAC,CAAA,SAAAA,CAAA,IAAAD,CAAA,IAAAA,CAAA,CAAAK,UAAA,SAAAL,CAAA,MAAAM,CAAA,EAAAC,CAAA,EAAAC,CAAA,KAAAC,SAAA,QAAAC,OAAA,EAAAV,CAAA,iBAAAA,CAAA,uBAAAA,CAAA,yBAAAA,CAAA,SAAAQ,CAAA,MAAAF,CAAA,GAAAL,CAAA,GAAAG,CAAA,GAAAD,CAAA,QAAAG,CAAA,CAAAK,GAAA,CAAAX,CAAA,UAAAM,CAAA,CAAAM,GAAA,CAAAZ,CAAA,GAAAM,CAAA,CAAAO,GAAA,CAAAb,CAAA,EAAAQ,CAAA,gBAAAP,CAAA,IAAAD,CAAA,gBAAAC,CAAA,OAAAa,cAAA,CAAAC,IAAA,CAAAf,CAAA,EAAAC,CAAA,OAAAM,CAAA,IAAAD,CAAA,GAAAU,MAAA,CAAAC,cAAA,KAAAD,MAAA,CAAAE,wBAAA,CAAAlB,CAAA,EAAAC,CAAA,OAAAM,CAAA,CAAAK,GAAA,IAAAL,CAAA,CAAAM,GAAA,IAAAP,CAAA,CAAAE,CAAA,EAAAP,CAAA,EAAAM,CAAA,IAAAC,CAAA,CAAAP,CAAA,IAAAD,CAAA,CAAAC,CAAA,WAAAO,CAAA,KAAAR,CAAA,EAAAC,CAAA;AAiBR,SAASkB,yBAAyBA,CACvCC,cAAoE,EAC/C;EACrB,MAAMR,GAAG,GAAIS,EAAU,IACrBD,cAAc,oBAAdA,cAAc,CAAGC,EAAE,CAAC;EAEtB,OAAO;IACLC,SAAS,EAAGD,EAAE,IAAK;MACjB,MAAME,MAAM,GAAGX,GAAG,CAACS,EAAE,CAAC;MACtB,OAAO,CAAAE,MAAM,oBAANA,MAAM,CAAEC,MAAM,MAAK,YAAY,IAAID,MAAM,CAACE,OAAO,KAAK,IAAI;IACnE,CAAC;IACDb;EACF,CAAC;AACH;AAEA,MAAMc,aAAa,GAAGP,yBAAyB,CAACQ,SAAS,CAAC;AAC1D,MAAMC,oBAAoB,gBAAG,IAAAC,oBAAa,EAAsBH,aAAa,CAAC;AAEvE,SAASI,qBAAqBA,CAAC;EACpCV,cAAc;EACdW;AAIF,CAAC,EAAE;EACD,MAAMC,MAAM,GAAG,IAAAC,cAAO,EACpB,MAAMd,yBAAyB,CAACC,cAAc,CAAC,EAC/C,CAACA,cAAc,CACjB,CAAC;EAED,oBACExB,MAAA,CAAAc,OAAA,CAAAwB,aAAA,CAACN,oBAAoB,CAACO,QAAQ;IAACC,KAAK,EAAEJ,MAAO;IAAAK,MAAA;IAAAC,QAAA;MAAAC,QAAA,EAAAxC,YAAA;MAAAyC,UAAA;MAAAC,YAAA;IAAA;EAAA,GAC1CV,QAC4B,CAAC;AAEpC;AAEO,SAASW,iBAAiBA,CAAA,EAAwB;EACvD,OAAO,IAAAC,iBAAU,EAACf,oBAAoB,CAAC;AACzC;AAEO,SAASgB,gBAAgBA,CAACvB,EAAU,EAAW;EACpD,OAAOqB,iBAAiB,CAAC,CAAC,CAACpB,SAAS,CAACD,EAAE,CAAC;AAC1C","ignoreList":[]}

package/dist/cjs/hooks/useConversation.js

@@ -0,0 +1,10 @@
+"use strict";
+
+exports.__esModule = true;
+exports.useConversation = useConversation;
+var _ComponentDependenciesContext = require("../context/ComponentDependenciesContext");
+function useConversation() {
+  const deps = (0, _ComponentDependenciesContext.useComponentDependencies)();
+  return deps.useConversation();
+}
+//# sourceMappingURL=useConversation.js.map

package/dist/cjs/hooks/useConversation.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_ComponentDependenciesContext","require","useConversation","deps","useComponentDependencies"],"sources":["../../../src/hooks/useConversation.ts"],"sourcesContent":["import { useComponentDependencies } from '../context/ComponentDependenciesContext';\nimport type { ConversationApi } from '../types/dependencies';\n\nexport function useConversation(): ConversationApi {\n  const deps = useComponentDependencies();\n  return deps.useConversation();\n}\n"],"mappings":";;;;AAAA,IAAAA,6BAAA,GAAAC,OAAA;AAGO,SAASC,eAAeA,CAAA,EAAoB;EACjD,MAAMC,IAAI,GAAG,IAAAC,sDAAwB,EAAC,CAAC;EACvC,OAAOD,IAAI,CAACD,eAAe,CAAC,CAAC;AAC/B","ignoreList":[]}

package/dist/cjs/hooks/useDebugImageContext.js

@@ -0,0 +1,10 @@
+"use strict";
+
+exports.__esModule = true;
+exports.useDebugImageContext = useDebugImageContext;
+var _ComponentDependenciesContext = require("../context/ComponentDependenciesContext");
+function useDebugImageContext() {
+  const deps = (0, _ComponentDependenciesContext.useComponentDependencies)();
+  return deps.useDebugImageContext();
+}
+//# sourceMappingURL=useDebugImageContext.js.map

package/dist/cjs/hooks/useDebugImageContext.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_ComponentDependenciesContext","require","useDebugImageContext","deps","useComponentDependencies"],"sources":["../../../src/hooks/useDebugImageContext.ts"],"sourcesContent":["import { useComponentDependencies } from '../context/ComponentDependenciesContext';\n\nexport function useDebugImageContext(): boolean {\n  const deps = useComponentDependencies();\n  return deps.useDebugImageContext();\n}\n"],"mappings":";;;;AAAA,IAAAA,6BAAA,GAAAC,OAAA;AAEO,SAASC,oBAAoBA,CAAA,EAAY;EAC9C,MAAMC,IAAI,GAAG,IAAAC,sDAAwB,EAAC,CAAC;EACvC,OAAOD,IAAI,CAACD,oBAAoB,CAAC,CAAC;AACpC","ignoreList":[]}

package/dist/cjs/hooks/useEntityTransforms.js

@@ -0,0 +1,10 @@
+"use strict";
+
+exports.__esModule = true;
+exports.useEntityTransforms = useEntityTransforms;
+var _ComponentDependenciesContext = require("../context/ComponentDependenciesContext");
+function useEntityTransforms() {
+  const deps = (0, _ComponentDependenciesContext.useComponentDependencies)();
+  return deps.entityTransforms;
+}
+//# sourceMappingURL=useEntityTransforms.js.map

package/dist/cjs/hooks/useEntityTransforms.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_ComponentDependenciesContext","require","useEntityTransforms","deps","useComponentDependencies","entityTransforms"],"sources":["../../../src/hooks/useEntityTransforms.ts"],"sourcesContent":["import { useComponentDependencies } from '../context/ComponentDependenciesContext';\nimport type { EntityTransforms } from '../types/dependencies';\n\nexport function useEntityTransforms(): EntityTransforms {\n  const deps = useComponentDependencies();\n  return deps.entityTransforms;\n}\n"],"mappings":";;;;AAAA,IAAAA,6BAAA,GAAAC,OAAA;AAGO,SAASC,mBAAmBA,CAAA,EAAqB;EACtD,MAAMC,IAAI,GAAG,IAAAC,sDAAwB,EAAC,CAAC;EACvC,OAAOD,IAAI,CAACE,gBAAgB;AAC9B","ignoreList":[]}

package/dist/cjs/hooks/useMarkdownUtils.js

@@ -0,0 +1,10 @@
+"use strict";
+
+exports.__esModule = true;
+exports.useMarkdownUtils = useMarkdownUtils;
+var _ComponentDependenciesContext = require("../context/ComponentDependenciesContext");
+function useMarkdownUtils() {
+  const deps = (0, _ComponentDependenciesContext.useComponentDependencies)();
+  return deps.markdownUtils;
+}
+//# sourceMappingURL=useMarkdownUtils.js.map

package/dist/cjs/hooks/useMarkdownUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_ComponentDependenciesContext","require","useMarkdownUtils","deps","useComponentDependencies","markdownUtils"],"sources":["../../../src/hooks/useMarkdownUtils.ts"],"sourcesContent":["import { useComponentDependencies } from '../context/ComponentDependenciesContext';\nimport type { MarkdownUtils } from '../types/dependencies';\n\nexport function useMarkdownUtils(): MarkdownUtils {\n  const deps = useComponentDependencies();\n  return deps.markdownUtils;\n}\n"],"mappings":";;;;AAAA,IAAAA,6BAAA,GAAAC,OAAA;AAGO,SAASC,gBAAgBA,CAAA,EAAkB;EAChD,MAAMC,IAAI,GAAG,IAAAC,sDAAwB,EAAC,CAAC;EACvC,OAAOD,IAAI,CAACE,aAAa;AAC3B","ignoreList":[]}

package/dist/cjs/hooks/useResolveGenericEntityData.js

@@ -0,0 +1,10 @@
+"use strict";
+
+exports.__esModule = true;
+exports.useResolveGenericEntityData = useResolveGenericEntityData;
+var _ComponentDependenciesContext = require("../context/ComponentDependenciesContext");
+function useResolveGenericEntityData(entities, options) {
+  const deps = (0, _ComponentDependenciesContext.useComponentDependencies)();
+  return deps.useResolveGenericEntityData(entities, options);
+}
+//# sourceMappingURL=useResolveGenericEntityData.js.map

package/dist/cjs/hooks/useResolveGenericEntityData.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_ComponentDependenciesContext","require","useResolveGenericEntityData","entities","options","deps","useComponentDependencies"],"sources":["../../../src/hooks/useResolveGenericEntityData.ts"],"sourcesContent":["import { useComponentDependencies } from '../context/ComponentDependenciesContext';\nimport type { ResolveGenericEntityDataOptions } from '../types/dependencies';\n\nexport function useResolveGenericEntityData<\n  TEntity extends {\n    entityId: string;\n    entityUrl: string;\n    entityType: string;\n    data?: TEntityData;\n  },\n  TEntityData,\n>(\n  entities: TEntity[],\n  options: ResolveGenericEntityDataOptions<TEntityData>,\n): { enrichedEntities: TEntity[]; loading: boolean } {\n  const deps = useComponentDependencies();\n  return deps.useResolveGenericEntityData(entities, options);\n}\n"],"mappings":";;;;AAAA,IAAAA,6BAAA,GAAAC,OAAA;AAGO,SAASC,2BAA2BA,CASzCC,QAAmB,EACnBC,OAAqD,EACF;EACnD,MAAMC,IAAI,GAAG,IAAAC,sDAAwB,EAAC,CAAC;EACvC,OAAOD,IAAI,CAACH,2BAA2B,CAACC,QAAQ,EAAEC,OAAO,CAAC;AAC5D","ignoreList":[]}

package/dist/cjs/hooks/useResolveSearchSpringEntityData.js

@@ -0,0 +1,146 @@
+"use strict";
+
+exports.__esModule = true;
+exports.mergeSearchSpringEntityData = mergeSearchSpringEntityData;
+exports.useResolveSearchSpringEntityData = useResolveSearchSpringEntityData;
+var _react = require("react");
+var _searchSpringClient = require("../services/searchspring/searchSpringClient");
+var _transformSSProduct = require("../services/searchspring/transformSSProduct");
+// Session-level cache: handle → resolved EntityItemData
+const ssEntityCache = new Map();
+function extractProductHandle(url) {
+  const trimmed = url == null ? void 0 : url.trim();
+  if (!trimmed) {
+    return undefined;
+  }
+  let pathname = trimmed;
+  try {
+    if (/^https?:\/\//i.test(trimmed)) {
+      pathname = new URL(trimmed).pathname;
+    }
+  } catch {
+    pathname = trimmed;
+  }
+  const withoutQuery = pathname.split(/[?#]/)[0];
+  const withoutLeadingSlash = withoutQuery.replace(/^\/+/, '');
+  const productsIndex = withoutLeadingSlash.indexOf('products/');
+  const handle = productsIndex >= 0 ? withoutLeadingSlash.slice(productsIndex + 'products/'.length) : withoutLeadingSlash;
+  return handle || undefined;
+}
+function getSearchSpringHandle(entity) {
+  var _entity$data;
+  return extractProductHandle((_entity$data = entity.data) == null ? void 0 : _entity$data.url) || entity.entityId;
+}
+function mergeSearchSpringEntityData(existing, resolved) {
+  var _existing$sizes, _existing$variants, _existing$options, _existing$allImages;
+  if (!existing) {
+    return resolved;
+  }
+  return {
+    ...existing,
+    ...resolved,
+    url: existing.url || resolved.url,
+    sizes: (_existing$sizes = existing.sizes) != null && _existing$sizes.length ? existing.sizes : resolved.sizes,
+    variants: (_existing$variants = existing.variants) != null && _existing$variants.length ? existing.variants : resolved.variants,
+    options: (_existing$options = existing.options) != null && _existing$options.length ? existing.options : resolved.options,
+    allImages: (_existing$allImages = existing.allImages) != null && _existing$allImages.length ? existing.allImages : resolved.allImages
+  };
+}
+
+/**
+ * SearchSpring-backed entity resolution hook.
+ *
+ * Fetches product data from the SearchSpring Search API by handle
+ * and transforms it to EntityItemData. Uses a single batched API call
+ * for all products (bgfilter.handle supports OR).
+ */
+function useResolveSearchSpringEntityData(entities, config) {
+  const [resolvedMap, setResolvedMap] = (0, _react.useState)(new Map());
+  const [settled, setSettled] = (0, _react.useState)(false);
+
+  // Stable key for dependency tracking
+  const entityKey = (0, _react.useMemo)(() => entities.map(e => `${e.entityType}:${e.entityId}:${getSearchSpringHandle(e)}`).join(','), [entities]);
+  (0, _react.useEffect)(() => {
+    let ignore = false;
+    if (!entities.length || !config.siteId) {
+      setSettled(true);
+      return;
+    }
+    const productEntityHandles = entities.filter(e => e.entityType.toLowerCase().includes('product')).map(entity => ({
+      entity,
+      handle: getSearchSpringHandle(entity)
+    }));
+
+    // Collect handles that need fetching. CMS payload IDs use payload url as the handle.
+    const handlesToFetch = [...new Set(productEntityHandles.map(({
+      handle
+    }) => handle).filter(handle => !ssEntityCache.has(handle)))];
+
+    // If everything is cached, resolve immediately
+    if (handlesToFetch.length === 0) {
+      const cached = new Map();
+      productEntityHandles.forEach(({
+        entity,
+        handle
+      }) => {
+        const item = ssEntityCache.get(handle);
+        if (item) {
+          cached.set(entity.entityId, item);
+        }
+      });
+      setResolvedMap(cached);
+      setSettled(true);
+      return;
+    }
+    setSettled(false);
+    const fetchAll = async () => {
+      const productMap = await (0, _searchSpringClient.fetchProductsByHandlesMap)(config.siteId, handlesToFetch);
+
+      // Transform and cache
+      for (const [handle, product] of productMap) {
+        const itemData = (0, _transformSSProduct.transformSSProductToEntityItemData)(product);
+        ssEntityCache.set(handle, itemData);
+      }
+      if (ignore) {
+        return;
+      }
+
+      // Build the final map
+      const finalMap = new Map();
+      productEntityHandles.forEach(({
+        entity,
+        handle
+      }) => {
+        const item = ssEntityCache.get(handle);
+        if (item) {
+          finalMap.set(entity.entityId, item);
+        }
+      });
+      setResolvedMap(finalMap);
+      setSettled(true);
+    };
+    fetchAll();
+    return () => {
+      ignore = true;
+    };
+  }, [entityKey, config.siteId]);
+
+  // Merge resolved data into entities
+  const enrichedEntities = (0, _react.useMemo)(() => {
+    return entities.map(entity => {
+      const resolved = resolvedMap.get(entity.entityId);
+      if (resolved) {
+        return {
+          ...entity,
+          data: mergeSearchSpringEntityData(entity.data, resolved)
+        };
+      }
+      return entity;
+    });
+  }, [entities, resolvedMap]);
+  return {
+    enrichedEntities,
+    loading: !settled
+  };
+}
+//# sourceMappingURL=useResolveSearchSpringEntityData.js.map