@restforgejs/platform 4.3.8 → 5.0.1

package/generators/cli/init.js

@@ -3,9 +3,8 @@
 /**
  * Contract: init (verb global)
  *
- * Generate sample starter files (config, payload, query template) di working
- * directory. Membuat `config/db-connection.env`, `payload/samples.json`, dan
- * `payload/query/samples-datatables.sql` sebagai template starting point.
+ * Generate starter config file di working directory. Membuat
+ * `config/db-connection.env` sebagai template starting point.
  *
  * Inline migration v4.0.0: business logic asli dari `init.js` di-inline
  * langsung ke handler. Adapter `process.argv` override dihapus. `process.exit()`
@@ -21,88 +20,9 @@ const path = require('node:path');
 const fs = require('node:fs');
 const { DB_CONNECTION_ENV_TEMPLATE: TEMPLATE_ENV } = require('../lib/templates/db-connection-env');
 
-const TEMPLATE_PAYLOAD = JSON.stringify({
-    "tableName": "contact",
-    "primaryKey": "contact_id",
-    "fieldName": [
-        "contact_id",
-        "contact_name",
-        "email",
-        "address",
-        "is_active",
-        "created_at",
-        "created_by",
-        "updated_at",
-        "updated_by"
-    ],
-    "fieldValidation": [
-        {
-            "name": "contact_id",
-            "type": "string",
-            "constraints": {
-                "primaryKey": true,
-                "autoGenerate": true,
-                "required": true
-            }
-        },
-        {
-            "name": "contact_name",
-            "type": "string",
-            "constraints": {
-                "required": true
-            }
-        },
-        {
-            "name": "email",
-            "type": "string",
-            "constraints": {}
-        },
-        {
-            "name": "is_active",
-            "type": "boolean",
-            "constraints": {}
-        }
-    ],
-    "fieldNameLookup": {
-        "id": "contact_id",
-        "text": "contact_name||' - '||email as display_text"
-    },
-    "datatablesQuery": "file:query/samples-datatables.sql",
-    "datatablesWhere": [
-        "contact_name",
-        "email",
-        "address",
-        "all"
-    ],
-    "action": {
-        "datatables": true,
-        "create": true,
-        "update": true,
-        "delete": true,
-        "first": true,
-        "lookup": true,
-        "read": true,
-        "export": true,
-        "import": true,
-        "adjust": false,
-        "aggregate": false,
-        "createComposite": false,
-        "updateComposite": false,
-        "readComposite": false
-    }
-}, null, 4) + '\n';
-
-const TEMPLATE_SQL = `SELECT a.contact_id,
-       a.contact_name,
-       a.email,
-       a.address,
-       a.is_active
-FROM contact a
-`;
-
 module.exports = {
     verb: 'init',
-    description: 'Generate sample starter files (config, payload, query template) di working directory',
+    description: 'Generate starter config file (config/db-connection.env) di working directory',
     category: 'utility',
     flags: {
         force: {
@@ -128,14 +48,6 @@ module.exports = {
             {
                 relativePath: path.join('config', 'db-connection.env'),
                 content: TEMPLATE_ENV
-            },
-            {
-                relativePath: path.join('payload', 'samples.json'),
-                content: TEMPLATE_PAYLOAD
-            },
-            {
-                relativePath: path.join('payload', 'query', 'samples-datatables.sql'),
-                content: TEMPLATE_SQL
             }
         ];
 
@@ -159,9 +71,7 @@ module.exports = {
         }
 
         const dirs = [
-            path.resolve(workingDir, 'config'),
-            path.resolve(workingDir, 'payload'),
-            path.resolve(workingDir, 'payload', 'query')
+            path.resolve(workingDir, 'config')
         ];
 
         for (const dir of dirs) {
@@ -183,15 +93,5 @@ module.exports = {
         console.log('  1. Edit config/db-connection.env');
         console.log('     Update database credentials (DB_HOST, DB_USER, DB_PASSWORD, DB_NAME)');
         console.log('');
-        console.log('  2. Edit payload/samples.json');
-        console.log('     Adjust tableName, fieldName, and action as needed');
-        console.log('');
-        console.log('  3. Generate module:');
-        console.log('     npx restforge endpoint create --project=my-project --name=contact \\');
-        console.log('       --payload=payload/samples.json --config=config/db-connection.env');
-        console.log('');
-        console.log('  4. Start server:');
-        console.log('     npx restforge serve --project=my-project --config=config/db-connection.env');
-        console.log('');
     }
 };

package/generators/cli/payload/migrate.js

@@ -1,96 +1,96 @@
-'use strict';
-
-/**
- * Contract: payload migrate
- *
- * Konversi file payload backend (RDF / RESTForge consumer) menjadi file payload
- * frontend (UDF / designer). Port dari `rfd migrate` di packages/designer/.
- *
- * Perbedaan dengan `rfd migrate`:
- *  - `apiBaseUrl` di-construct dari SERVER_ADDRESS + SERVER_PORT (db-connection.env)
- *    + --project sehingga sesuai dengan runtime server actual
- *  - Port di-baca dari db-connection.env (SERVER_PORT), bukan hard-coded 3000
- *  - Primary key (constraints.primaryKey=true) di-skip dari fields[] apapun
- *    tipenya (uuid/string/integer), karena PK adalah identifier teknis dan
- *    tidak perlu di-render di UI form
- */
-
-const runner = require('../../lib/migrate/migrate-runner');
-
-module.exports = {
-    resource: 'payload',
-    verb: 'migrate',
-    description: 'Convert backend payload (RDF) file into frontend payload (UDF) for the designer',
-    category: 'generation',
-    flags: {
-        name: {
-            type: 'string',
-            required: true,
-            description: 'Backend payload file name (e.g. visitors.json). Relative to cwd or cwd/payload/.'
-        },
-        output: {
-            type: 'string',
-            required: false,
-            default: null,
-            description: 'Output directory (the file will be written with the same name as --name inside it). If ending with `.json`, treated as an explicit file path. Default: frontend/payload/'
-        },
-        config: {
-            type: 'string',
-            required: false,
-            default: null,
-            description: 'Database config file (.env). Used to read SERVER_ADDRESS and SERVER_PORT. Falls back to `.restforge/defaults.json`.'
-        },
-        project: {
-            type: 'string',
-            required: true,
-            description: 'Project name (kebab-case code) used as the path segment in apiBaseUrl: http://{host}:{port}/api/{project}'
-        },
-        'app-name': {
-            type: 'string',
-            required: false,
-            default: null,
-            description: 'Application name (default: "My Application")'
-        },
-        'app-code': {
-            type: 'string',
-            required: false,
-            default: null,
-            description: 'Application code in kebab-case (default: follows --project)'
-        },
-        plugin: {
-            type: 'string',
-            required: false,
-            default: null,
-            description: 'Designer plugin ID (default: "vanilla-js-basic")'
-        },
-        port: {
-            type: 'number',
-            required: false,
-            default: null,
-            description: 'Frontend application port written to appConfig.port (default: 8000). Independent from the backend port used in apiBaseUrl.'
-        },
-        overwrite: {
-            type: 'boolean',
-            required: false,
-            default: false,
-            description: 'Overwrite the output file if it already exists'
-        }
-    },
-    examples: [
-        'npx restforge payload migrate --name=visitors.json --output=..\\sandbox\\frontend\\payload --config=db.env --project=myapp',
-        'npx restforge payload migrate --name=visitors.json --project=myapp --overwrite'
-    ],
-    async handler(args) {
-        await runner.run({
-            name: args.name,
-            output: args.output || null,
-            config: args.config || null,
-            project: args.project,
-            appName: args['app-name'] || null,
-            appCode: args['app-code'] || null,
-            plugin: args.plugin || null,
-            port: typeof args.port === 'number' ? args.port : null,
-            overwrite: args.overwrite === true
-        });
-    }
-};
+'use strict';
+
+/**
+ * Contract: payload migrate
+ *
+ * Konversi file payload backend (RDF / RESTForge consumer) menjadi file payload
+ * frontend (UDF / designer). Port dari `rfd migrate` di packages/designer/.
+ *
+ * Perbedaan dengan `rfd migrate`:
+ *  - `apiBaseUrl` di-construct dari SERVER_ADDRESS + SERVER_PORT (db-connection.env)
+ *    + --project sehingga sesuai dengan runtime server actual
+ *  - Port di-baca dari db-connection.env (SERVER_PORT), bukan hard-coded 3000
+ *  - Primary key (constraints.primaryKey=true) di-skip dari fields[] apapun
+ *    tipenya (uuid/string/integer), karena PK adalah identifier teknis dan
+ *    tidak perlu di-render di UI form
+ */
+
+const runner = require('../../lib/migrate/migrate-runner');
+
+module.exports = {
+    resource: 'payload',
+    verb: 'migrate',
+    description: 'Convert backend payload (RDF) file into frontend payload (UDF) for the designer',
+    category: 'generation',
+    flags: {
+        name: {
+            type: 'string',
+            required: true,
+            description: 'Backend payload file name (e.g. visitors.json). Relative to cwd or cwd/payload/.'
+        },
+        output: {
+            type: 'string',
+            required: false,
+            default: null,
+            description: 'Output directory (the file will be written with the same name as --name inside it). If ending with `.json`, treated as an explicit file path. Default: frontend/payload/'
+        },
+        config: {
+            type: 'string',
+            required: false,
+            default: null,
+            description: 'Database config file (.env). Used to read SERVER_ADDRESS and SERVER_PORT. Falls back to `.restforge/defaults.json`.'
+        },
+        project: {
+            type: 'string',
+            required: true,
+            description: 'Project name (kebab-case code) used as the path segment in apiBaseUrl: http://{host}:{port}/api/{project}'
+        },
+        'app-name': {
+            type: 'string',
+            required: false,
+            default: null,
+            description: 'Application name (default: derived from --project in Title Case, e.g. "visitors-app" -> "Visitors App")'
+        },
+        'app-code': {
+            type: 'string',
+            required: false,
+            default: null,
+            description: 'Application code in kebab-case (default: follows --project)'
+        },
+        plugin: {
+            type: 'string',
+            required: false,
+            default: null,
+            description: 'Designer plugin ID (default: "vanilla-js-basic")'
+        },
+        port: {
+            type: 'number',
+            required: false,
+            default: null,
+            description: 'Frontend application port written to appConfig.port (default: 8000). Independent from the backend port used in apiBaseUrl.'
+        },
+        overwrite: {
+            type: 'boolean',
+            required: false,
+            default: false,
+            description: 'Overwrite the output file if it already exists'
+        }
+    },
+    examples: [
+        'npx restforge payload migrate --name=visitors.json --output=..\\sandbox\\frontend\\payload --config=db.env --project=myapp',
+        'npx restforge payload migrate --name=visitors.json --project=myapp --overwrite'
+    ],
+    async handler(args) {
+        await runner.run({
+            name: args.name,
+            output: args.output || null,
+            config: args.config || null,
+            project: args.project,
+            appName: args['app-name'] || null,
+            appCode: args['app-code'] || null,
+            plugin: args.plugin || null,
+            port: typeof args.port === 'number' ? args.port : null,
+            overwrite: args.overwrite === true
+        });
+    }
+};

