@fluid-app/rep-core 0.1.14 → 0.1.15

package/dist/data-sources/types.d.cts

@@ -1,157 +1,2 @@
-type DataSourceType = "api" | "custom" | "static";
-type StaticSourceType = "collections" | "categories" | "tags";
-type ShareableType = "Medium" | "Page" | "EnrollmentPack" | "Library" | "Product";
-interface SelectedItem {
-    /** The unique ID of the selected item */
-    id: string | number;
-    /** The type of shareable content */
-    shareableType: ShareableType;
-    /** Optional cached data for preview/display purposes in the editor UI */
-    cachedData?: {
-        title?: string;
-        imageUrl?: string;
-        kind?: string;
-    };
-    /** Widget-specific per-item configuration overrides */
-    widgetConfig?: Record<string, unknown>;
-}
-interface ApiDataSource {
-    type: "api";
-    /** API endpoint URL (can include {variable} placeholders, e.g., /api/reps/{rep_id}/items) */
-    endpoint: string;
-    /** HTTP method (defaults to GET) */
-    method?: "GET" | "POST" | "PUT" | "DELETE";
-    /** Request headers */
-    headers?: Record<string, string>;
-    /** Request body for POST/PUT (will be JSON.stringify'd) */
-    body?: unknown;
-    /**
-     * Path to extract from response using dot notation
-     * e.g., "data.items" extracts response.data.items
-     */
-    resultPath?: string;
-    /**
-     * Which widget props this source populates
-     * e.g., ['data'] means the fetched result goes to props.data
-     */
-    targetProps: string[];
-    /**
-     * Name of a registered transform function to process the data
-     * Transform is applied after resultPath extraction
-     */
-    transform?: string;
-    /** Per-source variables for endpoint template interpolation (e.g., { limit: "10" }) */
-    variables?: Record<string, string>;
-    /**
-     * Auto-refresh interval in milliseconds
-     * 0 or undefined = no auto-refresh
-     */
-    refreshInterval?: number;
-}
-interface CustomDataSource {
-    type: "custom";
-    /** Array of selected items to fetch */
-    selectedItems: SelectedItem[];
-    /**
-     * Which widget props this source populates
-     * e.g., ['slides'] means the fetched results go to props.slides
-     */
-    targetProps: string[];
-    /**
-     * Name of a registered transform function to process the data
-     * Transform is applied after all items are fetched
-     */
-    transform?: string;
-    /**
-     * Auto-refresh interval in milliseconds
-     * 0 or undefined = no auto-refresh
-     */
-    refreshInterval?: number;
-}
-interface StaticDataSource {
-    type: "static";
-    /** The type of static data (collections, categories, tags) */
-    staticType: StaticSourceType;
-    /** The selected item ID */
-    selectedId: string | number;
-    /** Cached data for preview/display in editor UI */
-    cachedData?: {
-        title?: string;
-        imageUrl?: string;
-    };
-    /**
-     * Which widget props this source populates
-     */
-    targetProps: string[];
-    /**
-     * Name of a registered transform function to process the data
-     */
-    transform?: string;
-    /**
-     * Auto-refresh interval in milliseconds
-     * 0 or undefined = no auto-refresh
-     */
-    refreshInterval?: number;
-}
-type DataSource = ApiDataSource | CustomDataSource | StaticDataSource;
-interface DataSourceConfig {
-    /** Array of data sources (usually just one, but supports multiple) */
-    sources: DataSource[];
-    /** Loading state configuration */
-    loading?: {
-        /** Show skeleton placeholder while loading (default: true) */
-        showSkeleton?: boolean;
-    };
-    /** Error handling configuration */
-    error?: {
-        /** Fallback props to use when fetch fails */
-        fallback?: Record<string, unknown>;
-        /** Number of retry attempts (default: 0) */
-        retryCount?: number;
-        /** Delay between retries in ms (default: 1000) */
-        retryDelay?: number;
-    };
-}
-/** Item returned by static data fetchers */
-interface StaticItem {
-    id: string | number;
-    title: string;
-    imageUrl?: string | undefined;
-}
-/** Context passed to fetchers and transforms */
-interface DataSourceContext {
-    /** The widget's unique ID */
-    widgetId: string;
-    /** The widget type (e.g., "ChartWidget") */
-    widgetType: string;
-    /** AbortSignal for request cancellation */
-    signal: AbortSignal;
-    /** Base URL for API calls (e.g., "https://api.fluid.app/api") */
-    baseUrl?: string | undefined;
-    /** Get API headers function */
-    getApiHeaders?: (() => Record<string, string>) | undefined;
-    /** Dynamic variables for endpoint path substitution (e.g., { rep_id: "123" }) */
-    variables?: Record<string, string> | undefined;
-}
-/** Function signature for data fetchers */
-type DataFetcher<T extends DataSource = DataSource> = (source: T, context: DataSourceContext) => Promise<unknown>;
-/** Function signature for data transforms */
-type DataTransformer = (data: unknown, source?: DataSource, context?: DataSourceContext) => unknown;
-/** The data source registry configuration */
-interface DataSourceRegistry {
-    fetchers: Record<DataSourceType, DataFetcher>;
-    transformers: Record<string, DataTransformer>;
-}
-/** Result from useWidgetData hook */
-interface WidgetDataResult<T = unknown> {
-    /** The resolved data (undefined while loading) */
-    data: T | undefined;
-    /** True while any source is loading */
-    isLoading: boolean;
-    /** Error if any source failed */
-    error: Error | null;
-    /** Manually trigger a refetch */
-    refetch: () => void;
-}
-
-export type { ApiDataSource, CustomDataSource, DataFetcher, DataSource, DataSourceConfig, DataSourceContext, DataSourceRegistry, DataSourceType, DataTransformer, SelectedItem, ShareableType, StaticDataSource, StaticItem, StaticSourceType, WidgetDataResult };
+import { a as DataSourceConfig, c as DataSourceType, d as ShareableType, f as StaticDataSource, h as WidgetDataResult, i as DataSource, l as DataTransformer, m as StaticSourceType, n as CustomDataSource, o as DataSourceContext, p as StaticItem, r as DataFetcher, s as DataSourceRegistry, t as ApiDataSource, u as SelectedItem } from "../types-BIXtQlHB.cjs";
+export { ApiDataSource, CustomDataSource, DataFetcher, DataSource, DataSourceConfig, DataSourceContext, DataSourceRegistry, DataSourceType, DataTransformer, SelectedItem, ShareableType, StaticDataSource, StaticItem, StaticSourceType, WidgetDataResult };

