@aifabrix/builder 2.31.1 → 2.32.1

package/README.md

@@ -23,7 +23,7 @@ aifabrix down myapp
 # aifabrix down myapp --volumes
 ```
 
-→ [Full Guide](docs/QUICK-START.md) | [CLI Commands](docs/CLI-REFERENCE.md)
+→ [Full Guide](docs/quick-start.md) | [CLI Commands](docs/cli-reference.md)
 
 ## What You Get
 
@@ -48,17 +48,17 @@ aifabrix build miso-controller
 aifabrix run miso-controller
 ```
 
-→ [Infrastructure Guide](docs/INFRASTRUCTURE.md)
+→ [Infrastructure Guide](docs/infrastructure.md)
 
 ## Documentation
 
-- [Quick Start](docs/QUICK-START.md) - Get running in 5 minutes
-- [Infrastructure](docs/INFRASTRUCTURE.md) - What runs and why
-- [Configuration](docs/CONFIGURATION.md) - Config file reference
-- [Building](docs/BUILDING.md) - Build process explained
-- [Running](docs/RUNNING.md) - Run apps locally
-- [Deploying](docs/DEPLOYING.md) - Deploy to Azure
-- [CLI Reference](docs/CLI-REFERENCE.md) - All commands
+- [Quick Start](docs/quick-start.md) - Get running in 5 minutes
+- [Infrastructure](docs/infrastructure.md) - What runs and why
+- [Configuration](docs/configuration.md) - Config file reference
+- [Building](docs/building.md) - Build process explained
+- [Running](docs/running.md) - Run apps locally
+- [Deploying](docs/deploying.md) - Deploy to Azure
+- [CLI Reference](docs/cli-reference.md) - All commands
 
 ## How It Works
 

package/integration/hubspot/README.md

@@ -129,8 +129,8 @@ aifabrix datasource validate hubspot-company --environment dev
 
 ## Documentation
 
-- [External Systems Guide](../../docs/EXTERNAL-SYSTEMS.md) - Complete guide with examples
-- [CLI Reference](../../docs/CLI-REFERENCE.md) - All commands
+- [External Systems Guide](../../docs/external-systems.md) - Complete guide with examples
+- [CLI Reference](../../docs/cli-reference.md) - All commands
 - [Configuration Reference](../../docs/CONFIGURATION.md) - Config file details
 
 

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

@@ -3,7 +3,7 @@
   "displayName": "HubSpot Company",
   "description": "HubSpot companies datasource with field mappings for CRM company data",
   "systemKey": "hubspot",
-  "entityKey": "company",
+  "entityType": "company",
   "resourceType": "customer",
   "enabled": true,
   "version": "1.0.0",
