@pablozaiden/webapp 0.6.2 → 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.2",
+  "version": "0.6.4",
   "description": "Opinionated Bun + React webapp framework for single-server apps",
   "license": "MIT",
   "type": "module",
@@ -33,13 +33,15 @@
     "dev": "bun run --cwd examples/notes-todo dev",
     "dev:kitchen-sink": "bun run --cwd examples/kitchen-sink dev",
     "dev:notes-todo": "bun run --cwd examples/notes-todo dev",
-    "build": "bun run tsc && bun run --cwd examples/kitchen-sink build && bun run --cwd examples/notes-todo build",
+    "build": "bun run typecheck && bun run build:examples",
+    "build:examples": "bun run --cwd examples/kitchen-sink build && bun run --cwd examples/notes-todo build",
     "build:kitchen-sink": "bun run --cwd examples/kitchen-sink build",
     "build:notes-todo": "bun run --cwd examples/notes-todo build",
     "test": "bun run test:build-binary && bun run test:remaining",
     "test:build-binary": "bun test tests/build-binary.test.ts",
     "test:remaining": "bun test --path-ignore-patterns=**/build-binary.test.ts",
-    "tsc": "mkdir -p .cache/tsc && bunx tsc --noEmit --pretty false --incremental --tsBuildInfoFile .cache/tsc/build.tsbuildinfo"
+    "typecheck": "mkdir -p .cache/tsc && bunx tsc --noEmit --pretty false --incremental --tsBuildInfoFile .cache/tsc/build.tsbuildinfo",
+    "tsc": "bun run typecheck"
   },
   "dependencies": {
     "@simplewebauthn/browser": "13.3.0",

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;

package/src/web/theme.tsx

@@ -43,10 +43,10 @@ function readSystemTheme(): ResolvedTheme {
 }
 
 function parseThemeResponse(value: unknown): ThemePreference {
-  if (!isRecord(value) || !isThemePreference(value.theme)) {
+  if (!isRecord(value) || !isThemePreference(value["theme"])) {
     throw new Error("Theme preference response was invalid.");
   }
-  return value.theme;
+  return value["theme"];
 }
 
 function toError(value: unknown): Error {
@@ -97,8 +97,8 @@ export function ThemeProvider({ userId, children }: { userId?: string; children:
     const root = document.documentElement;
     root.classList.toggle("dark", resolvedTheme === "dark");
     root.style.colorScheme = resolvedTheme;
-    root.dataset.theme = preference;
-    root.dataset.resolvedTheme = resolvedTheme;
+    root.dataset["theme"] = preference;
+    root.dataset["resolvedTheme"] = resolvedTheme;
     window.localStorage.setItem(THEME_STORAGE_KEY, preference);
   }, [preference, resolvedTheme]);
 

package/src/web/webapp-config.tsx

@@ -21,11 +21,11 @@ function isLogLevelName(value: unknown): boolean {
 
 function isCurrentUser(value: unknown): boolean {
   return isRecord(value)
-    && typeof value.id === "string"
-    && typeof value.username === "string"
-    && (value.role === "owner" || value.role === "admin" || value.role === "user")
-    && typeof value.isOwner === "boolean"
-    && typeof value.isAdmin === "boolean";
+    && typeof value["id"] === "string"
+    && typeof value["username"] === "string"
+    && (value["role"] === "owner" || value["role"] === "admin" || value["role"] === "user")
+    && typeof value["isOwner"] === "boolean"
+    && typeof value["isAdmin"] === "boolean";
 }
 
 function hasBooleanFields(value: unknown, fields: readonly string[]): boolean {
@@ -34,10 +34,10 @@ function hasBooleanFields(value: unknown, fields: readonly string[]): boolean {
 
 function isWebAppConfigResponse(value: unknown): value is WebAppConfigResponse {
   return isRecord(value)
-    && typeof value.appName === "string"
-    && typeof value.version === "string"
-    && (value.currentUser === undefined || isCurrentUser(value.currentUser))
-    && hasBooleanFields(value.passkeyAuth, [
+    && typeof value["appName"] === "string"
+    && typeof value["version"] === "string"
+    && (value["currentUser"] === undefined || isCurrentUser(value["currentUser"]))
+    && hasBooleanFields(value["passkeyAuth"], [
       "enabled",
       "passkeyConfigured",
       "passkeyDisabled",
@@ -46,12 +46,12 @@ function isWebAppConfigResponse(value: unknown): value is WebAppConfigResponse {
       "bootstrapRequired",
       "ownerPasskeySetupRequired",
     ])
-    && hasBooleanFields(value.userManagement, ["enabled", "canManageUsers"])
-    && isRecord(value.logLevel)
-    && isLogLevelName(value.logLevel.level)
-    && typeof value.logLevel.fromEnv === "boolean"
-    && hasBooleanFields(value.deviceAuth, ["enabled"])
-    && hasBooleanFields(value.apiKeys, ["enabled"]);
+    && hasBooleanFields(value["userManagement"], ["enabled", "canManageUsers"])
+    && isRecord(value["logLevel"])
+    && isLogLevelName(value["logLevel"]["level"])
+    && typeof value["logLevel"]["fromEnv"] === "boolean"
+    && hasBooleanFields(value["deviceAuth"], ["enabled"])
+    && hasBooleanFields(value["apiKeys"], ["enabled"]);
 }
 
 export function parseWebAppConfigResponse(value: unknown): WebAppConfigResponse {