chore(shared): Remove top-level exports (#6940)

Author: jacekradko

.changeset/twenty-rockets-stop.md

@@ -0,0 +1,5 @@
+---
+'@clerk/shared': major
+---
+
+Removing deprecated top-level exports from @clerk/shared

.typedoc/__tests__/__snapshots__/file-structure.test.ts.snap

@@ -141,51 +141,9 @@ exports[`Typedoc output > should have a deliberate file structure 1`] = `
   "types/user-organization-invitation-resource.mdx",
   "types/user-resource.mdx",
   "types/without.mdx",
-  "shared/api-url-from-publishable-key.mdx",
-  "shared/build-clerk-js-script-attributes.mdx",
-  "shared/build-publishable-key.mdx",
-  "shared/camel-to-snake.mdx",
-  "shared/clerk-js-script-url.mdx",
-  "shared/clerk-runtime-error.mdx",
-  "shared/create-dev-or-staging-url-cache.mdx",
-  "shared/create-path-matcher.mdx",
-  "shared/deep-camel-to-snake.mdx",
-  "shared/deep-snake-to-camel.mdx",
-  "shared/deprecated-object-property.mdx",
-  "shared/derive-state.mdx",
-  "shared/extract-dev-browser-jwt-from-url.mdx",
-  "shared/fast-deep-merge-and-replace.mdx",
-  "shared/get-clerk-js-major-version-or-tag.mdx",
-  "shared/get-cookie-suffix.mdx",
-  "shared/get-env-variable.mdx",
-  "shared/get-non-undefined-values.mdx",
-  "shared/get-script-url.mdx",
-  "shared/get-suffixed-cookie-name.mdx",
-  "shared/icon-image-url.mdx",
-  "shared/in-browser.mdx",
-  "shared/is-browser-online.mdx",
-  "shared/is-clerk-runtime-error.mdx",
-  "shared/is-development-from-publishable-key.mdx",
-  "shared/is-development-from-secret-key.mdx",
-  "shared/is-ipv4-address.mdx",
-  "shared/is-production-from-publishable-key.mdx",
-  "shared/is-production-from-secret-key.mdx",
-  "shared/is-publishable-key.mdx",
-  "shared/is-staging.mdx",
-  "shared/is-truthy.mdx",
-  "shared/is-valid-browser-online.mdx",
-  "shared/is-valid-browser.mdx",
-  "shared/isomorphic-atob.mdx",
-  "shared/load-clerk-js-script.mdx",
   "shared/pages-or-infinite-options.mdx",
   "shared/paginated-hook-config.mdx",
   "shared/paginated-resources.mdx",
-  "shared/parse-publishable-key.mdx",
-  "shared/read-json-file.mdx",
-  "shared/set-clerk-js-loading-error-package-name.mdx",
-  "shared/snake-to-camel.mdx",
-  "shared/titleize.mdx",
-  "shared/to-sentence.mdx",
   "shared/use-clerk.mdx",
   "shared/use-organization-list-params.mdx",
   "shared/use-organization-list-return.mdx",
@@ -197,8 +155,6 @@ exports[`Typedoc output > should have a deliberate file structure 1`] = `
   "shared/use-session-list.mdx",
   "shared/use-session.mdx",
   "shared/use-user.mdx",
-  "shared/user-agent-is-robot.mdx",
-  "shared/version-selector.mdx",
   "react/api-keys.mdx",
   "react/checkout-button-props.mdx",
   "react/checkout-button.mdx",

packages/elements/src/internals/errors/index.ts

@@ -1,5 +1,4 @@
-// eslint-disable-next-line no-restricted-imports
-import type { MetamaskError } from '@clerk/shared';
+import type { MetamaskError } from '@clerk/shared/error';
 import type { ClerkAPIError } from '@clerk/types';
 
 export abstract class ClerkElementsErrorBase extends Error {

packages/shared/src/index.ts

@@ -1,39 +1,5 @@
-/** The following files are not exported on purpose:
- * - cookie.ts
- * - globs.ts
- *
- * The following folders are also not exported on purpose:
- * - react
- *
- * People should always use @clerk/shared/<name> instead
- */
+throw new Error(
+  'Do not import from the top-level of @clerk/shared directly. Import from specific subpaths like @clerk/shared/react or @clerk/shared/authorization instead.',
+);
 
-export * from './utils';
-
-export { apiUrlFromPublishableKey } from './apiUrlFromPublishableKey';
-export * from './browser';
-export * from './color';
-export * from './constants';
-export * from './date';
-export * from './deprecated';
-export { deriveState } from './deriveState';
-export * from './error';
-export * from './file';
-export { isomorphicAtob } from './isomorphicAtob';
-export { isomorphicBtoa } from './isomorphicBtoa';
-export * from './keys';
-export * from './loadClerkJsScript';
-export { loadScript } from './loadScript';
-export { LocalStorageBroadcastChannel } from './localStorageBroadcastChannel';
-export * from './poller';
-export * from './proxy';
-export * from './underscore';
-export * from './url';
-export { versionSelector } from './versionSelector';
-export * from './object';
-export * from './logger';
-export { createWorkerTimers } from './workerTimers';
-export { DEV_BROWSER_JWT_KEY, extractDevBrowserJWTFromURL, setDevBrowserJWTInURL } from './devBrowser';
-export { getEnvVariable } from './getEnvVariable';
-export * from './pathMatcher';
-export * from './netlifyCacheHandler';
+export {};

packages/shared/src/react/hooks/useCheckout.ts

@@ -6,7 +6,7 @@ import type {
 } from '@clerk/types';
 import { useMemo, useSyncExternalStore } from 'react';
 
-import type { ClerkAPIResponseError } from '../..';
+import type { ClerkAPIResponseError } from '../../error';
 import type { __experimental_CheckoutProvider } from '../contexts';
 import { useCheckoutContext } from '../contexts';
 import { useClerk } from './useClerk';