@iflow-mcp/attio-mcp 1.3.6

package/dist/services/create/extractor.js

@@ -0,0 +1,205 @@
+/**
+ * Shared extraction and normalization utilities for create services
+ *
+ * Extracted from MockService to be shared between AttioCreateService and MockCreateService
+ * without coupling to environment-specific logic.
+ */
+import { extractRecordId } from '../../utils/validation/uuid-validation.js';
+function isRecordLike(x) {
+    const rec = x;
+    return (!!rec &&
+        typeof rec === 'object' &&
+        rec.id &&
+        typeof rec.id.record_id === 'string');
+}
+function collectCandidates(src) {
+    const out = [];
+    if (src == null)
+        return out;
+    const source = src;
+    // Common axios/Attio envelopes
+    if (source.data)
+        out.push(source.data);
+    if (source.data?.data)
+        out.push(source.data.data);
+    if (source.data?.record)
+        out.push(source.data.record);
+    if (source.record)
+        out.push(source.record);
+    // Raw object as a candidate too
+    out.push(src);
+    // Arrays from bulk or list-like responses
+    const arrayish = [
+        Array.isArray(src) ? src : null,
+        Array.isArray(src?.data)
+            ? src.data
+            : null,
+        Array.isArray(src?.data?.records)
+            ? src.data.records
+            : null,
+        Array.isArray(src?.records)
+            ? src.records
+            : null,
+    ].filter(Boolean);
+    for (const arr of arrayish)
+        out.push(...arr);
+    return out;
+}
+/**
+ * Extract a single Attio record from any Attio/axios envelope.
+ * Returns null if we cannot find a record-like shape.
+ */
+export function extractAttioRecord(src) {
+    const candidates = collectCandidates(src);
+    // First try to find a complete record-like object
+    const rec = candidates.find(isRecordLike);
+    if (rec)
+        return rec;
+    // Fallback: try to adapt id formats for partial records
+    for (const candidate of candidates) {
+        if (candidate && typeof candidate === 'object') {
+            const c = candidate;
+            // id as string → adapt
+            if (typeof c.id === 'string') {
+                return { ...c, id: { record_id: c.id } };
+            }
+            // explicit record_id → adapt
+            if (typeof c.record_id === 'string' &&
+                (!c.id || typeof c.id !== 'object')) {
+                return { ...c, id: { record_id: c.record_id } };
+            }
+        }
+    }
+    // Last resort: try to salvage from headers (e.g., Location)
+    const loc = src?.headers
+        ?.location ||
+        src?.headers
+            ?.Location;
+    if (typeof loc === 'string') {
+        const rid = extractRecordId(loc);
+        if (rid)
+            return { id: { record_id: rid } };
+    }
+    return null;
+}
+/**
+ * Validates if a record looks like a successfully created Attio record
+ */
+export function looksLikeCreatedRecord(record) {
+    return isRecordLike(record);
+}
+/**
+ * Generates deterministic mock ID for consistency in testing
+ */
+export function generateMockId(prefix = '12345678-1234-4000') {
+    const timestamp = Date.now().toString().slice(-12);
+    return `${prefix}-${timestamp}`;
+}
+/**
+ * Throws if the object does not look like a freshly created record.
+ * Keeps error messages actionable for E2E.
+ */
+export function assertLooksLikeCreated(rec, where) {
+    if (!isRecordLike(rec)) {
+        const shape = rec && typeof rec === 'object' ? Object.keys(rec) : typeof rec;
+        // Keep as a normal Error to avoid extra wrapping here; creators add context
+        throw new Error(`invalid create result at ${where}; expected { id.record_id, values }, got: ${shape}`);
+    }
+}
+/**
+ * Debug utilities for development environments
+ */
+export function isTestRun() {
+    return process.env.E2E_MODE === 'true' || process.env.NODE_ENV === 'test';
+}
+export function debugRecordShape(record) {
+    return {
+        hasIdObj: !!record?.id?.record_id,
+        idType: typeof record?.id,
+        keys: Object.keys(record || {}),
+    };
+}
+// --- Output normalization: flatten Attio values into test-friendly shapes ---
+const SINGLETON_FIELDS = new Set([
+    'name',
+    'description',
+    'record_id',
+    'domains',
+]);
+const MULTI_VALUE_FIELDS = new Set([
+    // keep these as arrays of strings
+    'domains',
+    'categories',
+    'regions',
+    'team',
+    'associated_deals',
+    'associated_workspaces',
+    'services',
+    'notes',
+]);
+const DEFAULT_PREF = [
+    'value',
+    'text',
+    'name',
+    'email',
+    'domain',
+    'url',
+    'label',
+];
+function extractScalarFromObject(key, obj) {
+    if (!obj || typeof obj !== 'object')
+        return obj;
+    const o = obj;
+    const prefer = key === 'domains' ? ['domain', ...DEFAULT_PREF] : DEFAULT_PREF;
+    for (const k of prefer) {
+        const v = o[k];
+        if (typeof v === 'string' || typeof v === 'number')
+            return v;
+    }
+    return obj;
+}
+function normalizeField(key, val) {
+    if (Array.isArray(val)) {
+        const flat = val
+            .map((x) => extractScalarFromObject(key, x))
+            .filter((x) => x != null);
+        if (MULTI_VALUE_FIELDS.has(key)) {
+            // domains & co → array of strings
+            return flat;
+        }
+        if (SINGLETON_FIELDS.has(key)) {
+            // name/description/etc → single string
+            return flat[0] ?? null;
+        }
+        // Generic rule: collapse singletons unless it's a known multi-value field
+        return flat.length === 1 ? flat[0] : flat;
+    }
+    if (val && typeof val === 'object') {
+        return extractScalarFromObject(key, val);
+    }
+    return val;
+}
+function normalizeValuesObject(values, resourceType) {
+    if (!values || typeof values !== 'object')
+        return values;
+    const out = {};
+    for (const [k, v] of Object.entries(values)) {
+        // People records: keep `name` as Attio-style array entries
+        if (resourceType === 'people' && (k === 'name' || k === 'names')) {
+            // be defensive: guarantee array-of-objects shape
+            out[k] = Array.isArray(v) ? v : v == null ? [] : [{ value: String(v) }];
+            continue;
+        }
+        out[k] = normalizeField(k, v);
+    }
+    return out;
+}
+/** Public: normalize one Attio record to MCP/tool output (flatten values). */
+export function normalizeRecordForOutput(rec, resourceType) {
+    if (!rec || typeof rec !== 'object')
+        return rec;
+    const copy = { ...rec };
+    copy.values = normalizeValuesObject(rec.values, resourceType);
+    return copy;
+}
+//# sourceMappingURL=extractor.js.map

