@parsrun/payments 0.1.0

package/dist/providers/stripe.js

@@ -0,0 +1,586 @@
+// src/types.ts
+import {
+  type,
+  currencyCode,
+  money,
+  paymentCustomer,
+  createCustomerRequest,
+  cardDetails,
+  paymentMethod,
+  paymentIntentStatus,
+  paymentIntent,
+  createPaymentIntentRequest,
+  subscriptionStatus,
+  priceInterval,
+  price,
+  subscription,
+  createSubscriptionRequest,
+  refundStatus,
+  refund,
+  createRefundRequest,
+  webhookEventType,
+  webhookEvent,
+  stripeConfig,
+  paddleConfig,
+  iyzicoConfig,
+  paymentsConfig
+} from "@parsrun/types";
+var PaymentError = class extends Error {
+  constructor(message, code, cause) {
+    super(message);
+    this.code = code;
+    this.cause = cause;
+    this.name = "PaymentError";
+  }
+};
+var PaymentErrorCodes = {
+  INVALID_CONFIG: "INVALID_CONFIG",
+  CUSTOMER_NOT_FOUND: "CUSTOMER_NOT_FOUND",
+  SUBSCRIPTION_NOT_FOUND: "SUBSCRIPTION_NOT_FOUND",
+  CHECKOUT_FAILED: "CHECKOUT_FAILED",
+  PAYMENT_FAILED: "PAYMENT_FAILED",
+  WEBHOOK_VERIFICATION_FAILED: "WEBHOOK_VERIFICATION_FAILED",
+  API_ERROR: "API_ERROR",
+  RATE_LIMITED: "RATE_LIMITED"
+};
+
+// src/providers/stripe.ts
+var StripeProvider = class {
+  type = "stripe";
+  secretKey;
+  webhookSecret;
+  baseUrl = "https://api.stripe.com/v1";
+  apiVersion;
+  constructor(config) {
+    this.secretKey = config.secretKey;
+    this.webhookSecret = config.webhookSecret;
+    this.apiVersion = config.apiVersion ?? "2024-12-18.acacia";
+  }
+  async request(endpoint, options = {}) {
+    const { method = "GET", body } = options;
+    const headers = {
+      Authorization: `Bearer ${this.secretKey}`,
+      "Stripe-Version": this.apiVersion
+    };
+    const fetchOptions = {
+      method,
+      headers
+    };
+    if (body) {
+      headers["Content-Type"] = "application/x-www-form-urlencoded";
+      fetchOptions.body = this.encodeFormData(body);
+    }
+    const response = await fetch(`${this.baseUrl}${endpoint}`, fetchOptions);
+    const data = await response.json();
+    if (!response.ok || data.error) {
+      const errorMessage = data.error?.message ?? `HTTP ${response.status}`;
+      throw new PaymentError(
+        `Stripe API error: ${errorMessage}`,
+        data.error?.code ?? PaymentErrorCodes.API_ERROR,
+        data.error
+      );
+    }
+    return data;
+  }
+  encodeFormData(obj, prefix = "") {
+    const parts = [];
+    for (const [key, value] of Object.entries(obj)) {
+      if (value === void 0 || value === null) continue;
+      const fullKey = prefix ? `${prefix}[${key}]` : key;
+      if (typeof value === "object" && !Array.isArray(value)) {
+        parts.push(this.encodeFormData(value, fullKey));
+      } else if (Array.isArray(value)) {
+        value.forEach((item, index) => {
+          if (typeof item === "object") {
+            parts.push(this.encodeFormData(item, `${fullKey}[${index}]`));
+          } else {
+            parts.push(`${encodeURIComponent(`${fullKey}[${index}]`)}=${encodeURIComponent(String(item))}`);
+          }
+        });
+      } else {
+        parts.push(`${encodeURIComponent(fullKey)}=${encodeURIComponent(String(value))}`);
+      }
+    }
+    return parts.filter(Boolean).join("&");
+  }
+  // ============================================================================
+  // Customer
+  // ============================================================================
+  async createCustomer(options) {
+    const body = {
+      email: options.email
+    };
+    if (options.name) body["name"] = options.name;
+    if (options.phone) body["phone"] = options.phone;
+    if (options.metadata) body["metadata"] = options.metadata;
+    if (options.address) {
+      body["address"] = {
+        line1: options.address.line1,
+        line2: options.address.line2,
+        city: options.address.city,
+        state: options.address.state,
+        postal_code: options.address.postalCode,
+        country: options.address.country
+      };
+    }
+    const result = await this.request("/customers", {
+      method: "POST",
+      body
+    });
+    return this.mapCustomer(result);
+  }
+  async getCustomer(customerId) {
+    try {
+      const result = await this.request(`/customers/${customerId}`);
+      return this.mapCustomer(result);
+    } catch (err) {
+      if (err instanceof PaymentError && err.code === "resource_missing") {
+        return null;
+      }
+      throw err;
+    }
+  }
+  async updateCustomer(customerId, options) {
+    const body = {};
+    if (options.email) body["email"] = options.email;
+    if (options.name) body["name"] = options.name;
+    if (options.phone) body["phone"] = options.phone;
+    if (options.metadata) body["metadata"] = options.metadata;
+    if (options.address) {
+      body["address"] = {
+        line1: options.address.line1,
+        line2: options.address.line2,
+        city: options.address.city,
+        state: options.address.state,
+        postal_code: options.address.postalCode,
+        country: options.address.country
+      };
+    }
+    const result = await this.request(`/customers/${customerId}`, {
+      method: "POST",
+      body
+    });
+    return this.mapCustomer(result);
+  }
+  async deleteCustomer(customerId) {
+    await this.request(`/customers/${customerId}`, { method: "DELETE" });
+  }
+  mapCustomer(stripe) {
+    return {
+      id: stripe.id,
+      email: stripe.email ?? "",
+      name: stripe.name ?? void 0,
+      phone: stripe.phone ?? void 0,
+      address: stripe.address ? {
+        line1: stripe.address.line1 ?? void 0,
+        line2: stripe.address.line2 ?? void 0,
+        city: stripe.address.city ?? void 0,
+        state: stripe.address.state ?? void 0,
+        postalCode: stripe.address.postal_code ?? void 0,
+        country: stripe.address.country ?? void 0
+      } : void 0,
+      metadata: stripe.metadata ?? void 0,
+      providerData: stripe
+    };
+  }
+  // ============================================================================
+  // Checkout
+  // ============================================================================
+  async createCheckout(options) {
+    const body = {
+      mode: options.mode,
+      success_url: options.successUrl,
+      cancel_url: options.cancelUrl,
+      line_items: options.lineItems.map((item) => ({
+        price: item.priceId,
+        quantity: item.quantity
+      }))
+    };
+    if (options.customerId) body["customer"] = options.customerId;
+    if (options.customerEmail) body["customer_email"] = options.customerEmail;
+    if (options.allowPromotionCodes) body["allow_promotion_codes"] = true;
+    if (options.metadata) body["metadata"] = options.metadata;
+    if (options.mode === "subscription" && options.trialDays) {
+      body["subscription_data"] = {
+        trial_period_days: options.trialDays
+      };
+    }
+    const result = await this.request("/checkout/sessions", {
+      method: "POST",
+      body
+    });
+    return this.mapCheckoutSession(result);
+  }
+  async getCheckout(sessionId) {
+    try {
+      const result = await this.request(
+        `/checkout/sessions/${sessionId}`
+      );
+      return this.mapCheckoutSession(result);
+    } catch (err) {
+      if (err instanceof PaymentError && err.code === "resource_missing") {
+        return null;
+      }
+      throw err;
+    }
+  }
+  mapCheckoutSession(stripe) {
+    return {
+      id: stripe.id,
+      url: stripe.url ?? "",
+      customerId: stripe.customer ?? void 0,
+      status: stripe.status,
+      mode: stripe.mode,
+      amountTotal: stripe.amount_total ?? void 0,
+      currency: stripe.currency ?? void 0,
+      providerData: stripe
+    };
+  }
+  // ============================================================================
+  // Subscriptions
+  // ============================================================================
+  async createSubscription(options) {
+    const body = {
+      customer: options.customerId,
+      items: [{ price: options.priceId }]
+    };
+    if (options.trialDays) body["trial_period_days"] = options.trialDays;
+    if (options.metadata) body["metadata"] = options.metadata;
+    if (options.paymentBehavior) body["payment_behavior"] = options.paymentBehavior;
+    const result = await this.request("/subscriptions", {
+      method: "POST",
+      body
+    });
+    return this.mapSubscription(result);
+  }
+  async getSubscription(subscriptionId) {
+    try {
+      const result = await this.request(
+        `/subscriptions/${subscriptionId}`
+      );
+      return this.mapSubscription(result);
+    } catch (err) {
+      if (err instanceof PaymentError && err.code === "resource_missing") {
+        return null;
+      }
+      throw err;
+    }
+  }
+  async updateSubscription(subscriptionId, options) {
+    const body = {};
+    if (options.cancelAtPeriodEnd !== void 0) {
+      body["cancel_at_period_end"] = options.cancelAtPeriodEnd;
+    }
+    if (options.metadata) body["metadata"] = options.metadata;
+    if (options.prorationBehavior) body["proration_behavior"] = options.prorationBehavior;
+    if (options.priceId) {
+      const current = await this.request(
+        `/subscriptions/${subscriptionId}`
+      );
+      const itemId = current.items.data[0]?.id;
+      if (itemId) {
+        body["items"] = [{ id: itemId, price: options.priceId }];
+      }
+    }
+    const result = await this.request(
+      `/subscriptions/${subscriptionId}`,
+      { method: "POST", body }
+    );
+    return this.mapSubscription(result);
+  }
+  async cancelSubscription(subscriptionId, cancelAtPeriodEnd = true) {
+    if (cancelAtPeriodEnd) {
+      return this.updateSubscription(subscriptionId, { cancelAtPeriodEnd: true });
+    }
+    const result = await this.request(
+      `/subscriptions/${subscriptionId}`,
+      { method: "DELETE" }
+    );
+    return this.mapSubscription(result);
+  }
+  async listSubscriptions(customerId) {
+    const result = await this.request(
+      `/subscriptions?customer=${customerId}`
+    );
+    return result.data.map((sub) => this.mapSubscription(sub));
+  }
+  mapSubscription(stripe) {
+    const item = stripe.items.data[0];
+    return {
+      id: stripe.id,
+      customerId: typeof stripe.customer === "string" ? stripe.customer : stripe.customer.id,
+      status: stripe.status,
+      priceId: item?.price.id ?? "",
+      productId: typeof item?.price.product === "string" ? item.price.product : item?.price.product?.id,
+      currentPeriodStart: new Date(stripe.current_period_start * 1e3),
+      currentPeriodEnd: new Date(stripe.current_period_end * 1e3),
+      cancelAtPeriodEnd: stripe.cancel_at_period_end,
+      canceledAt: stripe.canceled_at ? new Date(stripe.canceled_at * 1e3) : void 0,
+      trialStart: stripe.trial_start ? new Date(stripe.trial_start * 1e3) : void 0,
+      trialEnd: stripe.trial_end ? new Date(stripe.trial_end * 1e3) : void 0,
+      metadata: stripe.metadata ?? void 0,
+      providerData: stripe
+    };
+  }
+  // ============================================================================
+  // Portal
+  // ============================================================================
+  async createPortalSession(options) {
+    const result = await this.request("/billing_portal/sessions", {
+      method: "POST",
+      body: {
+        customer: options.customerId,
+        return_url: options.returnUrl
+      }
+    });
+    return {
+      url: result.url,
+      returnUrl: options.returnUrl
+    };
+  }
+  // ============================================================================
+  // Products & Prices
+  // ============================================================================
+  async getProduct(productId) {
+    try {
+      const result = await this.request(`/products/${productId}`);
+      return this.mapProduct(result);
+    } catch (err) {
+      if (err instanceof PaymentError && err.code === "resource_missing") {
+        return null;
+      }
+      throw err;
+    }
+  }
+  async getPrice(priceId) {
+    try {
+      const result = await this.request(`/prices/${priceId}`);
+      return this.mapPrice(result);
+    } catch (err) {
+      if (err instanceof PaymentError && err.code === "resource_missing") {
+        return null;
+      }
+      throw err;
+    }
+  }
+  async listPrices(productId) {
+    let endpoint = "/prices?active=true&limit=100";
+    if (productId) {
+      endpoint += `&product=${productId}`;
+    }
+    const result = await this.request(endpoint);
+    return result.data.map((price2) => this.mapPrice(price2));
+  }
+  mapProduct(stripe) {
+    return {
+      id: stripe.id,
+      name: stripe.name,
+      description: stripe.description ?? void 0,
+      active: stripe.active,
+      metadata: stripe.metadata ?? void 0,
+      providerData: stripe
+    };
+  }
+  mapPrice(stripe) {
+    return {
+      id: stripe.id,
+      productId: typeof stripe.product === "string" ? stripe.product : stripe.product.id,
+      unitAmount: stripe.unit_amount ?? 0,
+      currency: stripe.currency.toUpperCase(),
+      recurring: stripe.recurring ? {
+        interval: stripe.recurring.interval,
+        intervalCount: stripe.recurring.interval_count
+      } : void 0,
+      active: stripe.active,
+      metadata: stripe.metadata ?? void 0,
+      providerData: stripe
+    };
+  }
+  // ============================================================================
+  // Webhooks
+  // ============================================================================
+  async verifyWebhook(payload, signature) {
+    if (!this.webhookSecret) {
+      throw new PaymentError(
+        "Webhook secret not configured",
+        PaymentErrorCodes.INVALID_CONFIG
+      );
+    }
+    const payloadString = typeof payload === "string" ? payload : new TextDecoder().decode(payload);
+    const signatureParts = signature.split(",").reduce((acc, part) => {
+      const [key, value] = part.split("=");
+      if (key && value) {
+        acc[key] = value;
+      }
+      return acc;
+    }, {});
+    const timestamp = signatureParts["t"];
+    const expectedSignature = signatureParts["v1"];
+    if (!timestamp || !expectedSignature) {
+      return null;
+    }
+    const timestampSeconds = parseInt(timestamp, 10);
+    const now = Math.floor(Date.now() / 1e3);
+    if (Math.abs(now - timestampSeconds) > 300) {
+      return null;
+    }
+    const signedPayload = `${timestamp}.${payloadString}`;
+    const computedSignature = await this.computeHmacSignature(
+      signedPayload,
+      this.webhookSecret
+    );
+    if (!this.secureCompare(computedSignature, expectedSignature)) {
+      return null;
+    }
+    const event = JSON.parse(payloadString);
+    return {
+      id: event.id,
+      type: this.mapEventType(event.type),
+      data: event.data.object,
+      created: new Date(event.created * 1e3),
+      provider: "stripe",
+      raw: event
+    };
+  }
+  async computeHmacSignature(payload, secret) {
+    const encoder = new TextEncoder();
+    const keyData = encoder.encode(secret);
+    const messageData = encoder.encode(payload);
+    const cryptoKey = await crypto.subtle.importKey(
+      "raw",
+      keyData,
+      { name: "HMAC", hash: "SHA-256" },
+      false,
+      ["sign"]
+    );
+    const signature = await crypto.subtle.sign("HMAC", cryptoKey, messageData);
+    const signatureArray = new Uint8Array(signature);
+    return Array.from(signatureArray).map((b) => b.toString(16).padStart(2, "0")).join("");
+  }
+  secureCompare(a, b) {
+    if (a.length !== b.length) return false;
+    let result = 0;
+    for (let i = 0; i < a.length; i++) {
+      result |= a.charCodeAt(i) ^ b.charCodeAt(i);
+    }
+    return result === 0;
+  }
+  mapEventType(stripeType) {
+    const mapping = {
+      "checkout.session.completed": "checkout.session.completed",
+      "checkout.session.expired": "checkout.session.expired",
+      "customer.created": "customer.created",
+      "customer.updated": "customer.updated",
+      "customer.deleted": "customer.deleted",
+      "customer.subscription.created": "subscription.created",
+      "customer.subscription.updated": "subscription.updated",
+      "customer.subscription.deleted": "subscription.deleted",
+      "customer.subscription.trial_will_end": "subscription.trial_will_end",
+      "payment_intent.succeeded": "payment.succeeded",
+      "payment_intent.payment_failed": "payment.failed",
+      "invoice.created": "invoice.created",
+      "invoice.paid": "invoice.paid",
+      "invoice.payment_failed": "invoice.payment_failed",
+      "invoice.upcoming": "invoice.upcoming",
+      "charge.refunded": "refund.created",
+      "refund.created": "refund.created",
+      "refund.updated": "refund.updated"
+    };
+    return mapping[stripeType] ?? "unknown";
+  }
+  // ============================================================================
+  // Usage Reporting (Metered Billing)
+  // ============================================================================
+  /**
+   * Report usage for metered billing
+   *
+   * @example
+   * ```typescript
+   * // Report 100 API calls for a subscription item
+   * await stripe.reportUsage({
+   *   subscriptionItemId: "si_xxx",
+   *   quantity: 100,
+   *   action: "increment", // or "set" to replace
+   * });
+   * ```
+   */
+  async reportUsage(record) {
+    const body = {
+      quantity: record.quantity,
+      action: record.action ?? "increment"
+    };
+    if (record.timestamp) {
+      body["timestamp"] = Math.floor(record.timestamp.getTime() / 1e3);
+    }
+    const headers = {};
+    if (record.idempotencyKey) {
+      headers["Idempotency-Key"] = record.idempotencyKey;
+    }
+    await this.request(
+      `/subscription_items/${record.subscriptionItemId}/usage_records`,
+      {
+        method: "POST",
+        body
+      }
+    );
+  }
+  /**
+   * Report multiple usage records (batch)
+   * Note: Stripe doesn't have a batch API, so this is sequential
+   */
+  async reportUsageBatch(records) {
+    for (const record of records) {
+      await this.reportUsage(record);
+    }
+  }
+  /**
+   * Get subscription item ID for a subscription and price
+   */
+  async getSubscriptionItemId(subscriptionId, priceId) {
+    const subscription2 = await this.request(
+      `/subscriptions/${subscriptionId}`
+    );
+    const item = subscription2.items.data.find((i) => i.price.id === priceId);
+    return item?.id ?? null;
+  }
+  /**
+   * Get usage records for a subscription item
+   */
+  async getUsageRecords(subscriptionItemId, options) {
+    let endpoint = `/subscription_items/${subscriptionItemId}/usage_record_summaries?`;
+    if (options?.limit) {
+      endpoint += `limit=${options.limit}&`;
+    }
+    if (options?.startingAfter) {
+      endpoint += `starting_after=${options.startingAfter}&`;
+    }
+    if (options?.endingBefore) {
+      endpoint += `ending_before=${options.endingBefore}&`;
+    }
+    const result = await this.request(endpoint);
+    return {
+      data: result.data.map((r) => ({
+        id: r.id,
+        quantity: r.total_usage,
+        timestamp: new Date(r.period.start * 1e3),
+        subscriptionItem: r.subscription_item
+      })),
+      hasMore: result.has_more
+    };
+  }
+  /**
+   * Get current period usage total for a subscription item
+   */
+  async getCurrentUsage(subscriptionItemId) {
+    const result = await this.getUsageRecords(subscriptionItemId, { limit: 1 });
+    return result.data[0]?.quantity ?? 0;
+  }
+};
+function createStripeProvider(config) {
+  return new StripeProvider(config);
+}
+export {
+  StripeProvider,
+  createStripeProvider
+};
+//# sourceMappingURL=stripe.js.map