millas 0.2.12-beta-1 → 0.2.12-beta-2

package/src/i18n/defaults.js

@@ -0,0 +1,122 @@
+'use strict';
+
+/**
+ * Millas framework default translatable strings.
+ *
+ * These are the strings used internally by Millas — validation messages,
+ * auth errors, admin panel labels, migration prompts, etc.
+ *
+ * When a developer runs `millas lang:publish sw --defaults`, these keys
+ * are merged into their locale file alongside their own app strings.
+ *
+ * Organised by module so translators know the context.
+ * All values are the English source text — same key = same value for 'en'.
+ *
+ * Format:
+ *   'key':              'English source text'   — simple string
+ *   'key':              ['singular', 'plural']  — plural form
+ *   'context|key':      'English source text'   — contextual
+ */
+module.exports = {
+
+  // ── Validation ─────────────────────────────────────────────────────────
+  'This field is required.':                        'This field is required.',
+  'Maximum {max} characters allowed.':              'Maximum {max} characters allowed.',
+  'Must be a whole number.':                        'Must be a whole number.',
+  'Must be a number.':                              'Must be a number.',
+  'Must be a valid email address.':                 'Must be a valid email address.',
+  'Must be a valid URL.':                           'Must be a valid URL.',
+  'Must be a valid date (YYYY-MM-DD).':             'Must be a valid date (YYYY-MM-DD).',
+  'Must be valid JSON.':                            'Must be valid JSON.',
+  'Must be a valid UUID.':                          'Must be a valid UUID.',
+  'Please select a value.':                         'Please select a value.',
+  'Please select a related record.':                'Please select a related record.',
+  'Invalid value. Must be one of: {values}':        'Invalid value. Must be one of: {values}',
+  'Password must be at least 8 characters.':        'Password must be at least 8 characters.',
+
+  // ── Auth ───────────────────────────────────────────────────────────────
+  'Email is required':                              'Email is required',
+  'Password is required':                           'Password is required',
+  'Invalid email or password':                      'Invalid email or password',
+  'Your account has been deactivated':              'Your account has been deactivated',
+  'Email already in use':                           'Email already in use',
+  'Passwords do not match':                         'Passwords do not match',
+  'Token has expired':                              'Token has expired',
+  'Invalid token':                                  'Invalid token',
+  'You are not authorized to perform this action':  'You are not authorized to perform this action',
+
+  // ── HTTP errors ────────────────────────────────────────────────────────
+  'Not Found':                                      'Not Found',
+  'Unauthorized':                                   'Unauthorized',
+  'Forbidden':                                      'Forbidden',
+  'Unprocessable Entity':                           'Unprocessable Entity',
+  'Internal Server Error':                          'Internal Server Error',
+  'Too Many Requests':                              'Too Many Requests',
+  '{model} #{id} not found':                        '{model} #{id} not found',
+
+  // ── Pagination ─────────────────────────────────────────────────────────
+  'Showing {from} to {to} of {total} results':      'Showing {from} to {to} of {total} results',
+  'Previous':                                       'Previous',
+  'Next':                                           'Next',
+  'Page {page} of {total}':                         'Page {page} of {total}',
+
+  // ── CRUD ───────────────────────────────────────────────────────────────
+  '{model} created successfully':                   '{model} created successfully',
+  '{model} updated successfully':                   '{model} updated successfully',
+  '{model} deleted':                                '{model} deleted',
+  'No records found':                               'No records found',
+  'Record not found':                               'Record not found',
+
+  // ── Plural CRUD ────────────────────────────────────────────────────────
+  '{count} record deleted':               ['{count} record deleted',    '{count} records deleted'],
+  '{count} record updated':               ['{count} record updated',    '{count} records updated'],
+
+  // ── Admin panel ────────────────────────────────────────────────────────
+  'Dashboard':                                      'Dashboard',
+  'Search':                                         'Search',
+  'Filters':                                        'Filters',
+  'Actions':                                        'Actions',
+  'Export CSV':                                     'Export CSV',
+  'Export JSON':                                    'Export JSON',
+  'Save':                                           'Save',
+  'Save and continue editing':                      'Save and continue editing',
+  'Save and add another':                           'Save and add another',
+  'Delete':                                         'Delete',
+  'Cancel':                                         'Cancel',
+  'Edit':                                           'Edit',
+  'Add {model}':                                    'Add {model}',
+  'Change {model}':                                 'Change {model}',
+  'Delete {model}':                                 'Delete {model}',
+  'Are you sure you want to delete {label}?':       'Are you sure you want to delete {label}?',
+  'This action cannot be undone.':                  'This action cannot be undone.',
+  'No {model} yet':                                 'No {model} yet',
+  'Select all':                                     'Select all',
+  'Deselect all':                                   'Deselect all',
+
+  // ── Admin status badges (contextual) ───────────────────────────────────
+  'status|active':                                  'Active',
+  'status|inactive':                                'Inactive',
+  'status|pending':                                 'Pending',
+  'status|approved':                                'Approved',
+  'status|rejected':                                'Rejected',
+  'status|draft':                                   'Draft',
+  'status|published':                               'Published',
+
+  // ── Admin login ────────────────────────────────────────────────────────
+  'Sign in to your account':                        'Sign in to your account',
+  'Email address':                                  'Email address',
+  'Password':                                       'Password',
+  'Remember me':                                    'Remember me',
+  'Sign in':                                        'Sign in',
+  'Sign out':                                       'Sign out',
+  'You have been logged out.':                      'You have been logged out.',
+
+  // ── Migration prompts ──────────────────────────────────────────────────
+  'No changes detected.':                           'No changes detected.',
+  'Migrations generated:':                          'Migrations generated:',
+  'Run: millas migrate   to apply.':                'Run: millas migrate   to apply.',
+
+  // ── Queue ──────────────────────────────────────────────────────────────
+  'Job failed: {message}':                          'Job failed: {message}',
+  'Job completed: {job}':                           'Job completed: {job}',
+};

