@paykit-sdk/paystack 1.0.0 → 1.0.1

package/dist/index.js

@@ -4048,16 +4048,16 @@ var coerce = {
   date: ((arg) => ZodDate.create({ ...arg, coerce: true }))
 };
 var NEVER = INVALID;
-var paykitCustomer$InboundSchema = (data) => {
+var Customer$inboundSchema = (data) => {
   const { fullName } = core.parseCustomerName({
-    name: [data.first_name, data.last_name].filter(Boolean).join(" ") || "",
+    name: [data.first_name, data.last_name].filter(Boolean).join(" ") ?? void 0,
     email: data.email
   });
   return {
     id: data.customer_code,
     email: data.email,
     name: fullName,
-    phone: data.phone ?? "",
+    phone: data.phone ?? null,
     metadata: data.metadata ?? void 0,
     created_at: new Date(data.created_at),
     updated_at: data.updated_at ? new Date(data.updated_at) : null
@@ -4069,7 +4069,7 @@ var paystackStatusMap = {
   pending: "pending",
   abandoned: "canceled"
 };
-var paykitPayment$InboundSchema = (data, overridePaymentUrl) => {
+var Payment$inboundSchema = (data, overridePaymentUrl) => {
   const rawMetadata = core.parseJSON(
     data.metadata,
     core.Schema.record(core.Schema.string(), core.Schema.unknown())
@@ -4090,7 +4090,7 @@ var paykitPayment$InboundSchema = (data, overridePaymentUrl) => {
     id: data.reference,
     amount: data.amount,
     currency: data.currency,
-    customer: data.customer?.email ?? "",
+    customer: data.customer?.email ? { email: data.customer.email } : null,
     status,
     metadata,
     item_id: itemId,
@@ -4098,7 +4098,7 @@ var paykitPayment$InboundSchema = (data, overridePaymentUrl) => {
     payment_url: overridePaymentUrl ?? null
   };
 };
-var paykitCheckout$InboundSchema = (init, transaction) => {
+var Checkout$inboundSchema = (init, transaction) => {
   const rawMetadata = core.parseJSON(
     transaction.metadata,
     core.Schema.record(core.Schema.string(), core.Schema.unknown())
@@ -4132,7 +4132,7 @@ var paykitCheckout$InboundSchema = (init, transaction) => {
   }
   return {
     id: init.reference,
-    customer: { email: transaction.customer?.email ?? "" },
+    customer: transaction.customer?.email ? { email: transaction.customer.email } : null,
     payment_url: init.authorization_url,
     metadata: Object.keys(metadata).length > 0 ? metadata : null,
     session_type: type ?? "one_time",
@@ -4162,11 +4162,11 @@ var paystackSubscriptionStatusMap = {
   attention: "past_due",
   completed: "expired"
 };
-var paykitSubscription$InboundSchema = (data) => {
+var Subscription$inboundSchema = (data) => {
   const nextPaymentDate = data.next_payment_date ? new Date(data.next_payment_date) : /* @__PURE__ */ new Date();
   return {
     id: data.subscription_code,
-    customer: data.customer?.email ?? "",
+    customer: data.customer?.email ? { email: data.customer.email } : null,
     amount: data.amount,
     currency: data.currency || data.plan?.currency || "NGN",
     status: paystackSubscriptionStatusMap[data.status] ?? "active",
@@ -4180,14 +4180,14 @@ var paykitSubscription$InboundSchema = (data) => {
     payment_url: null
   };
 };
-var paykitRefund$InboundSchema = (data, fallbackCurrency) => ({
+var Refund$inboundSchema = (data, fallbackCurrency) => ({
   id: String(data.id),
   amount: data.amount,
   currency: data.currency || fallbackCurrency,
   reason: data.customer_note || data.merchant_note || null,
   metadata: null
 });
-var paykitInvoice$InboundSchema = (data) => {
+var Invoice$inboundSchema = (data) => {
   const rawMetadata = core.parseJSON(
     data.metadata,
     core.Schema.record(core.Schema.string(), core.Schema.unknown())
@@ -4195,7 +4195,7 @@ var paykitInvoice$InboundSchema = (data) => {
   const metadata = core.omitInternalMetadata(rawMetadata);
   return {
     id: String(data.id),
-    customer: data.customer?.email ?? "",
+    customer: data.customer?.email ? { email: data.customer.email } : null,
     subscription_id: null,
     billing_mode: "one_time",
     amount_paid: data.amount,
@@ -4221,6 +4221,7 @@ var PaystackProvider = class extends core.AbstractPayKitProvider {
   providerName = providerName;
   _client;
   opts;
+  isSandbox;
   constructor(opts) {
     super(paystackOptionsSchema, opts, providerName);
     this.opts = opts;
@@ -4236,6 +4237,7 @@ var PaystackProvider = class extends core.AbstractPayKitProvider {
         debug: opts.debug ?? false
       }
     });
+    this.isSandbox = opts.isSandbox;
   }
   get _native() {
     return null;
@@ -4300,7 +4302,7 @@ var PaystackProvider = class extends core.AbstractPayKitProvider {
     const response = await this._client.post("/transaction/initialize", { body: JSON.stringify(body) });
     const initData = await this.unwrap(response, "createCheckout");
     const rawCustomer = await this._client.get(`/customer/${encodeURIComponent(data.customer.email)}`);
-    return paykitCheckout$InboundSchema(initData, {
+    return Checkout$inboundSchema(initData, {
       amount: body.amount,
       currency: body.currency,
       customer: await this.unwrap(rawCustomer, "createCheckout"),
@@ -4311,7 +4313,7 @@ var PaystackProvider = class extends core.AbstractPayKitProvider {
     const response = await this._client.get(`/transaction/verify/${encodeURIComponent(id)}`);
     if (!response.ok || !response.value?.data) return null;
     const txn = response.value.data;
-    return paykitCheckout$InboundSchema(
+    return Checkout$inboundSchema(
       {
         authorization_url: "",
         reference: txn.reference
@@ -4361,12 +4363,12 @@ var PaystackProvider = class extends core.AbstractPayKitProvider {
     };
     const response = await this._client.post("/customer", { body: JSON.stringify(body) });
     const customer = await this.unwrap(response, "createCustomer");
-    return paykitCustomer$InboundSchema(customer);
+    return Customer$inboundSchema(customer);
   };
   retrieveCustomer = async (id) => {
     const response = await this._client.get(`/customer/${encodeURIComponent(id)}`);
     if (!response.ok || !response.value?.data) return null;
-    return paykitCustomer$InboundSchema(response.value.data);
+    return Customer$inboundSchema(response.value.data);
   };
   updateCustomer = async (id, params) => {
     const body = {
@@ -4387,7 +4389,7 @@ var PaystackProvider = class extends core.AbstractPayKitProvider {
       body: JSON.stringify(body)
     });
     const customer = await this.unwrap(response, "updateCustomer");
-    return paykitCustomer$InboundSchema(customer);
+    return Customer$inboundSchema(customer);
   };
   deleteCustomer = async (_id) => {
     throw new core.ProviderNotSupportedError(
@@ -4399,11 +4401,11 @@ var PaystackProvider = class extends core.AbstractPayKitProvider {
     );
   };
   createSubscription = async (params) => {
-    const customerValue = typeof params.customer === "string" ? params.customer : "email" in params.customer ? params.customer.email : null;
+    const customerValue = core.isEmailCustomer(params.customer) ? params.customer.email : core.isIdCustomer(params.customer) ? String(params.customer.id) : null;
     if (!customerValue) {
       throw new core.InvalidTypeError(
         "customer",
-        "string (customer code) or object with email",
+        "object with email or id",
         typeof params.customer,
         { provider: this.providerName, method: "createSubscription" }
       );
@@ -4420,12 +4422,12 @@ var PaystackProvider = class extends core.AbstractPayKitProvider {
       response,
       "createSubscription"
     );
-    return paykitSubscription$InboundSchema(subscription);
+    return Subscription$inboundSchema(subscription);
   };
   retrieveSubscription = async (id) => {
     const response = await this._client.get(`/subscription/${encodeURIComponent(id)}`);
     if (!response.ok || !response.value?.data) return null;
-    return paykitSubscription$InboundSchema(response.value.data);
+    return Subscription$inboundSchema(response.value.data);
   };
   updateSubscription = async (_id, _params) => {
     throw new core.ProviderNotSupportedError(
@@ -4484,11 +4486,13 @@ var PaystackProvider = class extends core.AbstractPayKitProvider {
     if (core.isEmailCustomer(data.customer)) {
       email = data.customer.email;
     } else if (core.isIdCustomer(data.customer)) {
-      const customer = await this.retrieveCustomer(data.customer);
+      const customer = await this.retrieveCustomer(
+        String(data.customer.id)
+      );
       if (!customer) {
         throw new core.ResourceNotFoundError(
           "customer",
-          data.customer,
+          String(data.customer.id),
           this.providerName
         );
       }
@@ -4496,7 +4500,7 @@ var PaystackProvider = class extends core.AbstractPayKitProvider {
     } else {
       throw new core.InvalidTypeError(
         "customer",
-        "string (customer code) or object with email",
+        "object with email or id",
         typeof data.customer,
         { provider: this.providerName, method: "createPayment" }
       );
@@ -4528,7 +4532,7 @@ var PaystackProvider = class extends core.AbstractPayKitProvider {
       id: initData.reference,
       amount: data.amount,
       currency: data.currency,
-      customer: core.isEmailCustomer(data.customer) ? { email } : email,
+      customer: { email },
       status: "pending",
       metadata: core.stringifyMetadataValues(
         data.metadata ?? {}
@@ -4541,7 +4545,7 @@ var PaystackProvider = class extends core.AbstractPayKitProvider {
   retrievePayment = async (id) => {
     const response = await this._client.get(`/transaction/verify/${encodeURIComponent(id)}`);
     if (!response.ok || !response.value?.data) return null;
-    return paykitPayment$InboundSchema(response.value.data);
+    return Payment$inboundSchema(response.value.data);
   };
   updatePayment = async (_id, _params) => {
     throw new core.ProviderNotSupportedError("updatePayment", "Paystack", {
@@ -4584,9 +4588,15 @@ var PaystackProvider = class extends core.AbstractPayKitProvider {
     };
     const response = await this._client.post("/refund", { body: JSON.stringify(body) });
     const refund = await this.unwrap(response, "createRefund");
-    return paykitRefund$InboundSchema(refund, "NGN");
+    return Refund$inboundSchema(refund, "NGN");
   };
   handleWebhook = async (payload, webhookSecret) => {
+    if (!webhookSecret) {
+      throw new core.WebhookError(
+        "webhookSecret is required for Paystack webhook verification",
+        { provider: this.providerName }
+      );
+    }
     const { body, headersAsObject } = payload;
     const signature = headersAsObject["x-paystack-signature"];
     if (!signature) {
@@ -4629,8 +4639,8 @@ var PaystackProvider = class extends core.AbstractPayKitProvider {
     switch (event.event) {
       case "charge.success": {
         const txn = event.data;
-        const payment = paykitPayment$InboundSchema(txn);
-        const invoice = paykitInvoice$InboundSchema(txn);
+        const payment = Payment$inboundSchema(txn);
+        const invoice = Invoice$inboundSchema(txn);
         return [
           core.paykitEvent$InboundSchema({
             type: "payment.updated",
@@ -4648,10 +4658,10 @@ var PaystackProvider = class extends core.AbstractPayKitProvider {
       }
       case "charge.failed": {
         const txn = event.data;
-        const payment = paykitPayment$InboundSchema(txn);
+        const payment = Payment$inboundSchema(txn);
         return [
           core.paykitEvent$InboundSchema({
-            type: "payment.updated",
+            type: "payment.failed",
             created,
             id,
             data: payment
@@ -4660,7 +4670,7 @@ var PaystackProvider = class extends core.AbstractPayKitProvider {
       }
       case "customer.create": {
         const customerData = event.data;
-        const customer = paykitCustomer$InboundSchema(customerData);
+        const customer = Customer$inboundSchema(customerData);
         return [
           core.paykitEvent$InboundSchema({
             type: "customer.created",
@@ -4673,7 +4683,7 @@ var PaystackProvider = class extends core.AbstractPayKitProvider {
       case "customeridentification.success":
       case "customeridentification.failed": {
         const customerData = event.data;
-        const customer = paykitCustomer$InboundSchema(customerData);
+        const customer = Customer$inboundSchema(customerData);
         return [
           core.paykitEvent$InboundSchema({
             type: "customer.updated",
@@ -4685,7 +4695,7 @@ var PaystackProvider = class extends core.AbstractPayKitProvider {
       }
       case "subscription.create": {
         const subData = event.data;
-        const subscription = paykitSubscription$InboundSchema(subData);
+        const subscription = Subscription$inboundSchema(subData);
         return [
           core.paykitEvent$InboundSchema({
             type: "subscription.created",
@@ -4710,7 +4720,7 @@ var PaystackProvider = class extends core.AbstractPayKitProvider {
       case "invoice.update": {
         const invoiceData = event.data;
         if (!invoiceData.transaction) return null;
-        const payment = paykitPayment$InboundSchema(
+        const payment = Payment$inboundSchema(
           invoiceData.transaction
         );
         return [
@@ -4725,12 +4735,12 @@ var PaystackProvider = class extends core.AbstractPayKitProvider {
       case "invoice.payment_failed": {
         const invoiceData = event.data;
         if (!invoiceData.transaction) return null;
-        const payment = paykitPayment$InboundSchema(
+        const payment = Payment$inboundSchema(
           invoiceData.transaction
         );
         return [
           core.paykitEvent$InboundSchema({
-            type: "payment.updated",
+            type: "payment.failed",
             created,
             id,
             data: { ...payment, status: "failed" }
@@ -4741,7 +4751,7 @@ var PaystackProvider = class extends core.AbstractPayKitProvider {
       case "refund.processed":
       case "refund.failed": {
         const refundData = event.data;
-        const refund = paykitRefund$InboundSchema(refundData, "NGN");
+        const refund = Refund$inboundSchema(refundData, "NGN");
         return [
           core.paykitEvent$InboundSchema({
             type: "refund.created",

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { schema, AbstractPayKitProvider, HTTPClient, OperationFailedError, createCheckoutSchema, ValidationError, isEmailCustomer, InvalidTypeError, PAYKIT_METADATA_KEY, stringifyMetadataValues, ProviderNotSupportedError, createCustomerSchema, parseCustomerName, ResourceNotFoundError, createPaymentSchema, isIdCustomer, createRefundSchema, WebhookError, paykitEvent$InboundSchema, validateRequiredKeys, parseJSON, Schema, omitInternalMetadata, billingModeSchema } from '@paykit-sdk/core';
+import { schema, AbstractPayKitProvider, HTTPClient, OperationFailedError, createCheckoutSchema, ValidationError, isEmailCustomer, InvalidTypeError, PAYKIT_METADATA_KEY, stringifyMetadataValues, ProviderNotSupportedError, createCustomerSchema, parseCustomerName, isIdCustomer, ResourceNotFoundError, createPaymentSchema, createRefundSchema, WebhookError, paykitEvent$InboundSchema, validateRequiredKeys, parseJSON, Schema, omitInternalMetadata, billingModeSchema } from '@paykit-sdk/core';
 import { createHmac } from 'crypto';
 
 var __defProp = Object.defineProperty;
@@ -4046,16 +4046,16 @@ var coerce = {
   date: ((arg) => ZodDate.create({ ...arg, coerce: true }))
 };
 var NEVER = INVALID;
-var paykitCustomer$InboundSchema = (data) => {
+var Customer$inboundSchema = (data) => {
   const { fullName } = parseCustomerName({
-    name: [data.first_name, data.last_name].filter(Boolean).join(" ") || "",
+    name: [data.first_name, data.last_name].filter(Boolean).join(" ") ?? void 0,
     email: data.email
   });
   return {
     id: data.customer_code,
     email: data.email,
     name: fullName,
-    phone: data.phone ?? "",
+    phone: data.phone ?? null,
     metadata: data.metadata ?? void 0,
     created_at: new Date(data.created_at),
     updated_at: data.updated_at ? new Date(data.updated_at) : null
@@ -4067,7 +4067,7 @@ var paystackStatusMap = {
   pending: "pending",
   abandoned: "canceled"
 };
-var paykitPayment$InboundSchema = (data, overridePaymentUrl) => {
+var Payment$inboundSchema = (data, overridePaymentUrl) => {
   const rawMetadata = parseJSON(
     data.metadata,
     Schema.record(Schema.string(), Schema.unknown())
@@ -4088,7 +4088,7 @@ var paykitPayment$InboundSchema = (data, overridePaymentUrl) => {
     id: data.reference,
     amount: data.amount,
     currency: data.currency,
-    customer: data.customer?.email ?? "",
+    customer: data.customer?.email ? { email: data.customer.email } : null,
     status,
     metadata,
     item_id: itemId,
@@ -4096,7 +4096,7 @@ var paykitPayment$InboundSchema = (data, overridePaymentUrl) => {
     payment_url: overridePaymentUrl ?? null
   };
 };
-var paykitCheckout$InboundSchema = (init, transaction) => {
+var Checkout$inboundSchema = (init, transaction) => {
   const rawMetadata = parseJSON(
     transaction.metadata,
     Schema.record(Schema.string(), Schema.unknown())
@@ -4130,7 +4130,7 @@ var paykitCheckout$InboundSchema = (init, transaction) => {
   }
   return {
     id: init.reference,
-    customer: { email: transaction.customer?.email ?? "" },
+    customer: transaction.customer?.email ? { email: transaction.customer.email } : null,
     payment_url: init.authorization_url,
     metadata: Object.keys(metadata).length > 0 ? metadata : null,
     session_type: type ?? "one_time",
@@ -4160,11 +4160,11 @@ var paystackSubscriptionStatusMap = {
   attention: "past_due",
   completed: "expired"
 };
-var paykitSubscription$InboundSchema = (data) => {
+var Subscription$inboundSchema = (data) => {
   const nextPaymentDate = data.next_payment_date ? new Date(data.next_payment_date) : /* @__PURE__ */ new Date();
   return {
     id: data.subscription_code,
-    customer: data.customer?.email ?? "",
+    customer: data.customer?.email ? { email: data.customer.email } : null,
     amount: data.amount,
     currency: data.currency || data.plan?.currency || "NGN",
     status: paystackSubscriptionStatusMap[data.status] ?? "active",
@@ -4178,14 +4178,14 @@ var paykitSubscription$InboundSchema = (data) => {
     payment_url: null
   };
 };
-var paykitRefund$InboundSchema = (data, fallbackCurrency) => ({
+var Refund$inboundSchema = (data, fallbackCurrency) => ({
   id: String(data.id),
   amount: data.amount,
   currency: data.currency || fallbackCurrency,
   reason: data.customer_note || data.merchant_note || null,
   metadata: null
 });
-var paykitInvoice$InboundSchema = (data) => {
+var Invoice$inboundSchema = (data) => {
   const rawMetadata = parseJSON(
     data.metadata,
     Schema.record(Schema.string(), Schema.unknown())
@@ -4193,7 +4193,7 @@ var paykitInvoice$InboundSchema = (data) => {
   const metadata = omitInternalMetadata(rawMetadata);
   return {
     id: String(data.id),
-    customer: data.customer?.email ?? "",
+    customer: data.customer?.email ? { email: data.customer.email } : null,
     subscription_id: null,
     billing_mode: "one_time",
     amount_paid: data.amount,
@@ -4219,6 +4219,7 @@ var PaystackProvider = class extends AbstractPayKitProvider {
   providerName = providerName;
   _client;
   opts;
+  isSandbox;
   constructor(opts) {
     super(paystackOptionsSchema, opts, providerName);
     this.opts = opts;
@@ -4234,6 +4235,7 @@ var PaystackProvider = class extends AbstractPayKitProvider {
         debug: opts.debug ?? false
       }
     });
+    this.isSandbox = opts.isSandbox;
   }
   get _native() {
     return null;
@@ -4298,7 +4300,7 @@ var PaystackProvider = class extends AbstractPayKitProvider {
     const response = await this._client.post("/transaction/initialize", { body: JSON.stringify(body) });
     const initData = await this.unwrap(response, "createCheckout");
     const rawCustomer = await this._client.get(`/customer/${encodeURIComponent(data.customer.email)}`);
-    return paykitCheckout$InboundSchema(initData, {
+    return Checkout$inboundSchema(initData, {
       amount: body.amount,
       currency: body.currency,
       customer: await this.unwrap(rawCustomer, "createCheckout"),
@@ -4309,7 +4311,7 @@ var PaystackProvider = class extends AbstractPayKitProvider {
     const response = await this._client.get(`/transaction/verify/${encodeURIComponent(id)}`);
     if (!response.ok || !response.value?.data) return null;
     const txn = response.value.data;
-    return paykitCheckout$InboundSchema(
+    return Checkout$inboundSchema(
       {
         authorization_url: "",
         reference: txn.reference
@@ -4359,12 +4361,12 @@ var PaystackProvider = class extends AbstractPayKitProvider {
     };
     const response = await this._client.post("/customer", { body: JSON.stringify(body) });
     const customer = await this.unwrap(response, "createCustomer");
-    return paykitCustomer$InboundSchema(customer);
+    return Customer$inboundSchema(customer);
   };
   retrieveCustomer = async (id) => {
     const response = await this._client.get(`/customer/${encodeURIComponent(id)}`);
     if (!response.ok || !response.value?.data) return null;
-    return paykitCustomer$InboundSchema(response.value.data);
+    return Customer$inboundSchema(response.value.data);
   };
   updateCustomer = async (id, params) => {
     const body = {
@@ -4385,7 +4387,7 @@ var PaystackProvider = class extends AbstractPayKitProvider {
       body: JSON.stringify(body)
     });
     const customer = await this.unwrap(response, "updateCustomer");
-    return paykitCustomer$InboundSchema(customer);
+    return Customer$inboundSchema(customer);
   };
   deleteCustomer = async (_id) => {
     throw new ProviderNotSupportedError(
@@ -4397,11 +4399,11 @@ var PaystackProvider = class extends AbstractPayKitProvider {
     );
   };
   createSubscription = async (params) => {
-    const customerValue = typeof params.customer === "string" ? params.customer : "email" in params.customer ? params.customer.email : null;
+    const customerValue = isEmailCustomer(params.customer) ? params.customer.email : isIdCustomer(params.customer) ? String(params.customer.id) : null;
     if (!customerValue) {
       throw new InvalidTypeError(
         "customer",
-        "string (customer code) or object with email",
+        "object with email or id",
         typeof params.customer,
         { provider: this.providerName, method: "createSubscription" }
       );
@@ -4418,12 +4420,12 @@ var PaystackProvider = class extends AbstractPayKitProvider {
       response,
       "createSubscription"
     );
-    return paykitSubscription$InboundSchema(subscription);
+    return Subscription$inboundSchema(subscription);
   };
   retrieveSubscription = async (id) => {
     const response = await this._client.get(`/subscription/${encodeURIComponent(id)}`);
     if (!response.ok || !response.value?.data) return null;
-    return paykitSubscription$InboundSchema(response.value.data);
+    return Subscription$inboundSchema(response.value.data);
   };
   updateSubscription = async (_id, _params) => {
     throw new ProviderNotSupportedError(
@@ -4482,11 +4484,13 @@ var PaystackProvider = class extends AbstractPayKitProvider {
     if (isEmailCustomer(data.customer)) {
       email = data.customer.email;
     } else if (isIdCustomer(data.customer)) {
-      const customer = await this.retrieveCustomer(data.customer);
+      const customer = await this.retrieveCustomer(
+        String(data.customer.id)
+      );
       if (!customer) {
         throw new ResourceNotFoundError(
           "customer",
-          data.customer,
+          String(data.customer.id),
           this.providerName
         );
       }
@@ -4494,7 +4498,7 @@ var PaystackProvider = class extends AbstractPayKitProvider {
     } else {
       throw new InvalidTypeError(
         "customer",
-        "string (customer code) or object with email",
+        "object with email or id",
         typeof data.customer,
         { provider: this.providerName, method: "createPayment" }
       );
@@ -4526,7 +4530,7 @@ var PaystackProvider = class extends AbstractPayKitProvider {
       id: initData.reference,
       amount: data.amount,
       currency: data.currency,
-      customer: isEmailCustomer(data.customer) ? { email } : email,
+      customer: { email },
       status: "pending",
       metadata: stringifyMetadataValues(
         data.metadata ?? {}
@@ -4539,7 +4543,7 @@ var PaystackProvider = class extends AbstractPayKitProvider {
   retrievePayment = async (id) => {
     const response = await this._client.get(`/transaction/verify/${encodeURIComponent(id)}`);
     if (!response.ok || !response.value?.data) return null;
-    return paykitPayment$InboundSchema(response.value.data);
+    return Payment$inboundSchema(response.value.data);
   };
   updatePayment = async (_id, _params) => {
     throw new ProviderNotSupportedError("updatePayment", "Paystack", {
@@ -4582,9 +4586,15 @@ var PaystackProvider = class extends AbstractPayKitProvider {
     };
     const response = await this._client.post("/refund", { body: JSON.stringify(body) });
     const refund = await this.unwrap(response, "createRefund");
-    return paykitRefund$InboundSchema(refund, "NGN");
+    return Refund$inboundSchema(refund, "NGN");
   };
   handleWebhook = async (payload, webhookSecret) => {
+    if (!webhookSecret) {
+      throw new WebhookError(
+        "webhookSecret is required for Paystack webhook verification",
+        { provider: this.providerName }
+      );
+    }
     const { body, headersAsObject } = payload;
     const signature = headersAsObject["x-paystack-signature"];
     if (!signature) {
@@ -4627,8 +4637,8 @@ var PaystackProvider = class extends AbstractPayKitProvider {
     switch (event.event) {
       case "charge.success": {
         const txn = event.data;
-        const payment = paykitPayment$InboundSchema(txn);
-        const invoice = paykitInvoice$InboundSchema(txn);
+        const payment = Payment$inboundSchema(txn);
+        const invoice = Invoice$inboundSchema(txn);
         return [
           paykitEvent$InboundSchema({
             type: "payment.updated",
@@ -4646,10 +4656,10 @@ var PaystackProvider = class extends AbstractPayKitProvider {
       }
       case "charge.failed": {
         const txn = event.data;
-        const payment = paykitPayment$InboundSchema(txn);
+        const payment = Payment$inboundSchema(txn);
         return [
           paykitEvent$InboundSchema({
-            type: "payment.updated",
+            type: "payment.failed",
             created,
             id,
             data: payment
@@ -4658,7 +4668,7 @@ var PaystackProvider = class extends AbstractPayKitProvider {
       }
       case "customer.create": {
         const customerData = event.data;
-        const customer = paykitCustomer$InboundSchema(customerData);
+        const customer = Customer$inboundSchema(customerData);
         return [
           paykitEvent$InboundSchema({
             type: "customer.created",
@@ -4671,7 +4681,7 @@ var PaystackProvider = class extends AbstractPayKitProvider {
       case "customeridentification.success":
       case "customeridentification.failed": {
         const customerData = event.data;
-        const customer = paykitCustomer$InboundSchema(customerData);
+        const customer = Customer$inboundSchema(customerData);
         return [
           paykitEvent$InboundSchema({
             type: "customer.updated",
@@ -4683,7 +4693,7 @@ var PaystackProvider = class extends AbstractPayKitProvider {
       }
       case "subscription.create": {
         const subData = event.data;
-        const subscription = paykitSubscription$InboundSchema(subData);
+        const subscription = Subscription$inboundSchema(subData);
         return [
           paykitEvent$InboundSchema({
             type: "subscription.created",
@@ -4708,7 +4718,7 @@ var PaystackProvider = class extends AbstractPayKitProvider {
       case "invoice.update": {
         const invoiceData = event.data;
         if (!invoiceData.transaction) return null;
-        const payment = paykitPayment$InboundSchema(
+        const payment = Payment$inboundSchema(
           invoiceData.transaction
         );
         return [
@@ -4723,12 +4733,12 @@ var PaystackProvider = class extends AbstractPayKitProvider {
       case "invoice.payment_failed": {
         const invoiceData = event.data;
         if (!invoiceData.transaction) return null;
-        const payment = paykitPayment$InboundSchema(
+        const payment = Payment$inboundSchema(
           invoiceData.transaction
         );
         return [
           paykitEvent$InboundSchema({
-            type: "payment.updated",
+            type: "payment.failed",
             created,
             id,
             data: { ...payment, status: "failed" }
@@ -4739,7 +4749,7 @@ var PaystackProvider = class extends AbstractPayKitProvider {
       case "refund.processed":
       case "refund.failed": {
         const refundData = event.data;
-        const refund = paykitRefund$InboundSchema(refundData, "NGN");
+        const refund = Refund$inboundSchema(refundData, "NGN");
         return [
           paykitEvent$InboundSchema({
             type: "refund.created",

package/dist/paystack-provider.d.mts

@@ -13,7 +13,7 @@ interface PaystackMetadata extends ProviderMetadataRegistry {
 }
 interface PaystackOptions extends PaykitProviderOptions {
     /**
-     * Paystack secret key (sk_live_xxx or sk_test_xxx)
+     * Paystack secret key
      */
     secretKey: string;
 }
@@ -21,6 +21,7 @@ declare class PaystackProvider extends AbstractPayKitProvider implements PayKitP
     readonly providerName = "paystack";
     private readonly _client;
     private readonly opts;
+    readonly isSandbox: boolean;
     constructor(opts: PaystackOptions);
     get _native(): null;
     private _toCamel;
@@ -45,7 +46,7 @@ declare class PaystackProvider extends AbstractPayKitProvider implements PayKitP
     capturePayment: (_id: string, _params: CapturePaymentSchema) => Promise<Payment>;
     cancelPayment: (_id: string) => Promise<Payment>;
     createRefund: (params: CreateRefundSchema<PaystackMetadata["refund"]>) => Promise<Refund>;
-    handleWebhook: (payload: WebhookHandlerConfig, webhookSecret: string) => Promise<Array<WebhookEventPayload<PaystackRawEvents>>>;
+    handleWebhook: (payload: WebhookHandlerConfig, webhookSecret: string | null) => Promise<Array<WebhookEventPayload<PaystackRawEvents>>>;
     private mapToStandardEvents;
 }