@paykit-sdk/stripe 1.0.0

package/dist/index.d.mts

@@ -0,0 +1,38 @@
+import { PayKitProvider } from '@paykit-sdk/core/src/paykit-provider';
+import { CreateCheckoutParams, Checkout, CreateCustomerParams, Customer, UpdateCustomerParams, Subscription, UpdateSubscriptionParams, WebhookEventPayload } from '@paykit-sdk/core/src/resources';
+import { WithPaymentProviderConfig } from '@paykit-sdk/core/src/types';
+import Stripe from 'stripe';
+
+interface StripeConfig extends WithPaymentProviderConfig<Stripe.StripeConfig> {
+    apiVersion?: Stripe.LatestApiVersion;
+}
+declare class StripeProvider implements PayKitProvider {
+    private stripe;
+    constructor(config: StripeConfig);
+    /**
+     * Checkout management
+     */
+    createCheckout: (params: CreateCheckoutParams) => Promise<Checkout>;
+    retrieveCheckout: (id: string) => Promise<Checkout>;
+    /**
+     * Customer management
+     */
+    createCustomer: (params: CreateCustomerParams) => Promise<Customer>;
+    updateCustomer: (id: string, params: UpdateCustomerParams) => Promise<Customer>;
+    deleteCustomer: (id: string) => Promise<void>;
+    retrieveCustomer: (id: string) => Promise<Customer | null>;
+    /**
+     * Subscription management
+     */
+    cancelSubscription: (id: string) => Promise<Subscription>;
+    updateSubscription: (id: string, params: UpdateSubscriptionParams) => Promise<Subscription>;
+    retrieveSubscription: (id: string) => Promise<Subscription>;
+    /**
+     * Webhook management
+     */
+    handleWebhook: (payload: string, signature: string, secret: string) => Promise<WebhookEventPayload>;
+}
+
+declare const stripe: () => StripeProvider;
+
+export { stripe };

package/dist/index.d.ts

@@ -0,0 +1,38 @@
+import { PayKitProvider } from '@paykit-sdk/core/src/paykit-provider';
+import { CreateCheckoutParams, Checkout, CreateCustomerParams, Customer, UpdateCustomerParams, Subscription, UpdateSubscriptionParams, WebhookEventPayload } from '@paykit-sdk/core/src/resources';
+import { WithPaymentProviderConfig } from '@paykit-sdk/core/src/types';
+import Stripe from 'stripe';
+
+interface StripeConfig extends WithPaymentProviderConfig<Stripe.StripeConfig> {
+    apiVersion?: Stripe.LatestApiVersion;
+}
+declare class StripeProvider implements PayKitProvider {
+    private stripe;
+    constructor(config: StripeConfig);
+    /**
+     * Checkout management
+     */
+    createCheckout: (params: CreateCheckoutParams) => Promise<Checkout>;
+    retrieveCheckout: (id: string) => Promise<Checkout>;
+    /**
+     * Customer management
+     */
+    createCustomer: (params: CreateCustomerParams) => Promise<Customer>;
+    updateCustomer: (id: string, params: UpdateCustomerParams) => Promise<Customer>;
+    deleteCustomer: (id: string) => Promise<void>;
+    retrieveCustomer: (id: string) => Promise<Customer | null>;
+    /**
+     * Subscription management
+     */
+    cancelSubscription: (id: string) => Promise<Subscription>;
+    updateSubscription: (id: string, params: UpdateSubscriptionParams) => Promise<Subscription>;
+    retrieveSubscription: (id: string) => Promise<Subscription>;
+    /**
+     * Webhook management
+     */
+    handleWebhook: (payload: string, signature: string, secret: string) => Promise<WebhookEventPayload>;
+}
+
+declare const stripe: () => StripeProvider;
+
+export { stripe };

package/dist/index.js

