@clerk/tanstack-react-start 1.0.0-snapshot.v20260114034743 → 1.0.0-snapshot.v20260114095952

package/dist/client/ClerkProvider.js

@@ -12,7 +12,7 @@ import { jsxs, Fragment, jsx } from 'react/jsx-runtime';
 // src/client/ClerkProvider.tsx
 var SDK_METADATA = {
   name: "@clerk/tanstack-react-start",
-  version: "1.0.0-snapshot.v20260114034743"
+  version: "1.0.0-snapshot.v20260114095952"
 };
 var awaitableNavigateRef = { current: void 0 };
 function ClerkProvider({

package/dist/server/clerkClient.js

@@ -10,7 +10,7 @@ var clerkClient = (options) => {
     publishableKey: commonEnv.PUBLISHABLE_KEY,
     apiUrl: commonEnv.API_URL,
     apiVersion: commonEnv.API_VERSION,
-    userAgent: `${"@clerk/tanstack-react-start"}@${"1.0.0-snapshot.v20260114034743"}`,
+    userAgent: `${"@clerk/tanstack-react-start"}@${"1.0.0-snapshot.v20260114095952"}`,
     proxyUrl: commonEnv.PROXY_URL,
     domain: commonEnv.DOMAIN,
     isSatellite: commonEnv.IS_SATELLITE,

package/dist/server/constants.js

@@ -27,7 +27,7 @@ var commonEnvs = () => {
     API_URL: getEnvVariable("CLERK_API_URL") || apiUrlFromPublishableKey(publicEnvs.publishableKey),
     SDK_METADATA: {
       name: "@clerk/tanstack-react-start",
-      version: "1.0.0-snapshot.v20260114034743",
+      version: "1.0.0-snapshot.v20260114095952",
       environment: getEnvVariable("NODE_ENV")
     }
   };

package/dist/server/loadOptions.d.ts

@@ -15,6 +15,7 @@ declare const loadOptions: (request: ClerkRequest, overrides?: LoaderOptions) =>
     proxyUrl: string;
     signInUrl: string;
     signUpUrl: string;
+    satelliteAutoSync: boolean | undefined;
     organizationSyncOptions?: _clerk_backend_internal.OrganizationSyncOptions;
     audience?: string | string[] | undefined;
     authorizedParties?: string[] | undefined;
@@ -33,6 +34,7 @@ declare const loadOptions: (request: ClerkRequest, overrides?: LoaderOptions) =>
     proxyUrl: string;
     signInUrl: string;
     signUpUrl: string;
+    satelliteAutoSync: boolean | undefined;
     organizationSyncOptions?: _clerk_backend_internal.OrganizationSyncOptions;
     audience?: string | string[] | undefined;
     authorizedParties?: string[] | undefined;
@@ -51,6 +53,7 @@ declare const loadOptions: (request: ClerkRequest, overrides?: LoaderOptions) =>
     proxyUrl: string;
     signInUrl: string;
     signUpUrl: string;
+    satelliteAutoSync: boolean | undefined;
     organizationSyncOptions?: _clerk_backend_internal.OrganizationSyncOptions;
     audience?: string | string[] | undefined;
     authorizedParties?: string[] | undefined;

package/dist/server/loadOptions.js

@@ -19,6 +19,7 @@ var loadOptions = (request, overrides = {}) => {
   const relativeOrAbsoluteProxyUrl = handleValueOrFn(overrides?.proxyUrl, request.clerkUrl, commonEnv.PROXY_URL);
   const signInUrl = overrides.signInUrl || commonEnv.SIGN_IN_URL;
   const signUpUrl = overrides.signUpUrl || commonEnv.SIGN_UP_URL;
+  const satelliteAutoSync = handleValueOrFn(overrides.satelliteAutoSync, new URL(request.url));
   let proxyUrl;
   if (!!relativeOrAbsoluteProxyUrl && isProxyUrlRelative(relativeOrAbsoluteProxyUrl)) {
     proxyUrl = new URL(relativeOrAbsoluteProxyUrl, request.clerkUrl).toString();
@@ -46,7 +47,8 @@ var loadOptions = (request, overrides = {}) => {
     isSatellite,
     proxyUrl,
     signInUrl,
-    signUpUrl
+    signUpUrl,
+    satelliteAutoSync
   };
 };
 

package/dist/server/loadOptions.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/server/loadOptions.ts"],"names":[],"mappings":";;;;;;;;;AAWO,IAAM,WAAA,GAAc,CAAC,OAAA,EAAuB,SAAA,GAA2B,EAAC,KAAM;AACnF,EAAA,MAAM,YAAY,UAAA,EAAW;AAC7B,EAAA,MAAM,SAAA,GAAY,SAAA,CAAU,SAAA,IAAa,SAAA,CAAU,UAAA;AACnD,EAAA,MAAM,gBAAA,GAAmB,SAAA,CAAU,gBAAA,IAAoB,SAAA,CAAU,kBAAA;AACjE,EAAA,MAAM,cAAA,GAAiB,SAAA,CAAU,cAAA,IAAkB,SAAA,CAAU,eAAA;AAC7D,EAAA,MAAM,MAAA,GAAS,SAAA,CAAU,MAAA,IAAU,SAAA,CAAU,aAAA;AAC7C,EAAA,MAAM,MAAA,GAAS,cAAA,CAAe,eAAe,CAAA,IAAK,yBAAyB,cAAc,CAAA;AACzF,EAAA,MAAM,MAAA,GAAS,eAAA,CAAgB,SAAA,CAAU,MAAA,EAAQ,IAAI,IAAI,OAAA,CAAQ,GAAG,CAAC,CAAA,IAAK,SAAA,CAAU,MAAA;AACpF,EAAA,MAAM,WAAA,GAAc,eAAA,CAAgB,SAAA,CAAU,WAAA,EAAa,IAAI,IAAI,OAAA,CAAQ,GAAG,CAAC,CAAA,IAAK,SAAA,CAAU,YAAA;AAC9F,EAAA,MAAM,6BAA6B,eAAA,CAAgB,SAAA,EAAW,UAAU,OAAA,CAAQ,QAAA,EAAU,UAAU,SAAS,CAAA;AAC7G,EAAA,MAAM,SAAA,GAAY,SAAA,CAAU,SAAA,IAAa,SAAA,CAAU,WAAA;AACnD,EAAA,MAAM,SAAA,GAAY,SAAA,CAAU,SAAA,IAAa,SAAA,CAAU,WAAA;AAEnD,EAAA,IAAI,QAAA;AACJ,EAAA,IAAI,CAAC,CAAC,0BAAA,IAA8B,kBAAA,CAAmB,0BAA0B,CAAA,EAAG;AAClF,IAAA,QAAA,GAAW,IAAI,GAAA,CAAI,0BAAA,EAA4B,OAAA,CAAQ,QAAQ,EAAE,QAAA,EAAS;AAAA,EAC5E,CAAA,MAAO;AACL,IAAA,QAAA,GAAW,0BAAA;AAAA,EACb;AAEA,EAAA,IAAI,CAAC,SAAA,EAAW;AAEd,IAAA,MAAM,YAAA,CAAa,MAAM,+BAA+B,CAAA;AAAA,EAC1D;AAEA,EAAA,IAAI,WAAA,IAAe,CAAC,QAAA,IAAY,CAAC,MAAA,EAAQ;AAEvC,IAAA,MAAM,YAAA,CAAa,MAAM,sDAAsD,CAAA;AAAA,EACjF;AAEA,EAAA,IAAI,eAAe,CAAC,aAAA,CAAc,SAAS,CAAA,IAAK,0BAAA,CAA2B,SAAS,CAAA,EAAG;AAErF,IAAA,MAAM,YAAA,CAAa,MAAM,4DAA4D,CAAA;AAAA,EACvF;AAEA,EAAA,OAAO;AAAA;AAAA,IAEL,GAAG,SAAA;AAAA,IACH,SAAA;AAAA,IACA,gBAAA;AAAA,IACA,cAAA;AAAA,IACA,MAAA;AAAA,IACA,MAAA;AAAA,IACA,MAAA;AAAA,IACA,WAAA;AAAA,IACA,QAAA;AAAA,IACA,SAAA;AAAA,IACA;AAAA,GACF;AACF","file":"loadOptions.js","sourcesContent":["import type { ClerkRequest } from '@clerk/backend/internal';\nimport { apiUrlFromPublishableKey } from '@clerk/shared/apiUrlFromPublishableKey';\nimport { getEnvVariable } from '@clerk/shared/getEnvVariable';\nimport { isDevelopmentFromSecretKey } from '@clerk/shared/keys';\nimport { isHttpOrHttps, isProxyUrlRelative } from '@clerk/shared/proxy';\nimport { handleValueOrFn } from '@clerk/shared/utils';\n\nimport { errorThrower } from '../utils';\nimport { commonEnvs } from './constants';\nimport type { LoaderOptions } from './types';\n\nexport const loadOptions = (request: ClerkRequest, overrides: LoaderOptions = {}) => {\n  const commonEnv = commonEnvs();\n  const secretKey = overrides.secretKey || commonEnv.SECRET_KEY;\n  const machineSecretKey = overrides.machineSecretKey || commonEnv.MACHINE_SECRET_KEY;\n  const publishableKey = overrides.publishableKey || commonEnv.PUBLISHABLE_KEY;\n  const jwtKey = overrides.jwtKey || commonEnv.CLERK_JWT_KEY;\n  const apiUrl = getEnvVariable('CLERK_API_URL') || apiUrlFromPublishableKey(publishableKey);\n  const domain = handleValueOrFn(overrides.domain, new URL(request.url)) || commonEnv.DOMAIN;\n  const isSatellite = handleValueOrFn(overrides.isSatellite, new URL(request.url)) || commonEnv.IS_SATELLITE;\n  const relativeOrAbsoluteProxyUrl = handleValueOrFn(overrides?.proxyUrl, request.clerkUrl, commonEnv.PROXY_URL);\n  const signInUrl = overrides.signInUrl || commonEnv.SIGN_IN_URL;\n  const signUpUrl = overrides.signUpUrl || commonEnv.SIGN_UP_URL;\n\n  let proxyUrl;\n  if (!!relativeOrAbsoluteProxyUrl && isProxyUrlRelative(relativeOrAbsoluteProxyUrl)) {\n    proxyUrl = new URL(relativeOrAbsoluteProxyUrl, request.clerkUrl).toString();\n  } else {\n    proxyUrl = relativeOrAbsoluteProxyUrl;\n  }\n\n  if (!secretKey) {\n    // eslint-disable-next-line @typescript-eslint/only-throw-error\n    throw errorThrower.throw('Clerk: no secret key provided');\n  }\n\n  if (isSatellite && !proxyUrl && !domain) {\n    // eslint-disable-next-line @typescript-eslint/only-throw-error\n    throw errorThrower.throw('Clerk: satellite mode requires a proxy URL or domain');\n  }\n\n  if (isSatellite && !isHttpOrHttps(signInUrl) && isDevelopmentFromSecretKey(secretKey)) {\n    // eslint-disable-next-line @typescript-eslint/only-throw-error\n    throw errorThrower.throw('Clerk: satellite mode requires a sign-in URL in production');\n  }\n\n  return {\n    // used to append options that are not initialized from env\n    ...overrides,\n    secretKey,\n    machineSecretKey,\n    publishableKey,\n    jwtKey,\n    apiUrl,\n    domain,\n    isSatellite,\n    proxyUrl,\n    signInUrl,\n    signUpUrl,\n  };\n};\n"]}
+{"version":3,"sources":["../../src/server/loadOptions.ts"],"names":[],"mappings":";;;;;;;;;AAWO,IAAM,WAAA,GAAc,CAAC,OAAA,EAAuB,SAAA,GAA2B,EAAC,KAAM;AACnF,EAAA,MAAM,YAAY,UAAA,EAAW;AAC7B,EAAA,MAAM,SAAA,GAAY,SAAA,CAAU,SAAA,IAAa,SAAA,CAAU,UAAA;AACnD,EAAA,MAAM,gBAAA,GAAmB,SAAA,CAAU,gBAAA,IAAoB,SAAA,CAAU,kBAAA;AACjE,EAAA,MAAM,cAAA,GAAiB,SAAA,CAAU,cAAA,IAAkB,SAAA,CAAU,eAAA;AAC7D,EAAA,MAAM,MAAA,GAAS,SAAA,CAAU,MAAA,IAAU,SAAA,CAAU,aAAA;AAC7C,EAAA,MAAM,MAAA,GAAS,cAAA,CAAe,eAAe,CAAA,IAAK,yBAAyB,cAAc,CAAA;AACzF,EAAA,MAAM,MAAA,GAAS,eAAA,CAAgB,SAAA,CAAU,MAAA,EAAQ,IAAI,IAAI,OAAA,CAAQ,GAAG,CAAC,CAAA,IAAK,SAAA,CAAU,MAAA;AACpF,EAAA,MAAM,WAAA,GAAc,eAAA,CAAgB,SAAA,CAAU,WAAA,EAAa,IAAI,IAAI,OAAA,CAAQ,GAAG,CAAC,CAAA,IAAK,SAAA,CAAU,YAAA;AAC9F,EAAA,MAAM,6BAA6B,eAAA,CAAgB,SAAA,EAAW,UAAU,OAAA,CAAQ,QAAA,EAAU,UAAU,SAAS,CAAA;AAC7G,EAAA,MAAM,SAAA,GAAY,SAAA,CAAU,SAAA,IAAa,SAAA,CAAU,WAAA;AACnD,EAAA,MAAM,SAAA,GAAY,SAAA,CAAU,SAAA,IAAa,SAAA,CAAU,WAAA;AACnD,EAAA,MAAM,iBAAA,GAAoB,gBAAgB,SAAA,CAAU,iBAAA,EAAmB,IAAI,GAAA,CAAI,OAAA,CAAQ,GAAG,CAAC,CAAA;AAE3F,EAAA,IAAI,QAAA;AACJ,EAAA,IAAI,CAAC,CAAC,0BAAA,IAA8B,kBAAA,CAAmB,0BAA0B,CAAA,EAAG;AAClF,IAAA,QAAA,GAAW,IAAI,GAAA,CAAI,0BAAA,EAA4B,OAAA,CAAQ,QAAQ,EAAE,QAAA,EAAS;AAAA,EAC5E,CAAA,MAAO;AACL,IAAA,QAAA,GAAW,0BAAA;AAAA,EACb;AAEA,EAAA,IAAI,CAAC,SAAA,EAAW;AAEd,IAAA,MAAM,YAAA,CAAa,MAAM,+BAA+B,CAAA;AAAA,EAC1D;AAEA,EAAA,IAAI,WAAA,IAAe,CAAC,QAAA,IAAY,CAAC,MAAA,EAAQ;AAEvC,IAAA,MAAM,YAAA,CAAa,MAAM,sDAAsD,CAAA;AAAA,EACjF;AAEA,EAAA,IAAI,eAAe,CAAC,aAAA,CAAc,SAAS,CAAA,IAAK,0BAAA,CAA2B,SAAS,CAAA,EAAG;AAErF,IAAA,MAAM,YAAA,CAAa,MAAM,4DAA4D,CAAA;AAAA,EACvF;AAEA,EAAA,OAAO;AAAA;AAAA,IAEL,GAAG,SAAA;AAAA,IACH,SAAA;AAAA,IACA,gBAAA;AAAA,IACA,cAAA;AAAA,IACA,MAAA;AAAA,IACA,MAAA;AAAA,IACA,MAAA;AAAA,IACA,WAAA;AAAA,IACA,QAAA;AAAA,IACA,SAAA;AAAA,IACA,SAAA;AAAA,IACA;AAAA,GACF;AACF","file":"loadOptions.js","sourcesContent":["import type { ClerkRequest } from '@clerk/backend/internal';\nimport { apiUrlFromPublishableKey } from '@clerk/shared/apiUrlFromPublishableKey';\nimport { getEnvVariable } from '@clerk/shared/getEnvVariable';\nimport { isDevelopmentFromSecretKey } from '@clerk/shared/keys';\nimport { isHttpOrHttps, isProxyUrlRelative } from '@clerk/shared/proxy';\nimport { handleValueOrFn } from '@clerk/shared/utils';\n\nimport { errorThrower } from '../utils';\nimport { commonEnvs } from './constants';\nimport type { LoaderOptions } from './types';\n\nexport const loadOptions = (request: ClerkRequest, overrides: LoaderOptions = {}) => {\n  const commonEnv = commonEnvs();\n  const secretKey = overrides.secretKey || commonEnv.SECRET_KEY;\n  const machineSecretKey = overrides.machineSecretKey || commonEnv.MACHINE_SECRET_KEY;\n  const publishableKey = overrides.publishableKey || commonEnv.PUBLISHABLE_KEY;\n  const jwtKey = overrides.jwtKey || commonEnv.CLERK_JWT_KEY;\n  const apiUrl = getEnvVariable('CLERK_API_URL') || apiUrlFromPublishableKey(publishableKey);\n  const domain = handleValueOrFn(overrides.domain, new URL(request.url)) || commonEnv.DOMAIN;\n  const isSatellite = handleValueOrFn(overrides.isSatellite, new URL(request.url)) || commonEnv.IS_SATELLITE;\n  const relativeOrAbsoluteProxyUrl = handleValueOrFn(overrides?.proxyUrl, request.clerkUrl, commonEnv.PROXY_URL);\n  const signInUrl = overrides.signInUrl || commonEnv.SIGN_IN_URL;\n  const signUpUrl = overrides.signUpUrl || commonEnv.SIGN_UP_URL;\n  const satelliteAutoSync = handleValueOrFn(overrides.satelliteAutoSync, new URL(request.url));\n\n  let proxyUrl;\n  if (!!relativeOrAbsoluteProxyUrl && isProxyUrlRelative(relativeOrAbsoluteProxyUrl)) {\n    proxyUrl = new URL(relativeOrAbsoluteProxyUrl, request.clerkUrl).toString();\n  } else {\n    proxyUrl = relativeOrAbsoluteProxyUrl;\n  }\n\n  if (!secretKey) {\n    // eslint-disable-next-line @typescript-eslint/only-throw-error\n    throw errorThrower.throw('Clerk: no secret key provided');\n  }\n\n  if (isSatellite && !proxyUrl && !domain) {\n    // eslint-disable-next-line @typescript-eslint/only-throw-error\n    throw errorThrower.throw('Clerk: satellite mode requires a proxy URL or domain');\n  }\n\n  if (isSatellite && !isHttpOrHttps(signInUrl) && isDevelopmentFromSecretKey(secretKey)) {\n    // eslint-disable-next-line @typescript-eslint/only-throw-error\n    throw errorThrower.throw('Clerk: satellite mode requires a sign-in URL in production');\n  }\n\n  return {\n    // used to append options that are not initialized from env\n    ...overrides,\n    secretKey,\n    machineSecretKey,\n    publishableKey,\n    jwtKey,\n    apiUrl,\n    domain,\n    isSatellite,\n    proxyUrl,\n    signInUrl,\n    signUpUrl,\n    satelliteAutoSync,\n  };\n};\n"]}

package/dist/server/types.d.ts

@@ -10,6 +10,22 @@ type ClerkMiddlewareOptions = {
     signInUrl?: string;
     signUpUrl?: string;
     organizationSyncOptions?: OrganizationSyncOptions;
+    /**
+     * Controls whether satellite apps automatically sync with the primary domain on initial page load.
+     *
+     * When `true` (default), satellite apps will automatically trigger a handshake redirect
+     * to sync authentication state with the primary domain, even if no session cookies exist.
+     *
+     * When `false`, satellite apps will skip the automatic handshake if no session cookies exist,
+     * and only trigger the handshake after an explicit sign-in action (when the `__clerk_sync=1`
+     * query parameter is present). This optimizes performance for satellite apps where users
+     * may not be authenticated, avoiding unnecessary redirects to the primary domain.
+     *
+     * Can be a boolean or a callback that receives the request URL and returns a boolean.
+     *
+     * @default true
+     */
+    satelliteAutoSync?: boolean | ((url: URL) => boolean);
 } & Pick<VerifyTokenOptions, 'audience' | 'authorizedParties'> & MultiDomainAndOrProxy & SignInForceRedirectUrl & SignInFallbackRedirectUrl & SignUpForceRedirectUrl & SignUpFallbackRedirectUrl;
 type LoaderOptions = ClerkMiddlewareOptions;
 type AdditionalStateOptions = SignInFallbackRedirectUrl & SignUpFallbackRedirectUrl & SignInForceRedirectUrl & SignUpForceRedirectUrl;

package/dist/utils/index.d.ts

@@ -1,7 +1,7 @@
-import * as _clerk_shared_index_D2EaVwjc from '@clerk/shared/index-D2EaVwjc';
+import * as _clerk_shared_index_Bzvl2mNK from '@clerk/shared/index-Bzvl2mNK';
 
 declare const isClient: () => boolean;
 declare const isServer: () => boolean;
-declare const errorThrower: _clerk_shared_index_D2EaVwjc.Zn;
+declare const errorThrower: _clerk_shared_index_Bzvl2mNK.Zn;
 
 export { errorThrower, isClient, isServer };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clerk/tanstack-react-start",
-  "version": "1.0.0-snapshot.v20260114034743",
+  "version": "1.0.0-snapshot.v20260114095952",
   "description": "Clerk SDK for TanStack React Start",
   "keywords": [
     "clerk",
@@ -64,9 +64,9 @@
   ],
   "dependencies": {
     "tslib": "2.8.1",
-    "@clerk/backend": "3.0.0-snapshot.v20260114034743",
-    "@clerk/react": "6.0.0-snapshot.v20260114034743",
-    "@clerk/shared": "4.0.0-snapshot.v20260114034743"
+    "@clerk/shared": "4.0.0-snapshot.v20260114095952",
+    "@clerk/react": "6.0.0-snapshot.v20260114095952",
+    "@clerk/backend": "3.0.0-snapshot.v20260114095952"
   },
   "devDependencies": {
     "@tanstack/react-router": "1.132.0",