@aifabrix/builder 2.40.0 → 2.40.2

package/README.md

@@ -16,7 +16,7 @@ Install the AI Fabrix platform and test it locally. Then add external integratio
 - **Full lifecycle in your version control:** Configuration, apps, and integrations live in your own VCS (GitHub, GitLab, Azure DevOps).
 - **One tool from day one:** Single CLI for local infra, app and integration creation, build, run, and deploy—same workflow for apps and integrations.
 - **Consistency and production readiness:** Schema-driven; deploy apps and integrations to the same controller/dataplane; production-ready secrets with `kv://` and Azure Key Vault.
-- **Application development:** Use **[miso-client](https://github.com/esystemsdev/aifabrix-miso-client)** for TypeScript and Python to talk to the dataplane and controller (see [templates/applications/dataplane/README.md](templates/applications/dataplane/README.md) and the repo for usage).
+- **Application development:** Use **[miso-client](https://github.com/esystemsdev/aifabrix-miso-client)** (TypeScript and Python) to talk to the dataplane and controller. The repo includes both TypeScript and Python SDKs; see [templates/applications/dataplane/README.md](templates/applications/dataplane/README.md) and the repo for usage.
 
 ---
 

package/jest.config.manual.js

@@ -0,0 +1,29 @@
+/**
+ * Jest Configuration for Manual Tests (real API calls)
+ * Runs only tests/manual; requires user to be logged in (validated before run).
+ *
+ * @fileoverview Jest config for manual tests that call real Controller/Dataplane APIs
+ * @author AI Fabrix Team
+ * @version 2.0.0
+ */
+
+const baseProject = require('./jest.config').projects[0];
+
+module.exports = {
+  projects: [
+    {
+      ...baseProject,
+      displayName: 'manual',
+      testMatch: [
+        '**/tests/manual/**/*.test.js'
+      ],
+      testPathIgnorePatterns: [
+        '/node_modules/',
+        '\\\\node_modules\\\\'
+      ],
+      setupFilesAfterEnv: ['<rootDir>/tests/manual/setup.js'],
+      testTimeout: 60000,
+      maxWorkers: 1
+    }
+  ]
+};

package/lib/cli/setup-auth.js

@@ -63,6 +63,7 @@ function setupAuthSubcommands(program) {
   const auth = program.command('auth').description('Authentication commands');
   auth.command('status')
     .description('Display authentication status for current controller and environment')
+    .option('--validate', 'Exit with code 1 when not authenticated (for scripted use, e.g. manual test setup)')
     .action(authStatusHandler);
   auth.command('config')
     .description('Configure authentication settings (controller, environment)')

package/lib/cli/setup-utility.js

@@ -183,11 +183,17 @@ function setupSplitJsonConvertShowCommands(program) {
 function setupValidateDiffCommands(program) {
   program.command('validate <appOrFile>')
     .description('Validate application or external integration file')
+    .option('--format <format>', 'Output format: json | default (human-readable)')
     .action(async(appOrFile, options) => {
       try {
         const validate = require('../validation/validate');
         const result = await validate.validateAppOrFile(appOrFile, options);
-        validate.displayValidationResults(result);
+        const outFormat = (options.format || 'default').toLowerCase();
+        if (outFormat === 'json') {
+          logger.log(JSON.stringify(result, null, 2));
+        } else {
+          validate.displayValidationResults(result);
+        }
         if (!result.valid) process.exit(1);
       } catch (error) {
         handleCommandError(error, 'validate');

package/lib/commands/auth-status.js

@@ -317,10 +317,11 @@ function displayStatus(controllerUrl, environment, tokenInfo, dataplaneInfo) {
  * Controller and environment come from config.yaml (set via aifabrix login or aifabrix auth config).
  * @async
  * @function handleAuthStatus
- * @param {Object} _options - Command options (unused; controller/environment from config only)
+ * @param {Object} options - Command options
+ * @param {boolean} [options.validate] - If true, exit with code 1 when not authenticated
  * @returns {Promise<void>} Resolves when status is displayed
  */
-async function handleAuthStatus(_options) {
+async function handleAuthStatus(options = {}) {
   const { resolveEnvironment } = require('../core/config');
   const controllerUrl = await resolveControllerUrl();
   const environment = await resolveEnvironment();
@@ -342,6 +343,38 @@ async function handleAuthStatus(_options) {
   }
 
   displayStatus(controllerUrl, environment, tokenInfo, dataplaneInfo);
+
+  if (options.validate && (!tokenInfo || !tokenInfo.authenticated)) {
+    process.exit(1);
+  }
+}
+
+/**
+ * Get resolved auth context (controller URL, environment, authConfig) for use after validation.
+ * Call only when auth status --validate has already passed (e.g. in manual tests).
+ * @async
+ * @function getValidatedAuthContext
+ * @returns {Promise<{controllerUrl: string, environment: string, authConfig: Object, dataplaneUrl: string|null}>}
+ * @throws {Error} If not authenticated
+ */
+async function getValidatedAuthContext() {
+  const { resolveEnvironment } = require('../core/config');
+  const controllerUrl = await resolveControllerUrl();
+  const environment = await resolveEnvironment();
+
+  let tokenInfo = await checkDeviceToken(controllerUrl);
+  if (!tokenInfo) {
+    tokenInfo = await checkClientToken(controllerUrl, environment);
+  }
+
+  if (!tokenInfo || !tokenInfo.authenticated || !tokenInfo.token) {
+    throw new Error('Not authenticated. Run "aifabrix login" or configure client credentials.');
+  }
+
+  const authConfig = { type: 'bearer', token: tokenInfo.token };
+  const dataplaneUrl = await resolveDataplaneUrlSilent(controllerUrl, environment, authConfig);
+
+  return { controllerUrl, environment, authConfig, dataplaneUrl };
 }
 
-module.exports = { handleAuthStatus };
+module.exports = { handleAuthStatus, getValidatedAuthContext };

package/lib/generator/wizard.js

@@ -2,6 +2,10 @@
  * @fileoverview Wizard file generator - saves dataplane-generated configurations to files
  * @author AI Fabrix Team
  * @version 2.0.0
+ *
+ * Standard credential-backed variable names (supplied at runtime from the selected credential;
+ * do not list in configuration array): CLIENTID, CLIENTSECRET, TOKENURL, APIKEY, USERNAME,
+ * PASSWORD, BASEURL. See docs/external-systems.md and docs/wizard.md.
  */
 
 const fs = require('fs').promises;
@@ -322,7 +326,7 @@ function addAuthenticationLines(lines, auth, authType) {
 function addBaseUrlLines(lines, systemConfig) {
   if (systemConfig.baseUrl || systemConfig.baseURL) {
     lines.push('# API Base URL');
-    lines.push(`BASE_URL=${systemConfig.baseUrl || systemConfig.baseURL}`);
+    lines.push(`BASEURL=${systemConfig.baseUrl || systemConfig.baseURL}`);
     lines.push('');
   }
 }

package/lib/utils/paths.js

@@ -178,6 +178,12 @@ function checkGlobalProjectRoot() {
     return null;
   }
 
+  // In test environment, allow temp dir as project root (Jest sets NODE_ENV=test / JEST_WORKER_ID)
+  const isTestEnv = process.env.NODE_ENV === 'test' || typeof process.env.JEST_WORKER_ID !== 'undefined';
+  if (isTestEnv) {
+    return globalRoot;
+  }
+
   // Verify that __dirname is actually within globalRoot
   const dirnameNormalized = path.resolve(__dirname);
   const globalRootNormalized = path.resolve(globalRoot);

package/lib/validation/validate.js

@@ -452,7 +452,7 @@ async function validateAppOrFile(appOrFile, options = {}) {
   logOfflinePathWhenType(appPath);
 
   if (isExternal) {
-    return await validateExternalSystemComplete(appName);
+    return await validateExternalSystemComplete(appName, options);
   }
 
   const appValidation = await validator.validateApplication(appName, options);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aifabrix/builder",
-  "version": "2.40.0",
+  "version": "2.40.2",
   "description": "AI Fabrix Local Fabric & Deployment SDK",
   "main": "lib/index.js",
   "bin": {
@@ -16,11 +16,13 @@
     "test:integration": "jest --config jest.config.integration.js --runInBand",
     "test:integration:python": "cross-env TEST_LANGUAGE=python jest --config jest.config.integration.js --runInBand",
     "test:integration:typescript": "cross-env TEST_LANGUAGE=typescript jest --config jest.config.integration.js --runInBand",
+    "test:manual": "jest --config jest.config.manual.js --runInBand",
     "lint": "eslint . --ext .js",
     "lint:fix": "eslint . --ext .js --fix",
     "lint:ci": "eslint . --ext .js --format json --output-file eslint-report.json",
     "dev": "node bin/aifabrix.js",
     "build": "npm run lint && npm run test",
+    "build:ci": "npm run lint && npm run test:ci",
     "pack": "npm run build && npm pack",
     "validate": "npm run build",
     "prepublishOnly": "npm run validate",

package/templates/external-system/external-system.json.hbs

@@ -30,22 +30,7 @@
     "toolPrefix": "{{systemKey}}"
   }{{/if}},
   "tags": [],
-  "configuration": [
-    {
-      "name": "BASE_URL",
-      "value": "{{#if baseUrl}}{{baseUrl}}{{else}}https://api.example.com{{/if}}",
-      "location": "variable",
-      "required": true,
-      "portalInput": {
-        "field": "text",
-        "label": "Base URL",
-        "placeholder": "https://api.example.com",
-        "validation": {
-          "required": true
-        }
-      }
-    }
-  ]{{#if roles}},
+  "configuration": []{{#if roles}},
   "roles": [
     {{#each roles}}
     {