amcoin-sdk 1.0.0

package/README.md

@@ -0,0 +1,157 @@
+# amcoin-sdk
+
+Официальный JavaScript SDK для [AmCoin Merchant API](https://api.am-coin.online).
+
+## Установка
+
+```bash
+npm install amcoin-sdk
+```
+
+## Быстрый старт
+
+```javascript
+const AmCoin = require('amcoin-sdk');
+const amcoin = new AmCoin('AC_ваш_ключ');
+```
+
+---
+
+## Баланс
+
+```javascript
+const data = await amcoin.getBalance();
+console.log(data.balance); // 15000
+```
+
+---
+
+## Инвойсы
+
+```javascript
+// Создать
+const inv = await amcoin.invoice.create({
+  amount: 500,
+  description: 'Подписка Pro',
+  externalId: 'order_123',
+  expiresInMinutes: 60,
+});
+console.log(inv.invoiceId);  // INV1A2B3C
+console.log(inv.payLink);    // t.me/AmCoinMerchantBot?start=pay_...
+
+// Получить
+const inv = await amcoin.invoice.get('INV1A2B3C');
+console.log(inv.status); // pending | paid | expired | cancelled
+
+// Список
+const list = await amcoin.invoice.list({ status: 'pending', limit: 10 });
+
+// Отменить
+await amcoin.invoice.cancel('INV1A2B3C');
+
+// Ждать оплаты (polling)
+const paid = await amcoin.invoice.waitForPayment('INV1A2B3C', {
+  timeout: 10 * 60 * 1000, // 10 минут
+  interval: 3000,           // проверять каждые 3 сек
+});
+console.log('Оплачено!', paid.paidBy);
+```
+
+---
+
+## Чеки
+
+```javascript
+// Создать чек на 100 AC × 10 активаций
+const check = await amcoin.check.create({ amount: 100, activations: 10 });
+console.log(check.checkLink); // t.me/AmCoinAppbot?start=check_...
+
+// Получить статус
+const ch = await amcoin.check.get('A1B2C3D4');
+console.log(ch.remainingActivations);
+```
+
+---
+
+## Переводы
+
+```javascript
+await amcoin.transfer({
+  userId: 123456789,
+  amount: 100,
+  comment: 'Бонус за регистрацию',
+});
+```
+
+---
+
+## Пользователь
+
+```javascript
+const user = await amcoin.getUser(123456789);
+console.log(user.username, user.balance, user.isBanned);
+```
+
+---
+
+## Транзакции
+
+```javascript
+const txns = await amcoin.getTransactions({ type: 'deposit', limit: 20 });
+```
+
+---
+
+## Вебхуки
+
+### Установить URL
+```javascript
+await amcoin.setWebhook('https://мой-сайт.com/webhook');
+await amcoin.removeWebhook(); // удалить
+```
+
+### Слушать вебхуки локально
+```javascript
+amcoin.listenWebhook({ port: 3000, path: '/webhook' });
+
+amcoin.on('invoice_paid', (data) => {
+  console.log('Оплачен:', data.invoiceId, 'на', data.amount, 'AC');
+});
+
+amcoin.on('payment', (data) => {
+  console.log('Свободная оплата:', data.amount, 'AC от', data.userId);
+});
+```
+
+---
+
+## Обработка ошибок
+
+```javascript
+const { AmCoinError } = require('amcoin-sdk');
+
+try {
+  await amcoin.transfer({ userId: 123, amount: 99999 });
+} catch(e) {
+  if (e instanceof AmCoinError) {
+    console.log(e.message); // Недостаточно средств
+    console.log(e.code);    // 400
+  }
+}
+```
+
+---
+
+## Опции
+
+```javascript
+const amcoin = new AmCoin('AC_ключ', {
+  timeout: 15000, // таймаут запроса в мс (по умолч. 10000)
+});
+```
+
+---
+
+## Лицензия
+
+MIT

package/index.js

@@ -0,0 +1,218 @@
+'use strict';
+
+const https = require('https');
+const http  = require('http');
+const { EventEmitter } = require('events');
+
+const BASE_URL = 'https://api.am-coin.online/api';
+
+class AmCoinError extends Error {
+  constructor(message, code) {
+    super(message);
+    this.name = 'AmCoinError';
+    this.code = code || null;
+  }
+}
+
+class AmCoin extends EventEmitter {
+  constructor(apiKey, options) {
+    super();
+    if (!apiKey) throw new AmCoinError('API ключ обязателен.');
+    this._key     = apiKey;
+    this._timeout = (options && options.timeout) || 10000;
+    this._webhook = null;
+
+    this.invoice  = new InvoiceModule(this);
+    this.check    = new CheckModule(this);
+  }
+
+  // ─── HTTP ───────────────────────────────────────────────
+  _request(method, path, body) {
+    return new Promise((resolve, reject) => {
+      var url     = BASE_URL + path;
+      var payload = body ? JSON.stringify(body) : null;
+      var opts    = {
+        method  : method,
+        headers : {
+          'X-Api-Key'   : this._key,
+          'Content-Type': 'application/json',
+          'Accept'      : 'application/json',
+        },
+      };
+      if (payload) opts.headers['Content-Length'] = Buffer.byteLength(payload);
+
+      var lib = url.startsWith('https') ? https : http;
+      var req = lib.request(url, opts, (res) => {
+        var data = '';
+        res.on('data', (c) => data += c);
+        res.on('end', () => {
+          try {
+            var json = JSON.parse(data);
+            if (!json.success) return reject(new AmCoinError(json.error || 'Ошибка API', res.statusCode));
+            resolve(json);
+          } catch(e) {
+            reject(new AmCoinError('Неверный ответ сервера'));
+          }
+        });
+      });
+
+      req.setTimeout(this._timeout, () => {
+        req.destroy();
+        reject(new AmCoinError('Таймаут запроса'));
+      });
+
+      req.on('error', (e) => reject(new AmCoinError(e.message)));
+      if (payload) req.write(payload);
+      req.end();
+    });
+  }
+
+  _get(path)        { return this._request('GET',  path, null); }
+  _post(path, body) { return this._request('POST', path, body); }
+
+  // ─── BALANCE ────────────────────────────────────────────
+  async getBalance() {
+    return this._get('/balance');
+  }
+
+  // ─── TRANSFER ───────────────────────────────────────────
+  async transfer({ userId, amount, comment } = {}) {
+    if (!userId) throw new AmCoinError('userId обязателен');
+    if (!amount || amount <= 0) throw new AmCoinError('amount должен быть > 0');
+    return this._post('/transfer', { userId, amount, comment });
+  }
+
+  // ─── USER ───────────────────────────────────────────────
+  async getUser(userId) {
+    if (!userId) throw new AmCoinError('userId обязателен');
+    return this._get('/user/' + userId);
+  }
+
+  // ─── TRANSACTIONS ───────────────────────────────────────
+  async getTransactions({ type, limit, offset } = {}) {
+    var q = [];
+    if (type)   q.push('type='   + type);
+    if (limit)  q.push('limit='  + limit);
+    if (offset) q.push('offset=' + offset);
+    return this._get('/transactions' + (q.length ? '?' + q.join('&') : ''));
+  }
+
+  // ─── WEBHOOK ────────────────────────────────────────────
+  async setWebhook(url) {
+    return this._post('/webhook/set', { url: url || '' });
+  }
+
+  async removeWebhook() {
+    return this._post('/webhook/set', { url: '' });
+  }
+
+  /**
+   * Запускает локальный HTTP сервер для приёма вебхуков.
+   * Эмитит события: 'invoice_paid', 'payment'
+   *
+   * amcoin.listenWebhook({ port: 3000, path: '/webhook' })
+   * amcoin.on('invoice_paid', (data) => console.log(data))
+   */
+  listenWebhook({ port, path: whPath } = {}) {
+    whPath = whPath || '/webhook';
+    port   = port   || 3000;
+
+    var server = http.createServer((req, res) => {
+      if (req.method !== 'POST' || req.url !== whPath) {
+        res.writeHead(404); res.end(); return;
+      }
+      var data = '';
+      req.on('data', (c) => data += c);
+      req.on('end', () => {
+        try {
+          var json = JSON.parse(data);
+          if (json.event) this.emit(json.event, json);
+          this.emit('update', json);
+        } catch(e) {}
+        res.writeHead(200); res.end('OK');
+      });
+    });
+
+    server.listen(port, () => {
+      console.log('[AmCoin] Webhook слушает на порту ' + port + whPath);
+    });
+
+    this._webhook = server;
+    return server;
+  }
+
+  stopWebhook() {
+    if (this._webhook) { this._webhook.close(); this._webhook = null; }
+  }
+}
+
+// ─── INVOICE MODULE ─────────────────────────────────────────
+class InvoiceModule {
+  constructor(client) { this._c = client; }
+
+  async create({ amount, description, externalId, expiresInMinutes } = {}) {
+    if (!amount || amount <= 0) throw new AmCoinError('amount должен быть > 0');
+    return this._c._post('/invoice/create', { amount, description, externalId, expiresInMinutes });
+  }
+
+  async get(id) {
+    if (!id) throw new AmCoinError('id обязателен');
+    return this._c._get('/invoice/' + id);
+  }
+
+  async cancel(id) {
+    if (!id) throw new AmCoinError('id обязателен');
+    return this._c._post('/invoice/' + id + '/cancel');
+  }
+
+  async list({ status, limit, offset } = {}) {
+    var q = [];
+    if (status) q.push('status=' + status);
+    if (limit)  q.push('limit='  + limit);
+    if (offset) q.push('offset=' + offset);
+    return this._c._get('/invoices' + (q.length ? '?' + q.join('&') : ''));
+  }
+
+  /**
+   * Ждёт оплаты инвойса — резолвится когда статус станет 'paid'.
+   * Опционально: timeout в мс (по умолч. 30 минут), interval в мс (по умолч. 3 сек)
+   */
+  waitForPayment(id, { timeout, interval } = {}) {
+    timeout  = timeout  || 30 * 60 * 1000;
+    interval = interval || 3000;
+    return new Promise((resolve, reject) => {
+      var elapsed = 0;
+      var timer = setInterval(async () => {
+        elapsed += interval;
+        if (elapsed >= timeout) {
+          clearInterval(timer);
+          return reject(new AmCoinError('Таймаут ожидания оплаты'));
+        }
+        try {
+          var inv = await this.get(id);
+          if (inv.status === 'paid')      { clearInterval(timer); resolve(inv); }
+          if (inv.status === 'expired')   { clearInterval(timer); reject(new AmCoinError('Инвойс истёк')); }
+          if (inv.status === 'cancelled') { clearInterval(timer); reject(new AmCoinError('Инвойс отменён')); }
+        } catch(e) { clearInterval(timer); reject(e); }
+      }, interval);
+    });
+  }
+}
+
+// ─── CHECK MODULE ────────────────────────────────────────────
+class CheckModule {
+  constructor(client) { this._c = client; }
+
+  async create({ amount, activations } = {}) {
+    if (!amount || amount <= 0) throw new AmCoinError('amount должен быть > 0');
+    return this._c._post('/check/create', { amount, activations });
+  }
+
+  async get(id) {
+    if (!id) throw new AmCoinError('id обязателен');
+    return this._c._get('/check/' + id);
+  }
+}
+
+module.exports = AmCoin;
+module.exports.AmCoinError = AmCoinError;

package/package.json

@@ -0,0 +1,9 @@
+{
+  "name": "amcoin-sdk",
+  "version": "1.0.0",
+  "description": "Official AmCoin Merchant API SDK",
+  "main": "index.js",
+  "license": "MIT",
+  "keywords": ["amcoin", "payment", "telegram", "crypto"],
+  "author": "AmCoin"
+}