@flamingo-stack/openframe-frontend-core 0.0.393 → 0.0.394-snapshot.20260709183206

package/src/types/blog.ts

@@ -1,4 +1,5 @@
 import type { UserProfile } from "./user"
+import type { EntityPlatformAssoc } from "./entity-platform"
 
 // Core Platform Types (dynamically fetched from database via API)
 export type Platform = string;
@@ -58,14 +59,10 @@ export interface BlogPost {
   blog_media_assets?: BlogMediaAsset[];
 }
 
-export interface BlogPostPlatform {
-  id: string;
-  blog_post_id: number;
-  platform: Platform;
-  is_featured: boolean;
-  featured_order?: number;
-  created_at: string;
-}
+/** Hydrated `entity_platforms` association row — the shared junction shape
+ *  (see entity-platform.ts). The legacy `{blog_post_id, platform}` junction
+ *  declaration is gone; runtime always produced the hydrated shape. */
+export type BlogPostPlatform = EntityPlatformAssoc;
 
 export interface BlogPostCategory {
   post_id: number;
@@ -152,7 +149,8 @@ export interface CreateBlogPostData {
   og_image_url?: string;
   published_at?: string | null;
   platforms: Platform[];
-  featured_platform?: Platform;
+  /** Platform UUID (Platform is a string alias; kept as `string` for clarity — setEntityPlatforms compares against platform_id). */
+  featured_platform?: string;
   categories: number[];
   tags: number[];
 }
@@ -170,7 +168,8 @@ export interface UpdateBlogPostData {
   og_image_url?: string;
   published_at?: string | null;
   platforms?: Platform[];
-  featured_platform?: Platform;
+  /** Platform UUID (Platform is a string alias; kept as `string` for clarity — setEntityPlatforms compares against platform_id). */
+  featured_platform?: string;
   categories?: number[];
   tags?: number[];
 }

package/src/types/case-study.ts

@@ -2,6 +2,7 @@
 // Following the blog.ts pattern for consistency
 
 import type { PlatformRecord } from './platform'
+import type { EntityPlatformAssoc } from './entity-platform'
 import type { BlogTag, TagAssoc } from './blog'
 import type { MSP } from './stack'
 import type { UserProfile } from './user'
@@ -72,11 +73,7 @@ export interface CaseStudy {
   msp?: MSP // Populated MSP data via user.msp_id - includes industry, company_size, testimonials, etc.
   author?: UserProfile // Article author
   customer_interview?: CustomerInterview // Linked customer interview
-  case_study_platforms?: Array<{
-    platform_id: string
-    is_featured: boolean
-    featured_order: number | null
-  }>
+  case_study_platforms?: EntityPlatformAssoc[]
   // Flat unified tag-association shape (hydrated by entity-tag-utils).
   case_study_tags?: TagAssoc[]
 }

package/src/types/customer-interview.ts

@@ -2,6 +2,7 @@
 // Following the case-study.ts pattern for consistency
 
 import type { PlatformRecord } from './platform'
+import type { EntityPlatformAssoc } from './entity-platform'
 import type { MSP } from './stack'
 import type { UserProfile } from './user'
 import type { CaseStudy } from './case-study'
@@ -105,11 +106,7 @@ export interface CustomerInterview {
   msp?: MSP // Customer's MSP data via user.msp_id
   author?: UserProfile // Interview author
   case_study?: CaseStudy // Linked case study
-  customer_interview_platforms?: Array<{
-    platform_id: string
-    is_featured: boolean
-    featured_order: number | null
-  }>
+  customer_interview_platforms?: EntityPlatformAssoc[]
 }
 
 export interface CreateCustomerInterviewData {

package/src/types/entity-platform.ts

@@ -0,0 +1,21 @@
+/**
+ * Hydrated `entity_platforms` junction row — THE shape the hub's
+ * attachPlatformsToRows puts on every `<entity>_platforms[]` array
+ * (rows arrive featured-first with the platform record's fields spread on
+ * via PLATFORM_EMBED). One definition; the per-entity types
+ * (case_study_platforms / blog_post_platforms / customer_interview_platforms)
+ * all reference it so the shape can never drift per entity.
+ */
+export interface EntityPlatformAssoc {
+  platform_id: string
+  is_featured: boolean
+  featured_order?: number | null
+  /** Platform name — spread from the platform record. Feeds platform-aware
+   *  URL composition (composeContentUrlFromPlatforms) without casts. */
+  name?: string
+  display_name?: string
+  /** Alias some admin fetches add (e.g. getCaseStudyForAdmin). */
+  platform_name?: string
+  id?: string
+  created_at?: string
+}

package/src/types/index.ts

@@ -22,6 +22,7 @@ export * from './auth'
 export * from './blog'
 export * from './entity-author'
 export * from './case-study'
+export * from './entity-platform'
 export * from './customer-interview'
 export * from './customer-interview-ai.types'
 export * from './luma'