@restforgejs/platform 5.1.4 → 5.1.7

package/generators/lib/data/envelope.js

@@ -4,27 +4,33 @@
  * envelope — Bentuk + I/O envelope file data.
  *
  * Struktur envelope (urutan key wajib dipertahankan):
- *   { format_version, table, source_dialect, columns, rows }
+ *   { format_version, schema, table, source_dialect, columns, rows }
+ *
+ * `schema` (= `ir.schemaName`, `null` bila tanpa schema) ditambahkan di format
+ * version 1.1. File 1.0 (tanpa `schema`) tetap diterima oleh `validateEnvelope`
+ * untuk back-compat baca `data push`.
  *
  * Mengacu pada docs/plan/data-pull-push/data-pull-push-03-data-format.md.
  *
  * @module generators/lib/data/envelope
  */
 
-const FORMAT_VERSION = '1.0';
+const FORMAT_VERSION = '1.1';
 
 /**
  * Bangun header envelope (tanpa rows).
  *
  * @param {Object} args
+ * @param {string|null} [args.schema] - Nama schema (= ir.schemaName; null bila tanpa schema)
  * @param {string} args.table - Nama tabel
  * @param {string} args.sourceDialect - Dialect sumber (mis. 'postgresql')
  * @param {Array<Object>} args.columns - Daftar kolom { name, type, nullable, primary_key }
- * @returns {{format_version: string, table: string, source_dialect: string, columns: Array}}
+ * @returns {{format_version: string, schema: (string|null), table: string, source_dialect: string, columns: Array}}
  */
