Type Alias: LixFileDescriptor
LixFileDescriptor = FromLixSchemaDefinition<typeof LixFileDescriptorSchema>
The file descriptor type representing the stored metadata for a file.
This is the underlying entity stored in the database with schema_key 'lix_file_descriptor'.
It contains only the file's identity and metadata - NOT the actual file content.
┌─────────────────────────────────────────┐
│ LixFileDescriptor │
│ (schema_key: 'lix_file_descriptor') │
├─────────────────────────────────────────┤
│ • id: string (file identifier) │
│ • path: string (e.g., "/docs/README.md")│
│ • metadata: object | null │
│ • hidden: boolean │
└─────────────────────────────────────────┘
↓
Stored in state/state_all table
↓
┌─────────────────────────────────────────┐
│ File content entities are stored │
│ separately with file_id = descriptor.id │
│ │
│ • JSON properties (mock_json_property) │
│ • Markdown blocks (markdown_block) │
│ • CSV rows (csv_row) │
│ • etc... │
└─────────────────────────────────────────┘
Key points:
- File descriptors are just metadata - they don't contain file data
- The actual file content is stored as separate entities linked by file_id
- File views aggregate the descriptor + content entities into a complete file
- Changes to file content don't update the descriptor (and vice versa)
