tina4-nodejs 3.13.124 → 3.13.125

package/CLAUDE.md

@@ -13,13 +13,13 @@ Even if the skill text is not currently loaded, these are non-negotiable:
 
 The full discipline lives in `.claude/skills/tina4-maintainer/SKILL.md`; this block is the always-on floor.
 
-# CLAUDE.md - AI Developer Guide for tina4-nodejs (v3.13.124)
+# CLAUDE.md - AI Developer Guide for tina4-nodejs (v3.13.125)
 
 > This file helps AI assistants (Claude, Copilot, Cursor, etc.) understand and work on this codebase effectively.
 
 ## What This Project Is
 
-Tina4 for Node.js/TypeScript v3.13.124 - The Intelligent Native Application 4ramework. A convention-over-configuration structural paradigm. The developer writes TypeScript; Tina4 is invisible infrastructure.
+Tina4 for Node.js/TypeScript v3.13.125 - The Intelligent Native Application 4ramework. A convention-over-configuration structural paradigm. The developer writes TypeScript; Tina4 is invisible infrastructure.
 
 The philosophy: zero ceremony, batteries included, file system as source of truth.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tina4-nodejs",
-  "version": "3.13.124",
+  "version": "3.13.125",
   "type": "module",
   "description": "Tina4 for Node.js/TypeScript - native TypeScript conventions and shared Tina4 contracts",
   "keywords": [

package/packages/cli/dist/bin.js

@@ -6375,6 +6375,38 @@ var init_sqlTranslator = __esm({
             return sql;
         }
       }
+      /**
+       * Translate SQLite-canonical DDL column TYPES + CREATE-TABLE options to the
+       * target engine.
+       *
+       * ONLY acts on `CREATE TABLE` / `ALTER TABLE` statements, so a query or INSERT
+       * that happens to contain the word `TEXT` (a column name, a string literal) is
+       * never rewritten. Complements `autoIncrementSyntax` (which maps the id
+       * keyword) so ONE portable migration — and every `Model.createTable()` DDL,
+       * which is also SQLite-canonical — applies on every engine instead of failing
+       * on Firebird/MSSQL.
+       *
+       *   * Firebird has no `TEXT` (-607), no `REAL`, and no `CREATE TABLE IF NOT
+       *     EXISTS`.
+       *   * MSSQL has no `CREATE TABLE IF NOT EXISTS` and its `TIMESTAMP` is a
+       *     rowversion, not a datetime — a `created_at TIMESTAMP` there is wrong.
+       *   * MySQL's `TIMESTAMP` carries auto-update / 2038 surprises, so a datetime
+       *     column maps to `DATETIME` (matching the adapters' createTableAsync).
+       */
+      static ddlTypes(sql, engine) {
+        const head = sql.replace(/^(?:\s*--[^\n]*\n)+/, "");
+        if (!/^\s*(?:CREATE\s+TABLE|ALTER\s+TABLE)\b/i.test(head)) return sql;
+        switch ((engine ?? "").toLowerCase()) {
+          case "firebird":
+            return sql.replace(/\bIF\s+NOT\s+EXISTS\b/gi, "").replace(/\bBLOB\s+SUB_TYPE\s+TEXT\b/gi, "\0FBTEXT\0").replace(/\bTEXT\b/gi, "BLOB SUB_TYPE TEXT").replaceAll("\0FBTEXT\0", "BLOB SUB_TYPE TEXT").replace(/\bREAL\b/gi, "DOUBLE PRECISION");
+          case "mssql":
+            return sql.replace(/\bIF\s+NOT\s+EXISTS\b/gi, "").replace(/\bTIMESTAMP\b/gi, "DATETIME2");
+          case "mysql":
+            return sql.replace(/\bTIMESTAMP\b/gi, "DATETIME");
+          default:
+            return sql;
+        }
+      }
       /**
        * Convert ? placeholders to engine-specific style.
        *
@@ -8416,6 +8448,8 @@ var init_mysql = __esm({
       translateSql(sql) {
         let translated = SQLTranslator.concatPipesToFunc(sql);
         translated = SQLTranslator.ilikeToLike(translated);
+        translated = SQLTranslator.autoIncrementSyntax(translated, "mysql");
+        translated = SQLTranslator.ddlTypes(translated, "mysql");
         return translated;
       }
       execute(sql, params) {
@@ -8837,6 +8871,8 @@ var init_mssql = __esm({
         let translated = SQLTranslator.limitToTop(sql);
         translated = SQLTranslator.concatPipesToFunc(translated);
         translated = SQLTranslator.ilikeToLike(translated);
+        translated = SQLTranslator.autoIncrementSyntax(translated, "mssql");
+        translated = SQLTranslator.ddlTypes(translated, "mssql");
         return translated;
       }
       execSqlPromise(sql, params) {
@@ -9467,6 +9503,8 @@ var init_firebird = __esm({
         let translated = SQLTranslator.limitToRows(sql);
         translated = SQLTranslator.booleanToInt(translated);
         translated = SQLTranslator.ilikeToLike(translated);
+        translated = SQLTranslator.autoIncrementSyntax(translated, "firebird");
+        translated = SQLTranslator.ddlTypes(translated, "firebird");
         return translated;
       }
       /**
@@ -25048,7 +25086,7 @@ function generateMigration(name, flags, fieldsOverride, tableOverride, emitTest
       const defaultClause = info.defaultVal !== "NULL" ? ` DEFAULT ${info.defaultVal}` : "";
       colLines.push(`    ${fname} ${info.sql}${defaultClause}`);
     }
-    colLines.push("    created_at TEXT DEFAULT CURRENT_TIMESTAMP");
+    colLines.push("    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP");
     upSql = `CREATE TABLE IF NOT EXISTS ${table2} (
     -- tina4:edit  add columns beyond id + created_at
 ${colLines.join(",\n")}
@@ -26191,8 +26229,8 @@ var init_generate = __esm({
   "src/commands/generate.ts"() {
     "use strict";
     FIELD_TYPE_MAP = {
-      string: { orm: '"string"', sql: "TEXT", defaultVal: "''" },
-      str: { orm: '"string"', sql: "TEXT", defaultVal: "''" },
+      string: { orm: '"string"', sql: "VARCHAR(255)", defaultVal: "''" },
+      str: { orm: '"string"', sql: "VARCHAR(255)", defaultVal: "''" },
       int: { orm: '"integer"', sql: "INTEGER", defaultVal: "0" },
       integer: { orm: '"integer"', sql: "INTEGER", defaultVal: "0" },
       float: { orm: '"number"', sql: "REAL", defaultVal: "0" },
@@ -26202,7 +26240,7 @@ var init_generate = __esm({
       bool: { orm: '"boolean"', sql: "INTEGER", defaultVal: "0" },
       boolean: { orm: '"boolean"', sql: "INTEGER", defaultVal: "0" },
       text: { orm: '"string"', sql: "TEXT", defaultVal: "''" },
-      datetime: { orm: '"datetime"', sql: "TEXT", defaultVal: "NULL" },
+      datetime: { orm: '"datetime"', sql: "TIMESTAMP", defaultVal: "NULL" },
       blob: { orm: '"string"', sql: "BLOB", defaultVal: "NULL" }
     };
     SQL_RESERVED_TABLE_NAMES = /* @__PURE__ */ new Set([

package/packages/cli/src/commands/generate.ts

@@ -37,8 +37,8 @@ import { join, relative, resolve, sep } from "node:path";
 
 // ── Field type mapping ──────────────────────────────────────────────
 const FIELD_TYPE_MAP: Record<string, { orm: string; sql: string; defaultVal: string }> = {
-  string:   { orm: '"string"',   sql: "TEXT",    defaultVal: "''" },
-  str:      { orm: '"string"',   sql: "TEXT",    defaultVal: "''" },
+  string:   { orm: '"string"',   sql: "VARCHAR(255)", defaultVal: "''" },
+  str:      { orm: '"string"',   sql: "VARCHAR(255)", defaultVal: "''" },
   int:      { orm: '"integer"',  sql: "INTEGER", defaultVal: "0" },
   integer:  { orm: '"integer"',  sql: "INTEGER", defaultVal: "0" },
   float:    { orm: '"number"',   sql: "REAL",    defaultVal: "0" },
@@ -48,7 +48,7 @@ const FIELD_TYPE_MAP: Record<string, { orm: string; sql: string; defaultVal: str
   bool:     { orm: '"boolean"',  sql: "INTEGER", defaultVal: "0" },
   boolean:  { orm: '"boolean"',  sql: "INTEGER", defaultVal: "0" },
   text:     { orm: '"string"',   sql: "TEXT",    defaultVal: "''" },
-  datetime: { orm: '"datetime"', sql: "TEXT",    defaultVal: "NULL" },
+  datetime: { orm: '"datetime"', sql: "TIMESTAMP", defaultVal: "NULL" },
   blob:     { orm: '"string"',   sql: "BLOB",    defaultVal: "NULL" },
 };
 
@@ -1269,7 +1269,7 @@ export function generateMigration(
       const defaultClause = info.defaultVal !== "NULL" ? ` DEFAULT ${info.defaultVal}` : "";
       colLines.push(`    ${fname} ${info.sql}${defaultClause}`);
     }
-    colLines.push("    created_at TEXT DEFAULT CURRENT_TIMESTAMP");
+    colLines.push("    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP");
 
     upSql =
       `CREATE TABLE IF NOT EXISTS ${table} (\n` +

package/packages/core/dist/index.js

@@ -6374,6 +6374,38 @@ var init_sqlTranslator = __esm({
             return sql;
         }
       }
+      /**
+       * Translate SQLite-canonical DDL column TYPES + CREATE-TABLE options to the
+       * target engine.
+       *
+       * ONLY acts on `CREATE TABLE` / `ALTER TABLE` statements, so a query or INSERT
+       * that happens to contain the word `TEXT` (a column name, a string literal) is
+       * never rewritten. Complements `autoIncrementSyntax` (which maps the id
+       * keyword) so ONE portable migration — and every `Model.createTable()` DDL,
+       * which is also SQLite-canonical — applies on every engine instead of failing
+       * on Firebird/MSSQL.
+       *
+       *   * Firebird has no `TEXT` (-607), no `REAL`, and no `CREATE TABLE IF NOT
+       *     EXISTS`.
+       *   * MSSQL has no `CREATE TABLE IF NOT EXISTS` and its `TIMESTAMP` is a
+       *     rowversion, not a datetime — a `created_at TIMESTAMP` there is wrong.
+       *   * MySQL's `TIMESTAMP` carries auto-update / 2038 surprises, so a datetime
+       *     column maps to `DATETIME` (matching the adapters' createTableAsync).
+       */
+      static ddlTypes(sql, engine) {
+        const head = sql.replace(/^(?:\s*--[^\n]*\n)+/, "");
+        if (!/^\s*(?:CREATE\s+TABLE|ALTER\s+TABLE)\b/i.test(head)) return sql;
+        switch ((engine ?? "").toLowerCase()) {
+          case "firebird":
+            return sql.replace(/\bIF\s+NOT\s+EXISTS\b/gi, "").replace(/\bBLOB\s+SUB_TYPE\s+TEXT\b/gi, "\0FBTEXT\0").replace(/\bTEXT\b/gi, "BLOB SUB_TYPE TEXT").replaceAll("\0FBTEXT\0", "BLOB SUB_TYPE TEXT").replace(/\bREAL\b/gi, "DOUBLE PRECISION");
+          case "mssql":
+            return sql.replace(/\bIF\s+NOT\s+EXISTS\b/gi, "").replace(/\bTIMESTAMP\b/gi, "DATETIME2");
+          case "mysql":
+            return sql.replace(/\bTIMESTAMP\b/gi, "DATETIME");
+          default:
+            return sql;
+        }
+      }
       /**
        * Convert ? placeholders to engine-specific style.
        *
@@ -8415,6 +8447,8 @@ var init_mysql = __esm({
       translateSql(sql) {
         let translated = SQLTranslator.concatPipesToFunc(sql);
         translated = SQLTranslator.ilikeToLike(translated);
+        translated = SQLTranslator.autoIncrementSyntax(translated, "mysql");
+        translated = SQLTranslator.ddlTypes(translated, "mysql");
         return translated;
       }
       execute(sql, params) {
@@ -8836,6 +8870,8 @@ var init_mssql = __esm({
         let translated = SQLTranslator.limitToTop(sql);
         translated = SQLTranslator.concatPipesToFunc(translated);
         translated = SQLTranslator.ilikeToLike(translated);
+        translated = SQLTranslator.autoIncrementSyntax(translated, "mssql");
+        translated = SQLTranslator.ddlTypes(translated, "mssql");
         return translated;
       }
       execSqlPromise(sql, params) {
@@ -9466,6 +9502,8 @@ var init_firebird = __esm({
         let translated = SQLTranslator.limitToRows(sql);
         translated = SQLTranslator.booleanToInt(translated);
         translated = SQLTranslator.ilikeToLike(translated);
+        translated = SQLTranslator.autoIncrementSyntax(translated, "firebird");
+        translated = SQLTranslator.ddlTypes(translated, "firebird");
         return translated;
       }
       /**
@@ -25027,7 +25065,7 @@ function generateMigration(name, flags, fieldsOverride, tableOverride, emitTest
       const defaultClause = info.defaultVal !== "NULL" ? ` DEFAULT ${info.defaultVal}` : "";
       colLines.push(`    ${fname} ${info.sql}${defaultClause}`);
     }
-    colLines.push("    created_at TEXT DEFAULT CURRENT_TIMESTAMP");
+    colLines.push("    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP");
     upSql = `CREATE TABLE IF NOT EXISTS ${table2} (
     -- tina4:edit  add columns beyond id + created_at
 ${colLines.join(",\n")}
@@ -26170,8 +26208,8 @@ var init_generate = __esm({
   "../cli/src/commands/generate.ts"() {
     "use strict";
     FIELD_TYPE_MAP = {
-      string: { orm: '"string"', sql: "TEXT", defaultVal: "''" },
-      str: { orm: '"string"', sql: "TEXT", defaultVal: "''" },
+      string: { orm: '"string"', sql: "VARCHAR(255)", defaultVal: "''" },
+      str: { orm: '"string"', sql: "VARCHAR(255)", defaultVal: "''" },
       int: { orm: '"integer"', sql: "INTEGER", defaultVal: "0" },
       integer: { orm: '"integer"', sql: "INTEGER", defaultVal: "0" },
       float: { orm: '"number"', sql: "REAL", defaultVal: "0" },
@@ -26181,7 +26219,7 @@ var init_generate = __esm({
       bool: { orm: '"boolean"', sql: "INTEGER", defaultVal: "0" },
       boolean: { orm: '"boolean"', sql: "INTEGER", defaultVal: "0" },
       text: { orm: '"string"', sql: "TEXT", defaultVal: "''" },
-      datetime: { orm: '"datetime"', sql: "TEXT", defaultVal: "NULL" },
+      datetime: { orm: '"datetime"', sql: "TIMESTAMP", defaultVal: "NULL" },
       blob: { orm: '"string"', sql: "BLOB", defaultVal: "NULL" }
     };
     SQL_RESERVED_TABLE_NAMES = /* @__PURE__ */ new Set([

package/packages/orm/dist/index.js

@@ -915,6 +915,38 @@ var init_sqlTranslator = __esm({
             return sql;
         }
       }
+      /**
+       * Translate SQLite-canonical DDL column TYPES + CREATE-TABLE options to the
+       * target engine.
+       *
+       * ONLY acts on `CREATE TABLE` / `ALTER TABLE` statements, so a query or INSERT
+       * that happens to contain the word `TEXT` (a column name, a string literal) is
+       * never rewritten. Complements `autoIncrementSyntax` (which maps the id
+       * keyword) so ONE portable migration — and every `Model.createTable()` DDL,
+       * which is also SQLite-canonical — applies on every engine instead of failing
+       * on Firebird/MSSQL.
+       *
+       *   * Firebird has no `TEXT` (-607), no `REAL`, and no `CREATE TABLE IF NOT
+       *     EXISTS`.
+       *   * MSSQL has no `CREATE TABLE IF NOT EXISTS` and its `TIMESTAMP` is a
+       *     rowversion, not a datetime — a `created_at TIMESTAMP` there is wrong.
+       *   * MySQL's `TIMESTAMP` carries auto-update / 2038 surprises, so a datetime
+       *     column maps to `DATETIME` (matching the adapters' createTableAsync).
+       */
+      static ddlTypes(sql, engine) {
+        const head = sql.replace(/^(?:\s*--[^\n]*\n)+/, "");
+        if (!/^\s*(?:CREATE\s+TABLE|ALTER\s+TABLE)\b/i.test(head)) return sql;
+        switch ((engine ?? "").toLowerCase()) {
+          case "firebird":
+            return sql.replace(/\bIF\s+NOT\s+EXISTS\b/gi, "").replace(/\bBLOB\s+SUB_TYPE\s+TEXT\b/gi, "\0FBTEXT\0").replace(/\bTEXT\b/gi, "BLOB SUB_TYPE TEXT").replaceAll("\0FBTEXT\0", "BLOB SUB_TYPE TEXT").replace(/\bREAL\b/gi, "DOUBLE PRECISION");
+          case "mssql":
+            return sql.replace(/\bIF\s+NOT\s+EXISTS\b/gi, "").replace(/\bTIMESTAMP\b/gi, "DATETIME2");
+          case "mysql":
+            return sql.replace(/\bTIMESTAMP\b/gi, "DATETIME");
+          default:
+            return sql;
+        }
+      }
       /**
        * Convert ? placeholders to engine-specific style.
        *
@@ -13386,7 +13418,7 @@ function generateMigration(name, flags, fieldsOverride, tableOverride, emitTest
       const defaultClause = info.defaultVal !== "NULL" ? ` DEFAULT ${info.defaultVal}` : "";
       colLines.push(`    ${fname} ${info.sql}${defaultClause}`);
     }
-    colLines.push("    created_at TEXT DEFAULT CURRENT_TIMESTAMP");
+    colLines.push("    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP");
     upSql = `CREATE TABLE IF NOT EXISTS ${table2} (
     -- tina4:edit  add columns beyond id + created_at
 ${colLines.join(",\n")}
@@ -14529,8 +14561,8 @@ var init_generate = __esm({
   "../cli/src/commands/generate.ts"() {
     "use strict";
     FIELD_TYPE_MAP = {
-      string: { orm: '"string"', sql: "TEXT", defaultVal: "''" },
-      str: { orm: '"string"', sql: "TEXT", defaultVal: "''" },
+      string: { orm: '"string"', sql: "VARCHAR(255)", defaultVal: "''" },
+      str: { orm: '"string"', sql: "VARCHAR(255)", defaultVal: "''" },
       int: { orm: '"integer"', sql: "INTEGER", defaultVal: "0" },
       integer: { orm: '"integer"', sql: "INTEGER", defaultVal: "0" },
       float: { orm: '"number"', sql: "REAL", defaultVal: "0" },
@@ -14540,7 +14572,7 @@ var init_generate = __esm({
       bool: { orm: '"boolean"', sql: "INTEGER", defaultVal: "0" },
       boolean: { orm: '"boolean"', sql: "INTEGER", defaultVal: "0" },
       text: { orm: '"string"', sql: "TEXT", defaultVal: "''" },
-      datetime: { orm: '"datetime"', sql: "TEXT", defaultVal: "NULL" },
+      datetime: { orm: '"datetime"', sql: "TIMESTAMP", defaultVal: "NULL" },
       blob: { orm: '"string"', sql: "BLOB", defaultVal: "NULL" }
     };
     SQL_RESERVED_TABLE_NAMES = /* @__PURE__ */ new Set([
@@ -37310,6 +37342,8 @@ var init_mysql = __esm({
       translateSql(sql) {
         let translated = SQLTranslator.concatPipesToFunc(sql);
         translated = SQLTranslator.ilikeToLike(translated);
+        translated = SQLTranslator.autoIncrementSyntax(translated, "mysql");
+        translated = SQLTranslator.ddlTypes(translated, "mysql");
         return translated;
       }
       execute(sql, params) {
@@ -37731,6 +37765,8 @@ var init_mssql = __esm({
         let translated = SQLTranslator.limitToTop(sql);
         translated = SQLTranslator.concatPipesToFunc(translated);
         translated = SQLTranslator.ilikeToLike(translated);
+        translated = SQLTranslator.autoIncrementSyntax(translated, "mssql");
+        translated = SQLTranslator.ddlTypes(translated, "mssql");
         return translated;
       }
       execSqlPromise(sql, params) {
@@ -38361,6 +38397,8 @@ var init_firebird = __esm({
         let translated = SQLTranslator.limitToRows(sql);
         translated = SQLTranslator.booleanToInt(translated);
         translated = SQLTranslator.ilikeToLike(translated);
+        translated = SQLTranslator.autoIncrementSyntax(translated, "firebird");
+        translated = SQLTranslator.ddlTypes(translated, "firebird");
         return translated;
       }
       /**

package/packages/orm/src/adapters/firebird.ts

@@ -395,6 +395,13 @@ export class FirebirdAdapter implements DatabaseAdapter {
     let translated = SQLTranslator.limitToRows(sql);
     translated = SQLTranslator.booleanToInt(translated);
     translated = SQLTranslator.ilikeToLike(translated);
+    // DDL: strip AUTOINCREMENT (Firebird uses generators) and rewrite the
+    // SQLite-canonical column TYPES so ONE portable migration applies here —
+    // TEXT -> BLOB SUB_TYPE TEXT, REAL -> DOUBLE PRECISION, IF NOT EXISTS
+    // dropped. Both are DDL-only, so DML is untouched. Mirrors the Python
+    // master's firebird.py::_translate_sql.
+    translated = SQLTranslator.autoIncrementSyntax(translated, "firebird");
+    translated = SQLTranslator.ddlTypes(translated, "firebird");
     return translated;
   }
 

package/packages/orm/src/adapters/mssql.ts

@@ -172,6 +172,12 @@ export class MssqlAdapter implements DatabaseAdapter {
     let translated = SQLTranslator.limitToTop(sql);
     translated = SQLTranslator.concatPipesToFunc(translated);
     translated = SQLTranslator.ilikeToLike(translated);
+    // DDL: AUTOINCREMENT -> IDENTITY(1,1), drop IF NOT EXISTS (unsupported), and
+    // TIMESTAMP -> DATETIME2 (MSSQL's TIMESTAMP is a rowversion, not a datetime)
+    // so ONE portable migration applies here. Both are DDL-only, so DML is
+    // untouched. Mirrors the Python master's mssql.py::_translate_sql.
+    translated = SQLTranslator.autoIncrementSyntax(translated, "mssql");
+    translated = SQLTranslator.ddlTypes(translated, "mssql");
     return translated;
   }
 

package/packages/orm/src/adapters/mysql.ts

@@ -148,6 +148,12 @@ export class MysqlAdapter implements DatabaseAdapter {
     let translated = SQLTranslator.concatPipesToFunc(sql);
     // MySQL uses LOWER() LIKE instead of ILIKE
     translated = SQLTranslator.ilikeToLike(translated);
+    // DDL: AUTOINCREMENT -> AUTO_INCREMENT and TIMESTAMP -> DATETIME (MySQL's
+    // TIMESTAMP carries auto-update / 2038 surprises) so ONE portable migration
+    // applies here. Both are DDL-only, so DML is untouched. Mirrors the Python
+    // master's mysql.py::_translate_sql.
+    translated = SQLTranslator.autoIncrementSyntax(translated, "mysql");
+    translated = SQLTranslator.ddlTypes(translated, "mysql");
     return translated;
   }
 

package/packages/orm/src/sqlTranslator.ts

@@ -269,6 +269,51 @@ export class SQLTranslator {
     }
   }
 
+  /**
+   * Translate SQLite-canonical DDL column TYPES + CREATE-TABLE options to the
+   * target engine.
+   *
+   * ONLY acts on `CREATE TABLE` / `ALTER TABLE` statements, so a query or INSERT
+   * that happens to contain the word `TEXT` (a column name, a string literal) is
+   * never rewritten. Complements `autoIncrementSyntax` (which maps the id
+   * keyword) so ONE portable migration — and every `Model.createTable()` DDL,
+   * which is also SQLite-canonical — applies on every engine instead of failing
+   * on Firebird/MSSQL.
+   *
+   *   * Firebird has no `TEXT` (-607), no `REAL`, and no `CREATE TABLE IF NOT
+   *     EXISTS`.
+   *   * MSSQL has no `CREATE TABLE IF NOT EXISTS` and its `TIMESTAMP` is a
+   *     rowversion, not a datetime — a `created_at TIMESTAMP` there is wrong.
+   *   * MySQL's `TIMESTAMP` carries auto-update / 2038 surprises, so a datetime
+   *     column maps to `DATETIME` (matching the adapters' createTableAsync).
+   */
+  static ddlTypes(sql: string, engine: string): string {
+    // Gate to DDL only, tolerating leading `-- ...` comment lines / blank lines
+    // that a migration file carries before its CREATE TABLE. A SELECT or INSERT
+    // that merely mentions a type keyword is never rewritten.
+    const head = sql.replace(/^(?:\s*--[^\n]*\n)+/, "");
+    if (!/^\s*(?:CREATE\s+TABLE|ALTER\s+TABLE)\b/i.test(head)) return sql;
+    switch ((engine ?? "").toLowerCase()) {
+      case "firebird":
+        return sql
+          .replace(/\bIF\s+NOT\s+EXISTS\b/gi, "")
+          // Map bare TEXT -> BLOB SUB_TYPE TEXT, but leave an existing
+          // "BLOB SUB_TYPE TEXT" intact (it already contains the word TEXT).
+          .replace(/\bBLOB\s+SUB_TYPE\s+TEXT\b/gi, "\x00FBTEXT\x00")
+          .replace(/\bTEXT\b/gi, "BLOB SUB_TYPE TEXT")
+          .replaceAll("\x00FBTEXT\x00", "BLOB SUB_TYPE TEXT")
+          .replace(/\bREAL\b/gi, "DOUBLE PRECISION");
+      case "mssql":
+        return sql
+          .replace(/\bIF\s+NOT\s+EXISTS\b/gi, "")
+          .replace(/\bTIMESTAMP\b/gi, "DATETIME2");
+      case "mysql":
+        return sql.replace(/\bTIMESTAMP\b/gi, "DATETIME");
+      default:
+        return sql;
+    }
+  }
+
   /**
    * Convert ? placeholders to engine-specific style.
    *

package/types/orm/src/sqlTranslator.d.ts

@@ -75,6 +75,25 @@ export declare class SQLTranslator {
      * Translate AUTOINCREMENT across engines in DDL.
      */
     static autoIncrementSyntax(sql: string, engine: string): string;
+    /**
+     * Translate SQLite-canonical DDL column TYPES + CREATE-TABLE options to the
+     * target engine.
+     *
+     * ONLY acts on `CREATE TABLE` / `ALTER TABLE` statements, so a query or INSERT
+     * that happens to contain the word `TEXT` (a column name, a string literal) is
+     * never rewritten. Complements `autoIncrementSyntax` (which maps the id
+     * keyword) so ONE portable migration — and every `Model.createTable()` DDL,
+     * which is also SQLite-canonical — applies on every engine instead of failing
+     * on Firebird/MSSQL.
+     *
+     *   * Firebird has no `TEXT` (-607), no `REAL`, and no `CREATE TABLE IF NOT
+     *     EXISTS`.
+     *   * MSSQL has no `CREATE TABLE IF NOT EXISTS` and its `TIMESTAMP` is a
+     *     rowversion, not a datetime — a `created_at TIMESTAMP` there is wrong.
+     *   * MySQL's `TIMESTAMP` carries auto-update / 2038 surprises, so a datetime
+     *     column maps to `DATETIME` (matching the adapters' createTableAsync).
+     */
+    static ddlTypes(sql: string, engine: string): string;
     /**
      * Convert ? placeholders to engine-specific style.
      *