crudora 0.1.0-alpha.2 → 0.1.0-alpha.3

package/README.md

@@ -16,6 +16,12 @@ Automatic CRUD API generator for TypeScript with Prisma - Build REST APIs in min
 - 🔌 **Extensible**: Custom routes and middleware support
 - 📖 **Schema Generation**: Auto-generate Prisma schemas from models
 - 🗄️ **Repository Pattern**: Built-in repository for database operations
+- 🔄 **Lifecycle Hooks**: beforeCreate, afterCreate, beforeUpdate, afterUpdate, beforeDelete, afterDelete, beforeFind, afterFind
+- 🔒 **Field Security**: Hidden fields support with automatic filtering
+- 🎛️ **Dynamic Selection**: Smart field selection based on fillable and hidden properties
+- ⚡ **Auto Setup**: Intelligent postinstall script for quick project initialization
+- 🔄 **TypeScript First**: Native TypeScript support with ESM modules
+- 🖥️ **CLI Tool**: Command-line interface for project initialization and scaffolding
 
 ## Installation
 
@@ -25,9 +31,45 @@ npm install crudora prisma @prisma/client
 yarn add crudora prisma @prisma/client
 ```
 
+**Note**: After installation, Crudora automatically sets up your project with:
+
+- Prisma schema template
+- Environment configuration (.env)
+- Basic server setup (server.ts)
+- Useful npm scripts
+
+## CLI Usage
+
+Crudora comes with a built-in CLI tool for quick project initialization and database management:
+
+```bash
+# Initialize a new Crudora project in the current directory
+npx crudora init
+
+# Start Prisma Studio for database management
+npx crudora studio
+
+# Generate Prisma Client
+npx crudora generate
+
+# Push Prisma schema to database
+npx crudora push
+
+# Run Prisma migrations
+npx crudora migrate
+```
+
+### CLI Commands
+
+- `init` - Initialize a new Crudora project with necessary files (schema.prisma, .env, server.ts, tsconfig.json)
+- `studio` - Start Prisma Studio for visual database management
+- `generate` - Generate Prisma Client based on your schema
+- `push` - Push Prisma schema to your database without migrations
+- `migrate` - Run Prisma migrations for schema changes
+
 ## Quick Start
 
-### Method 1: Simple Inheritance (Recommended)
+### Basic Usage
 
 ```typescript
 import { CrudoraServer, Model } from "crudora";
@@ -35,26 +77,34 @@ import { PrismaClient } from "@prisma/client";
 
 const prisma = new PrismaClient();
 
-// Define your models
 class User extends Model {
   static tableName = "users";
   static primaryKey = "id";
   static timestamps = true;
-  static fillable = ["name", "email"];
+  static fillable = ["name", "email", "password"];
   static hidden = ["password"];
+
+  // Lifecycle hooks
+  static async beforeCreate(data: any): Promise<any> {
+    data.password = await hashPassword(data.password);
+    return data;
+  }
+
+  static async afterCreate(data: any, result: any): Promise<any> {
+    console.log(`User created: ${result.email}`);
+    return result;
+  }
 }
 
 class Post extends Model {
   static tableName = "posts";
   static fillable = ["title", "content", "authorId"];
+  static hidden = ["deletedAt"];
 }
 
-// Create server and register models
 const server = new CrudoraServer({
   port: 3000,
   prisma: prisma,
-  cors: true,
-  basePath: "/api",
 });
 
 server
