@coduckai/sdk 0.1.0 → 0.3.1

package/dist/payments/index.d.cts

@@ -1,14 +1,77 @@
+import Stripe from 'stripe';
+
 /**
  * @coduckai/sdk/payments — Stripe Payments (server-only)
  *
- * Coming in v0.2.0. Wraps Stripe SDK with Connect destination charges.
+ * Wraps Stripe SDK with automatic Connect direct charges via stripeAccount header.
+ * Auto-reads STRIPE_SECRET_KEY, STRIPE_CONNECTED_ACCOUNT_ID, STRIPE_WEBHOOK_SECRET from env.
  */
+
+interface CheckoutItem {
+    name: string;
+    /** Price in dollars (e.g. 29.99) */
+    price: number;
+    quantity?: number;
+    description?: string;
+    image?: string;
+}
+interface CreateCheckoutOptions {
+    items: CheckoutItem[];
+    successUrl: string;
+    cancelUrl: string;
+    customerEmail?: string;
+    metadata?: Record<string, string>;
+    /** Application fee in cents charged on top of the payment (Connect only) */
+    applicationFeeAmount?: number;
+}
+interface CreateSubscriptionOptions {
+    priceId: string;
+    successUrl: string;
+    cancelUrl: string;
+    customerEmail?: string;
+    trialDays?: number;
+    metadata?: Record<string, string>;
+    /** Application fee percentage for recurring charges (0-100, Connect only) */
+    applicationFeePercent?: number;
+}
+interface CheckoutResult {
+    url: string;
+    sessionId: string;
+}
+interface WebhookHandlers {
+    onCheckoutComplete?: (session: Stripe.Checkout.Session) => Promise<void> | void;
+    onSubscriptionCreated?: (subscription: Stripe.Subscription) => Promise<void> | void;
+    onSubscriptionUpdated?: (subscription: Stripe.Subscription) => Promise<void> | void;
+    onSubscriptionDeleted?: (subscription: Stripe.Subscription) => Promise<void> | void;
+    onPaymentSucceeded?: (invoice: Stripe.Invoice) => Promise<void> | void;
+    onPaymentFailed?: (invoice: Stripe.Invoice) => Promise<void> | void;
+    onChargeRefunded?: (charge: Stripe.Charge) => Promise<void> | void;
+}
 declare const payments: {
-    createCheckout: () => never;
-    createSubscription: () => never;
-    handleWebhook: () => never;
-    webhookMiddleware: () => never;
-    getStripe: () => never;
+    /**
+     * Create a Stripe Checkout Session for one-time payment.
+     * Automatically uses direct charges (stripeAccount) when STRIPE_CONNECTED_ACCOUNT_ID is set.
+     */
+    createCheckout(options: CreateCheckoutOptions): Promise<CheckoutResult>;
+    /**
+     * Create a Stripe Checkout Session for subscriptions.
+     * Automatically uses direct charges (stripeAccount) when STRIPE_CONNECTED_ACCOUNT_ID is set.
+     */
+    createSubscription(options: CreateSubscriptionOptions): Promise<CheckoutResult>;
+    /**
+     * Handle Stripe webhook events with typed handlers.
+     * Verifies the webhook signature and dispatches to your handler callbacks.
+     */
+    handleWebhook(req: any, handlers: WebhookHandlers): Promise<void>;
+    /**
+     * Express middleware for webhook routes.
+     * Applies express.raw() body parser — mount BEFORE any json() middleware.
+     */
+    webhookMiddleware(): any;
+    /**
+     * Get the underlying Stripe instance for advanced usage.
+     */
+    getStripe(): Stripe;
 };
 
-export { payments };
+export { type CheckoutItem, type CheckoutResult, type CreateCheckoutOptions, type CreateSubscriptionOptions, type WebhookHandlers, payments };

package/dist/payments/index.d.ts

@@ -1,14 +1,77 @@
+import Stripe from 'stripe';
+
 /**
  * @coduckai/sdk/payments — Stripe Payments (server-only)
  *
- * Coming in v0.2.0. Wraps Stripe SDK with Connect destination charges.
+ * Wraps Stripe SDK with automatic Connect direct charges via stripeAccount header.
+ * Auto-reads STRIPE_SECRET_KEY, STRIPE_CONNECTED_ACCOUNT_ID, STRIPE_WEBHOOK_SECRET from env.
  */
