# rfs-adreno/zca-js architecture

> Architecture diagram of the GitHub repository rfs-adreno/zca-js, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/rfs-adreno/zca-js
- Repository: https://github.com/rfs-adreno/zca-js

## Overview

ZCA-JS is an unofficial JavaScript client for personal Zalo accounts, simulating Zalo Web. The principal workflow is application code creating a Zalo client, authenticating through QR login, receiving an API facade, then listening for events or invoking domain APIs. Those APIs encode and dispatch requests through shared utilities to Zalo Web, returning typed results. The graph preserves messaging, stickers, contacts, groups, profile, commerce, reminders, polls, settings, and optional image metadata integration. Several broad API branches are represented from the tree and exports; their internal calls were not sampled.

Main entry points: [`src/apis.ts`](https://github.com/rfs-adreno/zca-js/blob/main/src/apis.ts) (API Facade), [`src/apis/sendMessage.ts`](https://github.com/rfs-adreno/zca-js/blob/main/src/apis/sendMessage.ts) (Message APIs), [`src/zalo.ts`](https://github.com/rfs-adreno/zca-js/blob/main/src/zalo.ts) (Zalo Client), [`src/apis/loginQR.ts`](https://github.com/rfs-adreno/zca-js/blob/main/src/apis/loginQR.ts) (QR Login)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_lifecycle["Client Lifecycle"]
  node_zalo["Zalo Client<br/>[zalo.ts]"]
  node_login["QR Login<br/>[loginQR.ts]"]
  node_api["API Facade<br/>[apis.ts]"]
end

subgraph group_transport["Session Transport"]
  node_context["Session Context<br/>[context.ts]"]
  node_utils["Request Utilities<br/>[utils.ts]"]
  node_errors["API Errors<br/>[index.ts]"]
end

subgraph group_messaging["Messaging Events"]
  node_listener["Event Listener<br/>[listen.ts]"]
  node_messages["Message APIs<br/>[sendMessage.ts]"]
  node_stickers["Sticker APIs<br/>[searchSticker.ts]"]
  node_message_models["Message Models<br/>[Message.ts]"]
end

subgraph group_social["Social Graph"]
  node_contacts["Contact APIs<br/>[getAllFriends.ts]"]
  node_groups["Group APIs"]
  node_profile["Profile APIs"]
end

subgraph group_tools["Business Tools"]
  node_catalogs["Catalog APIs<br/>[createCatalog.ts]"]
  node_banking["Bank APIs"]
  node_reminders["Reminder APIs<br/>[createReminder.ts]"]
  node_polls["Poll APIs<br/>[createPoll.ts]"]
  node_settings["Settings APIs<br/>[updateSettings.ts]"]
end

node_app(("Application"))
node_zalo_web["Zalo Web"]
node_metadata["Image Metadata"]

node_app -->|"creates client"| node_zalo
node_zalo -->|"starts login"| node_login
node_login -->|"authenticates QR"| node_zalo_web
node_login -->|"returns API"| node_api
node_zalo -->|"holds session"| node_context
node_api -->|"creates listener"| node_listener
node_listener -->|"receives events"| node_zalo_web
node_api -->|"creates APIs"| node_messages
node_api -->|"creates APIs"| node_stickers
node_api -->|"creates APIs"| node_contacts
node_api -->|"creates APIs"| node_groups
node_api -->|"creates APIs"| node_profile
node_api -->|"creates APIs"| node_catalogs
node_api -->|"creates APIs"| node_banking
node_api -->|"creates APIs"| node_reminders
node_api -->|"creates APIs"| node_polls
node_api -->|"creates APIs"| node_settings
node_messages -->|"dispatches requests"| node_utils
node_stickers -->|"dispatches requests"| node_utils
node_groups -->|"dispatches requests"| node_utils
node_messages -->|"uses message types"| node_message_models
node_messages -->|"raises errors"| node_errors
node_messages -.->|"reads metadata"| node_metadata

click node_zalo "https://github.com/rfs-adreno/zca-js/blob/main/src/zalo.ts"
click node_login "https://github.com/rfs-adreno/zca-js/blob/main/src/apis/loginQR.ts"
click node_api "https://github.com/rfs-adreno/zca-js/blob/main/src/apis.ts"
click node_context "https://github.com/rfs-adreno/zca-js/blob/main/src/context.ts"
click node_utils "https://github.com/rfs-adreno/zca-js/blob/main/src/utils.ts"
click node_listener "https://github.com/rfs-adreno/zca-js/blob/main/src/apis/listen.ts"
click node_messages "https://github.com/rfs-adreno/zca-js/blob/main/src/apis/sendMessage.ts"
click node_stickers "https://github.com/rfs-adreno/zca-js/blob/main/src/apis/searchSticker.ts"
click node_message_models "https://github.com/rfs-adreno/zca-js/blob/main/src/models/Message.ts"
click node_contacts "https://github.com/rfs-adreno/zca-js/blob/main/src/apis/getAllFriends.ts"
click node_groups "https://github.com/rfs-adreno/zca-js/blob/main/src/apis/reviewPendingMemberRequest.ts"
click node_profile "https://github.com/rfs-adreno/zca-js/blob/main/src/apis/fetchAccountInfo.ts"
click node_catalogs "https://github.com/rfs-adreno/zca-js/blob/main/src/apis/createCatalog.ts"
click node_banking "https://github.com/rfs-adreno/zca-js/blob/main/src/apis/createBankAccount.ts"
click node_reminders "https://github.com/rfs-adreno/zca-js/blob/main/src/apis/createReminder.ts"
click node_polls "https://github.com/rfs-adreno/zca-js/blob/main/src/apis/createPoll.ts"
click node_settings "https://github.com/rfs-adreno/zca-js/blob/main/src/apis/updateSettings.ts"
click node_errors "https://github.com/rfs-adreno/zca-js/blob/main/src/Errors/index.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_zalo,node_login,node_api toneBlue
class node_context,node_utils,node_errors toneAmber
class node_listener,node_messages,node_stickers,node_message_models toneMint
class node_contacts,node_groups,node_profile toneRose
class node_catalogs,node_banking,node_reminders,node_polls,node_settings,node_app,node_zalo_web,node_metadata toneIndigo
```

## Components

### Client Lifecycle

- [Zalo Client](https://github.com/rfs-adreno/zca-js/blob/main/src/zalo.ts): `src/zalo.ts`
- [QR Login](https://github.com/rfs-adreno/zca-js/blob/main/src/apis/loginQR.ts): `src/apis/loginQR.ts`
- [API Facade](https://github.com/rfs-adreno/zca-js/blob/main/src/apis.ts): `src/apis.ts`

### Session Transport

- [Session Context](https://github.com/rfs-adreno/zca-js/blob/main/src/context.ts): `src/context.ts`
- [Request Utilities](https://github.com/rfs-adreno/zca-js/blob/main/src/utils.ts): `src/utils.ts`
- [API Errors](https://github.com/rfs-adreno/zca-js/blob/main/src/Errors/index.ts): `src/Errors/index.ts`

### Messaging Events

- [Event Listener](https://github.com/rfs-adreno/zca-js/blob/main/src/apis/listen.ts): `src/apis/listen.ts`
- [Message APIs](https://github.com/rfs-adreno/zca-js/blob/main/src/apis/sendMessage.ts): `src/apis/sendMessage.ts`
- [Sticker APIs](https://github.com/rfs-adreno/zca-js/blob/main/src/apis/searchSticker.ts): `src/apis/searchSticker.ts`
- [Message Models](https://github.com/rfs-adreno/zca-js/blob/main/src/models/Message.ts): `src/models/Message.ts`

### Social Graph

- [Contact APIs](https://github.com/rfs-adreno/zca-js/blob/main/src/apis/getAllFriends.ts): `src/apis/getAllFriends.ts`
- [Group APIs](https://github.com/rfs-adreno/zca-js/blob/main/src/apis/reviewPendingMemberRequest.ts): `src/apis/reviewPendingMemberRequest.ts`
- [Profile APIs](https://github.com/rfs-adreno/zca-js/blob/main/src/apis/fetchAccountInfo.ts): `src/apis/fetchAccountInfo.ts`

### Business Tools

- [Catalog APIs](https://github.com/rfs-adreno/zca-js/blob/main/src/apis/createCatalog.ts): `src/apis/createCatalog.ts`
- [Bank APIs](https://github.com/rfs-adreno/zca-js/blob/main/src/apis/createBankAccount.ts): `src/apis/createBankAccount.ts`
- [Reminder APIs](https://github.com/rfs-adreno/zca-js/blob/main/src/apis/createReminder.ts): `src/apis/createReminder.ts`
- [Poll APIs](https://github.com/rfs-adreno/zca-js/blob/main/src/apis/createPoll.ts): `src/apis/createPoll.ts`
- [Settings APIs](https://github.com/rfs-adreno/zca-js/blob/main/src/apis/updateSettings.ts): `src/apis/updateSettings.ts`

### Other components

- **Application**
- **Zalo Web**
- **Image Metadata**

## Connections

- Application → Zalo Client: creates client
- Zalo Client → QR Login: starts login
- QR Login → Zalo Web: authenticates QR
- QR Login → API Facade: returns API
- Zalo Client → Session Context: holds session
- API Facade → Event Listener: creates listener
- Event Listener → Zalo Web: receives events
- API Facade → Message APIs: creates APIs
- API Facade → Sticker APIs: creates APIs
- API Facade → Contact APIs: creates APIs
- API Facade → Group APIs: creates APIs
- API Facade → Profile APIs: creates APIs
- API Facade → Catalog APIs: creates APIs
- API Facade → Bank APIs: creates APIs
- API Facade → Reminder APIs: creates APIs
- API Facade → Poll APIs: creates APIs
- API Facade → Settings APIs: creates APIs
- Message APIs → Request Utilities: dispatches requests
- Sticker APIs → Request Utilities: dispatches requests
- Group APIs → Request Utilities: dispatches requests
- Message APIs → Message Models: uses message types
- Message APIs → API Errors: raises errors
- Message APIs → Image Metadata: reads metadata
