@flamingo-stack/openframe-frontend-core 0.0.584 → 0.0.585-snapshot.20260903083645

package/src/types/marketing.ts

@@ -109,6 +109,7 @@ export interface CreateAIContentInput {
 // AI Media Types
 // =============================================================================
 
+/** Row union. Compare through `utils/media-type` (`isVideoMedia` / `isImageMedia` / `MEDIA_TYPE`), never a literal. */
 export type MediaType = 'image' | 'video' | 'figma_export';
 export type MediaProvider =
   | 'dalle'
@@ -155,8 +156,9 @@ export interface AIMedia {
   social_account_id: number | null; // FK to social_accounts table - primary source of truth
   created_at: string;
   updated_at: string;
-  // Publishing & Override fields
-  selected_for_publish: boolean;
+  // Override fields. NOTE: there is no `selected_for_publish` on media — a
+  // media item is "selected" by being ATTACHED to a post that is selected
+  // (`ai_content_media`); consumers derive the flag in their DAL.
   override_url: string | null;
   override_at: string | null;
   override_by: string | null;

package/src/utils/__tests__/media-type.test.ts

@@ -0,0 +1,30 @@
+import { describe, expect, it } from 'vitest';
+import { MEDIA_TYPE, isImageMedia, isPublishableMediaType, isVideoMedia, partitionMediaByType } from '../media-type';
+
+describe('media-type', () => {
+  it('predicates read the discriminator and tolerate missing rows', () => {
+    expect(isVideoMedia({ media_type: MEDIA_TYPE.VIDEO })).toBe(true);
+    expect(isImageMedia({ media_type: MEDIA_TYPE.VIDEO })).toBe(false);
+    expect(isVideoMedia(null)).toBe(false);
+    expect(isImageMedia(undefined)).toBe(false);
+  });
+
+  it('only image and video are publishable', () => {
+    expect(isPublishableMediaType('image')).toBe(true);
+    expect(isPublishableMediaType('video')).toBe(true);
+    expect(isPublishableMediaType('figma_export')).toBe(false);
+    expect(isPublishableMediaType(null)).toBe(false);
+  });
+
+  it('partitions in order', () => {
+    const rows = [
+      { id: 1, media_type: 'video' },
+      { id: 2, media_type: 'image' },
+      { id: 3, media_type: 'video' },
+      { id: 4, media_type: 'logo' },
+    ];
+    const { videos, images } = partitionMediaByType(rows);
+    expect(videos.map(r => r.id)).toEqual([1, 3]);
+    expect(images.map(r => r.id)).toEqual([2]);
+  });
+});

package/src/utils/index.ts

@@ -365,3 +365,6 @@ export * from './embed-url-converters';
 export * from './hubspot-meetings-convention';
 export * from './page-header-constants';
 export * from './first-touch-attribution';
+
+// Media type SSOT — `media_type` discriminator predicates (leaf, zero imports)
+export * from './media-type';

package/src/utils/media-type.ts

@@ -0,0 +1,39 @@
+/**
+ * Media type — THE single source of truth for the `media_type` discriminator
+ * on media rows (ai_media, program media, vendor media). Zero imports (a leaf),
+ * so every consumer reads the same predicate instead of scattering
+ * `=== 'video'` literals. `MediaType` (types/marketing.ts) is the row union;
+ * these are the two values a post can publish.
+ */
+
+export const MEDIA_TYPE = {
+  IMAGE: 'image',
+  VIDEO: 'video',
+} as const;
+
+/** The two media types a post can publish. */
+export type PublishableMediaType = (typeof MEDIA_TYPE)[keyof typeof MEDIA_TYPE];
+
+interface MediaTyped {
+  media_type?: string | null;
+}
+
+export function isVideoMedia(media: MediaTyped | null | undefined): boolean {
+  return media?.media_type === MEDIA_TYPE.VIDEO;
+}
+
+export function isImageMedia(media: MediaTyped | null | undefined): boolean {
+  return media?.media_type === MEDIA_TYPE.IMAGE;
+}
+
+export function isPublishableMediaType(mediaType: string | null | undefined): mediaType is PublishableMediaType {
+  return mediaType === MEDIA_TYPE.VIDEO || mediaType === MEDIA_TYPE.IMAGE;
+}
+
+/** Split a media list into its videos and images, preserving order. */
+export function partitionMediaByType<T extends MediaTyped>(media: readonly T[]): { videos: T[]; images: T[] } {
+  return {
+    videos: media.filter(m => isVideoMedia(m)),
+    images: media.filter(m => isImageMedia(m)),
+  };
+}

package/src/utils/vendor-media-stub.ts

@@ -1,8 +1,8 @@
 // Vendor media utilities for UI kit
 // Real implementation copied from main project
 
+import { isImageMedia, isVideoMedia } from './media-type';
 import { fixSupabaseStorageUrl } from './url-fix';
-
 export interface VendorMedia {
   media_type: 'logo' | 'image' | 'video';
   media_url: string;
@@ -44,7 +44,7 @@ export function getVendorLogo(vendor: VendorWithMedia): string | null {
  * Get the main image URL from vendor_media array
  */
 export function getVendorImage(vendor: VendorWithMedia): string | null {
-  const imageMedia = vendor.vendor_media?.find(m => m.media_type === 'image');
+  const imageMedia = vendor.vendor_media?.find(m => isImageMedia(m));
   return imageMedia?.media_url ? fixSupabaseStorageUrl(imageMedia.media_url) : null;
 }
 
@@ -52,7 +52,7 @@ export function getVendorImage(vendor: VendorWithMedia): string | null {
  * Get the video URL from vendor_media array
  */
 export function getVendorVideo(vendor: VendorWithMedia): string | null {
-  const videoMedia = vendor.vendor_media?.find(m => m.media_type === 'video');
+  const videoMedia = vendor.vendor_media?.find(m => isVideoMedia(m));
   return videoMedia?.media_url ? fixSupabaseStorageUrl(videoMedia.media_url) : null;
 }
 
@@ -75,8 +75,8 @@ export function getVendorMediaGrouped(vendor: VendorWithMedia): {
 
   return {
     logos: media.filter(m => m.media_type === 'logo').map(m => fixSupabaseStorageUrl(m.media_url)),
-    images: media.filter(m => m.media_type === 'image').map(m => fixSupabaseStorageUrl(m.media_url)),
-    videos: media.filter(m => m.media_type === 'video').map(m => fixSupabaseStorageUrl(m.media_url)),
+    images: media.filter(m => isImageMedia(m)).map(m => fixSupabaseStorageUrl(m.media_url)),
+    videos: media.filter(m => isVideoMedia(m)).map(m => fixSupabaseStorageUrl(m.media_url)),
   };
 }
 
@@ -115,8 +115,8 @@ export function getVendorMediaCount(vendor: VendorWithMedia): {
   const media = vendor.vendor_media || [];
 
   const logos = media.filter(m => m.media_type === 'logo').length;
-  const images = media.filter(m => m.media_type === 'image').length;
-  const videos = media.filter(m => m.media_type === 'video').length;
+  const images = media.filter(m => isImageMedia(m)).length;
+  const videos = media.filter(m => isVideoMedia(m)).length;
 
   return {
     logos,