npm - odac - Versions diffs - 0.9.0 → 1.0.0 - Mend

odac 0.9.0 → 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (208) hide show

package/.github/workflows/auto-pr-description.yml +0 -2
package/.github/workflows/codeql.yml +46 -0
package/.github/workflows/release.yml +13 -6
package/.github/workflows/test-coverage.yml +10 -9
package/.releaserc.js +9 -6
package/CHANGELOG.md +62 -150
package/CODE_OF_CONDUCT.md +1 -1
package/CONTRIBUTING.md +8 -8
package/LICENSE +21 -661
package/README.md +12 -12
package/SECURITY.md +4 -4
package/bin/odac.js +101 -0
package/{framework/web/candy.js → client/odac.js} +310 -44
package/docs/backend/01-overview/{01-whats-in-the-candy-box.md → 01-whats-in-the-odac-box.md} +4 -2
package/docs/backend/01-overview/02-super-handy-helper-functions.md +29 -1
package/docs/backend/01-overview/03-development-server.md +11 -11
package/docs/backend/02-structure/01-typical-project-layout.md +4 -4
package/docs/backend/03-config/00-configuration-overview.md +6 -6
package/docs/backend/03-config/01-database-connection.md +1 -1
package/docs/backend/03-config/02-static-route-mapping-optional.md +4 -4
package/docs/backend/03-config/04-environment-variables.md +20 -20
package/docs/backend/03-config/05-early-hints.md +4 -4
package/docs/backend/04-routing/01-basic-page-routes.md +4 -4
package/docs/backend/04-routing/02-controller-less-view-routes.md +5 -5
package/docs/backend/04-routing/03-api-and-data-routes.md +3 -3
package/docs/backend/04-routing/04-authentication-aware-routes.md +5 -5
package/docs/backend/04-routing/05-advanced-routing.md +3 -3
package/docs/backend/04-routing/06-error-pages.md +17 -17
package/docs/backend/04-routing/07-cron-jobs.md +13 -13
package/docs/backend/04-routing/08-middleware.md +214 -0
package/docs/backend/04-routing/09-websocket-auth-middleware.md +292 -0
package/docs/backend/04-routing/09-websocket-examples.md +381 -0
package/docs/backend/04-routing/09-websocket-quick-reference.md +211 -0
package/docs/backend/04-routing/09-websocket.md +298 -0
package/docs/backend/05-controllers/01-how-to-build-a-controller.md +3 -3
package/docs/backend/05-controllers/02-your-trusty-odac-assistant.md +41 -0
package/docs/backend/05-controllers/03-controller-classes.md +19 -19
package/docs/backend/05-forms/01-custom-forms.md +114 -114
package/docs/backend/05-forms/02-automatic-database-insert.md +82 -82
package/docs/backend/06-request-and-response/01-the-request-object-what-is-the-user-asking-for.md +26 -26
package/docs/backend/06-request-and-response/02-sending-a-response-replying-to-the-user.md +10 -10
package/docs/backend/07-views/01-the-view-directory.md +1 -1
package/docs/backend/07-views/02-rendering-a-view.md +22 -22
package/docs/backend/07-views/03-template-syntax.md +52 -52
package/docs/backend/07-views/03-variables.md +84 -84
package/docs/backend/07-views/04-request-data.md +57 -57
package/docs/backend/07-views/05-conditionals.md +78 -78
package/docs/backend/07-views/06-loops.md +114 -114
package/docs/backend/07-views/07-translations.md +66 -66
package/docs/backend/07-views/08-backend-javascript.md +103 -103
package/docs/backend/07-views/09-comments.md +71 -71
package/docs/backend/08-database/01-database-connection.md +8 -8
package/docs/backend/08-database/02-using-mysql.md +49 -49
package/docs/backend/09-validation/01-the-validator-service.md +38 -38
package/docs/backend/10-authentication/01-user-logins-with-authjs.md +15 -15
package/docs/backend/10-authentication/02-foiling-villains-with-csrf-protection.md +10 -10
package/docs/backend/10-authentication/03-register.md +12 -12
package/docs/backend/10-authentication/{04-candy-register-forms.md → 04-odac-register-forms.md} +141 -141
package/docs/backend/10-authentication/05-session-management.md +10 -10
package/docs/backend/10-authentication/{06-candy-login-forms.md → 06-odac-login-forms.md} +125 -125
package/docs/backend/11-mail/01-the-mail-service.md +5 -5
package/docs/backend/12-streaming/01-streaming-overview.md +96 -54
package/docs/backend/13-utilities/{01-candy-var.md → 01-odac-var.md} +109 -109
package/docs/frontend/01-overview/01-introduction.md +30 -30
package/docs/frontend/02-ajax-navigation/01-quick-start.md +45 -45
package/docs/frontend/02-ajax-navigation/02-configuration.md +14 -14
package/docs/frontend/02-ajax-navigation/03-advanced-usage.md +36 -36
package/docs/frontend/03-forms/01-form-handling.md +32 -32
package/docs/frontend/04-api-requests/01-get-post.md +33 -33
package/docs/frontend/05-streaming/01-client-streaming.md +15 -15
package/docs/frontend/06-websocket/00-overview.md +76 -0
package/docs/frontend/06-websocket/01-websocket-client.md +139 -0
package/docs/frontend/06-websocket/02-shared-websocket.md +149 -0
package/docs/index.json +49 -11
package/eslint.config.mjs +6 -6
package/{framework/index.js → index.js} +1 -1
package/package.json +14 -39
package/{framework/src → src}/Auth.js +59 -59
package/{framework/src → src}/Config.js +3 -3
package/{framework/src → src}/Lang.js +7 -7
package/{framework/src → src}/Mail.js +5 -5
package/{framework/src → src}/Mysql.js +42 -42
package/src/Odac.js +112 -0
package/{framework/src → src}/Request.js +38 -36
package/{framework/src → src}/Route/Internal.js +116 -116
package/src/Route/Middleware.js +75 -0
package/src/Route.js +621 -0
package/src/Server.js +22 -0
package/{framework/src → src}/Stream.js +11 -3
package/{framework/src → src}/Validator.js +21 -21
package/{framework/src → src}/Var.js +5 -5
package/{framework/src → src}/View/EarlyHints.js +1 -1
package/{framework/src → src}/View/Form.js +69 -69
package/{framework/src → src}/View.js +78 -81
package/src/WebSocket.js +403 -0
package/template/config.json +5 -0
package/{web → template}/controller/page/about.js +6 -6
package/{web → template}/controller/page/index.js +9 -9
package/{web → template}/package.json +4 -5
package/{web → template}/public/assets/css/style.css +4 -4
package/{web → template}/public/assets/js/app.js +6 -6
package/{web → template}/route/www.js +6 -6
package/{web → template}/skeleton/main.html +1 -1
package/{web → template}/view/content/about.html +5 -5
package/{web → template}/view/content/home.html +12 -12
package/template/view/footer/main.html +11 -0
package/{web → template}/view/head/main.html +1 -1
package/{web → template}/view/header/main.html +2 -2
package/test/core/Candy.test.js +58 -58
package/test/core/Commands.test.js +7 -7
package/test/core/Config.test.js +82 -85
package/test/core/Lang.test.js +2 -2
package/test/core/Process.test.js +6 -6
package/test/framework/Route.test.js +56 -37
package/test/framework/View/EarlyHints.test.js +2 -2
package/test/framework/WebSocket.test.js +100 -0
package/test/framework/middleware.test.js +85 -0
package/test/server/Api.test.js +31 -31
package/test/server/DNS.test.js +11 -11
package/test/server/Hub.test.js +497 -0
package/test/server/Mail.account.test_.js +3 -3
package/test/server/Mail.init.test_.js +10 -10
package/test/server/Mail.test_.js +20 -20
package/test/server/SSL.test_.js +54 -54
package/test/server/Server.test.js +39 -39
package/test/server/Service.test_.js +7 -7
package/test/server/Subdomain.test.js +7 -7
package/test/server/Web/Firewall.test.js +87 -87
package/test/server/Web/Proxy.test.js +397 -0
package/test/server/{Web.test_.js → Web.test.js} +137 -205
package/test/server/__mocks__/fs.js +2 -2
package/test/server/__mocks__/{globalCandy.js → globalOdac.js} +5 -5
package/test/server/__mocks__/index.js +6 -6
package/test/server/__mocks__/testFactories.js +1 -1
package/test/server/__mocks__/testHelpers.js +7 -7
package/.husky/pre-commit +0 -2
package/.kiro/steering/code-style.md +0 -56
package/.kiro/steering/product.md +0 -20
package/.kiro/steering/structure.md +0 -77
package/.kiro/steering/tech.md +0 -87
package/AGENTS.md +0 -84
package/bin/candy +0 -10
package/bin/candypack +0 -10
package/cli/index.js +0 -3
package/cli/src/Cli.js +0 -348
package/cli/src/Connector.js +0 -93
package/cli/src/Monitor.js +0 -416
package/core/Candy.js +0 -87
package/core/Commands.js +0 -239
package/core/Config.js +0 -1094
package/core/Lang.js +0 -52
package/core/Log.js +0 -43
package/core/Process.js +0 -26
package/docs/backend/05-controllers/02-your-trusty-candy-assistant.md +0 -20
package/docs/server/01-installation/01-quick-install.md +0 -19
package/docs/server/01-installation/02-manual-installation-via-npm.md +0 -9
package/docs/server/02-get-started/01-core-concepts.md +0 -7
package/docs/server/02-get-started/02-basic-commands.md +0 -57
package/docs/server/02-get-started/03-cli-reference.md +0 -276
package/docs/server/02-get-started/04-cli-quick-reference.md +0 -102
package/docs/server/03-service/01-start-a-new-service.md +0 -57
package/docs/server/03-service/02-delete-a-service.md +0 -48
package/docs/server/04-web/01-create-a-website.md +0 -36
package/docs/server/04-web/02-list-websites.md +0 -9
package/docs/server/04-web/03-delete-a-website.md +0 -29
package/docs/server/05-subdomain/01-create-a-subdomain.md +0 -32
package/docs/server/05-subdomain/02-list-subdomains.md +0 -33
package/docs/server/05-subdomain/03-delete-a-subdomain.md +0 -41
package/docs/server/06-ssl/01-renew-an-ssl-certificate.md +0 -34
package/docs/server/07-mail/01-create-a-mail-account.md +0 -23
package/docs/server/07-mail/02-delete-a-mail-account.md +0 -20
package/docs/server/07-mail/03-list-mail-accounts.md +0 -20
package/docs/server/07-mail/04-change-account-password.md +0 -23
package/framework/src/Candy.js +0 -81
package/framework/src/Route.js +0 -455
package/framework/src/Server.js +0 -15
package/locale/de-DE.json +0 -80
package/locale/en-US.json +0 -79
package/locale/es-ES.json +0 -80
package/locale/fr-FR.json +0 -80
package/locale/pt-BR.json +0 -80
package/locale/ru-RU.json +0 -80
package/locale/tr-TR.json +0 -85
package/locale/zh-CN.json +0 -80
package/server/index.js +0 -5
package/server/src/Api.js +0 -88
package/server/src/DNS.js +0 -940
package/server/src/Hub.js +0 -535
package/server/src/Mail.js +0 -571
package/server/src/SSL.js +0 -180
package/server/src/Server.js +0 -27
package/server/src/Service.js +0 -248
package/server/src/Subdomain.js +0 -64
package/server/src/Web/Firewall.js +0 -170
package/server/src/Web/Proxy.js +0 -134
package/server/src/Web.js +0 -451
package/server/src/mail/imap.js +0 -1091
package/server/src/mail/server.js +0 -32
package/server/src/mail/smtp.js +0 -786
package/test/server/Client.test.js +0 -338
package/test/server/__mocks__/http-proxy.js +0 -105
package/watchdog/index.js +0 -3
package/watchdog/src/Watchdog.js +0 -156
package/web/config.json +0 -5
package/web/view/footer/main.html +0 -11
/package/{framework/src → src}/Env.js +0 -0
/package/{framework/src → src}/Route/Cron.js +0 -0
/package/{framework/src → src}/Token.js +0 -0

package/docs/frontend/01-overview/01-introduction.md CHANGED Viewed

@@ -1,41 +1,41 @@
-# Frontend Javascript Framework: candy.js
+# Frontend Javascript Framework: odac.js
-`candy.js` is a lightweight frontend JavaScript framework designed to simplify interactions with the backend, handle forms, and manage page-specific logic within the CandyPack ecosystem. It provides a set of tools for event handling, AJAX requests, and more, all accessible through the global `Candy` object.
+`odac.js` is a lightweight frontend JavaScript framework designed to simplify interactions with the backend, handle forms, and manage page-specific logic within the Odac ecosystem. It provides a set of tools for event handling, AJAX requests, and more, all accessible through the global `odac` object.
-## The Global `Candy` Object
+## The Global `odac` Object
-After including `candy.js` in your page, you will have access to a global `Candy` object. This object is the main entry point for all the features of the framework.
+After including `odac.js` in your page, you will have access to a global `odac` object. This object is the main entry point for all the features of the framework.
 ## Core Concepts
 ### Actions
-Actions are the fundamental building block of `candy.js`. An action is a collection of event handlers and lifecycle callbacks that define the behavior of a page or a component.
+Actions are the fundamental building block of `odac.js`. An action is a collection of event handlers and lifecycle callbacks that define the behavior of a page or a component.
 ### Pages
