lazyconvex 0.0.0

package/src/components/file-field.tsx

@@ -0,0 +1,234 @@
+// oxlint-disable promise/prefer-await-to-then, next/no-img-element
+/* eslint-disable @typescript-eslint/no-unsafe-assignment, no-await-in-loop, complexity */
+// biome-ignore-all lint/performance/noImgElement: x
+// biome-ignore-all lint/performance/noAwaitInLoops: x
+// biome-ignore-all lint/suspicious/noExplicitAny: x
+'use client'
+import type { AnyFieldApi } from '@tanstack/react-form'
+import type { FunctionReference } from 'convex/server'
+import type { ReactNode } from 'react'
+
+import { cn } from '@a/ui'
+import { Field, FieldError, FieldLabel } from '@a/ui/field'
+import imageCompression from 'browser-image-compression'
+import { useQuery } from 'convex/react'
+import { FileIcon, ImageIcon, Upload, X } from 'lucide-react'
+import { createContext, use, useCallback } from 'react'
+import { useDropzone } from 'react-dropzone'
+import { toast } from 'sonner'
+
+import useUpload from '../react/use-upload'
+
+interface FileApi {
+  info: FunctionReference<'query'>
+  upload: FunctionReference<'mutation'>
+}
+
+const FileApiContext = createContext<FileApi | null>(null),
+  FileApiProvider = ({ children, value }: { children: ReactNode; value: FileApi }) => (
+    <FileApiContext value={value}>{children}</FileApiContext>
+  ),
+  useFileApi = () => {
+    const ctx = use(FileApiContext)
+    if (!ctx) throw new Error('FileApiProvider is required')
+    return ctx
+  },
+  fmt = (n: number) =>
+    n < 1024 ? `${n} B` : n < 1_048_576 ? `${(n / 1024).toFixed(1)} KB` : `${(n / 1_048_576).toFixed(1)} MB`,
+  isImg = (t: string) => t.startsWith('image/'),
+  parseAccept = (a?: string): Record<string, string[]> | undefined =>
+    a ? Object.fromEntries(a.split(',').map(t => [t.trim(), []])) : undefined,
+  compress = async (f: File, on: boolean) =>
+    on && f.type.startsWith('image/')
+      ? imageCompression(f, { maxSizeMB: 1, maxWidthOrHeight: 1920, useWebWorker: true }).catch(() => f)
+      : f,
+  Preview = ({ id, onRemove }: { id: string; onRemove?: () => void }) => {
+    const { info } = useFileApi(),
+      d = useQuery(info, { id }) as null | undefined | { contentType: string; size: number; url: null | string }
+    if (!d) return <p className='size-16 animate-pulse rounded-lg bg-muted' />
+    return (
+      <div className='relative'>
+        {d.contentType && isImg(d.contentType) && d.url ? (
+          <img alt='' className='size-16 rounded-lg object-cover' height={64} src={d.url} width={64} />
+        ) : (
+          <div className='flex size-16 flex-col items-center justify-center rounded-lg bg-muted text-xs'>
+            <FileIcon className='size-6 text-muted-foreground' />
+            <span className='mt-1'>{fmt(d.size)}</span>
+          </div>
+        )}
+        {onRemove ? (
+          <button
+            className='absolute -top-2 -right-2 rounded-full bg-destructive p-1 text-white transition-transform hover:scale-110'
+            onClick={onRemove}
+            type='button'>
+            <X className='size-3' />
+          </button>
+        ) : null}
+      </div>
+    )
+  },
+  Progress = ({ v }: { v: number }) => (
+    <div className='flex flex-col items-center'>
+      <div className='mb-2 h-2 w-32 overflow-hidden rounded-full bg-muted'>
+        <div className='h-full bg-primary transition-all' style={{ width: `${v}%` }} />
+      </div>
+      <span className='text-sm text-muted-foreground'>{v}%</span>
+    </div>
+  ),
+  FileFieldImpl = ({
+    accept,
+    className,
+    compressImg = true,
+    'data-testid': testId,
+    disabled,
+    field: f,
+    label,
+    max,
+    maxSize,
+    multiple
+  }: {
+    accept?: string
+    className?: string
+    compressImg?: boolean
+    'data-testid'?: string
+    disabled?: boolean
+    field: AnyFieldApi
+    label?: string
+    max?: number
+    maxSize?: number
+    multiple?: boolean
+  }) => {
+    const { upload: uploadRef } = useFileApi(),
+      raw = f.state.value,
+      vals = multiple ? ((raw ?? []) as string[]) : raw ? [raw as string] : [],
+      inv = f.state.meta.isTouched && !f.state.meta.isValid,
+      canAdd = multiple ? !max || vals.length < max : !vals.length,
+      { isUploading, progress, reset, upload } = useUpload(uploadRef),
+      errorId = `${f.name}-error`,
+      onDrop = useCallback(
+        async (accepted: File[]) => {
+          if (multiple && max && vals.length + accepted.length > max) return toast.error(`Max ${max}`)
+          const ids: string[] = []
+          for (const file of accepted) {
+            const res = await upload(await compress(file, compressImg))
+            if (res.ok) ids.push(res.storageId)
+            else if (res.code === 'HTTP') toast.error(`${file.name}: Upload failed (${res.status})`)
+            else if (res.code === 'ABORTED') toast.error(`${file.name}: Upload canceled`)
+            else if (res.code === 'NETWORK') toast.error(`${file.name}: Network error`)
+            else if (res.code === 'INVALID_RESPONSE') toast.error(`${file.name}: Invalid response`)
+            // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
+            else if (res.code === 'URL') toast.error(`${file.name}: Failed to start upload`)
+          }
+          if (multiple) f.handleChange([...vals, ...ids])
+          else if (ids[0]) f.handleChange(ids[0])
+        },
+        [compressImg, f, max, multiple, upload, vals]
+      ),
+      { getInputProps, getRootProps, inputRef, isDragActive } = useDropzone({
+        accept: parseAccept(accept),
+        disabled: disabled ?? (isUploading || !canAdd),
+        maxSize,
+        multiple: Boolean(multiple),
+        // eslint-disable-next-line @typescript-eslint/strict-void-return, @typescript-eslint/no-misused-promises
+        onDrop,
+        onDropRejected: r => {
+          const code = r[0]?.errors[0]?.code
+          if (code === 'file-too-large' && maxSize) toast.error(`Max ${fmt(maxSize)}`)
+          else if (code === 'file-invalid-type') toast.error('Invalid type')
+          else if (code === 'too-many-files' && max) toast.error(`Max ${max}`)
+        }
+      }),
+      dropCls = cn(
+        'flex cursor-pointer flex-col items-center justify-center rounded-lg border-2 border-dashed transition-colors focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 focus-visible:outline-none',
+        multiple ? 'size-16' : 'p-6',
+        isDragActive ? 'border-primary bg-primary/5' : 'border-muted-foreground/25 hover:border-primary/50',
+        (disabled ?? isUploading) && 'cursor-not-allowed opacity-50',
+        className
+      ),
+      tid = testId ?? f.name
+    return (
+      <Field data-invalid={inv} data-testid={tid}>
+        {label ? (
+          <FieldLabel htmlFor={f.name}>
+            {label}
+            {multiple && max ? (
+              <span className='text-muted-foreground'>
+                {' '}
+                ({vals.length}/{max})
+              </span>
+            ) : null}
+          </FieldLabel>
+        ) : null}
+        {multiple ? (
+          <div className='flex flex-wrap gap-2'>
+            {vals.map((id, i) => (
+              <Preview id={id} key={id} onRemove={() => f.handleChange(vals.filter((_, j) => j !== i))} />
+            ))}
+            {canAdd ? (
+              <div
+                {...getRootProps()}
+                aria-label='Upload file'
+                className={dropCls}
+                onKeyDown={e => {
+                  if (e.key === 'Enter' || e.key === ' ') {
+                    e.preventDefault()
+                    // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
+                    inputRef.current?.click()
+                  }
+                }}
+                role='button'
+                tabIndex={0}>
+                <input {...getInputProps()} aria-describedby={inv ? errorId : undefined} aria-invalid={inv} />
+                {isUploading ? (
+                  <span className='text-xs'>{progress}%</span>
+                ) : (
+                  <Upload className='size-5 text-muted-foreground' />
+                )}
+              </div>
+            ) : null}
+          </div>
+        ) : vals[0] ? (
+          <Preview
+            id={vals[0]}
+            onRemove={() => {
+              f.handleChange(null)
+              reset()
+            }}
+          />
+        ) : (
+          <div
+            {...getRootProps()}
+            aria-label='Upload file'
+            className={dropCls}
+            onKeyDown={e => {
+              if (e.key === 'Enter' || e.key === ' ') {
+                e.preventDefault()
+                // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
+                inputRef.current?.click()
+              }
+            }}
+            role='button'
+            tabIndex={0}>
+            <input {...getInputProps()} aria-describedby={inv ? errorId : undefined} aria-invalid={inv} />
+            {isUploading ? (
+              <Progress v={progress} />
+            ) : (
+              <>
+                {accept?.includes('image') ? (
+                  <ImageIcon className='mb-2 size-8 text-muted-foreground' />
+                ) : (
+                  <Upload className='mb-2 size-8 text-muted-foreground' />
+                )}
+                <span className='text-sm text-muted-foreground'>Click or drag</span>
+                {maxSize ? <span className='mt-1 text-xs text-muted-foreground'>Max {fmt(maxSize)}</span> : null}
+              </>
+            )}
+          </div>
+        )}
+        {inv ? <FieldError errors={f.state.meta.errors} id={errorId} /> : null}
+      </Field>
+    )
+  }
+
+export default FileFieldImpl
+export { FileApiContext, FileApiProvider }