@@ -94,72 +94,75 @@
     "required": ["id", "properties"]
   },
   "fieldMappings": {
-    "accessFields": ["country", "domain"],
-    "fields": {
+    "dimensions": {
+      "country": "metadata.country",
+      "domain": "metadata.domain"
+    },
+    "attributes": {
       "id": {
         "expression": "{{id}}",
         "type": "string",
         "description": "Unique company identifier",
-        "required": true
+        "indexed": true
       },
       "name": {
         "expression": "{{properties.name.value}} | trim",
         "type": "string",
         "description": "Company name",
-        "required": false
+        "indexed": false
       },
       "domain": {
         "expression": "{{properties.domain.value}} | toLower | trim",
         "type": "string",
         "description": "Company domain for ABAC filtering",
-        "required": false
+        "indexed": false
       },
       "country": {
         "expression": "{{properties.country.value}} | toUpper | trim",
         "type": "string",
         "description": "Country code for ABAC filtering",
-        "required": false
+        "indexed": false
       },
       "city": {
         "expression": "{{properties.city.value}} | trim",
         "type": "string",
         "description": "City name",
-        "required": false
+        "indexed": false
       },
       "industry": {
         "expression": "{{properties.industry.value}} | trim",
         "type": "string",
         "description": "Industry classification",
-        "required": false
+        "indexed": false
       },
       "website": {
         "expression": "{{properties.website.value}} | trim",
         "type": "string",
         "description": "Company website URL",
-        "required": false
+        "indexed": false
       },
       "phone": {
         "expression": "{{properties.phone.value}} | trim",
         "type": "string",
         "description": "Phone number",
-        "required": false
+        "indexed": false
       },
       "createdAt": {
         "expression": "{{properties.createdate.value}}",
         "type": "string",
         "description": "Creation timestamp",
-        "required": false
+        "indexed": false
       },
       "updatedAt": {
         "expression": "{{properties.hs_lastmodifieddate.value}}",
         "type": "string",
         "description": "Last modification timestamp",
-        "required": false
+        "indexed": false
       }
     }
   },
   "exposed": {
-    "fields": ["id", "name", "domain", "country", "city", "industry", "website", "phone", "createdAt", "updatedAt"],
+    "attributes": ["id", "name", "domain", "country", "city", "industry", "website", "phone", "createdAt", "updatedAt"],
     "description": "Exposed fields for HubSpot companies"
   },
   "openapi": {

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

@@ -3,7 +3,7 @@
   "displayName": "HubSpot Contact",
   "description": "HubSpot contacts datasource with field mappings for CRM contact data",
   "systemKey": "hubspot",
-  "entityKey": "contact",
+  "entityType": "contact",
   "resourceType": "contact",
   "enabled": true,
   "version": "1.0.0",
@@ -110,84 +110,87 @@
     "required": ["id", "properties"]
   },
   "fieldMappings": {
-    "accessFields": ["email", "country"],
-    "fields": {
+    "dimensions": {
+      "email": "metadata.email",
+      "country": "metadata.country"
+    },
+    "attributes": {
       "id": {
         "expression": "{{id}}",
         "type": "string",
         "description": "Unique contact identifier",
-        "required": true
+        "indexed": true
       },
       "firstName": {
         "expression": "{{properties.firstname.value}} | trim",
         "type": "string",
         "description": "First name",
-        "required": false
+        "indexed": false
       },
       "lastName": {
         "expression": "{{properties.lastname.value}} | trim",
         "type": "string",
         "description": "Last name",
-        "required": false
+        "indexed": false
       },
       "email": {
         "expression": "{{properties.email.value}} | toLower | trim",
         "type": "string",
         "description": "Email address for ABAC filtering",
-        "required": false
+        "indexed": false
       },
       "phone": {
         "expression": "{{properties.phone.value}} | trim",
         "type": "string",
         "description": "Phone number",
-        "required": false
+        "indexed": false
       },
       "company": {
         "expression": "{{properties.company.value}} | trim",
         "type": "string",
         "description": "Associated company name",
-        "required": false
+        "indexed": false
       },
       "jobTitle": {
         "expression": "{{properties.jobtitle.value}} | trim",
         "type": "string",
         "description": "Job title",
-        "required": false
+        "indexed": false
       },
       "address": {
         "expression": "{{properties.address.value}} | trim",
         "type": "string",
         "description": "Street address",
-        "required": false
+        "indexed": false
       },
       "city": {
         "expression": "{{properties.city.value}} | trim",
         "type": "string",
         "description": "City name",
-        "required": false
+        "indexed": false
       },
       "country": {
         "expression": "{{properties.country.value}} | toUpper | trim",
         "type": "string",
         "description": "Country code for ABAC filtering",
-        "required": false
+        "indexed": false
       },
       "createdAt": {
         "expression": "{{properties.createdate.value}}",
         "type": "string",
         "description": "Creation timestamp",
-        "required": false
+        "indexed": false
       },
       "updatedAt": {
         "expression": "{{properties.hs_lastmodifieddate.value}}",
         "type": "string",
         "description": "Last modification timestamp",
-        "required": false
+        "indexed": false
       }
     }
   },
   "exposed": {
-    "fields": ["id", "firstName", "lastName", "email", "phone", "company", "jobTitle", "address", "city", "country", "createdAt", "updatedAt"],
+    "attributes": ["id", "firstName", "lastName", "email", "phone", "company", "jobTitle", "address", "city", "country", "createdAt", "updatedAt"],
     "description": "Exposed fields for HubSpot contacts"
   },
   "openapi": {

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

@@ -3,7 +3,7 @@
   "displayName": "HubSpot Deal",
   "description": "HubSpot deals datasource with field mappings for CRM deal data",
   "systemKey": "hubspot",
-  "entityKey": "deal",
+  "entityType": "deal",
   "resourceType": "deal",
   "enabled": true,
   "version": "1.0.0",
@@ -131,84 +131,87 @@
     "required": ["id", "properties"]
   },
   "fieldMappings": {
-    "accessFields": ["stage", "pipeline"],
-    "fields": {
+    "dimensions": {
+      "stage": "metadata.stage",
+      "pipeline": "metadata.pipeline"
+    },
+    "attributes": {
       "id": {
         "expression": "{{id}}",
         "type": "string",
         "description": "Unique deal identifier",
-        "required": true
+        "indexed": true
       },
       "dealName": {
         "expression": "{{properties.dealname.value}} | trim",
         "type": "string",
         "description": "Deal name",
-        "required": false
+        "indexed": false
       },
       "amount": {
         "expression": "{{properties.amount.value}}",
         "type": "string",
         "description": "Deal amount",
-        "required": false
+        "indexed": false
       },
       "currency": {
         "expression": "{{properties.deal_currency_code.value}} | toUpper | trim",
         "type": "string",
         "description": "Currency code",
-        "required": false
+        "indexed": false
       },
       "stage": {
         "expression": "{{properties.dealstage.value}} | trim",
         "type": "string",
         "description": "Deal stage for ABAC filtering",
-        "required": false
+        "indexed": false
       },
       "pipeline": {
         "expression": "{{properties.pipeline.value}} | trim",
         "type": "string",
         "description": "Pipeline name for ABAC filtering",
-        "required": false
+        "indexed": false
       },
       "closeDate": {
         "expression": "{{properties.closedate.value}}",
         "type": "string",
         "description": "Expected close date",
-        "required": false
+        "indexed": false
       },
       "dealType": {
         "expression": "{{properties.dealtype.value}} | trim",
         "type": "string",
         "description": "Deal type",
-        "required": false
+        "indexed": false
       },
       "associatedCompany": {
-        "expression": "{{associations.companies.results[0].id}}",
+        "expression": "record_ref:customer",
         "type": "string",
-        "description": "Associated company ID",
-        "required": false
+        "description": "Associated company reference (record reference)",
+        "indexed": false
       },
       "associatedContacts": {
         "expression": "{{associations.contacts.results}}",
         "type": "array",
         "description": "Array of associated contact IDs",
-        "required": false
+        "indexed": false
       },
       "createdAt": {
         "expression": "{{properties.createdate.value}}",
         "type": "string",
         "description": "Creation timestamp",
-        "required": false
+        "indexed": false
       },
       "updatedAt": {
         "expression": "{{properties.hs_lastmodifieddate.value}}",
         "type": "string",
         "description": "Last modification timestamp",
-        "required": false
+        "indexed": false
       }
     }
   },
   "exposed": {
-    "fields": ["id", "dealName", "amount", "currency", "stage", "pipeline", "closeDate", "dealType", "associatedCompany", "associatedContacts", "createdAt", "updatedAt"],
+    "attributes": ["id", "dealName", "amount", "currency", "stage", "pipeline", "closeDate", "dealType", "associatedCompany", "associatedContacts", "createdAt", "updatedAt"],
     "description": "Exposed fields for HubSpot deals"
   },
   "openapi": {

package/lib/api/types/datasources.types.js

@@ -14,8 +14,9 @@
  * @property {string} displayName - Display name
  * @property {string|null} description - Datasource description
  * @property {string} externalSystemId - External system ID
- * @property {string} resourceType - Resource type
- * @property {Object} fieldMappings - Field mappings configuration
+ * @property {string} resourceType - Resource type (pattern: ^[a-z0-9-]+$, e.g., "customer", "contact", "deal")
+ * @property {string} entityType - Entity type (pattern: ^[a-z0-9-]+$)
+ * @property {FieldMappings} fieldMappings - Field mappings configuration with dimensions and attributes
  * @property {string} status - Status ('draft' | 'published' | 'archived')
  * @property {boolean} isActive - Whether datasource is active
  * @property {string} createdAt - Creation timestamp (ISO 8601)
@@ -29,8 +30,9 @@
  * @property {string} displayName - Display name
  * @property {string} [description] - Description
  * @property {string} externalSystemId - External system ID
- * @property {string} resourceType - Resource type
- * @property {Object} [fieldMappings] - Field mappings
+ * @property {string} resourceType - Resource type (pattern: ^[a-z0-9-]+$)
+ * @property {string} entityType - Entity type (pattern: ^[a-z0-9-]+$)
+ * @property {FieldMappings} [fieldMappings] - Field mappings with dimensions and attributes
  * @property {Object} [configuration] - Configuration
  */
 
@@ -39,7 +41,7 @@
  * @typedef {Object} ExternalDataSourceUpdate
  * @property {string} [displayName] - Display name
  * @property {string} [description] - Description
- * @property {Object} [fieldMappings] - Field mappings
+ * @property {FieldMappings} [fieldMappings] - Field mappings with dimensions and attributes
  * @property {Object} [configuration] - Configuration
  * @property {boolean} [isActive] - Active status
  */
@@ -138,6 +140,30 @@
 /** @typedef {Object} ListExecutionLogsResponse @property {CIPExecutionLogResponse[]} items @property {Object} meta @property {Object} links */
 /** @typedef {Object} GetExecutionLogResponse @property {CIPExecutionLogResponse} data */
 
+/**
+ * Field mappings with dimensions-first model
+ * @typedef {Object} FieldMappings
+ * @property {Object<string, string>} dimensions - Dimension keys mapped to attribute paths (e.g., {"country": "metadata.country", "department": "metadata.department"})
+ * @property {Object<string, AttributeDefinition>} attributes - Attribute definitions with transformation expressions
+ */
+
+/**
+ * Attribute definition
+ * @typedef {Object} AttributeDefinition
+ * @property {string} expression - Transformation expression (e.g., "{{properties.id}}" or "record_ref:customer")
+ * @property {string} type - Data type (e.g., "string", "number", "boolean")
+ * @property {boolean} [indexed] - Whether to create database index (default: false)
+ * @property {string} [description] - Attribute description
+ * @property {boolean} [required] - Whether attribute is required
+ */
+
+/**
+ * Record reference mapping (Plan 211)
+ * @typedef {Object} RecordReferenceMapping
+ * @property {string} expression - Expression with record_ref: prefix (e.g., "record_ref:customer")
+ * @property {string} type - Always "string" for record references
+ */
+
 /**
  * Bulk operation request
  * @typedef {Object} BulkOperationRequest

package/lib/api/types/wizard.types.js

@@ -0,0 +1,142 @@
+/**
+ * @fileoverview Wizard API type definitions
+ * @author AI Fabrix Team
+ * @version 2.0.0
+ */
+
+/**
+ * Wizard mode selection request
+ * @typedef {Object} WizardModeSelectionRequest
+ * @property {string} mode - Wizard mode ('create-system' | 'add-datasource')
+ */
+
+/**
+ * Wizard mode selection response
+ * @typedef {Object} WizardModeSelectionResponse
+ * @property {boolean} success - Request success flag
+ * @property {Object} data - Mode selection data
+ * @property {string} data.mode - Selected mode
+ * @property {string} timestamp - Response timestamp (ISO 8601)
+ */
+
+/**
+ * Wizard source selection request
+ * @typedef {Object} WizardSourceSelectionRequest
+ * @property {string} sourceType - Source type ('openapi-file' | 'openapi-url' | 'mcp-server' | 'known-platform')
+ * @property {string} [sourceData] - Source data (file path, URL, etc.)
+ */
+
+/**
+ * Wizard source selection response
+ * @typedef {Object} WizardSourceSelectionResponse
+ * @property {boolean} success - Request success flag
+ * @property {Object} data - Source selection data
+ * @property {string} data.sourceType - Selected source type
+ * @property {string} timestamp - Response timestamp (ISO 8601)
+ */
+
+/**
+ * Wizard parse OpenAPI response
+ * @typedef {Object} WizardParseOpenApiResponse
+ * @property {boolean} success - Request success flag
+ * @property {Object} data - Parsed OpenAPI data
+ * @property {Object} data.spec - Parsed OpenAPI specification
+ * @property {string} data.version - OpenAPI version
+ * @property {string} timestamp - Response timestamp (ISO 8601)
+ */
+
+/**
+ * Wizard detect type request
+ * @typedef {Object} WizardDetectTypeRequest
+ * @property {Object} openApiSpec - OpenAPI specification object
+ */
+
+/**
+ * Wizard detect type response
+ * @typedef {Object} WizardDetectTypeResponse
+ * @property {boolean} success - Request success flag
+ * @property {Object} data - Type detection data
+ * @property {string} data.apiType - Detected API type (e.g., 'rest', 'graphql', 'rpc')
+ * @property {string} data.category - API category (e.g., 'crm', 'support', 'sales')
+ * @property {Object} data.confidence - Confidence scores for detection
+ * @property {string} timestamp - Response timestamp (ISO 8601)
+ */
+
+/**
+ * Wizard generate config request
+ * @typedef {Object} WizardGenerateConfigRequest
+ * @property {string} mode - Wizard mode
+ * @property {string} sourceType - Source type
+ * @property {Object} [openApiSpec] - OpenAPI specification (if applicable)
+ * @property {string} [userIntent] - User intent (e.g., 'sales-focused', 'support-focused')
+ * @property {Object} [preferences] - User preferences
+ * @property {boolean} [preferences.mcp] - Enable MCP
+ * @property {boolean} [preferences.abac] - Enable ABAC
+ * @property {boolean} [preferences.rbac] - Enable RBAC
+ */
+
+/**
+ * Wizard generate config response
+ * @typedef {Object} WizardGenerateConfigResponse
+ * @property {boolean} success - Request success flag
+ * @property {Object} data - Generated configuration data
+ * @property {Object} data.systemConfig - External system configuration
+ * @property {Object[]} data.datasourceConfigs - Array of datasource configurations
+ * @property {string} data.systemKey - Generated system key
+ * @property {string} timestamp - Response timestamp (ISO 8601)
+ */
+
+/**
+ * Wizard validate request
+ * @typedef {Object} WizardValidateRequest
+ * @property {Object} systemConfig - System configuration to validate
+ * @property {Object[]} datasourceConfigs - Array of datasource configurations to validate
+ */
+
+/**
+ * Wizard validate response
+ * @typedef {Object} WizardValidateResponse
+ * @property {boolean} success - Request success flag
+ * @property {Object} data - Validation data
+ * @property {boolean} data.valid - Whether configuration is valid
+ * @property {Object[]} [data.errors] - Array of validation errors (if invalid)
+ * @property {Object[]} [data.warnings] - Array of validation warnings
+ * @property {string} timestamp - Response timestamp (ISO 8601)
+ */
+
+/**
+ * Wizard test MCP connection request
+ * @typedef {Object} WizardTestMcpConnectionRequest
+ * @property {string} serverUrl - MCP server URL
+ * @property {string} token - MCP server authentication token
+ */
+
+/**
+ * Wizard test MCP connection response
+ * @typedef {Object} WizardTestMcpConnectionResponse
+ * @property {boolean} success - Request success flag
+ * @property {Object} data - Connection test data
+ * @property {boolean} data.connected - Whether connection was successful
+ * @property {string} [data.error] - Error message (if connection failed)
+ * @property {string} timestamp - Response timestamp (ISO 8601)
+ */
+
+/**
+ * Deployment docs request
+ * @typedef {Object} DeploymentDocsRequest
+ * @property {string} systemKey - System key identifier
+ */
+
+/**
+ * Deployment docs response
+ * @typedef {Object} DeploymentDocsResponse
+ * @property {boolean} success - Request success flag
+ * @property {Object} data - Deployment documentation data
+ * @property {string} data.systemKey - System key identifier
+ * @property {string} data.content - README.md content (markdown)
+ * @property {string} data.contentType - Content type (e.g., 'text/markdown')
+ * @property {string} timestamp - Response timestamp (ISO 8601)
+ */
+
+module.exports = {};
+