-`candy.js` has a concept of "pages", which allows you to scope your JavaScript to a specific page. The current page identifier is determined by the backend based on:
+`odac.js` has a concept of "pages", which allows you to scope your JavaScript to a specific page. The current page identifier is determined by the backend based on:
 - **Controller name** when using controller files (e.g., `'user'` for `controller/page/user.js`)
 - **View name** when using view objects (e.g., `'dashboard'` from `{content: 'dashboard'}`)
-- This identifier is accessible via `Candy.page()` and stored in `data-candy-page` attribute on the `<html>` element.
+- This identifier is accessible via `Odac.page()` and stored in `data-odac-page` attribute on the `<html>` element.
 ### Lifecycle Events
-`candy.js` provides several lifecycle events that you can hook into:
+`odac.js` provides several lifecycle events that you can hook into:
 -   `start`: Fired once when the script is initialized.
 -   `load`: Fired on every page load, after the DOM is ready.
 -   `page`: Fired on a specific page, after the DOM is ready.
 -   `interval`: Fired repeatedly at a specified interval.
-## Event Handling with `Candy.action()`
+## Event Handling with `Odac.action()`
-The `Candy.action()` method is the most important method in the framework. It allows you to register event handlers and lifecycle callbacks.
+The `Odac.action()` method is the most important method in the framework. It allows you to register event handlers and lifecycle callbacks.
 ```javascript
-Candy.action({
+Odac.action({
     // Fired once on DOMContentLoaded
     start: function() {
-        console.log('Candy.js started!');
+        console.log('odac.js started!');
     },
     // Fired on every page load
@@ -82,19 +82,19 @@ Candy.action({
 });
 ```
-## Working with Forms using `Candy.form()`
+## Working with Forms using `Odac.form()`
-`Candy.form()` simplifies AJAX form submissions. It handles serialization, validation feedback, success messages, and file uploads automatically.
+`Odac.form()` simplifies AJAX form submissions. It handles serialization, validation feedback, success messages, and file uploads automatically.
 ```javascript
 // Basic usage
-Candy.form('#my-form', function(data) {
+odac.form('#my-form', function(data) {
     // This callback is executed on success
     console.log('Form submitted successfully!', data);
 });
 // With options
-Candy.form({
+odac.form({
     form: '#my-form',
     messages: ['success', 'error'], // Show both success and error messages
     loading: function(percent) {
@@ -107,40 +107,40 @@ Candy.form({
     }
 });
 ```
-To display validation errors, you can add elements with the `candy-form-error` attribute to your form. The value of the attribute should be the `name` of the input field.
+To display validation errors, you can add elements with the `odac-form-error` attribute to your form. The value of the attribute should be the `name` of the input field.
 ```html
 <input type="text" name="email">
-<span candy-form-error="email"></span>
+<span odac-form-error="email"></span>
 ```
-## Making AJAX requests with `Candy.get()`
+## Making AJAX requests with `Odac.get()`
-For simple GET requests, you can use the `Candy.get()` method.
+For simple GET requests, you can use the `Odac.get()` method.
 ```javascript
-Candy.get('/api/users', function(data) {
+odac.get('/api/users', function(data) {
     console.log('Users:', data);
 });
 ```
