coincircuit 0.1.2

package/dist/index.js

@@ -0,0 +1,482 @@
+// src/errors.ts
+var CoinCircuitError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "CoinCircuitError";
+  }
+};
+var CoinCircuitApiError = class extends CoinCircuitError {
+  statusCode;
+  path;
+  constructor(message, statusCode, path) {
+    super(message);
+    this.name = "CoinCircuitApiError";
+    this.statusCode = statusCode;
+    this.path = path;
+  }
+};
+var CoinCircuitAuthError = class extends CoinCircuitApiError {
+  constructor(message, statusCode, path) {
+    super(message, statusCode, path);
+    this.name = "CoinCircuitAuthError";
+  }
+};
+
+// src/client.ts
+var RETRYABLE_STATUS_CODES = /* @__PURE__ */ new Set([429, 500, 502, 503, 504]);
+var HttpClient = class {
+  apiKey;
+  baseUrl;
+  timeout;
+  maxRetries;
+  constructor(config) {
+    this.apiKey = config.apiKey;
+    this.baseUrl = (config.baseUrl ?? "https://api.coincircuit.io").replace(/\/$/, "");
+    this.timeout = config.timeout ?? 3e4;
+    this.maxRetries = config.maxRetries ?? 2;
+  }
+  async get(path, params) {
+    const url = this.buildUrl(path, params);
+    return this.request(url, { method: "GET" });
+  }
+  async getPaginated(path, params) {
+    const url = this.buildUrl(path, params);
+    const response = await this.rawRequest(url, { method: "GET" });
+    const body = await response.json();
+    if (!body.success) {
+      throw this.buildError(body, response.status, path);
+    }
+    return { data: body.data, meta: body.meta };
+  }
+  async post(path, body) {
+    const url = this.buildUrl(path);
+    return this.request(url, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: body != null ? JSON.stringify(body) : void 0
+    });
+  }
+  async patch(path, body) {
+    const url = this.buildUrl(path);
+    return this.request(url, {
+      method: "PATCH",
+      headers: { "Content-Type": "application/json" },
+      body: body != null ? JSON.stringify(body) : void 0
+    });
+  }
+  async delete(path) {
+    const url = this.buildUrl(path);
+    return this.request(url, { method: "DELETE" });
+  }
+  async request(url, init) {
+    const response = await this.rawRequest(url, init);
+    const body = await response.json();
+    if (!body.success) {
+      const path = new URL(url).pathname;
+      throw this.buildError(body, response.status, path);
+    }
+    return body.data;
+  }
+  async rawRequest(url, init) {
+    const headers = {
+      "x-api-key": this.apiKey,
+      ...init.headers ?? {}
+    };
+    let lastError;
+    for (let attempt = 0; attempt <= this.maxRetries; attempt++) {
+      try {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), this.timeout);
+        const response = await fetch(url, {
+          ...init,
+          headers,
+          signal: controller.signal
+        });
+        clearTimeout(timer);
+        if (RETRYABLE_STATUS_CODES.has(response.status) && attempt < this.maxRetries) {
+          const delay = Math.min(1e3 * Math.pow(2, attempt), 8e3);
+          await new Promise((r) => setTimeout(r, delay));
+          continue;
+        }
+        return response;
+      } catch (err) {
+        lastError = err;
+        if (attempt < this.maxRetries) {
+          const delay = Math.min(1e3 * Math.pow(2, attempt), 8e3);
+          await new Promise((r) => setTimeout(r, delay));
+          continue;
+        }
+      }
+    }
+    throw lastError ?? new Error("Request failed after retries");
+  }
+  buildUrl(path, params) {
+    const url = new URL(`${this.baseUrl}${path}`);
+    if (params) {
+      for (const [key, value] of Object.entries(params)) {
+        if (value !== void 0 && value !== null) {
+          url.searchParams.set(key, String(value));
+        }
+      }
+    }
+    return url.toString();
+  }
+  buildError(body, statusCode, path) {
+    const message = body?.message ?? "Unknown API error";
+    if (statusCode === 401 || statusCode === 403) {
+      return new CoinCircuitAuthError(message, statusCode, path);
+    }
+    return new CoinCircuitApiError(message, statusCode, path);
+  }
+};
+
+// src/pagination.ts
+function paginate(fetchPage, params = {}) {
+  return {
+    [Symbol.asyncIterator]() {
+      let currentPage = params.page ?? 1;
+      const size = params.size ?? 20;
+      let items = [];
+      let index = 0;
+      let totalPages = Infinity;
+      let fetched = false;
+      return {
+        async next() {
+          if (index < items.length) {
+            return { value: items[index++], done: false };
+          }
+          if (fetched && currentPage > totalPages) {
+            return { value: void 0, done: true };
+          }
+          const response = await fetchPage({ ...params, page: currentPage, size });
+          totalPages = response.meta.totalPages;
+          items = response.data;
+          index = 0;
+          currentPage++;
+          fetched = true;
+          if (items.length === 0) {
+            return { value: void 0, done: true };
+          }
+          return { value: items[index++], done: false };
+        }
+      };
+    }
+  };
+}
+
+// src/resources/payments.ts
+var Payments = class {
+  constructor(client) {
+    this.client = client;
+  }
+  async create(params) {
+    return this.client.post("/api/v1/payments", params);
+  }
+  async list(params) {
+    return this.client.getPaginated("/api/v1/payments", params);
+  }
+  listAutoPaginate(params) {
+    return paginate((p) => this.list(p), params);
+  }
+  async get(reference) {
+    return this.client.get(`/api/v1/payments/reference/${reference}`);
+  }
+  async generateAddress(reference, params) {
+    return this.client.post(`/api/v1/payments/${reference}/address`, params);
+  }
+  async estimate(params) {
+    return this.client.get("/api/v1/payments/estimate", params);
+  }
+};
+
+// src/resources/x402.ts
+var X402 = class {
+  constructor(client) {
+    this.client = client;
+  }
+  async settle(params) {
+    return this.client.post("/api/v1/payments/agent/settle", params);
+  }
+  async verify(params) {
+    return this.client.post("/api/v1/payments/agent/verify", params);
+  }
+};
+
+// src/resources/invoices.ts
+var Invoices = class {
+  constructor(client) {
+    this.client = client;
+  }
+  async create(params) {
+    return this.client.post("/api/v1/invoices", params);
+  }
+  async list(params) {
+    return this.client.getPaginated("/api/v1/invoices", params);
+  }
+  listAutoPaginate(params) {
+    return paginate((p) => this.list(p), params);
+  }
+  async get(reference) {
+    return this.client.get(`/api/v1/invoices/reference/${reference}`);
+  }
+};
+
+// src/resources/transactions.ts
+var Transactions = class {
+  constructor(client) {
+    this.client = client;
+  }
+  async list(params) {
+    return this.client.getPaginated("/api/v1/transactions", params);
+  }
+  listAutoPaginate(params) {
+    return paginate((p) => this.list(p), params);
+  }
+  async get(txHash) {
+    return this.client.get(`/api/v1/transactions/${txHash}`);
+  }
+};
+
+// src/resources/payouts.ts
+var Payouts = class {
+  constructor(client) {
+    this.client = client;
+  }
+  async create(params) {
+    return this.client.post("/api/v1/payouts", params);
+  }
+  async list(params) {
+    return this.client.getPaginated("/api/v1/payouts", params);
+  }
+  listAutoPaginate(params) {
+    return paginate((p) => this.list(p), params);
+  }
+  async get(id) {
+    return this.client.get(`/api/v1/payouts/${id}`);
+  }
+  async estimateFees(params) {
+    return this.client.get("/api/v1/payouts/fees", params);
+  }
+};
+
+// src/resources/balance.ts
+var Balance = class {
+  constructor(client) {
+    this.client = client;
+  }
+  async get() {
+    return this.client.get("/api/v1/balance");
+  }
+};
+
+// src/resources/blockchain.ts
+var Blockchain = class {
+  constructor(client) {
+    this.client = client;
+  }
+  async assets() {
+    return this.client.get("/api/v1/blockchain/assets");
+  }
+  async confirmations() {
+    return this.client.get("/api/v1/blockchain/confirmations");
+  }
+  async gasFees() {
+    return this.client.get("/api/v1/blockchain/gas-fees");
+  }
+};
+
+// src/resources/customers.ts
+var Customers = class {
+  constructor(client) {
+    this.client = client;
+  }
+  async create(params) {
+    return this.client.post("/api/v1/customers", params);
+  }
+  async list(params) {
+    return this.client.getPaginated("/api/v1/customers", params);
+  }
+  listAutoPaginate(params) {
+    return paginate((p) => this.list(p), params);
+  }
+  async get(id) {
+    return this.client.get(`/api/v1/customers/${id}`);
+  }
+};
+
+// src/resources/refunds.ts
+var Refunds = class {
+  constructor(client) {
+    this.client = client;
+  }
+  async createForSession(sessionReference, params) {
+    return this.client.post(`/api/v1/refunds/session/${sessionReference}`, params);
+  }
+  async createForInvoice(invoiceReference, params) {
+    return this.client.post(`/api/v1/refunds/invoice/${invoiceReference}`, params);
+  }
+  async list(params) {
+    return this.client.getPaginated("/api/v1/refunds", params);
+  }
+  listAutoPaginate(params) {
+    return paginate((p) => this.list(p), params);
+  }
+  async get(id) {
+    return this.client.get(`/api/v1/refunds/${id}`);
+  }
+  async estimate(reference) {
+    return this.client.get(`/api/v1/refunds/estimate/${reference}`);
+  }
+};
+
+// src/resources/settlements.ts
+var Settlements = class {
+  constructor(client) {
+    this.client = client;
+  }
+  async list(params) {
+    return this.client.getPaginated("/api/v1/settlements", params);
+  }
+  listAutoPaginate(params) {
+    return paginate((p) => this.list(p), params);
+  }
+  async get(reference) {
+    return this.client.get(`/api/v1/settlements/${reference}`);
+  }
+};
+
+// src/resources/rates.ts
+var Rates = class {
+  constructor(client) {
+    this.client = client;
+  }
+  async convert(params) {
+    return this.client.get("/api/v1/rates/convert", params);
+  }
+  async list(params) {
+    return this.client.get("/api/v1/rates", params);
+  }
+};
+
+// src/resources/payment-pages.ts
+var PaymentPages = class {
+  constructor(client) {
+    this.client = client;
+  }
+  async create(params) {
+    return this.client.post("/api/v1/payments/pages", params);
+  }
+  async list(params) {
+    return this.client.getPaginated("/api/v1/payments/pages", params);
+  }
+  listAutoPaginate(params) {
+    return paginate((p) => this.list(p), params);
+  }
+  async update(id, params) {
+    return this.client.patch(`/api/v1/payments/pages/${id}`, params);
+  }
+  async delete(id) {
+    return this.client.delete(`/api/v1/payments/pages/${id}`);
+  }
+  async sessions(reference, params) {
+    return this.client.getPaginated(`/api/v1/payments/pages/${reference}/sessions`, params);
+  }
+};
+
+// src/resources/bank-accounts.ts
+var BankAccounts = class {
+  constructor(client) {
+    this.client = client;
+  }
+  async create(params) {
+    return this.client.post("/api/v1/bank-accounts", params);
+  }
+  async list(params) {
+    return this.client.getPaginated("/api/v1/bank-accounts", params);
+  }
+  listAutoPaginate(params) {
+    return paginate((p) => this.list(p), params);
+  }
+  async get(id) {
+    return this.client.get(`/api/v1/bank-accounts/${id}`);
+  }
+  async update(id, params) {
+    return this.client.patch(`/api/v1/bank-accounts/${id}`, params);
+  }
+  async delete(id) {
+    return this.client.delete(`/api/v1/bank-accounts/${id}`);
+  }
+  async banks() {
+    return this.client.get("/api/v1/bank-accounts/banks");
+  }
+};
+
+// src/resources/crypto-addresses.ts
+var CryptoAddresses = class {
+  constructor(client) {
+    this.client = client;
+  }
+  async create(params) {
+    return this.client.post("/api/v1/crypto-addresses", params);
+  }
+  async list(params) {
+    return this.client.getPaginated("/api/v1/crypto-addresses", params);
+  }
+  listAutoPaginate(params) {
+    return paginate((p) => this.list(p), params);
+  }
+  async get(id) {
+    return this.client.get(`/api/v1/crypto-addresses/${id}`);
+  }
+  async update(id, params) {
+    return this.client.patch(`/api/v1/crypto-addresses/${id}`, params);
+  }
+  async delete(id) {
+    return this.client.delete(`/api/v1/crypto-addresses/${id}`);
+  }
+  async validate(params) {
+    return this.client.get("/api/v1/crypto-addresses/validate", params);
+  }
+};
+
+// src/index.ts
+var CoinCircuit = class {
+  payments;
+  x402;
+  invoices;
+  transactions;
+  payouts;
+  balance;
+  blockchain;
+  customers;
+  refunds;
+  settlements;
+  rates;
+  paymentPages;
+  bankAccounts;
+  cryptoAddresses;
+  constructor(config) {
+    const client = new HttpClient(config);
+    this.payments = new Payments(client);
+    this.x402 = new X402(client);
+    this.invoices = new Invoices(client);
+    this.transactions = new Transactions(client);
+    this.payouts = new Payouts(client);
+    this.balance = new Balance(client);
+    this.blockchain = new Blockchain(client);
+    this.customers = new Customers(client);
+    this.refunds = new Refunds(client);
+    this.settlements = new Settlements(client);
+    this.rates = new Rates(client);
+    this.paymentPages = new PaymentPages(client);
+    this.bankAccounts = new BankAccounts(client);
+    this.cryptoAddresses = new CryptoAddresses(client);
+  }
+};
+export {
+  CoinCircuit,
+  CoinCircuitApiError,
+  CoinCircuitAuthError,
+  CoinCircuitError,
+  paginate
+};

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "coincircuit",
+  "version": "0.1.2",
+  "description": "Official CoinCircuit Node.js SDK",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": ["dist"],
+  "scripts": {
+    "build": "tsup src/index.ts --format esm,cjs --dts --clean",
+    "generate-types": "npx openapi-typescript ../openapi.json -o src/types/generated.ts"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "keywords": ["coincircuit", "crypto", "payments", "stablecoin", "x402", "sdk"],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/coincircuit/coincircuit-node"
+  },
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "typescript": "^5.4.0",
+    "openapi-typescript": "^7.0.0"
+  }
+}