attio-mcp 0.1.2 → 1.1.0

package/dist/utils/AttioFieldMapper.js

@@ -0,0 +1,84 @@
+/**
+ * Attio Field Name Mapper
+ *
+ * Maps generic field names to Attio-specific field names
+ * Provides deprecation warnings for unsupported aliases
+ */
+import { createScopedLogger, OperationType } from './logger.js';
+const log = createScopedLogger('utils.AttioFieldMapper', undefined, OperationType.TRANSFORMATION);
+export const FIELD_MAPPINGS = {
+    timestamp: {
+        created: 'created_at',
+        modified: 'modified_at',
+        updated: 'modified_at', // Alias - Attio uses modified_at
+        interacted: 'interacted_at',
+    },
+    system: {
+        id: 'record_id',
+        workspace: 'workspace_id',
+        object: 'object_id',
+    },
+};
+/**
+ * Deprecated field mappings that should show warnings
+ */
+const DEPRECATED_FIELDS = {
+    updated_at: 'modified_at',
+    update_date: 'modified_at',
+    last_updated: 'modified_at',
+};
+/**
+ * Map generic field name to Attio-specific field name
+ * Logs deprecation warnings for unsupported aliases
+ */
+export function mapFieldName(genericField) {
+    // Check for deprecated mappings
+    const deprecated = DEPRECATED_FIELDS[genericField];
+    if (deprecated) {
+        log.warn('Deprecated field alias used', {
+            field: genericField,
+            replacement: deprecated,
+        });
+        return deprecated;
+    }
+    // Search in timestamp mappings
+    for (const [key, value] of Object.entries(FIELD_MAPPINGS.timestamp)) {
+        if (key === genericField) {
+            return value;
+        }
+    }
+    // Search in system mappings
+    for (const [key, value] of Object.entries(FIELD_MAPPINGS.system)) {
+        if (key === genericField) {
+            return value;
+        }
+    }
+    // Return as-is if no mapping found (might be valid Attio field)
+    return genericField;
+}
+/**
+ * Get all valid timestamp field names for a given resource
+ * Different resources may support different timestamp fields
+ */
+export function getValidTimestampFields(resourceType) {
+    const baseFields = ['created_at', 'modified_at'];
+    switch (resourceType) {
+        case 'companies':
+        case 'people':
+            return [...baseFields, 'interacted_at'];
+        case 'tasks':
+            return [...baseFields, 'due_date', 'completed_at'];
+        case 'notes':
+            return baseFields; // Notes typically only have created_at/modified_at
+        default:
+            return baseFields;
+    }
+}
+/**
+ * Validate if a field name is supported for timeframe filtering
+ */
+export function isValidTimestampField(fieldName, resourceType) {
+    const validFields = getValidTimestampFields(resourceType);
+    return validFields.includes(fieldName);
+}
+//# sourceMappingURL=AttioFieldMapper.js.map