+
+interface CheckoutItem {
+    name: string;
+    /** Price in dollars (e.g. 29.99) */
+    price: number;
+    quantity?: number;
+    description?: string;
+    image?: string;
+}
+interface CreateCheckoutOptions {
+    items: CheckoutItem[];
+    successUrl: string;
+    cancelUrl: string;
+    customerEmail?: string;
+    metadata?: Record<string, string>;
+    /** Application fee in cents charged on top of the payment (Connect only) */
+    applicationFeeAmount?: number;
+}
+interface CreateSubscriptionOptions {
+    priceId: string;
+    successUrl: string;
+    cancelUrl: string;
+    customerEmail?: string;
+    trialDays?: number;
+    metadata?: Record<string, string>;
+    /** Application fee percentage for recurring charges (0-100, Connect only) */
+    applicationFeePercent?: number;
+}
+interface CheckoutResult {
+    url: string;
+    sessionId: string;
+}
+interface WebhookHandlers {
+    onCheckoutComplete?: (session: Stripe.Checkout.Session) => Promise<void> | void;
+    onSubscriptionCreated?: (subscription: Stripe.Subscription) => Promise<void> | void;
+    onSubscriptionUpdated?: (subscription: Stripe.Subscription) => Promise<void> | void;
+    onSubscriptionDeleted?: (subscription: Stripe.Subscription) => Promise<void> | void;
+    onPaymentSucceeded?: (invoice: Stripe.Invoice) => Promise<void> | void;
+    onPaymentFailed?: (invoice: Stripe.Invoice) => Promise<void> | void;
+    onChargeRefunded?: (charge: Stripe.Charge) => Promise<void> | void;
+}
 declare const payments: {
-    createCheckout: () => never;
-    createSubscription: () => never;
-    handleWebhook: () => never;
-    webhookMiddleware: () => never;
-    getStripe: () => never;
+    /**
+     * Create a Stripe Checkout Session for one-time payment.
+     * Automatically uses direct charges (stripeAccount) when STRIPE_CONNECTED_ACCOUNT_ID is set.
+     */
+    createCheckout(options: CreateCheckoutOptions): Promise<CheckoutResult>;
+    /**
+     * Create a Stripe Checkout Session for subscriptions.
+     * Automatically uses direct charges (stripeAccount) when STRIPE_CONNECTED_ACCOUNT_ID is set.
+     */
+    createSubscription(options: CreateSubscriptionOptions): Promise<CheckoutResult>;
+    /**
+     * Handle Stripe webhook events with typed handlers.
+     * Verifies the webhook signature and dispatches to your handler callbacks.
+     */
+    handleWebhook(req: any, handlers: WebhookHandlers): Promise<void>;
+    /**
+     * Express middleware for webhook routes.
+     * Applies express.raw() body parser — mount BEFORE any json() middleware.
+     */
+    webhookMiddleware(): any;
+    /**
+     * Get the underlying Stripe instance for advanced usage.
+     */
+    getStripe(): Stripe;
 };
 
-export { payments };
+export { type CheckoutItem, type CheckoutResult, type CreateCheckoutOptions, type CreateSubscriptionOptions, type WebhookHandlers, payments };

package/dist/payments/index.js

@@ -1,3 +1,12 @@
+import Stripe from 'stripe';
+
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined") return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
+
 // src/internal/env.ts
 function isServer() {
   return typeof window === "undefined";
@@ -10,20 +19,155 @@ function assertServer(moduleName) {
   }
 }
 
-// src/payments/index.ts
+// src/internal/config.ts
+var globalConfig = {};
+function getConfig() {
+  return globalConfig;
+}
 assertServer("payments");
