@happychef/algorithm 1.3.0 → 1.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (71) hide show
  1. package/.claude/settings.local.json +16 -0
  2. package/.github/workflows/ci-cd.yml +80 -80
  3. package/BRANCH_PROTECTION_SETUP.md +167 -167
  4. package/CHANGELOG.md +8 -8
  5. package/README.md +144 -144
  6. package/RESERVERINGEN_GIDS.md +986 -986
  7. package/__tests__/crossMidnight.test.js +63 -0
  8. package/__tests__/crossMidnightTimeblocks.test.js +312 -0
  9. package/__tests__/edgeCases.test.js +271 -0
  10. package/__tests__/filters.test.js +276 -276
  11. package/__tests__/isDateAvailable.test.js +179 -175
  12. package/__tests__/isTimeAvailable.test.js +174 -168
  13. package/__tests__/restaurantData.test.js +422 -422
  14. package/__tests__/tableHelpers.test.js +247 -247
  15. package/assignTables.js +506 -444
  16. package/changes/2025/December/PR2___change.md +14 -14
  17. package/changes/2025/December/PR3_add__change.md +20 -20
  18. package/changes/2025/December/PR4___.md +15 -15
  19. package/changes/2025/December/PR5___.md +15 -15
  20. package/changes/2025/December/PR6__del_.md +17 -17
  21. package/changes/2025/December/PR7_add__change.md +21 -21
  22. package/changes/2026/February/PR15_add__change.md +21 -21
  23. package/changes/2026/February/PR16_add__.md +20 -0
  24. package/changes/2026/February/PR16_add_getDateClosingReasons.md +31 -31
  25. package/changes/2026/January/PR10_add__change.md +21 -21
  26. package/changes/2026/January/PR11_add__change.md +19 -19
  27. package/changes/2026/January/PR12_add__.md +21 -21
  28. package/changes/2026/January/PR13_add__change.md +20 -20
  29. package/changes/2026/January/PR14_add__change.md +19 -19
  30. package/changes/2026/January/PR8_add__change.md +38 -38
  31. package/changes/2026/January/PR9_add__change.md +19 -19
  32. package/dateHelpers.js +31 -0
  33. package/filters/maxArrivalsFilter.js +114 -114
  34. package/filters/maxGroupsFilter.js +221 -221
  35. package/filters/timeFilter.js +89 -89
  36. package/getAvailableTimeblocks.js +158 -158
  37. package/getDateClosingReasons.js +193 -193
  38. package/grouping.js +162 -162
  39. package/index.js +48 -43
  40. package/isDateAvailable.js +80 -80
  41. package/isDateAvailableWithTableCheck.js +172 -172
  42. package/isTimeAvailable.js +26 -26
  43. package/jest.config.js +23 -23
  44. package/package.json +27 -27
  45. package/processing/dailyGuestCounts.js +73 -73
  46. package/processing/mealTypeCount.js +133 -133
  47. package/processing/timeblocksAvailable.js +344 -182
  48. package/reservation_data/counter.js +82 -75
  49. package/restaurant_data/exceptions.js +150 -150
  50. package/restaurant_data/openinghours.js +142 -142
  51. package/simulateTableAssignment.js +833 -726
  52. package/tableHelpers.js +209 -209
  53. package/tables/time/parseTime.js +19 -19
  54. package/tables/time/shifts.js +7 -7
  55. package/tables/utils/calculateDistance.js +13 -13
  56. package/tables/utils/isTableFreeForAllSlots.js +14 -14
  57. package/tables/utils/isTemporaryTableValid.js +39 -39
  58. package/test/test_counter.js +194 -194
  59. package/test/test_dailyCount.js +81 -81
  60. package/test/test_datesAvailable.js +106 -106
  61. package/test/test_exceptions.js +172 -172
  62. package/test/test_isDateAvailable.js +330 -330
  63. package/test/test_mealTypeCount.js +54 -54
  64. package/test/test_timesAvailable.js +88 -88
  65. package/test-detailed-filter.js +100 -100
  66. package/test-lunch-debug.js +110 -110
  67. package/test-max-arrivals-filter.js +79 -79
  68. package/test-meal-stop-fix.js +147 -147
  69. package/test-meal-stop-simple.js +93 -93
  70. package/test-timezone-debug.js +47 -47
  71. package/test.js +336 -336
