@alepha/react 0.10.7 → 0.11.0

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "@alepha/react",
 	"description": "Build server-side rendered (SSR) or single-page React applications.",
-	"version": "0.10.7",
+	"version": "0.11.0",
 	"type": "module",
 	"engines": {
 		"node": ">=22.0.0"
@@ -17,22 +17,22 @@
 		"src"
 	],
 	"dependencies": {
-		"@alepha/core": "0.10.7",
-		"@alepha/datetime": "0.10.7",
-		"@alepha/logger": "0.10.7",
-		"@alepha/router": "0.10.7",
-		"@alepha/server": "0.10.7",
-		"@alepha/server-cache": "0.10.7",
-		"@alepha/server-links": "0.10.7",
-		"@alepha/server-static": "0.10.7"
+		"@alepha/core": "0.11.0",
+		"@alepha/datetime": "0.11.0",
+		"@alepha/logger": "0.11.0",
+		"@alepha/router": "0.11.0",
+		"@alepha/server": "0.11.0",
+		"@alepha/server-cache": "0.11.0",
+		"@alepha/server-links": "0.11.0",
+		"@alepha/server-static": "0.11.0"
 	},
 	"devDependencies": {
-		"@biomejs/biome": "^2.2.6",
+		"@biomejs/biome": "^2.3.2",
 		"@types/react": "^19.2.2",
 		"@types/react-dom": "^19.2.2",
 		"react": "^19.2.0",
 		"react-dom": "^19.2.0",
-		"tsdown": "^0.15.9",
+		"tsdown": "^0.15.11",
 		"typescript": "^5.9.3",
 		"vitest": "^3.2.4"
 	},

package/src/hooks/useQueryParams.ts

@@ -44,7 +44,7 @@ export interface UseQueryParamsHookOptions {
 }
 
 const encode = (alepha: Alepha, schema: TObject, data: any) => {
-  return btoa(JSON.stringify(alepha.parse(schema, data)));
+  return btoa(JSON.stringify(alepha.codec.decode(schema, data)));
 };
 
 const decode = <T extends TObject>(
@@ -53,7 +53,10 @@ const decode = <T extends TObject>(
   data: any,
 ): Static<T> | undefined => {
   try {
-    return alepha.parse(schema, JSON.parse(atob(decodeURIComponent(data))));
+    return alepha.codec.decode(
+      schema,
+      JSON.parse(atob(decodeURIComponent(data))),
+    );
   } catch {
     return;
   }

package/src/hooks/useSchema.ts

@@ -25,11 +25,11 @@ export const useSchema = <TConfig extends RequestConfigSchema>(
     }
 
     const opts: FetchOptions = {
-      cache: true,
+      localCache: true,
     };
 
     httpClient
-      .fetch(`${LinkProvider.path.apiLinks}/${name}/schema`, {}, opts)
+      .fetch(`${LinkProvider.path.apiLinks}/${name}/schema`, opts)
       .then((it) => setSchema(it.data as UseSchemaReturn<TConfig>));
   }, [name]);
 

package/src/providers/ReactPageProvider.ts