+var stripeInstance = null;
+function getStripeInstance() {
+  if (stripeInstance) return stripeInstance;
+  const config = getConfig();
+  const secretKey = config.payments?.stripeSecretKey || process.env.STRIPE_SECRET_KEY;
+  if (!secretKey) {
+    throw new Error(
+      "@coduckai/sdk/payments: STRIPE_SECRET_KEY is required. Set the env var or call configure()."
+    );
+  }
+  stripeInstance = new Stripe(secretKey);
+  return stripeInstance;
+}
+function getConnectedAccountId() {
+  const config = getConfig();
+  return config.payments?.connectedAccountId || process.env.STRIPE_CONNECTED_ACCOUNT_ID || void 0;
+}
+function getWebhookSecret() {
+  const config = getConfig();
+  const secret = config.payments?.webhookSecret || process.env.STRIPE_WEBHOOK_SECRET;
+  if (!secret) {
+    throw new Error(
+      "@coduckai/sdk/payments: STRIPE_WEBHOOK_SECRET is required for webhook handling."
+    );
+  }
+  return secret;
+}
 var payments = {
-  createCheckout: notImplemented("payments.createCheckout"),
-  createSubscription: notImplemented("payments.createSubscription"),
-  handleWebhook: notImplemented("payments.handleWebhook"),
-  webhookMiddleware: notImplemented("payments.webhookMiddleware"),
-  getStripe: notImplemented("payments.getStripe")
+  /**
+   * Create a Stripe Checkout Session for one-time payment.
+   * Automatically uses direct charges (stripeAccount) when STRIPE_CONNECTED_ACCOUNT_ID is set.
+   */
+  async createCheckout(options) {
+    const stripe = getStripeInstance();
+    const connectedAccountId = getConnectedAccountId();
+    const params = {
+      mode: "payment",
+      line_items: options.items.map((item) => ({
+        price_data: {
+          currency: "usd",
+          product_data: {
+            name: item.name,
+            ...item.description && { description: item.description },
+            ...item.image && { images: [item.image] }
+          },
+          unit_amount: Math.round(item.price * 100)
+        },
+        quantity: item.quantity || 1
+      })),
+      success_url: options.successUrl,
+      cancel_url: options.cancelUrl,
+      ...options.customerEmail && { customer_email: options.customerEmail },
+      ...options.metadata && { metadata: options.metadata }
+    };
+    if (connectedAccountId && options.applicationFeeAmount) {
+      params.payment_intent_data = {
+        application_fee_amount: options.applicationFeeAmount
+      };
+    }
+    const requestOptions = connectedAccountId ? { stripeAccount: connectedAccountId } : void 0;
+    const session = await stripe.checkout.sessions.create(params, requestOptions);
+    return { url: session.url, sessionId: session.id };
+  },
+  /**
+   * Create a Stripe Checkout Session for subscriptions.
+   * Automatically uses direct charges (stripeAccount) when STRIPE_CONNECTED_ACCOUNT_ID is set.
+   */
+  async createSubscription(options) {
+    const stripe = getStripeInstance();
+    const connectedAccountId = getConnectedAccountId();
+    const params = {
+      mode: "subscription",
+      line_items: [{ price: options.priceId, quantity: 1 }],
+      success_url: options.successUrl,
+      cancel_url: options.cancelUrl,
+      ...options.customerEmail && { customer_email: options.customerEmail },
+      ...options.metadata && { metadata: options.metadata }
+    };
+    if (options.trialDays || connectedAccountId && options.applicationFeePercent) {
+      params.subscription_data = {};
+      if (options.trialDays) {
+        params.subscription_data.trial_period_days = options.trialDays;
+      }
+      if (connectedAccountId && options.applicationFeePercent) {
+        params.subscription_data.application_fee_percent = options.applicationFeePercent;
+      }
+    }
+    const requestOptions = connectedAccountId ? { stripeAccount: connectedAccountId } : void 0;
+    const session = await stripe.checkout.sessions.create(params, requestOptions);
+    return { url: session.url, sessionId: session.id };
+  },
+  /**
+   * Handle Stripe webhook events with typed handlers.
+   * Verifies the webhook signature and dispatches to your handler callbacks.
+   */
+  async handleWebhook(req, handlers) {
+    const stripe = getStripeInstance();
+    const webhookSecret = getWebhookSecret();
+    const sig = req.headers["stripe-signature"];
+    const event = stripe.webhooks.constructEvent(req.body, sig, webhookSecret);
+    switch (event.type) {
+      case "checkout.session.completed":
+        await handlers.onCheckoutComplete?.(event.data.object);
+        break;
+      case "customer.subscription.created":
+        await handlers.onSubscriptionCreated?.(event.data.object);
+        break;
+      case "customer.subscription.updated":
+        await handlers.onSubscriptionUpdated?.(event.data.object);
+        break;
+      case "customer.subscription.deleted":
+        await handlers.onSubscriptionDeleted?.(event.data.object);
+        break;
+      case "invoice.payment_succeeded":
+        await handlers.onPaymentSucceeded?.(event.data.object);
+        break;
+      case "invoice.payment_failed":
+        await handlers.onPaymentFailed?.(event.data.object);
+        break;
+      case "charge.refunded":
+        await handlers.onChargeRefunded?.(event.data.object);
+        break;
+    }
+  },
+  /**
+   * Express middleware for webhook routes.
+   * Applies express.raw() body parser — mount BEFORE any json() middleware.
+   */
+  webhookMiddleware() {
+    try {
+      const express = __require("express");
+      return express.raw({ type: "application/json" });
+    } catch {
+      return (_req, _res, next) => next();
+    }
+  },
+  /**
+   * Get the underlying Stripe instance for advanced usage.
+   */
+  getStripe() {
+    return getStripeInstance();
+  }
 };