package/generators/cli/schema/list.js

@@ -5,7 +5,10 @@
  *
  * Live database schema discovery: list semua tabel (dan view) dari database
  * yang ter-konfigurasi di file .env. Agnostic terhadap PostgreSQL, MySQL, dan
- * Oracle. Output JSON ke stdout untuk konsumsi AI agent atau direct CLI usage.
+ * Oracle.
+ *
+ * Output default berupa table human-readable yang di-group per schema. Output
+ * JSON (untuk konsumsi AI agent / mcp-server) tersedia via `--format=json`.
  *
  * Inline migration v4.0.0: business logic dari dbschema-list.js
  * dipindah ke handler. parseArguments/showHelp/process.exit dihilangkan
@@ -15,6 +18,52 @@
 const { DatabaseIntrospector } = require('../../lib/utils/database-introspector');
 const { resolveConfig, printDefaultConfigWarning } = require('../../lib/utils/config-resolver');
 
+/**
+ * Render daftar tabel ke format table human-readable, di-group per schema.
+ * @param {{schema:string,name:string,type:string}[]} tables
+ * @param {string[]} schemas
+ * @param {string} dbType
+ */
+function renderHumanTable(tables, schemas, dbType) {
+    const lines = [];
+
+    if (tables.length === 0) {
+        lines.push('');
+        lines.push(`No tables found (database: ${dbType}).`);
+        lines.push('');
+        return lines.join('\n');
+    }
+
+    const COL_NAME = 36;
+    const COL_TYPE = 8;
+
+    for (const schema of schemas) {
+        const inSchema = tables.filter(t => t.schema === schema);
+        if (inSchema.length === 0) continue;
+
+        lines.push('');
+        lines.push(`schema: ${schema}`);
+        lines.push('');
+        lines.push('Object Name'.padEnd(COL_NAME) + '| Type');
+        lines.push('-'.repeat(COL_NAME) + '+' + '-'.repeat(COL_TYPE));
+
+        for (const t of inSchema) {
+            const name = t.name.length > COL_NAME - 1
+                ? t.name.substring(0, COL_NAME - 3) + '..'
+                : t.name;
+            lines.push(name.padEnd(COL_NAME) + '| ' + t.type);
+        }
+    }
+
+    const schemaWord = schemas.length === 1 ? 'schema' : 'schemas';
+    const tableWord = tables.length === 1 ? 'table' : 'tables';
+    lines.push('');
+    lines.push(`Total: ${tables.length} ${tableWord} in ${schemas.length} ${schemaWord} (database: ${dbType})`);
+    lines.push('');
+
+    return lines.join('\n');
+}
+
 module.exports = {
     resource: 'schema',
     verb: 'list',
@@ -39,16 +88,23 @@ module.exports = {
             default: false,
             description: 'Sertakan system schemas'
         },
+        format: {
+            type: 'string',
+            required: false,
+            default: 'table',
+            description: 'Format output: `table` (human-readable, di-group per schema) atau `json` (untuk AI agent / mcp-server)'
+        },
         pretty: {
             type: 'boolean',
             required: false,
             default: true,
-            description: 'Pretty-print output JSON'
+            description: 'Pretty-print output JSON (hanya berlaku saat --format=json)'
         }
     },
     examples: [
         'npx restforge schema list --config=db.env',
-        'npx restforge schema list --config=db.env --schema=public'
+        'npx restforge schema list --config=db.env --schema=public',
+        'npx restforge schema list --config=db.env --format=json'
     ],
     async handler(args) {
         const resolved = resolveConfig(args.config, process.cwd());
@@ -89,21 +145,29 @@ module.exports = {
                 type: t.type
             }));
 
