@forklaunch/implementation-billing-stripe 0.5.12 → 0.5.13

package/lib/eject/services/webhook.service.ts

@@ -102,6 +102,34 @@ export class StripeWebhookService<
     this.subscriptionService = subscriptionService;
   }
 
+  /**
+   * Extract features from Stripe product metadata.
+   * Features can be stored as:
+   * - metadata.features: comma-separated string (e.g., "feature1,feature2,feature3")
+   * - metadata.features: JSON array string (e.g., '["feature1","feature2"]')
+   */
+  private extractFeaturesFromProduct(product: Stripe.Product): string[] {
+    const featuresStr = product.metadata?.features;
+    if (!featuresStr) {
+      return [];
+    }
+
+    // Try parsing as JSON array first
+    try {
+      const parsed = JSON.parse(featuresStr);
+      if (Array.isArray(parsed)) {
+        return parsed.filter((f): f is string => typeof f === 'string');
+      }
+    } catch {
+      // Not JSON, treat as comma-separated
+    }
+
+    return featuresStr
+      .split(',')
+      .map((f) => f.trim())
+      .filter((f) => f.length > 0);
+  }
+
   async handleWebhookEvent(event: Stripe.Event): Promise<void> {
     if (this.openTelemetryCollector) {
       this.openTelemetryCollector.info('Handling webhook event', event);
@@ -185,22 +213,26 @@ export class StripeWebhookService<
 
       case 'plan.created': {
         if (
-          typeof event.data.object.product === 'object' &&
           event.data.object.product != null &&
           event.data.object.amount != null
         ) {
+          const productId =
+            typeof event.data.object.product === 'string'
+              ? event.data.object.product
+              : event.data.object.product.id;
+          const product = await this.stripeClient.products.retrieve(productId);
+          const features = this.extractFeaturesFromProduct(product);
+
           await this.planService.basePlanService.createPlan({
             id: event.data.object.id,
             billingProvider: BillingProviderEnum.STRIPE,
             cadence: event.data.object.interval as PlanCadenceEnum,
             currency: event.data.object.currency as CurrencyEnum,
-            active: true,
-            name:
-              typeof event.data.object.product === 'string'
-                ? event.data.object.product
-                : event.data.object.product?.id,
+            active: product.active,
+            name: product.name,
             price: event.data.object.amount,
-            externalId: event.data.object.id
+            externalId: event.data.object.id,
+            features
           });
         } else {
           throw new Error('Invalid plan');
@@ -210,22 +242,26 @@ export class StripeWebhookService<
 
       case 'plan.updated': {
         if (
-          typeof event.data.object.product === 'object' &&
           event.data.object.product != null &&
           event.data.object.amount != null
         ) {
+          const productId =
+            typeof event.data.object.product === 'string'
+              ? event.data.object.product
+              : event.data.object.product.id;
+          const product = await this.stripeClient.products.retrieve(productId);
+          const features = this.extractFeaturesFromProduct(product);
+
           await this.planService.basePlanService.updatePlan({
             id: event.data.object.id,
             billingProvider: BillingProviderEnum.STRIPE,
             cadence: event.data.object.interval as PlanCadenceEnum,
             currency: event.data.object.currency as CurrencyEnum,
-            active: true,
-            name:
-              typeof event.data.object.product === 'string'
-                ? event.data.object.product
-                : event.data.object.product?.id,
+            active: product.active,
+            name: product.name,
             price: event.data.object.amount,
-            externalId: event.data.object.id
+            externalId: event.data.object.id,
+            features
           });
         } else {
           throw new Error('Invalid plan');
@@ -240,6 +276,89 @@ export class StripeWebhookService<
         break;
       }
 
+      case 'product.created':
+      case 'product.updated': {
+        // When a product is created/updated, sync features to all associated plans
+        const product = event.data.object;
+        const features = this.extractFeaturesFromProduct(product);
+
+        // Update all legacy plans (iterates through all pages)
+        await this.stripeClient.plans
+          .list({ product: product.id })
+          .autoPagingEach(async (plan) => {
+            try {
+              await this.planService.basePlanService.updatePlan({
+                id: plan.id,
+                features,
+                active: product.active,
+                name: product.name
+              });
+            } catch (error) {
+              this.openTelemetryCollector.warn(
+                `Failed to update plan ${plan.id} with product features`,
+                error
+              );
+            }
+          });
+
+        // Update all price-based plans (iterates through all pages)
+        await this.stripeClient.prices
+          .list({ product: product.id })
+          .autoPagingEach(async (price) => {
+            try {
+              await this.planService.basePlanService.updatePlan({
+                id: price.id,
+                features,
+                active: price.active && product.active,
+                name: product.name
+              });
+            } catch (error) {
+              this.openTelemetryCollector.warn(
+                `Failed to update price-based plan ${price.id} with product features`,
+                error
+              );
+            }
+          });
+        break;
+      }
+
+      // Handle Stripe Prices API (newer alternative to Plans)
+      case 'price.created':
+      case 'price.updated': {
+        const price = event.data.object;
+        if (
+          price.product != null &&
+          price.unit_amount != null &&
+          price.recurring
+        ) {
+          const productId =
+            typeof price.product === 'string'
+              ? price.product
+              : price.product.id;
+          const product = await this.stripeClient.products.retrieve(productId);
+          const features = this.extractFeaturesFromProduct(product);
+
+          const planData = {
+            id: price.id,
+            billingProvider: BillingProviderEnum.STRIPE,
+            cadence: price.recurring.interval as PlanCadenceEnum,
+            currency: price.currency as CurrencyEnum,
+            active: price.active && product.active,
+            name: product.name,
+            price: price.unit_amount,
+            externalId: price.id,
+            features
+          };
+
+          if (event.type === 'price.created') {
+            await this.planService.basePlanService.createPlan(planData);
+          } else {
+            await this.planService.basePlanService.updatePlan(planData);
+          }
+        }
+        break;
+      }
+
       case 'customer.subscription.created': {
         if (
           !event.data.object.items?.data ||

package/lib/services/index.d.mts

@@ -168,6 +168,13 @@ declare class StripeWebhookService<SchemaValidator extends AnySchemaValidator, S
     protected readonly planService: StripePlanService<SchemaValidator, PlanEntities>;
     protected readonly subscriptionService: StripeSubscriptionService<SchemaValidator, PartyEnum, SubscriptionEntities>;
     constructor(stripeClient: stripe__default, em: EntityManager, schemaValidator: SchemaValidator, openTelemetryCollector: OpenTelemetryCollector<MetricsDefinition>, billingPortalService: StripeBillingPortalService<SchemaValidator, BillingPortalEntities>, checkoutSessionService: StripeCheckoutSessionService<SchemaValidator, StatusEnum, CheckoutSessionEntities>, paymentLinkService: StripePaymentLinkService<SchemaValidator, StatusEnum, PaymentLinkEntities>, planService: StripePlanService<SchemaValidator, PlanEntities>, subscriptionService: StripeSubscriptionService<SchemaValidator, PartyEnum, SubscriptionEntities>);
+    /**
+     * Extract features from Stripe product metadata.
+     * Features can be stored as:
+     * - metadata.features: comma-separated string (e.g., "feature1,feature2,feature3")
+     * - metadata.features: JSON array string (e.g., '["feature1","feature2"]')
+     */
+    private extractFeaturesFromProduct;
     handleWebhookEvent(event: stripe__default.Event): Promise<void>;
 }
 

package/lib/services/index.d.ts

@@ -168,6 +168,13 @@ declare class StripeWebhookService<SchemaValidator extends AnySchemaValidator, S
     protected readonly planService: StripePlanService<SchemaValidator, PlanEntities>;
     protected readonly subscriptionService: StripeSubscriptionService<SchemaValidator, PartyEnum, SubscriptionEntities>;
     constructor(stripeClient: stripe__default, em: EntityManager, schemaValidator: SchemaValidator, openTelemetryCollector: OpenTelemetryCollector<MetricsDefinition>, billingPortalService: StripeBillingPortalService<SchemaValidator, BillingPortalEntities>, checkoutSessionService: StripeCheckoutSessionService<SchemaValidator, StatusEnum, CheckoutSessionEntities>, paymentLinkService: StripePaymentLinkService<SchemaValidator, StatusEnum, PaymentLinkEntities>, planService: StripePlanService<SchemaValidator, PlanEntities>, subscriptionService: StripeSubscriptionService<SchemaValidator, PartyEnum, SubscriptionEntities>);
+    /**
+     * Extract features from Stripe product metadata.
+     * Features can be stored as:
+     * - metadata.features: comma-separated string (e.g., "feature1,feature2,feature3")
+     * - metadata.features: JSON array string (e.g., '["feature1","feature2"]')
+     */
+    private extractFeaturesFromProduct;
     handleWebhookEvent(event: stripe__default.Event): Promise<void>;
 }
 

package/lib/services/index.js

@@ -646,6 +646,26 @@ var StripeWebhookService = class {
     this.planService = planService;
     this.subscriptionService = subscriptionService;
   }
+  /**
+   * Extract features from Stripe product metadata.
+   * Features can be stored as:
+   * - metadata.features: comma-separated string (e.g., "feature1,feature2,feature3")
+   * - metadata.features: JSON array string (e.g., '["feature1","feature2"]')
+   */
+  extractFeaturesFromProduct(product) {
+    const featuresStr = product.metadata?.features;
+    if (!featuresStr) {
+      return [];
+    }
+    try {
+      const parsed = JSON.parse(featuresStr);
+      if (Array.isArray(parsed)) {
+        return parsed.filter((f) => typeof f === "string");
+      }
+    } catch {
+    }
+    return featuresStr.split(",").map((f) => f.trim()).filter((f) => f.length > 0);
+  }
   async handleWebhookEvent(event) {
     if (this.openTelemetryCollector) {
       this.openTelemetryCollector.info("Handling webhook event", event);
@@ -714,16 +734,20 @@ var StripeWebhookService = class {
         break;
       }
       case "plan.created": {
-        if (typeof event.data.object.product === "object" && event.data.object.product != null && event.data.object.amount != null) {
+        if (event.data.object.product != null && event.data.object.amount != null) {
+          const productId = typeof event.data.object.product === "string" ? event.data.object.product : event.data.object.product.id;
+          const product = await this.stripeClient.products.retrieve(productId);
+          const features = this.extractFeaturesFromProduct(product);
           await this.planService.basePlanService.createPlan({
             id: event.data.object.id,
             billingProvider: BillingProviderEnum.STRIPE,
             cadence: event.data.object.interval,
             currency: event.data.object.currency,
-            active: true,
-            name: typeof event.data.object.product === "string" ? event.data.object.product : event.data.object.product?.id,
+            active: product.active,
+            name: product.name,
             price: event.data.object.amount,
-            externalId: event.data.object.id
+            externalId: event.data.object.id,
+            features
           });
         } else {
           throw new Error("Invalid plan");
@@ -731,16 +755,20 @@ var StripeWebhookService = class {
         break;
       }
       case "plan.updated": {
-        if (typeof event.data.object.product === "object" && event.data.object.product != null && event.data.object.amount != null) {
+        if (event.data.object.product != null && event.data.object.amount != null) {
+          const productId = typeof event.data.object.product === "string" ? event.data.object.product : event.data.object.product.id;
+          const product = await this.stripeClient.products.retrieve(productId);
+          const features = this.extractFeaturesFromProduct(product);
           await this.planService.basePlanService.updatePlan({
             id: event.data.object.id,
             billingProvider: BillingProviderEnum.STRIPE,
             cadence: event.data.object.interval,
             currency: event.data.object.currency,
-            active: true,
-            name: typeof event.data.object.product === "string" ? event.data.object.product : event.data.object.product?.id,
+            active: product.active,
+            name: product.name,
             price: event.data.object.amount,
-            externalId: event.data.object.id
+            externalId: event.data.object.id,
+            features
           });
         } else {
           throw new Error("Invalid plan");
@@ -753,6 +781,69 @@ var StripeWebhookService = class {
         });
         break;
       }
+      case "product.created":
+      case "product.updated": {
+        const product = event.data.object;
+        const features = this.extractFeaturesFromProduct(product);
+        await this.stripeClient.plans.list({ product: product.id }).autoPagingEach(async (plan) => {
+          try {
+            await this.planService.basePlanService.updatePlan({
+              id: plan.id,
+              features,
+              active: product.active,
+              name: product.name
+            });
+          } catch (error) {
+            this.openTelemetryCollector.warn(
+              `Failed to update plan ${plan.id} with product features`,
+              error
+            );
+          }
+        });
+        await this.stripeClient.prices.list({ product: product.id }).autoPagingEach(async (price) => {
+          try {
+            await this.planService.basePlanService.updatePlan({
+              id: price.id,
+              features,
+              active: price.active && product.active,
+              name: product.name
+            });
+          } catch (error) {
+            this.openTelemetryCollector.warn(
+              `Failed to update price-based plan ${price.id} with product features`,
+              error
+            );
+          }
+        });
+        break;
+      }
+      // Handle Stripe Prices API (newer alternative to Plans)
+      case "price.created":
+      case "price.updated": {
+        const price = event.data.object;
+        if (price.product != null && price.unit_amount != null && price.recurring) {
+          const productId = typeof price.product === "string" ? price.product : price.product.id;
+          const product = await this.stripeClient.products.retrieve(productId);
+          const features = this.extractFeaturesFromProduct(product);
+          const planData = {
+            id: price.id,
+            billingProvider: BillingProviderEnum.STRIPE,
+            cadence: price.recurring.interval,
+            currency: price.currency,
+            active: price.active && product.active,
+            name: product.name,
+            price: price.unit_amount,
+            externalId: price.id,
+            features
+          };
+          if (event.type === "price.created") {
+            await this.planService.basePlanService.createPlan(planData);
+          } else {
+            await this.planService.basePlanService.updatePlan(planData);
+          }
+        }
+        break;
+      }
       case "customer.subscription.created": {
         if (!event.data.object.items?.data || event.data.object.items.data.length === 0 || !event.data.object.items.data[0]?.plan?.id) {
           throw new Error(

package/lib/services/index.mjs

@@ -614,6 +614,26 @@ var StripeWebhookService = class {
     this.planService = planService;
     this.subscriptionService = subscriptionService;
   }
+  /**
+   * Extract features from Stripe product metadata.
+   * Features can be stored as:
+   * - metadata.features: comma-separated string (e.g., "feature1,feature2,feature3")
+   * - metadata.features: JSON array string (e.g., '["feature1","feature2"]')
+   */
+  extractFeaturesFromProduct(product) {
+    const featuresStr = product.metadata?.features;
+    if (!featuresStr) {
+      return [];
+    }
+    try {
+      const parsed = JSON.parse(featuresStr);
+      if (Array.isArray(parsed)) {
+        return parsed.filter((f) => typeof f === "string");
+      }
+    } catch {
+    }
+    return featuresStr.split(",").map((f) => f.trim()).filter((f) => f.length > 0);
+  }
   async handleWebhookEvent(event) {
     if (this.openTelemetryCollector) {
       this.openTelemetryCollector.info("Handling webhook event", event);
@@ -682,16 +702,20 @@ var StripeWebhookService = class {
         break;
       }
       case "plan.created": {
-        if (typeof event.data.object.product === "object" && event.data.object.product != null && event.data.object.amount != null) {
+        if (event.data.object.product != null && event.data.object.amount != null) {
+          const productId = typeof event.data.object.product === "string" ? event.data.object.product : event.data.object.product.id;
+          const product = await this.stripeClient.products.retrieve(productId);
+          const features = this.extractFeaturesFromProduct(product);
           await this.planService.basePlanService.createPlan({
             id: event.data.object.id,
             billingProvider: BillingProviderEnum.STRIPE,
             cadence: event.data.object.interval,
             currency: event.data.object.currency,
-            active: true,
-            name: typeof event.data.object.product === "string" ? event.data.object.product : event.data.object.product?.id,
+            active: product.active,
+            name: product.name,
             price: event.data.object.amount,
-            externalId: event.data.object.id
+            externalId: event.data.object.id,
+            features
           });
         } else {
           throw new Error("Invalid plan");
@@ -699,16 +723,20 @@ var StripeWebhookService = class {
         break;
       }
       case "plan.updated": {
-        if (typeof event.data.object.product === "object" && event.data.object.product != null && event.data.object.amount != null) {
+        if (event.data.object.product != null && event.data.object.amount != null) {
+          const productId = typeof event.data.object.product === "string" ? event.data.object.product : event.data.object.product.id;
+          const product = await this.stripeClient.products.retrieve(productId);
+          const features = this.extractFeaturesFromProduct(product);
           await this.planService.basePlanService.updatePlan({
             id: event.data.object.id,
             billingProvider: BillingProviderEnum.STRIPE,
             cadence: event.data.object.interval,
             currency: event.data.object.currency,
-            active: true,
-            name: typeof event.data.object.product === "string" ? event.data.object.product : event.data.object.product?.id,
+            active: product.active,
+            name: product.name,
             price: event.data.object.amount,
-            externalId: event.data.object.id
+            externalId: event.data.object.id,
+            features
           });
         } else {
           throw new Error("Invalid plan");
@@ -721,6 +749,69 @@ var StripeWebhookService = class {
         });
         break;
       }
+      case "product.created":
+      case "product.updated": {
+        const product = event.data.object;
+        const features = this.extractFeaturesFromProduct(product);
+        await this.stripeClient.plans.list({ product: product.id }).autoPagingEach(async (plan) => {
+          try {
+            await this.planService.basePlanService.updatePlan({
+              id: plan.id,
+              features,
+              active: product.active,
+              name: product.name
+            });
+          } catch (error) {
+            this.openTelemetryCollector.warn(
+              `Failed to update plan ${plan.id} with product features`,
+              error
+            );
+          }
+        });
+        await this.stripeClient.prices.list({ product: product.id }).autoPagingEach(async (price) => {
+          try {
+            await this.planService.basePlanService.updatePlan({
+              id: price.id,
+              features,
+              active: price.active && product.active,
+              name: product.name
+            });
+          } catch (error) {
+            this.openTelemetryCollector.warn(
+              `Failed to update price-based plan ${price.id} with product features`,
+              error
+            );
+          }
+        });
+        break;
+      }
+      // Handle Stripe Prices API (newer alternative to Plans)
+      case "price.created":
+      case "price.updated": {
+        const price = event.data.object;
+        if (price.product != null && price.unit_amount != null && price.recurring) {
+          const productId = typeof price.product === "string" ? price.product : price.product.id;
+          const product = await this.stripeClient.products.retrieve(productId);
+          const features = this.extractFeaturesFromProduct(product);
+          const planData = {
+            id: price.id,
+            billingProvider: BillingProviderEnum.STRIPE,
+            cadence: price.recurring.interval,
+            currency: price.currency,
+            active: price.active && product.active,
+            name: product.name,
+            price: price.unit_amount,
+            externalId: price.id,
+            features
+          };
+          if (event.type === "price.created") {
+            await this.planService.basePlanService.createPlan(planData);
+          } else {
+            await this.planService.basePlanService.updatePlan(planData);
+          }
+        }
+        break;
+      }
       case "customer.subscription.created": {
         if (!event.data.object.items?.data || event.data.object.items.data.length === 0 || !event.data.object.items.data[0]?.plan?.id) {
           throw new Error(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forklaunch/implementation-billing-stripe",
-  "version": "0.5.12",
+  "version": "0.5.13",
   "description": "Stripe implementation for forklaunch billing",
   "homepage": "https://github.com/forklaunch/forklaunch-js#readme",
   "bugs": {
@@ -42,23 +42,23 @@
     "lib/**"
   ],
   "dependencies": {
-    "@forklaunch/common": "^0.6.28",
-    "@forklaunch/core": "^0.18.1",
-    "@forklaunch/internal": "^0.3.28",
-    "@forklaunch/validator": "^0.10.28",
-    "@mikro-orm/core": "^6.6.6",
+    "@forklaunch/common": "^0.6.29",
+    "@forklaunch/core": "^0.18.2",
+    "@forklaunch/internal": "^0.3.29",
+    "@forklaunch/validator": "^0.10.29",
+    "@mikro-orm/core": "^6.6.7",
     "@sinclair/typebox": "^0.34.48",
-    "ajv": "^8.17.1",
-    "stripe": "^20.3.0",
+    "ajv": "^8.18.0",
+    "stripe": "^20.3.1",
     "zod": "^4.3.6",
-    "@forklaunch/implementation-billing-base": "0.8.12",
-    "@forklaunch/interfaces-billing": "0.8.12"
+    "@forklaunch/implementation-billing-base": "0.8.13",
+    "@forklaunch/interfaces-billing": "0.8.13"
   },
   "devDependencies": {
-    "@typescript/native-preview": "7.0.0-dev.20260204.1",
+    "@typescript/native-preview": "7.0.0-dev.20260223.1",
     "depcheck": "^1.4.7",
     "prettier": "^3.8.1",
-    "typedoc": "^0.28.16"
+    "typedoc": "^0.28.17"
   },
   "scripts": {
     "build": "tsgo --noEmit && tsup domain/schemas/index.ts services/index.ts domain/enum/index.ts domain/types/index.ts --format cjs,esm --no-splitting --dts --tsconfig tsconfig.json --out-dir lib --clean && if [ -f eject-package.bash ]; then pnpm package:eject; fi",