musora-content-services 1.0.159 → 1.0.160

package/CHANGELOG.md

@@ -2,6 +2,8 @@
 
 All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
 
+### [1.0.160](https://github.com/railroadmedia/musora-content-services/compare/v1.0.159...v1.0.160) (2024-11-08)
+
 ### [1.0.159](https://github.com/railroadmedia/musora-content-services/compare/v1.0.158...v1.0.159) (2024-11-08)
 
 ### [1.0.158](https://github.com/railroadmedia/musora-content-services/compare/v1.0.157...v1.0.158) (2024-11-08)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "musora-content-services",
-  "version": "1.0.159",
+  "version": "1.0.160",
   "description": "A package for Musoras content services ",
   "main": "src/index.js",
   "scripts": {

package/src/services/contentProgress.js

@@ -85,13 +85,26 @@ export async function contentStatusReset(contentId) {
         });
 }
 
-
+/**
+ * Record watch session
+ * @return {string} sessionId - provide in future calls to update progress
+ * @param {int} contentId
+ * @param {string} mediaType - options are video, assignment, practice
+ * @param {string} mediaCategory - options are youtube, vimeo, soundslice, play-alongs
+ * @param {int} mediaLengthSeconds
+ * @param {int} currentSeconds
+ * @param {int} secondsPlayed
+ * @param {string} sessionId - This function records a sessionId to pass into future updates to progress on the same video
+ */
 export async function recordWatchSession(contentId, mediaType, mediaCategory, mediaLengthSeconds, currentSeconds, secondsPlayed, sessionId = null) {
     let mediaTypeId = getMediaTypeId(mediaType, mediaCategory);
     let updateLocalProgress = mediaTypeId === 1 || mediaTypeId === 2; //only update for video playback
+    if (!sessionId) {
+        sessionId = uuidv4();
+    }
     await dataContext.update(
         async function (localContext) {
-            if (contentId && updateLocalProgress ) {
+            if (contentId && updateLocalProgress) {
                 let data = localContext.data[contentId] ?? [];
                 let progress = data?.[DATA_KEY_PROGRESS] ?? 0;
                 let status = data?.[DATA_KEY_STATUS] ?? 0;