chore: move to duration based schedule

Author: tsi

docs/es-modules/schedule.html

@@ -52,8 +52,8 @@ <h3 class="mt-4">Example Code (ESM):</h3>
   publicId: 'sea_turtle',
   schedule: {
     weekly: [
-      { day: 'monday', start: '09:00', end: '17:00' },
-      { day: 'tuesday', start: '09:00', end: '17:00' }
+      { day: 'monday', start: '09:00', duration: 8 },
+      { day: 'tuesday', start: '09:00', duration: 8 }
     ]
   }
 });
@@ -73,7 +73,7 @@ <h3 class="mt-4">Example Code (ESM):</h3>
         const slots = [];
         for (let d = 0; d < 7; d++) {
           if (d !== today) {
-            slots.push({ day: DAY_NAMES[d], start: '00:00', end: '23:59' });
+            slots.push({ day: DAY_NAMES[d], start: '00:00', duration: 24 });
           }
         }
         return slots;
@@ -82,7 +82,7 @@ <h3 class="mt-4">Example Code (ESM):</h3>
       function getScheduleForPlayerMode() {
         const now = new Date();
         const today = now.getDay();
-        return [{ day: DAY_NAMES[today], start: '00:00', end: '23:59' }];
+        return [{ day: DAY_NAMES[today], start: '00:00', duration: 24 }];
       }
 
       function loadPlayerWithMode(showPlayer) {

docs/schedule.html

@@ -22,7 +22,7 @@
         var slots = [];
         for (var d = 0; d < 7; d++) {
           if (d !== today) {
-            slots.push({ day: DAY_NAMES[d], start: '00:00', end: '23:59' });
+            slots.push({ day: DAY_NAMES[d], start: '00:00', duration: 24 });
           }
         }
         return slots;
@@ -31,7 +31,7 @@
       function getScheduleForPlayerMode() {
         var now = new Date();
         var today = now.getDay();
-        return [{ day: DAY_NAMES[today], start: '00:00', end: '23:59' }];
+        return [{ day: DAY_NAMES[today], start: '00:00', duration: 24 }];
       }
 
       function loadPlayerWithMode(showPlayer) {
@@ -105,8 +105,8 @@ <h3 class="mt-4">Example Code:</h3>
   publicId: 'sea_turtle',
   schedule: {
     weekly: [
-      { day: 'monday', start: '09:00', end: '17:00' },
-      { day: 'tuesday', start: '09:00', end: '17:00' }
+      { day: 'monday', start: '09:00', duration: 8 },
+      { day: 'tuesday', start: '09:00', duration: 8 }
     ]
   }
 });

src/config/configSchema.json

@@ -569,9 +569,9 @@
             "properties": {
               "day": { "type": "string" },
               "start": { "type": "string" },
-              "end": { "type": "string" }
+              "duration": { "type": "number" }
             },
-            "required": ["day", "start", "end"]
+            "required": ["day", "start", "duration"]
           },
           "default": []
         }

src/utils/schedule.js

@@ -121,7 +121,7 @@ const parseTime = (timeStr) => {
 
 /**
  * Check if a date falls within any configured weekly slot (local time).
- * @param {{ weekly?: Array<{ day: string, start: string, end: string }> }} schedule - schedule config
+ * @param {{ weekly?: Array<{ day: string, start: string, duration: number }> }} schedule - schedule config
  * @param {Date} date - date to check (uses local time)
  * @returns {boolean} true if within a slot
  */
@@ -139,8 +139,8 @@ export const isWithinSchedule = (schedule, date) => {
     if (slotDay !== day) continue;
 
     const startMin = parseTime(slot.start);
-    const endMin = parseTime(slot.end);
-    if (startMin === null || endMin === null) continue;
+    if (startMin === null || typeof slot.duration !== 'number' || slot.duration <= 0) continue;
+    const endMin = startMin + slot.duration * 60;
 
     if (startMin <= endMin) {
       if (minutes >= startMin && minutes < endMin) return true;

test/unit/schedule.test.js

@@ -46,15 +46,15 @@ describe('schedule utils', () => {
     it('returns true when date falls within a slot', () => {
       const monday9am = new Date(2025, 2, 10, 9, 30);
       const schedule = {
-        weekly: [{ day: 'monday', start: '09:00', end: '17:00' }]
+        weekly: [{ day: 'monday', start: '09:00', duration: 8 }]
       };
       expect(isWithinSchedule(schedule, monday9am)).toBe(true);
     });
 
     it('returns false when date is outside all slots', () => {
       const monday8am = new Date(2025, 2, 10, 8, 0);
       const schedule = {
-        weekly: [{ day: 'monday', start: '09:00', end: '17:00' }]
+        weekly: [{ day: 'monday', start: '09:00', duration: 8 }]
       };
       expect(isWithinSchedule(schedule, monday8am)).toBe(false);
     });
@@ -63,7 +63,7 @@ describe('schedule utils', () => {
       const monday9am = new Date(2025, 2, 10, 9, 0);
       const monday5pm = new Date(2025, 2, 10, 17, 0);
       const schedule = {
-        weekly: [{ day: 'monday', start: '09:00', end: '17:00' }]
+        weekly: [{ day: 'monday', start: '09:00', duration: 8 }]
       };
       expect(isWithinSchedule(schedule, monday9am)).toBe(true);
       expect(isWithinSchedule(schedule, monday5pm)).toBe(false);
@@ -73,8 +73,8 @@ describe('schedule utils', () => {
       const wednesday2pm = new Date(2025, 2, 12, 14, 0);
       const schedule = {
         weekly: [
-          { day: 'monday', start: '09:00', end: '17:00' },
-          { day: 'wednesday', start: '12:00', end: '18:00' }
+          { day: 'monday', start: '09:00', duration: 8 },
+          { day: 'wednesday', start: '12:00', duration: 6 }
         ]
       };
       expect(isWithinSchedule(schedule, wednesday2pm)).toBe(true);