@paykit-sdk/polar 1.1.0 → 1.1.1

package/README.md

@@ -0,0 +1,81 @@
+# @paykit-sdk/polar
+
+Polar provider for PayKit
+
+## Quick Start
+
+```typescript
+import { PayKit } from '@paykit-sdk/core';
+import { polar, createPolar } from '@paykit-sdk/polar';
+
+// Method 1: Using environment variables
+const provider = polar(); // Uses POLAR_ACCESS_TOKEN from env
+
+// Method 2: Direct configuration
+const provider = createPolar({
+  accessToken: process.env.POLAR_ACCESS_TOKEN,
+  server: 'sandbox', // or 'production'
+  debug: true,
+});
+
+const paykit = new PayKit(provider);
+
+// Create checkout
+const checkout = await paykit.checkouts.create({
+  item_id: 'product-id',
+  metadata: { plan: 'pro' },
+  provider_metadata: {
+    successUrl: 'https://your-app.com/success',
+  },
+});
+
+// Handle webhooks
+paykit.webhooks
+  .setup({ webhookSecret: process.env.POLAR_WEBHOOK_SECRET })
+  .on('$checkoutCreated', async event => {
+    console.log('Checkout created:', event.data);
+  })
+  .on('$paymentReceived', async event => {
+    console.log('Payment received:', event.data);
+  });
+```
+
+## Subscription Updates
+
+Polar requires specific update types:
+
+```typescript
+// Change product
+await paykit.subscriptions.update('sub_123', {
+  metadata: { productId: 'new-product-id' },
+});
+
+// Cancel at period end
+await paykit.subscriptions.update('sub_123', {
+  metadata: { cancelAtPeriodEnd: 'true' },
+});
+
+// Cancel with reason
+await paykit.subscriptions.update('sub_123', {
+  metadata: {
+    cancelAtPeriodEnd: 'true',
+    customerCancellationReason: 'too_expensive',
+  },
+});
+```
+
+## Environment Variables
+
+```bash
+POLAR_ACCESS_TOKEN=polar_oat_...
+POLAR_WEBHOOK_SECRET=your-webhook-secret
+```
+
+## Support
+
+- [Polar Documentation](https://docs.polar.sh/)
+- [PayKit Issues](https://github.com/devodii/paykit/issues)
+
+## License
+
+ISC

package/dist/index.d.mts

@@ -23,7 +23,7 @@ declare class PolarProvider implements PayKitProvider {
     /**
      * Subscription management
      */
-    cancelSubscription: (id: string) => Promise<Subscription>;
+    cancelSubscription: (id: string) => Promise<null>;
     retrieveSubscription: (id: string) => Promise<Subscription>;
     updateSubscription: (id: string, params: UpdateSubscriptionParams) => Promise<Subscription>;
     /**

package/dist/index.d.ts

@@ -23,7 +23,7 @@ declare class PolarProvider implements PayKitProvider {
     /**
      * Subscription management
      */
-    cancelSubscription: (id: string) => Promise<Subscription>;
+    cancelSubscription: (id: string) => Promise<null>;
     retrieveSubscription: (id: string) => Promise<Subscription>;
     updateSubscription: (id: string, params: UpdateSubscriptionParams) => Promise<Subscription>;
     /**

package/dist/index.js

@@ -68,11 +68,7 @@ var PolarProvider = class {
      */
     this.createCheckout = async (params) => {
       const { metadata, item_id, provider_metadata } = params;
-      const response = await this.polar.checkouts.create({
-        metadata,
-        products: [item_id],
-        ...provider_metadata
-      });
+      const response = await this.polar.checkouts.create({ metadata, products: [item_id], ...provider_metadata });
       return toPaykitCheckout(response);
     };
     this.retrieveCheckout = async (id) => {
@@ -89,7 +85,10 @@ var PolarProvider = class {
     };
     this.updateCustomer = async (id, params) => {
       const { email, name, metadata } = params;
-      const response = await this.polar.customers.update({ id, customerUpdate: { email, name, ...metadata && { metadata } } });
+      const response = await this.polar.customers.update({
+        id,
+        customerUpdate: { ...email && { email }, ...name && { name }, ...metadata && { metadata } }
+      });
       return toPaykitCustomer(response);
     };
     this.retrieveCustomer = async (id) => {
@@ -100,16 +99,16 @@ var PolarProvider = class {
      * Subscription management
      */
     this.cancelSubscription = async (id) => {
-      const response = await this.polar.subscriptions.revoke({ id });
-      return toPaykitSubscription(response);
+      await this.polar.subscriptions.revoke({ id });
+      return null;
     };
     this.retrieveSubscription = async (id) => {
       const response = await this.polar.subscriptions.get({ id });
       return toPaykitSubscription(response);
     };
     this.updateSubscription = async (id, params) => {
-      const subscription = await this.retrieveSubscription(id);
-      return subscription;
+      const response = await this.polar.subscriptions.update({ id, subscriptionUpdate: { ...params.metadata } });
+      return toPaykitSubscription(response);
     };
     /**
      * Webhook management
@@ -123,6 +122,7 @@ var PolarProvider = class {
         },
         {}
       );
+      console.log({ headers, webhookHeaders, webhookSecret, body });
       const webhookEvent = (0, import_webhooks.validateEvent)(body, webhookHeaders, webhookSecret);
       const id = webhookHeaders["webhook-id"];
       const timestamp = webhookHeaders["webhook-timestamp"];
@@ -134,7 +134,7 @@ var PolarProvider = class {
         return (0, import_core2.toPaykitEvent)({ type: "$subscriptionCreated", created: parseInt(timestamp), id, data: subscription });
       } else if (webhookEvent.type === "subscription.revoked") {
         const subscription = await this.retrieveSubscription(webhookEvent.data.id);
-        return (0, import_core2.toPaykitEvent)({ type: "$subscriptionCanceled", created: parseInt(timestamp), id, data: subscription });
+        return (0, import_core2.toPaykitEvent)({ type: "$subscriptionCancelled", created: parseInt(timestamp), id, data: subscription });
       } else if (webhookEvent.type === "customer.created") {
         const customer = await this.retrieveCustomer(webhookEvent.data.id);
         return (0, import_core2.toPaykitEvent)({ type: "$customerCreated", created: parseInt(timestamp), id, data: customer });
@@ -150,7 +150,7 @@ var PolarProvider = class {
         const checkout = await this.retrieveCheckout(webhookEvent.data.id);
         return (0, import_core2.toPaykitEvent)({ type: "$paymentReceived", created: parseInt(timestamp), id, data: checkout });
       }
-      throw new Error(`Unknown event type: ${webhookEvent.type}`);
+      throw new Error(`Unhandled event type: ${webhookEvent.type}`);
     };
     const { accessToken, server, ...rest } = config;
     this.polar = new import_sdk.Polar({ accessToken, serverURL: server === "sandbox" ? this.sandboxURL : this.productionURL, ...rest });

package/dist/index.mjs

@@ -46,11 +46,7 @@ var PolarProvider = class {
      */
     this.createCheckout = async (params) => {
       const { metadata, item_id, provider_metadata } = params;
-      const response = await this.polar.checkouts.create({
-        metadata,
-        products: [item_id],
-        ...provider_metadata
-      });
+      const response = await this.polar.checkouts.create({ metadata, products: [item_id], ...provider_metadata });
       return toPaykitCheckout(response);
     };
     this.retrieveCheckout = async (id) => {
@@ -67,7 +63,10 @@ var PolarProvider = class {
     };
     this.updateCustomer = async (id, params) => {
       const { email, name, metadata } = params;
-      const response = await this.polar.customers.update({ id, customerUpdate: { email, name, ...metadata && { metadata } } });
+      const response = await this.polar.customers.update({
+        id,
+        customerUpdate: { ...email && { email }, ...name && { name }, ...metadata && { metadata } }
+      });
       return toPaykitCustomer(response);
     };
     this.retrieveCustomer = async (id) => {
@@ -78,16 +77,16 @@ var PolarProvider = class {
      * Subscription management
      */
     this.cancelSubscription = async (id) => {
-      const response = await this.polar.subscriptions.revoke({ id });
-      return toPaykitSubscription(response);
+      await this.polar.subscriptions.revoke({ id });
+      return null;
     };
     this.retrieveSubscription = async (id) => {
       const response = await this.polar.subscriptions.get({ id });
       return toPaykitSubscription(response);
     };
     this.updateSubscription = async (id, params) => {
-      const subscription = await this.retrieveSubscription(id);
-      return subscription;
+      const response = await this.polar.subscriptions.update({ id, subscriptionUpdate: { ...params.metadata } });
+      return toPaykitSubscription(response);
     };
     /**
      * Webhook management
@@ -101,6 +100,7 @@ var PolarProvider = class {
         },
         {}
       );
+      console.log({ headers, webhookHeaders, webhookSecret, body });
       const webhookEvent = validateEvent(body, webhookHeaders, webhookSecret);
       const id = webhookHeaders["webhook-id"];
       const timestamp = webhookHeaders["webhook-timestamp"];
@@ -112,7 +112,7 @@ var PolarProvider = class {
         return toPaykitEvent({ type: "$subscriptionCreated", created: parseInt(timestamp), id, data: subscription });
       } else if (webhookEvent.type === "subscription.revoked") {
         const subscription = await this.retrieveSubscription(webhookEvent.data.id);
-        return toPaykitEvent({ type: "$subscriptionCanceled", created: parseInt(timestamp), id, data: subscription });
+        return toPaykitEvent({ type: "$subscriptionCancelled", created: parseInt(timestamp), id, data: subscription });
       } else if (webhookEvent.type === "customer.created") {
         const customer = await this.retrieveCustomer(webhookEvent.data.id);
         return toPaykitEvent({ type: "$customerCreated", created: parseInt(timestamp), id, data: customer });
@@ -128,7 +128,7 @@ var PolarProvider = class {
         const checkout = await this.retrieveCheckout(webhookEvent.data.id);
         return toPaykitEvent({ type: "$paymentReceived", created: parseInt(timestamp), id, data: checkout });
       }
-      throw new Error(`Unknown event type: ${webhookEvent.type}`);
+      throw new Error(`Unhandled event type: ${webhookEvent.type}`);
     };
     const { accessToken, server, ...rest } = config;
     this.polar = new Polar({ accessToken, serverURL: server === "sandbox" ? this.sandboxURL : this.productionURL, ...rest });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@paykit-sdk/polar",
-  "version": "1.1.0",
+  "version": "1.1.1",
   "description": "Polar provider for PayKit",
   "main": "dist/index.js",
   "module": "dist/index.esm.js",
@@ -8,6 +8,10 @@
   "files": [
     "dist"
   ],
+  "scripts": {
+    "build": "tsup src/index.ts --format cjs,esm --dts",
+    "prepublishOnly": "rm -rf dist && npm run build"
+  },
   "keywords": [
     "polar",
     "paykit",
@@ -23,9 +27,9 @@
     "@paykit-sdk/core": "^1.1.0"
   },
   "devDependencies": {
+    "@paykit-sdk/core": "workspace:*",
     "tsup": "^8.0.0",
-    "typescript": "^5.0.0",
-    "@paykit-sdk/core": "1.1.0"
+    "typescript": "^5.0.0"
   },
   "publishConfig": {
     "access": "public"
@@ -36,8 +40,5 @@
   },
   "bugs": {
     "url": "https://github.com/devodii/paykit/issues"
-  },
-  "scripts": {
-    "build": "tsup src/index.ts --format cjs,esm --dts"
   }
-}
+}