package/dist/services/create/extractor.js.map

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

package/dist/services/create/factory.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Create Service Factory
+ *
+ * Central factory for selecting between real API and mock implementations
+ * based on environment flags. Provides single point of service selection logic.
+ */
+import type { CreateService, CreateServiceFactory } from './types.js';
+/**
+ * Determines if mock data should be used based on environment flags
+ * Priority: E2E_MODE > explicit USE_MOCK_DATA > other test environments
+ */
+export declare function shouldUseMockData(): boolean;
+/**
+ * Gets the appropriate CreateService implementation based on environment
+ *
+ * @returns CreateService implementation (real API or mock)
+ * @throws Error if real API requested but no ATTIO_API_KEY available
+ */
+export declare function getCreateService(): CreateService;
+/**
+ * Factory implementation that can be used for dependency injection
+ */
+export declare class CreateServiceFactoryImpl implements CreateServiceFactory {
+    getCreateService(): CreateService;
+    shouldUseMockData(): boolean;
+}
+/**
+ * Default factory instance
+ */
+export declare const createServiceFactory: CreateServiceFactoryImpl;
+//# sourceMappingURL=factory.d.ts.map

package/dist/services/create/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../src/services/create/factory.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAKtE;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAyB3C;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,IAAI,aAAa,CAkBhD;AAED;;GAEG;AACH,qBAAa,wBAAyB,YAAW,oBAAoB;IACnE,gBAAgB,IAAI,aAAa;IAIjC,iBAAiB,IAAI,OAAO;CAG7B;AAED;;GAEG;AACH,eAAO,MAAM,oBAAoB,0BAAiC,CAAC"}

