@pablozaiden/webapp 0.6.3 → 0.6.4

package/docs/server.md

@@ -106,6 +106,31 @@ Route context is user-aware:
 
 Use `ctx.filterOwned(records, getUserId)` and `ctx.requireOwned(record, getUserId)` when app records use a different ownership field. Return 404 for other-user resources so route responses do not reveal whether another user's id exists.
 
+## Supplying a validated runtime config
+
+`createWebAppServer` reads and validates `{PREFIX}_*` environment variables by
+default. An application that has already resolved a `RuntimeConfig` can pass it
+through `runtimeConfig` instead:
+
+```ts
+import { createWebAppServer, readRuntimeConfig } from "@pablozaiden/webapp/server";
+
+const runtimeConfig = readRuntimeConfig({ appName: "My App", envPrefix: "MY_APP" });
+const app = createWebAppServer({
+  appName: "My App",
+  envPrefix: "MY_APP",
+  runtimeConfig,
+  routes,
+});
+```
+
+The supplied config is used during every framework initialization step,
+including store selection, logging, authentication, document generation,
+request handling, and lifecycle setup. Its `appName` and `envPrefix` must match
+the constructor inputs. Do not mutate `app.config` after construction to
+replace constructor options; omit `runtimeConfig` when the framework should read
+the environment itself.
+
 Built-in endpoints include:
 
 | Endpoint | Purpose |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pablozaiden/webapp",
-  "version": "0.6.3",
+  "version": "0.6.4",
   "description": "Opinionated Bun + React webapp framework for single-server apps",
   "license": "MIT",
   "type": "module",

package/src/server/create-web-app-server.ts

@@ -41,7 +41,10 @@ function canUseSpaFallback(req: Request): boolean {
 }
 
 export function createWebAppServer<TEvent = unknown>(input: WebAppServerConfig<TEvent>): WebAppServer<TEvent> {
-  const config = readRuntimeConfig({ appName: input.appName, envPrefix: input.envPrefix });
+  const config = input.runtimeConfig ?? readRuntimeConfig({ appName: input.appName, envPrefix: input.envPrefix });
+  if (config.appName !== input.appName || config.envPrefix !== input.envPrefix) {
+    throw new Error("runtimeConfig appName and envPrefix must match the createWebAppServer inputs");
+  }
   const store = input.store ?? sqliteWebAppStore({ dataDir: config.dataDir });
   store.initialize();
   const savedLogLevel = store.getLogLevelPreference();

package/src/server/server-types.ts

@@ -26,6 +26,7 @@ export type PublicRouteDefinition =
 export interface WebAppServerConfig<TEvent = unknown> {
   appName: string;
   envPrefix: string;
+  runtimeConfig?: RuntimeConfig;
   web?: WebAppDocumentConfig;
   version?: string;
   store?: WebAppStore;