attio-mcp 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,62 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+### Changed
+- Updated LICENSE from BSD-3-Clause to Apache-2.0 while preserving original BSD license attribution
+- Updated package.json author field to @kesslerio
+
+## [0.1.0] - 2025-01-06
+
+### Added
+- Initial release of Attio MCP Server
+- Model Context Protocol integration for Attio CRM platform
+- Company management tools (create, read, update, search, batch operations)
+- People management tools (create, read, update, search, relationships)
+- Lists management (get details, add/remove records)
+- Notes management (create, read for companies and people)
+- Tasks management (create, read, update, complete)
+- Records management (read operations)
+- Advanced search and filtering capabilities
+- Batch operations support for companies and people
+- Relationship management between entities
+- Comprehensive error handling and validation
+- Rate limiting and API resilience
+- TypeScript implementation with strict typing
+- Comprehensive test suite with Vitest
+- Docker support for containerized deployment
+- CLI tools for attribute discovery and development
+- Structured logging and debugging utilities
+- Configuration management with environment variables
+- Auto-discovery of Attio workspace attributes
+
+### Features
+- **MCP Integration**: Fully compatible with Model Context Protocol v1.4.1
+- **CRM Operations**: Complete CRUD operations for all major Attio entities
+- **Advanced Search**: Complex filtering with date ranges, numeric comparisons, and text matching
+- **Batch Processing**: Efficient bulk operations for high-volume data management
+- **Relationship Mapping**: Handle complex relationships between companies and people
+- **Error Recovery**: Robust error handling with detailed error messages
+- **Development Tools**: CLI utilities for workspace exploration and debugging
+- **Container Ready**: Docker support for easy deployment and scaling
+
+### Dependencies
+- @modelcontextprotocol/sdk: ^1.4.1 (MCP protocol support)
+- TypeScript: ^5.8.3 (Type safety and modern JavaScript features)
+- Vitest: ^3.1.4 (Testing framework)
+- And other quality assurance and utility tools
+
+### Documentation
+- Comprehensive API documentation
+- Setup and configuration guides
+- Integration examples and workflows
+- Troubleshooting guides
+- Development and contribution guidelines
+
+[Unreleased]: https://github.com/kesslerio/attio-mcp-server/compare/v0.1.0...HEAD
+[0.1.0]: https://github.com/kesslerio/attio-mcp-server/releases/tag/v0.1.0

package/LICENSE