package/dist/services/create/factory.js

@@ -0,0 +1,73 @@
+/**
+ * Create Service Factory
+ *
+ * Central factory for selecting between real API and mock implementations
+ * based on environment flags. Provides single point of service selection logic.
+ */
+import { AttioCreateService } from './attio-create.service.js';
+import { MockCreateService } from './mock-create.service.js';
+import { debug } from '../../utils/logger.js';
+/**
+ * Determines if mock data should be used based on environment flags
+ * Priority: E2E_MODE > explicit USE_MOCK_DATA > other test environments
+ */
+export function shouldUseMockData() {
+    // Respect explicit USE_MOCK_DATA first
+    if (process.env.USE_MOCK_DATA === 'true')
+        return true;
+    if (process.env.USE_MOCK_DATA === 'false')
+        return false;
+    // E2E policy: do NOT auto-mock when E2E_MODE=true
+    if (process.env.E2E_MODE === 'true')
+        return false;
+    // Offline/perf/unit tests (NODE_ENV=test) use mocks by default
+    const result = process.env.OFFLINE_MODE === 'true' ||
+        process.env.PERFORMANCE_TEST === 'true' ||
+        process.env.NODE_ENV === 'test';
+    // Debug logging for service selection transparency
+    debug('CreateServiceFactory', 'Environment detection', {
+        result,
+        USE_MOCK_DATA: process.env.USE_MOCK_DATA,
+        OFFLINE_MODE: process.env.OFFLINE_MODE,
+        PERFORMANCE_TEST: process.env.PERFORMANCE_TEST,
+        E2E_MODE: process.env.E2E_MODE,
+        NODE_ENV: process.env.NODE_ENV,
+    });
+    return result;
+}
+/**
+ * Gets the appropriate CreateService implementation based on environment
+ *
+ * @returns CreateService implementation (real API or mock)
+ * @throws Error if real API requested but no ATTIO_API_KEY available
+ */
+export function getCreateService() {
+    const useMocks = shouldUseMockData();
+    if (useMocks) {
+        debug('CreateServiceFactory', 'Selected MockCreateService');
+        return new MockCreateService();
+    }
+    // Fail fast if real API requested but no credentials available
+    // Issue #928: Support both ATTIO_API_KEY and ATTIO_ACCESS_TOKEN (OAuth alternative)
+    if (!process.env.ATTIO_API_KEY && !process.env.ATTIO_ACCESS_TOKEN) {
+        throw new Error('ATTIO_API_KEY is required for real API calls. Set USE_MOCK_DATA=true to use mock data instead.');
+    }
+    debug('CreateServiceFactory', 'Selected AttioCreateService');
+    return new AttioCreateService();
+}
+/**
+ * Factory implementation that can be used for dependency injection
+ */
+export class CreateServiceFactoryImpl {
+    getCreateService() {
+        return getCreateService();
+    }
+    shouldUseMockData() {
+        return shouldUseMockData();
+    }
+}
+/**
+ * Default factory instance
+ */
+export const createServiceFactory = new CreateServiceFactoryImpl();
+//# sourceMappingURL=factory.js.map

