JSON-কে sequelize-typescript লাইব্রেরির decorator-ভিত্তিক মডেলে কনভার্ট করে: @Table আর @Column({ type: DataType.*, allowNull })-সহ Model extend করা একটি ক্লাস, TypeScript প্রপার্টি type, আর validation-এর জন্য class-validator decorator।
এটি সাধারণ sequelize নয়, sequelize-typescript-কে (NestJS-এর @nestjs/sequelize-এর পেছনের লাইব্রেরি) লক্ষ্য করে, তাই import path আর DataType বানান (শেষে s নেই) JavaScript সংস্করণ থেকে আলাদা।
মডেলের নাম-এ ক্লাসের নাম দিন (ডিফল্ট MyModel); এটি @Table-এ বড় হাতের snake case tableName-ও হয়।invoice.model.ts হিসেবে সেভ করে new Sequelize({ ..., models: [Invoice] }) বা NestJS-এর SequelizeModule.forFeature([Invoice]) দিয়ে রেজিস্টার করুন।{
"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 একটি ফাঁকা স্ট্রিং: এটি NULL নয়, তাই কলামটি allowNull: false রাখে, কিন্তু @IsNotEmpty()-এর বদলে @IsOptional() পায়। amount হয় DataType.DOUBLE, আর due_date হয় string type-এর DataType.DATEONLY, কারণ Sequelize শুধু-তারিখের ভ্যালু টেক্সট হিসেবে ফেরত দেয়।
sequelize-typescript থেকে { Table, Column, Model, DataType } import করে এবং ক্লাসটিকে extends Model<Invoice> হিসেবে ডিক্লেয়ার করে।@Table({ tableName: 'INVOICE', timestamps: false }), তাই কোনো createdAt/updatedAt কলাম ধরে নেওয়া হয় না।@Column type আর allowNull উল্লেখ করে; nullable কলামের type হয় string | null ইত্যাদি।INTEGER/BIGINT/DOUBLE → number, BOOLEAN → boolean, DATE → Date, DATEONLY → string, JSON → Record<string, unknown> বা string[]-এর মতো টাইপড array।field: 'invoice_no' মূল কলামকে নির্দেশ করে; JSON-এর id key ডুপ্লিকেট না হয়ে primary key হিসেবে ব্যবহৃত হয়।@IsNotEmpty() পায়; বাকিগুলো পায় @IsOptional()।এক্সটার্নাল বিলিং বা সেটেলমেন্ট সিস্টেম JSON হিসেবে যে ডেটা পাঠায় তা সংরক্ষণ করতে হলে সেই payload থেকে মডেল ক্লাস তৈরি করে @InjectModel(Invoice)-এর মাধ্যমে ব্যবহার করুন।
define() অবজেক্টকে হাতে ক্লাসে নতুন করে লেখার বদলে বিদ্যমান টেবিলের ডেটা JSON হিসেবে export করে পেস্ট করুন এবং টাইপড মডেলের খসড়া পান।
DataType.DOUBLE-এর চেয়ে DataType.DECIMAL(12, 2) বেশি নিরাপদ।experimentalDecorators আর emitDecoratorMetadata চালু থাকতে হবে।useDefineForClassFields চালু থাকলে (target ES2022 ও পরের জন্য ডিফল্ট), সাধারণ প্রপার্টি ডিক্লারেশন Sequelize-এর getter-কে ঢেকে দেয়। অপশনটি বন্ধ করুন বা প্রপার্টিগুলোর আগে declare দিন।Model<Invoice>-এর বদলে কি Model<InvoiceAttributes, InvoiceCreationAttributes> হওয়া উচিত নয়?sequelize-typescript v2 দুটি generic গ্রহণ করে; জেনারেট হওয়া কোড শুধু ক্লাসটিকেই দেয়। id-এর মতো স্বয়ংক্রিয় ফিল্ড ছাড়া Invoice.create({...}) type-check করাতে চাইলে একটি creation-attributes interface ডিক্লেয়ার করে দ্বিতীয় generic হিসেবে দিন।
DataTypes নয়, কেন DataType?DataType হলো sequelize-typescript যে নামে export করে। sequelize থেকে DataTypes import করলেও একইভাবে কাজ করে, তবে প্রতি ফাইলে একটি নামই ব্যবহার করলে পড়তে সুবিধা হয়।
না। Validation হয় শুধু যখন আপনি নিজে validate(invoice) কল করেন, বা যখন decorator-গুলো NestJS-এর ValidationPipe প্রসেস করা কোনো DTO-তে থাকে। Sequelize-স্তরের validation-এর জন্য @Column({ validate: { notEmpty: true } }) বা @NotEmpty-এর মতো sequelize-typescript decorator ব্যবহার করুন।