@aifabrix/builder 2.44.6 → 2.45.5

package/lib/api/types/protection.types.js

@@ -0,0 +1,69 @@
+/**
+ * @fileoverview Protection API type definitions (dataplane /api/v1/protection/*).
+ * @author AI Fabrix Team
+ * @version 1.0.0
+ */
+
+/**
+ * @typedef {Object} ProtectionUploadRequest
+ * @property {Object} manifest - Full protection manifest document
+ */
+
+/**
+ * @typedef {Object} ProtectionValidateOptions
+ * @property {boolean} [strict] - Promote WARN to FAIL
+ * @property {boolean} [explain]
+ * @property {number} [sampleSize] - For simulate
+ */
+
+/**
+ * @typedef {Object} ProtectionDeployResponse
+ * @property {string} protectionKey
+ * @property {string} deploymentId
+ * @property {number} revision
+ * @property {string} configHash
+ * @property {string} deployedAt
+ * @property {Object} manifest
+ */
+
+/**
+ * @typedef {Object} ProtectionManifestResponse
+ * @property {string} key
+ * @property {string} displayName
+ * @property {Object} spec
+ * @property {boolean} enabled
+ * @property {string} datasourceKey
+ * @property {number} [currentRevision]
+ * @property {string} [lastDeployedAt]
+ */
+
+/**
+ * @typedef {Object} ProtectionListResult
+ * @property {ProtectionManifestResponse[]} items
+ * @property {Object|null} meta
+ * @property {*} raw
+ */
+
+/**
+ * @typedef {Object} ProtectionGrantStatusSummary
+ * @property {string} dimensionKey
+ * @property {string} effectiveValueType
+ * @property {string} projectionRuleKey
+ */
+
+/**
+ * @typedef {Object} ProtectionStatusResponse
+ * @property {string} protectionKey
+ * @property {boolean} enabled
+ * @property {string} datasourceKey
+ * @property {number} [currentRevision]
+ * @property {string} [configHash]
+ * @property {string} [lastDeployedAt]
+ * @property {string} [lastProjectionRunAt]
+ * @property {string} [lastSuccessfulProjectionRunAt]
+ * @property {number} [dynamicValueCount]
+ * @property {number} [grantCount]
+ * @property {ProtectionGrantStatusSummary[]} [grants]
+ */
+
+module.exports = {};

package/lib/api/types/records-bulk.types.js

@@ -0,0 +1,35 @@
+/**
+ * @fileoverview Types for dataplane bulk record sync API
+ * @author AI Fabrix Team
+ * @version 1.0.0
+ */
+
+/**
+ * Single record in a bulk sync request
+ * @typedef {Object} ExternalBulkRecord
+ * @property {string} key - External record key
+ * @property {string} displayName - Human-readable label
+ * @property {string} recordType - Resource type from datasource manifest
+ * @property {Object} metadata - Record metadata payload
+ */
+
+/**
+ * Bulk sync request body
+ * @typedef {Object} ExternalRecordBulkRequest
+ * @property {'incremental'|'bulk'|'validate'} syncType - Sync mode
+ * @property {boolean} [sync] - Create linked sync job when true
+ * @property {ExternalBulkRecord[]} records - Records to process
+ */
+
+/**
+ * Bulk sync response
+ * @typedef {Object} ExternalRecordBulkResponse
+ * @property {number} insertedCount
+ * @property {number} updatedCount
+ * @property {number} deletedCount
+ * @property {number} totalProcessed
+ * @property {number} [skippedCount]
+ * @property {Object} [recordSkipSummary]
+ */
+
+module.exports = {};

package/lib/api/types/records-search.types.js

@@ -0,0 +1,28 @@
+/**
+ * @fileoverview Types for dataplane Records Search API
+ * @author AI Fabrix Team
+ * @version 1.0.0
+ */
+
+/**
+ * Records search request
+ * @typedef {Object} RecordsSearchRequest
+ * @property {'retrieval'|'grounding'|'analytics'|'validation'} intent
+ * @property {string[]} [datasourceKeys]
+ * @property {string[]} [resourceTypes]
+ * @property {string|Object} [filters]
+ * @property {string|Object} [exclude]
+ * @property {'ids'|'full'} [searchMode]
+ * @property {number} [limit]
+ * @property {boolean} [dryRun]
+ */
+
+/**
+ * Records search response
+ * @typedef {Object} RecordsSearchResponse
+ * @property {Array<string|Object>} data
+ * @property {Object} meta
+ * @property {Object} [links]
+ */
+
+module.exports = {};

