@aifabrix/builder 2.52.1 → 2.53.1

package/integration/hubspot-test/create-hubspot.js

@@ -1,523 +0,0 @@
-#!/usr/bin/env node
-/* eslint-disable max-lines */
-/**
- * HubSpot Integration Creation Helper Script
- *
- * Creates a new HubSpot integration using the wizard and prepares files for manual editing
- *
- * @fileoverview Helper script for creating HubSpot integrations
- * @author AI Fabrix Team
- * @version 2.0.0
- */
-'use strict';
-
-const fs = require('fs').promises;
-const path = require('path');
-const { execFile } = require('child_process');
-const { promisify } = require('util');
-const yaml = require('js-yaml');
-const chalk = require('chalk');
-const logger = require('../../lib/utils/logger');
-
-const execFileAsync = promisify(execFile);
-
-const DEFAULT_CONTROLLER_URL = process.env.CONTROLLER_URL || 'http://localhost:3110';
-const DEFAULT_ENVIRONMENT = process.env.ENVIRONMENT || 'miso';
-const DEFAULT_OPENAPI_FILE = process.env.HUBSPOT_OPENAPI_FILE ||
-  path.join(process.cwd(), 'integration', 'hubspot-test', 'companies.json');
-
-/**
- * Prints usage information
- * @function printUsage
- * @returns {void}
- */
-function printUsage() {
-  logger.log([
-    'Usage:',
-    '  node integration/hubspot-test/create-hubspot.js [options]',
-    '',
-    'Options:',
-    '  --name <name>              Application name (required)',
-    '  --openapi <path>           Path to OpenAPI file (default: env HUBSPOT_OPENAPI_FILE)',
-    '  --output <dir>             Output directory for files (default: integration/<name>)',
-    '  --controller <url>         Controller URL (default: env CONTROLLER_URL)',
-    '  --environment <env>        Environment name (default: env ENVIRONMENT)',
-    '  --keep-wizard-files        Keep wizard-generated files in integration/ directory',
-    '  --help                     Show this help message',
-    '',
-    'Examples:',
-    '  node integration/hubspot-test/create-hubspot.js --name my-hubspot',
-    '  node integration/hubspot-test/create-hubspot.js --name my-hubspot --output ~/my-project',
-    '  node integration/hubspot-test/create-hubspot.js --name my-hubspot --openapi /path/to/openapi.json'
-  ].join('\n'));
-}
-
-/**
- * Parses command line arguments
- * @function parseArgs
- * @param {string[]} argv - Command line arguments
- * @returns {Object} Parsed arguments
- */
-function parseArgs(argv) {
-  const args = {
-    name: null,
-    openapi: DEFAULT_OPENAPI_FILE,
-    output: null,
-    controller: DEFAULT_CONTROLLER_URL,
-    environment: DEFAULT_ENVIRONMENT,
-    keepWizardFiles: false,
-    help: false
-  };
-
-  const flagMap = {
-    '--name': 'name',
-    '--openapi': 'openapi',
-    '--output': 'output',
-    '--controller': 'controller',
-    '--environment': 'environment'
-  };
-
-  for (let i = 2; i < argv.length; i += 1) {
-    const arg = argv[i];
-    const argKey = flagMap[arg];
-
-    if (argKey && argv[i + 1]) {
-      args[argKey] = argv[i + 1];
-      i += 1;
-      continue;
-    }
-
-    if (arg === '--keep-wizard-files') {
-      args.keepWizardFiles = true;
-      continue;
-    }
-
-    if (arg === '--help' || arg === '-h') {
-      args.help = true;
-    }
-  }
-
-  return args;
-}
-
-/**
- * Logs info message
- * @function logInfo
- * @param {string} message - Message to log
- * @returns {void}
- */
-function logInfo(message) {
-  logger.log(chalk.cyan(message));
-}
-
-/**
- * Logs success message
- * @function logSuccess
- * @param {string} message - Message to log
- * @returns {void}
- */
-function logSuccess(message) {
-  logger.log(chalk.green(message));
-}
-
-/**
- * Logs error message
- * @function logError
- * @param {string} message - Message to log
- * @returns {void}
- */
-function logError(message) {
-  logger.error(chalk.red(message));
-}
-
-/**
- * Checks if file exists
- * @async
- * @function fileExists
- * @param {string} filePath - File path to check
- * @returns {Promise<boolean>} True if file exists
- */
-async function fileExists(filePath) {
-  try {
-    await fs.access(filePath);
-    return true;
-  } catch {
-    return false;
-  }
-}
-
-/**
- * Ensures directory exists
- * @async
- * @function ensureDir
- * @param {string} dirPath - Directory path
- * @returns {Promise<void>} Resolves when directory is created
- */
-async function ensureDir(dirPath) {
-  await fs.mkdir(dirPath, { recursive: true });
-}
-
-/**
- * Creates wizard configuration file
- * @async
- * @function createWizardConfig
- * @param {string} appName - Application name
- * @param {string} openapiFile - OpenAPI file path
- * @param {string} controllerUrl - Controller URL
- * @param {string} environment - Environment name
- * @returns {Promise<string>} Path to created config file
- */
-async function createWizardConfig(appName, openapiFile, controllerUrl, environment) {
-  const configDir = path.join(process.cwd(), 'integration', 'hubspot');
-  await ensureDir(configDir);
-  const configPath = path.join(configDir, `wizard-${appName}.yaml`);
-
-  const config = {
-    appName,
-    mode: 'create-system',
-    source: {
-      type: 'openapi-file',
-      filePath: openapiFile
-    },
-    credential: {
-      action: 'skip'
-    },
-    preferences: {
-      intent: `HubSpot CRM integration for ${appName}`,
-      fieldOnboardingLevel: 'full',
-      enableOpenAPIGeneration: true,
-      enableABAC: true,
-      enableRBAC: false
-    },
-    deployment: {
-      controller: controllerUrl,
-      environment
-    }
-  };
-
-  const yamlContent = yaml.dump(config, { lineWidth: -1, noRefs: true });
-  await fs.writeFile(configPath, yamlContent, 'utf8');
-  return configPath;
-}
-
-/**
- * Builds wizard command arguments
- * @function buildWizardArgs
- * @param {string} configPath - Path to wizard config file
- * @param {string} controllerUrl - Controller URL
- * @param {string} environment - Environment name
- * @returns {string[]} Command arguments
- */
-function buildWizardArgs(configPath, controllerUrl, environment) {
-  return [
-    'bin/aifabrix.js',
-    'wizard',
-    '--config',
-    configPath,
-    '--controller',
-    controllerUrl,
-    '--environment',
-    environment
-  ];
-}
-
-/**
- * Handles wizard command execution errors
- * @function handleWizardError
- * @param {Error} error - Error object
- * @param {string|null} dataplaneUrl - Dataplane URL (for error context; may be null when auto-discovered)
- * @returns {Object} Error result object
- */
-function handleWizardError(error, dataplaneUrl) {
-  const baseResult = {
-    success: false,
-    stdout: error.stdout || '',
-    stderr: error.stderr || ''
-  };
-
-  // Check for timeout
-  if (error.code === 'ETIMEDOUT' || error.signal === 'SIGTERM') {
-    const dataplaneInfo = dataplaneUrl ? `dataplane at ${dataplaneUrl}` : 'dataplane (auto-discovered)';
-    return {
-      ...baseResult,
-      error: `Wizard command timed out after 2 minutes. This usually indicates the ${dataplaneInfo} is down or unreachable.\n\n` +
-             'Please ensure the dataplane service is running and accessible, then try again.'
-    };
-  }
-
-  // Check for connection errors
-  const errorOutput = (error.stdout || '') + (error.stderr || '') + (error.message || '');
-  const lowerOutput = errorOutput.toLowerCase();
-  const isConnectionError = lowerOutput.includes('dataplane') ||
-    lowerOutput.includes('connection') ||
-    lowerOutput.includes('timeout') ||
-    lowerOutput.includes('econnrefused');
-
-  if (isConnectionError) {
-    return {
-      ...baseResult,
-      error: `Wizard failed: ${error.message}\n\nThis may be due to dataplane connectivity issues. Ensure the dataplane service is running at ${dataplaneUrl || 'the discovered URL'}.`
-    };
-  }
-
-  return { ...baseResult, error: error.message };
-}
-
-/**
- * Runs wizard command
- * @async
- * @function runWizard
- * @param {string} configPath - Path to wizard config file
- * @param {string} controllerUrl - Controller URL
- * @param {string} environment - Environment name
- * @returns {Promise<Object>} Command result object
- */
-async function runWizard(configPath, controllerUrl, environment) {
-  logInfo('Note: Dataplane URL is auto-discovered from the controller.');
-  const args = buildWizardArgs(configPath, controllerUrl, environment);
-
-  try {
-    const result = await execFileAsync('node', args, {
-      cwd: process.cwd(),
-      env: { ...process.env },
-      maxBuffer: 10 * 1024 * 1024,
-      timeout: 2 * 60 * 1000
-    });
-    return { success: true, stdout: result.stdout || '', stderr: result.stderr || '' };
-  } catch (error) {
-    return handleWizardError(error, null);
-  }
-}
-
-/**
- * Lists files in directory
- * @async
- * @function listFiles
- * @param {string} dirPath - Directory path
- * @returns {Promise<string[]>} Array of file names
- */
-async function listFiles(dirPath) {
-  try {
-    const entries = await fs.readdir(dirPath, { withFileTypes: true });
-    return entries
-      .filter(entry => entry.isFile())
-      .map(entry => entry.name);
-  } catch {
-    return [];
-  }
-}
-
-/**
- * Copies file
- * @async
- * @function copyFile
- * @param {string} src - Source file path
- * @param {string} dest - Destination file path
- * @returns {Promise<void>} Resolves when file is copied
- */
-async function copyFile(src, dest) {
-  await ensureDir(path.dirname(dest));
-  await fs.copyFile(src, dest);
-}
-
-/**
- * Copies directory contents
- * @async
- * @function copyDirectoryContents
- * @param {string} srcDir - Source directory
- * @param {string} destDir - Destination directory
- * @returns {Promise<string[]>} Array of copied file names
- */
-async function copyDirectoryContents(srcDir, destDir) {
-  await ensureDir(destDir);
-  const files = await listFiles(srcDir);
-  const copiedFiles = [];
-
-  for (const fileName of files) {
-    const srcPath = path.join(srcDir, fileName);
-    const destPath = path.join(destDir, fileName);
-    await copyFile(srcPath, destPath);
-    copiedFiles.push(fileName);
-  }
-
-  return copiedFiles;
-}
-
-/**
- * Validates command line arguments
- * @function validateArgs
- * @param {Object} args - Parsed arguments
- * @returns {void}
- * @throws {Error} If validation fails
- */
-function validateArgs(args) {
-  if (!args.name) {
-    throw new Error('--name is required');
-  }
-
-  if (!/^[a-z0-9-_]+$/.test(args.name)) {
-    throw new Error('App name must contain only lowercase letters, numbers, hyphens, and underscores');
-  }
-}
-
-/**
- * Validates OpenAPI file exists
- * @async
- * @function validateOpenApiFile
- * @param {string} openapiPath - OpenAPI file path
- * @returns {Promise<void>} Resolves if file exists
- * @throws {Error} If file doesn't exist
- */
-async function validateOpenApiFile(openapiPath) {
-  if (!(await fileExists(openapiPath))) {
-    throw new Error(`OpenAPI file not found: ${openapiPath}`);
-  }
-}
-
-/**
- * Handles wizard execution
- * @async
- * @function executeWizard
- * @param {Object} args - Parsed arguments
- * @returns {Promise<string>} Path to wizard config file
- */
-async function executeWizard(args) {
-  logInfo('\n1. Creating wizard configuration...');
-  const configPath = await createWizardConfig(
-    args.name,
-    args.openapi,
-    args.controller,
-    args.environment
-  );
-  logSuccess(`✔ Created config: ${configPath}`);
-
-  logInfo('\n2. Running wizard...');
-  const wizardResult = await runWizard(configPath, args.controller, args.environment);
-
-  if (!wizardResult.success) {
-    logError('Wizard failed:');
-    if (wizardResult.stdout) {
-      logger.log(wizardResult.stdout);
-    }
-    if (wizardResult.stderr) {
-      logger.error(wizardResult.stderr);
-    }
-    throw new Error('Wizard execution failed');
-  }
-
-  logSuccess('✔ Wizard completed successfully');
-  return configPath;
-}
-
-/**
- * Processes generated files
- * @async
- * @function processGeneratedFiles
- * @param {Object} args - Parsed arguments
- * @returns {Promise<string>} Output directory path
- */
-async function processGeneratedFiles(args) {
-  const wizardOutputDir = path.join(process.cwd(), 'integration', args.name);
-  if (!(await fileExists(wizardOutputDir))) {
-    throw new Error(`Wizard output directory not found: ${wizardOutputDir}`);
-  }
-
-  const generatedFiles = await listFiles(wizardOutputDir);
-  logInfo(`\n3. Generated files: ${generatedFiles.join(', ')}`);
-
-  const outputDir = args.output || wizardOutputDir;
-  if (outputDir !== wizardOutputDir) {
-    logInfo(`\n4. Copying files to: ${outputDir}`);
-    const copiedFiles = await copyDirectoryContents(wizardOutputDir, outputDir);
-    logSuccess(`✔ Copied ${copiedFiles.length} files`);
-  } else {
-    logInfo(`\n4. Files are in: ${outputDir}`);
-  }
-
-  return { outputDir, wizardOutputDir };
-}
-
-/**
- * Prints summary information
- * @async
- * @function printSummary
- * @param {string} outputDir - Output directory path
- * @param {string} appName - Application name
- * @param {string} environment - Environment name
- * @returns {Promise<void>} Resolves when summary is printed
- */
-async function printSummary(outputDir, appName, environment) {
-  logSuccess('\n✔ HubSpot integration created successfully!');
-  logger.log('\nGenerated files:');
-  const files = await listFiles(outputDir);
-  for (const file of files) {
-    logger.log(`  - ${file}`);
-  }
-
-  logger.log('\nNext steps:');
-  logger.log(`  1. Review files in: ${outputDir}`);
-  logger.log('  2. Edit hubspot-system.json and datasource files as needed');
-  logger.log(`  3. Validate: node bin/aifabrix.js validate ${appName}`);
-  logger.log(`  4. Deploy: node bin/aifabrix.js deploy ${appName} --environment ${environment}`);
-}
-
-/**
- * Cleans up temporary files
- * @async
- * @function cleanupFiles
- * @param {string} configPath - Config file path
- * @param {string} wizardOutputDir - Wizard output directory
- * @param {string} outputDir - Final output directory
- * @param {boolean} keepWizardFiles - Whether to keep wizard files
- * @returns {Promise<void>} Resolves when cleanup is complete
- */
-async function cleanupFiles(configPath, wizardOutputDir, outputDir, keepWizardFiles) {
-  if (!keepWizardFiles && outputDir !== wizardOutputDir) {
-    logInfo('\n5. Cleaning up wizard files...');
-    await fs.rm(wizardOutputDir, { recursive: true, force: true });
-    logSuccess('✔ Cleaned up wizard files');
-  }
-
-  await fs.unlink(configPath).catch(() => {
-    // Ignore errors
-  });
-}
-
-/**
- * Main function
- * @async
- * @function main
- * @returns {Promise<void>} Resolves when complete
- */
-async function main() {
-  const args = parseArgs(process.argv);
-
-  if (args.help) {
-    printUsage();
-    return;
-  }
-
-  try {
-    validateArgs(args);
-    await validateOpenApiFile(args.openapi);
-
-    logInfo(`Creating HubSpot integration: ${args.name}`);
-    logInfo(`OpenAPI file: ${args.openapi}`);
-    logInfo(`Controller: ${args.controller}`);
-    logInfo(`Environment: ${args.environment}`);
-    const configPath = await executeWizard(args);
-    const { outputDir, wizardOutputDir } = await processGeneratedFiles(args);
-    await printSummary(outputDir, args.name, args.environment);
-    await cleanupFiles(configPath, wizardOutputDir, outputDir, args.keepWizardFiles);
-  } catch (error) {
-    logError(`Error: ${error.message}`);
-    if (error.stack) {
-      logger.error(error.stack);
-    }
-    process.exit(1);
-  }
-}
-main().catch(error => {
-  logError(`Unexpected error: ${error.message}`);
-  process.exit(1);
-});

