@tillhub/schemas 6.455.0 → 6.456.0

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

@@ -162,12 +162,12 @@ 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.',
+      description: 'Additive Open or Closed exceptions over a date range, optionally limited to selected weekdays. Closed is full day only. 0 = Monday … 6 = Sunday. `from` and `to` are required keys on every item: omit neither. Open all-day is `from: null` and `to: null` (both present). Open specific hours requires both as HH:mm. Closed requires `from: null` and `to: null`.',
       type: 'array',
       items: {
         type: 'object',
         additionalProperties: false,
-        required: ['type', 'start_date', 'end_date'],
+        required: ['type', 'start_date', 'end_date', 'from', 'to'],
         properties: {
           type: {
             type: 'string',
@@ -190,12 +190,14 @@ module.exports = oneOf({
             }
           },
           from: {
+            description: 'Required. Open all-day: must be null together with `to` (the key must still be present). Open specific hours: HH:mm start, with `to` also set. Closed: always null.',
             oneOf: [
               { type: 'null' },
               { type: 'string', pattern: '^([01]\\d|2[0-3]):[0-5]\\d$' }
             ]
           },
           to: {
+            description: 'Required. Open all-day: must be null together with `from` (the key must still be present). Open specific hours: HH:mm end, with `from` also set and earlier than `to`. Closed: always null. Omitting this key is invalid and is not treated as all-day.',
             oneOf: [
               { type: 'null' },
               { type: 'string', pattern: '^([01]\\d|2[0-3]):[0-5]\\d$' }
@@ -226,6 +228,7 @@ module.exports = oneOf({
               required: ['type']
             },
             then: {
+              required: ['from', 'to'],
               properties: {
                 from: { type: 'null' },
                 to: { type: 'null' },
@@ -244,12 +247,15 @@ module.exports = oneOf({
             then: {
               oneOf: [
                 {
+                  description: 'Open all day: from and to must both be present and null (00:00–23:59). A break may sit strictly inside that window. Omitting either key is not all-day.',
+                  required: ['from', 'to'],
                   properties: {
                     from: { type: 'null' },
                     to: { type: 'null' }
                   }
                 },
                 {
+                  description: 'Open specific hours: from and to must both be present as HH:mm.',
                   properties: {
                     from: { type: 'string' },
                     to: { type: 'string' }

package/package.json

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

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

@@ -47,6 +47,16 @@ test('Configurations: opening_hours_exceptions accepts Open all-day, Open hours,
           to: null,
           reason: 'Sunday brunch all day'
         },
+        {
+          type: 'open',
+          start_date: '2026-12-21',
+          end_date: '2026-12-21',
+          from: null,
+          to: null,
+          break_from: '15:00',
+          break_to: '16:00',
+          reason: 'All day with afternoon break'
+        },
         {
           type: 'open',
           start_date: '2026-07-02',
@@ -93,6 +103,40 @@ test('Configurations: opening_hours_exceptions rejects Closed with specific hour
   t.end()
 })
 
+test('Configurations: opening_hours_exceptions rejects omitted Open from/to keys', function (t) {
+  t.plan(1)
+  const valid = validateUpdatePayload({
+    reservations: {
+      opening_hours_exceptions: [
+        {
+          type: 'open',
+          start_date: '2026-12-20',
+          end_date: '2026-12-20'
+        }
+      ]
+    }
+  })
+  t.notOk(valid, 'Open from/to keys are required; omitted keys are not all-day')
+  t.end()
+})
+
+test('Configurations: opening_hours_exceptions rejects omitted Closed from/to keys', function (t) {
+  t.plan(1)
+  const valid = validateUpdatePayload({
+    reservations: {
+      opening_hours_exceptions: [
+        {
+          type: 'closed',
+          start_date: '2026-01-01',
+          end_date: '2026-01-01'
+        }
+      ]
+    }
+  })
+  t.notOk(valid, 'Closed from/to keys are required and must be null')
+  t.end()
+})
+
 test('Configurations: opening_hours_exceptions rejects mixed Open from/to', function (t) {
   t.plan(1)
   const valid = validateUpdatePayload({