odac 0.9.0

package/docs/index.json

@@ -0,0 +1,452 @@
+{
+  "server": [
+    {
+      "file": "01-installation",
+      "title": "Installation",
+      "children": [
+        {
+          "file": "01-quick-install.md",
+          "title": "Quick Install"
+        },
+        {
+          "file": "02-manual-installation-via-npm.md",
+          "title": "Manual Installation (via NPM)"
+        }
+      ]
+    },
+    {
+      "file": "02-get-started",
+      "title": "Getting Started",
+      "children": [
+        {
+          "file": "01-core-concepts.md",
+          "title": "Core Concepts"
+        },
+        {
+          "file": "02-basic-commands.md",
+          "title": "Basic Commands"
+        },
+        {
+          "file": "03-cli-reference.md",
+          "title": "CLI Reference"
+        },
+        {
+          "file": "04-cli-quick-reference.md",
+          "title": "CLI Quick Reference"
+        }
+      ]
+    },
+    {
+      "file": "03-service",
+      "title": "Running a Service",
+      "children": [
+        {
+          "file": "01-start-a-new-service.md",
+          "title": "Start a New Service"
+        },
+        {
+          "file": "02-delete-a-service.md",
+          "title": "Delete a Service"
+        }
+      ]
+    },
+    {
+      "file": "04-web",
+      "title": "Managing Websites",
+      "children": [
+        {
+          "file": "01-create-a-website.md",
+          "title": "Create a Website"
+        },
+        {
+          "file": "02-list-websites.md",
+          "title": "List Websites"
+        },
+        {
+          "file": "03-delete-a-website.md",
+          "title": "Delete a Website"
+        }
+      ]
+    },
+    {
+      "file": "05-subdomain",
+      "title": "Managing Subdomains",
+      "children": [
+        {
+          "file": "01-create-a-subdomain.md",
+          "title": "Create a Subdomain"
+        },
+        {
+          "file": "02-list-subdomains.md",
+          "title": "List Subdomains"
+        },
+        {
+          "file": "03-delete-a-subdomain.md",
+          "title": "Delete a Subdomain"
+        }
+      ]
+    },
+    {
+      "file": "06-ssl",
+      "title": "Managing SSL",
+      "children": [
+        {
+          "file": "01-renew-an-ssl-certificate.md",
+          "title": "Renew an SSL Certificate"
+        }
+      ]
+    },
+    {
+      "file": "07-mail",
+      "title": "Managing Mail",
+      "children": [
+        {
+          "file": "01-create-a-mail-account.md",
+          "title": "Create a Mail Account"
+        },
+        {
+          "file": "02-delete-a-mail-account.md",
+          "title": "Delete a Mail Account"
+        },
+        {
+          "file": "03-list-mail-accounts.md",
+          "title": "List Mail Accounts"
+        },
+        {
+          "file": "04-change-account-password.md",
+          "title": "Change Account Password"
+        }
+      ]
+    }
+  ],
+  "backend": [
+    {
+      "file": "01-overview",
+      "title": "Backend Overview",
+      "children": [
+        {
+          "file": "01-whats-in-the-candy-box.md",
+          "title": "Candy Object"
+        },
+        {
+          "file": "02-super-handy-helper-functions.md",
+          "title": "Helper Functions"
+        },
+        {
+          "file": "03-development-server.md",
+          "title": "Development Server"
+        }
+      ]
+    },
+    {
+      "file": "02-structure",
+      "title": "Project Structure",
+      "children": [
+        {
+          "file": "01-typical-project-layout.md",
+          "title": "Project Layout"
+        }
+      ]
+    },
+    {
+      "file": "03-config",
+      "title": "Configuration",
+      "children": [
+        {
+          "file": "00-configuration-overview.md",
+          "title": "Configuration Overview"
+        },
+        {
+          "file": "01-database-connection.md",
+          "title": "Database Connection"
+        },
+        {
+          "file": "02-static-route-mapping-optional.md",
+          "title": "Static Route Mapping"
+        },
+        {
+          "file": "03-request-timeout.md",
+          "title": "Request Timeout"
+        },
+        {
+          "file": "04-environment-variables.md",
+          "title": "Environment Variables"
+        },
+        {
+          "file": "05-early-hints.md",
+          "title": "Early Hints"
+        }
+      ]
+    },
+    {
+      "file": "04-routing",
+      "title": "Routing",
+      "children": [
+        {
+          "file": "01-basic-page-routes.md",
+          "title": "Basic Routes"
+        },
+        {
+          "file": "02-controller-less-view-routes.md",
+          "title": "View Routes"
+        },
+        {
+          "file": "03-api-and-data-routes.md",
+          "title": "API Routes"
+        },
+        {
+          "file": "04-authentication-aware-routes.md",
+          "title": "Protected Routes"
+        },
+        {
+          "file": "05-advanced-routing.md",
+          "title": "Advanced Routing"
+        },
+        {
+          "file": "06-error-pages.md",
+          "title": "Error Pages"
+        },
+        {
+          "file": "07-cron-jobs.md",
+          "title": "Cron Jobs"
+        }
+      ]
+    },
+    {
+      "file": "05-controllers",
+      "title": "Controllers",
+      "children": [
+        {
+          "file": "01-how-to-build-a-controller.md",
+          "title": "Building Controllers"
+        },
+        {
+          "file": "02-your-trusty-candy-assistant.md",
+          "title": "Using Candy"
+        },
+        {
+          "file": "03-controller-classes.md",
+          "title": "Controller Classes"
+        }
+      ]
+    },
+    {
+      "file": "05-forms",
+      "title": "Forms",
+      "children": [
+        {
+          "file": "01-custom-forms.md",
+          "title": "Custom Forms"
+        },
+        {
+          "file": "02-automatic-database-insert.md",
+          "title": "Automatic Database Insert"
+        }
+      ]
+    },
+    {
+      "file": "06-request-and-response",
+      "title": "Request & Response",
+      "children": [
+        {
+          "file": "01-the-request-object-what-is-the-user-asking-for.md",
+          "title": "Request Object"
+        },
+        {
+          "file": "02-sending-a-response-replying-to-the-user.md",
+          "title": "Response Object"
+        }
+      ]
+    },
+    {
+      "file": "07-views",
+      "title": "Views",
+      "children": [
+        {
+          "file": "01-the-view-directory.md",
+          "title": "View System Overview"
+        },
+        {
+          "file": "02-rendering-a-view.md",
+          "title": "Rendering Views"
+        },
+        {
+          "file": "03-template-syntax.md",
+          "title": "Template Syntax Overview"
+        },
+        {
+          "file": "03-variables.md",
+          "title": "Variables"
+        },
+        {
+          "file": "04-request-data.md",
+          "title": "Request Data"
+        },
+        {
+          "file": "05-conditionals.md",
+          "title": "Conditionals"
+        },
+        {
+          "file": "06-loops.md",
+          "title": "Loops"
+        },
+        {
+          "file": "07-translations.md",
+          "title": "Translations (i18n)"
+        },
+        {
+          "file": "08-backend-javascript.md",
+          "title": "Backend JavaScript"
+        },
+        {
+          "file": "09-comments.md",
+          "title": "Comments"
+        }
+      ]
+    },
+    {
+      "file": "08-database",
+      "title": "Database",
+      "children": [
+        {
+          "file": "01-database-connection.md",
+          "title": "Database Connection"
+        },
+        {
+          "file": "02-using-mysql.md",
+          "title": "Using MySQL"
+        }
+      ]
+    },
+    {
+      "file": "09-validation",
+      "title": "Validation",
+      "children": [
+        {
+          "file": "01-the-validator-service.md",
+          "title": "Validator Service"
+        }
+      ]
+    },
+    {
+      "file": "10-authentication",
+      "title": "Authentication & Security",
+      "children": [
+        {
+          "file": "01-user-logins-with-authjs.md",
+          "title": "User Authentication"
+        },
+        {
+          "file": "02-foiling-villains-with-csrf-protection.md",
+          "title": "CSRF Protection"
+        },
+        {
+          "file": "03-register.md",
+          "title": "User Registration (Programmatic)"
+        },
+        {
+          "file": "04-candy-register-forms.md",
+          "title": "Candy Register Forms (Zero-Config)"
+        },
+        {
+          "file": "05-session-management.md",
+          "title": "Session Management"
+        },
+        {
+          "file": "06-candy-login-forms.md",
+          "title": "Candy Login Forms (Zero-Config)"
+        }
+      ]
+    },
+    {
+      "file": "11-mail",
+      "title": "Email",
+      "children": [
+        {
+          "file": "01-the-mail-service.md",
+          "title": "Mail Service"
+        }
+      ]
+    },
+    {
+      "file": "12-streaming",
+      "title": "Streaming",
+      "children": [
+        {
+          "file": "01-streaming-overview.md",
+          "title": "Streaming API"
+        }
+      ]
+    },
+    {
+      "file": "13-utilities",
+      "title": "Utilities",
+      "children": [
+        {
+          "file": "01-candy-var.md",
+          "title": "Candy.Var"
+        }
+      ]
+    }
+  ],
+  "frontend": [
+    {
+      "file": "01-overview",
+      "title": "candy.js Overview",
+      "children": [
+        {
+          "file": "01-introduction.md",
+          "title": "Introduction"
+        }
+      ]
+    },
+    {
+      "file": "02-ajax-navigation",
+      "title": "AJAX Navigation",
+      "children": [
+        {
+          "file": "01-quick-start.md",
+          "title": "Quick Start"
+        },
+        {
+          "file": "02-configuration.md",
+          "title": "Configuration"
+        },
+        {
+          "file": "03-advanced-usage.md",
+          "title": "Advanced Usage"
+        }
+      ]
+    },
+    {
+      "file": "03-forms",
+      "title": "Form Handling",
+      "children": [
+        {
+          "file": "01-form-handling.md",
+          "title": "Form Handling"
+        }
+      ]
+    },
+    {
+      "file": "04-api-requests",
+      "title": "API Requests",
+      "children": [
+        {
+          "file": "01-get-post.md",
+          "title": "GET & POST Requests"
+        }
+      ]
+    },
+    {
+      "file": "05-streaming",
+      "title": "Streaming",
+      "children": [
+        {
+          "file": "01-client-streaming.md",
+          "title": "Client-Side Streaming"
+        }
+      ]
+    }
+  ]
+}

