twenty-migrate-espocrm 1.0.0

package/src/transform.ts

@@ -0,0 +1,261 @@
+import { EspoCRMData, EspoCRMContact, EspoCRMAccount, EspoCRMOpportunity, EspoCRMNote } from './extract';
+
+export interface TwentyPerson {
+  name?: {
+    firstName?: string;
+    lastName?: string;
+  };
+  email?: string;
+  phone?: string;
+  jobTitle?: string;
+  company?: string;
+  city?: string;
+  country?: string;
+  createdAt?: string;
+  updatedAt?: string;
+  source?: 'espocrm';
+  espocrmId?: string;
+}
+
+export interface TwentyCompany {
+  name?: string;
+  domainName?: string;
+  industry?: string;
+  description?: string;
+  phone?: string;
+  website?: string;
+  createdAt?: string;
+  updatedAt?: string;
+  source?: 'espocrm';
+  espocrmId?: string;
+}
+
+export interface TwentyOpportunity {
+  name?: string;
+  amount?: number;
+  closeDate?: string;
+  pipeline?: string;
+  stage?: string;
+  createdAt?: string;
+  updatedAt?: string;
+  source?: 'espocrm';
+  espocrmId?: string;
+  personId?: string;
+  companyId?: string;
+}
+
+export interface TwentyNote {
+  body?: string;
+  createdAt?: string;
+  updatedAt?: string;
+  source?: 'espocrm';
+  espocrmId?: string;
+  personId?: string;
+  companyId?: string;
+  opportunityId?: string;
+}
+
+export interface TransformedData {
+  people: TwentyPerson[];
+  companies: TwentyCompany[];
+  opportunities: TwentyOpportunity[];
+  notes: TwentyNote[];
+}
+
+export async function transformData(espocrmData: Partial<EspoCRMData>): Promise<TransformedData> {
+  const transformed: TransformedData = {
+    people: [],
+    companies: [],
+    opportunities: [],
+    notes: []
+  };
+
+  console.log('🔄 Transforming EspoCRM data to Twenty CRM format...');
+
+  // Transform contacts to people
+  if (espocrmData.contacts) {
+    console.log(`👥 Transforming ${espocrmData.contacts.length} contacts...`);
+    transformed.people = transformContactsToPeople(espocrmData.contacts);
+  }
+
+  // Transform accounts
+  if (espocrmData.accounts) {
+    console.log(`🏢 Transforming ${espocrmData.accounts.length} accounts...`);
+    transformed.companies = transformAccounts(espocrmData.accounts);
+  }
+
+  // Transform opportunities
+  if (espocrmData.opportunities) {
+    console.log(`💼 Transforming ${espocrmData.opportunities.length} opportunities...`);
+    transformed.opportunities = transformOpportunities(espocrmData.opportunities);
+  }
+
+  // Transform notes
+  if (espocrmData.notes) {
+    console.log(`📝 Transforming ${espocrmData.notes.length} notes...`);
+    transformed.notes = transformNotes(espocrmData.notes);
+  }
+
+  console.log('✅ Data transformation completed');
+  return transformed;
+}
+
+function transformContactsToPeople(contacts: EspoCRMContact[]): TwentyPerson[] {
+  return contacts.map(contact => {
+    const twentyPerson: TwentyPerson = {
+      source: 'espocrm',
+      espocrmId: contact.id,
+      createdAt: contact.createdAt,
+      updatedAt: contact.modifiedAt
+    };
+
+    // Transform name
+    if (contact.firstName || contact.lastName) {
+      twentyPerson.name = {
+        firstName: contact.firstName || '',
+        lastName: contact.lastName || ''
+      };
+    }
+
+    // Transform email
+    if (contact.email) {
+      twentyPerson.email = contact.email;
+    }
+
+    // Transform phone
+    if (contact.phone) {
+      twentyPerson.phone = contact.phone;
+    }
+
+    // Transform job title
+    if (contact.title) {
+      twentyPerson.jobTitle = contact.title;
+    }
+
+    // Link to account (stored as company reference)
+    if (contact.accountId) {
+      twentyPerson.company = contact.accountId;
+    }
+
+    return twentyPerson;
+  });
+}
+
+function transformAccounts(accounts: EspoCRMAccount[]): TwentyCompany[] {
+  return accounts.map(account => {
+    const twentyCompany: TwentyCompany = {
+      source: 'espocrm',
+      espocrmId: account.id,
+      createdAt: account.createdAt,
+      updatedAt: account.modifiedAt
+    };
+
+    // Transform name
+    if (account.name) {
+      twentyCompany.name = account.name;
+    }
+
+    // Transform website
+    if (account.website) {
+      twentyCompany.website = account.website;
+    }
+
+    // Transform industry
+    if (account.industry) {
+      twentyCompany.industry = account.industry;
+    }
+
+    // Transform description
+    if (account.description) {
+      twentyCompany.description = account.description;
+    }
+
+    // Transform phone
+    if (account.phone) {
+      twentyCompany.phone = account.phone;
+    }
+
+    return twentyCompany;
+  });
+}
+
+function transformOpportunities(opportunities: EspoCRMOpportunity[]): TwentyOpportunity[] {
+  return opportunities.map(opportunity => {
+    const twentyOpportunity: TwentyOpportunity = {
+      source: 'espocrm',
+      espocrmId: opportunity.id,
+      createdAt: opportunity.createdAt,
+      updatedAt: opportunity.modifiedAt
+    };
+
+    // Transform name
+    if (opportunity.name) {
+      twentyOpportunity.name = opportunity.name;
+    }
+
+    // Transform amount
+    if (opportunity.amount !== undefined && opportunity.amount !== null) {
+      twentyOpportunity.amount = opportunity.amount;
+    }
+
+    // Transform currency (store as pipeline for now)
+    if (opportunity.currency) {
+      twentyOpportunity.pipeline = opportunity.currency;
+    }
+
+    // Transform stage
+    if (opportunity.stage) {
+      twentyOpportunity.stage = opportunity.stage;
+    }
+
+    // Transform close date
+    if (opportunity.closeDate) {
+      twentyOpportunity.closeDate = opportunity.closeDate;
+    }
+
+    // Link to account
+    if (opportunity.accountId) {
+      twentyOpportunity.companyId = opportunity.accountId;
+    }
+
+    // Link to contact
+    if (opportunity.contactId) {
+      twentyOpportunity.personId = opportunity.contactId;
+    }
+
+    return twentyOpportunity;
+  });
+}
+
+function transformNotes(notes: EspoCRMNote[]): TwentyNote[] {
+  return notes.map(note => {
+    const twentyNote: TwentyNote = {
+      source: 'espocrm',
+      espocrmId: note.id,
+      createdAt: note.createdAt,
+      updatedAt: note.modifiedAt
+    };
+
+    // Transform note
+    if (note.note) {
+      twentyNote.body = note.note;
+    }
+
+    // Link to parent based on parentType
+    if (note.parentId && note.parentType) {
+      switch (note.parentType) {
+        case 'Contact':
+          twentyNote.personId = note.parentId;
+          break;
+        case 'Account':
+          twentyNote.companyId = note.parentId;
+          break;
+        case 'Opportunity':
+          twentyNote.opportunityId = note.parentId;
+          break;
+      }
+    }
+
+    return twentyNote;
+  });
+}

package/tsconfig.json

@@ -0,0 +1,39 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "commonjs",
+    "lib": ["ES2020"],
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "removeComments": false,
+    "noImplicitAny": true,
+    "strictNullChecks": true,
+    "strictFunctionTypes": true,
+    "noImplicitReturns": true,
+    "noFallthroughCasesInSwitch": true,
+    "moduleResolution": "node",
+    "baseUrl": "./",
+    "paths": {
+      "@/*": ["src/*"]
+    },
+    "allowSyntheticDefaultImports": true,
+    "experimentalDecorators": true,
+    "emitDecoratorMetadata": true
+  },
+  "include": [
+    "src/**/*"
+  ],
+  "exclude": [
+    "node_modules",
+    "dist",
+    "**/*.test.ts",
+    "**/*.spec.ts"
+  ]
+}