in which file does astro API's first mount

[carmine drift]

I want to know where Astro apis are initialized to call a function which should be called only one time

[dusk roost]

Hi @carmine drift. I'm kapa.ai, your friendly support bot. I will try to answer your question by searching through the knowledge base. :wave:

---

Astro provides hooks that allow you to run functions at specific points in the build process. One such hook is astro:config:setup, which is called when the dev server starts. You can use the isRestart option to detect if the function is called more than once. If isRestart is false, it means the function is called for the first time.

Here's the relevant extract from the Astro Integration API documentation (https://docs.astro.build/en/reference/integrations-reference#isrestart-option):

**Type:** `boolean`

`false` when the dev server starts, `true` when a reload is triggered. Useful to detect when this function is called more than once.

You can create an integration and use this hook to call your function only once.

Note: you can ask me a follow up question by @ mentioning me again :speech_balloon:

@carmine drift kapa.ai is still learning and improving, please let us how it did by reacting below

[carmine drift]

i want to know where Astro endpoints are initialized @dusk roost

[dusk roost]

Let me check the knowledge base for you. One moment! :books:

---

Astro endpoints are initialized in the src/pages directory of your project. To create a custom endpoint, you need to add a .js or .ts file to the /pages directory. The .js or .ts extension will be removed during the build process, so the name of the file should include the extension of the data you want to create. For example, src/pages/data.json.ts will build a /data.json endpoint.

Here's an example of creating an endpoint from the Astro documentation (https://docs.astro.build/en/core-concepts/endpoints#static-file-endpoints):

// src/pages/builtwith.json.ts
export async function get({params, request}) {
 return {
 body: JSON.stringify({
 name: 'Astro',
 url: 'https://astro.build/',
 }),
 };
}

For more information on Astro endpoints, refer to the Astro documentation on endpoints (https://docs.astro.build/en/core-concepts/endpoints).

Note: you can ask me a follow up question by @ mentioning me again :speech_balloon:

@carmine drift kapa.ai is still learning and improving, please let us how it did by reacting below

[carmine drift]

@dusk roost what i want is to do a function on server first start to create a connection pool to use it on astro ssr endpoints, how can i do that

[dusk roost]

Let me check the knowledge base for you. One moment! :books:

---

Hmm, I don't know enough to give you a confident answer yet. The provided extracts don't cover creating a connection pool specifically for Astro SSR endpoints. However, you can refer to the Astro documentation on server-side rendering (https://docs.astro.build/en/guides/server-side-rendering/) and Astro documentation on endpoints (https://docs.astro.build/en/core-concepts/endpoints) for more information on working with SSR and endpoints in Astro.

Note: you can ask me a follow up question by @ mentioning me again :speech_balloon:

@carmine drift kapa.ai is still learning and improving, please let us how it did by reacting below

[carmine drift]

@dusk roost i want to call a function on server first start, give me code to do this

[dusk roost]

Let me check the knowledge base for you. One moment! :books:

---

Based on the provided extracts, you can use the astro:server:setup hook to call a function when the server starts. Here's an example of how to use this hook in an Astro integration:

// astro-integration.js
export default {
  hooks: {
    'astro:server:setup': async ({ server }) => {
      // Your function to call on server start
      yourFunctionToCallOnServerStart();
    },
  },
};

Then, add the integration to your astro.config.mjs file:

// astro.config.mjs
import { defineConfig } from 'astro/config';
import myIntegration from './astro-integration.js';

export default defineConfig({
  // ...
  integrations: [myIntegration()],
});

This code will call yourFunctionToCallOnServerStart() when the server starts. Replace yourFunctionToCallOnServerStart() with the actual function you want to call.

For more information on Astro hooks, refer to the Astro Integration API documentation (https://docs.astro.build/en/reference/integrations-reference#astroserversetup).

Note: you can ask me a follow up question by @ mentioning me again :speech_balloon:

@carmine drift kapa.ai is still learning and improving, please let us how it did by reacting below

[carmine drift]

@dusk roost how can i make a global variable for my ssr astro endpoints

[dusk roost]

Let me check the knowledge base for you. One moment! :books:

---

To create a global variable that can be used in your SSR Astro endpoints, you can extend the globalThis object. Add a global declaration to your env.d.ts file:

// env.d.ts
declare global {
  var myGlobalVariable: string;
}

export {};

Now, you can use myGlobalVariable in your SSR Astro endpoints. Note that globalThis is available both server-side and client-side, but its server-side value won't be shared with the client.

For more information on extending globalThis, refer to the Astro documentation on TypeScript (https://docs.astro.build/en/guides/typescript#extending-window-and-globalthis).

Note: you can ask me a follow up question by @ mentioning me again :speech_balloon:

@carmine drift kapa.ai is still learning and improving, please let us how it did by reacting below

[carmine drift]

@dusk roost can i next put a value in this global value and use it for my endpoints and give me an example of code using it

[dusk roost]

Let me check the knowledge base for you. One moment! :books: