@aifabrix/builder 2.49.2 → 2.51.0

package/lib/commands/resource-type.js

@@ -2,10 +2,7 @@
  * Resource type catalog commands (Controller).
  *
  * Commands:
- * - aifabrix resource-type create
- * - aifabrix resource-type import
- * - aifabrix resource-type get
- * - aifabrix resource-type list
+ * - aifabrix resource-type create|import|export|get|list
  *
  * @fileoverview Resource type CLI commands
  * @author AI Fabrix Team
@@ -21,7 +18,9 @@ const { normalizeControllerUrl, resolveEnvironment } = require('../core/config')
 const { getOrRefreshDeviceToken } = require('../utils/token-manager');
 const {
   readResourceTypeCreateFile,
-  readResourceTypeCatalogFile
+  readResourceTypeCatalogFile,
+  mapResourceTypeApiToFileRow,
+  writeResourceTypeCatalogFile
 } = require('../resolvers/resource-type-file');
 const {
   formatBlockingError,
@@ -41,45 +40,43 @@ const RESOURCE_TYPE_KEY_PATTERN = /^[a-z][a-z0-9-]*$/;
 const RESOURCE_TYPE_HELP_AFTER = `
 
 Examples:
-  $ aifabrix resource-type create --key customer --display-name "Customer"
+  $ aifabrix resource-type create --key customer --display-name "Customer" --domain sales
   $ aifabrix resource-type get customer
   $ aifabrix resource-type list --search customer
+  $ aifabrix resource-type export --file ./resource-types-export.json
 
 Per-command help:  aifabrix resource-type <command> --help
 `;
 
 const RESOURCE_TYPE_IMPORT_HELP_AFTER = `
-
 Examples:
   $ aifabrix resource-type import --file ./baseline-resourcetypes.json
   $ aifabrix resource-type import --file /path/to/catalog.json
+`;
 
+const RESOURCE_TYPE_EXPORT_HELP_AFTER = `
+Examples:
+  $ aifabrix resource-type export --file ./resource-types-export.json
 `;
 
 const RESOURCE_TYPE_CREATE_HELP_AFTER = `
-
 Examples:
-  $ aifabrix resource-type create --key customer --display-name "Customer"
-  $ aifabrix resource-type create --key deal --display-name "Deal" --category business --default-risk-level medium
+  $ aifabrix resource-type create --key customer --display-name "Customer" --domain sales
+  $ aifabrix resource-type create --key deal --display-name "Deal" --category business --default-risk-level medium --domain sales
   $ aifabrix resource-type create --file ./customer.json
-
 `;
 
 const RESOURCE_TYPE_GET_HELP_AFTER = `
-
 Examples:
   $ aifabrix resource-type get customer
   $ aifabrix resource-type get clx1234567890abcdef
-
 `;
 
 const RESOURCE_TYPE_LIST_HELP_AFTER = `
-
 Examples:
   $ aifabrix resource-type list
   $ aifabrix resource-type list --page 1 --page-size 50
   $ aifabrix resource-type list --search customer
-
 `;
 
 /**
@@ -145,10 +142,14 @@ function buildCreatePayload(options) {
   if (options.category) payload.category = options.category;
   if (options.defaultRiskLevel) payload.defaultRiskLevel = options.defaultRiskLevel;
   if (options.status) payload.status = options.status;
+  if (options.domain) payload.domain = options.domain;
   payload.key = requireResourceTypeKey(payload.key);
   if (!payload.displayName) {
     throw new Error('displayName is required (--display-name <name> or in --file).');
   }
+  if (!payload.domain) {
+    throw new Error('domain is required (--domain <domain> or in --file).');
+  }
   return payload;
 }
 
@@ -161,8 +162,62 @@ function unwrapControllerData(response) {
 }
 
 /**
- * @param {import('commander').Command} rt
+ * @param {Object|null|undefined} response
+ * @param {string} label
+ * @returns {void}
+ */
+function assertControllerListSuccess(response, label) {
+  if (response && response.success !== false) {
+    return;
+  }
+  const message =
+    response?.formattedError || response?.error || `Failed to list ${label}`;
+  throw new Error(message);
+}
+
+/**
+ * @param {Object} response
+ * @returns {Object[]}
+ */
+function extractControllerListItems(response) {
+  if (response?.data && Array.isArray(response.data.data)) {
+    return response.data.data;
+  }
+  const unwrapped = unwrapControllerData(response);
+  if (Array.isArray(unwrapped)) {
+    return unwrapped;
+  }
+  if (unwrapped && Array.isArray(unwrapped.data)) {
+    return unwrapped.data;
+  }
+  throw new Error('Unexpected list response from controller');
+}
+
+/**
+ * @param {string} controllerUrl
+ * @param {Object} authConfig
+ * @returns {Promise<Object[]>}
  */
+async function fetchAllResourceTypes(controllerUrl, authConfig) {
+  const all = [];
+  let page = 1;
+  const pageSize = 100;
+  for (;;) {
+    const res = await listResourceTypes(controllerUrl, authConfig, { page, pageSize });
+    assertControllerListSuccess(res, 'resource types');
+    const items = extractControllerListItems(res);
+    if (items.length === 0) {
+      break;
+    }
+    all.push(...items);
+    if (items.length < pageSize) {
+      break;
+    }
+    page += 1;
+  }
+  return all;
+}
+
 /**
  * @param {Object[]} rows
  * @param {string} controllerUrl
@@ -209,6 +264,35 @@ function setupResourceTypeImportCommand(rt) {
     });
 }
 
+function setupResourceTypeExportCommand(rt) {
+  rt
+    .command('export')
+    .description('Export resource types to baseline-shaped JSON')
+    .addHelpText('after', RESOURCE_TYPE_EXPORT_HELP_AFTER)
+    .requiredOption('--file <path>', 'Output path for baseline catalog JSON')
+    .action(async(options) => {
+      try {
+        const { controllerUrl, authConfig } = await resolveControllerAndAuth(options);
+        const records = await fetchAllResourceTypes(controllerUrl, authConfig);
+        const rows = records.map(mapResourceTypeApiToFileRow);
+        writeResourceTypeCatalogFile(options.file, rows);
+        if (rows.length === 0) {
+          logger.log(
+            infoLine(
+              'No resource types on the controller. Create or import types, then re-run export.'
+            )
+          );
+        }
+        logger.log(
+          formatSuccessLine(`Resource types exported: ${rows.length} written to ${options.file}`)
+        );
+      } catch (e) {
+        logger.error(formatBlockingError(e.message));
+        process.exit(1);
+      }
+    });
+}
+
 function setupResourceTypeCreateCommand(rt) {
   rt
     .command('create')
@@ -224,6 +308,10 @@ function setupResourceTypeCreateCommand(rt) {
     )
     .option('--default-risk-level <level>', 'low | medium | high | critical')
     .option('--status <status>', 'draft | active | deprecated | retired')
+    .option(
+      '--domain <domain>',
+      'sales | finance | people | collaboration | content | operations | governance | platform'
+    )
     .action(async(options) => {
       try {
         const { controllerUrl, authConfig } = await resolveControllerAndAuth(options);
@@ -232,13 +320,20 @@ function setupResourceTypeCreateCommand(rt) {
         const row = unwrapControllerData(out.response);
         const category = row.category || payload.category || 'business';
         const risk = row.defaultRiskLevel || payload.defaultRiskLevel || 'medium';
+        const domain = row.domain || payload.domain || '—';
         if (out.created) {
           logger.log(
-            formatSuccessLine(`Resource type created: ${row.key} (category: ${category}, risk: ${risk})`)
+            formatSuccessLine(
+              `Resource type created: ${row.key} (category: ${category}, risk: ${risk}, domain: ${domain})`
+            )
           );
           return;
         }
-        logger.log(formatSuccessLine(`Resource type exists: ${row.key} (category: ${category}, risk: ${risk})`));
+        logger.log(
+          formatSuccessLine(
+            `Resource type exists: ${row.key} (category: ${category}, risk: ${risk}, domain: ${domain})`
+          )
+        );
         logger.log(infoLine('No changes were needed.'));
       } catch (e) {
         logger.error(formatBlockingError(e.message));
@@ -265,6 +360,7 @@ function setupResourceTypeGetCommand(rt) {
         logger.log(headerKeyValue('Display:', row.displayName || '—'));
         logger.log(headerKeyValue('Category:', row.category || '—'));
         logger.log(headerKeyValue('Default risk:', row.defaultRiskLevel || '—'));
+        logger.log(headerKeyValue('Domain:', row.domain || '—'));
         logger.log(headerKeyValue('Status:', row.status || '—'));
         if (row.description) {
           logger.log(headerKeyValue('Description:', row.description));
@@ -282,6 +378,49 @@ function setupResourceTypeGetCommand(rt) {
  * @param {string} environment
  * @param {string} controllerUrl
  */
+const RESOURCE_TYPE_LIST_COLUMNS = {
+  key: 22,
+  display: 24,
+  category: 14,
+  domain: 14,
+  risk: 8,
+  status: 10
+};
+
+function resourceTypeListSeparatorLength(columns) {
+  return (
+    columns.key +
+    columns.display +
+    columns.category +
+    columns.domain +
+    columns.risk +
+    columns.status
+  );
+}
+
+function logResourceTypeListHeader(columns) {
+  const keyCol = 'Key'.padEnd(columns.key);
+  const displayCol = 'Display'.padEnd(columns.display);
+  const categoryCol = 'Category'.padEnd(columns.category);
+  const domainCol = 'Domain'.padEnd(columns.domain);
+  const riskCol = 'Risk'.padEnd(columns.risk);
+  const statusCol = 'Status'.padEnd(columns.status);
+  logger.log(chalk.gray(`${keyCol}${displayCol}${categoryCol}${domainCol}${riskCol}${statusCol}`));
+  logger.log(chalk.gray('-'.repeat(resourceTypeListSeparatorLength(columns))));
+}
+
+function logResourceTypeListRows(items, columns) {
+  items.forEach((d) => {
+    const key = (d?.key ?? '—').toString().padEnd(columns.key);
+    const displayName = (d?.displayName ?? '—').toString().padEnd(columns.display);
+    const category = (d?.category ?? '—').toString().padEnd(columns.category);
+    const domain = (d?.domain ?? '—').toString().padEnd(columns.domain);
+    const risk = (d?.defaultRiskLevel ?? '—').toString().padEnd(columns.risk);
+    const status = (d?.status ?? '—').toString().padEnd(columns.status);
+    logger.log(`${key}${displayName}${category}${domain}${risk}${status}`);
+  });
+}
+
 function displayResourceTypeList(items, environment, controllerUrl) {
   logger.log(
     chalk.bold(`\n🏷️  Resource types in ${environment} environment (${controllerUrl}):\n`)
@@ -291,29 +430,9 @@ function displayResourceTypeList(items, environment, controllerUrl) {
     return;
   }
 
-  const KEY_WIDTH = 22;
-  const DISPLAY_WIDTH = 30;
-  const CATEGORY_WIDTH = 16;
-  const RISK_WIDTH = 10;
-  const STATUS_WIDTH = 12;
-  const SEP_LEN = KEY_WIDTH + DISPLAY_WIDTH + CATEGORY_WIDTH + RISK_WIDTH + STATUS_WIDTH;
-
-  const keyCol = 'Key'.padEnd(KEY_WIDTH);
-  const displayCol = 'Display'.padEnd(DISPLAY_WIDTH);
-  const categoryCol = 'Category'.padEnd(CATEGORY_WIDTH);
-  const riskCol = 'Risk'.padEnd(RISK_WIDTH);
-  const statusCol = 'Status'.padEnd(STATUS_WIDTH);
-  logger.log(chalk.gray(`${keyCol}${displayCol}${categoryCol}${riskCol}${statusCol}`));
-  logger.log(chalk.gray('-'.repeat(SEP_LEN)));
-
-  items.forEach((d) => {
-    const key = (d?.key ?? '—').toString().padEnd(KEY_WIDTH);
-    const displayName = (d?.displayName ?? '—').toString().padEnd(DISPLAY_WIDTH);
-    const category = (d?.category ?? '—').toString().padEnd(CATEGORY_WIDTH);
-    const risk = (d?.defaultRiskLevel ?? '—').toString().padEnd(RISK_WIDTH);
-    const status = (d?.status ?? '—').toString().padEnd(STATUS_WIDTH);
-    logger.log(`${key}${displayName}${category}${risk}${status}`);
-  });
+  const columns = RESOURCE_TYPE_LIST_COLUMNS;
+  logResourceTypeListHeader(columns);
+  logResourceTypeListRows(items, columns);
   logger.log('');
 }
 
@@ -338,8 +457,8 @@ function setupResourceTypeListCommand(rt) {
           category: options.category,
           status: options.status
         });
-        const payload = unwrapControllerData(res);
-        const items = payload?.data ?? payload ?? [];
+        assertControllerListSuccess(res, 'resource types');
+        const items = extractControllerListItems(res);
         displayResourceTypeList(items, environment, headerControllerUrl);
       } catch (e) {
         logger.error(formatBlockingError(e.message));
@@ -358,6 +477,7 @@ function setupResourceTypeCommands(program) {
     .addHelpText('after', RESOURCE_TYPE_HELP_AFTER);
   setupResourceTypeCreateCommand(rt);
   setupResourceTypeImportCommand(rt);
+  setupResourceTypeExportCommand(rt);
   setupResourceTypeGetCommand(rt);
   setupResourceTypeListCommand(rt);
 }
@@ -367,5 +487,7 @@ module.exports = {
   requireResourceTypeKey,
   buildCreatePayload,
   unwrapControllerData,
-  importResourceTypeRows
+  importResourceTypeRows,
+  fetchAllResourceTypes,
+  mapResourceTypeApiToFileRow
 };