feat: add clip related methods to Track

Author: ricardomatias

lib/Track.ts

@@ -494,6 +494,42 @@ export class Track extends Properties<
 		return await Promise.all(clipSlots.filter((cs) => cs.hasClip).map(async (cs) => await cs.clip()));
 	}
 
+	/**
+	 * Get a specific clip based on Scene number
+	 *
+	 * @memberof Track
+	 * @return {(Promise<(Clip | null)>)}
+	 */
+	async getClip(scene: number): Promise<Clip | null> {
+		const clipSlots = await this.children('clip_slots');
+
+		if (scene < 1 || scene > clipSlots.length) return Promise.reject(null);
+
+		const clipSlot = clipSlots[scene - 1];
+
+		return await clipSlot.clip();
+	}
+
+	/**
+	 * Get a specific clip based on Scene number and creates one if there's none
+	 *
+	 * @memberof Track
+	 * @param {number} scene
+	 * @param {number} [length=4]
+	 * @return {(Promise<Clip>)}
+	 */
+	async getOrCreateClip(scene: number, length: number = 4): Promise<Clip> {
+		const clipSlots = await this.children('clip_slots');
+
+		if (scene < 1 || scene > clipSlots.length) return Promise.reject(null);
+
+		const clipSlot = clipSlots[scene - 1];
+
+		if (!clipSlot.hasClip) return await clipSlot.createClip(length);
+
+		return (await clipSlot.clip()) as Clip;
+	}
+
 	/**
 	 * Is the track a group track
 	 *