odac 0.9.0 → 1.0.0

package/docs/backend/07-views/09-comments.md

@@ -1,6 +1,6 @@
 ## 💬 Comments in Views
 
-CandyPack supports two types of comments in view files: backend comments (not rendered) and regular HTML comments (rendered).
+Odac supports two types of comments in view files: backend comments (not rendered) and regular HTML comments (rendered).
 
 ### Backend Comments (Not Rendered)
 
@@ -9,18 +9,18 @@ Backend comments are removed during template rendering and never appear in the H
 #### Single-Line Backend Comments
 
 ```html
-<!--candy This is a backend comment -->
+<!--odac This is a backend comment -->
 <p>This will be rendered</p>
 ```
 
 #### Multi-Line Backend Comments
 
 ```html
-<!--candy
+<!--odac
   This is a multi-line backend comment
   It can span multiple lines
   None of this will appear in the output
-candy-->
+odac-->
 
 <div class="content">
   <p>This will be rendered</p>
@@ -43,50 +43,50 @@ Standard HTML comments are preserved and sent to the browser:
 
 **Development Notes:**
 ```html
-<!--candy TODO: Add pagination here -->
-<!--candy FIXME: This needs optimization -->
-<!--candy NOTE: This section is for admin users only -->
+<!--odac TODO: Add pagination here -->
+<!--odac FIXME: This needs optimization -->
+<!--odac NOTE: This section is for admin users only -->
 ```
 
 **Sensitive Information:**
 ```html
-<!--candy 
+<!--odac 
   Database query returns: id, name, email, password_hash
   We only display: name, email
-candy-->
+odac-->
 
-<candy:for in="users" value="user">
-  <p><candy var="user.name" /> - <candy var="user.email" /></p>
-</candy:for>
+<odac:for in="users" value="user">
+  <p><odac var="user.name" /> - <odac var="user.email" /></p>
+</odac:for>
 ```
 
 **Debugging Information:**
 ```html
-<!--candy Debug: user object structure -->
-<!--candy { id: 1, name: "John", role: "admin" } -->
+<!--odac Debug: user object structure -->
+<!--odac { id: 1, name: "John", role: "admin" } -->
 
-<candy:if condition="user.role === 'admin'">
+<odac:if condition="user.role === 'admin'">
   <div class="admin-panel">Admin content</div>
-</candy:if>
+</odac:if>
 ```
 
 **Temporary Code:**
 ```html
-<!--candy
+<!--odac
   Old implementation - keeping for reference
   <div class="old-layout">
-    <candy:for in="items" value="item">
-      <p><candy var="item.name" /></p>
-    </candy:for>
+    <odac:for in="items" value="item">
+      <p><odac var="item.name" /></p>
+    </odac:for>
   </div>
-candy-->
+odac-->
 
 <div class="new-layout">
-  <candy:for in="items" value="item">
+  <odac:for in="items" value="item">
     <div class="item-card">
-      <h3><candy var="item.name" /></h3>
+      <h3><odac var="item.name" /></h3>
     </div>
-  </candy:for>
+  </odac:for>
 </div>
 ```
 
@@ -135,18 +135,18 @@ candy-->
 #### Documenting Complex Logic
 
 ```html
-<!--candy
+<!--odac
   This section displays products based on user role:
   - Admin: sees all products including inactive
   - Regular user: sees only active products
   - Guest: sees only featured products
-candy-->
+odac-->
 
-<script:candy>
+<script:odac>
   let visibleProducts;
   
