@hexclave/shared 1.0.1 → 1.0.2

package/dist/esm/utils/react.js

@@ -49,7 +49,7 @@ function getNodeText(node) {
 	if (["number", "string"].includes(typeof node)) return `${node}`;
 	if (!node) return "";
 	if (Array.isArray(node)) return node.map(getNodeText).join("");
-	if (typeof node === "object" && "props" in node) return getNodeText(node.props.children);
+	if (React.isValidElement(node)) return getNodeText(node.props.children);
 	throw new Error(`Unknown node type: ${typeof node}`);
 }
 (void 0)?.test("getNodeText", ({ expect }) => {
@@ -72,9 +72,9 @@ function getNodeText(node) {
 		42,
 		null
 	])).toBe("hello42");
-	expect(getNodeText({ props: { children: "child text" } })).toBe("child text");
-	expect(getNodeText({ props: { children: { props: { children: "nested text" } } } })).toBe("nested text");
-	expect(getNodeText([{ props: { children: "first" } }, { props: { children: "second" } }])).toBe("firstsecond");
+	expect(getNodeText(React.createElement("span", null, "child text"))).toBe("child text");
+	expect(getNodeText(React.createElement("div", null, React.createElement("span", null, "nested text")))).toBe("nested text");
+	expect(getNodeText([React.createElement("span", null, "first"), React.createElement("span", null, "second")])).toBe("firstsecond");
 });
 /**
 * Suspends the currently rendered component indefinitely. Will not unsuspend unless the component rerenders.

package/dist/esm/utils/react.js.map

@@ -1 +1 @@
-{"version":3,"file":"react.js","names":[],"sources":["../../../src/utils/react.tsx"],"sourcesContent":["import React, { SetStateAction } from \"react\";\nimport { isBrowserLike } from \"./env\";\nimport { neverResolve, runAsynchronously } from \"./promises\";\nimport { AsyncResult } from \"./results\";\nimport { ensureMonkeyPatch, NO_SUSPENSE_BOUNDARY_ERROR_SENTINEL } from \"./monkey-patch\";\nimport { deindent } from \"./strings\";\n\nexport function componentWrapper<\n  C extends React.ComponentType<any> | keyof React.JSX.IntrinsicElements,\n  ExtraProps extends {} = {}\n>(displayName: string, render: React.ForwardRefRenderFunction<RefFromComponent<C>, React.ComponentPropsWithRef<C> & ExtraProps>) {\n  const Component = forwardRefIfNeeded(render);\n  Component.displayName = displayName;\n  return Component;\n}\ntype RefFromComponent<C extends React.ComponentType<any> | keyof React.JSX.IntrinsicElements> = NonNullable<RefFromComponentDistCond<React.ComponentPropsWithRef<C>[\"ref\"]>>;\ntype RefFromComponentDistCond<A> = A extends React.RefObject<infer T> ? T : never;  // distributive conditional type; see https://www.typescriptlang.org/docs/handbook/2/conditional-types.html#distributive-conditional-types\n\nconst react18PromiseCache = new WeakMap<Promise<unknown>, AsyncResult<unknown, unknown>>();\nexport function use<T>(promise: Promise<T>): T {\n  if (\"use\" in React) {\n    return React.use(promise);\n  } else {\n    if (react18PromiseCache.has(promise)) {\n      const result = react18PromiseCache.get(promise)!;\n      if (result.status === \"pending\") {\n        throw promise;\n      } else if (result.status === \"ok\") {\n        return result.data as T;\n      } else {\n        throw result.error;\n      }\n    } else {\n      react18PromiseCache.set(promise, { \"status\": \"pending\", progress: undefined });\n      runAsynchronously(async () => {\n        try {\n          const res = await promise;\n          react18PromiseCache.set(promise, { \"status\": \"ok\", data: res });\n        } catch (e) {\n          react18PromiseCache.set(promise, { \"status\": \"error\", error: e });\n        }\n      });\n      throw promise;\n    }\n  }\n}\n\nexport function forwardRefIfNeeded<T, P = {}>(render: React.ForwardRefRenderFunction<T, P>): React.FC<P & { ref?: React.Ref<T> }> {\n  // TODO: when we drop support for react 18, remove this\n\n  const version = React.version;\n  const major = parseInt(version.split(\".\")[0]);\n  if (major < 19) {\n    return React.forwardRef<T, P>(render as any) as any;\n  } else {\n    return ((props: P) => render(props, (props as any).ref)) as any;\n  }\n}\n\nexport function getNodeText(node: React.ReactNode): string {\n  if ([\"number\", \"string\"].includes(typeof node)) {\n    return `${node}`;\n  }\n  if (!node) {\n    return \"\";\n  }\n  if (Array.isArray(node)) {\n    return node.map(getNodeText).join(\"\");\n  }\n  if (typeof node === \"object\" && \"props\" in node) {\n    return getNodeText(node.props.children);\n  }\n  throw new Error(`Unknown node type: ${typeof node}`);\n}\nimport.meta.vitest?.test(\"getNodeText\", ({ expect }) => {\n  // Test with string\n  expect(getNodeText(\"hello\")).toBe(\"hello\");\n\n  // Test with number\n  expect(getNodeText(42)).toBe(\"42\");\n\n  // Test with null/undefined\n  expect(getNodeText(null)).toBe(\"\");\n  expect(getNodeText(undefined)).toBe(\"\");\n\n  // Test with array\n  expect(getNodeText([\"hello\", \" \", \"world\"])).toBe(\"hello world\");\n  expect(getNodeText([1, 2, 3])).toBe(\"123\");\n\n  // Test with mixed array\n  expect(getNodeText([\"hello\", 42, null])).toBe(\"hello42\");\n\n  // Test with React element (mocked)\n  const mockElement = {\n    props: {\n      children: \"child text\"\n    }\n  } as React.ReactElement;\n  expect(getNodeText(mockElement)).toBe(\"child text\");\n\n  // Test with nested React elements\n  const nestedElement = {\n    props: {\n      children: {\n        props: {\n          children: \"nested text\"\n        }\n      } as React.ReactElement\n    }\n  } as React.ReactElement;\n  expect(getNodeText(nestedElement)).toBe(\"nested text\");\n\n  // Test with array of React elements\n  const arrayOfElements = [\n    { props: { children: \"first\" } } as React.ReactElement,\n    { props: { children: \"second\" } } as React.ReactElement\n  ];\n  expect(getNodeText(arrayOfElements)).toBe(\"firstsecond\");\n});\n\n/**\n * Suspends the currently rendered component indefinitely. Will not unsuspend unless the component rerenders.\n *\n * You can use this to translate older query- or AsyncResult-based code to new the Suspense system, for example: `if (query.isLoading) suspend();`\n */\nexport function suspend(): never {\n  use(neverResolve());\n  throw new Error(\"Somehow a Promise that never resolves was resolved?\");\n}\n\nexport function mapRef<T, R>(ref: ReadonlyRef<T>, mapper: (value: T) => R): ReadonlyRef<R> {\n  let last: [T, R] | null = null;\n  return {\n    get current() {\n      const input = ref.current;\n      if (last === null || input !== last[0]) {\n        last = [input, mapper(input)];\n      }\n      return last[1];\n    },\n  };\n}\n\nexport type ReadonlyRef<T> = {\n  readonly current: T,\n};\n\nexport type RefState<T> = ReadonlyRef<T> & {\n  set: (updater: SetStateAction<T>) => void,\n};\n\n/**\n * Like useState, but its value is immediately available on refState.current after being set.\n *\n * Like useRef, but setting the value will cause a rerender.\n *\n * Note that useRefState returns a new object every time a rerender happens due to a value change, which is intentional\n * as it allows you to specify it in a dependency array like this:\n *\n * ```tsx\n * useEffect(() => {\n *   // do something with refState.current\n * }, [refState]);  // instead of refState.current\n * ```\n *\n * If you don't want this, you can wrap the result in a useMemo call.\n */\nexport function useRefState<T>(initialValue: T | (() => T)): RefState<T> {\n  // Support lazy initialization like React.useState does: if initialValue is a function,\n  // call it once to get the actual initial value (React.useRef does NOT do this automatically).\n  const lazyInitRef = React.useRef<{ v: T } | null>(null);\n  if (lazyInitRef.current === null) {\n    lazyInitRef.current = {\n      v: typeof initialValue === \"function\" ? (initialValue as () => T)() : initialValue,\n    };\n  }\n  const resolvedInitialValue = lazyInitRef.current.v;\n  const [, setState] = React.useState<T>(() => resolvedInitialValue);\n  const ref = React.useRef(resolvedInitialValue);\n  const setValue = React.useCallback((updater: SetStateAction<T>) => {\n    const value: T = typeof updater === \"function\" ? (updater as any)(ref.current) : updater;\n    ref.current = value;\n    setState(value);\n  }, []);\n  const res = React.useMemo(() => ({\n    get current() {\n      return ref.current;\n    },\n    set: setValue,\n  }), [setValue]);\n  return res;\n}\n\nexport function mapRefState<T, R>(refState: RefState<T>, mapper: (value: T) => R, reverseMapper: (oldT: T, newR: R) => T): RefState<R> {\n  let last: [T, R] | null = null;\n  return {\n    get current() {\n      const input = refState.current;\n      if (last === null || input !== last[0]) {\n        last = [input, mapper(input)];\n      }\n      return last[1];\n    },\n    set(updater: SetStateAction<R>) {\n      const value: R = typeof updater === \"function\" ? (updater as any)(this.current) : updater;\n      refState.set(reverseMapper(refState.current, value));\n    },\n  };\n}\n\nexport function useQueryState(key: string, defaultValue?: string) {\n  const getValue = () => new URLSearchParams(window.location.search).get(key) ?? defaultValue ?? null;\n\n  const [value, setValue] = React.useState(getValue);\n\n  React.useEffect(() => {\n    const onPopState = () => setValue(getValue());\n    window.addEventListener(\"popstate\", onPopState);\n    return () => window.removeEventListener(\"popstate\", onPopState);\n  }, []);\n\n  const update = (next: string | null) => {\n    const params = new URLSearchParams(window.location.search);\n    if (next !== null) {\n      params.set(key, next);\n    } else {\n      params.delete(key);\n    }\n    const newUrl = params.toString()\n      ? `${window.location.pathname}?${params.toString()}`\n      : window.location.pathname;\n    window.history.pushState(null, \"\", newUrl);\n    setValue(next);\n  };\n\n  return [value, update] as const;\n}\n\nexport function shouldRethrowRenderingError(error: unknown): boolean {\n  return !!error && typeof error === \"object\" && \"digest\" in error && error.digest === \"BAILOUT_TO_CLIENT_SIDE_RENDERING\";\n}\n\nexport class NoSuspenseBoundaryError extends Error {\n  digest: string;\n  reason: string;\n  __noSuspenseBoundarySentinel = NO_SUSPENSE_BOUNDARY_ERROR_SENTINEL;\n\n  constructor(options: { caller?: string }) {\n    ensureMonkeyPatch();\n\n    super(deindent`\n      Suspense boundary not found! Read the error message below carefully (or paste it into your AI agent).\n\n      ${options.caller ?? \"This code path\"} attempted to display a loading indicator, but didn't find a Suspense boundary above it. Please read the error message below carefully.\n      \n      There are several potential causes:\n      \n      1. [Next.js] You are missing a loading.tsx file in your app directory. Fix it by adding a loading.tsx file in your app directory.\n\n      2. [React] You are missing a <Suspense> boundary in your component. Fix it by wrapping your component (or the entire app) in a <Suspense> component.\n\n      3. [Next.js] The component is rendered in the root (outermost) layout.tsx or template.tsx file. Next.js does not wrap those files in a Suspense boundary, even if there is a loading.tsx file in the same folder. To fix it, wrap your layout inside a route group like this:\n\n        - app\n        - - layout.tsx  // contains <html> and <body>, alongside providers and other components that don't need ${options.caller ?? \"this code path\"}\n        - - loading.tsx  // required for suspense\n        - - (main)\n        - - - layout.tsx  // contains the main layout of your app, like a sidebar or a header, and can use ${options.caller ?? \"this code path\"}\n        - - - route.tsx  // your actual main page\n        - - - the rest of your app\n\n        For more information on this approach, see Next's documentation on route groups: https://nextjs.org/docs/app/building-your-application/routing/route-groups\n      \n      4. You caught this error with try-catch or a custom error boundary. Fix this by rethrowing the error or not catching it in the first place.\n\n      5. Your version of Hexclave is too old. Upgrade to the latest version to see if that fixes the issue.\n\n      See: https://nextjs.org/docs/messages/missing-suspense-with-csr-bailout\n\n      More information on SSR and Suspense boundaries: https://react.dev/reference/react/Suspense#providing-a-fallback-for-server-errors-and-client-only-content\n    `);\n\n    this.name = \"NoSuspenseBoundaryError\";\n    this.reason = options.caller ?? \"suspendIfSsr()\";\n\n    // set the digest so nextjs doesn't log the error\n    // https://github.com/vercel/next.js/blob/d01d6d9c35a8c2725b3d74c1402ab76d4779a6cf/packages/next/src/shared/lib/lazy-dynamic/bailout-to-csr.ts#L14\n    this.digest = \"BAILOUT_TO_CLIENT_SIDE_RENDERING\";\n  }\n}\nimport.meta.vitest?.test(\"NoSuspenseBoundaryError\", ({ expect }) => {\n  // Test with default options\n  const defaultError = new NoSuspenseBoundaryError({});\n  expect(defaultError.name).toBe(\"NoSuspenseBoundaryError\");\n  expect(defaultError.reason).toBe(\"suspendIfSsr()\");\n  expect(defaultError.digest).toBe(\"BAILOUT_TO_CLIENT_SIDE_RENDERING\");\n  expect(defaultError.message).toContain(\"This code path attempted to display a loading indicator\");\n\n  // Test with custom caller\n  const customError = new NoSuspenseBoundaryError({ caller: \"CustomComponent\" });\n  expect(customError.name).toBe(\"NoSuspenseBoundaryError\");\n  expect(customError.reason).toBe(\"CustomComponent\");\n  expect(customError.digest).toBe(\"BAILOUT_TO_CLIENT_SIDE_RENDERING\");\n  expect(customError.message).toContain(\"CustomComponent attempted to display a loading indicator\");\n\n  // Verify error message contains all the necessary information\n  expect(customError.message).toContain(\"loading.tsx\");\n  expect(customError.message).toContain(\"route groups\");\n  expect(customError.message).toContain(\"https://nextjs.org/docs/messages/missing-suspense-with-csr-bailout\");\n});\n\n\n/**\n * Use this in a component or a hook to disable SSR. Should be wrapped in a Suspense boundary, or it will throw an error.\n */\nexport function suspendIfSsr(caller?: string) {\n  if (!isBrowserLike()) {\n    throw new NoSuspenseBoundaryError({ caller });\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"react.js","names":[],"sources":["../../../src/utils/react.tsx"],"sourcesContent":["import React, { SetStateAction } from \"react\";\nimport { isBrowserLike } from \"./env\";\nimport { neverResolve, runAsynchronously } from \"./promises\";\nimport { AsyncResult } from \"./results\";\nimport { ensureMonkeyPatch, NO_SUSPENSE_BOUNDARY_ERROR_SENTINEL } from \"./monkey-patch\";\nimport { deindent } from \"./strings\";\n\nexport function componentWrapper<\n  C extends React.ComponentType<any> | keyof React.JSX.IntrinsicElements,\n  ExtraProps extends {} = {}\n>(displayName: string, render: React.ForwardRefRenderFunction<RefFromComponent<C>, React.ComponentPropsWithRef<C> & ExtraProps>) {\n  const Component = forwardRefIfNeeded(render);\n  Component.displayName = displayName;\n  return Component;\n}\ntype RefFromComponent<C extends React.ComponentType<any> | keyof React.JSX.IntrinsicElements> = NonNullable<RefFromComponentDistCond<React.ComponentPropsWithRef<C>[\"ref\"]>>;\ntype RefFromComponentDistCond<A> = A extends React.RefObject<infer T> ? T : never;  // distributive conditional type; see https://www.typescriptlang.org/docs/handbook/2/conditional-types.html#distributive-conditional-types\n\nconst react18PromiseCache = new WeakMap<Promise<unknown>, AsyncResult<unknown, unknown>>();\nexport function use<T>(promise: Promise<T>): T {\n  if (\"use\" in React) {\n    return React.use(promise);\n  } else {\n    if (react18PromiseCache.has(promise)) {\n      const result = react18PromiseCache.get(promise)!;\n      if (result.status === \"pending\") {\n        throw promise;\n      } else if (result.status === \"ok\") {\n        return result.data as T;\n      } else {\n        throw result.error;\n      }\n    } else {\n      react18PromiseCache.set(promise, { \"status\": \"pending\", progress: undefined });\n      runAsynchronously(async () => {\n        try {\n          const res = await promise;\n          react18PromiseCache.set(promise, { \"status\": \"ok\", data: res });\n        } catch (e) {\n          react18PromiseCache.set(promise, { \"status\": \"error\", error: e });\n        }\n      });\n      throw promise;\n    }\n  }\n}\n\nexport function forwardRefIfNeeded<T, P = {}>(render: React.ForwardRefRenderFunction<T, P>): React.FC<P & { ref?: React.Ref<T> }> {\n  // TODO: when we drop support for react 18, remove this\n\n  const version = React.version;\n  const major = parseInt(version.split(\".\")[0]);\n  if (major < 19) {\n    return React.forwardRef<T, P>(render as any) as any;\n  } else {\n    return ((props: P) => render(props, (props as any).ref)) as any;\n  }\n}\n\nexport function getNodeText(node: React.ReactNode): string {\n  if ([\"number\", \"string\"].includes(typeof node)) {\n    return `${node}`;\n  }\n  if (!node) {\n    return \"\";\n  }\n  if (Array.isArray(node)) {\n    return node.map(getNodeText).join(\"\");\n  }\n  if (React.isValidElement<{ children?: React.ReactNode }>(node)) {\n    return getNodeText(node.props.children);\n  }\n  throw new Error(`Unknown node type: ${typeof node}`);\n}\nimport.meta.vitest?.test(\"getNodeText\", ({ expect }) => {\n  // Test with string\n  expect(getNodeText(\"hello\")).toBe(\"hello\");\n\n  // Test with number\n  expect(getNodeText(42)).toBe(\"42\");\n\n  // Test with null/undefined\n  expect(getNodeText(null)).toBe(\"\");\n  expect(getNodeText(undefined)).toBe(\"\");\n\n  // Test with array\n  expect(getNodeText([\"hello\", \" \", \"world\"])).toBe(\"hello world\");\n  expect(getNodeText([1, 2, 3])).toBe(\"123\");\n\n  // Test with mixed array\n  expect(getNodeText([\"hello\", 42, null])).toBe(\"hello42\");\n\n  // Test with React element\n  const mockElement = React.createElement(\"span\", null, \"child text\");\n  expect(getNodeText(mockElement)).toBe(\"child text\");\n\n  // Test with nested React elements\n  const nestedElement = React.createElement(\"div\", null, React.createElement(\"span\", null, \"nested text\"));\n  expect(getNodeText(nestedElement)).toBe(\"nested text\");\n\n  // Test with array of React elements\n  const arrayOfElements = [\n    React.createElement(\"span\", null, \"first\"),\n    React.createElement(\"span\", null, \"second\"),\n  ];\n  expect(getNodeText(arrayOfElements)).toBe(\"firstsecond\");\n});\n\n/**\n * Suspends the currently rendered component indefinitely. Will not unsuspend unless the component rerenders.\n *\n * You can use this to translate older query- or AsyncResult-based code to new the Suspense system, for example: `if (query.isLoading) suspend();`\n */\nexport function suspend(): never {\n  use(neverResolve());\n  throw new Error(\"Somehow a Promise that never resolves was resolved?\");\n}\n\nexport function mapRef<T, R>(ref: ReadonlyRef<T>, mapper: (value: T) => R): ReadonlyRef<R> {\n  let last: [T, R] | null = null;\n  return {\n    get current() {\n      const input = ref.current;\n      if (last === null || input !== last[0]) {\n        last = [input, mapper(input)];\n      }\n      return last[1];\n    },\n  };\n}\n\nexport type ReadonlyRef<T> = {\n  readonly current: T,\n};\n\nexport type RefState<T> = ReadonlyRef<T> & {\n  set: (updater: SetStateAction<T>) => void,\n};\n\n/**\n * Like useState, but its value is immediately available on refState.current after being set.\n *\n * Like useRef, but setting the value will cause a rerender.\n *\n * Note that useRefState returns a new object every time a rerender happens due to a value change, which is intentional\n * as it allows you to specify it in a dependency array like this:\n *\n * ```tsx\n * useEffect(() => {\n *   // do something with refState.current\n * }, [refState]);  // instead of refState.current\n * ```\n *\n * If you don't want this, you can wrap the result in a useMemo call.\n */\nexport function useRefState<T>(initialValue: T | (() => T)): RefState<T> {\n  // Support lazy initialization like React.useState does: if initialValue is a function,\n  // call it once to get the actual initial value (React.useRef does NOT do this automatically).\n  const lazyInitRef = React.useRef<{ v: T } | null>(null);\n  if (lazyInitRef.current === null) {\n    lazyInitRef.current = {\n      v: typeof initialValue === \"function\" ? (initialValue as () => T)() : initialValue,\n    };\n  }\n  const resolvedInitialValue = lazyInitRef.current.v;\n  const [, setState] = React.useState<T>(() => resolvedInitialValue);\n  const ref = React.useRef(resolvedInitialValue);\n  const setValue = React.useCallback((updater: SetStateAction<T>) => {\n    const value: T = typeof updater === \"function\" ? (updater as any)(ref.current) : updater;\n    ref.current = value;\n    setState(value);\n  }, []);\n  const res = React.useMemo(() => ({\n    get current() {\n      return ref.current;\n    },\n    set: setValue,\n  }), [setValue]);\n  return res;\n}\n\nexport function mapRefState<T, R>(refState: RefState<T>, mapper: (value: T) => R, reverseMapper: (oldT: T, newR: R) => T): RefState<R> {\n  let last: [T, R] | null = null;\n  return {\n    get current() {\n      const input = refState.current;\n      if (last === null || input !== last[0]) {\n        last = [input, mapper(input)];\n      }\n      return last[1];\n    },\n    set(updater: SetStateAction<R>) {\n      const value: R = typeof updater === \"function\" ? (updater as any)(this.current) : updater;\n      refState.set(reverseMapper(refState.current, value));\n    },\n  };\n}\n\nexport function useQueryState(key: string, defaultValue?: string) {\n  const getValue = () => new URLSearchParams(window.location.search).get(key) ?? defaultValue ?? null;\n\n  const [value, setValue] = React.useState(getValue);\n\n  React.useEffect(() => {\n    const onPopState = () => setValue(getValue());\n    window.addEventListener(\"popstate\", onPopState);\n    return () => window.removeEventListener(\"popstate\", onPopState);\n  }, []);\n\n  const update = (next: string | null) => {\n    const params = new URLSearchParams(window.location.search);\n    if (next !== null) {\n      params.set(key, next);\n    } else {\n      params.delete(key);\n    }\n    const newUrl = params.toString()\n      ? `${window.location.pathname}?${params.toString()}`\n      : window.location.pathname;\n    window.history.pushState(null, \"\", newUrl);\n    setValue(next);\n  };\n\n  return [value, update] as const;\n}\n\nexport function shouldRethrowRenderingError(error: unknown): boolean {\n  return !!error && typeof error === \"object\" && \"digest\" in error && error.digest === \"BAILOUT_TO_CLIENT_SIDE_RENDERING\";\n}\n\nexport class NoSuspenseBoundaryError extends Error {\n  digest: string;\n  reason: string;\n  __noSuspenseBoundarySentinel = NO_SUSPENSE_BOUNDARY_ERROR_SENTINEL;\n\n  constructor(options: { caller?: string }) {\n    ensureMonkeyPatch();\n\n    super(deindent`\n      Suspense boundary not found! Read the error message below carefully (or paste it into your AI agent).\n\n      ${options.caller ?? \"This code path\"} attempted to display a loading indicator, but didn't find a Suspense boundary above it. Please read the error message below carefully.\n      \n      There are several potential causes:\n      \n      1. [Next.js] You are missing a loading.tsx file in your app directory. Fix it by adding a loading.tsx file in your app directory.\n\n      2. [React] You are missing a <Suspense> boundary in your component. Fix it by wrapping your component (or the entire app) in a <Suspense> component.\n\n      3. [Next.js] The component is rendered in the root (outermost) layout.tsx or template.tsx file. Next.js does not wrap those files in a Suspense boundary, even if there is a loading.tsx file in the same folder. To fix it, wrap your layout inside a route group like this:\n\n        - app\n        - - layout.tsx  // contains <html> and <body>, alongside providers and other components that don't need ${options.caller ?? \"this code path\"}\n        - - loading.tsx  // required for suspense\n        - - (main)\n        - - - layout.tsx  // contains the main layout of your app, like a sidebar or a header, and can use ${options.caller ?? \"this code path\"}\n        - - - route.tsx  // your actual main page\n        - - - the rest of your app\n\n        For more information on this approach, see Next's documentation on route groups: https://nextjs.org/docs/app/building-your-application/routing/route-groups\n      \n      4. You caught this error with try-catch or a custom error boundary. Fix this by rethrowing the error or not catching it in the first place.\n\n      5. Your version of Hexclave is too old. Upgrade to the latest version to see if that fixes the issue.\n\n      See: https://nextjs.org/docs/messages/missing-suspense-with-csr-bailout\n\n      More information on SSR and Suspense boundaries: https://react.dev/reference/react/Suspense#providing-a-fallback-for-server-errors-and-client-only-content\n    `);\n\n    this.name = \"NoSuspenseBoundaryError\";\n    this.reason = options.caller ?? \"suspendIfSsr()\";\n\n    // set the digest so nextjs doesn't log the error\n    // https://github.com/vercel/next.js/blob/d01d6d9c35a8c2725b3d74c1402ab76d4779a6cf/packages/next/src/shared/lib/lazy-dynamic/bailout-to-csr.ts#L14\n    this.digest = \"BAILOUT_TO_CLIENT_SIDE_RENDERING\";\n  }\n}\nimport.meta.vitest?.test(\"NoSuspenseBoundaryError\", ({ expect }) => {\n  // Test with default options\n  const defaultError = new NoSuspenseBoundaryError({});\n  expect(defaultError.name).toBe(\"NoSuspenseBoundaryError\");\n  expect(defaultError.reason).toBe(\"suspendIfSsr()\");\n  expect(defaultError.digest).toBe(\"BAILOUT_TO_CLIENT_SIDE_RENDERING\");\n  expect(defaultError.message).toContain(\"This code path attempted to display a loading indicator\");\n\n  // Test with custom caller\n  const customError = new NoSuspenseBoundaryError({ caller: \"CustomComponent\" });\n  expect(customError.name).toBe(\"NoSuspenseBoundaryError\");\n  expect(customError.reason).toBe(\"CustomComponent\");\n  expect(customError.digest).toBe(\"BAILOUT_TO_CLIENT_SIDE_RENDERING\");\n  expect(customError.message).toContain(\"CustomComponent attempted to display a loading indicator\");\n\n  // Verify error message contains all the necessary information\n  expect(customError.message).toContain(\"loading.tsx\");\n  expect(customError.message).toContain(\"route groups\");\n  expect(customError.message).toContain(\"https://nextjs.org/docs/messages/missing-suspense-with-csr-bailout\");\n});\n\n\n/**\n * Use this in a component or a hook to disable SSR. Should be wrapped in a Suspense boundary, or it will throw an error.\n */\nexport function suspendIfSsr(caller?: string) {\n  if (!isBrowserLike()) {\n    throw new NoSuspenseBoundaryError({ caller });\n  }\n}\n"],"mappings":"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"}