package/src/i18n/index.js

@@ -0,0 +1,164 @@
+'use strict';
+
+const Translator = require('./Translator');
+
+/**
+ * Trans — global translation singleton + shorthand helpers.
+ *
+ * This is the object you import in controllers, models, views, and commands.
+ * It wraps the Translator instance with the Django-style shorthand functions.
+ *
+ * ── Import styles ──────────────────────────────────────────────────────────
+ *
+ *   // Named destructuring (recommended)
+ *   const { __, _n, _p, _f } = require('millas/src/i18n');
+ *
+ *   // Full facade for locale control
+ *   const { Trans } = require('millas/src/i18n');
+ *   Trans.setLocale('sw');
+ *
+ * ── API ────────────────────────────────────────────────────────────────────
+ *
+ *   __('Hello')
+ *   → 'Habari'   (when locale=sw)
+ *   → 'Hello'    (when locale=en or no translation found)
+ *
+ *   _n('You have %d message', 'You have %d messages', 3)
+ *   → 'Una ujumbe 3'
+ *
+ *   _p('menu', 'File')
+ *   → 'Faili'   (contextual — same word, different contexts)
+ *
+ *   _f('Welcome, {name}!', { name: 'Alice' })
+ *   → 'Karibu, Alice!'
+ *
+ *   _f('Hello %s, you have %d items', 'Alice', 5)
+ *   → 'Habari Alice, una vitu 5'
+ *
+ *   _fn('You have %d item', 'You have %d items', 3)
+ *   → 'Una vitu 3'
+ *
+ * ── In templates (Nunjucks) ────────────────────────────────────────────────
+ *
+ *   Add the filters via I18nServiceProvider (done automatically):
+ *
+ *   {{ 'Hello' | __ }}
+ *   {{ 'You have %d messages' | _n(count) }}
+ *   {{ 'Welcome, {name}!' | _f({ name: user.name }) }}
+ *
+ * ── In CLI commands ────────────────────────────────────────────────────────
+ *
+ *   const { __ } = require('millas/src/i18n');
+ *   console.log(__('Migrations applied successfully.'));
+ */
+
+// ── Singleton Translator instance ────────────────────────────────────────────
+const Trans = new Translator();
+
+// ── Shorthand functions ───────────────────────────────────────────────────────
+
+/**
+ * gettext — translate a string.
+ *
+ *   __('Hello')
+ *   __('Hello', 'sw')    // explicit locale override
+ *
+ * @param {string} key
+ * @param {string} [locale]
+ * @returns {string}
+ */
+function __(key, locale) {
+  return Trans.translate(key, locale);
+}
+
+/**
+ * ngettext — singular/plural translation.
+ *
+ *   _n('You have %d message', 'You have %d messages', count)
+ *
+ * Note: this does NOT interpolate %d — call _fn() if you also need
+ * the count substituted into the string.
+ *
+ * @param {string} singular
+ * @param {string} plural
+ * @param {number} count
+ * @param {string} [locale]
+ * @returns {string}
+ */
+function _n(singular, plural, count, locale) {
+  return Trans.ngettext(singular, plural, count, locale);
+}
+
+/**
+ * pgettext — contextual translation.
+ *
+ *   _p('menu', 'File')     // the menu item "File"
+ *   _p('action', 'File')   // the action "to file something"
+ *
+ * @param {string} context
+ * @param {string} key
+ * @param {string} [locale]
+ * @returns {string}
+ */
+function _p(context, key, locale) {
+  return Trans.pgettext(context, key, locale);
+}
+
+/**
+ * format — translate + interpolate named or positional variables.
+ *
+ *   _f('Welcome, {name}!', { name: 'Alice' })
+ *   _f('Hello %s, you have %d items', 'Alice', 5)
+ *
+ * @param {string} key
+ * @param {...*}   args
+ * @returns {string}
+ */
+function _f(key, ...args) {
+  return Trans.format(key, ...args);
+}
+
+/**
+ * nformat — plural translation + interpolation.
+ *
+ *   _fn('You have %d item', 'You have %d items', count)
+ *   // → 'You have 3 items'  (count is auto-interpolated as first %d)
+ *
+ * @param {string} singular
+ * @param {string} plural
+ * @param {number} count
+ * @param {...*}   args  — additional interpolation values after count
+ * @returns {string}
+ */
+function _fn(singular, plural, count, ...args) {
+  return Trans.nformat(singular, plural, count, ...args);
+}
+
+/**
+ * lazy — returns a lazy-evaluated translation proxy.
+ *
+ * Useful when the translation needs to be stored before the locale is set
+ * (e.g. in class-level constants, model field labels).
+ *
+ *   const label = lazy__('Email address');
+ *   // label() → 'Anwani ya barua pepe'   (evaluated at call time)
+ *
+ * @param {string} key
+ * @returns {Function}
+ */
+function lazy__(key) {
+  return () => Trans.translate(key);
+}
+
+module.exports = {
+  // Singleton for locale control + advanced usage
+  Trans,
+
+  // Shorthand functions
+  __,
+  _n,
+  _p,
+  _f,
+  _fn,
+  lazy__,
+};

