attio-mcp 1.3.5 → 1.4.0

package/dist/config/tool-aliases.js

@@ -1,74 +1,218 @@
+/**
+ * Tool alias registry for backward compatibility.
+ *
+ * This module provides a data-driven approach to tool aliasing, supporting
+ * two alias patterns from the pre-MCP compliance era:
+ * 1. Noun-verb snake_case (e.g., records_search → search_records)
+ * 2. Kebab-case (e.g., search-records → search_records)
+ *
+ * @see Issue #1039 for MCP compliance context
+ * @see Issue #1040 for dual alias system implementation
+ * @see Issue #1041 for refactoring improvements
+ */
 import { warn } from '../utils/logger.js';
+import { TOOL_NAMES } from '../constants/tool-names.js';
 const TOOL_ALIAS_FLAG = 'MCP_DISABLE_TOOL_ALIASES';
-const SINCE_PHASE_1 = '2025-09-30';
-const TOOL_ALIAS_REGISTRY = Object.freeze({
-    'search-records': {
-        target: 'records_search',
-        reason: 'Phase 1 search tool rename (#776)',
-        since: SINCE_PHASE_1,
-        removal: 'v1.x (TBD)',
-    },
-    'get-record-details': {
-        target: 'records_get_details',
-        reason: 'Phase 1 search tool rename (#776)',
-        since: SINCE_PHASE_1,
-        removal: 'v1.x (TBD)',
-    },
-    'get-attributes': {
-        target: 'records_get_attributes',
-        reason: 'Phase 1 search tool rename (#776)',
-        since: SINCE_PHASE_1,
-        removal: 'v1.x (TBD)',
-    },
-    'discover-attributes': {
-        target: 'records_discover_attributes',
-        reason: 'Phase 1 search tool rename (#776)',
-        since: SINCE_PHASE_1,
-        removal: 'v1.x (TBD)',
-    },
-    'get-detailed-info': {
-        target: 'records_get_info',
-        reason: 'Phase 1 search tool rename (#776)',
-        since: SINCE_PHASE_1,
-        removal: 'v1.x (TBD)',
-    },
-    'advanced-search': {
-        target: 'records_search_advanced',
-        reason: 'Phase 1 search tool rename (#776)',
-        since: SINCE_PHASE_1,
-        removal: 'v1.x (TBD)',
-    },
-    'search-by-relationship': {
-        target: 'records_search_by_relationship',
-        reason: 'Phase 1 search tool rename (#776)',
-        since: SINCE_PHASE_1,
-        removal: 'v1.x (TBD)',
-    },
-    'search-by-content': {
-        target: 'records_search_by_content',
-        reason: 'Phase 1 search tool rename (#776)',
-        since: SINCE_PHASE_1,
-        removal: 'v1.x (TBD)',
-    },
-    'search-by-timeframe': {
-        target: 'records_search_by_timeframe',
-        reason: 'Phase 1 search tool rename (#776)',
-        since: SINCE_PHASE_1,
-        removal: 'v1.x (TBD)',
-    },
-    'batch-operations': {
-        target: 'records_batch',
-        reason: 'Phase 1 search tool rename (#776)',
-        since: SINCE_PHASE_1,
-        removal: 'v1.x (TBD)',
-    },
-    'batch-search': {
-        target: 'records_search_batch',
-        reason: 'Phase 1 search tool rename (#776)',
-        since: SINCE_PHASE_1,
-        removal: 'v1.x (TBD)',
-    },
-});
+const SINCE_MCP_COMPLIANCE = '2025-12-16';
+const REMOVAL_VERSION = 'v2.0.0';
+/**
+ * Generates noun-verb to verb-first aliases.
+ * Pattern: records_{verb} → {verb}_records
+ *
+ * Examples:
+ * - records_search → search_records
+ * - records_batch → batch_records
+ * - records_get_details → get_record_details
+ */
+const NOUN_VERB_ALIASES = [
+    {
+        alias: 'records_search',
+        target: TOOL_NAMES.SEARCH_RECORDS,
+        reason: 'MCP compliance: verb-first snake_case (#1039)',
+    },
+    {
+        alias: 'records_get_details',
+        target: TOOL_NAMES.GET_RECORD_DETAILS,
+        reason: 'MCP compliance: verb-first snake_case (#1039)',
+    },
+    {
+        alias: 'records_get_attributes',
+        target: TOOL_NAMES.GET_RECORD_ATTRIBUTES,
+        reason: 'MCP compliance: verb-first snake_case (#1039)',
+    },
+    {
+        alias: 'records_discover_attributes',
+        target: TOOL_NAMES.DISCOVER_RECORD_ATTRIBUTES,
+        reason: 'MCP compliance: verb-first snake_case (#1039)',
+    },
+    {
+        alias: 'records_get_attribute_options',
+        target: TOOL_NAMES.GET_RECORD_ATTRIBUTE_OPTIONS,
+        reason: 'MCP compliance: verb-first snake_case (#1039)',
+    },
+    {
+        alias: 'records_get_info',
+        target: TOOL_NAMES.GET_RECORD_INFO,
+        reason: 'MCP compliance: verb-first snake_case (#1039)',
+    },
+    {
+        alias: 'records_search_advanced',
+        target: TOOL_NAMES.SEARCH_RECORDS_ADVANCED,
+        reason: 'MCP compliance: verb-first snake_case (#1039)',
+    },
+    {
+        alias: 'records_search_by_relationship',
+        target: TOOL_NAMES.SEARCH_RECORDS_BY_RELATIONSHIP,
+        reason: 'MCP compliance: verb-first snake_case (#1039)',
+    },
+    {
+        alias: 'records_search_by_content',
+        target: TOOL_NAMES.SEARCH_RECORDS_BY_CONTENT,
+        reason: 'MCP compliance: verb-first snake_case (#1039)',
+    },
+    {
+        alias: 'records_search_by_timeframe',
+        target: TOOL_NAMES.SEARCH_RECORDS_BY_TIMEFRAME,
+        reason: 'MCP compliance: verb-first snake_case (#1039)',
+    },
+    {
+        alias: 'records_batch',
+        target: TOOL_NAMES.BATCH_RECORDS,
+        reason: 'MCP compliance: verb-first snake_case (#1039)',
+    },
+    {
+        alias: 'records_search_batch',
+        target: TOOL_NAMES.BATCH_SEARCH_RECORDS,
+        reason: 'MCP compliance: verb-first snake_case (#1039)',
+    },
+];
+/**
+ * Generates kebab-case to snake_case aliases.
+ * Pattern: {name-with-dashes} → {name_with_underscores}
+ *
+ * Examples:
+ * - search-records → search_records
+ * - create-record → create_record
+ * - get-record-details → get_record_details
+ */
+const KEBAB_CASE_ALIASES = [
+    // Search/metadata tools
+    {
+        alias: 'search-records',
+        target: TOOL_NAMES.SEARCH_RECORDS,
+        reason: 'MCP compliance: snake_case over kebab-case (#1039)',
+    },
+    {
+        alias: 'get-record-details',
+        target: TOOL_NAMES.GET_RECORD_DETAILS,
+        reason: 'MCP compliance: snake_case over kebab-case (#1039)',
+    },
+    {
+        alias: 'get-attributes',
+        target: TOOL_NAMES.GET_RECORD_ATTRIBUTES,
+        reason: 'MCP compliance: snake_case over kebab-case (#1039)',
+    },
+    {
+        alias: 'discover-attributes',
+        target: TOOL_NAMES.DISCOVER_RECORD_ATTRIBUTES,
+        reason: 'MCP compliance: snake_case over kebab-case (#1039)',
+    },
+    {
+        alias: 'get-detailed-info',
+        target: TOOL_NAMES.GET_RECORD_INFO,
+        reason: 'MCP compliance: snake_case over kebab-case (#1039)',
+    },
+    // Advanced search tools
+    {
+        alias: 'advanced-search',
+        target: TOOL_NAMES.SEARCH_RECORDS_ADVANCED,
+        reason: 'MCP compliance: snake_case over kebab-case (#1039)',
+    },
+    {
+        alias: 'search-by-relationship',
+        target: TOOL_NAMES.SEARCH_RECORDS_BY_RELATIONSHIP,
+        reason: 'MCP compliance: snake_case over kebab-case (#1039)',
+    },
+    {
+        alias: 'search-by-content',
+        target: TOOL_NAMES.SEARCH_RECORDS_BY_CONTENT,
+        reason: 'MCP compliance: snake_case over kebab-case (#1039)',
+    },
+    {
+        alias: 'search-by-timeframe',
+        target: TOOL_NAMES.SEARCH_RECORDS_BY_TIMEFRAME,
+        reason: 'MCP compliance: snake_case over kebab-case (#1039)',
+    },
+    // Batch tools
+    {
+        alias: 'batch-operations',
+        target: TOOL_NAMES.BATCH_RECORDS,
+        reason: 'MCP compliance: snake_case over kebab-case (#1039)',
+    },
+    {
+        alias: 'batch-search',
+        target: TOOL_NAMES.BATCH_SEARCH_RECORDS,
+        reason: 'MCP compliance: snake_case over kebab-case (#1039)',
+    },
+    // CRUD tools
+    {
+        alias: 'create-record',
+        target: TOOL_NAMES.CREATE_RECORD,
+        reason: 'MCP compliance: snake_case over kebab-case (#1039)',
+    },
+    {
+        alias: 'update-record',
+        target: TOOL_NAMES.UPDATE_RECORD,
+        reason: 'MCP compliance: snake_case over kebab-case (#1039)',
+    },
+    {
+        alias: 'delete-record',
+        target: TOOL_NAMES.DELETE_RECORD,
+        reason: 'MCP compliance: snake_case over kebab-case (#1039)',
+    },
+    // Note tools
+    {
+        alias: 'create-note',
+        target: TOOL_NAMES.CREATE_NOTE,
+        reason: 'MCP compliance: snake_case over kebab-case (#1039)',
+    },
+    {
+        alias: 'list-notes',
+        target: TOOL_NAMES.LIST_NOTES,
+        reason: 'MCP compliance: snake_case over kebab-case (#1039)',
+    },
+    // Debug tools
+    {
+        alias: 'smithery-debug-config',
+        target: TOOL_NAMES.SMITHERY_DEBUG_CONFIG,
+        reason: 'MCP compliance: snake_case over kebab-case (#1039)',
+    },
+];
+/**
+ * Generates complete alias registry from pattern definitions.
+ *
+ * @param patterns - Array of alias patterns to convert to registry
+ * @returns Frozen registry object with metadata
+ */
+function generateAliasRegistry(patterns) {
+    const registry = {};
+    for (const pattern of patterns) {
+        registry[pattern.alias] = {
+            target: pattern.target,
+            reason: pattern.reason,
+            since: SINCE_MCP_COMPLIANCE,
+            removal: REMOVAL_VERSION,
+        };
+    }
+    return Object.freeze(registry);
+}
+/**
+ * Complete tool alias registry (29 aliases total).
+ */
+const TOOL_ALIAS_REGISTRY = generateAliasRegistry([
+    ...NOUN_VERB_ALIASES,
+    ...KEBAB_CASE_ALIASES,
+]);
 function aliasesEnabled() {
     return process.env[TOOL_ALIAS_FLAG] !== 'true';
 }

