@paykit-sdk/stripe 1.1.0 → 1.1.1

package/README.md

@@ -0,0 +1,71 @@
+# @paykit-sdk/stripe
+
+Stripe provider for PayKit
+
+## Quick Start
+
+```typescript
+import { PayKit } from '@paykit-sdk/core';
+import { stripe, createStripe } from '@paykit-sdk/stripe';
+
+// Method 1: Using environment variables
+const provider = stripe(); // Ensure STRIPE_API_KEY environment variable is set
+
+// Method 2: Direct configuration
+const provider = createStripe({
+  apiKey: process.env.STRIPE_API_KEY,
+  apiVersion: '2024-12-18.acacia',
+});
+
+const paykit = new PayKit(provider);
+
+// Create checkout
+const checkout = await paykit.checkouts.create({
+  customer_id: 'cus_123',
+  item_id: 'price_123',
+  session_type: 'one_time',
+  metadata: { plan: 'pro' },
+  provider_metadata: {
+    ui_mode: 'hosted',
+    success_url: 'https://your-app.com/success',
+  },
+});
+
+// Handle webhooks
+paykit.webhooks
+  .setup({ webhookSecret: process.env.STRIPE_WEBHOOK_SECRET })
+  .on('$checkoutCreated', async event => {
+    console.log('Checkout created:', event.data);
+  })
+  .on('$invoicePaid', async event => {
+    console.log('Payment received:', event.data);
+  });
+```
+
+## Subscription Management
+
+```typescript
+// Update subscription
+await paykit.subscriptions.update('sub_123', {
+  metadata: { plan: 'enterprise' },
+});
+
+// Cancel subscription
+await paykit.subscriptions.cancel('sub_123');
+```
+
+## Environment Variables
+
+```bash
+STRIPE_SECRET_KEY=sk_test_...
+STRIPE_WEBHOOK_SECRET=whsec_...
+```
+
+## Support
+
+- [Stripe Documentation](https://stripe.com/docs)
+- [PayKit Issues](https://github.com/devodii/paykit/issues)
+
+## License
+
+ISC

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { PaykitProviderOptions, PayKitProvider, CreateCheckoutParams, Checkout, CreateCustomerParams, Customer, UpdateCustomerParams, Subscription, UpdateSubscriptionParams, $ExtWebhookHandlerConfig, WebhookEventPayload } from '@paykit-sdk/core';
+import { PaykitProviderOptions, PayKitProvider, CreateCheckoutParams, Checkout, CreateCustomerParams, Customer, UpdateCustomerParams, UpdateSubscriptionParams, Subscription, $ExtWebhookHandlerConfig, WebhookEventPayload } from '@paykit-sdk/core';
 import Stripe from 'stripe';
 
 interface StripeConfig extends PaykitProviderOptions<Stripe.StripeConfig> {
@@ -17,12 +17,12 @@ declare class StripeProvider implements PayKitProvider {
      */
     createCustomer: (params: CreateCustomerParams) => Promise<Customer>;
     updateCustomer: (id: string, params: UpdateCustomerParams) => Promise<Customer>;
-    deleteCustomer: (id: string) => Promise<void>;
+    deleteCustomer: (id: string) => Promise<null>;
     retrieveCustomer: (id: string) => Promise<Customer | null>;
     /**
      * Subscription management
      */
-    cancelSubscription: (id: string) => Promise<Subscription>;
+    cancelSubscription: (id: string) => Promise<null>;
     updateSubscription: (id: string, params: UpdateSubscriptionParams) => Promise<Subscription>;
     retrieveSubscription: (id: string) => Promise<Subscription>;
     /**

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { PaykitProviderOptions, PayKitProvider, CreateCheckoutParams, Checkout, CreateCustomerParams, Customer, UpdateCustomerParams, Subscription, UpdateSubscriptionParams, $ExtWebhookHandlerConfig, WebhookEventPayload } from '@paykit-sdk/core';
+import { PaykitProviderOptions, PayKitProvider, CreateCheckoutParams, Checkout, CreateCustomerParams, Customer, UpdateCustomerParams, UpdateSubscriptionParams, Subscription, $ExtWebhookHandlerConfig, WebhookEventPayload } from '@paykit-sdk/core';
 import Stripe from 'stripe';
 
 interface StripeConfig extends PaykitProviderOptions<Stripe.StripeConfig> {
@@ -17,12 +17,12 @@ declare class StripeProvider implements PayKitProvider {
      */
     createCustomer: (params: CreateCustomerParams) => Promise<Customer>;
     updateCustomer: (id: string, params: UpdateCustomerParams) => Promise<Customer>;
-    deleteCustomer: (id: string) => Promise<void>;
+    deleteCustomer: (id: string) => Promise<null>;
     retrieveCustomer: (id: string) => Promise<Customer | null>;
     /**
      * Subscription management
      */
-    cancelSubscription: (id: string) => Promise<Subscription>;
+    cancelSubscription: (id: string) => Promise<null>;
     updateSubscription: (id: string, params: UpdateSubscriptionParams) => Promise<Subscription>;
     retrieveSubscription: (id: string) => Promise<Subscription>;
     /**

package/dist/index.js

@@ -55,15 +55,37 @@ var toPaykitCheckout = (checkout) => {
   };
 };
 var toPaykitCustomer = (customer) => {
-  return { id: customer.id, email: customer.email ?? void 0, name: customer.name ?? void 0 };
+  return {
+    id: customer.id,
+    email: customer.email ?? void 0,
+    name: customer.name ?? void 0,
+    metadata: (0, import_core.stringifyObjectValues)(customer.metadata ?? {})
+  };
+};
+var toPaykitSubscriptionStatus = (status) => {
+  if (["active", "trialing"].includes(status)) return "active";
+  if (["incomplete_expired", "incomplete", "past_due"].includes(status)) return "past_due";
+  if (["canceled"].includes(status)) return "canceled";
+  if (["expired"].includes(status)) return "expired";
+  throw new Error(`Unknown status: ${status}`);
 };
 var toPaykitSubscription = (subscription) => {
   return {
     id: subscription.id,
-    customer_id: subscription.customer,
-    status: (0, import_core.toPaykitSubscriptionStatus)(subscription.status),
+    customer_id: subscription.customer?.toString(),
+    status: toPaykitSubscriptionStatus(subscription.status),
     current_period_start: new Date(subscription.start_date),
-    current_period_end: new Date(subscription.cancel_at)
+    current_period_end: new Date(subscription.cancel_at),
+    metadata: (0, import_core.stringifyObjectValues)(subscription.metadata ?? {})
+  };
+};
+var toPaykitInvoice = (invoice) => {
+  return {
+    id: invoice.id,
+    amount: invoice.amount_paid,
+    currency: invoice.currency,
+    metadata: (0, import_core.stringifyObjectValues)(invoice.metadata ?? {}),
+    customer_id: invoice.customer?.toString() ?? ""
   };
 };
 
@@ -101,6 +123,7 @@ var StripeProvider = class {
     };
     this.deleteCustomer = async (id) => {
       await this.stripe.customers.del(id);
+      return null;
     };
     this.retrieveCustomer = async (id) => {
       const customer = await this.stripe.customers.retrieve(id);
@@ -111,8 +134,8 @@ var StripeProvider = class {
      * Subscription management
      */
     this.cancelSubscription = async (id) => {
-      const subscription = await this.stripe.subscriptions.cancel(id);
-      return toPaykitSubscription(subscription);
+      await this.stripe.subscriptions.cancel(id);
+      return null;
     };
     this.updateSubscription = async (id, params) => {
       const subscription = await this.stripe.subscriptions.update(id, { metadata: params.metadata });
@@ -131,43 +154,66 @@ var StripeProvider = class {
       const signature = stripeHeaders[0].value;
       const event = this.stripe.webhooks.constructEvent(body, signature, webhookSecret);
       if (event.type === "checkout.session.completed") {
-        const checkout = await this.retrieveCheckout(event.data.object.id);
-        const response = (0, import_core2.toPaykitEvent)({ type: "$checkoutCreated", created: event.created, id: event.id, data: checkout });
-        return response;
+        const data = event.data.object;
+        return (0, import_core2.toPaykitEvent)({
+          type: "$invoicePaid",
+          created: event.created,
+          id: event.id,
+          data: {
+            id: data.id,
+            amount: data.amount_total ?? 0,
+            currency: data.currency ?? "",
+            metadata: (0, import_core2.stringifyObjectValues)(data.metadata ?? {}),
+            customer_id: data.customer?.toString() ?? ""
+          }
+        });
       } else if (event.type === "customer.created") {
-        const customer = await this.createCustomer({ email: event.data.object.email, name: event.data.object.name ?? void 0 });
-        return (0, import_core2.toPaykitEvent)({ type: "$customerCreated", created: event.created, id: event.id, data: customer });
+        const customer = event.data.object;
+        return (0, import_core2.toPaykitEvent)({
+          type: "$customerCreated",
+          created: event.created,
+          id: event.id,
+          data: toPaykitCustomer(customer)
+        });
       } else if (event.type === "customer.updated") {
-        const { email, name } = event.data.object;
-        const customer = await this.updateCustomer(event.data.object.id, { email, name: name ?? void 0 });
-        return (0, import_core2.toPaykitEvent)({ type: "$customerUpdated", created: event.created, id: event.id, data: customer });
+        const customer = event.data.object;
+        return (0, import_core2.toPaykitEvent)({
+          type: "$customerUpdated",
+          created: event.created,
+          id: event.id,
+          data: toPaykitCustomer(customer)
+        });
       } else if (event.type === "customer.deleted") {
-        await this.deleteCustomer(event.data.object.id);
         return (0, import_core2.toPaykitEvent)({ type: "$customerDeleted", created: event.created, id: event.id, data: null });
       } else if (event.type === "customer.subscription.created") {
-        const subscription = await this.retrieveSubscription(event.data.object.id);
-        return (0, import_core2.toPaykitEvent)({ type: "$subscriptionCreated", created: event.created, id: event.id, data: subscription });
+        const subscription = event.data.object;
+        return (0, import_core2.toPaykitEvent)({
+          type: "$subscriptionCreated",
+          created: event.created,
+          id: event.id,
+          data: toPaykitSubscription(subscription)
+        });
       } else if (event.type === "customer.subscription.updated") {
-        const subscription = await this.retrieveSubscription(event.data.object.id);
-        return (0, import_core2.toPaykitEvent)({ type: "$subscriptionUpdated", created: event.created, id: event.id, data: subscription });
+        const subscription = event.data.object;
+        return (0, import_core2.toPaykitEvent)({
+          type: "$subscriptionUpdated",
+          created: event.created,
+          id: event.id,
+          data: toPaykitSubscription(subscription)
+        });
       } else if (event.type === "customer.subscription.deleted") {
-        const subscription = await this.retrieveSubscription(event.data.object.id);
-        return (0, import_core2.toPaykitEvent)({ type: "$subscriptionCanceled", created: event.created, id: event.id, data: subscription });
-      } else if (event.type === "customer.subscription.paused") {
-        const subscription = await this.retrieveSubscription(event.data.object.id);
-        return (0, import_core2.toPaykitEvent)({ type: "$subscriptionUpdated", created: event.created, id: event.id, data: subscription });
-      } else if (event.type == "invoice.payment_succeeded") {
-        const checkoutId = event.data.object.metadata?.checkoutId;
-        if (!checkoutId) throw new Error("Checkout ID not found in invoice metadata");
-        const checkout = await this.retrieveCheckout(checkoutId);
+        const subscription = event.data.object;
         return (0, import_core2.toPaykitEvent)({
-          type: "$paymentReceived",
+          type: "$subscriptionCancelled",
           created: event.created,
           id: event.id,
-          data: { ...checkout, checkoutId }
+          data: toPaykitSubscription(subscription)
         });
+      } else if (event.type == "invoice.paid") {
+        const invoice = event.data.object;
+        return (0, import_core2.toPaykitEvent)({ type: "$invoicePaid", created: event.created, id: event.id, data: toPaykitInvoice(invoice) });
       }
-      throw new Error(`Unknown event type: ${event.type}`);
+      throw new Error(`Unhandled event type: ${event.type}`);
     };
     const { debug, apiKey, ...rest } = config;
     this.stripe = new import_stripe.default(apiKey, rest);
@@ -184,7 +230,7 @@ var stripe = () => {
   if (!apiKey) {
     throw new Error("STRIPE_API_KEY is not set");
   }
-  return createStripe({ apiKey, debug: isDev, apiVersion: "2025-05-28.basil" });
+  return createStripe({ apiKey, debug: isDev, apiVersion: "2025-07-30.basil" });
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/dist/index.mjs

@@ -1,12 +1,13 @@
 // src/stripe-provider.ts
 import {
   toPaykitEvent,
-  headersExtractor
+  headersExtractor,
+  stringifyObjectValues as stringifyObjectValues2
 } from "@paykit-sdk/core";
 import Stripe from "stripe";
 
 // lib/mapper.ts
-import { toPaykitSubscriptionStatus } from "@paykit-sdk/core";
+import { stringifyObjectValues } from "@paykit-sdk/core";
 var toPaykitCheckout = (checkout) => {
   return {
     id: checkout.id,
@@ -21,15 +22,37 @@ var toPaykitCheckout = (checkout) => {
   };
 };
 var toPaykitCustomer = (customer) => {
-  return { id: customer.id, email: customer.email ?? void 0, name: customer.name ?? void 0 };
+  return {
+    id: customer.id,
+    email: customer.email ?? void 0,
+    name: customer.name ?? void 0,
+    metadata: stringifyObjectValues(customer.metadata ?? {})
+  };
+};
+var toPaykitSubscriptionStatus = (status) => {
+  if (["active", "trialing"].includes(status)) return "active";
+  if (["incomplete_expired", "incomplete", "past_due"].includes(status)) return "past_due";
+  if (["canceled"].includes(status)) return "canceled";
+  if (["expired"].includes(status)) return "expired";
+  throw new Error(`Unknown status: ${status}`);
 };
 var toPaykitSubscription = (subscription) => {
   return {
     id: subscription.id,
-    customer_id: subscription.customer,
+    customer_id: subscription.customer?.toString(),
     status: toPaykitSubscriptionStatus(subscription.status),
     current_period_start: new Date(subscription.start_date),
-    current_period_end: new Date(subscription.cancel_at)
+    current_period_end: new Date(subscription.cancel_at),
+    metadata: stringifyObjectValues(subscription.metadata ?? {})
+  };
+};
+var toPaykitInvoice = (invoice) => {
+  return {
+    id: invoice.id,
+    amount: invoice.amount_paid,
+    currency: invoice.currency,
+    metadata: stringifyObjectValues(invoice.metadata ?? {}),
+    customer_id: invoice.customer?.toString() ?? ""
   };
 };
 
@@ -67,6 +90,7 @@ var StripeProvider = class {
     };
     this.deleteCustomer = async (id) => {
       await this.stripe.customers.del(id);
+      return null;
     };
     this.retrieveCustomer = async (id) => {
       const customer = await this.stripe.customers.retrieve(id);
@@ -77,8 +101,8 @@ var StripeProvider = class {
      * Subscription management
      */
     this.cancelSubscription = async (id) => {
-      const subscription = await this.stripe.subscriptions.cancel(id);
-      return toPaykitSubscription(subscription);
+      await this.stripe.subscriptions.cancel(id);
+      return null;
     };
     this.updateSubscription = async (id, params) => {
       const subscription = await this.stripe.subscriptions.update(id, { metadata: params.metadata });
@@ -97,43 +121,66 @@ var StripeProvider = class {
       const signature = stripeHeaders[0].value;
       const event = this.stripe.webhooks.constructEvent(body, signature, webhookSecret);
       if (event.type === "checkout.session.completed") {
-        const checkout = await this.retrieveCheckout(event.data.object.id);
-        const response = toPaykitEvent({ type: "$checkoutCreated", created: event.created, id: event.id, data: checkout });
-        return response;
+        const data = event.data.object;
+        return toPaykitEvent({
+          type: "$invoicePaid",
+          created: event.created,
+          id: event.id,
+          data: {
+            id: data.id,
+            amount: data.amount_total ?? 0,
+            currency: data.currency ?? "",
+            metadata: stringifyObjectValues2(data.metadata ?? {}),
+            customer_id: data.customer?.toString() ?? ""
+          }
+        });
       } else if (event.type === "customer.created") {
-        const customer = await this.createCustomer({ email: event.data.object.email, name: event.data.object.name ?? void 0 });
-        return toPaykitEvent({ type: "$customerCreated", created: event.created, id: event.id, data: customer });
+        const customer = event.data.object;
+        return toPaykitEvent({
+          type: "$customerCreated",
+          created: event.created,
+          id: event.id,
+          data: toPaykitCustomer(customer)
+        });
       } else if (event.type === "customer.updated") {
-        const { email, name } = event.data.object;
-        const customer = await this.updateCustomer(event.data.object.id, { email, name: name ?? void 0 });
-        return toPaykitEvent({ type: "$customerUpdated", created: event.created, id: event.id, data: customer });
+        const customer = event.data.object;
+        return toPaykitEvent({
+          type: "$customerUpdated",
+          created: event.created,
+          id: event.id,
+          data: toPaykitCustomer(customer)
+        });
       } else if (event.type === "customer.deleted") {
-        await this.deleteCustomer(event.data.object.id);
         return toPaykitEvent({ type: "$customerDeleted", created: event.created, id: event.id, data: null });
       } else if (event.type === "customer.subscription.created") {
-        const subscription = await this.retrieveSubscription(event.data.object.id);
-        return toPaykitEvent({ type: "$subscriptionCreated", created: event.created, id: event.id, data: subscription });
+        const subscription = event.data.object;
+        return toPaykitEvent({
+          type: "$subscriptionCreated",
+          created: event.created,
+          id: event.id,
+          data: toPaykitSubscription(subscription)
+        });
       } else if (event.type === "customer.subscription.updated") {
-        const subscription = await this.retrieveSubscription(event.data.object.id);
-        return toPaykitEvent({ type: "$subscriptionUpdated", created: event.created, id: event.id, data: subscription });
+        const subscription = event.data.object;
+        return toPaykitEvent({
+          type: "$subscriptionUpdated",
+          created: event.created,
+          id: event.id,
+          data: toPaykitSubscription(subscription)
+        });
       } else if (event.type === "customer.subscription.deleted") {
-        const subscription = await this.retrieveSubscription(event.data.object.id);
-        return toPaykitEvent({ type: "$subscriptionCanceled", created: event.created, id: event.id, data: subscription });
-      } else if (event.type === "customer.subscription.paused") {
-        const subscription = await this.retrieveSubscription(event.data.object.id);
-        return toPaykitEvent({ type: "$subscriptionUpdated", created: event.created, id: event.id, data: subscription });
-      } else if (event.type == "invoice.payment_succeeded") {
-        const checkoutId = event.data.object.metadata?.checkoutId;
-        if (!checkoutId) throw new Error("Checkout ID not found in invoice metadata");
-        const checkout = await this.retrieveCheckout(checkoutId);
+        const subscription = event.data.object;
         return toPaykitEvent({
-          type: "$paymentReceived",
+          type: "$subscriptionCancelled",
           created: event.created,
           id: event.id,
-          data: { ...checkout, checkoutId }
+          data: toPaykitSubscription(subscription)
         });
+      } else if (event.type == "invoice.paid") {
+        const invoice = event.data.object;
+        return toPaykitEvent({ type: "$invoicePaid", created: event.created, id: event.id, data: toPaykitInvoice(invoice) });
       }
-      throw new Error(`Unknown event type: ${event.type}`);
+      throw new Error(`Unhandled event type: ${event.type}`);
     };
     const { debug, apiKey, ...rest } = config;
     this.stripe = new Stripe(apiKey, rest);
@@ -150,7 +197,7 @@ var stripe = () => {
   if (!apiKey) {
     throw new Error("STRIPE_API_KEY is not set");
   }
-  return createStripe({ apiKey, debug: isDev, apiVersion: "2025-05-28.basil" });
+  return createStripe({ apiKey, debug: isDev, apiVersion: "2025-07-30.basil" });
 };
 export {
   createStripe,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@paykit-sdk/stripe",
-  "version": "1.1.0",
+  "version": "1.1.1",
   "description": "Stripe 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": [
     "stripe",
     "paykit",
@@ -20,12 +24,12 @@
     "stripe": "^18.2.1"
   },
   "peerDependencies": {
-    "@paykit-sdk/core": "^1.1.0"
+    "@paykit-sdk/core": "^1.1.1"
   },
   "devDependencies": {
     "tsup": "^8.0.0",
     "typescript": "^5.0.0",
-    "@paykit-sdk/core": "1.1.0"
+    "@paykit-sdk/core": "workspace:*"
   },
   "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"
   }
-}
+}