feat: expose startedPlayback to blueprint contexts via getter properties

Add startedPlayback property to IRundownContext interface and implement
as getters in RundownActivationContext and SyncIngestUpdateToPartInstanceContext.
This provides blueprints access to playlist.startedPlayback timing data.

Part of BBC-SOFIE-454

Author: rjmunro

packages/blueprints-integration/src/context/rundownContext.ts

@@ -5,11 +5,15 @@ import type { IShowStyleContext } from './showStyleContext.js'
 import type { IExecuteTSRActionsContext } from './executeTsrActionContext.js'
 import type { IDataStoreMethods } from './adlibActionContext.js'
 import { ITTimersContext } from './tTimersContext.js'
+import type { Time } from '../common.js'
 
 export interface IRundownContext extends IShowStyleContext {
 	readonly rundownId: string
 	readonly playlistId: string
 	readonly rundown: Readonly<IBlueprintSegmentRundown>
+
+	/** Actual time of playback starting for the playlist (undefined if not started) */
+	readonly startedPlayback?: Time
 }
 
 export interface IRundownUserContext extends IUserNotesContext, IRundownContext {}

packages/job-worker/src/blueprints/context/RundownActivationContext.ts

@@ -4,6 +4,7 @@ import {
 	IRundownActivationContext,
 	IRundownActivationContextState,
 	TSR,
+	Time,
 } from '@sofie-automation/blueprints-integration'
 import { PeripheralDeviceId } from '@sofie-automation/shared-lib/dist/core/model/Ids'
 import { ReadonlyDeep } from 'type-fest'
@@ -58,6 +59,10 @@ export class RundownActivationContext extends RundownEventContext implements IRu
 		return this._currentState
 	}
 
+	get startedPlayback(): Time | undefined {
+		return this._playoutModel.playlist.startedPlayback
+	}
+
 	async listPlayoutDevices(): Promise<IBlueprintPlayoutDevice[]> {
 		return listPlayoutDevices(this._context, this._playoutModel)
 	}

packages/job-worker/src/blueprints/context/SyncIngestUpdateToPartInstanceContext.ts

@@ -17,6 +17,7 @@ import {
 	IBlueprintPartInstance,
 	SomeContent,
 	WithTimeline,
+	Time,
 } from '@sofie-automation/blueprints-integration'
 import { postProcessPieces, postProcessTimelineObjects } from '../postProcess.js'
 import {
@@ -61,6 +62,10 @@ export class SyncIngestUpdateToPartInstanceContext
 		return Array.from(this.#changedTTimers.values())
 	}
 
+	public get startedPlayback(): Time | undefined {
+		return this.#playoutModel.playlist.startedPlayback
+	}
+
 	constructor(
 		context: JobContext,
 		playoutModel: PlayoutModel,