@tailgatefantasysports/seasonservice 0.4.21 → 0.5.1

package/SeasonService.js

@@ -93,6 +93,29 @@ module.exports = class SeasonService {
         return full;
     }
 
+    /**
+     * Returns the regular season frame for a given season year, or null if not configured.
+     * @param {string|number} seasonYear
+     * @returns {{ season: string, type: string, start: Date, end: Date }|null}
+     */
+    getRegularSeason(seasonYear) {
+        const frames = this.timeframes[seasonYear];
+        if (!frames) return null;
+        const types = require('./types');
+        const frame = frames[types.regular] || frames['regular'];
+        if (!frame) return null;
+        return { season: String(seasonYear), type: types.regular, ...frame };
+    }
+
+    /**
+     * Returns the total number of weeks in the regular season for a given season object.
+     * @param {{ season: string, start: Date, end: Date }} season - regular season frame
+     * @returns {number}
+     */
+    getTotalWeeks(season) {
+        return Math.round((season.end - season.start) / this._weekInMs);
+    }
+
     /**
      * Walks to a nearby season from date in direction
      * @param {number} direction - direction to get season (1 for next, -1 for previous)

package/__tests__/index.test.js

@@ -7,7 +7,9 @@ describe('Service', () => {
             ['2020 Post', new Date('2021-01-20T00:00:00Z'), '2020', 2, new Date('2021-01-07T00:00:00Z'), new Date('2021-02-07T00:00:00Z')],
             ['2021 Beta', new Date('2021-06-20T00:00:00Z'), 'BETA', 'beta', new Date('2021-06-16T00:00:00Z'), new Date('2021-08-05T00:00:00Z')],
             ['2021 Regular', new Date('2021-09-10T00:00:00Z'), '2021', 1, new Date('2021-09-08T00:00:00Z'), new Date('2022-01-12T00:00:00Z')],
-            ['2021 Post', new Date('2022-01-20T00:00:00Z'), '2021', 2, new Date('2022-01-12T00:00:00Z'), new Date('2022-02-15T00:00:00Z')]
+            ['2021 Post', new Date('2022-01-20T00:00:00Z'), '2021', 2, new Date('2022-01-12T00:00:00Z'), new Date('2022-02-15T00:00:00Z')],
+            ['2026 Preseason', new Date('2026-08-13T23:00:00Z'), '2026', 0, new Date('2026-08-12T00:00:00Z'), new Date('2026-09-02T00:00:00Z')],
+            ['2026 Regular', new Date('2026-10-11T23:00:00Z'), '2026', 1, new Date('2026-09-09T00:00:00Z'), new Date('2027-01-13T00:00:00Z')]
         ])('%s', (_tName, date, season, type, start, end) => {
             let frame = SeasonService.getSeason(date);
                 expect(frame.season).toBe(season);
@@ -15,6 +17,34 @@ describe('Service', () => {
                 expect(frame.start).toStrictEqual(start);
                 expect(frame.end).toStrictEqual(end);
         });
+
+        // The Aug 6 Hall of Fame game sits outside the preseason frame on
+        // purpose — the game sync drops it, so week 1 is the Aug 13-15 slate.
+        test('2026 Hall of Fame game is outside the preseason frame', () => {
+            expect(SeasonService.getSeason(new Date('2026-08-06T23:00:00Z'))).toBeUndefined();
+        });
+    });
+
+    // Each frame's weeks must line up with the provider's week numbering:
+    // dates below are the first and last day of each slate on the real 2026
+    // schedule, at 7pm ET.
+    describe('Get Week — 2026 slates match provider weeks', () => {
+        test.each([
+            ['Preseason Week 1 open', new Date('2026-08-13T23:00:00Z'), 1],
+            ['Preseason Week 1 close', new Date('2026-08-15T23:00:00Z'), 1],
+            ['Preseason Week 2 open', new Date('2026-08-20T23:00:00Z'), 2],
+            ['Preseason Week 2 close', new Date('2026-08-23T23:00:00Z'), 2],
+            ['Preseason Week 3 open', new Date('2026-08-27T23:00:00Z'), 3],
+            ['Preseason Week 3 close', new Date('2026-08-29T23:00:00Z'), 3],
+            ['Regular Week 1 open', new Date('2026-09-09T23:00:00Z'), 1],
+            ['Regular Week 1 close', new Date('2026-09-14T23:00:00Z'), 1],
+            ['Regular Week 2 open', new Date('2026-09-17T23:00:00Z'), 2],
+            ['Regular Week 17 open', new Date('2026-12-31T23:00:00Z'), 17],
+            ['Regular Week 17 close', new Date('2027-01-04T23:00:00Z'), 17],
+            ['Regular Week 18', new Date('2027-01-10T23:00:00Z'), 18]
+        ])('%s', (_tName, date, week) => {
+            expect(SeasonService.getWeek(date).week).toBe(week);
+        });
     });
 });
 

package/app.config.js

@@ -89,12 +89,17 @@ module.exports = {
             }
         },
         2026: {
+            // Frames start the Wednesday 00:00Z before their week 1 games so the
+            // service's week N matches the provider's week N. The Aug 6 Hall of
+            // Fame game is intentionally outside the preseason frame — the game
+            // sync filters it out (its "Hall of Fame Weekend" label has no week
+            // number), so preseason week 1 is the Aug 13-15 slate.
             [types.preseason]: {
-                start: new Date('2026-08-05T00:00:00Z'),
-                end: new Date('2026-09-06T00:00:00Z')
+                start: new Date('2026-08-12T00:00:00Z'),
+                end: new Date('2026-09-02T00:00:00Z')
             },
             [types.regular]: {
-                start: new Date('2026-09-06T00:00:00Z'),
+                start: new Date('2026-09-09T00:00:00Z'),
                 end: new Date('2027-01-13T00:00:00Z'),
             },
             [types.postseason]: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tailgatefantasysports/seasonservice",
-  "version": "0.4.21",
+  "version": "0.5.1",
   "description": "Generic Season Service",
   "main": "index.js",
   "scripts": {