package/dist/data-sources/types.d.mts

@@ -0,0 +1,2 @@
+import { a as DataSourceConfig, c as DataSourceType, d as ShareableType, f as StaticDataSource, h as WidgetDataResult, i as DataSource, l as DataTransformer, m as StaticSourceType, n as CustomDataSource, o as DataSourceContext, p as StaticItem, r as DataFetcher, s as DataSourceRegistry, t as ApiDataSource, u as SelectedItem } from "../types-C5OFJy-O.mjs";
+export { ApiDataSource, CustomDataSource, DataFetcher, DataSource, DataSourceConfig, DataSourceContext, DataSourceRegistry, DataSourceType, DataTransformer, SelectedItem, ShareableType, StaticDataSource, StaticItem, StaticSourceType, WidgetDataResult };

package/dist/data-sources/types.mjs

@@ -0,0 +1 @@
+export {};

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

@@ -1,19 +1,111 @@
-'use strict';
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+require("../chunk-CKQMccvm.cjs");
+const require_data_sources_registry_context = require("./registry-context.cjs");
+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.
+*/
+function getSourceKey(source) {
+	if (source.type === "api") {
+		const varsKey = source.variables ? `:${JSON.stringify(source.variables)}` : "";
+		return `${source.endpoint}${varsKey}`;
+	}
+	if (source.type === "custom") return `custom:${(source.selectedItems?.map((item) => {
+		return `${item.shareableType}:${item.id}`;
+	}) ?? []).join(",")}`;
+	if (source.type === "static") return `static:${source.staticType}:${source.selectedId}`;
+	return "unknown";
+}
+/**
+* Resolves query results into widget props by mapping each source's result
+* to its target props.
+*/
+function resolvePropsFromQueries(queryResults, sources, 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;
+		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];
+		} else for (const prop of source.targetProps) resolvedProps[prop] = result;
+	}
+	return resolvedProps;
+}
+/**
+* Hook that fetches and resolves data sources for a widget using React Query.
+*/
+function useWidgetData(widget, options) {
+	const config = require_data_sources_registry_context.useDataSourceRegistryConfig();
+	const registry = options?.registry ?? config.registry;
+	const baseUrl = options?.baseUrl ?? config.baseUrl;
+	const getApiHeaders = config.getApiHeaders;
+	const variables = config.variables;
+	const sources = widget.dataSource?.sources ?? [];
+	const errorConfig = widget.dataSource?.error;
+	const widgetId = widget.id ?? "unknown";
+	const widgetType = widget.type;
+	const queryResultsRef = (0, react.useRef)([]);
+	const results = (0, _tanstack_react_query.useQueries)({ queries: sources.map((source) => ({
+		queryKey: [
+			"rep-widget-data",
+			getSourceKey(source),
+			baseUrl,
+			variables
+		],
+		queryFn: async ({ signal }) => {
+			const context = {
+				widgetId,
+				widgetType,
+				signal,
+				baseUrl,
+				getApiHeaders,
+				variables
+			};
+			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
+			};
+		},
+		enabled: sources.length > 0,
+		retry: errorConfig?.retryCount ?? 0,
+		retryDelay: errorConfig?.retryDelay ?? 1e3,
+		refetchInterval: source.refreshInterval || false
+	})) });
+	queryResultsRef.current = results;
+	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;
+	return {
+		data: resolvePropsFromQueries(results.map((q) => ({
+			data: q.data,
+			isLoading: q.isLoading,
+			error: q.error instanceof Error ? q.error : null
+		})), sources, errorConfig),
+		isLoading,
+		error,
+		refetch: (0, react.useCallback)(() => {
+			queryResultsRef.current.forEach((q) => q.refetch());
+		}, [])
+	};
+}
+//#endregion
+exports.useWidgetData = useWidgetData;
 
