fix(types): type safe runtime config on server (#7)

Author: onmax

README.md

@@ -142,6 +142,19 @@ const config = useSafeRuntimeConfig()
 </script>
 ```
 
+You can also use the same composable in server code:
+
+```ts
+// server/utils/config.ts
+export function getPrivateConfig() {
+  const config = useSafeRuntimeConfig()
+  return {
+    secretKey: config.secretKey,
+    apiBase: config.public.apiBase,
+  }
+}
+```
+
 ## Configuration Options
 
 | Option              | Type                            | Default           | Description                                |
@@ -289,7 +302,7 @@ The rule includes auto-fix support — run `eslint --fix` to automatically repla
 
 ## Type Safety
 
-Types are auto-generated at build time from your schema's JSON Schema representation. The `useSafeRuntimeConfig()` composable returns a fully typed object — no manual generics needed:
+Types are auto-generated at build time from your schema's JSON Schema representation. The `useSafeRuntimeConfig()` composable returns a fully typed object in both app and server contexts (`app.vue`, `server/api`, `server/utils`) — no manual generics needed:
 
 ```ts
 const config = useSafeRuntimeConfig()

docs/1.guide/3.type-safety.md

@@ -4,7 +4,7 @@ icon: ph:shield-check
 
 # Type Safety
 
-The module generates TypeScript types from your schema, making `useSafeRuntimeConfig()` fully typed without manual generics.
+The module generates TypeScript types from your schema, making `useSafeRuntimeConfig()` fully typed without manual generics in both app and server code.
 
 ## How It Works
 
@@ -56,7 +56,7 @@ interface SafeRuntimeConfig {
 
 ## Server vs Client
 
-On the server, you get the full config. On the client, only `public` properties are available:
+On the server (including `server/api` and `server/utils`), you get the full config. On the client, only `public` properties are available:
 
 ```ts
 // Server
@@ -69,6 +69,17 @@ config.secretKey // undefined (private keys not exposed)
 config.public.apiBase // available
 ```
 
+```ts
+// server/utils/config.ts
+export function getServerConfig() {
+  const config = useSafeRuntimeConfig()
+  return {
+    secretKey: config.secretKey,
+    apiBase: config.public.apiBase,
+  }
+}
+```
+
 ## Generated Types Location
 
 Types are stored in `.nuxt/types/safe-runtime-config.d.ts` and automatically included via Nuxt's type augmentation.