@@ -65,40 +115,6 @@ server
   });
 ```
 
-### Method 2: Decorator Pattern
-
-```typescript
-import { CrudoraServer, Model, Field } from "crudora";
-import { PrismaClient } from "@prisma/client";
-
-const prisma = new PrismaClient();
-
-@Model({ tableName: "users" })
-class User {
-  @Field({ type: "uuid", primary: true })
-  id!: string;
-
-  @Field({ type: "string", required: true })
-  name!: string;
-
-  @Field({ type: "string", unique: true, required: true })
-  email!: string;
-
-  @Field({ type: "date" })
-  createdAt!: Date;
-
-  @Field({ type: "date" })
-  updatedAt!: Date;
-}
-
-const server = new CrudoraServer({
-  port: 3000,
-  prisma: prisma,
-});
-
-server.registerModel(User).generateRoutes().listen();
-```
-
 ## Generated API Endpoints
 
 For each registered model, Crudora automatically generates:
@@ -118,19 +134,97 @@ For each registered model, Crudora automatically generates:
 
 ## Advanced Usage
 
+### Lifecycle Hooks
+
+Crudora supports comprehensive lifecycle hooks for all CRUD operations:
+
+```typescript
+class User extends Model {
+  static tableName = "users";
+  static fillable = ["name", "email", "password"];
+  static hidden = ["password"];
+
+  // Create hooks
+  static async beforeCreate(data: any): Promise<any> {
+    data.password = await hashPassword(data.password);
+    data.createdAt = new Date();
+    return data;
+  }
+
+  static async afterCreate(data: any, result: any): Promise<any> {
+    await sendWelcomeEmail(result.email);
+    await logUserCreation(result.id);
+    return result;
+  }
+
+  // Update hooks
+  static async beforeUpdate(id: string, data: any): Promise<any> {
+    data.updatedAt = new Date();
+    return data;
+  }
+
+  static async afterUpdate(id: string, data: any, result: any): Promise<any> {
+    await logUserUpdate(id, data);
+    return result;
+  }
+
+  // Delete hooks
+  static async beforeDelete(id: string): Promise<void> {
+    await archiveUserData(id);
+  }
+
+  static async afterDelete(id: string, result: any): Promise<any> {
+    await logUserDeletion(id);
+    return result;
+  }
+
+  // Find hooks
+  static async beforeFind(options: any): Promise<any> {
+    // Add default filters
+    options.where = { ...options.where, active: true };
+    return options;
+  }
+
+  static async afterFind(result: any): Promise<any> {
+    // Transform result
+    if (Array.isArray(result)) {
+      return result.map((user) => ({ ...user, displayName: user.name }));
+    }
+    return { ...result, displayName: result.name };
+  }
+}
+```
+
+### Field Security and Dynamic Selection
+
+Crudora automatically handles field security and dynamic selection:
+
+```typescript
+class User extends Model {
+  static tableName = "users";
+  static fillable = ["name", "email", "bio"]; // Only these fields can be mass-assigned
+  static hidden = ["password", "secret"]; // These fields are automatically excluded from responses
+}
+
+// API responses automatically exclude hidden fields
+// Only fillable fields are included in select queries for better performance
+```
+
 ### Using Repositories
 
 ```typescript
 const crudora = server.getCrudora();
 const userRepo = crudora.getRepository(User);
 
-// Create user
+// Create user (triggers beforeCreate and afterCreate hooks)
 const user = await userRepo.create({
   name: "John Doe",
   email: "john@example.com",
+  password: "plaintext", // Will be hashed by beforeCreate hook
 });
+// Response excludes password due to hidden field
 