-## Managing CSRF tokens with `Candy.token()`
+## Managing CSRF tokens with `Odac.token()`
-`candy.js` automatically manages CSRF tokens for you. The `Candy.token()` method will return a valid token for your requests. The `Candy.form()` and `Candy.get()` methods use this automatically, so you usually don't need to call it yourself.
+`odac.js` automatically manages CSRF tokens for you. The `Odac.token()` method will return a valid token for your requests. The `Odac.form()` and `Odac.get()` methods use this automatically, so you usually don't need to call it yourself.
 ## Other Utility Functions
--   **`Candy.client()`**: Returns a unique client identifier from a cookie.
--   **`Candy.data()`**: Returns data from the `candy_data` cookie, which is set by the backend. This data includes the current page and the initial CSRF token.
--   **`Candy.page()`**: Returns the identifier of the current page. This is the controller name (e.g., `'user'`) or view name (e.g., `'dashboard'`) set by the backend. Use this to conditionally run code for specific pages.
--   **`Candy.storage()`**: A wrapper for `localStorage`.
+-   **`Odac.client()`**: Returns a unique client identifier from a cookie.
+-   **`Odac.data()`**: Returns data from the `candy_data` cookie, which is set by the backend. This data includes the current page and the initial CSRF token.
+-   **`Odac.page()`**: Returns the identifier of the current page. This is the controller name (e.g., `'user'`) or view name (e.g., `'dashboard'`) set by the backend. Use this to conditionally run code for specific pages.
+-   **`Odac.storage()`**: A wrapper for `localStorage`.
     ```javascript
     // Set a value
-    Candy.storage('my-key', 'my-value');
+    odac.storage('my-key', 'my-value');
     // Get a value
-    let value = Candy.storage('my-key');
+    let value = odac.storage('my-key');
     // Remove a value
-    Candy.storage('my-key', null);
+    odac.storage('my-key', null);
     ```

package/docs/frontend/02-ajax-navigation/01-quick-start.md CHANGED Viewed

@@ -1,6 +1,6 @@
 # AJAX Navigation
-CandyPack framework includes a built-in AJAX navigation system that enables smooth, single-page application (SPA) style navigation without full page reloads.
+Odac framework includes a built-in AJAX navigation system that enables smooth, single-page application (SPA) style navigation without full page reloads.
 ## Features
@@ -19,7 +19,7 @@ CandyPack framework includes a built-in AJAX navigation system that enables smoo
 Just enable navigation - it automatically handles all internal links:
 ```javascript
-Candy.action({
+Odac.action({
   navigate: 'main'  // Update <main> element on navigation
 })
 ```
@@ -31,7 +31,7 @@ That's it! All links starting with `/` will now load via AJAX.
 Add a callback for post-navigation actions:
 ```javascript
-Candy.action({
+Odac.action({
   navigate: {
     update: 'main',
     on: function(page, variables) {
@@ -47,7 +47,7 @@ Candy.action({
 Full control over navigation behavior:
 ```javascript
