@aifabrix/builder 2.33.5 → 2.36.0

package/README.md

@@ -121,6 +121,11 @@ Build --> Run[Run Locally]:::base
 Run --> Deploy[Deploy to Azure]:::primary
 ```
 
+## Development
+
+- **Tests**: `npm test` (runs via wrapper; handles known Jest/Node exit issues).
+- **Coverage**: `npm run test:coverage` — runs tests with coverage through the same wrapper. May take 3–5 minutes for the full suite. If the process exits with a signal after "Ran all test suites", the wrapper treats it as success and coverage is written to `coverage/`. Use `test:coverage:nyc` only if you need nyc-specific reporters.
+
 ## Requirements
 
 - **Docker Desktop** - For running containers

package/integration/test-hubspot/wizard.yaml

@@ -0,0 +1,8 @@
+appName: test-hubspot
+mode: create-system
+source:
+  type: openapi-file
+  filePath: /workspace/aifabrix-builder/integration/hubspot/companies.json
+credential:
+  action: skip
+preferences: {}

package/lib/api/wizard.api.js

@@ -326,6 +326,28 @@ async function getDeploymentDocs(dataplaneUrl, authConfig, systemKey) {
   return await client.get(`/api/v1/wizard/deployment-docs/${systemKey}`);
 }
 
+/**
+ * Get known wizard platforms from dataplane.
+ * GET /api/v1/wizard/platforms
+ * Expected response: { platforms: [ { key: string, displayName?: string } ] } or equivalent.
+ * On 404 or error, returns empty array (caller should hide "Known platform" choice).
+ * @async
+ * @function getWizardPlatforms
+ * @param {string} dataplaneUrl - Dataplane base URL
+ * @param {Object} authConfig - Authentication configuration
+ * @returns {Promise<Array<{key: string, displayName?: string}>>} List of platforms (empty on 404/error)
+ */
+async function getWizardPlatforms(dataplaneUrl, authConfig) {
+  try {
+    const client = new ApiClient(dataplaneUrl, authConfig);
+    const response = await client.get('/api/v1/wizard/platforms');
+    const platforms = response?.data?.platforms ?? response?.platforms ?? [];
+    return Array.isArray(platforms) ? platforms : [];
+  } catch (error) {
+    return [];
+  }
+}
+
 module.exports = {
   createWizardSession,
   getWizardSession,
@@ -342,5 +364,6 @@ module.exports = {
   validateStep,
   getPreview,
   testMcpConnection,
-  getDeploymentDocs
+  getDeploymentDocs,
+  getWizardPlatforms
 };

package/lib/app/run-helpers.js

@@ -139,14 +139,15 @@ async function validateAppConfiguration(appName) {
 }
 
 /**
- * Checks prerequisites: Docker image and infrastructure
+ * Checks prerequisites: Docker image and (optionally) infrastructure
  * @async
  * @param {string} appName - Application name
  * @param {Object} appConfig - Application configuration
  * @param {boolean} [debug=false] - Enable debug logging
+ * @param {boolean} [skipInfraCheck=false] - When true, skip infra health check (e.g. when caller already verified, e.g. up-miso)
  * @throws {Error} If prerequisites are not met
  */
-async function checkPrerequisites(appName, appConfig, debug = false) {
+async function checkPrerequisites(appName, appConfig, debug = false, skipInfraCheck = false) {
   const imageName = composeGenerator.getImageName(appConfig, appName);
   const imageTag = appConfig.image?.tag || 'latest';
   const fullImageName = `${imageName}:${imageTag}`;
@@ -162,6 +163,10 @@ async function checkPrerequisites(appName, appConfig, debug = false) {
   }
   logger.log(chalk.green(`✓ Image ${fullImageName} found`));
 
+  if (skipInfraCheck) {
+    return;
+  }
+
   logger.log(chalk.blue('Checking infrastructure health...'));
   const infraHealth = await infra.checkInfraHealth();
   if (debug) {

package/lib/app/run.js

@@ -177,8 +177,8 @@ async function runApp(appName, options = {}) {
     // Load and configure application
     const appConfig = await loadAndConfigureApp(appName, debug);
 
-    // Check prerequisites: image and infrastructure
-    await helpers.checkPrerequisites(appName, appConfig, debug);
+    // Check prerequisites: image and (unless skipped) infrastructure
+    await helpers.checkPrerequisites(appName, appConfig, debug, options.skipInfraCheck === true);
 
     // Check if container is already running and stop it if needed
     await checkAndStopContainer(appName, appConfig.developerId, debug);

package/lib/app/show-display.js

@@ -0,0 +1,184 @@
+/**
+ * Human-readable display for aifabrix show command.
+ * Single display function for offline and online (unified summary shape).
+ *
+ * @fileoverview Display formatting for show command
+ * @author AI Fabrix Team
+ * @version 2.0.0
+ */
+
+'use strict';
+
+const chalk = require('chalk');
+const logger = require('../utils/logger');
+
+function logSourceAndHeader(summary) {
+  const isOffline = summary.source === 'offline';
+  const sourceLabel = isOffline
+    ? `Source: offline (${summary.path || '—'})`
+    : `Source: online (${summary.controllerUrl || '—'})`;
+  logger.log(sourceLabel);
+  logger.log('');
+}
+
+function logApplicationRequired(a) {
+  logger.log('📱 Application');
+  logger.log(`  Key:           ${a.key ?? '—'}`);
+  logger.log(`  Display name:  ${a.displayName ?? '—'}`);
+  logger.log(`  Description:   ${a.description ?? '—'}`);
+  logger.log(`  Type:          ${a.type ?? '—'}`);
+  const port = (a.port !== undefined && a.port !== null) ? a.port : '—';
+  logger.log(`  Port:          ${port}`);
+}
+
+function logApplicationOptional(a) {
+  if (a.deploymentKey !== undefined) logger.log(`  Deployment:    ${a.deploymentKey ?? '—'}`);
+  if (a.image !== undefined) logger.log(`  Image:         ${a.image ?? '—'}`);
+  if (a.registryMode !== undefined) logger.log(`  Registry:      ${a.registryMode ?? '—'}`);
+  if (a.healthCheck !== undefined) logger.log(`  Health:        ${a.healthCheck ?? '—'}`);
+  if (a.build !== undefined) logger.log(`  Build:         ${a.build ?? '—'}`);
+  if (a.status !== undefined) logger.log(`  Status:        ${a.status ?? '—'}`);
+  if (a.url !== undefined) logger.log(`  URL:           ${a.url ?? '—'}`);
+}
+
+function logApplicationFields(a) {
+  logApplicationRequired(a);
+  logApplicationOptional(a);
+}
+
+function logApplicationExternalIntegration(ei) {
+  logger.log('  External integration:');
+  logger.log(`    schemaBasePath: ${ei.schemaBasePath}`);
+  logger.log(`    systems: [${(ei.systems || []).join(', ')}]`);
+  logger.log(`    dataSources: [${(ei.dataSources || []).join(', ')}]`);
+  logger.log(chalk.gray('\n  For external system data as on dataplane, run with --online.'));
+}
+
+function logApplicationSection(a, isExternal) {
+  logApplicationFields(a);
+  if (isExternal && a.externalIntegration) {
+    logApplicationExternalIntegration(a.externalIntegration);
+  }
+}
+
+function logRolesSection(roles) {
+  if (roles.length === 0) return;
+  logger.log('');
+  logger.log('👥 Roles');
+  roles.forEach((r) => {
+    const ro = typeof r === 'object' ? r : { name: r, value: r };
+    const name = ro.name ?? ro.value ?? '—';
+    const value = ro.value ?? ro.name ?? '—';
+    logger.log(`  • ${name} (${value})`);
+    if (ro.description) logger.log(`  \t${ro.description}`);
+    if (ro.groups && ro.groups.length > 0) logger.log(`  \tgroups: [${ro.groups.join(', ')}]`);
+  });
+}
+
+function logPermissionsSection(permissions) {
+  if (permissions.length === 0) return;
+  logger.log('');
+  logger.log('🛡️ Permissions');
+  permissions.forEach((p) => {
+    const name = p.name ?? '—';
+    const roleList = (p.roles || []).join(', ');
+    logger.log(`  • ${name}`);
+    logger.log(`  \troles: [${roleList}]`);
+    if (p.description) logger.log(`  \t${p.description}`);
+  });
+}
+
+function logAuthSection(authentication) {
+  if (!authentication) return;
+  logger.log('');
+  logger.log('🔐 Authentication');
+  const sso = authentication.enableSSO ? 'enabled' : 'disabled';
+  logger.log(`  SSO: ${sso}   type: ${authentication.type ?? '—'}   requiredRoles: [${(authentication.requiredRoles || []).join(', ')}]`);
+}
+
+function logConfigurationsSection(portalInputConfigurations) {
+  if (portalInputConfigurations.length === 0) return;
+  logger.log('');
+  logger.log('📝 Configurations');
+  portalInputConfigurations.forEach((c) => {
+    logger.log(`  ${c.label ?? c.name ?? '—'}:  ${c.value ?? '—'}`);
+  });
+}
+
+function logDatabasesSection(dbNames) {
+  if (dbNames.length === 0) return;
+  logger.log('');
+  logger.log('🗄️ Databases');
+  logger.log(`  ${dbNames.join(', ')}`);
+}
+
+function logExternalSystemMain(ext) {
+  logger.log('🔗 External system (dataplane)');
+  logger.log(`  Dataplane:     ${ext.dataplaneUrl}`);
+  logger.log(`  System key:    ${ext.systemKey}`);
+  logger.log(`  Display name:  ${ext.displayName}`);
+  logger.log(`  Type:          ${ext.type}`);
+  logger.log(`  Status:        ${ext.status}`);
+  logger.log(`  Version:       ${ext.version ?? '—'}`);
+}
+
+function logExternalSystemDataSources(dataSources) {
+  if (!dataSources || dataSources.length === 0) return;
+  logger.log('  DataSources:');
+  dataSources.forEach((ds) => {
+    logger.log(`    • ${ds.key}  ${ds.displayName ?? ''} (systemKey: ${ds.systemKey ?? '—'})`);
+  });
+}
+
+function logExternalSystemApplication(ap) {
+  if (!ap) return;
+  logger.log('  Application (from dataplane):');
+  logger.log(`    key: ${ap.key}   displayName: ${ap.displayName}   type: ${ap.type}`);
+  if (ap.roles) logger.log(`    roles: ${Array.isArray(ap.roles) ? ap.roles.join(', ') : ap.roles}`);
+  if (ap.permissions) logger.log(`    permissions: ${Array.isArray(ap.permissions) ? ap.permissions.join(', ') : ap.permissions}`);
+}
+
+function logExternalSystemSection(ext) {
+  if (!ext) return;
+  logger.log('');
+  if (ext.error) {
+    logger.log('🔗 External system (dataplane): not available (dataplane unreachable or not found).');
+    return;
+  }
+  logExternalSystemMain(ext);
+  logExternalSystemDataSources(ext.dataSources);
+  logExternalSystemApplication(ext.application);
+  if (ext.openapiFiles && ext.openapiFiles.length > 0) {
+    logger.log(`  OpenAPI files: ${ext.openapiFiles.length}`);
+  }
+  if (ext.openapiEndpoints && ext.openapiEndpoints.length > 0) {
+    const sample = ext.openapiEndpoints.slice(0, 3).map((e) => `${e.method || 'GET'} ${e.path || e.pathPattern || e}`).join(', ');
+    logger.log(`  OpenAPI endpoints: ${ext.openapiEndpoints.length} (e.g. ${sample}${ext.openapiEndpoints.length > 3 ? ' …' : ''})`);
+  }
+}
+
+/**
+ * Format and print human-readable show output (offline or online).
+ * @param {Object} summary - Unified summary (buildOfflineSummaryFromDeployJson or buildOnlineSummary)
+ */
+function display(summary) {
+  const a = summary.application;
+  const roles = summary.roles ?? a.roles ?? [];
+  const permissions = summary.permissions ?? a.permissions ?? [];
+  const authentication = summary.authentication ?? a.authentication;
+  const portalInputConfigurations = summary.portalInputConfigurations ?? a.portalInputConfigurations ?? [];
+  const databases = summary.databases ?? a.databases ?? [];
+  const dbNames = Array.isArray(databases) ? databases.map((d) => (d && d.name) || d).filter(Boolean) : [];
+
+  logSourceAndHeader(summary);
+  logApplicationSection(a, summary.isExternal);
+  logRolesSection(roles);
+  logPermissionsSection(permissions);
+  logAuthSection(authentication);
+  logConfigurationsSection(portalInputConfigurations);
+  logDatabasesSection(dbNames);
+  logExternalSystemSection(summary.externalSystem);
+  logger.log('');
+}
+
+module.exports = { display };