package/src/components/form.tsx

@@ -0,0 +1,191 @@
+/* eslint-disable react-hooks/rules-of-hooks */
+// biome-ignore-all lint/suspicious/noExplicitAny: x
+// biome-ignore-all lint/correctness/useHookAtTopLevel: watch hook is called inside component render context
+'use client'
+import type { FunctionReference } from 'convex/server'
+import type { ReactNode } from 'react'
+import type { infer as zinfer, ZodObject, ZodRawShape } from 'zod/v4'
+
+import { Button } from '@a/ui/button'
+import { Dialog, DialogContent } from '@a/ui/dialog'
+import { useNavigationGuard } from 'next-navigation-guard'
+import { useEffect, useState } from 'react'
+
+import type { FormReturn as BaseFormReturn, ConflictData } from '../react/form'
+import type { Api } from './fields'
+
+import { useForm as useBaseForm, useFormMutation as useBaseFormMutation } from '../react/form'
+import { fields, FormContext } from './fields'
+
+const ConflictDialog = ({
+  conflict,
+  onResolve
+}: {
+  conflict: ConflictData | null
+  onResolve: (action: 'cancel' | 'overwrite' | 'reload') => void
+}) => (
+  <Dialog open={Boolean(conflict)}>
+    <DialogContent
+      className='[&>button]:hidden'
+      onEscapeKeyDown={() => onResolve('cancel')}
+      onInteractOutside={() => onResolve('cancel')}>
+      <h2 className='text-lg font-semibold'>Conflict Detected</h2>
+      <p className='text-sm text-muted-foreground'>
+        This record was modified by someone else. Choose how to resolve the conflict.
+      </p>
+      {conflict?.current || conflict?.incoming ? (
+        <div className='space-y-3'>
+          {conflict.current ? (
+            <div className='rounded-lg bg-muted p-3'>
+              <p className='mb-1 text-xs font-medium text-muted-foreground'>Server version:</p>
+              <pre className='text-xs'>{JSON.stringify(conflict.current, null, 2)}</pre>
+            </div>
+          ) : null}
+          {conflict.incoming ? (
+            <div className='rounded-lg bg-muted p-3'>
+              <p className='mb-1 text-xs font-medium text-muted-foreground'>Your version:</p>
+              <pre className='text-xs'>{JSON.stringify(conflict.incoming, null, 2)}</pre>
+            </div>
+          ) : null}
+        </div>
+      ) : null}
+      <div className='flex justify-end gap-2'>
+        <Button onClick={() => onResolve('cancel')} variant='outline'>
+          Cancel
+        </Button>
+        <Button onClick={() => onResolve('reload')} variant='outline'>
+          Reload
+        </Button>
+        <Button onClick={() => onResolve('overwrite')} variant='destructive'>
+          Overwrite
+        </Button>
+      </div>
+    </DialogContent>
+  </Dialog>
+)
+
+interface FormReturn<T extends Record<string, unknown>, S extends ZodObject<ZodRawShape>> extends BaseFormReturn<T, S> {
+  guard: ReturnType<typeof useNavigationGuard>
+}
+type Key<T, V> = string & { [K in keyof T]: T[K] extends V ? K : never }[keyof T]
+type Props<K extends keyof typeof fields> = Parameters<(typeof fields)[K]>[0]
+
+interface TypedFields<T> {
+  Arr: (p: WithName<Props<'Arr'>, Key<T, readonly string[] | string[] | undefined>>) => ReactNode
+  Choose: (p: WithName<Props<'Choose'>, Key<T, string | undefined>>) => ReactNode
+  Colorpick: (p: WithName<Props<'Colorpick'>, Key<T, string | undefined>>) => ReactNode
+  Combobox: (p: WithName<Props<'Combobox'>, Key<T, string | undefined>>) => ReactNode
+  Datepick: (p: WithName<Props<'Datepick'>, Key<T, null | number | undefined>>) => ReactNode
+  Err: typeof fields.Err
+  File: (p: WithName<Props<'File'>, Key<T, null | string | undefined>>) => ReactNode
+  Files: (p: WithName<Props<'Files'>, Key<T, readonly string[] | string[] | undefined>>) => ReactNode
+  MultiSelect: (p: WithName<Props<'MultiSelect'>, Key<T, readonly string[] | string[] | undefined>>) => ReactNode
+  Num: (p: WithName<Props<'Num'>, Key<T, number | undefined>>) => ReactNode
+  Rating: (p: WithName<Props<'Rating'>, Key<T, number | undefined>>) => ReactNode
+  Slider: (p: WithName<Props<'Slider'>, Key<T, number | undefined>>) => ReactNode
+  Submit: typeof fields.Submit
+  Text: (
+    p: WithName<Props<'Text'>, Key<T, string | undefined>> & {
+      asyncDebounceMs?: number
+      asyncValidate?: (value: string) => Promise<string | undefined>
+    }
+  ) => ReactNode
+  Timepick: (p: WithName<Props<'Timepick'>, Key<T, string | undefined>>) => ReactNode
+  Toggle: (p: { falseLabel?: string; name: Key<T, boolean | undefined>; trueLabel: string }) => ReactNode
+}
+
+type WithName<P, K> = Omit<P, 'name'> & { name: K }
+
+const withGuard = <T extends Record<string, unknown>, S extends ZodObject<ZodRawShape>>(
+    base: BaseFormReturn<T, S>
+  ): FormReturn<T, S> => {
+    const dirty = base.isDirty || base.isPending,
+      guard = useNavigationGuard({ enabled: dirty })
+    useEffect(() => {
+      if (!dirty) return
+      const h = (e: BeforeUnloadEvent) => {
+        e.preventDefault()
+        // eslint-disable-next-line @typescript-eslint/no-deprecated
+        e.returnValue = ''
+      }
+      window.addEventListener('beforeunload', h)
+      return () => window.removeEventListener('beforeunload', h)
+    }, [dirty])
+    return { ...base, guard }
+  },
+  useForm = <S extends ZodObject<ZodRawShape>>(opts: {
+    autoSave?: { debounceMs: number; enabled: boolean }
+    onConflict?: (data: ConflictData) => void
+    onError?: (e: unknown) => void
+    onSubmit: (d: zinfer<S>, force?: boolean) => Promise<undefined | zinfer<S>> | undefined | zinfer<S>
+    onSuccess?: () => void
+    resetOnSuccess?: boolean
+    schema: S
+    values?: zinfer<S>
+  }) => withGuard(useBaseForm(opts)),
+  useFormMutation = <S extends ZodObject<ZodRawShape>>(opts: {
+    mutation: FunctionReference<'mutation'>
+    onConflict?: (data: ConflictData) => void
+    onError?: (e: unknown) => void
+    onSuccess?: () => void
+    resetOnSuccess?: boolean
+    schema: S
+    transform?: (d: zinfer<S>) => Record<string, unknown>
+    values?: zinfer<S>
+  }) => withGuard(useBaseFormMutation(opts)),
+  Form = <T extends Record<string, unknown>, S extends ZodObject<ZodRawShape>>({
+    className,
+    form: { conflict, error, guard, instance, meta, resolveConflict, schema },
+    render,
+    showError = true
+  }: {
+    className?: string
+    form: FormReturn<T, S>
+    render: (f: TypedFields<T>) => ReactNode
+    showError?: boolean
+  }) => (
+    <FormContext value={{ form: instance as Api<Record<string, unknown>>, meta, schema }}>
+      <form
+        className={className}
+        onSubmit={e => {
+          e.preventDefault()
+          instance.handleSubmit()
+        }}>
+        {showError && error ? (
+          <p className='mb-4 rounded-lg bg-destructive/10 p-3 text-sm text-destructive' role='alert'>
+            {error.message}
+          </p>
+        ) : null}
+        {render(fields as TypedFields<T>)}
+      </form>
+      <ConflictDialog conflict={conflict} onResolve={resolveConflict} />
+      <Dialog open={guard.active}>
+        <DialogContent className='[&>button]:hidden' onEscapeKeyDown={guard.reject} onInteractOutside={guard.reject}>
+          <p>You have unsaved changes. Are you sure you want to leave?</p>
+          <div className='flex justify-end gap-2'>
+            <Button onClick={guard.reject} variant='outline'>
+              Cancel
+            </Button>
+            <Button onClick={guard.accept} variant='destructive'>
+              Discard
+            </Button>
+          </div>
+        </DialogContent>
+      </Dialog>
+    </FormContext>
+  ),
+  AutoSaveIndicator = ({ lastSaved }: { lastSaved: null | number }) => {
+    const [, forceUpdate] = useState(0)
+
+    useEffect(() => {
+      if (!lastSaved) return
+      const id = setInterval(() => forceUpdate(n => n + 1), 10_000)
+      return () => clearInterval(id)
+    }, [lastSaved])
+
+    if (!lastSaved) return null
+    const ago = Math.round((Date.now() - lastSaved) / 1000)
+    return <span className='text-xs text-muted-foreground'>{ago < 5 ? 'Saved' : `Saved ${ago}s ago`}</span>
+  }
+
+export { AutoSaveIndicator, ConflictDialog, Form, useForm, useFormMutation }

