t-tech-investments 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cff97b258ff7384f55f88ee890266d106003ba1e61ccaf0f140db45b6f981f55
-  data.tar.gz: 3d03d9e98cedc667ef2462e6aaba1824c5dc54b85fd34601241ba6aae90c911a
+  metadata.gz: 20123e15a4902951a5ee22661123c8a69ec7a55573203f505ec3f2ffd0016fc4
+  data.tar.gz: 24cd3848684453f36079b82c8398c9f69e8d29d422375e6396654b2b55eadd09
 SHA512:
-  metadata.gz: 49373e6e1b2b729b41701a778f2b1f2e7d9ab302b2231aaaa9d9cacb30816a8eba8784ca428f1ddce8abea1cd27d5e980df38fbd29f157ced37fafe135236a39
-  data.tar.gz: a0bb1a988d286d8bfe2117c1b482b36a29bda4b090c355cdbe9acc98dd1aa663d38384c17af4a77ce07b21df262cea51c2c26daccea37963f5f8f8ea70a6fdc5
+  metadata.gz: 4c2ab86b84b0303698ccb523c981e1437da6d0efb7a111971f7682db44e8bb855c26b1582a977b047ff2c111683f718fcd08ddb88956df32745fa620de39191d
+  data.tar.gz: 63a2b49c538d2b9c95f204e517325630de7ac26f9e5397002a81cf8cc6f15a991f99904195241bbbc21f84faa8324a688a0bcf8c3a6664d9bb68dc42ece6143c

data/.cursor/rules/git-flow.mdc

@@ -1,12 +1,56 @@
 ---
-description: Git Flow: ветки и слияния
+description: >
+  Правила следования Git Flow для разработки торговой системы.
+  Определяет модель веток, правила коммитов и merge-стратегии.
+
+globs:
+  - "**/*"
+
 alwaysApply: true
 ---