-Candy.action({
+Odac.action({
   navigate: {
     links: 'a[href^="/"]',  // Which links to intercept
     update: {                // Which elements to update
@@ -94,7 +94,7 @@ Example `skeleton/main.html`:
 <html>
 <head>
   <title>My Site</title>
-  <script src="/assets/js/candy.js"></script>
+  <script src="/assets/js/odac.js"></script>
   <script src="/assets/js/app.js"></script>
 </head>
 <body>
@@ -120,22 +120,22 @@ Example `skeleton/main.html`:
 ### Controller Setup
-Controllers automatically support AJAX loading. Use `Candy.View.skeleton()` to specify which skeleton to use:
+Controllers automatically support AJAX loading. Use `Odac.View.skeleton()` to specify which skeleton to use:
 ```javascript
-module.exports = function (Candy) {
+module.exports = function (Odac) {
   // Define the skeleton template
-  Candy.View.skeleton('main')
+  odac.View.skeleton('main')
   // Set view parts - lowercase keys map to UPPERCASE placeholders
-  Candy.View.set({
+  odac.View.set({
     header: 'main',      // Loads view/header/main.html into {{ HEADER }}
     content: 'about',    // Loads view/content/about.html into {{ CONTENT }}
     footer: 'main'       // Loads view/footer/main.html into {{ FOOTER }}
   })
   // Optional: Send variables to frontend (AJAX only)
-  Candy.set({
+  odac.set({
     pageTitle: 'About',
     data: {foo: 'bar'}
   }, true) // true = include in AJAX responses
@@ -159,8 +159,8 @@ module.exports = function (Candy) {
 1. User clicks `<a href="/about">`
 2. JavaScript intercepts click and sends AJAX request with:
-   - Header: `X-Candy: ajaxload`
-   - Header: `X-Candy-Load: content,header` (requested sections)
+   - Header: `X-Odac: ajaxload`
+   - Header: `X-Odac-Load: content,header` (requested sections)
 3. Server detects AJAX request and returns only requested sections as JSON:
    ```json
    {
@@ -179,20 +179,20 @@ module.exports = function (Candy) {
 6. Page-specific callbacks execute
 **Key Points:**
-- The `output` keys in the JSON response match the lowercase keys from `Candy.View.set()` in your controller
+- The `output` keys in the JSON response match the lowercase keys from `Odac.View.set()` in your controller
 - These keys correspond to UPPERCASE placeholders in your skeleton (e.g., `content` → `{{ CONTENT }}`)
 - Only the sections specified in `navigate.update` are sent and updated
 - Frontend selectors target the HTML tags wrapping the placeholders
 ## API Reference
-### Candy.action({ navigate: ... })
+### Odac.action({ navigate: ... })
 Initialize AJAX navigation using the action system.
 #### Minimal Usage
 ```javascript
-Candy.action({
+Odac.action({
   navigate: 'main'  // Just specify element to update
 })
 ```
@@ -201,7 +201,7 @@ Candy.action({
 #### Medium Usage
 ```javascript
-Candy.action({
+Odac.action({
   navigate: {
     update: 'main',           // Element to update
     on: function(page, vars) { // Callback after navigation
@@ -213,7 +213,7 @@ Candy.action({
 #### Advanced Usage
 ```javascript
-Candy.action({
+Odac.action({
   navigate: {
     links: 'a[href^="/"]',    // Which links to intercept
     update: {                  // Multiple elements to update
@@ -232,12 +232,12 @@ Candy.action({
 #### Boolean Usage
 ```javascript
-Candy.action({
+Odac.action({
   navigate: true   // Enable with all defaults
 })
 // Or disable completely
-Candy.action({
+Odac.action({
   navigate: false  // Disable AJAX navigation
 })
 ```
@@ -296,13 +296,13 @@ Both methods work automatically - no additional configuration needed!
   }
   ```
-### Candy.loader(selector, elements, callback)
+### odac.loader(selector, elements, callback)
 Low-level method for direct initialization (not recommended for new code).
 **Parameters:** Same as navigate configuration, but as separate arguments.
-### Candy.load(url, callback, push)
+### odac.load(url, callback, push)
 Programmatically load a page via AJAX.
@@ -313,7 +313,7 @@ Programmatically load a page via AJAX.
 **Example:**
 ```javascript
-Candy.load('/about', function(page, variables) {
+odac.load('/about', function(page, variables) {
   console.log('Loaded:', page)
 })
 ```
@@ -323,7 +323,7 @@ Candy.load('/about', function(page, variables) {
 Run code when specific pages load. The page identifier is based on the controller name or view name:
 ```javascript
-Candy.action({
+Odac.action({
   page: {
     // Runs when controller/page/index.js is used
     index: function(variables) {
@@ -347,7 +347,7 @@ Candy.action({
 **Page Identifier Rules:**
 - **With controller**: Uses controller filename (e.g., `user.js` → `'user'`)
 - **With view object**: Uses `content` or `all` value (e.g., `{content: 'dashboard'}` → `'dashboard'`)
-- Accessible via `Candy.page()` or `document.documentElement.dataset.candyPage`
+- Accessible via `Odac.page()` or `document.documentElement.dataset.candyPage`
 ## Server Variables
@@ -355,7 +355,7 @@ Send data from server to client in AJAX responses:
 ```javascript
 // In controller
-Candy.set({
+odac.set({
   user: {name: 'John', role: 'admin'},
   stats: {views: 1234}
 }, true) // true = include in AJAX
@@ -364,7 +364,7 @@ Candy.set({
 Access in client:
 ```javascript
-Candy.action({
+Odac.action({
   navigate: {
     update: 'main',
     on: function(page, variables) {
@@ -388,25 +388,25 @@ Candy.action({
 ### Minimal Example
 ```javascript
 // Just enable AJAX navigation
-Candy.action({
+Odac.action({
   navigate: 'main'
 })
 ```
 ### Real-World Example
 ```javascript
-// app.js - Everything in one Candy.action() call
-Candy.action({
+// app.js - Everything in one Odac.action() call
+Odac.action({
   // AJAX Navigation - automatically handles all internal links
   navigate: {
     update: 'main',
     on: function(page, variables) {
-      Candy.fn.updateActiveNav(window.location.pathname)
+      odac.fn.updateActiveNav(window.location.pathname)
       console.log('Navigated to:', page)
     }
   },
-  // Custom functions (accessible as Candy.fn.functionName)
+  // Custom functions (accessible as odac.fn.functionName)
   function: {
     updateActiveNav: function(url) {
       document.querySelectorAll('nav a').forEach(link => {
@@ -418,14 +418,14 @@ Candy.action({
   // App initialization
   load: function() {
     console.log('App initialized')
-    Candy.fn.updateActiveNav(window.location.pathname)
+    odac.fn.updateActiveNav(window.location.pathname)
   },
   // Page-specific code
   page: {
     index: function(variables) {
       // Home page specific code
-      Candy.form('#contact-form', function(data) {
+      odac.form('#contact-form', function(data) {
         if (data.result.success) {
           alert('Message sent!')
         }
@@ -441,7 +441,7 @@ Candy.action({
   // Event handlers
   click: {
     '#refresh-btn': function() {
-      Candy.load(window.location.pathname)
+      odac.load(window.location.pathname)
     }
   }
 })
@@ -449,7 +449,7 @@ Candy.action({
 ### Advanced Multi-Section Example
 ```javascript
-Candy.action({
+Odac.action({
   navigate: {
     update: {
       content: 'main',
@@ -473,7 +473,7 @@ Candy.action({
 ### Disable Completely
 ```javascript
-Candy.action({
+Odac.action({
   navigate: false  // Disable AJAX navigation entirely
 })
 ```
@@ -505,7 +505,7 @@ Candy.action({
 ### 1. Use Minimal Configuration
 ```javascript
 // Simple and effective
-Candy.action({
+Odac.action({
   navigate: 'main'
 })
 ```
@@ -524,7 +524,7 @@ Candy.action({
 ### 3. Handle Loading States
 ```javascript
-Candy.action({
+Odac.action({
   navigate: {
     update: 'main',
     on: (page, vars) => {
@@ -546,7 +546,7 @@ Candy.action({
 ### Links not loading via AJAX
 - Check browser console for errors
-- Verify navigate is enabled in `Candy.action()`
+- Verify navigate is enabled in `Odac.action()`
 - Ensure links start with `/` for internal navigation
 ### Specific links should not use AJAX
@@ -573,8 +573,8 @@ This is usually caused by mismatched keys between your skeleton, controller, and
 2. **Controller** (`controller/page/about.js`):
    ```javascript
-   Candy.View.skeleton('main')
-   Candy.View.set({
+   odac.View.skeleton('main')
+   odac.View.set({
      header: 'main',    // Lowercase → {{ HEADER }}
      content: 'about'   // Lowercase → {{ CONTENT }}
    })
@@ -582,7 +582,7 @@ This is usually caused by mismatched keys between your skeleton, controller, and
 3. **Frontend** (`public/assets/js/app.js`):
    ```javascript
-   Candy.action({
+   Odac.action({
      navigate: {
        update: {
          header: 'header',  // Targets <header> tag
@@ -599,10 +599,10 @@ This is usually caused by mismatched keys between your skeleton, controller, and
 **Also verify:**
 - Element selectors match actual DOM elements (e.g., `'main'` matches `<main>`)
-- Skeleton template is defined with `Candy.View.skeleton('main')`
-- View parts are defined in controller with `Candy.View.set()`
+- Skeleton template is defined with `Odac.View.skeleton('main')`
+- View parts are defined in controller with `Odac.View.set()`
 ### Variables not available
-- Confirm `Candy.set(data, true)` has `true` as second parameter
+- Confirm `Odac.set(data, true)` has `true` as second parameter
 - Check that variables are set before `View.print()` is called

package/docs/frontend/02-ajax-navigation/02-configuration.md CHANGED Viewed

@@ -1,6 +1,6 @@
 # AJAX Navigation Configuration
-Learn how to configure and customize AJAX navigation in your CandyPack application.
+Learn how to configure and customize AJAX navigation in your Odac application.
 ## Prerequisites
@@ -23,7 +23,7 @@ Before configuring AJAX navigation, ensure your skeleton template is properly se
 The simplest way to enable AJAX navigation:
 ```javascript
-Candy.action({
+Odac.action({
   navigate: 'main'  // Update <main> element
 })
 ```
@@ -33,7 +33,7 @@ Candy.action({
 All available options:
 ```javascript
-Candy.action({
+Odac.action({
   navigate: {
     // Which links to intercept
     links: 'a[href^="/"]',  // Default: all internal links
@@ -129,7 +129,7 @@ The keys (content, header, etc.) must match the view parts defined in your contr
 ```javascript
 // In controller
-Candy.View.set({
+odac.View.set({
   header: 'main',
   content: 'about',
   sidebar: 'main'
@@ -170,7 +170,7 @@ navigate: {
 Run code for specific pages:
 ```javascript
-Candy.action({
+Odac.action({
   navigate: {
     update: 'main',
     on: (page, vars) => console.log('Navigated to:', page)
@@ -192,7 +192,7 @@ Candy.action({
 ### Disable Completely
 ```javascript
-Candy.action({
+Odac.action({
   navigate: false  // No AJAX navigation
 })
 ```
@@ -217,16 +217,16 @@ Candy.action({
 In your controller, send data to the client:
 ```javascript
-module.exports = function(Candy) {
+module.exports = function(Odac) {
   // Set variables for AJAX responses
-  Candy.set({
+  odac.set({
     title: 'About Page',
     user: {name: 'John', role: 'admin'},
     stats: {views: 1234}
   }, true)  // true = include in AJAX
-  Candy.View.skeleton('main')
-  Candy.View.set({
+  odac.View.skeleton('main')
+  odac.View.set({
     header: 'main',
     content: 'about',
     footer: 'main'
@@ -256,7 +256,7 @@ navigate: {
 Show a loading spinner during navigation:
 ```javascript
-Candy.action({
+Odac.action({
   navigate: {
     update: 'main',
     on: (page, vars) => {
@@ -290,7 +290,7 @@ Animated progress bar:
 ```javascript
 let progressBar = document.getElementById('progress')
-Candy.action({
+Odac.action({
   navigate: {
     update: 'main',
     on: () => {
@@ -316,7 +316,7 @@ Candy.action({
 Confirm before navigating:
 ```javascript
-Candy.action({
+Odac.action({
   navigate: {
     update: 'main'
   },
@@ -360,7 +360,7 @@ Candy.action({
 ### Variables Not Available
-- Confirm `Candy.set(data, true)` has `true` parameter
+- Confirm `Odac.set(data, true)` has `true` parameter
 - Check variables are set before `View.print()`
 ## Next Steps