# 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`](https://latest.alepha.dev/docs/reference-providers-bunshellprovider.md) - Bun implementation of ShellProvider.
- [`FileSystemProvider`](https://latest.alepha.dev/docs/reference-providers-filesystemprovider.md) - FileSystem interface providing utilities for working with files.
- [`MemoryFileSystemProvider`](https://latest.alepha.dev/docs/reference-providers-memoryfilesystemprovider.md) - In-memory implementation of FileSystemProvider for testing.
- [`MemoryShellProvider`](https://latest.alepha.dev/docs/reference-providers-memoryshellprovider.md) - In-memory implementation of ShellProvider for testing.
- [`NodeFileSystemProvider`](https://latest.alepha.dev/docs/reference-providers-nodefilesystemprovider.md) - Node.js implementation of FileSystem interface.
- [`NodeShellProvider`](https://latest.alepha.dev/docs/reference-providers-nodeshellprovider.md) - Node.js implementation of ShellProvider.
- [`ShellProvider`](https://latest.alepha.dev/docs/reference-providers-shellprovider.md) - Abstract provider for executing shell commands and binaries.
- [`WorkerdFileSystemProvider`](https://latest.alepha.dev/docs/reference-providers-workerdfilesystemprovider.md) - Web-standard implementation of FileSystemProvider for Cloudflare Workers and other edge runtimes.