@iflow-mcp/attio-mcp 1.3.6

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

@@ -0,0 +1,261 @@
+/**
+ * Universal Constants for Attio MCP Server
+ *
+ * Centralized location for all magic numbers, field mappings, and configuration
+ * constants used throughout the universal handlers and services.
+ *
+ * Addresses PR feedback: Extract constants to improve maintainability and
+ * reduce magic numbers scattered throughout the codebase.
+ */
+import { UniversalResourceType } from '../handlers/tool-configs/universal/types.js';
+/** Default TTL for tasks cache in milliseconds (30 seconds) */
+export declare const DEFAULT_TASKS_CACHE_TTL = 30000;
+/** Default TTL for 404 response cache in milliseconds (60 seconds) */
+export declare const DEFAULT_404_CACHE_TTL = 60000;
+/** Default TTL for attribute discovery cache in milliseconds (5 minutes) */
+export declare const DEFAULT_ATTRIBUTES_CACHE_TTL = 300000;
+/** Maximum number of cache entries before cleanup */
+export declare const MAX_CACHE_ENTRIES = 1000;
+/** Maximum number of suggestions to show in validation errors */
+export declare const MAX_VALIDATION_SUGGESTIONS = 5;
+/** Maximum length for truncated suggestion text */
+export declare const MAX_SUGGESTION_TEXT_LENGTH = 100;
+/** Default request timeout in milliseconds */
+export declare const DEFAULT_REQUEST_TIMEOUT = 30000;
+/** Maximum number of retry attempts for API calls */
+export declare const MAX_RETRY_ATTEMPTS = 3;
+/** Base delay between retries in milliseconds */
+export declare const RETRY_BASE_DELAY = 1000;
+/**
+ * Maps various resource type strings to canonical UniversalResourceType values
+ * Handles common typos and plural/singular variations
+ */
+export declare const RESOURCE_TYPE_MAPPINGS: Record<string, UniversalResourceType>;
+/**
+ * Maps resource types to their Attio API object slugs
+ * Used for schema discovery and API routing
+ */
+export declare const OBJECT_SLUG_MAP: Record<string, string>;
+export declare const COMPANY_FIELD_MAPPINGS: {
+    website: string;
+    url: string;
+    company_name: string;
+    company_domain: string;
+    domain: string;
+    website_url: string;
+    company_url: string;
+    site: string;
+    homepage: string;
+    web: string;
+    industry_type: string;
+    business_type: string;
+    sector: string;
+    category: string;
+    about: string;
+    summary: string;
+    overview: string;
+    info: string;
+    details: string;
+    size: string;
+    employees: string;
+    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: {
+    website: string;
+    url: string;
+    company_name: string;
+    about: string;
+    size: string;
+};
+export declare const PEOPLE_FIELD_MAPPINGS: {
+    full_name: string;
+    fullname: string;
+    person_name: string;
+    contact_name: string;
+    individual_name: string;
+    email: string;
+    emails: string;
+    email_address: string;
+    contact_email: string;
+    work_email: string;
+    business_email: string;
+    phone: string;
+    phones: string;
+    phone_number: string;
+    contact_phone: string;
+    mobile: string;
+    cell: string;
+    telephone: string;
+    job_title: string;
+    position: string;
+    role: string;
+    job_position: string;
+    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: {
+    email: string;
+    phone: string;
+    job_title: string;
+    full_name: string;
+};
+export declare const TASK_FIELD_MAPPINGS: {
+    task: string;
+    description: string;
+    title: string;
+    name: string;
+    task_name: string;
+    task_title: string;
+    task_description: string;
+    todo: string;
+    item: string;
+    status: string;
+    completed: string;
+    done: string;
+    finished: string;
+    complete: string;
+    is_done: string;
+    is_finished: string;
+    deadline: string;
+    due_date: string;
+    due: string;
+    expires_at: string;
+    completion_date: string;
+    target_date: string;
+    assignee: string;
+    assigned_to: string;
+    owner: string;
+    responsible: string;
+    assigned_user: string;
+    task_owner: string;
+    linked_record: string;
+    related_records: string;
+    connected_records: string;
+    associated_records: string;
+};
+export declare const TASK_VALID_FIELDS: string[];
+export declare const TASK_COMMON_MISTAKES: {
+    task: string;
+    title: string;
+    status: string;
+    deadline: string;
+    assignee: string;
+};
+export declare const DEAL_FIELD_MAPPINGS: {
+    deal_name: string;
+    opportunity_name: string;
+    title: string;
+    deal_title: string;
+    amount: string;
+    deal_value: string;
+    opportunity_value: string;
+    deal_amount: string;
+    revenue: string;
+    deal_stage: string;
+    opportunity_stage: string;
+    sales_stage: string;
+    pipeline_stage: string;
+    close_date: string;
+    expected_close: string;
+    target_close: string;
+    projected_close: string;
+};
+export declare const DEAL_VALID_FIELDS: string[];
+export declare const DEAL_COMMON_MISTAKES: {
+    amount: string;
+    deal_name: string;
+    deal_stage: string;
+    close_date: string;
+};
+export declare const RECORD_FIELD_MAPPINGS: {
+    title: string;
+    record_name: string;
+};
+export declare const RECORD_VALID_FIELDS: string[];
+export declare const RECORD_COMMON_MISTAKES: {
+    title: string;
+};
+export declare const NOTE_FIELD_MAPPINGS: {
+    note: string;
+    text: string;
+    body: string;
+    message: string;
+    description: string;
+    comment: string;
+    note_title: string;
+    subject: string;
+    heading: string;
+    parent: string;
+    record_id: string;
+    attached_to: string;
+    linked_to: string;
+    object_type: string;
+    parent_type: string;
+    attached_to_type: string;
+};
+export declare const NOTE_VALID_FIELDS: string[];
+export declare const NOTE_COMMON_MISTAKES: {
+    note: string;
+    text: string;
+    parent: string;
+    object_type: string;
+};
+export declare const ERROR_MESSAGES: {
+    INVALID_RESOURCE_TYPE: (type: string) => string;
+    MISSING_REQUIRED_FIELD: (field: string) => string;
+    INVALID_FIELD_TYPE: (field: string, expected: string, received: string) => string;
+    FIELD_COLLISION: (fields: string[], target: string) => string;
+    ATTRIBUTE_DISCOVERY_FAILED: (resourceType: string) => string;
+    CACHE_CLEANUP_FAILED: string;
+    VALIDATION_FAILED: (resourceType: string) => string;
+};
+/** Regex pattern for valid email addresses (basic validation) */
+export declare const EMAIL_PATTERN: RegExp;
+/** Regex pattern for valid phone numbers (international format) */
+export declare const PHONE_PATTERN: RegExp;
+/** Regex pattern for valid URLs */
+export declare const URL_PATTERN: RegExp;
+/** Regex pattern for valid UUID format */
+export declare const UUID_PATTERN: RegExp;
+/** Values that should be converted to true */
+export declare const TRUTHY_VALUES: string[];
+/** Values that should be converted to false */
+export declare const FALSY_VALUES: string[];
+/** Default page size for paginated requests */
+export declare const DEFAULT_PAGE_SIZE = 25;
+/** Maximum page size allowed */
+export declare const MAX_PAGE_SIZE = 100;
+/** Default limit for search results */
+export declare const DEFAULT_SEARCH_LIMIT = 10;
+/** Maximum search results limit */
+export declare const MAX_SEARCH_LIMIT = 500;
+//# sourceMappingURL=universal.constants.d.ts.map

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

@@ -0,0 +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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;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"}