attio-mcp 0.1.2 → 1.1.0

package/dist/objects/deals/attributes.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Deals attributes and related operations
+ * Contains functions for getting deal information with different levels of detail
+ */
+import { AttioRecord } from '../../types/attio.js';
+/**
+ * Determines if a field is a standard Attio deal field or a custom field
+ *
+ * @param fieldName - The field name to check
+ * @returns True if it's a standard field, false if custom
+ */
+export declare function isStandardDealField(fieldName: string): boolean;
+/**
+ * Gets a list of all standard deal field names
+ *
+ * @returns Array of standard field names
+ */
+export declare function getStandardDealFields(): string[];
+/**
+ * Checks if a field is custom (not in the standard Attio deal schema)
+ *
+ * @param fieldName - The name of the field to check
+ * @returns True if the field is custom, false if it's a standard field
+ */
+export declare function isCustomDealField(fieldName: string): boolean;
+/**
+ * Gets deal fields with error handling and validation
+ *
+ * @param dealIdOrUri - The ID of the deal or its URI
+ * @param fields - Array of field names to retrieve
+ * @returns Deal data with specified fields
+ */
+export declare function getDealFields(dealIdOrUri: string, fields: string[]): Promise<Partial<AttioRecord>>;
+/**
+ * Gets basic deal information
+ *
+ * @param dealIdOrUri - The ID of the deal or its URI
+ * @returns Basic deal information
+ */
+export declare function getDealBasicInfo(dealIdOrUri: string): Promise<Partial<AttioRecord>>;
+/**
+ * Gets deal sales information
+ *
+ * @param dealIdOrUri - The ID of the deal or its URI
+ * @returns Deal sales pipeline information
+ */
+export declare function getDealSalesInfo(dealIdOrUri: string): Promise<Partial<AttioRecord>>;
+/**
+ * Gets deal relationship information
+ *
+ * @param dealIdOrUri - The ID of the deal or its URI
+ * @returns Deal relationship information
+ */
+export declare function getDealRelationshipInfo(dealIdOrUri: string): Promise<Partial<AttioRecord>>;
+/**
+ * Gets deal metadata information
+ *
+ * @param dealIdOrUri - The ID of the deal or its URI
+ * @returns Deal metadata information
+ */
+export declare function getDealMetadataInfo(dealIdOrUri: string): Promise<Partial<AttioRecord>>;
+/**
+ * Validate and categorize deal fields
+ *
+ * @param fields - Array of field names to validate
+ * @returns Object with categorized fields
+ */
+export declare function validateAndCategorizeDealFields(fields: string[]): {
+    standardFields: string[];
+    customFields: string[];
+    warnings: string[];
+};
+/**
+ * Get comprehensive deal attribute information with custom field detection
+ *
+ * @param dealIdOrUri - The ID of the deal or its URI
+ * @param requestedFields - Optional array of specific fields to retrieve
+ * @returns Deal with field categorization info
+ */
+export declare function getDealWithFieldAnalysis(dealIdOrUri: string, requestedFields?: string[]): Promise<{
+    deal: Partial<AttioRecord>;
+    fieldAnalysis: {
+        standardFields: string[];
+        customFields: string[];
+        warnings: string[];
+    };
+}>;
+//# sourceMappingURL=attributes.d.ts.map

package/dist/objects/deals/attributes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attributes.d.ts","sourceRoot":"","sources":["../../../src/objects/deals/attributes.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAgBnD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAE9D;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,EAAE,CAEhD;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAE5D;AAED;;;;;;GAMG;AACH,wBAAsB,aAAa,CACjC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EAAE,GACf,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAW/B;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAI/B;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAW/B;AAED;;;;;GAKG;AACH,wBAAsB,uBAAuB,CAC3C,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAS/B;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CACvC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAI/B;AAED;;;;;GAKG;AACH,wBAAgB,+BAA+B,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG;IACjE,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,CA4BA;AAED;;;;;;GAMG;AACH,wBAAsB,wBAAwB,CAC5C,WAAW,EAAE,MAAM,EACnB,eAAe,CAAC,EAAE,MAAM,EAAE,GACzB,OAAO,CAAC;IACT,IAAI,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IAC3B,aAAa,EAAE;QACb,cAAc,EAAE,MAAM,EAAE,CAAC;QACzB,YAAY,EAAE,MAAM,EAAE,CAAC;QACvB,QAAQ,EAAE,MAAM,EAAE,CAAC;KACpB,CAAC;CACH,CAAC,CAWD"}

