seatsio 65.2.0 → 67.0.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "seatsio",
-  "version": "65.2.0",
+  "version": "67.0.0",
   "main": "index.js",
   "description": "Official JavaScript and Node.JS client library for the Seats.io REST API",
   "license": "MIT",
@@ -14,13 +14,13 @@
     "url": "https://github.com/seatsio/seatsio-js"
   },
   "dependencies": {
-    "axios": "0.24.0"
+    "axios": "0.25.0"
   },
   "devDependencies": {
     "browserify": "latest",
     "eslint": "7.32.0",
     "eslint-config-standard": "16.0.3",
-    "eslint-plugin-import": "2.25.3",
+    "eslint-plugin-import": "2.25.4",
     "eslint-plugin-node": "11.1.0",
     "eslint-plugin-promise": "6.0.0",
     "eslint-plugin-standard": "5.0.0",
@@ -30,8 +30,8 @@
     "gulp-tap": "latest",
     "gulp-uglify": "latest",
     "gulp-uglify-es": "latest",
-    "jest": "27.4.5",
-    "jest-cli": "27.4.5",
+    "jest": "27.4.7",
+    "jest-cli": "27.4.7",
     "uuid": "8.3.2"
   }
 }

package/src/AsyncIterator.js

@@ -1,15 +1,16 @@
 const Page = require('./Page.js')
 const StatusChange = require('./Events/StatusChange.js')
 const Chart = require('./Charts/Chart.js')
-const Event = require('./Events/Event.js')
 const User = require('./Users/User.js')
 const Subaccount = require('./Subaccounts/Subaccount.js')
 const Workspace = require('./Workspaces/Workspace.js')