package/docs/server/01-installation/01-quick-install.md

@@ -0,0 +1,19 @@
+## ⚡ Quick Install
+
+This is the recommended method for most users.
+
+### Linux & macOS
+
+Run the following command in your terminal:
+
+```bash
+curl -sL https://candypack.dev/install | bash
+```
+
+### Windows
+
+Open PowerShell as an administrator and run the following command:
+
+```powershell
+iex (iwr -useb 'https://candypack.dev/install')
+```

package/docs/server/01-installation/02-manual-installation-via-npm.md

@@ -0,0 +1,9 @@
+## 📦 Manual Installation (via NPM)
+
+If you prefer to install manually or have issues with the quick install script, you can install CandyPack directly from NPM.
+
+1.  **Install Node.js:** Ensure you have Node.js (v18+) installed on your system. You can download it from [nodejs.org](https://nodejs.org/).
+2.  **Install CandyPack:** Use npm to install CandyPack globally:
+    ```bash
+    npm install -g candypack
+    ```

package/docs/server/02-get-started/01-core-concepts.md

@@ -0,0 +1,7 @@
+## 🧠 Core Concepts
+
+CandyPack is designed to be a powerful, developer-first toolkit that runs as a persistent background service on your server. Here’s how it works:
+
+- **Background Service:** Once started, CandyPack runs continuously in the background, managing all your configured websites and services. You don't need to manually keep it active.
+- **CLI Control:** You interact with and control the CandyPack server through the `candy` command-line tool. This tool allows you to start, stop, monitor, and manage your applications.
+- **Automation:** The primary goal of CandyPack is to automate common server management tasks, such as SSL certificate renewal, service monitoring, and application deployment, allowing you to focus on development.

package/docs/server/02-get-started/02-basic-commands.md

@@ -0,0 +1,57 @@
+## 💻 Basic Commands
+
+These are the most common commands for interacting with the CandyPack server.
+
+### Check Status
+To see the current status of the CandyPack server, including uptime and the number of running services, simply run the `candy` command with no arguments:
+```bash
+candy
+```
+
+### Restart the Server
+If you need to apply new configurations or restart all services, you can use the `restart` command:
+```bash
+candy restart
+```
+
+### Monitor Services
+To get a real-time, interactive view of your running websites and services, use the `monit` command:
+```bash
+candy monit
+```
+
+### View Live Logs
+For debugging purposes, you can view a live stream of all server and application logs with the `debug` command:
+```bash
+candy debug
+```
+
+### Get Help
+To see a list of all available commands, use the `help` command:
+```bash
+candy help
+```
+
+### Using Prefix Arguments
+Many CandyPack commands support prefix arguments that allow you to provide values directly in the command line, avoiding interactive prompts. This is especially useful for automation and scripting.
+
+**Common Prefixes:**
+- `-d`, `--domain`: Specify domain name
+- `-e`, `--email`: Specify email address  
+- `-p`, `--password`: Specify password
+- `-s`, `--subdomain`: Specify subdomain
+- `-i`, `--id`: Specify service ID
+- `-k`, `--key`: Specify authentication key
+
+**Example:**
+```bash
+# Interactive mode (prompts for input)
+candy web create
+
+# Single-line mode with prefix
+candy web create -d example.com
+```
+
+---
+
+**Next Steps:** For more advanced topics, such as managing websites, services, SSL certificates, and mail accounts, please refer to the upcoming documentation files.