@@ -1,247 +1,247 @@
1
- const {
2
- parseTime,
3
- getMealTypeByTime,
4
- getAllTables,
5
- isTemporaryTableValid,
6
- shifts
7
- } = require('../tableHelpers');
8
-
9
- describe('tableHelpers - parseTime', () => {
10
- test('should parse valid time string correctly', () => {
11
- expect(parseTime('12:30')).toBe(750); // 12*60 + 30 = 750
12
- expect(parseTime('00:00')).toBe(0);
13
- expect(parseTime('23:59')).toBe(1439);
14
- });
15
-
16
- test('should return NaN for invalid time strings', () => {
17
- expect(parseTime('')).toBeNaN();
18
- expect(parseTime(null)).toBeNaN();
19
- expect(parseTime(undefined)).toBeNaN();
20
- expect(parseTime('25:00')).toBeNaN(); // Invalid hour
21
- expect(parseTime('12:60')).toBeNaN(); // Invalid minute
22
- expect(parseTime('12')).toBeNaN(); // Missing colon
23
- expect(parseTime('ab:cd')).toBeNaN(); // Not numbers
24
- });
25
-
26
- test('should handle edge cases', () => {
27
- expect(parseTime('0:0')).toBe(0);
28
- expect(parseTime('1:1')).toBe(61);
29
- });
30
- });
31
-
32
- describe('tableHelpers - getMealTypeByTime', () => {
33
- test('should identify breakfast times correctly', () => {
34
- expect(getMealTypeByTime('07:00')).toBe('breakfast');
35
- expect(getMealTypeByTime('09:30')).toBe('breakfast');
36
- expect(getMealTypeByTime('10:59')).toBe('breakfast');
37
- });
38
-
39
- test('should identify lunch times correctly', () => {
40
- expect(getMealTypeByTime('11:00')).toBe('lunch');
41
- expect(getMealTypeByTime('12:30')).toBe('lunch');
42
- expect(getMealTypeByTime('15:59')).toBe('lunch');
43
- });
44
-
45
- test('should identify dinner times correctly', () => {
46
- expect(getMealTypeByTime('16:00')).toBe('dinner');
47
- expect(getMealTypeByTime('18:30')).toBe('dinner');
48
- expect(getMealTypeByTime('22:59')).toBe('dinner');
49
- });
50
-
51
- test('should return null for times outside defined shifts', () => {
52
- expect(getMealTypeByTime('06:59')).toBeNull();
53
- expect(getMealTypeByTime('23:00')).toBeNull();
54
- expect(getMealTypeByTime('02:00')).toBeNull();
55
- });
56
-
57
- test('should return null for invalid time strings', () => {
58
- expect(getMealTypeByTime('invalid')).toBeNull();
59
- expect(getMealTypeByTime('')).toBeNull();
60
- expect(getMealTypeByTime(null)).toBeNull();
61
- });
62
- });
63
-
64
- describe('tableHelpers - getAllTables', () => {
65
- test('should extract tables correctly from restaurant data', () => {
66
- const restaurantData = {
67
- floors: [
68
- {
69
- tables: [
70
- {
71
- objectType: 'Tafel',
72
- id: 'table1',
73
- tableNumber: 1,
74
- minCapacity: 2,
75
- maxCapacity: 4,
76
- priority: 1,
77
- x: 10,
78
- y: 20,
79
- isTemporary: false
80
- },
81
- {
82
- objectType: 'Tafel',
83
- id: 'table2',
84
- tableNumber: { $numberInt: '2' },
85
- minCapacity: { $numberInt: '4' },
86
- maxCapacity: { $numberInt: '6' },
87
- priority: { $numberInt: '2' },
88
- x: { $numberInt: '30' },
89
- y: { $numberInt: '40' },
90
- isTemporary: false
91
- }
92
- ]
93
- }
94
- ]
95
- };
96
-
97
- const tables = getAllTables(restaurantData);
98
- expect(tables).toHaveLength(2);
99
- expect(tables[0].tableNumber).toBe(1);
100
- expect(tables[0].maxCapacity).toBe(4);
101
- expect(tables[1].tableNumber).toBe(2);
102
- expect(tables[1].maxCapacity).toBe(6);
103
- });
104
-
105
- test('should sort tables by maxCapacity, priority, and minCapacity', () => {
106
- const restaurantData = {
107
- floors: [
108
- {
109
- tables: [
110
- {
111
- objectType: 'Tafel',
112
- id: 'table1',
113
- tableNumber: 1,
114
- minCapacity: 2,
115
- maxCapacity: 6,
116
- priority: 1,
117
- x: 10,
118
- y: 20
119
- },
120
- {
121
- objectType: 'Tafel',
122
- id: 'table2',
123
- tableNumber: 2,
124
- minCapacity: 2,
125
- maxCapacity: 4,
126
- priority: 1,
127
- x: 30,
128
- y: 40
129
- }
130
- ]
131
- }
132
- ]
133
- };
134
-
135
- const tables = getAllTables(restaurantData);
136
- expect(tables[0].tableNumber).toBe(2); // Smaller maxCapacity comes first
137
- expect(tables[1].tableNumber).toBe(1);
138
- });
139
-
140
- test('should handle empty or missing data gracefully', () => {
141
- expect(getAllTables({})).toEqual([]);
142
- expect(getAllTables({ floors: [] })).toEqual([]);
143
- expect(getAllTables(null)).toEqual([]);
144
- });
145
-
146
- test('should filter out non-Tafel objects', () => {
147
- const restaurantData = {
148
- floors: [
149
- {
150
- tables: [
151
- {
152
- objectType: 'Wall',
153
- id: 'wall1',
154
- tableNumber: 1
155
- },
156
- {
157
- objectType: 'Tafel',
158
- id: 'table1',
159
- tableNumber: 2,
160
- minCapacity: 2,
161
- maxCapacity: 4,
162
- priority: 1,
163
- x: 10,
164
- y: 20
165
- }
166
- ]
167
- }
168
- ]
169
- };
170
-
171
- const tables = getAllTables(restaurantData);
172
- expect(tables).toHaveLength(1);
173
- expect(tables[0].tableNumber).toBe(2);
174
- });
175
- });
176
-
177
- describe('tableHelpers - isTemporaryTableValid', () => {
178
- test('should return true for non-temporary tables', () => {
179
- const table = {
180
- tableNumber: 1,
181
- isTemporary: false
182
- };
183
- expect(isTemporaryTableValid(table, '2025-06-15', '12:00')).toBe(true);
184
- });
185
-
186
- test('should validate temporary table within date range and correct meal type', () => {
187
- const table = {
188
- tableNumber: 1,
189
- isTemporary: true,
190
- startDate: '2025-06-01',
191
- endDate: '2025-06-30',
192
- application: 'lunch'
193
- };
194
- expect(isTemporaryTableValid(table, '2025-06-15', '12:00')).toBe(true);
195
- });
196
-
197
- test('should reject temporary table outside date range', () => {
198
- const table = {
199
- tableNumber: 1,
200
- isTemporary: true,
201
- startDate: '2025-06-01',
202
- endDate: '2025-06-30',
203
- application: 'lunch'
204
- };
205
- expect(isTemporaryTableValid(table, '2025-07-01', '12:00')).toBe(false);
206
- expect(isTemporaryTableValid(table, '2025-05-31', '12:00')).toBe(false);
207
- });
208
-
209
- test('should reject temporary table with wrong meal type', () => {
210
- const table = {
211
- tableNumber: 1,
212
- isTemporary: true,
213
- startDate: '2025-06-01',
214
- endDate: '2025-06-30',
215
- application: 'dinner'
216
- };
217
- expect(isTemporaryTableValid(table, '2025-06-15', '12:00')).toBe(false); // lunch time
218
- });
219
-
220
- test('should reject temporary table with missing date range', () => {
221
- const table = {
222
- tableNumber: 1,
223
- isTemporary: true,
224
- application: 'lunch'
225
- };
226
- expect(isTemporaryTableValid(table, '2025-06-15', '12:00')).toBe(false);
227
- });
228
-
229
- test('should reject temporary table with invalid time', () => {
230
- const table = {
231
- tableNumber: 1,
232
- isTemporary: true,
233
- startDate: '2025-06-01',
234
- endDate: '2025-06-30',
235
- application: 'lunch'
236
- };
237
- expect(isTemporaryTableValid(table, '2025-06-15', 'invalid')).toBe(false);
238
- });
239
- });
240
-
241
- describe('tableHelpers - shifts constant', () => {
242
- test('should have correct shift definitions', () => {
243
- expect(shifts.breakfast).toEqual({ start: '07:00', end: '11:00' });
244
- expect(shifts.lunch).toEqual({ start: '11:00', end: '16:00' });
245
- expect(shifts.dinner).toEqual({ start: '16:00', end: '23:00' });
246
- });
247
- });
1
+ const {
2
+ parseTime,
3
+ getMealTypeByTime,
4
+ getAllTables,
5
+ isTemporaryTableValid,
6
+ shifts
7
+ } = require('../tableHelpers');
8
+
9
+ describe('tableHelpers - parseTime', () => {
10
+ test('should parse valid time string correctly', () => {
11
+ expect(parseTime('12:30')).toBe(750); // 12*60 + 30 = 750
12
+ expect(parseTime('00:00')).toBe(0);
13
+ expect(parseTime('23:59')).toBe(1439);
14
+ });
15
+
16
+ test('should return NaN for invalid time strings', () => {
17
+ expect(parseTime('')).toBeNaN();
18
+ expect(parseTime(null)).toBeNaN();
19
+ expect(parseTime(undefined)).toBeNaN();
20
+ expect(parseTime('25:00')).toBeNaN(); // Invalid hour
21
+ expect(parseTime('12:60')).toBeNaN(); // Invalid minute
22
+ expect(parseTime('12')).toBeNaN(); // Missing colon
23
+ expect(parseTime('ab:cd')).toBeNaN(); // Not numbers
24
+ });
25
+
26
+ test('should handle edge cases', () => {
27
+ expect(parseTime('0:0')).toBe(0);
28
+ expect(parseTime('1:1')).toBe(61);
29
+ });
30
+ });
31
+
32
+ describe('tableHelpers - getMealTypeByTime', () => {
33
+ test('should identify breakfast times correctly', () => {
34
+ expect(getMealTypeByTime('07:00')).toBe('breakfast');
35
+ expect(getMealTypeByTime('09:30')).toBe('breakfast');
36
+ expect(getMealTypeByTime('10:59')).toBe('breakfast');
37
+ });
38
+
39
+ test('should identify lunch times correctly', () => {
40
+ expect(getMealTypeByTime('11:00')).toBe('lunch');
41
+ expect(getMealTypeByTime('12:30')).toBe('lunch');
42
+ expect(getMealTypeByTime('15:59')).toBe('lunch');
43
+ });
44
+
45
+ test('should identify dinner times correctly', () => {
46
+ expect(getMealTypeByTime('16:00')).toBe('dinner');
47
+ expect(getMealTypeByTime('18:30')).toBe('dinner');
48
+ expect(getMealTypeByTime('22:59')).toBe('dinner');
49
+ });
50
+
51
+ test('should return null for times outside defined shifts', () => {
52
+ expect(getMealTypeByTime('06:59')).toBeNull();
53
+ expect(getMealTypeByTime('23:00')).toBeNull();
54
+ expect(getMealTypeByTime('02:00')).toBeNull();
55
+ });
56
+
57
+ test('should return null for invalid time strings', () => {
58
+ expect(getMealTypeByTime('invalid')).toBeNull();
59
+ expect(getMealTypeByTime('')).toBeNull();
60
+ expect(getMealTypeByTime(null)).toBeNull();
61
+ });
62
+ });
63
+
64
+ describe('tableHelpers - getAllTables', () => {
65
+ test('should extract tables correctly from restaurant data', () => {
66
+ const restaurantData = {
67
+ floors: [
68
+ {
69
+ tables: [
70
+ {
71
+ objectType: 'Tafel',
72
+ id: 'table1',
73
+ tableNumber: 1,
74
+ minCapacity: 2,
75
+ maxCapacity: 4,
76
+ priority: 1,
77
+ x: 10,
78
+ y: 20,
79
+ isTemporary: false
80
+ },
81
+ {
82
+ objectType: 'Tafel',
83
+ id: 'table2',
84
+ tableNumber: { $numberInt: '2' },
85
+ minCapacity: { $numberInt: '4' },
86
+ maxCapacity: { $numberInt: '6' },
87
+ priority: { $numberInt: '2' },
88
+ x: { $numberInt: '30' },
89
+ y: { $numberInt: '40' },
90
+ isTemporary: false
91
+ }
92
+ ]
93
+ }
94
+ ]
95
+ };
96
+
97
+ const tables = getAllTables(restaurantData);
98
+ expect(tables).toHaveLength(2);
99
+ expect(tables[0].tableNumber).toBe(1);
100
+ expect(tables[0].maxCapacity).toBe(4);
101
+ expect(tables[1].tableNumber).toBe(2);
102
+ expect(tables[1].maxCapacity).toBe(6);
103
+ });
104
+
105
+ test('should sort tables by maxCapacity, priority, and minCapacity', () => {
106
+ const restaurantData = {
107
+ floors: [
108
+ {
109
+ tables: [
110
+ {
111
+ objectType: 'Tafel',
112
+ id: 'table1',
113
+ tableNumber: 1,
114
+ minCapacity: 2,
115
+ maxCapacity: 6,
116
+ priority: 1,
117
+ x: 10,
118
+ y: 20
119
+ },
120
+ {
121
+ objectType: 'Tafel',
122
+ id: 'table2',
123
+ tableNumber: 2,
124
+ minCapacity: 2,
125
+ maxCapacity: 4,
126
+ priority: 1,
127
+ x: 30,
128
+ y: 40
129
+ }
130
+ ]
131
+ }
132
+ ]
133
+ };
134
+
135
+ const tables = getAllTables(restaurantData);
136
+ expect(tables[0].tableNumber).toBe(2); // Smaller maxCapacity comes first
137
+ expect(tables[1].tableNumber).toBe(1);
138
+ });
139
+
140
+ test('should handle empty or missing data gracefully', () => {
141
+ expect(getAllTables({})).toEqual([]);
142
+ expect(getAllTables({ floors: [] })).toEqual([]);
143
+ expect(getAllTables(null)).toEqual([]);
144
+ });
145
+
146
+ test('should filter out non-Tafel objects', () => {
147
+ const restaurantData = {
148
+ floors: [
149
+ {
150
+ tables: [
151
+ {
152
+ objectType: 'Wall',
153
+ id: 'wall1',
154
+ tableNumber: 1
155
+ },
156
+ {
157
+ objectType: 'Tafel',
158
+ id: 'table1',
159
+ tableNumber: 2,
160
+ minCapacity: 2,
161
+ maxCapacity: 4,
162
+ priority: 1,
163
+ x: 10,
164
+ y: 20
165
+ }
166
+ ]
167
+ }
168
+ ]
169
+ };
170
+
171
+ const tables = getAllTables(restaurantData);
172
+ expect(tables).toHaveLength(1);
173
+ expect(tables[0].tableNumber).toBe(2);
174
+ });
175
+ });
176
+
177
+ describe('tableHelpers - isTemporaryTableValid', () => {
178
+ test('should return true for non-temporary tables', () => {
179
+ const table = {
180
+ tableNumber: 1,
181
+ isTemporary: false
182
+ };
183
+ expect(isTemporaryTableValid(table, '2025-06-15', '12:00')).toBe(true);
184
+ });
185
+
186
+ test('should validate temporary table within date range and correct meal type', () => {
187
+ const table = {
188
+ tableNumber: 1,
189
+ isTemporary: true,
190
+ startDate: '2025-06-01',
191
+ endDate: '2025-06-30',
192
+ application: 'lunch'
193
+ };
194
+ expect(isTemporaryTableValid(table, '2025-06-15', '12:00')).toBe(true);
195
+ });
196
+
197
+ test('should reject temporary table outside date range', () => {
198
+ const table = {
199
+ tableNumber: 1,
200
+ isTemporary: true,
201
+ startDate: '2025-06-01',
202
+ endDate: '2025-06-30',
203
+ application: 'lunch'
204
+ };
205
+ expect(isTemporaryTableValid(table, '2025-07-01', '12:00')).toBe(false);
206
+ expect(isTemporaryTableValid(table, '2025-05-31', '12:00')).toBe(false);
207
+ });
208
+
209
+ test('should reject temporary table with wrong meal type', () => {
210
+ const table = {
211
+ tableNumber: 1,
212
+ isTemporary: true,
213
+ startDate: '2025-06-01',
214
+ endDate: '2025-06-30',
215
+ application: 'dinner'
216
+ };
217
+ expect(isTemporaryTableValid(table, '2025-06-15', '12:00')).toBe(false); // lunch time
218
+ });
219
+
220
+ test('should reject temporary table with missing date range', () => {
221
+ const table = {
222
+ tableNumber: 1,
223
+ isTemporary: true,
224
+ application: 'lunch'
225
+ };
226
+ expect(isTemporaryTableValid(table, '2025-06-15', '12:00')).toBe(false);
227
+ });
228
+
229
+ test('should reject temporary table with invalid time', () => {
230
+ const table = {
231
+ tableNumber: 1,
232
+ isTemporary: true,
233
+ startDate: '2025-06-01',
234
+ endDate: '2025-06-30',
235
+ application: 'lunch'
236
+ };
237
+ expect(isTemporaryTableValid(table, '2025-06-15', 'invalid')).toBe(false);
238
+ });
239
+ });
240
+
241
+ describe('tableHelpers - shifts constant', () => {
242
+ test('should have correct shift definitions', () => {
243
+ expect(shifts.breakfast).toEqual({ start: '07:00', end: '11:00' });
244
+ expect(shifts.lunch).toEqual({ start: '11:00', end: '16:00' });
245
+ expect(shifts.dinner).toEqual({ start: '16:00', end: '23:00' });
246
+ });
247
+ });