package/dist/utils/AttioFieldMapper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AttioFieldMapper.js","sourceRoot":"","sources":["../../src/utils/AttioFieldMapper.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEhE,MAAM,GAAG,GAAG,kBAAkB,CAC5B,wBAAwB,EACxB,SAAS,EACT,aAAa,CAAC,cAAc,CAC7B,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,SAAS,EAAE;QACT,OAAO,EAAE,YAAY;QACrB,QAAQ,EAAE,aAAa;QACvB,OAAO,EAAE,aAAa,EAAE,iCAAiC;QACzD,UAAU,EAAE,eAAe;KAC5B;IACD,MAAM,EAAE;QACN,EAAE,EAAE,WAAW;QACf,SAAS,EAAE,cAAc;QACzB,MAAM,EAAE,WAAW;KACpB;CACO,CAAC;AAEX;;GAEG;AACH,MAAM,iBAAiB,GAA2B;IAChD,UAAU,EAAE,aAAa;IACzB,WAAW,EAAE,aAAa;IAC1B,YAAY,EAAE,aAAa;CAC5B,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,YAAoB;IAC/C,gCAAgC;IAChC,MAAM,UAAU,GAAG,iBAAiB,CAAC,YAAY,CAAC,CAAC;IACnD,IAAI,UAAU,EAAE,CAAC;QACf,GAAG,CAAC,IAAI,CAAC,6BAA6B,EAAE;YACtC,KAAK,EAAE,YAAY;YACnB,WAAW,EAAE,UAAU;SACxB,CAAC,CAAC;QACH,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,+BAA+B;IAC/B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,SAAS,CAAC,EAAE,CAAC;QACpE,IAAI,GAAG,KAAK,YAAY,EAAE,CAAC;YACzB,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,4BAA4B;IAC5B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,CAAC;QACjE,IAAI,GAAG,KAAK,YAAY,EAAE,CAAC;YACzB,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,gEAAgE;IAChE,OAAO,YAAY,CAAC;AACtB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAC,YAAoB;IAC1D,MAAM,UAAU,GAAG,CAAC,YAAY,EAAE,aAAa,CAAC,CAAC;IAEjD,QAAQ,YAAY,EAAE,CAAC;QACrB,KAAK,WAAW,CAAC;QACjB,KAAK,QAAQ;YACX,OAAO,CAAC,GAAG,UAAU,EAAE,eAAe,CAAC,CAAC;QAC1C,KAAK,OAAO;YACV,OAAO,CAAC,GAAG,UAAU,EAAE,UAAU,EAAE,cAAc,CAAC,CAAC;QACrD,KAAK,OAAO;YACV,OAAO,UAAU,CAAC,CAAC,mDAAmD;QACxE;YACE,OAAO,UAAU,CAAC;IACtB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CACnC,SAAiB,EACjB,YAAoB;IAEpB,MAAM,WAAW,GAAG,uBAAuB,CAAC,YAAY,CAAC,CAAC;IAC1D,OAAO,WAAW,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;AACzC,CAAC"}

package/dist/utils/AttioFilterOperators.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Attio API Filter Operators and Validation
+ *
+ * Based on official Attio API documentation (Context7 research)
+ * Provides operator normalization, validation, and 429 backoff handling
+ */
+export declare enum FilterOperator {
+    EQUALS = "$eq",
+    NOT_EMPTY = "$not_empty",
+    CONTAINS = "$contains",
+    STARTS_WITH = "$starts_with",
+    ENDS_WITH = "$ends_with",
+    GREATER_THAN = "$gt",
+    GREATER_THAN_OR_EQUAL = "$gte",
+    LESS_THAN = "$lt",
+    LESS_THAN_OR_EQUAL = "$lte",
+    IN = "$in",
+    AND = "$and",
+    OR = "$or",
+    NOT = "$not"
+}
+export declare function isValidOperator(op: string): boolean;
+/**
+ * Normalize legacy operators to proper $ prefixed format
+ * Logs deprecation warnings for legacy usage
+ */
+export declare function normalizeOperator(op: string): FilterOperator;
+/**
+ * Validate filter operator and value shape
+ */
+export declare function validateFilter(operator: string, value: unknown): {
+    valid: boolean;
+    error?: string;
+};
+/**
+ * Lightweight concurrency semaphore (no external deps)
+ * Includes 429-specific backoff with jitter
+ */
+export declare class AttioRateLimitSemaphore {
+    private maxConcurrent;
+    private running;
+    private queue;
+    constructor(maxConcurrent?: number);
+    acquire<T>(fn: () => Promise<T>): Promise<T>;
+    private withRetry;
+    private processQueue;
+}
+export declare const apiSemaphore: AttioRateLimitSemaphore;
+//# sourceMappingURL=AttioFilterOperators.d.ts.map