package/lib/api/user-groups.api.js

@@ -0,0 +1,50 @@
+/**
+ * @fileoverview User–group membership API (Controller)
+ * @author AI Fabrix Team
+ * @version 1.0.0
+ */
+
+'use strict';
+
+const { ApiClient } = require('./index');
+
+/**
+ * Add user to group
+ * @requiresPermission {Controller} users:update
+ * @async
+ * @param {string} controllerUrl
+ * @param {Object} authConfig
+ * @param {string} userId
+ * @param {string} groupId
+ * @param {Object} [body]
+ * @returns {Promise<Object>}
+ */
+async function addUserToGroup(controllerUrl, authConfig, userId, groupId, body = {}) {
+  const client = new ApiClient(controllerUrl, authConfig);
+  return await client.post(
+    `/api/v1/users/${encodeURIComponent(userId)}/groups/${encodeURIComponent(groupId)}`,
+    { body }
+  );
+}
+
+/**
+ * Remove user from group
+ * @requiresPermission {Controller} users:update
+ * @async
+ * @param {string} controllerUrl
+ * @param {Object} authConfig
+ * @param {string} userId
+ * @param {string} groupId
+ * @returns {Promise<Object>}
+ */
+async function removeUserFromGroup(controllerUrl, authConfig, userId, groupId) {
+  const client = new ApiClient(controllerUrl, authConfig);
+  return await client.delete(
+    `/api/v1/users/${encodeURIComponent(userId)}/groups/${encodeURIComponent(groupId)}`
+  );
+}
+
+module.exports = {
+  addUserToGroup,
+  removeUserFromGroup
+};

package/lib/api/users.api.js

@@ -0,0 +1,95 @@
+/**
+ * @fileoverview Users API (Controller /api/v1/users)
+ * @author AI Fabrix Team
+ * @version 1.0.0
+ */
+
+'use strict';
+
+const { ApiClient } = require('./index');
+
+const BASE = '/api/v1/users';
+
+/**
+ * List users (paginated)
+ * @requiresPermission {Controller} users:read
+ * @async
+ * @param {string} controllerUrl
+ * @param {Object} authConfig
+ * @param {Object} [options]
+ * @returns {Promise<Object>}
+ */
+async function listUsers(controllerUrl, authConfig, options = {}) {
+  const client = new ApiClient(controllerUrl, authConfig);
+  return await client.get(BASE, { params: options });
+}
+
+/**
+ * Get user by id
+ * @requiresPermission {Controller} users:read
+ * @async
+ * @param {string} controllerUrl
+ * @param {Object} authConfig
+ * @param {string} userId
+ * @param {Object} [options]
+ * @returns {Promise<Object>}
+ */
+async function getUser(controllerUrl, authConfig, userId, options = {}) {
+  const client = new ApiClient(controllerUrl, authConfig);
+  const params = {};
+  if (options.includeGroups) {
+    params.includeGroups = 'true';
+  }
+  return await client.get(`${BASE}/${encodeURIComponent(userId)}`, { params });
+}
+
+/**
+ * Create user
+ * @requiresPermission {Controller} users:create
+ * @async
+ * @param {string} controllerUrl
+ * @param {Object} authConfig
+ * @param {Object} body
+ * @returns {Promise<Object>}
+ */
+async function createUser(controllerUrl, authConfig, body) {
+  const client = new ApiClient(controllerUrl, authConfig);
+  return await client.post(BASE, { body });
+}
+
+/**
+ * Patch user
+ * @requiresPermission {Controller} users:update
+ * @async
+ * @param {string} controllerUrl
+ * @param {Object} authConfig
+ * @param {string} userId
+ * @param {Object} body
+ * @returns {Promise<Object>}
+ */
+async function updateUser(controllerUrl, authConfig, userId, body) {
+  const client = new ApiClient(controllerUrl, authConfig);
+  return await client.patch(`${BASE}/${encodeURIComponent(userId)}`, { body });
+}
+
+/**
+ * List groups for a user
+ * @requiresPermission {Controller} users:read
+ * @async
+ * @param {string} controllerUrl
+ * @param {Object} authConfig
+ * @param {string} userId
+ * @returns {Promise<Object>}
+ */
+async function listUserGroups(controllerUrl, authConfig, userId) {
+  const client = new ApiClient(controllerUrl, authConfig);
+  return await client.get(`${BASE}/${encodeURIComponent(userId)}/groups`);
+}
+
+module.exports = {
+  listUsers,
+  getUser,
+  createUser,
+  updateUser,
+  listUserGroups
+};