package/dist/objects/deals/attributes.js

@@ -0,0 +1,155 @@
+import { createScopedLogger } from '../../utils/logger.js';
+import { getRecord } from '../../api/operations/crud.js';
+// Standard fields that are NOT custom (based on actual Attio API)
+const standardFields = new Set([
+    'name',
+    'stage',
+    'owner',
+    'value',
+    'associated_people',
+    'associated_company',
+    'created_at',
+    'created_by',
+]);
+/**
+ * Determines if a field is a standard Attio deal field or a custom field
+ *
+ * @param fieldName - The field name to check
+ * @returns True if it's a standard field, false if custom
+ */
+export function isStandardDealField(fieldName) {
+    return standardFields.has(fieldName);
+}
+/**
+ * Gets a list of all standard deal field names
+ *
+ * @returns Array of standard field names
+ */
+export function getStandardDealFields() {
+    return Array.from(standardFields).sort();
+}
+/**
+ * Checks if a field is custom (not in the standard Attio deal schema)
+ *
+ * @param fieldName - The name of the field to check
+ * @returns True if the field is custom, false if it's a standard field
+ */
+export function isCustomDealField(fieldName) {
+    return !standardFields.has(fieldName);
+}
+/**
+ * Gets deal fields with error handling and validation
+ *
+ * @param dealIdOrUri - The ID of the deal or its URI
+ * @param fields - Array of field names to retrieve
+ * @returns Deal data with specified fields
+ */
+export async function getDealFields(dealIdOrUri, fields) {
+    try {
+        const deal = await getRecord('deals', dealIdOrUri, fields);
+        return deal;
+    }
+    catch (error) {
+        createScopedLogger('deals.attributes', 'getDealFields').error('Error fetching deal fields', error);
+        throw error;
+    }
+}
+/**
+ * Gets basic deal information
+ *
+ * @param dealIdOrUri - The ID of the deal or its URI
+ * @returns Basic deal information
+ */
+export async function getDealBasicInfo(dealIdOrUri) {
+    const basicFields = ['name', 'stage', 'owner', 'value'];
+    return getDealFields(dealIdOrUri, basicFields);
+}
+/**
+ * Gets deal sales information
+ *
+ * @param dealIdOrUri - The ID of the deal or its URI
+ * @returns Deal sales pipeline information
+ */
+export async function getDealSalesInfo(dealIdOrUri) {
+    const salesFields = [
+        'name',
+        'stage',
+        'value',
+        'owner',
+        'associated_company',
+        'associated_people',
+    ];
+    return getDealFields(dealIdOrUri, salesFields);
+}
+/**
+ * Gets deal relationship information
+ *
+ * @param dealIdOrUri - The ID of the deal or its URI
+ * @returns Deal relationship information
+ */
+export async function getDealRelationshipInfo(dealIdOrUri) {
+    const relationshipFields = [
+        'name',
+        'associated_company',
+        'associated_people',
+        'owner',
+    ];
+    return getDealFields(dealIdOrUri, relationshipFields);
+}
+/**
+ * Gets deal metadata information
+ *
+ * @param dealIdOrUri - The ID of the deal or its URI
+ * @returns Deal metadata information
+ */
+export async function getDealMetadataInfo(dealIdOrUri) {
+    const metadataFields = ['name', 'created_at', 'created_by', 'owner'];
+    return getDealFields(dealIdOrUri, metadataFields);
+}
+/**
+ * Validate and categorize deal fields
+ *
+ * @param fields - Array of field names to validate
+ * @returns Object with categorized fields
+ */
+export function validateAndCategorizeDealFields(fields) {
+    const result = {
+        standardFields: [],
+        customFields: [],
+        warnings: [],
+    };
+    for (const fieldName of fields) {
+        if (isStandardDealField(fieldName)) {
+            result.standardFields.push(fieldName);
+        }
+        else {
+            result.customFields.push(fieldName);
+            // Generate warnings for fields that look like they might be standard but aren't
+            if (fieldName.includes('stage') && fieldName !== 'stage') {
+                result.warnings.push(`Field '${fieldName}' appears to be stage-related. The standard field is 'stage'.`);
+            }
+            if (fieldName.includes('value') && fieldName !== 'value') {
+                result.warnings.push(`Field '${fieldName}' appears to be value-related. The standard field is 'value'.`);
+            }
+        }
+    }
+    return result;
+}
+/**
+ * Get comprehensive deal attribute information with custom field detection
+ *
+ * @param dealIdOrUri - The ID of the deal or its URI
+ * @param requestedFields - Optional array of specific fields to retrieve
+ * @returns Deal with field categorization info
+ */
+export async function getDealWithFieldAnalysis(dealIdOrUri, requestedFields) {
+    // If no specific fields requested, get all basic fields
+    const fieldsToFetch = requestedFields || getStandardDealFields();
+    const deal = await getDealFields(dealIdOrUri, fieldsToFetch);
+    const fieldAnalysis = validateAndCategorizeDealFields(fieldsToFetch);
+    return {
+        deal,
+        fieldAnalysis,
+    };
+}
+//# sourceMappingURL=attributes.js.map

