payweave 0.0.0

package/dist/chunk-FBPOCXRZ.js

@@ -0,0 +1,1135 @@
+import { defineProvider, FLW_V4_BASE_URL, FLW_V4_SANDBOX_URL, FLW_V3_BASE_URL, flutterwaveProviderConfigSchema, inferEnvironment, HttpClient, oauthClientCredentials, bearer, readHeader } from './chunk-IUVGM3K7.js';
+import { verifyFlutterwaveV4, verifyFlutterwaveV3 } from './chunk-CJEYDHY6.js';
+import { toUnifiedEventType } from './chunk-67NRYGRC.js';
+import { PayweaveConfigError, PayweaveValidationError } from './chunk-HTRGMZFH.js';
+import { z } from 'zod';
+import { createCipheriv, createDecipheriv } from 'crypto';
+
+function parseRequest(schema, input) {
+  try {
+    return schema.parse(input);
+  } catch (err) {
+    if (err instanceof z.ZodError) {
+      const detail = err.issues.map((i) => `${i.path.join(".") || "(root)"}: ${i.message}`).join("; ");
+      throw new PayweaveValidationError(`flutterwave request validation failed \u2014 ${detail}`, {
+        provider: "flutterwave",
+        cause: err
+      });
+    }
+    throw err;
+  }
+}
+var flwEnvelope = (data) => z.looseObject({
+  status: z.string(),
+  message: z.string(),
+  data
+});
+var pageInfo = z.looseObject({
+  total: z.union([z.number(), z.string()]).optional(),
+  current_page: z.union([z.number(), z.string()]).optional(),
+  total_pages: z.union([z.number(), z.string()]).optional()
+});
+var listMeta = z.looseObject({
+  page_info: pageInfo.optional()
+});
+var flwListEnvelope = (item) => z.looseObject({
+  status: z.string(),
+  message: z.string(),
+  data: z.array(item),
+  meta: listMeta.optional()
+});
+var metaSchema = z.record(z.string(), z.unknown());
+function metaNumber(value) {
+  if (typeof value === "number") return value;
+  if (typeof value === "string" && value.trim() !== "") {
+    const n = Number(value);
+    return Number.isFinite(n) ? n : void 0;
+  }
+  return void 0;
+}
+var paymentCustomer = z.object({
+  email: z.string(),
+  name: z.string().optional(),
+  phonenumber: z.string().optional()
+});
+var paymentCustomizations = z.object({
+  title: z.string().optional(),
+  description: z.string().optional(),
+  logo: z.string().optional()
+});
+var paymentSubaccount = z.looseObject({
+  id: z.string(),
+  transaction_split_ratio: z.number().optional(),
+  transaction_charge_type: z.string().optional(),
+  transaction_charge: z.number().optional()
+});
+var createPaymentReq = z.object({
+  /** Your unique transaction reference. Required. */
+  tx_ref: z.string(),
+  /** Amount in MAJOR units (e.g. 5000 = ₦5,000). Passed through unchanged. */
+  amount: z.union([z.number(), z.string()]),
+  /** ISO currency, e.g. "NGN". Defaults to NGN on Flutterwave's side if omitted. */
+  currency: z.string().optional(),
+  /** URL Flutterwave redirects to after payment. */
+  redirect_url: z.string().optional(),
+  customer: paymentCustomer,
+  /** Comma-separated payment methods, e.g. "card,banktransfer,ussd". */
+  payment_options: z.string().optional(),
+  customizations: paymentCustomizations.optional(),
+  /** Existing payment-plan id to subscribe the customer to. */
+  payment_plan: z.union([z.string(), z.number()]).optional(),
+  subaccounts: z.array(paymentSubaccount).optional(),
+  meta: metaSchema.optional(),
+  /** Checkout session lifetime in minutes. */
+  session_duration: z.number().optional(),
+  /** Max number of retries allowed on the checkout. */
+  max_retry_attempt: z.number().optional()
+});
+var paymentInitData = z.looseObject({
+  link: z.string()
+});
+
+// src/flutterwave/v3/resources/payments.ts
+var paymentInitRes = flwEnvelope(paymentInitData);
+var Payments = class {
+  constructor(http) {
+    this.http = http;
+  }
+  http;
+  /**
+   * Create a Standard payment and get a hosted checkout link. `amount` is in
+   * MAJOR units (e.g. `5000` = ₦5,000) and is sent to Flutterwave unchanged
+   * (Surface A). The checkout URL is returned at `data.link`.
+   *
+   * Docs: https://developer.flutterwave.com/v3.0.0/reference/standard
+   *
+   * @example
+   * const res = await fw.flutterwave.payments.create({
+   *   tx_ref: "pwv_tx_001",
+   *   amount: 5000, // ₦5,000 in major units
+   *   currency: "NGN",
+   *   redirect_url: "https://example.com/callback",
+   *   customer: { email: "buyer@example.com" },
+   * });
+   * console.log(res.data.link);
+   */
+  async create(input) {
+    const body = parseRequest(createPaymentReq, input);
+    return this.http.request({
+      method: "POST",
+      path: "/payments",
+      body,
+      schema: paymentInitRes
+    });
+  }
+};
+var transaction = z.looseObject({
+  id: z.number(),
+  tx_ref: z.string().nullable().optional(),
+  flw_ref: z.string().nullable().optional(),
+  device_fingerprint: z.string().nullable().optional(),
+  amount: z.number().optional(),
+  currency: z.string().optional(),
+  charged_amount: z.number().optional(),
+  app_fee: z.number().optional(),
+  merchant_fee: z.number().optional(),
+  processor_response: z.string().nullable().optional(),
+  auth_model: z.string().nullable().optional(),
+  ip: z.string().nullable().optional(),
+  narration: z.string().nullable().optional(),
+  /** Flutterwave transaction status, e.g. "successful" | "failed" | "pending". */
+  status: z.string().optional(),
+  payment_type: z.string().nullable().optional(),
+  created_at: z.string().optional(),
+  account_id: z.number().optional(),
+  amount_settled: z.number().optional(),
+  customer: z.looseObject({}).optional(),
+  card: z.looseObject({}).optional(),
+  meta: z.unknown().optional()
+});
+var listQuery = z.object({
+  from: z.string().optional(),
+  to: z.string().optional(),
+  page: z.number().int().positive().optional(),
+  customer_email: z.string().optional(),
+  status: z.string().optional(),
+  tx_ref: z.string().optional(),
+  currency: z.string().optional(),
+  amount: z.union([z.number(), z.string()]).optional()
+});
+var feesQuery = z.object({
+  amount: z.union([z.number(), z.string()]),
+  currency: z.string().optional(),
+  /** e.g. "card", "account", "ussd" — the charge type the fee is quoted for. */
+  ptype: z.string().optional()
+});
+var feeData = z.looseObject({
+  charge_amount: z.number().optional(),
+  fee: z.number().optional(),
+  merchant_fee: z.number().optional(),
+  flutterwave_fee: z.number().optional(),
+  stamp_duty_fee: z.number().optional(),
+  currency: z.string().optional()
+});
+
+// src/flutterwave/v3/resources/transactions.ts
+var transactionRes = flwEnvelope(transaction);
+var transactionListRes = flwListEnvelope(transaction);
+var feeRes = flwEnvelope(feeData);
+var Transactions = class {
+  constructor(http) {
+    this.http = http;
+  }
+  http;
+  /**
+   * Verify a transaction by its numeric Flutterwave id (NOT `tx_ref` — use
+   * {@link verifyByReference} for that). A 404 for an unknown id surfaces as
+   * {@link PayweaveNotFoundError}.
+   *
+   * Docs: https://developer.flutterwave.com/v3.0.0/reference/verify-transaction
+   *
+   * @example
+   * const res = await fw.flutterwave.transactions.verify(288200108);
+   * if (res.data.status === "successful") { }
+   */
+  async verify(id) {
+    return this.http.request({
+      method: "GET",
+      path: `/transactions/${encodeURIComponent(String(id))}/verify`,
+      schema: transactionRes
+    });
+  }
+  /**
+   * Verify a transaction by your `tx_ref` (the reference you supplied at
+   * checkout). This is a distinct endpoint from verify-by-id.
+   *
+   * Docs: https://developer.flutterwave.com/v3.0.0/reference/verify-transaction-by-tx_ref
+   *
+   * @example
+   * const res = await fw.flutterwave.transactions.verifyByReference("pwv_tx_001");
+   */
+  async verifyByReference(txRef) {
+    const tx_ref = parseRequest(z.string().min(1), txRef);
+    return this.http.request({
+      method: "GET",
+      path: "/transactions/verify_by_reference",
+      query: { tx_ref },
+      schema: transactionRes
+    });
+  }
+  /**
+   * List transactions on the account.
+   *
+   * Docs: https://developer.flutterwave.com/v3.0.0/reference/list-transactions
+   *
+   * @example
+   * const page = await fw.flutterwave.transactions.list({ status: "successful" });
+   */
+  async list(query = {}) {
+    const q = parseRequest(listQuery, query);
+    return this.http.request({
+      method: "GET",
+      path: "/transactions",
+      query: q,
+      schema: transactionListRes
+    });
+  }
+  /**
+   * Async iterator over ALL transactions matching `query`, transparently walking
+   * every page via `meta.page_info.total_pages`.
+   *
+   * Docs: https://developer.flutterwave.com/v3.0.0/reference/list-transactions
+   *
+   * @example
+   * for await (const tx of fw.flutterwave.transactions.iterate({ status: "successful" })) {
+   *   console.log(tx.id);
+   * }
+   */
+  async *iterate(query = {}) {
+    const base = parseRequest(listQuery, query);
+    let page = base.page ?? 1;
+    for (; ; ) {
+      const res = await this.http.request({
+        method: "GET",
+        path: "/transactions",
+        query: { ...base, page },
+        schema: transactionListRes
+      });
+      for (const tx of res.data) yield tx;
+      const totalPages = metaNumber(res.meta?.page_info?.total_pages);
+      if (totalPages !== void 0) {
+        if (page >= totalPages) return;
+      } else if (res.data.length === 0) {
+        return;
+      }
+      page += 1;
+    }
+  }
+  /**
+   * Get the fee Flutterwave would charge for an amount. `amount` is MAJOR units.
+   *
+   * Docs: https://developer.flutterwave.com/v3.0.0/reference/get-transaction-fees
+   *
+   * @example
+   * const res = await fw.flutterwave.transactions.fees({ amount: 5000, currency: "NGN" });
+   */
+  async fees(query) {
+    const q = parseRequest(feesQuery, query);
+    return this.http.request({
+      method: "GET",
+      path: "/transactions/fee",
+      query: q,
+      schema: feeRes
+    });
+  }
+};
+var bank = z.looseObject({
+  id: z.number().optional(),
+  code: z.string().optional(),
+  name: z.string().optional()
+});
+var bankBranch = z.looseObject({
+  id: z.number().optional(),
+  branch_code: z.string().optional(),
+  branch_name: z.string().optional(),
+  swift_code: z.string().nullable().optional(),
+  bic: z.string().nullable().optional(),
+  bank_id: z.number().optional()
+});
+var resolveAccountReq = z.object({
+  account_number: z.string(),
+  /** The bank code (from `GET /banks/:country`). */
+  account_bank: z.string()
+});
+var resolvedAccount = z.looseObject({
+  account_number: z.string().optional(),
+  account_name: z.string().optional()
+});
+
+// src/flutterwave/v3/resources/banks.ts
+var bankListRes = flwEnvelope(z.array(bank));
+var branchListRes = flwEnvelope(z.array(bankBranch));
+var resolveRes = flwEnvelope(resolvedAccount);
+var Banks = class {
+  constructor(http) {
+    this.http = http;
+  }
+  http;
+  /**
+   * List the banks Flutterwave supports for a country (ISO-2 code, e.g. "NG").
+   * `data` is a flat array (no pagination on this endpoint).
+   *
+   * Docs: https://developer.flutterwave.com/v3.0.0/reference/get-all-banks
+   *
+   * @example
+   * const res = await fw.flutterwave.banks.list("NG");
+   * console.log(res.data[0].code);
+   */
+  async list(country) {
+    const value = parseRequest(z.string().min(1), country);
+    return this.http.request({
+      method: "GET",
+      path: `/banks/${encodeURIComponent(value)}`,
+      schema: bankListRes
+    });
+  }
+  /**
+   * List branches for a bank by its Flutterwave bank id.
+   *
+   * Docs: https://developer.flutterwave.com/v3.0.0/reference/get-bank-branches
+   *
+   * @example
+   * const res = await fw.flutterwave.banks.branches(280);
+   */
+  async branches(bankId) {
+    return this.http.request({
+      method: "GET",
+      path: `/banks/${encodeURIComponent(String(bankId))}/branches`,
+      schema: branchListRes
+    });
+  }
+  /**
+   * Resolve a bank account number to its account holder name.
+   *
+   * Docs: https://developer.flutterwave.com/v3.0.0/reference/resolve-account-details
+   *
+   * @example
+   * const res = await fw.flutterwave.banks.resolveAccount({
+   *   account_number: "0690000040",
+   *   account_bank: "044",
+   * });
+   * console.log(res.data.account_name);
+   */
+  async resolveAccount(input) {
+    const body = parseRequest(resolveAccountReq, input);
+    return this.http.request({
+      method: "POST",
+      path: "/accounts/resolve",
+      body,
+      schema: resolveRes
+    });
+  }
+};
+var createRefundReq = z.object({
+  /** Amount to refund in MAJOR units. Omit for a full refund. */
+  amount: z.union([z.number(), z.string()]).optional()
+});
+var listRefundsQuery = z.object({
+  from: z.string().optional(),
+  to: z.string().optional(),
+  page: z.number().int().positive().optional(),
+  status: z.string().optional()
+});
+var refund = z.looseObject({
+  id: z.number().optional(),
+  account_id: z.number().optional(),
+  tx_id: z.number().optional(),
+  flw_ref: z.string().nullable().optional(),
+  amount_refunded: z.number().optional(),
+  status: z.string().optional(),
+  destination: z.string().nullable().optional(),
+  meta: z.unknown().optional(),
+  created_at: z.string().optional()
+});
+
+// src/flutterwave/v3/resources/refunds.ts
+var refundRes = flwEnvelope(refund);
+var refundListRes = flwListEnvelope(refund);
+var Refunds = class {
+  constructor(http) {
+    this.http = http;
+  }
+  http;
+  /**
+   * Refund a transaction by its numeric id. Omit `amount` to refund in full;
+   * `amount` (when given) is MAJOR units, passed through unchanged.
+   *
+   * Docs: https://developer.flutterwave.com/v3.0.0/reference/refund-a-transaction
+   *
+   * @example
+   * const res = await fw.flutterwave.refunds.create(288200108, { amount: 1000 });
+   */
+  async create(transactionId, input = {}) {
+    const body = parseRequest(createRefundReq, input);
+    return this.http.request({
+      method: "POST",
+      path: `/transactions/${encodeURIComponent(String(transactionId))}/refund`,
+      body,
+      schema: refundRes
+    });
+  }
+  /**
+   * List refunds on the account.
+   *
+   * Docs: https://developer.flutterwave.com/v3.0.0/reference/get-all-refunds
+   *
+   * @example
+   * const page = await fw.flutterwave.refunds.list({ status: "completed" });
+   */
+  async list(query = {}) {
+    const q = parseRequest(listRefundsQuery, query);
+    return this.http.request({
+      method: "GET",
+      path: "/refunds",
+      query: q,
+      schema: refundListRes
+    });
+  }
+  /**
+   * Async iterator over ALL refunds matching `query`, walking every page via
+   * `meta.page_info.total_pages`.
+   *
+   * Docs: https://developer.flutterwave.com/v3.0.0/reference/get-all-refunds
+   *
+   * @example
+   * for await (const r of fw.flutterwave.refunds.iterate()) console.log(r.id);
+   */
+  async *iterate(query = {}) {
+    const base = parseRequest(listRefundsQuery, query);
+    let page = base.page ?? 1;
+    for (; ; ) {
+      const res = await this.http.request({
+        method: "GET",
+        path: "/refunds",
+        query: { ...base, page },
+        schema: refundListRes
+      });
+      for (const r of res.data) yield r;
+      const totalPages = metaNumber(res.meta?.page_info?.total_pages);
+      if (totalPages !== void 0) {
+        if (page >= totalPages) return;
+      } else if (res.data.length === 0) {
+        return;
+      }
+      page += 1;
+    }
+  }
+  /**
+   * Fetch a single refund by its id.
+   *
+   * Docs: https://developer.flutterwave.com/v3.0.0/reference/get-a-refund
+   *
+   * @example
+   * const res = await fw.flutterwave.refunds.fetch(15221);
+   */
+  async fetch(refundId) {
+    return this.http.request({
+      method: "GET",
+      path: `/refunds/${encodeURIComponent(String(refundId))}`,
+      schema: refundRes
+    });
+  }
+};
+function encryptCharge(encryptionKey, payload) {
+  const key = toKey(encryptionKey);
+  const plaintext = JSON.stringify(payload);
+  const cipher = createCipheriv("des-ede3", key, null);
+  const encrypted = Buffer.concat([cipher.update(plaintext, "utf8"), cipher.final()]);
+  return encrypted.toString("base64");
+}
+function decryptCharge(encryptionKey, ciphertext) {
+  const key = toKey(encryptionKey);
+  const decipher = createDecipheriv("des-ede3", key, null);
+  const decrypted = Buffer.concat([
+    decipher.update(Buffer.from(ciphertext, "base64")),
+    decipher.final()
+  ]);
+  return JSON.parse(decrypted.toString("utf8"));
+}
+function toKey(encryptionKey) {
+  const key = Buffer.from(encryptionKey, "utf8");
+  if (key.length !== 24) {
+    throw new PayweaveConfigError(
+      "Flutterwave v3 encryptionKey must be the 24-character dashboard Encryption Key (3DES needs a 24-byte key).",
+      { provider: "flutterwave" }
+    );
+  }
+  return key;
+}
+var cardChargeReq = z.object({
+  card_number: z.string(),
+  cvv: z.string(),
+  expiry_month: z.string(),
+  expiry_year: z.string(),
+  currency: z.string(),
+  /** Amount in MAJOR units. Passed through unchanged. */
+  amount: z.union([z.number(), z.string()]),
+  email: z.string(),
+  tx_ref: z.string(),
+  fullname: z.string().optional(),
+  phone_number: z.string().optional(),
+  /** Required only for the AVS/NoAuth authorization flows. */
+  redirect_url: z.string().optional(),
+  /** 3DS / AVS / PIN authorization sub-object (validated loosely). */
+  authorization: z.looseObject({}).optional(),
+  preauthorize: z.boolean().optional(),
+  meta: metaSchema.optional()
+});
+var bankTransferChargeReq = z.object({
+  tx_ref: z.string(),
+  amount: z.union([z.number(), z.string()]),
+  email: z.string(),
+  currency: z.string().optional(),
+  fullname: z.string().optional(),
+  phone_number: z.string().optional(),
+  /** Whether the generated account/number is reusable (permanent). */
+  is_permanent: z.boolean().optional(),
+  narration: z.string().optional(),
+  meta: metaSchema.optional()
+});
+var ussdChargeReq = z.object({
+  tx_ref: z.string(),
+  /** Bank code for the USSD-supported bank, e.g. "057". */
+  account_bank: z.string(),
+  amount: z.union([z.number(), z.string()]),
+  email: z.string(),
+  currency: z.string().optional(),
+  fullname: z.string().optional(),
+  phone_number: z.string().optional(),
+  meta: metaSchema.optional()
+});
+var ngAccountChargeReq = z.object({
+  tx_ref: z.string(),
+  amount: z.union([z.number(), z.string()]),
+  account_bank: z.string(),
+  account_number: z.string(),
+  email: z.string(),
+  currency: z.string().optional(),
+  fullname: z.string().optional(),
+  phone_number: z.string().optional(),
+  /** BVN — required by some banks for the NG account-debit flow. */
+  bvn: z.string().optional(),
+  meta: metaSchema.optional()
+});
+var validateChargeReq = z.object({
+  otp: z.string(),
+  /** The transaction's `flw_ref` from the initial charge response. */
+  flw_ref: z.string(),
+  type: z.string().optional()
+});
+var chargeData = z.looseObject({
+  id: z.number().optional(),
+  tx_ref: z.string().nullable().optional(),
+  flw_ref: z.string().nullable().optional(),
+  amount: z.number().optional(),
+  currency: z.string().optional(),
+  status: z.string().optional(),
+  payment_type: z.string().nullable().optional(),
+  processor_response: z.string().nullable().optional(),
+  auth_model: z.string().nullable().optional(),
+  created_at: z.string().optional(),
+  customer: z.looseObject({}).optional(),
+  meta: z.unknown().optional()
+});
+
+// src/flutterwave/v3/resources/charges.ts
+var chargeRes = flwEnvelope(chargeData);
+var Charges = class {
+  /**
+   * @param http - Shared HTTP client.
+   * @param encryptionKey - The account Encryption Key (from resolved config).
+   *   May be `undefined` if not configured; `card()` then requires a per-call
+   *   `encryptionKey` override or throws {@link PayweaveConfigError}.
+   */
+  constructor(http, encryptionKey) {
+    this.http = http;
+    this.encryptionKey = encryptionKey;
+  }
+  http;
+  encryptionKey;
+  /**
+   * Charge a card. The payload is 3DES-EDE3-ECB encrypted with the account
+   * Encryption Key and sent as `{ client }` (provider-reference §5.3). `amount`
+   * is MAJOR units, passed through unchanged. A successful charge that needs
+   * OTP/PIN returns a `flw_ref` — pass it to {@link validate}.
+   *
+   * Docs: https://developer.flutterwave.com/v3.0.0/reference/initiate-a-card-charge
+   *
+   * @example
+   * const res = await fw.flutterwave.charges.card({
+   *   card_number: "5531886652142950", cvv: "564",
+   *   expiry_month: "09", expiry_year: "32", currency: "NGN",
+   *   amount: 1000, email: "buyer@example.com", tx_ref: "pwv_tx_001",
+   * });
+   */
+  async card(input, opts = {}) {
+    const payload = parseRequest(cardChargeReq, input);
+    const key = opts.encryptionKey ?? this.encryptionKey;
+    if (!key) {
+      throw new PayweaveConfigError(
+        "Flutterwave card charge requires an Encryption Key. Set `encryptionKey` in the SDK config or pass it as the second argument.",
+        { provider: "flutterwave" }
+      );
+    }
+    const client = encryptCharge(key, payload);
+    return this.http.request({
+      method: "POST",
+      path: "/charges",
+      query: { type: "card" },
+      body: { client },
+      schema: chargeRes
+    });
+  }
+  /**
+   * Initiate a bank-transfer (pay-with-transfer) charge. `amount` is MAJOR units.
+   *
+   * Docs: https://developer.flutterwave.com/v3.0.0/reference/initiate-a-bank-transfer-charge
+   *
+   * @example
+   * const res = await fw.flutterwave.charges.bankTransfer({
+   *   tx_ref: "pwv_tx_002", amount: 5000, email: "buyer@example.com", currency: "NGN",
+   * });
+   */
+  async bankTransfer(input) {
+    const body = parseRequest(bankTransferChargeReq, input);
+    return this.http.request({
+      method: "POST",
+      path: "/charges",
+      query: { type: "bank_transfer" },
+      body,
+      schema: chargeRes
+    });
+  }
+  /**
+   * Initiate a USSD charge. `amount` is MAJOR units.
+   *
+   * Docs: https://developer.flutterwave.com/v3.0.0/reference/initiate-a-ussd-charge
+   *
+   * @example
+   * const res = await fw.flutterwave.charges.ussd({
+   *   tx_ref: "pwv_tx_003", account_bank: "057", amount: 1000,
+   *   email: "buyer@example.com", currency: "NGN",
+   * });
+   */
+  async ussd(input) {
+    const body = parseRequest(ussdChargeReq, input);
+    return this.http.request({
+      method: "POST",
+      path: "/charges",
+      query: { type: "ussd" },
+      body,
+      schema: chargeRes
+    });
+  }
+  /**
+   * Initiate a Nigeria bank-account debit charge. `amount` is MAJOR units.
+   *
+   * Docs: https://developer.flutterwave.com/v3.0.0/reference/initiate-a-nigeria-bank-account-charge
+   *
+   * @example
+   * const res = await fw.flutterwave.charges.ngAccount({
+   *   tx_ref: "pwv_tx_004", account_bank: "044", account_number: "0690000031",
+   *   amount: 1000, email: "buyer@example.com", currency: "NGN",
+   * });
+   */
+  async ngAccount(input) {
+    const body = parseRequest(ngAccountChargeReq, input);
+    return this.http.request({
+      method: "POST",
+      path: "/charges",
+      query: { type: "debit_ng_account" },
+      body,
+      schema: chargeRes
+    });
+  }
+  /**
+   * Validate a charge with the OTP/PIN the customer received.
+   *
+   * Docs: https://developer.flutterwave.com/v3.0.0/reference/validate-a-charge
+   *
+   * @example
+   * const res = await fw.flutterwave.charges.validate({
+   *   otp: "12345", flw_ref: "FLW-MOCK-abc", type: "card",
+   * });
+   */
+  async validate(input) {
+    const body = parseRequest(validateChargeReq, input);
+    return this.http.request({
+      method: "POST",
+      path: "/validate-charge",
+      body,
+      schema: chargeRes
+    });
+  }
+};
+var createTransferReq = z.object({
+  /** Recipient bank code. */
+  account_bank: z.string(),
+  account_number: z.string(),
+  /** Amount in MAJOR units. Passed through unchanged. */
+  amount: z.union([z.number(), z.string()]),
+  currency: z.string().optional(),
+  narration: z.string().optional(),
+  /** Your unique transfer reference. */
+  reference: z.string().optional(),
+  callback_url: z.string().optional(),
+  /** Currency to debit the balance in (for cross-currency transfers). */
+  debit_currency: z.string().optional(),
+  beneficiary_name: z.string().optional(),
+  /** Saved beneficiary id to transfer to instead of raw account details. */
+  beneficiary: z.number().optional(),
+  meta: metaSchema.optional()
+});
+var listTransfersQuery = z.object({
+  page: z.number().int().positive().optional(),
+  status: z.string().optional()
+});
+var transferFeeQuery = z.object({
+  amount: z.union([z.number(), z.string()]),
+  currency: z.string().optional(),
+  /** Fee category, e.g. "account" | "mobilemoney". */
+  type: z.string().optional()
+});
+var transfer = z.looseObject({
+  id: z.number().optional(),
+  account_number: z.string().optional(),
+  bank_code: z.string().optional(),
+  full_name: z.string().optional(),
+  created_at: z.string().optional(),
+  currency: z.string().optional(),
+  amount: z.number().optional(),
+  fee: z.number().optional(),
+  status: z.string().optional(),
+  reference: z.string().nullable().optional(),
+  narration: z.string().nullable().optional(),
+  complete_message: z.string().nullable().optional(),
+  bank_name: z.string().optional()
+});
+var transferFee = z.looseObject({
+  currency: z.string().optional(),
+  fee_type: z.string().optional(),
+  fee: z.number().optional()
+});
+var createBeneficiaryReq = z.object({
+  account_bank: z.string(),
+  account_number: z.string(),
+  beneficiary_name: z.string().optional(),
+  currency: z.string().optional(),
+  bank_name: z.string().optional()
+});
+var listBeneficiariesQuery = z.object({
+  page: z.number().int().positive().optional()
+});
+var beneficiary = z.looseObject({
+  id: z.number().optional(),
+  account_number: z.string().optional(),
+  account_name: z.string().optional(),
+  bank_name: z.string().optional(),
+  bank_code: z.string().optional(),
+  full_name: z.string().optional(),
+  created_at: z.string().optional()
+});
+
+// src/flutterwave/v3/resources/transfers.ts
+var transferRes = flwEnvelope(transfer);
+var transferListRes = flwListEnvelope(transfer);
+var transferFeeRes = flwEnvelope(transferFee.array());
+var Transfers = class {
+  constructor(http) {
+    this.http = http;
+  }
+  http;
+  /**
+   * Initiate a transfer (payout) to a bank account. `amount` is MAJOR units,
+   * passed through unchanged.
+   *
+   * Docs: https://developer.flutterwave.com/v3.0.0/reference/create-a-transfer
+   *
+   * @example
+   * const res = await fw.flutterwave.transfers.create({
+   *   account_bank: "044", account_number: "0690000040",
+   *   amount: 5000, currency: "NGN", narration: "Payout",
+   * });
+   */
+  async create(input) {
+    const body = parseRequest(createTransferReq, input);
+    return this.http.request({
+      method: "POST",
+      path: "/transfers",
+      body,
+      schema: transferRes
+    });
+  }
+  /**
+   * List transfers on the account.
+   *
+   * Docs: https://developer.flutterwave.com/v3.0.0/reference/list-all-transfers
+   *
+   * @example
+   * const page = await fw.flutterwave.transfers.list({ status: "SUCCESSFUL" });
+   */
+  async list(query = {}) {
+    const q = parseRequest(listTransfersQuery, query);
+    return this.http.request({
+      method: "GET",
+      path: "/transfers",
+      query: q,
+      schema: transferListRes
+    });
+  }
+  /**
+   * Async iterator over ALL transfers matching `query`, walking every page via
+   * `meta.page_info.total_pages`.
+   *
+   * Docs: https://developer.flutterwave.com/v3.0.0/reference/list-all-transfers
+   *
+   * @example
+   * for await (const t of fw.flutterwave.transfers.iterate()) console.log(t.id);
+   */
+  async *iterate(query = {}) {
+    const base = parseRequest(listTransfersQuery, query);
+    let page = base.page ?? 1;
+    for (; ; ) {
+      const res = await this.http.request({
+        method: "GET",
+        path: "/transfers",
+        query: { ...base, page },
+        schema: transferListRes
+      });
+      for (const t of res.data) yield t;
+      const totalPages = metaNumber(res.meta?.page_info?.total_pages);
+      if (totalPages !== void 0) {
+        if (page >= totalPages) return;
+      } else if (res.data.length === 0) {
+        return;
+      }
+      page += 1;
+    }
+  }
+  /**
+   * Fetch a single transfer by its id.
+   *
+   * Docs: https://developer.flutterwave.com/v3.0.0/reference/get-a-transfer
+   *
+   * @example
+   * const res = await fw.flutterwave.transfers.fetch(27494);
+   */
+  async fetch(id) {
+    return this.http.request({
+      method: "GET",
+      path: `/transfers/${encodeURIComponent(String(id))}`,
+      schema: transferRes
+    });
+  }
+  /**
+   * Get the fee Flutterwave charges for a transfer of `amount` MAJOR units.
+   *
+   * Docs: https://developer.flutterwave.com/v3.0.0/reference/get-transfer-fee
+   *
+   * @example
+   * const res = await fw.flutterwave.transfers.fees({ amount: 5000, currency: "NGN" });
+   */
+  async fees(query) {
+    const q = parseRequest(transferFeeQuery, query);
+    return this.http.request({
+      method: "GET",
+      path: "/transfers/fee",
+      query: q,
+      schema: transferFeeRes
+    });
+  }
+};
+
+// src/flutterwave/v3/resources/beneficiaries.ts
+var beneficiaryRes = flwEnvelope(beneficiary);
+var beneficiaryListRes = flwListEnvelope(beneficiary);
+var Beneficiaries = class {
+  constructor(http) {
+    this.http = http;
+  }
+  http;
+  /**
+   * Save a transfer beneficiary.
+   *
+   * Docs: https://developer.flutterwave.com/v3.0.0/reference/create-a-transfer-beneficiary
+   *
+   * @example
+   * const res = await fw.flutterwave.beneficiaries.create({
+   *   account_bank: "044", account_number: "0690000040", beneficiary_name: "Jane Doe",
+   * });
+   */
+  async create(input) {
+    const body = parseRequest(createBeneficiaryReq, input);
+    return this.http.request({
+      method: "POST",
+      path: "/beneficiaries",
+      body,
+      schema: beneficiaryRes
+    });
+  }
+  /**
+   * List saved beneficiaries.
+   *
+   * Docs: https://developer.flutterwave.com/v3.0.0/reference/list-all-transfer-beneficiaries
+   *
+   * @example
+   * const page = await fw.flutterwave.beneficiaries.list();
+   */
+  async list(query = {}) {
+    const q = parseRequest(listBeneficiariesQuery, query);
+    return this.http.request({
+      method: "GET",
+      path: "/beneficiaries",
+      query: q,
+      schema: beneficiaryListRes
+    });
+  }
+  /**
+   * Async iterator over ALL beneficiaries, walking every page via
+   * `meta.page_info.total_pages`.
+   *
+   * Docs: https://developer.flutterwave.com/v3.0.0/reference/list-all-transfer-beneficiaries
+   *
+   * @example
+   * for await (const b of fw.flutterwave.beneficiaries.iterate()) console.log(b.id);
+   */
+  async *iterate(query = {}) {
+    const base = parseRequest(listBeneficiariesQuery, query);
+    let page = base.page ?? 1;
+    for (; ; ) {
+      const res = await this.http.request({
+        method: "GET",
+        path: "/beneficiaries",
+        query: { ...base, page },
+        schema: beneficiaryListRes
+      });
+      for (const b of res.data) yield b;
+      const totalPages = metaNumber(res.meta?.page_info?.total_pages);
+      if (totalPages !== void 0) {
+        if (page >= totalPages) return;
+      } else if (res.data.length === 0) {
+        return;
+      }
+      page += 1;
+    }
+  }
+  /**
+   * Fetch a single beneficiary by its id.
+   *
+   * Docs: https://developer.flutterwave.com/v3.0.0/reference/fetch-a-transfer-beneficiary
+   *
+   * @example
+   * const res = await fw.flutterwave.beneficiaries.fetch(5307);
+   */
+  async fetch(id) {
+    return this.http.request({
+      method: "GET",
+      path: `/beneficiaries/${encodeURIComponent(String(id))}`,
+      schema: beneficiaryRes
+    });
+  }
+};
+
+// src/flutterwave/client.ts
+var FlutterwaveClient = class {
+  /**
+   * Shared HTTP client. Resource classes receive THIS instance:
+   * `new Payments(this.http)`.
+   */
+  http;
+  /** Configured API generation — decides which resource surface is mounted. */
+  version;
+  // ── v3 resources (mounted when version === "v3") ─────────────────────────────
+  /** Standard Payments: hosted checkout link (`data.link`). */
+  payments;
+  /** Transactions: verify by id / by tx_ref, list/iterate, fees. */
+  transactions;
+  /** Banks + account resolution: list banks by country, branches, resolve. */
+  banks;
+  /** Refunds: create, list/iterate, fetch. */
+  refunds;
+  /** Direct charges: card (3DES), bank transfer, USSD, NG account, validate. */
+  charges;
+  /** Transfers: create, list/iterate, fetch, fees. */
+  transfers;
+  /** Transfer beneficiaries: create, list/iterate, fetch. */
+  beneficiaries;
+  /**
+   * @param http - Shared HTTP client every resource is built on.
+   * @param version - `"v3"` mounts the v3 surface; `"v4"` is a later wave.
+   * @param encryptionKey - The v3 dashboard Encryption Key (from resolved
+   *   config), consumed by `charges.card`. Optional so the facade can construct
+   *   the client without it; card charges then require a per-call override.
+   */
+  constructor(http, version, encryptionKey) {
+    this.http = http;
+    this.version = version;
+    if (version === "v3") {
+      this.payments = new Payments(this.http);
+      this.transactions = new Transactions(this.http);
+      this.banks = new Banks(this.http);
+      this.refunds = new Refunds(this.http);
+      this.charges = new Charges(this.http, encryptionKey);
+      this.transfers = new Transfers(this.http);
+      this.beneficiaries = new Beneficiaries(this.http);
+    }
+  }
+};
+function flutterwaveHttp(cfg) {
+  if (cfg.version === "v4") {
+    if (!cfg.clientId || !cfg.clientSecret || !cfg.tokenUrl) {
+      throw new PayweaveConfigError(
+        "Flutterwave v4 requires clientId, clientSecret, and a token URL.",
+        { provider: "flutterwave" }
+      );
+    }
+    return new HttpClient({
+      baseUrl: cfg.baseUrl,
+      auth: oauthClientCredentials({
+        clientId: cfg.clientId,
+        clientSecret: cfg.clientSecret,
+        tokenUrl: cfg.tokenUrl,
+        ...cfg.fetch ? { fetch: cfg.fetch } : {},
+        ...cfg.logger ? { logger: cfg.logger } : {}
+      }),
+      provider: "flutterwave",
+      version: "v4",
+      timeoutMs: cfg.timeoutMs,
+      maxRetries: cfg.maxRetries,
+      fetch: cfg.fetch,
+      logger: cfg.logger
+    });
+  }
+  if (!cfg.secretKey) {
+    throw new PayweaveConfigError("Missing secret key for flutterwave.", { provider: "flutterwave" });
+  }
+  return new HttpClient({
+    baseUrl: cfg.baseUrl,
+    auth: bearer(cfg.secretKey),
+    provider: "flutterwave",
+    version: "v3",
+    timeoutMs: cfg.timeoutMs,
+    maxRetries: cfg.maxRetries,
+    fetch: cfg.fetch,
+    logger: cfg.logger
+  });
+}
+function flutterwaveWebhooks(version) {
+  if (version === "v4") {
+    return {
+      signatureHeader: "flutterwave-signature",
+      verify: ({ rawBody, headers, secret }) => verifyFlutterwaveV4(rawBody, readHeader(headers, "flutterwave-signature"), secret),
+      parse: (rawBody) => {
+        const root = JSON.parse(rawBody);
+        return {
+          type: typeof root.type === "string" ? root.type : "unknown",
+          data: root.data,
+          raw: root,
+          ...typeof root.id === "string" ? { id: root.id } : {}
+        };
+      },
+      toUnified: (e) => ({
+        provider: "flutterwave",
+        type: e.type,
+        unifiedType: toUnifiedEventType("flutterwave", "v4", e.type, e.data),
+        data: e.data,
+        raw: e.raw
+      })
+    };
+  }
+  return {
+    signatureHeader: "verif-hash",
+    verify: ({ headers, secret }) => verifyFlutterwaveV3(readHeader(headers, "verif-hash"), secret),
+    parse: (rawBody) => {
+      const root = JSON.parse(rawBody);
+      return {
+        type: typeof root.event === "string" ? root.event : "unknown",
+        data: root.data,
+        raw: root
+      };
+    },
+    toUnified: (e) => ({
+      provider: "flutterwave",
+      type: e.type,
+      unifiedType: toUnifiedEventType("flutterwave", "v3", e.type, e.data),
+      data: e.data,
+      raw: e.raw
+    })
+  };
+}
+function createFlutterwaveAdapter(version = "v3") {
+  return defineProvider({
+    id: "flutterwave",
+    configKey: "flutterwave",
+    configSchema: flutterwaveProviderConfigSchema,
+    environments: version === "v4" ? { test: { baseUrl: FLW_V4_SANDBOX_URL }, live: { baseUrl: FLW_V4_BASE_URL } } : (
+      // v3: one host for both — environment is key-derived, not host-derived.
+      { test: { baseUrl: FLW_V3_BASE_URL }, live: { baseUrl: FLW_V3_BASE_URL } }
+    ),
+    inferEnvironment: (secretKey) => {
+      if (version === "v4") return null;
+      try {
+        return inferEnvironment("flutterwave", secretKey);
+      } catch {
+        return null;
+      }
+    },
+    createHttp: flutterwaveHttp,
+    webhooks: flutterwaveWebhooks(version)
+  });
+}
+createFlutterwaveAdapter("v3");
+
+export { Banks, Beneficiaries, Charges, FlutterwaveClient, Payments, Refunds, Transactions, Transfers, decryptCharge, encryptCharge };
+//# sourceMappingURL=chunk-FBPOCXRZ.js.map
+//# sourceMappingURL=chunk-FBPOCXRZ.js.map