Zon File Management System

A comprehensive file management system for Val Town that handles different file types including HTTP, cron, email, JSON, and more with collaborative editing capabilities.

• Multi-file type support: HTTP, cron, email, JSON, TypeScript, and more
• Collaborative editing: Real-time collaboration using YJS with ts-editor component
• TypeScript editor: Full-featured TypeScript editor with syntax highlighting
• File type detection: Automatic file type detection and appropriate handling
• Val Town integration: Direct integration with Val Town API for file management
• Configurable URLs: All service URLs are configurable via config.json

├── config.json          # Configuration file with URLs and file type definitions
├── zons                 # Main gallery view showing all zons (HTTP)
├── zon                  # Individual zon view with file listings (HTTP)  
├── file                 # File editor interface with TypeScript support (HTTP)
├── sync                 # Background sync service for YJS collaboration (Cron)
└── README.md           # This file

The system uses /config.json for configuration:

{
  "urls": {
    "zons": "https://zons.val.run",     // Main gallery URL
    "zon": "https://zon.val.run",       // Individual zon view URL  
    "files": "https://svc.val.run"      // File editor URL
  },
  "editor": {
    "yjs": {
      "room": "@vals",                   // YJS collaboration room
      "url": "wss://hp.cfapps.us10-001.hana.ondemand.com"  // YJS WebSocket URL
    }
  },
  "fileTypes": {
    // File type definitions with icons, colors, templates, etc.
  }
}

• HTTP (http) - Web endpoints and APIs
• Cron (cron) - Scheduled tasks
• Email (email) - Email handlers
• JSON (json) - Configuration and data files
• TypeScript (ts) - General TypeScript files
• JavaScript (js) - JavaScript files
• Markdown (md) - Documentation files

• GET / - Main gallery showing all zons
• Displays all available zons with metadata

• GET / - Redirects to main gallery
• GET /{zon-name} - View files in specific zon
• GET /{zon-name}/files - API endpoint returning JSON list of files
• Groups files by type and shows file metadata

• GET / - Redirects to main gallery (configurable)
• GET /{zon-name}/{file-name} - Edit specific file with ts-editor
• GET /{zon-name}/{file-name}/raw - Get raw file content as JSON
• POST /{zon-name}/{file-name} - Save file changes

• Cron job that syncs Val Town files to YJS documents
• Enables real-time collaborative editing
• Runs periodically to keep YJS documents up to date

1. Browse zons: Visit main gallery to see all available zons
2. Select zon: Click on a zon to view its files grouped by type
3. Edit file: Click on a file to open it in the collaborative editor
4. Save changes: Use the Save button to persist changes back to Val Town
5. Run HTTP files: Use the Run button to test HTTP endpoints

The system integrates with:

• Val Town API: For reading/writing files and managing zons
• YJS: For real-time collaborative editing
• ts-editor: For TypeScript/JavaScript editing with syntax highlighting

• All URLs are configurable via config.json
• File types can be extended by adding to the fileTypes configuration
• Authorization is currently disabled for development (returns true)
• Error handling includes proper error propagation and user feedback