Update Oura schemas

commons/connector/oura/oura_heart_rate.avsc

@@ -8,7 +8,7 @@
  {"name": "timeReceived", "type": "double", "doc": "Time that this record was collected by a service in seconds since the Unix Epoch (s)."},
  {"name": "bpm", "type": ["null", "int"], "doc": "Heart rate in beats per minute.", "default": null}, 
  {"name": "source", "type":
- {"name": "OuraHeartRateSource", "type": "enum", "symbols": ["AWAKE", "REST", "SLEEP", "SESSION", "LIVE", "UNKNOWN"], "doc": "Heart rate source type as computed by Oura."},
- "doc": "Heart rate source type as computed by Oura.", "default": "UNKNOWN" }
+ {"name": "OuraHeartRateSource", "type": "enum", "symbols": ["AWAKE", "REST", "SLEEP", "SESSION", "LIVE", "WORKOUT", "UNKNOWN"], "doc": "Heart rate source type as computed by Oura."},
+ "doc": "Heart rate source type as computed by Oura. UNKNOWN when this data is not provided (e.g. samples from sleep API).", "default": "UNKNOWN" }
  ]
 }

commons/connector/oura/oura_session.avsc

@@ -4,16 +4,15 @@
  "type": "record",
  "doc": "The Sessions data scope provides information on how users engage with guided and unguided sessions in the Oura app, including the user’s biometric trends during the sessions.",
  "fields": [
- {"name": "time", "type": "double", "doc": "Start time of the activity in seconds since January 1, 1970, 00:00:00 UTC (Unix timestamp)."},
+ {"name": "time", "type": "double", "doc": "Start time of the session in seconds since January 1, 1970, 00:00:00 UTC (Unix timestamp)."},
+ {"name": "endTime", "type": ["null", "string"], "doc": "Timestamp indicating when the session ended. Null if unknown.", "default": null}, 
  {"name": "timeReceived", "type": "double", "doc": "Time that this record was collected by a service in seconds since the Unix Epoch (s)."},
  {"name": "id", "type": ["null", "string"], "doc": "Unique identifier of the session from Oura.", "default": null}, 
- {"name": "startDateTime", "type": ["null", "string"], "doc": "Timestamp indicating when the workout started. Null if unknown.", "default": null},
- {"name": "endDateTime", "type": ["null", "string"], "doc": "Timestamp indicating when the workout ended. Null if unknown.", "default": null},
  {"name": "type", "type":
  {"name": "OuraMomentType", "type": "enum", "symbols": ["BREATHING", "MEDITATION", "NAP", "RELAXATION", "REST", "BODY_STATUS", "UNKNOWN"], "doc": "Possible Oura Moment types."},
- "doc": "Oura Moment type.", "default": "UNKNOWN" },
+ "doc": "Oura Moment type. UNKNOWN when this data is not provided by Oura.", "default": "UNKNOWN" },
  {"name": "mood", "type":
  {"name": "OuraMomentMood", "type": "enum", "symbols": ["BAD", "WORSE", "SAME", "GOOD", "GREAT", "UNKNOWN"], "doc": "Possible Oura Moment moods."},
- "doc": "Oura Moment mood.", "default": "UNKNOWN" }
+ "doc": "Oura Moment mood. UNKNOWN when this data is not provided by Oura.", "default": "UNKNOWN" }
  ]
 }

commons/connector/oura/oura_workout.avsc

@@ -4,20 +4,19 @@
  "type": "record",
  "doc": "The Workout data scope includes information about user workouts. This is a diverse, growing list of workouts that help inform how the user is training and exercising.",
  "fields": [
- {"name": "time", "type": "double", "doc": "Start time of the activity in seconds since January 1, 1970, 00:00:00 UTC (Unix timestamp)."},
+ {"name": "time", "type": "double", "doc": "Start time of the workout in seconds since January 1, 1970, 00:00:00 UTC (Unix timestamp)."},
+ {"name": "endTime", "type": ["null", "string"], "doc": "Timestamp indicating when the workout ended. Null if unknown.", "default": null},
  {"name": "timeReceived", "type": "double", "doc": "Time that this record was collected by a service in seconds since the Unix Epoch (s)."},
  {"name": "id", "type": ["null", "string"], "doc": "Unique identifier of the workout from Oura.", "default": null}, 
  {"name": "calories", "type": ["null", "float"], "doc": "Energy burned in kilocalories during the workout. Null if unknown.", "default": null},
  {"name": "day", "type": ["null", "string"], "doc": "Day when the workout occurred. Null if unknown.", "default": null},
  {"name": "distance", "type": ["null", "float"], "doc": "Distance traveled in meters during the workout. Null if unknown.", "default": null},
- {"name": "startDateTime", "type": ["null", "string"], "doc": "Timestamp indicating when the workout started. Null if unknown.", "default": null},
- {"name": "endDateTime", "type": ["null", "string"], "doc": "Timestamp indicating when the workout ended. Null if unknown.", "default": null},
  {"name": "intensity", "type":
  {"name": "OuraWorkoutIntensity", "type": "enum", "symbols": ["EASY", "MODERATE", "HARD", "UNKNOWN"], "doc": "Workout intensity as computed by Oura."},
- "doc": "Workout intensity as computed by Oura.", "default": "UNKNOWN" },
+ "doc": "Workout intensity as computed by Oura. UNKNOWN when this data is not provided by Oura.", "default": "UNKNOWN" },
  {"name": "label", "type": ["null", "string"], "doc": "User-defined label for the workout. Null if unknown.", "default": null},
  {"name": "source", "type":
  {"name": "OuraWorkoutSource", "type": "enum", "symbols": ["MANUAL", "AUTODETECTED", "CONFIRMED", "WORKOUT_HEART_RATE", "UNKNOWN"], "doc": "Workout source type as computed by Oura."},
- "doc": "Workout source type as computed by Oura.", "default": "UNKNOWN" }
+ "doc": "Workout source type as computed by Oura. UNKNOWN when this data is not provided by Oura.", "default": "UNKNOWN" }
  ]
 }