payweave 0.0.0

package/dist/chunk-E633MKVX.js

@@ -0,0 +1,1507 @@
+import { defineProvider, PAYSTACK_BASE_URL, paystackProviderConfigSchema, readHeader, inferEnvironment, HttpClient, bearer } from './chunk-IUVGM3K7.js';
+import { verifyPaystack } from './chunk-NXQBP35U.js';
+import { toUnifiedEventType } from './chunk-67NRYGRC.js';
+import { PayweaveConfigError, PayweaveValidationError } from './chunk-HTRGMZFH.js';
+import { z } from 'zod';
+
+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(`paystack request validation failed \u2014 ${detail}`, {
+        provider: "paystack",
+        cause: err
+      });
+    }
+    throw err;
+  }
+}
+var paystackEnvelope = (data) => z.looseObject({
+  status: z.boolean(),
+  message: z.string(),
+  data
+});
+var paginationMeta = z.looseObject({
+  total: z.union([z.number(), z.string()]).optional(),
+  perPage: z.union([z.number(), z.string()]).optional(),
+  page: z.union([z.number(), z.string()]).optional(),
+  pageCount: z.union([z.number(), z.string()]).optional(),
+  // Cursor pagination (e.g. `GET /bank`) uses next/previous instead of pageCount.
+  next: z.string().nullable().optional(),
+  previous: z.string().nullable().optional()
+});
+var paystackListEnvelope = (item) => z.looseObject({
+  status: z.boolean(),
+  message: z.string(),
+  data: z.array(item),
+  meta: paginationMeta.optional()
+});
+var metadataSchema = z.record(z.string(), z.unknown());
+({
+  perPage: z.number().int().positive().optional(),
+  page: z.number().int().positive().optional(),
+  from: z.string().optional(),
+  to: z.string().optional()
+});
+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 channelEnum = z.enum([
+  "card",
+  "bank",
+  "ussd",
+  "qr",
+  "mobile_money",
+  "bank_transfer",
+  "eft"
+]);
+var initializeReq = z.object({
+  /** Customer email. Required by Paystack. */
+  email: z.string(),
+  /** Amount in KOBO (minor units) — passed through unchanged (e.g. 500000 = ₦5,000). */
+  amount: z.number().int().nonnegative(),
+  currency: z.string().optional(),
+  /** Your unique transaction reference. If omitted, Paystack generates one. */
+  reference: z.string().optional(),
+  callback_url: z.string().optional(),
+  plan: z.string().optional(),
+  invoice_limit: z.number().int().optional(),
+  metadata: metadataSchema.optional(),
+  channels: z.array(channelEnum).optional(),
+  split_code: z.string().optional(),
+  subaccount: z.string().optional(),
+  transaction_charge: z.number().int().optional(),
+  bearer: z.enum(["account", "subaccount"]).optional()
+});
+var initializeData = z.looseObject({
+  authorization_url: z.string(),
+  access_code: z.string(),
+  reference: z.string()
+});
+var transaction = z.looseObject({
+  id: z.number(),
+  domain: z.string().optional(),
+  status: z.string().optional(),
+  reference: z.string().optional(),
+  amount: z.number().optional(),
+  message: z.string().nullable().optional(),
+  gateway_response: z.string().nullable().optional(),
+  paid_at: z.string().nullable().optional(),
+  created_at: z.string().optional(),
+  channel: z.string().nullable().optional(),
+  currency: z.string().optional(),
+  ip_address: z.string().nullable().optional(),
+  metadata: z.unknown().optional(),
+  customer: z.looseObject({}).optional(),
+  authorization: z.looseObject({}).optional(),
+  requested_amount: z.number().optional()
+});
+var listQuery = z.object({
+  perPage: z.number().int().positive().optional(),
+  page: z.number().int().positive().optional(),
+  customer: z.number().int().optional(),
+  terminalid: z.string().optional(),
+  status: z.enum(["failed", "success", "abandoned"]).optional(),
+  from: z.string().optional(),
+  to: z.string().optional(),
+  amount: z.number().int().optional()
+});
+var chargeAuthorizationReq = z.object({
+  email: z.string(),
+  amount: z.number().int().nonnegative(),
+  /** Reusable authorization code (`AUTH_...`) from a prior charge. Required. */
+  authorization_code: z.string(),
+  currency: z.string().optional(),
+  reference: z.string().optional(),
+  metadata: metadataSchema.optional(),
+  channels: z.array(channelEnum).optional(),
+  subaccount: z.string().optional(),
+  transaction_charge: z.number().int().optional(),
+  bearer: z.enum(["account", "subaccount"]).optional(),
+  queue: z.boolean().optional()
+});
+var partialDebitReq = z.object({
+  authorization_code: z.string(),
+  /** Currency to debit — required by Paystack for partial debit. */
+  currency: z.string(),
+  amount: z.number().int().nonnegative(),
+  email: z.string(),
+  reference: z.string().optional(),
+  at_least: z.number().int().optional()
+});
+var totalsQuery = z.object({
+  perPage: z.number().int().positive().optional(),
+  page: z.number().int().positive().optional(),
+  from: z.string().optional(),
+  to: z.string().optional()
+});
+
+// src/paystack/resources/transactions.ts
+var initializeRes = paystackEnvelope(initializeData);
+var transactionRes = paystackEnvelope(transaction);
+var transactionListRes = paystackListEnvelope(transaction);
+function refString(value) {
+  return parseRequest(z.string().min(1), value);
+}
+function looseData() {
+  return z.looseObject({});
+}
+var Transactions = class {
+  constructor(http) {
+    this.http = http;
+  }
+  http;
+  /**
+   * Initialize a transaction and get a hosted checkout URL. `amount` is in KOBO
+   * (minor units) and is sent to Paystack unchanged.
+   *
+   * Docs: https://paystack.com/docs/api/transaction/#initialize
+   *
+   * @example
+   * const res = await ps.paystack.transactions.initialize({
+   *   email: "buyer@example.com",
+   *   amount: 500000, // ₦5,000 in kobo
+   * });
+   * console.log(res.data.authorization_url);
+   */
+  async initialize(input) {
+    const body = parseRequest(initializeReq, input);
+    return this.http.request({
+      method: "POST",
+      path: "/transaction/initialize",
+      body,
+      schema: initializeRes
+    });
+  }
+  /**
+   * Verify a transaction by its `reference` (Paystack verifies by reference, not
+   * numeric id). A 404 for an unknown reference surfaces as
+   * {@link PayweaveNotFoundError}.
+   *
+   * Docs: https://paystack.com/docs/api/transaction/#verify
+   *
+   * @example
+   * const res = await ps.paystack.transactions.verify("pwv_ref_001");
+   * if (res.data.status === "success") { }
+   */
+  async verify(reference) {
+    const ref = refString(reference);
+    return this.http.request({
+      method: "GET",
+      path: `/transaction/verify/${encodeURIComponent(ref)}`,
+      schema: transactionRes
+    });
+  }
+  /**
+   * List transactions on the integration.
+   *
+   * Docs: https://paystack.com/docs/api/transaction/#list
+   *
+   * @example
+   * const page = await ps.paystack.transactions.list({ perPage: 50, status: "success" });
+   */
+  async list(query = {}) {
+    const q = parseRequest(listQuery, query);
+    return this.http.request({
+      method: "GET",
+      path: "/transaction",
+      query: q,
+      schema: transactionListRes
+    });
+  }
+  /**
+   * Async iterator over ALL transactions matching `query`, transparently walking
+   * every page (`meta.pageCount`).
+   *
+   * Docs: https://paystack.com/docs/api/transaction/#list
+   *
+   * @example
+   * for await (const tx of ps.paystack.transactions.iterate({ status: "success" })) {
+   *   console.log(tx.id);
+   * }
+   */
+  async *iterate(query = {}) {
+    const base = parseRequest(listQuery, query);
+    const perPage = base.perPage ?? 50;
+    let page = base.page ?? 1;
+    for (; ; ) {
+      const res = await this.http.request({
+        method: "GET",
+        path: "/transaction",
+        query: { ...base, perPage, page },
+        schema: transactionListRes
+      });
+      for (const tx of res.data) yield tx;
+      const pageCount = metaNumber(res.meta?.pageCount);
+      if (pageCount !== void 0) {
+        if (page >= pageCount) return;
+      } else if (res.data.length < perPage) {
+        return;
+      }
+      page += 1;
+    }
+  }
+  /**
+   * Fetch a single transaction by its numeric Paystack id.
+   *
+   * Docs: https://paystack.com/docs/api/transaction/#fetch
+   *
+   * @example
+   * const res = await ps.paystack.transactions.fetch(123456789);
+   */
+  async fetch(id) {
+    return this.http.request({
+      method: "GET",
+      path: `/transaction/${encodeURIComponent(String(id))}`,
+      schema: transactionRes
+    });
+  }
+  /**
+   * Charge a previously-authorized card using its reusable `authorization_code`.
+   * `amount` is KOBO minor units, passed through unchanged.
+   *
+   * Docs: https://paystack.com/docs/api/transaction/#charge-authorization
+   *
+   * @example
+   * const res = await ps.paystack.transactions.chargeAuthorization({
+   *   email: "buyer@example.com",
+   *   amount: 500000,
+   *   authorization_code: "AUTH_example",
+   * });
+   */
+  async chargeAuthorization(input) {
+    const body = parseRequest(chargeAuthorizationReq, input);
+    return this.http.request({
+      method: "POST",
+      path: "/transaction/charge_authorization",
+      body,
+      schema: transactionRes
+    });
+  }
+  /**
+   * Retrieve the timeline (event log) of a transaction by id or reference.
+   *
+   * Docs: https://paystack.com/docs/api/transaction/#view-timeline
+   *
+   * @example
+   * const res = await ps.paystack.transactions.timeline("pwv_ref_001");
+   */
+  async timeline(idOrReference) {
+    return this.http.request({
+      method: "GET",
+      path: `/transaction/timeline/${encodeURIComponent(String(idOrReference))}`,
+      schema: paystackEnvelope(looseData())
+    });
+  }
+  /**
+   * Total amount received on the integration over an optional date window.
+   *
+   * Docs: https://paystack.com/docs/api/transaction/#totals
+   *
+   * @example
+   * const res = await ps.paystack.transactions.totals({ from: "2024-01-01" });
+   */
+  async totals(query = {}) {
+    const q = parseRequest(totalsQuery, query);
+    return this.http.request({
+      method: "GET",
+      path: "/transaction/totals",
+      query: q,
+      schema: paystackEnvelope(looseData())
+    });
+  }
+  /**
+   * Deduct a partial amount from a customer's authorization. `amount` is KOBO.
+   *
+   * Docs: https://paystack.com/docs/api/transaction/#partial-debit
+   *
+   * @example
+   * const res = await ps.paystack.transactions.partialDebit({
+   *   authorization_code: "AUTH_example",
+   *   currency: "NGN",
+   *   amount: 200000,
+   *   email: "buyer@example.com",
+   * });
+   */
+  async partialDebit(input) {
+    const body = parseRequest(partialDebitReq, input);
+    return this.http.request({
+      method: "POST",
+      path: "/transaction/partial_debit",
+      body,
+      schema: transactionRes
+    });
+  }
+};
+var createRefundReq = z.object({
+  /** Transaction id or reference to refund. Required. */
+  transaction: z.union([z.string(), z.number().int()]),
+  /** Amount in KOBO (minor units). Omit to refund the full amount. */
+  amount: z.number().int().nonnegative().optional(),
+  currency: z.string().optional(),
+  customer_note: z.string().optional(),
+  merchant_note: z.string().optional()
+});
+var listRefundsQuery = z.object({
+  transaction: z.union([z.string(), z.number().int()]).optional(),
+  currency: z.string().optional(),
+  perPage: z.number().int().positive().optional(),
+  page: z.number().int().positive().optional(),
+  from: z.string().optional(),
+  to: z.string().optional()
+});
+var refund = z.looseObject({
+  id: z.number().optional(),
+  transaction: z.union([z.number(), z.looseObject({})]).optional(),
+  integration: z.number().optional(),
+  amount: z.number().optional(),
+  deducted_amount: z.number().nullable().optional(),
+  currency: z.string().optional(),
+  channel: z.string().nullable().optional(),
+  status: z.string().optional(),
+  refunded_by: z.string().nullable().optional(),
+  customer_note: z.string().nullable().optional(),
+  merchant_note: z.string().nullable().optional(),
+  expected_at: z.string().nullable().optional(),
+  created_at: z.string().optional(),
+  updated_at: z.string().optional()
+});
+
+// src/paystack/resources/refunds.ts
+var refundRes = paystackEnvelope(refund);
+var refundListRes = paystackListEnvelope(refund);
+var Refunds = class {
+  constructor(http) {
+    this.http = http;
+  }
+  http;
+  /**
+   * Create a refund for a transaction. `amount` is KOBO minor units; omit to
+   * refund in full.
+   *
+   * Docs: https://paystack.com/docs/api/refund/#create
+   *
+   * @example
+   * const res = await ps.paystack.refunds.create({ transaction: "pwv_ref_001", amount: 100000 });
+   */
+  async create(input) {
+    const body = parseRequest(createRefundReq, input);
+    return this.http.request({
+      method: "POST",
+      path: "/refund",
+      body,
+      schema: refundRes
+    });
+  }
+  /**
+   * List refunds.
+   *
+   * Docs: https://paystack.com/docs/api/refund/#list
+   *
+   * @example
+   * const page = await ps.paystack.refunds.list({ perPage: 50 });
+   */
+  async list(query = {}) {
+    const q = parseRequest(listRefundsQuery, query);
+    return this.http.request({
+      method: "GET",
+      path: "/refund",
+      query: q,
+      schema: refundListRes
+    });
+  }
+  /**
+   * Async iterator over ALL refunds matching `query`.
+   *
+   * Docs: https://paystack.com/docs/api/refund/#list
+   *
+   * @example
+   * for await (const r of ps.paystack.refunds.iterate()) console.log(r.id);
+   */
+  async *iterate(query = {}) {
+    const base = parseRequest(listRefundsQuery, query);
+    const perPage = base.perPage ?? 50;
+    let page = base.page ?? 1;
+    for (; ; ) {
+      const res = await this.http.request({
+        method: "GET",
+        path: "/refund",
+        query: { ...base, perPage, page },
+        schema: refundListRes
+      });
+      for (const r of res.data) yield r;
+      const pageCount = metaNumber(res.meta?.pageCount);
+      if (pageCount !== void 0) {
+        if (page >= pageCount) return;
+      } else if (res.data.length < perPage) {
+        return;
+      }
+      page += 1;
+    }
+  }
+  /**
+   * Fetch a single refund by id.
+   *
+   * Docs: https://paystack.com/docs/api/refund/#fetch
+   *
+   * @example
+   * const res = await ps.paystack.refunds.fetch(1234);
+   */
+  async fetch(id) {
+    z.string().min(1).parse(String(id));
+    return this.http.request({
+      method: "GET",
+      path: `/refund/${encodeURIComponent(String(id))}`,
+      schema: refundRes
+    });
+  }
+};
+var createCustomerReq = z.object({
+  /** Customer email. Required. */
+  email: z.string(),
+  first_name: z.string().optional(),
+  last_name: z.string().optional(),
+  phone: z.string().optional(),
+  metadata: metadataSchema.optional()
+});
+var updateCustomerReq = z.object({
+  first_name: z.string().optional(),
+  last_name: z.string().optional(),
+  phone: z.string().optional(),
+  metadata: metadataSchema.optional()
+});
+var listCustomersQuery = z.object({
+  perPage: z.number().int().positive().optional(),
+  page: z.number().int().positive().optional(),
+  from: z.string().optional(),
+  to: z.string().optional()
+});
+var validateCustomerReq = z.object({
+  /** e.g. "NG". Required. */
+  country: z.string(),
+  /** Predefined type of identification, e.g. "bank_account". Required. */
+  type: z.string(),
+  account_number: z.string().optional(),
+  bvn: z.string().optional(),
+  bank_code: z.string().optional(),
+  first_name: z.string().optional(),
+  last_name: z.string().optional(),
+  middle_name: z.string().optional(),
+  value: z.string().optional()
+});
+var setRiskActionReq = z.object({
+  /** Customer code or email. Required. */
+  customer: z.string(),
+  /** allow (whitelist), deny (blacklist), or default. Required. */
+  risk_action: z.enum(["default", "allow", "deny"])
+});
+var customer = z.looseObject({
+  id: z.number().optional(),
+  integration: z.number().optional(),
+  first_name: z.string().nullable().optional(),
+  last_name: z.string().nullable().optional(),
+  email: z.string().optional(),
+  phone: z.string().nullable().optional(),
+  customer_code: z.string().optional(),
+  domain: z.string().optional(),
+  risk_action: z.string().optional(),
+  metadata: z.unknown().optional(),
+  created_at: z.string().optional(),
+  updated_at: z.string().optional()
+});
+
+// src/paystack/resources/customers.ts
+var customerRes = paystackEnvelope(customer);
+var customerListRes = paystackListEnvelope(customer);
+var ackRes = paystackEnvelope(z.unknown());
+var Customers = class {
+  constructor(http) {
+    this.http = http;
+  }
+  http;
+  /**
+   * Create a customer.
+   *
+   * Docs: https://paystack.com/docs/api/customer/#create
+   *
+   * @example
+   * const res = await ps.paystack.customers.create({ email: "buyer@example.com" });
+   */
+  async create(input) {
+    const body = parseRequest(createCustomerReq, input);
+    return this.http.request({
+      method: "POST",
+      path: "/customer",
+      body,
+      schema: customerRes
+    });
+  }
+  /**
+   * List customers.
+   *
+   * Docs: https://paystack.com/docs/api/customer/#list
+   *
+   * @example
+   * const page = await ps.paystack.customers.list({ perPage: 50 });
+   */
+  async list(query = {}) {
+    const q = parseRequest(listCustomersQuery, query);
+    return this.http.request({
+      method: "GET",
+      path: "/customer",
+      query: q,
+      schema: customerListRes
+    });
+  }
+  /**
+   * Async iterator over ALL customers.
+   *
+   * Docs: https://paystack.com/docs/api/customer/#list
+   *
+   * @example
+   * for await (const c of ps.paystack.customers.iterate()) console.log(c.customer_code);
+   */
+  async *iterate(query = {}) {
+    const base = parseRequest(listCustomersQuery, query);
+    const perPage = base.perPage ?? 50;
+    let page = base.page ?? 1;
+    for (; ; ) {
+      const res = await this.http.request({
+        method: "GET",
+        path: "/customer",
+        query: { ...base, perPage, page },
+        schema: customerListRes
+      });
+      for (const c of res.data) yield c;
+      const pageCount = metaNumber(res.meta?.pageCount);
+      if (pageCount !== void 0) {
+        if (page >= pageCount) return;
+      } else if (res.data.length < perPage) {
+        return;
+      }
+      page += 1;
+    }
+  }
+  /**
+   * Fetch a customer by email or customer code.
+   *
+   * Docs: https://paystack.com/docs/api/customer/#fetch
+   *
+   * @example
+   * const res = await ps.paystack.customers.fetch("CUS_example");
+   */
+  async fetch(emailOrCode) {
+    const key = parseRequest(z.string().min(1), emailOrCode);
+    return this.http.request({
+      method: "GET",
+      path: `/customer/${encodeURIComponent(key)}`,
+      schema: customerRes
+    });
+  }
+  /**
+   * Update a customer by customer code.
+   *
+   * Docs: https://paystack.com/docs/api/customer/#update
+   *
+   * @example
+   * const res = await ps.paystack.customers.update("CUS_example", { first_name: "Ada" });
+   */
+  async update(code, input) {
+    const key = parseRequest(z.string().min(1), code);
+    const body = parseRequest(updateCustomerReq, input);
+    return this.http.request({
+      method: "PUT",
+      path: `/customer/${encodeURIComponent(key)}`,
+      body,
+      schema: customerRes
+    });
+  }
+  /**
+   * Validate a customer's identity (e.g. bank account). Paystack processes this
+   * asynchronously and returns an acknowledgement envelope.
+   *
+   * Docs: https://paystack.com/docs/api/customer/#validate
+   *
+   * @example
+   * await ps.paystack.customers.validate("CUS_example", {
+   *   country: "NG", type: "bank_account",
+   *   account_number: "0000000000", bank_code: "011",
+   *   first_name: "Ada", last_name: "Lovelace",
+   * });
+   */
+  async validate(code, input) {
+    const key = parseRequest(z.string().min(1), code);
+    const body = parseRequest(validateCustomerReq, input);
+    return this.http.request({
+      method: "POST",
+      path: `/customer/${encodeURIComponent(key)}/identification`,
+      body,
+      schema: ackRes
+    });
+  }
+  /**
+   * Whitelist or blacklist a customer (set risk action).
+   *
+   * Docs: https://paystack.com/docs/api/customer/#whitelist-blacklist
+   *
+   * @example
+   * await ps.paystack.customers.setRiskAction({ customer: "CUS_example", risk_action: "allow" });
+   */
+  async setRiskAction(input) {
+    const body = parseRequest(setRiskActionReq, input);
+    return this.http.request({
+      method: "POST",
+      path: "/customer/set_risk_action",
+      body,
+      schema: customerRes
+    });
+  }
+  /**
+   * Deactivate a reusable authorization on a customer.
+   *
+   * Docs: https://paystack.com/docs/api/customer/#deactivate-authorization
+   *
+   * @example
+   * await ps.paystack.customers.deactivateAuthorization("AUTH_example");
+   */
+  async deactivateAuthorization(authorizationCode) {
+    const code = parseRequest(z.string().min(1), authorizationCode);
+    return this.http.request({
+      method: "POST",
+      path: "/customer/deactivate_authorization",
+      body: { authorization_code: code },
+      schema: ackRes
+    });
+  }
+};
+var listBanksQuery = z.object({
+  /** Country name, e.g. "nigeria" (lowercase, as Paystack documents). */
+  country: z.string().optional(),
+  use_cursor: z.boolean().optional(),
+  perPage: z.number().int().positive().optional(),
+  pay_with_bank_transfer: z.boolean().optional(),
+  pay_with_bank: z.boolean().optional(),
+  gateway: z.string().optional(),
+  type: z.string().optional(),
+  currency: z.string().optional(),
+  next: z.string().optional(),
+  previous: z.string().optional()
+});
+var bank = z.looseObject({
+  id: z.number().optional(),
+  name: z.string().optional(),
+  slug: z.string().optional(),
+  code: z.string().optional(),
+  longcode: z.string().nullable().optional(),
+  gateway: z.string().nullable().optional(),
+  pay_with_bank: z.boolean().optional(),
+  active: z.boolean().optional(),
+  country: z.string().optional(),
+  currency: z.string().optional(),
+  type: z.string().optional()
+});
+var resolveAccountQuery = z.object({
+  account_number: z.string(),
+  bank_code: z.string()
+});
+var resolvedAccount = z.looseObject({
+  account_number: z.string(),
+  account_name: z.string(),
+  bank_id: z.number().optional()
+});
+var listStatesQuery = z.object({
+  /** Country code, e.g. "CA" or "NG". */
+  country: z.string()
+});
+var country = z.looseObject({
+  id: z.number().optional(),
+  name: z.string().optional(),
+  iso_code: z.string().optional(),
+  default_currency_code: z.string().optional()
+});
+var avsState = z.looseObject({
+  name: z.string().optional(),
+  slug: z.string().optional(),
+  abbreviation: z.string().optional()
+});
+var cardBin = z.looseObject({
+  bin: z.string().optional(),
+  brand: z.string().optional(),
+  sub_brand: z.string().optional(),
+  country_code: z.string().optional(),
+  country_name: z.string().optional(),
+  card_type: z.string().optional(),
+  bank: z.string().optional(),
+  linked_bank_id: z.number().optional()
+});
+
+// src/paystack/resources/misc.ts
+var bankListRes = paystackListEnvelope(bank);
+var resolveRes = paystackEnvelope(resolvedAccount);
+var countryListRes = paystackListEnvelope(country);
+var stateListRes = paystackListEnvelope(avsState);
+var cardBinRes = paystackEnvelope(cardBin);
+var Misc = class {
+  constructor(http) {
+    this.http = http;
+  }
+  http;
+  /**
+   * List banks (and other financial channels) for a country.
+   *
+   * Docs: https://paystack.com/docs/api/miscellaneous/#bank
+   *
+   * @example
+   * const res = await ps.paystack.misc.listBanks({ country: "nigeria" });
+   */
+  async listBanks(query = {}) {
+    const q = parseRequest(listBanksQuery, query);
+    return this.http.request({
+      method: "GET",
+      path: "/bank",
+      query: q,
+      schema: bankListRes
+    });
+  }
+  /**
+   * Resolve an account number to an account name at a bank.
+   *
+   * Docs: https://paystack.com/docs/api/verification/#resolve-account
+   *
+   * @example
+   * const res = await ps.paystack.misc.resolveAccountNumber({
+   *   account_number: "0000000000", bank_code: "011",
+   * });
+   * console.log(res.data.account_name);
+   */
+  async resolveAccountNumber(query) {
+    const q = parseRequest(resolveAccountQuery, query);
+    return this.http.request({
+      method: "GET",
+      path: "/bank/resolve",
+      query: q,
+      schema: resolveRes
+    });
+  }
+  /**
+   * List countries Paystack currently supports.
+   *
+   * Docs: https://paystack.com/docs/api/miscellaneous/#country
+   *
+   * @example
+   * const res = await ps.paystack.misc.listCountries();
+   */
+  async listCountries() {
+    return this.http.request({
+      method: "GET",
+      path: "/country",
+      schema: countryListRes
+    });
+  }
+  /**
+   * List the states for a country's address verification.
+   *
+   * Docs: https://paystack.com/docs/api/miscellaneous/#avs-states
+   *
+   * @example
+   * const res = await ps.paystack.misc.listStates({ country: "CA" });
+   */
+  async listStates(query) {
+    const q = parseRequest(listStatesQuery, query);
+    return this.http.request({
+      method: "GET",
+      path: "/address_verification/states",
+      query: q,
+      schema: stateListRes
+    });
+  }
+  /**
+   * Resolve a card BIN (first 6 digits) to its issuer/brand.
+   *
+   * Docs: https://paystack.com/docs/api/verification/#resolve-card-bin
+   *
+   * @example
+   * const res = await ps.paystack.misc.resolveCardBin("539983");
+   */
+  async resolveCardBin(bin) {
+    const value = parseRequest(z.string().min(1), bin);
+    return this.http.request({
+      method: "GET",
+      path: `/decision/bin/${encodeURIComponent(value)}`,
+      schema: cardBinRes
+    });
+  }
+};
+var createRecipientReq = z.object({
+  /** Recipient type, e.g. "nuban", "mobile_money", "basa". Required. */
+  type: z.string(),
+  /** Recipient name. Required. */
+  name: z.string(),
+  account_number: z.string().optional(),
+  bank_code: z.string().optional(),
+  description: z.string().optional(),
+  currency: z.string().optional(),
+  authorization_code: z.string().optional(),
+  metadata: metadataSchema.optional()
+});
+var listRecipientsQuery = z.object({
+  perPage: z.number().int().positive().optional(),
+  page: z.number().int().positive().optional(),
+  from: z.string().optional(),
+  to: z.string().optional()
+});
+var recipient = z.looseObject({
+  id: z.number().optional(),
+  integration: z.number().optional(),
+  domain: z.string().optional(),
+  type: z.string().optional(),
+  currency: z.string().optional(),
+  name: z.string().optional(),
+  recipient_code: z.string().optional(),
+  active: z.boolean().optional(),
+  is_deleted: z.boolean().optional(),
+  details: z.looseObject({}).optional(),
+  created_at: z.string().optional(),
+  updated_at: z.string().optional()
+});
+var initiateTransferReq = z.object({
+  /** Where to debit, currently only "balance". Required. */
+  source: z.string(),
+  /** Amount in KOBO (minor units). Required. */
+  amount: z.number().int().nonnegative(),
+  /** Recipient code (`RCP_...`). Required. */
+  recipient: z.string(),
+  reason: z.string().optional(),
+  currency: z.string().optional(),
+  reference: z.string().optional()
+});
+var listTransfersQuery = z.object({
+  perPage: z.number().int().positive().optional(),
+  page: z.number().int().positive().optional(),
+  recipient: z.number().int().optional(),
+  from: z.string().optional(),
+  to: z.string().optional()
+});
+var transfer = z.looseObject({
+  id: z.number().optional(),
+  integration: z.number().optional(),
+  domain: z.string().optional(),
+  amount: z.number().optional(),
+  currency: z.string().optional(),
+  source: z.string().optional(),
+  reason: z.string().nullable().optional(),
+  recipient: z.union([z.number(), z.looseObject({})]).optional(),
+  status: z.string().optional(),
+  transfer_code: z.string().optional(),
+  reference: z.string().nullable().optional(),
+  created_at: z.string().optional(),
+  updated_at: z.string().optional()
+});
+var balanceEntry = z.looseObject({
+  currency: z.string().optional(),
+  balance: z.number().optional()
+});
+
+// src/paystack/resources/transfer-recipients.ts
+var recipientRes = paystackEnvelope(recipient);
+var recipientListRes = paystackListEnvelope(recipient);
+var TransferRecipients = class {
+  constructor(http) {
+    this.http = http;
+  }
+  http;
+  /**
+   * Create a transfer recipient.
+   *
+   * Docs: https://paystack.com/docs/api/transfer-recipient/#create
+   *
+   * @example
+   * const res = await ps.paystack.transferRecipients.create({
+   *   type: "nuban", name: "Ada Lovelace",
+   *   account_number: "0000000000", bank_code: "011",
+   * });
+   */
+  async create(input) {
+    const body = parseRequest(createRecipientReq, input);
+    return this.http.request({
+      method: "POST",
+      path: "/transferrecipient",
+      body,
+      schema: recipientRes
+    });
+  }
+  /**
+   * List transfer recipients.
+   *
+   * Docs: https://paystack.com/docs/api/transfer-recipient/#list
+   *
+   * @example
+   * const page = await ps.paystack.transferRecipients.list({ perPage: 50 });
+   */
+  async list(query = {}) {
+    const q = parseRequest(listRecipientsQuery, query);
+    return this.http.request({
+      method: "GET",
+      path: "/transferrecipient",
+      query: q,
+      schema: recipientListRes
+    });
+  }
+  /**
+   * Async iterator over ALL transfer recipients.
+   *
+   * Docs: https://paystack.com/docs/api/transfer-recipient/#list
+   *
+   * @example
+   * for await (const r of ps.paystack.transferRecipients.iterate()) console.log(r.recipient_code);
+   */
+  async *iterate(query = {}) {
+    const base = parseRequest(listRecipientsQuery, query);
+    const perPage = base.perPage ?? 50;
+    let page = base.page ?? 1;
+    for (; ; ) {
+      const res = await this.http.request({
+        method: "GET",
+        path: "/transferrecipient",
+        query: { ...base, perPage, page },
+        schema: recipientListRes
+      });
+      for (const r of res.data) yield r;
+      const pageCount = metaNumber(res.meta?.pageCount);
+      if (pageCount !== void 0) {
+        if (page >= pageCount) return;
+      } else if (res.data.length < perPage) {
+        return;
+      }
+      page += 1;
+    }
+  }
+  /**
+   * Fetch a transfer recipient by id or recipient code.
+   *
+   * Docs: https://paystack.com/docs/api/transfer-recipient/#fetch
+   *
+   * @example
+   * const res = await ps.paystack.transferRecipients.fetch("RCP_example");
+   */
+  async fetch(idOrCode) {
+    const key = z.string().min(1).parse(String(idOrCode));
+    return this.http.request({
+      method: "GET",
+      path: `/transferrecipient/${encodeURIComponent(key)}`,
+      schema: recipientRes
+    });
+  }
+};
+var transferRes = paystackEnvelope(transfer);
+var transferListRes = paystackListEnvelope(transfer);
+var balanceRes = paystackEnvelope(z.array(balanceEntry));
+var Transfers = class {
+  constructor(http) {
+    this.http = http;
+  }
+  http;
+  /**
+   * Initiate a transfer to a recipient. `amount` is KOBO minor units.
+   *
+   * Docs: https://paystack.com/docs/api/transfer/#initiate
+   *
+   * @example
+   * const res = await ps.paystack.transfers.initiate({
+   *   source: "balance", amount: 500000, recipient: "RCP_example",
+   * });
+   */
+  async initiate(input) {
+    const body = parseRequest(initiateTransferReq, input);
+    return this.http.request({
+      method: "POST",
+      path: "/transfer",
+      body,
+      schema: transferRes
+    });
+  }
+  /**
+   * List transfers.
+   *
+   * Docs: https://paystack.com/docs/api/transfer/#list
+   *
+   * @example
+   * const page = await ps.paystack.transfers.list({ perPage: 50 });
+   */
+  async list(query = {}) {
+    const q = parseRequest(listTransfersQuery, query);
+    return this.http.request({
+      method: "GET",
+      path: "/transfer",
+      query: q,
+      schema: transferListRes
+    });
+  }
+  /**
+   * Async iterator over ALL transfers.
+   *
+   * Docs: https://paystack.com/docs/api/transfer/#list
+   *
+   * @example
+   * for await (const t of ps.paystack.transfers.iterate()) console.log(t.transfer_code);
+   */
+  async *iterate(query = {}) {
+    const base = parseRequest(listTransfersQuery, query);
+    const perPage = base.perPage ?? 50;
+    let page = base.page ?? 1;
+    for (; ; ) {
+      const res = await this.http.request({
+        method: "GET",
+        path: "/transfer",
+        query: { ...base, perPage, page },
+        schema: transferListRes
+      });
+      for (const t of res.data) yield t;
+      const pageCount = metaNumber(res.meta?.pageCount);
+      if (pageCount !== void 0) {
+        if (page >= pageCount) return;
+      } else if (res.data.length < perPage) {
+        return;
+      }
+      page += 1;
+    }
+  }
+  /**
+   * Fetch a transfer by id or transfer code.
+   *
+   * Docs: https://paystack.com/docs/api/transfer/#fetch
+   *
+   * @example
+   * const res = await ps.paystack.transfers.fetch("TRF_example");
+   */
+  async fetch(idOrCode) {
+    const key = z.string().min(1).parse(String(idOrCode));
+    return this.http.request({
+      method: "GET",
+      path: `/transfer/${encodeURIComponent(key)}`,
+      schema: transferRes
+    });
+  }
+  /**
+   * Verify a transfer by its reference.
+   *
+   * Docs: https://paystack.com/docs/api/transfer/#verify
+   *
+   * @example
+   * const res = await ps.paystack.transfers.verify("pwv_transfer_ref");
+   */
+  async verify(reference) {
+    const ref = parseRequest(z.string().min(1), reference);
+    return this.http.request({
+      method: "GET",
+      path: `/transfer/verify/${encodeURIComponent(ref)}`,
+      schema: transferRes
+    });
+  }
+  /**
+   * Fetch the balance(s) available on the integration.
+   *
+   * Docs: https://paystack.com/docs/api/transfer/#balance
+   *
+   * @example
+   * const res = await ps.paystack.transfers.balance();
+   * console.log(res.data[0]?.balance);
+   */
+  async balance() {
+    return this.http.request({
+      method: "GET",
+      path: "/balance",
+      schema: balanceRes
+    });
+  }
+};
+var planInterval = z.enum([
+  "daily",
+  "weekly",
+  "monthly",
+  "quarterly",
+  "biannually",
+  "annually"
+]);
+var createPlanReq = z.object({
+  /** Plan name. Required. */
+  name: z.string(),
+  /** Amount in KOBO (minor units). Required. */
+  amount: z.number().int().nonnegative(),
+  /** Billing interval. Required. */
+  interval: planInterval,
+  description: z.string().optional(),
+  send_invoices: z.boolean().optional(),
+  send_sms: z.boolean().optional(),
+  currency: z.string().optional(),
+  invoice_limit: z.number().int().optional()
+});
+var listPlansQuery = z.object({
+  perPage: z.number().int().positive().optional(),
+  page: z.number().int().positive().optional(),
+  status: z.string().optional(),
+  interval: planInterval.optional(),
+  amount: z.number().int().optional()
+});
+var plan = z.looseObject({
+  id: z.number().optional(),
+  name: z.string().optional(),
+  plan_code: z.string().optional(),
+  description: z.string().nullable().optional(),
+  amount: z.number().optional(),
+  interval: z.string().optional(),
+  currency: z.string().optional(),
+  send_invoices: z.boolean().optional(),
+  send_sms: z.boolean().optional(),
+  hosted_page: z.boolean().optional(),
+  integration: z.number().optional(),
+  domain: z.string().optional(),
+  created_at: z.string().optional(),
+  updated_at: z.string().optional()
+});
+var createSubscriptionReq = z.object({
+  /** Customer code or email. Required. */
+  customer: z.string(),
+  /** Plan code. Required. */
+  plan: z.string(),
+  /** Authorization code to charge (optional; defaults to the customer's). */
+  authorization: z.string().optional(),
+  start_date: z.string().optional()
+});
+var listSubscriptionsQuery = z.object({
+  perPage: z.number().int().positive().optional(),
+  page: z.number().int().positive().optional(),
+  customer: z.number().int().optional(),
+  plan: z.number().int().optional()
+});
+var toggleSubscriptionReq = z.object({
+  /** Subscription code. Required. */
+  code: z.string(),
+  /** Email token from the subscription. Required. */
+  token: z.string()
+});
+var subscription = z.looseObject({
+  id: z.number().optional(),
+  subscription_code: z.string().optional(),
+  email_token: z.string().optional(),
+  status: z.string().optional(),
+  amount: z.number().optional(),
+  quantity: z.number().optional(),
+  customer: z.union([z.number(), z.looseObject({})]).optional(),
+  plan: z.union([z.number(), z.looseObject({})]).optional(),
+  authorization: z.looseObject({}).optional(),
+  start: z.number().optional(),
+  next_payment_date: z.string().nullable().optional(),
+  created_at: z.string().optional(),
+  updated_at: z.string().optional()
+});
+
+// src/paystack/resources/plans.ts
+var planRes = paystackEnvelope(plan);
+var planListRes = paystackListEnvelope(plan);
+var Plans = class {
+  constructor(http) {
+    this.http = http;
+  }
+  http;
+  /**
+   * Create a plan. `amount` is KOBO minor units.
+   *
+   * Docs: https://paystack.com/docs/api/plan/#create
+   *
+   * @example
+   * const res = await ps.paystack.plans.create({
+   *   name: "Monthly", amount: 500000, interval: "monthly",
+   * });
+   */
+  async create(input) {
+    const body = parseRequest(createPlanReq, input);
+    return this.http.request({
+      method: "POST",
+      path: "/plan",
+      body,
+      schema: planRes
+    });
+  }
+  /**
+   * List plans.
+   *
+   * Docs: https://paystack.com/docs/api/plan/#list
+   *
+   * @example
+   * const page = await ps.paystack.plans.list({ perPage: 50 });
+   */
+  async list(query = {}) {
+    const q = parseRequest(listPlansQuery, query);
+    return this.http.request({
+      method: "GET",
+      path: "/plan",
+      query: q,
+      schema: planListRes
+    });
+  }
+  /**
+   * Async iterator over ALL plans.
+   *
+   * Docs: https://paystack.com/docs/api/plan/#list
+   *
+   * @example
+   * for await (const p of ps.paystack.plans.iterate()) console.log(p.plan_code);
+   */
+  async *iterate(query = {}) {
+    const base = parseRequest(listPlansQuery, query);
+    const perPage = base.perPage ?? 50;
+    let page = base.page ?? 1;
+    for (; ; ) {
+      const res = await this.http.request({
+        method: "GET",
+        path: "/plan",
+        query: { ...base, perPage, page },
+        schema: planListRes
+      });
+      for (const p of res.data) yield p;
+      const pageCount = metaNumber(res.meta?.pageCount);
+      if (pageCount !== void 0) {
+        if (page >= pageCount) return;
+      } else if (res.data.length < perPage) {
+        return;
+      }
+      page += 1;
+    }
+  }
+  /**
+   * Fetch a plan by id or plan code.
+   *
+   * Docs: https://paystack.com/docs/api/plan/#fetch
+   *
+   * @example
+   * const res = await ps.paystack.plans.fetch("PLN_example");
+   */
+  async fetch(idOrCode) {
+    const key = z.string().min(1).parse(String(idOrCode));
+    return this.http.request({
+      method: "GET",
+      path: `/plan/${encodeURIComponent(key)}`,
+      schema: planRes
+    });
+  }
+};
+var subscriptionRes = paystackEnvelope(subscription);
+var subscriptionListRes = paystackListEnvelope(subscription);
+var ackRes2 = paystackEnvelope(z.unknown());
+var Subscriptions = class {
+  constructor(http) {
+    this.http = http;
+  }
+  http;
+  /**
+   * Create a subscription binding a customer to a plan.
+   *
+   * Docs: https://paystack.com/docs/api/subscription/#create
+   *
+   * @example
+   * const res = await ps.paystack.subscriptions.create({
+   *   customer: "CUS_example", plan: "PLN_example",
+   * });
+   */
+  async create(input) {
+    const body = parseRequest(createSubscriptionReq, input);
+    return this.http.request({
+      method: "POST",
+      path: "/subscription",
+      body,
+      schema: subscriptionRes
+    });
+  }
+  /**
+   * List subscriptions.
+   *
+   * Docs: https://paystack.com/docs/api/subscription/#list
+   *
+   * @example
+   * const page = await ps.paystack.subscriptions.list({ perPage: 50 });
+   */
+  async list(query = {}) {
+    const q = parseRequest(listSubscriptionsQuery, query);
+    return this.http.request({
+      method: "GET",
+      path: "/subscription",
+      query: q,
+      schema: subscriptionListRes
+    });
+  }
+  /**
+   * Async iterator over ALL subscriptions.
+   *
+   * Docs: https://paystack.com/docs/api/subscription/#list
+   *
+   * @example
+   * for await (const s of ps.paystack.subscriptions.iterate()) console.log(s.subscription_code);
+   */
+  async *iterate(query = {}) {
+    const base = parseRequest(listSubscriptionsQuery, query);
+    const perPage = base.perPage ?? 50;
+    let page = base.page ?? 1;
+    for (; ; ) {
+      const res = await this.http.request({
+        method: "GET",
+        path: "/subscription",
+        query: { ...base, perPage, page },
+        schema: subscriptionListRes
+      });
+      for (const s of res.data) yield s;
+      const pageCount = metaNumber(res.meta?.pageCount);
+      if (pageCount !== void 0) {
+        if (page >= pageCount) return;
+      } else if (res.data.length < perPage) {
+        return;
+      }
+      page += 1;
+    }
+  }
+  /**
+   * Fetch a subscription by id or subscription code.
+   *
+   * Docs: https://paystack.com/docs/api/subscription/#fetch
+   *
+   * @example
+   * const res = await ps.paystack.subscriptions.fetch("SUB_example");
+   */
+  async fetch(idOrCode) {
+    const key = z.string().min(1).parse(String(idOrCode));
+    return this.http.request({
+      method: "GET",
+      path: `/subscription/${encodeURIComponent(key)}`,
+      schema: subscriptionRes
+    });
+  }
+  /**
+   * Enable a subscription (`code` + email `token`).
+   *
+   * Docs: https://paystack.com/docs/api/subscription/#enable
+   *
+   * @example
+   * await ps.paystack.subscriptions.enable({ code: "SUB_example", token: "email_token" });
+   */
+  async enable(input) {
+    const body = parseRequest(toggleSubscriptionReq, input);
+    return this.http.request({
+      method: "POST",
+      path: "/subscription/enable",
+      body,
+      schema: ackRes2
+    });
+  }
+  /**
+   * Disable a subscription (`code` + email `token`).
+   *
+   * Docs: https://paystack.com/docs/api/subscription/#disable
+   *
+   * @example
+   * await ps.paystack.subscriptions.disable({ code: "SUB_example", token: "email_token" });
+   */
+  async disable(input) {
+    const body = parseRequest(toggleSubscriptionReq, input);
+    return this.http.request({
+      method: "POST",
+      path: "/subscription/disable",
+      body,
+      schema: ackRes2
+    });
+  }
+};
+
+// src/paystack/client.ts
+var PaystackClient = class {
+  /** Shared HTTP client every resource is constructed with. */
+  http;
+  /** Transactions: initialize, verify, list/iterate, fetch, charge auth, etc. */
+  transactions;
+  /** Refunds: create, list, fetch. */
+  refunds;
+  /** Customers: create, list, fetch, update, validate, risk action. */
+  customers;
+  /** Verification / misc: banks, resolve account, countries, states, card BIN. */
+  misc;
+  /** Transfer recipients: create, list, fetch. */
+  transferRecipients;
+  /** Transfers: initiate, list, fetch, verify, balance. */
+  transfers;
+  /** Plans: create, list, fetch. */
+  plans;
+  /** Subscriptions: create, list, fetch, enable, disable. */
+  subscriptions;
+  constructor(http) {
+    this.http = http;
+    this.transactions = new Transactions(this.http);
+    this.refunds = new Refunds(this.http);
+    this.customers = new Customers(this.http);
+    this.misc = new Misc(this.http);
+    this.transferRecipients = new TransferRecipients(this.http);
+    this.transfers = new Transfers(this.http);
+    this.plans = new Plans(this.http);
+    this.subscriptions = new Subscriptions(this.http);
+  }
+};
+function paystackHttp(cfg) {
+  if (!cfg.secretKey) {
+    throw new PayweaveConfigError("Missing secret key for paystack.", { provider: "paystack" });
+  }
+  return new HttpClient({
+    baseUrl: cfg.baseUrl,
+    auth: bearer(cfg.secretKey),
+    provider: "paystack",
+    timeoutMs: cfg.timeoutMs,
+    maxRetries: cfg.maxRetries,
+    fetch: cfg.fetch,
+    logger: cfg.logger
+  });
+}
+defineProvider({
+  id: "paystack",
+  configKey: "paystack",
+  configSchema: paystackProviderConfigSchema,
+  environments: {
+    // One host for both — Paystack's environment is key-derived, not host-derived.
+    test: { baseUrl: PAYSTACK_BASE_URL },
+    live: { baseUrl: PAYSTACK_BASE_URL }
+  },
+  inferEnvironment: (secretKey) => {
+    try {
+      return inferEnvironment("paystack", secretKey);
+    } catch {
+      return null;
+    }
+  },
+  createHttp: paystackHttp,
+  webhooks: {
+    signatureHeader: "x-paystack-signature",
+    verify: ({ rawBody, headers, secret }) => verifyPaystack(rawBody, readHeader(headers, "x-paystack-signature"), 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: "paystack",
+      type: e.type,
+      unifiedType: toUnifiedEventType("paystack", void 0, e.type, e.data),
+      data: e.data,
+      raw: e.raw
+    })
+  }
+});
+
+export { Customers, Misc, PaystackClient, Plans, Refunds, Subscriptions, Transactions, TransferRecipients, Transfers };
+//# sourceMappingURL=chunk-E633MKVX.js.map
+//# sourceMappingURL=chunk-E633MKVX.js.map