package/dist/services/create/factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../../src/services/create/factory.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAE9C;;;GAGG;AACH,MAAM,UAAU,iBAAiB;IAC/B,uCAAuC;IACvC,IAAI,OAAO,CAAC,GAAG,CAAC,aAAa,KAAK,MAAM;QAAE,OAAO,IAAI,CAAC;IACtD,IAAI,OAAO,CAAC,GAAG,CAAC,aAAa,KAAK,OAAO;QAAE,OAAO,KAAK,CAAC;IAExD,kDAAkD;IAClD,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,MAAM;QAAE,OAAO,KAAK,CAAC;IAElD,+DAA+D;IAC/D,MAAM,MAAM,GACV,OAAO,CAAC,GAAG,CAAC,YAAY,KAAK,MAAM;QACnC,OAAO,CAAC,GAAG,CAAC,gBAAgB,KAAK,MAAM;QACvC,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,MAAM,CAAC;IAElC,mDAAmD;IACnD,KAAK,CAAC,sBAAsB,EAAE,uBAAuB,EAAE;QACrD,MAAM;QACN,aAAa,EAAE,OAAO,CAAC,GAAG,CAAC,aAAa;QACxC,YAAY,EAAE,OAAO,CAAC,GAAG,CAAC,YAAY;QACtC,gBAAgB,EAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB;QAC9C,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,QAAQ;QAC9B,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,QAAQ;KAC/B,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB;IAC9B,MAAM,QAAQ,GAAG,iBAAiB,EAAE,CAAC;IAErC,IAAI,QAAQ,EAAE,CAAC;QACb,KAAK,CAAC,sBAAsB,EAAE,4BAA4B,CAAC,CAAC;QAC5D,OAAO,IAAI,iBAAiB,EAAE,CAAC;IACjC,CAAC;IAED,+DAA+D;IAC/D,oFAAoF;IACpF,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,EAAE,CAAC;QAClE,MAAM,IAAI,KAAK,CACb,gGAAgG,CACjG,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,sBAAsB,EAAE,6BAA6B,CAAC,CAAC;IAC7D,OAAO,IAAI,kBAAkB,EAAE,CAAC;AAClC,CAAC;AAED;;GAEG;AACH,MAAM,OAAO,wBAAwB;IACnC,gBAAgB;QACd,OAAO,gBAAgB,EAAE,CAAC;IAC5B,CAAC;IAED,iBAAiB;QACf,OAAO,iBAAiB,EAAE,CAAC;IAC7B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAI,wBAAwB,EAAE,CAAC"}

package/dist/services/create/helpers/ErrorHelpers.d.ts

@@ -0,0 +1,27 @@
+import { UniversalValidationError } from '../../../handlers/tool-configs/universal/schemas.js';
+export declare enum ErrorCategory {
+    VALIDATION = "VALIDATION",
+    AUTHENTICATION = "AUTHENTICATION",
+    PERMISSION = "PERMISSION",
+    NETWORK = "NETWORK",
+    RATE_LIMIT = "RATE_LIMIT",
+    DATA_INTEGRITY = "DATA_INTEGRITY",
+    EXTERNAL_SERVICE = "EXTERNAL_SERVICE",
+    CONFIGURATION = "CONFIGURATION"
+}
+export interface EnhancedErrorDetails {
+    category?: ErrorCategory;
+    field?: string;
+    expectedType?: string;
+    receivedType?: string;
+    expectedValue?: unknown;
+    receivedValue?: unknown;
+    suggestion?: string;
+    remediation?: string[];
+    relatedFields?: string[];
+    errorCode?: string;
+}
+export declare function createEnhancedValidationError(message: string, details: Partial<EnhancedErrorDetails>): UniversalValidationError;
+export declare function createFieldTypeError(field: string, expectedType: string, receivedValue: unknown): UniversalValidationError;
+export declare function createFieldCollisionError(collidingFields: string[], targetField: string): UniversalValidationError;
+//# sourceMappingURL=ErrorHelpers.d.ts.map

package/dist/services/create/helpers/ErrorHelpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ErrorHelpers.d.ts","sourceRoot":"","sources":["../../../../src/services/create/helpers/ErrorHelpers.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EAEzB,MAAM,qDAAqD,CAAC;AAG7D,oBAAY,aAAa;IACvB,UAAU,eAAe;IACzB,cAAc,mBAAmB;IACjC,UAAU,eAAe;IACzB,OAAO,YAAY;IACnB,UAAU,eAAe;IACzB,cAAc,mBAAmB;IACjC,gBAAgB,qBAAqB;IACrC,aAAa,kBAAkB;CAChC;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,OAAO,CAAC,oBAAoB,CAAC,GACrC,wBAAwB,CAI1B;AAED,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,MAAM,EACb,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE,OAAO,GACrB,wBAAwB,CAc1B;AAED,wBAAgB,yBAAyB,CACvC,eAAe,EAAE,MAAM,EAAE,EACzB,WAAW,EAAE,MAAM,GAClB,wBAAwB,CAO1B"}

