odac 0.9.0

package/docs/server/02-get-started/03-cli-reference.md

@@ -0,0 +1,276 @@
+## 📖 CLI Reference
+
+This comprehensive reference covers all CandyPack CLI commands and their usage patterns, including both interactive and single-line modes with prefix arguments.
+
+### Command Structure
+
+CandyPack CLI follows a hierarchical command structure:
+```bash
+candy [command] [subcommand] [prefixes] [arguments]
+```
+
+### Prefix Arguments
+
+Most commands support prefix arguments that allow you to provide values directly in the command line, avoiding interactive prompts. This is especially useful for automation, scripting, and quick operations.
+
+#### Common Prefixes
+- `-d`, `--domain`: Domain name
+- `-e`, `--email`: Email address  
+- `-p`, `--password`: Password
+- `-s`, `--subdomain`: Subdomain name
+- `-i`, `--id`: Service ID or name
+- `-k`, `--key`: Authentication key
+
+### Authentication Commands
+
+#### `candy auth`
+Define your server to your CandyPack account.
+
+**Interactive:**
+```bash
+candy auth
+```
+
+**Single-line:**
+```bash
+candy auth -k your-auth-key
+candy auth --key your-auth-key
+```
+
+### Basic Server Commands
+
+#### `candy` (no arguments)
+Display server status, uptime, and statistics.
+
+#### `candy restart`
+Restart the CandyPack server.
+
+#### `candy monit`
+Monitor websites and services in real-time.
+
+#### `candy debug`
+View live server and application logs.
+
+#### `candy help`
+Display help information for all commands.
+
+### Service Management
+
+#### `candy run <file>`
+Add a new service by specifying the entry file path.
+
+**Example:**
+```bash
+candy run /path/to/your/app.js
+candy run ./index.js
+```
+
+#### `candy service delete`
+Delete a running service.
+
+**Interactive:**
+```bash
+candy service delete
+```
+
+**Single-line:**
+```bash
+candy service delete -i service-name
+candy service delete --id service-name
+```
+
+### Website Management
+
+#### `candy web create`
+Create a new website configuration.
+
+**Interactive:**
+```bash
+candy web create
+```
+
+**Single-line:**
+```bash
+candy web create -d example.com
+candy web create --domain example.com
+```
+
+#### `candy web delete`
+Delete a website configuration.
+
+**Interactive:**
+```bash
+candy web delete
+```
+
+**Single-line:**
+```bash
+candy web delete -d example.com
+candy web delete --domain example.com
+```
+
+#### `candy web list`
+List all configured websites.
+
+```bash
+candy web list
+```
+
+### Subdomain Management
+
+#### `candy subdomain create`
+Create a new subdomain.
+
+**Interactive:**
+```bash
+candy subdomain create
+```
+
+**Single-line:**
+```bash
+candy subdomain create -s blog.example.com
+candy subdomain create --subdomain blog.example.com
+```
+
+#### `candy subdomain delete`
+Delete a subdomain.
+
+**Interactive:**
+```bash
+candy subdomain delete
+```
+
+**Single-line:**
+```bash
+candy subdomain delete -s blog.example.com
+candy subdomain delete --subdomain blog.example.com
+```
+
+#### `candy subdomain list`
+List all subdomains for a domain.
+
+**Interactive:**
+```bash
+candy subdomain list
+```
+
+**Single-line:**
+```bash
+candy subdomain list -d example.com
+candy subdomain list --domain example.com
+```
+
+### SSL Certificate Management
+
+#### `candy ssl renew`
+Renew SSL certificate for a domain.
+
+**Interactive:**
+```bash
+candy ssl renew
+```
+
+**Single-line:**
+```bash
+candy ssl renew -d example.com
+candy ssl renew --domain example.com
+```
+
+### Mail Account Management
+
+#### `candy mail create`
+Create a new email account.
+
+**Interactive:**
+```bash
+candy mail create
+```
+
+**Single-line:**
+```bash
+candy mail create -e user@example.com -p password123
+candy mail create --email user@example.com --password password123
+```
+
+#### `candy mail delete`
+Delete an email account.
+
+**Interactive:**
+```bash
+candy mail delete
+```
+
+**Single-line:**
+```bash
+candy mail delete -e user@example.com
+candy mail delete --email user@example.com
+```
+
+#### `candy mail list`
+List all email accounts for a domain.
+
+**Interactive:**
+```bash
+candy mail list
+```
+
+**Single-line:**
+```bash
+candy mail list -d example.com
+candy mail list --domain example.com
+```
+
+#### `candy mail password`
+Change password for an email account.
+
+**Interactive:**
+```bash
+candy mail password
+```
+
+**Single-line:**
+```bash
+candy mail password -e user@example.com -p newpassword
+candy mail password --email user@example.com --password newpassword
+```
+
+### Usage Tips
+
+#### Automation and Scripting
+Single-line commands with prefixes are perfect for automation:
+
+```bash
+#!/bin/bash
+# Create multiple email accounts
+candy mail create -e admin@example.com -p admin123
+candy mail create -e support@example.com -p support123
+candy mail create -e sales@example.com -p sales123
+
+# Set up subdomains
+candy subdomain create -s blog.example.com
+candy subdomain create -s shop.example.com
+candy subdomain create -s api.example.com
+```
+
+#### Mixed Usage
+You can mix interactive and single-line modes as needed:
+
+```bash
+# Specify domain, but let the system prompt for other details
+candy web create -d example.com
+```
+
+#### Password Security
+When using password prefixes (`-p`, `--password`):
+- Interactive mode requires password confirmation
+- Single-line mode skips confirmation for automation
+- Consider using environment variables for sensitive data in scripts
+
+```bash
+# Using environment variable
+candy mail create -e user@example.com -p "$MAIL_PASSWORD"
+```
+
+### Error Handling
+
+If a command fails or you provide invalid arguments, CandyPack will display helpful error messages and suggest corrections. Use `candy help [command]` to get specific help for any command.