package/src/components/index.ts

@@ -0,0 +1,11 @@
+export { default as EditorsSection } from './editors-section'
+export { fields, FormContext } from './fields'
+export type { Api } from './fields'
+export { FileApiContext, FileApiProvider } from './file-field'
+export { default as FileFieldImpl } from './file-field'
+export { AutoSaveIndicator, ConflictDialog, Form, useForm, useFormMutation } from './form'
+export { default as OfflineIndicator } from './offline-indicator'
+export { default as OrgAvatar } from './org-avatar'
+export { default as PermissionGuard } from './permission-guard'
+export { default as RoleBadge } from './role-badge'
+export { default as suspenseWrap } from './suspense-wrap'

package/src/components/offline-indicator.tsx

@@ -0,0 +1,15 @@
+'use client'
+
+import useOnlineStatus from '../react/use-online-status'
+
+const OfflineIndicator = () => {
+  const online = useOnlineStatus()
+  if (online) return null
+  return (
+    <div className='fixed bottom-4 left-4 z-50 rounded-md bg-destructive px-4 py-2 text-sm font-medium text-destructive-foreground shadow-lg'>
+      You are offline
+    </div>
+  )
+}
+
+export default OfflineIndicator

package/src/components/org-avatar.tsx

@@ -0,0 +1,13 @@
+'use client'
+
+import { Avatar, AvatarFallback, AvatarImage } from '@a/ui/avatar'
+
+const sizes = { lg: 'size-12', md: 'size-8', sm: 'size-6' },
+  OrgAvatar = ({ avatarUrl, name, size = 'md' }: { avatarUrl?: string; name: string; size?: 'lg' | 'md' | 'sm' }) => (
+    <Avatar className={sizes[size]}>
+      {avatarUrl ? <AvatarImage src={avatarUrl} /> : null}
+      <AvatarFallback>{name.slice(0, 2).toUpperCase()}</AvatarFallback>
+    </Avatar>
+  )
+
+export default OrgAvatar