package/dist/services/create/helpers/ErrorHelpers.js

@@ -0,0 +1,37 @@
+import { UniversalValidationError, ErrorType, } from '../../../handlers/tool-configs/universal/schemas.js';
+import { ERROR_MESSAGES } from '../../../constants/universal.constants.js';
+export var ErrorCategory;
+(function (ErrorCategory) {
+    ErrorCategory["VALIDATION"] = "VALIDATION";
+    ErrorCategory["AUTHENTICATION"] = "AUTHENTICATION";
+    ErrorCategory["PERMISSION"] = "PERMISSION";
+    ErrorCategory["NETWORK"] = "NETWORK";
+    ErrorCategory["RATE_LIMIT"] = "RATE_LIMIT";
+    ErrorCategory["DATA_INTEGRITY"] = "DATA_INTEGRITY";
+    ErrorCategory["EXTERNAL_SERVICE"] = "EXTERNAL_SERVICE";
+    ErrorCategory["CONFIGURATION"] = "CONFIGURATION";
+})(ErrorCategory || (ErrorCategory = {}));
+export function createEnhancedValidationError(message, details) {
+    return new UniversalValidationError(message, ErrorType.USER_ERROR, {
+        ...details,
+    });
+}
+export function createFieldTypeError(field, expectedType, receivedValue) {
+    const receivedType = typeof receivedValue;
+    const message = ERROR_MESSAGES.INVALID_FIELD_TYPE(field, expectedType, receivedType);
+    return createEnhancedValidationError(message, {
+        field,
+        expectedType,
+        receivedType,
+        errorCode: 'FIELD_TYPE_MISMATCH',
+    });
+}
+export function createFieldCollisionError(collidingFields, targetField) {
+    const message = ERROR_MESSAGES.FIELD_COLLISION(collidingFields, targetField);
+    return createEnhancedValidationError(message, {
+        field: targetField,
+        errorCode: 'FIELD_COLLISION',
+        relatedFields: collidingFields,
+    });
+}
+//# sourceMappingURL=ErrorHelpers.js.map

package/dist/services/create/helpers/ErrorHelpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ErrorHelpers.js","sourceRoot":"","sources":["../../../../src/services/create/helpers/ErrorHelpers.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,SAAS,GACV,MAAM,qDAAqD,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,2CAA2C,CAAC;AAE3E,MAAM,CAAN,IAAY,aASX;AATD,WAAY,aAAa;IACvB,0CAAyB,CAAA;IACzB,kDAAiC,CAAA;IACjC,0CAAyB,CAAA;IACzB,oCAAmB,CAAA;IACnB,0CAAyB,CAAA;IACzB,kDAAiC,CAAA;IACjC,sDAAqC,CAAA;IACrC,gDAA+B,CAAA;AACjC,CAAC,EATW,aAAa,KAAb,aAAa,QASxB;AAeD,MAAM,UAAU,6BAA6B,CAC3C,OAAe,EACf,OAAsC;IAEtC,OAAO,IAAI,wBAAwB,CAAC,OAAO,EAAE,SAAS,CAAC,UAAU,EAAE;QACjE,GAAG,OAAO;KACX,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,KAAa,EACb,YAAoB,EACpB,aAAsB;IAEtB,MAAM,YAAY,GAAG,OAAO,aAAa,CAAC;IAC1C,MAAM,OAAO,GAAG,cAAc,CAAC,kBAAkB,CAC/C,KAAK,EACL,YAAY,EACZ,YAAY,CACb,CAAC;IAEF,OAAO,6BAA6B,CAAC,OAAO,EAAE;QAC5C,KAAK;QACL,YAAY;QACZ,YAAY;QACZ,SAAS,EAAE,qBAAqB;KACjC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,yBAAyB,CACvC,eAAyB,EACzB,WAAmB;IAEnB,MAAM,OAAO,GAAG,cAAc,CAAC,eAAe,CAAC,eAAe,EAAE,WAAW,CAAC,CAAC;IAC7E,OAAO,6BAA6B,CAAC,OAAO,EAAE;QAC5C,KAAK,EAAE,WAAW;QAClB,SAAS,EAAE,iBAAiB;QAC5B,aAAa,EAAE,eAAe;KAC/B,CAAC,CAAC;AACL,CAAC"}

