bazik-sdk 1.0.1 → 1.0.2

package/CHANGELOG.md

@@ -1,3 +1,5 @@
 # Changelog
 
+## [1.0.2](https://github.com/josephjoberno/basik-sdk/compare/v1.0.1...v1.0.2) (2026-07-02)
+
 ## 1.0.1 (2026-02-28)

package/README.md

@@ -109,6 +109,31 @@ const natTransfer = await bazik.transfers.natcash({
 });
 ```
 
+### Withdraw to a MonCash Wallet
+
+Send money from your Bazik account to a customer's MonCash wallet (payout).
+
+```javascript
+const withdrawal = await bazik.payments.withdraw({
+  gdes: 500,                            // amount in HTG
+  wallet: "47556677",                   // recipient phone (8 or 11 digits)
+  customerFirstName: "Melissa",
+  customerLastName: "Francois",
+  description: "Weekly earnings",
+  referenceId: "PAYOUT-001",
+  customerEmail: "melissa@example.com",
+  webhookUrl: "https://mysite.com/webhook",
+});
+
+console.log("Transaction:", withdrawal.transaction_id);
+console.log("Status:     ", withdrawal.status);
+console.log("Total cost: ", withdrawal.total, withdrawal.currency);
+```
+
+Required fields: `gdes`, `wallet`, `customerFirstName`, `customerLastName`.
+The other fields are optional. The same typed errors apply — wrap calls in
+`try/catch` to handle `BazikInsufficientFundsError`, `BazikValidationError`, etc.
+
 ### Check Balance
 
 ```javascript

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bazik-sdk",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "Unofficial JavaScript/Node.js SDK for the Bazik API — MonCash & NatCash payments, transfers, and wallet management for Haiti.",
   "main": "src/index.js",
   "module": "src/index.mjs",

package/src/constants.js

@@ -0,0 +1,13 @@
+"use strict";
+
+// ─── Constants ───────────────────────────────────────────────────────────────
+
+const DEFAULT_BASE_URL = "https://api.bazik.io";
+const TOKEN_REFRESH_MARGIN_MS = 60 * 60 * 1000; // 1 hour before expiry
+const MAX_MONCASH_AMOUNT = 75_000;
+
+module.exports = {
+  DEFAULT_BASE_URL,
+  TOKEN_REFRESH_MARGIN_MS,
+  MAX_MONCASH_AMOUNT,
+};

package/src/errors/BazikAuthError.js

@@ -0,0 +1,12 @@
+"use strict";
+
+const BazikError = require("./BazikError");
+
+class BazikAuthError extends BazikError {
+  constructor(message, status, code, details) {
+    super(message, status, code, details);
+    this.name = "BazikAuthError";
+  }
+}
+
+module.exports = BazikAuthError;

package/src/errors/BazikError.js

@@ -0,0 +1,21 @@
+"use strict";
+
+// ─── Errors ──────────────────────────────────────────────────────────────────
+
+class BazikError extends Error {
+  /**
+   * @param {string} message
+   * @param {number} [status]
+   * @param {string} [code]
+   * @param {*} [details]
+   */
+  constructor(message, status, code, details) {
+    super(message);
+    this.name = "BazikError";
+    this.status = status ?? null;
+    this.code = code ?? null;
+    this.details = details ?? null;
+  }
+}
+
+module.exports = BazikError;

package/src/errors/BazikInsufficientFundsError.js

@@ -0,0 +1,12 @@
+"use strict";
+
+const BazikError = require("./BazikError");
+
+class BazikInsufficientFundsError extends BazikError {
+  constructor(message, details) {
+    super(message, 402, "insufficient_funds", details);
+    this.name = "BazikInsufficientFundsError";
+  }
+}
+
+module.exports = BazikInsufficientFundsError;

package/src/errors/BazikRateLimitError.js

@@ -0,0 +1,12 @@
+"use strict";
+
+const BazikError = require("./BazikError");
+
+class BazikRateLimitError extends BazikError {
+  constructor(message, details) {
+    super(message, 429, "rate_limit_exceeded", details);
+    this.name = "BazikRateLimitError";
+  }
+}
+
+module.exports = BazikRateLimitError;

package/src/errors/BazikValidationError.js

@@ -0,0 +1,12 @@
+"use strict";
+
+const BazikError = require("./BazikError");
+
+class BazikValidationError extends BazikError {
+  constructor(message, details) {
+    super(message, 400, "validation_error", details);
+    this.name = "BazikValidationError";
+  }
+}
+
+module.exports = BazikValidationError;

package/src/helpers/validateAmount.js

@@ -0,0 +1,23 @@
+"use strict";
+
+const BazikValidationError = require("../errors/BazikValidationError");
+
+/**
+ * Validate a positive numeric amount.
+ * @param {number} amount
+ * @param {number} [max]
+ */
+function validateAmount(amount, max) {
+  if (typeof amount !== "number" || !isFinite(amount) || amount <= 0) {
+    throw new BazikValidationError(
+      `Invalid amount: ${amount}. Must be a positive number.`
+    );
+  }
+  if (max !== undefined && amount > max) {
+    throw new BazikValidationError(
+      `Amount ${amount} exceeds maximum of ${max} HTG.`
+    );
+  }
+}
+
+module.exports = validateAmount;

package/src/helpers/validateRequired.js

@@ -0,0 +1,21 @@
+"use strict";
+
+const BazikValidationError = require("../errors/BazikValidationError");
+
+/**
+ * Validate that required fields are present in an object.
+ * @param {Record<string, *>} obj
+ * @param {string[]} fields
+ */
+function validateRequired(obj, fields) {
+  const missing = fields.filter(
+    (f) => obj[f] === undefined || obj[f] === null || obj[f] === ""
+  );
+  if (missing.length > 0) {
+    throw new BazikValidationError(
+      `Missing required field(s): ${missing.join(", ")}`
+    );
+  }
+}
+
+module.exports = validateRequired;

package/src/helpers/validateWallet.js

@@ -0,0 +1,19 @@
+"use strict";
+
+const BazikValidationError = require("../errors/BazikValidationError");
+
+// ─── Helpers ─────────────────────────────────────────────────────────────────
+
+/**
+ * Validate that a wallet number is 8 or 11 digits.
+ * @param {string} wallet
+ */
+function validateWallet(wallet) {
+  if (typeof wallet !== "string" || !/^\d{8}(\d{3})?$/.test(wallet)) {
+    throw new BazikValidationError(
+      `Invalid wallet number "${wallet}". Must be 8 or 11 digits.`
+    );
+  }
+}
+
+module.exports = validateWallet;

package/src/http/request.js

@@ -0,0 +1,37 @@
+"use strict";
+
+// ─── HTTP Client (zero dependencies) ─────────────────────────────────────────
+
+/**
+ * Minimal fetch wrapper.
+ * @param {string} url
+ * @param {RequestInit & { timeout?: number }} options
+ * @returns {Promise<{ status: number, data: * }>}
+ */
+async function request(url, options = {}) {
+  const { timeout = 30_000, ...fetchOptions } = options;
+
+  const controller = new AbortController();
+  const timer = setTimeout(() => controller.abort(), timeout);
+
+  try {
+    const res = await fetch(url, {
+      ...fetchOptions,
+      signal: controller.signal,
+    });
+
+    let data;
+    const contentType = res.headers.get("content-type") || "";
+    if (contentType.includes("application/json")) {
+      data = await res.json();
+    } else {
+      data = await res.text();
+    }
+
+    return { status: res.status, data };
+  } finally {
+    clearTimeout(timer);
+  }
+}
+
+module.exports = request;