package/dist/utils/AttioFilterOperators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AttioFilterOperators.d.ts","sourceRoot":"","sources":["../../src/utils/AttioFilterOperators.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,oBAAY,cAAc;IAExB,MAAM,QAAQ;IACd,SAAS,eAAe;IAGxB,QAAQ,cAAc;IACtB,WAAW,iBAAiB;IAC5B,SAAS,eAAe;IAGxB,YAAY,QAAQ;IACpB,qBAAqB,SAAS;IAC9B,SAAS,QAAQ;IACjB,kBAAkB,SAAS;IAG3B,EAAE,QAAQ;IAGV,GAAG,SAAS;IACZ,EAAE,QAAQ;IACV,GAAG,SAAS;CACb;AAoBD,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,CAwB5D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,OAAO,GACb;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAyCpC;AAED;;;GAGG;AACH,qBAAa,uBAAuB;IAOhC,OAAO,CAAC,aAAa;IANvB,OAAO,CAAC,OAAO,CAAK;IACpB,OAAO,CAAC,KAAK,CAAyB;gBAK5B,aAAa,SAAI;IAGrB,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;YAwBpC,SAAS;IA8BvB,OAAO,CAAC,YAAY;CAMrB;AAGD,eAAO,MAAM,YAAY,yBAAiC,CAAC"}

package/dist/utils/AttioFilterOperators.js

