tina4-nodejs 3.10.65 → 3.10.67

package/CLAUDE.md

@@ -153,13 +153,39 @@ Database layer with auto-CRUD generation, seeding, fake data, and SQL translatio
 - `fakeData.ts` — ORM-aware fake data extending core (adds `forField()` with column-name heuristics)
 - `seeder.ts` — Database seeding (`seedTable` for raw SQL, `seedOrm` for model-based)
 - `sqlTranslation.ts` — Cross-engine SQL translator (`SQLTranslator`) and TTL query cache (`QueryCache`)
-- `BaseModel.select<T>(sql, params?)` — Raw SQL query returning `T[]`
-- `BaseModel.selectOne<T>(sql, params?, include?)` — Raw SQL query returning `T | null` (first match or null, with optional eager loading)
+- **Instance methods:** `save()`, `delete()`, `forceDelete()`, `restore()`, `load(sql, params?, include?): boolean` (selectOne into self), `validate(): string[]`, `toDict(include?): Record`, `toObject(): Record`, `toArray(): unknown[]`, `toList(): unknown[]`, `toJson(): string`, `hasOne()`, `hasMany()`, `belongsTo()`
+- **Static methods:** `find(id, include?)`, `findById(id, include?)`, `findAll(where?, params?, include?)`, `findOrFail(id)`, `create(data)`, `select(sql, params?)`, `selectOne(sql, params?, include?)`, `count(conditions?, params?)`, `withTrashed(conditions?, params?)`, `scope(name, filterSql, params?)`, `createTable()`, `query(): QueryBuilder`
 - QueryBuilder supports `toMongo()` for generating MongoDB query documents from the same fluent API
 - `getNextId(table: string, pkColumn?: string, generatorName?: string): Promise<number>` — Race-safe ID generation using atomic sequence table (`tina4_sequences`). SQLite/MySQL/MSSQL use `tina4_sequences` with atomic UPDATE+SELECT. PostgreSQL auto-creates sequences if missing. Firebird uses existing generators (unchanged).
 
 **`tina4_sequences` table** — Auto-created by `getNextId()` on first use for SQLite, MySQL, and MSSQL. Stores the current sequence value per table. Do not modify this table manually.
 
+### File Uploads
+
+Multipart file uploads are available via `req.files` (array of UploadedFile objects):
+
+```typescript
+// req.files[0] =>
+{
+  fieldName: "avatar",
+  filename: "photo.png",
+  type: "image/png",
+  content: Buffer,            // raw bytes — NOT base64
+  size: 102400
+}
+```
+
+```typescript
+post("/api/upload", (req, res) => {
+  const file = req.files?.find(f => f.fieldName === "avatar");
+  if (!file) return res.json({ error: "No file" }, 400);
+  fs.writeFileSync(`src/public/uploads/${file.filename}`, file.content);
+  return res.json({ ok: true });
+});
+```
+
+Max upload size: `TINA4_MAX_UPLOAD_SIZE` env var (default 10MB).
+
 ### @tina4/swagger (`packages/swagger/`)
 Auto-generates OpenAPI 3.0 docs.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tina4-nodejs",
-  "version": "3.10.65",
+  "version": "3.10.67",
   "type": "module",
   "description": "Tina4 for Node.js/TypeScript — 54 built-in features, zero dependencies",
   "keywords": ["tina4", "framework", "web", "api", "orm", "graphql", "websocket", "typescript"],

package/packages/core/src/metrics.ts

@@ -54,6 +54,9 @@ function relativePath(filePath: string, root: string = "."): string {
   return path.relative(root, filePath);
 }
 
+// Stores the resolved scan root so fileDetail() can locate framework files.
+let _lastScanRoot = "";
+
 // ── Test file detection ─────────────────────────────────────
 
 function hasMatchingTest(relPath: string): boolean {
@@ -591,10 +594,13 @@ function detectViolations(
 function resolveRoot(root: string = "src"): string {
   const rootPath = path.resolve(root);
   if (fs.existsSync(rootPath) && walkFiles(rootPath, [".ts", ".js"]).length > 0) {
+    _lastScanRoot = rootPath;
     return root;
   }
   // Fallback: scan the framework package itself
-  return path.resolve(path.dirname(new URL(import.meta.url).pathname));
+  const fwDir = path.resolve(path.dirname(new URL(import.meta.url).pathname));
+  _lastScanRoot = fwDir;
+  return fwDir;
 }
 
 // ── Quick Metrics ────────────────────────────────────────────
@@ -854,7 +860,15 @@ export function fullAnalysis(root: string = "src"): Record<string, any> {
 // ── File Detail ──────────────────────────────────────────────
 
 export function fileDetail(filePath: string): Record<string, any> {
-  const resolved = path.resolve(filePath);
+  let resolved = path.resolve(filePath);
+  if (!fs.existsSync(resolved) && _lastScanRoot) {
+    // Try resolving relative to the last scan root (framework mode)
+    const candidate = path.resolve(_lastScanRoot, filePath);
+    if (fs.existsSync(candidate)) {
+      resolved = candidate;
+      filePath = candidate;
+    }
+  }
   if (!fs.existsSync(resolved)) {
     return { error: `File not found: ${filePath}` };
   }

package/packages/orm/src/baseModel.ts

@@ -240,9 +240,20 @@ export class BaseModel {
     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;
+  /**
+   * Load a record into this instance via selectOne.
+   * Returns true if found and loaded, false otherwise.
+   */
+  load(sql: string, params?: unknown[], include?: string[]): boolean {
+    const ModelClass = this.constructor as typeof BaseModel & (new (data?: Record<string, unknown>) => BaseModel);
+    const result = ModelClass.selectOne(sql, params, include);
+    if (!result) return false;
+    const data = (result as any).toJSON ? (result as any).toJSON() : result;
+    for (const [key, value] of Object.entries(data)) {
+      (this as any)[key] = value;
+    }
+    (this as any)._exists = true;
+    return true;
   }
 
   /**