@timber-js/app 0.1.13 → 0.1.15

package/dist/plugins/shims.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shims.d.ts","sourceRoot":"","sources":["../../src/plugins/shims.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAGnC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AA6DhD;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,CAuGvD"}
+{"version":3,"file":"shims.d.ts","sourceRoot":"","sources":["../../src/plugins/shims.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAGnC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AA6DhD;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,CAkIvD"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@timber-js/app",
-  "version": "0.1.13",
+  "version": "0.1.15",
   "description": "Vite-native React framework for Cloudflare Workers — correct HTTP semantics, real status codes, pages that work without JavaScript",
   "keywords": [
     "cloudflare-workers",

package/src/client/use-router.ts

@@ -42,21 +42,24 @@ const SSR_NOOP_ROUTER: AppRouterInstance = {
  *
  * Compatible with Next.js's `useRouter()` from `next/navigation`.
  *
- * Returns a no-op router during SSR or before the client router is bootstrapped,
- * so components that call useRouter() at the function level (e.g. TransitionLink)
- * do not crash during server-side rendering.
+ * Methods lazily resolve the global router when invoked (during user
+ * interaction) rather than capturing it at render time. This is critical
+ * because during hydration, React synchronously executes component render
+ * functions *before* the router is bootstrapped in browser-entry.ts.
+ * If we eagerly captured the router during render, components would get
+ * the SSR_NOOP_ROUTER and be stuck with silent no-ops forever.
+ *
+ * Returns safe no-ops during SSR (typeof window === 'undefined').
  */
 export function useRouter(): AppRouterInstance {
-  let router;
-  try {
-    router = getRouter();
-  } catch {
-    // Router not yet bootstrapped — SSR or early client render before bootstrap().
+  // SSR guard — on the server there's no router and no window.
+  if (typeof window === 'undefined') {
     return SSR_NOOP_ROUTER;
   }
 
   return {
     push(href: string, options?: { scroll?: boolean }) {
+      const router = getRouter();
       // Wrap in startTransition so React 19 tracks the async navigation.
       // React 19's startTransition accepts async callbacks — it keeps
       // isPending=true until the returned promise resolves. This means
@@ -67,11 +70,13 @@ export function useRouter(): AppRouterInstance {
       });
     },
     replace(href: string, options?: { scroll?: boolean }) {
+      const router = getRouter();
       startTransition(async () => {
         await router.navigate(href, { scroll: options?.scroll, replace: true });
       });
     },
     refresh() {
+      const router = getRouter();
       startTransition(async () => {
         await router.refresh();
       });
@@ -83,6 +88,7 @@ export function useRouter(): AppRouterInstance {
       window.history.forward();
     },
     prefetch(href: string) {
+      const router = getRouter();
       router.prefetch(href);
     },
   };

package/src/plugins/shims.ts

@@ -177,11 +177,38 @@ export function timberShims(_ctx: PluginContext): Plugin {
       // Server modules must never be bundled into the browser — if this
       // module is reached, there is a broken import chain that needs fixing.
       if (id === '\0timber:server-empty') {
-        return `throw new Error(
-  "[timber] @timber-js/app/server was imported from client code. " +
+        // Export named stubs instead of throwing at evaluation time.
+        // Throwing at eval breaks the module system — the browser can't
+        // resolve named imports like `import { notFound } from '...'`.
+        // Instead, each stub throws at call time with a clear message.
+        return `
+const msg = "[timber] @timber-js/app/server was imported from client code. " +
   "Server modules (headers, cookies, redirect, deny, etc.) cannot be used in client components. " +
-  "If you need these APIs, move the import to a server component or middleware."
-);`;
+  "If you need these APIs, move the import to a server component or middleware.";
+function stub() { throw new Error(msg); }
+export const headers = stub;
+export const cookies = stub;
+export const searchParams = stub;
+export const deny = stub;
+export const notFound = stub;
+export const redirect = stub;
+export const permanentRedirect = stub;
+export const redirectExternal = stub;
+export const waitUntil = stub;
+export const RenderError = stub;
+export const RedirectType = {};
+export const DenySignal = stub;
+export const RedirectSignal = stub;
+export const createPipeline = stub;
+export const revalidatePath = stub;
+export const revalidateTag = stub;
+export const createActionClient = stub;
+export const ActionError = stub;
+export const validated = stub;
+export const getFormFlash = stub;
+export const parseFormData = stub;
+export const coerce = stub;
+`;
       }
     },
   };