@wscsports/blaze-web-sdk 0.35.4 → 0.35.6

package/index.d.ts

@@ -596,10 +596,6 @@ export declare class VideoFilters {
 	 */
 	static validate(options: IVideoFilterOptions): void;
 }
-export type BlazeAbTestType = {
-	id: string;
-	variant: string;
-};
 export interface IBlazeWidgetLabel {
 	readonly _type: "BlazeWidgetLabel";
 	value: string;
@@ -621,7 +617,40 @@ declare class BlazeWidgetLabel implements IBlazeWidgetLabel {
 	private static validateAndProceed;
 	private static isValidLabelFormat;
 }
-export type BlazeSourceType = "labels" | "ids" | "recommendations" | "text";
+/**
+ * Per-entry configuration for a data source within a composite.
+ */
+export interface BlazeCompositeDataSourceConfig {
+	/**
+	 * When `true`, a fetch failure for this data source fails the entire composite.
+	 * An empty success response (0 items) is not considered a failure.
+	 * Default: `false`
+	 */
+	isMandatory: boolean;
+}
+/**
+ * A single data source entry within a composite data source, paired with its configuration.
+ */
+export interface BlazeCompositeDataSourceEntry {
+	/** The data source to fetch content from. */
+	dataSource: BlazeDataSourceType;
+	/** Per-entry configuration (e.g. mandatory/optional). */
+	config: BlazeCompositeDataSourceConfig;
+}
+/**
+ * Metadata stamped on every item produced by a composite data source fetch.
+ * `null` / `undefined` for items fetched outside of a composite.
+ */
+export interface CompositeSourceMetadata {
+	/** The specific data source within the composite that produced this item. */
+	ownDataSource: BlazeDataSourceType;
+	/**
+	 * All data sources declared in the composite, in declaration order.
+	 * Includes sources that failed or returned 0 items — reflects the full configured intent.
+	 */
+	compositeRepresentation: BlazeDataSourceType[];
+}
+export type BlazeSourceType = "labels" | "ids" | "recommendations" | "text" | "composite";
 export type AdvancedOrdering = "LiveFirst";
 export interface BlazeDataSourceType {
 	sourceType: BlazeSourceType;
@@ -634,7 +663,13 @@ export interface BlazeDataSourceType {
 	personalized?: BlazePersonalized;
 	recommendations?: BlazeRecommendations;
 	text?: string;
+	/** Only present when `sourceType === 'composite'`. */
+	dataSources?: BlazeCompositeDataSourceEntry[];
 }
+export type BlazeAbTestType = {
+	id: string;
+	variant: string;
+};
 export type LocaleDirectionType = "LTR" | "RTL";
 export type OrderType = "Manual" | "AtoZ" | "ZtoA" | "RecentlyUpdatedFirst" | "RecentlyUpdatedLast" | "RecentlyCreatedFirst" | "RecentlyCreatedLast" | "Random" | "Upcoming" | "RecentlyStartingFirst" | "RecentlyStartingLast" | "RecentlyStartedFirst" | "RecentlyStartedLast";
 export type ContentOrderType = "LIVE_CHIP" | "STORY_TITLE" | "PUBLISHED_DATE";
@@ -772,11 +807,9 @@ export type RecommendationsType = {
 	anyLabelFilter?: string[];
 };
 export type BlazeRecommendationsForYou = RecommendationsType & {
-	promotedLabels?: string[];
-};
-export type BlazeRecommendationsTrending = RecommendationsType & {
-	promotedLabels?: string[];
+	coldStartLabels?: string[];
 };
+export type BlazeRecommendationsTrending = RecommendationsType;
 export type BlazeRecommendations = {
 	forYou?: BlazeRecommendationsForYou;
 	trending?: BlazeRecommendationsTrending;
@@ -820,6 +853,8 @@ export interface IContent {
 	followEntities?: BlazeFollowEntity[];
 	retrievedLanguages?: RetrievedLanguages;
 	titleImageUrl?: string;
+	attributionToken?: string | null;
+	compositeMetadata?: CompositeSourceMetadata;
 }
 export interface IBlazeContent {
 	id: string;
@@ -906,11 +941,18 @@ export interface IDataSourceBuilder {
 	ids: (params: IdsDataSourceParams) => BlazeDataSourceType;
 	recommendations: (params: RecommendationsDataSourceParams) => BlazeDataSourceType;
 	text: (params: TextDataSourceParams) => BlazeDataSourceType;
+	composite: (params: CompositeDataSourceParams) => BlazeDataSourceType;
+}
+export type LabelsDataSourceParams = Omit<BlazeDataSourceType, "sourceType" | "ids" | "recommendations" | "dataSources">;
+export type IdsDataSourceParams = Omit<BlazeDataSourceType, "sourceType" | "labels" | "recommendations" | "labelsPriority" | "maxItems" | "text" | "dataSources">;
+export type RecommendationsDataSourceParams = Omit<BlazeDataSourceType, "sourceType" | "ids" | "labels" | "text" | "dataSources">;
+export type TextDataSourceParams = Omit<BlazeDataSourceType, "sourceType" | "ids" | "recommendations" | "labels" | "labelsPriority" | "dataSources">;
+export interface CompositeDataSourceParams {
+	dataSources: {
+		dataSource: BlazeDataSourceType;
+		config?: Partial<BlazeCompositeDataSourceConfig>;
+	}[];
 }
-export type LabelsDataSourceParams = Omit<BlazeDataSourceType, "sourceType" | "ids" | "recommendations">;
-export type IdsDataSourceParams = Omit<BlazeDataSourceType, "sourceType" | "labels" | "recommendations" | "labelsPriority" | "maxItems" | "text">;
-export type RecommendationsDataSourceParams = Omit<BlazeDataSourceType, "sourceType" | "ids" | "labels" | "text">;
-export type TextDataSourceParams = Omit<BlazeDataSourceType, "sourceType" | "ids" | "recommendations" | "labels" | "labelsPriority">;
 export type BaseBlazeIcons = {
 	play: string;
 	pause: string;