-function notImplemented(name) {
-  return () => {
-    throw new Error(`@coduckai/sdk: ${name}() is not yet implemented. Coming in v0.2.0.`);
-  };
-}
 
 export { payments };
 //# sourceMappingURL=index.js.map

package/dist/payments/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/internal/env.ts","../../src/payments/index.ts"],"names":[],"mappings":";AAgBO,SAAS,QAAA,GAAoB;AAClC,EAAA,OAAO,OAAO,MAAA,KAAW,WAAA;AAC3B;AAEO,SAAS,aAAa,UAAA,EAA0B;AACrD,EAAA,IAAI,CAAC,UAAS,EAAG;AACf,IAAA,MAAM,IAAI,KAAA;AAAA,MACR,iBAAiB,UAAU,CAAA,2DAAA;AAAA,KAC7B;AAAA,EACF;AACF;;;ACnBA,YAAA,CAAa,UAAU,CAAA;AAEhB,IAAM,QAAA,GAAW;AAAA,EACtB,cAAA,EAAgB,eAAe,yBAAyB,CAAA;AAAA,EACxD,kBAAA,EAAoB,eAAe,6BAA6B,CAAA;AAAA,EAChE,aAAA,EAAe,eAAe,wBAAwB,CAAA;AAAA,EACtD,iBAAA,EAAmB,eAAe,4BAA4B,CAAA;AAAA,EAC9D,SAAA,EAAW,eAAe,oBAAoB;AAChD;AAEA,SAAS,eAAe,IAAA,EAAc;AACpC,EAAA,OAAO,MAAM;AACX,IAAA,MAAM,IAAI,KAAA,CAAM,CAAA,eAAA,EAAkB,IAAI,CAAA,4CAAA,CAA8C,CAAA;AAAA,EACtF,CAAA;AACF","file":"index.js","sourcesContent":["/**\n * Environment variable helpers\n */\n\nexport function getEnv(key: string, fallback?: string): string | undefined {\n  return process.env[key] || fallback;\n}\n\nexport function requireEnv(key: string): string {\n  const val = process.env[key];\n  if (!val) {\n    throw new Error(`@coduckai/sdk: Missing required environment variable: ${key}`);\n  }\n  return val;\n}\n\nexport function isServer(): boolean {\n  return typeof window === 'undefined';\n}\n\nexport function assertServer(moduleName: string): void {\n  if (!isServer()) {\n    throw new Error(\n      `@coduckai/sdk/${moduleName} is server-only. Use @coduckai/sdk/client for browser code.`\n    );\n  }\n}\n","/**\n * @coduckai/sdk/payments — Stripe Payments (server-only)\n *\n * Coming in v0.2.0. Wraps Stripe SDK with Connect destination charges.\n */\n\nimport { assertServer } from '../internal/env';\nassertServer('payments');\n\nexport const payments = {\n  createCheckout: notImplemented('payments.createCheckout'),\n  createSubscription: notImplemented('payments.createSubscription'),\n  handleWebhook: notImplemented('payments.handleWebhook'),\n  webhookMiddleware: notImplemented('payments.webhookMiddleware'),\n  getStripe: notImplemented('payments.getStripe'),\n};\n\nfunction notImplemented(name: string) {\n  return () => {\n    throw new Error(`@coduckai/sdk: ${name}() is not yet implemented. Coming in v0.2.0.`);\n  };\n}\n"]}
+{"version":3,"sources":["../../src/internal/env.ts","../../src/internal/config.ts","../../src/payments/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Environment variable helpers\n */\n\nexport function getEnv(key: string, fallback?: string): string | undefined {\n  return process.env[key] || fallback;\n}\n\nexport function requireEnv(key: string): string {\n  const val = process.env[key];\n  if (!val) {\n    throw new Error(`@coduckai/sdk: Missing required environment variable: ${key}`);\n  }\n  return val;\n}\n\nexport function isServer(): boolean {\n  return typeof window === 'undefined';\n}\n\nexport function assertServer(moduleName: string): void {\n  if (!isServer()) {\n    throw new Error(\n      `@coduckai/sdk/${moduleName} is server-only. Use @coduckai/sdk/client for browser code.`\n    );\n  }\n}\n","/**\n * Global SDK configuration\n *\n * CoDuck apps use env vars automatically — no configure() needed.\n * Standalone usage can call configure() to override.\n */\n\nexport interface SDKConfig {\n  auth?: {\n    jwtSecret?: string;\n    jwtExpiresIn?: string;\n    bcryptRounds?: number;\n  };\n  db?: {\n    connectionString?: string;\n  };\n  client?: {\n    baseUrl?: string;\n    tokenKey?: string;\n  };\n  payments?: {\n    stripeSecretKey?: string;\n    connectedAccountId?: string;\n    webhookSecret?: string;\n  };\n  ai?: {\n    provider?: 'openai' | 'anthropic';\n    apiKey?: string;\n  };\n}\n\nlet globalConfig: SDKConfig = {};\n\nexport function setConfig(config: SDKConfig): void {\n  globalConfig = { ...globalConfig, ...config };\n}\n\nexport function getConfig(): SDKConfig {\n  return globalConfig;\n}\n","/**\n * @coduckai/sdk/payments — Stripe Payments (server-only)\n *\n * Wraps Stripe SDK with automatic Connect direct charges via stripeAccount header.\n * Auto-reads STRIPE_SECRET_KEY, STRIPE_CONNECTED_ACCOUNT_ID, STRIPE_WEBHOOK_SECRET from env.\n */\n\nimport { assertServer } from '../internal/env';\nimport { getConfig } from '../internal/config';\nimport Stripe from 'stripe';\n\nassertServer('payments');\n\n// ---------------------------------------------------------------------------\n// Lazy singleton Stripe instance\n// ---------------------------------------------------------------------------\n\nlet stripeInstance: Stripe | null = null;\n\nfunction getStripeInstance(): Stripe {\n  if (stripeInstance) return stripeInstance;\n\n  const config = getConfig();\n  const secretKey = config.payments?.stripeSecretKey || process.env.STRIPE_SECRET_KEY;\n\n  if (!secretKey) {\n    throw new Error(\n      '@coduckai/sdk/payments: STRIPE_SECRET_KEY is required. Set the env var or call configure().'\n    );\n  }\n\n  stripeInstance = new Stripe(secretKey);\n  return stripeInstance;\n}\n\nfunction getConnectedAccountId(): string | undefined {\n  const config = getConfig();\n  return config.payments?.connectedAccountId || process.env.STRIPE_CONNECTED_ACCOUNT_ID || undefined;\n}\n\nfunction getWebhookSecret(): string {\n  const config = getConfig();\n  const secret = config.payments?.webhookSecret || process.env.STRIPE_WEBHOOK_SECRET;\n  if (!secret) {\n    throw new Error(\n      '@coduckai/sdk/payments: STRIPE_WEBHOOK_SECRET is required for webhook handling.'\n    );\n  }\n  return secret;\n}\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\nexport interface CheckoutItem {\n  name: string;\n  /** Price in dollars (e.g. 29.99) */\n  price: number;\n  quantity?: number;\n  description?: string;\n  image?: string;\n}\n\nexport interface CreateCheckoutOptions {\n  items: CheckoutItem[];\n  successUrl: string;\n  cancelUrl: string;\n  customerEmail?: string;\n  metadata?: Record<string, string>;\n  /** Application fee in cents charged on top of the payment (Connect only) */\n  applicationFeeAmount?: number;\n}\n\nexport interface CreateSubscriptionOptions {\n  priceId: string;\n  successUrl: string;\n  cancelUrl: string;\n  customerEmail?: string;\n  trialDays?: number;\n  metadata?: Record<string, string>;\n  /** Application fee percentage for recurring charges (0-100, Connect only) */\n  applicationFeePercent?: number;\n}\n\nexport interface CheckoutResult {\n  url: string;\n  sessionId: string;\n}\n\nexport interface WebhookHandlers {\n  onCheckoutComplete?: (session: Stripe.Checkout.Session) => Promise<void> | void;\n  onSubscriptionCreated?: (subscription: Stripe.Subscription) => Promise<void> | void;\n  onSubscriptionUpdated?: (subscription: Stripe.Subscription) => Promise<void> | void;\n  onSubscriptionDeleted?: (subscription: Stripe.Subscription) => Promise<void> | void;\n  onPaymentSucceeded?: (invoice: Stripe.Invoice) => Promise<void> | void;\n  onPaymentFailed?: (invoice: Stripe.Invoice) => Promise<void> | void;\n  onChargeRefunded?: (charge: Stripe.Charge) => Promise<void> | void;\n}\n\n// ---------------------------------------------------------------------------\n// Payments API\n// ---------------------------------------------------------------------------\n\nexport const payments = {\n  /**\n   * Create a Stripe Checkout Session for one-time payment.\n   * Automatically uses direct charges (stripeAccount) when STRIPE_CONNECTED_ACCOUNT_ID is set.\n   */\n  async createCheckout(options: CreateCheckoutOptions): Promise<CheckoutResult> {\n    const stripe = getStripeInstance();\n    const connectedAccountId = getConnectedAccountId();\n\n    const params: Stripe.Checkout.SessionCreateParams = {\n      mode: 'payment',\n      line_items: options.items.map(item => ({\n        price_data: {\n          currency: 'usd',\n          product_data: {\n            name: item.name,\n            ...(item.description && { description: item.description }),\n            ...(item.image && { images: [item.image] }),\n          },\n          unit_amount: Math.round(item.price * 100),\n        },\n        quantity: item.quantity || 1,\n      })),\n      success_url: options.successUrl,\n      cancel_url: options.cancelUrl,\n      ...(options.customerEmail && { customer_email: options.customerEmail }),\n      ...(options.metadata && { metadata: options.metadata }),\n    };\n\n    if (connectedAccountId && options.applicationFeeAmount) {\n      params.payment_intent_data = {\n        application_fee_amount: options.applicationFeeAmount,\n      };\n    }\n\n    const requestOptions: Stripe.RequestOptions | undefined = connectedAccountId\n      ? { stripeAccount: connectedAccountId }\n      : undefined;\n\n    const session = await stripe.checkout.sessions.create(params, requestOptions);\n\n    return { url: session.url!, sessionId: session.id };\n  },\n\n  /**\n   * Create a Stripe Checkout Session for subscriptions.\n   * Automatically uses direct charges (stripeAccount) when STRIPE_CONNECTED_ACCOUNT_ID is set.\n   */\n  async createSubscription(options: CreateSubscriptionOptions): Promise<CheckoutResult> {\n    const stripe = getStripeInstance();\n    const connectedAccountId = getConnectedAccountId();\n\n    const params: Stripe.Checkout.SessionCreateParams = {\n      mode: 'subscription',\n      line_items: [{ price: options.priceId, quantity: 1 }],\n      success_url: options.successUrl,\n      cancel_url: options.cancelUrl,\n      ...(options.customerEmail && { customer_email: options.customerEmail }),\n      ...(options.metadata && { metadata: options.metadata }),\n    };\n\n    if (options.trialDays || (connectedAccountId && options.applicationFeePercent)) {\n      params.subscription_data = {};\n      if (options.trialDays) {\n        params.subscription_data.trial_period_days = options.trialDays;\n      }\n      if (connectedAccountId && options.applicationFeePercent) {\n        params.subscription_data.application_fee_percent = options.applicationFeePercent;\n      }\n    }\n\n    const requestOptions: Stripe.RequestOptions | undefined = connectedAccountId\n      ? { stripeAccount: connectedAccountId }\n      : undefined;\n\n    const session = await stripe.checkout.sessions.create(params, requestOptions);\n\n    return { url: session.url!, sessionId: session.id };\n  },\n\n  /**\n   * Handle Stripe webhook events with typed handlers.\n   * Verifies the webhook signature and dispatches to your handler callbacks.\n   */\n  async handleWebhook(req: any, handlers: WebhookHandlers): Promise<void> {\n    const stripe = getStripeInstance();\n    const webhookSecret = getWebhookSecret();\n\n    const sig = req.headers['stripe-signature'];\n    const event = stripe.webhooks.constructEvent(req.body, sig, webhookSecret);\n\n    switch (event.type) {\n      case 'checkout.session.completed':\n        await handlers.onCheckoutComplete?.(event.data.object as Stripe.Checkout.Session);\n        break;\n      case 'customer.subscription.created':\n        await handlers.onSubscriptionCreated?.(event.data.object as Stripe.Subscription);\n        break;\n      case 'customer.subscription.updated':\n        await handlers.onSubscriptionUpdated?.(event.data.object as Stripe.Subscription);\n        break;\n      case 'customer.subscription.deleted':\n        await handlers.onSubscriptionDeleted?.(event.data.object as Stripe.Subscription);\n        break;\n      case 'invoice.payment_succeeded':\n        await handlers.onPaymentSucceeded?.(event.data.object as Stripe.Invoice);\n        break;\n      case 'invoice.payment_failed':\n        await handlers.onPaymentFailed?.(event.data.object as Stripe.Invoice);\n        break;\n      case 'charge.refunded':\n        await handlers.onChargeRefunded?.(event.data.object as Stripe.Charge);\n        break;\n    }\n  },\n\n  /**\n   * Express middleware for webhook routes.\n   * Applies express.raw() body parser — mount BEFORE any json() middleware.\n   */\n  webhookMiddleware(): any {\n    try {\n      const express = require('express');\n      return express.raw({ type: 'application/json' });\n    } catch {\n      return (_req: any, _res: any, next: any) => next();\n    }\n  },\n\n  /**\n   * Get the underlying Stripe instance for advanced usage.\n   */\n  getStripe(): Stripe {\n    return getStripeInstance();\n  },\n};\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coduckai/sdk",
-  "version": "0.1.0",
+  "version": "0.3.1",
   "description": "CoDuck platform SDK — auth, database, payments, AI, and more for generated apps",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -60,31 +60,53 @@
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
+    "axios": "^1.6.2",
     "bcrypt": "^5.1.1",
     "jsonwebtoken": "^9.0.2",
-    "pg": "^8.11.3",
-    "axios": "^1.6.2"
+    "pg": "^8.11.3"
   },
   "devDependencies": {
+    "@anthropic-ai/sdk": "^0.74.0",
     "@types/bcrypt": "^5.0.2",
-    "@types/jsonwebtoken": "^9.0.7",
-    "@types/pg": "^8.11.10",
     "@types/express": "^4.17.21",
+    "@types/jsonwebtoken": "^9.0.7",
     "@types/node": "^20.11.5",
+    "@types/pg": "^8.11.10",
     "express": "^4.18.2",
+    "openai": "^6.21.0",
+    "stripe": "^20.3.1",
     "tsup": "^8.0.1",
     "typescript": "^5.3.3",
     "vitest": "^1.2.0"
   },
   "peerDependencies": {
-    "express": "^4.18.0"
+    "@anthropic-ai/sdk": ">=0.20.0",
+    "express": "^4.18.0",
+    "openai": ">=4.0.0",
+    "stripe": ">=14.0.0"
   },
   "peerDependenciesMeta": {
     "express": {
       "optional": true
+    },
+    "stripe": {
+      "optional": true
+    },
+    "openai": {
+      "optional": true
+    },
+    "@anthropic-ai/sdk": {
+      "optional": true
     }
   },
-  "keywords": ["coduck", "sdk", "auth", "database", "payments", "ai"],
+  "keywords": [
+    "coduck",
+    "sdk",
+    "auth",
+    "database",
+    "payments",
+    "ai"
+  ],
   "license": "MIT",
   "repository": {
     "type": "git",