@@ -0,0 +1,173 @@
+/**
+ * Attio API Filter Operators and Validation
+ *
+ * Based on official Attio API documentation (Context7 research)
+ * Provides operator normalization, validation, and 429 backoff handling
+ */
+import { warn, OperationType } from './logger.js';
+export var FilterOperator;
+(function (FilterOperator) {
+    // Equality and existence
+    FilterOperator["EQUALS"] = "$eq";
+    FilterOperator["NOT_EMPTY"] = "$not_empty";
+    // String operations
+    FilterOperator["CONTAINS"] = "$contains";
+    FilterOperator["STARTS_WITH"] = "$starts_with";
+    FilterOperator["ENDS_WITH"] = "$ends_with";
+    // Numeric/date comparisons
+    FilterOperator["GREATER_THAN"] = "$gt";
+    FilterOperator["GREATER_THAN_OR_EQUAL"] = "$gte";
+    FilterOperator["LESS_THAN"] = "$lt";
+    FilterOperator["LESS_THAN_OR_EQUAL"] = "$lte";
+    // Array operations (resource-specific)
+    FilterOperator["IN"] = "$in";
+    // Logical combinators (filter-expression level)
+    FilterOperator["AND"] = "$and";
+    FilterOperator["OR"] = "$or";
+    FilterOperator["NOT"] = "$not";
+})(FilterOperator || (FilterOperator = {}));
+/**
+ * Legacy operator mappings for backward compatibility
+ * Logs deprecation warnings when used
+ */
+const LEGACY_OPERATOR_MAP = {
+    gte: FilterOperator.GREATER_THAN_OR_EQUAL,
+    lte: FilterOperator.LESS_THAN_OR_EQUAL,
+    gt: FilterOperator.GREATER_THAN,
+    lt: FilterOperator.LESS_THAN,
+    eq: FilterOperator.EQUALS,
+    not_empty: FilterOperator.NOT_EMPTY,
+    is_not_empty: FilterOperator.NOT_EMPTY, // Common mistake
+    contains: FilterOperator.CONTAINS,
+    starts_with: FilterOperator.STARTS_WITH,
+    ends_with: FilterOperator.ENDS_WITH,
+    in: FilterOperator.IN,
+};
+export function isValidOperator(op) {
+    return Object.values(FilterOperator).includes(op);
+}
+/**
+ * Normalize legacy operators to proper $ prefixed format
+ * Logs deprecation warnings for legacy usage
+ */
+export function normalizeOperator(op) {
+    // Already normalized
+    if (isValidOperator(op)) {
+        return op;
+    }
+    // Legacy mapping with warning
+    const normalized = LEGACY_OPERATOR_MAP[op];
+    if (normalized) {
+        warn('utils/AttioFilterOperators', `Deprecated operator '${op}' used. Use '${normalized}' instead.`, { deprecatedOperator: op, suggestedOperator: normalized }, 'normalizeFilterOperator', OperationType.VALIDATION);
+        return normalized;
+    }
+    throw new Error(`Invalid filter operator: '${op}'. Supported: ${Object.values(FilterOperator).join(', ')}`);
+}
+/**
+ * Validate filter operator and value shape
+ */
+export function validateFilter(operator, value) {
+    const normalizedOp = normalizeOperator(operator);
+    switch (normalizedOp) {
+        case FilterOperator.NOT_EMPTY:
+            if (typeof value !== 'boolean') {
+                return {
+                    valid: false,
+                    error: '$not_empty requires boolean value (true)',
+                };
+            }
+            break;
+        case FilterOperator.IN:
+            if (!Array.isArray(value)) {
+                return { valid: false, error: '$in requires array value' };
+            }
+            break;
+        case FilterOperator.GREATER_THAN:
+        case FilterOperator.GREATER_THAN_OR_EQUAL:
+        case FilterOperator.LESS_THAN:
+        case FilterOperator.LESS_THAN_OR_EQUAL:
+            if (typeof value !== 'string' && typeof value !== 'number') {
+                return {
+                    valid: false,
+                    error: `${normalizedOp} requires string or number value`,
+                };
+            }
+            break;
+        case FilterOperator.CONTAINS:
+        case FilterOperator.STARTS_WITH:
+        case FilterOperator.ENDS_WITH:
+            if (typeof value !== 'string') {
+                return { valid: false, error: `${normalizedOp} requires string value` };
+            }
+            break;
+    }
+    return { valid: true };
+}
+/**
+ * Lightweight concurrency semaphore (no external deps)
+ * Includes 429-specific backoff with jitter
+ */
+export class AttioRateLimitSemaphore {
+    maxConcurrent;
+    running = 0;
+    queue = [];
+    constructor(
+    // Conservative limit to avoid rate limiting (429) errors
+    // Attio API typically allows ~10 req/sec, we use 4 concurrent for safety margin
+    maxConcurrent = 4) {
+        this.maxConcurrent = maxConcurrent;
+    }
+    async acquire(fn) {
+        return new Promise((resolve, reject) => {
+            const execute = async () => {
+                this.running++;
+                try {
+                    const result = await this.withRetry(fn);
+                    resolve(result);
+                }
+                catch (error) {
+                    reject(error);
+                }
+                finally {
+                    this.running--;
+                    this.processQueue();
+                }
+            };
+            if (this.running < this.maxConcurrent) {
+                execute();
+            }
+            else {
+                this.queue.push(execute);
+            }
+        });
+    }
+    async withRetry(fn, attempt = 1) {
+        try {
+            return await fn();
+        }
+        catch (error) {
+            // 429 backoff with jitter
+            const maxRetries = 4;
+            if (error?.status === 429 &&
+                attempt <= maxRetries) {
+                const baseDelay = Math.pow(2, attempt - 1) * 250; // 250ms, 500ms, 1s, 2s
+                const jitter = Math.random() * 100; // 0-100ms jitter
+                const delay = baseDelay + jitter;
+                warn('utils/AttioFilterOperators', `Rate limit hit, retrying in ${Math.round(delay)}ms (attempt ${attempt})`, { delayMs: Math.round(delay), attempt, maxRetries }, 'AttioRateLimitSemaphore', OperationType.API_CALL);
+                await new Promise((resolve) => setTimeout(resolve, delay));
+                return this.withRetry(fn, attempt + 1);
+            }
+            throw error;
+        }
+    }
+    processQueue() {
+        if (this.queue.length > 0 && this.running < this.maxConcurrent) {
+            const next = this.queue.shift();
+            if (next)
+                next();
+        }
+    }
+}
+// Global semaphore instance
+export const apiSemaphore = new AttioRateLimitSemaphore(4);
+//# sourceMappingURL=AttioFilterOperators.js.map

