# vbondarevsky/connector architecture

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

- Interactive diagram: https://gitdiagram.com/vbondarevsky/connector
- Repository: https://github.com/vbondarevsky/connector

## Overview

Connector is a 1C:Enterprise HTTP client library. The documented workflow starts with a caller choosing an HTTP or JSON method, builds and encodes the request, sends it through HTTP, and exposes the response (including JSON deserialization). The README also documents sessions, authentication, compression, redirects, cookies, and retries. Source excerpts were not provided, so the map reflects documented capabilities and uses the shared module path rather than asserting internal implementation boundaries.

Main entry points: [`src/en/CommonModules/HTTPConnector/Ext/Module.bsl`](https://github.com/vbondarevsky/connector/blob/master/src/en/CommonModules/HTTPConnector/Ext/Module.bsl) (HTTP and JSON methods)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_request["Request preparation"]
  node_api["HTTP and JSON methods<br/>[Module.bsl]"]
  node_url["URL parameters<br/>[Module.bsl]"]
  node_body["Body encoding<br/>[Module.bsl]"]
  node_auth["Authentication<br/>[Module.bsl]"]
end

subgraph group_transport["HTTP transport"]
  node_session["Session state<br/>[Module.bsl]"]
  node_retry["Retry policy<br/>[Module.bsl]"]
  node_gzip["GZip support<br/>[Module.bsl]"]
  node_http(("HTTP server"))
  node_redirect["Redirect handling<br/>[Module.bsl]"]
  node_cookies["Cookie handling<br/>[Module.bsl]"]
end

subgraph group_response["Response handling"]
  node_response["Response processing<br/>[Module.bsl]"]
  node_json["JSON decoding<br/>[Module.bsl]"]
end

node_caller(("1C caller"))

node_caller -->|"calls"| node_api
node_api -->|"builds URL"| node_url
node_api -->|"encodes body"| node_body
node_api -->|"configures auth"| node_auth
node_api -->|"uses session"| node_session
node_api -->|"applies retries"| node_retry
node_api -->|"supports compression"| node_gzip
node_api -->|"sends request"| node_http
node_http -->|"returns redirect"| node_redirect
node_api -->|"resolves redirects"| node_redirect
node_api -->|"manages cookies"| node_cookies
node_http -->|"returns response"| node_response
node_api -->|"deserializes JSON"| node_json
node_response -->|"returns result"| node_caller

click node_api "https://github.com/vbondarevsky/connector/blob/master/src/en/CommonModules/HTTPConnector/Ext/Module.bsl"
click node_url "https://github.com/vbondarevsky/connector/blob/master/src/en/CommonModules/HTTPConnector/Ext/Module.bsl"
click node_body "https://github.com/vbondarevsky/connector/blob/master/src/en/CommonModules/HTTPConnector/Ext/Module.bsl"
click node_auth "https://github.com/vbondarevsky/connector/blob/master/src/en/CommonModules/HTTPConnector/Ext/Module.bsl"
click node_session "https://github.com/vbondarevsky/connector/blob/master/src/en/CommonModules/HTTPConnector/Ext/Module.bsl"
click node_retry "https://github.com/vbondarevsky/connector/blob/master/src/en/CommonModules/HTTPConnector/Ext/Module.bsl"
click node_gzip "https://github.com/vbondarevsky/connector/blob/master/src/en/CommonModules/HTTPConnector/Ext/Module.bsl"
click node_redirect "https://github.com/vbondarevsky/connector/blob/master/src/en/CommonModules/HTTPConnector/Ext/Module.bsl"
click node_cookies "https://github.com/vbondarevsky/connector/blob/master/src/en/CommonModules/HTTPConnector/Ext/Module.bsl"
click node_response "https://github.com/vbondarevsky/connector/blob/master/src/en/CommonModules/HTTPConnector/Ext/Module.bsl"
click node_json "https://github.com/vbondarevsky/connector/blob/master/src/en/CommonModules/HTTPConnector/Ext/Module.bsl"

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_api,node_url,node_body,node_auth toneBlue
class node_session,node_retry,node_gzip,node_http,node_redirect,node_cookies toneAmber
class node_response,node_json toneMint
class node_caller toneIndigo
```

## Components

### Request preparation

- [HTTP and JSON methods](https://github.com/vbondarevsky/connector/blob/master/src/en/CommonModules/HTTPConnector/Ext/Module.bsl): `src/en/CommonModules/HTTPConnector/Ext/Module.bsl`
- [URL parameters](https://github.com/vbondarevsky/connector/blob/master/src/en/CommonModules/HTTPConnector/Ext/Module.bsl): `src/en/CommonModules/HTTPConnector/Ext/Module.bsl`
- [Body encoding](https://github.com/vbondarevsky/connector/blob/master/src/en/CommonModules/HTTPConnector/Ext/Module.bsl): `src/en/CommonModules/HTTPConnector/Ext/Module.bsl`
- [Authentication](https://github.com/vbondarevsky/connector/blob/master/src/en/CommonModules/HTTPConnector/Ext/Module.bsl): `src/en/CommonModules/HTTPConnector/Ext/Module.bsl`

### HTTP transport

- [Session state](https://github.com/vbondarevsky/connector/blob/master/src/en/CommonModules/HTTPConnector/Ext/Module.bsl): `src/en/CommonModules/HTTPConnector/Ext/Module.bsl`
- [Retry policy](https://github.com/vbondarevsky/connector/blob/master/src/en/CommonModules/HTTPConnector/Ext/Module.bsl): `src/en/CommonModules/HTTPConnector/Ext/Module.bsl`
- [GZip support](https://github.com/vbondarevsky/connector/blob/master/src/en/CommonModules/HTTPConnector/Ext/Module.bsl): `src/en/CommonModules/HTTPConnector/Ext/Module.bsl`
- **HTTP server**
- [Redirect handling](https://github.com/vbondarevsky/connector/blob/master/src/en/CommonModules/HTTPConnector/Ext/Module.bsl): `src/en/CommonModules/HTTPConnector/Ext/Module.bsl`
- [Cookie handling](https://github.com/vbondarevsky/connector/blob/master/src/en/CommonModules/HTTPConnector/Ext/Module.bsl): `src/en/CommonModules/HTTPConnector/Ext/Module.bsl`

### Response handling

- [Response processing](https://github.com/vbondarevsky/connector/blob/master/src/en/CommonModules/HTTPConnector/Ext/Module.bsl): `src/en/CommonModules/HTTPConnector/Ext/Module.bsl`
- [JSON decoding](https://github.com/vbondarevsky/connector/blob/master/src/en/CommonModules/HTTPConnector/Ext/Module.bsl): `src/en/CommonModules/HTTPConnector/Ext/Module.bsl`

### Other components

- **1C caller**

## Connections

- 1C caller → HTTP and JSON methods: calls (evidence: `README.md`)
- HTTP and JSON methods → URL parameters: builds URL (evidence: `README.md`)
- HTTP and JSON methods → Body encoding: encodes body (evidence: `README.md`)
- HTTP and JSON methods → Authentication: configures auth (evidence: `README.md`)
- HTTP and JSON methods → Session state: uses session (evidence: `README.md`)
- HTTP and JSON methods → Retry policy: applies retries (evidence: `README.md`)
- HTTP and JSON methods → GZip support: supports compression (evidence: `README.md`)
- HTTP and JSON methods → HTTP server: sends request (evidence: `README.md`)
- HTTP server → Redirect handling: returns redirect (evidence: `README.md`)
- HTTP and JSON methods → Redirect handling: resolves redirects (evidence: `README.md`)
- HTTP and JSON methods → Cookie handling: manages cookies (evidence: `README.md`)
- HTTP server → Response processing: returns response (evidence: `README.md`)
- HTTP and JSON methods → JSON decoding: deserializes JSON (evidence: `README.md`)
- Response processing → 1C caller: returns result (evidence: `README.md`)
