@clerk/types 4.54.2-snapshot.v20250417032557 → 4.54.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.mts CHANGED
@@ -1304,7 +1304,7 @@ type GetOrganizationMemberships = (params?: GetUserOrganizationMembershipParams)
1304
1304
  */
1305
1305
  type PendingSessionOptions = {
1306
1306
  /**
1307
- * Determines if pending sessions are considered as signed-out state.
1307
+ * A boolean that indicates whether pending sessions are considered as signed out or not.
1308
1308
  * @default true
1309
1309
  */
1310
1310
  treatPendingAsSignedOut?: boolean;
@@ -2090,8 +2090,8 @@ type AfterSignOutUrl = {
2090
2090
  };
2091
2091
  type AfterMultiSessionSingleSignOutUrl = {
2092
2092
  /**
2093
- * Full URL or path to navigate to after signing out the current user is complete.
2094
- * This option applies to multi-session applications.
2093
+ * The full URL or path to navigate to after signing out the current user is complete.
2094
+ * This option applies to [multi-session applications](https://clerk.com/docs/authentication/configuration/session-options#multi-session-applications).
2095
2095
  */
2096
2096
  afterMultiSessionSingleSignOutUrl?: string | null;
2097
2097
  };
@@ -2119,13 +2119,13 @@ type LegacyRedirectProps = {
2119
2119
  type RedirectOptions = SignInForceRedirectUrl & SignInFallbackRedirectUrl & SignUpForceRedirectUrl & SignUpFallbackRedirectUrl & LegacyRedirectProps;
2120
2120
  type AuthenticateWithRedirectParams = {
2121
2121
  /**
2122
- * Full URL or path to the route that will complete the OAuth or SAML flow.
2122
+ * The full URL or path to the route that will complete the OAuth or SAML flow.
2123
2123
  * Typically, this will be a simple `/sso-callback` route that calls `Clerk.handleRedirectCallback`
2124
2124
  * or mounts the <AuthenticateWithRedirectCallback /> component.
2125
2125
  */
2126
2126
  redirectUrl: string;
2127
2127
  /**
2128
- * Full URL or path to navigate to after the OAuth or SAML flow completes.
2128
+ * The full URL or path to navigate to after the OAuth or SAML flow completes.
2129
2129
  */
2130
2130
  redirectUrlComplete: string;
2131
2131
  /**
@@ -2161,7 +2161,7 @@ type RedirectUrlProp = {
2161
2161
  };
2162
2162
  type SignUpForceRedirectUrl = {
2163
2163
  /**
2164
- * If provided, this URL will always be redirected to after the user signs up. It's recommended to use the [environment variable](https://clerk.com/docs/deployments/clerk-environment-variables#sign-in-and-sign-up-redirects) instead.
2164
+ * This URL will always be redirected to after the user signs up. It's recommended to use the [environment variable](https://clerk.com/docs/deployments/clerk-environment-variables#sign-in-and-sign-up-redirects) instead.
2165
2165
  */
2166
2166
  signUpForceRedirectUrl?: string | null;
2167
2167
  };
@@ -2181,14 +2181,13 @@ type SignInFallbackRedirectUrl = {
2181
2181
  };
2182
2182
  type SignInForceRedirectUrl = {
2183
2183
  /**
2184
- * If provided, this URL will always be redirected to after the user signs in. It's recommended to use the [environment variable](https://clerk.com/docs/deployments/clerk-environment-variables#sign-in-and-sign-up-redirects) instead.
2184
+ * This URL will always be redirected to after the user signs in. It's recommended to use the [environment variable](https://clerk.com/docs/deployments/clerk-environment-variables#sign-in-and-sign-up-redirects) instead.
2185
2185
  */
2186
2186
  signInForceRedirectUrl?: string | null;
2187
2187
  };
2188
2188
 
2189
2189
  /**
2190
2190
  * The `SignIn` object holds the state of the current sign-in and provides helper methods to navigate and complete the sign-in process. It is used to manage the sign-in lifecycle, including the first and second factor verification, and the creation of a new session.
2191
- * @interface
2192
2191
  */
2193
2192
  interface SignInResource extends ClerkResource {
2194
2193
  /**
@@ -2221,6 +2220,9 @@ interface SignInResource extends ClerkResource {
2221
2220
  authenticateWithPasskey: (params?: AuthenticateWithPasskeyParams) => Promise<SignInResource>;
2222
2221
  createEmailLinkFlow: () => CreateEmailLinkFlowReturn<SignInStartEmailLinkFlowParams, SignInResource>;
2223
2222
  validatePassword: (password: string, callbacks?: ValidatePasswordCallbacks) => void;
2223
+ /**
2224
+ * @internal
2225
+ */
2224
2226
  __internal_toSnapshot: () => SignInJSONSnapshot;
2225
2227
  }
2226
2228
  type SignInStatus = 'needs_identifier' | 'needs_first_factor' | 'needs_second_factor' | 'needs_new_password' | 'complete';
@@ -3539,12 +3541,20 @@ type ElementsConfig = {
3539
3541
  invoiceRoot: WithOptions;
3540
3542
  invoiceCard: WithOptions;
3541
3543
  invoiceHeader: WithOptions;
3544
+ invoiceHeaderContent: WithOptions;
3542
3545
  invoiceTitle: WithOptions;
3546
+ invoiceHeaderTitleBadgeContainer: WithOptions;
3547
+ invoiceTitleIdContainer: WithOptions;
3548
+ invoiceId: WithOptions;
3549
+ invoiceIdContainer: WithOptions;
3543
3550
  invoiceBadge: WithOptions;
3544
3551
  invoiceDetails: WithOptions;
3545
3552
  invoiceDetailsItem: WithOptions;
3546
3553
  invoiceDetailsItemTitle: WithOptions;
3554
+ invoiceDetailsItemTitleText: WithOptions;
3547
3555
  invoiceDetailsItemValue: WithOptions;
3556
+ invoiceDetailsItemValueText: WithOptions;
3557
+ invoiceCopyButton: WithOptions;
3548
3558
  invoiceContent: WithOptions;
3549
3559
  menuButton: WithOptions<MenuId>;
3550
3560
  menuButtonEllipsis: WithOptions;
@@ -3973,7 +3983,7 @@ type InstanceType = 'production' | 'development';
3973
3983
  type LocalizationValue = string;
3974
3984
  /**
3975
3985
  * A type containing all the possible localization keys the prebuilt Clerk components support.
3976
- * Users aiming to customise a few strings can also peak at the `data-localization-key` attribute by inspecting
3986
+ * Users aiming to customize a few strings can also peak at the `data-localization-key` attribute by inspecting
3977
3987
  * the DOM and updating the corresponding key.
3978
3988
  * Users aiming to completely localize the components by providing a complete translation can use
3979
3989
  * the default english resource object from {@link https://github.com/clerk/javascript Clerk's open source repo}
@@ -6545,7 +6555,7 @@ type UseSessionReturn = {
6545
6555
  */
6546
6556
  isSignedIn: undefined;
6547
6557
  /**
6548
- * Holds the current active session for the user.
6558
+ * The current active session for the user.
6549
6559
  */
6550
6560
  session: undefined;
6551
6561
  } | {
@@ -6591,7 +6601,7 @@ type UseUserReturn = {
6591
6601
  */
6592
6602
  isSignedIn: undefined;
6593
6603
  /**
6594
- * The `User` object for the current user. If the user isn't signed in, `user` will be `null`.
6604
+ * The `User` object for the current user.
6595
6605
  */
6596
6606
  user: undefined;
6597
6607
  } | {
@@ -6619,7 +6629,7 @@ type PublishableKey = {
6619
6629
  */
6620
6630
  type MultiDomainAndOrProxy = {
6621
6631
  /**
6622
- * Whether the application is a satellite application.
6632
+ * A boolean that indicates whether the application is a satellite application.
6623
6633
  */
6624
6634
  isSatellite?: never;
6625
6635
  /**
@@ -6641,7 +6651,7 @@ type MultiDomainAndOrProxy = {
6641
6651
  };
6642
6652
  type MultiDomainAndOrProxyPrimitives = {
6643
6653
  /**
6644
- * Whether the application is a satellite application.
6654
+ * A boolean that indicates whether the application is a satellite application.
6645
6655
  */
6646
6656
  isSatellite?: never;
6647
6657
  /**
package/dist/index.d.ts CHANGED
@@ -1304,7 +1304,7 @@ type GetOrganizationMemberships = (params?: GetUserOrganizationMembershipParams)
1304
1304
  */
1305
1305
  type PendingSessionOptions = {
1306
1306
  /**
1307
- * Determines if pending sessions are considered as signed-out state.
1307
+ * A boolean that indicates whether pending sessions are considered as signed out or not.
1308
1308
  * @default true
1309
1309
  */
1310
1310
  treatPendingAsSignedOut?: boolean;
@@ -2090,8 +2090,8 @@ type AfterSignOutUrl = {
2090
2090
  };
2091
2091
  type AfterMultiSessionSingleSignOutUrl = {
2092
2092
  /**
2093
- * Full URL or path to navigate to after signing out the current user is complete.
2094
- * This option applies to multi-session applications.
2093
+ * The full URL or path to navigate to after signing out the current user is complete.
2094
+ * This option applies to [multi-session applications](https://clerk.com/docs/authentication/configuration/session-options#multi-session-applications).
2095
2095
  */
2096
2096
  afterMultiSessionSingleSignOutUrl?: string | null;
2097
2097
  };
@@ -2119,13 +2119,13 @@ type LegacyRedirectProps = {
2119
2119
  type RedirectOptions = SignInForceRedirectUrl & SignInFallbackRedirectUrl & SignUpForceRedirectUrl & SignUpFallbackRedirectUrl & LegacyRedirectProps;
2120
2120
  type AuthenticateWithRedirectParams = {
2121
2121
  /**
2122
- * Full URL or path to the route that will complete the OAuth or SAML flow.
2122
+ * The full URL or path to the route that will complete the OAuth or SAML flow.
2123
2123
  * Typically, this will be a simple `/sso-callback` route that calls `Clerk.handleRedirectCallback`
2124
2124
  * or mounts the <AuthenticateWithRedirectCallback /> component.
2125
2125
  */
2126
2126
  redirectUrl: string;
2127
2127
  /**
2128
- * Full URL or path to navigate to after the OAuth or SAML flow completes.
2128
+ * The full URL or path to navigate to after the OAuth or SAML flow completes.
2129
2129
  */
2130
2130
  redirectUrlComplete: string;
2131
2131
  /**
@@ -2161,7 +2161,7 @@ type RedirectUrlProp = {
2161
2161
  };
2162
2162
  type SignUpForceRedirectUrl = {
2163
2163
  /**
2164
- * If provided, this URL will always be redirected to after the user signs up. It's recommended to use the [environment variable](https://clerk.com/docs/deployments/clerk-environment-variables#sign-in-and-sign-up-redirects) instead.
2164
+ * This URL will always be redirected to after the user signs up. It's recommended to use the [environment variable](https://clerk.com/docs/deployments/clerk-environment-variables#sign-in-and-sign-up-redirects) instead.
2165
2165
  */
2166
2166
  signUpForceRedirectUrl?: string | null;
2167
2167
  };
@@ -2181,14 +2181,13 @@ type SignInFallbackRedirectUrl = {
2181
2181
  };
2182
2182
  type SignInForceRedirectUrl = {
2183
2183
  /**
2184
- * If provided, this URL will always be redirected to after the user signs in. It's recommended to use the [environment variable](https://clerk.com/docs/deployments/clerk-environment-variables#sign-in-and-sign-up-redirects) instead.
2184
+ * This URL will always be redirected to after the user signs in. It's recommended to use the [environment variable](https://clerk.com/docs/deployments/clerk-environment-variables#sign-in-and-sign-up-redirects) instead.
2185
2185
  */
2186
2186
  signInForceRedirectUrl?: string | null;
2187
2187
  };
2188
2188
 
2189
2189
  /**
2190
2190
  * The `SignIn` object holds the state of the current sign-in and provides helper methods to navigate and complete the sign-in process. It is used to manage the sign-in lifecycle, including the first and second factor verification, and the creation of a new session.
2191
- * @interface
2192
2191
  */
2193
2192
  interface SignInResource extends ClerkResource {
2194
2193
  /**
@@ -2221,6 +2220,9 @@ interface SignInResource extends ClerkResource {
2221
2220
  authenticateWithPasskey: (params?: AuthenticateWithPasskeyParams) => Promise<SignInResource>;
2222
2221
  createEmailLinkFlow: () => CreateEmailLinkFlowReturn<SignInStartEmailLinkFlowParams, SignInResource>;
2223
2222
  validatePassword: (password: string, callbacks?: ValidatePasswordCallbacks) => void;
2223
+ /**
2224
+ * @internal
2225
+ */
2224
2226
  __internal_toSnapshot: () => SignInJSONSnapshot;
2225
2227
  }
2226
2228
  type SignInStatus = 'needs_identifier' | 'needs_first_factor' | 'needs_second_factor' | 'needs_new_password' | 'complete';
@@ -3539,12 +3541,20 @@ type ElementsConfig = {
3539
3541
  invoiceRoot: WithOptions;
3540
3542
  invoiceCard: WithOptions;
3541
3543
  invoiceHeader: WithOptions;
3544
+ invoiceHeaderContent: WithOptions;
3542
3545
  invoiceTitle: WithOptions;
3546
+ invoiceHeaderTitleBadgeContainer: WithOptions;
3547
+ invoiceTitleIdContainer: WithOptions;
3548
+ invoiceId: WithOptions;
3549
+ invoiceIdContainer: WithOptions;
3543
3550
  invoiceBadge: WithOptions;
3544
3551
  invoiceDetails: WithOptions;
3545
3552
  invoiceDetailsItem: WithOptions;
3546
3553
  invoiceDetailsItemTitle: WithOptions;
3554
+ invoiceDetailsItemTitleText: WithOptions;
3547
3555
  invoiceDetailsItemValue: WithOptions;
3556
+ invoiceDetailsItemValueText: WithOptions;
3557
+ invoiceCopyButton: WithOptions;
3548
3558
  invoiceContent: WithOptions;
3549
3559
  menuButton: WithOptions<MenuId>;
3550
3560
  menuButtonEllipsis: WithOptions;
@@ -3973,7 +3983,7 @@ type InstanceType = 'production' | 'development';
3973
3983
  type LocalizationValue = string;
3974
3984
  /**
3975
3985
  * A type containing all the possible localization keys the prebuilt Clerk components support.
3976
- * Users aiming to customise a few strings can also peak at the `data-localization-key` attribute by inspecting
3986
+ * Users aiming to customize a few strings can also peak at the `data-localization-key` attribute by inspecting
3977
3987
  * the DOM and updating the corresponding key.
3978
3988
  * Users aiming to completely localize the components by providing a complete translation can use
3979
3989
  * the default english resource object from {@link https://github.com/clerk/javascript Clerk's open source repo}
@@ -6545,7 +6555,7 @@ type UseSessionReturn = {
6545
6555
  */
6546
6556
  isSignedIn: undefined;
6547
6557
  /**
6548
- * Holds the current active session for the user.
6558
+ * The current active session for the user.
6549
6559
  */
6550
6560
  session: undefined;
6551
6561
  } | {
@@ -6591,7 +6601,7 @@ type UseUserReturn = {
6591
6601
  */
6592
6602
  isSignedIn: undefined;
6593
6603
  /**
6594
- * The `User` object for the current user. If the user isn't signed in, `user` will be `null`.
6604
+ * The `User` object for the current user.
6595
6605
  */
6596
6606
  user: undefined;
6597
6607
  } | {
@@ -6619,7 +6629,7 @@ type PublishableKey = {
6619
6629
  */
6620
6630
  type MultiDomainAndOrProxy = {
6621
6631
  /**
6622
- * Whether the application is a satellite application.
6632
+ * A boolean that indicates whether the application is a satellite application.
6623
6633
  */
6624
6634
  isSatellite?: never;
6625
6635
  /**
@@ -6641,7 +6651,7 @@ type MultiDomainAndOrProxy = {
6641
6651
  };
6642
6652
  type MultiDomainAndOrProxyPrimitives = {
6643
6653
  /**
6644
- * Whether the application is a satellite application.
6654
+ * A boolean that indicates whether the application is a satellite application.
6645
6655
  */
6646
6656
  isSatellite?: never;
6647
6657
  /**
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@clerk/types",
3
- "version": "4.54.2-snapshot.v20250417032557",
3
+ "version": "4.54.2",
4
4
  "description": "Typings for Clerk libraries.",
5
5
  "keywords": [
6
6
  "clerk",