@memberjunction/integration-connectors 5.13.0 → 5.14.0

package/dist/HubSpotConnector.js

@@ -5,7 +5,7 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
 import { RegisterClass } from '@memberjunction/global';
-import { Metadata } from '@memberjunction/core';
+import { Metadata, RunView } from '@memberjunction/core';
 import { BaseIntegrationConnector, BaseRESTIntegrationConnector, } from '@memberjunction/integration-engine';
 // ─── Constants ────────────────────────────────────────────────────────
 const HUBSPOT_API_BASE = 'https://api.hubapi.com';
@@ -17,98 +17,287 @@ const REQUEST_TIMEOUT_MS = 30000;
 /** Minimum milliseconds between API requests (HubSpot: 100 req/10s for private apps) */
 const MIN_REQUEST_INTERVAL_MS = 100;
 /**
- * Known properties to request per object type. HubSpot's list endpoint
- * only returns a handful of default properties unless you explicitly
- * specify which properties to include via the `properties` query param.
+ * Comprehensive HubSpot object metadata — single source of truth for both
+ * action generation and API property requests.
+ *
+ * CRM objects (contacts, companies, deals, tasks, tickets, products) generate
+ * CRUD actions. Activity/ancillary objects (calls, emails, notes, meetings,
+ * line_items, quotes, feedback_submissions) are included for property lookups
+ * but excluded from action generation via IncludeInActionGeneration: false.
  */
