@restforgejs/platform 4.3.8 → 5.0.0

package/generators/lib/migrate/label-generator.js

@@ -1,38 +1,38 @@
-'use strict';
-
-/**
- * Port dari packages/designer/src/migrators/label_generator.rs.
- * Generator label field dari snake_case ke human-readable format.
- */
-
-const { snakeToTitle } = require('./naming');
-
-const LABEL_OVERRIDES = {
-    is_active: 'Status',
-    uom: 'UOM',
-    sku: 'SKU',
-    email: 'Email',
-    phone: 'Phone',
-    url: 'URL',
-    ip: 'IP',
-    id: 'ID'
-};
-
-function generateLabel(fieldName, isForeignKey) {
-    const name = String(fieldName || '');
-
-    if (Object.prototype.hasOwnProperty.call(LABEL_OVERRIDES, name)) {
-        return LABEL_OVERRIDES[name];
-    }
-
-    if (isForeignKey && name.endsWith('_id')) {
-        const stripped = name.slice(0, -3);
-        if (stripped.length > 0) {
-            return snakeToTitle(stripped);
-        }
-    }
-
-    return snakeToTitle(name);
-}
-
-module.exports = { generateLabel };
+'use strict';
+
+/**
+ * Port dari packages/designer/src/migrators/label_generator.rs.
+ * Generator label field dari snake_case ke human-readable format.
+ */
+
+const { snakeToTitle } = require('./naming');
+
+const LABEL_OVERRIDES = {
+    is_active: 'Status',
+    uom: 'UOM',
+    sku: 'SKU',
+    email: 'Email',
+    phone: 'Phone',
+    url: 'URL',
+    ip: 'IP',
+    id: 'ID'
+};
+
+function generateLabel(fieldName, isForeignKey) {
+    const name = String(fieldName || '');
+
+    if (Object.prototype.hasOwnProperty.call(LABEL_OVERRIDES, name)) {
+        return LABEL_OVERRIDES[name];
+    }
+
+    if (isForeignKey && name.endsWith('_id')) {
+        const stripped = name.slice(0, -3);
+        if (stripped.length > 0) {
+            return snakeToTitle(stripped);
+        }
+    }
+
+    return snakeToTitle(name);
+}
+
+module.exports = { generateLabel };

package/generators/lib/migrate/migrate-runner.js

