tina4-nodejs 3.10.66 → 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.66",
+  "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/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;
   }
 
   /**