# investira/investira.sdk.js architecture

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

- Interactive diagram: https://gitdiagram.com/investira/investira.sdk.js
- Repository: https://github.com/investira/investira.sdk.js

## Overview

investira.sdk is a CommonJS utility library consumed by Node.js applications, not a standalone service. Its entry point exports reusable utilities for dates, finance, HTTP, text and validation, alongside message contracts and helper structures; loading it also installs Date prototype extensions. The README’s integrated example documents an API-request workflow using response extraction, numeric conversion, formatting, dates and standardized messages. Internal dependency edges below are limited to relationships visible in the README or source index; unsampled modules are represented by their documented capabilities, not inferred behavior.

Main entry points: [`index.js`](https://github.com/investira/investira.sdk.js/blob/master/index.js) (SDK entry), [`lib/utils/validators.js`](https://github.com/investira/investira.sdk.js/blob/master/lib/utils/validators.js) (Validators), [`lib/utils/dates.js`](https://github.com/investira/investira.sdk.js/blob/master/lib/utils/dates.js) (Date utilities), [`lib/utils/numbers.js`](https://github.com/investira/investira.sdk.js/blob/master/lib/utils/numbers.js) (Number utilities)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["SDK entry and contracts"]
  node_entry["SDK entry<br/>[index.js]"]
  node_http["HTTP requests<br/>[httpRequests.js]"]
  node_responses["Response helpers<br/>[responses.js]"]
  node_messages["Message catalog"]
end

subgraph group_data["Data and calculations"]
  node_validators["Validators<br/>[validators.js]"]
  node_arrays["Array utilities<br/>[arrays.js]"]
  node_objects["Object utilities<br/>[objects.js]"]
  node_numbers["Number utilities<br/>[numbers.js]"]
  node_dates["Date utilities<br/>[dates.js]"]
  node_invests["Financial calculations<br/>[invests.js]"]
end

subgraph group_text["Text and presentation"]
  node_formats["Value formatting<br/>[formats.js]"]
  node_strings["String utilities<br/>[strings.js]"]
  node_rags["RAG utilities<br/>[rags.js]"]
  node_spellchecker["Spell checker<br/>[spellChecker.js]"]
  node_themes["Theme palettes<br/>[themes.js]"]
end

subgraph group_structures["Scheduling and structures"]
  node_tasks["Scheduled tasks<br/>[tasks.js]"]
  node_matrix["Matrix structure<br/>[matrix.js]"]
  node_datamodel["Typed data model<br/>[dataModel.js]"]
  node_plugins["Date extensions<br/>[date.js]"]
end

node_app(("Node.js application"))
node_api_service["External API"]

node_app -->|"imports"| node_entry
node_entry -->|"exports"| node_http
node_entry -->|"exports"| node_responses
node_entry -->|"exports"| node_messages
node_entry -->|"exports"| node_validators
node_entry -->|"exports"| node_arrays
node_entry -->|"exports"| node_objects
node_entry -->|"exports"| node_numbers
node_entry -->|"exports"| node_dates
node_entry -->|"exports"| node_invests
node_entry -->|"exports"| node_formats
node_entry -->|"exports"| node_strings
node_entry -->|"exports"| node_rags
node_entry -->|"exports"| node_spellchecker
node_entry -->|"exports"| node_themes
node_entry -->|"exports"| node_tasks
node_entry -->|"exports"| node_matrix
node_entry -->|"exports"| node_datamodel
node_entry -->|"loads"| node_plugins
node_app -->|"requests through"| node_http
node_http -.->|"calls"| node_api_service
node_app -->|"extracts data"| node_responses
node_app -->|"converts values"| node_numbers
node_app -->|"formats values"| node_formats
node_app -->|"formats dates"| node_dates
node_app -->|"creates message"| node_messages
node_dates -->|"imports"| node_numbers
node_dates -->|"imports"| node_validators
node_dates -->|"imports"| node_arrays
node_formats -->|"imports"| node_numbers
node_formats -->|"imports"| node_dates
node_formats -->|"imports"| node_validators
node_invests -->|"imports"| node_numbers
node_objects -->|"imports"| node_validators
node_objects -->|"imports"| node_dates
node_arrays -->|"imports"| node_validators
node_numbers -->|"imports"| node_validators
node_responses -->|"imports"| node_validators
node_responses -->|"imports"| node_arrays
node_strings -->|"imports"| node_validators
node_strings -->|"imports"| node_arrays
node_spellchecker -->|"imports"| node_strings
node_spellchecker -->|"imports"| node_validators
node_spellchecker -->|"imports"| node_messages
node_tasks -->|"imports"| node_dates
node_tasks -->|"imports"| node_validators
node_tasks -->|"imports"| node_objects
node_datamodel -->|"imports"| node_objects

click node_entry "https://github.com/investira/investira.sdk.js/blob/master/index.js"
click node_http "https://github.com/investira/investira.sdk.js/blob/master/lib/utils/httpRequests.js"
click node_responses "https://github.com/investira/investira.sdk.js/blob/master/lib/utils/responses.js"
click node_messages "https://github.com/investira/investira.sdk.js/tree/master/lib/messages"
click node_validators "https://github.com/investira/investira.sdk.js/blob/master/lib/utils/validators.js"
click node_arrays "https://github.com/investira/investira.sdk.js/blob/master/lib/utils/arrays.js"
click node_objects "https://github.com/investira/investira.sdk.js/blob/master/lib/utils/objects.js"
click node_numbers "https://github.com/investira/investira.sdk.js/blob/master/lib/utils/numbers.js"
click node_dates "https://github.com/investira/investira.sdk.js/blob/master/lib/utils/dates.js"
click node_invests "https://github.com/investira/investira.sdk.js/blob/master/lib/utils/invests.js"
click node_formats "https://github.com/investira/investira.sdk.js/blob/master/lib/utils/formats.js"
click node_strings "https://github.com/investira/investira.sdk.js/blob/master/lib/utils/strings.js"
click node_rags "https://github.com/investira/investira.sdk.js/blob/master/lib/utils/rags.js"
click node_spellchecker "https://github.com/investira/investira.sdk.js/blob/master/lib/utils/spellChecker.js"
click node_themes "https://github.com/investira/investira.sdk.js/blob/master/lib/utils/themes.js"
click node_tasks "https://github.com/investira/investira.sdk.js/blob/master/lib/hofs/tasks.js"
click node_matrix "https://github.com/investira/investira.sdk.js/blob/master/lib/hofs/matrix.js"
click node_datamodel "https://github.com/investira/investira.sdk.js/blob/master/lib/hofs/dataModel.js"
click node_plugins "https://github.com/investira/investira.sdk.js/blob/master/lib/plugins/date.js"

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_http,node_responses,node_messages toneBlue
class node_validators,node_arrays,node_objects,node_numbers,node_dates,node_invests toneAmber
class node_formats,node_strings,node_rags,node_spellchecker,node_themes,node_api_service toneMint
class node_tasks,node_matrix,node_datamodel,node_plugins toneRose
class node_app toneIndigo
```

## Components

### SDK entry and contracts

- [SDK entry](https://github.com/investira/investira.sdk.js/blob/master/index.js): `index.js`
- [HTTP requests](https://github.com/investira/investira.sdk.js/blob/master/lib/utils/httpRequests.js): `lib/utils/httpRequests.js`
- [Response helpers](https://github.com/investira/investira.sdk.js/blob/master/lib/utils/responses.js): `lib/utils/responses.js`
- [Message catalog](https://github.com/investira/investira.sdk.js/tree/master/lib/messages): `lib/messages`

### Data and calculations

- [Validators](https://github.com/investira/investira.sdk.js/blob/master/lib/utils/validators.js): `lib/utils/validators.js`
- [Array utilities](https://github.com/investira/investira.sdk.js/blob/master/lib/utils/arrays.js): `lib/utils/arrays.js`
- [Object utilities](https://github.com/investira/investira.sdk.js/blob/master/lib/utils/objects.js): `lib/utils/objects.js`
- [Number utilities](https://github.com/investira/investira.sdk.js/blob/master/lib/utils/numbers.js): `lib/utils/numbers.js`
- [Date utilities](https://github.com/investira/investira.sdk.js/blob/master/lib/utils/dates.js): `lib/utils/dates.js`
- [Financial calculations](https://github.com/investira/investira.sdk.js/blob/master/lib/utils/invests.js): `lib/utils/invests.js`

### Text and presentation

- [Value formatting](https://github.com/investira/investira.sdk.js/blob/master/lib/utils/formats.js): `lib/utils/formats.js`
- [String utilities](https://github.com/investira/investira.sdk.js/blob/master/lib/utils/strings.js): `lib/utils/strings.js`
- [RAG utilities](https://github.com/investira/investira.sdk.js/blob/master/lib/utils/rags.js): `lib/utils/rags.js`
- [Spell checker](https://github.com/investira/investira.sdk.js/blob/master/lib/utils/spellChecker.js): `lib/utils/spellChecker.js`
- [Theme palettes](https://github.com/investira/investira.sdk.js/blob/master/lib/utils/themes.js): `lib/utils/themes.js`

### Scheduling and structures

- [Scheduled tasks](https://github.com/investira/investira.sdk.js/blob/master/lib/hofs/tasks.js): `lib/hofs/tasks.js`
- [Matrix structure](https://github.com/investira/investira.sdk.js/blob/master/lib/hofs/matrix.js): `lib/hofs/matrix.js`
- [Typed data model](https://github.com/investira/investira.sdk.js/blob/master/lib/hofs/dataModel.js): `lib/hofs/dataModel.js`
- [Date extensions](https://github.com/investira/investira.sdk.js/blob/master/lib/plugins/date.js): `lib/plugins/date.js`

### Other components

- **Node.js application**
- **External API**

## Connections

- Node.js application → SDK entry: imports (evidence: `README.md`)
- SDK entry → HTTP requests: exports (evidence: `index.js`)
- SDK entry → Response helpers: exports (evidence: `index.js`)
- SDK entry → Message catalog: exports (evidence: `index.js`)
- SDK entry → Validators: exports (evidence: `index.js`)
- SDK entry → Array utilities: exports (evidence: `index.js`)
- SDK entry → Object utilities: exports (evidence: `index.js`)
- SDK entry → Number utilities: exports (evidence: `index.js`)
- SDK entry → Date utilities: exports (evidence: `index.js`)
- SDK entry → Financial calculations: exports (evidence: `index.js`)
- SDK entry → Value formatting: exports (evidence: `index.js`)
- SDK entry → String utilities: exports (evidence: `index.js`)
- SDK entry → RAG utilities: exports (evidence: `index.js`)
- SDK entry → Spell checker: exports (evidence: `index.js`)
- SDK entry → Theme palettes: exports (evidence: `index.js`)
- SDK entry → Scheduled tasks: exports (evidence: `index.js`)
- SDK entry → Matrix structure: exports (evidence: `index.js`)
- SDK entry → Typed data model: exports (evidence: `index.js`)
- SDK entry → Date extensions: loads (evidence: `index.js`)
- Node.js application → HTTP requests: requests through (evidence: `README.md`)
- HTTP requests → External API: calls
- Node.js application → Response helpers: extracts data (evidence: `README.md`)
- Node.js application → Number utilities: converts values (evidence: `README.md`)
- Node.js application → Value formatting: formats values (evidence: `README.md`)
- Node.js application → Date utilities: formats dates (evidence: `README.md`)
- Node.js application → Message catalog: creates message (evidence: `README.md`)
- Date utilities → Number utilities: imports (evidence: `lib/utils/dates.js`)
- Date utilities → Validators: imports (evidence: `lib/utils/dates.js`)
- Date utilities → Array utilities: imports (evidence: `lib/utils/dates.js`)
- Value formatting → Number utilities: imports (evidence: `lib/utils/formats.js`)
- Value formatting → Date utilities: imports (evidence: `lib/utils/formats.js`)
- Value formatting → Validators: imports (evidence: `lib/utils/formats.js`)
- Financial calculations → Number utilities: imports (evidence: `lib/utils/invests.js`)
- Object utilities → Validators: imports (evidence: `lib/utils/objects.js`)
- Object utilities → Date utilities: imports (evidence: `lib/utils/objects.js`)
- Array utilities → Validators: imports (evidence: `lib/utils/arrays.js`)
- Number utilities → Validators: imports (evidence: `lib/utils/numbers.js`)
- Response helpers → Validators: imports (evidence: `lib/utils/responses.js`)
- Response helpers → Array utilities: imports (evidence: `lib/utils/responses.js`)
- String utilities → Validators: imports (evidence: `lib/utils/strings.js`)
- String utilities → Array utilities: imports (evidence: `lib/utils/strings.js`)
- Spell checker → String utilities: imports (evidence: `lib/utils/spellChecker.js`)
- Spell checker → Validators: imports (evidence: `lib/utils/spellChecker.js`)
- Spell checker → Message catalog: imports (evidence: `lib/utils/spellChecker.js`)
- Scheduled tasks → Date utilities: imports (evidence: `lib/hofs/tasks.js`)
- Scheduled tasks → Validators: imports (evidence: `lib/hofs/tasks.js`)
- Scheduled tasks → Object utilities: imports (evidence: `lib/hofs/tasks.js`)
- Typed data model → Object utilities: imports (evidence: `lib/hofs/dataModel.js`)