package/dist/objects/deals/attributes.js.map

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

package/dist/objects/deals/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Deal module - Central export point
+ * Re-exports all deal-related functionality from modular files
+ */
+export { getDealNotes, createDealNote } from './notes.js';
+export { searchDealsByCompany, searchDealsByPerson } from './relationships.js';
+export { isStandardDealField, getStandardDealFields, isCustomDealField, getDealFields, getDealBasicInfo, getDealSalesInfo, getDealRelationshipInfo, getDealMetadataInfo, validateAndCategorizeDealFields, getDealWithFieldAnalysis, } from './attributes.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/objects/deals/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/objects/deals/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAG1D,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAG/E,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,iBAAiB,EACjB,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,uBAAuB,EACvB,mBAAmB,EACnB,+BAA+B,EAC/B,wBAAwB,GACzB,MAAM,iBAAiB,CAAC"}

package/dist/objects/deals/index.js

@@ -0,0 +1,11 @@
+/**
+ * Deal module - Central export point
+ * Re-exports all deal-related functionality from modular files
+ */
+// Note operations
+export { getDealNotes, createDealNote } from './notes.js';
+// Relationship-based queries
+export { searchDealsByCompany, searchDealsByPerson } from './relationships.js';
+// Export attribute operations and field validation
+export { isStandardDealField, getStandardDealFields, isCustomDealField, getDealFields, getDealBasicInfo, getDealSalesInfo, getDealRelationshipInfo, getDealMetadataInfo, validateAndCategorizeDealFields, getDealWithFieldAnalysis, } from './attributes.js';
+//# sourceMappingURL=index.js.map

package/dist/objects/deals/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/objects/deals/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,kBAAkB;AAClB,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE1D,6BAA6B;AAC7B,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAE/E,mDAAmD;AACnD,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,iBAAiB,EACjB,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,uBAAuB,EACvB,mBAAmB,EACnB,+BAA+B,EAC/B,wBAAwB,GACzB,MAAM,iBAAiB,CAAC"}

package/dist/objects/deals/notes.d.ts

@@ -0,0 +1,20 @@
+import { AttioNote } from '../../types/attio.js';
+/**
+ * Gets notes for a specific deal
+ *
+ * @param dealId - ID of the deal
+ * @param limit - Maximum number of notes to return (default: 10)
+ * @param offset - Offset for pagination (default: 0)
+ * @returns Array of notes
+ */
+export declare function getDealNotes(dealId: string, limit?: number, offset?: number): Promise<AttioNote[]>;
+/**
+ * Creates a note for a deal
+ *
+ * @param dealId - ID of the deal
+ * @param title - Title of the note
+ * @param content - Content of the note
+ * @returns Created note
+ */
+export declare function createDealNote(dealId: string, title: string, content: string): Promise<AttioNote>;
+//# sourceMappingURL=notes.d.ts.map

package/dist/objects/deals/notes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notes.d.ts","sourceRoot":"","sources":["../../../src/objects/deals/notes.ts"],"names":[],"mappings":"AAOA,OAAO,EAAgB,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAI/D;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,MAAM,EACd,KAAK,GAAE,MAAW,EAClB,MAAM,GAAE,MAAU,GACjB,OAAO,CAAC,SAAS,EAAE,CAAC,CAgBtB;AAED;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,SAAS,CAAC,CAwBpB"}

