JSON को sequelize-typescript library के decorator-आधारित model में बदलता है: @Table और @Column({ type: DataType.*, allowNull }) वाली Model को extend करने वाली class, TypeScript property types, और validation के लिए class-validator decorators।
यह सादे sequelize की बजाय sequelize-typescript (NestJS के @nestjs/sequelize के पीछे की library) को target करता है, इसलिए import path और DataType की spelling (अंत में s नहीं) JavaScript version से अलग हैं।
मॉडल का नाम में class का नाम डालें (default MyModel); यही @Table में upper snake case tableName भी बनता है।invoice.model.ts के रूप में सेव करें और new Sequelize({ ..., models: [Invoice] }) या NestJS के SequelizeModule.forFeature([Invoice]) से register करें।{
"invoice_no": "INV-2024-0042",
"amount": 1250.75,
"currency": "EUR",
"paid": false,
"due_date": "2024-07-31",
"memo": ""
}import { Table, Column, Model, DataType } from 'sequelize-typescript';
import { IsNotEmpty, IsOptional } from 'class-validator';
@Table({ tableName: 'INVOICE', timestamps: false })
export class Invoice extends Model<Invoice> {
@Column({ type: DataType.INTEGER, primaryKey: true, autoIncrement: true })
id: number;
@Column({ type: DataType.STRING, allowNull: false, field: 'invoice_no' })
@IsNotEmpty()
invoiceNo: string;
@Column({ type: DataType.DOUBLE, allowNull: false })
@IsNotEmpty()
amount: number;
@Column({ type: DataType.STRING, allowNull: false })
@IsNotEmpty()
currency: string;
@Column({ type: DataType.BOOLEAN, allowNull: false })
@IsNotEmpty()
paid: boolean;
@Column({ type: DataType.DATEONLY, allowNull: false, field: 'due_date' })
@IsNotEmpty()
dueDate: string;
@Column({ type: DataType.STRING, allowNull: false })
@IsOptional()
memo: string;
}memo खाली string है: वह NULL नहीं है, इसलिए column allowNull: false रखता है, लेकिन उसे @IsNotEmpty() की बजाय @IsOptional() मिलता है। amount DataType.DOUBLE बनता है, और due_date string type के साथ DataType.DATEONLY बनता है, क्योंकि Sequelize सिर्फ़ तारीख वाली values को टेक्स्ट के रूप में लौटाता है।
sequelize-typescript से { Table, Column, Model, DataType } import करता है और class को extends Model<Invoice> के रूप में declare करता है।@Table({ tableName: 'INVOICE', timestamps: false }), JavaScript generator जैसा, इसलिए createdAt/updatedAt columns नहीं माने जाते।@Column type और allowNull बताता है; nullable columns का type string | null वगैरह होता है।INTEGER/BIGINT/DOUBLE → number, BOOLEAN → boolean, DATE → Date, DATEONLY → string, JSON → Record<string, unknown> या string[] जैसा typed array।field: 'invoice_no' मूल column की ओर इशारा करता है; JSON की id key दोहराई नहीं जाती बल्कि primary key के रूप में इस्तेमाल होती है।@IsNotEmpty() मिलता है; बाकी को @IsOptional()।जब बाहरी billing या settlement system का JSON में भेजा data persist करना हो, तो उस payload से model class बनाएं और उसे @InjectModel(Invoice) के ज़रिए इस्तेमाल करें।
define() object को हाथ से class में दोबारा लिखने की बजाय, मौजूदा table data को JSON के रूप में export करके पेस्ट करें और typed model draft पाएं।
DataType.DOUBLE से DataType.DECIMAL(12, 2) ज़्यादा सुरक्षित है।experimentalDecorators और emitDecoratorMetadata चालू होने चाहिए।useDefineForClassFields (target ES2022 और बाद के लिए default) के साथ सादे property declarations Sequelize के getters को ढक देते हैं। उस option को बंद करें या properties के आगे declare लगाएं।Model<Invoice> की बजाय Model<InvoiceAttributes, InvoiceCreationAttributes> नहीं होना चाहिए?sequelize-typescript v2 दो generics स्वीकार करता है; बना हुआ कोड बस class खुद को देता है। अगर आप चाहते हैं कि id जैसे auto-generated fields के बिना Invoice.create({...}) type-check हो, तो creation-attributes interface declare करें और उसे दूसरे generic के रूप में दें।
DataTypes की बजाय DataType क्यों?DataType वह नाम है जिसे sequelize-typescript export करता है। sequelize से DataTypes import करना भी वैसे ही काम करता है, लेकिन एक फ़ाइल में एक ही नाम रखना ज़्यादा पढ़ने लायक है।
नहीं। Validation तभी होता है जब आप खुद validate(invoice) call करें या decorators NestJS के ValidationPipe से संभाले जाने वाले DTO पर हों। Sequelize-level validation के लिए @Column({ validate: { notEmpty: true } }) या @NotEmpty जैसे sequelize-typescript decorators इस्तेमाल करें।