seatsio 64.0.0 → 65.3.0

package/README.md

@@ -38,10 +38,31 @@ seatsio-js follows semver since v54.4.0.
 
 Please note that any version below v2 is not production ready.
 
-## Examples
+## Usage
+
+### General instructions
+
+To use this library, you'll need to create a `SeatsioClient`:
+
+```js
+import { SeatsioClient, Region } from 'seatsio'
+
+let client = new SeatsioClient(Region.EU(), <WORKSPACE SECRET KEY>)
+...
+```
+
+You can find your _workspace secret key_ in the [settings section of the workspace](https://app.seats.io/workspace-settings). It is important that you keep your _secret key_ private and not expose it in-browser calls unless it is password protected.
+
+The region should correspond to the region of your account:
+
+- `Region.EU()`: Europe
+- `Region.NA()`: North-America
+- `Region.SA()`: South-America
+- `Region.OC()`: Oceania
+
+If you're unsure about your region, have a look at your [company settings page](https://app.seats.io/company-settings).
 
 ### Creating a chart and an event
-Once you create a new `SeatsioClient` using your _secret key_, you can create _charts_ and then _events_. You can find your _secret key_ in the Settings section of your workspace: https://app.seats.io/workspace-settings. It is important that you keep your _secret key_ private and not expose it in-browser calls unless it is password protected.
 
 ```js
 import { SeatsioClient, Region } from 'seatsio'
@@ -154,6 +175,23 @@ A combination of filter, sorting order and sorting option is also possible.
 let parameter = new StatusChangesParams().withFilter('testFilter').sortByStatus().sortAscending()
 ```
 
+### Retrieving object category and status (and other information)
+
+```js
+import { SeatsioClient, Region } from 'seatsio'
+
+let client = new SeatsioClient(Region.EU(), <WORKSPACE SECRET KEY>)
+let objectInfos = await client.events.retrieveObjectInfos(event.key, ['A-1', 'A-2'])
+
+console.log(objectInfos['A-1'].categoryKey)
+console.log(objectInfos['A-1'].categoryLabel)
+console.log(objectInfos['A-1'].status)
+    
+console.log(objectInfos['A-2'].categoryKey)
+console.log(objectInfos['A-2'].categoryLabel)
+console.log(objectInfos['A-2'].status)
+```
+
 ### Event reports
 
 Want to know which seats of an event are booked, and which ones are free? That’s where reporting comes in handy.
@@ -224,12 +262,29 @@ let client = new SeatsioClient(Region.EU(), <COMPANY ADMIN KEY>)
 await client.workspaces.create('a workspace');
 ```
 
+### Creating a chart and an event with the company admin key
+
+```js
+import { SeatsioClient, Region } from 'seatsio'
+
+let client = new SeatsioClient(Region.EU(), <COMPANY ADMIN KEY>, <WORKSPACE PUBLIC KEY>)
+let chart = await client.charts.create()
+let event = await client.events.create(chart.key)
+console.log(`Created a chart with key ${chart.key} and an event with key: ${event.key}`)
+```
+
 ## Error Handling
-When an API call results in an error, a rejected promise is returned with the response received from the server. This response contains a message string describing what went wrong, and also two other properties:
+When an API call results in an error, a rejected promise is returned with a value that looks like
+
+```json
+{
+  "errors": [{ "code": "RATE_LIMIT_EXCEEDED", "message": "Rate limit exceeded" }],
+  "messages": ["Rate limit exceeded"],
+  "requestId": "123456",
+  "status": 429
+}
+```
 
-- `messages`: an array of error messages that the server returned. In most cases, this array will contain only one element.
-- `requestId`: the identifier of the request you made. Please mention this to us when you have questions, as it will make debugging easier.
-- 
 ## Rate limiting - exponential backoff
 
 This library supports [exponential backoff](https://en.wikipedia.org/wiki/Exponential_backoff).

package/package.json

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

package/src/Charts/ChartListParams.js

@@ -4,11 +4,13 @@ class ChartListParams {
      * @param {?string} tag
      * @param {?boolean} expandEvents
      * @param {?boolean} withValidation
+     * @param {?number} eventsLimit
      */
-    constructor (filter = null, tag = null, expandEvents = null, withValidation = false) {
+    constructor (filter = null, tag = null, expandEvents = null, withValidation = false, eventsLimit = null) {
         this.filter = filter
         this.tag = tag
         this.validation = withValidation
+        this.eventsLimit = eventsLimit
         if (expandEvents === true) {
             this.expand = 'events'
         }
@@ -43,6 +45,15 @@ class ChartListParams {
         return this
     }
 
+    /**
+     * @param {number} eventsLimit
+     * @returns {ChartListParams}
+     */
+    withEventsLimit (eventsLimit) {
+        this.eventsLimit = eventsLimit
+        return this
+    }
+
     /**
      *
      * @param {boolean} validation
@@ -58,7 +69,8 @@ class ChartListParams {
             tag: this.tag,
             expand: this.expand,
             filter: this.filter,
-            validation: this.validation
+            validation: this.validation,
+            eventsLimit: this.eventsLimit
         }
     }
 }

package/src/Events/EventObjectInfo.js

@@ -31,7 +31,8 @@ class EventObjectInfo {
         this.displayedObjectType = report.displayedObjectType
         this.leftNeighbour = report.leftNeighbour
         this.rightNeighbour = report.rightNeighbour
-        this.isSelectable = report.isSelectable
+        this.isAvailable = report.isAvailable
+        this.availabilityReason = report.availabilityReason
         this.isDisabledBySocialDistancing = report.isDisabledBySocialDistancing
         this.channel = report.channel
         this.distanceToFocalPoint = report.distanceToFocalPoint

package/src/Events/Events.js

@@ -272,12 +272,14 @@ class Events {
      * @param {?string[]} channelKeys
      * @param {?boolean} ignoreSocialDistancing
      * @returns {Promise<ChangeObjectStatusResult>}
+     * @param {?string[]} allowedPreviousStatuses
+     * @param {?string[]} rejectedPreviousStatuses
      */
-    changeObjectStatus (eventKeyOrKeys, objectOrObjects, status, holdToken = null, orderId = null, keepExtraData = null, ignoreChannels = null, channelKeys = null, ignoreSocialDistancing = null) {
-        const request = this.changeObjectStatusRequest(objectOrObjects, status, holdToken, orderId, keepExtraData, ignoreChannels, channelKeys, ignoreSocialDistancing)
+    changeObjectStatus (eventKeyOrKeys, objectOrObjects, status, holdToken = null, orderId = null, keepExtraData = null, ignoreChannels = null, channelKeys = null, ignoreSocialDistancing = null, allowedPreviousStatuses = null, rejectedPreviousStatuses = null) {
+        const request = this.changeObjectStatusRequest(objectOrObjects, status, holdToken, orderId, keepExtraData, ignoreChannels, channelKeys, ignoreSocialDistancing, allowedPreviousStatuses, rejectedPreviousStatuses)
         request.events = Array.isArray(eventKeyOrKeys) ? eventKeyOrKeys : [eventKeyOrKeys]
 
-        return this.client.post('/seasons/actions/change-object-status?expand=objects', request)
+        return this.client.post('/events/groups/actions/change-object-status?expand=objects', request)
             .then((res) => new ChangeObjectStatusResult(res.data.objects))
     }
 
@@ -287,7 +289,18 @@ class Events {
      */
     changeObjectStatusInBatch (statusChangeRequests) {
         const requests = statusChangeRequests.map(r => {
-            const json = this.changeObjectStatusRequest(r.objectOrObjects, r.status, r.holdToken, r.orderId, r.keepExtraData, r.ignoreChannels, r.channelKeys)
+            const json = this.changeObjectStatusRequest(
+                r.objectOrObjects,
+                r.status,
+                r.holdToken,
+                r.orderId,
+                r.keepExtraData,
+                r.ignoreChannels,
+                r.channelKeys,
+                null,
+                r.allowedPreviousStatuses,
+                r.rejectedPreviousStatuses
+            )
             json.event = r.eventKey
             return json
         })
@@ -297,7 +310,7 @@ class Events {
             .then((res) => res.data.results.map(r => new ChangeObjectStatusResult(r.objects)))
     }
 
-    changeObjectStatusRequest (objectOrObjects, status, holdToken, orderId, keepExtraData, ignoreChannels, channelKeys, ignoreSocialDistancing) {
+    changeObjectStatusRequest (objectOrObjects, status, holdToken, orderId, keepExtraData, ignoreChannels, channelKeys, ignoreSocialDistancing, allowedPreviousStatuses, rejectedPreviousStatuses) {
         const request = {}
         request.objects = this.normalizeObjects(objectOrObjects)
         request.status = status
@@ -319,6 +332,12 @@ class Events {
         if (ignoreSocialDistancing !== null) {
             request.ignoreSocialDistancing = ignoreSocialDistancing
         }
+        if (allowedPreviousStatuses !== null) {
+            request.allowedPreviousStatuses = allowedPreviousStatuses
+        }
+        if (rejectedPreviousStatuses !== null) {
+            request.rejectedPreviousStatuses = rejectedPreviousStatuses
+        }
         return request
     }
 

package/src/Events/StatusChangeRequest.js

@@ -8,8 +8,10 @@ class StatusChangeRequest {
      * @param {?boolean} keepExtraData
      * @param {?boolean} ignoreChannels
      * @param {?string[]} channelKeys
+     * @param {?string[]} allowedPreviousStatuses
+     * @param {?string[]} rejectedPreviousStatuses
      */
-    constructor (eventKey, objectOrObjects, status, holdToken, orderId, keepExtraData, ignoreChannels, channelKeys) {
+    constructor (eventKey, objectOrObjects, status, holdToken, orderId, keepExtraData, ignoreChannels, channelKeys, allowedPreviousStatuses, rejectedPreviousStatuses) {
         this.eventKey = eventKey
         this.objectOrObjects = objectOrObjects
         this.status = status
@@ -18,6 +20,8 @@ class StatusChangeRequest {
         this.keepExtraData = keepExtraData
         this.ignoreChannels = ignoreChannels
         this.channelKeys = channelKeys
+        this.allowedPreviousStatuses = allowedPreviousStatuses
+        this.rejectedPreviousStatuses = rejectedPreviousStatuses
     }
 }
 

package/src/Reports/ChartReports.js

@@ -5,11 +5,6 @@ class ChartReports {
         this.client = client
     }
 
-    fetchReport (reportType, eventKey, bookWholeTables) {
-        return this.client.get(`/reports/charts/${encodeURIComponent(eventKey)}/${reportType}`, { params: { bookWholeTables } })
-            .then((res) => utilities.createChartReport(res.data))
-    }
-
     /**
      * @param {string} chartKey
      * @param {string} bookWholeTables
@@ -28,6 +23,15 @@ class ChartReports {
         return this.fetchReport('byObjectType', chartKey, bookWholeTables)
     }
 
+    /**
+     * @param {string} chartKey
+     * @param {string} bookWholeTables
+     * @returns {Object} JSON response from the server
+     */
+    summaryByObjectType (chartKey, bookWholeTables = undefined) {
+        return this.fetchSummaryReport('byObjectType', chartKey, bookWholeTables)
+    }
+
     /**
      * @param {string} chartKey
      * @param {string} bookWholeTables
@@ -37,6 +41,15 @@ class ChartReports {
         return this.fetchReport('byCategoryLabel', chartKey, bookWholeTables)
     }
 
+    /**
+     * @param {string} chartKey
+     * @param {string} bookWholeTables
+     * @returns {Object} JSON response from the server
+     */
+    summaryByCategoryLabel (chartKey, bookWholeTables = undefined) {
+        return this.fetchSummaryReport('byCategoryLabel', chartKey, bookWholeTables)
+    }
+
     /**
      * @param {string} chartKey
      * @param {string} bookWholeTables
@@ -45,6 +58,43 @@ class ChartReports {
     byCategoryKey (chartKey, bookWholeTables = undefined) {
         return this.fetchReport('byCategoryKey', chartKey, bookWholeTables)
     }
+
+    /**
+     * @param {string} chartKey
+     * @param {string} bookWholeTables
+     * @returns {Object} JSON response from the server
+     */
+    summaryByCategoryKey (chartKey, bookWholeTables = undefined) {
+        return this.fetchSummaryReport('byCategoryKey', chartKey, bookWholeTables)
+    }
+
+    /**
+     * @param {string} chartKey
+     * @param {string} bookWholeTables
+     * @returns {Object.<string, ChartObjectInfo[]>}
+     */
+    bySection (chartKey, bookWholeTables = undefined) {
+        return this.fetchReport('bySection', chartKey, bookWholeTables)
+    }
+
+    /**
+     * @param {string} chartKey
+     * @param {string} bookWholeTables
+     * @returns {Object} JSON response from the server
+     */
+    summaryBySection (chartKey, bookWholeTables = undefined) {
+        return this.fetchSummaryReport('bySection', chartKey, bookWholeTables)
+    }
+
+    fetchReport (reportType, chartKey, bookWholeTables) {
+        return this.client.get(`/reports/charts/${encodeURIComponent(chartKey)}/${reportType}`, { params: { bookWholeTables } })
+            .then((res) => utilities.createChartReport(res.data))
+    }
+
+    fetchSummaryReport (reportType, chartKey, bookWholeTables) {
+        return this.client.get(`/reports/charts/${encodeURIComponent(chartKey)}/${reportType}/summary`, { params: { bookWholeTables } })
+            .then((res) => res.data)
+    }
 }
 
 module.exports = ChartReports

package/src/Reports/EventReports.js

@@ -167,20 +167,48 @@ class EventReports {
 
     /**
      * @param {string} eventKey
-     * @param {?string} selectability
+     * @param {?string} availability
      * @returns {Object.<string, ObjectInfo[]>}
      */
-    bySelectability (eventKey, selectability = null) {
-        return this.client.get(EventReports.reportUrl('bySelectability', eventKey, selectability))
+    byAvailability (eventKey, availability = null) {
+        return this.client.get(EventReports.reportUrl('byAvailability', eventKey, availability))
             .then((res) => utilities.createEventReport(res.data))
     }
 
+    /**
+     * @param {string} eventKey
+     * @param {?string} availabilityReason
+     * @returns {Object.<string, ObjectInfo[]>}
+     */
+    byAvailabilityReason (eventKey, availabilityReason = null) {
+        return this.client.get(EventReports.reportUrl('byAvailabilityReason', eventKey, availabilityReason))
+            .then((res) => utilities.createEventReport(res.data))
+    }
+
+    /**
+     * @param {string} eventKey
+     * @returns {Object} JSON response from the server
+     */
+    summaryByAvailability (eventKey) {
+        return this.client.get(EventReports.summaryReportUrl('byAvailability', eventKey))
+            .then((res) => res.data)
+    }
+
+    /**
+     * @param {string} eventKey
+     * @returns {Object} JSON response from the server
+     */
+    summaryByAvailabilityReason (eventKey) {
+        return this.client.get(EventReports.summaryReportUrl('byAvailabilityReason', eventKey))
+            .then((res) => res.data)
+    }
+
     /**
      * @param {string} eventKey
      * @returns {Object} JSON response from the server
      */
-    summaryBySelectability (eventKey) {
-        return this.client.get(EventReports.summaryReportUrl('bySelectability', eventKey))
+    deepSummaryByAvailability (eventKey) {
+        return this.client.get(EventReports.deepSummaryReportUrl('byAvailability', eventKey))
             .then((res) => res.data)
     }
 
@@ -188,8 +216,8 @@ class EventReports {
      * @param {string} eventKey
      * @returns {Object} JSON response from the server
      */
-    deepSummaryBySelectability (eventKey) {
-        return this.client.get(EventReports.deepSummaryReportUrl('bySelectability', eventKey))
+    deepSummaryByAvailabilityReason (eventKey) {
+        return this.client.get(EventReports.deepSummaryReportUrl('byAvailabilityReason', eventKey))
             .then((res) => res.data)
     }
 

package/src/errorInterceptor.js

@@ -4,10 +4,9 @@ function errorResponseHandler (error) {
             if (typeof error.response.data !== 'undefined' && error.response.data) {
                 reject(error.response.data)
             } else if (typeof error.response.statusText !== 'undefined' && error.response.statusText) {
-        reject(`${error.config.method} ${error.config.url} resulted in ${error.response.status}  ${error.response.statusText}  error`) // eslint-disable-line
+        reject(`${error.config.method} ${error.config.url} resulted in ${error.response.status} ${error.response.statusText} error`) // eslint-disable-line
             }
         } else {
-            console.log(error)
             reject(error)
         }
     })

package/tests/chartReports/chartReport.test.js

@@ -119,3 +119,14 @@ test('get report byCategoryLabel', async () => {
     expect(report.Cat1.length).toBe(17)
     expect(report.Cat2.length).toBe(17)
 })
+
+test('get report bySection', async () => {
+    const { client, user } = await testUtils.createTestUserAndClient()
+    const chartKey = testUtils.getChartKey()
+    await testUtils.createTestChartWithSections(chartKey, user.secretKey)
+
+    const report = await client.chartReports.bySection(chartKey)
+
+    expect(report['Section A'].length).toBe(36)
+    expect(report['Section B'].length).toBe(35)
+})

package/tests/chartReports/chartReportSummary.test.js

@@ -0,0 +1,155 @@
+const testUtils = require('../testUtils.js')
+
+test('summaryByObjectType', async () => {
+    const { client, user } = await testUtils.createTestUserAndClient()
+    const chartKey = testUtils.getChartKey()
+    await testUtils.createTestChart(chartKey, user.secretKey)
+
+    const report = await client.chartReports.summaryByObjectType(chartKey)
+
+    expect(report).toEqual({
+        seat: {
+            count: 32,
+            bySection: { NO_SECTION: 32 },
+            byCategoryKey: { 9: 16, 10: 16 },
+            byCategoryLabel: { Cat1: 16, Cat2: 16 }
+        },
+        generalAdmission: {
+            count: 200,
+            bySection: { NO_SECTION: 200 },
+            byCategoryKey: { 9: 100, 10: 100 },
+            byCategoryLabel: { Cat2: 100, Cat1: 100 }
+        },
+        table: {
+            count: 0,
+            bySection: {},
+            byCategoryKey: {},
+            byCategoryLabel: {}
+        },
+        booth: {
+            count: 0,
+            bySection: {},
+            byCategoryKey: {},
+            byCategoryLabel: {}
+        }
+    })
+})
+
+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()
+    await testUtils.createTestChart(chartKey, user.secretKey)
+
+    const report = await client.chartReports.summaryByCategoryKey(chartKey)
+
+    expect(report).toEqual({
+        9: {
+            count: 116,
+            bySection: { NO_SECTION: 116 },
+            byObjectType: {
+                generalAdmission: 100,
+                seat: 16
+            }
+        },
+        10: {
+            count: 116,
+            bySection: { NO_SECTION: 116 },
+            byObjectType: {
+                generalAdmission: 100,
+                seat: 16
+            }
+        },
+        NO_CATEGORY: {
+            count: 0,
+            bySection: {},
+            byObjectType: {}
+        }
+    })
+})
+
+test('summaryByCategoryLabel', async () => {
+    const { client, user } = await testUtils.createTestUserAndClient()
+    const chartKey = testUtils.getChartKey()
+    await testUtils.createTestChart(chartKey, user.secretKey)
+
+    const report = await client.chartReports.summaryByCategoryLabel(chartKey)
+
+    expect(report).toEqual({
+        Cat2: {
+            count: 116,
+            bySection: { NO_SECTION: 116 },
+            byObjectType: {
+                generalAdmission: 100,
+                seat: 16
+            }
+        },
+        Cat1: {
+            count: 116,
+            bySection: { NO_SECTION: 116 },
+            byObjectType: {
+                generalAdmission: 100,
+                seat: 16
+            }
+        },
+        NO_CATEGORY: {
+            count: 0,
+            bySection: {},
+            byObjectType: {}
+        }
+    })
+})
+
+test('summaryBySection', async () => {
+    const { client, user } = await testUtils.createTestUserAndClient()
+    const chartKey = testUtils.getChartKey()
+    await testUtils.createTestChart(chartKey, user.secretKey)
+
+    const report = await client.chartReports.summaryBySection(chartKey)
+
+    expect(report).toEqual({
+        NO_SECTION: {
+            count: 232,
+            byCategoryKey: { 9: 116, 10: 116 },
+            byCategoryLabel: { Cat2: 116, Cat1: 116 },
+            byObjectType: {
+                generalAdmission: 200,
+                seat: 32
+            }
+        }
+    })
+})

package/tests/charts/listAllCharts.test.js

@@ -2,7 +2,7 @@ const ChartListParams = require('../../src/Charts/ChartListParams.js')
 const testUtils = require('../testUtils.js')
 
 test('listAll when there are many charts', async () => {
-    const { client, user } = await testUtils.createTestUserAndClient()
+    const { client } = await testUtils.createTestUserAndClient()
     const charts = await testUtils.createArray(15, () => client.charts.create())
 
     const retrievedKeys = []
@@ -14,7 +14,7 @@ test('listAll when there are many charts', async () => {
 })
 
 test('listAll when there are no charts', async () => {
-    const { client, user } = await testUtils.createTestUserAndClient()
+    const { client } = await testUtils.createTestUserAndClient()
     const retrievedKeys = []
 
     for await (const chart of client.charts.listAll()) {
@@ -25,7 +25,7 @@ test('listAll when there are no charts', async () => {
 })
 
 test('listAll Charts with filter', async () => {
-    const { client, user } = await testUtils.createTestUserAndClient()
+    const { client } = await testUtils.createTestUserAndClient()
     const fooCharts = await testUtils.createArray(3, () => client.charts.create('foo'))
     await client.charts.create('bar')
     const params = new ChartListParams().withFilter('foo')
@@ -39,7 +39,7 @@ test('listAll Charts with filter', async () => {
 })
 
 test('listAll Charts with tag', async () => {
-    const { client, user } = await testUtils.createTestUserAndClient()
+    const { client } = await testUtils.createTestUserAndClient()
     const fooCharts = await testUtils.createArray(3, async () => {
         const chart = await client.charts.create()
         await client.charts.addTag(chart.key, 'foo')
@@ -58,7 +58,7 @@ test('listAll Charts with tag', async () => {
 })
 
 test('listAll Charts with tag and filter parameters', async () => {
-    const { client, user } = await testUtils.createTestUserAndClient()
+    const { client } = await testUtils.createTestUserAndClient()
     const chart1 = await client.charts.create('bar')
     const chart2 = await client.charts.create()
     const chart3 = await client.charts.create('bar')
@@ -77,7 +77,7 @@ test('listAll Charts with tag and filter parameters', async () => {
 })
 
 test('listAll Charts with expandEvents parameters', async () => {
-    const { client, user } = await testUtils.createTestUserAndClient()
+    const { client } = await testUtils.createTestUserAndClient()
     const chart1 = await client.charts.create()
     const chart2 = await client.charts.create()
     const promises = [
@@ -100,8 +100,26 @@ test('listAll Charts with expandEvents parameters', async () => {
     expect(retrievedKeys.sort()).toEqual(generatedEventKeys.sort())
 })
 
+test('listAll Charts with expandEvents parameters and eventsLimit', async () => {
+    const { client } = await testUtils.createTestUserAndClient()
+    const chart1 = await client.charts.create()
+    const event1 = await client.events.create(chart1.key)
+    const event2 = await client.events.create(chart1.key)
+    const event3 = await client.events.create(chart1.key)
+    const retrievedKeys = []
+    const params = new ChartListParams().withExpandEvents(true).withEventsLimit(2)
+
+    for await (const chart of client.charts.listAll(params)) {
+        for (const event of chart.events) {
+            retrievedKeys.push(event.key)
+        }
+    }
+
+    expect(retrievedKeys).toEqual([event3.key, event2.key])
+})
+
 test('list all charts with validation', async () => {
-    const { client, user } = await testUtils.createTestUserAndClient()
+    const { client } = await testUtils.createTestUserAndClient()
     await testUtils.createArray(3, () => client.charts.create())
     const params = new ChartListParams(...Array(3), true)
 
@@ -111,7 +129,7 @@ test('list all charts with validation', async () => {
 })
 
 test('list all charts without validation', async () => {
-    const { client, user } = await testUtils.createTestUserAndClient()
+    const { client } = await testUtils.createTestUserAndClient()
     await testUtils.createArray(3, () => client.charts.create())
     const params = new ChartListParams()
 

package/tests/eventReports/eventReport.test.js

@@ -37,7 +37,8 @@ test('report properties', async () => {
     expect(reportItem.displayedObjectType).toBe(undefined)
     expect(reportItem.leftNeighbour).toBe(undefined)
     expect(reportItem.rightNeighbour).toBe('A-2')
-    expect(reportItem.isSelectable).toBe(false)
+    expect(reportItem.isAvailable).toBe(false)
+    expect(reportItem.availabilityReason).toBe('booked')
     expect(reportItem.isDisabledBySocialDistancing).toBe(false)
     expect(reportItem.bookAsAWhole).toBe(undefined)
     expect(reportItem.distanceToFocalPoint).toBeTruthy()
@@ -252,7 +253,7 @@ test('report by object type', async () => {
     expect(report.booth.length).toBe(0)
 })
 
-test('report by selectability', async () => {
+test('report by availability', async () => {
     const { client, user } = await testUtils.createTestUserAndClient()
     const chartKey = testUtils.getChartKey()
     await testUtils.createTestChart(chartKey, user.secretKey)
@@ -261,13 +262,13 @@ test('report by selectability', async () => {
     await client.events.book(event.key, 'A-2', null, 'order1')
     await client.events.book(event.key, 'A-3', null, 'order2')
 
-    const report = await client.eventReports.bySelectability(event.key)
+    const report = await client.eventReports.byAvailability(event.key)
 
-    expect(report.selectable.length).toBe(31)
-    expect(report.not_selectable.length).toBe(3)
+    expect(report.available.length).toBe(31)
+    expect(report.not_available.length).toBe(3)
 })
 
-test('report by specific selectability', async () => {
+test('report by specific availability', async () => {
     const { client, user } = await testUtils.createTestUserAndClient()
     const chartKey = testUtils.getChartKey()
     await testUtils.createTestChart(chartKey, user.secretKey)
@@ -276,9 +277,38 @@ test('report by specific selectability', async () => {
     await client.events.book(event.key, 'A-2', null, 'order1')
     await client.events.book(event.key, 'A-3', null, 'order2')
 
-    const report = await client.eventReports.bySelectability(event.key, 'selectable')
+    const report = await client.eventReports.byAvailability(event.key, 'available')
 
-    expect(report.selectable.length).toBe(31)
+    expect(report.available.length).toBe(31)
+})
+
+test('report by availability reason', async () => {
+    const { client, user } = await testUtils.createTestUserAndClient()
+    const chartKey = testUtils.getChartKey()
+    await testUtils.createTestChart(chartKey, user.secretKey)
+    const event = await client.events.create(chartKey)
+    await client.events.book(event.key, 'A-1', null, 'order1')
+    await client.events.book(event.key, 'A-2', null, 'order1')
+    await client.events.book(event.key, 'A-3', null, 'order2')
+
+    const report = await client.eventReports.byAvailabilityReason(event.key)
+
+    expect(report.available.length).toBe(31)
+    expect(report.booked.length).toBe(3)
+})
+
+test('report by specific availability reason', async () => {
+    const { client, user } = await testUtils.createTestUserAndClient()
+    const chartKey = testUtils.getChartKey()
+    await testUtils.createTestChart(chartKey, user.secretKey)
+    const event = await client.events.create(chartKey)
+    await client.events.book(event.key, 'A-1', null, 'order1')
+    await client.events.book(event.key, 'A-2', null, 'order1')
+    await client.events.book(event.key, 'A-3', null, 'order2')
+
+    const report = await client.eventReports.byAvailabilityReason(event.key, 'booked')
+
+    expect(report.booked.length).toBe(3)
 })
 
 test('report by channel', async () => {

package/tests/eventReports/eventReportDeepSummary.test.js

@@ -70,18 +70,32 @@ test('deepSummaryBySection', async () => {
     expect(report.NO_SECTION.byCategoryLabel.Cat1.bySelectability.not_selectable).toEqual(1)
 })
 
-test('deepSummaryBySelectability', async () => {
+test('deepSummaryByAvailability', async () => {
     const { client, user } = await testUtils.createTestUserAndClient()
     const chartKey = testUtils.getChartKey()
     await testUtils.createTestChart(chartKey, user.secretKey)
     const event = await client.events.create(chartKey)
     await client.events.book(event.key, (new ObjectProperties('A-1')))
 
-    const report = await client.eventReports.deepSummaryBySelectability(event.key)
+    const report = await client.eventReports.deepSummaryByAvailability(event.key)
 
-    expect(report.not_selectable.count).toEqual(1)
-    expect(report.not_selectable.byCategoryLabel.Cat1.count).toEqual(1)
-    expect(report.not_selectable.byCategoryLabel.Cat1.bySection.NO_SECTION).toEqual(1)
+    expect(report.not_available.count).toEqual(1)
+    expect(report.not_available.byCategoryLabel.Cat1.count).toEqual(1)
+    expect(report.not_available.byCategoryLabel.Cat1.bySection.NO_SECTION).toEqual(1)
+})
+
+test('deepSummaryByAvailabilityReason', async () => {
+    const { client, user } = await testUtils.createTestUserAndClient()
+    const chartKey = testUtils.getChartKey()
+    await testUtils.createTestChart(chartKey, user.secretKey)
+    const event = await client.events.create(chartKey)
+    await client.events.book(event.key, (new ObjectProperties('A-1')))
+
+    const report = await client.eventReports.deepSummaryByAvailabilityReason(event.key)
+
+    expect(report.booked.count).toEqual(1)
+    expect(report.booked.byCategoryLabel.Cat1.count).toEqual(1)
+    expect(report.booked.byCategoryLabel.Cat1.bySection.NO_SECTION).toEqual(1)
 })
 
 test('deepSummaryByChannel', async () => {

package/tests/eventReports/eventReportSummary.test.js

@@ -17,6 +17,8 @@ test('summaryByStatus', async () => {
             count: 1,
             byCategoryKey: { 9: 1 },
             bySelectability: { not_selectable: 1 },
+            byAvailability: { not_available: 1 },
+            byAvailabilityReason: { booked: 1 },
             byCategoryLabel: { Cat1: 1 },
             byChannel: { NO_CHANNEL: 1 }
         },
@@ -26,6 +28,8 @@ test('summaryByStatus', async () => {
             count: 231,
             byCategoryKey: { 9: 115, 10: 116 },
             bySelectability: { selectable: 231 },
+            byAvailability: { available: 231 },
+            byAvailabilityReason: { available: 231 },
             byCategoryLabel: { Cat2: 116, Cat1: 115 },
             byChannel: { NO_CHANNEL: 231 }
         }
@@ -47,6 +51,8 @@ test('summaryByObjectType', async () => {
             count: 32,
             byCategoryKey: { 9: 16, 10: 16 },
             bySelectability: { selectable: 32 },
+            byAvailability: { available: 32 },
+            byAvailabilityReason: { available: 32 },
             byCategoryLabel: { Cat1: 16, Cat2: 16 },
             byChannel: { NO_CHANNEL: 32 }
         },
@@ -56,26 +62,32 @@ test('summaryByObjectType', async () => {
             byStatus: { free: 200 },
             byCategoryKey: { 9: 100, 10: 100 },
             bySelectability: { selectable: 200 },
+            byAvailability: { available: 200 },
+            byAvailabilityReason: { available: 200 },
             byCategoryLabel: { Cat2: 100, Cat1: 100 },
             byChannel: { NO_CHANNEL: 200 }
         },
         table: {
             count: 0,
-            bySection: { },
+            bySection: {},
             byStatus: {},
             byCategoryKey: {},
-            bySelectability: { },
+            bySelectability: {},
+            byAvailability: {},
+            byAvailabilityReason: {},
             byCategoryLabel: {},
-            byChannel: { }
+            byChannel: {}
         },
         booth: {
             count: 0,
-            bySection: { },
+            bySection: {},
             byStatus: {},
             byCategoryKey: {},
-            bySelectability: { },
+            bySelectability: {},
+            byAvailability: {},
+            byAvailabilityReason: {},
             byCategoryLabel: {},
-            byChannel: { }
+            byChannel: {}
         }
     })
 })
@@ -94,6 +106,8 @@ test('summaryByCategoryKey', async () => {
             count: 116,
             bySection: { NO_SECTION: 116 },
             bySelectability: { selectable: 115, not_selectable: 1 },
+            byAvailability: { available: 115, not_available: 1 },
+            byAvailabilityReason: { available: 115, booked: 1 },
             byStatus: { booked: 1, free: 115 },
             byChannel: { NO_CHANNEL: 116 },
             byObjectType: {
@@ -105,6 +119,8 @@ test('summaryByCategoryKey', async () => {
             count: 116,
             bySection: { NO_SECTION: 116 },
             bySelectability: { selectable: 116 },
+            byAvailability: { available: 116 },
+            byAvailabilityReason: { available: 116 },
             byStatus: { free: 116 },
             byChannel: { NO_CHANNEL: 116 },
             byObjectType: {
@@ -116,6 +132,8 @@ test('summaryByCategoryKey', async () => {
             count: 0,
             bySection: {},
             bySelectability: {},
+            byAvailability: {},
+            byAvailabilityReason: { },
             byStatus: {},
             byChannel: {},
             byObjectType: {}
@@ -137,6 +155,8 @@ test('summaryByCategoryLabel', async () => {
             count: 116,
             bySection: { NO_SECTION: 116 },
             bySelectability: { selectable: 116 },
+            byAvailability: { available: 116 },
+            byAvailabilityReason: { available: 116 },
             byStatus: { free: 116 },
             byChannel: { NO_CHANNEL: 116 },
             byObjectType: {
@@ -148,6 +168,8 @@ test('summaryByCategoryLabel', async () => {
             count: 116,
             bySection: { NO_SECTION: 116 },
             bySelectability: { selectable: 115, not_selectable: 1 },
+            byAvailability: { available: 115, not_available: 1 },
+            byAvailabilityReason: { available: 115, booked: 1 },
             byStatus: { booked: 1, free: 115 },
             byChannel: { NO_CHANNEL: 116 },
             byObjectType: {
@@ -159,6 +181,8 @@ test('summaryByCategoryLabel', async () => {
             count: 0,
             bySection: {},
             bySelectability: {},
+            byAvailability: {},
+            byAvailabilityReason: { },
             byStatus: {},
             byChannel: {},
             byObjectType: {}
@@ -179,6 +203,8 @@ test('summaryBySection', async () => {
             count: 232,
             byCategoryKey: { 9: 116, 10: 116 },
             bySelectability: { selectable: 231, not_selectable: 1 },
+            byAvailability: { available: 231, not_available: 1 },
+            byAvailabilityReason: { available: 231, booked: 1 },
             byStatus: { booked: 1, free: 231 },
             byCategoryLabel: { Cat2: 116, Cat1: 116 },
             byChannel: { NO_CHANNEL: 232 },
@@ -190,20 +216,62 @@ test('summaryBySection', async () => {
     })
 })
 
-test('summaryBySelectability', async () => {
+test('summaryByAvailability', async () => {
+    const { client, user } = await testUtils.createTestUserAndClient()
+    const chartKey = testUtils.getChartKey()
+    await testUtils.createTestChart(chartKey, user.secretKey)
+    const event = await client.events.create(chartKey)
+    await client.events.book(event.key, (new ObjectProperties('A-1')))
+
+    const report = await client.eventReports.summaryByAvailability(event.key)
+
+    expect(report).toEqual({
+        available: {
+            bySection: { NO_SECTION: 231 },
+            count: 231,
+            byCategoryKey: { 9: 115, 10: 116 },
+            bySelectability: { selectable: 231 },
+            byAvailabilityReason: { available: 231 },
+            byStatus: { free: 231 },
+            byCategoryLabel: { Cat2: 116, Cat1: 115 },
+            byChannel: { NO_CHANNEL: 231 },
+            byObjectType: {
+                generalAdmission: 200,
+                seat: 31
+            }
+        },
+        not_available: {
+            bySection: { NO_SECTION: 1 },
+            count: 1,
+            byCategoryKey: { 9: 1 },
+            bySelectability: { not_selectable: 1 },
+            byAvailabilityReason: { booked: 1 },
+            byStatus: { booked: 1 },
+            byCategoryLabel: { Cat1: 1 },
+            byChannel: { NO_CHANNEL: 1 },
+            byObjectType: {
+                seat: 1
+            }
+        }
+    })
+})
+
+test('summaryByAvailabilityReason', async () => {
     const { client, user } = await testUtils.createTestUserAndClient()
     const chartKey = testUtils.getChartKey()
     await testUtils.createTestChart(chartKey, user.secretKey)
     const event = await client.events.create(chartKey)
     await client.events.book(event.key, (new ObjectProperties('A-1')))
 
-    const report = await client.eventReports.summaryBySelectability(event.key)
+    const report = await client.eventReports.summaryByAvailabilityReason(event.key)
 
     expect(report).toEqual({
-        selectable: {
+        available: {
             bySection: { NO_SECTION: 231 },
             count: 231,
             byCategoryKey: { 9: 115, 10: 116 },
+            bySelectability: { selectable: 231 },
+            byAvailability: { available: 231 },
             byStatus: { free: 231 },
             byCategoryLabel: { Cat2: 116, Cat1: 115 },
             byChannel: { NO_CHANNEL: 231 },
@@ -212,16 +280,51 @@ test('summaryBySelectability', async () => {
                 seat: 31
             }
         },
-        not_selectable: {
+        booked: {
             bySection: { NO_SECTION: 1 },
             count: 1,
             byCategoryKey: { 9: 1 },
+            bySelectability: { not_selectable: 1 },
+            byAvailability: { not_available: 1 },
             byStatus: { booked: 1 },
             byCategoryLabel: { Cat1: 1 },
             byChannel: { NO_CHANNEL: 1 },
             byObjectType: {
                 seat: 1
             }
+        },
+        disabled_by_social_distancing: {
+            count: 0,
+            bySection: { },
+            byCategoryKey: { },
+            bySelectability: { },
+            byAvailability: { },
+            byStatus: { },
+            byCategoryLabel: { },
+            byChannel: { },
+            byObjectType: {}
+        },
+        not_for_sale: {
+            count: 0,
+            bySection: { },
+            byCategoryKey: { },
+            bySelectability: { },
+            byAvailability: { },
+            byStatus: { },
+            byCategoryLabel: { },
+            byChannel: { },
+            byObjectType: {}
+        },
+        reservedByToken: {
+            count: 0,
+            bySection: { },
+            byCategoryKey: { },
+            bySelectability: { },
+            byAvailability: { },
+            byStatus: { },
+            byCategoryLabel: { },
+            byChannel: { },
+            byObjectType: {}
         }
     })
 })
@@ -246,6 +349,8 @@ test('summaryByChannel', async () => {
             byStatus: { free: 230 },
             byCategoryLabel: { Cat2: 116, Cat1: 114 },
             bySelectability: { selectable: 230 },
+            byAvailabilityReason: { available: 230 },
+            byAvailability: { available: 230 },
             byObjectType: {
                 generalAdmission: 200,
                 seat: 30
@@ -258,6 +363,8 @@ test('summaryByChannel', async () => {
             byStatus: { free: 2 },
             byCategoryLabel: { Cat1: 2 },
             bySelectability: { selectable: 2 },
+            byAvailability: { available: 2 },
+            byAvailabilityReason: { available: 2 },
             byObjectType: {
                 seat: 2
             }

package/tests/events/changeObjectStatus.test.js

@@ -26,7 +26,8 @@ test('should change object status', async () => {
             hasRestrictedView: false,
             isCompanionSeat: false,
             rightNeighbour: 'A-2',
-            isSelectable: false,
+            isAvailable: false,
+            availabilityReason: 'lolzor',
             isDisabledBySocialDistancing: false,
             distanceToFocalPoint: 79.43847425150014
         }
@@ -228,3 +229,33 @@ test('should accept ignoreSocialDistancing', async () => {
     const objectInfo = await client.events.retrieveObjectInfo(event.key, 'A-1')
     expect(objectInfo.status).toBe(EventObjectInfo.BOOKED)
 })
+
+test('should accept allowedPreviousStatuses', async () => {
+    const { client, user } = await testUtils.createTestUserAndClient()
+    const chartKey = testUtils.getChartKey()
+    await testUtils.createTestChart(chartKey, user.secretKey)
+    const event = await client.events.create(chartKey)
+
+    try {
+        await client.events.changeObjectStatus(event.key, ['A-1'], EventObjectInfo.BOOKED, null, null, null, null, null, true, ['MustBeThisStatus'], null)
+        throw new Error('Should have failed')
+    } catch (e) {
+        expect(e.errors.length).toEqual(1)
+        expect(e.errors[0].code).toBe('ILLEGAL_STATUS_CHANGE')
+    }
+})
+
+test('should accept rejectedPreviousStatuses', async () => {
+    const { client, user } = await testUtils.createTestUserAndClient()
+    const chartKey = testUtils.getChartKey()
+    await testUtils.createTestChart(chartKey, user.secretKey)
+    const event = await client.events.create(chartKey)
+
+    try {
+        await client.events.changeObjectStatus(event.key, ['A-1'], EventObjectInfo.BOOKED, null, null, null, null, null, true, null, ['free'])
+        throw new Error('Should have failed')
+    } catch (e) {
+        expect(e.errors.length).toEqual(1)
+        expect(e.errors[0].code).toBe('ILLEGAL_STATUS_CHANGE')
+    }
+})

package/tests/events/changeObjectStatusInBatch.test.js

@@ -71,3 +71,37 @@ test('should accept ignoreChannels', async () => {
 
     expect(result[0].objects['A-1'].status).toBe('lolzor')
 })
+
+test('should accept allowedPreviousStatuses', async () => {
+    const { client, user } = await testUtils.createTestUserAndClient()
+    const chartKey = testUtils.getChartKey()
+    await testUtils.createTestChart(chartKey, user.secretKey)
+    const event = await client.events.create(chartKey)
+
+    try {
+        await client.events.changeObjectStatusInBatch([
+            new StatusChangeRequest(event.key, ['A-1'], 'lolzor', null, null, null, null, null, ['MustBeThisStatus'], null)
+        ])
+        throw new Error('Should have failed')
+    } catch (e) {
+        expect(e.errors.length).toEqual(1)
+        expect(e.errors[0].code).toBe('ILLEGAL_STATUS_CHANGE')
+    }
+})
+
+test('should accept rejectedPreviousStatuses', async () => {
+    const { client, user } = await testUtils.createTestUserAndClient()
+    const chartKey = testUtils.getChartKey()
+    await testUtils.createTestChart(chartKey, user.secretKey)
+    const event = await client.events.create(chartKey)
+
+    try {
+        await client.events.changeObjectStatusInBatch([
+            new StatusChangeRequest(event.key, ['A-1'], 'lolzor', null, null, null, true, null, null, ['free'])
+        ])
+        throw new Error('Should have failed')
+    } catch (e) {
+        expect(e.errors.length).toEqual(1)
+        expect(e.errors[0].code).toBe('ILLEGAL_STATUS_CHANGE')
+    }
+})

package/tests/exponentialBackoff.test.js

@@ -8,7 +8,7 @@ test('aborts eventually if server keeps returning 429', async () => {
         await client.client.get('/status/429')
         throw new Error('Should have failed')
     } catch (e) {
-        expect(e).toBe('get /status/429 resulted in 429  TOO MANY REQUESTS  error')
+        expect(e).toBe('get /status/429 resulted in 429 TOO MANY REQUESTS error')
         const waitTime = new Date().getTime() - start.getTime()
         expect(waitTime).toBeGreaterThan(10000)
         expect(waitTime).toBeLessThan(20000)
@@ -22,7 +22,7 @@ test('aborts directly if server returns error other than 429', async () => {
         await client.client.get('/status/400')
         throw new Error('Should have failed')
     } catch (e) {
-        expect(e).toBe('get /status/400 resulted in 400  BAD REQUEST  error')
+        expect(e).toBe('get /status/400 resulted in 400 BAD REQUEST error')
         const waitTime = new Date().getTime() - start.getTime()
         expect(waitTime).toBeLessThan(2000)
     }
@@ -35,7 +35,7 @@ test('aborts directly if server returns 429 but max retries 0', async () => {
         await client.client.get('/status/429')
         throw new Error('Should have failed')
     } catch (e) {
-        expect(e).toBe('get /status/429 resulted in 429  TOO MANY REQUESTS  error')
+        expect(e).toBe('get /status/429 resulted in 429 TOO MANY REQUESTS error')
         const waitTime = new Date().getTime() - start.getTime()
         expect(waitTime).toBeLessThan(2000)
     }