package/dist/objects/deals/notes.js

@@ -0,0 +1,60 @@
+/**
+ * Note operations for Deals
+ */
+import { getObjectNotes, createObjectNote, } from '../../api/operations/index.js';
+import { ResourceType } from '../../types/attio.js';
+import { FilterValidationError } from '../../errors/api-errors.js';
+import { isValidId } from '../../utils/validation.js';
+/**
+ * Gets notes for a specific deal
+ *
+ * @param dealId - ID of the deal
+ * @param limit - Maximum number of notes to return (default: 10)
+ * @param offset - Offset for pagination (default: 0)
+ * @returns Array of notes
+ */
+export async function getDealNotes(dealId, limit = 10, offset = 0) {
+    try {
+        if (!isValidId(dealId)) {
+            throw new FilterValidationError(`Invalid deal ID: ${dealId}`);
+        }
+        return await getObjectNotes(ResourceType.DEALS, dealId, limit, offset);
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        if (errorMessage.includes('validation')) {
+            throw new FilterValidationError(`Note retrieval validation failed: ${errorMessage}`);
+        }
+        throw new Error(`Failed to get deal notes: ${errorMessage}`);
+    }
+}
+/**
+ * Creates a note for a deal
+ *
+ * @param dealId - ID of the deal
+ * @param title - Title of the note
+ * @param content - Content of the note
+ * @returns Created note
+ */
+export async function createDealNote(dealId, title, content) {
+    try {
+        if (!isValidId(dealId)) {
+            throw new FilterValidationError(`Invalid deal ID: ${dealId}`);
+        }
+        if (!title || title.trim().length === 0) {
+            throw new FilterValidationError('Note title cannot be empty');
+        }
+        if (!content || content.trim().length === 0) {
+            throw new FilterValidationError('Note content cannot be empty');
+        }
+        return await createObjectNote(ResourceType.DEALS, dealId, title, content);
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        if (errorMessage.includes('validation')) {
+            throw new FilterValidationError(`Note creation validation failed: ${errorMessage}`);
+        }
+        throw new Error(`Failed to create deal note: ${errorMessage}`);
+    }
+}
+//# sourceMappingURL=notes.js.map

package/dist/objects/deals/notes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notes.js","sourceRoot":"","sources":["../../../src/objects/deals/notes.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EACL,cAAc,EACd,gBAAgB,GACjB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,YAAY,EAAa,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAEtD;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,MAAc,EACd,QAAgB,EAAE,EAClB,SAAiB,CAAC;IAElB,IAAI,CAAC;QACH,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,qBAAqB,CAAC,oBAAoB,MAAM,EAAE,CAAC,CAAC;QAChE,CAAC;QAED,OAAO,MAAM,cAAc,CAAC,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;IACzE,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5E,IAAI,YAAY,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;YACxC,MAAM,IAAI,qBAAqB,CAC7B,qCAAqC,YAAY,EAAE,CACpD,CAAC;QACJ,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,6BAA6B,YAAY,EAAE,CAAC,CAAC;IAC/D,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,MAAc,EACd,KAAa,EACb,OAAe;IAEf,IAAI,CAAC;QACH,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,qBAAqB,CAAC,oBAAoB,MAAM,EAAE,CAAC,CAAC;QAChE,CAAC;QAED,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxC,MAAM,IAAI,qBAAqB,CAAC,4BAA4B,CAAC,CAAC;QAChE,CAAC;QAED,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC5C,MAAM,IAAI,qBAAqB,CAAC,8BAA8B,CAAC,CAAC;QAClE,CAAC;QAED,OAAO,MAAM,gBAAgB,CAAC,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IAC5E,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5E,IAAI,YAAY,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;YACxC,MAAM,IAAI,qBAAqB,CAC7B,oCAAoC,YAAY,EAAE,CACnD,CAAC;QACJ,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,+BAA+B,YAAY,EAAE,CAAC,CAAC;IACjE,CAAC;AACH,CAAC"}

