@restforgejs/platform 5.1.21 → 5.2.0

package/generators/cli/payload/generate.js

@@ -17,31 +17,31 @@ const { PayloadGenerator } = require('../../lib/payload/payload-runner');
 module.exports = {
     resource: 'payload',
     verb: 'generate',
-    description: 'Generate payload JSON dari schema database (introspeksi tabel)',
+    description: 'Generate JSON payload from database schema (table introspection)',
     category: 'generation',
     flags: {
         config: {
             type: 'string',
             required: false,
             default: null,
-            description: 'File config database (.env). Fallback ke `.restforge/defaults.json` bila tidak disediakan eksplisit (set via `config set-default`)'
+            description: 'Database config file (.env). Fallback to `.restforge/defaults.json` if not explicitly provided (set via `config set-default`)'
         },
         table: {
             type: 'string',
             required: true,
-            description: 'Nama tabel spesifik yang akan di-generate payload-nya'
+            description: 'Specific table name to generate a payload for'
         },
         output: {
             type: 'string',
             required: false,
             default: null,
-            description: 'Output directory untuk file payload yang di-generate (default: payload/)'
+            description: 'Output directory for generated payload files (default: payload/)'
         },
         'schema-path': {
             type: 'string',
             required: false,
             default: 'schema',
-            description: 'Lokasi SDF (file atau folder) sumber metadata tabel (default: folder `schema`). WAJIB memuat tabel bila tabel memiliki kolom soft-delete (is_deleted/deleted_at/deleted_by): blok softDelete RDF diturunkan dari SDF (R12/R13). Diabaikan untuk tabel non-soft-delete.'
+            description: 'SDF location (file or folder) for table metadata (default: `schema` folder). REQUIRED to include the table if it has soft-delete columns (is_deleted/deleted_at/deleted_by): the softDelete RDF block is derived from the SDF (R12/R13). Ignored for non-soft-delete tables.'
         }
     },
     examples: [

package/generators/cli/payload/sync.js

@@ -16,32 +16,32 @@ const { PayloadGenerator } = require('../../lib/payload/payload-runner');
 module.exports = {
     resource: 'payload',
     verb: 'sync',
-    description: 'Apply schema drift dari database ke file payload (update kolom, tipe, constraint)',
+    description: 'Apply schema drift from database to payload files (updates columns, types, constraints)',
     category: 'management',
     flags: {
         config: {
             type: 'string',
             required: false,
             default: null,
-            description: 'File config database (.env). Fallback ke `.restforge/defaults.json` bila tidak disediakan eksplisit (set via `config set-default`)'
+            description: 'Database config file (.env). Fallback to `.restforge/defaults.json` if not explicitly provided (set via `config set-default`)'
         },
         table: {
             type: 'string',
             required: false,
             default: null,
-            description: 'Sync hanya satu tabel spesifik (default: semua)'
+            description: 'Sync only a specific table (default: all)'
         },
         'expand-fk': {
             type: 'boolean',
             required: false,
             default: false,
-            description: 'Generate konfigurasi JOIN dari foreign key: buat file SQL query/<table>-join.sql dan set datatablesQuery/viewQuery ke file tersebut. Opt-in; tanpa flag ini perilaku sync tidak berubah. Butuh --table. Bila --fk-columns tidak diisi, kolom display per FK dipilih otomatis (name/nama -> code/kode -> primary key)'
+            description: 'Generate JOIN configuration from foreign keys: creates SQL file query/<table>-join.sql and sets datatablesQuery/viewQuery to that file. Opt-in; without this flag sync behavior is unchanged. Requires --table. If --fk-columns is empty, display columns per FK are auto-selected (name → code → primary key)'
         },
         'fk-columns': {
             type: 'string',
             required: false,
             default: null,
-            description: 'Opsional. Daftar kolom tabel referensi yang di-surface lewat JOIN. Setiap entri WAJIB berbentuk `table.column` (qualified), dipisah koma. Contoh: visitor_categories.category_code,visitor_categories.category_name. Bila dikosongkan, di-resolve otomatis per FK'
+            description: 'Optional. List of reference table columns to surface via JOIN. Each entry MUST be in `table.column` (qualified) format, comma-separated. Example: visitor_categories.category_code,visitor_categories.category_name. If empty, resolved automatically per FK'
         }
     },
     examples: [

package/generators/cli/payload/validate.js

@@ -15,20 +15,20 @@ const { PayloadGenerator } = require('../../lib/payload/payload-runner');
 module.exports = {
     resource: 'payload',
     verb: 'validate',
-    description: 'Validate payload terhadap struktur tabel database (read-only)',
+    description: 'Validate payload against database table structure (read-only)',
     category: 'introspection',
     flags: {
         config: {
             type: 'string',
             required: false,
             default: null,
-            description: 'File config database (.env). Fallback ke `.restforge/defaults.json` bila tidak disediakan eksplisit (set via `config set-default`)'
+            description: 'Database config file (.env). Fallback to `.restforge/defaults.json` if not explicitly provided (set via `config set-default`)'
         },
         table: {
             type: 'string',
             required: false,
             default: null,
-            description: 'Validate hanya satu tabel spesifik (default: semua)'
+            description: 'Validate only a specific table (default: all)'
         }
     },
     examples: [

package/generators/cli/processor/create.js

@@ -857,41 +857,41 @@ function updateEndpointMetadata(moduleName, endpointName, payload) {
 module.exports = {
     resource: 'processor',
     verb: 'create',
-    description: 'Generate processor dari payload JSON',
+    description: 'Generate a processor from a JSON payload',
     category: 'generation',
     flags: {
         project: {
             type: 'string',
             required: true,
-            description: 'Nama project target'
+            description: 'Target project name'
         },
         name: {
             type: 'string',
             required: true,
-            description: 'Nama processor (endpoint) yang akan dibuat'
+            description: 'Processor (endpoint) name to create'
         },
         payload: {
             type: 'string',
             required: true,
-            description: 'Path atau nama file payload JSON'
+            description: 'Path or filename of the JSON payload'
         },
         database: {
             type: 'string',
             required: false,
             default: null,
-            description: 'Tipe database (postgres|mysql|oracle|sqlite). Default: postgres'
+            description: 'Database type (postgres|mysql|oracle|sqlite). Default: postgres'
         },
         force: {
             type: 'boolean',
             required: false,
             default: false,
-            description: 'Timpa file existing (processor file di-archive sebelum overwrite)'
+            description: 'Overwrite existing files (processor file is archived before overwrite)'
         },
         'skip-sql-validation': {
             type: 'boolean',
             required: false,
             default: false,
-            description: 'Lewati validasi keyword SQL'
+            description: 'Skip SQL keyword validation'
         }
     },
     examples: [

package/generators/cli/processor/list.js

@@ -167,20 +167,20 @@ function renderHumanTable(entries) {
 module.exports = {
     resource: 'processor',
     verb: 'list',
-    description: 'Menampilkan daftar processor dari workbench metadata di working directory',
+    description: 'List processors from workbench metadata in the working directory',
     category: 'management',
     flags: {
         format: {
             type: 'string',
             required: false,
             default: 'text',
-            description: 'Format output: `text` (table human-readable) atau `json` (untuk AI agent / mcp-server)'
+            description: 'Output format: `text` (human-readable table) or `json` (for AI agent / mcp-server)'
         },
         name: {
             type: 'string',
             required: false,
             default: null,
-            description: 'Filter nama processor, case-insensitive. Wildcard `*` = karakter apa pun (mis. `*order*`); tanpa wildcard berarti exact match'
+            description: 'Filter processor name, case-insensitive. Wildcard `*` matches any characters (e.g., `*order*`); without wildcard means exact match'
         }
     },
     examples: [

package/generators/cli/project/delete.js

@@ -209,13 +209,13 @@ function displayModuleSummary(workingDir, moduleName, moduleInfo, submodules, mo
 module.exports = {
     resource: 'project',
     verb: 'delete',
-    description: 'Menghapus project beserta seluruh endpoint, processor, dashboard, dan consumer di dalamnya',
+    description: 'Delete a project along with all its endpoints, processors, dashboards, and consumers',
     category: 'management',
     flags: {
         project: {
             type: 'string',
             required: true,
-            description: 'Nama project yang akan dihapus'
+            description: 'Project name to delete'
         },
         yes: {
             type: 'boolean',

package/generators/cli/project/list.js

@@ -17,7 +17,7 @@ const projectRegistry = require('../../lib/utils/project-registry');
 module.exports = {
     resource: 'project',
     verb: 'list',
-    description: 'Menampilkan daftar project yang terdaftar di registry',
+    description: 'List projects registered in the registry',
     category: 'management',
     flags: {},
     examples: [

package/generators/cli/query/validate.js

@@ -28,19 +28,19 @@ function isReadOnlySql(sql) {
 module.exports = {
     resource: 'query',
     verb: 'validate',
-    description: 'Validate SQL statement (SELECT/CTE) terhadap database live menggunakan EXPLAIN (read-only, tidak mengeksekusi data modification)',
+    description: 'Validate SQL statement (SELECT/CTE) against a live database using EXPLAIN (read-only, does not execute data modification)',
     category: 'introspection',
     flags: {
         config: {
             type: 'string',
             required: false,
             default: null,
-            description: 'File config database (.env). Fallback ke `.restforge/defaults.json` bila tidak disediakan eksplisit (set via `config set-default`)'
+            description: 'Database config file (.env). Fallback to `.restforge/defaults.json` if not explicitly provided (set via `config set-default`)'
         },
         sql: {
             type: 'string',
             required: true,
-            description: 'SQL statement untuk divalidasi (hanya SELECT atau WITH/CTE)'
+            description: 'SQL statement to validate (SELECT or WITH/CTE only)'
         },
         pretty: {
             type: 'boolean',

package/generators/cli/schema/apply.js

@@ -214,50 +214,50 @@ function buildExitCode(result) {
 module.exports = {
     resource: 'schema',
     verb: 'apply',
-    description: 'Apply drift dari SDF ke database via ALTER TABLE incremental (komplemen schema diff)',
+    description: 'Apply schema drift to database via incremental ALTER TABLE (complements schema diff)',
     category: 'management',
     flags: {
-        path: {
+        'schema-path': {
             type: 'string',
             required: true,
-            description: 'Path file atau folder schema (mis. ./schema atau ./schema/users.js)'
+            description: 'Path to schema file or directory (e.g., ./schema or ./schema/users.js)'
         },
         config: {
             type: 'string',
             required: false,
             default: null,
-            description: 'File config database (.env). Fallback ke `.restforge/defaults.json` bila tidak disediakan eksplisit (set via `config set-default`)'
+            description: 'Database config file (.env). Fallback to `.restforge/defaults.json` if not explicitly provided (set via `config set-default`)'
         },
         table: {
             type: 'string',
             required: false,
             default: null,
-            description: 'Apply hanya satu tabel spesifik (default: semua model di SDF)'
+            description: 'Apply only a specific table (default: all models in SDF)'
         },
         'dry-run': {
             type: 'boolean',
             required: false,
             default: false,
-            description: 'Preview ALTER tanpa apply ke database'
+            description: 'Preview ALTER statements without applying to database'
         },
         'allow-drop': {
             type: 'boolean',
             required: false,
             default: false,
-            description: 'Opt-in: izinkan DROP COLUMN/INDEX/UNIQUE constraint (destruktif data)'
+            description: 'Opt-in: allow DROP COLUMN/INDEX/UNIQUE constraint (destructive, data will be lost)'
         },
         'allow-modify': {
             type: 'boolean',
             required: false,
             default: false,
-            description: 'Opt-in: izinkan ALTER COLUMN length/nullable (potential data loss)'
+            description: 'Opt-in: allow ALTER COLUMN length/nullable (potential data loss)'
         }
     },
     examples: [
-        'npx restforge schema apply --path=./schema --config=db.env --dry-run',
-        'npx restforge schema apply --path=./schema --config=db.env',
-        'npx restforge schema apply --path=./schema --config=db.env --allow-drop',
-        'npx restforge schema apply --path=./schema/visitors.js --config=db.env --table=visitors --dry-run'
+        'npx restforge schema apply --schema-path=./schema --config=db.env --dry-run',
+        'npx restforge schema apply --schema-path=./schema --config=db.env',
+        'npx restforge schema apply --schema-path=./schema --config=db.env --allow-drop',
+        'npx restforge schema apply --schema-path=./schema/visitors.js --config=db.env --table=visitors --dry-run'
     ],
     async handler(args) {
         // 1. Resolve config
@@ -284,7 +284,7 @@ module.exports = {
         }
 
         // 2. Load SDF
-        const schemaPath = args.path;
+        const schemaPath = args['schema-path'];
         const absPath = path.resolve(process.cwd(), schemaPath);
 
         let sdfModels;

package/generators/cli/schema/describe.js

@@ -46,37 +46,37 @@ function buildColumns(detailedColumns, pkColumns) {
 module.exports = {
     resource: 'schema',
     verb: 'describe',
-    description: 'Menampilkan detail struktur satu tabel: kolom, primary key, foreign keys, indexes',
+    description: 'Show detailed structure of one table: columns, primary key, foreign keys, indexes',
     category: 'introspection',
     flags: {
         config: {
             type: 'string',
             required: false,
             default: null,
-            description: 'File config database (.env). Fallback ke `.restforge/defaults.json` bila tidak disediakan eksplisit (set via `config set-default`)'
+            description: 'Database config file (.env). Fallback to `.restforge/defaults.json` if not explicitly provided (set via `config set-default`)'
         },
         table: {
             type: 'string',
             required: true,
-            description: 'Nama tabel (unqualified atau qualified public.users)'
+            description: 'Table name (unqualified or qualified, e.g., public.users)'
         },
         'include-foreign-keys': {
             type: 'boolean',
             required: false,
             default: true,
-            description: 'Sertakan informasi foreign key'
+            description: 'Include foreign key information'
         },
         'include-indexes': {
             type: 'boolean',
             required: false,
             default: true,
-            description: 'Sertakan informasi indexes'
+            description: 'Include index information'
         },
         pretty: {
             type: 'boolean',
             required: false,
             default: true,
-            description: 'Pretty-print output JSON'
+            description: 'Pretty-print JSON output'
         }
     },
     examples: [

package/generators/cli/schema/diff.js

@@ -143,37 +143,37 @@ const defaultIntrospector = {
 module.exports = {
     resource: 'schema',
     verb: 'diff',
-    description: 'Drift detection antara SDF dan struktur tabel database (read-only, bidirectional)',
+    description: 'Drift detection between SDF and database table structure (read-only, bidirectional)',
     category: 'introspection',
     flags: {
-        path: {
+        'schema-path': {
             type: 'string',
             required: true,
-            description: 'Path file atau folder schema (mis. ./schema atau ./schema/users.js)'
+            description: 'Path to schema file or directory (e.g., ./schema or ./schema/users.js)'
         },
         config: {
             type: 'string',
             required: false,
             default: null,
-            description: 'File config database (.env). Fallback ke `.restforge/defaults.json` bila tidak disediakan eksplisit (set via `config set-default`)'
+            description: 'Database config file (.env). Fallback to `.restforge/defaults.json` if not explicitly provided (set via `config set-default`)'
         },
         table: {
             type: 'string',
             required: false,
             default: null,
-            description: 'Diff hanya satu tabel spesifik (default: semua model di SDF)'
+            description: 'Diff only a specific table (default: all models in SDF)'
         },
         json: {
             type: 'boolean',
             required: false,
             default: false,
-            description: 'Output format JSON (default: human-readable plain)'
+            description: 'Output in JSON format (default: human-readable plain)'
         }
     },
     examples: [
-        'npx restforge schema diff --path=./schema --config=db.env',
-        'npx restforge schema diff --path=./schema/visitors.js --config=db.env --table=visitors',
-        'npx restforge schema diff --path=./schema --config=db.env --json'
+        'npx restforge schema diff --schema-path=./schema --config=db.env',
+        'npx restforge schema diff --schema-path=./schema/visitors.js --config=db.env --table=visitors',
+        'npx restforge schema diff --schema-path=./schema --config=db.env --json'
     ],
     async handler(args) {
         // 1. Resolve config
@@ -201,7 +201,7 @@ module.exports = {
         }
 
         // 2. Load SDF
-        const schemaPath = args.path;
+        const schemaPath = args['schema-path'];
         const absPath = path.resolve(process.cwd(), schemaPath);
 
         let sdfModels;

package/generators/cli/schema/generate-ddl.js

@@ -24,35 +24,35 @@ const SUPPORTED_DIALECTS = ['postgres', 'mysql', 'oracle', 'sqlite'];
 module.exports = {
     resource: 'schema',
     verb: 'generate-ddl',
-    description: 'Generate DDL SQL (CREATE TABLE, CREATE INDEX, opsional DROP) untuk seluruh schema models',
+    description: 'Generate DDL SQL (CREATE TABLE, CREATE INDEX, optional DROP) for all schema models',
     category: 'generation',
     flags: {
-        path: {
+        'schema-path': {
             type: 'string',
             required: true,
-            description: 'Path file atau folder schema (mis. ./schema atau ./schema/users.js)'
+            description: 'Path to schema file or directory (e.g., ./schema or ./schema/users.js)'
         },
         dialect: {
             type: 'string',
             required: true,
             description: 'Target SQL dialect (postgres|mysql|oracle|sqlite)'
         },
-        out: {
+        output: {
             type: 'string',
             required: false,
             default: null,
-            description: 'File output untuk DDL hasil generate (default: stdout)'
+            description: 'Output file for generated DDL (default: stdout)'
         },
         drop: {
             type: 'boolean',
             required: false,
             default: false,
-            description: 'Sertakan statement DROP TABLE sebelum CREATE'
+            description: 'Include DROP TABLE statements before CREATE'
         }
     },
     examples: [
-        'npx restforge schema generate-ddl --path=./schema --dialect=postgres --out=migration.sql',
-        'npx restforge schema generate-ddl --path=./schema --dialect=mysql --drop=true'
+        'npx restforge schema generate-ddl --schema-path=./schema --dialect=postgres --output=migration.sql',
+        'npx restforge schema generate-ddl --schema-path=./schema --dialect=mysql --drop=true'
     ],
     async handler(args) {
         if (!args.dialect) {
@@ -65,7 +65,7 @@ module.exports = {
             throw new Error(`Unknown dialect '${args.dialect}'`);
         }
 
-        const schemaPath = args.path;
+        const schemaPath = args['schema-path'];
         const absPath = path.resolve(process.cwd(), schemaPath);
 
         let models;
@@ -94,8 +94,8 @@ module.exports = {
             throw err;
         }
 
-        if (args.out) {
-            const outPath = path.resolve(process.cwd(), args.out);
+        if (args.output) {
+            const outPath = path.resolve(process.cwd(), args.output);
             try {
                 fs.writeFileSync(outPath, sql, { encoding: 'utf-8' });
             } catch (err) {