-// Find users
+// Find users (triggers beforeFind and afterFind hooks)
 const users = await userRepo.findAll({
   skip: 0,
   take: 10,
@@ -138,6 +232,11 @@ const users = await userRepo.findAll({
   orderBy: { createdAt: "desc" },
 });
 
+// Update user (triggers beforeUpdate and afterUpdate hooks)
+const updatedUser = await userRepo.update("user-id", {
+  name: "John Updated",
+});
+
 // Count users
 const count = await userRepo.count({ active: true });
 ```
@@ -178,11 +277,43 @@ const partialSchema = crudora.getValidationSchema(User);
 const strictSchema = crudora.getStrictValidationSchema(User);
 ```
 
+## Project Setup
+
+After installing Crudora, run these commands to complete setup:
+
+```bash
+# Install additional dependencies
+npm install @prisma/client prisma dotenv
+
+# Generate Prisma client
+npm run db:generate
+
+# Push database schema
+npm run db:push
+
+# Start development server
+npm run dev
+```
+
+## Available Scripts
+
+Crudora automatically adds these scripts to your package.json:
+
+- `npm run dev` - Start development server with ts-node
+- `npm run build` - Build TypeScript to JavaScript
+- `npm run start` - Start production server from built JavaScript
+- `npm run start:prod` - Build and start production server
+- `npm run db:generate` - Generate Prisma client
+- `npm run db:push` - Push schema to database
+- `npm run db:migrate` - Run database migrations
+- `npm run db:studio` - Open Prisma Studio
+
 ## Documentation
 
 - [API Reference](./docs/api.md)
 - [Model Definition Guide](./docs/models.md)
 - [Custom Routes](./docs/custom-routes.md)
+- [CLI Reference](./docs/cli.md)
 - [Deployment Guide](./docs/deployment.md)
 
 ## Contributing

package/bin/crudora.js

@@ -0,0 +1,25 @@
+#!/usr/bin/env node
+
+import { fileURLToPath } from 'url';
+import { dirname } from 'path';
+import { createRequire } from 'module';
+
+const require = createRequire(import.meta.url);
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+let cliPath;
+try {
+  cliPath = new URL('../dist/cli.js', import.meta.url);
+  await import(cliPath);
+} catch (error) {
+  try {
+    cliPath = new URL('../src/cli.ts', import.meta.url);
+    const tsNodePath = require.resolve('ts-node/register');
+    require(tsNodePath);
+    await import(cliPath);
+  } catch (innerError) {
+    console.error('Error loading CLI:', innerError);
+    process.exit(1);
+  }
+}

package/dist/bin/crudora.js

@@ -0,0 +1,25 @@
+#!/usr/bin/env node
+
+import { fileURLToPath } from 'url';
+import { dirname } from 'path';
+import { createRequire } from 'module';
+
+const require = createRequire(import.meta.url);
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+let cliPath;
+try {
+  cliPath = new URL('../dist/cli.js', import.meta.url);
+  await import(cliPath);
+} catch (error) {
+  try {
+    cliPath = new URL('../src/cli.ts', import.meta.url);
+    const tsNodePath = require.resolve('ts-node/register');
+    require(tsNodePath);
+    await import(cliPath);
+  } catch (innerError) {
+    console.error('Error loading CLI:', innerError);
+    process.exit(1);
+  }
+}

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,233 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+// Ubah semua import menjadi require
+const commander_1 = require("commander");
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const child_process_1 = require("child_process");
+function initProject() {
+    const templatePath = path_1.default.join(__dirname, '..', 'templates', 'schema.prisma');
+    const targetPrismaPath = path_1.default.join(process.cwd(), 'prisma', 'schema.prisma');
+    const targetEnvPath = path_1.default.join(process.cwd(), '.env');
+    const targetServerPath = path_1.default.join(process.cwd(), 'src', 'server.ts'); // Ubah ke .ts
+    const targetPackagePath = path_1.default.join(process.cwd(), 'package.json');
+    console.log('🚀 Setting up Crudora project...');
+    // 1. Create prisma directory and schema
+    if (!fs_1.default.existsSync(path_1.default.dirname(targetPrismaPath))) {
+        console.log('📋 Creating Prisma schema...');
+        fs_1.default.mkdirSync(path_1.default.dirname(targetPrismaPath), { recursive: true });
+        fs_1.default.copyFileSync(templatePath, targetPrismaPath);
+        console.log('✅ Prisma schema created at prisma/schema.prisma');
+    }
+    else {
+        console.log('📋 Prisma directory already exists, skipping schema creation');
+    }
+    // 2. Create .env file
+    if (!fs_1.default.existsSync(targetEnvPath)) {
+        console.log('🔧 Creating .env file...');
+        const envContent = fs_1.default.readFileSync(path_1.default.join(__dirname, '..', 'templates', '.env.example'), 'utf8');
+        fs_1.default.writeFileSync(targetEnvPath, envContent);
+        console.log('✅ .env file created');
+    }
+    else {
+        console.log('🔧 .env file already exists, skipping creation');
+    }
+    // 3. Create basic server setup with TypeScript and ESM
+    if (!fs_1.default.existsSync(targetServerPath)) {
+        console.log('🖥️  Creating server setup...');
+        const serverContent = `import { CrudoraServer } from 'crudora';
+import { PrismaClient } from '@prisma/client';
+import dotenv from 'dotenv';
+dotenv.config();
+
+const prisma = new PrismaClient();
+
+// Example User model (uncomment and modify as needed)
+/*
+class User {
+  static tableName = 'users';
+  static primaryKey = 'id';
+  static timestamps = true;
+  static fillable = ['name', 'email'];
+  static hidden = ['password'];
+}
+*/
+
+const server = new CrudoraServer({
+  port: Number(process.env.PORT) || 3000,
+  prisma: prisma,
+  cors: true,
+  basePath: process.env.API_BASE_PATH || '/api'
+});
+
+// Register your models here
+// server.registerModel(User);
+
+// Add custom routes if needed
+server.get('/health', (req, res) => {
+  res.json({ status: 'ok', timestamp: new Date() });
+});
+
+// Generate routes and start server
+server
+  .generateRoutes()
+  .listen(() => {
+    console.log('🚀 Crudora server is running!');
+    console.log('📚 API documentation: http://localhost:\${process.env.PORT || 3000}\${process.env.API_BASE_PATH || '/api'}');
+  });
+`;
+        fs_1.default.writeFileSync(targetServerPath, serverContent);
+        console.log('✅ Server setup created at server.ts');
+    }
+    else {
+        console.log('🖥️  server.ts already exists, skipping creation');
+    }
+    // 4. Update package.json scripts (if package.json exists)
+    if (fs_1.default.existsSync(targetPackagePath)) {
+        try {
+            const packageJson = JSON.parse(fs_1.default.readFileSync(targetPackagePath, 'utf8'));
+            if (!packageJson.scripts) {
+                packageJson.scripts = {};
+            }
+            // Add useful scripts if they don't exist
+            const scriptsToAdd = {
+                'dev': 'ts-node server.ts',
+                'start': 'ts-node server.ts',
+                'build': 'tsc',
+                'start:prod': 'node dist/server.js',
+            };
+            let scriptsAdded = false;
+            for (const [scriptName, scriptCommand] of Object.entries(scriptsToAdd)) {
+                if (!packageJson.scripts[scriptName]) {
+                    packageJson.scripts[scriptName] = scriptCommand;
+                    scriptsAdded = true;
+                }
+            }
+            if (scriptsAdded) {
+                fs_1.default.writeFileSync(targetPackagePath, JSON.stringify(packageJson, null, 2));
+                console.log('✅ Package.json scripts updated');
+            }
+        }
+        catch (error) {
+            console.log('⚠️  Could not update package.json scripts:', error.message);
+        }
+    }
+    // 5. Create tsconfig.json if it doesn't exist
+    const targetTsConfigPath = path_1.default.join(process.cwd(), 'tsconfig.json');
+    if (!fs_1.default.existsSync(targetTsConfigPath)) {
+        console.log('📝 Creating tsconfig.json...');
+        const tsConfigContent = {
+            "compilerOptions": {
+                "target": "ES2020",
+                "module": "NodeNext",
+                "moduleResolution": "NodeNext",
+                "lib": ["ES2020"],
+                "outDir": "./dist",
+                "rootDir": "./",
+                "strict": true,
+                "esModuleInterop": true,
+                "skipLibCheck": true,
+                "forceConsistentCasingInFileNames": true,
+                "experimentalDecorators": true,
+                "emitDecoratorMetadata": true,
+                "resolveJsonModule": true,
+                "declaration": true,
+                "sourceMap": true
+            },
+            "include": ["*.ts", "src/**/*"],
+            "exclude": ["node_modules", "dist", "**/*.test.ts"]
+        };
+        fs_1.default.writeFileSync(targetTsConfigPath, JSON.stringify(tsConfigContent, null, 2));
+        console.log('✅ tsconfig.json created');
+    }
+    console.log('\n🎉 Crudora setup complete!');
+    console.log('\n📝 Next steps:');
+    console.log('1. Install dependencies: npm install @prisma/client prisma dotenv ts-node typescript');
+    console.log('2. Generate Prisma client: npx prisma generate');
+    console.log('3. Push database schema: npx prisma db push');
+    console.log('4. Define your models in server.ts');
+    console.log('5. Start development server: npm run dev');
+    console.log('\n📖 Documentation: https://github.com/suryamsj/crudora#readme');
+}
+function runPrismaStudio() {
+    console.log('🚀 Starting Prisma Studio...');
+    try {
+        (0, child_process_1.execSync)('npx prisma studio', { stdio: 'inherit' });
+    }
+    catch (error) {
+        console.error('❌ Failed to start Prisma Studio:', error.message);
+        process.exit(1);
+    }
+}
+function generatePrismaClient() {
+    console.log('🔧 Generating Prisma Client...');
+    try {
+        (0, child_process_1.execSync)('npx prisma generate', { stdio: 'inherit' });
+        console.log('✅ Prisma Client generated successfully');
+    }
+    catch (error) {
+        console.error('❌ Failed to generate Prisma Client:', error.message);
+        process.exit(1);
+    }
+}
+function pushPrismaSchema() {
+    console.log('🔄 Pushing Prisma schema to database...');
+    try {
+        (0, child_process_1.execSync)('npx prisma db push', { stdio: 'inherit' });
+        console.log('✅ Schema pushed to database successfully');
+    }
+    catch (error) {
+        console.error('❌ Failed to push schema to database:', error.message);
+        process.exit(1);
+    }
+}
+function migratePrismaSchema() {
+    console.log('🔄 Running Prisma migrations...');
+    try {
+        (0, child_process_1.execSync)('npx prisma migrate dev', { stdio: 'inherit' });
+        console.log('✅ Migrations completed successfully');
+    }
+    catch (error) {
+        console.error('❌ Failed to run migrations:', error.message);
+        process.exit(1);
+    }
+}
+// Membuat CLI program
+const program = new commander_1.Command();
+program
+    .name('crudora')
+    .description('CLI for Crudora - TypeScript framework for automated CRUD API generation')
+    .version('0.1.0-alpha.3');
+program
+    .command('init')
+    .description('Initialize a new Crudora project')
+    .action(initProject);
+program
+    .command('studio')
+    .description('Start Prisma Studio')
+    .action(runPrismaStudio);
+program
+    .command('generate')
+    .description('Generate Prisma Client')
+    .action(generatePrismaClient);
+program
+    .command('push')
+    .description('Push Prisma schema to database')
+    .action(pushPrismaSchema);
+program
+    .command('migrate')
+    .description('Run Prisma migrations')
+    .action(migratePrismaSchema);
+program.parse();
+// Di akhir file, ubah export jika ada
+module.exports = {
+    initProject,
+    runPrismaStudio,
+    generatePrismaClient,
+    pushPrismaSchema,
+    migratePrismaSchema
+};
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/core/crudora.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"crudora.d.ts","sourceRoot":"","sources":["../../src/core/crudora.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAG1C,OAAO,EAAE,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAElD,qBAAa,OAAO;IAClB,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,MAAM,CAA4C;IAC1D,OAAO,CAAC,YAAY,CAA2C;IAC/D,OAAO,CAAC,YAAY,CAIZ;gBAEI,MAAM,CAAC,EAAE,YAAY;IAQjC,aAAa,CAAC,GAAG,YAAY,EAAE,gBAAgB,EAAE,GAAG,IAAI;IAWxD,aAAa,CAAC,CAAC,SAAS,KAAK,EAAE,UAAU,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC;IAQ9E,oBAAoB,CAAC,gBAAgB,CAAC,EAAE,MAAM,GAAG,MAAM;IAKvD,mBAAmB,CAAC,CAAC,SAAS,KAAK,EAAE,UAAU,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAI5F,yBAAyB,CAAC,CAAC,SAAS,KAAK,EAAE,UAAU,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IAKzF,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,KAAK,IAAI,GAAG,IAAI;IAK9D,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,KAAK,IAAI,GAAG,IAAI;IAK/D,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,KAAK,IAAI,GAAG,IAAI;IAK9D,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,KAAK,IAAI,GAAG,IAAI;IAKjE,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,KAAK,IAAI,GAAG,IAAI;IAMhE,cAAc,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,GAAE,MAAe,GAAG,IAAI;CA+G9D"}
+{"version":3,"file":"crudora.d.ts","sourceRoot":"","sources":["../../src/core/crudora.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAG1C,OAAO,EAAE,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAElD,qBAAa,OAAO;IAClB,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,MAAM,CAA4C;IAC1D,OAAO,CAAC,YAAY,CAA2C;IAC/D,OAAO,CAAC,YAAY,CAIZ;gBAEI,MAAM,CAAC,EAAE,YAAY;IAQjC,aAAa,CAAC,GAAG,YAAY,EAAE,gBAAgB,EAAE,GAAG,IAAI;IAWxD,aAAa,CAAC,CAAC,SAAS,KAAK,EAAE,UAAU,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC;IAQ9E,oBAAoB,CAAC,gBAAgB,CAAC,EAAE,MAAM,GAAG,MAAM;IAKvD,mBAAmB,CAAC,CAAC,SAAS,KAAK,EAAE,UAAU,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAI5F,yBAAyB,CAAC,CAAC,SAAS,KAAK,EAAE,UAAU,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IAKzF,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,KAAK,IAAI,GAAG,IAAI;IAK9D,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,KAAK,IAAI,GAAG,IAAI;IAK/D,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,KAAK,IAAI,GAAG,IAAI;IAK9D,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,KAAK,IAAI,GAAG,IAAI;IAKjE,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,KAAK,IAAI,GAAG,IAAI;IAOhE,cAAc,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,GAAE,MAAe,GAAG,IAAI;CAsK9D"}

package/dist/core/crudora.js

@@ -64,7 +64,52 @@ class Crudora {
         return this;
     }
     // Auto-generate REST API routes
+    // Auto-generate REST API routes
     generateRoutes(app, basePath = '/api') {
+        // Add API documentation endpoint
+        app.get(basePath, (req, res) => {
+            const routes = [];
+            // Add CRUD routes for each model
+            for (const [modelName, modelClass] of this.models) {
+                const routePath = `${basePath}/${modelClass.getTableName()}`;
+                routes.push({
+                    method: 'GET',
+                    path: routePath,
+                    description: `List all ${modelClass.getTableName()}`,
+                    type: 'CRUD'
+                }, {
+                    method: 'GET',
+                    path: `${routePath}/:id`,
+                    description: `Get ${modelClass.getTableName()} by ID`,
+                    type: 'CRUD'
+                }, {
+                    method: 'POST',
+                    path: routePath,
+                    description: `Create new ${modelClass.getTableName()}`,
+                    type: 'CRUD'
+                }, {
+                    method: 'PUT',
+                    path: `${routePath}/:id`,
+                    description: `Update ${modelClass.getTableName()} by ID`,
+                    type: 'CRUD'
+                }, {
+                    method: 'DELETE',
+                    path: `${routePath}/:id`,
+                    description: `Delete ${modelClass.getTableName()} by ID`,
+                    type: 'CRUD'
+                });
+            }
+            // Add custom routes
+            for (const route of this.customRoutes) {
+                routes.push({
+                    method: route.method,
+                    path: `${basePath}${route.path}`,
+                    description: `Custom ${route.method} route`,
+                    type: 'Custom'
+                });
+            }
+            res.json({ routes });
+        });
         // Generate CRUD routes for models
         for (const [modelName, modelClass] of this.models) {
             const repository = this.getRepository(modelClass);
@@ -108,11 +153,11 @@ class Crudora {
                     res.status(500).json({ error: 'Internal server error' });
                 }
             });
-            // POST /api/model - Create (gunakan strict validation)
+            // POST /api/model - Create
             app.post(routePath, async (req, res) => {
                 try {
-                    const strictValidationSchema = this.getStrictValidationSchema(modelClass);
-                    const validatedData = strictValidationSchema.parse(req.body);
+                    // Gunakan partial validation schema instead of strict
+                    const validatedData = validationSchema.parse(req.body);
                     const item = await repository.create(validatedData);
                     res.status(201).json(item);
                 }