tina4-nodejs 3.10.38 → 3.10.40

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tina4-nodejs",
-  "version": "3.10.38",
+  "version": "3.10.40",
   "type": "module",
   "description": "This is not a framework. Tina4 for Node.js/TypeScript — zero deps, 38 built-in features.",
   "keywords": ["tina4", "framework", "web", "api", "orm", "graphql", "websocket", "typescript"],

package/packages/cli/src/bin.ts

@@ -7,6 +7,7 @@ import { migrateRollback } from "./commands/migrateRollback.js";
 import { listRoutes } from "./commands/routes.js";
 import { runTests } from "./commands/test.js";
 import { generate } from "./commands/generate.js";
+import { runSeeds } from "./commands/seed.js";
 
 const args = process.argv.slice(2);
 const command = args[0];
@@ -24,6 +25,7 @@ const HELP = `
     tina4nodejs routes                List all registered routes
     tina4nodejs test [file]           Run project tests
     tina4nodejs generate <what> <name> Generate scaffolding (model, route, migration, middleware)
+    tina4nodejs seed [file]           Run database seed files from src/seeds/
     tina4nodejs ai                    Install AI coding assistant context files
     tina4nodejs help                  Show this help message
 
@@ -78,6 +80,10 @@ async function main(): Promise<void> {
       await generate(what, genName);
       break;
     }
+    case "seed": {
+      await runSeeds(args[1]);
+      break;
+    }
     case "ai": {
       const { showMenu, installSelected, installAll } = await import("../../core/src/ai.js");
       const root = args[1] || ".";

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

@@ -0,0 +1,72 @@
+/**
+ * CLI command: seed — Run database seed files.
+ *
+ * Scans src/seeds/ for .ts files and executes them with tsx in alphabetical order.
+ */
+import { existsSync, readdirSync } from "node:fs";
+import { resolve, join } from "node:path";
+import { execSync } from "node:child_process";
+
+export async function runSeeds(seedPath?: string): Promise<void> {
+  const cwd = process.cwd();
+  const seedDir = resolve(cwd, "src/seeds");
+
+  // If a specific seed file is provided, run it directly
+  if (seedPath) {
+    const file = resolve(seedPath);
+    if (!existsSync(file)) {
+      console.error(`  Error: Seed file not found: ${seedPath}`);
+      process.exit(1);
+    }
+    console.log(`  Running seed: ${seedPath}\n`);
+    try {
+      execSync(`npx tsx "${file}"`, { cwd, stdio: "inherit" });
+    } catch {
+      process.exit(1);
+    }
+    return;
+  }
+
+  // Auto-discover seed files in src/seeds/
+  if (!existsSync(seedDir)) {
+    console.log("  No seeds directory found.");
+    console.log("  Create seed files in src/seeds/ (e.g. src/seeds/001-users.ts)");
+    return;
+  }
+
+  let seedFiles: string[];
+  try {
+    seedFiles = readdirSync(seedDir)
+      .filter((f) => f.endsWith(".ts"))
+      .sort()
+      .map((f) => join(seedDir, f));
+  } catch {
+    console.log("  Could not read src/seeds/ directory.");
+    return;
+  }
+
+  if (seedFiles.length === 0) {
+    console.log("  No seed files found in src/seeds/");
+    return;
+  }
+
+  console.log(`  Found ${seedFiles.length} seed file(s)\n`);
+
+  let failed = false;
+  for (const file of seedFiles) {
+    const relative = file.replace(cwd + "/", "");
+    console.log(`  Seeding: ${relative}`);
+    try {
+      execSync(`npx tsx "${file}"`, { cwd, stdio: "inherit" });
+    } catch {
+      failed = true;
+    }
+  }
+
+  if (failed) {
+    console.error("\n  Some seeds failed.");
+    process.exit(1);
+  }
+
+  console.log("\n  All seeds completed.");
+}

package/packages/core/src/devAdmin.ts

@@ -2332,6 +2332,8 @@ function tina4VersionModal(){
                 if(l>c){isNewer=true;break;}
                 if(l<c)break;
             }
+            var isAhead=false;
+            if(!isNewer){for(var i=0;i<Math.max(cParts.length,lParts.length);i++){var c2=cParts[i]||0,l2=lParts[i]||0;if(c2>l2){isAhead=true;break;}if(c2<l2)break;}}
             if(isNewer){
                 var breaking=(lParts[0]!==cParts[0]||lParts[1]!==cParts[1]);
                 el.innerHTML='Latest: <strong style="color:#f9e2af;">v'+latest+'</strong>';
@@ -2340,6 +2342,9 @@ function tina4VersionModal(){
                 }else{
                     el.innerHTML+='<div style="color:#f9e2af;margin-top:6px;">Patch update available. Run: <code style="background:#313244;padding:2px 6px;border-radius:3px;">npm install tina4-nodejs@latest</code></div>';
                 }
+            }else if(isAhead){
+                el.innerHTML='You are running <strong style="color:#cba6f7;">v'+current+'</strong> (ahead of npm <strong>v'+latest+'</strong> &mdash; not yet published).';
+                el.style.color='#cba6f7';
             }else{
                 el.innerHTML='Latest: <strong style="color:#a6e3a1;">v'+latest+'</strong> &mdash; You are up to date!';
                 el.style.color='#a6e3a1';

package/packages/core/src/router.ts

@@ -247,6 +247,11 @@ export class Router {
     return all;
   }
 
+  /** Alias for getRoutes(). */
+  allRoutes(): RouteDefinition[] {
+    return this.getRoutes();
+  }
+
   /**
    * List all routes in a debug-friendly format for CLI output.
    */

package/packages/orm/src/baseModel.ts

@@ -188,6 +188,31 @@ export class BaseModel {
     return instance;
   }
 
+  /**
+   * Create a new instance from data, save it, and return the saved instance.
+   *
+   * Usage:
+   *   const user = User.create({ name: "Alice", email: "alice@example.com" });
+   */
+  static create<T extends BaseModel>(
+    this: new (data?: Record<string, unknown>) => T,
+    data: Record<string, unknown>,
+  ): T {
+    const instance = new this(data) as T;
+    instance.save();
+    return instance;
+  }
+
+  /** Alias for findById(). */
+  static find<T extends BaseModel>(this: new (data?: Record<string, unknown>) => T, id: unknown, include?: string[]): T | null {
+    return (this as unknown as typeof BaseModel).findById.call(this, id, include) as T | null;
+  }
+
+  /** Alias for findById(). */
+  static load<T extends BaseModel>(this: new (data?: Record<string, unknown>) => T, id: unknown, include?: string[]): T | null {
+    return (this as unknown as typeof BaseModel).findById.call(this, id, include) as T | null;
+  }
+
   /**
    * Find all records, optionally with a where clause.
    * @param where Optional WHERE clause.

package/packages/orm/src/database.ts

@@ -393,6 +393,44 @@ export class Database {
     return this.getNextAdapter().tables();
   }
 
+  /**
+   * Get column metadata for a table.
+   * Uses the adapter's columns() method which handles engine-specific introspection
+   * (PRAGMA table_info for SQLite, information_schema.columns for others).
+   *
+   * @param tableName - Name of the table to inspect.
+   * @returns Array of column info objects: { name, type, nullable, default, primaryKey }.
+   */
+  getColumns(tableName: string): { name: string; type: string; nullable?: boolean; default?: unknown; primaryKey?: boolean }[] {
+    return this.getNextAdapter().columns(tableName);
+  }
+
+  /**
+   * Execute a SQL statement with multiple parameter sets (batch insert/update).
+   * Wraps all executions in a single transaction for atomicity and performance.
+   *
+   * @param sql - The SQL statement with parameter placeholders.
+   * @param paramSets - Array of parameter arrays, one per execution.
+   * @returns Array of results from each execution.
+   */
+  executeMany(sql: string, paramSets: unknown[][]): unknown[] {
+    const adapter = this.getNextAdapter();
+    const results: unknown[] = [];
+
+    adapter.startTransaction();
+    try {
+      for (const params of paramSets) {
+        results.push(adapter.execute(sql, params));
+      }
+      adapter.commit();
+    } catch (e) {
+      adapter.rollback();
+      throw e;
+    }
+
+    return results;
+  }
+
   /** Get the last auto-increment id. */
   getLastId(): string | number {
     const id = this.getNextAdapter().lastInsertId();