package/dist/services/create/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Create Services Module
+ *
+ * Clean exports for the create services architecture.
+ * Primary entry point for consuming create functionality.
+ */
+export { getCreateService, shouldUseMockData, createServiceFactory, } from './factory.js';
+export type { CreateService, CreateServiceFactory, EnvironmentDetector, } from './types.js';
+export { AttioCreateService } from './attio-create.service.js';
+export { MockCreateService } from './mock-create.service.js';
+export { extractAttioRecord, looksLikeCreatedRecord, generateMockId, assertLooksLikeCreated, isTestRun, debugRecordShape, } from './extractor.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/services/create/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/services/create/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,cAAc,CAAC;AAGtB,YAAY,EACV,aAAa,EACb,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAG7D,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,cAAc,EACd,sBAAsB,EACtB,SAAS,EACT,gBAAgB,GACjB,MAAM,gBAAgB,CAAC"}

package/dist/services/create/index.js

@@ -0,0 +1,14 @@
+/**
+ * Create Services Module
+ *
+ * Clean exports for the create services architecture.
+ * Primary entry point for consuming create functionality.
+ */
+// Main factory and service selection
+export { getCreateService, shouldUseMockData, createServiceFactory, } from './factory.js';
+// Individual service implementations (for testing and special cases)
+export { AttioCreateService } from './attio-create.service.js';
+export { MockCreateService } from './mock-create.service.js';
+// Shared utilities
+export { extractAttioRecord, looksLikeCreatedRecord, generateMockId, assertLooksLikeCreated, isTestRun, debugRecordShape, } from './extractor.js';
+//# sourceMappingURL=index.js.map

package/dist/services/create/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/services/create/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,qCAAqC;AACrC,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,cAAc,CAAC;AAStB,qEAAqE;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D,mBAAmB;AACnB,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,cAAc,EACd,sBAAsB,EACtB,SAAS,EACT,gBAAgB,GACjB,MAAM,gBAAgB,CAAC"}

package/dist/services/create/mock-create.service.d.ts

@@ -0,0 +1,30 @@
+/**
+ * MockCreateService - Pure mock implementation
+ *
+ * Pure mock implementation with no API calls or environment checks.
+ * Generates synthetic data for testing environments.
+ */
+import type { CreateService } from './types.js';
+import type { AttioRecord } from '../../types/attio.js';
+/**
+ * Pure mock implementation of CreateService
+ */
+export declare class MockCreateService implements CreateService {
+    createCompany(input: Record<string, unknown>): Promise<AttioRecord>;
+    createPerson(input: Record<string, unknown>): Promise<AttioRecord>;
+    createTask(input: Record<string, unknown>): Promise<AttioRecord>;
+    updateTask(taskId: string, updateData: Record<string, unknown>): Promise<AttioRecord>;
+    createNote(noteData: {
+        resource_type: string;
+        record_id: string;
+        title: string;
+        content: string;
+        format?: string;
+    }): Promise<Record<string, unknown>>;
+    listNotes(): Promise<Record<string, unknown>[]>;
+    /**
+     * Apply consistent E2E test markers to mock data
+     */
+    private applyE2EMarkers;
+}
+//# sourceMappingURL=mock-create.service.d.ts.map

package/dist/services/create/mock-create.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-create.service.d.ts","sourceRoot":"","sources":["../../../src/services/create/mock-create.service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAMxD;;GAEG;AACH,qBAAa,iBAAkB,YAAW,aAAa;IAC/C,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC;IAyBnE,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC;IAuBlE,UAAU,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC;IAsGhE,UAAU,CACd,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAClC,OAAO,CAAC,WAAW,CAAC;IAuGjB,UAAU,CAAC,QAAQ,EAAE;QACzB,aAAa,EAAE,MAAM,CAAC;QACtB,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IA+D9B,SAAS,IAGR,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IAOzC;;OAEG;IACH,OAAO,CAAC,eAAe;CAkBxB"}