attio-mcp 1.3.5 → 1.4.0

package/dist/services/value-transformer/types.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Types for the value transformer service
+ * Auto-transforms values before API calls to prevent common errors
+ */
+import { UniversalResourceType } from '../../handlers/tool-configs/universal/types.js';
+/**
+ * Context provided to transformers
+ */
+export interface TransformContext {
+    /** The resource type being operated on */
+    resourceType: UniversalResourceType;
+    /** The operation type (create or update) */
+    operation: 'create' | 'update';
+    /** Optional record ID for updates */
+    recordId?: string;
+    /**
+     * Optional pre-fetched attribute metadata to avoid duplicate API calls
+     * @see Issue #984 - Consolidate metadata fetching
+     */
+    attributeMetadata?: Map<string, AttributeMetadata>;
+}
+/**
+ * Result of a transformation
+ */
+export interface TransformResult {
+    /** Whether transformation was applied */
+    transformed: boolean;
+    /** The original value */
+    originalValue: unknown;
+    /** The transformed value (same as original if not transformed) */
+    transformedValue: unknown;
+    /** Human-readable description of what was transformed */
+    description?: string;
+}
+/**
+ * Result of transforming an entire record
+ */
+export interface RecordTransformResult {
+    /** The transformed record data */
+    data: Record<string, unknown>;
+    /** List of transformations applied */
+    transformations: FieldTransformation[];
+    /** Warnings about potential issues */
+    warnings: string[];
+}
+/**
+ * Details about a single field transformation
+ */
+export interface FieldTransformation {
+    /** Field name that was transformed */
+    field: string;
+    /** Original value */
+    from: unknown;
+    /** Transformed value */
+    to: unknown;
+    /** Type of transformation applied */
+    type: TransformationType;
+    /** Human-readable description */
+    description: string;
+}
+/**
+ * Types of transformations supported
+ */
+export type TransformationType = 'status_title_to_id' | 'multi_select_wrap' | 'select_title_to_array' | 'array_coercion' | 'record_reference_format';
+/**
+ * Attribute metadata needed for transformation
+ */
+export interface AttributeMetadata {
+    slug: string;
+    type: string;
+    title?: string;
+    api_slug?: string;
+    is_system_attribute?: boolean;
+    is_writable?: boolean;
+    /** Indicates multi-select attribute (Attio uses type="select" + is_multiselect=true) */
+    is_multiselect?: boolean;
+    /** Relationship metadata for record-reference attributes (Issue #997) */
+    relationship?: {
+        /** Target object type (e.g., 'companies', 'people') */
+        object?: string;
+        /** Relationship cardinality (API may return any string) */
+        cardinality?: string;
+    };
+}
+/**
+ * Record reference value format expected by Attio API
+ */
+export interface RecordReferenceValue {
+    target_object: string;
+    target_record_id: string;
+}
+/**
+ * Option for select/status attributes
+ */
+export interface AttributeOption {
+    id: string;
+    title: string;
+    is_archived?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/services/value-transformer/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/services/value-transformer/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,4CAA4C,CAAC;AAEnF;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,0CAA0C;IAC1C,YAAY,EAAE,qBAAqB,CAAC;IACpC,4CAA4C;IAC5C,SAAS,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC/B,qCAAqC;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;CACpD;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,yCAAyC;IACzC,WAAW,EAAE,OAAO,CAAC;IACrB,yBAAyB;IACzB,aAAa,EAAE,OAAO,CAAC;IACvB,kEAAkE;IAClE,gBAAgB,EAAE,OAAO,CAAC;IAC1B,yDAAyD;IACzD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,sCAAsC;IACtC,eAAe,EAAE,mBAAmB,EAAE,CAAC;IACvC,sCAAsC;IACtC,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,sCAAsC;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,qBAAqB;IACrB,IAAI,EAAE,OAAO,CAAC;IACd,wBAAwB;IACxB,EAAE,EAAE,OAAO,CAAC;IACZ,qCAAqC;IACrC,IAAI,EAAE,kBAAkB,CAAC;IACzB,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAC1B,oBAAoB,GACpB,mBAAmB,GACnB,uBAAuB,GACvB,gBAAgB,GAChB,yBAAyB,CAAC;AAE9B;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,wFAAwF;IACxF,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,yEAAyE;IACzE,YAAY,CAAC,EAAE;QACb,uDAAuD;QACvD,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,2DAA2D;QAC3D,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB"}

package/dist/services/value-transformer/types.js

@@ -0,0 +1,6 @@
+/**
+ * Types for the value transformer service
+ * Auto-transforms values before API calls to prevent common errors
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/services/value-transformer/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/services/value-transformer/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/templates/skill/SKILL.template.md

@@ -0,0 +1,78 @@
+---
+name: attio-workspace-schema
+description: Use when working with Attio workspace data to know valid attributes, field names, and option values for {{#each metadata.objects}}{{this}}{{#unless @last}}, {{/unless}}{{/each}}.
+---
+
+# Attio Workspace Schema Reference
+
+**Generated**: {{metadata.generatedAt}}
+**Objects**: {{#each metadata.objects}}{{this}}{{#unless @last}}, {{/unless}}{{/each}}
+
+⚠️ **CRITICAL: Display Name vs API Slug**
+
+The #1 error source when working with Attio is using Display Names instead of API Slugs. **Always use API Slugs from the per-object files below.**
+
+---
+
+## Attribute Reference by Object
+
+**Only open the file for the object you're working with** (progressive disclosure):
+
+{{#each objects}}
+
+- {{displayName}}: [resources/{{objectSlug}}-attributes.md](resources/{{objectSlug}}-attributes.md)
+  {{/each}}
+
+Each file contains:
+
+- Select/status option values
+- Complete attribute specifications
+- Relationship definitions
+
+## Complex Type Structures
+
+See [resources/complex-types.md](resources/complex-types.md) for:
+
+- Location object structure (10 required fields)
+- Personal name object structure
+- Phone number formatting
+- Email address handling
+
+---
+
+## Usage Guidelines
+
+1. **Always use API Slugs**, never Display Names
+   - ❌ Wrong: `{"Team size": "51-200"}`
+   - ✅ Correct: `{"team_size": "51-200"}`
+
+2. **Check multi-select flag** before sending values
+   - Multi-select (✓): Send array `["value1", "value2"]`
+   - Single-select (✗): Send string `"value1"`
+
+3. **Use exact option titles (slugs)** from the tables
+   - Per Attio docs, select option slugs are the title field
+   - Case-sensitive
+
+4. **Complex types require specific object structures**
+   - Location: All 10 fields must be present (use `null` for empty)
+   - Personal-name: Minimum `first_name` required
+   - See resources/complex-types.md for details
+
+5. **When unsure, use MCP discovery tools**:
+   - `records_discover_attributes` - Get attribute metadata
+   - `records_get_attribute_options` - Get valid select/status values
+
+---
+
+## When to Use This Skill
+
+Use this skill when:
+
+- Creating or updating Attio records
+- Filtering or searching by specific attributes
+- Validating attribute values before API calls
+- Understanding field requirements and constraints
+- Working with select/status fields and need valid option values
+
+> ⚠️ **This schema may become outdated.** When in doubt, verify with MCP discovery tools listed above.

package/dist/templates/skill/attribute-reference.template.md

@@ -0,0 +1,126 @@
+# {{#each objects}}{{displayName}}{{/each}} Attributes
+
+⚠️ **Always use API Slugs, never Display Names**
+
+{{#each objects}}
+
+## Display Name → API Slug Mapping
+
+| Display Name | API Slug | Type | Multi | Required | Unique |
+| ------------ | -------- | ---- | ----- | -------- | ------ |
+
+{{#each attributes}}
+| {{displayName}} | `{{apiSlug}}` | {{type}} | {{#if isMultiselect}}✓{{else}}✗{{/if}} | {{#if isRequired}}✓{{else}}✗{{/if}} | {{#if isUnique}}✓{{else}}✗{{/if}} |
+{{/each}}
+
+---
+
+## Detailed Specifications
+
+{{#each attributes}}
+
+### {{displayName}} (`{{apiSlug}}`)
+
+**Type**: `{{type}}`{{#if isMultiselect}} _(multi-select)_{{/if}}{{#if isRequired}} _(required)_{{/if}}{{#if isUnique}} _(unique)_{{/if}}{{#unless isWritable}} _(read-only)_{{/unless}}{{#if description}}
+**Description**: {{{description}}}{{/if}}
+{{#if options}}
+**Options**: {{#each options}}{{{title}}}{{#unless @last}}, {{/unless}}{{/each}}{{#if optionsTruncated}} _(showing {{options.length}} of {{totalOptions}})_{{/if}}
+{{/if}}
+{{#if complexTypeStructure}}
+**Structure**:
+
+```json
+{{{json complexTypeStructure}}}
+```
+
+{{/if}}
+{{#if relationship}}
+**Relationship**:
+
+- Target Object: `{{relationship.targetObject}}`
+- Cardinality: {{relationship.cardinality}}
+  {{/if}}
+
+---
+
+{{/each}}
+
+---
+
+## ⚠️ Common Pitfalls
+
+### 1. Option Fields: Status vs Select Behavior
+
+**Status fields** (type: `status`) - Auto-converts human-readable titles:
+
+- ✅ Use title: `stage: "Demo Scheduling"`
+- ✅ Already converts to: `{ status_id: "uuid" }`
+- Titles are case-insensitive and support partial matching
+
+**Select fields** (type: `select`) - Accepts titles OR UUIDs:
+
+- ✅ Use title: `lead_type: ["Potential Customer"]`
+- ✅ Use UUID: `lead_type: ["8f6ac4eb-6ab6-40be-909a-29042d3674e7"]`
+- Titles are case-sensitive (exact match required)
+- Multi-select fields must always use arrays (even for single values)
+
+**Both field types accept exact titles** - Use whichever is more convenient for your use case
+
+### 2. Array Fields: Always Use Arrays
+
+These field types **require arrays** even for single values:
+
+**Multi-select fields** (marked with ✓ in Multi column):
+
+- ❌ Wrong: `domains: "example.com"`
+- ✅ Correct: `domains: ["example.com"]`
+
+**Select fields** (even single-select):
+
+- ❌ Wrong: `lead_type: "uuid"`
+- ✅ Correct: `lead_type: ["uuid"]`
+
+**Record references** (actor-reference, record-reference types):
+
+- ❌ Wrong: `team: "person_id"`
+- ✅ Correct: `team: ["person_id"]`
+
+**Common error**: `"expects array"` or `"invalid type"`
+
+### 3. Data Type Formatting
+
+Types must match exactly:
+
+**Number fields**:
+
+- ✅ Correct: `lead_score: 85`
+- ❌ Wrong: `lead_score: "85"` or `lead_score: "8.5/10"`
+
+**Boolean fields** (checkbox type):
+
+- ✅ Correct: `has_weight_loss_program_boolean: true`
+- ❌ Wrong: `has_weight_loss_program_boolean: "true"`
+
+**Date fields**:
+
+- ✅ Correct: `foundation_date: "2024-12-14"`
+- ❌ Wrong: `foundation_date: "December 14, 2024"`
+
+### 4. Read-Only Fields
+
+Fields marked as _(read-only)_ cannot be updated:
+
+- `record_id`, `created_at`, `created_by`, interaction fields
+
+Attempting to update read-only fields will cause API errors.
+
+### 5. Complex Type Structures
+
+Location, personal-name, phone-number, and email-address types require **complete object structures**. See [complex-types.md](complex-types.md) for required field formats.
+
+**Common mistake**: Sending incomplete location objects
+
+- ❌ Wrong: `primary_location: {locality: "San Francisco"}`
+- ✅ Correct: All 10 location fields must be present (use `null` for empty fields)
+
+{{/each}}

package/dist/templates/skill/complex-types.template.md

@@ -0,0 +1,255 @@
+# Complex Type Structures
+
+This document provides detailed structure requirements for complex Attio attribute types.
+
+---
+
+## Location
+
+Attio requires **ALL 10 fields** to be present when writing location attributes. Use `null` for empty fields.
+
+### Required Structure
+
+```typescript
+{
+  line_1: string | null,        // Street address
+  line_2: string | null,        // Apt/Suite
+  line_3: string | null,        // Additional address line
+  line_4: string | null,        // Additional address line
+  locality: string | null,      // City
+  region: string | null,        // State/Province
+  postcode: string | null,      // ZIP/Postal code
+  country_code: string | null,  // ISO country code (e.g., "US", "GB")
+  latitude: number | null,      // Coordinates
+  longitude: number | null      // Coordinates
+}
+```
+
+### Common Mistakes
+
+❌ **Wrong**: Missing fields
+
+```json
+{
+  "line_1": "123 Main St",
+  "locality": "New York"
+}
+```
+
+✅ **Correct**: All fields present
+
+```json
+{
+  "line_1": "123 Main St",
+  "line_2": null,
+  "line_3": null,
+  "line_4": null,
+  "locality": "New York",
+  "region": "NY",
+  "postcode": "10001",
+  "country_code": "US",
+  "latitude": null,
+  "longitude": null
+}
+```
+
+### Common Field Aliases
+
+These are NOT valid - always use the exact field names above:
+
+- `city` → Use `locality`
+- `state` → Use `region`
+- `zip` → Use `postcode`
+- `country` → Use `country_code`
+
+---
+
+## Personal Name
+
+### Required Structure
+
+```typescript
+{
+  first_name: string,           // Required
+  last_name: string | null,
+  middle_name: string | null,
+  title: string | null,         // e.g., "Dr.", "Prof.", "Mr."
+  full_name: string             // Auto-generated by Attio
+}
+```
+
+### String Parsing
+
+When Attio receives a string instead of an object, it will parse it:
+
+```json
+Input: "John Doe"
+Parsed to:
+{
+  "first_name": "John",
+  "last_name": "Doe",
+  "middle_name": null,
+  "title": null,
+  "full_name": "John Doe"
+}
+```
+
+### Examples
+
+✅ **Correct**: Object format
+
+```json
+{
+  "first_name": "Jane",
+  "last_name": "Smith",
+  "middle_name": null,
+  "title": "Dr.",
+  "full_name": "Dr. Jane Smith"
+}
+```
+
+✅ **Correct**: String format (auto-parsed)
+
+```json
+"Jane Smith"
+```
+
+---
+
+## Phone Number
+
+### Required Structure
+
+```typescript
+{
+  country_code: string,         // e.g., "+1", "+44"
+  number: string,               // Digits only (no formatting)
+  original_number: string       // As provided by user
+}
+```
+
+### Examples
+
+✅ **Correct**:
+
+```json
+{
+  "country_code": "+1",
+  "number": "5551234567",
+  "original_number": "(555) 123-4567"
+}
+```
+
+### String Parsing
+
+Attio will attempt to parse phone number strings:
+
+```json
+Input: "+1 (555) 123-4567"
+Parsed to:
+{
+  "country_code": "+1",
+  "number": "5551234567",
+  "original_number": "+1 (555) 123-4567"
+}
+```
+
+---
+
+## Email Address
+
+### Required Structure
+
+```typescript
+{
+  email_address: string; // Must be valid email format
+}
+```
+
+### Examples
+
+✅ **Correct**: Object format
+
+```json
+{
+  "email_address": "jane@example.com"
+}
+```
+
+✅ **Correct**: String format (auto-converted)
+
+```json
+"jane@example.com"
+```
+
+---
+
+## Usage in API Calls
+
+### Creating Records with Complex Types
+
+```typescript
+// Example: Creating a company with location
+{
+  "name": "Acme Corp",
+  "primary_location": {
+    "line_1": "123 Main St",
+    "line_2": null,
+    "line_3": null,
+    "line_4": null,
+    "locality": "San Francisco",
+    "region": "CA",
+    "postcode": "94105",
+    "country_code": "US",
+    "latitude": null,
+    "longitude": null
+  }
+}
+```
+
+### Updating Complex Type Fields
+
+When updating, you must provide the **complete structure**, even if only changing one field:
+
+❌ **Wrong**: Partial update
+
+```json
+{
+  "primary_location": {
+    "line_1": "456 New St"
+  }
+}
+```
+
+✅ **Correct**: Complete structure
+
+```json
+{
+  "primary_location": {
+    "line_1": "456 New St",
+    "line_2": null,
+    "line_3": null,
+    "line_4": null,
+    "locality": "San Francisco",
+    "region": "CA",
+    "postcode": "94105",
+    "country_code": "US",
+    "latitude": null,
+    "longitude": null
+  }
+}
+```
+
+---
+
+## Need Help?
+
+If you encounter errors with complex types:
+
+1. **Verify structure completeness**: All required fields present?
+2. **Check field names**: Exact match (case-sensitive)?
+3. **Use MCP discovery tools**:
+   - `records_discover_attributes` - Get attribute metadata
+   - Check the attribute's type to confirm it's a complex type
+
+For the most up-to-date structures, always verify with the MCP discovery tools.

package/dist/utils/client-resolver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client-resolver.d.ts","sourceRoot":"","sources":["../../src/utils/client-resolver.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAqEtC;;;;;;GAMG;AACH,wBAAgB,kBAAkB,IAAI,aAAa,CAyFlD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,IAAI,aAAa,CAOtE;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,IAAI,aAAa,CAIvD"}
+{"version":3,"file":"client-resolver.d.ts","sourceRoot":"","sources":["../../src/utils/client-resolver.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAmEtC;;;;;;GAMG;AACH,wBAAgB,kBAAkB,IAAI,aAAa,CA4ElD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,IAAI,aAAa,CAOtE;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,IAAI,aAAa,CAIvD"}

package/dist/utils/client-resolver.js

@@ -4,6 +4,8 @@
  */
 import * as AttioClientModule from '../api/attio-client.js';
 import { getContextApiKey } from '../api/client-context.js';
+import { createScopedLogger } from './logger.js';
+const logger = createScopedLogger('client-resolver');
 /**
  * Guards that the resolved value behaves like an Axios instance. We keep the
  * checks intentionally simple so tests can provide lightweight mocks.
@@ -33,9 +35,7 @@ function assertAxiosInstance(value, source) {
                 ? Object.keys(candidate).slice(0, 10)
                 : [],
         };
-        if (process.env.MCP_LOG_LEVEL === 'DEBUG') {
-            console.error(`[client-resolver:assertAxiosInstance] Validation failed for ${source}:`, diagnostics);
-        }
+        logger.debug(`Validation failed for ${source}`, diagnostics);
         throw new Error(`${source} returned invalid Axios client instance (hasGetMethod=${hasGetMethod}, hasDefaults=${hasDefaults})`);
     }
 }
@@ -53,7 +53,7 @@ export function resolveAttioClient() {
         const contextApiKey = getContextApiKey();
         const envApiKey = process.env.ATTIO_API_KEY;
         const resolvedApiKey = envApiKey || contextApiKey;
-        console.error('[client-resolver:resolve] API key resolution:', {
+        logger.debug('API key resolution', {
             hasEnvApiKey: Boolean(envApiKey),
             envKeyLength: envApiKey?.length || 0,
             hasContextApiKey: Boolean(contextApiKey),
@@ -75,18 +75,14 @@ export function resolveAttioClient() {
     // - API key resolution (env, context, config)
     // This is the proven code path used throughout the codebase
     if (typeof mod.getAttioClient === 'function') {
-        if (process.env.MCP_LOG_LEVEL === 'DEBUG') {
-            console.error('[client-resolver:resolve] Using getAttioClient()');
-        }
+        logger.debug('Using getAttioClient()');
         const client = mod.getAttioClient();
         assertAxiosInstance(client, 'getAttioClient()');
         return client;
     }
     // Fallback to createAttioClient with config object
     if (typeof mod.createAttioClient === 'function') {
-        if (process.env.MCP_LOG_LEVEL === 'DEBUG') {
-            console.error('[client-resolver:resolve] Fallback to createAttioClient(config)');
-        }
+        logger.debug('Fallback to createAttioClient(config)');
         try {
             const config = {};
             const client = mod.createAttioClient(config);
@@ -94,9 +90,7 @@ export function resolveAttioClient() {
             return client;
         }
         catch (error) {
-            if (process.env.MCP_LOG_LEVEL === 'DEBUG') {
-                console.error('[client-resolver:resolve] createAttioClient failed:', error);
-            }
+            logger.debug('createAttioClient failed', { error });
             // Continue to last resort
         }
     }
@@ -108,9 +102,7 @@ export function resolveAttioClient() {
         if (!resolvedApiKey) {
             throw new Error('Attio API key is required for client initialization. Please set ATTIO_API_KEY environment variable.');
         }
-        if (process.env.MCP_LOG_LEVEL === 'DEBUG') {
-            console.error('[client-resolver:resolve] Last resort: buildAttioClient');
-        }
+        logger.debug('Last resort: buildAttioClient');
         const client = mod.buildAttioClient({ apiKey: resolvedApiKey });
         assertAxiosInstance(client, 'buildAttioClient()');
         return client;

package/dist/utils/client-resolver.js.map

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

package/dist/utils/complex-type-validation.d.ts

@@ -0,0 +1,16 @@
+type UnknownRecord = Record<string, unknown>;
+/**
+ * Validates and normalizes a location value. Ensures an object shape and adds all 10 fields.
+ */
+export declare function validateLocationValue(value: unknown, fieldName: string): unknown;
+/**
+ * Validates and normalizes a personal-name value.
+ * Accepts string or object with first_name/last_name/full_name.
+ */
+export declare function validatePersonalNameValue(value: unknown, fieldName: string): UnknownRecord | null;
+/**
+ * Validates phone-number values. Ensures each entry has phone_number or original_phone_number.
+ */
+export declare function validatePhoneNumberValue(value: unknown, fieldName: string): unknown;
+export {};
+//# sourceMappingURL=complex-type-validation.d.ts.map