-  if (Candy.Auth.check()) {
-    const user = Candy.Auth.user();
+  if (Odac.Auth.check()) {
+    const user = Odac.Auth.user();
     if (user.role === 'admin') {
       visibleProducts = products;
     } else {
@@ -155,52 +155,52 @@ candy-->
   } else {
     visibleProducts = products.filter(p => p.featured);
   }
-</script:candy>
+</script:odac>
 
-<candy:for in="visibleProducts" value="product">
+<odac:for in="visibleProducts" value="product">
   <div class="product">
-    <h3><candy var="product.name" /></h3>
+    <h3><odac var="product.name" /></h3>
   </div>
-</candy:for>
+</odac:for>
 ```
 
 #### Marking Sections for Developers
 
 ```html
 <div class="dashboard">
-  <!--candy START: User Statistics Section -->
+  <!--odac START: User Statistics Section -->
   <div class="stats">
     <h2>Statistics</h2>
-    <p>Total Users: <candy var="stats.totalUsers" /></p>
-    <p>Active Users: <candy var="stats.activeUsers" /></p>
+    <p>Total Users: <odac var="stats.totalUsers" /></p>
+    <p>Active Users: <odac var="stats.activeUsers" /></p>
   </div>
-  <!--candy END: User Statistics Section -->
+  <!--odac END: User Statistics Section -->
   
-  <!--candy START: Recent Activity Section -->
+  <!--odac START: Recent Activity Section -->
   <div class="activity">
     <h2>Recent Activity</h2>
-    <candy:for in="activities" value="activity">
-      <p><candy var="activity.description" /></p>
-    </candy:for>
+    <odac:for in="activities" value="activity">
+      <p><odac var="activity.description" /></p>
+    </odac:for>
   </div>
-  <!--candy END: Recent Activity Section -->
+  <!--odac END: Recent Activity Section -->
 </div>
 ```
 
 #### Explaining Template Variables
 
 ```html
-<!--candy
+<!--odac
   Available variables from controller:
   - user: Current user object { id, name, email, role }
   - posts: Array of post objects
   - categories: Array of category objects
   - settings: Site settings object
-candy-->
+odac-->
 
 <div class="profile">
-  <h1><candy var="user.name" /></h1>
-  <p><candy var="user.email" /></p>
+  <h1><odac var="user.name" /></h1>
+  <p><odac var="user.email" /></p>
 </div>
 ```
 
@@ -208,31 +208,31 @@ candy-->
 
 ```html
 <div class="products">
-  <candy:for in="products" value="product">
+  <odac:for in="products" value="product">
     <div class="product-card">
-      <h3><candy var="product.name" /></h3>
-      <p>$<candy var="product.price" /></p>
+      <h3><odac var="product.name" /></h3>
+      <p>$<odac var="product.price" /></p>
       
-      <!--candy Temporarily disabled - waiting for API
+      <!--odac Temporarily disabled - waiting for API
       <div class="reviews">
-        <candy var="product.averageRating" /> stars
+        <odac var="product.averageRating" /> stars
       </div>
-      candy-->
+      odac-->
     </div>
-  </candy:for>
+  </odac:for>
 </div>
 ```
 
 #### Version History
 
 ```html
-<!--candy
+<!--odac
   Version History:
   v1.0 - Initial implementation
   v1.1 - Added sorting functionality
   v1.2 - Added filtering by category
   v2.0 - Complete redesign with new layout
-candy-->
+odac-->
 
 <div class="product-list">
   <!-- Product list implementation -->
@@ -249,19 +249,19 @@ candy-->
 
 **Good:**
 ```html
-<!--candy This query is cached for 5 minutes -->
-<candy:for in="products" value="product">
-  <div><candy var="product.name" /></div>
-</candy:for>
+<!--odac This query is cached for 5 minutes -->
+<odac:for in="products" value="product">
+  <div><odac var="product.name" /></div>
+</odac:for>
 ```
 
 **Avoid:**
 ```html
-<!--candy Loop through products -->
-<candy:for in="products" value="product">
-  <!--candy Display product name -->
-  <div><candy var="product.name" /></div>
-</candy:for>
+<!--odac Loop through products -->
+<odac:for in="products" value="product">
+  <!--odac Display product name -->
+  <div><odac var="product.name" /></div>
+</odac:for>
 ```
 
 ### Security Considerations
@@ -273,9 +273,9 @@ candy-->
 <!-- Database password: secret123 -->
 <!-- API key: abc123xyz -->
 
-<!--candy GOOD: Not visible in output -->
-<!--candy Database password: secret123 -->
-<!--candy API key: abc123xyz -->
+<!--odac GOOD: Not visible in output -->
+<!--odac Database password: secret123 -->
+<!--odac API key: abc123xyz -->
 ```
 
 **Be careful with user data:**
@@ -284,14 +284,14 @@ candy-->
 <!-- BAD: Exposes user data -->
 <!-- User ID: 12345, Email: user@example.com -->
 
-<!--candy GOOD: Hidden from output -->
-<!--candy User ID: 12345, Email: user@example.com -->
+<!--odac GOOD: Hidden from output -->
+<!--odac User ID: 12345, Email: user@example.com -->
 ```
 
 ### Comment Syntax Summary
 
 | Type | Syntax | Rendered | Use Case |
 |------|--------|----------|----------|
-| Backend Single-Line | `<!--candy comment -->` | No | Development notes, TODOs |
-| Backend Multi-Line | `<!--candy ... candy-->` | No | Detailed explanations, disabled code |
+| Backend Single-Line | `<!--odac comment -->` | No | Development notes, TODOs |
+| Backend Multi-Line | `<!--odac ... odac-->` | No | Detailed explanations, disabled code |
 | HTML Comment | `<!-- comment -->` | Yes | Section markers, browser hacks |

package/docs/backend/08-database/01-database-connection.md

@@ -1,6 +1,6 @@
 ## 🔌 Database Connection
 
-CandyPack automatically connects to your MySQL database when you provide the configuration.
+Odac automatically connects to your MySQL database when you provide the configuration.
 
 ### Configuration
 
@@ -44,10 +44,10 @@ Access different databases:
 
 ```javascript
 // Default database
-const users = await Candy.Mysql.table('users').get()
+const users = await Odac.Mysql.table('users').get()
 
 // Specific database
-const stats = await Candy.Mysql.database('analytics').table('stats').get()
+const stats = await Odac.Mysql.database('analytics').table('stats').get()
 ```
 
 ### Environment Variables
@@ -86,14 +86,14 @@ Available configuration options:
 
 ### Automatic Connection
 
-The connection is established automatically when your application starts. You don't need to write any connection code - just use `Candy.Mysql` in your controllers.
+The connection is established automatically when your application starts. You don't need to write any connection code - just use `Odac.Mysql` in your controllers.
 
 ```javascript
-module.exports = async function (Candy) {
+module.exports = async function (Odac) {
   // Connection is already established
-  const users = await Candy.Mysql.table('users').get()
+  const users = await Odac.Mysql.table('users').get()
   
-  Candy.set('users', users)
-  Candy.View.set({ skeleton: 'main', content: 'users' })
+  Odac.set('users', users)
+  Odac.View.set({ skeleton: 'main', content: 'users' })
 }
 ```

package/docs/backend/08-database/02-using-mysql.md

@@ -1,25 +1,25 @@
 ## 🗄️ Using MySQL
 
-CandyPack provides a powerful query builder for safe and easy database operations.
+Odac provides a powerful query builder for safe and easy database operations.
 
 ### Selecting Data
 
 #### Get All Records
 
 ```javascript
-const users = await Candy.Mysql.table('users').get()
+const users = await Odac.Mysql.table('users').get()
 ```
 
 #### Get First Record
 
 ```javascript
-const user = await Candy.Mysql.table('users').where('id', 1).first()
+const user = await Odac.Mysql.table('users').where('id', 1).first()
 ```
 
 #### Select Specific Columns
 
 ```javascript
-const users = await Candy.Mysql.table('users')
+const users = await Odac.Mysql.table('users')
   .select('id', 'name', 'email')
   .get()
 ```
@@ -28,35 +28,35 @@ const users = await Candy.Mysql.table('users')
 
 ```javascript
 // Single condition
-const users = await Candy.Mysql.table('users')
+const users = await Odac.Mysql.table('users')
   .where('status', 'active')
   .get()
 
 // Multiple conditions (AND)
-const users = await Candy.Mysql.table('users')
+const users = await Odac.Mysql.table('users')
   .where('status', 'active')
   .where('verified', 1)
   .get()
 
 // OR condition
-const users = await Candy.Mysql.table('users')
+const users = await Odac.Mysql.table('users')
   .where('role', 'admin')
   .orWhere('role', 'moderator')
   .get()
 
 // Comparison operators
-const products = await Candy.Mysql.table('products')
+const products = await Odac.Mysql.table('products')
   .where('price', '>', 100)
   .where('stock', '<=', 10)
   .get()
 
 // LIKE
-const users = await Candy.Mysql.table('users')
+const users = await Odac.Mysql.table('users')
   .where('name', 'LIKE', '%John%')
   .get()
 
 // IN
-const users = await Candy.Mysql.table('users')
+const users = await Odac.Mysql.table('users')
   .where('role', 'IN', ['admin', 'moderator'])
   .get()
 ```
@@ -67,7 +67,7 @@ For complex queries with nested AND/OR conditions, use arrays:
 
 ```javascript
 // SQL: WHERE (status = 'active' AND verified = 1) OR (role = 'admin')
-const users = await Candy.Mysql.table('users')
+const users = await Odac.Mysql.table('users')
   .where([
     ['status', 'active'],
     ['verified', 1]
@@ -76,7 +76,7 @@ const users = await Candy.Mysql.table('users')
   .get()
 
 // SQL: WHERE status = 'active' AND (role = 'admin' OR role = 'moderator')
-const users = await Candy.Mysql.table('users')
+const users = await Odac.Mysql.table('users')
   .where('status', 'active')
   .where([
     ['role', 'admin'],
@@ -88,7 +88,7 @@ const users = await Candy.Mysql.table('users')
 // Complex nested conditions
 // SQL: WHERE (status = 'active' AND (role = 'admin' OR role = 'moderator')) 
 //      AND (verified = 1 OR email_verified = 1)
-const users = await Candy.Mysql.table('users')
+const users = await Odac.Mysql.table('users')
   .where([
     ['status', 'active'],
     [
@@ -109,19 +109,19 @@ const users = await Candy.Mysql.table('users')
 
 ```javascript
 // Order by
-const users = await Candy.Mysql.table('users')
+const users = await Odac.Mysql.table('users')
   .order('created_at', 'desc')
   .get()
 
 // Limit
-const users = await Candy.Mysql.table('users')
+const users = await Odac.Mysql.table('users')
   .limit(10)
   .get()
 
 // Pagination
 const page = 2
 const perPage = 20
-const users = await Candy.Mysql.table('users')
+const users = await Odac.Mysql.table('users')
   .limit((page - 1) * perPage, perPage)
   .get()
 ```
@@ -129,7 +129,7 @@ const users = await Candy.Mysql.table('users')
 ### Counting Records
 
 ```javascript
-const userCount = await Candy.Mysql.table('users')
+const userCount = await Odac.Mysql.table('users')
   .where('status', 'active')
   .rows()
 ```
@@ -137,7 +137,7 @@ const userCount = await Candy.Mysql.table('users')
 ### Joins
 
 ```javascript
-const orders = await Candy.Mysql.table('orders')
+const orders = await Odac.Mysql.table('orders')
   .leftJoin('users', 'orders.user_id', 'users.id')
   .select('orders.*', 'users.name', 'users.email')
   .get()
@@ -147,7 +147,7 @@ const orders = await Candy.Mysql.table('orders')
 
 ```javascript
 // Insert single record
-const result = await Candy.Mysql.table('users').insert({
+const result = await Odac.Mysql.table('users').insert({
   name: 'John Doe',
   email: 'john@example.com',
   status: 'active'
@@ -160,7 +160,7 @@ console.log(result.affected) // Affected rows
 ### Updating Data
 
 ```javascript
-const result = await Candy.Mysql.table('users')
+const result = await Odac.Mysql.table('users')
   .where('id', 1)
   .set({
     name: 'Jane Doe',
@@ -173,7 +173,7 @@ console.log(result.affected) // Number of updated rows
 ### Deleting Data
 
 ```javascript
-const result = await Candy.Mysql.table('users')
+const result = await Odac.Mysql.table('users')
   .where('id', 1)
   .delete()
 
@@ -186,12 +186,12 @@ For complex queries, use raw SQL:
 
 ```javascript
 // Raw value in select
-const users = await Candy.Mysql.table('users')
-  .select('id', 'name', Candy.Mysql.raw('COUNT(*) as total'))
+const users = await Odac.Mysql.table('users')
+  .select('id', 'name', Odac.Mysql.raw('COUNT(*) as total'))
   .get()
 
 // Raw query with parameters (SAFE - recommended)
-const result = await Candy.Mysql.run('SELECT * FROM users WHERE status = ?', ['active'])
+const result = await Odac.Mysql.run('SELECT * FROM users WHERE status = ?', ['active'])
 ```
 
 #### ⚠️ Security Warning: Mysql.raw()
@@ -200,25 +200,25 @@ const result = await Candy.Mysql.run('SELECT * FROM users WHERE status = ?', ['a
 
 ```javascript
 // ❌ DANGEROUS - Never do this!
-const userInput = await Candy.request('search')
-const users = await Candy.Mysql.table('users')
-  .where('name', Candy.Mysql.raw(userInput))  // SQL INJECTION RISK!
+const userInput = await Odac.request('search')
+const users = await Odac.Mysql.table('users')
+  .where('name', Odac.Mysql.raw(userInput))  // SQL INJECTION RISK!
   .get()
 
 // ✅ SAFE - Use query builder instead
-const userInput = await Candy.request('search')
-const users = await Candy.Mysql.table('users')
+const userInput = await Odac.request('search')
+const users = await Odac.Mysql.table('users')
   .where('name', 'LIKE', `%${userInput}%`)  // Automatically escaped
   .get()
 
 // ✅ SAFE - Use with hardcoded values only
-const users = await Candy.Mysql.table('users')
-  .select('id', 'name', Candy.Mysql.raw('COUNT(*) as total'))  // OK - hardcoded
+const users = await Odac.Mysql.table('users')
+  .select('id', 'name', Odac.Mysql.raw('COUNT(*) as total'))  // OK - hardcoded
   .get()
 
 // ✅ SAFE - Use parameterized queries for dynamic values
-const status = await Candy.request('status')
-const result = await Candy.Mysql.run(
+const status = await Odac.request('status')
+const result = await Odac.Mysql.run(
   'SELECT * FROM users WHERE status = ?',
   [status]  // Automatically escaped
 )
@@ -237,8 +237,8 @@ const result = await Candy.Mysql.run(
 ### Group By
 
 ```javascript
-const stats = await Candy.Mysql.table('orders')
-  .select('user_id', Candy.Mysql.raw('COUNT(*) as order_count'))
+const stats = await Odac.Mysql.table('orders')
+  .select('user_id', Odac.Mysql.raw('COUNT(*) as order_count'))
   .groupBy('user_id')
   .get()
 ```
@@ -246,13 +246,13 @@ const stats = await Candy.Mysql.table('orders')
 ### Complete Example
 
 ```javascript
-module.exports = async function (Candy) {
-  const page = await Candy.request('page') || 1
+module.exports = async function (Odac) {
+  const page = await Odac.request('page') || 1
   const perPage = 20
-  const search = await Candy.request('search')
+  const search = await Odac.request('search')
   
   // Build query
-  let query = Candy.Mysql.table('products')
+  let query = Odac.Mysql.table('products')
     .select('id', 'name', 'price', 'stock')
     .where('status', 'active')
   
@@ -268,17 +268,17 @@ module.exports = async function (Candy) {
     .get()
   
   // Get total count
-  const totalCount = await Candy.Mysql.table('products')
+  const totalCount = await Odac.Mysql.table('products')
     .where('status', 'active')
     .rows()
   
-  Candy.set({
+  Odac.set({
     products: products,
     currentPage: page,
     totalPages: Math.ceil(totalCount / perPage)
   })
   
-  Candy.View.set({
+  Odac.View.set({
     skeleton: 'main',
     content: 'products.list'
   })
@@ -298,23 +298,23 @@ module.exports = async function (Candy) {
 ### Error Handling
 
 ```javascript
-module.exports = async function (Candy) {
+module.exports = async function (Odac) {
   try {
-    const user = await Candy.Mysql.table('users')
-      .where('id', await Candy.request('id'))
+    const user = await Odac.Mysql.table('users')
+      .where('id', await Odac.request('id'))
       .first()
     
     if (!user) {
-      Candy.set('error', 'User not found')
+      Odac.set('error', 'User not found')
     } else {
-      Candy.set('user', user)
+      Odac.set('user', user)
     }
   } catch (error) {
     console.error('Database error:', error)
-    Candy.set('error', 'An error occurred')
+    Odac.set('error', 'An error occurred')
   }
   
-  Candy.View.set({
+  Odac.View.set({
     skeleton: 'main',
     content: 'user.profile'
   })