@@ -119,7 +119,7 @@ export class ReactPageProvider {
           typeof value[key] === "string"
         ) {
           try {
-            value[key] = this.alepha.parse(
+            value[key] = this.alepha.codec.decode(
               schema.properties[key],
               decodeURIComponent(value[key]),
             );
@@ -161,7 +161,7 @@ export class ReactPageProvider {
       try {
         this.convertStringObjectToObject(route.schema?.query, state.query);
         config.query = route.schema?.query
-          ? this.alepha.parse(route.schema.query, state.query)
+          ? this.alepha.codec.decode(route.schema.query, state.query)
           : {};
       } catch (e) {
         it.error = e as Error;
@@ -170,7 +170,7 @@ export class ReactPageProvider {
 
       try {
         config.params = route.schema?.params
-          ? this.alepha.parse(route.schema.params, state.params)
+          ? this.alepha.codec.decode(route.schema.params, state.params)
           : {};
       } catch (e) {
         it.error = e as Error;

package/src/providers/ReactServerProvider.ts

@@ -6,6 +6,7 @@ import {
   $inject,
   Alepha,
   AlephaError,
+  type Configurable,
   type Static,
   t,
 } from "@alepha/core";
@@ -17,7 +18,10 @@ import {
   ServerTimingProvider,
 } from "@alepha/server";
 import { ServerLinksProvider } from "@alepha/server-links";
-import { ServerStaticProvider } from "@alepha/server-static";
+import {
+  type ServeDescriptorOptions,
+  ServerStaticProvider,
+} from "@alepha/server-static";
 import { renderToString } from "react-dom/server";
 import {
   $page,
@@ -36,7 +40,7 @@ const envSchema = t.object({
   REACT_SERVER_DIST: t.text({ default: "public" }),
   REACT_SERVER_PREFIX: t.text({ default: "" }),
   REACT_SSR_ENABLED: t.optional(t.boolean()),
-  REACT_ROOT_ID: t.text({ default: "root" }),
+  REACT_ROOT_ID: t.text({ default: "root" }), // TODO: move to ReactPageProvider.options?
   REACT_SERVER_TEMPLATE: t.optional(
     t.text({
       size: "rich",
@@ -51,21 +55,35 @@ declare module "@alepha/core" {
   }
 }
 
-export class ReactServerProvider {
+export interface ReactServerProviderOptions {
+  /**
+   * Override default options for the static file server.
+   * > Static file server is only created in non-serverless production mode.
+   */
+  static?: Partial<Omit<ServeDescriptorOptions, "root">>;
+}
+
+export class ReactServerProvider implements Configurable {
   protected readonly log = $logger();
   protected readonly alepha = $inject(Alepha);
+  protected readonly env = $env(envSchema);
   protected readonly pageApi = $inject(ReactPageProvider);
   protected readonly serverProvider = $inject(ServerProvider);
   protected readonly serverStaticProvider = $inject(ServerStaticProvider);
   protected readonly serverRouterProvider = $inject(ServerRouterProvider);
   protected readonly serverTimingProvider = $inject(ServerTimingProvider);
-  protected readonly env = $env(envSchema);
+
   protected readonly ROOT_DIV_REGEX = new RegExp(
     `<div([^>]*)\\s+id=["']${this.env.REACT_ROOT_ID}["']([^>]*)>(.*?)<\\/div>`,
     "is",
   );
   protected preprocessedTemplate: PreprocessedTemplate | null = null;
 
+  public options: ReactServerProviderOptions = {};
+
+  /**
+   * Configure the React server provider.
+   */
   public readonly onConfigure = $hook({
     on: "configure",
     handler: async () => {
@@ -174,6 +192,9 @@ export class ReactServerProvider {
     }
   }
 
+  /**
+   * Get the public directory path where static files are located.
+   */
   protected getPublicDirectory(): string {
     const maybe = [
       join(process.cwd(), `dist/${this.env.REACT_SERVER_DIST}`),
@@ -189,13 +210,24 @@ export class ReactServerProvider {
     return "";
   }
 
+  /**
+   * Configure the static file server to serve files from the given root directory.
+   */
   protected async configureStaticServer(root: string) {
     await this.serverStaticProvider.createStaticServer({
       root,
       path: this.env.REACT_SERVER_PREFIX,
+      cacheControl: {
+        maxAge: 3600,
+        immutable: true,
+      },
+      ...this.options.static,
     });
   }
 
+  /**
+   * Configure Vite for SSR.
+   */
   protected async configureVite(ssrEnabled: boolean) {
     if (!ssrEnabled) {
       // do nothing, vite will handle everything for us
@@ -286,7 +318,7 @@ export class ReactServerProvider {
       const { url, reply, query, params } = serverRequest;
       const template = await templateLoader();
       if (!template) {
-        throw new Error("Template not found");
+        throw new AlephaError("Template not found");
       }
 
       this.log.trace("Rendering page", {