-function buildHeader({ table, sourceDialect, columns }) {
+function buildHeader({ schema = null, table, sourceDialect, columns }) {
   return {
     format_version: FORMAT_VERSION,
+    schema,
     table,
     source_dialect: sourceDialect,
     columns
@@ -58,11 +64,11 @@ function resolveSink(sink) {
  * Menulis header, meng-append rows per batch, lalu menutup array `rows` dan envelope.
  * Cocok untuk tabel besar karena rows tidak perlu ditahan seluruhnya di memori.
  * Output akhir adalah JSON valid dengan urutan key:
- *   format_version, table, source_dialect, columns, rows
+ *   format_version, schema, table, source_dialect, columns, rows
  *
  * Penggunaan:
  *   const w = new EnvelopeWriter(fs.createWriteStream(path));
- *   w.writeHeader({ table, sourceDialect, columns });
+ *   w.writeHeader({ schema, table, sourceDialect, columns });
  *   w.appendRows(batch1);
  *   w.appendRows(batch2);
  *   w.end();
@@ -83,16 +89,17 @@ class EnvelopeWriter {
 
   /**
    * Tulis prefix header dan buka array `rows`.
-   * @param {Object} header - { table, sourceDialect, columns }
+   * @param {Object} header - { schema, table, sourceDialect, columns }
    * @returns {EnvelopeWriter} this
    */
-  writeHeader({ table, sourceDialect, columns }) {
+  writeHeader({ schema, table, sourceDialect, columns }) {
     if (this._state !== 'init') {
       throw new Error('EnvelopeWriter: writeHeader() hanya boleh dipanggil sekali di awal');
     }
     const prefix =
       '{' +
       `"format_version":${JSON.stringify(FORMAT_VERSION)},` +
+      `"schema":${JSON.stringify(schema ?? null)},` +
       `"table":${JSON.stringify(table)},` +
       `"source_dialect":${JSON.stringify(sourceDialect)},` +
       `"columns":${JSON.stringify(columns)},` +
@@ -163,7 +170,11 @@ function parseEnvelope(jsonString) {
  * Validasi shape envelope. Throw (exitCode=1) bila tidak valid.
  *
  * Wajib: format_version (ada), table (string), columns (array of {name,type}),
- * rows (array of object).
+ * rows (array of object). Opsional: `schema` (string atau null bila ada).
+ *
+ * `format_version` tetap LENIENT (cukup ada/non-null) agar file 1.0 maupun 1.1
+ * sama-sama diterima tanpa penolakan versi. `schema` opsional untuk back-compat:
+ * file 1.0 (tanpa key `schema`) diterima; bila ada, wajib string atau null.
  *
  * @param {Object} obj
  * @returns {Object} obj yang sama (untuk chaining)
@@ -182,6 +193,11 @@ function validateEnvelope(obj) {
   if (obj.format_version === undefined || obj.format_version === null) {
     fail('field "format_version" wajib ada');
   }
+  // `schema` opsional (back-compat 1.0). Bila absen → diterima; bila ada → wajib
+  // string atau null. `null` eksplisit (1.1 tabel schemaless) tetap valid.
+  if (obj.schema !== undefined && obj.schema !== null && typeof obj.schema !== 'string') {
+    fail('field "schema" wajib berupa string atau null bila ada');
+  }
   if (typeof obj.table !== 'string' || obj.table === '') {
     fail('field "table" wajib berupa string non-kosong');
   }

package/generators/lib/data/pull-runner.js

@@ -3,17 +3,18 @@
 /**
  * pull-runner — Business logic command `data pull`.
  *
- * `run()` adalah dispatcher (single vs all-tables); `runOne(ir, ctx)` mengeksekusi
+ * `run()` adalah dispatcher (single vs multi-schema); `runOne(ir, ctx)` mengeksekusi
  * pull satu tabel dan mengelola executor-nya sendiri (Phase 02, data-pull-push-v2).
  *
  * Alur dispatcher `run()`:
  *   1. Resolve config DB (config-resolver) → loadConfig (dbschema-kit/connection); SEKALI.
- *   2. Validasi mutual-exclusive (sebelum load SDF / koneksi DB): tepat satu dari
- *      --table / --all-tables (keduanya / tidak keduanya → exit 2).
+ *   2. parseSchemaFlag + validateScopeFlags (sebelum load SDF / koneksi DB): tepat satu
+ *      dari --table / --schema / --all-schemas (selain itu → exit 2).
  *   3. Validasi --format (hanya 'json').
  *   4. Load SDF SEKALI → Map<qualifiedName, IR> (sdf-reader).
- *   5a. Jalur --table:      findTableOrThrow → runOne(ir, ctx) → ringkasan single.
- *   5b. Jalur --all-tables: iterasi models.values() FAIL-FAST (Q3) → runOne per IR →
+ *   5. resolveScope(models, args, schemaList) → daftar IR sesuai flag scope.
+ *   5a. Jalur --table:               satu IR → runOne(ir, ctx) → ringkasan single.
+ *   5b. Jalur --schema/--all-schemas: iterasi subset FAIL-FAST (Q3) → runOne per IR →
  *       ringkasan agregat. Tabel yang sudah selesai sebelum error tetap tertulis.
  *
  * Alur `runOne(ir, ctx)` (per tabel; metadata kolom/namespace/PK murni dari SDF IR):
@@ -37,11 +38,11 @@ const { resolveConfig, printDefaultConfigWarning } = require('../utils/config-re
 const { loadConfig } = require('../dbschema-kit/connection');
 const {
     loadSdf,
-    findTableOrThrow,
     irToColumns,
     getNamespace,
     getPrimaryKey
 } = require('./sdf-reader');
+const { parseSchemaFlag, validateScopeFlags, resolveScope, relDataFilePath } = require('./data-scope');
 const { createDialect, validateIdentifier } = require('./dialect-kit');
 const { createExecutor } = require('./db-executor');
 const { encodeValue } = require('./value-codec');
@@ -176,10 +177,12 @@ async function pullInBatches({ executor, dialect, queryTable, columns, pk, batch
 }
 
 /**
- * Pull satu tabel SDF ke file envelope JSON `<output>/<qualifiedName>.json`.
+ * Pull satu tabel SDF ke file envelope JSON (path via relDataFilePath: bersarang
+ * `<output>/<schema>/<table>.json` bila ber-schema, flat `<output>/<table>.json`
+ * bila tanpa schema).
  *
  * Mengelola executor-nya sendiri (buat → disconnect, termasuk cleanup file partial
- * saat error) agar isolasi per-tabel jelas dan jalur --all-tables dapat memanggilnya
+ * saat error) agar isolasi per-tabel jelas dan jalur multi-schema dapat memanggilnya
  * berulang tanpa kebocoran koneksi. Metadata kolom, namespace, dan PK murni dari IR.
  *
  * @param {Object} ir - IR model SDF satu tabel
@@ -188,24 +191,24 @@ async function pullInBatches({ executor, dialect, queryTable, columns, pk, batch
  * @param {string} ctx.sourceDialect - dialect kanonik untuk header envelope
  * @param {Object} ctx.args - argumen ter-parse (storage-path, force, limit, batch-size)
  * @param {string} ctx.cwd - working directory
- * @returns {Promise<{table: string, rows: number, file: string, source_dialect: string}>}
+ * @returns {Promise<{schema: (string|null), table: string, rows: number, file: string, source_dialect: string}>}
  */
 async function runOne(ir, ctx) {
     const { config, sourceDialect, args, cwd } = ctx;
 
     const columns = irToColumns(ir);
-    const { qualifiedName } = getNamespace(ir);
+    const { schemaName, qualifiedName } = getNamespace(ir);
     const rawPk = getPrimaryKey(ir);
     const pk = Array.isArray(rawPk) ? rawPk : [];
 
     // ── a. Cek file output (SEBELUM menulis/konek) ───────────────────────────────
-    // Nama file = qualifiedName SDF (bukan ir.tableName), agar dua tabel bernama sama
-    // di schema berbeda tidak collision (mis. `sales.order_item.json`). Tabel tanpa
-    // schema: qualifiedName === tableName → `visitors.json` (tak berubah). Titik pada
-    // qualifiedName dipertahankan (valid sebagai nama file). push (Phase 03) menurunkan
-    // nama file dengan aturan identik dari SDF.
+    // Path diturunkan dari relDataFilePath (aturan seragam Q2): tabel ber-schema →
+    // bersarang `<schema>/<table>.json` (mis. `sales/order_item.json`); tabel tanpa
+    // schema → flat `<table>.json` (mis. `visitors.json`). Helper bersama dengan push
+    // (data-scope) agar derivasi tidak drift. queryTable SELECT tetap memakai
+    // qualifiedName (identitas DB).
     const outputDir = path.resolve(cwd, args['storage-path']);
-    const outFile = path.join(outputDir, `${qualifiedName}.json`);
+    const outFile = path.join(outputDir, relDataFilePath(ir));
     if (fs.existsSync(outFile) && args.force !== true) {
         const rel = path.relative(cwd, outFile).split(path.sep).join('/');
         throw failWith(
@@ -238,11 +241,14 @@ async function runOne(ir, ctx) {
     let rowCount = 0;
     let fd = null;
     try {
-        fs.mkdirSync(outputDir, { recursive: true });
+        // Buat direktori parent dari outFile (bukan sekadar outputDir): pada layout
+        // bersarang, outFile berada di subfolder schema (mis. `<storage>/main/`) yang
+        // belum tentu ada. path.dirname mencakup subfolder schema maupun flat root.
+        fs.mkdirSync(path.dirname(outFile), { recursive: true });
         fd = fs.openSync(outFile, 'w');
 
         const writer = new EnvelopeWriter((chunk) => fs.writeSync(fd, chunk));
-        writer.writeHeader({ table: ir.tableName, sourceDialect, columns });
+        writer.writeHeader({ schema: schemaName, table: ir.tableName, sourceDialect, columns });
 
         rowCount = await pullInBatches({
             executor,
@@ -277,6 +283,7 @@ async function runOne(ir, ctx) {
     // ── e. Ringkasan per-tabel (tanpa `command`; dirakit caller) ─────────────────
     const relFile = path.relative(cwd, outFile).split(path.sep).join('/');
     return {
+        schema: schemaName,
         table: ir.tableName,
         rows: rowCount,
         file: relFile,
@@ -285,10 +292,10 @@ async function runOne(ir, ctx) {
 }
 
 /**
- * Jalankan command `data pull` (dispatcher: single-table vs --all-tables).
+ * Jalankan command `data pull` (dispatcher: single-table vs multi-schema).
  * @param {Object} args - argumen ter-parse dari contract
- * @returns {Promise<Object>} ringkasan single { command, table, rows, file, source_dialect }
- *   atau agregat { command, all_tables, table_count, total_rows, tables: [...] }
+ * @returns {Promise<Object>} ringkasan single { command, schema, table, rows, file, source_dialect }
+ *   atau agregat { command, scope, table_count, total_rows, tables: [...] }
  */
 async function run(args) {
     const cwd = process.cwd();
@@ -312,17 +319,12 @@ async function run(args) {
         throw failWith(e.message, 2);
     }
 
-    // ── 2. Validasi mutual-exclusive --table / --all-tables (SEBELUM SDF/DB) ──────
-    // Arg-parser tidak punya mekanisme XOR lintas-flag (hanya `required` per-flag),
-    // sehingga "tepat satu" ditegakkan di sini. Exit 2 (precondition/usage).
+    // ── 2. Validasi scope flags (SEBELUM SDF/DB) ─────────────────────────────────
+    // Tepat satu dari --table / --schema / --all-schemas (selain itu → exit 2).
+    // Helper bersama dengan push (data-scope) agar perilaku identik.
+    const schemaList = parseSchemaFlag(args.schema);
+    validateScopeFlags(args, schemaList);
     const hasTable = args.table != null && args.table !== '';
-    const hasAll = args['all-tables'] === true;
-    if (hasTable && hasAll) {
-        throw failWith('Specify exactly one of --table or --all-tables.', 2);
-    }
-    if (!hasTable && !hasAll) {
-        throw failWith('Specify either --table=<name> or --all-tables.', 2);
-    }
 
     // ── 3. Validasi --format ─────────────────────────────────────────────────────
     if (args.format !== 'json') {
@@ -350,10 +352,14 @@ async function run(args) {
         cwd
     };
 
+    // ── 5. Resolusi scope → daftar IR ────────────────────────────────────────────
+    // --table → [ir] (exit 2 bila tak terdaftar/ambigu); --schema → subset (exit 2
+    // bila 0-match); --all-schemas → seluruh IR (boleh kosong → agregat 0 tabel).
+    const subset = resolveScope(models, args, schemaList);
+
     // ── 5a. Jalur --table (single; regresi nol) ──────────────────────────────────
     if (hasTable) {
-        const ir = findTableOrThrow(models, args.table); // throw exitCode=2 bila tak terdaftar
-        const per = await runOne(ir, ctx);
+        const per = await runOne(subset[0], ctx);
         const summary = { command: 'pull', ...per };
 
         if (args.json === true) {
@@ -366,13 +372,14 @@ async function run(args) {
         return summary;
     }
 
-    // ── 5b. Jalur --all-tables (fail-fast Q3; agregat) ───────────────────────────
+    // ── 5b. Jalur --schema/--all-schemas (fail-fast Q3; agregat) ─────────────────
     // Iterasi mengikuti urutan insertion Map (file SDF ter-sort alfabetis). Error
     // pada satu tabel menghentikan loop (fail-fast); tabel yang sudah selesai
-    // sebelum error tetap tertulis (konsekuensi Q3/R4, didokumentasikan Phase 05).
+    // sebelum error tetap tertulis (konsekuensi Q3/R4, didokumentasikan Phase 03).
+    const scope = schemaList ? 'schema' : 'all-schemas';
     const tables = [];
     let totalRows = 0;
-    for (const ir of models.values()) {
+    for (const ir of subset) {
         const per = await runOne(ir, ctx);
         tables.push(per);
         totalRows += per.rows;
@@ -385,7 +392,7 @@ async function run(args) {
 
     const aggregate = {
         command: 'pull',
-        all_tables: true,
+        scope,
         table_count: tables.length,
         total_rows: totalRows,
         tables

package/generators/lib/data/push-runner.js

@@ -7,21 +7,23 @@
  * di-descope dari v1 (User konfirmasi 2026-06-03), sehingga flag `--mode`/`--force`
  * dihapus dari contract dan runner tidak lagi membaca/memvalidasi keduanya.
  *
- * `run()` adalah dispatcher (single vs all-tables); `runOne(ir, ctx)` mengeksekusi
+ * `run()` adalah dispatcher (single vs multi-schema); `runOne(ir, ctx)` mengeksekusi
  * push satu tabel dan mengelola executor-nya sendiri (Phase 03, data-pull-push-v2).
  *
  * Alur dispatcher `run()`:
  *   1. Resolve config DB tujuan (config-resolver) → loadConfig (dbschema-kit/connection); SEKALI.
- *   2. Validasi mutual-exclusive (sebelum load SDF / koneksi DB): tepat satu dari
- *      --table / --all-tables (keduanya / tidak keduanya → exit 2).
+ *   2. parseSchemaFlag + validateScopeFlags (sebelum load SDF / koneksi DB): tepat satu
+ *      dari --table / --schema / --all-schemas (selain itu → exit 2).
  *   3. Load SDF SEKALI → Map<qualifiedName, IR> (sdf-reader).
- *   4a. Jalur --table:      findTableOrThrow → runOne(ir, ctx) → ringkasan single (regresi nol).
- *   4b. Jalur --all-tables: topoSortByFk(models) → urutan parent→child (table-order); siklus →
- *       warning stderr + fallback urutan deklarasi. Loop FAIL-FAST (Q3); tabel tanpa file
- *       input di-SKIP (warning stderr, catat di skipped[], lanjut) → runOne per IR → agregat.
+ *   4. resolveScope(models, args, schemaList) → daftar IR sesuai flag scope.
+ *   4a. Jalur --table:               satu IR → runOne(ir, ctx) → ringkasan single (regresi nol).
+ *   4b. Jalur --schema/--all-schemas: topoSortByFk(SUBSET) → urutan parent→child (table-order);
+ *       siklus → warning stderr + fallback urutan deklarasi. Loop FAIL-FAST (Q3); tabel tanpa
+ *       file input di-SKIP (warning stderr, catat di skipped[], lanjut) → runOne per IR → agregat.
  *
  * Alur `runOne(ir, ctx)` (per tabel; metadata kolom/namespace/PK murni dari SDF IR):
- *   a. Derive nama file dari SDF (aturan IDENTIK pull): {cwd}/{input}/{qualifiedName}.json.
+ *   a. Derive nama file dari SDF (aturan IDENTIK pull, relDataFilePath): bersarang
+ *      `<input>/<schema>/<table>.json` bila ber-schema, flat `<input>/<table>.json`.
  *      File tidak ada → exit 1. Baca + parseEnvelope + validateEnvelope (shape invalid → exit 1).
  *   b. Column match vs SDF (BUKAN introspeksi DB): tiap envelope.columns[].name harus ada
  *      di SDF dan tipe konsisten. Mismatch → exit 1. No-PK guard (exit 1).
@@ -46,11 +48,11 @@ const { resolveConfig, printDefaultConfigWarning } = require('../utils/config-re
 const { loadConfig } = require('../dbschema-kit/connection');
 const {
     loadSdf,
-    findTableOrThrow,
     irToColumns,
     getNamespace,
     getPrimaryKey
 } = require('./sdf-reader');
+const { parseSchemaFlag, validateScopeFlags, resolveScope, relDataFilePath } = require('./data-scope');
 const { createDialect, validateIdentifier, placeholder } = require('./dialect-kit');
 const { createExecutor } = require('./db-executor');
 const { decodeValue } = require('./value-codec');
@@ -135,10 +137,12 @@ function matchColumns(envelopeColumns, sdfColumns, tableName) {
 }
 
 /**
- * Push satu tabel SDF dari file envelope JSON `<input>/<qualifiedName>.json` ke DB.
+ * Push satu tabel SDF dari file envelope JSON ke DB. Path input via relDataFilePath
+ * (bersarang `<input>/<schema>/<table>.json` bila ber-schema, flat
+ * `<input>/<table>.json` bila tanpa schema).
  *
  * Mengelola executor-nya sendiri (buat → disconnect di finally) agar isolasi
- * per-tabel jelas dan jalur --all-tables dapat memanggilnya berulang tanpa kebocoran
+ * per-tabel jelas dan jalur multi-schema dapat memanggilnya berulang tanpa kebocoran
  * koneksi. Metadata kolom, namespace, dan PK murni dari IR.
  *
  * @param {Object} ir - IR model SDF satu tabel
@@ -147,24 +151,24 @@ function matchColumns(envelopeColumns, sdfColumns, tableName) {
  * @param {string} ctx.targetDialect - dialect kanonik (untuk output, dirakit caller)
  * @param {Object} ctx.args - argumen ter-parse (storage-path, batch-size)
  * @param {string} ctx.cwd - working directory
- * @returns {Promise<{table: string, rows: number, committed_batches: number}>}
+ * @returns {Promise<{schema: (string|null), table: string, rows: number, committed_batches: number}>}
  */
 async function runOne(ir, ctx) {
     const { config, args, cwd } = ctx;
 
     const sdfColumns = irToColumns(ir);
-    const { qualifiedName } = getNamespace(ir);
+    const { schemaName, qualifiedName } = getNamespace(ir);
     const rawPk = getPrimaryKey(ir);
     const pk = Array.isArray(rawPk) ? rawPk : [];
 
-    // ── a. Derive nama file dari SDF (aturan IDENTIK pull) + baca envelope ─────────
-    // Nama file = {input}/{qualifiedName}.json, turunan murni dari SDF (bukan --table
-    // mentah). Konsisten dengan pull (lihat phase-02b Keputusan K2): tabel ber-schema
-    // → `<schema>.<table>.json`; tanpa schema → `<table>.json`. Single-table:
-    // file-not-found = exit 1 (tak berubah). Jalur --all-tables menyaring file-missing
-    // SEBELUM memanggil runOne (skip-missing), jadi guard ini hanya tercapai pada single.
+    // ── a. Derive nama file dari SDF (aturan IDENTIK pull, relDataFilePath) ────────
+    // Path = {input}/relDataFilePath(ir), turunan MURNI dari SDF (bukan --table mentah
+    // maupun envelope.schema). Tabel ber-schema → bersarang `<schema>/<table>.json`;
+    // tanpa schema → flat `<table>.json`. Single-table: file-not-found = exit 1 (tak
+    // berubah). Jalur --schema/--all-schemas menyaring file-missing SEBELUM memanggil
+    // runOne (skip-missing), jadi guard ini hanya tercapai pada single.
     const inputDir = path.resolve(cwd, args['storage-path']);
-    const inFile = path.join(inputDir, `${qualifiedName}.json`);
+    const inFile = path.join(inputDir, relDataFilePath(ir));
     if (!fs.existsSync(inFile)) {
         const rel = path.relative(cwd, inFile).split(path.sep).join('/');
         throw failWith(`Input file not found: ${rel}`, 1);
@@ -180,6 +184,17 @@ async function runOne(ir, ctx) {
         throw failWith(`Failed to read envelope '${path.relative(cwd, inFile).split(path.sep).join('/')}': ${e.message}`, 1);
     }
 
+    // Cross-check OPSIONAL: path diturunkan dari SDF, bukan envelope. Bila envelope 1.1
+    // membawa `schema` yang berbeda dari schema SDF (mis. file dipindah/diedit manual),
+    // cetak warning informatif (bukan error) — konsisten perlakuan envelope.table.
+    // File 1.0 (tanpa `schema`, undefined) dilewati.
+    if (envelope.schema !== undefined && envelope.schema !== schemaName) {
+        process.stderr.write(
+            `Warning: envelope schema '${envelope.schema}' differs from SDF schema ` +
+            `'${schemaName === null ? '(none)' : schemaName}' for table '${ir.tableName}'\n`
+        );
+    }
+
     // ── b. Column match vs SDF (tanpa introspeksi DB) + no-PK guard ──────────────
     const insertColumns = matchColumns(envelope.columns, sdfColumns, ir.tableName);
 
@@ -233,6 +248,7 @@ async function runOne(ir, ctx) {
 
     // ── e. Ringkasan per-tabel (tanpa command/target_dialect; dirakit caller) ─────
     return {
+        schema: schemaName,
         table: ir.tableName,
         rows: rowCount,
         committed_batches: committedBatches
@@ -240,10 +256,10 @@ async function runOne(ir, ctx) {
 }
 
 /**
- * Jalankan command `data push` (dispatcher: single-table vs --all-tables, append-only).
+ * Jalankan command `data push` (dispatcher: single-table vs multi-schema, append-only).
  * @param {Object} args - argumen ter-parse dari contract
- * @returns {Promise<Object>} ringkasan single { command, table, rows, target_dialect, committed_batches }
- *   atau agregat { command, all_tables, table_count, total_rows, tables: [...], skipped: [...] }
+ * @returns {Promise<Object>} ringkasan single { command, schema, table, rows, target_dialect, committed_batches }
+ *   atau agregat { command, scope, table_count, total_rows, tables: [...], skipped: [...] }
  */
 async function run(args) {
     const cwd = process.cwd();
@@ -267,18 +283,12 @@ async function run(args) {
         throw failWith(e.message, 2);
     }
 
-    // ── 2. Validasi mutual-exclusive --table / --all-tables (SEBELUM SDF/DB) ──────
-    // Arg-parser tidak punya mekanisme XOR lintas-flag (hanya `required` per-flag),
-    // sehingga "tepat satu" ditegakkan di sini. Exit 2 (precondition/usage). Identik
-    // pull-runner Phase 02.
+    // ── 2. Validasi scope flags (SEBELUM SDF/DB) ─────────────────────────────────
+    // Tepat satu dari --table / --schema / --all-schemas (selain itu → exit 2).
+    // Helper bersama dengan pull (data-scope) agar perilaku identik.
+    const schemaList = parseSchemaFlag(args.schema);
+    validateScopeFlags(args, schemaList);
     const hasTable = args.table != null && args.table !== '';
-    const hasAll = args['all-tables'] === true;
-    if (hasTable && hasAll) {
-        throw failWith('Specify exactly one of --table or --all-tables.', 2);
-    }
-    if (!hasTable && !hasAll) {
-        throw failWith('Specify either --table=<name> or --all-tables.', 2);
-    }
 
     // ── 3. Load SDF (SEKALI) ─────────────────────────────────────────────────────
     const schemaPath = args['schema-path'];
@@ -298,12 +308,17 @@ async function run(args) {
         cwd
     };
 
+    // ── 4. Resolusi scope → daftar IR ────────────────────────────────────────────
+    // --table → [ir] (exit 2 bila tak terdaftar/ambigu); --schema → subset (exit 2
+    // bila 0-match); --all-schemas → seluruh IR (boleh kosong → agregat 0 tabel).
+    const subset = resolveScope(models, args, schemaList);
+
     // ── 4a. Jalur --table (single; regresi nol) ──────────────────────────────────
     if (hasTable) {
-        const ir = findTableOrThrow(models, args.table); // throw exitCode=2 bila tak terdaftar/ambigu
-        const per = await runOne(ir, ctx);
+        const per = await runOne(subset[0], ctx);
         const summary = {
             command: 'push',
+            schema: per.schema,
             table: per.table,
             rows: per.rows,
             target_dialect: ctx.targetDialect,
@@ -320,25 +335,28 @@ async function run(args) {
         return summary;
     }
 
-    // ── 4b. Jalur --all-tables (topo-sort FK parent→child, fail-fast Q3, skip-missing) ──
-    // Urutan push diturunkan dari FK SDF: parent (tabel direferensikan) SEBELUM child
-    // agar INSERT child tidak melanggar FK constraint. Siklus → fallback urutan deklarasi.
-    const { ordered, cycle } = topoSortByFk(models);
+    // ── 4b. Jalur --schema/--all-schemas (topo-sort FK parent→child, fail-fast Q3, skip-missing) ──
+    // Urutan push diturunkan dari FK SDF SUBSET (bukan seluruh models): parent (tabel
+    // direferensikan) SEBELUM child agar INSERT child tidak melanggar FK constraint.
+    // Siklus → fallback urutan deklarasi. Catatan (Phase 03): untuk --schema subset, FK
+    // ke parent di luar subset → edge diabaikan table-order; child bisa di-push tanpa
+    // parent → potensi FK error runtime (exit 3), tanpa pre-warning.
+    const scope = schemaList ? 'schema' : 'all-schemas';
+    const subsetMap = new Map(subset.map((ir) => [getNamespace(ir).qualifiedName, ir]));
+    const { ordered, cycle } = topoSortByFk(subsetMap);
     if (cycle) {
         process.stderr.write('FK cycle detected; falling back to declaration order\n');
     }
 
-    // Skip-missing HANYA di --all-tables: tabel tanpa file input dilewati (warning +
-    // catat), bukan error. Catatan (Phase 05): bila parent di-skip namun child ada,
-    // INSERT child dapat melanggar FK → muncul sebagai DB error exit 3 (fail-fast).
+    // Skip-missing HANYA di jalur multi: tabel tanpa file input dilewati (warning +
+    // catat), bukan error. Path input via relDataFilePath (aturan IDENTIK pull).
     const inputDir = path.resolve(cwd, args['storage-path']);
     const tables = [];
     const skipped = [];
     let totalRows = 0;
 
     for (const ir of ordered) {
-        const { qualifiedName } = getNamespace(ir);
-        const inFile = path.join(inputDir, `${qualifiedName}.json`);
+        const inFile = path.join(inputDir, relDataFilePath(ir));
         if (!fs.existsSync(inFile)) {
             process.stderr.write(`Skipped ${ir.tableName}: input file not found\n`);
             skipped.push(ir.tableName);
@@ -357,7 +375,7 @@ async function run(args) {
 
     const aggregate = {
         command: 'push',
-        all_tables: true,
+        scope,
         table_count: tables.length,
         total_rows: totalRows,
         tables,

package/generators/lib/templates/dashboard-catalog.js

@@ -1 +1 @@
-const a0_0x8f7365=a0_0x5fba;function a0_0x1bd9(){const _0x1b6fce=['zMLSztPXDwvYEs88Cgf0Ad4VyNjLywTKB3DUlNnXBa','Aw5OzxjPDhmGq0fdsevFvfrmigvUDG','C2nHBgfYihbYAw1PDgL2zq','u0vmrunuicOGrLjptsbZDg9JA19PBMjVDw5KifDirvjfievyvfjbq1qOwuvbuIbguK9nigLUyM91BMrFzgf0zsKGpsa6EwvHCG','D2LKz2v0lNf1zxjPzxmUpgTLEt4GD2L0AcbtuuWGCMv0DxjUAw5Nie4GCM93CW','yxjYyxK8C3rYAw5NpIWGB3b0Aw9UywWG4Ocuihn1yNnLDcbVzIb3AwrNzxqGsurZihrVigv4zwn1DguUie9TAxqGDg8GzxHLy3v0zsbHBgWGzgvJBgfYzwqGD2LKz2v0CY4','DMfSDwu','zMLSztPXDwvYEs88Cgf0Ad4VCg9PBNrZlNnXBa','twv0CMLJicSGu3bHCMTSAw5L','D2LKz2v0lNf1zxjPzxmUpgTLEt4GD2L0AcbtuuWGCMv0DxjUAw5NideGCM93imoxig11BhrPCgXLignVBhvTBNm','zMLSztPYzwXHDgL2zs9WyxrOl3rVl3f1zxj5lNnXBa','zxHWB3j0CW','sgvHzgXPBMuGBwv0CMLJihDPDgGGDhjLBMqGy2HPCcbHBMqGChjVz3jLC3mGyMfYigfNywLUC3qGysbWzxjPB2qGDgfYz2v0lIbtDwL0ywjSzsbMB3iGD2LKz2v0CYbSAwTLicDpCMrLCNmGvgHPCYbnB250AcCU','ugfYyw1LDgvYignVBNrYywn0igzVCIb0AguGzgfZAgjVyxjKlIbfywnOigTLEsbPCYbHihbHCMfTig5HBwu7ihzHBhvLCYbKzxnJCMLIzsb0ExbLl3jLCxvPCMvKl2rLzMf1BhqUifbSywnLAg9SzgvYCYbPBNnPzguGD2LKz2v0ifnrtcbTDxn0ihjLzMvYzw5JzsbKzwnSyxjLzcbWyxjHBsbUyw1LCY4','ue9tvcaVyxbPl21PBMKTAw52zw50B3j5l2rHC2GTAw5IB3vUzc9KyxnOyM9HCMq','yxjYyxK','n05KD0PuBq','tMvNyxrPDMuGBg9VA2jLAgLUzcbWCMv2zw50CYbTyxrJAgLUzYaNoJONicHqB3n0z3jLCYbJyxn0ihn5BNrHEcKGyxmGysbWBgfJzwHVBgrLCI4','DgfIBgvoyw1L','sgvHzgXPBMuGBwv0CMLJihDPDgGGDhjLBMqGy2HPCcbHBMqGC3bHCMTSAw5Lig1PBMKTy2HHCNqGzM9YihnOB3j0ihDPBMrVD3mGkdCGzgf5CYWGmtiGBw9UDgHZlcbLDgmUks4Gu3vPDgfIBguGzM9YihDPzgDLDhmGBgLRzsaNqxzLCMfNzsbeywLSEsbtywXLCYCU','msbYB3CGW5CGmIbJB2X1Bw5Z','vuKGBgfIzwWGAxmGysbMCM9UDgvUzcbYzw5KzxjPBMCGy29Uy2vYBI4','q29SBgfWC2uGDg8GC2nHBgfYihbYAw1PDgL2zsaODgHLihzHBhvLig9MihrOzsbZAw5NBguGy29SDw1Uks4','zgfZAgjVyxjKlwnHDgfSB2C','y2fJAgu','yw55icHTDxn0igjLignVBxbHDgLIBguGD2L0AcbKzwnSyxjLzcaNDhLWzsCP','EYbZDwnJzxnZoIbIB29SzwfUlcbKyxrHoIb7idX3AwrNzxrjzd46idXWzxjxAwrNzxrszxnWB25Zzt4Sic4UlIb9ih0','w3SGiMXHyMvSiJOGiLnOB2vZiIWGiNzHBhvLiJOGiJC2nJaIih0SihSGiMXHyMvSiJOGiKDHBwLUzYiSicj2ywX1zsi6iciYodiWiIb9lcb7icjSywjLBci6icjpDgHLCNmIlcaIDMfSDwuIoIaInduYntCIih1D','otK0nde5tgLUA3HA','nZqWmZeYDK94C3zc','Dg9WlwXLDMvSicDWyxjHBxmNig9IAMvJDa','msbYB3CGW5CGmsbJB2X1Bw4','zMLSztPXDwvYEs88Cgf0Ad4VDMfSDwuUC3fS','mty0odCWngXssM1guG','BM9UlwvTChr5lcb1BMLXDwuGywnYB3nZihDPzgDLDhmGAw4GDgHLihnHBwuGCgf5Bg9Hza','DhLWzq','mJqWnJiYnw5QwwrnuG','CgfYyw1Z','vg9Nz2XLignHy2HLigzLyxr1CMuGzM9YihrOAxmGzgfZAgjVyxjKlG','Bwv0CMLJx3bYB2DYzxnZx3rVx2DVywW','ugvYlwTLEsbIyxnLzcbVBIbZy2fSyxjdB2XSyxbZzvj1BgvZigjLBg93lG','B3jKzxjZx3rOAxnFBw9UDgG','ndCWC3zJvvvd','yM9VBgvHBG','qsbWyxLSB2fKihDPDgGGyM90AcaND2LKz2v0CYCGyw5KicD0ywjSzu5HBwuNigLZihjLAMvJDgvKigj5ierHC2HIB2fYzfzHBgLKyxrVCI4GugLJAYbVBMuGC2HHCguU','D2LKz2v0vhLWzq','DhjLBMq','BgfIzwW','uMvZzxj2zwqGzM9YiensvuqGCgf5Bg9HzhmUieeGzgfZAgjVyxjKihbHEwXVywqGBxvZDcbKzwnSyxjLicD3AwrNzxrZjYbPBNn0zwfKlG','msbYB3CGW5CGmsbJB2WSig91Dhb1DcbJB2X1Bw4Gj3zHBhvLjW','B2jQzwn0','iJi0mJaI','rgfZAgjVyxjKigvUzhbVAw50ig1HEsbVChqTAw4GDg8GuMvKAxmTyMfZzwqGy2fJAguUifbHDhrLCM4GzM9SBg93CYbWCM9JzxnZB3iGy2fJAguGkhnLzsbMzwf0lwnHy2HLlM1Kks4Gq2fJAguGC2nVCguGAxmGDgHLigz1BgWGCMvZCg9UC2uGzw52zwXVCgu7ig9UzsbJywnOzsbLBNrYEsbWzxiGkhbHCMfTCYaRihDPzgDLDhnBxsbZDwjZzxqPignVBwjPBMf0Aw9UlG','Dg9Wtgv2zwXbBgXVD2vK','v2LKz2v0igLKzw50AwzPzxi7ihvZzwqGyxmGDgHLihjLC3bVBNnLigTLEsbPBIb0AguGzgfZAgjVyxjKigvUDMvSB3bLlG','CxvLCMLLCW','DgfYz2v0','tM90igeGzgfZAgjVyxjKihbHEwXVywqGkgXPA2vSEsbduLveihDPDgGGDgfIBgvoyw1LlcbVCIbPBNzHBgLKkq','yxzNx2rHAwX5x3nHBgvZ','qwX3yxLZihSGAxrLBxm6ifSUlI5Dih0GCMvNyxjKBgvZCYbVzIbtuuWGCMvZDwX0ihnOyxbLlG','Cgn0','msbYB3CGW5CGmIbJB2XZlcbVDxrWDxqGy29SDw1UCYaNzgLYzwn0Aw9UjYWGj3bJDcC','v2HLBIb0CNvLlcb0AguGCMvXDwvZDcbIB2r5ie1vu1qGAw5JBhvKzsb0AgLZihbHCMfTicHVDgHLCNDPC2uGndaWks4','zw5HyMXLza','zMLSztPXDwvYEs88Cgf0Ad4VDhjLBMqUC3fS','CMvXDwLYzwq','mJC2nde5EfbnqK1M','ugfYyw0GBMfTzsbTDxn0ig1HDgnOihrOzsbWBgfJzwHVBgrLCIbYzwDLEcbGw2eTEKeTwL9Dw2eTEKeTwJaTov9DkMaGkgfSCgHHBNvTzxjPyYaRihvUzgvYC2nVCMuSig11C3qGC3rHCNqGD2L0AcbSzxr0zxiGB3iGDw5KzxjZy29YzsKU','zgLYzwn0Aw9U','CgvYAw9K','zgfZAc1PBMjVDw5K','BgvUz3rO','u2LUz2XLifnrtcbXDwvYEsbMB3iGDgHLihDPzgDLDc4','CxvLCNK','zxHWzwn0zwrFzwfYBMLUz3m','mti1ode2zuf2v3nu','Cg9PBNrZ','rNjVBNrLBMqGzgv0zxjTAw5LCYbKB251Dc9WAwuGDMfYAwfUDcWGy29SB3iGCgvYignHDgvNB3j5lcbHBMqGBgfIzwWGB3jKzxiUieLMihbLCI1JyxrLz29YEsbWzxjJzw50ywDLigLZig5LzwrLzcbMB3iGDgHLigrVBNv0igfYyYWGzNjVBNrLBMqGy29TChv0zxmGAxqGzNjVBsbPDgvTC1TPxs52ywX1zsaVihn1BsHPDgvTC1SQxs52ywX1zsKUie5Vig5LzwqGDg8GC2vUzcaNCgn0jYbMCM9TigjHy2TLBMqGDw5SzxnZihrOzsbMAwD1CMuGAxmGysbZDgfIBguGyNvZAw5LC3mGy2fSy3vSyxrPB24GAw5KzxbLBMrLBNqGB2yGDMLZDwfSihjLBMrLCMLUzY4','m2XwEfbwuq','tgLZDcbVzIbduLveihrHyMXLig5HBwvZihrOyxqSihDOzw4GD3jPDhrLBIWGD2LSBcb0CMLNz2vYigLUDMfSAwrHDgLVBIbVzIb0AgLZigrHC2HIB2fYzcbJywnOzs4','z2vUzxjHDgLVBIb0Aw1LicHot1qGCNvUDgLTzsK','nLnXrKrcvW','zgfZAgjVyxjKihbHEwXVywq','iJy5nZaWiG','vgLTzs10BY1SAxzLigLUihnLy29UzhmUidaGzwzMzwn0AxzLBhKGzgLZywjSzxmGy2fJAguGzM9YihrOAxmGzw50CNKU','vMLZDwfSihzHCMLHBNqGkgrVBNv0lcbIyxiSihbPzsWGyxjLysKGAxmGysbMCM9UDgvUzcbYzw5KzxjPBMCGy29Uy2vYBIaOC2vWyxjHDgLVBIbVzIbJB25JzxjUCYKU','q29SBgfWC2uGDg8GB2jQzwn0ihDOB3nLigTLExmGyxjLifnrtcbJB2X1Bw4GBMfTzxmGkgXVD2vYy2fZzwqPlG','mty4mJi1nNDOvgrZAa','Aw52ywXPzgf0zxm','twv0CMLJicSGuhjVz3jLC3mGDg8Gr29HBa','qsb3AwrNzxqGtvvtvcbKzwnSyxjLigv4ywn0BhKGB25Lig9MoIaNCxvLCNKNie9sicDXDwvYAwvZjY4GqM90AcbVCIbUzwL0AgvYigLZihjLAMvJDgvKlG','tgLZDcbVzIb3AwrNzxqGzgvMAw5PDgLVBNmUie9YzgvYigLZigLUzM9YBwf0Aw9UywWGB25SEsaOCMvZCg9UC2uGA2v5CYbHCMuGyNKGD2LKz2v0igLKlcbUB3qGyxjYyxKGAw5KzxGPlG'];a0_0x1bd9=function(){return _0x1b6fce;};return a0_0x1bd9();}function a0_0x5fba(_0x577dad,_0x13c29a){_0x577dad=_0x577dad-0x9c;const _0x1bd98f=a0_0x1bd9();let _0x5fba85=_0x1bd98f[_0x577dad];if(a0_0x5fba['DVwhas']===undefined){var _0xb4672d=function(_0xf33517){const _0x5e9201='abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789+/=';let _0x5a52be='',_0x2471e8='';for(let _0x39d2ff=0x0,_0x4dcdff,_0x45d33c,_0x4988dc=0x0;_0x45d33c=_0xf33517['charAt'](_0x4988dc++);~_0x45d33c&&(_0x4dcdff=_0x39d2ff%0x4?_0x4dcdff*0x40+_0x45d33c:_0x45d33c,_0x39d2ff++%0x4)?_0x5a52be+=String['fromCharCode'](0xff&_0x4dcdff>>(-0x2*_0x39d2ff&0x6)):0x0){_0x45d33c=_0x5e9201['indexOf'](_0x45d33c);}for(let _0x34a890=0x0,_0x29c11f=_0x5a52be['length'];_0x34a890<_0x29c11f;_0x34a890++){_0x2471e8+='%'+('00'+_0x5a52be['charCodeAt'](_0x34a890)['toString'](0x10))['slice'](-0x2);}return decodeURIComponent(_0x2471e8);};a0_0x5fba['JGsvKy']=_0xb4672d,a0_0x5fba['LnyIKt']={},a0_0x5fba['DVwhas']=!![];}const _0x47ded6=_0x1bd98f[0x0],_0x30874b=_0x577dad+_0x47ded6,_0x38cad0=a0_0x5fba['LnyIKt'][_0x30874b];return!_0x38cad0?(_0x5fba85=a0_0x5fba['JGsvKy'](_0x5fba85),a0_0x5fba['LnyIKt'][_0x30874b]=_0x5fba85):_0x5fba85=_0x38cad0,_0x5fba85;}(function(_0x533163,_0x463dd6){const _0x4da6d0=a0_0x5fba,_0x58da42=_0x533163();while(!![]){try{const _0x16ed12=parseInt(_0x4da6d0(0xb0))/0x1*(parseInt(_0x4da6d0(0xad))/0x2)+parseInt(_0x4da6d0(0xb9))/0x3+parseInt(_0x4da6d0(0xdf))/0x4+parseInt(_0x4da6d0(0xe2))/0x5*(parseInt(_0x4da6d0(0xb3))/0x6)+-parseInt(_0x4da6d0(0xce))/0x7*(-parseInt(_0x4da6d0(0xdb))/0x8)+-parseInt(_0x4da6d0(0xda))/0x9+-parseInt(_0x4da6d0(0xe8))/0xa*(parseInt(_0x4da6d0(0xa4))/0xb);if(_0x16ed12===_0x463dd6)break;else _0x58da42['push'](_0x58da42['shift']());}catch(_0x141317){_0x58da42['push'](_0x58da42['shift']());}}}(a0_0x1bd9,0x6c5ea));const FORBIDDEN_FRONTEND_FIELDS=[a0_0x8f7365(0xeb),'layout','title','subtitle','color'],ALLOWED_PARAM_TYPES=['string','number',a0_0x8f7365(0xe9),'date'],FRONTEND_CONCERN_REASONS={'widgetType':a0_0x8f7365(0xb7),'layout':'Layout\x20is\x20a\x20frontend\x20rendering\x20concern.','title':a0_0x8f7365(0xd3),'subtitle':'UI\x20label\x20is\x20a\x20frontend\x20rendering\x20concern.','color':'Visual\x20color\x20is\x20a\x20frontend\x20rendering\x20concern.'},PAYLOAD_SHAPE={'discriminator':{'field':'widgets','presentMeans':a0_0x8f7365(0xb4),'absentMeans':a0_0x8f7365(0xf7),'conflictsWith':a0_0x8f7365(0xd0),'conflictRationale':a0_0x8f7365(0xea)},'topLevelAllowed':[{'name':'widgets','type':a0_0x8f7365(0xcd),'required':!![],'minItems':0x1,'description':a0_0x8f7365(0xbd)},{'name':a0_0x8f7365(0xe3),'type':a0_0x8f7365(0xf0),'required':![],'description':a0_0x8f7365(0xcb)},{'name':a0_0x8f7365(0xd6),'type':'object','required':![],'description':'Optional\x20cache\x20configuration.\x20See\x20cacheSpec\x20for\x20details.'}],'topLevelForbidden':[{'name':'tableName','category':'shape-conflict','reason':a0_0x8f7365(0xee)},...FORBIDDEN_FRONTEND_FIELDS['map'](_0x5a52be=>({'name':_0x5a52be,'category':'frontend-concern','reason':FRONTEND_CONCERN_REASONS[_0x5a52be]}))]},WIDGET_SPEC={'requiredFields':[{'name':'id','type':'string','constraint':a0_0x8f7365(0xe0),'description':a0_0x8f7365(0xf4)}],'exclusiveQueryFields':{'rule':a0_0x8f7365(0xbc),'options':[{'name':a0_0x8f7365(0xab),'type':'string','format':a0_0x8f7365(0xc8),'description':a0_0x8f7365(0xaa),'responseShape':a0_0x8f7365(0x9d)},{'name':a0_0x8f7365(0xf5),'type':'object','format':'key→file:relative/path/to/query.sql','minKeys':0x1,'description':'Multi-SQL\x20widget.\x20Each\x20key\x20becomes\x20a\x20key\x20in\x20the\x20response\x20object.','responseShape':a0_0x8f7365(0xe6)}]},'forbiddenFields':FORBIDDEN_FRONTEND_FIELDS},PARAM_SPEC={'container':a0_0x8f7365(0xdc),'keyConvention':a0_0x8f7365(0xa5),'perEntryFields':[{'name':a0_0x8f7365(0xe1),'required':!![],'allowedValues':ALLOWED_PARAM_TYPES,'description':'Param\x20data\x20type.\x20Validates\x20request\x20body\x20and\x20shapes\x20runtime\x20parameter\x20binding.'},{'name':a0_0x8f7365(0xa3),'required':![],'type':'boolean','default':![],'description':a0_0x8f7365(0xa0)},{'name':'default','required':![],'type':a0_0x8f7365(0xd7),'description':'Default\x20value\x20applied\x20when\x20the\x20request\x20omits\x20this\x20param.\x20Validator\x20does\x20NOT\x20strictly\x20type-check\x20default;\x20runtime\x20is\x20responsible\x20for\x20compatibility.'}]},SCALAR_COLLAPSE_RULES=[{'appliesTo':'widget.query\x20(singular)','rule':'Always\x20wrap\x20as\x20{\x20items:\x20[...]\x20}\x20regardless\x20of\x20SQL\x20result\x20shape.','exampleSqlShape':'any\x20(1\x20row\x20×\x201\x20col,\x20N\x20rows\x20×\x20M\x20cols,\x20etc.)','exampleResponse':'\x22shopping_categories\x22:\x20{\x20\x22items\x22:\x20[{\x20\x22name\x22:\x20\x22Lands\x22\x20},\x20{\x20\x22name\x22:\x20\x22Houses\x22\x20}]\x20}'},{'appliesTo':'widget.queries.<key>\x20with\x20SQL\x20returning\x201\x20row\x20×\x201\x20column','rule':a0_0x8f7365(0xd4),'exampleSqlShape':a0_0x8f7365(0xef),'exampleResponse':'\x22value\x22:\x20\x2269700\x22'},{'appliesTo':a0_0x8f7365(0xc7),'rule':a0_0x8f7365(0xb8),'exampleSqlShape':a0_0x8f7365(0x9f),'exampleResponse':'\x22trend\x22:\x20{\x20\x22direction\x22:\x20\x22up\x22,\x20\x22pct\x22:\x20\x222.2\x22\x20}'},{'appliesTo':a0_0x8f7365(0xc2),'rule':'Return\x20as\x20array\x20of\x20objects\x20(no\x20collapse).','exampleSqlShape':'N\x20rows\x20×\x20M\x20cols','exampleResponse':'\x22items\x22:\x20[{\x20\x22label\x22:\x20\x22Shoes\x22,\x20\x22value\x22:\x20\x227660\x22\x20},\x20...]'}],COMMON_WIDGET_PATTERNS=[{'id':'metric_donut_breakdown','name':'Metric\x20+\x20Donut\x20Breakdown','useCase':'Headline\x20metric\x20with\x20trend\x20chip\x20and\x20breakdown\x20across\x20categories.\x20Suitable\x20for\x20widgets\x20like\x20\x27Expected\x20Earnings\x27\x20that\x20show\x20total\x20value,\x20percentage\x20change,\x20and\x20per-category\x20contribution.','payloadShape':{'id':'<widget_id>','queries':{'value':a0_0x8f7365(0xde),'trend':'file:query/<path>/trend.sql','items':a0_0x8f7365(0xbe)}},'sqlShapesPerKey':[{'key':'value','shape':'1\x20row\x20×\x201\x20column','outputColumns':[a0_0x8f7365(0xc4)],'collapseRule':'scalar\x20primitive'},{'key':a0_0x8f7365(0xec),'shape':'1\x20row\x20×\x202\x20columns','outputColumns':[a0_0x8f7365(0xa6),a0_0x8f7365(0x9e)],'collapseRule':'object'},{'key':'items','shape':'N\x20rows\x20×\x202\x20columns','outputColumns':[a0_0x8f7365(0xed),a0_0x8f7365(0xc4)],'collapseRule':'array\x20of\x20objects'}],'responseShape':{'value':a0_0x8f7365(0xb5),'trend':'{\x20\x22direction\x22:\x20\x22up\x22,\x20\x22pct\x22:\x20\x222.2\x22\x20}','items':a0_0x8f7365(0xd9)},'referenceWidgetId':a0_0x8f7365(0xac),'socNotes':a0_0x8f7365(0xaf)},{'id':'metric_sparkline','name':a0_0x8f7365(0xc6),'useCase':a0_0x8f7365(0xd1),'payloadShape':{'id':'<widget_id>','queries':{'value':a0_0x8f7365(0xde),'trend':'file:query/<path>/trend.sql','points':a0_0x8f7365(0xc5)}},'sqlShapesPerKey':[{'key':'value','shape':'1\x20row\x20×\x201\x20column','outputColumns':['value'],'collapseRule':a0_0x8f7365(0xc0)},{'key':a0_0x8f7365(0xec),'shape':a0_0x8f7365(0xd2),'outputColumns':[a0_0x8f7365(0xa6),a0_0x8f7365(0x9e)],'collapseRule':a0_0x8f7365(0xf0)},{'key':a0_0x8f7365(0xae),'shape':'N\x20rows\x20×\x202\x20columns','outputColumns':[a0_0x8f7365(0xa7),'value'],'collapseRule':'array\x20of\x20objects'}],'responseShape':{'value':a0_0x8f7365(0xf1),'trend':'{\x20\x22direction\x22:\x20\x22up\x22,\x20\x22pct\x22:\x20\x222.6\x22\x20}','points':'[{\x20\x22period\x22:\x20\x222026-04-24\x22,\x20\x22value\x22:\x20\x221850\x22\x20},\x20...\x20]'},'referenceWidgetId':a0_0x8f7365(0x9c),'socNotes':'Sparkline\x20libraries\x20(ApexCharts,\x20Chartist,\x20etc.)\x20typically\x20need\x20a\x20plain\x20number\x20array.\x20Frontend\x20maps\x20points.map(p\x20=>\x20p.value).\x20The\x20\x27period\x27\x20field\x20stays\x20for\x20tooltip\x20and\x20gap-resilience\x20against\x20missing\x20days.\x20Use\x20generate_series\x20in\x20SQL\x20to\x20ensure\x20consistent\x20row\x20count\x20even\x20for\x20days\x20with\x20no\x20transactions.'},{'id':a0_0x8f7365(0xe5),'name':a0_0x8f7365(0xbb),'useCase':a0_0x8f7365(0xca),'payloadShape':{'id':'<widget_id>','queries':{'value':'file:query/<path>/current.sql','trend':a0_0x8f7365(0xa2),'target':'file:query/<path>/target.sql'}},'sqlShapesPerKey':[{'key':'value','shape':a0_0x8f7365(0xdd),'outputColumns':['value\x20(or\x20current)'],'collapseRule':'scalar\x20primitive'},{'key':a0_0x8f7365(0xec),'shape':'1\x20row\x20×\x202\x20columns','outputColumns':['direction','pct'],'collapseRule':'object'},{'key':a0_0x8f7365(0xf6),'shape':'1\x20row\x20×\x201\x20column','outputColumns':['target'],'collapseRule':'scalar\x20primitive'}],'responseShape':{'value':'\x221836\x22','trend':'{\x20\x22direction\x22:\x20\x22down\x22,\x20\x22pct\x22:\x20\x222.2\x22\x20}','target':'\x222884\x22'},'referenceWidgetId':a0_0x8f7365(0xe7),'socNotes':'Frontend\x20computes\x20to_goal\x20=\x20target\x20-\x20value\x20and\x20pct\x20=\x20round(value\x20/\x20target\x20*\x20100)\x20for\x20the\x20progress\x20bar.\x20Visual\x20width\x20is\x20presentational\x20and\x20must\x20NOT\x20live\x20in\x20the\x20backend\x20payload.\x20If\x20progress\x20involves\x20complex\x20business\x20rules\x20(e.g.\x20exclude\x20weekends,\x20prorated\x20workdays),\x20use\x20a\x20single\x20multi-column\x20query\x20so\x20\x27pct\x27\x20is\x20a\x20stable\x20business\x20fact\x20rather\x20than\x20visual\x20width.'}],NAMING_CONVENTION={'dashboardName':{'constraint':'MUST\x20start\x20with\x20\x27dash-\x27\x20prefix','minLength':0x6,'maxLength':0x32,'regex':'^dash-[a-zA-Z0-9_-]+$','examples':['dash-sales',a0_0x8f7365(0xa8),'dash-author-stats'],'rationale':'The\x20prefix\x20becomes\x20part\x20of\x20the\x20URL\x20segment.\x20The\x20reserved\x20scheme\x20keeps\x20dashboard\x20endpoints\x20visually\x20distinct\x20from\x20CRUD\x20endpoints\x20in\x20the\x20URL\x20space\x20and\x20allows\x20future\x20routing\x20differentiation.'}},URL_PATTERN={'method':'POST','path':'/api/{project}/{name}/dashboard','exampleFull':a0_0x8f7365(0xcc),'requestBodyShape':{'params':'object\x20—\x20values\x20for\x20declared\x20params\x20(validated\x20against\x20params\x20contract;\x20missing\x20required\x20→\x20400,\x20type\x20mismatch\x20→\x20400)','widgets':a0_0x8f7365(0xc3)},'responseShape':{'envelope':a0_0x8f7365(0xd8),'perWidgetResponse':'Determined\x20by\x20scalarCollapseRules.\x20Failed\x20widgets\x20produce\x20{\x20error:\x20\x27...\x27\x20}\x20block\x20with\x20top-level\x20success\x20still\x20true\x20(one\x20widget\x20failure\x20does\x20NOT\x20fail\x20the\x20dashboard).'}},FILE_REFERENCE_CONVENTION={'format':a0_0x8f7365(0xc8),'pathRelativeTo':'payload\x20JSON\x20file\x20location','fileExtensionPolicy':'free;\x20.sql\x20recommended\x20for\x20editor\x20highlight','resolvedAt':a0_0x8f7365(0xb2),'embedStrategy':'SQL\x20file\x20content\x20is\x20embedded\x20as\x20JavaScript\x20template\x20literal\x20inside\x20the\x20generated\x20module\x20file.\x20Runtime\x20performs\x20zero\x20disk\x20I/O\x20per\x20request\x20—\x20all\x20SQL\x20is\x20in\x20memory\x20after\x20module\x20load.','implication':'Updating\x20an\x20SQL\x20file\x20requires\x20regenerating\x20the\x20dashboard\x20module\x20(\x27codegen_create_dashboard\x27)\x20for\x20changes\x20to\x20take\x20effect.'},PLACEHOLDER_CONVENTION={'format':':paramName','regex':'(?<!:):([a-zA-Z_][a-zA-Z0-9_]*)','regexNotes':a0_0x8f7365(0xcf),'scanScope':'All\x20widget\x20SQL\x20—\x20both\x20\x27query\x27\x20(singular)\x20and\x20every\x20\x27queries.<key>\x27.','constraint':'Every\x20placeholder\x20used\x20in\x20SQL\x20MUST\x20be\x20declared\x20in\x20\x27params\x27.\x20Validator\x20throws\x20Error\x20with\x20message\x20format:\x20\x22Widget\x20\x27<id>\x27\x20query\x20\x27<label>\x27\x20uses\x20undeclared\x20placeholder\x20\x27:<token>\x27\x20(declare\x20in\x20\x27params\x27)\x22.','exampleSql':a0_0x8f7365(0xc1),'exampleParamDeclaration':'{\x20\x22params\x22:\x20{\x20\x22year\x22:\x20{\x20\x22type\x22:\x20\x22number\x22,\x20\x22required\x22:\x20true\x20}\x20}\x20}'},CACHE_SPEC={'container':'top-level\x20\x27cache\x27\x20object','optional':!![],'rationale':a0_0x8f7365(0xf2),'fields':[{'name':a0_0x8f7365(0xa1),'type':a0_0x8f7365(0xe9),'required':!![],'description':a0_0x8f7365(0xe4)},{'name':'ttl','type':'number','required':![],'constraint':'>=\x200\x20(seconds)','default':a0_0x8f7365(0xbf),'description':a0_0x8f7365(0xb6)},{'name':a0_0x8f7365(0xba),'type':'array<string>','required':![],'default':'[]','description':a0_0x8f7365(0xb1)}],'validation':{'sqlCrossReference':'When\x20cache.enabled\x20===\x20true\x20and\x20invalidates\x20is\x20non-empty:\x20validator\x20extracts\x20table\x20candidates\x20from\x20widget\x20SQL\x20(regex\x20FROM/JOIN),\x20cross-references\x20with\x20metadata/{project}.json\x20(endpoints[*].tableName\x20where\x20type\x20===\x20\x22module\x22),\x20and\x20asserts\x20equality\x20of\x20expected\x20vs\x20declared\x20sets.\x20Mismatches\x20are\x20reported\x20per\x20category\x20(missing,\x20extra,\x20unmatched).','errorOn':['Table\x20appears\x20in\x20SQL\x20AND\x20in\x20metadata\x20project,\x20but\x20missing\x20from\x20invalidates\x20(cache\x20stale\x20risk)','Table\x20declared\x20in\x20invalidates,\x20but\x20not\x20detected\x20in\x20any\x20widget\x20SQL\x20(typo\x20or\x20dead\x20entry)'],'warningOn':['Table\x20detected\x20in\x20SQL,\x20but\x20not\x20registered\x20as\x20CRUD\x20endpoint\x20in\x20metadata\x20project\x20(likely\x20a\x20view,\x20CTE\x20alias,\x20or\x20cross-project\x20table\x20—\x20cascade\x20will\x20not\x20fire)']}},DOCUMENTATION_URL='https://restforge.dev/docs/server/query-data/dashboard',DASHBOARD_CATALOG={'schemaVersion':'1.0','source':a0_0x8f7365(0xd5),'summary':{'totalAllowedTopLevelFields':PAYLOAD_SHAPE[a0_0x8f7365(0xf3)]['length'],'totalForbiddenFrontendFields':FORBIDDEN_FRONTEND_FIELDS[a0_0x8f7365(0xa9)],'totalParamTypes':ALLOWED_PARAM_TYPES[a0_0x8f7365(0xa9)],'totalScalarCollapseRules':SCALAR_COLLAPSE_RULES[a0_0x8f7365(0xa9)],'totalCommonWidgetPatterns':COMMON_WIDGET_PATTERNS[a0_0x8f7365(0xa9)]},'payloadShape':PAYLOAD_SHAPE,'widgetSpec':WIDGET_SPEC,'paramSpec':PARAM_SPEC,'scalarCollapseRules':SCALAR_COLLAPSE_RULES,'commonWidgetPatterns':COMMON_WIDGET_PATTERNS,'namingConvention':NAMING_CONVENTION,'urlPattern':URL_PATTERN,'fileReferenceConvention':FILE_REFERENCE_CONVENTION,'placeholderConvention':PLACEHOLDER_CONVENTION,'cacheSpec':CACHE_SPEC,'documentationUrl':DOCUMENTATION_URL};module[a0_0x8f7365(0xc9)]={'DASHBOARD_CATALOG':DASHBOARD_CATALOG};
+function a0_0x3ae6(_0x1ea3cd,_0x5cd116){_0x1ea3cd=_0x1ea3cd-0x1ec;const _0x90e912=a0_0x90e9();let _0x3ae674=_0x90e912[_0x1ea3cd];if(a0_0x3ae6['zodufx']===undefined){var _0x25d31d=function(_0x25009b){const _0x2bffb8='abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789+/=';let _0x1f8166='',_0x5f199f='';for(let _0x11caea=0x0,_0x8affc8,_0x52b897,_0x4214fc=0x0;_0x52b897=_0x25009b['charAt'](_0x4214fc++);~_0x52b897&&(_0x8affc8=_0x11caea%0x4?_0x8affc8*0x40+_0x52b897:_0x52b897,_0x11caea++%0x4)?_0x1f8166+=String['fromCharCode'](0xff&_0x8affc8>>(-0x2*_0x11caea&0x6)):0x0){_0x52b897=_0x2bffb8['indexOf'](_0x52b897);}for(let _0x4e3115=0x0,_0x56589f=_0x1f8166['length'];_0x4e3115<_0x56589f;_0x4e3115++){_0x5f199f+='%'+('00'+_0x1f8166['charCodeAt'](_0x4e3115)['toString'](0x10))['slice'](-0x2);}return decodeURIComponent(_0x5f199f);};a0_0x3ae6['ShXTQz']=_0x25d31d,a0_0x3ae6['RGZEDa']={},a0_0x3ae6['zodufx']=!![];}const _0x24ae72=_0x90e912[0x0],_0x1d2861=_0x1ea3cd+_0x24ae72,_0x153909=a0_0x3ae6['RGZEDa'][_0x1d2861];return!_0x153909?(_0x3ae674=a0_0x3ae6['ShXTQz'](_0x3ae674),a0_0x3ae6['RGZEDa'][_0x1d2861]=_0x3ae674):_0x3ae674=_0x153909,_0x3ae674;}const a0_0x464bb1=a0_0x3ae6;(function(_0x10a8f1,_0x45039d){const _0x404615=a0_0x3ae6,_0x50c3cc=_0x10a8f1();while(!![]){try{const _0x103dc2=-parseInt(_0x404615(0x215))/0x1+parseInt(_0x404615(0x1f2))/0x2*(-parseInt(_0x404615(0x23f))/0x3)+parseInt(_0x404615(0x214))/0x4+parseInt(_0x404615(0x1fc))/0x5+-parseInt(_0x404615(0x244))/0x6*(-parseInt(_0x404615(0x20e))/0x7)+parseInt(_0x404615(0x21c))/0x8+-parseInt(_0x404615(0x204))/0x9*(parseInt(_0x404615(0x212))/0xa);if(_0x103dc2===_0x45039d)break;else _0x50c3cc['push'](_0x50c3cc['shift']());}catch(_0x25f463){_0x50c3cc['push'](_0x50c3cc['shift']());}}}(a0_0x90e9,0xf3865));const FORBIDDEN_FRONTEND_FIELDS=[a0_0x464bb1(0x233),a0_0x464bb1(0x220),'title',a0_0x464bb1(0x20b),'color'],ALLOWED_PARAM_TYPES=['string',a0_0x464bb1(0x229),'boolean',a0_0x464bb1(0x21a)],FRONTEND_CONCERN_REASONS={'widgetType':a0_0x464bb1(0x231),'layout':'Layout\x20is\x20a\x20frontend\x20rendering\x20concern.','title':'UI\x20label\x20is\x20a\x20frontend\x20rendering\x20concern.','subtitle':'UI\x20label\x20is\x20a\x20frontend\x20rendering\x20concern.','color':a0_0x464bb1(0x1f4)},PAYLOAD_SHAPE={'discriminator':{'field':a0_0x464bb1(0x242),'presentMeans':a0_0x464bb1(0x237),'absentMeans':a0_0x464bb1(0x232),'conflictsWith':a0_0x464bb1(0x24c),'conflictRationale':'A\x20payload\x20with\x20both\x20\x27widgets\x27\x20and\x20\x27tableName\x27\x20is\x20rejected\x20by\x20DashboardValidator.\x20Pick\x20one\x20shape.'},'topLevelAllowed':[{'name':'widgets','type':a0_0x464bb1(0x20c),'required':!![],'minItems':0x1,'description':'List\x20of\x20widget\x20definitions.\x20Order\x20is\x20informational\x20only\x20(response\x20keys\x20are\x20by\x20widget\x20id,\x20not\x20array\x20index).'},{'name':a0_0x464bb1(0x236),'type':a0_0x464bb1(0x1fa),'required':![],'description':a0_0x464bb1(0x224)},{'name':'cache','type':a0_0x464bb1(0x1fa),'required':![],'description':a0_0x464bb1(0x22b)}],'topLevelForbidden':[{'name':'tableName','category':a0_0x464bb1(0x216),'reason':'Reserved\x20for\x20CRUD\x20payloads.\x20A\x20dashboard\x20payload\x20must\x20declare\x20\x27widgets\x27\x20instead.'},...FORBIDDEN_FRONTEND_FIELDS[a0_0x464bb1(0x22f)](_0x1f8166=>({'name':_0x1f8166,'category':'frontend-concern','reason':FRONTEND_CONCERN_REASONS[_0x1f8166]}))]},WIDGET_SPEC={'requiredFields':[{'name':'id','type':a0_0x464bb1(0x1f5),'constraint':a0_0x464bb1(0x210),'description':'Widget\x20identifier;\x20used\x20as\x20the\x20response\x20key\x20in\x20the\x20dashboard\x20envelope.'}],'exclusiveQueryFields':{'rule':a0_0x464bb1(0x1f3),'options':[{'name':a0_0x464bb1(0x248),'type':a0_0x464bb1(0x1f5),'format':a0_0x464bb1(0x24b),'description':a0_0x464bb1(0x235),'responseShape':a0_0x464bb1(0x1f1)},{'name':a0_0x464bb1(0x22c),'type':'object','format':a0_0x464bb1(0x239),'minKeys':0x1,'description':a0_0x464bb1(0x247),'responseShape':a0_0x464bb1(0x1f6)}]},'forbiddenFields':FORBIDDEN_FRONTEND_FIELDS},PARAM_SPEC={'container':a0_0x464bb1(0x217),'keyConvention':'Param\x20name\x20must\x20match\x20the\x20placeholder\x20regex\x20`[a-zA-Z_][a-zA-Z0-9_]*`\x20(alphanumeric\x20+\x20underscore,\x20must\x20start\x20with\x20letter\x20or\x20underscore).','perEntryFields':[{'name':a0_0x464bb1(0x206),'required':!![],'allowedValues':ALLOWED_PARAM_TYPES,'description':'Param\x20data\x20type.\x20Validates\x20request\x20body\x20and\x20shapes\x20runtime\x20parameter\x20binding.'},{'name':'required','required':![],'type':'boolean','default':![],'description':'When\x20true,\x20the\x20request\x20body\x20MUST\x20include\x20this\x20param\x20(otherwise\x20400).'},{'name':'default','required':![],'type':'any\x20(must\x20be\x20compatible\x20with\x20declared\x20\x27type\x27)','description':a0_0x464bb1(0x228)}]},SCALAR_COLLAPSE_RULES=[{'appliesTo':'widget.query\x20(singular)','rule':'Always\x20wrap\x20as\x20{\x20items:\x20[...]\x20}\x20regardless\x20of\x20SQL\x20result\x20shape.','exampleSqlShape':a0_0x464bb1(0x21e),'exampleResponse':'\x22shopping_categories\x22:\x20{\x20\x22items\x22:\x20[{\x20\x22name\x22:\x20\x22Lands\x22\x20},\x20{\x20\x22name\x22:\x20\x22Houses\x22\x20}]\x20}'},{'appliesTo':a0_0x464bb1(0x20d),'rule':a0_0x464bb1(0x243),'exampleSqlShape':a0_0x464bb1(0x249),'exampleResponse':'\x22value\x22:\x20\x2269700\x22'},{'appliesTo':a0_0x464bb1(0x203),'rule':'Collapse\x20to\x20object\x20whose\x20keys\x20are\x20SQL\x20column\x20names\x20(lowercased).','exampleSqlShape':'1\x20row\x20×\x202\x20cols,\x20output\x20columns\x20\x27direction\x27,\x20\x27pct\x27','exampleResponse':a0_0x464bb1(0x241)},{'appliesTo':a0_0x464bb1(0x1f9),'rule':a0_0x464bb1(0x21b),'exampleSqlShape':'N\x20rows\x20×\x20M\x20cols','exampleResponse':'\x22items\x22:\x20[{\x20\x22label\x22:\x20\x22Shoes\x22,\x20\x22value\x22:\x20\x227660\x22\x20},\x20...]'}],COMMON_WIDGET_PATTERNS=[{'id':'metric_donut_breakdown','name':a0_0x464bb1(0x22a),'useCase':'Headline\x20metric\x20with\x20trend\x20chip\x20and\x20breakdown\x20across\x20categories.\x20Suitable\x20for\x20widgets\x20like\x20\x27Expected\x20Earnings\x27\x20that\x20show\x20total\x20value,\x20percentage\x20change,\x20and\x20per-category\x20contribution.','payloadShape':{'id':'<widget_id>','queries':{'value':'file:query/<path>/value.sql','trend':a0_0x464bb1(0x223),'items':'file:query/<path>/breakdown.sql'}},'sqlShapesPerKey':[{'key':a0_0x464bb1(0x20f),'shape':'1\x20row\x20×\x201\x20column','outputColumns':['value'],'collapseRule':'scalar\x20primitive'},{'key':'trend','shape':'1\x20row\x20×\x202\x20columns','outputColumns':['direction','pct'],'collapseRule':a0_0x464bb1(0x1fa)},{'key':'items','shape':'N\x20rows\x20×\x202\x20columns','outputColumns':[a0_0x464bb1(0x230),'value'],'collapseRule':a0_0x464bb1(0x218)}],'responseShape':{'value':'\x2269700\x22','trend':'{\x20\x22direction\x22:\x20\x22up\x22,\x20\x22pct\x22:\x20\x222.2\x22\x20}','items':'[{\x20\x22label\x22:\x20\x22Shoes\x22,\x20\x22value\x22:\x20\x227660\x22\x20},\x20{\x20\x22label\x22:\x20\x22Gaming\x22,\x20\x22value\x22:\x20\x222820\x22\x20},\x20{\x20\x22label\x22:\x20\x22Others\x22,\x20\x22value\x22:\x20\x2245257\x22\x20}]'},'referenceWidgetId':a0_0x464bb1(0x200),'socNotes':'Frontend\x20determines\x20donut/pie\x20variant,\x20color\x20per\x20category,\x20and\x20label\x20order.\x20If\x20per-category\x20percentage\x20is\x20needed\x20for\x20the\x20donut\x20arc,\x20frontend\x20computes\x20it\x20from\x20items[i].value\x20/\x20sum(items[*].value).\x20No\x20need\x20to\x20send\x20\x27pct\x27\x20from\x20backend\x20unless\x20the\x20figure\x20is\x20a\x20stable\x20business\x20calculation\x20independent\x20of\x20visual\x20rendering.'},{'id':a0_0x464bb1(0x222),'name':a0_0x464bb1(0x22e),'useCase':a0_0x464bb1(0x246),'payloadShape':{'id':a0_0x464bb1(0x23b),'queries':{'value':'file:query/<path>/value.sql','trend':a0_0x464bb1(0x223),'points':'file:query/<path>/points.sql'}},'sqlShapesPerKey':[{'key':'value','shape':'1\x20row\x20×\x201\x20column','outputColumns':[a0_0x464bb1(0x20f)],'collapseRule':a0_0x464bb1(0x1fe)},{'key':a0_0x464bb1(0x22d),'shape':'1\x20row\x20×\x202\x20columns','outputColumns':[a0_0x464bb1(0x207),a0_0x464bb1(0x1ff)],'collapseRule':'object'},{'key':'points','shape':a0_0x464bb1(0x225),'outputColumns':[a0_0x464bb1(0x1ed),a0_0x464bb1(0x20f)],'collapseRule':'array\x20of\x20objects'}],'responseShape':{'value':'\x222420\x22','trend':a0_0x464bb1(0x234),'points':'[{\x20\x22period\x22:\x20\x222026-04-24\x22,\x20\x22value\x22:\x20\x221850\x22\x20},\x20...\x20]'},'referenceWidgetId':'avg_daily_sales','socNotes':'Sparkline\x20libraries\x20(ApexCharts,\x20Chartist,\x20etc.)\x20typically\x20need\x20a\x20plain\x20number\x20array.\x20Frontend\x20maps\x20points.map(p\x20=>\x20p.value).\x20The\x20\x27period\x27\x20field\x20stays\x20for\x20tooltip\x20and\x20gap-resilience\x20against\x20missing\x20days.\x20Use\x20generate_series\x20in\x20SQL\x20to\x20ensure\x20consistent\x20row\x20count\x20even\x20for\x20days\x20with\x20no\x20transactions.'},{'id':a0_0x464bb1(0x219),'name':'Metric\x20+\x20Progress\x20to\x20Goal','useCase':'Headline\x20metric\x20with\x20trend\x20chip\x20and\x20progress\x20bar\x20against\x20a\x20period\x20target.\x20Suitable\x20for\x20widgets\x20like\x20\x27Orders\x20This\x20Month\x27.','payloadShape':{'id':a0_0x464bb1(0x23b),'queries':{'value':a0_0x464bb1(0x211),'trend':'file:query/<path>/trend.sql','target':a0_0x464bb1(0x23d)}},'sqlShapesPerKey':[{'key':a0_0x464bb1(0x20f),'shape':a0_0x464bb1(0x21d),'outputColumns':[a0_0x464bb1(0x1f0)],'collapseRule':'scalar\x20primitive'},{'key':'trend','shape':a0_0x464bb1(0x1ef),'outputColumns':['direction','pct'],'collapseRule':a0_0x464bb1(0x1fa)},{'key':'target','shape':'1\x20row\x20×\x201\x20column','outputColumns':[a0_0x464bb1(0x1ec)],'collapseRule':a0_0x464bb1(0x1fe)}],'responseShape':{'value':a0_0x464bb1(0x23c),'trend':a0_0x464bb1(0x238),'target':a0_0x464bb1(0x221)},'referenceWidgetId':a0_0x464bb1(0x23a),'socNotes':'Frontend\x20computes\x20to_goal\x20=\x20target\x20-\x20value\x20and\x20pct\x20=\x20round(value\x20/\x20target\x20*\x20100)\x20for\x20the\x20progress\x20bar.\x20Visual\x20width\x20is\x20presentational\x20and\x20must\x20NOT\x20live\x20in\x20the\x20backend\x20payload.\x20If\x20progress\x20involves\x20complex\x20business\x20rules\x20(e.g.\x20exclude\x20weekends,\x20prorated\x20workdays),\x20use\x20a\x20single\x20multi-column\x20query\x20so\x20\x27pct\x27\x20is\x20a\x20stable\x20business\x20fact\x20rather\x20than\x20visual\x20width.'}],NAMING_CONVENTION={'dashboardName':{'constraint':'MUST\x20start\x20with\x20\x27dash-\x27\x20prefix','minLength':0x6,'maxLength':0x32,'regex':'^dash-[a-zA-Z0-9_-]+$','examples':['dash-sales','dash-inbound',a0_0x464bb1(0x1fb)],'rationale':a0_0x464bb1(0x208)}},URL_PATTERN={'method':a0_0x464bb1(0x213),'path':'/api/{project}/{name}/dashboard','exampleFull':'POST\x20/api/mini-inventory/dash-inbound/dashboard','requestBodyShape':{'params':a0_0x464bb1(0x23e),'widgets':'array<string>,\x20optional\x20—\x20subset\x20of\x20widget\x20IDs\x20to\x20execute.\x20Omit\x20to\x20execute\x20all\x20declared\x20widgets.'},'responseShape':{'envelope':'{\x20success:\x20boolean,\x20data:\x20{\x20<widgetId>:\x20<perWidgetResponse>,\x20...\x20}\x20}','perWidgetResponse':'Determined\x20by\x20scalarCollapseRules.\x20Failed\x20widgets\x20produce\x20{\x20error:\x20\x27...\x27\x20}\x20block\x20with\x20top-level\x20success\x20still\x20true\x20(one\x20widget\x20failure\x20does\x20NOT\x20fail\x20the\x20dashboard).'}},FILE_REFERENCE_CONVENTION={'format':'file:relative/path/to/query.sql','pathRelativeTo':a0_0x464bb1(0x205),'fileExtensionPolicy':a0_0x464bb1(0x24a),'resolvedAt':'generation\x20time\x20(NOT\x20runtime)','embedStrategy':a0_0x464bb1(0x227),'implication':a0_0x464bb1(0x201)},PLACEHOLDER_CONVENTION={'format':':paramName','regex':'(?<!:):([a-zA-Z_][a-zA-Z0-9_]*)','regexNotes':a0_0x464bb1(0x240),'scanScope':'All\x20widget\x20SQL\x20—\x20both\x20\x27query\x27\x20(singular)\x20and\x20every\x20\x27queries.<key>\x27.','constraint':'Every\x20placeholder\x20used\x20in\x20SQL\x20MUST\x20be\x20declared\x20in\x20\x27params\x27.\x20Validator\x20throws\x20Error\x20with\x20message\x20format:\x20\x22Widget\x20\x27<id>\x27\x20query\x20\x27<label>\x27\x20uses\x20undeclared\x20placeholder\x20\x27:<token>\x27\x20(declare\x20in\x20\x27params\x27)\x22.','exampleSql':a0_0x464bb1(0x1ee),'exampleParamDeclaration':'{\x20\x22params\x22:\x20{\x20\x22year\x22:\x20{\x20\x22type\x22:\x20\x22number\x22,\x20\x22required\x22:\x20true\x20}\x20}\x20}'},CACHE_SPEC={'container':a0_0x464bb1(0x202),'optional':!![],'rationale':a0_0x464bb1(0x1f8),'fields':[{'name':'enabled','type':a0_0x464bb1(0x20a),'required':!![],'description':'Toggle\x20cache\x20feature\x20for\x20this\x20dashboard.'},{'name':a0_0x464bb1(0x1fd),'type':a0_0x464bb1(0x229),'required':![],'constraint':'>=\x200\x20(seconds)','default':'inherits\x20CACHE_TTL\x20env','description':'Time-to-live\x20in\x20seconds.\x200\x20effectively\x20disables\x20cache\x20for\x20this\x20entry.'},{'name':a0_0x464bb1(0x226),'type':'array<string>','required':![],'default':'[]','description':'List\x20of\x20CRUD\x20table\x20names\x20that,\x20when\x20written,\x20will\x20trigger\x20invalidation\x20of\x20this\x20dashboard\x20cache.'}],'validation':{'sqlCrossReference':'When\x20cache.enabled\x20===\x20true\x20and\x20invalidates\x20is\x20non-empty:\x20validator\x20extracts\x20table\x20candidates\x20from\x20widget\x20SQL\x20(regex\x20FROM/JOIN),\x20cross-references\x20with\x20metadata/{project}.json\x20(endpoints[*].tableName\x20where\x20type\x20===\x20\x22module\x22),\x20and\x20asserts\x20equality\x20of\x20expected\x20vs\x20declared\x20sets.\x20Mismatches\x20are\x20reported\x20per\x20category\x20(missing,\x20extra,\x20unmatched).','errorOn':['Table\x20appears\x20in\x20SQL\x20AND\x20in\x20metadata\x20project,\x20but\x20missing\x20from\x20invalidates\x20(cache\x20stale\x20risk)','Table\x20declared\x20in\x20invalidates,\x20but\x20not\x20detected\x20in\x20any\x20widget\x20SQL\x20(typo\x20or\x20dead\x20entry)'],'warningOn':[a0_0x464bb1(0x209)]}},DOCUMENTATION_URL='https://restforge.dev/docs/server/query-data/dashboard',DASHBOARD_CATALOG={'schemaVersion':'1.0','source':a0_0x464bb1(0x21f),'summary':{'totalAllowedTopLevelFields':PAYLOAD_SHAPE['topLevelAllowed']['length'],'totalForbiddenFrontendFields':FORBIDDEN_FRONTEND_FIELDS[a0_0x464bb1(0x1f7)],'totalParamTypes':ALLOWED_PARAM_TYPES[a0_0x464bb1(0x1f7)],'totalScalarCollapseRules':SCALAR_COLLAPSE_RULES['length'],'totalCommonWidgetPatterns':COMMON_WIDGET_PATTERNS['length']},'payloadShape':PAYLOAD_SHAPE,'widgetSpec':WIDGET_SPEC,'paramSpec':PARAM_SPEC,'scalarCollapseRules':SCALAR_COLLAPSE_RULES,'commonWidgetPatterns':COMMON_WIDGET_PATTERNS,'namingConvention':NAMING_CONVENTION,'urlPattern':URL_PATTERN,'fileReferenceConvention':FILE_REFERENCE_CONVENTION,'placeholderConvention':PLACEHOLDER_CONVENTION,'cacheSpec':CACHE_SPEC,'documentationUrl':DOCUMENTATION_URL};function a0_0x90e9(){const _0x5234f0=['D2LKz2v0CW','q29SBgfWC2uGDg8GC2nHBgfYihbYAw1PDgL2zsaODgHLihzHBhvLig9MihrOzsbZAw5NBguGy29SDw1Uks4','mtHJu3jhvNq','zxHWB3j0CW','sgvHzgXPBMuGBwv0CMLJihDPDgGGDhjLBMqGy2HPCcbHBMqGC3bHCMTSAw5Lig1PBMKTy2HHCNqGzM9YihnOB3j0ihDPBMrVD3mGkdCGzgf5CYWGmtiGBw9UDgHZlcbLDgmUks4Gu3vPDgfIBguGzM9YihDPzgDLDhmGBgLRzsaNqxzLCMfNzsbeywLSEsbtywXLCYCU','txvSDgKTu1fmihDPzgDLDc4GrwfJAcbRzxKGyMvJB21LCYbHigTLEsbPBIb0AguGCMvZCg9UC2uGB2jQzwn0lG','CxvLCNK','msbYB3CGW5CGmsbJB2WSig91Dhb1DcbJB2X1Bw4Gj3zHBhvLjW','zNjLztSGlNnXBcbYzwnVBw1LBMrLzcbMB3iGzwrPDg9YigHPz2HSAwDODa','zMLSztPYzwXHDgL2zs9WyxrOl3rVl3f1zxj5lNnXBa','DgfIBgvoyw1L','DgfYz2v0','CgvYAw9K','u0vmrunuicOGrLjptsbZDg9JA19PBMjVDw5KifDirvjfievyvfjbq1qOwuvbuIbguK9nigLUyM91BMrFzgf0zsKGpsa6EwvHCG','msbYB3CGW5CGmIbJB2X1Bw5Z','DMfSDwuGkg9Yign1CNjLBNqP','qwX3yxLZihSGAxrLBxm6ifSUlI5Dih0GCMvNyxjKBgvZCYbVzIbtuuWGCMvZDwX0ihnOyxbLlG','mtyZmtG1ofPyBwfvCq','qsb3AwrNzxqGtvvtvcbKzwnSyxjLigv4ywn0BhKGB25Lig9MoIaNCxvLCNKNie9sicDXDwvYAwvZjY4GqM90AcbVCIbUzwL0AgvYigLZihjLAMvJDgvKlG','vMLZDwfSignVBg9YigLZigeGzNjVBNrLBMqGCMvUzgvYAw5NignVBMnLCM4U','C3rYAw5N','ugvYlwTLEsbIyxnLzcbVBIbZy2fSyxjdB2XSyxbZzvj1BgvZigjLBg93lG','BgvUz3rO','rgfZAgjVyxjKigvUzhbVAw50ig1HEsbVChqTAw4GDg8GuMvKAxmTyMfZzwqGy2fJAguUifbHDhrLCM4GzM9SBg93CYbWCM9JzxnZB3iGy2fJAguGkhnLzsbMzwf0lwnHy2HLlM1Kks4Gq2fJAguGC2nVCguGAxmGDgHLigz1BgWGCMvZCg9UC2uGzw52zwXVCgu7ig9UzsbJywnOzsbLBNrYEsbWzxiGkhbHCMfTCYaRihDPzgDLDhnBxsbZDwjZzxqPignVBwjPBMf0Aw9UlG','D2LKz2v0lNf1zxjPzxmUpgTLEt4GD2L0AcbtuuWGCMv0DxjUAw5Nie4GCM93CW','B2jQzwn0','zgfZAc1HDxrOB3iTC3rHDhm','mZG0oda1mePZr2zcra','DhrS','C2nHBgfYihbYAw1PDgL2zq','Cgn0','zxHWzwn0zwrFzwfYBMLUz3m','vxbKyxrPBMCGyw4Gu1fmigzPBguGCMvXDwLYzxmGCMvNzw5LCMf0Aw5NihrOzsbKyxnOyM9HCMqGBw9KDwXLicGNy29KzwDLBL9JCMvHDgvFzgfZAgjVyxjKjYKGzM9YignOyw5NzxmGDg8GDgfRzsbLzMzLy3qU','Dg9WlwXLDMvSicDJywnOzsCGB2jQzwn0','D2LKz2v0lNf1zxjPzxmUpgTLEt4GD2L0AcbtuuWGCMv0DxjUAw5NideGCM93imoxig11BhrPCgXLignVBhvTBNm','ntyYmdq4mLPVuwXjzW','Cgf5Bg9Hzcbku09oigzPBguGBg9JyxrPB24','DhLWzq','zgLYzwn0Aw9U','vgHLihbYzwzPEcbIzwnVBwvZihbHCNqGB2yGDgHLifvstcbZzwDTzw50lIbuAguGCMvZzxj2zwqGC2nOzw1LigTLzxbZigrHC2HIB2fYzcbLBMrWB2LUDhmGDMLZDwfSBhKGzgLZDgLUy3qGzNjVBsbduLveigvUzhbVAw50CYbPBIb0AguGvvjmihnWywnLigfUzcbHBgXVD3mGzNv0DxjLihjVDxrPBMCGzgLMzMvYzw50Awf0Aw9UlG','vgfIBguGzgv0zwn0zwqGAw4Gu1fmlcbIDxqGBM90ihjLz2LZDgvYzwqGyxmGq1jvrcbLBMrWB2LUDcbPBIbTzxrHzgf0ysbWCM9Qzwn0icHSAwTLBhKGysb2Awv3lcbdveuGywXPyxmSig9YignYB3nZlxbYB2PLy3qGDgfIBguG4OcuignHC2nHzguGD2LSBcbUB3qGzMLYzsK','yM9VBgvHBG','C3vIDgL0Bgu','yxjYyxK','D2LKz2v0lNf1zxjPzxmUpgTLEt4GD2L0AcbtuuWGCMv0DxjUAw5NideGCM93imoxideGy29SDw1U','mJK3odaZmxHNuLjbvG','DMfSDwu','BM9UlwvTChr5lcb1BMLXDwuGywnYB3nZihDPzgDLDhmGAw4GDgHLihnHBwuGCgf5Bg9Hza','zMLSztPXDwvYEs88Cgf0Ad4Vy3vYCMvUDc5ZCwW','mJbevM1vz00','ue9tva','ntG2mZi1mMr3v1zQvW','mti1mdG4ne1guvn6uq','C2HHCguTy29UzMXPy3q','Dg9WlwXLDMvSicDWyxjHBxmNig9IAMvJDa','yxjYyxKGB2yGB2jQzwn0CW','Bwv0CMLJx3bYB2DYzxnZx3rVx2DVywW','zgf0zq','uMv0DxjUigfZigfYCMf5ig9Mig9IAMvJDhmGkg5VignVBgXHChnLks4','mti5mZK5ndroz2PQBe8','msbYB3CGW5CGmsbJB2X1Bw4','yw55icGXihjVDYddLYaXignVBcWGtIbYB3DZimoxie0Gy29SCYWGzxrJlIK','zgfZAgjVyxjKlwnHDgfSB2C','Bgf5B3v0','iJi4odqI','Bwv0CMLJx3nWyxjRBgLUzq','zMLSztPXDwvYEs88Cgf0Ad4VDhjLBMqUC3fS','ugfYyw1LDgvYignVBNrYywn0igzVCIb0AguGzgfZAgjVyxjKlIbfywnOigTLEsbPCYbHihbHCMfTig5HBwu7ihzHBhvLCYbKzxnJCMLIzsb0ExbLl3jLCxvPCMvKl2rLzMf1BhqUifbSywnLAg9SzgvYCYbPBNnPzguGD2LKz2v0ifnrtcbTDxn0ihjLzMvYzw5JzsbKzwnSyxjLzcbWyxjHBsbUyw1LCY4','tIbYB3DZimoxidiGy29SDw1UCW','Aw52ywXPzgf0zxm','u1fmigzPBguGy29UDgvUDcbPCYbLBwjLzgrLzcbHCYbkyxzHu2nYAxb0ihrLBxbSyxrLigXPDgvYywWGAw5ZAwrLihrOzsbNzw5LCMf0zwqGBw9KDwXLigzPBguUifj1BNrPBwuGCgvYzM9YBxmGEMvYBYbKAxnRieKVtYbWzxiGCMvXDwvZDcdIGjqGywXSifnrtcbPCYbPBIbTzw1VCNKGywz0zxiGBw9KDwXLigXVywqU','rgvMyxvSDcb2ywX1zsbHChbSAwvKihDOzw4GDgHLihjLCxvLC3qGB21PDhmGDgHPCYbWyxjHBs4GvMfSAwrHDg9YigrVzxmGtK9uihn0CMLJDgX5ihr5CguTy2HLy2SGzgvMyxvSDdSGCNvUDgLTzsbPCYbYzxnWB25ZAwjSzsbMB3iGy29TCgf0AwjPBgL0Es4','BNvTyMvY','twv0CMLJicSGrg9UDxqGqNjLywTKB3DU','t3b0Aw9UywWGy2fJAguGy29UzMLNDxjHDgLVBI4Gu2vLignHy2HLu3bLyYbMB3iGzgv0ywLSCY4','CxvLCMLLCW','DhjLBMq','twv0CMLJicSGu3bHCMTSAw5L','BwfW','BgfIzwW','vMLZDwfSihzHCMLHBNqGkgrVBNv0lcbIyxiSihbPzsWGyxjLysKGAxmGysbMCM9UDgvUzcbYzw5KzxjPBMCGy29Uy2vYBIaOC2vWyxjHDgLVBIbVzIbJB25JzxjUCYKU','tM90igeGzgfZAgjVyxjKihbHEwXVywqGkgXPA2vSEsbduLveihDPDgGGDgfIBgvoyw1LlcbVCIbPBNzHBgLKkq','D2LKz2v0vhLWzq','EYaIzgLYzwn0Aw9UiJOGiNvWiIWGiNbJDci6iciYlJyIih0','u2LUz2XLifnrtcbXDwvYEsbMB3iGDgHLihDPzgDLDc4','CgfYyw1Z','zgfZAgjVyxjKihbHEwXVywq','EYaIzgLYzwn0Aw9UiJOGiMrVD24IlcaICgn0iJOGiJiUmIiGFq','A2v54OAszMLSztPYzwXHDgL2zs9WyxrOl3rVl3f1zxj5lNnXBa','B3jKzxjZx3rOAxnFBw9UDgG','phDPzgDLDf9Pzd4','iJe4mZyI','zMLSztPXDwvYEs88Cgf0Ad4VDgfYz2v0lNnXBa','B2jQzwn0iokaLcb2ywX1zxmGzM9YigrLy2XHCMvKihbHCMfTCYaODMfSAwrHDgvKigfNywLUC3qGCgfYyw1ZignVBNrYywn0oYbTAxnZAw5NihjLCxvPCMvKiokgKIa0mdaSihr5CguGBwLZBwf0y2GG4OAsidqWmcK','nNneEeTxva','tMvNyxrPDMuGBg9VA2jLAgLUzcbWCMv2zw50CYbTyxrJAgLUzYaNoJONicHqB3n0z3jLCYbJyxn0ihn5BNrHEcKGyxmGysbWBgfJzwHVBgrLCI4','iNrYzw5KiJOGEYaIzgLYzwn0Aw9UiJOGiNvWiIWGiNbJDci6iciYlJiIih0'];a0_0x90e9=function(){return _0x5234f0;};return a0_0x90e9();}module[a0_0x464bb1(0x245)]={'DASHBOARD_CATALOG':DASHBOARD_CATALOG};