JSON কে Sequelize (TypeScript) সমাধানে রূপান্তর করুন!

JSON ইনপুট করুন এবং এটিকে Sequelize (TypeScript) সমাধানে রূপান্তর করুন! sequelize-typescript @Table, @Column, Model, class-validator সমর্থিত।
JSON
ফলাফল
 

JSON কে Sequelize (TypeScript) সমাধানে রূপান্তর করুন!

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 সংস্করণ থেকে আলাদা।

কীভাবে ব্যবহার করবেন

  1. একটি টেবিল row-এর জন্য একটি JSON অবজেক্ট, অথবা row-গুলোর একটি array পেস্ট করুন।
  2. মডেলের নাম-এ ক্লাসের নাম দিন (ডিফল্ট MyModel); এটি @Table-এ বড় হাতের snake case tableName-ও হয়।
  3. ফলাফলটি invoice.model.ts হিসেবে সেভ করে new Sequelize({ ..., models: [Invoice] }) বা NestJS-এর SequelizeModule.forFeature([Invoice]) দিয়ে রেজিস্টার করুন।

উদাহরণ

ইনপুট (JSON)
{
  "invoice_no": "INV-2024-0042",
  "amount": 1250.75,
  "currency": "EUR",
  "paid": false,
  "due_date": "2024-07-31",
  "memo": ""
}
আউটপুট (sequelize-typescript)
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> হিসেবে ডিক্লেয়ার করে।
  • JavaScript জেনারেটরের মতোই @Table({ tableName: 'INVOICE', timestamps: false }), তাই কোনো createdAt/updatedAt কলাম ধরে নেওয়া হয় না।
  • প্রতিটি @Column type আর allowNull উল্লেখ করে; nullable কলামের type হয় string | null ইত্যাদি।
  • Type জোড়া: INTEGER/BIGINT/DOUBLE → number, BOOLEAN → boolean, DATE → Date, DATEONLY → string, JSON → Record<string, unknown> বা string[]-এর মতো টাইপড array।
  • প্রপার্টি camelCase, আর field: 'invoice_no' মূল কলামকে নির্দেশ করে; JSON-এর id key ডুপ্লিকেট না হয়ে primary key হিসেবে ব্যবহৃত হয়।
  • প্রতিটি row-এ ফাঁকা নয় এমন ভ্যালু থাকা ফিল্ড @IsNotEmpty() পায়; বাকিগুলো পায় @IsOptional()।

ব্যবহারের ক্ষেত্র

`@nestjs/sequelize`-সহ NestJS-এর মডেল

এক্সটার্নাল বিলিং বা সেটেলমেন্ট সিস্টেম JSON হিসেবে যে ডেটা পাঠায় তা সংরক্ষণ করতে হলে সেই payload থেকে মডেল ক্লাস তৈরি করে @InjectModel(Invoice)-এর মাধ্যমে ব্যবহার করুন।

JavaScript Sequelize মডেলকে টাইপড কোডে বদলানো

define() অবজেক্টকে হাতে ক্লাসে নতুন করে লেখার বদলে বিদ্যমান টেবিলের ডেটা JSON হিসেবে export করে পেস্ট করুন এবং টাইপড মডেলের খসড়া পান।

নোট ও সীমাবদ্ধতা

  • টাকা আর অন্যান্য নির্ভুল দশমিকের জন্য DataType.DOUBLE-এর চেয়ে DataType.DECIMAL(12, 2) বেশি নিরাপদ।
  • Decorator কাজ করার জন্য tsconfig-এ 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 করলেও একইভাবে কাজ করে, তবে প্রতি ফাইলে একটি নামই ব্যবহার করলে পড়তে সুবিধা হয়।

class-validator decorator কি মডেলে স্বয়ংক্রিয়ভাবে চেক হয়?

না। Validation হয় শুধু যখন আপনি নিজে validate(invoice) কল করেন, বা যখন decorator-গুলো NestJS-এর ValidationPipe প্রসেস করা কোনো DTO-তে থাকে। Sequelize-স্তরের validation-এর জন্য @Column({ validate: { notEmpty: true } }) বা @NotEmpty-এর মতো sequelize-typescript decorator ব্যবহার করুন।