package/dist/hooks/use-hover.d.ts

@@ -1,5 +1,5 @@
 //#region src/hooks/use-hover.d.ts
-declare function useHover<T extends HTMLElement>(ref: React.RefObject<T>, options?: {
+declare function useHover<T extends HTMLElement | null>(ref: React.RefObject<T>, options?: {
   onMouseEnter?: () => void;
   onMouseLeave?: () => void;
 }): boolean;

package/dist/hooks/use-hover.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-hover.d.ts","names":[],"sources":["../../src/hooks/use-hover.tsx"],"mappings":";iBAGgB,QAAA,WAAmB,WAAA,CAAA,CACjC,GAAA,EAAK,KAAA,CAAM,SAAA,CAAU,CAAA,GACrB,OAAA;EACE,YAAA;EACA,YAAA;AAAA"}
+{"version":3,"file":"use-hover.d.ts","names":[],"sources":["../../src/hooks/use-hover.tsx"],"mappings":";iBAGgB,QAAA,WAAmB,WAAA,QAAA,CACjC,GAAA,EAAK,KAAA,CAAM,SAAA,CAAU,CAAA,GACrB,OAAA;EACE,YAAA;EACA,YAAA;AAAA"}

package/dist/hooks/use-hover.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-hover.js","names":[],"sources":["../../src/hooks/use-hover.tsx"],"sourcesContent":["import { useLayoutEffect } from \"react\";\nimport { useRefState } from \"../utils/react\";\n\nexport function useHover<T extends HTMLElement>(\n  ref: React.RefObject<T>,\n  options: {\n    onMouseEnter?: () => void,\n    onMouseLeave?: () => void,\n  } = {},\n): boolean {\n  // Internal counter: mouseenter++ / mouseleave-- (isHovering = counter > 0)\n  const counter = useRefState(0);\n\n  useLayoutEffect(() => {\n    const el = ref.current;\n    if (!el) return;\n    let incr = 0;\n    let prevInside = false;\n\n    const contains = (r: DOMRect, x: number, y: number) =>\n      x >= r.left && x <= r.right && y >= r.top && y <= r.bottom;\n\n    const enter = () => {\n      incr++;\n      counter.set(c => c + 1);\n      if (counter.current === 1) {\n        options.onMouseEnter?.();\n      }\n    };\n\n    const leave = () => {\n      incr--;\n      requestAnimationFrame(() => {\n        requestAnimationFrame(() => {\n          counter.set(c => c - 1);\n          if (counter.current === 0) {\n            options.onMouseLeave?.();\n          }\n        });\n      });\n    };\n\n    const topMatchesTarget = (x: number, y: number) => {\n      const top = document.elementFromPoint(x, y);\n      return !!(top && (top === el || el.contains(top)));\n    };\n\n    const processPoint = (x: number, y: number) => {\n      const rect = el.getBoundingClientRect();\n\n      // True “hoverability”: inside rect AND not occluded by others\n      const inside = contains(rect, x, y) && topMatchesTarget(x, y);\n      if (inside && !prevInside) {\n        enter();\n      } else if (!inside && prevInside) {\n        leave();\n      }\n      prevInside = inside;\n    };\n\n    const onMove = (e: PointerEvent) => {\n      if (e.pointerType !== \"mouse\") return; // keep it hover-only\n      // Use coalesced points when available\n      const batch = e.getCoalescedEvents();\n      if (batch.length) {\n        for (let eventIndex = 0; eventIndex < batch.length - 1; eventIndex++) {\n          const e1 = batch[eventIndex];\n          const e2 = batch[eventIndex + 1];\n          const steps = 10;\n          for (let i = 0; i <= steps; i++) {\n            processPoint(e1.clientX + (e2.clientX - e1.clientX) * i / steps, e1.clientY + (e2.clientY - e1.clientY) * i / steps);\n          }\n        }\n      } else {\n        processPoint(e.clientX, e.clientY);\n      }\n    };\n\n    window.addEventListener(\"pointermove\", onMove, { passive: true });\n\n    return () => {\n      window.removeEventListener(\"pointermove\", onMove);\n      counter.set(c => c - incr);\n    };\n  }, []);\n\n  return counter.current > 0;\n}\n"],"mappings":";;;;;;AAGA,SAAgB,SACd,KACA,UAGI,EAAE,EACG;CAET,MAAM,6CAAsB,EAAE;AAE9B,kCAAsB;EACpB,MAAM,KAAK,IAAI;AACf,MAAI,CAAC,GAAI;EACT,IAAI,OAAO;EACX,IAAI,aAAa;EAEjB,MAAM,YAAY,GAAY,GAAW,MACvC,KAAK,EAAE,QAAQ,KAAK,EAAE,SAAS,KAAK,EAAE,OAAO,KAAK,EAAE;EAEtD,MAAM,cAAc;AAClB;AACA,WAAQ,KAAI,MAAK,IAAI,EAAE;AACvB,OAAI,QAAQ,YAAY,EACtB,SAAQ,gBAAgB;;EAI5B,MAAM,cAAc;AAClB;AACA,+BAA4B;AAC1B,gCAA4B;AAC1B,aAAQ,KAAI,MAAK,IAAI,EAAE;AACvB,SAAI,QAAQ,YAAY,EACtB,SAAQ,gBAAgB;MAE1B;KACF;;EAGJ,MAAM,oBAAoB,GAAW,MAAc;GACjD,MAAM,MAAM,SAAS,iBAAiB,GAAG,EAAE;AAC3C,UAAO,CAAC,EAAE,QAAQ,QAAQ,MAAM,GAAG,SAAS,IAAI;;EAGlD,MAAM,gBAAgB,GAAW,MAAc;GAI7C,MAAM,SAAS,SAHF,GAAG,uBAAuB,EAGT,GAAG,EAAE,IAAI,iBAAiB,GAAG,EAAE;AAC7D,OAAI,UAAU,CAAC,WACb,QAAO;YACE,CAAC,UAAU,WACpB,QAAO;AAET,gBAAa;;EAGf,MAAM,UAAU,MAAoB;AAClC,OAAI,EAAE,gBAAgB,QAAS;GAE/B,MAAM,QAAQ,EAAE,oBAAoB;AACpC,OAAI,MAAM,OACR,MAAK,IAAI,aAAa,GAAG,aAAa,MAAM,SAAS,GAAG,cAAc;IACpE,MAAM,KAAK,MAAM;IACjB,MAAM,KAAK,MAAM,aAAa;IAC9B,MAAM,QAAQ;AACd,SAAK,IAAI,IAAI,GAAG,KAAK,OAAO,IAC1B,cAAa,GAAG,WAAW,GAAG,UAAU,GAAG,WAAW,IAAI,OAAO,GAAG,WAAW,GAAG,UAAU,GAAG,WAAW,IAAI,MAAM;;OAIxH,cAAa,EAAE,SAAS,EAAE,QAAQ;;AAItC,SAAO,iBAAiB,eAAe,QAAQ,EAAE,SAAS,MAAM,CAAC;AAEjE,eAAa;AACX,UAAO,oBAAoB,eAAe,OAAO;AACjD,WAAQ,KAAI,MAAK,IAAI,KAAK;;IAE3B,EAAE,CAAC;AAEN,QAAO,QAAQ,UAAU"}
+{"version":3,"file":"use-hover.js","names":[],"sources":["../../src/hooks/use-hover.tsx"],"sourcesContent":["import { useLayoutEffect } from \"react\";\nimport { useRefState } from \"../utils/react\";\n\nexport function useHover<T extends HTMLElement | null>(\n  ref: React.RefObject<T>,\n  options: {\n    onMouseEnter?: () => void,\n    onMouseLeave?: () => void,\n  } = {},\n): boolean {\n  // Internal counter: mouseenter++ / mouseleave-- (isHovering = counter > 0)\n  const counter = useRefState(0);\n\n  useLayoutEffect(() => {\n    const el = ref.current;\n    if (!el) return;\n    let incr = 0;\n    let prevInside = false;\n\n    const contains = (r: DOMRect, x: number, y: number) =>\n      x >= r.left && x <= r.right && y >= r.top && y <= r.bottom;\n\n    const enter = () => {\n      incr++;\n      counter.set(c => c + 1);\n      if (counter.current === 1) {\n        options.onMouseEnter?.();\n      }\n    };\n\n    const leave = () => {\n      incr--;\n      requestAnimationFrame(() => {\n        requestAnimationFrame(() => {\n          counter.set(c => c - 1);\n          if (counter.current === 0) {\n            options.onMouseLeave?.();\n          }\n        });\n      });\n    };\n\n    const topMatchesTarget = (x: number, y: number) => {\n      const top = document.elementFromPoint(x, y);\n      return !!(top && (top === el || el.contains(top)));\n    };\n\n    const processPoint = (x: number, y: number) => {\n      const rect = el.getBoundingClientRect();\n\n      // True “hoverability”: inside rect AND not occluded by others\n      const inside = contains(rect, x, y) && topMatchesTarget(x, y);\n      if (inside && !prevInside) {\n        enter();\n      } else if (!inside && prevInside) {\n        leave();\n      }\n      prevInside = inside;\n    };\n\n    const onMove = (e: PointerEvent) => {\n      if (e.pointerType !== \"mouse\") return; // keep it hover-only\n      // Use coalesced points when available\n      const batch = e.getCoalescedEvents();\n      if (batch.length) {\n        for (let eventIndex = 0; eventIndex < batch.length - 1; eventIndex++) {\n          const e1 = batch[eventIndex];\n          const e2 = batch[eventIndex + 1];\n          const steps = 10;\n          for (let i = 0; i <= steps; i++) {\n            processPoint(e1.clientX + (e2.clientX - e1.clientX) * i / steps, e1.clientY + (e2.clientY - e1.clientY) * i / steps);\n          }\n        }\n      } else {\n        processPoint(e.clientX, e.clientY);\n      }\n    };\n\n    window.addEventListener(\"pointermove\", onMove, { passive: true });\n\n    return () => {\n      window.removeEventListener(\"pointermove\", onMove);\n      counter.set(c => c - incr);\n    };\n  }, []);\n\n  return counter.current > 0;\n}\n"],"mappings":";;;;;;AAGA,SAAgB,SACd,KACA,UAGI,EAAE,EACG;CAET,MAAM,6CAAsB,EAAE;AAE9B,kCAAsB;EACpB,MAAM,KAAK,IAAI;AACf,MAAI,CAAC,GAAI;EACT,IAAI,OAAO;EACX,IAAI,aAAa;EAEjB,MAAM,YAAY,GAAY,GAAW,MACvC,KAAK,EAAE,QAAQ,KAAK,EAAE,SAAS,KAAK,EAAE,OAAO,KAAK,EAAE;EAEtD,MAAM,cAAc;AAClB;AACA,WAAQ,KAAI,MAAK,IAAI,EAAE;AACvB,OAAI,QAAQ,YAAY,EACtB,SAAQ,gBAAgB;;EAI5B,MAAM,cAAc;AAClB;AACA,+BAA4B;AAC1B,gCAA4B;AAC1B,aAAQ,KAAI,MAAK,IAAI,EAAE;AACvB,SAAI,QAAQ,YAAY,EACtB,SAAQ,gBAAgB;MAE1B;KACF;;EAGJ,MAAM,oBAAoB,GAAW,MAAc;GACjD,MAAM,MAAM,SAAS,iBAAiB,GAAG,EAAE;AAC3C,UAAO,CAAC,EAAE,QAAQ,QAAQ,MAAM,GAAG,SAAS,IAAI;;EAGlD,MAAM,gBAAgB,GAAW,MAAc;GAI7C,MAAM,SAAS,SAHF,GAAG,uBAAuB,EAGT,GAAG,EAAE,IAAI,iBAAiB,GAAG,EAAE;AAC7D,OAAI,UAAU,CAAC,WACb,QAAO;YACE,CAAC,UAAU,WACpB,QAAO;AAET,gBAAa;;EAGf,MAAM,UAAU,MAAoB;AAClC,OAAI,EAAE,gBAAgB,QAAS;GAE/B,MAAM,QAAQ,EAAE,oBAAoB;AACpC,OAAI,MAAM,OACR,MAAK,IAAI,aAAa,GAAG,aAAa,MAAM,SAAS,GAAG,cAAc;IACpE,MAAM,KAAK,MAAM;IACjB,MAAM,KAAK,MAAM,aAAa;IAC9B,MAAM,QAAQ;AACd,SAAK,IAAI,IAAI,GAAG,KAAK,OAAO,IAC1B,cAAa,GAAG,WAAW,GAAG,UAAU,GAAG,WAAW,IAAI,OAAO,GAAG,WAAW,GAAG,UAAU,GAAG,WAAW,IAAI,MAAM;;OAIxH,cAAa,EAAE,SAAS,EAAE,QAAQ;;AAItC,SAAO,iBAAiB,eAAe,QAAQ,EAAE,SAAS,MAAM,CAAC;AAEjE,eAAa;AACX,UAAO,oBAAoB,eAAe,OAAO;AACjD,WAAQ,KAAI,MAAK,IAAI,KAAK;;IAE3B,EAAE,CAAC;AAEN,QAAO,QAAQ,UAAU"}

