@tillhub/schemas 6.451.0 → 6.453.0

package/lib/v0/analytics/reports/stocks/index.js

@@ -89,19 +89,37 @@ module.exports.request = {
       minLength: 1,
       maxLength: 64
     },
+    as_of: {
+      type: 'string',
+      format: 'date-time',
+      example: '2025-12-31T22:59:59.999Z',
+      description:
+        'ISO 8601 cut-off (inclusive). When set, Quantity Available is the latest stock-book balance at this instant per product × location. Send this or the start/end pair, not both. Omit both modes to return current stock.'
+    },
     start: {
       type: 'string',
       format: 'date-time',
       example: '2026-05-07T22:00:00.000Z',
       description:
-        'Url-safe ISO 8601 start of the reporting window. Filters stock rows by `updated_at` when set. Also used as the report `date` when `end` is omitted.'
+        'Url-safe ISO 8601 start of the reporting window. Use with `end` as a pair to filter current stock rows by `updated_at`. Cannot be combined with `as_of`. Also used as the report `date` when `end` is omitted.'
     },
     end: {
       type: 'string',
       format: 'date-time',
       example: '2026-05-08T21:59:59.999Z',
       description:
-        'Url-safe ISO 8601 end of the reporting window. Filters stock rows by `updated_at` when set. Preferred source for the report `date` column when set.'
+        'Url-safe ISO 8601 end of the reporting window. Use with `start` as a pair to filter current stock rows by `updated_at`. Cannot be combined with `as_of`. Preferred source for the report `date` column when set.'
+    }
+  },
+  allOf: [
+    {
+      description: 'Clients send either as_of or the start/end pair, not both.',
+      not: {
+        anyOf: [
+          { required: ['as_of', 'start'] },
+          { required: ['as_of', 'end'] }
+        ]
+      }
     }
-  }
+  ]
 }

package/lib/v0/service_categories/base.js

@@ -1,6 +1,9 @@
 const base = require('../product_groups/base')
 const { oneOf } = require('../../helpers/payload-or-null')
 
+const DEPRECATION_NOTICE =
+  'Service Categories v0 are deprecated, use v1 schemas instead'
+
 const request = {
   ...base.request,
   properties: {
@@ -21,10 +24,13 @@ const request = {
       default: false
     }
   },
-  required: ['name']
+  required: ['name'],
+  deprecated: true,
+  description: DEPRECATION_NOTICE
 }
 
 module.exports = {
+  DEPRECATION_NOTICE,
   request,
   response: {
     ...request,
@@ -37,6 +43,8 @@ module.exports = {
         example: '05297f58-3408-44d0-8bf4-125d4e86c08a'
       },
       ...request.properties
-    }
+    },
+    deprecated: true,
+    description: DEPRECATION_NOTICE
   }
 }

package/lib/v0/service_categories/create.response.js

@@ -1,8 +1,10 @@
-const { response } = require('./base')
+const { response, DEPRECATION_NOTICE } = require('./base')
 const commonResponse = require('../../common/response')
 
 module.exports = {
   $id: 'https://schemas.tillhub.com/v0/service_categories.create.response.schema.json',
   $schema: 'http://json-schema.org/draft-07/schema#',
-  ...commonResponse({ resultItems: response })
+  ...commonResponse({ resultItems: response }),
+  deprecated: true,
+  description: DEPRECATION_NOTICE
 }

package/lib/v0/service_categories/update.response.js

@@ -1,8 +1,10 @@
-const { response } = require('./base')
+const { response, DEPRECATION_NOTICE } = require('./base')
 const commonResponse = require('../../common/response')
 
 module.exports = {
   $id: 'https://schemas.tillhub.com/v0/service_categories.update.response.schema.json',
   $schema: 'http://json-schema.org/draft-07/schema#',
-  ...commonResponse({ resultItems: response })
+  ...commonResponse({ resultItems: response }),
+  deprecated: true,
+  description: DEPRECATION_NOTICE
 }

package/lib/v0/services/create.request.js

@@ -1,4 +1,5 @@
 const base = require('../products/create')
