@aifabrix/builder 2.7.0 → 2.9.0

package/integration/hubspot/hubspot-deploy-deal.json

@@ -0,0 +1,248 @@
+{
+  "key": "hubspot-deal",
+  "displayName": "HubSpot Deal",
+  "description": "HubSpot deals datasource with field mappings for CRM deal data",
+  "systemKey": "hubspot",
+  "entityKey": "deal",
+  "resourceType": "deal",
+  "enabled": true,
+  "version": "1.0.0",
+  "metadataSchema": {
+    "type": "object",
+    "properties": {
+      "id": {
+        "type": "string"
+      },
+      "properties": {
+        "type": "object",
+        "properties": {
+          "dealname": {
+            "type": "object",
+            "properties": {
+              "value": {
+                "type": "string"
+              }
+            }
+          },
+          "amount": {
+            "type": "object",
+            "properties": {
+              "value": {
+                "type": "string"
+              }
+            }
+          },
+          "deal_currency_code": {
+            "type": "object",
+            "properties": {
+              "value": {
+                "type": "string"
+              }
+            }
+          },
+          "dealstage": {
+            "type": "object",
+            "properties": {
+              "value": {
+                "type": "string"
+              }
+            }
+          },
+          "pipeline": {
+            "type": "object",
+            "properties": {
+              "value": {
+                "type": "string"
+              }
+            }
+          },
+          "closedate": {
+            "type": "object",
+            "properties": {
+              "value": {
+                "type": "string"
+              }
+            }
+          },
+          "dealtype": {
+            "type": "object",
+            "properties": {
+              "value": {
+                "type": "string"
+              }
+            }
+          },
+          "createdate": {
+            "type": "object",
+            "properties": {
+              "value": {
+                "type": "string"
+              }
+            }
+          },
+          "hs_lastmodifieddate": {
+            "type": "object",
+            "properties": {
+              "value": {
+                "type": "string"
+              }
+            }
+          }
+        }
+      },
+      "associations": {
+        "type": "object",
+        "properties": {
+          "companies": {
+            "type": "object",
+            "properties": {
+              "results": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "id": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "contacts": {
+            "type": "object",
+            "properties": {
+              "results": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "id": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "required": ["id", "properties"]
+  },
+  "fieldMappings": {
+    "accessFields": ["stage", "pipeline"],
+    "fields": {
+      "id": {
+        "expression": "{{id}}",
+        "type": "string",
+        "description": "Unique deal identifier",
+        "required": true
+      },
+      "dealName": {
+        "expression": "{{properties.dealname.value}} | trim",
+        "type": "string",
+        "description": "Deal name",
+        "required": false
+      },
+      "amount": {
+        "expression": "{{properties.amount.value}}",
+        "type": "string",
+        "description": "Deal amount",
+        "required": false
+      },
+      "currency": {
+        "expression": "{{properties.deal_currency_code.value}} | toUpper | trim",
+        "type": "string",
+        "description": "Currency code",
+        "required": false
+      },
+      "stage": {
+        "expression": "{{properties.dealstage.value}} | trim",
+        "type": "string",
+        "description": "Deal stage for ABAC filtering",
+        "required": false
+      },
+      "pipeline": {
+        "expression": "{{properties.pipeline.value}} | trim",
+        "type": "string",
+        "description": "Pipeline name for ABAC filtering",
+        "required": false
+      },
+      "closeDate": {
+        "expression": "{{properties.closedate.value}}",
+        "type": "string",
+        "description": "Expected close date",
+        "required": false
+      },
+      "dealType": {
+        "expression": "{{properties.dealtype.value}} | trim",
+        "type": "string",
+        "description": "Deal type",
+        "required": false
+      },
+      "associatedCompany": {
+        "expression": "{{associations.companies.results[0].id}}",
+        "type": "string",
+        "description": "Associated company ID",
+        "required": false
+      },
+      "associatedContacts": {
+        "expression": "{{associations.contacts.results}}",
+        "type": "array",
+        "description": "Array of associated contact IDs",
+        "required": false
+      },
+      "createdAt": {
+        "expression": "{{properties.createdate.value}}",
+        "type": "string",
+        "description": "Creation timestamp",
+        "required": false
+      },
+      "updatedAt": {
+        "expression": "{{properties.hs_lastmodifieddate.value}}",
+        "type": "string",
+        "description": "Last modification timestamp",
+        "required": false
+      }
+    }
+  },
+  "exposed": {
+    "fields": ["id", "dealName", "amount", "currency", "stage", "pipeline", "closeDate", "dealType", "associatedCompany", "associatedContacts", "createdAt", "updatedAt"],
+    "description": "Exposed fields for HubSpot deals"
+  },
+  "openapi": {
+    "enabled": true,
+    "documentKey": "hubspot-v3",
+    "baseUrl": "https://api.hubapi.com",
+    "operations": {
+      "list": {
+        "operationId": "getDeals",
+        "method": "GET",
+        "path": "/crm/v3/objects/deals"
+      },
+      "get": {
+        "operationId": "getDeal",
+        "method": "GET",
+        "path": "/crm/v3/objects/deals/{dealId}"
+      },
+      "create": {
+        "operationId": "createDeal",
+        "method": "POST",
+        "path": "/crm/v3/objects/deals"
+      },
+      "update": {
+        "operationId": "updateDeal",
+        "method": "PATCH",
+        "path": "/crm/v3/objects/deals/{dealId}"
+      },
+      "delete": {
+        "operationId": "deleteDeal",
+        "method": "DELETE",
+        "path": "/crm/v3/objects/deals/{dealId}"
+      }
+    },
+    "autoRbac": true
+  }
+}
+

package/integration/hubspot/hubspot-deploy.json

@@ -0,0 +1,91 @@
+{
+  "key": "hubspot",
+  "displayName": "HubSpot CRM",
+  "description": "HubSpot CRM integration with OpenAPI support for companies, contacts, and deals",
+  "type": "openapi",
+  "enabled": true,
+  "environment": {
+    "baseUrl": "https://api.hubapi.com"
+  },
+  "authentication": {
+    "type": "oauth2",
+    "mode": "oauth2",
+    "oauth2": {
+      "tokenUrl": "{{TOKENURL}}",
+      "clientId": "{{CLIENTID}}",
+      "clientSecret": "{{CLIENTSECRET}}",
+      "scopes": [
+        "crm.objects.companies.read",
+        "crm.objects.companies.write",
+        "crm.objects.contacts.read",
+        "crm.objects.contacts.write",
+        "crm.objects.deals.read",
+        "crm.objects.deals.write"
+      ]
+    }
+  },
+  "configuration": [
+    {
+      "name": "CLIENTID",
+      "value": "hubspot-clientidKeyVault",
+      "location": "keyvault",
+      "required": true
+    },
+    {
+      "name": "CLIENTSECRET",
+      "value": "hubspot-clientsecretKeyVault",
+      "location": "keyvault",
+      "required": true
+    },
+    {
+      "name": "TOKENURL",
+      "value": "https://api.hubapi.com/oauth/v1/token",
+      "location": "variable",
+      "required": true
+    },
+    {
+      "name": "REDIRECT_URI",
+      "value": "hubspot-redirect-uriKeyVault",
+      "location": "keyvault",
+      "required": false
+    },
+    {
+      "name": "HUBSPOT_API_VERSION",
+      "value": "v3",
+      "location": "variable",
+      "required": false,
+      "portalInput": {
+        "field": "select",
+        "label": "HubSpot API Version",
+        "placeholder": "Select API version",
+        "options": ["v1", "v2", "v3"],
+        "validation": {
+          "required": false
+        }
+      }
+    },
+    {
+      "name": "MAX_PAGE_SIZE",
+      "value": "100",
+      "location": "variable",
+      "required": false,
+      "portalInput": {
+        "field": "text",
+        "label": "Maximum Page Size",
+        "placeholder": "100",
+        "validation": {
+          "required": false,
+          "pattern": "^[0-9]+$",
+          "min": 1,
+          "max": 1000
+        }
+      }
+    }
+  ],
+  "openapi": {
+    "documentKey": "hubspot-v3",
+    "autoDiscoverEntities": false
+  },
+  "tags": ["crm", "sales", "marketing", "hubspot"]
+}
+

package/integration/hubspot/variables.yaml

@@ -0,0 +1,17 @@
+app:
+  key: hubspot
+  displayName: "HubSpot CRM Integration"
+  description: "HubSpot CRM external system integration with companies, contacts, and deals"
+  type: external
+
+externalIntegration:
+  schemaBasePath: ./
+  systems:
+    - hubspot-deploy.json
+  dataSources:
+    - hubspot-deploy-company.json
+    - hubspot-deploy-contact.json
+    - hubspot-deploy-deal.json
+  autopublish: true
+  version: 1.0.0
+

package/lib/app-config.js

@@ -54,6 +54,11 @@ async function generateVariablesYamlFile(appPath, appName, config) {
  * @param {Object} existingEnv - Existing environment variables
  */
 async function generateEnvTemplateFile(appPath, config, existingEnv) {
+  // Skip env.template for external type
+  if (config.type === 'external') {
+    return;
+  }
+
   const envTemplatePath = path.join(appPath, 'env.template');
   if (!(await fileExists(envTemplatePath))) {
     let envTemplate;
@@ -94,13 +99,18 @@ async function generateRbacYamlFile(appPath, appName, config) {
 }
 
 /**
- * Generates aifabrix-deploy.json file
+ * Generates <app-name>-deploy.json file (consistent naming for all apps)
  * @async
  * @param {string} appPath - Path to application directory
  * @param {string} appName - Application name
  * @param {Object} config - Application configuration
  */
 async function generateDeployJsonFile(appPath, appName, config) {
+  // Skip for external type (external system JSON is generated separately)
+  if (config.type === 'external') {
+    return;
+  }
+
   const deployJson = {
     apiVersion: 'v1',
     kind: 'ApplicationDeployment',
@@ -128,8 +138,9 @@ async function generateDeployJsonFile(appPath, appName, config) {
     }
   };
 
+  // Use consistent naming: <app-name>-deploy.json
   await fs.writeFile(
-    path.join(appPath, 'aifabrix-deploy.json'),
+    path.join(appPath, `${appName}-deploy.json`),
     JSON.stringify(deployJson, null, 2)
   );
 }

package/lib/app-deploy.js

@@ -17,6 +17,7 @@ const pushUtils = require('./push');
 const logger = require('./utils/logger');
 const config = require('./config');
 const { getDeploymentAuth } = require('./utils/token-manager');
+const { detectAppType } = require('./utils/paths');
 
 /**
  * Validate application name format
@@ -215,10 +216,11 @@ function validateDeploymentConfig(deploymentConfig) {
  * @throws {Error} If configuration is invalid
  */
 async function loadDeploymentConfig(appName, options) {
-  const builderPath = path.join(process.cwd(), 'builder', appName);
-  await validateAppDirectory(builderPath, appName);
+  // Detect app type and get correct path (integration or builder)
+  const { appPath } = await detectAppType(appName);
+  await validateAppDirectory(appPath, appName);
 
-  const variablesPath = path.join(builderPath, 'variables.yaml');
+  const variablesPath = path.join(appPath, 'variables.yaml');
   const variables = await loadVariablesFile(variablesPath);
 
   const deploymentConfig = extractDeploymentConfig(options, variables);
@@ -366,6 +368,10 @@ async function deployApp(appName, options = {}) {
 
     validateAppName(appName);
 
+    // 2. Check if app type is external - use normal deployment flow with application-schema.json
+    // External systems now deploy via miso controller as normal application (full application file)
+    // The json command generates application-schema.json which is used for deployment
+
     // 2. Load deployment configuration
     config = await loadDeploymentConfig(appName, options);
     controllerUrl = config.controllerUrl || options.controller || 'unknown';

package/lib/app-dockerfile.js

@@ -84,11 +84,24 @@ async function generateAndCopyDockerfile(appPath, dockerfilePath, config) {
  * @returns {Promise<string>} Path to generated Dockerfile
  */
 async function generateDockerfileForApp(appName, options = {}) {
+  // Check if app type is external - skip Dockerfile generation
+  const { detectAppType } = require('./utils/paths');
+  try {
+    const { isExternal } = await detectAppType(appName);
+    if (isExternal) {
+      logger.log(chalk.yellow('⚠️  External systems don\'t require Dockerfiles. Skipping...'));
+      return null;
+    }
+  } catch (error) {
+    // If detection fails, continue with normal generation
+    // (detectAppType throws if app doesn't exist, which is fine for dockerfile command)
+  }
   try {
     // Validate app name
     validateAppName(appName);
 
-    const appPath = path.join(process.cwd(), 'builder', appName);
+    // Detect app type and get correct path (integration or builder)
+    const { appPath } = await detectAppType(appName);
     const dockerfilePath = path.join(appPath, 'Dockerfile');
 
     // Check if Dockerfile already exists