Home Doh Ref
Core ▼
Ai Glossary Auto Packager Data-binding Dohballs Dohpath Load Manifests Modules Overview Packages Pods Project-structure Resolution Order Use Snapshot Use State
Tools ▼
Backup Cli Esbuild Export External Packages
Guides ▼
Getting Started
Patterns ▼
Css Html Lifecycle Moc Objects Patterns Seeif Stylesheet Sub-object-builder
Dohballs ▼
  • 📁 doh_chat
    • 📦 ai_keys_admin
    • 📦 ai_services
    • 📦 chat
    • 📦 chat_embed
    • 📦 chat_files
    • 📦 chat_messenger
    • 📦 collab_docs
    • 📦 collab_richtext
    • 📦 collab_shared
  • 📦 doh_js
  • 📁 doh_modules
    • 📦 admin_dashboard
    • 📦 banal
    • 📦 cloud_manager
    • 📦 cookie_alert
    • 📦 crawlclone
    • 📦 dataforge
      • 📦 dataforge_handlebars
      • 📦 db_dataforge
    • 📦 deploydoh_home
    • 📦 dohball_manager
    • 📦 export_browser
    • 📦 express
      • 📦 ajax
      • 📦 analytics
      • 📦 hmr
      • 📦 remote_state
      • 📦 socket_handler
    • 📦 feedback
    • 📦 greenlockcli
    • 📦 html_differ
    • 📦 ide
    • 📦 legal_admin
    • 📦 managed_site
    • 📦 mcp
    • 📦 monaco_editor
    • 📦 privacy
    • 📦 redbird
    • 📦 security_audit
    • 📦 server_manager
    • 📁 sso
      • 📦 sso_client
      • 📦 sso_server
    • 📦 storage_manager
    • 📦 synthara_v2
    • 📦 terms
    • 📦 tests
    • 📦 unet
    • 📁 user
      • 📦 core
      • 📦 user_host
      • 📦 user_permissions
    • 📦 yjs

chat_files

File transfer subsystem for chat with P2P-first delivery and socket relay fallback.

What this module provides

Although chat_files has no standalone .doh.yaml, it is loaded through the chat package as:

  • node: chat_files_server
  • browser: chat_files_client

Server (chat_files_server.js)

Responsibilities:

  • initializes file tables in DB chat:
    • chat.files (metadata)
    • chat.file_seeds (who can serve each file)
  • enforces limits from Doh.pod.chat_files (size, chunking, timeout, cache caps)
  • writes file messages into chat.messages using [FILE] payload format
  • tracks room membership/guest access before allowing share/download flows

Socket events handled include:

  • chat:file:share
  • chat:file:request_peers
  • chat:file:signal (WebRTC offer/answer/ICE relay)
  • chat:file:relay_request, chat:file:relay_chunk, chat:file:relay_complete
  • chat:file:seed_registered
  • chat:file:probe (+ probe responses)

Client (chat_files_client.js)

Main pieces:

  • TransferManager orchestration for requesting/transferring files
  • FileCache (IndexedDB-backed local cache)
  • ChunkAccumulator for efficient chunk merge/finalization
  • ChatFileCard UI with transfer state, previews, cancel/download actions

Capabilities:

  • WebRTC data channel transfer with ICE servers from pod config
  • socket relay fallback when P2P cannot establish
  • media/text/pdf preview handling
  • optional media playback sync over chat socket
  • drag-and-drop integration with chat input surfaces

Configuration

Default pod keys are declared in Doh.Pod('chat_files_server', ...), including:

  • chunk_size
  • max_file_size
  • webrtc_timeout
  • relay_batch_size
  • cache_max_bytes
  • image_auto_download_max

Override in pod.yaml as needed.

Last updated: 2/17/2026