package/src/i18n/locales/en.js

@@ -0,0 +1,55 @@
+'use strict';
+
+/**
+ * English (en) — source language catalogue.
+ *
+ * For the source language this file acts as documentation:
+ * it lists every translatable string in the application.
+ * Values are the same as keys — no actual translation needed.
+ *
+ * Other locale files only need to include keys where the translation
+ * differs. Missing keys fall back to this file, then to the raw key.
+ *
+ * ── Auth ──────────────────────────────────────────────────────────────────
+ */
+module.exports = {
+
+  // ── Auth / validation ────────────────────────────────────────────────────
+  'Email is required':                      'Email is required',
+  'Password is required':                   'Password is required',
+  'Invalid email or password':              'Invalid email or password',
+  'Your account has been deactivated':      'Your account has been deactivated',
+  'Email already in use':                   'Email already in use',
+  'Password must be at least 8 characters': 'Password must be at least 8 characters',
+  'Passwords do not match':                 'Passwords do not match',
+
+  // ── CRUD messages ────────────────────────────────────────────────────────
+  '%s created successfully':                '%s created successfully',
+  '%s updated successfully':                '%s updated successfully',
+  '%s deleted':                             '%s deleted',
+  'No records found':                       'No records found',
+  'Record not found':                       'Record not found',
+
+  // ── Pagination ───────────────────────────────────────────────────────────
+  'Showing %d to %d of %d results':         'Showing %d to %d of %d results',
+  'Previous':                               'Previous',
+  'Next':                                   'Next',
+
+  // ── Plural examples ──────────────────────────────────────────────────────
+  // Array format: [singular_form, plural_form, ...]
+  'You have %d message':                    ['You have %d message',  'You have %d messages'],
+  '%d item selected':                       ['%d item selected',     '%d items selected'],
+  '%d record deleted':                      ['%d record deleted',    '%d records deleted'],
+
+  // ── Contextual examples (context|key) ────────────────────────────────────
+  'menu|File':                              'File',
+  'menu|Edit':                              'Edit',
+  'status|active':                          'Active',
+  'status|inactive':                        'Inactive',
+  'status|pending':                         'Pending',
+
+  // ── Named interpolation examples ─────────────────────────────────────────
+  'Welcome, {name}!':                       'Welcome, {name}!',
+  'Hello, {name}. You have {count} notifications.':
+    'Hello, {name}. You have {count} notifications.',
+};

