@payclave/sdk-server 0.1.1 → 0.2.0

package/dist/index.js

@@ -3,14 +3,27 @@ import { createHmac, timingSafeEqual } from 'crypto';
 
 // src/index.ts
 var PAYCLAVE_WEBHOOK_EVENT_TYPES = [
+  "invoice.issued",
   "invoice.paid",
+  "invoice.partially_paid",
+  "invoice.past_due",
+  "invoice.overpaid",
+  "invoice.voided",
+  "invoice.uncollectible",
+  "invoice.refund_recorded",
+  "invoice.payment_received_after_void",
+  "invoice.payment_received_after_uncollectible",
   "invoice.expired",
+  "payment_link.completed",
+  "payment_link.expired",
   "payment.failed",
   "payment.underpaid",
   "payment.overpaid"
 ];
+var PAYCLAVE_RECONCILIATION_SCHEMA_VERSION = "2026-08-29.v1";
 var PAYCLAVE_API_ERROR_CODES = [
   "ACCOUNT_SUSPENDED",
+  "ACTIVE_MERCHANT_REQUIRED",
   "API_KEY_FORBIDDEN",
   "API_KEY_REQUIRED",
   "AUTH_FORBIDDEN",
@@ -23,6 +36,7 @@ var PAYCLAVE_API_ERROR_CODES = [
   "GOOGLE_PROFILE_UNAVAILABLE",
   "GOOGLE_AUTH_STATE_INVALID",
   "AUTH_PASSWORD_ALREADY_SET",
+  "AUTH_PROXY_UNAUTHORIZED",
   "AUTH_PROVIDER_UNAVAILABLE",
   "AUTH_REQUIRED",
   "USE_SOCIAL_LOGIN",
@@ -39,22 +53,73 @@ var PAYCLAVE_API_ERROR_CODES = [
   "INVALID_WALLET_PAYMENT_ATTEMPT",
   "INVALID_TX_HASH",
   "INVALID_WALLET_ADDRESS",
+  "MODE_MISMATCH",
+  "MEMBERSHIP_REVOKED",
+  "MEMBER_ALREADY_EXISTS",
+  "MEMBER_LIMIT_REACHED",
+  "LAST_OWNER_REQUIRED",
+  "INVITATION_ALREADY_PENDING",
+  "INVITATION_ALREADY_USED",
+  "INVITATION_EMAIL_MISMATCH",
+  "INVITATION_EXPIRED",
+  "INVITATION_NOT_FOUND",
+  "OWNERSHIP_TRANSFER_REQUIRED",
   "NOT_FOUND",
+  "PUBLIC_KEY_FIELD_NOT_ALLOWED",
+  "PERMISSION_DENIED",
   "RATE_LIMIT_EXCEEDED",
+  "REAUTH_REQUIRED",
+  "STEP_UP_REQUIRED",
   "REQUEST_ERROR",
+  "REQUEST_TOO_LARGE",
   "SCAN_OR_COPY_UNAVAILABLE",
   "WALLET_PAYMENTS_UNAVAILABLE",
   "UNSUPPORTED_DEFAULT_WALLET",
   "VALIDATION_ERROR",
   "WEBHOOK_DELIVERY_NOT_FOUND",
+  "WEBHOOK_ENDPOINT_DISABLED",
   "WEBHOOK_ENDPOINT_NOT_FOUND",
   "WEBHOOK_EVENT_UNSUPPORTED",
+  "WEBHOOK_INCIDENT_NOT_FOUND",
   "WEBHOOK_SIGNATURE_INVALID",
+  "SECRET_OVERLAP_ACTIVE",
+  "SECRET_OVERLAP_EXPIRED",
   "CHECKOUT_SESSION_NOT_PAYABLE",
+  "EVENT_TYPE_UNSUPPORTED",
+  "EVENT_PAYLOAD_TOO_LARGE",
+  "JOURNEY_TOKEN_INVALID",
+  "EVENT_DUPLICATE",
+  "TIMESTAMP_OUT_OF_RANGE",
   "INVOICE_NOT_FOUND",
   "INVOICE_STATE_MISMATCH",
   "INVOICE_TRANSITION_GUARD_FAILED",
-  "IDEMPOTENCY_KEY_CONFLICT"
+  "INVOICE_NOT_EDITABLE",
+  "INVOICE_ALREADY_ISSUED",
+  "INVOICE_NOT_PAYABLE",
+  "INVOICE_PDF_UNAVAILABLE",
+  "INVOICE_VERSION_CONFLICT",
+  "CURRENCY_MISMATCH",
+  "INVALID_TOTAL",
+  "CUSTOMER_EMAIL_REQUIRED",
+  "IDEMPOTENCY_KEY_CONFLICT",
+  "PAYMENT_LINK_NOT_FOUND",
+  "PAYMENT_LINK_VERSION_CONFLICT",
+  "LINK_INACTIVE",
+  "LINK_EXPIRED",
+  "LINK_ALREADY_USED",
+  "LINK_RESERVED",
+  "AMOUNT_OUT_OF_RANGE",
+  "FIELD_REQUIRED",
+  "FEATURE_UNAVAILABLE",
+  "MODE_UNAVAILABLE",
+  "CONFIG_CHANGED",
+  "RATE_LIMITED",
+  "EXPORT_RANGE_TOO_LARGE",
+  "EXPORT_NOT_READY",
+  "EXPORT_EXPIRED",
+  "EXPORT_CANCELLED",
+  "EXPORT_SCHEMA_UNSUPPORTED",
+  "EXPORT_TOO_LARGE_FOR_SYNC"
 ];
 var PAYCLAVE_SERVER_SDK_ERROR_CODES = [
   "INVALID_SECRET_KEY",
@@ -113,13 +178,15 @@ var PayclaveError = class extends Error {
   }
 };
 var PAYCLAVE_SERVER_SDK_NAME = "payclave-sdk-server";
-var PAYCLAVE_SERVER_SDK_VERSION = "0.1.0";
+var PAYCLAVE_SERVER_SDK_VERSION = "0.2.0";
 var defaultApiBaseUrl = "https://api.payclave.com";
 var defaultFetcher = (input, init) => fetch(input, init);
 var secretKeyPattern = /^sk_(test|live)_[A-Za-z0-9_-]+$/;
 var amountPattern = /^(0|[1-9]\d*)(\.\d{1,6})?$/;
 var webhookUrlMessage = "Webhook URL must be a valid http or https URL.";
+var webhookRawBodyGuideUrl = "https://www.payclave.com/developers/docs#webhooks";
 var defaultWebhookToleranceSeconds = 300;
+var defaultTimeoutMs = 3e4;
 var minExpiryMinutes = 5;
 var maxExpiryMinutes = 24 * 60;
 var supportedWebhookEventTypes = new Set(PAYCLAVE_WEBHOOK_EVENT_TYPES);
@@ -132,6 +199,8 @@ var isPlainObject = (value) => {
   return prototype === Object.prototype || prototype === null;
 };
 var isStringOrNull = (value) => typeof value === "string" || value === null;
+var isOptionalString = (value) => value === void 0 || typeof value === "string";
+var isOptionalStringOrNull = (value) => value === void 0 || isStringOrNull(value);
 var isMetadata = (value) => isPlainObject(value);
 var isStringArray = (value) => Array.isArray(value) && value.every((item) => typeof item === "string");
 var joinUrl = (baseUrl, path) => `${baseUrl.replace(/\/+$/, "")}${path}`;
@@ -226,6 +295,79 @@ var assertOptionalMetadata = (metadata) => {
     });
   }
 };