+const Season = require('./Seasons/Season')
+const EventDeserializer = require('./Events/EventDeserializer')
 
 class AsyncIterator {
     /**
      * @param {string} url
-     * @param {SeatsioClient} client
+     * @param {Axios} client
      * @param {string} objType
      * @param {object} params
      */
@@ -38,13 +39,23 @@ class AsyncIterator {
     events (data) {
         const events = []
         data.items.forEach(eventData => {
-            const event = new Event(eventData)
+            const event = new EventDeserializer().fromJson(eventData)
             this.items.push(event)
             events.push(event)
         })
         this.pages.push(new Page(events, data.next_page_starts_after, data.previous_page_ends_before))
     }
 
+    seasons (data) {
+        const seasons = []
+        data.items.forEach(seasonData => {
+            const season = new Season(seasonData)
+            this.items.push(season)
+            seasons.push(season)
+        })
+        this.pages.push(new Page(seasons, data.next_page_starts_after, data.previous_page_ends_before))
+    }
+
     statusChanges (data) {
         const statusChanges = []
         data.items.forEach((statusData) => {
@@ -102,6 +113,9 @@ class AsyncIterator {
                 case 'events':
                     this.events(res.data)
                     break
+                case 'seasons':
+                    this.seasons(res.data)
+                    break
                 case 'statusChanges':
                     this.statusChanges(res.data)
                     break

package/src/Charts/Chart.js

@@ -1,6 +1,6 @@
-const Event = require('../Events/Event.js')
 const ChartValidation = require('./ChartValidation')
 const SocialDistancingRuleset = require('./SocialDistancingRuleset')
+const EventDeserializer = require('../Events/EventDeserializer')
 
 class Chart {
     /**
@@ -14,7 +14,7 @@ class Chart {
         this.tags = chart.tags
         this.publishedVersionThumbnailUrl = chart.publishedVersionThumbnailUrl
         this.draftVersionThumbnailUrl = chart.draftVersionThumbnailUrl || null
-        this.events = chart.events ? chart.events.map(event => new Event(event)) : []
+        this.events = chart.events ? chart.events.map(event => new EventDeserializer().fromJson(event)) : []
         this.archived = chart.archived
         if (chart.validation) this.validation = new ChartValidation(chart.validation)
         this.socialDistancingRulesets = Chart.socialDistancingRulesetsFromJson(chart.socialDistancingRulesets)

package/src/Charts/Charts.js

@@ -4,7 +4,7 @@ const Chart = require('./Chart.js')
 
 class Charts {
     /**
-     * @param {SeatsioClient} client
+     * @param {Axios} client
      */
     constructor (client) {
         this.client = client

package/src/Events/Event.js

@@ -17,6 +17,10 @@ class Event {
         this.channels = event.channels ? event.channels.map(c => new Channel(c)) : null
         this.socialDistancingRulesetKey = event.socialDistancingRulesetKey
     }
+
+    isSeason () {
+        return false
+    }
 }
 
 module.exports = Event

package/src/Events/EventDeserializer.js

@@ -0,0 +1,13 @@
+const Season = require('../Seasons/Season')
+const Event = require('./Event.js')
+
+class EventDeserializer {
+    fromJson (event) {
+        if (event.isSeason) {
+            return new Season(event)
+        }
+        return new Event(event)
+    }
+}
+
+module.exports = EventDeserializer

package/src/Events/Events.js

@@ -4,11 +4,11 @@ const EventObjectInfo = require('./EventObjectInfo.js')
 const StatusChange = require('./StatusChange.js')
 const BestAvailableObjects = require('./BestAvailableObjects.js')
 const ChangeObjectStatusResult = require('./ChangeObjectStatusResult.js')
-const Event = require('./Event.js')
+const EventDeserializer = require('./EventDeserializer')
 
 class Events {
     /**
-     * @param {SeatsioClient} client
+     * @param {Axios} client
      */
     constructor (client) {
         this.client = client
@@ -40,7 +40,7 @@ class Events {
         }
 
         return this.client.post('/events', requestParameters)
-            .then((res) => new Event(res.data))
+            .then((res) => new EventDeserializer().fromJson(res.data))
     }
 
     /**
@@ -49,7 +49,7 @@ class Events {
      */
     retrieve (eventKey) {
         return this.client.get(`/events/${encodeURIComponent(eventKey)}`)
-            .then((res) => new Event(res.data))
+            .then((res) => new EventDeserializer().fromJson(res.data))
     }
 
     updateChannels (eventKey, channels) {
@@ -137,7 +137,7 @@ class Events {
      */
     iterator () {
         return new Lister('/events', this.client, 'events', (data) => {
-            const events = data.items.map(eventData => new Event(eventData))
+            const events = data.items.map(eventData => new EventDeserializer().fromJson(eventData))
             return new Page(events, data.next_page_starts_after, data.previous_page_ends_before)
         })
     }

package/src/Events/StatusChange.js

@@ -13,6 +13,8 @@ class StatusChange {
         this.extraData = statusChange.extraData ? statusChange.extraData : null
         this.holdToken = statusChange.holdToken ? statusChange.holdToken : null
         this.origin = statusChange.origin
+        this.isPresentOnChart = statusChange.isPresentOnChart
+        this.displayedLabel = statusChange.displayedLabel ? statusChange.displayedLabel : null
     }
 }
 

package/src/Invitations/Invitations.js

@@ -2,7 +2,7 @@ const Invitation = require('./Invitation.js')
 
 class Invitations {
     /**
-     * @param {SeatsioClient} client
+     * @param {Axios} client
      */
     constructor (client) {
         this.client = client

package/src/Reports/ChartReports.js

@@ -25,11 +25,11 @@ class ChartReports {
 
     /**
      * @param {string} chartKey
+     * @param {string} bookWholeTables
      * @returns {Object} JSON response from the server
      */
-    summaryByObjectType (chartKey) {
-        return this.client.get(ChartReports.summaryReportUrl('byObjectType', chartKey))
-            .then((res) => res.data)
+    summaryByObjectType (chartKey, bookWholeTables = undefined) {
+        return this.fetchSummaryReport('byObjectType', chartKey, bookWholeTables)
     }
 
     /**
@@ -43,11 +43,11 @@ class ChartReports {
 
     /**
      * @param {string} chartKey
+     * @param {string} bookWholeTables
      * @returns {Object} JSON response from the server
      */
-    summaryByCategoryLabel (chartKey) {
-        return this.client.get(ChartReports.summaryReportUrl('byCategoryLabel', chartKey))
-            .then((res) => res.data)
+    summaryByCategoryLabel (chartKey, bookWholeTables = undefined) {
+        return this.fetchSummaryReport('byCategoryLabel', chartKey, bookWholeTables)
     }
 
     /**
@@ -61,11 +61,11 @@ class ChartReports {
 
     /**
      * @param {string} chartKey
+     * @param {string} bookWholeTables
      * @returns {Object} JSON response from the server
      */
-    summaryByCategoryKey (chartKey) {
-        return this.client.get(ChartReports.summaryReportUrl('byCategoryKey', chartKey))
-            .then((res) => res.data)
+    summaryByCategoryKey (chartKey, bookWholeTables = undefined) {
+        return this.fetchSummaryReport('byCategoryKey', chartKey, bookWholeTables)
     }
 
     /**
@@ -79,20 +79,21 @@ class ChartReports {
 
     /**
      * @param {string} chartKey
+     * @param {string} bookWholeTables
      * @returns {Object} JSON response from the server
      */
-    summaryBySection (chartKey) {
-        return this.client.get(ChartReports.summaryReportUrl('bySection', chartKey))
-            .then((res) => res.data)
+    summaryBySection (chartKey, bookWholeTables = undefined) {
+        return this.fetchSummaryReport('bySection', chartKey, bookWholeTables)
     }
 
-    fetchReport (reportType, eventKey, bookWholeTables) {
-        return this.client.get(`/reports/charts/${encodeURIComponent(eventKey)}/${reportType}`, { params: { bookWholeTables } })
+    fetchReport (reportType, chartKey, bookWholeTables) {
+        return this.client.get(`/reports/charts/${encodeURIComponent(chartKey)}/${reportType}`, { params: { bookWholeTables } })
             .then((res) => utilities.createChartReport(res.data))
     }
 
-    static summaryReportUrl (reportType, eventKey) {
-        return `/reports/charts/${encodeURIComponent(eventKey)}/${reportType}/summary`
+    fetchSummaryReport (reportType, chartKey, bookWholeTables) {
+        return this.client.get(`/reports/charts/${encodeURIComponent(chartKey)}/${reportType}/summary`, { params: { bookWholeTables } })
+            .then((res) => res.data)
     }
 }
 

package/src/Seasons/Season.js

@@ -0,0 +1,18 @@
+const Event = require('../Events/Event.js')
+
+class Season extends Event {
+    /**
+     * @param {object} season
+     */
+    constructor (season) {
+        super(season)
+        this.partialSeasonKeys = season.partialSeasonKeys
+        this.events = season.events ? season.events.map(e => new Event(e)) : undefined
+    }
+
+    isSeason () {
+        return true
+    }
+}
+
+module.exports = Season

package/src/Seasons/SeasonParams.js

@@ -0,0 +1,28 @@
+class SeasonParams {
+    key (key) {
+        this._key = key
+        return this
+    }
+
+    numberOfEvents (numberOfEvents) {
+        this._numberOfEvents = numberOfEvents
+        return this
+    }
+
+    eventKeys (eventKeys) {
+        this._eventKeys = eventKeys
+        return this
+    }
+
+    tableBookingConfig (tableBookingConfig) {
+        this._tableBookingConfig = tableBookingConfig
+        return this
+    }
+
+    socialDistancingRulesetKey (socialDistancingRulesetKey) {
+        this._socialDistancingRulesetKey = socialDistancingRulesetKey
+        return this
+    }
+}
+
+module.exports = SeasonParams

package/src/Seasons/Seasons.js

@@ -0,0 +1,122 @@
+const Season = require('./Season')
+
+class Seasons {
+    /**
+     * @param {Axios} client
+     * @param {SeatsioClient} seatsioClient
+     */
+    constructor (client, seatsioClient) {
+        this.client = client
+        this.seatsioClient = seatsioClient
+    }
+
+    /**
+     * @param {string} chartKey
+     * @param {?seasonParams} SeasonParams
+     * @returns {Promise<Season>}
+     */
+    create (chartKey, seasonParams = null) {
+        const requestParameters = {}
+
+        requestParameters.chartKey = chartKey
+
+        if (seasonParams !== null) {
+            if (seasonParams._key !== null) {
+                requestParameters.key = seasonParams._key
+            }
+
+            if (seasonParams._numberOfEvents !== null) {
+                requestParameters.numberOfEvents = seasonParams._numberOfEvents
+            }
+
+            if (seasonParams._eventKeys !== null) {
+                requestParameters.eventKeys = seasonParams._eventKeys
+            }
+
+            if (seasonParams._tableBookingConfig !== null) {
+                requestParameters.tableBookingConfig = seasonParams._tableBookingConfig
+            }
+
+            if (seasonParams._socialDistancingRulesetKey !== null) {
+                requestParameters.socialDistancingRulesetKey = seasonParams._socialDistancingRulesetKey
+            }
+        }
+
+        return this.client.post('/seasons', requestParameters)
+            .then((res) => new Season(res.data))
+    }
+
+    /**
+     * @param {string} topLevelSeasonKey
+     * @param {?string} partialSeasonKey
+     * @param {?string[]} eventKeys
+     * @returns {Promise<Season>}
+     */
+    createPartialSeason (topLevelSeasonKey, partialSeasonKey = null, eventKeys = null) {
+        const requestParameters = {}
+
+        if (partialSeasonKey !== null) {
+            requestParameters.key = partialSeasonKey
+        }
+
+        if (eventKeys !== null) {
+            requestParameters.eventKeys = eventKeys
+        }
+        return this.client.post(`/seasons/${encodeURIComponent(topLevelSeasonKey)}/partial-seasons`, requestParameters)
+            .then((res) => new Season(res.data))
+    }
+
+    /**
+     * @param {string} key
+     * @param {?number} numberOfEvents
+     * @param {?string[]} eventKeys
+     * @returns {Promise<Season>}
+     */
+    createEvents (key, numberOfEvents = null, eventKeys = null) {
+        const requestParameters = { }
+
+        if (numberOfEvents !== null) {
+            requestParameters.numberOfEvents = numberOfEvents
+        }
+
+        if (eventKeys !== null) {
+            requestParameters.eventKeys = eventKeys
+        }
+
+        return this.client.post(`/seasons/${encodeURIComponent(key)}/actions/create-events`, requestParameters)
+            .then((res) => new Season(res.data))
+    }
+
+    /**
+     * @param {string} topLevelSeasonKey
+     * @param {string} partialSeasonKey
+     * @param {string[]} eventKeys
+     * @returns {Promise<Season>}
+     */
+    addEventsToPartialSeason (topLevelSeasonKey, partialSeasonKey, eventKeys) {
+        const requestParameters = { eventKeys }
+        return this.client.post(`/seasons/${encodeURIComponent(topLevelSeasonKey)}/partial-seasons/${encodeURIComponent(partialSeasonKey)}/actions/add-events`, requestParameters)
+            .then((res) => new Season(res.data))
+    }
+
+    /**
+     * @param {string} topLevelSeasonKey
+     * @param {string} partialSeasonKey
+     * @param {string} eventKey
+     * @returns {Promise<Season>}
+     */
+    async removeEventFromPartialSeason (topLevelSeasonKey, partialSeasonKey, eventKey) {
+        return this.client.delete(`/seasons/${encodeURIComponent(topLevelSeasonKey)}/partial-seasons/${encodeURIComponent(partialSeasonKey)}/events/${encodeURIComponent(eventKey)}`)
+            .then((res) => new Season(res.data))
+    }
+
+    /**
+     * @param {string} key
+     * @returns {Promise<Season>}
+     */
+    retrieve (key) {
+        return this.seatsioClient.events.retrieve(key)
+    }
+}
+
+module.exports = Seasons

package/src/SeatsioClient.js

@@ -11,6 +11,7 @@ const EventReports = require('./Reports/EventReports.js')
 const UsageReports = require('./Reports/UsageReports.js')
 const errorResponseHandler = require('./errorInterceptor.js')
 const Axios = require('axios')
+const Seasons = require('./Seasons/Seasons')
 
 class SeatsioClient {
     constructor (region, secretKey, workspaceKey = null, extraHeaders = {}) {
@@ -22,7 +23,7 @@ class SeatsioClient {
         this.errInterceptor = this.client.interceptors.response.use(response => response, errorResponseHandler)
 
         this.charts = new Charts(this.client)
-        this.events = new Events(this.client)
+        this.events = new Events(this.client, this)
         this.subaccounts = new Subaccounts(this.client)
         this.workspaces = new Workspaces(this.client)
         this.users = new Users(this.client)
@@ -32,6 +33,7 @@ class SeatsioClient {
         this.chartReports = new ChartReports(this.client)
         this.eventReports = new EventReports(this.client)
         this.usageReports = new UsageReports(this.client)
+        this.seasons = new Seasons(this.client, this)
     }
 
     _axiosConfig (baseUrl, secretKey, workspaceKey, extraHeaders) {

package/src/Subaccounts/Subaccounts.js

@@ -5,7 +5,7 @@ const Chart = require('../Charts/Chart.js')
 
 class Subaccounts {
     /**
-     * @param {SeatsioClient} client
+     * @param {Axios} client
      */
     constructor (client) {
         this.client = client

package/src/Users/Users.js

@@ -4,7 +4,7 @@ const User = require('./User.js')
 
 class Users {
     /**
-     * @param {SeatsioClient} client
+     * @param {Axios} client
      */
     constructor (client) {
         this.client = client

package/src/Workspaces/Workspaces.js

@@ -4,7 +4,7 @@ const Workspace = require('./Workspace.js')
 
 class Workspaces {
     /**
-     * @param {SeatsioClient} client
+     * @param {Axios} client
      */
     constructor (client) {
         this.client = client

package/tests/chartReports/chartReportSummary.test.js

@@ -35,6 +35,41 @@ test('summaryByObjectType', async () => {
     })
 })
 
+test('summaryByObjectType_bookWholeTablesTrue', async () => {
+    const { client, user } = await testUtils.createTestUserAndClient()
+    const chartKey = testUtils.getChartKey()
+    await testUtils.createTestChartWithTables(chartKey, user.secretKey)
+
+    const report = await client.chartReports.summaryByObjectType(chartKey, 'true')
+
+    expect(report).toEqual({
+        seat: {
+            count: 0,
+            bySection: {},
+            byCategoryKey: {},
+            byCategoryLabel: {}
+        },
+        generalAdmission: {
+            count: 0,
+            bySection: {},
+            byCategoryKey: {},
+            byCategoryLabel: {}
+        },
+        table: {
+            count: 2,
+            bySection: { NO_SECTION: 2 },
+            byCategoryKey: { 9: 2 },
+            byCategoryLabel: { Cat1: 2 }
+        },
+        booth: {
+            count: 0,
+            bySection: {},
+            byCategoryKey: {},
+            byCategoryLabel: {}
+        }
+    })
+})
+
 test('summaryByCategoryKey', async () => {
     const { client, user } = await testUtils.createTestUserAndClient()
     const chartKey = testUtils.getChartKey()

package/tests/events/listAllEvents.test.js

@@ -1,7 +1,7 @@
 const testUtils = require('../testUtils.js')
 
 test('listAll events when there are more than 10 events)', async () => {
-    const { client, user } = await testUtils.createTestUserAndClient()
+    const { client } = await testUtils.createTestUserAndClient()
     const chart = await client.charts.create()
 
     const events = await testUtils.createArray(15, () => client.events.create(chart.key))
@@ -13,3 +13,18 @@ test('listAll events when there are more than 10 events)', async () => {
 
     expect(retrievedEventKeys.sort()).toEqual(events.map(e => e.key).sort())
 })
+
+test('list seasons', async () => {
+    const { client } = await testUtils.createTestUserAndClient()
+    const chart = await client.charts.create()
+    await client.seasons.create(chart.key)
+    await client.seasons.create(chart.key)
+    await client.seasons.create(chart.key)
+
+    const areSeasons = []
+    for await (const season of client.events.listAll()) {
+        areSeasons.push(season.isSeason())
+    }
+
+    expect(areSeasons).toEqual([true, true, true])
+})

package/tests/events/listAllStatusChanges.test.js

@@ -174,6 +174,8 @@ test('properties of status changes', async () => {
     expect(statusChange.value.eventId).toBe(event.id)
     expect(statusChange.value.extraData).toEqual({ foo: 'bar' })
     expect(statusChange.value.origin.type).toBe('API_CALL')
+    expect(statusChange.value.displayedLabel).toBe('A-1')
+    expect(statusChange.value.isPresentOnChart).toBe(true)
 })
 
 test('should list status changes with hold token', async () => {

package/tests/events/retrieveEvent.test.js

@@ -1,5 +1,6 @@
 const testUtils = require('../testUtils.js')
 const TableBookingConfig = require('../../src/Events/TableBookingConfig')
+const SeasonParams = require("../../src/Seasons/SeasonParams");
 
 test('should retrieve event', async () => {
     const { client, user } = await testUtils.createTestUserAndClient()
@@ -20,3 +21,25 @@ test('should retrieve event', async () => {
     expect(retrievedEvent.forSaleConfig).toBeFalsy()
     expect(retrievedEvent.updatedOn).toBeNull()
 })
+
+test('retrieve season', async () => {
+    const { client, user } = await testUtils.createTestUserAndClient()
+    const chartKey = testUtils.getChartKey()
+    await testUtils.createTestChart(chartKey, user.secretKey)
+    const season = await client.seasons.create(chartKey, new SeasonParams().eventKeys(['event1', 'event2']))
+    const partialSeason1 = await client.seasons.createPartialSeason(season.key)
+    const partialSeason2 = await client.seasons.createPartialSeason(season.key)
+
+    const retrievedSeason = await client.events.retrieve(season.key)
+
+    expect(retrievedSeason.key).toBeTruthy()
+    expect(retrievedSeason.id).toBeTruthy()
+    expect(retrievedSeason.partialSeasonKeys).toEqual([partialSeason1.key, partialSeason2.key])
+    expect(retrievedSeason.events.map(e => e.key)).toEqual(['event1', 'event2'])
+    expect(retrievedSeason.chartKey).toBe(chartKey)
+    expect(retrievedSeason.tableBookingConfig).toEqual(TableBookingConfig.inherit())
+    expect(retrievedSeason.supportsBestAvailable).toBe(true)
+    expect(retrievedSeason.createdOn).toBeInstanceOf(Date)
+    expect(retrievedSeason.forSaleConfig).toBeFalsy()
+    expect(retrievedSeason.updatedOn).toBeFalsy()
+})

package/tests/seasons/addEventsToPartialSeason.test.js

@@ -0,0 +1,13 @@
+const testUtils = require('../testUtils.js')
+const SeasonParams = require('../../src/Seasons/SeasonParams')
+
+test('add events to partial season', async () => {
+    const { client } = await testUtils.createTestUserAndClient()
+    const chart = await client.charts.create()
+    const season = await client.seasons.create(chart.key, new SeasonParams().eventKeys(['event1', 'event2']))
+    const partialSeason = await client.seasons.createPartialSeason(season.key)
+
+    const updatedPartialSeason = await client.seasons.addEventsToPartialSeason(season.key, partialSeason.key, ['event1', 'event2'])
+
+    expect(updatedPartialSeason.events.map(e => e.key)).toEqual(['event1', 'event2'])
+})

package/tests/seasons/createEventsInSeason.test.js

@@ -0,0 +1,21 @@
+const testUtils = require('../testUtils.js')
+
+test('create events in season by event keys', async () => {
+    const { client } = await testUtils.createTestUserAndClient()
+    const chart = await client.charts.create()
+    const season = await client.seasons.create(chart.key)
+
+    const updatedSeason = await client.seasons.createEvents(season.key, null, ['event1', 'event2'])
+
+    expect(updatedSeason.events.map(e => e.key)).toEqual(['event1', 'event2'])
+})
+
+test('create events in season by number of events', async () => {
+    const { client } = await testUtils.createTestUserAndClient()
+    const chart = await client.charts.create()
+    const season = await client.seasons.create(chart.key)
+
+    const updatedSeason = await client.seasons.createEvents(season.key, 2)
+
+    expect(updatedSeason.events.length).toBe(2)
+})

package/tests/seasons/createPartialSeason.test.js

@@ -0,0 +1,22 @@
+const testUtils = require('../testUtils.js')
+const SeasonParams = require('../../src/Seasons/SeasonParams')
+
+test('key can be passed in', async () => {
+    const { client } = await testUtils.createTestUserAndClient()
+    const chart = await client.charts.create()
+    const season = await client.seasons.create(chart.key)
+
+    const partialSeason = await client.seasons.createPartialSeason(season.key, 'aPartialSeason')
+
+    expect(partialSeason.key).toBe('aPartialSeason')
+})
+
+test('event keys can be passed in', async () => {
+    const { client } = await testUtils.createTestUserAndClient()
+    const chart = await client.charts.create()
+    const season = await client.seasons.create(chart.key, new SeasonParams().eventKeys(['event1', 'event2']))
+
+    const partialSeason = await client.seasons.createPartialSeason(season.key, null, ['event1', 'event2'])
+
+    expect(partialSeason.events.map(event => event.key)).toEqual(['event1', 'event2'])
+})

package/tests/seasons/createSeason.test.js

@@ -0,0 +1,72 @@
+const testUtils = require('../testUtils.js')
+const SocialDistancingRuleset = require('../../src/Charts/SocialDistancingRuleset.js')
+const TableBookingConfig = require('../../src/Events/TableBookingConfig')
+const SeasonParams = require('../../src/Seasons/SeasonParams')
+
+test('chart key is required', async () => {
+    const { client, user } = await testUtils.createTestUserAndClient()
+    const chartKey = testUtils.getChartKey()
+    await testUtils.createTestChart(chartKey, user.secretKey)
+
+    const season = await client.seasons.create(chartKey)
+
+    expect(season.partialSeasonKeys.length).toBe(0)
+    expect(season.events.length).toBe(0)
+    expect(season.id).toBeTruthy()
+    expect(season.key).toBe(season.key)
+    expect(season.chartKey).toBe(chartKey)
+    expect(season.tableBookingConfig).toEqual(TableBookingConfig.inherit())
+    expect(season.supportsBestAvailable).toBe(true)
+    expect(season.createdOn).toBeInstanceOf(Date)
+    expect(season.forSaleConfig).toBeFalsy()
+    expect(season.updatedOn).toBeFalsy()
+})
+
+test('key can be passed in', async () => {
+    const { client } = await testUtils.createTestUserAndClient()
+    const chart = await client.charts.create()
+
+    const season = await client.seasons.create(chart.key, new SeasonParams().key('aSeason'))
+
+    expect(season.key).toBe('aSeason')
+})
+
+test('number of events can be passed in', async () => {
+    const { client } = await testUtils.createTestUserAndClient()
+    const chart = await client.charts.create()
+
+    const season = await client.seasons.create(chart.key, new SeasonParams().numberOfEvents(2))
+
+    expect(season.events.length).toBe(2)
+})
+
+test('event keys can be passed in', async () => {
+    const { client } = await testUtils.createTestUserAndClient()
+    const chart = await client.charts.create()
+
+    const season = await client.seasons.create(chart.key, new SeasonParams().eventKeys(['event1', 'event2']))
+
+    expect(season.events.map(event => event.key)).toEqual(['event1', 'event2'])
+})
+
+test('table booking config can be passed in', async () => {
+    const { client, user } = await testUtils.createTestUserAndClient()
+    const chartKey = testUtils.getChartKey()
+    await testUtils.createTestChartWithTables(chartKey, user.secretKey)
+    const tableBookingConfig = TableBookingConfig.custom({ T1: 'BY_TABLE', T2: 'BY_SEAT' })
+
+    const season = await client.seasons.create(chartKey, new SeasonParams().tableBookingConfig(tableBookingConfig))
+
+    expect(season.tableBookingConfig).toEqual(tableBookingConfig)
+})
+
+test('social distancing ruleset key can be passed in', async () => {
+    const { client } = await testUtils.createTestUserAndClient()
+    const chart = await client.charts.create()
+    const rulesets = { ruleset1: SocialDistancingRuleset.ruleBased('My ruleset').build() }
+    await client.charts.saveSocialDistancingRulesets(chart.key, rulesets)
+
+    const season = await client.seasons.create(chart.key, new SeasonParams().socialDistancingRulesetKey('ruleset1'))
+
+    expect(season.socialDistancingRulesetKey).toBe('ruleset1')
+})

package/tests/seasons/removeEventsFromPartialSeason.test.js

@@ -0,0 +1,13 @@
+const testUtils = require('../testUtils.js')
+const SeasonParams = require('../../src/Seasons/SeasonParams')
+
+test('add events to partial season', async () => {
+    const { client } = await testUtils.createTestUserAndClient()
+    const chart = await client.charts.create()
+    const season = await client.seasons.create(chart.key, new SeasonParams().eventKeys(['event1', 'event2']))
+    const partialSeason = await client.seasons.createPartialSeason(season.key, null, ['event1', 'event2'])
+
+    const updatedPartialSeason = await client.seasons.removeEventFromPartialSeason(season.key, partialSeason.key, 'event2')
+
+    expect(updatedPartialSeason.events.map(e => e.key)).toEqual(['event1'])
+})

package/tests/seasons/retrieveSeason.test.js

@@ -0,0 +1,25 @@
+const testUtils = require('../testUtils.js')
+const TableBookingConfig = require('../../src/Events/TableBookingConfig')
+const SeasonParams = require('../../src/Seasons/SeasonParams')
+
+test('retrieve season', async () => {
+    const { client, user } = await testUtils.createTestUserAndClient()
+    const chartKey = testUtils.getChartKey()
+    await testUtils.createTestChart(chartKey, user.secretKey)
+    const season = await client.seasons.create(chartKey, new SeasonParams().eventKeys(['event1', 'event2']))
+    const partialSeason1 = await client.seasons.createPartialSeason(season.key)
+    const partialSeason2 = await client.seasons.createPartialSeason(season.key)
+
+    const retrievedSeason = await client.seasons.retrieve(season.key)
+
+    expect(retrievedSeason.key).toBeTruthy()
+    expect(retrievedSeason.id).toBeTruthy()
+    expect(retrievedSeason.partialSeasonKeys).toEqual([partialSeason1.key, partialSeason2.key])
+    expect(retrievedSeason.events.map(e => e.key)).toEqual(['event1', 'event2'])
+    expect(retrievedSeason.chartKey).toBe(chartKey)
+    expect(retrievedSeason.tableBookingConfig).toEqual(TableBookingConfig.inherit())
+    expect(retrievedSeason.supportsBestAvailable).toBe(true)
+    expect(retrievedSeason.createdOn).toBeInstanceOf(Date)
+    expect(retrievedSeason.forSaleConfig).toBeFalsy()
+    expect(retrievedSeason.updatedOn).toBeFalsy()
+})