@fluid-app/portal-core 0.1.18 → 0.1.20

package/dist/data-sources/transformers.cjs

@@ -83,16 +83,18 @@ const toVideoPropsFromShareable = (data) => {
 */
 const toShareableProps = (data, source) => {
 	if (!Array.isArray(data)) return [];
+	const sourceTypeHint = source?.type === "api" ? source.variables?.shareable_type : void 0;
 	return data.map((item) => {
 		const d = item;
 		const widgetConfig = extractCustomWidgetConfig(d, source);
+		const shareableType = d.type ?? d.relateable_type ?? d.shareable_type ?? d.shareableType ?? sourceTypeHint ?? "";
 		return {
 			id: d.id,
 			title: d.title ?? d.name ?? "",
 			description: extractDescription(d),
 			imageUrl: extractImageUrl(d),
 			videoUrl: (d.video_url ?? d.videoUrl) || null,
-			shareableType: d.type ?? d.relateable_type ?? d.shareableType ?? "",
+			shareableType,
 			kind: d.kind ?? "image",
 			status: d.status ?? "active",
 			wholesalePrice: d.display_wholesale_price ?? d.wholesale_price ?? null,

package/dist/data-sources/transformers.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"transformers.cjs","names":[],"sources":["../../src/data-sources/transformers.ts"],"sourcesContent":["/**\n * Widget Transformers\n *\n * Transform functions that map API response data to widget-specific prop shapes.\n * Each widget has one transformer that handles all data structure variants:\n * - Standard: Direct field name match\n * - Legacy: Different field names that need mapping\n * - Minimal: Bare minimum fields that need defaults\n *\n * Usage:\n * 1. Transformers are registered in the DataSourceRegistry\n * 2. Reference by name in ApiDataSource.transform\n * 3. Applied after resultPath extraction, before targetProps assignment\n */\n\nimport type { DataTransformer, DataSource } from \"./types\";\n\n/**\n * Helper to extract image URL from various API response structures.\n * Handles:\n * - Flat fields (Medium, Page, Product): image_url, imageUrl, thumbnail_url, src\n * - Nested images array (EnrollmentPack): images[0].image_url\n * - Nested library_items (Library): library_items[0].relateable.image_url\n */\nfunction extractImageUrl(d: Record<string, unknown>): string {\n  // Try flat fields first (Medium, Page, Product)\n  if (d.image_url) return d.image_url as string;\n  if (d.imageUrl) return d.imageUrl as string;\n  if (d.thumbnail_url) return d.thumbnail_url as string;\n  if (d.src) return d.src as string;\n\n  // Try nested images array (EnrollmentPack)\n  const images = d.images as Array<Record<string, unknown>> | undefined;\n  if (images && images.length > 0) {\n    const firstImage = images[0];\n    if (firstImage?.image_url) return firstImage.image_url as string;\n    if (firstImage?.url) return firstImage.url as string;\n  }\n\n  // Try nested library_items (Library/Playlist)\n  const libraryItems = d.library_items as\n    | Array<Record<string, unknown>>\n    | undefined;\n  if (libraryItems && libraryItems.length > 0) {\n    const firstItem = libraryItems[0];\n    const relateable = firstItem?.relateable as\n      | Record<string, unknown>\n      | undefined;\n    if (relateable?.image_url) return relateable.image_url as string;\n    if (relateable?.imageUrl) return relateable.imageUrl as string;\n    if (relateable?.thumbnail_url) return relateable.thumbnail_url as string;\n  }\n\n  return \"\";\n}\n\n/**\n * Helper to extract description from various API response structures.\n * Handles different field names across endpoints.\n */\nfunction extractDescription(d: Record<string, unknown>): string {\n  // Try various description field names\n  const desc =\n    d.description ?? d.stripped ?? d.stripped_description ?? d.body ?? \"\";\n\n  // Handle nested description object (some APIs return { body: \"...\" })\n  if (typeof desc === \"object\" && desc !== null && \"body\" in desc) {\n    return ((desc as Record<string, unknown>).body as string) ?? \"\";\n  }\n\n  return desc as string;\n}\n\n/**\n * Helper to extract custom widget config from a selected item.\n */\nfunction extractCustomWidgetConfig(\n  d: Record<string, unknown>,\n  source: DataSource | undefined,\n): Record<string, unknown> {\n  if (source === undefined || source.type !== \"custom\") return {};\n\n  const selectedItem = source.selectedItems.find(\n    (s) => String(s.id) === String(d.id),\n  );\n  return selectedItem?.widgetConfig ?? {};\n}\n\n/**\n * ImageWidget transformer from shareable data\n */\nconst toImagePropsFromShareable: DataTransformer = (data) => {\n  const item = Array.isArray(data) ? data[0] : data;\n  if (!item || typeof item !== \"object\") {\n    return { src: \"\", alt: \"Image\", objectFit: \"cover\" };\n  }\n\n  const d = item as Record<string, unknown>;\n  return {\n    src: extractImageUrl(d),\n    alt: (d.title ?? d.name ?? d.alt ?? \"Image\") as string,\n    objectFit: \"cover\" as const,\n  };\n};\n\n/**\n * VideoWidget transformer from shareable data\n */\nconst toVideoPropsFromShareable: DataTransformer = (data) => {\n  const item = Array.isArray(data) ? data[0] : data;\n  if (!item || typeof item !== \"object\") {\n    return { src: \"\", poster: \"\", caption: \"\" };\n  }\n\n  const d = item as Record<string, unknown>;\n  return {\n    src: ((d.video_url ?? d.videoUrl ?? d.src) as string) || \"\",\n    poster: extractImageUrl(d),\n    caption: (d.title ?? d.name ?? d.caption ?? \"\") as string,\n  };\n};\n\n/**\n * Shareable content transformer\n * Normalizes shareable API responses to a consistent format\n */\nconst toShareableProps: DataTransformer = (data, source) => {\n  if (!Array.isArray(data)) return [];\n\n  return data.map((item: unknown) => {\n    const d = item as Record<string, unknown>;\n\n    const widgetConfig = extractCustomWidgetConfig(d, source);\n\n    return {\n      id: d.id,\n      title: (d.title ?? d.name ?? \"\") as string,\n      description: extractDescription(d),\n      imageUrl: extractImageUrl(d),\n      videoUrl: ((d.video_url ?? d.videoUrl) as string) || null,\n      shareableType: (d.type ??\n        d.relateable_type ??\n        d.shareableType ??\n        \"\") as string,\n      kind: (d.kind ?? \"image\") as string,\n      status: (d.status ?? \"active\") as string,\n      wholesalePrice: d.display_wholesale_price ?? d.wholesale_price ?? null,\n      subscriptionPrice: d.subscription_price ?? null,\n      outOfStock: d.out_of_stock ?? false,\n      lowInStock: d.low_in_stock ?? false,\n      ...d,\n      ...widgetConfig,\n    };\n  });\n};\n\n/**\n * Carousel slides from shareables transformer\n */\nconst toCarouselSlidesFromShareables: DataTransformer = (data, source) => {\n  if (!Array.isArray(data)) return [];\n\n  return data.map((item: unknown, index: number) => {\n    const d = item as Record<string, unknown>;\n\n    const widgetConfig = extractCustomWidgetConfig(d, source);\n\n    const imageUrl = extractImageUrl(d);\n    const isVideo = d.kind === \"video\" || d.videoUrl || d.video_url;\n    const title = (d.title ?? d.name ?? \"\") as string;\n\n    const content = isVideo\n      ? {\n          type: \"VideoWidget\",\n          props: {\n            src: ((d.videoUrl ?? d.video_url) as string) || \"\",\n            poster: imageUrl,\n            caption: title,\n          },\n        }\n      : {\n          type: \"ImageWidget\",\n          props: {\n            src: imageUrl,\n            alt: title || \"Slide image\",\n            objectFit: \"cover\",\n          },\n        };\n\n    const baseSlide = {\n      id: String(d.id ?? `slide-${index}`),\n      content,\n      title,\n      description: extractDescription(d),\n    };\n\n    return {\n      ...baseSlide,\n      ...widgetConfig,\n    };\n  });\n};\n\n/**\n * All widget transformers bundled for registration\n */\nexport const WIDGET_TRANSFORMERS: Record<string, DataTransformer> = {\n  toShareableProps,\n  toCarouselSlidesFromShareables,\n  toImagePropsFromShareable,\n  toVideoPropsFromShareable,\n};\n"],"mappings":"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"}
+{"version":3,"file":"transformers.cjs","names":[],"sources":["../../src/data-sources/transformers.ts"],"sourcesContent":["/**\n * Widget Transformers\n *\n * Transform functions that map API response data to widget-specific prop shapes.\n * Each widget has one transformer that handles all data structure variants:\n * - Standard: Direct field name match\n * - Legacy: Different field names that need mapping\n * - Minimal: Bare minimum fields that need defaults\n *\n * Usage:\n * 1. Transformers are registered in the DataSourceRegistry\n * 2. Reference by name in ApiDataSource.transform\n * 3. Applied after resultPath extraction, before targetProps assignment\n */\n\nimport type { DataTransformer, DataSource } from \"./types\";\n\n/**\n * Helper to extract image URL from various API response structures.\n * Handles:\n * - Flat fields (Medium, Page, Product): image_url, imageUrl, thumbnail_url, src\n * - Nested images array (EnrollmentPack): images[0].image_url\n * - Nested library_items (Library): library_items[0].relateable.image_url\n */\nfunction extractImageUrl(d: Record<string, unknown>): string {\n  // Try flat fields first (Medium, Page, Product)\n  if (d.image_url) return d.image_url as string;\n  if (d.imageUrl) return d.imageUrl as string;\n  if (d.thumbnail_url) return d.thumbnail_url as string;\n  if (d.src) return d.src as string;\n\n  // Try nested images array (EnrollmentPack)\n  const images = d.images as Array<Record<string, unknown>> | undefined;\n  if (images && images.length > 0) {\n    const firstImage = images[0];\n    if (firstImage?.image_url) return firstImage.image_url as string;\n    if (firstImage?.url) return firstImage.url as string;\n  }\n\n  // Try nested library_items (Library/Playlist)\n  const libraryItems = d.library_items as\n    | Array<Record<string, unknown>>\n    | undefined;\n  if (libraryItems && libraryItems.length > 0) {\n    const firstItem = libraryItems[0];\n    const relateable = firstItem?.relateable as\n      | Record<string, unknown>\n      | undefined;\n    if (relateable?.image_url) return relateable.image_url as string;\n    if (relateable?.imageUrl) return relateable.imageUrl as string;\n    if (relateable?.thumbnail_url) return relateable.thumbnail_url as string;\n  }\n\n  return \"\";\n}\n\n/**\n * Helper to extract description from various API response structures.\n * Handles different field names across endpoints.\n */\nfunction extractDescription(d: Record<string, unknown>): string {\n  // Try various description field names\n  const desc =\n    d.description ?? d.stripped ?? d.stripped_description ?? d.body ?? \"\";\n\n  // Handle nested description object (some APIs return { body: \"...\" })\n  if (typeof desc === \"object\" && desc !== null && \"body\" in desc) {\n    return ((desc as Record<string, unknown>).body as string) ?? \"\";\n  }\n\n  return desc as string;\n}\n\n/**\n * Helper to extract custom widget config from a selected item.\n */\nfunction extractCustomWidgetConfig(\n  d: Record<string, unknown>,\n  source: DataSource | undefined,\n): Record<string, unknown> {\n  if (source === undefined || source.type !== \"custom\") return {};\n\n  const selectedItem = source.selectedItems.find(\n    (s) => String(s.id) === String(d.id),\n  );\n  return selectedItem?.widgetConfig ?? {};\n}\n\n/**\n * ImageWidget transformer from shareable data\n */\nconst toImagePropsFromShareable: DataTransformer = (data) => {\n  const item = Array.isArray(data) ? data[0] : data;\n  if (!item || typeof item !== \"object\") {\n    return { src: \"\", alt: \"Image\", objectFit: \"cover\" };\n  }\n\n  const d = item as Record<string, unknown>;\n  return {\n    src: extractImageUrl(d),\n    alt: (d.title ?? d.name ?? d.alt ?? \"Image\") as string,\n    objectFit: \"cover\" as const,\n  };\n};\n\n/**\n * VideoWidget transformer from shareable data\n */\nconst toVideoPropsFromShareable: DataTransformer = (data) => {\n  const item = Array.isArray(data) ? data[0] : data;\n  if (!item || typeof item !== \"object\") {\n    return { src: \"\", poster: \"\", caption: \"\" };\n  }\n\n  const d = item as Record<string, unknown>;\n  return {\n    src: ((d.video_url ?? d.videoUrl ?? d.src) as string) || \"\",\n    poster: extractImageUrl(d),\n    caption: (d.title ?? d.name ?? d.caption ?? \"\") as string,\n  };\n};\n\n/**\n * Shareable content transformer\n * Normalizes shareable API responses to a consistent format\n */\nconst toShareableProps: DataTransformer = (data, source) => {\n  if (!Array.isArray(data)) return [];\n\n  // Derive a fallback shareable type from the data source configuration.\n  // API presets pass shareable_type in their variables (e.g., \"products\").\n  // Custom sources store it per-item (handled below).\n  const sourceTypeHint =\n    source?.type === \"api\" ? source.variables?.shareable_type : undefined;\n\n  return data.map((item: unknown) => {\n    const d = item as Record<string, unknown>;\n\n    const widgetConfig = extractCustomWidgetConfig(d, source);\n\n    // Resolve shareable type from the item itself, then fall back to source hint\n    const shareableType = (d.type ??\n      d.relateable_type ??\n      d.shareable_type ??\n      d.shareableType ??\n      sourceTypeHint ??\n      \"\") as string;\n\n    return {\n      id: d.id,\n      title: (d.title ?? d.name ?? \"\") as string,\n      description: extractDescription(d),\n      imageUrl: extractImageUrl(d),\n      videoUrl: ((d.video_url ?? d.videoUrl) as string) || null,\n      shareableType,\n      kind: (d.kind ?? \"image\") as string,\n      status: (d.status ?? \"active\") as string,\n      wholesalePrice: d.display_wholesale_price ?? d.wholesale_price ?? null,\n      subscriptionPrice: d.subscription_price ?? null,\n      outOfStock: d.out_of_stock ?? false,\n      lowInStock: d.low_in_stock ?? false,\n      ...d,\n      ...widgetConfig,\n    };\n  });\n};\n\n/**\n * Carousel slides from shareables transformer\n */\nconst toCarouselSlidesFromShareables: DataTransformer = (data, source) => {\n  if (!Array.isArray(data)) return [];\n\n  return data.map((item: unknown, index: number) => {\n    const d = item as Record<string, unknown>;\n\n    const widgetConfig = extractCustomWidgetConfig(d, source);\n\n    const imageUrl = extractImageUrl(d);\n    const isVideo = d.kind === \"video\" || d.videoUrl || d.video_url;\n    const title = (d.title ?? d.name ?? \"\") as string;\n\n    const content = isVideo\n      ? {\n          type: \"VideoWidget\",\n          props: {\n            src: ((d.videoUrl ?? d.video_url) as string) || \"\",\n            poster: imageUrl,\n            caption: title,\n          },\n        }\n      : {\n          type: \"ImageWidget\",\n          props: {\n            src: imageUrl,\n            alt: title || \"Slide image\",\n            objectFit: \"cover\",\n          },\n        };\n\n    const baseSlide = {\n      id: String(d.id ?? `slide-${index}`),\n      content,\n      title,\n      description: extractDescription(d),\n    };\n\n    return {\n      ...baseSlide,\n      ...widgetConfig,\n    };\n  });\n};\n\n/**\n * All widget transformers bundled for registration\n */\nexport const WIDGET_TRANSFORMERS: Record<string, DataTransformer> = {\n  toShareableProps,\n  toCarouselSlidesFromShareables,\n  toImagePropsFromShareable,\n  toVideoPropsFromShareable,\n};\n"],"mappings":"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"}

package/dist/data-sources/transformers.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"transformers.d.cts","names":[],"sources":["../../src/data-sources/transformers.ts"],"mappings":";;;;;;cA8Ma,mBAAA,EAAqB,MAAA,SAAe,eAAA"}
+{"version":3,"file":"transformers.d.cts","names":[],"sources":["../../src/data-sources/transformers.ts"],"mappings":";;;;;;cAyNa,mBAAA,EAAqB,MAAA,SAAe,eAAA"}

package/dist/data-sources/transformers.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"transformers.d.mts","names":[],"sources":["../../src/data-sources/transformers.ts"],"mappings":";;;;;;cA8Ma,mBAAA,EAAqB,MAAA,SAAe,eAAA"}
+{"version":3,"file":"transformers.d.mts","names":[],"sources":["../../src/data-sources/transformers.ts"],"mappings":";;;;;;cAyNa,mBAAA,EAAqB,MAAA,SAAe,eAAA"}

package/dist/data-sources/transformers.mjs

@@ -82,16 +82,18 @@ const toVideoPropsFromShareable = (data) => {
 */
 const toShareableProps = (data, source) => {
 	if (!Array.isArray(data)) return [];
+	const sourceTypeHint = source?.type === "api" ? source.variables?.shareable_type : void 0;
 	return data.map((item) => {
 		const d = item;
 		const widgetConfig = extractCustomWidgetConfig(d, source);
+		const shareableType = d.type ?? d.relateable_type ?? d.shareable_type ?? d.shareableType ?? sourceTypeHint ?? "";
 		return {
 			id: d.id,
 			title: d.title ?? d.name ?? "",
 			description: extractDescription(d),
 			imageUrl: extractImageUrl(d),
 			videoUrl: (d.video_url ?? d.videoUrl) || null,
-			shareableType: d.type ?? d.relateable_type ?? d.shareableType ?? "",
+			shareableType,
 			kind: d.kind ?? "image",
 			status: d.status ?? "active",
 			wholesalePrice: d.display_wholesale_price ?? d.wholesale_price ?? null,

package/dist/data-sources/transformers.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"transformers.mjs","names":[],"sources":["../../src/data-sources/transformers.ts"],"sourcesContent":["/**\n * Widget Transformers\n *\n * Transform functions that map API response data to widget-specific prop shapes.\n * Each widget has one transformer that handles all data structure variants:\n * - Standard: Direct field name match\n * - Legacy: Different field names that need mapping\n * - Minimal: Bare minimum fields that need defaults\n *\n * Usage:\n * 1. Transformers are registered in the DataSourceRegistry\n * 2. Reference by name in ApiDataSource.transform\n * 3. Applied after resultPath extraction, before targetProps assignment\n */\n\nimport type { DataTransformer, DataSource } from \"./types\";\n\n/**\n * Helper to extract image URL from various API response structures.\n * Handles:\n * - Flat fields (Medium, Page, Product): image_url, imageUrl, thumbnail_url, src\n * - Nested images array (EnrollmentPack): images[0].image_url\n * - Nested library_items (Library): library_items[0].relateable.image_url\n */\nfunction extractImageUrl(d: Record<string, unknown>): string {\n  // Try flat fields first (Medium, Page, Product)\n  if (d.image_url) return d.image_url as string;\n  if (d.imageUrl) return d.imageUrl as string;\n  if (d.thumbnail_url) return d.thumbnail_url as string;\n  if (d.src) return d.src as string;\n\n  // Try nested images array (EnrollmentPack)\n  const images = d.images as Array<Record<string, unknown>> | undefined;\n  if (images && images.length > 0) {\n    const firstImage = images[0];\n    if (firstImage?.image_url) return firstImage.image_url as string;\n    if (firstImage?.url) return firstImage.url as string;\n  }\n\n  // Try nested library_items (Library/Playlist)\n  const libraryItems = d.library_items as\n    | Array<Record<string, unknown>>\n    | undefined;\n  if (libraryItems && libraryItems.length > 0) {\n    const firstItem = libraryItems[0];\n    const relateable = firstItem?.relateable as\n      | Record<string, unknown>\n      | undefined;\n    if (relateable?.image_url) return relateable.image_url as string;\n    if (relateable?.imageUrl) return relateable.imageUrl as string;\n    if (relateable?.thumbnail_url) return relateable.thumbnail_url as string;\n  }\n\n  return \"\";\n}\n\n/**\n * Helper to extract description from various API response structures.\n * Handles different field names across endpoints.\n */\nfunction extractDescription(d: Record<string, unknown>): string {\n  // Try various description field names\n  const desc =\n    d.description ?? d.stripped ?? d.stripped_description ?? d.body ?? \"\";\n\n  // Handle nested description object (some APIs return { body: \"...\" })\n  if (typeof desc === \"object\" && desc !== null && \"body\" in desc) {\n    return ((desc as Record<string, unknown>).body as string) ?? \"\";\n  }\n\n  return desc as string;\n}\n\n/**\n * Helper to extract custom widget config from a selected item.\n */\nfunction extractCustomWidgetConfig(\n  d: Record<string, unknown>,\n  source: DataSource | undefined,\n): Record<string, unknown> {\n  if (source === undefined || source.type !== \"custom\") return {};\n\n  const selectedItem = source.selectedItems.find(\n    (s) => String(s.id) === String(d.id),\n  );\n  return selectedItem?.widgetConfig ?? {};\n}\n\n/**\n * ImageWidget transformer from shareable data\n */\nconst toImagePropsFromShareable: DataTransformer = (data) => {\n  const item = Array.isArray(data) ? data[0] : data;\n  if (!item || typeof item !== \"object\") {\n    return { src: \"\", alt: \"Image\", objectFit: \"cover\" };\n  }\n\n  const d = item as Record<string, unknown>;\n  return {\n    src: extractImageUrl(d),\n    alt: (d.title ?? d.name ?? d.alt ?? \"Image\") as string,\n    objectFit: \"cover\" as const,\n  };\n};\n\n/**\n * VideoWidget transformer from shareable data\n */\nconst toVideoPropsFromShareable: DataTransformer = (data) => {\n  const item = Array.isArray(data) ? data[0] : data;\n  if (!item || typeof item !== \"object\") {\n    return { src: \"\", poster: \"\", caption: \"\" };\n  }\n\n  const d = item as Record<string, unknown>;\n  return {\n    src: ((d.video_url ?? d.videoUrl ?? d.src) as string) || \"\",\n    poster: extractImageUrl(d),\n    caption: (d.title ?? d.name ?? d.caption ?? \"\") as string,\n  };\n};\n\n/**\n * Shareable content transformer\n * Normalizes shareable API responses to a consistent format\n */\nconst toShareableProps: DataTransformer = (data, source) => {\n  if (!Array.isArray(data)) return [];\n\n  return data.map((item: unknown) => {\n    const d = item as Record<string, unknown>;\n\n    const widgetConfig = extractCustomWidgetConfig(d, source);\n\n    return {\n      id: d.id,\n      title: (d.title ?? d.name ?? \"\") as string,\n      description: extractDescription(d),\n      imageUrl: extractImageUrl(d),\n      videoUrl: ((d.video_url ?? d.videoUrl) as string) || null,\n      shareableType: (d.type ??\n        d.relateable_type ??\n        d.shareableType ??\n        \"\") as string,\n      kind: (d.kind ?? \"image\") as string,\n      status: (d.status ?? \"active\") as string,\n      wholesalePrice: d.display_wholesale_price ?? d.wholesale_price ?? null,\n      subscriptionPrice: d.subscription_price ?? null,\n      outOfStock: d.out_of_stock ?? false,\n      lowInStock: d.low_in_stock ?? false,\n      ...d,\n      ...widgetConfig,\n    };\n  });\n};\n\n/**\n * Carousel slides from shareables transformer\n */\nconst toCarouselSlidesFromShareables: DataTransformer = (data, source) => {\n  if (!Array.isArray(data)) return [];\n\n  return data.map((item: unknown, index: number) => {\n    const d = item as Record<string, unknown>;\n\n    const widgetConfig = extractCustomWidgetConfig(d, source);\n\n    const imageUrl = extractImageUrl(d);\n    const isVideo = d.kind === \"video\" || d.videoUrl || d.video_url;\n    const title = (d.title ?? d.name ?? \"\") as string;\n\n    const content = isVideo\n      ? {\n          type: \"VideoWidget\",\n          props: {\n            src: ((d.videoUrl ?? d.video_url) as string) || \"\",\n            poster: imageUrl,\n            caption: title,\n          },\n        }\n      : {\n          type: \"ImageWidget\",\n          props: {\n            src: imageUrl,\n            alt: title || \"Slide image\",\n            objectFit: \"cover\",\n          },\n        };\n\n    const baseSlide = {\n      id: String(d.id ?? `slide-${index}`),\n      content,\n      title,\n      description: extractDescription(d),\n    };\n\n    return {\n      ...baseSlide,\n      ...widgetConfig,\n    };\n  });\n};\n\n/**\n * All widget transformers bundled for registration\n */\nexport const WIDGET_TRANSFORMERS: Record<string, DataTransformer> = {\n  toShareableProps,\n  toCarouselSlidesFromShareables,\n  toImagePropsFromShareable,\n  toVideoPropsFromShareable,\n};\n"],"mappings":";;;;;;;;AAwBA,SAAS,gBAAgB,GAAoC;AAE3D,KAAI,EAAE,UAAW,QAAO,EAAE;AAC1B,KAAI,EAAE,SAAU,QAAO,EAAE;AACzB,KAAI,EAAE,cAAe,QAAO,EAAE;AAC9B,KAAI,EAAE,IAAK,QAAO,EAAE;CAGpB,MAAM,SAAS,EAAE;AACjB,KAAI,UAAU,OAAO,SAAS,GAAG;EAC/B,MAAM,aAAa,OAAO;AAC1B,MAAI,YAAY,UAAW,QAAO,WAAW;AAC7C,MAAI,YAAY,IAAK,QAAO,WAAW;;CAIzC,MAAM,eAAe,EAAE;AAGvB,KAAI,gBAAgB,aAAa,SAAS,GAAG;EAE3C,MAAM,aADY,aAAa,IACD;AAG9B,MAAI,YAAY,UAAW,QAAO,WAAW;AAC7C,MAAI,YAAY,SAAU,QAAO,WAAW;AAC5C,MAAI,YAAY,cAAe,QAAO,WAAW;;AAGnD,QAAO;;;;;;AAOT,SAAS,mBAAmB,GAAoC;CAE9D,MAAM,OACJ,EAAE,eAAe,EAAE,YAAY,EAAE,wBAAwB,EAAE,QAAQ;AAGrE,KAAI,OAAO,SAAS,YAAY,SAAS,QAAQ,UAAU,KACzD,QAAS,KAAiC,QAAmB;AAG/D,QAAO;;;;;AAMT,SAAS,0BACP,GACA,QACyB;AACzB,KAAI,WAAW,KAAA,KAAa,OAAO,SAAS,SAAU,QAAO,EAAE;AAK/D,QAHqB,OAAO,cAAc,MACvC,MAAM,OAAO,EAAE,GAAG,KAAK,OAAO,EAAE,GAAG,CACrC,EACoB,gBAAgB,EAAE;;;;;AAMzC,MAAM,6BAA8C,SAAS;CAC3D,MAAM,OAAO,MAAM,QAAQ,KAAK,GAAG,KAAK,KAAK;AAC7C,KAAI,CAAC,QAAQ,OAAO,SAAS,SAC3B,QAAO;EAAE,KAAK;EAAI,KAAK;EAAS,WAAW;EAAS;CAGtD,MAAM,IAAI;AACV,QAAO;EACL,KAAK,gBAAgB,EAAE;EACvB,KAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO;EACpC,WAAW;EACZ;;;;;AAMH,MAAM,6BAA8C,SAAS;CAC3D,MAAM,OAAO,MAAM,QAAQ,KAAK,GAAG,KAAK,KAAK;AAC7C,KAAI,CAAC,QAAQ,OAAO,SAAS,SAC3B,QAAO;EAAE,KAAK;EAAI,QAAQ;EAAI,SAAS;EAAI;CAG7C,MAAM,IAAI;AACV,QAAO;EACL,MAAO,EAAE,aAAa,EAAE,YAAY,EAAE,QAAmB;EACzD,QAAQ,gBAAgB,EAAE;EAC1B,SAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW;EAC7C;;;;;;AAOH,MAAM,oBAAqC,MAAM,WAAW;AAC1D,KAAI,CAAC,MAAM,QAAQ,KAAK,CAAE,QAAO,EAAE;AAEnC,QAAO,KAAK,KAAK,SAAkB;EACjC,MAAM,IAAI;EAEV,MAAM,eAAe,0BAA0B,GAAG,OAAO;AAEzD,SAAO;GACL,IAAI,EAAE;GACN,OAAQ,EAAE,SAAS,EAAE,QAAQ;GAC7B,aAAa,mBAAmB,EAAE;GAClC,UAAU,gBAAgB,EAAE;GAC5B,WAAY,EAAE,aAAa,EAAE,aAAwB;GACrD,eAAgB,EAAE,QAChB,EAAE,mBACF,EAAE,iBACF;GACF,MAAO,EAAE,QAAQ;GACjB,QAAS,EAAE,UAAU;GACrB,gBAAgB,EAAE,2BAA2B,EAAE,mBAAmB;GAClE,mBAAmB,EAAE,sBAAsB;GAC3C,YAAY,EAAE,gBAAgB;GAC9B,YAAY,EAAE,gBAAgB;GAC9B,GAAG;GACH,GAAG;GACJ;GACD;;;;;AAMJ,MAAM,kCAAmD,MAAM,WAAW;AACxE,KAAI,CAAC,MAAM,QAAQ,KAAK,CAAE,QAAO,EAAE;AAEnC,QAAO,KAAK,KAAK,MAAe,UAAkB;EAChD,MAAM,IAAI;EAEV,MAAM,eAAe,0BAA0B,GAAG,OAAO;EAEzD,MAAM,WAAW,gBAAgB,EAAE;EACnC,MAAM,UAAU,EAAE,SAAS,WAAW,EAAE,YAAY,EAAE;EACtD,MAAM,QAAS,EAAE,SAAS,EAAE,QAAQ;EAEpC,MAAM,UAAU,UACZ;GACE,MAAM;GACN,OAAO;IACL,MAAO,EAAE,YAAY,EAAE,cAAyB;IAChD,QAAQ;IACR,SAAS;IACV;GACF,GACD;GACE,MAAM;GACN,OAAO;IACL,KAAK;IACL,KAAK,SAAS;IACd,WAAW;IACZ;GACF;AASL,SAAO;GANL,IAAI,OAAO,EAAE,MAAM,SAAS,QAAQ;GACpC;GACA;GACA,aAAa,mBAAmB,EAAE;GAKlC,GAAG;GACJ;GACD;;;;;AAMJ,MAAa,sBAAuD;CAClE;CACA;CACA;CACA;CACD"}
+{"version":3,"file":"transformers.mjs","names":[],"sources":["../../src/data-sources/transformers.ts"],"sourcesContent":["/**\n * Widget Transformers\n *\n * Transform functions that map API response data to widget-specific prop shapes.\n * Each widget has one transformer that handles all data structure variants:\n * - Standard: Direct field name match\n * - Legacy: Different field names that need mapping\n * - Minimal: Bare minimum fields that need defaults\n *\n * Usage:\n * 1. Transformers are registered in the DataSourceRegistry\n * 2. Reference by name in ApiDataSource.transform\n * 3. Applied after resultPath extraction, before targetProps assignment\n */\n\nimport type { DataTransformer, DataSource } from \"./types\";\n\n/**\n * Helper to extract image URL from various API response structures.\n * Handles:\n * - Flat fields (Medium, Page, Product): image_url, imageUrl, thumbnail_url, src\n * - Nested images array (EnrollmentPack): images[0].image_url\n * - Nested library_items (Library): library_items[0].relateable.image_url\n */\nfunction extractImageUrl(d: Record<string, unknown>): string {\n  // Try flat fields first (Medium, Page, Product)\n  if (d.image_url) return d.image_url as string;\n  if (d.imageUrl) return d.imageUrl as string;\n  if (d.thumbnail_url) return d.thumbnail_url as string;\n  if (d.src) return d.src as string;\n\n  // Try nested images array (EnrollmentPack)\n  const images = d.images as Array<Record<string, unknown>> | undefined;\n  if (images && images.length > 0) {\n    const firstImage = images[0];\n    if (firstImage?.image_url) return firstImage.image_url as string;\n    if (firstImage?.url) return firstImage.url as string;\n  }\n\n  // Try nested library_items (Library/Playlist)\n  const libraryItems = d.library_items as\n    | Array<Record<string, unknown>>\n    | undefined;\n  if (libraryItems && libraryItems.length > 0) {\n    const firstItem = libraryItems[0];\n    const relateable = firstItem?.relateable as\n      | Record<string, unknown>\n      | undefined;\n    if (relateable?.image_url) return relateable.image_url as string;\n    if (relateable?.imageUrl) return relateable.imageUrl as string;\n    if (relateable?.thumbnail_url) return relateable.thumbnail_url as string;\n  }\n\n  return \"\";\n}\n\n/**\n * Helper to extract description from various API response structures.\n * Handles different field names across endpoints.\n */\nfunction extractDescription(d: Record<string, unknown>): string {\n  // Try various description field names\n  const desc =\n    d.description ?? d.stripped ?? d.stripped_description ?? d.body ?? \"\";\n\n  // Handle nested description object (some APIs return { body: \"...\" })\n  if (typeof desc === \"object\" && desc !== null && \"body\" in desc) {\n    return ((desc as Record<string, unknown>).body as string) ?? \"\";\n  }\n\n  return desc as string;\n}\n\n/**\n * Helper to extract custom widget config from a selected item.\n */\nfunction extractCustomWidgetConfig(\n  d: Record<string, unknown>,\n  source: DataSource | undefined,\n): Record<string, unknown> {\n  if (source === undefined || source.type !== \"custom\") return {};\n\n  const selectedItem = source.selectedItems.find(\n    (s) => String(s.id) === String(d.id),\n  );\n  return selectedItem?.widgetConfig ?? {};\n}\n\n/**\n * ImageWidget transformer from shareable data\n */\nconst toImagePropsFromShareable: DataTransformer = (data) => {\n  const item = Array.isArray(data) ? data[0] : data;\n  if (!item || typeof item !== \"object\") {\n    return { src: \"\", alt: \"Image\", objectFit: \"cover\" };\n  }\n\n  const d = item as Record<string, unknown>;\n  return {\n    src: extractImageUrl(d),\n    alt: (d.title ?? d.name ?? d.alt ?? \"Image\") as string,\n    objectFit: \"cover\" as const,\n  };\n};\n\n/**\n * VideoWidget transformer from shareable data\n */\nconst toVideoPropsFromShareable: DataTransformer = (data) => {\n  const item = Array.isArray(data) ? data[0] : data;\n  if (!item || typeof item !== \"object\") {\n    return { src: \"\", poster: \"\", caption: \"\" };\n  }\n\n  const d = item as Record<string, unknown>;\n  return {\n    src: ((d.video_url ?? d.videoUrl ?? d.src) as string) || \"\",\n    poster: extractImageUrl(d),\n    caption: (d.title ?? d.name ?? d.caption ?? \"\") as string,\n  };\n};\n\n/**\n * Shareable content transformer\n * Normalizes shareable API responses to a consistent format\n */\nconst toShareableProps: DataTransformer = (data, source) => {\n  if (!Array.isArray(data)) return [];\n\n  // Derive a fallback shareable type from the data source configuration.\n  // API presets pass shareable_type in their variables (e.g., \"products\").\n  // Custom sources store it per-item (handled below).\n  const sourceTypeHint =\n    source?.type === \"api\" ? source.variables?.shareable_type : undefined;\n\n  return data.map((item: unknown) => {\n    const d = item as Record<string, unknown>;\n\n    const widgetConfig = extractCustomWidgetConfig(d, source);\n\n    // Resolve shareable type from the item itself, then fall back to source hint\n    const shareableType = (d.type ??\n      d.relateable_type ??\n      d.shareable_type ??\n      d.shareableType ??\n      sourceTypeHint ??\n      \"\") as string;\n\n    return {\n      id: d.id,\n      title: (d.title ?? d.name ?? \"\") as string,\n      description: extractDescription(d),\n      imageUrl: extractImageUrl(d),\n      videoUrl: ((d.video_url ?? d.videoUrl) as string) || null,\n      shareableType,\n      kind: (d.kind ?? \"image\") as string,\n      status: (d.status ?? \"active\") as string,\n      wholesalePrice: d.display_wholesale_price ?? d.wholesale_price ?? null,\n      subscriptionPrice: d.subscription_price ?? null,\n      outOfStock: d.out_of_stock ?? false,\n      lowInStock: d.low_in_stock ?? false,\n      ...d,\n      ...widgetConfig,\n    };\n  });\n};\n\n/**\n * Carousel slides from shareables transformer\n */\nconst toCarouselSlidesFromShareables: DataTransformer = (data, source) => {\n  if (!Array.isArray(data)) return [];\n\n  return data.map((item: unknown, index: number) => {\n    const d = item as Record<string, unknown>;\n\n    const widgetConfig = extractCustomWidgetConfig(d, source);\n\n    const imageUrl = extractImageUrl(d);\n    const isVideo = d.kind === \"video\" || d.videoUrl || d.video_url;\n    const title = (d.title ?? d.name ?? \"\") as string;\n\n    const content = isVideo\n      ? {\n          type: \"VideoWidget\",\n          props: {\n            src: ((d.videoUrl ?? d.video_url) as string) || \"\",\n            poster: imageUrl,\n            caption: title,\n          },\n        }\n      : {\n          type: \"ImageWidget\",\n          props: {\n            src: imageUrl,\n            alt: title || \"Slide image\",\n            objectFit: \"cover\",\n          },\n        };\n\n    const baseSlide = {\n      id: String(d.id ?? `slide-${index}`),\n      content,\n      title,\n      description: extractDescription(d),\n    };\n\n    return {\n      ...baseSlide,\n      ...widgetConfig,\n    };\n  });\n};\n\n/**\n * All widget transformers bundled for registration\n */\nexport const WIDGET_TRANSFORMERS: Record<string, DataTransformer> = {\n  toShareableProps,\n  toCarouselSlidesFromShareables,\n  toImagePropsFromShareable,\n  toVideoPropsFromShareable,\n};\n"],"mappings":"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"}

package/dist/data-sources/use-widget-data.cjs

@@ -5,7 +5,9 @@ let react = require("react");
 let _tanstack_react_query = require("@tanstack/react-query");
 //#region src/data-sources/use-widget-data.ts
 /**
-* Generates a unique key for a data source to use in query caching.
+* Generates a cache key for the raw data fetch (endpoint/items identity only).
+* Transforms and targetProps are NOT included — they are applied per-widget
+* after reading from the shared cache.
 */
 function getSourceKey(source) {
 	if (source.type === "api") {
@@ -19,20 +21,27 @@ function getSourceKey(source) {
 	return "unknown";
 }
 /**
-* Resolves query results into widget props by mapping each source's result
-* to its target props.
+* Resolves cached raw data into widget props by applying each widget's own
+* transforms and targetProps mapping.
 */
-function resolvePropsFromQueries(queryResults, sources, errorConfig) {
+function resolvePropsFromQueries(queryResults, sources, registry, errorConfig) {
 	if (sources.length === 0) return void 0;
 	if (queryResults.some((q) => q.isLoading && !q.data)) return void 0;
 	const hasError = !!queryResults.find((q) => q.error)?.error;
 	if (hasError && errorConfig?.fallback) return errorConfig.fallback;
 	if (hasError) return;
 	const resolvedProps = {};
-	for (const query of queryResults) {
-		if (!query.data) continue;
-		const { source, result } = query.data;
-		if (!source?.targetProps) continue;
+	for (let i = 0; i < queryResults.length; i++) {
+		const query = queryResults[i];
+		const source = sources[i];
+		if (!query?.data || !source) continue;
+		if (!source.targetProps) continue;
+		let result = query.data;
+		if (source.transform) {
+			const transformer = registry.transformers[source.transform];
+			if (transformer) result = transformer(result, source);
+			else console.warn(`Transform "${source.transform}" not found in registry`);
+		}
 		if (result !== null && typeof result === "object" && !Array.isArray(result) && source.targetProps.length > 1) {
 			const resultObj = result;
 			for (const prop of source.targetProps) if (prop in resultObj) resolvedProps[prop] = resultObj[prop];
@@ -42,6 +51,10 @@ function resolvePropsFromQueries(queryResults, sources, errorConfig) {
 }
 /**
 * Hook that fetches and resolves data sources for a widget using React Query.
+*
+* Raw API data is cached and shared across widgets with the same data source.
+* Transforms and targetProps mapping are applied per-widget after cache reads,
+* so multiple widgets can share one fetch but resolve data independently.
 */
 function useWidgetData(widget, options) {
 	const config = require_data_sources_registry_context.useDataSourceRegistryConfig();
@@ -72,16 +85,7 @@ function useWidgetData(widget, options) {
 			};
 			const fetcher = registry.fetchers[source.type];
 			if (!fetcher) throw new Error(`No fetcher registered for source type: ${source.type}`);
-			let result = await fetcher(source, context);
-			if (source.transform) {
-				const transformer = registry.transformers[source.transform];
-				if (transformer) result = transformer(result, source);
-				else console.warn(`Transform "${source.transform}" not found in registry`);
-			}
-			return {
-				source,
-				result
-			};
+			return fetcher(source, context);
 		},
 		enabled: sources.length > 0,
 		retry: errorConfig?.retryCount ?? 0,
@@ -92,12 +96,22 @@ function useWidgetData(widget, options) {
 	const isLoading = results.some((q) => q.isLoading);
 	const failedQuery = results.find((q) => q.error);
 	const error = failedQuery?.error instanceof Error ? failedQuery.error : failedQuery?.error ? new Error(String(failedQuery.error)) : null;
+	const queryFingerprint = results.map((r) => `${r.dataUpdatedAt}:${r.isLoading}`).join(",");
+	const resultsRef = (0, react.useRef)(results);
+	resultsRef.current = results;
 	return {
-		data: resolvePropsFromQueries(results.map((q) => ({
-			data: q.data,
-			isLoading: q.isLoading,
-			error: q.error instanceof Error ? q.error : null
-		})), sources, errorConfig),
+		data: (0, react.useMemo)(() => {
+			return resolvePropsFromQueries(resultsRef.current.map((q) => ({
+				data: q.data,
+				isLoading: q.isLoading,
+				error: q.error instanceof Error ? q.error : null
+			})), sources, registry, errorConfig);
+		}, [
+			queryFingerprint,
+			sources,
+			registry,
+			errorConfig
+		]),
 		isLoading,
 		error,
 		refetch: (0, react.useCallback)(() => {

package/dist/data-sources/use-widget-data.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"use-widget-data.cjs","names":["useDataSourceRegistryConfig"],"sources":["../../src/data-sources/use-widget-data.ts"],"sourcesContent":["import { useQueries } from \"@tanstack/react-query\";\nimport { useCallback, useRef } from \"react\";\nimport type { WidgetSchema } from \"../types/widget-schema\";\nimport type {\n  DataSourceRegistry,\n  WidgetDataResult,\n  DataSourceContext,\n  DataSource,\n} from \"./types\";\nimport { useDataSourceRegistryConfig } from \"./registry-context\";\n\ninterface UseWidgetDataOptions {\n  /** Override the default registry from context */\n  registry?: DataSourceRegistry | undefined;\n  /** Base URL for API calls (e.g., \"https://api.fluid.app/api\") */\n  baseUrl?: string | undefined;\n}\n\n/** Result shape from a single source query */\ninterface SourceQueryResult {\n  source: DataSource;\n  result: unknown;\n}\n\n/**\n * Generates a unique key for a data source to use in query caching.\n */\nfunction getSourceKey(source: DataSource): string {\n  if (source.type === \"api\") {\n    const varsKey = source.variables\n      ? `:${JSON.stringify(source.variables)}`\n      : \"\";\n    return `${source.endpoint}${varsKey}`;\n  }\n  if (source.type === \"custom\") {\n    const itemKeys =\n      source.selectedItems?.map((item) => {\n        return `${item.shareableType}:${item.id}`;\n      }) ?? [];\n    return `custom:${itemKeys.join(\",\")}`;\n  }\n  if (source.type === \"static\") {\n    return `static:${source.staticType}:${source.selectedId}`;\n  }\n  return \"unknown\";\n}\n\n/**\n * Resolves query results into widget props by mapping each source's result\n * to its target props.\n */\nfunction resolvePropsFromQueries<T>(\n  queryResults: ReadonlyArray<{\n    data?: SourceQueryResult | undefined;\n    isLoading: boolean;\n    error: Error | null;\n  }>,\n  sources: DataSource[],\n  errorConfig?: { fallback?: unknown },\n): T | undefined {\n  if (sources.length === 0) return undefined;\n  if (queryResults.some((q) => q.isLoading && !q.data)) return undefined;\n\n  const failedQuery = queryResults.find((q) => q.error);\n  const hasError = !!failedQuery?.error;\n\n  if (hasError && errorConfig?.fallback) {\n    return errorConfig.fallback as T;\n  }\n\n  if (hasError) {\n    return undefined;\n  }\n\n  const resolvedProps: Record<string, unknown> = {};\n\n  for (const query of queryResults) {\n    if (!query.data) continue;\n    const { source, result } = query.data;\n\n    // Sentry fix: FLUID-ADMIN-1DH — source or targetProps can be undefined from malformed widget config\n    if (!source?.targetProps) continue;\n\n    if (\n      result !== null &&\n      typeof result === \"object\" &&\n      !Array.isArray(result) &&\n      source.targetProps.length > 1\n    ) {\n      const resultObj = result as Record<string, unknown>;\n      for (const prop of source.targetProps) {\n        if (prop in resultObj) {\n          resolvedProps[prop] = resultObj[prop];\n        }\n      }\n    } else {\n      for (const prop of source.targetProps) {\n        resolvedProps[prop] = result;\n      }\n    }\n  }\n\n  return resolvedProps as T;\n}\n\n/**\n * Hook that fetches and resolves data sources for a widget using React Query.\n */\nexport function useWidgetData<T = Record<string, unknown>>(\n  widget: WidgetSchema,\n  options?: UseWidgetDataOptions,\n): WidgetDataResult<T> {\n  const config = useDataSourceRegistryConfig();\n  const registry = options?.registry ?? config.registry;\n  const baseUrl = options?.baseUrl ?? config.baseUrl;\n  const getApiHeaders = config.getApiHeaders;\n  const variables = config.variables;\n\n  const sources = widget.dataSource?.sources ?? [];\n  const errorConfig = widget.dataSource?.error;\n  const widgetId = widget.id ?? \"unknown\";\n  const widgetType = widget.type;\n\n  const queryResultsRef = useRef<Array<{ refetch: () => void }>>([]);\n\n  const results = useQueries({\n    queries: sources.map((source: DataSource) => ({\n      queryKey: [\n        \"portal-widget-data\",\n        getSourceKey(source),\n        baseUrl,\n        variables,\n      ] as const,\n      queryFn: async ({\n        signal,\n      }: {\n        signal: AbortSignal;\n      }): Promise<SourceQueryResult> => {\n        const context: DataSourceContext = {\n          widgetId,\n          widgetType,\n          signal,\n          baseUrl,\n          getApiHeaders,\n          variables,\n        };\n\n        const fetcher = registry.fetchers[source.type];\n        if (!fetcher) {\n          throw new Error(\n            `No fetcher registered for source type: ${source.type}`,\n          );\n        }\n\n        const rawData = await fetcher(source, context);\n\n        // Apply transform\n        let result = rawData;\n        if (source.transform) {\n          const transformer = registry.transformers[source.transform];\n          if (transformer) {\n            result = transformer(result, source);\n          } else {\n            console.warn(\n              `Transform \"${source.transform}\" not found in registry`,\n            );\n          }\n        }\n        return { source, result };\n      },\n      enabled: sources.length > 0,\n      retry: errorConfig?.retryCount ?? 0,\n      retryDelay: errorConfig?.retryDelay ?? 1000,\n      refetchInterval: source.refreshInterval || false,\n    })),\n  });\n\n  // Update ref for refetch callback\n  queryResultsRef.current = results;\n\n  // Aggregate loading state\n  const isLoading = results.some((q) => q.isLoading);\n\n  // Get first error from any failed query\n  const failedQuery = results.find((q) => q.error);\n  const error =\n    failedQuery?.error instanceof Error\n      ? failedQuery.error\n      : failedQuery?.error\n        ? new Error(String(failedQuery.error))\n        : null;\n\n  // Resolve data from all queries\n  const data = resolvePropsFromQueries<T>(\n    results.map((q) => ({\n      data: q.data as SourceQueryResult | undefined,\n      isLoading: q.isLoading,\n      error: q.error instanceof Error ? q.error : null,\n    })),\n    sources,\n    errorConfig,\n  );\n\n  // Stable refetch callback using ref\n  const refetch = useCallback(() => {\n    queryResultsRef.current.forEach((q) => q.refetch());\n  }, []);\n\n  return {\n    data,\n    isLoading,\n    error,\n    refetch,\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"use-widget-data.cjs","names":["useDataSourceRegistryConfig"],"sources":["../../src/data-sources/use-widget-data.ts"],"sourcesContent":["import { useQueries } from \"@tanstack/react-query\";\nimport { useCallback, useMemo, useRef } from \"react\";\nimport type { WidgetSchema } from \"../types/widget-schema\";\nimport type {\n  DataSourceRegistry,\n  WidgetDataResult,\n  DataSourceContext,\n  DataSource,\n} from \"./types\";\nimport { useDataSourceRegistryConfig } from \"./registry-context\";\n\ninterface UseWidgetDataOptions {\n  /** Override the default registry from context */\n  registry?: DataSourceRegistry | undefined;\n  /** Base URL for API calls (e.g., \"https://api.fluid.app/api\") */\n  baseUrl?: string | undefined;\n}\n\n/**\n * Generates a cache key for the raw data fetch (endpoint/items identity only).\n * Transforms and targetProps are NOT included — they are applied per-widget\n * after reading from the shared cache.\n */\nfunction getSourceKey(source: DataSource): string {\n  if (source.type === \"api\") {\n    const varsKey = source.variables\n      ? `:${JSON.stringify(source.variables)}`\n      : \"\";\n    return `${source.endpoint}${varsKey}`;\n  }\n  if (source.type === \"custom\") {\n    const itemKeys =\n      source.selectedItems?.map((item) => {\n        return `${item.shareableType}:${item.id}`;\n      }) ?? [];\n    return `custom:${itemKeys.join(\",\")}`;\n  }\n  if (source.type === \"static\") {\n    return `static:${source.staticType}:${source.selectedId}`;\n  }\n  return \"unknown\";\n}\n\n/**\n * Resolves cached raw data into widget props by applying each widget's own\n * transforms and targetProps mapping.\n */\nfunction resolvePropsFromQueries<T>(\n  queryResults: ReadonlyArray<{\n    data?: unknown;\n    isLoading: boolean;\n    error: Error | null;\n  }>,\n  sources: DataSource[],\n  registry: DataSourceRegistry,\n  errorConfig?: { fallback?: unknown },\n): T | undefined {\n  if (sources.length === 0) return undefined;\n  if (queryResults.some((q) => q.isLoading && !q.data)) return undefined;\n\n  const failedQuery = queryResults.find((q) => q.error);\n  const hasError = !!failedQuery?.error;\n\n  if (hasError && errorConfig?.fallback) {\n    return errorConfig.fallback as T;\n  }\n\n  if (hasError) {\n    return undefined;\n  }\n\n  const resolvedProps: Record<string, unknown> = {};\n\n  for (let i = 0; i < queryResults.length; i++) {\n    const query = queryResults[i];\n    const source = sources[i];\n    if (!query?.data || !source) continue;\n\n    // Sentry fix: FLUID-ADMIN-1DH — source or targetProps can be undefined from malformed widget config\n    if (!source.targetProps) continue;\n\n    // Apply this widget's transform to the cached raw data\n    let result: unknown = query.data;\n    if (source.transform) {\n      const transformer = registry.transformers[source.transform];\n      if (transformer) {\n        result = transformer(result, source);\n      } else {\n        console.warn(`Transform \"${source.transform}\" not found in registry`);\n      }\n    }\n\n    // Map to this widget's targetProps\n    if (\n      result !== null &&\n      typeof result === \"object\" &&\n      !Array.isArray(result) &&\n      source.targetProps.length > 1\n    ) {\n      const resultObj = result as Record<string, unknown>;\n      for (const prop of source.targetProps) {\n        if (prop in resultObj) {\n          resolvedProps[prop] = resultObj[prop];\n        }\n      }\n    } else {\n      for (const prop of source.targetProps) {\n        resolvedProps[prop] = result;\n      }\n    }\n  }\n\n  return resolvedProps as T;\n}\n\n/**\n * Hook that fetches and resolves data sources for a widget using React Query.\n *\n * Raw API data is cached and shared across widgets with the same data source.\n * Transforms and targetProps mapping are applied per-widget after cache reads,\n * so multiple widgets can share one fetch but resolve data independently.\n */\nexport function useWidgetData<T = Record<string, unknown>>(\n  widget: WidgetSchema,\n  options?: UseWidgetDataOptions,\n): WidgetDataResult<T> {\n  const config = useDataSourceRegistryConfig();\n  const registry = options?.registry ?? config.registry;\n  const baseUrl = options?.baseUrl ?? config.baseUrl;\n  const getApiHeaders = config.getApiHeaders;\n  const variables = config.variables;\n\n  const sources = widget.dataSource?.sources ?? [];\n  const errorConfig = widget.dataSource?.error;\n  const widgetId = widget.id ?? \"unknown\";\n  const widgetType = widget.type;\n\n  const queryResultsRef = useRef<Array<{ refetch: () => void }>>([]);\n\n  // Cache only raw fetched data — no transforms or source objects stored\n  const results = useQueries({\n    queries: sources.map((source: DataSource) => ({\n      queryKey: [\n        \"portal-widget-data\",\n        getSourceKey(source),\n        baseUrl,\n        variables,\n      ] as const,\n      queryFn: async ({\n        signal,\n      }: {\n        signal: AbortSignal;\n      }): Promise<unknown> => {\n        const context: DataSourceContext = {\n          widgetId,\n          widgetType,\n          signal,\n          baseUrl,\n          getApiHeaders,\n          variables,\n        };\n\n        const fetcher = registry.fetchers[source.type];\n        if (!fetcher) {\n          throw new Error(\n            `No fetcher registered for source type: ${source.type}`,\n          );\n        }\n\n        return fetcher(source, context);\n      },\n      enabled: sources.length > 0,\n      retry: errorConfig?.retryCount ?? 0,\n      retryDelay: errorConfig?.retryDelay ?? 1000,\n      refetchInterval: source.refreshInterval || false,\n    })),\n  });\n\n  // Update ref for refetch callback\n  queryResultsRef.current = results;\n\n  // Aggregate loading state\n  const isLoading = results.some((q) => q.isLoading);\n\n  // Get first error from any failed query\n  const failedQuery = results.find((q) => q.error);\n  const error =\n    failedQuery?.error instanceof Error\n      ? failedQuery.error\n      : failedQuery?.error\n        ? new Error(String(failedQuery.error))\n        : null;\n\n  // Stable fingerprint that changes only when query data or loading states change\n  const queryFingerprint = results\n    .map((r) => `${r.dataUpdatedAt}:${r.isLoading}`)\n    .join(\",\");\n\n  // Resolve data: apply per-widget transforms and map to targetProps\n  const resultsRef = useRef(results);\n  resultsRef.current = results;\n\n  const data = useMemo(() => {\n    const querySnapshots = resultsRef.current.map((q) => ({\n      data: q.data,\n      isLoading: q.isLoading,\n      error: q.error instanceof Error ? q.error : null,\n    }));\n    return resolvePropsFromQueries<T>(\n      querySnapshots,\n      sources,\n      registry,\n      errorConfig,\n    );\n  }, [queryFingerprint, sources, registry, errorConfig]);\n\n  // Stable refetch callback using ref\n  const refetch = useCallback(() => {\n    queryResultsRef.current.forEach((q) => q.refetch());\n  }, []);\n\n  return {\n    data,\n    isLoading,\n    error,\n    refetch,\n  };\n}\n"],"mappings":"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"}

package/dist/data-sources/use-widget-data.d.cts

@@ -10,6 +10,10 @@ interface UseWidgetDataOptions {
 }
 /**
 * Hook that fetches and resolves data sources for a widget using React Query.
+*
+* Raw API data is cached and shared across widgets with the same data source.
+* Transforms and targetProps mapping are applied per-widget after cache reads,
+* so multiple widgets can share one fetch but resolve data independently.
 */
 declare function useWidgetData<T = Record<string, unknown>>(widget: WidgetSchema, options?: UseWidgetDataOptions): WidgetDataResult<T>;
 //#endregion

package/dist/data-sources/use-widget-data.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"use-widget-data.d.cts","names":[],"sources":["../../src/data-sources/use-widget-data.ts"],"mappings":";;;;UAWU,oBAAA;;EAER,QAAA,GAAW,kBAAA;EAFH;EAIR,OAAA;AAAA;;;;iBA6Fc,aAAA,KAAkB,MAAA,kBAAA,CAChC,MAAA,EAAQ,YAAA,EACR,OAAA,GAAU,oBAAA,GACT,gBAAA,CAAiB,CAAA"}
+{"version":3,"file":"use-widget-data.d.cts","names":[],"sources":["../../src/data-sources/use-widget-data.ts"],"mappings":";;;;UAWU,oBAAA;;EAER,QAAA,GAAW,kBAAA;EAFH;EAIR,OAAA;AAAA;;;;;;AA2GF;;iBAAgB,aAAA,KAAkB,MAAA,kBAAA,CAChC,MAAA,EAAQ,YAAA,EACR,OAAA,GAAU,oBAAA,GACT,gBAAA,CAAiB,CAAA"}

package/dist/data-sources/use-widget-data.d.mts

@@ -10,6 +10,10 @@ interface UseWidgetDataOptions {
 }
 /**
 * Hook that fetches and resolves data sources for a widget using React Query.
+*
+* Raw API data is cached and shared across widgets with the same data source.
+* Transforms and targetProps mapping are applied per-widget after cache reads,
+* so multiple widgets can share one fetch but resolve data independently.
 */
 declare function useWidgetData<T = Record<string, unknown>>(widget: WidgetSchema, options?: UseWidgetDataOptions): WidgetDataResult<T>;
 //#endregion

package/dist/data-sources/use-widget-data.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"use-widget-data.d.mts","names":[],"sources":["../../src/data-sources/use-widget-data.ts"],"mappings":";;;;UAWU,oBAAA;;EAER,QAAA,GAAW,kBAAA;EAFH;EAIR,OAAA;AAAA;;;;iBA6Fc,aAAA,KAAkB,MAAA,kBAAA,CAChC,MAAA,EAAQ,YAAA,EACR,OAAA,GAAU,oBAAA,GACT,gBAAA,CAAiB,CAAA"}
+{"version":3,"file":"use-widget-data.d.mts","names":[],"sources":["../../src/data-sources/use-widget-data.ts"],"mappings":";;;;UAWU,oBAAA;;EAER,QAAA,GAAW,kBAAA;EAFH;EAIR,OAAA;AAAA;;;;;;AA2GF;;iBAAgB,aAAA,KAAkB,MAAA,kBAAA,CAChC,MAAA,EAAQ,YAAA,EACR,OAAA,GAAU,oBAAA,GACT,gBAAA,CAAiB,CAAA"}

package/dist/data-sources/use-widget-data.mjs

@@ -1,9 +1,11 @@
 import { useDataSourceRegistryConfig } from "./registry-context.mjs";
-import { useCallback, useRef } from "react";
+import { useCallback, useMemo, useRef } from "react";
 import { useQueries } from "@tanstack/react-query";
 //#region src/data-sources/use-widget-data.ts
 /**
-* Generates a unique key for a data source to use in query caching.
+* Generates a cache key for the raw data fetch (endpoint/items identity only).
+* Transforms and targetProps are NOT included — they are applied per-widget
+* after reading from the shared cache.
 */
 function getSourceKey(source) {
 	if (source.type === "api") {
@@ -17,20 +19,27 @@ function getSourceKey(source) {
 	return "unknown";
 }
 /**
-* Resolves query results into widget props by mapping each source's result
-* to its target props.
+* Resolves cached raw data into widget props by applying each widget's own
+* transforms and targetProps mapping.
 */
-function resolvePropsFromQueries(queryResults, sources, errorConfig) {
+function resolvePropsFromQueries(queryResults, sources, registry, errorConfig) {
 	if (sources.length === 0) return void 0;
 	if (queryResults.some((q) => q.isLoading && !q.data)) return void 0;
 	const hasError = !!queryResults.find((q) => q.error)?.error;
 	if (hasError && errorConfig?.fallback) return errorConfig.fallback;
 	if (hasError) return;
 	const resolvedProps = {};
-	for (const query of queryResults) {
-		if (!query.data) continue;
-		const { source, result } = query.data;
-		if (!source?.targetProps) continue;
+	for (let i = 0; i < queryResults.length; i++) {
+		const query = queryResults[i];
+		const source = sources[i];
+		if (!query?.data || !source) continue;
+		if (!source.targetProps) continue;
+		let result = query.data;
+		if (source.transform) {
+			const transformer = registry.transformers[source.transform];
+			if (transformer) result = transformer(result, source);
+			else console.warn(`Transform "${source.transform}" not found in registry`);
+		}
 		if (result !== null && typeof result === "object" && !Array.isArray(result) && source.targetProps.length > 1) {
 			const resultObj = result;
 			for (const prop of source.targetProps) if (prop in resultObj) resolvedProps[prop] = resultObj[prop];
@@ -40,6 +49,10 @@ function resolvePropsFromQueries(queryResults, sources, errorConfig) {
 }
 /**
 * Hook that fetches and resolves data sources for a widget using React Query.
+*
+* Raw API data is cached and shared across widgets with the same data source.
+* Transforms and targetProps mapping are applied per-widget after cache reads,
+* so multiple widgets can share one fetch but resolve data independently.
 */
 function useWidgetData(widget, options) {
 	const config = useDataSourceRegistryConfig();
@@ -70,16 +83,7 @@ function useWidgetData(widget, options) {
 			};
 			const fetcher = registry.fetchers[source.type];
 			if (!fetcher) throw new Error(`No fetcher registered for source type: ${source.type}`);
-			let result = await fetcher(source, context);
-			if (source.transform) {
-				const transformer = registry.transformers[source.transform];
-				if (transformer) result = transformer(result, source);
-				else console.warn(`Transform "${source.transform}" not found in registry`);
-			}
-			return {
-				source,
-				result
-			};
+			return fetcher(source, context);
 		},
 		enabled: sources.length > 0,
 		retry: errorConfig?.retryCount ?? 0,
@@ -90,12 +94,22 @@ function useWidgetData(widget, options) {
 	const isLoading = results.some((q) => q.isLoading);
 	const failedQuery = results.find((q) => q.error);
 	const error = failedQuery?.error instanceof Error ? failedQuery.error : failedQuery?.error ? new Error(String(failedQuery.error)) : null;
+	const queryFingerprint = results.map((r) => `${r.dataUpdatedAt}:${r.isLoading}`).join(",");
+	const resultsRef = useRef(results);
+	resultsRef.current = results;
 	return {
-		data: resolvePropsFromQueries(results.map((q) => ({
-			data: q.data,
-			isLoading: q.isLoading,
-			error: q.error instanceof Error ? q.error : null
-		})), sources, errorConfig),
+		data: useMemo(() => {
+			return resolvePropsFromQueries(resultsRef.current.map((q) => ({
+				data: q.data,
+				isLoading: q.isLoading,
+				error: q.error instanceof Error ? q.error : null
+			})), sources, registry, errorConfig);
+		}, [
+			queryFingerprint,
+			sources,
+			registry,
+			errorConfig
+		]),
 		isLoading,
 		error,
 		refetch: useCallback(() => {

package/dist/data-sources/use-widget-data.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"use-widget-data.mjs","names":[],"sources":["../../src/data-sources/use-widget-data.ts"],"sourcesContent":["import { useQueries } from \"@tanstack/react-query\";\nimport { useCallback, useRef } from \"react\";\nimport type { WidgetSchema } from \"../types/widget-schema\";\nimport type {\n  DataSourceRegistry,\n  WidgetDataResult,\n  DataSourceContext,\n  DataSource,\n} from \"./types\";\nimport { useDataSourceRegistryConfig } from \"./registry-context\";\n\ninterface UseWidgetDataOptions {\n  /** Override the default registry from context */\n  registry?: DataSourceRegistry | undefined;\n  /** Base URL for API calls (e.g., \"https://api.fluid.app/api\") */\n  baseUrl?: string | undefined;\n}\n\n/** Result shape from a single source query */\ninterface SourceQueryResult {\n  source: DataSource;\n  result: unknown;\n}\n\n/**\n * Generates a unique key for a data source to use in query caching.\n */\nfunction getSourceKey(source: DataSource): string {\n  if (source.type === \"api\") {\n    const varsKey = source.variables\n      ? `:${JSON.stringify(source.variables)}`\n      : \"\";\n    return `${source.endpoint}${varsKey}`;\n  }\n  if (source.type === \"custom\") {\n    const itemKeys =\n      source.selectedItems?.map((item) => {\n        return `${item.shareableType}:${item.id}`;\n      }) ?? [];\n    return `custom:${itemKeys.join(\",\")}`;\n  }\n  if (source.type === \"static\") {\n    return `static:${source.staticType}:${source.selectedId}`;\n  }\n  return \"unknown\";\n}\n\n/**\n * Resolves query results into widget props by mapping each source's result\n * to its target props.\n */\nfunction resolvePropsFromQueries<T>(\n  queryResults: ReadonlyArray<{\n    data?: SourceQueryResult | undefined;\n    isLoading: boolean;\n    error: Error | null;\n  }>,\n  sources: DataSource[],\n  errorConfig?: { fallback?: unknown },\n): T | undefined {\n  if (sources.length === 0) return undefined;\n  if (queryResults.some((q) => q.isLoading && !q.data)) return undefined;\n\n  const failedQuery = queryResults.find((q) => q.error);\n  const hasError = !!failedQuery?.error;\n\n  if (hasError && errorConfig?.fallback) {\n    return errorConfig.fallback as T;\n  }\n\n  if (hasError) {\n    return undefined;\n  }\n\n  const resolvedProps: Record<string, unknown> = {};\n\n  for (const query of queryResults) {\n    if (!query.data) continue;\n    const { source, result } = query.data;\n\n    // Sentry fix: FLUID-ADMIN-1DH — source or targetProps can be undefined from malformed widget config\n    if (!source?.targetProps) continue;\n\n    if (\n      result !== null &&\n      typeof result === \"object\" &&\n      !Array.isArray(result) &&\n      source.targetProps.length > 1\n    ) {\n      const resultObj = result as Record<string, unknown>;\n      for (const prop of source.targetProps) {\n        if (prop in resultObj) {\n          resolvedProps[prop] = resultObj[prop];\n        }\n      }\n    } else {\n      for (const prop of source.targetProps) {\n        resolvedProps[prop] = result;\n      }\n    }\n  }\n\n  return resolvedProps as T;\n}\n\n/**\n * Hook that fetches and resolves data sources for a widget using React Query.\n */\nexport function useWidgetData<T = Record<string, unknown>>(\n  widget: WidgetSchema,\n  options?: UseWidgetDataOptions,\n): WidgetDataResult<T> {\n  const config = useDataSourceRegistryConfig();\n  const registry = options?.registry ?? config.registry;\n  const baseUrl = options?.baseUrl ?? config.baseUrl;\n  const getApiHeaders = config.getApiHeaders;\n  const variables = config.variables;\n\n  const sources = widget.dataSource?.sources ?? [];\n  const errorConfig = widget.dataSource?.error;\n  const widgetId = widget.id ?? \"unknown\";\n  const widgetType = widget.type;\n\n  const queryResultsRef = useRef<Array<{ refetch: () => void }>>([]);\n\n  const results = useQueries({\n    queries: sources.map((source: DataSource) => ({\n      queryKey: [\n        \"portal-widget-data\",\n        getSourceKey(source),\n        baseUrl,\n        variables,\n      ] as const,\n      queryFn: async ({\n        signal,\n      }: {\n        signal: AbortSignal;\n      }): Promise<SourceQueryResult> => {\n        const context: DataSourceContext = {\n          widgetId,\n          widgetType,\n          signal,\n          baseUrl,\n          getApiHeaders,\n          variables,\n        };\n\n        const fetcher = registry.fetchers[source.type];\n        if (!fetcher) {\n          throw new Error(\n            `No fetcher registered for source type: ${source.type}`,\n          );\n        }\n\n        const rawData = await fetcher(source, context);\n\n        // Apply transform\n        let result = rawData;\n        if (source.transform) {\n          const transformer = registry.transformers[source.transform];\n          if (transformer) {\n            result = transformer(result, source);\n          } else {\n            console.warn(\n              `Transform \"${source.transform}\" not found in registry`,\n            );\n          }\n        }\n        return { source, result };\n      },\n      enabled: sources.length > 0,\n      retry: errorConfig?.retryCount ?? 0,\n      retryDelay: errorConfig?.retryDelay ?? 1000,\n      refetchInterval: source.refreshInterval || false,\n    })),\n  });\n\n  // Update ref for refetch callback\n  queryResultsRef.current = results;\n\n  // Aggregate loading state\n  const isLoading = results.some((q) => q.isLoading);\n\n  // Get first error from any failed query\n  const failedQuery = results.find((q) => q.error);\n  const error =\n    failedQuery?.error instanceof Error\n      ? failedQuery.error\n      : failedQuery?.error\n        ? new Error(String(failedQuery.error))\n        : null;\n\n  // Resolve data from all queries\n  const data = resolvePropsFromQueries<T>(\n    results.map((q) => ({\n      data: q.data as SourceQueryResult | undefined,\n      isLoading: q.isLoading,\n      error: q.error instanceof Error ? q.error : null,\n    })),\n    sources,\n    errorConfig,\n  );\n\n  // Stable refetch callback using ref\n  const refetch = useCallback(() => {\n    queryResultsRef.current.forEach((q) => q.refetch());\n  }, []);\n\n  return {\n    data,\n    isLoading,\n    error,\n    refetch,\n  };\n}\n"],"mappings":";;;;;;;AA2BA,SAAS,aAAa,QAA4B;AAChD,KAAI,OAAO,SAAS,OAAO;EACzB,MAAM,UAAU,OAAO,YACnB,IAAI,KAAK,UAAU,OAAO,UAAU,KACpC;AACJ,SAAO,GAAG,OAAO,WAAW;;AAE9B,KAAI,OAAO,SAAS,SAKlB,QAAO,WAHL,OAAO,eAAe,KAAK,SAAS;AAClC,SAAO,GAAG,KAAK,cAAc,GAAG,KAAK;GACrC,IAAI,EAAE,EACgB,KAAK,IAAI;AAErC,KAAI,OAAO,SAAS,SAClB,QAAO,UAAU,OAAO,WAAW,GAAG,OAAO;AAE/C,QAAO;;;;;;AAOT,SAAS,wBACP,cAKA,SACA,aACe;AACf,KAAI,QAAQ,WAAW,EAAG,QAAO,KAAA;AACjC,KAAI,aAAa,MAAM,MAAM,EAAE,aAAa,CAAC,EAAE,KAAK,CAAE,QAAO,KAAA;CAG7D,MAAM,WAAW,CAAC,CADE,aAAa,MAAM,MAAM,EAAE,MAAM,EACrB;AAEhC,KAAI,YAAY,aAAa,SAC3B,QAAO,YAAY;AAGrB,KAAI,SACF;CAGF,MAAM,gBAAyC,EAAE;AAEjD,MAAK,MAAM,SAAS,cAAc;AAChC,MAAI,CAAC,MAAM,KAAM;EACjB,MAAM,EAAE,QAAQ,WAAW,MAAM;AAGjC,MAAI,CAAC,QAAQ,YAAa;AAE1B,MACE,WAAW,QACX,OAAO,WAAW,YAClB,CAAC,MAAM,QAAQ,OAAO,IACtB,OAAO,YAAY,SAAS,GAC5B;GACA,MAAM,YAAY;AAClB,QAAK,MAAM,QAAQ,OAAO,YACxB,KAAI,QAAQ,UACV,eAAc,QAAQ,UAAU;QAIpC,MAAK,MAAM,QAAQ,OAAO,YACxB,eAAc,QAAQ;;AAK5B,QAAO;;;;;AAMT,SAAgB,cACd,QACA,SACqB;CACrB,MAAM,SAAS,6BAA6B;CAC5C,MAAM,WAAW,SAAS,YAAY,OAAO;CAC7C,MAAM,UAAU,SAAS,WAAW,OAAO;CAC3C,MAAM,gBAAgB,OAAO;CAC7B,MAAM,YAAY,OAAO;CAEzB,MAAM,UAAU,OAAO,YAAY,WAAW,EAAE;CAChD,MAAM,cAAc,OAAO,YAAY;CACvC,MAAM,WAAW,OAAO,MAAM;CAC9B,MAAM,aAAa,OAAO;CAE1B,MAAM,kBAAkB,OAAuC,EAAE,CAAC;CAElE,MAAM,UAAU,WAAW,EACzB,SAAS,QAAQ,KAAK,YAAwB;EAC5C,UAAU;GACR;GACA,aAAa,OAAO;GACpB;GACA;GACD;EACD,SAAS,OAAO,EACd,aAGgC;GAChC,MAAM,UAA6B;IACjC;IACA;IACA;IACA;IACA;IACA;IACD;GAED,MAAM,UAAU,SAAS,SAAS,OAAO;AACzC,OAAI,CAAC,QACH,OAAM,IAAI,MACR,0CAA0C,OAAO,OAClD;GAMH,IAAI,SAHY,MAAM,QAAQ,QAAQ,QAAQ;AAI9C,OAAI,OAAO,WAAW;IACpB,MAAM,cAAc,SAAS,aAAa,OAAO;AACjD,QAAI,YACF,UAAS,YAAY,QAAQ,OAAO;QAEpC,SAAQ,KACN,cAAc,OAAO,UAAU,yBAChC;;AAGL,UAAO;IAAE;IAAQ;IAAQ;;EAE3B,SAAS,QAAQ,SAAS;EAC1B,OAAO,aAAa,cAAc;EAClC,YAAY,aAAa,cAAc;EACvC,iBAAiB,OAAO,mBAAmB;EAC5C,EAAE,EACJ,CAAC;AAGF,iBAAgB,UAAU;CAG1B,MAAM,YAAY,QAAQ,MAAM,MAAM,EAAE,UAAU;CAGlD,MAAM,cAAc,QAAQ,MAAM,MAAM,EAAE,MAAM;CAChD,MAAM,QACJ,aAAa,iBAAiB,QAC1B,YAAY,QACZ,aAAa,QACX,IAAI,MAAM,OAAO,YAAY,MAAM,CAAC,GACpC;AAkBR,QAAO;EACL,MAhBW,wBACX,QAAQ,KAAK,OAAO;GAClB,MAAM,EAAE;GACR,WAAW,EAAE;GACb,OAAO,EAAE,iBAAiB,QAAQ,EAAE,QAAQ;GAC7C,EAAE,EACH,SACA,YACD;EASC;EACA;EACA,SARc,kBAAkB;AAChC,mBAAgB,QAAQ,SAAS,MAAM,EAAE,SAAS,CAAC;KAClD,EAAE,CAAC;EAOL"}
+{"version":3,"file":"use-widget-data.mjs","names":[],"sources":["../../src/data-sources/use-widget-data.ts"],"sourcesContent":["import { useQueries } from \"@tanstack/react-query\";\nimport { useCallback, useMemo, useRef } from \"react\";\nimport type { WidgetSchema } from \"../types/widget-schema\";\nimport type {\n  DataSourceRegistry,\n  WidgetDataResult,\n  DataSourceContext,\n  DataSource,\n} from \"./types\";\nimport { useDataSourceRegistryConfig } from \"./registry-context\";\n\ninterface UseWidgetDataOptions {\n  /** Override the default registry from context */\n  registry?: DataSourceRegistry | undefined;\n  /** Base URL for API calls (e.g., \"https://api.fluid.app/api\") */\n  baseUrl?: string | undefined;\n}\n\n/**\n * Generates a cache key for the raw data fetch (endpoint/items identity only).\n * Transforms and targetProps are NOT included — they are applied per-widget\n * after reading from the shared cache.\n */\nfunction getSourceKey(source: DataSource): string {\n  if (source.type === \"api\") {\n    const varsKey = source.variables\n      ? `:${JSON.stringify(source.variables)}`\n      : \"\";\n    return `${source.endpoint}${varsKey}`;\n  }\n  if (source.type === \"custom\") {\n    const itemKeys =\n      source.selectedItems?.map((item) => {\n        return `${item.shareableType}:${item.id}`;\n      }) ?? [];\n    return `custom:${itemKeys.join(\",\")}`;\n  }\n  if (source.type === \"static\") {\n    return `static:${source.staticType}:${source.selectedId}`;\n  }\n  return \"unknown\";\n}\n\n/**\n * Resolves cached raw data into widget props by applying each widget's own\n * transforms and targetProps mapping.\n */\nfunction resolvePropsFromQueries<T>(\n  queryResults: ReadonlyArray<{\n    data?: unknown;\n    isLoading: boolean;\n    error: Error | null;\n  }>,\n  sources: DataSource[],\n  registry: DataSourceRegistry,\n  errorConfig?: { fallback?: unknown },\n): T | undefined {\n  if (sources.length === 0) return undefined;\n  if (queryResults.some((q) => q.isLoading && !q.data)) return undefined;\n\n  const failedQuery = queryResults.find((q) => q.error);\n  const hasError = !!failedQuery?.error;\n\n  if (hasError && errorConfig?.fallback) {\n    return errorConfig.fallback as T;\n  }\n\n  if (hasError) {\n    return undefined;\n  }\n\n  const resolvedProps: Record<string, unknown> = {};\n\n  for (let i = 0; i < queryResults.length; i++) {\n    const query = queryResults[i];\n    const source = sources[i];\n    if (!query?.data || !source) continue;\n\n    // Sentry fix: FLUID-ADMIN-1DH — source or targetProps can be undefined from malformed widget config\n    if (!source.targetProps) continue;\n\n    // Apply this widget's transform to the cached raw data\n    let result: unknown = query.data;\n    if (source.transform) {\n      const transformer = registry.transformers[source.transform];\n      if (transformer) {\n        result = transformer(result, source);\n      } else {\n        console.warn(`Transform \"${source.transform}\" not found in registry`);\n      }\n    }\n\n    // Map to this widget's targetProps\n    if (\n      result !== null &&\n      typeof result === \"object\" &&\n      !Array.isArray(result) &&\n      source.targetProps.length > 1\n    ) {\n      const resultObj = result as Record<string, unknown>;\n      for (const prop of source.targetProps) {\n        if (prop in resultObj) {\n          resolvedProps[prop] = resultObj[prop];\n        }\n      }\n    } else {\n      for (const prop of source.targetProps) {\n        resolvedProps[prop] = result;\n      }\n    }\n  }\n\n  return resolvedProps as T;\n}\n\n/**\n * Hook that fetches and resolves data sources for a widget using React Query.\n *\n * Raw API data is cached and shared across widgets with the same data source.\n * Transforms and targetProps mapping are applied per-widget after cache reads,\n * so multiple widgets can share one fetch but resolve data independently.\n */\nexport function useWidgetData<T = Record<string, unknown>>(\n  widget: WidgetSchema,\n  options?: UseWidgetDataOptions,\n): WidgetDataResult<T> {\n  const config = useDataSourceRegistryConfig();\n  const registry = options?.registry ?? config.registry;\n  const baseUrl = options?.baseUrl ?? config.baseUrl;\n  const getApiHeaders = config.getApiHeaders;\n  const variables = config.variables;\n\n  const sources = widget.dataSource?.sources ?? [];\n  const errorConfig = widget.dataSource?.error;\n  const widgetId = widget.id ?? \"unknown\";\n  const widgetType = widget.type;\n\n  const queryResultsRef = useRef<Array<{ refetch: () => void }>>([]);\n\n  // Cache only raw fetched data — no transforms or source objects stored\n  const results = useQueries({\n    queries: sources.map((source: DataSource) => ({\n      queryKey: [\n        \"portal-widget-data\",\n        getSourceKey(source),\n        baseUrl,\n        variables,\n      ] as const,\n      queryFn: async ({\n        signal,\n      }: {\n        signal: AbortSignal;\n      }): Promise<unknown> => {\n        const context: DataSourceContext = {\n          widgetId,\n          widgetType,\n          signal,\n          baseUrl,\n          getApiHeaders,\n          variables,\n        };\n\n        const fetcher = registry.fetchers[source.type];\n        if (!fetcher) {\n          throw new Error(\n            `No fetcher registered for source type: ${source.type}`,\n          );\n        }\n\n        return fetcher(source, context);\n      },\n      enabled: sources.length > 0,\n      retry: errorConfig?.retryCount ?? 0,\n      retryDelay: errorConfig?.retryDelay ?? 1000,\n      refetchInterval: source.refreshInterval || false,\n    })),\n  });\n\n  // Update ref for refetch callback\n  queryResultsRef.current = results;\n\n  // Aggregate loading state\n  const isLoading = results.some((q) => q.isLoading);\n\n  // Get first error from any failed query\n  const failedQuery = results.find((q) => q.error);\n  const error =\n    failedQuery?.error instanceof Error\n      ? failedQuery.error\n      : failedQuery?.error\n        ? new Error(String(failedQuery.error))\n        : null;\n\n  // Stable fingerprint that changes only when query data or loading states change\n  const queryFingerprint = results\n    .map((r) => `${r.dataUpdatedAt}:${r.isLoading}`)\n    .join(\",\");\n\n  // Resolve data: apply per-widget transforms and map to targetProps\n  const resultsRef = useRef(results);\n  resultsRef.current = results;\n\n  const data = useMemo(() => {\n    const querySnapshots = resultsRef.current.map((q) => ({\n      data: q.data,\n      isLoading: q.isLoading,\n      error: q.error instanceof Error ? q.error : null,\n    }));\n    return resolvePropsFromQueries<T>(\n      querySnapshots,\n      sources,\n      registry,\n      errorConfig,\n    );\n  }, [queryFingerprint, sources, registry, errorConfig]);\n\n  // Stable refetch callback using ref\n  const refetch = useCallback(() => {\n    queryResultsRef.current.forEach((q) => q.refetch());\n  }, []);\n\n  return {\n    data,\n    isLoading,\n    error,\n    refetch,\n  };\n}\n"],"mappings":"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"}