# idevscode/networking-library_ios architecture

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

- Interactive diagram: https://gitdiagram.com/idevscode/networking-library_ios
- Repository: https://github.com/idevscode/networking-library_ios

## Overview

This is a Swift SafeCircle client/data library covering authentication and session state, profile and guardian management, live journeys, risk detection, consent, and push registration. The typical workflow is a client-driven use case, a repository implementation that builds network requests and maps responses into domain entities, and an HTTP or WebSocket service; profile data may also be cached locally. The excerpts confirm authentication, profile/guardian, token, and HTTP behavior. Several other product branches are present in the tree but their runtime wiring was not sampled, so those links are marked unverified rather than inferred as definite calls.

Main entry points: [`Sources/Data/Networking/NetworkClient.swift`](https://github.com/idevscode/networking-library_ios/blob/main/Sources/Data/Networking/NetworkClient.swift) (HTTP client), [`Sources/Data/Repositories/MainRepositoryImpl.swift`](https://github.com/idevscode/networking-library_ios/blob/main/Sources/Data/Repositories/MainRepositoryImpl.swift) (People repository), [`Sources/Data/Repositories/AuthRepoImpl.swift`](https://github.com/idevscode/networking-library_ios/blob/main/Sources/Data/Repositories/AuthRepoImpl.swift) (Authentication repository), [`Sources/Data/Repositories/JourneyRepoImpl.swift`](https://github.com/idevscode/networking-library_ios/blob/main/Sources/Data/Repositories/JourneyRepoImpl.swift) (Journey repository)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_auth["Authentication"]
  node_session["Session orchestration"]
  node_authapi["Authentication contract"]
  node_authimpl["Authentication repository<br/>[AuthRepoImpl.swift]"]
  node_authflow["OTP flow"]
end

subgraph group_people["Profile and guardians"]
  node_profileuse["Profile use case"]
  node_mainapi["People repository contract"]
  node_mainimpl["People repository"]
  node_guardianflows["Guardian workflows"]
  node_usercache[("User preferences")]
end

subgraph group_journeys["Journey safety"]
  node_journeyflows["Journey workflows"]
  node_journeyrepo["Journey repository"]
  node_journeytypes["Journey entities"]
  node_journeydto["Journey response mapping<br/>[JourneyDTO.swift]"]
  node_socketclient["Live journey socket"]
  node_riskflows["Risk detection"]
end

subgraph group_platform["Data and integrations"]
  node_consentflows["Consent management"]
  node_pushflows["Push registration"]
  node_network["HTTP client"]
  node_requests["Request definitions"]
  node_dtos["Response DTOs"]
  node_entities["Shared domain entities"]
  node_tokenstore[("Access token store")]
end

node_client(("SDK client"))
node_backend{{"SafeCircle API"}}
node_websocket{{"Journey service"}}

node_session -->|"delegates"| node_authapi
node_session -->|"validates via"| node_profileuse
node_authimpl -->|"implements"| node_authapi
node_authimpl -->|"executes requests"| node_network
node_authimpl -->|"reads and clears"| node_tokenstore
node_authimpl -->|"uses OTP flow"| node_authflow
node_profileuse -.->|"uses repository"| node_mainapi
node_mainimpl -->|"implements"| node_mainapi
node_mainimpl -->|"executes requests"| node_network
node_mainimpl -->|"caches profile"| node_usercache
node_guardianflows -.->|"uses repository"| node_mainapi
node_mainimpl -->|"maps responses"| node_dtos
node_mainimpl -->|"returns domain values"| node_entities
node_journeyflows -.->|"uses repository"| node_journeyrepo
node_journeyrepo -.->|"executes requests"| node_network
node_journeyrepo -.->|"maps journey data"| node_journeytypes
node_journeydto -->|"converts to"| node_journeytypes
node_socketclient -.->|"connects to"| node_websocket
node_socketclient -.->|"uses live events"| node_journeytypes
node_riskflows -.->|"uses journey data"| node_journeyrepo
node_consentflows -.->|"uses HTTP client"| node_network
node_pushflows -.->|"uses HTTP client"| node_network
node_network -->|"sends HTTP requests"| node_backend
node_network -->|"saves response token"| node_tokenstore
node_network -.->|"executes request"| node_requests

click node_session "https://github.com/idevscode/networking-library_ios/blob/main/Sources/Data/UseCases/DefaultSessionUseCase.swift"
click node_authapi "https://github.com/idevscode/networking-library_ios/blob/main/Sources/Domain/Repositories/AuthRepository.swift"
click node_authimpl "https://github.com/idevscode/networking-library_ios/blob/main/Sources/Data/Repositories/AuthRepoImpl.swift"
click node_authflow "https://github.com/idevscode/networking-library_ios/blob/main/Sources/Domain/VerifyOTPFlow.swift"
click node_profileuse "https://github.com/idevscode/networking-library_ios/blob/main/Sources/Domain/UseCases/GetMyProfileUseCase.swift"
click node_mainapi "https://github.com/idevscode/networking-library_ios/blob/main/Sources/Domain/Repositories/MainRepository.swift"
click node_mainimpl "https://github.com/idevscode/networking-library_ios/blob/main/Sources/Data/Repositories/MainRepositoryImpl.swift"
click node_guardianflows "https://github.com/idevscode/networking-library_ios/tree/main/Sources/Domain/UseCases"
click node_usercache "https://github.com/idevscode/networking-library_ios/blob/main/Sources/Data/Local/UserDefaultsManager.swift"
click node_journeyflows "https://github.com/idevscode/networking-library_ios/tree/main/Sources/Domain/UseCases"
click node_journeyrepo "https://github.com/idevscode/networking-library_ios/blob/main/Sources/Data/Repositories/JourneyRepoImpl.swift"
click node_journeytypes "https://github.com/idevscode/networking-library_ios/blob/main/Sources/Domain/Entities/JourneyEntity.swift"
click node_journeydto "https://github.com/idevscode/networking-library_ios/blob/main/Sources/Data/DTO/JourneyDTO.swift"
click node_socketclient "https://github.com/idevscode/networking-library_ios/blob/main/Sources/Data/Networking/JourneyWebSocketClient.swift"
click node_riskflows "https://github.com/idevscode/networking-library_ios/tree/main/Sources/Domain/UseCases"
click node_consentflows "https://github.com/idevscode/networking-library_ios/tree/main/Sources/Domain/UseCases"
click node_pushflows "https://github.com/idevscode/networking-library_ios/tree/main/Sources/Domain/UseCases"
click node_network "https://github.com/idevscode/networking-library_ios/blob/main/Sources/Data/Networking/NetworkClient.swift"
click node_requests "https://github.com/idevscode/networking-library_ios/tree/main/Sources/Data/NetworkRequests"
click node_dtos "https://github.com/idevscode/networking-library_ios/tree/main/Sources/Data/DTO"
click node_entities "https://github.com/idevscode/networking-library_ios/blob/main/Sources/Domain/Entities/DefaultEntity.swift"
click node_tokenstore "https://github.com/idevscode/networking-library_ios/blob/main/Sources/Data/Local/KeychainManager.swift"

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_session,node_authapi,node_authimpl,node_authflow,node_client toneBlue
class node_profileuse,node_mainapi,node_mainimpl,node_guardianflows,node_usercache toneAmber
class node_journeyflows,node_journeyrepo,node_journeytypes,node_journeydto,node_socketclient,node_riskflows,node_backend toneMint
class node_consentflows,node_pushflows,node_network,node_requests,node_dtos,node_entities,node_tokenstore toneRose
class node_websocket toneIndigo
```

## Components

### Authentication

- [Session orchestration](https://github.com/idevscode/networking-library_ios/blob/main/Sources/Data/UseCases/DefaultSessionUseCase.swift): `Sources/Data/UseCases/DefaultSessionUseCase.swift`
- [Authentication contract](https://github.com/idevscode/networking-library_ios/blob/main/Sources/Domain/Repositories/AuthRepository.swift): `Sources/Domain/Repositories/AuthRepository.swift`
- [Authentication repository](https://github.com/idevscode/networking-library_ios/blob/main/Sources/Data/Repositories/AuthRepoImpl.swift): `Sources/Data/Repositories/AuthRepoImpl.swift`
- [OTP flow](https://github.com/idevscode/networking-library_ios/blob/main/Sources/Domain/VerifyOTPFlow.swift): `Sources/Domain/VerifyOTPFlow.swift`

### Profile and guardians

- [Profile use case](https://github.com/idevscode/networking-library_ios/blob/main/Sources/Domain/UseCases/GetMyProfileUseCase.swift): `Sources/Domain/UseCases/GetMyProfileUseCase.swift`
- [People repository contract](https://github.com/idevscode/networking-library_ios/blob/main/Sources/Domain/Repositories/MainRepository.swift): `Sources/Domain/Repositories/MainRepository.swift`
- [People repository](https://github.com/idevscode/networking-library_ios/blob/main/Sources/Data/Repositories/MainRepositoryImpl.swift): `Sources/Data/Repositories/MainRepositoryImpl.swift`
- [Guardian workflows](https://github.com/idevscode/networking-library_ios/tree/main/Sources/Domain/UseCases): `Sources/Domain/UseCases`
- [User preferences](https://github.com/idevscode/networking-library_ios/blob/main/Sources/Data/Local/UserDefaultsManager.swift): `Sources/Data/Local/UserDefaultsManager.swift`

### Journey safety

- [Journey workflows](https://github.com/idevscode/networking-library_ios/tree/main/Sources/Domain/UseCases): `Sources/Domain/UseCases`
- [Journey repository](https://github.com/idevscode/networking-library_ios/blob/main/Sources/Data/Repositories/JourneyRepoImpl.swift): `Sources/Data/Repositories/JourneyRepoImpl.swift`
- [Journey entities](https://github.com/idevscode/networking-library_ios/blob/main/Sources/Domain/Entities/JourneyEntity.swift): `Sources/Domain/Entities/JourneyEntity.swift`
- [Journey response mapping](https://github.com/idevscode/networking-library_ios/blob/main/Sources/Data/DTO/JourneyDTO.swift): `Sources/Data/DTO/JourneyDTO.swift`
- [Live journey socket](https://github.com/idevscode/networking-library_ios/blob/main/Sources/Data/Networking/JourneyWebSocketClient.swift): `Sources/Data/Networking/JourneyWebSocketClient.swift`
- [Risk detection](https://github.com/idevscode/networking-library_ios/tree/main/Sources/Domain/UseCases): `Sources/Domain/UseCases`

### Data and integrations

- [Consent management](https://github.com/idevscode/networking-library_ios/tree/main/Sources/Domain/UseCases): `Sources/Domain/UseCases`
- [Push registration](https://github.com/idevscode/networking-library_ios/tree/main/Sources/Domain/UseCases): `Sources/Domain/UseCases`
- [HTTP client](https://github.com/idevscode/networking-library_ios/blob/main/Sources/Data/Networking/NetworkClient.swift): `Sources/Data/Networking/NetworkClient.swift`
- [Request definitions](https://github.com/idevscode/networking-library_ios/tree/main/Sources/Data/NetworkRequests): `Sources/Data/NetworkRequests`
- [Response DTOs](https://github.com/idevscode/networking-library_ios/tree/main/Sources/Data/DTO): `Sources/Data/DTO`
- [Shared domain entities](https://github.com/idevscode/networking-library_ios/blob/main/Sources/Domain/Entities/DefaultEntity.swift): `Sources/Domain/Entities/DefaultEntity.swift`
- [Access token store](https://github.com/idevscode/networking-library_ios/blob/main/Sources/Data/Local/KeychainManager.swift): `Sources/Data/Local/KeychainManager.swift`

### Other components

- **SDK client**
- **SafeCircle API**
- **Journey service**

## Connections

- Session orchestration → Authentication contract: delegates (evidence: `Sources/Data/UseCases/DefaultSessionUseCase.swift`)
- Session orchestration → Profile use case: validates via (evidence: `Sources/Data/UseCases/DefaultSessionUseCase.swift`)
- Authentication repository → Authentication contract: implements (evidence: `Sources/Data/Repositories/AuthRepoImpl.swift`)
- Authentication repository → HTTP client: executes requests (evidence: `Sources/Data/Repositories/AuthRepoImpl.swift`)
- Authentication repository → Access token store: reads and clears (evidence: `Sources/Data/Repositories/AuthRepoImpl.swift`)
- Authentication repository → OTP flow: uses OTP flow (evidence: `Sources/Data/Repositories/AuthRepoImpl.swift`)
- Profile use case → People repository contract: uses repository
- People repository → People repository contract: implements (evidence: `Sources/Data/Repositories/MainRepositoryImpl.swift`)
- People repository → HTTP client: executes requests (evidence: `Sources/Data/Repositories/MainRepositoryImpl.swift`)
- People repository → User preferences: caches profile (evidence: `Sources/Data/Repositories/MainRepositoryImpl.swift`)
- Guardian workflows → People repository contract: uses repository
- People repository → Response DTOs: maps responses (evidence: `Sources/Data/Repositories/MainRepositoryImpl.swift`)
- People repository → Shared domain entities: returns domain values (evidence: `Sources/Data/Repositories/MainRepositoryImpl.swift`)
- Journey workflows → Journey repository: uses repository
- Journey repository → HTTP client: executes requests
- Journey repository → Journey entities: maps journey data
- Journey response mapping → Journey entities: converts to (evidence: `Sources/Data/DTO/JourneyDTO.swift`)
- Live journey socket → Journey service: connects to
- Live journey socket → Journey entities: uses live events
- Risk detection → Journey repository: uses journey data
- Consent management → HTTP client: uses HTTP client
- Push registration → HTTP client: uses HTTP client
- HTTP client → SafeCircle API: sends HTTP requests (evidence: `Sources/Data/Networking/NetworkClient.swift`)
- HTTP client → Access token store: saves response token (evidence: `Sources/Data/Networking/NetworkClient.swift`)
- HTTP client → Request definitions: executes request