-var chunkKTXGU7OP_cjs = require('../chunk-KTXGU7OP.cjs');
-require('../chunk-ZA4AE7KF.cjs');
-require('../chunk-SJQPHJL4.cjs');
-require('../chunk-U3CQLX2Z.cjs');
-require('../chunk-46PUWB7C.cjs');
-require('../chunk-HGVSPZEL.cjs');
-require('../chunk-N2K6W7FX.cjs');
-require('../chunk-B2NTWEDF.cjs');
-
-
-
-Object.defineProperty(exports, "useWidgetData", {
-  enumerable: true,
-  get: function () { return chunkKTXGU7OP_cjs.useWidgetData; }
-});
-//# sourceMappingURL=use-widget-data.cjs.map
 //# sourceMappingURL=use-widget-data.cjs.map

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

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"use-widget-data.cjs"}
+{"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        \"rep-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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"}

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

@@ -1,16 +1,17 @@
-import { a as WidgetSchema } from '../widget-schema-DvJdg1-B.cjs';
-import { DataSourceRegistry, WidgetDataResult } from './types.cjs';
-import 'react';
+import { h as WidgetDataResult, s as DataSourceRegistry } from "../types-BIXtQlHB.cjs";
+import { a as WidgetSchema } from "../widget-schema--PY1uMWx.cjs";
 
+//#region src/data-sources/use-widget-data.d.ts
 interface UseWidgetDataOptions {
-    /** Override the default registry from context */
-    registry?: DataSourceRegistry | undefined;
-    /** Base URL for API calls (e.g., "https://api.fluid.app/api") */
-    baseUrl?: string | undefined;
+  /** Override the default registry from context */
+  registry?: DataSourceRegistry | undefined;
+  /** Base URL for API calls (e.g., "https://api.fluid.app/api") */
+  baseUrl?: string | undefined;
 }
 /**
  * Hook that fetches and resolves data sources for a widget using React Query.
  */
 declare function useWidgetData<T = Record<string, unknown>>(widget: WidgetSchema, options?: UseWidgetDataOptions): WidgetDataResult<T>;
-
+//#endregion
 export { useWidgetData };
+//# sourceMappingURL=use-widget-data.d.cts.map

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

