rustore

rustore
CLI для работы с RuStore API

Командная строка для взаимодействия с RuStore API, похожая на Expo CLI

🌟 Возможности

• 🔐 Авторизация через приватный ключ из RuStore Консоль
• 🔑 Автоматическое управление токенами доступа
• 📦 Работа с API RuStore (платежи, подписки, приложения)
• ⚙️ Сохранение конфигурации в ~/.rustore/config.json
• 🧪 Полное покрытие тестами

🛠️ Установка

npm install -g rustore

или локально:

npm install rustore

📖 Использование

Первоначальная настройка

Перед использованием CLI необходимо получить приватный ключ в RuStore Консоль.

Авторизация

# Авторизация с указанием keyId и приватного ключа
rustore login --key-id <keyId> --key <base64-ключ>

# Или короткая форма
rustore login -i <keyId> -k <base64-ключ>

Пример:

rustore login --key-id 123456 --key MIIEvQIBADANBgkqhkiG9w0BAQEFAASCBKgwggSkAgEAAoIBAQC...

Проверка статуса

# Показать информацию о текущей авторизации
rustore whoami

Выход из системы

# Удалить токен (ключи остаются в конфиге)
rustore logout

Работа с приложениями

# Получить список приложений
rustore apps list

# Получить все приложения (с пагинацией)
rustore apps list --all

# Вывести результат в формате JSON
rustore apps list --json

📁 Конфигурация

CLI сохраняет конфигурацию в ~/.rustore/config.json:

{
  "keyId": "ваш-key-id",
  "privateKey": "ваш-приватный-ключ-base64",
  "token": "jwe-токен",
  "tokenExpiresAt": 1234567890
}

Важно: Приватный ключ хранится в открытом виде. Защитите доступ к файлу конфигурации.

🔧 Разработка

Установка зависимостей

npm install

Сборка

npm run build

Запуск в режиме разработки

npm start

Тестирование

# Запустить все тесты
npm test

# Тесты в watch режиме
npm run test:watch

# С покрытием
npm run test:coverage

Как протестировать текущие изменения

• Сборка проекта:

  npm run build
  

• Проверка типов:

  npm run type-check
  # или
  ./node_modules/.bin/tsc --noEmit
  

• Запуск тестов:

  npm test
  

• Тестирование CLI локально:

  # Запуск без установки (через tsx)
  npm start -- login <keyId> --key <key>
  
  # Или после сборки
  node dist/bin.js whoami
  

• Линтинг:

  npm run lint
  npm run lint:fix
  

Проверка типов

npm run type-check

Линтинг

npm run lint
npm run lint:fix

📚 API

Структура API

API организовано по категориям, как в документации RuStore:

• Apps API (appsApi) - Загрузка и публикация приложений (общие методы)
• Payments API (paymentsApi) - Работа с платежами и подписками (общие методы)
• Payments App API (paymentsAppApi) - Работа с платежами и подписками (методы приложений)
• Catalog API (catalogApi) - API для работы с продуктовым каталогом

Программный доступ

import {login, appsApi, paymentsApi, catalogApi} from 'rustore';

// Авторизация
await login('keyId', 'privateKey');

// Получить список приложений
const appsResponse = await appsApi.getAppList();
console.log(appsResponse.body.content);

// Получить все приложения (с автоматической пагинацией)
const allApps = await appsApi.getAllApps();

// Использование других API категорий
// await paymentsApi.refund(...);
// await catalogApi.getProducts(...);

🔗 Полезные ссылки

• Документация RuStore API
• Процесс авторизации
• RuStore Консоль

📝 Лицензия

MIT