package/src/components/permission-guard.tsx

@@ -0,0 +1,36 @@
+/* eslint-disable @typescript-eslint/promise-function-async */
+'use client'
+
+import type { ReactNode } from 'react'
+
+import { Badge } from '@a/ui/badge'
+import { Button } from '@a/ui/button'
+import Link from 'next/link'
+
+const PermissionGuard = ({
+  backHref,
+  backLabel,
+  canAccess,
+  children,
+  resource
+}: {
+  backHref: string
+  backLabel: string
+  canAccess: boolean
+  children: ReactNode
+  resource: string
+}) => {
+  if (!canAccess)
+    return (
+      <div className='flex flex-col items-center gap-4 py-12'>
+        <Badge variant='secondary'>View only</Badge>
+        <p className='text-muted-foreground'>You don&apos;t have edit permission for this {resource}.</p>
+        <Button asChild variant='outline'>
+          <Link href={backHref}>Back to {backLabel}</Link>
+        </Button>
+      </div>
+    )
+  return children
+}
+
+export default PermissionGuard

package/src/components/role-badge.tsx

@@ -0,0 +1,14 @@
+'use client'
+
+import { Badge } from '@a/ui/badge'
+
+import type { OrgRole } from '../server/types'
+
+const variants: Record<OrgRole, 'default' | 'outline' | 'secondary'> = {
+    admin: 'secondary',
+    member: 'outline',
+    owner: 'default'
+  },
+  RoleBadge = ({ role }: { role: OrgRole }) => <Badge variant={variants[role]}>{role}</Badge>
+
+export default RoleBadge

