# akutishevsky/salesforce-migrator architecture

> Architecture diagram of the GitHub repository akutishevsky/salesforce-migrator, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/akutishevsky/salesforce-migrator
- Repository: https://github.com/akutishevsky/salesforce-migrator

## Overview

Salesforce Migrator is a VS Code extension for moving Salesforce metadata and records between authorized orgs. The user selects source and target orgs, then follows either the metadata path (browse and select components, retrieve/deploy) or the records path (choose objects and fields, export or perform DML). The extension views orchestrate services, Salesforce CLI commands, and REST/Bulk API clients. The README documents capabilities such as folder-based metadata, SOQL, progress, cancellation, and job monitoring; several of these details are not visible in the sampled excerpts, so only documented or indexed relationships are shown.

Main entry points: [`src/webviews/RecordsMigrationExport.ts`](https://github.com/akutishevsky/salesforce-migrator/blob/main/src/webviews/RecordsMigrationExport.ts) (Record Export), [`src/webviews/RecordsMigrationDml.ts`](https://github.com/akutishevsky/salesforce-migrator/blob/main/src/webviews/RecordsMigrationDml.ts) (Record DML), [`src/services/HtmlService.ts`](https://github.com/akutishevsky/salesforce-migrator/blob/main/src/services/HtmlService.ts) (Webview HTML), [`src/extension.ts`](https://github.com/akutishevsky/salesforce-migrator/blob/main/src/extension.ts) (Extension Entry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_extension["Extension and Orgs"]
  node_entry["Extension Entry<br/>[extension.ts]"]
  node_orgview["Org Selector<br/>[OrgSelectorView.ts]"]
  node_orgservice["Org Service<br/>[OrgService.ts]"]
end

subgraph group_metadata["Metadata Migration"]
  node_metaselector["Metadata Browser"]
  node_metaselection["Selected Metadata"]
  node_metaservice["Metadata Catalog<br/>[MetadataService.ts]"]
  node_deployment["Deployment Webview"]
end

subgraph group_records["Records Migration"]
  node_recordselector["Object Selector"]
  node_objectservice["Object Catalog<br/>[ObjectService.ts]"]
  node_export["Record Export"]
  node_dml["Record DML"]
end

subgraph group_integrations["Services and APIs"]
  node_html["Webview HTML<br/>[HtmlService.ts]"]
  node_commands["Salesforce CLI"]
  node_rest["Salesforce REST<br/>[SfRestApi.ts]"]
  node_bulk["Bulk API 2.0<br/>[SfBulkApi.ts]"]
end

node_vscode(("VS Code User"))
node_salesforce{{"Salesforce Org"}}

node_vscode -->|"activates extension"| node_entry
node_entry -->|"registers views"| node_orgview
node_entry -->|"registers views"| node_metaselector
node_entry -->|"registers views"| node_metaselection
node_entry -->|"registers views"| node_recordselector
node_orgview -->|"fetches orgs"| node_orgservice
node_orgservice -->|"runs CLI"| node_commands
node_metaselector -->|"lists metadata"| node_metaservice
node_metaselector -->|"updates selection"| node_metaselection
node_metaselector -->|"opens deployment"| node_deployment
node_metaservice -->|"runs CLI"| node_commands
node_deployment -->|"uses metadata service"| node_metaservice
node_deployment -->|"gets org details"| node_orgservice
node_recordselector -->|"lists objects"| node_objectservice
node_objectservice -->|"runs CLI"| node_commands
node_recordselector -->|"opens export"| node_export
node_recordselector -->|"opens DML"| node_dml
node_export -->|"opens with file"| node_dml
node_export -->|"runs bulk query"| node_bulk
node_export -->|"uses REST API"| node_rest
node_export -->|"gets org details"| node_orgservice
node_dml -->|"runs bulk DML"| node_bulk
node_dml -->|"describes objects"| node_rest
node_dml -->|"gets org details"| node_orgservice
node_orgview -->|"composes view"| node_html
node_metaselector -->|"composes view"| node_html
node_deployment -->|"composes view"| node_html
node_recordselector -->|"composes view"| node_html
node_export -->|"composes view"| node_html
node_dml -->|"composes view"| node_html
node_commands -->|"invokes Salesforce CLI"| node_salesforce
node_rest -->|"sends REST requests"| node_salesforce
node_bulk -->|"sends bulk requests"| node_salesforce

click node_entry "https://github.com/akutishevsky/salesforce-migrator/blob/main/src/extension.ts"
click node_orgview "https://github.com/akutishevsky/salesforce-migrator/blob/main/src/views/OrgSelectorView.ts"
click node_orgservice "https://github.com/akutishevsky/salesforce-migrator/blob/main/src/services/OrgService.ts"
click node_metaselector "https://github.com/akutishevsky/salesforce-migrator/blob/main/src/views/MetadataSelectorView.ts"
click node_metaselection "https://github.com/akutishevsky/salesforce-migrator/blob/main/src/views/MetadataSelectionView.ts"
click node_metaservice "https://github.com/akutishevsky/salesforce-migrator/blob/main/src/services/MetadataService.ts"
click node_deployment "https://github.com/akutishevsky/salesforce-migrator/blob/main/src/webviews/MetadataDeploymentWebview.ts"
click node_recordselector "https://github.com/akutishevsky/salesforce-migrator/blob/main/src/views/RecordsSelectorView.ts"
click node_objectservice "https://github.com/akutishevsky/salesforce-migrator/blob/main/src/services/ObjectService.ts"
click node_export "https://github.com/akutishevsky/salesforce-migrator/blob/main/src/webviews/RecordsMigrationExport.ts"
click node_dml "https://github.com/akutishevsky/salesforce-migrator/blob/main/src/webviews/RecordsMigrationDml.ts"
click node_html "https://github.com/akutishevsky/salesforce-migrator/blob/main/src/services/HtmlService.ts"
click node_commands "https://github.com/akutishevsky/salesforce-migrator/blob/main/src/services/SfCommandService.ts"
click node_rest "https://github.com/akutishevsky/salesforce-migrator/blob/main/src/api/SfRestApi.ts"
click node_bulk "https://github.com/akutishevsky/salesforce-migrator/blob/main/src/api/SfBulkApi.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_entry,node_orgview,node_orgservice,node_vscode toneBlue
class node_metaselector,node_metaselection,node_metaservice,node_deployment toneAmber
class node_recordselector,node_objectservice,node_export,node_dml toneMint
class node_html,node_commands,node_rest,node_bulk toneRose
class node_salesforce toneIndigo
```

## Components

### Extension and Orgs

- [Extension Entry](https://github.com/akutishevsky/salesforce-migrator/blob/main/src/extension.ts): `src/extension.ts`
- [Org Selector](https://github.com/akutishevsky/salesforce-migrator/blob/main/src/views/OrgSelectorView.ts): `src/views/OrgSelectorView.ts`
- [Org Service](https://github.com/akutishevsky/salesforce-migrator/blob/main/src/services/OrgService.ts): `src/services/OrgService.ts`

### Metadata Migration

- [Metadata Browser](https://github.com/akutishevsky/salesforce-migrator/blob/main/src/views/MetadataSelectorView.ts): `src/views/MetadataSelectorView.ts`
- [Selected Metadata](https://github.com/akutishevsky/salesforce-migrator/blob/main/src/views/MetadataSelectionView.ts): `src/views/MetadataSelectionView.ts`
- [Metadata Catalog](https://github.com/akutishevsky/salesforce-migrator/blob/main/src/services/MetadataService.ts): `src/services/MetadataService.ts`
- [Deployment Webview](https://github.com/akutishevsky/salesforce-migrator/blob/main/src/webviews/MetadataDeploymentWebview.ts): `src/webviews/MetadataDeploymentWebview.ts`

### Records Migration

- [Object Selector](https://github.com/akutishevsky/salesforce-migrator/blob/main/src/views/RecordsSelectorView.ts): `src/views/RecordsSelectorView.ts`
- [Object Catalog](https://github.com/akutishevsky/salesforce-migrator/blob/main/src/services/ObjectService.ts): `src/services/ObjectService.ts`
- [Record Export](https://github.com/akutishevsky/salesforce-migrator/blob/main/src/webviews/RecordsMigrationExport.ts): `src/webviews/RecordsMigrationExport.ts`
- [Record DML](https://github.com/akutishevsky/salesforce-migrator/blob/main/src/webviews/RecordsMigrationDml.ts): `src/webviews/RecordsMigrationDml.ts`

### Services and APIs

- [Webview HTML](https://github.com/akutishevsky/salesforce-migrator/blob/main/src/services/HtmlService.ts): `src/services/HtmlService.ts`
- [Salesforce CLI](https://github.com/akutishevsky/salesforce-migrator/blob/main/src/services/SfCommandService.ts): `src/services/SfCommandService.ts`
- [Salesforce REST](https://github.com/akutishevsky/salesforce-migrator/blob/main/src/api/SfRestApi.ts): `src/api/SfRestApi.ts`
- [Bulk API 2.0](https://github.com/akutishevsky/salesforce-migrator/blob/main/src/api/SfBulkApi.ts): `src/api/SfBulkApi.ts`

### Other components

- **VS Code User**
- **Salesforce Org**

## Connections

- VS Code User → Extension Entry: activates extension (evidence: `src/extension.ts`)
- Extension Entry → Org Selector: registers views (evidence: `src/extension.ts`)
- Extension Entry → Metadata Browser: registers views (evidence: `src/extension.ts`)
- Extension Entry → Selected Metadata: registers views (evidence: `src/extension.ts`)
- Extension Entry → Object Selector: registers views (evidence: `src/extension.ts`)
- Org Selector → Org Service: fetches orgs (evidence: `src/views/OrgSelectorView.ts`)
- Org Service → Salesforce CLI: runs CLI (evidence: `src/services/OrgService.ts`)
- Metadata Browser → Metadata Catalog: lists metadata (evidence: `src/views/MetadataSelectorView.ts`)
- Metadata Browser → Selected Metadata: updates selection (evidence: `src/views/MetadataSelectorView.ts`)
- Metadata Browser → Deployment Webview: opens deployment (evidence: `src/views/MetadataSelectorView.ts`)
- Metadata Catalog → Salesforce CLI: runs CLI (evidence: `src/services/MetadataService.ts`)
- Deployment Webview → Metadata Catalog: uses metadata service (evidence: `src/webviews/MetadataDeploymentWebview.ts`)
- Deployment Webview → Org Service: gets org details (evidence: `src/webviews/MetadataDeploymentWebview.ts`)
- Object Selector → Object Catalog: lists objects (evidence: `src/views/RecordsSelectorView.ts`)
- Object Catalog → Salesforce CLI: runs CLI (evidence: `src/services/ObjectService.ts`)
- Object Selector → Record Export: opens export (evidence: `src/views/RecordsSelectorView.ts`)
- Object Selector → Record DML: opens DML (evidence: `src/views/RecordsSelectorView.ts`)
- Record Export → Record DML: opens with file (evidence: `src/webviews/RecordsMigrationExport.ts`)
- Record Export → Bulk API 2.0: runs bulk query (evidence: `src/webviews/RecordsMigrationExport.ts`)
- Record Export → Salesforce REST: uses REST API (evidence: `src/webviews/RecordsMigrationExport.ts`)
- Record Export → Org Service: gets org details (evidence: `src/webviews/RecordsMigrationExport.ts`)
- Record DML → Bulk API 2.0: runs bulk DML (evidence: `src/webviews/RecordsMigrationDml.ts`)
- Record DML → Salesforce REST: describes objects (evidence: `src/webviews/RecordsMigrationDml.ts`)
- Record DML → Org Service: gets org details (evidence: `src/webviews/RecordsMigrationDml.ts`)
- Org Selector → Webview HTML: composes view (evidence: `src/views/OrgSelectorView.ts`)
- Metadata Browser → Webview HTML: composes view (evidence: `src/views/MetadataSelectorView.ts`)
- Deployment Webview → Webview HTML: composes view (evidence: `src/webviews/MetadataDeploymentWebview.ts`)
- Object Selector → Webview HTML: composes view (evidence: `src/views/RecordsSelectorView.ts`)
- Record Export → Webview HTML: composes view (evidence: `src/webviews/RecordsMigrationExport.ts`)
- Record DML → Webview HTML: composes view (evidence: `src/webviews/RecordsMigrationDml.ts`)
- Salesforce CLI → Salesforce Org: invokes Salesforce CLI (evidence: `src/services/SfCommandService.ts`)
- Salesforce REST → Salesforce Org: sends REST requests (evidence: `src/api/SfRestApi.ts`)
- Bulk API 2.0 → Salesforce Org: sends bulk requests (evidence: `src/api/SfBulkApi.ts`)