package/docs/server/02-get-started/04-cli-quick-reference.md

@@ -0,0 +1,102 @@
+## ⚡ CLI Quick Reference
+
+A compact reference for all CandyPack CLI commands with their prefix arguments.
+
+### Basic Commands
+```bash
+candy                    # Show server status
+candy restart            # Restart server
+candy monit              # Monitor services
+candy debug              # View live logs
+candy help               # Show help
+```
+
+### Authentication
+```bash
+candy auth [-k|--key] <key>
+```
+
+### Services
+```bash
+candy run <file>                           # Start new service
+candy service delete [-i|--id] <service>  # Delete service
+```
+
+### Websites
+```bash
+candy web create [-d|--domain] <domain>   # Create website
+candy web delete [-d|--domain] <domain>   # Delete website
+candy web list                             # List websites
+```
+
+### Subdomains
+```bash
+candy subdomain create [-s|--subdomain] <subdomain>  # Create subdomain
+candy subdomain delete [-s|--subdomain] <subdomain>  # Delete subdomain
+candy subdomain list [-d|--domain] <domain>          # List subdomains
+```
+
+### SSL Certificates
+```bash
+candy ssl renew [-d|--domain] <domain>    # Renew SSL certificate
+```
+
+### Mail Accounts
+```bash
+candy mail create [-e|--email] <email> [-p|--password] <password>  # Create account
+candy mail delete [-e|--email] <email>                             # Delete account
+candy mail list [-d|--domain] <domain>                             # List accounts
+candy mail password [-e|--email] <email> [-p|--password] <password> # Change password
+```
+
+### Common Prefixes
+| Prefix | Long Form | Description |
+|--------|-----------|-------------|
+| `-d` | `--domain` | Domain name |
+| `-e` | `--email` | Email address |
+| `-p` | `--password` | Password |
+| `-s` | `--subdomain` | Subdomain name |
+| `-i` | `--id` | Service ID/name |
+| `-k` | `--key` | Authentication key |
+
+### Usage Patterns
+
+**Interactive Mode:**
+```bash
+candy web create
+# Prompts for domain name
+```
+
+**Single-Line Mode:**
+```bash
+candy web create -d example.com
+# No prompts, immediate execution
+```
+
+**Mixed Mode:**
+```bash
+candy mail create -e user@example.com
+# Prompts only for password
+```
+
+### Automation Examples
+```bash
+# Batch create email accounts
+candy mail create -e admin@example.com -p admin123
+candy mail create -e support@example.com -p support456
+
+# Set up multiple subdomains
+candy subdomain create -s blog.example.com
+candy subdomain create -s api.example.com
+candy subdomain create -s shop.example.com
+
+# Renew multiple SSL certificates
+candy ssl renew -d example.com
+candy ssl renew -d api.example.com
+```
+
+### Tips
+- Use single-line mode for scripts and automation
+- Use interactive mode for one-off operations
+- Combine both modes as needed
+- All commands support `--help` for detailed information

package/docs/server/03-service/01-start-a-new-service.md

