Merge branch 'dev' into customizable-ports

stack-auth · N2D4 · Oct 20, 2025 · Oct 17, 2025 · Oct 17, 2025 · Oct 17, 2025
commit 75c259545e1bf5c55e5e330a987450a5a99aefce
diff --git a/.github/workflows/e2e-api-tests.yaml b/.github/workflows/e2e-api-tests.yaml
@@ -78,9 +78,6 @@ jobs:
       - name: Create .env.test.local file for examples/middleware
         run: cp examples/middleware/.env.development examples/middleware/.env.test.local
 
-      - name: Create .env.test.local file for examples/partial-prerendering
-        run: cp examples/partial-prerendering/.env.development examples/partial-prerendering/.env.test.local
-
       - name: Create .env.test.local file for examples/supabase
         run: cp examples/supabase/.env.development examples/supabase/.env.test.local
 

diff --git a/.github/workflows/e2e-source-of-truth-api-tests.yaml b/.github/workflows/e2e-source-of-truth-api-tests.yaml
@@ -80,9 +80,6 @@ jobs:
       - name: Create .env.test.local file for examples/middleware
         run: cp examples/middleware/.env.development examples/middleware/.env.test.local
 
-      - name: Create .env.test.local file for examples/partial-prerendering
-        run: cp examples/partial-prerendering/.env.development examples/partial-prerendering/.env.test.local
-
       - name: Create .env.test.local file for examples/supabase
         run: cp examples/supabase/.env.development examples/supabase/.env.test.local
 

diff --git a/.github/workflows/lint-and-build.yaml b/.github/workflows/lint-and-build.yaml
@@ -62,9 +62,6 @@ jobs:
       - name: Create .env.production.local file for examples/middleware
         run: cp examples/middleware/.env.development examples/middleware/.env.production.local
 
-      - name: Create .env.production.local file for examples/partial-prerendering
-        run: cp examples/partial-prerendering/.env.development examples/partial-prerendering/.env.production.local
-
       - name: Create .env.production.local file for examples/supabase
         run: cp examples/supabase/.env.development examples/supabase/.env.production.local
 

diff --git a/apps/backend/CHANGELOG.md b/apps/backend/CHANGELOG.md
@@ -1,5 +1,14 @@
 # @stackframe/stack-backend
 
+## 2.8.44
+
+### Patch Changes
+
+- Various changes
+- Updated dependencies
+  - @stackframe/stack-shared@2.8.44
+  - @stackframe/stack@2.8.44
+
 ## 2.8.43
 
 ### Patch Changes