@@ -0,0 +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;EAFiB;EAI5B,OAAA;AAAA;;;;iBA6Fc,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

@@ -0,0 +1,17 @@
+import { h as WidgetDataResult, s as DataSourceRegistry } from "../types-C5OFJy-O.mjs";
+import { a as WidgetSchema } from "../widget-schema-YkD5p3v4.mjs";
+
+//#region src/data-sources/use-widget-data.d.ts
+interface UseWidgetDataOptions {
+  /** Override the default registry from context */
+  registry?: DataSourceRegistry | undefined;
+  /** Base URL for API calls (e.g., "https://api.fluid.app/api") */
+  baseUrl?: string | undefined;
+}
+/**
+ * Hook that fetches and resolves data sources for a widget using React Query.
+ */
+declare function useWidgetData<T = Record<string, unknown>>(widget: WidgetSchema, options?: UseWidgetDataOptions): WidgetDataResult<T>;
+//#endregion
+export { useWidgetData };
+//# sourceMappingURL=use-widget-data.d.mts.map

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

@@ -0,0 +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;EAFiB;EAI5B,OAAA;AAAA;;;;iBA6Fc,aAAA,KAAkB,MAAA,kBAAA,CAChC,MAAA,EAAQ,YAAA,EACR,OAAA,GAAU,oBAAA,GACT,gBAAA,CAAiB,CAAA"}

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

@@ -0,0 +1,109 @@
+import { useDataSourceRegistryConfig } from "./registry-context.mjs";
+import { useCallback, 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.
+*/
+function getSourceKey(source) {
+	if (source.type === "api") {
+		const varsKey = source.variables ? `:${JSON.stringify(source.variables)}` : "";
+		return `${source.endpoint}${varsKey}`;
+	}
+	if (source.type === "custom") return `custom:${(source.selectedItems?.map((item) => {
+		return `${item.shareableType}:${item.id}`;
+	}) ?? []).join(",")}`;
+	if (source.type === "static") return `static:${source.staticType}:${source.selectedId}`;
+	return "unknown";
+}
+/**
+* Resolves query results into widget props by mapping each source's result
+* to its target props.
+*/
+function resolvePropsFromQueries(queryResults, sources, 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;
+		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];
+		} else for (const prop of source.targetProps) resolvedProps[prop] = result;
+	}
+	return resolvedProps;
+}
+/**
+* Hook that fetches and resolves data sources for a widget using React Query.
+*/
+function useWidgetData(widget, options) {
+	const config = useDataSourceRegistryConfig();
+	const registry = options?.registry ?? config.registry;
+	const baseUrl = options?.baseUrl ?? config.baseUrl;
+	const getApiHeaders = config.getApiHeaders;
+	const variables = config.variables;
+	const sources = widget.dataSource?.sources ?? [];
+	const errorConfig = widget.dataSource?.error;
+	const widgetId = widget.id ?? "unknown";
+	const widgetType = widget.type;
+	const queryResultsRef = useRef([]);
+	const results = useQueries({ queries: sources.map((source) => ({
+		queryKey: [
+			"rep-widget-data",
+			getSourceKey(source),
+			baseUrl,
+			variables
+		],
+		queryFn: async ({ signal }) => {
+			const context = {
+				widgetId,
+				widgetType,
+				signal,
+				baseUrl,
+				getApiHeaders,
+				variables
+			};
+			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
+			};
+		},
+		enabled: sources.length > 0,
+		retry: errorConfig?.retryCount ?? 0,
+		retryDelay: errorConfig?.retryDelay ?? 1e3,
+		refetchInterval: source.refreshInterval || false
+	})) });
+	queryResultsRef.current = results;
+	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;
+	return {
+		data: resolvePropsFromQueries(results.map((q) => ({
+			data: q.data,
+			isLoading: q.isLoading,
+			error: q.error instanceof Error ? q.error : null
+		})), sources, errorConfig),
+		isLoading,
+		error,
+		refetch: useCallback(() => {
+			queryResultsRef.current.forEach((q) => q.refetch());
+		}, [])
+	};
+}
+//#endregion
+export { useWidgetData };
+
+//# sourceMappingURL=use-widget-data.mjs.map

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

@@ -0,0 +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        \"rep-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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"}