@@ -1,187 +1,187 @@
-'use strict';
-
-/**
- * Migrate Runner — orchestrator untuk command `payload migrate`.
- *
- * Tanggung jawab:
- *  1. Resolve file config (.env) via cascade lookup standar platform
- *  2. Baca SERVER_ADDRESS dan SERVER_PORT dari config → konstruksi apiBaseUrl
- *     dengan format `http://{host}:{port}/api/{project}`
- *  3. Load file payload backend (RDF) dari --name (relative ke cwd/payload/
- *     atau absolute)
- *  4. Jalankan migrasi RDF → UDF via BackendPayloadMigrator
- *  5. Tulis output JSON ke directory --output (file name = basename tanpa ext +
- *     suffix `-app.json`)
- */
-
-const fs = require('fs');
-const path = require('path');
-
-const { resolveConfig, printDefaultConfigWarning } = require('../utils/config-resolver');
-const { readEnvFile } = require('../utils/env-manager');
-const { migrate } = require('./backend-payload-migrator');
-
-const DEFAULT_APP_NAME = 'My Application';
-const DEFAULT_APP_CODE_FALLBACK = 'my-app';
-const DEFAULT_PLUGIN = 'vanilla-js-basic';
-const DEFAULT_HOST = '127.0.0.1';
-const DEFAULT_BACKEND_PORT = 3000;
-const DEFAULT_FRONTEND_PORT = 8000;
-
-function resolveInputPath(nameArg, cwd) {
-    if (path.isAbsolute(nameArg)) return nameArg;
-    const direct = path.resolve(cwd, nameArg);
-    if (fs.existsSync(direct)) return direct;
-    const inPayload = path.resolve(cwd, 'payload', nameArg);
-    if (fs.existsSync(inPayload)) return inPayload;
-    // Fallback: return cwd-resolved path so caller dapat tampilkan error path
-    return direct;
-}
-
-function buildOutputPath(outputArg, inputBaseName, cwd) {
-    const targetFileName = inputBaseName;
-
-    if (!outputArg) {
-        const defaultDir = path.resolve(cwd, 'frontend', 'payload');
-        return path.join(defaultDir, targetFileName);
-    }
-
-    const abs = path.isAbsolute(outputArg) ? outputArg : path.resolve(cwd, outputArg);
-
-    // Treat as file path bila berakhiran .json (case insensitive)
-    if (/\.json$/i.test(abs)) return abs;
-
-    // Else treat as directory
-    return path.join(abs, targetFileName);
-}
-
-function readServerConfig(envFilePath) {
-    const { data } = readEnvFile(envFilePath);
-    const host = (typeof data.SERVER_ADDRESS === 'string' && data.SERVER_ADDRESS.length > 0)
-        ? data.SERVER_ADDRESS
-        : DEFAULT_HOST;
-    const portRaw = (typeof data.SERVER_PORT === 'string' && data.SERVER_PORT.length > 0)
-        ? data.SERVER_PORT
-        : '';
-    const portNum = parseInt(portRaw, 10);
-    const port = Number.isFinite(portNum) && portNum > 0 ? portNum : DEFAULT_BACKEND_PORT;
-    return { host, port };
-}
-
-function buildApiBaseUrl(host, port, project) {
-    const projectSegment = project ? `/${project}` : '';
-    return `http://${host}:${port}/api${projectSegment}`;
-}
-
-async function run(args) {
-    const cwd = process.cwd();
-
-    if (!args.name || typeof args.name !== 'string') {
-        const err = new Error('Flag --name is required (backend payload file name, e.g. visitors.json)');
-        err.exitCode = 2;
-        throw err;
-    }
-    if (!args.project || typeof args.project !== 'string') {
-        const err = new Error('Flag --project is required (project name used in apiBaseUrl)');
-        err.exitCode = 2;
-        throw err;
-    }
-
-    const resolved = resolveConfig(args.config, cwd);
-    if (!resolved) {
-        const err = new Error('Flag --config is required, or set a default config via `restforge config set-default`');
-        err.exitCode = 2;
-        throw err;
-    }
-    if (resolved.source === 'default') {
-        printDefaultConfigWarning(resolved.defaultName);
-    }
-    if (!fs.existsSync(resolved.path)) {
-        const err = new Error(`Config file not found: ${resolved.path}`);
-        err.exitCode = 3;
-        throw err;
-    }
-
-    const { host, port: backendPort } = readServerConfig(resolved.path);
-    const project = args.project;
-    const apiBaseUrl = buildApiBaseUrl(host, backendPort, project);
-
-    const frontendPortArg = (typeof args.port === 'number' && Number.isFinite(args.port) && args.port > 0)
-        ? args.port
-        : DEFAULT_FRONTEND_PORT;
-
-    const appName = args.appName || DEFAULT_APP_NAME;
-    const appCode = args.appCode || project || DEFAULT_APP_CODE_FALLBACK;
-    const plugin = args.plugin || DEFAULT_PLUGIN;
-
-    const inputPath = resolveInputPath(args.name, cwd);
-    if (!fs.existsSync(inputPath)) {
-        const err = new Error(`Input payload file not found: ${inputPath}`);
-        err.exitCode = 3;
-        throw err;
-    }
-    let backendPayload;
-    try {
-        const content = fs.readFileSync(inputPath, 'utf8');
-        backendPayload = JSON.parse(content);
-    } catch (e) {
-        const err = new Error(`Failed to parse JSON from ${inputPath}: ${e.message}`);
-        err.exitCode = 3;
-        throw err;
-    }
-
-    const inputBaseName = path.basename(inputPath);
-    const outputPath = buildOutputPath(args.output, inputBaseName, cwd);
-
-    if (fs.existsSync(outputPath) && !args.overwrite) {
-        const err = new Error(`Output file already exists: ${outputPath}. Use --overwrite to replace.`);
-        err.exitCode = 1;
-        throw err;
-    }
-
-    const result = migrate([backendPayload], appName, appCode, plugin, apiBaseUrl, frontendPortArg);
-    if (!result.success) {
-        const msg = (result.errors && result.errors.length > 0)
-            ? result.errors.join('; ')
-            : 'Migration failed without details';
-        const err = new Error(msg);
-        err.exitCode = 1;
-        throw err;
-    }
-
-    const outputDir = path.dirname(outputPath);
-    if (!fs.existsSync(outputDir)) {
-        fs.mkdirSync(outputDir, { recursive: true });
-    }
-    fs.writeFileSync(outputPath, JSON.stringify(result.payload, null, 2), 'utf8');
-
-    const stdout = process.stdout;
-    stdout.write('============================================================\n');
-    stdout.write('PAYLOAD MIGRATE - RDF (backend) -> UDF (frontend)\n');
-    stdout.write('============================================================\n\n');
-    stdout.write(`  Input        : ${inputPath}\n`);
-    stdout.write(`  Output       : ${outputPath}\n`);
-    stdout.write(`  Project      : ${project}\n`);
-    stdout.write(`  apiBaseUrl   : ${apiBaseUrl}\n`);
-    stdout.write(`  Backend port : ${backendPort}\n`);
-    stdout.write(`  Frontend port: ${frontendPortArg}\n`);
-    stdout.write(`  Pages        : ${result.pageResults.length}\n\n`);
-    for (const pr of result.pageResults) {
-        stdout.write(`  [OK] ${pr.pageId}: ${pr.fieldCount} field(s), ${pr.tableColCount} table column(s)\n`);
-    }
-    if (result.warnings && result.warnings.length > 0) {
-        stdout.write('\n  Warnings:\n');
-        for (const w of result.warnings) {
-            stdout.write(`    - ${w}\n`);
-        }
-    }
-    stdout.write('\n  Migration completed successfully.\n');
-}
-
-module.exports = {
-    run,
-    resolveInputPath,
-    buildOutputPath,
-    readServerConfig,
-    buildApiBaseUrl
-};
+'use strict';
+
+/**
+ * Migrate Runner — orchestrator untuk command `payload migrate`.
+ *
+ * Tanggung jawab:
+ *  1. Resolve file config (.env) via cascade lookup standar platform
+ *  2. Baca SERVER_ADDRESS dan SERVER_PORT dari config → konstruksi apiBaseUrl
+ *     dengan format `http://{host}:{port}/api/{project}`
+ *  3. Load file payload backend (RDF) dari --name (relative ke cwd/payload/
+ *     atau absolute)
+ *  4. Jalankan migrasi RDF → UDF via BackendPayloadMigrator
+ *  5. Tulis output JSON ke directory --output (file name = basename tanpa ext +
+ *     suffix `-app.json`)
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+const { resolveConfig, printDefaultConfigWarning } = require('../utils/config-resolver');
+const { readEnvFile } = require('../utils/env-manager');
+const { migrate } = require('./backend-payload-migrator');
+
+const DEFAULT_APP_NAME = 'My Application';
+const DEFAULT_APP_CODE_FALLBACK = 'my-app';
+const DEFAULT_PLUGIN = 'vanilla-js-basic';
+const DEFAULT_HOST = '127.0.0.1';
+const DEFAULT_BACKEND_PORT = 3000;
+const DEFAULT_FRONTEND_PORT = 8000;
+
+function resolveInputPath(nameArg, cwd) {
+    if (path.isAbsolute(nameArg)) return nameArg;
+    const direct = path.resolve(cwd, nameArg);
+    if (fs.existsSync(direct)) return direct;
+    const inPayload = path.resolve(cwd, 'payload', nameArg);
+    if (fs.existsSync(inPayload)) return inPayload;
+    // Fallback: return cwd-resolved path so caller dapat tampilkan error path
+    return direct;
+}
+
+function buildOutputPath(outputArg, inputBaseName, cwd) {
+    const targetFileName = inputBaseName;
+
+    if (!outputArg) {
+        const defaultDir = path.resolve(cwd, 'frontend', 'payload');
+        return path.join(defaultDir, targetFileName);
+    }
+
+    const abs = path.isAbsolute(outputArg) ? outputArg : path.resolve(cwd, outputArg);
+
+    // Treat as file path bila berakhiran .json (case insensitive)
+    if (/\.json$/i.test(abs)) return abs;
+
+    // Else treat as directory
+    return path.join(abs, targetFileName);
+}
+
+function readServerConfig(envFilePath) {
+    const { data } = readEnvFile(envFilePath);
+    const host = (typeof data.SERVER_ADDRESS === 'string' && data.SERVER_ADDRESS.length > 0)
+        ? data.SERVER_ADDRESS
+        : DEFAULT_HOST;
+    const portRaw = (typeof data.SERVER_PORT === 'string' && data.SERVER_PORT.length > 0)
+        ? data.SERVER_PORT
+        : '';
+    const portNum = parseInt(portRaw, 10);
+    const port = Number.isFinite(portNum) && portNum > 0 ? portNum : DEFAULT_BACKEND_PORT;
+    return { host, port };
+}
+
+function buildApiBaseUrl(host, port, project) {
+    const projectSegment = project ? `/${project}` : '';
+    return `http://${host}:${port}/api${projectSegment}`;
+}
+
+async function run(args) {
+    const cwd = process.cwd();
+
+    if (!args.name || typeof args.name !== 'string') {
+        const err = new Error('Flag --name is required (backend payload file name, e.g. visitors.json)');
+        err.exitCode = 2;
+        throw err;
+    }
+    if (!args.project || typeof args.project !== 'string') {
+        const err = new Error('Flag --project is required (project name used in apiBaseUrl)');
+        err.exitCode = 2;
+        throw err;
+    }
+
+    const resolved = resolveConfig(args.config, cwd);
+    if (!resolved) {
+        const err = new Error('Flag --config is required, or set a default config via `restforge config set-default`');
+        err.exitCode = 2;
+        throw err;
+    }
+    if (resolved.source === 'default') {
+        printDefaultConfigWarning(resolved.defaultName);
+    }
+    if (!fs.existsSync(resolved.path)) {
+        const err = new Error(`Config file not found: ${resolved.path}`);
+        err.exitCode = 3;
+        throw err;
+    }
+
+    const { host, port: backendPort } = readServerConfig(resolved.path);
+    const project = args.project;
+    const apiBaseUrl = buildApiBaseUrl(host, backendPort, project);
+
+    const frontendPortArg = (typeof args.port === 'number' && Number.isFinite(args.port) && args.port > 0)
+        ? args.port
+        : DEFAULT_FRONTEND_PORT;
+
+    const appName = args.appName || DEFAULT_APP_NAME;
+    const appCode = args.appCode || project || DEFAULT_APP_CODE_FALLBACK;
+    const plugin = args.plugin || DEFAULT_PLUGIN;
+
+    const inputPath = resolveInputPath(args.name, cwd);
+    if (!fs.existsSync(inputPath)) {
+        const err = new Error(`Input payload file not found: ${inputPath}`);
+        err.exitCode = 3;
+        throw err;
+    }
+    let backendPayload;
+    try {
+        const content = fs.readFileSync(inputPath, 'utf8');
+        backendPayload = JSON.parse(content);
+    } catch (e) {
+        const err = new Error(`Failed to parse JSON from ${inputPath}: ${e.message}`);
+        err.exitCode = 3;
+        throw err;
+    }
+
+    const inputBaseName = path.basename(inputPath);
+    const outputPath = buildOutputPath(args.output, inputBaseName, cwd);
+
+    if (fs.existsSync(outputPath) && !args.overwrite) {
+        const err = new Error(`Output file already exists: ${outputPath}. Use --overwrite to replace.`);
+        err.exitCode = 1;
+        throw err;
+    }
+
+    const result = migrate([backendPayload], appName, appCode, plugin, apiBaseUrl, frontendPortArg);
+    if (!result.success) {
+        const msg = (result.errors && result.errors.length > 0)
+            ? result.errors.join('; ')
+            : 'Migration failed without details';
+        const err = new Error(msg);
+        err.exitCode = 1;
+        throw err;
+    }
+
+    const outputDir = path.dirname(outputPath);
+    if (!fs.existsSync(outputDir)) {
+        fs.mkdirSync(outputDir, { recursive: true });
+    }
+    fs.writeFileSync(outputPath, JSON.stringify(result.payload, null, 2), 'utf8');
+
+    const stdout = process.stdout;
+    stdout.write('============================================================\n');
+    stdout.write('PAYLOAD MIGRATE - RDF (backend) -> UDF (frontend)\n');
+    stdout.write('============================================================\n\n');
+    stdout.write(`  Input        : ${inputPath}\n`);
+    stdout.write(`  Output       : ${outputPath}\n`);
+    stdout.write(`  Project      : ${project}\n`);
+    stdout.write(`  apiBaseUrl   : ${apiBaseUrl}\n`);
+    stdout.write(`  Backend port : ${backendPort}\n`);
+    stdout.write(`  Frontend port: ${frontendPortArg}\n`);
+    stdout.write(`  Pages        : ${result.pageResults.length}\n\n`);
+    for (const pr of result.pageResults) {
+        stdout.write(`  [OK] ${pr.pageId}: ${pr.fieldCount} field(s), ${pr.tableColCount} table column(s)\n`);
+    }
+    if (result.warnings && result.warnings.length > 0) {
+        stdout.write('\n  Warnings:\n');
+        for (const w of result.warnings) {
+            stdout.write(`    - ${w}\n`);
+        }
+    }
+    stdout.write('\n  Migration completed successfully.\n');
+}
+
+module.exports = {
+    run,
+    resolveInputPath,
+    buildOutputPath,
+    readServerConfig,
+    buildApiBaseUrl
+};

package/generators/lib/migrate/naming.js

@@ -1,43 +1,43 @@
-'use strict';
-
-/**
- * Port dari packages/designer/src/utils/naming.rs.
- * Konversi naming convention: snake_case -> kebab-case / camelCase / PascalCase / Title Case.
- */
-
-function capitalize(s) {
-    if (!s || s.length === 0) return '';
-    return s.charAt(0).toUpperCase() + s.slice(1).toLowerCase();
-}
-
-function snakeToKebab(name) {
-    return String(name || '').replace(/_/g, '-');
-}
-
-function snakeToCamel(name) {
-    const parts = String(name || '').split('_');
-    if (parts.length === 0) return '';
-    const first = parts.shift();
-    return first + parts.map(capitalize).join('');
-}
-
-function snakeToPascal(name) {
-    return String(name || '').split('_').map(capitalize).join('');
-}
-
-function snakeToTitle(name) {
-    return String(name || '').split('_').map(capitalize).join(' ');
-}
-
-function toClassName(appCode) {
-    return String(appCode || '').replace(/_/g, '-').split('-').map(capitalize).join('');
-}
-
-module.exports = {
-    capitalize,
-    snakeToKebab,
-    snakeToCamel,
-    snakeToPascal,
-    snakeToTitle,
-    toClassName
-};
+'use strict';
+
+/**
+ * Port dari packages/designer/src/utils/naming.rs.
+ * Konversi naming convention: snake_case -> kebab-case / camelCase / PascalCase / Title Case.
+ */
+
+function capitalize(s) {
+    if (!s || s.length === 0) return '';
+    return s.charAt(0).toUpperCase() + s.slice(1).toLowerCase();
+}
+
+function snakeToKebab(name) {
+    return String(name || '').replace(/_/g, '-');
+}
+
+function snakeToCamel(name) {
+    const parts = String(name || '').split('_');
+    if (parts.length === 0) return '';
+    const first = parts.shift();
+    return first + parts.map(capitalize).join('');
+}
+
+function snakeToPascal(name) {
+    return String(name || '').split('_').map(capitalize).join('');
+}
+
+function snakeToTitle(name) {
+    return String(name || '').split('_').map(capitalize).join(' ');
+}
+
+function toClassName(appCode) {
+    return String(appCode || '').replace(/_/g, '-').split('-').map(capitalize).join('');
+}
+
+module.exports = {
+    capitalize,
+    snakeToKebab,
+    snakeToCamel,
+    snakeToPascal,
+    snakeToTitle,
+    toClassName
+};