package/dist/objects/deals/relationships.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Relationship-based queries for deals
+ */
+import { AttioRecord } from '../../types/attio.js';
+/**
+ * Search for deals associated with a specific company
+ *
+ * @param companyId - ID of the company to find deals for
+ * @param limit - Maximum number of results to return (default: 20)
+ * @param offset - Number of results to skip (default: 0)
+ * @returns Array of matching deal records
+ */
+export declare function searchDealsByCompany(companyId: string, limit?: number | string, offset?: number | string): Promise<AttioRecord[]>;
+/**
+ * Search for deals associated with a specific person
+ *
+ * @param personId - ID of the person to find deals for
+ * @param limit - Maximum number of results to return (default: 20)
+ * @param offset - Number of results to skip (default: 0)
+ * @returns Array of matching deal records
+ */
+export declare function searchDealsByPerson(personId: string, limit?: number | string, offset?: number | string): Promise<AttioRecord[]>;
+//# sourceMappingURL=relationships.d.ts.map

package/dist/objects/deals/relationships.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relationships.d.ts","sourceRoot":"","sources":["../../../src/objects/deals/relationships.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAKrD;;;;;;;GAOG;AACH,wBAAsB,oBAAoB,CACxC,SAAS,EAAE,MAAM,EACjB,KAAK,GAAE,MAAM,GAAG,MAAW,EAC3B,MAAM,GAAE,MAAM,GAAG,MAAU,GAC1B,OAAO,CAAC,WAAW,EAAE,CAAC,CA0CxB;AAED;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,MAAM,EAChB,KAAK,GAAE,MAAM,GAAG,MAAW,EAC3B,MAAM,GAAE,MAAM,GAAG,MAAU,GAC1B,OAAO,CAAC,WAAW,EAAE,CAAC,CAsCxB"}

package/dist/objects/deals/relationships.js

