# Alepha - System

## Installation

Part of the `alepha` package. Import from `alepha/system`.

```bash
npm install alepha
```

## Overview

System-level abstractions for portable code across runtimes.

**Features:**

- File system operations (read, write, exists, etc.)
- Shell command execution
- File type detection and MIME utilities
- Memory implementations for testing

## API Reference

### Providers

- [`BunShellProvider`](/docs/reference-providers-bunshellprovider) - Bun implementation of ShellProvider.
- [`FileSystemProvider`](/docs/reference-providers-filesystemprovider) - FileSystem interface providing utilities for working with files.
- [`MemoryFileSystemProvider`](/docs/reference-providers-memoryfilesystemprovider) - In-memory implementation of FileSystemProvider for testing.
- [`MemoryShellProvider`](/docs/reference-providers-memoryshellprovider) - In-memory implementation of ShellProvider for testing.
- [`NodeFileSystemProvider`](/docs/reference-providers-nodefilesystemprovider) - Node.js implementation of FileSystem interface.
- [`NodeShellProvider`](/docs/reference-providers-nodeshellprovider) - Node.js implementation of ShellProvider.
- [`ShellProvider`](/docs/reference-providers-shellprovider) - Abstract provider for executing shell commands and binaries.
- [`WorkerdFileSystemProvider`](/docs/reference-providers-workerdfilesystemprovider) - Web-standard implementation of FileSystemProvider for Cloudflare Workers and other edge runtimes.