@restforgejs/platform 5.1.7 → 5.1.20

package/generators/lib/utils/database-introspector.js

@@ -975,6 +975,54 @@ class DatabaseIntrospector {
     }
   }
 
+  /**
+   * Get CHECK constraints for a table (PostgreSQL, Fase 1).
+   *
+   * Mengembalikan `{ name, clause }` per CHECK constraint, di mana `clause` adalah
+   * definisi lengkap dari `pg_get_constraintdef` (mis.
+   * `CHECK ((is_deleted = ...) OR (...))`). Cukup untuk:
+   *   - mengenali CHECK konsistensi soft-delete lewat NAMA deterministik
+   *     (`chk_<table>_soft_delete_consistency`, R8) di introspect-mapper (R6), dan
+   *   - parse CHECK generik single-field (`age >= 0`, dll.) di introspect-mapper.
+   *
+   * Hanya PostgreSQL yang diimplementasikan: Fase 1 soft-delete adalah PostgreSQL-only,
+   * dan dialect lain (mysql/oracle) memakai penanda boolean `col IN ('true','false')`
+   * yang sudah ditangani jalur `getBooleanColumns` terpisah. Memasukkan penanda boolean
+   * itu ke `checks` justru akan menimbulkan false drift di diff dbschema-kit (sisi SDF
+   * tidak menyimpan penanda boolean di `checks`), maka non-PostgreSQL mengembalikan [].
+   *
+   * Degradasi anggun: bila katalog tidak tersedia, error di-catch dan dikembalikan []
+   * (mengikuti pola `getBooleanColumns`).
+   *
+   * @param {string} tableName - Nama table (boleh schema.tablename atau tablename)
+   * @returns {Promise<Array<{name:string, clause:string}>>}
+   */
+  async getCheckConstraints(tableName) {
+    if (!this.pool) return [];
+
+    // Fase 1: introspeksi CHECK hanya untuk PostgreSQL (lihat doc di atas).
+    if (this.dbType !== 'postgresql') return [];
+
+    try {
+      const { schema, table } = this.parseTableName(tableName);
+      const rows = await this.query(
+        `SELECT con.conname AS name,
+                pg_get_constraintdef(con.oid) AS clause
+         FROM pg_constraint con
+         JOIN pg_class rel ON rel.oid = con.conrelid
+         JOIN pg_namespace ns ON ns.oid = rel.relnamespace
+         WHERE con.contype = 'c'
+           AND ns.nspname = $1 AND rel.relname = $2
+         ORDER BY con.conname`,
+        [schema, table]
+      );
+      return rows.map(r => ({ name: r.name, clause: r.clause }));
+    } catch (error) {
+      console.warn(`  Warning: Could not fetch check constraints: ${error.message}`);
+      return [];
+    }
+  }
+
   /**
    * Deteksi kolom boolean pada dialect varchar (mysql/oracle/sqlite) lewat
    * penanda CHECK `<col> IN ('true','false')` yang di-emit dbschema-kit.

package/generators/lib/utils/env-manager.js

@@ -133,7 +133,7 @@ function updateEnvKey(filePath, key, value, createIfNotExist = true) {
     if (fs.existsSync(filePath)) {
         envData = readEnvFile(filePath);
     } else if (!createIfNotExist) {
-        throw new Error(`File ${filePath} tidak ditemukan`);
+        throw new Error(`File ${filePath} not found`);
     }
 
     // Update data
@@ -161,7 +161,7 @@ function updateEnvKey(filePath, key, value, createIfNotExist = true) {
  */
 function removeEnvKey(filePath, key, softDelete = true) {
     if (!fs.existsSync(filePath)) {
-        throw new Error(`File ${filePath} tidak ditemukan`);
+        throw new Error(`File ${filePath} not found`);
     }
 
     const envData = readEnvFile(filePath);
@@ -252,7 +252,7 @@ function validateEnvFile(filePath) {
     if (!fs.existsSync(filePath)) {
         return {
             valid: false,
-            error: `File ${filePath} tidak ditemukan`
+            error: `File ${filePath} not found`
         };
     }
 
@@ -294,7 +294,7 @@ function validateEnvFile(filePath) {
  */
 function backupEnvFile(filePath) {
     if (!fs.existsSync(filePath)) {
-        throw new Error(`File ${filePath} tidak ditemukan`);
+        throw new Error(`File ${filePath} not found`);
     }
 
     const timestamp = new Date().toISOString().replace(/[:.]/g, '-');

package/generators/lib/utils/file-utils.js

@@ -286,7 +286,7 @@ class FileUtils {
    */
   static copyFileWithValidation(fileInfo) {
     if (!fs.existsSync(fileInfo.source)) {
-      throw new Error(`Source file tidak ditemukan: ${fileInfo.source}`);
+      throw new Error(`Source file not found: ${fileInfo.source}`);
     }
 
     console.log(`Copying SQL file: ${fileInfo.originalPath} -> ${path.basename(fileInfo.dest)}`);
@@ -297,14 +297,14 @@ class FileUtils {
       
       // Verifikasi copy result
       if (!fs.existsSync(fileInfo.dest)) {
-        throw new Error('Destination file tidak berhasil dibuat');
+        throw new Error('Destination file was not created');
       }
       
       const sourceStats = fs.statSync(fileInfo.source);
       const destStats = fs.statSync(fileInfo.dest);
       
       if (destStats.size === 0) {
-        throw new Error('Destination file kosong setelah copy');
+        throw new Error('Destination file is empty after copy');
       }
       
       if (sourceStats.size !== destStats.size) {
@@ -329,12 +329,12 @@ class FileUtils {
   static readFileWithErrorHandling(filePath, encoding = 'utf8') {
     try {
       if (!fs.existsSync(filePath)) {
-        throw new Error(`File tidak ditemukan: ${filePath}`);
+        throw new Error(`File not found: ${filePath}`);
       }
 
       const stats = fs.statSync(filePath);
       if (stats.size === 0) {
-        console.warn(`Warning: File kosong: ${filePath}`);
+        console.warn(`Warning: File is empty: ${filePath}`);
         return '';
       }
 
@@ -374,7 +374,7 @@ class FileUtils {
 
       // Verifikasi
       if (!fs.existsSync(filePath)) {
-        throw new Error('File tidak berhasil dibuat setelah write operation');
+        throw new Error('File was not created after the write operation');
       }
 
       const stats = fs.statSync(filePath);

package/generators/lib/utils/payload-processor.js

@@ -675,6 +675,14 @@ class PayloadProcessor {
     // Note: 'add' dan 'list' sudah di-convert ke 'create' dan 'read' oleh applyActionAliases()
     const validActions = ['datatables', 'create', 'update', 'delete', 'first', 'lookup', 'read', 'export', 'import', 'adjust', 'aggregate', 'createComposite', 'updateComposite', 'readComposite', 'workflow'];
 
+    // Opt-in actions (soft-delete R20): dikenali generator TAPI TIDAK diberi default-false.
+    // Hanya disertakan di output normalized bila dideklarasikan eksplisit di payload. Ini
+    // menjaga gate diff-zero: objek action untuk payload non-restore tetap byte-identik
+    // baseline (tidak ada key `restore` tambahan yang bisa bocor ke output ter-generate,
+    // mis. /info). Bila restore=true, key dipertahankan sehingga route `/restore` +
+    // `restoreData` ter-generate (validator R17 memaksa softDelete.enabled bila restore=true).
+    const optInActions = ['restore'];
+
     // Action aliases yang dikenali di payload tapi tidak perlu di-normalize lagi
     // (sudah di-handle oleh applyActionAliases sebelum sampai di sini)
     const knownAliases = Object.keys(this.ACTION_ALIASES);
@@ -690,9 +698,17 @@ class PayloadProcessor {
       }
     }
 
-    // Warn about unknown actions (skip known aliases)
+    // Process opt-in actions: TANPA default-false (lihat catatan optInActions di atas).
+    // Hanya muncul di normalized bila key hadir di payload, menjaga diff-zero non-restore.
+    for (const action of optInActions) {
+      if (action in actions) {
+        normalized[action] = Boolean(actions[action]);
+      }
+    }
+
+    // Warn about unknown actions (skip known aliases + opt-in actions yang dikenali)
     for (const action of Object.keys(actions)) {
-      if (!validActions.includes(action) && !knownAliases.includes(action)) {
+      if (!validActions.includes(action) && !optInActions.includes(action) && !knownAliases.includes(action)) {
         console.warn(`Unknown action '${action}' will be ignored`);
       }
     }

package/generators/lib/validators/argument-validator.js

@@ -519,12 +519,12 @@ class ArgumentValidator {
  
      // Warning untuk force overwrite
      if (args.force) {
-       summary.warnings.push('Mode force overwrite aktif - file yang sudah ada akan ditimpa tanpa konfirmasi');
+       summary.warnings.push('Force overwrite mode is active - existing files will be overwritten without confirmation');
      }
  
      // Warning untuk Oracle database
      if (args.database === 'oracle') {
-       summary.warnings.push('Menggunakan Oracle database - pastikan utils/oracle.js tersedia');
+       summary.warnings.push('Using Oracle database - make sure utils/oracle.js is available');
      }
  
      return summary;

package/generators/lib/validators/dashboard-validator.js

@@ -1,7 +1,8 @@
 const fs = require('fs');
 const path = require('path');
 const PayloadProcessor = require('../utils/payload-processor');
-const sqlTableExtractor = require('../utils/sql-table-extractor');
+const sqlTableExtractor = require('../../../src/utils/sql-table-extractor');
+const softDeleteDashboardGuard = require('../../../src/utils/soft-delete-dashboard-guard');
 
 const FORBIDDEN_FRONTEND_FIELDS = ['widgetType', 'layout', 'title', 'subtitle', 'color'];
 const ALLOWED_PARAM_TYPES = ['string', 'number', 'boolean', 'date'];
@@ -40,6 +41,8 @@ class DashboardValidator {
 
     this._validateWidgets(payload.widgets, declaredParams, payloadDir);
 
+    this._validateSoftDeleteGuard(payload, payloadDir);
+
     this._validateCacheBlock(payload.cache);
 
     if (
@@ -167,6 +170,37 @@ class DashboardValidator {
     }
   }
 
+  /**
+   * Checkpoint soft-delete (ERROR) untuk `dashboard create`.
+   *
+   * Bangun registry tabel soft-delete dari scan payloadDir, lalu cek tiap widget.
+   * Bila ada widget yang mereferensikan tabel soft-delete tanpa token `is_deleted`,
+   * lempar Error yang memblok `dashboard create`. Registry kosong (project tanpa
+   * tabel soft-delete) → no-op, sehingga perilaku project lama tidak berubah.
+   *
+   * Resolusi SQL di-delegasikan ke `_resolveSqlText` (sudah memverifikasi file:
+   * reference pada `_validateWidgets`, jadi di titik ini file dijamin ada).
+   */
+  static _validateSoftDeleteGuard(payload, payloadDir) {
+    const registry = softDeleteDashboardGuard.buildSoftDeleteRegistry(payloadDir);
+    if (registry.size === 0) return;
+
+    const violations = softDeleteDashboardGuard.checkDashboardViolations(
+      payload,
+      (sqlOrRef, widgetId, key) => this._resolveSqlText(
+        widgetId,
+        key === null ? 'query' : `queries.${key}`,
+        sqlOrRef,
+        payloadDir
+      ),
+      registry
+    );
+
+    if (violations.length > 0) {
+      throw new Error(softDeleteDashboardGuard.formatViolationMessage(violations[0]));
+    }
+  }
+
   static _resolveSqlText(widgetId, queryLabel, sqlOrRef, payloadDir) {
     if (!PayloadProcessor.isFileReference(sqlOrRef)) {
       return sqlOrRef;