package/dist/utils/AttioFilterOperators.js.map

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

package/dist/utils/attio-response.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Utilities for handling Attio API responses
+ *
+ * Handles both Axios (res.data) and fetch/mock response formats
+ */
+/**
+ * Interface for raw note data from API
+ */
+interface RawNoteData {
+    id?: {
+        note_id?: string;
+        record_id?: string;
+        workspace_id?: string;
+        id?: string;
+    } | string;
+    note_id?: string;
+    record_id?: string;
+    workspace_id?: string;
+    parent_object?: string;
+    parent_record_id?: string;
+    title?: string;
+    content_markdown?: string;
+    content_plaintext?: string;
+    created_at?: string;
+    updated_at?: string;
+    tags?: unknown[];
+    meeting_id?: string;
+    format?: string;
+}
+/**
+ * Interface for normalized note structure
+ */
+export interface NormalizedNote extends Record<string, unknown> {
+    id: {
+        note_id: string | null;
+        workspace_id: string | null;
+        record_id: string | null;
+    };
+    parent_object: string | null;
+    parent_record_id: string | null;
+    title: string | null;
+    content_markdown: string | null;
+    content_plaintext: string | null;
+    content: string;
+    created_at: string | null;
+    updated_at: string | null;
+    tags: unknown[];
+    meeting_id: string | null;
+    format: string;
+}
+/**
+ * Safely unwrap Attio API response envelope
+ * Handles both Axios responses and direct API responses
+ */
+export declare function unwrapAttio<T>(res: unknown): T;
+/**
+ * Normalize Attio note to consistent structure
+ * Provides compatibility with record-style tests via record_id alias
+ */
+export declare function normalizeNote(note: RawNoteData): NormalizedNote;
+/**
+ * Normalize array of notes
+ */
+export declare function normalizeNotes(notes: RawNoteData[]): NormalizedNote[];
+/**
+ * Coerce format to Attio-accepted values and preserve content
+ */
+export declare function coerceNoteFormat(format?: string, content?: string): {
+    format: 'markdown' | 'plaintext';
+    content: string;
+};
+export {};
+//# sourceMappingURL=attio-response.d.ts.map

package/dist/utils/attio-response.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attio-response.d.ts","sourceRoot":"","sources":["../../src/utils/attio-response.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAUH;;GAEG;AACH,UAAU,WAAW;IACnB,EAAE,CAAC,EACC;QACE,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,EAAE,CAAC,EAAE,MAAM,CAAC;KACb,GACD,MAAM,CAAC;IACX,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,cAAe,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC7D,EAAE,EAAE;QACF,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;QACvB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;QAC5B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;KAC1B,CAAC;IACF,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,IAAI,EAAE,OAAO,EAAE,CAAC;IAChB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,GAAG,CAAC,CAO9C;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,WAAW,GAAG,cAAc,CAuC/D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,cAAc,EAAE,CAGrE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,CAAC,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,GACf;IAAE,MAAM,EAAE,UAAU,GAAG,WAAW,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAYvD"}

package/dist/utils/attio-response.js