+В проекте используется Git Flow.
+
+Основные ветки:
+- main — стабильная ветка, всегда в рабочем состоянии.
+- develop — основная ветка разработки.
+
+Рабочие ветки:
+- feature/* — разработка новых фич и модулей
+- bugfix/* — исправления ошибок
+- hotfix/* — срочные исправления для main
+- release/* — подготовка релиза
+
+Правила работы:
+- Прямая разработка в main запрещена.
+- Новые фичи всегда начинаются от develop.
+- Feature-ветки мержатся обратно только в develop.
+- Hotfix-ветки начинаются от main и мержатся в main и develop.
+- Release-ветки используются для стабилизации перед релизом.
+
+Коммиты:
+- Коммиты атомарные и логически завершённые.
+- Один коммит — одно логическое изменение.
+- Сообщения коммитов описывают ЧТО и ЗАЧЕМ, а не КАК.
 
-# Git Flow
+Рекомендованный формат commit message:
+- feat: добавление новой функциональности
+- fix: исправление ошибки
+- refactor: рефакторинг без изменения поведения
+- chore: инфраструктурные изменения
+- test: добавление или изменение тестов
+- docs: документация
 
-**Ветки:** main — только прод (через release/hotfix). develop — интеграция, от неё feature.
+Примеры:
+- feat(strategy): add breakout strategy
+- fix(risk): prevent position size overflow
+- refactor(execution): simplify order state machine
 
-**Именование:** `feature/имя` ← develop → develop; `release/1.2.0` ← develop → main + develop; `hotfix/имя` ← main → main + develop.
+Merge:
+- Предпочтителен merge commit или squash (осознанно).
+- Избегать rebase на общих ветках (develop, main).
+- Конфликты решаются до merge, не после.
 
-Предлагать эти шаблоны веток, feature сливать в develop, не в main.
+Cursor должен:
+- учитывать текущую ветку при генерации изменений
+- не предлагать изменения напрямую в main
+- придерживаться Git Flow при создании новых задач и файлов

data/.cursor/rules/less-code.mdc

@@ -0,0 +1,6 @@
+---
+description: Пожалуйста, решите эту задачу с минимально возможным количеством строк кода.
+alwaysApply: false
+---
+Пожалуйста, решите эту задачу с минимально возможным количеством строк кода.
+Убедитесь, что результат функционально эквивалентен исходной цели и проходит существующие тесты или сценарии использовани

data/.cursor/rules/only-important-steps.mdc

@@ -0,0 +1,5 @@
+---
+alwaysApply: false
+---
+Разбей это только на действительно необходимые шаги. Исключи любые необязательные или умозрительные функции.
+Убедись, что каждый шаг напрямую соответствует текущей цели. Предоставь объяснение, почему каждый шаг необходим.

data/.cursor/rules/sdk-architecture.mdc

@@ -0,0 +1,31 @@
+---
+description: Минимальная архитектура SDK: слои, зависимости, контракты
+alwaysApply: true
+---
+
+# Архитектура SDK (минимум правил)
+
+## Слои
+
+- `Client` (facade) → `Services` → `Transport` (gRPC)
+- `Services` подслои: `contracts` (proto-обвязка), `mappers`, `stores`, `stream`
+- Вспомогательные: `Coercers/Mappers`, `Errors`, `Proto` (сгенерёнка)
+
+## Зависимости (жёсткие запреты)
+
+- `Services` не вызывают gRPC stub напрямую — только через `Transport`.
+- Публичный API не возвращает protobuf по умолчанию (только `raw:`/debug, если нужен).
+- `Transport` без бизнес-логики; только: metadata, deadlines, retries-policy, error mapping.
+- `Coercers/Mappers` — чистые и детерминированные (без IO/сети).
+
+## Контракты (invest-contracts)
+
+- Контракты **пинуем по tag/SHA** (не `master`), храним в `contracts.lock`.
+- Сгенерированный Ruby protobuf/gRPC код **коммитим** в `lib/**/proto/**` (установка гема без `protoc`).
+- Обновление контрактов обязано включать: pin → реген → тест “все RPC экспонированы”.
+
+## T‑Invest инварианты (transport обязан)
+
+- metadata каждого запроса: `Authorization: Bearer <token>`; `x-app-name` (если задан).
+- endpoints по умолчанию (конфигурируемо): prod/sandbox.
+- `x-tracking-id`: извлекать из unary headers и прокидывать в ошибки/логи; для stream — логировать tracking id из статусных сообщений подписки.

data/.cursor/rules/sdk-code-standards.mdc

@@ -0,0 +1,22 @@
+---
+description: Минимальные стандарты кода/PR для SDK
+alwaysApply: true
+---
+
+# Код и процесс (минимум правил)
+
+## Стиль/качество
+
+- Ruby **>= 3.2**, стиль — через `rubocop` (double quotes и т.д.).
+- `rubocop` и `rspec` обязаны проходить.
+- Не логировать секреты (token/credentials).
+- Protobuf наружу не экспонировать по умолчанию (только `raw:`/debug).
+
+## Контракты
+
+- Любое обновление `invest-contracts` включает: обновить pin tag/SHA → реген `lib/**/proto/**` → golden test “все RPC экспонированы”.
+
+## Git/PR
+
+- Следовать git-flow из `.cursor/rules/git-flow.mdc` (feature от `develop` → `develop`).
+- PR: кратко “что/зачем” + тест-план + breaking/non-breaking для публичного Ruby API.

data/.cursor/rules/sdk-patterns.mdc

@@ -0,0 +1,22 @@
+---
+description: Минимальные паттерны: auto-expose RPC, coercion, streaming API
+alwaysApply: true
+---
+
+# Паттерны (минимум правил)
+
+## 1) “Все методы реализованы”
+
+- RPC **экспонируются автоматически** из descriptor’ов/Stub’ов (метапрограммирование).
+- Нельзя вручную поддерживать списки методов или дублировать proto-структуру в коде.
+
+## 2) Преобразования Ruby ↔ protobuf
+
+- Вход в unary/stream управление: Ruby hash/kwargs → protobuf message через reflection (descriptor).
+- Выход наружу: protobuf response → Ruby-friendly hash/DTO; protobuf наружу только `raw:`/debug.
+
+## 3) Streaming (block/yield)
+
+- Streaming API наружу: `client.market_data.stream { |s| s.subscribe_*; s.each_event { |event| ... } }`.
+- Внутри: bidi stream + очередь исходящих команд; server ping игнорируется.
+- Для MarketDataStream: reconciliation через `GetMySubscriptions` (рассинхрон → resubscribe; пусто → restart).

data/.cursor/rules/sdk-testing.mdc

@@ -0,0 +1,19 @@
+---
+description: Тесты без сети: golden checks, coercion, streaming через fake transport
+alwaysApply: true
+---
+
+# Тестирование (строго без сети)
+
+- Любые тесты **без сетевых вызовов** (ни prod, ни sandbox).
+- Тестируем только: преобразования, поведение SDK, соответствие контрактам и документации.
+
+## Обязательные проверки
+
+- **Golden test “все RPC экспонированы”**: после регенерации proto тест падает, если появился новый RPC, но SDK его не выставил.
+- **Coercers/Mappers**: reflection-based Hash/kwargs ↔ protobuf (enum/time/money/oneof).
+- **Transport**: `GRPC::BadStatus` → `Errors::*`, извлечение `x-tracking-id` (unary headers), redaction секретов.
+- **Streaming**: тестировать через fake transport + controlled `Enumerator`:
+  - ping игнорируется
+  - статусы подписки (включая `TOO_MANY_REQUESTS`) мапятся в события/ошибки
+  - reconciliation через `GetMySubscriptions` (рассинхрон → resubscribe; пусто → restart)

data/CHANGELOG.md

@@ -1,5 +1,19 @@
 ## [Unreleased]
 
+## [0.2.0] - 2026-02-06
+
+- Client: services exposed via Registry (method_missing), no hardcoded list; facades (e.g. market_data) discovered dynamically
+- ProtoLoader: load proto files dynamically from directory; common_pb first, then rest + services
+- Market data stream: session stop/close, reconciliation (GetMySubscriptions → restart + resubscribe on drift), max_restarts limit and StreamRestartLimitError
+- Market data: contract/mapper/store/reconciler split; subscription kinds single source of truth; candle interval validation
+- Transport: allow custom CA certs for gRPC
+- Dev: SimpleCov coverage (COVERAGE=1), codecov badge in README
+- Docs: README stream stopping, reconciliation example, installation and usage
+
+## [0.1.1] - 2026-02-05
+
+- Docs: update README with correct links and env options
+
 ## [0.1.0] - 2026-02-05
 
 - Initial release

data/README.md

@@ -1,12 +1,35 @@
 # T::Tech::Investments
 
-Ruby-обёртка над gRPC API [T-Bank Invest API](https://opensource.tbank.ru/invest/invest-contracts). Контракты (proto-файлы) берутся из репозитория [invest-contracts](https://opensource.tbank.ru/invest/invest-contracts/-/tree/master/src/docs/contracts); гем даёт удобный Ruby-клиент для работы с брокерским счётом, инструментами, заявками и стримами маркет-данных.
+[![Gem Version](https://img.shields.io/gem/v/t-tech-investments.svg)](https://rubygems.org/gems/t-tech-investments)
+[![Ruby](https://img.shields.io/badge/ruby-%3E%3D%203.2-blue)](https://www.ruby-lang.org/)
+[![CI](https://img.shields.io/github/actions/workflow/status/naveroot/t-tech-investments/main.yml?branch=main&label=rspec)](https://github.com/naveroot/t-tech-investments/actions/workflows/main.yml)
+[![codecov](https://codecov.io/gh/naveroot/t-tech-investments/graph/badge.svg)](https://codecov.io/gh/naveroot/t-tech-investments)
 
-Гем предназначен для интеграции инвестиционных сервисов T-Bank в Ruby-приложения: типизированные вызовы вместо ручной работы с gRPC, единый стиль API и опора на официальные контракты.
+Ruby wrapper for the gRPC API of [T-Bank Invest](https://developer.tbank.ru/invest/intro/intro/). Contracts (proto files) are sourced from [investAPI](https://github.com/RussianInvestments/investAPI) and pinned by SHA in `contracts.lock`; generated protobuf/gRPC code is committed to `lib/**/proto/**`. The gem provides a convenient Ruby client for accounts, instruments, orders, and market data streams. Available `Client` methods depend on the loaded contract; after regenerating proto, the set of methods can change.
+
+This gem integrates T-Bank investment services into Ruby apps: typed calls instead of manual gRPC handling, consistent API style, and adherence to official contracts.
+
+## Contents
+
+- [Installation](#installation)
+- [Minimal requirements (Prod / Sandbox)](#minimal-requirements-prod--sandbox)
+- [Usage](#usage)
+- [Development](#development)
+- [Contributing](#contributing)
+- [License](#license)
+- [Code of Conduct](#code-of-conduct)
+
+## Key features
+
+- Typed unary RPC wrappers for all services
+- MarketData bidirectional stream with Ruby-friendly events
+- Hash/kwargs ↔ protobuf coercers (reflection-based)
+- Config snapshot per client (safe for background jobs)
+- Error mapping with tracking id extraction
 
 ## Installation
 
-Install the gem and add to the application's Gemfile by executing:
+Install the gem and add it to the application's Gemfile by executing:
 
 ```bash
 bundle add t-tech-investments
@@ -18,19 +41,309 @@ If bundler is not being used to manage dependencies, install the gem by executin
 gem install t-tech-investments
 ```
 
+## Minimal requirements (Prod / Sandbox)
+
+Minimum required to start using T-Invest API:
+
+- **Ruby**: >= 3.2
+- **Access token**: obtain a token in T-Bank Dev Portal (“Getting started”) — [docs](https://developer.tbank.ru/invest/intro/intro/)
+- **Environment**: use a **prod** or **sandbox** token
+- **gRPC endpoint** (from docs):
+  - **Prod**: `invest-public-api.tbank.ru:443`
+  - **Sandbox**: `sandbox-invest-public-api.tbank.ru:443`
+
+Recommended environment-variable configuration (names follow this gem's convention):
+
+```bash
+# Prod
+export TINVEST_TOKEN="..."
+export TINVEST_ENDPOINT="invest-public-api.tbank.ru:443"
+
+# or Sandbox
+export TINVEST_TOKEN="..."
+export TINVEST_ENDPOINT="sandbox-invest-public-api.tbank.ru:443"
+```
+
+Optional (ENV-first configuration):
+
+```bash
+# Application identifier (x-app-name)
+export TINVEST_APP_NAME="my-app"
+
+# Default timeout (seconds)
+export TINVEST_TIMEOUT="10"
+
+# Path to CA certs PEM (custom environments)
+export TINVEST_SSL_CA_CERTS="/path/to/ca.pem"
+```
+
 ## Usage
 
-TODO: Write usage instructions here
+The gem provides a global default configuration plus per-client overrides.
+
+### Configuration
+
+#### ENV-first (quick start)
+
+**Given** you have a token and selected environment (prod/sandbox)  
+**When** you set `TINVEST_TOKEN` and `TINVEST_ENDPOINT`  
+**Then** you can create a client without additional setup
+
+```ruby
+require "t/tech/investments"
+
+client = T::Tech::Investments.client
+```
+
+If you installed the gem via `gem install` and see `uninitialized constant T`, make sure your script requires the gem:
+
+```ruby
+require "t/tech/investments"
+```
+
+#### Explicit configuration (Rails / monolith)
+
+**Given** you want centralized configuration  
+**When** you call `T::Tech::Investments.configure`  
+**Then** new clients use these values by default
+
+```ruby
+T::Tech::Investments.configure do |c|
+  c.token    = ENV.fetch("TINVEST_TOKEN")
+  c.endpoint = ENV.fetch("TINVEST_ENDPOINT", "invest-public-api.tbank.ru:443") # or sandbox
+  c.timeout  = 10
+
+  # optional
+  c.app_name = "my-app"
+  c.logger   = Logger.new($stdout)
+end
+
+client = T::Tech::Investments.client
+```
+
+#### Override for a single client
+
+**Given** you need different settings for one call/process  
+**When** you pass parameters to `client(...)`  
+**Then** they apply only to that instance
+
+```ruby
+client = T::Tech::Investments.client(
+  endpoint: "sandbox-invest-public-api.tbank.ru:443",
+  timeout: 2
+)
+```
+
+### Configuration best practices
+
+- **Validate token**: if missing/empty, raise `ConfigurationError` (or similar) with a clear message.
+- **Do not log secrets**: token must not appear in logs or exceptions.
+- **Snapshot config per client**: a created client should not pick up global config changes later (important for jobs/threads).
+- **Prod vs Sandbox**: distinguish environments only by the endpoint from the docs:
+  - **Prod**: `invest-public-api.tbank.ru:443`
+  - **Sandbox**: `sandbox-invest-public-api.tbank.ru:443`
+
+### Unary requests (data fetch)
+
+Unary requests in T-Invest API are standard gRPC calls: “one request → one response”.
+
+#### Authorization and headers
+
+Per T-Invest API docs, the token is passed in **request metadata** as a header:
+
+- **`authorization: Bearer <token>`**
+
+Additionally (recommended for SDK) you can pass:
+
+- **`x-app-name`** — app/SDK identifier for analytics (as recommended in the docs)
+
+Source: [gRPC — Authorization / AppName / trackingId](https://developer.tbank.ru/invest/intro/developer/protocols/grpc/).
+
+#### Example (common pattern)
+
+**Given** `TINVEST_TOKEN` and `TINVEST_ENDPOINT` are configured  
+**When** you call a unary service method  
+**Then** you get a Hash (default) or raw protobuf with `raw: true`
+
+```ruby
+client = T::Tech::Investments.client
+
+# Accounts list (Hash with :accounts etc.)
+accounts = client.users.get_accounts
+# With params and options
+accounts = client.users.get_accounts(status: :open)
+
+# Candles for an instrument (from/to — Time or Hash)
+candles = client.market_data.get_candles(
+  figi: "BBG004730N88",
+  from: Time.now - 3600,
+  to: Time.now,
+  interval: :candle_interval_1_min
+)
+
+# Raw protobuf (debugging)
+raw_response = client.users.get_accounts(raw: true)
+```
+
+#### Timeouts (deadline)
+
+For gRPC it is important to set a deadline/timeout to avoid hanging requests. Calls use `timeout` from configuration (or an override per client).
+
+#### Tracking id (x-tracking-id)
+
+Docs note that **`x-tracking-id` is included in unary responses**. This UUID should be provided to support when troubleshooting.
+
+Recommended practice for the gem:
+
+- log/propagate `x-tracking-id` on errors;
+- optionally expose it via a response wrapper or instrumentation hooks.
+
+### Streaming (MarketData)
+
+Bidirectional stream: in the block you send subscriptions, then `each_event` yields events. Events are Hashes with `:type` and `:data`; **ping is ignored** by the SDK.
+
+#### Correct usage
+
+- Treat the stream as **long-lived** and set a higher `timeout` (or override per call).
+- Enqueue subscriptions **before** calling `each_event`.
+- Keep `each_event` running; break the block when you want to stop the stream.
+
+```ruby
+client.market_data.stream(timeout: 300) do |s|
+  s.subscribe_candles(
+    subscription_action: :SUBSCRIPTION_ACTION_SUBSCRIBE,
+    instruments: [
+      {
+        figi: "BBG004730N88",
+        interval: :SUBSCRIPTION_INTERVAL_ONE_MINUTE
+      }
+    ],
+    waiting_close: true,
+    candle_source_type: :CANDLE_SOURCE_EXCHANGE
+  )
+
+  s.each_event do |event|
+    p event
+    # break if you want to stop the stream
+  end
+end
+```
+
+#### Troubleshooting
+
+If you see `SUBSCRIPTION_STATUS_SUBSCRIPTION_NOT_FOUND` or the server responds with an unsubscribe action, explicitly pass full enum values:
+
+```ruby
+client.market_data.stream(timeout: 300) do |s|
+  s.subscribe_candles(
+    subscription_action: :SUBSCRIPTION_ACTION_SUBSCRIBE,
+    instruments: [
+      {
+        figi: "BBG004730N88",
+        interval: :SUBSCRIPTION_INTERVAL_ONE_MINUTE
+      }
+    ],
+    waiting_close: true,
+    candle_source_type: :CANDLE_SOURCE_EXCHANGE
+  )
+  s.each_event { |event| p event }
+end
+```
+
+Also ensure your **token and endpoint match the same environment** (prod vs sandbox).
+
+```ruby
+client = T::Tech::Investments.client
+
+client.market_data.stream do |s|
+  # 1) Subscriptions (subscription_action: :subscribe or :unsubscribe)
+  s.subscribe_candles(
+    subscription_action: :subscribe,
+    instruments: [{ figi: "BBG004730N88", interval: :subscription_interval_one_minute }],
+    waiting_close: true
+  )
+  s.subscribe_order_book(
+    subscription_action: :subscribe,
+    instruments: [{ figi: "BBG004730N88", depth: 10 }]
+  )
+
+  # 2) Read events (event[:type], event[:data])
+  s.each_event do |event|
+    case event[:type]
+    when :candle
+      puts "candle: #{event[:data].inspect}"
+    when :orderbook
+      puts "orderbook: #{event[:data].inspect}"
+    when :subscribe_candles_response, :subscribe_order_book_response
+      # subscription responses (tracking_id and statuses in event[:data])
+      warn "subscription: #{event[:data].inspect}"
+    when :trading_status, :last_price, :trade
+      # other types by contract
+    end
+  end
+end
+```
+
+Reconciliation: if subscriptions drift, call `s.get_my_subscriptions` and resubscribe or restart the stream as needed.
+
+#### Stopping a stream (graceful)
+
+If you need to stop a long-running stream from another thread or from a signal handler, call `stop`/`close` on the session to terminate the request stream cleanly:
+
+```ruby
+session = nil
+stream_thread = Thread.new do
+  client.market_data.stream(timeout: 300) do |s|
+    session = s
+    s.subscribe_candles(
+      subscription_action: :subscribe,
+      instruments: [{ figi: "BBG004730N88", interval: :subscription_interval_one_minute }]
+    )
+    s.each_event { |event| p event }
+  end
+end
+
+# later...
+session&.stop
+stream_thread.join
+```
+
+#### Reconciliation example (server vs local subscriptions)
+
+To detect drift, request server-side subscriptions and let the session reconcile:
+
+```ruby
+client.market_data.stream(timeout: 300) do |s|
+  s.subscribe_candles(
+    subscription_action: :subscribe,
+    instruments: [{ figi: "BBG004730N88", interval: :subscription_interval_one_minute }]
+  )
+  s.get_my_subscriptions
+
+  s.each_event do |event|
+    case event[:type]
+    when :subscribe_candles_response
+      # local subscription responses
+    end
+  end
+end
+```
+
+Notes:
+
+- Stream authorization uses metadata `authorization: Bearer <token>` (same as unary). See [gRPC — Authorization / AppName / trackingId](https://developer.tbank.ru/invest/intro/developer/protocols/grpc/).
+- A single stream can send multiple subscription requests (candles, order book, trades, etc.) — each is enqueued separately.
+- See [Market data service docs](https://developer.tbank.ru/invest/services/quotes/head-marketdata/).
 
 ## Development
 
-After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. To generate a coverage report (development only), run `COVERAGE=1 bundle exec rspec`; the report is written to `coverage/`. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
 
 To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and the created tag, and push the `.gem` file to [rubygems.org](https://rubygems.org).
 
 ## Contributing
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/t-tech-investments. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [code of conduct](https://github.com/[USERNAME]/t-tech-investments/blob/main/CODE_OF_CONDUCT.md).
+Bug reports and pull requests are welcome on GitHub at https://github.com/naveroot/t-tech-investments. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [code of conduct](https://github.com/naveroot/t-tech-investments/blob/main/CODE_OF_CONDUCT.md).
 
 ## License
 
@@ -38,4 +351,4 @@ The gem is available as open source under the terms of the [MIT License](https:/
 
 ## Code of Conduct
 
-Everyone interacting in the T::Tech::Investments project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/[USERNAME]/t-tech-investments/blob/main/CODE_OF_CONDUCT.md).
+Everyone interacting in the T::Tech::Investments project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/naveroot/t-tech-investments/blob/main/CODE_OF_CONDUCT.md).

data/Rakefile

@@ -9,4 +9,8 @@ require "rubocop/rake_task"
 
 RuboCop::RakeTask.new
 
+task :regenerate_proto do
+  sh "bundle exec ruby script/regenerate_proto"
+end
+
 task default: %i[spec rubocop]

data/contracts.lock

@@ -0,0 +1,6 @@
+{
+  "repository": "https://github.com/RussianInvestments/investAPI.git",
+  "ref": "3eaf23a25f598fe483c913184acdbd9132bc68d2",
+  "contracts_path": "src/docs/contracts",
+  "description": "invest-contracts pin (Release 1.43). Update ref then run script/regenerate_proto and golden test."
+}

data/lib/t/tech/investments/client.rb

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+module T
+  module Tech
+    module Investments
+      # Client facade: config snapshot, transport, and service adapters (users, instruments, etc.).
+      # Services expose unary RPCs via Transport + Coercers; RPCs are defined from proto descriptors.
+      class Client
+        attr_reader :config
+
+        def initialize(config_snapshot)
+          @config = config_snapshot.validate!
+          @transport = nil
+          @services = {}
+        end
+
+        def transport
+          @transport ||= Transport.new(config)
+        end
+
+        def method_missing(method_name, *args, **kwargs, &block)
+          if Services::Registry.public_service_names.include?(method_name) &&
+             args.empty? && kwargs.empty? && block.nil?
+            return service(method_name)
+          end
+
+          super
+        end
+
+        def respond_to_missing?(method_name, include_private = false)
+          Services::Registry.public_service_names.include?(method_name) || super
+        end
+
+        private
+
+        def service(name)
+          if (facade_class = Services::Registry.facade_class(name))
+            @facades ||= {}
+            return @facades[name] ||= begin
+              ProtoLoader.load!
+              unary = Services::UnaryAdapter.new(Services::Registry.service_class(name), transport)
+              facade_class.new(unary, transport)
+            end
+          end
+
+          @services[name] ||= begin
+            ProtoLoader.load!
+            Services::UnaryAdapter.new(Services::Registry.service_class(name), transport)
+          end
+        end
+      end
+    end
+  end
+end