@restforgejs/platform 4.2.8 → 4.3.2

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

@@ -1,354 +0,0 @@
-const test = require('node:test');
-const assert = require('node:assert');
-const path = require('path');
-const fs = require('fs');
-const os = require('os');
-
-const DashboardValidator = require('../../../lib/validators/dashboard-validator');
-
-const HAPPY_PATH_PAYLOAD = path.resolve(
-  __dirname,
-  '../../../../restforge/docs/architecture/dashboard-architecture/payload/dashboard-sales.json'
-);
-
-test('happy path: payload dashboard-sales.json valid dengan SQL files lengkap', () => {
-  const payload = JSON.parse(fs.readFileSync(HAPPY_PATH_PAYLOAD, 'utf8'));
-  const payloadDir = path.dirname(HAPPY_PATH_PAYLOAD);
-
-  const result = DashboardValidator.validateDashboardPayload(payload, payloadDir);
-
-  assert.deepStrictEqual(result, { valid: true });
-});
-
-test('missing widgets: payload kosong harus throw error tentang widgets', () => {
-  assert.throws(
-    () => DashboardValidator.validateDashboardPayload({}, __dirname),
-    /widgets/i
-  );
-});
-
-test('widgets + tableName collision: tidak boleh ada keduanya', () => {
-  const payload = {
-    tableName: 'sales',
-    widgets: [{ id: 'w1', query: 'SELECT 1' }]
-  };
-  assert.throws(
-    () => DashboardValidator.validateDashboardPayload(payload, __dirname),
-    /tableName/
-  );
-});
-
-test('widget query+queries collision: harus salah satu, bukan keduanya', () => {
-  const payload = {
-    widgets: [
-      {
-        id: 'w1',
-        query: 'SELECT 1',
-        queries: { value: 'SELECT 2' }
-      }
-    ]
-  };
-  assert.throws(
-    () => DashboardValidator.validateDashboardPayload(payload, __dirname),
-    /either 'query' or 'queries'/
-  );
-});
-
-test('params schema invalid: type harus enum yang diizinkan', () => {
-  const payload = {
-    params: { from: { type: 'datetime' } },
-    widgets: [{ id: 'w1', query: 'SELECT 1' }]
-  };
-  assert.throws(
-    () => DashboardValidator.validateDashboardPayload(payload, __dirname),
-    /Param 'from' has invalid type 'datetime'/
-  );
-});
-
-test('undeclared placeholder: SQL pakai :foo tapi tidak declared di params', () => {
-  const payload = {
-    params: { from: { type: 'date' } },
-    widgets: [
-      {
-        id: 'w1',
-        query: 'SELECT * FROM sales WHERE region = :foo'
-      }
-    ]
-  };
-  assert.throws(
-    () => DashboardValidator.validateDashboardPayload(payload, __dirname),
-    /:foo/
-  );
-});
-
-test('duplicate widget id: dua widget dengan id sama harus throw', () => {
-  const payload = {
-    widgets: [
-      { id: 'sales', query: 'SELECT 1' },
-      { id: 'sales', query: 'SELECT 2' }
-    ]
-  };
-  assert.throws(
-    () => DashboardValidator.validateDashboardPayload(payload, __dirname),
-    /Duplicate widget id: 'sales'/
-  );
-});
-
-test('frontend field rejection: widgetType di widget harus ditolak (SoC)', () => {
-  const payload = {
-    widgets: [
-      {
-        id: 'w1',
-        widgetType: 'donut',
-        query: 'SELECT 1'
-      }
-    ]
-  };
-  assert.throws(
-    () => DashboardValidator.validateDashboardPayload(payload, __dirname),
-    /widgetType.*frontend|separation of concerns/i
-  );
-});
-
-// ============================================================================
-// Cache block — validasi struktur
-// ============================================================================
-
-test('cache block: tanpa cache → valid (existing behavior preserved)', () => {
-  const payload = {
-    widgets: [{ id: 'w1', query: 'SELECT 1' }]
-  };
-  const result = DashboardValidator.validateDashboardPayload(payload, __dirname);
-  assert.deepStrictEqual(result, { valid: true });
-});
-
-test('cache.enabled missing: harus throw', () => {
-  const payload = {
-    cache: { ttl: 300 },
-    widgets: [{ id: 'w1', query: 'SELECT 1' }]
-  };
-  assert.throws(
-    () => DashboardValidator.validateDashboardPayload(payload, __dirname),
-    /'cache\.enabled' is required/
-  );
-});
-
-test('cache.enabled non-boolean: harus throw', () => {
-  const payload = {
-    cache: { enabled: 'yes' },
-    widgets: [{ id: 'w1', query: 'SELECT 1' }]
-  };
-  assert.throws(
-    () => DashboardValidator.validateDashboardPayload(payload, __dirname),
-    /'cache\.enabled' is required and must be a boolean/
-  );
-});
-
-test('cache.ttl negative: harus throw', () => {
-  const payload = {
-    cache: { enabled: false, ttl: -1 },
-    widgets: [{ id: 'w1', query: 'SELECT 1' }]
-  };
-  assert.throws(
-    () => DashboardValidator.validateDashboardPayload(payload, __dirname),
-    /'cache\.ttl' must be a non-negative number/
-  );
-});
-
-test('cache.invalidates duplikat: harus throw', () => {
-  const payload = {
-    cache: { enabled: false, invalidates: ['users', 'Users'] },
-    widgets: [{ id: 'w1', query: 'SELECT 1' }]
-  };
-  assert.throws(
-    () => DashboardValidator.validateDashboardPayload(payload, __dirname),
-    /duplicate entry/i
-  );
-});
-
-test('cache field unknown: harus throw', () => {
-  const payload = {
-    cache: { enabled: false, prefix: 'foo' },
-    widgets: [{ id: 'w1', query: 'SELECT 1' }]
-  };
-  assert.throws(
-    () => DashboardValidator.validateDashboardPayload(payload, __dirname),
-    /unknown field: 'prefix'/
-  );
-});
-
-// ============================================================================
-// Cache cross-reference — fixture metadata + tmpdir
-// ============================================================================
-
-function makeTmpDir() {
-  return fs.mkdtempSync(path.join(os.tmpdir(), 'dash-validator-cache-test-'));
-}
-
-function cleanupTmpDir(dir) {
-  try {
-    fs.rmSync(dir, { recursive: true, force: true });
-  } catch (_err) {
-    // best-effort
-  }
-}
-
-function writeMetadata(tmpDir, projectName, endpoints) {
-  const metadataDir = path.join(tmpDir, 'metadata');
-  fs.mkdirSync(metadataDir, { recursive: true });
-  const filePath = path.join(metadataDir, `${projectName}.json`);
-  fs.writeFileSync(filePath, JSON.stringify({ endpoints }, null, 2), 'utf8');
-  return metadataDir;
-}
-
-test('cross-reference: metadata file tidak ada → throw', () => {
-  const tmpDir = makeTmpDir();
-  try {
-    const payload = {
-      cache: { enabled: true, invalidates: ['stock_inbound'] },
-      widgets: [{ id: 'w1', query: 'SELECT * FROM stock_inbound' }]
-    };
-    assert.throws(
-      () => DashboardValidator.validateDashboardPayload(payload, __dirname, {
-        projectName: 'mini-inventory',
-        metadataDir: path.join(tmpDir, 'metadata')
-      }),
-      /requires metadata\/mini-inventory\.json/
-    );
-  } finally {
-    cleanupTmpDir(tmpDir);
-  }
-});
-
-test('cross-reference: SQL pakai table di metadata tapi tidak di invalidates → throw missing', () => {
-  const tmpDir = makeTmpDir();
-  try {
-    const metadataDir = writeMetadata(tmpDir, 'mini-inventory', {
-      stock_inbound: { type: 'module', tableName: 'stock_inbound' },
-      supplier: { type: 'module', tableName: 'supplier' }
-    });
-    const payload = {
-      cache: { enabled: true, invalidates: ['stock_inbound'] },
-      widgets: [
-        { id: 'w1', query: 'SELECT * FROM stock_inbound JOIN supplier ON supplier.id = stock_inbound.supplier_id' }
-      ]
-    };
-    assert.throws(
-      () => DashboardValidator.validateDashboardPayload(payload, __dirname, {
-        projectName: 'mini-inventory',
-        metadataDir
-      }),
-      /missing tables detected in widget SQL: supplier/
-    );
-  } finally {
-    cleanupTmpDir(tmpDir);
-  }
-});
-
-test('cross-reference: invalidates punya entry yang tidak ada di SQL → throw extra', () => {
-  const tmpDir = makeTmpDir();
-  try {
-    const metadataDir = writeMetadata(tmpDir, 'mini-inventory', {
-      stock_inbound: { type: 'module', tableName: 'stock_inbound' },
-      product: { type: 'module', tableName: 'product' }
-    });
-    const payload = {
-      cache: { enabled: true, invalidates: ['stock_inbound', 'product'] },
-      widgets: [
-        { id: 'w1', query: 'SELECT * FROM stock_inbound' }
-      ]
-    };
-    assert.throws(
-      () => DashboardValidator.validateDashboardPayload(payload, __dirname, {
-        projectName: 'mini-inventory',
-        metadataDir
-      }),
-      /tables not detected in any widget SQL: product/
-    );
-  } finally {
-    cleanupTmpDir(tmpDir);
-  }
-});
-
-test('cross-reference: SQL punya table tidak terdaftar di metadata → warning, bukan error', () => {
-  const tmpDir = makeTmpDir();
-  try {
-    const metadataDir = writeMetadata(tmpDir, 'mini-inventory', {
-      stock_inbound: { type: 'module', tableName: 'stock_inbound' }
-    });
-    const warnMessages = [];
-    const payload = {
-      cache: { enabled: true, invalidates: ['stock_inbound'] },
-      widgets: [
-        { id: 'w1', query: 'SELECT * FROM stock_inbound JOIN external_view ON external_view.id = stock_inbound.ext_id' }
-      ]
-    };
-    const result = DashboardValidator.validateDashboardPayload(payload, __dirname, {
-      projectName: 'mini-inventory',
-      metadataDir,
-      warn: (msg) => warnMessages.push(msg)
-    });
-    assert.deepStrictEqual(result, { valid: true });
-    assert.strictEqual(warnMessages.length, 1);
-    assert.match(warnMessages[0], /external_view/);
-    assert.match(warnMessages[0], /Cascade invalidation will not trigger/);
-  } finally {
-    cleanupTmpDir(tmpDir);
-  }
-});
-
-test('cross-reference: happy path SQL extract = invalidates exact → valid', () => {
-  const tmpDir = makeTmpDir();
-  try {
-    const metadataDir = writeMetadata(tmpDir, 'mini-inventory', {
-      stock_inbound: { type: 'module', tableName: 'stock_inbound' },
-      supplier: { type: 'module', tableName: 'supplier' },
-      product: { type: 'module', tableName: 'product' }
-    });
-    const warnMessages = [];
-    const payload = {
-      cache: {
-        enabled: true,
-        ttl: 300,
-        invalidates: ['stock_inbound', 'supplier', 'product']
-      },
-      widgets: [
-        {
-          id: 'inbound_by_supplier',
-          query: 'SELECT * FROM stock_inbound JOIN supplier ON supplier.id = stock_inbound.supplier_id JOIN product ON product.id = stock_inbound.product_id'
-        }
-      ]
-    };
-    const result = DashboardValidator.validateDashboardPayload(payload, __dirname, {
-      projectName: 'mini-inventory',
-      metadataDir,
-      warn: (msg) => warnMessages.push(msg)
-    });
-    assert.deepStrictEqual(result, { valid: true });
-    assert.strictEqual(warnMessages.length, 0);
-  } finally {
-    cleanupTmpDir(tmpDir);
-  }
-});
-
-test('cross-reference: cache.enabled=false skip cross-reference (no metadata required)', () => {
-  const payload = {
-    cache: { enabled: false, invalidates: ['anything'] },
-    widgets: [{ id: 'w1', query: 'SELECT * FROM stock_inbound' }]
-  };
-  const result = DashboardValidator.validateDashboardPayload(payload, __dirname, {
-    projectName: 'nonexistent-project'
-  });
-  assert.deepStrictEqual(result, { valid: true });
-});
-
-test('cross-reference: invalidates kosong skip cross-reference (TTL-only mode)', () => {
-  const payload = {
-    cache: { enabled: true, ttl: 300 },
-    widgets: [{ id: 'w1', query: 'SELECT * FROM stock_inbound' }]
-  };
-  const result = DashboardValidator.validateDashboardPayload(payload, __dirname, {
-    projectName: 'nonexistent-project'
-  });
-  assert.deepStrictEqual(result, { valid: true });
-});