@@ -0,0 +1,236 @@
+Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (which shall not be interpreted as modifying the License).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based upon (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and that do not otherwise combine with the Work in such a way
+      as to form a larger program.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control
+      systems, and issue tracking systems that are managed by, or on behalf
+      of, the Licensor for the purpose of discussing and improving the Work,
+      but excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to use, reproduce, modify, merge, publish,
+      distribute, sublicense, and/or sell copies of the Work, and to
+      permit persons to whom the Work is furnished to do so, subject to
+      the following conditions:
+
+      The above copyright notice and this permission notice shall be
+      included in all copies or substantial portions of the Work.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright notice to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Support. When redistributing the Work or
+      Derivative Works thereof, You may choose to offer, and charge a fee
+      for, warranty, support, indemnity, or other liability obligations
+      and/or rights consistent with this License. However, in accepting such
+      obligations, You may act only on Your own behalf and on Your sole
+      responsibility, not on behalf of any other Contributor, and only if
+      You agree to indemnify, defend, and hold each Contributor harmless for
+      any liability incurred by, or claims asserted against, such Contributor
+      by reason of your accepting any such warranty or support.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in comments when
+      applicable for the file type.
+
+      Copyright [yyyy] [name of copyright holder]
+
+      Licensed under the Apache License, Version 2.0 (the "License");
+      you may not use this file except in compliance with the License.
+      You may obtain a copy of the License at
+
+          http://www.apache.org/licenses/
+
+      Unless required by applicable law or agreed to in writing, software
+      distributed under the License is distributed on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+      See the License for the specific language governing permissions and
+      limitations under the License.
+
+
+================================================================================
+NOTICE: This software contains code originally licensed under the BSD-3-Clause
+License. The original copyright notice is preserved below:
+
+BSD 3-Clause License
+
+Copyright (c) 2025, @hmk
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+================================================================================

package/README.md

@@ -0,0 +1,105 @@
+# Attio MCP Server
+
+[![License: BSD 3-Clause](https://img.shields.io/badge/License-BSD%203--Clause-blue.svg)](LICENSE)
+[![CI/CD Pipeline](https://github.com/kesslerio/attio-mcp-server/actions/workflows/ci.yml/badge.svg)](https://github.com/kesslerio/attio-mcp-server/actions/workflows/ci.yml)
+[![codecov](https://codecov.io/gh/kesslerio/attio-mcp-server/branch/main/graph/badge.svg)](https://codecov.io/gh/kesslerio/attio-mcp-server)
+[![Node.js Version](https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen.svg)](https://nodejs.org/)
+[![npm version](https://badge.fury.io/js/attio-mcp-server.svg)](https://badge.fury.io/js/attio-mcp-server)
+
+A Model Context Protocol (MCP) server for [Attio](https://attio.com/), the AI-native CRM. This server enables AI assistants like Claude to interact directly with your Attio data, providing a seamless integration between conversational AI and your CRM.
+
+## 🚀 Key Features
+
+- **Comprehensive Attio API Support**
+  - Companies: Search, view details, manage notes
+  - People: Search (with email/phone support), view details, manage notes
+  - Lists: View, manage entries, add/remove records
+  - Records: Create, read, update, delete (coming soon)
+  - Tasks: Create, update, and link to records
+
+- **Enhanced Capabilities**
+  - Robust error handling with helpful messages
+  - Automatic retry logic with exponential backoff
+  - Input validation to prevent common errors
+  - Standardized response formatting
+
+## 🔍 Example: Using with Claude
+
+Ask Claude natural questions about your Attio data:
+
+```
+"Find all technology companies in our CRM"
+"Add a note to Acme Corporation about our recent product demo"
+"Show me all contacts from Microsoft who were added this month"
+"Add Sarah Johnson's new phone number: +1-555-123-4567"
+```
+
+## ⚡ Quick Start
+
+### Prerequisites
+
+- Node.js (v18 or higher)
+- Attio API Key ([Get one here](https://developers.attio.com/reference/get_v2-objects))
+
+### Installation
+
+```bash
+npm install attio-mcp-server
+```
+
+### Configuration for Claude Desktop
+
+```json
+{
+  "mcpServers": {
+    "attio": {
+      "command": "npx",
+      "args": ["attio-mcp-server"],
+      "env": {
+        "ATTIO_API_KEY": "YOUR_ATTIO_API_KEY"
+      }
+    }
+  }
+}
+```
+
+## 🌐 Deployment Options
+
+- **Local Development**: [Development Guide](./docs/development-guide.md)
+- **Docker**: [Docker Guide](./docs/docker/docker-guide.md)
+  - Easy setup with Docker Compose
+  - Health checks included
+  - Configurable through environment variables
+
+## 📚 Documentation
+
+Full documentation is available in the [docs directory](./docs):
+
+- **Getting Started**
+  - [Installation & Setup](./docs/getting-started.md)
+  - [Claude Desktop Config](./docs/claude-desktop-config.md)
+  - [Troubleshooting Guide](./TROUBLESHOOTING.md)
+
+- **API Reference**
+  - [API Overview](./docs/api/api-overview.md)
+  - [People API](./docs/api/people-api.md)
+  - [Companies API](./docs/api/companies-api.md)
+  - [Lists API](./docs/api/lists-api.md)
+  - [Notes API](./docs/api/notes-api.md)
+
+- **Deployment**
+  - [Docker Guide](./docs/docker/docker-guide.md)
+  - [Security Best Practices](./docs/docker/security-guide.md)
+
+- **Development**
+  - [Contributing Guidelines](./CONTRIB.md)
+  - [Error Handling](./docs/api/error-handling.md)
+  - [Extending MCP](./docs/api/extending-mcp.md)
+
+## 🤝 Contributing
+
+Contributions are welcome! Please see our [Contributing Guidelines](./CONTRIB.md) for details on how to submit pull requests, report issues, and suggest improvements.
+
+## 📄 License
+
+This project is licensed under the BSD 3-Clause License - see the [LICENSE](LICENSE) file for details.

package/dist/api/attio-client.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Attio API client and related utilities
+ */
+import { AxiosInstance } from 'axios';
+/**
+ * Creates and configures an Axios instance for the Attio API
+ *
+ * @param apiKey - The Attio API key
+ * @returns Configured Axios instance
+ */
+export declare function createAttioClient(apiKey: string): AxiosInstance;
+/**
+ * Initializes the global API client with the provided API key
+ *
+ * @param apiKey - The Attio API key
+ */
+export declare function initializeAttioClient(apiKey: string): void;
+/**
+ * Gets the global API client instance
+ *
+ * @returns The Axios instance for the Attio API
+ * @throws If the API client hasn't been initialized and no API key is available
+ */
+export declare function getAttioClient(): AxiosInstance;
+//# sourceMappingURL=attio-client.d.ts.map

package/dist/api/attio-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attio-client.d.ts","sourceRoot":"","sources":["../../src/api/attio-client.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAc,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAM7C;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,CA2B/D;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAE1D;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,IAAI,aAAa,CAgB9C"}

package/dist/api/attio-client.js

@@ -0,0 +1,64 @@
+/**
+ * Attio API client and related utilities
+ */
+import axios from 'axios';
+import { createAttioError } from '../utils/error-handler.js';
+// Global API client instance
+let apiInstance = null;
+/**
+ * Creates and configures an Axios instance for the Attio API
+ *
+ * @param apiKey - The Attio API key
+ * @returns Configured Axios instance
+ */
+export function createAttioClient(apiKey) {
+    const client = axios.create({
+        baseURL: 'https://api.attio.com/v2',
+        headers: {
+            Authorization: `Bearer ${apiKey}`,
+            'Content-Type': 'application/json',
+        },
+    });
+    // Add response interceptor for error handling
+    client.interceptors.response.use((response) => response, (error) => {
+        if (process.env.NODE_ENV === 'development') {
+            console.error('[Attio API] Request failed:');
+            console.error('URL:', error.config?.url);
+            console.error('Method:', error.config?.method);
+            console.error('Data:', error.config?.data);
+            console.error('Response status:', error.response?.status);
+            console.error('Response data:', error.response?.data);
+        }
+        const enhancedError = createAttioError(error);
+        return Promise.reject(enhancedError);
+    });
+    return client;
+}
+/**
+ * Initializes the global API client with the provided API key
+ *
+ * @param apiKey - The Attio API key
+ */
+export function initializeAttioClient(apiKey) {
+    apiInstance = createAttioClient(apiKey);
+}
+/**
+ * Gets the global API client instance
+ *
+ * @returns The Axios instance for the Attio API
+ * @throws If the API client hasn't been initialized and no API key is available
+ */
+export function getAttioClient() {
+    if (!apiInstance) {
+        // Fallback: try to initialize from environment variable
+        const apiKey = process.env.ATTIO_API_KEY;
+        if (apiKey) {
+            console.warn('[Attio API] API client not initialized, auto-initializing from environment variable');
+            initializeAttioClient(apiKey);
+            return apiInstance;
+        }
+        throw new Error('API client not initialized. Call initializeAttioClient first or set ATTIO_API_KEY environment variable.');
+    }
+    return apiInstance;
+}
+//# sourceMappingURL=attio-client.js.map

package/dist/api/attio-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attio-client.js","sourceRoot":"","sources":["../../src/api/attio-client.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAwB,MAAM,OAAO,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAE7D,6BAA6B;AAC7B,IAAI,WAAW,GAAyB,IAAI,CAAC;AAE7C;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAc;IAC9C,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;QAC1B,OAAO,EAAE,0BAA0B;QACnC,OAAO,EAAE;YACP,aAAa,EAAE,UAAU,MAAM,EAAE;YACjC,cAAc,EAAE,kBAAkB;SACnC;KACF,CAAC,CAAC;IAEH,8CAA8C;IAC9C,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,GAAG,CAC9B,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,EACtB,CAAC,KAAK,EAAE,EAAE;QACR,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,aAAa,EAAE,CAAC;YAC3C,OAAO,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAAC;YAC7C,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;YACzC,OAAO,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YAC/C,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;YAC3C,OAAO,CAAC,KAAK,CAAC,kBAAkB,EAAE,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YAC1D,OAAO,CAAC,KAAK,CAAC,gBAAgB,EAAE,KAAK,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QACxD,CAAC;QACD,MAAM,aAAa,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;QAC9C,OAAO,OAAO,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;IACvC,CAAC,CACF,CAAC;IAEF,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAAc;IAClD,WAAW,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;AAC1C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc;IAC5B,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,wDAAwD;QACxD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;QACzC,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,CAAC,IAAI,CACV,qFAAqF,CACtF,CAAC;YACF,qBAAqB,CAAC,MAAM,CAAC,CAAC;YAC9B,OAAO,WAAY,CAAC;QACtB,CAAC;QACD,MAAM,IAAI,KAAK,CACb,yGAAyG,CAC1G,CAAC;IACJ,CAAC;IACD,OAAO,WAAW,CAAC;AACrB,CAAC"}

package/dist/api/attribute-types.d.ts

@@ -0,0 +1,119 @@
+/**
+ * Interface for Attio attribute metadata
+ */
+export interface AttioAttributeMetadata {
+    id: {
+        workspace_id: string;
+        object_id: string;
+        attribute_id: string;
+    };
+    api_slug: string;
+    title: string;
+    description?: string;
+    type: string;
+    is_system_attribute?: boolean;
+    is_writable?: boolean;
+    is_required?: boolean;
+    is_unique?: boolean;
+    is_multiselect?: boolean;
+    is_default_value_enabled?: boolean;
+    is_archived?: boolean;
+    default_value?: any;
+    relationship?: any;
+    created_at?: string;
+    config?: {
+        currency?: {
+            default_currency_code?: string | null;
+            display_type?: string | null;
+        };
+        record_reference?: {
+            allowed_object_ids?: string[] | null;
+        };
+        select?: {
+            options?: Array<{
+                id: string;
+                title: string;
+                value: string;
+            }>;
+        };
+    };
+}
+/**
+ * Fetches and caches attribute metadata for a specific object type
+ *
+ * @param objectSlug - The object type (e.g., 'companies', 'people')
+ * @returns Map of attribute slug to metadata
+ */
+export declare function getObjectAttributeMetadata(objectSlug: string): Promise<Map<string, AttioAttributeMetadata>>;
+/**
+ * Detects the field type of a specific attribute
+ *
+ * @param objectSlug - The object type (e.g., 'companies', 'people')
+ * @param attributeSlug - The attribute slug (e.g., 'name', 'products')
+ * @returns The detected field type
+ */
+export declare function detectFieldType(objectSlug: string, attributeSlug: string): Promise<string>;
+/**
+ * Gets detailed type information for an attribute
+ *
+ * @param objectSlug - The object type
+ * @param attributeSlug - The attribute slug
+ * @returns Detailed type information
+ */
+export declare function getAttributeTypeInfo(objectSlug: string, attributeSlug: string): Promise<{
+    fieldType: string;
+    isArray: boolean;
+    isRequired: boolean;
+    isUnique: boolean;
+    attioType: string;
+    metadata: AttioAttributeMetadata | null;
+}>;
+/**
+ * Clears the attribute cache for a specific object type or all types
+ *
+ * @param objectSlug - Optional object type to clear (clears all if not provided)
+ */
+export declare function clearAttributeCache(objectSlug?: string): void;
+/**
+ * Looks up the API slug for an attribute by its ID
+ *
+ * @param objectSlug - The object type
+ * @param attributeId - The attribute's unique ID
+ * @returns The corresponding slug or null if not found
+ */
+export declare function getAttributeSlugById(objectSlug: string, attributeId: string): Promise<string | null>;
+/**
+ * Gets field validation rules based on attribute metadata
+ *
+ * @param objectSlug - The object type
+ * @param attributeSlug - The attribute slug
+ * @returns Validation rules for the field
+ */
+export declare function getFieldValidationRules(objectSlug: string, attributeSlug: string): Promise<{
+    type: string;
+    required: boolean;
+    unique: boolean;
+    allowMultiple: boolean;
+    pattern?: string;
+    minLength?: number;
+    maxLength?: number;
+    enum?: any[];
+}>;
+/**
+ * Formats an attribute value according to Attio's expected format
+ *
+ * @param objectSlug - The object type
+ * @param attributeSlug - The attribute slug
+ * @param value - The raw value to format
+ * @returns The formatted value in Attio's expected structure
+ */
+export declare function formatAttributeValue(objectSlug: string, attributeSlug: string, value: any): Promise<any>;
+/**
+ * Validates and formats all attributes for an object
+ *
+ * @param objectSlug - The object type
+ * @param attributes - Raw attributes object
+ * @returns Formatted attributes ready for Attio API
+ */
+export declare function formatAllAttributes(objectSlug: string, attributes: Record<string, any>): Promise<Record<string, any>>;
+//# sourceMappingURL=attribute-types.d.ts.map

package/dist/api/attribute-types.d.ts.map

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