+const { DEPRECATION_NOTICE } = require('./deprecation')
 const { oneOf } = require('../../helpers/payload-or-null')
 
 module.exports = {
@@ -44,6 +45,8 @@ module.exports = {
     }
   },
   required: ['name', 'duration', 'linked_product'],
+  deprecated: true,
+  description: DEPRECATION_NOTICE,
   $id: 'https://schemas.tillhub.com/v0/services.create.request.schema.json',
   $schema: 'http://json-schema.org/draft-07/schema#'
 }

package/lib/v0/services/create.response.js

@@ -1,4 +1,5 @@
 const request = require('./create.request')
+const { DEPRECATION_NOTICE } = require('./deprecation')
 const commonResponse = require('../../common/response')
 
 const response = {
@@ -18,5 +19,7 @@ const response = {
 module.exports = {
   $id: 'https://schemas.tillhub.com/v0/services.create.response.schema.json',
   $schema: 'http://json-schema.org/draft-07/schema#',
-  ...commonResponse({ resultItems: response })
+  ...commonResponse({ resultItems: response }),
+  deprecated: true,
+  description: DEPRECATION_NOTICE
 }

package/lib/v0/services/deprecation.js

@@ -0,0 +1,3 @@
+module.exports = {
+  DEPRECATION_NOTICE: 'Services v0 are deprecated, use v1 schemas instead'
+}

package/lib/v0/services/update.request.js

@@ -1,4 +1,5 @@
 const base = require('../products/update')
+const { DEPRECATION_NOTICE } = require('./deprecation')
 const { oneOf } = require('../../helpers/payload-or-null')
 
 module.exports = {
@@ -43,6 +44,8 @@ module.exports = {
     }
   },
   required: [],
+  deprecated: true,
+  description: DEPRECATION_NOTICE,
   $id: 'https://schemas.tillhub.com/v0/services.update.request.schema.json',
   $schema: 'http://json-schema.org/draft-07/schema#'
 }

package/lib/v0/services/update.response.js

@@ -1,4 +1,5 @@
 const request = require('./update.request')
+const { DEPRECATION_NOTICE } = require('./deprecation')
 const commonResponse = require('../../common/response')
 
 const response = {
@@ -18,5 +19,7 @@ const response = {
 module.exports = {
   $id: 'https://schemas.tillhub.com/v0/services.update.response.schema.json',
   $schema: 'http://json-schema.org/draft-07/schema#',
-  ...commonResponse({ resultItems: response })
+  ...commonResponse({ resultItems: response }),
+  deprecated: true,
+  description: DEPRECATION_NOTICE
 }

package/lib/v0/vouchers/query.js

@@ -135,20 +135,21 @@ module.exports = {
     format: 'date-time'
   },
   system: {
-    oneOf: [
-      {
-        type: 'array',
-        minItems: 1,
-        items: {
-          type: 'string',
-          format: 'uuid'
-        }
-      },
-      {
-        type: 'string',
-        format: 'uuid'
-      }
-    ]
+    type: 'string',
+    format: 'uuid'
+  },
+  voucher_system: {
+    type: 'string',
+    format: 'uuid'
+  },
+  systems: {
+    type: 'array',
+    minItems: 1,
+    maxItems: 50,
+    items: {
+      type: 'string',
+      format: 'uuid'
+    }
   },
   location: {
     oneOf: [

package/lib/v1/configurations/items/reservations.js

@@ -161,6 +161,107 @@ module.exports = oneOf({
         }
       }
     },
+    opening_hours_exceptions: {
+      description: 'Additive Open or Closed exceptions over a date range, optionally limited to selected weekdays. Closed is full day only. 0 = Monday … 6 = Sunday.',
+      type: 'array',
+      items: {
+        type: 'object',
+        additionalProperties: false,
+        required: ['type', 'start_date', 'end_date'],
+        properties: {
+          type: {
+            type: 'string',
+            enum: ['open', 'closed']
+          },
+          start_date: {
+            type: 'string',
+            format: 'date'
+          },
+          end_date: {
+            type: 'string',
+            format: 'date'
+          },
+          weekdays: {
+            type: 'array',
+            items: {
+              type: 'integer',
+              minimum: 0,
+              maximum: 6
+            }
+          },
+          from: {
+            oneOf: [
+              { type: 'null' },
+              { type: 'string', pattern: '^([01]\\d|2[0-3]):[0-5]\\d$' }
+            ]
+          },
+          to: {
+            oneOf: [
+              { type: 'null' },
+              { type: 'string', pattern: '^([01]\\d|2[0-3]):[0-5]\\d$' }
+            ]
+          },
+          break_from: {
+            oneOf: [
+              { type: 'null' },
+              { type: 'string', pattern: '^([01]\\d|2[0-3]):[0-5]\\d$' }
+            ]
+          },
+          break_to: {
+            oneOf: [
+              { type: 'null' },
+              { type: 'string', pattern: '^([01]\\d|2[0-3]):[0-5]\\d$' }
+            ]
+          },
+          reason: {
+            type: 'string'
+          }
+        },
+        allOf: [
+          {
+            if: {
+              properties: {
+                type: { const: 'closed' }
+              },
+              required: ['type']
+            },
+            then: {
+              properties: {
+                from: { type: 'null' },
+                to: { type: 'null' },
+                break_from: { type: 'null' },
+                break_to: { type: 'null' }
+              }
+            }
+          },
+          {
+            if: {
+              properties: {
+                type: { const: 'open' }
+              },
+              required: ['type']
+            },
+            then: {
+              oneOf: [
+                {
+                  properties: {
+                    from: { type: 'null' },
+                    to: { type: 'null' }
+                  }
+                },
+                {
+                  properties: {
+                    from: { type: 'string' },
+                    to: { type: 'string' }
+                  },
+                  required: ['from', 'to']
+                }
+              ]
+            }
+          }
+        ]
+      }
+    },
     appointment_reminder: {
       type: 'boolean'
     },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tillhub/schemas",
-  "version": "6.451.0",
+  "version": "6.453.0",
   "private": false,
   "description": "All Tillhub API OpenAPI 3 compatible JSON Schemas.",
   "main": "./lib/index.js",

package/test/analytics/reports/stocks/stocks.v0.spec.js

@@ -0,0 +1,51 @@
+const test = require('tape')
+const Ajv = require('ajv')
+const validate = require('../../../helpers/validate-schema')
+const stocksSchema = require('../../../../lib/v0/analytics/reports/stocks')
+
+const ajv = new Ajv()
+const validateRequest = ajv.compile(stocksSchema.request)
+
+const AS_OF = '2025-12-31T22:59:59.999Z'
+const START = '2026-05-07T22:00:00.000Z'
+const END = '2026-05-08T21:59:59.999Z'
+
+test('analytics:reports:stocks:v0: request schema is valid', function (t) {
+  t.plan(2)
+  const { valid, error } = validate(stocksSchema.request)
+  t.ok(valid, 'request schema is valid')
+  t.error(error, 'should not get any error')
+  t.end()
+})
+
+test('analytics:reports:stocks:v0: accepts as_of without start/end', function (t) {
+  t.plan(1)
+  t.ok(validateRequest({ as_of: AS_OF }), 'as_of alone is valid')
+  t.end()
+})
+
+test('analytics:reports:stocks:v0: accepts the start/end pair without as_of', function (t) {
+  t.plan(1)
+  t.ok(validateRequest({ start: START, end: END }), 'start/end pair is valid')
+  t.end()
+})
+
+test('analytics:reports:stocks:v0: accepts omitting both date modes', function (t) {
+  t.plan(1)
+  t.ok(validateRequest({}), 'current stock without as_of or start/end is valid')
+  t.end()
+})
+
+test('analytics:reports:stocks:v0: rejects as_of combined with start or end', function (t) {
+  t.plan(3)
+  t.notOk(validateRequest({ as_of: AS_OF, start: START }), 'as_of + start is invalid')
+  t.notOk(validateRequest({ as_of: AS_OF, end: END }), 'as_of + end is invalid')
+  t.notOk(validateRequest({ as_of: AS_OF, start: START, end: END }), 'as_of + start/end is invalid')
+  t.end()
+})
+
+test('analytics:reports:stocks:v0: rejects invalid as_of', function (t) {
+  t.plan(1)
+  t.notOk(validateRequest({ as_of: 'not-a-valid-iso8601' }), 'non-ISO as_of is invalid')
+  t.end()
+})

package/test/configurations/configurations.v1.spec.js

@@ -1,6 +1,11 @@
 const test = require('tape')
+const Ajv = require('ajv')
 const validate = require('../helpers/validate-schema')
 
+const ajv = new Ajv({ allErrors: true })
+const updateRequest = require('../../lib/v1/configurations').update.request
+const validateUpdatePayload = ajv.compile(updateRequest)
+
 test('Configurations: create schema validation', function (t) {
   t.plan(2)
   const createRequest = require('../../lib/v1/configurations').create.request
@@ -28,3 +33,111 @@ test('Configurations: patch schema validation', function (t) {
   t.error(error, 'should not get any error')
   t.end()
 })
+
+test('Configurations: opening_hours_exceptions accepts Open all-day, Open hours, and Closed full-day', function (t) {
+  t.plan(1)
+  const valid = validateUpdatePayload({
+    reservations: {
+      opening_hours_exceptions: [
+        {
+          type: 'open',
+          start_date: '2026-12-20',
+          end_date: '2026-12-20',
+          from: null,
+          to: null,
+          reason: 'Sunday brunch all day'
+        },
+        {
+          type: 'open',
+          start_date: '2026-07-02',
+          end_date: '2026-07-11',
+          weekdays: [1, 3],
+          from: '10:00',
+          to: '22:00',
+          break_from: null,
+          break_to: null,
+          reason: 'Summer Tue/Thu hours'
+        },
+        {
+          type: 'closed',
+          start_date: '2026-01-01',
+          end_date: '2026-03-31',
+          weekdays: [0, 1],
+          from: null,
+          to: null,
+          reason: 'Winter Mon/Tue closure'
+        }
+      ]
+    }
+  })
+  t.ok(valid, ajv.errorsText(validateUpdatePayload.errors))
+  t.end()
+})
+
+test('Configurations: opening_hours_exceptions rejects Closed with specific hours', function (t) {
+  t.plan(1)
+  const valid = validateUpdatePayload({
+    reservations: {
+      opening_hours_exceptions: [
+        {
+          type: 'closed',
+          start_date: '2026-01-01',
+          end_date: '2026-01-01',
+          from: '10:00',
+          to: '18:00'
+        }
+      ]
+    }
+  })
+  t.notOk(valid, 'Closed exceptions must be full day (from/to null)')
+  t.end()
+})
+
+test('Configurations: opening_hours_exceptions rejects mixed Open from/to', function (t) {
+  t.plan(1)
+  const valid = validateUpdatePayload({
+    reservations: {
+      opening_hours_exceptions: [
+        {
+          type: 'open',
+          start_date: '2026-12-20',
+          end_date: '2026-12-20',
+          from: '10:00',
+          to: null
+        }
+      ]
+    }
+  })
+  t.notOk(valid, 'Open from/to must both be null or both be set')
+  t.end()
+})
+
+test('Configurations: opening_hours_exceptions rejects invalid HH:mm times', function (t) {
+  t.plan(1)
+  const valid = validateUpdatePayload({
+    reservations: {
+      opening_hours_exceptions: [
+        {
+          type: 'open',
+          start_date: '2026-12-20',
+          end_date: '2026-12-20',
+          from: '25:00',
+          to: '26:00'
+        }
+      ]
+    }
+  })
+  t.notOk(valid, 'Open from/to must match HH:mm')
+  t.end()
+})
+
+test('Configurations: payloads without opening_hours_exceptions remain valid', function (t) {
+  t.plan(1)
+  const valid = validateUpdatePayload({
+    reservations: {
+      opening_hours: []
+    }
+  })
+  t.ok(valid, ajv.errorsText(validateUpdatePayload.errors))
+  t.end()
+})