@restforgejs/platform 4.1.1 → 4.3.1

package/generators/tests/unit/lib/metadata-manager-dashboard.test.js

@@ -1,256 +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 MetadataManager = require('../../../lib/utils/metadata-manager');
-const ConfigReader = require('../../../lib/config/config-reader');
-
-function makeTmpDir() {
-  return fs.mkdtempSync(path.join(os.tmpdir(), 'metadata-dash-test-'));
-}
-
-function cleanupTmpDir(dir) {
-  try {
-    fs.rmSync(dir, { recursive: true, force: true });
-  } catch (err) {
-    // best-effort cleanup
-  }
-}
-
-/**
- * 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;
-  }
-}
-
-async function withWorkingDirAsync(dir, fn) {
-  const original = ConfigReader.getWorkingDirectory;
-  ConfigReader.getWorkingDirectory = () => dir;
-  try {
-    return await fn();
-  } finally {
-    ConfigReader.getWorkingDirectory = original;
-  }
-}
-
-// Suppress noisy console output dari MetadataManager.writeModuleMetadata
-// dan FileUtils.ensureDirectoryExists tanpa menyembunyikan error.
-let _originalLog;
-let _originalWarn;
-before(() => {
-  _originalLog = console.log;
-  _originalWarn = console.warn;
-  console.log = () => {};
-  console.warn = () => {};
-});
-after(() => {
-  console.log = _originalLog;
-  console.warn = _originalWarn;
-});
-
-function readMetadata(tmpDir, moduleName) {
-  const filePath = path.join(tmpDir, 'metadata', `${moduleName}.json`);
-  return JSON.parse(fs.readFileSync(filePath, 'utf8'));
-}
-
-function buildSinglePayload() {
-  return {
-    widgets: [
-      { id: 'author_sales', query: 'SELECT 1' }
-    ]
-  };
-}
-
-function buildMultiWidgetPayload() {
-  return {
-    widgets: [
-      { id: 'author_sales', query: 'SELECT 1' },
-      { id: 'sales_statistics', query: 'SELECT 2' },
-      { id: 'sales_this_months', queries: { value: 'SELECT 3', points: 'SELECT 4' } }
-    ]
-  };
-}
-
-// ===== Test cases =====
-
-test('create initial metadata: file dibuat dengan entry dash-{name} bertipe dashboard', () => {
-  const tmpDir = makeTmpDir();
-  try {
-    withWorkingDir(tmpDir, () => {
-      const payload = buildSinglePayload();
-
-      const ok = MetadataManager.updateDashboardMetadata('mini-inventory', 'dash-sales', payload, 'postgres');
-      assert.strictEqual(ok, true, 'method harus return true');
-
-      const metadataFile = path.join(tmpDir, 'metadata', 'mini-inventory.json');
-      assert.strictEqual(fs.existsSync(metadataFile), true, 'metadata file harus dibuat');
-
-      const metadata = readMetadata(tmpDir, 'mini-inventory');
-      assert.ok('dash-sales' in metadata.endpoints, 'entry dash-sales harus ada');
-
-      const entry = metadata.endpoints['dash-sales'];
-      assert.strictEqual(entry.type, 'dashboard');
-      assert.strictEqual(entry.widgetCount, 1);
-      assert.deepStrictEqual(entry.widgetIds, ['author_sales']);
-      assert.strictEqual(entry.databaseType, 'postgres');
-      assert.strictEqual(entry.path, 'src/modules/mini-inventory/dash-sales.js');
-      assert.strictEqual(entry.statistics.timesGenerated, 1);
-    });
-  } finally {
-    cleanupTmpDir(tmpDir);
-  }
-});
-
-test('update timesGenerated increment: dua panggilan beruntun → timesGenerated 2 dan createdAt tidak berubah', async () => {
-  const tmpDir = makeTmpDir();
-  try {
-    await withWorkingDirAsync(tmpDir, async () => {
-      const payload = buildSinglePayload();
-
-      MetadataManager.updateDashboardMetadata('mini-inventory', 'dash-sales', payload, 'postgres');
-      const first = readMetadata(tmpDir, 'mini-inventory').endpoints['dash-sales'];
-
-      // Tunggu sebentar agar updatedAt berbeda secara observasi
-      await new Promise((resolve) => setTimeout(resolve, 10));
-
-      MetadataManager.updateDashboardMetadata('mini-inventory', 'dash-sales', payload, 'postgres');
-      const second = readMetadata(tmpDir, 'mini-inventory').endpoints['dash-sales'];
-
-      assert.strictEqual(second.statistics.timesGenerated, 2);
-      assert.strictEqual(second.createdAt, first.createdAt, 'createdAt harus tetap dari invocation pertama');
-      assert.ok(second.updatedAt >= first.updatedAt, 'updatedAt harus sama atau lebih baru');
-    });
-  } finally {
-    cleanupTmpDir(tmpDir);
-  }
-});
-
-test('multi widget metadata: payload 3 widget → widgetCount 3 dan widgetIds urutan match', () => {
-  const tmpDir = makeTmpDir();
-  try {
-    withWorkingDir(tmpDir, () => {
-      const payload = buildMultiWidgetPayload();
-
-      MetadataManager.updateDashboardMetadata('mini-inventory', 'dash-sales', payload, 'postgres');
-
-      const entry = readMetadata(tmpDir, 'mini-inventory').endpoints['dash-sales'];
-      assert.strictEqual(entry.widgetCount, 3);
-      assert.deepStrictEqual(
-        entry.widgetIds,
-        ['author_sales', 'sales_statistics', 'sales_this_months']
-      );
-    });
-  } finally {
-    cleanupTmpDir(tmpDir);
-  }
-});
-
-test('params contract metadata: payload dengan params {from,to} → keyCount 2 dan keys match', () => {
-  const tmpDir = makeTmpDir();
-  try {
-    withWorkingDir(tmpDir, () => {
-      const payload = {
-        widgets: [{ id: 'w1', query: 'SELECT 1' }],
-        params: {
-          from: { type: 'date', required: true },
-          to: { type: 'date', required: true }
-        }
-      };
-
-      MetadataManager.updateDashboardMetadata('mini-inventory', 'dash-sales', payload, 'postgres');
-
-      const entry = readMetadata(tmpDir, 'mini-inventory').endpoints['dash-sales'];
-      assert.strictEqual(entry.paramsContract.keyCount, 2);
-      assert.deepStrictEqual(entry.paramsContract.keys, ['from', 'to']);
-    });
-  } finally {
-    cleanupTmpDir(tmpDir);
-  }
-});
-
-test('empty params: payload tanpa params → keyCount 0 dan keys array kosong', () => {
-  const tmpDir = makeTmpDir();
-  try {
-    withWorkingDir(tmpDir, () => {
-      const payload = buildSinglePayload();
-
-      MetadataManager.updateDashboardMetadata('mini-inventory', 'dash-sales', payload, 'postgres');
-
-      const entry = readMetadata(tmpDir, 'mini-inventory').endpoints['dash-sales'];
-      assert.strictEqual(entry.paramsContract.keyCount, 0);
-      assert.deepStrictEqual(entry.paramsContract.keys, []);
-    });
-  } finally {
-    cleanupTmpDir(tmpDir);
-  }
-});
-
-test('coexist dengan endpoint CRUD: keduanya tetap ada di endpoints dengan endpointsByType yang benar', () => {
-  const tmpDir = makeTmpDir();
-  try {
-    withWorkingDir(tmpDir, () => {
-      const crudPayload = {
-        tableName: 'products',
-        action: { create: true, read: true },
-        fieldName: ['id', 'name', 'price']
-      };
-      MetadataManager.updateEndpointMetadata('mini-inventory', 'products', crudPayload, 'postgres');
-
-      const dashPayload = buildSinglePayload();
-      MetadataManager.updateDashboardMetadata('mini-inventory', 'dash-sales', dashPayload, 'postgres');
-
-      const metadata = readMetadata(tmpDir, 'mini-inventory');
-      assert.ok('products' in metadata.endpoints, 'endpoint CRUD harus tetap ada');
-      assert.ok('dash-sales' in metadata.endpoints, 'endpoint dashboard harus ada');
-
-      assert.strictEqual(metadata.endpoints['products'].type, 'module');
-      assert.strictEqual(metadata.endpoints['dash-sales'].type, 'dashboard');
-
-      assert.strictEqual(metadata.statistics.endpointsByType.module, 1);
-      assert.strictEqual(metadata.statistics.endpointsByType.dashboard, 1);
-    });
-  } finally {
-    cleanupTmpDir(tmpDir);
-  }
-});
-
-test('statistics totalEndpoints: dashboard ditambahkan ke module dengan 2 CRUD → totalEndpoints 3', () => {
-  const tmpDir = makeTmpDir();
-  try {
-    withWorkingDir(tmpDir, () => {
-      const crudPayload1 = {
-        tableName: 'products',
-        action: { create: true },
-        fieldName: ['id', 'name']
-      };
-      const crudPayload2 = {
-        tableName: 'orders',
-        action: { create: true, read: true },
-        fieldName: ['id', 'total']
-      };
-      MetadataManager.updateEndpointMetadata('mini-inventory', 'products', crudPayload1, 'postgres');
-      MetadataManager.updateEndpointMetadata('mini-inventory', 'orders', crudPayload2, 'postgres');
-
-      MetadataManager.updateDashboardMetadata('mini-inventory', 'dash-sales', buildSinglePayload(), 'postgres');
-
-      const metadata = readMetadata(tmpDir, 'mini-inventory');
-      assert.strictEqual(metadata.statistics.totalEndpoints, 3);
-    });
-  } finally {
-    cleanupTmpDir(tmpDir);
-  }
-});

package/generators/tests/unit/lib/payload-validator-fieldpolicy.test.js

@@ -1,240 +0,0 @@
-const test = require('node:test');
-const assert = require('node:assert');
-
-const PayloadValidator = require('../../../lib/validators/payload-validator');
-
-const FILE = 'sample.json';
-const FIELDS = ['id', 'salary', 'bonus', 'name'];
-
-function expectThrowsWithMessage(fn, expectedSubstring) {
-  let thrown = null;
-  try {
-    fn();
-  } catch (err) {
-    thrown = err;
-  }
-  assert.ok(thrown, 'Expected function to throw, but it did not');
-  assert.match(
-    thrown.message,
-    new RegExp(expectedSubstring.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')),
-    `Expected error message to contain: ${expectedSubstring}\nActual: ${thrown.message}`
-  );
-  return thrown;
-}
-
-test('validateFieldPolicy: strategies ["lock"] valid', () => {
-  const policy = { salary: { strategies: ['lock'] } };
-  assert.doesNotThrow(() => {
-    PayloadValidator.validateFieldPolicy(policy, FIELDS, FILE);
-  });
-});
-
-test('validateFieldPolicy: strategies ["audit"] valid', () => {
-  const policy = { salary: { strategies: ['audit'] } };
-  assert.doesNotThrow(() => {
-    PayloadValidator.validateFieldPolicy(policy, FIELDS, FILE);
-  });
-});
-
-test('validateFieldPolicy: strategies ["lock", "audit"] valid (kombinasi umum)', () => {
-  const policy = { salary: { strategies: ['lock', 'audit'] } };
-  assert.doesNotThrow(() => {
-    PayloadValidator.validateFieldPolicy(policy, FIELDS, FILE);
-  });
-});
-
-test('validateFieldPolicy: multi-kolom dengan strategies berbeda valid', () => {
-  const policy = {
-    salary: { strategies: ['lock', 'audit'] },
-    bonus: { strategies: ['lock'] }
-  };
-  assert.doesNotThrow(() => {
-    PayloadValidator.validateFieldPolicy(policy, FIELDS, FILE);
-  });
-});
-
-test('validateFieldPolicy: strategies kosong [] menolak', () => {
-  const policy = { salary: { strategies: [] } };
-  expectThrowsWithMessage(
-    () => PayloadValidator.validateFieldPolicy(policy, FIELDS, FILE),
-    'fieldPolicy.salary.strategies in sample.json is required and must be a non-empty array of strings'
-  );
-});
-
-test('validateFieldPolicy: strategies tanpa property menolak', () => {
-  const policy = { salary: {} };
-  expectThrowsWithMessage(
-    () => PayloadValidator.validateFieldPolicy(policy, FIELDS, FILE),
-    'fieldPolicy.salary.strategies in sample.json is required and must be a non-empty array of strings'
-  );
-});
-
-test('validateFieldPolicy: strategy "condition" menolak dengan pesan Phase 2', () => {
-  const policy = { salary: { strategies: ['condition'] } };
-  const err = expectThrowsWithMessage(
-    () => PayloadValidator.validateFieldPolicy(policy, FIELDS, FILE),
-    "includes 'condition' which is planned for Phase 2"
-  );
-  assert.match(err.message, /docs\/todo\/todo-fieldpolicy-extension\.md/);
-});
-
-test('validateFieldPolicy: strategy "version" menolak dengan pesan Phase 2', () => {
-  const policy = { salary: { strategies: ['version'] } };
-  const err = expectThrowsWithMessage(
-    () => PayloadValidator.validateFieldPolicy(policy, FIELDS, FILE),
-    "includes 'version' which is planned for Phase 2"
-  );
-  assert.match(err.message, /docs\/todo\/todo-fieldpolicy-extension\.md/);
-});
-
-test('validateFieldPolicy: strategy typo "lok" menolak dengan list valid values', () => {
-  const policy = { salary: { strategies: ['lok'] } };
-  const err = expectThrowsWithMessage(
-    () => PayloadValidator.validateFieldPolicy(policy, FIELDS, FILE),
-    "includes 'lok' which is not valid"
-  );
-  assert.match(err.message, /Valid strategies in Phase 1: lock, audit/);
-});
-
-test('validateFieldPolicy: kolom tidak ada di fieldName menolak', () => {
-  const policy = { unknown_column: { strategies: ['lock'] } };
-  expectThrowsWithMessage(
-    () => PayloadValidator.validateFieldPolicy(policy, FIELDS, FILE),
-    "fieldPolicy column 'unknown_column' in sample.json is not in fieldName"
-  );
-});
-
-test('validateFieldPolicy: fieldPolicy berupa array menolak', () => {
-  const policy = [{ strategies: ['lock'] }];
-  expectThrowsWithMessage(
-    () => PayloadValidator.validateFieldPolicy(policy, FIELDS, FILE),
-    'fieldPolicy in sample.json must be a non-null object'
-  );
-});
-
-test('validateFieldPolicy: fieldPolicy null menolak', () => {
-  expectThrowsWithMessage(
-    () => PayloadValidator.validateFieldPolicy(null, FIELDS, FILE),
-    'fieldPolicy in sample.json must be a non-null object'
-  );
-});
-
-test('validateFieldPolicy: entry kolom berupa string menolak', () => {
-  const policy = { salary: 'lock' };
-  expectThrowsWithMessage(
-    () => PayloadValidator.validateFieldPolicy(policy, FIELDS, FILE),
-    'fieldPolicy.salary in sample.json must be a non-null object'
-  );
-});
-
-test('validateFieldPolicy: entry kolom berupa array menolak', () => {
-  const policy = { salary: ['lock'] };
-  expectThrowsWithMessage(
-    () => PayloadValidator.validateFieldPolicy(policy, FIELDS, FILE),
-    'fieldPolicy.salary in sample.json must be a non-null object'
-  );
-});
-
-test('validateFieldPolicy: strategies bukan array menolak', () => {
-  const policy = { salary: { strategies: 'lock' } };
-  expectThrowsWithMessage(
-    () => PayloadValidator.validateFieldPolicy(policy, FIELDS, FILE),
-    'fieldPolicy.salary.strategies in sample.json is required and must be a non-empty array of strings'
-  );
-});
-
-test('validateFieldPolicy: strategies item bukan string menolak', () => {
-  const policy = { salary: { strategies: [123] } };
-  expectThrowsWithMessage(
-    () => PayloadValidator.validateFieldPolicy(policy, FIELDS, FILE),
-    'fieldPolicy.salary.strategies in sample.json is required and must be a non-empty array of strings'
-  );
-});
-
-test('validateFieldPolicy: property tambahan (conditions) menolak Phase 1', () => {
-  const policy = {
-    salary: {
-      strategies: ['lock'],
-      conditions: [{ operation: 'reserve' }]
-    }
-  };
-  expectThrowsWithMessage(
-    () => PayloadValidator.validateFieldPolicy(policy, FIELDS, FILE),
-    'fieldPolicy.salary.conditions is not supported in Phase 1'
-  );
-});
-
-test('validateFieldPolicy: property tambahan (versionField) menolak Phase 1', () => {
-  const policy = {
-    salary: {
-      strategies: ['lock'],
-      versionField: 'version'
-    }
-  };
-  expectThrowsWithMessage(
-    () => PayloadValidator.validateFieldPolicy(policy, FIELDS, FILE),
-    'fieldPolicy.salary.versionField is not supported in Phase 1'
-  );
-});
-
-test('validateFieldPolicy: property tambahan (auditFormat) menolak Phase 1', () => {
-  const policy = {
-    salary: {
-      strategies: ['audit'],
-      auditFormat: 'snapshot'
-    }
-  };
-  expectThrowsWithMessage(
-    () => PayloadValidator.validateFieldPolicy(policy, FIELDS, FILE),
-    'fieldPolicy.salary.auditFormat is not supported in Phase 1'
-  );
-});
-
-test('validatePayloadStructure: payload dengan fieldProtection lama menolak dengan migration hint', () => {
-  const payload = {
-    tableName: 'karyawan',
-    primaryKey: 'id',
-    fieldName: ['id', 'salary'],
-    fieldProtection: {
-      salary: { level: 'strict', auditRequired: true }
-    },
-    action: { update: true, datatables: false }
-  };
-  const err = expectThrowsWithMessage(
-    () => PayloadValidator.validatePayloadStructure(payload, 'karyawan.json', true),
-    "'fieldProtection' in karyawan.json has been replaced by 'fieldPolicy'"
-  );
-  assert.match(err.message, /docs\/todo\/todo-fieldpolicy-extension\.md/);
-  assert.match(err.message, /strategies/);
-});
-
-test('validatePayloadStructure: payload dengan fieldPolicy valid lulus structure validation', () => {
-  const payload = {
-    tableName: 'karyawan',
-    primaryKey: 'id',
-    fieldName: ['id', 'salary'],
-    fieldPolicy: {
-      salary: { strategies: ['lock', 'audit'] }
-    },
-    action: { update: true, datatables: false }
-  };
-  assert.doesNotThrow(() => {
-    PayloadValidator.validatePayloadStructure(payload, 'karyawan.json', true);
-  });
-});
-
-test('validatePayloadStructure: payload dengan fieldPolicy strategy "condition" ditolak end-to-end', () => {
-  const payload = {
-    tableName: 'karyawan',
-    primaryKey: 'id',
-    fieldName: ['id', 'salary'],
-    fieldPolicy: {
-      salary: { strategies: ['condition'] }
-    },
-    action: { update: true, datatables: false }
-  };
-  expectThrowsWithMessage(
-    () => PayloadValidator.validatePayloadStructure(payload, 'karyawan.json', true),
-    'planned for Phase 2'
-  );
-});