@@ -0,0 +1,57 @@
+## ⚙️ Start a New Service
+
+To start a new service, use the `run` command followed by the path to your application's entry file.
+
+### Usage
+```bash
+candy run <file>
+```
+
+### Arguments
+- `<file>`: The path to the script or application entry point you want to run. This can be an absolute path or a relative path from your current directory.
+
+### Examples
+
+**Absolute path:**
+```bash
+candy run /path/to/your/app/index.js
+```
+
+**Relative path from current directory:**
+```bash
+candy run index.js
+candy run ./src/server.js
+candy run ../other-project/app.js
+```
+
+**Multiple services:**
+```bash
+# Start multiple services in sequence
+candy run ./api/index.js
+candy run ./worker/processor.js
+candy run ./scheduler/cron.js
+```
+
+### Path Resolution
+- **Absolute paths**: Start with `/` (Linux/macOS) or drive letter (Windows)
+- **Relative paths**: Resolved from your current working directory
+- **Automatic conversion**: Relative paths are automatically converted to absolute paths internally
+
+### Service Management
+Once started, CandyPack will:
+- Monitor the service continuously
+- Automatically restart it if it crashes
+- Assign it a unique service ID for management
+- Log all output for debugging
+
+You can view service status using:
+```bash
+candy monit    # Real-time monitoring
+candy          # Quick status overview
+```
+
+### Service Deletion
+To remove a running service, use:
+```bash
+candy service delete -i <service-name-or-id>
+```

package/docs/server/03-service/02-delete-a-service.md

@@ -0,0 +1,48 @@
+## 🗑️ Delete a Service
+
+This command removes a running service from CandyPack's monitoring and stops its execution.
+
+### Interactive Usage
+```bash
+candy service delete
+```
+You will be prompted to enter the service ID or name that you want to delete.
+
+### Single-Line Usage with Prefixes
+```bash
+# Specify service ID or name directly
+candy service delete -i my-service
+candy service delete -i /path/to/app/index.js
+
+# Or use long form prefix
+candy service delete --id my-service
+```
+
+### Available Prefixes
+- `-i`, `--id`: Service ID or name to delete
+
+### Finding Service Information
+To find the service ID or name, use:
+```bash
+candy monit    # Interactive monitoring view
+candy          # Quick status with service count
+```
+
+### Interactive Example
+```bash
+$ candy service delete
+> Enter the Service ID or Name: my-api-service
+✓ Service 'my-api-service' deleted successfully
+```
+
+### Single-Line Example
+```bash
+$ candy service delete -i my-api-service
+✓ Service 'my-api-service' deleted successfully
+```
+
+### Important Notes
+- Deleting a service stops its execution immediately
+- The service will no longer be monitored or automatically restarted
+- This does not delete the source code files, only removes the service from CandyPack
+- You can restart the same service later using `candy run <file>`

package/docs/server/04-web/01-create-a-website.md

@@ -0,0 +1,36 @@
+## 🌐 Create a Website
+This command helps you set up a new website on your server. CandyPack will ask for the domain name and the path to the website's files.
+
+### Interactive Usage
+```bash
+candy web create
+```
+After running the command, you will be prompted to enter the following information:
+- **Domain Name:** The primary domain for your website (e.g., `example.com`).
+- **Path:** The absolute path to your website's root directory (e.g., `/var/www/example.com`). If you leave this blank, CandyPack will suggest a default path based on the domain name.
+
+### Single-Line Usage with Prefixes
+```bash
+# Specify domain directly
+candy web create -d example.com
+
+# Or use long form prefix
+candy web create --domain example.com
+```
+
+### Available Prefixes
+- `-d`, `--domain`: Domain name for the new website
+
+### Interactive Example
+```bash
+$ candy web create
+> Enter the domain name: example.com
+> Enter the path to the website (/home/user/example.com/):
+```
+
+### Single-Line Example
+```bash
+$ candy web create -d example.com
+✓ Website created successfully for example.com
+```
+

package/docs/server/04-web/02-list-websites.md

@@ -0,0 +1,9 @@
+## 📋 List Websites
+To see a list of all websites currently configured on your server, use the `list` command.
+
+### Usage
+```bash
+candy web list
+```
+
+This command will output a table of your websites, showing their status and other relevant details. You can also monitor your websites in real-time with the `candy monit` command.

package/docs/server/04-web/03-delete-a-website.md

@@ -0,0 +1,29 @@
+## 🗑️ Delete a Website
+
+You can delete a website using the `web delete` command. This command will prompt you for the domain name of the website you want to delete.
+
+### Interactive Usage
+```bash
+candy web delete
+```
+
+The command will then ask for the domain name:
+```
+Enter the domain name: my-website.com
+```
+
+### Single-Line Usage with Prefixes
+```bash
+# Specify domain directly
+candy web delete -d my-website.com
+
+# Or use long form prefix
+candy web delete --domain my-website.com
+```
+
+### Available Prefixes
+- `-d`, `--domain`: Domain name of the website to delete
+
+### Important Note
+
+This command only removes the server configuration for the website. It **does not** delete the website's source code directory. If you want to remove the source code as well, you must delete the directory manually.