@@ -0,0 +1,79 @@
+/**
+ * Utilities for handling Attio API responses
+ *
+ * Handles both Axios (res.data) and fetch/mock response formats
+ */
+/**
+ * Safely unwrap Attio API response envelope
+ * Handles both Axios responses and direct API responses
+ */
+export function unwrapAttio(res) {
+    const responseEnvelope = res;
+    const envelope = responseEnvelope?.data ?? res;
+    const envelopeObj = envelope;
+    // If the envelope clearly looks like an error, just return it as-is and let the caller detect it
+    if (envelopeObj?.error && !envelopeObj?.data)
+        return envelope;
+    return (envelopeObj?.data ?? envelope);
+}
+/**
+ * Normalize Attio note to consistent structure
+ * Provides compatibility with record-style tests via record_id alias
+ */
+export function normalizeNote(note) {
+    // Ensure we always have a base object to work with
+    const source = note || {};
+    const idObj = source.id || {};
+    // Simplify ID extraction
+    const rawId = source.note_id ||
+        source.record_id ||
+        (typeof idObj === 'object' && idObj !== null ? idObj.note_id : null) ||
+        (typeof idObj === 'object' && idObj !== null ? idObj.record_id : null) ||
+        (typeof idObj === 'object' && idObj !== null ? idObj.id : null) ||
+        (typeof source.id === 'string' ? source.id : null);
+    const normalized = {
+        id: {
+            note_id: rawId,
+            workspace_id: source.workspace_id ||
+                (typeof idObj === 'object' && idObj !== null
+                    ? idObj.workspace_id
+                    : null) ||
+                null,
+            record_id: rawId, // alias for tests
+        },
+        parent_object: source.parent_object || null,
+        parent_record_id: source.parent_record_id || null,
+        title: source.title || null,
+        content_markdown: source.content_markdown || null,
+        content_plaintext: source.content_plaintext || null,
+        content: source.content_markdown || source.content_plaintext || '',
+        created_at: source.created_at || null,
+        updated_at: source.updated_at || null,
+        tags: Array.isArray(source.tags) ? source.tags : [],
+        meeting_id: source.meeting_id || null,
+        format: source.format || 'markdown',
+    };
+    return normalized;
+}
+/**
+ * Normalize array of notes
+ */
+export function normalizeNotes(notes) {
+    if (!Array.isArray(notes))
+        return [];
+    return notes.map(normalizeNote).filter(Boolean);
+}
+/**
+ * Coerce format to Attio-accepted values and preserve content
+ */
+export function coerceNoteFormat(format, content) {
+    // Convert html to markdown to preserve HTML tags, otherwise default to markdown or plaintext
+    const attioFormat = format === 'html' || format === 'markdown' ? 'markdown' : 'plaintext';
+    // Preserve content as-is - tests expect HTML content to be unchanged
+    const processedContent = content || '';
+    return {
+        format: attioFormat,
+        content: processedContent,
+    };
+}
+//# sourceMappingURL=attio-response.js.map

package/dist/utils/attio-response.js.map

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

package/dist/utils/attribute-format-helpers.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Attribute format helpers to convert common user mistakes to correct API formats
+ *
+ * This module provides automatic format conversion for common attribute mistakes
+ * to improve user experience and reduce errors.
+ */
+/**
+ * Converts common attribute format mistakes to correct API format
+ *
+ * @param resourceType - The type of resource (companies, people, etc.)
+ * @param attributes - The attributes object with potential format issues
+ * @returns Corrected attributes object
+ */
+export declare function convertAttributeFormats(resourceType: string, attributes: Record<string, unknown>): Record<string, unknown>;
+/**
+ * Validates people attributes before POST to ensure correct Attio format
+ * Throws validation errors if required formats are not met
+ */
+export declare function validatePeopleAttributesPrePost(attributes: Record<string, unknown>): void;
+/**
+ * Generates helpful error message with correct format examples
+ */
+export declare function getFormatErrorHelp(resourceType: string, attributeName: string, error: string): string;
+//# sourceMappingURL=attribute-format-helpers.d.ts.map

package/dist/utils/attribute-format-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attribute-format-helpers.d.ts","sourceRoot":"","sources":["../../src/utils/attribute-format-helpers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAiCH;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAClC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAgBzB;AA8RD;;;GAGG;AACH,wBAAgB,+BAA+B,CAC7C,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAClC,IAAI,CAiCN;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,MAAM,GACZ,MAAM,CA+CR"}