@@ -0,0 +1,167 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  stripe: () => stripe
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/stripe-provider.ts
+var import_resources2 = require("@paykit-sdk/core/src/resources");
+var import_stripe = __toESM(require("stripe"));
+
+// lib/mapper.ts
+var import_resources = require("@paykit-sdk/core/src/resources");
+var toPaykitCheckout = (checkout) => {
+  return {
+    id: checkout.id,
+    customer_id: checkout.customer,
+    mode: checkout.mode,
+    success_url: checkout.success_url,
+    cancel_url: checkout.cancel_url,
+    products: checkout.line_items.data.map((item) => ({ id: item.price.id, quantity: item.quantity })),
+    url: checkout.url,
+    ...checkout.metadata && { metadata: checkout.metadata }
+  };
+};
+var toPaykitCustomer = (customer) => {
+  return { id: customer.id, email: customer.email ?? void 0, name: customer.name ?? void 0 };
+};
+var toPaykitSubscription = (subscription) => {
+  return {
+    id: subscription.id,
+    customer_id: subscription.customer,
+    status: (0, import_resources.toPaykitSubscriptionStatus)(subscription.status),
+    current_period_start: new Date(subscription.start_date),
+    current_period_end: new Date(subscription.cancel_at)
+  };
+};
+
+// src/stripe-provider.ts
+var StripeProvider = class {
+  constructor(config) {
+    /**
+     * Checkout management
+     */
+    this.createCheckout = async (params) => {
+      const { customer_id, price_id, quantity, ...rest } = params;
+      const checkout = await this.stripe.checkout.sessions.create({ customer: customer_id, line_items: [{ price: price_id, quantity }], ...rest });
+      return toPaykitCheckout(checkout);
+    };
+    this.retrieveCheckout = async (id) => {
+      const checkout = await this.stripe.checkout.sessions.retrieve(id);
+      return toPaykitCheckout(checkout);
+    };
+    /**
+     * Customer management
+     */
+    this.createCustomer = async (params) => {
+      const customer = await this.stripe.customers.create(params);
+      return toPaykitCustomer(customer);
+    };
+    this.updateCustomer = async (id, params) => {
+      const customer = await this.stripe.customers.update(id, params);
+      return toPaykitCustomer(customer);
+    };
+    this.deleteCustomer = async (id) => {
+      await this.stripe.customers.del(id);
+    };
+    this.retrieveCustomer = async (id) => {
+      const customer = await this.stripe.customers.retrieve(id);
+      if ("deleted" in customer) return null;
+      return toPaykitCustomer(customer);
+    };
+    /**
+     * Subscription management
+     */
+    this.cancelSubscription = async (id) => {
+      const subscription = await this.stripe.subscriptions.cancel(id);
+      return toPaykitSubscription(subscription);
+    };
+    this.updateSubscription = async (id, params) => {
+      const subscription = await this.stripe.subscriptions.update(id, { metadata: params.metadata });
+      return toPaykitSubscription(subscription);
+    };
+    this.retrieveSubscription = async (id) => {
+      const subscription = await this.stripe.subscriptions.retrieve(id);
+      return toPaykitSubscription(subscription);
+    };
+    /**
+     * Webhook management
+     */
+    this.handleWebhook = async (payload, signature, secret) => {
+      const event = this.stripe.webhooks.constructEvent(payload, signature, secret);
+      if (event.type === "checkout.session.completed") {
+        const checkout = await this.retrieveCheckout(event.data.object.id);
+        return (0, import_resources2.toPaykitEvent)({ type: "checkout.created", created: event.created, id: event.id, data: checkout });
+      } else if (event.type === "customer.created") {
+        const customer = await this.retrieveCustomer(event.data.object.id);
+        return (0, import_resources2.toPaykitEvent)({ type: "customer.created", created: event.created, id: event.id, data: customer });
+      } else if (event.type === "customer.updated") {
+        const customer = await this.retrieveCustomer(event.data.object.id);
+        return (0, import_resources2.toPaykitEvent)({ type: "customer.updated", created: event.created, id: event.id, data: customer });
+      } else if (event.type === "customer.deleted") {
+        return (0, import_resources2.toPaykitEvent)({ type: "customer.deleted", 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_resources2.toPaykitEvent)({ type: "subscription.created", created: event.created, id: event.id, data: subscription });
+      } else if (event.type === "customer.subscription.updated") {
+        const subscription = await this.retrieveSubscription(event.data.object.id);
+        return (0, import_resources2.toPaykitEvent)({ type: "subscription.updated", created: event.created, id: event.id, data: subscription });
+      } else if (event.type === "customer.subscription.deleted") {
+        const subscription = await this.retrieveSubscription(event.data.object.id);
+        return (0, import_resources2.toPaykitEvent)({ type: "subscription.canceled", 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_resources2.toPaykitEvent)({ type: "subscription.updated", created: event.created, id: event.id, data: subscription });
+      }
+      throw new Error(`Unknown event type: ${event.type}`);
+    };
+    const { apiKey, ...rest } = config;
+    this.stripe = new import_stripe.default(apiKey, rest);
+  }
+};
+
+// src/index.ts
+var createStripe = (config) => {
+  return new StripeProvider(config);
+};
+var stripe = () => {
+  const apiKey = process.env.STRIPE_API_KEY;
+  if (!apiKey) {
+    throw new Error("STRIPE_API_KEY is not set");
+  }
+  return createStripe({ apiKey, apiVersion: "2025-05-28.basil" });
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  stripe
+});

package/dist/index.mjs

@@ -0,0 +1,132 @@
+// src/stripe-provider.ts
+import {
+  toPaykitEvent
+} from "@paykit-sdk/core/src/resources";
+import Stripe from "stripe";
+
+// lib/mapper.ts
+import { toPaykitSubscriptionStatus } from "@paykit-sdk/core/src/resources";
+var toPaykitCheckout = (checkout) => {
+  return {
+    id: checkout.id,
+    customer_id: checkout.customer,
+    mode: checkout.mode,
+    success_url: checkout.success_url,
+    cancel_url: checkout.cancel_url,
+    products: checkout.line_items.data.map((item) => ({ id: item.price.id, quantity: item.quantity })),
+    url: checkout.url,
+    ...checkout.metadata && { metadata: checkout.metadata }
+  };
+};
+var toPaykitCustomer = (customer) => {
+  return { id: customer.id, email: customer.email ?? void 0, name: customer.name ?? void 0 };
+};
+var toPaykitSubscription = (subscription) => {
+  return {
+    id: subscription.id,
+    customer_id: subscription.customer,
+    status: toPaykitSubscriptionStatus(subscription.status),
+    current_period_start: new Date(subscription.start_date),
+    current_period_end: new Date(subscription.cancel_at)
+  };
+};
+
+// src/stripe-provider.ts
+var StripeProvider = class {
+  constructor(config) {
+    /**
+     * Checkout management
+     */
+    this.createCheckout = async (params) => {
+      const { customer_id, price_id, quantity, ...rest } = params;
+      const checkout = await this.stripe.checkout.sessions.create({ customer: customer_id, line_items: [{ price: price_id, quantity }], ...rest });
+      return toPaykitCheckout(checkout);
+    };
+    this.retrieveCheckout = async (id) => {
+      const checkout = await this.stripe.checkout.sessions.retrieve(id);
+      return toPaykitCheckout(checkout);
+    };
+    /**
+     * Customer management
+     */
+    this.createCustomer = async (params) => {
+      const customer = await this.stripe.customers.create(params);
+      return toPaykitCustomer(customer);
+    };
+    this.updateCustomer = async (id, params) => {
+      const customer = await this.stripe.customers.update(id, params);
+      return toPaykitCustomer(customer);
+    };
+    this.deleteCustomer = async (id) => {
+      await this.stripe.customers.del(id);
+    };
+    this.retrieveCustomer = async (id) => {
+      const customer = await this.stripe.customers.retrieve(id);
+      if ("deleted" in customer) return null;
+      return toPaykitCustomer(customer);
+    };
+    /**
+     * Subscription management
+     */
+    this.cancelSubscription = async (id) => {
+      const subscription = await this.stripe.subscriptions.cancel(id);
+      return toPaykitSubscription(subscription);
+    };
+    this.updateSubscription = async (id, params) => {
+      const subscription = await this.stripe.subscriptions.update(id, { metadata: params.metadata });
+      return toPaykitSubscription(subscription);
+    };
+    this.retrieveSubscription = async (id) => {
+      const subscription = await this.stripe.subscriptions.retrieve(id);
+      return toPaykitSubscription(subscription);
+    };
+    /**
+     * Webhook management
+     */
+    this.handleWebhook = async (payload, signature, secret) => {
+      const event = this.stripe.webhooks.constructEvent(payload, signature, secret);
+      if (event.type === "checkout.session.completed") {
+        const checkout = await this.retrieveCheckout(event.data.object.id);
+        return toPaykitEvent({ type: "checkout.created", created: event.created, id: event.id, data: checkout });
+      } else if (event.type === "customer.created") {
+        const customer = await this.retrieveCustomer(event.data.object.id);
+        return toPaykitEvent({ type: "customer.created", created: event.created, id: event.id, data: customer });
+      } else if (event.type === "customer.updated") {
+        const customer = await this.retrieveCustomer(event.data.object.id);
+        return toPaykitEvent({ type: "customer.updated", created: event.created, id: event.id, data: customer });
+      } else if (event.type === "customer.deleted") {
+        return toPaykitEvent({ type: "customer.deleted", 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: "subscription.created", created: event.created, id: event.id, data: subscription });
+      } else if (event.type === "customer.subscription.updated") {
+        const subscription = await this.retrieveSubscription(event.data.object.id);
+        return toPaykitEvent({ type: "subscription.updated", created: event.created, id: event.id, data: subscription });
+      } else if (event.type === "customer.subscription.deleted") {
+        const subscription = await this.retrieveSubscription(event.data.object.id);
+        return toPaykitEvent({ type: "subscription.canceled", 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: "subscription.updated", created: event.created, id: event.id, data: subscription });
+      }
+      throw new Error(`Unknown event type: ${event.type}`);
+    };
+    const { apiKey, ...rest } = config;
+    this.stripe = new Stripe(apiKey, rest);
+  }
+};
+
+// src/index.ts
+var createStripe = (config) => {
+  return new StripeProvider(config);
+};
+var stripe = () => {
+  const apiKey = process.env.STRIPE_API_KEY;
+  if (!apiKey) {
+    throw new Error("STRIPE_API_KEY is not set");
+  }
+  return createStripe({ apiKey, apiVersion: "2025-05-28.basil" });
+};
+export {
+  stripe
+};

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@paykit-sdk/stripe",
+  "version": "1.0.0",
+  "description": "Stripe provider for PayKit",
+  "main": "dist/index.js",
+  "module": "dist/index.esm.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts --format cjs,esm --dts",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "stripe",
+    "paykit",
+    "payment",
+    "typescript"
+  ],
+  "author": "Emmanuel Odii",
+  "license": "ISC",
+  "dependencies": {
+    "stripe": "^18.2.1"
+  },
+  "peerDependencies": {
+    "@paykit-sdk/core": "^1.0.0"
+  },
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "typescript": "^5.0.0",
+    "@paykit-sdk/core": "workspace:*"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/devodii/paykit.git"
+  },
+  "bugs": {
+    "url": "https://github.com/devodii/paykit/issues"
+  }
+}