apps/backend/src/common/hotel-fnb-input-validation.tsTypeScript
function isRecord(value: unknown): value is Record<string, any> {
return Boolean(value) && typeof value === 'object' && !Array.isArray(value);
}
function text(value: unknown, max: number, code: string): asserts value is string {
if (typeof value !== 'string' || value.trim().length === 0 || value.length > max) throw new Error(code);
}
function optionalText(value: unknown, max: number, code: string): void {
if (value !== undefined && value !== null) text(value, max, code);
}
function boundedStringList(value: unknown, max: number, code: string): void {
if (value === undefined || value === null) return;
if (!Array.isArray(value) || value.length > max || value.some((item) => typeof item !== 'string' || item.trim().length === 0 || item.length > 200)) {
throw new Error(code);
}
}
export function assertPmsContextInput(input: unknown): asserts input is Record<string, any> {
if (!isRecord(input)) throw new Error('pms_context.input_invalid');
if (input.source !== 'pms' || typeof input.stayId !== 'string' || !input.stayId.trim() || typeof input.hotelId !== 'string' || !input.hotelId.trim()) {
throw new Error('pms_context.identity_invalid');
}
text(input.stayId, 200, 'pms_context.input_invalid');
text(input.hotelId, 200, 'pms_context.input_invalid');
optionalText(input.roomNumber, 32, 'pms_context.input_invalid');
if (!['in_house', 'arriving', 'departed'].includes(input.status)) throw new Error('pms_context.state_invalid');
if (input.availability !== undefined && !['available', 'degraded', 'unavailable'].includes(input.availability)) throw new Error('pms_context.availability_invalid');
}
export function assertHotelFnbCompositionInput(input: unknown): asserts input is Record<string, any> {
if (!isRecord(input) || !isRecord(input.pms) || !isRecord(input.guest) || !isRecord(input.outlet)) {
throw new Error('hotel_fnb_context.input_invalid');
}
}
export function assertHotelGuestContextInput(input: unknown): asserts input is Record<string, any> {
if (!isRecord(input)) throw new Error('hotel_guest_context.input_invalid');
if (typeof input.stayId !== 'string' || !input.stayId.trim()) throw new Error('hotel_guest_context.stay_invalid');
text(input.stayId, 200, 'hotel_guest_context.input_invalid');
optionalText(input.roomNumber, 32, 'hotel_guest_context.input_invalid');
optionalText(input.entitlement, 200, 'hotel_guest_context.input_invalid');
optionalText(input.preference, 500, 'hotel_guest_context.input_invalid');
if (typeof input.privacyAllowed !== 'boolean') throw new Error('hotel_guest_context.privacy_invalid');
if (input.roomChargeAllowed !== undefined && typeof input.roomChargeAllowed !== 'boolean') throw new Error('hotel_guest_context.input_invalid');
}
export function assertOutletNetworkInput(input: unknown): asserts input is Record<string, any> {
if (!isRecord(input)) throw new Error('multi_outlet.input_invalid');
if (typeof input.groupId !== 'string' || !input.groupId.trim() || typeof input.outletId !== 'string' || !input.outletId.trim()) throw new Error('multi_outlet.identity_invalid');
text(input.groupId, 200, 'multi_outlet.input_invalid');
text(input.outletId, 200, 'multi_outlet.input_invalid');
optionalText(input.guestId, 200, 'multi_outlet.input_invalid');
optionalText(input.transferToOutletId, 200, 'multi_outlet.input_invalid');
optionalText(input.reportMetric, 200, 'multi_outlet.input_invalid');
boundedStringList(input.sharedResourceIds, 100, 'multi_outlet.input_invalid');
if (input.transferToOutletId?.trim() === input.outletId.trim()) throw new Error('multi_outlet.identity_invalid');
}
export function assertRoomserviceInput(input: unknown): asserts input is Record<string, any> {
if (!isRecord(input)) throw new Error('roomservice.input_invalid');
if (typeof input.orderId !== 'string' || !input.orderId.trim() || typeof input.roomNumber !== 'string' || !input.roomNumber.trim()) throw new Error('roomservice.identity_invalid');
text(input.orderId, 200, 'roomservice.input_invalid');
text(input.roomNumber, 32, 'roomservice.input_invalid');
if (typeof input.productionReady !== 'boolean' || typeof input.deliveryTaskReady !== 'boolean') throw new Error('roomservice.input_invalid');
boundedStringList(input.resourceIds, 100, 'roomservice.input_invalid');
}
const settlementSources = ['payment', 'room_folio', 'package', 'allowance', 'house_account'] as const;
export function assertSettlementInput(input: unknown): asserts input is Record<string, any> {
if (!isRecord(input)) throw new Error('settlement.input_invalid');
if (!Number.isSafeInteger(input.totalCents) || input.totalCents <= 0 || !Array.isArray(input.allocations) || input.allocations.length === 0 || input.allocations.length > 32) throw new Error('settlement.invalid_total');
for (const allocation of input.allocations) {
if (!isRecord(allocation) || !settlementSources.includes(allocation.source) || !Number.isSafeInteger(allocation.amountCents) || allocation.amountCents <= 0) throw new Error('settlement.invalid_allocation');
optionalText(allocation.reference, 500, 'settlement.invalid_allocation');
}
}