musora-content-services 2.95.0 → 2.95.2

package/src/services/awards/types.js

@@ -6,14 +6,14 @@
  * @property {string|null} logo - URL to logo image
  * @property {string} badge - URL to badge image
  * @property {string} award - URL to award image
- * @property {number} content_id - Railcontent ID of the parent content
- * @property {string} content_type - Type of content (guided-course, learning-path-v2, etc.)
+ * @property {number} content_id - Railcontent ID of the parent content (e.g., the learning path ID)
+ * @property {string} content_type - Type of parent content ('learning-path-v2', 'guided-course', etc.). Used with content_id to determine collection context for award evaluation.
  * @property {string} type - Sanity document type
  * @property {string} brand - Brand (drumeo, pianote, guitareo, singeo)
  * @property {string} content_title - Title of the associated content
  * @property {string|null} award_custom_text - Custom text for the award
  * @property {string|null} instructor_name - Name of the instructor
- * @property {number[]} child_ids - Array of child content IDs required for completion
+ * @property {number[]} child_ids - Array of child content IDs (lessons) that must be completed to earn this award
  */
 
 /**
@@ -41,7 +41,7 @@
  * @property {string} award - URL to award image
  * @property {string} brand - Brand (drumeo, pianote, guitareo, singeo)
  * @property {string} instructorName - Name of the instructor
- * @property {number} progressPercentage - Completion percentage (0-100)
+ * @property {number} progressPercentage - Completion percentage (0-100). Progress is tracked per collection context for learning paths.
  * @property {boolean} isCompleted - Whether the award is fully completed
  * @property {string|null} completedAt - ISO timestamp of completion, or null if not completed
  * @property {AwardCompletionData|null} completionData - Practice statistics, or null if not started
@@ -50,7 +50,7 @@
 /**
  * @typedef {Object} ContentAwardsResponse
  * @property {boolean} hasAwards - Whether the content has any associated awards
- * @property {AwardInfo[]} awards - Array of award objects with progress information
+ * @property {AwardInfo[]} awards - Array of award objects with progress information. For learning paths, progress is scoped to the specific learning path context.
  */
 
 /**

package/src/services/sync/fetch.ts

@@ -308,7 +308,13 @@ function serializeIds(ids: { id: RecordId }): { client_record_id: RecordId } {
 
 function deserializeRecord(record: SyncSyncable<BaseModel, 'client_record_id'> | null): SyncSyncable<BaseModel, 'id'> | null {
   if (record) {
-    const { client_record_id: id, ...rest } = record
+    const { client_record_id: id, ...rest } = record as any
+
+    if ('collection_type' in rest && rest.collection_type === 'self') {
+      rest.collection_type = null
+      rest.collection_id = null
+    }
+
     return {
       ...rest,
       id

package/src/services/sync/repositories/user-award-progress.ts

@@ -15,7 +15,7 @@ export default class UserAwardProgressRepository extends SyncRepository<UserAwar
   }
 
   static isInProgress(progress: AwardProgressData): boolean {
-    return progress.progress_percentage > 0 && !UserAwardProgressRepository.isCompleted(progress)
+    return progress.progress_percentage >= 0 && !UserAwardProgressRepository.isCompleted(progress)
   }
 
   static completedAtDate(progress: { completed_at: number | null }): Date | null {