package/docs/server/05-subdomain/01-create-a-subdomain.md

@@ -0,0 +1,32 @@
+## 🔗 Create a Subdomain
+This command allows you to create a new subdomain. CandyPack will automatically configure it to point to a directory with the same name inside your main domain's root directory.
+
+### Interactive Usage
+```bash
+candy subdomain create
+```
+After running the command, you will be prompted to enter the new subdomain name, including the main domain (e.g., `blog.example.com`).
+
+### Single-Line Usage with Prefixes
+```bash
+# Specify subdomain directly
+candy subdomain create -s blog.example.com
+
+# Or use long form prefix
+candy subdomain create --subdomain blog.example.com
+```
+
+### Available Prefixes
+- `-s`, `--subdomain`: Full subdomain name (e.g., blog.example.com)
+
+### Interactive Example
+```bash
+$ candy subdomain create
+> Enter the subdomain name (subdomain.example.com): blog.example.com
+```
+
+### Single-Line Example
+```bash
+$ candy subdomain create -s blog.example.com
+✓ Subdomain blog.example.com created successfully
+```

package/docs/server/05-subdomain/02-list-subdomains.md

@@ -0,0 +1,33 @@
+## 📋 List Subdomains
+To see a list of all subdomains configured for a specific domain, use the `list` command.
+
+### Interactive Usage
+```bash
+candy subdomain list
+```
+This command will prompt you to enter the main domain name for which you want to list the subdomains.
+
+### Single-Line Usage with Prefixes
+```bash
+# Specify domain directly
+candy subdomain list -d example.com
+
+# Or use long form prefix
+candy subdomain list --domain example.com
+```
+
+### Available Prefixes
+- `-d`, `--domain`: Domain name to list subdomains for
+
+### Interactive Example
+```bash
+$ candy subdomain list
+> Enter the domain name: example.com
+```
+
+### Single-Line Example
+```bash
+$ candy subdomain list -d example.com
+```
+
+This will display a list of all subdomains associated with `example.com`.

package/docs/server/05-subdomain/03-delete-a-subdomain.md

@@ -0,0 +1,41 @@
+## 🗑️ Delete a Subdomain
+
+This command removes a subdomain configuration from your server.
+
+### Interactive Usage
+```bash
+candy subdomain delete
+```
+You will be prompted to enter the full subdomain name (including the main domain) that you want to delete.
+
+### Single-Line Usage with Prefixes
+```bash
+# Specify subdomain directly
+candy subdomain delete -s blog.example.com
+
+# Or use long form prefix
+candy subdomain delete --subdomain blog.example.com
+```
+
+### Available Prefixes
+- `-s`, `--subdomain`: Full subdomain name to delete (e.g., blog.example.com)
+
+### Interactive Example
+```bash
+$ candy subdomain delete
+> Enter the subdomain name (subdomain.example.com): blog.example.com
+✓ Subdomain 'blog.example.com' deleted successfully
+```
+
+### Single-Line Example
+```bash
+$ candy subdomain delete -s blog.example.com
+✓ Subdomain 'blog.example.com' deleted successfully
+```
+
+### Important Notes
+- This command only removes the server configuration for the subdomain
+- It **does not** delete the subdomain's directory or files
+- If you want to remove the files as well, you must delete the directory manually
+- The subdomain will no longer be accessible after deletion
+- SSL certificates associated with the subdomain may need to be renewed for the main domain

package/docs/server/06-ssl/01-renew-an-ssl-certificate.md

@@ -0,0 +1,34 @@
+## 🔒 Renew an SSL Certificate
+This command attempts to renew the SSL certificate for a given domain. This can be useful if a certificate is close to expiring and you want to force an early renewal.
+
+### Interactive Usage
+```bash
+candy ssl renew
+```
+After running the command, you will be prompted to enter the domain name for which you want to renew the SSL certificate.
+
+### Single-Line Usage with Prefixes
+```bash
+# Specify domain directly
+candy ssl renew -d example.com
+
+# Or use long form prefix
+candy ssl renew --domain example.com
+```
+
+### Available Prefixes
+- `-d`, `--domain`: Domain name to renew SSL certificate for
+
+### Interactive Example
+```bash
+$ candy ssl renew
+> Enter the domain name: example.com
+```
+
+### Single-Line Example
+```bash
+$ candy ssl renew -d example.com
+✓ SSL certificate renewal initiated for example.com
+```
+
+CandyPack will then handle the process of validating your domain and renewing the certificate.