@crediblemark/buayar 0.4.0 → 0.6.0

package/dist/cli/index.js

@@ -0,0 +1,643 @@
+#!/usr/bin/env node
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+
+// src/cli/index.ts
+var path2 = __toESM(require("path"));
+var fs2 = __toESM(require("fs"));
+var p2 = __toESM(require("@clack/prompts"));
+
+// src/cli/templates.ts
+var DOT_ENV_TEMPLATE = `# \u2500\u2500 @crediblemark/buayar \xB7 Konfigurasi \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+# Provider aktif (salah satu dari 19): midtrans, duitku, ipaymu, xendit, doku,
+# prismalink, faspay, finpay, nicepay, oy, stripe, paypal, adyen, checkoutcom,
+# razorpay, square, payu, braintree, twocheckout
+PROVIDER_PG=midtrans
+
+# Kredensial Universal (dipetakan otomatis per provider)
+BUAYAR_API_KEY=your-server-key-atau-secret
+BUAYAR_MERCHANT_CODE=merchant-id-atau-username
+BUAYAR_SANDBOX=true
+
+# Callback & Return URL
+BUAYAR_CALLBACK_URL=http://localhost:3000/api/payment/webhook
+BUAYAR_RETURN_URL=http://localhost:3000/payment/success
+
+# \u2500\u2500 Kredensial Spesifik Provider (isi sesuai yang aktif saja) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+# MIDTRANS_SERVER_KEY=
+# MIDTRANS_CLIENT_KEY=
+# DUITKU_API_KEY=
+# DUITKU_MERCHANT_CODE=
+# IPAYMU_API_KEY=
+# IPAYMU_VA=
+# XENDIT_SECRET_KEY=
+# XENDIT_WEBHOOK_TOKEN=
+# DOKU_CLIENT_ID=
+# DOKU_SECRET_KEY=
+# PRISMALINK_MERCHANT_ID=
+# PRISMALINK_SECRET_KEY=
+# FASPAY_MERCHANT_ID=
+# FASPAY_USER_ID=
+# FASPAY_PASSWORD=
+# FINPAY_MERCHANT_ID=
+# FINPAY_MERCHANT_KEY=
+# NICEPAY_IMID=
+# NICEPAY_KEY=
+# OY_USERNAME=
+# OY_API_KEY=
+# STRIPE_SECRET_KEY=
+# STRIPE_PUBLIC_KEY=
+# STRIPE_WEBHOOK_SECRET=
+# PAYPAL_CLIENT_ID=
+# PAYPAL_CLIENT_SECRET=
+# PAYPAL_WEBHOOK_ID=
+# ADYEN_API_KEY=
+# ADYEN_MERCHANT_ACCOUNT=
+# ADYEN_HMAC_KEY=
+# CHECKOUTCOM_SECRET_KEY=
+# CHECKOUTCOM_WEBHOOK_SECRET=
+# RAZORPAY_KEY_ID=
+# RAZORPAY_KEY_SECRET=
+# RAZORPAY_WEBHOOK_SECRET=
+# SQUARE_ACCESS_TOKEN=
+# SQUARE_LOCATION_ID=
+# PAYU_POS_ID=
+# PAYU_MD5_KEY=
+# BRAINTREE_MERCHANT_ID=
+# BRAINTREE_PUBLIC_KEY=
+# BRAINTREE_PRIVATE_KEY=
+# TWOCHECKOUT_MERCHANT_CODE=
+# TWOCHECKOUT_SECRET_KEY=
+# TWOCHECKOUT_SECRET_WORD=
+`;
+var CONFIG_TEMPLATE = `// src/payment/buayar.ts
+// Inisialisasi Buayar \u2014 baca otomatis dari process.env (.env)
+import { buayar } from "@crediblemark/buayar";
+
+export { buayar };
+
+// Bila perlu inisialisasi programatik (menggantikan .env):
+// export const buayar = new Buayar({
+//   provider: "midtrans",
+//   apiKey: "SB-Mid-server-xxxx",
+//   sandbox: true,
+// });
+`;
+var SERVICE_TEMPLATE = `// src/payment/service.ts
+// Service layer \u2014 satu-satunya tempat aplikasi berinteraksi dengan Buayar.
+// Ganti provider cukup dengan ubah .env; kode ini tidak berubah.
+import { buayar } from "./buayar";
+
+export interface PaymentService {
+  createCheckout(input: {
+    orderId: string;
+    amount: number;
+    productDetails: string;
+    customer: { name: string; email: string; phone?: string };
+    paymentMethod?: string;
+    currency?: string;
+  }): Promise<any>;
+  getMethods(amount?: number): Promise<any>;
+  checkStatus(orderId: string): Promise<any>;
+  handleWebhook(payload: any, headers: Record<string, string | string[] | undefined>): Promise<any>;
+  refund(transactionId: string, amount?: number, reason?: string): Promise<any>;
+  checkBalance(): Promise<any>;
+  disburse(payload: {
+    externalId: string;
+    bankCode: string;
+    accountNumber: string;
+    amount: number;
+    accountHolderName?: string;
+    description?: string;
+  }): Promise<any>;
+}
+
+export const paymentService: PaymentService = {
+  async createCheckout({ orderId, amount, productDetails, customer, paymentMethod, currency }) {
+    return buayar.createInvoice({
+      orderId,
+      amount,
+      productDetails,
+      customer,
+      paymentMethod,
+      currency,
+    });
+  },
+
+  async getMethods(amount = 10000) {
+    return buayar.getPaymentMethods({ amount });
+  },
+
+  async checkStatus(orderId) {
+    return buayar.checkTransaction({ merchantOrderId: orderId });
+  },
+
+  async handleWebhook(payload, headers) {
+    return buayar.verifyWebhook(payload, headers);
+  },
+
+  async refund(transactionId, amount, reason) {
+    return buayar.refund({ transactionId, amount, reason });
+  },
+
+  async checkBalance() {
+    return buayar.checkBalance();
+  },
+
+  async disburse({ externalId, bankCode, accountNumber, amount, accountHolderName, description }) {
+    return buayar.disburse({
+      externalId,
+      bankCode,
+      accountNumber,
+      amount,
+      accountHolderName,
+      description,
+    });
+  },
+};
+`;
+var ROUTES_EXPRESS_TEMPLATE = `// src/payment/routes/express.ts
+// Controller + route untuk Express. Mount via:
+//   import { paymentRoutes } from "./payment/routes/express";
+//   app.use("/api/payment", paymentRoutes);
+import { Router } from "express";
+import { paymentService } from "../service";
+
+export const paymentRoutes = Router();
+
+// POST /api/payment/checkout \u2014 buat transaksi (redirect / direct)
+paymentRoutes.post("/checkout", async (req, res) => {
+  const result = await paymentService.createCheckout(req.body);
+  res.status(result.success ? 200 : 400).json(result);
+});
+
+// GET /api/payment/methods \u2014 daftar channel pembayaran
+paymentRoutes.get("/methods", async (req, res) => {
+  const amount = Number(req.query.amount) || 10000;
+  const result = await paymentService.getMethods(amount);
+  res.json(result);
+});
+
+// GET /api/payment/status/:orderId \u2014 cek status transaksi
+paymentRoutes.get("/status/:orderId", async (req, res) => {
+  const result = await paymentService.checkStatus(req.params.orderId);
+  res.json(result);
+});
+
+// POST /api/payment/webhook \u2014 notifikasi dari payment gateway
+paymentRoutes.post("/webhook", async (req, res) => {
+  const verification = await paymentService.handleWebhook(req.body, req.headers as any);
+  return verification.isValid
+    ? res.status(200).json({ status: "OK" })
+    : res.status(400).json({ error: "Invalid signature" });
+});
+
+// POST /api/payment/refund \u2014 refund transaksi
+paymentRoutes.post("/refund", async (req, res) => {
+  const { transactionId, amount, reason } = req.body;
+  const result = await paymentService.refund(transactionId, amount, reason);
+  res.json(result);
+});
+
+// GET /api/payment/balance \u2014 cek saldo merchant
+paymentRoutes.get("/balance", async (_req, res) => {
+  res.json(await paymentService.checkBalance());
+});
+`;
+var ROUTES_HONO_TEMPLATE = `// src/payment/routes/hono.ts
+// Controller + route untuk Hono. Mount via:
+//   app.route("/api/payment", paymentRoutes);
+import { Hono } from "hono";
+import { paymentService } from "../service";
+
+export const paymentRoutes = new Hono();
+
+paymentRoutes.post("/checkout", async (c) => {
+  const body = await c.req.json();
+  const result = await paymentService.createCheckout(body);
+  return c.json(result, result.success ? 200 : 400);
+});
+
+paymentRoutes.get("/methods", async (c) => {
+  const amount = Number(c.req.query("amount")) || 10000;
+  return c.json(await paymentService.getMethods(amount));
+});
+
+paymentRoutes.get("/status/:orderId", async (c) => {
+  return c.json(await paymentService.checkStatus(c.req.param("orderId")));
+});
+
+paymentRoutes.post("/webhook", async (c) => {
+  const payload = await c.req.json();
+  const headers = c.req.raw.headers;
+  const verification = await paymentService.handleWebhook(payload, Object.fromEntries(headers) as any);
+  return verification.isValid
+    ? c.json({ status: "OK" }, 200)
+    : c.json({ error: "Invalid signature" }, 400);
+});
+
+paymentRoutes.post("/refund", async (c) => {
+  const { transactionId, amount, reason } = await c.req.json();
+  return c.json(await paymentService.refund(transactionId, amount, reason));
+});
+
+paymentRoutes.get("/balance", async (c) => {
+  return c.json(await paymentService.checkBalance());
+});
+`;
+var ROUTES_NEXTJS_TEMPLATE = `// src/app/api/payment/webhook/route.ts
+// Route handler untuk Next.js App Router.
+// Jalankan: npm run build && npm run start
+import { NextResponse } from "next/server";
+import { paymentService } from "@/payment/service";
+
+export async function POST(request: Request) {
+  const payload = await request.json();
+  const headers: Record<string, string | string[] | undefined> = {};
+  request.headers.forEach((value, key) => {
+    headers[key] = value;
+  });
+
+  const verification = await paymentService.handleWebhook(payload, headers);
+
+  return verification.isValid
+    ? NextResponse.json({ status: "OK" })
+    : NextResponse.json({ error: "Invalid signature" }, { status: 400 });
+}
+`;
+var README_PAYMENT_TEMPLATE = (framework, provider) => `# \u{1F4B3} Payment \u2014 @crediblemark/buayar
+
+Scaffold dibuat otomatis oleh \`buayar init\`.
+
+- **Provider aktif:** \`${provider}\` (ganti di \`.env\` \u2192 \`PROVIDER_PG\`)
+- **Framework route:** \`${framework}\`
+
+## Struktur
+\`\`\`
+src/payment/
+\u251C\u2500\u2500 buayar.ts          # Inisialisasi Buayar (baca .env)
+\u251C\u2500\u2500 service.ts         # Service layer wrapper \u2014 semua interaksi lewat sini
+\u2514\u2500\u2500 routes/            # Controller/route per framework
+\`\`\`
+
+## Alur
+1. Salin \`.env.example\` ke \`.env\` dan isi kredensial.
+2. Mount route (lihat template framework di folder \`routes/\`).
+3. Frontend: panggil \`POST /api/payment/checkout\` \u2192 terima \`paymentUrl\` (redirect) atau \`vaNumber\`/\`qrString\` (direct).
+4. Notifikasi masuk ke \`POST /api/payment/webhook\` \u2192 diverifikasi otomatis.
+
+## Ganti Provider
+Ubah \`PROVIDER_PG\` + kredensial di \`.env\`. Kode \`service.ts\`/route **tidak berubah**.
+
+> Dokumentasi lengkap: https://github.com/crediblemark-official/Buayar#readme
+`;
+var TYPE_DECL_TEMPLATE = `// src/payment/types.ts
+// Tipe-tipe hasil dari Buayar (dapat disesuaikan)
+export interface CheckoutResult {
+  success: boolean;
+  provider?: string;
+  orderId?: string;
+  paymentUrl?: string;
+  reference?: string;
+  vaNumber?: string;
+  qrString?: string;
+  paymentCode?: string;
+  deeplink?: string;
+  error?: string;
+}
+
+export interface WebhookVerification {
+  isValid: boolean;
+  provider?: string;
+  orderId: string;
+  amount: number;
+  isPaid: boolean;
+  status: "paid" | "pending" | "failed" | "expired";
+}
+`;
+var PROVIDERS = [
+  "midtrans",
+  "duitku",
+  "ipaymu",
+  "xendit",
+  "doku",
+  "prismalink",
+  "faspay",
+  "finpay",
+  "nicepay",
+  "oy",
+  "stripe",
+  "paypal",
+  "adyen",
+  "checkoutcom",
+  "razorpay",
+  "square",
+  "payu",
+  "braintree",
+  "twocheckout"
+];
+var FRAMEWORKS = ["express", "hono", "nextjs"];
+function getRouteTemplate(framework) {
+  switch (framework) {
+    case "hono":
+      return ROUTES_HONO_TEMPLATE;
+    case "nextjs":
+      return ROUTES_NEXTJS_TEMPLATE;
+    case "express":
+    default:
+      return ROUTES_EXPRESS_TEMPLATE;
+  }
+}
+function buildScaffold(provider, framework) {
+  const routeRel = framework === "nextjs" ? "src/app/api/payment/webhook/route.ts" : "src/payment/routes/index.ts";
+  return {
+    ".env.example": DOT_ENV_TEMPLATE,
+    "src/payment/buayar.ts": CONFIG_TEMPLATE,
+    "src/payment/service.ts": SERVICE_TEMPLATE,
+    "src/payment/types.ts": TYPE_DECL_TEMPLATE,
+    [routeRel]: getRouteTemplate(framework),
+    "README-PAYMENT.md": README_PAYMENT_TEMPLATE(framework, provider)
+  };
+}
+
+// src/cli/prompts.ts
+var p = __toESM(require("@clack/prompts"));
+async function selectPrompt(message, choices, initialValue) {
+  const result = await p.select({
+    message,
+    initialValue,
+    options: choices.map((c) => {
+      const opt = {
+        value: c.value,
+        label: c.label || c.value
+      };
+      if (c.hint) opt.hint = c.hint;
+      return opt;
+    })
+  });
+  if (p.isCancel(result)) {
+    p.cancel("Dibatalkan oleh user.");
+    process.exit(0);
+  }
+  return result;
+}
+async function confirmPrompt(message, initialValue = true) {
+  const result = await p.confirm({
+    message,
+    initialValue
+  });
+  if (p.isCancel(result)) {
+    p.cancel("Dibatalkan oleh user.");
+    process.exit(0);
+  }
+  return result;
+}
+
+// src/cli/scaffold.ts
+var fs = __toESM(require("fs"));
+var path = __toESM(require("path"));
+function scaffold(targetDir, provider, framework, opts = {}) {
+  const files = buildScaffold(provider, framework);
+  const written = [];
+  const skipped = [];
+  const copied = [];
+  const errors = [];
+  if (!fs.existsSync(targetDir)) {
+    fs.mkdirSync(targetDir, { recursive: true });
+  }
+  for (const [relPath, content] of Object.entries(files)) {
+    const fullPath = path.join(targetDir, relPath);
+    const dir = path.dirname(fullPath);
+    try {
+      fs.mkdirSync(dir, { recursive: true });
+      if (fs.existsSync(fullPath) && !opts.overwrite) {
+        skipped.push(relPath);
+        continue;
+      }
+      fs.writeFileSync(fullPath, content, "utf8");
+      written.push(relPath);
+    } catch (e) {
+      errors.push(`${relPath}: ${e.message}`);
+    }
+  }
+  const envExample = path.join(targetDir, ".env.example");
+  const env = path.join(targetDir, ".env");
+  if (fs.existsSync(envExample) && !fs.existsSync(env)) {
+    try {
+      fs.copyFileSync(envExample, env);
+      copied.push(".env");
+    } catch (e) {
+      errors.push(`.env: ${e.message}`);
+    }
+  }
+  return { written, skipped, copied, errors };
+}
+function printScaffoldSummary(result) {
+  const color = (c, s) => process.stdout.isTTY ? `\x1B[${c}m${s}\x1B[0m` : s;
+  if (result.written.length) {
+    console.log(color("32", "\n\u2714 File dibuat:"));
+    for (const f of result.written) console.log(`  ${color("36", f)}`);
+  }
+  if (result.copied.length) {
+    console.log(color("32", "\n\u21AA Disalin dari .env.example (karena .env belum ada):"));
+    for (const f of result.copied) console.log(`  ${color("36", f)}`);
+  }
+  if (result.skipped.length) {
+    console.log(color("33", "\n\u2022 Dilewati (sudah ada, gunakan --force untuk menimpa):"));
+    for (const f of result.skipped) console.log(`  ${color("36", f)}`);
+  }
+  if (result.errors.length) {
+    console.log(color("31", "\n\u2716 Error:"));
+    for (const e of result.errors) console.log(`  ${color("31", e)}`);
+  }
+}
+
+// src/cli/index.ts
+var VERSION = "0.5.0";
+function parseArgs(argv) {
+  const flags = [];
+  const rest = [];
+  let i = 0;
+  while (i < argv.length) {
+    const a = argv[i];
+    if (a.startsWith("--")) {
+      const idx = a.indexOf("=");
+      if (idx !== -1) {
+        flags.push({ flag: a.slice(2, idx), value: a.slice(idx + 1) });
+        i++;
+        continue;
+      }
+      const name = a.slice(2);
+      const next = argv[i + 1];
+      if (next !== void 0 && !next.startsWith("-")) {
+        flags.push({ flag: name, value: next });
+        i += 2;
+      } else {
+        flags.push({ flag: name, value: void 0 });
+        i++;
+      }
+    } else if (a.startsWith("-") && a.length === 2) {
+      flags.push({ flag: a.slice(1), value: void 0 });
+      i++;
+    } else {
+      rest.push(a);
+      i++;
+    }
+  }
+  const command = rest.shift() || "init";
+  return { command, flags, rest };
+}
+function getFlag(flags, name) {
+  const found = flags.find((f) => f.flag === name);
+  if (found) {
+    if (found.value !== void 0) return found.value;
+    return "";
+  }
+  return void 0;
+}
+function hasFlag(flags, name) {
+  return flags.some((f) => f.flag === name);
+}
+function printHelp() {
+  console.log(`
+@crediblemark/buayar \u2014 Unified Payment Gateway SDK
+
+Usage:
+  buayar init                    Scaffold boilerplate (interaktif, arrow-key)
+  buayar init --yes              Scaffold non-interaktif (defaults)
+  buayar init --out <dir>        Direktori target (default: ./)
+  buayar init --provider <id>    Paksa provider (default: midtrans)
+  buayar init --framework <fw>   express | hono | nextjs (default: express)
+  buayar init --force            Timpa file yang sudah ada
+  buayar --version | -v          Tampilkan versi
+  buayar --help | -h             Tampilkan bantuan
+
+Contoh:
+  buayar init --yes --framework hono --provider xendit
+`);
+}
+async function runInit(argv) {
+  const { flags } = parseArgs(argv);
+  const yes = hasFlag(flags, "yes");
+  const force = hasFlag(flags, "force");
+  const outRaw = getFlag(flags, "out");
+  const targetDir = outRaw ? outRaw === "" ? "./" : outRaw : "./";
+  const resolvedDir = path2.resolve(targetDir);
+  p2.intro("\u{1F40A} Buayar init \u2014 Unified Payment Gateway scaffold");
+  let provider = getFlag(flags, "provider") || void 0;
+  if (!provider && !yes) {
+    provider = await selectPrompt(
+      "Pilih provider aktif",
+      PROVIDERS.map((value) => ({
+        value,
+        hint: value === "midtrans" ? "populer di Indonesia" : void 0
+      })),
+      "midtrans"
+    );
+  }
+  provider = provider || "midtrans";
+  if (!PROVIDERS.includes(provider)) {
+    p2.cancel(`Provider tidak dikenal: "${provider}"`);
+    return 1;
+  }
+  let framework = getFlag(flags, "framework") || void 0;
+  if (!framework && !yes) {
+    framework = await selectPrompt(
+      "Pilih framework route",
+      [
+        { value: "express", hint: "Node.js REST API" },
+        { value: "hono", hint: "Ringan, edge-ready" },
+        { value: "nextjs", hint: "App Router" }
+      ],
+      "express"
+    );
+  }
+  framework = framework || "express";
+  if (!FRAMEWORKS.includes(framework)) {
+    p2.cancel(`Framework tidak dikenal: "${framework}"`);
+    return 1;
+  }
+  if (!yes && !fs2.existsSync(path2.join(resolvedDir, "package.json"))) {
+    const cont = await confirmPrompt(
+      `"${resolvedDir}" bukan proyek Node yang terlihat. Lanjutkan?`,
+      true
+    );
+    if (!cont) {
+      p2.outro("Dibatalkan.");
+      return 0;
+    }
+  }
+  if (!yes) {
+    const ok = await confirmPrompt(
+      `Scaffold ${framework} (provider ${provider}) ke "${resolvedDir}"?`,
+      true
+    );
+    if (!ok) {
+      p2.outro("Dibatalkan.");
+      return 0;
+    }
+  }
+  const result = scaffold(resolvedDir, provider, framework, { overwrite: force });
+  printScaffoldSummary(result);
+  p2.outro(`
+Selesai! Langkah berikutnya:
+  1. Salin .env.example ke .env & isi kredensial (PROVIDER_PG + key provider aktif).
+  2. Mount route payment (lihat README-PAYMENT.md).
+  3. Ganti provider cukup ubah .env \u2014 kode tidak berubah.
+`);
+  return result.errors.length ? 1 : 0;
+}
+async function main() {
+  const argv = process.argv.slice(2);
+  const { command, flags } = parseArgs(argv);
+  if (argv.length === 0 || command === "init") {
+    if (hasFlag(flags, "version") || hasFlag(flags, "v")) {
+      console.log(VERSION);
+      return 0;
+    }
+    if (hasFlag(flags, "help") || hasFlag(flags, "h")) {
+      printHelp();
+      return 0;
+    }
+    return runInit(argv);
+  }
+  if (command === "--version" || command === "-v" || command === "version") {
+    console.log(VERSION);
+    return 0;
+  }
+  if (command === "--help" || command === "-h" || command === "help") {
+    printHelp();
+    return 0;
+  }
+  console.error(`
+\u2716 Perintah tidak dikenal: "${command}"`);
+  printHelp();
+  return 1;
+}
+main().then((code) => {
+  process.exitCode = code;
+}).catch((e) => {
+  console.error(e);
+  process.exitCode = 1;
+});