package/src/i18n/locales/sw.js

@@ -0,0 +1,48 @@
+'use strict';
+
+/**
+ * Swahili (sw) translation catalogue.
+ *
+ * Only include keys where the translation differs from the source.
+ * Missing keys automatically fall back to the fallback locale (en).
+ */
+module.exports = {
+
+  // ── Auth / validation ────────────────────────────────────────────────────
+  'Email is required':                      'Barua pepe inahitajika',
+  'Password is required':                   'Nywila inahitajika',
+  'Invalid email or password':              'Barua pepe au nywila si sahihi',
+  'Your account has been deactivated':      'Akaunti yako imezimwa',
+  'Email already in use':                   'Barua pepe hiyo tayari inatumika',
+  'Password must be at least 8 characters': 'Nywila lazima iwe na herufi angalau 8',
+  'Passwords do not match':                 'Nywila hazifanani',
+
+  // ── CRUD messages ────────────────────────────────────────────────────────
+  '%s created successfully':                '%s imeundwa kikamilifu',
+  '%s updated successfully':                '%s imesasishwa kikamilifu',
+  '%s deleted':                             '%s imefutwa',
+  'No records found':                       'Hakuna rekodi zilizopatikana',
+  'Record not found':                       'Rekodi haijapatikana',
+
+  // ── Pagination ───────────────────────────────────────────────────────────
+  'Showing %d to %d of %d results':         'Inaonyesha %d hadi %d kati ya %d matokeo',
+  'Previous':                               'Iliyotangulia',
+  'Next':                                   'Inayofuata',
+
+  // ── Plural forms (Swahili uses same form for all counts) ─────────────────
+  'You have %d message':                    ['Una ujumbe %d', 'Una ujumbe %d'],
+  '%d item selected':                       ['%d kipengele kimechaguliwa', '%d vipengele vimechaguliwa'],
+  '%d record deleted':                      ['Rekodi %d imefutwa', 'Rekodi %d zimefutwa'],
+
+  // ── Contextual ───────────────────────────────────────────────────────────
+  'menu|File':      'Faili',
+  'menu|Edit':      'Hariri',
+  'status|active':  'Amilifu',
+  'status|inactive':'Haifanyi kazi',
+  'status|pending': 'Inasubiri',
+
+  // ── Named interpolation ──────────────────────────────────────────────────
+  'Welcome, {name}!':  'Karibu, {name}!',
+  'Hello, {name}. You have {count} notifications.':
+    'Habari {name}. Una arifa {count}.',
+};