package/integration/hubspot-test/env.template

@@ -1,4 +0,0 @@
-HUBSPOT_API_VERSION=v3
-MAX_PAGE_SIZE=100
-KV_HUBSPOT_TEST_CLIENTID=kv://hubspot-test/clientId
-KV_HUBSPOT_TEST_CLIENTSECRET=kv://hubspot-test/clientSecret

package/integration/hubspot-test/hubspot-test-datasource-company.json

@@ -1,138 +0,0 @@
-{
-  "key": "hubspot-test-company",
-  "displayName": "HubSpot Company",
-  "description": "HubSpot companies datasource with field mappings for CRM company data",
-  "systemKey": "hubspot-test",
-  "entityType": "recordStorage",
-  "resourceType": "customer",
-  "enabled": true,
-  "version": "1.0.0",
-  "primaryKey": [
-    "id"
-  ],
-  "labelKey": [
-    "name"
-  ],
-  "metadataSchema": {
-    "type": "object",
-    "required": [
-      "id",
-      "externalId",
-      "properties"
-    ],
-    "properties": {
-      "id": {
-        "type": "string",
-        "index": true
-      },
-      "externalId": {
-        "type": "string",
-        "index": true
-      },
-      "name": {
-        "type": "string",
-        "filter": true
-      },
-      "properties": {
-        "type": "object",
-        "additionalProperties": true
-      }
-    }
-  },
-  "dimensions": {
-    "country": {
-      "type": "local",
-      "field": "country"
-    },
-    "domain": {
-      "type": "local",
-      "field": "domain"
-    }
-  },
-  "fieldMappings": {
-    "attributes": {
-      "id": {
-        "expression": "{{raw.id}}"
-      },
-      "externalId": {
-        "expression": "{{raw.id}}"
-      },
-      "name": {
-        "expression": "{{raw.properties.name.value}} | trim"
-      },
-      "domain": {
-        "expression": "{{raw.properties.domain.value}} | toLower | trim"
-      },
-      "country": {
-        "expression": "{{raw.properties.country.value}} | toUpper | trim"
-      },
-      "city": {
-        "expression": "{{raw.properties.city.value}} | trim"
-      },
-      "industry": {
-        "expression": "{{raw.properties.industry.value}} | trim"
-      },
-      "website": {
-        "expression": "{{raw.properties.website.value}} | trim"
-      },
-      "phone": {
-        "expression": "{{raw.properties.phone.value}} | trim"
-      },
-      "createdAt": {
-        "expression": "{{raw.properties.createdate.value}}"
-      },
-      "updatedAt": {
-        "expression": "{{raw.properties.hs_lastmodifieddate.value}}"
-      }
-    }
-  },
-  "exposed": {
-    "description": "Exposed fields for HubSpot companies",
-    "schema": {
-      "id": "metadata.id",
-      "externalId": "metadata.externalId",
-      "name": "metadata.name",
-      "domain": "metadata.domain",
-      "country": "metadata.country",
-      "city": "metadata.city",
-      "industry": "metadata.industry",
-      "website": "metadata.website",
-      "phone": "metadata.phone",
-      "createdAt": "metadata.createdAt",
-      "updatedAt": "metadata.updatedAt"
-    }
-  },
-  "openapi": {
-    "enabled": true,
-    "documentKey": "hubspot-v3",
-    "baseUrl": "https://api.hubapi.com",
-    "operations": {
-      "list": {
-        "operationId": "getCompanies",
-        "method": "GET",
-        "path": "/crm/v3/objects/companies"
-      },
-      "get": {
-        "operationId": "getCompany",
-        "method": "GET",
-        "path": "/crm/v3/objects/companies/{companyId}"
-      },
-      "create": {
-        "operationId": "createCompany",
-        "method": "POST",
-        "path": "/crm/v3/objects/companies"
-      },
-      "update": {
-        "operationId": "updateCompany",
-        "method": "PATCH",
-        "path": "/crm/v3/objects/companies/{companyId}"
-      },
-      "delete": {
-        "operationId": "deleteCompany",
-        "method": "DELETE",
-        "path": "/crm/v3/objects/companies/{companyId}"
-      }
-    },
-    "autoRbac": true
-  }
-}