package/dist/config/tool-aliases.js.map

@@ -1 +1 @@
-{"version":3,"file":"tool-aliases.js","sourceRoot":"","sources":["../../src/config/tool-aliases.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"tool-aliases.js","sourceRoot":"","sources":["../../src/config/tool-aliases.ts"],"names":[],"mappings":"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"}

package/dist/constants/tool-names.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Type-safe tool name constants.
+ *
+ * This module provides centralized tool name constants with TypeScript type safety.
+ * Use these constants instead of string literals to:
+ * - Prevent typos in tool names
+ * - Enable autocomplete/IntelliSense
+ * - Easier refactoring across codebase
+ * - Type-safe tool name references
+ *
+ * @example
+ * ```typescript
+ * import { TOOL_NAMES } from '../constants/tool-names.js';
+ *
+ * const toolName = TOOL_NAMES.SEARCH_RECORDS; // Type-safe, autocompletes
+ * ```
+ *
+ * @see Issue #1041 for refactoring context
+ */
+/**
+ * All canonical MCP-compliant tool names (snake_case, verb-first).
+ *
+ * NOTE: Excludes special tools that use kebab-case by design:
+ * - aaa-health-check (health monitoring)
+ * - openai-search, openai-fetch (OpenAI integration)
+ *
+ * These special tools are not included because they intentionally use
+ * kebab-case naming for specific integration purposes.
+ */
+export declare const TOOL_NAMES: {
+    readonly SEARCH_RECORDS: "search_records";
+    readonly GET_RECORD_DETAILS: "get_record_details";
+    readonly GET_RECORD_ATTRIBUTES: "get_record_attributes";
+    readonly DISCOVER_RECORD_ATTRIBUTES: "discover_record_attributes";
+    readonly GET_RECORD_ATTRIBUTE_OPTIONS: "get_record_attribute_options";
+    readonly GET_RECORD_INFO: "get_record_info";
+    readonly SEARCH_RECORDS_ADVANCED: "search_records_advanced";
+    readonly SEARCH_RECORDS_BY_RELATIONSHIP: "search_records_by_relationship";
+    readonly SEARCH_RECORDS_BY_CONTENT: "search_records_by_content";
+    readonly SEARCH_RECORDS_BY_TIMEFRAME: "search_records_by_timeframe";
+    readonly BATCH_RECORDS: "batch_records";
+    readonly BATCH_SEARCH_RECORDS: "batch_search_records";
+    readonly CREATE_RECORD: "create_record";
+    readonly UPDATE_RECORD: "update_record";
+    readonly DELETE_RECORD: "delete_record";
+    readonly CREATE_NOTE: "create_note";
+    readonly LIST_NOTES: "list_notes";
+    readonly SMITHERY_DEBUG_CONFIG: "smithery_debug_config";
+};
+/**
+ * Union type of all valid tool names.
+ *
+ * @example
+ * ```typescript
+ * function processTool(name: ToolName) {
+ *   // name is guaranteed to be one of the valid tool names
+ * }
+ * ```
+ */
+export type ToolName = (typeof TOOL_NAMES)[keyof typeof TOOL_NAMES];
+/**
+ * Type guard to check if a string is a valid tool name.
+ *
+ * @param name - The string to check
+ * @returns True if the string is a valid tool name
+ *
+ * @example
+ * ```typescript
+ * if (isToolName(userInput)) {
+ *   // userInput is now typed as ToolName
+ *   processTool(userInput);
+ * }
+ * ```
+ */
+export declare function isToolName(name: string): name is ToolName;
+/**
+ * Array of all canonical tool names (for iteration).
+ */
+export declare const ALL_TOOL_NAMES: ("list_notes" | "create_record" | "update_record" | "delete_record" | "create_note" | "search_records" | "get_record_details" | "get_record_attributes" | "discover_record_attributes" | "get_record_attribute_options" | "get_record_info" | "search_records_advanced" | "search_records_by_relationship" | "search_records_by_content" | "search_records_by_timeframe" | "batch_records" | "batch_search_records" | "smithery_debug_config")[];
+/**
+ * Total count of canonical tools in the system.
+ */
+export declare const TOOL_COUNT: number;
+//# sourceMappingURL=tool-names.d.ts.map

package/dist/constants/tool-names.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-names.d.ts","sourceRoot":"","sources":["../../src/constants/tool-names.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH;;;;;;;;;GASG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;CA8Bb,CAAC;AAEX;;;;;;;;;GASG;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,OAAO,UAAU,CAAC,CAAC;AAEpE;;;;;;;;;;;;;GAaG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,IAAI,QAAQ,CAEzD;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,kbAA4B,CAAC;AAExD;;GAEG;AACH,eAAO,MAAM,UAAU,QAAwB,CAAC"}

package/dist/constants/tool-names.js

@@ -0,0 +1,81 @@
+/**
+ * Type-safe tool name constants.
+ *
+ * This module provides centralized tool name constants with TypeScript type safety.
+ * Use these constants instead of string literals to:
+ * - Prevent typos in tool names
+ * - Enable autocomplete/IntelliSense
+ * - Easier refactoring across codebase
+ * - Type-safe tool name references
+ *
+ * @example
+ * ```typescript
+ * import { TOOL_NAMES } from '../constants/tool-names.js';
+ *
+ * const toolName = TOOL_NAMES.SEARCH_RECORDS; // Type-safe, autocompletes
+ * ```
+ *
+ * @see Issue #1041 for refactoring context
+ */
+/**
+ * All canonical MCP-compliant tool names (snake_case, verb-first).
+ *
+ * NOTE: Excludes special tools that use kebab-case by design:
+ * - aaa-health-check (health monitoring)
+ * - openai-search, openai-fetch (OpenAI integration)
+ *
+ * These special tools are not included because they intentionally use
+ * kebab-case naming for specific integration purposes.
+ */
+export const TOOL_NAMES = {
+    // Core search/metadata tools
+    SEARCH_RECORDS: 'search_records',
+    GET_RECORD_DETAILS: 'get_record_details',
+    GET_RECORD_ATTRIBUTES: 'get_record_attributes',
+    DISCOVER_RECORD_ATTRIBUTES: 'discover_record_attributes',
+    GET_RECORD_ATTRIBUTE_OPTIONS: 'get_record_attribute_options',
+    GET_RECORD_INFO: 'get_record_info',
+    // Advanced search tools
+    SEARCH_RECORDS_ADVANCED: 'search_records_advanced',
+    SEARCH_RECORDS_BY_RELATIONSHIP: 'search_records_by_relationship',
+    SEARCH_RECORDS_BY_CONTENT: 'search_records_by_content',
+    SEARCH_RECORDS_BY_TIMEFRAME: 'search_records_by_timeframe',
+    // Batch tools
+    BATCH_RECORDS: 'batch_records',
+    BATCH_SEARCH_RECORDS: 'batch_search_records',
+    // CRUD tools
+    CREATE_RECORD: 'create_record',
+    UPDATE_RECORD: 'update_record',
+    DELETE_RECORD: 'delete_record',
+    // Note tools
+    CREATE_NOTE: 'create_note',
+    LIST_NOTES: 'list_notes',
+    // Debug tools
+    SMITHERY_DEBUG_CONFIG: 'smithery_debug_config',
+};
+/**
+ * Type guard to check if a string is a valid tool name.
+ *
+ * @param name - The string to check
+ * @returns True if the string is a valid tool name
+ *
+ * @example
+ * ```typescript
+ * if (isToolName(userInput)) {
+ *   // userInput is now typed as ToolName
+ *   processTool(userInput);
+ * }
+ * ```
+ */
+export function isToolName(name) {
+    return Object.values(TOOL_NAMES).includes(name);
+}
+/**
+ * Array of all canonical tool names (for iteration).
+ */
+export const ALL_TOOL_NAMES = Object.values(TOOL_NAMES);
+/**
+ * Total count of canonical tools in the system.
+ */
+export const TOOL_COUNT = ALL_TOOL_NAMES.length;
+//# sourceMappingURL=tool-names.js.map

package/dist/constants/tool-names.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-names.js","sourceRoot":"","sources":["../../src/constants/tool-names.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,6BAA6B;IAC7B,cAAc,EAAE,gBAAgB;IAChC,kBAAkB,EAAE,oBAAoB;IACxC,qBAAqB,EAAE,uBAAuB;IAC9C,0BAA0B,EAAE,4BAA4B;IACxD,4BAA4B,EAAE,8BAA8B;IAC5D,eAAe,EAAE,iBAAiB;IAElC,wBAAwB;IACxB,uBAAuB,EAAE,yBAAyB;IAClD,8BAA8B,EAAE,gCAAgC;IAChE,yBAAyB,EAAE,2BAA2B;IACtD,2BAA2B,EAAE,6BAA6B;IAE1D,cAAc;IACd,aAAa,EAAE,eAAe;IAC9B,oBAAoB,EAAE,sBAAsB;IAE5C,aAAa;IACb,aAAa,EAAE,eAAe;IAC9B,aAAa,EAAE,eAAe;IAC9B,aAAa,EAAE,eAAe;IAE9B,aAAa;IACb,WAAW,EAAE,aAAa;IAC1B,UAAU,EAAE,YAAY;IAExB,cAAc;IACd,qBAAqB,EAAE,uBAAuB;CACtC,CAAC;AAcX;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAO,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,QAAQ,CAAC,IAAgB,CAAC,CAAC;AAC9D,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;AAExD;;GAEG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,cAAc,CAAC,MAAM,CAAC"}

package/dist/constants/universal.constants.d.ts

@@ -61,6 +61,18 @@ export declare const COMPANY_FIELD_MAPPINGS: {
     employee_count: string;
     headcount: string;
     staff_count: string;
+    linkedin_url: string;
+    linkedin_link: string;
+    linkedinUrl: string;
+    linkedIn: string;
+    twitter_url: string;
+    twitter_handle: string;
+    twitter_link: string;
+    twitterHandle: string;
+    twitterUrl: string;
+    facebook_url: string;
+    facebook_link: string;
+    facebookUrl: string;
 };
 export declare const COMPANY_VALID_FIELDS: string[];
 export declare const COMPANY_COMMON_MISTAKES: {
@@ -96,6 +108,18 @@ export declare const PEOPLE_FIELD_MAPPINGS: {
     job_role: string;
     occupation: string;
     designation: string;
+    linkedin_url: string;
+    linkedin_link: string;
+    linkedinUrl: string;
+    linkedIn: string;
+    twitter_url: string;
+    twitter_handle: string;
+    twitter_link: string;
+    twitterHandle: string;
+    twitterUrl: string;
+    facebook_url: string;
+    facebook_link: string;
+    facebookUrl: string;
 };
 export declare const PEOPLE_VALID_FIELDS: string[];
 export declare const PEOPLE_COMMON_MISTAKES: {

package/dist/constants/universal.constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"universal.constants.d.ts","sourceRoot":"","sources":["../../src/constants/universal.constants.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,6CAA6C,CAAC;AAMpF,+DAA+D;AAC/D,eAAO,MAAM,uBAAuB,QAAQ,CAAC;AAE7C,sEAAsE;AACtE,eAAO,MAAM,qBAAqB,QAAQ,CAAC;AAE3C,4EAA4E;AAC5E,eAAO,MAAM,4BAA4B,SAAS,CAAC;AAEnD,qDAAqD;AACrD,eAAO,MAAM,iBAAiB,OAAO,CAAC;AAMtC,iEAAiE;AACjE,eAAO,MAAM,0BAA0B,IAAI,CAAC;AAE5C,mDAAmD;AACnD,eAAO,MAAM,0BAA0B,MAAM,CAAC;AAE9C,8CAA8C;AAC9C,eAAO,MAAM,uBAAuB,QAAQ,CAAC;AAE7C,qDAAqD;AACrD,eAAO,MAAM,kBAAkB,IAAI,CAAC;AAEpC,iDAAiD;AACjD,eAAO,MAAM,gBAAgB,OAAO,CAAC;AAMrC;;;GAGG;AACH,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CA4BxE,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAQlD,CAAC;AAMF,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;CA8BlC,CAAC;AAEF,eAAO,MAAM,oBAAoB,UAehC,CAAC;AAEF,eAAO,MAAM,uBAAuB;;;;;;CAMnC,CAAC;AAMF,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;CAiCjC,CAAC;AAEF,eAAO,MAAM,mBAAmB,UAY/B,CAAC;AAEF,eAAO,MAAM,sBAAsB;;;;;CAKlC,CAAC;AAMF,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0C/B,CAAC;AAEF,eAAO,MAAM,iBAAiB,UAS7B,CAAC;AAEF,eAAO,MAAM,oBAAoB;;;;;;CAMhC,CAAC;AAMF,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;CAyB/B,CAAC;AAEF,eAAO,MAAM,iBAAiB,UAW7B,CAAC;AAEF,eAAO,MAAM,oBAAoB;;;;;CAKhC,CAAC;AAMF,eAAO,MAAM,qBAAqB;;;CAIjC,CAAC;AAEF,eAAO,MAAM,mBAAmB,UAS/B,CAAC;AAEF,eAAO,MAAM,sBAAsB;;CAElC,CAAC;AAMF,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;CAwB/B,CAAC;AAEF,eAAO,MAAM,iBAAiB,UAQ7B,CAAC;AAEF,eAAO,MAAM,oBAAoB;;;;;CAMhC,CAAC;AAMF,eAAO,MAAM,cAAc;kCACK,MAAM;oCACJ,MAAM;gCACV,MAAM,YAAY,MAAM,YAAY,MAAM;8BAE5C,MAAM,EAAE,UAAU,MAAM;+CAEP,MAAM;;sCAGf,MAAM;CAEzC,CAAC;AAMF,iEAAiE;AACjE,eAAO,MAAM,aAAa,QAA+B,CAAC;AAE1D,mEAAmE;AACnE,eAAO,MAAM,aAAa,QAAqB,CAAC;AAEhD,mCAAmC;AACnC,eAAO,MAAM,WAAW,QAAoB,CAAC;AAE7C,0CAA0C;AAC1C,eAAO,MAAM,YAAY,QACqD,CAAC;AAM/E,8CAA8C;AAC9C,eAAO,MAAM,aAAa,UAWzB,CAAC;AAEF,+CAA+C;AAC/C,eAAO,MAAM,YAAY,UAWxB,CAAC;AAMF,+CAA+C;AAC/C,eAAO,MAAM,iBAAiB,KAAK,CAAC;AAEpC,gCAAgC;AAChC,eAAO,MAAM,aAAa,MAAM,CAAC;AAEjC,uCAAuC;AACvC,eAAO,MAAM,oBAAoB,KAAK,CAAC;AAEvC,mCAAmC;AACnC,eAAO,MAAM,gBAAgB,MAAM,CAAC"}
+{"version":3,"file":"universal.constants.d.ts","sourceRoot":"","sources":["../../src/constants/universal.constants.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,6CAA6C,CAAC;AAMpF,+DAA+D;AAC/D,eAAO,MAAM,uBAAuB,QAAQ,CAAC;AAE7C,sEAAsE;AACtE,eAAO,MAAM,qBAAqB,QAAQ,CAAC;AAE3C,4EAA4E;AAC5E,eAAO,MAAM,4BAA4B,SAAS,CAAC;AAEnD,qDAAqD;AACrD,eAAO,MAAM,iBAAiB,OAAO,CAAC;AAMtC,iEAAiE;AACjE,eAAO,MAAM,0BAA0B,IAAI,CAAC;AAE5C,mDAAmD;AACnD,eAAO,MAAM,0BAA0B,MAAM,CAAC;AAE9C,8CAA8C;AAC9C,eAAO,MAAM,uBAAuB,QAAQ,CAAC;AAE7C,qDAAqD;AACrD,eAAO,MAAM,kBAAkB,IAAI,CAAC;AAEpC,iDAAiD;AACjD,eAAO,MAAM,gBAAgB,OAAO,CAAC;AAMrC;;;GAGG;AACH,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CA4BxE,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAQlD,CAAC;AAMF,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgDlC,CAAC;AAEF,eAAO,MAAM,oBAAoB,UA8ChC,CAAC;AAEF,eAAO,MAAM,uBAAuB;;;;;;CAMnC,CAAC;AAMF,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmDjC,CAAC;AAEF,eAAO,MAAM,mBAAmB,UAkC/B,CAAC;AAEF,eAAO,MAAM,sBAAsB;;;;;CAKlC,CAAC;AAMF,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0C/B,CAAC;AAEF,eAAO,MAAM,iBAAiB,UAS7B,CAAC;AAEF,eAAO,MAAM,oBAAoB;;;;;;CAMhC,CAAC;AAMF,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;CAyB/B,CAAC;AAEF,eAAO,MAAM,iBAAiB,UAW7B,CAAC;AAEF,eAAO,MAAM,oBAAoB;;;;;CAKhC,CAAC;AAMF,eAAO,MAAM,qBAAqB;;;CAIjC,CAAC;AAEF,eAAO,MAAM,mBAAmB,UAS/B,CAAC;AAEF,eAAO,MAAM,sBAAsB;;CAElC,CAAC;AAMF,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;CAwB/B,CAAC;AAEF,eAAO,MAAM,iBAAiB,UAQ7B,CAAC;AAEF,eAAO,MAAM,oBAAoB;;;;;CAMhC,CAAC;AAMF,eAAO,MAAM,cAAc;kCACK,MAAM;oCACJ,MAAM;gCACV,MAAM,YAAY,MAAM,YAAY,MAAM;8BAE5C,MAAM,EAAE,UAAU,MAAM;+CAEP,MAAM;;sCAGf,MAAM;CAEzC,CAAC;AAMF,iEAAiE;AACjE,eAAO,MAAM,aAAa,QAA+B,CAAC;AAE1D,mEAAmE;AACnE,eAAO,MAAM,aAAa,QAAqB,CAAC;AAEhD,mCAAmC;AACnC,eAAO,MAAM,WAAW,QAAoB,CAAC;AAE7C,0CAA0C;AAC1C,eAAO,MAAM,YAAY,QACqD,CAAC;AAM/E,8CAA8C;AAC9C,eAAO,MAAM,aAAa,UAWzB,CAAC;AAEF,+CAA+C;AAC/C,eAAO,MAAM,YAAY,UAWxB,CAAC;AAMF,+CAA+C;AAC/C,eAAO,MAAM,iBAAiB,KAAK,CAAC;AAEpC,gCAAgC;AAChC,eAAO,MAAM,aAAa,MAAM,CAAC;AAEjC,uCAAuC;AACvC,eAAO,MAAM,oBAAoB,KAAK,CAAC;AAEvC,mCAAmC;AACnC,eAAO,MAAM,gBAAgB,MAAM,CAAC"}

package/dist/constants/universal.constants.js

@@ -111,22 +111,62 @@ export const COMPANY_FIELD_MAPPINGS = {
     employee_count: 'team_size',
     headcount: 'team_size',
     staff_count: 'team_size',
+    // LinkedIn aliases (common mistakes)
+    linkedin_url: 'linkedin',
+    linkedin_link: 'linkedin',
+    linkedinUrl: 'linkedin',
+    linkedIn: 'linkedin',
+    // Twitter aliases (common mistakes)
+    twitter_url: 'twitter',
+    twitter_handle: 'twitter',
+    twitter_link: 'twitter',
+    twitterHandle: 'twitter',
+    twitterUrl: 'twitter',
+    // Facebook aliases
+    facebook_url: 'facebook',
+    facebook_link: 'facebook',
+    facebookUrl: 'facebook',
 };
 export const COMPANY_VALID_FIELDS = [
+    // Core fields
     'name',
     'domains',
     'description',
+    'categories',
     'industry',
+    'type',
+    'typpe', // Valid Attio field (not a typo)
+    // Size and financials
     'team_size',
+    'employee_count',
+    'estimated_arr',
+    'revenue',
+    'founded',
     'founded_at',
+    // Location fields
+    'location',
+    'locations',
+    'primary_location',
     'headquarters',
+    // Social media - canonical names
+    'linkedin',
+    'twitter',
+    'facebook',
+    'instagram',
+    'angellist',
+    'crunchbase',
+    // Social media - alias forms (for validation acceptance)
     'linkedin_url',
+    'twitter_url',
     'twitter_handle',
     'facebook_url',
-    'crunchbase_url',
-    'annual_revenue',
-    'categories',
-    'locations',
+    // Relationships
+    'team', // Associated people
+    'associated_deals',
+    'associated_workspaces',
+    // Other standard fields
+    'notes',
+    'primary_domain',
 ];
 export const COMPANY_COMMON_MISTAKES = {
     website: 'Use "domains" for company websites (as an array of strings)',
@@ -168,19 +208,51 @@ export const PEOPLE_FIELD_MAPPINGS = {
     job_role: 'title',
     occupation: 'title',
     designation: 'title',
+    // LinkedIn aliases (common mistakes)
+    linkedin_url: 'linkedin',
+    linkedin_link: 'linkedin',
+    linkedinUrl: 'linkedin',
+    linkedIn: 'linkedin',
+    // Twitter aliases (common mistakes)
+    twitter_url: 'twitter',
+    twitter_handle: 'twitter',
+    twitter_link: 'twitter',
+    twitterHandle: 'twitter',
+    twitterUrl: 'twitter',
+    // Facebook aliases
+    facebook_url: 'facebook',
+    facebook_link: 'facebook',
+    facebookUrl: 'facebook',
 };
 export const PEOPLE_VALID_FIELDS = [
+    // Core fields
     'name',
+    'first_name',
+    'last_name',
     'email_addresses',
     'phone_numbers',
     'title',
-    'linkedin_url',
-    'twitter_handle',
-    'location',
-    'avatar_url',
-    'timezone',
+    'description',
+    // Primary contact fields
     'primary_email_address',
     'primary_phone_number',
+    // Profile fields
+    'avatar_url',
+    'timezone',
+    'location',
+    // Social media - canonical names
+    'linkedin',
+    'twitter',
+    'facebook',
+    'instagram',
+    // Social media - alias forms (for validation acceptance)
+    'linkedin_url',
+    'twitter_url',
+    'twitter_handle',
+    'facebook_url',
+    // Relationships
+    'company',
+    'associated_deals',
 ];
 export const PEOPLE_COMMON_MISTAKES = {
     email: 'Use "email_addresses" as an array of email strings',