feat(*): add /types subpath export to SDK packages

Why:
Developers currently need to install @clerk/types as a separate package
to access Clerk types. This adds friction and can cause version mismatches
between the types package and SDK.

What changed:
Added /types subpath export to 11 SDK packages that re-exports types from
@clerk/shared/types along with SDK-specific types. Developers can now import
types directly from their SDK:

  import type { UserResource } from '@clerk/react/types'

Packages updated:
- @clerk/react
- @clerk/nextjs
- @clerk/tanstack-react-start
- @clerk/react-router
- @clerk/express
- @clerk/fastify
- @clerk/astro
- @clerk/nuxt
- @clerk/vue
- @clerk/expo
- @clerk/chrome-extension

Author: nikosdouvlis

.changeset/types-subpath-export.md

@@ -0,0 +1,15 @@
+---
+'@clerk/react': minor
+'@clerk/nextjs': minor
+'@clerk/tanstack-react-start': minor
+'@clerk/react-router': minor
+'@clerk/express': minor
+'@clerk/fastify': minor
+'@clerk/astro': minor
+'@clerk/nuxt': minor
+'@clerk/vue': minor
+'@clerk/expo': minor
+'@clerk/chrome-extension': minor
+---
+
+Add `/types` subpath export to re-export types from `@clerk/shared/types` along with SDK-specific types. This allows importing Clerk types directly from the SDK package (e.g., `import type { UserResource } from '@clerk/react/types'`) without needing to install `@clerk/types` as a separate dependency.

packages/astro/package.json

@@ -59,6 +59,10 @@
       "types": "./dist/webhooks.d.ts",
       "default": "./dist/webhooks.js"
     },
+    "./types": {
+      "types": "./dist/types/index.d.ts",
+      "default": "./dist/types/index.js"
+    },
     "./env": "./env.d.ts",
     "./components": "./components/index.ts",
     "./package.json": "./package.json"

packages/astro/src/types/index.ts

@@ -0,0 +1,37 @@
+/**
+ * Re-export all shared types
+ */
+export type * from '@clerk/shared/types';
+
+/**
+ * Astro-specific types
+ */
+export type {
+  AstroClerkUpdateOptions,
+  AstroClerkIntegrationParams,
+  AstroClerkCreateInstanceParams,
+  HeadlessBrowserClerk,
+  BrowserClerk,
+  ProtectParams,
+  ProtectProps,
+  ShowProps,
+  ButtonProps,
+  InternalUIComponentId,
+} from '../types';
+
+/**
+ * Astro server types
+ */
+export type {
+  AstroMiddleware,
+  AstroMiddlewareContextParam,
+  AstroMiddlewareNextParam,
+  AstroMiddlewareReturn,
+  SessionAuthObjectWithRedirect,
+  AuthFn,
+} from '../server/types';
+
+/**
+ * Astro React types
+ */
+export type { SignInButtonProps, SignUpButtonProps } from '../react/types';

packages/astro/tsup.config.ts

@@ -15,6 +15,7 @@ export default defineConfig(() => {
       './src/async-local-storage.client.ts',
       './src/async-local-storage.server.ts',
       './src/webhooks.ts',
+      './src/types/index.ts',
     ],
     dts: true,
     minify: false,

packages/chrome-extension/package.json

@@ -29,7 +29,8 @@
     "background",
     "dist",
     "internal",
-    "react"
+    "react",
+    "types"
   ],
   "scripts": {
     "build": "tsup",

packages/chrome-extension/src/types/index.ts

@@ -0,0 +1,17 @@
+/**
+ * Re-export all shared types from @clerk/shared/types
+ */
+export type * from '@clerk/shared/types';
+
+/**
+ * Chrome Extension-specific types
+ */
+
+// Core types from src/types.ts
+export type { Scope, ClerkClientExtensionFeatures } from '../types';
+
+// Storage types
+export type { StorageCache } from '../internal/utils/storage';
+
+// Internal Clerk client options
+export type { CreateClerkClientOptions } from '../internal/clerk';

packages/chrome-extension/tsup.config.ts

@@ -9,7 +9,7 @@ export default defineConfig(overrideOptions => {
   const shouldPublish = !!overrideOptions.env?.publish;
 
   const common: Options = {
-    entry: ['./src/index.ts', './src/background/index.ts', './src/react/index.ts'],
+    entry: ['./src/index.ts', './src/background/index.ts', './src/react/index.ts', './src/types/index.ts'],
     bundle: true,
     clean: true,
     minify: false,

packages/chrome-extension/types/package.json

@@ -0,0 +1,5 @@
+{
+  "main": "../dist/cjs/types/index.js",
+  "module": "../dist/esm/types/index.js",
+  "types": "../dist/types/types/index.d.ts"
+}

packages/expo/package.json

@@ -60,6 +60,10 @@
       "types": "./dist/legacy.d.ts",
       "default": "./dist/legacy.js"
     },
+    "./types": {
+      "types": "./dist/types/index.d.ts",
+      "default": "./dist/types/index.js"
+    },
     "./app.plugin.js": "./app.plugin.js"
   },
   "main": "./dist/index.js",

packages/expo/src/types/index.ts

@@ -0,0 +1,32 @@
+// Re-export all types from @clerk/shared/types
+export type * from '@clerk/shared/types';
+
+// Expo-specific types
+export type { ClerkProviderProps } from '../provider/ClerkProvider';
+export type { TokenCache, ResourceCache, ResourceCacheInitOptions } from '../cache/types';
+export type { IStorage, BuildClerkOptions } from '../provider/singleton/types';
+
+// OAuth/SSO hook types
+export type { UseOAuthFlowParams, StartOAuthFlowParams, StartOAuthFlowReturnType } from '../hooks/useOAuth';
+export type { StartSSOFlowParams, StartSSOFlowReturnType } from '../hooks/useSSO';
+
+// Google Sign-In types
+export type {
+  StartGoogleAuthenticationFlowParams,
+  StartGoogleAuthenticationFlowReturnType,
+} from '../hooks/useSignInWithGoogle.types';
+
+// Google One Tap types
+export type {
+  ConfigureParams,
+  SignInParams,
+  CreateAccountParams,
+  ExplicitSignInParams,
+  GoogleUser,
+  OneTapSuccessResponse,
+  CancelledResponse,
+  NoSavedCredentialFound,
+  OneTapResponse,
+  GoogleSignInErrorCode,
+  GoogleSignInError,
+} from '../google-one-tap/types';