@garuhq/cli 0.8.0 → 0.10.0

package/dist/index.cjs

@@ -15,7 +15,7 @@ var pc__default = /*#__PURE__*/_interopDefault(pc);
 // src/index.ts
 
 // src/version.ts
-var CLI_VERSION = "0.8.0";
+var CLI_VERSION = "0.10.0";
 var CliError = class extends Error {
   code;
   exitCode;
@@ -233,6 +233,192 @@ function createGaruClient(opts) {
   });
 }
 
+// src/lib/parse.ts
+function parsePositiveIntId(raw, label) {
+  const id = Number.parseInt(raw, 10);
+  if (!Number.isFinite(id) || id <= 0) {
+    throw new CliError("invalid_input", `${label} must be a positive integer (got '${raw}')`);
+  }
+  return id;
+}
+function parsePaymentMethod(raw) {
+  if (raw === "pix" || raw === "credit_card" || raw === "boleto") return raw;
+  throw new CliError(
+    "invalid_input",
+    `--type must be 'pix', 'credit_card', or 'boleto' (got '${raw}')`
+  );
+}
+function toChargePaymentMethod(type) {
+  return type === "credit_card" ? "creditCard" : type;
+}
+function parsePersonType(raw) {
+  if (raw === "fisica" || raw === "juridica") return raw;
+  throw new CliError(
+    "invalid_input",
+    `--person-type must be 'fisica' or 'juridica' (got '${raw}')`
+  );
+}
+function parseChargePaymentMethodFilter(raw) {
+  return toChargePaymentMethod(parsePaymentMethod(raw));
+}
+var CHARGE_STATUSES = [
+  "pending",
+  "authorized",
+  "paid",
+  "failed",
+  "expired",
+  "canceled",
+  "refund_pending",
+  "refunded",
+  "chargeback"
+];
+function parseChargeStatus(raw) {
+  if (CHARGE_STATUSES.includes(raw)) return raw;
+  throw new CliError(
+    "invalid_input",
+    `--status must be one of ${CHARGE_STATUSES.join(", ")} (got '${raw}')`
+  );
+}
+var INSTALLMENT_PLAN_STATUSES = [
+  "pending_activation",
+  "active",
+  "completed",
+  "defaulted",
+  "canceled",
+  "refunded"
+];
+function parseInstallmentPlanStatus(raw) {
+  if (INSTALLMENT_PLAN_STATUSES.includes(raw)) return raw;
+  throw new CliError(
+    "invalid_input",
+    `--status must be one of ${INSTALLMENT_PLAN_STATUSES.join(", ")} (got '${raw}')`
+  );
+}
+var REFUND_REQUEST_STATUSES = ["pending", "confirmed", "rejected"];
+function parseRefundRequestStatus(raw) {
+  if (REFUND_REQUEST_STATUSES.includes(raw)) return raw;
+  throw new CliError(
+    "invalid_input",
+    `--status must be one of ${REFUND_REQUEST_STATUSES.join(", ")} (got '${raw}')`
+  );
+}
+function parseWebhookEventStatus(raw) {
+  if (raw === "pending" || raw === "success" || raw === "failed") return raw;
+  throw new CliError(
+    "invalid_input",
+    `--status must be 'pending', 'success', or 'failed' (got '${raw}')`
+  );
+}
+function parseScheduledChargeType(raw) {
+  if (raw === "one_time" || raw === "recurring") return raw;
+  throw new CliError("invalid_input", `--type must be 'one_time' or 'recurring' (got '${raw}')`);
+}
+var SCHEDULED_PAYMENT_METHODS = [
+  "pix",
+  "boleto",
+  "card",
+  "pix_automatic"
+];
+function parseCsvList(raw) {
+  return raw.split(",").map((s) => s.trim()).filter(Boolean);
+}
+function parseScheduledPaymentMethods(raw) {
+  const parts = parseCsvList(raw);
+  if (parts.length === 0) {
+    throw new CliError(
+      "invalid_input",
+      `--methods must list at least one of: ${SCHEDULED_PAYMENT_METHODS.join(", ")}`
+    );
+  }
+  for (const p of parts) {
+    if (!SCHEDULED_PAYMENT_METHODS.includes(p)) {
+      throw new CliError(
+        "invalid_input",
+        `--methods entries must be one of ${SCHEDULED_PAYMENT_METHODS.join(", ")} (got '${p}')`
+      );
+    }
+  }
+  return parts;
+}
+var RECURRENCE_INTERVALS = [
+  "weekly",
+  "biweekly",
+  "monthly",
+  "bimonthly",
+  "quarterly",
+  "biannual",
+  "yearly"
+];
+function parseRecurrenceInterval(raw) {
+  if (RECURRENCE_INTERVALS.includes(raw)) return raw;
+  throw new CliError(
+    "invalid_input",
+    `--recurrence-interval must be one of ${RECURRENCE_INTERVALS.join(", ")} (got '${raw}')`
+  );
+}
+var SCHEDULED_CHARGE_STATUSES = [
+  "scheduled",
+  "due_today",
+  "overdue",
+  "paid",
+  "paused",
+  "canceled",
+  "trial",
+  "pending_tokenization",
+  "recurrence_canceled"
+];
+function parseScheduledChargeStatus(raw) {
+  if (SCHEDULED_CHARGE_STATUSES.includes(raw)) return raw;
+  throw new CliError(
+    "invalid_input",
+    `--status must be one of ${SCHEDULED_CHARGE_STATUSES.join(", ")} (got '${raw}')`
+  );
+}
+function parseIntInRange(raw, label, min, max) {
+  const trimmed = raw.trim();
+  const n = Number.parseInt(trimmed, 10);
+  if (!Number.isFinite(n) || String(n) !== trimmed || n < min || n > max) {
+    throw new CliError(
+      "invalid_input",
+      `${label} must be an integer between ${min} and ${max} (got '${raw}')`
+    );
+  }
+  return n;
+}
+function parseNonNegativeBrl(raw, label) {
+  const trimmed = raw.trim();
+  const n = Number(trimmed);
+  if (trimmed === "" || !Number.isFinite(n) || n < 0) {
+    throw new CliError(
+      "invalid_input",
+      `${label} must be a non-negative amount in BRL/reais, e.g. 49.90 (got '${raw}')`
+    );
+  }
+  return n;
+}
+function parseAmountBrl(raw) {
+  const n = Number(raw);
+  if (!Number.isFinite(n) || n <= 0) {
+    throw new CliError(
+      "invalid_input",
+      `--amount must be a positive decimal in BRL, e.g. 297.50 (got '${raw}')`
+    );
+  }
+  return n;
+}
+function parseMetadata(raw) {
+  let parsed;
+  try {
+    parsed = JSON.parse(raw);
+  } catch {
+    throw new CliError("invalid_input", `--metadata must be valid JSON (got '${raw}')`);
+  }
+  if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
+    throw new CliError("invalid_input", `--metadata must be a JSON object`);
+  }
+  return parsed;
+}
+
 // src/commands/charges.ts
 async function getClient(opts) {
   if (opts.garu) return opts.garu;
@@ -275,8 +461,9 @@ async function chargesCreateCommand(opts) {
     assertCardFieldsPresent(opts);
     charge = await garu.charges.create({
       ...base,
-      cardInfo: {
-        cardNumber: opts.cardNumber,
+      paymentMethod: toChargePaymentMethod(opts.type),
+      card: {
+        number: opts.cardNumber,
         cvv: opts.cardCvv,
         expirationDate: opts.cardExpiration,
         holderName: opts.cardHolder,
@@ -284,14 +471,17 @@ async function chargesCreateCommand(opts) {
       }
     });
   } else {
-    charge = await garu.charges.create(base);
+    charge = await garu.charges.create({
+      ...base,
+      paymentMethod: toChargePaymentMethod(opts.type)
+    });
   }
   printResult(charge, { ...opts, prettyPrint: prettyCharge });
   return charge;
 }
 async function chargesGetCommand(opts) {
   const garu = await getClient(opts);
-  const charge = await garu.charges.get(opts.id);
+  const charge = await garu.charges.retrieve(opts.id);
   printResult(charge, { ...opts, prettyPrint: prettyCharge });
   return charge;
 }
@@ -300,7 +490,6 @@ async function chargesRefundCommand(opts) {
   const params = {};
   if (opts.amount !== void 0) params.amount = opts.amount;
   if (opts.reason !== void 0) params.reason = opts.reason;
-  if (opts.idempotencyKey !== void 0) params.idempotencyKey = opts.idempotencyKey;
   const charge = await garu.charges.refund(opts.id, params);
   printResult(charge, { ...opts, prettyPrint: prettyCharge });
   return charge;
@@ -319,23 +508,128 @@ async function chargesListCommand(opts) {
 }
 function prettyChargeList(list) {
   if (list.data.length === 0) {
-    return `No charges found (page ${list.meta.page}/${list.meta.totalPages || 1})`;
+    return "No charges found";
   }
-  const header = `Charges (page ${list.meta.page}/${list.meta.totalPages || "?"}, ${list.meta.total} total)`;
+  const header = `Charges (${list.count} of ${list.totalCount} total, ${list.totalPages} page(s))`;
   const rows = list.data.map(
-    (c) => `  ${String(c.id).padStart(6)}  ${String(c.status).padEnd(14)}  ${c.paymentMethodId?.padEnd(10) ?? ""}  ${c.date}`
+    (c) => `  ${c.uuid}  ${String(c.status).padEnd(14)}  ${c.paymentMethod.padEnd(10)}  ${c.createdAt}`
   );
   return [header, ...rows].join("\n");
 }
 function prettyCharge(charge) {
   const lines = [
-    `Charge ${charge.id}`,
-    `  status:  ${charge.status}`,
-    `  amount:  ${charge.amount}`,
-    `  method:  ${charge.paymentMethodId}`,
-    `  date:    ${charge.date}`
+    `Charge ${charge.uuid}`,
+    `  status:       ${charge.status}`,
+    `  amount:       ${charge.amount}`,
+    `  chargedTotal: ${charge.chargedTotal}`,
+    `  method:       ${charge.paymentMethod}`,
+    `  createdAt:    ${charge.createdAt}`
+  ];
+  if (charge.expiresAt) lines.push(`  expiresAt:    ${charge.expiresAt}`);
+  if (charge.refund)
+    lines.push(`  refund:       ${charge.refund.amount} (${charge.refund.reason ?? "no reason"})`);
+  return lines.join("\n");
+}
+
+// src/commands/customers.ts
+async function getClient2(opts) {
+  if (opts.garu) return opts.garu;
+  const auth = await resolveAuth({
+    ...opts.apiKey !== void 0 ? { apiKey: opts.apiKey } : {},
+    ...opts.profile !== void 0 ? { profile: opts.profile } : {}
+  });
+  return createGaruClient({
+    auth,
+    ...opts.baseUrl !== void 0 ? { baseUrl: opts.baseUrl } : {}
+  });
+}
+async function customersCreateCommand(opts) {
+  const garu = await getClient2(opts);
+  const params = {
+    name: opts.name,
+    email: opts.email,
+    document: opts.document,
+    phone: opts.phone,
+    personType: opts.personType
+  };
+  if (opts.zipCode !== void 0) params.zipCode = opts.zipCode;
+  if (opts.street !== void 0) params.street = opts.street;
+  if (opts.number !== void 0) params.number = opts.number;
+  if (opts.complement !== void 0) params.complement = opts.complement;
+  if (opts.neighborhood !== void 0) params.neighborhood = opts.neighborhood;
+  if (opts.city !== void 0) params.city = opts.city;
+  if (opts.state !== void 0) params.state = opts.state;
+  const customer = await garu.customers.create(params);
+  printResult(customer, { ...opts, prettyPrint: prettyCustomer });
+  return customer;
+}
+async function customersListCommand(opts) {
+  const garu = await getClient2(opts);
+  const params = {};
+  if (opts.page !== void 0) params.page = opts.page;
+  if (opts.limit !== void 0) params.limit = opts.limit;
+  if (opts.search !== void 0) params.search = opts.search;
+  if (opts.status !== void 0) params.status = opts.status;
+  const result = await garu.customers.list(params);
+  printResult(result, { ...opts, prettyPrint: prettyCustomerList });
+  return result;
+}
+async function customersGetCommand(opts) {
+  const garu = await getClient2(opts);
+  const customer = await garu.customers.get(opts.uuid);
+  printResult(customer, { ...opts, prettyPrint: prettyCustomer });
+  return customer;
+}
+async function customersUpdateCommand(opts) {
+  const garu = await getClient2(opts);
+  const params = {};
+  if (opts.name !== void 0) params.name = opts.name;
+  if (opts.email !== void 0) params.email = opts.email;
+  if (opts.phone !== void 0) params.phone = opts.phone;
+  if (opts.document !== void 0) params.document = opts.document;
+  if (opts.personType !== void 0) params.personType = opts.personType;
+  if (opts.zipCode !== void 0) params.zipCode = opts.zipCode;
+  if (opts.street !== void 0) params.street = opts.street;
+  if (opts.number !== void 0) params.number = opts.number;
+  if (opts.complement !== void 0) params.complement = opts.complement;
+  if (opts.neighborhood !== void 0) params.neighborhood = opts.neighborhood;
+  if (opts.city !== void 0) params.city = opts.city;
+  if (opts.state !== void 0) params.state = opts.state;
+  const customer = await garu.customers.update(opts.uuid, params);
+  printResult(customer, { ...opts, prettyPrint: prettyCustomer });
+  return customer;
+}
+async function customersSetBillingEmailOverrideCommand(opts) {
+  const garu = await getClient2(opts);
+  const params = {
+    billingEmailOverride: opts.billingEmailOverride
+  };
+  const customer = await garu.customers.setBillingEmailOverride(opts.uuid, params);
+  printResult(customer, { ...opts, prettyPrint: prettyCustomer });
+  return customer;
+}
+async function customersDeleteCommand(opts) {
+  const garu = await getClient2(opts);
+  const result = await garu.customers.delete(opts.uuid);
+  printResult(result, { ...opts });
+  return result;
+}
+function prettyCustomerList(list) {
+  if (list.data.length === 0) return "No customers found";
+  const header = `Customers (${list.count} of ${list.totalCount} total, ${list.totalPages} page(s))`;
+  const rows = list.data.map((c) => `  ${c.uuid}  ${c.name.padEnd(30)}  ${c.email}`);
+  return [header, ...rows].join("\n");
+}
+function prettyCustomer(c) {
+  const lines = [
+    `Customer ${c.uuid}`,
+    `  name:         ${c.name}`,
+    `  email:        ${c.email}`,
+    `  phone:        ${c.phone}`,
+    `  document:     ${c.document}`,
+    `  personType:   ${c.personType}`,
+    `  billingEmail: ${c.billingEmail}${c.hasBillingEmailOverride ? " (override)" : ""}`
   ];
-  if (charge.deadline) lines.push(`  deadline: ${charge.deadline}`);
   return lines.join("\n");
 }
 async function doctorCommand(opts = {}) {
@@ -430,6 +724,152 @@ function prettyDoctor(r) {
   ].filter((l) => l !== void 0);
   return lines.join("\n");
 }
+
+// src/commands/installment-plans.ts
+async function getClient3(opts) {
+  if (opts.garu) return opts.garu;
+  const auth = await resolveAuth({
+    ...opts.apiKey !== void 0 ? { apiKey: opts.apiKey } : {},
+    ...opts.profile !== void 0 ? { profile: opts.profile } : {}
+  });
+  return createGaruClient({
+    auth,
+    ...opts.baseUrl !== void 0 ? { baseUrl: opts.baseUrl } : {}
+  });
+}
+async function installmentPlansCreateCommand(opts) {
+  const garu = await getClient3(opts);
+  const params = {
+    productId: opts.productId,
+    customerId: opts.customerId,
+    installments: opts.installments
+  };
+  if (opts.firstDueDate !== void 0) params.firstDueDate = opts.firstDueDate;
+  if (opts.affiliateId !== void 0) params.affiliateId = opts.affiliateId;
+  if (opts.idempotencyKey !== void 0) params.idempotencyKey = opts.idempotencyKey;
+  const plan = await garu.installmentPlans.create(params);
+  printResult(plan, { ...opts, prettyPrint: prettyInstallmentPlan });
+  return plan;
+}
+async function installmentPlansListCommand(opts) {
+  const garu = await getClient3(opts);
+  const params = {};
+  if (opts.page !== void 0) params.page = opts.page;
+  if (opts.limit !== void 0) params.limit = opts.limit;
+  if (opts.customerId !== void 0) params.customerId = opts.customerId;
+  if (opts.productId !== void 0) params.productId = opts.productId;
+  if (opts.dueFrom !== void 0) params.dueFrom = opts.dueFrom;
+  if (opts.dueTo !== void 0) params.dueTo = opts.dueTo;
+  if (opts.status !== void 0 && opts.status.length > 0) {
+    params.status = opts.status.length === 1 ? opts.status[0] : opts.status;
+  }
+  const result = await garu.installmentPlans.list(params);
+  printResult(result, { ...opts, prettyPrint: prettyInstallmentPlanList });
+  return result;
+}
+async function installmentPlansGetCommand(opts) {
+  const garu = await getClient3(opts);
+  const plan = await garu.installmentPlans.get(opts.uuid);
+  printResult(plan, { ...opts, prettyPrint: prettyInstallmentPlanDetail });
+  return plan;
+}
+async function installmentPlansReissueCommand(opts) {
+  const garu = await getClient3(opts);
+  const result = await garu.installmentPlans.reissueInstallment(opts.uuid, opts.number);
+  printResult(result, { ...opts, prettyPrint: prettyReissueResult });
+  return result;
+}
+async function installmentPlansPostponeCommand(opts) {
+  const garu = await getClient3(opts);
+  const params = { newDueDate: opts.newDueDate };
+  const installment = await garu.installmentPlans.postponeInstallment(
+    opts.uuid,
+    opts.number,
+    params
+  );
+  printResult(installment, { ...opts, prettyPrint: prettyInstallment });
+  return installment;
+}
+async function installmentPlansMarkPaidCommand(opts) {
+  const garu = await getClient3(opts);
+  const installment = await garu.installmentPlans.markInstallmentPaid(opts.uuid, opts.number);
+  printResult(installment, { ...opts, prettyPrint: prettyInstallment });
+  return installment;
+}
+async function installmentPlansCancelCommand(opts) {
+  const garu = await getClient3(opts);
+  const params = {};
+  if (opts.note !== void 0) params.note = opts.note;
+  const plan = await garu.installmentPlans.cancel(opts.uuid, params);
+  printResult(plan, { ...opts, prettyPrint: prettyInstallmentPlan });
+  return plan;
+}
+async function installmentPlansRequestRefundCommand(opts) {
+  const garu = await getClient3(opts);
+  const params = {};
+  if (opts.amount !== void 0) params.amount = opts.amount;
+  if (opts.reason !== void 0) params.reason = opts.reason;
+  const request = await garu.installmentPlans.requestRefund(opts.uuid, params);
+  printResult(request, { ...opts, prettyPrint: prettyRefundRequest });
+  return request;
+}
+function prettyInstallmentPlan(p) {
+  const lines = [
+    `Installment plan ${p.uuid}`,
+    `  status:            ${p.status}`,
+    `  installments:      ${p.installmentsPaid}/${p.installments} paid`,
+    `  baseValue:         ${p.baseValue}`,
+    `  installmentAmount: ${p.installmentAmount}`,
+    `  totalScheduled:    ${p.totalScheduled}`,
+    `  totalCollected:    ${p.totalCollected}`,
+    `  firstDueDate:      ${p.firstDueDate}`
+  ];
+  if (p.product) lines.push(`  product:           ${p.product.name} (${p.product.uuid})`);
+  if (p.customer) lines.push(`  customer:          ${p.customer.name} <${p.customer.email}>`);
+  return lines.join("\n");
+}
+function prettyInstallmentPlanDetail(p) {
+  const lines = [prettyInstallmentPlan(p)];
+  if (p.installmentsDetail && p.installmentsDetail.length > 0) {
+    lines.push("  installments:");
+    for (const i of p.installmentsDetail) {
+      lines.push(
+        `    #${i.number}  ${i.status.padEnd(10)}  ${String(i.amount).padStart(10)}  due ${i.dueDate}${i.paidAt ? `  paid ${i.paidAt}` : ""}`
+      );
+    }
+  }
+  return lines.join("\n");
+}
+function prettyInstallmentPlanList(list) {
+  if (list.data.length === 0) return "No installment plans found";
+  const header = `Installment plans (${list.count} of ${list.totalCount} total, ${list.totalPages} page(s))`;
+  const rows = list.data.map(
+    (p) => `  ${p.uuid}  ${p.status.padEnd(18)}  ${p.installmentsPaid}/${p.installments} paid  ${p.firstDueDate}`
+  );
+  return [header, ...rows].join("\n");
+}
+function prettyInstallment(i) {
+  const lines = [
+    `Installment #${i.number}`,
+    `  status:  ${i.status}`,
+    `  amount:  ${i.amount}`,
+    `  dueDate: ${i.dueDate}`
+  ];
+  if (i.paidAt) lines.push(`  paidAt:  ${i.paidAt}`);
+  if (i.boleto) lines.push(`  boleto:  ${i.boleto.barcodeLine}`);
+  return lines.join("\n");
+}
+function prettyReissueResult(result) {
+  const lines = [`Reissue: ${result.status}`];
+  if (result.reason) lines.push(`  reason: ${result.reason}`);
+  if (result.installment) lines.push(prettyInstallment(result.installment));
+  return lines.join("\n");
+}
+function prettyRefundRequest(r) {
+  const lines = [`Refund request ${r.uuid}`, `  status: ${r.status}`, `  amount: ${r.amount}`];
+  if (r.reason) lines.push(`  reason: ${r.reason}`);
+  return lines.join("\n");
+}
 async function loginCommand(opts = {}) {
   const profile = opts.profile ?? "default";
   const apiKey = opts.apiKey ?? await import('@inquirer/prompts').then(
@@ -477,7 +917,7 @@ async function logoutCommand(opts = {}) {
 }
 
 // src/commands/products.ts
-async function getClient2(opts) {
+async function getClient4(opts) {
   if (opts.garu) return opts.garu;
   const auth = await resolveAuth({
     ...opts.apiKey !== void 0 ? { apiKey: opts.apiKey } : {},
@@ -508,7 +948,7 @@ function buildProductBody(opts) {
   return body;
 }
 async function productsCreateCommand(opts) {
-  const garu = await getClient2(opts);
+  const garu = await getClient4(opts);
   const params = { ...buildProductBody(opts), name: opts.name };
   const product = await garu.products.create(params);
   printSuccess(`Created product ${product.uuid ?? product.id}`, opts);
@@ -520,7 +960,7 @@ async function productsUpdateCommand(opts) {
   if (Object.keys(body).length === 0) {
     throw new CliError("invalid_input", "Nothing to update \u2014 pass at least one field to change.");
   }
-  const garu = await getClient2(opts);
+  const garu = await getClient4(opts);
   const product = await garu.products.update(opts.id, body);
   printSuccess(`Updated product ${product.uuid ?? product.id}`, opts);
   printResult(product, { ...opts, prettyPrint: prettyProduct });
@@ -543,8 +983,74 @@ function prettyProduct(p) {
   return lines.join("\n");
 }
 
+// src/commands/refund-requests.ts
+async function getClient5(opts) {
+  if (opts.garu) return opts.garu;
+  const auth = await resolveAuth({
+    ...opts.apiKey !== void 0 ? { apiKey: opts.apiKey } : {},
+    ...opts.profile !== void 0 ? { profile: opts.profile } : {}
+  });
+  return createGaruClient({
+    auth,
+    ...opts.baseUrl !== void 0 ? { baseUrl: opts.baseUrl } : {}
+  });
+}
+async function refundRequestsListCommand(opts) {
+  const garu = await getClient5(opts);
+  const params = {};
+  if (opts.page !== void 0) params.page = opts.page;
+  if (opts.limit !== void 0) params.limit = opts.limit;
+  if (opts.planId !== void 0) params.planId = opts.planId;
+  if (opts.chargeId !== void 0) params.chargeId = opts.chargeId;
+  if (opts.status !== void 0 && opts.status.length > 0) {
+    params.status = opts.status.length === 1 ? opts.status[0] : opts.status;
+  }
+  const result = await garu.refundRequests.list(params);
+  printResult(result, { ...opts, prettyPrint: prettyRefundRequestList });
+  return result;
+}
+async function refundRequestsGetCommand(opts) {
+  const garu = await getClient5(opts);
+  const request = await garu.refundRequests.get(opts.uuid);
+  printResult(request, { ...opts, prettyPrint: prettyRefundRequest2 });
+  return request;
+}
+async function refundRequestsConfirmCommand(opts) {
+  const garu = await getClient5(opts);
+  const params = {};
+  if (opts.note !== void 0) params.note = opts.note;
+  const request = await garu.refundRequests.confirm(opts.uuid, params);
+  printResult(request, { ...opts, prettyPrint: prettyRefundRequest2 });
+  return request;
+}
+async function refundRequestsRejectCommand(opts) {
+  const garu = await getClient5(opts);
+  const params = {};
+  if (opts.note !== void 0) params.note = opts.note;
+  const request = await garu.refundRequests.reject(opts.uuid, params);
+  printResult(request, { ...opts, prettyPrint: prettyRefundRequest2 });
+  return request;
+}
+function prettyRefundRequestList(list) {
+  if (list.data.length === 0) return "No refund requests found";
+  const header = `Refund requests (${list.count} of ${list.totalCount} total, ${list.totalPages} page(s))`;
+  const rows = list.data.map(
+    (r) => `  ${r.uuid}  ${r.status.padEnd(10)}  ${String(r.amount).padStart(10)}  ${r.installmentPlanId ?? r.chargeId ?? ""}`
+  );
+  return [header, ...rows].join("\n");
+}
+function prettyRefundRequest2(r) {
+  const lines = [`Refund request ${r.uuid}`, `  status: ${r.status}`, `  amount: ${r.amount}`];
+  if (r.reason) lines.push(`  reason: ${r.reason}`);
+  if (r.installmentPlanId) lines.push(`  installmentPlan: ${r.installmentPlanId}`);
+  if (r.chargeId) lines.push(`  charge: ${r.chargeId}`);
+  if (r.resolvedAt) lines.push(`  resolvedAt: ${r.resolvedAt}`);
+  if (r.sellerNote) lines.push(`  sellerNote: ${r.sellerNote}`);
+  return lines.join("\n");
+}
+
 // src/commands/scheduled-charges.ts
-async function getClient3(opts) {
+async function getClient6(opts) {
   if (opts.garu) return opts.garu;
   const auth = await resolveAuth({
     ...opts.apiKey !== void 0 ? { apiKey: opts.apiKey } : {},
@@ -581,7 +1087,7 @@ function assertPixAutomaticRequirements(opts) {
 }
 async function scheduledChargesCreateCommand(opts) {
   assertPixAutomaticRequirements(opts);
-  const garu = await getClient3(opts);
+  const garu = await getClient6(opts);
   const params = {
     customerId: opts.customerId,
     amount: opts.amount,
@@ -603,7 +1109,7 @@ async function scheduledChargesCreateCommand(opts) {
   return charge;
 }
 async function scheduledChargesListCommand(opts) {
-  const garu = await getClient3(opts);
+  const garu = await getClient6(opts);
   const params = {};
   if (opts.page !== void 0) params.page = opts.page;
   if (opts.limit !== void 0) params.limit = opts.limit;
@@ -620,13 +1126,13 @@ async function scheduledChargesListCommand(opts) {
   return result;
 }
 async function scheduledChargesGetCommand(opts) {
-  const garu = await getClient3(opts);
+  const garu = await getClient6(opts);
   const detail = await garu.scheduledCharges.get(opts.id);
   printResult(detail, { ...opts, prettyPrint: prettyScheduledChargeDetail });
   return detail;
 }
 async function scheduledChargesPostponeCommand(opts) {
-  const garu = await getClient3(opts);
+  const garu = await getClient6(opts);
   const params = { newDueDate: opts.newDueDate };
   if (opts.reason !== void 0) params.reason = opts.reason;
   const charge = await garu.scheduledCharges.postpone(opts.id, params);
@@ -634,7 +1140,7 @@ async function scheduledChargesPostponeCommand(opts) {
   return charge;
 }
 async function scheduledChargesPauseCommand(opts) {
-  const garu = await getClient3(opts);
+  const garu = await getClient6(opts);
   const params = {};
   if (opts.reason !== void 0) params.reason = opts.reason;
   const charge = await garu.scheduledCharges.pause(opts.id, params);
@@ -642,13 +1148,13 @@ async function scheduledChargesPauseCommand(opts) {
   return charge;
 }
 async function scheduledChargesResumeCommand(opts) {
-  const garu = await getClient3(opts);
+  const garu = await getClient6(opts);
   const charge = await garu.scheduledCharges.resume(opts.id);
   printResult(charge, { ...opts, prettyPrint: prettyScheduledCharge });
   return charge;
 }
 async function scheduledChargesMarkPaidCommand(opts) {
-  const garu = await getClient3(opts);
+  const garu = await getClient6(opts);
   const params = { paymentDate: opts.paymentDate };
   if (opts.externalReference !== void 0) params.externalReference = opts.externalReference;
   if (opts.cycleNumber !== void 0) params.cycleNumber = opts.cycleNumber;
@@ -657,7 +1163,7 @@ async function scheduledChargesMarkPaidCommand(opts) {
   return charge;
 }
 async function scheduledChargesCancelRecurrenceCommand(opts) {
-  const garu = await getClient3(opts);
+  const garu = await getClient6(opts);
   const params = {};
   if (opts.reason !== void 0) params.reason = opts.reason;
   const charge = await garu.scheduledCharges.cancelRecurrence(opts.id, params);
@@ -665,14 +1171,14 @@ async function scheduledChargesCancelRecurrenceCommand(opts) {
   return charge;
 }
 async function scheduledChargesCancelAtPeriodEndCommand(opts) {
-  const garu = await getClient3(opts);
+  const garu = await getClient6(opts);
   const params = { enabled: opts.enabled };
   const charge = await garu.scheduledCharges.setCancelAtPeriodEnd(opts.id, params);
   printResult(charge, { ...opts, prettyPrint: prettyScheduledCharge });
   return charge;
 }
 async function scheduledChargesChangePaymentMethodCommand(opts) {
-  const garu = await getClient3(opts);
+  const garu = await getClient6(opts);
   const params = {
     paymentMethodId: opts.paymentMethodId
   };
@@ -681,13 +1187,13 @@ async function scheduledChargesChangePaymentMethodCommand(opts) {
   return charge;
 }
 async function scheduledChargesClearPaymentMethodCommand(opts) {
-  const garu = await getClient3(opts);
+  const garu = await getClient6(opts);
   const charge = await garu.scheduledCharges.clearPaymentMethod(opts.id);
   printResult(charge, { ...opts, prettyPrint: prettyScheduledCharge });
   return charge;
 }
 async function scheduledChargesAttemptsCommand(opts) {
-  const garu = await getClient3(opts);
+  const garu = await getClient6(opts);
   const params = {};
   if (opts.page !== void 0) params.page = opts.page;
   if (opts.limit !== void 0) params.limit = opts.limit;
@@ -697,7 +1203,7 @@ async function scheduledChargesAttemptsCommand(opts) {
   return result;
 }
 async function scheduledChargesChargeNowCommand(opts) {
-  const garu = await getClient3(opts);
+  const garu = await getClient6(opts);
   const result = await garu.scheduledCharges.chargeNow(opts.id);
   printResult(result, { ...opts, prettyPrint: prettyChargeNow });
   if (result.outcome === "failed" || result.outcome === "not_sent") {
@@ -761,7 +1267,7 @@ function prettyChargeNow(result) {
   if (result.reason) lines.push(`  reason:  ${result.reason}`);
   return lines.join("\n");
 }
-async function getClient4(opts) {
+async function getClient7(opts) {
   if (opts.garu) return opts.garu;
   const auth = await resolveAuth({
     ...opts.apiKey !== void 0 ? { apiKey: opts.apiKey } : {},
@@ -773,7 +1279,7 @@ async function getClient4(opts) {
   });
 }
 async function webhooksEventsListCommand(opts) {
-  const garu = await getClient4(opts);
+  const garu = await getClient7(opts);
   const params = {};
   if (opts.page !== void 0) params.page = opts.page;
   if (opts.limit !== void 0) params.limit = opts.limit;
@@ -785,19 +1291,19 @@ async function webhooksEventsListCommand(opts) {
   return result;
 }
 async function webhooksEventsGetCommand(opts) {
-  const garu = await getClient4(opts);
+  const garu = await getClient7(opts);
   const event = await garu.webhookEvents.get(opts.id);
   printResult(event, { ...opts, prettyPrint: prettyWebhookEvent });
   return event;
 }
 async function webhooksEventsRetryCommand(opts) {
-  const garu = await getClient4(opts);
+  const garu = await getClient7(opts);
   const event = await garu.webhookEvents.retry(opts.id);
   printResult(event, { ...opts, prettyPrint: prettyWebhookEvent });
   return event;
 }
 async function webhooksEventsResendCommand(opts) {
-  const garu = await getClient4(opts);
+  const garu = await getClient7(opts);
   const clone = await garu.webhookEvents.resend(opts.id);
   printSuccess(`Resent event ${opts.id} \u2192 new event ${clone.id}`, opts);
   printResult(clone, { ...opts, prettyPrint: prettyWebhookEvent });
@@ -839,138 +1345,6 @@ function prettyWebhookEvent(event) {
   return lines.join("\n");
 }
 
-// src/lib/parse.ts
-function parsePositiveIntId(raw, label) {
-  const id = Number.parseInt(raw, 10);
-  if (!Number.isFinite(id) || id <= 0) {
-    throw new CliError("invalid_input", `${label} must be a positive integer (got '${raw}')`);
-  }
-  return id;
-}
-function parsePaymentMethod(raw) {
-  if (raw === "pix" || raw === "credit_card" || raw === "boleto") return raw;
-  throw new CliError(
-    "invalid_input",
-    `--type must be 'pix', 'credit_card', or 'boleto' (got '${raw}')`
-  );
-}
-function parseWebhookEventStatus(raw) {
-  if (raw === "pending" || raw === "success" || raw === "failed") return raw;
-  throw new CliError(
-    "invalid_input",
-    `--status must be 'pending', 'success', or 'failed' (got '${raw}')`
-  );
-}
-function parseScheduledChargeType(raw) {
-  if (raw === "one_time" || raw === "recurring") return raw;
-  throw new CliError("invalid_input", `--type must be 'one_time' or 'recurring' (got '${raw}')`);
-}
-var SCHEDULED_PAYMENT_METHODS = [
-  "pix",
-  "boleto",
-  "card",
-  "pix_automatic"
-];
-function parseCsvList(raw) {
-  return raw.split(",").map((s) => s.trim()).filter(Boolean);
-}
-function parseScheduledPaymentMethods(raw) {
-  const parts = parseCsvList(raw);
-  if (parts.length === 0) {
-    throw new CliError(
-      "invalid_input",
-      `--methods must list at least one of: ${SCHEDULED_PAYMENT_METHODS.join(", ")}`
-    );
-  }
-  for (const p of parts) {
-    if (!SCHEDULED_PAYMENT_METHODS.includes(p)) {
-      throw new CliError(
-        "invalid_input",
-        `--methods entries must be one of ${SCHEDULED_PAYMENT_METHODS.join(", ")} (got '${p}')`
-      );
-    }
-  }
-  return parts;
-}
-var RECURRENCE_INTERVALS = [
-  "weekly",
-  "biweekly",
-  "monthly",
-  "bimonthly",
-  "quarterly",
-  "biannual",
-  "yearly"
-];
-function parseRecurrenceInterval(raw) {
-  if (RECURRENCE_INTERVALS.includes(raw)) return raw;
-  throw new CliError(
-    "invalid_input",
-    `--recurrence-interval must be one of ${RECURRENCE_INTERVALS.join(", ")} (got '${raw}')`
-  );
-}
-var SCHEDULED_CHARGE_STATUSES = [
-  "scheduled",
-  "due_today",
-  "overdue",
-  "paid",
-  "paused",
-  "canceled",
-  "trial",
-  "pending_tokenization",
-  "recurrence_canceled"
-];
-function parseScheduledChargeStatus(raw) {
-  if (SCHEDULED_CHARGE_STATUSES.includes(raw)) return raw;
-  throw new CliError(
-    "invalid_input",
-    `--status must be one of ${SCHEDULED_CHARGE_STATUSES.join(", ")} (got '${raw}')`
-  );
-}
-function parseIntInRange(raw, label, min, max) {
-  const trimmed = raw.trim();
-  const n = Number.parseInt(trimmed, 10);
-  if (!Number.isFinite(n) || String(n) !== trimmed || n < min || n > max) {
-    throw new CliError(
-      "invalid_input",
-      `${label} must be an integer between ${min} and ${max} (got '${raw}')`
-    );
-  }
-  return n;
-}
-function parseNonNegativeBrl(raw, label) {
-  const trimmed = raw.trim();
-  const n = Number(trimmed);
-  if (trimmed === "" || !Number.isFinite(n) || n < 0) {
-    throw new CliError(
-      "invalid_input",
-      `${label} must be a non-negative amount in BRL/reais, e.g. 49.90 (got '${raw}')`
-    );
-  }
-  return n;
-}
-function parseAmountBrl(raw) {
-  const n = Number(raw);
-  if (!Number.isFinite(n) || n <= 0) {
-    throw new CliError(
-      "invalid_input",
-      `--amount must be a positive decimal in BRL, e.g. 297.50 (got '${raw}')`
-    );
-  }
-  return n;
-}
-function parseMetadata(raw) {
-  let parsed;
-  try {
-    parsed = JSON.parse(raw);
-  } catch {
-    throw new CliError("invalid_input", `--metadata must be valid JSON (got '${raw}')`);
-  }
-  if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
-    throw new CliError("invalid_input", `--metadata must be a JSON object`);
-  }
-  return parsed;
-}
-
 // src/index.ts
 function buildCli() {
   const program = new commander.Command();
@@ -1021,16 +1395,19 @@ Recipes:
     );
   });
   const charges = program.command("charges").description("Create, fetch, and refund charges");
-  charges.command("list").description("List charges with pagination and filters").option("--page <n>", "page number (1-based)", (v) => parseInt(v, 10)).option("--limit <n>", "items per page (1-100)", (v) => parseInt(v, 10)).option("--status <status>", "filter by status (e.g. paid, pending)").option("--search <query>", "search by customer name, email, or document").option("--payment-method <method>", "filter: pix, creditcard, boleto").action(
+  charges.command("list").description("List charges with pagination and filters").option("--page <n>", "page number (1-based)", (v) => parseInt(v, 10)).option("--limit <n>", "items per page (1-100)", (v) => parseInt(v, 10)).option(
+    "--status <status>",
+    "filter by status: pending, authorized, paid, failed, expired, canceled, refund_pending, refunded, chargeback"
+  ).option("--search <query>", "search by customer name, email, or document").option("--payment-method <method>", "filter: pix, credit_card, boleto").action(
     async (cmdOpts) => {
       const base = toCommandOptions(program);
       await chargesListCommand({
         ...base,
         page: cmdOpts.page,
         limit: cmdOpts.limit,
-        status: cmdOpts.status,
+        status: cmdOpts.status ? parseChargeStatus(cmdOpts.status) : void 0,
         search: cmdOpts.search,
-        paymentMethod: cmdOpts.paymentMethod
+        paymentMethod: cmdOpts.paymentMethod ? parseChargePaymentMethodFilter(cmdOpts.paymentMethod) : void 0
       }).catch((err) => printErrorAndExit(err, base));
     }
   );
@@ -1056,20 +1433,21 @@ Recipes:
       idempotencyKey: cmdOpts.idempotencyKey
     }).catch((err) => printErrorAndExit(err, base));
   });
-  charges.command("get <id>").description("Fetch a single charge by ID").action(async (id) => {
+  charges.command("get <id>").description("Fetch a single charge by its uuid").action(async (id) => {
     const base = toCommandOptions(program);
-    await chargesGetCommand({ ...base, id: parsePositiveIntId(id, "Charge ID") }).catch(
-      (err) => printErrorAndExit(err, base)
-    );
+    await chargesGetCommand({ ...base, id }).catch((err) => printErrorAndExit(err, base));
   });
-  charges.command("refund <id>").description("Refund a charge (full or partial)").option("--amount <centavos>", "partial refund amount in centavos", (v) => parseInt(v, 10)).option("--reason <text>", "optional refund reason").option("--idempotency-key <key>", "idempotency key (auto-generated if omitted)").action(async (id, cmdOpts) => {
+  charges.command("refund <id>").description("Refund a charge by its uuid (full or partial)").option(
+    "--amount <reais>",
+    "partial refund amount in decimal BRL, e.g. 10.00",
+    (v) => parseNonNegativeBrl(v, "--amount")
+  ).option("--reason <text>", "optional refund reason").action(async (id, cmdOpts) => {
     const base = toCommandOptions(program);
     await chargesRefundCommand({
       ...base,
-      id: parsePositiveIntId(id, "Charge ID"),
+      id,
       amount: cmdOpts.amount,
-      reason: cmdOpts.reason,
-      idempotencyKey: cmdOpts.idempotencyKey
+      reason: cmdOpts.reason
     }).catch((err) => printErrorAndExit(err, base));
   });
   const scheduled = program.command("scheduled-charges").description("Schedule, inspect, and act on future-dated charges");
@@ -1286,6 +1664,221 @@ Recipes:
       id: parsePositiveIntId(id, "Webhook event ID")
     }).catch((err) => printErrorAndExit(err, base));
   });
+  const customers = program.command("customers").description("Manage your customer base");
+  customers.command("create").description("Register a customer for the current seller (dedup by document)").requiredOption("--name <name>", "customer name").requiredOption("--email <email>", "customer email").requiredOption("--document <document>", "CPF (11 digits) or CNPJ (14 digits), digits only").requiredOption("--phone <phone>", "phone with area code, 10-11 digits").requiredOption("--person-type <type>", "'fisica' or 'juridica'").option("--zip-code <cep>", "ZIP code, 8 digits").option("--street <street>", "street address").option("--number <number>", "address number").option("--complement <text>", "address complement").option("--neighborhood <text>", "neighborhood").option("--city <city>", "city").option("--state <uf>", "2-letter state code, e.g. SP").action(async (cmdOpts) => {
+    const base = toCommandOptions(program);
+    await customersCreateCommand({
+      ...base,
+      name: cmdOpts.name,
+      email: cmdOpts.email,
+      document: cmdOpts.document,
+      phone: cmdOpts.phone,
+      personType: parsePersonType(cmdOpts.personType),
+      zipCode: cmdOpts.zipCode,
+      street: cmdOpts.street,
+      number: cmdOpts.number,
+      complement: cmdOpts.complement,
+      neighborhood: cmdOpts.neighborhood,
+      city: cmdOpts.city,
+      state: cmdOpts.state
+    }).catch((err) => printErrorAndExit(err, base));
+  });
+  customers.command("list").description("List customers with pagination and search").option("--page <n>", "page number (1-based)", (v) => parseInt(v, 10)).option("--limit <n>", "items per page (1-100)", (v) => parseInt(v, 10)).option("--search <query>", "search by name, email, or document").option(
+    "--status <status>",
+    "'overdue' returns customers with at least one overdue scheduled charge"
+  ).action(
+    async (cmdOpts) => {
+      const base = toCommandOptions(program);
+      await customersListCommand({
+        ...base,
+        page: cmdOpts.page,
+        limit: cmdOpts.limit,
+        search: cmdOpts.search,
+        status: cmdOpts.status === "overdue" ? "overdue" : void 0
+      }).catch((err) => printErrorAndExit(err, base));
+    }
+  );
+  customers.command("get <uuid>").description("Fetch a single customer by uuid").action(async (uuid) => {
+    const base = toCommandOptions(program);
+    await customersGetCommand({ ...base, uuid }).catch((err) => printErrorAndExit(err, base));
+  });
+  customers.command("update <uuid>").description("Partially update a customer (only the flags you pass change)").option("--name <name>", "customer name").option("--email <email>", "customer email").option("--phone <phone>", "phone with area code, 10-11 digits").option("--document <document>", "CPF (11 digits) or CNPJ (14 digits), digits only").option("--person-type <type>", "'fisica' or 'juridica'").option("--zip-code <cep>", "ZIP code, 8 digits").option("--street <street>", "street address").option("--number <number>", "address number").option("--complement <text>", "address complement").option("--neighborhood <text>", "neighborhood").option("--city <city>", "city").option("--state <uf>", "2-letter state code, e.g. SP").action(async (uuid, cmdOpts) => {
+    const base = toCommandOptions(program);
+    await customersUpdateCommand({
+      ...base,
+      uuid,
+      name: cmdOpts.name,
+      email: cmdOpts.email,
+      phone: cmdOpts.phone,
+      document: cmdOpts.document,
+      personType: cmdOpts.personType ? parsePersonType(cmdOpts.personType) : void 0,
+      zipCode: cmdOpts.zipCode,
+      street: cmdOpts.street,
+      number: cmdOpts.number,
+      complement: cmdOpts.complement,
+      neighborhood: cmdOpts.neighborhood,
+      city: cmdOpts.city,
+      state: cmdOpts.state
+    }).catch((err) => printErrorAndExit(err, base));
+  });
+  customers.command("set-billing-email <uuid>").description("Set the sticky per-seller billing-email override").requiredOption("--email <email>", "the billing email to set").action(async (uuid, cmdOpts) => {
+    const base = toCommandOptions(program);
+    await customersSetBillingEmailOverrideCommand({
+      ...base,
+      uuid,
+      billingEmailOverride: cmdOpts.email
+    }).catch((err) => printErrorAndExit(err, base));
+  });
+  customers.command("clear-billing-email <uuid>").description("Clear the billing-email override, falling back to the last-used email").action(async (uuid) => {
+    const base = toCommandOptions(program);
+    await customersSetBillingEmailOverrideCommand({
+      ...base,
+      uuid,
+      billingEmailOverride: null
+    }).catch((err) => printErrorAndExit(err, base));
+  });
+  customers.command("delete <uuid>").description("Remove a customer from the current seller (unlinks your profile only)").action(async (uuid) => {
+    const base = toCommandOptions(program);
+    await customersDeleteCommand({ ...base, uuid }).catch((err) => printErrorAndExit(err, base));
+  });
+  const installmentPlans = program.command("installment-plans").description("Sell a product as boleto parcelado (carn\xEA) and manage its installments");
+  installmentPlans.command("create").description("Sell a product as a carn\xEA (installments of boleto slips)").requiredOption("--product-id <uuid>", "product uuid (must have boleto parcelado enabled)").requiredOption(
+    "--customer-id <n>",
+    "customer id",
+    (v) => parsePositiveIntId(v, "--customer-id")
+  ).requiredOption(
+    "--installments <n>",
+    "2-12 installments",
+    (v) => parseIntInRange(v, "--installments", 2, 12)
+  ).option("--first-due-date <yyyy-mm-dd>", "first installment due date (default: today)").option(
+    "--affiliate-id <n>",
+    "attribute the sale to this affiliate (fixed for the whole plan)",
+    (v) => parsePositiveIntId(v, "--affiliate-id")
+  ).option("--idempotency-key <key>", "idempotency key (auto-generated if omitted)").action(async (cmdOpts) => {
+    const base = toCommandOptions(program);
+    await installmentPlansCreateCommand({
+      ...base,
+      productId: cmdOpts.productId,
+      customerId: cmdOpts.customerId,
+      installments: cmdOpts.installments,
+      firstDueDate: cmdOpts.firstDueDate,
+      affiliateId: cmdOpts.affiliateId,
+      idempotencyKey: cmdOpts.idempotencyKey
+    }).catch((err) => printErrorAndExit(err, base));
+  });
+  installmentPlans.command("list").description("List installment plans (carn\xEAs) with pagination and filters").option("--page <n>", "page number (1-based)", (v) => parseInt(v, 10)).option("--limit <n>", "items per page (1-100)", (v) => parseInt(v, 10)).option(
+    "--customer-id <n>",
+    "filter by customer id",
+    (v) => parsePositiveIntId(v, "--customer-id")
+  ).option("--product-id <uuid>", "filter by product uuid").option(
+    "--status <status>",
+    "filter by status (repeatable)",
+    (val, acc) => acc.concat(val),
+    []
+  ).option("--due-from <yyyy-mm-dd>", "lower bound for the first installment due date").option("--due-to <yyyy-mm-dd>", "upper bound for the first installment due date").action(
+    async (cmdOpts) => {
+      const base = toCommandOptions(program);
+      await installmentPlansListCommand({
+        ...base,
+        page: cmdOpts.page,
+        limit: cmdOpts.limit,
+        customerId: cmdOpts.customerId,
+        productId: cmdOpts.productId,
+        status: cmdOpts.status.length > 0 ? cmdOpts.status.map(parseInstallmentPlanStatus) : void 0,
+        dueFrom: cmdOpts.dueFrom,
+        dueTo: cmdOpts.dueTo
+      }).catch((err) => printErrorAndExit(err, base));
+    }
+  );
+  installmentPlans.command("get <uuid>").description("Fetch a carn\xEA with every installment: due date, status, barcode and PDF").action(async (uuid) => {
+    const base = toCommandOptions(program);
+    await installmentPlansGetCommand({ ...base, uuid }).catch(
+      (err) => printErrorAndExit(err, base)
+    );
+  });
+  installmentPlans.command("reissue <uuid> <number>").description("Issue a segunda via for one installment once its slip has expired").action(async (uuid, number) => {
+    const base = toCommandOptions(program);
+    await installmentPlansReissueCommand({
+      ...base,
+      uuid,
+      number: parsePositiveIntId(number, "installment number")
+    }).catch((err) => printErrorAndExit(err, base));
+  });
+  installmentPlans.command("postpone <uuid> <number>").description("Move one installment to a later due date (its siblings keep theirs)").requiredOption("--new-due-date <yyyy-mm-dd>", "new due date for this installment").action(async (uuid, number, cmdOpts) => {
+    const base = toCommandOptions(program);
+    await installmentPlansPostponeCommand({
+      ...base,
+      uuid,
+      number: parsePositiveIntId(number, "installment number"),
+      newDueDate: cmdOpts.newDueDate
+    }).catch((err) => printErrorAndExit(err, base));
+  });
+  installmentPlans.command("mark-paid <uuid> <number>").description("Record an installment as paid when the buyer paid but the webhook never arrived").action(async (uuid, number) => {
+    const base = toCommandOptions(program);
+    await installmentPlansMarkPaidCommand({
+      ...base,
+      uuid,
+      number: parsePositiveIntId(number, "installment number")
+    }).catch((err) => printErrorAndExit(err, base));
+  });
+  installmentPlans.command("cancel <uuid>").description("Cancel a carn\xEA \u2014 stops emission/reminders and cancels open provider slips").option("--note <text>", "optional note recorded on the plan").action(async (uuid, cmdOpts) => {
+    const base = toCommandOptions(program);
+    await installmentPlansCancelCommand({ ...base, uuid, note: cmdOpts.note }).catch(
+      (err) => printErrorAndExit(err, base)
+    );
+  });
+  installmentPlans.command("request-refund <uuid>").description(
+    "Ask for a carn\xEA to be refunded (Garu records the request; transfer the money yourself, then confirm with `garu refund-requests confirm`)"
+  ).option(
+    "--amount <reais>",
+    "defaults to everything the carn\xEA has collected",
+    (v) => parseNonNegativeBrl(v, "--amount")
+  ).option("--reason <text>", "optional reason").action(async (uuid, cmdOpts) => {
+    const base = toCommandOptions(program);
+    await installmentPlansRequestRefundCommand({
+      ...base,
+      uuid,
+      amount: cmdOpts.amount,
+      reason: cmdOpts.reason
+    }).catch((err) => printErrorAndExit(err, base));
+  });
+  const refundRequests = program.command("refund-requests").description("Inspect and resolve refund requests (carn\xEA and Pix/boleto)");
+  refundRequests.command("list").description("List refund requests with pagination and filters").option("--page <n>", "page number (1-based)", (v) => parseInt(v, 10)).option("--limit <n>", "items per page (1-100)", (v) => parseInt(v, 10)).option("--plan-id <uuid>", "filter by carn\xEA uuid").option("--charge-id <uuid>", "filter by charge uuid (Pix/boleto)").option(
+    "--status <status>",
+    "filter by status (repeatable): pending, confirmed, rejected",
+    (val, acc) => acc.concat(val),
+    []
+  ).action(
+    async (cmdOpts) => {
+      const base = toCommandOptions(program);
+      await refundRequestsListCommand({
+        ...base,
+        page: cmdOpts.page,
+        limit: cmdOpts.limit,
+        planId: cmdOpts.planId,
+        chargeId: cmdOpts.chargeId,
+        status: cmdOpts.status.length > 0 ? cmdOpts.status.map(parseRefundRequestStatus) : void 0
+      }).catch((err) => printErrorAndExit(err, base));
+    }
+  );
+  refundRequests.command("get <uuid>").description("Fetch a single refund request").action(async (uuid) => {
+    const base = toCommandOptions(program);
+    await refundRequestsGetCommand({ ...base, uuid }).catch(
+      (err) => printErrorAndExit(err, base)
+    );
+  });
+  refundRequests.command("confirm <uuid>").description("Record that you transferred the money back \u2014 call this AFTER the transfer").option("--note <text>", "optional note, e.g. a bank reference").action(async (uuid, cmdOpts) => {
+    const base = toCommandOptions(program);
+    await refundRequestsConfirmCommand({ ...base, uuid, note: cmdOpts.note }).catch(
+      (err) => printErrorAndExit(err, base)
+    );
+  });
+  refundRequests.command("reject <uuid>").description("Decline the request \u2014 the carn\xEA or charge is left untouched").option("--note <text>", "optional note explaining the rejection").action(async (uuid, cmdOpts) => {
+    const base = toCommandOptions(program);
+    await refundRequestsRejectCommand({ ...base, uuid, note: cmdOpts.note }).catch(
+      (err) => printErrorAndExit(err, base)
+    );
+  });
   const products = program.command("products").description("Create and update products");
   products.command("create").description("Create a product").requiredOption("--name <name>", "product name").option(
     "--value <reais>",