# moooooo16/salesforce architecture

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

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

## Overview

This is a Python Salesforce REST API client. The principal workflow is to create a Salesforce facade with an authentication strategy, then use its domain services to query, search, inspect, or modify Salesforce data; the shared client authenticates and issues HTTP requests. The README is empty, so documented capabilities come from sampled code and the source index. Collection, event, info, and process services are represented from the tree and index, but their internal behavior was not sampled.

Main entry points: [`src/salesforce/salesforce.py`](https://github.com/moooooo16/salesforce/blob/main/src/salesforce/salesforce.py) (Salesforce facade), [`src/salesforce/client/client.py`](https://github.com/moooooo16/salesforce/blob/main/src/salesforce/client/client.py) (HTTP client), [`src/salesforce/client/auth.py`](https://github.com/moooooo16/salesforce/blob/main/src/salesforce/client/auth.py) (Auth strategies), [`src/salesforce/service/service.py`](https://github.com/moooooo16/salesforce/blob/main/src/salesforce/service/service.py) (Service base)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Client entry"]
  node_salesforce["Salesforce facade<br/>[salesforce.py]"]
end

subgraph group_auth["Authentication"]
  node_settings["API settings<br/>[config.py]"]
  node_authflow["Auth strategies<br/>[auth.py]"]
  node_session["Auth session<br/>[auth.py]"]
end

subgraph group_services["Domain services"]
  node_servicebase["Service base<br/>[service.py]"]
  node_query["SOQL queries<br/>[query.py]"]
  node_search["SOSL search<br/>[search.py]"]
  node_sobject["SObject CRUD<br/>[sobject.py]"]
  node_bulk["Bulk ingest<br/>[bulk.py]"]
  node_collection["Batch collections<br/>[collection.py]"]
  node_event["Event service<br/>[event.py]"]
  node_info["Org information<br/>[info.py]"]
  node_process["Process service<br/>[process.py]"]
end

subgraph group_transport["HTTP transport"]
  node_client["HTTP client<br/>[client.py]"]
  node_errors["API errors<br/>[exception.py]"]
end

node_user(("Library caller"))
node_salesforce_api["Salesforce REST API"]

node_user -->|"creates"| node_salesforce
node_salesforce -->|"creates"| node_client
node_salesforce -->|"provides"| node_query
node_salesforce -->|"provides"| node_bulk
node_salesforce -->|"provides"| node_collection
node_salesforce -->|"provides"| node_event
node_salesforce -->|"provides"| node_info
node_salesforce -->|"provides"| node_process
node_salesforce -->|"provides"| node_search
node_salesforce -->|"provides"| node_sobject
node_salesforce -->|"selects"| node_authflow
node_authflow -->|"loads"| node_settings
node_authflow -->|"requests token"| node_salesforce_api
node_authflow -->|"creates"| node_session
node_client -->|"authenticates"| node_authflow
node_client -->|"uses token"| node_session
node_client -->|"sends requests"| node_salesforce_api
node_client -->|"refreshes token"| node_authflow
node_servicebase -->|"delegates HTTP"| node_client
node_servicebase -->|"reads version"| node_settings
node_query -->|"fetches records"| node_client
node_search -->|"searches records"| node_client
node_sobject -->|"performs CRUD"| node_client
node_bulk -->|"runs ingest"| node_client
node_client -->|"raises API errors"| node_errors
node_authflow -->|"raises auth errors"| node_errors

click node_salesforce "https://github.com/moooooo16/salesforce/blob/main/src/salesforce/salesforce.py"
click node_settings "https://github.com/moooooo16/salesforce/blob/main/src/salesforce/config.py"
click node_authflow "https://github.com/moooooo16/salesforce/blob/main/src/salesforce/client/auth.py"
click node_session "https://github.com/moooooo16/salesforce/blob/main/src/salesforce/client/auth.py"
click node_servicebase "https://github.com/moooooo16/salesforce/blob/main/src/salesforce/service/service.py"
click node_query "https://github.com/moooooo16/salesforce/blob/main/src/salesforce/service/query.py"
click node_search "https://github.com/moooooo16/salesforce/blob/main/src/salesforce/service/search.py"
click node_sobject "https://github.com/moooooo16/salesforce/blob/main/src/salesforce/service/sobject.py"
click node_bulk "https://github.com/moooooo16/salesforce/blob/main/src/salesforce/service/bulk.py"
click node_collection "https://github.com/moooooo16/salesforce/blob/main/src/salesforce/service/collection.py"
click node_event "https://github.com/moooooo16/salesforce/blob/main/src/salesforce/service/event.py"
click node_info "https://github.com/moooooo16/salesforce/blob/main/src/salesforce/service/info.py"
click node_process "https://github.com/moooooo16/salesforce/blob/main/src/salesforce/service/process.py"
click node_client "https://github.com/moooooo16/salesforce/blob/main/src/salesforce/client/client.py"
click node_errors "https://github.com/moooooo16/salesforce/blob/main/src/salesforce/exception.py"

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_salesforce toneBlue
class node_settings,node_authflow,node_session toneAmber
class node_servicebase,node_query,node_search,node_sobject,node_bulk,node_collection,node_event,node_info,node_process,node_salesforce_api toneMint
class node_client,node_errors toneRose
class node_user toneIndigo
```

## Components

### Client entry

- [Salesforce facade](https://github.com/moooooo16/salesforce/blob/main/src/salesforce/salesforce.py): `src/salesforce/salesforce.py`

### Authentication

- [API settings](https://github.com/moooooo16/salesforce/blob/main/src/salesforce/config.py): `src/salesforce/config.py`
- [Auth strategies](https://github.com/moooooo16/salesforce/blob/main/src/salesforce/client/auth.py): `src/salesforce/client/auth.py`
- [Auth session](https://github.com/moooooo16/salesforce/blob/main/src/salesforce/client/auth.py): `src/salesforce/client/auth.py`

### Domain services

- [Service base](https://github.com/moooooo16/salesforce/blob/main/src/salesforce/service/service.py): `src/salesforce/service/service.py`
- [SOQL queries](https://github.com/moooooo16/salesforce/blob/main/src/salesforce/service/query.py): `src/salesforce/service/query.py`
- [SOSL search](https://github.com/moooooo16/salesforce/blob/main/src/salesforce/service/search.py): `src/salesforce/service/search.py`
- [SObject CRUD](https://github.com/moooooo16/salesforce/blob/main/src/salesforce/service/sobject.py): `src/salesforce/service/sobject.py`
- [Bulk ingest](https://github.com/moooooo16/salesforce/blob/main/src/salesforce/service/bulk.py): `src/salesforce/service/bulk.py`
- [Batch collections](https://github.com/moooooo16/salesforce/blob/main/src/salesforce/service/collection.py): `src/salesforce/service/collection.py`
- [Event service](https://github.com/moooooo16/salesforce/blob/main/src/salesforce/service/event.py): `src/salesforce/service/event.py`
- [Org information](https://github.com/moooooo16/salesforce/blob/main/src/salesforce/service/info.py): `src/salesforce/service/info.py`
- [Process service](https://github.com/moooooo16/salesforce/blob/main/src/salesforce/service/process.py): `src/salesforce/service/process.py`

### HTTP transport

- [HTTP client](https://github.com/moooooo16/salesforce/blob/main/src/salesforce/client/client.py): `src/salesforce/client/client.py`
- [API errors](https://github.com/moooooo16/salesforce/blob/main/src/salesforce/exception.py): `src/salesforce/exception.py`

### Other components

- **Library caller**
- **Salesforce REST API**

## Connections

- Library caller → Salesforce facade: creates (evidence: `src/salesforce/salesforce.py`)
- Salesforce facade → HTTP client: creates (evidence: `src/salesforce/salesforce.py`)
- Salesforce facade → SOQL queries: provides (evidence: `src/salesforce/salesforce.py`)
- Salesforce facade → Bulk ingest: provides (evidence: `src/salesforce/salesforce.py`)
- Salesforce facade → Batch collections: provides (evidence: `src/salesforce/salesforce.py`)
- Salesforce facade → Event service: provides (evidence: `src/salesforce/salesforce.py`)
- Salesforce facade → Org information: provides (evidence: `src/salesforce/salesforce.py`)
- Salesforce facade → Process service: provides (evidence: `src/salesforce/salesforce.py`)
- Salesforce facade → SOSL search: provides (evidence: `src/salesforce/salesforce.py`)
- Salesforce facade → SObject CRUD: provides (evidence: `src/salesforce/salesforce.py`)
- Salesforce facade → Auth strategies: selects (evidence: `src/salesforce/salesforce.py`)
- Auth strategies → API settings: loads (evidence: `src/salesforce/client/auth.py`)
- Auth strategies → Salesforce REST API: requests token (evidence: `src/salesforce/client/auth.py`)
- Auth strategies → Auth session: creates (evidence: `src/salesforce/client/auth.py`)
- HTTP client → Auth strategies: authenticates (evidence: `src/salesforce/client/client.py`)
- HTTP client → Auth session: uses token (evidence: `src/salesforce/client/client.py`)
- HTTP client → Salesforce REST API: sends requests (evidence: `src/salesforce/client/client.py`)
- HTTP client → Auth strategies: refreshes token (evidence: `src/salesforce/client/client.py`)
- Service base → HTTP client: delegates HTTP (evidence: `src/salesforce/service/service.py`)
- Service base → API settings: reads version (evidence: `src/salesforce/service/service.py`)
- SOQL queries → HTTP client: fetches records (evidence: `src/salesforce/service/query.py`)
- SOSL search → HTTP client: searches records (evidence: `src/salesforce/service/search.py`)
- SObject CRUD → HTTP client: performs CRUD (evidence: `src/salesforce/service/sobject.py`)
- Bulk ingest → HTTP client: runs ingest (evidence: `src/salesforce/service/bulk.py`)
- HTTP client → API errors: raises API errors (evidence: `src/salesforce/client/client.py`)
- Auth strategies → API errors: raises auth errors (evidence: `src/salesforce/client/auth.py`)