package/dist/interface/admin-metrics.d.ts

@@ -150,15 +150,15 @@ declare const MetricsEmailOverviewSchema: yup.ObjectSchema<{
     activity: number;
   }[];
   daily_emails_by_status: {
+    ok: number;
     error: number;
     date: string;
-    ok: number;
     in_progress: number;
   }[];
   emails_sent: number;
   recent_emails: {
-    status: string;
     id: string;
+    status: string;
     subject: string;
     created_at_millis: number;
   }[];
@@ -310,9 +310,9 @@ declare const UserActivityResponseBodySchema: yup.ObjectSchema<{
   data_points: undefined;
 }, "">;
 declare const MetricsActiveUsersByCountrySchema: yup.MixedSchema<Record<string, {
-  primary_email: string | null;
-  display_name: string | null;
   id: string;
+  display_name: string | null;
+  primary_email: string | null;
   profile_image_url: string | null;
   signed_up_at_millis: number;
   last_active_at_millis: number | null;
@@ -330,25 +330,25 @@ declare const MetricsResponseBodySchema: yup.ObjectSchema<{
   }[];
   users_by_country: Record<string, number>;
   active_users_by_country: Record<string, {
-    primary_email: string | null;
-    display_name: string | null;
     id: string;
+    display_name: string | null;
+    primary_email: string | null;
     profile_image_url: string | null;
     signed_up_at_millis: number;
     last_active_at_millis: number | null;
   }[]>;
   recently_registered: {
-    primary_email: string | null;
-    display_name: string | null;
     id: string;
+    display_name: string | null;
+    primary_email: string | null;
     profile_image_url: string | null;
     signed_up_at_millis: number;
     last_active_at_millis: number | null;
   }[];
   recently_active: {
-    primary_email: string | null;
-    display_name: string | null;
     id: string;
+    display_name: string | null;
+    primary_email: string | null;
     profile_image_url: string | null;
     signed_up_at_millis: number;
     last_active_at_millis: number | null;
@@ -422,15 +422,15 @@ declare const MetricsResponseBodySchema: yup.ObjectSchema<{
     emails_by_status: Record<string, number>;
     total_emails: number;
     daily_emails_by_status: {
+      ok: number;
       error: number;
       date: string;
-      ok: number;
       in_progress: number;
     }[];
     emails_sent: number;
     recent_emails: {
-      status: string;
       id: string;
+      status: string;
       subject: string;
       created_at_millis: number;
     }[];

package/dist/interface/conversations.d.ts

@@ -49,7 +49,7 @@ declare const conversationSummarySchema: yup$1.ObjectSchema<{
   userPrimaryEmail: string | null;
   userProfileImageUrl: string | null;
   subject: string;
-  status: "open" | "pending" | "closed";
+  status: "pending" | "open" | "closed";
   priority: "low" | "normal" | "high" | "urgent";
   source: "email" | "manual" | "chat" | "api";
   lastMessageType: "message" | "internal-note" | "status-change";
@@ -129,7 +129,7 @@ declare const conversationMessageSchema: yup$1.ObjectSchema<{
   userId: string | null;
   teamId: string | null;
   subject: string;
-  status: "open" | "pending" | "closed";
+  status: "pending" | "open" | "closed";
   priority: "low" | "normal" | "high" | "urgent";
   source: "email" | "manual" | "chat" | "api";
   messageType: "message" | "internal-note" | "status-change";
@@ -139,8 +139,8 @@ declare const conversationMessageSchema: yup$1.ObjectSchema<{
   createdAt: string;
   sender: {
     type: "user" | "agent" | "system";
-    displayName: string | null;
     id: string | null;
+    displayName: string | null;
     primaryEmail: string | null;
   };
 }, yup$1.AnyObject, {
@@ -173,19 +173,7 @@ declare const conversationListResponseSchema: yup$1.ObjectSchema<{
     lastOutboundAt?: string | null | undefined;
     closedAt?: string | null | undefined;
     recordMetadata?: {} | null | undefined;
-    status: "open" | "pending" | "closed";
-    priority: "low" | "normal" | "high" | "urgent";
-    subject: string;
-    conversationId: string;
-    userId: string | null;
-    teamId: string | null;
-    userDisplayName: string | null;
-    userPrimaryEmail: string | null;
-    userProfileImageUrl: string | null;
     source: "email" | "manual" | "chat" | "api";
-    lastMessageType: "message" | "internal-note" | "status-change";
-    preview: string | null;
-    lastActivityAt: string;
     metadata: {
       assignedToUserId: string | null;
       assignedToDisplayName: string | null;
@@ -196,6 +184,18 @@ declare const conversationListResponseSchema: yup$1.ObjectSchema<{
       lastCustomerReplyAt: string | null;
       lastAgentReplyAt: string | null;
     };
+    status: "pending" | "open" | "closed";
+    subject: string;
+    conversationId: string;
+    userId: string | null;
+    teamId: string | null;
+    userDisplayName: string | null;
+    userPrimaryEmail: string | null;
+    userProfileImageUrl: string | null;
+    priority: "low" | "normal" | "high" | "urgent";
+    lastMessageType: "message" | "internal-note" | "status-change";
+    preview: string | null;
+    lastActivityAt: string;
   }[];
   hasMore: boolean;
 }, yup$1.AnyObject, {
@@ -211,19 +211,7 @@ declare const conversationDetailResponseSchema: yup$1.ObjectSchema<{
     lastOutboundAt?: string | null | undefined;
     closedAt?: string | null | undefined;
     recordMetadata?: {} | null | undefined;
-    status: "open" | "pending" | "closed";
-    priority: "low" | "normal" | "high" | "urgent";
-    subject: string;
-    conversationId: string;
-    userId: string | null;
-    teamId: string | null;
-    userDisplayName: string | null;
-    userPrimaryEmail: string | null;
-    userProfileImageUrl: string | null;
     source: "email" | "manual" | "chat" | "api";
-    lastMessageType: "message" | "internal-note" | "status-change";
-    preview: string | null;
-    lastActivityAt: string;
     metadata: {
       assignedToUserId: string | null;
       assignedToDisplayName: string | null;
@@ -234,31 +222,43 @@ declare const conversationDetailResponseSchema: yup$1.ObjectSchema<{
       lastCustomerReplyAt: string | null;
       lastAgentReplyAt: string | null;
     };
+    status: "pending" | "open" | "closed";
+    subject: string;
+    conversationId: string;
+    userId: string | null;
+    teamId: string | null;
+    userDisplayName: string | null;
+    userPrimaryEmail: string | null;
+    userProfileImageUrl: string | null;
+    priority: "low" | "normal" | "high" | "urgent";
+    lastMessageType: "message" | "internal-note" | "status-change";
+    preview: string | null;
+    lastActivityAt: string;
   };
   messages: {
-    status: "open" | "pending" | "closed";
+    body: string | null;
+    source: "email" | "manual" | "chat" | "api";
+    metadata: {} | null;
     id: string;
-    priority: "low" | "normal" | "high" | "urgent";
+    status: "pending" | "open" | "closed";
     subject: string;
     conversationId: string;
     userId: string | null;
     teamId: string | null;
-    source: "email" | "manual" | "chat" | "api";
-    metadata: {} | null;
+    priority: "low" | "normal" | "high" | "urgent";
     createdAt: string;
     messageType: "message" | "internal-note" | "status-change";
-    body: string | null;
     attachments: {}[];
     sender: {
       type: "user" | "agent" | "system";
-      displayName: string | null;
       id: string | null;
+      displayName: string | null;
       primaryEmail: string | null;
     };
   }[];
   entryPoints: {
-    id: string;
     metadata: {} | null;
+    id: string;
     createdAt: string;
     updatedAt: string;
     channelType: string;

package/dist/interface/crud/current-user.d.ts

@@ -4,20 +4,20 @@ import * as yup$1 from "yup";
 //#region src/interface/crud/current-user.d.ts
 declare const currentUserCrud: CrudSchemaFromOptions<{
   clientReadSchema: yup$1.ObjectSchema<{
-    restricted_reason: {
-      type: "anonymous" | "email_not_verified" | "restricted_by_administrator";
-    } | null;
-    primary_email: string | null;
-    display_name: string | null;
-    client_metadata: {} | null;
-    client_read_only_metadata: {} | null;
-    id: string;
     selected_team_id: string | null;
     is_anonymous: boolean;
     is_restricted: boolean;
+    restricted_reason: {
+      type: "anonymous" | "email_not_verified" | "restricted_by_administrator";
+    } | null;
     requires_totp_mfa: boolean;
+    id: string;
+    display_name: string | null;
+    primary_email: string | null;
     profile_image_url: string | null;
     signed_up_at_millis: number;
+    client_metadata: {} | null;
+    client_read_only_metadata: {} | null;
     primary_email_verified: boolean;
     has_password: boolean;
     otp_auth_enabled: boolean;
@@ -34,8 +34,8 @@ declare const currentUserCrud: CrudSchemaFromOptions<{
     selected_team: {
       client_metadata?: {} | null | undefined;
       client_read_only_metadata?: {} | null | undefined;
-      display_name: string;
       id: string;
+      display_name: string;
       profile_image_url: string | null;
     } | null;
   }, yup$1.AnyObject, {
@@ -90,9 +90,9 @@ declare const currentUserCrud: CrudSchemaFromOptions<{
       client_metadata?: {} | null | undefined;
       client_read_only_metadata?: {} | null | undefined;
       server_metadata?: {} | null | undefined;
-      display_name: string;
       id: string;
       created_at_millis: number;
+      display_name: string;
       profile_image_url: string | null;
     } | null;
     selected_team_id: string | null;
@@ -172,11 +172,11 @@ declare const currentUserCrud: CrudSchemaFromOptions<{
     requires_totp_mfa: undefined;
   }, "">;
   clientUpdateSchema: yup$1.ObjectSchema<{
-    primary_email: string | null | undefined;
-    display_name: string | null | undefined;
-    client_metadata: {} | null | undefined;
     selected_team_id: string | null | undefined;
+    display_name: string | null | undefined;
+    primary_email: string | null | undefined;
     profile_image_url: string | null | undefined;
+    client_metadata: {} | null | undefined;
     otp_auth_enabled: boolean | undefined;
     passkey_auth_enabled: boolean | undefined;
     totp_secret_base64: string | null | undefined;