@@ -0,0 +1,86 @@
+import { FilterValidationError } from '../../errors/api-errors.js';
+import { validateNumericParam } from '../../utils/filters/index.js';
+import { getLazyAttioClient } from '../../api/lazy-client.js';
+/**
+ * Search for deals associated with a specific company
+ *
+ * @param companyId - ID of the company to find deals for
+ * @param limit - Maximum number of results to return (default: 20)
+ * @param offset - Number of results to skip (default: 0)
+ * @returns Array of matching deal records
+ */
+export async function searchDealsByCompany(companyId, limit = 20, offset = 0) {
+    try {
+        // Validate companyId
+        if (!companyId ||
+            typeof companyId !== 'string' ||
+            companyId.trim() === '') {
+            throw new FilterValidationError('Company ID must be a non-empty string');
+        }
+        // Validate and normalize limit and offset parameters
+        const validatedLimit = validateNumericParam(limit, 'limit', 20);
+        const validatedOffset = validateNumericParam(offset, 'offset', 0);
+        const client = getLazyAttioClient();
+        // Query deals filtered by associated_company
+        const response = await client.post('/objects/deals/records/query', {
+            filter: {
+                associated_company: {
+                    target_object: 'companies',
+                    target_record_id: companyId,
+                },
+            },
+            limit: validatedLimit,
+            offset: validatedOffset,
+        });
+        const deals = response?.data?.data || [];
+        return Array.isArray(deals) ? deals : [];
+    }
+    catch (error) {
+        // Convert all errors to FilterValidationErrors for consistent handling
+        if (error instanceof FilterValidationError) {
+            throw error;
+        }
+        throw new FilterValidationError(`Failed to search deals by company: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+/**
+ * Search for deals associated with a specific person
+ *
+ * @param personId - ID of the person to find deals for
+ * @param limit - Maximum number of results to return (default: 20)
+ * @param offset - Number of results to skip (default: 0)
+ * @returns Array of matching deal records
+ */
+export async function searchDealsByPerson(personId, limit = 20, offset = 0) {
+    try {
+        // Validate personId
+        if (!personId || typeof personId !== 'string' || personId.trim() === '') {
+            throw new FilterValidationError('Person ID must be a non-empty string');
+        }
+        // Validate and normalize limit and offset parameters
+        const validatedLimit = validateNumericParam(limit, 'limit', 20);
+        const validatedOffset = validateNumericParam(offset, 'offset', 0);
+        const client = getLazyAttioClient();
+        // Query deals filtered by associated_people
+        const response = await client.post('/objects/deals/records/query', {
+            filter: {
+                associated_people: {
+                    target_object: 'people',
+                    target_record_id: personId,
+                },
+            },
+            limit: validatedLimit,
+            offset: validatedOffset,
+        });
+        const deals = response?.data?.data || [];
+        return Array.isArray(deals) ? deals : [];
+    }
+    catch (error) {
+        // Convert all errors to FilterValidationErrors for consistent handling
+        if (error instanceof FilterValidationError) {
+            throw error;
+        }
+        throw new FilterValidationError(`Failed to search deals by person: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+//# sourceMappingURL=relationships.js.map

package/dist/objects/deals/relationships.js.map

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

package/dist/objects/lists/attributes.d.ts

@@ -0,0 +1,2 @@
+export declare function getListAttributes(): Promise<Record<string, unknown>>;
+//# sourceMappingURL=attributes.d.ts.map

package/dist/objects/lists/attributes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attributes.d.ts","sourceRoot":"","sources":["../../../src/objects/lists/attributes.ts"],"names":[],"mappings":"AAOA,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CA0B1E"}

package/dist/objects/lists/attributes.js

@@ -0,0 +1,26 @@
+/**
+ * List attribute utilities.
+ */
+import { getLazyAttioClient } from '../../api/lazy-client.js';
+import { createScopedLogger, OperationType } from '../../utils/logger.js';
+import { extract } from './shared.js';
+export async function getListAttributes() {
+    const log = createScopedLogger('objects.lists', 'getListAttributes', OperationType.API_CALL);
+    const api = getLazyAttioClient();
+    const path = '/lists/attributes';
+    try {
+        const response = await api.get(path);
+        return extract(response);
+    }
+    catch (error) {
+        if (process.env.NODE_ENV === 'development') {
+            log.error('Failed to fetch list attributes, returning default schema', error instanceof Error ? error : undefined);
+        }
+        return {
+            name: { type: 'string', required: true },
+            parent_object: { type: 'string', required: true },
+            description: { type: 'string', required: false },
+        };
+    }
+}
+//# sourceMappingURL=attributes.js.map

package/dist/objects/lists/attributes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attributes.js","sourceRoot":"","sources":["../../../src/objects/lists/attributes.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC1E,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEtC,MAAM,CAAC,KAAK,UAAU,iBAAiB;IACrC,MAAM,GAAG,GAAG,kBAAkB,CAC5B,eAAe,EACf,mBAAmB,EACnB,aAAa,CAAC,QAAQ,CACvB,CAAC;IACF,MAAM,GAAG,GAAG,kBAAkB,EAAE,CAAC;IACjC,MAAM,IAAI,GAAG,mBAAmB,CAAC;IAEjC,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACrC,OAAO,OAAO,CAA0B,QAAQ,CAAC,CAAC;IACpD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,aAAa,EAAE,CAAC;YAC3C,GAAG,CAAC,KAAK,CACP,2DAA2D,EAC3D,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAC3C,CAAC;QACJ,CAAC;QAED,OAAO;YACL,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;YACxC,aAAa,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;YACjD,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE;SACjD,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/objects/lists/base.d.ts

@@ -0,0 +1,22 @@
+import type { AttioList } from '../../types/attio.js';
+/**
+ * Gets all lists in the workspace.
+ */
+export declare function getLists(objectSlug?: string, limit?: number): Promise<AttioList[]>;
+/**
+ * Gets details for a specific list.
+ */
+export declare function getListDetails(listId: string): Promise<AttioList>;
+/**
+ * Creates a new list in Attio.
+ */
+export declare function createList(attributes: Record<string, unknown>): Promise<AttioList>;
+/**
+ * Updates a list in Attio.
+ */
+export declare function updateList(listId: string, attributes: Record<string, unknown>): Promise<AttioList>;
+/**
+ * Deletes a list in Attio.
+ */
+export declare function deleteList(listId: string): Promise<boolean>;
+//# sourceMappingURL=base.d.ts.map

package/dist/objects/lists/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../src/objects/lists/base.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAGtD;;GAEG;AACH,wBAAsB,QAAQ,CAC5B,UAAU,CAAC,EAAE,MAAM,EACnB,KAAK,GAAE,MAAW,GACjB,OAAO,CAAC,SAAS,EAAE,CAAC,CAsBtB;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAsDvE;AAED;;GAEG;AACH,wBAAsB,UAAU,CAC9B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAClC,OAAO,CAAC,SAAS,CAAC,CA+DpB;AAED;;GAEG;AACH,wBAAsB,UAAU,CAC9B,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAClC,OAAO,CAAC,SAAS,CAAC,CA6DpB;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CA2DjE"}