odac 1.4.11 → 1.4.12

package/CHANGELOG.md

@@ -1,3 +1,19 @@
+### 📚 Documentation
+
+- refactor database configuration to a unified structure and document multi-connection support
+
+### 🛠️ Fixes & Improvements
+
+- **mail:** add line wrapping for email content to comply with SMTP standards
+- **mail:** use 990-char wrap for HTML, 76 for text; trim migration defaults
+- **route:** hot-reload cron fix
+
+
+
+---
+
+Powered by [⚡ ODAC](https://odac.run)
+
 ### ✨ What's New
 
 - add esbuild-powered JS/TS frontend pipeline

package/docs/ai/skills/backend/config.md

@@ -30,10 +30,30 @@ const apiKey = Odac.env('API_KEY');
 ### 2. odac.json Structure
 ```json
 {
-  "mysql": {
+  "database": {
+    "type": "mysql",
     "host": "${DB_HOST}",
     "password": "${DB_PASSWORD}"
   },
   "debug": true
 }
 ```
+
+### 3. Multiple Databases
+```json
+{
+  "database": {
+    "default": {
+      "type": "mysql",
+      "database": "main_app"
+    },
+    "analytics": {
+      "type": "postgres",
+      "host": "analytics.local",
+      "database": "events"
+    }
+  }
+}
+```
+
+Access via: `Odac.DB.analytics.tableName`

package/docs/ai/skills/backend/database.md

@@ -16,6 +16,46 @@ High-performance database operations using the ODAC Query Builder, Read-Through
 4.  **Read Caching**: Use `cache()` for frequently-read, rarely-changed data.
 5.  **Write Coalescing**: Use `buffer` for high-frequency writes to avoid DB saturation.
 
+## Database Configuration (`odac.json`)
+
+ODAC connects to databases automatically based on the `database` key in `odac.json`.
+
+### 1. Single Connection
+```json
+{
+  "database": {
+    "type": "mysql",
+    "host": "${DB_HOST}",
+    "user": "${DB_USER}",
+    "password": "${DB_PASSWORD}",
+    "database": "myapp"
+  }
+}
+```
+
+### 2. Multiple Connections
+Define named objects. The one named `default` (or the first one) is used by default.
+```json
+{
+  "database": {
+    "default": {
+      "type": "mysql",
+      "database": "app_db"
+    },
+    "analytics": {
+      "type": "postgres",
+      "host": "remote-stats.db",
+      "database": "events"
+    }
+  }
+}
+```
+
+Access named connections via: `Odac.DB.analytics.tableName`
+
+### 3. Environment Variables
+Always use `${VAR_NAME}` for sensitive credentials. Map them in `.env`.
+
 ## Query Builder Patterns
 ```javascript
 const user = await Odac.DB.users

package/docs/backend/03-config/00-configuration-overview.md

@@ -12,7 +12,8 @@ The main configuration file located in your website's root directory. This file
   "request": {
     "timeout": 30000
   },
-  "mysql": {
+  "database": {
+    "type": "mysql",
     "host": "localhost",
     "user": "root",
     "password": "secret123",
@@ -38,7 +39,8 @@ Perfect for development or non-sensitive settings:
 
 ```json
 {
-  "mysql": {
+  "database": {
+    "type": "mysql",
     "host": "localhost",
     "password": "dev123"
   }
@@ -50,7 +52,8 @@ Use `${VARIABLE}` syntax in `odac.json` to reference `.env` values:
 
 ```json
 {
-  "mysql": {
+  "database": {
+    "type": "mysql",
     "host": "${MYSQL_HOST}",
     "password": "${MYSQL_PASSWORD}"
   }
@@ -68,7 +71,8 @@ Combine both methods - use direct values for non-sensitive data and environment
 
 ```json
 {
-  "mysql": {
+  "database": {
+    "type": "mysql",
     "host": "localhost",
     "user": "root",
     "password": "${MYSQL_PASSWORD}",
@@ -88,7 +92,7 @@ You can access configuration values in three ways:
 
 ```javascript
 // 1. From Odac.Config (recommended for structured config)
-const dbHost = Odac.Config.mysql.host
+const dbHost = Odac.Config.database.host
 
 // 2. Using Odac.env() helper
 const apiKey = Odac.env('API_KEY')
@@ -130,6 +134,7 @@ const nodeEnv = process.env.NODE_ENV
 ```json
 {
   "database": {
+    "type": "mysql",
     "host": "localhost",
     "user": "root",
     "password": "${MYSQL_PASSWORD}",
@@ -195,7 +200,8 @@ See individual documentation sections for detailed configuration options.
   "request": {
     "timeout": 30000
   },
-  "mysql": {
+  "database": {
+    "type": "mysql",
     "host": "${MYSQL_HOST}",
     "user": "${MYSQL_USER}",
     "password": "${MYSQL_PASSWORD}",

package/docs/backend/03-config/01-database-connection.md

@@ -1,12 +1,13 @@
 ## 🔌 Database Connection
 
-When you add a `mysql` object to your `odac.json`, the system will automatically connect to your MySQL database. No separate connection setup is needed in your code.
+When you add a `database` object to your `odac.json`, the system will automatically connect to your database. No separate connection setup is needed in your code.
 
 ### Basic Configuration
 
 ```json
 {
-  "mysql": {
+  "database": {
+    "type": "mysql",
     "host": "localhost",
     "user": "your_user",
     "password": "your_password",
@@ -24,7 +25,8 @@ For better security, especially in production, you can use environment variables
 **odac.json:**
 ```json
 {
-  "mysql": {
+  "database": {
+    "type": "mysql",
     "host": "${MYSQL_HOST}",
     "user": "${MYSQL_USER}",
     "password": "${MYSQL_PASSWORD}",
@@ -48,7 +50,8 @@ You can also mix direct values with environment variables:
 
 ```json
 {
-  "mysql": {
+  "database": {
+    "type": "mysql",
     "host": "localhost",
     "user": "root",
     "password": "${MYSQL_PASSWORD}",
@@ -58,3 +61,37 @@ You can also mix direct values with environment variables:
 ```
 
 This way, non-sensitive values are directly in the config while passwords remain in the `.env` file.
+
+### Multiple Database Connections
+
+ODAC supports multiple simultaneous database connections. You can define them as named objects within the `database` configuration:
+
+```json
+{
+  "database": {
+    "default": {
+      "type": "mysql",
+      "host": "localhost",
+      "database": "app_db"
+    },
+    "analytics": {
+      "type": "postgres",
+      "host": "remote-stats.db",
+      "database": "events"
+    }
+  }
+}
+```
+
+#### Usage in Code
+
+To use a specific connection, access it by its name via `Odac.DB`:
+
+```javascript
+// Uses 'default' connection
+const users = await Odac.DB.users.select('*')
+
+// Uses 'analytics' connection
+const events = await Odac.DB.analytics.pageviews.select('*')
+```
+

package/docs/backend/03-config/04-environment-variables.md

@@ -43,7 +43,8 @@ Reference environment variables using `${VARIABLE_NAME}` syntax:
 
 ```json
 {
-  "mysql": {
+  "database": {
+    "type": "mysql",
     "host": "${MYSQL_HOST}",
     "user": "${MYSQL_USER}",
     "password": "${MYSQL_PASSWORD}",
@@ -95,7 +96,7 @@ module.exports = function() {
 
 ```javascript
 module.exports = function() {
-  const dbHost = Odac.Config.mysql.host
+  const dbHost = Odac.Config.database.host
   const apiKey = Odac.Config.api.stripe.key
 }
 ```

package/docs/backend/08-database/01-getting-started.md

@@ -66,6 +66,17 @@ You can configure multiple database connections. The connection named `default`
 }
 ```
 
+To use a named connection in your code, simply access it through `Odac.DB`:
+
+```javascript
+// Primary database (default)
+const users = await Odac.DB.users.where('active', true)
+
+// Analytics database
+const logs = await Odac.DB.analytics.events.insert({ type: 'login' })
+```
+
+
 ---
 
 ## Environment Variables

package/docs/backend/10-authentication/04-odac-register-forms.md

@@ -8,7 +8,8 @@ The `<odac:register>` component provides a zero-configuration way to create secu
 
 ```json
 {
-  "mysql": {
+  "database": {
+    "type": "mysql",
     "host": "localhost",
     "user": "root",
     "password": "",
@@ -54,7 +55,8 @@ If you want to customize table names or primary key:
 
 ```json
 {
-  "mysql": {
+  "database": {
+    "type": "mysql",
     "host": "localhost",
     "user": "root",
     "password": "",
@@ -468,11 +470,12 @@ This provides instant feedback to users before form submission.
 
 ### Required Configuration
 
-Only MySQL configuration is required:
+Only database configuration is required:
 
 ```json
 {
-  "mysql": {
+  "database": {
+    "type": "mysql",
     "host": "localhost",
     "user": "root",
     "password": "",

package/docs/backend/10-authentication/06-odac-login-forms.md

@@ -8,7 +8,8 @@ The `<odac:login>` component provides a zero-configuration way to create secure
 
 ```json
 {
-  "mysql": {
+  "database": {
+    "type": "mysql",
     "host": "localhost",
     "user": "root",
     "password": "",
@@ -47,7 +48,8 @@ If you want to customize table names or primary key:
 
 ```json
 {
-  "mysql": {
+  "database": {
+    "type": "mysql",
     "host": "localhost",
     "user": "root",
     "password": "",
@@ -428,11 +430,12 @@ input._odac_error {
 
 ### Required Configuration
 
-Only MySQL configuration is required:
+Only database configuration is required:
 
 ```json
 {
-  "mysql": {
+  "database": {
+    "type": "mysql",
     "host": "localhost",
     "user": "root",
     "password": "",

package/package.json

@@ -7,7 +7,7 @@
     "email": "mail@emre.red",
     "url": "https://emre.red"
   },
-  "version": "1.4.11",
+  "version": "1.4.12",
   "license": "MIT",
   "engines": {
     "node": ">=18.0.0"

package/src/Database/Migration.js

@@ -681,7 +681,7 @@ class Migration {
    */
   async _createTable(knex, tableName, schema) {
     await knex.schema.createTable(tableName, table => {
-      this._buildColumns(table, schema.columns)
+      this._buildColumns(knex, table, schema.columns)
       this._buildIndexes(table, schema.indexes)
     })
   }
@@ -716,13 +716,13 @@ class Migration {
         for (const op of batchOps) {
           switch (op.type) {
             case 'add_column':
-              this._addColumn(table, op.column, op.definition)
+              this._addColumn(knex, table, op.column, op.definition)
               break
             case 'drop_column':
               table.dropColumn(op.column)
               break
             case 'alter_column':
-              this._alterColumn(table, op.column, op.definition, op.currentNullable)
+              this._alterColumn(knex, table, op.column, op.definition, op.currentNullable)
               break
           }
         }
@@ -739,8 +739,9 @@ class Migration {
 
       // Apply default value change if specified
       if (op.definition.default !== undefined) {
-        if (op.definition.default === 'now()') {
-          await knex.raw(`ALTER TABLE ?? ALTER COLUMN ?? SET DEFAULT now()`, [tableName, op.column])
+        const lower = String(op.definition.default).toLowerCase().trim()
+        if (lower === 'now()' || lower === 'current_timestamp' || lower === 'current_timestamp()') {
+          await knex.raw(`ALTER TABLE ?? ALTER COLUMN ?? SET DEFAULT ${lower}`, [tableName, op.column])
         } else {
           await knex.raw(`ALTER TABLE ?? ALTER COLUMN ?? SET DEFAULT ?`, [tableName, op.column, op.definition.default])
         }
@@ -915,7 +916,27 @@ class Migration {
    * @param {object} table - Knex TableBuilder instance
    * @param {object} columns - Column definition map
    */
-  _buildColumns(table, columns) {
+  /**
+   * Resolves a column default value, wrapping special SQL keywords in knex.raw().
+   * Why: Knex.defaultTo() quotes string values by default. For keywords like
+   * CURRENT_TIMESTAMP, this results in 'CURRENT_TIMESTAMP' which MySQL rejects.
+   * Wrapping in knex.raw() ensures the keyword is emitted without quotes.
+   * @param {object} knex - Knex instance
+   * @param {*} value - Raw default value from schema
+   * @returns {*} Resolved value (possibly knex.raw)
+   */
+  _resolveDefault(knex, value) {
+    if (typeof value !== 'string') return value
+
+    const lower = value.toLowerCase().trim()
+    if (lower === 'current_timestamp' || lower === 'current_timestamp()' || lower === 'now()') {
+      return knex.raw(value)
+    }
+
+    return value
+  }
+
+  _buildColumns(knex, table, columns) {
     if (!columns) return
 
     for (const [colName, def] of Object.entries(columns)) {
@@ -930,7 +951,7 @@ class Migration {
       if (def.nullable === false) col.notNullable()
       else if (def.nullable === true) col.nullable()
 
-      if (def.default !== undefined) col.defaultTo(def.default)
+      if (def.default !== undefined) col.defaultTo(this._resolveDefault(knex, def.default))
       if (def.unsigned) col.unsigned()
       // Column-level unique is handled via _normalizeSchema → _buildIndexes.
       // Applying it here as well would create duplicate constraints.
@@ -1019,14 +1040,14 @@ class Migration {
    * @param {string} colName - Column name
    * @param {object} def - Column definition
    */
-  _addColumn(table, colName, def) {
+  _addColumn(knex, table, colName, def) {
     const col = this._createColumnBuilder(table, colName, def)
     if (!col) return
 
     if (def.nullable === false) col.notNullable()
     else col.nullable()
 
-    if (def.default !== undefined) col.defaultTo(def.default)
+    if (def.default !== undefined) col.defaultTo(this._resolveDefault(knex, def.default))
     if (def.unsigned) col.unsigned()
     if (def.references) col.references(def.references.column).inTable(def.references.table)
     if (def.onDelete) col.onDelete(def.onDelete)
@@ -1039,7 +1060,7 @@ class Migration {
    * @param {string} colName - Column name
    * @param {object} def - Column definition
    */
-  _alterColumn(table, colName, def, currentNullable) {
+  _alterColumn(knex, table, colName, def, currentNullable) {
     const col = this._createColumnBuilder(table, colName, def)
     if (!col) return
 
@@ -1052,7 +1073,7 @@ class Migration {
     else if (currentNullable === false) col.notNullable()
     else if (currentNullable === true) col.nullable()
 
-    if (def.default !== undefined) col.defaultTo(def.default)
+    if (def.default !== undefined) col.defaultTo(this._resolveDefault(knex, def.default))
 
     col.alter()
   }

package/src/Mail.js

@@ -317,6 +317,62 @@ class Mail {
     return '=?UTF-8?B?' + Buffer.from(text).toString('base64') + '?='
   }
 
+  #wrapLines(content, limit = 76) {
+    if (!content) return ''
+    const normalized = content.replace(/\r\n/g, '\n').replace(/\r/g, '\n')
+    const out = []
+    for (const line of normalized.split('\n')) {
+      if (Buffer.byteLength(line, 'utf8') <= limit) {
+        out.push(line)
+        continue
+      }
+      let buf = ''
+      let bufBytes = 0
+      const flush = () => {
+        if (buf.length) out.push(buf)
+        buf = ''
+        bufBytes = 0
+      }
+      for (const word of line.split(/(\s+)/)) {
+        if (!word) continue
+        const wordBytes = Buffer.byteLength(word, 'utf8')
+        if (bufBytes + wordBytes <= limit) {
+          buf += word
+          bufBytes += wordBytes
+          continue
+        }
+        if (buf.length && /^\s+$/.test(word)) {
+          flush()
+          continue
+        }
+        if (buf.length) flush()
+        if (wordBytes <= limit) {
+          buf = word
+          bufBytes = wordBytes
+          continue
+        }
+        let chunk = ''
+        let chunkBytes = 0
+        for (const ch of word) {
+          const chBytes = Buffer.byteLength(ch, 'utf8')
+          if (chunkBytes + chBytes > limit) {
+            out.push(chunk)
+            chunk = ''
+            chunkBytes = 0
+          }
+          chunk += ch
+          chunkBytes += chBytes
+        }
+        if (chunk.length) {
+          buf = chunk
+          bufBytes = chunkBytes
+        }
+      }
+      flush()
+    }
+    return out.join('\r\n')
+  }
+
   #stripHtml(html) {
     if (!html) return ''
 
@@ -376,6 +432,11 @@ class Mail {
             }
           }
 
+          // RFC 5321 §4.5.3.1.6: SMTP lines must be ≤1000 octets including CRLF.
+          // Wrap to 990 chars for HTML and 76 for text to prevent SMTP rejection.
+          htmlContent = this.#wrapLines(htmlContent, 990)
+          textContent = this.#wrapLines(textContent)
+
           if (!this.#header['From']) this.#header['From'] = `${this.#encode(this.#from.name)} <${this.#from.email}>`
           if (!this.#header['To']) {
             const t = this.#to.value[0]

package/src/Route/Cron.js

@@ -104,6 +104,15 @@ class Cron {
     }
   }
 
+  /**
+   * Removes all cron jobs registered from a given route file.
+   * Called before hot-reloading a route file to prevent duplicate cron registrations.
+   */
+  clear(route) {
+    if (!route) return
+    this.#jobs = this.#jobs.filter(job => job.route !== route)
+  }
+
   job(controller) {
     let path
     if (typeof controller !== 'function') {
@@ -114,6 +123,7 @@ class Cron {
       }
     }
     this.#jobs.push({
+      route: global.Odac?.Route?.buff || null,
       controller: typeof controller === 'function' ? null : controller,
       lastRun: null,
       condition: [],

package/src/Route.js

@@ -452,6 +452,7 @@ class Route {
 
         if (!routes2[Odac.Route.buff] || routes2[Odac.Route.buff] < mtime - 1000) {
           delete require.cache[require.resolve(filePath)]
+          Cron.clear(Odac.Route.buff)
           routes2[Odac.Route.buff] = mtime
           const routeModule = require(filePath)
           if (typeof routeModule === 'function') {