feat: add notes field to VideoBlock

apis/api-gateway/schema.graphql

@@ -1328,6 +1328,10 @@ type VideoBlock implements Block @join__type(graph: API_JOURNEYS, key: "id")  @j
   showGeneratedSubtitles: Boolean
   customizable: Boolean
   mediaVideo: MediaVideo @join__field(graph: API_JOURNEYS_MODERN) 
+  """
+  Publisher notes for template adapters (e.g. trailer, intro).
+  """
+  notes: String @join__field(graph: API_JOURNEYS_MODERN) 
 }
 
 """
@@ -5033,6 +5037,7 @@ input VideoBlockCreateInput @join__type(graph: API_JOURNEYS_MODERN)  {
   subtitleLanguageId: ID
   showGeneratedSubtitles: Boolean
   customizable: Boolean
+  notes: String
 }
 
 input VideoBlockUpdateInput @join__type(graph: API_JOURNEYS_MODERN)  {
@@ -5060,6 +5065,7 @@ input VideoBlockUpdateInput @join__type(graph: API_JOURNEYS_MODERN)  {
   source: VideoBlockSource
   showGeneratedSubtitles: Boolean
   customizable: Boolean
+  notes: String
 }
 
 input LanguagesFilter @join__type(graph: API_LANGUAGES)  {

apis/api-journeys-modern/schema.graphql

@@ -2394,6 +2394,9 @@ type VideoBlock implements Block
   showGeneratedSubtitles: Boolean
   mediaVideo: MediaVideo
   customizable: Boolean
+
+  """Publisher notes for template adapters (e.g. trailer, intro)."""
+  notes: String
 }
 
 input VideoBlockCreateInput {
@@ -2424,6 +2427,7 @@ input VideoBlockCreateInput {
   subtitleLanguageId: ID
   showGeneratedSubtitles: Boolean
   customizable: Boolean
+  notes: String
 }
 
 enum VideoBlockObjectFit {
@@ -2465,6 +2469,7 @@ input VideoBlockUpdateInput {
   source: VideoBlockSource
   showGeneratedSubtitles: Boolean
   customizable: Boolean
+  notes: String
 }
 
 type VideoCollapseEvent implements Event

apis/api-journeys-modern/src/schema/block/video/inputs/videoBlockCreateInput.ts

@@ -32,7 +32,8 @@ export const VideoBlockCreateInput = builder.inputType(
       posterBlockId: t.id({ required: false }),
       subtitleLanguageId: t.id({ required: false }),
       showGeneratedSubtitles: t.boolean({ required: false }),
-      customizable: t.boolean({ required: false })
+      customizable: t.boolean({ required: false }),
+      notes: t.string({ required: false })
     })
   }
 )

apis/api-journeys-modern/src/schema/block/video/inputs/videoBlockUpdateInput.ts

@@ -30,7 +30,8 @@ export const VideoBlockUpdateInput = builder.inputType(
   youTube source: videoId required`
       }),
       showGeneratedSubtitles: t.boolean({ required: false }),
-      customizable: t.boolean({ required: false })
+      customizable: t.boolean({ required: false }),
+      notes: t.string({ required: false })
     })
   }
 )

apis/api-journeys-modern/src/schema/block/video/video.ts

@@ -117,6 +117,11 @@ youTube source: videoId, title, description, and duration present`,
     }),
     customizable: t.exposeBoolean('customizable', {
       nullable: true
+    }),
+    notes: t.exposeString('notes', {
+      nullable: true,
+      description:
+        'Publisher notes for template adapters (e.g. trailer, intro).'
     })
   })
 })

apis/api-journeys-modern/src/schema/block/video/videoBlockUpdate.mutation.spec.ts

@@ -20,6 +20,10 @@ jest.mock('./service', () => {
   }
 })
 
+type VideoBlockUpdateResult = {
+  data?: { videoBlockUpdate: { notes: string | null } }
+}
+
 describe('videoBlockUpdate', () => {
   const mockUser = { id: 'userId' }
   const authClient = getClient({
@@ -47,6 +51,7 @@ describe('videoBlockUpdate', () => {
         posterBlockId
         parentBlockId
         showGeneratedSubtitles
+        notes
         subtitleLanguage {
           id
         }
@@ -97,6 +102,7 @@ describe('videoBlockUpdate', () => {
           journeyId: 'journeyId',
           typename: 'VideoBlock',
           subtitleLanguage: null,
+          notes: null,
           ...input
         })
       },
@@ -156,4 +162,83 @@ describe('videoBlockUpdate', () => {
       ]
     })
   })
+
+  it('updates and returns notes when notes is set', async () => {
+    fetchBlockWithJourneyAcl.mockResolvedValue({
+      id,
+      journeyId: 'journeyId',
+      journey: { id: 'journeyId' }
+    })
+    mockAbility.mockReturnValue(true)
+
+    const notesInput = { notes: 'test trailer note' }
+    const tx = {
+      block: {
+        update: jest.fn().mockResolvedValue({
+          id,
+          journeyId: 'journeyId',
+          typename: 'VideoBlock',
+          subtitleLanguage: null,
+          ...input,
+          ...notesInput
+        })
+      },
+      journey: { update: jest.fn().mockResolvedValue({ id: 'journeyId' }) }
+    }
+    prismaMock.$transaction.mockImplementation(async (cb: any) => await cb(tx))
+
+    const result = await authClient({
+      document: VIDEO_BLOCK_UPDATE,
+      variables: { id, input: { ...input, ...notesInput } }
+    })
+
+    expect(
+      (result as VideoBlockUpdateResult).data?.videoBlockUpdate.notes
+    ).toBe('test trailer note')
+    expect(tx.block.update).toHaveBeenCalledWith(
+      expect.objectContaining({
+        where: { id },
+        data: expect.objectContaining({ notes: 'test trailer note' })
+      })
+    )
+  })
+
+  it('clears notes when notes is set to empty string', async () => {
+    fetchBlockWithJourneyAcl.mockResolvedValue({
+      id,
+      journeyId: 'journeyId',
+      journey: { id: 'journeyId' }
+    })
+    mockAbility.mockReturnValue(true)
+
+    const tx = {
+      block: {
+        update: jest.fn().mockResolvedValue({
+          id,
+          journeyId: 'journeyId',
+          typename: 'VideoBlock',
+          subtitleLanguage: null,
+          notes: '',
+          ...input
+        })
+      },
+      journey: { update: jest.fn().mockResolvedValue({ id: 'journeyId' }) }
+    }
+    prismaMock.$transaction.mockImplementation(async (cb: any) => await cb(tx))
+
+    const result = await authClient({
+      document: VIDEO_BLOCK_UPDATE,
+      variables: { id, input: { ...input, notes: '' } }
+    })
+
+    expect(
+      (result as VideoBlockUpdateResult).data?.videoBlockUpdate.notes
+    ).toBe('')
+    expect(tx.block.update).toHaveBeenCalledWith(
+      expect.objectContaining({
+        where: { id },
+        data: expect.objectContaining({ notes: '' })
+      })
+    )
+  })
 })

apis/api-journeys/src/app/modules/block/video/video.graphql

@@ -117,4 +117,8 @@ type VideoBlock implements Block @key(fields: "id") @shareable {
   subtitleLanguage: Language @shareable
   showGeneratedSubtitles: Boolean @shareable
   customizable: Boolean @shareable
+  """
+  Publisher notes for template adapters (e.g. trailer, intro).
+  """
+  notes: String @shareable
 }

libs/prisma/journeys/db/migrations/20260305200417_add_video_block_notes/migration.sql

@@ -0,0 +1,2 @@
+-- AlterTable
+ALTER TABLE "Block" ADD COLUMN "notes" TEXT;

libs/prisma/journeys/db/schema.prisma

@@ -632,6 +632,7 @@ model Block {
   settings                   Json                 @default("{ }") // block settings
   exportOrder                Int? // column order for CSV exports and Google Sheets syncs
   customizable               Boolean?
+  notes                      String? // VideoBlock: publisher notes for template adapters (e.g. trailer, intro)
 
   @@unique([slug, journeyId])
   @@index(journeyId)