package/src/components/suspense-wrap.tsx

@@ -0,0 +1,8 @@
+// oxlint-disable unicorn/no-anonymous-default-export
+
+import type { ReactNode } from 'react'
+
+import { Suspense } from 'react'
+
+// eslint-disable-next-line react/display-name
+export default (f: (...args: unknown[]) => ReactNode) => () => <Suspense fallback=''>{f()}</Suspense>

package/src/index.ts

@@ -0,0 +1,40 @@
+export type { Api, ConflictData, FormReturn } from './react/form'
+export type { FieldKind, FieldMeta, FieldMetaMap } from './react/form-meta'
+export type { OrgContextValue, OrgDoc, OrgProviderProps } from './react/org'
+export type {
+  Ab,
+  ActionCtxLike,
+  AuthorInfo,
+  CacheCrudResult,
+  CacheOptions,
+  CanEditOpts,
+  ChildConfig,
+  ChildCrudResult,
+  ComparisonOp,
+  CrudOptions,
+  CrudReadApi,
+  CrudResult,
+  DbLike,
+  DbReadLike,
+  DocBase,
+  EnrichedDoc,
+  ErrorCode,
+  FID,
+  Mb,
+  MutationCtxLike,
+  OrgCrudResult,
+  OrgEnrichedDoc,
+  OrgRole,
+  PaginatedResult,
+  PaginationOptsShape,
+  Qb,
+  QueryCtxLike,
+  QueryLike,
+  ReadCtx,
+  SetupConfig,
+  StorageLike,
+  WhereGroupOf,
+  WhereOf,
+  WithUrls
+} from './server/types'
+export type { CvMeta, DefType, ZodSchema } from './zod'

