Test

Instructions

Implementation Reference

• src/index.ts:524-548 (handler)

  The core handler function for the 'bereken_hypotheek_starter' tool. It extracts and validates arguments, constructs the payload, calls the external Replit mortgage calculation API, logs success, and returns a formatted response.
  async function handleBerekenStarter(request: any): Promise<ToolResponse> { const args = requireArguments<BaseArguments>(request); const logger = createLogger(args.session_id); validateBaseArguments(args); enforceRateLimit(args.session_id); const payload: any = { aanvragers: mapAanvragers(args), }; if (args.session_id) { payload.session_id = args.session_id; } const apiClient = getApiClient(); const { data } = await apiClient.post( REPLIT_API_URL_BEREKENEN, payload, { correlationId: args.session_id } ); logger.info('Toolcall succesvol', { tool: 'bereken_hypotheek_starter' }); return successResponse(formatResponse(data, "bereken_hypotheek_starter")); }
• src/index.ts:766-774 (registration)

  Registration of tool handlers in the TOOL_HANDLERS object, mapping 'bereken_hypotheek_starter' to its handler function.
  const TOOL_HANDLERS: Record<string, ToolHandler> = { bereken_hypotheek_starter: handleBerekenStarter, bereken_hypotheek_doorstromer: handleBerekenDoorstromer, bereken_hypotheek_uitgebreid: handleBerekenUitgebreid, haal_actuele_rentes_op: handleActueleRentes, opzet_hypotheek_starter: handleOpzetStarter, opzet_hypotheek_doorstromer: handleOpzetDoorstromer, opzet_hypotheek_uitgebreid: handleOpzetUitgebreid, };
• src/index.ts:782-796 (schema)

  Tool registration including name, description, and input schema definition for 'bereken_hypotheek_starter' in the listTools response.
  name: "bereken_hypotheek_starter", description: `Maximale hypotheek voor starters ZONDER concrete woning. Gebruik deze tool alleen wanneer de gebruiker zich oriënteert ("Wat kan ik lenen?") en er nog geen koopsom/adres bekend is. Zodra de gebruiker een specifiek huis of biedprijs noemt moet u overschakelen naar de opzet-hypotheek tools.`, inputSchema: { type: "object", description: `Gebruik basisintakevelden; zie ${OPZET_GUIDE_URI} voor detaildefinities.`, properties: { ...baseIntakeProperties, session_id: { type: "string", description: "Optioneel sessie-ID vanuit n8n (voor logging).", }, }, required: baseIntakeRequired, }, },
• src/validation/schemas.ts:92-203 (helper)

  Validation helper function validateBaseArguments used by the handler to validate core input fields like income, birthdate, partner info.
  export function validateBaseArguments(args: unknown): void { // Type check if (typeof args !== 'object' || args === null) { throw new ValidationError( ErrorCode.INVALID_INPUT, 'Arguments moet een object zijn', 'arguments' ); } const input = args as Record<string, unknown>; // Valideer verplichte velden if (typeof input.inkomen_aanvrager !== 'number') { throw new ValidationError( ErrorCode.INVALID_INPUT, 'inkomen_aanvrager moet een getal zijn', 'inkomen_aanvrager', input.inkomen_aanvrager ); } if (typeof input.geboortedatum_aanvrager !== 'string') { throw new ValidationError( ErrorCode.INVALID_INPUT, 'geboortedatum_aanvrager moet een string zijn', 'geboortedatum_aanvrager', input.geboortedatum_aanvrager ); } if (typeof input.heeft_partner !== 'boolean') { throw new ValidationError( ErrorCode.INVALID_INPUT, 'heeft_partner moet een boolean zijn', 'heeft_partner', input.heeft_partner ); } // Valideer inkomen range if (input.inkomen_aanvrager < ValidationConstraints.INKOMEN.MIN || input.inkomen_aanvrager > ValidationConstraints.INKOMEN.MAX) { throw new ValidationError( ErrorCode.INCOME_OUT_OF_RANGE, `Inkomen aanvrager moet tussen €${ValidationConstraints.INKOMEN.MIN} en €${ValidationConstraints.INKOMEN.MAX} liggen`, 'inkomen_aanvrager', input.inkomen_aanvrager ); } // Valideer leeftijd aanvrager validateAge(input.geboortedatum_aanvrager, 'aanvrager'); // Valideer partner gegevens indien heeft_partner = true if (input.heeft_partner) { if (input.inkomen_partner !== undefined) { if (typeof input.inkomen_partner !== 'number') { throw new ValidationError( ErrorCode.INVALID_INPUT, 'inkomen_partner moet een getal zijn', 'inkomen_partner', input.inkomen_partner ); } if (input.inkomen_partner < ValidationConstraints.INKOMEN.MIN || input.inkomen_partner > ValidationConstraints.INKOMEN.MAX) { throw new ValidationError( ErrorCode.INCOME_OUT_OF_RANGE, `Inkomen partner moet tussen €${ValidationConstraints.INKOMEN.MIN} en €${ValidationConstraints.INKOMEN.MAX} liggen`, 'inkomen_partner', input.inkomen_partner ); } } if (input.geboortedatum_partner) { if (typeof input.geboortedatum_partner !== 'string') { throw new ValidationError( ErrorCode.INVALID_INPUT, 'geboortedatum_partner moet een string zijn', 'geboortedatum_partner', input.geboortedatum_partner ); } validateAge(input.geboortedatum_partner, 'partner'); } } // Valideer verplichtingen if (input.verplichtingen_pm !== undefined) { if (typeof input.verplichtingen_pm !== 'number') { throw new ValidationError( ErrorCode.INVALID_INPUT, 'verplichtingen_pm moet een getal zijn', 'verplichtingen_pm', input.verplichtingen_pm ); } if (input.verplichtingen_pm < ValidationConstraints.VERPLICHTINGEN.MIN || input.verplichtingen_pm > ValidationConstraints.VERPLICHTINGEN.MAX) { throw new ValidationError( ErrorCode.INVALID_INPUT, `Verplichtingen moet tussen €${ValidationConstraints.VERPLICHTINGEN.MIN} en €${ValidationConstraints.VERPLICHTINGEN.MAX} liggen`, 'verplichtingen_pm', input.verplichtingen_pm ); } } }
• src/index.ts:420-429 (helper)

  Helper function to map and default applicant arguments into the payload format sent to the API.
  }) { return { inkomen_aanvrager: args.inkomen_aanvrager, geboortedatum_aanvrager: args.geboortedatum_aanvrager, heeft_partner: args.heeft_partner, inkomen_partner: args.inkomen_partner ?? 0, geboortedatum_partner: args.geboortedatum_partner ?? null, verplichtingen_pm: args.verplichtingen_pm ?? 0, }; }