-const HUBSPOT_PROPERTIES = {
-    contacts: [
-        'email', 'firstname', 'lastname', 'phone', 'mobilephone', 'company',
-        'jobtitle', 'lifecyclestage', 'hs_lead_status', 'address', 'city',
-        'state', 'zip', 'country', 'website', 'industry',
-        'annualrevenue', 'numberofemployees', 'hs_object_id',
-        'createdate', 'lastmodifieddate', 'associatedcompanyid',
-        'notes_last_contacted', 'notes_last_updated', 'hs_email_optout',
-    ],
-    companies: [
-        'name', 'domain', 'industry', 'phone', 'address', 'address2',
-        'city', 'state', 'zip', 'country', 'website', 'description',
-        'numberofemployees', 'annualrevenue', 'lifecyclestage',
-        'type', 'hs_object_id', 'createdate', 'hs_lastmodifieddate',
-        'founded_year', 'is_public',
-    ],
-    deals: [
-        'dealname', 'amount', 'dealstage', 'pipeline', 'closedate',
-        'createdate', 'hs_object_id', 'hs_lastmodifieddate',
-        'dealtype', 'description', 'hs_deal_stage_probability',
-        'hs_projected_amount', 'hs_priority', 'hubspot_owner_id',
-        'notes_last_contacted', 'num_associated_contacts',
-    ],
-    tickets: [
-        'subject', 'content', 'hs_pipeline', 'hs_pipeline_stage',
-        'hs_ticket_priority', 'hs_ticket_category', 'createdate',
-        'hs_lastmodifieddate', 'hs_object_id', 'closed_date',
-        'source_type', 'hubspot_owner_id',
-    ],
-    products: [
-        'name', 'description', 'price', 'hs_cost_of_goods_sold',
-        'hs_recurring_billing_period', 'hs_sku', 'tax',
-        'createdate', 'hs_lastmodifieddate', 'hs_object_id',
-    ],
-    line_items: [
-        'name', 'description', 'quantity', 'price', 'amount',
-        'discount', 'tax', 'hs_product_id', 'hs_line_item_currency_code',
-        'hs_sku', 'hs_cost_of_goods_sold', 'hs_recurring_billing_period',
-        'createdate', 'hs_lastmodifieddate', 'hs_object_id',
-    ],
-    quotes: [
-        'hs_title', 'hs_expiration_date', 'hs_status', 'hs_quote_amount',
-        'hs_currency', 'hs_sender_firstname', 'hs_sender_lastname',
-        'hs_sender_email', 'hs_sender_company_name', 'hs_language',
-        'hs_locale', 'hs_slug', 'hs_public_url_key',
-        'createdate', 'hs_lastmodifieddate', 'hs_object_id',
-    ],
-    calls: [
-        'hs_call_title', 'hs_call_body', 'hs_call_status',
-        'hs_call_direction', 'hs_call_duration', 'hs_call_from_number',
-        'hs_call_to_number', 'hs_call_disposition',
-        'hs_call_recording_url', 'hubspot_owner_id',
-        'hs_timestamp', 'createdate', 'hs_lastmodifieddate', 'hs_object_id',
-    ],
-    emails: [
-        'hs_email_subject', 'hs_email_text', 'hs_email_html',
-        'hs_email_status', 'hs_email_direction',
-        'hs_email_sender_email', 'hs_email_sender_firstname',
-        'hs_email_sender_lastname', 'hs_email_to_email',
-        'hubspot_owner_id',
-        'hs_timestamp', 'createdate', 'hs_lastmodifieddate', 'hs_object_id',
-    ],
-    notes: [
-        'hs_note_body', 'hs_timestamp', 'hubspot_owner_id',
-        'hs_attachment_ids', 'hs_body_preview', 'hs_body_preview_is_truncated',
-        'createdate', 'hs_lastmodifieddate', 'hs_object_id',
-    ],
-    tasks: [
-        'hs_task_subject', 'hs_task_body', 'hs_task_status',
-        'hs_task_priority', 'hs_task_type', 'hs_timestamp',
-        'hs_task_completion_date', 'hs_queue_membership_ids',
-        'hubspot_owner_id',
-        'createdate', 'hs_lastmodifieddate', 'hs_object_id',
-    ],
-    meetings: [
-        'hs_meeting_title', 'hs_meeting_body', 'hs_meeting_start_time',
-        'hs_meeting_end_time', 'hs_meeting_outcome', 'hs_meeting_location',
-        'hs_meeting_external_url', 'hs_internal_meeting_notes',
-        'hs_activity_type', 'hubspot_owner_id',
-        'hs_timestamp', 'createdate', 'hs_lastmodifieddate', 'hs_object_id',
-    ],
-    feedback_submissions: [
-        'hs_survey_id', 'hs_survey_name', 'hs_survey_type',
-        'hs_submission_name', 'hs_content', 'hs_response_group',
-        'hs_sentiment', 'hs_survey_channel',
-        'hs_timestamp', 'createdate', 'hs_lastmodifieddate', 'hs_object_id',
-    ],
-};
+const HUBSPOT_OBJECTS = [
+    // ── CRM Objects (generate actions) ──────────────────────────────────
+    {
+        Name: 'contacts', DisplayName: 'Contact',
+        Description: 'A person or lead in HubSpot CRM', SupportsWrite: true,
+        Fields: [
+            { Name: 'email', DisplayName: 'Email', Type: 'string', IsRequired: true, IsReadOnly: false, IsPrimaryKey: false, Description: 'Contact email address' },
+            { Name: 'firstname', DisplayName: 'First Name', Type: 'string', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'Contact first name' },
+            { Name: 'lastname', DisplayName: 'Last Name', Type: 'string', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'Contact last name' },
+            { Name: 'phone', DisplayName: 'Phone', Type: 'string', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'Contact phone number' },
+            { Name: 'mobilephone', DisplayName: 'Mobile Phone', Type: 'string', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'Mobile phone number' },
+            { Name: 'company', DisplayName: 'Company', Type: 'string', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'Associated company name' },
+            { Name: 'jobtitle', DisplayName: 'Job Title', Type: 'string', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'Contact job title' },
+            { Name: 'lifecyclestage', DisplayName: 'Lifecycle Stage', Type: 'enum', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'Lifecycle stage (subscriber, lead, opportunity, customer, etc.)' },
+            { Name: 'hs_lead_status', DisplayName: 'Lead Status', Type: 'enum', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'Lead qualification status' },
+            { Name: 'address', DisplayName: 'Address', Type: 'string', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'Street address' },
+            { Name: 'city', DisplayName: 'City', Type: 'string', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'City' },
+            { Name: 'state', DisplayName: 'State', Type: 'string', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'State or province' },
+            { Name: 'zip', DisplayName: 'Zip', Type: 'string', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'Postal/zip code' },
+            { Name: 'country', DisplayName: 'Country', Type: 'string', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'Country' },
+            { Name: 'website', DisplayName: 'Website', Type: 'string', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'Contact website URL' },
+            { Name: 'industry', DisplayName: 'Industry', Type: 'string', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'Industry' },
+            { Name: 'annualrevenue', DisplayName: 'Annual Revenue', Type: 'number', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'Annual revenue' },
+            { Name: 'numberofemployees', DisplayName: 'Number of Employees', Type: 'number', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'Number of employees' },
+            { Name: 'associatedcompanyid', DisplayName: 'Associated Company ID', Type: 'string', IsRequired: false, IsReadOnly: true, IsPrimaryKey: false, Description: 'ID of associated company' },
+            { Name: 'notes_last_contacted', DisplayName: 'Last Contacted', Type: 'datetime', IsRequired: false, IsReadOnly: true, IsPrimaryKey: false, Description: 'When last contacted' },
+            { Name: 'notes_last_updated', DisplayName: 'Notes Last Updated', Type: 'datetime', IsRequired: false, IsReadOnly: true, IsPrimaryKey: false, Description: 'When notes were last updated' },
+            { Name: 'hs_email_optout', DisplayName: 'Email Opt-out', Type: 'boolean', IsRequired: false, IsReadOnly: true, IsPrimaryKey: false, Description: 'Whether contact has opted out of email' },
+            { Name: 'hs_object_id', DisplayName: 'Object ID', Type: 'string', IsRequired: false, IsReadOnly: true, IsPrimaryKey: true, Description: 'HubSpot internal object ID' },
+            { Name: 'createdate', DisplayName: 'Created Date', Type: 'datetime', IsRequired: false, IsReadOnly: true, IsPrimaryKey: false, Description: 'When the contact was created' },
+            { Name: 'lastmodifieddate', DisplayName: 'Last Modified', Type: 'datetime', IsRequired: false, IsReadOnly: true, IsPrimaryKey: false, Description: 'When last modified' },
+        ],
+    },
+    {
+        Name: 'companies', DisplayName: 'Company',
+        Description: 'A business organization in HubSpot CRM', SupportsWrite: true,
+        Fields: [
+            { Name: 'name', DisplayName: 'Company Name', Type: 'string', IsRequired: true, IsReadOnly: false, IsPrimaryKey: false, Description: 'Company name' },
+            { Name: 'domain', DisplayName: 'Domain', Type: 'string', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'Company website domain' },
+            { Name: 'industry', DisplayName: 'Industry', Type: 'string', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'Company industry' },
+            { Name: 'phone', DisplayName: 'Phone', Type: 'string', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'Company phone number' },
+            { Name: 'address', DisplayName: 'Address', Type: 'string', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'Street address' },
+            { Name: 'address2', DisplayName: 'Address Line 2', Type: 'string', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'Address line 2' },
+            { Name: 'city', DisplayName: 'City', Type: 'string', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'City' },
+            { Name: 'state', DisplayName: 'State', Type: 'string', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'State or province' },
+            { Name: 'zip', DisplayName: 'Zip', Type: 'string', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'Postal/zip code' },
+            { Name: 'country', DisplayName: 'Country', Type: 'string', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'Country' },
+            { Name: 'website', DisplayName: 'Website', Type: 'string', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'Company website URL' },
+            { Name: 'description', DisplayName: 'Description', Type: 'text', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'Company description' },
+            { Name: 'numberofemployees', DisplayName: 'Employees', Type: 'number', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'Number of employees' },
+            { Name: 'annualrevenue', DisplayName: 'Annual Revenue', Type: 'number', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'Annual revenue' },
+            { Name: 'lifecyclestage', DisplayName: 'Lifecycle Stage', Type: 'enum', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'Company lifecycle stage' },
+            { Name: 'type', DisplayName: 'Type', Type: 'string', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'Company type' },
+            { Name: 'founded_year', DisplayName: 'Founded Year', Type: 'string', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'Year the company was founded' },
+            { Name: 'is_public', DisplayName: 'Is Public', Type: 'boolean', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'Whether the company is publicly traded' },
+            { Name: 'hs_object_id', DisplayName: 'Object ID', Type: 'string', IsRequired: false, IsReadOnly: true, IsPrimaryKey: true, Description: 'HubSpot internal object ID' },
+            { Name: 'createdate', DisplayName: 'Created Date', Type: 'datetime', IsRequired: false, IsReadOnly: true, IsPrimaryKey: false, Description: 'When the company was created' },
+            { Name: 'hs_lastmodifieddate', DisplayName: 'Last Modified', Type: 'datetime', IsRequired: false, IsReadOnly: true, IsPrimaryKey: false, Description: 'When last modified' },
+        ],
+    },
+    {
+        Name: 'deals', DisplayName: 'Deal',
+        Description: 'A sales deal/opportunity in HubSpot CRM', SupportsWrite: true,
+        Fields: [
+            { Name: 'dealname', DisplayName: 'Deal Name', Type: 'string', IsRequired: true, IsReadOnly: false, IsPrimaryKey: false, Description: 'Name of the deal' },
+            { Name: 'amount', DisplayName: 'Amount', Type: 'number', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'Deal value/amount' },
+            { Name: 'dealstage', DisplayName: 'Deal Stage', Type: 'enum', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'Current stage in the sales pipeline' },
+            { Name: 'pipeline', DisplayName: 'Pipeline', Type: 'string', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'Sales pipeline' },
+            { Name: 'closedate', DisplayName: 'Close Date', Type: 'datetime', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'Expected close date' },
+            { Name: 'dealtype', DisplayName: 'Deal Type', Type: 'string', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'Type of deal' },
+            { Name: 'description', DisplayName: 'Description', Type: 'text', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'Deal description' },
+            { Name: 'hs_deal_stage_probability', DisplayName: 'Stage Probability', Type: 'number', IsRequired: false, IsReadOnly: true, IsPrimaryKey: false, Description: 'Probability based on deal stage' },
+            { Name: 'hs_projected_amount', DisplayName: 'Projected Amount', Type: 'number', IsRequired: false, IsReadOnly: true, IsPrimaryKey: false, Description: 'Projected deal amount' },
+            { Name: 'hs_priority', DisplayName: 'Priority', Type: 'enum', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'Deal priority level' },
+            { Name: 'hubspot_owner_id', DisplayName: 'Owner', Type: 'string', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'HubSpot owner user ID' },
+            { Name: 'notes_last_contacted', DisplayName: 'Last Contacted', Type: 'datetime', IsRequired: false, IsReadOnly: true, IsPrimaryKey: false, Description: 'When last contacted' },
+            { Name: 'num_associated_contacts', DisplayName: 'Associated Contacts', Type: 'number', IsRequired: false, IsReadOnly: true, IsPrimaryKey: false, Description: 'Number of associated contacts' },
+            { Name: 'hs_object_id', DisplayName: 'Object ID', Type: 'string', IsRequired: false, IsReadOnly: true, IsPrimaryKey: true, Description: 'HubSpot internal object ID' },
+            { Name: 'createdate', DisplayName: 'Created Date', Type: 'datetime', IsRequired: false, IsReadOnly: true, IsPrimaryKey: false, Description: 'When the deal was created' },
+            { Name: 'hs_lastmodifieddate', DisplayName: 'Last Modified', Type: 'datetime', IsRequired: false, IsReadOnly: true, IsPrimaryKey: false, Description: 'When last modified' },
+        ],
+    },
+    {
+        Name: 'tasks', DisplayName: 'Task',
+        Description: 'A task/to-do item in HubSpot CRM', SupportsWrite: true,
+        Fields: [
+            { Name: 'hs_task_subject', DisplayName: 'Subject', Type: 'string', IsRequired: true, IsReadOnly: false, IsPrimaryKey: false, Description: 'Task subject line' },
+            { Name: 'hs_task_body', DisplayName: 'Body', Type: 'text', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'Task body/description' },
+            { Name: 'hs_task_status', DisplayName: 'Status', Type: 'enum', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'Task status (NOT_STARTED, IN_PROGRESS, COMPLETED, etc.)' },
+            { Name: 'hs_task_priority', DisplayName: 'Priority', Type: 'enum', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'Task priority level' },
+            { Name: 'hs_task_type', DisplayName: 'Type', Type: 'string', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'Task type (TODO, CALL, EMAIL)' },
+            { Name: 'hs_timestamp', DisplayName: 'Due Date', Type: 'datetime', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'Task due date/timestamp' },
+            { Name: 'hs_task_completion_date', DisplayName: 'Completion Date', Type: 'datetime', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'When the task was completed' },
+            { Name: 'hs_queue_membership_ids', DisplayName: 'Queue IDs', Type: 'string', IsRequired: false, IsReadOnly: true, IsPrimaryKey: false, Description: 'Task queue membership IDs' },
+            { Name: 'hubspot_owner_id', DisplayName: 'Owner', Type: 'string', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'HubSpot owner user ID' },
+            { Name: 'hs_object_id', DisplayName: 'Object ID', Type: 'string', IsRequired: false, IsReadOnly: true, IsPrimaryKey: true, Description: 'HubSpot internal object ID' },
+            { Name: 'createdate', DisplayName: 'Created Date', Type: 'datetime', IsRequired: false, IsReadOnly: true, IsPrimaryKey: false, Description: 'When the task was created' },
+            { Name: 'hs_lastmodifieddate', DisplayName: 'Last Modified', Type: 'datetime', IsRequired: false, IsReadOnly: true, IsPrimaryKey: false, Description: 'When last modified' },
+        ],
+    },
+    {
+        Name: 'tickets', DisplayName: 'Ticket',
+        Description: 'A support ticket in HubSpot CRM', SupportsWrite: true,
+        Fields: [
+            { Name: 'subject', DisplayName: 'Subject', Type: 'string', IsRequired: true, IsReadOnly: false, IsPrimaryKey: false, Description: 'Ticket subject line' },
+            { Name: 'content', DisplayName: 'Content', Type: 'text', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'Ticket body/content' },
+            { Name: 'hs_pipeline', DisplayName: 'Pipeline', Type: 'string', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'Support pipeline' },
+            { Name: 'hs_pipeline_stage', DisplayName: 'Pipeline Stage', Type: 'string', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'Current pipeline stage' },
+            { Name: 'hs_ticket_priority', DisplayName: 'Priority', Type: 'enum', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'Ticket priority level' },
+            { Name: 'hs_ticket_category', DisplayName: 'Category', Type: 'string', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'Ticket category' },
+            { Name: 'source_type', DisplayName: 'Source', Type: 'string', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'How the ticket was created' },
+            { Name: 'hubspot_owner_id', DisplayName: 'Owner', Type: 'string', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'HubSpot owner user ID' },
+            { Name: 'closed_date', DisplayName: 'Closed Date', Type: 'datetime', IsRequired: false, IsReadOnly: true, IsPrimaryKey: false, Description: 'When the ticket was closed' },
+            { Name: 'hs_object_id', DisplayName: 'Object ID', Type: 'string', IsRequired: false, IsReadOnly: true, IsPrimaryKey: true, Description: 'HubSpot internal object ID' },
+            { Name: 'createdate', DisplayName: 'Created Date', Type: 'datetime', IsRequired: false, IsReadOnly: true, IsPrimaryKey: false, Description: 'When the ticket was created' },
+            { Name: 'hs_lastmodifieddate', DisplayName: 'Last Modified', Type: 'datetime', IsRequired: false, IsReadOnly: true, IsPrimaryKey: false, Description: 'When last modified' },
+        ],
+    },
+    {
+        Name: 'products', DisplayName: 'Product',
+        Description: 'A product in the HubSpot product catalog', SupportsWrite: true,
+        Fields: [
+            { Name: 'name', DisplayName: 'Product Name', Type: 'string', IsRequired: true, IsReadOnly: false, IsPrimaryKey: false, Description: 'Product name' },
+            { Name: 'description', DisplayName: 'Description', Type: 'text', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'Product description' },
+            { Name: 'price', DisplayName: 'Price', Type: 'number', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'Product unit price' },
+            { Name: 'hs_cost_of_goods_sold', DisplayName: 'Cost of Goods Sold', Type: 'number', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'Cost of goods sold' },
+            { Name: 'hs_recurring_billing_period', DisplayName: 'Recurring Billing Period', Type: 'string', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'Recurring billing period' },
+            { Name: 'hs_sku', DisplayName: 'SKU', Type: 'string', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'Stock keeping unit identifier' },
+            { Name: 'tax', DisplayName: 'Tax', Type: 'number', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'Tax amount' },
+            { Name: 'hs_object_id', DisplayName: 'Object ID', Type: 'string', IsRequired: false, IsReadOnly: true, IsPrimaryKey: true, Description: 'HubSpot internal object ID' },
+            { Name: 'createdate', DisplayName: 'Created Date', Type: 'datetime', IsRequired: false, IsReadOnly: true, IsPrimaryKey: false, Description: 'When the product was created' },
+            { Name: 'hs_lastmodifieddate', DisplayName: 'Last Modified', Type: 'datetime', IsRequired: false, IsReadOnly: true, IsPrimaryKey: false, Description: 'When last modified' },
+        ],
+    },
+    // ── Ancillary Objects (property lookups only, no action generation) ──
+    {
+        Name: 'line_items', DisplayName: 'Line Item',
+        Description: 'A line item on a deal or quote', SupportsWrite: false, IncludeInActionGeneration: false,
+        Fields: [
+            { Name: 'name', DisplayName: 'Name', Type: 'string', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'Line item name' },
+            { Name: 'description', DisplayName: 'Description', Type: 'text', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'Line item description' },
+            { Name: 'quantity', DisplayName: 'Quantity', Type: 'number', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'Quantity' },
+            { Name: 'price', DisplayName: 'Price', Type: 'number', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'Unit price' },
+            { Name: 'amount', DisplayName: 'Amount', Type: 'number', IsRequired: false, IsReadOnly: true, IsPrimaryKey: false, Description: 'Total amount' },
+            { Name: 'discount', DisplayName: 'Discount', Type: 'number', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'Discount amount' },
+            { Name: 'tax', DisplayName: 'Tax', Type: 'number', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'Tax amount' },
+            { Name: 'hs_product_id', DisplayName: 'Product ID', Type: 'string', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'Associated product ID' },
+            { Name: 'hs_line_item_currency_code', DisplayName: 'Currency', Type: 'string', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'Currency code' },
+            { Name: 'hs_sku', DisplayName: 'SKU', Type: 'string', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'Stock keeping unit' },
+            { Name: 'hs_cost_of_goods_sold', DisplayName: 'Cost of Goods Sold', Type: 'number', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'Cost of goods sold' },
+            { Name: 'hs_recurring_billing_period', DisplayName: 'Recurring Billing Period', Type: 'string', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'Recurring billing period' },
+            { Name: 'hs_object_id', DisplayName: 'Object ID', Type: 'string', IsRequired: false, IsReadOnly: true, IsPrimaryKey: true, Description: 'HubSpot internal object ID' },
+            { Name: 'createdate', DisplayName: 'Created Date', Type: 'datetime', IsRequired: false, IsReadOnly: true, IsPrimaryKey: false, Description: 'When created' },
+            { Name: 'hs_lastmodifieddate', DisplayName: 'Last Modified', Type: 'datetime', IsRequired: false, IsReadOnly: true, IsPrimaryKey: false, Description: 'When last modified' },
+        ],
+    },
+    {
+        Name: 'quotes', DisplayName: 'Quote',
+        Description: 'A sales quote in HubSpot', SupportsWrite: false, IncludeInActionGeneration: false,
+        Fields: [
+            { Name: 'hs_title', DisplayName: 'Title', Type: 'string', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'Quote title' },
+            { Name: 'hs_expiration_date', DisplayName: 'Expiration Date', Type: 'datetime', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'Quote expiration date' },
+            { Name: 'hs_status', DisplayName: 'Status', Type: 'enum', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'Quote status' },
+            { Name: 'hs_quote_amount', DisplayName: 'Amount', Type: 'number', IsRequired: false, IsReadOnly: true, IsPrimaryKey: false, Description: 'Quote total amount' },
+            { Name: 'hs_currency', DisplayName: 'Currency', Type: 'string', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'Currency code' },
+            { Name: 'hs_sender_firstname', DisplayName: 'Sender First Name', Type: 'string', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'Sender first name' },
+            { Name: 'hs_sender_lastname', DisplayName: 'Sender Last Name', Type: 'string', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'Sender last name' },
+            { Name: 'hs_sender_email', DisplayName: 'Sender Email', Type: 'string', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'Sender email' },
+            { Name: 'hs_sender_company_name', DisplayName: 'Sender Company', Type: 'string', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'Sender company name' },
+            { Name: 'hs_language', DisplayName: 'Language', Type: 'string', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'Quote language' },
+            { Name: 'hs_locale', DisplayName: 'Locale', Type: 'string', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'Quote locale' },
+            { Name: 'hs_slug', DisplayName: 'Slug', Type: 'string', IsRequired: false, IsReadOnly: true, IsPrimaryKey: false, Description: 'URL slug' },
+            { Name: 'hs_public_url_key', DisplayName: 'Public URL Key', Type: 'string', IsRequired: false, IsReadOnly: true, IsPrimaryKey: false, Description: 'Public URL access key' },
+            { Name: 'hs_object_id', DisplayName: 'Object ID', Type: 'string', IsRequired: false, IsReadOnly: true, IsPrimaryKey: true, Description: 'HubSpot internal object ID' },
+            { Name: 'createdate', DisplayName: 'Created Date', Type: 'datetime', IsRequired: false, IsReadOnly: true, IsPrimaryKey: false, Description: 'When created' },
+            { Name: 'hs_lastmodifieddate', DisplayName: 'Last Modified', Type: 'datetime', IsRequired: false, IsReadOnly: true, IsPrimaryKey: false, Description: 'When last modified' },
+        ],
+    },
+    // ── Activity Objects (property lookups only, no action generation) ───
+    {
+        Name: 'calls', DisplayName: 'Call',
+        Description: 'A call activity in HubSpot', SupportsWrite: false, IncludeInActionGeneration: false,
+        Fields: [
+            { Name: 'hs_call_title', DisplayName: 'Title', Type: 'string', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'Call title' },
+            { Name: 'hs_call_body', DisplayName: 'Body', Type: 'text', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'Call notes/body' },
+            { Name: 'hs_call_status', DisplayName: 'Status', Type: 'enum', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'Call status' },
+            { Name: 'hs_call_direction', DisplayName: 'Direction', Type: 'enum', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'Inbound or outbound' },
+            { Name: 'hs_call_duration', DisplayName: 'Duration', Type: 'number', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'Call duration in ms' },
+            { Name: 'hs_call_from_number', DisplayName: 'From Number', Type: 'string', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'Caller phone number' },
+            { Name: 'hs_call_to_number', DisplayName: 'To Number', Type: 'string', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'Recipient phone number' },
+            { Name: 'hs_call_disposition', DisplayName: 'Disposition', Type: 'string', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'Call outcome disposition' },
+            { Name: 'hs_call_recording_url', DisplayName: 'Recording URL', Type: 'string', IsRequired: false, IsReadOnly: true, IsPrimaryKey: false, Description: 'Call recording URL' },
+            { Name: 'hubspot_owner_id', DisplayName: 'Owner', Type: 'string', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'HubSpot owner user ID' },
+            { Name: 'hs_timestamp', DisplayName: 'Timestamp', Type: 'datetime', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'Call timestamp' },
+            { Name: 'hs_object_id', DisplayName: 'Object ID', Type: 'string', IsRequired: false, IsReadOnly: true, IsPrimaryKey: true, Description: 'HubSpot internal object ID' },
+            { Name: 'createdate', DisplayName: 'Created Date', Type: 'datetime', IsRequired: false, IsReadOnly: true, IsPrimaryKey: false, Description: 'When created' },
+            { Name: 'hs_lastmodifieddate', DisplayName: 'Last Modified', Type: 'datetime', IsRequired: false, IsReadOnly: true, IsPrimaryKey: false, Description: 'When last modified' },
+        ],
+    },
+    {
+        Name: 'emails', DisplayName: 'Email',
+        Description: 'An email activity in HubSpot', SupportsWrite: false, IncludeInActionGeneration: false,
+        Fields: [
+            { Name: 'hs_email_subject', DisplayName: 'Subject', Type: 'string', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'Email subject' },
+            { Name: 'hs_email_text', DisplayName: 'Text Body', Type: 'text', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'Plain text body' },
+            { Name: 'hs_email_html', DisplayName: 'HTML Body', Type: 'text', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'HTML body' },
+            { Name: 'hs_email_status', DisplayName: 'Status', Type: 'enum', IsRequired: false, IsReadOnly: true, IsPrimaryKey: false, Description: 'Email status' },
+            { Name: 'hs_email_direction', DisplayName: 'Direction', Type: 'enum', IsRequired: false, IsReadOnly: true, IsPrimaryKey: false, Description: 'Inbound or outbound' },
+            { Name: 'hs_email_sender_email', DisplayName: 'Sender Email', Type: 'string', IsRequired: false, IsReadOnly: true, IsPrimaryKey: false, Description: 'Sender email address' },
+            { Name: 'hs_email_sender_firstname', DisplayName: 'Sender First Name', Type: 'string', IsRequired: false, IsReadOnly: true, IsPrimaryKey: false, Description: 'Sender first name' },
+            { Name: 'hs_email_sender_lastname', DisplayName: 'Sender Last Name', Type: 'string', IsRequired: false, IsReadOnly: true, IsPrimaryKey: false, Description: 'Sender last name' },
+            { Name: 'hs_email_to_email', DisplayName: 'To Email', Type: 'string', IsRequired: false, IsReadOnly: true, IsPrimaryKey: false, Description: 'Recipient email address' },
+            { Name: 'hubspot_owner_id', DisplayName: 'Owner', Type: 'string', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'HubSpot owner user ID' },
+            { Name: 'hs_timestamp', DisplayName: 'Timestamp', Type: 'datetime', IsRequired: false, IsReadOnly: true, IsPrimaryKey: false, Description: 'Email timestamp' },
+            { Name: 'hs_object_id', DisplayName: 'Object ID', Type: 'string', IsRequired: false, IsReadOnly: true, IsPrimaryKey: true, Description: 'HubSpot internal object ID' },
+            { Name: 'createdate', DisplayName: 'Created Date', Type: 'datetime', IsRequired: false, IsReadOnly: true, IsPrimaryKey: false, Description: 'When created' },
+            { Name: 'hs_lastmodifieddate', DisplayName: 'Last Modified', Type: 'datetime', IsRequired: false, IsReadOnly: true, IsPrimaryKey: false, Description: 'When last modified' },
+        ],
+    },
+    {
+        Name: 'notes', DisplayName: 'Note',
+        Description: 'A note activity in HubSpot', SupportsWrite: false, IncludeInActionGeneration: false,
+        Fields: [
+            { Name: 'hs_note_body', DisplayName: 'Body', Type: 'text', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'Note body content' },
+            { Name: 'hs_timestamp', DisplayName: 'Timestamp', Type: 'datetime', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'Note timestamp' },
+            { Name: 'hubspot_owner_id', DisplayName: 'Owner', Type: 'string', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'HubSpot owner user ID' },
+            { Name: 'hs_attachment_ids', DisplayName: 'Attachment IDs', Type: 'string', IsRequired: false, IsReadOnly: true, IsPrimaryKey: false, Description: 'Attached file IDs' },
+            { Name: 'hs_body_preview', DisplayName: 'Body Preview', Type: 'string', IsRequired: false, IsReadOnly: true, IsPrimaryKey: false, Description: 'Truncated body preview' },
+            { Name: 'hs_body_preview_is_truncated', DisplayName: 'Preview Truncated', Type: 'boolean', IsRequired: false, IsReadOnly: true, IsPrimaryKey: false, Description: 'Whether preview is truncated' },
+            { Name: 'hs_object_id', DisplayName: 'Object ID', Type: 'string', IsRequired: false, IsReadOnly: true, IsPrimaryKey: true, Description: 'HubSpot internal object ID' },
+            { Name: 'createdate', DisplayName: 'Created Date', Type: 'datetime', IsRequired: false, IsReadOnly: true, IsPrimaryKey: false, Description: 'When created' },
+            { Name: 'hs_lastmodifieddate', DisplayName: 'Last Modified', Type: 'datetime', IsRequired: false, IsReadOnly: true, IsPrimaryKey: false, Description: 'When last modified' },
+        ],
+    },
+    {
+        Name: 'meetings', DisplayName: 'Meeting',
+        Description: 'A meeting activity in HubSpot', SupportsWrite: false, IncludeInActionGeneration: false,
+        Fields: [
+            { Name: 'hs_meeting_title', DisplayName: 'Title', Type: 'string', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'Meeting title' },
+            { Name: 'hs_meeting_body', DisplayName: 'Body', Type: 'text', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'Meeting description' },
+            { Name: 'hs_meeting_start_time', DisplayName: 'Start Time', Type: 'datetime', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'Meeting start time' },
+            { Name: 'hs_meeting_end_time', DisplayName: 'End Time', Type: 'datetime', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'Meeting end time' },
+            { Name: 'hs_meeting_outcome', DisplayName: 'Outcome', Type: 'enum', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'Meeting outcome' },
+            { Name: 'hs_meeting_location', DisplayName: 'Location', Type: 'string', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'Meeting location' },
+            { Name: 'hs_meeting_external_url', DisplayName: 'External URL', Type: 'string', IsRequired: false, IsReadOnly: true, IsPrimaryKey: false, Description: 'External meeting URL' },
+            { Name: 'hs_internal_meeting_notes', DisplayName: 'Internal Notes', Type: 'text', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'Internal meeting notes' },
+            { Name: 'hs_activity_type', DisplayName: 'Activity Type', Type: 'string', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'Activity type' },
+            { Name: 'hubspot_owner_id', DisplayName: 'Owner', Type: 'string', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'HubSpot owner user ID' },
+            { Name: 'hs_timestamp', DisplayName: 'Timestamp', Type: 'datetime', IsRequired: false, IsReadOnly: false, IsPrimaryKey: false, Description: 'Meeting timestamp' },
+            { Name: 'hs_object_id', DisplayName: 'Object ID', Type: 'string', IsRequired: false, IsReadOnly: true, IsPrimaryKey: true, Description: 'HubSpot internal object ID' },
+            { Name: 'createdate', DisplayName: 'Created Date', Type: 'datetime', IsRequired: false, IsReadOnly: true, IsPrimaryKey: false, Description: 'When created' },
+            { Name: 'hs_lastmodifieddate', DisplayName: 'Last Modified', Type: 'datetime', IsRequired: false, IsReadOnly: true, IsPrimaryKey: false, Description: 'When last modified' },
+        ],
+    },
+    {
+        Name: 'feedback_submissions', DisplayName: 'Feedback Submission',
+        Description: 'A feedback survey submission in HubSpot', SupportsWrite: false, IncludeInActionGeneration: false,
+        Fields: [
+            { Name: 'hs_survey_id', DisplayName: 'Survey ID', Type: 'string', IsRequired: false, IsReadOnly: true, IsPrimaryKey: false, Description: 'Survey ID' },
+            { Name: 'hs_survey_name', DisplayName: 'Survey Name', Type: 'string', IsRequired: false, IsReadOnly: true, IsPrimaryKey: false, Description: 'Survey name' },
+            { Name: 'hs_survey_type', DisplayName: 'Survey Type', Type: 'string', IsRequired: false, IsReadOnly: true, IsPrimaryKey: false, Description: 'Type of survey' },
+            { Name: 'hs_submission_name', DisplayName: 'Submission Name', Type: 'string', IsRequired: false, IsReadOnly: true, IsPrimaryKey: false, Description: 'Submission name' },
+            { Name: 'hs_content', DisplayName: 'Content', Type: 'text', IsRequired: false, IsReadOnly: true, IsPrimaryKey: false, Description: 'Submission content' },
+            { Name: 'hs_response_group', DisplayName: 'Response Group', Type: 'string', IsRequired: false, IsReadOnly: true, IsPrimaryKey: false, Description: 'Response group' },
+            { Name: 'hs_sentiment', DisplayName: 'Sentiment', Type: 'string', IsRequired: false, IsReadOnly: true, IsPrimaryKey: false, Description: 'Response sentiment' },
+            { Name: 'hs_survey_channel', DisplayName: 'Channel', Type: 'string', IsRequired: false, IsReadOnly: true, IsPrimaryKey: false, Description: 'Survey channel' },
+            { Name: 'hs_timestamp', DisplayName: 'Timestamp', Type: 'datetime', IsRequired: false, IsReadOnly: true, IsPrimaryKey: false, Description: 'Submission timestamp' },
+            { Name: 'hs_object_id', DisplayName: 'Object ID', Type: 'string', IsRequired: false, IsReadOnly: true, IsPrimaryKey: true, Description: 'HubSpot internal object ID' },
+            { Name: 'createdate', DisplayName: 'Created Date', Type: 'datetime', IsRequired: false, IsReadOnly: true, IsPrimaryKey: false, Description: 'When created' },
+            { Name: 'hs_lastmodifieddate', DisplayName: 'Last Modified', Type: 'datetime', IsRequired: false, IsReadOnly: true, IsPrimaryKey: false, Description: 'When last modified' },
+        ],
+    },
+];
 // ─── Connector ────────────────────────────────────────────────────────
 /**
  * Connector for HubSpot CRM via the HubSpot REST API v3.
@@ -127,7 +316,8 @@ const HUBSPOT_PROPERTIES = {
  *   "MinRequestIntervalMs": 100   // optional, default: 100
  * }
  *
- * DATA SAFETY: This connector is READ-ONLY. It never writes data back to HubSpot.
+ * Supports full CRUD: Get, Create, Update, Delete, Search, and List operations
+ * on all HubSpot CRM object types.
  */
 let HubSpotConnector = class HubSpotConnector extends BaseRESTIntegrationConnector {
     constructor() {
@@ -141,6 +331,195 @@ let HubSpotConnector = class HubSpotConnector extends BaseRESTIntegrationConnect
     get effectiveMaxRetries() { return this._config?.MaxRetries ?? MAX_RETRIES; }
     get effectiveRequestTimeoutMs() { return this._config?.RequestTimeoutMs ?? REQUEST_TIMEOUT_MS; }
     get effectiveMinRequestIntervalMs() { return this._config?.MinRequestIntervalMs ?? MIN_REQUEST_INTERVAL_MS; }
+    // ─── Capability Getters ──────────────────────────────────────────────
+    get SupportsCreate() { return true; }
+    get SupportsUpdate() { return true; }
+    get SupportsDelete() { return true; }
+    get SupportsSearch() { return true; }
+    get SupportsListing() { return true; }
+    get IntegrationName() { return 'HubSpot'; }
+    // ─── Action Metadata ─────────────────────────────────────────────────
+    GetIntegrationObjects() {
+        return HUBSPOT_OBJECTS;
+    }
+    GetActionGeneratorConfig() {
+        const config = super.GetActionGeneratorConfig();
+        if (!config)
+            return null;
+        config.IconClass = 'fa-brands fa-hubspot';
+        config.CreateCategory = false; // HubSpot category already exists in metadata/action-categories
+        return config;
+    }
+    // ─── CRUD Operations ─────────────────────────────────────────────────
+    /**
+     * Retrieves a single record by ExternalID (HubSpot object ID).
+     */
+    async GetRecord(ctx) {
+        const companyIntegration = ctx.CompanyIntegration;
+        const contextUser = ctx.ContextUser;
+        const auth = await this.Authenticate(companyIntegration, contextUser);
+        const headers = this.BuildHeaders(auth);
+        const propertiesParam = this.BuildPropertiesParam(ctx.ObjectName);
+        const url = `${HUBSPOT_API_BASE}/crm/v3/objects/${ctx.ObjectName}/${ctx.ExternalID}?${propertiesParam.replace(/^&/, '')}`;
+        const response = await this.MakeHTTPRequest(auth, url, 'GET', headers);
+        if (response.Status === 404)
+            return null;
+        this.ValidateCRUDResponse(response, 'GetRecord', ctx.ObjectName);
+        const raw = response.Body;
+        return this.RawToExternalRecord(raw, ctx.ObjectName);
+    }
+    /**
+     * Creates a new record in HubSpot.
+     */
+    async CreateRecord(ctx) {
+        const companyIntegration = ctx.CompanyIntegration;
+        const contextUser = ctx.ContextUser;
+        const auth = await this.Authenticate(companyIntegration, contextUser);
+        const headers = this.BuildHeaders(auth);
+        const url = `${HUBSPOT_API_BASE}/crm/v3/objects/${ctx.ObjectName}`;
+        const body = { properties: ctx.Attributes };
+        const response = await this.MakeHTTPRequest(auth, url, 'POST', headers, body);
+        if (response.Status >= 200 && response.Status < 300) {
+            const created = response.Body;
+            return {
+                Success: true,
+                ExternalID: String(created['id'] ?? ''),
+                StatusCode: response.Status,
+            };
+        }
+        return this.BuildCRUDErrorResult(response, 'CreateRecord', ctx.ObjectName);
+    }
+    /**
+     * Updates an existing record in HubSpot by ExternalID.
+     */
+    async UpdateRecord(ctx) {
+        const companyIntegration = ctx.CompanyIntegration;
+        const contextUser = ctx.ContextUser;
+        const auth = await this.Authenticate(companyIntegration, contextUser);
+        const headers = this.BuildHeaders(auth);
+        const url = `${HUBSPOT_API_BASE}/crm/v3/objects/${ctx.ObjectName}/${ctx.ExternalID}`;
+        const body = { properties: ctx.Attributes };
+        const response = await this.MakeHTTPRequest(auth, url, 'PATCH', headers, body);
+        if (response.Status >= 200 && response.Status < 300) {
+            const updated = response.Body;
+            return {
+                Success: true,
+                ExternalID: String(updated['id'] ?? ctx.ExternalID),
+                StatusCode: response.Status,
+            };
+        }
+        return this.BuildCRUDErrorResult(response, 'UpdateRecord', ctx.ObjectName);
+    }
+    /**
+     * Deletes (archives) a record in HubSpot by ExternalID.
+     */
+    async DeleteRecord(ctx) {
+        const companyIntegration = ctx.CompanyIntegration;
+        const contextUser = ctx.ContextUser;
+        const auth = await this.Authenticate(companyIntegration, contextUser);
+        const headers = this.BuildHeaders(auth);
+        const url = `${HUBSPOT_API_BASE}/crm/v3/objects/${ctx.ObjectName}/${ctx.ExternalID}`;
+        const response = await this.MakeHTTPRequest(auth, url, 'DELETE', headers);
+        if (response.Status === 204 || (response.Status >= 200 && response.Status < 300)) {
+            return {
+                Success: true,
+                ExternalID: ctx.ExternalID,
+                StatusCode: response.Status,
+            };
+        }
+        return this.BuildCRUDErrorResult(response, 'DeleteRecord', ctx.ObjectName);
+    }
+    /**
+     * Searches HubSpot objects using the CRM search API.
+     */
+    async SearchRecords(ctx) {
+        const companyIntegration = ctx.CompanyIntegration;
+        const contextUser = ctx.ContextUser;
+        const auth = await this.Authenticate(companyIntegration, contextUser);
+        const headers = this.BuildHeaders(auth);
+        const url = `${HUBSPOT_API_BASE}/crm/v3/objects/${ctx.ObjectName}/search`;
+        const filters = Object.entries(ctx.Filters).map(([propertyName, value]) => ({
+            propertyName,
+            operator: 'EQ',
+            value,
+        }));
+        const properties = this.GetObjectFieldNames(ctx.ObjectName);
+        const body = {
+            filterGroups: [{ filters }],
+            properties,
+            limit: ctx.PageSize ?? 100,
+            after: ctx.Page != null && ctx.Page > 1 ? String((ctx.Page - 1) * (ctx.PageSize ?? 100)) : undefined,
+        };
+        const response = await this.MakeHTTPRequest(auth, url, 'POST', headers, body);
+        this.ValidateCRUDResponse(response, 'SearchRecords', ctx.ObjectName);
+        const responseBody = response.Body;
+        const results = responseBody.results ?? [];
+        const records = results.map(r => this.RawToExternalRecord(r, ctx.ObjectName));
+        return {
+            Records: records,
+            TotalCount: responseBody.total ?? records.length,
+            HasMore: responseBody.paging?.next?.after != null,
+        };
+    }
+    /**
+     * Lists records from a HubSpot object with cursor-based pagination.
+     */
+    async ListRecords(ctx) {
+        const companyIntegration = ctx.CompanyIntegration;
+        const contextUser = ctx.ContextUser;
+        const auth = await this.Authenticate(companyIntegration, contextUser);
+        const headers = this.BuildHeaders(auth);
+        const pageSize = ctx.PageSize ?? 100;
+        const propertiesParam = this.BuildPropertiesParam(ctx.ObjectName);
+        let url = `${HUBSPOT_API_BASE}/crm/v3/objects/${ctx.ObjectName}?limit=${pageSize}${propertiesParam}`;
+        if (ctx.Cursor) {
+            url += `&after=${encodeURIComponent(ctx.Cursor)}`;
+        }
+        const response = await this.MakeHTTPRequest(auth, url, 'GET', headers);
+        this.ValidateCRUDResponse(response, 'ListRecords', ctx.ObjectName);
+        const responseBody = response.Body;
+        const results = responseBody.results ?? [];
+        const records = results.map(r => this.RawToExternalRecord(r, ctx.ObjectName));
+        const nextCursor = responseBody.paging?.next?.after;
+        return {
+            Records: records,
+            HasMore: nextCursor != null,
+            NextCursor: nextCursor ?? undefined,
+            TotalCount: responseBody.total,
+        };
+    }
+    // ─── CRUD Helpers ────────────────────────────────────────────────────
+    /** Converts a raw HubSpot API object to an ExternalRecord. */
+    RawToExternalRecord(raw, objectType) {
+        const flat = this.FlattenHubSpotRecord(raw);
+        return {
+            ExternalID: String(raw['id'] ?? ''),
+            ObjectType: objectType,
+            Fields: flat,
+            ModifiedAt: raw['updatedAt'] ? new Date(raw['updatedAt']) : undefined,
+        };
+    }
+    /** Validates a CRUD response and throws on non-2xx status. */
+    ValidateCRUDResponse(response, operation, objectName) {
+        if (response.Status < 200 || response.Status >= 300) {
+            const bodyPreview = typeof response.Body === 'string'
+                ? response.Body.slice(0, 500)
+                : JSON.stringify(response.Body).slice(0, 500);
+            throw new Error(`[HubSpot] ${operation} on ${objectName} failed (HTTP ${response.Status}): ${bodyPreview}`);
+        }
+    }
+    /** Builds a CRUDResult for error responses. */
+    BuildCRUDErrorResult(response, operation, objectName) {
+        const bodyObj = response.Body;
+        const message = bodyObj?.['message']
+            ? String(bodyObj['message'])
+            : `[HubSpot] ${operation} on ${objectName} failed (HTTP ${response.Status})`;
+        return {
+            Success: false,
+            ErrorMessage: message,
+            StatusCode: response.Status,
+        };
+    }
     // ─── Abstract method implementations (BaseRESTIntegrationConnector) ──
     async Authenticate(companyIntegration, contextUser) {
         console.log(`[HubSpot] Authenticating...`);
@@ -161,7 +540,7 @@ let HubSpotConnector = class HubSpotConnector extends BaseRESTIntegrationConnect
             'Accept': 'application/json',
         };
     }
-    async MakeHTTPRequest(_auth, url, method, headers, _body) {
+    async MakeHTTPRequest(_auth, url, method, headers, body) {
         // Throttle: ensure minimum interval between requests
         const minInterval = this.effectiveMinRequestIntervalMs;
         const elapsed = Date.now() - this.lastRequestTime;
@@ -170,7 +549,7 @@ let HubSpotConnector = class HubSpotConnector extends BaseRESTIntegrationConnect
         }
         const maxRetries = this.effectiveMaxRetries;
         for (let attempt = 0; attempt <= maxRetries; attempt++) {
-            const response = await this.FetchWithTimeout(url, method, headers);
+            const response = await this.FetchWithTimeout(url, method, headers, body);
             this.lastRequestTime = Date.now();
             if (response.status === 429) {
                 const delayMs = this.CalculateRetryDelay(response, attempt);
@@ -179,8 +558,12 @@ let HubSpotConnector = class HubSpotConnector extends BaseRESTIntegrationConnect
                 await this.Sleep(delayMs);
                 continue;
             }
-            const body = await response.json();
-            return this.BuildRESTResponse(response, body);
+            // Handle empty responses (e.g., 204 No Content from DELETE)
+            if (response.status === 204) {
+                return this.BuildRESTResponse(response, {});
+            }
+            const responseBody = await response.json();
+            return this.BuildRESTResponse(response, responseBody);
         }
         throw new Error(`HubSpot API request failed after ${maxRetries} retries: ${url}`);
     }
@@ -428,10 +811,12 @@ let HubSpotConnector = class HubSpotConnector extends BaseRESTIntegrationConnect
     FlattenHubSpotRecord(record) {
         const properties = record['properties'];
         const result = {};
-        // Add flattened properties first
+        // Add flattened properties — HubSpot uses '' to mean "no value" for all
+        // property types, which causes SQL errors on datetime/numeric columns.
+        // Normalize empty strings to null so nullable DB columns receive NULL.
         if (properties) {
             for (const [key, value] of Object.entries(properties)) {
-                result[key] = value;
+                result[key] = value === '' ? null : value;
             }
         }
         // Add system fields (these override any conflicting property names)
@@ -441,6 +826,153 @@ let HubSpotConnector = class HubSpotConnector extends BaseRESTIntegrationConnect
         result['archived'] = record['archived'];
         return result;
     }
+    // ─── Association fetch (v4 API) ───────────────────────────────────
+    /**
+     * Overrides FetchChanges to intercept association objects (Category === 'Association')
+     * and route them through the v4 per-object associations endpoint instead of the
+     * non-existent flat list endpoint stored in APIPath.
+     */
+    async FetchChanges(ctx) {
+        const obj = this.GetCachedObject(ctx.CompanyIntegration.IntegrationID, ctx.ObjectName);
+        if (obj.Category === 'Association') {
+            return this.FetchAssociationChanges(ctx, obj);
+        }
+        return super.FetchChanges(ctx);
+    }
+    /**
+     * Fetches association records in batches by iterating over synced parent (from-side)
+     * objects and calling HubSpot's v4 per-object associations endpoint.
+     *
+     * Uses ctx.CurrentOffset to track parent position across batch calls, so the engine
+     * can page through all parents without truncating records.
+     */
+    async FetchAssociationChanges(ctx, obj) {
+        const parsed = this.ParseAssociationPath(obj.APIPath);
+        if (!parsed) {
+            console.warn(`[HubSpot] Cannot parse association path: ${obj.APIPath}`);
+            return { Records: [], HasMore: false };
+        }
+        const { fromType, toType } = parsed;
+        const fields = this.GetCachedFields(obj.ID);
+        const auth = await this.Authenticate(ctx.CompanyIntegration, ctx.ContextUser);
+        const baseURL = this.GetBaseURL(ctx.CompanyIntegration, auth);
+        // Association objects have two PK fields: left (from-side) and right (to-side)
+        const pkFields = fields.filter(f => f.IsPrimaryKey).sort((a, b) => a.Sequence - b.Sequence);
+        const leftFieldName = pkFields[0]?.Name ?? `${fromType.replace(/s$/, '')}_id`;
+        const rightFieldName = pkFields[1]?.Name ?? `${toType.replace(/s$/, '')}_id`;
+        const parentIDs = await this.LoadAssociationParentIDs(fromType, ctx);
+        const parentOffset = ctx.CurrentOffset ?? 0;
+        if (parentOffset === 0) {
+            console.log(`[HubSpot] Fetching ${obj.Name}: ${parentIDs.length} parent ${fromType} to iterate`);
+        }
+        const batchSize = Math.min(ctx.BatchSize ?? 200, 200);
+        const batchRecords = [];
+        let parentIndex = parentOffset;
+        while (parentIndex < parentIDs.length && batchRecords.length < batchSize) {
+            const parentID = parentIDs[parentIndex];
+            const basePath = `${baseURL}/crm/v4/objects/${fromType}/${parentID}/associations/${toType}`;
+            const rawRecords = await this.FetchAllAssociationPages(auth, basePath, obj.DefaultPageSize ?? 500);
+            let addedAll = true;
+            for (const record of rawRecords) {
+                if (batchRecords.length >= batchSize) {
+                    addedAll = false;
+                    break;
+                }
+                const flat = this.FlattenAssociationRecord(record, leftFieldName, parentID, rightFieldName);
+                batchRecords.push({
+                    ExternalID: `${flat[leftFieldName]}|${flat[rightFieldName]}`,
+                    ObjectType: ctx.ObjectName,
+                    Fields: flat,
+                });
+            }
+            if (addedAll) {
+                parentIndex++;
+            }
+            else {
+                // Don't advance — next batch re-fetches this parent so no records are lost
+                break;
+            }
+        }
+        const hasMore = parentIndex < parentIDs.length;
+        console.log(`[HubSpot] ${obj.Name}: fetched ${batchRecords.length} association records (parents ${parentOffset}-${parentIndex - 1} of ${parentIDs.length})`);
+        return { Records: batchRecords, HasMore: hasMore, NextOffset: hasMore ? parentIndex : undefined };
+    }
+    /**
+     * Paginates through all pages of a HubSpot v4 per-object association endpoint,
+     * returning the raw result items (each with toObjectId + associationTypes).
+     */
+    async FetchAllAssociationPages(auth, basePath, pageSize) {
+        const headers = this.BuildHeaders(auth);
+        const allRecords = [];
+        let cursor;
+        do {
+            const url = cursor
+                ? `${basePath}?limit=${pageSize}&after=${encodeURIComponent(cursor)}`
+                : `${basePath}?limit=${pageSize}`;
+            const response = await this.MakeHTTPRequest(auth, url, 'GET', headers);
+            if (response.Status < 200 || response.Status >= 300)
+                break;
+            const body = response.Body;
+            const results = body['results'];
+            if (!results || !Array.isArray(results) || results.length === 0)
+                break;
+            allRecords.push(...results);
+            const paging = body['paging'];
+            cursor = paging?.next?.after;
+        } while (cursor);
+        return allRecords;
+    }
+    /**
+     * Converts a HubSpot v4 association result item into a flat record suitable for storage.
+     * v4 format: { toObjectId: number, associationTypes: [{ label, typeId, category }] }
+     */
+    FlattenAssociationRecord(record, leftFieldName, leftValue, rightFieldName) {
+        const assocTypes = record['associationTypes'];
+        return {
+            [leftFieldName]: leftValue,
+            [rightFieldName]: String(record['toObjectId']),
+            association_type: assocTypes?.[0]?.label ?? null,
+        };
+    }
+    /**
+     * Parses a v4 associations APIPath to extract from/to object type names.
+     * E.g., "/crm/v4/associations/contacts/companies" → { fromType: "contacts", toType: "companies" }
+     */
+    ParseAssociationPath(apiPath) {
+        const match = /\/crm\/v4\/associations\/([^/?]+)\/([^/?]+)/.exec(apiPath);
+        if (!match)
+            return null;
+        return { fromType: match[1], toType: match[2] };
+    }
+    /**
+     * Loads hs_object_id values for all synced records of a given HubSpot object type
+     * by finding its entity map and querying the local MJ entity.
+     */
+    async LoadAssociationParentIDs(fromType, ctx) {
+        const rv = new RunView();
+        const entityMapResult = await rv.RunView({
+            EntityName: 'MJ: Company Integration Entity Maps',
+            ExtraFilter: `ExternalObjectName='${fromType}' AND SyncEnabled=1 AND CompanyIntegrationID='${ctx.CompanyIntegration.ID}'`,
+            Fields: ['Entity'],
+            MaxRows: 1,
+            ResultType: 'simple',
+        }, ctx.ContextUser);
+        if (!entityMapResult.Success || entityMapResult.Results.length === 0) {
+            console.warn(`[HubSpot] No entity map found for ${fromType} — skipping association fetch`);
+            return [];
+        }
+        const entityName = entityMapResult.Results[0].Entity;
+        const idsResult = await rv.RunView({
+            EntityName: entityName,
+            Fields: ['hs_object_id'],
+            ResultType: 'simple',
+        }, ctx.ContextUser);
+        if (!idsResult.Success)
+            return [];
+        return idsResult.Results
+            .map(r => String(r['hs_object_id']))
+            .filter(id => id && id !== 'undefined' && id !== 'null');
+    }
     // ─── URL helpers ─────────────────────────────────────────────────
     /**
      * Extracts the HubSpot object name from an API path.
@@ -453,25 +985,38 @@ let HubSpotConnector = class HubSpotConnector extends BaseRESTIntegrationConnect
         const segments = pathOnly.split('/').filter(s => s.length > 0);
         return segments[segments.length - 1] ?? '';
     }
+    /**
+     * Returns the known field names for a HubSpot object type, derived from
+     * the HUBSPOT_OBJECTS metadata (single source of truth).
+     */
+    GetObjectFieldNames(objectName) {
+        const obj = HUBSPOT_OBJECTS.find(o => o.Name === objectName);
+        return obj ? obj.Fields.map(f => f.Name) : [];
+    }
     /**
      * Builds the `properties` query parameter for a HubSpot object type.
      * Returns empty string if no properties are configured for the object.
      */
     BuildPropertiesParam(objectName) {
-        const properties = HUBSPOT_PROPERTIES[objectName];
-        if (properties && properties.length > 0) {
+        const properties = this.GetObjectFieldNames(objectName);
+        if (properties.length > 0) {
             return `&properties=${properties.join(',')}`;
         }
         return '';
     }
     // ─── HTTP helpers ────────────────────────────────────────────────
-    /** Executes an HTTP request with a timeout. */
-    async FetchWithTimeout(url, method, headers) {
+    /** Executes an HTTP request with a timeout and optional JSON body. */
+    async FetchWithTimeout(url, method, headers, body) {
         const controller = new AbortController();
         const timeoutMs = this.effectiveRequestTimeoutMs;
         const timeoutId = setTimeout(() => controller.abort(), timeoutMs);
         try {
-            return await fetch(url, { method, headers, signal: controller.signal });
+            const requestInit = { method, headers, signal: controller.signal };
+            if (body !== undefined) {
+                requestInit.body = JSON.stringify(body);
+                requestInit.headers['Content-Type'] = 'application/json';
+            }
+            return await fetch(url, requestInit);
         }
         catch (err) {
             if (err instanceof Error && err.name === 'AbortError') {