package/src/next/active-org.ts

@@ -0,0 +1,33 @@
+'use server'
+import type { FunctionReference } from 'convex/server'
+
+import { fetchQuery } from 'convex/nextjs'
+import { cookies } from 'next/headers'
+
+const setActiveOrgCookie = async ({ orgId, slug }: { orgId: string; slug: string }) => {
+    const cookieStore = await cookies(),
+      opts = { httpOnly: false, maxAge: 60 * 60 * 24 * 365, path: '/' } as const
+    cookieStore.set('activeOrgId', orgId, opts)
+    cookieStore.set('activeOrgSlug', slug, opts)
+  },
+  clearActiveOrgCookie = async () => {
+    const cookieStore = await cookies()
+    cookieStore.delete('activeOrgId')
+    cookieStore.delete('activeOrgSlug')
+  },
+  getActiveOrg = async ({ query, token }: { query: FunctionReference<'query'>; token: null | string }) => {
+    if (!token) return null
+    const cookieStore = await cookies(),
+      orgId = cookieStore.get('activeOrgId')?.value
+    if (!orgId) return null
+    try {
+      // eslint-disable-next-line @typescript-eslint/no-unsafe-return
+      return await fetchQuery(query, { orgId }, { token })
+    } catch {
+      cookieStore.delete('activeOrgId')
+      cookieStore.delete('activeOrgSlug')
+      return null
+    }
+  }
+
+export { clearActiveOrgCookie, getActiveOrg, setActiveOrgCookie }

package/src/next/auth.ts

@@ -0,0 +1,9 @@
+'use server'
+import { convexAuthNextjsToken } from '@convex-dev/auth/nextjs/server'
+
+// eslint-disable-next-line no-restricted-properties, @typescript-eslint/prefer-nullish-coalescing
+const isTest = Boolean(process.env.PLAYWRIGHT || process.env.TEST_MODE),
+  getToken = async () => (isTest ? undefined : convexAuthNextjsToken()),
+  isAuthenticated = async () => isTest || Boolean(await convexAuthNextjsToken())
+
+export { getToken, isAuthenticated }