---
name: xberg-io/mime-detection-routing
source: https://app.decimal.ai/s/xberg-io-mime-detection-routing@1/SKILL.md
source_sha256: f60cccff43d8
---

# MIME Detection & Routing

## Detection Flow

```text
Extension -> EXT_TO_MIME map -> validate -> Registry lookup -> Extractor
```

## Key Functions

| Function                             | Location       | Purpose                                 |
| ------------------------------------ | -------------- | --------------------------------------- |
| `detect_mime_type(path, inspect)`    | `core/mime.rs` | Extension + optional content inspection |
| `detect_mime_type_from_bytes(bytes)` | `core/mime.rs` | Magic number detection (infer crate)    |
| `validate_mime_type(mime)`           | `core/mime.rs` | Check if any extractor supports it      |

## Extension Mapping

115 extensions mapped in `EXT_TO_MIME` (`core/mime.rs`). Case-insensitive.

Key mappings: `.pdf` -> `application/pdf`, `.docx` -> `application/vnd.openxmlformats-officedocument.wordprocessingml.document`, `.xlsx` -> spreadsheet variant, `.png`/`.jpg` -> `image/*`

## Registry Selection

```rust
// In core/extractor/bytes.rs
fn select_extractor_for_mime(mime_type: &str) -> Result<Arc<dyn DocumentExtractor>> {
    let registry = get_document_extractor_registry();
    let registry_guard = registry.read()?;
    registry_guard.get_for_mime_type(mime_type)
        .ok_or_else(|| XbergError::UnsupportedFormat(mime_type.into()))
}
```

Selects highest-priority extractor registered for that MIME type.

## Adding New MIME Types

1. Add extension mapping: `m.insert("ext", "application/x-new");` in `core/mime.rs`
2. Implement `DocumentExtractor` with `supported_mime_types()` returning the MIME
3. Register in `register_default_extractors()`

## Wildcard Support

Extractors can register for MIME type families: `"image/*"` matches `image/png`, `image/jpeg`, etc.

## Critical Rules

1. Always `validate_mime_type()` before extraction
2. Extension mapping is case-insensitive
3. Content inspection (infer crate) is fallback for extension-less files
4. Registry validation is final authority on supported types