@palbase/web 5.0.1 → 6.0.0

package/README.md

@@ -49,10 +49,10 @@ If you forget to import it, every `pb` call throws a guided `BackendError`
 
 ## Calling your backend
 
-Codegen turns each backend controller into a typed namespace on `pb`. A
-controller method `todos.create` becomes `pb.todos.create(input)`; a top-level
-endpoint `getHello` becomes `pb.getHello()`. Path params come first, the request
-body/query second:
+Codegen turns each backend controller into a typed namespace on `pb`. The
+operation id is `<controller>.<method>` — `TodosController.create` becomes
+`pb.todos.create(input)`, `HelloController.greet` becomes `pb.hello.greet()`.
+Path params come first, the request body/query second:
 
 ```ts
 import { pb } from '@palbase/web';
@@ -206,8 +206,8 @@ specific failures a given endpoint documents.
 ## Next.js — `@palbase/web/next`
 
 The Next.js App Router adapter shares one session cookie between the browser and
-the server so Server Components, Route Handlers and middleware all see the same
-auth state.
+the server so Server Components, Route Handlers and the proxy all see the same
+auth state. Requires `next >= 16` (the `proxy` file convention).
 
 **1. Configure the browser client** (a client provider/component):
 
@@ -225,15 +225,15 @@ export function PalbeProvider({ children }: { children: React.ReactNode }) {
 `setupPalbeNext()` swaps in `cookieSessionStorage` so the session is written to a
 cookie the server can read.
 
-**2. Refresh the session in middleware** (required for session-bearing RSC apps):
+**2. Refresh the session in the proxy** (required for session-bearing RSC apps):
 
 ```ts
-// middleware.ts
-import { palbeMiddleware } from '@palbase/web/next/middleware';
+// proxy.ts
+import { palbeProxy } from '@palbase/web/next/proxy';
 import type { NextRequest } from 'next/server';
 
-export function middleware(request: NextRequest) {
-  return palbeMiddleware(request, {
+export function proxy(request: NextRequest) {
+  return palbeProxy(request, {
     url: 'https://<environmentRef>.palbase.studio',
     apiKey: 'pb_<environmentRef>_c...',
   });
@@ -247,15 +247,15 @@ export const config = { matcher: ['/((?!_next/static|_next/image|favicon.ico).*)
 
 Two rules the shape above encodes:
 
-- **Import `@palbase/web/next/middleware`, not `@palbase/web/next`.** Next
-  compiles middleware into a separate Edge bundle, and the full adapter graph
-  reaches `WebAssembly.compile`, which Next rejects there with a build error.
+- **Import `@palbase/web/next/proxy`, not `@palbase/web/next`.** Next compiles
+  the proxy into its own bundle, and the full adapter graph reaches
+  `livekit-client` and the MLS WASM loader — megabytes on every request path.
   This entry reaches none of it.
 - **Pass the config explicitly; do not `import './palbe.gen'` here.** That
   import would pull the same graph back in. It also means `config`/`matcher`
   must be declared in this file — Next reads `export const config` off this
   file's own AST, so a re-exported or imported one is silently ignored and the
-  middleware degrades to matching every request.
+  proxy degrades to matching every request.
 
 **3. Read data in Server Components** with `pbServer()` — a per-request,
 session-isolated client:

package/dist/{chunk-QKFPPZLF.js → chunk-KOJ4OAAR.js}

@@ -8633,7 +8633,7 @@ function defaultSessionStorage(key) {
 }
 
 // src/version.ts
-var VERSION = "5.0.1";
+var VERSION = "6.0.0";
 
 // src/runtime.ts
 function buildRuntime(config) {
@@ -9058,4 +9058,4 @@ export {
   pb,
   createBoundClient
 };
-//# sourceMappingURL=chunk-QKFPPZLF.js.map
+//# sourceMappingURL=chunk-KOJ4OAAR.js.map