deepspace 0.18.0 → 0.19.1

package/features/documents/src/InviteDialog.tsx

@@ -3,7 +3,11 @@ import type { RecordData } from 'deepspace'
 import { useMutations, useQuery, useUser } from 'deepspace'
 import { Mail, ShieldCheck, UserMinus, Users } from 'lucide-react'
 import { Modal, useToast } from '@/components/ui'
-import { parseDocumentsIdList, type DocumentsDocumentFields, type InviteAclDiff } from './documents-library-types'
+import {
+  parseDocumentsIdList,
+  type DocumentsDocumentFields,
+  type InviteAclDiff,
+} from './documents-library-types'
 
 interface UserFields {
   email?: string
@@ -42,12 +46,14 @@ function initialsFor(name: string): string {
 
 export function InviteDialog({ open, onOpenChange, doc, isOwner, onAclChange }: InviteDialogProps) {
   const { user } = useUser()
-  const { records: users } = useQuery<UserFields>('users')
-  const { put } = useMutations<DocumentsDocumentFields>('documents')
+  const { records: users, status: usersStatus } = useQuery<UserFields>('users')
+  const { putConfirmed, ready: documentsMutationsReady } =
+    useMutations<DocumentsDocumentFields>('documents')
   const toast = useToast()
   const [email, setEmail] = useState('')
   const [role, setRole] = useState<InviteRole>('editor')
   const [saving, setSaving] = useState(false)
+  const ready = usersStatus === 'ready' && documentsMutationsReady
 
   const collaborators = useMemo(
     () => parseDocumentsIdList(doc.data.collaborators),
@@ -70,7 +76,11 @@ export function InviteDialog({ open, onOpenChange, doc, isOwner, onAclChange }:
 
   if (!isOwner) return null
 
-  const saveAccess = async (nextCollaborators: string[], nextEditors: string[]) => {
+  const saveAccess = async (
+    nextCollaborators: string[],
+    nextEditors: string[],
+  ): Promise<boolean> => {
+    if (!ready) return false
     const prevCollaborators = parseDocumentsIdList(doc.data.collaborators)
     const prevEditors = parseDocumentsIdList(doc.data.editors)
     const nextCollabList = uniqueIds(nextCollaborators)
@@ -80,7 +90,7 @@ export function InviteDialog({ open, onOpenChange, doc, isOwner, onAclChange }:
 
     setSaving(true)
     try {
-      await put(doc.recordId, {
+      await putConfirmed(doc.recordId, {
         ...doc.data,
         collaborators: JSON.stringify(nextCollabList),
         editors: JSON.stringify(nextEditorList),
@@ -98,6 +108,13 @@ export function InviteDialog({ open, onOpenChange, doc, isOwner, onAclChange }:
           onAclChange({ removedUserIds, demotedUserIds, promotedUserIds })
         }
       }
+      return true
+    } catch {
+      toast.error(
+        'Access not saved',
+        'DeepSpace did not confirm the change. Reconnect and try again.',
+      )
+      return false
     } finally {
       setSaving(false)
     }
@@ -109,7 +126,10 @@ export function InviteDialog({ open, onOpenChange, doc, isOwner, onAclChange }:
 
     const target = users.find((u) => u.data.email?.trim().toLowerCase() === normalized)
     if (!target) {
-      toast.error('User not found', 'No DeepSpace user with that email has used this app yet.')
+      toast.error(
+        'User not found',
+        'Ask them to sign in to this app once, then invite the same email again.',
+      )
       return
     }
     if (target.recordId === doc.data.ownerId || target.recordId === user?.id) {
@@ -123,7 +143,7 @@ export function InviteDialog({ open, onOpenChange, doc, isOwner, onAclChange }:
 
     const nextCollaborators = [...collaborators, target.recordId]
     const nextEditors = role === 'editor' ? [...editors, target.recordId] : editors
-    await saveAccess(nextCollaborators, nextEditors)
+    if (!(await saveAccess(nextCollaborators, nextEditors))) return
     setEmail('')
     toast.success('Invite added', `${target.data.email ?? normalized} now has ${role} access.`)
   }
@@ -151,7 +171,12 @@ export function InviteDialog({ open, onOpenChange, doc, isOwner, onAclChange }:
     'Owner'
 
   return (
-    <Modal open={open} onClose={() => onOpenChange(false)} size="lg" className="documents-feature-scope">
+    <Modal
+      open={open}
+      onClose={() => onOpenChange(false)}
+      size="lg"
+      className="documents-feature-scope"
+    >
       <Modal.Header>
         <Modal.Title>Share document</Modal.Title>
         <Modal.Description>
@@ -174,6 +199,7 @@ export function InviteDialog({ open, onOpenChange, doc, isOwner, onAclChange }:
                 style={{ color: 'var(--documents-el-muted)' }}
               />
               <input
+                disabled={!ready || saving}
                 value={email}
                 onChange={(e) => setEmail(e.target.value)}
                 onKeyDown={(e) => {
@@ -181,7 +207,10 @@ export function InviteDialog({ open, onOpenChange, doc, isOwner, onAclChange }:
                 }}
                 placeholder="person@gmail.com"
                 className="h-10 w-full rounded-lg border bg-transparent pl-9 pr-3 text-sm outline-none focus-visible:ring-2 focus-visible:ring-ring/30"
-                style={{ borderColor: 'var(--documents-el-line)', color: 'var(--documents-el-text)' }}
+                style={{
+                  borderColor: 'var(--documents-el-line)',
+                  color: 'var(--documents-el-text)',
+                }}
               />
             </div>
             <select
@@ -196,7 +225,7 @@ export function InviteDialog({ open, onOpenChange, doc, isOwner, onAclChange }:
             <button
               type="button"
               onClick={() => void addInvite()}
-              disabled={saving || !email.trim()}
+              disabled={!ready || saving || !email.trim()}
               className="h-10 rounded-lg px-4 text-sm font-semibold text-white transition-opacity hover:opacity-90 disabled:cursor-not-allowed disabled:opacity-50"
               style={{ backgroundColor: 'var(--documents-el-accent)' }}
             >
@@ -253,7 +282,10 @@ export function InviteDialog({ open, onOpenChange, doc, isOwner, onAclChange }:
                   )}
                   <div className="min-w-0 flex-1">
                     <div className="truncate text-sm font-medium">{name}</div>
-                    <div className="truncate text-xs" style={{ color: 'var(--documents-el-muted)' }}>
+                    <div
+                      className="truncate text-xs"
+                      style={{ color: 'var(--documents-el-muted)' }}
+                    >
                       {u.data.email ?? 'No email'}
                     </div>
                   </div>
@@ -262,9 +294,12 @@ export function InviteDialog({ open, onOpenChange, doc, isOwner, onAclChange }:
                     onChange={(e) =>
                       void setCollaboratorRole(u.recordId, e.target.value as InviteRole)
                     }
-                    disabled={saving}
+                    disabled={!ready || saving}
                     className="h-8 rounded-lg border bg-transparent px-2 text-xs font-medium outline-none"
-                    style={{ borderColor: 'var(--documents-el-line)', color: 'var(--documents-el-text)' }}
+                    style={{
+                      borderColor: 'var(--documents-el-line)',
+                      color: 'var(--documents-el-text)',
+                    }}
                   >
                     <option value="editor">Editor</option>
                     <option value="viewer">Viewer</option>
@@ -272,7 +307,7 @@ export function InviteDialog({ open, onOpenChange, doc, isOwner, onAclChange }:
                   <button
                     type="button"
                     onClick={() => void removeCollaborator(u.recordId)}
-                    disabled={saving}
+                    disabled={!ready || saving}
                     className="rounded-lg p-1.5 text-red-600 transition-colors hover:bg-red-500/10 disabled:opacity-50"
                     title="Remove access"
                   >

package/features/documents/src/LibrarySidebar.tsx

@@ -182,6 +182,7 @@ export interface LibrarySidebarProps {
   selection: LibraryNavSelection
   onSelect: (s: LibraryNavSelection) => void
   folders: RecordData<DocFolderFields>[]
+  canManageFolders: boolean
   collapsed: boolean
   onToggleCollapsed: () => void
   onCreateFolder: (name: string) => void | Promise<void>
@@ -198,6 +199,7 @@ export function LibrarySidebar({
   selection,
   onSelect,
   folders,
+  canManageFolders,
   collapsed,
   onToggleCollapsed,
   onCreateFolder,
@@ -337,7 +339,7 @@ export function LibrarySidebar({
             </span>
             <div className="space-y-0.5">
               {sortedFolders.map((f) =>
-                renamingFolderId === f.recordId ? (
+                canManageFolders && renamingFolderId === f.recordId ? (
                   <div
                     key={f.recordId}
                     className="group flex w-full min-w-0 items-center gap-0.5 rounded-md bg-[color:var(--documents-el-accent)]/10 py-0.5 pl-0.5 dark:bg-[color:var(--documents-el-accent)]/15"
@@ -369,96 +371,102 @@ export function LibrarySidebar({
                     onClick={() => onSelect({ kind: 'folder', folderId: f.recordId })}
                     collapsed={collapsed}
                     trailing={
-                      <span className="relative z-[1] flex shrink-0 items-center gap-0.5">
-                        <button
-                          type="button"
-                          data-testid={`rename-folder-${f.recordId}`}
-                          onMouseDown={(e) => {
-                            e.preventDefault()
-                            e.stopPropagation()
-                          }}
-                          onClick={(e) => {
-                            e.stopPropagation()
-                            onStartRenameFolder(f)
-                          }}
-                          className="rounded p-1 text-[color:var(--documents-el-muted)] opacity-0 transition-all hover:bg-black/[0.04] hover:text-[color:var(--documents-el-accent)] group-hover:opacity-100 dark:hover:bg-white/[0.06]"
-                          title="Rename folder"
-                          aria-label={`Rename folder ${f.data.name}`}
-                        >
-                          <Pencil className="h-3.5 w-3.5" />
-                        </button>
-                        <button
-                          type="button"
-                          data-testid={`delete-folder-${f.recordId}`}
-                          onClick={(e) => {
-                            e.stopPropagation()
-                            if (
-                              confirm(
-                                `Delete folder “${f.data.name}”? Documents inside will move to uncategorized.`,
-                              )
-                            ) {
-                              void onDeleteFolder(f.recordId)
-                            }
-                          }}
-                          className="rounded p-1 text-[color:var(--documents-el-muted)] opacity-0 transition-all hover:bg-red-500/10 hover:text-red-600 group-hover:opacity-100"
-                          title="Delete folder"
-                          aria-label={`Delete folder ${f.data.name}`}
-                        >
-                          <Trash2 className="h-3.5 w-3.5" />
-                        </button>
-                      </span>
+                      canManageFolders ? (
+                        <span className="relative z-[1] flex shrink-0 items-center gap-0.5">
+                          <button
+                            type="button"
+                            data-testid={`rename-folder-${f.recordId}`}
+                            onMouseDown={(e) => {
+                              e.preventDefault()
+                              e.stopPropagation()
+                            }}
+                            onClick={(e) => {
+                              e.stopPropagation()
+                              onStartRenameFolder(f)
+                            }}
+                            className="rounded p-1 text-[color:var(--documents-el-muted)] opacity-0 transition-all hover:bg-black/[0.04] hover:text-[color:var(--documents-el-accent)] group-hover:opacity-100 dark:hover:bg-white/[0.06]"
+                            title="Rename folder"
+                            aria-label={`Rename folder ${f.data.name}`}
+                          >
+                            <Pencil className="h-3.5 w-3.5" />
+                          </button>
+                          <button
+                            type="button"
+                            data-testid={`delete-folder-${f.recordId}`}
+                            onClick={(e) => {
+                              e.stopPropagation()
+                              if (
+                                confirm(
+                                  `Delete folder “${f.data.name}”? Documents inside will move to uncategorized.`,
+                                )
+                              ) {
+                                void onDeleteFolder(f.recordId)
+                              }
+                            }}
+                            className="rounded p-1 text-[color:var(--documents-el-muted)] opacity-0 transition-all hover:bg-red-500/10 hover:text-red-600 group-hover:opacity-100"
+                            title="Delete folder"
+                            aria-label={`Delete folder ${f.data.name}`}
+                          >
+                            <Trash2 className="h-3.5 w-3.5" />
+                          </button>
+                        </span>
+                      ) : undefined
                     }
                   />
                 ),
               )}
 
-              {addingFolder ? (
-                <div className="py-1">
-                  <input
-                    autoFocus
-                    value={newFolderName}
-                    onChange={(e) => setNewFolderName(e.target.value)}
-                    onBlur={() => void submitNewFolder()}
-                    onKeyDown={(e) => {
-                      if (e.key === 'Enter') void submitNewFolder()
-                      if (e.key === 'Escape') {
-                        setAddingFolder(false)
-                        setNewFolderName('')
+              {canManageFolders &&
+                (addingFolder ? (
+                  <div className="py-1">
+                    <input
+                      autoFocus
+                      value={newFolderName}
+                      onChange={(e) => setNewFolderName(e.target.value)}
+                      onBlur={() => void submitNewFolder()}
+                      onKeyDown={(e) => {
+                        if (e.key === 'Enter') void submitNewFolder()
+                        if (e.key === 'Escape') {
+                          setAddingFolder(false)
+                          setNewFolderName('')
+                        }
+                      }}
+                      placeholder="Folder name"
+                      data-testid="new-folder-input"
+                      className="w-full rounded-md border px-2 py-1.5 text-[13px] outline-none focus-visible:ring-2 focus-visible:ring-ring/30"
+                      style={{
+                        borderColor: 'var(--documents-el-line)',
+                        backgroundColor: 'var(--documents-el-bg)',
+                        color: 'var(--documents-el-text)',
+                      }}
+                    />
+                  </div>
+                ) : (
+                  <button
+                    type="button"
+                    data-testid="new-folder-btn"
+                    onClick={() => {
+                      if (!collapsed) {
+                        setAddingFolder(true)
+                        return
                       }
+                      const name = window.prompt('Folder name')?.trim()
+                      if (name) void onCreateFolder(name)
                     }}
-                    placeholder="Folder name"
-                    data-testid="new-folder-input"
-                    className="w-full rounded-md border px-2 py-1.5 text-[13px] outline-none focus-visible:ring-2 focus-visible:ring-ring/30"
-                    style={{
-                      borderColor: 'var(--documents-el-line)',
-                      backgroundColor: 'var(--documents-el-bg)',
-                      color: 'var(--documents-el-text)',
-                    }}
-                  />
-                </div>
-              ) : (
-                <button
-                  type="button"
-                  data-testid="new-folder-btn"
-                  onClick={() => {
-                    if (!collapsed) {
-                      setAddingFolder(true)
-                      return
-                    }
-                    const name = window.prompt('Folder name')?.trim()
-                    if (name) void onCreateFolder(name)
-                  }}
-                  title={collapsed ? 'New folder' : undefined}
-                  className="flex h-9 w-full min-w-0 items-center gap-0 rounded-md pl-0.5 pr-0 text-left text-[13px] text-[color:var(--documents-el-muted)] transition-colors hover:bg-black/[0.04] hover:text-[color:var(--documents-el-accent)] dark:hover:bg-white/[0.06]"
-                >
-                  <span className="flex h-9 w-10 shrink-0 items-center justify-center" aria-hidden>
-                    <FolderPlus className="h-3.5 w-3.5 shrink-0" />
-                  </span>
-                  <span className={collapsed ? 'sr-only' : 'min-w-0 flex-1 truncate pr-2'}>
-                    New folder
-                  </span>
-                </button>
-              )}
+                    title={collapsed ? 'New folder' : undefined}
+                    className="flex h-9 w-full min-w-0 items-center gap-0 rounded-md pl-0.5 pr-0 text-left text-[13px] text-[color:var(--documents-el-muted)] transition-colors hover:bg-black/[0.04] hover:text-[color:var(--documents-el-accent)] dark:hover:bg-white/[0.06]"
+                  >
+                    <span
+                      className="flex h-9 w-10 shrink-0 items-center justify-center"
+                      aria-hidden
+                    >
+                      <FolderPlus className="h-3.5 w-3.5 shrink-0" />
+                    </span>
+                    <span className={collapsed ? 'sr-only' : 'min-w-0 flex-1 truncate pr-2'}>
+                      New folder
+                    </span>
+                  </button>
+                ))}
             </div>
           </div>
         </nav>

package/features/documents/src/__tests__/documents-presence-access.test.ts

@@ -5,6 +5,15 @@ import {
   isDocumentsOwner,
   resolveDocumentsAccessRole,
 } from '../use-documents-presence-access'
+import { recordsReadyForMutation } from '../documents-library-types'
+
+describe('document mutation readiness', () => {
+  it('requires both a ready query and a ready mutation transport', () => {
+    expect(recordsReadyForMutation('loading', true)).toBe(false)
+    expect(recordsReadyForMutation('ready', false)).toBe(false)
+    expect(recordsReadyForMutation('ready', true)).toBe(true)
+  })
+})
 
 describe('document access policy', () => {
   const document = {
@@ -42,8 +51,12 @@ describe('document access policy', () => {
     expect(deriveDocumentsAccessChange('viewer', 'editor', null)).toBe('upgrade')
     expect(deriveDocumentsAccessChange('viewer', 'none', null)).toBe('revoked')
     expect(deriveDocumentsAccessChange('owner', 'owner', null)).toBeNull()
-    expect(deriveDocumentsAccessChange(null, 'viewer', { kind: 'downgrade', at: 20 })).toBe('downgrade')
-    expect(deriveDocumentsAccessChange('editor', 'viewer', { kind: 'revoked', at: 20 })).toBe('revoked')
+    expect(deriveDocumentsAccessChange(null, 'viewer', { kind: 'downgrade', at: 20 })).toBe(
+      'downgrade',
+    )
+    expect(deriveDocumentsAccessChange('editor', 'viewer', { kind: 'revoked', at: 20 })).toBe(
+      'revoked',
+    )
   })
 
   it('accepts only a fresh ACL signal addressed to the current user', () => {

package/features/documents/src/documents-library-types.ts

@@ -29,6 +29,12 @@ export type LibraryNavSelection =
   | { kind: 'uncategorized' }
   | { kind: 'folder'; folderId: string }
 
+/** Record controls are usable only after both the initial query and mutation
+ * transport are ready. Keep that boundary identical across feature pages. */
+export function recordsReadyForMutation(queryStatus: string, mutationsReady: boolean): boolean {
+  return queryStatus === 'ready' && mutationsReady
+}
+
 export function parseDocumentsIdList(raw: string | undefined): string[] {
   if (!raw) return []
   try {

package/features/documents/src/editor/useDocEditor.ts

@@ -120,7 +120,7 @@ export function useDocEditor({
   canWrite,
   placeholder = 'Start typing — toolbar above for formatting…',
 }: UseDocEditorOptions): Editor | null {
-  /** Structured CRDT field that ProseMirror binds to — distinct from the legacy Y.Text('content'). */
+  /** Structured CRDT field that ProseMirror binds to. */
   const fragment = useMemo(() => doc.getXmlFragment('default'), [doc])
 
   /** CollaborationCaret expects a provider-shaped `{ awareness }` object. */

package/features/documents/src/use-documents-presence-access.ts

@@ -96,13 +96,11 @@ function peerToDocumentsParticipant(peer: PresencePeerClient): DocumentsPresence
   const participant: DocumentsPresenceParticipant = {
     clientId: 0,
     userId: peer.userId,
-    name: peer.userName?.trim() || peer.userEmail?.trim() || 'Guest',
+    name: peer.userName?.trim() || 'Guest',
     mode,
     typing: state.typing === true,
     isSelf: false,
   }
-  if (peer.userEmail) participant.email = peer.userEmail
-  if (peer.userImageUrl) participant.imageUrl = peer.userImageUrl
   if (lastTypedAt != null) participant.lastTypedAt = lastTypedAt
   return participant
 }

package/features/tasks/src/TasksPage.tsx

@@ -460,7 +460,10 @@ export default function TasksPage({ className }: TasksPageProps) {
   const handleUnclaim = async (challenge: { recordId: string; data: Challenge }) => {
     await put(challenge.recordId, {
       ...challenge.data,
-      claimedById: undefined,
+      // Empty strings are normalized to SQL NULL by the record writer. The
+      // read model omits null database fields, so this also keeps Challenge's
+      // optional-string shape honest.
+      claimedById: '',
     })
   }
 
@@ -469,8 +472,8 @@ export default function TasksPage({ className }: TasksPageProps) {
     await put(submitChallenge.recordId, {
       ...submitChallenge.data,
       submitted: true,
-      submissionUrl: url || undefined,
-      submissionNotes: notes || undefined,
+      submissionUrl: url,
+      submissionNotes: notes,
     })
     setSubmitChallenge(null)
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "deepspace",
-  "version": "0.18.0",
+  "version": "0.19.1",
   "engines": {
     "node": ">=22.15.0 <23 || >=24 <25 || >=26 <27"
   },
@@ -56,13 +56,13 @@
     "prepublishOnly": "pnpm build"
   },
   "dependencies": {
-    "@ai-sdk/anthropic": "^2.0.0",
-    "@ai-sdk/openai": "^2.0.0",
-    "@ai-sdk/openai-compatible": "^1.0.0",
+    "@ai-sdk/anthropic": "2.0.91",
+    "@ai-sdk/openai": "2.0.116",
+    "@ai-sdk/openai-compatible": "1.0.46",
     "@clack/prompts": "^1.2.0",
     "@mdx-js/mdx": "^3.1.1",
     "acorn": "^8.16.0",
-    "ai": "^5.0.0",
+    "ai": "5.0.222",
     "better-auth": "1.6.23",
     "citty": "^0.2.0",
     "cross-spawn": "^7.0.6",