feat(T-Timers): Add convenience method to set estimate anchor part by externalId

Author: rjmunro

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

@@ -88,6 +88,15 @@ export interface IPlaylistTTimer {
 	 */
 	setEstimateAnchorPart(partId: string): void
 
+	/**
+	 * Set the anchor part for automatic estimate calculation, looked up by its externalId.
+	 * This is a convenience method when you know the externalId of the part (e.g. set during ingest)
+	 * but not its internal PartId. If no part with the given externalId is found, this is a no-op.
+	 * Clears any manual estimate set via setEstimateTime/setEstimateDuration.
+	 * @param externalId The externalId of the part to use as timing anchor
+	 */
+	setEstimateAnchorPartByExternalId(externalId: string): void
+
 	/**
 	 * Manually set the estimate as an absolute timestamp
 	 * Use this when you have custom logic for calculating when you expect to reach a timing point.

packages/job-worker/src/blueprints/context/services/TTimersService.ts

@@ -6,7 +6,7 @@ import type { RundownTTimer, RundownTTimerIndex } from '@sofie-automation/coreli
 import type { TimerState } from '@sofie-automation/corelib/dist/dataModel/RundownPlaylist'
 import type { PartId } from '@sofie-automation/corelib/dist/dataModel/Ids'
 import { assertNever, literal } from '@sofie-automation/corelib/dist/lib'
-import { protectString } from '@sofie-automation/corelib/dist/protectedString'
+import { protectString, unprotectString } from '@sofie-automation/corelib/dist/protectedString'
 import type { PlayoutModel } from '../../../playout/model/PlayoutModel.js'
 import { ReadonlyDeep } from 'type-fest'
 import {
@@ -213,6 +213,13 @@ export class PlaylistTTimerImpl implements IPlaylistTTimer {
 		recalculateTTimerEstimates(this.#jobContext, this.#playoutModel)
 	}
 
+	setEstimateAnchorPartByExternalId(externalId: string): void {
+		const part = this.#playoutModel.getAllOrderedParts().find((p) => p.externalId === externalId)
+		if (!part) return
+
+		this.setEstimateAnchorPart(unprotectString(part._id))
+	}
+
 	setEstimateTime(time: number, paused: boolean = false): void {
 		const estimateState: TimerState = paused
 			? literal<TimerState>({ paused: true, duration: time - getCurrentTime() })