diff --git a/apps/backend/package.json b/apps/backend/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@stackframe/stack-backend",
-  "version": "2.8.43",
+  "version": "2.8.44",
   "private": true,
   "scripts": {
     "clean": "rimraf src/generated && rimraf .next && rimraf node_modules",

diff --git a/apps/backend/src/middleware.tsx b/apps/backend/src/middleware.tsx
@@ -79,12 +79,11 @@ export async function middleware(request: NextRequest) {
   } : undefined;
 
   // ensure our clients can handle 429 responses
-  if (isApiRequest && getNodeEnvironment() === 'development' && request.method !== 'OPTIONS') {
+  if (isApiRequest && !request.headers.get('x-stack-disable-artificial-development-delay') && getNodeEnvironment() === 'development' && request.method !== 'OPTIONS' && !request.url.includes(".well-known")) {
     const now = Date.now();
     while (devRateLimitTimestamps.length > 0 && now - devRateLimitTimestamps[0] > DEV_RATE_LIMIT_WINDOW_MS) {
       devRateLimitTimestamps.shift();
     }
-    console.log('devRateLimitTimestamps', devRateLimitTimestamps.length);
     if (devRateLimitTimestamps.length >= DEV_RATE_LIMIT_MAX_REQUESTS) {
       const waitMs = Math.max(0, DEV_RATE_LIMIT_WINDOW_MS - (now - devRateLimitTimestamps[0]));
       const retryAfterSeconds = Math.max(1, Math.ceil(waitMs / 1000));

diff --git a/apps/dashboard/CHANGELOG.md b/apps/dashboard/CHANGELOG.md
@@ -1,5 +1,15 @@
 # @stackframe/stack-dashboard
 
+## 2.8.44
+
+### Patch Changes
+
+- Various changes
+- Updated dependencies
+  - @stackframe/stack-shared@2.8.44
+  - @stackframe/stack-ui@2.8.44
+  - @stackframe/stack@2.8.44
+
 ## 2.8.43
 
 ### Patch Changes

diff --git a/apps/dashboard/package.json b/apps/dashboard/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@stackframe/stack-dashboard",
-  "version": "2.8.43",
+  "version": "2.8.44",
   "private": true,
   "scripts": {
     "clean": "rimraf .next && rimraf node_modules",

diff --git a/apps/dashboard/src/app/(main)/(protected)/projects/[projectId]/layout.tsx b/apps/dashboard/src/app/(main)/(protected)/projects/[projectId]/layout.tsx
@@ -1,20 +1,24 @@
+import { SiteLoadingIndicator } from "@/components/site-loading-indicator";
 import { UrlPrefetcher } from "@/lib/prefetch/url-prefetcher";
+import { Suspense } from "react";
 import SidebarLayout from "./sidebar-layout";
 import { AdminAppProvider } from "./use-admin-app";
 
 export default async function Layout(
   props: { children: React.ReactNode, modal?: React.ReactNode, params: Promise<{ projectId: string }> }
 ) {
   return (
-    <AdminAppProvider projectId={(await props.params).projectId}>
+    <Suspense fallback={<SiteLoadingIndicator />}>
+      <AdminAppProvider projectId={(await props.params).projectId}>
 
-      {/* Pre-fetch the current URL to prevent request waterfalls */}
-      <UrlPrefetcher href="" />
+        {/* Pre-fetch the current URL to prevent request waterfalls */}
+        <UrlPrefetcher href="" />
 
-      <SidebarLayout projectId={(await props.params).projectId}>
-        {props.children}
-        {props.modal}
-      </SidebarLayout>
-    </AdminAppProvider>
+        <SidebarLayout projectId={(await props.params).projectId}>
+          {props.children}
+          {props.modal}
+        </SidebarLayout>
+      </AdminAppProvider>
+    </Suspense>
   );
 }
diff --git a/apps/dashboard/src/app/(main)/(protected)/projects/[projectId]/loading.tsx b/apps/dashboard/src/app/(main)/(protected)/projects/[projectId]/loading.tsx
diff --git a/apps/dashboard/src/app/(main)/(protected)/projects/[projectId]/page-layout.tsx b/apps/dashboard/src/app/(main)/(protected)/projects/[projectId]/page-layout.tsx
@@ -1,9 +1,10 @@
 import { Typography } from "@stackframe/stack-ui";
+import React from "react";
 
 export function PageLayout(props: {
   children?: React.ReactNode,
   title?: string,
-  description?: string,
+  description?: string | React.ReactNode,
   actions?: React.ReactNode,
   fillWidth?: boolean,
 } & ({
@@ -26,7 +27,7 @@ export function PageLayout(props: {
               {props.title}
             </Typography>}
             {props.description && (
-              <Typography type="p" variant="secondary">
+              <Typography type={typeof props.description === "string" ? "p" : "div"} variant="secondary">
                 {props.description}
               </Typography>
             )}

diff --git a/apps/dashboard/src/app/(main)/(protected)/projects/[projectId]/users/page-client.tsx b/apps/dashboard/src/app/(main)/(protected)/projects/[projectId]/users/page-client.tsx
@@ -4,21 +4,33 @@ import { stackAppInternalsSymbol } from "@/app/(main)/integrations/transfer-conf
 import { UserTable } from "@/components/data-table/user-table";
 import { StyledLink } from "@/components/link";
 import { UserDialog } from "@/components/user-dialog";
-import { Alert, Button } from "@stackframe/stack-ui";
+import { Alert, Button, Skeleton } from "@stackframe/stack-ui";
+import { Suspense } from "react";
 import { AppEnabledGuard } from "../app-enabled-guard";
 import { PageLayout } from "../page-layout";
 import { useAdminApp } from "../use-admin-app";
 
-export default function PageClient() {
+function TotalUsersDisplay() {
   const stackAdminApp = useAdminApp();
   const data = (stackAdminApp as any)[stackAppInternalsSymbol].useMetrics();
+
+  return <>{data.total_users}</>;
+}
+
+export default function PageClient() {
+  const stackAdminApp = useAdminApp();
   const firstUser = stackAdminApp.useUsers({ limit: 1 });
 
   return (
     <AppEnabledGuard appId="authentication">
       <PageLayout
         title="Users"
-        description={`Total: ${data.total_users}`}
+        description={<>
+          Total:{" "}
+          <Suspense fallback={<Skeleton className="inline"><span>Calculating</span></Skeleton>}>
+            <TotalUsersDisplay />
+          </Suspense>
+        </>}
         actions={<UserDialog
           type="create"
           trigger={<Button>Create User</Button>}

diff --git a/apps/dashboard/src/lib/prefetch/hook-prefetcher.tsx b/apps/dashboard/src/lib/prefetch/hook-prefetcher.tsx
@@ -25,7 +25,9 @@ export function HookPrefetcher(props: {
         if (options.cache.isDirty(options.dependencies)) {
           if (isPrefetching) {
             // all good, continue
-            console.log(`Prefetched ${options.caller}`);
+            if (process.env.NODE_ENV === "development") {
+              console.info(`Prefetching ${options.caller}...`);
+            }
           } else {
             console.warn(deindent`
               Fetched ${options.caller} on ${window.location.pathname} without prefetching! Could you maybe add a HookPrefetcher to make this transition faster?

diff --git a/apps/dev-launchpad/CHANGELOG.md b/apps/dev-launchpad/CHANGELOG.md
@@ -1,5 +1,11 @@
 # @stackframe/dev-launchpad
 
+## 2.8.44
+
+### Patch Changes
+
+- Various changes
+
 ## 2.8.43
 
 ## 2.8.42

diff --git a/apps/dev-launchpad/package.json b/apps/dev-launchpad/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@stackframe/dev-launchpad",
-  "version": "2.8.43",
+  "version": "2.8.44",
   "private": true,
   "scripts": {
     "dev": "node scripts/write-env-config.js && serve -p ${NEXT_PUBLIC_STACK_PORT_PREFIX:-81}00 -s public",

diff --git a/apps/dev-launchpad/public/index.html b/apps/dev-launchpad/public/index.html
@@ -206,13 +206,6 @@ <h2 style="margin-top: 64px;">Background services</h2>
             "Src: ./examples/docs-examples",
           ],
         },
-        {
-          name: "examples/partial-prerendering",
-          portSuffix: "09",
-          description: [
-            "Src: ./examples/partial-prerendering",
-          ],
-        },
         {
           name: "examples/cjs-test",
           portSuffix: "10",

diff --git a/apps/e2e/CHANGELOG.md b/apps/e2e/CHANGELOG.md
@@ -1,5 +1,14 @@
 # @stackframe/e2e-tests
 
+## 2.8.44
+
+### Patch Changes
+
+- Various changes
+- Updated dependencies
+  - @stackframe/stack-shared@2.8.44
+  - @stackframe/js@2.8.44
+
 ## 2.8.43
 
 ### Patch Changes

diff --git a/apps/e2e/package.json b/apps/e2e/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@stackframe/e2e-tests",
-  "version": "2.8.43",
+  "version": "2.8.44",
   "private": true,
   "type": "module",
   "scripts": {

diff --git a/apps/mock-oauth-server/CHANGELOG.md b/apps/mock-oauth-server/CHANGELOG.md
@@ -1,5 +1,7 @@
 # @stackframe/mock-oauth-server
 
+## 2.8.44
+
 ## 2.8.43
 
 ## 2.8.42

diff --git a/apps/mock-oauth-server/package.json b/apps/mock-oauth-server/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@stackframe/mock-oauth-server",
-  "version": "2.8.43",
+  "version": "2.8.44",
   "private": true,
   "main": "index.js",
   "scripts": {

diff --git a/docs/.gitignore b/docs/.gitignore
@@ -27,8 +27,7 @@ yarn-error.log*
 .vercel
 next-env.d.ts
 
-# ignore all generated docs content
-/content/docs/
+# ignore generated API content
 /content/api/
 /public/openapi/
 /openapi/

diff --git a/docs/CHANGELOG.md b/docs/CHANGELOG.md
@@ -1,5 +1,14 @@
 # @stackframe/stack-docs
 
+## 2.8.44
+
+### Patch Changes
+
+- Various changes
+- Updated dependencies
+  - @stackframe/stack-shared@2.8.44
+  - @stackframe/stack@2.8.44
+
 ## 2.8.43
 
 ### Patch Changes

diff --git a/docs/code-examples/index.ts b/docs/code-examples/index.ts
@@ -0,0 +1,22 @@
+import { CodeExample } from '../lib/code-examples';
+import { setupExamples } from './setup';
+
+const allExamples: Record<string, Record<string, Record<string, CodeExample[]>>> = {
+  'setup': setupExamples,
+  // Add more sections here as needed:
+  // 'auth': authExamples,
+  // 'customization': customizationExamples,
+};
+
+export function getExample(documentPath: string, exampleName: string): CodeExample[] | undefined {
+  const [section, ...rest] = documentPath.split('/');
+  const subsection = rest.join('/');
+  return allExamples[section]?.[subsection]?.[exampleName];
+}
+
+export function getDocumentExamples(documentPath: string): Record<string, CodeExample[]> | undefined {
+  const [section, ...rest] = documentPath.split('/');
+  const subsection = rest.join('/');
+  return allExamples[section]?.[subsection];
+}
+