@restforgejs/platform 4.1.1 → 4.3.1

package/generators/tests/unit/lib/dashboard-generator.test.js

@@ -1,895 +0,0 @@
-'use strict';
-
-const test = require('node:test');
-const { before, after } = require('node:test');
-const assert = require('node:assert');
-const fs = require('fs');
-const os = require('os');
-const path = require('path');
-
-const DashboardGenerator = require('../../../lib/generators/dashboard-generator');
-const ConfigReader = require('../../../lib/config/config-reader');
-
-const SAMPLE_PAYLOAD_PATH = path.resolve(
-  __dirname,
-  '../../../../restforge/docs/architecture/dashboard-architecture/payload/dashboard-sales.json'
-);
-
-const SAMPLE_PAYLOAD_DIR = path.dirname(SAMPLE_PAYLOAD_PATH);
-
-function loadSamplePayload() {
-  return JSON.parse(fs.readFileSync(SAMPLE_PAYLOAD_PATH, 'utf8'));
-}
-
-function makeTmpDir() {
-  return fs.mkdtempSync(path.join(os.tmpdir(), 'dash-gen-test-'));
-}
-
-/**
- * Override ConfigReader.getWorkingDirectory selama eksekusi callback.
- * Pendekatan ini menghindari mutasi process.cwd() global yang bisa
- * bocor antar test paralel.
- */
-function withWorkingDir(dir, fn) {
-  const original = ConfigReader.getWorkingDirectory;
-  ConfigReader.getWorkingDirectory = () => dir;
-  try {
-    return fn();
-  } finally {
-    ConfigReader.getWorkingDirectory = original;
-  }
-}
-
-// Suppress noisy console output dari FileUtils.setupModuleDirectories
-// tanpa menyembunyikan error sebenarnya.
-let _originalLog;
-let _originalWarn;
-before(() => {
-  _originalLog = console.log;
-  _originalWarn = console.warn;
-  console.log = () => {};
-  console.warn = () => {};
-});
-after(() => {
-  console.log = _originalLog;
-  console.warn = _originalWarn;
-});
-
-// ===== collectSqlFileReferences =====
-
-test('collectSqlFileReferences: payload sample mengembalikan 4 file SQL relatif terhadap payload dir', () => {
-  const payload = loadSamplePayload();
-  const refs = DashboardGenerator.collectSqlFileReferences(payload.widgets);
-  const sorted = [...refs].sort();
-  const expected = [
-    'query/author-sales.sql',
-    'query/sales-statistics.sql',
-    'query/sales-this-months-points.sql',
-    'query/sales-this-months-value.sql'
-  ].sort();
-  assert.deepStrictEqual(sorted, expected);
-});
-
-// ===== createDashboardModule: output struktur =====
-
-test('createDashboardModule: file output dibuat di src/modules/{project}/dash-{name}.js', () => {
-  const tmpDir = makeTmpDir();
-  withWorkingDir(tmpDir, () => {
-    const payload = loadSamplePayload();
-    const result = DashboardGenerator.createDashboardModule(
-      'mini-inventory', 'dash-sales', payload,
-      { force: true, payloadDir: SAMPLE_PAYLOAD_DIR }
-    );
-    const expected = path.join(
-      tmpDir, 'src', 'modules', 'mini-inventory', 'dash-sales.js'
-    );
-    assert.strictEqual(result.filePath, expected);
-    assert.strictEqual(result.generated, true);
-    assert.strictEqual(fs.existsSync(expected), true);
-  });
-});
-
-test('createDashboardModule: folder src/models/{project}/dash-{name}/query/ TIDAK dibuat (SQL embedded, no copy)', () => {
-  const tmpDir = makeTmpDir();
-  withWorkingDir(tmpDir, () => {
-    const payload = loadSamplePayload();
-    DashboardGenerator.createDashboardModule(
-      'mini-inventory', 'dash-sales', payload,
-      { force: true, payloadDir: SAMPLE_PAYLOAD_DIR }
-    );
-    const dashboardQueryDir = path.join(
-      tmpDir, 'src', 'models', 'mini-inventory', 'dash-sales', 'query'
-    );
-    assert.strictEqual(
-      fs.existsSync(dashboardQueryDir),
-      false,
-      'folder dashboard query tidak boleh terbuat (SQL sudah embedded di JS)'
-    );
-  });
-});
-
-test('createDashboardModule: output mengandung require express, dashboard-helpers, db', () => {
-  const tmpDir = makeTmpDir();
-  withWorkingDir(tmpDir, () => {
-    const payload = loadSamplePayload();
-    DashboardGenerator.createDashboardModule(
-      'mini-inventory', 'dash-sales', payload,
-      { force: true, payloadDir: SAMPLE_PAYLOAD_DIR }
-    );
-    const filePath = path.join(
-      tmpDir, 'src', 'modules', 'mini-inventory', 'dash-sales.js'
-    );
-    const content = fs.readFileSync(filePath, 'utf8');
-    assert.ok(content.includes("require('express')"), 'harus require express');
-    assert.ok(
-      content.includes("require('restforgejs/src/utils/dashboard-helpers')"),
-      'harus require dashboard-helpers via npm package style restforgejs/src/utils/...'
-    );
-    assert.ok(
-      content.includes("require('restforgejs/src/utils/db')"),
-      'harus require db utility via npm package style'
-    );
-    assert.ok(
-      !content.includes("require('../../utils/"),
-      'tidak boleh emit relative path require ../../utils/... — anti-pattern di deployment'
-    );
-  });
-});
-
-test('createDashboardModule: output mengandung paramsContract constant', () => {
-  const tmpDir = makeTmpDir();
-  withWorkingDir(tmpDir, () => {
-    const payload = loadSamplePayload();
-    DashboardGenerator.createDashboardModule(
-      'mini-inventory', 'dash-sales', payload,
-      { force: true, payloadDir: SAMPLE_PAYLOAD_DIR }
-    );
-    const filePath = path.join(
-      tmpDir, 'src', 'modules', 'mini-inventory', 'dash-sales.js'
-    );
-    const content = fs.readFileSync(filePath, 'utf8');
-    assert.match(content, /const paramsContract\s*=/);
-  });
-});
-
-test('createDashboardModule: output mengandung allWidgetIds array literal dengan ID widget yang benar', () => {
-  const tmpDir = makeTmpDir();
-  withWorkingDir(tmpDir, () => {
-    const payload = loadSamplePayload();
-    DashboardGenerator.createDashboardModule(
-      'mini-inventory', 'dash-sales', payload,
-      { force: true, payloadDir: SAMPLE_PAYLOAD_DIR }
-    );
-    const filePath = path.join(
-      tmpDir, 'src', 'modules', 'mini-inventory', 'dash-sales.js'
-    );
-    const content = fs.readFileSync(filePath, 'utf8');
-    assert.match(content, /const allWidgetIds\s*=\s*\[/);
-    assert.ok(content.includes('"author_sales"'), 'allWidgetIds harus mengandung author_sales');
-    assert.ok(content.includes('"sales_statistics"'), 'allWidgetIds harus mengandung sales_statistics');
-    assert.ok(content.includes('"sales_this_months"'), 'allWidgetIds harus mengandung sales_this_months');
-  });
-});
-
-test('createDashboardModule: output mengandung router.post handler /dashboard', () => {
-  const tmpDir = makeTmpDir();
-  withWorkingDir(tmpDir, () => {
-    const payload = loadSamplePayload();
-    DashboardGenerator.createDashboardModule(
-      'mini-inventory', 'dash-sales', payload,
-      { force: true, payloadDir: SAMPLE_PAYLOAD_DIR }
-    );
-    const filePath = path.join(
-      tmpDir, 'src', 'modules', 'mini-inventory', 'dash-sales.js'
-    );
-    const content = fs.readFileSync(filePath, 'utf8');
-    assert.ok(
-      content.includes("router.post('/dashboard', async (req, res) => {"),
-      'output harus emit router.post handler untuk /dashboard'
-    );
-  });
-});
-
-test('createDashboardModule: output mengandung post-processing loop lowercaseKeysDeep + stringifyNumericDeep sebelum res.json', () => {
-  const tmpDir = makeTmpDir();
-  withWorkingDir(tmpDir, () => {
-    const payload = loadSamplePayload();
-    DashboardGenerator.createDashboardModule(
-      'mini-inventory', 'dash-sales', payload,
-      { force: true, payloadDir: SAMPLE_PAYLOAD_DIR }
-    );
-    const filePath = path.join(
-      tmpDir, 'src', 'modules', 'mini-inventory', 'dash-sales.js'
-    );
-    const content = fs.readFileSync(filePath, 'utf8');
-    assert.ok(
-      content.includes('helpers.lowercaseKeysDeep'),
-      'output harus memanggil helpers.lowercaseKeysDeep untuk normalisasi key Oracle UPPERCASE'
-    );
-    assert.ok(
-      content.includes('helpers.stringifyNumericDeep'),
-      'output harus memanggil helpers.stringifyNumericDeep untuk normalisasi numeric → string'
-    );
-    const lowerIdx = content.indexOf('helpers.lowercaseKeysDeep');
-    const stringifyIdx = content.indexOf('helpers.stringifyNumericDeep');
-    const resJsonIdx = content.indexOf('res.json(response)');
-    assert.ok(
-      lowerIdx < stringifyIdx,
-      'lowercaseKeysDeep harus dipanggil sebelum stringifyNumericDeep'
-    );
-    assert.ok(
-      stringifyIdx < resJsonIdx,
-      'post-processing loop harus dipanggil sebelum res.json(response)'
-    );
-    assert.match(
-      content,
-      /const response\s*=\s*\{\s*success:\s*true,\s*data\s*\};/,
-      'response envelope dibangun ke variable response sebelum res.json'
-    );
-  });
-});
-
-test('createDashboardModule: output mengandung Promise.allSettled call untuk eksekusi paralel', () => {
-  const tmpDir = makeTmpDir();
-  withWorkingDir(tmpDir, () => {
-    const payload = loadSamplePayload();
-    DashboardGenerator.createDashboardModule(
-      'mini-inventory', 'dash-sales', payload,
-      { force: true, payloadDir: SAMPLE_PAYLOAD_DIR }
-    );
-    const filePath = path.join(
-      tmpDir, 'src', 'modules', 'mini-inventory', 'dash-sales.js'
-    );
-    const content = fs.readFileSync(filePath, 'utf8');
-    assert.ok(content.includes('Promise.allSettled'), 'harus pakai Promise.allSettled');
-  });
-});
-
-test('createDashboardModule: output mengandung module.exports = router', () => {
-  const tmpDir = makeTmpDir();
-  withWorkingDir(tmpDir, () => {
-    const payload = loadSamplePayload();
-    DashboardGenerator.createDashboardModule(
-      'mini-inventory', 'dash-sales', payload,
-      { force: true, payloadDir: SAMPLE_PAYLOAD_DIR }
-    );
-    const filePath = path.join(
-      tmpDir, 'src', 'modules', 'mini-inventory', 'dash-sales.js'
-    );
-    const content = fs.readFileSync(filePath, 'utf8');
-    assert.ok(content.includes('module.exports = router'));
-  });
-});
-
-test('createDashboardModule: payload tanpa params mengemit paramsContract = {}', () => {
-  const tmpDir = makeTmpDir();
-  withWorkingDir(tmpDir, () => {
-    const payload = loadSamplePayload();
-    assert.ok(!('params' in payload), 'sample payload tidak punya params');
-    DashboardGenerator.createDashboardModule(
-      'mini-inventory', 'dash-sales', payload,
-      { force: true, payloadDir: SAMPLE_PAYLOAD_DIR }
-    );
-    const filePath = path.join(
-      tmpDir, 'src', 'modules', 'mini-inventory', 'dash-sales.js'
-    );
-    const content = fs.readFileSync(filePath, 'utf8');
-    assert.match(content, /const paramsContract\s*=\s*\{\}/);
-  });
-});
-
-// ===== SQL embedded =====
-
-test('createDashboardModule: SQL author-sales.sql ter-embed apa adanya di output (string match)', () => {
-  const tmpDir = makeTmpDir();
-  withWorkingDir(tmpDir, () => {
-    const payload = loadSamplePayload();
-    DashboardGenerator.createDashboardModule(
-      'mini-inventory', 'dash-sales', payload,
-      { force: true, payloadDir: SAMPLE_PAYLOAD_DIR }
-    );
-    const filePath = path.join(
-      tmpDir, 'src', 'modules', 'mini-inventory', 'dash-sales.js'
-    );
-    const content = fs.readFileSync(filePath, 'utf8');
-    assert.ok(content.includes('country AS label'), 'fragment SQL author-sales harus muncul di output');
-    assert.ok(content.includes('SUM(amount) AS value'), 'fragment SQL author-sales harus muncul di output');
-    assert.ok(content.includes('GROUP BY country'), 'fragment SQL author-sales harus muncul di output');
-  });
-});
-
-test('createDashboardModule: SQL semua 4 fixture file dashboard-sales ter-embed', () => {
-  const tmpDir = makeTmpDir();
-  withWorkingDir(tmpDir, () => {
-    const payload = loadSamplePayload();
-    DashboardGenerator.createDashboardModule(
-      'mini-inventory', 'dash-sales', payload,
-      { force: true, payloadDir: SAMPLE_PAYLOAD_DIR }
-    );
-    const filePath = path.join(
-      tmpDir, 'src', 'modules', 'mini-inventory', 'dash-sales.js'
-    );
-    const content = fs.readFileSync(filePath, 'utf8');
-
-    // Marker khas tiap fixture
-    assert.ok(content.includes('country AS label'), 'author-sales.sql harus muncul');
-    assert.ok(content.includes('product_name AS label'), 'sales-statistics.sql harus muncul');
-    assert.ok(
-      content.includes("date_trunc('month', sale_date)"),
-      'sales-this-months-*.sql harus muncul'
-    );
-    assert.ok(
-      content.includes("TO_CHAR(sale_date, 'YYYY-MM-DD') AS period"),
-      'sales-this-months-points.sql (varian points) harus muncul'
-    );
-  });
-});
-
-// ===== SoC lock + residue lock =====
-
-test('createDashboardModule: SoC lock — output tidak boleh emit field frontend (widgetType, __dashboardEmbed, title, subtitle)', () => {
-  const tmpDir = makeTmpDir();
-  withWorkingDir(tmpDir, () => {
-    const payload = loadSamplePayload();
-    DashboardGenerator.createDashboardModule(
-      'mini-inventory', 'dash-sales', payload,
-      { force: true, payloadDir: SAMPLE_PAYLOAD_DIR }
-    );
-    const filePath = path.join(
-      tmpDir, 'src', 'modules', 'mini-inventory', 'dash-sales.js'
-    );
-    const content = fs.readFileSync(filePath, 'utf8');
-
-    assert.ok(!content.includes('widgetType'), 'tidak boleh emit widgetType');
-    assert.ok(!content.includes('__dashboardEmbed'), 'tidak boleh emit __dashboardEmbed');
-    assert.ok(!/['"]title['"]\s*:/.test(content), 'tidak boleh emit field title');
-    assert.ok(!/['"]subtitle['"]\s*:/.test(content), 'tidak boleh emit field subtitle');
-  });
-});
-
-test('createDashboardModule: residue lock — output tidak boleh mengandung pattern lama (widgetsConfig/queryDir/dashboardRunner/runDashboard/queryFile/queryFiles)', () => {
-  const tmpDir = makeTmpDir();
-  withWorkingDir(tmpDir, () => {
-    const payload = loadSamplePayload();
-    DashboardGenerator.createDashboardModule(
-      'mini-inventory', 'dash-sales', payload,
-      { force: true, payloadDir: SAMPLE_PAYLOAD_DIR }
-    );
-    const filePath = path.join(
-      tmpDir, 'src', 'modules', 'mini-inventory', 'dash-sales.js'
-    );
-    const content = fs.readFileSync(filePath, 'utf8');
-
-    assert.ok(!content.includes('widgetsConfig'), 'residue widgetsConfig harus hilang');
-    assert.ok(!content.includes('queryDir'), 'residue queryDir harus hilang');
-    assert.ok(!content.includes('dashboardRunner'), 'residue dashboardRunner harus hilang');
-    assert.ok(!content.includes('runDashboard'), 'residue runDashboard harus hilang');
-    assert.ok(!content.includes('queryFile'), 'residue queryFile harus hilang');
-    assert.ok(!content.includes('queryFiles'), 'residue queryFiles harus hilang');
-  });
-});
-
-// ===== Inline SQL rejection =====
-
-test('createDashboardModule: widget dengan inline SQL (tidak pakai file: prefix) ditolak', () => {
-  const tmpDir = makeTmpDir();
-  withWorkingDir(tmpDir, () => {
-    const payload = {
-      widgets: [{ id: 'x', query: 'SELECT 1' }]
-    };
-    assert.throws(
-      () => DashboardGenerator.createDashboardModule(
-        'mini-inventory', 'dash-sales', payload,
-        { force: true, payloadDir: SAMPLE_PAYLOAD_DIR }
-      ),
-      /inline SQL is not supported/
-    );
-  });
-});
-
-// ===== Conflict handling =====
-
-test('createDashboardModule: file sudah ada tanpa force harus throw error', () => {
-  const tmpDir = makeTmpDir();
-  withWorkingDir(tmpDir, () => {
-    const payload = loadSamplePayload();
-    DashboardGenerator.createDashboardModule(
-      'mini-inventory', 'dash-sales', payload,
-      { force: true, payloadDir: SAMPLE_PAYLOAD_DIR }
-    );
-    assert.throws(
-      () => DashboardGenerator.createDashboardModule(
-        'mini-inventory', 'dash-sales', payload,
-        { force: false, payloadDir: SAMPLE_PAYLOAD_DIR }
-      ),
-      /already exists/
-    );
-  });
-});
-
-test('createDashboardModule: file sudah ada dengan force=true harus archive lalu rewrite', () => {
-  const tmpDir = makeTmpDir();
-  withWorkingDir(tmpDir, () => {
-    const payload = loadSamplePayload();
-    DashboardGenerator.createDashboardModule(
-      'mini-inventory', 'dash-sales', payload,
-      { force: true, payloadDir: SAMPLE_PAYLOAD_DIR }
-    );
-    const moduleDir = path.join(tmpDir, 'src', 'modules', 'mini-inventory');
-    const liveFile = path.join(moduleDir, 'dash-sales.js');
-    const before = fs.statSync(liveFile).mtimeMs;
-
-    // Pastikan timestamp archive berbeda dengan menunggu sedikit
-    const start = Date.now();
-    while (Date.now() === start) { /* spin */ }
-
-    const result = DashboardGenerator.createDashboardModule(
-      'mini-inventory', 'dash-sales', payload,
-      { force: true, payloadDir: SAMPLE_PAYLOAD_DIR }
-    );
-
-    assert.ok(result.archivedPath, 'createDashboardModule harus return archivedPath bila override');
-    assert.strictEqual(fs.existsSync(result.archivedPath), true);
-
-    const files = fs.readdirSync(moduleDir);
-    const archived = files.filter((f) => f.startsWith('dash-sales.js.archive.'));
-    const live = files.filter((f) => f === 'dash-sales.js');
-    assert.strictEqual(live.length, 1);
-    assert.ok(archived.length >= 1, 'minimal satu archive file harus terbuat');
-
-    const after = fs.statSync(liveFile).mtimeMs;
-    assert.ok(after >= before, 'live file harus ditulis ulang');
-  });
-});
-
-// ===== Signature & validation =====
-
-test('createDashboardModule: payloadDir wajib di options (throw bila tidak ada)', () => {
-  const tmpDir = makeTmpDir();
-  withWorkingDir(tmpDir, () => {
-    const payload = loadSamplePayload();
-    assert.throws(
-      () => DashboardGenerator.createDashboardModule(
-        'mini-inventory', 'dash-sales', payload, { force: true }
-      ),
-      /payloadDir/
-    );
-  });
-});
-
-// ===== SQL escaping (optional defensive) =====
-
-test('createDashboardModule: SQL berisi backtick di-escape jadi \\` di template literal output', () => {
-  const tmpDir = makeTmpDir();
-  // Buat payloadDir custom dengan SQL fixture yang punya backtick
-  const customPayloadDir = fs.mkdtempSync(path.join(os.tmpdir(), 'dash-gen-fixture-'));
-  fs.mkdirSync(path.join(customPayloadDir, 'query'));
-  const sqlPath = path.join(customPayloadDir, 'query', 'tick.sql');
-  fs.writeFileSync(sqlPath, 'SELECT `col` FROM tbl', 'utf8');
-
-  withWorkingDir(tmpDir, () => {
-    const payload = {
-      widgets: [{ id: 'tick_widget', query: 'file:query/tick.sql' }]
-    };
-    DashboardGenerator.createDashboardModule(
-      'mini-inventory', 'dash-tick', payload,
-      { force: true, payloadDir: customPayloadDir }
-    );
-    const filePath = path.join(
-      tmpDir, 'src', 'modules', 'mini-inventory', 'dash-tick.js'
-    );
-    const content = fs.readFileSync(filePath, 'utf8');
-    assert.ok(
-      content.includes('SELECT \\`col\\` FROM tbl'),
-      'backtick di SQL harus di-escape jadi \\`'
-    );
-  });
-});
-
-test('createDashboardModule: SQL berisi ${...} di-escape jadi \\${ di template literal output', () => {
-  const tmpDir = makeTmpDir();
-  const customPayloadDir = fs.mkdtempSync(path.join(os.tmpdir(), 'dash-gen-fixture-'));
-  fs.mkdirSync(path.join(customPayloadDir, 'query'));
-  const sqlPath = path.join(customPayloadDir, 'query', 'dollar.sql');
-  fs.writeFileSync(sqlPath, 'SELECT * FROM t WHERE name = \'${suspect}\'', 'utf8');
-
-  withWorkingDir(tmpDir, () => {
-    const payload = {
-      widgets: [{ id: 'dollar_widget', query: 'file:query/dollar.sql' }]
-    };
-    DashboardGenerator.createDashboardModule(
-      'mini-inventory', 'dash-dollar', payload,
-      { force: true, payloadDir: customPayloadDir }
-    );
-    const filePath = path.join(
-      tmpDir, 'src', 'modules', 'mini-inventory', 'dash-dollar.js'
-    );
-    const content = fs.readFileSync(filePath, 'utf8');
-    assert.ok(
-      content.includes('\\${suspect}'),
-      'dollar-brace di SQL harus di-escape jadi \\${'
-    );
-  });
-});
-
-// ===== Multi-dialect: option database propagation =====
-
-test('createDashboardModule: database=postgres → emit require restforgejs/src/utils/db dan const dialect = postgres', () => {
-  const tmpDir = makeTmpDir();
-  withWorkingDir(tmpDir, () => {
-    const payload = loadSamplePayload();
-    DashboardGenerator.createDashboardModule(
-      'mini-inventory', 'dash-sales', payload,
-      { force: true, payloadDir: SAMPLE_PAYLOAD_DIR, database: 'postgres' }
-    );
-    const filePath = path.join(
-      tmpDir, 'src', 'modules', 'mini-inventory', 'dash-sales.js'
-    );
-    const content = fs.readFileSync(filePath, 'utf8');
-    assert.ok(
-      content.includes("require('restforgejs/src/utils/db')"),
-      'output harus require restforgejs/src/utils/db untuk dialect postgres'
-    );
-    assert.ok(
-      content.includes("const dialect = 'postgres';"),
-      "output harus emit const dialect = 'postgres'"
-    );
-  });
-});
-
-test('createDashboardModule: database=mysql → emit require restforgejs/src/utils/db-mysql dan const dialect = mysql', () => {
-  const tmpDir = makeTmpDir();
-  withWorkingDir(tmpDir, () => {
-    const payload = loadSamplePayload();
-    DashboardGenerator.createDashboardModule(
-      'mini-inventory', 'dash-sales', payload,
-      { force: true, payloadDir: SAMPLE_PAYLOAD_DIR, database: 'mysql' }
-    );
-    const filePath = path.join(
-      tmpDir, 'src', 'modules', 'mini-inventory', 'dash-sales.js'
-    );
-    const content = fs.readFileSync(filePath, 'utf8');
-    assert.ok(
-      content.includes("require('restforgejs/src/utils/db-mysql')"),
-      'output harus require restforgejs/src/utils/db-mysql untuk dialect mysql'
-    );
-    assert.ok(
-      content.includes("const dialect = 'mysql';"),
-      "output harus emit const dialect = 'mysql'"
-    );
-    assert.ok(
-      !content.includes("require('restforgejs/src/utils/db')\n"),
-      'output tidak boleh require db postgres saat dialect mysql'
-    );
-  });
-});
-
-test('createDashboardModule: database=oracle → emit require restforgejs/src/utils/db-oracle dan const dialect = oracle', () => {
-  const tmpDir = makeTmpDir();
-  withWorkingDir(tmpDir, () => {
-    const payload = loadSamplePayload();
-    DashboardGenerator.createDashboardModule(
-      'mini-inventory', 'dash-sales', payload,
-      { force: true, payloadDir: SAMPLE_PAYLOAD_DIR, database: 'oracle' }
-    );
-    const filePath = path.join(
-      tmpDir, 'src', 'modules', 'mini-inventory', 'dash-sales.js'
-    );
-    const content = fs.readFileSync(filePath, 'utf8');
-    assert.ok(
-      content.includes("require('restforgejs/src/utils/db-oracle')"),
-      'output harus require restforgejs/src/utils/db-oracle untuk dialect oracle'
-    );
-    assert.ok(
-      content.includes("const dialect = 'oracle';"),
-      "output harus emit const dialect = 'oracle'"
-    );
-  });
-});
-
-test('createDashboardModule: database=sqlite (tidak didukung) → throw error dengan pesan jelas', () => {
-  const tmpDir = makeTmpDir();
-  withWorkingDir(tmpDir, () => {
-    const payload = loadSamplePayload();
-    assert.throws(
-      () => DashboardGenerator.createDashboardModule(
-        'mini-inventory', 'dash-sales', payload,
-        { force: true, payloadDir: SAMPLE_PAYLOAD_DIR, database: 'sqlite' }
-      ),
-      (err) =>
-        err instanceof Error &&
-        /sqlite/.test(err.message) &&
-        /Supported: postgres, mysql, oracle/.test(err.message)
-    );
-  });
-});
-
-test('createDashboardModule: options tanpa database → default postgres (backward compat caller existing)', () => {
-  const tmpDir = makeTmpDir();
-  withWorkingDir(tmpDir, () => {
-    const payload = loadSamplePayload();
-    DashboardGenerator.createDashboardModule(
-      'mini-inventory', 'dash-sales', payload,
-      { force: true, payloadDir: SAMPLE_PAYLOAD_DIR }
-    );
-    const filePath = path.join(
-      tmpDir, 'src', 'modules', 'mini-inventory', 'dash-sales.js'
-    );
-    const content = fs.readFileSync(filePath, 'utf8');
-    assert.ok(
-      content.includes("require('restforgejs/src/utils/db')"),
-      'tanpa options.database, output default ke require db postgres'
-    );
-    assert.ok(
-      content.includes("const dialect = 'postgres';"),
-      "tanpa options.database, output default emit const dialect = 'postgres'"
-    );
-  });
-});
-
-test('createDashboardModule: generated handler memanggil substitutePlaceholders dengan 3 argument (dialect)', () => {
-  const tmpDir = makeTmpDir();
-  withWorkingDir(tmpDir, () => {
-    const payload = loadSamplePayload();
-    DashboardGenerator.createDashboardModule(
-      'mini-inventory', 'dash-sales', payload,
-      { force: true, payloadDir: SAMPLE_PAYLOAD_DIR, database: 'mysql' }
-    );
-    const filePath = path.join(
-      tmpDir, 'src', 'modules', 'mini-inventory', 'dash-sales.js'
-    );
-    const content = fs.readFileSync(filePath, 'utf8');
-    assert.match(
-      content,
-      /helpers\.substitutePlaceholders\(\s*`[\s\S]*?`,\s*effectiveParams,\s*dialect\s*\)/,
-      'panggilan substitutePlaceholders harus menyertakan dialect sebagai argument ketiga'
-    );
-  });
-});
-
-// ============================================================================
-// CACHE WRAPPING (Phase 3)
-// ============================================================================
-
-function generateAndRead(projectName, dashboardName, payload, opts = {}) {
-  const tmpDir = makeTmpDir();
-  let content;
-  withWorkingDir(tmpDir, () => {
-    DashboardGenerator.createDashboardModule(
-      projectName, dashboardName, payload,
-      { force: true, payloadDir: SAMPLE_PAYLOAD_DIR, ...opts }
-    );
-    const filePath = path.join(
-      tmpDir, 'src', 'modules', projectName, `${dashboardName}.js`
-    );
-    content = fs.readFileSync(filePath, 'utf8');
-  });
-  return content;
-}
-
-// ----- Cache disabled (3 test) -----
-
-test('cache: payload tanpa cache block — output TIDAK mengandung cacheManager / cache check / cache set', () => {
-  const payload = loadSamplePayload(); // sample tidak punya cache
-  const content = generateAndRead('mini-inventory', 'dash-sales', payload);
-
-  assert.ok(
-    !content.includes('cacheManager'),
-    'tanpa cache.enabled, generator TIDAK boleh emit referensi cacheManager'
-  );
-  assert.ok(
-    !content.includes('Cache check'),
-    'tanpa cache.enabled, generator TIDAK boleh emit comment "Cache check"'
-  );
-  assert.ok(
-    !content.includes('Cache set'),
-    'tanpa cache.enabled, generator TIDAK boleh emit comment "Cache set"'
-  );
-  assert.ok(
-    !content.includes("require('restforgejs/src/utils/cache-manager')"),
-    'tanpa cache.enabled, generator TIDAK boleh require cache-manager'
-  );
-});
-
-test('cache: payload dengan cache.enabled=false — output TIDAK mengandung cache wrapping', () => {
-  const payload = { ...loadSamplePayload(), cache: { enabled: false } };
-  const content = generateAndRead('mini-inventory', 'dash-sales', payload);
-
-  assert.ok(!content.includes('cacheManager'), 'cache.enabled=false harus skip cache wrapping');
-  assert.ok(!content.includes('Cache check'), 'comment Cache check harus absen');
-  assert.ok(!content.includes('Cache set'), 'comment Cache set harus absen');
-});
-
-test('cache: output non-cache valid sebagai Express router (smoke parse via new Function)', () => {
-  const payload = loadSamplePayload();
-  const content = generateAndRead('mini-inventory', 'dash-sales', payload);
-
-  assert.doesNotThrow(
-    () => new Function(content),
-    'output non-cache harus parse-able sebagai JavaScript valid'
-  );
-});
-
-// ----- Cache enabled (8 test) -----
-
-test('cache: payload dengan cache.enabled=true — output MENGANDUNG require cache-manager', () => {
-  const payload = {
-    ...loadSamplePayload(),
-    cache: { enabled: true, invalidates: ['sales'] }
-  };
-  const content = generateAndRead('mini-inventory', 'dash-sales', payload);
-
-  assert.ok(
-    content.includes("require('restforgejs/src/utils/cache-manager')"),
-    'cache.enabled=true harus emit require cache-manager via npm package style'
-  );
-  assert.ok(
-    content.includes('const cacheManager = '),
-    'output harus declare const cacheManager'
-  );
-});
-
-test('cache: output mengandung buildKey dengan module/endpoint/type=dashboard', () => {
-  const payload = {
-    ...loadSamplePayload(),
-    cache: { enabled: true, invalidates: ['sales'] }
-  };
-  const content = generateAndRead('mini-inventory', 'dash-sales', payload);
-
-  assert.ok(content.includes('cacheManager.buildKey({'), 'harus emit buildKey call');
-  assert.ok(
-    content.includes("module: 'mini-inventory'"),
-    'buildKey module field harus literal projectName'
-  );
-  assert.ok(
-    content.includes("endpoint: 'dash-sales'"),
-    'buildKey endpoint field harus literal dashboardName'
-  );
-  assert.ok(
-    content.includes("type: 'dashboard'"),
-    'buildKey type field harus literal "dashboard"'
-  );
-});
-
-test('cache: output mengandung crypto.createHash MD5 + cabang isEmpty="all"', () => {
-  const payload = {
-    ...loadSamplePayload(),
-    cache: { enabled: true, invalidates: ['sales'] }
-  };
-  const content = generateAndRead('mini-inventory', 'dash-sales', payload);
-
-  assert.ok(
-    content.includes("crypto.createHash('md5')"),
-    'identifier hash WAJIB pakai MD5'
-  );
-  assert.ok(
-    content.includes(".substring(0, 8)"),
-    'hash harus dipotong 8 karakter'
-  );
-  assert.ok(
-    content.includes("'all'"),
-    'output harus emit literal "all" untuk body kosong'
-  );
-  assert.match(
-    content,
-    /const isEmpty\s*=\s*Object\.keys\(body\)\.length\s*===\s*0/,
-    'isEmpty derivation dari Object.keys(req.body).length'
-  );
-});
-
-test('cache: output mengandung cacheManager.set(cacheKey, response, <ttl>)', () => {
-  const payload = {
-    ...loadSamplePayload(),
-    cache: { enabled: true, ttl: 600, invalidates: ['sales'] }
-  };
-  const content = generateAndRead('mini-inventory', 'dash-sales', payload);
-
-  assert.ok(
-    content.includes('cacheManager.set(cacheKey, response, 600)'),
-    'cache set harus pakai cacheKey + response + ttl literal'
-  );
-  assert.ok(
-    content.includes('if (cacheKey) {'),
-    'cache set di-guard dengan if (cacheKey)'
-  );
-});
-
-test('cache: TTL literal — cache.ttl=600 emit "600", tanpa ttl emit "null"', () => {
-  // case 1: cache.ttl=600
-  const withTtl = generateAndRead('mini-inventory', 'dash-sales', {
-    ...loadSamplePayload(),
-    cache: { enabled: true, ttl: 600, invalidates: ['sales'] }
-  });
-  assert.ok(
-    withTtl.includes('cacheManager.set(cacheKey, response, 600)'),
-    'ttl=600 harus emit literal numeric 600'
-  );
-
-  // case 2: tanpa ttl
-  const withoutTtl = generateAndRead('mini-inventory', 'dash-sales', {
-    ...loadSamplePayload(),
-    cache: { enabled: true, invalidates: ['sales'] }
-  });
-  assert.ok(
-    withoutTtl.includes('cacheManager.set(cacheKey, response, null)'),
-    'tanpa ttl harus emit literal null (fallback ke env CACHE_TTL)'
-  );
-});
-
-test('cache: cache check muncul sebelum Promise.allSettled, cache set setelah loop normalisasi', () => {
-  const payload = {
-    ...loadSamplePayload(),
-    cache: { enabled: true, ttl: 300, invalidates: ['sales'] }
-  };
-  const content = generateAndRead('mini-inventory', 'dash-sales', payload);
-
-  const cacheCheckIdx = content.indexOf('// --- Cache check');
-  const allSettledIdx = content.indexOf('Promise.allSettled');
-  const stringifyIdx = content.indexOf('helpers.stringifyNumericDeep');
-  const cacheSetIdx = content.indexOf('// --- Cache set');
-  const resJsonIdx = content.indexOf('res.json(response)');
-
-  assert.ok(cacheCheckIdx > 0, 'cache check block harus ada');
-  assert.ok(cacheSetIdx > 0, 'cache set block harus ada');
-  assert.ok(
-    cacheCheckIdx < allSettledIdx,
-    'cache check WAJIB muncul sebelum Promise.allSettled'
-  );
-  assert.ok(
-    stringifyIdx < cacheSetIdx,
-    'cache set WAJIB muncul setelah loop normalisasi (stringifyNumericDeep)'
-  );
-  assert.ok(
-    cacheSetIdx < resJsonIdx,
-    'cache set WAJIB muncul sebelum res.json(response)'
-  );
-});
-
-test('cache: generated code dengan cache wrapping tetap parse valid (smoke)', () => {
-  const payload = {
-    ...loadSamplePayload(),
-    cache: { enabled: true, ttl: 300, invalidates: ['sales'] }
-  };
-  const content = generateAndRead('mini-inventory', 'dash-sales', payload);
-
-  assert.doesNotThrow(
-    () => new Function(content),
-    'output dengan cache wrapping harus parse-able sebagai JavaScript valid'
-  );
-});
-
-test('cache: cache check guard menggunakan getter cacheManager.enabled (bukan isEnabled())', () => {
-  const payload = {
-    ...loadSamplePayload(),
-    cache: { enabled: true, invalidates: ['sales'] }
-  };
-  const content = generateAndRead('mini-inventory', 'dash-sales', payload);
-
-  assert.ok(
-    content.includes('if (cacheManager.enabled) {'),
-    'cache check WAJIB pakai getter cacheManager.enabled, bukan cacheManager.isEnabled()'
-  );
-  assert.ok(
-    !content.includes('cacheManager.isEnabled()'),
-    'cache check TIDAK boleh pakai method isEnabled() — gunakan getter enabled'
-  );
-});
-
-test('cache: cache hit branch menjalankan early return res.json(cached)', () => {
-  const payload = {
-    ...loadSamplePayload(),
-    cache: { enabled: true, ttl: 300, invalidates: ['sales'] }
-  };
-  const content = generateAndRead('mini-inventory', 'dash-sales', payload);
-
-  assert.match(
-    content,
-    /const cached\s*=\s*await cacheManager\.get\(cacheKey\)/,
-    'cache check harus await cacheManager.get(cacheKey)'
-  );
-  assert.match(
-    content,
-    /if \(cached\)\s*return res\.json\(cached\)/,
-    'cache hit harus early-return res.json(cached)'
-  );
-});