package/src/logger/formatters/PrettyFormatter.js

@@ -1,98 +1,134 @@
 'use strict';
 
-const { LEVEL_NAMES, LEVEL_TAGS, LEVEL_COLOURS, RESET, BOLD, DIM } = require('../levels');
-
-/**
- * PrettyFormatter
- *
- * Colourful, human-readable output. Designed for development.
- * Inspired by Timber (Android) and Laravel's log formatting.
- *
- * Output:
- *   [2026-03-15 12:00:00] I  UserController  User #5 logged in
- *   [2026-03-15 12:00:01] E  Database        Connection refused  { host: 'localhost' }
- *   [2026-03-15 12:00:02] W  Auth            Token expiring soon
- *
- * WTF level also prints the full stack trace.
- */
+const { LEVEL_TAGS, LEVEL_COLOURS, RESET, BOLD } = require('../levels');
+
+const SEP = '  ';
+const TAG_WIDTH = 18;
+
+// Matches /absolute/path/to/file.js or /absolute/path/to/file.js:12:34
+const FILE_PATH_RE = /(\/[^\s)'"]+\.(js|ts|json|mjs|cjs)(?::\d+(?::\d+)?)?)/g;
+// Matches http(s):// URLs
+const URL_RE = /(https?:\/\/[^\s)'"]+)/g;
+
+function linkify(text, dim, useColour) {
+  if (!useColour) return text;
+
+  text = text.replace(FILE_PATH_RE, (match) => {
+    const filePath = match.replace(/(:\d+)+$/, '');
+    const uri = `file://${filePath}`;
+    return `${RESET}\x1b]8;;${uri}\x1b\\${match}\x1b]8;;\x1b\\`;
+  });
+
+  text = text.replace(URL_RE, (match) => {
+    return `${RESET}\x1b]8;;${match}\x1b\\${match}\x1b]8;;\x1b\\`;
+  });
+
+  return text;
+}
+
 class PrettyFormatter {
-  /**
-   * @param {object} options
-   * @param {boolean} [options.timestamp=true]    — show timestamp
-   * @param {boolean} [options.tag=true]          — show tag/component name
-   * @param {boolean} [options.colour=true]       — ANSI colour (disable for pipes/files)
-   * @param {string}  [options.timestampFormat]   — 'iso' | 'short' (default: 'short')
-   */
   constructor(options = {}) {
     this.showTimestamp = options.timestamp !== false;
     this.showTag       = options.tag       !== false;
     this.colour        = options.colour    !== false;
     this.tsFormat      = options.timestampFormat || 'short';
+    this.tagWidth      = options.tagWidth || TAG_WIDTH;
   }
 
   format(entry) {
     const { level, tag, message, context, error } = entry;
 
-    const c    = this.colour ? LEVEL_COLOURS[level] : '';
-    const r    = this.colour ? RESET                : '';
-    const b    = this.colour ? BOLD                 : '';
-    const d    = this.colour ? '\x1b[2m'            : '';
-    const lvl  = LEVEL_TAGS[level] || '?';
+    const c   = this.colour ? (LEVEL_COLOURS[level] || '') : '';
+    const r   = this.colour ? RESET     : '';
+    const b   = this.colour ? BOLD      : '';
+    const d   = this.colour ? '\x1b[2m' : '';
+    const lvl = LEVEL_TAGS[level] || '?';
 
-    const parts = [];
+    // ── 1. Measure plain prefix once ─────────────────────────────────────────
+    const ts = this._timestamp();
+    const plainCols = [];
+    if (this.showTimestamp)    plainCols.push(`[${ts}]`);
+    plainCols.push(lvl);
+    if (this.showTag && tag)   plainCols.push(tag.padEnd(this.tagWidth));
 
-    // Timestamp
-    if (this.showTimestamp) {
-      const ts = this._timestamp();
-      parts.push(`${d}[${ts}]${r}`);
-    }
+    const indentWidth = plainCols.join(SEP).length + SEP.length;
+    const indent      = ' '.repeat(indentWidth);
 
-    // Level tag (single letter, coloured)
-    parts.push(`${c}${b}${lvl}${r}`);
+    // ── 2. Coloured prefix ───────────────────────────────────────────────────
+    const colCols = [];
+    if (this.showTimestamp)    colCols.push(`${d}[${ts}]${r}`);
+    colCols.push(`${c}${b}${lvl}${r}`);
+    if (this.showTag && tag)   colCols.push(`${b}${tag.padEnd(this.tagWidth)}${r}`);
 
-    // Component/tag
-    if (this.showTag && tag) {
-      const tagStr = tag.padEnd(18);
-      parts.push(`${b}${tagStr}${r}`);
-    }
+    const prefix = colCols.join(SEP) + SEP;
 
-    // Message (handle multi-line)
-    const lines = message.split('\n');
-    parts.push(`${c}${lines[0]}${r}`);
+    // ── 3. Terminal width ────────────────────────────────────────────────────
+    const termWidth = (process.stdout.columns || 120);
+    const msgWidth  = termWidth - indentWidth;
 
-    let output = parts.join('  ');
+    // ── 4. Collect all logical lines ─────────────────────────────────────────
+    const logicalLines = [];
 
-    // Continuation lines (aligned with first line)
-    if (lines.length > 1) {
-      const prefix = parts.slice(0, -1).map(p => p.replace(/\x1b\[[0-9;]*m/g, '')).join('  ');
-      const indent = ' '.repeat(prefix.length + 2);
-      for (let i = 1; i < lines.length; i++) {
-        output += `\n${indent}${c}${lines[i]}${r}`;
-      }
-    }
+    for (const l of String(message).split('\n')) logicalLines.push({ text: l, dim: false });
 
-    // Context object
-    if (context !== undefined && context !== null) {
-      const ctx = typeof context === 'object'
-        ? JSON.stringify(context, null, 0)
-        : String(context);
-      output += `  ${d}${ctx}${r}`;
+    if (context != null) {
+      const ctx = typeof context === 'object' ? JSON.stringify(context) : String(context);
+      logicalLines.push({ text: ctx, dim: true });
     }
 
-    // Error stack
     if (error instanceof Error) {
-      output += `\n${d}${error.stack || error.message}${r}`;
+      for (const l of (error.stack || error.message).split('\n'))
+        logicalLines.push({ text: l, dim: true });
+    }
+
+    // ── 5. Hard-wrap (skip stack frames so paths stay intact) ────────────────
+    const wrappedLines = [];
+
+    for (const { text, dim } of logicalLines) {
+      const isStackFrame = dim && /^\s*at /.test(text);
+
+      if (isStackFrame || text.length <= msgWidth) {
+        wrappedLines.push({ text, dim });
+        continue;
+      }
+
+      const words = text.split(' ');
+      let chunk = '';
+      for (const word of words) {
+        if (chunk.length === 0) {
+          if (word.length > msgWidth) {
+            for (let i = 0; i < word.length; i += msgWidth)
+              wrappedLines.push({ text: word.slice(i, i + msgWidth), dim });
+          } else {
+            chunk = word;
+          }
+        } else if (chunk.length + 1 + word.length <= msgWidth) {
+          chunk += ' ' + word;
+        } else {
+          wrappedLines.push({ text: chunk, dim });
+          chunk = word;
+        }
+      }
+      if (chunk.length) wrappedLines.push({ text: chunk, dim });
     }
 
-    // WTF: print big warning banner
+    // ── 6. Render + linkify ───────────────────────────────────────────────────
+    const rendered = wrappedLines.map((line, i) => {
+      const col  = line.dim ? d : c;
+      const text = linkify(line.text, line.dim, this.colour);
+      if (i === 0) return `${prefix}${col}${text}${r}`;
+      return `${indent}${col}${text}${r}`;
+    }).join('\n');
+
+    // ── 7. WTF banner ─────────────────────────────────────────────────────────
     if (level === 5) {
-      const banner = this.colour
+      const bar = this.colour
         ? `\x1b[35m\x1b[1m${'━'.repeat(60)}\x1b[0m`
         : '━'.repeat(60);
-      output = `${banner}\n${output}\n${banner}`;
+      return `${bar}\n${rendered}\n${bar}`;
     }
 
-    return output;
+    return rendered;
   }
 
   _timestamp() {
@@ -102,4 +138,4 @@ class PrettyFormatter {
   }
 }
 
-module.exports = PrettyFormatter;
+module.exports = PrettyFormatter;

package/src/migrations/system/0001_users.js

@@ -0,0 +1,21 @@
+'use strict';
+
+/**
+ * System migration: 0001_users
+ *
+ * Previously created the users table directly.
+ *
+ * As of Millas 0.3+, the users table is owned by the APP — not the framework.
+ * AuthUser is now fully abstract (no table). The app defines its own User model
+ * that extends AuthUser and owns whatever table it wants (typically 'users').
+ *
+ * This migration is kept as a no-op so existing projects that depend on
+ * ['system', '0001_users'] don't break. It creates nothing.
+ *
+ * Equivalent to Django's pattern: AbstractUser has no table; your custom
+ * User model creates its own table via app migrations.
+ */
+module.exports = {
+  dependencies: [],
+  operations:   [],
+};

package/src/migrations/system/0002_admin_log.js

@@ -0,0 +1,25 @@
+'use strict';
+
+const { CreateModel } = require('../../orm/migration/operations');
+
+/**
+ * System migration: millas_admin_log
+ * Equivalent to Django's django_admin_log.
+ */
+module.exports = {
+  dependencies: [['system', '0001_users']],
+
+  operations: [
+    new CreateModel('millas_admin_log', {
+      id:         { type: 'id',        unsigned: true,  nullable: false, unique: false, default: null, max: null, enumValues: null, references: null, precision: null, scale: null },
+      user_id:    { type: 'integer',   unsigned: true,  nullable: true,  unique: false, default: null, max: null, enumValues: null, references: { table: 'users', column: 'id', onDelete: 'SET NULL' }, precision: null, scale: null },
+      user_email: { type: 'string',    max: 255,        nullable: true,  unique: false, default: null, unsigned: false, enumValues: null, references: null, precision: null, scale: null },
+      resource:   { type: 'string',    max: 100,        nullable: false, unique: false, default: null, unsigned: false, enumValues: null, references: null, precision: null, scale: null },
+      record_id:  { type: 'string',    max: 100,        nullable: true,  unique: false, default: null, unsigned: false, enumValues: null, references: null, precision: null, scale: null },
+      action:     { type: 'enum',      enumValues: ['create','update','delete'], nullable: false, unique: false, default: null, max: null, unsigned: false, references: null, precision: null, scale: null },
+      label:      { type: 'string',    max: 255,        nullable: true,  unique: false, default: null, unsigned: false, enumValues: null, references: null, precision: null, scale: null },
+      change_msg: { type: 'text',      nullable: true,  unique: false, default: null, max: null, unsigned: false, enumValues: null, references: null, precision: null, scale: null },
+      created_at: { type: 'timestamp', nullable: true,  unique: false, default: null, max: null, unsigned: false, enumValues: null, references: null, precision: null, scale: null },
+    }),
+  ],
+};