+var assertInvoiceDraftFields = (input) => {
+  if (!isPlainObject(input.customer) || !Array.isArray(input.lines) || input.lines.length < 1 || input.lines.length > 100) {
+    throw new PayclaveError({
+      message: "Invoice drafts require a customer object and 1 to 100 lines.",
+      code: "INVALID_REQUEST_BODY",
+      status: 0
+    });
+  }
+  assertOptionalMetadata(input.metadata);
+  assertOptionalExpiry(input.checkoutExpiresInMinutes);
+};
+var assertInvoiceVersion = (version) => {
+  if (typeof version !== "number" || !Number.isInteger(version) || version < 1) {
+    throw new PayclaveError({
+      message: "Invoice version must be a positive integer.",
+      code: "INVALID_REQUEST_BODY",
+      status: 0
+    });
+  }
+};
+var assertPaymentLinkFields = (input) => {
+  if (!isPlainObject(input) || typeof input.title !== "string" || input.title.trim() === "" || input.mode !== void 0 && input.mode !== "test" && input.mode !== "live" || input.amountType !== "fixed" && input.amountType !== "customer_entered" || input.usageType !== void 0 && input.usageType !== "single_use" && input.usageType !== "reusable" || input.currencyCode !== void 0 && input.currencyCode !== "USDC" && input.currencyCode !== "USDT") {
+    throw new PayclaveError({
+      message: "Payment link fields are invalid.",
+      code: "INVALID_REQUEST_BODY",
+      status: 0
+    });
+  }
+  if (input.amountType === "fixed") {
+    assertAmount(input.amount);
+  } else {
+    assertAmount(input.minimumAmount);
+    if (input.maximumAmount !== void 0 && input.maximumAmount !== "") {
+      assertAmount(input.maximumAmount);
+    }
+  }
+  if (input.collect !== void 0 && (!isPlainObject(input.collect) || Object.values(input.collect).some((value) => typeof value !== "boolean"))) {
+    throw new PayclaveError({
+      message: "Payment link customer fields must be booleans.",
+      code: "INVALID_REQUEST_BODY",
+      status: 0
+    });
+  }
+  assertOptionalMetadata(input.metadata);
+};
+var assertPaymentLinkVersion = (version) => {
+  if (typeof version !== "number" || !Number.isInteger(version) || version < 1) {
+    throw new PayclaveError({
+      message: "Payment link version must be a positive integer.",
+      code: "INVALID_REQUEST_BODY",
+      status: 0
+    });
+  }
+};
+var paymentLinkBody = (input) => compact({
+  mode: input.mode,
+  title: input.title,
+  description: input.description,
+  amountType: input.amountType,
+  amount: input.amount,
+  minimumAmount: input.minimumAmount,
+  maximumAmount: input.maximumAmount,
+  currencyCode: input.currencyCode,
+  usageType: input.usageType,
+  activeAt: input.activeAt,
+  expiresAt: input.expiresAt,
+  collect: input.collect,
+  referencePrefix: input.referencePrefix,
+  successUrl: input.successUrl,
+  cancelUrl: input.cancelUrl,
+  successMessage: input.successMessage,
+  metadata: input.metadata
+});
 var assertIdempotencyKey = (key) => {
   if (typeof key !== "string" || key.length === 0) {
     throw new PayclaveError({
@@ -311,6 +453,15 @@ var assertPositiveIntegerLimit = (limit) => {
     });
   }
 };
+var assertReconciliationFormat = (format) => {
+  if (format !== "csv" && format !== "json") {
+    throw new PayclaveError({
+      message: "Reconciliation export format must be csv or json.",
+      code: "INVALID_REQUEST_BODY",
+      status: 0
+    });
+  }
+};
 var serializeBody = (body) => {
   try {
     return JSON.stringify(body);
@@ -363,6 +514,98 @@ var parseResponse = async (response, guard) => {
   }
   return body.data;
 };
+var parseInvoicePDFResponse = async (response) => {
+  const fallbackRequestId = response.headers.get("X-Request-ID");
+  if (!response.ok) {
+    const body = await response.json().catch(() => null);
+    if (isFailureResponse(body)) {
+      throw new PayclaveError({
+        message: body.error.message,
+        code: body.error.code,
+        status: response.status,
+        requestId: body.meta?.requestId ?? fallbackRequestId,
+        details: body.error.details
+      });
+    }
+    throw new PayclaveError({
+      message: "Payclave returned an invalid response.",
+      code: "INVALID_RESPONSE",
+      status: response.status,
+      requestId: fallbackRequestId
+    });
+  }
+  if (response.headers.get("content-type")?.split(";", 1)[0].trim() !== "application/pdf") {
+    throw new PayclaveError({
+      message: "Payclave returned an invalid invoice PDF response.",
+      code: "INVALID_RESPONSE",
+      status: response.status,
+      requestId: fallbackRequestId
+    });
+  }
+  const bytes = new Uint8Array(await response.arrayBuffer());
+  if (bytes.length < 5 || String.fromCharCode(...bytes.slice(0, 5)) !== "%PDF-") {
+    throw new PayclaveError({
+      message: "Payclave returned invalid invoice PDF bytes.",
+      code: "INVALID_RESPONSE",
+      status: response.status,
+      requestId: fallbackRequestId
+    });
+  }
+  const disposition = response.headers.get("content-disposition") ?? "";
+  const filenameMatch = disposition.match(
+    /filename=(?:"([^"\r\n/\\]+\.pdf)"|([^;\s\r\n/\\]+\.pdf))/i
+  );
+  const filename = filenameMatch?.[1] ?? filenameMatch?.[2] ?? "payclave-invoice.pdf";
+  return {
+    bytes,
+    contentType: "application/pdf",
+    filename,
+    requestId: fallbackRequestId
+  };
+};
+var parseReconciliationDownloadResponse = async (response) => {
+  const requestId = response.headers.get("X-Request-ID");
+  if (!response.ok) {
+    const body = await response.json().catch(() => null);
+    if (isFailureResponse(body)) {
+      throw new PayclaveError({
+        message: body.error.message,
+        code: body.error.code,
+        status: response.status,
+        requestId: body.meta?.requestId ?? requestId,
+        details: body.error.details
+      });
+    }
+    throw new PayclaveError({
+      message: "Payclave returned an invalid response.",
+      code: "INVALID_RESPONSE",
+      status: response.status,
+      requestId
+    });
+  }
+  if (response.headers.get("content-type")?.split(";", 1)[0].trim() !== "application/zip" || !response.body) {
+    throw new PayclaveError({
+      message: "Payclave returned an invalid reconciliation archive response.",
+      code: "INVALID_RESPONSE",
+      status: response.status,
+      requestId
+    });
+  }
+  const disposition = response.headers.get("content-disposition") ?? "";
+  const filenameMatch = disposition.match(
+    /filename=(?:"([^"\r\n/\\]+\.zip)"|([^;\s\r\n/\\]+\.zip))/i
+  );
+  const rawSize = response.headers.get("content-length");
+  const parsedSize = rawSize === null ? Number.NaN : Number(rawSize);
+  return {
+    stream: response.body,
+    contentType: "application/zip",
+    filename: filenameMatch?.[1] ?? filenameMatch?.[2] ?? "payclave-reconciliation.zip",
+    byteSize: Number.isSafeInteger(parsedSize) && parsedSize >= 0 ? parsedSize : null,
+    sha256: response.headers.get("X-Payclave-Content-SHA256"),
+    requestId
+  };
+};
 var runFetch = async ({
   fetcher,
   url,
@@ -436,32 +679,44 @@ var isCreatedCheckoutSession = (value) => {
   if (!isRecord(value)) {
     return false;
   }
-  return typeof value.id === "string" && typeof value.checkoutId === "string" && value.object === "checkout_session" && typeof value.mode === "string" && value.status === "pending" && typeof value.invoiceId === "string" && typeof value.invoiceNumber === "string" && typeof value.amountDue === "string" && typeof value.amountReceived === "string" && typeof value.currencyCode === "string" && typeof value.chainId === "number" && typeof value.tokenSymbol === "string" && typeof value.tokenContract === "string" && typeof value.settlementWalletAddress === "string" && isStringOrNull(value.externalReference) && isStringOrNull(value.customerEmail) && isMetadata(value.metadata) && typeof value.checkoutUrl === "string" && typeof value.expiresAt === "string" && typeof value.createdAt === "string";
+  return typeof value.id === "string" && typeof value.checkoutId === "string" && value.object === "checkout_session" && typeof value.mode === "string" && isOptionalString(value.sourceType) && value.status === "pending" && typeof value.collectionState === "string" && typeof value.invoiceId === "string" && typeof value.invoiceNumber === "string" && typeof value.amountDue === "string" && typeof value.amountReceived === "string" && typeof value.total === "string" && typeof value.customerAmountPaid === "string" && typeof value.customerAmountRemaining === "string" && typeof value.currencyCode === "string" && typeof value.chainId === "number" && typeof value.tokenSymbol === "string" && typeof value.tokenContract === "string" && typeof value.settlementWalletAddress === "string" && isStringOrNull(value.externalReference) && isStringOrNull(value.customerEmail) && isMetadata(value.metadata) && typeof value.checkoutUrl === "string" && typeof value.expiresAt === "string" && typeof value.createdAt === "string";
 };
 var isCheckoutSession = (value) => {
   if (!isRecord(value)) {
     return false;
   }
-  return typeof value.id === "string" && typeof value.checkoutId === "string" && value.object === "checkout_session" && typeof value.mode === "string" && typeof value.status === "string" && isStringOrNull(value.invoiceId) && isStringOrNull(value.invoiceNumber) && typeof value.amountDue === "string" && typeof value.amountReceived === "string" && typeof value.currencyCode === "string" && typeof value.chainId === "number" && typeof value.tokenSymbol === "string" && typeof value.tokenContract === "string" && typeof value.settlementWalletAddress === "string" && isStringOrNull(value.externalReference) && isStringOrNull(value.customerEmail) && isMetadata(value.metadata) && typeof value.checkoutUrl === "string" && typeof value.expiresAt === "string" && isStringOrNull(value.completedAt) && typeof value.createdAt === "string";
+  return typeof value.id === "string" && typeof value.checkoutId === "string" && value.object === "checkout_session" && typeof value.mode === "string" && isOptionalString(value.sourceType) && typeof value.status === "string" && typeof value.collectionState === "string" && isStringOrNull(value.invoiceId) && isStringOrNull(value.invoiceNumber) && typeof value.amountDue === "string" && typeof value.amountReceived === "string" && typeof value.total === "string" && typeof value.customerAmountPaid === "string" && typeof value.customerAmountRemaining === "string" && typeof value.currencyCode === "string" && typeof value.chainId === "number" && typeof value.tokenSymbol === "string" && typeof value.tokenContract === "string" && typeof value.settlementWalletAddress === "string" && isStringOrNull(value.externalReference) && isStringOrNull(value.customerEmail) && isMetadata(value.metadata) && typeof value.checkoutUrl === "string" && typeof value.expiresAt === "string" && isStringOrNull(value.completedAt) && typeof value.createdAt === "string";
 };
 var isInvoice = (value) => {
   if (!isRecord(value)) {
     return false;
   }
-  return typeof value.id === "string" && typeof value.invoiceNumber === "string" && value.object === "invoice" && typeof value.mode === "string" && typeof value.status === "string" && typeof value.amountDue === "string" && typeof value.amountReceived === "string" && typeof value.platformFee === "string" && typeof value.netAmount === "string" && typeof value.currencyCode === "string" && typeof value.chainId === "number" && typeof value.tokenContract === "string" && typeof value.settlementWalletAddress === "string" && isStringOrNull(value.externalReference) && isMetadata(value.metadata) && typeof value.expiresAt === "string" && isStringOrNull(value.paidAt) && isStringOrNull(value.cancelledAt) && typeof value.createdAt === "string";
+  return typeof value.id === "string" && isStringOrNull(value.invoiceNumber) && value.object === "invoice" && typeof value.mode === "string" && typeof value.status === "string" && typeof value.collectionState === "string" && typeof value.subtotal === "string" && typeof value.discountTotal === "string" && typeof value.taxTotal === "string" && typeof value.total === "string" && typeof value.customerAmountPaid === "string" && typeof value.customerAmountRemaining === "string" && typeof value.expectedMerchantSettlement === "string" && typeof value.merchantAmountSettled === "string" && typeof value.overpaymentAmount === "string" && typeof value.migrationState === "string" && typeof value.amountDue === "string" && typeof value.amountReceived === "string" && typeof value.platformFee === "string" && typeof value.netAmount === "string" && typeof value.currencyCode === "string" && typeof value.chainId === "number" && typeof value.tokenContract === "string" && typeof value.settlementWalletAddress === "string" && isStringOrNull(value.externalReference) && isMetadata(value.metadata) && isStringOrNull(value.expiresAt) && isStringOrNull(value.paidAt) && isStringOrNull(value.cancelledAt) && isOptionalStringOrNull(value.voidedAt) && isOptionalStringOrNull(value.uncollectibleAt) && typeof value.createdAt === "string" && isOptionalString(value.internalId) && isOptionalString(value.sourceType) && (value.version === void 0 || typeof value.version === "number") && isOptionalString(value.calculationVersion) && (value.customer === void 0 || isRecord(value.customer)) && (value.lines === void 0 || Array.isArray(value.lines)) && (value.discount === void 0 || value.discount === null || isRecord(value.discount)) && (value.taxes === void 0 || Array.isArray(value.taxes)) && isOptionalStringOrNull(value.dueAt) && isOptionalStringOrNull(value.issuedAt) && isOptionalStringOrNull(value.publicToken) && (value.hostedInvoiceEnabled === void 0 || typeof value.hostedInvoiceEnabled === "boolean") && isOptionalStringOrNull(value.hostedInvoiceUrl) && (value.checkoutSessions === void 0 || Array.isArray(value.checkoutSessions)) && (value.payments === void 0 || Array.isArray(value.payments)) && (value.adjustments === void 0 || Array.isArray(value.adjustments)) && (value.deliveries === void 0 || Array.isArray(value.deliveries)) && (value.reminderSchedule === void 0 || isRecord(value.reminderSchedule)) && isOptionalStringOrNull(value.remindersPausedAt) && isOptionalStringOrNull(value.lastReminderAt) && isOptionalStringOrNull(value.nextReminderAt) && isOptionalStringOrNull(value.lastSentAt) && isOptionalString(value.updatedAt) && isOptionalStringOrNull(value.lastActivityAt);
 };
+var isInvoiceCheckoutSessionCreated = (value) => isRecord(value) && typeof value.invoiceId === "string" && typeof value.invoiceNumber === "string" && typeof value.checkoutSessionId === "string" && typeof value.checkoutUrl === "string" && typeof value.amountDue === "string" && typeof value.currencyCode === "string" && typeof value.expiresAt === "string";
+var isRefundReferenceResult = (value) => isRecord(value) && isRecord(value.adjustment) && isInvoice(value.invoice);
+var isInvoiceList = (value) => isRecord(value) && Array.isArray(value.items) && value.items.every(isInvoice) && typeof value.hasMore === "boolean" && isStringOrNull(value.nextCursor);
+var isPaymentLinkCollect = (value) => isRecord(value) && typeof value.email === "boolean" && typeof value.name === "boolean" && typeof value.reference === "boolean";
+var isPaymentLink = (value) => isRecord(value) && typeof value.id === "string" && value.object === "payment_link" && typeof value.publicId === "string" && typeof value.url === "string" && typeof value.merchantId === "string" && typeof value.mode === "string" && typeof value.status === "string" && typeof value.version === "number" && typeof value.title === "string" && typeof value.description === "string" && (value.amountType === "fixed" || value.amountType === "customer_entered") && isStringOrNull(value.amount) && isStringOrNull(value.minimumAmount) && isStringOrNull(value.maximumAmount) && typeof value.currencyCode === "string" && typeof value.chainId === "number" && typeof value.tokenContract === "string" && (value.usageType === "single_use" || value.usageType === "reusable") && typeof value.completedPayments === "number" && typeof value.startedCheckouts === "number" && isStringOrNull(value.activeAt) && isStringOrNull(value.expiresAt) && isStringOrNull(value.pausedAt) && isStringOrNull(value.archivedAt) && isPaymentLinkCollect(value.collect) && typeof value.referencePrefix === "string" && isStringOrNull(value.successUrl) && isStringOrNull(value.cancelUrl) && typeof value.successMessage === "string" && isMetadata(value.metadata) && isStringOrNull(value.reservationInvoiceId) && isStringOrNull(value.reservedAt) && typeof value.createdAt === "string" && typeof value.updatedAt === "string" && isStringOrNull(value.lastCheckoutCreatedAt);
+var isPaymentLinkList = (value) => isRecord(value) && Array.isArray(value.items) && value.items.every(isPaymentLink) && typeof value.hasMore === "boolean" && isStringOrNull(value.nextCursor);
+var isPaymentLinkPayments = (value) => isRecord(value) && Array.isArray(value.items) && value.items.every(isInvoice);
 var isPayment = (value) => {
   if (!isRecord(value)) {
     return false;
   }
-  return typeof value.id === "string" && value.object === "payment" && typeof value.invoiceId === "string" && typeof value.invoiceNumber === "string" && isStringOrNull(value.transactionId) && typeof value.mode === "string" && typeof value.status === "string" && typeof value.amountExpected === "string" && typeof value.amountReceived === "string" && typeof value.platformFee === "string" && typeof value.netAmount === "string" && typeof value.chainId === "number" && typeof value.settlementWalletAddress === "string" && isStringOrNull(value.failureReason) && isStringOrNull(value.confirmedAt) && typeof value.createdAt === "string";
+  return typeof value.id === "string" && value.object === "payment" && typeof value.invoiceId === "string" && typeof value.invoiceNumber === "string" && isStringOrNull(value.transactionId) && typeof value.mode === "string" && typeof value.status === "string" && typeof value.amountExpected === "string" && typeof value.amountReceived === "string" && typeof value.customerAmountTendered === "string" && typeof value.customerAmountCredited === "string" && typeof value.expectedMerchantSettlement === "string" && typeof value.merchantAmountSettled === "string" && typeof value.platformFeeExpected === "string" && typeof value.platformFeeCollected === "string" && typeof value.payerWalletAddress === "string" && typeof value.payerWalletEvidence === "string" && typeof value.creditEvidenceType === "string" && typeof value.migrationState === "string" && typeof value.platformFee === "string" && typeof value.netAmount === "string" && typeof value.chainId === "number" && typeof value.settlementWalletAddress === "string" && isStringOrNull(value.failureReason) && isStringOrNull(value.confirmedAt) && typeof value.createdAt === "string";
 };
 var isWebhookEndpoint = (value) => {
   if (!isRecord(value)) {
     return false;
   }
-  return typeof value.id === "string" && value.object === "webhook_endpoint" && typeof value.mode === "string" && typeof value.url === "string" && typeof value.enabled === "boolean" && isStringArray(value.eventTypes) && typeof value.signingSecret === "string" && typeof value.createdAt === "string";
+  return typeof value.id === "string" && value.object === "webhook_endpoint" && typeof value.mode === "string" && typeof value.url === "string" && typeof value.enabled === "boolean" && isStringArray(value.eventTypes) && (value.signingSecret === void 0 || typeof value.signingSecret === "string") && (value.copyRequired === void 0 || typeof value.copyRequired === "boolean") && typeof value.currentSecretVersion === "number" && Array.isArray(value.secretVersions) && value.secretVersions.every(isWebhookSecretVersion) && isRecord(value.secretOverlap) && typeof value.secretOverlap.status === "string" && isStringOrNull(value.secretOverlap.expiresAt) && (typeof value.secretOverlap.previousVersion === "number" || value.secretOverlap.previousVersion === null) && typeof value.createdAt === "string" && typeof value.updatedAt === "string";
 };
+var isWebhookSecretVersion = (value) => isRecord(value) && typeof value.version === "number" && typeof value.createdAt === "string" && typeof value.activatesAt === "string" && isStringOrNull(value.expiresAt) && isStringOrNull(value.revokedAt) && isStringOrNull(value.testedAt);
+var isWebhookEndpointArray = (value) => Array.isArray(value) && value.every(isWebhookEndpoint);
+var isWebhookEndpointArchive = (value) => isRecord(value) && typeof value.id === "string" && value.object === "webhook_endpoint" && value.archived === true;
+var isWebhookIncident = (value) => isRecord(value) && typeof value.id === "string" && value.object === "webhook_incident" && typeof value.endpointId === "string" && typeof value.mode === "string" && typeof value.status === "string" && typeof value.reasonFamily === "string" && typeof value.failureCount === "number" && typeof value.affectedDeliveryCount === "number" && isStringArray(value.affectedDeliveryIds) && typeof value.firstFailedAt === "string" && typeof value.lastFailedAt === "string" && typeof value.openedAt === "string" && isStringOrNull(value.resolvedAt) && typeof value.lastDeliveryId === "string" && typeof value.lastAttemptId === "string" && typeof value.createdAt === "string" && typeof value.updatedAt === "string";
+var isWebhookIncidentArray = (value) => Array.isArray(value) && value.every(isWebhookIncident);
 var isWebhookEvent = (value) => {
   if (!isRecord(value)) {
     return false;
@@ -472,15 +727,22 @@ var isWebhookDeliveryAttemptSummary = (value) => {
   if (!isRecord(value)) {
     return false;
   }
-  return (typeof value.responseStatusCode === "number" || value.responseStatusCode === null) && isStringOrNull(value.errorMessage) && typeof value.attemptedAt === "string";
+  return (typeof value.responseStatusCode === "number" || value.responseStatusCode === null) && isStringOrNull(value.errorMessage) && (value.errorCategory === void 0 || isStringOrNull(value.errorCategory)) && typeof value.attemptedAt === "string";
 };
+var isWebhookDeliveryAttempt = (value) => isRecord(value) && typeof value.id === "string" && typeof value.attemptNumber === "number" && (typeof value.responseStatusCode === "number" || value.responseStatusCode === null) && isStringOrNull(value.responseBody) && typeof value.responseBodyTruncated === "boolean" && isStringOrNull(value.errorMessage) && (value.errorCategory === void 0 || isStringOrNull(value.errorCategory)) && (value.responseHeaders === void 0 || value.responseHeaders === null || isRecord(value.responseHeaders)) && (value.requestHeaders === void 0 || value.requestHeaders === null || isRecord(value.requestHeaders)) && (value.destinationHost === void 0 || typeof value.destinationHost === "string") && (value.sanitizedAt === void 0 || typeof value.sanitizedAt === "string") && typeof value.attemptedAt === "string" && typeof value.startedAt === "string" && typeof value.completedAt === "string" && typeof value.durationMs === "number";
 var isWebhookDelivery = (value) => {
   if (!isRecord(value)) {
     return false;
   }
-  return typeof value.id === "string" && value.object === "webhook_delivery" && typeof value.endpointId === "string" && isStringOrNull(value.invoiceId) && typeof value.eventType === "string" && typeof value.status === "string" && typeof value.idempotencyKey === "string" && isWebhookEvent(value.payload) && typeof value.nextAttemptAt === "string" && isStringOrNull(value.deliveredAt) && typeof value.attemptCount === "number" && (value.latestAttempt === null || isWebhookDeliveryAttemptSummary(value.latestAttempt)) && typeof value.createdAt === "string";
+  return typeof value.id === "string" && value.object === "webhook_delivery" && typeof value.endpointId === "string" && isStringOrNull(value.invoiceId) && typeof value.eventId === "string" && typeof value.eventType === "string" && typeof value.status === "string" && typeof value.idempotencyKey === "string" && isWebhookEvent(value.payload) && typeof value.nextAttemptAt === "string" && isStringOrNull(value.deliveredAt) && typeof value.attemptCount === "number" && (value.latestErrorCategory === void 0 || isStringOrNull(value.latestErrorCategory)) && (value.latestAttempt === null || isWebhookDeliveryAttemptSummary(value.latestAttempt)) && isStringOrNull(value.replayOfDeliveryId) && isStringOrNull(value.replayRootDeliveryId) && isStringOrNull(value.replayedBy) && isStringOrNull(value.replayedAt) && typeof value.createdAt === "string";
 };
+var isWebhookDeliveryDetail = (value) => isWebhookDelivery(value) && Array.isArray(value.attempts) && value.attempts.every(isWebhookDeliveryAttempt);
+var isWebhookDeliveryAttemptArray = (value) => Array.isArray(value) && value.every(isWebhookDeliveryAttempt);
 var isWebhookDeliveryArray = (value) => Array.isArray(value) && value.every(isWebhookDelivery);
+var isReconciliationSchema = (value) => isRecord(value) && typeof value.schemaVersion === "string" && Array.isArray(value.formats) && Array.isArray(value.dateBases) && typeof value.maximumRangeDays === "number" && typeof value.rangeEnd === "string" && typeof value.retention === "string" && Array.isArray(value.files) && Array.isArray(value.stateRules);
+var isReconciliationSummary = (value) => isRecord(value) && typeof value.schemaVersion === "string" && typeof value.dateBasis === "string" && typeof value.from === "string" && typeof value.to === "string" && typeof value.cutoffAt === "string" && typeof value.timezone === "string" && isRecord(value.rowCounts) && Array.isArray(value.summaryByToken) && Array.isArray(value.exceptions) && isStringArray(value.warnings);
+var isReconciliationExport = (value) => isRecord(value) && typeof value.id === "string" && typeof value.merchantId === "string" && typeof value.mode === "string" && typeof value.status === "string" && typeof value.format === "string" && typeof value.schemaVersion === "string" && isRecord(value.filters) && typeof value.filters.from === "string" && typeof value.filters.to === "string" && typeof value.dateBasis === "string" && typeof value.timezone === "string" && typeof value.requestedBy === "string" && typeof value.requestedAt === "string" && typeof value.attempts === "number" && typeof value.includePII === "boolean" && typeof value.createdAt === "string" && typeof value.updatedAt === "string";
+var isReconciliationExportList = (value) => isRecord(value) && Array.isArray(value.items) && value.items.every(isReconciliationExport) && typeof value.hasMore === "boolean" && (value.nextCursor === void 0 || typeof value.nextCursor === "string");
 var normalizePayloadBytes = (payload) => {
   if (typeof payload === "string") {
     return Buffer.from(payload, "utf8");
@@ -618,9 +880,10 @@ function assertPayclaveWebhookSignature({
     (candidate) => timingSafeHexEqual(candidate, expected)
   )) {
     throw new PayclaveError({
-      message: "Payclave webhook signature is invalid.",
+      message: `Payclave webhook signature is invalid. Verify the signature against the exact raw request body before parsing it. See ${webhookRawBodyGuideUrl}`,
       code: "WEBHOOK_SIGNATURE_INVALID",
-      status: 0
+      status: 0,
+      details: { documentationUrl: webhookRawBodyGuideUrl }
     });
   }
 }
@@ -658,7 +921,7 @@ function createPayclaveServerClient({
   secretKey,
   apiBaseUrl = defaultApiBaseUrl,
   fetcher = defaultFetcher,
-  timeoutMs
+  timeoutMs = defaultTimeoutMs
 }) {
   assertSecretKey(secretKey);
   assertTimeoutMs(timeoutMs);
@@ -744,6 +1007,40 @@ function createPayclaveServerClient({
       guard: isInvoice
     });
   };
+  const createInvoiceDraft = (input) => {
+    assertInvoiceDraftFields(input);
+    const { signal, idempotencyKey, ...body } = input;
+    return request({
+      method: "POST",
+      path: "/v1/invoices",
+      body,
+      idempotencyKey,
+      signal,
+      guard: isInvoice
+    });
+  };
+  const listInvoices = (input = {}) => {
+    const query = new URLSearchParams();
+    if (input.limit !== void 0) {
+      assertPositiveIntegerLimit(input.limit);
+      query.set("limit", String(input.limit));
+    }
+    if (input.startingAfter !== void 0) {
+      assertIdentifier(input.startingAfter, "Starting invoice id");
+      query.set("startingAfter", input.startingAfter);
+    }
+    if (input.collectionState !== void 0) {
+      assertIdentifier(input.collectionState, "Invoice collection state");
+      query.set("collectionState", input.collectionState);
+    }
+    const suffix = query.size > 0 ? `?${query.toString()}` : "";
+    return request({
+      method: "GET",
+      path: `/v1/invoices${suffix}`,
+      signal: input.signal,
+      guard: isInvoiceList
+    });
+  };
   const getInvoice = (id, options = {}) => {
     assertIdentifier(id, "Invoice id");
     return request({
@@ -753,6 +1050,230 @@ function createPayclaveServerClient({
       guard: isInvoice
     });
   };
+  const downloadInvoicePDF = async (id, options = {}) => {
+    assertIdentifier(id, "Invoice id");
+    const response = await runFetch({
+      fetcher,
+      url: joinUrl(
+        normalizedApiBaseUrl,
+        `/v1/invoices/${encodePathSegment(id)}/pdf`
+      ),
+      init: {
+        method: "GET",
+        headers: {
+          Accept: "application/pdf",
+          Authorization: `Bearer ${secretKey}`,
+          "X-Payclave-Client": buildClientHeader()
+        }
+      },
+      externalSignal: options.signal,
+      timeoutMs
+    });
+    return parseInvoicePDFResponse(response);
+  };
+  const updateInvoiceDraft = (id, input) => {
+    assertIdentifier(id, "Invoice id");
+    assertInvoiceDraftFields(input);
+    assertInvoiceVersion(input.version);
+    const { signal, idempotencyKey, ...body } = input;
+    return request({
+      method: "PATCH",
+      path: `/v1/invoices/${encodePathSegment(id)}`,
+      body,
+      idempotencyKey,
+      signal,
+      guard: isInvoice
+    });
+  };
+  const issueInvoice = (id, input) => {
+    assertIdentifier(id, "Invoice id");
+    assertInvoiceVersion(input.version);
+    return request({
+      method: "POST",
+      path: `/v1/invoices/${encodePathSegment(id)}/issue`,
+      body: { version: input.version, send: input.send },
+      idempotencyKey: input.idempotencyKey,
+      signal: input.signal,
+      guard: isInvoice
+    });
+  };
+  const createInvoiceCheckoutSession = (id, input = {}) => {
+    assertIdentifier(id, "Invoice id");
+    return request({
+      method: "POST",
+      path: `/v1/invoices/${encodePathSegment(id)}/checkout-sessions`,
+      idempotencyKey: input.idempotencyKey,
+      signal: input.signal,
+      guard: isInvoiceCheckoutSessionCreated
+    });
+  };
+  const sendInvoice = (id, input = {}) => {
+    assertIdentifier(id, "Invoice id");
+    return request({
+      method: "POST",
+      path: `/v1/invoices/${encodePathSegment(id)}/send`,
+      idempotencyKey: input.idempotencyKey,
+      signal: input.signal,
+      guard: isInvoice
+    });
+  };
+  const remindInvoice = (id, input = {}) => {
+    assertIdentifier(id, "Invoice id");
+    return request({
+      method: "POST",
+      path: `/v1/invoices/${encodePathSegment(id)}/remind`,
+      idempotencyKey: input.idempotencyKey,
+      signal: input.signal,
+      guard: isInvoice
+    });
+  };
+  const invoiceAction = (id, path, input) => {
+    assertIdentifier(id, "Invoice id");
+    return request({
+      method: "POST",
+      path: `/v1/invoices/${encodePathSegment(id)}/${path}`,
+      body: compact({ reason: input.reason }),
+      idempotencyKey: input.idempotencyKey,
+      signal: input.signal,
+      guard: isInvoice
+    });
+  };
+  const voidInvoice = (id, input = {}) => invoiceAction(id, "void", input);
+  const voidInvoiceRemaining = (id, input = {}) => invoiceAction(id, "void-remaining", input);
+  const markInvoiceUncollectible = (id, input = {}) => invoiceAction(id, "mark-uncollectible", input);
+  const duplicateInvoice = (id, input = {}) => {
+    assertIdentifier(id, "Invoice id");
+    return request({
+      method: "POST",
+      path: `/v1/invoices/${encodePathSegment(id)}/duplicate`,
+      idempotencyKey: input.idempotencyKey,
+      signal: input.signal,
+      guard: isInvoice
+    });
+  };
+  const recordInvoiceRefundReference = (id, input) => {
+    assertIdentifier(id, "Invoice id");
+    assertIdentifier(input.paymentId, "Payment id");
+    assertAmount(input.amount);
+    const { signal, idempotencyKey, ...body } = input;
+    return request({
+      method: "POST",
+      path: `/v1/invoices/${encodePathSegment(id)}/refund-references`,
+      body,
+      idempotencyKey,
+      signal,
+      guard: isRefundReferenceResult
+    });
+  };
+  const createPaymentLink = (input) => {
+    assertPaymentLinkFields(input);
+    return request({
+      method: "POST",
+      path: "/v1/payment-links",
+      body: paymentLinkBody(input),
+      idempotencyKey: input.idempotencyKey,
+      signal: input.signal,
+      guard: isPaymentLink
+    });
+  };
+  const listPaymentLinks = (input = {}) => {
+    const query = new URLSearchParams();
+    if (input.limit !== void 0) {
+      assertPositiveIntegerLimit(input.limit);
+      query.set("limit", String(input.limit));
+    }
+    for (const [name, value] of [
+      ["startingAfter", input.startingAfter],
+      ["status", input.status],
+      ["amountType", input.amountType],
+      ["usageType", input.usageType],
+      ["currencyCode", input.currencyCode],
+      ["search", input.search],
+      ["createdFrom", input.createdFrom],
+      ["createdTo", input.createdTo]
+    ]) {
+      if (value !== void 0) {
+        assertIdentifier(value, name);
+        query.set(name, value);
+      }
+    }
+    const suffix = query.size > 0 ? `?${query.toString()}` : "";
+    return request({
+      method: "GET",
+      path: `/v1/payment-links${suffix}`,
+      signal: input.signal,
+      guard: isPaymentLinkList
+    });
+  };
+  const getPaymentLink = (id, options = {}) => {
+    assertIdentifier(id, "Payment link id");
+    return request({
+      method: "GET",
+      path: `/v1/payment-links/${encodePathSegment(id)}`,
+      signal: options.signal,
+      guard: isPaymentLink
+    });
+  };
+  const updatePaymentLink = (id, input) => {
+    assertIdentifier(id, "Payment link id");
+    assertPaymentLinkFields(input);
+    assertPaymentLinkVersion(input.version);
+    return request({
+      method: "PATCH",
+      path: `/v1/payment-links/${encodePathSegment(id)}`,
+      body: { ...paymentLinkBody(input), version: input.version },
+      idempotencyKey: input.idempotencyKey,
+      signal: input.signal,
+      guard: isPaymentLink
+    });
+  };
+  const paymentLinkAction = (id, action, input = {}) => {
+    assertIdentifier(id, "Payment link id");
+    return request({
+      method: "POST",
+      path: `/v1/payment-links/${encodePathSegment(id)}/${action}`,
+      idempotencyKey: input.idempotencyKey,
+      signal: input.signal,
+      guard: isPaymentLink
+    });
+  };
+  const pausePaymentLink = (id, input = {}) => paymentLinkAction(id, "pause", input);
+  const resumePaymentLink = (id, input = {}) => paymentLinkAction(id, "resume", input);
+  const archivePaymentLink = (id, input = {}) => paymentLinkAction(id, "archive", input);
+  const duplicatePaymentLink = (id, input = {}) => paymentLinkAction(id, "duplicate", input);
+  const releasePaymentLinkReservation = (id, input) => {
+    assertIdentifier(id, "Payment link id");
+    if (input.acknowledgeLatePaymentRisk !== true) {
+      throw new PayclaveError({
+        message: "Payment-link reservation release requires explicit late-payment risk acknowledgement.",
+        code: "INVALID_REQUEST_BODY",
+        status: 0
+      });
+    }
+    return request({
+      method: "POST",
+      path: `/v1/payment-links/${encodePathSegment(id)}/release-reservation`,
+      body: { acknowledgeLatePaymentRisk: input.acknowledgeLatePaymentRisk },
+      idempotencyKey: input.idempotencyKey,
+      signal: input.signal,
+      guard: isPaymentLink
+    });
+  };
+  const listPaymentLinkPayments = (id, input = {}) => {
+    assertIdentifier(id, "Payment link id");
+    const query = new URLSearchParams();
+    if (input.limit !== void 0) {
+      assertPositiveIntegerLimit(input.limit);
+      query.set("limit", String(input.limit));
+    }
+    const suffix = query.size > 0 ? `?${query.toString()}` : "";
+    return request({
+      method: "GET",
+      path: `/v1/payment-links/${encodePathSegment(id)}/payments${suffix}`,
+      signal: input.signal,
+      guard: isPaymentLinkPayments
+    });
+  };
   const getPayment = (id, options = {}) => {
     assertIdentifier(id, "Payment id");
     return request({
@@ -776,6 +1297,75 @@ function createPayclaveServerClient({
       guard: isWebhookEndpoint
     });
   };
+  const listWebhookEndpoints = (options = {}) => request({
+    method: "GET",
+    path: "/v1/webhook-endpoints",
+    signal: options.signal,
+    guard: isWebhookEndpointArray
+  });
+  const getWebhookEndpoint = (id, options = {}) => {
+    assertIdentifier(id, "Webhook endpoint id");
+    return request({
+      method: "GET",
+      path: `/v1/webhook-endpoints/${encodePathSegment(id)}`,
+      signal: options.signal,
+      guard: isWebhookEndpoint
+    });
+  };
+  const updateWebhookEndpoint = (id, input) => {
+    assertIdentifier(id, "Webhook endpoint id");
+    const url = input.url === void 0 ? void 0 : normalizeWebhookUrl(input.url);
+    assertWebhookEventTypes(input.eventTypes);
+    if (input.alertThreshold !== void 0 && (!Number.isInteger(input.alertThreshold) || input.alertThreshold < 2 || input.alertThreshold > 10)) {
+      throw new PayclaveError({
+        message: "Webhook alert threshold must be between 2 and 10.",
+        code: "INVALID_ARGUMENT",
+        status: 0
+      });
+    }
+    const { signal, idempotencyKey, ...rest } = input;
+    const body = { ...rest, ...url === void 0 ? {} : { url } };
+    return request({
+      method: "PATCH",
+      path: `/v1/webhook-endpoints/${encodePathSegment(id)}`,
+      body,
+      idempotencyKey,
+      signal,
+      guard: isWebhookEndpoint
+    });
+  };
+  const archiveWebhookEndpoint = (id, input) => {
+    assertIdentifier(id, "Webhook endpoint id");
+    return request({
+      method: "DELETE",
+      path: `/v1/webhook-endpoints/${encodePathSegment(id)}`,
+      idempotencyKey: input.idempotencyKey,
+      signal: input.signal,
+      guard: isWebhookEndpointArchive
+    });
+  };
+  const rotateWebhookSecret = (id, input) => {
+    assertIdentifier(id, "Webhook endpoint id");
+    return request({
+      method: "POST",
+      path: `/v1/webhook-endpoints/${encodePathSegment(id)}/rotate-secret`,
+      body: {},
+      idempotencyKey: input.idempotencyKey,
+      signal: input.signal,
+      guard: isWebhookEndpoint
+    });
+  };
+  const endWebhookSecretOverlap = (id, input) => {
+    assertIdentifier(id, "Webhook endpoint id");
+    return request({
+      method: "POST",
+      path: `/v1/webhook-endpoints/${encodePathSegment(id)}/end-secret-overlap`,
+      body: {},
+      idempotencyKey: input.idempotencyKey,
+      signal: input.signal,
+      guard: isWebhookEndpoint
+    });
+  };
   const createTestWebhook = (input) => {
     assertIdentifier(input.endpointId, "Webhook endpoint id");
     assertWebhookEventTypes(
@@ -797,7 +1387,23 @@ function createPayclaveServerClient({
     if (limit !== void 0) {
       assertPositiveIntegerLimit(limit);
     }
-    const query = limit !== void 0 ? `?limit=${encodeURIComponent(String(limit))}` : "";
+    const params = new URLSearchParams();
+    if (limit !== void 0) params.set("limit", String(limit));
+    for (const [key, value] of [
+      ["endpointId", input.endpointId],
+      ["eventType", input.eventType],
+      ["status", input.status],
+      ["createdFrom", input.createdFrom],
+      ["createdTo", input.createdTo],
+      ["replayStatus", input.replayStatus],
+      ["responseFamily", input.responseFamily]
+    ]) {
+      if (value !== void 0) {
+        assertIdentifier(value, key);
+        params.set(key, value);
+      }
+    }
+    const query = params.size > 0 ? `?${params.toString()}` : "";
     return request({
       method: "GET",
       path: `/v1/webhook-deliveries${query}`,
@@ -805,16 +1411,221 @@ function createPayclaveServerClient({
       guard: isWebhookDeliveryArray
     });
   };
+  const getWebhookDelivery = (id, options = {}) => {
+    assertIdentifier(id, "Webhook delivery id");
+    return request({
+      method: "GET",
+      path: `/v1/webhook-deliveries/${encodePathSegment(id)}`,
+      signal: options.signal,
+      guard: isWebhookDeliveryDetail
+    });
+  };
+  const listWebhookDeliveryAttempts = (id, options = {}) => {
+    assertIdentifier(id, "Webhook delivery id");
+    return request({
+      method: "GET",
+      path: `/v1/webhook-deliveries/${encodePathSegment(id)}/attempts`,
+      signal: options.signal,
+      guard: isWebhookDeliveryAttemptArray
+    });
+  };
+  const replayWebhookDelivery = (id, input) => {
+    assertIdentifier(id, "Webhook delivery id");
+    return request({
+      method: "POST",
+      path: `/v1/webhook-deliveries/${encodePathSegment(id)}/replay`,
+      idempotencyKey: input.idempotencyKey,
+      signal: input.signal,
+      guard: isWebhookDeliveryDetail
+    });
+  };
+  const listWebhookIncidents = (input = {}) => {
+    const query = input.status ? `?status=${input.status}` : "";
+    return request({
+      method: "GET",
+      path: `/v1/webhook-incidents${query}`,
+      signal: input.signal,
+      guard: isWebhookIncidentArray
+    });
+  };
+  const getWebhookIncident = (id, options = {}) => {
+    assertIdentifier(id, "Webhook incident id");
+    return request({
+      method: "GET",
+      path: `/v1/webhook-incidents/${encodePathSegment(id)}`,
+      signal: options.signal,
+      guard: isWebhookIncident
+    });
+  };
+  const getReconciliationSchema = (version = PAYCLAVE_RECONCILIATION_SCHEMA_VERSION, options = {}) => {
+    assertIdentifier(version, "Reconciliation schema version");
+    return request({
+      method: "GET",
+      path: `/v1/reconciliation/schema/${encodePathSegment(version)}`,
+      signal: options.signal,
+      guard: isReconciliationSchema
+    });
+  };
+  const getReconciliationSummary = (input) => {
+    assertIdentifier(input.dateBasis, "Reconciliation date basis");
+    assertIdentifier(input.from, "Reconciliation from timestamp");
+    assertIdentifier(input.to, "Reconciliation to timestamp");
+    const query = new URLSearchParams({
+      dateBasis: input.dateBasis,
+      from: input.from,
+      to: input.to,
+      timezone: input.timezone ?? "UTC"
+    });
+    if (input.exceptionOnly !== void 0) {
+      query.set("exceptionOnly", String(input.exceptionOnly));
+    }
+    for (const status of input.invoiceStatuses ?? []) {
+      query.append("invoiceStatus", status);
+    }
+    for (const status of input.paymentStatuses ?? []) {
+      query.append("paymentStatus", status);
+    }
+    for (const token of input.settlementTokens ?? []) {
+      query.append("settlementToken", token);
+    }
+    return request({
+      method: "GET",
+      path: `/v1/reconciliation/summary?${query.toString()}`,
+      signal: input.signal,
+      guard: isReconciliationSummary
+    });
+  };
+  const createReconciliationExport = (input) => {
+    assertReconciliationFormat(input.format);
+    assertIdentifier(input.dateBasis, "Reconciliation date basis");
+    assertIdentifier(input.from, "Reconciliation from timestamp");
+    assertIdentifier(input.to, "Reconciliation to timestamp");
+    const { signal, idempotencyKey, ...fields } = input;
+    return request({
+      method: "POST",
+      path: "/v1/reconciliation-exports",
+      body: compact({
+        ...fields,
+        mode: input.mode ?? (secretKey.startsWith("sk_live_") ? "live" : "test"),
+        timezone: input.timezone ?? "UTC",
+        exceptionOnly: input.exceptionOnly ?? false,
+        includePII: input.includePII ?? false,
+        schemaVersion: input.schemaVersion ?? PAYCLAVE_RECONCILIATION_SCHEMA_VERSION
+      }),
+      idempotencyKey,
+      signal,
+      guard: isReconciliationExport
+    });
+  };
+  const listReconciliationExports = (input = {}) => {
+    const query = new URLSearchParams();
+    if (input.limit !== void 0) {
+      assertPositiveIntegerLimit(input.limit);
+      query.set("limit", String(input.limit));
+    }
+    if (input.startingAfter !== void 0) {
+      assertIdentifier(input.startingAfter, "Starting reconciliation export id");
+      query.set("startingAfter", input.startingAfter);
+    }
+    const suffix = query.size > 0 ? `?${query.toString()}` : "";
+    return request({
+      method: "GET",
+      path: `/v1/reconciliation-exports${suffix}`,
+      signal: input.signal,
+      guard: isReconciliationExportList
+    });
+  };
+  const getReconciliationExport = (id, options = {}) => {
+    assertIdentifier(id, "Reconciliation export id");
+    return request({
+      method: "GET",
+      path: `/v1/reconciliation-exports/${encodePathSegment(id)}`,
+      signal: options.signal,
+      guard: isReconciliationExport
+    });
+  };
+  const cancelReconciliationExport = (id, input = {}) => {
+    assertIdentifier(id, "Reconciliation export id");
+    return request({
+      method: "POST",
+      path: `/v1/reconciliation-exports/${encodePathSegment(id)}/cancel`,
+      idempotencyKey: input.idempotencyKey,
+      signal: input.signal,
+      guard: isReconciliationExport
+    });
+  };
+  const downloadReconciliationExport = async (id, options = {}) => {
+    assertIdentifier(id, "Reconciliation export id");
+    const response = await runFetch({
+      fetcher,
+      url: joinUrl(
+        normalizedApiBaseUrl,
+        `/v1/reconciliation-exports/${encodePathSegment(id)}/download`
+      ),
+      init: {
+        method: "GET",
+        headers: {
+          Accept: "application/zip",
+          Authorization: `Bearer ${secretKey}`,
+          "X-Payclave-Client": buildClientHeader()
+        }
+      },
+      externalSignal: options.signal,
+      timeoutMs
+    });
+    return parseReconciliationDownloadResponse(response);
+  };
   return {
     createCheckoutSession,
     getCheckoutSession,
     createInvoice,
+    createInvoiceDraft,
+    listInvoices,
     getInvoice,
+    downloadInvoicePDF,
+    updateInvoiceDraft,
+    issueInvoice,
+    sendInvoice,
+    remindInvoice,
+    createInvoiceCheckoutSession,
+    voidInvoice,
+    voidInvoiceRemaining,
+    markInvoiceUncollectible,
+    duplicateInvoice,
+    recordInvoiceRefundReference,
+    createPaymentLink,
+    listPaymentLinks,
+    getPaymentLink,
+    updatePaymentLink,
+    pausePaymentLink,
+    resumePaymentLink,
+    archivePaymentLink,
+    duplicatePaymentLink,
+    releasePaymentLinkReservation,
+    listPaymentLinkPayments,
     getPayment,
     createWebhookEndpoint,
+    listWebhookEndpoints,
+    getWebhookEndpoint,
+    updateWebhookEndpoint,
+    archiveWebhookEndpoint,
+    rotateWebhookSecret,
+    endWebhookSecretOverlap,
     createTestWebhook,
-    listWebhookDeliveries
+    listWebhookDeliveries,
+    getWebhookDelivery,
+    listWebhookDeliveryAttempts,
+    replayWebhookDelivery,
+    listWebhookIncidents,
+    getWebhookIncident,
+    getReconciliationSchema,
+    getReconciliationSummary,
+    createReconciliationExport,
+    listReconciliationExports,
+    getReconciliationExport,
+    cancelReconciliationExport,
+    downloadReconciliationExport
   };
 }
 
-export { PAYCLAVE_API_ERROR_CODES, PAYCLAVE_SERVER_SDK_ERROR_CODES, PAYCLAVE_SERVER_SDK_NAME, PAYCLAVE_SERVER_SDK_VERSION, PAYCLAVE_WEBHOOK_EVENT_TYPES, PAYCLAVE_WEBHOOK_VERIFICATION_ERROR_CODES, PayclaveError, assertPayclaveWebhookSignature, constructPayclaveWebhookEvent, createPayclaveServerClient, verifyPayclaveWebhookSignature };
+export { PAYCLAVE_API_ERROR_CODES, PAYCLAVE_RECONCILIATION_SCHEMA_VERSION, PAYCLAVE_SERVER_SDK_ERROR_CODES, PAYCLAVE_SERVER_SDK_NAME, PAYCLAVE_SERVER_SDK_VERSION, PAYCLAVE_WEBHOOK_EVENT_TYPES, PAYCLAVE_WEBHOOK_VERIFICATION_ERROR_CODES, PayclaveError, assertPayclaveWebhookSignature, constructPayclaveWebhookEvent, createPayclaveServerClient, verifyPayclaveWebhookSignature };