@iflow-mcp/attio-mcp 1.3.6

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

@@ -0,0 +1,91 @@
+/**
+ * Attio API client and related utilities
+ * Unified client factory with strategy pattern for different environments
+ */
+import { AxiosInstance } from 'axios';
+import { AttioAttributeSchema, AttioSelectOption, AttioStatusOption } from './types.js';
+import { ClientConfig } from './client-config.js';
+export declare const __MODULE_PATH__ = "attio-client";
+export type AttioClient = AxiosInstance;
+/**
+ * UNIFIED CLIENT FACTORY: Support new createAttioClient(config) signature
+ *
+ * @param config - Client configuration options
+ * @returns Configured Axios instance
+ */
+export declare function createAttioClient(config?: ClientConfig): AxiosInstance;
+/**
+ * BACKWARD COMPATIBILITY: Support old createAttioClient(apiKey) signature
+ *
+ * @param apiKey - The Attio API key (legacy signature)
+ * @returns Configured Axios instance
+ */
+export declare function createAttioClient(apiKey: string): AxiosInstance;
+/**
+ * LEGACY: Centralized authenticated Attio client builder
+ *
+ * @deprecated Use createAttioClient() instead for unified interface
+ * Guarantees proper Authorization header and fails fast if API key is missing
+ */
+export declare function buildAttioClient(opts?: {
+    apiKey?: string;
+    baseURL?: string;
+    timeoutMs?: number;
+}): AttioClient;
+/**
+ * LEGACY: Creates and configures an Axios instance for the Attio API
+ *
+ * @deprecated Use createAttioClient(config) instead for unified interface
+ * @param apiKey - The Attio API key
+ * @returns Configured Axios instance
+ */
+export declare function createLegacyAttioClient(apiKey: string): AxiosInstance;
+/**
+ * Gets the schema for a specific attribute.
+ * @param objectSlug - The slug of the object (e.g., 'companies').
+ * @param attributeSlug - The slug of the attribute (e.g., 'categories').
+ * @returns The attribute schema.
+ */
+export declare function getAttributeSchema(objectSlug: string, attributeSlug: string): Promise<AttioAttributeSchema>;
+/**
+ * Lists the available options for a select attribute on an object.
+ * @param objectSlug - The slug of the object.
+ * @param attributeSlug - The slug of the select attribute.
+ * @param showArchived - Whether to include archived options.
+ * @returns A list of available select options.
+ */
+export declare function getSelectOptions(objectSlug: string, attributeSlug: string, showArchived?: boolean): Promise<AttioSelectOption[]>;
+/**
+ * Lists the available options for a select attribute on a list.
+ * @param listId - The ID or slug of the list.
+ * @param attributeSlug - The slug of the select attribute.
+ * @param showArchived - Whether to include archived options.
+ * @returns A list of available select options.
+ */
+export declare function getListSelectOptions(listId: string, attributeSlug: string, showArchived?: boolean): Promise<AttioSelectOption[]>;
+/**
+ * Lists the available statuses for a status attribute.
+ * @param objectSlug - The slug of the object.
+ * @param attributeSlug - The slug of the status attribute.
+ * @param showArchived - Whether to include archived statuses.
+ * @returns A list of available statuses.
+ */
+export declare function getStatusOptions(objectSlug: string, attributeSlug: string, showArchived?: boolean): Promise<AttioStatusOption[]>;
+/**
+ * Initializes the global API client with the provided API key
+ *
+ * @deprecated Use createAttioClient() with ClientCache instead
+ * @param apiKey - The Attio API key
+ */
+export declare function initializeAttioClient(apiKey: string): AxiosInstance;
+/**
+ * Gets the global API client instance - SIMPLIFIED using unified architecture
+ *
+ * @deprecated Use createAttioClient() or getLazyAttioClient() instead
+ * @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(opts?: {
+    rawE2E?: boolean;
+}): 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;;;GAGG;AACH,OAAc,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAG7C,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,EAClB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,YAAY,EAGb,MAAM,oBAAoB,CAAC;AAa5B,eAAO,MAAM,eAAe,iBAAc,CAAC;AAE3C,MAAM,MAAM,WAAW,GAAG,aAAa,CAAC;AAmCxC;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,CAAC,EAAE,YAAY,GAAG,aAAa,CAAC;AACxE;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,CAAC;AAqEjE;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,CAAC,EAAE;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,WAAW,CAqBd;AAID;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,CA0DrE;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,oBAAoB,CAAC,CAe/B;AAED;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CACpC,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,MAAM,EACrB,YAAY,CAAC,EAAE,OAAO,GACrB,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAkB9B;AAED;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,MAAM,EACrB,YAAY,CAAC,EAAE,OAAO,GACrB,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAkB9B;AAED;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CACpC,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,MAAM,EACrB,YAAY,CAAC,EAAE,OAAO,GACrB,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAkB9B;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,CAInE;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,IAAI,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,aAAa,CAoEzE"}

package/dist/api/attio-client.js

@@ -0,0 +1,325 @@
+/**
+ * Attio API client and related utilities
+ * Unified client factory with strategy pattern for different environments
+ */
+import axios from 'axios';
+import { debug, error, OperationType } from '../utils/logger.js';
+import { getContextApiKey, validateApiKey } from './client-context.js';
+import { configureStandardInterceptors } from './client-interceptors.js';
+import { ClientMode, EnvironmentModeHandler, } from './client-config.js';
+import { ClientStrategyFactory } from './client-strategies.js';
+import { ClientCache } from './client-cache.js';
+// Module identification for debugging (compatible with both ESM and CJS)
+const MODULE_FILE = 'attio-client';
+// Debug loading info - use logger instead of console.log to avoid JSON parsing issues
+debug('attio-client', 'Module loaded', {
+    file: `${MODULE_FILE}.js`,
+    E2E_MODE: process.env.E2E_MODE,
+    USE_MOCK_DATA: process.env.USE_MOCK_DATA,
+});
+export const __MODULE_PATH__ = MODULE_FILE;
+/**
+ * Validates and throws standardized error for API key issues
+ * @param apiKey - The API key to validate
+ * @param source - Source of the API key for error context
+ * @throws {Error} With standardized error message for invalid API keys
+ */
+function validateAndThrowForApiKey(apiKey, source = 'provided') {
+    if (!apiKey || typeof apiKey !== 'string') {
+        throw new Error(`Invalid API key: API key must be a non-empty string (source: ${source})`);
+    }
+    if (!validateApiKey(apiKey)) {
+        throw new Error(`Invalid API key format: API key contains invalid characters or whitespace (source: ${source})`);
+    }
+    // Basic length validation - Attio API keys should be a reasonable length
+    if (apiKey.length < 10) {
+        throw new Error(`Invalid API key: API key appears to be too short (source: ${source})`);
+    }
+}
+// LEGACY: Global API client instance - replaced by ClientCache
+let apiInstance = null;
+/**
+ * Implementation of overloaded createAttioClient function
+ */
+export function createAttioClient(configOrApiKey = {}) {
+    // Handle legacy string API key parameter
+    if (typeof configOrApiKey === 'string') {
+        debug('attio-client', 'createAttioClient (LEGACY string signature) - redirecting to unified version');
+        return createLegacyAttioClient(configOrApiKey);
+    }
+    // Handle new config object parameter - this is the main implementation we defined above
+    const config = configOrApiKey;
+    // Get API key from config, environment, or context
+    // Supports both API keys and OAuth access tokens (Issue #928)
+    const apiKey = config.apiKey ??
+        process.env.ATTIO_API_KEY ??
+        process.env.ATTIO_ACCESS_TOKEN ??
+        getContextApiKey() ??
+        '';
+    // Determine the source for better error messages
+    const apiKeySource = config.apiKey
+        ? 'config parameter'
+        : process.env.ATTIO_API_KEY
+            ? 'ATTIO_API_KEY environment variable'
+            : process.env.ATTIO_ACCESS_TOKEN
+                ? 'ATTIO_ACCESS_TOKEN environment variable'
+                : 'context configuration';
+    // Validate API key using standardized validation
+    validateAndThrowForApiKey(apiKey, apiKeySource);
+    // Get environment-aware configuration
+    const environmentConfig = EnvironmentModeHandler.getClientConfig({
+        rawE2E: config.mode === ClientMode.E2E_RAW,
+    });
+    // Merge configurations: environment defaults < config parameter
+    const finalConfig = {
+        ...environmentConfig,
+        ...config,
+        apiKey, // Always use the validated API key
+        interceptors: {
+            ...environmentConfig.interceptors,
+            ...config.interceptors,
+        },
+    };
+    debug('attio-client', 'Creating unified client', {
+        mode: finalConfig.mode,
+        hasApiKey: Boolean(apiKey),
+        apiKeySource,
+        bypassCache: finalConfig.bypassCache,
+        baseURL: finalConfig.baseURL,
+        timeout: finalConfig.timeout,
+    });
+    // Use strategy factory to create the appropriate client
+    return ClientStrategyFactory.createClient(finalConfig);
+}
+/**
+ * LEGACY: Centralized authenticated Attio client builder
+ *
+ * @deprecated Use createAttioClient() instead for unified interface
+ * Guarantees proper Authorization header and fails fast if API key is missing
+ */
+export function buildAttioClient(opts) {
+    // Convert legacy options to new config format
+    const config = {
+        apiKey: opts?.apiKey,
+        baseURL: opts?.baseURL,
+        timeout: opts?.timeoutMs,
+        mode: ClientMode.PRODUCTION, // buildAttioClient was used for production
+    };
+    debug('attio-client', 'buildAttioClient (LEGACY) - redirecting to unified createAttioClient', {
+        hasApiKey: Boolean(opts?.apiKey),
+        baseURL: opts?.baseURL,
+        timeout: opts?.timeoutMs,
+    });
+    // Use the new unified client factory
+    return createAttioClient(config);
+}
+// Legacy getAttioClient exists below - it's already implemented
+/**
+ * LEGACY: Creates and configures an Axios instance for the Attio API
+ *
+ * @deprecated Use createAttioClient(config) instead for unified interface
+ * @param apiKey - The Attio API key
+ * @returns Configured Axios instance
+ */
+export function createLegacyAttioClient(apiKey) {
+    // Use standardized validation
+    validateAndThrowForApiKey(apiKey, 'parameter');
+    // Log client initialization for debugging (without exposing sensitive data)
+    debug(MODULE_FILE, 'Initializing Attio client with provided API key', { hasApiKey: Boolean(apiKey) }, 'createAttioClient', OperationType.API_CALL);
+    const baseURL = (process.env.ATTIO_BASE_URL || 'https://api.attio.com/v2').replace(/\/+$/, '');
+    // Log which client path is being used
+    debug('attio-client', 'Client baseURL configured', { baseURL });
+    const client = axios.create({
+        baseURL,
+        timeout: 20000,
+        headers: {
+            Authorization: `Bearer ${apiKey}`,
+            'Content-Type': 'application/json',
+            Accept: 'application/json',
+        },
+        // do NOT transform the response; we want raw server JSON
+        transformResponse: [
+            (data) => {
+                try {
+                    return JSON.parse(data);
+                }
+                catch {
+                    return data;
+                }
+            },
+        ],
+        validateStatus: (s) => s >= 200 && s < 300, // don't swallow 4xx/5xx
+    });
+    // Configure interceptors using the centralized module
+    const isE2EMode = process.env.E2E_MODE === 'true';
+    const interceptorPrefix = isE2EMode ? 'E2E' : '';
+    debug('attio-client', 'Configuring client interceptors', {
+        baseURL,
+        isE2EMode,
+        prefix: interceptorPrefix,
+    });
+    configureStandardInterceptors(client, {
+        prefix: interceptorPrefix,
+        enableDiagnostics: true,
+        enableErrorHandling: true,
+    });
+    return client;
+}
+/**
+ * Gets the schema for a specific attribute.
+ * @param objectSlug - The slug of the object (e.g., 'companies').
+ * @param attributeSlug - The slug of the attribute (e.g., 'categories').
+ * @returns The attribute schema.
+ */
+export async function getAttributeSchema(objectSlug, attributeSlug) {
+    const client = getAttioClient();
+    const path = `/objects/${objectSlug}/attributes/${attributeSlug}`;
+    try {
+        const response = await client.get(path);
+        return response.data?.data;
+    }
+    catch (err) {
+        error('attio-client', `Failed to get attribute schema for ${objectSlug}.${attributeSlug}`, err, { objectSlug, attributeSlug });
+        throw err;
+    }
+}
+/**
+ * Lists the available options for a select attribute on an object.
+ * @param objectSlug - The slug of the object.
+ * @param attributeSlug - The slug of the select attribute.
+ * @param showArchived - Whether to include archived options.
+ * @returns A list of available select options.
+ */
+export async function getSelectOptions(objectSlug, attributeSlug, showArchived) {
+    const client = getAttioClient();
+    let path = `/objects/${objectSlug}/attributes/${attributeSlug}/options`;
+    if (showArchived) {
+        path += '?show_archived=true';
+    }
+    try {
+        const response = await client.get(path);
+        return response.data?.data || [];
+    }
+    catch (err) {
+        error('attio-client', `Failed to get select options for ${objectSlug}.${attributeSlug}`, err, { objectSlug, attributeSlug, showArchived });
+        throw err;
+    }
+}
+/**
+ * Lists the available options for a select attribute on a list.
+ * @param listId - The ID or slug of the list.
+ * @param attributeSlug - The slug of the select attribute.
+ * @param showArchived - Whether to include archived options.
+ * @returns A list of available select options.
+ */
+export async function getListSelectOptions(listId, attributeSlug, showArchived) {
+    const client = getAttioClient();
+    let path = `/lists/${listId}/attributes/${attributeSlug}/options`;
+    if (showArchived) {
+        path += '?show_archived=true';
+    }
+    try {
+        const response = await client.get(path);
+        return response.data?.data || [];
+    }
+    catch (err) {
+        error('attio-client', `Failed to get select options for list ${listId}.${attributeSlug}`, err, { listId, attributeSlug, showArchived });
+        throw err;
+    }
+}
+/**
+ * Lists the available statuses for a status attribute.
+ * @param objectSlug - The slug of the object.
+ * @param attributeSlug - The slug of the status attribute.
+ * @param showArchived - Whether to include archived statuses.
+ * @returns A list of available statuses.
+ */
+export async function getStatusOptions(objectSlug, attributeSlug, showArchived) {
+    const client = getAttioClient();
+    let path = `/objects/${objectSlug}/attributes/${attributeSlug}/statuses`;
+    if (showArchived) {
+        path += '?show_archived=true';
+    }
+    try {
+        const response = await client.get(path);
+        return response.data?.data || [];
+    }
+    catch (err) {
+        error('attio-client', `Failed to get status options for ${objectSlug}.${attributeSlug}`, err, { objectSlug, attributeSlug, showArchived });
+        throw err;
+    }
+}
+/**
+ * Initializes the global API client with the provided API key
+ *
+ * @deprecated Use createAttioClient() with ClientCache instead
+ * @param apiKey - The Attio API key
+ */
+export function initializeAttioClient(apiKey) {
+    apiInstance = createAttioClient(apiKey); // This will use the legacy signature
+    ClientCache.setInstance(apiInstance);
+    return apiInstance;
+}
+/**
+ * Gets the global API client instance - SIMPLIFIED using unified architecture
+ *
+ * @deprecated Use createAttioClient() or getLazyAttioClient() instead
+ * @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(opts) {
+    debug('attio-client', 'getAttioClient (LEGACY) called', {
+        rawE2E: opts?.rawE2E,
+        hasCache: ClientCache.hasInstance(),
+        E2E_MODE: process.env.E2E_MODE,
+        USE_MOCK_DATA: process.env.USE_MOCK_DATA,
+    });
+    // Check if we should bypass cache and create fresh client
+    const shouldBypassCache = EnvironmentModeHandler.shouldUseRealClient() || opts?.rawE2E;
+    if (shouldBypassCache) {
+        debug('attio-client', 'Bypassing cache - creating fresh client');
+        // Clear cache to ensure fresh client
+        ClientCache.clearInstance();
+        apiInstance = null;
+        // Determine mode based on rawE2E option
+        const mode = opts?.rawE2E
+            ? ClientMode.E2E_RAW
+            : EnvironmentModeHandler.determineMode();
+        const config = {
+            mode,
+            bypassCache: true,
+        };
+        const client = createAttioClient(config);
+        debug('attio-client', 'Returning fresh E2E client');
+        return client;
+    }
+    // Check cache first
+    const cachedClient = ClientCache.getInstance();
+    if (cachedClient) {
+        debug('attio-client', 'Returning cached client from ClientCache');
+        return cachedClient;
+    }
+    // Check legacy cache
+    if (apiInstance) {
+        debug('attio-client', 'Returning cached client from legacy apiInstance');
+        return apiInstance;
+    }
+    // No cached client - create new one
+    debug('attio-client', 'No cached client found - creating new client');
+    try {
+        const config = {}; // Use environment defaults
+        const client = createAttioClient(config);
+        // Cache the client in both new and legacy systems
+        ClientCache.setInstance(client);
+        apiInstance = client;
+        debug('attio-client', 'Created and cached new client');
+        return client;
+    }
+    catch (validationError) {
+        const errorMessage = validationError instanceof Error
+            ? validationError.message
+            : String(validationError);
+        throw new Error(`API client not initialized and no valid API key or access token available. ${errorMessage} Call initializeAttioClient first or set ATTIO_API_KEY (or ATTIO_ACCESS_TOKEN for OAuth) environment variable.`);
+    }
+}
+//# 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":"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"}

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

@@ -0,0 +1,3 @@
+import type { AxiosInstance } from 'axios';
+export declare function resolveObjectSlug(client: AxiosInstance, logical: 'companies' | 'people'): Promise<string>;
+//# sourceMappingURL=attio-objects.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"attio-objects.d.ts","sourceRoot":"","sources":["../../src/api/attio-objects.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAK3C,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,WAAW,GAAG,QAAQ,GAC9B,OAAO,CAAC,MAAM,CAAC,CAmEjB"}

package/dist/api/attio-objects.js

@@ -0,0 +1,72 @@
+import { createScopedLogger } from '../utils/logger.js';
+const slugCache = new Map();
+export async function resolveObjectSlug(client, logical) {
+    if (slugCache.has(logical))
+        return slugCache.get(logical);
+    const log = createScopedLogger('attio-objects', 'resolveObjectSlug');
+    // 1) Try direct object endpoint (most reliable)
+    try {
+        const { data } = await client.get(`/objects/${logical}`);
+        const obj = (data && data.data) || data;
+        if (obj && (obj.api_slug || obj.slug || obj.id)) {
+            const slug = String(obj.api_slug || obj.slug || obj.id);
+            slugCache.set(logical, slug);
+            if (process.env.E2E_MODE === 'true') {
+                log.debug('/objects/{logical} probe', {
+                    logical,
+                    ok: true,
+                    ...obj,
+                    rawResponse: data,
+                });
+            }
+            return slug;
+        }
+        else {
+            if (process.env.E2E_MODE === 'true') {
+                log.debug('probe EMPTY', {
+                    logical,
+                    statusLike: data?.status,
+                    body: data,
+                });
+            }
+        }
+    }
+    catch (e) {
+        if (process.env.E2E_MODE === 'true') {
+            log.warn('/objects/{logical} probe failed', {
+                logical,
+                error: e?.response
+                    ?.data || e?.message,
+            });
+        }
+    }
+    // 2) Fall back to list (some tenants)
+    try {
+        const { data } = await client.get('/objects', { params: { limit: 200 } });
+        const list = Array.isArray(data?.data)
+            ? data.data
+            : Array.isArray(data)
+                ? data
+                : data?.objects || [];
+        for (const pd of list) {
+            if (!pd)
+                continue;
+            const fields = [pd.api_slug, pd.slug, pd.id].filter(Boolean).map(String);
+            if (fields.includes(logical)) {
+                const slug = String(pd.api_slug || pd.slug || pd.id);
+                slugCache.set(logical, slug);
+                return slug;
+            }
+        }
+    }
+    catch {
+        // Intentionally empty - fallback behavior handled below
+    }
+    // 3) Last resort: assume standard slug
+    if (process.env.E2E_MODE === 'true') {
+        log.warn('resolveObjectSlug fallback', { logical });
+    }
+    slugCache.set(logical, logical);
+    return logical;
+}
+//# sourceMappingURL=attio-objects.js.map

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

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

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

@@ -0,0 +1,123 @@
+/**
+ * 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?: string | number | boolean | null | Record<string, unknown>;
+    relationship?: {
+        object?: string;
+        cardinality?: 'one-to-one' | 'one-to-many' | 'many-to-one' | 'many-to-many';
+    } | null;
+    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;
+            }>;
+        };
+    };
+    allow_multiple_values?: boolean;
+}
+/**
+ * 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?: (string | number | boolean)[];
+}>;
+/**
+ * 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: string | number | boolean | null | undefined | Array<string | number | boolean> | Record<string, unknown>): Promise<unknown>;
+/**
+ * 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, unknown>): Promise<Record<string, unknown>>;
+//# 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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"}