@wix/himalaya-cli 0.1387.0 → 0.1388.0

package/templates/restaurant/tier5-src/himi-branded-lite-home/index.ts

@@ -22,12 +22,18 @@ import { formatDateMedium } from "../_shared/engine-intl.js";
 import { readSavedProducts, type SavedProduct } from "../_shared/himi-store-saved.js";
 import { readSavedIds } from "../_shared/himi-blog-saved.js";
 import { wixMediaUrl } from "@himalaya/wix-media";
+import { isWixVideoWebRefusal, listLatestVideos, videoCard, type WixVideoCard } from "@himalaya/wix-video";
+import { videoCaptionOf, withCaption, type CaptionFlags } from "../_shared/video-caption.js";
 
 /** Latched once the member feed is refused because of WHERE the app is running rather
  *  than because of the request — see the catch in `loadExtras`. Module scope, so it
  *  survives every refresh of this worker and is reset only by a fresh boot. */
 let feedSurfaceRefused = false;
 
+/** The same latch for Wix Video: its gateway is reachable from the native apps only, so a
+ *  web bridge's refusal is permanent for this boot and the rail stays collapsed. */
+let videoSurfaceRefused = false;
+
 /** True for the one refusal that can never change while the app keeps running: the web
  *  bridge reporting that this host is not reachable from a browser at all. Deliberately
  *  narrower than `isBridgeUnavailable` — a 502/503 is an outage worth retrying, and only
@@ -292,6 +298,10 @@ interface State {
   noNextEvent: boolean;
   homePrograms: ProgramCard[];
   noHomePrograms: boolean;
+  /** The videos module's carousel — the newest ready Wix Video videos, the channels
+   *  taking turns. Guarded on `videos`; same silent-fail contract. */
+  homeVideos: (WixVideoCard & CaptionFlags)[];
+  noHomeVideos: boolean;
   feedHighlights: FeedHighlight[];
   noFeedHighlights: boolean;
   /** communityPulse member strip — the author directory of the SAME feed read
@@ -529,6 +539,7 @@ interface ExtrasSignal {
   upcomingEvents: EventEntry[];
   nextEventCards: NextEventCard[];
   homePrograms: ProgramCard[];
+  homeVideos: (WixVideoCard & CaptionFlags)[];
   feedHighlights: FeedHighlight[];
   memberAvatars: CoachAvatar[];
   groupCards: GroupCard[];
@@ -539,7 +550,7 @@ interface ExtrasSignal {
 }
 
 function emptyExtrasSignal(): ExtrasSignal {
-  return { upcomingEvents: [], nextEventCards: [], homePrograms: [], feedHighlights: [], memberAvatars: [], groupCards: [], announcementTitle: "", postCards: [], popularDishes: [], menuCategories: [] };
+  return { upcomingEvents: [], nextEventCards: [], homePrograms: [], homeVideos: [], feedHighlights: [], memberAvatars: [], groupCards: [], announcementTitle: "", postCards: [], popularDishes: [], menuCategories: [] };
 }
 
 /** Cover URL probe for a blog post — the himi-blog-feed imageUrl fallbacks
@@ -679,6 +690,18 @@ async function fetchHomePrograms(): Promise<ProgramCard[]> {
   }
 }
 
+/** ONE Wix Video read for the videos module. A failure collapses the module; the web
+ *  bridges' refusal of the gateway also latches it off for the rest of this boot. */
+async function fetchHomeVideos(): Promise<WixVideoCard[]> {
+  try {
+    const untitled = copyParam("home.videoFallbackTitle", "Video");
+    return (await listLatestVideos({ limit: 8 })).map((entry) => videoCard(entry, untitled));
+  } catch (error) {
+    if (isWixVideoWebRefusal(error)) videoSurfaceRefused = true;
+    return [];
+  }
+}
+
 function homeFeedText(item: WixFeedItem): string {
   const blocks = item.content?.blocks;
   if (Array.isArray(blocks)) {
@@ -731,6 +754,10 @@ async function fetchExtrasSignal(arg: unknown): Promise<ExtrasSignal> {
   if (verticals.includes("programs")) {
     jobs.push(fetchHomePrograms().then((cards) => { extras.homePrograms = cards; }));
   }
+  if (verticals.includes("videos") && !videoSurfaceRefused) {
+    const caption = videoCaptionOf(paramValue(arg, "videoCaption"));
+    jobs.push(fetchHomeVideos().then((cards) => { extras.homeVideos = withCaption(cards, caption); }));
+  }
   if (verticals.includes("blog")) {
     // ONE limit-8 posts query feeds BOTH the communityPulse announcement
     // (posts[0].title — the frozen contract) and the showcaseFirst/episodeFirst
@@ -847,6 +874,7 @@ function derive(state: State): State {
     noUpcomingEvents: state.upcomingEvents.length === 0,
     noNextEvent: state.nextEventCards.length === 0,
     noHomePrograms: state.homePrograms.length === 0,
+    noHomeVideos: state.homeVideos.length === 0,
     noFeedHighlights: state.feedHighlights.length === 0,
     noMemberAvatars: state.memberAvatars.length === 0,
     noGroupCards: state.groupCards.length === 0,
@@ -938,6 +966,8 @@ function baseState(): State {
     noNextEvent: true,
     homePrograms: [],
     noHomePrograms: true,
+    homeVideos: [],
+    noHomeVideos: true,
     feedHighlights: [],
     noFeedHighlights: true,
     memberAvatars: [],

package/templates/restaurant-owner/tier5-src/_shared/collection-contract.ts

@@ -98,7 +98,7 @@ export const COLLECTIONS: Record<string, CollectionConfig> = {
   himiBrandedBadges: { rows: 'badges', title: 'name', subtitle: 'description', view: 'grid' },
   himiBrandedDonations: { rows: 'campaigns', title: 'name', subtitle: 'description', view: 'grid', primaryVerb: { label: 'Donate' } },
   himiBrandedGiftCards: { rows: 'cards', title: 'name', subtitle: 'description', view: 'grid' },
-  himiBrandedVideos: { rows: 'channels', title: 'title', subtitle: 'description', view: 'grid' },
+  himiBrandedVideos: { rows: 'channels', title: 'title', subtitle: 'subtitle', image: 'coverUrl', view: 'grid', searchPlaceholder: 'Search channels', countNoun: ['channel', 'channels'] },
   himiBrandedPodcasts: { rows: 'episodes', title: 'title', subtitle: 'subtitle', image: 'image', metadata: ['progressLabel'], view: 'list' },
   himiBrandedForms: { rows: 'forms', title: 'name', subtitle: 'description', view: 'list' },
   himiBrandedGalleries: { rows: 'galleries', title: 'name', subtitle: 'description', image: 'image', view: 'grid' },

package/templates/retail-store/tier5-src/_shared/collection-contract.ts

@@ -98,7 +98,7 @@ export const COLLECTIONS: Record<string, CollectionConfig> = {
   himiBrandedBadges: { rows: 'badges', title: 'name', subtitle: 'description', view: 'grid' },
   himiBrandedDonations: { rows: 'campaigns', title: 'name', subtitle: 'description', view: 'grid', primaryVerb: { label: 'Donate' } },
   himiBrandedGiftCards: { rows: 'cards', title: 'name', subtitle: 'description', view: 'grid' },
-  himiBrandedVideos: { rows: 'channels', title: 'title', subtitle: 'description', view: 'grid' },
+  himiBrandedVideos: { rows: 'channels', title: 'title', subtitle: 'subtitle', image: 'coverUrl', view: 'grid', searchPlaceholder: 'Search channels', countNoun: ['channel', 'channels'] },
   himiBrandedPodcasts: { rows: 'episodes', title: 'title', subtitle: 'subtitle', image: 'image', metadata: ['progressLabel'], view: 'list' },
   himiBrandedForms: { rows: 'forms', title: 'name', subtitle: 'description', view: 'list' },
   himiBrandedGalleries: { rows: 'galleries', title: 'name', subtitle: 'description', image: 'image', view: 'grid' },

package/templates/retail-store/tier5-src/_shared/video-caption.ts

@@ -0,0 +1,21 @@
+// The video carousel's two looks: the caption ON the cover (a brand label chip over the
+// image) or UNDER it. Every slide carries both placements; the descriptor's
+// `videoCaption` appear param picks one, and these flags hide the other
+// (`hiddenWhen` hides on TRUE). So a screen switches look by changing ONE param,
+// with no second carousel and no change to the slide tree.
+export type VideoCaption = "overlay" | "below";
+
+/** The placement a param asks for. Anything but "below" is the default, "overlay". */
+export function videoCaptionOf(value: unknown): VideoCaption {
+  return value === "below" ? "below" : "overlay";
+}
+
+export interface CaptionFlags {
+  captionOnImage: boolean;
+  captionBelow: boolean;
+}
+
+/** Stamp each card with the gates its slide reads (`$item.captionOnImage` / `$item.captionBelow`). */
+export function withCaption<T extends object>(cards: T[], caption: VideoCaption): (T & CaptionFlags)[] {
+  return cards.map((card) => ({ ...card, captionOnImage: caption === "overlay", captionBelow: caption === "below" }));
+}

package/templates/retail-store/tier5-src/himi-branded-lite-home/index.ts

@@ -22,12 +22,18 @@ import { formatDateMedium } from "../_shared/engine-intl.js";
 import { readSavedProducts, type SavedProduct } from "../_shared/himi-store-saved.js";
 import { readSavedIds } from "../_shared/himi-blog-saved.js";
 import { wixMediaUrl } from "@himalaya/wix-media";
+import { isWixVideoWebRefusal, listLatestVideos, videoCard, type WixVideoCard } from "@himalaya/wix-video";
+import { videoCaptionOf, withCaption, type CaptionFlags } from "../_shared/video-caption.js";
 
 /** Latched once the member feed is refused because of WHERE the app is running rather
  *  than because of the request — see the catch in `loadExtras`. Module scope, so it
  *  survives every refresh of this worker and is reset only by a fresh boot. */
 let feedSurfaceRefused = false;
 
+/** The same latch for Wix Video: its gateway is reachable from the native apps only, so a
+ *  web bridge's refusal is permanent for this boot and the rail stays collapsed. */
+let videoSurfaceRefused = false;
+
 /** True for the one refusal that can never change while the app keeps running: the web
  *  bridge reporting that this host is not reachable from a browser at all. Deliberately
  *  narrower than `isBridgeUnavailable` — a 502/503 is an outage worth retrying, and only
@@ -292,6 +298,10 @@ interface State {
   noNextEvent: boolean;
   homePrograms: ProgramCard[];
   noHomePrograms: boolean;
+  /** The videos module's carousel — the newest ready Wix Video videos, the channels
+   *  taking turns. Guarded on `videos`; same silent-fail contract. */
+  homeVideos: (WixVideoCard & CaptionFlags)[];
+  noHomeVideos: boolean;
   feedHighlights: FeedHighlight[];
   noFeedHighlights: boolean;
   /** communityPulse member strip — the author directory of the SAME feed read
@@ -529,6 +539,7 @@ interface ExtrasSignal {
   upcomingEvents: EventEntry[];
   nextEventCards: NextEventCard[];
   homePrograms: ProgramCard[];
+  homeVideos: (WixVideoCard & CaptionFlags)[];
   feedHighlights: FeedHighlight[];
   memberAvatars: CoachAvatar[];
   groupCards: GroupCard[];
@@ -539,7 +550,7 @@ interface ExtrasSignal {
 }
 
 function emptyExtrasSignal(): ExtrasSignal {
-  return { upcomingEvents: [], nextEventCards: [], homePrograms: [], feedHighlights: [], memberAvatars: [], groupCards: [], announcementTitle: "", postCards: [], popularDishes: [], menuCategories: [] };
+  return { upcomingEvents: [], nextEventCards: [], homePrograms: [], homeVideos: [], feedHighlights: [], memberAvatars: [], groupCards: [], announcementTitle: "", postCards: [], popularDishes: [], menuCategories: [] };
 }
 
 /** Cover URL probe for a blog post — the himi-blog-feed imageUrl fallbacks
@@ -679,6 +690,18 @@ async function fetchHomePrograms(): Promise<ProgramCard[]> {
   }
 }
 
+/** ONE Wix Video read for the videos module. A failure collapses the module; the web
+ *  bridges' refusal of the gateway also latches it off for the rest of this boot. */
+async function fetchHomeVideos(): Promise<WixVideoCard[]> {
+  try {
+    const untitled = copyParam("home.videoFallbackTitle", "Video");
+    return (await listLatestVideos({ limit: 8 })).map((entry) => videoCard(entry, untitled));
+  } catch (error) {
+    if (isWixVideoWebRefusal(error)) videoSurfaceRefused = true;
+    return [];
+  }
+}
+
 function homeFeedText(item: WixFeedItem): string {
   const blocks = item.content?.blocks;
   if (Array.isArray(blocks)) {
@@ -731,6 +754,10 @@ async function fetchExtrasSignal(arg: unknown): Promise<ExtrasSignal> {
   if (verticals.includes("programs")) {
     jobs.push(fetchHomePrograms().then((cards) => { extras.homePrograms = cards; }));
   }
+  if (verticals.includes("videos") && !videoSurfaceRefused) {
+    const caption = videoCaptionOf(paramValue(arg, "videoCaption"));
+    jobs.push(fetchHomeVideos().then((cards) => { extras.homeVideos = withCaption(cards, caption); }));
+  }
   if (verticals.includes("blog")) {
     // ONE limit-8 posts query feeds BOTH the communityPulse announcement
     // (posts[0].title — the frozen contract) and the showcaseFirst/episodeFirst
@@ -847,6 +874,7 @@ function derive(state: State): State {
     noUpcomingEvents: state.upcomingEvents.length === 0,
     noNextEvent: state.nextEventCards.length === 0,
     noHomePrograms: state.homePrograms.length === 0,
+    noHomeVideos: state.homeVideos.length === 0,
     noFeedHighlights: state.feedHighlights.length === 0,
     noMemberAvatars: state.memberAvatars.length === 0,
     noGroupCards: state.groupCards.length === 0,
@@ -938,6 +966,8 @@ function baseState(): State {
     noNextEvent: true,
     homePrograms: [],
     noHomePrograms: true,
+    homeVideos: [],
+    noHomeVideos: true,
     feedHighlights: [],
     noFeedHighlights: true,
     memberAvatars: [],

package/templates/retail-store-owner/tier5-src/_shared/collection-contract.ts

@@ -98,7 +98,7 @@ export const COLLECTIONS: Record<string, CollectionConfig> = {
   himiBrandedBadges: { rows: 'badges', title: 'name', subtitle: 'description', view: 'grid' },
   himiBrandedDonations: { rows: 'campaigns', title: 'name', subtitle: 'description', view: 'grid', primaryVerb: { label: 'Donate' } },
   himiBrandedGiftCards: { rows: 'cards', title: 'name', subtitle: 'description', view: 'grid' },
-  himiBrandedVideos: { rows: 'channels', title: 'title', subtitle: 'description', view: 'grid' },
+  himiBrandedVideos: { rows: 'channels', title: 'title', subtitle: 'subtitle', image: 'coverUrl', view: 'grid', searchPlaceholder: 'Search channels', countNoun: ['channel', 'channels'] },
   himiBrandedPodcasts: { rows: 'episodes', title: 'title', subtitle: 'subtitle', image: 'image', metadata: ['progressLabel'], view: 'list' },
   himiBrandedForms: { rows: 'forms', title: 'name', subtitle: 'description', view: 'list' },
   himiBrandedGalleries: { rows: 'galleries', title: 'name', subtitle: 'description', image: 'image', view: 'grid' },

package/templates/yoga-studio/tier5-src/_shared/collection-contract.ts

@@ -98,7 +98,7 @@ export const COLLECTIONS: Record<string, CollectionConfig> = {
   himiBrandedBadges: { rows: 'badges', title: 'name', subtitle: 'description', view: 'grid' },
   himiBrandedDonations: { rows: 'campaigns', title: 'name', subtitle: 'description', view: 'grid', primaryVerb: { label: 'Donate' } },
   himiBrandedGiftCards: { rows: 'cards', title: 'name', subtitle: 'description', view: 'grid' },
-  himiBrandedVideos: { rows: 'channels', title: 'title', subtitle: 'description', view: 'grid' },
+  himiBrandedVideos: { rows: 'channels', title: 'title', subtitle: 'subtitle', image: 'coverUrl', view: 'grid', searchPlaceholder: 'Search channels', countNoun: ['channel', 'channels'] },
   himiBrandedPodcasts: { rows: 'episodes', title: 'title', subtitle: 'subtitle', image: 'image', metadata: ['progressLabel'], view: 'list' },
   himiBrandedForms: { rows: 'forms', title: 'name', subtitle: 'description', view: 'list' },
   himiBrandedGalleries: { rows: 'galleries', title: 'name', subtitle: 'description', image: 'image', view: 'grid' },

package/templates/yoga-studio/tier5-src/_shared/video-caption.ts

@@ -0,0 +1,21 @@
+// The video carousel's two looks: the caption ON the cover (a brand label chip over the
+// image) or UNDER it. Every slide carries both placements; the descriptor's
+// `videoCaption` appear param picks one, and these flags hide the other
+// (`hiddenWhen` hides on TRUE). So a screen switches look by changing ONE param,
+// with no second carousel and no change to the slide tree.
+export type VideoCaption = "overlay" | "below";
+
+/** The placement a param asks for. Anything but "below" is the default, "overlay". */
+export function videoCaptionOf(value: unknown): VideoCaption {
+  return value === "below" ? "below" : "overlay";
+}
+
+export interface CaptionFlags {
+  captionOnImage: boolean;
+  captionBelow: boolean;
+}
+
+/** Stamp each card with the gates its slide reads (`$item.captionOnImage` / `$item.captionBelow`). */
+export function withCaption<T extends object>(cards: T[], caption: VideoCaption): (T & CaptionFlags)[] {
+  return cards.map((card) => ({ ...card, captionOnImage: caption === "overlay", captionBelow: caption === "below" }));
+}

package/templates/yoga-studio/tier5-src/himi-branded-lite-home/index.ts

@@ -22,12 +22,18 @@ import { formatDateMedium } from "../_shared/engine-intl.js";
 import { readSavedProducts, type SavedProduct } from "../_shared/himi-store-saved.js";
 import { readSavedIds } from "../_shared/himi-blog-saved.js";
 import { wixMediaUrl } from "@himalaya/wix-media";
+import { isWixVideoWebRefusal, listLatestVideos, videoCard, type WixVideoCard } from "@himalaya/wix-video";
+import { videoCaptionOf, withCaption, type CaptionFlags } from "../_shared/video-caption.js";
 
 /** Latched once the member feed is refused because of WHERE the app is running rather
  *  than because of the request — see the catch in `loadExtras`. Module scope, so it
  *  survives every refresh of this worker and is reset only by a fresh boot. */
 let feedSurfaceRefused = false;
 
+/** The same latch for Wix Video: its gateway is reachable from the native apps only, so a
+ *  web bridge's refusal is permanent for this boot and the rail stays collapsed. */
+let videoSurfaceRefused = false;
+
 /** True for the one refusal that can never change while the app keeps running: the web
  *  bridge reporting that this host is not reachable from a browser at all. Deliberately
  *  narrower than `isBridgeUnavailable` — a 502/503 is an outage worth retrying, and only
@@ -292,6 +298,10 @@ interface State {
   noNextEvent: boolean;
   homePrograms: ProgramCard[];
   noHomePrograms: boolean;
+  /** The videos module's carousel — the newest ready Wix Video videos, the channels
+   *  taking turns. Guarded on `videos`; same silent-fail contract. */
+  homeVideos: (WixVideoCard & CaptionFlags)[];
+  noHomeVideos: boolean;
   feedHighlights: FeedHighlight[];
   noFeedHighlights: boolean;
   /** communityPulse member strip — the author directory of the SAME feed read
@@ -529,6 +539,7 @@ interface ExtrasSignal {
   upcomingEvents: EventEntry[];
   nextEventCards: NextEventCard[];
   homePrograms: ProgramCard[];
+  homeVideos: (WixVideoCard & CaptionFlags)[];
   feedHighlights: FeedHighlight[];
   memberAvatars: CoachAvatar[];
   groupCards: GroupCard[];
@@ -539,7 +550,7 @@ interface ExtrasSignal {
 }
 
 function emptyExtrasSignal(): ExtrasSignal {
-  return { upcomingEvents: [], nextEventCards: [], homePrograms: [], feedHighlights: [], memberAvatars: [], groupCards: [], announcementTitle: "", postCards: [], popularDishes: [], menuCategories: [] };
+  return { upcomingEvents: [], nextEventCards: [], homePrograms: [], homeVideos: [], feedHighlights: [], memberAvatars: [], groupCards: [], announcementTitle: "", postCards: [], popularDishes: [], menuCategories: [] };
 }
 
 /** Cover URL probe for a blog post — the himi-blog-feed imageUrl fallbacks
@@ -679,6 +690,18 @@ async function fetchHomePrograms(): Promise<ProgramCard[]> {
   }
 }
 
+/** ONE Wix Video read for the videos module. A failure collapses the module; the web
+ *  bridges' refusal of the gateway also latches it off for the rest of this boot. */
+async function fetchHomeVideos(): Promise<WixVideoCard[]> {
+  try {
+    const untitled = copyParam("home.videoFallbackTitle", "Video");
+    return (await listLatestVideos({ limit: 8 })).map((entry) => videoCard(entry, untitled));
+  } catch (error) {
+    if (isWixVideoWebRefusal(error)) videoSurfaceRefused = true;
+    return [];
+  }
+}
+
 function homeFeedText(item: WixFeedItem): string {
   const blocks = item.content?.blocks;
   if (Array.isArray(blocks)) {
@@ -731,6 +754,10 @@ async function fetchExtrasSignal(arg: unknown): Promise<ExtrasSignal> {
   if (verticals.includes("programs")) {
     jobs.push(fetchHomePrograms().then((cards) => { extras.homePrograms = cards; }));
   }
+  if (verticals.includes("videos") && !videoSurfaceRefused) {
+    const caption = videoCaptionOf(paramValue(arg, "videoCaption"));
+    jobs.push(fetchHomeVideos().then((cards) => { extras.homeVideos = withCaption(cards, caption); }));
+  }
   if (verticals.includes("blog")) {
     // ONE limit-8 posts query feeds BOTH the communityPulse announcement
     // (posts[0].title — the frozen contract) and the showcaseFirst/episodeFirst
@@ -847,6 +874,7 @@ function derive(state: State): State {
     noUpcomingEvents: state.upcomingEvents.length === 0,
     noNextEvent: state.nextEventCards.length === 0,
     noHomePrograms: state.homePrograms.length === 0,
+    noHomeVideos: state.homeVideos.length === 0,
     noFeedHighlights: state.feedHighlights.length === 0,
     noMemberAvatars: state.memberAvatars.length === 0,
     noGroupCards: state.groupCards.length === 0,
@@ -938,6 +966,8 @@ function baseState(): State {
     noNextEvent: true,
     homePrograms: [],
     noHomePrograms: true,
+    homeVideos: [],
+    noHomeVideos: true,
     feedHighlights: [],
     noFeedHighlights: true,
     memberAvatars: [],

package/templates/yoga-studio-owner/tier5-src/_shared/collection-contract.ts

@@ -98,7 +98,7 @@ export const COLLECTIONS: Record<string, CollectionConfig> = {
   himiBrandedBadges: { rows: 'badges', title: 'name', subtitle: 'description', view: 'grid' },
   himiBrandedDonations: { rows: 'campaigns', title: 'name', subtitle: 'description', view: 'grid', primaryVerb: { label: 'Donate' } },
   himiBrandedGiftCards: { rows: 'cards', title: 'name', subtitle: 'description', view: 'grid' },
-  himiBrandedVideos: { rows: 'channels', title: 'title', subtitle: 'description', view: 'grid' },
+  himiBrandedVideos: { rows: 'channels', title: 'title', subtitle: 'subtitle', image: 'coverUrl', view: 'grid', searchPlaceholder: 'Search channels', countNoun: ['channel', 'channels'] },
   himiBrandedPodcasts: { rows: 'episodes', title: 'title', subtitle: 'subtitle', image: 'image', metadata: ['progressLabel'], view: 'list' },
   himiBrandedForms: { rows: 'forms', title: 'name', subtitle: 'description', view: 'list' },
   himiBrandedGalleries: { rows: 'galleries', title: 'name', subtitle: 'description', image: 'image', view: 'grid' },

package/templates/branded-lite/tier5-src/_shared/vod.ts

@@ -1,71 +0,0 @@
-// VOD's public GraphQL contract: wix-one-app-vod/src/api/v3/{Channel,Video}Fetch.ts.
-// Always use the host's visitor/member bridge; never use owner credentials here.
-export const VOD_PUBLIC_GRAPHQL = "https://manage.wix.com/_api/vod/public/graphql";
-export interface VodVideo {
-  id: string; title?: string; description?: string; source?: string; status?: string;
-  content?: { status?: string; externalUrl?: string; externalId?: string };
-  pricing?: { type: string; enabled: boolean }[];
-  purchase?: { status?: string }; rent_purchase?: { status?: string };
-}
-export interface VodChannel {
-  id: string; title?: string;
-  pricing?: { type: string; enabled: boolean; required?: boolean }[];
-  purchase?: { status?: string; expiresAt?: string };
-}
-export function vodError(message: string, denied = false, signInRequired = false): Error & { denied: boolean; signInRequired: boolean } {
-  return Object.assign(new Error(message), { denied, signInRequired });
-}
-export async function vodQuery<T>(query: string, variables: Record<string, unknown>): Promise<T> {
-  const api = (globalThis as { himalaya?: { wixApi?: { call: (m: string, p: string, b: unknown) => Promise<unknown> } } }).himalaya?.wixApi;
-  if (!api) throw vodError("Wix bridge unavailable");
-  const response = await api.call("POST", VOD_PUBLIC_GRAPHQL, { query, variables }) as
-    { data?: T | null; errors?: { message?: string; extensions?: { code?: string } }[] };
-  if (response?.errors?.length) {
-    const signInRequired = response.errors.some(e => /^UNAUTHENTICATED$|^UNAUTHORIZED$/i.test(e.extensions?.code ?? ""));
-    const denied = response.errors.some(e => /FORBIDDEN|UNAUTH|ACCESS_DENIED|PERMISSION_DENIED/i.test(e.extensions?.code ?? ""));
-    throw vodError(signInRequired ? "Video unauthenticated" : denied ? "Video access denied" : "VOD query failed", denied, signInRequired);
-  }
-  const data = response && Object.prototype.hasOwnProperty.call(response, "data") ? response.data : response as T;
-  if (!data || typeof data !== "object") throw vodError("Invalid VOD response");
-  return data;
-}
-
-export async function vodPages<T extends { id: string }>(fetchPage: (cursor: string | null) => Promise<{ entities: T[]; cursor?: string | null }>): Promise<T[]> {
-  const rows = new Map<string, T>();
-  const cursors = new Set<string>();
-  let cursor: string | null = null;
-  for (let page = 0; page < 200; page++) {
-    const result = await fetchPage(cursor);
-    if (!result || !Array.isArray(result.entities)) throw vodError("Invalid VOD page");
-    for (const row of result.entities) if (row?.id) rows.set(row.id, row);
-    if (!result.cursor) return [...rows.values()];
-    if (typeof result.cursor !== "string" || cursors.has(result.cursor)) throw vodError("Invalid VOD cursor");
-    cursor = result.cursor;
-    cursors.add(cursor);
-  }
-  throw vodError("VOD pagination limit exceeded");
-}
-
-export const CHANNEL_ACCESS_FIELDS = `id title pricing { type enabled required } purchase(filter: {type: SUBSCRIPTION}) { status expiresAt }`;
-export const VIDEO_FIELDS = `id title description source status content { status externalUrl externalId } pricing { type enabled } purchase(filter: {type: SALE}) { status } rent_purchase: purchase(filter: {type: RENT}) { status }`;
-
-/** External embeds expose their URL without a play authorization. Fail closed when
- * metadata is missing or a plan's entitlement cannot be established. Hosted videos
- * must ALSO obtain their media URL through play(type: CONTENT). */
-export function videoAccess(channel: VodChannel, video: VodVideo): boolean {
-  if (!Array.isArray(channel.pricing) || !Array.isArray(video.pricing)) return false;
-  const subscription = channel.purchase;
-  const expires = subscription?.expiresAt ? Date.parse(subscription.expiresAt) : undefined;
-  const subscribed = subscription?.status === "ACTIVE" && (expires === undefined || expires > Date.now()) ||
-    subscription?.status === "CANCELED" && expires !== undefined && expires > Date.now();
-  const channelOptions = channel.pricing.filter(p => p.enabled);
-  if (channelOptions.some(p => p.required || p.type === "PRICING_PLAN") && !subscribed) return false;
-  const paid = video.pricing.some(p => p.enabled);
-  return !paid || subscribed || video.purchase?.status === "ACTIVE" || video.rent_purchase?.status === "ACTIVE";
-}
-
-export function youtubeId(video: VodVideo): string {
-  // Treat the embed URL as data, not arbitrary WebView HTML or a navigable URL.
-  const match = /^https:\/\/(?:(?:www\.|m\.)?youtube\.com|www\.youtube-nocookie\.com)\/embed\/([A-Za-z0-9_-]{11})(?:[?/#]|$)/.exec(video.content?.externalUrl ?? "");
-  return match?.[1] ?? (/^[A-Za-z0-9_-]{11}$/.test(video.content?.externalId ?? "") ? video.content!.externalId! : "");
-}