package/lib/api/validation-run.api.js

@@ -4,7 +4,7 @@
  * @version 2.0.0
  */
 
-const { ApiClient } = require('./index');
+const { createDataplaneApiClient } = require('./index');
 
 const POST_PATH = '/api/v1/validation/run';
 
@@ -52,7 +52,7 @@ function normalizeDataplaneAuth(authConfig) {
 async function postValidationRun(dataplaneUrl, authConfig, body, transportOpts = {}) {
   const hdrs = buildClientCredentialHeaders(authConfig);
   const clientAuth = hdrs ? {} : normalizeDataplaneAuth(authConfig);
-  const client = new ApiClient(dataplaneUrl, clientAuth);
+  const client = createDataplaneApiClient(dataplaneUrl, clientAuth);
   const postOpts = { body, headers: hdrs || undefined };
   if (Number.isFinite(transportOpts.timeoutMs) && transportOpts.timeoutMs > 0) {
     postOpts.timeoutMs = transportOpts.timeoutMs;
@@ -77,7 +77,7 @@ async function getValidationRun(dataplaneUrl, authConfig, testRunId, transportOp
   }
   const hdrs = buildClientCredentialHeaders(authConfig);
   const clientAuth = hdrs ? {} : normalizeDataplaneAuth(authConfig);
-  const client = new ApiClient(dataplaneUrl, clientAuth);
+  const client = createDataplaneApiClient(dataplaneUrl, clientAuth);
   const path = `${POST_PATH}/${encodeURIComponent(testRunId)}`;
   const getOpts = { headers: hdrs || undefined };
   if (Number.isFinite(transportOpts.timeoutMs) && transportOpts.timeoutMs > 0) {

package/lib/api/validation-runner.js

@@ -10,7 +10,6 @@ const { extractTestRunId } = require('./validation-run.api');
 const { postValidationRunWithTransportRetry } = require('../utils/validation-run-post-retry');
 const { pollValidationRunUntilComplete } = require('../utils/validation-run-poll');
 const { createValidationPollHandlers } = require('../utils/validation-poll-ui');
-const logger = require('../utils/logger');
 
 /**
  * POST /api/v1/validation/run and (when async) poll GET until reportCompleteness is full.
@@ -60,8 +59,9 @@ async function postValidationRunAndOptionalPoll(opts) {
     const remaining = Math.max(0, timeoutMs - elapsed);
     const deadlineMs = Date.now() + remaining;
 
-    logger.log('');
-    const pollUi = createValidationPollHandlers(deadlineMs);
+    const pollUi = createValidationPollHandlers(deadlineMs, {
+      subject: opts.pollSubject
+    });
     const mergeOnPollProgress =
       typeof opts.onPollProgress === 'function'
         ? (envelope, attemptIndex, meta) => {

package/lib/api/wizard-platform.api.js

@@ -4,7 +4,7 @@
  * @version 2.0.0
  */
 
-const { ApiClient } = require('./index');
+const { createDataplaneApiClient } = require('./index');
 
 /**
  * Get platform details including available datasources
@@ -19,7 +19,7 @@ const { ApiClient } = require('./index');
  * @throws {Error} If request fails or platform not found (404)
  */
 async function getPlatformDetails(dataplaneUrl, authConfig, platformKey) {
-  const client = new ApiClient(dataplaneUrl, authConfig);
+  const client = createDataplaneApiClient(dataplaneUrl, authConfig);
   const response = await client.get(`/api/v1/wizard/platforms/${encodeURIComponent(platformKey)}`);
   if (!response.success) {
     const msg = response.status === 404
@@ -45,7 +45,7 @@ async function getPlatformDetails(dataplaneUrl, authConfig, platformKey) {
  * @throws {Error} If request fails
  */
 async function discoverEntities(dataplaneUrl, authConfig, openapiSpec) {
-  const client = new ApiClient(dataplaneUrl, authConfig);
+  const client = createDataplaneApiClient(dataplaneUrl, authConfig);
   const response = await client.post('/api/v1/wizard/discover-entities', {
     body: { openapiSpec }
   });

package/lib/api/wizard.api.js

@@ -4,7 +4,7 @@
  * @version 2.0.0
  */
 
-const { ApiClient } = require('./index');
+const { createDataplaneApiClient } = require('./index');
 const { uploadFile } = require('../utils/file-upload');
 const { getPlatformDetails, discoverEntities } = require('./wizard-platform.api');
 
@@ -22,7 +22,7 @@ const { getPlatformDetails, discoverEntities } = require('./wizard-platform.api'
  * @throws {Error} If request fails
  */
 async function createWizardSession(dataplaneUrl, authConfig, mode, systemIdOrKey = null) {
-  const client = new ApiClient(dataplaneUrl, authConfig);
+  const client = createDataplaneApiClient(dataplaneUrl, authConfig);
   const body = { mode };
   if (systemIdOrKey) {
     body.systemIdOrKey = systemIdOrKey;
@@ -45,7 +45,7 @@ async function createWizardSession(dataplaneUrl, authConfig, mode, systemIdOrKey
  * @throws {Error} If request fails
  */
 async function getWizardSession(dataplaneUrl, sessionId, authConfig) {
-  const client = new ApiClient(dataplaneUrl, authConfig);
+  const client = createDataplaneApiClient(dataplaneUrl, authConfig);
   return await client.get(`/api/v1/wizard/sessions/${sessionId}`);
 }
 
@@ -75,7 +75,7 @@ async function getWizardSession(dataplaneUrl, sessionId, authConfig) {
  * @throws {Error} If request fails
  */
 async function updateWizardSession(dataplaneUrl, sessionId, authConfig, updateData) {
-  const client = new ApiClient(dataplaneUrl, authConfig);
+  const client = createDataplaneApiClient(dataplaneUrl, authConfig);
   return await client.put(`/api/v1/wizard/sessions/${sessionId}`, {
     body: updateData
   });
@@ -94,7 +94,7 @@ async function updateWizardSession(dataplaneUrl, sessionId, authConfig, updateDa
  * @throws {Error} If request fails
  */
 async function deleteWizardSession(dataplaneUrl, sessionId, authConfig) {
-  const client = new ApiClient(dataplaneUrl, authConfig);
+  const client = createDataplaneApiClient(dataplaneUrl, authConfig);
   return await client.delete(`/api/v1/wizard/sessions/${sessionId}`);
 }
 
@@ -111,7 +111,7 @@ async function deleteWizardSession(dataplaneUrl, sessionId, authConfig) {
  * @throws {Error} If request fails
  */
 async function getWizardProgress(dataplaneUrl, sessionId, authConfig) {
-  const client = new ApiClient(dataplaneUrl, authConfig);
+  const client = createDataplaneApiClient(dataplaneUrl, authConfig);
   return await client.get(`/api/v1/wizard/sessions/${sessionId}/progress`);
 }
 
@@ -130,7 +130,7 @@ async function getWizardProgress(dataplaneUrl, sessionId, authConfig) {
  */
 async function parseOpenApi(dataplaneUrl, authConfig, openApiFilePathOrUrl, isUrl = false) {
   if (isUrl) {
-    const client = new ApiClient(dataplaneUrl, authConfig);
+    const client = createDataplaneApiClient(dataplaneUrl, authConfig);
     return await client.post(`/api/v1/wizard/parse-openapi?url=${encodeURIComponent(openApiFilePathOrUrl)}`);
   }
   const url = `${dataplaneUrl.replace(/\/$/, '')}/api/v1/wizard/parse-openapi`;
@@ -153,7 +153,7 @@ async function parseOpenApi(dataplaneUrl, authConfig, openApiFilePathOrUrl, isUr
  * @throws {Error} If request fails
  */
 async function credentialSelection(dataplaneUrl, authConfig, selectionData) {
-  const client = new ApiClient(dataplaneUrl, authConfig);
+  const client = createDataplaneApiClient(dataplaneUrl, authConfig);
   return await client.post('/api/v1/wizard/credential-selection', {
     body: selectionData
   });
@@ -172,7 +172,7 @@ async function credentialSelection(dataplaneUrl, authConfig, selectionData) {
  * @throws {Error} If request fails
  */
 async function detectType(dataplaneUrl, authConfig, openapiSpec) {
-  const client = new ApiClient(dataplaneUrl, authConfig);
+  const client = createDataplaneApiClient(dataplaneUrl, authConfig);
   return await client.post('/api/v1/wizard/detect-type', {
     body: { openapiSpec }
   });
@@ -199,7 +199,7 @@ async function detectType(dataplaneUrl, authConfig, openapiSpec) {
  * @throws {Error} If request fails
  */
 async function getPlatformConfig(dataplaneUrl, authConfig, platformKey, config) {
-  const client = new ApiClient(dataplaneUrl, authConfig);
+  const client = createDataplaneApiClient(dataplaneUrl, authConfig);
   return await client.post(`/api/v1/wizard/platforms/${encodeURIComponent(platformKey)}/config`, {
     body: config
   });
@@ -233,7 +233,7 @@ async function getPlatformConfig(dataplaneUrl, authConfig, platformKey, config)
  * @throws {Error} If request fails
  */
 async function generateConfig(dataplaneUrl, authConfig, config) {
-  const client = new ApiClient(dataplaneUrl, authConfig);
+  const client = createDataplaneApiClient(dataplaneUrl, authConfig);
   return await client.post('/api/v1/wizard/generate-config', {
     body: config
   });
@@ -252,7 +252,7 @@ async function generateConfig(dataplaneUrl, authConfig, config) {
  * @throws {Error} If request fails
  */
 async function generateConfigStream(dataplaneUrl, authConfig, config) {
-  const client = new ApiClient(dataplaneUrl, authConfig);
+  const client = createDataplaneApiClient(dataplaneUrl, authConfig);
   return await client.post('/api/v1/wizard/generate-config-stream', {
     body: config
   });
@@ -272,7 +272,7 @@ async function generateConfigStream(dataplaneUrl, authConfig, config) {
  * @throws {Error} If request fails
  */
 async function validateWizardConfig(dataplaneUrl, authConfig, systemConfig, datasourceConfig) {
-  const client = new ApiClient(dataplaneUrl, authConfig);
+  const client = createDataplaneApiClient(dataplaneUrl, authConfig);
   return await client.post('/api/v1/wizard/validate', {
     body: {
       systemConfig,
@@ -294,7 +294,7 @@ async function validateWizardConfig(dataplaneUrl, authConfig, systemConfig, data
  * @throws {Error} If request fails
  */
 async function validateAllSteps(dataplaneUrl, sessionId, authConfig) {
-  const client = new ApiClient(dataplaneUrl, authConfig);
+  const client = createDataplaneApiClient(dataplaneUrl, authConfig);
   return await client.get(`/api/v1/wizard/sessions/${sessionId}/validate`);
 }
 
@@ -312,7 +312,7 @@ async function validateAllSteps(dataplaneUrl, sessionId, authConfig) {
  * @throws {Error} If request fails
  */
 async function validateStep(dataplaneUrl, sessionId, authConfig, stepNumber) {
-  const client = new ApiClient(dataplaneUrl, authConfig);
+  const client = createDataplaneApiClient(dataplaneUrl, authConfig);
   return await client.post(`/api/v1/wizard/sessions/${sessionId}/validate-step?step=${stepNumber}`);
 }
 
@@ -329,7 +329,7 @@ async function validateStep(dataplaneUrl, sessionId, authConfig, stepNumber) {
  * @throws {Error} If request fails
  */
 async function getPreview(dataplaneUrl, sessionId, authConfig) {
-  const client = new ApiClient(dataplaneUrl, authConfig);
+  const client = createDataplaneApiClient(dataplaneUrl, authConfig);
   return await client.get(`/api/v1/wizard/preview/${sessionId}`);
 }
 
@@ -347,7 +347,7 @@ async function getPreview(dataplaneUrl, sessionId, authConfig) {
  * @throws {Error} If request fails
  */
 async function testMcpConnection(dataplaneUrl, authConfig, serverUrl, token) {
-  const client = new ApiClient(dataplaneUrl, authConfig);
+  const client = createDataplaneApiClient(dataplaneUrl, authConfig);
   return await client.post('/api/v1/wizard/test-mcp-connection', {
     body: {
       serverUrl,
@@ -369,7 +369,7 @@ async function testMcpConnection(dataplaneUrl, authConfig, serverUrl, token) {
  * @throws {Error} If request fails
  */
 async function getDeploymentDocs(dataplaneUrl, authConfig, systemKey) {
-  const client = new ApiClient(dataplaneUrl, authConfig);
+  const client = createDataplaneApiClient(dataplaneUrl, authConfig);
   return await client.get(`/api/v1/wizard/deployment-docs/${systemKey}`);
 }
 
@@ -390,7 +390,7 @@ async function getDeploymentDocs(dataplaneUrl, authConfig, systemKey) {
  * @throws {Error} If request fails
  */
 async function postDeploymentDocs(dataplaneUrl, authConfig, systemKey, body = null) {
-  const client = new ApiClient(dataplaneUrl, authConfig);
+  const client = createDataplaneApiClient(dataplaneUrl, authConfig);
   return await client.post(`/api/v1/wizard/deployment-docs/${systemKey}`, {
     body: body || {}
   });
@@ -410,7 +410,7 @@ async function postDeploymentDocs(dataplaneUrl, authConfig, systemKey, body = nu
  */
 async function getWizardPlatforms(dataplaneUrl, authConfig) {
   try {
-    const client = new ApiClient(dataplaneUrl, authConfig);
+    const client = createDataplaneApiClient(dataplaneUrl, authConfig);
     const response = await client.get('/api/v1/wizard/platforms');
     const platforms = response?.data?.platforms ?? response?.platforms ?? [];
     return Array.isArray(platforms) ? platforms : [];
@@ -433,7 +433,7 @@ async function getWizardPlatforms(dataplaneUrl, authConfig) {
  * @throws {Error} If request fails
  */
 async function listWizardCredentials(dataplaneUrl, authConfig, options = {}) {
-  const client = new ApiClient(dataplaneUrl, authConfig);
+  const client = createDataplaneApiClient(dataplaneUrl, authConfig);
   return await client.get('/api/v1/wizard/credentials', {
     params: options
   });

package/lib/app/deploy.js

@@ -421,6 +421,35 @@ async function tryExternalDeployFallback(appName, options) {
   return { usedExternalDeploy: false, result: null };
 }
 
+function assertDeployNotProtectionScope(appName) {
+  const { isProtectionScope } = require('../protection/scope');
+  if (!isProtectionScope(appName)) {
+    return;
+  }
+  const { formatDeployProtectionNotImplementedTTY } = require('../protection/protection-display');
+  logger.error(formatDeployProtectionNotImplementedTTY());
+  process.exit(1);
+}
+
+/**
+ * Run external, fallback, or standard deployment paths.
+ * @param {string} appName
+ * @param {Object} options
+ * @returns {Promise<{ result: Object, usedExternalDeploy: boolean, controllerUrl?: string }>}
+ */
+async function executeDeployPipeline(appName, options) {
+  const externalResult = await handleExternalDeployment(appName, options);
+  if (externalResult) {
+    return { result: externalResult, usedExternalDeploy: true };
+  }
+  const fallback = await tryExternalDeployFallback(appName, options);
+  if (fallback.result) {
+    return { result: fallback.result, usedExternalDeploy: fallback.usedExternalDeploy };
+  }
+  const { result, controllerUrl } = await executeStandardDeployment(appName, options);
+  return { result, usedExternalDeploy: false, controllerUrl };
+}
+
 /**
  * Deploys application to Miso Controller
  * Orchestrates manifest generation, key creation, and deployment
@@ -446,26 +475,12 @@ async function deployApp(appName, options = {}) {
   let usedExternalDeploy = false;
 
   try {
-    if (!appName || typeof appName !== 'string' || appName.trim().length === 0) {
-      throw new Error('App name is required');
-    }
+    assertDeployNotProtectionScope(appName);
     validateAppName(appName);
-
-    const externalResult = await handleExternalDeployment(appName, options);
-    if (externalResult) {
-      usedExternalDeploy = true;
-      return { result: externalResult, usedExternalDeploy: true };
-    }
-
-    const fallback = await tryExternalDeployFallback(appName, options);
-    if (fallback.result) {
-      usedExternalDeploy = fallback.usedExternalDeploy;
-      return { result: fallback.result, usedExternalDeploy };
-    }
-
-    const { result, controllerUrl: url } = await executeStandardDeployment(appName, options);
-    controllerUrl = url;
-    return { result, usedExternalDeploy: false };
+    const pipeline = await executeDeployPipeline(appName, options);
+    controllerUrl = pipeline.controllerUrl ?? null;
+    usedExternalDeploy = pipeline.usedExternalDeploy;
+    return { result: pipeline.result, usedExternalDeploy };
   } catch (error) {
     await handleDeploymentError(error, appName, controllerUrl, usedExternalDeploy);
   }

package/lib/app/helpers.js

@@ -14,7 +14,7 @@ const path = require('path');
 const chalk = require('chalk');
 const { validateTemplate, copyTemplateFiles, copyAppFiles } = require('../validation/template');
 const logger = require('../utils/logger');
-const { getIntegrationPath, getBuilderPath } = require('../utils/paths');
+const paths = require('../utils/paths');
 
 /**
  * Validates that no app or external system with this name exists in integration/ or builder/.
@@ -25,8 +25,8 @@ const { getIntegrationPath, getBuilderPath } = require('../utils/paths');
  * @throws {Error} If integration/<systemKey> or builder/<appKey> already exists
  */
 async function validateAppOrExternalNameNotExists(appName) {
-  const integrationPath = getIntegrationPath(appName);
-  const builderPath = getBuilderPath(appName);
+  const integrationPath = paths.getIntegrationPath(appName);
+  const builderPath = paths.getBuilderPath(appName);
   try {
     await fs.access(integrationPath);
     throw new Error(

package/lib/app/index.js

@@ -21,7 +21,7 @@ const { loadTemplateVariables, updateTemplateVariables, mergeTemplateVariables }
 const { validateTemplate } = require('../validation/template');
 const auditLogger = require('../core/audit-logger');
 const { downApp } = require('./down');
-const { getAppPath } = require('../utils/paths');
+const paths = require('../utils/paths');
 const { displaySuccessMessage } = require('./display');
 const {
   validateAppDirectoryNotExists,
@@ -93,7 +93,7 @@ function validateAppNameAndSetup(appName, options) {
 
   const initialType = options.type || 'external';
   const baseDir = getBaseDirForAppType(initialType);
-  const appPath = getAppPath(appName, initialType);
+  const appPath = paths.getAppPath(appName, initialType);
 
   return { initialType, baseDir, appPath };
 }
@@ -124,7 +124,7 @@ async function handleTemplateSetup(options) {
  */
 async function prepareFinalAppPath(appName, config, initialAppPath) {
   const finalBaseDir = getBaseDirForAppType(config.type);
-  const finalAppPath = getAppPath(appName, config.type);
+  const finalAppPath = paths.getAppPath(appName, config.type);
 
   // If path changed, validate the new path
   if (finalAppPath !== initialAppPath) {