@durrapay/sdk 0.1.0

package/README.md

@@ -0,0 +1,47 @@
+# @durrapay/sdk (Node)
+
+Thin, dependency-free client for the [DurraPay Platform API](https://developer.durrapay.com).
+Requires Node 18+.
+
+```bash
+npm install @durrapay/sdk
+```
+
+```js
+import { DurraPay } from '@durrapay/sdk'
+
+const dp = new DurraPay({
+  apiKey: process.env.DURRAPAY_KEY,          // dpk_test_... or dpk_live_...
+  // baseUrl: 'https://api.durrapay.com/v1',  // default
+})
+
+// Who am I?
+console.log(await dp.me())
+
+// Collect in Kenya (M-Pesa STK)
+const c = await dp.collections.stk({
+  phone: '254712345678',
+  amount_minor: 150000,           // KES 1,500.00 (minor units)
+  currency: 'KES',
+  reference: 'ORDER-1001',
+})
+
+// Poll status (or use webhooks)
+await dp.collections.get(c.payment_id)
+
+// Send cross-border (FX + payout)
+const quote = await dp.transfers.quote({ from_currency: 'KES', destination_country: 'TZ', from_amount_minor: 1000000 })
+await dp.transfers.create({
+  quote_id: quote.quote_id,
+  dest_type: 'PHONE',
+  dest_phone: '255712345678',
+  dest_name: 'Jane Doe',
+})
+
+// Customers, recipients, payment links, balances, usage…
+await dp.customers.create({ name: 'Jane Doe', email: 'jane@example.com' })
+await dp.balances()
+```
+
+Idempotency keys are auto-generated for POSTs (override with `{ idempotencyKey }`).
+Errors throw `DurraPayError` with `.status`, `.code`, and `.body`.

package/index.mjs

@@ -0,0 +1,101 @@
+// DurraPay Node SDK — a thin, dependency-free client for the /v1 Platform API.
+// Requires Node 18+ (global fetch).
+//
+//   import { DurraPay } from '@durrapay/sdk'
+//   const dp = new DurraPay({ apiKey: process.env.DURRAPAY_KEY })
+//   const me = await dp.me()
+
+import { randomUUID } from 'node:crypto'
+
+export class DurraPayError extends Error {
+  constructor(message, { status, code, body } = {}) {
+    super(message)
+    this.name = 'DurraPayError'
+    this.status = status
+    this.code = code
+    this.body = body
+  }
+}
+
+export class DurraPay {
+  constructor({ apiKey, baseUrl = 'https://api.durrapay.com/v1', fetch: fetchImpl } = {}) {
+    if (!apiKey) throw new Error('DurraPay: apiKey is required')
+    this._apiKey = apiKey
+    this._baseUrl = baseUrl.replace(/\/$/, '')
+    this._fetch = fetchImpl || globalThis.fetch
+  }
+
+  async _request(method, path, { body, idempotencyKey, query } = {}) {
+    let url = this._baseUrl + path
+    if (query) {
+      const qs = new URLSearchParams(
+        Object.entries(query).filter(([, v]) => v !== undefined && v !== null)
+      ).toString()
+      if (qs) url += '?' + qs
+    }
+    const headers = { 'X-DurraPay-API-Key': this._apiKey }
+    if (body) headers['Content-Type'] = 'application/json'
+    if (method === 'POST') headers['Idempotency-Key'] = idempotencyKey || randomUUID()
+
+    const res = await this._fetch(url, {
+      method,
+      headers,
+      body: body ? JSON.stringify(body) : undefined,
+    })
+    const json = await res.json().catch(() => ({}))
+    if (!res.ok || json.success === false) {
+      const err = json.error || {}
+      throw new DurraPayError(err.message || `HTTP ${res.status}`, {
+        status: res.status,
+        code: err.code,
+        body: json,
+      })
+    }
+    return json.data
+  }
+
+  // --- identity / account ---
+  me() { return this._request('GET', '/me') }
+  balances() { return this._request('GET', '/balances') }
+  usage(days = 30) { return this._request('GET', '/usage', { query: { days } }) }
+  corridors(from = 'KES') { return this._request('GET', '/corridors', { query: { from } }) }
+
+  // --- collections ---
+  collections = {
+    stk: (input, opts = {}) => this._request('POST', '/collections/stk', { body: input, idempotencyKey: opts.idempotencyKey }),
+    list: (query = {}) => this._request('GET', '/collections', { query }),
+    get: (id) => this._request('GET', `/collections/${id}`),
+  }
+
+  // --- payment links ---
+  paymentLinks = {
+    create: (input, opts = {}) => this._request('POST', '/payment-links', { body: input, idempotencyKey: opts.idempotencyKey }),
+    list: (query = {}) => this._request('GET', '/payment-links', { query }),
+    delete: (id) => this._request('DELETE', `/payment-links/${id}`),
+  }
+
+  // --- customers ---
+  customers = {
+    create: (input) => this._request('POST', '/customers', { body: input }),
+    list: (query = {}) => this._request('GET', '/customers', { query }),
+    get: (id) => this._request('GET', `/customers/${id}`),
+    delete: (id) => this._request('DELETE', `/customers/${id}`),
+  }
+
+  // --- recipients ---
+  recipients = {
+    create: (input) => this._request('POST', '/recipients', { body: input }),
+    list: () => this._request('GET', '/recipients'),
+    delete: (id) => this._request('DELETE', `/recipients/${id}`),
+  }
+
+  // --- transfers (cross-border send) ---
+  transfers = {
+    quote: (input) => this._request('POST', '/transfers/quote', { body: input }),
+    create: (input, opts = {}) => this._request('POST', '/transfers', { body: input, idempotencyKey: opts.idempotencyKey }),
+    list: (query = {}) => this._request('GET', '/transfers', { query }),
+    get: (id) => this._request('GET', `/transfers/${id}`),
+  }
+}
+
+export default DurraPay

package/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "@durrapay/sdk",
+  "version": "0.1.0",
+  "description": "DurraPay Platform API client for Node.js",
+  "type": "module",
+  "main": "index.mjs",
+  "exports": { ".": "./index.mjs" },
+  "engines": { "node": ">=18" },
+  "files": ["index.mjs", "README.md"],
+  "keywords": ["durrapay", "payments", "mpesa", "africa", "fintech"],
+  "license": "MIT",
+  "homepage": "https://developer.durrapay.com",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Durrafx-repos/durrapy-sdks.git",
+    "directory": "node"
+  },
+  "bugs": { "url": "https://github.com/Durrafx-repos/durrapy-sdks/issues" }
+}