@paykit-sdk/polar 1.1.96 → 1.1.98

package/README.md

@@ -86,10 +86,11 @@ export async function POST(request: NextRequest) {
     });
 
   const body = await request.text();
-  const headers = Object.fromEntries(request.headers.entries());
-  await webhook.handle({ body, headers, fullUrl: request.url });
+  const headers = request.headers;
+  const fullUrl = request.url;
+
+  await webhook.handle({ body, headers, fullUrl });
 
-  // Return immediately, processing happens in background
   return NextResponse.json({ success: true });
 }
 ```
@@ -131,11 +132,12 @@ app.post(
           console.log('Refund created:', event.data);
         });
 
-      const body = req.body; // Raw buffer from express.raw()
-      const headers = req.headers;
-      await webhook.handle({ body, headers });
+      const body = typeof req.body === 'string' ? req.body : JSON.stringify(req.body);
+      const headers = new Headers(Object.entries(req.headers) as [string, string][]);
+      const fullUrl = `${req.protocol}://${req.get('host')}${req.originalUrl}`;
+
+      await webhook.handle({ body, headers, fullUrl });
 
-      // Return immediately, processing happens in background
       res.json({ success: true });
     } catch (error) {
       console.error('Webhook error:', error);
@@ -174,17 +176,17 @@ app.listen(3000, () => {
 });
 ```
 
-## Subscription Management
-
-```typescript
-// Update subscription
-await paykit.subscriptions.update('sub_123', {
-  metadata: { plan: 'enterprise' },
-});
-
-// Cancel subscription
-await paykit.subscriptions.cancel('sub_123');
-```
+## Webhook Events
+
+- order.paid
+- order.created
+- customer.created
+- customer.updated
+- customer.deleted
+- subscription.updated
+- subscription.created
+- subscription.revoked
+- refund.created
 
 ## Environment Variables
 

package/dist/index.js

@@ -4057,7 +4057,7 @@ var paykitCheckout$InboundSchema = (checkout) => {
     customer: checkout.customerId ? checkout.customerId : { email: checkout.customerEmail ?? "" },
     session_type: checkout.subscriptionId ? "recurring" : "one_time",
     products: checkout.products.map((product) => ({ id: product.id, quantity: 1 })),
-    metadata: checkout.metadata ?? null,
+    metadata: core.omitInternalMetadata(checkout.metadata) ?? null,
     currency: checkout.currency,
     amount: checkout.amount
   };
@@ -4110,7 +4110,10 @@ var paykitInvoice$InboundSchema = (invoice) => {
     status,
     subscription_id: invoice.subscription?.id ?? null,
     paid_at: new Date(invoice.createdAt).toISOString(),
-    line_items: []
+    line_items: invoice.items.map(({ productPriceId }) => ({
+      id: productPriceId ?? "",
+      quantity: invoice.items.length
+    }))
   };
 };
 var paykitPayment$InboundSchema = (checkout) => {
@@ -4127,8 +4130,10 @@ var paykitPayment$InboundSchema = (checkout) => {
     currency: checkout.currency,
     customer: checkout.customerId ? checkout.customerId : { email: checkout.customerEmail ?? "" },
     status: statusMap[checkout.status],
-    metadata: checkout.metadata ?? {},
-    item_id: checkout.products.length > 0 ? checkout.products[0].id : null
+    metadata: core.omitInternalMetadata(checkout.metadata) ?? {},
+    item_id: checkout.products.length > 0 ? checkout.products[0].id : null,
+    requires_action: checkout.status === "open" ? true : false,
+    payment_url: checkout.status === "open" ? checkout.url : null
   };
 };
 var mapRefundReason = (debug, reason) => {
@@ -4186,10 +4191,16 @@ var PolarProvider = class extends core.AbstractPayKitProvider {
       const { metadata, item_id, provider_metadata } = data;
       const checkoutMetadata = core.stringifyMetadataValues(metadata ?? {});
       const checkoutCreateOptions = {
+        ...provider_metadata,
         metadata: checkoutMetadata,
         products: [item_id],
-        ...provider_metadata
+        successUrl: data.success_url
       };
+      if (typeof data.customer === "object" && "email" in data.customer) {
+        checkoutCreateOptions.customerEmail = data.customer.email;
+      } else if (typeof data.customer === "string") {
+        checkoutCreateOptions.customerId = data.customer;
+      }
       if (data.billing) {
         checkoutCreateOptions.customerBillingAddress = {
           line1: data.billing.address.line1,
@@ -4324,9 +4335,15 @@ var PolarProvider = class extends core.AbstractPayKitProvider {
       if (error) {
         throw core.ValidationError.fromZodError(error, this.providerName, "updateSubscription");
       }
+      if (!data.provider_metadata || Object.keys(data.provider_metadata).length === 0) {
+        throw new core.ValidationError(
+          "Polar requires specific update type via provider_metadata. Use one of: { productId: string } | { discountId: string } | { trialEnd: Date }",
+          { provider: this.providerName, method: "updateSubscription" }
+        );
+      }
       const response = await this.polar.subscriptions.update({
         id,
-        subscriptionUpdate: { ...data.metadata ?? {} }
+        subscriptionUpdate: data.provider_metadata
       });
       return paykitSubscription$InboundSchema(response);
     };
@@ -4384,10 +4401,11 @@ var PolarProvider = class extends core.AbstractPayKitProvider {
       const checkoutResponse = await this.polar.checkouts.update({
         id,
         checkoutUpdate: {
-          ...rest,
+          ...provider_metadata,
           ...rest.metadata && { metadata: paymentMetadata },
           ...rest.item_id && { products: [rest.item_id] },
-          ...provider_metadata
+          ...rest.amount && { amount: rest.amount },
+          ...rest.currency && { currency: rest.currency }
         }
       });
       return paykitPayment$InboundSchema(checkoutResponse);
@@ -4448,71 +4466,67 @@ var PolarProvider = class extends core.AbstractPayKitProvider {
          */
         "order.paid": (data2) => {
           const { status, metadata } = data2;
-          if (status == "paid") {
-            const invoice = paykitInvoice$InboundSchema({
-              ...data2,
-              billingMode: core.billingModeSchema.parse("one_time"),
-              metadata: { ...metadata ?? {} }
-            });
-            const payment = {
-              id: data2.id,
-              amount: data2.totalAmount,
-              currency: data2.currency,
-              customer: data2.customerId ? data2.customerId : { email: data2.customer.email ?? "" },
-              status: data2.status === "paid" ? "succeeded" : "pending",
-              metadata: core.stringifyMetadataValues(metadata ?? {}),
-              item_id: data2.product.id
-            };
-            return [
-              core.paykitEvent$InboundSchema({
-                type: "payment.updated",
-                created: parseInt(webhookTimestamp),
-                id: webhookId,
-                data: payment
-              }),
-              core.paykitEvent$InboundSchema({
-                type: "invoice.generated",
-                created: parseInt(webhookTimestamp),
-                id: webhookId,
-                data: invoice
-              })
-            ];
+          if (status !== "paid") {
+            return null;
           }
-          return null;
+          const isSubscription = ["subscription_create", "subscription_cycle"].includes(
+            data2.billingReason
+          );
+          const invoice = paykitInvoice$InboundSchema({
+            ...data2,
+            billingMode: core.billingModeSchema.parse(isSubscription ? "recurring" : "one_time"),
+            metadata: { ...metadata ?? {} }
+          });
+          const payment = {
+            id: data2.id,
+            amount: data2.totalAmount,
+            currency: data2.currency,
+            customer: data2.customerId ? data2.customerId : { email: data2.customer.email ?? "" },
+            status: data2.status === "paid" ? "succeeded" : "pending",
+            metadata: core.stringifyMetadataValues(metadata ?? {}),
+            item_id: data2.product.id,
+            requires_action: false,
+            payment_url: null
+          };
+          return [
+            core.paykitEvent$InboundSchema({
+              type: "payment.updated",
+              created: parseInt(webhookTimestamp),
+              id: webhookId,
+              data: payment
+            }),
+            core.paykitEvent$InboundSchema({
+              type: "invoice.generated",
+              created: parseInt(webhookTimestamp),
+              id: webhookId,
+              data: invoice
+            })
+          ];
         },
         "order.created": (data2) => {
           const { billingReason, metadata, status } = data2;
-          if (["subscription_create", "subscription_cycle"].includes(billingReason) && status == "paid") {
-            const invoice = paykitInvoice$InboundSchema({
-              ...data2,
-              billingMode: core.billingModeSchema.parse("recurring"),
-              metadata: { ...metadata ?? {} }
-            });
-            const payment = {
-              id: data2.id,
-              amount: data2.totalAmount,
-              currency: data2.currency,
-              customer: data2.customerId ? data2.customerId : { email: data2.customer.email ?? "" },
-              status: data2.status === "paid" ? "succeeded" : "pending",
-              metadata: core.stringifyMetadataValues(metadata ?? {}),
-              item_id: data2.product.id
-            };
-            return [
-              core.paykitEvent$InboundSchema({
-                type: "payment.created",
-                created: parseInt(webhookTimestamp),
-                id: webhookId,
-                data: payment
-              }),
-              core.paykitEvent$InboundSchema({
-                type: "invoice.generated",
-                created: parseInt(webhookTimestamp),
-                id: webhookId,
-                data: invoice
-              })
-            ];
+          if (status !== "paid") {
+            return null;
           }
-          return null;
+          const payment = {
+            id: data2.id,
+            amount: data2.totalAmount,
+            currency: data2.currency,
+            customer: data2.customerId ? data2.customerId : { email: data2.customer.email ?? "" },
+            status: data2.status === "paid" ? "succeeded" : "pending",
+            metadata: core.stringifyMetadataValues(metadata ?? {}),
+            item_id: data2.product.id,
+            requires_action: data2.status === "paid" ? false : true,
+            payment_url: null
+          };
+          return [
+            core.paykitEvent$InboundSchema({
+              type: "payment.created",
+              created: parseInt(webhookTimestamp),
+              id: webhookId,
+              data: payment
+            })
+          ];
         },
         /**
          * Customer
@@ -4602,8 +4616,12 @@ var PolarProvider = class extends core.AbstractPayKitProvider {
       if (!handler)
         throw new Error(`Unhandled event type: ${type} for provider: ${this.providerName}`);
       const results = handler(data);
-      if (!results)
-        throw new Error(`Unhandled event type: ${type} for provider: ${this.providerName}`);
+      if (!results) {
+        console.log(
+          `Skipping event ${type} for provider: ${this.providerName} as no action needed`
+        );
+        return [];
+      }
       return results;
     };
     const { accessToken, isSandbox, debug = true, ...rest } = config;

package/dist/index.mjs

@@ -4055,7 +4055,7 @@ var paykitCheckout$InboundSchema = (checkout) => {
     customer: checkout.customerId ? checkout.customerId : { email: checkout.customerEmail ?? "" },
     session_type: checkout.subscriptionId ? "recurring" : "one_time",
     products: checkout.products.map((product) => ({ id: product.id, quantity: 1 })),
-    metadata: checkout.metadata ?? null,
+    metadata: omitInternalMetadata(checkout.metadata) ?? null,
     currency: checkout.currency,
     amount: checkout.amount
   };
@@ -4108,7 +4108,10 @@ var paykitInvoice$InboundSchema = (invoice) => {
     status,
     subscription_id: invoice.subscription?.id ?? null,
     paid_at: new Date(invoice.createdAt).toISOString(),
-    line_items: []
+    line_items: invoice.items.map(({ productPriceId }) => ({
+      id: productPriceId ?? "",
+      quantity: invoice.items.length
+    }))
   };
 };
 var paykitPayment$InboundSchema = (checkout) => {
@@ -4125,8 +4128,10 @@ var paykitPayment$InboundSchema = (checkout) => {
     currency: checkout.currency,
     customer: checkout.customerId ? checkout.customerId : { email: checkout.customerEmail ?? "" },
     status: statusMap[checkout.status],
-    metadata: checkout.metadata ?? {},
-    item_id: checkout.products.length > 0 ? checkout.products[0].id : null
+    metadata: omitInternalMetadata(checkout.metadata) ?? {},
+    item_id: checkout.products.length > 0 ? checkout.products[0].id : null,
+    requires_action: checkout.status === "open" ? true : false,
+    payment_url: checkout.status === "open" ? checkout.url : null
   };
 };
 var mapRefundReason = (debug, reason) => {
@@ -4184,10 +4189,16 @@ var PolarProvider = class extends AbstractPayKitProvider {
       const { metadata, item_id, provider_metadata } = data;
       const checkoutMetadata = stringifyMetadataValues(metadata ?? {});
       const checkoutCreateOptions = {
+        ...provider_metadata,
         metadata: checkoutMetadata,
         products: [item_id],
-        ...provider_metadata
+        successUrl: data.success_url
       };
+      if (typeof data.customer === "object" && "email" in data.customer) {
+        checkoutCreateOptions.customerEmail = data.customer.email;
+      } else if (typeof data.customer === "string") {
+        checkoutCreateOptions.customerId = data.customer;
+      }
       if (data.billing) {
         checkoutCreateOptions.customerBillingAddress = {
           line1: data.billing.address.line1,
@@ -4322,9 +4333,15 @@ var PolarProvider = class extends AbstractPayKitProvider {
       if (error) {
         throw ValidationError.fromZodError(error, this.providerName, "updateSubscription");
       }
+      if (!data.provider_metadata || Object.keys(data.provider_metadata).length === 0) {
+        throw new ValidationError(
+          "Polar requires specific update type via provider_metadata. Use one of: { productId: string } | { discountId: string } | { trialEnd: Date }",
+          { provider: this.providerName, method: "updateSubscription" }
+        );
+      }
       const response = await this.polar.subscriptions.update({
         id,
-        subscriptionUpdate: { ...data.metadata ?? {} }
+        subscriptionUpdate: data.provider_metadata
       });
       return paykitSubscription$InboundSchema(response);
     };
@@ -4382,10 +4399,11 @@ var PolarProvider = class extends AbstractPayKitProvider {
       const checkoutResponse = await this.polar.checkouts.update({
         id,
         checkoutUpdate: {
-          ...rest,
+          ...provider_metadata,
           ...rest.metadata && { metadata: paymentMetadata },
           ...rest.item_id && { products: [rest.item_id] },
-          ...provider_metadata
+          ...rest.amount && { amount: rest.amount },
+          ...rest.currency && { currency: rest.currency }
         }
       });
       return paykitPayment$InboundSchema(checkoutResponse);
@@ -4446,71 +4464,67 @@ var PolarProvider = class extends AbstractPayKitProvider {
          */
         "order.paid": (data2) => {
           const { status, metadata } = data2;
-          if (status == "paid") {
-            const invoice = paykitInvoice$InboundSchema({
-              ...data2,
-              billingMode: billingModeSchema.parse("one_time"),
-              metadata: { ...metadata ?? {} }
-            });
-            const payment = {
-              id: data2.id,
-              amount: data2.totalAmount,
-              currency: data2.currency,
-              customer: data2.customerId ? data2.customerId : { email: data2.customer.email ?? "" },
-              status: data2.status === "paid" ? "succeeded" : "pending",
-              metadata: stringifyMetadataValues(metadata ?? {}),
-              item_id: data2.product.id
-            };
-            return [
-              paykitEvent$InboundSchema({
-                type: "payment.updated",
-                created: parseInt(webhookTimestamp),
-                id: webhookId,
-                data: payment
-              }),
-              paykitEvent$InboundSchema({
-                type: "invoice.generated",
-                created: parseInt(webhookTimestamp),
-                id: webhookId,
-                data: invoice
-              })
-            ];
+          if (status !== "paid") {
+            return null;
           }
-          return null;
+          const isSubscription = ["subscription_create", "subscription_cycle"].includes(
+            data2.billingReason
+          );
+          const invoice = paykitInvoice$InboundSchema({
+            ...data2,
+            billingMode: billingModeSchema.parse(isSubscription ? "recurring" : "one_time"),
+            metadata: { ...metadata ?? {} }
+          });
+          const payment = {
+            id: data2.id,
+            amount: data2.totalAmount,
+            currency: data2.currency,
+            customer: data2.customerId ? data2.customerId : { email: data2.customer.email ?? "" },
+            status: data2.status === "paid" ? "succeeded" : "pending",
+            metadata: stringifyMetadataValues(metadata ?? {}),
+            item_id: data2.product.id,
+            requires_action: false,
+            payment_url: null
+          };
+          return [
+            paykitEvent$InboundSchema({
+              type: "payment.updated",
+              created: parseInt(webhookTimestamp),
+              id: webhookId,
+              data: payment
+            }),
+            paykitEvent$InboundSchema({
+              type: "invoice.generated",
+              created: parseInt(webhookTimestamp),
+              id: webhookId,
+              data: invoice
+            })
+          ];
         },
         "order.created": (data2) => {
           const { billingReason, metadata, status } = data2;
-          if (["subscription_create", "subscription_cycle"].includes(billingReason) && status == "paid") {
-            const invoice = paykitInvoice$InboundSchema({
-              ...data2,
-              billingMode: billingModeSchema.parse("recurring"),
-              metadata: { ...metadata ?? {} }
-            });
-            const payment = {
-              id: data2.id,
-              amount: data2.totalAmount,
-              currency: data2.currency,
-              customer: data2.customerId ? data2.customerId : { email: data2.customer.email ?? "" },
-              status: data2.status === "paid" ? "succeeded" : "pending",
-              metadata: stringifyMetadataValues(metadata ?? {}),
-              item_id: data2.product.id
-            };
-            return [
-              paykitEvent$InboundSchema({
-                type: "payment.created",
-                created: parseInt(webhookTimestamp),
-                id: webhookId,
-                data: payment
-              }),
-              paykitEvent$InboundSchema({
-                type: "invoice.generated",
-                created: parseInt(webhookTimestamp),
-                id: webhookId,
-                data: invoice
-              })
-            ];
+          if (status !== "paid") {
+            return null;
           }
-          return null;
+          const payment = {
+            id: data2.id,
+            amount: data2.totalAmount,
+            currency: data2.currency,
+            customer: data2.customerId ? data2.customerId : { email: data2.customer.email ?? "" },
+            status: data2.status === "paid" ? "succeeded" : "pending",
+            metadata: stringifyMetadataValues(metadata ?? {}),
+            item_id: data2.product.id,
+            requires_action: data2.status === "paid" ? false : true,
+            payment_url: null
+          };
+          return [
+            paykitEvent$InboundSchema({
+              type: "payment.created",
+              created: parseInt(webhookTimestamp),
+              id: webhookId,
+              data: payment
+            })
+          ];
         },
         /**
          * Customer
@@ -4600,8 +4614,12 @@ var PolarProvider = class extends AbstractPayKitProvider {
       if (!handler)
         throw new Error(`Unhandled event type: ${type} for provider: ${this.providerName}`);
       const results = handler(data);
-      if (!results)
-        throw new Error(`Unhandled event type: ${type} for provider: ${this.providerName}`);
+      if (!results) {
+        console.log(
+          `Skipping event ${type} for provider: ${this.providerName} as no action needed`
+        );
+        return [];
+      }
       return results;
     };
     const { accessToken, isSandbox, debug = true, ...rest } = config;

package/dist/polar-provider.js

@@ -4057,7 +4057,7 @@ var paykitCheckout$InboundSchema = (checkout) => {
     customer: checkout.customerId ? checkout.customerId : { email: checkout.customerEmail ?? "" },
     session_type: checkout.subscriptionId ? "recurring" : "one_time",
     products: checkout.products.map((product) => ({ id: product.id, quantity: 1 })),
-    metadata: checkout.metadata ?? null,
+    metadata: core.omitInternalMetadata(checkout.metadata) ?? null,
     currency: checkout.currency,
     amount: checkout.amount
   };
@@ -4110,7 +4110,10 @@ var paykitInvoice$InboundSchema = (invoice) => {
     status,
     subscription_id: invoice.subscription?.id ?? null,
     paid_at: new Date(invoice.createdAt).toISOString(),
-    line_items: []
+    line_items: invoice.items.map(({ productPriceId }) => ({
+      id: productPriceId ?? "",
+      quantity: invoice.items.length
+    }))
   };
 };
 var paykitPayment$InboundSchema = (checkout) => {
@@ -4127,8 +4130,10 @@ var paykitPayment$InboundSchema = (checkout) => {
     currency: checkout.currency,
     customer: checkout.customerId ? checkout.customerId : { email: checkout.customerEmail ?? "" },
     status: statusMap[checkout.status],
-    metadata: checkout.metadata ?? {},
-    item_id: checkout.products.length > 0 ? checkout.products[0].id : null
+    metadata: core.omitInternalMetadata(checkout.metadata) ?? {},
+    item_id: checkout.products.length > 0 ? checkout.products[0].id : null,
+    requires_action: checkout.status === "open" ? true : false,
+    payment_url: checkout.status === "open" ? checkout.url : null
   };
 };
 var mapRefundReason = (debug, reason) => {
@@ -4186,10 +4191,16 @@ var PolarProvider = class extends core.AbstractPayKitProvider {
       const { metadata, item_id, provider_metadata } = data;
       const checkoutMetadata = core.stringifyMetadataValues(metadata ?? {});
       const checkoutCreateOptions = {
+        ...provider_metadata,
         metadata: checkoutMetadata,
         products: [item_id],
-        ...provider_metadata
+        successUrl: data.success_url
       };
+      if (typeof data.customer === "object" && "email" in data.customer) {
+        checkoutCreateOptions.customerEmail = data.customer.email;
+      } else if (typeof data.customer === "string") {
+        checkoutCreateOptions.customerId = data.customer;
+      }
       if (data.billing) {
         checkoutCreateOptions.customerBillingAddress = {
           line1: data.billing.address.line1,
@@ -4324,9 +4335,15 @@ var PolarProvider = class extends core.AbstractPayKitProvider {
       if (error) {
         throw core.ValidationError.fromZodError(error, this.providerName, "updateSubscription");
       }
+      if (!data.provider_metadata || Object.keys(data.provider_metadata).length === 0) {
+        throw new core.ValidationError(
+          "Polar requires specific update type via provider_metadata. Use one of: { productId: string } | { discountId: string } | { trialEnd: Date }",
+          { provider: this.providerName, method: "updateSubscription" }
+        );
+      }
       const response = await this.polar.subscriptions.update({
         id,
-        subscriptionUpdate: { ...data.metadata ?? {} }
+        subscriptionUpdate: data.provider_metadata
       });
       return paykitSubscription$InboundSchema(response);
     };
@@ -4384,10 +4401,11 @@ var PolarProvider = class extends core.AbstractPayKitProvider {
       const checkoutResponse = await this.polar.checkouts.update({
         id,
         checkoutUpdate: {
-          ...rest,
+          ...provider_metadata,
           ...rest.metadata && { metadata: paymentMetadata },
           ...rest.item_id && { products: [rest.item_id] },
-          ...provider_metadata
+          ...rest.amount && { amount: rest.amount },
+          ...rest.currency && { currency: rest.currency }
         }
       });
       return paykitPayment$InboundSchema(checkoutResponse);
@@ -4448,71 +4466,67 @@ var PolarProvider = class extends core.AbstractPayKitProvider {
          */
         "order.paid": (data2) => {
           const { status, metadata } = data2;
-          if (status == "paid") {
-            const invoice = paykitInvoice$InboundSchema({
-              ...data2,
-              billingMode: core.billingModeSchema.parse("one_time"),
-              metadata: { ...metadata ?? {} }
-            });
-            const payment = {
-              id: data2.id,
-              amount: data2.totalAmount,
-              currency: data2.currency,
-              customer: data2.customerId ? data2.customerId : { email: data2.customer.email ?? "" },
-              status: data2.status === "paid" ? "succeeded" : "pending",
-              metadata: core.stringifyMetadataValues(metadata ?? {}),
-              item_id: data2.product.id
-            };
-            return [
-              core.paykitEvent$InboundSchema({
-                type: "payment.updated",
-                created: parseInt(webhookTimestamp),
-                id: webhookId,
-                data: payment
-              }),
-              core.paykitEvent$InboundSchema({
-                type: "invoice.generated",
-                created: parseInt(webhookTimestamp),
-                id: webhookId,
-                data: invoice
-              })
-            ];
+          if (status !== "paid") {
+            return null;
           }
-          return null;
+          const isSubscription = ["subscription_create", "subscription_cycle"].includes(
+            data2.billingReason
+          );
+          const invoice = paykitInvoice$InboundSchema({
+            ...data2,
+            billingMode: core.billingModeSchema.parse(isSubscription ? "recurring" : "one_time"),
+            metadata: { ...metadata ?? {} }
+          });
+          const payment = {
+            id: data2.id,
+            amount: data2.totalAmount,
+            currency: data2.currency,
+            customer: data2.customerId ? data2.customerId : { email: data2.customer.email ?? "" },
+            status: data2.status === "paid" ? "succeeded" : "pending",
+            metadata: core.stringifyMetadataValues(metadata ?? {}),
+            item_id: data2.product.id,
+            requires_action: false,
+            payment_url: null
+          };
+          return [
+            core.paykitEvent$InboundSchema({
+              type: "payment.updated",
+              created: parseInt(webhookTimestamp),
+              id: webhookId,
+              data: payment
+            }),
+            core.paykitEvent$InboundSchema({
+              type: "invoice.generated",
+              created: parseInt(webhookTimestamp),
+              id: webhookId,
+              data: invoice
+            })
+          ];
         },
         "order.created": (data2) => {
           const { billingReason, metadata, status } = data2;
-          if (["subscription_create", "subscription_cycle"].includes(billingReason) && status == "paid") {
-            const invoice = paykitInvoice$InboundSchema({
-              ...data2,
-              billingMode: core.billingModeSchema.parse("recurring"),
-              metadata: { ...metadata ?? {} }
-            });
-            const payment = {
-              id: data2.id,
-              amount: data2.totalAmount,
-              currency: data2.currency,
-              customer: data2.customerId ? data2.customerId : { email: data2.customer.email ?? "" },
-              status: data2.status === "paid" ? "succeeded" : "pending",
-              metadata: core.stringifyMetadataValues(metadata ?? {}),
-              item_id: data2.product.id
-            };
-            return [
-              core.paykitEvent$InboundSchema({
-                type: "payment.created",
-                created: parseInt(webhookTimestamp),
-                id: webhookId,
-                data: payment
-              }),
-              core.paykitEvent$InboundSchema({
-                type: "invoice.generated",
-                created: parseInt(webhookTimestamp),
-                id: webhookId,
-                data: invoice
-              })
-            ];
+          if (status !== "paid") {
+            return null;
           }
-          return null;
+          const payment = {
+            id: data2.id,
+            amount: data2.totalAmount,
+            currency: data2.currency,
+            customer: data2.customerId ? data2.customerId : { email: data2.customer.email ?? "" },
+            status: data2.status === "paid" ? "succeeded" : "pending",
+            metadata: core.stringifyMetadataValues(metadata ?? {}),
+            item_id: data2.product.id,
+            requires_action: data2.status === "paid" ? false : true,
+            payment_url: null
+          };
+          return [
+            core.paykitEvent$InboundSchema({
+              type: "payment.created",
+              created: parseInt(webhookTimestamp),
+              id: webhookId,
+              data: payment
+            })
+          ];
         },
         /**
          * Customer
@@ -4602,8 +4616,12 @@ var PolarProvider = class extends core.AbstractPayKitProvider {
       if (!handler)
         throw new Error(`Unhandled event type: ${type} for provider: ${this.providerName}`);
       const results = handler(data);
-      if (!results)
-        throw new Error(`Unhandled event type: ${type} for provider: ${this.providerName}`);
+      if (!results) {
+        console.log(
+          `Skipping event ${type} for provider: ${this.providerName} as no action needed`
+        );
+        return [];
+      }
       return results;
     };
     const { accessToken, isSandbox, debug = true, ...rest } = config;

package/dist/polar-provider.mjs

@@ -4055,7 +4055,7 @@ var paykitCheckout$InboundSchema = (checkout) => {
     customer: checkout.customerId ? checkout.customerId : { email: checkout.customerEmail ?? "" },
     session_type: checkout.subscriptionId ? "recurring" : "one_time",
     products: checkout.products.map((product) => ({ id: product.id, quantity: 1 })),
-    metadata: checkout.metadata ?? null,
+    metadata: omitInternalMetadata(checkout.metadata) ?? null,
     currency: checkout.currency,
     amount: checkout.amount
   };
@@ -4108,7 +4108,10 @@ var paykitInvoice$InboundSchema = (invoice) => {
     status,
     subscription_id: invoice.subscription?.id ?? null,
     paid_at: new Date(invoice.createdAt).toISOString(),
-    line_items: []
+    line_items: invoice.items.map(({ productPriceId }) => ({
+      id: productPriceId ?? "",
+      quantity: invoice.items.length
+    }))
   };
 };
 var paykitPayment$InboundSchema = (checkout) => {
@@ -4125,8 +4128,10 @@ var paykitPayment$InboundSchema = (checkout) => {
     currency: checkout.currency,
     customer: checkout.customerId ? checkout.customerId : { email: checkout.customerEmail ?? "" },
     status: statusMap[checkout.status],
-    metadata: checkout.metadata ?? {},
-    item_id: checkout.products.length > 0 ? checkout.products[0].id : null
+    metadata: omitInternalMetadata(checkout.metadata) ?? {},
+    item_id: checkout.products.length > 0 ? checkout.products[0].id : null,
+    requires_action: checkout.status === "open" ? true : false,
+    payment_url: checkout.status === "open" ? checkout.url : null
   };
 };
 var mapRefundReason = (debug, reason) => {
@@ -4184,10 +4189,16 @@ var PolarProvider = class extends AbstractPayKitProvider {
       const { metadata, item_id, provider_metadata } = data;
       const checkoutMetadata = stringifyMetadataValues(metadata ?? {});
       const checkoutCreateOptions = {
+        ...provider_metadata,
         metadata: checkoutMetadata,
         products: [item_id],
-        ...provider_metadata
+        successUrl: data.success_url
       };
+      if (typeof data.customer === "object" && "email" in data.customer) {
+        checkoutCreateOptions.customerEmail = data.customer.email;
+      } else if (typeof data.customer === "string") {
+        checkoutCreateOptions.customerId = data.customer;
+      }
       if (data.billing) {
         checkoutCreateOptions.customerBillingAddress = {
           line1: data.billing.address.line1,
@@ -4322,9 +4333,15 @@ var PolarProvider = class extends AbstractPayKitProvider {
       if (error) {
         throw ValidationError.fromZodError(error, this.providerName, "updateSubscription");
       }
+      if (!data.provider_metadata || Object.keys(data.provider_metadata).length === 0) {
+        throw new ValidationError(
+          "Polar requires specific update type via provider_metadata. Use one of: { productId: string } | { discountId: string } | { trialEnd: Date }",
+          { provider: this.providerName, method: "updateSubscription" }
+        );
+      }
       const response = await this.polar.subscriptions.update({
         id,
-        subscriptionUpdate: { ...data.metadata ?? {} }
+        subscriptionUpdate: data.provider_metadata
       });
       return paykitSubscription$InboundSchema(response);
     };
@@ -4382,10 +4399,11 @@ var PolarProvider = class extends AbstractPayKitProvider {
       const checkoutResponse = await this.polar.checkouts.update({
         id,
         checkoutUpdate: {
-          ...rest,
+          ...provider_metadata,
           ...rest.metadata && { metadata: paymentMetadata },
           ...rest.item_id && { products: [rest.item_id] },
-          ...provider_metadata
+          ...rest.amount && { amount: rest.amount },
+          ...rest.currency && { currency: rest.currency }
         }
       });
       return paykitPayment$InboundSchema(checkoutResponse);
@@ -4446,71 +4464,67 @@ var PolarProvider = class extends AbstractPayKitProvider {
          */
         "order.paid": (data2) => {
           const { status, metadata } = data2;
-          if (status == "paid") {
-            const invoice = paykitInvoice$InboundSchema({
-              ...data2,
-              billingMode: billingModeSchema.parse("one_time"),
-              metadata: { ...metadata ?? {} }
-            });
-            const payment = {
-              id: data2.id,
-              amount: data2.totalAmount,
-              currency: data2.currency,
-              customer: data2.customerId ? data2.customerId : { email: data2.customer.email ?? "" },
-              status: data2.status === "paid" ? "succeeded" : "pending",
-              metadata: stringifyMetadataValues(metadata ?? {}),
-              item_id: data2.product.id
-            };
-            return [
-              paykitEvent$InboundSchema({
-                type: "payment.updated",
-                created: parseInt(webhookTimestamp),
-                id: webhookId,
-                data: payment
-              }),
-              paykitEvent$InboundSchema({
-                type: "invoice.generated",
-                created: parseInt(webhookTimestamp),
-                id: webhookId,
-                data: invoice
-              })
-            ];
+          if (status !== "paid") {
+            return null;
           }
-          return null;
+          const isSubscription = ["subscription_create", "subscription_cycle"].includes(
+            data2.billingReason
+          );
+          const invoice = paykitInvoice$InboundSchema({
+            ...data2,
+            billingMode: billingModeSchema.parse(isSubscription ? "recurring" : "one_time"),
+            metadata: { ...metadata ?? {} }
+          });
+          const payment = {
+            id: data2.id,
+            amount: data2.totalAmount,
+            currency: data2.currency,
+            customer: data2.customerId ? data2.customerId : { email: data2.customer.email ?? "" },
+            status: data2.status === "paid" ? "succeeded" : "pending",
+            metadata: stringifyMetadataValues(metadata ?? {}),
+            item_id: data2.product.id,
+            requires_action: false,
+            payment_url: null
+          };
+          return [
+            paykitEvent$InboundSchema({
+              type: "payment.updated",
+              created: parseInt(webhookTimestamp),
+              id: webhookId,
+              data: payment
+            }),
+            paykitEvent$InboundSchema({
+              type: "invoice.generated",
+              created: parseInt(webhookTimestamp),
+              id: webhookId,
+              data: invoice
+            })
+          ];
         },
         "order.created": (data2) => {
           const { billingReason, metadata, status } = data2;
-          if (["subscription_create", "subscription_cycle"].includes(billingReason) && status == "paid") {
-            const invoice = paykitInvoice$InboundSchema({
-              ...data2,
-              billingMode: billingModeSchema.parse("recurring"),
-              metadata: { ...metadata ?? {} }
-            });
-            const payment = {
-              id: data2.id,
-              amount: data2.totalAmount,
-              currency: data2.currency,
-              customer: data2.customerId ? data2.customerId : { email: data2.customer.email ?? "" },
-              status: data2.status === "paid" ? "succeeded" : "pending",
-              metadata: stringifyMetadataValues(metadata ?? {}),
-              item_id: data2.product.id
-            };
-            return [
-              paykitEvent$InboundSchema({
-                type: "payment.created",
-                created: parseInt(webhookTimestamp),
-                id: webhookId,
-                data: payment
-              }),
-              paykitEvent$InboundSchema({
-                type: "invoice.generated",
-                created: parseInt(webhookTimestamp),
-                id: webhookId,
-                data: invoice
-              })
-            ];
+          if (status !== "paid") {
+            return null;
           }
-          return null;
+          const payment = {
+            id: data2.id,
+            amount: data2.totalAmount,
+            currency: data2.currency,
+            customer: data2.customerId ? data2.customerId : { email: data2.customer.email ?? "" },
+            status: data2.status === "paid" ? "succeeded" : "pending",
+            metadata: stringifyMetadataValues(metadata ?? {}),
+            item_id: data2.product.id,
+            requires_action: data2.status === "paid" ? false : true,
+            payment_url: null
+          };
+          return [
+            paykitEvent$InboundSchema({
+              type: "payment.created",
+              created: parseInt(webhookTimestamp),
+              id: webhookId,
+              data: payment
+            })
+          ];
         },
         /**
          * Customer
@@ -4600,8 +4614,12 @@ var PolarProvider = class extends AbstractPayKitProvider {
       if (!handler)
         throw new Error(`Unhandled event type: ${type} for provider: ${this.providerName}`);
       const results = handler(data);
-      if (!results)
-        throw new Error(`Unhandled event type: ${type} for provider: ${this.providerName}`);
+      if (!results) {
+        console.log(
+          `Skipping event ${type} for provider: ${this.providerName} as no action needed`
+        );
+        return [];
+      }
       return results;
     };
     const { accessToken, isSandbox, debug = true, ...rest } = config;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@paykit-sdk/polar",
-  "version": "1.1.96",
+  "version": "1.1.98",
   "description": "Polar provider for PayKit",
   "main": "dist/index.js",
   "module": "dist/index.esm.js",
@@ -17,16 +17,16 @@
   "author": "Emmanuel Odii",
   "license": "ISC",
   "dependencies": {
-    "@polar-sh/sdk": "^0.33.0"
+    "@polar-sh/sdk": "0.37.0"
   },
   "peerDependencies": {
-    "@paykit-sdk/core": ">=1.1.96"
+    "@paykit-sdk/core": ">=1.1.98"
   },
   "devDependencies": {
     "tsup": "^8.0.0",
     "typescript": "^5.0.0",
     "zod": "^3.24.2",
-    "@paykit-sdk/core": "1.1.96"
+    "@paykit-sdk/core": "1.1.98"
   },
   "publishConfig": {
     "access": "public"