# ConveniencePro

> Privacy-focused developer utility tools with client-side processing. All tools run in your browser - no data is ever sent to servers.

ConveniencePro provides 25+ developer tools accessible via URL-as-API pattern, JavaScript SDK, and embeddable widgets. Designed for LLM integration without server infrastructure.

## Tool Categories

- **Encoding/Decoding**: Base64, URL, HTML encode/decode
- **JSON**: Format, minify, validate JSON
- **Hashing**: SHA-256, SHA-512, SHA-1, MD5
- **UUID**: Generate and validate UUIDs
- **Regex**: Test patterns, find/replace
- **Text**: Statistics, case conversion, reverse, trim
- **Numbers**: Formatting, base conversion
- **Date/Time**: Timestamp conversion
- **Colors**: Hex, RGB, HSL conversion

## LLM Integration

### URL-as-API Pattern

Invoke tools via URL parameters:

```
https://conveniencepro.cc/run/{tool-name}?param=value
```

Examples:
- `/run/base64-encode?text=Hello%20World`
- `/run/hash-sha256?text=secret`
- `/run/uuid-generate`
- `/run/json-format?json={"key":"value"}`

Results render as JSON in the page content.

### Discovery Endpoints

- Tool manifest: `/.well-known/ai-tools.json`
- OpenAPI spec: `/.well-known/openapi.yaml`
- ChatGPT plugin: `/.well-known/ai-plugin.json`
- A2A agent card: `/.well-known/agent-card.json`

### JavaScript SDK

```html
<script src="https://conveniencepro.cc/sdk/conveniencepro.js"></script>
<script>
  const result = ConveniencePro.base64Encode('Hello');
  console.log(result.encoded); // "SGVsbG8="
</script>
```

### Embeddable Widgets

```html
<iframe src="https://conveniencepro.cc/embed/base64-encode"
        width="400" height="300"></iframe>
```

## Available Tools

### Encoding
- `base64-encode` - Encode text to Base64
- `base64-decode` - Decode Base64 to text
- `url-encode` - URL encode text
- `url-decode` - URL decode text
- `html-encode` - HTML escape special characters
- `html-decode` - HTML unescape entities

### JSON
- `json-format` - Beautify/format JSON
- `json-minify` - Minify JSON
- `json-validate` - Validate JSON syntax

### Hashing
- `hash-sha256` - Generate SHA-256 hash
- `hash-sha512` - Generate SHA-512 hash
- `hash-sha1` - Generate SHA-1 hash (deprecated)
- `hash-md5` - Generate MD5 hash (not secure)

### UUID
- `uuid-generate` - Generate UUID v4
- `uuid-validate` - Validate UUID format

### Regex
- `regex-test` - Test regex pattern
- `regex-replace` - Replace using regex

### Text
- `text-stats` - Word/character counts
- `case-convert` - Convert text case
- `text-reverse` - Reverse text
- `text-trim` - Trim whitespace

### Numbers
- `number-format` - Format numbers
- `number-base` - Convert number bases

### Date/Time
- `timestamp` - Convert timestamps

### Colors
- `color-convert` - Convert color formats

## Security Model

All processing happens client-side in the browser:
- No data transmission to servers
- No storage or logging of user input
- No authentication required
- Fully static file deployment

## Links

- Website: https://conveniencepro.cc
- Tool Documentation: https://conveniencepro.cc/.well-known/ai-tools.json
- SDK: https://conveniencepro.cc/sdk/conveniencepro.js