@restforgejs/platform 5.1.4 → 5.1.7

package/generators/cli/data/pull.js

@@ -11,14 +11,17 @@
  * (amandemen arah B, lihat docs/plan/data-pull-push/data-pull-push-09-amendments.md).
  * Handler tetap tipis: seluruh logika berada di lib/data/pull-runner.js.
  *
- * Catatan: flag `--schema` (namespace) TIDAK dideklarasikan — namespace tabel
- * diambil dari SDF IR (amandemen A4). Lokasi SDF ditentukan `--schema-path`.
+ * Catatan: scope tabel dipilih lewat tepat satu dari `--table` / `--schema` /
+ * `--all-schemas`. Flag `--schema` di sini adalah FILTER scope (bukan penentu
+ * namespace) — namespace tabel tetap diambil dari SDF IR (amandemen A4). Lokasi
+ * SDF ditentukan `--schema-path`. Layout output: bersarang `<schema>/<table>.json`
+ * untuk tabel ber-schema, flat `<table>.json` untuk tabel tanpa schema.
  */
 
 module.exports = {
     resource: 'data',
     verb: 'pull',
-    description: 'Export isi tabel database ke file envelope JSON (data-storage/<table>.json) berdasarkan metadata SDF',
+    description: 'Export isi tabel database ke file envelope JSON (data-storage/<schema>/<table>.json) berdasarkan metadata SDF',
     category: 'introspection',
     flags: {
         table: {
@@ -27,11 +30,17 @@ module.exports = {
             default: null,
             description: 'Nama tabel sumber yang akan di-pull (harus terdaftar di SDF)'
         },
-        'all-tables': {
+        schema: {
+            type: 'string',
+            required: false,
+            default: null,
+            description: 'Filter schema: satu atau comma-separated (mutual-exclusive dengan --table/--all-schemas)'
+        },
+        'all-schemas': {
             type: 'boolean',
             required: false,
             default: false,
-            description: 'Pull seluruh tabel yang terdaftar di --schema-path (mutual-exclusive dengan --table)'
+            description: 'Pull seluruh tabel di semua schema (mutual-exclusive dengan --table/--schema)'
         },
         config: {
             type: 'string',
@@ -84,8 +93,8 @@ module.exports = {
     },
     examples: [
         'npx restforge data pull --table=visitors',
-        'npx restforge data pull --all-tables --config=db.env',
-        'npx restforge data pull --all-tables --config=db.env --json',
+        'npx restforge data pull --schema=public --config=db.env',
+        'npx restforge data pull --all-schemas --config=db.env --json',
         'npx restforge data pull --table=visitors --config=db.env --limit=500',
         'npx restforge data pull --table=visitors --config=db.env --json'
     ],

package/generators/cli/data/push.js

@@ -19,14 +19,18 @@
  * commit per batch). `--mode=...`/`--force` kini menjadi unknown flag → ditolak
  * arg-parser dengan exit 2 (perilaku standar).
  *
- * Catatan: flag `--schema` (namespace) TIDAK dideklarasikan — namespace tabel
- * diambil dari SDF IR (amandemen A4). Lokasi SDF ditentukan `--schema-path`.
+ * Catatan: scope tabel dipilih lewat tepat satu dari `--table` / `--schema` /
+ * `--all-schemas`. Flag `--schema` adalah FILTER scope (bukan penentu namespace) —
+ * namespace tabel tetap diambil dari SDF IR (amandemen A4). Lokasi SDF ditentukan
+ * `--schema-path`. Path input mengikuti aturan IDENTIK pull (bersarang
+ * `<schema>/<table>.json` untuk tabel ber-schema, flat `<table>.json` untuk tabel
+ * tanpa schema).
  */
 
 module.exports = {
     resource: 'data',
     verb: 'push',
-    description: 'Muat isi file envelope JSON (data-storage/<table>.json) ke tabel tujuan via INSERT batch berdasarkan metadata SDF',
+    description: 'Muat isi file envelope JSON (data-storage/<schema>/<table>.json) ke tabel tujuan via INSERT batch berdasarkan metadata SDF',
     category: 'management',
     flags: {
         table: {
@@ -35,11 +39,17 @@ module.exports = {
             default: null,
             description: 'Nama tabel tujuan yang akan di-push (harus terdaftar di SDF)'
         },
-        'all-tables': {
+        schema: {
+            type: 'string',
+            required: false,
+            default: null,
+            description: 'Filter schema: satu atau comma-separated (mutual-exclusive dengan --table/--all-schemas)'
+        },
+        'all-schemas': {
             type: 'boolean',
             required: false,
             default: false,
-            description: 'Push seluruh tabel yang punya file di --storage-path, urut topological FK parent→child (mutual-exclusive dengan --table)'
+            description: 'Push seluruh tabel di semua schema, urut topological FK parent→child (mutual-exclusive dengan --table/--schema)'
         },
         config: {
             type: 'string',
@@ -74,8 +84,8 @@ module.exports = {
     },
     examples: [
         'npx restforge data push --table=visitors',
-        'npx restforge data push --all-tables --config=db.env',
-        'npx restforge data push --all-tables --config=db.env --json',
+        'npx restforge data push --schema=public --config=db.env',
+        'npx restforge data push --all-schemas --config=db.env --json',
         'npx restforge data push --table=visitors --config=db.env --batch-size=500',
         'npx restforge data push --table=visitors --config=db.env --json'
     ],

package/generators/cli/fast-track.js

@@ -28,6 +28,11 @@ const http = require('node:http');
 const readline = require('node:readline');
 const { spawnSync } = require('node:child_process');
 
+// Loader SDF yang SAMA dengan `schema migrate`. Bersifat rekursif sehingga
+// struktur per-schema (mis. `schema/public/visitors.js`) ikut terbaca, dan
+// mengembalikan IR model dengan relasi ter-normalisasi (sumber FK yang andal).
+const { loadSchemaPath } = require('../lib/dbschema-kit/loader');
+
 // ---------------------------------------------------------------------------
 // Default konfigurasi (selaras dengan restforge-playbook/fast-track.mjs)
 // ---------------------------------------------------------------------------
@@ -207,9 +212,11 @@ const FALLBACK_TABLES = [
 ];
 
 /**
- * Mengumpulkan nama tabel dari folder schema bila ada; bila tidak, memakai
+ * Mengumpulkan nama tabel dari folder schema bila ada (rekursif, termasuk
+ * subfolder per schema seperti `schema/public/*.js`); bila tidak, memakai
  * daftar fallback yang dipadkan sampai 30 entri agar contoh kanonik (30 tabel)
- * tetap dapat dirender.
+ * tetap dapat dirender. Nama yang dikumpulkan adalah kebab tabel agar count
+ * preview konsisten dengan file payload/endpoint yang akan dibuat.
  */
 function collectTables(schemaDir) {
     let names = [];
@@ -217,10 +224,7 @@ function collectTables(schemaDir) {
 
     try {
         if (schemaDir && fs.existsSync(schemaDir) && fs.statSync(schemaDir).isDirectory()) {
-            names = fs.readdirSync(schemaDir)
-                .filter((f) => f.endsWith('.js') && !f.startsWith('_') && !f.endsWith('.test.js'))
-                .map((f) => f.slice(0, -3))
-                .sort();
+            names = loadModels(schemaDir).map((m) => m.kebab).sort();
             if (names.length > 0) realSchema = true;
         }
     } catch (_err) {
@@ -497,48 +501,64 @@ function ensureEnv(ctx) {
 const AUDIT_COLS = new Set(['created_at', 'created_by', 'updated_at', 'updated_by']);
 
 /**
- * Parse satu file SDF menjadi descriptor model. Deterministik dari SDF (tanpa DB):
- *   { kebab, table, pk, fields[{name,isPk,isAudit,fk}], fks[{childCol,parentTable,parentCol}], displayCols }
- * displayCols = kolom yang mengandung `code`/`name`, di luar PK & kolom audit
- * (dipakai sebagai kolom display saat tabel ini menjadi parent FK).
+ * Turunkan kebab dari NAMA TABEL (bukan nama file) dengan normalisasi
+ * `[._]` -> `-`, identik dengan penamaan file output `payload generate`
+ * (payload-runner: baseFilename = table.replace(/[._]/g, '-')). Dengan ini
+ * `endpoint create --payload=<kebab>.json` dan `payload migrate --name=<kebab>.json`
+ * menemukan file payload yang benar, baik untuk SDF bernama underscore (hasil
+ * `schema introspect`, mis. `visitor_categories.js`) maupun kebab.
+ */
+function tableToKebab(table) {
+    return table.replace(/[._]/g, '-');
+}
+
+/**
+ * Muat seluruh SDF di folder memakai loader dbschema-kit yang SAMA dengan
+ * `schema migrate`. Loader bersifat REKURSIF sehingga struktur per-schema
+ * (mis. `schema/public/visitors.js`) ikut terbaca; flat readdir lama hanya
+ * membaca top-level sehingga subfolder schema tidak dikenali.
+ *
+ * Mengembalikan descriptor per tabel (deterministik dari SDF, tanpa DB):
+ *   { kebab, table, fks[{childCol,parentTable,parentCol}], displayCols }
+ *
+ * FK dibaca dari `relations` (belongsTo) pada IR model. IR menormalkan KEDUA
+ * gaya format: blok `relations:` eksplisit (gaya `schema introspect`) DAN inline
+ * `fk:<parent>.<col>` pada field (di-auto-promote ke relations oleh ir-builder).
+ * displayCols = kolom code/name di luar PK & kolom audit, dipakai sebagai kolom
+ * display saat tabel ini menjadi parent FK (untuk `payload sync --expand-fk`).
  */
-function parseModel(absFile, kebab) {
-    let content = '';
-    try { content = fs.readFileSync(absFile, 'utf8'); } catch (_err) { /* kosong */ }
-    const table = (content.match(/defineModel\(\s*['"]([^'"]+)['"]/) || [, kebab.replace(/-/g, '_')])[1];
-    const block = (content.match(/fields\s*:\s*\{([\s\S]*?)\}/) || [, ''])[1];
-
-    const fields = [];
-    const re = /(\w+)\s*:\s*'([^']*)'/g;
-    let m;
-    while ((m = re.exec(block)) !== null) {
-        const name = m[1];
-        const spec = m[2];
-        const fkMatch = spec.match(/fk:(\w+)\.(\w+)/);
-        fields.push({
-            name,
-            isPk: /\bpk\b/.test(spec),
-            isAudit: AUDIT_COLS.has(name),
-            fk: fkMatch ? { parentTable: fkMatch[1], parentCol: fkMatch[2] } : null
+function loadModels(schemaDir) {
+    const models = loadSchemaPath(schemaDir);
+    const entries = [];
+    for (const model of models.values()) {
+        const table = model.tableName;
+        const primaryKey = Array.isArray(model.primaryKey) ? model.primaryKey : [];
+
+        const fks = [];
+        for (const rel of Object.values(model.relations || {})) {
+            if (rel.type !== 'belongsTo' || !rel.localKey || !rel.target) continue;
+            fks.push({
+                childCol: rel.localKey,
+                parentTable: rel.target,
+                parentCol: rel.references || null
+            });
+        }
+
+        const displayCols = Object.keys(model.fields || {}).filter((name) => {
+            const field = model.fields[name];
+            const isPk = (field && field.pk === true) || primaryKey.includes(name);
+            return !isPk && !AUDIT_COLS.has(name) && /(code|name)/i.test(name);
         });
-    }
-    const pk = (fields.find((f) => f.isPk) || {}).name || null;
-    const displayCols = fields
-        .filter((f) => !f.isPk && !f.isAudit && /(code|name)/i.test(f.name))
-        .map((f) => f.name);
-    const fks = fields
-        .filter((f) => f.fk)
-        .map((f) => ({ childCol: f.name, parentTable: f.fk.parentTable, parentCol: f.fk.parentCol }));
 
-    return { kebab, table, pk, fields, fks, displayCols };
+        entries.push({ kebab: tableToKebab(table), table, fks, displayCols });
+    }
+    entries.sort((a, b) => a.table.localeCompare(b.table));
+    return entries;
 }
 
-/** Bangun daftar model dari folder schema. */
+/** Bangun daftar model dari folder schema (rekursif, via loader bersama). */
 function buildTableEntries(schemaDir) {
-    const files = fs.readdirSync(schemaDir)
-        .filter((f) => f.endsWith('.js') && !f.startsWith('_') && !f.endsWith('.test.js'))
-        .sort();
-    return files.map((f) => parseModel(path.join(schemaDir, f), f.slice(0, -3)));
+    return loadModels(schemaDir);
 }
 
 /**
@@ -946,5 +966,5 @@ module.exports = {
 // terpisah tanpa menjalankan pipeline penuh. Pada penggunaan CLI normal env ini
 // tidak di-set sehingga export tetap berupa contract murni.
 if (process.env.FASTTRACK_TEST === '1') {
-    module.exports.__test = { parseModel, buildTableEntries, fkColumnsForEntry };
+    module.exports.__test = { loadModels, buildTableEntries, fkColumnsForEntry, tableToKebab };
 }