How It Works ​

tl;dr ​

The internal /api/__kql server route proxies KQL requests to the Kirby instance.

Detailed Answer ​

The useKql and $kql composables will initiate a POST request to the Nuxt server route /api/__kql defined by this module. The KQL query will be encoded in the request body.

The internal server route then fetches the actual data for a given query from the Kirby instance and passes the response back to the client. Thus, no KQL requests to the Kirby instance are initiated on the client-side. This proxy behavior has the benefit of omitting CORS issues, since data is sent from server to server.

During server-side rendering, calls to the Nuxt server route will directly call the relevant function (emulating the request), saving an additional API call. Thus, only the fetch request from Nuxt to Kirby will be performed.