docs(upgrade,tanstack-react-start,expo): Fix stale Core 3 upgrade docs and READMEs

.changeset/stale-core-3-upgrade-docs.md

@@ -0,0 +1,5 @@
+---
+'@clerk/upgrade': patch
+---
+
+Correct Core 3 upgrade guide entries: the `idPOAuthAccessToken` property name in the backend verify example is fixed, `@clerk/react-router/api.server` is described as deprecated (still exported) instead of removed, and the Expo minimum version check now flags caret ranges such as `"expo": "^52.1.0"`.

packages/expo-passkeys/README.md

@@ -27,7 +27,7 @@
 
 ### Prerequisites
 
-- Expo 53 or later
+- Expo 54 to 58
 - React 18 or later
 - React Native 0.73 or later
 - Node.js `>=20.9.0` or later

packages/expo/README.md

@@ -32,7 +32,7 @@
 ### Prerequisites
 
 - React 18 or later
-- Expo 53 or later
+- Expo 54 to 58
 - React Native 0.73 or later
 - Node.js `>=20.9.0` or later
 - An existing Expo application

packages/tanstack-react-start/README.md

@@ -41,7 +41,7 @@
 
 The fastest way to get started with Clerk is by following the [TanStack React Start Quickstart](https://clerk.com/docs/quickstarts/tanstack-react-start?utm_source=github&utm_medium=clerk_tanstack_react_start).
 
-You'll learn how to install `@clerk/tanstack-react-start`, set up your environment keys, configure `createClerkHandler` and protect your pages.
+You'll learn how to install `@clerk/tanstack-react-start`, set up your environment keys, configure `clerkMiddleware()` and protect your pages.
 
 ## Usage
 

packages/upgrade/src/__tests__/integration/config.test.js

@@ -43,6 +43,15 @@ describe('loadConfig', () => {
     expect(config.needsUpgrade).toBe(true);
   });
 
+  it('flags Expo versions below 53, including caret ranges', async () => {
+    const config = await loadConfig('expo', 2);
+    const { matcher } = config.changes.find(change => change.docsAnchor === 'expo-min-version');
+
+    expect('"expo": "^52.1.0"'.match(matcher)).not.toBeNull();
+    expect('"expo": "~52.0.0"'.match(matcher)).not.toBeNull();
+    expect('"expo": "~53.0.0"'.match(matcher)).toBeNull();
+  });
+
   it('returns null for unsupported SDK version (too old)', async () => {
     const config = await loadConfig('nextjs', 4);
 

packages/upgrade/src/versions/core-3/changes/backend-deprecated-verify-methods-removed.md

@@ -14,8 +14,8 @@ The deprecated `verifySecret()`, `verifyAccessToken()`, and `verifyToken()` meth
 - await clerkClient.apiKeys.verifySecret(secret);
 + await clerkClient.apiKeys.verify(secret);
 
-- await clerkClient.idpOAuthAccessToken.verifyAccessToken(accessToken);
-+ await clerkClient.idpOAuthAccessToken.verify(accessToken);
+- await clerkClient.idPOAuthAccessToken.verifyAccessToken(accessToken);
++ await clerkClient.idPOAuthAccessToken.verify(accessToken);
 
 - await clerkClient.m2m.verifyToken(params);
 + await clerkClient.m2m.verify(params);

packages/upgrade/src/versions/core-3/changes/expo-min-version.md

@@ -1,7 +1,7 @@
 ---
 title: 'Minimum Expo version increased to 53'
 packages: ['expo']
-matcher: "expo\":\\s*\"(?:^|~|>|=|\\s)*(?:50|51|52)\\..*?"
+matcher: "expo\":\\s*\"(?:\\^|~|>|=|\\s)*(?:50|51|52)\\..*?"
 matcherFlags: 'm'
 category: 'version'
 ---

packages/upgrade/src/versions/core-3/changes/react-router-api-server-removed.md

@@ -1,15 +1,16 @@
 ---
-title: '`@clerk/react-router/api.server` export removed'
+title: '`@clerk/react-router/api.server` export deprecated'
 packages: ['react-router']
 matcher: '@clerk/react-router/api.server'
-category: 'breaking'
+category: 'deprecation'
+warning: true
 ---
 
-The `@clerk/react-router/api.server` export has been removed. Use `@clerk/react-router/server` instead.
+The `@clerk/react-router/api.server` export is deprecated and will be removed in a future major version. Use `@clerk/react-router/server` instead.
 
 ```diff
-- import { getAuth } from '@clerk/react-router/api.server';
-+ import { getAuth } from '@clerk/react-router/server';
+- import { createClerkClient } from '@clerk/react-router/api.server';
++ import { createClerkClient } from '@clerk/react-router/server';
 ```
 
 A codemod is available to automatically apply this change: