@tillhub/schemas 6.452.0 → 6.454.0

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/lib/v1/gastro_orders/deltas/query.js

@@ -0,0 +1,31 @@
+module.exports = {
+  $id: 'https://schemas.tillhub.com/v1/gastro_orders.deltas.query.request.schema.json',
+  $schema: 'http://json-schema.org/draft-07/schema#',
+  type: 'object',
+  additionalProperties: false,
+  required: [],
+  properties: {
+    order: {
+      type: 'string',
+      format: 'uuid'
+    },
+    start: {
+      type: 'string',
+      format: 'date-time',
+      example: '2026-08-27T14:55:05.000Z'
+    },
+    end: {
+      type: 'string',
+      format: 'date-time',
+      example: '2026-08-27T14:55:05.000Z'
+    },
+    limit: {
+      type: 'integer',
+      minimum: 1
+    },
+    offset: {
+      type: 'integer',
+      minimum: 1
+    }
+  }
+}

package/lib/v1/gastro_orders/index.js

@@ -1,6 +1,14 @@
 const commonResponse = require('../../common/response')
 
 module.exports.deltas = {
+  query: {
+    request: require('./deltas/query'),
+    response: {
+      $id: 'https://schemas.tillhub.com/v1/gastro_orders.deltas.get.response.schema.json',
+      $schema: 'http://json-schema.org/draft-07/schema#',
+      ...commonResponse({ resultItems: require('./deltas/response') })
+    }
+  },
   create: {
     request: require('./deltas/create.request'),
     response: {

package/package.json

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

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()
+})