-            const output = {
-                schemaVersion: '1.0',
-                source: 'dbschema-list',
-                summary: {
-                    totalTables: tablesOut.length,
-                    schemas,
-                    database: introspector.dbType
-                },
-                tables: tablesOut
-            };
-
-            const json = args.pretty
-                ? JSON.stringify(output, null, 2)
-                : JSON.stringify(output);
-            process.stdout.write(json + '\n');
+            const format = (args.format || 'table').toLowerCase();
+
+            if (format === 'json') {
+                const output = {
+                    schemaVersion: '1.0',
+                    source: 'dbschema-list',
+                    summary: {
+                        totalTables: tablesOut.length,
+                        schemas,
+                        database: introspector.dbType
+                    },
+                    tables: tablesOut
+                };
+
+                const json = args.pretty
+                    ? JSON.stringify(output, null, 2)
+                    : JSON.stringify(output);
+                process.stdout.write(json + '\n');
+            } else {
+                process.stdout.write(
+                    renderHumanTable(tablesOut, schemas, introspector.dbType) + '\n'
+                );
+            }
         } catch (error) {
             console.error(`Error: ${error.message}`);
             if (process.env.DEBUG) {

package/generators/cli/schema/migrate.js

@@ -208,9 +208,11 @@ module.exports = {
                 console.log('');
             }
             console.log('Dry-run complete. No changes applied.');
-            const dryErr = new Error('schema migrate dry-run complete');
-            dryErr.exitCode = 2;
-            throw dryErr;
+            // Dry-run sukses: selesai bersih (exit 0) tanpa melempar error.
+            // Sebelumnya throw exitCode=2 dipakai sebagai sinyal "no changes",
+            // tetapi menampilkan baris "Error: ..." menyesatkan user padahal
+            // tidak ada kegagalan.
+            return;
         }
 
         if (statements.length === 0) {
@@ -218,6 +220,24 @@ module.exports = {
             return;
         }
 
+        // ------------------------------------------------------------------
+        // Konfirmasi destruktif untuk mode --drop (apply nyata saja; dry-run
+        // sudah return di atas). Dialog y/N hanya ditampilkan di terminal
+        // interaktif (TTY) dengan default No. Pada mode non-interaktif (CI/pipe)
+        // prompt dilewati agar proses tidak hang, perilaku apply tetap seperti
+        // sebelumnya.
+        // ------------------------------------------------------------------
+        if (args.drop === true) {
+            const { isInteractive, promptYesNo } = require('../../../src/utils/db-bootstrap');
+            if (isInteractive()) {
+                const confirmed = await promptYesNo('Drop and re-create all tables now? Existing data will be lost. (y/N): ');
+                if (!confirmed) {
+                    console.log('Aborted by user. No changes applied.');
+                    return;
+                }
+            }
+        }
+
         // ------------------------------------------------------------------
         // Pre-check database existence (khusus postgres/mysql).
         // Bila database tujuan tidak ada, tawarkan pembuatan otomatis via